madeline82-HEAD.phar composer.jsongcoJ2vendor/phpseclib/phpseclib/phpseclib/File/ANSI.phpNgcN֟a2vendor/phpseclib/phpseclib/phpseclib/File/X509.php{*gc{*Ƥ2vendor/phpseclib/phpseclib/phpseclib/File/ASN1.phpogcodMvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateKeyUsagePeriod.phpgc$s}Dvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ECPrivateKey.php~gc~OgCvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/TBSCertList.php\gc\u?vendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ECPoint.phpgcdFvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyMappings.phpgc^wDvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PersonalName.phpCgcCᙤKvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ExtensionAttributes.phpugcu YFvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OtherPrimeInfo.phpgc6RCvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralName.phpgc>vendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CPSuri.phpgcfDvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/FieldElement.phpgc[:gCvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Certificate.phpgc贗Ovendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OrganizationalUnitNames.phpgcw8uBvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/UserNotice.php gc mXAUvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BuiltInDomainDefinedAttribute.phpgcIvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SpecifiedECDomain.phpXgcXRLODvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ECParameters.phptgct_Dvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DSAPublicKey.phpgc"5,Kvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/HoldInstructionCode.phpgc>uQvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BuiltInStandardAttributes.phpgc/wOvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EncryptedPrivateKeyInfo.phpgc0פMvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DistributionPointName.phpgcaIvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RSASSA_PSS_params.phpgcXQEvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/HashAlgorithm.phpgc$IPvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/IssuingDistributionPoint.php^gc^S.yޤDvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBMAC1params.phpgcSOvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectInfoAccessSyntax.phpigciǔ4Fvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NetworkAddress.phpgcqt Evendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DSAPrivateKey.phpNgcN1Gvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralSubtrees.phpNgcNߠqFvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralSubtree.phpgcooAvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Attribute.phpgc5~Gvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NameConstraints.phpgcL Evendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EncryptedData.phpgcpMvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PublicKeyAndChallenge.phpgcJvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/netscape_cert_type.phpJgcJ{Hvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OneAsymmetricKey.phpgcWQvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RelativeDistinguishedName.phpgchFvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateKeyInfo.phpgcϒ@vendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Validity.phpRgcRPnCvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBES2params.phpgc[iDVvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BuiltInDomainDefinedAttributes.phpgcF]ŤEvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RSAPrivateKey.phpgcxRwDvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralNames.phpBgcBCGvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OtherPrimeInfos.phpgcR|Pvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AdministrationDomainName.phpgc|[Jvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Characteristic_two.php&gc&(Ivendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyQualifierId.phpgcc5Ivendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificateIssuer.phpgc5Evendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PostalAddress.phpegceM0Gvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DirectoryString.phprgcr7hܧDvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/KeyPurposeId.phpgcnpHvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/MaskGenAlgorithm.phpgc_Svendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SignedPublicKeyAndChallenge.phpgcZPIvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ExtKeyUsageSyntax.phpRgcRdNvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/netscape_ca_policy_url.phpgceRvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectDirectoryAttributes.phpjgcj[Lvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificationRequest.phpgc)Cvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DssSigValue.phpvgcv5֤Hvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BasicConstraints.php>gc> $Ivendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateDomainName.phpgcDEvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PublicKeyInfo.php-gc-riAvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Trinomial.phpgc0Nvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AuthorityKeyIdentifier.phpSgcS8]Kvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AlgorithmIdentifier.phpgc(Dvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EDIPartyName.php2gc2V:Avendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CRLNumber.phpgcKvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificatePolicies.php]gc]҅Gvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NoticeReference.php"gc"͖Jvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ExtensionAttribute.phpgcܥX<Fvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AttributeValue.phpgc>aCvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Pentanomial.phpgcǀJvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RevokedCertificate.phpgcb78Dvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BaseDistance.phpgcnCvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PKCS9String.phpgcA2Z:?vendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/FieldID.phpgcqƃFvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/TBSCertificate.phpWgcWZIvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DistributionPoint.php(gc(Dvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBKDF2params.phpgcZEvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/IssuerAltName.phpgcO5Pvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificationRequestInfo.phpgcAvBvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DigestInfo.phpgcjDvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBEParameter.phpgc%qBvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateKey.phpgc'JMvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AttributeTypeAndValue.phpgc*<Fvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectAltName.phpgcOAvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DSAParams.phpgc0Avendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CRLReason.phpbgcbz7Cvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CountryName.phpgcզCvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DisplayText.phpgcrɤGvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificateList.phpgc6<vendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Name.php(gc(InGvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RC2CBCParameter.phpgc)Cvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DHParameter.phpVgcV:Cvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AnotherName.php gc ߣAAvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ORAddress.phpgcf{Mvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CRLDistributionPoints.phpcgccЫy`Hvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/UniqueIdentifier.phpgcBʑ7Avendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Extension.php+gc+݈YEvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AttributeType.phpgc䆤Mvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NumericUserIdentifier.phpgc|Zk=vendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Curve.phpgcUIvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyInformation.phpMgcM C@vendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/KeyUsage.php gc $UDvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertPolicyId.phpgcP*Evendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EcdsaSigValue.php|gc|ߖg%Kvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyQualifierInfo.phpgcsމCvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ReasonFlags.phpgcJ*<vendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Time.phpygcyHvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/netscape_comment.phpgcZ?Dvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RSAPublicKey.phpgc"PBvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Extensions.phpgc7Ivendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AccessDescription.phpgc!AFvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/InvalidityDate.phpgc6njJvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/TerminalIdentifier.phpgcȴHvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OrganizationName.phpgcǓRҤEvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/KeyIdentifier.phpgc;[Avendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PublicKey.phpgcnOvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificateSerialNumber.phpgcQvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AuthorityInfoAccessSyntax.phpogco ,Cvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RDNSequence.phpgc>pa?vendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Prime_p.phpgc^jBvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Attributes.php5gc5S+YLvendor/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectPublicKeyInfo.phpgc]9:vendor/phpseclib/phpseclib/phpseclib/File/ASN1/Element.phpJgcJO@2vendor/phpseclib/phpseclib/phpseclib/Crypt/AES.phpgc 6vendor/phpseclib/phpseclib/phpseclib/Crypt/Salsa20.phpt9gct9\&~=vendor/phpseclib/phpseclib/phpseclib/Crypt/RSA/PrivateKey.php#?gc#?kCTEvendor/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PKCS1.phpgcsǽiEvendor/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PKCS8.phpgcCvendor/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PSS.php+gc+Z\̤Cvendor/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/XML.phpgcPHFvendor/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/MSBLOB.phpkgckߕ Cvendor/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/JWK.phpgc(ϾEvendor/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PuTTY.phpWgcWbYPGvendor/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/OpenSSH.phpgc1ˤCvendor/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/Raw.phpKgcK<vendor/phpseclib/phpseclib/phpseclib/Crypt/RSA/PublicKey.phpy<gcy<)$<vendor/phpseclib/phpseclib/phpseclib/Crypt/DH/Parameters.php gc  +<vendor/phpseclib/phpseclib/phpseclib/Crypt/DH/PrivateKey.phpgc6Dvendor/phpseclib/phpseclib/phpseclib/Crypt/DH/Formats/Keys/PKCS1.php<gc<Q{*Dvendor/phpseclib/phpseclib/phpseclib/Crypt/DH/Formats/Keys/PKCS8.php gc ڶ;vendor/phpseclib/phpseclib/phpseclib/Crypt/DH/PublicKey.phpgcjf 1vendor/phpseclib/phpseclib/phpseclib/Crypt/EC.php3gc3y7vendor/phpseclib/phpseclib/phpseclib/Crypt/Rijndael.phpbgcbc_2vendor/phpseclib/phpseclib/phpseclib/Crypt/RC4.phpgcߤ8vendor/phpseclib/phpseclib/phpseclib/Crypt/TripleDES.php4gc4)2vendor/phpseclib/phpseclib/phpseclib/Crypt/DSA.php"gc"W3vendor/phpseclib/phpseclib/phpseclib/Crypt/Hash.php`gc`&2vendor/phpseclib/phpseclib/phpseclib/Crypt/RSA.phpkgckR6vendor/phpseclib/phpseclib/phpseclib/Crypt/Twofish.phphgchTĴ>vendor/phpseclib/phpseclib/phpseclib/Crypt/PublicKeyLoader.php gc `1vendor/phpseclib/phpseclib/phpseclib/Crypt/DH.php*Igc*Id˦Avendor/phpseclib/phpseclib/phpseclib/Crypt/Common/BlockCipher.phpgc Cvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/AsymmetricKey.php:gc:UBvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/SymmetricKey.phpgcZBvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/StreamCipher.phpgc-%@vendor/phpseclib/phpseclib/phpseclib/Crypt/Common/PrivateKey.phpgcb2Hvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/Traits/Fingerprint.phpgcrNNvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/Traits/PasswordProtected.php*gc*ɛHvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PKCS1.phpgcIȥHvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PKCS8.phpjgcjK]Fvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/JWK.phpgc5SHvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PuTTY.phpH4gcH4UV(Gvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PKCS.phpagcaJvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/OpenSSH.phpxgcxΤKvendor/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Signature/Raw.php gc 1Q7'?vendor/phpseclib/phpseclib/phpseclib/Crypt/Common/PublicKey.phpNgcN.[-ɤ5vendor/phpseclib/phpseclib/phpseclib/Crypt/Random.php1%gc1%:%7vendor/phpseclib/phpseclib/phpseclib/Crypt/ChaCha20.phpgc0N2vendor/phpseclib/phpseclib/phpseclib/Crypt/DES.php gc r _Bvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp128r1.phpgc6DAvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp224.phpfgcfl)OBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp112r2.phpgci.Avendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistk163.phpfgcfMIAvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp256.phpfgcfv[Bvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp160r1.php gc *Hvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP192t1.phpQgcQsBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect283k1.php1gc1~äBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp224k1.phpgcrBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect239k1.phpgcE3Avendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp521.phpfgcf'olAvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp192.phpfgcf)>vendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/Ed448.phpgc*Hvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP512r1.phpgcĤBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect409k1.phpgcԋBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect233k1.phpgc"Cvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime239v2.phpgc嬤Bvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect131r1.phppgcp5MBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp192k1.php>gc>eAvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistt571.phpfgcfBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect283r1.php1gc1EHvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP224t1.phpgcZǤBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp112r1.phpgcXAvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistk283.phpggcgTyڤBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect163r2.phpgc lBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect193r1.phpgcoۆ@vendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/Ed25519.php'gc'δ̤Bvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect131r2.phppgcp ϤBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp192r1.php gc 32wBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect163r1.phpgc^KHvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP160t1.phpgc)Bvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp384r1.phpWgcW볤Bvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp256k1.phpAgcAL-Bvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect113r1.phpVgcVGHvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP256r1.phpgcoBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp521r1.phpgc& GBvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect571k1.phpgcI&Hvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP192r1.phpGgcGG٤Avendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistk233.phpfgcf Hvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP224r1.phpwgcw<Cvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime239v1.phpgcX uHvendor/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP384t1.phpgcB2vendor/phpseclib/phpseclib/phpseclib/bootstrap.phpgcy@vendor/phpseclib/phpseclib/phpseclib/Math/PrimeField/Integer.php'gc'D8vendor/phpseclib/phpseclib/phpseclib/Math/PrimeField.php\ gc\ 3Uvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/DefaultEngine.phpIgcIOvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/OpenSSL.php7gc7Zvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/Reductions/Barrett.phpgcopBu^vendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/Reductions/EvalBarrett.phpB gcB ϽRLvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/Base.phpg gcg E⨕Ovendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/BuiltIn.phpgc>Hvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/OpenSSL.phpgcfmFvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP64.php#gc#2ޑGvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/Engine.phpgcݓ`Dvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/GMP.php@gc@UwGvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath.php,Egc,E+uDvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP.phpgcuX Rvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/GMP/DefaultEngine.php|gc|5֤Rvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/DefaultEngine.phpHgcH`IڤLvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/OpenSSL.php4gc4b'"Wvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/Classic.phpgckǤ^vendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/MontgomeryMult.phpo gco Zvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/PowerOfTwo.php`gc` Wvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/Barrett.php+gc+EHZvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/Montgomery.phpgc7 [[vendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/EvalBarrett.php<gc<4}OIvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Base.phpgcX4Ovendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Montgomery.php_ gc_ 0Fvendor/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP32.phpC#gcC# v9vendor/phpseclib/phpseclib/phpseclib/Math/BinaryField.phpgcdGAvendor/phpseclib/phpseclib/phpseclib/Math/BinaryField/Integer.php5gc5q1÷Hvendor/phpseclib/phpseclib/phpseclib/Math/Common/FiniteField/Integer.phpgc~]ª@vendor/phpseclib/phpseclib/phpseclib/Math/Common/FiniteField.phpwgcww8vendor/phpseclib/phpseclib/phpseclib/Math/BigInteger.phpUgcUl!1vendor/phpseclib/phpseclib/phpseclib/Net/SSH2.phpgcnD1vendor/phpseclib/phpseclib/phpseclib/Net/SFTP.phpbgcbz]8vendor/phpseclib/phpseclib/phpseclib/Net/SFTP/Stream.php%Sgc%S͍+(vendor/phpseclib/phpseclib/composer.json gc B4 "vendor/cash/lrucache/composer.jsongc>8Ѥ*vendor/cash/lrucache/src/cash/LRUCache.php gc dܤ%vendor/webmozart/assert/composer.jsongcvؤ8vendor/webmozart/assert/src/InvalidArgumentException.php[gc[*i%vendor/webmozart/assert/src/Mixin.phpgc.A&vendor/webmozart/assert/src/Assert.php6gc6\1vendor/autoload.phpgc/ȹ5vendor/daverandom/libdns/tools/autoload_generator.php gc ̘Z&vendor/daverandom/libdns/composer.jsongcxez.vendor/daverandom/libdns/examples/SOAQuery.php` gc` eZ{.vendor/daverandom/libdns/examples/autoload.phpgc,vendor/daverandom/libdns/examples/AQuery.phpgcX,vendor/daverandom/libdns/src/Enumeration.phpgc{ ?vendor/daverandom/libdns/src/Encoder/EncodingContextFactory.phpgcnϤ7vendor/daverandom/libdns/src/Encoder/EncoderFactory.phpgc Τ8vendor/daverandom/libdns/src/Encoder/EncodingContext.phpgc140vendor/daverandom/libdns/src/Encoder/Encoder.php+gc+qH/vendor/daverandom/libdns/src/Packets/Packet.php gc GP6vendor/daverandom/libdns/src/Packets/LabelRegistry.phpAgcAuf6vendor/daverandom/libdns/src/Packets/PacketFactory.phpgci@*vendor/daverandom/libdns/src/functions.phpgcM?vendor/daverandom/libdns/src/Decoder/DecodingContextFactory.phpgcY)8vendor/daverandom/libdns/src/Decoder/DecodingContext.phpgc$W:A0vendor/daverandom/libdns/src/Decoder/Decoder.phpIgcI-U7vendor/daverandom/libdns/src/Decoder/DecoderFactory.phpagca/o6vendor/daverandom/libdns/src/Records/ResourceTypes.phpgcz|[.vendor/daverandom/libdns/src/Records/RData.phpgcF8vendor/daverandom/libdns/src/Records/ResourceBuilder.phpgct%Y@vendor/daverandom/libdns/src/Records/RecordCollectionFactory.phpgcM )1vendor/daverandom/libdns/src/Records/Question.phpgc]4vendor/daverandom/libdns/src/Records/Types/Types.phpgcP5vendor/daverandom/libdns/src/Records/Types/BitMap.phpgcku3vendor/daverandom/libdns/src/Records/Types/Char.phpgc>9^4vendor/daverandom/libdns/src/Records/Types/Short.phpgc3vendor/daverandom/libdns/src/Records/Types/Type.phpgcՇ#!3vendor/daverandom/libdns/src/Records/Types/Long.php:gc:\x:vendor/daverandom/libdns/src/Records/Types/TypeFactory.php gc :vendor/daverandom/libdns/src/Records/Types/TypeBuilder.phpUgcUt:vendor/daverandom/libdns/src/Records/Types/IPv6Address.phpgcp 9vendor/daverandom/libdns/src/Records/Types/DomainName.phpU gcU 4X:vendor/daverandom/libdns/src/Records/Types/IPv4Address.php gc Il7vendor/daverandom/libdns/src/Records/Types/Anything.php]gc]2>vendor/daverandom/libdns/src/Records/Types/CharacterString.phpZgcZJ3?vendor/daverandom/libdns/src/Records/ResourceBuilderFactory.phpgchL5vendor/daverandom/libdns/src/Records/RDataFactory.phpngcn.j1vendor/daverandom/libdns/src/Records/Resource.phpgcV~Gvendor/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinition.phpgc^XޤNvendor/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinitionFactory.phpagca:_פUvendor/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinitionManagerFactory.phpgcp[Nvendor/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinitionManager.php;)gc;)1]>Ovendor/daverandom/libdns/src/Records/TypeDefinitions/FieldDefinitionFactory.phpGgcGGBjפHvendor/daverandom/libdns/src/Records/TypeDefinitions/FieldDefinition.phpgc</vendor/daverandom/libdns/src/Records/Record.php! gc! 8vendor/daverandom/libdns/src/Records/ResourceFactory.phpgcp7ͤ8vendor/daverandom/libdns/src/Records/QuestionFactory.phpEgcEPӭ7vendor/daverandom/libdns/src/Records/ResourceQTypes.phpgc\^,4vendor/daverandom/libdns/src/Records/RecordTypes.phpgc05vendor/daverandom/libdns/src/Records/RDataBuilder.phptgct|9vendor/daverandom/libdns/src/Records/RecordCollection.php gc ʲ9vendor/daverandom/libdns/src/Records/ResourceQClasses.phpgc8vendor/daverandom/libdns/src/Records/ResourceClasses.phpgcv6vendor/daverandom/libdns/src/Messages/MessageTypes.phpgcT+>vendor/daverandom/libdns/src/Messages/MessageResponseCodes.php gc b7'8vendor/daverandom/libdns/src/Messages/MessageFactory.phpgcOٳ'1vendor/daverandom/libdns/src/Messages/Message.phpvgcv/8vendor/daverandom/libdns/src/Messages/MessageOpCodes.phpgc`iB:vendor/danog/madelineproto/.devcontainer/devcontainer.jsongca+vendor/danog/madelineproto/examples/bot.phppgcp(^1vendor/danog/madelineproto/.php-cs-fixer.dist.phpgc>N/vendor/danog/madelineproto/tools/build_docs.phpgcSXУ(vendor/danog/madelineproto/tools/std.phpb gcb _f+vendor/danog/madelineproto/tools/static.phpgc-vendor/danog/madelineproto/tools/makephar.phpvgcv|r8<vendor/danog/madelineproto/tools/build_docs/layerUpgrade.phpjgcjǫڤ5vendor/danog/madelineproto/tools/build_docs/merge.php,gc,F7vendor/danog/madelineproto/tools/build_docs/schemas.phpgc-vendor/danog/madelineproto/tools/asyncify.phpgc$+vendor/danog/madelineproto/tools/phpdoc.php)gc)p.vendor/danog/madelineproto/tools/layerdiff.phpgchۤ/vendor/danog/madelineproto/tools/translator.phpgc`)vendor/danog/madelineproto/tools/phar.phpR"gcR"cI@vendor/danog/madelineproto/ton/ton-lite-client-test1.config.jsongct-vendor/danog/madelineproto/ton/toncustom.jsongc?.vendor/danog/madelineproto/ton/lite-client.phprgcrt}(vendor/danog/madelineproto/composer.json4gc4E,ܤ2vendor/danog/madelineproto/examples/secret_bot.php3gc3N"9vendor/danog/madelineproto/examples/downloadRenameBot.php &gc & 3vendor/danog/madelineproto/examples/combinedBot.php gc Z\-vendor/danog/madelineproto/examples/index.php)gc)L罤Ivendor/danog/madelineproto/examples/database-config-examples/postgres.phpgcU\uFvendor/danog/madelineproto/examples/database-config-examples/mysql.phpgc$Fvendor/danog/madelineproto/examples/database-config-examples/redis.php-gc-ѤGvendor/danog/madelineproto/examples/database-config-examples/memory.phpIgcIJ6vendor/danog/madelineproto/examples/botAllMessages.php gc ܤ-vendor/danog/madelineproto/src/BigIntegor.php gc + z+vendor/danog/madelineproto/src/polyfill.phpBgcB;UHvendor/danog/madelineproto/src/danog/MadelineProto/RPCErrorException.phpSgcSⴏbHvendor/danog/madelineproto/src/danog/MadelineProto/SecurityException.php?gc?<z=vendor/danog/madelineproto/src/danog/MadelineProto/Logger.php0gc0Ց/Ovendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/MinDatabase.phpgcKCOvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/PeerHandler.phpgceƱTvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt/IGEOpenssl.php# gc# TsMvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt/IGE.phpgc0ڤVvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt/IGEPhpseclib.phpY gcY G"Ivendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt.php!gc!m8Pvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/ResponseInfo.phpUgcU ɤUvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/ReferenceDatabase.phpLagcLaǩPvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/UpdatesState.php$gc$ddNvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/FilesLogic.php@gc@YVvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/PasswordCalculator.php*gc*$Rvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/AuthKeyHandler.php, gc, OҮQvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/UpdateHandler.phpYgcYҤIvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Files.php5gc5v#ԤOvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/CallHandler.php gc iXvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/CombinedUpdatesState.php@ gc@ T(>vendor/danog/madelineproto/src/danog/MadelineProto/MTProto.phpqgcq%EGvendor/danog/madelineproto/src/danog/MadelineProto/ContextConnector.php gc 5Bvendor/danog/madelineproto/src/danog/MadelineProto/InternalDoc.phpmgcmKvendor/danog/madelineproto/src/danog/MadelineProto/DataCenterConnection.phplgclkrAvendor/danog/madelineproto/src/danog/MadelineProto/APIFactory.phpgc2AGvendor/danog/madelineproto/src/danog/MadelineProto/GarbageCollector.php gc v|4?vendor/danog/madelineproto/src/danog/MadelineProto/TON/Lite.phpgc6Ivendor/danog/madelineproto/src/danog/MadelineProto/TON/ADNLConnection.php gc #Fvendor/danog/madelineproto/src/danog/MadelineProto/TON/InternalDoc.php)gc)yoEvendor/danog/madelineproto/src/danog/MadelineProto/TON/APIFactory.php gc KS>vendor/danog/madelineproto/src/danog/MadelineProto/TON/API.phpogcoԮ6?vendor/danog/madelineproto/src/danog/MadelineProto/StrTools.phpYgcYS<Cvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/IpcState.phpxgcxiIvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/ServerCallback.php gc Ovendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Runner/ProcessRunner.php.gc.vGvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Runner/entry.php7gc7lpmKvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Runner/WebRunner.phpgcEEPvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Runner/RunnerAbstract.php gc jBvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper.phpgchӫNvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/InputStream.phpgctFvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/Obj.phpgcYRvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/WrapMethodTrait.phpgc-Vvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/SeekableInputStream.php|gc|A8Ovendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/FileCallback.phpgc Wvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/SeekableOutputStream.php~gc~եUOvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/OutputStream.phpgc5Pvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/SeekableTrait.phpggcgːAvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Server.phpi#gci#CѤIvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/ClientAbstract.phpgcAuM֤Fvendor/danog/madelineproto/src/danog/MadelineProto/Ipc/ExitFailure.phpgc>Avendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Client.php3gc3dw"Kvendor/danog/madelineproto/src/danog/MadelineProto/MyTelegramOrgWrapper.phpn3gcn3IކFvendor/danog/madelineproto/src/danog/MadelineProto/VoIP/AckHandler.php] gc] ŮJvendor/danog/madelineproto/src/danog/MadelineProto/VoIP/AuthKeyHandler.phpCgcC_Jvendor/danog/madelineproto/src/danog/MadelineProto/VoIP/MessageHandler.phpXgcX5(Dvendor/danog/madelineproto/src/danog/MadelineProto/VoIP/Endpoint.phpgc4 Cvendor/danog/madelineproto/src/danog/MadelineProto/PTSException.phpgc9;vendor/danog/madelineproto/src/danog/MadelineProto/Lang.phpzgcz6Cvendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/TOS.php] gc] a%Fvendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/Button.phpgc.YMvendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/DialogHandler.php+gc+ywFvendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/Events.phpgc)bܤDvendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/Noop.phpVgcVkQEvendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/Login.php2gc2sؤEvendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/Start.phpgc1Ivendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/Templates.phpgc~Dvendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/Loop.phpgc&AĮHvendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/Callback.phpgc)FLGvendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/Webhook.php gc Cvendor/danog/madelineproto/src/danog/MadelineProto/Wrappers/Ads.php< gc< < Dvendor/danog/madelineproto/src/danog/MadelineProto/Serialization.php8gc8h:Bvendor/danog/madelineproto/src/danog/MadelineProto/DocsBuilder.phptgcti yAvendor/danog/madelineproto/src/danog/MadelineProto/DataCenter.phpogcoKvendor/danog/madelineproto/src/danog/MadelineProto/Async/AsyncConstruct.php gc qJvendor/danog/madelineproto/src/danog/MadelineProto/MTProto/PermAuthKey.phpE gcE Aq?ФNvendor/danog/madelineproto/src/danog/MadelineProto/MTProto/OutgoingMessage.php}4gc}4`\Fvendor/danog/madelineproto/src/danog/MadelineProto/MTProto/Message.phpgc7|Hvendor/danog/madelineproto/src/danog/MadelineProto/MTProto/Container.phpgckNvendor/danog/madelineproto/src/danog/MadelineProto/MTProto/IncomingMessage.phpgcFvendor/danog/madelineproto/src/danog/MadelineProto/MTProto/AuthKey.phpgcJvendor/danog/madelineproto/src/danog/MadelineProto/MTProto/TempAuthKey.phpgc'iAvendor/danog/madelineproto/src/danog/MadelineProto/LightState.phpgcVĤHvendor/danog/madelineproto/src/danog/MadelineProto/ApiWrappers/Start.phpTgcTHۢLvendor/danog/madelineproto/src/danog/MadelineProto/ApiWrappers/Templates.php'gc'%oޤGvendor/danog/madelineproto/src/danog/MadelineProto/SettingsAbstract.php& gc& }x%@vendor/danog/madelineproto/src/danog/MadelineProto/Coroutine.phpR%gcR%, :Gvendor/danog/madelineproto/src/danog/MadelineProto/VoIPServerConfig.php- gc- /NQvendor/danog/madelineproto/src/danog/MadelineProto/SecretChats/AuthKeyHandler.phpEgcEh0Qvendor/danog/madelineproto/src/danog/MadelineProto/SecretChats/MessageHandler.phpE0gcE0Y'IOvendor/danog/madelineproto/src/danog/MadelineProto/SecretChats/SeqNoHandler.phpgc3 qRvendor/danog/madelineproto/src/danog/MadelineProto/SecretChats/ResponseHandler.php7gc7&\-Cvendor/danog/madelineproto/src/danog/MadelineProto/FileCallback.phpgcIJAvendor/danog/madelineproto/src/danog/MadelineProto/APIWrapper.phpgcG]IPvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/AckHandler.phpYgcYS񝗤Mvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/Session.phpmgcmj'Rvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/MsgIdHandler.php2 gc2 00Tvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/AuthKeyHandler.phpClgcClavendor/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/MsgIdHandler/MsgIdHandler64.phpgcQRvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/SeqNoHandler.php gc ,Uvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/ResponseHandler.phpVgcVuQvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/CallHandler.php%gc%Nvendor/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/Reliable.phpgc'Dvendor/danog/madelineproto/src/danog/MadelineProto/Db/RedisArray.php;gc;UKvendor/danog/madelineproto/src/danog/MadelineProto/Db/DbPropertiesTrait.phpgcMU4 Mvendor/danog/madelineproto/src/danog/MadelineProto/Db/DbPropertiesFactory.php> gc> msIvendor/danog/madelineproto/src/danog/MadelineProto/Db/ArrayCacheTrait.php gc g솤Gvendor/danog/madelineproto/src/danog/MadelineProto/Db/PostgresArray.php gc \J@vendor/danog/madelineproto/src/danog/MadelineProto/Db/DbType.phpkgckEvendor/danog/madelineproto/src/danog/MadelineProto/Db/MemoryArray.php gc T&Fvendor/danog/madelineproto/src/danog/MadelineProto/Db/Driver/Redis.phpgcȤIvendor/danog/madelineproto/src/danog/MadelineProto/Db/Driver/Postgres.php gc c孤Fvendor/danog/madelineproto/src/danog/MadelineProto/Db/Driver/Mysql.phpgc‘Dvendor/danog/madelineproto/src/danog/MadelineProto/Db/MysqlArray.php gc ۡHNvendor/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/RedisArray.phpgc Rvendor/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/NullCacheTrait.phpbgcbPQvendor/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/PostgresArray.phpgcbNvendor/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/MysqlArray.phpgc `Avendor/danog/madelineproto/src/danog/MadelineProto/Db/DbArray.phptgct9/,Bvendor/danog/madelineproto/src/danog/MadelineProto/Db/SqlArray.phpgcd ҤEvendor/danog/madelineproto/src/danog/MadelineProto/Db/DriverArray.php=gc=E"Rvendor/danog/madelineproto/src/danog/MadelineProto/NothingInTheSocketException.php,gc,C:vendor/danog/madelineproto/src/danog/MadelineProto/API.phpMgcMkp>פHvendor/danog/madelineproto/src/danog/MadelineProto/ResponseException.php~gc~?vendor/danog/madelineproto/src/danog/MadelineProto/TL_botAPI.tlBgcB_Mvendor/danog/madelineproto/src/danog/MadelineProto/Stream/BufferInterface.phpgcYEvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Ogg/Ogg.php.gc.s0Rvendor/danog/madelineproto/src/danog/MadelineProto/Stream/ProxyStreamInterface.phpgcRvendor/danog/madelineproto/src/danog/MadelineProto/Stream/WriteBufferInterface.phpgcvPPvendor/danog/madelineproto/src/danog/MadelineProto/Stream/RawStreamInterface.phpgc!LMvendor/danog/madelineproto/src/danog/MadelineProto/Stream/StreamInterface.phpfgcf?MVvendor/danog/madelineproto/src/danog/MadelineProto/Stream/ADNLTransport/ADNLStream.php gc QUzMvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Async/RawStream.php&gc&O=Rvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Async/BufferedStream.phpgcjJvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Async/Buffer.phpgc!YTvendor/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoBufferInterface.phpgc·Zvendor/danog/madelineproto/src/danog/MadelineProto/Stream/BufferedProxyStreamInterface.phpgcjy MQvendor/danog/madelineproto/src/danog/MadelineProto/Stream/ReadBufferInterface.phpgc:XW]vendor/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/AbridgedStream.phpr gcr tyavendor/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/IntermediateStream.php gc Yvendor/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/FullStream.php6gc66gvendor/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/IntermediatePaddedStream.php5 gc5 <Yvendor/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/HttpStream.phpgce=_vendor/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/ObfuscatedStream.phpgc=Zvendor/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/HttpsStream.php/gc/gNvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Proxy/SocksProxy.php!gc! äMvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Proxy/HttpProxy.phpgcʿQvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/WssStream.phpgcNUvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/PremadeStream.phpi gci 62Uvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/DefaultStream.phpgc>/Pvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/WsStream.php'gc'Uvendor/danog/madelineproto/src/danog/MadelineProto/Stream/RawProxyStreamInterface.phpgcI4KUvendor/danog/madelineproto/src/danog/MadelineProto/Stream/BufferedStreamInterface.phpqgcq#Wvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Common/FileBufferedStream.phpgc:|oNvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Common/CtrStream.php:gc: ȤVvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Common/BufferedRawStream.phpgc\\vendor/danog/madelineproto/src/danog/MadelineProto/Stream/Common/SimpleBufferedRawStream.php gc y Yvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Common/HashedBufferedStream.phpJ"gcJ"t2=Vvendor/danog/madelineproto/src/danog/MadelineProto/Stream/Common/UdpBufferedStream.phpgck2Ovendor/danog/madelineproto/src/danog/MadelineProto/Stream/ConnectionContext.php)gc)@vendor/danog/madelineproto/src/danog/MadelineProto/Exception.phpgcФHvendor/danog/madelineproto/src/danog/MadelineProto/Bug74586Exception.phpgc`]Cvendor/danog/madelineproto/src/danog/MadelineProto/DoHConnector.phpH!gcH!y Avendor/danog/madelineproto/src/danog/MadelineProto/Conversion.phpEgcEUȤLvendor/danog/madelineproto/src/danog/MadelineProto/FileCallbackInterface.php[gc[x*Fvendor/danog/madelineproto/src/danog/MadelineProto/TL_telegram_v151.tltgctkzդDvendor/danog/madelineproto/src/danog/MadelineProto/TL/TLCallback.php: gc: #5&Cvendor/danog/madelineproto/src/danog/MadelineProto/TL/TLMethods.phpgcsHvendor/danog/madelineproto/src/danog/MadelineProto/TL/TLConstructors.php%gc%mӤIvendor/danog/madelineproto/src/danog/MadelineProto/TL/PrettyException.phpygcy14<vendor/danog/madelineproto/src/danog/MadelineProto/TL/TL.php gc zFvendor/danog/madelineproto/src/danog/MadelineProto/TL/Types/Button.phpgcEvendor/danog/madelineproto/src/danog/MadelineProto/TL/Types/Bytes.php gc JrPvendor/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/BotAPIFiles.php+gc+EUPvendor/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/DOMEntities.php gc gZKvendor/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/BotAPI.phpC`gcC` QNvendor/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/Exception.phpgcCGvendor/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/TD.php1"gc1""Nvendor/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/Extension.php gc ʋMvendor/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/Entities.php|gc|ϤCvendor/danog/madelineproto/src/danog/MadelineProto/TL/Exception.phpjgcj<|Bvendor/danog/madelineproto/src/danog/MadelineProto/TL/TLParams.phpRgcRG?vendor/danog/madelineproto/src/danog/MadelineProto/Shutdown.php gc .'Cvendor/danog/madelineproto/src/danog/MadelineProto/EventHandler.phpgcp:vendor/danog/madelineproto/src/danog/MadelineProto/RSA.php# gc# Hy-6:vendor/danog/madelineproto/src/danog/MadelineProto/Lua.php_gc_SnIvendor/danog/madelineproto/src/danog/MadelineProto/AbstractAPIFactory.phpgch7Avendor/danog/madelineproto/src/danog/MadelineProto/Connection.phpMgcM<vendor/danog/madelineproto/src/danog/MadelineProto/Tools.php!gc!|FF<vendor/danog/madelineproto/src/danog/MadelineProto/Magic.phpTgcTq%Cvendor/danog/madelineproto/src/danog/MadelineProto/Files/Server.phpgc=P\;vendor/danog/madelineproto/src/danog/MadelineProto/VoIP.phpFgcF}>vendor/danog/madelineproto/src/danog/MadelineProto/FastAPI.phpgc!ja?vendor/danog/madelineproto/src/danog/MadelineProto/Settings.php5gc5R;@vendor/danog/madelineproto/src/danog/MadelineProto/PsrLogger.phpgc%ŤFvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Logger.php^gc^MHvendor/danog/madelineproto/src/danog/MadelineProto/Settings/TLSchema.phpgc݉Mvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Serialization.phpgcaCvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Ipc.phpgc-2Ivendor/danog/madelineproto/src/danog/MadelineProto/Settings/Templates.phpgc}pDNvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Redis.php gc :Qvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Postgres.phpgcOvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Memory.phpgcҤNvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Mysql.phpgcTvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Database/SqlAbstract.phpc gcc L'Yvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Database/DatabaseAbstract.php gc DCvendor/danog/madelineproto/src/danog/MadelineProto/Settings/RPC.phpL gcL jDvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Peer.php gc {@,'Dvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Auth.php gc x Kvendor/danog/madelineproto/src/danog/MadelineProto/Settings/SecretChats.php%gc%xGvendor/danog/madelineproto/src/danog/MadelineProto/Settings/AppInfo.phpgcEWlJvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Connection.php}Igc}IcEvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Files.php gc ^͟Pvendor/danog/madelineproto/src/danog/MadelineProto/Settings/DatabaseAbstract.phpgcgPڤDvendor/danog/madelineproto/src/danog/MadelineProto/Settings/VoIP.phpgc(Cvendor/danog/madelineproto/src/danog/MadelineProto/Settings/Pwr.phpgc ѤDvendor/danog/madelineproto/src/danog/MadelineProto/SettingsEmpty.phpgc-hFXvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Generic/PeriodicLoopInternal.phpgcLۤOvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Generic/GenericLoop.phpgcL+Pvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Generic/PeriodicLoop.phpgc/1Cvendor/danog/madelineproto/src/danog/MadelineProto/Loop/APILoop.phpgc]ϤHvendor/danog/madelineproto/src/danog/MadelineProto/Loop/InternalLoop.phpgcԗϤFvendor/danog/madelineproto/src/danog/MadelineProto/Loop/LoggerLoop.php gc Ovendor/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/PingLoop.php gc MȾSvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/HttpWaitLoop.phpd gcd ?/Mvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/Common.phpgc-Pvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/CheckLoop.php"gc"Zm;Ovendor/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/ReadLoop.phpv+gcv+KRvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/CleanupLoop.phpgc "Pvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/WriteLoop.phpFgcF[Mvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Update/UpdateLoop.php8,gc8,Qvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Update/SecretFeedLoop.php gc ,Kvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Update/FeedLoop.php,gc,WFJvendor/danog/madelineproto/src/danog/MadelineProto/Loop/Update/SeqLoop.php'gc'6,?vendor/danog/madelineproto/src/danog/MadelineProto/TL_secret.tlgcyIvendor/danog/madelineproto/src/danog/MadelineProto/AnnotationsBuilder.phpNgcNpJvendor/danog/madelineproto/src/danog/MadelineProto/DocsBuilder/Methods.php%?gc%?.vOOvendor/danog/madelineproto/src/danog/MadelineProto/DocsBuilder/Constructors.php6gc6-Cvendor/danog/madelineproto/src/danog/MadelineProto/SessionPaths.phpgc=vendor/danog/madelineproto/src/danog/MadelineProto/Snitch.php gc OCvendor/danog/madelineproto/src/danog/MadelineProto/TL_mtproto_v1.tlWgcWrn֤3vendor/danog/tg-file-decoder/.php-cs-fixer.dist.phpgcX*vendor/danog/tg-file-decoder/composer.jsongc Mvendor/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceThumbnail.php gc QBJvendor/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceLegacy.phpgc Ovendor/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceDialogPhoto.phpS gcS IEWvendor/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceStickersetThumbnail.php$ gc$ (^vendor/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceStickersetThumbnailVersion.phpu gcu 54vendor/danog/tg-file-decoder/src/PhotoSizeSource.phpgc΃4+vendor/danog/tg-file-decoder/src/FileId.php-<gc-<)vendor/danog/tg-file-decoder/src/type.php7Egc7E&1vendor/danog/tg-file-decoder/src/UniqueFileId.php,gc,-vendor/danog/dns-over-https/lib/DoHConfig.phpgcx7vendor/danog/dns-over-https/lib/Rfc8484StubResolver.php>gc>Ruu.vendor/danog/dns-over-https/lib/Nameserver.phpgcBk23vendor/danog/dns-over-https/lib/Internal/Socket.phpgco:XK8vendor/danog/dns-over-https/lib/Internal/HttpsSocket.phpgc0vendor/danog/dns-over-https/lib/DoHException.phpqgcqg)vendor/danog/dns-over-https/composer.jsongczb!vendor/danog/ipc/test/IpcTest.phpgcn-vendor/danog/ipc/test/Fixtures/echoServer.phpgcq)vendor/danog/ipc/test/Fixtures/server.phpMgcMf"vendor/danog/ipc/lib/IpcServer.php[ gc[ o^[+vendor/danog/ipc/lib/PendingAcceptError.phpgcGˤ"vendor/danog/ipc/lib/functions.php gc n.vendor/danog/ipc/lib/Sync/ChannelledSocket.php"gc"䑋-vendor/danog/ipc/lib/Sync/ChannelCloseMsg.php>gc>$vendor/danog/ipc/lib/Sync/Parcel.phpgc(vendor/danog/ipc/lib/Sync/PanicError.phpzgczL-vendor/danog/ipc/lib/Sync/ChannelCloseAck.php[gc[H%vendor/danog/ipc/lib/Sync/Channel.phpgc.vendor/danog/ipc/lib/Sync/ChannelException.phpNgcN|2vendor/danog/ipc/lib/Sync/SynchronizationError.phpNgcNc4-vendor/danog/ipc/lib/Sync/ChannelCloseReq.php[gc[+vendor/danog/ipc/lib/Sync/ChannelParser.php gc Z.vendor/danog/ipc/lib/Sync/ChannelledStream.phpgcNY4vendor/danog/ipc/lib/Sync/SerializationException.phpTgcT~Dͤ+vendor/danog/ipc/lib/IpcServerException.phpgcSvendor/danog/ipc/composer.jsongc.ss$vendor/danog/ipc/examples/client.phpEgcEđ$vendor/danog/ipc/examples/server.phpgc PQ,vendor/danog/magicalserializer/composer.jsongcއ$vendor/danog/magicalserializer/b.phpgcŽ&{:vendor/danog/magicalserializer/src/danog/Serialization.phpgcV9vendor/danog/magicalserializer/src/danog/Serializable.phpgcY8vendor/danog/magicalserializer/src/danog/PlaceHolder.phptgct't$vendor/danog/magicalserializer/a.phpNgcN]2vendor/danog/primemodule/lib/danog/PrimeModule.php;gc;8։/vendor/danog/primemodule/lib/danog/alt_prime.pygc_3{+vendor/danog/primemodule/lib/danog/prime.py-gc-B&vendor/danog/primemodule/composer.json>gc>Te#vendor/danog/loop/test/LoopTest.php gc `#vendor/danog/loop/test/Fixtures.php gc @z%vendor/danog/loop/test/SignalTest.php7 gc7 Zۤ&vendor/danog/loop/test/GenericTest.phpE gcE 'vendor/danog/loop/test/PeriodicTest.php gc ͒'vendor/danog/loop/test/Traits/Basic.phpgc8 J(vendor/danog/loop/test/Traits/Signal.phpDgcDSuߕ)vendor/danog/loop/test/Traits/Logging.phpgc!פ.vendor/danog/loop/test/Traits/LoggingPause.phpgcE+vendor/danog/loop/test/Traits/Resumable.php;gc;bU#0vendor/danog/loop/test/Traits/BasicException.phpgc9"(vendor/danog/loop/test/ResumableTest.phpgc'Z5vendor/danog/loop/test/Interfaces/SignalInterface.phpgcIݤ8vendor/danog/loop/test/Interfaces/ResumableInterface.phpgcC4vendor/danog/loop/test/Interfaces/BasicInterface.phpgc EH7vendor/danog/loop/test/Interfaces/IntervalInterface.php gc tB;vendor/danog/loop/test/Interfaces/LoggingPauseInterface.phpgc`ؤ6vendor/danog/loop/test/Interfaces/LoggingInterface.phpgc"-vendor/danog/loop/lib/ResumableSignalLoop.php|gc|`Ǥ'vendor/danog/loop/lib/ResumableLoop.php gc |X ɤ$vendor/danog/loop/lib/SignalLoop.phpgcX+-vendor/danog/loop/lib/Generic/GenericLoop.php*gc*ъ[.vendor/danog/loop/lib/Generic/PeriodicLoop.php gc cvendor/danog/loop/lib/Loop.phpgcs2.vendor/danog/loop/lib/Traits/ResumableLoop.phpgcǸ+vendor/danog/loop/lib/Traits/SignalLoop.php"gc"m;!%vendor/danog/loop/lib/Traits/Loop.php gc jo2vendor/danog/loop/lib/Interfaces/LoopInterface.phpYgcY8vendor/danog/loop/lib/Interfaces/SignalLoopInterface.phpgcNL;vendor/danog/loop/lib/Interfaces/ResumableLoopInterface.phpgck\vendor/danog/loop/composer.jsongcf3vendor/danog/loop/examples/1. Basic/GenericLoop.phpMgcMVg*4vendor/danog/loop/examples/1. Basic/PeriodicLoop.php<gc<1>vendor/danog/loop/examples/2. Advanced/ResumableSignalLoop.phpgc٣8vendor/danog/loop/examples/2. Advanced/ResumableLoop.phpvgcvw 55vendor/danog/loop/examples/2. Advanced/SignalLoop.phpgcD/vendor/danog/loop/examples/2. Advanced/Loop.php-gc-ͤ8vendor/danog/libdns-json/test/JsonDecoderFactoryTest.php^gc^q@1vendor/danog/libdns-json/test/JsonDecoderTest.phpgc9vendor/danog/libdns-json/test/QueryEncoderFactoryTest.phpdgcdL[L2vendor/danog/libdns-json/test/QueryEncoderTest.phpgcR-vendor/danog/libdns-json/lib/QueryEncoder.phpgchY9,vendor/danog/libdns-json/lib/JsonDecoder.php2gc2W`3vendor/danog/libdns-json/lib/JsonDecoderFactory.phpgc&4vendor/danog/libdns-json/lib/QueryEncoderFactory.php4gc4lY Ȥ&vendor/danog/libdns-json/composer.json:gc:9K*vendor/league/uri-interfaces/composer.jsongcm<vendor/league/uri-interfaces/src/Contracts/HostInterface.php[gc[=|;vendor/league/uri-interfaces/src/Contracts/UriException.phpogcoEF@vendor/league/uri-interfaces/src/Contracts/DataPathInterface.php gc Ѥ>vendor/league/uri-interfaces/src/Contracts/IpHostInterface.phpgcz!Bvendor/league/uri-interfaces/src/Contracts/DomainHostInterface.php gc QDvendor/league/uri-interfaces/src/Contracts/UriComponentInterface.php gc Aؤ<vendor/league/uri-interfaces/src/Contracts/PortInterface.phpgc³<vendor/league/uri-interfaces/src/Contracts/PathInterface.phpH gcH l֨DAvendor/league/uri-interfaces/src/Contracts/AuthorityInterface.php gc /;vendor/league/uri-interfaces/src/Contracts/UriInterface.php,)gc,)%@vendor/league/uri-interfaces/src/Contracts/FragmentInterface.phpgc Ԥ=vendor/league/uri-interfaces/src/Contracts/QueryInterface.phpgcX@vendor/league/uri-interfaces/src/Contracts/UserInfoInterface.phpgcEvendor/league/uri-interfaces/src/Contracts/SegmentedPathInterface.phpbgcb֘ҤFvendor/league/uri-interfaces/src/Exceptions/FileinfoSupportMissing.phpgc Dvendor/league/uri-interfaces/src/Exceptions/IdnaConversionFailed.phpRgcR,H;vendor/league/uri-interfaces/src/Exceptions/SyntaxError.phpgcI2Avendor/league/uri-interfaces/src/Exceptions/IdnSupportMissing.phpgck[.vendor/league/uri-interfaces/src/Idna/Idna.phpgc 2vendor/league/uri-interfaces/src/Idna/IdnaInfo.phpgcvendor/league/uri/composer.json gc ~vendor/league/uri/src/Http.phpgciK%vendor/league/uri/src/HttpFactory.php(gc(\!vendor/league/uri/src/UriInfo.phpgc5 %vendor/league/uri/src/UriTemplate.phpgcuDa%vendor/league/uri/src/UriResolver.php7(gc7(==vendor/league/uri/src/Exceptions/TemplateCanNotBeExpanded.php^gc^Cv#vendor/league/uri/src/UriString.php9gc96@դvendor/league/uri/src/Uri.phpgcZ靤.vendor/league/uri/src/UriTemplate/Template.phpgc{8}ͤ1vendor/league/uri/src/UriTemplate/VariableBag.phpgc򄍎2vendor/league/uri/src/UriTemplate/VarSpecifier.php gc p0vendor/league/uri/src/UriTemplate/Expression.php$gc$3&vendor/league/uri-parser/composer.json>gc>'*vendor/league/uri-parser/src/functions.php4 gc4 >X*vendor/league/uri-parser/src/Exception.php gc 3~2vendor/league/uri-parser/src/MissingIdnSupport.phpgcZ?2vendor/league/uri-parser/src/functions_include.phpgca]l'vendor/league/uri-parser/src/Parser.phpzZgczZ$vendor/monolog/monolog/composer.json gc KF-vendor/monolog/monolog/src/Monolog/Logger.php[Qgc[Qa:vendor/monolog/monolog/src/Monolog/ResettableInterface.phpgcG;vendor/monolog/monolog/src/Monolog/Handler/GroupHandler.php gc >>vendor/monolog/monolog/src/Monolog/Handler/SamplingHandler.phpgc@v<vendor/monolog/monolog/src/Monolog/Handler/SyslogHandler.phpsgcsrE:vendor/monolog/monolog/src/Monolog/Handler/GelfHandler.phpwgcw_9Fvendor/monolog/monolog/src/Monolog/Handler/ProcessableHandlerTrait.phpgcZ=vendor/monolog/monolog/src/Monolog/Handler/HandlerWrapper.php gc CޤBvendor/monolog/monolog/src/Monolog/Handler/SyslogUdp/UdpSocket.phpxgcxHvendor/monolog/monolog/src/Monolog/Handler/MissingExtensionException.phpgc>vendor/monolog/monolog/src/Monolog/Handler/FlowdockHandler.php gc ?vendor/monolog/monolog/src/Monolog/Handler/FleepHookHandler.php gc _[=vendor/monolog/monolog/src/Monolog/Handler/MongoDBHandler.php gc C8vendor/monolog/monolog/src/Monolog/Handler/Curl/Util.phpggcg鯤>vendor/monolog/monolog/src/Monolog/Handler/DynamoDbHandler.php gc @_?vendor/monolog/monolog/src/Monolog/Handler/SyslogUdpHandler.phpgcH@vendor/monolog/monolog/src/Monolog/Handler/LogEntriesHandler.phpgc g9vendor/monolog/monolog/src/Monolog/Handler/SqsHandler.phpgc!Bvendor/monolog/monolog/src/Monolog/Handler/RotatingFileHandler.phpgcIL>vendor/monolog/monolog/src/Monolog/Handler/ErrorLogHandler.php gc @vendor/monolog/monolog/src/Monolog/Handler/Slack/SlackRecord.php)gc)$p:vendor/monolog/monolog/src/Monolog/Handler/NullHandler.php9gc9IkDvendor/monolog/monolog/src/Monolog/Handler/AbstractSyslogHandler.php gc 5?6Fvendor/monolog/monolog/src/Monolog/Handler/WhatFailureGroupHandler.phpgcV<vendor/monolog/monolog/src/Monolog/Handler/BufferHandler.php$gc$>9vendor/monolog/monolog/src/Monolog/Handler/PsrHandler.php gc r!lAvendor/monolog/monolog/src/Monolog/Handler/TelegramBotHandler.php gc 4ƌL;vendor/monolog/monolog/src/Monolog/Handler/RedisHandler.php gc G6vendor/monolog/monolog/src/Monolog/Handler/Handler.phpgc4Evendor/monolog/monolog/src/Monolog/Handler/DoctrineCouchDBHandler.phphgch=Hvendor/monolog/monolog/src/Monolog/Handler/WebRequestRecognizerTrait.php gc yJvendor/monolog/monolog/src/Monolog/Handler/FormattableHandlerInterface.phpMgcMB魤Cvendor/monolog/monolog/src/Monolog/Handler/SymfonyMailerHandler.php gc 蕮Bvendor/monolog/monolog/src/Monolog/Handler/SlackWebhookHandler.phpSgcS`<>vendor/monolog/monolog/src/Monolog/Handler/OverflowHandler.phpgccR<vendor/monolog/monolog/src/Monolog/Handler/StreamHandler.phpJgcJbT,Dvendor/monolog/monolog/src/Monolog/Handler/BrowserConsoleHandler.php##gc##'dxʤ@vendor/monolog/monolog/src/Monolog/Handler/InsightOpsHandler.php:gc:Dvendor/monolog/monolog/src/Monolog/Handler/FingersCrossedHandler.php!gc!+Cvendor/monolog/monolog/src/Monolog/Handler/ElasticsearchHandler.phpogcofT>vendor/monolog/monolog/src/Monolog/Handler/NewRelicHandler.phpCgcCR;vendor/monolog/monolog/src/Monolog/Handler/IFTTTHandler.phpgcwӤHvendor/monolog/monolog/src/Monolog/Handler/AbstractProcessingHandler.phpzgczm>vendor/monolog/monolog/src/Monolog/Handler/PushoverHandler.phpgc{”Jvendor/monolog/monolog/src/Monolog/Handler/ProcessableHandlerInterface.phpgcy:0>vendor/monolog/monolog/src/Monolog/Handler/ElasticaHandler.php gc +:vendor/monolog/monolog/src/Monolog/Handler/TestHandler.php^gc^b=vendor/monolog/monolog/src/Monolog/Handler/CouchDBHandler.php7gc7M>vendor/monolog/monolog/src/Monolog/Handler/SendGridHandler.php7 gc7 $sM:vendor/monolog/monolog/src/Monolog/Handler/MailHandler.php% gc% ww>vendor/monolog/monolog/src/Monolog/Handler/LogmaticHandler.php gc ܩZvendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ErrorLevelActivationStrategy.phpNgcND?Yvendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ActivationStrategyInterface.phpgc0C\vendor/monolog/monolog/src/Monolog/Handler/FingersCrossed/ChannelLevelActivationStrategy.php gc f&Fvendor/monolog/monolog/src/Monolog/Handler/FormattableHandlerTrait.phpgcy`Bvendor/monolog/monolog/src/Monolog/Handler/NativeMailerHandler.phpkgck^wn#:vendor/monolog/monolog/src/Monolog/Handler/NoopHandler.phppgcph=vendor/monolog/monolog/src/Monolog/Handler/RollbarHandler.phpT gcT Y,<vendor/monolog/monolog/src/Monolog/Handler/SocketHandler.php/gc/?p#Cvendor/monolog/monolog/src/Monolog/Handler/DeduplicationHandler.phpgcDi$h:vendor/monolog/monolog/src/Monolog/Handler/AmqpHandler.php|gc|'ؤ?vendor/monolog/monolog/src/Monolog/Handler/HandlerInterface.php gc 6<vendor/monolog/monolog/src/Monolog/Handler/LogglyHandler.phpgcFAvendor/monolog/monolog/src/Monolog/Handler/ZendMonitorHandler.phpA gcA =ڤ>vendor/monolog/monolog/src/Monolog/Handler/AbstractHandler.php[ gc[ פ@vendor/monolog/monolog/src/Monolog/Handler/PHPConsoleHandler.php,)gc,)vY<vendor/monolog/monolog/src/Monolog/Handler/FilterHandler.phpgc#;vendor/monolog/monolog/src/Monolog/Handler/SlackHandler.phplgcl=vendor/monolog/monolog/src/Monolog/Handler/ProcessHandler.php_gc_Vb?vendor/monolog/monolog/src/Monolog/Handler/ChromePHPHandler.phpgcaPޤ:vendor/monolog/monolog/src/Monolog/Handler/CubeHandler.phpgcexAvendor/monolog/monolog/src/Monolog/Handler/RedisPubSubHandler.phpgcZCvendor/monolog/monolog/src/Monolog/Handler/FallbackGroupHandler.phpgcVAvendor/monolog/monolog/src/Monolog/Handler/SwiftMailerHandler.phpUgcU8 r=vendor/monolog/monolog/src/Monolog/Handler/FirePHPHandler.phpgc>vendor/monolog/monolog/src/Monolog/Handler/MandrillHandler.php gc H78vendor/monolog/monolog/src/Monolog/DateTimeImmutable.php=gc=v$4vendor/monolog/monolog/src/Monolog/Test/TestCase.phpn gcn Mn3vendor/monolog/monolog/src/Monolog/ErrorHandler.php**gc**4=vendor/monolog/monolog/src/Monolog/Processor/TagProcessor.phpbgcb{=vendor/monolog/monolog/src/Monolog/Processor/GitProcessor.phpgcx\ˤBvendor/monolog/monolog/src/Monolog/Processor/HostnameProcessor.phpgcaGvendor/monolog/monolog/src/Monolog/Processor/PsrLogMessageProcessor.phpF gcF ^ɌTGvendor/monolog/monolog/src/Monolog/Processor/IntrospectionProcessor.phpgc .f=vendor/monolog/monolog/src/Monolog/Processor/UidProcessor.phpgcxפEvendor/monolog/monolog/src/Monolog/Processor/MemoryUsageProcessor.php1gc1)ƤIvendor/monolog/monolog/src/Monolog/Processor/MemoryPeakUsageProcessor.phpDgcD=vendor/monolog/monolog/src/Monolog/Processor/WebProcessor.php gc j:@vendor/monolog/monolog/src/Monolog/Processor/MemoryProcessor.php#gc#a ߤCvendor/monolog/monolog/src/Monolog/Processor/MercurialProcessor.phphgch:DCCvendor/monolog/monolog/src/Monolog/Processor/ProcessorInterface.phpgcY^Cvendor/monolog/monolog/src/Monolog/Processor/ProcessIdProcessor.php_gc_Cvendor/monolog/monolog/src/Monolog/Attribute/AsMonologProcessor.phpgc(դ>vendor/monolog/monolog/src/Monolog/Formatter/HtmlFormatter.phpgc& Cvendor/monolog/monolog/src/Monolog/Formatter/ChromePHPFormatter.php`gc`](MCvendor/monolog/monolog/src/Monolog/Formatter/FormatterInterface.phpgc4z@vendor/monolog/monolog/src/Monolog/Formatter/ScalarFormatter.phpgcF>vendor/monolog/monolog/src/Monolog/Formatter/JsonFormatter.phpgcnBvendor/monolog/monolog/src/Monolog/Formatter/WildfireFormatter.phpagca13cEvendor/monolog/monolog/src/Monolog/Formatter/GelfMessageFormatter.phpEgcEA'@vendor/monolog/monolog/src/Monolog/Formatter/LogglyFormatter.phpgc ؑLvendor/monolog/monolog/src/Monolog/Formatter/GoogleCloudLoggingFormatter.php.gc.|#<>vendor/monolog/monolog/src/Monolog/Formatter/LineFormatter.php gc R;Bvendor/monolog/monolog/src/Monolog/Formatter/LogmaticFormatter.phpgcqRDvendor/monolog/monolog/src/Monolog/Formatter/NormalizerFormatter.phpfgcfȤAvendor/monolog/monolog/src/Monolog/Formatter/MongoDBFormatter.phplgclAvendor/monolog/monolog/src/Monolog/Formatter/FluentdFormatter.phpgcXBvendor/monolog/monolog/src/Monolog/Formatter/FlowdockFormatter.php gc Bvendor/monolog/monolog/src/Monolog/Formatter/LogstashFormatter.phpJ gcJ Gvendor/monolog/monolog/src/Monolog/Formatter/ElasticsearchFormatter.phpEgcEƤBvendor/monolog/monolog/src/Monolog/Formatter/ElasticaFormatter.phpgc1e/vendor/monolog/monolog/src/Monolog/Registry.phpgc bt4vendor/monolog/monolog/src/Monolog/SignalHandler.phpgcؤ,vendor/monolog/monolog/src/Monolog/Utils.phpA%gcA%7Dɤ0vendor/monolog/monolog/src/Monolog/LogRecord.phpgcT%vendor/erusev/parsedown/Parsedown.phpgc7~%vendor/erusev/parsedown/composer.jsongc4%vendor/psr/http-factory/composer.jsongc2d=7vendor/psr/http-factory/src/RequestFactoryInterface.phpgcrTX8vendor/psr/http-factory/src/ResponseFactoryInterface.php"gc"X=vendor/psr/http-factory/src/ServerRequestFactoryInterface.phpgcBHA3vendor/psr/http-factory/src/UriFactoryInterface.phpEgcEDh6vendor/psr/http-factory/src/StreamFactoryInterface.phpgcyۜ<vendor/psr/http-factory/src/UploadedFileFactoryInterface.phpVgcV!%vendor/psr/http-message/composer.jsonmgcm0vendor/psr/http-message/src/RequestInterface.phpgcԤ0vendor/psr/http-message/src/MessageInterface.phpgcz //vendor/psr/http-message/src/StreamInterface.phpgc=fbr1vendor/psr/http-message/src/ResponseInterface.php gc -{6vendor/psr/http-message/src/ServerRequestInterface.phpr'gcr'_,vendor/psr/http-message/src/UriInterface.php?1gc?1?.5vendor/psr/http-message/src/UploadedFileInterface.phpQgcQ㭢vvendor/psr/log/composer.json+gc+&vendor/psr/log/src/LoggerInterface.phpA gcA AaH'vendor/psr/log/src/LoggerAwareTrait.phpgc>"vendor/psr/log/src/LoggerTrait.phpwgcw +vendor/psr/log/src/LoggerAwareInterface.php/gc/~!vendor/psr/log/src/NullLogger.phpgcK;vendor/psr/log/src/LogLevel.phpPgcP/vendor/psr/log/src/InvalidArgumentException.php`gc` X1%vendor/psr/log/src/AbstractLogger.phpgcۛvendor/composer/installed.jsongc X%vendor/composer/autoload_classmap.phpKWgcKW'Un"vendor/composer/platform_check.phpgc vendor/composer/ClassLoader.php/@gc/@!mj'vendor/composer/autoload_namespaces.phpkgckJM>פ!vendor/composer/autoload_psr4.php gc D%vendor/composer/InstalledVersions.php:gc:畎K!vendor/composer/autoload_real.phpngcnBi٤vendor/composer/installed.phpIgcINn"vendor/composer/autoload_files.phpa gca />#vendor/composer/autoload_static.phpZgcZ+8-vendor/paragonie/random_compat/lib/random.php/gc/&,vendor/paragonie/random_compat/composer.jsonfgcfP|*1vendor/paragonie/random_compat/psalm-autoload.phpgc3vendor/paragonie/random_compat/other/build_phar.phpagcak}45vendor/paragonie/constant_time_encoding/composer.json1gc19f@vendor/paragonie/constant_time_encoding/src/EncoderInterface.phpgcq~6vendor/paragonie/constant_time_encoding/src/Binary.php gc #6vendor/paragonie/constant_time_encoding/src/Base64.phpw'gcw'] 6vendor/paragonie/constant_time_encoding/src/Base32.php:Dgc:DbS3vendor/paragonie/constant_time_encoding/src/Hex.php6gc6. ޤ9vendor/paragonie/constant_time_encoding/src/Base32Hex.phpY gcY Lߤ8vendor/paragonie/constant_time_encoding/src/Encoding.php~gc~KEvendor/paragonie/constant_time_encoding/src/Base64DotSlashOrdered.php gc EZ7vendor/paragonie/constant_time_encoding/src/RFC4648.phpgcxH=vendor/paragonie/constant_time_encoding/src/Base64UrlSafe.php gc ϧ>vendor/paragonie/constant_time_encoding/src/Base64DotSlash.php gc o~{.vendor/kelunik/certificate/lib/Certificate.phpgclf%פ*vendor/kelunik/certificate/lib/Profile.php<gc<ƗBŤ=vendor/kelunik/certificate/lib/FieldNotSupportedException.php`gc`\>vendor/kelunik/certificate/lib/InvalidCertificateException.phpagcaWZ֤(vendor/kelunik/certificate/composer.jsonSgcSR vendor/amphp/redis/composer.jsonrgcr+vendor/amphp/redis/src/RedisHyperLogLog.phpCgcCbE vendor/amphp/redis/src/Redis.phpjgcj_פ)vendor/amphp/redis/src/RedisException.phpXgcX*)vendor/amphp/redis/src/RedisSortedSet.php)gc)B4'vendor/amphp/redis/src/Subscription.phpgcG6ڤ/vendor/amphp/redis/src/QueryExecutorFactory.phpgcx(vendor/amphp/redis/src/QueryExecutor.php~gc~*-*vendor/amphp/redis/src/ParserException.phpNgcNz/X!vendor/amphp/redis/src/Config.phpgc7#vendor/amphp/redis/src/RedisMap.phpgc0T'$vendor/amphp/redis/src/functions.php gc |ns)vendor/amphp/redis/src/RemoteExecutor.phpgcR/vendor/amphp/redis/src/Mutex/MutexException.phprgcryA.vendor/amphp/redis/src/Mutex/LockException.phpRgcRs-vendor/amphp/redis/src/Mutex/MutexOptions.phpgcKf&vendor/amphp/redis/src/Mutex/Mutex.php|"gc|" Cxפ9vendor/amphp/redis/src/Mutex/ConnectionLimitException.php]gc]-% vendor/amphp/redis/src/Cache.phpIgcI.i$vendor/amphp/redis/src/RedisList.php7gc7 }*vendor/amphp/redis/src/SocketException.phpNgcNP<"%vendor/amphp/redis/src/RespSocket.php gc ,F0vendor/amphp/redis/src/RemoteExecutorFactory.phpgc%vendor/amphp/redis/src/SetOptions.phpgc. )vendor/amphp/redis/src/QueryException.phpMgcM(=&vendor/amphp/redis/src/SortOptions.php+ gc+ U H%vendor/amphp/redis/src/Subscriber.phpPgcPf%vendor/amphp/redis/src/RespParser.phpogco#vendor/amphp/redis/src/RedisSet.phpgcrä3vendor/amphp/sql-common/test/ConnectionPoolTest.phpO gcO G4vendor/amphp/sql-common/test/PooledResultSetTest.php3gc3f2vendor/amphp/sql-common/test/StatementPoolTest.php gc bܤ3vendor/amphp/sql-common/test/RetryConnectorTest.php gc 6P%vendor/amphp/sql-common/composer.jsongc)/vendor/amphp/sql-common/src/PooledStatement.phpgcԖi.vendor/amphp/sql-common/src/RetryConnector.phpWgcW=ˤ.vendor/amphp/sql-common/src/ConnectionPool.php2gc21vendor/amphp/sql-common/src/PooledTransaction.phpUgcU{R/vendor/amphp/sql-common/src/PooledResultSet.phpgc؜~-vendor/amphp/sql-common/src/StatementPool.php?gc?CΤ&vendor/amphp/http-client/composer.json gc (vendor/amphp/http-client/src/Request.php0<gc0<087Bvendor/amphp/http-client/src/EventListener/RecordHarAttributes.php gc %ԁ,vendor/amphp/http-client/src/RequestBody.phpggcgT)vendor/amphp/http-client/src/Trailers.phpgc|!9Z:vendor/amphp/http-client/src/Interceptor/RetryRequests.phpngcnv=vendor/amphp/http-client/src/Interceptor/AddRequestHeader.phpgc|bFvendor/amphp/http-client/src/Interceptor/TooManyRedirectsException.phpgc(G=vendor/amphp/http-client/src/Interceptor/SetRequestHeader.phpgc 0:vendor/amphp/http-client/src/Interceptor/ModifyRequest.phpTgcTeEvendor/amphp/http-client/src/Interceptor/SetResponseHeaderIfUnset.phpGgcGhAvendor/amphp/http-client/src/Interceptor/RemoveResponseHeader.php|gc|OJ?vendor/amphp/http-client/src/Interceptor/DecompressResponse.php) gc) _ `Dvendor/amphp/http-client/src/Interceptor/SetRequestHeaderIfUnset.php?gc?>vendor/amphp/http-client/src/Interceptor/SetResponseHeader.phpgc!;vendor/amphp/http-client/src/Interceptor/LogHttpArchive.php gc  #j;vendor/amphp/http-client/src/Interceptor/ModifyResponse.phpgc2Hp>vendor/amphp/http-client/src/Interceptor/SetRequestTimeout.phpgc4Qi>vendor/amphp/http-client/src/Interceptor/AddResponseHeader.phpgcE-:@vendor/amphp/http-client/src/Interceptor/RemoveRequestHeader.phpugcux48vendor/amphp/http-client/src/Interceptor/MatchOrigin.php= gc= )m>vendor/amphp/http-client/src/Interceptor/ForbidUriUserInfo.phpgc՘_<vendor/amphp/http-client/src/Interceptor/FollowRedirects.php0&gc0&HA)vendor/amphp/http-client/src/Response.phphgch*f3vendor/amphp/http-client/src/NetworkInterceptor.phpgc ^6vendor/amphp/http-client/src/MissingAttributeError.phpgcAޤ8vendor/amphp/http-client/src/InvalidRequestException.phpgcfZ=vendor/amphp/http-client/src/Internal/ForbidSerialization.phpgcМȩ7vendor/amphp/http-client/src/Internal/ForbidCloning.phpgc<vendor/amphp/http-client/src/Internal/ResponseBodyStream.phpgc?nAvendor/amphp/http-client/src/Internal/SizeLimitingInputStream.phpgc03vendor/amphp/http-client/src/Internal/functions.phpgc7vendor/amphp/http-client/src/Internal/HarAttributes.phpgccT.vendor/amphp/http-client/src/Body/JsonBody.phpgcYE/0vendor/amphp/http-client/src/Body/StringBody.phpgc.vendor/amphp/http-client/src/Body/FormBody.phpgci.vendor/amphp/http-client/src/Body/FileBody.phpgcq2vendor/amphp/http-client/src/HttpClientBuilder.phpgcQ60vendor/amphp/http-client/src/SocketException.phpYgcY=1vendor/amphp/http-client/src/TimeoutException.phpZgcZvendor/amphp/http-client/src/Connection/StreamLimitingPool.php gc }ؤBvendor/amphp/http-client/src/Connection/ConnectionLimitingPool.php1gc1/FDvendor/amphp/http-client/src/Connection/DefaultConnectionFactory.phpI%gcI%rU:vendor/amphp/http-client/src/Connection/ConnectionPool.phpgc}@vendor/amphp/http-client/src/Connection/Internal/Http1Parser.php4gc46E[@vendor/amphp/http-client/src/Connection/Internal/Http2Stream.php gc bw/Mvendor/amphp/http-client/src/Connection/Internal/Http2ConnectionProcessor.phpgcϴFvendor/amphp/http-client/src/Connection/Internal/RequestNormalizer.phpi gci q[W=vendor/amphp/http-client/src/Connection/ConnectionFactory.phpgciՖ6vendor/amphp/http-client/src/Connection/HttpStream.php6 gc6 љ!;vendor/amphp/http-client/src/Connection/Http1Connection.phpfgcf_ 2vendor/amphp/http-client/src/Connection/Stream.phprgcri>'6vendor/amphp/http-client/src/Connection/Connection.phpgcW]\Cvendor/amphp/http-client/src/Connection/UnlimitedConnectionPool.php^gc^m;vendor/amphp/http-client/src/Connection/Http2Connection.phpJ gcJ ld@vendor/amphp/http-client/src/Connection/Http2StreamException.phpNgcNTѴ.vendor/amphp/http-client/src/EventListener.phpgc߅1vendor/amphp/http-client/src/PooledHttpClient.phpgc;.vendor/amphp/http-client/src/HttpException.phpNgcNs H+vendor/amphp/http-client/src/HttpClient.phpgc$פ7vendor/amphp/http-client/src/ApplicationInterceptor.phpgcؐݤ/vendor/amphp/http-client/src/ParseException.phpgc{5ɤ#vendor/amphp/postgres/composer.jsonXgcX{)vendor/amphp/postgres/examples/listen.phpgcl+Ѥ/vendor/amphp/postgres/examples/multi-listen.phpgcYF.vendor/amphp/postgres/examples/transaction.phpgc4(vendor/amphp/postgres/examples/basic.phpSgcS7)#)vendor/amphp/postgres/src/PgSqlHandle.phpoCgcoClּ,vendor/amphp/postgres/src/PgSqlResultSet.phpMgcMD<i*vendor/amphp/postgres/src/PqConnection.php gc yg-vendor/amphp/postgres/src/PqCommandResult.php>gc>dF -vendor/amphp/postgres/src/PgSqlConnection.php gc V,vendor/amphp/postgres/src/PooledListener.phpWgcWM0vendor/amphp/postgres/src/ConnectionListener.phpgc;()vendor/amphp/postgres/src/PqStatement.phpgc[Mu-vendor/amphp/postgres/src/PooledStatement.phpgc=_*vendor/amphp/postgres/src/Notification.phpgc1vendor/amphp/postgres/src/PqBufferedResultSet.phpzgcz0&vendor/amphp/postgres/src/PqHandle.php>gc>'vendor/amphp/postgres/src/ResultSet.phpgc\.vendor/amphp/postgres/src/TimeoutConnector.phpggcgc1vendor/amphp/postgres/src/QueryExecutionError.phpgc3&vendor/amphp/postgres/src/Receiver.php gc w9.vendor/amphp/postgres/src/ConnectionConfig.php7 gc7 h2vendor/amphp/postgres/src/Internal/ArrayParser.phpgcI!0vendor/amphp/postgres/src/Internal/functions.phpK gcK w"vendor/amphp/postgres/src/Link.phpkgck.&vendor/amphp/postgres/src/Executor.php/gc/Hq3vendor/amphp/postgres/src/PqUnbufferedResultSet.php- gc- 5:Ĥ'vendor/amphp/postgres/src/functions.php gc L/vendor/amphp/postgres/src/PooledTransaction.phplgclMj0vendor/amphp/postgres/src/PgSqlCommandResult.php_gc_o$vendor/amphp/postgres/src/Handle.phpxgcxЙڤ&vendor/amphp/postgres/src/Listener.php"gc"͸D,vendor/amphp/postgres/src/PgSqlStatement.phpugcuU $vendor/amphp/postgres/src/Quoter.php`gc`K Ƥ(vendor/amphp/postgres/src/Connection.phpgc*2)vendor/amphp/postgres/src/Transaction.phpgcؤ3vendor/amphp/postgres/src/ConnectionTransaction.php gc F\-vendor/amphp/postgres/src/PooledResultSet.php4gc4z5ɤ,vendor/amphp/postgres/src/ParseException.php?gc? "vendor/amphp/postgres/src/Pool.phpgcrqQ+vendor/amphp/postgres/src/StatementPool.phpQgcQUHQ#vendor/amphp/file/test/FileTest.php gc s"vendor/amphp/file/test/Fixture.phpl gcl j)vendor/amphp/file/test/FilesystemTest.phpGgcG(vendor/amphp/file/test/AsyncFileTest.phpgcß.vendor/amphp/file/test/Driver/UvDriverTest.php_gc_q2vendor/amphp/file/test/Driver/BlockingFileTest.phpgc&t9vendor/amphp/file/test/Driver/StatusCachingDriverTest.php5gc5yp7vendor/amphp/file/test/Driver/StatusCachingFileTest.php/gc/_4vendor/amphp/file/test/Driver/BlockingDriverTest.php gc ./vendor/amphp/file/test/Driver/EioDriverTest.phpgc}j4vendor/amphp/file/test/Driver/ParallelDriverTest.phpgcƤ2vendor/amphp/file/test/Driver/ParallelFileTest.php gc },vendor/amphp/file/test/Driver/UvFileTest.phpgc9O-vendor/amphp/file/test/Driver/EioFileTest.phpgc~i2vendor/amphp/file/test/Sync/AsyncFileMutexTest.phpegcer%vendor/amphp/file/test/DriverTest.phpCgcCjvendor/amphp/file/composer.jsonigci-vendor/amphp/file/src/FilesystemException.phpgc$vendor/amphp/file/src/Filesystem.phpR-gcR-_7/vendor/amphp/file/src/Driver/BlockingDriver.phpo,gco, m-vendor/amphp/file/src/Driver/ParallelFile.phpgcj9"2vendor/amphp/file/src/Driver/StatusCachingFile.phpgc.])vendor/amphp/file/src/Driver/UvDriver.php#Egc#Eکx'vendor/amphp/file/src/Driver/UvFile.phpD"gcD"^](vendor/amphp/file/src/Driver/EioFile.php@!gc@!bXN*vendor/amphp/file/src/Driver/EioDriver.php9gc9-vendor/amphp/file/src/Driver/BlockingFile.phpgc C4vendor/amphp/file/src/Driver/StatusCachingDriver.phpgc'DL/vendor/amphp/file/src/Driver/ParallelDriver.phpgcY'vendor/amphp/sync/src/SyncException.phpGgcGj#vendor/amphp/sync/src/FileMutex.phpgcQ*vendor/amphp/parser/.php-cs-fixer.dist.phpgc+d!vendor/amphp/parser/composer.jsongc1vendor/amphp/parser/src/InvalidDelimiterError.phpgc\孤"vendor/amphp/parser/src/Parser.phpGgcGČ*F(vendor/amphp/serialization/composer.jsongcq43vendor/amphp/serialization/src/NativeSerializer.phpXgcXT-vendor/amphp/serialization/src/Serializer.phpgc+ ,vendor/amphp/serialization/src/functions.phpbgcbؤ8vendor/amphp/serialization/src/PassthroughSerializer.phpgcoL8vendor/amphp/serialization/src/CompressingSerializer.phpgc 1vendor/amphp/serialization/src/JsonSerializer.php< gc< 'É9vendor/amphp/serialization/src/SerializationException.phpYgcYK%vendor/amphp/hpack/tools/compress.php gc MI.vendor/amphp/hpack/tools/php-fuzzer/decode.phpgc2j4vendor/amphp/hpack/tools/php-fuzzer/decode-crash.phpgc$rS vendor/amphp/hpack/composer.jsongc7O%vendor/amphp/hpack/examples/bench.php+gc+U2vendor/amphp/hpack/src/Internal/huffman-lookup.phpgc&+vendor/amphp/hpack/src/Internal/amp-hpack.hgcF=a/vendor/amphp/hpack/src/Internal/HPackNative.php[gc[;-b0vendor/amphp/hpack/src/Internal/HPackNghttp2.phpXgcXm{1vendor/amphp/hpack/src/Internal/huffman-codes.phpAgcA3P vendor/amphp/hpack/src/HPack.php+gc+?त)vendor/amphp/hpack/src/HPackException.phpNgcN돤%vendor/amphp/cache/lib/ArrayCache.phpgc&vendor/amphp/cache/lib/PrefixCache.phpgc\.;&vendor/amphp/cache/lib/AtomicCache.php#gc#ԪQ$vendor/amphp/cache/lib/NullCache.phpZgcZpo^)vendor/amphp/cache/lib/CacheException.phpgc`}6 vendor/amphp/cache/lib/Cache.phpgcji*vendor/amphp/cache/lib/SerializedCache.phpB gcB D$vendor/amphp/cache/lib/FileCache.phpKgcK ȥ vendor/amphp/cache/composer.jsoncgcc|i(vendor/amphp/sql/test/QueryErrorTest.phpgcx9vendor/amphp/sql/composer.jsongcCa&vendor/amphp/sql/src/CommandResult.phpgc{ Ƥ"vendor/amphp/sql/src/Statement.php{gc{ؑOդ,vendor/amphp/sql/src/ConnectionException.phpRgcR!%K)vendor/amphp/sql/src/TransactionError.phpEgcE ?"vendor/amphp/sql/src/ResultSet.phpgcDb)vendor/amphp/sql/src/ConnectionConfig.php gc ,vendor/amphp/sql/src/Link.phpcgcc2,!vendor/amphp/sql/src/Executor.php@gc@"vendor/amphp/sql/src/Connector.phpgc3,)vendor/amphp/sql/src/FailureException.phpIgcIiѤ$vendor/amphp/sql/src/Transaction.phpgc"vendor/amphp/sql/src/PoolError.php>gc>.#vendor/amphp/sql/src/QueryError.phpgcvendor/amphp/sql/src/Pool.phpgc" *vendor/amphp/sql/src/TransientResource.phpigci9*vendor/amphp/dns/lib/NoRecordException.phpLgcLpa%vendor/amphp/dns/lib/DnsException.phpEgcEkLC,vendor/amphp/dns/lib/WindowsConfigLoader.php gc ,yR-vendor/amphp/dns/lib/InvalidNameException.phpOgcO8M1vendor/amphp/dns/lib/BlockingFallbackResolver.phpgcsn%vendor/amphp/dns/lib/ConfigLoader.phpsgcssEvendor/amphp/dns/lib/Config.phpgc |)vendor/amphp/dns/lib/UnixConfigLoader.phpgc;?[+vendor/amphp/dns/lib/Internal/TcpSocket.php gc O (vendor/amphp/dns/lib/Internal/Socket.phpgc+vendor/amphp/dns/lib/Internal/UdpSocket.php&gc& 9vendor/amphp/dns/lib/Record.php gc )"vendor/amphp/dns/lib/functions.php gc SC,vendor/amphp/dns/lib/Rfc1035StubResolver.php Pgc Pgk!vendor/amphp/dns/lib/Resolver.phpgcG8)vendor/amphp/dns/lib/TimeoutException.phpKgcKt#vendor/amphp/dns/lib/HostLoader.php gc C(vendor/amphp/dns/lib/ConfigException.phpAgcAvendor/amphp/dns/composer.json@gc@.vendor/amphp/parallel/lib/Worker/TaskError.phpgc 9vendor/amphp/parallel/lib/Worker/TaskFailureThrowable.phpgc-눙9vendor/amphp/parallel/lib/Worker/DefaultWorkerFactory.phpgc!Ag5vendor/amphp/parallel/lib/Worker/BasicEnvironment.phpgcͤ3vendor/amphp/parallel/lib/Worker/WorkerParallel.phpgc"ǘU1vendor/amphp/parallel/lib/Worker/WorkerThread.phpgcz-r)vendor/amphp/parallel/lib/Worker/Task.phpgcZs2vendor/amphp/parallel/lib/Worker/TaskException.phpgc9vendor/amphp/parallel/lib/Worker/TaskFailureException.php gc *6;vendor/amphp/parallel/lib/Worker/BootstrapWorkerFactory.php gc i:vendor/amphp/parallel/lib/Worker/Internal/PooledWorker.phpFgcFo[8vendor/amphp/parallel/lib/Worker/Internal/TaskResult.phpIgcI;vendor/amphp/parallel/lib/Worker/Internal/WorkerProcess.phpgcȤ1vendor/amphp/parallel/lib/Worker/Internal/Job.phpgcnk 9vendor/amphp/parallel/lib/Worker/Internal/TaskFailure.phpgco9vendor/amphp/parallel/lib/Worker/Internal/TaskSuccess.phpgc\<vendor/amphp/parallel/lib/Worker/Internal/worker-process.phpgcM:B+vendor/amphp/parallel/lib/Worker/Worker.phpgcР .vendor/amphp/parallel/lib/Worker/functions.phpgc2vendor/amphp/parallel/lib/Worker/WorkerProcess.phpTgcTߤ1vendor/amphp/parallel/lib/Worker/CallableTask.phpgce0vendor/amphp/parallel/lib/Worker/DefaultPool.php7gc7.`/vendor/amphp/parallel/lib/Worker/TaskRunner.phpgc6/vendor/amphp/parallel/lib/Worker/TaskWorker.phpgc| 0vendor/amphp/parallel/lib/Worker/Environment.phpgcWE2vendor/amphp/parallel/lib/Worker/WorkerFactory.phpgcKR5vendor/amphp/parallel/lib/Worker/TaskFailureError.php gc 9F>4vendor/amphp/parallel/lib/Worker/WorkerException.phpTgcT G)vendor/amphp/parallel/lib/Worker/Pool.phpgcojG.vendor/amphp/parallel/lib/Context/Parallel.php4gc4( -vendor/amphp/parallel/lib/Context/Context.phpgc64vendor/amphp/parallel/lib/Context/ContextFactory.phpgcЉ-vendor/amphp/parallel/lib/Context/Process.php0gc0׊;1vendor/amphp/parallel/lib/Context/StatusError.phpMgcMr=vendor/amphp/parallel/lib/Context/Internal/process-runner.phpWgcWb䭤9vendor/amphp/parallel/lib/Context/Internal/ProcessHub.phpgcS:vendor/amphp/parallel/lib/Context/Internal/ParallelHub.phpegcep25vendor/amphp/parallel/lib/Context/Internal/Thread.phplgcl6vendor/amphp/parallel/lib/Context/ContextException.phpVgcVͺ/vendor/amphp/parallel/lib/Context/functions.phpMgcM6;vendor/amphp/parallel/lib/Context/DefaultContextFactory.php gc g%,vendor/amphp/parallel/lib/Context/Thread.php$gc$'Ƥ4vendor/amphp/parallel/lib/Sync/ContextPanicError.phpgcwOː5vendor/amphp/parallel/lib/Sync/SharedMemoryParcel.php7gc7x1vendor/amphp/parallel/lib/Sync/ThreadedParcel.phpgcI73vendor/amphp/parallel/lib/Sync/ChannelledSocket.php gc  )vendor/amphp/parallel/lib/Sync/Parcel.phpgcG-vendor/amphp/parallel/lib/Sync/PanicError.phpgcr{'8vendor/amphp/parallel/lib/Sync/SharedMemoryException.php]gc]o)*vendor/amphp/parallel/lib/Sync/Channel.phpgcAiL2vendor/amphp/parallel/lib/Sync/ParcelException.phpRgcR(9vendor/amphp/parallel/lib/Sync/Internal/ParcelStorage.phpgce3vendor/amphp/parallel/lib/Sync/ChannelException.phpSgcS,vendor/amphp/parallel/lib/Sync/functions.php gc sȁ7vendor/amphp/parallel/lib/Sync/SynchronizationError.phpSgcS\7|0vendor/amphp/parallel/lib/Sync/ChannelParser.phpgcLMBD3vendor/amphp/parallel/lib/Sync/ChannelledStream.php gc .vendor/amphp/parallel/lib/Sync/ExitSuccess.phpIgcI^Ǥ-vendor/amphp/parallel/lib/Sync/ExitResult.php'gc'| .vendor/amphp/parallel/lib/Sync/ExitFailure.php=gc=4m#vendor/amphp/parallel/composer.json\gc\@v$vendor/amphp/websocket/composer.jsongc1&vendor/amphp/websocket/src/Options.php/gc/E+Ѥ1vendor/amphp/websocket/src/CompressionContext.php4gc4Hs!#vendor/amphp/websocket/src/Code.phpgc%vendor/amphp/websocket/src/Opcode.phpgcl98vendor/amphp/websocket/src/Rfc7692CompressionFactory.php7gc7{&vendor/amphp/websocket/src/Message.phpXgcX.vendor/amphp/websocket/src/ClosedException.php&gc&4 (vendor/amphp/websocket/src/functions.phpgc4-1vendor/amphp/websocket/src/Rfc7692Compression.phpIgcI.#-vendor/amphp/websocket/src/ClientMetadata.phpgcZ8vendor/amphp/websocket/src/CompressionContextFactory.phpugcu/X,vendor/amphp/websocket/src/Rfc6455Client.phpgc0C%vendor/amphp/websocket/src/Client.phpgc?m vendor/amphp/mysql/composer.jsonsgcs *.vendor/amphp/mysql/examples/2-simple-query.phpgckMY-vendor/amphp/mysql/examples/5-multi-stmts.phpgc!q,vendor/amphp/mysql/examples/4-multi-rows.phpgcPiGR4vendor/amphp/mysql/examples/3-generic-with-yield.phpegce3X)vendor/amphp/mysql/examples/1-connect.phpgcv-vendor/amphp/mysql/examples/6-transaction.php?gc?^7x1vendor/amphp/mysql/examples/support/bootstrap.phpgcB٤5vendor/amphp/mysql/examples/support/generic-table.phpgc  vendor/amphp/mysql/phpbench.jsonhgch#.vendor/amphp/mysql/src/ConnectionStatement.phpgc{(vendor/amphp/mysql/src/CommandResult.phpgcN$vendor/amphp/mysql/src/Statement.php}gc}.vendor/amphp/mysql/src/ConnectionResultSet.phpgcƤ/vendor/amphp/mysql/src/CancellableConnector.phpgcD)+vendor/amphp/mysql/src/TransactionError.phpZgcZ}A*vendor/amphp/mysql/src/PooledStatement.phpgc$vendor/amphp/mysql/src/ResultSet.phpgcY9+vendor/amphp/mysql/src/ConnectionConfig.phpgcUĥ/vendor/amphp/mysql/src/Internal/ResultProxy.phpgcc33vendor/amphp/mysql/src/Internal/ConnectionState.phpgcӝ赤-vendor/amphp/mysql/src/Internal/Processor.php$gc$v$vendor/amphp/mysql/src/functions.phpgcL(,vendor/amphp/mysql/src/PooledTransaction.phpgclE$vendor/amphp/mysql/src/DataTypes.php9gc9%vendor/amphp/mysql/src/Connection.php:gc:'vendor/amphp/mysql/src/RefreshTypes.php=gc=u2vendor/amphp/mysql/src/InitializationException.phpwgcw7Ϥ0vendor/amphp/mysql/src/ConnectionTransaction.phpgc`8*vendor/amphp/mysql/src/PooledResultSet.phpgcLvendor/amphp/mysql/src/Pool.phpgcƯV(vendor/amphp/mysql/src/StatementPool.phpggcg>\V/vendor/amphp/mysql/benchmarks/AbstractBench.phpgc~>,vendor/amphp/mysql/benchmarks/QueryBench.php gc zؤ6vendor/amphp/websocket-client/test-autobahn/runner.php< gc< ũEvendor/amphp/websocket-client/test-autobahn/config/fuzzingserver.jsongctB+vendor/amphp/websocket-client/composer.json'gc'T9vendor/amphp/websocket-client/src/ConnectionException.phpgcq>:F/vendor/amphp/websocket-client/src/Handshake.phpgc{6vendor/amphp/websocket-client/src/Rfc6455Connector.phpgcu 7vendor/amphp/websocket-client/src/ConnectionFactory.phpugcu!/vendor/amphp/websocket-client/src/functions.php!gc!]ᷤ/vendor/amphp/websocket-client/src/Connector.phpGgcGJ[07vendor/amphp/websocket-client/src/Rfc6455Connection.php gc [-F0vendor/amphp/websocket-client/src/Connection.phpgcW|5ؤ>vendor/amphp/websocket-client/src/Rfc6455ConnectionFactory.phpXgcX{)5vendor/amphp/process/bin/windows/ProcessWrapper64.exeHgcH&;3vendor/amphp/process/bin/windows/ProcessWrapper.exe4gc4%P$vendor/amphp/process/lib/Process.phpgc40vendor/amphp/process/lib/ProcessOutputStream.php: gc: $(vendor/amphp/process/lib/StatusError.phpDgcDT93vendor/amphp/process/lib/Internal/ProcessHandle.phpgc>f3vendor/amphp/process/lib/Internal/ProcessRunner.phpgcSo62vendor/amphp/process/lib/Internal/Posix/Runner.php gc 2vendor/amphp/process/lib/Internal/Posix/Handle.phpgcj=vendor/amphp/process/lib/Internal/Windows/SocketConnector.php1gc1%Avendor/amphp/process/lib/Internal/Windows/PendingSocketClient.php1gc1+^8vendor/amphp/process/lib/Internal/Windows/SignalCode.php]gc]TZ/=vendor/amphp/process/lib/Internal/Windows/HandshakeStatus.phpgcaؤ4vendor/amphp/process/lib/Internal/Windows/Runner.phpgcGn4vendor/amphp/process/lib/Internal/Windows/Handle.phpgcT3vendor/amphp/process/lib/Internal/ProcessStatus.phpgcʍ &vendor/amphp/process/lib/functions.php gc 'DT"-vendor/amphp/process/lib/ProcessException.phpMgcM/vendor/amphp/process/lib/ProcessInputStream.php) gc) U"vendor/amphp/process/composer.jsontgct@Ԥ:vendor/amphp/windows-registry/lib/KeyNotFoundException.phpYgcY4]5vendor/amphp/windows-registry/lib/WindowsRegistry.php gc a+vendor/amphp/windows-registry/composer.jsontgctJ;Gvendor/amphp/http-client-cookies/test/Internal/PublicSuffixListTest.phpgc)N?vendor/amphp/http-client-cookies/test/InMemoryCookieJarTest.phpgcvm;vendor/amphp/http-client-cookies/test/FileCookieJarTest.php/gc/7vendor/amphp/http-client-cookies/test/CookieJarTest.php gc :4vendor/amphp/http-client-cookies/test/CookieTest.php1gc19g:vendor/amphp/http-client-cookies/test/ClientCookieTest.phpgc;vendor/amphp/http-client-cookies/res/public_suffix_list.datmgcmstK<vendor/amphp/http-client-cookies/composer-require-check.jsongc8fa.vendor/amphp/http-client-cookies/composer.jsongcu3vendor/amphp/http-client-cookies/examples/basic.phpMgcM.,G8vendor/amphp/http-client-cookies/examples/basic-file.phpogcoZ\6vendor/amphp/http-client-cookies/src/NullCookieJar.phpgc !ၤ:vendor/amphp/http-client-cookies/src/CookieInterceptor.php8gc8vBvendor/amphp/http-client-cookies/src/Internal/PublicSuffixList.php gc @06vendor/amphp/http-client-cookies/src/FileCookieJar.phpgcC?-2vendor/amphp/http-client-cookies/src/CookieJar.phpgc:vendor/amphp/http-client-cookies/src/InMemoryCookieJar.phpgc[̤vendor/amphp/http/composer.jsonrgcrr7vendor/amphp/http/src/Cookie/InvalidCookieException.phpgcGB/vendor/amphp/http/src/Cookie/ResponseCookie.php)gc)@_.vendor/amphp/http/src/Cookie/RequestCookie.php5 gc5 eRؤ1vendor/amphp/http/src/Cookie/CookieAttributes.php"gc"@n0 vendor/amphp/http/src/Status.php\gc\ˡ_0vendor/amphp/http/src/InvalidHeaderException.phpIgcI8vendor/amphp/http/src/Http2/Http2ConnectionException.phpgc0.vendor/amphp/http/src/Http2/Http2Processor.phpqgcqsj?4vendor/amphp/http/src/Http2/Http2StreamException.phpgc qlz+vendor/amphp/http/src/Http2/Http2Parser.phpVgcV׵Y!vendor/amphp/http/src/Message.phpgc* <#vendor/amphp/http/src/functions.phpgc=fȤ!vendor/amphp/http/src/Rfc7230.php|gc|xcJ!vendor/amphp/socket/composer.jsontgctߤ(vendor/amphp/socket/src/DnsConnector.phpgc) Ѥ&vendor/amphp/socket/src/SocketPool.phpgcfg,vendor/amphp/socket/src/ConnectException.phpxgcx$'vendor/amphp/socket/src/Certificate.phpgc[Č"vendor/amphp/socket/src/Socket.phpgcl*,vendor/amphp/socket/src/ServerTlsContext.phpR5gcR5ozb)vendor/amphp/socket/src/SocketAddress.phpl gcl cE*vendor/amphp/socket/src/DatagramSocket.phpgcZ|S'vendor/amphp/socket/src/BindContext.php gc a.vendor/amphp/socket/src/PendingAcceptError.phpgcL.vendor/amphp/socket/src/Internal/functions.phpgckY+#vendor/amphp/socket/src/TlsInfo.php@gc@R%vendor/amphp/socket/src/functions.php= gc= =o%vendor/amphp/socket/src/Connector.phpgce-vendor/amphp/socket/src/EncryptableSocket.phpgcF)/vendor/amphp/socket/src/PendingReceiveError.phpgc~A+vendor/amphp/socket/src/StaticConnector.phpvgcv%+vendor/amphp/socket/src/SocketException.phpugcuƄ,vendor/amphp/socket/src/ClientTlsContext.php0gc0VѤ*vendor/amphp/socket/src/ConnectContext.phpO gcO ץ(vendor/amphp/socket/src/TlsException.phpgc'/vendor/amphp/socket/src/UnlimitedSocketPool.php= gc= C"vendor/amphp/socket/src/Server.phptgctA*vendor/amphp/socket/src/ResourceSocket.php?gc?*vendor/amphp/log/composer.jsongc6W)vendor/amphp/log/examples/hello-world.php gc ^&vendor/amphp/log/src/StreamHandler.phpgcV"vendor/amphp/log/src/functions.phpgc)vendor/amphp/log/src/ConsoleFormatter.phpR gcR x1vendor/amphp/amp/lib/TimeoutCancellationToken.phpgck`B*vendor/amphp/amp/lib/InvalidYieldError.phpdgcdKƭ vendor/amphp/amp/lib/Delayed.phpgckt0vendor/amphp/amp/lib/Struct.phpgc|b10vendor/amphp/amp/lib/CancellationTokenSource.phpgcmȤ!vendor/amphp/amp/lib/Iterator.phpEgcE>, vendor/amphp/amp/lib/Promise.phpgc}==&vendor/amphp/amp/lib/CallableMaker.php gc $ͤ-vendor/amphp/amp/lib/MultiReasonException.phpgc{I"vendor/amphp/amp/lib/Coroutine.phprgcrvR+vendor/amphp/amp/lib/CancelledException.phpTgcT&*vendor/amphp/amp/lib/CancellationToken.phpgcGnvendor/amphp/amp/lib/Loop.phpEgcE츋 vendor/amphp/amp/lib/Emitter.phpgc vendor/amphp/amp/lib/Success.phpgc4̤-vendor/amphp/amp/lib/Internal/Placeholder.phpgc0vendor/amphp/amp/lib/Internal/PrivatePromise.phpgcS+vendor/amphp/amp/lib/Internal/functions.php0gc0Kg1vendor/amphp/amp/lib/Internal/ResolutionQueue.php$ gc$ a*vendor/amphp/amp/lib/Internal/Producer.phpgcn1vendor/amphp/amp/lib/Internal/PrivateIterator.phpzgcz~X vendor/amphp/amp/lib/Failure.phpgchۤ"vendor/amphp/amp/lib/functions.phpfgcfW=Y.vendor/amphp/amp/lib/NullCancellationToken.phpgcL@)vendor/amphp/amp/lib/TimeoutException.phpogco!vendor/amphp/amp/lib/Producer.phpgck379vendor/amphp/amp/lib/Loop/UnsupportedFeatureException.phpgc0`%vendor/amphp/amp/lib/Loop/Watcher.phpgcDj1vendor/amphp/amp/lib/Loop/InvalidWatcherError.phpgc24dE&vendor/amphp/amp/lib/Loop/UvDriver.php(gc(`)Τ*vendor/amphp/amp/lib/Loop/NativeDriver.php8gc8D+vendor/amphp/amp/lib/Loop/TracingDriver.phpgcV Y&vendor/amphp/amp/lib/Loop/EvDriver.php!gc!`+vendor/amphp/amp/lib/Loop/DriverFactory.phpUgcU4$)vendor/amphp/amp/lib/Loop/EventDriver.php'gc' 1vendor/amphp/amp/lib/Loop/Internal/TimerQueue.php7gc7yk,{$vendor/amphp/amp/lib/Loop/Driver.phpggcgu$vendor/amphp/amp/lib/LazyPromise.phpgcHYT!vendor/amphp/amp/lib/Deferred.phpgc2vendor/amphp/amp/lib/CombinedCancellationToken.phpgc_ vendor/amphp/amp/composer.jsongcDQ0vendor/amphp/byte-stream/lib/StreamException.phpOgcOکݤ,vendor/amphp/byte-stream/lib/InputStream.php!gc!Ӥ-vendor/amphp/byte-stream/lib/OutputBuffer.phpgcФ+vendor/amphp/byte-stream/lib/LineReader.phpgcBvendor/amphp/byte-stream/lib/Base64/Base64DecodingOutputStream.phpgcRBvendor/amphp/byte-stream/lib/Base64/Base64EncodingOutputStream.phpgchAvendor/amphp/byte-stream/lib/Base64/Base64DecodingInputStream.phpgcPTAvendor/amphp/byte-stream/lib/Base64/Base64EncodingInputStream.php3gc30O5vendor/amphp/byte-stream/lib/ResourceOutputStream.php)gc)(vendor/amphp/byte-stream/lib/Message.phpgc2C/vendor/amphp/byte-stream/lib/IteratorStream.phpgcYȦ0vendor/amphp/byte-stream/lib/ClosedException.phpZgcZ *vendor/amphp/byte-stream/lib/functions.phpgc?4vendor/amphp/byte-stream/lib/ResourceInputStream.phpgcw"-vendor/amphp/byte-stream/lib/OutputStream.phpgc\D7/vendor/amphp/byte-stream/lib/InMemoryStream.phpBgcBIw!1vendor/amphp/byte-stream/lib/PendingReadError.phpgc^1vendor/amphp/byte-stream/lib/InputStreamChain.phpSgcSƽ>f1vendor/amphp/byte-stream/lib/ZlibOutputStream.phpD gcD C(vendor/amphp/byte-stream/lib/Payload.php gc ڤ0vendor/amphp/byte-stream/lib/ZlibInputStream.phpR gcR NV&vendor/amphp/byte-stream/composer.jsonqgcqRߤ-vendor/symfony/polyfill-mbstring/Mbstring.phpqgcqsܺ.vendor/symfony/polyfill-mbstring/composer.json gc .vendor/symfony/polyfill-mbstring/bootstrap.phpEgcE`0vendor/symfony/polyfill-mbstring/bootstrap80.phpP"gcP"AnFvendor/symfony/polyfill-mbstring/Resources/unidata/titleCaseRegexp.php9gc9>|zK@vendor/symfony/polyfill-mbstring/Resources/unidata/lowerCase.php_gc_d@vendor/symfony/polyfill-mbstring/Resources/unidata/upperCase.phpfgcfP*vendor/symfony/polyfill-php80/PhpToken.phpgc]f+vendor/symfony/polyfill-php80/composer.json=gc=0粠+vendor/symfony/polyfill-php80/bootstrap.phpgc.Ĥ'vendor/symfony/polyfill-php80/Php80.php gc cHEvendor/symfony/polyfill-php80/Resources/stubs/UnhandledMatchError.phpGgcGֈ+<vendor/symfony/polyfill-php80/Resources/stubs/ValueError.php>gc>g:vendor/symfony/polyfill-php80/Resources/stubs/PhpToken.phpwgcw=7T8;vendor/symfony/polyfill-php80/Resources/stubs/Attribute.phpgcMK<<vendor/symfony/polyfill-php80/Resources/stubs/Stringable.phpgct]\ڤ1vendor/danog/madelineproto/.git/refs/heads/master+gc+֭+.git/refs/heads/master+gc+֭+{ "name": "danog/madelineprotophar", "require": { "danog/madelineproto": "7.0.148" }, "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "repositories": [ { "type": "path", "url": "/woodpecker/src/gitea.daniil.it/danog/MadelineProto", "options": {"symlink": false} } ] } * @copyright 2012 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File; /** * Pure-PHP ANSI Decoder * * @author Jim Wigginton */ class ANSI { /** * Max Width * * @var int */ private $max_x; /** * Max Height * * @var int */ private $max_y; /** * Max History * * @var int */ private $max_history; /** * History * * @var array */ private $history; /** * History Attributes * * @var array */ private $history_attrs; /** * Current Column * * @var int */ private $x; /** * Current Row * * @var int */ private $y; /** * Old Column * * @var int */ private $old_x; /** * Old Row * * @var int */ private $old_y; /** * An empty attribute cell * * @var object */ private $base_attr_cell; /** * The current attribute cell * * @var object */ private $attr_cell; /** * An empty attribute row * * @var array */ private $attr_row; /** * The current screen text * * @var list */ private $screen; /** * The current screen attributes * * @var array */ private $attrs; /** * Current ANSI code * * @var string */ private $ansi; /** * Tokenization * * @var array */ private $tokenization; /** * Default Constructor. * * @return \phpseclib3\File\ANSI */ public function __construct() { $attr_cell = new \stdClass(); $attr_cell->bold = false; $attr_cell->underline = false; $attr_cell->blink = false; $attr_cell->background = 'black'; $attr_cell->foreground = 'white'; $attr_cell->reverse = false; $this->base_attr_cell = clone $attr_cell; $this->attr_cell = clone $attr_cell; $this->setHistory(200); $this->setDimensions(80, 24); } /** * Set terminal width and height * * Resets the screen as well * * @param int $x * @param int $y */ public function setDimensions($x, $y) { $this->max_x = $x - 1; $this->max_y = $y - 1; $this->x = $this->y = 0; $this->history = $this->history_attrs = []; $this->attr_row = array_fill(0, $this->max_x + 2, $this->base_attr_cell); $this->screen = array_fill(0, $this->max_y + 1, ''); $this->attrs = array_fill(0, $this->max_y + 1, $this->attr_row); $this->ansi = ''; } /** * Set the number of lines that should be logged past the terminal height * * @param int $history */ public function setHistory($history) { $this->max_history = $history; } /** * Load a string * * @param string $source */ public function loadString($source) { $this->setDimensions($this->max_x + 1, $this->max_y + 1); $this->appendString($source); } /** * Appdend a string * * @param string $source */ public function appendString($source) { $this->tokenization = ['']; for ($i = 0; $i < strlen($source); $i++) { if (strlen($this->ansi)) { $this->ansi .= $source[$i]; $chr = ord($source[$i]); // http://en.wikipedia.org/wiki/ANSI_escape_code#Sequence_elements // single character CSI's not currently supported switch (true) { case $this->ansi == "\x1B=": $this->ansi = ''; continue 2; case strlen($this->ansi) == 2 && $chr >= 64 && $chr <= 95 && $chr != ord('['): case strlen($this->ansi) > 2 && $chr >= 64 && $chr <= 126: break; default: continue 2; } $this->tokenization[] = $this->ansi; $this->tokenization[] = ''; // http://ascii-table.com/ansi-escape-sequences-vt-100.php switch ($this->ansi) { case "\x1B[H": // Move cursor to upper left corner $this->old_x = $this->x; $this->old_y = $this->y; $this->x = $this->y = 0; break; case "\x1B[J": // Clear screen from cursor down $this->history = array_merge($this->history, array_slice(array_splice($this->screen, $this->y + 1), 0, $this->old_y)); $this->screen = array_merge($this->screen, array_fill($this->y, $this->max_y, '')); $this->history_attrs = array_merge($this->history_attrs, array_slice(array_splice($this->attrs, $this->y + 1), 0, $this->old_y)); $this->attrs = array_merge($this->attrs, array_fill($this->y, $this->max_y, $this->attr_row)); if (count($this->history) == $this->max_history) { array_shift($this->history); array_shift($this->history_attrs); } // fall-through case "\x1B[K": // Clear screen from cursor right $this->screen[$this->y] = substr($this->screen[$this->y], 0, $this->x); array_splice($this->attrs[$this->y], $this->x + 1, $this->max_x - $this->x, array_fill($this->x, $this->max_x - ($this->x - 1), $this->base_attr_cell)); break; case "\x1B[2K": // Clear entire line $this->screen[$this->y] = str_repeat(' ', $this->x); $this->attrs[$this->y] = $this->attr_row; break; case "\x1B[?1h": // set cursor key to application case "\x1B[?25h": // show the cursor case "\x1B(B": // set united states g0 character set break; case "\x1BE": // Move to next line $this->newLine(); $this->x = 0; break; default: switch (true) { case preg_match('#\x1B\[(\d+)B#', $this->ansi, $match): // Move cursor down n lines $this->old_y = $this->y; $this->y += (int) $match[1]; break; case preg_match('#\x1B\[(\d+);(\d+)H#', $this->ansi, $match): // Move cursor to screen location v,h $this->old_x = $this->x; $this->old_y = $this->y; $this->x = $match[2] - 1; $this->y = (int) $match[1] - 1; break; case preg_match('#\x1B\[(\d+)C#', $this->ansi, $match): // Move cursor right n lines $this->old_x = $this->x; $this->x += $match[1]; break; case preg_match('#\x1B\[(\d+)D#', $this->ansi, $match): // Move cursor left n lines $this->old_x = $this->x; $this->x -= $match[1]; if ($this->x < 0) { $this->x = 0; } break; case preg_match('#\x1B\[(\d+);(\d+)r#', $this->ansi, $match): // Set top and bottom lines of a window break; case preg_match('#\x1B\[(\d*(?:;\d*)*)m#', $this->ansi, $match): // character attributes $attr_cell = &$this->attr_cell; $mods = explode(';', $match[1]); foreach ($mods as $mod) { switch ($mod) { case '': case '0': // Turn off character attributes $attr_cell = clone $this->base_attr_cell; break; case '1': // Turn bold mode on $attr_cell->bold = true; break; case '4': // Turn underline mode on $attr_cell->underline = true; break; case '5': // Turn blinking mode on $attr_cell->blink = true; break; case '7': // Turn reverse video on $attr_cell->reverse = !$attr_cell->reverse; $temp = $attr_cell->background; $attr_cell->background = $attr_cell->foreground; $attr_cell->foreground = $temp; break; default: // set colors //$front = $attr_cell->reverse ? &$attr_cell->background : &$attr_cell->foreground; $front = &$attr_cell->{ $attr_cell->reverse ? 'background' : 'foreground' }; //$back = $attr_cell->reverse ? &$attr_cell->foreground : &$attr_cell->background; $back = &$attr_cell->{ $attr_cell->reverse ? 'foreground' : 'background' }; switch ($mod) { // @codingStandardsIgnoreStart case '30': $front = 'black'; break; case '31': $front = 'red'; break; case '32': $front = 'green'; break; case '33': $front = 'yellow'; break; case '34': $front = 'blue'; break; case '35': $front = 'magenta'; break; case '36': $front = 'cyan'; break; case '37': $front = 'white'; break; case '40': $back = 'black'; break; case '41': $back = 'red'; break; case '42': $back = 'green'; break; case '43': $back = 'yellow'; break; case '44': $back = 'blue'; break; case '45': $back = 'magenta'; break; case '46': $back = 'cyan'; break; case '47': $back = 'white'; break; // @codingStandardsIgnoreEnd default: //user_error('Unsupported attribute: ' . $mod); $this->ansi = ''; break 2; } } } break; default: //user_error("{$this->ansi} is unsupported\r\n"); } } $this->ansi = ''; continue; } $this->tokenization[count($this->tokenization) - 1] .= $source[$i]; switch ($source[$i]) { case "\r": $this->x = 0; break; case "\n": $this->newLine(); break; case "\x08": // backspace if ($this->x) { $this->x--; $this->attrs[$this->y][$this->x] = clone $this->base_attr_cell; $this->screen[$this->y] = substr_replace( $this->screen[$this->y], $source[$i], $this->x, 1 ); } break; case "\x0F": // shift break; case "\x1B": // start ANSI escape code $this->tokenization[count($this->tokenization) - 1] = substr($this->tokenization[count($this->tokenization) - 1], 0, -1); //if (!strlen($this->tokenization[count($this->tokenization) - 1])) { // array_pop($this->tokenization); //} $this->ansi .= "\x1B"; break; default: $this->attrs[$this->y][$this->x] = clone $this->attr_cell; if ($this->x > strlen($this->screen[$this->y])) { $this->screen[$this->y] = str_repeat(' ', $this->x); } $this->screen[$this->y] = substr_replace( $this->screen[$this->y], $source[$i], $this->x, 1 ); if ($this->x > $this->max_x) { $this->x = 0; $this->newLine(); } else { $this->x++; } } } } /** * Add a new line * * Also update the $this->screen and $this->history buffers * */ private function newLine() { //if ($this->y < $this->max_y) { // $this->y++; //} while ($this->y >= $this->max_y) { $this->history = array_merge($this->history, [array_shift($this->screen)]); $this->screen[] = ''; $this->history_attrs = array_merge($this->history_attrs, [array_shift($this->attrs)]); $this->attrs[] = $this->attr_row; if (count($this->history) >= $this->max_history) { array_shift($this->history); array_shift($this->history_attrs); } $this->y--; } $this->y++; } /** * Returns the current coordinate without preformating * * @param \stdClass $last_attr * @param \stdClass $cur_attr * @param string $char * @return string */ private function processCoordinate(\stdClass $last_attr, \stdClass $cur_attr, $char) { $output = ''; if ($last_attr != $cur_attr) { $close = $open = ''; if ($last_attr->foreground != $cur_attr->foreground) { if ($cur_attr->foreground != 'white') { $open .= ''; } if ($last_attr->foreground != 'white') { $close = '' . $close; } } if ($last_attr->background != $cur_attr->background) { if ($cur_attr->background != 'black') { $open .= ''; } if ($last_attr->background != 'black') { $close = '' . $close; } } if ($last_attr->bold != $cur_attr->bold) { if ($cur_attr->bold) { $open .= ''; } else { $close = '' . $close; } } if ($last_attr->underline != $cur_attr->underline) { if ($cur_attr->underline) { $open .= ''; } else { $close = '' . $close; } } if ($last_attr->blink != $cur_attr->blink) { if ($cur_attr->blink) { $open .= ''; } else { $close = '' . $close; } } $output .= $close . $open; } $output .= htmlspecialchars($char); return $output; } /** * Returns the current screen without preformating * * @return string */ private function getScreenHelper() { $output = ''; $last_attr = $this->base_attr_cell; for ($i = 0; $i <= $this->max_y; $i++) { for ($j = 0; $j <= $this->max_x; $j++) { $cur_attr = $this->attrs[$i][$j]; $output .= $this->processCoordinate($last_attr, $cur_attr, isset($this->screen[$i][$j]) ? $this->screen[$i][$j] : ''); $last_attr = $this->attrs[$i][$j]; } $output .= "\r\n"; } $output = substr($output, 0, -2); // close any remaining open tags $output .= $this->processCoordinate($last_attr, $this->base_attr_cell, ''); return rtrim($output); } /** * Returns the current screen * * @return string */ public function getScreen() { return '
' . $this->getScreenHelper() . '
'; } /** * Returns the current screen and the x previous lines * * @return string */ public function getHistory() { $scrollback = ''; $last_attr = $this->base_attr_cell; for ($i = 0; $i < count($this->history); $i++) { for ($j = 0; $j <= $this->max_x + 1; $j++) { $cur_attr = $this->history_attrs[$i][$j]; $scrollback .= $this->processCoordinate($last_attr, $cur_attr, isset($this->history[$i][$j]) ? $this->history[$i][$j] : ''); $last_attr = $this->history_attrs[$i][$j]; } $scrollback .= "\r\n"; } $base_attr_cell = $this->base_attr_cell; $this->base_attr_cell = $last_attr; $scrollback .= $this->getScreen(); $this->base_attr_cell = $base_attr_cell; return '
' . $scrollback . '
'; } } * @copyright 2012 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\PrivateKey; use phpseclib3\Crypt\Common\PublicKey; use phpseclib3\Crypt\DSA; use phpseclib3\Crypt\EC; use phpseclib3\Crypt\Hash; use phpseclib3\Crypt\PublicKeyLoader; use phpseclib3\Crypt\Random; use phpseclib3\Crypt\RSA; use phpseclib3\Crypt\RSA\Formats\Keys\PSS; use phpseclib3\Exception\UnsupportedAlgorithmException; use phpseclib3\File\ASN1\Element; use phpseclib3\File\ASN1\Maps; use phpseclib3\Math\BigInteger; /** * Pure-PHP X.509 Parser * * @author Jim Wigginton */ class X509 { /** * Flag to only accept signatures signed by certificate authorities * * Not really used anymore but retained all the same to suppress E_NOTICEs from old installs * */ const VALIDATE_SIGNATURE_BY_CA = 1; /** * Return internal array representation * * @see \phpseclib3\File\X509::getDN() */ const DN_ARRAY = 0; /** * Return string * * @see \phpseclib3\File\X509::getDN() */ const DN_STRING = 1; /** * Return ASN.1 name string * * @see \phpseclib3\File\X509::getDN() */ const DN_ASN1 = 2; /** * Return OpenSSL compatible array * * @see \phpseclib3\File\X509::getDN() */ const DN_OPENSSL = 3; /** * Return canonical ASN.1 RDNs string * * @see \phpseclib3\File\X509::getDN() */ const DN_CANON = 4; /** * Return name hash for file indexing * * @see \phpseclib3\File\X509::getDN() */ const DN_HASH = 5; /** * Save as PEM * * ie. a base64-encoded PEM with a header and a footer * * @see \phpseclib3\File\X509::saveX509() * @see \phpseclib3\File\X509::saveCSR() * @see \phpseclib3\File\X509::saveCRL() */ const FORMAT_PEM = 0; /** * Save as DER * * @see \phpseclib3\File\X509::saveX509() * @see \phpseclib3\File\X509::saveCSR() * @see \phpseclib3\File\X509::saveCRL() */ const FORMAT_DER = 1; /** * Save as a SPKAC * * @see \phpseclib3\File\X509::saveX509() * @see \phpseclib3\File\X509::saveCSR() * @see \phpseclib3\File\X509::saveCRL() * * Only works on CSRs. Not currently supported. */ const FORMAT_SPKAC = 2; /** * Auto-detect the format * * Used only by the load*() functions * * @see \phpseclib3\File\X509::saveX509() * @see \phpseclib3\File\X509::saveCSR() * @see \phpseclib3\File\X509::saveCRL() */ const FORMAT_AUTO_DETECT = 3; /** * Attribute value disposition. * If disposition is >= 0, this is the index of the target value. */ const ATTR_ALL = -1; // All attribute values (array). const ATTR_APPEND = -2; // Add a value. const ATTR_REPLACE = -3; // Clear first, then add a value. /** * Distinguished Name * * @var array */ private $dn; /** * Public key * * @var string|PublicKey */ private $publicKey; /** * Private key * * @var string|PrivateKey */ private $privateKey; /** * The certificate authorities * * @var array */ private $CAs; /** * The currently loaded certificate * * @var array */ private $currentCert; /** * The signature subject * * There's no guarantee \phpseclib3\File\X509 is going to re-encode an X.509 cert in the same way it was originally * encoded so we take save the portion of the original cert that the signature would have made for. * * @var string */ private $signatureSubject; /** * Certificate Start Date * * @var string */ private $startDate; /** * Certificate End Date * * @var string|Element */ private $endDate; /** * Serial Number * * @var string */ private $serialNumber; /** * Key Identifier * * See {@link http://tools.ietf.org/html/rfc5280#section-4.2.1.1 RFC5280#section-4.2.1.1} and * {@link http://tools.ietf.org/html/rfc5280#section-4.2.1.2 RFC5280#section-4.2.1.2}. * * @var string */ private $currentKeyIdentifier; /** * CA Flag * * @var bool */ private $caFlag = false; /** * SPKAC Challenge * * @var string */ private $challenge; /** * @var array */ private $extensionValues = []; /** * OIDs loaded * * @var bool */ private static $oidsLoaded = false; /** * Recursion Limit * * @var int */ private static $recur_limit = 5; /** * URL fetch flag * * @var bool */ private static $disable_url_fetch = false; /** * @var array */ private static $extensions = []; /** * @var ?array */ private $ipAddresses = null; /** * @var ?array */ private $domains = null; /** * Default Constructor. * * @return \phpseclib3\File\X509 */ public function __construct() { // Explicitly Tagged Module, 1988 Syntax // http://tools.ietf.org/html/rfc5280#appendix-A.1 if (!self::$oidsLoaded) { // OIDs from RFC5280 and those RFCs mentioned in RFC5280#section-4.1.1.2 ASN1::loadOIDs([ //'id-pkix' => '1.3.6.1.5.5.7', //'id-pe' => '1.3.6.1.5.5.7.1', //'id-qt' => '1.3.6.1.5.5.7.2', //'id-kp' => '1.3.6.1.5.5.7.3', //'id-ad' => '1.3.6.1.5.5.7.48', 'id-qt-cps' => '1.3.6.1.5.5.7.2.1', 'id-qt-unotice' => '1.3.6.1.5.5.7.2.2', 'id-ad-ocsp' => '1.3.6.1.5.5.7.48.1', 'id-ad-caIssuers' => '1.3.6.1.5.5.7.48.2', 'id-ad-timeStamping' => '1.3.6.1.5.5.7.48.3', 'id-ad-caRepository' => '1.3.6.1.5.5.7.48.5', //'id-at' => '2.5.4', 'id-at-name' => '2.5.4.41', 'id-at-surname' => '2.5.4.4', 'id-at-givenName' => '2.5.4.42', 'id-at-initials' => '2.5.4.43', 'id-at-generationQualifier' => '2.5.4.44', 'id-at-commonName' => '2.5.4.3', 'id-at-localityName' => '2.5.4.7', 'id-at-stateOrProvinceName' => '2.5.4.8', 'id-at-organizationName' => '2.5.4.10', 'id-at-organizationalUnitName' => '2.5.4.11', 'id-at-title' => '2.5.4.12', 'id-at-description' => '2.5.4.13', 'id-at-dnQualifier' => '2.5.4.46', 'id-at-countryName' => '2.5.4.6', 'id-at-serialNumber' => '2.5.4.5', 'id-at-pseudonym' => '2.5.4.65', 'id-at-postalCode' => '2.5.4.17', 'id-at-streetAddress' => '2.5.4.9', 'id-at-uniqueIdentifier' => '2.5.4.45', 'id-at-role' => '2.5.4.72', 'id-at-postalAddress' => '2.5.4.16', //'id-domainComponent' => '0.9.2342.19200300.100.1.25', //'pkcs-9' => '1.2.840.113549.1.9', 'pkcs-9-at-emailAddress' => '1.2.840.113549.1.9.1', //'id-ce' => '2.5.29', 'id-ce-authorityKeyIdentifier' => '2.5.29.35', 'id-ce-subjectKeyIdentifier' => '2.5.29.14', 'id-ce-keyUsage' => '2.5.29.15', 'id-ce-privateKeyUsagePeriod' => '2.5.29.16', 'id-ce-certificatePolicies' => '2.5.29.32', //'anyPolicy' => '2.5.29.32.0', 'id-ce-policyMappings' => '2.5.29.33', 'id-ce-subjectAltName' => '2.5.29.17', 'id-ce-issuerAltName' => '2.5.29.18', 'id-ce-subjectDirectoryAttributes' => '2.5.29.9', 'id-ce-basicConstraints' => '2.5.29.19', 'id-ce-nameConstraints' => '2.5.29.30', 'id-ce-policyConstraints' => '2.5.29.36', 'id-ce-cRLDistributionPoints' => '2.5.29.31', 'id-ce-extKeyUsage' => '2.5.29.37', //'anyExtendedKeyUsage' => '2.5.29.37.0', 'id-kp-serverAuth' => '1.3.6.1.5.5.7.3.1', 'id-kp-clientAuth' => '1.3.6.1.5.5.7.3.2', 'id-kp-codeSigning' => '1.3.6.1.5.5.7.3.3', 'id-kp-emailProtection' => '1.3.6.1.5.5.7.3.4', 'id-kp-timeStamping' => '1.3.6.1.5.5.7.3.8', 'id-kp-OCSPSigning' => '1.3.6.1.5.5.7.3.9', 'id-ce-inhibitAnyPolicy' => '2.5.29.54', 'id-ce-freshestCRL' => '2.5.29.46', 'id-pe-authorityInfoAccess' => '1.3.6.1.5.5.7.1.1', 'id-pe-subjectInfoAccess' => '1.3.6.1.5.5.7.1.11', 'id-ce-cRLNumber' => '2.5.29.20', 'id-ce-issuingDistributionPoint' => '2.5.29.28', 'id-ce-deltaCRLIndicator' => '2.5.29.27', 'id-ce-cRLReasons' => '2.5.29.21', 'id-ce-certificateIssuer' => '2.5.29.29', 'id-ce-holdInstructionCode' => '2.5.29.23', //'holdInstruction' => '1.2.840.10040.2', 'id-holdinstruction-none' => '1.2.840.10040.2.1', 'id-holdinstruction-callissuer' => '1.2.840.10040.2.2', 'id-holdinstruction-reject' => '1.2.840.10040.2.3', 'id-ce-invalidityDate' => '2.5.29.24', 'rsaEncryption' => '1.2.840.113549.1.1.1', 'md2WithRSAEncryption' => '1.2.840.113549.1.1.2', 'md5WithRSAEncryption' => '1.2.840.113549.1.1.4', 'sha1WithRSAEncryption' => '1.2.840.113549.1.1.5', 'sha224WithRSAEncryption' => '1.2.840.113549.1.1.14', 'sha256WithRSAEncryption' => '1.2.840.113549.1.1.11', 'sha384WithRSAEncryption' => '1.2.840.113549.1.1.12', 'sha512WithRSAEncryption' => '1.2.840.113549.1.1.13', 'id-ecPublicKey' => '1.2.840.10045.2.1', 'ecdsa-with-SHA1' => '1.2.840.10045.4.1', // from https://tools.ietf.org/html/rfc5758#section-3.2 'ecdsa-with-SHA224' => '1.2.840.10045.4.3.1', 'ecdsa-with-SHA256' => '1.2.840.10045.4.3.2', 'ecdsa-with-SHA384' => '1.2.840.10045.4.3.3', 'ecdsa-with-SHA512' => '1.2.840.10045.4.3.4', 'id-dsa' => '1.2.840.10040.4.1', 'id-dsa-with-sha1' => '1.2.840.10040.4.3', // from https://tools.ietf.org/html/rfc5758#section-3.1 'id-dsa-with-sha224' => '2.16.840.1.101.3.4.3.1', 'id-dsa-with-sha256' => '2.16.840.1.101.3.4.3.2', // from https://tools.ietf.org/html/rfc8410: 'id-Ed25519' => '1.3.101.112', 'id-Ed448' => '1.3.101.113', 'id-RSASSA-PSS' => '1.2.840.113549.1.1.10', //'id-sha224' => '2.16.840.1.101.3.4.2.4', //'id-sha256' => '2.16.840.1.101.3.4.2.1', //'id-sha384' => '2.16.840.1.101.3.4.2.2', //'id-sha512' => '2.16.840.1.101.3.4.2.3', //'id-GostR3411-94-with-GostR3410-94' => '1.2.643.2.2.4', //'id-GostR3411-94-with-GostR3410-2001' => '1.2.643.2.2.3', //'id-GostR3410-2001' => '1.2.643.2.2.20', //'id-GostR3410-94' => '1.2.643.2.2.19', // Netscape Object Identifiers from "Netscape Certificate Extensions" 'netscape' => '2.16.840.1.113730', 'netscape-cert-extension' => '2.16.840.1.113730.1', 'netscape-cert-type' => '2.16.840.1.113730.1.1', 'netscape-comment' => '2.16.840.1.113730.1.13', 'netscape-ca-policy-url' => '2.16.840.1.113730.1.8', // the following are X.509 extensions not supported by phpseclib 'id-pe-logotype' => '1.3.6.1.5.5.7.1.12', 'entrustVersInfo' => '1.2.840.113533.7.65.0', 'verisignPrivate' => '2.16.840.1.113733.1.6.9', // for Certificate Signing Requests // see http://tools.ietf.org/html/rfc2985 'pkcs-9-at-unstructuredName' => '1.2.840.113549.1.9.2', // PKCS #9 unstructured name 'pkcs-9-at-challengePassword' => '1.2.840.113549.1.9.7', // Challenge password for certificate revocations 'pkcs-9-at-extensionRequest' => '1.2.840.113549.1.9.14' // Certificate extension request ]); } } /** * Load X.509 certificate * * Returns an associative array describing the X.509 cert or a false if the cert failed to load * * @param array|string $cert * @param int $mode * @return mixed */ public function loadX509($cert, $mode = self::FORMAT_AUTO_DETECT) { if (is_array($cert) && isset($cert['tbsCertificate'])) { unset($this->currentCert); unset($this->currentKeyIdentifier); $this->dn = $cert['tbsCertificate']['subject']; if (!isset($this->dn)) { return false; } $this->currentCert = $cert; $currentKeyIdentifier = $this->getExtension('id-ce-subjectKeyIdentifier'); $this->currentKeyIdentifier = is_string($currentKeyIdentifier) ? $currentKeyIdentifier : null; unset($this->signatureSubject); return $cert; } if ($mode != self::FORMAT_DER) { $newcert = ASN1::extractBER($cert); if ($mode == self::FORMAT_PEM && $cert == $newcert) { return false; } $cert = $newcert; } if ($cert === false) { $this->currentCert = false; return false; } $decoded = ASN1::decodeBER($cert); if ($decoded) { $x509 = ASN1::asn1map($decoded[0], Maps\Certificate::MAP); } if (!isset($x509) || $x509 === false) { $this->currentCert = false; return false; } $this->signatureSubject = substr($cert, $decoded[0]['content'][0]['start'], $decoded[0]['content'][0]['length']); if ($this->isSubArrayValid($x509, 'tbsCertificate/extensions')) { $this->mapInExtensions($x509, 'tbsCertificate/extensions'); } $this->mapInDNs($x509, 'tbsCertificate/issuer/rdnSequence'); $this->mapInDNs($x509, 'tbsCertificate/subject/rdnSequence'); $key = $x509['tbsCertificate']['subjectPublicKeyInfo']; $key = ASN1::encodeDER($key, Maps\SubjectPublicKeyInfo::MAP); $x509['tbsCertificate']['subjectPublicKeyInfo']['subjectPublicKey'] = "-----BEGIN PUBLIC KEY-----\r\n" . chunk_split(base64_encode($key), 64) . "-----END PUBLIC KEY-----"; $this->currentCert = $x509; $this->dn = $x509['tbsCertificate']['subject']; $currentKeyIdentifier = $this->getExtension('id-ce-subjectKeyIdentifier'); $this->currentKeyIdentifier = is_string($currentKeyIdentifier) ? $currentKeyIdentifier : null; return $x509; } /** * Save X.509 certificate * * @param array $cert * @param int $format optional * @return string */ public function saveX509(array $cert, $format = self::FORMAT_PEM) { if (!is_array($cert) || !isset($cert['tbsCertificate'])) { return false; } switch (true) { // "case !$a: case !$b: break; default: whatever();" is the same thing as "if ($a && $b) whatever()" case !($algorithm = $this->subArray($cert, 'tbsCertificate/subjectPublicKeyInfo/algorithm/algorithm')): case is_object($cert['tbsCertificate']['subjectPublicKeyInfo']['subjectPublicKey']): break; default: $cert['tbsCertificate']['subjectPublicKeyInfo'] = new Element( base64_decode(preg_replace('#-.+-|[\r\n]#', '', $cert['tbsCertificate']['subjectPublicKeyInfo']['subjectPublicKey'])) ); } if ($algorithm == 'rsaEncryption') { $cert['signatureAlgorithm']['parameters'] = null; $cert['tbsCertificate']['signature']['parameters'] = null; } $filters = []; $type_utf8_string = ['type' => ASN1::TYPE_UTF8_STRING]; $filters['tbsCertificate']['signature']['parameters'] = $type_utf8_string; $filters['tbsCertificate']['signature']['issuer']['rdnSequence']['value'] = $type_utf8_string; $filters['tbsCertificate']['issuer']['rdnSequence']['value'] = $type_utf8_string; $filters['tbsCertificate']['subject']['rdnSequence']['value'] = $type_utf8_string; $filters['tbsCertificate']['subjectPublicKeyInfo']['algorithm']['parameters'] = $type_utf8_string; $filters['signatureAlgorithm']['parameters'] = $type_utf8_string; $filters['authorityCertIssuer']['directoryName']['rdnSequence']['value'] = $type_utf8_string; //$filters['policyQualifiers']['qualifier'] = $type_utf8_string; $filters['distributionPoint']['fullName']['directoryName']['rdnSequence']['value'] = $type_utf8_string; $filters['directoryName']['rdnSequence']['value'] = $type_utf8_string; foreach (self::$extensions as $extension) { $filters['tbsCertificate']['extensions'][] = $extension; } /* in the case of policyQualifiers/qualifier, the type has to be \phpseclib3\File\ASN1::TYPE_IA5_STRING. \phpseclib3\File\ASN1::TYPE_PRINTABLE_STRING will cause OpenSSL's X.509 parser to spit out random characters. */ $filters['policyQualifiers']['qualifier'] = ['type' => ASN1::TYPE_IA5_STRING]; ASN1::setFilters($filters); $this->mapOutExtensions($cert, 'tbsCertificate/extensions'); $this->mapOutDNs($cert, 'tbsCertificate/issuer/rdnSequence'); $this->mapOutDNs($cert, 'tbsCertificate/subject/rdnSequence'); $cert = ASN1::encodeDER($cert, Maps\Certificate::MAP); switch ($format) { case self::FORMAT_DER: return $cert; // case self::FORMAT_PEM: default: return "-----BEGIN CERTIFICATE-----\r\n" . chunk_split(Strings::base64_encode($cert), 64) . '-----END CERTIFICATE-----'; } } /** * Map extension values from octet string to extension-specific internal * format. * * @param array $root (by reference) * @param string $path */ private function mapInExtensions(array &$root, $path) { $extensions = &$this->subArrayUnchecked($root, $path); if ($extensions) { for ($i = 0; $i < count($extensions); $i++) { $id = $extensions[$i]['extnId']; $value = &$extensions[$i]['extnValue']; /* [extnValue] contains the DER encoding of an ASN.1 value corresponding to the extension type identified by extnID */ $map = $this->getMapping($id); if (!is_bool($map)) { $decoder = $id == 'id-ce-nameConstraints' ? [static::class, 'decodeNameConstraintIP'] : [static::class, 'decodeIP']; $decoded = ASN1::decodeBER($value); if (!$decoded) { continue; } $mapped = ASN1::asn1map($decoded[0], $map, ['iPAddress' => $decoder]); $value = $mapped === false ? $decoded[0] : $mapped; if ($id == 'id-ce-certificatePolicies') { for ($j = 0; $j < count($value); $j++) { if (!isset($value[$j]['policyQualifiers'])) { continue; } for ($k = 0; $k < count($value[$j]['policyQualifiers']); $k++) { $subid = $value[$j]['policyQualifiers'][$k]['policyQualifierId']; $map = $this->getMapping($subid); $subvalue = &$value[$j]['policyQualifiers'][$k]['qualifier']; if ($map !== false) { $decoded = ASN1::decodeBER($subvalue); if (!$decoded) { continue; } $mapped = ASN1::asn1map($decoded[0], $map); $subvalue = $mapped === false ? $decoded[0] : $mapped; } } } } } } } } /** * Map extension values from extension-specific internal format to * octet string. * * @param array $root (by reference) * @param string $path */ private function mapOutExtensions(array &$root, $path) { $extensions = &$this->subArray($root, $path, !empty($this->extensionValues)); foreach ($this->extensionValues as $id => $data) { extract($data); $newext = [ 'extnId' => $id, 'extnValue' => $value, 'critical' => $critical ]; if ($replace) { foreach ($extensions as $key => $value) { if ($value['extnId'] == $id) { $extensions[$key] = $newext; continue 2; } } } $extensions[] = $newext; } if (is_array($extensions)) { $size = count($extensions); for ($i = 0; $i < $size; $i++) { if ($extensions[$i] instanceof Element) { continue; } $id = $extensions[$i]['extnId']; $value = &$extensions[$i]['extnValue']; switch ($id) { case 'id-ce-certificatePolicies': for ($j = 0; $j < count($value); $j++) { if (!isset($value[$j]['policyQualifiers'])) { continue; } for ($k = 0; $k < count($value[$j]['policyQualifiers']); $k++) { $subid = $value[$j]['policyQualifiers'][$k]['policyQualifierId']; $map = $this->getMapping($subid); $subvalue = &$value[$j]['policyQualifiers'][$k]['qualifier']; if ($map !== false) { // by default \phpseclib3\File\ASN1 will try to render qualifier as a \phpseclib3\File\ASN1::TYPE_IA5_STRING since it's // actual type is \phpseclib3\File\ASN1::TYPE_ANY $subvalue = new Element(ASN1::encodeDER($subvalue, $map)); } } } break; case 'id-ce-authorityKeyIdentifier': // use 00 as the serial number instead of an empty string if (isset($value['authorityCertSerialNumber'])) { if ($value['authorityCertSerialNumber']->toBytes() == '') { $temp = chr((ASN1::CLASS_CONTEXT_SPECIFIC << 6) | 2) . "\1\0"; $value['authorityCertSerialNumber'] = new Element($temp); } } } /* [extnValue] contains the DER encoding of an ASN.1 value corresponding to the extension type identified by extnID */ $map = $this->getMapping($id); if (is_bool($map)) { if (!$map) { //user_error($id . ' is not a currently supported extension'); unset($extensions[$i]); } } else { $value = ASN1::encodeDER($value, $map, ['iPAddress' => [static::class, 'encodeIP']]); } } } } /** * Map attribute values from ANY type to attribute-specific internal * format. * * @param array $root (by reference) * @param string $path */ private function mapInAttributes(&$root, $path) { $attributes = &$this->subArray($root, $path); if (is_array($attributes)) { for ($i = 0; $i < count($attributes); $i++) { $id = $attributes[$i]['type']; /* $value contains the DER encoding of an ASN.1 value corresponding to the attribute type identified by type */ $map = $this->getMapping($id); if (is_array($attributes[$i]['value'])) { $values = &$attributes[$i]['value']; for ($j = 0; $j < count($values); $j++) { $value = ASN1::encodeDER($values[$j], Maps\AttributeValue::MAP); $decoded = ASN1::decodeBER($value); if (!is_bool($map)) { if (!$decoded) { continue; } $mapped = ASN1::asn1map($decoded[0], $map); if ($mapped !== false) { $values[$j] = $mapped; } if ($id == 'pkcs-9-at-extensionRequest' && $this->isSubArrayValid($values, $j)) { $this->mapInExtensions($values, $j); } } elseif ($map) { $values[$j] = $value; } } } } } } /** * Map attribute values from attribute-specific internal format to * ANY type. * * @param array $root (by reference) * @param string $path */ private function mapOutAttributes(&$root, $path) { $attributes = &$this->subArray($root, $path); if (is_array($attributes)) { $size = count($attributes); for ($i = 0; $i < $size; $i++) { /* [value] contains the DER encoding of an ASN.1 value corresponding to the attribute type identified by type */ $id = $attributes[$i]['type']; $map = $this->getMapping($id); if ($map === false) { //user_error($id . ' is not a currently supported attribute', E_USER_NOTICE); unset($attributes[$i]); } elseif (is_array($attributes[$i]['value'])) { $values = &$attributes[$i]['value']; for ($j = 0; $j < count($values); $j++) { switch ($id) { case 'pkcs-9-at-extensionRequest': $this->mapOutExtensions($values, $j); break; } if (!is_bool($map)) { $temp = ASN1::encodeDER($values[$j], $map); $decoded = ASN1::decodeBER($temp); if (!$decoded) { continue; } $values[$j] = ASN1::asn1map($decoded[0], Maps\AttributeValue::MAP); } } } } } } /** * Map DN values from ANY type to DN-specific internal * format. * * @param array $root (by reference) * @param string $path */ private function mapInDNs(array &$root, $path) { $dns = &$this->subArray($root, $path); if (is_array($dns)) { for ($i = 0; $i < count($dns); $i++) { for ($j = 0; $j < count($dns[$i]); $j++) { $type = $dns[$i][$j]['type']; $value = &$dns[$i][$j]['value']; if (is_object($value) && $value instanceof Element) { $map = $this->getMapping($type); if (!is_bool($map)) { $decoded = ASN1::decodeBER($value); if (!$decoded) { continue; } $value = ASN1::asn1map($decoded[0], $map); } } } } } } /** * Map DN values from DN-specific internal format to * ANY type. * * @param array $root (by reference) * @param string $path */ private function mapOutDNs(array &$root, $path) { $dns = &$this->subArray($root, $path); if (is_array($dns)) { $size = count($dns); for ($i = 0; $i < $size; $i++) { for ($j = 0; $j < count($dns[$i]); $j++) { $type = $dns[$i][$j]['type']; $value = &$dns[$i][$j]['value']; if (is_object($value) && $value instanceof Element) { continue; } $map = $this->getMapping($type); if (!is_bool($map)) { $value = new Element(ASN1::encodeDER($value, $map)); } } } } } /** * Associate an extension ID to an extension mapping * * @param string $extnId * @return mixed */ private function getMapping($extnId) { if (!is_string($extnId)) { // eg. if it's a \phpseclib3\File\ASN1\Element object return true; } if (isset(self::$extensions[$extnId])) { return self::$extensions[$extnId]; } switch ($extnId) { case 'id-ce-keyUsage': return Maps\KeyUsage::MAP; case 'id-ce-basicConstraints': return Maps\BasicConstraints::MAP; case 'id-ce-subjectKeyIdentifier': return Maps\KeyIdentifier::MAP; case 'id-ce-cRLDistributionPoints': return Maps\CRLDistributionPoints::MAP; case 'id-ce-authorityKeyIdentifier': return Maps\AuthorityKeyIdentifier::MAP; case 'id-ce-certificatePolicies': return Maps\CertificatePolicies::MAP; case 'id-ce-extKeyUsage': return Maps\ExtKeyUsageSyntax::MAP; case 'id-pe-authorityInfoAccess': return Maps\AuthorityInfoAccessSyntax::MAP; case 'id-ce-subjectAltName': return Maps\SubjectAltName::MAP; case 'id-ce-subjectDirectoryAttributes': return Maps\SubjectDirectoryAttributes::MAP; case 'id-ce-privateKeyUsagePeriod': return Maps\PrivateKeyUsagePeriod::MAP; case 'id-ce-issuerAltName': return Maps\IssuerAltName::MAP; case 'id-ce-policyMappings': return Maps\PolicyMappings::MAP; case 'id-ce-nameConstraints': return Maps\NameConstraints::MAP; case 'netscape-cert-type': return Maps\netscape_cert_type::MAP; case 'netscape-comment': return Maps\netscape_comment::MAP; case 'netscape-ca-policy-url': return Maps\netscape_ca_policy_url::MAP; // since id-qt-cps isn't a constructed type it will have already been decoded as a string by the time it gets // back around to asn1map() and we don't want it decoded again. //case 'id-qt-cps': // return Maps\CPSuri::MAP; case 'id-qt-unotice': return Maps\UserNotice::MAP; // the following OIDs are unsupported but we don't want them to give notices when calling saveX509(). case 'id-pe-logotype': // http://www.ietf.org/rfc/rfc3709.txt case 'entrustVersInfo': // http://support.microsoft.com/kb/287547 case '1.3.6.1.4.1.311.20.2': // szOID_ENROLL_CERTTYPE_EXTENSION case '1.3.6.1.4.1.311.21.1': // szOID_CERTSRV_CA_VERSION // "SET Secure Electronic Transaction Specification" // http://www.maithean.com/docs/set_bk3.pdf case '2.23.42.7.0': // id-set-hashedRootKey // "Certificate Transparency" // https://tools.ietf.org/html/rfc6962 case '1.3.6.1.4.1.11129.2.4.2': // "Qualified Certificate statements" // https://tools.ietf.org/html/rfc3739#section-3.2.6 case '1.3.6.1.5.5.7.1.3': return true; // CSR attributes case 'pkcs-9-at-unstructuredName': return Maps\PKCS9String::MAP; case 'pkcs-9-at-challengePassword': return Maps\DirectoryString::MAP; case 'pkcs-9-at-extensionRequest': return Maps\Extensions::MAP; // CRL extensions. case 'id-ce-cRLNumber': return Maps\CRLNumber::MAP; case 'id-ce-deltaCRLIndicator': return Maps\CRLNumber::MAP; case 'id-ce-issuingDistributionPoint': return Maps\IssuingDistributionPoint::MAP; case 'id-ce-freshestCRL': return Maps\CRLDistributionPoints::MAP; case 'id-ce-cRLReasons': return Maps\CRLReason::MAP; case 'id-ce-invalidityDate': return Maps\InvalidityDate::MAP; case 'id-ce-certificateIssuer': return Maps\CertificateIssuer::MAP; case 'id-ce-holdInstructionCode': return Maps\HoldInstructionCode::MAP; case 'id-at-postalAddress': return Maps\PostalAddress::MAP; } return false; } /** * Load an X.509 certificate as a certificate authority * * @param string $cert * @return bool */ public function loadCA($cert) { $olddn = $this->dn; $oldcert = $this->currentCert; $oldsigsubj = $this->signatureSubject; $oldkeyid = $this->currentKeyIdentifier; $cert = $this->loadX509($cert); if (!$cert) { $this->dn = $olddn; $this->currentCert = $oldcert; $this->signatureSubject = $oldsigsubj; $this->currentKeyIdentifier = $oldkeyid; return false; } /* From RFC5280 "PKIX Certificate and CRL Profile": If the keyUsage extension is present, then the subject public key MUST NOT be used to verify signatures on certificates or CRLs unless the corresponding keyCertSign or cRLSign bit is set. */ //$keyUsage = $this->getExtension('id-ce-keyUsage'); //if ($keyUsage && !in_array('keyCertSign', $keyUsage)) { // return false; //} /* From RFC5280 "PKIX Certificate and CRL Profile": The cA boolean indicates whether the certified public key may be used to verify certificate signatures. If the cA boolean is not asserted, then the keyCertSign bit in the key usage extension MUST NOT be asserted. If the basic constraints extension is not present in a version 3 certificate, or the extension is present but the cA boolean is not asserted, then the certified public key MUST NOT be used to verify certificate signatures. */ //$basicConstraints = $this->getExtension('id-ce-basicConstraints'); //if (!$basicConstraints || !$basicConstraints['cA']) { // return false; //} $this->CAs[] = $cert; $this->dn = $olddn; $this->currentCert = $oldcert; $this->signatureSubject = $oldsigsubj; return true; } /** * Validate an X.509 certificate against a URL * * From RFC2818 "HTTP over TLS": * * Matching is performed using the matching rules specified by * [RFC2459]. If more than one identity of a given type is present in * the certificate (e.g., more than one dNSName name, a match in any one * of the set is considered acceptable.) Names may contain the wildcard * character * which is considered to match any single domain name * component or component fragment. E.g., *.a.com matches foo.a.com but * not bar.foo.a.com. f*.com matches foo.com but not bar.com. * * @param string $url * @return bool */ public function validateURL($url) { if (!is_array($this->currentCert) || !isset($this->currentCert['tbsCertificate'])) { return false; } $components = parse_url($url); if (!isset($components['host'])) { return false; } if ($names = $this->getExtension('id-ce-subjectAltName')) { foreach ($names as $name) { foreach ($name as $key => $value) { $value = str_replace(['.', '*'], ['\.', '[^.]*'], $value); switch ($key) { case 'dNSName': /* From RFC2818 "HTTP over TLS": If a subjectAltName extension of type dNSName is present, that MUST be used as the identity. Otherwise, the (most specific) Common Name field in the Subject field of the certificate MUST be used. Although the use of the Common Name is existing practice, it is deprecated and Certification Authorities are encouraged to use the dNSName instead. */ if (preg_match('#^' . $value . '$#', $components['host'])) { return true; } break; case 'iPAddress': /* From RFC2818 "HTTP over TLS": In some cases, the URI is specified as an IP address rather than a hostname. In this case, the iPAddress subjectAltName must be present in the certificate and must exactly match the IP in the URI. */ if (preg_match('#(?:\d{1-3}\.){4}#', $components['host'] . '.') && preg_match('#^' . $value . '$#', $components['host'])) { return true; } } } } return false; } if ($value = $this->getDNProp('id-at-commonName')) { $value = str_replace(['.', '*'], ['\.', '[^.]*'], $value[0]); return preg_match('#^' . $value . '$#', $components['host']) === 1; } return false; } /** * Validate a date * * If $date isn't defined it is assumed to be the current date. * * @param \DateTimeInterface|string $date optional * @return bool */ public function validateDate($date = null) { if (!is_array($this->currentCert) || !isset($this->currentCert['tbsCertificate'])) { return false; } if (!isset($date)) { $date = new \DateTimeImmutable('now', new \DateTimeZone(@date_default_timezone_get())); } $notBefore = $this->currentCert['tbsCertificate']['validity']['notBefore']; $notBefore = isset($notBefore['generalTime']) ? $notBefore['generalTime'] : $notBefore['utcTime']; $notAfter = $this->currentCert['tbsCertificate']['validity']['notAfter']; $notAfter = isset($notAfter['generalTime']) ? $notAfter['generalTime'] : $notAfter['utcTime']; if (is_string($date)) { $date = new \DateTimeImmutable($date, new \DateTimeZone(@date_default_timezone_get())); } $notBefore = new \DateTimeImmutable($notBefore, new \DateTimeZone(@date_default_timezone_get())); $notAfter = new \DateTimeImmutable($notAfter, new \DateTimeZone(@date_default_timezone_get())); return $date >= $notBefore && $date <= $notAfter; } /** * Fetches a URL * * @param string $url * @return bool|string */ private static function fetchURL($url) { if (self::$disable_url_fetch) { return false; } $parts = parse_url($url); $data = ''; switch ($parts['scheme']) { case 'http': $fsock = @fsockopen($parts['host'], isset($parts['port']) ? $parts['port'] : 80); if (!$fsock) { return false; } $path = $parts['path']; if (isset($parts['query'])) { $path .= '?' . $parts['query']; } fputs($fsock, "GET $path HTTP/1.0\r\n"); fputs($fsock, "Host: $parts[host]\r\n\r\n"); $line = fgets($fsock, 1024); if (strlen($line) < 3) { return false; } preg_match('#HTTP/1.\d (\d{3})#', $line, $temp); if ($temp[1] != '200') { return false; } // skip the rest of the headers in the http response while (!feof($fsock) && fgets($fsock, 1024) != "\r\n") { } while (!feof($fsock)) { $temp = fread($fsock, 1024); if ($temp === false) { return false; } $data .= $temp; } break; //case 'ftp': //case 'ldap': //default: } return $data; } /** * Validates an intermediate cert as identified via authority info access extension * * See https://tools.ietf.org/html/rfc4325 for more info * * @param bool $caonly * @param int $count * @return bool */ private function testForIntermediate($caonly, $count) { $opts = $this->getExtension('id-pe-authorityInfoAccess'); if (!is_array($opts)) { return false; } foreach ($opts as $opt) { if ($opt['accessMethod'] == 'id-ad-caIssuers') { // accessLocation is a GeneralName. GeneralName fields support stuff like email addresses, IP addresses, LDAP, // etc, but we're only supporting URI's. URI's and LDAP are the only thing https://tools.ietf.org/html/rfc4325 // discusses if (isset($opt['accessLocation']['uniformResourceIdentifier'])) { $url = $opt['accessLocation']['uniformResourceIdentifier']; break; } } } if (!isset($url)) { return false; } $cert = static::fetchURL($url); if (!is_string($cert)) { return false; } $parent = new static(); $parent->CAs = $this->CAs; /* "Conforming applications that support HTTP or FTP for accessing certificates MUST be able to accept .cer files and SHOULD be able to accept .p7c files." -- https://tools.ietf.org/html/rfc4325 A .p7c file is 'a "certs-only" CMS message as specified in RFC 2797" These are currently unsupported */ if (!is_array($parent->loadX509($cert))) { return false; } if (!$parent->validateSignatureCountable($caonly, ++$count)) { return false; } $this->CAs[] = $parent->currentCert; //$this->loadCA($cert); return true; } /** * Validate a signature * * Works on X.509 certs, CSR's and CRL's. * Returns true if the signature is verified, false if it is not correct or null on error * * By default returns false for self-signed certs. Call validateSignature(false) to make this support * self-signed. * * The behavior of this function is inspired by {@link http://php.net/openssl-verify openssl_verify}. * * @param bool $caonly optional * @return mixed */ public function validateSignature($caonly = true) { return $this->validateSignatureCountable($caonly, 0); } /** * Validate a signature * * Performs said validation whilst keeping track of how many times validation method is called * * @param bool $caonly * @param int $count * @return mixed */ private function validateSignatureCountable($caonly, $count) { if (!is_array($this->currentCert) || !isset($this->signatureSubject)) { return null; } if ($count == self::$recur_limit) { return false; } /* TODO: "emailAddress attribute values are not case-sensitive (e.g., "subscriber@example.com" is the same as "SUBSCRIBER@EXAMPLE.COM")." -- http://tools.ietf.org/html/rfc5280#section-4.1.2.6 implement pathLenConstraint in the id-ce-basicConstraints extension */ switch (true) { case isset($this->currentCert['tbsCertificate']): // self-signed cert switch (true) { case !defined('FILE_X509_IGNORE_TYPE') && $this->currentCert['tbsCertificate']['issuer'] === $this->currentCert['tbsCertificate']['subject']: case defined('FILE_X509_IGNORE_TYPE') && $this->getIssuerDN(self::DN_STRING) === $this->getDN(self::DN_STRING): $authorityKey = $this->getExtension('id-ce-authorityKeyIdentifier'); $subjectKeyID = $this->getExtension('id-ce-subjectKeyIdentifier'); switch (true) { case !is_array($authorityKey): case !$subjectKeyID: case isset($authorityKey['keyIdentifier']) && $authorityKey['keyIdentifier'] === $subjectKeyID: $signingCert = $this->currentCert; // working cert } } if (!empty($this->CAs)) { for ($i = 0; $i < count($this->CAs); $i++) { // even if the cert is a self-signed one we still want to see if it's a CA; // if not, we'll conditionally return an error $ca = $this->CAs[$i]; switch (true) { case !defined('FILE_X509_IGNORE_TYPE') && $this->currentCert['tbsCertificate']['issuer'] === $ca['tbsCertificate']['subject']: case defined('FILE_X509_IGNORE_TYPE') && $this->getDN(self::DN_STRING, $this->currentCert['tbsCertificate']['issuer']) === $this->getDN(self::DN_STRING, $ca['tbsCertificate']['subject']): $authorityKey = $this->getExtension('id-ce-authorityKeyIdentifier'); $subjectKeyID = $this->getExtension('id-ce-subjectKeyIdentifier', $ca); switch (true) { case !is_array($authorityKey): case !$subjectKeyID: case isset($authorityKey['keyIdentifier']) && $authorityKey['keyIdentifier'] === $subjectKeyID: if (is_array($authorityKey) && isset($authorityKey['authorityCertSerialNumber']) && !$authorityKey['authorityCertSerialNumber']->equals($ca['tbsCertificate']['serialNumber'])) { break 2; // serial mismatch - check other ca } $signingCert = $ca; // working cert break 3; } } } if (count($this->CAs) == $i && $caonly) { return $this->testForIntermediate($caonly, $count) && $this->validateSignature($caonly); } } elseif (!isset($signingCert) || $caonly) { return $this->testForIntermediate($caonly, $count) && $this->validateSignature($caonly); } return $this->validateSignatureHelper( $signingCert['tbsCertificate']['subjectPublicKeyInfo']['algorithm']['algorithm'], $signingCert['tbsCertificate']['subjectPublicKeyInfo']['subjectPublicKey'], $this->currentCert['signatureAlgorithm']['algorithm'], substr($this->currentCert['signature'], 1), $this->signatureSubject ); case isset($this->currentCert['certificationRequestInfo']): return $this->validateSignatureHelper( $this->currentCert['certificationRequestInfo']['subjectPKInfo']['algorithm']['algorithm'], $this->currentCert['certificationRequestInfo']['subjectPKInfo']['subjectPublicKey'], $this->currentCert['signatureAlgorithm']['algorithm'], substr($this->currentCert['signature'], 1), $this->signatureSubject ); case isset($this->currentCert['publicKeyAndChallenge']): return $this->validateSignatureHelper( $this->currentCert['publicKeyAndChallenge']['spki']['algorithm']['algorithm'], $this->currentCert['publicKeyAndChallenge']['spki']['subjectPublicKey'], $this->currentCert['signatureAlgorithm']['algorithm'], substr($this->currentCert['signature'], 1), $this->signatureSubject ); case isset($this->currentCert['tbsCertList']): if (!empty($this->CAs)) { for ($i = 0; $i < count($this->CAs); $i++) { $ca = $this->CAs[$i]; switch (true) { case !defined('FILE_X509_IGNORE_TYPE') && $this->currentCert['tbsCertList']['issuer'] === $ca['tbsCertificate']['subject']: case defined('FILE_X509_IGNORE_TYPE') && $this->getDN(self::DN_STRING, $this->currentCert['tbsCertList']['issuer']) === $this->getDN(self::DN_STRING, $ca['tbsCertificate']['subject']): $authorityKey = $this->getExtension('id-ce-authorityKeyIdentifier'); $subjectKeyID = $this->getExtension('id-ce-subjectKeyIdentifier', $ca); switch (true) { case !is_array($authorityKey): case !$subjectKeyID: case isset($authorityKey['keyIdentifier']) && $authorityKey['keyIdentifier'] === $subjectKeyID: if (is_array($authorityKey) && isset($authorityKey['authorityCertSerialNumber']) && !$authorityKey['authorityCertSerialNumber']->equals($ca['tbsCertificate']['serialNumber'])) { break 2; // serial mismatch - check other ca } $signingCert = $ca; // working cert break 3; } } } } if (!isset($signingCert)) { return false; } return $this->validateSignatureHelper( $signingCert['tbsCertificate']['subjectPublicKeyInfo']['algorithm']['algorithm'], $signingCert['tbsCertificate']['subjectPublicKeyInfo']['subjectPublicKey'], $this->currentCert['signatureAlgorithm']['algorithm'], substr($this->currentCert['signature'], 1), $this->signatureSubject ); default: return false; } } /** * Validates a signature * * Returns true if the signature is verified and false if it is not correct. * If the algorithms are unsupposed an exception is thrown. * * @param string $publicKeyAlgorithm * @param string $publicKey * @param string $signatureAlgorithm * @param string $signature * @param string $signatureSubject * @throws \phpseclib3\Exception\UnsupportedAlgorithmException if the algorithm is unsupported * @return bool */ private function validateSignatureHelper($publicKeyAlgorithm, $publicKey, $signatureAlgorithm, $signature, $signatureSubject) { switch ($publicKeyAlgorithm) { case 'id-RSASSA-PSS': $key = RSA::loadFormat('PSS', $publicKey); break; case 'rsaEncryption': $key = RSA::loadFormat('PKCS8', $publicKey); switch ($signatureAlgorithm) { case 'id-RSASSA-PSS': break; case 'md2WithRSAEncryption': case 'md5WithRSAEncryption': case 'sha1WithRSAEncryption': case 'sha224WithRSAEncryption': case 'sha256WithRSAEncryption': case 'sha384WithRSAEncryption': case 'sha512WithRSAEncryption': $key = $key ->withHash(preg_replace('#WithRSAEncryption$#', '', $signatureAlgorithm)) ->withPadding(RSA::SIGNATURE_PKCS1); break; default: throw new UnsupportedAlgorithmException('Signature algorithm unsupported'); } break; case 'id-Ed25519': case 'id-Ed448': $key = EC::loadFormat('PKCS8', $publicKey); break; case 'id-ecPublicKey': $key = EC::loadFormat('PKCS8', $publicKey); switch ($signatureAlgorithm) { case 'ecdsa-with-SHA1': case 'ecdsa-with-SHA224': case 'ecdsa-with-SHA256': case 'ecdsa-with-SHA384': case 'ecdsa-with-SHA512': $key = $key ->withHash(preg_replace('#^ecdsa-with-#', '', strtolower($signatureAlgorithm))); break; default: throw new UnsupportedAlgorithmException('Signature algorithm unsupported'); } break; case 'id-dsa': $key = DSA::loadFormat('PKCS8', $publicKey); switch ($signatureAlgorithm) { case 'id-dsa-with-sha1': case 'id-dsa-with-sha224': case 'id-dsa-with-sha256': $key = $key ->withHash(preg_replace('#^id-dsa-with-#', '', strtolower($signatureAlgorithm))); break; default: throw new UnsupportedAlgorithmException('Signature algorithm unsupported'); } break; default: throw new UnsupportedAlgorithmException('Public key algorithm unsupported'); } return $key->verify($signatureSubject, $signature); } /** * Sets the recursion limit * * When validating a signature it may be necessary to download intermediate certs from URI's. * An intermediate cert that linked to itself would result in an infinite loop so to prevent * that we set a recursion limit. A negative number means that there is no recursion limit. * * @param int $count */ public static function setRecurLimit($count) { self::$recur_limit = $count; } /** * Prevents URIs from being automatically retrieved * */ public static function disableURLFetch() { self::$disable_url_fetch = true; } /** * Allows URIs to be automatically retrieved * */ public static function enableURLFetch() { self::$disable_url_fetch = false; } /** * Decodes an IP address * * Takes in a base64 encoded "blob" and returns a human readable IP address * * @param string $ip * @return string */ public static function decodeIP($ip) { return inet_ntop($ip); } /** * Decodes an IP address in a name constraints extension * * Takes in a base64 encoded "blob" and returns a human readable IP address / mask * * @param string $ip * @return array */ public static function decodeNameConstraintIP($ip) { $size = strlen($ip) >> 1; $mask = substr($ip, $size); $ip = substr($ip, 0, $size); return [inet_ntop($ip), inet_ntop($mask)]; } /** * Encodes an IP address * * Takes a human readable IP address into a base64-encoded "blob" * * @param string|array $ip * @return string */ public static function encodeIP($ip) { return is_string($ip) ? inet_pton($ip) : inet_pton($ip[0]) . inet_pton($ip[1]); } /** * "Normalizes" a Distinguished Name property * * @param string $propName * @return mixed */ private function translateDNProp($propName) { switch (strtolower($propName)) { case 'id-at-countryname': case 'countryname': case 'c': return 'id-at-countryName'; case 'id-at-organizationname': case 'organizationname': case 'o': return 'id-at-organizationName'; case 'id-at-dnqualifier': case 'dnqualifier': return 'id-at-dnQualifier'; case 'id-at-commonname': case 'commonname': case 'cn': return 'id-at-commonName'; case 'id-at-stateorprovincename': case 'stateorprovincename': case 'state': case 'province': case 'provincename': case 'st': return 'id-at-stateOrProvinceName'; case 'id-at-localityname': case 'localityname': case 'l': return 'id-at-localityName'; case 'id-emailaddress': case 'emailaddress': return 'pkcs-9-at-emailAddress'; case 'id-at-serialnumber': case 'serialnumber': return 'id-at-serialNumber'; case 'id-at-postalcode': case 'postalcode': return 'id-at-postalCode'; case 'id-at-streetaddress': case 'streetaddress': return 'id-at-streetAddress'; case 'id-at-name': case 'name': return 'id-at-name'; case 'id-at-givenname': case 'givenname': return 'id-at-givenName'; case 'id-at-surname': case 'surname': case 'sn': return 'id-at-surname'; case 'id-at-initials': case 'initials': return 'id-at-initials'; case 'id-at-generationqualifier': case 'generationqualifier': return 'id-at-generationQualifier'; case 'id-at-organizationalunitname': case 'organizationalunitname': case 'ou': return 'id-at-organizationalUnitName'; case 'id-at-pseudonym': case 'pseudonym': return 'id-at-pseudonym'; case 'id-at-title': case 'title': return 'id-at-title'; case 'id-at-description': case 'description': return 'id-at-description'; case 'id-at-role': case 'role': return 'id-at-role'; case 'id-at-uniqueidentifier': case 'uniqueidentifier': case 'x500uniqueidentifier': return 'id-at-uniqueIdentifier'; case 'postaladdress': case 'id-at-postaladdress': return 'id-at-postalAddress'; default: return false; } } /** * Set a Distinguished Name property * * @param string $propName * @param mixed $propValue * @param string $type optional * @return bool */ public function setDNProp($propName, $propValue, $type = 'utf8String') { if (empty($this->dn)) { $this->dn = ['rdnSequence' => []]; } if (($propName = $this->translateDNProp($propName)) === false) { return false; } foreach ((array) $propValue as $v) { if (!is_array($v) && isset($type)) { $v = [$type => $v]; } $this->dn['rdnSequence'][] = [ [ 'type' => $propName, 'value' => $v ] ]; } return true; } /** * Remove Distinguished Name properties * * @param string $propName */ public function removeDNProp($propName) { if (empty($this->dn)) { return; } if (($propName = $this->translateDNProp($propName)) === false) { return; } $dn = &$this->dn['rdnSequence']; $size = count($dn); for ($i = 0; $i < $size; $i++) { if ($dn[$i][0]['type'] == $propName) { unset($dn[$i]); } } $dn = array_values($dn); // fix for https://bugs.php.net/75433 affecting PHP 7.2 if (!isset($dn[0])) { $dn = array_splice($dn, 0, 0); } } /** * Get Distinguished Name properties * * @param string $propName * @param array $dn optional * @param bool $withType optional * @return mixed */ public function getDNProp($propName, array $dn = null, $withType = false) { if (!isset($dn)) { $dn = $this->dn; } if (empty($dn)) { return false; } if (($propName = $this->translateDNProp($propName)) === false) { return false; } $filters = []; $filters['value'] = ['type' => ASN1::TYPE_UTF8_STRING]; ASN1::setFilters($filters); $this->mapOutDNs($dn, 'rdnSequence'); $dn = $dn['rdnSequence']; $result = []; for ($i = 0; $i < count($dn); $i++) { if ($dn[$i][0]['type'] == $propName) { $v = $dn[$i][0]['value']; if (!$withType) { if (is_array($v)) { foreach ($v as $type => $s) { $type = array_search($type, ASN1::ANY_MAP); if ($type !== false && array_key_exists($type, ASN1::STRING_TYPE_SIZE)) { $s = ASN1::convert($s, $type); if ($s !== false) { $v = $s; break; } } } if (is_array($v)) { $v = array_pop($v); // Always strip data type. } } elseif (is_object($v) && $v instanceof Element) { $map = $this->getMapping($propName); if (!is_bool($map)) { $decoded = ASN1::decodeBER($v); if (!$decoded) { return false; } $v = ASN1::asn1map($decoded[0], $map); } } } $result[] = $v; } } return $result; } /** * Set a Distinguished Name * * @param mixed $dn * @param bool $merge optional * @param string $type optional * @return bool */ public function setDN($dn, $merge = false, $type = 'utf8String') { if (!$merge) { $this->dn = null; } if (is_array($dn)) { if (isset($dn['rdnSequence'])) { $this->dn = $dn; // No merge here. return true; } // handles stuff generated by openssl_x509_parse() foreach ($dn as $prop => $value) { if (!$this->setDNProp($prop, $value, $type)) { return false; } } return true; } // handles everything else $results = preg_split('#((?:^|, *|/)(?:C=|O=|OU=|CN=|L=|ST=|SN=|postalCode=|streetAddress=|emailAddress=|serialNumber=|organizationalUnitName=|title=|description=|role=|x500UniqueIdentifier=|postalAddress=))#', $dn, -1, PREG_SPLIT_DELIM_CAPTURE); for ($i = 1; $i < count($results); $i += 2) { $prop = trim($results[$i], ', =/'); $value = $results[$i + 1]; if (!$this->setDNProp($prop, $value, $type)) { return false; } } return true; } /** * Get the Distinguished Name for a certificates subject * * @param mixed $format optional * @param array $dn optional * @return array|bool|string */ public function getDN($format = self::DN_ARRAY, array $dn = null) { if (!isset($dn)) { $dn = isset($this->currentCert['tbsCertList']) ? $this->currentCert['tbsCertList']['issuer'] : $this->dn; } switch ((int) $format) { case self::DN_ARRAY: return $dn; case self::DN_ASN1: $filters = []; $filters['rdnSequence']['value'] = ['type' => ASN1::TYPE_UTF8_STRING]; ASN1::setFilters($filters); $this->mapOutDNs($dn, 'rdnSequence'); return ASN1::encodeDER($dn, Maps\Name::MAP); case self::DN_CANON: // No SEQUENCE around RDNs and all string values normalized as // trimmed lowercase UTF-8 with all spacing as one blank. // constructed RDNs will not be canonicalized $filters = []; $filters['value'] = ['type' => ASN1::TYPE_UTF8_STRING]; ASN1::setFilters($filters); $result = ''; $this->mapOutDNs($dn, 'rdnSequence'); foreach ($dn['rdnSequence'] as $rdn) { foreach ($rdn as $i => $attr) { $attr = &$rdn[$i]; if (is_array($attr['value'])) { foreach ($attr['value'] as $type => $v) { $type = array_search($type, ASN1::ANY_MAP, true); if ($type !== false && array_key_exists($type, ASN1::STRING_TYPE_SIZE)) { $v = ASN1::convert($v, $type); if ($v !== false) { $v = preg_replace('/\s+/', ' ', $v); $attr['value'] = strtolower(trim($v)); break; } } } } } $result .= ASN1::encodeDER($rdn, Maps\RelativeDistinguishedName::MAP); } return $result; case self::DN_HASH: $dn = $this->getDN(self::DN_CANON, $dn); $hash = new Hash('sha1'); $hash = $hash->hash($dn); extract(unpack('Vhash', $hash)); return strtolower(Strings::bin2hex(pack('N', $hash))); } // Default is to return a string. $start = true; $output = ''; $result = []; $filters = []; $filters['rdnSequence']['value'] = ['type' => ASN1::TYPE_UTF8_STRING]; ASN1::setFilters($filters); $this->mapOutDNs($dn, 'rdnSequence'); foreach ($dn['rdnSequence'] as $field) { $prop = $field[0]['type']; $value = $field[0]['value']; $delim = ', '; switch ($prop) { case 'id-at-countryName': $desc = 'C'; break; case 'id-at-stateOrProvinceName': $desc = 'ST'; break; case 'id-at-organizationName': $desc = 'O'; break; case 'id-at-organizationalUnitName': $desc = 'OU'; break; case 'id-at-commonName': $desc = 'CN'; break; case 'id-at-localityName': $desc = 'L'; break; case 'id-at-surname': $desc = 'SN'; break; case 'id-at-uniqueIdentifier': $delim = '/'; $desc = 'x500UniqueIdentifier'; break; case 'id-at-postalAddress': $delim = '/'; $desc = 'postalAddress'; break; default: $delim = '/'; $desc = preg_replace('#.+-([^-]+)$#', '$1', $prop); } if (!$start) { $output .= $delim; } if (is_array($value)) { foreach ($value as $type => $v) { $type = array_search($type, ASN1::ANY_MAP, true); if ($type !== false && array_key_exists($type, ASN1::STRING_TYPE_SIZE)) { $v = ASN1::convert($v, $type); if ($v !== false) { $value = $v; break; } } } if (is_array($value)) { $value = array_pop($value); // Always strip data type. } } elseif (is_object($value) && $value instanceof Element) { $callback = function ($x) { return '\x' . bin2hex($x[0]); }; $value = strtoupper(preg_replace_callback('#[^\x20-\x7E]#', $callback, $value->element)); } $output .= $desc . '=' . $value; $result[$desc] = isset($result[$desc]) ? array_merge((array) $result[$desc], [$value]) : $value; $start = false; } return $format == self::DN_OPENSSL ? $result : $output; } /** * Get the Distinguished Name for a certificate/crl issuer * * @param int $format optional * @return mixed */ public function getIssuerDN($format = self::DN_ARRAY) { switch (true) { case !isset($this->currentCert) || !is_array($this->currentCert): break; case isset($this->currentCert['tbsCertificate']): return $this->getDN($format, $this->currentCert['tbsCertificate']['issuer']); case isset($this->currentCert['tbsCertList']): return $this->getDN($format, $this->currentCert['tbsCertList']['issuer']); } return false; } /** * Get the Distinguished Name for a certificate/csr subject * Alias of getDN() * * @param int $format optional * @return mixed */ public function getSubjectDN($format = self::DN_ARRAY) { switch (true) { case !empty($this->dn): return $this->getDN($format); case !isset($this->currentCert) || !is_array($this->currentCert): break; case isset($this->currentCert['tbsCertificate']): return $this->getDN($format, $this->currentCert['tbsCertificate']['subject']); case isset($this->currentCert['certificationRequestInfo']): return $this->getDN($format, $this->currentCert['certificationRequestInfo']['subject']); } return false; } /** * Get an individual Distinguished Name property for a certificate/crl issuer * * @param string $propName * @param bool $withType optional * @return mixed */ public function getIssuerDNProp($propName, $withType = false) { switch (true) { case !isset($this->currentCert) || !is_array($this->currentCert): break; case isset($this->currentCert['tbsCertificate']): return $this->getDNProp($propName, $this->currentCert['tbsCertificate']['issuer'], $withType); case isset($this->currentCert['tbsCertList']): return $this->getDNProp($propName, $this->currentCert['tbsCertList']['issuer'], $withType); } return false; } /** * Get an individual Distinguished Name property for a certificate/csr subject * * @param string $propName * @param bool $withType optional * @return mixed */ public function getSubjectDNProp($propName, $withType = false) { switch (true) { case !empty($this->dn): return $this->getDNProp($propName, null, $withType); case !isset($this->currentCert) || !is_array($this->currentCert): break; case isset($this->currentCert['tbsCertificate']): return $this->getDNProp($propName, $this->currentCert['tbsCertificate']['subject'], $withType); case isset($this->currentCert['certificationRequestInfo']): return $this->getDNProp($propName, $this->currentCert['certificationRequestInfo']['subject'], $withType); } return false; } /** * Get the certificate chain for the current cert * * @return mixed */ public function getChain() { $chain = [$this->currentCert]; if (!is_array($this->currentCert) || !isset($this->currentCert['tbsCertificate'])) { return false; } if (empty($this->CAs)) { return $chain; } while (true) { $currentCert = $chain[count($chain) - 1]; for ($i = 0; $i < count($this->CAs); $i++) { $ca = $this->CAs[$i]; if ($currentCert['tbsCertificate']['issuer'] === $ca['tbsCertificate']['subject']) { $authorityKey = $this->getExtension('id-ce-authorityKeyIdentifier', $currentCert); $subjectKeyID = $this->getExtension('id-ce-subjectKeyIdentifier', $ca); switch (true) { case !is_array($authorityKey): case is_array($authorityKey) && isset($authorityKey['keyIdentifier']) && $authorityKey['keyIdentifier'] === $subjectKeyID: if ($currentCert === $ca) { break 3; } $chain[] = $ca; break 2; } } } if ($i == count($this->CAs)) { break; } } foreach ($chain as $key => $value) { $chain[$key] = new X509(); $chain[$key]->loadX509($value); } return $chain; } /** * Returns the current cert * * @return array|bool */ public function &getCurrentCert() { return $this->currentCert; } /** * Set public key * * Key needs to be a \phpseclib3\Crypt\RSA object * * @param PublicKey $key * @return void */ public function setPublicKey(PublicKey $key) { $this->publicKey = $key; } /** * Set private key * * Key needs to be a \phpseclib3\Crypt\RSA object * * @param PrivateKey $key */ public function setPrivateKey(PrivateKey $key) { $this->privateKey = $key; } /** * Set challenge * * Used for SPKAC CSR's * * @param string $challenge */ public function setChallenge($challenge) { $this->challenge = $challenge; } /** * Gets the public key * * Returns a \phpseclib3\Crypt\RSA object or a false. * * @return mixed */ public function getPublicKey() { if (isset($this->publicKey)) { return $this->publicKey; } if (isset($this->currentCert) && is_array($this->currentCert)) { $paths = [ 'tbsCertificate/subjectPublicKeyInfo', 'certificationRequestInfo/subjectPKInfo', 'publicKeyAndChallenge/spki' ]; foreach ($paths as $path) { $keyinfo = $this->subArray($this->currentCert, $path); if (!empty($keyinfo)) { break; } } } if (empty($keyinfo)) { return false; } $key = $keyinfo['subjectPublicKey']; switch ($keyinfo['algorithm']['algorithm']) { case 'id-RSASSA-PSS': return RSA::loadFormat('PSS', $key); case 'rsaEncryption': return RSA::loadFormat('PKCS8', $key)->withPadding(RSA::SIGNATURE_PKCS1); case 'id-ecPublicKey': case 'id-Ed25519': case 'id-Ed448': return EC::loadFormat('PKCS8', $key); case 'id-dsa': return DSA::loadFormat('PKCS8', $key); } return false; } /** * Load a Certificate Signing Request * * @param string $csr * @param int $mode * @return mixed */ public function loadCSR($csr, $mode = self::FORMAT_AUTO_DETECT) { if (is_array($csr) && isset($csr['certificationRequestInfo'])) { unset($this->currentCert); unset($this->currentKeyIdentifier); unset($this->signatureSubject); $this->dn = $csr['certificationRequestInfo']['subject']; if (!isset($this->dn)) { return false; } $this->currentCert = $csr; return $csr; } // see http://tools.ietf.org/html/rfc2986 if ($mode != self::FORMAT_DER) { $newcsr = ASN1::extractBER($csr); if ($mode == self::FORMAT_PEM && $csr == $newcsr) { return false; } $csr = $newcsr; } $orig = $csr; if ($csr === false) { $this->currentCert = false; return false; } $decoded = ASN1::decodeBER($csr); if (!$decoded) { $this->currentCert = false; return false; } $csr = ASN1::asn1map($decoded[0], Maps\CertificationRequest::MAP); if (!isset($csr) || $csr === false) { $this->currentCert = false; return false; } $this->mapInAttributes($csr, 'certificationRequestInfo/attributes'); $this->mapInDNs($csr, 'certificationRequestInfo/subject/rdnSequence'); $this->dn = $csr['certificationRequestInfo']['subject']; $this->signatureSubject = substr($orig, $decoded[0]['content'][0]['start'], $decoded[0]['content'][0]['length']); $key = $csr['certificationRequestInfo']['subjectPKInfo']; $key = ASN1::encodeDER($key, Maps\SubjectPublicKeyInfo::MAP); $csr['certificationRequestInfo']['subjectPKInfo']['subjectPublicKey'] = "-----BEGIN PUBLIC KEY-----\r\n" . chunk_split(base64_encode($key), 64) . "-----END PUBLIC KEY-----"; $this->currentKeyIdentifier = null; $this->currentCert = $csr; $this->publicKey = null; $this->publicKey = $this->getPublicKey(); return $csr; } /** * Save CSR request * * @param array $csr * @param int $format optional * @return string */ public function saveCSR(array $csr, $format = self::FORMAT_PEM) { if (!is_array($csr) || !isset($csr['certificationRequestInfo'])) { return false; } switch (true) { case !($algorithm = $this->subArray($csr, 'certificationRequestInfo/subjectPKInfo/algorithm/algorithm')): case is_object($csr['certificationRequestInfo']['subjectPKInfo']['subjectPublicKey']): break; default: $csr['certificationRequestInfo']['subjectPKInfo'] = new Element( base64_decode(preg_replace('#-.+-|[\r\n]#', '', $csr['certificationRequestInfo']['subjectPKInfo']['subjectPublicKey'])) ); } $filters = []; $filters['certificationRequestInfo']['subject']['rdnSequence']['value'] = ['type' => ASN1::TYPE_UTF8_STRING]; ASN1::setFilters($filters); $this->mapOutDNs($csr, 'certificationRequestInfo/subject/rdnSequence'); $this->mapOutAttributes($csr, 'certificationRequestInfo/attributes'); $csr = ASN1::encodeDER($csr, Maps\CertificationRequest::MAP); switch ($format) { case self::FORMAT_DER: return $csr; // case self::FORMAT_PEM: default: return "-----BEGIN CERTIFICATE REQUEST-----\r\n" . chunk_split(Strings::base64_encode($csr), 64) . '-----END CERTIFICATE REQUEST-----'; } } /** * Load a SPKAC CSR * * SPKAC's are produced by the HTML5 keygen element: * * https://developer.mozilla.org/en-US/docs/HTML/Element/keygen * * @param string $spkac * @return mixed */ public function loadSPKAC($spkac) { if (is_array($spkac) && isset($spkac['publicKeyAndChallenge'])) { unset($this->currentCert); unset($this->currentKeyIdentifier); unset($this->signatureSubject); $this->currentCert = $spkac; return $spkac; } // see http://www.w3.org/html/wg/drafts/html/master/forms.html#signedpublickeyandchallenge // OpenSSL produces SPKAC's that are preceded by the string SPKAC= $temp = preg_replace('#(?:SPKAC=)|[ \r\n\\\]#', '', $spkac); $temp = preg_match('#^[a-zA-Z\d/+]*={0,2}$#', $temp) ? Strings::base64_decode($temp) : false; if ($temp != false) { $spkac = $temp; } $orig = $spkac; if ($spkac === false) { $this->currentCert = false; return false; } $decoded = ASN1::decodeBER($spkac); if (!$decoded) { $this->currentCert = false; return false; } $spkac = ASN1::asn1map($decoded[0], Maps\SignedPublicKeyAndChallenge::MAP); if (!isset($spkac) || !is_array($spkac)) { $this->currentCert = false; return false; } $this->signatureSubject = substr($orig, $decoded[0]['content'][0]['start'], $decoded[0]['content'][0]['length']); $key = $spkac['publicKeyAndChallenge']['spki']; $key = ASN1::encodeDER($key, Maps\SubjectPublicKeyInfo::MAP); $spkac['publicKeyAndChallenge']['spki']['subjectPublicKey'] = "-----BEGIN PUBLIC KEY-----\r\n" . chunk_split(base64_encode($key), 64) . "-----END PUBLIC KEY-----"; $this->currentKeyIdentifier = null; $this->currentCert = $spkac; $this->publicKey = null; $this->publicKey = $this->getPublicKey(); return $spkac; } /** * Save a SPKAC CSR request * * @param array $spkac * @param int $format optional * @return string */ public function saveSPKAC(array $spkac, $format = self::FORMAT_PEM) { if (!is_array($spkac) || !isset($spkac['publicKeyAndChallenge'])) { return false; } $algorithm = $this->subArray($spkac, 'publicKeyAndChallenge/spki/algorithm/algorithm'); switch (true) { case !$algorithm: case is_object($spkac['publicKeyAndChallenge']['spki']['subjectPublicKey']): break; default: $spkac['publicKeyAndChallenge']['spki'] = new Element( base64_decode(preg_replace('#-.+-|[\r\n]#', '', $spkac['publicKeyAndChallenge']['spki']['subjectPublicKey'])) ); } $spkac = ASN1::encodeDER($spkac, Maps\SignedPublicKeyAndChallenge::MAP); switch ($format) { case self::FORMAT_DER: return $spkac; // case self::FORMAT_PEM: default: // OpenSSL's implementation of SPKAC requires the SPKAC be preceded by SPKAC= and since there are pretty much // no other SPKAC decoders phpseclib will use that same format return 'SPKAC=' . Strings::base64_encode($spkac); } } /** * Load a Certificate Revocation List * * @param string $crl * @param int $mode * @return mixed */ public function loadCRL($crl, $mode = self::FORMAT_AUTO_DETECT) { if (is_array($crl) && isset($crl['tbsCertList'])) { $this->currentCert = $crl; unset($this->signatureSubject); return $crl; } if ($mode != self::FORMAT_DER) { $newcrl = ASN1::extractBER($crl); if ($mode == self::FORMAT_PEM && $crl == $newcrl) { return false; } $crl = $newcrl; } $orig = $crl; if ($crl === false) { $this->currentCert = false; return false; } $decoded = ASN1::decodeBER($crl); if (!$decoded) { $this->currentCert = false; return false; } $crl = ASN1::asn1map($decoded[0], Maps\CertificateList::MAP); if (!isset($crl) || $crl === false) { $this->currentCert = false; return false; } $this->signatureSubject = substr($orig, $decoded[0]['content'][0]['start'], $decoded[0]['content'][0]['length']); $this->mapInDNs($crl, 'tbsCertList/issuer/rdnSequence'); if ($this->isSubArrayValid($crl, 'tbsCertList/crlExtensions')) { $this->mapInExtensions($crl, 'tbsCertList/crlExtensions'); } if ($this->isSubArrayValid($crl, 'tbsCertList/revokedCertificates')) { $rclist_ref = &$this->subArrayUnchecked($crl, 'tbsCertList/revokedCertificates'); if ($rclist_ref) { $rclist = $crl['tbsCertList']['revokedCertificates']; foreach ($rclist as $i => $extension) { if ($this->isSubArrayValid($rclist, "$i/crlEntryExtensions")) { $this->mapInExtensions($rclist_ref, "$i/crlEntryExtensions"); } } } } $this->currentKeyIdentifier = null; $this->currentCert = $crl; return $crl; } /** * Save Certificate Revocation List. * * @param array $crl * @param int $format optional * @return string */ public function saveCRL(array $crl, $format = self::FORMAT_PEM) { if (!is_array($crl) || !isset($crl['tbsCertList'])) { return false; } $filters = []; $filters['tbsCertList']['issuer']['rdnSequence']['value'] = ['type' => ASN1::TYPE_UTF8_STRING]; $filters['tbsCertList']['signature']['parameters'] = ['type' => ASN1::TYPE_UTF8_STRING]; $filters['signatureAlgorithm']['parameters'] = ['type' => ASN1::TYPE_UTF8_STRING]; if (empty($crl['tbsCertList']['signature']['parameters'])) { $filters['tbsCertList']['signature']['parameters'] = ['type' => ASN1::TYPE_NULL]; } if (empty($crl['signatureAlgorithm']['parameters'])) { $filters['signatureAlgorithm']['parameters'] = ['type' => ASN1::TYPE_NULL]; } ASN1::setFilters($filters); $this->mapOutDNs($crl, 'tbsCertList/issuer/rdnSequence'); $this->mapOutExtensions($crl, 'tbsCertList/crlExtensions'); $rclist = &$this->subArray($crl, 'tbsCertList/revokedCertificates'); if (is_array($rclist)) { foreach ($rclist as $i => $extension) { $this->mapOutExtensions($rclist, "$i/crlEntryExtensions"); } } $crl = ASN1::encodeDER($crl, Maps\CertificateList::MAP); switch ($format) { case self::FORMAT_DER: return $crl; // case self::FORMAT_PEM: default: return "-----BEGIN X509 CRL-----\r\n" . chunk_split(Strings::base64_encode($crl), 64) . '-----END X509 CRL-----'; } } /** * Helper function to build a time field according to RFC 3280 section * - 4.1.2.5 Validity * - 5.1.2.4 This Update * - 5.1.2.5 Next Update * - 5.1.2.6 Revoked Certificates * by choosing utcTime iff year of date given is before 2050 and generalTime else. * * @param string $date in format date('D, d M Y H:i:s O') * @return array|Element */ private function timeField($date) { if ($date instanceof Element) { return $date; } $dateObj = new \DateTimeImmutable($date, new \DateTimeZone('GMT')); $year = $dateObj->format('Y'); // the same way ASN1.php parses this if ($year < 2050) { return ['utcTime' => $date]; } else { return ['generalTime' => $date]; } } /** * Sign an X.509 certificate * * $issuer's private key needs to be loaded. * $subject can be either an existing X.509 cert (if you want to resign it), * a CSR or something with the DN and public key explicitly set. * * @return mixed */ public function sign(X509 $issuer, X509 $subject) { if (!is_object($issuer->privateKey) || empty($issuer->dn)) { return false; } if (isset($subject->publicKey) && !($subjectPublicKey = $subject->formatSubjectPublicKey())) { return false; } $currentCert = isset($this->currentCert) ? $this->currentCert : null; $signatureSubject = isset($this->signatureSubject) ? $this->signatureSubject : null; $signatureAlgorithm = self::identifySignatureAlgorithm($issuer->privateKey); if (isset($subject->currentCert) && is_array($subject->currentCert) && isset($subject->currentCert['tbsCertificate'])) { $this->currentCert = $subject->currentCert; $this->currentCert['tbsCertificate']['signature'] = $signatureAlgorithm; $this->currentCert['signatureAlgorithm'] = $signatureAlgorithm; if (!empty($this->startDate)) { $this->currentCert['tbsCertificate']['validity']['notBefore'] = $this->timeField($this->startDate); } if (!empty($this->endDate)) { $this->currentCert['tbsCertificate']['validity']['notAfter'] = $this->timeField($this->endDate); } if (!empty($this->serialNumber)) { $this->currentCert['tbsCertificate']['serialNumber'] = $this->serialNumber; } if (!empty($subject->dn)) { $this->currentCert['tbsCertificate']['subject'] = $subject->dn; } if (!empty($subject->publicKey)) { $this->currentCert['tbsCertificate']['subjectPublicKeyInfo'] = $subjectPublicKey; } $this->removeExtension('id-ce-authorityKeyIdentifier'); if (isset($subject->domains)) { $this->removeExtension('id-ce-subjectAltName'); } } elseif (isset($subject->currentCert) && is_array($subject->currentCert) && isset($subject->currentCert['tbsCertList'])) { return false; } else { if (!isset($subject->publicKey)) { return false; } $startDate = new \DateTimeImmutable('now', new \DateTimeZone(@date_default_timezone_get())); $startDate = !empty($this->startDate) ? $this->startDate : $startDate->format('D, d M Y H:i:s O'); $endDate = new \DateTimeImmutable('+1 year', new \DateTimeZone(@date_default_timezone_get())); $endDate = !empty($this->endDate) ? $this->endDate : $endDate->format('D, d M Y H:i:s O'); /* "The serial number MUST be a positive integer" "Conforming CAs MUST NOT use serialNumber values longer than 20 octets." -- https://tools.ietf.org/html/rfc5280#section-4.1.2.2 for the integer to be positive the leading bit needs to be 0 hence the application of a bitmap */ $serialNumber = !empty($this->serialNumber) ? $this->serialNumber : new BigInteger(Random::string(20) & ("\x7F" . str_repeat("\xFF", 19)), 256); $this->currentCert = [ 'tbsCertificate' => [ 'version' => 'v3', 'serialNumber' => $serialNumber, // $this->setSerialNumber() 'signature' => $signatureAlgorithm, 'issuer' => false, // this is going to be overwritten later 'validity' => [ 'notBefore' => $this->timeField($startDate), // $this->setStartDate() 'notAfter' => $this->timeField($endDate) // $this->setEndDate() ], 'subject' => $subject->dn, 'subjectPublicKeyInfo' => $subjectPublicKey ], 'signatureAlgorithm' => $signatureAlgorithm, 'signature' => false // this is going to be overwritten later ]; // Copy extensions from CSR. $csrexts = $subject->getAttribute('pkcs-9-at-extensionRequest', 0); if (!empty($csrexts)) { $this->currentCert['tbsCertificate']['extensions'] = $csrexts; } } $this->currentCert['tbsCertificate']['issuer'] = $issuer->dn; if (isset($issuer->currentKeyIdentifier)) { $this->setExtension('id-ce-authorityKeyIdentifier', [ //'authorityCertIssuer' => array( // array( // 'directoryName' => $issuer->dn // ) //), 'keyIdentifier' => $issuer->currentKeyIdentifier ]); //$extensions = &$this->currentCert['tbsCertificate']['extensions']; //if (isset($issuer->serialNumber)) { // $extensions[count($extensions) - 1]['authorityCertSerialNumber'] = $issuer->serialNumber; //} //unset($extensions); } if (isset($subject->currentKeyIdentifier)) { $this->setExtension('id-ce-subjectKeyIdentifier', $subject->currentKeyIdentifier); } $altName = []; if (isset($subject->domains) && count($subject->domains)) { $altName = array_map(['\phpseclib3\File\X509', 'dnsName'], $subject->domains); } if (isset($subject->ipAddresses) && count($subject->ipAddresses)) { // should an IP address appear as the CN if no domain name is specified? idk //$ips = count($subject->domains) ? $subject->ipAddresses : array_slice($subject->ipAddresses, 1); $ipAddresses = []; foreach ($subject->ipAddresses as $ipAddress) { $encoded = $subject->ipAddress($ipAddress); if ($encoded !== false) { $ipAddresses[] = $encoded; } } if (count($ipAddresses)) { $altName = array_merge($altName, $ipAddresses); } } if (!empty($altName)) { $this->setExtension('id-ce-subjectAltName', $altName); } if ($this->caFlag) { $keyUsage = $this->getExtension('id-ce-keyUsage'); if (!$keyUsage) { $keyUsage = []; } $this->setExtension( 'id-ce-keyUsage', array_values(array_unique(array_merge($keyUsage, ['cRLSign', 'keyCertSign']))) ); $basicConstraints = $this->getExtension('id-ce-basicConstraints'); if (!$basicConstraints) { $basicConstraints = []; } $this->setExtension( 'id-ce-basicConstraints', array_merge(['cA' => true], $basicConstraints), true ); if (!isset($subject->currentKeyIdentifier)) { $this->setExtension('id-ce-subjectKeyIdentifier', $this->computeKeyIdentifier($this->currentCert), false, false); } } // resync $this->signatureSubject // save $tbsCertificate in case there are any \phpseclib3\File\ASN1\Element objects in it $tbsCertificate = $this->currentCert['tbsCertificate']; $this->loadX509($this->saveX509($this->currentCert)); $result = $this->currentCert; $this->currentCert['signature'] = $result['signature'] = "\0" . $issuer->privateKey->sign($this->signatureSubject); $result['tbsCertificate'] = $tbsCertificate; $this->currentCert = $currentCert; $this->signatureSubject = $signatureSubject; return $result; } /** * Sign a CSR * * @return mixed */ public function signCSR() { if (!is_object($this->privateKey) || empty($this->dn)) { return false; } $origPublicKey = $this->publicKey; $this->publicKey = $this->privateKey->getPublicKey(); $publicKey = $this->formatSubjectPublicKey(); $this->publicKey = $origPublicKey; $currentCert = isset($this->currentCert) ? $this->currentCert : null; $signatureSubject = isset($this->signatureSubject) ? $this->signatureSubject : null; $signatureAlgorithm = self::identifySignatureAlgorithm($this->privateKey); if (isset($this->currentCert) && is_array($this->currentCert) && isset($this->currentCert['certificationRequestInfo'])) { $this->currentCert['signatureAlgorithm'] = $signatureAlgorithm; if (!empty($this->dn)) { $this->currentCert['certificationRequestInfo']['subject'] = $this->dn; } $this->currentCert['certificationRequestInfo']['subjectPKInfo'] = $publicKey; } else { $this->currentCert = [ 'certificationRequestInfo' => [ 'version' => 'v1', 'subject' => $this->dn, 'subjectPKInfo' => $publicKey ], 'signatureAlgorithm' => $signatureAlgorithm, 'signature' => false // this is going to be overwritten later ]; } // resync $this->signatureSubject // save $certificationRequestInfo in case there are any \phpseclib3\File\ASN1\Element objects in it $certificationRequestInfo = $this->currentCert['certificationRequestInfo']; $this->loadCSR($this->saveCSR($this->currentCert)); $result = $this->currentCert; $this->currentCert['signature'] = $result['signature'] = "\0" . $this->privateKey->sign($this->signatureSubject); $result['certificationRequestInfo'] = $certificationRequestInfo; $this->currentCert = $currentCert; $this->signatureSubject = $signatureSubject; return $result; } /** * Sign a SPKAC * * @return mixed */ public function signSPKAC() { if (!is_object($this->privateKey)) { return false; } $origPublicKey = $this->publicKey; $this->publicKey = $this->privateKey->getPublicKey(); $publicKey = $this->formatSubjectPublicKey(); $this->publicKey = $origPublicKey; $currentCert = isset($this->currentCert) ? $this->currentCert : null; $signatureSubject = isset($this->signatureSubject) ? $this->signatureSubject : null; $signatureAlgorithm = self::identifySignatureAlgorithm($this->privateKey); // re-signing a SPKAC seems silly but since everything else supports re-signing why not? if (isset($this->currentCert) && is_array($this->currentCert) && isset($this->currentCert['publicKeyAndChallenge'])) { $this->currentCert['signatureAlgorithm'] = $signatureAlgorithm; $this->currentCert['publicKeyAndChallenge']['spki'] = $publicKey; if (!empty($this->challenge)) { // the bitwise AND ensures that the output is a valid IA5String $this->currentCert['publicKeyAndChallenge']['challenge'] = $this->challenge & str_repeat("\x7F", strlen($this->challenge)); } } else { $this->currentCert = [ 'publicKeyAndChallenge' => [ 'spki' => $publicKey, // quoting , // "A challenge string that is submitted along with the public key. Defaults to an empty string if not specified." // both Firefox and OpenSSL ("openssl spkac -key private.key") behave this way // we could alternatively do this instead if we ignored the specs: // Random::string(8) & str_repeat("\x7F", 8) 'challenge' => !empty($this->challenge) ? $this->challenge : '' ], 'signatureAlgorithm' => $signatureAlgorithm, 'signature' => false // this is going to be overwritten later ]; } // resync $this->signatureSubject // save $publicKeyAndChallenge in case there are any \phpseclib3\File\ASN1\Element objects in it $publicKeyAndChallenge = $this->currentCert['publicKeyAndChallenge']; $this->loadSPKAC($this->saveSPKAC($this->currentCert)); $result = $this->currentCert; $this->currentCert['signature'] = $result['signature'] = "\0" . $this->privateKey->sign($this->signatureSubject); $result['publicKeyAndChallenge'] = $publicKeyAndChallenge; $this->currentCert = $currentCert; $this->signatureSubject = $signatureSubject; return $result; } /** * Sign a CRL * * $issuer's private key needs to be loaded. * * @return mixed */ public function signCRL(X509 $issuer, X509 $crl) { if (!is_object($issuer->privateKey) || empty($issuer->dn)) { return false; } $currentCert = isset($this->currentCert) ? $this->currentCert : null; $signatureSubject = isset($this->signatureSubject) ? $this->signatureSubject : null; $signatureAlgorithm = self::identifySignatureAlgorithm($issuer->privateKey); $thisUpdate = new \DateTimeImmutable('now', new \DateTimeZone(@date_default_timezone_get())); $thisUpdate = !empty($this->startDate) ? $this->startDate : $thisUpdate->format('D, d M Y H:i:s O'); if (isset($crl->currentCert) && is_array($crl->currentCert) && isset($crl->currentCert['tbsCertList'])) { $this->currentCert = $crl->currentCert; $this->currentCert['tbsCertList']['signature'] = $signatureAlgorithm; $this->currentCert['signatureAlgorithm'] = $signatureAlgorithm; } else { $this->currentCert = [ 'tbsCertList' => [ 'version' => 'v2', 'signature' => $signatureAlgorithm, 'issuer' => false, // this is going to be overwritten later 'thisUpdate' => $this->timeField($thisUpdate) // $this->setStartDate() ], 'signatureAlgorithm' => $signatureAlgorithm, 'signature' => false // this is going to be overwritten later ]; } $tbsCertList = &$this->currentCert['tbsCertList']; $tbsCertList['issuer'] = $issuer->dn; $tbsCertList['thisUpdate'] = $this->timeField($thisUpdate); if (!empty($this->endDate)) { $tbsCertList['nextUpdate'] = $this->timeField($this->endDate); // $this->setEndDate() } else { unset($tbsCertList['nextUpdate']); } if (!empty($this->serialNumber)) { $crlNumber = $this->serialNumber; } else { $crlNumber = $this->getExtension('id-ce-cRLNumber'); // "The CRL number is a non-critical CRL extension that conveys a // monotonically increasing sequence number for a given CRL scope and // CRL issuer. This extension allows users to easily determine when a // particular CRL supersedes another CRL." // -- https://tools.ietf.org/html/rfc5280#section-5.2.3 $crlNumber = $crlNumber !== false ? $crlNumber->add(new BigInteger(1)) : null; } $this->removeExtension('id-ce-authorityKeyIdentifier'); $this->removeExtension('id-ce-issuerAltName'); // Be sure version >= v2 if some extension found. $version = isset($tbsCertList['version']) ? $tbsCertList['version'] : 0; if (!$version) { if (!empty($tbsCertList['crlExtensions'])) { $version = 1; // v2. } elseif (!empty($tbsCertList['revokedCertificates'])) { foreach ($tbsCertList['revokedCertificates'] as $cert) { if (!empty($cert['crlEntryExtensions'])) { $version = 1; // v2. } } } if ($version) { $tbsCertList['version'] = $version; } } // Store additional extensions. if (!empty($tbsCertList['version'])) { // At least v2. if (!empty($crlNumber)) { $this->setExtension('id-ce-cRLNumber', $crlNumber); } if (isset($issuer->currentKeyIdentifier)) { $this->setExtension('id-ce-authorityKeyIdentifier', [ //'authorityCertIssuer' => array( // ] // 'directoryName' => $issuer->dn // ] //), 'keyIdentifier' => $issuer->currentKeyIdentifier ]); //$extensions = &$tbsCertList['crlExtensions']; //if (isset($issuer->serialNumber)) { // $extensions[count($extensions) - 1]['authorityCertSerialNumber'] = $issuer->serialNumber; //} //unset($extensions); } $issuerAltName = $this->getExtension('id-ce-subjectAltName', $issuer->currentCert); if ($issuerAltName !== false) { $this->setExtension('id-ce-issuerAltName', $issuerAltName); } } if (empty($tbsCertList['revokedCertificates'])) { unset($tbsCertList['revokedCertificates']); } unset($tbsCertList); // resync $this->signatureSubject // save $tbsCertList in case there are any \phpseclib3\File\ASN1\Element objects in it $tbsCertList = $this->currentCert['tbsCertList']; $this->loadCRL($this->saveCRL($this->currentCert)); $result = $this->currentCert; $this->currentCert['signature'] = $result['signature'] = "\0" . $issuer->privateKey->sign($this->signatureSubject); $result['tbsCertList'] = $tbsCertList; $this->currentCert = $currentCert; $this->signatureSubject = $signatureSubject; return $result; } /** * Identify signature algorithm from key settings * * @param PrivateKey $key * @throws \phpseclib3\Exception\UnsupportedAlgorithmException if the algorithm is unsupported * @return array */ private static function identifySignatureAlgorithm(PrivateKey $key) { if ($key instanceof RSA) { if ($key->getPadding() & RSA::SIGNATURE_PSS) { $r = PSS::load($key->withPassword()->toString('PSS')); return [ 'algorithm' => 'id-RSASSA-PSS', 'parameters' => PSS::savePSSParams($r) ]; } switch ($key->getHash()) { case 'md2': case 'md5': case 'sha1': case 'sha224': case 'sha256': case 'sha384': case 'sha512': return ['algorithm' => $key->getHash() . 'WithRSAEncryption']; } throw new UnsupportedAlgorithmException('The only supported hash algorithms for RSA are: md2, md5, sha1, sha224, sha256, sha384, sha512'); } if ($key instanceof DSA) { switch ($key->getHash()) { case 'sha1': case 'sha224': case 'sha256': return ['algorithm' => 'id-dsa-with-' . $key->getHash()]; } throw new UnsupportedAlgorithmException('The only supported hash algorithms for DSA are: sha1, sha224, sha256'); } if ($key instanceof EC) { switch ($key->getCurve()) { case 'Ed25519': case 'Ed448': return ['algorithm' => 'id-' . $key->getCurve()]; } switch ($key->getHash()) { case 'sha1': case 'sha224': case 'sha256': case 'sha384': case 'sha512': return ['algorithm' => 'ecdsa-with-' . strtoupper($key->getHash())]; } throw new UnsupportedAlgorithmException('The only supported hash algorithms for EC are: sha1, sha224, sha256, sha384, sha512'); } throw new UnsupportedAlgorithmException('The only supported public key classes are: RSA, DSA, EC'); } /** * Set certificate start date * * @param \DateTimeInterface|string $date */ public function setStartDate($date) { if (!is_object($date) || !($date instanceof \DateTimeInterface)) { $date = new \DateTimeImmutable($date, new \DateTimeZone(@date_default_timezone_get())); } $this->startDate = $date->format('D, d M Y H:i:s O'); } /** * Set certificate end date * * @param \DateTimeInterface|string $date */ public function setEndDate($date) { /* To indicate that a certificate has no well-defined expiration date, the notAfter SHOULD be assigned the GeneralizedTime value of 99991231235959Z. -- http://tools.ietf.org/html/rfc5280#section-4.1.2.5 */ if (is_string($date) && strtolower($date) === 'lifetime') { $temp = '99991231235959Z'; $temp = chr(ASN1::TYPE_GENERALIZED_TIME) . ASN1::encodeLength(strlen($temp)) . $temp; $this->endDate = new Element($temp); } else { if (!is_object($date) || !($date instanceof \DateTimeInterface)) { $date = new \DateTimeImmutable($date, new \DateTimeZone(@date_default_timezone_get())); } $this->endDate = $date->format('D, d M Y H:i:s O'); } } /** * Set Serial Number * * @param string $serial * @param int $base optional */ public function setSerialNumber($serial, $base = -256) { $this->serialNumber = new BigInteger($serial, $base); } /** * Turns the certificate into a certificate authority * */ public function makeCA() { $this->caFlag = true; } /** * Check for validity of subarray * * This is intended for use in conjunction with _subArrayUnchecked(), * implementing the checks included in _subArray() but without copying * a potentially large array by passing its reference by-value to is_array(). * * @param array $root * @param string $path * @return boolean */ private function isSubArrayValid(array $root, $path) { if (!is_array($root)) { return false; } foreach (explode('/', $path) as $i) { if (!is_array($root)) { return false; } if (!isset($root[$i])) { return true; } $root = $root[$i]; } return true; } /** * Get a reference to a subarray * * This variant of _subArray() does no is_array() checking, * so $root should be checked with _isSubArrayValid() first. * * This is here for performance reasons: * Passing a reference (i.e. $root) by-value (i.e. to is_array()) * creates a copy. If $root is an especially large array, this is expensive. * * @param array $root * @param string $path absolute path with / as component separator * @param bool $create optional * @return array|false */ private function &subArrayUnchecked(array &$root, $path, $create = false) { $false = false; foreach (explode('/', $path) as $i) { if (!isset($root[$i])) { if (!$create) { return $false; } $root[$i] = []; } $root = &$root[$i]; } return $root; } /** * Get a reference to a subarray * * @param array $root * @param string $path absolute path with / as component separator * @param bool $create optional * @return array|false */ private function &subArray(array &$root = null, $path, $create = false) { $false = false; if (!is_array($root)) { return $false; } foreach (explode('/', $path) as $i) { if (!is_array($root)) { return $false; } if (!isset($root[$i])) { if (!$create) { return $false; } $root[$i] = []; } $root = &$root[$i]; } return $root; } /** * Get a reference to an extension subarray * * @param array $root * @param string $path optional absolute path with / as component separator * @param bool $create optional * @return array|false */ private function &extensions(array &$root = null, $path = null, $create = false) { if (!isset($root)) { $root = $this->currentCert; } switch (true) { case !empty($path): case !is_array($root): break; case isset($root['tbsCertificate']): $path = 'tbsCertificate/extensions'; break; case isset($root['tbsCertList']): $path = 'tbsCertList/crlExtensions'; break; case isset($root['certificationRequestInfo']): $pth = 'certificationRequestInfo/attributes'; $attributes = &$this->subArray($root, $pth, $create); if (is_array($attributes)) { foreach ($attributes as $key => $value) { if ($value['type'] == 'pkcs-9-at-extensionRequest') { $path = "$pth/$key/value/0"; break 2; } } if ($create) { $key = count($attributes); $attributes[] = ['type' => 'pkcs-9-at-extensionRequest', 'value' => []]; $path = "$pth/$key/value/0"; } } break; } $extensions = &$this->subArray($root, $path, $create); if (!is_array($extensions)) { $false = false; return $false; } return $extensions; } /** * Remove an Extension * * @param string $id * @param string $path optional * @return bool */ private function removeExtensionHelper($id, $path = null) { $extensions = &$this->extensions($this->currentCert, $path); if (!is_array($extensions)) { return false; } $result = false; foreach ($extensions as $key => $value) { if ($value['extnId'] == $id) { unset($extensions[$key]); $result = true; } } $extensions = array_values($extensions); // fix for https://bugs.php.net/75433 affecting PHP 7.2 if (!isset($extensions[0])) { $extensions = array_splice($extensions, 0, 0); } return $result; } /** * Get an Extension * * Returns the extension if it exists and false if not * * @param string $id * @param array $cert optional * @param string $path optional * @return mixed */ private function getExtensionHelper($id, array $cert = null, $path = null) { $extensions = $this->extensions($cert, $path); if (!is_array($extensions)) { return false; } foreach ($extensions as $key => $value) { if ($value['extnId'] == $id) { return $value['extnValue']; } } return false; } /** * Returns a list of all extensions in use * * @param array $cert optional * @param string $path optional * @return array */ private function getExtensionsHelper(array $cert = null, $path = null) { $exts = $this->extensions($cert, $path); $extensions = []; if (is_array($exts)) { foreach ($exts as $extension) { $extensions[] = $extension['extnId']; } } return $extensions; } /** * Set an Extension * * @param string $id * @param mixed $value * @param bool $critical optional * @param bool $replace optional * @param string $path optional * @return bool */ private function setExtensionHelper($id, $value, $critical = false, $replace = true, $path = null) { $extensions = &$this->extensions($this->currentCert, $path, true); if (!is_array($extensions)) { return false; } $newext = ['extnId' => $id, 'critical' => $critical, 'extnValue' => $value]; foreach ($extensions as $key => $value) { if ($value['extnId'] == $id) { if (!$replace) { return false; } $extensions[$key] = $newext; return true; } } $extensions[] = $newext; return true; } /** * Remove a certificate, CSR or CRL Extension * * @param string $id * @return bool */ public function removeExtension($id) { return $this->removeExtensionHelper($id); } /** * Get a certificate, CSR or CRL Extension * * Returns the extension if it exists and false if not * * @param string $id * @param array $cert optional * @param string $path * @return mixed */ public function getExtension($id, array $cert = null, $path = null) { return $this->getExtensionHelper($id, $cert, $path); } /** * Returns a list of all extensions in use in certificate, CSR or CRL * * @param array $cert optional * @param string $path optional * @return array */ public function getExtensions(array $cert = null, $path = null) { return $this->getExtensionsHelper($cert, $path); } /** * Set a certificate, CSR or CRL Extension * * @param string $id * @param mixed $value * @param bool $critical optional * @param bool $replace optional * @return bool */ public function setExtension($id, $value, $critical = false, $replace = true) { return $this->setExtensionHelper($id, $value, $critical, $replace); } /** * Remove a CSR attribute. * * @param string $id * @param int $disposition optional * @return bool */ public function removeAttribute($id, $disposition = self::ATTR_ALL) { $attributes = &$this->subArray($this->currentCert, 'certificationRequestInfo/attributes'); if (!is_array($attributes)) { return false; } $result = false; foreach ($attributes as $key => $attribute) { if ($attribute['type'] == $id) { $n = count($attribute['value']); switch (true) { case $disposition == self::ATTR_APPEND: case $disposition == self::ATTR_REPLACE: return false; case $disposition >= $n: $disposition -= $n; break; case $disposition == self::ATTR_ALL: case $n == 1: unset($attributes[$key]); $result = true; break; default: unset($attributes[$key]['value'][$disposition]); $attributes[$key]['value'] = array_values($attributes[$key]['value']); $result = true; break; } if ($result && $disposition != self::ATTR_ALL) { break; } } } $attributes = array_values($attributes); return $result; } /** * Get a CSR attribute * * Returns the attribute if it exists and false if not * * @param string $id * @param int $disposition optional * @param array $csr optional * @return mixed */ public function getAttribute($id, $disposition = self::ATTR_ALL, array $csr = null) { if (empty($csr)) { $csr = $this->currentCert; } $attributes = $this->subArray($csr, 'certificationRequestInfo/attributes'); if (!is_array($attributes)) { return false; } foreach ($attributes as $key => $attribute) { if ($attribute['type'] == $id) { $n = count($attribute['value']); switch (true) { case $disposition == self::ATTR_APPEND: case $disposition == self::ATTR_REPLACE: return false; case $disposition == self::ATTR_ALL: return $attribute['value']; case $disposition >= $n: $disposition -= $n; break; default: return $attribute['value'][$disposition]; } } } return false; } /** * Returns a list of all CSR attributes in use * * @param array $csr optional * @return array */ public function getAttributes(array $csr = null) { if (empty($csr)) { $csr = $this->currentCert; } $attributes = $this->subArray($csr, 'certificationRequestInfo/attributes'); $attrs = []; if (is_array($attributes)) { foreach ($attributes as $attribute) { $attrs[] = $attribute['type']; } } return $attrs; } /** * Set a CSR attribute * * @param string $id * @param mixed $value * @param int $disposition optional * @return bool */ public function setAttribute($id, $value, $disposition = self::ATTR_ALL) { $attributes = &$this->subArray($this->currentCert, 'certificationRequestInfo/attributes', true); if (!is_array($attributes)) { return false; } switch ($disposition) { case self::ATTR_REPLACE: $disposition = self::ATTR_APPEND; // fall-through case self::ATTR_ALL: $this->removeAttribute($id); break; } foreach ($attributes as $key => $attribute) { if ($attribute['type'] == $id) { $n = count($attribute['value']); switch (true) { case $disposition == self::ATTR_APPEND: $last = $key; break; case $disposition >= $n: $disposition -= $n; break; default: $attributes[$key]['value'][$disposition] = $value; return true; } } } switch (true) { case $disposition >= 0: return false; case isset($last): $attributes[$last]['value'][] = $value; break; default: $attributes[] = ['type' => $id, 'value' => $disposition == self::ATTR_ALL ? $value : [$value]]; break; } return true; } /** * Sets the subject key identifier * * This is used by the id-ce-authorityKeyIdentifier and the id-ce-subjectKeyIdentifier extensions. * * @param string $value */ public function setKeyIdentifier($value) { if (empty($value)) { unset($this->currentKeyIdentifier); } else { $this->currentKeyIdentifier = $value; } } /** * Compute a public key identifier. * * Although key identifiers may be set to any unique value, this function * computes key identifiers from public key according to the two * recommended methods (4.2.1.2 RFC 3280). * Highly polymorphic: try to accept all possible forms of key: * - Key object * - \phpseclib3\File\X509 object with public or private key defined * - Certificate or CSR array * - \phpseclib3\File\ASN1\Element object * - PEM or DER string * * @param mixed $key optional * @param int $method optional * @return string binary key identifier */ public function computeKeyIdentifier($key = null, $method = 1) { if (is_null($key)) { $key = $this; } switch (true) { case is_string($key): break; case is_array($key) && isset($key['tbsCertificate']['subjectPublicKeyInfo']['subjectPublicKey']): return $this->computeKeyIdentifier($key['tbsCertificate']['subjectPublicKeyInfo']['subjectPublicKey'], $method); case is_array($key) && isset($key['certificationRequestInfo']['subjectPKInfo']['subjectPublicKey']): return $this->computeKeyIdentifier($key['certificationRequestInfo']['subjectPKInfo']['subjectPublicKey'], $method); case !is_object($key): return false; case $key instanceof Element: // Assume the element is a bitstring-packed key. $decoded = ASN1::decodeBER($key->element); if (!$decoded) { return false; } $raw = ASN1::asn1map($decoded[0], ['type' => ASN1::TYPE_BIT_STRING]); if (empty($raw)) { return false; } // If the key is private, compute identifier from its corresponding public key. $key = PublicKeyLoader::load($raw); if ($key instanceof PrivateKey) { // If private. return $this->computeKeyIdentifier($key, $method); } $key = $raw; // Is a public key. break; case $key instanceof X509: if (isset($key->publicKey)) { return $this->computeKeyIdentifier($key->publicKey, $method); } if (isset($key->privateKey)) { return $this->computeKeyIdentifier($key->privateKey, $method); } if (isset($key->currentCert['tbsCertificate']) || isset($key->currentCert['certificationRequestInfo'])) { return $this->computeKeyIdentifier($key->currentCert, $method); } return false; default: // Should be a key object (i.e.: \phpseclib3\Crypt\RSA). $key = $key->getPublicKey(); break; } // If in PEM format, convert to binary. $key = ASN1::extractBER($key); // Now we have the key string: compute its sha-1 sum. $hash = new Hash('sha1'); $hash = $hash->hash($key); if ($method == 2) { $hash = substr($hash, -8); $hash[0] = chr((ord($hash[0]) & 0x0F) | 0x40); } return $hash; } /** * Format a public key as appropriate * * @return array|false */ private function formatSubjectPublicKey() { $format = $this->publicKey instanceof RSA && ($this->publicKey->getPadding() & RSA::SIGNATURE_PSS) ? 'PSS' : 'PKCS8'; $publicKey = base64_decode(preg_replace('#-.+-|[\r\n]#', '', $this->publicKey->toString($format))); $decoded = ASN1::decodeBER($publicKey); if (!$decoded) { return false; } $mapped = ASN1::asn1map($decoded[0], Maps\SubjectPublicKeyInfo::MAP); if (!is_array($mapped)) { return false; } $mapped['subjectPublicKey'] = $this->publicKey->toString($format); return $mapped; } /** * Set the domain name's which the cert is to be valid for * * @param mixed ...$domains * @return void */ public function setDomain(...$domains) { $this->domains = $domains; $this->removeDNProp('id-at-commonName'); $this->setDNProp('id-at-commonName', $this->domains[0]); } /** * Set the IP Addresses's which the cert is to be valid for * * @param mixed[] ...$ipAddresses */ public function setIPAddress(...$ipAddresses) { $this->ipAddresses = $ipAddresses; /* if (!isset($this->domains)) { $this->removeDNProp('id-at-commonName'); $this->setDNProp('id-at-commonName', $this->ipAddresses[0]); } */ } /** * Helper function to build domain array * * @param string $domain * @return array */ private static function dnsName($domain) { return ['dNSName' => $domain]; } /** * Helper function to build IP Address array * * (IPv6 is not currently supported) * * @param string $address * @return array */ private function iPAddress($address) { return ['iPAddress' => $address]; } /** * Get the index of a revoked certificate. * * @param array $rclist * @param string $serial * @param bool $create optional * @return int|false */ private function revokedCertificate(array &$rclist, $serial, $create = false) { $serial = new BigInteger($serial); foreach ($rclist as $i => $rc) { if (!($serial->compare($rc['userCertificate']))) { return $i; } } if (!$create) { return false; } $i = count($rclist); $revocationDate = new \DateTimeImmutable('now', new \DateTimeZone(@date_default_timezone_get())); $rclist[] = ['userCertificate' => $serial, 'revocationDate' => $this->timeField($revocationDate->format('D, d M Y H:i:s O'))]; return $i; } /** * Revoke a certificate. * * @param string $serial * @param string $date optional * @return bool */ public function revoke($serial, $date = null) { if (isset($this->currentCert['tbsCertList'])) { if (is_array($rclist = &$this->subArray($this->currentCert, 'tbsCertList/revokedCertificates', true))) { if ($this->revokedCertificate($rclist, $serial) === false) { // If not yet revoked if (($i = $this->revokedCertificate($rclist, $serial, true)) !== false) { if (!empty($date)) { $rclist[$i]['revocationDate'] = $this->timeField($date); } return true; } } } } return false; } /** * Unrevoke a certificate. * * @param string $serial * @return bool */ public function unrevoke($serial) { if (is_array($rclist = &$this->subArray($this->currentCert, 'tbsCertList/revokedCertificates'))) { if (($i = $this->revokedCertificate($rclist, $serial)) !== false) { unset($rclist[$i]); $rclist = array_values($rclist); return true; } } return false; } /** * Get a revoked certificate. * * @param string $serial * @return mixed */ public function getRevoked($serial) { if (is_array($rclist = $this->subArray($this->currentCert, 'tbsCertList/revokedCertificates'))) { if (($i = $this->revokedCertificate($rclist, $serial)) !== false) { return $rclist[$i]; } } return false; } /** * List revoked certificates * * @param array $crl optional * @return array|bool */ public function listRevoked(array $crl = null) { if (!isset($crl)) { $crl = $this->currentCert; } if (!isset($crl['tbsCertList'])) { return false; } $result = []; if (is_array($rclist = $this->subArray($crl, 'tbsCertList/revokedCertificates'))) { foreach ($rclist as $rc) { $result[] = $rc['userCertificate']->toString(); } } return $result; } /** * Remove a Revoked Certificate Extension * * @param string $serial * @param string $id * @return bool */ public function removeRevokedCertificateExtension($serial, $id) { if (is_array($rclist = &$this->subArray($this->currentCert, 'tbsCertList/revokedCertificates'))) { if (($i = $this->revokedCertificate($rclist, $serial)) !== false) { return $this->removeExtensionHelper($id, "tbsCertList/revokedCertificates/$i/crlEntryExtensions"); } } return false; } /** * Get a Revoked Certificate Extension * * Returns the extension if it exists and false if not * * @param string $serial * @param string $id * @param array $crl optional * @return mixed */ public function getRevokedCertificateExtension($serial, $id, array $crl = null) { if (!isset($crl)) { $crl = $this->currentCert; } if (is_array($rclist = $this->subArray($crl, 'tbsCertList/revokedCertificates'))) { if (($i = $this->revokedCertificate($rclist, $serial)) !== false) { return $this->getExtension($id, $crl, "tbsCertList/revokedCertificates/$i/crlEntryExtensions"); } } return false; } /** * Returns a list of all extensions in use for a given revoked certificate * * @param string $serial * @param array $crl optional * @return array|bool */ public function getRevokedCertificateExtensions($serial, array $crl = null) { if (!isset($crl)) { $crl = $this->currentCert; } if (is_array($rclist = $this->subArray($crl, 'tbsCertList/revokedCertificates'))) { if (($i = $this->revokedCertificate($rclist, $serial)) !== false) { return $this->getExtensions($crl, "tbsCertList/revokedCertificates/$i/crlEntryExtensions"); } } return false; } /** * Set a Revoked Certificate Extension * * @param string $serial * @param string $id * @param mixed $value * @param bool $critical optional * @param bool $replace optional * @return bool */ public function setRevokedCertificateExtension($serial, $id, $value, $critical = false, $replace = true) { if (isset($this->currentCert['tbsCertList'])) { if (is_array($rclist = &$this->subArray($this->currentCert, 'tbsCertList/revokedCertificates', true))) { if (($i = $this->revokedCertificate($rclist, $serial, true)) !== false) { return $this->setExtensionHelper($id, $value, $critical, $replace, "tbsCertList/revokedCertificates/$i/crlEntryExtensions"); } } } return false; } /** * Register the mapping for a custom/unsupported extension. * * @param string $id * @param array $mapping */ public static function registerExtension($id, array $mapping) { if (isset(self::$extensions[$id]) && self::$extensions[$id] !== $mapping) { throw new \RuntimeException( 'Extension ' . $id . ' has already been defined with a different mapping.' ); } self::$extensions[$id] = $mapping; } /** * Register the mapping for a custom/unsupported extension. * * @param string $id * * @return array|null */ public static function getRegisteredExtension($id) { return isset(self::$extensions[$id]) ? self::$extensions[$id] : null; } /** * Register the mapping for a custom/unsupported extension. * * @param string $id * @param mixed $value * @param bool $critical * @param bool $replace */ public function setExtensionValue($id, $value, $critical = false, $replace = false) { $this->extensionValues[$id] = compact('critical', 'replace', 'value'); } } * @copyright 2012 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File; use DateTime; use phpseclib3\Common\Functions\Strings; use phpseclib3\File\ASN1\Element; use phpseclib3\Math\BigInteger; /** * Pure-PHP ASN.1 Parser * * @author Jim Wigginton */ abstract class ASN1 { // Tag Classes // http://www.itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf#page=12 const CLASS_UNIVERSAL = 0; const CLASS_APPLICATION = 1; const CLASS_CONTEXT_SPECIFIC = 2; const CLASS_PRIVATE = 3; // Tag Classes // http://www.obj-sys.com/asn1tutorial/node124.html const TYPE_BOOLEAN = 1; const TYPE_INTEGER = 2; const TYPE_BIT_STRING = 3; const TYPE_OCTET_STRING = 4; const TYPE_NULL = 5; const TYPE_OBJECT_IDENTIFIER = 6; //const TYPE_OBJECT_DESCRIPTOR = 7; //const TYPE_INSTANCE_OF = 8; // EXTERNAL const TYPE_REAL = 9; const TYPE_ENUMERATED = 10; //const TYPE_EMBEDDED = 11; const TYPE_UTF8_STRING = 12; //const TYPE_RELATIVE_OID = 13; const TYPE_SEQUENCE = 16; // SEQUENCE OF const TYPE_SET = 17; // SET OF // More Tag Classes // http://www.obj-sys.com/asn1tutorial/node10.html const TYPE_NUMERIC_STRING = 18; const TYPE_PRINTABLE_STRING = 19; const TYPE_TELETEX_STRING = 20; // T61String const TYPE_VIDEOTEX_STRING = 21; const TYPE_IA5_STRING = 22; const TYPE_UTC_TIME = 23; const TYPE_GENERALIZED_TIME = 24; const TYPE_GRAPHIC_STRING = 25; const TYPE_VISIBLE_STRING = 26; // ISO646String const TYPE_GENERAL_STRING = 27; const TYPE_UNIVERSAL_STRING = 28; //const TYPE_CHARACTER_STRING = 29; const TYPE_BMP_STRING = 30; // Tag Aliases // These tags are kinda place holders for other tags. const TYPE_CHOICE = -1; const TYPE_ANY = -2; /** * ASN.1 object identifiers * * @var array * @link http://en.wikipedia.org/wiki/Object_identifier */ private static $oids = []; /** * ASN.1 object identifier reverse mapping * * @var array */ private static $reverseOIDs = []; /** * Default date format * * @var string * @link http://php.net/class.datetime */ private static $format = 'D, d M Y H:i:s O'; /** * Filters * * If the mapping type is self::TYPE_ANY what do we actually encode it as? * * @var array * @see self::encode_der() */ private static $filters; /** * Current Location of most recent ASN.1 encode process * * Useful for debug purposes * * @var array * @see self::encode_der() */ private static $location; /** * DER Encoded String * * In case we need to create ASN1\Element object's.. * * @var string * @see self::decodeDER() */ private static $encoded; /** * Type mapping table for the ANY type. * * Structured or unknown types are mapped to a \phpseclib3\File\ASN1\Element. * Unambiguous types get the direct mapping (int/real/bool). * Others are mapped as a choice, with an extra indexing level. * * @var array */ const ANY_MAP = [ self::TYPE_BOOLEAN => true, self::TYPE_INTEGER => true, self::TYPE_BIT_STRING => 'bitString', self::TYPE_OCTET_STRING => 'octetString', self::TYPE_NULL => 'null', self::TYPE_OBJECT_IDENTIFIER => 'objectIdentifier', self::TYPE_REAL => true, self::TYPE_ENUMERATED => 'enumerated', self::TYPE_UTF8_STRING => 'utf8String', self::TYPE_NUMERIC_STRING => 'numericString', self::TYPE_PRINTABLE_STRING => 'printableString', self::TYPE_TELETEX_STRING => 'teletexString', self::TYPE_VIDEOTEX_STRING => 'videotexString', self::TYPE_IA5_STRING => 'ia5String', self::TYPE_UTC_TIME => 'utcTime', self::TYPE_GENERALIZED_TIME => 'generalTime', self::TYPE_GRAPHIC_STRING => 'graphicString', self::TYPE_VISIBLE_STRING => 'visibleString', self::TYPE_GENERAL_STRING => 'generalString', self::TYPE_UNIVERSAL_STRING => 'universalString', //self::TYPE_CHARACTER_STRING => 'characterString', self::TYPE_BMP_STRING => 'bmpString' ]; /** * String type to character size mapping table. * * Non-convertable types are absent from this table. * size == 0 indicates variable length encoding. * * @var array */ const STRING_TYPE_SIZE = [ self::TYPE_UTF8_STRING => 0, self::TYPE_BMP_STRING => 2, self::TYPE_UNIVERSAL_STRING => 4, self::TYPE_PRINTABLE_STRING => 1, self::TYPE_TELETEX_STRING => 1, self::TYPE_IA5_STRING => 1, self::TYPE_VISIBLE_STRING => 1, ]; /** * Parse BER-encoding * * Serves a similar purpose to openssl's asn1parse * * @param Element|string $encoded * @return ?array */ public static function decodeBER($encoded) { if ($encoded instanceof Element) { $encoded = $encoded->element; } self::$encoded = $encoded; $decoded = self::decode_ber($encoded); if ($decoded === false) { return null; } return [self::decode_ber($encoded)]; } /** * Parse BER-encoding (Helper function) * * Sometimes we want to get the BER encoding of a particular tag. $start lets us do that without having to reencode. * $encoded is passed by reference for the recursive calls done for self::TYPE_BIT_STRING and * self::TYPE_OCTET_STRING. In those cases, the indefinite length is used. * * @param string $encoded * @param int $start * @param int $encoded_pos * @return array|bool */ private static function decode_ber($encoded, $start = 0, $encoded_pos = 0) { $current = ['start' => $start]; if (!isset($encoded[$encoded_pos])) { return false; } $type = ord($encoded[$encoded_pos++]); $startOffset = 1; $constructed = ($type >> 5) & 1; $tag = $type & 0x1F; if ($tag == 0x1F) { $tag = 0; // process septets (since the eighth bit is ignored, it's not an octet) do { if (!isset($encoded[$encoded_pos])) { return false; } $temp = ord($encoded[$encoded_pos++]); $startOffset++; $loop = $temp >> 7; $tag <<= 7; $temp &= 0x7F; // "bits 7 to 1 of the first subsequent octet shall not all be zero" if ($startOffset == 2 && $temp == 0) { return false; } $tag |= $temp; } while ($loop); } $start += $startOffset; // Length, as discussed in paragraph 8.1.3 of X.690-0207.pdf#page=13 if (!isset($encoded[$encoded_pos])) { return false; } $length = ord($encoded[$encoded_pos++]); $start++; if ($length == 0x80) { // indefinite length // "[A sender shall] use the indefinite form (see 8.1.3.6) if the encoding is constructed and is not all // immediately available." -- paragraph 8.1.3.2.c $length = strlen($encoded) - $encoded_pos; } elseif ($length & 0x80) { // definite length, long form // technically, the long form of the length can be represented by up to 126 octets (bytes), but we'll only // support it up to four. $length &= 0x7F; $temp = substr($encoded, $encoded_pos, $length); $encoded_pos += $length; // tags of indefinte length don't really have a header length; this length includes the tag $current += ['headerlength' => $length + 2]; $start += $length; extract(unpack('Nlength', substr(str_pad($temp, 4, chr(0), STR_PAD_LEFT), -4))); /** @var integer $length */ } else { $current += ['headerlength' => 2]; } if ($length > (strlen($encoded) - $encoded_pos)) { return false; } $content = substr($encoded, $encoded_pos, $length); $content_pos = 0; // at this point $length can be overwritten. it's only accurate for definite length things as is /* Class is UNIVERSAL, APPLICATION, PRIVATE, or CONTEXT-SPECIFIC. The UNIVERSAL class is restricted to the ASN.1 built-in types. It defines an application-independent data type that must be distinguishable from all other data types. The other three classes are user defined. The APPLICATION class distinguishes data types that have a wide, scattered use within a particular presentation context. PRIVATE distinguishes data types within a particular organization or country. CONTEXT-SPECIFIC distinguishes members of a sequence or set, the alternatives of a CHOICE, or universally tagged set members. Only the class number appears in braces for this data type; the term CONTEXT-SPECIFIC does not appear. -- http://www.obj-sys.com/asn1tutorial/node12.html */ $class = ($type >> 6) & 3; switch ($class) { case self::CLASS_APPLICATION: case self::CLASS_PRIVATE: case self::CLASS_CONTEXT_SPECIFIC: if (!$constructed) { return [ 'type' => $class, 'constant' => $tag, 'content' => $content, 'length' => $length + $start - $current['start'] ] + $current; } $newcontent = []; $remainingLength = $length; while ($remainingLength > 0) { $temp = self::decode_ber($content, $start, $content_pos); if ($temp === false) { break; } $length = $temp['length']; // end-of-content octets - see paragraph 8.1.5 if (substr($content, $content_pos + $length, 2) == "\0\0") { $length += 2; $start += $length; $newcontent[] = $temp; break; } $start += $length; $remainingLength -= $length; $newcontent[] = $temp; $content_pos += $length; } return [ 'type' => $class, 'constant' => $tag, // the array encapsulation is for BC with the old format 'content' => $newcontent, // the only time when $content['headerlength'] isn't defined is when the length is indefinite. // the absence of $content['headerlength'] is how we know if something is indefinite or not. // technically, it could be defined to be 2 and then another indicator could be used but whatever. 'length' => $start - $current['start'] ] + $current; } $current += ['type' => $tag]; // decode UNIVERSAL tags switch ($tag) { case self::TYPE_BOOLEAN: // "The contents octets shall consist of a single octet." -- paragraph 8.2.1 if ($constructed || strlen($content) != 1) { return false; } $current['content'] = (bool) ord($content[$content_pos]); break; case self::TYPE_INTEGER: case self::TYPE_ENUMERATED: if ($constructed) { return false; } $current['content'] = new BigInteger(substr($content, $content_pos), -256); break; case self::TYPE_REAL: // not currently supported return false; case self::TYPE_BIT_STRING: // The initial octet shall encode, as an unsigned binary integer with bit 1 as the least significant bit, // the number of unused bits in the final subsequent octet. The number shall be in the range zero to // seven. if (!$constructed) { $current['content'] = substr($content, $content_pos); } else { $temp = self::decode_ber($content, $start, $content_pos); if ($temp === false) { return false; } $length -= (strlen($content) - $content_pos); $last = count($temp) - 1; for ($i = 0; $i < $last; $i++) { // all subtags should be bit strings if ($temp[$i]['type'] != self::TYPE_BIT_STRING) { return false; } $current['content'] .= substr($temp[$i]['content'], 1); } // all subtags should be bit strings if ($temp[$last]['type'] != self::TYPE_BIT_STRING) { return false; } $current['content'] = $temp[$last]['content'][0] . $current['content'] . substr($temp[$i]['content'], 1); } break; case self::TYPE_OCTET_STRING: if (!$constructed) { $current['content'] = substr($content, $content_pos); } else { $current['content'] = ''; $length = 0; while (substr($content, $content_pos, 2) != "\0\0") { $temp = self::decode_ber($content, $length + $start, $content_pos); if ($temp === false) { return false; } $content_pos += $temp['length']; // all subtags should be octet strings if ($temp['type'] != self::TYPE_OCTET_STRING) { return false; } $current['content'] .= $temp['content']; $length += $temp['length']; } if (substr($content, $content_pos, 2) == "\0\0") { $length += 2; // +2 for the EOC } } break; case self::TYPE_NULL: // "The contents octets shall not contain any octets." -- paragraph 8.8.2 if ($constructed || strlen($content)) { return false; } break; case self::TYPE_SEQUENCE: case self::TYPE_SET: if (!$constructed) { return false; } $offset = 0; $current['content'] = []; $content_len = strlen($content); while ($content_pos < $content_len) { // if indefinite length construction was used and we have an end-of-content string next // see paragraphs 8.1.1.3, 8.1.3.2, 8.1.3.6, 8.1.5, and (for an example) 8.6.4.2 if (!isset($current['headerlength']) && substr($content, $content_pos, 2) == "\0\0") { $length = $offset + 2; // +2 for the EOC break 2; } $temp = self::decode_ber($content, $start + $offset, $content_pos); if ($temp === false) { return false; } $content_pos += $temp['length']; $current['content'][] = $temp; $offset += $temp['length']; } break; case self::TYPE_OBJECT_IDENTIFIER: if ($constructed) { return false; } $current['content'] = self::decodeOID(substr($content, $content_pos)); if ($current['content'] === false) { return false; } break; /* Each character string type shall be encoded as if it had been declared: [UNIVERSAL x] IMPLICIT OCTET STRING -- X.690-0207.pdf#page=23 (paragraph 8.21.3) Per that, we're not going to do any validation. If there are any illegal characters in the string, we don't really care */ case self::TYPE_NUMERIC_STRING: // 0,1,2,3,4,5,6,7,8,9, and space case self::TYPE_PRINTABLE_STRING: // Upper and lower case letters, digits, space, apostrophe, left/right parenthesis, plus sign, comma, // hyphen, full stop, solidus, colon, equal sign, question mark case self::TYPE_TELETEX_STRING: // The Teletex character set in CCITT's T61, space, and delete // see http://en.wikipedia.org/wiki/Teletex#Character_sets case self::TYPE_VIDEOTEX_STRING: // The Videotex character set in CCITT's T.100 and T.101, space, and delete case self::TYPE_VISIBLE_STRING: // Printing character sets of international ASCII, and space case self::TYPE_IA5_STRING: // International Alphabet 5 (International ASCII) case self::TYPE_GRAPHIC_STRING: // All registered G sets, and space case self::TYPE_GENERAL_STRING: // All registered C and G sets, space and delete case self::TYPE_UTF8_STRING: // ???? case self::TYPE_BMP_STRING: if ($constructed) { return false; } $current['content'] = substr($content, $content_pos); break; case self::TYPE_UTC_TIME: case self::TYPE_GENERALIZED_TIME: if ($constructed) { return false; } $current['content'] = self::decodeTime(substr($content, $content_pos), $tag); break; default: return false; } $start += $length; // ie. length is the length of the full TLV encoding - it's not just the length of the value return $current + ['length' => $start - $current['start']]; } /** * ASN.1 Map * * Provides an ASN.1 semantic mapping ($mapping) from a parsed BER-encoding to a human readable format. * * "Special" mappings may be applied on a per tag-name basis via $special. * * @param array $decoded * @param array $mapping * @param array $special * @return array|bool|Element|string|null */ public static function asn1map(array $decoded, $mapping, $special = []) { if (isset($mapping['explicit']) && is_array($decoded['content'])) { $decoded = $decoded['content'][0]; } switch (true) { case $mapping['type'] == self::TYPE_ANY: $intype = $decoded['type']; // !isset(self::ANY_MAP[$intype]) produces a fatal error on PHP 5.6 if (isset($decoded['constant']) || !array_key_exists($intype, self::ANY_MAP) || (ord(self::$encoded[$decoded['start']]) & 0x20)) { return new Element(substr(self::$encoded, $decoded['start'], $decoded['length'])); } $inmap = self::ANY_MAP[$intype]; if (is_string($inmap)) { return [$inmap => self::asn1map($decoded, ['type' => $intype] + $mapping, $special)]; } break; case $mapping['type'] == self::TYPE_CHOICE: foreach ($mapping['children'] as $key => $option) { switch (true) { case isset($option['constant']) && $option['constant'] == $decoded['constant']: case !isset($option['constant']) && $option['type'] == $decoded['type']: $value = self::asn1map($decoded, $option, $special); break; case !isset($option['constant']) && $option['type'] == self::TYPE_CHOICE: $v = self::asn1map($decoded, $option, $special); if (isset($v)) { $value = $v; } } if (isset($value)) { if (isset($special[$key])) { $value = $special[$key]($value); } return [$key => $value]; } } return null; case isset($mapping['implicit']): case isset($mapping['explicit']): case $decoded['type'] == $mapping['type']: break; default: // if $decoded['type'] and $mapping['type'] are both strings, but different types of strings, // let it through switch (true) { case $decoded['type'] < 18: // self::TYPE_NUMERIC_STRING == 18 case $decoded['type'] > 30: // self::TYPE_BMP_STRING == 30 case $mapping['type'] < 18: case $mapping['type'] > 30: return null; } } if (isset($mapping['implicit'])) { $decoded['type'] = $mapping['type']; } switch ($decoded['type']) { case self::TYPE_SEQUENCE: $map = []; // ignore the min and max if (isset($mapping['min']) && isset($mapping['max'])) { $child = $mapping['children']; foreach ($decoded['content'] as $content) { if (($map[] = self::asn1map($content, $child, $special)) === null) { return null; } } return $map; } $n = count($decoded['content']); $i = 0; foreach ($mapping['children'] as $key => $child) { $maymatch = $i < $n; // Match only existing input. if ($maymatch) { $temp = $decoded['content'][$i]; if ($child['type'] != self::TYPE_CHOICE) { // Get the mapping and input class & constant. $childClass = $tempClass = self::CLASS_UNIVERSAL; $constant = null; if (isset($temp['constant'])) { $tempClass = $temp['type']; } if (isset($child['class'])) { $childClass = $child['class']; $constant = $child['cast']; } elseif (isset($child['constant'])) { $childClass = self::CLASS_CONTEXT_SPECIFIC; $constant = $child['constant']; } if (isset($constant) && isset($temp['constant'])) { // Can only match if constants and class match. $maymatch = $constant == $temp['constant'] && $childClass == $tempClass; } else { // Can only match if no constant expected and type matches or is generic. $maymatch = !isset($child['constant']) && array_search($child['type'], [$temp['type'], self::TYPE_ANY, self::TYPE_CHOICE]) !== false; } } } if ($maymatch) { // Attempt submapping. $candidate = self::asn1map($temp, $child, $special); $maymatch = $candidate !== null; } if ($maymatch) { // Got the match: use it. if (isset($special[$key])) { $candidate = $special[$key]($candidate); } $map[$key] = $candidate; $i++; } elseif (isset($child['default'])) { $map[$key] = $child['default']; } elseif (!isset($child['optional'])) { return null; // Syntax error. } } // Fail mapping if all input items have not been consumed. return $i < $n ? null : $map; // the main diff between sets and sequences is the encapsulation of the foreach in another for loop case self::TYPE_SET: $map = []; // ignore the min and max if (isset($mapping['min']) && isset($mapping['max'])) { $child = $mapping['children']; foreach ($decoded['content'] as $content) { if (($map[] = self::asn1map($content, $child, $special)) === null) { return null; } } return $map; } for ($i = 0; $i < count($decoded['content']); $i++) { $temp = $decoded['content'][$i]; $tempClass = self::CLASS_UNIVERSAL; if (isset($temp['constant'])) { $tempClass = $temp['type']; } foreach ($mapping['children'] as $key => $child) { if (isset($map[$key])) { continue; } $maymatch = true; if ($child['type'] != self::TYPE_CHOICE) { $childClass = self::CLASS_UNIVERSAL; $constant = null; if (isset($child['class'])) { $childClass = $child['class']; $constant = $child['cast']; } elseif (isset($child['constant'])) { $childClass = self::CLASS_CONTEXT_SPECIFIC; $constant = $child['constant']; } if (isset($constant) && isset($temp['constant'])) { // Can only match if constants and class match. $maymatch = $constant == $temp['constant'] && $childClass == $tempClass; } else { // Can only match if no constant expected and type matches or is generic. $maymatch = !isset($child['constant']) && array_search($child['type'], [$temp['type'], self::TYPE_ANY, self::TYPE_CHOICE]) !== false; } } if ($maymatch) { // Attempt submapping. $candidate = self::asn1map($temp, $child, $special); $maymatch = $candidate !== null; } if (!$maymatch) { break; } // Got the match: use it. if (isset($special[$key])) { $candidate = $special[$key]($candidate); } $map[$key] = $candidate; break; } } foreach ($mapping['children'] as $key => $child) { if (!isset($map[$key])) { if (isset($child['default'])) { $map[$key] = $child['default']; } elseif (!isset($child['optional'])) { return null; } } } return $map; case self::TYPE_OBJECT_IDENTIFIER: return isset(self::$oids[$decoded['content']]) ? self::$oids[$decoded['content']] : $decoded['content']; case self::TYPE_UTC_TIME: case self::TYPE_GENERALIZED_TIME: // for explicitly tagged optional stuff if (is_array($decoded['content'])) { $decoded['content'] = $decoded['content'][0]['content']; } // for implicitly tagged optional stuff // in theory, doing isset($mapping['implicit']) would work but malformed certs do exist // in the wild that OpenSSL decodes without issue so we'll support them as well if (!is_object($decoded['content'])) { $decoded['content'] = self::decodeTime($decoded['content'], $decoded['type']); } return $decoded['content'] ? $decoded['content']->format(self::$format) : false; case self::TYPE_BIT_STRING: if (isset($mapping['mapping'])) { $offset = ord($decoded['content'][0]); $size = (strlen($decoded['content']) - 1) * 8 - $offset; /* From X.680-0207.pdf#page=46 (21.7): "When a "NamedBitList" is used in defining a bitstring type ASN.1 encoding rules are free to add (or remove) arbitrarily any trailing 0 bits to (or from) values that are being encoded or decoded. Application designers should therefore ensure that different semantics are not associated with such values which differ only in the number of trailing 0 bits." */ $bits = count($mapping['mapping']) == $size ? [] : array_fill(0, count($mapping['mapping']) - $size, false); for ($i = strlen($decoded['content']) - 1; $i > 0; $i--) { $current = ord($decoded['content'][$i]); for ($j = $offset; $j < 8; $j++) { $bits[] = (bool) ($current & (1 << $j)); } $offset = 0; } $values = []; $map = array_reverse($mapping['mapping']); foreach ($map as $i => $value) { if ($bits[$i]) { $values[] = $value; } } return $values; } // fall-through case self::TYPE_OCTET_STRING: return $decoded['content']; case self::TYPE_NULL: return ''; case self::TYPE_BOOLEAN: case self::TYPE_NUMERIC_STRING: case self::TYPE_PRINTABLE_STRING: case self::TYPE_TELETEX_STRING: case self::TYPE_VIDEOTEX_STRING: case self::TYPE_IA5_STRING: case self::TYPE_GRAPHIC_STRING: case self::TYPE_VISIBLE_STRING: case self::TYPE_GENERAL_STRING: case self::TYPE_UNIVERSAL_STRING: case self::TYPE_UTF8_STRING: case self::TYPE_BMP_STRING: return $decoded['content']; case self::TYPE_INTEGER: case self::TYPE_ENUMERATED: $temp = $decoded['content']; if (isset($mapping['implicit'])) { $temp = new BigInteger($decoded['content'], -256); } if (isset($mapping['mapping'])) { $temp = (int) $temp->toString(); return isset($mapping['mapping'][$temp]) ? $mapping['mapping'][$temp] : false; } return $temp; } } /** * DER-decode the length * * DER supports lengths up to (2**8)**127, however, we'll only support lengths up to (2**8)**4. See * {@link http://itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf#p=13 X.690 paragraph 8.1.3} for more information. * * @param string $string * @return int */ public static function decodeLength(&$string) { $length = ord(Strings::shift($string)); if ($length & 0x80) { // definite length, long form $length &= 0x7F; $temp = Strings::shift($string, $length); list(, $length) = unpack('N', substr(str_pad($temp, 4, chr(0), STR_PAD_LEFT), -4)); } return $length; } /** * ASN.1 Encode * * DER-encodes an ASN.1 semantic mapping ($mapping). Some libraries would probably call this function * an ASN.1 compiler. * * "Special" mappings can be applied via $special. * * @param Element|string|array $source * @param array $mapping * @param array $special * @return string */ public static function encodeDER($source, $mapping, $special = []) { self::$location = []; return self::encode_der($source, $mapping, null, $special); } /** * ASN.1 Encode (Helper function) * * @param Element|string|array|null $source * @param array $mapping * @param int $idx * @param array $special * @return string */ private static function encode_der($source, array $mapping, $idx = null, array $special = []) { if ($source instanceof Element) { return $source->element; } // do not encode (implicitly optional) fields with value set to default if (isset($mapping['default']) && $source === $mapping['default']) { return ''; } if (isset($idx)) { if (isset($special[$idx])) { $source = $special[$idx]($source); } self::$location[] = $idx; } $tag = $mapping['type']; switch ($tag) { case self::TYPE_SET: // Children order is not important, thus process in sequence. case self::TYPE_SEQUENCE: $tag |= 0x20; // set the constructed bit // ignore the min and max if (isset($mapping['min']) && isset($mapping['max'])) { $value = []; $child = $mapping['children']; foreach ($source as $content) { $temp = self::encode_der($content, $child, null, $special); if ($temp === false) { return false; } $value[] = $temp; } /* "The encodings of the component values of a set-of value shall appear in ascending order, the encodings being compared as octet strings with the shorter components being padded at their trailing end with 0-octets. NOTE - The padding octets are for comparison purposes only and do not appear in the encodings." -- sec 11.6 of http://www.itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf */ if ($mapping['type'] == self::TYPE_SET) { sort($value); } $value = implode('', $value); break; } $value = ''; foreach ($mapping['children'] as $key => $child) { if (!array_key_exists($key, $source)) { if (!isset($child['optional'])) { return false; } continue; } $temp = self::encode_der($source[$key], $child, $key, $special); if ($temp === false) { return false; } // An empty child encoding means it has been optimized out. // Else we should have at least one tag byte. if ($temp === '') { continue; } // if isset($child['constant']) is true then isset($child['optional']) should be true as well if (isset($child['constant'])) { /* From X.680-0207.pdf#page=58 (30.6): "The tagging construction specifies explicit tagging if any of the following holds: ... c) the "Tag Type" alternative is used and the value of "TagDefault" for the module is IMPLICIT TAGS or AUTOMATIC TAGS, but the type defined by "Type" is an untagged choice type, an untagged open type, or an untagged "DummyReference" (see ITU-T Rec. X.683 | ISO/IEC 8824-4, 8.3)." */ if (isset($child['explicit']) || $child['type'] == self::TYPE_CHOICE) { $subtag = chr((self::CLASS_CONTEXT_SPECIFIC << 6) | 0x20 | $child['constant']); $temp = $subtag . self::encodeLength(strlen($temp)) . $temp; } else { $subtag = chr((self::CLASS_CONTEXT_SPECIFIC << 6) | (ord($temp[0]) & 0x20) | $child['constant']); $temp = $subtag . substr($temp, 1); } } $value .= $temp; } break; case self::TYPE_CHOICE: $temp = false; foreach ($mapping['children'] as $key => $child) { if (!isset($source[$key])) { continue; } $temp = self::encode_der($source[$key], $child, $key, $special); if ($temp === false) { return false; } // An empty child encoding means it has been optimized out. // Else we should have at least one tag byte. if ($temp === '') { continue; } $tag = ord($temp[0]); // if isset($child['constant']) is true then isset($child['optional']) should be true as well if (isset($child['constant'])) { if (isset($child['explicit']) || $child['type'] == self::TYPE_CHOICE) { $subtag = chr((self::CLASS_CONTEXT_SPECIFIC << 6) | 0x20 | $child['constant']); $temp = $subtag . self::encodeLength(strlen($temp)) . $temp; } else { $subtag = chr((self::CLASS_CONTEXT_SPECIFIC << 6) | (ord($temp[0]) & 0x20) | $child['constant']); $temp = $subtag . substr($temp, 1); } } } if (isset($idx)) { array_pop(self::$location); } if ($temp && isset($mapping['cast'])) { $temp[0] = chr(($mapping['class'] << 6) | ($tag & 0x20) | $mapping['cast']); } return $temp; case self::TYPE_INTEGER: case self::TYPE_ENUMERATED: if (!isset($mapping['mapping'])) { if (is_numeric($source)) { $source = new BigInteger($source); } $value = $source->toBytes(true); } else { $value = array_search($source, $mapping['mapping']); if ($value === false) { return false; } $value = new BigInteger($value); $value = $value->toBytes(true); } if (!strlen($value)) { $value = chr(0); } break; case self::TYPE_UTC_TIME: case self::TYPE_GENERALIZED_TIME: $format = $mapping['type'] == self::TYPE_UTC_TIME ? 'y' : 'Y'; $format .= 'mdHis'; // if $source does _not_ include timezone information within it then assume that the timezone is GMT $date = new \DateTime($source, new \DateTimeZone('GMT')); // if $source _does_ include timezone information within it then convert the time to GMT $date->setTimezone(new \DateTimeZone('GMT')); $value = $date->format($format) . 'Z'; break; case self::TYPE_BIT_STRING: if (isset($mapping['mapping'])) { $bits = array_fill(0, count($mapping['mapping']), 0); $size = 0; for ($i = 0; $i < count($mapping['mapping']); $i++) { if (in_array($mapping['mapping'][$i], $source)) { $bits[$i] = 1; $size = $i; } } if (isset($mapping['min']) && $mapping['min'] >= 1 && $size < $mapping['min']) { $size = $mapping['min'] - 1; } $offset = 8 - (($size + 1) & 7); $offset = $offset !== 8 ? $offset : 0; $value = chr($offset); for ($i = $size + 1; $i < count($mapping['mapping']); $i++) { unset($bits[$i]); } $bits = implode('', array_pad($bits, $size + $offset + 1, 0)); $bytes = explode(' ', rtrim(chunk_split($bits, 8, ' '))); foreach ($bytes as $byte) { $value .= chr(bindec($byte)); } break; } // fall-through case self::TYPE_OCTET_STRING: /* The initial octet shall encode, as an unsigned binary integer with bit 1 as the least significant bit, the number of unused bits in the final subsequent octet. The number shall be in the range zero to seven. -- http://www.itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf#page=16 */ $value = $source; break; case self::TYPE_OBJECT_IDENTIFIER: $value = self::encodeOID($source); break; case self::TYPE_ANY: $loc = self::$location; if (isset($idx)) { array_pop(self::$location); } switch (true) { case !isset($source): return self::encode_der(null, ['type' => self::TYPE_NULL] + $mapping, null, $special); case is_int($source): case $source instanceof BigInteger: return self::encode_der($source, ['type' => self::TYPE_INTEGER] + $mapping, null, $special); case is_float($source): return self::encode_der($source, ['type' => self::TYPE_REAL] + $mapping, null, $special); case is_bool($source): return self::encode_der($source, ['type' => self::TYPE_BOOLEAN] + $mapping, null, $special); case is_array($source) && count($source) == 1: $typename = implode('', array_keys($source)); $outtype = array_search($typename, self::ANY_MAP, true); if ($outtype !== false) { return self::encode_der($source[$typename], ['type' => $outtype] + $mapping, null, $special); } } $filters = self::$filters; foreach ($loc as $part) { if (!isset($filters[$part])) { $filters = false; break; } $filters = $filters[$part]; } if ($filters === false) { throw new \RuntimeException('No filters defined for ' . implode('/', $loc)); } return self::encode_der($source, $filters + $mapping, null, $special); case self::TYPE_NULL: $value = ''; break; case self::TYPE_NUMERIC_STRING: case self::TYPE_TELETEX_STRING: case self::TYPE_PRINTABLE_STRING: case self::TYPE_UNIVERSAL_STRING: case self::TYPE_UTF8_STRING: case self::TYPE_BMP_STRING: case self::TYPE_IA5_STRING: case self::TYPE_VISIBLE_STRING: case self::TYPE_VIDEOTEX_STRING: case self::TYPE_GRAPHIC_STRING: case self::TYPE_GENERAL_STRING: $value = $source; break; case self::TYPE_BOOLEAN: $value = $source ? "\xFF" : "\x00"; break; default: throw new \RuntimeException('Mapping provides no type definition for ' . implode('/', self::$location)); } if (isset($idx)) { array_pop(self::$location); } if (isset($mapping['cast'])) { if (isset($mapping['explicit']) || $mapping['type'] == self::TYPE_CHOICE) { $value = chr($tag) . self::encodeLength(strlen($value)) . $value; $tag = ($mapping['class'] << 6) | 0x20 | $mapping['cast']; } else { $tag = ($mapping['class'] << 6) | (ord($temp[0]) & 0x20) | $mapping['cast']; } } return chr($tag) . self::encodeLength(strlen($value)) . $value; } /** * BER-decode the OID * * Called by _decode_ber() * * @param string $content * @return string */ public static function decodeOID($content) { static $eighty; if (!$eighty) { $eighty = new BigInteger(80); } $oid = []; $pos = 0; $len = strlen($content); if (ord($content[$len - 1]) & 0x80) { return false; } $n = new BigInteger(); while ($pos < $len) { $temp = ord($content[$pos++]); $n = $n->bitwise_leftShift(7); $n = $n->bitwise_or(new BigInteger($temp & 0x7F)); if (~$temp & 0x80) { $oid[] = $n; $n = new BigInteger(); } } $part1 = array_shift($oid); $first = floor(ord($content[0]) / 40); /* "This packing of the first two object identifier components recognizes that only three values are allocated from the root node, and at most 39 subsequent values from nodes reached by X = 0 and X = 1." -- https://www.itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf#page=22 */ if ($first <= 2) { // ie. 0 <= ord($content[0]) < 120 (0x78) array_unshift($oid, ord($content[0]) % 40); array_unshift($oid, $first); } else { array_unshift($oid, $part1->subtract($eighty)); array_unshift($oid, 2); } return implode('.', $oid); } /** * DER-encode the OID * * Called by _encode_der() * * @param string $source * @return string */ public static function encodeOID($source) { static $mask, $zero, $forty; if (!$mask) { $mask = new BigInteger(0x7F); $zero = new BigInteger(); $forty = new BigInteger(40); } if (!preg_match('#(?:\d+\.)+#', $source)) { $oid = isset(self::$reverseOIDs[$source]) ? self::$reverseOIDs[$source] : false; } else { $oid = $source; } if ($oid === false) { throw new \RuntimeException('Invalid OID'); } $parts = explode('.', $oid); $part1 = array_shift($parts); $part2 = array_shift($parts); $first = new BigInteger($part1); $first = $first->multiply($forty); $first = $first->add(new BigInteger($part2)); array_unshift($parts, $first->toString()); $value = ''; foreach ($parts as $part) { if (!$part) { $temp = "\0"; } else { $temp = ''; $part = new BigInteger($part); while (!$part->equals($zero)) { $submask = $part->bitwise_and($mask); $submask->setPrecision(8); $temp = (chr(0x80) | $submask->toBytes()) . $temp; $part = $part->bitwise_rightShift(7); } $temp[strlen($temp) - 1] = $temp[strlen($temp) - 1] & chr(0x7F); } $value .= $temp; } return $value; } /** * BER-decode the time * * Called by _decode_ber() and in the case of implicit tags asn1map(). * * @param string $content * @param int $tag * @return \DateTime|false */ private static function decodeTime($content, $tag) { /* UTCTime: http://tools.ietf.org/html/rfc5280#section-4.1.2.5.1 http://www.obj-sys.com/asn1tutorial/node15.html GeneralizedTime: http://tools.ietf.org/html/rfc5280#section-4.1.2.5.2 http://www.obj-sys.com/asn1tutorial/node14.html */ $format = 'YmdHis'; if ($tag == self::TYPE_UTC_TIME) { // https://www.itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf#page=28 says "the seconds // element shall always be present" but none-the-less I've seen X509 certs where it isn't and if the // browsers parse it phpseclib ought to too if (preg_match('#^(\d{10})(Z|[+-]\d{4})$#', $content, $matches)) { $content = $matches[1] . '00' . $matches[2]; } $prefix = substr($content, 0, 2) >= 50 ? '19' : '20'; $content = $prefix . $content; } elseif (strpos($content, '.') !== false) { $format .= '.u'; } if ($content[strlen($content) - 1] == 'Z') { $content = substr($content, 0, -1) . '+0000'; } if (strpos($content, '-') !== false || strpos($content, '+') !== false) { $format .= 'O'; } // error supression isn't necessary as of PHP 7.0: // http://php.net/manual/en/migration70.other-changes.php return @\DateTime::createFromFormat($format, $content); } /** * Set the time format * * Sets the time / date format for asn1map(). * * @param string $format */ public static function setTimeFormat($format) { self::$format = $format; } /** * Load OIDs * * Load the relevant OIDs for a particular ASN.1 semantic mapping. * Previously loaded OIDs are retained. * * @param array $oids */ public static function loadOIDs(array $oids) { self::$reverseOIDs += $oids; self::$oids = array_flip(self::$reverseOIDs); } /** * Set filters * * See \phpseclib3\File\X509, etc, for an example. * Previously loaded filters are not retained. * * @param array $filters */ public static function setFilters(array $filters) { self::$filters = $filters; } /** * String type conversion * * This is a lazy conversion, dealing only with character size. * No real conversion table is used. * * @param string $in * @param int $from * @param int $to * @return string */ public static function convert($in, $from = self::TYPE_UTF8_STRING, $to = self::TYPE_UTF8_STRING) { // isset(self::STRING_TYPE_SIZE[$from] returns a fatal error on PHP 5.6 if (!array_key_exists($from, self::STRING_TYPE_SIZE) || !array_key_exists($to, self::STRING_TYPE_SIZE)) { return false; } $insize = self::STRING_TYPE_SIZE[$from]; $outsize = self::STRING_TYPE_SIZE[$to]; $inlength = strlen($in); $out = ''; for ($i = 0; $i < $inlength;) { if ($inlength - $i < $insize) { return false; } // Get an input character as a 32-bit value. $c = ord($in[$i++]); switch (true) { case $insize == 4: $c = ($c << 8) | ord($in[$i++]); $c = ($c << 8) | ord($in[$i++]); // fall-through case $insize == 2: $c = ($c << 8) | ord($in[$i++]); // fall-through case $insize == 1: break; case ($c & 0x80) == 0x00: break; case ($c & 0x40) == 0x00: return false; default: $bit = 6; do { if ($bit > 25 || $i >= $inlength || (ord($in[$i]) & 0xC0) != 0x80) { return false; } $c = ($c << 6) | (ord($in[$i++]) & 0x3F); $bit += 5; $mask = 1 << $bit; } while ($c & $bit); $c &= $mask - 1; break; } // Convert and append the character to output string. $v = ''; switch (true) { case $outsize == 4: $v .= chr($c & 0xFF); $c >>= 8; $v .= chr($c & 0xFF); $c >>= 8; // fall-through case $outsize == 2: $v .= chr($c & 0xFF); $c >>= 8; // fall-through case $outsize == 1: $v .= chr($c & 0xFF); $c >>= 8; if ($c) { return false; } break; case ($c & 0x80000000) != 0: return false; case $c >= 0x04000000: $v .= chr(0x80 | ($c & 0x3F)); $c = ($c >> 6) | 0x04000000; // fall-through case $c >= 0x00200000: $v .= chr(0x80 | ($c & 0x3F)); $c = ($c >> 6) | 0x00200000; // fall-through case $c >= 0x00010000: $v .= chr(0x80 | ($c & 0x3F)); $c = ($c >> 6) | 0x00010000; // fall-through case $c >= 0x00000800: $v .= chr(0x80 | ($c & 0x3F)); $c = ($c >> 6) | 0x00000800; // fall-through case $c >= 0x00000080: $v .= chr(0x80 | ($c & 0x3F)); $c = ($c >> 6) | 0x000000C0; // fall-through default: $v .= chr($c); break; } $out .= strrev($v); } return $out; } /** * Extract raw BER from Base64 encoding * * @param string $str * @return string */ public static function extractBER($str) { /* X.509 certs are assumed to be base64 encoded but sometimes they'll have additional things in them * above and beyond the ceritificate. * ie. some may have the following preceding the -----BEGIN CERTIFICATE----- line: * * Bag Attributes * localKeyID: 01 00 00 00 * subject=/O=organization/OU=org unit/CN=common name * issuer=/O=organization/CN=common name */ if (strlen($str) > ini_get('pcre.backtrack_limit')) { $temp = $str; } else { $temp = preg_replace('#.*?^-+[^-]+-+[\r\n ]*$#ms', '', $str, 1); $temp = preg_replace('#-+END.*[\r\n ]*.*#ms', '', $temp, 1); } // remove new lines $temp = str_replace(["\r", "\n", ' '], '', $temp); // remove the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE----- stuff $temp = preg_replace('#^-+[^-]+-+|-+[^-]+-+$#', '', $temp); $temp = preg_match('#^[a-zA-Z\d/+]*={0,2}$#', $temp) ? Strings::base64_decode($temp) : false; return $temp != false ? $temp : $str; } /** * DER-encode the length * * DER supports lengths up to (2**8)**127, however, we'll only support lengths up to (2**8)**4. See * {@link http://itu.int/ITU-T/studygroups/com17/languages/X.690-0207.pdf#p=13 X.690 paragraph 8.1.3} for more information. * * @param int $length * @return string */ public static function encodeLength($length) { if ($length <= 0x7F) { return chr($length); } $temp = ltrim(pack('N', $length), chr(0)); return pack('Ca*', 0x80 | strlen($temp), $temp); } /** * Returns the OID corresponding to a name * * What's returned in the associative array returned by loadX509() (or load*()) is either a name or an OID if * no OID to name mapping is available. The problem with this is that what may be an unmapped OID in one version * of phpseclib may not be unmapped in the next version, so apps that are looking at this OID may not be able * to work from version to version. * * This method will return the OID if a name is passed to it and if no mapping is avialable it'll assume that * what's being passed to it already is an OID and return that instead. A few examples. * * getOID('2.16.840.1.101.3.4.2.1') == '2.16.840.1.101.3.4.2.1' * getOID('id-sha256') == '2.16.840.1.101.3.4.2.1' * getOID('zzz') == 'zzz' * * @param string $name * @return string */ public static function getOID($name) { return isset(self::$reverseOIDs[$name]) ? self::$reverseOIDs[$name] : $name; } } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PrivateKeyUsagePeriod * * @author Jim Wigginton */ abstract class PrivateKeyUsagePeriod { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'notBefore' => [ 'constant' => 0, 'optional' => true, 'implicit' => true, 'type' => ASN1::TYPE_GENERALIZED_TIME], 'notAfter' => [ 'constant' => 1, 'optional' => true, 'implicit' => true, 'type' => ASN1::TYPE_GENERALIZED_TIME] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * ECPrivateKey * * @author Jim Wigginton */ abstract class ECPrivateKey { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'version' => [ 'type' => ASN1::TYPE_INTEGER, 'mapping' => [1 => 'ecPrivkeyVer1'] ], 'privateKey' => ['type' => ASN1::TYPE_OCTET_STRING], 'parameters' => [ 'constant' => 0, 'optional' => true, 'explicit' => true ] + ECParameters::MAP, 'publicKey' => [ 'type' => ASN1::TYPE_BIT_STRING, 'constant' => 1, 'optional' => true, 'explicit' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * TBSCertList * * @author Jim Wigginton */ abstract class TBSCertList { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'version' => [ 'type' => ASN1::TYPE_INTEGER, 'mapping' => ['v1', 'v2', 'v3'], 'optional' => true, 'default' => 'v2' ], 'signature' => AlgorithmIdentifier::MAP, 'issuer' => Name::MAP, 'thisUpdate' => Time::MAP, 'nextUpdate' => [ 'optional' => true ] + Time::MAP, 'revokedCertificates' => [ 'type' => ASN1::TYPE_SEQUENCE, 'optional' => true, 'min' => 0, 'max' => -1, 'children' => RevokedCertificate::MAP ], 'crlExtensions' => [ 'constant' => 0, 'optional' => true, 'explicit' => true ] + Extensions::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * ECPoint * * @author Jim Wigginton */ abstract class ECPoint { const MAP = ['type' => ASN1::TYPE_OCTET_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PolicyMappings * * @author Jim Wigginton */ abstract class PolicyMappings { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => -1, 'children' => [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'issuerDomainPolicy' => CertPolicyId::MAP, 'subjectDomainPolicy' => CertPolicyId::MAP ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PersonalName * * @author Jim Wigginton */ abstract class PersonalName { const MAP = [ 'type' => ASN1::TYPE_SET, 'children' => [ 'surname' => [ 'type' => ASN1::TYPE_PRINTABLE_STRING, 'constant' => 0, 'optional' => true, 'implicit' => true ], 'given-name' => [ 'type' => ASN1::TYPE_PRINTABLE_STRING, 'constant' => 1, 'optional' => true, 'implicit' => true ], 'initials' => [ 'type' => ASN1::TYPE_PRINTABLE_STRING, 'constant' => 2, 'optional' => true, 'implicit' => true ], 'generation-qualifier' => [ 'type' => ASN1::TYPE_PRINTABLE_STRING, 'constant' => 3, 'optional' => true, 'implicit' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * ExtensionAttributes * * @author Jim Wigginton */ abstract class ExtensionAttributes { const MAP = [ 'type' => ASN1::TYPE_SET, 'min' => 1, 'max' => 256, // ub-extension-attributes 'children' => ExtensionAttribute::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * OtherPrimeInfo * * @author Jim Wigginton */ abstract class OtherPrimeInfo { // version must be multi if otherPrimeInfos present const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'prime' => ['type' => ASN1::TYPE_INTEGER], // ri 'exponent' => ['type' => ASN1::TYPE_INTEGER], // di 'coefficient' => ['type' => ASN1::TYPE_INTEGER] // ti ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * GeneralName * * @author Jim Wigginton */ abstract class GeneralName { const MAP = [ 'type' => ASN1::TYPE_CHOICE, 'children' => [ 'otherName' => [ 'constant' => 0, 'optional' => true, 'implicit' => true ] + AnotherName::MAP, 'rfc822Name' => [ 'type' => ASN1::TYPE_IA5_STRING, 'constant' => 1, 'optional' => true, 'implicit' => true ], 'dNSName' => [ 'type' => ASN1::TYPE_IA5_STRING, 'constant' => 2, 'optional' => true, 'implicit' => true ], 'x400Address' => [ 'constant' => 3, 'optional' => true, 'implicit' => true ] + ORAddress::MAP, 'directoryName' => [ 'constant' => 4, 'optional' => true, 'explicit' => true ] + Name::MAP, 'ediPartyName' => [ 'constant' => 5, 'optional' => true, 'implicit' => true ] + EDIPartyName::MAP, 'uniformResourceIdentifier' => [ 'type' => ASN1::TYPE_IA5_STRING, 'constant' => 6, 'optional' => true, 'implicit' => true ], 'iPAddress' => [ 'type' => ASN1::TYPE_OCTET_STRING, 'constant' => 7, 'optional' => true, 'implicit' => true ], 'registeredID' => [ 'type' => ASN1::TYPE_OBJECT_IDENTIFIER, 'constant' => 8, 'optional' => true, 'implicit' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * CPSuri * * @author Jim Wigginton */ abstract class CPSuri { const MAP = ['type' => ASN1::TYPE_IA5_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * FieldElement * * @author Jim Wigginton */ abstract class FieldElement { const MAP = ['type' => ASN1::TYPE_OCTET_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Certificate * * @author Jim Wigginton */ abstract class Certificate { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'tbsCertificate' => TBSCertificate::MAP, 'signatureAlgorithm' => AlgorithmIdentifier::MAP, 'signature' => ['type' => ASN1::TYPE_BIT_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * OrganizationalUnitNames * * @author Jim Wigginton */ abstract class OrganizationalUnitNames { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => 4, // ub-organizational-units 'children' => ['type' => ASN1::TYPE_PRINTABLE_STRING] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * UserNotice * * @author Jim Wigginton */ abstract class UserNotice { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'noticeRef' => [ 'optional' => true, 'implicit' => true ] + NoticeReference::MAP, 'explicitText' => [ 'optional' => true, 'implicit' => true ] + DisplayText::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * BuiltInDomainDefinedAttribute * * @author Jim Wigginton */ abstract class BuiltInDomainDefinedAttribute { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'type' => ['type' => ASN1::TYPE_PRINTABLE_STRING], 'value' => ['type' => ASN1::TYPE_PRINTABLE_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * SpecifiedECDomain * * @author Jim Wigginton */ abstract class SpecifiedECDomain { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'version' => [ 'type' => ASN1::TYPE_INTEGER, 'mapping' => [1 => 'ecdpVer1', 'ecdpVer2', 'ecdpVer3'] ], 'fieldID' => FieldID::MAP, 'curve' => Curve::MAP, 'base' => ECPoint::MAP, 'order' => ['type' => ASN1::TYPE_INTEGER], 'cofactor' => [ 'type' => ASN1::TYPE_INTEGER, 'optional' => true ], 'hash' => ['optional' => true] + HashAlgorithm::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * ECParameters * * ECParameters ::= CHOICE { * namedCurve OBJECT IDENTIFIER * -- implicitCurve NULL * -- specifiedCurve SpecifiedECDomain * } * -- implicitCurve and specifiedCurve MUST NOT be used in PKIX. * -- Details for SpecifiedECDomain can be found in [X9.62]. * -- Any future additions to this CHOICE should be coordinated * -- with ANSI X9. * * @author Jim Wigginton */ abstract class ECParameters { const MAP = [ 'type' => ASN1::TYPE_CHOICE, 'children' => [ 'namedCurve' => ['type' => ASN1::TYPE_OBJECT_IDENTIFIER], 'implicitCurve' => ['type' => ASN1::TYPE_NULL], 'specifiedCurve' => SpecifiedECDomain::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * DSAPublicKey * * @author Jim Wigginton */ abstract class DSAPublicKey { const MAP = ['type' => ASN1::TYPE_INTEGER]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * HoldInstructionCode * * @author Jim Wigginton */ abstract class HoldInstructionCode { const MAP = ['type' => ASN1::TYPE_OBJECT_IDENTIFIER]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * BuiltInStandardAttributes * * @author Jim Wigginton */ abstract class BuiltInStandardAttributes { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'country-name' => ['optional' => true] + CountryName::MAP, 'administration-domain-name' => ['optional' => true] + AdministrationDomainName::MAP, 'network-address' => [ 'constant' => 0, 'optional' => true, 'implicit' => true ] + NetworkAddress::MAP, 'terminal-identifier' => [ 'constant' => 1, 'optional' => true, 'implicit' => true ] + TerminalIdentifier::MAP, 'private-domain-name' => [ 'constant' => 2, 'optional' => true, 'explicit' => true ] + PrivateDomainName::MAP, 'organization-name' => [ 'constant' => 3, 'optional' => true, 'implicit' => true ] + OrganizationName::MAP, 'numeric-user-identifier' => [ 'constant' => 4, 'optional' => true, 'implicit' => true ] + NumericUserIdentifier::MAP, 'personal-name' => [ 'constant' => 5, 'optional' => true, 'implicit' => true ] + PersonalName::MAP, 'organizational-unit-names' => [ 'constant' => 6, 'optional' => true, 'implicit' => true ] + OrganizationalUnitNames::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * EncryptedPrivateKeyInfo * * @author Jim Wigginton */ abstract class EncryptedPrivateKeyInfo { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'encryptionAlgorithm' => AlgorithmIdentifier::MAP, 'encryptedData' => EncryptedData::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * DistributionPointName * * @author Jim Wigginton */ abstract class DistributionPointName { const MAP = [ 'type' => ASN1::TYPE_CHOICE, 'children' => [ 'fullName' => [ 'constant' => 0, 'optional' => true, 'implicit' => true ] + GeneralNames::MAP, 'nameRelativeToCRLIssuer' => [ 'constant' => 1, 'optional' => true, 'implicit' => true ] + RelativeDistinguishedName::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * RSASSA_PSS_params * * @author Jim Wigginton */ abstract class RSASSA_PSS_params { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'hashAlgorithm' => [ 'constant' => 0, 'optional' => true, 'explicit' => true, //'default' => 'sha1Identifier' ] + HashAlgorithm::MAP, 'maskGenAlgorithm' => [ 'constant' => 1, 'optional' => true, 'explicit' => true, //'default' => 'mgf1SHA1Identifier' ] + MaskGenAlgorithm::MAP, 'saltLength' => [ 'type' => ASN1::TYPE_INTEGER, 'constant' => 2, 'optional' => true, 'explicit' => true, 'default' => 20 ], 'trailerField' => [ 'type' => ASN1::TYPE_INTEGER, 'constant' => 3, 'optional' => true, 'explicit' => true, 'default' => 1 ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; /** * HashAglorithm * * @author Jim Wigginton */ abstract class HashAlgorithm { const MAP = AlgorithmIdentifier::MAP; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * IssuingDistributionPoint * * @author Jim Wigginton */ abstract class IssuingDistributionPoint { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'distributionPoint' => [ 'constant' => 0, 'optional' => true, 'explicit' => true ] + DistributionPointName::MAP, 'onlyContainsUserCerts' => [ 'type' => ASN1::TYPE_BOOLEAN, 'constant' => 1, 'optional' => true, 'default' => false, 'implicit' => true ], 'onlyContainsCACerts' => [ 'type' => ASN1::TYPE_BOOLEAN, 'constant' => 2, 'optional' => true, 'default' => false, 'implicit' => true ], 'onlySomeReasons' => [ 'constant' => 3, 'optional' => true, 'implicit' => true ] + ReasonFlags::MAP, 'indirectCRL' => [ 'type' => ASN1::TYPE_BOOLEAN, 'constant' => 4, 'optional' => true, 'default' => false, 'implicit' => true ], 'onlyContainsAttributeCerts' => [ 'type' => ASN1::TYPE_BOOLEAN, 'constant' => 5, 'optional' => true, 'default' => false, 'implicit' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PBMAC1params * * from https://tools.ietf.org/html/rfc2898#appendix-A.3 * * @author Jim Wigginton */ abstract class PBMAC1params { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'keyDerivationFunc' => AlgorithmIdentifier::MAP, 'messageAuthScheme' => AlgorithmIdentifier::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * SubjectInfoAccessSyntax * * @author Jim Wigginton */ abstract class SubjectInfoAccessSyntax { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => -1, 'children' => AccessDescription::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * NetworkAddress * * @author Jim Wigginton */ abstract class NetworkAddress { const MAP = ['type' => ASN1::TYPE_NUMERIC_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * DSAPrivateKey * * @author Jim Wigginton */ abstract class DSAPrivateKey { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'version' => ['type' => ASN1::TYPE_INTEGER], 'p' => ['type' => ASN1::TYPE_INTEGER], 'q' => ['type' => ASN1::TYPE_INTEGER], 'g' => ['type' => ASN1::TYPE_INTEGER], 'y' => ['type' => ASN1::TYPE_INTEGER], 'x' => ['type' => ASN1::TYPE_INTEGER] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * GeneralSubtrees * * @author Jim Wigginton */ abstract class GeneralSubtrees { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => -1, 'children' => GeneralSubtree::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * GeneralSubtree * * @author Jim Wigginton */ abstract class GeneralSubtree { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'base' => GeneralName::MAP, 'minimum' => [ 'constant' => 0, 'optional' => true, 'implicit' => true, 'default' => '0' ] + BaseDistance::MAP, 'maximum' => [ 'constant' => 1, 'optional' => true, 'implicit' => true, ] + BaseDistance::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Attribute * * @author Jim Wigginton */ abstract class Attribute { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'type' => AttributeType::MAP, 'value' => [ 'type' => ASN1::TYPE_SET, 'min' => 1, 'max' => -1, 'children' => AttributeValue::MAP ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * NameConstraints * * @author Jim Wigginton */ abstract class NameConstraints { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'permittedSubtrees' => [ 'constant' => 0, 'optional' => true, 'implicit' => true ] + GeneralSubtrees::MAP, 'excludedSubtrees' => [ 'constant' => 1, 'optional' => true, 'implicit' => true ] + GeneralSubtrees::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * EncryptedData * * @author Jim Wigginton */ abstract class EncryptedData { const MAP = ['type' => ASN1::TYPE_OCTET_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PublicKeyAndChallenge * * @author Jim Wigginton */ abstract class PublicKeyAndChallenge { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'spki' => SubjectPublicKeyInfo::MAP, 'challenge' => ['type' => ASN1::TYPE_IA5_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * netscape_cert_type * * mapping is from * * @author Jim Wigginton */ abstract class netscape_cert_type { const MAP = [ 'type' => ASN1::TYPE_BIT_STRING, 'mapping' => [ 'SSLClient', 'SSLServer', 'Email', 'ObjectSigning', 'Reserved', 'SSLCA', 'EmailCA', 'ObjectSigningCA' ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * OneAsymmetricKey * * @author Jim Wigginton */ abstract class OneAsymmetricKey { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'version' => [ 'type' => ASN1::TYPE_INTEGER, 'mapping' => ['v1', 'v2'] ], 'privateKeyAlgorithm' => AlgorithmIdentifier::MAP, 'privateKey' => PrivateKey::MAP, 'attributes' => [ 'constant' => 0, 'optional' => true, 'implicit' => true ] + Attributes::MAP, 'publicKey' => [ 'constant' => 1, 'optional' => true, 'implicit' => true ] + PublicKey::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * RelativeDistinguishedName * * In practice, RDNs containing multiple name-value pairs (called "multivalued RDNs") are rare, * but they can be useful at times when either there is no unique attribute in the entry or you * want to ensure that the entry's DN contains some useful identifying information. * * - https://www.opends.org/wiki/page/DefinitionRelativeDistinguishedName * * @author Jim Wigginton */ abstract class RelativeDistinguishedName { const MAP = [ 'type' => ASN1::TYPE_SET, 'min' => 1, 'max' => -1, 'children' => AttributeTypeAndValue::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PrivateKeyInfo * * @author Jim Wigginton */ abstract class PrivateKeyInfo { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'version' => [ 'type' => ASN1::TYPE_INTEGER, 'mapping' => ['v1'] ], 'privateKeyAlgorithm' => AlgorithmIdentifier::MAP, 'privateKey' => PrivateKey::MAP, 'attributes' => [ 'constant' => 0, 'optional' => true, 'implicit' => true ] + Attributes::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Validity * * @author Jim Wigginton */ abstract class Validity { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'notBefore' => Time::MAP, 'notAfter' => Time::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PBES2params * * from https://tools.ietf.org/html/rfc2898#appendix-A.3 * * @author Jim Wigginton */ abstract class PBES2params { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'keyDerivationFunc' => AlgorithmIdentifier::MAP, 'encryptionScheme' => AlgorithmIdentifier::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * BuiltInDomainDefinedAttributes * * @author Jim Wigginton */ abstract class BuiltInDomainDefinedAttributes { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => 4, // ub-domain-defined-attributes 'children' => BuiltInDomainDefinedAttribute::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * RSAPrivateKey * * @author Jim Wigginton */ abstract class RSAPrivateKey { // version must be multi if otherPrimeInfos present const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'version' => [ 'type' => ASN1::TYPE_INTEGER, 'mapping' => ['two-prime', 'multi'] ], 'modulus' => ['type' => ASN1::TYPE_INTEGER], // n 'publicExponent' => ['type' => ASN1::TYPE_INTEGER], // e 'privateExponent' => ['type' => ASN1::TYPE_INTEGER], // d 'prime1' => ['type' => ASN1::TYPE_INTEGER], // p 'prime2' => ['type' => ASN1::TYPE_INTEGER], // q 'exponent1' => ['type' => ASN1::TYPE_INTEGER], // d mod (p-1) 'exponent2' => ['type' => ASN1::TYPE_INTEGER], // d mod (q-1) 'coefficient' => ['type' => ASN1::TYPE_INTEGER], // (inverse of q) mod p 'otherPrimeInfos' => OtherPrimeInfos::MAP + ['optional' => true] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * GeneralNames * * @author Jim Wigginton */ abstract class GeneralNames { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => -1, 'children' => GeneralName::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * OtherPrimeInfos * * @author Jim Wigginton */ abstract class OtherPrimeInfos { // version must be multi if otherPrimeInfos present const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => -1, 'children' => OtherPrimeInfo::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * AdministrationDomainName * * @author Jim Wigginton */ abstract class AdministrationDomainName { const MAP = [ 'type' => ASN1::TYPE_CHOICE, // if class isn't present it's assumed to be \phpseclib3\File\ASN1::CLASS_UNIVERSAL or // (if constant is present) \phpseclib3\File\ASN1::CLASS_CONTEXT_SPECIFIC 'class' => ASN1::CLASS_APPLICATION, 'cast' => 2, 'children' => [ 'numeric' => ['type' => ASN1::TYPE_NUMERIC_STRING], 'printable' => ['type' => ASN1::TYPE_PRINTABLE_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Characteristic_two * * @author Jim Wigginton */ abstract class Characteristic_two { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'm' => ['type' => ASN1::TYPE_INTEGER], // field size 2**m 'basis' => ['type' => ASN1::TYPE_OBJECT_IDENTIFIER], 'parameters' => [ 'type' => ASN1::TYPE_ANY, 'optional' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PolicyQualifierId * * @author Jim Wigginton */ abstract class PolicyQualifierId { const MAP = ['type' => ASN1::TYPE_OBJECT_IDENTIFIER]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; /** * CertificateIssuer * * @author Jim Wigginton */ abstract class CertificateIssuer { const MAP = GeneralNames::MAP; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PostalAddress * * @author Jim Wigginton */ abstract class PostalAddress { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'optional' => true, 'min' => 1, 'max' => -1, 'children' => DirectoryString::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * DirectoryString * * @author Jim Wigginton */ abstract class DirectoryString { const MAP = [ 'type' => ASN1::TYPE_CHOICE, 'children' => [ 'teletexString' => ['type' => ASN1::TYPE_TELETEX_STRING], 'printableString' => ['type' => ASN1::TYPE_PRINTABLE_STRING], 'universalString' => ['type' => ASN1::TYPE_UNIVERSAL_STRING], 'utf8String' => ['type' => ASN1::TYPE_UTF8_STRING], 'bmpString' => ['type' => ASN1::TYPE_BMP_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * KeyPurposeId * * @author Jim Wigginton */ abstract class KeyPurposeId { const MAP = ['type' => ASN1::TYPE_OBJECT_IDENTIFIER]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; /** * MaskGenAglorithm * * @author Jim Wigginton */ abstract class MaskGenAlgorithm { const MAP = AlgorithmIdentifier::MAP; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * SignedPublicKeyAndChallenge * * @author Jim Wigginton */ abstract class SignedPublicKeyAndChallenge { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'publicKeyAndChallenge' => PublicKeyAndChallenge::MAP, 'signatureAlgorithm' => AlgorithmIdentifier::MAP, 'signature' => ['type' => ASN1::TYPE_BIT_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * ExtKeyUsageSyntax * * @author Jim Wigginton */ abstract class ExtKeyUsageSyntax { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => -1, 'children' => KeyPurposeId::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * netscape_ca_policy_url * * @author Jim Wigginton */ abstract class netscape_ca_policy_url { const MAP = ['type' => ASN1::TYPE_IA5_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * SubjectDirectoryAttributes * * @author Jim Wigginton */ abstract class SubjectDirectoryAttributes { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => -1, 'children' => Attribute::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * CertificationRequest * * @author Jim Wigginton */ abstract class CertificationRequest { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'certificationRequestInfo' => CertificationRequestInfo::MAP, 'signatureAlgorithm' => AlgorithmIdentifier::MAP, 'signature' => ['type' => ASN1::TYPE_BIT_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * DssSigValue * * @author Jim Wigginton */ abstract class DssSigValue { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'r' => ['type' => ASN1::TYPE_INTEGER], 's' => ['type' => ASN1::TYPE_INTEGER] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * BasicConstraints * * @author Jim Wigginton */ abstract class BasicConstraints { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'cA' => [ 'type' => ASN1::TYPE_BOOLEAN, 'optional' => true, 'default' => false ], 'pathLenConstraint' => [ 'type' => ASN1::TYPE_INTEGER, 'optional' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PrivateDomainName * * @author Jim Wigginton */ abstract class PrivateDomainName { const MAP = [ 'type' => ASN1::TYPE_CHOICE, 'children' => [ 'numeric' => ['type' => ASN1::TYPE_NUMERIC_STRING], 'printable' => ['type' => ASN1::TYPE_PRINTABLE_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PublicKeyInfo * * this format is not formally defined anywhere but is none-the-less the form you * get when you do "openssl rsa -in private.pem -outform PEM -pubout" * * @author Jim Wigginton */ abstract class PublicKeyInfo { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'publicKeyAlgorithm' => AlgorithmIdentifier::MAP, 'publicKey' => ['type' => ASN1::TYPE_BIT_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Trinomial * * @author Jim Wigginton */ abstract class Trinomial { const MAP = ['type' => ASN1::TYPE_INTEGER]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * AuthorityKeyIdentifier * * @author Jim Wigginton */ abstract class AuthorityKeyIdentifier { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'keyIdentifier' => [ 'constant' => 0, 'optional' => true, 'implicit' => true ] + KeyIdentifier::MAP, 'authorityCertIssuer' => [ 'constant' => 1, 'optional' => true, 'implicit' => true ] + GeneralNames::MAP, 'authorityCertSerialNumber' => [ 'constant' => 2, 'optional' => true, 'implicit' => true ] + CertificateSerialNumber::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * AlgorithmIdentifier * * @author Jim Wigginton */ abstract class AlgorithmIdentifier { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'algorithm' => ['type' => ASN1::TYPE_OBJECT_IDENTIFIER], 'parameters' => [ 'type' => ASN1::TYPE_ANY, 'optional' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * EDIPartyName * * @author Jim Wigginton */ abstract class EDIPartyName { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'nameAssigner' => [ 'constant' => 0, 'optional' => true, 'implicit' => true ] + DirectoryString::MAP, // partyName is technically required but \phpseclib3\File\ASN1 doesn't currently support non-optional constants and // setting it to optional gets the job done in any event. 'partyName' => [ 'constant' => 1, 'optional' => true, 'implicit' => true ] + DirectoryString::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * CRLNumber * * @author Jim Wigginton */ abstract class CRLNumber { const MAP = ['type' => ASN1::TYPE_INTEGER]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * CertificatePolicies * * @author Jim Wigginton */ abstract class CertificatePolicies { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => -1, 'children' => PolicyInformation::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * NoticeReference * * @author Jim Wigginton */ abstract class NoticeReference { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'organization' => DisplayText::MAP, 'noticeNumbers' => [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => 200, 'children' => ['type' => ASN1::TYPE_INTEGER] ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * ExtensionAttribute * * @author Jim Wigginton */ abstract class ExtensionAttribute { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'extension-attribute-type' => [ 'type' => ASN1::TYPE_PRINTABLE_STRING, 'constant' => 0, 'optional' => true, 'implicit' => true ], 'extension-attribute-value' => [ 'type' => ASN1::TYPE_ANY, 'constant' => 1, 'optional' => true, 'explicit' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * AttributeValue * * @author Jim Wigginton */ abstract class AttributeValue { const MAP = ['type' => ASN1::TYPE_ANY]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Pentanomial * * @author Jim Wigginton */ abstract class Pentanomial { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'k1' => ['type' => ASN1::TYPE_INTEGER], // k1 > 0 'k2' => ['type' => ASN1::TYPE_INTEGER], // k2 > k1 'k3' => ['type' => ASN1::TYPE_INTEGER], // k3 > h2 ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * RevokedCertificate * * @author Jim Wigginton */ abstract class RevokedCertificate { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'userCertificate' => CertificateSerialNumber::MAP, 'revocationDate' => Time::MAP, 'crlEntryExtensions' => [ 'optional' => true ] + Extensions::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * BaseDistance * * @author Jim Wigginton */ abstract class BaseDistance { const MAP = ['type' => ASN1::TYPE_INTEGER]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PKCS9String * * @author Jim Wigginton */ abstract class PKCS9String { const MAP = [ 'type' => ASN1::TYPE_CHOICE, 'children' => [ 'ia5String' => ['type' => ASN1::TYPE_IA5_STRING], 'directoryString' => DirectoryString::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * FieldID * * @author Jim Wigginton */ abstract class FieldID { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'fieldType' => ['type' => ASN1::TYPE_OBJECT_IDENTIFIER], 'parameters' => [ 'type' => ASN1::TYPE_ANY, 'optional' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * TBSCertificate * * @author Jim Wigginton */ abstract class TBSCertificate { // assert($TBSCertificate['children']['signature'] == $Certificate['children']['signatureAlgorithm']) const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ // technically, default implies optional, but we'll define it as being optional, none-the-less, just to // reenforce that fact 'version' => [ 'type' => ASN1::TYPE_INTEGER, 'constant' => 0, 'optional' => true, 'explicit' => true, 'mapping' => ['v1', 'v2', 'v3'], 'default' => 'v1' ], 'serialNumber' => CertificateSerialNumber::MAP, 'signature' => AlgorithmIdentifier::MAP, 'issuer' => Name::MAP, 'validity' => Validity::MAP, 'subject' => Name::MAP, 'subjectPublicKeyInfo' => SubjectPublicKeyInfo::MAP, // implicit means that the T in the TLV structure is to be rewritten, regardless of the type 'issuerUniqueID' => [ 'constant' => 1, 'optional' => true, 'implicit' => true ] + UniqueIdentifier::MAP, 'subjectUniqueID' => [ 'constant' => 2, 'optional' => true, 'implicit' => true ] + UniqueIdentifier::MAP, // doesn't use the EXPLICIT keyword but if // it's not IMPLICIT, it's EXPLICIT 'extensions' => [ 'constant' => 3, 'optional' => true, 'explicit' => true ] + Extensions::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * DistributionPoint * * @author Jim Wigginton */ abstract class DistributionPoint { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'distributionPoint' => [ 'constant' => 0, 'optional' => true, 'explicit' => true ] + DistributionPointName::MAP, 'reasons' => [ 'constant' => 1, 'optional' => true, 'implicit' => true ] + ReasonFlags::MAP, 'cRLIssuer' => [ 'constant' => 2, 'optional' => true, 'implicit' => true ] + GeneralNames::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PBKDF2params * * from https://tools.ietf.org/html/rfc2898#appendix-A.3 * * @author Jim Wigginton */ abstract class PBKDF2params { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ // technically, this is a CHOICE in RFC2898 but the other "choice" is, currently, more of a placeholder // in the RFC 'salt' => ['type' => ASN1::TYPE_OCTET_STRING], 'iterationCount' => ['type' => ASN1::TYPE_INTEGER], 'keyLength' => [ 'type' => ASN1::TYPE_INTEGER, 'optional' => true ], 'prf' => AlgorithmIdentifier::MAP + ['optional' => true] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; /** * IssuerAltName * * @author Jim Wigginton */ abstract class IssuerAltName { const MAP = GeneralNames::MAP; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * CertificationRequestInfo * * @author Jim Wigginton */ abstract class CertificationRequestInfo { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'version' => [ 'type' => ASN1::TYPE_INTEGER, 'mapping' => ['v1'] ], 'subject' => Name::MAP, 'subjectPKInfo' => SubjectPublicKeyInfo::MAP, 'attributes' => [ 'constant' => 0, 'optional' => true, 'implicit' => true ] + Attributes::MAP, ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * DigestInfo * * from https://tools.ietf.org/html/rfc2898#appendix-A.3 * * @author Jim Wigginton */ abstract class DigestInfo { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'digestAlgorithm' => AlgorithmIdentifier::MAP, 'digest' => ['type' => ASN1::TYPE_OCTET_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PBEParameter * * from https://tools.ietf.org/html/rfc2898#appendix-A.3 * * @author Jim Wigginton */ abstract class PBEParameter { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'salt' => ['type' => ASN1::TYPE_OCTET_STRING], 'iterationCount' => ['type' => ASN1::TYPE_INTEGER] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PrivateKey * * @author Jim Wigginton */ abstract class PrivateKey { const MAP = ['type' => ASN1::TYPE_OCTET_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * AttributeTypeAndValue * * @author Jim Wigginton */ abstract class AttributeTypeAndValue { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'type' => AttributeType::MAP, 'value' => AttributeValue::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; /** * SubjectAltName * * @author Jim Wigginton */ abstract class SubjectAltName { const MAP = GeneralNames::MAP; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * DSAParams * * @author Jim Wigginton */ abstract class DSAParams { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'p' => ['type' => ASN1::TYPE_INTEGER], 'q' => ['type' => ASN1::TYPE_INTEGER], 'g' => ['type' => ASN1::TYPE_INTEGER] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * CRLReason * * @author Jim Wigginton */ abstract class CRLReason { const MAP = [ 'type' => ASN1::TYPE_ENUMERATED, 'mapping' => [ 'unspecified', 'keyCompromise', 'cACompromise', 'affiliationChanged', 'superseded', 'cessationOfOperation', 'certificateHold', // Value 7 is not used. 8 => 'removeFromCRL', 'privilegeWithdrawn', 'aACompromise' ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * CountryName * * @author Jim Wigginton */ abstract class CountryName { const MAP = [ 'type' => ASN1::TYPE_CHOICE, // if class isn't present it's assumed to be \phpseclib3\File\ASN1::CLASS_UNIVERSAL or // (if constant is present) \phpseclib3\File\ASN1::CLASS_CONTEXT_SPECIFIC 'class' => ASN1::CLASS_APPLICATION, 'cast' => 1, 'children' => [ 'x121-dcc-code' => ['type' => ASN1::TYPE_NUMERIC_STRING], 'iso-3166-alpha2-code' => ['type' => ASN1::TYPE_PRINTABLE_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * DisplayText * * @author Jim Wigginton */ abstract class DisplayText { const MAP = [ 'type' => ASN1::TYPE_CHOICE, 'children' => [ 'ia5String' => ['type' => ASN1::TYPE_IA5_STRING], 'visibleString' => ['type' => ASN1::TYPE_VISIBLE_STRING], 'bmpString' => ['type' => ASN1::TYPE_BMP_STRING], 'utf8String' => ['type' => ASN1::TYPE_UTF8_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * CertificateList * * @author Jim Wigginton */ abstract class CertificateList { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'tbsCertList' => TBSCertList::MAP, 'signatureAlgorithm' => AlgorithmIdentifier::MAP, 'signature' => ['type' => ASN1::TYPE_BIT_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Name * * @author Jim Wigginton */ abstract class Name { const MAP = [ 'type' => ASN1::TYPE_CHOICE, 'children' => [ 'rdnSequence' => RDNSequence::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * RC2CBCParameter * * from https://tools.ietf.org/html/rfc2898#appendix-A.3 * * @author Jim Wigginton */ abstract class RC2CBCParameter { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'rc2ParametersVersion' => [ 'type' => ASN1::TYPE_INTEGER, 'optional' => true ], 'iv' => ['type' => ASN1::TYPE_OCTET_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * DHParameter * * @author Jim Wigginton */ abstract class DHParameter { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'prime' => ['type' => ASN1::TYPE_INTEGER], 'base' => ['type' => ASN1::TYPE_INTEGER], 'privateValueLength' => [ 'type' => ASN1::TYPE_INTEGER, 'optional' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * AnotherName * * @author Jim Wigginton */ abstract class AnotherName { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'type-id' => ['type' => ASN1::TYPE_OBJECT_IDENTIFIER], 'value' => [ 'type' => ASN1::TYPE_ANY, 'constant' => 0, 'optional' => true, 'explicit' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * ORAddress * * @author Jim Wigginton */ abstract class ORAddress { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'built-in-standard-attributes' => BuiltInStandardAttributes::MAP, 'built-in-domain-defined-attributes' => ['optional' => true] + BuiltInDomainDefinedAttributes::MAP, 'extension-attributes' => ['optional' => true] + ExtensionAttributes::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * CRLDistributionPoints * * @author Jim Wigginton */ abstract class CRLDistributionPoints { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => -1, 'children' => DistributionPoint::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * UniqueIdentifier * * @author Jim Wigginton */ abstract class UniqueIdentifier { const MAP = ['type' => ASN1::TYPE_BIT_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Extension * * A certificate using system MUST reject the certificate if it encounters * a critical extension it does not recognize; however, a non-critical * extension may be ignored if it is not recognized. * * http://tools.ietf.org/html/rfc5280#section-4.2 * * @author Jim Wigginton */ abstract class Extension { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'extnId' => ['type' => ASN1::TYPE_OBJECT_IDENTIFIER], 'critical' => [ 'type' => ASN1::TYPE_BOOLEAN, 'optional' => true, 'default' => false ], 'extnValue' => ['type' => ASN1::TYPE_OCTET_STRING] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * AttributeType * * @author Jim Wigginton */ abstract class AttributeType { const MAP = ['type' => ASN1::TYPE_OBJECT_IDENTIFIER]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * NumericUserIdentifier * * @author Jim Wigginton */ abstract class NumericUserIdentifier { const MAP = ['type' => ASN1::TYPE_NUMERIC_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Curve * * @author Jim Wigginton */ abstract class Curve { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'a' => FieldElement::MAP, 'b' => FieldElement::MAP, 'seed' => [ 'type' => ASN1::TYPE_BIT_STRING, 'optional' => true ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PolicyInformation * * @author Jim Wigginton */ abstract class PolicyInformation { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'policyIdentifier' => CertPolicyId::MAP, 'policyQualifiers' => [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 0, 'max' => -1, 'optional' => true, 'children' => PolicyQualifierInfo::MAP ] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * KeyUsage * * @author Jim Wigginton */ abstract class KeyUsage { const MAP = [ 'type' => ASN1::TYPE_BIT_STRING, 'mapping' => [ 'digitalSignature', 'nonRepudiation', 'keyEncipherment', 'dataEncipherment', 'keyAgreement', 'keyCertSign', 'cRLSign', 'encipherOnly', 'decipherOnly' ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * CertPolicyId * * @author Jim Wigginton */ abstract class CertPolicyId { const MAP = ['type' => ASN1::TYPE_OBJECT_IDENTIFIER]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * EcdsaSigValue * * @author Jim Wigginton */ abstract class EcdsaSigValue { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'r' => ['type' => ASN1::TYPE_INTEGER], 's' => ['type' => ASN1::TYPE_INTEGER] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PolicyQualifierInfo * * @author Jim Wigginton */ abstract class PolicyQualifierInfo { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'policyQualifierId' => PolicyQualifierId::MAP, 'qualifier' => ['type' => ASN1::TYPE_ANY] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * ReasonFlags * * @author Jim Wigginton */ abstract class ReasonFlags { const MAP = [ 'type' => ASN1::TYPE_BIT_STRING, 'mapping' => [ 'unused', 'keyCompromise', 'cACompromise', 'affiliationChanged', 'superseded', 'cessationOfOperation', 'certificateHold', 'privilegeWithdrawn', 'aACompromise' ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Time * * @author Jim Wigginton */ abstract class Time { const MAP = [ 'type' => ASN1::TYPE_CHOICE, 'children' => [ 'utcTime' => ['type' => ASN1::TYPE_UTC_TIME], 'generalTime' => ['type' => ASN1::TYPE_GENERALIZED_TIME] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * netscape_comment * * @author Jim Wigginton */ abstract class netscape_comment { const MAP = ['type' => ASN1::TYPE_IA5_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * RSAPublicKey * * @author Jim Wigginton */ abstract class RSAPublicKey { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'modulus' => ['type' => ASN1::TYPE_INTEGER], 'publicExponent' => ['type' => ASN1::TYPE_INTEGER] ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Extensions * * @author Jim Wigginton */ abstract class Extensions { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, // technically, it's MAX, but we'll assume anything < 0 is MAX 'max' => -1, // if 'children' isn't an array then 'min' and 'max' must be defined 'children' => Extension::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * AccessDescription * * @author Jim Wigginton */ abstract class AccessDescription { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'accessMethod' => ['type' => ASN1::TYPE_OBJECT_IDENTIFIER], 'accessLocation' => GeneralName::MAP ] ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * InvalidityDate * * @author Jim Wigginton */ abstract class InvalidityDate { const MAP = ['type' => ASN1::TYPE_GENERALIZED_TIME]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * TerminalIdentifier * * @author Jim Wigginton */ abstract class TerminalIdentifier { const MAP = ['type' => ASN1::TYPE_PRINTABLE_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * OrganizationName * * @author Jim Wigginton */ abstract class OrganizationName { const MAP = ['type' => ASN1::TYPE_PRINTABLE_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * KeyIdentifier * * @author Jim Wigginton */ abstract class KeyIdentifier { const MAP = ['type' => ASN1::TYPE_OCTET_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * PublicKey * * @author Jim Wigginton */ abstract class PublicKey { const MAP = ['type' => ASN1::TYPE_BIT_STRING]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * CertificateSerialNumber * * @author Jim Wigginton */ abstract class CertificateSerialNumber { const MAP = ['type' => ASN1::TYPE_INTEGER]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * AuthorityInfoAccessSyntax * * @author Jim Wigginton */ abstract class AuthorityInfoAccessSyntax { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'min' => 1, 'max' => -1, 'children' => AccessDescription::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * RDNSequence * * In practice, RDNs containing multiple name-value pairs (called "multivalued RDNs") are rare, * but they can be useful at times when either there is no unique attribute in the entry or you * want to ensure that the entry's DN contains some useful identifying information. * * - https://www.opends.org/wiki/page/DefinitionRelativeDistinguishedName * * @author Jim Wigginton */ abstract class RDNSequence { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, // RDNSequence does not define a min or a max, which means it doesn't have one 'min' => 0, 'max' => -1, 'children' => RelativeDistinguishedName::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Prime_p * * @author Jim Wigginton */ abstract class Prime_p { const MAP = ['type' => ASN1::TYPE_INTEGER]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * Attributes * * @author Jim Wigginton */ abstract class Attributes { const MAP = [ 'type' => ASN1::TYPE_SET, 'min' => 1, 'max' => -1, 'children' => Attribute::MAP ]; } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1\Maps; use phpseclib3\File\ASN1; /** * SubjectPublicKeyInfo * * @author Jim Wigginton */ abstract class SubjectPublicKeyInfo { const MAP = [ 'type' => ASN1::TYPE_SEQUENCE, 'children' => [ 'algorithm' => AlgorithmIdentifier::MAP, 'subjectPublicKey' => ['type' => ASN1::TYPE_BIT_STRING] ] ]; } * @copyright 2012 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\File\ASN1; /** * ASN.1 Raw Element * * An ASN.1 ANY mapping will return an ASN1\Element object. Use of this object * will also bypass the normal encoding rules in ASN1::encodeDER() * * @author Jim Wigginton */ class Element { /** * Raw element value * * @var string */ public $element; /** * Constructor * * @param string $encoded * @return \phpseclib3\File\ASN1\Element */ public function __construct($encoded) { $this->element = $encoded; } } * setKey('abcdefghijklmnop'); * * $size = 10 * 1024; * $plaintext = ''; * for ($i = 0; $i < $size; $i++) { * $plaintext.= 'a'; * } * * echo $aes->decrypt($aes->encrypt($plaintext)); * ?> * * * @author Jim Wigginton * @copyright 2008 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; /** * Pure-PHP implementation of AES. * * @author Jim Wigginton */ class AES extends Rijndael { /** * Dummy function * * Since \phpseclib3\Crypt\AES extends \phpseclib3\Crypt\Rijndael, this function is, technically, available, but it doesn't do anything. * * @see \phpseclib3\Crypt\Rijndael::setBlockLength() * @param int $length * @throws \BadMethodCallException anytime it's called */ public function setBlockLength($length) { throw new \BadMethodCallException('The block length cannot be set for AES.'); } /** * Sets the key length * * Valid key lengths are 128, 192, and 256. Set the link to bool(false) to disable a fixed key length * * @see \phpseclib3\Crypt\Rijndael:setKeyLength() * @param int $length * @throws \LengthException if the key length isn't supported */ public function setKeyLength($length) { switch ($length) { case 128: case 192: case 256: break; default: throw new \LengthException('Key of size ' . $length . ' not supported by this algorithm. Only keys of sizes 128, 192 or 256 supported'); } parent::setKeyLength($length); } /** * Sets the key. * * Rijndael supports five different key lengths, AES only supports three. * * @see \phpseclib3\Crypt\Rijndael:setKey() * @see setKeyLength() * @param string $key * @throws \LengthException if the key length isn't supported */ public function setKey($key) { switch (strlen($key)) { case 16: case 24: case 32: break; default: throw new \LengthException('Key of size ' . strlen($key) . ' not supported by this algorithm. Only keys of sizes 16, 24 or 32 supported'); } parent::setKey($key); } } * @copyright 2019 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\StreamCipher; use phpseclib3\Exception\BadDecryptionException; use phpseclib3\Exception\InsufficientSetupException; /** * Pure-PHP implementation of Salsa20. * * @author Jim Wigginton */ class Salsa20 extends StreamCipher { /** * Part 1 of the state * * @var string|false */ protected $p1 = false; /** * Part 2 of the state * * @var string|false */ protected $p2 = false; /** * Key Length (in bytes) * * @var int */ protected $key_length = 32; // = 256 bits /** * @see \phpseclib3\Crypt\Salsa20::crypt() */ const ENCRYPT = 0; /** * @see \phpseclib3\Crypt\Salsa20::crypt() */ const DECRYPT = 1; /** * Encryption buffer for continuous mode * * @var array */ protected $enbuffer; /** * Decryption buffer for continuous mode * * @var array */ protected $debuffer; /** * Counter * * @var int */ protected $counter = 0; /** * Using Generated Poly1305 Key * * @var boolean */ protected $usingGeneratedPoly1305Key = false; /** * Salsa20 uses a nonce * * @return bool */ public function usesNonce() { return true; } /** * Sets the key. * * @param string $key * @throws \LengthException if the key length isn't supported */ public function setKey($key) { switch (strlen($key)) { case 16: case 32: break; default: throw new \LengthException('Key of size ' . strlen($key) . ' not supported by this algorithm. Only keys of sizes 16 or 32 are supported'); } parent::setKey($key); } /** * Sets the nonce. * * @param string $nonce */ public function setNonce($nonce) { if (strlen($nonce) != 8) { throw new \LengthException('Nonce of size ' . strlen($key) . ' not supported by this algorithm. Only an 64-bit nonce is supported'); } $this->nonce = $nonce; $this->changed = true; $this->setEngine(); } /** * Sets the counter. * * @param int $counter */ public function setCounter($counter) { $this->counter = $counter; $this->setEngine(); } /** * Creates a Poly1305 key using the method discussed in RFC8439 * * See https://tools.ietf.org/html/rfc8439#section-2.6.1 */ protected function createPoly1305Key() { if ($this->nonce === false) { throw new InsufficientSetupException('No nonce has been defined'); } if ($this->key === false) { throw new InsufficientSetupException('No key has been defined'); } $c = clone $this; $c->setCounter(0); $c->usePoly1305 = false; $block = $c->encrypt(str_repeat("\0", 256)); $this->setPoly1305Key(substr($block, 0, 32)); if ($this->counter == 0) { $this->counter++; } } /** * Setup the self::ENGINE_INTERNAL $engine * * (re)init, if necessary, the internal cipher $engine * * _setup() will be called each time if $changed === true * typically this happens when using one or more of following public methods: * * - setKey() * * - setNonce() * * - First run of encrypt() / decrypt() with no init-settings * * @see self::setKey() * @see self::setNonce() * @see self::disableContinuousBuffer() */ protected function setup() { if (!$this->changed) { return; } $this->enbuffer = $this->debuffer = ['ciphertext' => '', 'counter' => $this->counter]; $this->changed = $this->nonIVChanged = false; if ($this->nonce === false) { throw new InsufficientSetupException('No nonce has been defined'); } if ($this->key === false) { throw new InsufficientSetupException('No key has been defined'); } if ($this->usePoly1305 && !isset($this->poly1305Key)) { $this->usingGeneratedPoly1305Key = true; $this->createPoly1305Key(); } $key = $this->key; if (strlen($key) == 16) { $constant = 'expand 16-byte k'; $key .= $key; } else { $constant = 'expand 32-byte k'; } $this->p1 = substr($constant, 0, 4) . substr($key, 0, 16) . substr($constant, 4, 4) . $this->nonce . "\0\0\0\0"; $this->p2 = substr($constant, 8, 4) . substr($key, 16, 16) . substr($constant, 12, 4); } /** * Setup the key (expansion) */ protected function setupKey() { // Salsa20 does not utilize this method } /** * Encrypts a message. * * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() * @see self::crypt() * @param string $plaintext * @return string $ciphertext */ public function encrypt($plaintext) { $ciphertext = $this->crypt($plaintext, self::ENCRYPT); if (isset($this->poly1305Key)) { $this->newtag = $this->poly1305($ciphertext); } return $ciphertext; } /** * Decrypts a message. * * $this->decrypt($this->encrypt($plaintext)) == $this->encrypt($this->encrypt($plaintext)). * At least if the continuous buffer is disabled. * * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see self::crypt() * @param string $ciphertext * @return string $plaintext */ public function decrypt($ciphertext) { if (isset($this->poly1305Key)) { if ($this->oldtag === false) { throw new InsufficientSetupException('Authentication Tag has not been set'); } $newtag = $this->poly1305($ciphertext); if ($this->oldtag != substr($newtag, 0, strlen($this->oldtag))) { $this->oldtag = false; throw new BadDecryptionException('Derived authentication tag and supplied authentication tag do not match'); } $this->oldtag = false; } return $this->crypt($ciphertext, self::DECRYPT); } /** * Encrypts a block * * @param string $in */ protected function encryptBlock($in) { // Salsa20 does not utilize this method } /** * Decrypts a block * * @param string $in */ protected function decryptBlock($in) { // Salsa20 does not utilize this method } /** * Encrypts or decrypts a message. * * @see self::encrypt() * @see self::decrypt() * @param string $text * @param int $mode * @return string $text */ private function crypt($text, $mode) { $this->setup(); if (!$this->continuousBuffer) { if ($this->engine == self::ENGINE_OPENSSL) { $iv = pack('V', $this->counter) . $this->p2; return openssl_encrypt( $text, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA, $iv ); } $i = $this->counter; $blocks = str_split($text, 64); foreach ($blocks as &$block) { $block ^= static::salsa20($this->p1 . pack('V', $i++) . $this->p2); } return implode('', $blocks); } if ($mode == self::ENCRYPT) { $buffer = &$this->enbuffer; } else { $buffer = &$this->debuffer; } if (!strlen($buffer['ciphertext'])) { $ciphertext = ''; } else { $ciphertext = $text ^ Strings::shift($buffer['ciphertext'], strlen($text)); $text = substr($text, strlen($ciphertext)); if (!strlen($text)) { return $ciphertext; } } $overflow = strlen($text) % 64; // & 0x3F if ($overflow) { $text2 = Strings::pop($text, $overflow); if ($this->engine == self::ENGINE_OPENSSL) { $iv = pack('V', $buffer['counter']) . $this->p2; // at this point $text should be a multiple of 64 $buffer['counter'] += (strlen($text) >> 6) + 1; // ie. divide by 64 $encrypted = openssl_encrypt( $text . str_repeat("\0", 64), $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA, $iv ); $temp = Strings::pop($encrypted, 64); } else { $blocks = str_split($text, 64); if (strlen($text)) { foreach ($blocks as &$block) { $block ^= static::salsa20($this->p1 . pack('V', $buffer['counter']++) . $this->p2); } } $encrypted = implode('', $blocks); $temp = static::salsa20($this->p1 . pack('V', $buffer['counter']++) . $this->p2); } $ciphertext .= $encrypted . ($text2 ^ $temp); $buffer['ciphertext'] = substr($temp, $overflow); } elseif (!strlen($buffer['ciphertext'])) { if ($this->engine == self::ENGINE_OPENSSL) { $iv = pack('V', $buffer['counter']) . $this->p2; $buffer['counter'] += (strlen($text) >> 6); $ciphertext .= openssl_encrypt( $text, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA, $iv ); } else { $blocks = str_split($text, 64); foreach ($blocks as &$block) { $block ^= static::salsa20($this->p1 . pack('V', $buffer['counter']++) . $this->p2); } $ciphertext .= implode('', $blocks); } } return $ciphertext; } /** * Left Rotate * * @param int $x * @param int $n * @return int */ protected static function leftRotate($x, $n) { if (PHP_INT_SIZE == 8) { $r1 = $x << $n; $r1 &= 0xFFFFFFFF; $r2 = ($x & 0xFFFFFFFF) >> (32 - $n); } else { $x = (int) $x; $r1 = $x << $n; $r2 = $x >> (32 - $n); $r2 &= (1 << $n) - 1; } return $r1 | $r2; } /** * The quarterround function * * @param int $a * @param int $b * @param int $c * @param int $d */ protected static function quarterRound(&$a, &$b, &$c, &$d) { $b ^= self::leftRotate($a + $d, 7); $c ^= self::leftRotate($b + $a, 9); $d ^= self::leftRotate($c + $b, 13); $a ^= self::leftRotate($d + $c, 18); } /** * The doubleround function * * @param int $x0 (by reference) * @param int $x1 (by reference) * @param int $x2 (by reference) * @param int $x3 (by reference) * @param int $x4 (by reference) * @param int $x5 (by reference) * @param int $x6 (by reference) * @param int $x7 (by reference) * @param int $x8 (by reference) * @param int $x9 (by reference) * @param int $x10 (by reference) * @param int $x11 (by reference) * @param int $x12 (by reference) * @param int $x13 (by reference) * @param int $x14 (by reference) * @param int $x15 (by reference) */ protected static function doubleRound(&$x0, &$x1, &$x2, &$x3, &$x4, &$x5, &$x6, &$x7, &$x8, &$x9, &$x10, &$x11, &$x12, &$x13, &$x14, &$x15) { // columnRound static::quarterRound($x0, $x4, $x8, $x12); static::quarterRound($x5, $x9, $x13, $x1); static::quarterRound($x10, $x14, $x2, $x6); static::quarterRound($x15, $x3, $x7, $x11); // rowRound static::quarterRound($x0, $x1, $x2, $x3); static::quarterRound($x5, $x6, $x7, $x4); static::quarterRound($x10, $x11, $x8, $x9); static::quarterRound($x15, $x12, $x13, $x14); } /** * The Salsa20 hash function function * * @param string $x */ protected static function salsa20($x) { $z = $x = unpack('V*', $x); for ($i = 0; $i < 10; $i++) { static::doubleRound($z[1], $z[2], $z[3], $z[4], $z[5], $z[6], $z[7], $z[8], $z[9], $z[10], $z[11], $z[12], $z[13], $z[14], $z[15], $z[16]); } for ($i = 1; $i <= 16; $i++) { $x[$i] += $z[$i]; } return pack('V*', ...$x); } /** * Calculates Poly1305 MAC * * @see self::decrypt() * @see self::encrypt() * @param string $ciphertext * @return string */ protected function poly1305($ciphertext) { if (!$this->usingGeneratedPoly1305Key) { return parent::poly1305($this->aad . $ciphertext); } else { /* sodium_crypto_aead_chacha20poly1305_encrypt does not calculate the poly1305 tag the same way sodium_crypto_aead_chacha20poly1305_ietf_encrypt does. you can see how the latter encrypts it in Salsa20::encrypt(). here's how the former encrypts it: $this->newtag = $this->poly1305( $this->aad . pack('V', strlen($this->aad)) . "\0\0\0\0" . $ciphertext . pack('V', strlen($ciphertext)) . "\0\0\0\0" ); phpseclib opts to use the IETF construction, even when the nonce is 64-bits instead of 96-bits */ return parent::poly1305( self::nullPad128($this->aad) . self::nullPad128($ciphertext) . pack('V', strlen($this->aad)) . "\0\0\0\0" . pack('V', strlen($ciphertext)) . "\0\0\0\0" ); } } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\RSA; use phpseclib3\Crypt\Common; use phpseclib3\Crypt\Random; use phpseclib3\Crypt\RSA; use phpseclib3\Crypt\RSA\Formats\Keys\PSS; use phpseclib3\Exception\UnsupportedFormatException; use phpseclib3\Math\BigInteger; /** * Raw RSA Key Handler * * @author Jim Wigginton */ class PrivateKey extends RSA implements Common\PrivateKey { use Common\Traits\PasswordProtected; /** * Primes for Chinese Remainder Theorem (ie. p and q) * * @var array */ protected $primes; /** * Exponents for Chinese Remainder Theorem (ie. dP and dQ) * * @var array */ protected $exponents; /** * Coefficients for Chinese Remainder Theorem (ie. qInv) * * @var array */ protected $coefficients; /** * Private Exponent * * @var \phpseclib3\Math\BigInteger */ protected $privateExponent; /** * RSADP * * See {@link http://tools.ietf.org/html/rfc3447#section-5.1.2 RFC3447#section-5.1.2}. * * @return bool|\phpseclib3\Math\BigInteger */ private function rsadp(BigInteger $c) { if ($c->compare(self::$zero) < 0 || $c->compare($this->modulus) > 0) { throw new \OutOfRangeException('Ciphertext representative out of range'); } return $this->exponentiate($c); } /** * RSASP1 * * See {@link http://tools.ietf.org/html/rfc3447#section-5.2.1 RFC3447#section-5.2.1}. * * @return bool|\phpseclib3\Math\BigInteger */ private function rsasp1(BigInteger $m) { if ($m->compare(self::$zero) < 0 || $m->compare($this->modulus) > 0) { throw new \OutOfRangeException('Signature representative out of range'); } return $this->exponentiate($m); } /** * Exponentiate * * @param \phpseclib3\Math\BigInteger $x * @return \phpseclib3\Math\BigInteger */ protected function exponentiate(BigInteger $x) { switch (true) { case empty($this->primes): case $this->primes[1]->equals(self::$zero): case empty($this->coefficients): case $this->coefficients[2]->equals(self::$zero): case empty($this->exponents): case $this->exponents[1]->equals(self::$zero): return $x->modPow($this->exponent, $this->modulus); } $num_primes = count($this->primes); if (!static::$enableBlinding) { $m_i = [ 1 => $x->modPow($this->exponents[1], $this->primes[1]), 2 => $x->modPow($this->exponents[2], $this->primes[2]) ]; $h = $m_i[1]->subtract($m_i[2]); $h = $h->multiply($this->coefficients[2]); list(, $h) = $h->divide($this->primes[1]); $m = $m_i[2]->add($h->multiply($this->primes[2])); $r = $this->primes[1]; for ($i = 3; $i <= $num_primes; $i++) { $m_i = $x->modPow($this->exponents[$i], $this->primes[$i]); $r = $r->multiply($this->primes[$i - 1]); $h = $m_i->subtract($m); $h = $h->multiply($this->coefficients[$i]); list(, $h) = $h->divide($this->primes[$i]); $m = $m->add($r->multiply($h)); } } else { $smallest = $this->primes[1]; for ($i = 2; $i <= $num_primes; $i++) { if ($smallest->compare($this->primes[$i]) > 0) { $smallest = $this->primes[$i]; } } $r = BigInteger::randomRange(self::$one, $smallest->subtract(self::$one)); $m_i = [ 1 => $this->blind($x, $r, 1), 2 => $this->blind($x, $r, 2) ]; $h = $m_i[1]->subtract($m_i[2]); $h = $h->multiply($this->coefficients[2]); list(, $h) = $h->divide($this->primes[1]); $m = $m_i[2]->add($h->multiply($this->primes[2])); $r = $this->primes[1]; for ($i = 3; $i <= $num_primes; $i++) { $m_i = $this->blind($x, $r, $i); $r = $r->multiply($this->primes[$i - 1]); $h = $m_i->subtract($m); $h = $h->multiply($this->coefficients[$i]); list(, $h) = $h->divide($this->primes[$i]); $m = $m->add($r->multiply($h)); } } return $m; } /** * Performs RSA Blinding * * Protects against timing attacks by employing RSA Blinding. * Returns $x->modPow($this->exponents[$i], $this->primes[$i]) * * @param \phpseclib3\Math\BigInteger $x * @param \phpseclib3\Math\BigInteger $r * @param int $i * @return \phpseclib3\Math\BigInteger */ private function blind(BigInteger $x, BigInteger $r, $i) { $x = $x->multiply($r->modPow($this->publicExponent, $this->primes[$i])); $x = $x->modPow($this->exponents[$i], $this->primes[$i]); $r = $r->modInverse($this->primes[$i]); $x = $x->multiply($r); list(, $x) = $x->divide($this->primes[$i]); return $x; } /** * EMSA-PSS-ENCODE * * See {@link http://tools.ietf.org/html/rfc3447#section-9.1.1 RFC3447#section-9.1.1}. * * @return string * @param string $m * @throws \RuntimeException on encoding error * @param int $emBits */ private function emsa_pss_encode($m, $emBits) { // if $m is larger than two million terrabytes and you're using sha1, PKCS#1 suggests a "Label too long" error // be output. $emLen = ($emBits + 1) >> 3; // ie. ceil($emBits / 8) $sLen = $this->sLen !== null ? $this->sLen : $this->hLen; $mHash = $this->hash->hash($m); if ($emLen < $this->hLen + $sLen + 2) { throw new \LengthException('RSA modulus too short'); } $salt = Random::string($sLen); $m2 = "\0\0\0\0\0\0\0\0" . $mHash . $salt; $h = $this->hash->hash($m2); $ps = str_repeat(chr(0), $emLen - $sLen - $this->hLen - 2); $db = $ps . chr(1) . $salt; $dbMask = $this->mgf1($h, $emLen - $this->hLen - 1); // ie. stlren($db) $maskedDB = $db ^ $dbMask; $maskedDB[0] = ~chr(0xFF << ($emBits & 7)) & $maskedDB[0]; $em = $maskedDB . $h . chr(0xBC); return $em; } /** * RSASSA-PSS-SIGN * * See {@link http://tools.ietf.org/html/rfc3447#section-8.1.1 RFC3447#section-8.1.1}. * * @param string $m * @return bool|string */ private function rsassa_pss_sign($m) { // EMSA-PSS encoding $em = $this->emsa_pss_encode($m, 8 * $this->k - 1); // RSA signature $m = $this->os2ip($em); $s = $this->rsasp1($m); $s = $this->i2osp($s, $this->k); // Output the signature S return $s; } /** * RSASSA-PKCS1-V1_5-SIGN * * See {@link http://tools.ietf.org/html/rfc3447#section-8.2.1 RFC3447#section-8.2.1}. * * @param string $m * @throws \LengthException if the RSA modulus is too short * @return bool|string */ private function rsassa_pkcs1_v1_5_sign($m) { // EMSA-PKCS1-v1_5 encoding // If the encoding operation outputs "intended encoded message length too short," output "RSA modulus // too short" and stop. try { $em = $this->emsa_pkcs1_v1_5_encode($m, $this->k); } catch (\LengthException $e) { throw new \LengthException('RSA modulus too short'); } // RSA signature $m = $this->os2ip($em); $s = $this->rsasp1($m); $s = $this->i2osp($s, $this->k); // Output the signature S return $s; } /** * Create a signature * * @see self::verify() * @param string $message * @return string */ public function sign($message) { switch ($this->signaturePadding) { case self::SIGNATURE_PKCS1: case self::SIGNATURE_RELAXED_PKCS1: return $this->rsassa_pkcs1_v1_5_sign($message); //case self::SIGNATURE_PSS: default: return $this->rsassa_pss_sign($message); } } /** * RSAES-PKCS1-V1_5-DECRYPT * * See {@link http://tools.ietf.org/html/rfc3447#section-7.2.2 RFC3447#section-7.2.2}. * * @param string $c * @return bool|string */ private function rsaes_pkcs1_v1_5_decrypt($c) { // Length checking if (strlen($c) != $this->k) { // or if k < 11 throw new \LengthException('Ciphertext representative too long'); } // RSA decryption $c = $this->os2ip($c); $m = $this->rsadp($c); $em = $this->i2osp($m, $this->k); // EME-PKCS1-v1_5 decoding if (ord($em[0]) != 0 || ord($em[1]) > 2) { throw new \RuntimeException('Decryption error'); } $ps = substr($em, 2, strpos($em, chr(0), 2) - 2); $m = substr($em, strlen($ps) + 3); if (strlen($ps) < 8) { throw new \RuntimeException('Decryption error'); } // Output M return $m; } /** * RSAES-OAEP-DECRYPT * * See {@link http://tools.ietf.org/html/rfc3447#section-7.1.2 RFC3447#section-7.1.2}. The fact that the error * messages aren't distinguishable from one another hinders debugging, but, to quote from RFC3447#section-7.1.2: * * Note. Care must be taken to ensure that an opponent cannot * distinguish the different error conditions in Step 3.g, whether by * error message or timing, or, more generally, learn partial * information about the encoded message EM. Otherwise an opponent may * be able to obtain useful information about the decryption of the * ciphertext C, leading to a chosen-ciphertext attack such as the one * observed by Manger [36]. * * @param string $c * @return bool|string */ private function rsaes_oaep_decrypt($c) { // Length checking // if $l is larger than two million terrabytes and you're using sha1, PKCS#1 suggests a "Label too long" error // be output. if (strlen($c) != $this->k || $this->k < 2 * $this->hLen + 2) { throw new \LengthException('Ciphertext representative too long'); } // RSA decryption $c = $this->os2ip($c); $m = $this->rsadp($c); $em = $this->i2osp($m, $this->k); // EME-OAEP decoding $lHash = $this->hash->hash($this->label); $y = ord($em[0]); $maskedSeed = substr($em, 1, $this->hLen); $maskedDB = substr($em, $this->hLen + 1); $seedMask = $this->mgf1($maskedDB, $this->hLen); $seed = $maskedSeed ^ $seedMask; $dbMask = $this->mgf1($seed, $this->k - $this->hLen - 1); $db = $maskedDB ^ $dbMask; $lHash2 = substr($db, 0, $this->hLen); $m = substr($db, $this->hLen); $hashesMatch = hash_equals($lHash, $lHash2); $leadingZeros = 1; $patternMatch = 0; $offset = 0; for ($i = 0; $i < strlen($m); $i++) { $patternMatch |= $leadingZeros & ($m[$i] === "\1"); $leadingZeros &= $m[$i] === "\0"; $offset += $patternMatch ? 0 : 1; } // we do | instead of || to avoid https://en.wikipedia.org/wiki/Short-circuit_evaluation // to protect against timing attacks if (!$hashesMatch | !$patternMatch) { throw new \RuntimeException('Decryption error'); } // Output the message M return substr($m, $offset + 1); } /** * Raw Encryption / Decryption * * Doesn't use padding and is not recommended. * * @param string $m * @return bool|string * @throws \LengthException if strlen($m) > $this->k */ private function raw_encrypt($m) { if (strlen($m) > $this->k) { throw new \LengthException('Ciphertext representative too long'); } $temp = $this->os2ip($m); $temp = $this->rsadp($temp); return $this->i2osp($temp, $this->k); } /** * Decryption * * @see self::encrypt() * @param string $ciphertext * @return bool|string */ public function decrypt($ciphertext) { switch ($this->encryptionPadding) { case self::ENCRYPTION_NONE: return $this->raw_encrypt($ciphertext); case self::ENCRYPTION_PKCS1: return $this->rsaes_pkcs1_v1_5_decrypt($ciphertext); //case self::ENCRYPTION_OAEP: default: return $this->rsaes_oaep_decrypt($ciphertext); } } /** * Returns the public key * * @return mixed */ public function getPublicKey() { $type = self::validatePlugin('Keys', 'PKCS8', 'savePublicKey'); if (empty($this->modulus) || empty($this->publicExponent)) { throw new \RuntimeException('Public key components not found'); } $key = $type::savePublicKey($this->modulus, $this->publicExponent); return RSA::loadFormat('PKCS8', $key) ->withHash($this->hash->getHash()) ->withMGFHash($this->mgfHash->getHash()) ->withSaltLength($this->sLen) ->withLabel($this->label) ->withPadding($this->signaturePadding | $this->encryptionPadding); } /** * Returns the private key * * @param string $type * @param array $options optional * @return string */ public function toString($type, array $options = []) { $type = self::validatePlugin( 'Keys', $type, empty($this->primes) ? 'savePublicKey' : 'savePrivateKey' ); if ($type == PSS::class) { if ($this->signaturePadding == self::SIGNATURE_PSS) { $options += [ 'hash' => $this->hash->getHash(), 'MGFHash' => $this->mgfHash->getHash(), 'saltLength' => $this->getSaltLength() ]; } else { throw new UnsupportedFormatException('The PSS format can only be used when the signature method has been explicitly set to PSS'); } } if (empty($this->primes)) { return $type::savePublicKey($this->modulus, $this->exponent, $options); } return $type::savePrivateKey($this->modulus, $this->publicExponent, $this->exponent, $this->primes, $this->exponents, $this->coefficients, $this->password, $options); /* $key = $type::savePrivateKey($this->modulus, $this->publicExponent, $this->exponent, $this->primes, $this->exponents, $this->coefficients, $this->password, $options); if ($key !== false || count($this->primes) == 2) { return $key; } $nSize = $this->getSize() >> 1; $primes = [1 => clone self::$one, clone self::$one]; $i = 1; foreach ($this->primes as $prime) { $primes[$i] = $primes[$i]->multiply($prime); if ($primes[$i]->getLength() >= $nSize) { $i++; } } $exponents = []; $coefficients = [2 => $primes[2]->modInverse($primes[1])]; foreach ($primes as $i => $prime) { $temp = $prime->subtract(self::$one); $exponents[$i] = $this->modulus->modInverse($temp); } return $type::savePrivateKey($this->modulus, $this->publicExponent, $this->exponent, $primes, $exponents, $coefficients, $this->password, $options); */ } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\RSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\PKCS1 as Progenitor; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps; use phpseclib3\Math\BigInteger; /** * PKCS#1 Formatted RSA Key Handler * * @author Jim Wigginton */ abstract class PKCS1 extends Progenitor { /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } if (strpos($key, 'PUBLIC') !== false) { $components = ['isPublicKey' => true]; } elseif (strpos($key, 'PRIVATE') !== false) { $components = ['isPublicKey' => false]; } else { $components = []; } $key = parent::load($key, $password); $decoded = ASN1::decodeBER($key); if (!$decoded) { throw new \RuntimeException('Unable to decode BER'); } $key = ASN1::asn1map($decoded[0], Maps\RSAPrivateKey::MAP); if (is_array($key)) { $components += [ 'modulus' => $key['modulus'], 'publicExponent' => $key['publicExponent'], 'privateExponent' => $key['privateExponent'], 'primes' => [1 => $key['prime1'], $key['prime2']], 'exponents' => [1 => $key['exponent1'], $key['exponent2']], 'coefficients' => [2 => $key['coefficient']] ]; if ($key['version'] == 'multi') { foreach ($key['otherPrimeInfos'] as $primeInfo) { $components['primes'][] = $primeInfo['prime']; $components['exponents'][] = $primeInfo['exponent']; $components['coefficients'][] = $primeInfo['coefficient']; } } if (!isset($components['isPublicKey'])) { $components['isPublicKey'] = false; } return $components; } $key = ASN1::asn1map($decoded[0], Maps\RSAPublicKey::MAP); if (!is_array($key)) { throw new \RuntimeException('Unable to perform ASN1 mapping'); } if (!isset($components['isPublicKey'])) { $components['isPublicKey'] = true; } return $components + $key; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param \phpseclib3\Math\BigInteger $d * @param array $primes * @param array $exponents * @param array $coefficients * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $n, BigInteger $e, BigInteger $d, array $primes, array $exponents, array $coefficients, $password = '', array $options = []) { $num_primes = count($primes); $key = [ 'version' => $num_primes == 2 ? 'two-prime' : 'multi', 'modulus' => $n, 'publicExponent' => $e, 'privateExponent' => $d, 'prime1' => $primes[1], 'prime2' => $primes[2], 'exponent1' => $exponents[1], 'exponent2' => $exponents[2], 'coefficient' => $coefficients[2] ]; for ($i = 3; $i <= $num_primes; $i++) { $key['otherPrimeInfos'][] = [ 'prime' => $primes[$i], 'exponent' => $exponents[$i], 'coefficient' => $coefficients[$i] ]; } $key = ASN1::encodeDER($key, Maps\RSAPrivateKey::MAP); return self::wrapPrivateKey($key, 'RSA', $password, $options); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @return string */ public static function savePublicKey(BigInteger $n, BigInteger $e) { $key = [ 'modulus' => $n, 'publicExponent' => $e ]; $key = ASN1::encodeDER($key, Maps\RSAPublicKey::MAP); return self::wrapPublicKey($key, 'RSA'); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\RSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\PKCS8 as Progenitor; use phpseclib3\File\ASN1; use phpseclib3\Math\BigInteger; /** * PKCS#8 Formatted RSA Key Handler * * @author Jim Wigginton */ abstract class PKCS8 extends Progenitor { /** * OID Name * * @var string */ const OID_NAME = 'rsaEncryption'; /** * OID Value * * @var string */ const OID_VALUE = '1.2.840.113549.1.1.1'; /** * Child OIDs loaded * * @var bool */ protected static $childOIDsLoaded = false; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } if (strpos($key, 'PUBLIC') !== false) { $components = ['isPublicKey' => true]; } elseif (strpos($key, 'PRIVATE') !== false) { $components = ['isPublicKey' => false]; } else { $components = []; } $key = parent::load($key, $password); if (isset($key['privateKey'])) { if (!isset($components['isPublicKey'])) { $components['isPublicKey'] = false; } $type = 'private'; } else { if (!isset($components['isPublicKey'])) { $components['isPublicKey'] = true; } $type = 'public'; } $result = $components + PKCS1::load($key[$type . 'Key']); if (isset($key['meta'])) { $result['meta'] = $key['meta']; } return $result; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param \phpseclib3\Math\BigInteger $d * @param array $primes * @param array $exponents * @param array $coefficients * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $n, BigInteger $e, BigInteger $d, array $primes, array $exponents, array $coefficients, $password = '', array $options = []) { $key = PKCS1::savePrivateKey($n, $e, $d, $primes, $exponents, $coefficients); $key = ASN1::extractBER($key); return self::wrapPrivateKey($key, [], null, $password, null, '', $options); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param array $options optional * @return string */ public static function savePublicKey(BigInteger $n, BigInteger $e, array $options = []) { $key = PKCS1::savePublicKey($n, $e); $key = ASN1::extractBER($key); return self::wrapPublicKey($key, null); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\RSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\PKCS8 as Progenitor; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps; use phpseclib3\Math\BigInteger; /** * PKCS#8 Formatted RSA-PSS Key Handler * * @author Jim Wigginton */ abstract class PSS extends Progenitor { /** * OID Name * * @var string */ const OID_NAME = 'id-RSASSA-PSS'; /** * OID Value * * @var string */ const OID_VALUE = '1.2.840.113549.1.1.10'; /** * OIDs loaded * * @var bool */ private static $oidsLoaded = false; /** * Child OIDs loaded * * @var bool */ protected static $childOIDsLoaded = false; /** * Initialize static variables */ private static function initialize_static_variables() { if (!self::$oidsLoaded) { ASN1::loadOIDs([ 'md2' => '1.2.840.113549.2.2', 'md4' => '1.2.840.113549.2.4', 'md5' => '1.2.840.113549.2.5', 'id-sha1' => '1.3.14.3.2.26', 'id-sha256' => '2.16.840.1.101.3.4.2.1', 'id-sha384' => '2.16.840.1.101.3.4.2.2', 'id-sha512' => '2.16.840.1.101.3.4.2.3', 'id-sha224' => '2.16.840.1.101.3.4.2.4', 'id-sha512/224' => '2.16.840.1.101.3.4.2.5', 'id-sha512/256' => '2.16.840.1.101.3.4.2.6', 'id-mgf1' => '1.2.840.113549.1.1.8' ]); self::$oidsLoaded = true; } } /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { self::initialize_static_variables(); if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } $components = ['isPublicKey' => strpos($key, 'PUBLIC') !== false]; $key = parent::load($key, $password); $type = isset($key['privateKey']) ? 'private' : 'public'; $result = $components + PKCS1::load($key[$type . 'Key']); if (isset($key[$type . 'KeyAlgorithm']['parameters'])) { $decoded = ASN1::decodeBER($key[$type . 'KeyAlgorithm']['parameters']); if ($decoded === false) { throw new \UnexpectedValueException('Unable to decode parameters'); } $params = ASN1::asn1map($decoded[0], Maps\RSASSA_PSS_params::MAP); } else { $params = []; } if (isset($params['maskGenAlgorithm']['parameters'])) { $decoded = ASN1::decodeBER($params['maskGenAlgorithm']['parameters']); if ($decoded === false) { throw new \UnexpectedValueException('Unable to decode parameters'); } $params['maskGenAlgorithm']['parameters'] = ASN1::asn1map($decoded[0], Maps\HashAlgorithm::MAP); } else { $params['maskGenAlgorithm'] = [ 'algorithm' => 'id-mgf1', 'parameters' => ['algorithm' => 'id-sha1'] ]; } if (!isset($params['hashAlgorithm']['algorithm'])) { $params['hashAlgorithm']['algorithm'] = 'id-sha1'; } $result['hash'] = str_replace('id-', '', $params['hashAlgorithm']['algorithm']); $result['MGFHash'] = str_replace('id-', '', $params['maskGenAlgorithm']['parameters']['algorithm']); if (isset($params['saltLength'])) { $result['saltLength'] = (int) $params['saltLength']->toString(); } if (isset($key['meta'])) { $result['meta'] = $key['meta']; } return $result; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param \phpseclib3\Math\BigInteger $d * @param array $primes * @param array $exponents * @param array $coefficients * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $n, BigInteger $e, BigInteger $d, array $primes, array $exponents, array $coefficients, $password = '', array $options = []) { self::initialize_static_variables(); $key = PKCS1::savePrivateKey($n, $e, $d, $primes, $exponents, $coefficients); $key = ASN1::extractBER($key); $params = self::savePSSParams($options); return self::wrapPrivateKey($key, [], $params, $password, null, '', $options); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param array $options optional * @return string */ public static function savePublicKey(BigInteger $n, BigInteger $e, array $options = []) { self::initialize_static_variables(); $key = PKCS1::savePublicKey($n, $e); $key = ASN1::extractBER($key); $params = self::savePSSParams($options); return self::wrapPublicKey($key, $params); } /** * Encodes PSS parameters * * @param array $options * @return string */ public static function savePSSParams(array $options) { /* The trailerField field is an integer. It provides compatibility with IEEE Std 1363a-2004 [P1363A]. The value MUST be 1, which represents the trailer field with hexadecimal value 0xBC. Other trailer fields, including the trailer field composed of HashID concatenated with 0xCC that is specified in IEEE Std 1363a, are not supported. Implementations that perform signature generation MUST omit the trailerField field, indicating that the default trailer field value was used. Implementations that perform signature validation MUST recognize both a present trailerField field with value 1 and an absent trailerField field. source: https://tools.ietf.org/html/rfc4055#page-9 */ $params = [ 'trailerField' => new BigInteger(1) ]; if (isset($options['hash'])) { $params['hashAlgorithm']['algorithm'] = 'id-' . $options['hash']; } if (isset($options['MGFHash'])) { $temp = ['algorithm' => 'id-' . $options['MGFHash']]; $temp = ASN1::encodeDER($temp, Maps\HashAlgorithm::MAP); $params['maskGenAlgorithm'] = [ 'algorithm' => 'id-mgf1', 'parameters' => new ASN1\Element($temp) ]; } if (isset($options['saltLength'])) { $params['saltLength'] = new BigInteger($options['saltLength']); } return new ASN1\Element(ASN1::encodeDER($params, Maps\RSASSA_PSS_params::MAP)); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\RSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Exception\BadConfigurationException; use phpseclib3\Exception\UnsupportedFormatException; use phpseclib3\Math\BigInteger; /** * XML Formatted RSA Key Handler * * @author Jim Wigginton */ abstract class XML { /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } if (!class_exists('DOMDocument')) { throw new BadConfigurationException('The dom extension is not setup correctly on this system'); } $components = [ 'isPublicKey' => false, 'primes' => [], 'exponents' => [], 'coefficients' => [] ]; $use_errors = libxml_use_internal_errors(true); $dom = new \DOMDocument(); if (substr($key, 0, 5) != '' . $key . ''; } if (!$dom->loadXML($key)) { libxml_use_internal_errors($use_errors); throw new \UnexpectedValueException('Key does not appear to contain XML'); } $xpath = new \DOMXPath($dom); $keys = ['modulus', 'exponent', 'p', 'q', 'dp', 'dq', 'inverseq', 'd']; foreach ($keys as $key) { // $dom->getElementsByTagName($key) is case-sensitive $temp = $xpath->query("//*[translate(local-name(), 'ABCDEFGHIJKLMNOPQRSTUVWXYZ','abcdefghijklmnopqrstuvwxyz')='$key']"); if (!$temp->length) { continue; } $value = new BigInteger(Strings::base64_decode($temp->item(0)->nodeValue), 256); switch ($key) { case 'modulus': $components['modulus'] = $value; break; case 'exponent': $components['publicExponent'] = $value; break; case 'p': $components['primes'][1] = $value; break; case 'q': $components['primes'][2] = $value; break; case 'dp': $components['exponents'][1] = $value; break; case 'dq': $components['exponents'][2] = $value; break; case 'inverseq': $components['coefficients'][2] = $value; break; case 'd': $components['privateExponent'] = $value; } } libxml_use_internal_errors($use_errors); foreach ($components as $key => $value) { if (is_array($value) && !count($value)) { unset($components[$key]); } } if (isset($components['modulus']) && isset($components['publicExponent'])) { if (count($components) == 3) { $components['isPublicKey'] = true; } return $components; } throw new \UnexpectedValueException('Modulus / exponent not present'); } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param \phpseclib3\Math\BigInteger $d * @param array $primes * @param array $exponents * @param array $coefficients * @param string $password optional * @return string */ public static function savePrivateKey(BigInteger $n, BigInteger $e, BigInteger $d, array $primes, array $exponents, array $coefficients, $password = '') { if (count($primes) != 2) { throw new \InvalidArgumentException('XML does not support multi-prime RSA keys'); } if (!empty($password) && is_string($password)) { throw new UnsupportedFormatException('XML private keys do not support encryption'); } return "\r\n" . ' ' . Strings::base64_encode($n->toBytes()) . "\r\n" . ' ' . Strings::base64_encode($e->toBytes()) . "\r\n" . '

' . Strings::base64_encode($primes[1]->toBytes()) . "

\r\n" . ' ' . Strings::base64_encode($primes[2]->toBytes()) . "\r\n" . ' ' . Strings::base64_encode($exponents[1]->toBytes()) . "\r\n" . ' ' . Strings::base64_encode($exponents[2]->toBytes()) . "\r\n" . ' ' . Strings::base64_encode($coefficients[2]->toBytes()) . "\r\n" . ' ' . Strings::base64_encode($d->toBytes()) . "\r\n" . ''; } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @return string */ public static function savePublicKey(BigInteger $n, BigInteger $e) { return "\r\n" . ' ' . Strings::base64_encode($n->toBytes()) . "\r\n" . ' ' . Strings::base64_encode($e->toBytes()) . "\r\n" . ''; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\RSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Exception\UnsupportedFormatException; use phpseclib3\Math\BigInteger; /** * Microsoft BLOB Formatted RSA Key Handler * * @author Jim Wigginton */ abstract class MSBLOB { /** * Public/Private Key Pair * */ const PRIVATEKEYBLOB = 0x7; /** * Public Key * */ const PUBLICKEYBLOB = 0x6; /** * Public Key * */ const PUBLICKEYBLOBEX = 0xA; /** * RSA public key exchange algorithm * */ const CALG_RSA_KEYX = 0x0000A400; /** * RSA public key exchange algorithm * */ const CALG_RSA_SIGN = 0x00002400; /** * Public Key * */ const RSA1 = 0x31415352; /** * Private Key * */ const RSA2 = 0x32415352; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } $key = Strings::base64_decode($key); if (!is_string($key)) { throw new \UnexpectedValueException('Base64 decoding produced an error'); } if (strlen($key) < 20) { throw new \UnexpectedValueException('Key appears to be malformed'); } // PUBLICKEYSTRUC publickeystruc // https://msdn.microsoft.com/en-us/library/windows/desktop/aa387453(v=vs.85).aspx extract(unpack('atype/aversion/vreserved/Valgo', Strings::shift($key, 8))); /** * @var string $type * @var string $version * @var integer $reserved * @var integer $algo */ switch (ord($type)) { case self::PUBLICKEYBLOB: case self::PUBLICKEYBLOBEX: $publickey = true; break; case self::PRIVATEKEYBLOB: $publickey = false; break; default: throw new \UnexpectedValueException('Key appears to be malformed'); } $components = ['isPublicKey' => $publickey]; // https://msdn.microsoft.com/en-us/library/windows/desktop/aa375549(v=vs.85).aspx switch ($algo) { case self::CALG_RSA_KEYX: case self::CALG_RSA_SIGN: break; default: throw new \UnexpectedValueException('Key appears to be malformed'); } // RSAPUBKEY rsapubkey // https://msdn.microsoft.com/en-us/library/windows/desktop/aa387685(v=vs.85).aspx // could do V for pubexp but that's unsigned 32-bit whereas some PHP installs only do signed 32-bit extract(unpack('Vmagic/Vbitlen/a4pubexp', Strings::shift($key, 12))); /** * @var integer $magic * @var integer $bitlen * @var string $pubexp */ switch ($magic) { case self::RSA2: $components['isPublicKey'] = false; // fall-through case self::RSA1: break; default: throw new \UnexpectedValueException('Key appears to be malformed'); } $baseLength = $bitlen / 16; if (strlen($key) != 2 * $baseLength && strlen($key) != 9 * $baseLength) { throw new \UnexpectedValueException('Key appears to be malformed'); } $components[$components['isPublicKey'] ? 'publicExponent' : 'privateExponent'] = new BigInteger(strrev($pubexp), 256); // BYTE modulus[rsapubkey.bitlen/8] $components['modulus'] = new BigInteger(strrev(Strings::shift($key, $bitlen / 8)), 256); if ($publickey) { return $components; } $components['isPublicKey'] = false; // BYTE prime1[rsapubkey.bitlen/16] $components['primes'] = [1 => new BigInteger(strrev(Strings::shift($key, $bitlen / 16)), 256)]; // BYTE prime2[rsapubkey.bitlen/16] $components['primes'][] = new BigInteger(strrev(Strings::shift($key, $bitlen / 16)), 256); // BYTE exponent1[rsapubkey.bitlen/16] $components['exponents'] = [1 => new BigInteger(strrev(Strings::shift($key, $bitlen / 16)), 256)]; // BYTE exponent2[rsapubkey.bitlen/16] $components['exponents'][] = new BigInteger(strrev(Strings::shift($key, $bitlen / 16)), 256); // BYTE coefficient[rsapubkey.bitlen/16] $components['coefficients'] = [2 => new BigInteger(strrev(Strings::shift($key, $bitlen / 16)), 256)]; if (isset($components['privateExponent'])) { $components['publicExponent'] = $components['privateExponent']; } // BYTE privateExponent[rsapubkey.bitlen/8] $components['privateExponent'] = new BigInteger(strrev(Strings::shift($key, $bitlen / 8)), 256); return $components; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param \phpseclib3\Math\BigInteger $d * @param array $primes * @param array $exponents * @param array $coefficients * @param string $password optional * @return string */ public static function savePrivateKey(BigInteger $n, BigInteger $e, BigInteger $d, array $primes, array $exponents, array $coefficients, $password = '') { if (count($primes) != 2) { throw new \InvalidArgumentException('MSBLOB does not support multi-prime RSA keys'); } if (!empty($password) && is_string($password)) { throw new UnsupportedFormatException('MSBLOB private keys do not support encryption'); } $n = strrev($n->toBytes()); $e = str_pad(strrev($e->toBytes()), 4, "\0"); $key = pack('aavV', chr(self::PRIVATEKEYBLOB), chr(2), 0, self::CALG_RSA_KEYX); $key .= pack('VVa*', self::RSA2, 8 * strlen($n), $e); $key .= $n; $key .= strrev($primes[1]->toBytes()); $key .= strrev($primes[2]->toBytes()); $key .= strrev($exponents[1]->toBytes()); $key .= strrev($exponents[2]->toBytes()); $key .= strrev($coefficients[2]->toBytes()); $key .= strrev($d->toBytes()); return Strings::base64_encode($key); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @return string */ public static function savePublicKey(BigInteger $n, BigInteger $e) { $n = strrev($n->toBytes()); $e = str_pad(strrev($e->toBytes()), 4, "\0"); $key = pack('aavV', chr(self::PUBLICKEYBLOB), chr(2), 0, self::CALG_RSA_KEYX); $key .= pack('VVa*', self::RSA1, 8 * strlen($n), $e); $key .= $n; return Strings::base64_encode($key); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\RSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\JWK as Progenitor; use phpseclib3\Math\BigInteger; /** * JWK Formatted RSA Handler * * @author Jim Wigginton */ abstract class JWK extends Progenitor { /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { $key = parent::load($key, $password); if ($key->kty != 'RSA') { throw new \RuntimeException('Only RSA JWK keys are supported'); } $count = $publicCount = 0; $vars = ['n', 'e', 'd', 'p', 'q', 'dp', 'dq', 'qi']; foreach ($vars as $var) { if (!isset($key->$var) || !is_string($key->$var)) { continue; } $count++; $value = new BigInteger(Strings::base64url_decode($key->$var), 256); switch ($var) { case 'n': $publicCount++; $components['modulus'] = $value; break; case 'e': $publicCount++; $components['publicExponent'] = $value; break; case 'd': $components['privateExponent'] = $value; break; case 'p': $components['primes'][1] = $value; break; case 'q': $components['primes'][2] = $value; break; case 'dp': $components['exponents'][1] = $value; break; case 'dq': $components['exponents'][2] = $value; break; case 'qi': $components['coefficients'][2] = $value; } } if ($count == count($vars)) { return $components + ['isPublicKey' => false]; } if ($count == 2 && $publicCount == 2) { return $components + ['isPublicKey' => true]; } throw new \UnexpectedValueException('Key does not have an appropriate number of RSA parameters'); } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param \phpseclib3\Math\BigInteger $d * @param array $primes * @param array $exponents * @param array $coefficients * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $n, BigInteger $e, BigInteger $d, array $primes, array $exponents, array $coefficients, $password = '', array $options = []) { if (count($primes) != 2) { throw new \InvalidArgumentException('JWK does not support multi-prime RSA keys'); } $key = [ 'kty' => 'RSA', 'n' => Strings::base64url_encode($n->toBytes()), 'e' => Strings::base64url_encode($e->toBytes()), 'd' => Strings::base64url_encode($d->toBytes()), 'p' => Strings::base64url_encode($primes[1]->toBytes()), 'q' => Strings::base64url_encode($primes[2]->toBytes()), 'dp' => Strings::base64url_encode($exponents[1]->toBytes()), 'dq' => Strings::base64url_encode($exponents[2]->toBytes()), 'qi' => Strings::base64url_encode($coefficients[2]->toBytes()) ]; return self::wrapKey($key, $options); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param array $options optional * @return string */ public static function savePublicKey(BigInteger $n, BigInteger $e, array $options = []) { $key = [ 'kty' => 'RSA', 'n' => Strings::base64url_encode($n->toBytes()), 'e' => Strings::base64url_encode($e->toBytes()) ]; return self::wrapKey($key, $options); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\RSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\PuTTY as Progenitor; use phpseclib3\Math\BigInteger; /** * PuTTY Formatted RSA Key Handler * * @author Jim Wigginton */ abstract class PuTTY extends Progenitor { /** * Public Handler * * @var string */ const PUBLIC_HANDLER = 'phpseclib3\Crypt\RSA\Formats\Keys\OpenSSH'; /** * Algorithm Identifier * * @var array */ protected static $types = ['ssh-rsa']; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { static $one; if (!isset($one)) { $one = new BigInteger(1); } $components = parent::load($key, $password); if (!isset($components['private'])) { return $components; } extract($components); unset($components['public'], $components['private']); $isPublicKey = false; $result = Strings::unpackSSH2('ii', $public); if ($result === false) { throw new \UnexpectedValueException('Key appears to be malformed'); } list($publicExponent, $modulus) = $result; $result = Strings::unpackSSH2('iiii', $private); if ($result === false) { throw new \UnexpectedValueException('Key appears to be malformed'); } $primes = $coefficients = []; list($privateExponent, $primes[1], $primes[2], $coefficients[2]) = $result; $temp = $primes[1]->subtract($one); $exponents = [1 => $publicExponent->modInverse($temp)]; $temp = $primes[2]->subtract($one); $exponents[] = $publicExponent->modInverse($temp); return compact('publicExponent', 'modulus', 'privateExponent', 'primes', 'coefficients', 'exponents', 'comment', 'isPublicKey'); } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param \phpseclib3\Math\BigInteger $d * @param array $primes * @param array $exponents * @param array $coefficients * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $n, BigInteger $e, BigInteger $d, array $primes, array $exponents, array $coefficients, $password = '', array $options = []) { if (count($primes) != 2) { throw new \InvalidArgumentException('PuTTY does not support multi-prime RSA keys'); } $public = Strings::packSSH2('ii', $e, $n); $private = Strings::packSSH2('iiii', $d, $primes[1], $primes[2], $coefficients[2]); return self::wrapPrivateKey($public, $private, 'ssh-rsa', $password, $options); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @return string */ public static function savePublicKey(BigInteger $n, BigInteger $e) { return self::wrapPublicKey(Strings::packSSH2('ii', $e, $n), 'ssh-rsa'); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\RSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\OpenSSH as Progenitor; use phpseclib3\Math\BigInteger; /** * OpenSSH Formatted RSA Key Handler * * @author Jim Wigginton */ abstract class OpenSSH extends Progenitor { /** * Supported Key Types * * @var array */ protected static $types = ['ssh-rsa']; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { static $one; if (!isset($one)) { $one = new BigInteger(1); } $parsed = parent::load($key, $password); if (isset($parsed['paddedKey'])) { list($type) = Strings::unpackSSH2('s', $parsed['paddedKey']); if ($type != $parsed['type']) { throw new \RuntimeException("The public and private keys are not of the same type ($type vs $parsed[type])"); } $primes = $coefficients = []; list( $modulus, $publicExponent, $privateExponent, $coefficients[2], $primes[1], $primes[2], $comment, ) = Strings::unpackSSH2('i6s', $parsed['paddedKey']); $temp = $primes[1]->subtract($one); $exponents = [1 => $publicExponent->modInverse($temp)]; $temp = $primes[2]->subtract($one); $exponents[] = $publicExponent->modInverse($temp); $isPublicKey = false; return compact('publicExponent', 'modulus', 'privateExponent', 'primes', 'coefficients', 'exponents', 'comment', 'isPublicKey'); } list($publicExponent, $modulus) = Strings::unpackSSH2('ii', $parsed['publicKey']); return [ 'isPublicKey' => true, 'modulus' => $modulus, 'publicExponent' => $publicExponent, 'comment' => $parsed['comment'] ]; } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param array $options optional * @return string */ public static function savePublicKey(BigInteger $n, BigInteger $e, array $options = []) { $RSAPublicKey = Strings::packSSH2('sii', 'ssh-rsa', $e, $n); if (isset($options['binary']) ? $options['binary'] : self::$binary) { return $RSAPublicKey; } $comment = isset($options['comment']) ? $options['comment'] : self::$comment; $RSAPublicKey = 'ssh-rsa ' . base64_encode($RSAPublicKey) . ' ' . $comment; return $RSAPublicKey; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param \phpseclib3\Math\BigInteger $d * @param array $primes * @param array $exponents * @param array $coefficients * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $n, BigInteger $e, BigInteger $d, array $primes, array $exponents, array $coefficients, $password = '', array $options = []) { $publicKey = self::savePublicKey($n, $e, ['binary' => true]); $privateKey = Strings::packSSH2('si6', 'ssh-rsa', $n, $e, $d, $coefficients[2], $primes[1], $primes[2]); return self::wrapPrivateKey($publicKey, $privateKey, $password, $options); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\RSA\Formats\Keys; use phpseclib3\Math\BigInteger; /** * Raw RSA Key Handler * * @author Jim Wigginton */ abstract class Raw { /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { if (!is_array($key)) { throw new \UnexpectedValueException('Key should be a array - not a ' . gettype($key)); } $key = array_change_key_case($key, CASE_LOWER); $components = ['isPublicKey' => false]; foreach (['e', 'exponent', 'publicexponent', 0, 'privateexponent', 'd'] as $index) { if (isset($key[$index])) { $components['publicExponent'] = $key[$index]; break; } } foreach (['n', 'modulo', 'modulus', 1] as $index) { if (isset($key[$index])) { $components['modulus'] = $key[$index]; break; } } if (!isset($components['publicExponent']) || !isset($components['modulus'])) { throw new \UnexpectedValueException('Modulus / exponent not present'); } if (isset($key['primes'])) { $components['primes'] = $key['primes']; } elseif (isset($key['p']) && isset($key['q'])) { $indices = [ ['p', 'q'], ['prime1', 'prime2'] ]; foreach ($indices as $index) { list($i0, $i1) = $index; if (isset($key[$i0]) && isset($key[$i1])) { $components['primes'] = [1 => $key[$i0], $key[$i1]]; } } } if (isset($key['exponents'])) { $components['exponents'] = $key['exponents']; } else { $indices = [ ['dp', 'dq'], ['exponent1', 'exponent2'] ]; foreach ($indices as $index) { list($i0, $i1) = $index; if (isset($key[$i0]) && isset($key[$i1])) { $components['exponents'] = [1 => $key[$i0], $key[$i1]]; } } } if (isset($key['coefficients'])) { $components['coefficients'] = $key['coefficients']; } else { foreach (['inverseq', 'q\'', 'coefficient'] as $index) { if (isset($key[$index])) { $components['coefficients'] = [2 => $key[$index]]; } } } if (!isset($components['primes'])) { $components['isPublicKey'] = true; return $components; } if (!isset($components['exponents'])) { $one = new BigInteger(1); $temp = $components['primes'][1]->subtract($one); $exponents = [1 => $components['publicExponent']->modInverse($temp)]; $temp = $components['primes'][2]->subtract($one); $exponents[] = $components['publicExponent']->modInverse($temp); $components['exponents'] = $exponents; } if (!isset($components['coefficients'])) { $components['coefficients'] = [2 => $components['primes'][2]->modInverse($components['primes'][1])]; } foreach (['privateexponent', 'd'] as $index) { if (isset($key[$index])) { $components['privateExponent'] = $key[$index]; break; } } return $components; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @param \phpseclib3\Math\BigInteger $d * @param array $primes * @param array $exponents * @param array $coefficients * @param string $password optional * @param array $options optional * @return array */ public static function savePrivateKey(BigInteger $n, BigInteger $e, BigInteger $d, array $primes, array $exponents, array $coefficients, $password = '', array $options = []) { if (!empty($password) && is_string($password)) { throw new UnsupportedFormatException('Raw private keys do not support encryption'); } return [ 'e' => clone $e, 'n' => clone $n, 'd' => clone $d, 'primes' => array_map(function ($var) { return clone $var; }, $primes), 'exponents' => array_map(function ($var) { return clone $var; }, $exponents), 'coefficients' => array_map(function ($var) { return clone $var; }, $coefficients) ]; } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $n * @param \phpseclib3\Math\BigInteger $e * @return array */ public static function savePublicKey(BigInteger $n, BigInteger $e) { return ['e' => clone $e, 'n' => clone $n]; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\RSA; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common; use phpseclib3\Crypt\Hash; use phpseclib3\Crypt\Random; use phpseclib3\Crypt\RSA; use phpseclib3\Crypt\RSA\Formats\Keys\PSS; use phpseclib3\Exception\UnsupportedAlgorithmException; use phpseclib3\Exception\UnsupportedFormatException; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps\DigestInfo; use phpseclib3\Math\BigInteger; /** * Raw RSA Key Handler * * @author Jim Wigginton */ class PublicKey extends RSA implements Common\PublicKey { use Common\Traits\Fingerprint; /** * Exponentiate * * @param \phpseclib3\Math\BigInteger $x * @return \phpseclib3\Math\BigInteger */ private function exponentiate(BigInteger $x) { return $x->modPow($this->exponent, $this->modulus); } /** * RSAVP1 * * See {@link http://tools.ietf.org/html/rfc3447#section-5.2.2 RFC3447#section-5.2.2}. * * @param \phpseclib3\Math\BigInteger $s * @return bool|\phpseclib3\Math\BigInteger */ private function rsavp1($s) { if ($s->compare(self::$zero) < 0 || $s->compare($this->modulus) > 0) { return false; } return $this->exponentiate($s); } /** * RSASSA-PKCS1-V1_5-VERIFY * * See {@link http://tools.ietf.org/html/rfc3447#section-8.2.2 RFC3447#section-8.2.2}. * * @param string $m * @param string $s * @throws \LengthException if the RSA modulus is too short * @return bool */ private function rsassa_pkcs1_v1_5_verify($m, $s) { // Length checking if (strlen($s) != $this->k) { return false; } // RSA verification $s = $this->os2ip($s); $m2 = $this->rsavp1($s); if ($m2 === false) { return false; } $em = $this->i2osp($m2, $this->k); if ($em === false) { return false; } // EMSA-PKCS1-v1_5 encoding $exception = false; // If the encoding operation outputs "intended encoded message length too short," output "RSA modulus // too short" and stop. try { $em2 = $this->emsa_pkcs1_v1_5_encode($m, $this->k); $r1 = hash_equals($em, $em2); } catch (\LengthException $e) { $exception = true; } try { $em3 = $this->emsa_pkcs1_v1_5_encode_without_null($m, $this->k); $r2 = hash_equals($em, $em3); } catch (\LengthException $e) { $exception = true; } catch (UnsupportedAlgorithmException $e) { $r2 = false; } if ($exception) { throw new \LengthException('RSA modulus too short'); } // Compare return $r1 || $r2; } /** * RSASSA-PKCS1-V1_5-VERIFY (relaxed matching) * * Per {@link http://tools.ietf.org/html/rfc3447#page-43 RFC3447#page-43} PKCS1 v1.5 * specified the use BER encoding rather than DER encoding that PKCS1 v2.0 specified. * This means that under rare conditions you can have a perfectly valid v1.5 signature * that fails to validate with _rsassa_pkcs1_v1_5_verify(). PKCS1 v2.1 also recommends * that if you're going to validate these types of signatures you "should indicate * whether the underlying BER encoding is a DER encoding and hence whether the signature * is valid with respect to the specification given in [PKCS1 v2.0+]". so if you do * $rsa->getLastPadding() and get RSA::PADDING_RELAXED_PKCS1 back instead of * RSA::PADDING_PKCS1... that means BER encoding was used. * * @param string $m * @param string $s * @return bool */ private function rsassa_pkcs1_v1_5_relaxed_verify($m, $s) { // Length checking if (strlen($s) != $this->k) { return false; } // RSA verification $s = $this->os2ip($s); $m2 = $this->rsavp1($s); if ($m2 === false) { return false; } $em = $this->i2osp($m2, $this->k); if ($em === false) { return false; } if (Strings::shift($em, 2) != "\0\1") { return false; } $em = ltrim($em, "\xFF"); if (Strings::shift($em) != "\0") { return false; } $decoded = ASN1::decodeBER($em); if (!is_array($decoded) || empty($decoded[0]) || strlen($em) > $decoded[0]['length']) { return false; } static $oids; if (!isset($oids)) { $oids = [ 'md2' => '1.2.840.113549.2.2', 'md4' => '1.2.840.113549.2.4', // from PKCS1 v1.5 'md5' => '1.2.840.113549.2.5', 'id-sha1' => '1.3.14.3.2.26', 'id-sha256' => '2.16.840.1.101.3.4.2.1', 'id-sha384' => '2.16.840.1.101.3.4.2.2', 'id-sha512' => '2.16.840.1.101.3.4.2.3', // from PKCS1 v2.2 'id-sha224' => '2.16.840.1.101.3.4.2.4', 'id-sha512/224' => '2.16.840.1.101.3.4.2.5', 'id-sha512/256' => '2.16.840.1.101.3.4.2.6', ]; ASN1::loadOIDs($oids); } $decoded = ASN1::asn1map($decoded[0], DigestInfo::MAP); if (!isset($decoded) || $decoded === false) { return false; } if (!isset($oids[$decoded['digestAlgorithm']['algorithm']])) { return false; } if (isset($decoded['digestAlgorithm']['parameters']) && $decoded['digestAlgorithm']['parameters'] !== ['null' => '']) { return false; } $hash = $decoded['digestAlgorithm']['algorithm']; $hash = substr($hash, 0, 3) == 'id-' ? substr($hash, 3) : $hash; $hash = new Hash($hash); $em = $hash->hash($m); $em2 = $decoded['digest']; return hash_equals($em, $em2); } /** * EMSA-PSS-VERIFY * * See {@link http://tools.ietf.org/html/rfc3447#section-9.1.2 RFC3447#section-9.1.2}. * * @param string $m * @param string $em * @param int $emBits * @return string */ private function emsa_pss_verify($m, $em, $emBits) { // if $m is larger than two million terrabytes and you're using sha1, PKCS#1 suggests a "Label too long" error // be output. $emLen = ($emBits + 7) >> 3; // ie. ceil($emBits / 8); $sLen = $this->sLen !== null ? $this->sLen : $this->hLen; $mHash = $this->hash->hash($m); if ($emLen < $this->hLen + $sLen + 2) { return false; } if ($em[strlen($em) - 1] != chr(0xBC)) { return false; } $maskedDB = substr($em, 0, -$this->hLen - 1); $h = substr($em, -$this->hLen - 1, $this->hLen); $temp = chr(0xFF << ($emBits & 7)); if ((~$maskedDB[0] & $temp) != $temp) { return false; } $dbMask = $this->mgf1($h, $emLen - $this->hLen - 1); $db = $maskedDB ^ $dbMask; $db[0] = ~chr(0xFF << ($emBits & 7)) & $db[0]; $temp = $emLen - $this->hLen - $sLen - 2; if (substr($db, 0, $temp) != str_repeat(chr(0), $temp) || ord($db[$temp]) != 1) { return false; } $salt = substr($db, $temp + 1); // should be $sLen long $m2 = "\0\0\0\0\0\0\0\0" . $mHash . $salt; $h2 = $this->hash->hash($m2); return hash_equals($h, $h2); } /** * RSASSA-PSS-VERIFY * * See {@link http://tools.ietf.org/html/rfc3447#section-8.1.2 RFC3447#section-8.1.2}. * * @param string $m * @param string $s * @return bool|string */ private function rsassa_pss_verify($m, $s) { // Length checking if (strlen($s) != $this->k) { return false; } // RSA verification $modBits = strlen($this->modulus->toBits()); $s2 = $this->os2ip($s); $m2 = $this->rsavp1($s2); $em = $this->i2osp($m2, $this->k); if ($em === false) { return false; } // EMSA-PSS verification return $this->emsa_pss_verify($m, $em, $modBits - 1); } /** * Verifies a signature * * @see self::sign() * @param string $message * @param string $signature * @return bool */ public function verify($message, $signature) { switch ($this->signaturePadding) { case self::SIGNATURE_RELAXED_PKCS1: return $this->rsassa_pkcs1_v1_5_relaxed_verify($message, $signature); case self::SIGNATURE_PKCS1: return $this->rsassa_pkcs1_v1_5_verify($message, $signature); //case self::SIGNATURE_PSS: default: return $this->rsassa_pss_verify($message, $signature); } } /** * RSAES-PKCS1-V1_5-ENCRYPT * * See {@link http://tools.ietf.org/html/rfc3447#section-7.2.1 RFC3447#section-7.2.1}. * * @param string $m * @param bool $pkcs15_compat optional * @throws \LengthException if strlen($m) > $this->k - 11 * @return bool|string */ private function rsaes_pkcs1_v1_5_encrypt($m, $pkcs15_compat = false) { $mLen = strlen($m); // Length checking if ($mLen > $this->k - 11) { throw new \LengthException('Message too long'); } // EME-PKCS1-v1_5 encoding $psLen = $this->k - $mLen - 3; $ps = ''; while (strlen($ps) != $psLen) { $temp = Random::string($psLen - strlen($ps)); $temp = str_replace("\x00", '', $temp); $ps .= $temp; } $type = 2; $em = chr(0) . chr($type) . $ps . chr(0) . $m; // RSA encryption $m = $this->os2ip($em); $c = $this->rsaep($m); $c = $this->i2osp($c, $this->k); // Output the ciphertext C return $c; } /** * RSAES-OAEP-ENCRYPT * * See {@link http://tools.ietf.org/html/rfc3447#section-7.1.1 RFC3447#section-7.1.1} and * {http://en.wikipedia.org/wiki/Optimal_Asymmetric_Encryption_Padding OAES}. * * @param string $m * @throws \LengthException if strlen($m) > $this->k - 2 * $this->hLen - 2 * @return string */ private function rsaes_oaep_encrypt($m) { $mLen = strlen($m); // Length checking // if $l is larger than two million terrabytes and you're using sha1, PKCS#1 suggests a "Label too long" error // be output. if ($mLen > $this->k - 2 * $this->hLen - 2) { throw new \LengthException('Message too long'); } // EME-OAEP encoding $lHash = $this->hash->hash($this->label); $ps = str_repeat(chr(0), $this->k - $mLen - 2 * $this->hLen - 2); $db = $lHash . $ps . chr(1) . $m; $seed = Random::string($this->hLen); $dbMask = $this->mgf1($seed, $this->k - $this->hLen - 1); $maskedDB = $db ^ $dbMask; $seedMask = $this->mgf1($maskedDB, $this->hLen); $maskedSeed = $seed ^ $seedMask; $em = chr(0) . $maskedSeed . $maskedDB; // RSA encryption $m = $this->os2ip($em); $c = $this->rsaep($m); $c = $this->i2osp($c, $this->k); // Output the ciphertext C return $c; } /** * RSAEP * * See {@link http://tools.ietf.org/html/rfc3447#section-5.1.1 RFC3447#section-5.1.1}. * * @param \phpseclib3\Math\BigInteger $m * @return bool|\phpseclib3\Math\BigInteger */ private function rsaep($m) { if ($m->compare(self::$zero) < 0 || $m->compare($this->modulus) > 0) { throw new \OutOfRangeException('Message representative out of range'); } return $this->exponentiate($m); } /** * Raw Encryption / Decryption * * Doesn't use padding and is not recommended. * * @param string $m * @return bool|string * @throws \LengthException if strlen($m) > $this->k */ private function raw_encrypt($m) { if (strlen($m) > $this->k) { throw new \LengthException('Message too long'); } $temp = $this->os2ip($m); $temp = $this->rsaep($temp); return $this->i2osp($temp, $this->k); } /** * Encryption * * Both self::PADDING_OAEP and self::PADDING_PKCS1 both place limits on how long $plaintext can be. * If $plaintext exceeds those limits it will be broken up so that it does and the resultant ciphertext's will * be concatenated together. * * @see self::decrypt() * @param string $plaintext * @return bool|string * @throws \LengthException if the RSA modulus is too short */ public function encrypt($plaintext) { switch ($this->encryptionPadding) { case self::ENCRYPTION_NONE: return $this->raw_encrypt($plaintext); case self::ENCRYPTION_PKCS1: return $this->rsaes_pkcs1_v1_5_encrypt($plaintext); //case self::ENCRYPTION_OAEP: default: return $this->rsaes_oaep_encrypt($plaintext); } } /** * Returns the public key * * The public key is only returned under two circumstances - if the private key had the public key embedded within it * or if the public key was set via setPublicKey(). If the currently loaded key is supposed to be the public key this * function won't return it since this library, for the most part, doesn't distinguish between public and private keys. * * @param string $type * @param array $options optional * @return mixed */ public function toString($type, array $options = []) { $type = self::validatePlugin('Keys', $type, 'savePublicKey'); if ($type == PSS::class) { if ($this->signaturePadding == self::SIGNATURE_PSS) { $options += [ 'hash' => $this->hash->getHash(), 'MGFHash' => $this->mgfHash->getHash(), 'saltLength' => $this->getSaltLength() ]; } else { throw new UnsupportedFormatException('The PSS format can only be used when the signature method has been explicitly set to PSS'); } } return $type::savePublicKey($this->modulus, $this->publicExponent, $options); } /** * Converts a public key to a private key * * @return RSA */ public function asPrivateKey() { $new = new PrivateKey(); $new->exponent = $this->exponent; $new->modulus = $this->modulus; $new->k = $this->k; $new->format = $this->format; return $new ->withHash($this->hash->getHash()) ->withMGFHash($this->mgfHash->getHash()) ->withSaltLength($this->sLen) ->withLabel($this->label) ->withPadding($this->signaturePadding | $this->encryptionPadding); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DH; use phpseclib3\Crypt\DH; /** * DH Parameters * * @author Jim Wigginton */ class Parameters extends DH { /** * Returns the parameters * * @param string $type * @param array $options optional * @return string */ public function toString($type = 'PKCS1', array $options = []) { $type = self::validatePlugin('Keys', 'PKCS1', 'saveParameters'); return $type::saveParameters($this->prime, $this->base, $options); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DH; use phpseclib3\Crypt\Common; use phpseclib3\Crypt\DH; /** * DH Private Key * * @author Jim Wigginton */ class PrivateKey extends DH { use Common\Traits\PasswordProtected; /** * Private Key * * @var \phpseclib3\Math\BigInteger */ protected $privateKey; /** * Public Key * * @var \phpseclib3\Math\BigInteger */ protected $publicKey; /** * Returns the public key * * @return DH\PublicKey */ public function getPublicKey() { $type = self::validatePlugin('Keys', 'PKCS8', 'savePublicKey'); if (!isset($this->publicKey)) { $this->publicKey = $this->base->powMod($this->privateKey, $this->prime); } $key = $type::savePublicKey($this->prime, $this->base, $this->publicKey); return DH::loadFormat('PKCS8', $key); } /** * Returns the private key * * @param string $type * @param array $options optional * @return string */ public function toString($type, array $options = []) { $type = self::validatePlugin('Keys', $type, 'savePrivateKey'); if (!isset($this->publicKey)) { $this->publicKey = $this->base->powMod($this->privateKey, $this->prime); } return $type::savePrivateKey($this->prime, $this->base, $this->privateKey, $this->publicKey, $this->password, $options); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DH\Formats\Keys; use phpseclib3\Crypt\Common\Formats\Keys\PKCS1 as Progenitor; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps; use phpseclib3\Math\BigInteger; /** * "PKCS1" Formatted DH Key Handler * * @author Jim Wigginton */ abstract class PKCS1 extends Progenitor { /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { $key = parent::load($key, $password); $decoded = ASN1::decodeBER($key); if (!$decoded) { throw new \RuntimeException('Unable to decode BER'); } $components = ASN1::asn1map($decoded[0], Maps\DHParameter::MAP); if (!is_array($components)) { throw new \RuntimeException('Unable to perform ASN1 mapping on parameters'); } return $components; } /** * Convert EC parameters to the appropriate format * * @return string */ public static function saveParameters(BigInteger $prime, BigInteger $base, array $options = []) { $params = [ 'prime' => $prime, 'base' => $base ]; $params = ASN1::encodeDER($params, Maps\DHParameter::MAP); return "-----BEGIN DH PARAMETERS-----\r\n" . chunk_split(base64_encode($params), 64) . "-----END DH PARAMETERS-----\r\n"; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DH\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\PKCS8 as Progenitor; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps; use phpseclib3\Math\BigInteger; /** * PKCS#8 Formatted DH Key Handler * * @author Jim Wigginton */ abstract class PKCS8 extends Progenitor { /** * OID Name * * @var string */ const OID_NAME = 'dhKeyAgreement'; /** * OID Value * * @var string */ const OID_VALUE = '1.2.840.113549.1.3.1'; /** * Child OIDs loaded * * @var bool */ protected static $childOIDsLoaded = false; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } $isPublic = strpos($key, 'PUBLIC') !== false; $key = parent::load($key, $password); $type = isset($key['privateKey']) ? 'privateKey' : 'publicKey'; switch (true) { case !$isPublic && $type == 'publicKey': throw new \UnexpectedValueException('Human readable string claims non-public key but DER encoded string claims public key'); case $isPublic && $type == 'privateKey': throw new \UnexpectedValueException('Human readable string claims public key but DER encoded string claims private key'); } $decoded = ASN1::decodeBER($key[$type . 'Algorithm']['parameters']->element); if (empty($decoded)) { throw new \RuntimeException('Unable to decode BER of parameters'); } $components = ASN1::asn1map($decoded[0], Maps\DHParameter::MAP); if (!is_array($components)) { throw new \RuntimeException('Unable to perform ASN1 mapping on parameters'); } $decoded = ASN1::decodeBER($key[$type]); switch (true) { case !isset($decoded): case !isset($decoded[0]['content']): case !$decoded[0]['content'] instanceof BigInteger: throw new \RuntimeException('Unable to decode BER of parameters'); } $components[$type] = $decoded[0]['content']; return $components; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $prime * @param \phpseclib3\Math\BigInteger $base * @param \phpseclib3\Math\BigInteger $privateKey * @param \phpseclib3\Math\BigInteger $publicKey * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $prime, BigInteger $base, BigInteger $privateKey, BigInteger $publicKey, $password = '', array $options = []) { $params = [ 'prime' => $prime, 'base' => $base ]; $params = ASN1::encodeDER($params, Maps\DHParameter::MAP); $params = new ASN1\Element($params); $key = ASN1::encodeDER($privateKey, ['type' => ASN1::TYPE_INTEGER]); return self::wrapPrivateKey($key, [], $params, $password, null, '', $options); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $prime * @param \phpseclib3\Math\BigInteger $base * @param \phpseclib3\Math\BigInteger $publicKey * @param array $options optional * @return string */ public static function savePublicKey(BigInteger $prime, BigInteger $base, BigInteger $publicKey, array $options = []) { $params = [ 'prime' => $prime, 'base' => $base ]; $params = ASN1::encodeDER($params, Maps\DHParameter::MAP); $params = new ASN1\Element($params); $key = ASN1::encodeDER($publicKey, ['type' => ASN1::TYPE_INTEGER]); return self::wrapPublicKey($key, $params); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DH; use phpseclib3\Crypt\Common; use phpseclib3\Crypt\DH; /** * DH Public Key * * @author Jim Wigginton */ class PublicKey extends DH { use Common\Traits\Fingerprint; /** * Returns the public key * * @param string $type * @param array $options optional * @return string */ public function toString($type, array $options = []) { $type = self::validatePlugin('Keys', $type, 'savePublicKey'); return $type::savePublicKey($this->prime, $this->base, $this->publicKey, $options); } /** * Returns the public key as a BigInteger * * @return \phpseclib3\Math\BigInteger */ public function toBigInteger() { return $this->publicKey; } } * getPublicKey(); * * $plaintext = 'terrafrost'; * * $signature = $private->sign($plaintext); * * echo $public->verify($plaintext, $signature) ? 'verified' : 'unverified'; * ?> * * * @author Jim Wigginton * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Crypt\Common\AsymmetricKey; use phpseclib3\Crypt\EC\BaseCurves\Montgomery as MontgomeryCurve; use phpseclib3\Crypt\EC\BaseCurves\TwistedEdwards as TwistedEdwardsCurve; use phpseclib3\Crypt\EC\Curves\Curve25519; use phpseclib3\Crypt\EC\Curves\Ed25519; use phpseclib3\Crypt\EC\Curves\Ed448; use phpseclib3\Crypt\EC\Formats\Keys\PKCS1; use phpseclib3\Crypt\EC\Parameters; use phpseclib3\Crypt\EC\PrivateKey; use phpseclib3\Crypt\EC\PublicKey; use phpseclib3\Exception\UnsupportedAlgorithmException; use phpseclib3\Exception\UnsupportedCurveException; use phpseclib3\Exception\UnsupportedOperationException; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps\ECParameters; use phpseclib3\Math\BigInteger; /** * Pure-PHP implementation of EC. * * @author Jim Wigginton */ abstract class EC extends AsymmetricKey { /** * Algorithm Name * * @var string */ const ALGORITHM = 'EC'; /** * Public Key QA * * @var object[] */ protected $QA; /** * Curve * * @var \phpseclib3\Crypt\EC\BaseCurves\Base */ protected $curve; /** * Signature Format * * @var string */ protected $format; /** * Signature Format (Short) * * @var string */ protected $shortFormat; /** * Curve Name * * @var string */ private $curveName; /** * Curve Order * * Used for deterministic ECDSA * * @var \phpseclib3\Math\BigInteger */ protected $q; /** * Alias for the private key * * Used for deterministic ECDSA. AsymmetricKey expects $x. I don't like x because * with x you have x * the base point yielding an (x, y)-coordinate that is the * public key. But the x is different depending on which side of the equal sign * you're on. It's less ambiguous if you do dA * base point = (x, y)-coordinate. * * @var \phpseclib3\Math\BigInteger */ protected $x; /** * Context * * @var string */ protected $context; /** * Signature Format * * @var string */ protected $sigFormat; /** * Create public / private key pair. * * @param string $curve * @return \phpseclib3\Crypt\EC\PrivateKey */ public static function createKey($curve) { self::initialize_static_variables(); if (!isset(self::$engines['PHP'])) { self::useBestEngine(); } $curve = strtolower($curve); if (self::$engines['libsodium'] && $curve == 'ed25519' && function_exists('sodium_crypto_sign_keypair')) { $kp = sodium_crypto_sign_keypair(); $privatekey = EC::loadFormat('libsodium', sodium_crypto_sign_secretkey($kp)); //$publickey = EC::loadFormat('libsodium', sodium_crypto_sign_publickey($kp)); $privatekey->curveName = 'Ed25519'; //$publickey->curveName = $curve; return $privatekey; } $privatekey = new PrivateKey(); $curveName = $curve; if (preg_match('#(?:^curve|^ed)\d+$#', $curveName)) { $curveName = ucfirst($curveName); } elseif (substr($curveName, 0, 10) == 'brainpoolp') { $curveName = 'brainpoolP' . substr($curveName, 10); } $curve = '\phpseclib3\Crypt\EC\Curves\\' . $curveName; if (!class_exists($curve)) { throw new UnsupportedCurveException('Named Curve of ' . $curveName . ' is not supported'); } $reflect = new \ReflectionClass($curve); $curveName = $reflect->isFinal() ? $reflect->getParentClass()->getShortName() : $reflect->getShortName(); $curve = new $curve(); if ($curve instanceof TwistedEdwardsCurve) { $arr = $curve->extractSecret(Random::string($curve instanceof Ed448 ? 57 : 32)); $privatekey->dA = $dA = $arr['dA']; $privatekey->secret = $arr['secret']; } else { $privatekey->dA = $dA = $curve->createRandomMultiplier(); } if ($curve instanceof Curve25519 && self::$engines['libsodium']) { //$r = pack('H*', '0900000000000000000000000000000000000000000000000000000000000000'); //$QA = sodium_crypto_scalarmult($dA->toBytes(), $r); $QA = sodium_crypto_box_publickey_from_secretkey($dA->toBytes()); $privatekey->QA = [$curve->convertInteger(new BigInteger(strrev($QA), 256))]; } else { $privatekey->QA = $curve->multiplyPoint($curve->getBasePoint(), $dA); } $privatekey->curve = $curve; //$publickey = clone $privatekey; //unset($publickey->dA); //unset($publickey->x); $privatekey->curveName = $curveName; //$publickey->curveName = $curveName; if ($privatekey->curve instanceof TwistedEdwardsCurve) { return $privatekey->withHash($curve::HASH); } return $privatekey; } /** * OnLoad Handler * * @return bool */ protected static function onLoad(array $components) { if (!isset(self::$engines['PHP'])) { self::useBestEngine(); } if (!isset($components['dA']) && !isset($components['QA'])) { $new = new Parameters(); $new->curve = $components['curve']; return $new; } $new = isset($components['dA']) ? new PrivateKey() : new PublicKey(); $new->curve = $components['curve']; $new->QA = $components['QA']; if (isset($components['dA'])) { $new->dA = $components['dA']; $new->secret = $components['secret']; } if ($new->curve instanceof TwistedEdwardsCurve) { return $new->withHash($components['curve']::HASH); } return $new; } /** * Constructor * * PublicKey and PrivateKey objects can only be created from abstract RSA class */ protected function __construct() { $this->sigFormat = self::validatePlugin('Signature', 'ASN1'); $this->shortFormat = 'ASN1'; parent::__construct(); } /** * Returns the curve * * Returns a string if it's a named curve, an array if not * * @return string|array */ public function getCurve() { if ($this->curveName) { return $this->curveName; } if ($this->curve instanceof MontgomeryCurve) { $this->curveName = $this->curve instanceof Curve25519 ? 'Curve25519' : 'Curve448'; return $this->curveName; } if ($this->curve instanceof TwistedEdwardsCurve) { $this->curveName = $this->curve instanceof Ed25519 ? 'Ed25519' : 'Ed448'; return $this->curveName; } $params = $this->getParameters()->toString('PKCS8', ['namedCurve' => true]); $decoded = ASN1::extractBER($params); $decoded = ASN1::decodeBER($decoded); $decoded = ASN1::asn1map($decoded[0], ECParameters::MAP); if (isset($decoded['namedCurve'])) { $this->curveName = $decoded['namedCurve']; return $decoded['namedCurve']; } if (!$namedCurves) { PKCS1::useSpecifiedCurve(); } return $decoded; } /** * Returns the key size * * Quoting https://tools.ietf.org/html/rfc5656#section-2, * * "The size of a set of elliptic curve domain parameters on a prime * curve is defined as the number of bits in the binary representation * of the field order, commonly denoted by p. Size on a * characteristic-2 curve is defined as the number of bits in the binary * representation of the field, commonly denoted by m. A set of * elliptic curve domain parameters defines a group of order n generated * by a base point P" * * @return int */ public function getLength() { return $this->curve->getLength(); } /** * Returns the current engine being used * * @see self::useInternalEngine() * @see self::useBestEngine() * @return string */ public function getEngine() { if (!isset(self::$engines['PHP'])) { self::useBestEngine(); } if ($this->curve instanceof TwistedEdwardsCurve) { return $this->curve instanceof Ed25519 && self::$engines['libsodium'] && !isset($this->context) ? 'libsodium' : 'PHP'; } return self::$engines['OpenSSL'] && in_array($this->hash->getHash(), openssl_get_md_methods()) ? 'OpenSSL' : 'PHP'; } /** * Returns the public key coordinates as a string * * Used by ECDH * * @return string */ public function getEncodedCoordinates() { if ($this->curve instanceof MontgomeryCurve) { return strrev($this->QA[0]->toBytes(true)); } if ($this->curve instanceof TwistedEdwardsCurve) { return $this->curve->encodePoint($this->QA); } return "\4" . $this->QA[0]->toBytes(true) . $this->QA[1]->toBytes(true); } /** * Returns the parameters * * @see self::getPublicKey() * @param string $type optional * @return mixed */ public function getParameters($type = 'PKCS1') { $type = self::validatePlugin('Keys', $type, 'saveParameters'); $key = $type::saveParameters($this->curve); return EC::load($key, 'PKCS1') ->withHash($this->hash->getHash()) ->withSignatureFormat($this->shortFormat); } /** * Determines the signature padding mode * * Valid values are: ASN1, SSH2, Raw * * @param string $format */ public function withSignatureFormat($format) { if ($this->curve instanceof MontgomeryCurve) { throw new UnsupportedOperationException('Montgomery Curves cannot be used to create signatures'); } $new = clone $this; $new->shortFormat = $format; $new->sigFormat = self::validatePlugin('Signature', $format); return $new; } /** * Returns the signature format currently being used * */ public function getSignatureFormat() { return $this->shortFormat; } /** * Sets the context * * Used by Ed25519 / Ed448. * * @see self::sign() * @see self::verify() * @param string $context optional */ public function withContext($context = null) { if (!$this->curve instanceof TwistedEdwardsCurve) { throw new UnsupportedCurveException('Only Ed25519 and Ed448 support contexts'); } $new = clone $this; if (!isset($context)) { $new->context = null; return $new; } if (!is_string($context)) { throw new \InvalidArgumentException('setContext expects a string'); } if (strlen($context) > 255) { throw new \LengthException('The context is supposed to be, at most, 255 bytes long'); } $new->context = $context; return $new; } /** * Returns the signature format currently being used * */ public function getContext() { return $this->context; } /** * Determines which hashing function should be used * * @param string $hash */ public function withHash($hash) { if ($this->curve instanceof MontgomeryCurve) { throw new UnsupportedOperationException('Montgomery Curves cannot be used to create signatures'); } if ($this->curve instanceof Ed25519 && $hash != 'sha512') { throw new UnsupportedAlgorithmException('Ed25519 only supports sha512 as a hash'); } if ($this->curve instanceof Ed448 && $hash != 'shake256-912') { throw new UnsupportedAlgorithmException('Ed448 only supports shake256 with a length of 114 bytes'); } return parent::withHash($hash); } /** * __toString() magic method * * @return string */ public function __toString() { if ($this->curve instanceof MontgomeryCurve) { return ''; } return parent::__toString(); } } * setKey('abcdefghijklmnop'); * * $size = 10 * 1024; * $plaintext = ''; * for ($i = 0; $i < $size; $i++) { * $plaintext.= 'a'; * } * * echo $rijndael->decrypt($rijndael->encrypt($plaintext)); * ?> * * * @author Jim Wigginton * @copyright 2008 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\BlockCipher; use phpseclib3\Exception\BadDecryptionException; use phpseclib3\Exception\BadModeException; use phpseclib3\Exception\InconsistentSetupException; use phpseclib3\Exception\InsufficientSetupException; /** * Pure-PHP implementation of Rijndael. * * @author Jim Wigginton */ class Rijndael extends BlockCipher { /** * The mcrypt specific name of the cipher * * Mcrypt is useable for 128/192/256-bit $block_size/$key_length. For 160/224 not. * \phpseclib3\Crypt\Rijndael determines automatically whether mcrypt is useable * or not for the current $block_size/$key_length. * In case of, $cipher_name_mcrypt will be set dynamically at run time accordingly. * * @see \phpseclib3\Crypt\Common\SymmetricKey::cipher_name_mcrypt * @see \phpseclib3\Crypt\Common\SymmetricKey::engine * @see self::isValidEngine() * @var string */ protected $cipher_name_mcrypt = 'rijndael-128'; /** * The Key Schedule * * @see self::setup() * @var array */ private $w; /** * The Inverse Key Schedule * * @see self::setup() * @var array */ private $dw; /** * The Block Length divided by 32 * * {@internal The max value is 256 / 32 = 8, the min value is 128 / 32 = 4. Exists in conjunction with $block_size * because the encryption / decryption / key schedule creation requires this number and not $block_size. We could * derive this from $block_size or vice versa, but that'd mean we'd have to do multiple shift operations, so in lieu * of that, we'll just precompute it once.} * * @see self::setBlockLength() * @var int */ private $Nb = 4; /** * The Key Length (in bytes) * * {@internal The max value is 256 / 8 = 32, the min value is 128 / 8 = 16. Exists in conjunction with $Nk * because the encryption / decryption / key schedule creation requires this number and not $key_length. We could * derive this from $key_length or vice versa, but that'd mean we'd have to do multiple shift operations, so in lieu * of that, we'll just precompute it once.} * * @see self::setKeyLength() * @var int */ protected $key_length = 16; /** * The Key Length divided by 32 * * @see self::setKeyLength() * @var int * @internal The max value is 256 / 32 = 8, the min value is 128 / 32 = 4 */ private $Nk = 4; /** * The Number of Rounds * * {@internal The max value is 14, the min value is 10.} * * @var int */ private $Nr; /** * Shift offsets * * @var array */ private $c; /** * Holds the last used key- and block_size information * * @var array */ private $kl; /** * Default Constructor. * * @param string $mode * @throws \InvalidArgumentException if an invalid / unsupported mode is provided */ public function __construct($mode) { parent::__construct($mode); if ($this->mode == self::MODE_STREAM) { throw new BadModeException('Block ciphers cannot be ran in stream mode'); } } /** * Sets the key length. * * Valid key lengths are 128, 160, 192, 224, and 256. * * Note: phpseclib extends Rijndael (and AES) for using 160- and 224-bit keys but they are officially not defined * and the most (if not all) implementations are not able using 160/224-bit keys but round/pad them up to * 192/256 bits as, for example, mcrypt will do. * * That said, if you want be compatible with other Rijndael and AES implementations, * you should not setKeyLength(160) or setKeyLength(224). * * Additional: In case of 160- and 224-bit keys, phpseclib will/can, for that reason, not use * the mcrypt php extension, even if available. * This results then in slower encryption. * * @throws \LengthException if the key length is invalid * @param int $length */ public function setKeyLength($length) { switch ($length) { case 128: case 160: case 192: case 224: case 256: $this->key_length = $length >> 3; break; default: throw new \LengthException('Key size of ' . $length . ' bits is not supported by this algorithm. Only keys of sizes 128, 160, 192, 224 or 256 bits are supported'); } parent::setKeyLength($length); } /** * Sets the key. * * Rijndael supports five different key lengths * * @see setKeyLength() * @param string $key * @throws \LengthException if the key length isn't supported */ public function setKey($key) { switch (strlen($key)) { case 16: case 20: case 24: case 28: case 32: break; default: throw new \LengthException('Key of size ' . strlen($key) . ' not supported by this algorithm. Only keys of sizes 16, 20, 24, 28 or 32 are supported'); } parent::setKey($key); } /** * Sets the block length * * Valid block lengths are 128, 160, 192, 224, and 256. * * @param int $length */ public function setBlockLength($length) { switch ($length) { case 128: case 160: case 192: case 224: case 256: break; default: throw new \LengthException('Key size of ' . $length . ' bits is not supported by this algorithm. Only keys of sizes 128, 160, 192, 224 or 256 bits are supported'); } $this->Nb = $length >> 5; $this->block_size = $length >> 3; $this->changed = $this->nonIVChanged = true; $this->setEngine(); } /** * Test for engine validity * * This is mainly just a wrapper to set things up for \phpseclib3\Crypt\Common\SymmetricKey::isValidEngine() * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() * @param int $engine * @return bool */ protected function isValidEngineHelper($engine) { switch ($engine) { case self::ENGINE_LIBSODIUM: return function_exists('sodium_crypto_aead_aes256gcm_is_available') && sodium_crypto_aead_aes256gcm_is_available() && $this->mode == self::MODE_GCM && $this->key_length == 32 && $this->nonce && strlen($this->nonce) == 12 && $this->block_size == 16; case self::ENGINE_OPENSSL_GCM: if (!extension_loaded('openssl')) { return false; } $methods = openssl_get_cipher_methods(); return $this->mode == self::MODE_GCM && version_compare(PHP_VERSION, '7.1.0', '>=') && in_array('aes-' . $this->getKeyLength() . '-gcm', $methods) && $this->block_size == 16; case self::ENGINE_OPENSSL: if ($this->block_size != 16) { return false; } $this->cipher_name_openssl_ecb = 'aes-' . ($this->key_length << 3) . '-ecb'; $this->cipher_name_openssl = 'aes-' . ($this->key_length << 3) . '-' . $this->openssl_translate_mode(); break; case self::ENGINE_MCRYPT: $this->cipher_name_mcrypt = 'rijndael-' . ($this->block_size << 3); if ($this->key_length % 8) { // is it a 160/224-bit key? // mcrypt is not usable for them, only for 128/192/256-bit keys return false; } } return parent::isValidEngineHelper($engine); } /** * Encrypts a block * * @param string $in * @return string */ protected function encryptBlock($in) { static $tables; if (empty($tables)) { $tables = &$this->getTables(); } $t0 = $tables[0]; $t1 = $tables[1]; $t2 = $tables[2]; $t3 = $tables[3]; $sbox = $tables[4]; $state = []; $words = unpack('N*', $in); $c = $this->c; $w = $this->w; $Nb = $this->Nb; $Nr = $this->Nr; // addRoundKey $wc = $Nb - 1; foreach ($words as $word) { $state[] = $word ^ $w[++$wc]; } // fips-197.pdf#page=19, "Figure 5. Pseudo Code for the Cipher", states that this loop has four components - // subBytes, shiftRows, mixColumns, and addRoundKey. fips-197.pdf#page=30, "Implementation Suggestions Regarding // Various Platforms" suggests that performs enhanced implementations are described in Rijndael-ammended.pdf. // Rijndael-ammended.pdf#page=20, "Implementation aspects / 32-bit processor", discusses such an optimization. // Unfortunately, the description given there is not quite correct. Per aes.spec.v316.pdf#page=19 [1], // equation (7.4.7) is supposed to use addition instead of subtraction, so we'll do that here, as well. // [1] http://fp.gladman.plus.com/cryptography_technology/rijndael/aes.spec.v316.pdf $temp = []; for ($round = 1; $round < $Nr; ++$round) { $i = 0; // $c[0] == 0 $j = $c[1]; $k = $c[2]; $l = $c[3]; while ($i < $Nb) { $temp[$i] = $t0[$state[$i] >> 24 & 0x000000FF] ^ $t1[$state[$j] >> 16 & 0x000000FF] ^ $t2[$state[$k] >> 8 & 0x000000FF] ^ $t3[$state[$l] & 0x000000FF] ^ $w[++$wc]; ++$i; $j = ($j + 1) % $Nb; $k = ($k + 1) % $Nb; $l = ($l + 1) % $Nb; } $state = $temp; } // subWord for ($i = 0; $i < $Nb; ++$i) { $state[$i] = $sbox[$state[$i] & 0x000000FF] | ($sbox[$state[$i] >> 8 & 0x000000FF] << 8) | ($sbox[$state[$i] >> 16 & 0x000000FF] << 16) | ($sbox[$state[$i] >> 24 & 0x000000FF] << 24); } // shiftRows + addRoundKey $i = 0; // $c[0] == 0 $j = $c[1]; $k = $c[2]; $l = $c[3]; while ($i < $Nb) { $temp[$i] = ($state[$i] & intval(0xFF000000)) ^ ($state[$j] & 0x00FF0000) ^ ($state[$k] & 0x0000FF00) ^ ($state[$l] & 0x000000FF) ^ $w[$i]; ++$i; $j = ($j + 1) % $Nb; $k = ($k + 1) % $Nb; $l = ($l + 1) % $Nb; } return pack('N*', ...$temp); } /** * Decrypts a block * * @param string $in * @return string */ protected function decryptBlock($in) { static $invtables; if (empty($invtables)) { $invtables = &$this->getInvTables(); } $dt0 = $invtables[0]; $dt1 = $invtables[1]; $dt2 = $invtables[2]; $dt3 = $invtables[3]; $isbox = $invtables[4]; $state = []; $words = unpack('N*', $in); $c = $this->c; $dw = $this->dw; $Nb = $this->Nb; $Nr = $this->Nr; // addRoundKey $wc = $Nb - 1; foreach ($words as $word) { $state[] = $word ^ $dw[++$wc]; } $temp = []; for ($round = $Nr - 1; $round > 0; --$round) { $i = 0; // $c[0] == 0 $j = $Nb - $c[1]; $k = $Nb - $c[2]; $l = $Nb - $c[3]; while ($i < $Nb) { $temp[$i] = $dt0[$state[$i] >> 24 & 0x000000FF] ^ $dt1[$state[$j] >> 16 & 0x000000FF] ^ $dt2[$state[$k] >> 8 & 0x000000FF] ^ $dt3[$state[$l] & 0x000000FF] ^ $dw[++$wc]; ++$i; $j = ($j + 1) % $Nb; $k = ($k + 1) % $Nb; $l = ($l + 1) % $Nb; } $state = $temp; } // invShiftRows + invSubWord + addRoundKey $i = 0; // $c[0] == 0 $j = $Nb - $c[1]; $k = $Nb - $c[2]; $l = $Nb - $c[3]; while ($i < $Nb) { $word = ($state[$i] & intval(0xFF000000)) | ($state[$j] & 0x00FF0000) | ($state[$k] & 0x0000FF00) | ($state[$l] & 0x000000FF); $temp[$i] = $dw[$i] ^ ($isbox[$word & 0x000000FF] | ($isbox[$word >> 8 & 0x000000FF] << 8) | ($isbox[$word >> 16 & 0x000000FF] << 16) | ($isbox[$word >> 24 & 0x000000FF] << 24)); ++$i; $j = ($j + 1) % $Nb; $k = ($k + 1) % $Nb; $l = ($l + 1) % $Nb; } return pack('N*', ...$temp); } /** * Setup the self::ENGINE_INTERNAL $engine * * (re)init, if necessary, the internal cipher $engine and flush all $buffers * Used (only) if $engine == self::ENGINE_INTERNAL * * _setup() will be called each time if $changed === true * typically this happens when using one or more of following public methods: * * - setKey() * * - setIV() * * - disableContinuousBuffer() * * - First run of encrypt() / decrypt() with no init-settings * * {@internal setup() is always called before en/decryption.} * * {@internal Could, but not must, extend by the child Crypt_* class} * * @see self::setKey() * @see self::setIV() * @see self::disableContinuousBuffer() */ protected function setup() { if (!$this->changed) { return; } parent::setup(); if (is_string($this->iv) && strlen($this->iv) != $this->block_size) { throw new InconsistentSetupException('The IV length (' . strlen($this->iv) . ') does not match the block size (' . $this->block_size . ')'); } } /** * Setup the key (expansion) * * @see \phpseclib3\Crypt\Common\SymmetricKey::setupKey() */ protected function setupKey() { // Each number in $rcon is equal to the previous number multiplied by two in Rijndael's finite field. // See http://en.wikipedia.org/wiki/Finite_field_arithmetic#Multiplicative_inverse static $rcon; if (!isset($rcon)) { $rcon = [0, 0x01000000, 0x02000000, 0x04000000, 0x08000000, 0x10000000, 0x20000000, 0x40000000, 0x80000000, 0x1B000000, 0x36000000, 0x6C000000, 0xD8000000, 0xAB000000, 0x4D000000, 0x9A000000, 0x2F000000, 0x5E000000, 0xBC000000, 0x63000000, 0xC6000000, 0x97000000, 0x35000000, 0x6A000000, 0xD4000000, 0xB3000000, 0x7D000000, 0xFA000000, 0xEF000000, 0xC5000000, 0x91000000 ]; $rcon = array_map('intval', $rcon); } if (isset($this->kl['key']) && $this->key === $this->kl['key'] && $this->key_length === $this->kl['key_length'] && $this->block_size === $this->kl['block_size']) { // already expanded return; } $this->kl = ['key' => $this->key, 'key_length' => $this->key_length, 'block_size' => $this->block_size]; $this->Nk = $this->key_length >> 2; // see Rijndael-ammended.pdf#page=44 $this->Nr = max($this->Nk, $this->Nb) + 6; // shift offsets for Nb = 5, 7 are defined in Rijndael-ammended.pdf#page=44, // "Table 8: Shift offsets in Shiftrow for the alternative block lengths" // shift offsets for Nb = 4, 6, 8 are defined in Rijndael-ammended.pdf#page=14, // "Table 2: Shift offsets for different block lengths" switch ($this->Nb) { case 4: case 5: case 6: $this->c = [0, 1, 2, 3]; break; case 7: $this->c = [0, 1, 2, 4]; break; case 8: $this->c = [0, 1, 3, 4]; } $w = array_values(unpack('N*words', $this->key)); $length = $this->Nb * ($this->Nr + 1); for ($i = $this->Nk; $i < $length; $i++) { $temp = $w[$i - 1]; if ($i % $this->Nk == 0) { // according to , "the size of an integer is platform-dependent". // on a 32-bit machine, it's 32-bits, and on a 64-bit machine, it's 64-bits. on a 32-bit machine, // 0xFFFFFFFF << 8 == 0xFFFFFF00, but on a 64-bit machine, it equals 0xFFFFFFFF00. as such, doing 'and' // with 0xFFFFFFFF (or 0xFFFFFF00) on a 32-bit machine is unnecessary, but on a 64-bit machine, it is. $temp = (($temp << 8) & intval(0xFFFFFF00)) | (($temp >> 24) & 0x000000FF); // rotWord $temp = $this->subWord($temp) ^ $rcon[$i / $this->Nk]; } elseif ($this->Nk > 6 && $i % $this->Nk == 4) { $temp = $this->subWord($temp); } $w[$i] = $w[$i - $this->Nk] ^ $temp; } // convert the key schedule from a vector of $Nb * ($Nr + 1) length to a matrix with $Nr + 1 rows and $Nb columns // and generate the inverse key schedule. more specifically, // according to (section 5.3.3), // "The key expansion for the Inverse Cipher is defined as follows: // 1. Apply the Key Expansion. // 2. Apply InvMixColumn to all Round Keys except the first and the last one." // also, see fips-197.pdf#page=27, "5.3.5 Equivalent Inverse Cipher" list($dt0, $dt1, $dt2, $dt3) = $this->getInvTables(); $temp = $this->w = $this->dw = []; for ($i = $row = $col = 0; $i < $length; $i++, $col++) { if ($col == $this->Nb) { if ($row == 0) { $this->dw[0] = $this->w[0]; } else { // subWord + invMixColumn + invSubWord = invMixColumn $j = 0; while ($j < $this->Nb) { $dw = $this->subWord($this->w[$row][$j]); $temp[$j] = $dt0[$dw >> 24 & 0x000000FF] ^ $dt1[$dw >> 16 & 0x000000FF] ^ $dt2[$dw >> 8 & 0x000000FF] ^ $dt3[$dw & 0x000000FF]; $j++; } $this->dw[$row] = $temp; } $col = 0; $row++; } $this->w[$row][$col] = $w[$i]; } $this->dw[$row] = $this->w[$row]; // Converting to 1-dim key arrays (both ascending) $this->dw = array_reverse($this->dw); $w = array_pop($this->w); $dw = array_pop($this->dw); foreach ($this->w as $r => $wr) { foreach ($wr as $c => $wc) { $w[] = $wc; $dw[] = $this->dw[$r][$c]; } } $this->w = $w; $this->dw = $dw; } /** * Performs S-Box substitutions * * @return array * @param int $word */ private function subWord($word) { static $sbox; if (empty($sbox)) { list(, , , , $sbox) = self::getTables(); } return $sbox[$word & 0x000000FF] | ($sbox[$word >> 8 & 0x000000FF] << 8) | ($sbox[$word >> 16 & 0x000000FF] << 16) | ($sbox[$word >> 24 & 0x000000FF] << 24); } /** * Provides the mixColumns and sboxes tables * * @see self::encryptBlock() * @see self::setupInlineCrypt() * @see self::subWord() * @return array &$tables */ protected function &getTables() { static $tables; if (empty($tables)) { // according to (section 5.2.1), // precomputed tables can be used in the mixColumns phase. in that example, they're assigned t0...t3, so // those are the names we'll use. $t3 = array_map('intval', [ // with array_map('intval', ...) we ensure we have only int's and not // some slower floats converted by php automatically on high values 0x6363A5C6, 0x7C7C84F8, 0x777799EE, 0x7B7B8DF6, 0xF2F20DFF, 0x6B6BBDD6, 0x6F6FB1DE, 0xC5C55491, 0x30305060, 0x01010302, 0x6767A9CE, 0x2B2B7D56, 0xFEFE19E7, 0xD7D762B5, 0xABABE64D, 0x76769AEC, 0xCACA458F, 0x82829D1F, 0xC9C94089, 0x7D7D87FA, 0xFAFA15EF, 0x5959EBB2, 0x4747C98E, 0xF0F00BFB, 0xADADEC41, 0xD4D467B3, 0xA2A2FD5F, 0xAFAFEA45, 0x9C9CBF23, 0xA4A4F753, 0x727296E4, 0xC0C05B9B, 0xB7B7C275, 0xFDFD1CE1, 0x9393AE3D, 0x26266A4C, 0x36365A6C, 0x3F3F417E, 0xF7F702F5, 0xCCCC4F83, 0x34345C68, 0xA5A5F451, 0xE5E534D1, 0xF1F108F9, 0x717193E2, 0xD8D873AB, 0x31315362, 0x15153F2A, 0x04040C08, 0xC7C75295, 0x23236546, 0xC3C35E9D, 0x18182830, 0x9696A137, 0x05050F0A, 0x9A9AB52F, 0x0707090E, 0x12123624, 0x80809B1B, 0xE2E23DDF, 0xEBEB26CD, 0x2727694E, 0xB2B2CD7F, 0x75759FEA, 0x09091B12, 0x83839E1D, 0x2C2C7458, 0x1A1A2E34, 0x1B1B2D36, 0x6E6EB2DC, 0x5A5AEEB4, 0xA0A0FB5B, 0x5252F6A4, 0x3B3B4D76, 0xD6D661B7, 0xB3B3CE7D, 0x29297B52, 0xE3E33EDD, 0x2F2F715E, 0x84849713, 0x5353F5A6, 0xD1D168B9, 0x00000000, 0xEDED2CC1, 0x20206040, 0xFCFC1FE3, 0xB1B1C879, 0x5B5BEDB6, 0x6A6ABED4, 0xCBCB468D, 0xBEBED967, 0x39394B72, 0x4A4ADE94, 0x4C4CD498, 0x5858E8B0, 0xCFCF4A85, 0xD0D06BBB, 0xEFEF2AC5, 0xAAAAE54F, 0xFBFB16ED, 0x4343C586, 0x4D4DD79A, 0x33335566, 0x85859411, 0x4545CF8A, 0xF9F910E9, 0x02020604, 0x7F7F81FE, 0x5050F0A0, 0x3C3C4478, 0x9F9FBA25, 0xA8A8E34B, 0x5151F3A2, 0xA3A3FE5D, 0x4040C080, 0x8F8F8A05, 0x9292AD3F, 0x9D9DBC21, 0x38384870, 0xF5F504F1, 0xBCBCDF63, 0xB6B6C177, 0xDADA75AF, 0x21216342, 0x10103020, 0xFFFF1AE5, 0xF3F30EFD, 0xD2D26DBF, 0xCDCD4C81, 0x0C0C1418, 0x13133526, 0xECEC2FC3, 0x5F5FE1BE, 0x9797A235, 0x4444CC88, 0x1717392E, 0xC4C45793, 0xA7A7F255, 0x7E7E82FC, 0x3D3D477A, 0x6464ACC8, 0x5D5DE7BA, 0x19192B32, 0x737395E6, 0x6060A0C0, 0x81819819, 0x4F4FD19E, 0xDCDC7FA3, 0x22226644, 0x2A2A7E54, 0x9090AB3B, 0x8888830B, 0x4646CA8C, 0xEEEE29C7, 0xB8B8D36B, 0x14143C28, 0xDEDE79A7, 0x5E5EE2BC, 0x0B0B1D16, 0xDBDB76AD, 0xE0E03BDB, 0x32325664, 0x3A3A4E74, 0x0A0A1E14, 0x4949DB92, 0x06060A0C, 0x24246C48, 0x5C5CE4B8, 0xC2C25D9F, 0xD3D36EBD, 0xACACEF43, 0x6262A6C4, 0x9191A839, 0x9595A431, 0xE4E437D3, 0x79798BF2, 0xE7E732D5, 0xC8C8438B, 0x3737596E, 0x6D6DB7DA, 0x8D8D8C01, 0xD5D564B1, 0x4E4ED29C, 0xA9A9E049, 0x6C6CB4D8, 0x5656FAAC, 0xF4F407F3, 0xEAEA25CF, 0x6565AFCA, 0x7A7A8EF4, 0xAEAEE947, 0x08081810, 0xBABAD56F, 0x787888F0, 0x25256F4A, 0x2E2E725C, 0x1C1C2438, 0xA6A6F157, 0xB4B4C773, 0xC6C65197, 0xE8E823CB, 0xDDDD7CA1, 0x74749CE8, 0x1F1F213E, 0x4B4BDD96, 0xBDBDDC61, 0x8B8B860D, 0x8A8A850F, 0x707090E0, 0x3E3E427C, 0xB5B5C471, 0x6666AACC, 0x4848D890, 0x03030506, 0xF6F601F7, 0x0E0E121C, 0x6161A3C2, 0x35355F6A, 0x5757F9AE, 0xB9B9D069, 0x86869117, 0xC1C15899, 0x1D1D273A, 0x9E9EB927, 0xE1E138D9, 0xF8F813EB, 0x9898B32B, 0x11113322, 0x6969BBD2, 0xD9D970A9, 0x8E8E8907, 0x9494A733, 0x9B9BB62D, 0x1E1E223C, 0x87879215, 0xE9E920C9, 0xCECE4987, 0x5555FFAA, 0x28287850, 0xDFDF7AA5, 0x8C8C8F03, 0xA1A1F859, 0x89898009, 0x0D0D171A, 0xBFBFDA65, 0xE6E631D7, 0x4242C684, 0x6868B8D0, 0x4141C382, 0x9999B029, 0x2D2D775A, 0x0F0F111E, 0xB0B0CB7B, 0x5454FCA8, 0xBBBBD66D, 0x16163A2C ]); foreach ($t3 as $t3i) { $t0[] = (($t3i << 24) & intval(0xFF000000)) | (($t3i >> 8) & 0x00FFFFFF); $t1[] = (($t3i << 16) & intval(0xFFFF0000)) | (($t3i >> 16) & 0x0000FFFF); $t2[] = (($t3i << 8) & intval(0xFFFFFF00)) | (($t3i >> 24) & 0x000000FF); } $tables = [ // The Precomputed mixColumns tables t0 - t3 $t0, $t1, $t2, $t3, // The SubByte S-Box [ 0x63, 0x7C, 0x77, 0x7B, 0xF2, 0x6B, 0x6F, 0xC5, 0x30, 0x01, 0x67, 0x2B, 0xFE, 0xD7, 0xAB, 0x76, 0xCA, 0x82, 0xC9, 0x7D, 0xFA, 0x59, 0x47, 0xF0, 0xAD, 0xD4, 0xA2, 0xAF, 0x9C, 0xA4, 0x72, 0xC0, 0xB7, 0xFD, 0x93, 0x26, 0x36, 0x3F, 0xF7, 0xCC, 0x34, 0xA5, 0xE5, 0xF1, 0x71, 0xD8, 0x31, 0x15, 0x04, 0xC7, 0x23, 0xC3, 0x18, 0x96, 0x05, 0x9A, 0x07, 0x12, 0x80, 0xE2, 0xEB, 0x27, 0xB2, 0x75, 0x09, 0x83, 0x2C, 0x1A, 0x1B, 0x6E, 0x5A, 0xA0, 0x52, 0x3B, 0xD6, 0xB3, 0x29, 0xE3, 0x2F, 0x84, 0x53, 0xD1, 0x00, 0xED, 0x20, 0xFC, 0xB1, 0x5B, 0x6A, 0xCB, 0xBE, 0x39, 0x4A, 0x4C, 0x58, 0xCF, 0xD0, 0xEF, 0xAA, 0xFB, 0x43, 0x4D, 0x33, 0x85, 0x45, 0xF9, 0x02, 0x7F, 0x50, 0x3C, 0x9F, 0xA8, 0x51, 0xA3, 0x40, 0x8F, 0x92, 0x9D, 0x38, 0xF5, 0xBC, 0xB6, 0xDA, 0x21, 0x10, 0xFF, 0xF3, 0xD2, 0xCD, 0x0C, 0x13, 0xEC, 0x5F, 0x97, 0x44, 0x17, 0xC4, 0xA7, 0x7E, 0x3D, 0x64, 0x5D, 0x19, 0x73, 0x60, 0x81, 0x4F, 0xDC, 0x22, 0x2A, 0x90, 0x88, 0x46, 0xEE, 0xB8, 0x14, 0xDE, 0x5E, 0x0B, 0xDB, 0xE0, 0x32, 0x3A, 0x0A, 0x49, 0x06, 0x24, 0x5C, 0xC2, 0xD3, 0xAC, 0x62, 0x91, 0x95, 0xE4, 0x79, 0xE7, 0xC8, 0x37, 0x6D, 0x8D, 0xD5, 0x4E, 0xA9, 0x6C, 0x56, 0xF4, 0xEA, 0x65, 0x7A, 0xAE, 0x08, 0xBA, 0x78, 0x25, 0x2E, 0x1C, 0xA6, 0xB4, 0xC6, 0xE8, 0xDD, 0x74, 0x1F, 0x4B, 0xBD, 0x8B, 0x8A, 0x70, 0x3E, 0xB5, 0x66, 0x48, 0x03, 0xF6, 0x0E, 0x61, 0x35, 0x57, 0xB9, 0x86, 0xC1, 0x1D, 0x9E, 0xE1, 0xF8, 0x98, 0x11, 0x69, 0xD9, 0x8E, 0x94, 0x9B, 0x1E, 0x87, 0xE9, 0xCE, 0x55, 0x28, 0xDF, 0x8C, 0xA1, 0x89, 0x0D, 0xBF, 0xE6, 0x42, 0x68, 0x41, 0x99, 0x2D, 0x0F, 0xB0, 0x54, 0xBB, 0x16 ] ]; } return $tables; } /** * Provides the inverse mixColumns and inverse sboxes tables * * @see self::decryptBlock() * @see self::setupInlineCrypt() * @see self::setupKey() * @return array &$tables */ protected function &getInvTables() { static $tables; if (empty($tables)) { $dt3 = array_map('intval', [ 0xF4A75051, 0x4165537E, 0x17A4C31A, 0x275E963A, 0xAB6BCB3B, 0x9D45F11F, 0xFA58ABAC, 0xE303934B, 0x30FA5520, 0x766DF6AD, 0xCC769188, 0x024C25F5, 0xE5D7FC4F, 0x2ACBD7C5, 0x35448026, 0x62A38FB5, 0xB15A49DE, 0xBA1B6725, 0xEA0E9845, 0xFEC0E15D, 0x2F7502C3, 0x4CF01281, 0x4697A38D, 0xD3F9C66B, 0x8F5FE703, 0x929C9515, 0x6D7AEBBF, 0x5259DA95, 0xBE832DD4, 0x7421D358, 0xE0692949, 0xC9C8448E, 0xC2896A75, 0x8E7978F4, 0x583E6B99, 0xB971DD27, 0xE14FB6BE, 0x88AD17F0, 0x20AC66C9, 0xCE3AB47D, 0xDF4A1863, 0x1A3182E5, 0x51336097, 0x537F4562, 0x6477E0B1, 0x6BAE84BB, 0x81A01CFE, 0x082B94F9, 0x48685870, 0x45FD198F, 0xDE6C8794, 0x7BF8B752, 0x73D323AB, 0x4B02E272, 0x1F8F57E3, 0x55AB2A66, 0xEB2807B2, 0xB5C2032F, 0xC57B9A86, 0x3708A5D3, 0x2887F230, 0xBFA5B223, 0x036ABA02, 0x16825CED, 0xCF1C2B8A, 0x79B492A7, 0x07F2F0F3, 0x69E2A14E, 0xDAF4CD65, 0x05BED506, 0x34621FD1, 0xA6FE8AC4, 0x2E539D34, 0xF355A0A2, 0x8AE13205, 0xF6EB75A4, 0x83EC390B, 0x60EFAA40, 0x719F065E, 0x6E1051BD, 0x218AF93E, 0xDD063D96, 0x3E05AEDD, 0xE6BD464D, 0x548DB591, 0xC45D0571, 0x06D46F04, 0x5015FF60, 0x98FB2419, 0xBDE997D6, 0x4043CC89, 0xD99E7767, 0xE842BDB0, 0x898B8807, 0x195B38E7, 0xC8EEDB79, 0x7C0A47A1, 0x420FE97C, 0x841EC9F8, 0x00000000, 0x80868309, 0x2BED4832, 0x1170AC1E, 0x5A724E6C, 0x0EFFFBFD, 0x8538560F, 0xAED51E3D, 0x2D392736, 0x0FD9640A, 0x5CA62168, 0x5B54D19B, 0x362E3A24, 0x0A67B10C, 0x57E70F93, 0xEE96D2B4, 0x9B919E1B, 0xC0C54F80, 0xDC20A261, 0x774B695A, 0x121A161C, 0x93BA0AE2, 0xA02AE5C0, 0x22E0433C, 0x1B171D12, 0x090D0B0E, 0x8BC7ADF2, 0xB6A8B92D, 0x1EA9C814, 0xF1198557, 0x75074CAF, 0x99DDBBEE, 0x7F60FDA3, 0x01269FF7, 0x72F5BC5C, 0x663BC544, 0xFB7E345B, 0x4329768B, 0x23C6DCCB, 0xEDFC68B6, 0xE4F163B8, 0x31DCCAD7, 0x63851042, 0x97224013, 0xC6112084, 0x4A247D85, 0xBB3DF8D2, 0xF93211AE, 0x29A16DC7, 0x9E2F4B1D, 0xB230F3DC, 0x8652EC0D, 0xC1E3D077, 0xB3166C2B, 0x70B999A9, 0x9448FA11, 0xE9642247, 0xFC8CC4A8, 0xF03F1AA0, 0x7D2CD856, 0x3390EF22, 0x494EC787, 0x38D1C1D9, 0xCAA2FE8C, 0xD40B3698, 0xF581CFA6, 0x7ADE28A5, 0xB78E26DA, 0xADBFA43F, 0x3A9DE42C, 0x78920D50, 0x5FCC9B6A, 0x7E466254, 0x8D13C2F6, 0xD8B8E890, 0x39F75E2E, 0xC3AFF582, 0x5D80BE9F, 0xD0937C69, 0xD52DA96F, 0x2512B3CF, 0xAC993BC8, 0x187DA710, 0x9C636EE8, 0x3BBB7BDB, 0x267809CD, 0x5918F46E, 0x9AB701EC, 0x4F9AA883, 0x956E65E6, 0xFFE67EAA, 0xBCCF0821, 0x15E8E6EF, 0xE79BD9BA, 0x6F36CE4A, 0x9F09D4EA, 0xB07CD629, 0xA4B2AF31, 0x3F23312A, 0xA59430C6, 0xA266C035, 0x4EBC3774, 0x82CAA6FC, 0x90D0B0E0, 0xA7D81533, 0x04984AF1, 0xECDAF741, 0xCD500E7F, 0x91F62F17, 0x4DD68D76, 0xEFB04D43, 0xAA4D54CC, 0x9604DFE4, 0xD1B5E39E, 0x6A881B4C, 0x2C1FB8C1, 0x65517F46, 0x5EEA049D, 0x8C355D01, 0x877473FA, 0x0B412EFB, 0x671D5AB3, 0xDBD25292, 0x105633E9, 0xD647136D, 0xD7618C9A, 0xA10C7A37, 0xF8148E59, 0x133C89EB, 0xA927EECE, 0x61C935B7, 0x1CE5EDE1, 0x47B13C7A, 0xD2DF599C, 0xF2733F55, 0x14CE7918, 0xC737BF73, 0xF7CDEA53, 0xFDAA5B5F, 0x3D6F14DF, 0x44DB8678, 0xAFF381CA, 0x68C43EB9, 0x24342C38, 0xA3405FC2, 0x1DC37216, 0xE2250CBC, 0x3C498B28, 0x0D9541FF, 0xA8017139, 0x0CB3DE08, 0xB4E49CD8, 0x56C19064, 0xCB84617B, 0x32B670D5, 0x6C5C7448, 0xB85742D0 ]); foreach ($dt3 as $dt3i) { $dt0[] = (($dt3i << 24) & intval(0xFF000000)) | (($dt3i >> 8) & 0x00FFFFFF); $dt1[] = (($dt3i << 16) & intval(0xFFFF0000)) | (($dt3i >> 16) & 0x0000FFFF); $dt2[] = (($dt3i << 8) & intval(0xFFFFFF00)) | (($dt3i >> 24) & 0x000000FF); }; $tables = [ // The Precomputed inverse mixColumns tables dt0 - dt3 $dt0, $dt1, $dt2, $dt3, // The inverse SubByte S-Box [ 0x52, 0x09, 0x6A, 0xD5, 0x30, 0x36, 0xA5, 0x38, 0xBF, 0x40, 0xA3, 0x9E, 0x81, 0xF3, 0xD7, 0xFB, 0x7C, 0xE3, 0x39, 0x82, 0x9B, 0x2F, 0xFF, 0x87, 0x34, 0x8E, 0x43, 0x44, 0xC4, 0xDE, 0xE9, 0xCB, 0x54, 0x7B, 0x94, 0x32, 0xA6, 0xC2, 0x23, 0x3D, 0xEE, 0x4C, 0x95, 0x0B, 0x42, 0xFA, 0xC3, 0x4E, 0x08, 0x2E, 0xA1, 0x66, 0x28, 0xD9, 0x24, 0xB2, 0x76, 0x5B, 0xA2, 0x49, 0x6D, 0x8B, 0xD1, 0x25, 0x72, 0xF8, 0xF6, 0x64, 0x86, 0x68, 0x98, 0x16, 0xD4, 0xA4, 0x5C, 0xCC, 0x5D, 0x65, 0xB6, 0x92, 0x6C, 0x70, 0x48, 0x50, 0xFD, 0xED, 0xB9, 0xDA, 0x5E, 0x15, 0x46, 0x57, 0xA7, 0x8D, 0x9D, 0x84, 0x90, 0xD8, 0xAB, 0x00, 0x8C, 0xBC, 0xD3, 0x0A, 0xF7, 0xE4, 0x58, 0x05, 0xB8, 0xB3, 0x45, 0x06, 0xD0, 0x2C, 0x1E, 0x8F, 0xCA, 0x3F, 0x0F, 0x02, 0xC1, 0xAF, 0xBD, 0x03, 0x01, 0x13, 0x8A, 0x6B, 0x3A, 0x91, 0x11, 0x41, 0x4F, 0x67, 0xDC, 0xEA, 0x97, 0xF2, 0xCF, 0xCE, 0xF0, 0xB4, 0xE6, 0x73, 0x96, 0xAC, 0x74, 0x22, 0xE7, 0xAD, 0x35, 0x85, 0xE2, 0xF9, 0x37, 0xE8, 0x1C, 0x75, 0xDF, 0x6E, 0x47, 0xF1, 0x1A, 0x71, 0x1D, 0x29, 0xC5, 0x89, 0x6F, 0xB7, 0x62, 0x0E, 0xAA, 0x18, 0xBE, 0x1B, 0xFC, 0x56, 0x3E, 0x4B, 0xC6, 0xD2, 0x79, 0x20, 0x9A, 0xDB, 0xC0, 0xFE, 0x78, 0xCD, 0x5A, 0xF4, 0x1F, 0xDD, 0xA8, 0x33, 0x88, 0x07, 0xC7, 0x31, 0xB1, 0x12, 0x10, 0x59, 0x27, 0x80, 0xEC, 0x5F, 0x60, 0x51, 0x7F, 0xA9, 0x19, 0xB5, 0x4A, 0x0D, 0x2D, 0xE5, 0x7A, 0x9F, 0x93, 0xC9, 0x9C, 0xEF, 0xA0, 0xE0, 0x3B, 0x4D, 0xAE, 0x2A, 0xF5, 0xB0, 0xC8, 0xEB, 0xBB, 0x3C, 0x83, 0x53, 0x99, 0x61, 0x17, 0x2B, 0x04, 0x7E, 0xBA, 0x77, 0xD6, 0x26, 0xE1, 0x69, 0x14, 0x63, 0x55, 0x21, 0x0C, 0x7D ] ]; } return $tables; } /** * Setup the performance-optimized function for de/encrypt() * * @see \phpseclib3\Crypt\Common\SymmetricKey::setupInlineCrypt() */ protected function setupInlineCrypt() { $w = $this->w; $dw = $this->dw; $init_encrypt = ''; $init_decrypt = ''; $Nr = $this->Nr; $Nb = $this->Nb; $c = $this->c; // Generating encrypt code: $init_encrypt .= ' static $tables; if (empty($tables)) { $tables = &$this->getTables(); } $t0 = $tables[0]; $t1 = $tables[1]; $t2 = $tables[2]; $t3 = $tables[3]; $sbox = $tables[4]; '; $s = 'e'; $e = 's'; $wc = $Nb - 1; // Preround: addRoundKey $encrypt_block = '$in = unpack("N*", $in);' . "\n"; for ($i = 0; $i < $Nb; ++$i) { $encrypt_block .= '$s' . $i . ' = $in[' . ($i + 1) . '] ^ ' . $w[++$wc] . ";\n"; } // Mainrounds: shiftRows + subWord + mixColumns + addRoundKey for ($round = 1; $round < $Nr; ++$round) { list($s, $e) = [$e, $s]; for ($i = 0; $i < $Nb; ++$i) { $encrypt_block .= '$' . $e . $i . ' = $t0[($' . $s . $i . ' >> 24) & 0xff] ^ $t1[($' . $s . (($i + $c[1]) % $Nb) . ' >> 16) & 0xff] ^ $t2[($' . $s . (($i + $c[2]) % $Nb) . ' >> 8) & 0xff] ^ $t3[ $' . $s . (($i + $c[3]) % $Nb) . ' & 0xff] ^ ' . $w[++$wc] . ";\n"; } } // Finalround: subWord + shiftRows + addRoundKey for ($i = 0; $i < $Nb; ++$i) { $encrypt_block .= '$' . $e . $i . ' = $sbox[ $' . $e . $i . ' & 0xff] | ($sbox[($' . $e . $i . ' >> 8) & 0xff] << 8) | ($sbox[($' . $e . $i . ' >> 16) & 0xff] << 16) | ($sbox[($' . $e . $i . ' >> 24) & 0xff] << 24);' . "\n"; } $encrypt_block .= '$in = pack("N*"' . "\n"; for ($i = 0; $i < $Nb; ++$i) { $encrypt_block .= ', ($' . $e . $i . ' & ' . ((int)0xFF000000) . ') ^ ($' . $e . (($i + $c[1]) % $Nb) . ' & 0x00FF0000 ) ^ ($' . $e . (($i + $c[2]) % $Nb) . ' & 0x0000FF00 ) ^ ($' . $e . (($i + $c[3]) % $Nb) . ' & 0x000000FF ) ^ ' . $w[$i] . "\n"; } $encrypt_block .= ');'; // Generating decrypt code: $init_decrypt .= ' static $invtables; if (empty($invtables)) { $invtables = &$this->getInvTables(); } $dt0 = $invtables[0]; $dt1 = $invtables[1]; $dt2 = $invtables[2]; $dt3 = $invtables[3]; $isbox = $invtables[4]; '; $s = 'e'; $e = 's'; $wc = $Nb - 1; // Preround: addRoundKey $decrypt_block = '$in = unpack("N*", $in);' . "\n"; for ($i = 0; $i < $Nb; ++$i) { $decrypt_block .= '$s' . $i . ' = $in[' . ($i + 1) . '] ^ ' . $dw[++$wc] . ';' . "\n"; } // Mainrounds: shiftRows + subWord + mixColumns + addRoundKey for ($round = 1; $round < $Nr; ++$round) { list($s, $e) = [$e, $s]; for ($i = 0; $i < $Nb; ++$i) { $decrypt_block .= '$' . $e . $i . ' = $dt0[($' . $s . $i . ' >> 24) & 0xff] ^ $dt1[($' . $s . (($Nb + $i - $c[1]) % $Nb) . ' >> 16) & 0xff] ^ $dt2[($' . $s . (($Nb + $i - $c[2]) % $Nb) . ' >> 8) & 0xff] ^ $dt3[ $' . $s . (($Nb + $i - $c[3]) % $Nb) . ' & 0xff] ^ ' . $dw[++$wc] . ";\n"; } } // Finalround: subWord + shiftRows + addRoundKey for ($i = 0; $i < $Nb; ++$i) { $decrypt_block .= '$' . $e . $i . ' = $isbox[ $' . $e . $i . ' & 0xff] | ($isbox[($' . $e . $i . ' >> 8) & 0xff] << 8) | ($isbox[($' . $e . $i . ' >> 16) & 0xff] << 16) | ($isbox[($' . $e . $i . ' >> 24) & 0xff] << 24);' . "\n"; } $decrypt_block .= '$in = pack("N*"' . "\n"; for ($i = 0; $i < $Nb; ++$i) { $decrypt_block .= ', ($' . $e . $i . ' & ' . ((int)0xFF000000) . ') ^ ($' . $e . (($Nb + $i - $c[1]) % $Nb) . ' & 0x00FF0000 ) ^ ($' . $e . (($Nb + $i - $c[2]) % $Nb) . ' & 0x0000FF00 ) ^ ($' . $e . (($Nb + $i - $c[3]) % $Nb) . ' & 0x000000FF ) ^ ' . $dw[$i] . "\n"; } $decrypt_block .= ');'; $this->inline_crypt = $this->createInlineCryptFunction( [ 'init_crypt' => '', 'init_encrypt' => $init_encrypt, 'init_decrypt' => $init_decrypt, 'encrypt_block' => $encrypt_block, 'decrypt_block' => $decrypt_block ] ); } /** * Encrypts a message. * * @see self::decrypt() * @see parent::encrypt() * @param string $plaintext * @return string */ public function encrypt($plaintext) { $this->setup(); switch ($this->engine) { case self::ENGINE_LIBSODIUM: $this->newtag = sodium_crypto_aead_aes256gcm_encrypt($plaintext, $this->aad, $this->nonce, $this->key); return Strings::shift($this->newtag, strlen($plaintext)); case self::ENGINE_OPENSSL_GCM: return openssl_encrypt( $plaintext, 'aes-' . $this->getKeyLength() . '-gcm', $this->key, OPENSSL_RAW_DATA, $this->nonce, $this->newtag, $this->aad ); } return parent::encrypt($plaintext); } /** * Decrypts a message. * * @see self::encrypt() * @see parent::decrypt() * @param string $ciphertext * @return string */ public function decrypt($ciphertext) { $this->setup(); switch ($this->engine) { case self::ENGINE_LIBSODIUM: if ($this->oldtag === false) { throw new InsufficientSetupException('Authentication Tag has not been set'); } if (strlen($this->oldtag) != 16) { break; } $plaintext = sodium_crypto_aead_aes256gcm_decrypt($ciphertext . $this->oldtag, $this->aad, $this->nonce, $this->key); if ($plaintext === false) { $this->oldtag = false; throw new BadDecryptionException('Error decrypting ciphertext with libsodium'); } return $plaintext; case self::ENGINE_OPENSSL_GCM: if ($this->oldtag === false) { throw new InsufficientSetupException('Authentication Tag has not been set'); } $plaintext = openssl_decrypt( $ciphertext, 'aes-' . $this->getKeyLength() . '-gcm', $this->key, OPENSSL_RAW_DATA, $this->nonce, $this->oldtag, $this->aad ); if ($plaintext === false) { $this->oldtag = false; throw new BadDecryptionException('Error decrypting ciphertext with OpenSSL'); } return $plaintext; } return parent::decrypt($ciphertext); } } * setKey('abcdefgh'); * * $size = 10 * 1024; * $plaintext = ''; * for ($i = 0; $i < $size; $i++) { * $plaintext.= 'a'; * } * * echo $rc4->decrypt($rc4->encrypt($plaintext)); * ?> * * * @author Jim Wigginton * @copyright 2007 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Crypt\Common\StreamCipher; /** * Pure-PHP implementation of RC4. * * @author Jim Wigginton */ class RC4 extends StreamCipher { /** * @see \phpseclib3\Crypt\RC4::_crypt() */ const ENCRYPT = 0; /** * @see \phpseclib3\Crypt\RC4::_crypt() */ const DECRYPT = 1; /** * Key Length (in bytes) * * @see \phpseclib3\Crypt\RC4::setKeyLength() * @var int */ protected $key_length = 128; // = 1024 bits /** * The mcrypt specific name of the cipher * * @see \phpseclib3\Crypt\Common\SymmetricKey::cipher_name_mcrypt * @var string */ protected $cipher_name_mcrypt = 'arcfour'; /** * The Key * * @see self::setKey() * @var string */ protected $key; /** * The Key Stream for decryption and encryption * * @see self::setKey() * @var array */ private $stream; /** * Test for engine validity * * This is mainly just a wrapper to set things up for \phpseclib3\Crypt\Common\SymmetricKey::isValidEngine() * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() * @param int $engine * @return bool */ protected function isValidEngineHelper($engine) { if ($engine == self::ENGINE_OPENSSL) { if ($this->continuousBuffer) { return false; } // quoting https://www.openssl.org/news/openssl-3.0-notes.html, OpenSSL 3.0.1 // "Moved all variations of the EVP ciphers CAST5, BF, IDEA, SEED, RC2, RC4, RC5, and DES to the legacy provider" // in theory openssl_get_cipher_methods() should catch this but, on GitHub Actions, at least, it does not if (version_compare(preg_replace('#OpenSSL (\d+\.\d+\.\d+) .*#', '$1', OPENSSL_VERSION_TEXT), '3.0.1', '>=')) { return false; } $this->cipher_name_openssl = 'rc4-40'; } return parent::isValidEngineHelper($engine); } /** * Sets the key length * * Keys can be between 1 and 256 bytes long. * * @param int $length * @throws \LengthException if the key length is invalid */ public function setKeyLength($length) { if ($length < 8 || $length > 2048) { throw new \LengthException('Key size of ' . $length . ' bits is not supported by this algorithm. Only keys between 1 and 256 bytes are supported'); } $this->key_length = $length >> 3; parent::setKeyLength($length); } /** * Sets the key length * * Keys can be between 1 and 256 bytes long. * * @param string $key */ public function setKey($key) { $length = strlen($key); if ($length < 1 || $length > 256) { throw new \LengthException('Key size of ' . $length . ' bytes is not supported by RC4. Keys must be between 1 and 256 bytes long'); } parent::setKey($key); } /** * Encrypts a message. * * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() * @see self::crypt() * @param string $plaintext * @return string $ciphertext */ public function encrypt($plaintext) { if ($this->engine != self::ENGINE_INTERNAL) { return parent::encrypt($plaintext); } return $this->crypt($plaintext, self::ENCRYPT); } /** * Decrypts a message. * * $this->decrypt($this->encrypt($plaintext)) == $this->encrypt($this->encrypt($plaintext)). * At least if the continuous buffer is disabled. * * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see self::crypt() * @param string $ciphertext * @return string $plaintext */ public function decrypt($ciphertext) { if ($this->engine != self::ENGINE_INTERNAL) { return parent::decrypt($ciphertext); } return $this->crypt($ciphertext, self::DECRYPT); } /** * Encrypts a block * * @param string $in */ protected function encryptBlock($in) { // RC4 does not utilize this method } /** * Decrypts a block * * @param string $in */ protected function decryptBlock($in) { // RC4 does not utilize this method } /** * Setup the key (expansion) * * @see \phpseclib3\Crypt\Common\SymmetricKey::_setupKey() */ protected function setupKey() { $key = $this->key; $keyLength = strlen($key); $keyStream = range(0, 255); $j = 0; for ($i = 0; $i < 256; $i++) { $j = ($j + $keyStream[$i] + ord($key[$i % $keyLength])) & 255; $temp = $keyStream[$i]; $keyStream[$i] = $keyStream[$j]; $keyStream[$j] = $temp; } $this->stream = []; $this->stream[self::DECRYPT] = $this->stream[self::ENCRYPT] = [ 0, // index $i 0, // index $j $keyStream ]; } /** * Encrypts or decrypts a message. * * @see self::encrypt() * @see self::decrypt() * @param string $text * @param int $mode * @return string $text */ private function crypt($text, $mode) { if ($this->changed) { $this->setup(); } $stream = &$this->stream[$mode]; if ($this->continuousBuffer) { $i = &$stream[0]; $j = &$stream[1]; $keyStream = &$stream[2]; } else { $i = $stream[0]; $j = $stream[1]; $keyStream = $stream[2]; } $len = strlen($text); for ($k = 0; $k < $len; ++$k) { $i = ($i + 1) & 255; $ksi = $keyStream[$i]; $j = ($j + $ksi) & 255; $ksj = $keyStream[$j]; $keyStream[$i] = $ksj; $keyStream[$j] = $ksi; $text[$k] = $text[$k] ^ chr($keyStream[($ksj + $ksi) & 255]); } return $text; } } * setKey('abcdefghijklmnopqrstuvwx'); * * $size = 10 * 1024; * $plaintext = ''; * for ($i = 0; $i < $size; $i++) { * $plaintext.= 'a'; * } * * echo $des->decrypt($des->encrypt($plaintext)); * ?> * * * @author Jim Wigginton * @copyright 2007 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; /** * Pure-PHP implementation of Triple DES. * * @author Jim Wigginton */ class TripleDES extends DES { /** * Encrypt / decrypt using inner chaining * * Inner chaining is used by SSH-1 and is generally considered to be less secure then outer chaining (self::MODE_CBC3). */ const MODE_3CBC = -2; /** * Encrypt / decrypt using outer chaining * * Outer chaining is used by SSH-2 and when the mode is set to \phpseclib3\Crypt\Common\BlockCipher::MODE_CBC. */ const MODE_CBC3 = self::MODE_CBC; /** * Key Length (in bytes) * * @see \phpseclib3\Crypt\TripleDES::setKeyLength() * @var int */ protected $key_length = 24; /** * The mcrypt specific name of the cipher * * @see \phpseclib3\Crypt\DES::cipher_name_mcrypt * @see \phpseclib3\Crypt\Common\SymmetricKey::cipher_name_mcrypt * @var string */ protected $cipher_name_mcrypt = 'tripledes'; /** * Optimizing value while CFB-encrypting * * @see \phpseclib3\Crypt\Common\SymmetricKey::cfb_init_len * @var int */ protected $cfb_init_len = 750; /** * max possible size of $key * * @see self::setKey() * @see \phpseclib3\Crypt\DES::setKey() * @var string */ protected $key_length_max = 24; /** * Internal flag whether using self::MODE_3CBC or not * * @var bool */ private $mode_3cbc; /** * The \phpseclib3\Crypt\DES objects * * Used only if $mode_3cbc === true * * @var array */ private $des; /** * Default Constructor. * * Determines whether or not the mcrypt or OpenSSL extensions should be used. * * $mode could be: * * - ecb * * - cbc * * - ctr * * - cfb * * - ofb * * - 3cbc * * - cbc3 (same as cbc) * * @see \phpseclib3\Crypt\DES::__construct() * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() * @param string $mode */ public function __construct($mode) { switch (strtolower($mode)) { // In case of self::MODE_3CBC, we init as CRYPT_DES_MODE_CBC // and additional flag us internally as 3CBC case '3cbc': parent::__construct('cbc'); $this->mode_3cbc = true; // This three $des'es will do the 3CBC work (if $key > 64bits) $this->des = [ new DES('cbc'), new DES('cbc'), new DES('cbc'), ]; // we're going to be doing the padding, ourselves, so disable it in the \phpseclib3\Crypt\DES objects $this->des[0]->disablePadding(); $this->des[1]->disablePadding(); $this->des[2]->disablePadding(); break; case 'cbc3': $mode = 'cbc'; // fall-through // If not 3CBC, we init as usual default: parent::__construct($mode); if ($this->mode == self::MODE_STREAM) { throw new BadModeException('Block ciphers cannot be ran in stream mode'); } } } /** * Test for engine validity * * This is mainly just a wrapper to set things up for \phpseclib3\Crypt\Common\SymmetricKey::isValidEngine() * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() * @param int $engine * @return bool */ protected function isValidEngineHelper($engine) { if ($engine == self::ENGINE_OPENSSL) { $this->cipher_name_openssl_ecb = 'des-ede3'; $mode = $this->openssl_translate_mode(); $this->cipher_name_openssl = $mode == 'ecb' ? 'des-ede3' : 'des-ede3-' . $mode; } return parent::isValidEngineHelper($engine); } /** * Sets the initialization vector. * * SetIV is not required when \phpseclib3\Crypt\Common\SymmetricKey::MODE_ECB is being used. * * @see \phpseclib3\Crypt\Common\SymmetricKey::setIV() * @param string $iv */ public function setIV($iv) { parent::setIV($iv); if ($this->mode_3cbc) { $this->des[0]->setIV($iv); $this->des[1]->setIV($iv); $this->des[2]->setIV($iv); } } /** * Sets the key length. * * Valid key lengths are 128 and 192 bits. * * If you want to use a 64-bit key use DES.php * * @see \phpseclib3\Crypt\Common\SymmetricKey:setKeyLength() * @throws \LengthException if the key length is invalid * @param int $length */ public function setKeyLength($length) { switch ($length) { case 128: case 192: break; default: throw new \LengthException('Key size of ' . $length . ' bits is not supported by this algorithm. Only keys of sizes 128 or 192 bits are supported'); } parent::setKeyLength($length); } /** * Sets the key. * * Triple DES can use 128-bit (eg. strlen($key) == 16) or 192-bit (eg. strlen($key) == 24) keys. * * DES also requires that every eighth bit be a parity bit, however, we'll ignore that. * * @see \phpseclib3\Crypt\DES::setKey() * @see \phpseclib3\Crypt\Common\SymmetricKey::setKey() * @throws \LengthException if the key length is invalid * @param string $key */ public function setKey($key) { if ($this->explicit_key_length !== false && strlen($key) != $this->explicit_key_length) { throw new \LengthException('Key length has already been set to ' . $this->explicit_key_length . ' bytes and this key is ' . strlen($key) . ' bytes'); } switch (strlen($key)) { case 16: $key .= substr($key, 0, 8); break; case 24: break; default: throw new \LengthException('Key of size ' . strlen($key) . ' not supported by this algorithm. Only keys of sizes 16 or 24 are supported'); } // copied from self::setKey() $this->key = $key; $this->key_length = strlen($key); $this->changed = $this->nonIVChanged = true; $this->setEngine(); if ($this->mode_3cbc) { $this->des[0]->setKey(substr($key, 0, 8)); $this->des[1]->setKey(substr($key, 8, 8)); $this->des[2]->setKey(substr($key, 16, 8)); } } /** * Encrypts a message. * * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @param string $plaintext * @return string $cipertext */ public function encrypt($plaintext) { // parent::en/decrypt() is able to do all the work for all modes and keylengths, // except for: self::MODE_3CBC (inner chaining CBC) with a key > 64bits // if the key is smaller then 8, do what we'd normally do if ($this->mode_3cbc && strlen($this->key) > 8) { return $this->des[2]->encrypt( $this->des[1]->decrypt( $this->des[0]->encrypt( $this->pad($plaintext) ) ) ); } return parent::encrypt($plaintext); } /** * Decrypts a message. * * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() * @param string $ciphertext * @return string $plaintext */ public function decrypt($ciphertext) { if ($this->mode_3cbc && strlen($this->key) > 8) { return $this->unpad( $this->des[0]->decrypt( $this->des[1]->encrypt( $this->des[2]->decrypt( str_pad($ciphertext, (strlen($ciphertext) + 7) & 0xFFFFFFF8, "\0") ) ) ) ); } return parent::decrypt($ciphertext); } /** * Treat consecutive "packets" as if they are a continuous buffer. * * Say you have a 16-byte plaintext $plaintext. Using the default behavior, the two following code snippets * will yield different outputs: * * * echo $des->encrypt(substr($plaintext, 0, 8)); * echo $des->encrypt(substr($plaintext, 8, 8)); * * * echo $des->encrypt($plaintext); * * * The solution is to enable the continuous buffer. Although this will resolve the above discrepancy, it creates * another, as demonstrated with the following: * * * $des->encrypt(substr($plaintext, 0, 8)); * echo $des->decrypt($des->encrypt(substr($plaintext, 8, 8))); * * * echo $des->decrypt($des->encrypt(substr($plaintext, 8, 8))); * * * With the continuous buffer disabled, these would yield the same output. With it enabled, they yield different * outputs. The reason is due to the fact that the initialization vector's change after every encryption / * decryption round when the continuous buffer is enabled. When it's disabled, they remain constant. * * Put another way, when the continuous buffer is enabled, the state of the \phpseclib3\Crypt\DES() object changes after each * encryption / decryption round, whereas otherwise, it'd remain constant. For this reason, it's recommended that * continuous buffers not be used. They do offer better security and are, in fact, sometimes required (SSH uses them), * however, they are also less intuitive and more likely to cause you problems. * * @see \phpseclib3\Crypt\Common\SymmetricKey::enableContinuousBuffer() * @see self::disableContinuousBuffer() */ public function enableContinuousBuffer() { parent::enableContinuousBuffer(); if ($this->mode_3cbc) { $this->des[0]->enableContinuousBuffer(); $this->des[1]->enableContinuousBuffer(); $this->des[2]->enableContinuousBuffer(); } } /** * Treat consecutive packets as if they are a discontinuous buffer. * * The default behavior. * * @see \phpseclib3\Crypt\Common\SymmetricKey::disableContinuousBuffer() * @see self::enableContinuousBuffer() */ public function disableContinuousBuffer() { parent::disableContinuousBuffer(); if ($this->mode_3cbc) { $this->des[0]->disableContinuousBuffer(); $this->des[1]->disableContinuousBuffer(); $this->des[2]->disableContinuousBuffer(); } } /** * Creates the key schedule * * @see \phpseclib3\Crypt\DES::setupKey() * @see \phpseclib3\Crypt\Common\SymmetricKey::setupKey() */ protected function setupKey() { switch (true) { // if $key <= 64bits we configure our internal pure-php cipher engine // to act as regular [1]DES, not as 3DES. mcrypt.so::tripledes does the same. case strlen($this->key) <= 8: $this->des_rounds = 1; break; // otherwise, if $key > 64bits, we configure our engine to work as 3DES. default: $this->des_rounds = 3; // (only) if 3CBC is used we have, of course, to setup the $des[0-2] keys also separately. if ($this->mode_3cbc) { $this->des[0]->setupKey(); $this->des[1]->setupKey(); $this->des[2]->setupKey(); // because $des[0-2] will, now, do all the work we can return here // not need unnecessary stress parent::setupKey() with our, now unused, $key. return; } } // setup our key parent::setupKey(); } /** * Sets the internal crypt engine * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() * @see \phpseclib3\Crypt\Common\SymmetricKey::setPreferredEngine() * @param int $engine */ public function setPreferredEngine($engine) { if ($this->mode_3cbc) { $this->des[0]->setPreferredEngine($engine); $this->des[1]->setPreferredEngine($engine); $this->des[2]->setPreferredEngine($engine); } parent::setPreferredEngine($engine); } } * getPublicKey(); * * $plaintext = 'terrafrost'; * * $signature = $private->sign($plaintext); * * echo $public->verify($plaintext, $signature) ? 'verified' : 'unverified'; * ?> * * * @author Jim Wigginton * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Crypt\Common\AsymmetricKey; use phpseclib3\Crypt\DSA\Parameters; use phpseclib3\Crypt\DSA\PrivateKey; use phpseclib3\Crypt\DSA\PublicKey; use phpseclib3\Exception\InsufficientSetupException; use phpseclib3\Math\BigInteger; /** * Pure-PHP FIPS 186-4 compliant implementation of DSA. * * @author Jim Wigginton */ abstract class DSA extends AsymmetricKey { /** * Algorithm Name * * @var string */ const ALGORITHM = 'DSA'; /** * DSA Prime P * * @var \phpseclib3\Math\BigInteger */ protected $p; /** * DSA Group Order q * * Prime divisor of p-1 * * @var \phpseclib3\Math\BigInteger */ protected $q; /** * DSA Group Generator G * * @var \phpseclib3\Math\BigInteger */ protected $g; /** * DSA public key value y * * @var \phpseclib3\Math\BigInteger */ protected $y; /** * Signature Format * * @var string */ protected $sigFormat; /** * Signature Format (Short) * * @var string */ protected $shortFormat; /** * Create DSA parameters * * @param int $L * @param int $N * @return \phpseclib3\Crypt\DSA|bool */ public static function createParameters($L = 2048, $N = 224) { self::initialize_static_variables(); if (!isset(self::$engines['PHP'])) { self::useBestEngine(); } switch (true) { case $N == 160: /* in FIPS 186-1 and 186-2 N was fixed at 160 whereas K had an upper bound of 1024. RFC 4253 (SSH Transport Layer Protocol) references FIPS 186-2 and as such most SSH DSA implementations only support keys with an N of 160. puttygen let's you set the size of L (but not the size of N) and uses 2048 as the default L value. that's not really compliant with any of the FIPS standards, however, for the purposes of maintaining compatibility with puttygen, we'll support it */ //case ($L >= 512 || $L <= 1024) && (($L & 0x3F) == 0) && $N == 160: // FIPS 186-3 changed this as follows: //case $L == 1024 && $N == 160: case $L == 2048 && $N == 224: case $L == 2048 && $N == 256: case $L == 3072 && $N == 256: break; default: throw new \InvalidArgumentException('Invalid values for N and L'); } $two = new BigInteger(2); $q = BigInteger::randomPrime($N); $divisor = $q->multiply($two); do { $x = BigInteger::random($L); list(, $c) = $x->divide($divisor); $p = $x->subtract($c->subtract(self::$one)); } while ($p->getLength() != $L || !$p->isPrime()); $p_1 = $p->subtract(self::$one); list($e) = $p_1->divide($q); // quoting http://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-4.pdf#page=50 , // "h could be obtained from a random number generator or from a counter that // changes after each use". PuTTY (sshdssg.c) starts h off at 1 and increments // it on each loop. wikipedia says "commonly h = 2 is used" so we'll just do that $h = clone $two; while (true) { $g = $h->powMod($e, $p); if (!$g->equals(self::$one)) { break; } $h = $h->add(self::$one); } $dsa = new Parameters(); $dsa->p = $p; $dsa->q = $q; $dsa->g = $g; return $dsa; } /** * Create public / private key pair. * * This method is a bit polymorphic. It can take a DSA/Parameters object, L / N as two distinct parameters or * no parameters (at which point L and N will be generated with this method) * * Returns the private key, from which the publickey can be extracted * * @param int[] ...$args * @return DSA\PrivateKey */ public static function createKey(...$args) { self::initialize_static_variables(); if (!isset(self::$engines['PHP'])) { self::useBestEngine(); } if (count($args) == 2 && is_int($args[0]) && is_int($args[1])) { $params = self::createParameters($args[0], $args[1]); } elseif (count($args) == 1 && $args[0] instanceof Parameters) { $params = $args[0]; } elseif (!count($args)) { $params = self::createParameters(); } else { throw new InsufficientSetupException('Valid parameters are either two integers (L and N), a single DSA object or no parameters at all.'); } $private = new PrivateKey(); $private->p = $params->p; $private->q = $params->q; $private->g = $params->g; $private->x = BigInteger::randomRange(self::$one, $private->q->subtract(self::$one)); $private->y = $private->g->powMod($private->x, $private->p); //$public = clone $private; //unset($public->x); return $private ->withHash($params->hash->getHash()) ->withSignatureFormat($params->shortFormat); } /** * OnLoad Handler * * @return bool */ protected static function onLoad(array $components) { if (!isset(self::$engines['PHP'])) { self::useBestEngine(); } if (!isset($components['x']) && !isset($components['y'])) { $new = new Parameters(); } elseif (isset($components['x'])) { $new = new PrivateKey(); $new->x = $components['x']; } else { $new = new PublicKey(); } $new->p = $components['p']; $new->q = $components['q']; $new->g = $components['g']; if (isset($components['y'])) { $new->y = $components['y']; } return $new; } /** * Constructor * * PublicKey and PrivateKey objects can only be created from abstract RSA class */ protected function __construct() { $this->sigFormat = self::validatePlugin('Signature', 'ASN1'); $this->shortFormat = 'ASN1'; parent::__construct(); } /** * Returns the key size * * More specifically, this L (the length of DSA Prime P) and N (the length of DSA Group Order q) * * @return array */ public function getLength() { return ['L' => $this->p->getLength(), 'N' => $this->q->getLength()]; } /** * Returns the current engine being used * * @see self::useInternalEngine() * @see self::useBestEngine() * @return string */ public function getEngine() { if (!isset(self::$engines['PHP'])) { self::useBestEngine(); } return self::$engines['OpenSSL'] && in_array($this->hash->getHash(), openssl_get_md_methods()) ? 'OpenSSL' : 'PHP'; } /** * Returns the parameters * * A public / private key is only returned if the currently loaded "key" contains an x or y * value. * * @see self::getPublicKey() * @return mixed */ public function getParameters() { $type = self::validatePlugin('Keys', 'PKCS1', 'saveParameters'); $key = $type::saveParameters($this->p, $this->q, $this->g); return DSA::load($key, 'PKCS1') ->withHash($this->hash->getHash()) ->withSignatureFormat($this->shortFormat); } /** * Determines the signature padding mode * * Valid values are: ASN1, SSH2, Raw * * @param string $format */ public function withSignatureFormat($format) { $new = clone $this; $new->shortFormat = $format; $new->sigFormat = self::validatePlugin('Signature', $format); return $new; } /** * Returns the signature format currently being used * */ public function getSignatureFormat() { return $this->shortFormat; } } * setKey('abcdefg'); * * echo base64_encode($hash->hash('abcdefg')); * ?> * * * @author Jim Wigginton * @copyright 2015 Jim Wigginton * @author Andreas Fischer * @copyright 2015 Andreas Fischer * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Common\Functions\Strings; use phpseclib3\Exception\InsufficientSetupException; use phpseclib3\Exception\UnsupportedAlgorithmException; use phpseclib3\Math\BigInteger; use phpseclib3\Math\PrimeField; /** * @author Jim Wigginton * @author Andreas Fischer */ class Hash { /** * Padding Types * */ const PADDING_KECCAK = 1; /** * Padding Types * */ const PADDING_SHA3 = 2; /** * Padding Types * */ const PADDING_SHAKE = 3; /** * Padding Type * * Only used by SHA3 * * @var int */ private $paddingType = 0; /** * Hash Parameter * * @see self::setHash() * @var int */ private $hashParam; /** * Byte-length of hash output (Internal HMAC) * * @see self::setHash() * @var int */ private $length; /** * Hash Algorithm * * @see self::setHash() * @var string */ private $algo; /** * Key * * @see self::setKey() * @var string */ private $key = false; /** * Nonce * * @see self::setNonce() * @var string */ private $nonce = false; /** * Hash Parameters * * @var array */ private $parameters = []; /** * Computed Key * * @see self::_computeKey() * @var string */ private $computedKey = false; /** * Outer XOR (Internal HMAC) * * Used only for sha512/* * * @see self::hash() * @var string */ private $opad; /** * Inner XOR (Internal HMAC) * * Used only for sha512/* * * @see self::hash() * @var string */ private $ipad; /** * Recompute AES Key * * Used only for umac * * @see self::hash() * @var boolean */ private $recomputeAESKey; /** * umac cipher object * * @see self::hash() * @var \phpseclib3\Crypt\AES */ private $c; /** * umac pad * * @see self::hash() * @var string */ private $pad; /** * Block Size * * @var int */ private $blockSize; /**#@+ * UMAC variables * * @var PrimeField */ private static $factory36; private static $factory64; private static $factory128; private static $offset64; private static $offset128; private static $marker64; private static $marker128; private static $maxwordrange64; private static $maxwordrange128; /**#@-*/ /** * Default Constructor. * * @param string $hash */ public function __construct($hash = 'sha256') { $this->setHash($hash); } /** * Sets the key for HMACs * * Keys can be of any length. * * @param string $key */ public function setKey($key = false) { $this->key = $key; $this->computeKey(); $this->recomputeAESKey = true; } /** * Sets the nonce for UMACs * * Keys can be of any length. * * @param string $nonce */ public function setNonce($nonce = false) { switch (true) { case !is_string($nonce): case strlen($nonce) > 0 && strlen($nonce) <= 16: $this->recomputeAESKey = true; $this->nonce = $nonce; return; } throw new \LengthException('The nonce length must be between 1 and 16 bytes, inclusive'); } /** * Pre-compute the key used by the HMAC * * Quoting http://tools.ietf.org/html/rfc2104#section-2, "Applications that use keys longer than B bytes * will first hash the key using H and then use the resultant L byte string as the actual key to HMAC." * * As documented in https://www.reddit.com/r/PHP/comments/9nct2l/symfonypolyfill_hash_pbkdf2_correct_fix_for/ * when doing an HMAC multiple times it's faster to compute the hash once instead of computing it during * every call * */ private function computeKey() { if ($this->key === false) { $this->computedKey = false; return; } if (strlen($this->key) <= $this->getBlockLengthInBytes()) { $this->computedKey = $this->key; return; } $this->computedKey = is_array($this->algo) ? call_user_func($this->algo, $this->key) : hash($this->algo, $this->key, true); } /** * Gets the hash function. * * As set by the constructor or by the setHash() method. * * @return string */ public function getHash() { return $this->hashParam; } /** * Sets the hash function. * * @param string $hash */ public function setHash($hash) { $this->hashParam = $hash = strtolower($hash); switch ($hash) { case 'umac-32': case 'umac-64': case 'umac-96': case 'umac-128': $this->blockSize = 128; $this->length = abs(substr($hash, -3)) >> 3; $this->algo = 'umac'; return; case 'md2-96': case 'md5-96': case 'sha1-96': case 'sha224-96': case 'sha256-96': case 'sha384-96': case 'sha512-96': case 'sha512/224-96': case 'sha512/256-96': $hash = substr($hash, 0, -3); $this->length = 12; // 96 / 8 = 12 break; case 'md2': case 'md5': $this->length = 16; break; case 'sha1': $this->length = 20; break; case 'sha224': case 'sha512/224': case 'sha3-224': $this->length = 28; break; case 'keccak256': $this->paddingType = self::PADDING_KECCAK; // fall-through case 'sha256': case 'sha512/256': case 'sha3-256': $this->length = 32; break; case 'sha384': case 'sha3-384': $this->length = 48; break; case 'sha512': case 'sha3-512': $this->length = 64; break; default: if (preg_match('#^(shake(?:128|256))-(\d+)$#', $hash, $matches)) { $this->paddingType = self::PADDING_SHAKE; $hash = $matches[1]; $this->length = $matches[2] >> 3; } else { throw new UnsupportedAlgorithmException( "$hash is not a supported algorithm" ); } } switch ($hash) { case 'md2': case 'md2-96': $this->blockSize = 128; break; case 'md5-96': case 'sha1-96': case 'sha224-96': case 'sha256-96': case 'md5': case 'sha1': case 'sha224': case 'sha256': $this->blockSize = 512; break; case 'sha3-224': $this->blockSize = 1152; // 1600 - 2*224 break; case 'sha3-256': case 'shake256': case 'keccak256': $this->blockSize = 1088; // 1600 - 2*256 break; case 'sha3-384': $this->blockSize = 832; // 1600 - 2*384 break; case 'sha3-512': $this->blockSize = 576; // 1600 - 2*512 break; case 'shake128': $this->blockSize = 1344; // 1600 - 2*128 break; default: $this->blockSize = 1024; } if (in_array(substr($hash, 0, 5), ['sha3-', 'shake', 'kecca'])) { // PHP 7.1.0 introduced support for "SHA3 fixed mode algorithms": // http://php.net/ChangeLog-7.php#7.1.0 if (version_compare(PHP_VERSION, '7.1.0') < 0 || substr($hash, 0, 5) != 'sha3-') { //preg_match('#(\d+)$#', $hash, $matches); //$this->parameters['capacity'] = 2 * $matches[1]; // 1600 - $this->blockSize //$this->parameters['rate'] = 1600 - $this->parameters['capacity']; // == $this->blockSize if (!$this->paddingType) { $this->paddingType = self::PADDING_SHA3; } $this->parameters = [ 'capacity' => 1600 - $this->blockSize, 'rate' => $this->blockSize, 'length' => $this->length, 'padding' => $this->paddingType ]; $hash = ['phpseclib3\Crypt\Hash', PHP_INT_SIZE == 8 ? 'sha3_64' : 'sha3_32']; } } if ($hash == 'sha512/224' || $hash == 'sha512/256') { // PHP 7.1.0 introduced sha512/224 and sha512/256 support: // http://php.net/ChangeLog-7.php#7.1.0 if (version_compare(PHP_VERSION, '7.1.0') < 0) { // from http://csrc.nist.gov/publications/fips/fips180-4/fips-180-4.pdf#page=24 $initial = $hash == 'sha512/256' ? [ '22312194FC2BF72C', '9F555FA3C84C64C2', '2393B86B6F53B151', '963877195940EABD', '96283EE2A88EFFE3', 'BE5E1E2553863992', '2B0199FC2C85B8AA', '0EB72DDC81C52CA2' ] : [ '8C3D37C819544DA2', '73E1996689DCD4D6', '1DFAB7AE32FF9C82', '679DD514582F9FCF', '0F6D2B697BD44DA8', '77E36F7304C48942', '3F9D85A86A1D36C8', '1112E6AD91D692A1' ]; for ($i = 0; $i < 8; $i++) { $initial[$i] = new BigInteger($initial[$i], 16); $initial[$i]->setPrecision(64); } $this->parameters = compact('initial'); $hash = ['phpseclib3\Crypt\Hash', 'sha512']; } } if (is_array($hash)) { $b = $this->blockSize >> 3; $this->ipad = str_repeat(chr(0x36), $b); $this->opad = str_repeat(chr(0x5C), $b); } $this->algo = $hash; $this->computeKey(); } /** * KDF: Key-Derivation Function * * The key-derivation function generates pseudorandom bits used to key the hash functions. * * @param int $index a non-negative integer less than 2^64 * @param int $numbytes a non-negative integer less than 2^64 * @return string string of length numbytes bytes */ private function kdf($index, $numbytes) { $this->c->setIV(pack('N4', 0, $index, 0, 1)); return $this->c->encrypt(str_repeat("\0", $numbytes)); } /** * PDF Algorithm * * @return string string of length taglen bytes. */ private function pdf() { $k = $this->key; $nonce = $this->nonce; $taglen = $this->length; // // Extract and zero low bit(s) of Nonce if needed // if ($taglen <= 8) { $last = strlen($nonce) - 1; $mask = $taglen == 4 ? "\3" : "\1"; $index = $nonce[$last] & $mask; $nonce[$last] = $nonce[$last] ^ $index; } // // Make Nonce BLOCKLEN bytes by appending zeroes if needed // $nonce = str_pad($nonce, 16, "\0"); // // Generate subkey, encipher and extract indexed substring // $kp = $this->kdf(0, 16); $c = new AES('ctr'); $c->disablePadding(); $c->setKey($kp); $c->setIV($nonce); $t = $c->encrypt("\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0"); // we could use ord() but per https://paragonie.com/blog/2016/06/constant-time-encoding-boring-cryptography-rfc-4648-and-you // unpack() doesn't leak timing info return $taglen <= 8 ? substr($t, unpack('C', $index)[1] * $taglen, $taglen) : substr($t, 0, $taglen); } /** * UHASH Algorithm * * @param string $m string of length less than 2^67 bits. * @param int $taglen the integer 4, 8, 12 or 16. * @return string string of length taglen bytes. */ private function uhash($m, $taglen) { // // One internal iteration per 4 bytes of output // $iters = $taglen >> 2; // // Define total key needed for all iterations using KDF. // L1Key reuses most key material between iterations. // //$L1Key = $this->kdf(1, 1024 + ($iters - 1) * 16); $L1Key = $this->kdf(1, (1024 + ($iters - 1)) * 16); $L2Key = $this->kdf(2, $iters * 24); $L3Key1 = $this->kdf(3, $iters * 64); $L3Key2 = $this->kdf(4, $iters * 4); // // For each iteration, extract key and do three-layer hash. // If bytelength(M) <= 1024, then skip L2-HASH. // $y = ''; for ($i = 0; $i < $iters; $i++) { $L1Key_i = substr($L1Key, $i * 16, 1024); $L2Key_i = substr($L2Key, $i * 24, 24); $L3Key1_i = substr($L3Key1, $i * 64, 64); $L3Key2_i = substr($L3Key2, $i * 4, 4); $a = self::L1Hash($L1Key_i, $m); $b = strlen($m) <= 1024 ? "\0\0\0\0\0\0\0\0$a" : self::L2Hash($L2Key_i, $a); $c = self::L3Hash($L3Key1_i, $L3Key2_i, $b); $y .= $c; } return $y; } /** * L1-HASH Algorithm * * The first-layer hash breaks the message into 1024-byte chunks and * hashes each with a function called NH. Concatenating the results * forms a string, which is up to 128 times shorter than the original. * * @param string $k string of length 1024 bytes. * @param string $m string of length less than 2^67 bits. * @return string string of length (8 * ceil(bitlength(M)/8192)) bytes. */ private static function L1Hash($k, $m) { // // Break M into 1024 byte chunks (final chunk may be shorter) // $m = str_split($m, 1024); // // For each chunk, except the last: endian-adjust, NH hash // and add bit-length. Use results to build Y. // $length = new BigInteger(1024 * 8); $y = ''; for ($i = 0; $i < count($m) - 1; $i++) { $m[$i] = pack('N*', ...unpack('V*', $m[$i])); // ENDIAN-SWAP $y .= static::nh($k, $m[$i], $length); } // // For the last chunk: pad to 32-byte boundary, endian-adjust, // NH hash and add bit-length. Concatenate the result to Y. // $length = count($m) ? strlen($m[$i]) : 0; $pad = 32 - ($length % 32); $pad = max(32, $length + $pad % 32); $m[$i] = str_pad(isset($m[$i]) ? $m[$i] : '', $pad, "\0"); // zeropad $m[$i] = pack('N*', ...unpack('V*', $m[$i])); // ENDIAN-SWAP $y .= static::nh($k, $m[$i], new BigInteger($length * 8)); return $y; } /** * NH Algorithm * * @param string $k string of length 1024 bytes. * @param string $m string with length divisible by 32 bytes. * @return string string of length 8 bytes. */ private static function nh($k, $m, $length) { $toUInt32 = function ($x) { $x = new BigInteger($x, 256); $x->setPrecision(32); return $x; }; // // Break M and K into 4-byte chunks // //$t = strlen($m) >> 2; $m = str_split($m, 4); $t = count($m); $k = str_split($k, 4); $k = array_pad(array_slice($k, 0, $t), $t, 0); $m = array_map($toUInt32, $m); $k = array_map($toUInt32, $k); // // Perform NH hash on the chunks, pairing words for multiplication // which are 4 apart to accommodate vector-parallelism. // $y = new BigInteger(); $y->setPrecision(64); $i = 0; while ($i < $t) { $temp = $m[$i]->add($k[$i]); $temp->setPrecision(64); $temp = $temp->multiply($m[$i + 4]->add($k[$i + 4])); $y = $y->add($temp); $temp = $m[$i + 1]->add($k[$i + 1]); $temp->setPrecision(64); $temp = $temp->multiply($m[$i + 5]->add($k[$i + 5])); $y = $y->add($temp); $temp = $m[$i + 2]->add($k[$i + 2]); $temp->setPrecision(64); $temp = $temp->multiply($m[$i + 6]->add($k[$i + 6])); $y = $y->add($temp); $temp = $m[$i + 3]->add($k[$i + 3]); $temp->setPrecision(64); $temp = $temp->multiply($m[$i + 7]->add($k[$i + 7])); $y = $y->add($temp); $i += 8; } return $y->add($length)->toBytes(); } /** * L2-HASH: Second-Layer Hash * * The second-layer rehashes the L1-HASH output using a polynomial hash * called POLY. If the L1-HASH output is long, then POLY is called once * on a prefix of the L1-HASH output and called using different settings * on the remainder. (This two-step hashing of the L1-HASH output is * needed only if the message length is greater than 16 megabytes.) * Careful implementation of POLY is necessary to avoid a possible * timing attack (see Section 6.6 for more information). * * @param string $k string of length 24 bytes. * @param string $m string of length less than 2^64 bytes. * @return string string of length 16 bytes. */ private static function L2Hash($k, $m) { // // Extract keys and restrict to special key-sets // $k64 = $k & "\x01\xFF\xFF\xFF\x01\xFF\xFF\xFF"; $k64 = new BigInteger($k64, 256); $k128 = substr($k, 8) & "\x01\xFF\xFF\xFF\x01\xFF\xFF\xFF\x01\xFF\xFF\xFF\x01\xFF\xFF\xFF"; $k128 = new BigInteger($k128, 256); // // If M is no more than 2^17 bytes, hash under 64-bit prime, // otherwise, hash first 2^17 bytes under 64-bit prime and // remainder under 128-bit prime. // if (strlen($m) <= 0x20000) { // 2^14 64-bit words $y = self::poly(64, self::$maxwordrange64, $k64, $m); } else { $m_1 = substr($m, 0, 0x20000); // 1 << 17 $m_2 = substr($m, 0x20000) . "\x80"; $length = strlen($m_2); $pad = 16 - ($length % 16); $pad %= 16; $m_2 = str_pad($m_2, $length + $pad, "\0"); // zeropad $y = self::poly(64, self::$maxwordrange64, $k64, $m_1); $y = str_pad($y, 16, "\0", STR_PAD_LEFT); $y = self::poly(128, self::$maxwordrange128, $k128, $y . $m_2); } return str_pad($y, 16, "\0", STR_PAD_LEFT); } /** * POLY Algorithm * * @param int $wordbits the integer 64 or 128. * @param BigInteger $maxwordrange positive integer less than 2^wordbits. * @param BigInteger $k integer in the range 0 ... prime(wordbits) - 1. * @param string $m string with length divisible by (wordbits / 8) bytes. * @return integer in the range 0 ... prime(wordbits) - 1. */ private static function poly($wordbits, $maxwordrange, $k, $m) { // // Define constants used for fixing out-of-range words // $wordbytes = $wordbits >> 3; if ($wordbits == 128) { $factory = self::$factory128; $offset = self::$offset128; $marker = self::$marker128; } else { $factory = self::$factory64; $offset = self::$offset64; $marker = self::$marker64; } $k = $factory->newInteger($k); // // Break M into chunks of length wordbytes bytes // $m_i = str_split($m, $wordbytes); // // Each input word m is compared with maxwordrange. If not smaller // then 'marker' and (m - offset), both in range, are hashed. // $y = $factory->newInteger(new BigInteger(1)); foreach ($m_i as $m) { $m = $factory->newInteger(new BigInteger($m, 256)); if ($m->compare($maxwordrange) >= 0) { $y = $k->multiply($y)->add($marker); $y = $k->multiply($y)->add($m->subtract($offset)); } else { $y = $k->multiply($y)->add($m); } } return $y->toBytes(); } /** * L3-HASH: Third-Layer Hash * * The output from L2-HASH is 16 bytes long. This final hash function * hashes the 16-byte string to a fixed length of 4 bytes. * * @param string $k1 string of length 64 bytes. * @param string $k2 string of length 4 bytes. * @param string $m string of length 16 bytes. * @return string string of length 4 bytes. */ private static function L3Hash($k1, $k2, $m) { $factory = self::$factory36; $y = $factory->newInteger(new BigInteger()); for ($i = 0; $i < 8; $i++) { $m_i = $factory->newInteger(new BigInteger(substr($m, 2 * $i, 2), 256)); $k_i = $factory->newInteger(new BigInteger(substr($k1, 8 * $i, 8), 256)); $y = $y->add($m_i->multiply($k_i)); } $y = str_pad(substr($y->toBytes(), -4), 4, "\0", STR_PAD_LEFT); $y = $y ^ $k2; return $y; } /** * Compute the Hash / HMAC / UMAC. * * @param string $text * @return string */ public function hash($text) { $algo = $this->algo; if ($algo == 'umac') { if ($this->recomputeAESKey) { if (!is_string($this->nonce)) { throw new InsufficientSetupException('No nonce has been set'); } if (!is_string($this->key)) { throw new InsufficientSetupException('No key has been set'); } if (strlen($this->key) != 16) { throw new \LengthException('Key must be 16 bytes long'); } if (!isset(self::$maxwordrange64)) { $one = new BigInteger(1); $prime36 = new BigInteger("\x00\x00\x00\x0F\xFF\xFF\xFF\xFB", 256); self::$factory36 = new PrimeField($prime36); $prime64 = new BigInteger("\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xC5", 256); self::$factory64 = new PrimeField($prime64); $prime128 = new BigInteger("\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\x61", 256); self::$factory128 = new PrimeField($prime128); self::$offset64 = new BigInteger("\1\0\0\0\0\0\0\0\0", 256); self::$offset64 = self::$factory64->newInteger(self::$offset64->subtract($prime64)); self::$offset128 = new BigInteger("\1\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0", 256); self::$offset128 = self::$factory128->newInteger(self::$offset128->subtract($prime128)); self::$marker64 = self::$factory64->newInteger($prime64->subtract($one)); self::$marker128 = self::$factory128->newInteger($prime128->subtract($one)); $maxwordrange64 = $one->bitwise_leftShift(64)->subtract($one->bitwise_leftShift(32)); self::$maxwordrange64 = self::$factory64->newInteger($maxwordrange64); $maxwordrange128 = $one->bitwise_leftShift(128)->subtract($one->bitwise_leftShift(96)); self::$maxwordrange128 = self::$factory128->newInteger($maxwordrange128); } $this->c = new AES('ctr'); $this->c->disablePadding(); $this->c->setKey($this->key); $this->pad = $this->pdf(); $this->recomputeAESKey = false; } $hashedmessage = $this->uhash($text, $this->length); return $hashedmessage ^ $this->pad; } if (is_array($algo)) { if (empty($this->key) || !is_string($this->key)) { return substr($algo($text, ...array_values($this->parameters)), 0, $this->length); } // SHA3 HMACs are discussed at https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.202.pdf#page=30 $key = str_pad($this->computedKey, $b, chr(0)); $temp = $this->ipad ^ $key; $temp .= $text; $temp = substr($algo($temp, ...array_values($this->parameters)), 0, $this->length); $output = $this->opad ^ $key; $output .= $temp; $output = $algo($output, ...array_values($this->parameters)); return substr($output, 0, $this->length); } $output = !empty($this->key) || is_string($this->key) ? hash_hmac($algo, $text, $this->computedKey, true) : hash($algo, $text, true); return strlen($output) > $this->length ? substr($output, 0, $this->length) : $output; } /** * Returns the hash length (in bits) * * @return int */ public function getLength() { return $this->length << 3; } /** * Returns the hash length (in bytes) * * @return int */ public function getLengthInBytes() { return $this->length; } /** * Returns the block length (in bits) * * @return int */ public function getBlockLength() { return $this->blockSize; } /** * Returns the block length (in bytes) * * @return int */ public function getBlockLengthInBytes() { return $this->blockSize >> 3; } /** * Pads SHA3 based on the mode * * @param int $padLength * @param int $padType * @return string */ private static function sha3_pad($padLength, $padType) { switch ($padType) { case self::PADDING_KECCAK: $temp = chr(0x01) . str_repeat("\0", $padLength - 1); $temp[$padLength - 1] = $temp[$padLength - 1] | chr(0x80); return $temp; case self::PADDING_SHAKE: $temp = chr(0x1F) . str_repeat("\0", $padLength - 1); $temp[$padLength - 1] = $temp[$padLength - 1] | chr(0x80); return $temp; //case self::PADDING_SHA3: default: // from https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.202.pdf#page=36 return $padLength == 1 ? chr(0x86) : chr(0x06) . str_repeat("\0", $padLength - 2) . chr(0x80); } } /** * Pure-PHP 32-bit implementation of SHA3 * * Whereas BigInteger.php's 32-bit engine works on PHP 64-bit this 32-bit implementation * of SHA3 will *not* work on PHP 64-bit. This is because this implementation * employees bitwise NOTs and bitwise left shifts. And the round constants only work * on 32-bit PHP. eg. dechex(-2147483648) returns 80000000 on 32-bit PHP and * FFFFFFFF80000000 on 64-bit PHP. Sure, we could do bitwise ANDs but that would slow * things down. * * SHA512 requires BigInteger to simulate 64-bit unsigned integers because SHA2 employees * addition whereas SHA3 just employees bitwise operators. PHP64 only supports signed * 64-bit integers, which complicates addition, whereas that limitation isn't an issue * for SHA3. * * In https://ws680.nist.gov/publication/get_pdf.cfm?pub_id=919061#page=16 KECCAK[C] is * defined as "the KECCAK instance with KECCAK-f[1600] as the underlying permutation and * capacity c". This is relevant because, altho the KECCAK standard defines a mode * (KECCAK-f[800]) designed for 32-bit machines that mode is incompatible with SHA3 * * @param string $p * @param int $c * @param int $r * @param int $d * @param int $padType */ private static function sha3_32($p, $c, $r, $d, $padType) { $block_size = $r >> 3; $padLength = $block_size - (strlen($p) % $block_size); $num_ints = $block_size >> 2; $p .= static::sha3_pad($padLength, $padType); $n = strlen($p) / $r; // number of blocks $s = [ [[0, 0], [0, 0], [0, 0], [0, 0], [0, 0]], [[0, 0], [0, 0], [0, 0], [0, 0], [0, 0]], [[0, 0], [0, 0], [0, 0], [0, 0], [0, 0]], [[0, 0], [0, 0], [0, 0], [0, 0], [0, 0]], [[0, 0], [0, 0], [0, 0], [0, 0], [0, 0]] ]; $p = str_split($p, $block_size); foreach ($p as $pi) { $pi = unpack('V*', $pi); $x = $y = 0; for ($i = 1; $i <= $num_ints; $i += 2) { $s[$x][$y][0] ^= $pi[$i + 1]; $s[$x][$y][1] ^= $pi[$i]; if (++$y == 5) { $y = 0; $x++; } } static::processSHA3Block32($s); } $z = ''; $i = $j = 0; while (strlen($z) < $d) { $z .= pack('V2', $s[$i][$j][1], $s[$i][$j++][0]); if ($j == 5) { $j = 0; $i++; if ($i == 5) { $i = 0; static::processSHA3Block32($s); } } } return $z; } /** * 32-bit block processing method for SHA3 * * @param array $s */ private static function processSHA3Block32(&$s) { static $rotationOffsets = [ [ 0, 1, 62, 28, 27], [36, 44, 6, 55, 20], [ 3, 10, 43, 25, 39], [41, 45, 15, 21, 8], [18, 2, 61, 56, 14] ]; // the standards give these constants in hexadecimal notation. it's tempting to want to use // that same notation, here, however, we can't, because 0x80000000, on PHP32, is a positive // float - not the negative int that we need to be in PHP32. so we use -2147483648 instead static $roundConstants = [ [0, 1], [0, 32898], [-2147483648, 32906], [-2147483648, -2147450880], [0, 32907], [0, -2147483647], [-2147483648, -2147450751], [-2147483648, 32777], [0, 138], [0, 136], [0, -2147450871], [0, -2147483638], [0, -2147450741], [-2147483648, 139], [-2147483648, 32905], [-2147483648, 32771], [-2147483648, 32770], [-2147483648, 128], [0, 32778], [-2147483648, -2147483638], [-2147483648, -2147450751], [-2147483648, 32896], [0, -2147483647], [-2147483648, -2147450872] ]; for ($round = 0; $round < 24; $round++) { // theta step $parity = $rotated = []; for ($i = 0; $i < 5; $i++) { $parity[] = [ $s[0][$i][0] ^ $s[1][$i][0] ^ $s[2][$i][0] ^ $s[3][$i][0] ^ $s[4][$i][0], $s[0][$i][1] ^ $s[1][$i][1] ^ $s[2][$i][1] ^ $s[3][$i][1] ^ $s[4][$i][1] ]; $rotated[] = static::rotateLeft32($parity[$i], 1); } $temp = [ [$parity[4][0] ^ $rotated[1][0], $parity[4][1] ^ $rotated[1][1]], [$parity[0][0] ^ $rotated[2][0], $parity[0][1] ^ $rotated[2][1]], [$parity[1][0] ^ $rotated[3][0], $parity[1][1] ^ $rotated[3][1]], [$parity[2][0] ^ $rotated[4][0], $parity[2][1] ^ $rotated[4][1]], [$parity[3][0] ^ $rotated[0][0], $parity[3][1] ^ $rotated[0][1]] ]; for ($i = 0; $i < 5; $i++) { for ($j = 0; $j < 5; $j++) { $s[$i][$j][0] ^= $temp[$j][0]; $s[$i][$j][1] ^= $temp[$j][1]; } } $st = $s; // rho and pi steps for ($i = 0; $i < 5; $i++) { for ($j = 0; $j < 5; $j++) { $st[(2 * $i + 3 * $j) % 5][$j] = static::rotateLeft32($s[$j][$i], $rotationOffsets[$j][$i]); } } // chi step for ($i = 0; $i < 5; $i++) { $s[$i][0] = [ $st[$i][0][0] ^ (~$st[$i][1][0] & $st[$i][2][0]), $st[$i][0][1] ^ (~$st[$i][1][1] & $st[$i][2][1]) ]; $s[$i][1] = [ $st[$i][1][0] ^ (~$st[$i][2][0] & $st[$i][3][0]), $st[$i][1][1] ^ (~$st[$i][2][1] & $st[$i][3][1]) ]; $s[$i][2] = [ $st[$i][2][0] ^ (~$st[$i][3][0] & $st[$i][4][0]), $st[$i][2][1] ^ (~$st[$i][3][1] & $st[$i][4][1]) ]; $s[$i][3] = [ $st[$i][3][0] ^ (~$st[$i][4][0] & $st[$i][0][0]), $st[$i][3][1] ^ (~$st[$i][4][1] & $st[$i][0][1]) ]; $s[$i][4] = [ $st[$i][4][0] ^ (~$st[$i][0][0] & $st[$i][1][0]), $st[$i][4][1] ^ (~$st[$i][0][1] & $st[$i][1][1]) ]; } // iota step $s[0][0][0] ^= $roundConstants[$round][0]; $s[0][0][1] ^= $roundConstants[$round][1]; } } /** * Rotate 32-bit int * * @param array $x * @param int $shift */ private static function rotateLeft32($x, $shift) { if ($shift < 32) { list($hi, $lo) = $x; } else { $shift -= 32; list($lo, $hi) = $x; } return [ ($hi << $shift) | (($lo >> (32 - $shift)) & (1 << $shift) - 1), ($lo << $shift) | (($hi >> (32 - $shift)) & (1 << $shift) - 1) ]; } /** * Pure-PHP 64-bit implementation of SHA3 * * @param string $p * @param int $c * @param int $r * @param int $d * @param int $padType */ private static function sha3_64($p, $c, $r, $d, $padType) { $block_size = $r >> 3; $padLength = $block_size - (strlen($p) % $block_size); $num_ints = $block_size >> 2; $p .= static::sha3_pad($padLength, $padType); $n = strlen($p) / $r; // number of blocks $s = [ [0, 0, 0, 0, 0], [0, 0, 0, 0, 0], [0, 0, 0, 0, 0], [0, 0, 0, 0, 0], [0, 0, 0, 0, 0] ]; $p = str_split($p, $block_size); foreach ($p as $pi) { $pi = unpack('P*', $pi); $x = $y = 0; foreach ($pi as $subpi) { $s[$x][$y++] ^= $subpi; if ($y == 5) { $y = 0; $x++; } } static::processSHA3Block64($s); } $z = ''; $i = $j = 0; while (strlen($z) < $d) { $z .= pack('P', $s[$i][$j++]); if ($j == 5) { $j = 0; $i++; if ($i == 5) { $i = 0; static::processSHA3Block64($s); } } } return $z; } /** * 64-bit block processing method for SHA3 * * @param array $s */ private static function processSHA3Block64(&$s) { static $rotationOffsets = [ [ 0, 1, 62, 28, 27], [36, 44, 6, 55, 20], [ 3, 10, 43, 25, 39], [41, 45, 15, 21, 8], [18, 2, 61, 56, 14] ]; static $roundConstants = [ 1, 32898, -9223372036854742902, -9223372034707259392, 32907, 2147483649, -9223372034707259263, -9223372036854743031, 138, 136, 2147516425, 2147483658, 2147516555, -9223372036854775669, -9223372036854742903, -9223372036854743037, -9223372036854743038, -9223372036854775680, 32778, -9223372034707292150, -9223372034707259263, -9223372036854742912, 2147483649, -9223372034707259384 ]; for ($round = 0; $round < 24; $round++) { // theta step $parity = []; for ($i = 0; $i < 5; $i++) { $parity[] = $s[0][$i] ^ $s[1][$i] ^ $s[2][$i] ^ $s[3][$i] ^ $s[4][$i]; } $temp = [ $parity[4] ^ static::rotateLeft64($parity[1], 1), $parity[0] ^ static::rotateLeft64($parity[2], 1), $parity[1] ^ static::rotateLeft64($parity[3], 1), $parity[2] ^ static::rotateLeft64($parity[4], 1), $parity[3] ^ static::rotateLeft64($parity[0], 1) ]; for ($i = 0; $i < 5; $i++) { for ($j = 0; $j < 5; $j++) { $s[$i][$j] ^= $temp[$j]; } } $st = $s; // rho and pi steps for ($i = 0; $i < 5; $i++) { for ($j = 0; $j < 5; $j++) { $st[(2 * $i + 3 * $j) % 5][$j] = static::rotateLeft64($s[$j][$i], $rotationOffsets[$j][$i]); } } // chi step for ($i = 0; $i < 5; $i++) { $s[$i] = [ $st[$i][0] ^ (~$st[$i][1] & $st[$i][2]), $st[$i][1] ^ (~$st[$i][2] & $st[$i][3]), $st[$i][2] ^ (~$st[$i][3] & $st[$i][4]), $st[$i][3] ^ (~$st[$i][4] & $st[$i][0]), $st[$i][4] ^ (~$st[$i][0] & $st[$i][1]) ]; } // iota step $s[0][0] ^= $roundConstants[$round]; } } /** * Rotate 64-bit int * * @param int $x * @param int $shift */ private static function rotateLeft64($x, $shift) { return ($x << $shift) | (($x >> (64 - $shift)) & ((1 << $shift) - 1)); } /** * Pure-PHP implementation of SHA512 * * @param string $m * @param array $hash * @return string */ private static function sha512($m, $hash) { static $k; if (!isset($k)) { // Initialize table of round constants // (first 64 bits of the fractional parts of the cube roots of the first 80 primes 2..409) $k = [ '428a2f98d728ae22', '7137449123ef65cd', 'b5c0fbcfec4d3b2f', 'e9b5dba58189dbbc', '3956c25bf348b538', '59f111f1b605d019', '923f82a4af194f9b', 'ab1c5ed5da6d8118', 'd807aa98a3030242', '12835b0145706fbe', '243185be4ee4b28c', '550c7dc3d5ffb4e2', '72be5d74f27b896f', '80deb1fe3b1696b1', '9bdc06a725c71235', 'c19bf174cf692694', 'e49b69c19ef14ad2', 'efbe4786384f25e3', '0fc19dc68b8cd5b5', '240ca1cc77ac9c65', '2de92c6f592b0275', '4a7484aa6ea6e483', '5cb0a9dcbd41fbd4', '76f988da831153b5', '983e5152ee66dfab', 'a831c66d2db43210', 'b00327c898fb213f', 'bf597fc7beef0ee4', 'c6e00bf33da88fc2', 'd5a79147930aa725', '06ca6351e003826f', '142929670a0e6e70', '27b70a8546d22ffc', '2e1b21385c26c926', '4d2c6dfc5ac42aed', '53380d139d95b3df', '650a73548baf63de', '766a0abb3c77b2a8', '81c2c92e47edaee6', '92722c851482353b', 'a2bfe8a14cf10364', 'a81a664bbc423001', 'c24b8b70d0f89791', 'c76c51a30654be30', 'd192e819d6ef5218', 'd69906245565a910', 'f40e35855771202a', '106aa07032bbd1b8', '19a4c116b8d2d0c8', '1e376c085141ab53', '2748774cdf8eeb99', '34b0bcb5e19b48a8', '391c0cb3c5c95a63', '4ed8aa4ae3418acb', '5b9cca4f7763e373', '682e6ff3d6b2b8a3', '748f82ee5defb2fc', '78a5636f43172f60', '84c87814a1f0ab72', '8cc702081a6439ec', '90befffa23631e28', 'a4506cebde82bde9', 'bef9a3f7b2c67915', 'c67178f2e372532b', 'ca273eceea26619c', 'd186b8c721c0c207', 'eada7dd6cde0eb1e', 'f57d4f7fee6ed178', '06f067aa72176fba', '0a637dc5a2c898a6', '113f9804bef90dae', '1b710b35131c471b', '28db77f523047d84', '32caab7b40c72493', '3c9ebe0a15c9bebc', '431d67c49c100d4c', '4cc5d4becb3e42b6', '597f299cfc657e2a', '5fcb6fab3ad6faec', '6c44198c4a475817' ]; for ($i = 0; $i < 80; $i++) { $k[$i] = new BigInteger($k[$i], 16); } } // Pre-processing $length = strlen($m); // to round to nearest 112 mod 128, we'll add 128 - (length + (128 - 112)) % 128 $m .= str_repeat(chr(0), 128 - (($length + 16) & 0x7F)); $m[$length] = chr(0x80); // we don't support hashing strings 512MB long $m .= pack('N4', 0, 0, 0, $length << 3); // Process the message in successive 1024-bit chunks $chunks = str_split($m, 128); foreach ($chunks as $chunk) { $w = []; for ($i = 0; $i < 16; $i++) { $temp = new BigInteger(Strings::shift($chunk, 8), 256); $temp->setPrecision(64); $w[] = $temp; } // Extend the sixteen 32-bit words into eighty 32-bit words for ($i = 16; $i < 80; $i++) { $temp = [ $w[$i - 15]->bitwise_rightRotate(1), $w[$i - 15]->bitwise_rightRotate(8), $w[$i - 15]->bitwise_rightShift(7) ]; $s0 = $temp[0]->bitwise_xor($temp[1]); $s0 = $s0->bitwise_xor($temp[2]); $temp = [ $w[$i - 2]->bitwise_rightRotate(19), $w[$i - 2]->bitwise_rightRotate(61), $w[$i - 2]->bitwise_rightShift(6) ]; $s1 = $temp[0]->bitwise_xor($temp[1]); $s1 = $s1->bitwise_xor($temp[2]); $w[$i] = clone $w[$i - 16]; $w[$i] = $w[$i]->add($s0); $w[$i] = $w[$i]->add($w[$i - 7]); $w[$i] = $w[$i]->add($s1); } // Initialize hash value for this chunk $a = clone $hash[0]; $b = clone $hash[1]; $c = clone $hash[2]; $d = clone $hash[3]; $e = clone $hash[4]; $f = clone $hash[5]; $g = clone $hash[6]; $h = clone $hash[7]; // Main loop for ($i = 0; $i < 80; $i++) { $temp = [ $a->bitwise_rightRotate(28), $a->bitwise_rightRotate(34), $a->bitwise_rightRotate(39) ]; $s0 = $temp[0]->bitwise_xor($temp[1]); $s0 = $s0->bitwise_xor($temp[2]); $temp = [ $a->bitwise_and($b), $a->bitwise_and($c), $b->bitwise_and($c) ]; $maj = $temp[0]->bitwise_xor($temp[1]); $maj = $maj->bitwise_xor($temp[2]); $t2 = $s0->add($maj); $temp = [ $e->bitwise_rightRotate(14), $e->bitwise_rightRotate(18), $e->bitwise_rightRotate(41) ]; $s1 = $temp[0]->bitwise_xor($temp[1]); $s1 = $s1->bitwise_xor($temp[2]); $temp = [ $e->bitwise_and($f), $g->bitwise_and($e->bitwise_not()) ]; $ch = $temp[0]->bitwise_xor($temp[1]); $t1 = $h->add($s1); $t1 = $t1->add($ch); $t1 = $t1->add($k[$i]); $t1 = $t1->add($w[$i]); $h = clone $g; $g = clone $f; $f = clone $e; $e = $d->add($t1); $d = clone $c; $c = clone $b; $b = clone $a; $a = $t1->add($t2); } // Add this chunk's hash to result so far $hash = [ $hash[0]->add($a), $hash[1]->add($b), $hash[2]->add($c), $hash[3]->add($d), $hash[4]->add($e), $hash[5]->add($f), $hash[6]->add($g), $hash[7]->add($h) ]; } // Produce the final hash value (big-endian) // (\phpseclib3\Crypt\Hash::hash() trims the output for hashes but not for HMACs. as such, we trim the output here) $temp = $hash[0]->toBytes() . $hash[1]->toBytes() . $hash[2]->toBytes() . $hash[3]->toBytes() . $hash[4]->toBytes() . $hash[5]->toBytes() . $hash[6]->toBytes() . $hash[7]->toBytes(); return $temp; } /** * __toString() magic method */ public function __toString() { return $this->getHash(); } } * getPublicKey(); * * $plaintext = 'terrafrost'; * * $ciphertext = $public->encrypt($plaintext); * * echo $private->decrypt($ciphertext); * ?> * * * Here's an example of how to create signatures and verify signatures with this library: * * getPublicKey(); * * $plaintext = 'terrafrost'; * * $signature = $private->sign($plaintext); * * echo $public->verify($plaintext, $signature) ? 'verified' : 'unverified'; * ?> * * * One thing to consider when using this: so phpseclib uses PSS mode by default. * Technically, id-RSASSA-PSS has a different key format than rsaEncryption. So * should phpseclib save to the id-RSASSA-PSS format by default or the * rsaEncryption format? For stand-alone keys I figure rsaEncryption is better * because SSH doesn't use PSS and idk how many SSH servers would be able to * decode an id-RSASSA-PSS key. For X.509 certificates the id-RSASSA-PSS * format is used by default (unless you change it up to use PKCS1 instead) * * @author Jim Wigginton * @copyright 2009 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Crypt\Common\AsymmetricKey; use phpseclib3\Crypt\RSA\Formats\Keys\PSS; use phpseclib3\Crypt\RSA\PrivateKey; use phpseclib3\Crypt\RSA\PublicKey; use phpseclib3\Exception\InconsistentSetupException; use phpseclib3\Exception\UnsupportedAlgorithmException; use phpseclib3\Math\BigInteger; /** * Pure-PHP PKCS#1 compliant implementation of RSA. * * @author Jim Wigginton */ abstract class RSA extends AsymmetricKey { /** * Algorithm Name * * @var string */ const ALGORITHM = 'RSA'; /** * Use {@link http://en.wikipedia.org/wiki/Optimal_Asymmetric_Encryption_Padding Optimal Asymmetric Encryption Padding} * (OAEP) for encryption / decryption. * * Uses sha256 by default * * @see self::setHash() * @see self::setMGFHash() * @see self::encrypt() * @see self::decrypt() */ const ENCRYPTION_OAEP = 1; /** * Use PKCS#1 padding. * * Although self::PADDING_OAEP / self::PADDING_PSS offers more security, including PKCS#1 padding is necessary for purposes of backwards * compatibility with protocols (like SSH-1) written before OAEP's introduction. * * @see self::encrypt() * @see self::decrypt() */ const ENCRYPTION_PKCS1 = 2; /** * Do not use any padding * * Although this method is not recommended it can none-the-less sometimes be useful if you're trying to decrypt some legacy * stuff, if you're trying to diagnose why an encrypted message isn't decrypting, etc. * * @see self::encrypt() * @see self::decrypt() */ const ENCRYPTION_NONE = 4; /** * Use the Probabilistic Signature Scheme for signing * * Uses sha256 and 0 as the salt length * * @see self::setSaltLength() * @see self::setMGFHash() * @see self::setHash() * @see self::sign() * @see self::verify() * @see self::setHash() */ const SIGNATURE_PSS = 16; /** * Use a relaxed version of PKCS#1 padding for signature verification * * @see self::sign() * @see self::verify() * @see self::setHash() */ const SIGNATURE_RELAXED_PKCS1 = 32; /** * Use PKCS#1 padding for signature verification * * @see self::sign() * @see self::verify() * @see self::setHash() */ const SIGNATURE_PKCS1 = 64; /** * Encryption padding mode * * @var int */ protected $encryptionPadding = self::ENCRYPTION_OAEP; /** * Signature padding mode * * @var int */ protected $signaturePadding = self::SIGNATURE_PSS; /** * Length of hash function output * * @var int */ protected $hLen; /** * Length of salt * * @var int */ protected $sLen; /** * Label * * @var string */ protected $label = ''; /** * Hash function for the Mask Generation Function * * @var \phpseclib3\Crypt\Hash */ protected $mgfHash; /** * Length of MGF hash function output * * @var int */ protected $mgfHLen; /** * Modulus (ie. n) * * @var \phpseclib3\Math\BigInteger */ protected $modulus; /** * Modulus length * * @var \phpseclib3\Math\BigInteger */ protected $k; /** * Exponent (ie. e or d) * * @var \phpseclib3\Math\BigInteger */ protected $exponent; /** * Default public exponent * * @var int * @link http://en.wikipedia.org/wiki/65537_%28number%29 */ private static $defaultExponent = 65537; /** * Enable Blinding? * * @var bool */ protected static $enableBlinding = true; /** * OpenSSL configuration file name. * * @see self::createKey() * @var ?string */ protected static $configFile; /** * Smallest Prime * * Per , this number ought not result in primes smaller * than 256 bits. As a consequence if the key you're trying to create is 1024 bits and you've set smallestPrime * to 384 bits then you're going to get a 384 bit prime and a 640 bit prime (384 + 1024 % 384). At least if * engine is set to self::ENGINE_INTERNAL. If Engine is set to self::ENGINE_OPENSSL then smallest Prime is * ignored (ie. multi-prime RSA support is more intended as a way to speed up RSA key generation when there's * a chance neither gmp nor OpenSSL are installed) * * @var int */ private static $smallestPrime = 4096; /** * Public Exponent * * @var \phpseclib3\Math\BigInteger */ protected $publicExponent; /** * Sets the public exponent for key generation * * This will be 65537 unless changed. * * @param int $val */ public static function setExponent($val) { self::$defaultExponent = $val; } /** * Sets the smallest prime number in bits. Used for key generation * * This will be 4096 unless changed. * * @param int $val */ public static function setSmallestPrime($val) { self::$smallestPrime = $val; } /** * Sets the OpenSSL config file path * * Set to the empty string to use the default config file * * @param string $val */ public static function setOpenSSLConfigPath($val) { self::$configFile = $val; } /** * Create a private key * * The public key can be extracted from the private key * * @return RSA\PrivateKey * @param int $bits */ public static function createKey($bits = 2048) { self::initialize_static_variables(); $regSize = $bits >> 1; // divide by two to see how many bits P and Q would be if ($regSize > self::$smallestPrime) { $num_primes = floor($bits / self::$smallestPrime); $regSize = self::$smallestPrime; } else { $num_primes = 2; } if ($num_primes == 2 && $bits >= 384 && self::$defaultExponent == 65537) { if (!isset(self::$engines['PHP'])) { self::useBestEngine(); } // OpenSSL uses 65537 as the exponent and requires RSA keys be 384 bits minimum if (self::$engines['OpenSSL']) { $config = []; if (self::$configFile) { $config['config'] = self::$configFile; } $rsa = openssl_pkey_new(['private_key_bits' => $bits] + $config); openssl_pkey_export($rsa, $privatekeystr, null, $config); // clear the buffer of error strings stemming from a minimalistic openssl.cnf while (openssl_error_string() !== false) { } return RSA::load($privatekeystr); } } static $e; if (!isset($e)) { $e = new BigInteger(self::$defaultExponent); } $n = clone self::$one; $exponents = $coefficients = $primes = []; $lcm = [ 'top' => clone self::$one, 'bottom' => false ]; do { for ($i = 1; $i <= $num_primes; $i++) { if ($i != $num_primes) { $primes[$i] = BigInteger::randomPrime($regSize); } else { extract(BigInteger::minMaxBits($bits)); /** @var BigInteger $min * @var BigInteger $max */ list($min) = $min->divide($n); $min = $min->add(self::$one); list($max) = $max->divide($n); $primes[$i] = BigInteger::randomRangePrime($min, $max); } // the first coefficient is calculated differently from the rest // ie. instead of being $primes[1]->modInverse($primes[2]), it's $primes[2]->modInverse($primes[1]) if ($i > 2) { $coefficients[$i] = $n->modInverse($primes[$i]); } $n = $n->multiply($primes[$i]); $temp = $primes[$i]->subtract(self::$one); // textbook RSA implementations use Euler's totient function instead of the least common multiple. // see http://en.wikipedia.org/wiki/Euler%27s_totient_function $lcm['top'] = $lcm['top']->multiply($temp); $lcm['bottom'] = $lcm['bottom'] === false ? $temp : $lcm['bottom']->gcd($temp); } list($temp) = $lcm['top']->divide($lcm['bottom']); $gcd = $temp->gcd($e); $i0 = 1; } while (!$gcd->equals(self::$one)); $coefficients[2] = $primes[2]->modInverse($primes[1]); $d = $e->modInverse($temp); foreach ($primes as $i => $prime) { $temp = $prime->subtract(self::$one); $exponents[$i] = $e->modInverse($temp); } // from : // RSAPrivateKey ::= SEQUENCE { // version Version, // modulus INTEGER, -- n // publicExponent INTEGER, -- e // privateExponent INTEGER, -- d // prime1 INTEGER, -- p // prime2 INTEGER, -- q // exponent1 INTEGER, -- d mod (p-1) // exponent2 INTEGER, -- d mod (q-1) // coefficient INTEGER, -- (inverse of q) mod p // otherPrimeInfos OtherPrimeInfos OPTIONAL // } $privatekey = new PrivateKey(); $privatekey->modulus = $n; $privatekey->k = $bits >> 3; $privatekey->publicExponent = $e; $privatekey->exponent = $d; $privatekey->primes = $primes; $privatekey->exponents = $exponents; $privatekey->coefficients = $coefficients; /* $publickey = new PublicKey; $publickey->modulus = $n; $publickey->k = $bits >> 3; $publickey->exponent = $e; $publickey->publicExponent = $e; $publickey->isPublic = true; */ return $privatekey; } /** * OnLoad Handler * * @return bool */ protected static function onLoad(array $components) { $key = $components['isPublicKey'] ? new PublicKey() : new PrivateKey(); $key->modulus = $components['modulus']; $key->publicExponent = $components['publicExponent']; $key->k = $key->modulus->getLengthInBytes(); if ($components['isPublicKey'] || !isset($components['privateExponent'])) { $key->exponent = $key->publicExponent; } else { $key->privateExponent = $components['privateExponent']; $key->exponent = $key->privateExponent; $key->primes = $components['primes']; $key->exponents = $components['exponents']; $key->coefficients = $components['coefficients']; } if ($components['format'] == PSS::class) { // in the X509 world RSA keys are assumed to use PKCS1 padding by default. only if the key is // explicitly a PSS key is the use of PSS assumed. phpseclib does not work like this. phpseclib // uses PSS padding by default. it assumes the more secure method by default and altho it provides // for the less secure PKCS1 method you have to go out of your way to use it. this is consistent // with the latest trends in crypto. libsodium (NaCl) is actually a little more extreme in that // not only does it defaults to the most secure methods - it doesn't even let you choose less // secure methods //$key = $key->withPadding(self::SIGNATURE_PSS); if (isset($components['hash'])) { $key = $key->withHash($components['hash']); } if (isset($components['MGFHash'])) { $key = $key->withMGFHash($components['MGFHash']); } if (isset($components['saltLength'])) { $key = $key->withSaltLength($components['saltLength']); } } return $key; } /** * Initialize static variables */ protected static function initialize_static_variables() { if (!isset(self::$configFile)) { self::$configFile = dirname(__FILE__) . '/../openssl.cnf'; } parent::initialize_static_variables(); } /** * Constructor * * PublicKey and PrivateKey objects can only be created from abstract RSA class */ protected function __construct() { parent::__construct(); $this->hLen = $this->hash->getLengthInBytes(); $this->mgfHash = new Hash('sha256'); $this->mgfHLen = $this->mgfHash->getLengthInBytes(); } /** * Integer-to-Octet-String primitive * * See {@link http://tools.ietf.org/html/rfc3447#section-4.1 RFC3447#section-4.1}. * * @param bool|\phpseclib3\Math\BigInteger $x * @param int $xLen * @return bool|string */ protected function i2osp($x, $xLen) { if ($x === false) { return false; } $x = $x->toBytes(); if (strlen($x) > $xLen) { throw new \OutOfRangeException('Resultant string length out of range'); } return str_pad($x, $xLen, chr(0), STR_PAD_LEFT); } /** * Octet-String-to-Integer primitive * * See {@link http://tools.ietf.org/html/rfc3447#section-4.2 RFC3447#section-4.2}. * * @param string $x * @return \phpseclib3\Math\BigInteger */ protected function os2ip($x) { return new BigInteger($x, 256); } /** * EMSA-PKCS1-V1_5-ENCODE * * See {@link http://tools.ietf.org/html/rfc3447#section-9.2 RFC3447#section-9.2}. * * @param string $m * @param int $emLen * @throws \LengthException if the intended encoded message length is too short * @return string */ protected function emsa_pkcs1_v1_5_encode($m, $emLen) { $h = $this->hash->hash($m); // see http://tools.ietf.org/html/rfc3447#page-43 switch ($this->hash->getHash()) { case 'md2': $t = "\x30\x20\x30\x0c\x06\x08\x2a\x86\x48\x86\xf7\x0d\x02\x02\x05\x00\x04\x10"; break; case 'md5': $t = "\x30\x20\x30\x0c\x06\x08\x2a\x86\x48\x86\xf7\x0d\x02\x05\x05\x00\x04\x10"; break; case 'sha1': $t = "\x30\x21\x30\x09\x06\x05\x2b\x0e\x03\x02\x1a\x05\x00\x04\x14"; break; case 'sha256': $t = "\x30\x31\x30\x0d\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x01\x05\x00\x04\x20"; break; case 'sha384': $t = "\x30\x41\x30\x0d\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x02\x05\x00\x04\x30"; break; case 'sha512': $t = "\x30\x51\x30\x0d\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x03\x05\x00\x04\x40"; break; // from https://www.emc.com/collateral/white-papers/h11300-pkcs-1v2-2-rsa-cryptography-standard-wp.pdf#page=40 case 'sha224': $t = "\x30\x2d\x30\x0d\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x04\x05\x00\x04\x1c"; break; case 'sha512/224': $t = "\x30\x2d\x30\x0d\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x05\x05\x00\x04\x1c"; break; case 'sha512/256': $t = "\x30\x31\x30\x0d\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x06\x05\x00\x04\x20"; } $t .= $h; $tLen = strlen($t); if ($emLen < $tLen + 11) { throw new \LengthException('Intended encoded message length too short'); } $ps = str_repeat(chr(0xFF), $emLen - $tLen - 3); $em = "\0\1$ps\0$t"; return $em; } /** * EMSA-PKCS1-V1_5-ENCODE (without NULL) * * Quoting https://tools.ietf.org/html/rfc8017#page-65, * * "The parameters field associated with id-sha1, id-sha224, id-sha256, * id-sha384, id-sha512, id-sha512/224, and id-sha512/256 should * generally be omitted, but if present, it shall have a value of type * NULL" * * @param string $m * @param int $emLen * @return string */ protected function emsa_pkcs1_v1_5_encode_without_null($m, $emLen) { $h = $this->hash->hash($m); // see http://tools.ietf.org/html/rfc3447#page-43 switch ($this->hash->getHash()) { case 'sha1': $t = "\x30\x1f\x30\x07\x06\x05\x2b\x0e\x03\x02\x1a\x04\x14"; break; case 'sha256': $t = "\x30\x2f\x30\x0b\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x01\x04\x20"; break; case 'sha384': $t = "\x30\x3f\x30\x0b\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x02\x04\x30"; break; case 'sha512': $t = "\x30\x4f\x30\x0b\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x03\x04\x40"; break; // from https://www.emc.com/collateral/white-papers/h11300-pkcs-1v2-2-rsa-cryptography-standard-wp.pdf#page=40 case 'sha224': $t = "\x30\x2b\x30\x0b\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x04\x04\x1c"; break; case 'sha512/224': $t = "\x30\x2b\x30\x0b\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x05\x04\x1c"; break; case 'sha512/256': $t = "\x30\x2f\x30\x0b\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x06\x04\x20"; break; default: throw new UnsupportedAlgorithmException('md2 and md5 require NULLs'); } $t .= $h; $tLen = strlen($t); if ($emLen < $tLen + 11) { throw new \LengthException('Intended encoded message length too short'); } $ps = str_repeat(chr(0xFF), $emLen - $tLen - 3); $em = "\0\1$ps\0$t"; return $em; } /** * MGF1 * * See {@link http://tools.ietf.org/html/rfc3447#appendix-B.2.1 RFC3447#appendix-B.2.1}. * * @param string $mgfSeed * @param int $maskLen * @return string */ protected function mgf1($mgfSeed, $maskLen) { // if $maskLen would yield strings larger than 4GB, PKCS#1 suggests a "Mask too long" error be output. $t = ''; $count = ceil($maskLen / $this->mgfHLen); for ($i = 0; $i < $count; $i++) { $c = pack('N', $i); $t .= $this->mgfHash->hash($mgfSeed . $c); } return substr($t, 0, $maskLen); } /** * Returns the key size * * More specifically, this returns the size of the modulo in bits. * * @return int */ public function getLength() { return !isset($this->modulus) ? 0 : $this->modulus->getLength(); } /** * Determines which hashing function should be used * * Used with signature production / verification and (if the encryption mode is self::PADDING_OAEP) encryption and * decryption. * * @param string $hash */ public function withHash($hash) { $new = clone $this; // \phpseclib3\Crypt\Hash supports algorithms that PKCS#1 doesn't support. md5-96 and sha1-96, for example. switch (strtolower($hash)) { case 'md2': case 'md5': case 'sha1': case 'sha256': case 'sha384': case 'sha512': case 'sha224': case 'sha512/224': case 'sha512/256': $new->hash = new Hash($hash); break; default: throw new UnsupportedAlgorithmException( 'The only supported hash algorithms are: md2, md5, sha1, sha256, sha384, sha512, sha224, sha512/224, sha512/256' ); } $new->hLen = $new->hash->getLengthInBytes(); return $new; } /** * Determines which hashing function should be used for the mask generation function * * The mask generation function is used by self::PADDING_OAEP and self::PADDING_PSS and although it's * best if Hash and MGFHash are set to the same thing this is not a requirement. * * @param string $hash */ public function withMGFHash($hash) { $new = clone $this; // \phpseclib3\Crypt\Hash supports algorithms that PKCS#1 doesn't support. md5-96 and sha1-96, for example. switch (strtolower($hash)) { case 'md2': case 'md5': case 'sha1': case 'sha256': case 'sha384': case 'sha512': case 'sha224': case 'sha512/224': case 'sha512/256': $new->mgfHash = new Hash($hash); break; default: throw new UnsupportedAlgorithmException( 'The only supported hash algorithms are: md2, md5, sha1, sha256, sha384, sha512, sha224, sha512/224, sha512/256' ); } $new->mgfHLen = $new->mgfHash->getLengthInBytes(); return $new; } /** * Returns the MGF hash algorithm currently being used * */ public function getMGFHash() { return clone $this->mgfHash; } /** * Determines the salt length * * Used by RSA::PADDING_PSS * * To quote from {@link http://tools.ietf.org/html/rfc3447#page-38 RFC3447#page-38}: * * Typical salt lengths in octets are hLen (the length of the output * of the hash function Hash) and 0. * * @param int $sLen */ public function withSaltLength($sLen) { $new = clone $this; $new->sLen = $sLen; return $new; } /** * Returns the salt length currently being used * */ public function getSaltLength() { return $this->sLen !== null ? $this->sLen : $this->hLen; } /** * Determines the label * * Used by RSA::PADDING_OAEP * * To quote from {@link http://tools.ietf.org/html/rfc3447#page-17 RFC3447#page-17}: * * Both the encryption and the decryption operations of RSAES-OAEP take * the value of a label L as input. In this version of PKCS #1, L is * the empty string; other uses of the label are outside the scope of * this document. * * @param string $label */ public function withLabel($label) { $new = clone $this; $new->label = $label; return $new; } /** * Returns the label currently being used * */ public function getLabel() { return $this->label; } /** * Determines the padding modes * * Example: $key->withPadding(RSA::ENCRYPTION_PKCS1 | RSA::SIGNATURE_PKCS1); * * @param int $padding */ public function withPadding($padding) { $masks = [ self::ENCRYPTION_OAEP, self::ENCRYPTION_PKCS1, self::ENCRYPTION_NONE ]; $numSelected = 0; $selected = 0; foreach ($masks as $mask) { if ($padding & $mask) { $selected = $mask; $numSelected++; } } if ($numSelected > 1) { throw new InconsistentSetupException('Multiple encryption padding modes have been selected; at most only one should be selected'); } $encryptionPadding = $selected; $masks = [ self::SIGNATURE_PSS, self::SIGNATURE_RELAXED_PKCS1, self::SIGNATURE_PKCS1 ]; $numSelected = 0; $selected = 0; foreach ($masks as $mask) { if ($padding & $mask) { $selected = $mask; $numSelected++; } } if ($numSelected > 1) { throw new InconsistentSetupException('Multiple signature padding modes have been selected; at most only one should be selected'); } $signaturePadding = $selected; $new = clone $this; $new->encryptionPadding = $encryptionPadding; $new->signaturePadding = $signaturePadding; return $new; } /** * Returns the padding currently being used * */ public function getPadding() { return $this->signaturePadding | $this->encryptionPadding; } /** * Returns the current engine being used * * OpenSSL is only used in this class (and it's subclasses) for key generation * Even then it depends on the parameters you're using. It's not used for * multi-prime RSA nor is it used if the key length is outside of the range * supported by OpenSSL * * @see self::useInternalEngine() * @see self::useBestEngine() * @return string */ public function getEngine() { if (!isset(self::$engines['PHP'])) { self::useBestEngine(); } return self::$engines['OpenSSL'] && self::$defaultExponent == 65537 ? 'OpenSSL' : 'PHP'; } /** * Enable RSA Blinding * */ public static function enableBlinding() { static::$enableBlinding = true; } /** * Disable RSA Blinding * */ public static function disableBlinding() { static::$enableBlinding = false; } } * setKey('12345678901234567890123456789012'); * * $plaintext = str_repeat('a', 1024); * * echo $twofish->decrypt($twofish->encrypt($plaintext)); * ?> * * * @author Jim Wigginton * @author Hans-Juergen Petrich * @copyright 2007 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Crypt\Common\BlockCipher; use phpseclib3\Exception\BadModeException; /** * Pure-PHP implementation of Twofish. * * @author Jim Wigginton * @author Hans-Juergen Petrich */ class Twofish extends BlockCipher { /** * The mcrypt specific name of the cipher * * @see \phpseclib3\Crypt\Common\SymmetricKey::cipher_name_mcrypt * @var string */ protected $cipher_name_mcrypt = 'twofish'; /** * Optimizing value while CFB-encrypting * * @see \phpseclib3\Crypt\Common\SymmetricKey::cfb_init_len * @var int */ protected $cfb_init_len = 800; /** * Q-Table * * @var array */ private static $q0 = [ 0xA9, 0x67, 0xB3, 0xE8, 0x04, 0xFD, 0xA3, 0x76, 0x9A, 0x92, 0x80, 0x78, 0xE4, 0xDD, 0xD1, 0x38, 0x0D, 0xC6, 0x35, 0x98, 0x18, 0xF7, 0xEC, 0x6C, 0x43, 0x75, 0x37, 0x26, 0xFA, 0x13, 0x94, 0x48, 0xF2, 0xD0, 0x8B, 0x30, 0x84, 0x54, 0xDF, 0x23, 0x19, 0x5B, 0x3D, 0x59, 0xF3, 0xAE, 0xA2, 0x82, 0x63, 0x01, 0x83, 0x2E, 0xD9, 0x51, 0x9B, 0x7C, 0xA6, 0xEB, 0xA5, 0xBE, 0x16, 0x0C, 0xE3, 0x61, 0xC0, 0x8C, 0x3A, 0xF5, 0x73, 0x2C, 0x25, 0x0B, 0xBB, 0x4E, 0x89, 0x6B, 0x53, 0x6A, 0xB4, 0xF1, 0xE1, 0xE6, 0xBD, 0x45, 0xE2, 0xF4, 0xB6, 0x66, 0xCC, 0x95, 0x03, 0x56, 0xD4, 0x1C, 0x1E, 0xD7, 0xFB, 0xC3, 0x8E, 0xB5, 0xE9, 0xCF, 0xBF, 0xBA, 0xEA, 0x77, 0x39, 0xAF, 0x33, 0xC9, 0x62, 0x71, 0x81, 0x79, 0x09, 0xAD, 0x24, 0xCD, 0xF9, 0xD8, 0xE5, 0xC5, 0xB9, 0x4D, 0x44, 0x08, 0x86, 0xE7, 0xA1, 0x1D, 0xAA, 0xED, 0x06, 0x70, 0xB2, 0xD2, 0x41, 0x7B, 0xA0, 0x11, 0x31, 0xC2, 0x27, 0x90, 0x20, 0xF6, 0x60, 0xFF, 0x96, 0x5C, 0xB1, 0xAB, 0x9E, 0x9C, 0x52, 0x1B, 0x5F, 0x93, 0x0A, 0xEF, 0x91, 0x85, 0x49, 0xEE, 0x2D, 0x4F, 0x8F, 0x3B, 0x47, 0x87, 0x6D, 0x46, 0xD6, 0x3E, 0x69, 0x64, 0x2A, 0xCE, 0xCB, 0x2F, 0xFC, 0x97, 0x05, 0x7A, 0xAC, 0x7F, 0xD5, 0x1A, 0x4B, 0x0E, 0xA7, 0x5A, 0x28, 0x14, 0x3F, 0x29, 0x88, 0x3C, 0x4C, 0x02, 0xB8, 0xDA, 0xB0, 0x17, 0x55, 0x1F, 0x8A, 0x7D, 0x57, 0xC7, 0x8D, 0x74, 0xB7, 0xC4, 0x9F, 0x72, 0x7E, 0x15, 0x22, 0x12, 0x58, 0x07, 0x99, 0x34, 0x6E, 0x50, 0xDE, 0x68, 0x65, 0xBC, 0xDB, 0xF8, 0xC8, 0xA8, 0x2B, 0x40, 0xDC, 0xFE, 0x32, 0xA4, 0xCA, 0x10, 0x21, 0xF0, 0xD3, 0x5D, 0x0F, 0x00, 0x6F, 0x9D, 0x36, 0x42, 0x4A, 0x5E, 0xC1, 0xE0 ]; /** * Q-Table * * @var array */ private static $q1 = [ 0x75, 0xF3, 0xC6, 0xF4, 0xDB, 0x7B, 0xFB, 0xC8, 0x4A, 0xD3, 0xE6, 0x6B, 0x45, 0x7D, 0xE8, 0x4B, 0xD6, 0x32, 0xD8, 0xFD, 0x37, 0x71, 0xF1, 0xE1, 0x30, 0x0F, 0xF8, 0x1B, 0x87, 0xFA, 0x06, 0x3F, 0x5E, 0xBA, 0xAE, 0x5B, 0x8A, 0x00, 0xBC, 0x9D, 0x6D, 0xC1, 0xB1, 0x0E, 0x80, 0x5D, 0xD2, 0xD5, 0xA0, 0x84, 0x07, 0x14, 0xB5, 0x90, 0x2C, 0xA3, 0xB2, 0x73, 0x4C, 0x54, 0x92, 0x74, 0x36, 0x51, 0x38, 0xB0, 0xBD, 0x5A, 0xFC, 0x60, 0x62, 0x96, 0x6C, 0x42, 0xF7, 0x10, 0x7C, 0x28, 0x27, 0x8C, 0x13, 0x95, 0x9C, 0xC7, 0x24, 0x46, 0x3B, 0x70, 0xCA, 0xE3, 0x85, 0xCB, 0x11, 0xD0, 0x93, 0xB8, 0xA6, 0x83, 0x20, 0xFF, 0x9F, 0x77, 0xC3, 0xCC, 0x03, 0x6F, 0x08, 0xBF, 0x40, 0xE7, 0x2B, 0xE2, 0x79, 0x0C, 0xAA, 0x82, 0x41, 0x3A, 0xEA, 0xB9, 0xE4, 0x9A, 0xA4, 0x97, 0x7E, 0xDA, 0x7A, 0x17, 0x66, 0x94, 0xA1, 0x1D, 0x3D, 0xF0, 0xDE, 0xB3, 0x0B, 0x72, 0xA7, 0x1C, 0xEF, 0xD1, 0x53, 0x3E, 0x8F, 0x33, 0x26, 0x5F, 0xEC, 0x76, 0x2A, 0x49, 0x81, 0x88, 0xEE, 0x21, 0xC4, 0x1A, 0xEB, 0xD9, 0xC5, 0x39, 0x99, 0xCD, 0xAD, 0x31, 0x8B, 0x01, 0x18, 0x23, 0xDD, 0x1F, 0x4E, 0x2D, 0xF9, 0x48, 0x4F, 0xF2, 0x65, 0x8E, 0x78, 0x5C, 0x58, 0x19, 0x8D, 0xE5, 0x98, 0x57, 0x67, 0x7F, 0x05, 0x64, 0xAF, 0x63, 0xB6, 0xFE, 0xF5, 0xB7, 0x3C, 0xA5, 0xCE, 0xE9, 0x68, 0x44, 0xE0, 0x4D, 0x43, 0x69, 0x29, 0x2E, 0xAC, 0x15, 0x59, 0xA8, 0x0A, 0x9E, 0x6E, 0x47, 0xDF, 0x34, 0x35, 0x6A, 0xCF, 0xDC, 0x22, 0xC9, 0xC0, 0x9B, 0x89, 0xD4, 0xED, 0xAB, 0x12, 0xA2, 0x0D, 0x52, 0xBB, 0x02, 0x2F, 0xA9, 0xD7, 0x61, 0x1E, 0xB4, 0x50, 0x04, 0xF6, 0xC2, 0x16, 0x25, 0x86, 0x56, 0x55, 0x09, 0xBE, 0x91 ]; /** * M-Table * * @var array */ private static $m0 = [ 0xBCBC3275, 0xECEC21F3, 0x202043C6, 0xB3B3C9F4, 0xDADA03DB, 0x02028B7B, 0xE2E22BFB, 0x9E9EFAC8, 0xC9C9EC4A, 0xD4D409D3, 0x18186BE6, 0x1E1E9F6B, 0x98980E45, 0xB2B2387D, 0xA6A6D2E8, 0x2626B74B, 0x3C3C57D6, 0x93938A32, 0x8282EED8, 0x525298FD, 0x7B7BD437, 0xBBBB3771, 0x5B5B97F1, 0x474783E1, 0x24243C30, 0x5151E20F, 0xBABAC6F8, 0x4A4AF31B, 0xBFBF4887, 0x0D0D70FA, 0xB0B0B306, 0x7575DE3F, 0xD2D2FD5E, 0x7D7D20BA, 0x666631AE, 0x3A3AA35B, 0x59591C8A, 0x00000000, 0xCDCD93BC, 0x1A1AE09D, 0xAEAE2C6D, 0x7F7FABC1, 0x2B2BC7B1, 0xBEBEB90E, 0xE0E0A080, 0x8A8A105D, 0x3B3B52D2, 0x6464BAD5, 0xD8D888A0, 0xE7E7A584, 0x5F5FE807, 0x1B1B1114, 0x2C2CC2B5, 0xFCFCB490, 0x3131272C, 0x808065A3, 0x73732AB2, 0x0C0C8173, 0x79795F4C, 0x6B6B4154, 0x4B4B0292, 0x53536974, 0x94948F36, 0x83831F51, 0x2A2A3638, 0xC4C49CB0, 0x2222C8BD, 0xD5D5F85A, 0xBDBDC3FC, 0x48487860, 0xFFFFCE62, 0x4C4C0796, 0x4141776C, 0xC7C7E642, 0xEBEB24F7, 0x1C1C1410, 0x5D5D637C, 0x36362228, 0x6767C027, 0xE9E9AF8C, 0x4444F913, 0x1414EA95, 0xF5F5BB9C, 0xCFCF18C7, 0x3F3F2D24, 0xC0C0E346, 0x7272DB3B, 0x54546C70, 0x29294CCA, 0xF0F035E3, 0x0808FE85, 0xC6C617CB, 0xF3F34F11, 0x8C8CE4D0, 0xA4A45993, 0xCACA96B8, 0x68683BA6, 0xB8B84D83, 0x38382820, 0xE5E52EFF, 0xADAD569F, 0x0B0B8477, 0xC8C81DC3, 0x9999FFCC, 0x5858ED03, 0x19199A6F, 0x0E0E0A08, 0x95957EBF, 0x70705040, 0xF7F730E7, 0x6E6ECF2B, 0x1F1F6EE2, 0xB5B53D79, 0x09090F0C, 0x616134AA, 0x57571682, 0x9F9F0B41, 0x9D9D803A, 0x111164EA, 0x2525CDB9, 0xAFAFDDE4, 0x4545089A, 0xDFDF8DA4, 0xA3A35C97, 0xEAEAD57E, 0x353558DA, 0xEDEDD07A, 0x4343FC17, 0xF8F8CB66, 0xFBFBB194, 0x3737D3A1, 0xFAFA401D, 0xC2C2683D, 0xB4B4CCF0, 0x32325DDE, 0x9C9C71B3, 0x5656E70B, 0xE3E3DA72, 0x878760A7, 0x15151B1C, 0xF9F93AEF, 0x6363BFD1, 0x3434A953, 0x9A9A853E, 0xB1B1428F, 0x7C7CD133, 0x88889B26, 0x3D3DA65F, 0xA1A1D7EC, 0xE4E4DF76, 0x8181942A, 0x91910149, 0x0F0FFB81, 0xEEEEAA88, 0x161661EE, 0xD7D77321, 0x9797F5C4, 0xA5A5A81A, 0xFEFE3FEB, 0x6D6DB5D9, 0x7878AEC5, 0xC5C56D39, 0x1D1DE599, 0x7676A4CD, 0x3E3EDCAD, 0xCBCB6731, 0xB6B6478B, 0xEFEF5B01, 0x12121E18, 0x6060C523, 0x6A6AB0DD, 0x4D4DF61F, 0xCECEE94E, 0xDEDE7C2D, 0x55559DF9, 0x7E7E5A48, 0x2121B24F, 0x03037AF2, 0xA0A02665, 0x5E5E198E, 0x5A5A6678, 0x65654B5C, 0x62624E58, 0xFDFD4519, 0x0606F48D, 0x404086E5, 0xF2F2BE98, 0x3333AC57, 0x17179067, 0x05058E7F, 0xE8E85E05, 0x4F4F7D64, 0x89896AAF, 0x10109563, 0x74742FB6, 0x0A0A75FE, 0x5C5C92F5, 0x9B9B74B7, 0x2D2D333C, 0x3030D6A5, 0x2E2E49CE, 0x494989E9, 0x46467268, 0x77775544, 0xA8A8D8E0, 0x9696044D, 0x2828BD43, 0xA9A92969, 0xD9D97929, 0x8686912E, 0xD1D187AC, 0xF4F44A15, 0x8D8D1559, 0xD6D682A8, 0xB9B9BC0A, 0x42420D9E, 0xF6F6C16E, 0x2F2FB847, 0xDDDD06DF, 0x23233934, 0xCCCC6235, 0xF1F1C46A, 0xC1C112CF, 0x8585EBDC, 0x8F8F9E22, 0x7171A1C9, 0x9090F0C0, 0xAAAA539B, 0x0101F189, 0x8B8BE1D4, 0x4E4E8CED, 0x8E8E6FAB, 0xABABA212, 0x6F6F3EA2, 0xE6E6540D, 0xDBDBF252, 0x92927BBB, 0xB7B7B602, 0x6969CA2F, 0x3939D9A9, 0xD3D30CD7, 0xA7A72361, 0xA2A2AD1E, 0xC3C399B4, 0x6C6C4450, 0x07070504, 0x04047FF6, 0x272746C2, 0xACACA716, 0xD0D07625, 0x50501386, 0xDCDCF756, 0x84841A55, 0xE1E15109, 0x7A7A25BE, 0x1313EF91 ]; /** * M-Table * * @var array */ private static $m1 = [ 0xA9D93939, 0x67901717, 0xB3719C9C, 0xE8D2A6A6, 0x04050707, 0xFD985252, 0xA3658080, 0x76DFE4E4, 0x9A084545, 0x92024B4B, 0x80A0E0E0, 0x78665A5A, 0xE4DDAFAF, 0xDDB06A6A, 0xD1BF6363, 0x38362A2A, 0x0D54E6E6, 0xC6432020, 0x3562CCCC, 0x98BEF2F2, 0x181E1212, 0xF724EBEB, 0xECD7A1A1, 0x6C774141, 0x43BD2828, 0x7532BCBC, 0x37D47B7B, 0x269B8888, 0xFA700D0D, 0x13F94444, 0x94B1FBFB, 0x485A7E7E, 0xF27A0303, 0xD0E48C8C, 0x8B47B6B6, 0x303C2424, 0x84A5E7E7, 0x54416B6B, 0xDF06DDDD, 0x23C56060, 0x1945FDFD, 0x5BA33A3A, 0x3D68C2C2, 0x59158D8D, 0xF321ECEC, 0xAE316666, 0xA23E6F6F, 0x82165757, 0x63951010, 0x015BEFEF, 0x834DB8B8, 0x2E918686, 0xD9B56D6D, 0x511F8383, 0x9B53AAAA, 0x7C635D5D, 0xA63B6868, 0xEB3FFEFE, 0xA5D63030, 0xBE257A7A, 0x16A7ACAC, 0x0C0F0909, 0xE335F0F0, 0x6123A7A7, 0xC0F09090, 0x8CAFE9E9, 0x3A809D9D, 0xF5925C5C, 0x73810C0C, 0x2C273131, 0x2576D0D0, 0x0BE75656, 0xBB7B9292, 0x4EE9CECE, 0x89F10101, 0x6B9F1E1E, 0x53A93434, 0x6AC4F1F1, 0xB499C3C3, 0xF1975B5B, 0xE1834747, 0xE66B1818, 0xBDC82222, 0x450E9898, 0xE26E1F1F, 0xF4C9B3B3, 0xB62F7474, 0x66CBF8F8, 0xCCFF9999, 0x95EA1414, 0x03ED5858, 0x56F7DCDC, 0xD4E18B8B, 0x1C1B1515, 0x1EADA2A2, 0xD70CD3D3, 0xFB2BE2E2, 0xC31DC8C8, 0x8E195E5E, 0xB5C22C2C, 0xE9894949, 0xCF12C1C1, 0xBF7E9595, 0xBA207D7D, 0xEA641111, 0x77840B0B, 0x396DC5C5, 0xAF6A8989, 0x33D17C7C, 0xC9A17171, 0x62CEFFFF, 0x7137BBBB, 0x81FB0F0F, 0x793DB5B5, 0x0951E1E1, 0xADDC3E3E, 0x242D3F3F, 0xCDA47676, 0xF99D5555, 0xD8EE8282, 0xE5864040, 0xC5AE7878, 0xB9CD2525, 0x4D049696, 0x44557777, 0x080A0E0E, 0x86135050, 0xE730F7F7, 0xA1D33737, 0x1D40FAFA, 0xAA346161, 0xED8C4E4E, 0x06B3B0B0, 0x706C5454, 0xB22A7373, 0xD2523B3B, 0x410B9F9F, 0x7B8B0202, 0xA088D8D8, 0x114FF3F3, 0x3167CBCB, 0xC2462727, 0x27C06767, 0x90B4FCFC, 0x20283838, 0xF67F0404, 0x60784848, 0xFF2EE5E5, 0x96074C4C, 0x5C4B6565, 0xB1C72B2B, 0xAB6F8E8E, 0x9E0D4242, 0x9CBBF5F5, 0x52F2DBDB, 0x1BF34A4A, 0x5FA63D3D, 0x9359A4A4, 0x0ABCB9B9, 0xEF3AF9F9, 0x91EF1313, 0x85FE0808, 0x49019191, 0xEE611616, 0x2D7CDEDE, 0x4FB22121, 0x8F42B1B1, 0x3BDB7272, 0x47B82F2F, 0x8748BFBF, 0x6D2CAEAE, 0x46E3C0C0, 0xD6573C3C, 0x3E859A9A, 0x6929A9A9, 0x647D4F4F, 0x2A948181, 0xCE492E2E, 0xCB17C6C6, 0x2FCA6969, 0xFCC3BDBD, 0x975CA3A3, 0x055EE8E8, 0x7AD0EDED, 0xAC87D1D1, 0x7F8E0505, 0xD5BA6464, 0x1AA8A5A5, 0x4BB72626, 0x0EB9BEBE, 0xA7608787, 0x5AF8D5D5, 0x28223636, 0x14111B1B, 0x3FDE7575, 0x2979D9D9, 0x88AAEEEE, 0x3C332D2D, 0x4C5F7979, 0x02B6B7B7, 0xB896CACA, 0xDA583535, 0xB09CC4C4, 0x17FC4343, 0x551A8484, 0x1FF64D4D, 0x8A1C5959, 0x7D38B2B2, 0x57AC3333, 0xC718CFCF, 0x8DF40606, 0x74695353, 0xB7749B9B, 0xC4F59797, 0x9F56ADAD, 0x72DAE3E3, 0x7ED5EAEA, 0x154AF4F4, 0x229E8F8F, 0x12A2ABAB, 0x584E6262, 0x07E85F5F, 0x99E51D1D, 0x34392323, 0x6EC1F6F6, 0x50446C6C, 0xDE5D3232, 0x68724646, 0x6526A0A0, 0xBC93CDCD, 0xDB03DADA, 0xF8C6BABA, 0xC8FA9E9E, 0xA882D6D6, 0x2BCF6E6E, 0x40507070, 0xDCEB8585, 0xFE750A0A, 0x328A9393, 0xA48DDFDF, 0xCA4C2929, 0x10141C1C, 0x2173D7D7, 0xF0CCB4B4, 0xD309D4D4, 0x5D108A8A, 0x0FE25151, 0x00000000, 0x6F9A1919, 0x9DE01A1A, 0x368F9494, 0x42E6C7C7, 0x4AECC9C9, 0x5EFDD2D2, 0xC1AB7F7F, 0xE0D8A8A8 ]; /** * M-Table * * @var array */ private static $m2 = [ 0xBC75BC32, 0xECF3EC21, 0x20C62043, 0xB3F4B3C9, 0xDADBDA03, 0x027B028B, 0xE2FBE22B, 0x9EC89EFA, 0xC94AC9EC, 0xD4D3D409, 0x18E6186B, 0x1E6B1E9F, 0x9845980E, 0xB27DB238, 0xA6E8A6D2, 0x264B26B7, 0x3CD63C57, 0x9332938A, 0x82D882EE, 0x52FD5298, 0x7B377BD4, 0xBB71BB37, 0x5BF15B97, 0x47E14783, 0x2430243C, 0x510F51E2, 0xBAF8BAC6, 0x4A1B4AF3, 0xBF87BF48, 0x0DFA0D70, 0xB006B0B3, 0x753F75DE, 0xD25ED2FD, 0x7DBA7D20, 0x66AE6631, 0x3A5B3AA3, 0x598A591C, 0x00000000, 0xCDBCCD93, 0x1A9D1AE0, 0xAE6DAE2C, 0x7FC17FAB, 0x2BB12BC7, 0xBE0EBEB9, 0xE080E0A0, 0x8A5D8A10, 0x3BD23B52, 0x64D564BA, 0xD8A0D888, 0xE784E7A5, 0x5F075FE8, 0x1B141B11, 0x2CB52CC2, 0xFC90FCB4, 0x312C3127, 0x80A38065, 0x73B2732A, 0x0C730C81, 0x794C795F, 0x6B546B41, 0x4B924B02, 0x53745369, 0x9436948F, 0x8351831F, 0x2A382A36, 0xC4B0C49C, 0x22BD22C8, 0xD55AD5F8, 0xBDFCBDC3, 0x48604878, 0xFF62FFCE, 0x4C964C07, 0x416C4177, 0xC742C7E6, 0xEBF7EB24, 0x1C101C14, 0x5D7C5D63, 0x36283622, 0x672767C0, 0xE98CE9AF, 0x441344F9, 0x149514EA, 0xF59CF5BB, 0xCFC7CF18, 0x3F243F2D, 0xC046C0E3, 0x723B72DB, 0x5470546C, 0x29CA294C, 0xF0E3F035, 0x088508FE, 0xC6CBC617, 0xF311F34F, 0x8CD08CE4, 0xA493A459, 0xCAB8CA96, 0x68A6683B, 0xB883B84D, 0x38203828, 0xE5FFE52E, 0xAD9FAD56, 0x0B770B84, 0xC8C3C81D, 0x99CC99FF, 0x580358ED, 0x196F199A, 0x0E080E0A, 0x95BF957E, 0x70407050, 0xF7E7F730, 0x6E2B6ECF, 0x1FE21F6E, 0xB579B53D, 0x090C090F, 0x61AA6134, 0x57825716, 0x9F419F0B, 0x9D3A9D80, 0x11EA1164, 0x25B925CD, 0xAFE4AFDD, 0x459A4508, 0xDFA4DF8D, 0xA397A35C, 0xEA7EEAD5, 0x35DA3558, 0xED7AEDD0, 0x431743FC, 0xF866F8CB, 0xFB94FBB1, 0x37A137D3, 0xFA1DFA40, 0xC23DC268, 0xB4F0B4CC, 0x32DE325D, 0x9CB39C71, 0x560B56E7, 0xE372E3DA, 0x87A78760, 0x151C151B, 0xF9EFF93A, 0x63D163BF, 0x345334A9, 0x9A3E9A85, 0xB18FB142, 0x7C337CD1, 0x8826889B, 0x3D5F3DA6, 0xA1ECA1D7, 0xE476E4DF, 0x812A8194, 0x91499101, 0x0F810FFB, 0xEE88EEAA, 0x16EE1661, 0xD721D773, 0x97C497F5, 0xA51AA5A8, 0xFEEBFE3F, 0x6DD96DB5, 0x78C578AE, 0xC539C56D, 0x1D991DE5, 0x76CD76A4, 0x3EAD3EDC, 0xCB31CB67, 0xB68BB647, 0xEF01EF5B, 0x1218121E, 0x602360C5, 0x6ADD6AB0, 0x4D1F4DF6, 0xCE4ECEE9, 0xDE2DDE7C, 0x55F9559D, 0x7E487E5A, 0x214F21B2, 0x03F2037A, 0xA065A026, 0x5E8E5E19, 0x5A785A66, 0x655C654B, 0x6258624E, 0xFD19FD45, 0x068D06F4, 0x40E54086, 0xF298F2BE, 0x335733AC, 0x17671790, 0x057F058E, 0xE805E85E, 0x4F644F7D, 0x89AF896A, 0x10631095, 0x74B6742F, 0x0AFE0A75, 0x5CF55C92, 0x9BB79B74, 0x2D3C2D33, 0x30A530D6, 0x2ECE2E49, 0x49E94989, 0x46684672, 0x77447755, 0xA8E0A8D8, 0x964D9604, 0x284328BD, 0xA969A929, 0xD929D979, 0x862E8691, 0xD1ACD187, 0xF415F44A, 0x8D598D15, 0xD6A8D682, 0xB90AB9BC, 0x429E420D, 0xF66EF6C1, 0x2F472FB8, 0xDDDFDD06, 0x23342339, 0xCC35CC62, 0xF16AF1C4, 0xC1CFC112, 0x85DC85EB, 0x8F228F9E, 0x71C971A1, 0x90C090F0, 0xAA9BAA53, 0x018901F1, 0x8BD48BE1, 0x4EED4E8C, 0x8EAB8E6F, 0xAB12ABA2, 0x6FA26F3E, 0xE60DE654, 0xDB52DBF2, 0x92BB927B, 0xB702B7B6, 0x692F69CA, 0x39A939D9, 0xD3D7D30C, 0xA761A723, 0xA21EA2AD, 0xC3B4C399, 0x6C506C44, 0x07040705, 0x04F6047F, 0x27C22746, 0xAC16ACA7, 0xD025D076, 0x50865013, 0xDC56DCF7, 0x8455841A, 0xE109E151, 0x7ABE7A25, 0x139113EF ]; /** * M-Table * * @var array */ private static $m3 = [ 0xD939A9D9, 0x90176790, 0x719CB371, 0xD2A6E8D2, 0x05070405, 0x9852FD98, 0x6580A365, 0xDFE476DF, 0x08459A08, 0x024B9202, 0xA0E080A0, 0x665A7866, 0xDDAFE4DD, 0xB06ADDB0, 0xBF63D1BF, 0x362A3836, 0x54E60D54, 0x4320C643, 0x62CC3562, 0xBEF298BE, 0x1E12181E, 0x24EBF724, 0xD7A1ECD7, 0x77416C77, 0xBD2843BD, 0x32BC7532, 0xD47B37D4, 0x9B88269B, 0x700DFA70, 0xF94413F9, 0xB1FB94B1, 0x5A7E485A, 0x7A03F27A, 0xE48CD0E4, 0x47B68B47, 0x3C24303C, 0xA5E784A5, 0x416B5441, 0x06DDDF06, 0xC56023C5, 0x45FD1945, 0xA33A5BA3, 0x68C23D68, 0x158D5915, 0x21ECF321, 0x3166AE31, 0x3E6FA23E, 0x16578216, 0x95106395, 0x5BEF015B, 0x4DB8834D, 0x91862E91, 0xB56DD9B5, 0x1F83511F, 0x53AA9B53, 0x635D7C63, 0x3B68A63B, 0x3FFEEB3F, 0xD630A5D6, 0x257ABE25, 0xA7AC16A7, 0x0F090C0F, 0x35F0E335, 0x23A76123, 0xF090C0F0, 0xAFE98CAF, 0x809D3A80, 0x925CF592, 0x810C7381, 0x27312C27, 0x76D02576, 0xE7560BE7, 0x7B92BB7B, 0xE9CE4EE9, 0xF10189F1, 0x9F1E6B9F, 0xA93453A9, 0xC4F16AC4, 0x99C3B499, 0x975BF197, 0x8347E183, 0x6B18E66B, 0xC822BDC8, 0x0E98450E, 0x6E1FE26E, 0xC9B3F4C9, 0x2F74B62F, 0xCBF866CB, 0xFF99CCFF, 0xEA1495EA, 0xED5803ED, 0xF7DC56F7, 0xE18BD4E1, 0x1B151C1B, 0xADA21EAD, 0x0CD3D70C, 0x2BE2FB2B, 0x1DC8C31D, 0x195E8E19, 0xC22CB5C2, 0x8949E989, 0x12C1CF12, 0x7E95BF7E, 0x207DBA20, 0x6411EA64, 0x840B7784, 0x6DC5396D, 0x6A89AF6A, 0xD17C33D1, 0xA171C9A1, 0xCEFF62CE, 0x37BB7137, 0xFB0F81FB, 0x3DB5793D, 0x51E10951, 0xDC3EADDC, 0x2D3F242D, 0xA476CDA4, 0x9D55F99D, 0xEE82D8EE, 0x8640E586, 0xAE78C5AE, 0xCD25B9CD, 0x04964D04, 0x55774455, 0x0A0E080A, 0x13508613, 0x30F7E730, 0xD337A1D3, 0x40FA1D40, 0x3461AA34, 0x8C4EED8C, 0xB3B006B3, 0x6C54706C, 0x2A73B22A, 0x523BD252, 0x0B9F410B, 0x8B027B8B, 0x88D8A088, 0x4FF3114F, 0x67CB3167, 0x4627C246, 0xC06727C0, 0xB4FC90B4, 0x28382028, 0x7F04F67F, 0x78486078, 0x2EE5FF2E, 0x074C9607, 0x4B655C4B, 0xC72BB1C7, 0x6F8EAB6F, 0x0D429E0D, 0xBBF59CBB, 0xF2DB52F2, 0xF34A1BF3, 0xA63D5FA6, 0x59A49359, 0xBCB90ABC, 0x3AF9EF3A, 0xEF1391EF, 0xFE0885FE, 0x01914901, 0x6116EE61, 0x7CDE2D7C, 0xB2214FB2, 0x42B18F42, 0xDB723BDB, 0xB82F47B8, 0x48BF8748, 0x2CAE6D2C, 0xE3C046E3, 0x573CD657, 0x859A3E85, 0x29A96929, 0x7D4F647D, 0x94812A94, 0x492ECE49, 0x17C6CB17, 0xCA692FCA, 0xC3BDFCC3, 0x5CA3975C, 0x5EE8055E, 0xD0ED7AD0, 0x87D1AC87, 0x8E057F8E, 0xBA64D5BA, 0xA8A51AA8, 0xB7264BB7, 0xB9BE0EB9, 0x6087A760, 0xF8D55AF8, 0x22362822, 0x111B1411, 0xDE753FDE, 0x79D92979, 0xAAEE88AA, 0x332D3C33, 0x5F794C5F, 0xB6B702B6, 0x96CAB896, 0x5835DA58, 0x9CC4B09C, 0xFC4317FC, 0x1A84551A, 0xF64D1FF6, 0x1C598A1C, 0x38B27D38, 0xAC3357AC, 0x18CFC718, 0xF4068DF4, 0x69537469, 0x749BB774, 0xF597C4F5, 0x56AD9F56, 0xDAE372DA, 0xD5EA7ED5, 0x4AF4154A, 0x9E8F229E, 0xA2AB12A2, 0x4E62584E, 0xE85F07E8, 0xE51D99E5, 0x39233439, 0xC1F66EC1, 0x446C5044, 0x5D32DE5D, 0x72466872, 0x26A06526, 0x93CDBC93, 0x03DADB03, 0xC6BAF8C6, 0xFA9EC8FA, 0x82D6A882, 0xCF6E2BCF, 0x50704050, 0xEB85DCEB, 0x750AFE75, 0x8A93328A, 0x8DDFA48D, 0x4C29CA4C, 0x141C1014, 0x73D72173, 0xCCB4F0CC, 0x09D4D309, 0x108A5D10, 0xE2510FE2, 0x00000000, 0x9A196F9A, 0xE01A9DE0, 0x8F94368F, 0xE6C742E6, 0xECC94AEC, 0xFDD25EFD, 0xAB7FC1AB, 0xD8A8E0D8 ]; /** * The Key Schedule Array * * @var array */ private $K = []; /** * The Key depended S-Table 0 * * @var array */ private $S0 = []; /** * The Key depended S-Table 1 * * @var array */ private $S1 = []; /** * The Key depended S-Table 2 * * @var array */ private $S2 = []; /** * The Key depended S-Table 3 * * @var array */ private $S3 = []; /** * Holds the last used key * * @var array */ private $kl; /** * The Key Length (in bytes) * * @see Crypt_Twofish::setKeyLength() * @var int */ protected $key_length = 16; /** * Default Constructor. * * @param string $mode * @throws BadModeException if an invalid / unsupported mode is provided */ public function __construct($mode) { parent::__construct($mode); if ($this->mode == self::MODE_STREAM) { throw new BadModeException('Block ciphers cannot be ran in stream mode'); } } /** * Initialize Static Variables */ protected static function initialize_static_variables() { if (is_float(self::$m3[0])) { self::$m0 = array_map('intval', self::$m0); self::$m1 = array_map('intval', self::$m1); self::$m2 = array_map('intval', self::$m2); self::$m3 = array_map('intval', self::$m3); self::$q0 = array_map('intval', self::$q0); self::$q1 = array_map('intval', self::$q1); } parent::initialize_static_variables(); } /** * Sets the key length. * * Valid key lengths are 128, 192 or 256 bits * * @param int $length */ public function setKeyLength($length) { switch ($length) { case 128: case 192: case 256: break; default: throw new \LengthException('Key of size ' . $length . ' not supported by this algorithm. Only keys of sizes 16, 24 or 32 supported'); } parent::setKeyLength($length); } /** * Sets the key. * * Rijndael supports five different key lengths * * @see setKeyLength() * @param string $key * @throws \LengthException if the key length isn't supported */ public function setKey($key) { switch (strlen($key)) { case 16: case 24: case 32: break; default: throw new \LengthException('Key of size ' . strlen($key) . ' not supported by this algorithm. Only keys of sizes 16, 24 or 32 supported'); } parent::setKey($key); } /** * Setup the key (expansion) * * @see \phpseclib3\Crypt\Common\SymmetricKey::_setupKey() */ protected function setupKey() { if (isset($this->kl['key']) && $this->key === $this->kl['key']) { // already expanded return; } $this->kl = ['key' => $this->key]; /* Key expanding and generating the key-depended s-boxes */ $le_longs = unpack('V*', $this->key); $key = unpack('C*', $this->key); $m0 = self::$m0; $m1 = self::$m1; $m2 = self::$m2; $m3 = self::$m3; $q0 = self::$q0; $q1 = self::$q1; $K = $S0 = $S1 = $S2 = $S3 = []; switch (strlen($this->key)) { case 16: list($s7, $s6, $s5, $s4) = $this->mdsrem($le_longs[1], $le_longs[2]); list($s3, $s2, $s1, $s0) = $this->mdsrem($le_longs[3], $le_longs[4]); for ($i = 0, $j = 1; $i < 40; $i += 2, $j += 2) { $A = $m0[$q0[$q0[$i] ^ $key[ 9]] ^ $key[1]] ^ $m1[$q0[$q1[$i] ^ $key[10]] ^ $key[2]] ^ $m2[$q1[$q0[$i] ^ $key[11]] ^ $key[3]] ^ $m3[$q1[$q1[$i] ^ $key[12]] ^ $key[4]]; $B = $m0[$q0[$q0[$j] ^ $key[13]] ^ $key[5]] ^ $m1[$q0[$q1[$j] ^ $key[14]] ^ $key[6]] ^ $m2[$q1[$q0[$j] ^ $key[15]] ^ $key[7]] ^ $m3[$q1[$q1[$j] ^ $key[16]] ^ $key[8]]; $B = ($B << 8) | ($B >> 24 & 0xff); $A = self::safe_intval($A + $B); $K[] = $A; $A = self::safe_intval($A + $B); $K[] = ($A << 9 | $A >> 23 & 0x1ff); } for ($i = 0; $i < 256; ++$i) { $S0[$i] = $m0[$q0[$q0[$i] ^ $s4] ^ $s0]; $S1[$i] = $m1[$q0[$q1[$i] ^ $s5] ^ $s1]; $S2[$i] = $m2[$q1[$q0[$i] ^ $s6] ^ $s2]; $S3[$i] = $m3[$q1[$q1[$i] ^ $s7] ^ $s3]; } break; case 24: list($sb, $sa, $s9, $s8) = $this->mdsrem($le_longs[1], $le_longs[2]); list($s7, $s6, $s5, $s4) = $this->mdsrem($le_longs[3], $le_longs[4]); list($s3, $s2, $s1, $s0) = $this->mdsrem($le_longs[5], $le_longs[6]); for ($i = 0, $j = 1; $i < 40; $i += 2, $j += 2) { $A = $m0[$q0[$q0[$q1[$i] ^ $key[17]] ^ $key[ 9]] ^ $key[1]] ^ $m1[$q0[$q1[$q1[$i] ^ $key[18]] ^ $key[10]] ^ $key[2]] ^ $m2[$q1[$q0[$q0[$i] ^ $key[19]] ^ $key[11]] ^ $key[3]] ^ $m3[$q1[$q1[$q0[$i] ^ $key[20]] ^ $key[12]] ^ $key[4]]; $B = $m0[$q0[$q0[$q1[$j] ^ $key[21]] ^ $key[13]] ^ $key[5]] ^ $m1[$q0[$q1[$q1[$j] ^ $key[22]] ^ $key[14]] ^ $key[6]] ^ $m2[$q1[$q0[$q0[$j] ^ $key[23]] ^ $key[15]] ^ $key[7]] ^ $m3[$q1[$q1[$q0[$j] ^ $key[24]] ^ $key[16]] ^ $key[8]]; $B = ($B << 8) | ($B >> 24 & 0xff); $A = self::safe_intval($A + $B); $K[] = $A; $A = self::safe_intval($A + $B); $K[] = ($A << 9 | $A >> 23 & 0x1ff); } for ($i = 0; $i < 256; ++$i) { $S0[$i] = $m0[$q0[$q0[$q1[$i] ^ $s8] ^ $s4] ^ $s0]; $S1[$i] = $m1[$q0[$q1[$q1[$i] ^ $s9] ^ $s5] ^ $s1]; $S2[$i] = $m2[$q1[$q0[$q0[$i] ^ $sa] ^ $s6] ^ $s2]; $S3[$i] = $m3[$q1[$q1[$q0[$i] ^ $sb] ^ $s7] ^ $s3]; } break; default: // 32 list($sf, $se, $sd, $sc) = $this->mdsrem($le_longs[1], $le_longs[2]); list($sb, $sa, $s9, $s8) = $this->mdsrem($le_longs[3], $le_longs[4]); list($s7, $s6, $s5, $s4) = $this->mdsrem($le_longs[5], $le_longs[6]); list($s3, $s2, $s1, $s0) = $this->mdsrem($le_longs[7], $le_longs[8]); for ($i = 0, $j = 1; $i < 40; $i += 2, $j += 2) { $A = $m0[$q0[$q0[$q1[$q1[$i] ^ $key[25]] ^ $key[17]] ^ $key[ 9]] ^ $key[1]] ^ $m1[$q0[$q1[$q1[$q0[$i] ^ $key[26]] ^ $key[18]] ^ $key[10]] ^ $key[2]] ^ $m2[$q1[$q0[$q0[$q0[$i] ^ $key[27]] ^ $key[19]] ^ $key[11]] ^ $key[3]] ^ $m3[$q1[$q1[$q0[$q1[$i] ^ $key[28]] ^ $key[20]] ^ $key[12]] ^ $key[4]]; $B = $m0[$q0[$q0[$q1[$q1[$j] ^ $key[29]] ^ $key[21]] ^ $key[13]] ^ $key[5]] ^ $m1[$q0[$q1[$q1[$q0[$j] ^ $key[30]] ^ $key[22]] ^ $key[14]] ^ $key[6]] ^ $m2[$q1[$q0[$q0[$q0[$j] ^ $key[31]] ^ $key[23]] ^ $key[15]] ^ $key[7]] ^ $m3[$q1[$q1[$q0[$q1[$j] ^ $key[32]] ^ $key[24]] ^ $key[16]] ^ $key[8]]; $B = ($B << 8) | ($B >> 24 & 0xff); $A = self::safe_intval($A + $B); $K[] = $A; $A = self::safe_intval($A + $B); $K[] = ($A << 9 | $A >> 23 & 0x1ff); } for ($i = 0; $i < 256; ++$i) { $S0[$i] = $m0[$q0[$q0[$q1[$q1[$i] ^ $sc] ^ $s8] ^ $s4] ^ $s0]; $S1[$i] = $m1[$q0[$q1[$q1[$q0[$i] ^ $sd] ^ $s9] ^ $s5] ^ $s1]; $S2[$i] = $m2[$q1[$q0[$q0[$q0[$i] ^ $se] ^ $sa] ^ $s6] ^ $s2]; $S3[$i] = $m3[$q1[$q1[$q0[$q1[$i] ^ $sf] ^ $sb] ^ $s7] ^ $s3]; } } $this->K = $K; $this->S0 = $S0; $this->S1 = $S1; $this->S2 = $S2; $this->S3 = $S3; } /** * _mdsrem function using by the twofish cipher algorithm * * @param string $A * @param string $B * @return array */ private function mdsrem($A, $B) { // No gain by unrolling this loop. for ($i = 0; $i < 8; ++$i) { // Get most significant coefficient. $t = 0xff & ($B >> 24); // Shift the others up. $B = ($B << 8) | (0xff & ($A >> 24)); $A <<= 8; $u = $t << 1; // Subtract the modular polynomial on overflow. if ($t & 0x80) { $u ^= 0x14d; } // Remove t * (a * x^2 + 1). $B ^= $t ^ ($u << 16); // Form u = a*t + t/a = t*(a + 1/a). $u ^= 0x7fffffff & ($t >> 1); // Add the modular polynomial on underflow. if ($t & 0x01) { $u ^= 0xa6 ; } // Remove t * (a + 1/a) * (x^3 + x). $B ^= ($u << 24) | ($u << 8); } return [ 0xff & $B >> 24, 0xff & $B >> 16, 0xff & $B >> 8, 0xff & $B]; } /** * Encrypts a block * * @param string $in * @return string */ protected function encryptBlock($in) { $S0 = $this->S0; $S1 = $this->S1; $S2 = $this->S2; $S3 = $this->S3; $K = $this->K; $in = unpack("V4", $in); $R0 = $K[0] ^ $in[1]; $R1 = $K[1] ^ $in[2]; $R2 = $K[2] ^ $in[3]; $R3 = $K[3] ^ $in[4]; $ki = 7; while ($ki < 39) { $t0 = $S0[ $R0 & 0xff] ^ $S1[($R0 >> 8) & 0xff] ^ $S2[($R0 >> 16) & 0xff] ^ $S3[($R0 >> 24) & 0xff]; $t1 = $S0[($R1 >> 24) & 0xff] ^ $S1[ $R1 & 0xff] ^ $S2[($R1 >> 8) & 0xff] ^ $S3[($R1 >> 16) & 0xff]; $R2 ^= self::safe_intval($t0 + $t1 + $K[++$ki]); $R2 = ($R2 >> 1 & 0x7fffffff) | ($R2 << 31); $R3 = ((($R3 >> 31) & 1) | ($R3 << 1)) ^ self::safe_intval($t0 + ($t1 << 1) + $K[++$ki]); $t0 = $S0[ $R2 & 0xff] ^ $S1[($R2 >> 8) & 0xff] ^ $S2[($R2 >> 16) & 0xff] ^ $S3[($R2 >> 24) & 0xff]; $t1 = $S0[($R3 >> 24) & 0xff] ^ $S1[ $R3 & 0xff] ^ $S2[($R3 >> 8) & 0xff] ^ $S3[($R3 >> 16) & 0xff]; $R0 ^= self::safe_intval($t0 + $t1 + $K[++$ki]); $R0 = ($R0 >> 1 & 0x7fffffff) | ($R0 << 31); $R1 = ((($R1 >> 31) & 1) | ($R1 << 1)) ^ self::safe_intval($t0 + ($t1 << 1) + $K[++$ki]); } // @codingStandardsIgnoreStart return pack("V4", $K[4] ^ $R2, $K[5] ^ $R3, $K[6] ^ $R0, $K[7] ^ $R1); // @codingStandardsIgnoreEnd } /** * Decrypts a block * * @param string $in * @return string */ protected function decryptBlock($in) { $S0 = $this->S0; $S1 = $this->S1; $S2 = $this->S2; $S3 = $this->S3; $K = $this->K; $in = unpack("V4", $in); $R0 = $K[4] ^ $in[1]; $R1 = $K[5] ^ $in[2]; $R2 = $K[6] ^ $in[3]; $R3 = $K[7] ^ $in[4]; $ki = 40; while ($ki > 8) { $t0 = $S0[$R0 & 0xff] ^ $S1[$R0 >> 8 & 0xff] ^ $S2[$R0 >> 16 & 0xff] ^ $S3[$R0 >> 24 & 0xff]; $t1 = $S0[$R1 >> 24 & 0xff] ^ $S1[$R1 & 0xff] ^ $S2[$R1 >> 8 & 0xff] ^ $S3[$R1 >> 16 & 0xff]; $R3 ^= self::safe_intval($t0 + ($t1 << 1) + $K[--$ki]); $R3 = $R3 >> 1 & 0x7fffffff | $R3 << 31; $R2 = ($R2 >> 31 & 0x1 | $R2 << 1) ^ self::safe_intval($t0 + $t1 + $K[--$ki]); $t0 = $S0[$R2 & 0xff] ^ $S1[$R2 >> 8 & 0xff] ^ $S2[$R2 >> 16 & 0xff] ^ $S3[$R2 >> 24 & 0xff]; $t1 = $S0[$R3 >> 24 & 0xff] ^ $S1[$R3 & 0xff] ^ $S2[$R3 >> 8 & 0xff] ^ $S3[$R3 >> 16 & 0xff]; $R1 ^= self::safe_intval($t0 + ($t1 << 1) + $K[--$ki]); $R1 = $R1 >> 1 & 0x7fffffff | $R1 << 31; $R0 = ($R0 >> 31 & 0x1 | $R0 << 1) ^ self::safe_intval($t0 + $t1 + $K[--$ki]); } // @codingStandardsIgnoreStart return pack("V4", $K[0] ^ $R2, $K[1] ^ $R3, $K[2] ^ $R0, $K[3] ^ $R1); // @codingStandardsIgnoreEnd } /** * Setup the performance-optimized function for de/encrypt() * * @see \phpseclib3\Crypt\Common\SymmetricKey::_setupInlineCrypt() */ protected function setupInlineCrypt() { $K = $this->K; $init_crypt = ' static $S0, $S1, $S2, $S3; if (!$S0) { for ($i = 0; $i < 256; ++$i) { $S0[] = (int)$this->S0[$i]; $S1[] = (int)$this->S1[$i]; $S2[] = (int)$this->S2[$i]; $S3[] = (int)$this->S3[$i]; } } '; $safeint = self::safe_intval_inline(); // Generating encrypt code: $encrypt_block = ' $in = unpack("V4", $in); $R0 = ' . $K[0] . ' ^ $in[1]; $R1 = ' . $K[1] . ' ^ $in[2]; $R2 = ' . $K[2] . ' ^ $in[3]; $R3 = ' . $K[3] . ' ^ $in[4]; '; for ($ki = 7, $i = 0; $i < 8; ++$i) { $encrypt_block .= ' $t0 = $S0[ $R0 & 0xff] ^ $S1[($R0 >> 8) & 0xff] ^ $S2[($R0 >> 16) & 0xff] ^ $S3[($R0 >> 24) & 0xff]; $t1 = $S0[($R1 >> 24) & 0xff] ^ $S1[ $R1 & 0xff] ^ $S2[($R1 >> 8) & 0xff] ^ $S3[($R1 >> 16) & 0xff]; $R2^= ' . sprintf($safeint, '$t0 + $t1 + ' . $K[++$ki]) . '; $R2 = ($R2 >> 1 & 0x7fffffff) | ($R2 << 31); $R3 = ((($R3 >> 31) & 1) | ($R3 << 1)) ^ ' . sprintf($safeint, '($t0 + ($t1 << 1) + ' . $K[++$ki] . ')') . '; $t0 = $S0[ $R2 & 0xff] ^ $S1[($R2 >> 8) & 0xff] ^ $S2[($R2 >> 16) & 0xff] ^ $S3[($R2 >> 24) & 0xff]; $t1 = $S0[($R3 >> 24) & 0xff] ^ $S1[ $R3 & 0xff] ^ $S2[($R3 >> 8) & 0xff] ^ $S3[($R3 >> 16) & 0xff]; $R0^= ' . sprintf($safeint, '($t0 + $t1 + ' . $K[++$ki] . ')') . '; $R0 = ($R0 >> 1 & 0x7fffffff) | ($R0 << 31); $R1 = ((($R1 >> 31) & 1) | ($R1 << 1)) ^ ' . sprintf($safeint, '($t0 + ($t1 << 1) + ' . $K[++$ki] . ')') . '; '; } $encrypt_block .= ' $in = pack("V4", ' . $K[4] . ' ^ $R2, ' . $K[5] . ' ^ $R3, ' . $K[6] . ' ^ $R0, ' . $K[7] . ' ^ $R1); '; // Generating decrypt code: $decrypt_block = ' $in = unpack("V4", $in); $R0 = ' . $K[4] . ' ^ $in[1]; $R1 = ' . $K[5] . ' ^ $in[2]; $R2 = ' . $K[6] . ' ^ $in[3]; $R3 = ' . $K[7] . ' ^ $in[4]; '; for ($ki = 40, $i = 0; $i < 8; ++$i) { $decrypt_block .= ' $t0 = $S0[$R0 & 0xff] ^ $S1[$R0 >> 8 & 0xff] ^ $S2[$R0 >> 16 & 0xff] ^ $S3[$R0 >> 24 & 0xff]; $t1 = $S0[$R1 >> 24 & 0xff] ^ $S1[$R1 & 0xff] ^ $S2[$R1 >> 8 & 0xff] ^ $S3[$R1 >> 16 & 0xff]; $R3^= ' . sprintf($safeint, '$t0 + ($t1 << 1) + ' . $K[--$ki]) . '; $R3 = $R3 >> 1 & 0x7fffffff | $R3 << 31; $R2 = ($R2 >> 31 & 0x1 | $R2 << 1) ^ ' . sprintf($safeint, '($t0 + $t1 + ' . $K[--$ki] . ')') . '; $t0 = $S0[$R2 & 0xff] ^ $S1[$R2 >> 8 & 0xff] ^ $S2[$R2 >> 16 & 0xff] ^ $S3[$R2 >> 24 & 0xff]; $t1 = $S0[$R3 >> 24 & 0xff] ^ $S1[$R3 & 0xff] ^ $S2[$R3 >> 8 & 0xff] ^ $S3[$R3 >> 16 & 0xff]; $R1^= ' . sprintf($safeint, '$t0 + ($t1 << 1) + ' . $K[--$ki]) . '; $R1 = $R1 >> 1 & 0x7fffffff | $R1 << 31; $R0 = ($R0 >> 31 & 0x1 | $R0 << 1) ^ ' . sprintf($safeint, '($t0 + $t1 + ' . $K[--$ki] . ')') . '; '; } $decrypt_block .= ' $in = pack("V4", ' . $K[0] . ' ^ $R2, ' . $K[1] . ' ^ $R3, ' . $K[2] . ' ^ $R0, ' . $K[3] . ' ^ $R1); '; $this->inline_crypt = $this->createInlineCryptFunction( [ 'init_crypt' => $init_crypt, 'init_encrypt' => '', 'init_decrypt' => '', 'encrypt_block' => $encrypt_block, 'decrypt_block' => $decrypt_block ] ); } } * @copyright 2009 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Crypt\Common\AsymmetricKey; use phpseclib3\Crypt\Common\PrivateKey; use phpseclib3\Crypt\Common\PublicKey; use phpseclib3\Exception\NoKeyLoadedException; use phpseclib3\File\X509; /** * PublicKeyLoader * * @author Jim Wigginton */ abstract class PublicKeyLoader { /** * Loads a public or private key * * @return AsymmetricKey * @param string|array $key * @param string $password optional */ public static function load($key, $password = false) { try { return EC::load($key, $password); } catch (NoKeyLoadedException $e) { } try { return RSA::load($key, $password); } catch (NoKeyLoadedException $e) { } try { return DSA::load($key, $password); } catch (NoKeyLoadedException $e) { } try { $x509 = new X509(); $x509->loadX509($key); $key = $x509->getPublicKey(); if ($key) { return $key; } } catch (\Exception $e) { } throw new NoKeyLoadedException('Unable to read key'); } /** * Loads a private key * * @return PrivateKey * @param string|array $key * @param string $password optional */ public static function loadPrivateKey($key, $password = false) { $key = self::load($key, $password); if (!$key instanceof PrivateKey) { throw new NoKeyLoadedException('The key that was loaded was not a private key'); } return $key; } /** * Loads a public key * * @return PublicKey * @param string|array $key */ public static function loadPublicKey($key) { $key = self::load($key); if (!$key instanceof PublicKey) { throw new NoKeyLoadedException('The key that was loaded was not a public key'); } return $key; } /** * Loads parameters * * @return AsymmetricKey * @param string|array $key */ public static function loadParameters($key) { $key = self::load($key); if (!$key instanceof PrivateKey && !$key instanceof PublicKey) { throw new NoKeyLoadedException('The key that was loaded was not a parameter'); } return $key; } } * * * * @author Jim Wigginton * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Crypt\Common\AsymmetricKey; use phpseclib3\Crypt\DH\Parameters; use phpseclib3\Crypt\DH\PrivateKey; use phpseclib3\Crypt\DH\PublicKey; use phpseclib3\Exception\NoKeyLoadedException; use phpseclib3\Exception\UnsupportedOperationException; use phpseclib3\Math\BigInteger; /** * Pure-PHP (EC)DH implementation * * @author Jim Wigginton */ abstract class DH extends AsymmetricKey { /** * Algorithm Name * * @var string */ const ALGORITHM = 'DH'; /** * DH prime * * @var \phpseclib3\Math\BigInteger */ protected $prime; /** * DH Base * * Prime divisor of p-1 * * @var \phpseclib3\Math\BigInteger */ protected $base; /** * Public Key * * @var \phpseclib3\Math\BigInteger */ protected $publicKey; /** * Create DH parameters * * This method is a bit polymorphic. It can take any of the following: * - two BigInteger's (prime and base) * - an integer representing the size of the prime in bits (the base is assumed to be 2) * - a string (eg. diffie-hellman-group14-sha1) * * @return Parameters */ public static function createParameters(...$args) { $params = new Parameters(); if (count($args) == 2 && $args[0] instanceof BigInteger && $args[1] instanceof BigInteger) { //if (!$args[0]->isPrime()) { // throw new \InvalidArgumentException('The first parameter should be a prime number'); //} $params->prime = $args[0]; $params->base = $args[1]; return $params; } elseif (count($args) == 1 && is_numeric($args[0])) { $params->prime = BigInteger::randomPrime($args[0]); $params->base = new BigInteger(2); return $params; } elseif (count($args) != 1 || !is_string($args[0])) { throw new \InvalidArgumentException('Valid parameters are either: two BigInteger\'s (prime and base), a single integer (the length of the prime; base is assumed to be 2) or a string'); } switch ($args[0]) { // see http://tools.ietf.org/html/rfc2409#section-6.2 and // http://tools.ietf.org/html/rfc2412, appendex E case 'diffie-hellman-group1-sha1': $prime = 'FFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74' . '020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F1437' . '4FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7ED' . 'EE386BFB5A899FA5AE9F24117C4B1FE649286651ECE65381FFFFFFFFFFFFFFFF'; break; // see http://tools.ietf.org/html/rfc3526#section-3 case 'diffie-hellman-group14-sha1': // 2048-bit MODP Group case 'diffie-hellman-group14-sha256': $prime = 'FFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74' . '020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F1437' . '4FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7ED' . 'EE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF05' . '98DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB' . '9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3B' . 'E39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF695581718' . '3995497CEA956AE515D2261898FA051015728E5A8AACAA68FFFFFFFFFFFFFFFF'; break; // see https://tools.ietf.org/html/rfc3526#section-4 case 'diffie-hellman-group15-sha512': // 3072-bit MODP Group $prime = 'FFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74' . '020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F1437' . '4FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7ED' . 'EE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF05' . '98DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB' . '9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3B' . 'E39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF695581718' . '3995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33' . 'A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7' . 'ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864' . 'D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E2' . '08E24FA074E5AB3143DB5BFCE0FD108E4B82D120A93AD2CAFFFFFFFFFFFFFFFF'; break; // see https://tools.ietf.org/html/rfc3526#section-5 case 'diffie-hellman-group16-sha512': // 4096-bit MODP Group $prime = 'FFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74' . '020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F1437' . '4FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7ED' . 'EE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF05' . '98DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB' . '9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3B' . 'E39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF695581718' . '3995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33' . 'A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7' . 'ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864' . 'D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E2' . '08E24FA074E5AB3143DB5BFCE0FD108E4B82D120A92108011A723C12A787E6D7' . '88719A10BDBA5B2699C327186AF4E23C1A946834B6150BDA2583E9CA2AD44CE8' . 'DBBBC2DB04DE8EF92E8EFC141FBECAA6287C59474E6BC05D99B2964FA090C3A2' . '233BA186515BE7ED1F612970CEE2D7AFB81BDD762170481CD0069127D5B05AA9' . '93B4EA988D8FDDC186FFB7DC90A6C08F4DF435C934063199FFFFFFFFFFFFFFFF'; break; // see https://tools.ietf.org/html/rfc3526#section-6 case 'diffie-hellman-group17-sha512': // 6144-bit MODP Group $prime = 'FFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74' . '020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F1437' . '4FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7ED' . 'EE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF05' . '98DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB' . '9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3B' . 'E39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF695581718' . '3995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33' . 'A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7' . 'ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864' . 'D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E2' . '08E24FA074E5AB3143DB5BFCE0FD108E4B82D120A92108011A723C12A787E6D7' . '88719A10BDBA5B2699C327186AF4E23C1A946834B6150BDA2583E9CA2AD44CE8' . 'DBBBC2DB04DE8EF92E8EFC141FBECAA6287C59474E6BC05D99B2964FA090C3A2' . '233BA186515BE7ED1F612970CEE2D7AFB81BDD762170481CD0069127D5B05AA9' . '93B4EA988D8FDDC186FFB7DC90A6C08F4DF435C93402849236C3FAB4D27C7026' . 'C1D4DCB2602646DEC9751E763DBA37BDF8FF9406AD9E530EE5DB382F413001AE' . 'B06A53ED9027D831179727B0865A8918DA3EDBEBCF9B14ED44CE6CBACED4BB1B' . 'DB7F1447E6CC254B332051512BD7AF426FB8F401378CD2BF5983CA01C64B92EC' . 'F032EA15D1721D03F482D7CE6E74FEF6D55E702F46980C82B5A84031900B1C9E' . '59E7C97FBEC7E8F323A97A7E36CC88BE0F1D45B7FF585AC54BD407B22B4154AA' . 'CC8F6D7EBF48E1D814CC5ED20F8037E0A79715EEF29BE32806A1D58BB7C5DA76' . 'F550AA3D8A1FBFF0EB19CCB1A313D55CDA56C9EC2EF29632387FE8D76E3C0468' . '043E8F663F4860EE12BF2D5B0B7474D6E694F91E6DCC4024FFFFFFFFFFFFFFFF'; break; // see https://tools.ietf.org/html/rfc3526#section-7 case 'diffie-hellman-group18-sha512': // 8192-bit MODP Group $prime = 'FFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74' . '020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F1437' . '4FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7ED' . 'EE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF05' . '98DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB' . '9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3B' . 'E39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF695581718' . '3995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33' . 'A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7' . 'ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864' . 'D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E2' . '08E24FA074E5AB3143DB5BFCE0FD108E4B82D120A92108011A723C12A787E6D7' . '88719A10BDBA5B2699C327186AF4E23C1A946834B6150BDA2583E9CA2AD44CE8' . 'DBBBC2DB04DE8EF92E8EFC141FBECAA6287C59474E6BC05D99B2964FA090C3A2' . '233BA186515BE7ED1F612970CEE2D7AFB81BDD762170481CD0069127D5B05AA9' . '93B4EA988D8FDDC186FFB7DC90A6C08F4DF435C93402849236C3FAB4D27C7026' . 'C1D4DCB2602646DEC9751E763DBA37BDF8FF9406AD9E530EE5DB382F413001AE' . 'B06A53ED9027D831179727B0865A8918DA3EDBEBCF9B14ED44CE6CBACED4BB1B' . 'DB7F1447E6CC254B332051512BD7AF426FB8F401378CD2BF5983CA01C64B92EC' . 'F032EA15D1721D03F482D7CE6E74FEF6D55E702F46980C82B5A84031900B1C9E' . '59E7C97FBEC7E8F323A97A7E36CC88BE0F1D45B7FF585AC54BD407B22B4154AA' . 'CC8F6D7EBF48E1D814CC5ED20F8037E0A79715EEF29BE32806A1D58BB7C5DA76' . 'F550AA3D8A1FBFF0EB19CCB1A313D55CDA56C9EC2EF29632387FE8D76E3C0468' . '043E8F663F4860EE12BF2D5B0B7474D6E694F91E6DBE115974A3926F12FEE5E4' . '38777CB6A932DF8CD8BEC4D073B931BA3BC832B68D9DD300741FA7BF8AFC47ED' . '2576F6936BA424663AAB639C5AE4F5683423B4742BF1C978238F16CBE39D652D' . 'E3FDB8BEFC848AD922222E04A4037C0713EB57A81A23F0C73473FC646CEA306B' . '4BCBC8862F8385DDFA9D4B7FA2C087E879683303ED5BDD3A062B3CF5B3A278A6' . '6D2A13F83F44F82DDF310EE074AB6A364597E899A0255DC164F31CC50846851D' . 'F9AB48195DED7EA1B1D510BD7EE74D73FAF36BC31ECFA268359046F4EB879F92' . '4009438B481C6CD7889A002ED5EE382BC9190DA6FC026E479558E4475677E9AA' . '9E3050E2765694DFC81F56E880B96E7160C980DD98EDD3DFFFFFFFFFFFFFFFFF'; break; default: throw new \InvalidArgumentException('Invalid named prime provided'); } $params->prime = new BigInteger($prime, 16); $params->base = new BigInteger(2); return $params; } /** * Create public / private key pair. * * The rationale for the second parameter is described in http://tools.ietf.org/html/rfc4419#section-6.2 : * * "To increase the speed of the key exchange, both client and server may * reduce the size of their private exponents. It should be at least * twice as long as the key material that is generated from the shared * secret. For more details, see the paper by van Oorschot and Wiener * [VAN-OORSCHOT]." * * $length is in bits * * @param Parameters $params * @param int $length optional * @return DH\PrivateKey */ public static function createKey(Parameters $params, $length = 0) { $one = new BigInteger(1); if ($length) { $max = $one->bitwise_leftShift($length); $max = $max->subtract($one); } else { $max = $params->prime->subtract($one); } $key = new PrivateKey(); $key->prime = $params->prime; $key->base = $params->base; $key->privateKey = BigInteger::randomRange($one, $max); $key->publicKey = $key->base->powMod($key->privateKey, $key->prime); return $key; } /** * Compute Shared Secret * * @param PrivateKey|EC $private * @param PublicKey|BigInteger|string $public * @return mixed */ public static function computeSecret($private, $public) { if ($private instanceof PrivateKey) { // DH\PrivateKey switch (true) { case $public instanceof PublicKey: if (!$private->prime->equals($public->prime) || !$private->base->equals($public->base)) { throw new \InvalidArgumentException('The public and private key do not share the same prime and / or base numbers'); } return $public->publicKey->powMod($private->privateKey, $private->prime)->toBytes(true); case is_string($public): $public = new BigInteger($public, -256); // fall-through case $public instanceof BigInteger: return $public->powMod($private->privateKey, $private->prime)->toBytes(true); default: throw new \InvalidArgumentException('$public needs to be an instance of DH\PublicKey, a BigInteger or a string'); } } if ($private instanceof EC\PrivateKey) { switch (true) { case $public instanceof EC\PublicKey: $public = $public->getEncodedCoordinates(); // fall-through case is_string($public): $point = $private->multiply($public); switch ($private->getCurve()) { case 'Curve25519': case 'Curve448': $secret = $point; break; default: // according to https://www.secg.org/sec1-v2.pdf#page=33 only X is returned $secret = substr($point, 1, (strlen($point) - 1) >> 1); } /* if (($secret[0] & "\x80") === "\x80") { $secret = "\0$secret"; } */ return $secret; default: throw new \InvalidArgumentException('$public needs to be an instance of EC\PublicKey or a string (an encoded coordinate)'); } } } /** * Load the key * * @param string $key * @param string $password optional * @return AsymmetricKey */ public static function load($key, $password = false) { try { return EC::load($key, $password); } catch (NoKeyLoadedException $e) { } return parent::load($key, $password); } /** * OnLoad Handler * * @return bool */ protected static function onLoad(array $components) { if (!isset($components['privateKey']) && !isset($components['publicKey'])) { $new = new Parameters(); } else { $new = isset($components['privateKey']) ? new PrivateKey() : new PublicKey(); } $new->prime = $components['prime']; $new->base = $components['base']; if (isset($components['privateKey'])) { $new->privateKey = $components['privateKey']; } if (isset($components['publicKey'])) { $new->publicKey = $components['publicKey']; } return $new; } /** * Determines which hashing function should be used * * @param string $hash */ public function withHash($hash) { throw new UnsupportedOperationException('DH does not use a hash algorithm'); } /** * Returns the hash algorithm currently being used * */ public function getHash() { throw new UnsupportedOperationException('DH does not use a hash algorithm'); } /** * Returns the parameters * * A public / private key is only returned if the currently loaded "key" contains an x or y * value. * * @see self::getPublicKey() * @return mixed */ public function getParameters() { $type = self::validatePlugin('Keys', 'PKCS1', 'saveParameters'); $key = $type::saveParameters($this->prime, $this->base); return self::load($key, 'PKCS1'); } } * @author Hans-Juergen Petrich * @copyright 2007 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common; /** * Base Class for all block cipher classes * * @author Jim Wigginton */ abstract class BlockCipher extends SymmetricKey { } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common; use phpseclib3\Crypt\DSA; use phpseclib3\Crypt\Hash; use phpseclib3\Crypt\RSA; use phpseclib3\Exception\NoKeyLoadedException; use phpseclib3\Exception\UnsupportedFormatException; use phpseclib3\Math\BigInteger; /** * Base Class for all asymmetric cipher classes * * @author Jim Wigginton */ abstract class AsymmetricKey { /** * Precomputed Zero * * @var \phpseclib3\Math\BigInteger */ protected static $zero; /** * Precomputed One * * @var \phpseclib3\Math\BigInteger */ protected static $one; /** * Format of the loaded key * * @var string */ protected $format; /** * Hash function * * @var \phpseclib3\Crypt\Hash */ protected $hash; /** * HMAC function * * @var \phpseclib3\Crypt\Hash */ private $hmac; /** * Supported plugins (lower case) * * @see self::initialize_static_variables() * @var array */ private static $plugins = []; /** * Invisible plugins * * @see self::initialize_static_variables() * @var array */ private static $invisiblePlugins = []; /** * Available Engines * * @var boolean[] */ protected static $engines = []; /** * Key Comment * * @var null|string */ private $comment; /** * @param string $type * @return string */ abstract public function toString($type, array $options = []); /** * The constructor */ protected function __construct() { self::initialize_static_variables(); $this->hash = new Hash('sha256'); $this->hmac = new Hash('sha256'); } /** * Initialize static variables */ protected static function initialize_static_variables() { if (!isset(self::$zero)) { self::$zero = new BigInteger(0); self::$one = new BigInteger(1); } self::loadPlugins('Keys'); if (static::ALGORITHM != 'RSA' && static::ALGORITHM != 'DH') { self::loadPlugins('Signature'); } } /** * Load the key * * @param string $key * @param string $password optional * @return AsymmetricKey */ public static function load($key, $password = false) { self::initialize_static_variables(); $components = false; foreach (self::$plugins[static::ALGORITHM]['Keys'] as $format) { if (isset(self::$invisiblePlugins[static::ALGORITHM]) && in_array($format, self::$invisiblePlugins[static::ALGORITHM])) { continue; } try { $components = $format::load($key, $password); } catch (\Exception $e) { $components = false; } if ($components !== false) { break; } } if ($components === false) { throw new NoKeyLoadedException('Unable to read key'); } $components['format'] = $format; $components['secret'] = isset($components['secret']) ? $components['secret'] : ''; $comment = isset($components['comment']) ? $components['comment'] : null; $new = static::onLoad($components); $new->format = $format; $new->comment = $comment; return $new instanceof PrivateKey ? $new->withPassword($password) : $new; } /** * Loads a private key * * @return PrivateKey * @param string|array $key * @param string $password optional */ public static function loadPrivateKey($key, $password = '') { $key = self::load($key, $password); if (!$key instanceof PrivateKey) { throw new NoKeyLoadedException('The key that was loaded was not a private key'); } return $key; } /** * Loads a public key * * @return PublicKey * @param string|array $key */ public static function loadPublicKey($key) { $key = self::load($key); if (!$key instanceof PublicKey) { throw new NoKeyLoadedException('The key that was loaded was not a public key'); } return $key; } /** * Loads parameters * * @return AsymmetricKey * @param string|array $key */ public static function loadParameters($key) { $key = self::load($key); if (!$key instanceof PrivateKey && !$key instanceof PublicKey) { throw new NoKeyLoadedException('The key that was loaded was not a parameter'); } return $key; } /** * Load the key, assuming a specific format * * @param string $type * @param string $key * @param string $password optional * @return static */ public static function loadFormat($type, $key, $password = false) { self::initialize_static_variables(); $components = false; $format = strtolower($type); if (isset(self::$plugins[static::ALGORITHM]['Keys'][$format])) { $format = self::$plugins[static::ALGORITHM]['Keys'][$format]; $components = $format::load($key, $password); } if ($components === false) { throw new NoKeyLoadedException('Unable to read key'); } $components['format'] = $format; $components['secret'] = isset($components['secret']) ? $components['secret'] : ''; $new = static::onLoad($components); $new->format = $format; return $new instanceof PrivateKey ? $new->withPassword($password) : $new; } /** * Loads a private key * * @return PrivateKey * @param string $type * @param string $key * @param string $password optional */ public static function loadPrivateKeyFormat($type, $key, $password = false) { $key = self::loadFormat($type, $key, $password); if (!$key instanceof PrivateKey) { throw new NoKeyLoadedException('The key that was loaded was not a private key'); } return $key; } /** * Loads a public key * * @return PublicKey * @param string $type * @param string $key */ public static function loadPublicKeyFormat($type, $key) { $key = self::loadFormat($type, $key); if (!$key instanceof PublicKey) { throw new NoKeyLoadedException('The key that was loaded was not a public key'); } return $key; } /** * Loads parameters * * @return AsymmetricKey * @param string $type * @param string|array $key */ public static function loadParametersFormat($type, $key) { $key = self::loadFormat($type, $key); if (!$key instanceof PrivateKey && !$key instanceof PublicKey) { throw new NoKeyLoadedException('The key that was loaded was not a parameter'); } return $key; } /** * Validate Plugin * * @param string $format * @param string $type * @param string $method optional * @return mixed */ protected static function validatePlugin($format, $type, $method = null) { $type = strtolower($type); if (!isset(self::$plugins[static::ALGORITHM][$format][$type])) { throw new UnsupportedFormatException("$type is not a supported format"); } $type = self::$plugins[static::ALGORITHM][$format][$type]; if (isset($method) && !method_exists($type, $method)) { throw new UnsupportedFormatException("$type does not implement $method"); } return $type; } /** * Load Plugins * * @param string $format */ private static function loadPlugins($format) { if (!isset(self::$plugins[static::ALGORITHM][$format])) { self::$plugins[static::ALGORITHM][$format] = []; foreach (new \DirectoryIterator(__DIR__ . '/../' . static::ALGORITHM . '/Formats/' . $format . '/') as $file) { if ($file->getExtension() != 'php') { continue; } $name = $file->getBasename('.php'); if ($name[0] == '.') { continue; } $type = 'phpseclib3\Crypt\\' . static::ALGORITHM . '\\Formats\\' . $format . '\\' . $name; $reflect = new \ReflectionClass($type); if ($reflect->isTrait()) { continue; } self::$plugins[static::ALGORITHM][$format][strtolower($name)] = $type; if ($reflect->hasConstant('IS_INVISIBLE')) { self::$invisiblePlugins[static::ALGORITHM][] = $type; } } } } /** * Returns a list of supported formats. * * @return array */ public static function getSupportedKeyFormats() { self::initialize_static_variables(); return self::$plugins[static::ALGORITHM]['Keys']; } /** * Add a fileformat plugin * * The plugin needs to either already be loaded or be auto-loadable. * Loading a plugin whose shortname overwrite an existing shortname will overwrite the old plugin. * * @see self::load() * @param string $fullname * @return bool */ public static function addFileFormat($fullname) { self::initialize_static_variables(); if (class_exists($fullname)) { $meta = new \ReflectionClass($fullname); $shortname = $meta->getShortName(); self::$plugins[static::ALGORITHM]['Keys'][strtolower($shortname)] = $fullname; if ($meta->hasConstant('IS_INVISIBLE')) { self::$invisiblePlugins[static::ALGORITHM] = strtolower($name); } } } /** * Returns the format of the loaded key. * * If the key that was loaded wasn't in a valid or if the key was auto-generated * with RSA::createKey() then this will throw an exception. * * @see self::load() * @return mixed */ public function getLoadedFormat() { if (empty($this->format)) { throw new NoKeyLoadedException('This key was created with createKey - it was not loaded with load. Therefore there is no "loaded format"'); } $meta = new \ReflectionClass($this->format); return $meta->getShortName(); } /** * Returns the key's comment * * Not all key formats support comments. If you want to set a comment use toString() * * @return null|string */ public function getComment() { return $this->comment; } /** * Tests engine validity * */ public static function useBestEngine() { static::$engines = [ 'PHP' => true, 'OpenSSL' => extension_loaded('openssl'), // this test can be satisfied by either of the following: // http://php.net/manual/en/book.sodium.php // https://github.com/paragonie/sodium_compat 'libsodium' => function_exists('sodium_crypto_sign_keypair') ]; return static::$engines; } /** * Flag to use internal engine only (useful for unit testing) * */ public static function useInternalEngine() { static::$engines = [ 'PHP' => true, 'OpenSSL' => false, 'libsodium' => false ]; } /** * __toString() magic method * * @return string */ public function __toString() { return $this->toString('PKCS8'); } /** * Determines which hashing function should be used * * @param string $hash */ public function withHash($hash) { $new = clone $this; $new->hash = new Hash($hash); $new->hmac = new Hash($hash); return $new; } /** * Returns the hash algorithm currently being used * */ public function getHash() { return clone $this->hash; } /** * Compute the pseudorandom k for signature generation, * using the process specified for deterministic DSA. * * @param string $h1 * @return string */ protected function computek($h1) { $v = str_repeat("\1", strlen($h1)); $k = str_repeat("\0", strlen($h1)); $x = $this->int2octets($this->x); $h1 = $this->bits2octets($h1); $this->hmac->setKey($k); $k = $this->hmac->hash($v . "\0" . $x . $h1); $this->hmac->setKey($k); $v = $this->hmac->hash($v); $k = $this->hmac->hash($v . "\1" . $x . $h1); $this->hmac->setKey($k); $v = $this->hmac->hash($v); $qlen = $this->q->getLengthInBytes(); while (true) { $t = ''; while (strlen($t) < $qlen) { $v = $this->hmac->hash($v); $t = $t . $v; } $k = $this->bits2int($t); if (!$k->equals(self::$zero) && $k->compare($this->q) < 0) { break; } $k = $this->hmac->hash($v . "\0"); $this->hmac->setKey($k); $v = $this->hmac->hash($v); } return $k; } /** * Integer to Octet String * * @param \phpseclib3\Math\BigInteger $v * @return string */ private function int2octets($v) { $out = $v->toBytes(); $rolen = $this->q->getLengthInBytes(); if (strlen($out) < $rolen) { return str_pad($out, $rolen, "\0", STR_PAD_LEFT); } elseif (strlen($out) > $rolen) { return substr($out, -$rolen); } else { return $out; } } /** * Bit String to Integer * * @param string $in * @return \phpseclib3\Math\BigInteger */ protected function bits2int($in) { $v = new BigInteger($in, 256); $vlen = strlen($in) << 3; $qlen = $this->q->getLength(); if ($vlen > $qlen) { return $v->bitwise_rightShift($vlen - $qlen); } return $v; } /** * Bit String to Octet String * * @param string $in * @return string */ private function bits2octets($in) { $z1 = $this->bits2int($in); $z2 = $z1->subtract($this->q); return $z2->compare(self::$zero) < 0 ? $this->int2octets($z1) : $this->int2octets($z2); } } * @author Hans-Juergen Petrich * @copyright 2007 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Blowfish; use phpseclib3\Crypt\Hash; use phpseclib3\Exception\BadDecryptionException; use phpseclib3\Exception\BadModeException; use phpseclib3\Exception\InconsistentSetupException; use phpseclib3\Exception\InsufficientSetupException; use phpseclib3\Exception\UnsupportedAlgorithmException; use phpseclib3\Math\BigInteger; use phpseclib3\Math\BinaryField; use phpseclib3\Math\PrimeField; /** * Base Class for all \phpseclib3\Crypt\* cipher classes * * @author Jim Wigginton * @author Hans-Juergen Petrich */ abstract class SymmetricKey { /** * Encrypt / decrypt using the Counter mode. * * Set to -1 since that's what Crypt/Random.php uses to index the CTR mode. * * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Counter_.28CTR.29 * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() */ const MODE_CTR = -1; /** * Encrypt / decrypt using the Electronic Code Book mode. * * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Electronic_codebook_.28ECB.29 * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() */ const MODE_ECB = 1; /** * Encrypt / decrypt using the Code Book Chaining mode. * * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Cipher-block_chaining_.28CBC.29 * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() */ const MODE_CBC = 2; /** * Encrypt / decrypt using the Cipher Feedback mode. * * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Cipher_feedback_.28CFB.29 * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() */ const MODE_CFB = 3; /** * Encrypt / decrypt using the Cipher Feedback mode (8bit) * * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() */ const MODE_CFB8 = 7; /** * Encrypt / decrypt using the Output Feedback mode (8bit) * * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() */ const MODE_OFB8 = 8; /** * Encrypt / decrypt using the Output Feedback mode. * * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Output_feedback_.28OFB.29 * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() */ const MODE_OFB = 4; /** * Encrypt / decrypt using Galois/Counter mode. * * @link https://en.wikipedia.org/wiki/Galois/Counter_Mode * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() */ const MODE_GCM = 5; /** * Encrypt / decrypt using streaming mode. * * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() */ const MODE_STREAM = 6; /** * Mode Map * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() */ const MODE_MAP = [ 'ctr' => self::MODE_CTR, 'ecb' => self::MODE_ECB, 'cbc' => self::MODE_CBC, 'cfb' => self::MODE_CFB, 'cfb8' => self::MODE_CFB8, 'ofb' => self::MODE_OFB, 'ofb8' => self::MODE_OFB8, 'gcm' => self::MODE_GCM, 'stream' => self::MODE_STREAM ]; /** * Base value for the internal implementation $engine switch * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() */ const ENGINE_INTERNAL = 1; /** * Base value for the eval() implementation $engine switch * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() */ const ENGINE_EVAL = 2; /** * Base value for the mcrypt implementation $engine switch * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() */ const ENGINE_MCRYPT = 3; /** * Base value for the openssl implementation $engine switch * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() */ const ENGINE_OPENSSL = 4; /** * Base value for the libsodium implementation $engine switch * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() */ const ENGINE_LIBSODIUM = 5; /** * Base value for the openssl / gcm implementation $engine switch * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() */ const ENGINE_OPENSSL_GCM = 6; /** * Engine Reverse Map * * @see \phpseclib3\Crypt\Common\SymmetricKey::getEngine() */ const ENGINE_MAP = [ self::ENGINE_INTERNAL => 'PHP', self::ENGINE_EVAL => 'Eval', self::ENGINE_MCRYPT => 'mcrypt', self::ENGINE_OPENSSL => 'OpenSSL', self::ENGINE_LIBSODIUM => 'libsodium', self::ENGINE_OPENSSL_GCM => 'OpenSSL (GCM)' ]; /** * The Encryption Mode * * @see self::__construct() * @var int */ protected $mode; /** * The Block Length of the block cipher * * @var int */ protected $block_size = 16; /** * The Key * * @see self::setKey() * @var string */ protected $key = false; /** * HMAC Key * * @see self::setupGCM() * @var ?string */ protected $hKey = false; /** * The Initialization Vector * * @see self::setIV() * @var string */ protected $iv = false; /** * A "sliding" Initialization Vector * * @see self::enableContinuousBuffer() * @see self::clearBuffers() * @var string */ protected $encryptIV; /** * A "sliding" Initialization Vector * * @see self::enableContinuousBuffer() * @see self::clearBuffers() * @var string */ protected $decryptIV; /** * Continuous Buffer status * * @see self::enableContinuousBuffer() * @var bool */ protected $continuousBuffer = false; /** * Encryption buffer for CTR, OFB and CFB modes * * @see self::encrypt() * @see self::clearBuffers() * @var array */ protected $enbuffer; /** * Decryption buffer for CTR, OFB and CFB modes * * @see self::decrypt() * @see self::clearBuffers() * @var array */ protected $debuffer; /** * mcrypt resource for encryption * * The mcrypt resource can be recreated every time something needs to be created or it can be created just once. * Since mcrypt operates in continuous mode, by default, it'll need to be recreated when in non-continuous mode. * * @see self::encrypt() * @var resource */ private $enmcrypt; /** * mcrypt resource for decryption * * The mcrypt resource can be recreated every time something needs to be created or it can be created just once. * Since mcrypt operates in continuous mode, by default, it'll need to be recreated when in non-continuous mode. * * @see self::decrypt() * @var resource */ private $demcrypt; /** * Does the enmcrypt resource need to be (re)initialized? * * @see \phpseclib3\Crypt\Twofish::setKey() * @see \phpseclib3\Crypt\Twofish::setIV() * @var bool */ private $enchanged = true; /** * Does the demcrypt resource need to be (re)initialized? * * @see \phpseclib3\Crypt\Twofish::setKey() * @see \phpseclib3\Crypt\Twofish::setIV() * @var bool */ private $dechanged = true; /** * mcrypt resource for CFB mode * * mcrypt's CFB mode, in (and only in) buffered context, * is broken, so phpseclib implements the CFB mode by it self, * even when the mcrypt php extension is available. * * In order to do the CFB-mode work (fast) phpseclib * use a separate ECB-mode mcrypt resource. * * @link http://phpseclib.sourceforge.net/cfb-demo.phps * @see self::encrypt() * @see self::decrypt() * @see self::setupMcrypt() * @var resource */ private $ecb; /** * Optimizing value while CFB-encrypting * * Only relevant if $continuousBuffer enabled * and $engine == self::ENGINE_MCRYPT * * It's faster to re-init $enmcrypt if * $buffer bytes > $cfb_init_len than * using the $ecb resource furthermore. * * This value depends of the chosen cipher * and the time it would be needed for it's * initialization [by mcrypt_generic_init()] * which, typically, depends on the complexity * on its internaly Key-expanding algorithm. * * @see self::encrypt() * @var int */ protected $cfb_init_len = 600; /** * Does internal cipher state need to be (re)initialized? * * @see self::setKey() * @see self::setIV() * @see self::disableContinuousBuffer() * @var bool */ protected $changed = true; /** * Does Eval engie need to be (re)initialized? * * @see self::setup() * @var bool */ protected $nonIVChanged = true; /** * Padding status * * @see self::enablePadding() * @var bool */ private $padding = true; /** * Is the mode one that is paddable? * * @see self::__construct() * @var bool */ private $paddable = false; /** * Holds which crypt engine internaly should be use, * which will be determined automatically on __construct() * * Currently available $engines are: * - self::ENGINE_LIBSODIUM (very fast, php-extension: libsodium, extension_loaded('libsodium') required) * - self::ENGINE_OPENSSL_GCM (very fast, php-extension: openssl, extension_loaded('openssl') required) * - self::ENGINE_OPENSSL (very fast, php-extension: openssl, extension_loaded('openssl') required) * - self::ENGINE_MCRYPT (fast, php-extension: mcrypt, extension_loaded('mcrypt') required) * - self::ENGINE_EVAL (medium, pure php-engine, no php-extension required) * - self::ENGINE_INTERNAL (slower, pure php-engine, no php-extension required) * * @see self::setEngine() * @see self::encrypt() * @see self::decrypt() * @var int */ protected $engine; /** * Holds the preferred crypt engine * * @see self::setEngine() * @see self::setPreferredEngine() * @var int */ private $preferredEngine; /** * The mcrypt specific name of the cipher * * Only used if $engine == self::ENGINE_MCRYPT * * @link http://www.php.net/mcrypt_module_open * @link http://www.php.net/mcrypt_list_algorithms * @see self::setupMcrypt() * @var string */ protected $cipher_name_mcrypt; /** * The openssl specific name of the cipher * * Only used if $engine == self::ENGINE_OPENSSL * * @link http://www.php.net/openssl-get-cipher-methods * @var string */ protected $cipher_name_openssl; /** * The openssl specific name of the cipher in ECB mode * * If OpenSSL does not support the mode we're trying to use (CTR) * it can still be emulated with ECB mode. * * @link http://www.php.net/openssl-get-cipher-methods * @var string */ protected $cipher_name_openssl_ecb; /** * The default salt used by setPassword() * * @see self::setPassword() * @var string */ private $password_default_salt = 'phpseclib/salt'; /** * The name of the performance-optimized callback function * * Used by encrypt() / decrypt() * only if $engine == self::ENGINE_INTERNAL * * @see self::encrypt() * @see self::decrypt() * @see self::setupInlineCrypt() * @var Callback */ protected $inline_crypt; /** * If OpenSSL can be used in ECB but not in CTR we can emulate CTR * * @see self::openssl_ctr_process() * @var bool */ private $openssl_emulate_ctr = false; /** * Don't truncate / null pad key * * @see self::clearBuffers() * @var bool */ private $skip_key_adjustment = false; /** * Has the key length explicitly been set or should it be derived from the key, itself? * * @see self::setKeyLength() * @var bool */ protected $explicit_key_length = false; /** * Hash subkey for GHASH * * @see self::setupGCM() * @see self::ghash() * @var BinaryField\Integer */ private $h; /** * Additional authenticated data * * @var string */ protected $aad = ''; /** * Authentication Tag produced after a round of encryption * * @var string */ protected $newtag = false; /** * Authentication Tag to be verified during decryption * * @var string */ protected $oldtag = false; /** * GCM Binary Field * * @see self::__construct() * @see self::ghash() * @var BinaryField */ private static $gcmField; /** * Poly1305 Prime Field * * @see self::enablePoly1305() * @see self::poly1305() * @var PrimeField */ private static $poly1305Field; /** * Flag for using regular vs "safe" intval * * @see self::initialize_static_variables() * @var boolean */ protected static $use_reg_intval; /** * Poly1305 Key * * @see self::setPoly1305Key() * @see self::poly1305() * @var string */ protected $poly1305Key; /** * Poly1305 Flag * * @see self::setPoly1305Key() * @see self::enablePoly1305() * @var boolean */ protected $usePoly1305 = false; /** * The Original Initialization Vector * * GCM uses the nonce to build the IV but we want to be able to distinguish between nonce-derived * IV's and user-set IV's * * @see self::setIV() * @var string */ private $origIV = false; /** * Nonce * * Only used with GCM. We could re-use setIV() but nonce's can be of a different length and * toggling between GCM and other modes could be more complicated if we re-used setIV() * * @see self::setNonce() * @var string */ protected $nonce = false; /** * Default Constructor. * * $mode could be: * * - ecb * * - cbc * * - ctr * * - cfb * * - cfb8 * * - ofb * * - ofb8 * * - gcm * * @param string $mode * @throws BadModeException if an invalid / unsupported mode is provided */ public function __construct($mode) { $mode = strtolower($mode); // necessary because of 5.6 compatibility; we can't do isset(self::MODE_MAP[$mode]) in 5.6 $map = self::MODE_MAP; if (!isset($map[$mode])) { throw new BadModeException('No valid mode has been specified'); } $mode = self::MODE_MAP[$mode]; // $mode dependent settings switch ($mode) { case self::MODE_ECB: case self::MODE_CBC: $this->paddable = true; break; case self::MODE_CTR: case self::MODE_CFB: case self::MODE_CFB8: case self::MODE_OFB: case self::MODE_OFB8: case self::MODE_STREAM: $this->paddable = false; break; case self::MODE_GCM: if ($this->block_size != 16) { throw new BadModeException('GCM is only valid for block ciphers with a block size of 128 bits'); } if (!isset(self::$gcmField)) { self::$gcmField = new BinaryField(128, 7, 2, 1, 0); } $this->paddable = false; break; default: throw new BadModeException('No valid mode has been specified'); } $this->mode = $mode; static::initialize_static_variables(); } /** * Initialize static variables */ protected static function initialize_static_variables() { if (!isset(self::$use_reg_intval)) { switch (true) { // PHP_OS & "\xDF\xDF\xDF" == strtoupper(substr(PHP_OS, 0, 3)), but a lot faster case (PHP_OS & "\xDF\xDF\xDF") === 'WIN': case (php_uname('m') & "\xDF\xDF\xDF") != 'ARM': case defined('PHP_INT_SIZE') && PHP_INT_SIZE == 8: self::$use_reg_intval = true; break; case (php_uname('m') & "\xDF\xDF\xDF") == 'ARM': switch (true) { /* PHP 7.0.0 introduced a bug that affected 32-bit ARM processors: https://github.com/php/php-src/commit/716da71446ebbd40fa6cf2cea8a4b70f504cc3cd altho the changelogs make no mention of it, this bug was fixed with this commit: https://github.com/php/php-src/commit/c1729272b17a1fe893d1a54e423d3b71470f3ee8 affected versions of PHP are: 7.0.x, 7.1.0 - 7.1.23 and 7.2.0 - 7.2.11 */ case PHP_VERSION_ID >= 70000 && PHP_VERSION_ID <= 70123: case PHP_VERSION_ID >= 70200 && PHP_VERSION_ID <= 70211: self::$use_reg_intval = false; break; default: self::$use_reg_intval = true; } } } } /** * Sets the initialization vector. * * setIV() is not required when ecb or gcm modes are being used. * * {@internal Can be overwritten by a sub class, but does not have to be} * * @param string $iv * @throws \LengthException if the IV length isn't equal to the block size * @throws \BadMethodCallException if an IV is provided when one shouldn't be */ public function setIV($iv) { if ($this->mode == self::MODE_ECB) { throw new \BadMethodCallException('This mode does not require an IV.'); } if ($this->mode == self::MODE_GCM) { throw new \BadMethodCallException('Use setNonce instead'); } if (!$this->usesIV()) { throw new \BadMethodCallException('This algorithm does not use an IV.'); } if (strlen($iv) != $this->block_size) { throw new \LengthException('Received initialization vector of size ' . strlen($iv) . ', but size ' . $this->block_size . ' is required'); } $this->iv = $this->origIV = $iv; $this->changed = true; } /** * Enables Poly1305 mode. * * Once enabled Poly1305 cannot be disabled. * * @throws \BadMethodCallException if Poly1305 is enabled whilst in GCM mode */ public function enablePoly1305() { if ($this->mode == self::MODE_GCM) { throw new \BadMethodCallException('Poly1305 cannot be used in GCM mode'); } $this->usePoly1305 = true; } /** * Enables Poly1305 mode. * * Once enabled Poly1305 cannot be disabled. If $key is not passed then an attempt to call createPoly1305Key * will be made. * * @param string $key optional * @throws \LengthException if the key isn't long enough * @throws \BadMethodCallException if Poly1305 is enabled whilst in GCM mode */ public function setPoly1305Key($key = null) { if ($this->mode == self::MODE_GCM) { throw new \BadMethodCallException('Poly1305 cannot be used in GCM mode'); } if (!is_string($key) || strlen($key) != 32) { throw new \LengthException('The Poly1305 key must be 32 bytes long (256 bits)'); } if (!isset(self::$poly1305Field)) { // 2^130-5 self::$poly1305Field = new PrimeField(new BigInteger('3fffffffffffffffffffffffffffffffb', 16)); } $this->poly1305Key = $key; $this->usePoly1305 = true; } /** * Sets the nonce. * * setNonce() is only required when gcm is used * * @param string $nonce * @throws \BadMethodCallException if an nonce is provided when one shouldn't be */ public function setNonce($nonce) { if ($this->mode != self::MODE_GCM) { throw new \BadMethodCallException('Nonces are only used in GCM mode.'); } $this->nonce = $nonce; $this->setEngine(); } /** * Sets additional authenticated data * * setAAD() is only used by gcm or in poly1305 mode * * @param string $aad * @throws \BadMethodCallException if mode isn't GCM or if poly1305 isn't being utilized */ public function setAAD($aad) { if ($this->mode != self::MODE_GCM && !$this->usePoly1305) { throw new \BadMethodCallException('Additional authenticated data is only utilized in GCM mode or with Poly1305'); } $this->aad = $aad; } /** * Returns whether or not the algorithm uses an IV * * @return bool */ public function usesIV() { return $this->mode != self::MODE_GCM && $this->mode != self::MODE_ECB; } /** * Returns whether or not the algorithm uses a nonce * * @return bool */ public function usesNonce() { return $this->mode == self::MODE_GCM; } /** * Returns the current key length in bits * * @return int */ public function getKeyLength() { return $this->key_length << 3; } /** * Returns the current block length in bits * * @return int */ public function getBlockLength() { return $this->block_size << 3; } /** * Returns the current block length in bytes * * @return int */ public function getBlockLengthInBytes() { return $this->block_size; } /** * Sets the key length. * * Keys with explicitly set lengths need to be treated accordingly * * @param int $length */ public function setKeyLength($length) { $this->explicit_key_length = $length >> 3; if (is_string($this->key) && strlen($this->key) != $this->explicit_key_length) { $this->key = false; throw new InconsistentSetupException('Key has already been set and is not ' . $this->explicit_key_length . ' bytes long'); } } /** * Sets the key. * * The min/max length(s) of the key depends on the cipher which is used. * If the key not fits the length(s) of the cipher it will paded with null bytes * up to the closest valid key length. If the key is more than max length, * we trim the excess bits. * * If the key is not explicitly set, it'll be assumed to be all null bytes. * * {@internal Could, but not must, extend by the child Crypt_* class} * * @param string $key */ public function setKey($key) { if ($this->explicit_key_length !== false && strlen($key) != $this->explicit_key_length) { throw new InconsistentSetupException('Key length has already been set to ' . $this->explicit_key_length . ' bytes and this key is ' . strlen($key) . ' bytes'); } $this->key = $key; $this->key_length = strlen($key); $this->setEngine(); } /** * Sets the password. * * Depending on what $method is set to, setPassword()'s (optional) parameters are as follows: * {@link http://en.wikipedia.org/wiki/PBKDF2 pbkdf2} or pbkdf1: * $hash, $salt, $count, $dkLen * * Where $hash (default = sha1) currently supports the following hashes: see: Crypt/Hash.php * {@link https://en.wikipedia.org/wiki/Bcrypt bcypt}: * $salt, $rounds, $keylen * * This is a modified version of bcrypt used by OpenSSH. * * {@internal Could, but not must, extend by the child Crypt_* class} * * @see Crypt/Hash.php * @param string $password * @param string $method * @param string[] ...$func_args * @throws \LengthException if pbkdf1 is being used and the derived key length exceeds the hash length * @throws \RuntimeException if bcrypt is being used and a salt isn't provided * @return bool */ public function setPassword($password, $method = 'pbkdf2', ...$func_args) { $key = ''; $method = strtolower($method); switch ($method) { case 'bcrypt': if (!isset($func_args[2])) { throw new \RuntimeException('A salt must be provided for bcrypt to work'); } $salt = $func_args[0]; $rounds = isset($func_args[1]) ? $func_args[1] : 16; $keylen = isset($func_args[2]) ? $func_args[2] : $this->key_length; $key = Blowfish::bcrypt_pbkdf($password, $salt, $keylen + $this->block_size, $rounds); $this->setKey(substr($key, 0, $keylen)); $this->setIV(substr($key, $keylen)); return true; case 'pkcs12': // from https://tools.ietf.org/html/rfc7292#appendix-B.2 case 'pbkdf1': case 'pbkdf2': // Hash function $hash = isset($func_args[0]) ? strtolower($func_args[0]) : 'sha1'; $hashObj = new Hash(); $hashObj->setHash($hash); // WPA and WPA2 use the SSID as the salt $salt = isset($func_args[1]) ? $func_args[1] : $this->password_default_salt; // RFC2898#section-4.2 uses 1,000 iterations by default // WPA and WPA2 use 4,096. $count = isset($func_args[2]) ? $func_args[2] : 1000; // Keylength if (isset($func_args[3])) { if ($func_args[3] <= 0) { throw new \LengthException('Derived key length cannot be longer 0 or less'); } $dkLen = $func_args[3]; } else { $key_length = $this->explicit_key_length !== false ? $this->explicit_key_length : $this->key_length; $dkLen = $method == 'pbkdf1' ? 2 * $key_length : $key_length; } switch (true) { case $method == 'pkcs12': /* In this specification, however, all passwords are created from BMPStrings with a NULL terminator. This means that each character in the original BMPString is encoded in 2 bytes in big-endian format (most-significant byte first). There are no Unicode byte order marks. The 2 bytes produced from the last character in the BMPString are followed by 2 additional bytes with the value 0x00. -- https://tools.ietf.org/html/rfc7292#appendix-B.1 */ $password = "\0" . chunk_split($password, 1, "\0") . "\0"; /* This standard specifies 3 different values for the ID byte mentioned above: 1. If ID=1, then the pseudorandom bits being produced are to be used as key material for performing encryption or decryption. 2. If ID=2, then the pseudorandom bits being produced are to be used as an IV (Initial Value) for encryption or decryption. 3. If ID=3, then the pseudorandom bits being produced are to be used as an integrity key for MACing. */ // Construct a string, D (the "diversifier"), by concatenating v/8 // copies of ID. $blockLength = $hashObj->getBlockLengthInBytes(); $d1 = str_repeat(chr(1), $blockLength); $d2 = str_repeat(chr(2), $blockLength); $s = ''; if (strlen($salt)) { while (strlen($s) < $blockLength) { $s .= $salt; } } $s = substr($s, 0, $blockLength); $p = ''; if (strlen($password)) { while (strlen($p) < $blockLength) { $p .= $password; } } $p = substr($p, 0, $blockLength); $i = $s . $p; $this->setKey(self::pkcs12helper($dkLen, $hashObj, $i, $d1, $count)); if ($this->usesIV()) { $this->setIV(self::pkcs12helper($this->block_size, $hashObj, $i, $d2, $count)); } return true; case $method == 'pbkdf1': if ($dkLen > $hashObj->getLengthInBytes()) { throw new \LengthException('Derived key length cannot be longer than the hash length'); } $t = $password . $salt; for ($i = 0; $i < $count; ++$i) { $t = $hashObj->hash($t); } $key = substr($t, 0, $dkLen); $this->setKey(substr($key, 0, $dkLen >> 1)); if ($this->usesIV()) { $this->setIV(substr($key, $dkLen >> 1)); } return true; case !in_array($hash, hash_algos()): $i = 1; $hashObj->setKey($password); while (strlen($key) < $dkLen) { $f = $u = $hashObj->hash($salt . pack('N', $i++)); for ($j = 2; $j <= $count; ++$j) { $u = $hashObj->hash($u); $f ^= $u; } $key .= $f; } $key = substr($key, 0, $dkLen); break; default: $key = hash_pbkdf2($hash, $password, $salt, $count, $dkLen, true); } break; default: throw new UnsupportedAlgorithmException($method . ' is not a supported password hashing method'); } $this->setKey($key); return true; } /** * PKCS#12 KDF Helper Function * * As discussed here: * * {@link https://tools.ietf.org/html/rfc7292#appendix-B} * * @see self::setPassword() * @param int $n * @param \phpseclib3\Crypt\Hash $hashObj * @param string $i * @param string $d * @param int $count * @return string $a */ private static function pkcs12helper($n, $hashObj, $i, $d, $count) { static $one; if (!isset($one)) { $one = new BigInteger(1); } $blockLength = $hashObj->getBlockLength() >> 3; $c = ceil($n / $hashObj->getLengthInBytes()); $a = ''; for ($j = 1; $j <= $c; $j++) { $ai = $d . $i; for ($k = 0; $k < $count; $k++) { $ai = $hashObj->hash($ai); } $b = ''; while (strlen($b) < $blockLength) { $b .= $ai; } $b = substr($b, 0, $blockLength); $b = new BigInteger($b, 256); $newi = ''; for ($k = 0; $k < strlen($i); $k += $blockLength) { $temp = substr($i, $k, $blockLength); $temp = new BigInteger($temp, 256); $temp->setPrecision($blockLength << 3); $temp = $temp->add($b); $temp = $temp->add($one); $newi .= $temp->toBytes(false); } $i = $newi; $a .= $ai; } return substr($a, 0, $n); } /** * Encrypts a message. * * $plaintext will be padded with additional bytes such that it's length is a multiple of the block size. Other cipher * implementations may or may not pad in the same manner. Other common approaches to padding and the reasons why it's * necessary are discussed in the following * URL: * * {@link http://www.di-mgt.com.au/cryptopad.html http://www.di-mgt.com.au/cryptopad.html} * * An alternative to padding is to, separately, send the length of the file. This is what SSH, in fact, does. * strlen($plaintext) will still need to be a multiple of the block size, however, arbitrary values can be added to make it that * length. * * {@internal Could, but not must, extend by the child Crypt_* class} * * @see self::decrypt() * @param string $plaintext * @return string $ciphertext */ public function encrypt($plaintext) { if ($this->paddable) { $plaintext = $this->pad($plaintext); } $this->setup(); if ($this->mode == self::MODE_GCM) { $oldIV = $this->iv; Strings::increment_str($this->iv); $cipher = new static('ctr'); $cipher->setKey($this->key); $cipher->setIV($this->iv); $ciphertext = $cipher->encrypt($plaintext); $s = $this->ghash( self::nullPad128($this->aad) . self::nullPad128($ciphertext) . self::len64($this->aad) . self::len64($ciphertext) ); $cipher->encryptIV = $this->iv = $this->encryptIV = $this->decryptIV = $oldIV; $this->newtag = $cipher->encrypt($s); return $ciphertext; } if (isset($this->poly1305Key)) { $cipher = clone $this; unset($cipher->poly1305Key); $this->usePoly1305 = false; $ciphertext = $cipher->encrypt($plaintext); $this->newtag = $this->poly1305($ciphertext); return $ciphertext; } if ($this->engine === self::ENGINE_OPENSSL) { switch ($this->mode) { case self::MODE_STREAM: return openssl_encrypt($plaintext, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING); case self::MODE_ECB: return openssl_encrypt($plaintext, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING); case self::MODE_CBC: $result = openssl_encrypt($plaintext, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $this->encryptIV); if ($this->continuousBuffer) { $this->encryptIV = substr($result, -$this->block_size); } return $result; case self::MODE_CTR: return $this->openssl_ctr_process($plaintext, $this->encryptIV, $this->enbuffer); case self::MODE_CFB: // cfb loosely routines inspired by openssl's: // {@link http://cvs.openssl.org/fileview?f=openssl/crypto/modes/cfb128.c&v=1.3.2.2.2.1} $ciphertext = ''; if ($this->continuousBuffer) { $iv = &$this->encryptIV; $pos = &$this->enbuffer['pos']; } else { $iv = $this->encryptIV; $pos = 0; } $len = strlen($plaintext); $i = 0; if ($pos) { $orig_pos = $pos; $max = $this->block_size - $pos; if ($len >= $max) { $i = $max; $len -= $max; $pos = 0; } else { $i = $len; $pos += $len; $len = 0; } // ie. $i = min($max, $len), $len-= $i, $pos+= $i, $pos%= $blocksize $ciphertext = substr($iv, $orig_pos) ^ $plaintext; $iv = substr_replace($iv, $ciphertext, $orig_pos, $i); $plaintext = substr($plaintext, $i); } $overflow = $len % $this->block_size; if ($overflow) { $ciphertext .= openssl_encrypt(substr($plaintext, 0, -$overflow) . str_repeat("\0", $this->block_size), $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $iv); $iv = Strings::pop($ciphertext, $this->block_size); $size = $len - $overflow; $block = $iv ^ substr($plaintext, -$overflow); $iv = substr_replace($iv, $block, 0, $overflow); $ciphertext .= $block; $pos = $overflow; } elseif ($len) { $ciphertext = openssl_encrypt($plaintext, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $iv); $iv = substr($ciphertext, -$this->block_size); } return $ciphertext; case self::MODE_CFB8: $ciphertext = openssl_encrypt($plaintext, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $this->encryptIV); if ($this->continuousBuffer) { if (($len = strlen($ciphertext)) >= $this->block_size) { $this->encryptIV = substr($ciphertext, -$this->block_size); } else { $this->encryptIV = substr($this->encryptIV, $len - $this->block_size) . substr($ciphertext, -$len); } } return $ciphertext; case self::MODE_OFB8: $ciphertext = ''; $len = strlen($plaintext); $iv = $this->encryptIV; for ($i = 0; $i < $len; ++$i) { $xor = openssl_encrypt($iv, $this->cipher_name_openssl_ecb, $this->key, $this->openssl_options, $this->decryptIV); $ciphertext .= $plaintext[$i] ^ $xor; $iv = substr($iv, 1) . $xor[0]; } if ($this->continuousBuffer) { $this->encryptIV = $iv; } break; case self::MODE_OFB: return $this->openssl_ofb_process($plaintext, $this->encryptIV, $this->enbuffer); } } if ($this->engine === self::ENGINE_MCRYPT) { set_error_handler(function () { }); if ($this->enchanged) { mcrypt_generic_init($this->enmcrypt, $this->key, $this->getIV($this->encryptIV)); $this->enchanged = false; } // re: {@link http://phpseclib.sourceforge.net/cfb-demo.phps} // using mcrypt's default handing of CFB the above would output two different things. using phpseclib's // rewritten CFB implementation the above outputs the same thing twice. if ($this->mode == self::MODE_CFB && $this->continuousBuffer) { $block_size = $this->block_size; $iv = &$this->encryptIV; $pos = &$this->enbuffer['pos']; $len = strlen($plaintext); $ciphertext = ''; $i = 0; if ($pos) { $orig_pos = $pos; $max = $block_size - $pos; if ($len >= $max) { $i = $max; $len -= $max; $pos = 0; } else { $i = $len; $pos += $len; $len = 0; } $ciphertext = substr($iv, $orig_pos) ^ $plaintext; $iv = substr_replace($iv, $ciphertext, $orig_pos, $i); $this->enbuffer['enmcrypt_init'] = true; } if ($len >= $block_size) { if ($this->enbuffer['enmcrypt_init'] === false || $len > $this->cfb_init_len) { if ($this->enbuffer['enmcrypt_init'] === true) { mcrypt_generic_init($this->enmcrypt, $this->key, $iv); $this->enbuffer['enmcrypt_init'] = false; } $ciphertext .= mcrypt_generic($this->enmcrypt, substr($plaintext, $i, $len - $len % $block_size)); $iv = substr($ciphertext, -$block_size); $len %= $block_size; } else { while ($len >= $block_size) { $iv = mcrypt_generic($this->ecb, $iv) ^ substr($plaintext, $i, $block_size); $ciphertext .= $iv; $len -= $block_size; $i += $block_size; } } } if ($len) { $iv = mcrypt_generic($this->ecb, $iv); $block = $iv ^ substr($plaintext, -$len); $iv = substr_replace($iv, $block, 0, $len); $ciphertext .= $block; $pos = $len; } restore_error_handler(); return $ciphertext; } $ciphertext = mcrypt_generic($this->enmcrypt, $plaintext); if (!$this->continuousBuffer) { mcrypt_generic_init($this->enmcrypt, $this->key, $this->getIV($this->encryptIV)); } restore_error_handler(); return $ciphertext; } if ($this->engine === self::ENGINE_EVAL) { $inline = $this->inline_crypt; return $inline('encrypt', $plaintext); } $buffer = &$this->enbuffer; $block_size = $this->block_size; $ciphertext = ''; switch ($this->mode) { case self::MODE_ECB: for ($i = 0; $i < strlen($plaintext); $i += $block_size) { $ciphertext .= $this->encryptBlock(substr($plaintext, $i, $block_size)); } break; case self::MODE_CBC: $xor = $this->encryptIV; for ($i = 0; $i < strlen($plaintext); $i += $block_size) { $block = substr($plaintext, $i, $block_size); $block = $this->encryptBlock($block ^ $xor); $xor = $block; $ciphertext .= $block; } if ($this->continuousBuffer) { $this->encryptIV = $xor; } break; case self::MODE_CTR: $xor = $this->encryptIV; if (strlen($buffer['ciphertext'])) { for ($i = 0; $i < strlen($plaintext); $i += $block_size) { $block = substr($plaintext, $i, $block_size); if (strlen($block) > strlen($buffer['ciphertext'])) { $buffer['ciphertext'] .= $this->encryptBlock($xor); Strings::increment_str($xor); } $key = Strings::shift($buffer['ciphertext'], $block_size); $ciphertext .= $block ^ $key; } } else { for ($i = 0; $i < strlen($plaintext); $i += $block_size) { $block = substr($plaintext, $i, $block_size); $key = $this->encryptBlock($xor); Strings::increment_str($xor); $ciphertext .= $block ^ $key; } } if ($this->continuousBuffer) { $this->encryptIV = $xor; if ($start = strlen($plaintext) % $block_size) { $buffer['ciphertext'] = substr($key, $start) . $buffer['ciphertext']; } } break; case self::MODE_CFB: // cfb loosely routines inspired by openssl's: // {@link http://cvs.openssl.org/fileview?f=openssl/crypto/modes/cfb128.c&v=1.3.2.2.2.1} if ($this->continuousBuffer) { $iv = &$this->encryptIV; $pos = &$buffer['pos']; } else { $iv = $this->encryptIV; $pos = 0; } $len = strlen($plaintext); $i = 0; if ($pos) { $orig_pos = $pos; $max = $block_size - $pos; if ($len >= $max) { $i = $max; $len -= $max; $pos = 0; } else { $i = $len; $pos += $len; $len = 0; } // ie. $i = min($max, $len), $len-= $i, $pos+= $i, $pos%= $blocksize $ciphertext = substr($iv, $orig_pos) ^ $plaintext; $iv = substr_replace($iv, $ciphertext, $orig_pos, $i); } while ($len >= $block_size) { $iv = $this->encryptBlock($iv) ^ substr($plaintext, $i, $block_size); $ciphertext .= $iv; $len -= $block_size; $i += $block_size; } if ($len) { $iv = $this->encryptBlock($iv); $block = $iv ^ substr($plaintext, $i); $iv = substr_replace($iv, $block, 0, $len); $ciphertext .= $block; $pos = $len; } break; case self::MODE_CFB8: $ciphertext = ''; $len = strlen($plaintext); $iv = $this->encryptIV; for ($i = 0; $i < $len; ++$i) { $ciphertext .= ($c = $plaintext[$i] ^ $this->encryptBlock($iv)); $iv = substr($iv, 1) . $c; } if ($this->continuousBuffer) { if ($len >= $block_size) { $this->encryptIV = substr($ciphertext, -$block_size); } else { $this->encryptIV = substr($this->encryptIV, $len - $block_size) . substr($ciphertext, -$len); } } break; case self::MODE_OFB8: $ciphertext = ''; $len = strlen($plaintext); $iv = $this->encryptIV; for ($i = 0; $i < $len; ++$i) { $xor = $this->encryptBlock($iv); $ciphertext .= $plaintext[$i] ^ $xor; $iv = substr($iv, 1) . $xor[0]; } if ($this->continuousBuffer) { $this->encryptIV = $iv; } break; case self::MODE_OFB: $xor = $this->encryptIV; if (strlen($buffer['xor'])) { for ($i = 0; $i < strlen($plaintext); $i += $block_size) { $block = substr($plaintext, $i, $block_size); if (strlen($block) > strlen($buffer['xor'])) { $xor = $this->encryptBlock($xor); $buffer['xor'] .= $xor; } $key = Strings::shift($buffer['xor'], $block_size); $ciphertext .= $block ^ $key; } } else { for ($i = 0; $i < strlen($plaintext); $i += $block_size) { $xor = $this->encryptBlock($xor); $ciphertext .= substr($plaintext, $i, $block_size) ^ $xor; } $key = $xor; } if ($this->continuousBuffer) { $this->encryptIV = $xor; if ($start = strlen($plaintext) % $block_size) { $buffer['xor'] = substr($key, $start) . $buffer['xor']; } } break; case self::MODE_STREAM: $ciphertext = $this->encryptBlock($plaintext); break; } return $ciphertext; } /** * Decrypts a message. * * If strlen($ciphertext) is not a multiple of the block size, null bytes will be added to the end of the string until * it is. * * {@internal Could, but not must, extend by the child Crypt_* class} * * @see self::encrypt() * @param string $ciphertext * @return string $plaintext * @throws \LengthException if we're inside a block cipher and the ciphertext length is not a multiple of the block size */ public function decrypt($ciphertext) { if ($this->paddable && strlen($ciphertext) % $this->block_size) { throw new \LengthException('The ciphertext length (' . strlen($ciphertext) . ') needs to be a multiple of the block size (' . $this->block_size . ')'); } $this->setup(); if ($this->mode == self::MODE_GCM || isset($this->poly1305Key)) { if ($this->oldtag === false) { throw new InsufficientSetupException('Authentication Tag has not been set'); } if (isset($this->poly1305Key)) { $newtag = $this->poly1305($ciphertext); } else { $oldIV = $this->iv; Strings::increment_str($this->iv); $cipher = new static('ctr'); $cipher->setKey($this->key); $cipher->setIV($this->iv); $plaintext = $cipher->decrypt($ciphertext); $s = $this->ghash( self::nullPad128($this->aad) . self::nullPad128($ciphertext) . self::len64($this->aad) . self::len64($ciphertext) ); $cipher->encryptIV = $this->iv = $this->encryptIV = $this->decryptIV = $oldIV; $newtag = $cipher->encrypt($s); } if ($this->oldtag != substr($newtag, 0, strlen($newtag))) { $cipher = clone $this; unset($cipher->poly1305Key); $this->usePoly1305 = false; $plaintext = $cipher->decrypt($ciphertext); $this->oldtag = false; throw new BadDecryptionException('Derived authentication tag and supplied authentication tag do not match'); } $this->oldtag = false; return $plaintext; } if ($this->engine === self::ENGINE_OPENSSL) { switch ($this->mode) { case self::MODE_STREAM: $plaintext = openssl_decrypt($ciphertext, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING); break; case self::MODE_ECB: $plaintext = openssl_decrypt($ciphertext, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING); break; case self::MODE_CBC: $offset = $this->block_size; $plaintext = openssl_decrypt($ciphertext, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $this->decryptIV); if ($this->continuousBuffer) { $this->decryptIV = substr($ciphertext, -$offset, $this->block_size); } break; case self::MODE_CTR: $plaintext = $this->openssl_ctr_process($ciphertext, $this->decryptIV, $this->debuffer); break; case self::MODE_CFB: // cfb loosely routines inspired by openssl's: // {@link http://cvs.openssl.org/fileview?f=openssl/crypto/modes/cfb128.c&v=1.3.2.2.2.1} $plaintext = ''; if ($this->continuousBuffer) { $iv = &$this->decryptIV; $pos = &$this->debuffer['pos']; } else { $iv = $this->decryptIV; $pos = 0; } $len = strlen($ciphertext); $i = 0; if ($pos) { $orig_pos = $pos; $max = $this->block_size - $pos; if ($len >= $max) { $i = $max; $len -= $max; $pos = 0; } else { $i = $len; $pos += $len; $len = 0; } // ie. $i = min($max, $len), $len-= $i, $pos+= $i, $pos%= $this->blocksize $plaintext = substr($iv, $orig_pos) ^ $ciphertext; $iv = substr_replace($iv, substr($ciphertext, 0, $i), $orig_pos, $i); $ciphertext = substr($ciphertext, $i); } $overflow = $len % $this->block_size; if ($overflow) { $plaintext .= openssl_decrypt(substr($ciphertext, 0, -$overflow), $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $iv); if ($len - $overflow) { $iv = substr($ciphertext, -$overflow - $this->block_size, -$overflow); } $iv = openssl_encrypt(str_repeat("\0", $this->block_size), $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $iv); $plaintext .= $iv ^ substr($ciphertext, -$overflow); $iv = substr_replace($iv, substr($ciphertext, -$overflow), 0, $overflow); $pos = $overflow; } elseif ($len) { $plaintext .= openssl_decrypt($ciphertext, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $iv); $iv = substr($ciphertext, -$this->block_size); } break; case self::MODE_CFB8: $plaintext = openssl_decrypt($ciphertext, $this->cipher_name_openssl, $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $this->decryptIV); if ($this->continuousBuffer) { if (($len = strlen($ciphertext)) >= $this->block_size) { $this->decryptIV = substr($ciphertext, -$this->block_size); } else { $this->decryptIV = substr($this->decryptIV, $len - $this->block_size) . substr($ciphertext, -$len); } } break; case self::MODE_OFB8: $plaintext = ''; $len = strlen($ciphertext); $iv = $this->decryptIV; for ($i = 0; $i < $len; ++$i) { $xor = openssl_encrypt($iv, $this->cipher_name_openssl_ecb, $this->key, $this->openssl_options, $this->decryptIV); $plaintext .= $ciphertext[$i] ^ $xor; $iv = substr($iv, 1) . $xor[0]; } if ($this->continuousBuffer) { $this->decryptIV = $iv; } break; case self::MODE_OFB: $plaintext = $this->openssl_ofb_process($ciphertext, $this->decryptIV, $this->debuffer); } return $this->paddable ? $this->unpad($plaintext) : $plaintext; } if ($this->engine === self::ENGINE_MCRYPT) { set_error_handler(function () { }); $block_size = $this->block_size; if ($this->dechanged) { mcrypt_generic_init($this->demcrypt, $this->key, $this->getIV($this->decryptIV)); $this->dechanged = false; } if ($this->mode == self::MODE_CFB && $this->continuousBuffer) { $iv = &$this->decryptIV; $pos = &$this->debuffer['pos']; $len = strlen($ciphertext); $plaintext = ''; $i = 0; if ($pos) { $orig_pos = $pos; $max = $block_size - $pos; if ($len >= $max) { $i = $max; $len -= $max; $pos = 0; } else { $i = $len; $pos += $len; $len = 0; } // ie. $i = min($max, $len), $len-= $i, $pos+= $i, $pos%= $blocksize $plaintext = substr($iv, $orig_pos) ^ $ciphertext; $iv = substr_replace($iv, substr($ciphertext, 0, $i), $orig_pos, $i); } if ($len >= $block_size) { $cb = substr($ciphertext, $i, $len - $len % $block_size); $plaintext .= mcrypt_generic($this->ecb, $iv . $cb) ^ $cb; $iv = substr($cb, -$block_size); $len %= $block_size; } if ($len) { $iv = mcrypt_generic($this->ecb, $iv); $plaintext .= $iv ^ substr($ciphertext, -$len); $iv = substr_replace($iv, substr($ciphertext, -$len), 0, $len); $pos = $len; } restore_error_handler(); return $plaintext; } $plaintext = mdecrypt_generic($this->demcrypt, $ciphertext); if (!$this->continuousBuffer) { mcrypt_generic_init($this->demcrypt, $this->key, $this->getIV($this->decryptIV)); } restore_error_handler(); return $this->paddable ? $this->unpad($plaintext) : $plaintext; } if ($this->engine === self::ENGINE_EVAL) { $inline = $this->inline_crypt; return $inline('decrypt', $ciphertext); } $block_size = $this->block_size; $buffer = &$this->debuffer; $plaintext = ''; switch ($this->mode) { case self::MODE_ECB: for ($i = 0; $i < strlen($ciphertext); $i += $block_size) { $plaintext .= $this->decryptBlock(substr($ciphertext, $i, $block_size)); } break; case self::MODE_CBC: $xor = $this->decryptIV; for ($i = 0; $i < strlen($ciphertext); $i += $block_size) { $block = substr($ciphertext, $i, $block_size); $plaintext .= $this->decryptBlock($block) ^ $xor; $xor = $block; } if ($this->continuousBuffer) { $this->decryptIV = $xor; } break; case self::MODE_CTR: $xor = $this->decryptIV; if (strlen($buffer['ciphertext'])) { for ($i = 0; $i < strlen($ciphertext); $i += $block_size) { $block = substr($ciphertext, $i, $block_size); if (strlen($block) > strlen($buffer['ciphertext'])) { $buffer['ciphertext'] .= $this->encryptBlock($xor); Strings::increment_str($xor); } $key = Strings::shift($buffer['ciphertext'], $block_size); $plaintext .= $block ^ $key; } } else { for ($i = 0; $i < strlen($ciphertext); $i += $block_size) { $block = substr($ciphertext, $i, $block_size); $key = $this->encryptBlock($xor); Strings::increment_str($xor); $plaintext .= $block ^ $key; } } if ($this->continuousBuffer) { $this->decryptIV = $xor; if ($start = strlen($ciphertext) % $block_size) { $buffer['ciphertext'] = substr($key, $start) . $buffer['ciphertext']; } } break; case self::MODE_CFB: if ($this->continuousBuffer) { $iv = &$this->decryptIV; $pos = &$buffer['pos']; } else { $iv = $this->decryptIV; $pos = 0; } $len = strlen($ciphertext); $i = 0; if ($pos) { $orig_pos = $pos; $max = $block_size - $pos; if ($len >= $max) { $i = $max; $len -= $max; $pos = 0; } else { $i = $len; $pos += $len; $len = 0; } // ie. $i = min($max, $len), $len-= $i, $pos+= $i, $pos%= $blocksize $plaintext = substr($iv, $orig_pos) ^ $ciphertext; $iv = substr_replace($iv, substr($ciphertext, 0, $i), $orig_pos, $i); } while ($len >= $block_size) { $iv = $this->encryptBlock($iv); $cb = substr($ciphertext, $i, $block_size); $plaintext .= $iv ^ $cb; $iv = $cb; $len -= $block_size; $i += $block_size; } if ($len) { $iv = $this->encryptBlock($iv); $plaintext .= $iv ^ substr($ciphertext, $i); $iv = substr_replace($iv, substr($ciphertext, $i), 0, $len); $pos = $len; } break; case self::MODE_CFB8: $plaintext = ''; $len = strlen($ciphertext); $iv = $this->decryptIV; for ($i = 0; $i < $len; ++$i) { $plaintext .= $ciphertext[$i] ^ $this->encryptBlock($iv); $iv = substr($iv, 1) . $ciphertext[$i]; } if ($this->continuousBuffer) { if ($len >= $block_size) { $this->decryptIV = substr($ciphertext, -$block_size); } else { $this->decryptIV = substr($this->decryptIV, $len - $block_size) . substr($ciphertext, -$len); } } break; case self::MODE_OFB8: $plaintext = ''; $len = strlen($ciphertext); $iv = $this->decryptIV; for ($i = 0; $i < $len; ++$i) { $xor = $this->encryptBlock($iv); $plaintext .= $ciphertext[$i] ^ $xor; $iv = substr($iv, 1) . $xor[0]; } if ($this->continuousBuffer) { $this->decryptIV = $iv; } break; case self::MODE_OFB: $xor = $this->decryptIV; if (strlen($buffer['xor'])) { for ($i = 0; $i < strlen($ciphertext); $i += $block_size) { $block = substr($ciphertext, $i, $block_size); if (strlen($block) > strlen($buffer['xor'])) { $xor = $this->encryptBlock($xor); $buffer['xor'] .= $xor; } $key = Strings::shift($buffer['xor'], $block_size); $plaintext .= $block ^ $key; } } else { for ($i = 0; $i < strlen($ciphertext); $i += $block_size) { $xor = $this->encryptBlock($xor); $plaintext .= substr($ciphertext, $i, $block_size) ^ $xor; } $key = $xor; } if ($this->continuousBuffer) { $this->decryptIV = $xor; if ($start = strlen($ciphertext) % $block_size) { $buffer['xor'] = substr($key, $start) . $buffer['xor']; } } break; case self::MODE_STREAM: $plaintext = $this->decryptBlock($ciphertext); break; } return $this->paddable ? $this->unpad($plaintext) : $plaintext; } /** * Get the authentication tag * * Only used in GCM or Poly1305 mode * * @see self::encrypt() * @param int $length optional * @return string * @throws \LengthException if $length isn't of a sufficient length * @throws \RuntimeException if GCM mode isn't being used */ public function getTag($length = 16) { if ($this->mode != self::MODE_GCM && !$this->usePoly1305) { throw new \BadMethodCallException('Authentication tags are only utilized in GCM mode or with Poly1305'); } if ($this->newtag === false) { throw new \BadMethodCallException('A tag can only be returned after a round of encryption has been performed'); } // the tag is 128-bits. it can't be greater than 16 bytes because that's bigger than the tag is. if it // were 0 you might as well be doing CTR and less than 4 provides minimal security that could be trivially // easily brute forced. // see https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf#page=36 // for more info if ($length < 4 || $length > 16) { throw new \LengthException('The authentication tag must be between 4 and 16 bytes long'); } return $length == 16 ? $this->newtag : substr($this->newtag, 0, $length); } /** * Sets the authentication tag * * Only used in GCM mode * * @see self::decrypt() * @param string $tag * @throws \LengthException if $length isn't of a sufficient length * @throws \RuntimeException if GCM mode isn't being used */ public function setTag($tag) { if ($this->usePoly1305 && !isset($this->poly1305Key) && method_exists($this, 'createPoly1305Key')) { $this->createPoly1305Key(); } if ($this->mode != self::MODE_GCM && !$this->usePoly1305) { throw new \BadMethodCallException('Authentication tags are only utilized in GCM mode or with Poly1305'); } $length = strlen($tag); if ($length < 4 || $length > 16) { throw new \LengthException('The authentication tag must be between 4 and 16 bytes long'); } $this->oldtag = $tag; } /** * Get the IV * * mcrypt requires an IV even if ECB is used * * @see self::encrypt() * @see self::decrypt() * @param string $iv * @return string */ protected function getIV($iv) { return $this->mode == self::MODE_ECB ? str_repeat("\0", $this->block_size) : $iv; } /** * OpenSSL CTR Processor * * PHP's OpenSSL bindings do not operate in continuous mode so we'll wrap around it. Since the keystream * for CTR is the same for both encrypting and decrypting this function is re-used by both SymmetricKey::encrypt() * and SymmetricKey::decrypt(). Also, OpenSSL doesn't implement CTR for all of it's symmetric ciphers so this * function will emulate CTR with ECB when necessary. * * @see self::encrypt() * @see self::decrypt() * @param string $plaintext * @param string $encryptIV * @param array $buffer * @return string */ private function openssl_ctr_process($plaintext, &$encryptIV, &$buffer) { $ciphertext = ''; $block_size = $this->block_size; $key = $this->key; if ($this->openssl_emulate_ctr) { $xor = $encryptIV; if (strlen($buffer['ciphertext'])) { for ($i = 0; $i < strlen($plaintext); $i += $block_size) { $block = substr($plaintext, $i, $block_size); if (strlen($block) > strlen($buffer['ciphertext'])) { $buffer['ciphertext'] .= openssl_encrypt($xor, $this->cipher_name_openssl_ecb, $key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING); } Strings::increment_str($xor); $otp = Strings::shift($buffer['ciphertext'], $block_size); $ciphertext .= $block ^ $otp; } } else { for ($i = 0; $i < strlen($plaintext); $i += $block_size) { $block = substr($plaintext, $i, $block_size); $otp = openssl_encrypt($xor, $this->cipher_name_openssl_ecb, $key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING); Strings::increment_str($xor); $ciphertext .= $block ^ $otp; } } if ($this->continuousBuffer) { $encryptIV = $xor; if ($start = strlen($plaintext) % $block_size) { $buffer['ciphertext'] = substr($key, $start) . $buffer['ciphertext']; } } return $ciphertext; } if (strlen($buffer['ciphertext'])) { $ciphertext = $plaintext ^ Strings::shift($buffer['ciphertext'], strlen($plaintext)); $plaintext = substr($plaintext, strlen($ciphertext)); if (!strlen($plaintext)) { return $ciphertext; } } $overflow = strlen($plaintext) % $block_size; if ($overflow) { $plaintext2 = Strings::pop($plaintext, $overflow); // ie. trim $plaintext to a multiple of $block_size and put rest of $plaintext in $plaintext2 $encrypted = openssl_encrypt($plaintext . str_repeat("\0", $block_size), $this->cipher_name_openssl, $key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $encryptIV); $temp = Strings::pop($encrypted, $block_size); $ciphertext .= $encrypted . ($plaintext2 ^ $temp); if ($this->continuousBuffer) { $buffer['ciphertext'] = substr($temp, $overflow); $encryptIV = $temp; } } elseif (!strlen($buffer['ciphertext'])) { $ciphertext .= openssl_encrypt($plaintext . str_repeat("\0", $block_size), $this->cipher_name_openssl, $key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $encryptIV); $temp = Strings::pop($ciphertext, $block_size); if ($this->continuousBuffer) { $encryptIV = $temp; } } if ($this->continuousBuffer) { $encryptIV = openssl_decrypt($encryptIV, $this->cipher_name_openssl_ecb, $key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING); if ($overflow) { Strings::increment_str($encryptIV); } } return $ciphertext; } /** * OpenSSL OFB Processor * * PHP's OpenSSL bindings do not operate in continuous mode so we'll wrap around it. Since the keystream * for OFB is the same for both encrypting and decrypting this function is re-used by both SymmetricKey::encrypt() * and SymmetricKey::decrypt(). * * @see self::encrypt() * @see self::decrypt() * @param string $plaintext * @param string $encryptIV * @param array $buffer * @return string */ private function openssl_ofb_process($plaintext, &$encryptIV, &$buffer) { if (strlen($buffer['xor'])) { $ciphertext = $plaintext ^ $buffer['xor']; $buffer['xor'] = substr($buffer['xor'], strlen($ciphertext)); $plaintext = substr($plaintext, strlen($ciphertext)); } else { $ciphertext = ''; } $block_size = $this->block_size; $len = strlen($plaintext); $key = $this->key; $overflow = $len % $block_size; if (strlen($plaintext)) { if ($overflow) { $ciphertext .= openssl_encrypt(substr($plaintext, 0, -$overflow) . str_repeat("\0", $block_size), $this->cipher_name_openssl, $key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $encryptIV); $xor = Strings::pop($ciphertext, $block_size); if ($this->continuousBuffer) { $encryptIV = $xor; } $ciphertext .= Strings::shift($xor, $overflow) ^ substr($plaintext, -$overflow); if ($this->continuousBuffer) { $buffer['xor'] = $xor; } } else { $ciphertext = openssl_encrypt($plaintext, $this->cipher_name_openssl, $key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING, $encryptIV); if ($this->continuousBuffer) { $encryptIV = substr($ciphertext, -$block_size) ^ substr($plaintext, -$block_size); } } } return $ciphertext; } /** * phpseclib <-> OpenSSL Mode Mapper * * May need to be overwritten by classes extending this one in some cases * * @return string */ protected function openssl_translate_mode() { switch ($this->mode) { case self::MODE_ECB: return 'ecb'; case self::MODE_CBC: return 'cbc'; case self::MODE_CTR: case self::MODE_GCM: return 'ctr'; case self::MODE_CFB: return 'cfb'; case self::MODE_CFB8: return 'cfb8'; case self::MODE_OFB: return 'ofb'; } } /** * Pad "packets". * * Block ciphers working by encrypting between their specified [$this->]block_size at a time * If you ever need to encrypt or decrypt something that isn't of the proper length, it becomes necessary to * pad the input so that it is of the proper length. * * Padding is enabled by default. Sometimes, however, it is undesirable to pad strings. Such is the case in SSH, * where "packets" are padded with random bytes before being encrypted. Unpad these packets and you risk stripping * away characters that shouldn't be stripped away. (SSH knows how many bytes are added because the length is * transmitted separately) * * @see self::disablePadding() */ public function enablePadding() { $this->padding = true; } /** * Do not pad packets. * * @see self::enablePadding() */ public function disablePadding() { $this->padding = false; } /** * Treat consecutive "packets" as if they are a continuous buffer. * * Say you have a 32-byte plaintext $plaintext. Using the default behavior, the two following code snippets * will yield different outputs: * * * echo $rijndael->encrypt(substr($plaintext, 0, 16)); * echo $rijndael->encrypt(substr($plaintext, 16, 16)); * * * echo $rijndael->encrypt($plaintext); * * * The solution is to enable the continuous buffer. Although this will resolve the above discrepancy, it creates * another, as demonstrated with the following: * * * $rijndael->encrypt(substr($plaintext, 0, 16)); * echo $rijndael->decrypt($rijndael->encrypt(substr($plaintext, 16, 16))); * * * echo $rijndael->decrypt($rijndael->encrypt(substr($plaintext, 16, 16))); * * * With the continuous buffer disabled, these would yield the same output. With it enabled, they yield different * outputs. The reason is due to the fact that the initialization vector's change after every encryption / * decryption round when the continuous buffer is enabled. When it's disabled, they remain constant. * * Put another way, when the continuous buffer is enabled, the state of the \phpseclib3\Crypt\*() object changes after each * encryption / decryption round, whereas otherwise, it'd remain constant. For this reason, it's recommended that * continuous buffers not be used. They do offer better security and are, in fact, sometimes required (SSH uses them), * however, they are also less intuitive and more likely to cause you problems. * * {@internal Could, but not must, extend by the child Crypt_* class} * * @see self::disableContinuousBuffer() */ public function enableContinuousBuffer() { if ($this->mode == self::MODE_ECB) { return; } if ($this->mode == self::MODE_GCM) { throw new \BadMethodCallException('This mode does not run in continuous mode'); } $this->continuousBuffer = true; $this->setEngine(); } /** * Treat consecutive packets as if they are a discontinuous buffer. * * The default behavior. * * {@internal Could, but not must, extend by the child Crypt_* class} * * @see self::enableContinuousBuffer() */ public function disableContinuousBuffer() { if ($this->mode == self::MODE_ECB) { return; } if (!$this->continuousBuffer) { return; } $this->continuousBuffer = false; $this->setEngine(); } /** * Test for engine validity * * @see self::__construct() * @param int $engine * @return bool */ protected function isValidEngineHelper($engine) { switch ($engine) { case self::ENGINE_OPENSSL: $this->openssl_emulate_ctr = false; $result = $this->cipher_name_openssl && extension_loaded('openssl'); if (!$result) { return false; } $methods = openssl_get_cipher_methods(); if (in_array($this->cipher_name_openssl, $methods)) { return true; } // not all of openssl's symmetric cipher's support ctr. for those // that don't we'll emulate it switch ($this->mode) { case self::MODE_CTR: if (in_array($this->cipher_name_openssl_ecb, $methods)) { $this->openssl_emulate_ctr = true; return true; } } return false; case self::ENGINE_MCRYPT: set_error_handler(function () { }); $result = $this->cipher_name_mcrypt && extension_loaded('mcrypt') && in_array($this->cipher_name_mcrypt, mcrypt_list_algorithms()); restore_error_handler(); return $result; case self::ENGINE_EVAL: return method_exists($this, 'setupInlineCrypt'); case self::ENGINE_INTERNAL: return true; } return false; } /** * Test for engine validity * * @see self::__construct() * @param string $engine * @return bool */ public function isValidEngine($engine) { static $reverseMap; if (!isset($reverseMap)) { $reverseMap = array_map('strtolower', self::ENGINE_MAP); $reverseMap = array_flip($reverseMap); } $engine = strtolower($engine); if (!isset($reverseMap[$engine])) { return false; } return $this->isValidEngineHelper($reverseMap[$engine]); } /** * Sets the preferred crypt engine * * Currently, $engine could be: * * - libsodium[very fast] * * - OpenSSL [very fast] * * - mcrypt [fast] * * - Eval [slow] * * - PHP [slowest] * * If the preferred crypt engine is not available the fastest available one will be used * * @see self::__construct() * @param string $engine */ public function setPreferredEngine($engine) { static $reverseMap; if (!isset($reverseMap)) { $reverseMap = array_map('strtolower', self::ENGINE_MAP); $reverseMap = array_flip($reverseMap); } $engine = is_string($engine) ? strtolower($engine) : ''; $this->preferredEngine = isset($reverseMap[$engine]) ? $reverseMap[$engine] : self::ENGINE_LIBSODIUM; $this->setEngine(); } /** * Returns the engine currently being utilized * * @see self::setEngine() */ public function getEngine() { return self::ENGINE_MAP[$this->engine]; } /** * Sets the engine as appropriate * * @see self::__construct() */ protected function setEngine() { $this->engine = null; $candidateEngines = [ self::ENGINE_LIBSODIUM, self::ENGINE_OPENSSL_GCM, self::ENGINE_OPENSSL, self::ENGINE_MCRYPT, self::ENGINE_EVAL ]; if (isset($this->preferredEngine)) { $temp = [$this->preferredEngine]; $candidateEngines = array_merge( $temp, array_diff($candidateEngines, $temp) ); } foreach ($candidateEngines as $engine) { if ($this->isValidEngineHelper($engine)) { $this->engine = $engine; break; } } if (!$this->engine) { $this->engine = self::ENGINE_INTERNAL; } if ($this->engine != self::ENGINE_MCRYPT && $this->enmcrypt) { set_error_handler(function () { }); // Closing the current mcrypt resource(s). _mcryptSetup() will, if needed, // (re)open them with the module named in $this->cipher_name_mcrypt mcrypt_module_close($this->enmcrypt); mcrypt_module_close($this->demcrypt); $this->enmcrypt = null; $this->demcrypt = null; if ($this->ecb) { mcrypt_module_close($this->ecb); $this->ecb = null; } restore_error_handler(); } $this->changed = $this->nonIVChanged = true; } /** * Encrypts a block * * Note: Must be extended by the child \phpseclib3\Crypt\* class * * @param string $in * @return string */ abstract protected function encryptBlock($in); /** * Decrypts a block * * Note: Must be extended by the child \phpseclib3\Crypt\* class * * @param string $in * @return string */ abstract protected function decryptBlock($in); /** * Setup the key (expansion) * * Only used if $engine == self::ENGINE_INTERNAL * * Note: Must extend by the child \phpseclib3\Crypt\* class * * @see self::setup() */ abstract protected function setupKey(); /** * Setup the self::ENGINE_INTERNAL $engine * * (re)init, if necessary, the internal cipher $engine and flush all $buffers * Used (only) if $engine == self::ENGINE_INTERNAL * * _setup() will be called each time if $changed === true * typically this happens when using one or more of following public methods: * * - setKey() * * - setIV() * * - disableContinuousBuffer() * * - First run of encrypt() / decrypt() with no init-settings * * {@internal setup() is always called before en/decryption.} * * {@internal Could, but not must, extend by the child Crypt_* class} * * @see self::setKey() * @see self::setIV() * @see self::disableContinuousBuffer() */ protected function setup() { if (!$this->changed) { return; } $this->changed = false; if ($this->usePoly1305 && !isset($this->poly1305Key) && method_exists($this, 'createPoly1305Key')) { $this->createPoly1305Key(); } $this->enbuffer = $this->debuffer = ['ciphertext' => '', 'xor' => '', 'pos' => 0, 'enmcrypt_init' => true]; //$this->newtag = $this->oldtag = false; if ($this->usesNonce()) { if ($this->nonce === false) { throw new InsufficientSetupException('No nonce has been defined'); } if ($this->mode == self::MODE_GCM && !in_array($this->engine, [self::ENGINE_LIBSODIUM, self::ENGINE_OPENSSL_GCM])) { $this->setupGCM(); } } else { $this->iv = $this->origIV; } if ($this->iv === false && !in_array($this->mode, [self::MODE_STREAM, self::MODE_ECB])) { if ($this->mode != self::MODE_GCM || !in_array($this->engine, [self::ENGINE_LIBSODIUM, self::ENGINE_OPENSSL_GCM])) { throw new InsufficientSetupException('No IV has been defined'); } } if ($this->key === false) { throw new InsufficientSetupException('No key has been defined'); } $this->encryptIV = $this->decryptIV = $this->iv; switch ($this->engine) { case self::ENGINE_MCRYPT: $this->enchanged = $this->dechanged = true; set_error_handler(function () { }); if (!isset($this->enmcrypt)) { static $mcrypt_modes = [ self::MODE_CTR => 'ctr', self::MODE_ECB => MCRYPT_MODE_ECB, self::MODE_CBC => MCRYPT_MODE_CBC, self::MODE_CFB => 'ncfb', self::MODE_CFB8 => MCRYPT_MODE_CFB, self::MODE_OFB => MCRYPT_MODE_NOFB, self::MODE_OFB8 => MCRYPT_MODE_OFB, self::MODE_STREAM => MCRYPT_MODE_STREAM, ]; $this->demcrypt = mcrypt_module_open($this->cipher_name_mcrypt, '', $mcrypt_modes[$this->mode], ''); $this->enmcrypt = mcrypt_module_open($this->cipher_name_mcrypt, '', $mcrypt_modes[$this->mode], ''); // we need the $ecb mcrypt resource (only) in MODE_CFB with enableContinuousBuffer() // to workaround mcrypt's broken ncfb implementation in buffered mode // see: {@link http://phpseclib.sourceforge.net/cfb-demo.phps} if ($this->mode == self::MODE_CFB) { $this->ecb = mcrypt_module_open($this->cipher_name_mcrypt, '', MCRYPT_MODE_ECB, ''); } } // else should mcrypt_generic_deinit be called? if ($this->mode == self::MODE_CFB) { mcrypt_generic_init($this->ecb, $this->key, str_repeat("\0", $this->block_size)); } restore_error_handler(); break; case self::ENGINE_INTERNAL: $this->setupKey(); break; case self::ENGINE_EVAL: if ($this->nonIVChanged) { $this->setupKey(); $this->setupInlineCrypt(); } } $this->nonIVChanged = false; } /** * Pads a string * * Pads a string using the RSA PKCS padding standards so that its length is a multiple of the blocksize. * $this->block_size - (strlen($text) % $this->block_size) bytes are added, each of which is equal to * chr($this->block_size - (strlen($text) % $this->block_size) * * If padding is disabled and $text is not a multiple of the blocksize, the string will be padded regardless * and padding will, hence forth, be enabled. * * @see self::unpad() * @param string $text * @throws \LengthException if padding is disabled and the plaintext's length is not a multiple of the block size * @return string */ protected function pad($text) { $length = strlen($text); if (!$this->padding) { if ($length % $this->block_size == 0) { return $text; } else { throw new \LengthException("The plaintext's length ($length) is not a multiple of the block size ({$this->block_size}). Try enabling padding."); } } $pad = $this->block_size - ($length % $this->block_size); return str_pad($text, $length + $pad, chr($pad)); } /** * Unpads a string. * * If padding is enabled and the reported padding length is invalid the encryption key will be assumed to be wrong * and false will be returned. * * @see self::pad() * @param string $text * @throws \LengthException if the ciphertext's length is not a multiple of the block size * @return string */ protected function unpad($text) { if (!$this->padding) { return $text; } $length = ord($text[strlen($text) - 1]); if (!$length || $length > $this->block_size) { throw new BadDecryptionException("The ciphertext has an invalid padding length ($length) compared to the block size ({$this->block_size})"); } return substr($text, 0, -$length); } /** * Setup the performance-optimized function for de/encrypt() * * Stores the created (or existing) callback function-name * in $this->inline_crypt * * Internally for phpseclib developers: * * _setupInlineCrypt() would be called only if: * * - $this->engine === self::ENGINE_EVAL * * - each time on _setup(), after(!) _setupKey() * * * This ensures that _setupInlineCrypt() has always a * full ready2go initializated internal cipher $engine state * where, for example, the keys already expanded, * keys/block_size calculated and such. * * It is, each time if called, the responsibility of _setupInlineCrypt(): * * - to set $this->inline_crypt to a valid and fully working callback function * as a (faster) replacement for encrypt() / decrypt() * * - NOT to create unlimited callback functions (for memory reasons!) * no matter how often _setupInlineCrypt() would be called. At some * point of amount they must be generic re-useable. * * - the code of _setupInlineCrypt() it self, * and the generated callback code, * must be, in following order: * - 100% safe * - 100% compatible to encrypt()/decrypt() * - using only php5+ features/lang-constructs/php-extensions if * compatibility (down to php4) or fallback is provided * - readable/maintainable/understandable/commented and... not-cryptic-styled-code :-) * - >= 10% faster than encrypt()/decrypt() [which is, by the way, * the reason for the existence of _setupInlineCrypt() :-)] * - memory-nice * - short (as good as possible) * * Note: - _setupInlineCrypt() is using _createInlineCryptFunction() to create the full callback function code. * - In case of using inline crypting, _setupInlineCrypt() must extend by the child \phpseclib3\Crypt\* class. * - The following variable names are reserved: * - $_* (all variable names prefixed with an underscore) * - $self (object reference to it self. Do not use $this, but $self instead) * - $in (the content of $in has to en/decrypt by the generated code) * - The callback function should not use the 'return' statement, but en/decrypt'ing the content of $in only * * {@internal If a Crypt_* class providing inline crypting it must extend _setupInlineCrypt()} * * @see self::setup() * @see self::createInlineCryptFunction() * @see self::encrypt() * @see self::decrypt() */ //protected function setupInlineCrypt(); /** * Creates the performance-optimized function for en/decrypt() * * Internally for phpseclib developers: * * _createInlineCryptFunction(): * * - merge the $cipher_code [setup'ed by _setupInlineCrypt()] * with the current [$this->]mode of operation code * * - create the $inline function, which called by encrypt() / decrypt() * as its replacement to speed up the en/decryption operations. * * - return the name of the created $inline callback function * * - used to speed up en/decryption * * * * The main reason why can speed up things [up to 50%] this way are: * * - using variables more effective then regular. * (ie no use of expensive arrays but integers $k_0, $k_1 ... * or even, for example, the pure $key[] values hardcoded) * * - avoiding 1000's of function calls of ie _encryptBlock() * but inlining the crypt operations. * in the mode of operation for() loop. * * - full loop unroll the (sometimes key-dependent) rounds * avoiding this way ++$i counters and runtime-if's etc... * * The basic code architectur of the generated $inline en/decrypt() * lambda function, in pseudo php, is: * * * +----------------------------------------------------------------------------------------------+ * | callback $inline = create_function: | * | lambda_function_0001_crypt_ECB($action, $text) | * | { | * | INSERT PHP CODE OF: | * | $cipher_code['init_crypt']; // general init code. | * | // ie: $sbox'es declarations used for | * | // encrypt and decrypt'ing. | * | | * | switch ($action) { | * | case 'encrypt': | * | INSERT PHP CODE OF: | * | $cipher_code['init_encrypt']; // encrypt sepcific init code. | * | ie: specified $key or $box | * | declarations for encrypt'ing. | * | | * | foreach ($ciphertext) { | * | $in = $block_size of $ciphertext; | * | | * | INSERT PHP CODE OF: | * | $cipher_code['encrypt_block']; // encrypt's (string) $in, which is always: | * | // strlen($in) == $this->block_size | * | // here comes the cipher algorithm in action | * | // for encryption. | * | // $cipher_code['encrypt_block'] has to | * | // encrypt the content of the $in variable | * | | * | $plaintext .= $in; | * | } | * | return $plaintext; | * | | * | case 'decrypt': | * | INSERT PHP CODE OF: | * | $cipher_code['init_decrypt']; // decrypt sepcific init code | * | ie: specified $key or $box | * | declarations for decrypt'ing. | * | foreach ($plaintext) { | * | $in = $block_size of $plaintext; | * | | * | INSERT PHP CODE OF: | * | $cipher_code['decrypt_block']; // decrypt's (string) $in, which is always | * | // strlen($in) == $this->block_size | * | // here comes the cipher algorithm in action | * | // for decryption. | * | // $cipher_code['decrypt_block'] has to | * | // decrypt the content of the $in variable | * | $ciphertext .= $in; | * | } | * | return $ciphertext; | * | } | * | } | * +----------------------------------------------------------------------------------------------+ * * * See also the \phpseclib3\Crypt\*::_setupInlineCrypt()'s for * productive inline $cipher_code's how they works. * * Structure of: * * $cipher_code = [ * 'init_crypt' => (string) '', // optional * 'init_encrypt' => (string) '', // optional * 'init_decrypt' => (string) '', // optional * 'encrypt_block' => (string) '', // required * 'decrypt_block' => (string) '' // required * ]; * * * @see self::setupInlineCrypt() * @see self::encrypt() * @see self::decrypt() * @param array $cipher_code * @return string (the name of the created callback function) */ protected function createInlineCryptFunction($cipher_code) { $block_size = $this->block_size; // optional $init_crypt = isset($cipher_code['init_crypt']) ? $cipher_code['init_crypt'] : ''; $init_encrypt = isset($cipher_code['init_encrypt']) ? $cipher_code['init_encrypt'] : ''; $init_decrypt = isset($cipher_code['init_decrypt']) ? $cipher_code['init_decrypt'] : ''; // required $encrypt_block = $cipher_code['encrypt_block']; $decrypt_block = $cipher_code['decrypt_block']; // Generating mode of operation inline code, // merged with the $cipher_code algorithm // for encrypt- and decryption. switch ($this->mode) { case self::MODE_ECB: $encrypt = $init_encrypt . ' $_ciphertext = ""; $_plaintext_len = strlen($_text); for ($_i = 0; $_i < $_plaintext_len; $_i+= ' . $block_size . ') { $in = substr($_text, $_i, ' . $block_size . '); ' . $encrypt_block . ' $_ciphertext.= $in; } return $_ciphertext; '; $decrypt = $init_decrypt . ' $_plaintext = ""; $_text = str_pad($_text, strlen($_text) + (' . $block_size . ' - strlen($_text) % ' . $block_size . ') % ' . $block_size . ', chr(0)); $_ciphertext_len = strlen($_text); for ($_i = 0; $_i < $_ciphertext_len; $_i+= ' . $block_size . ') { $in = substr($_text, $_i, ' . $block_size . '); ' . $decrypt_block . ' $_plaintext.= $in; } return $this->unpad($_plaintext); '; break; case self::MODE_CTR: $encrypt = $init_encrypt . ' $_ciphertext = ""; $_plaintext_len = strlen($_text); $_xor = $this->encryptIV; $_buffer = &$this->enbuffer; if (strlen($_buffer["ciphertext"])) { for ($_i = 0; $_i < $_plaintext_len; $_i+= ' . $block_size . ') { $_block = substr($_text, $_i, ' . $block_size . '); if (strlen($_block) > strlen($_buffer["ciphertext"])) { $in = $_xor; ' . $encrypt_block . ' \phpseclib3\Common\Functions\Strings::increment_str($_xor); $_buffer["ciphertext"].= $in; } $_key = \phpseclib3\Common\Functions\Strings::shift($_buffer["ciphertext"], ' . $block_size . '); $_ciphertext.= $_block ^ $_key; } } else { for ($_i = 0; $_i < $_plaintext_len; $_i+= ' . $block_size . ') { $_block = substr($_text, $_i, ' . $block_size . '); $in = $_xor; ' . $encrypt_block . ' \phpseclib3\Common\Functions\Strings::increment_str($_xor); $_key = $in; $_ciphertext.= $_block ^ $_key; } } if ($this->continuousBuffer) { $this->encryptIV = $_xor; if ($_start = $_plaintext_len % ' . $block_size . ') { $_buffer["ciphertext"] = substr($_key, $_start) . $_buffer["ciphertext"]; } } return $_ciphertext; '; $decrypt = $init_encrypt . ' $_plaintext = ""; $_ciphertext_len = strlen($_text); $_xor = $this->decryptIV; $_buffer = &$this->debuffer; if (strlen($_buffer["ciphertext"])) { for ($_i = 0; $_i < $_ciphertext_len; $_i+= ' . $block_size . ') { $_block = substr($_text, $_i, ' . $block_size . '); if (strlen($_block) > strlen($_buffer["ciphertext"])) { $in = $_xor; ' . $encrypt_block . ' \phpseclib3\Common\Functions\Strings::increment_str($_xor); $_buffer["ciphertext"].= $in; } $_key = \phpseclib3\Common\Functions\Strings::shift($_buffer["ciphertext"], ' . $block_size . '); $_plaintext.= $_block ^ $_key; } } else { for ($_i = 0; $_i < $_ciphertext_len; $_i+= ' . $block_size . ') { $_block = substr($_text, $_i, ' . $block_size . '); $in = $_xor; ' . $encrypt_block . ' \phpseclib3\Common\Functions\Strings::increment_str($_xor); $_key = $in; $_plaintext.= $_block ^ $_key; } } if ($this->continuousBuffer) { $this->decryptIV = $_xor; if ($_start = $_ciphertext_len % ' . $block_size . ') { $_buffer["ciphertext"] = substr($_key, $_start) . $_buffer["ciphertext"]; } } return $_plaintext; '; break; case self::MODE_CFB: $encrypt = $init_encrypt . ' $_ciphertext = ""; $_buffer = &$this->enbuffer; if ($this->continuousBuffer) { $_iv = &$this->encryptIV; $_pos = &$_buffer["pos"]; } else { $_iv = $this->encryptIV; $_pos = 0; } $_len = strlen($_text); $_i = 0; if ($_pos) { $_orig_pos = $_pos; $_max = ' . $block_size . ' - $_pos; if ($_len >= $_max) { $_i = $_max; $_len-= $_max; $_pos = 0; } else { $_i = $_len; $_pos+= $_len; $_len = 0; } $_ciphertext = substr($_iv, $_orig_pos) ^ $_text; $_iv = substr_replace($_iv, $_ciphertext, $_orig_pos, $_i); } while ($_len >= ' . $block_size . ') { $in = $_iv; ' . $encrypt_block . '; $_iv = $in ^ substr($_text, $_i, ' . $block_size . '); $_ciphertext.= $_iv; $_len-= ' . $block_size . '; $_i+= ' . $block_size . '; } if ($_len) { $in = $_iv; ' . $encrypt_block . ' $_iv = $in; $_block = $_iv ^ substr($_text, $_i); $_iv = substr_replace($_iv, $_block, 0, $_len); $_ciphertext.= $_block; $_pos = $_len; } return $_ciphertext; '; $decrypt = $init_encrypt . ' $_plaintext = ""; $_buffer = &$this->debuffer; if ($this->continuousBuffer) { $_iv = &$this->decryptIV; $_pos = &$_buffer["pos"]; } else { $_iv = $this->decryptIV; $_pos = 0; } $_len = strlen($_text); $_i = 0; if ($_pos) { $_orig_pos = $_pos; $_max = ' . $block_size . ' - $_pos; if ($_len >= $_max) { $_i = $_max; $_len-= $_max; $_pos = 0; } else { $_i = $_len; $_pos+= $_len; $_len = 0; } $_plaintext = substr($_iv, $_orig_pos) ^ $_text; $_iv = substr_replace($_iv, substr($_text, 0, $_i), $_orig_pos, $_i); } while ($_len >= ' . $block_size . ') { $in = $_iv; ' . $encrypt_block . ' $_iv = $in; $cb = substr($_text, $_i, ' . $block_size . '); $_plaintext.= $_iv ^ $cb; $_iv = $cb; $_len-= ' . $block_size . '; $_i+= ' . $block_size . '; } if ($_len) { $in = $_iv; ' . $encrypt_block . ' $_iv = $in; $_plaintext.= $_iv ^ substr($_text, $_i); $_iv = substr_replace($_iv, substr($_text, $_i), 0, $_len); $_pos = $_len; } return $_plaintext; '; break; case self::MODE_CFB8: $encrypt = $init_encrypt . ' $_ciphertext = ""; $_len = strlen($_text); $_iv = $this->encryptIV; for ($_i = 0; $_i < $_len; ++$_i) { $in = $_iv; ' . $encrypt_block . ' $_ciphertext .= ($_c = $_text[$_i] ^ $in); $_iv = substr($_iv, 1) . $_c; } if ($this->continuousBuffer) { if ($_len >= ' . $block_size . ') { $this->encryptIV = substr($_ciphertext, -' . $block_size . '); } else { $this->encryptIV = substr($this->encryptIV, $_len - ' . $block_size . ') . substr($_ciphertext, -$_len); } } return $_ciphertext; '; $decrypt = $init_encrypt . ' $_plaintext = ""; $_len = strlen($_text); $_iv = $this->decryptIV; for ($_i = 0; $_i < $_len; ++$_i) { $in = $_iv; ' . $encrypt_block . ' $_plaintext .= $_text[$_i] ^ $in; $_iv = substr($_iv, 1) . $_text[$_i]; } if ($this->continuousBuffer) { if ($_len >= ' . $block_size . ') { $this->decryptIV = substr($_text, -' . $block_size . '); } else { $this->decryptIV = substr($this->decryptIV, $_len - ' . $block_size . ') . substr($_text, -$_len); } } return $_plaintext; '; break; case self::MODE_OFB8: $encrypt = $init_encrypt . ' $_ciphertext = ""; $_len = strlen($_text); $_iv = $this->encryptIV; for ($_i = 0; $_i < $_len; ++$_i) { $in = $_iv; ' . $encrypt_block . ' $_ciphertext.= $_text[$_i] ^ $in; $_iv = substr($_iv, 1) . $in[0]; } if ($this->continuousBuffer) { $this->encryptIV = $_iv; } return $_ciphertext; '; $decrypt = $init_encrypt . ' $_plaintext = ""; $_len = strlen($_text); $_iv = $this->decryptIV; for ($_i = 0; $_i < $_len; ++$_i) { $in = $_iv; ' . $encrypt_block . ' $_plaintext.= $_text[$_i] ^ $in; $_iv = substr($_iv, 1) . $in[0]; } if ($this->continuousBuffer) { $this->decryptIV = $_iv; } return $_plaintext; '; break; case self::MODE_OFB: $encrypt = $init_encrypt . ' $_ciphertext = ""; $_plaintext_len = strlen($_text); $_xor = $this->encryptIV; $_buffer = &$this->enbuffer; if (strlen($_buffer["xor"])) { for ($_i = 0; $_i < $_plaintext_len; $_i+= ' . $block_size . ') { $_block = substr($_text, $_i, ' . $block_size . '); if (strlen($_block) > strlen($_buffer["xor"])) { $in = $_xor; ' . $encrypt_block . ' $_xor = $in; $_buffer["xor"].= $_xor; } $_key = \phpseclib3\Common\Functions\Strings::shift($_buffer["xor"], ' . $block_size . '); $_ciphertext.= $_block ^ $_key; } } else { for ($_i = 0; $_i < $_plaintext_len; $_i+= ' . $block_size . ') { $in = $_xor; ' . $encrypt_block . ' $_xor = $in; $_ciphertext.= substr($_text, $_i, ' . $block_size . ') ^ $_xor; } $_key = $_xor; } if ($this->continuousBuffer) { $this->encryptIV = $_xor; if ($_start = $_plaintext_len % ' . $block_size . ') { $_buffer["xor"] = substr($_key, $_start) . $_buffer["xor"]; } } return $_ciphertext; '; $decrypt = $init_encrypt . ' $_plaintext = ""; $_ciphertext_len = strlen($_text); $_xor = $this->decryptIV; $_buffer = &$this->debuffer; if (strlen($_buffer["xor"])) { for ($_i = 0; $_i < $_ciphertext_len; $_i+= ' . $block_size . ') { $_block = substr($_text, $_i, ' . $block_size . '); if (strlen($_block) > strlen($_buffer["xor"])) { $in = $_xor; ' . $encrypt_block . ' $_xor = $in; $_buffer["xor"].= $_xor; } $_key = \phpseclib3\Common\Functions\Strings::shift($_buffer["xor"], ' . $block_size . '); $_plaintext.= $_block ^ $_key; } } else { for ($_i = 0; $_i < $_ciphertext_len; $_i+= ' . $block_size . ') { $in = $_xor; ' . $encrypt_block . ' $_xor = $in; $_plaintext.= substr($_text, $_i, ' . $block_size . ') ^ $_xor; } $_key = $_xor; } if ($this->continuousBuffer) { $this->decryptIV = $_xor; if ($_start = $_ciphertext_len % ' . $block_size . ') { $_buffer["xor"] = substr($_key, $_start) . $_buffer["xor"]; } } return $_plaintext; '; break; case self::MODE_STREAM: $encrypt = $init_encrypt . ' $_ciphertext = ""; ' . $encrypt_block . ' return $_ciphertext; '; $decrypt = $init_decrypt . ' $_plaintext = ""; ' . $decrypt_block . ' return $_plaintext; '; break; // case self::MODE_CBC: default: $encrypt = $init_encrypt . ' $_ciphertext = ""; $_plaintext_len = strlen($_text); $in = $this->encryptIV; for ($_i = 0; $_i < $_plaintext_len; $_i+= ' . $block_size . ') { $in = substr($_text, $_i, ' . $block_size . ') ^ $in; ' . $encrypt_block . ' $_ciphertext.= $in; } if ($this->continuousBuffer) { $this->encryptIV = $in; } return $_ciphertext; '; $decrypt = $init_decrypt . ' $_plaintext = ""; $_text = str_pad($_text, strlen($_text) + (' . $block_size . ' - strlen($_text) % ' . $block_size . ') % ' . $block_size . ', chr(0)); $_ciphertext_len = strlen($_text); $_iv = $this->decryptIV; for ($_i = 0; $_i < $_ciphertext_len; $_i+= ' . $block_size . ') { $in = $_block = substr($_text, $_i, ' . $block_size . '); ' . $decrypt_block . ' $_plaintext.= $in ^ $_iv; $_iv = $_block; } if ($this->continuousBuffer) { $this->decryptIV = $_iv; } return $this->unpad($_plaintext); '; break; } // Before discrediting this, please read the following: // @see https://github.com/phpseclib/phpseclib/issues/1293 // @see https://github.com/phpseclib/phpseclib/pull/1143 eval('$func = function ($_action, $_text) { ' . $init_crypt . 'if ($_action == "encrypt") { ' . $encrypt . ' } else { ' . $decrypt . ' }};'); return \Closure::bind($func, $this, static::class); } /** * Convert float to int * * On ARM CPUs converting floats to ints doesn't always work * * @param string $x * @return int */ protected static function safe_intval($x) { if (is_int($x)) { return $x; } if (self::$use_reg_intval) { return PHP_INT_SIZE == 4 && PHP_VERSION_ID >= 80100 ? intval($x) : $x; } return (fmod($x, 0x80000000) & 0x7FFFFFFF) | ((fmod(floor($x / 0x80000000), 2) & 1) << 31); } /** * eval()'able string for in-line float to int * * @return string */ protected static function safe_intval_inline() { if (self::$use_reg_intval) { return PHP_INT_SIZE == 4 && PHP_VERSION_ID >= 80100 ? 'intval(%s)' : '%s'; } $safeint = '(is_int($temp = %s) ? $temp : (fmod($temp, 0x80000000) & 0x7FFFFFFF) | '; return $safeint . '((fmod(floor($temp / 0x80000000), 2) & 1) << 31))'; } /** * Sets up GCM parameters * * See steps 1-2 of https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf#page=23 * for more info * */ private function setupGCM() { // don't keep on re-calculating $this->h if (!$this->h || $this->hKey != $this->key) { $cipher = new static('ecb'); $cipher->setKey($this->key); $cipher->disablePadding(); $this->h = self::$gcmField->newInteger( Strings::switchEndianness($cipher->encrypt("\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0")) ); $this->hKey = $this->key; } if (strlen($this->nonce) == 12) { $this->iv = $this->nonce . "\0\0\0\1"; } else { $this->iv = $this->ghash( self::nullPad128($this->nonce) . str_repeat("\0", 8) . self::len64($this->nonce) ); } } /** * Performs GHASH operation * * See https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf#page=20 * for more info * * @see self::decrypt() * @see self::encrypt() * @param string $x * @return string */ private function ghash($x) { $h = $this->h; $y = ["\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0"]; $x = str_split($x, 16); $n = 0; // the switchEndianness calls are necessary because the multiplication algorithm in BinaryField/Integer // interprets strings as polynomials in big endian order whereas in GCM they're interpreted in little // endian order per https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf#page=19. // big endian order is what binary field elliptic curves use per http://www.secg.org/sec1-v2.pdf#page=18. // we could switchEndianness here instead of in the while loop but doing so in the while loop seems like it // might be slightly more performant //$x = Strings::switchEndianness($x); foreach ($x as $xn) { $xn = Strings::switchEndianness($xn); $t = $y[$n] ^ $xn; $temp = self::$gcmField->newInteger($t); $y[++$n] = $temp->multiply($h)->toBytes(); $y[$n] = substr($y[$n], 1); } $y[$n] = Strings::switchEndianness($y[$n]); return $y[$n]; } /** * Returns the bit length of a string in a packed format * * @see self::decrypt() * @see self::encrypt() * @see self::setupGCM() * @param string $str * @return string */ private static function len64($str) { return "\0\0\0\0" . pack('N', 8 * strlen($str)); } /** * NULL pads a string to be a multiple of 128 * * @see self::decrypt() * @see self::encrypt() * @see self::setupGCM() * @param string $str * @return string */ protected static function nullPad128($str) { $len = strlen($str); return $str . str_repeat("\0", 16 * ceil($len / 16) - $len); } /** * Calculates Poly1305 MAC * * On my system ChaCha20, with libsodium, takes 0.5s. With this custom Poly1305 implementation * it takes 1.2s. * * @see self::decrypt() * @see self::encrypt() * @param string $text * @return string */ protected function poly1305($text) { $s = $this->poly1305Key; // strlen($this->poly1305Key) == 32 $r = Strings::shift($s, 16); $r = strrev($r); $r &= "\x0f\xff\xff\xfc\x0f\xff\xff\xfc\x0f\xff\xff\xfc\x0f\xff\xff\xff"; $s = strrev($s); $r = self::$poly1305Field->newInteger(new BigInteger($r, 256)); $s = self::$poly1305Field->newInteger(new BigInteger($s, 256)); $a = self::$poly1305Field->newInteger(new BigInteger()); $blocks = str_split($text, 16); foreach ($blocks as $block) { $n = strrev($block . chr(1)); $n = self::$poly1305Field->newInteger(new BigInteger($n, 256)); $a = $a->add($n); $a = $a->multiply($r); } $r = $a->toBigInteger()->add($s->toBigInteger()); $mask = "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF"; return strrev($r->toBytes()) & $mask; } /** * Return the mode * * You can do $obj instanceof AES or whatever to get the cipher but you can't do that to get the mode * * @return string */ public function getMode() { return array_flip(self::MODE_MAP)[$this->mode]; } /** * Is the continuous buffer enabled? * * @return boolean */ public function continuousBufferEnabled() { return $this->continuousBuffer; } } * @author Hans-Juergen Petrich * @copyright 2007 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common; /** * Base Class for all stream cipher classes * * @author Jim Wigginton */ abstract class StreamCipher extends SymmetricKey { /** * Block Length of the cipher * * Stream ciphers do not have a block size * * @see \phpseclib3\Crypt\Common\SymmetricKey::block_size * @var int */ protected $block_size = 0; /** * Default Constructor. * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() * @return \phpseclib3\Crypt\Common\StreamCipher */ public function __construct() { parent::__construct('stream'); } /** * Stream ciphers not use an IV * * @return bool */ public function usesIV() { return false; } } * @copyright 2009 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common; /** * PrivateKey interface * * @author Jim Wigginton */ interface PrivateKey { public function sign($message); //public function decrypt($ciphertext); public function getPublicKey(); public function toString($type, array $options = []); /** * @param string|false $password * @return mixed */ public function withPassword($password = false); } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common\Traits; use phpseclib3\Crypt\Hash; /** * Fingerprint Trait for Private Keys * * @author Jim Wigginton */ trait Fingerprint { /** * Returns the public key's fingerprint * * The public key's fingerprint is returned, which is equivalent to running `ssh-keygen -lf rsa.pub`. If there is * no public key currently loaded, false is returned. * Example output (md5): "c1:b1:30:29:d7:b8:de:6c:97:77:10:d7:46:41:63:87" (as specified by RFC 4716) * * @param string $algorithm The hashing algorithm to be used. Valid options are 'md5' and 'sha256'. False is returned * for invalid values. * @return mixed */ public function getFingerprint($algorithm = 'md5') { $type = self::validatePlugin('Keys', 'OpenSSH', 'savePublicKey'); if ($type === false) { return false; } $key = $this->toString('OpenSSH', ['binary' => true]); if ($key === false) { return false; } switch ($algorithm) { case 'sha256': $hash = new Hash('sha256'); $base = base64_encode($hash->hash($key)); return substr($base, 0, strlen($base) - 1); case 'md5': return substr(chunk_split(md5($key), 2, ':'), 0, -1); default: return false; } } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common\Traits; /** * Password Protected Trait for Private Keys * * @author Jim Wigginton */ trait PasswordProtected { /** * Password * * @var string|bool */ private $password = false; /** * Sets the password * * Private keys can be encrypted with a password. To unset the password, pass in the empty string or false. * Or rather, pass in $password such that empty($password) && !is_string($password) is true. * * @see self::createKey() * @see self::load() * @param string|bool $password */ public function withPassword($password = false) { $new = clone $this; $new->password = $password; return $new; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\AES; use phpseclib3\Crypt\DES; use phpseclib3\Crypt\Random; use phpseclib3\Crypt\TripleDES; use phpseclib3\Exception\UnsupportedAlgorithmException; use phpseclib3\File\ASN1; /** * PKCS1 Formatted Key Handler * * @author Jim Wigginton */ abstract class PKCS1 extends PKCS { /** * Default encryption algorithm * * @var string */ private static $defaultEncryptionAlgorithm = 'AES-128-CBC'; /** * Sets the default encryption algorithm * * @param string $algo */ public static function setEncryptionAlgorithm($algo) { self::$defaultEncryptionAlgorithm = $algo; } /** * Returns the mode constant corresponding to the mode string * * @param string $mode * @return int * @throws \UnexpectedValueException if the block cipher mode is unsupported */ private static function getEncryptionMode($mode) { switch ($mode) { case 'CBC': case 'ECB': case 'CFB': case 'OFB': case 'CTR': return $mode; } throw new \UnexpectedValueException('Unsupported block cipher mode of operation'); } /** * Returns a cipher object corresponding to a string * * @param string $algo * @return string * @throws \UnexpectedValueException if the encryption algorithm is unsupported */ private static function getEncryptionObject($algo) { $modes = '(CBC|ECB|CFB|OFB|CTR)'; switch (true) { case preg_match("#^AES-(128|192|256)-$modes$#", $algo, $matches): $cipher = new AES(self::getEncryptionMode($matches[2])); $cipher->setKeyLength($matches[1]); return $cipher; case preg_match("#^DES-EDE3-$modes$#", $algo, $matches): return new TripleDES(self::getEncryptionMode($matches[1])); case preg_match("#^DES-$modes$#", $algo, $matches): return new DES(self::getEncryptionMode($matches[1])); default: throw new UnsupportedAlgorithmException($algo . ' is not a supported algorithm'); } } /** * Generate a symmetric key for PKCS#1 keys * * @param string $password * @param string $iv * @param int $length * @return string */ private static function generateSymmetricKey($password, $iv, $length) { $symkey = ''; $iv = substr($iv, 0, 8); while (strlen($symkey) < $length) { $symkey .= md5($symkey . $password . $iv, true); } return substr($symkey, 0, $length); } /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ protected static function load($key, $password) { if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } /* Although PKCS#1 proposes a format that public and private keys can use, encrypting them is "outside the scope" of PKCS#1. PKCS#1 then refers you to PKCS#12 and PKCS#15 if you're wanting to protect private keys, however, that's not what OpenSSL* does. OpenSSL protects private keys by adding two new "fields" to the key - DEK-Info and Proc-Type. These fields are discussed here: http://tools.ietf.org/html/rfc1421#section-4.6.1.1 http://tools.ietf.org/html/rfc1421#section-4.6.1.3 DES-EDE3-CBC as an algorithm, however, is not discussed anywhere, near as I can tell. DES-CBC and DES-EDE are discussed in RFC1423, however, DES-EDE3-CBC isn't, nor is its key derivation function. As is, the definitive authority on this encoding scheme isn't the IETF but rather OpenSSL's own implementation. ie. the implementation *is* the standard and any bugs that may exist in that implementation are part of the standard, as well. * OpenSSL is the de facto standard. It's utilized by OpenSSH and other projects */ if (preg_match('#DEK-Info: (.+),(.+)#', $key, $matches)) { $iv = Strings::hex2bin(trim($matches[2])); // remove the Proc-Type / DEK-Info sections as they're no longer needed $key = preg_replace('#^(?:Proc-Type|DEK-Info): .*#m', '', $key); $ciphertext = ASN1::extractBER($key); if ($ciphertext === false) { $ciphertext = $key; } $crypto = self::getEncryptionObject($matches[1]); $crypto->setKey(self::generateSymmetricKey($password, $iv, $crypto->getKeyLength() >> 3)); $crypto->setIV($iv); $key = $crypto->decrypt($ciphertext); } else { if (self::$format != self::MODE_DER) { $decoded = ASN1::extractBER($key); if ($decoded !== false) { $key = $decoded; } elseif (self::$format == self::MODE_PEM) { throw new \UnexpectedValueException('Expected base64-encoded PEM format but was unable to decode base64 text'); } } } return $key; } /** * Wrap a private key appropriately * * @param string $key * @param string $type * @param string $password * @param array $options optional * @return string */ protected static function wrapPrivateKey($key, $type, $password, array $options = []) { if (empty($password) || !is_string($password)) { return "-----BEGIN $type PRIVATE KEY-----\r\n" . chunk_split(Strings::base64_encode($key), 64) . "-----END $type PRIVATE KEY-----"; } $encryptionAlgorithm = isset($options['encryptionAlgorithm']) ? $options['encryptionAlgorithm'] : self::$defaultEncryptionAlgorithm; $cipher = self::getEncryptionObject($encryptionAlgorithm); $iv = Random::string($cipher->getBlockLength() >> 3); $cipher->setKey(self::generateSymmetricKey($password, $iv, $cipher->getKeyLength() >> 3)); $cipher->setIV($iv); $iv = strtoupper(Strings::bin2hex($iv)); return "-----BEGIN $type PRIVATE KEY-----\r\n" . "Proc-Type: 4,ENCRYPTED\r\n" . "DEK-Info: " . $encryptionAlgorithm . ",$iv\r\n" . "\r\n" . chunk_split(Strings::base64_encode($cipher->encrypt($key)), 64) . "-----END $type PRIVATE KEY-----"; } /** * Wrap a public key appropriately * * @param string $key * @param string $type * @return string */ protected static function wrapPublicKey($key, $type) { return "-----BEGIN $type PUBLIC KEY-----\r\n" . chunk_split(Strings::base64_encode($key), 64) . "-----END $type PUBLIC KEY-----"; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\AES; use phpseclib3\Crypt\DES; use phpseclib3\Crypt\Random; use phpseclib3\Crypt\RC2; use phpseclib3\Crypt\RC4; use phpseclib3\Crypt\TripleDES; use phpseclib3\Exception\InsufficientSetupException; use phpseclib3\Exception\UnsupportedAlgorithmException; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps; /** * PKCS#8 Formatted Key Handler * * @author Jim Wigginton */ abstract class PKCS8 extends PKCS { /** * Default encryption algorithm * * @var string */ private static $defaultEncryptionAlgorithm = 'id-PBES2'; /** * Default encryption scheme * * Only used when defaultEncryptionAlgorithm is id-PBES2 * * @var string */ private static $defaultEncryptionScheme = 'aes128-CBC-PAD'; /** * Default PRF * * Only used when defaultEncryptionAlgorithm is id-PBES2 * * @var string */ private static $defaultPRF = 'id-hmacWithSHA256'; /** * Default Iteration Count * * @var int */ private static $defaultIterationCount = 2048; /** * OIDs loaded * * @var bool */ private static $oidsLoaded = false; /** * Sets the default encryption algorithm * * @param string $algo */ public static function setEncryptionAlgorithm($algo) { self::$defaultEncryptionAlgorithm = $algo; } /** * Sets the default encryption algorithm for PBES2 * * @param string $algo */ public static function setEncryptionScheme($algo) { self::$defaultEncryptionScheme = $algo; } /** * Sets the iteration count * * @param int $count */ public static function setIterationCount($count) { self::$defaultIterationCount = $count; } /** * Sets the PRF for PBES2 * * @param string $algo */ public static function setPRF($algo) { self::$defaultPRF = $algo; } /** * Returns a SymmetricKey object based on a PBES1 $algo * * @return \phpseclib3\Crypt\Common\SymmetricKey * @param string $algo */ private static function getPBES1EncryptionObject($algo) { $algo = preg_match('#^pbeWith(?:MD2|MD5|SHA1|SHA)And(.*?)-CBC$#', $algo, $matches) ? $matches[1] : substr($algo, 13); // strlen('pbeWithSHAAnd') == 13 switch ($algo) { case 'DES': $cipher = new DES('cbc'); break; case 'RC2': $cipher = new RC2('cbc'); break; case '3-KeyTripleDES': $cipher = new TripleDES('cbc'); break; case '2-KeyTripleDES': $cipher = new TripleDES('cbc'); $cipher->setKeyLength(128); break; case '128BitRC2': $cipher = new RC2('cbc'); $cipher->setKeyLength(128); break; case '40BitRC2': $cipher = new RC2('cbc'); $cipher->setKeyLength(40); break; case '128BitRC4': $cipher = new RC4(); $cipher->setKeyLength(128); break; case '40BitRC4': $cipher = new RC4(); $cipher->setKeyLength(40); break; default: throw new UnsupportedAlgorithmException("$algo is not a supported algorithm"); } return $cipher; } /** * Returns a hash based on a PBES1 $algo * * @return string * @param string $algo */ private static function getPBES1Hash($algo) { if (preg_match('#^pbeWith(MD2|MD5|SHA1|SHA)And.*?-CBC$#', $algo, $matches)) { return $matches[1] == 'SHA' ? 'sha1' : $matches[1]; } return 'sha1'; } /** * Returns a KDF baesd on a PBES1 $algo * * @return string * @param string $algo */ private static function getPBES1KDF($algo) { switch ($algo) { case 'pbeWithMD2AndDES-CBC': case 'pbeWithMD2AndRC2-CBC': case 'pbeWithMD5AndDES-CBC': case 'pbeWithMD5AndRC2-CBC': case 'pbeWithSHA1AndDES-CBC': case 'pbeWithSHA1AndRC2-CBC': return 'pbkdf1'; } return 'pkcs12'; } /** * Returns a SymmetricKey object baesd on a PBES2 $algo * * @return SymmetricKey * @param string $algo */ private static function getPBES2EncryptionObject($algo) { switch ($algo) { case 'desCBC': $cipher = new TripleDES('cbc'); break; case 'des-EDE3-CBC': $cipher = new TripleDES('cbc'); break; case 'rc2CBC': $cipher = new RC2('cbc'); // in theory this can be changed $cipher->setKeyLength(128); break; case 'rc5-CBC-PAD': throw new UnsupportedAlgorithmException('rc5-CBC-PAD is not supported for PBES2 PKCS#8 keys'); case 'aes128-CBC-PAD': case 'aes192-CBC-PAD': case 'aes256-CBC-PAD': $cipher = new AES('cbc'); $cipher->setKeyLength(substr($algo, 3, 3)); break; default: throw new UnsupportedAlgorithmException("$algo is not supported"); } return $cipher; } /** * Initialize static variables * */ private static function initialize_static_variables() { if (!isset(static::$childOIDsLoaded)) { throw new InsufficientSetupException('This class should not be called directly'); } if (!static::$childOIDsLoaded) { ASN1::loadOIDs(is_array(static::OID_NAME) ? array_combine(static::OID_NAME, static::OID_VALUE) : [static::OID_NAME => static::OID_VALUE]); static::$childOIDsLoaded = true; } if (!self::$oidsLoaded) { // from https://tools.ietf.org/html/rfc2898 ASN1::loadOIDs([ // PBES1 encryption schemes 'pbeWithMD2AndDES-CBC' => '1.2.840.113549.1.5.1', 'pbeWithMD2AndRC2-CBC' => '1.2.840.113549.1.5.4', 'pbeWithMD5AndDES-CBC' => '1.2.840.113549.1.5.3', 'pbeWithMD5AndRC2-CBC' => '1.2.840.113549.1.5.6', 'pbeWithSHA1AndDES-CBC' => '1.2.840.113549.1.5.10', 'pbeWithSHA1AndRC2-CBC' => '1.2.840.113549.1.5.11', // from PKCS#12: // https://tools.ietf.org/html/rfc7292 'pbeWithSHAAnd128BitRC4' => '1.2.840.113549.1.12.1.1', 'pbeWithSHAAnd40BitRC4' => '1.2.840.113549.1.12.1.2', 'pbeWithSHAAnd3-KeyTripleDES-CBC' => '1.2.840.113549.1.12.1.3', 'pbeWithSHAAnd2-KeyTripleDES-CBC' => '1.2.840.113549.1.12.1.4', 'pbeWithSHAAnd128BitRC2-CBC' => '1.2.840.113549.1.12.1.5', 'pbeWithSHAAnd40BitRC2-CBC' => '1.2.840.113549.1.12.1.6', 'id-PBKDF2' => '1.2.840.113549.1.5.12', 'id-PBES2' => '1.2.840.113549.1.5.13', 'id-PBMAC1' => '1.2.840.113549.1.5.14', // from PKCS#5 v2.1: // http://www.rsa.com/rsalabs/pkcs/files/h11302-wp-pkcs5v2-1-password-based-cryptography-standard.pdf 'id-hmacWithSHA1' => '1.2.840.113549.2.7', 'id-hmacWithSHA224' => '1.2.840.113549.2.8', 'id-hmacWithSHA256' => '1.2.840.113549.2.9', 'id-hmacWithSHA384' => '1.2.840.113549.2.10', 'id-hmacWithSHA512' => '1.2.840.113549.2.11', 'id-hmacWithSHA512-224' => '1.2.840.113549.2.12', 'id-hmacWithSHA512-256' => '1.2.840.113549.2.13', 'desCBC' => '1.3.14.3.2.7', 'des-EDE3-CBC' => '1.2.840.113549.3.7', 'rc2CBC' => '1.2.840.113549.3.2', 'rc5-CBC-PAD' => '1.2.840.113549.3.9', 'aes128-CBC-PAD' => '2.16.840.1.101.3.4.1.2', 'aes192-CBC-PAD' => '2.16.840.1.101.3.4.1.22', 'aes256-CBC-PAD' => '2.16.840.1.101.3.4.1.42' ]); self::$oidsLoaded = true; } } /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ protected static function load($key, $password = '') { $decoded = self::preParse($key); $meta = []; $decrypted = ASN1::asn1map($decoded[0], Maps\EncryptedPrivateKeyInfo::MAP); if (strlen($password) && is_array($decrypted)) { $algorithm = $decrypted['encryptionAlgorithm']['algorithm']; switch ($algorithm) { // PBES1 case 'pbeWithMD2AndDES-CBC': case 'pbeWithMD2AndRC2-CBC': case 'pbeWithMD5AndDES-CBC': case 'pbeWithMD5AndRC2-CBC': case 'pbeWithSHA1AndDES-CBC': case 'pbeWithSHA1AndRC2-CBC': case 'pbeWithSHAAnd3-KeyTripleDES-CBC': case 'pbeWithSHAAnd2-KeyTripleDES-CBC': case 'pbeWithSHAAnd128BitRC2-CBC': case 'pbeWithSHAAnd40BitRC2-CBC': case 'pbeWithSHAAnd128BitRC4': case 'pbeWithSHAAnd40BitRC4': $cipher = self::getPBES1EncryptionObject($algorithm); $hash = self::getPBES1Hash($algorithm); $kdf = self::getPBES1KDF($algorithm); $meta['meta']['algorithm'] = $algorithm; $temp = ASN1::decodeBER($decrypted['encryptionAlgorithm']['parameters']); if (!$temp) { throw new \RuntimeException('Unable to decode BER'); } extract(ASN1::asn1map($temp[0], Maps\PBEParameter::MAP)); $iterationCount = (int) $iterationCount->toString(); $cipher->setPassword($password, $kdf, $hash, $salt, $iterationCount); $key = $cipher->decrypt($decrypted['encryptedData']); $decoded = ASN1::decodeBER($key); if (!$decoded) { throw new \RuntimeException('Unable to decode BER 2'); } break; case 'id-PBES2': $meta['meta']['algorithm'] = $algorithm; $temp = ASN1::decodeBER($decrypted['encryptionAlgorithm']['parameters']); if (!$temp) { throw new \RuntimeException('Unable to decode BER'); } $temp = ASN1::asn1map($temp[0], Maps\PBES2params::MAP); extract($temp); $cipher = self::getPBES2EncryptionObject($encryptionScheme['algorithm']); $meta['meta']['cipher'] = $encryptionScheme['algorithm']; $temp = ASN1::decodeBER($decrypted['encryptionAlgorithm']['parameters']); if (!$temp) { throw new \RuntimeException('Unable to decode BER'); } $temp = ASN1::asn1map($temp[0], Maps\PBES2params::MAP); extract($temp); if (!$cipher instanceof RC2) { $cipher->setIV($encryptionScheme['parameters']['octetString']); } else { $temp = ASN1::decodeBER($encryptionScheme['parameters']); if (!$temp) { throw new \RuntimeException('Unable to decode BER'); } extract(ASN1::asn1map($temp[0], Maps\RC2CBCParameter::MAP)); $effectiveKeyLength = (int) $rc2ParametersVersion->toString(); switch ($effectiveKeyLength) { case 160: $effectiveKeyLength = 40; break; case 120: $effectiveKeyLength = 64; break; case 58: $effectiveKeyLength = 128; break; //default: // should be >= 256 } $cipher->setIV($iv); $cipher->setKeyLength($effectiveKeyLength); } $meta['meta']['keyDerivationFunc'] = $keyDerivationFunc['algorithm']; switch ($keyDerivationFunc['algorithm']) { case 'id-PBKDF2': $temp = ASN1::decodeBER($keyDerivationFunc['parameters']); if (!$temp) { throw new \RuntimeException('Unable to decode BER'); } $prf = ['algorithm' => 'id-hmacWithSHA1']; $params = ASN1::asn1map($temp[0], Maps\PBKDF2params::MAP); extract($params); $meta['meta']['prf'] = $prf['algorithm']; $hash = str_replace('-', '/', substr($prf['algorithm'], 11)); $params = [ $password, 'pbkdf2', $hash, $salt, (int) $iterationCount->toString() ]; if (isset($keyLength)) { $params[] = (int) $keyLength->toString(); } $cipher->setPassword(...$params); $key = $cipher->decrypt($decrypted['encryptedData']); $decoded = ASN1::decodeBER($key); if (!$decoded) { throw new \RuntimeException('Unable to decode BER 3'); } break; default: throw new UnsupportedAlgorithmException('Only PBKDF2 is supported for PBES2 PKCS#8 keys'); } break; case 'id-PBMAC1': //$temp = ASN1::decodeBER($decrypted['encryptionAlgorithm']['parameters']); //$value = ASN1::asn1map($temp[0], Maps\PBMAC1params::MAP); // since i can't find any implementation that does PBMAC1 it is unsupported throw new UnsupportedAlgorithmException('Only PBES1 and PBES2 PKCS#8 keys are supported.'); // at this point we'll assume that the key conforms to PublicKeyInfo } } $private = ASN1::asn1map($decoded[0], Maps\OneAsymmetricKey::MAP); if (is_array($private)) { if (isset($private['privateKeyAlgorithm']['parameters']) && !$private['privateKeyAlgorithm']['parameters'] instanceof ASN1\Element && isset($decoded[0]['content'][1]['content'][1])) { $temp = $decoded[0]['content'][1]['content'][1]; $private['privateKeyAlgorithm']['parameters'] = new ASN1\Element(substr($key, $temp['start'], $temp['length'])); } if (is_array(static::OID_NAME)) { if (!in_array($private['privateKeyAlgorithm']['algorithm'], static::OID_NAME)) { throw new UnsupportedAlgorithmException($private['privateKeyAlgorithm']['algorithm'] . ' is not a supported key type'); } } else { if ($private['privateKeyAlgorithm']['algorithm'] != static::OID_NAME) { throw new UnsupportedAlgorithmException('Only ' . static::OID_NAME . ' keys are supported; this is a ' . $private['privateKeyAlgorithm']['algorithm'] . ' key'); } } if (isset($private['publicKey'])) { if ($private['publicKey'][0] != "\0") { throw new \UnexpectedValueException('The first byte of the public key should be null - not ' . bin2hex($private['publicKey'][0])); } $private['publicKey'] = substr($private['publicKey'], 1); } return $private + $meta; } // EncryptedPrivateKeyInfo and PublicKeyInfo have largely identical "signatures". the only difference // is that the former has an octet string and the later has a bit string. the first byte of a bit // string represents the number of bits in the last byte that are to be ignored but, currently, // bit strings wanting a non-zero amount of bits trimmed are not supported $public = ASN1::asn1map($decoded[0], Maps\PublicKeyInfo::MAP); if (is_array($public)) { if ($public['publicKey'][0] != "\0") { throw new \UnexpectedValueException('The first byte of the public key should be null - not ' . bin2hex($public['publicKey'][0])); } if (is_array(static::OID_NAME)) { if (!in_array($public['publicKeyAlgorithm']['algorithm'], static::OID_NAME)) { throw new UnsupportedAlgorithmException($public['publicKeyAlgorithm']['algorithm'] . ' is not a supported key type'); } } else { if ($public['publicKeyAlgorithm']['algorithm'] != static::OID_NAME) { throw new UnsupportedAlgorithmException('Only ' . static::OID_NAME . ' keys are supported; this is a ' . $public['publicKeyAlgorithm']['algorithm'] . ' key'); } } if (isset($public['publicKeyAlgorithm']['parameters']) && !$public['publicKeyAlgorithm']['parameters'] instanceof ASN1\Element && isset($decoded[0]['content'][0]['content'][1])) { $temp = $decoded[0]['content'][0]['content'][1]; $public['publicKeyAlgorithm']['parameters'] = new ASN1\Element(substr($key, $temp['start'], $temp['length'])); } $public['publicKey'] = substr($public['publicKey'], 1); return $public; } throw new \RuntimeException('Unable to parse using either OneAsymmetricKey or PublicKeyInfo ASN1 maps'); } /** * Wrap a private key appropriately * * @param string $key * @param string $attr * @param mixed $params * @param string $password * @param string $oid optional * @param string $publicKey optional * @param array $options optional * @return string */ protected static function wrapPrivateKey($key, $attr, $params, $password, $oid = null, $publicKey = '', array $options = []) { self::initialize_static_variables(); $key = [ 'version' => 'v1', 'privateKeyAlgorithm' => [ 'algorithm' => is_string(static::OID_NAME) ? static::OID_NAME : $oid ], 'privateKey' => $key ]; if ($oid != 'id-Ed25519' && $oid != 'id-Ed448') { $key['privateKeyAlgorithm']['parameters'] = $params; } if (!empty($attr)) { $key['attributes'] = $attr; } if (!empty($publicKey)) { $key['version'] = 'v2'; $key['publicKey'] = $publicKey; } $key = ASN1::encodeDER($key, Maps\OneAsymmetricKey::MAP); if (!empty($password) && is_string($password)) { $salt = Random::string(8); $iterationCount = isset($options['iterationCount']) ? $options['iterationCount'] : self::$defaultIterationCount; $encryptionAlgorithm = isset($options['encryptionAlgorithm']) ? $options['encryptionAlgorithm'] : self::$defaultEncryptionAlgorithm; $encryptionScheme = isset($options['encryptionScheme']) ? $options['encryptionScheme'] : self::$defaultEncryptionScheme; $prf = isset($options['PRF']) ? $options['PRF'] : self::$defaultPRF; if ($encryptionAlgorithm == 'id-PBES2') { $crypto = self::getPBES2EncryptionObject($encryptionScheme); $hash = str_replace('-', '/', substr($prf, 11)); $kdf = 'pbkdf2'; $iv = Random::string($crypto->getBlockLength() >> 3); $PBKDF2params = [ 'salt' => $salt, 'iterationCount' => $iterationCount, 'prf' => ['algorithm' => $prf, 'parameters' => null] ]; $PBKDF2params = ASN1::encodeDER($PBKDF2params, Maps\PBKDF2params::MAP); if (!$crypto instanceof RC2) { $params = ['octetString' => $iv]; } else { $params = [ 'rc2ParametersVersion' => 58, 'iv' => $iv ]; $params = ASN1::encodeDER($params, Maps\RC2CBCParameter::MAP); $params = new ASN1\Element($params); } $params = [ 'keyDerivationFunc' => [ 'algorithm' => 'id-PBKDF2', 'parameters' => new ASN1\Element($PBKDF2params) ], 'encryptionScheme' => [ 'algorithm' => $encryptionScheme, 'parameters' => $params ] ]; $params = ASN1::encodeDER($params, Maps\PBES2params::MAP); $crypto->setIV($iv); } else { $crypto = self::getPBES1EncryptionObject($encryptionAlgorithm); $hash = self::getPBES1Hash($encryptionAlgorithm); $kdf = self::getPBES1KDF($encryptionAlgorithm); $params = [ 'salt' => $salt, 'iterationCount' => $iterationCount ]; $params = ASN1::encodeDER($params, Maps\PBEParameter::MAP); } $crypto->setPassword($password, $kdf, $hash, $salt, $iterationCount); $key = $crypto->encrypt($key); $key = [ 'encryptionAlgorithm' => [ 'algorithm' => $encryptionAlgorithm, 'parameters' => new ASN1\Element($params) ], 'encryptedData' => $key ]; $key = ASN1::encodeDER($key, Maps\EncryptedPrivateKeyInfo::MAP); return "-----BEGIN ENCRYPTED PRIVATE KEY-----\r\n" . chunk_split(Strings::base64_encode($key), 64) . "-----END ENCRYPTED PRIVATE KEY-----"; } return "-----BEGIN PRIVATE KEY-----\r\n" . chunk_split(Strings::base64_encode($key), 64) . "-----END PRIVATE KEY-----"; } /** * Wrap a public key appropriately * * @param string $key * @param mixed $params * @param string $oid * @return string */ protected static function wrapPublicKey($key, $params, $oid = null) { self::initialize_static_variables(); $key = [ 'publicKeyAlgorithm' => [ 'algorithm' => is_string(static::OID_NAME) ? static::OID_NAME : $oid ], 'publicKey' => "\0" . $key ]; if ($oid != 'id-Ed25519' && $oid != 'id-Ed448') { $key['publicKeyAlgorithm']['parameters'] = $params; } $key = ASN1::encodeDER($key, Maps\PublicKeyInfo::MAP); return "-----BEGIN PUBLIC KEY-----\r\n" . chunk_split(Strings::base64_encode($key), 64) . "-----END PUBLIC KEY-----"; } /** * Perform some preliminary parsing of the key * * @param string $key * @return array */ private static function preParse(&$key) { self::initialize_static_variables(); if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } if (self::$format != self::MODE_DER) { $decoded = ASN1::extractBER($key); if ($decoded !== false) { $key = $decoded; } elseif (self::$format == self::MODE_PEM) { throw new \UnexpectedValueException('Expected base64-encoded PEM format but was unable to decode base64 text'); } } $decoded = ASN1::decodeBER($key); if (!$decoded) { throw new \RuntimeException('Unable to decode BER'); } return $decoded; } /** * Returns the encryption parameters used by the key * * @param string $key * @return array */ public static function extractEncryptionAlgorithm($key) { $decoded = self::preParse($key); $r = ASN1::asn1map($decoded[0], ASN1\Maps\EncryptedPrivateKeyInfo::MAP); if (!is_array($r)) { throw new \RuntimeException('Unable to parse using EncryptedPrivateKeyInfo map'); } if ($r['encryptionAlgorithm']['algorithm'] == 'id-PBES2') { $decoded = ASN1::decodeBER($r['encryptionAlgorithm']['parameters']->element); if (!$decoded) { throw new \RuntimeException('Unable to decode BER'); } $r['encryptionAlgorithm']['parameters'] = ASN1::asn1map($decoded[0], ASN1\Maps\PBES2params::MAP); $kdf = &$r['encryptionAlgorithm']['parameters']['keyDerivationFunc']; switch ($kdf['algorithm']) { case 'id-PBKDF2': $decoded = ASN1::decodeBER($kdf['parameters']->element); if (!$decoded) { throw new \RuntimeException('Unable to decode BER'); } $kdf['parameters'] = ASN1::asn1map($decoded[0], Maps\PBKDF2params::MAP); } } return $r['encryptionAlgorithm']; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common\Formats\Keys; use phpseclib3\Common\Functions\Strings; /** * JSON Web Key Formatted Key Handler * * @author Jim Wigginton */ abstract class JWK { /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password * @return array */ public static function load($key, $password = '') { if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } $key = preg_replace('#\s#', '', $key); // remove whitespace if (PHP_VERSION_ID >= 73000) { $key = json_decode($key, null, 512, JSON_THROW_ON_ERROR); } else { $key = json_decode($key); if (!$key) { throw new \RuntimeException('Unable to decode JSON'); } } if (isset($key->kty)) { return $key; } if (count($key->keys) != 1) { throw new \RuntimeException('Although the JWK key format supports multiple keys phpseclib does not'); } return $key->keys[0]; } /** * Wrap a key appropriately * * @return string */ protected static function wrapKey(array $key, array $options) { return json_encode(['keys' => [$key + $options]]); } } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\AES; use phpseclib3\Crypt\Hash; use phpseclib3\Crypt\Random; use phpseclib3\Exception\UnsupportedAlgorithmException; /** * PuTTY Formatted Key Handler * * @author Jim Wigginton */ abstract class PuTTY { /** * Default comment * * @var string */ private static $comment = 'phpseclib-generated-key'; /** * Default version * * @var int */ private static $version = 2; /** * Sets the default comment * * @param string $comment */ public static function setComment($comment) { self::$comment = str_replace(["\r", "\n"], '', $comment); } /** * Sets the default version * * @param int $version */ public static function setVersion($version) { if ($version != 2 && $version != 3) { throw new \RuntimeException('Only supported versions are 2 and 3'); } self::$version = $version; } /** * Generate a symmetric key for PuTTY v2 keys * * @param string $password * @param int $length * @return string */ private static function generateV2Key($password, $length) { $symkey = ''; $sequence = 0; while (strlen($symkey) < $length) { $temp = pack('Na*', $sequence++, $password); $symkey .= Strings::hex2bin(sha1($temp)); } return substr($symkey, 0, $length); } /** * Generate a symmetric key for PuTTY v3 keys * * @param string $password * @param string $flavour * @param int $memory * @param int $passes * @param string $salt * @return array */ private static function generateV3Key($password, $flavour, $memory, $passes, $salt) { if (!function_exists('sodium_crypto_pwhash')) { throw new \RuntimeException('sodium_crypto_pwhash needs to exist for Argon2 password hasing'); } switch ($flavour) { case 'Argon2i': $flavour = SODIUM_CRYPTO_PWHASH_ALG_ARGON2I13; break; case 'Argon2id': $flavour = SODIUM_CRYPTO_PWHASH_ALG_ARGON2ID13; break; default: throw new UnsupportedAlgorithmException('Only Argon2i and Argon2id are supported'); } $length = 80; // keylen + ivlen + mac_keylen $temp = sodium_crypto_pwhash($length, $password, $salt, $passes, $memory << 10, $flavour); $symkey = substr($temp, 0, 32); $symiv = substr($temp, 32, 16); $hashkey = substr($temp, -32); return compact('symkey', 'symiv', 'hashkey'); } /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password * @return array */ public static function load($key, $password) { if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } if (strpos($key, 'BEGIN SSH2 PUBLIC KEY') !== false) { $lines = preg_split('#[\r\n]+#', $key); switch (true) { case $lines[0] != '---- BEGIN SSH2 PUBLIC KEY ----': throw new \UnexpectedValueException('Key doesn\'t start with ---- BEGIN SSH2 PUBLIC KEY ----'); case $lines[count($lines) - 1] != '---- END SSH2 PUBLIC KEY ----': throw new \UnexpectedValueException('Key doesn\'t end with ---- END SSH2 PUBLIC KEY ----'); } $lines = array_splice($lines, 1, -1); $lines = array_map(function ($line) { return rtrim($line, "\r\n"); }, $lines); $data = $current = ''; $values = []; $in_value = false; foreach ($lines as $line) { switch (true) { case preg_match('#^(.*?): (.*)#', $line, $match): $in_value = $line[strlen($line) - 1] == '\\'; $current = strtolower($match[1]); $values[$current] = $in_value ? substr($match[2], 0, -1) : $match[2]; break; case $in_value: $in_value = $line[strlen($line) - 1] == '\\'; $values[$current] .= $in_value ? substr($line, 0, -1) : $line; break; default: $data .= $line; } } $components = call_user_func([static::PUBLIC_HANDLER, 'load'], $data); if ($components === false) { throw new \UnexpectedValueException('Unable to decode public key'); } $components += $values; $components['comment'] = str_replace(['\\\\', '\"'], ['\\', '"'], $values['comment']); return $components; } $components = []; $key = preg_split('#\r\n|\r|\n#', trim($key)); if (Strings::shift($key[0], strlen('PuTTY-User-Key-File-')) != 'PuTTY-User-Key-File-') { return false; } $version = (int) Strings::shift($key[0], 3); // should be either "2: " or "3: 0" prior to int casting if ($version != 2 && $version != 3) { throw new \RuntimeException('Only v2 and v3 PuTTY private keys are supported'); } $components['type'] = $type = rtrim($key[0]); if (!in_array($type, static::$types)) { $error = count(static::$types) == 1 ? 'Only ' . static::$types[0] . ' keys are supported. ' : ''; throw new UnsupportedAlgorithmException($error . 'This is an unsupported ' . $type . ' key'); } $encryption = trim(preg_replace('#Encryption: (.+)#', '$1', $key[1])); $components['comment'] = trim(preg_replace('#Comment: (.+)#', '$1', $key[2])); $publicLength = trim(preg_replace('#Public-Lines: (\d+)#', '$1', $key[3])); $public = Strings::base64_decode(implode('', array_map('trim', array_slice($key, 4, $publicLength)))); $source = Strings::packSSH2('ssss', $type, $encryption, $components['comment'], $public); extract(unpack('Nlength', Strings::shift($public, 4))); $newtype = Strings::shift($public, $length); if ($newtype != $type) { throw new \RuntimeException('The binary type does not match the human readable type field'); } $components['public'] = $public; switch ($version) { case 3: $hashkey = ''; break; case 2: $hashkey = 'putty-private-key-file-mac-key'; } $offset = $publicLength + 4; switch ($encryption) { case 'aes256-cbc': $crypto = new AES('cbc'); switch ($version) { case 3: $flavour = trim(preg_replace('#Key-Derivation: (.*)#', '$1', $key[$offset++])); $memory = trim(preg_replace('#Argon2-Memory: (\d+)#', '$1', $key[$offset++])); $passes = trim(preg_replace('#Argon2-Passes: (\d+)#', '$1', $key[$offset++])); $parallelism = trim(preg_replace('#Argon2-Parallelism: (\d+)#', '$1', $key[$offset++])); $salt = Strings::hex2bin(trim(preg_replace('#Argon2-Salt: ([0-9a-f]+)#', '$1', $key[$offset++]))); extract(self::generateV3Key($password, $flavour, $memory, $passes, $salt)); break; case 2: $symkey = self::generateV2Key($password, 32); $symiv = str_repeat("\0", $crypto->getBlockLength() >> 3); $hashkey .= $password; } } switch ($version) { case 3: $hash = new Hash('sha256'); $hash->setKey($hashkey); break; case 2: $hash = new Hash('sha1'); $hash->setKey(sha1($hashkey, true)); } $privateLength = trim(preg_replace('#Private-Lines: (\d+)#', '$1', $key[$offset++])); $private = Strings::base64_decode(implode('', array_map('trim', array_slice($key, $offset, $privateLength)))); if ($encryption != 'none') { $crypto->setKey($symkey); $crypto->setIV($symiv); $crypto->disablePadding(); $private = $crypto->decrypt($private); } $source .= Strings::packSSH2('s', $private); $hmac = trim(preg_replace('#Private-MAC: (.+)#', '$1', $key[$offset + $privateLength])); $hmac = Strings::hex2bin($hmac); if (!hash_equals($hash->hash($source), $hmac)) { throw new \UnexpectedValueException('MAC validation error'); } $components['private'] = $private; return $components; } /** * Wrap a private key appropriately * * @param string $public * @param string $private * @param string $type * @param string $password * @param array $options optional * @return string */ protected static function wrapPrivateKey($public, $private, $type, $password, array $options = []) { $encryption = (!empty($password) || is_string($password)) ? 'aes256-cbc' : 'none'; $comment = isset($options['comment']) ? $options['comment'] : self::$comment; $version = isset($options['version']) ? $options['version'] : self::$version; $key = "PuTTY-User-Key-File-$version: $type\r\n"; $key .= "Encryption: $encryption\r\n"; $key .= "Comment: $comment\r\n"; $public = Strings::packSSH2('s', $type) . $public; $source = Strings::packSSH2('ssss', $type, $encryption, $comment, $public); $public = Strings::base64_encode($public); $key .= "Public-Lines: " . ((strlen($public) + 63) >> 6) . "\r\n"; $key .= chunk_split($public, 64); if (empty($password) && !is_string($password)) { $source .= Strings::packSSH2('s', $private); switch ($version) { case 3: $hash = new Hash('sha256'); $hash->setKey(''); break; case 2: $hash = new Hash('sha1'); $hash->setKey(sha1('putty-private-key-file-mac-key', true)); } } else { $private .= Random::string(16 - (strlen($private) & 15)); $source .= Strings::packSSH2('s', $private); $crypto = new AES('cbc'); switch ($version) { case 3: $salt = Random::string(16); $key .= "Key-Derivation: Argon2id\r\n"; $key .= "Argon2-Memory: 8192\r\n"; $key .= "Argon2-Passes: 13\r\n"; $key .= "Argon2-Parallelism: 1\r\n"; $key .= "Argon2-Salt: " . Strings::bin2hex($salt) . "\r\n"; extract(self::generateV3Key($password, 'Argon2id', 8192, 13, $salt)); $hash = new Hash('sha256'); $hash->setKey($hashkey); break; case 2: $symkey = self::generateV2Key($password, 32); $symiv = str_repeat("\0", $crypto->getBlockLength() >> 3); $hashkey = 'putty-private-key-file-mac-key' . $password; $hash = new Hash('sha1'); $hash->setKey(sha1($hashkey, true)); } $crypto->setKey($symkey); $crypto->setIV($symiv); $crypto->disablePadding(); $private = $crypto->encrypt($private); $mac = $hash->hash($source); } $private = Strings::base64_encode($private); $key .= 'Private-Lines: ' . ((strlen($private) + 63) >> 6) . "\r\n"; $key .= chunk_split($private, 64); $key .= 'Private-MAC: ' . Strings::bin2hex($hash->hash($source)) . "\r\n"; return $key; } /** * Wrap a public key appropriately * * This is basically the format described in RFC 4716 (https://tools.ietf.org/html/rfc4716) * * @param string $key * @param string $type * @return string */ protected static function wrapPublicKey($key, $type) { $key = pack('Na*a*', strlen($type), $type, $key); $key = "---- BEGIN SSH2 PUBLIC KEY ----\r\n" . 'Comment: "' . str_replace(['\\', '"'], ['\\\\', '\"'], self::$comment) . "\"\r\n" . chunk_split(Strings::base64_encode($key), 64) . '---- END SSH2 PUBLIC KEY ----'; return $key; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common\Formats\Keys; /** * PKCS1 Formatted Key Handler * * @author Jim Wigginton */ abstract class PKCS { /** * Auto-detect the format */ const MODE_ANY = 0; /** * Require base64-encoded PEM's be supplied */ const MODE_PEM = 1; /** * Require raw DER's be supplied */ const MODE_DER = 2; /**#@-*/ /** * Is the key a base-64 encoded PEM, DER or should it be auto-detected? * * @var int */ protected static $format = self::MODE_ANY; /** * Require base64-encoded PEM's be supplied * */ public static function requirePEM() { self::$format = self::MODE_PEM; } /** * Require raw DER's be supplied * */ public static function requireDER() { self::$format = self::MODE_DER; } /** * Accept any format and auto detect the format * * This is the default setting * */ public static function requireAny() { self::$format = self::MODE_ANY; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\AES; use phpseclib3\Crypt\Random; /** * OpenSSH Formatted RSA Key Handler * * @author Jim Wigginton */ abstract class OpenSSH { /** * Default comment * * @var string */ protected static $comment = 'phpseclib-generated-key'; /** * Binary key flag * * @var bool */ protected static $binary = false; /** * Sets the default comment * * @param string $comment */ public static function setComment($comment) { self::$comment = str_replace(["\r", "\n"], '', $comment); } /** * Break a public or private key down into its constituent components * * $type can be either ssh-dss or ssh-rsa * * @param string $key * @param string $password * @return array */ public static function load($key, $password = '') { if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } // key format is described here: // https://cvsweb.openbsd.org/cgi-bin/cvsweb/src/usr.bin/ssh/PROTOCOL.key?annotate=HEAD if (strpos($key, 'BEGIN OPENSSH PRIVATE KEY') !== false) { $key = preg_replace('#(?:^-.*?-[\r\n]*$)|\s#ms', '', $key); $key = Strings::base64_decode($key); $magic = Strings::shift($key, 15); if ($magic != "openssh-key-v1\0") { throw new \RuntimeException('Expected openssh-key-v1'); } list($ciphername, $kdfname, $kdfoptions, $numKeys) = Strings::unpackSSH2('sssN', $key); if ($numKeys != 1) { // if we wanted to support multiple keys we could update PublicKeyLoader to preview what the # of keys // would be; it'd then call Common\Keys\OpenSSH.php::load() and get the paddedKey. it'd then pass // that to the appropriate key loading parser $numKey times or something throw new \RuntimeException('Although the OpenSSH private key format supports multiple keys phpseclib does not'); } switch ($ciphername) { case 'none': break; case 'aes256-ctr': if ($kdfname != 'bcrypt') { throw new \RuntimeException('Only the bcrypt kdf is supported (' . $kdfname . ' encountered)'); } list($salt, $rounds) = Strings::unpackSSH2('sN', $kdfoptions); $crypto = new AES('ctr'); //$crypto->setKeyLength(256); //$crypto->disablePadding(); $crypto->setPassword($password, 'bcrypt', $salt, $rounds, 32); break; default: throw new \RuntimeException('The only supported cipherse are: none, aes256-ctr (' . $ciphername . ' is being used)'); } list($publicKey, $paddedKey) = Strings::unpackSSH2('ss', $key); list($type) = Strings::unpackSSH2('s', $publicKey); if (isset($crypto)) { $paddedKey = $crypto->decrypt($paddedKey); } list($checkint1, $checkint2) = Strings::unpackSSH2('NN', $paddedKey); // any leftover bytes in $paddedKey are for padding? but they should be sequential bytes. eg. 1, 2, 3, etc. if ($checkint1 != $checkint2) { throw new \RuntimeException('The two checkints do not match'); } self::checkType($type); return compact('type', 'publicKey', 'paddedKey'); } $parts = explode(' ', $key, 3); if (!isset($parts[1])) { $key = base64_decode($parts[0]); $comment = false; } else { $asciiType = $parts[0]; self::checkType($parts[0]); $key = base64_decode($parts[1]); $comment = isset($parts[2]) ? $parts[2] : false; } if ($key === false) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } list($type) = Strings::unpackSSH2('s', $key); self::checkType($type); if (isset($asciiType) && $asciiType != $type) { throw new \RuntimeException('Two different types of keys are claimed: ' . $asciiType . ' and ' . $type); } if (strlen($key) <= 4) { throw new \UnexpectedValueException('Key appears to be malformed'); } $publicKey = $key; return compact('type', 'publicKey', 'comment'); } /** * Toggle between binary and printable keys * * Printable keys are what are generated by default. These are the ones that go in * $HOME/.ssh/authorized_key. * * @param bool $enabled */ public static function setBinaryOutput($enabled) { self::$binary = $enabled; } /** * Checks to see if the type is valid * * @param string $candidate */ private static function checkType($candidate) { if (!in_array($candidate, static::$types)) { throw new \RuntimeException("The key type ($candidate) is not equal to: " . implode(',', static::$types)); } } /** * Wrap a private key appropriately * * @param string $publicKey * @param string $privateKey * @param string $password * @param array $options * @return string */ protected static function wrapPrivateKey($publicKey, $privateKey, $password, $options) { list(, $checkint) = unpack('N', Random::string(4)); $comment = isset($options['comment']) ? $options['comment'] : self::$comment; $paddedKey = Strings::packSSH2('NN', $checkint, $checkint) . $privateKey . Strings::packSSH2('s', $comment); $usesEncryption = !empty($password) && is_string($password); /* from http://tools.ietf.org/html/rfc4253#section-6 : Note that the length of the concatenation of 'packet_length', 'padding_length', 'payload', and 'random padding' MUST be a multiple of the cipher block size or 8, whichever is larger. */ $blockSize = $usesEncryption ? 16 : 8; $paddingLength = (($blockSize - 1) * strlen($paddedKey)) % $blockSize; for ($i = 1; $i <= $paddingLength; $i++) { $paddedKey .= chr($i); } if (!$usesEncryption) { $key = Strings::packSSH2('sssNss', 'none', 'none', '', 1, $publicKey, $paddedKey); } else { $rounds = isset($options['rounds']) ? $options['rounds'] : 16; $salt = Random::string(16); $kdfoptions = Strings::packSSH2('sN', $salt, $rounds); $crypto = new AES('ctr'); $crypto->setPassword($password, 'bcrypt', $salt, $rounds, 32); $paddedKey = $crypto->encrypt($paddedKey); $key = Strings::packSSH2('sssNss', 'aes256-ctr', 'bcrypt', $kdfoptions, 1, $publicKey, $paddedKey); } $key = "openssh-key-v1\0$key"; return "-----BEGIN OPENSSH PRIVATE KEY-----\n" . chunk_split(Strings::base64_encode($key), 70, "\n") . "-----END OPENSSH PRIVATE KEY-----\n"; } } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common\Formats\Signature; use phpseclib3\Math\BigInteger; /** * Raw Signature Handler * * @author Jim Wigginton */ abstract class Raw { /** * Loads a signature * * @param array $sig * @return array|bool */ public static function load($sig) { switch (true) { case !is_array($sig): case !isset($sig['r']) || !isset($sig['s']): case !$sig['r'] instanceof BigInteger: case !$sig['s'] instanceof BigInteger: return false; } return [ 'r' => $sig['r'], 's' => $sig['s'] ]; } /** * Returns a signature in the appropriate format * * @param \phpseclib3\Math\BigInteger $r * @param \phpseclib3\Math\BigInteger $s * @return string */ public static function save(BigInteger $r, BigInteger $s) { return compact('r', 's'); } } * @copyright 2009 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\Common; /** * PublicKey interface * * @author Jim Wigginton */ interface PublicKey { public function verify($message, $signature); //public function encrypt($plaintext); public function toString($type, array $options = []); public function getFingerprint($algorithm); } * * * * @author Jim Wigginton * @copyright 2007 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; /** * Pure-PHP Random Number Generator * * @author Jim Wigginton */ abstract class Random { /** * Generate a random string. * * Although microoptimizations are generally discouraged as they impair readability this function is ripe with * microoptimizations because this function has the potential of being called a huge number of times. * eg. for RSA key generation. * * @param int $length * @throws \RuntimeException if a symmetric cipher is needed but not loaded * @return string */ public static function string($length) { if (!$length) { return ''; } try { return random_bytes($length); } catch (\Exception $e) { // random_compat will throw an Exception, which in PHP 5 does not implement Throwable } catch (\Throwable $e) { // If a sufficient source of randomness is unavailable, random_bytes() will throw an // object that implements the Throwable interface (Exception, TypeError, Error). // We don't actually need to do anything here. The string() method should just continue // as normal. Note, however, that if we don't have a sufficient source of randomness for // random_bytes(), most of the other calls here will fail too, so we'll end up using // the PHP implementation. } // at this point we have no choice but to use a pure-PHP CSPRNG // cascade entropy across multiple PHP instances by fixing the session and collecting all // environmental variables, including the previous session data and the current session // data. // // mt_rand seeds itself by looking at the PID and the time, both of which are (relatively) // easy to guess at. linux uses mouse clicks, keyboard timings, etc, as entropy sources, but // PHP isn't low level to be able to use those as sources and on a web server there's not likely // going to be a ton of keyboard or mouse action. web servers do have one thing that we can use // however, a ton of people visiting the website. obviously you don't want to base your seeding // solely on parameters a potential attacker sends but (1) not everything in $_SERVER is controlled // by the user and (2) this isn't just looking at the data sent by the current user - it's based // on the data sent by all users. one user requests the page and a hash of their info is saved. // another user visits the page and the serialization of their data is utilized along with the // server environment stuff and a hash of the previous http request data (which itself utilizes // a hash of the session data before that). certainly an attacker should be assumed to have // full control over his own http requests. he, however, is not going to have control over // everyone's http requests. static $crypto = false, $v; if ($crypto === false) { // save old session data $old_session_id = session_id(); $old_use_cookies = ini_get('session.use_cookies'); $old_session_cache_limiter = session_cache_limiter(); $_OLD_SESSION = isset($_SESSION) ? $_SESSION : false; if ($old_session_id != '') { session_write_close(); } session_id(1); ini_set('session.use_cookies', 0); session_cache_limiter(''); session_start(); $v = (isset($_SERVER) ? self::safe_serialize($_SERVER) : '') . (isset($_POST) ? self::safe_serialize($_POST) : '') . (isset($_GET) ? self::safe_serialize($_GET) : '') . (isset($_COOKIE) ? self::safe_serialize($_COOKIE) : '') . // as of PHP 8.1 $GLOBALS can't be accessed by reference, which eliminates // the need for phpseclib_safe_serialize. see https://wiki.php.net/rfc/restrict_globals_usage // for more info (version_compare(PHP_VERSION, '8.1.0', '>=') ? serialize($GLOBALS) : self::safe_serialize($GLOBALS)) . self::safe_serialize($_SESSION) . self::safe_serialize($_OLD_SESSION); $v = $seed = $_SESSION['seed'] = sha1($v, true); if (!isset($_SESSION['count'])) { $_SESSION['count'] = 0; } $_SESSION['count']++; session_write_close(); // restore old session data if ($old_session_id != '') { session_id($old_session_id); session_start(); ini_set('session.use_cookies', $old_use_cookies); session_cache_limiter($old_session_cache_limiter); } else { if ($_OLD_SESSION !== false) { $_SESSION = $_OLD_SESSION; unset($_OLD_SESSION); } else { unset($_SESSION); } } // in SSH2 a shared secret and an exchange hash are generated through the key exchange process. // the IV client to server is the hash of that "nonce" with the letter A and for the encryption key it's the letter C. // if the hash doesn't produce enough a key or an IV that's long enough concat successive hashes of the // original hash and the current hash. we'll be emulating that. for more info see the following URL: // // http://tools.ietf.org/html/rfc4253#section-7.2 // // see the is_string($crypto) part for an example of how to expand the keys $key = sha1($seed . 'A', true); $iv = sha1($seed . 'C', true); // ciphers are used as per the nist.gov link below. also, see this link: // // http://en.wikipedia.org/wiki/Cryptographically_secure_pseudorandom_number_generator#Designs_based_on_cryptographic_primitives switch (true) { case class_exists('\phpseclib3\Crypt\AES'): $crypto = new AES('ctr'); break; case class_exists('\phpseclib3\Crypt\Twofish'): $crypto = new Twofish('ctr'); break; case class_exists('\phpseclib3\Crypt\Blowfish'): $crypto = new Blowfish('ctr'); break; case class_exists('\phpseclib3\Crypt\TripleDES'): $crypto = new TripleDES('ctr'); break; case class_exists('\phpseclib3\Crypt\DES'): $crypto = new DES('ctr'); break; case class_exists('\phpseclib3\Crypt\RC4'): $crypto = new RC4(); break; default: throw new \RuntimeException(__CLASS__ . ' requires at least one symmetric cipher be loaded'); } $crypto->setKey(substr($key, 0, $crypto->getKeyLength() >> 3)); $crypto->setIV(substr($iv, 0, $crypto->getBlockLength() >> 3)); $crypto->enableContinuousBuffer(); } //return $crypto->encrypt(str_repeat("\0", $length)); // the following is based off of ANSI X9.31: // // http://csrc.nist.gov/groups/STM/cavp/documents/rng/931rngext.pdf // // OpenSSL uses that same standard for it's random numbers: // // http://www.opensource.apple.com/source/OpenSSL/OpenSSL-38/openssl/fips-1.0/rand/fips_rand.c // (do a search for "ANS X9.31 A.2.4") $result = ''; while (strlen($result) < $length) { $i = $crypto->encrypt(microtime()); // strlen(microtime()) == 21 $r = $crypto->encrypt($i ^ $v); // strlen($v) == 20 $v = $crypto->encrypt($r ^ $i); // strlen($r) == 20 $result .= $r; } return substr($result, 0, $length); } /** * Safely serialize variables * * If a class has a private __sleep() it'll emit a warning * @return mixed * @param mixed $arr */ private static function safe_serialize(&$arr) { if (is_object($arr)) { return ''; } if (!is_array($arr)) { return serialize($arr); } // prevent circular array recursion if (isset($arr['__phpseclib_marker'])) { return ''; } $safearr = []; $arr['__phpseclib_marker'] = true; foreach (array_keys($arr) as $key) { // do not recurse on the '__phpseclib_marker' key itself, for smaller memory usage if ($key !== '__phpseclib_marker') { $safearr[$key] = self::safe_serialize($arr[$key]); } } unset($arr['__phpseclib_marker']); return serialize($safearr); } } * @copyright 2019 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Exception\BadDecryptionException; use phpseclib3\Exception\InsufficientSetupException; /** * Pure-PHP implementation of ChaCha20. * * @author Jim Wigginton */ class ChaCha20 extends Salsa20 { /** * The OpenSSL specific name of the cipher * * @var string */ protected $cipher_name_openssl = 'chacha20'; /** * Test for engine validity * * This is mainly just a wrapper to set things up for \phpseclib3\Crypt\Common\SymmetricKey::isValidEngine() * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() * @param int $engine * @return bool */ protected function isValidEngineHelper($engine) { switch ($engine) { case self::ENGINE_LIBSODIUM: // PHP 7.2.0 (30 Nov 2017) added support for libsodium // we could probably make it so that if $this->counter == 0 then the first block would be done with either OpenSSL // or PHP and then subsequent blocks would then be done with libsodium but idk - it's not a high priority atm // we could also make it so that if $this->counter == 0 and $this->continuousBuffer then do the first string // with libsodium and subsequent strings with openssl or pure-PHP but again not a high priority return function_exists('sodium_crypto_aead_chacha20poly1305_ietf_encrypt') && $this->key_length == 32 && (($this->usePoly1305 && !isset($this->poly1305Key) && $this->counter == 0) || $this->counter == 1) && !$this->continuousBuffer; case self::ENGINE_OPENSSL: // OpenSSL 1.1.0 (released 25 Aug 2016) added support for chacha20. // PHP didn't support OpenSSL 1.1.0 until 7.0.19 (11 May 2017) // if you attempt to provide openssl with a 128 bit key (as opposed to a 256 bit key) openssl will null // pad the key to 256 bits and still use the expansion constant for 256-bit keys. the fact that // openssl treats the IV as both the counter and nonce, however, let's us use openssl in continuous mode // whereas libsodium does not if ($this->key_length != 32) { return false; } } return parent::isValidEngineHelper($engine); } /** * Encrypts a message. * * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() * @see self::crypt() * @param string $plaintext * @return string $ciphertext */ public function encrypt($plaintext) { $this->setup(); if ($this->engine == self::ENGINE_LIBSODIUM) { return $this->encrypt_with_libsodium($plaintext); } return parent::encrypt($plaintext); } /** * Decrypts a message. * * $this->decrypt($this->encrypt($plaintext)) == $this->encrypt($this->encrypt($plaintext)). * At least if the continuous buffer is disabled. * * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see self::crypt() * @param string $ciphertext * @return string $plaintext */ public function decrypt($ciphertext) { $this->setup(); if ($this->engine == self::ENGINE_LIBSODIUM) { return $this->decrypt_with_libsodium($ciphertext); } return parent::decrypt($ciphertext); } /** * Encrypts a message with libsodium * * @see self::encrypt() * @param string $plaintext * @return string $text */ private function encrypt_with_libsodium($plaintext) { $params = [$plaintext, $this->aad, $this->nonce, $this->key]; $ciphertext = strlen($this->nonce) == 8 ? sodium_crypto_aead_chacha20poly1305_encrypt(...$params) : sodium_crypto_aead_chacha20poly1305_ietf_encrypt(...$params); if (!$this->usePoly1305) { return substr($ciphertext, 0, strlen($plaintext)); } $newciphertext = substr($ciphertext, 0, strlen($plaintext)); $this->newtag = $this->usingGeneratedPoly1305Key && strlen($this->nonce) == 12 ? substr($ciphertext, strlen($plaintext)) : $this->poly1305($newciphertext); return $newciphertext; } /** * Decrypts a message with libsodium * * @see self::decrypt() * @param string $ciphertext * @return string $text */ private function decrypt_with_libsodium($ciphertext) { $params = [$ciphertext, $this->aad, $this->nonce, $this->key]; if (isset($this->poly1305Key)) { if ($this->oldtag === false) { throw new InsufficientSetupException('Authentication Tag has not been set'); } if ($this->usingGeneratedPoly1305Key && strlen($this->nonce) == 12) { $plaintext = sodium_crypto_aead_chacha20poly1305_ietf_decrypt(...$params); $this->oldtag = false; if ($plaintext === false) { throw new BadDecryptionException('Derived authentication tag and supplied authentication tag do not match'); } return $plaintext; } $newtag = $this->poly1305($ciphertext); if ($this->oldtag != substr($newtag, 0, strlen($this->oldtag))) { $this->oldtag = false; throw new BadDecryptionException('Derived authentication tag and supplied authentication tag do not match'); } $this->oldtag = false; } $plaintext = strlen($this->nonce) == 8 ? sodium_crypto_aead_chacha20poly1305_encrypt(...$params) : sodium_crypto_aead_chacha20poly1305_ietf_encrypt(...$params); return substr($plaintext, 0, strlen($ciphertext)); } /** * Sets the nonce. * * @param string $nonce */ public function setNonce($nonce) { if (!is_string($nonce)) { throw new \UnexpectedValueException('The nonce should be a string'); } /* from https://tools.ietf.org/html/rfc7539#page-7 "Note also that the original ChaCha had a 64-bit nonce and 64-bit block count. We have modified this here to be more consistent with recommendations in Section 3.2 of [RFC5116]." */ switch (strlen($nonce)) { case 8: // 64 bits case 12: // 96 bits break; default: throw new \LengthException('Nonce of size ' . strlen($nonce) . ' not supported by this algorithm. Only 64-bit nonces or 96-bit nonces are supported'); } $this->nonce = $nonce; $this->changed = true; $this->setEngine(); } /** * Setup the self::ENGINE_INTERNAL $engine * * (re)init, if necessary, the internal cipher $engine * * _setup() will be called each time if $changed === true * typically this happens when using one or more of following public methods: * * - setKey() * * - setNonce() * * - First run of encrypt() / decrypt() with no init-settings * * @see self::setKey() * @see self::setNonce() * @see self::disableContinuousBuffer() */ protected function setup() { if (!$this->changed) { return; } $this->enbuffer = $this->debuffer = ['ciphertext' => '', 'counter' => $this->counter]; $this->changed = $this->nonIVChanged = false; if ($this->nonce === false) { throw new InsufficientSetupException('No nonce has been defined'); } if ($this->key === false) { throw new InsufficientSetupException('No key has been defined'); } if ($this->usePoly1305 && !isset($this->poly1305Key)) { $this->usingGeneratedPoly1305Key = true; if ($this->engine == self::ENGINE_LIBSODIUM) { return; } $this->createPoly1305Key(); } $key = $this->key; if (strlen($key) == 16) { $constant = 'expand 16-byte k'; $key .= $key; } else { $constant = 'expand 32-byte k'; } $this->p1 = $constant . $key; $this->p2 = $this->nonce; if (strlen($this->nonce) == 8) { $this->p2 = "\0\0\0\0" . $this->p2; } } /** * The quarterround function * * @param int $a * @param int $b * @param int $c * @param int $d */ protected static function quarterRound(&$a, &$b, &$c, &$d) { // in https://datatracker.ietf.org/doc/html/rfc7539#section-2.1 the addition, // xor'ing and rotation are all on the same line so i'm keeping it on the same // line here as well // @codingStandardsIgnoreStart $a+= $b; $d = self::leftRotate(intval($d) ^ intval($a), 16); $c+= $d; $b = self::leftRotate(intval($b) ^ intval($c), 12); $a+= $b; $d = self::leftRotate(intval($d) ^ intval($a), 8); $c+= $d; $b = self::leftRotate(intval($b) ^ intval($c), 7); // @codingStandardsIgnoreEnd } /** * The doubleround function * * @param int $x0 (by reference) * @param int $x1 (by reference) * @param int $x2 (by reference) * @param int $x3 (by reference) * @param int $x4 (by reference) * @param int $x5 (by reference) * @param int $x6 (by reference) * @param int $x7 (by reference) * @param int $x8 (by reference) * @param int $x9 (by reference) * @param int $x10 (by reference) * @param int $x11 (by reference) * @param int $x12 (by reference) * @param int $x13 (by reference) * @param int $x14 (by reference) * @param int $x15 (by reference) */ protected static function doubleRound(&$x0, &$x1, &$x2, &$x3, &$x4, &$x5, &$x6, &$x7, &$x8, &$x9, &$x10, &$x11, &$x12, &$x13, &$x14, &$x15) { // columnRound static::quarterRound($x0, $x4, $x8, $x12); static::quarterRound($x1, $x5, $x9, $x13); static::quarterRound($x2, $x6, $x10, $x14); static::quarterRound($x3, $x7, $x11, $x15); // rowRound static::quarterRound($x0, $x5, $x10, $x15); static::quarterRound($x1, $x6, $x11, $x12); static::quarterRound($x2, $x7, $x8, $x13); static::quarterRound($x3, $x4, $x9, $x14); } /** * The Salsa20 hash function function * * On my laptop this loop unrolled / function dereferenced version of parent::salsa20 encrypts 1mb of text in * 0.65s vs the 0.85s that it takes with the parent method. * * If we were free to assume that the host OS would always be 64-bits then the if condition in leftRotate could * be eliminated and we could knock this done to 0.60s. * * For comparison purposes, RC4 takes 0.16s and AES in CTR mode with the Eval engine takes 0.48s. * AES in CTR mode with the PHP engine takes 1.19s. Salsa20 / ChaCha20 do not benefit as much from the Eval * approach due to the fact that there are a lot less variables to de-reference, fewer loops to unroll, etc * * @param string $x */ protected static function salsa20($x) { list(, $x0, $x1, $x2, $x3, $x4, $x5, $x6, $x7, $x8, $x9, $x10, $x11, $x12, $x13, $x14, $x15) = unpack('V*', $x); $z0 = $x0; $z1 = $x1; $z2 = $x2; $z3 = $x3; $z4 = $x4; $z5 = $x5; $z6 = $x6; $z7 = $x7; $z8 = $x8; $z9 = $x9; $z10 = $x10; $z11 = $x11; $z12 = $x12; $z13 = $x13; $z14 = $x14; $z15 = $x15; // @codingStandardsIgnoreStart // columnRound $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 16); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 12); $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 8); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 7); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 16); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 12); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 8); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 7); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 16); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 12); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 8); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 7); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 16); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 12); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 8); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 7); // rowRound $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 16); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 12); $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 8); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 7); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 16); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 12); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 8); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 7); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 16); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 12); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 8); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 7); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 16); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 12); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 8); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 7); // columnRound $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 16); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 12); $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 8); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 7); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 16); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 12); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 8); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 7); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 16); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 12); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 8); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 7); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 16); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 12); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 8); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 7); // rowRound $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 16); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 12); $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 8); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 7); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 16); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 12); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 8); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 7); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 16); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 12); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 8); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 7); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 16); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 12); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 8); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 7); // columnRound $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 16); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 12); $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 8); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 7); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 16); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 12); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 8); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 7); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 16); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 12); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 8); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 7); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 16); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 12); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 8); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 7); // rowRound $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 16); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 12); $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 8); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 7); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 16); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 12); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 8); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 7); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 16); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 12); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 8); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 7); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 16); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 12); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 8); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 7); // columnRound $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 16); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 12); $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 8); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 7); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 16); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 12); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 8); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 7); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 16); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 12); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 8); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 7); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 16); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 12); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 8); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 7); // rowRound $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 16); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 12); $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 8); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 7); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 16); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 12); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 8); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 7); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 16); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 12); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 8); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 7); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 16); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 12); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 8); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 7); // columnRound $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 16); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 12); $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 8); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 7); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 16); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 12); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 8); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 7); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 16); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 12); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 8); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 7); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 16); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 12); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 8); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 7); // rowRound $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 16); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 12); $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 8); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 7); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 16); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 12); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 8); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 7); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 16); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 12); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 8); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 7); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 16); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 12); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 8); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 7); // columnRound $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 16); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 12); $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 8); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 7); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 16); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 12); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 8); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 7); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 16); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 12); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 8); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 7); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 16); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 12); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 8); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 7); // rowRound $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 16); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 12); $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 8); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 7); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 16); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 12); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 8); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 7); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 16); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 12); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 8); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 7); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 16); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 12); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 8); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 7); // columnRound $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 16); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 12); $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 8); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 7); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 16); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 12); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 8); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 7); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 16); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 12); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 8); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 7); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 16); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 12); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 8); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 7); // rowRound $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 16); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 12); $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 8); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 7); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 16); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 12); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 8); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 7); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 16); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 12); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 8); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 7); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 16); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 12); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 8); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 7); // columnRound $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 16); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 12); $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 8); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 7); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 16); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 12); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 8); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 7); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 16); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 12); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 8); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 7); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 16); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 12); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 8); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 7); // rowRound $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 16); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 12); $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 8); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 7); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 16); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 12); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 8); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 7); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 16); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 12); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 8); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 7); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 16); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 12); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 8); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 7); // columnRound $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 16); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 12); $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 8); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 7); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 16); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 12); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 8); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 7); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 16); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 12); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 8); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 7); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 16); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 12); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 8); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 7); // rowRound $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 16); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 12); $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 8); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 7); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 16); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 12); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 8); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 7); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 16); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 12); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 8); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 7); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 16); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 12); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 8); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 7); // columnRound $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 16); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 12); $x0+= $x4; $x12 = self::leftRotate(intval($x12) ^ intval($x0), 8); $x8+= $x12; $x4 = self::leftRotate(intval($x4) ^ intval($x8), 7); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 16); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 12); $x1+= $x5; $x13 = self::leftRotate(intval($x13) ^ intval($x1), 8); $x9+= $x13; $x5 = self::leftRotate(intval($x5) ^ intval($x9), 7); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 16); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 12); $x2+= $x6; $x14 = self::leftRotate(intval($x14) ^ intval($x2), 8); $x10+= $x14; $x6 = self::leftRotate(intval($x6) ^ intval($x10), 7); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 16); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 12); $x3+= $x7; $x15 = self::leftRotate(intval($x15) ^ intval($x3), 8); $x11+= $x15; $x7 = self::leftRotate(intval($x7) ^ intval($x11), 7); // rowRound $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 16); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 12); $x0+= $x5; $x15 = self::leftRotate(intval($x15) ^ intval($x0), 8); $x10+= $x15; $x5 = self::leftRotate(intval($x5) ^ intval($x10), 7); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 16); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 12); $x1+= $x6; $x12 = self::leftRotate(intval($x12) ^ intval($x1), 8); $x11+= $x12; $x6 = self::leftRotate(intval($x6) ^ intval($x11), 7); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 16); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 12); $x2+= $x7; $x13 = self::leftRotate(intval($x13) ^ intval($x2), 8); $x8+= $x13; $x7 = self::leftRotate(intval($x7) ^ intval($x8), 7); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 16); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 12); $x3+= $x4; $x14 = self::leftRotate(intval($x14) ^ intval($x3), 8); $x9+= $x14; $x4 = self::leftRotate(intval($x4) ^ intval($x9), 7); // @codingStandardsIgnoreEnd $x0 += $z0; $x1 += $z1; $x2 += $z2; $x3 += $z3; $x4 += $z4; $x5 += $z5; $x6 += $z6; $x7 += $z7; $x8 += $z8; $x9 += $z9; $x10 += $z10; $x11 += $z11; $x12 += $z12; $x13 += $z13; $x14 += $z14; $x15 += $z15; return pack('V*', $x0, $x1, $x2, $x3, $x4, $x5, $x6, $x7, $x8, $x9, $x10, $x11, $x12, $x13, $x14, $x15); } } * setKey('abcdefgh'); * * $size = 10 * 1024; * $plaintext = ''; * for ($i = 0; $i < $size; $i++) { * $plaintext.= 'a'; * } * * echo $des->decrypt($des->encrypt($plaintext)); * ?> * * * @author Jim Wigginton * @copyright 2007 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Crypt\Common\BlockCipher; use phpseclib3\Exception\BadModeException; /** * Pure-PHP implementation of DES. * * @author Jim Wigginton */ class DES extends BlockCipher { /** * Contains $keys[self::ENCRYPT] * * @see \phpseclib3\Crypt\DES::setupKey() * @see \phpseclib3\Crypt\DES::processBlock() */ const ENCRYPT = 0; /** * Contains $keys[self::DECRYPT] * * @see \phpseclib3\Crypt\DES::setupKey() * @see \phpseclib3\Crypt\DES::processBlock() */ const DECRYPT = 1; /** * Block Length of the cipher * * @see \phpseclib3\Crypt\Common\SymmetricKey::block_size * @var int */ protected $block_size = 8; /** * Key Length (in bytes) * * @see \phpseclib3\Crypt\Common\SymmetricKey::setKeyLength() * @var int */ protected $key_length = 8; /** * The mcrypt specific name of the cipher * * @see \phpseclib3\Crypt\Common\SymmetricKey::cipher_name_mcrypt * @var string */ protected $cipher_name_mcrypt = 'des'; /** * The OpenSSL names of the cipher / modes * * @see \phpseclib3\Crypt\Common\SymmetricKey::openssl_mode_names * @var array */ protected $openssl_mode_names = [ self::MODE_ECB => 'des-ecb', self::MODE_CBC => 'des-cbc', self::MODE_CFB => 'des-cfb', self::MODE_OFB => 'des-ofb' // self::MODE_CTR is undefined for DES ]; /** * Optimizing value while CFB-encrypting * * @see \phpseclib3\Crypt\Common\SymmetricKey::cfb_init_len * @var int */ protected $cfb_init_len = 500; /** * Switch for DES/3DES encryption * * Used only if $engine == self::ENGINE_INTERNAL * * @see self::setupKey() * @see self::processBlock() * @var int */ protected $des_rounds = 1; /** * max possible size of $key * * @see self::setKey() * @var string */ protected $key_length_max = 8; /** * The Key Schedule * * @see self::setupKey() * @var array */ private $keys; /** * Key Cache "key" * * @see self::setupKey() * @var array */ private $kl; /** * Shuffle table. * * For each byte value index, the entry holds an 8-byte string * with each byte containing all bits in the same state as the * corresponding bit in the index value. * * @see self::processBlock() * @see self::setupKey() * @var array */ protected static $shuffle = [ "\x00\x00\x00\x00\x00\x00\x00\x00", "\x00\x00\x00\x00\x00\x00\x00\xFF", "\x00\x00\x00\x00\x00\x00\xFF\x00", "\x00\x00\x00\x00\x00\x00\xFF\xFF", "\x00\x00\x00\x00\x00\xFF\x00\x00", "\x00\x00\x00\x00\x00\xFF\x00\xFF", "\x00\x00\x00\x00\x00\xFF\xFF\x00", "\x00\x00\x00\x00\x00\xFF\xFF\xFF", "\x00\x00\x00\x00\xFF\x00\x00\x00", "\x00\x00\x00\x00\xFF\x00\x00\xFF", "\x00\x00\x00\x00\xFF\x00\xFF\x00", "\x00\x00\x00\x00\xFF\x00\xFF\xFF", "\x00\x00\x00\x00\xFF\xFF\x00\x00", "\x00\x00\x00\x00\xFF\xFF\x00\xFF", "\x00\x00\x00\x00\xFF\xFF\xFF\x00", "\x00\x00\x00\x00\xFF\xFF\xFF\xFF", "\x00\x00\x00\xFF\x00\x00\x00\x00", "\x00\x00\x00\xFF\x00\x00\x00\xFF", "\x00\x00\x00\xFF\x00\x00\xFF\x00", "\x00\x00\x00\xFF\x00\x00\xFF\xFF", "\x00\x00\x00\xFF\x00\xFF\x00\x00", "\x00\x00\x00\xFF\x00\xFF\x00\xFF", "\x00\x00\x00\xFF\x00\xFF\xFF\x00", "\x00\x00\x00\xFF\x00\xFF\xFF\xFF", "\x00\x00\x00\xFF\xFF\x00\x00\x00", "\x00\x00\x00\xFF\xFF\x00\x00\xFF", "\x00\x00\x00\xFF\xFF\x00\xFF\x00", "\x00\x00\x00\xFF\xFF\x00\xFF\xFF", "\x00\x00\x00\xFF\xFF\xFF\x00\x00", "\x00\x00\x00\xFF\xFF\xFF\x00\xFF", "\x00\x00\x00\xFF\xFF\xFF\xFF\x00", "\x00\x00\x00\xFF\xFF\xFF\xFF\xFF", "\x00\x00\xFF\x00\x00\x00\x00\x00", "\x00\x00\xFF\x00\x00\x00\x00\xFF", "\x00\x00\xFF\x00\x00\x00\xFF\x00", "\x00\x00\xFF\x00\x00\x00\xFF\xFF", "\x00\x00\xFF\x00\x00\xFF\x00\x00", "\x00\x00\xFF\x00\x00\xFF\x00\xFF", "\x00\x00\xFF\x00\x00\xFF\xFF\x00", "\x00\x00\xFF\x00\x00\xFF\xFF\xFF", "\x00\x00\xFF\x00\xFF\x00\x00\x00", "\x00\x00\xFF\x00\xFF\x00\x00\xFF", "\x00\x00\xFF\x00\xFF\x00\xFF\x00", "\x00\x00\xFF\x00\xFF\x00\xFF\xFF", "\x00\x00\xFF\x00\xFF\xFF\x00\x00", "\x00\x00\xFF\x00\xFF\xFF\x00\xFF", "\x00\x00\xFF\x00\xFF\xFF\xFF\x00", "\x00\x00\xFF\x00\xFF\xFF\xFF\xFF", "\x00\x00\xFF\xFF\x00\x00\x00\x00", "\x00\x00\xFF\xFF\x00\x00\x00\xFF", "\x00\x00\xFF\xFF\x00\x00\xFF\x00", "\x00\x00\xFF\xFF\x00\x00\xFF\xFF", "\x00\x00\xFF\xFF\x00\xFF\x00\x00", "\x00\x00\xFF\xFF\x00\xFF\x00\xFF", "\x00\x00\xFF\xFF\x00\xFF\xFF\x00", "\x00\x00\xFF\xFF\x00\xFF\xFF\xFF", "\x00\x00\xFF\xFF\xFF\x00\x00\x00", "\x00\x00\xFF\xFF\xFF\x00\x00\xFF", "\x00\x00\xFF\xFF\xFF\x00\xFF\x00", "\x00\x00\xFF\xFF\xFF\x00\xFF\xFF", "\x00\x00\xFF\xFF\xFF\xFF\x00\x00", "\x00\x00\xFF\xFF\xFF\xFF\x00\xFF", "\x00\x00\xFF\xFF\xFF\xFF\xFF\x00", "\x00\x00\xFF\xFF\xFF\xFF\xFF\xFF", "\x00\xFF\x00\x00\x00\x00\x00\x00", "\x00\xFF\x00\x00\x00\x00\x00\xFF", "\x00\xFF\x00\x00\x00\x00\xFF\x00", "\x00\xFF\x00\x00\x00\x00\xFF\xFF", "\x00\xFF\x00\x00\x00\xFF\x00\x00", "\x00\xFF\x00\x00\x00\xFF\x00\xFF", "\x00\xFF\x00\x00\x00\xFF\xFF\x00", "\x00\xFF\x00\x00\x00\xFF\xFF\xFF", "\x00\xFF\x00\x00\xFF\x00\x00\x00", "\x00\xFF\x00\x00\xFF\x00\x00\xFF", "\x00\xFF\x00\x00\xFF\x00\xFF\x00", "\x00\xFF\x00\x00\xFF\x00\xFF\xFF", "\x00\xFF\x00\x00\xFF\xFF\x00\x00", "\x00\xFF\x00\x00\xFF\xFF\x00\xFF", "\x00\xFF\x00\x00\xFF\xFF\xFF\x00", "\x00\xFF\x00\x00\xFF\xFF\xFF\xFF", "\x00\xFF\x00\xFF\x00\x00\x00\x00", "\x00\xFF\x00\xFF\x00\x00\x00\xFF", "\x00\xFF\x00\xFF\x00\x00\xFF\x00", "\x00\xFF\x00\xFF\x00\x00\xFF\xFF", "\x00\xFF\x00\xFF\x00\xFF\x00\x00", "\x00\xFF\x00\xFF\x00\xFF\x00\xFF", "\x00\xFF\x00\xFF\x00\xFF\xFF\x00", "\x00\xFF\x00\xFF\x00\xFF\xFF\xFF", "\x00\xFF\x00\xFF\xFF\x00\x00\x00", "\x00\xFF\x00\xFF\xFF\x00\x00\xFF", "\x00\xFF\x00\xFF\xFF\x00\xFF\x00", "\x00\xFF\x00\xFF\xFF\x00\xFF\xFF", "\x00\xFF\x00\xFF\xFF\xFF\x00\x00", "\x00\xFF\x00\xFF\xFF\xFF\x00\xFF", "\x00\xFF\x00\xFF\xFF\xFF\xFF\x00", "\x00\xFF\x00\xFF\xFF\xFF\xFF\xFF", "\x00\xFF\xFF\x00\x00\x00\x00\x00", "\x00\xFF\xFF\x00\x00\x00\x00\xFF", "\x00\xFF\xFF\x00\x00\x00\xFF\x00", "\x00\xFF\xFF\x00\x00\x00\xFF\xFF", "\x00\xFF\xFF\x00\x00\xFF\x00\x00", "\x00\xFF\xFF\x00\x00\xFF\x00\xFF", "\x00\xFF\xFF\x00\x00\xFF\xFF\x00", "\x00\xFF\xFF\x00\x00\xFF\xFF\xFF", "\x00\xFF\xFF\x00\xFF\x00\x00\x00", "\x00\xFF\xFF\x00\xFF\x00\x00\xFF", "\x00\xFF\xFF\x00\xFF\x00\xFF\x00", "\x00\xFF\xFF\x00\xFF\x00\xFF\xFF", "\x00\xFF\xFF\x00\xFF\xFF\x00\x00", "\x00\xFF\xFF\x00\xFF\xFF\x00\xFF", "\x00\xFF\xFF\x00\xFF\xFF\xFF\x00", "\x00\xFF\xFF\x00\xFF\xFF\xFF\xFF", "\x00\xFF\xFF\xFF\x00\x00\x00\x00", "\x00\xFF\xFF\xFF\x00\x00\x00\xFF", "\x00\xFF\xFF\xFF\x00\x00\xFF\x00", "\x00\xFF\xFF\xFF\x00\x00\xFF\xFF", "\x00\xFF\xFF\xFF\x00\xFF\x00\x00", "\x00\xFF\xFF\xFF\x00\xFF\x00\xFF", "\x00\xFF\xFF\xFF\x00\xFF\xFF\x00", "\x00\xFF\xFF\xFF\x00\xFF\xFF\xFF", "\x00\xFF\xFF\xFF\xFF\x00\x00\x00", "\x00\xFF\xFF\xFF\xFF\x00\x00\xFF", "\x00\xFF\xFF\xFF\xFF\x00\xFF\x00", "\x00\xFF\xFF\xFF\xFF\x00\xFF\xFF", "\x00\xFF\xFF\xFF\xFF\xFF\x00\x00", "\x00\xFF\xFF\xFF\xFF\xFF\x00\xFF", "\x00\xFF\xFF\xFF\xFF\xFF\xFF\x00", "\x00\xFF\xFF\xFF\xFF\xFF\xFF\xFF", "\xFF\x00\x00\x00\x00\x00\x00\x00", "\xFF\x00\x00\x00\x00\x00\x00\xFF", "\xFF\x00\x00\x00\x00\x00\xFF\x00", "\xFF\x00\x00\x00\x00\x00\xFF\xFF", "\xFF\x00\x00\x00\x00\xFF\x00\x00", "\xFF\x00\x00\x00\x00\xFF\x00\xFF", "\xFF\x00\x00\x00\x00\xFF\xFF\x00", "\xFF\x00\x00\x00\x00\xFF\xFF\xFF", "\xFF\x00\x00\x00\xFF\x00\x00\x00", "\xFF\x00\x00\x00\xFF\x00\x00\xFF", "\xFF\x00\x00\x00\xFF\x00\xFF\x00", "\xFF\x00\x00\x00\xFF\x00\xFF\xFF", "\xFF\x00\x00\x00\xFF\xFF\x00\x00", "\xFF\x00\x00\x00\xFF\xFF\x00\xFF", "\xFF\x00\x00\x00\xFF\xFF\xFF\x00", "\xFF\x00\x00\x00\xFF\xFF\xFF\xFF", "\xFF\x00\x00\xFF\x00\x00\x00\x00", "\xFF\x00\x00\xFF\x00\x00\x00\xFF", "\xFF\x00\x00\xFF\x00\x00\xFF\x00", "\xFF\x00\x00\xFF\x00\x00\xFF\xFF", "\xFF\x00\x00\xFF\x00\xFF\x00\x00", "\xFF\x00\x00\xFF\x00\xFF\x00\xFF", "\xFF\x00\x00\xFF\x00\xFF\xFF\x00", "\xFF\x00\x00\xFF\x00\xFF\xFF\xFF", "\xFF\x00\x00\xFF\xFF\x00\x00\x00", "\xFF\x00\x00\xFF\xFF\x00\x00\xFF", "\xFF\x00\x00\xFF\xFF\x00\xFF\x00", "\xFF\x00\x00\xFF\xFF\x00\xFF\xFF", "\xFF\x00\x00\xFF\xFF\xFF\x00\x00", "\xFF\x00\x00\xFF\xFF\xFF\x00\xFF", "\xFF\x00\x00\xFF\xFF\xFF\xFF\x00", "\xFF\x00\x00\xFF\xFF\xFF\xFF\xFF", "\xFF\x00\xFF\x00\x00\x00\x00\x00", "\xFF\x00\xFF\x00\x00\x00\x00\xFF", "\xFF\x00\xFF\x00\x00\x00\xFF\x00", "\xFF\x00\xFF\x00\x00\x00\xFF\xFF", "\xFF\x00\xFF\x00\x00\xFF\x00\x00", "\xFF\x00\xFF\x00\x00\xFF\x00\xFF", "\xFF\x00\xFF\x00\x00\xFF\xFF\x00", "\xFF\x00\xFF\x00\x00\xFF\xFF\xFF", "\xFF\x00\xFF\x00\xFF\x00\x00\x00", "\xFF\x00\xFF\x00\xFF\x00\x00\xFF", "\xFF\x00\xFF\x00\xFF\x00\xFF\x00", "\xFF\x00\xFF\x00\xFF\x00\xFF\xFF", "\xFF\x00\xFF\x00\xFF\xFF\x00\x00", "\xFF\x00\xFF\x00\xFF\xFF\x00\xFF", "\xFF\x00\xFF\x00\xFF\xFF\xFF\x00", "\xFF\x00\xFF\x00\xFF\xFF\xFF\xFF", "\xFF\x00\xFF\xFF\x00\x00\x00\x00", "\xFF\x00\xFF\xFF\x00\x00\x00\xFF", "\xFF\x00\xFF\xFF\x00\x00\xFF\x00", "\xFF\x00\xFF\xFF\x00\x00\xFF\xFF", "\xFF\x00\xFF\xFF\x00\xFF\x00\x00", "\xFF\x00\xFF\xFF\x00\xFF\x00\xFF", "\xFF\x00\xFF\xFF\x00\xFF\xFF\x00", "\xFF\x00\xFF\xFF\x00\xFF\xFF\xFF", "\xFF\x00\xFF\xFF\xFF\x00\x00\x00", "\xFF\x00\xFF\xFF\xFF\x00\x00\xFF", "\xFF\x00\xFF\xFF\xFF\x00\xFF\x00", "\xFF\x00\xFF\xFF\xFF\x00\xFF\xFF", "\xFF\x00\xFF\xFF\xFF\xFF\x00\x00", "\xFF\x00\xFF\xFF\xFF\xFF\x00\xFF", "\xFF\x00\xFF\xFF\xFF\xFF\xFF\x00", "\xFF\x00\xFF\xFF\xFF\xFF\xFF\xFF", "\xFF\xFF\x00\x00\x00\x00\x00\x00", "\xFF\xFF\x00\x00\x00\x00\x00\xFF", "\xFF\xFF\x00\x00\x00\x00\xFF\x00", "\xFF\xFF\x00\x00\x00\x00\xFF\xFF", "\xFF\xFF\x00\x00\x00\xFF\x00\x00", "\xFF\xFF\x00\x00\x00\xFF\x00\xFF", "\xFF\xFF\x00\x00\x00\xFF\xFF\x00", "\xFF\xFF\x00\x00\x00\xFF\xFF\xFF", "\xFF\xFF\x00\x00\xFF\x00\x00\x00", "\xFF\xFF\x00\x00\xFF\x00\x00\xFF", "\xFF\xFF\x00\x00\xFF\x00\xFF\x00", "\xFF\xFF\x00\x00\xFF\x00\xFF\xFF", "\xFF\xFF\x00\x00\xFF\xFF\x00\x00", "\xFF\xFF\x00\x00\xFF\xFF\x00\xFF", "\xFF\xFF\x00\x00\xFF\xFF\xFF\x00", "\xFF\xFF\x00\x00\xFF\xFF\xFF\xFF", "\xFF\xFF\x00\xFF\x00\x00\x00\x00", "\xFF\xFF\x00\xFF\x00\x00\x00\xFF", "\xFF\xFF\x00\xFF\x00\x00\xFF\x00", "\xFF\xFF\x00\xFF\x00\x00\xFF\xFF", "\xFF\xFF\x00\xFF\x00\xFF\x00\x00", "\xFF\xFF\x00\xFF\x00\xFF\x00\xFF", "\xFF\xFF\x00\xFF\x00\xFF\xFF\x00", "\xFF\xFF\x00\xFF\x00\xFF\xFF\xFF", "\xFF\xFF\x00\xFF\xFF\x00\x00\x00", "\xFF\xFF\x00\xFF\xFF\x00\x00\xFF", "\xFF\xFF\x00\xFF\xFF\x00\xFF\x00", "\xFF\xFF\x00\xFF\xFF\x00\xFF\xFF", "\xFF\xFF\x00\xFF\xFF\xFF\x00\x00", "\xFF\xFF\x00\xFF\xFF\xFF\x00\xFF", "\xFF\xFF\x00\xFF\xFF\xFF\xFF\x00", "\xFF\xFF\x00\xFF\xFF\xFF\xFF\xFF", "\xFF\xFF\xFF\x00\x00\x00\x00\x00", "\xFF\xFF\xFF\x00\x00\x00\x00\xFF", "\xFF\xFF\xFF\x00\x00\x00\xFF\x00", "\xFF\xFF\xFF\x00\x00\x00\xFF\xFF", "\xFF\xFF\xFF\x00\x00\xFF\x00\x00", "\xFF\xFF\xFF\x00\x00\xFF\x00\xFF", "\xFF\xFF\xFF\x00\x00\xFF\xFF\x00", "\xFF\xFF\xFF\x00\x00\xFF\xFF\xFF", "\xFF\xFF\xFF\x00\xFF\x00\x00\x00", "\xFF\xFF\xFF\x00\xFF\x00\x00\xFF", "\xFF\xFF\xFF\x00\xFF\x00\xFF\x00", "\xFF\xFF\xFF\x00\xFF\x00\xFF\xFF", "\xFF\xFF\xFF\x00\xFF\xFF\x00\x00", "\xFF\xFF\xFF\x00\xFF\xFF\x00\xFF", "\xFF\xFF\xFF\x00\xFF\xFF\xFF\x00", "\xFF\xFF\xFF\x00\xFF\xFF\xFF\xFF", "\xFF\xFF\xFF\xFF\x00\x00\x00\x00", "\xFF\xFF\xFF\xFF\x00\x00\x00\xFF", "\xFF\xFF\xFF\xFF\x00\x00\xFF\x00", "\xFF\xFF\xFF\xFF\x00\x00\xFF\xFF", "\xFF\xFF\xFF\xFF\x00\xFF\x00\x00", "\xFF\xFF\xFF\xFF\x00\xFF\x00\xFF", "\xFF\xFF\xFF\xFF\x00\xFF\xFF\x00", "\xFF\xFF\xFF\xFF\x00\xFF\xFF\xFF", "\xFF\xFF\xFF\xFF\xFF\x00\x00\x00", "\xFF\xFF\xFF\xFF\xFF\x00\x00\xFF", "\xFF\xFF\xFF\xFF\xFF\x00\xFF\x00", "\xFF\xFF\xFF\xFF\xFF\x00\xFF\xFF", "\xFF\xFF\xFF\xFF\xFF\xFF\x00\x00", "\xFF\xFF\xFF\xFF\xFF\xFF\x00\xFF", "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\x00", "\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF" ]; /** * IP mapping helper table. * * Indexing this table with each source byte performs the initial bit permutation. * * @var array */ protected static $ipmap = [ 0x00, 0x10, 0x01, 0x11, 0x20, 0x30, 0x21, 0x31, 0x02, 0x12, 0x03, 0x13, 0x22, 0x32, 0x23, 0x33, 0x40, 0x50, 0x41, 0x51, 0x60, 0x70, 0x61, 0x71, 0x42, 0x52, 0x43, 0x53, 0x62, 0x72, 0x63, 0x73, 0x04, 0x14, 0x05, 0x15, 0x24, 0x34, 0x25, 0x35, 0x06, 0x16, 0x07, 0x17, 0x26, 0x36, 0x27, 0x37, 0x44, 0x54, 0x45, 0x55, 0x64, 0x74, 0x65, 0x75, 0x46, 0x56, 0x47, 0x57, 0x66, 0x76, 0x67, 0x77, 0x80, 0x90, 0x81, 0x91, 0xA0, 0xB0, 0xA1, 0xB1, 0x82, 0x92, 0x83, 0x93, 0xA2, 0xB2, 0xA3, 0xB3, 0xC0, 0xD0, 0xC1, 0xD1, 0xE0, 0xF0, 0xE1, 0xF1, 0xC2, 0xD2, 0xC3, 0xD3, 0xE2, 0xF2, 0xE3, 0xF3, 0x84, 0x94, 0x85, 0x95, 0xA4, 0xB4, 0xA5, 0xB5, 0x86, 0x96, 0x87, 0x97, 0xA6, 0xB6, 0xA7, 0xB7, 0xC4, 0xD4, 0xC5, 0xD5, 0xE4, 0xF4, 0xE5, 0xF5, 0xC6, 0xD6, 0xC7, 0xD7, 0xE6, 0xF6, 0xE7, 0xF7, 0x08, 0x18, 0x09, 0x19, 0x28, 0x38, 0x29, 0x39, 0x0A, 0x1A, 0x0B, 0x1B, 0x2A, 0x3A, 0x2B, 0x3B, 0x48, 0x58, 0x49, 0x59, 0x68, 0x78, 0x69, 0x79, 0x4A, 0x5A, 0x4B, 0x5B, 0x6A, 0x7A, 0x6B, 0x7B, 0x0C, 0x1C, 0x0D, 0x1D, 0x2C, 0x3C, 0x2D, 0x3D, 0x0E, 0x1E, 0x0F, 0x1F, 0x2E, 0x3E, 0x2F, 0x3F, 0x4C, 0x5C, 0x4D, 0x5D, 0x6C, 0x7C, 0x6D, 0x7D, 0x4E, 0x5E, 0x4F, 0x5F, 0x6E, 0x7E, 0x6F, 0x7F, 0x88, 0x98, 0x89, 0x99, 0xA8, 0xB8, 0xA9, 0xB9, 0x8A, 0x9A, 0x8B, 0x9B, 0xAA, 0xBA, 0xAB, 0xBB, 0xC8, 0xD8, 0xC9, 0xD9, 0xE8, 0xF8, 0xE9, 0xF9, 0xCA, 0xDA, 0xCB, 0xDB, 0xEA, 0xFA, 0xEB, 0xFB, 0x8C, 0x9C, 0x8D, 0x9D, 0xAC, 0xBC, 0xAD, 0xBD, 0x8E, 0x9E, 0x8F, 0x9F, 0xAE, 0xBE, 0xAF, 0xBF, 0xCC, 0xDC, 0xCD, 0xDD, 0xEC, 0xFC, 0xED, 0xFD, 0xCE, 0xDE, 0xCF, 0xDF, 0xEE, 0xFE, 0xEF, 0xFF ]; /** * Inverse IP mapping helper table. * Indexing this table with a byte value reverses the bit order. * * @var array */ protected static $invipmap = [ 0x00, 0x80, 0x40, 0xC0, 0x20, 0xA0, 0x60, 0xE0, 0x10, 0x90, 0x50, 0xD0, 0x30, 0xB0, 0x70, 0xF0, 0x08, 0x88, 0x48, 0xC8, 0x28, 0xA8, 0x68, 0xE8, 0x18, 0x98, 0x58, 0xD8, 0x38, 0xB8, 0x78, 0xF8, 0x04, 0x84, 0x44, 0xC4, 0x24, 0xA4, 0x64, 0xE4, 0x14, 0x94, 0x54, 0xD4, 0x34, 0xB4, 0x74, 0xF4, 0x0C, 0x8C, 0x4C, 0xCC, 0x2C, 0xAC, 0x6C, 0xEC, 0x1C, 0x9C, 0x5C, 0xDC, 0x3C, 0xBC, 0x7C, 0xFC, 0x02, 0x82, 0x42, 0xC2, 0x22, 0xA2, 0x62, 0xE2, 0x12, 0x92, 0x52, 0xD2, 0x32, 0xB2, 0x72, 0xF2, 0x0A, 0x8A, 0x4A, 0xCA, 0x2A, 0xAA, 0x6A, 0xEA, 0x1A, 0x9A, 0x5A, 0xDA, 0x3A, 0xBA, 0x7A, 0xFA, 0x06, 0x86, 0x46, 0xC6, 0x26, 0xA6, 0x66, 0xE6, 0x16, 0x96, 0x56, 0xD6, 0x36, 0xB6, 0x76, 0xF6, 0x0E, 0x8E, 0x4E, 0xCE, 0x2E, 0xAE, 0x6E, 0xEE, 0x1E, 0x9E, 0x5E, 0xDE, 0x3E, 0xBE, 0x7E, 0xFE, 0x01, 0x81, 0x41, 0xC1, 0x21, 0xA1, 0x61, 0xE1, 0x11, 0x91, 0x51, 0xD1, 0x31, 0xB1, 0x71, 0xF1, 0x09, 0x89, 0x49, 0xC9, 0x29, 0xA9, 0x69, 0xE9, 0x19, 0x99, 0x59, 0xD9, 0x39, 0xB9, 0x79, 0xF9, 0x05, 0x85, 0x45, 0xC5, 0x25, 0xA5, 0x65, 0xE5, 0x15, 0x95, 0x55, 0xD5, 0x35, 0xB5, 0x75, 0xF5, 0x0D, 0x8D, 0x4D, 0xCD, 0x2D, 0xAD, 0x6D, 0xED, 0x1D, 0x9D, 0x5D, 0xDD, 0x3D, 0xBD, 0x7D, 0xFD, 0x03, 0x83, 0x43, 0xC3, 0x23, 0xA3, 0x63, 0xE3, 0x13, 0x93, 0x53, 0xD3, 0x33, 0xB3, 0x73, 0xF3, 0x0B, 0x8B, 0x4B, 0xCB, 0x2B, 0xAB, 0x6B, 0xEB, 0x1B, 0x9B, 0x5B, 0xDB, 0x3B, 0xBB, 0x7B, 0xFB, 0x07, 0x87, 0x47, 0xC7, 0x27, 0xA7, 0x67, 0xE7, 0x17, 0x97, 0x57, 0xD7, 0x37, 0xB7, 0x77, 0xF7, 0x0F, 0x8F, 0x4F, 0xCF, 0x2F, 0xAF, 0x6F, 0xEF, 0x1F, 0x9F, 0x5F, 0xDF, 0x3F, 0xBF, 0x7F, 0xFF ]; /** * Pre-permuted S-box1 * * Each box ($sbox1-$sbox8) has been vectorized, then each value pre-permuted using the * P table: concatenation can then be replaced by exclusive ORs. * * @var array */ protected static $sbox1 = [ 0x00808200, 0x00000000, 0x00008000, 0x00808202, 0x00808002, 0x00008202, 0x00000002, 0x00008000, 0x00000200, 0x00808200, 0x00808202, 0x00000200, 0x00800202, 0x00808002, 0x00800000, 0x00000002, 0x00000202, 0x00800200, 0x00800200, 0x00008200, 0x00008200, 0x00808000, 0x00808000, 0x00800202, 0x00008002, 0x00800002, 0x00800002, 0x00008002, 0x00000000, 0x00000202, 0x00008202, 0x00800000, 0x00008000, 0x00808202, 0x00000002, 0x00808000, 0x00808200, 0x00800000, 0x00800000, 0x00000200, 0x00808002, 0x00008000, 0x00008200, 0x00800002, 0x00000200, 0x00000002, 0x00800202, 0x00008202, 0x00808202, 0x00008002, 0x00808000, 0x00800202, 0x00800002, 0x00000202, 0x00008202, 0x00808200, 0x00000202, 0x00800200, 0x00800200, 0x00000000, 0x00008002, 0x00008200, 0x00000000, 0x00808002 ]; /** * Pre-permuted S-box2 * * @var array */ protected static $sbox2 = [ 0x40084010, 0x40004000, 0x00004000, 0x00084010, 0x00080000, 0x00000010, 0x40080010, 0x40004010, 0x40000010, 0x40084010, 0x40084000, 0x40000000, 0x40004000, 0x00080000, 0x00000010, 0x40080010, 0x00084000, 0x00080010, 0x40004010, 0x00000000, 0x40000000, 0x00004000, 0x00084010, 0x40080000, 0x00080010, 0x40000010, 0x00000000, 0x00084000, 0x00004010, 0x40084000, 0x40080000, 0x00004010, 0x00000000, 0x00084010, 0x40080010, 0x00080000, 0x40004010, 0x40080000, 0x40084000, 0x00004000, 0x40080000, 0x40004000, 0x00000010, 0x40084010, 0x00084010, 0x00000010, 0x00004000, 0x40000000, 0x00004010, 0x40084000, 0x00080000, 0x40000010, 0x00080010, 0x40004010, 0x40000010, 0x00080010, 0x00084000, 0x00000000, 0x40004000, 0x00004010, 0x40000000, 0x40080010, 0x40084010, 0x00084000 ]; /** * Pre-permuted S-box3 * * @var array */ protected static $sbox3 = [ 0x00000104, 0x04010100, 0x00000000, 0x04010004, 0x04000100, 0x00000000, 0x00010104, 0x04000100, 0x00010004, 0x04000004, 0x04000004, 0x00010000, 0x04010104, 0x00010004, 0x04010000, 0x00000104, 0x04000000, 0x00000004, 0x04010100, 0x00000100, 0x00010100, 0x04010000, 0x04010004, 0x00010104, 0x04000104, 0x00010100, 0x00010000, 0x04000104, 0x00000004, 0x04010104, 0x00000100, 0x04000000, 0x04010100, 0x04000000, 0x00010004, 0x00000104, 0x00010000, 0x04010100, 0x04000100, 0x00000000, 0x00000100, 0x00010004, 0x04010104, 0x04000100, 0x04000004, 0x00000100, 0x00000000, 0x04010004, 0x04000104, 0x00010000, 0x04000000, 0x04010104, 0x00000004, 0x00010104, 0x00010100, 0x04000004, 0x04010000, 0x04000104, 0x00000104, 0x04010000, 0x00010104, 0x00000004, 0x04010004, 0x00010100 ]; /** * Pre-permuted S-box4 * * @var array */ protected static $sbox4 = [ 0x80401000, 0x80001040, 0x80001040, 0x00000040, 0x00401040, 0x80400040, 0x80400000, 0x80001000, 0x00000000, 0x00401000, 0x00401000, 0x80401040, 0x80000040, 0x00000000, 0x00400040, 0x80400000, 0x80000000, 0x00001000, 0x00400000, 0x80401000, 0x00000040, 0x00400000, 0x80001000, 0x00001040, 0x80400040, 0x80000000, 0x00001040, 0x00400040, 0x00001000, 0x00401040, 0x80401040, 0x80000040, 0x00400040, 0x80400000, 0x00401000, 0x80401040, 0x80000040, 0x00000000, 0x00000000, 0x00401000, 0x00001040, 0x00400040, 0x80400040, 0x80000000, 0x80401000, 0x80001040, 0x80001040, 0x00000040, 0x80401040, 0x80000040, 0x80000000, 0x00001000, 0x80400000, 0x80001000, 0x00401040, 0x80400040, 0x80001000, 0x00001040, 0x00400000, 0x80401000, 0x00000040, 0x00400000, 0x00001000, 0x00401040 ]; /** * Pre-permuted S-box5 * * @var array */ protected static $sbox5 = [ 0x00000080, 0x01040080, 0x01040000, 0x21000080, 0x00040000, 0x00000080, 0x20000000, 0x01040000, 0x20040080, 0x00040000, 0x01000080, 0x20040080, 0x21000080, 0x21040000, 0x00040080, 0x20000000, 0x01000000, 0x20040000, 0x20040000, 0x00000000, 0x20000080, 0x21040080, 0x21040080, 0x01000080, 0x21040000, 0x20000080, 0x00000000, 0x21000000, 0x01040080, 0x01000000, 0x21000000, 0x00040080, 0x00040000, 0x21000080, 0x00000080, 0x01000000, 0x20000000, 0x01040000, 0x21000080, 0x20040080, 0x01000080, 0x20000000, 0x21040000, 0x01040080, 0x20040080, 0x00000080, 0x01000000, 0x21040000, 0x21040080, 0x00040080, 0x21000000, 0x21040080, 0x01040000, 0x00000000, 0x20040000, 0x21000000, 0x00040080, 0x01000080, 0x20000080, 0x00040000, 0x00000000, 0x20040000, 0x01040080, 0x20000080 ]; /** * Pre-permuted S-box6 * * @var array */ protected static $sbox6 = [ 0x10000008, 0x10200000, 0x00002000, 0x10202008, 0x10200000, 0x00000008, 0x10202008, 0x00200000, 0x10002000, 0x00202008, 0x00200000, 0x10000008, 0x00200008, 0x10002000, 0x10000000, 0x00002008, 0x00000000, 0x00200008, 0x10002008, 0x00002000, 0x00202000, 0x10002008, 0x00000008, 0x10200008, 0x10200008, 0x00000000, 0x00202008, 0x10202000, 0x00002008, 0x00202000, 0x10202000, 0x10000000, 0x10002000, 0x00000008, 0x10200008, 0x00202000, 0x10202008, 0x00200000, 0x00002008, 0x10000008, 0x00200000, 0x10002000, 0x10000000, 0x00002008, 0x10000008, 0x10202008, 0x00202000, 0x10200000, 0x00202008, 0x10202000, 0x00000000, 0x10200008, 0x00000008, 0x00002000, 0x10200000, 0x00202008, 0x00002000, 0x00200008, 0x10002008, 0x00000000, 0x10202000, 0x10000000, 0x00200008, 0x10002008 ]; /** * Pre-permuted S-box7 * * @var array */ protected static $sbox7 = [ 0x00100000, 0x02100001, 0x02000401, 0x00000000, 0x00000400, 0x02000401, 0x00100401, 0x02100400, 0x02100401, 0x00100000, 0x00000000, 0x02000001, 0x00000001, 0x02000000, 0x02100001, 0x00000401, 0x02000400, 0x00100401, 0x00100001, 0x02000400, 0x02000001, 0x02100000, 0x02100400, 0x00100001, 0x02100000, 0x00000400, 0x00000401, 0x02100401, 0x00100400, 0x00000001, 0x02000000, 0x00100400, 0x02000000, 0x00100400, 0x00100000, 0x02000401, 0x02000401, 0x02100001, 0x02100001, 0x00000001, 0x00100001, 0x02000000, 0x02000400, 0x00100000, 0x02100400, 0x00000401, 0x00100401, 0x02100400, 0x00000401, 0x02000001, 0x02100401, 0x02100000, 0x00100400, 0x00000000, 0x00000001, 0x02100401, 0x00000000, 0x00100401, 0x02100000, 0x00000400, 0x02000001, 0x02000400, 0x00000400, 0x00100001 ]; /** * Pre-permuted S-box8 * * @var array */ protected static $sbox8 = [ 0x08000820, 0x00000800, 0x00020000, 0x08020820, 0x08000000, 0x08000820, 0x00000020, 0x08000000, 0x00020020, 0x08020000, 0x08020820, 0x00020800, 0x08020800, 0x00020820, 0x00000800, 0x00000020, 0x08020000, 0x08000020, 0x08000800, 0x00000820, 0x00020800, 0x00020020, 0x08020020, 0x08020800, 0x00000820, 0x00000000, 0x00000000, 0x08020020, 0x08000020, 0x08000800, 0x00020820, 0x00020000, 0x00020820, 0x00020000, 0x08020800, 0x00000800, 0x00000020, 0x08020020, 0x00000800, 0x00020820, 0x08000800, 0x00000020, 0x08000020, 0x08020000, 0x08020020, 0x08000000, 0x00020000, 0x08000820, 0x00000000, 0x08020820, 0x00020020, 0x08000020, 0x08020000, 0x08000800, 0x08000820, 0x00000000, 0x08020820, 0x00020800, 0x00020800, 0x00000820, 0x00000820, 0x00020020, 0x08000000, 0x08020800 ]; /** * Default Constructor. * * @param string $mode * @throws BadModeException if an invalid / unsupported mode is provided */ public function __construct($mode) { parent::__construct($mode); if ($this->mode == self::MODE_STREAM) { throw new BadModeException('Block ciphers cannot be ran in stream mode'); } } /** * Test for engine validity * * This is mainly just a wrapper to set things up for \phpseclib3\Crypt\Common\SymmetricKey::isValidEngine() * * @see \phpseclib3\Crypt\Common\SymmetricKey::isValidEngine() * @param int $engine * @return bool */ protected function isValidEngineHelper($engine) { if ($this->key_length_max == 8) { if ($engine == self::ENGINE_OPENSSL) { // quoting https://www.openssl.org/news/openssl-3.0-notes.html, OpenSSL 3.0.1 // "Moved all variations of the EVP ciphers CAST5, BF, IDEA, SEED, RC2, RC4, RC5, and DES to the legacy provider" // in theory openssl_get_cipher_methods() should catch this but, on GitHub Actions, at least, it does not if (version_compare(preg_replace('#OpenSSL (\d+\.\d+\.\d+) .*#', '$1', OPENSSL_VERSION_TEXT), '3.0.1', '>=')) { return false; } $this->cipher_name_openssl_ecb = 'des-ecb'; $this->cipher_name_openssl = 'des-' . $this->openssl_translate_mode(); } } return parent::isValidEngineHelper($engine); } /** * Sets the key. * * Keys must be 64-bits long or 8 bytes long. * * DES also requires that every eighth bit be a parity bit, however, we'll ignore that. * * @see \phpseclib3\Crypt\Common\SymmetricKey::setKey() * @param string $key */ public function setKey($key) { if (!($this instanceof TripleDES) && strlen($key) != 8) { throw new \LengthException('Key of size ' . strlen($key) . ' not supported by this algorithm. Only keys of size 8 are supported'); } // Sets the key parent::setKey($key); } /** * Encrypts a block * * @see \phpseclib3\Crypt\Common\SymmetricKey::encryptBlock() * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @see self::encrypt() * @param string $in * @return string */ protected function encryptBlock($in) { return $this->processBlock($in, self::ENCRYPT); } /** * Decrypts a block * * @see \phpseclib3\Crypt\Common\SymmetricKey::decryptBlock() * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() * @see self::decrypt() * @param string $in * @return string */ protected function decryptBlock($in) { return $this->processBlock($in, self::DECRYPT); } /** * Encrypts or decrypts a 64-bit block * * $mode should be either self::ENCRYPT or self::DECRYPT. See * {@link http://en.wikipedia.org/wiki/Image:Feistel.png Feistel.png} to get a general * idea of what this function does. * * @see self::encryptBlock() * @see self::decryptBlock() * @param string $block * @param int $mode * @return string */ private function processBlock($block, $mode) { static $sbox1, $sbox2, $sbox3, $sbox4, $sbox5, $sbox6, $sbox7, $sbox8, $shuffleip, $shuffleinvip; if (!$sbox1) { $sbox1 = array_map('intval', self::$sbox1); $sbox2 = array_map('intval', self::$sbox2); $sbox3 = array_map('intval', self::$sbox3); $sbox4 = array_map('intval', self::$sbox4); $sbox5 = array_map('intval', self::$sbox5); $sbox6 = array_map('intval', self::$sbox6); $sbox7 = array_map('intval', self::$sbox7); $sbox8 = array_map('intval', self::$sbox8); /* Merge $shuffle with $[inv]ipmap */ for ($i = 0; $i < 256; ++$i) { $shuffleip[] = self::$shuffle[self::$ipmap[$i]]; $shuffleinvip[] = self::$shuffle[self::$invipmap[$i]]; } } $keys = $this->keys[$mode]; $ki = -1; // Do the initial IP permutation. $t = unpack('Nl/Nr', $block); list($l, $r) = [$t['l'], $t['r']]; $block = ($shuffleip[ $r & 0xFF] & "\x80\x80\x80\x80\x80\x80\x80\x80") | ($shuffleip[($r >> 8) & 0xFF] & "\x40\x40\x40\x40\x40\x40\x40\x40") | ($shuffleip[($r >> 16) & 0xFF] & "\x20\x20\x20\x20\x20\x20\x20\x20") | ($shuffleip[($r >> 24) & 0xFF] & "\x10\x10\x10\x10\x10\x10\x10\x10") | ($shuffleip[ $l & 0xFF] & "\x08\x08\x08\x08\x08\x08\x08\x08") | ($shuffleip[($l >> 8) & 0xFF] & "\x04\x04\x04\x04\x04\x04\x04\x04") | ($shuffleip[($l >> 16) & 0xFF] & "\x02\x02\x02\x02\x02\x02\x02\x02") | ($shuffleip[($l >> 24) & 0xFF] & "\x01\x01\x01\x01\x01\x01\x01\x01"); // Extract L0 and R0. $t = unpack('Nl/Nr', $block); list($l, $r) = [$t['l'], $t['r']]; for ($des_round = 0; $des_round < $this->des_rounds; ++$des_round) { // Perform the 16 steps. for ($i = 0; $i < 16; $i++) { // start of "the Feistel (F) function" - see the following URL: // http://en.wikipedia.org/wiki/Image:Data_Encryption_Standard_InfoBox_Diagram.png // Merge key schedule. $b1 = (($r >> 3) & 0x1FFFFFFF) ^ ($r << 29) ^ $keys[++$ki]; $b2 = (($r >> 31) & 0x00000001) ^ ($r << 1) ^ $keys[++$ki]; // S-box indexing. $t = $sbox1[($b1 >> 24) & 0x3F] ^ $sbox2[($b2 >> 24) & 0x3F] ^ $sbox3[($b1 >> 16) & 0x3F] ^ $sbox4[($b2 >> 16) & 0x3F] ^ $sbox5[($b1 >> 8) & 0x3F] ^ $sbox6[($b2 >> 8) & 0x3F] ^ $sbox7[ $b1 & 0x3F] ^ $sbox8[ $b2 & 0x3F] ^ $l; // end of "the Feistel (F) function" $l = $r; $r = $t; } // Last step should not permute L & R. $t = $l; $l = $r; $r = $t; } // Perform the inverse IP permutation. return ($shuffleinvip[($r >> 24) & 0xFF] & "\x80\x80\x80\x80\x80\x80\x80\x80") | ($shuffleinvip[($l >> 24) & 0xFF] & "\x40\x40\x40\x40\x40\x40\x40\x40") | ($shuffleinvip[($r >> 16) & 0xFF] & "\x20\x20\x20\x20\x20\x20\x20\x20") | ($shuffleinvip[($l >> 16) & 0xFF] & "\x10\x10\x10\x10\x10\x10\x10\x10") | ($shuffleinvip[($r >> 8) & 0xFF] & "\x08\x08\x08\x08\x08\x08\x08\x08") | ($shuffleinvip[($l >> 8) & 0xFF] & "\x04\x04\x04\x04\x04\x04\x04\x04") | ($shuffleinvip[ $r & 0xFF] & "\x02\x02\x02\x02\x02\x02\x02\x02") | ($shuffleinvip[ $l & 0xFF] & "\x01\x01\x01\x01\x01\x01\x01\x01"); } /** * Creates the key schedule * * @see \phpseclib3\Crypt\Common\SymmetricKey::setupKey() */ protected function setupKey() { if (isset($this->kl['key']) && $this->key === $this->kl['key'] && $this->des_rounds === $this->kl['des_rounds']) { // already expanded return; } $this->kl = ['key' => $this->key, 'des_rounds' => $this->des_rounds]; static $shifts = [ // number of key bits shifted per round 1, 1, 2, 2, 2, 2, 2, 2, 1, 2, 2, 2, 2, 2, 2, 1 ]; static $pc1map = [ 0x00, 0x00, 0x08, 0x08, 0x04, 0x04, 0x0C, 0x0C, 0x02, 0x02, 0x0A, 0x0A, 0x06, 0x06, 0x0E, 0x0E, 0x10, 0x10, 0x18, 0x18, 0x14, 0x14, 0x1C, 0x1C, 0x12, 0x12, 0x1A, 0x1A, 0x16, 0x16, 0x1E, 0x1E, 0x20, 0x20, 0x28, 0x28, 0x24, 0x24, 0x2C, 0x2C, 0x22, 0x22, 0x2A, 0x2A, 0x26, 0x26, 0x2E, 0x2E, 0x30, 0x30, 0x38, 0x38, 0x34, 0x34, 0x3C, 0x3C, 0x32, 0x32, 0x3A, 0x3A, 0x36, 0x36, 0x3E, 0x3E, 0x40, 0x40, 0x48, 0x48, 0x44, 0x44, 0x4C, 0x4C, 0x42, 0x42, 0x4A, 0x4A, 0x46, 0x46, 0x4E, 0x4E, 0x50, 0x50, 0x58, 0x58, 0x54, 0x54, 0x5C, 0x5C, 0x52, 0x52, 0x5A, 0x5A, 0x56, 0x56, 0x5E, 0x5E, 0x60, 0x60, 0x68, 0x68, 0x64, 0x64, 0x6C, 0x6C, 0x62, 0x62, 0x6A, 0x6A, 0x66, 0x66, 0x6E, 0x6E, 0x70, 0x70, 0x78, 0x78, 0x74, 0x74, 0x7C, 0x7C, 0x72, 0x72, 0x7A, 0x7A, 0x76, 0x76, 0x7E, 0x7E, 0x80, 0x80, 0x88, 0x88, 0x84, 0x84, 0x8C, 0x8C, 0x82, 0x82, 0x8A, 0x8A, 0x86, 0x86, 0x8E, 0x8E, 0x90, 0x90, 0x98, 0x98, 0x94, 0x94, 0x9C, 0x9C, 0x92, 0x92, 0x9A, 0x9A, 0x96, 0x96, 0x9E, 0x9E, 0xA0, 0xA0, 0xA8, 0xA8, 0xA4, 0xA4, 0xAC, 0xAC, 0xA2, 0xA2, 0xAA, 0xAA, 0xA6, 0xA6, 0xAE, 0xAE, 0xB0, 0xB0, 0xB8, 0xB8, 0xB4, 0xB4, 0xBC, 0xBC, 0xB2, 0xB2, 0xBA, 0xBA, 0xB6, 0xB6, 0xBE, 0xBE, 0xC0, 0xC0, 0xC8, 0xC8, 0xC4, 0xC4, 0xCC, 0xCC, 0xC2, 0xC2, 0xCA, 0xCA, 0xC6, 0xC6, 0xCE, 0xCE, 0xD0, 0xD0, 0xD8, 0xD8, 0xD4, 0xD4, 0xDC, 0xDC, 0xD2, 0xD2, 0xDA, 0xDA, 0xD6, 0xD6, 0xDE, 0xDE, 0xE0, 0xE0, 0xE8, 0xE8, 0xE4, 0xE4, 0xEC, 0xEC, 0xE2, 0xE2, 0xEA, 0xEA, 0xE6, 0xE6, 0xEE, 0xEE, 0xF0, 0xF0, 0xF8, 0xF8, 0xF4, 0xF4, 0xFC, 0xFC, 0xF2, 0xF2, 0xFA, 0xFA, 0xF6, 0xF6, 0xFE, 0xFE ]; // Mapping tables for the PC-2 transformation. static $pc2mapc1 = [ 0x00000000, 0x00000400, 0x00200000, 0x00200400, 0x00000001, 0x00000401, 0x00200001, 0x00200401, 0x02000000, 0x02000400, 0x02200000, 0x02200400, 0x02000001, 0x02000401, 0x02200001, 0x02200401 ]; static $pc2mapc2 = [ 0x00000000, 0x00000800, 0x08000000, 0x08000800, 0x00010000, 0x00010800, 0x08010000, 0x08010800, 0x00000000, 0x00000800, 0x08000000, 0x08000800, 0x00010000, 0x00010800, 0x08010000, 0x08010800, 0x00000100, 0x00000900, 0x08000100, 0x08000900, 0x00010100, 0x00010900, 0x08010100, 0x08010900, 0x00000100, 0x00000900, 0x08000100, 0x08000900, 0x00010100, 0x00010900, 0x08010100, 0x08010900, 0x00000010, 0x00000810, 0x08000010, 0x08000810, 0x00010010, 0x00010810, 0x08010010, 0x08010810, 0x00000010, 0x00000810, 0x08000010, 0x08000810, 0x00010010, 0x00010810, 0x08010010, 0x08010810, 0x00000110, 0x00000910, 0x08000110, 0x08000910, 0x00010110, 0x00010910, 0x08010110, 0x08010910, 0x00000110, 0x00000910, 0x08000110, 0x08000910, 0x00010110, 0x00010910, 0x08010110, 0x08010910, 0x00040000, 0x00040800, 0x08040000, 0x08040800, 0x00050000, 0x00050800, 0x08050000, 0x08050800, 0x00040000, 0x00040800, 0x08040000, 0x08040800, 0x00050000, 0x00050800, 0x08050000, 0x08050800, 0x00040100, 0x00040900, 0x08040100, 0x08040900, 0x00050100, 0x00050900, 0x08050100, 0x08050900, 0x00040100, 0x00040900, 0x08040100, 0x08040900, 0x00050100, 0x00050900, 0x08050100, 0x08050900, 0x00040010, 0x00040810, 0x08040010, 0x08040810, 0x00050010, 0x00050810, 0x08050010, 0x08050810, 0x00040010, 0x00040810, 0x08040010, 0x08040810, 0x00050010, 0x00050810, 0x08050010, 0x08050810, 0x00040110, 0x00040910, 0x08040110, 0x08040910, 0x00050110, 0x00050910, 0x08050110, 0x08050910, 0x00040110, 0x00040910, 0x08040110, 0x08040910, 0x00050110, 0x00050910, 0x08050110, 0x08050910, 0x01000000, 0x01000800, 0x09000000, 0x09000800, 0x01010000, 0x01010800, 0x09010000, 0x09010800, 0x01000000, 0x01000800, 0x09000000, 0x09000800, 0x01010000, 0x01010800, 0x09010000, 0x09010800, 0x01000100, 0x01000900, 0x09000100, 0x09000900, 0x01010100, 0x01010900, 0x09010100, 0x09010900, 0x01000100, 0x01000900, 0x09000100, 0x09000900, 0x01010100, 0x01010900, 0x09010100, 0x09010900, 0x01000010, 0x01000810, 0x09000010, 0x09000810, 0x01010010, 0x01010810, 0x09010010, 0x09010810, 0x01000010, 0x01000810, 0x09000010, 0x09000810, 0x01010010, 0x01010810, 0x09010010, 0x09010810, 0x01000110, 0x01000910, 0x09000110, 0x09000910, 0x01010110, 0x01010910, 0x09010110, 0x09010910, 0x01000110, 0x01000910, 0x09000110, 0x09000910, 0x01010110, 0x01010910, 0x09010110, 0x09010910, 0x01040000, 0x01040800, 0x09040000, 0x09040800, 0x01050000, 0x01050800, 0x09050000, 0x09050800, 0x01040000, 0x01040800, 0x09040000, 0x09040800, 0x01050000, 0x01050800, 0x09050000, 0x09050800, 0x01040100, 0x01040900, 0x09040100, 0x09040900, 0x01050100, 0x01050900, 0x09050100, 0x09050900, 0x01040100, 0x01040900, 0x09040100, 0x09040900, 0x01050100, 0x01050900, 0x09050100, 0x09050900, 0x01040010, 0x01040810, 0x09040010, 0x09040810, 0x01050010, 0x01050810, 0x09050010, 0x09050810, 0x01040010, 0x01040810, 0x09040010, 0x09040810, 0x01050010, 0x01050810, 0x09050010, 0x09050810, 0x01040110, 0x01040910, 0x09040110, 0x09040910, 0x01050110, 0x01050910, 0x09050110, 0x09050910, 0x01040110, 0x01040910, 0x09040110, 0x09040910, 0x01050110, 0x01050910, 0x09050110, 0x09050910 ]; static $pc2mapc3 = [ 0x00000000, 0x00000004, 0x00001000, 0x00001004, 0x00000000, 0x00000004, 0x00001000, 0x00001004, 0x10000000, 0x10000004, 0x10001000, 0x10001004, 0x10000000, 0x10000004, 0x10001000, 0x10001004, 0x00000020, 0x00000024, 0x00001020, 0x00001024, 0x00000020, 0x00000024, 0x00001020, 0x00001024, 0x10000020, 0x10000024, 0x10001020, 0x10001024, 0x10000020, 0x10000024, 0x10001020, 0x10001024, 0x00080000, 0x00080004, 0x00081000, 0x00081004, 0x00080000, 0x00080004, 0x00081000, 0x00081004, 0x10080000, 0x10080004, 0x10081000, 0x10081004, 0x10080000, 0x10080004, 0x10081000, 0x10081004, 0x00080020, 0x00080024, 0x00081020, 0x00081024, 0x00080020, 0x00080024, 0x00081020, 0x00081024, 0x10080020, 0x10080024, 0x10081020, 0x10081024, 0x10080020, 0x10080024, 0x10081020, 0x10081024, 0x20000000, 0x20000004, 0x20001000, 0x20001004, 0x20000000, 0x20000004, 0x20001000, 0x20001004, 0x30000000, 0x30000004, 0x30001000, 0x30001004, 0x30000000, 0x30000004, 0x30001000, 0x30001004, 0x20000020, 0x20000024, 0x20001020, 0x20001024, 0x20000020, 0x20000024, 0x20001020, 0x20001024, 0x30000020, 0x30000024, 0x30001020, 0x30001024, 0x30000020, 0x30000024, 0x30001020, 0x30001024, 0x20080000, 0x20080004, 0x20081000, 0x20081004, 0x20080000, 0x20080004, 0x20081000, 0x20081004, 0x30080000, 0x30080004, 0x30081000, 0x30081004, 0x30080000, 0x30080004, 0x30081000, 0x30081004, 0x20080020, 0x20080024, 0x20081020, 0x20081024, 0x20080020, 0x20080024, 0x20081020, 0x20081024, 0x30080020, 0x30080024, 0x30081020, 0x30081024, 0x30080020, 0x30080024, 0x30081020, 0x30081024, 0x00000002, 0x00000006, 0x00001002, 0x00001006, 0x00000002, 0x00000006, 0x00001002, 0x00001006, 0x10000002, 0x10000006, 0x10001002, 0x10001006, 0x10000002, 0x10000006, 0x10001002, 0x10001006, 0x00000022, 0x00000026, 0x00001022, 0x00001026, 0x00000022, 0x00000026, 0x00001022, 0x00001026, 0x10000022, 0x10000026, 0x10001022, 0x10001026, 0x10000022, 0x10000026, 0x10001022, 0x10001026, 0x00080002, 0x00080006, 0x00081002, 0x00081006, 0x00080002, 0x00080006, 0x00081002, 0x00081006, 0x10080002, 0x10080006, 0x10081002, 0x10081006, 0x10080002, 0x10080006, 0x10081002, 0x10081006, 0x00080022, 0x00080026, 0x00081022, 0x00081026, 0x00080022, 0x00080026, 0x00081022, 0x00081026, 0x10080022, 0x10080026, 0x10081022, 0x10081026, 0x10080022, 0x10080026, 0x10081022, 0x10081026, 0x20000002, 0x20000006, 0x20001002, 0x20001006, 0x20000002, 0x20000006, 0x20001002, 0x20001006, 0x30000002, 0x30000006, 0x30001002, 0x30001006, 0x30000002, 0x30000006, 0x30001002, 0x30001006, 0x20000022, 0x20000026, 0x20001022, 0x20001026, 0x20000022, 0x20000026, 0x20001022, 0x20001026, 0x30000022, 0x30000026, 0x30001022, 0x30001026, 0x30000022, 0x30000026, 0x30001022, 0x30001026, 0x20080002, 0x20080006, 0x20081002, 0x20081006, 0x20080002, 0x20080006, 0x20081002, 0x20081006, 0x30080002, 0x30080006, 0x30081002, 0x30081006, 0x30080002, 0x30080006, 0x30081002, 0x30081006, 0x20080022, 0x20080026, 0x20081022, 0x20081026, 0x20080022, 0x20080026, 0x20081022, 0x20081026, 0x30080022, 0x30080026, 0x30081022, 0x30081026, 0x30080022, 0x30080026, 0x30081022, 0x30081026 ]; static $pc2mapc4 = [ 0x00000000, 0x00100000, 0x00000008, 0x00100008, 0x00000200, 0x00100200, 0x00000208, 0x00100208, 0x00000000, 0x00100000, 0x00000008, 0x00100008, 0x00000200, 0x00100200, 0x00000208, 0x00100208, 0x04000000, 0x04100000, 0x04000008, 0x04100008, 0x04000200, 0x04100200, 0x04000208, 0x04100208, 0x04000000, 0x04100000, 0x04000008, 0x04100008, 0x04000200, 0x04100200, 0x04000208, 0x04100208, 0x00002000, 0x00102000, 0x00002008, 0x00102008, 0x00002200, 0x00102200, 0x00002208, 0x00102208, 0x00002000, 0x00102000, 0x00002008, 0x00102008, 0x00002200, 0x00102200, 0x00002208, 0x00102208, 0x04002000, 0x04102000, 0x04002008, 0x04102008, 0x04002200, 0x04102200, 0x04002208, 0x04102208, 0x04002000, 0x04102000, 0x04002008, 0x04102008, 0x04002200, 0x04102200, 0x04002208, 0x04102208, 0x00000000, 0x00100000, 0x00000008, 0x00100008, 0x00000200, 0x00100200, 0x00000208, 0x00100208, 0x00000000, 0x00100000, 0x00000008, 0x00100008, 0x00000200, 0x00100200, 0x00000208, 0x00100208, 0x04000000, 0x04100000, 0x04000008, 0x04100008, 0x04000200, 0x04100200, 0x04000208, 0x04100208, 0x04000000, 0x04100000, 0x04000008, 0x04100008, 0x04000200, 0x04100200, 0x04000208, 0x04100208, 0x00002000, 0x00102000, 0x00002008, 0x00102008, 0x00002200, 0x00102200, 0x00002208, 0x00102208, 0x00002000, 0x00102000, 0x00002008, 0x00102008, 0x00002200, 0x00102200, 0x00002208, 0x00102208, 0x04002000, 0x04102000, 0x04002008, 0x04102008, 0x04002200, 0x04102200, 0x04002208, 0x04102208, 0x04002000, 0x04102000, 0x04002008, 0x04102008, 0x04002200, 0x04102200, 0x04002208, 0x04102208, 0x00020000, 0x00120000, 0x00020008, 0x00120008, 0x00020200, 0x00120200, 0x00020208, 0x00120208, 0x00020000, 0x00120000, 0x00020008, 0x00120008, 0x00020200, 0x00120200, 0x00020208, 0x00120208, 0x04020000, 0x04120000, 0x04020008, 0x04120008, 0x04020200, 0x04120200, 0x04020208, 0x04120208, 0x04020000, 0x04120000, 0x04020008, 0x04120008, 0x04020200, 0x04120200, 0x04020208, 0x04120208, 0x00022000, 0x00122000, 0x00022008, 0x00122008, 0x00022200, 0x00122200, 0x00022208, 0x00122208, 0x00022000, 0x00122000, 0x00022008, 0x00122008, 0x00022200, 0x00122200, 0x00022208, 0x00122208, 0x04022000, 0x04122000, 0x04022008, 0x04122008, 0x04022200, 0x04122200, 0x04022208, 0x04122208, 0x04022000, 0x04122000, 0x04022008, 0x04122008, 0x04022200, 0x04122200, 0x04022208, 0x04122208, 0x00020000, 0x00120000, 0x00020008, 0x00120008, 0x00020200, 0x00120200, 0x00020208, 0x00120208, 0x00020000, 0x00120000, 0x00020008, 0x00120008, 0x00020200, 0x00120200, 0x00020208, 0x00120208, 0x04020000, 0x04120000, 0x04020008, 0x04120008, 0x04020200, 0x04120200, 0x04020208, 0x04120208, 0x04020000, 0x04120000, 0x04020008, 0x04120008, 0x04020200, 0x04120200, 0x04020208, 0x04120208, 0x00022000, 0x00122000, 0x00022008, 0x00122008, 0x00022200, 0x00122200, 0x00022208, 0x00122208, 0x00022000, 0x00122000, 0x00022008, 0x00122008, 0x00022200, 0x00122200, 0x00022208, 0x00122208, 0x04022000, 0x04122000, 0x04022008, 0x04122008, 0x04022200, 0x04122200, 0x04022208, 0x04122208, 0x04022000, 0x04122000, 0x04022008, 0x04122008, 0x04022200, 0x04122200, 0x04022208, 0x04122208 ]; static $pc2mapd1 = [ 0x00000000, 0x00000001, 0x08000000, 0x08000001, 0x00200000, 0x00200001, 0x08200000, 0x08200001, 0x00000002, 0x00000003, 0x08000002, 0x08000003, 0x00200002, 0x00200003, 0x08200002, 0x08200003 ]; static $pc2mapd2 = [ 0x00000000, 0x00100000, 0x00000800, 0x00100800, 0x00000000, 0x00100000, 0x00000800, 0x00100800, 0x04000000, 0x04100000, 0x04000800, 0x04100800, 0x04000000, 0x04100000, 0x04000800, 0x04100800, 0x00000004, 0x00100004, 0x00000804, 0x00100804, 0x00000004, 0x00100004, 0x00000804, 0x00100804, 0x04000004, 0x04100004, 0x04000804, 0x04100804, 0x04000004, 0x04100004, 0x04000804, 0x04100804, 0x00000000, 0x00100000, 0x00000800, 0x00100800, 0x00000000, 0x00100000, 0x00000800, 0x00100800, 0x04000000, 0x04100000, 0x04000800, 0x04100800, 0x04000000, 0x04100000, 0x04000800, 0x04100800, 0x00000004, 0x00100004, 0x00000804, 0x00100804, 0x00000004, 0x00100004, 0x00000804, 0x00100804, 0x04000004, 0x04100004, 0x04000804, 0x04100804, 0x04000004, 0x04100004, 0x04000804, 0x04100804, 0x00000200, 0x00100200, 0x00000A00, 0x00100A00, 0x00000200, 0x00100200, 0x00000A00, 0x00100A00, 0x04000200, 0x04100200, 0x04000A00, 0x04100A00, 0x04000200, 0x04100200, 0x04000A00, 0x04100A00, 0x00000204, 0x00100204, 0x00000A04, 0x00100A04, 0x00000204, 0x00100204, 0x00000A04, 0x00100A04, 0x04000204, 0x04100204, 0x04000A04, 0x04100A04, 0x04000204, 0x04100204, 0x04000A04, 0x04100A04, 0x00000200, 0x00100200, 0x00000A00, 0x00100A00, 0x00000200, 0x00100200, 0x00000A00, 0x00100A00, 0x04000200, 0x04100200, 0x04000A00, 0x04100A00, 0x04000200, 0x04100200, 0x04000A00, 0x04100A00, 0x00000204, 0x00100204, 0x00000A04, 0x00100A04, 0x00000204, 0x00100204, 0x00000A04, 0x00100A04, 0x04000204, 0x04100204, 0x04000A04, 0x04100A04, 0x04000204, 0x04100204, 0x04000A04, 0x04100A04, 0x00020000, 0x00120000, 0x00020800, 0x00120800, 0x00020000, 0x00120000, 0x00020800, 0x00120800, 0x04020000, 0x04120000, 0x04020800, 0x04120800, 0x04020000, 0x04120000, 0x04020800, 0x04120800, 0x00020004, 0x00120004, 0x00020804, 0x00120804, 0x00020004, 0x00120004, 0x00020804, 0x00120804, 0x04020004, 0x04120004, 0x04020804, 0x04120804, 0x04020004, 0x04120004, 0x04020804, 0x04120804, 0x00020000, 0x00120000, 0x00020800, 0x00120800, 0x00020000, 0x00120000, 0x00020800, 0x00120800, 0x04020000, 0x04120000, 0x04020800, 0x04120800, 0x04020000, 0x04120000, 0x04020800, 0x04120800, 0x00020004, 0x00120004, 0x00020804, 0x00120804, 0x00020004, 0x00120004, 0x00020804, 0x00120804, 0x04020004, 0x04120004, 0x04020804, 0x04120804, 0x04020004, 0x04120004, 0x04020804, 0x04120804, 0x00020200, 0x00120200, 0x00020A00, 0x00120A00, 0x00020200, 0x00120200, 0x00020A00, 0x00120A00, 0x04020200, 0x04120200, 0x04020A00, 0x04120A00, 0x04020200, 0x04120200, 0x04020A00, 0x04120A00, 0x00020204, 0x00120204, 0x00020A04, 0x00120A04, 0x00020204, 0x00120204, 0x00020A04, 0x00120A04, 0x04020204, 0x04120204, 0x04020A04, 0x04120A04, 0x04020204, 0x04120204, 0x04020A04, 0x04120A04, 0x00020200, 0x00120200, 0x00020A00, 0x00120A00, 0x00020200, 0x00120200, 0x00020A00, 0x00120A00, 0x04020200, 0x04120200, 0x04020A00, 0x04120A00, 0x04020200, 0x04120200, 0x04020A00, 0x04120A00, 0x00020204, 0x00120204, 0x00020A04, 0x00120A04, 0x00020204, 0x00120204, 0x00020A04, 0x00120A04, 0x04020204, 0x04120204, 0x04020A04, 0x04120A04, 0x04020204, 0x04120204, 0x04020A04, 0x04120A04 ]; static $pc2mapd3 = [ 0x00000000, 0x00010000, 0x02000000, 0x02010000, 0x00000020, 0x00010020, 0x02000020, 0x02010020, 0x00040000, 0x00050000, 0x02040000, 0x02050000, 0x00040020, 0x00050020, 0x02040020, 0x02050020, 0x00002000, 0x00012000, 0x02002000, 0x02012000, 0x00002020, 0x00012020, 0x02002020, 0x02012020, 0x00042000, 0x00052000, 0x02042000, 0x02052000, 0x00042020, 0x00052020, 0x02042020, 0x02052020, 0x00000000, 0x00010000, 0x02000000, 0x02010000, 0x00000020, 0x00010020, 0x02000020, 0x02010020, 0x00040000, 0x00050000, 0x02040000, 0x02050000, 0x00040020, 0x00050020, 0x02040020, 0x02050020, 0x00002000, 0x00012000, 0x02002000, 0x02012000, 0x00002020, 0x00012020, 0x02002020, 0x02012020, 0x00042000, 0x00052000, 0x02042000, 0x02052000, 0x00042020, 0x00052020, 0x02042020, 0x02052020, 0x00000010, 0x00010010, 0x02000010, 0x02010010, 0x00000030, 0x00010030, 0x02000030, 0x02010030, 0x00040010, 0x00050010, 0x02040010, 0x02050010, 0x00040030, 0x00050030, 0x02040030, 0x02050030, 0x00002010, 0x00012010, 0x02002010, 0x02012010, 0x00002030, 0x00012030, 0x02002030, 0x02012030, 0x00042010, 0x00052010, 0x02042010, 0x02052010, 0x00042030, 0x00052030, 0x02042030, 0x02052030, 0x00000010, 0x00010010, 0x02000010, 0x02010010, 0x00000030, 0x00010030, 0x02000030, 0x02010030, 0x00040010, 0x00050010, 0x02040010, 0x02050010, 0x00040030, 0x00050030, 0x02040030, 0x02050030, 0x00002010, 0x00012010, 0x02002010, 0x02012010, 0x00002030, 0x00012030, 0x02002030, 0x02012030, 0x00042010, 0x00052010, 0x02042010, 0x02052010, 0x00042030, 0x00052030, 0x02042030, 0x02052030, 0x20000000, 0x20010000, 0x22000000, 0x22010000, 0x20000020, 0x20010020, 0x22000020, 0x22010020, 0x20040000, 0x20050000, 0x22040000, 0x22050000, 0x20040020, 0x20050020, 0x22040020, 0x22050020, 0x20002000, 0x20012000, 0x22002000, 0x22012000, 0x20002020, 0x20012020, 0x22002020, 0x22012020, 0x20042000, 0x20052000, 0x22042000, 0x22052000, 0x20042020, 0x20052020, 0x22042020, 0x22052020, 0x20000000, 0x20010000, 0x22000000, 0x22010000, 0x20000020, 0x20010020, 0x22000020, 0x22010020, 0x20040000, 0x20050000, 0x22040000, 0x22050000, 0x20040020, 0x20050020, 0x22040020, 0x22050020, 0x20002000, 0x20012000, 0x22002000, 0x22012000, 0x20002020, 0x20012020, 0x22002020, 0x22012020, 0x20042000, 0x20052000, 0x22042000, 0x22052000, 0x20042020, 0x20052020, 0x22042020, 0x22052020, 0x20000010, 0x20010010, 0x22000010, 0x22010010, 0x20000030, 0x20010030, 0x22000030, 0x22010030, 0x20040010, 0x20050010, 0x22040010, 0x22050010, 0x20040030, 0x20050030, 0x22040030, 0x22050030, 0x20002010, 0x20012010, 0x22002010, 0x22012010, 0x20002030, 0x20012030, 0x22002030, 0x22012030, 0x20042010, 0x20052010, 0x22042010, 0x22052010, 0x20042030, 0x20052030, 0x22042030, 0x22052030, 0x20000010, 0x20010010, 0x22000010, 0x22010010, 0x20000030, 0x20010030, 0x22000030, 0x22010030, 0x20040010, 0x20050010, 0x22040010, 0x22050010, 0x20040030, 0x20050030, 0x22040030, 0x22050030, 0x20002010, 0x20012010, 0x22002010, 0x22012010, 0x20002030, 0x20012030, 0x22002030, 0x22012030, 0x20042010, 0x20052010, 0x22042010, 0x22052010, 0x20042030, 0x20052030, 0x22042030, 0x22052030 ]; static $pc2mapd4 = [ 0x00000000, 0x00000400, 0x01000000, 0x01000400, 0x00000000, 0x00000400, 0x01000000, 0x01000400, 0x00000100, 0x00000500, 0x01000100, 0x01000500, 0x00000100, 0x00000500, 0x01000100, 0x01000500, 0x10000000, 0x10000400, 0x11000000, 0x11000400, 0x10000000, 0x10000400, 0x11000000, 0x11000400, 0x10000100, 0x10000500, 0x11000100, 0x11000500, 0x10000100, 0x10000500, 0x11000100, 0x11000500, 0x00080000, 0x00080400, 0x01080000, 0x01080400, 0x00080000, 0x00080400, 0x01080000, 0x01080400, 0x00080100, 0x00080500, 0x01080100, 0x01080500, 0x00080100, 0x00080500, 0x01080100, 0x01080500, 0x10080000, 0x10080400, 0x11080000, 0x11080400, 0x10080000, 0x10080400, 0x11080000, 0x11080400, 0x10080100, 0x10080500, 0x11080100, 0x11080500, 0x10080100, 0x10080500, 0x11080100, 0x11080500, 0x00000008, 0x00000408, 0x01000008, 0x01000408, 0x00000008, 0x00000408, 0x01000008, 0x01000408, 0x00000108, 0x00000508, 0x01000108, 0x01000508, 0x00000108, 0x00000508, 0x01000108, 0x01000508, 0x10000008, 0x10000408, 0x11000008, 0x11000408, 0x10000008, 0x10000408, 0x11000008, 0x11000408, 0x10000108, 0x10000508, 0x11000108, 0x11000508, 0x10000108, 0x10000508, 0x11000108, 0x11000508, 0x00080008, 0x00080408, 0x01080008, 0x01080408, 0x00080008, 0x00080408, 0x01080008, 0x01080408, 0x00080108, 0x00080508, 0x01080108, 0x01080508, 0x00080108, 0x00080508, 0x01080108, 0x01080508, 0x10080008, 0x10080408, 0x11080008, 0x11080408, 0x10080008, 0x10080408, 0x11080008, 0x11080408, 0x10080108, 0x10080508, 0x11080108, 0x11080508, 0x10080108, 0x10080508, 0x11080108, 0x11080508, 0x00001000, 0x00001400, 0x01001000, 0x01001400, 0x00001000, 0x00001400, 0x01001000, 0x01001400, 0x00001100, 0x00001500, 0x01001100, 0x01001500, 0x00001100, 0x00001500, 0x01001100, 0x01001500, 0x10001000, 0x10001400, 0x11001000, 0x11001400, 0x10001000, 0x10001400, 0x11001000, 0x11001400, 0x10001100, 0x10001500, 0x11001100, 0x11001500, 0x10001100, 0x10001500, 0x11001100, 0x11001500, 0x00081000, 0x00081400, 0x01081000, 0x01081400, 0x00081000, 0x00081400, 0x01081000, 0x01081400, 0x00081100, 0x00081500, 0x01081100, 0x01081500, 0x00081100, 0x00081500, 0x01081100, 0x01081500, 0x10081000, 0x10081400, 0x11081000, 0x11081400, 0x10081000, 0x10081400, 0x11081000, 0x11081400, 0x10081100, 0x10081500, 0x11081100, 0x11081500, 0x10081100, 0x10081500, 0x11081100, 0x11081500, 0x00001008, 0x00001408, 0x01001008, 0x01001408, 0x00001008, 0x00001408, 0x01001008, 0x01001408, 0x00001108, 0x00001508, 0x01001108, 0x01001508, 0x00001108, 0x00001508, 0x01001108, 0x01001508, 0x10001008, 0x10001408, 0x11001008, 0x11001408, 0x10001008, 0x10001408, 0x11001008, 0x11001408, 0x10001108, 0x10001508, 0x11001108, 0x11001508, 0x10001108, 0x10001508, 0x11001108, 0x11001508, 0x00081008, 0x00081408, 0x01081008, 0x01081408, 0x00081008, 0x00081408, 0x01081008, 0x01081408, 0x00081108, 0x00081508, 0x01081108, 0x01081508, 0x00081108, 0x00081508, 0x01081108, 0x01081508, 0x10081008, 0x10081408, 0x11081008, 0x11081408, 0x10081008, 0x10081408, 0x11081008, 0x11081408, 0x10081108, 0x10081508, 0x11081108, 0x11081508, 0x10081108, 0x10081508, 0x11081108, 0x11081508 ]; $keys = []; for ($des_round = 0; $des_round < $this->des_rounds; ++$des_round) { // pad the key and remove extra characters as appropriate. $key = str_pad(substr($this->key, $des_round * 8, 8), 8, "\0"); // Perform the PC/1 transformation and compute C and D. $t = unpack('Nl/Nr', $key); list($l, $r) = [$t['l'], $t['r']]; $key = (self::$shuffle[$pc1map[ $r & 0xFF]] & "\x80\x80\x80\x80\x80\x80\x80\x00") | (self::$shuffle[$pc1map[($r >> 8) & 0xFF]] & "\x40\x40\x40\x40\x40\x40\x40\x00") | (self::$shuffle[$pc1map[($r >> 16) & 0xFF]] & "\x20\x20\x20\x20\x20\x20\x20\x00") | (self::$shuffle[$pc1map[($r >> 24) & 0xFF]] & "\x10\x10\x10\x10\x10\x10\x10\x00") | (self::$shuffle[$pc1map[ $l & 0xFF]] & "\x08\x08\x08\x08\x08\x08\x08\x00") | (self::$shuffle[$pc1map[($l >> 8) & 0xFF]] & "\x04\x04\x04\x04\x04\x04\x04\x00") | (self::$shuffle[$pc1map[($l >> 16) & 0xFF]] & "\x02\x02\x02\x02\x02\x02\x02\x00") | (self::$shuffle[$pc1map[($l >> 24) & 0xFF]] & "\x01\x01\x01\x01\x01\x01\x01\x00"); $key = unpack('Nc/Nd', $key); $c = ( $key['c'] >> 4) & 0x0FFFFFFF; $d = (($key['d'] >> 4) & 0x0FFFFFF0) | ($key['c'] & 0x0F); $keys[$des_round] = [ self::ENCRYPT => [], self::DECRYPT => array_fill(0, 32, 0) ]; for ($i = 0, $ki = 31; $i < 16; ++$i, $ki -= 2) { $c <<= $shifts[$i]; $c = ($c | ($c >> 28)) & 0x0FFFFFFF; $d <<= $shifts[$i]; $d = ($d | ($d >> 28)) & 0x0FFFFFFF; // Perform the PC-2 transformation. $cp = $pc2mapc1[ $c >> 24 ] | $pc2mapc2[($c >> 16) & 0xFF] | $pc2mapc3[($c >> 8) & 0xFF] | $pc2mapc4[ $c & 0xFF]; $dp = $pc2mapd1[ $d >> 24 ] | $pc2mapd2[($d >> 16) & 0xFF] | $pc2mapd3[($d >> 8) & 0xFF] | $pc2mapd4[ $d & 0xFF]; // Reorder: odd bytes/even bytes. Push the result in key schedule. $val1 = ( $cp & intval(0xFF000000)) | (($cp << 8) & 0x00FF0000) | (($dp >> 16) & 0x0000FF00) | (($dp >> 8) & 0x000000FF); $val2 = (($cp << 8) & intval(0xFF000000)) | (($cp << 16) & 0x00FF0000) | (($dp >> 8) & 0x0000FF00) | ( $dp & 0x000000FF); $keys[$des_round][self::ENCRYPT][ ] = $val1; $keys[$des_round][self::DECRYPT][$ki - 1] = $val1; $keys[$des_round][self::ENCRYPT][ ] = $val2; $keys[$des_round][self::DECRYPT][$ki ] = $val2; } } switch ($this->des_rounds) { case 3: // 3DES keys $this->keys = [ self::ENCRYPT => array_merge( $keys[0][self::ENCRYPT], $keys[1][self::DECRYPT], $keys[2][self::ENCRYPT] ), self::DECRYPT => array_merge( $keys[2][self::DECRYPT], $keys[1][self::ENCRYPT], $keys[0][self::DECRYPT] ) ]; break; // case 1: // DES keys default: $this->keys = [ self::ENCRYPT => $keys[0][self::ENCRYPT], self::DECRYPT => $keys[0][self::DECRYPT] ]; } } /** * Setup the performance-optimized function for de/encrypt() * * @see \phpseclib3\Crypt\Common\SymmetricKey::setupInlineCrypt() */ protected function setupInlineCrypt() { // Engine configuration for: // - DES ($des_rounds == 1) or // - 3DES ($des_rounds == 3) $des_rounds = $this->des_rounds; $init_crypt = 'static $sbox1, $sbox2, $sbox3, $sbox4, $sbox5, $sbox6, $sbox7, $sbox8, $shuffleip, $shuffleinvip; if (!$sbox1) { $sbox1 = array_map("intval", self::$sbox1); $sbox2 = array_map("intval", self::$sbox2); $sbox3 = array_map("intval", self::$sbox3); $sbox4 = array_map("intval", self::$sbox4); $sbox5 = array_map("intval", self::$sbox5); $sbox6 = array_map("intval", self::$sbox6); $sbox7 = array_map("intval", self::$sbox7); $sbox8 = array_map("intval", self::$sbox8);' /* Merge $shuffle with $[inv]ipmap */ . ' for ($i = 0; $i < 256; ++$i) { $shuffleip[] = self::$shuffle[self::$ipmap[$i]]; $shuffleinvip[] = self::$shuffle[self::$invipmap[$i]]; } } '; $k = [ self::ENCRYPT => $this->keys[self::ENCRYPT], self::DECRYPT => $this->keys[self::DECRYPT] ]; $init_encrypt = ''; $init_decrypt = ''; // Creating code for en- and decryption. $crypt_block = []; foreach ([self::ENCRYPT, self::DECRYPT] as $c) { /* Do the initial IP permutation. */ $crypt_block[$c] = ' $in = unpack("N*", $in); $l = $in[1]; $r = $in[2]; $in = unpack("N*", ($shuffleip[ $r & 0xFF] & "\x80\x80\x80\x80\x80\x80\x80\x80") | ($shuffleip[($r >> 8) & 0xFF] & "\x40\x40\x40\x40\x40\x40\x40\x40") | ($shuffleip[($r >> 16) & 0xFF] & "\x20\x20\x20\x20\x20\x20\x20\x20") | ($shuffleip[($r >> 24) & 0xFF] & "\x10\x10\x10\x10\x10\x10\x10\x10") | ($shuffleip[ $l & 0xFF] & "\x08\x08\x08\x08\x08\x08\x08\x08") | ($shuffleip[($l >> 8) & 0xFF] & "\x04\x04\x04\x04\x04\x04\x04\x04") | ($shuffleip[($l >> 16) & 0xFF] & "\x02\x02\x02\x02\x02\x02\x02\x02") | ($shuffleip[($l >> 24) & 0xFF] & "\x01\x01\x01\x01\x01\x01\x01\x01") ); ' . /* Extract L0 and R0 */ ' $l = $in[1]; $r = $in[2]; '; $l = '$l'; $r = '$r'; // Perform DES or 3DES. for ($ki = -1, $des_round = 0; $des_round < $des_rounds; ++$des_round) { // Perform the 16 steps. for ($i = 0; $i < 16; ++$i) { // start of "the Feistel (F) function" - see the following URL: // http://en.wikipedia.org/wiki/Image:Data_Encryption_Standard_InfoBox_Diagram.png // Merge key schedule. $crypt_block[$c] .= ' $b1 = ((' . $r . ' >> 3) & 0x1FFFFFFF) ^ (' . $r . ' << 29) ^ ' . $k[$c][++$ki] . '; $b2 = ((' . $r . ' >> 31) & 0x00000001) ^ (' . $r . ' << 1) ^ ' . $k[$c][++$ki] . ';' . /* S-box indexing. */ $l . ' = $sbox1[($b1 >> 24) & 0x3F] ^ $sbox2[($b2 >> 24) & 0x3F] ^ $sbox3[($b1 >> 16) & 0x3F] ^ $sbox4[($b2 >> 16) & 0x3F] ^ $sbox5[($b1 >> 8) & 0x3F] ^ $sbox6[($b2 >> 8) & 0x3F] ^ $sbox7[ $b1 & 0x3F] ^ $sbox8[ $b2 & 0x3F] ^ ' . $l . '; '; // end of "the Feistel (F) function" // swap L & R list($l, $r) = [$r, $l]; } list($l, $r) = [$r, $l]; } // Perform the inverse IP permutation. $crypt_block[$c] .= '$in = ($shuffleinvip[($l >> 24) & 0xFF] & "\x80\x80\x80\x80\x80\x80\x80\x80") | ($shuffleinvip[($r >> 24) & 0xFF] & "\x40\x40\x40\x40\x40\x40\x40\x40") | ($shuffleinvip[($l >> 16) & 0xFF] & "\x20\x20\x20\x20\x20\x20\x20\x20") | ($shuffleinvip[($r >> 16) & 0xFF] & "\x10\x10\x10\x10\x10\x10\x10\x10") | ($shuffleinvip[($l >> 8) & 0xFF] & "\x08\x08\x08\x08\x08\x08\x08\x08") | ($shuffleinvip[($r >> 8) & 0xFF] & "\x04\x04\x04\x04\x04\x04\x04\x04") | ($shuffleinvip[ $l & 0xFF] & "\x02\x02\x02\x02\x02\x02\x02\x02") | ($shuffleinvip[ $r & 0xFF] & "\x01\x01\x01\x01\x01\x01\x01\x01"); '; } // Creates the inline-crypt function $this->inline_crypt = $this->createInlineCryptFunction( [ 'init_crypt' => $init_crypt, 'init_encrypt' => $init_encrypt, 'init_decrypt' => $init_decrypt, 'encrypt_block' => $crypt_block[self::ENCRYPT], 'decrypt_block' => $crypt_block[self::DECRYPT] ] ); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class secp128r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('FFFFFFFDFFFFFFFFFFFFFFFFFFFFFFFF', 16)); $this->setCoefficients( new BigInteger('FFFFFFFDFFFFFFFFFFFFFFFFFFFFFFFC', 16), new BigInteger('E87579C11079F43DD824993C2CEE5ED3', 16) ); $this->setBasePoint( new BigInteger('161FF7528B899B2D0C28607CA52C5B86', 16), new BigInteger('CF5AC8395BAFEB13C02DA292DDED7A83', 16) ); $this->setOrder(new BigInteger('FFFFFFFE0000000075A30D1B9038A115', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistp224 extends secp224r1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class secp112r2 extends Prime { public function __construct() { // same modulo as secp112r1 $this->setModulo(new BigInteger('DB7C2ABF62E35E668076BEAD208B', 16)); $this->setCoefficients( new BigInteger('6127C24C05F38A0AAAF65C0EF02C', 16), new BigInteger('51DEF1815DB5ED74FCC34C85D709', 16) ); $this->setBasePoint( new BigInteger('4BA30AB5E892B4E1649DD0928643', 16), new BigInteger('ADCD46F5882E3747DEF36E956E97', 16) ); $this->setOrder(new BigInteger('36DF0AAFD8B8D7597CA10520D04B', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistk163 extends sect163k1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistp256 extends secp256r1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class secp160r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7FFFFFFF', 16)); $this->setCoefficients( new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7FFFFFFC', 16), new BigInteger('1C97BEFC54BD7A8B65ACF89F81D4D4ADC565FA45', 16) ); $this->setBasePoint( new BigInteger('4A96B5688EF573284664698968C38BB913CBFC82', 16), new BigInteger('23A628553168947D59DCC912042351377AC5FB32', 16) ); $this->setOrder(new BigInteger('0100000000000000000001F4C8F927AED3CA752257', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP192t1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('C302F41D932A36CDA7A3463093D18DB78FCE476DE1A86297', 16)); $this->setCoefficients( new BigInteger('C302F41D932A36CDA7A3463093D18DB78FCE476DE1A86294', 16), // eg. -3 new BigInteger('13D56FFAEC78681E68F9DEB43B35BEC2FB68542E27897B79', 16) ); $this->setBasePoint( new BigInteger('3AE9E58C82F63C30282E1FE7BBF43FA72C446AF6F4618129', 16), new BigInteger('097E2C5667C2223A902AB5CA449D0084B7E5B3DE7CCC01C9', 16) ); $this->setOrder(new BigInteger('C302F41D932A36CDA7A3462F9E9E916B5BE8F1029AC4ACC1', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect283k1 extends Binary { public function __construct() { $this->setModulo(283, 12, 7, 5, 0); $this->setCoefficients( '000000000000000000000000000000000000000000000000000000000000000000000000', '000000000000000000000000000000000000000000000000000000000000000000000001' ); $this->setBasePoint( '0503213F78CA44883F1A3B8162F188E553CD265F23C1567A16876913B0C2AC2458492836', '01CCDA380F1C9E318D90F95D07E5426FE87E45C0E8184698E45962364E34116177DD2259' ); $this->setOrder(new BigInteger('01FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFE9AE2ED07577265DFF7F94451E061E163C61', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\KoblitzPrime; use phpseclib3\Math\BigInteger; class secp224k1 extends KoblitzPrime { public function __construct() { $this->setModulo(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFE56D', 16)); $this->setCoefficients( new BigInteger('00000000000000000000000000000000000000000000000000000000', 16), new BigInteger('00000000000000000000000000000000000000000000000000000005', 16) ); $this->setBasePoint( new BigInteger('A1455B334DF099DF30FC28A169A467E9E47075A90F7E650EB6B7A45C', 16), new BigInteger('7E089FED7FBA344282CAFBD6F7E319F7C0B0BD59E2CA4BDB556D61A5', 16) ); $this->setOrder(new BigInteger('010000000000000000000000000001DCE8D2EC6184CAF0A971769FB1F7', 16)); $this->basis = []; $this->basis[] = [ 'a' => new BigInteger('00B8ADF1378A6EB73409FA6C9C637D', -16), 'b' => new BigInteger('94730F82B358A3776A826298FA6F', -16) ]; $this->basis[] = [ 'a' => new BigInteger('01DCE8D2EC6184CAF0A972769FCC8B', -16), 'b' => new BigInteger('4D2100BA3DC75AAB747CCF355DEC', -16) ]; $this->beta = $this->factory->newInteger(new BigInteger('01F178FFA4B17C89E6F73AECE2AAD57AF4C0A748B63C830947B27E04', -16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect239k1 extends Binary { public function __construct() { $this->setModulo(239, 158, 0); $this->setCoefficients( '000000000000000000000000000000000000000000000000000000000000', '000000000000000000000000000000000000000000000000000000000001' ); $this->setBasePoint( '29A0B6A887A983E9730988A68727A8B2D126C44CC2CC7B2A6555193035DC', '76310804F12E549BDB011C103089E73510ACB275FC312A5DC6B76553F0CA' ); $this->setOrder(new BigInteger('2000000000000000000000000000005A79FEC67CB6E91F1C1DA800E478A5', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistp521 extends secp521r1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistp192 extends secp192r1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\TwistedEdwards; use phpseclib3\Crypt\Hash; use phpseclib3\Crypt\Random; use phpseclib3\Math\BigInteger; class Ed448 extends TwistedEdwards { const HASH = 'shake256-912'; const SIZE = 57; public function __construct() { // 2^448 - 2^224 - 1 $this->setModulo(new BigInteger( 'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFE' . 'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF', 16 )); $this->setCoefficients( new BigInteger(1), // -39081 new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFE' . 'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF6756', 16) ); $this->setBasePoint( new BigInteger('4F1970C66BED0DED221D15A622BF36DA9E146570470F1767EA6DE324' . 'A3D3A46412AE1AF72AB66511433B80E18B00938E2626A82BC70CC05E', 16), new BigInteger('693F46716EB6BC248876203756C9C7624BEA73736CA3984087789C1E' . '05A0C2D73AD3FF1CE67C39C4FDBD132C4ED7C8AD9808795BF230FA14', 16) ); $this->setOrder(new BigInteger( '3FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' . '7CCA23E9C44EDB49AED63690216CC2728DC58F552378C292AB5844F3', 16 )); } /** * Recover X from Y * * Implements steps 2-4 at https://tools.ietf.org/html/rfc8032#section-5.2.3 * * Used by EC\Keys\Common.php * * @param BigInteger $y * @param boolean $sign * @return object[] */ public function recoverX(BigInteger $y, $sign) { $y = $this->factory->newInteger($y); $y2 = $y->multiply($y); $u = $y2->subtract($this->one); $v = $this->d->multiply($y2)->subtract($this->one); $x2 = $u->divide($v); if ($x2->equals($this->zero)) { if ($sign) { throw new \RuntimeException('Unable to recover X coordinate (x2 = 0)'); } return clone $this->zero; } // find the square root $exp = $this->getModulo()->add(new BigInteger(1)); $exp = $exp->bitwise_rightShift(2); $x = $x2->pow($exp); if (!$x->multiply($x)->subtract($x2)->equals($this->zero)) { throw new \RuntimeException('Unable to recover X coordinate'); } if ($x->isOdd() != $sign) { $x = $x->negate(); } return [$x, $y]; } /** * Extract Secret Scalar * * Implements steps 1-3 at https://tools.ietf.org/html/rfc8032#section-5.2.5 * * Used by the various key handlers * * @param string $str * @return array */ public function extractSecret($str) { if (strlen($str) != 57) { throw new \LengthException('Private Key should be 57-bytes long'); } // 1. Hash the 57-byte private key using SHAKE256(x, 114), storing the // digest in a 114-octet large buffer, denoted h. Only the lower 57 // bytes are used for generating the public key. $hash = new Hash('shake256-912'); $h = $hash->hash($str); $h = substr($h, 0, 57); // 2. Prune the buffer: The two least significant bits of the first // octet are cleared, all eight bits the last octet are cleared, and // the highest bit of the second to last octet is set. $h[0] = $h[0] & chr(0xFC); $h = strrev($h); $h[0] = "\0"; $h[1] = $h[1] | chr(0x80); // 3. Interpret the buffer as the little-endian integer, forming a // secret scalar s. $dA = new BigInteger($h, 256); return [ 'dA' => $dA, 'secret' => $str ]; $dA->secret = $str; return $dA; } /** * Encode a point as a string * * @param array $point * @return string */ public function encodePoint($point) { list($x, $y) = $point; $y = "\0" . $y->toBytes(); if ($x->isOdd()) { $y[0] = $y[0] | chr(0x80); } $y = strrev($y); return $y; } /** * Creates a random scalar multiplier * * @return \phpseclib3\Math\PrimeField\Integer */ public function createRandomMultiplier() { return $this->extractSecret(Random::string(57))['dA']; } /** * Converts an affine point to an extended homogeneous coordinate * * From https://tools.ietf.org/html/rfc8032#section-5.2.4 : * * A point (x,y) is represented in extended homogeneous coordinates (X, Y, Z, T), * with x = X/Z, y = Y/Z, x * y = T/Z. * * @return \phpseclib3\Math\PrimeField\Integer[] */ public function convertToInternal(array $p) { if (empty($p)) { return [clone $this->zero, clone $this->one, clone $this->one]; } if (isset($p[2])) { return $p; } $p[2] = clone $this->one; return $p; } /** * Doubles a point on a curve * * @return FiniteField[] */ public function doublePoint(array $p) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } if (!count($p)) { return []; } if (!isset($p[2])) { throw new \RuntimeException('Affine coordinates need to be manually converted to "Jacobi" coordinates or vice versa'); } // from https://tools.ietf.org/html/rfc8032#page-18 list($x1, $y1, $z1) = $p; $b = $x1->add($y1); $b = $b->multiply($b); $c = $x1->multiply($x1); $d = $y1->multiply($y1); $e = $c->add($d); $h = $z1->multiply($z1); $j = $e->subtract($this->two->multiply($h)); $x3 = $b->subtract($e)->multiply($j); $y3 = $c->subtract($d)->multiply($e); $z3 = $e->multiply($j); return [$x3, $y3, $z3]; } /** * Adds two points on the curve * * @return FiniteField[] */ public function addPoint(array $p, array $q) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } if (!count($p) || !count($q)) { if (count($q)) { return $q; } if (count($p)) { return $p; } return []; } if (!isset($p[2]) || !isset($q[2])) { throw new \RuntimeException('Affine coordinates need to be manually converted to "Jacobi" coordinates or vice versa'); } if ($p[0]->equals($q[0])) { return !$p[1]->equals($q[1]) ? [] : $this->doublePoint($p); } // from https://tools.ietf.org/html/rfc8032#page-17 list($x1, $y1, $z1) = $p; list($x2, $y2, $z2) = $q; $a = $z1->multiply($z2); $b = $a->multiply($a); $c = $x1->multiply($x2); $d = $y1->multiply($y2); $e = $this->d->multiply($c)->multiply($d); $f = $b->subtract($e); $g = $b->add($e); $h = $x1->add($y1)->multiply($x2->add($y2)); $x3 = $a->multiply($f)->multiply($h->subtract($c)->subtract($d)); $y3 = $a->multiply($g)->multiply($d->subtract($c)); $z3 = $f->multiply($g); return [$x3, $y3, $z3]; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP512r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger( 'AADD9DB8DBE9C48B3FD4E6AE33C9FC07CB308DB3B3C9D20ED6639CCA703308717D4D9B009BC' . '66842AECDA12AE6A380E62881FF2F2D82C68528AA6056583A48F3', 16 )); $this->setCoefficients( new BigInteger( '7830A3318B603B89E2327145AC234CC594CBDD8D3DF91610A83441CAEA9863BC2DED5D5AA82' . '53AA10A2EF1C98B9AC8B57F1117A72BF2C7B9E7C1AC4D77FC94CA', 16 ), new BigInteger( '3DF91610A83441CAEA9863BC2DED5D5AA8253AA10A2EF1C98B9AC8B57F1117A72BF2C7B9E7C' . '1AC4D77FC94CADC083E67984050B75EBAE5DD2809BD638016F723', 16 ) ); $this->setBasePoint( new BigInteger( '81AEE4BDD82ED9645A21322E9C4C6A9385ED9F70B5D916C1B43B62EEF4D0098EFF3B1F78E2D' . '0D48D50D1687B93B97D5F7C6D5047406A5E688B352209BCB9F822', 16 ), new BigInteger( '7DDE385D566332ECC0EABFA9CF7822FDF209F70024A57B1AA000C55B881F8111B2DCDE494A5' . 'F485E5BCA4BD88A2763AED1CA2B2FA8F0540678CD1E0F3AD80892', 16 ) ); $this->setOrder(new BigInteger( 'AADD9DB8DBE9C48B3FD4E6AE33C9FC07CB308DB3B3C9D20ED6639CCA70330870553E5C414CA' . '92619418661197FAC10471DB1D381085DDADDB58796829CA90069', 16 )); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect409k1 extends Binary { public function __construct() { $this->setModulo(409, 87, 0); $this->setCoefficients( '00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000', '00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001' ); $this->setBasePoint( '0060F05F658F49C1AD3AB1890F7184210EFD0987E307C84C27ACCFB8F9F67CC2C460189EB5AAAA62EE222EB1B35540CFE9023746', '01E369050B7C4E42ACBA1DACBF04299C3460782F918EA427E6325165E9EA10E3DA5F6C42E9C55215AA9CA27A5863EC48D8E0286B' ); $this->setOrder(new BigInteger( '7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFE5F' . '83B2D4EA20400EC4557D5ED3E3E7CA5B4B5C83B8E01E5FCF', 16 )); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect233k1 extends Binary { public function __construct() { $this->setModulo(233, 74, 0); $this->setCoefficients( '000000000000000000000000000000000000000000000000000000000000', '000000000000000000000000000000000000000000000000000000000001' ); $this->setBasePoint( '017232BA853A7E731AF129F22FF4149563A419C26BF50A4C9D6EEFAD6126', '01DB537DECE819B7F70F555A67C427A8CD9BF18AEB9B56E0C11056FAE6A3' ); $this->setOrder(new BigInteger('8000000000000000000000000000069D5BB915BCD46EFB1AD5F173ABDF', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class prime239v2 extends Prime { public function __construct() { $this->setModulo(new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFF7FFFFFFFFFFF8000000000007FFFFFFFFFFF', 16)); $this->setCoefficients( new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFF7FFFFFFFFFFF8000000000007FFFFFFFFFFC', 16), new BigInteger('617FAB6832576CBBFED50D99F0249C3FEE58B94BA0038C7AE84C8C832F2C', 16) ); $this->setBasePoint( new BigInteger('38AF09D98727705120C921BB5E9E26296A3CDCF2F35757A0EAFD87B830E7', 16), new BigInteger('5B0125E4DBEA0EC7206DA0FC01D9B081329FB555DE6EF460237DFF8BE4BA', 16) ); $this->setOrder(new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFF800000CFA7E8594377D414C03821BC582063', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect131r1 extends Binary { public function __construct() { $this->setModulo(131, 8, 3, 2, 0); $this->setCoefficients( '07A11B09A76B562144418FF3FF8C2570B8', '0217C05610884B63B9C6C7291678F9D341' ); $this->setBasePoint( '0081BAF91FDF9833C40F9C181343638399', '078C6E7EA38C001F73C8134B1B4EF9E150' ); $this->setOrder(new BigInteger('0400000000000000023123953A9464B54D', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\KoblitzPrime; use phpseclib3\Math\BigInteger; class secp192k1 extends KoblitzPrime { public function __construct() { $this->setModulo(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFEE37', 16)); $this->setCoefficients( new BigInteger('000000000000000000000000000000000000000000000000', 16), new BigInteger('000000000000000000000000000000000000000000000003', 16) ); $this->setBasePoint( new BigInteger('DB4FF10EC057E9AE26B07D0280B7F4341DA5D1B1EAE06C7D', 16), new BigInteger('9B2F2F6D9C5628A7844163D015BE86344082AA88D95E2F9D', 16) ); $this->setOrder(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFE26F2FC170F69466A74DEFD8D', 16)); $this->basis = []; $this->basis[] = [ 'a' => new BigInteger('00B3FB3400DEC5C4ADCEB8655C', -16), 'b' => new BigInteger('8EE96418CCF4CFC7124FDA0F', -16) ]; $this->basis[] = [ 'a' => new BigInteger('01D90D03E8F096B9948B20F0A9', -16), 'b' => new BigInteger('42E49819ABBA9474E1083F6B', -16) ]; $this->beta = $this->factory->newInteger(new BigInteger('447A96E6C647963E2F7809FEAAB46947F34B0AA3CA0BBA74', -16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistt571 extends sect571k1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect283r1 extends Binary { public function __construct() { $this->setModulo(283, 12, 7, 5, 0); $this->setCoefficients( '000000000000000000000000000000000000000000000000000000000000000000000001', '027B680AC8B8596DA5A4AF8A19A0303FCA97FD7645309FA2A581485AF6263E313B79A2F5' ); $this->setBasePoint( '05F939258DB7DD90E1934F8C70B0DFEC2EED25B8557EAC9C80E2E198F8CDBECD86B12053', '03676854FE24141CB98FE6D4B20D02B4516FF702350EDDB0826779C813F0DF45BE8112F4' ); $this->setOrder(new BigInteger('03FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEF90399660FC938A90165B042A7CEFADB307', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP224t1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('D7C134AA264366862A18302575D1D787B09F075797DA89F57EC8C0FF', 16)); $this->setCoefficients( new BigInteger('D7C134AA264366862A18302575D1D787B09F075797DA89F57EC8C0FC', 16), // eg. -3 new BigInteger('4B337D934104CD7BEF271BF60CED1ED20DA14C08B3BB64F18A60888D', 16) ); $this->setBasePoint( new BigInteger('6AB1E344CE25FF3896424E7FFE14762ECB49F8928AC0C76029B4D580', 16), new BigInteger('0374E9F5143E568CD23F3F4D7C0D4B1E41C8CC0D1C6ABD5F1A46DB4C', 16) ); $this->setOrder(new BigInteger('D7C134AA264366862A18302575D0FB98D116BC4B6DDEBCA3A5A7939F', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class secp112r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('DB7C2ABF62E35E668076BEAD208B', 16)); $this->setCoefficients( new BigInteger('DB7C2ABF62E35E668076BEAD2088', 16), new BigInteger('659EF8BA043916EEDE8911702B22', 16) ); $this->setBasePoint( new BigInteger('09487239995A5EE76B55F9C2F098', 16), new BigInteger('A89CE5AF8724C0A23E0E0FF77500', 16) ); $this->setOrder(new BigInteger('DB7C2ABF62E35E7628DFAC6561C5', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistk283 extends sect283k1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect163r2 extends Binary { public function __construct() { $this->setModulo(163, 7, 6, 3, 0); $this->setCoefficients( '000000000000000000000000000000000000000001', '020A601907B8C953CA1481EB10512F78744A3205FD' ); $this->setBasePoint( '03F0EBA16286A2D57EA0991168D4994637E8343E36', '00D51FBC6C71A0094FA2CDD545B11C5C0C797324F1' ); $this->setOrder(new BigInteger('040000000000000000000292FE77E70C12A4234C33', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect193r1 extends Binary { public function __construct() { $this->setModulo(193, 15, 0); $this->setCoefficients( '0017858FEB7A98975169E171F77B4087DE098AC8A911DF7B01', '00FDFB49BFE6C3A89FACADAA7A1E5BBC7CC1C2E5D831478814' ); $this->setBasePoint( '01F481BC5F0FF84A74AD6CDF6FDEF4BF6179625372D8C0C5E1', '0025E399F2903712CCF3EA9E3A1AD17FB0B3201B6AF7CE1B05' ); $this->setOrder(new BigInteger('01000000000000000000000000C7F34A778F443ACC920EBA49', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\TwistedEdwards; use phpseclib3\Crypt\Hash; use phpseclib3\Crypt\Random; use phpseclib3\Math\BigInteger; class Ed25519 extends TwistedEdwards { const HASH = 'sha512'; /* Per https://tools.ietf.org/html/rfc8032#page-6 EdDSA has several parameters, one of which is b: 2. An integer b with 2^(b-1) > p. EdDSA public keys have exactly b bits, and EdDSA signatures have exactly 2*b bits. b is recommended to be a multiple of 8, so public key and signature lengths are an integral number of octets. SIZE corresponds to b */ const SIZE = 32; public function __construct() { // 2^255 - 19 $this->setModulo(new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFED', 16)); $this->setCoefficients( // -1 new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEC', 16), // a // -121665/121666 new BigInteger('52036CEE2B6FFE738CC740797779E89800700A4D4141D8AB75EB4DCA135978A3', 16) // d ); $this->setBasePoint( new BigInteger('216936D3CD6E53FEC0A4E231FDD6DC5C692CC7609525A7B2C9562D608F25D51A', 16), new BigInteger('6666666666666666666666666666666666666666666666666666666666666658', 16) ); $this->setOrder(new BigInteger('1000000000000000000000000000000014DEF9DEA2F79CD65812631A5CF5D3ED', 16)); // algorithm 14.47 from http://cacr.uwaterloo.ca/hac/about/chap14.pdf#page=16 /* $this->setReduction(function($x) { $parts = $x->bitwise_split(255); $className = $this->className; if (count($parts) > 2) { list(, $r) = $x->divide($className::$modulo); return $r; } $zero = new BigInteger(); $c = new BigInteger(19); switch (count($parts)) { case 2: list($qi, $ri) = $parts; break; case 1: $qi = $zero; list($ri) = $parts; break; case 0: return $zero; } $r = $ri; while ($qi->compare($zero) > 0) { $temp = $qi->multiply($c)->bitwise_split(255); if (count($temp) == 2) { list($qi, $ri) = $temp; } else { $qi = $zero; list($ri) = $temp; } $r = $r->add($ri); } while ($r->compare($className::$modulo) > 0) { $r = $r->subtract($className::$modulo); } return $r; }); */ } /** * Recover X from Y * * Implements steps 2-4 at https://tools.ietf.org/html/rfc8032#section-5.1.3 * * Used by EC\Keys\Common.php * * @param BigInteger $y * @param boolean $sign * @return object[] */ public function recoverX(BigInteger $y, $sign) { $y = $this->factory->newInteger($y); $y2 = $y->multiply($y); $u = $y2->subtract($this->one); $v = $this->d->multiply($y2)->add($this->one); $x2 = $u->divide($v); if ($x2->equals($this->zero)) { if ($sign) { throw new \RuntimeException('Unable to recover X coordinate (x2 = 0)'); } return clone $this->zero; } // find the square root /* we don't do $x2->squareRoot() because, quoting from https://tools.ietf.org/html/rfc8032#section-5.1.1: "For point decoding or "decompression", square roots modulo p are needed. They can be computed using the Tonelli-Shanks algorithm or the special case for p = 5 (mod 8). To find a square root of a, first compute the candidate root x = a^((p+3)/8) (mod p)." */ $exp = $this->getModulo()->add(new BigInteger(3)); $exp = $exp->bitwise_rightShift(3); $x = $x2->pow($exp); // If v x^2 = -u (mod p), set x <-- x * 2^((p-1)/4), which is a square root. if (!$x->multiply($x)->subtract($x2)->equals($this->zero)) { $temp = $this->getModulo()->subtract(new BigInteger(1)); $temp = $temp->bitwise_rightShift(2); $temp = $this->two->pow($temp); $x = $x->multiply($temp); if (!$x->multiply($x)->subtract($x2)->equals($this->zero)) { throw new \RuntimeException('Unable to recover X coordinate'); } } if ($x->isOdd() != $sign) { $x = $x->negate(); } return [$x, $y]; } /** * Extract Secret Scalar * * Implements steps 1-3 at https://tools.ietf.org/html/rfc8032#section-5.1.5 * * Used by the various key handlers * * @param string $str * @return array */ public function extractSecret($str) { if (strlen($str) != 32) { throw new \LengthException('Private Key should be 32-bytes long'); } // 1. Hash the 32-byte private key using SHA-512, storing the digest in // a 64-octet large buffer, denoted h. Only the lower 32 bytes are // used for generating the public key. $hash = new Hash('sha512'); $h = $hash->hash($str); $h = substr($h, 0, 32); // 2. Prune the buffer: The lowest three bits of the first octet are // cleared, the highest bit of the last octet is cleared, and the // second highest bit of the last octet is set. $h[0] = $h[0] & chr(0xF8); $h = strrev($h); $h[0] = ($h[0] & chr(0x3F)) | chr(0x40); // 3. Interpret the buffer as the little-endian integer, forming a // secret scalar s. $dA = new BigInteger($h, 256); return [ 'dA' => $dA, 'secret' => $str ]; } /** * Encode a point as a string * * @param array $point * @return string */ public function encodePoint($point) { list($x, $y) = $point; $y = $y->toBytes(); $y[0] = $y[0] & chr(0x7F); if ($x->isOdd()) { $y[0] = $y[0] | chr(0x80); } $y = strrev($y); return $y; } /** * Creates a random scalar multiplier * * @return \phpseclib3\Math\PrimeField\Integer */ public function createRandomMultiplier() { return $this->extractSecret(Random::string(32))['dA']; } /** * Converts an affine point to an extended homogeneous coordinate * * From https://tools.ietf.org/html/rfc8032#section-5.1.4 : * * A point (x,y) is represented in extended homogeneous coordinates (X, Y, Z, T), * with x = X/Z, y = Y/Z, x * y = T/Z. * * @return \phpseclib3\Math\PrimeField\Integer[] */ public function convertToInternal(array $p) { if (empty($p)) { return [clone $this->zero, clone $this->one, clone $this->one, clone $this->zero]; } if (isset($p[2])) { return $p; } $p[2] = clone $this->one; $p[3] = $p[0]->multiply($p[1]); return $p; } /** * Doubles a point on a curve * * @return FiniteField[] */ public function doublePoint(array $p) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } if (!count($p)) { return []; } if (!isset($p[2])) { throw new \RuntimeException('Affine coordinates need to be manually converted to "Jacobi" coordinates or vice versa'); } // from https://tools.ietf.org/html/rfc8032#page-12 list($x1, $y1, $z1, $t1) = $p; $a = $x1->multiply($x1); $b = $y1->multiply($y1); $c = $this->two->multiply($z1)->multiply($z1); $h = $a->add($b); $temp = $x1->add($y1); $e = $h->subtract($temp->multiply($temp)); $g = $a->subtract($b); $f = $c->add($g); $x3 = $e->multiply($f); $y3 = $g->multiply($h); $t3 = $e->multiply($h); $z3 = $f->multiply($g); return [$x3, $y3, $z3, $t3]; } /** * Adds two points on the curve * * @return FiniteField[] */ public function addPoint(array $p, array $q) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } if (!count($p) || !count($q)) { if (count($q)) { return $q; } if (count($p)) { return $p; } return []; } if (!isset($p[2]) || !isset($q[2])) { throw new \RuntimeException('Affine coordinates need to be manually converted to "Jacobi" coordinates or vice versa'); } if ($p[0]->equals($q[0])) { return !$p[1]->equals($q[1]) ? [] : $this->doublePoint($p); } // from https://tools.ietf.org/html/rfc8032#page-12 list($x1, $y1, $z1, $t1) = $p; list($x2, $y2, $z2, $t2) = $q; $a = $y1->subtract($x1)->multiply($y2->subtract($x2)); $b = $y1->add($x1)->multiply($y2->add($x2)); $c = $t1->multiply($this->two)->multiply($this->d)->multiply($t2); $d = $z1->multiply($this->two)->multiply($z2); $e = $b->subtract($a); $f = $d->subtract($c); $g = $d->add($c); $h = $b->add($a); $x3 = $e->multiply($f); $y3 = $g->multiply($h); $t3 = $e->multiply($h); $z3 = $f->multiply($g); return [$x3, $y3, $z3, $t3]; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect131r2 extends Binary { public function __construct() { $this->setModulo(131, 8, 3, 2, 0); $this->setCoefficients( '03E5A88919D7CAFCBF415F07C2176573B2', '04B8266A46C55657AC734CE38F018F2192' ); $this->setBasePoint( '0356DCD8F2F95031AD652D23951BB366A8', '0648F06D867940A5366D9E265DE9EB240F' ); $this->setOrder(new BigInteger('0400000000000000016954A233049BA98F', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class secp192r1 extends Prime { public function __construct() { $modulo = new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFFFFFFFFFFFF', 16); $this->setModulo($modulo); // algorithm 2.27 from http://diamond.boisestate.edu/~liljanab/MATH308/GuideToECC.pdf#page=66 /* in theory this should be faster than regular modular reductions save for one small issue. to convert to / from base-2**8 with BCMath you have to call bcmul() and bcdiv() a lot. to convert to / from base-2**8 with PHP64 you have to call base256_rshift() a lot. in short, converting to / from base-2**8 is pretty expensive and that expense is enough to offset whatever else might be gained by a simplified reduction algorithm. now, if PHP supported unsigned integers things might be different. no bit-shifting would be required for the PHP engine and it'd be a lot faster. but as is, BigInteger uses base-2**31 or base-2**26 depending on whether or not the system is has a 32-bit or a 64-bit OS. */ /* $m_length = $this->getLengthInBytes(); $this->setReduction(function($c) use ($m_length) { $cBytes = $c->toBytes(); $className = $this->className; if (strlen($cBytes) > 2 * $m_length) { list(, $r) = $c->divide($className::$modulo); return $r; } $c = str_pad($cBytes, 48, "\0", STR_PAD_LEFT); $c = array_reverse(str_split($c, 8)); $null = "\0\0\0\0\0\0\0\0"; $s1 = new BigInteger($c[2] . $c[1] . $c[0], 256); $s2 = new BigInteger($null . $c[3] . $c[3], 256); $s3 = new BigInteger($c[4] . $c[4] . $null, 256); $s4 = new BigInteger($c[5] . $c[5] . $c[5], 256); $r = $s1->add($s2)->add($s3)->add($s4); while ($r->compare($className::$modulo) >= 0) { $r = $r->subtract($className::$modulo); } return $r; }); */ $this->setCoefficients( new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFFFFFFFFFFFC', 16), new BigInteger('64210519E59C80E70FA7E9AB72243049FEB8DEECC146B9B1', 16) ); $this->setBasePoint( new BigInteger('188DA80EB03090F67CBF20EB43A18800F4FF0AFD82FF1012', 16), new BigInteger('07192B95FFC8DA78631011ED6B24CDD573F977A11E794811', 16) ); $this->setOrder(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFF99DEF836146BC9B1B4D22831', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect163r1 extends Binary { public function __construct() { $this->setModulo(163, 7, 6, 3, 0); $this->setCoefficients( '07B6882CAAEFA84F9554FF8428BD88E246D2782AE2', '0713612DCDDCB40AAB946BDA29CA91F73AF958AFD9' ); $this->setBasePoint( '0369979697AB43897789566789567F787A7876A654', '00435EDB42EFAFB2989D51FEFCE3C80988F41FF883' ); $this->setOrder(new BigInteger('03FFFFFFFFFFFFFFFFFFFF48AAB689C29CA710279B', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP160t1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('E95E4A5F737059DC60DFC7AD95B3D8139515620F', 16)); $this->setCoefficients( new BigInteger('E95E4A5F737059DC60DFC7AD95B3D8139515620C', 16), // eg. -3 new BigInteger('7A556B6DAE535B7B51ED2C4D7DAA7A0B5C55F380', 16) ); $this->setBasePoint( new BigInteger('B199B13B9B34EFC1397E64BAEB05ACC265FF2378', 16), new BigInteger('ADD6718B7C7C1961F0991B842443772152C9E0AD', 16) ); $this->setOrder(new BigInteger('E95E4A5F737059DC60DF5991D45029409E60FC09', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class secp384r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger( 'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFFFF0000000000000000FFFFFFFF', 16 )); $this->setCoefficients( new BigInteger( 'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFFFF0000000000000000FFFFFFFC', 16 ), new BigInteger( 'B3312FA7E23EE7E4988E056BE3F82D19181D9C6EFE8141120314088F5013875AC656398D8A2ED19D2A85C8EDD3EC2AEF', 16 ) ); $this->setBasePoint( new BigInteger( 'AA87CA22BE8B05378EB1C71EF320AD746E1D3B628BA79B9859F741E082542A385502F25DBF55296C3A545E3872760AB7', 16 ), new BigInteger( '3617DE4A96262C6F5D9E98BF9292DC29F8F41DBD289A147CE9DA3113B5F0B8C00A60B1CE1D7E819D7A431D7C90EA0E5F', 16 ) ); $this->setOrder(new BigInteger( 'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFC7634D81F4372DDF581A0DB248B0A77AECEC196ACCC52973', 16 )); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; //use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Crypt\EC\BaseCurves\KoblitzPrime; use phpseclib3\Math\BigInteger; //class secp256k1 extends Prime class secp256k1 extends KoblitzPrime { public function __construct() { $this->setModulo(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFC2F', 16)); $this->setCoefficients( new BigInteger('0000000000000000000000000000000000000000000000000000000000000000', 16), new BigInteger('0000000000000000000000000000000000000000000000000000000000000007', 16) ); $this->setOrder(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141', 16)); $this->setBasePoint( new BigInteger('79BE667EF9DCBBAC55A06295CE870B07029BFCDB2DCE28D959F2815B16F81798', 16), new BigInteger('483ADA7726A3C4655DA4FBFC0E1108A8FD17B448A68554199C47D08FFB10D4B8', 16) ); $this->basis = []; $this->basis[] = [ 'a' => new BigInteger('3086D221A7D46BCDE86C90E49284EB15', -16), 'b' => new BigInteger('FF1BBC8129FEF177D790AB8056F5401B3D', -16) ]; $this->basis[] = [ 'a' => new BigInteger('114CA50F7A8E2F3F657C1108D9D44CFD8', -16), 'b' => new BigInteger('3086D221A7D46BCDE86C90E49284EB15', -16) ]; $this->beta = $this->factory->newInteger(new BigInteger('7AE96A2B657C07106E64479EAC3434E99CF0497512F58995C1396C28719501EE', -16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect113r1 extends Binary { public function __construct() { $this->setModulo(113, 9, 0); $this->setCoefficients( '003088250CA6E7C7FE649CE85820F7', '00E8BEE4D3E2260744188BE0E9C723' ); $this->setBasePoint( '009D73616F35F4AB1407D73562C10F', '00A52830277958EE84D1315ED31886' ); $this->setOrder(new BigInteger('0100000000000000D9CCEC8A39E56F', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP256r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('A9FB57DBA1EEA9BC3E660A909D838D726E3BF623D52620282013481D1F6E5377', 16)); $this->setCoefficients( new BigInteger('7D5A0975FC2C3057EEF67530417AFFE7FB8055C126DC5C6CE94A4B44F330B5D9', 16), new BigInteger('26DC5C6CE94A4B44F330B5D9BBD77CBF958416295CF7E1CE6BCCDC18FF8C07B6', 16) ); $this->setBasePoint( new BigInteger('8BD2AEB9CB7E57CB2C4B482FFC81B7AFB9DE27E1E3BD23C23A4453BD9ACE3262', 16), new BigInteger('547EF835C3DAC4FD97F8461A14611DC9C27745132DED8E545C1D54C72F046997', 16) ); $this->setOrder(new BigInteger('A9FB57DBA1EEA9BC3E660A909D838D718C397AA3B561A6F7901E0E82974856A7', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class secp521r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('01FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' . 'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' . 'FFFF', 16)); $this->setCoefficients( new BigInteger('01FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' . 'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' . 'FFFC', 16), new BigInteger('0051953EB9618E1C9A1F929A21A0B68540EEA2DA725B99B315F3B8B489918EF1' . '09E156193951EC7E937B1652C0BD3BB1BF073573DF883D2C34F1EF451FD46B50' . '3F00', 16) ); $this->setBasePoint( new BigInteger('00C6858E06B70404E9CD9E3ECB662395B4429C648139053FB521F828AF606B4D' . '3DBAA14B5E77EFE75928FE1DC127A2FFA8DE3348B3C1856A429BF97E7E31C2E5' . 'BD66', 16), new BigInteger('011839296A789A3BC0045C8A5FB42C7D1BD998F54449579B446817AFBD17273E' . '662C97EE72995EF42640C550B9013FAD0761353C7086A272C24088BE94769FD1' . '6650', 16) ); $this->setOrder(new BigInteger('01FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' . 'FFFA51868783BF2F966B7FCC0148F709A5D03BB5C9B8899C47AEBB6FB71E9138' . '6409', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect571k1 extends Binary { public function __construct() { $this->setModulo(571, 10, 5, 2, 0); $this->setCoefficients( '000000000000000000000000000000000000000000000000000000000000000000000000' . '000000000000000000000000000000000000000000000000000000000000000000000000', '000000000000000000000000000000000000000000000000000000000000000000000000' . '000000000000000000000000000000000000000000000000000000000000000000000001' ); $this->setBasePoint( '026EB7A859923FBC82189631F8103FE4AC9CA2970012D5D46024804801841CA443709584' . '93B205E647DA304DB4CEB08CBBD1BA39494776FB988B47174DCA88C7E2945283A01C8972', '0349DC807F4FBF374F4AEADE3BCA95314DD58CEC9F307A54FFC61EFC006D8A2C9D4979C0' . 'AC44AEA74FBEBBB9F772AEDCB620B01A7BA7AF1B320430C8591984F601CD4C143EF1C7A3' ); $this->setOrder(new BigInteger( '020000000000000000000000000000000000000000000000000000000000000000000000' . '131850E1F19A63E4B391A8DB917F4138B630D84BE5D639381E91DEB45CFE778F637C1001', 16 )); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP192r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('C302F41D932A36CDA7A3463093D18DB78FCE476DE1A86297', 16)); $this->setCoefficients( new BigInteger('6A91174076B1E0E19C39C031FE8685C1CAE040E5C69A28EF', 16), new BigInteger('469A28EF7C28CCA3DC721D044F4496BCCA7EF4146FBF25C9', 16) ); $this->setBasePoint( new BigInteger('C0A0647EAAB6A48753B033C56CB0F0900A2F5C4853375FD6', 16), new BigInteger('14B690866ABD5BB88B5F4828C1490002E6773FA2FA299B8F', 16) ); $this->setOrder(new BigInteger('C302F41D932A36CDA7A3462F9E9E916B5BE8F1029AC4ACC1', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistk233 extends sect233k1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP224r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('D7C134AA264366862A18302575D1D787B09F075797DA89F57EC8C0FF', 16)); $this->setCoefficients( new BigInteger('68A5E62CA9CE6C1C299803A6C1530B514E182AD8B0042A59CAD29F43', 16), new BigInteger('2580F63CCFE44138870713B1A92369E33E2135D266DBB372386C400B', 16) ); $this->setBasePoint( new BigInteger('0D9029AD2C7E5CF4340823B2A87DC68C9E4CE3174C1E6EFDEE12C07D', 16), new BigInteger('58AA56F772C0726F24C6B89E4ECDAC24354B9E99CAA3F6D3761402CD', 16) ); $this->setOrder(new BigInteger('D7C134AA264366862A18302575D0FB98D116BC4B6DDEBCA3A5A7939F', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class prime239v1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFF7FFFFFFFFFFF8000000000007FFFFFFFFFFF', 16)); $this->setCoefficients( new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFF7FFFFFFFFFFF8000000000007FFFFFFFFFFC', 16), new BigInteger('6B016C3BDCF18941D0D654921475CA71A9DB2FB27D1D37796185C2942C0A', 16) ); $this->setBasePoint( new BigInteger('0FFA963CDCA8816CCC33B8642BEDF905C3D358573D3F27FBBD3B3CB9AAAF', 16), new BigInteger('7DEBE8E4E90A5DAE6E4054CA530BA04654B36818CE226B39FCCB7B02F1AE', 16) ); $this->setOrder(new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFF7FFFFF9E5E9A9F5D9071FBD1522688909D0B', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP384t1 extends Prime { public function __construct() { $this->setModulo(new BigInteger( '8CB91E82A3386D280F5D6F7E50E641DF152F7109ED5456B412B1DA197FB71123ACD3A729901D1A7' . '1874700133107EC53', 16 )); $this->setCoefficients( new BigInteger( '8CB91E82A3386D280F5D6F7E50E641DF152F7109ED5456B412B1DA197FB71123ACD3A729901' . 'D1A71874700133107EC50', 16 ), // eg. -3 new BigInteger( '7F519EADA7BDA81BD826DBA647910F8C4B9346ED8CCDC64E4B1ABD11756DCE1D2074AA263B8' . '8805CED70355A33B471EE', 16 ) ); $this->setBasePoint( new BigInteger( '18DE98B02DB9A306F2AFCD7235F72A819B80AB12EBD653172476FECD462AABFFC4FF191B946' . 'A5F54D8D0AA2F418808CC', 16 ), new BigInteger( '25AB056962D30651A114AFD2755AD336747F93475B7A1FCA3B88F2B6A208CCFE469408584DC' . '2B2912675BF5B9E582928', 16 ) ); $this->setOrder(new BigInteger( '8CB91E82A3386D280F5D6F7E50E641DF152F7109ED5456B31F166E6CAC0425A7CF3AB6AF6B7FC31' . '03B883202E9046565', 16 )); } } * @copyright 2019 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Montgomery; use phpseclib3\Math\BigInteger; class Curve448 extends Montgomery { public function __construct() { // 2^448 - 2^224 - 1 $this->setModulo(new BigInteger( 'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFE' . 'FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF', 16 )); $this->a24 = $this->factory->newInteger(new BigInteger('39081')); $this->p = [$this->factory->newInteger(new BigInteger(5))]; // 2^446 - 0x8335dc163bb124b65129c96fde933d8d723a70aadc873d6d54a7bb0d $this->setOrder(new BigInteger( '3FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' . '7CCA23E9C44EDB49AED63690216CC2728DC58F552378C292AB5844F3', 16 )); /* $this->setCoefficients( new BigInteger('156326'), // a ); $this->setBasePoint( new BigInteger(5), new BigInteger( '355293926785568175264127502063783334808976399387714271831880898' . '435169088786967410002932673765864550910142774147268105838985595290' . '606362') ); */ } /** * Multiply a point on the curve by a scalar * * Modifies the scalar as described at https://tools.ietf.org/html/rfc7748#page-8 * * @return array */ public function multiplyPoint(array $p, BigInteger $d) { //$r = strrev(sodium_crypto_scalarmult($d->toBytes(), strrev($p[0]->toBytes()))); //return [$this->factory->newInteger(new BigInteger($r, 256))]; $d = $d->toBytes(); $d[0] = $d[0] & "\xFC"; $d = strrev($d); $d |= "\x80"; $d = new BigInteger($d, 256); return parent::multiplyPoint($p, $d); } /** * Creates a random scalar multiplier * * @return BigInteger */ public function createRandomMultiplier() { return BigInteger::random(446); } /** * Performs range check */ public function rangeCheck(BigInteger $x) { if ($x->getLength() > 448 || $x->isNegative()) { throw new \RangeException('x must be a positive integer less than 446 bytes in length'); } } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class prime256v1 extends secp256r1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP320t1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('D35E472036BC4FB7E13C785ED201E065F98FCFA6F6F40DEF4F9' . '2B9EC7893EC28FCD412B1F1B32E27', 16)); $this->setCoefficients( new BigInteger('D35E472036BC4FB7E13C785ED201E065F98FCFA6F6F40DEF4F92B9EC7893EC28' . 'FCD412B1F1B32E24', 16), // eg. -3 new BigInteger('A7F561E038EB1ED560B3D147DB782013064C19F27ED27C6780AAF77FB8A547CE' . 'B5B4FEF422340353', 16) ); $this->setBasePoint( new BigInteger('925BE9FB01AFC6FB4D3E7D4990010F813408AB106C4F09CB7EE07868CC136FFF' . '3357F624A21BED52', 16), new BigInteger('63BA3A7A27483EBF6671DBEF7ABB30EBEE084E58A0B077AD42A5A0989D1EE71B' . '1B9BC0455FB0D2C3', 16) ); $this->setOrder(new BigInteger('D35E472036BC4FB7E13C785ED201E065F98FCFA5B68F12A32D4' . '82EC7EE8658E98691555B44C59311', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP160r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('E95E4A5F737059DC60DFC7AD95B3D8139515620F', 16)); $this->setCoefficients( new BigInteger('340E7BE2A280EB74E2BE61BADA745D97E8F7C300', 16), new BigInteger('1E589A8595423412134FAA2DBDEC95C8D8675E58', 16) ); $this->setBasePoint( new BigInteger('BED5AF16EA3F6A4F62938C4631EB5AF7BDBCDBC3', 16), new BigInteger('1667CB477A1A8EC338F94741669C976316DA6321', 16) ); $this->setOrder(new BigInteger('E95E4A5F737059DC60DF5991D45029409E60FC09', 16)); } } * @copyright 2019 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Montgomery; use phpseclib3\Math\BigInteger; class Curve25519 extends Montgomery { public function __construct() { // 2^255 - 19 $this->setModulo(new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFED', 16)); $this->a24 = $this->factory->newInteger(new BigInteger('121666')); $this->p = [$this->factory->newInteger(new BigInteger(9))]; // 2^252 + 0x14def9dea2f79cd65812631a5cf5d3ed $this->setOrder(new BigInteger('1000000000000000000000000000000014DEF9DEA2F79CD65812631A5CF5D3ED', 16)); /* $this->setCoefficients( new BigInteger('486662'), // a ); $this->setBasePoint( new BigInteger(9), new BigInteger('14781619447589544791020593568409986887264606134616475288964881837755586237401') ); */ } /** * Multiply a point on the curve by a scalar * * Modifies the scalar as described at https://tools.ietf.org/html/rfc7748#page-8 * * @return array */ public function multiplyPoint(array $p, BigInteger $d) { //$r = strrev(sodium_crypto_scalarmult($d->toBytes(), strrev($p[0]->toBytes()))); //return [$this->factory->newInteger(new BigInteger($r, 256))]; $d = $d->toBytes(); $d &= "\xF8" . str_repeat("\xFF", 30) . "\x7F"; $d = strrev($d); $d |= "\x40"; $d = new BigInteger($d, -256); return parent::multiplyPoint($p, $d); } /** * Creates a random scalar multiplier * * @return BigInteger */ public function createRandomMultiplier() { return BigInteger::random(256); } /** * Performs range check */ public function rangeCheck(BigInteger $x) { if ($x->getLength() > 256 || $x->isNegative()) { throw new \RangeException('x must be a positive integer less than 256 bytes in length'); } } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class prime192v2 extends Prime { public function __construct() { $this->setModulo(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFFFFFFFFFFFF', 16)); $this->setCoefficients( new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFFFFFFFFFFFC', 16), new BigInteger('CC22D6DFB95C6B25E49C0D6364A4E5980C393AA21668D953', 16) ); $this->setBasePoint( new BigInteger('EEA2BAE7E1497842F2DE7769CFE9C989C072AD696F48034A', 16), new BigInteger('6574D11D69B6EC7A672BB82A083DF2F2B0847DE970B2DE15', 16) ); $this->setOrder(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFE5FB1A724DC80418648D8DD31', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP256t1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('A9FB57DBA1EEA9BC3E660A909D838D726E3BF623D52620282013481D1F6E5377', 16)); $this->setCoefficients( new BigInteger('A9FB57DBA1EEA9BC3E660A909D838D726E3BF623D52620282013481D1F6E5374', 16), // eg. -3 new BigInteger('662C61C430D84EA4FE66A7733D0B76B7BF93EBC4AF2F49256AE58101FEE92B04', 16) ); $this->setBasePoint( new BigInteger('A3E8EB3CC1CFE7B7732213B23A656149AFA142C47AAFBC2B79A191562E1305F4', 16), new BigInteger('2D996C823439C56D7F7B22E14644417E69BCB6DE39D027001DABE8F35B25C9BE', 16) ); $this->setOrder(new BigInteger('A9FB57DBA1EEA9BC3E660A909D838D718C397AA3B561A6F7901E0E82974856A7', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistb233 extends sect233r1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect163k1 extends Binary { public function __construct() { $this->setModulo(163, 7, 6, 3, 0); $this->setCoefficients( '000000000000000000000000000000000000000001', '000000000000000000000000000000000000000001' ); $this->setBasePoint( '02FE13C0537BBC11ACAA07D793DE4E6D5E5C94EEE8', '0289070FB05D38FF58321F2E800536D538CCDAA3D9' ); $this->setOrder(new BigInteger('04000000000000000000020108A2E0CC0D99F8A5EF', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP384r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger( '8CB91E82A3386D280F5D6F7E50E641DF152F7109ED5456B412B1DA197FB71123ACD3A729901D1A7' . '1874700133107EC53', 16 )); $this->setCoefficients( new BigInteger( '7BC382C63D8C150C3C72080ACE05AFA0C2BEA28E4FB22787139165EFBA91F90F8AA5814A503' . 'AD4EB04A8C7DD22CE2826', 16 ), new BigInteger( '4A8C7DD22CE28268B39B55416F0447C2FB77DE107DCD2A62E880EA53EEB62D57CB4390295DB' . 'C9943AB78696FA504C11', 16 ) ); $this->setBasePoint( new BigInteger( '1D1C64F068CF45FFA2A63A81B7C13F6B8847A3E77EF14FE3DB7FCAFE0CBD10E8E826E03436D' . '646AAEF87B2E247D4AF1E', 16 ), new BigInteger( '8ABE1D7520F9C2A45CB1EB8E95CFD55262B70B29FEEC5864E19C054FF99129280E464621779' . '1811142820341263C5315', 16 ) ); $this->setOrder(new BigInteger( '8CB91E82A3386D280F5D6F7E50E641DF152F7109ED5456B31F166E6CAC0425A7CF3AB6AF6B7FC31' . '03B883202E9046565', 16 )); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP320r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('D35E472036BC4FB7E13C785ED201E065F98FCFA6F6F40DEF4F9' . '2B9EC7893EC28FCD412B1F1B32E27', 16)); $this->setCoefficients( new BigInteger('3EE30B568FBAB0F883CCEBD46D3F3BB8A2A73513F5EB79DA66190EB085FFA9F4' . '92F375A97D860EB4', 16), new BigInteger('520883949DFDBC42D3AD198640688A6FE13F41349554B49ACC31DCCD88453981' . '6F5EB4AC8FB1F1A6', 16) ); $this->setBasePoint( new BigInteger('43BD7E9AFB53D8B85289BCC48EE5BFE6F20137D10A087EB6E7871E2A10A599C7' . '10AF8D0D39E20611', 16), new BigInteger('14FDD05545EC1CC8AB4093247F77275E0743FFED117182EAA9C77877AAAC6AC7' . 'D35245D1692E8EE1', 16) ); $this->setOrder(new BigInteger('D35E472036BC4FB7E13C785ED201E065F98FCFA5B68F12A32D4' . '82EC7EE8658E98691555B44C59311', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect571r1 extends Binary { public function __construct() { $this->setModulo(571, 10, 5, 2, 0); $this->setCoefficients( '000000000000000000000000000000000000000000000000000000000000000000000000' . '000000000000000000000000000000000000000000000000000000000000000000000001', '02F40E7E2221F295DE297117B7F3D62F5C6A97FFCB8CEFF1CD6BA8CE4A9A18AD84FFABBD' . '8EFA59332BE7AD6756A66E294AFD185A78FF12AA520E4DE739BACA0C7FFEFF7F2955727A' ); $this->setBasePoint( '0303001D34B856296C16C0D40D3CD7750A93D1D2955FA80AA5F40FC8DB7B2ABDBDE53950' . 'F4C0D293CDD711A35B67FB1499AE60038614F1394ABFA3B4C850D927E1E7769C8EEC2D19', '037BF27342DA639B6DCCFFFEB73D69D78C6C27A6009CBBCA1980F8533921E8A684423E43' . 'BAB08A576291AF8F461BB2A8B3531D2F0485C19B16E2F1516E23DD3C1A4827AF1B8AC15B' ); $this->setOrder(new BigInteger( '03FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' . 'E661CE18FF55987308059B186823851EC7DD9CA1161DE93D5174D66E8382E9BB2FE84E47', 16 )); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class secp160r2 extends Prime { public function __construct() { // same as secp160k1 $this->setModulo(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFAC73', 16)); $this->setCoefficients( new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFAC70', 16), new BigInteger('B4E134D3FB59EB8BAB57274904664D5AF50388BA', 16) ); $this->setBasePoint( new BigInteger('52DCB034293A117E1F4FF11B30F7199D3144CE6D', 16), new BigInteger('FEAFFEF2E331F296E071FA0DF9982CFEA7D43F2E', 16) ); $this->setOrder(new BigInteger('0100000000000000000000351EE786A818F3A1A16B', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class brainpoolP512t1 extends Prime { public function __construct() { $this->setModulo(new BigInteger( 'AADD9DB8DBE9C48B3FD4E6AE33C9FC07CB308DB3B3C9D20ED6639CCA703308717D4D9B009BC' . '66842AECDA12AE6A380E62881FF2F2D82C68528AA6056583A48F3', 16 )); $this->setCoefficients( new BigInteger( 'AADD9DB8DBE9C48B3FD4E6AE33C9FC07CB308DB3B3C9D20ED6639CCA703308717D4D9B009BC' . '66842AECDA12AE6A380E62881FF2F2D82C68528AA6056583A48F0', 16 ), // eg. -3 new BigInteger( '7CBBBCF9441CFAB76E1890E46884EAE321F70C0BCB4981527897504BEC3E36A62BCDFA23049' . '76540F6450085F2DAE145C22553B465763689180EA2571867423E', 16 ) ); $this->setBasePoint( new BigInteger( '640ECE5C12788717B9C1BA06CBC2A6FEBA85842458C56DDE9DB1758D39C0313D82BA51735CD' . 'B3EA499AA77A7D6943A64F7A3F25FE26F06B51BAA2696FA9035DA', 16 ), new BigInteger( '5B534BD595F5AF0FA2C892376C84ACE1BB4E3019B71634C01131159CAE03CEE9D9932184BEE' . 'F216BD71DF2DADF86A627306ECFF96DBB8BACE198B61E00F8B332', 16 ) ); $this->setOrder(new BigInteger( 'AADD9DB8DBE9C48B3FD4E6AE33C9FC07CB308DB3B3C9D20ED6639CCA70330870553E5C414CA' . '92619418661197FAC10471DB1D381085DDADDB58796829CA90069', 16 )); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class prime192v1 extends secp192r1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class secp128r2 extends Prime { public function __construct() { // same as secp128r1 $this->setModulo(new BigInteger('FFFFFFFDFFFFFFFFFFFFFFFFFFFFFFFF', 16)); $this->setCoefficients( new BigInteger('D6031998D1B3BBFEBF59CC9BBFF9AEE1', 16), new BigInteger('5EEEFCA380D02919DC2C6558BB6D8A5D', 16) ); $this->setBasePoint( new BigInteger('7B6AA5D85E572983E6FB32A7CDEBC140', 16), new BigInteger('27B6916A894D3AEE7106FE805FC34B44', 16) ); $this->setOrder(new BigInteger('3FFFFFFF7FFFFFFFBE0024720613B5A3', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class secp224r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF000000000000000000000001', 16)); $this->setCoefficients( new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFFFFFFFFFFFFFFFFFFFE', 16), new BigInteger('B4050A850C04B3ABF54132565044B0B7D7BFD8BA270B39432355FFB4', 16) ); $this->setBasePoint( new BigInteger('B70E0CBD6BB4BF7F321390B94A03C1D356C21122343280D6115C1D21', 16), new BigInteger('BD376388B5F723FB4C22DFE6CD4375A05A07476444D5819985007E34', 16) ); $this->setOrder(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFF16A2E0B8F03E13DD29455C5C2A3D', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistb409 extends sect409r1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistk409 extends sect409k1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\KoblitzPrime; use phpseclib3\Math\BigInteger; class secp160k1 extends KoblitzPrime { public function __construct() { // same as secp160r2 $this->setModulo(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFAC73', 16)); $this->setCoefficients( new BigInteger('0000000000000000000000000000000000000000', 16), new BigInteger('0000000000000000000000000000000000000007', 16) ); $this->setBasePoint( new BigInteger('3B4C382CE37AA192A4019E763036F4F5DD4D7EBB', 16), new BigInteger('938CF935318FDCED6BC28286531733C3F03C4FEE', 16) ); $this->setOrder(new BigInteger('0100000000000000000001B8FA16DFAB9ACA16B6B3', 16)); $this->basis = []; $this->basis[] = [ 'a' => new BigInteger('0096341F1138933BC2F505', -16), 'b' => new BigInteger('FF6E9D0418C67BB8D5F562', -16) ]; $this->basis[] = [ 'a' => new BigInteger('01BDCB3A09AAAABEAFF4A8', -16), 'b' => new BigInteger('04D12329FF0EF498EA67', -16) ]; $this->beta = $this->factory->newInteger(new BigInteger('645B7345A143464942CC46D7CF4D5D1E1E6CBB68', -16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; final class nistp384 extends secp384r1 { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class prime239v3 extends Prime { public function __construct() { $this->setModulo(new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFF7FFFFFFFFFFF8000000000007FFFFFFFFFFF', 16)); $this->setCoefficients( new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFF7FFFFFFFFFFF8000000000007FFFFFFFFFFC', 16), new BigInteger('255705FA2A306654B1F4CB03D6A750A30C250102D4988717D9BA15AB6D3E', 16) ); $this->setBasePoint( new BigInteger('6768AE8E18BB92CFCF005C949AA2C6D94853D0E660BBF854B1C9505FE95A', 16), new BigInteger('1607E6898F390C06BC1D552BAD226F3B6FCFE48B6E818499AF18E3ED6CF3', 16) ); $this->setOrder(new BigInteger('7FFFFFFFFFFFFFFFFFFFFFFF7FFFFF975DEB41B3A6057C3C432146526551', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect193r2 extends Binary { public function __construct() { $this->setModulo(193, 15, 0); $this->setCoefficients( '0163F35A5137C2CE3EA6ED8667190B0BC43ECD69977702709B', '00C9BB9E8927D4D64C377E2AB2856A5B16E3EFB7F61D4316AE' ); $this->setBasePoint( '00D9B67D192E0367C803F39E1A7E82CA14A651350AAE617E8F', '01CE94335607C304AC29E7DEFBD9CA01F596F927224CDECF6C' ); $this->setOrder(new BigInteger('010000000000000000000000015AAB561B005413CCD4EE99D5', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect409r1 extends Binary { public function __construct() { $this->setModulo(409, 87, 0); $this->setCoefficients( '00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001', '0021A5C2C8EE9FEB5C4B9A753B7B476B7FD6422EF1F3DD674761FA99D6AC27C8A9A197B272822F6CD57A55AA4F50AE317B13545F' ); $this->setBasePoint( '015D4860D088DDB3496B0C6064756260441CDE4AF1771D4DB01FFE5B34E59703DC255A868A1180515603AEAB60794E54BB7996A7', '0061B1CFAB6BE5F32BBFA78324ED106A7636B9C5A7BD198D0158AA4F5488D08F38514F1FDF4B4F40D2181B3681C364BA0273C706' ); $this->setOrder(new BigInteger( '010000000000000000000000000000000000000000000000000001E2' . 'AAD6A612F33307BE5FA47C3C9E052F838164CD37D9A21173', 16 )); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect113r2 extends Binary { public function __construct() { $this->setModulo(113, 9, 0); $this->setCoefficients( '00689918DBEC7E5A0DD6DFC0AA55C7', '0095E9A9EC9B297BD4BF36E059184F' ); $this->setBasePoint( '01A57A6A7B26CA5EF52FCDB8164797', '00B3ADC94ED1FE674C06E695BABA1D' ); $this->setOrder(new BigInteger('010000000000000108789B2496AF93', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class prime192v3 extends Prime { public function __construct() { $this->setModulo(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFFFFFFFFFFFF', 16)); $this->setCoefficients( new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFFFFFFFFFFFC', 16), new BigInteger('22123DC2395A05CAA7423DAECCC94760A7D462256BD56916', 16) ); $this->setBasePoint( new BigInteger('7D29778100C65A1DA1783716588DCE2B8B4AEE8E228F1896', 16), new BigInteger('38A90F22637337334B49DCB66A6DC8F9978ACA7648A943B0', 16) ); $this->setOrder(new BigInteger('FFFFFFFFFFFFFFFFFFFFFFFF7A62D031C83F4294F640EC13', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Prime; use phpseclib3\Math\BigInteger; class secp256r1 extends Prime { public function __construct() { $this->setModulo(new BigInteger('FFFFFFFF00000001000000000000000000000000FFFFFFFFFFFFFFFFFFFFFFFF', 16)); $this->setCoefficients( new BigInteger('FFFFFFFF00000001000000000000000000000000FFFFFFFFFFFFFFFFFFFFFFFC', 16), new BigInteger('5AC635D8AA3A93E7B3EBBD55769886BC651D06B0CC53B0F63BCE3C3E27D2604B', 16) ); $this->setBasePoint( new BigInteger('6B17D1F2E12C4247F8BCE6E563A440F277037D812DEB33A0F4A13945D898C296', 16), new BigInteger('4FE342E2FE1A7F9B8EE7EB4A7C0F9E162BCE33576B315ECECBB6406837BF51F5', 16) ); $this->setOrder(new BigInteger('FFFFFFFF00000000FFFFFFFFFFFFFFFFBCE6FAADA7179E84F3B9CAC2FC632551', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\Curves; use phpseclib3\Crypt\EC\BaseCurves\Binary; use phpseclib3\Math\BigInteger; class sect233r1 extends Binary { public function __construct() { $this->setModulo(233, 74, 0); $this->setCoefficients( '000000000000000000000000000000000000000000000000000000000001', '0066647EDE6C332C7F8C0923BB58213B333B20E9CE4281FE115F7D8F90AD' ); $this->setBasePoint( '00FAC9DFCBAC8313BB2139F1BB755FEF65BC391F8B36F8F8EB7371FD558B', '01006A08A41903350678E58528BEBF8A0BEFF867A7CA36716F7E01F81052' ); $this->setOrder(new BigInteger('01000000000000000000000000000013E974E72F8A6922031D2603CFE0D7', 16)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\BaseCurves; use phpseclib3\Math\BigInteger; /** * Base * * @author Jim Wigginton */ abstract class Base { /** * The Order * * @var BigInteger */ protected $order; /** * Finite Field Integer factory * * @var \phpseclib3\Math\FiniteField\Integer */ protected $factory; /** * Returns a random integer * * @return object */ public function randomInteger() { return $this->factory->randomInteger(); } /** * Converts a BigInteger to a \phpseclib3\Math\FiniteField\Integer integer * * @return object */ public function convertInteger(BigInteger $x) { return $this->factory->newInteger($x); } /** * Returns the length, in bytes, of the modulo * * @return integer */ public function getLengthInBytes() { return $this->factory->getLengthInBytes(); } /** * Returns the length, in bits, of the modulo * * @return integer */ public function getLength() { return $this->factory->getLength(); } /** * Multiply a point on the curve by a scalar * * Uses the montgomery ladder technique as described here: * * https://en.wikipedia.org/wiki/Elliptic_curve_point_multiplication#Montgomery_ladder * https://github.com/phpecc/phpecc/issues/16#issuecomment-59176772 * * @return array */ public function multiplyPoint(array $p, BigInteger $d) { $alreadyInternal = isset($p[2]); $r = $alreadyInternal ? [[], $p] : [[], $this->convertToInternal($p)]; $d = $d->toBits(); for ($i = 0; $i < strlen($d); $i++) { $d_i = (int) $d[$i]; $r[1 - $d_i] = $this->addPoint($r[0], $r[1]); $r[$d_i] = $this->doublePoint($r[$d_i]); } return $alreadyInternal ? $r[0] : $this->convertToAffine($r[0]); } /** * Creates a random scalar multiplier * * @return BigInteger */ public function createRandomMultiplier() { static $one; if (!isset($one)) { $one = new BigInteger(1); } return BigInteger::randomRange($one, $this->order->subtract($one)); } /** * Performs range check */ public function rangeCheck(BigInteger $x) { static $zero; if (!isset($zero)) { $zero = new BigInteger(); } if (!isset($this->order)) { throw new \RuntimeException('setOrder needs to be called before this method'); } if ($x->compare($this->order) > 0 || $x->compare($zero) <= 0) { throw new \RangeException('x must be between 1 and the order of the curve'); } } /** * Sets the Order */ public function setOrder(BigInteger $order) { $this->order = $order; } /** * Returns the Order * * @return \phpseclib3\Math\BigInteger */ public function getOrder() { return $this->order; } /** * Use a custom defined modular reduction function * * @return object */ public function setReduction(callable $func) { $this->factory->setReduction($func); } /** * Returns the affine point * * @return object[] */ public function convertToAffine(array $p) { return $p; } /** * Converts an affine point to a jacobian coordinate * * @return object[] */ public function convertToInternal(array $p) { return $p; } /** * Negates a point * * @return object[] */ public function negatePoint(array $p) { $temp = [ $p[0], $p[1]->negate() ]; if (isset($p[2])) { $temp[] = $p[2]; } return $temp; } /** * Multiply and Add Points * * @return int[] */ public function multiplyAddPoints(array $points, array $scalars) { $p1 = $this->convertToInternal($points[0]); $p2 = $this->convertToInternal($points[1]); $p1 = $this->multiplyPoint($p1, $scalars[0]); $p2 = $this->multiplyPoint($p2, $scalars[1]); $r = $this->addPoint($p1, $p2); return $this->convertToAffine($r); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\BaseCurves; use phpseclib3\Math\BigInteger; use phpseclib3\Math\PrimeField; use phpseclib3\Math\PrimeField\Integer as PrimeInteger; /** * Curves over a*x^2 + y^2 = 1 + d*x^2*y^2 * * @author Jim Wigginton */ class TwistedEdwards extends Base { /** * The modulo * * @var BigInteger */ protected $modulo; /** * Cofficient for x^2 * * @var object */ protected $a; /** * Cofficient for x^2*y^2 * * @var object */ protected $d; /** * Base Point * * @var object[] */ protected $p; /** * The number zero over the specified finite field * * @var object */ protected $zero; /** * The number one over the specified finite field * * @var object */ protected $one; /** * The number two over the specified finite field * * @var object */ protected $two; /** * Sets the modulo */ public function setModulo(BigInteger $modulo) { $this->modulo = $modulo; $this->factory = new PrimeField($modulo); $this->zero = $this->factory->newInteger(new BigInteger(0)); $this->one = $this->factory->newInteger(new BigInteger(1)); $this->two = $this->factory->newInteger(new BigInteger(2)); } /** * Set coefficients a and b */ public function setCoefficients(BigInteger $a, BigInteger $d) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } $this->a = $this->factory->newInteger($a); $this->d = $this->factory->newInteger($d); } /** * Set x and y coordinates for the base point */ public function setBasePoint($x, $y) { switch (true) { case !$x instanceof BigInteger && !$x instanceof PrimeInteger: throw new \UnexpectedValueException('Argument 1 passed to Prime::setBasePoint() must be an instance of either BigInteger or PrimeField\Integer'); case !$y instanceof BigInteger && !$y instanceof PrimeInteger: throw new \UnexpectedValueException('Argument 2 passed to Prime::setBasePoint() must be an instance of either BigInteger or PrimeField\Integer'); } if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } $this->p = [ $x instanceof BigInteger ? $this->factory->newInteger($x) : $x, $y instanceof BigInteger ? $this->factory->newInteger($y) : $y ]; } /** * Returns the a coefficient * * @return \phpseclib3\Math\PrimeField\Integer */ public function getA() { return $this->a; } /** * Returns the a coefficient * * @return \phpseclib3\Math\PrimeField\Integer */ public function getD() { return $this->d; } /** * Retrieve the base point as an array * * @return array */ public function getBasePoint() { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } /* if (!isset($this->p)) { throw new \RuntimeException('setBasePoint needs to be called before this method'); } */ return $this->p; } /** * Returns the affine point * * @return \phpseclib3\Math\PrimeField\Integer[] */ public function convertToAffine(array $p) { if (!isset($p[2])) { return $p; } list($x, $y, $z) = $p; $z = $this->one->divide($z); return [ $x->multiply($z), $y->multiply($z) ]; } /** * Returns the modulo * * @return \phpseclib3\Math\BigInteger */ public function getModulo() { return $this->modulo; } /** * Tests whether or not the x / y values satisfy the equation * * @return boolean */ public function verifyPoint(array $p) { list($x, $y) = $p; $x2 = $x->multiply($x); $y2 = $y->multiply($y); $lhs = $this->a->multiply($x2)->add($y2); $rhs = $this->d->multiply($x2)->multiply($y2)->add($this->one); return $lhs->equals($rhs); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\BaseCurves; use phpseclib3\Math\BigInteger; use phpseclib3\Math\BinaryField; use phpseclib3\Math\BinaryField\Integer as BinaryInteger; /** * Curves over y^2 + x*y = x^3 + a*x^2 + b * * @author Jim Wigginton */ class Binary extends Base { /** * Binary Field Integer factory * * @var \phpseclib3\Math\BinaryField */ protected $factory; /** * Cofficient for x^1 * * @var object */ protected $a; /** * Cofficient for x^0 * * @var object */ protected $b; /** * Base Point * * @var object */ protected $p; /** * The number one over the specified finite field * * @var object */ protected $one; /** * The modulo * * @var BigInteger */ protected $modulo; /** * The Order * * @var BigInteger */ protected $order; /** * Sets the modulo */ public function setModulo(...$modulo) { $this->modulo = $modulo; $this->factory = new BinaryField(...$modulo); $this->one = $this->factory->newInteger("\1"); } /** * Set coefficients a and b * * @param string $a * @param string $b */ public function setCoefficients($a, $b) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } $this->a = $this->factory->newInteger(pack('H*', $a)); $this->b = $this->factory->newInteger(pack('H*', $b)); } /** * Set x and y coordinates for the base point * * @param string|BinaryInteger $x * @param string|BinaryInteger $y */ public function setBasePoint($x, $y) { switch (true) { case !is_string($x) && !$x instanceof BinaryInteger: throw new \UnexpectedValueException('Argument 1 passed to Binary::setBasePoint() must be a string or an instance of BinaryField\Integer'); case !is_string($y) && !$y instanceof BinaryInteger: throw new \UnexpectedValueException('Argument 2 passed to Binary::setBasePoint() must be a string or an instance of BinaryField\Integer'); } if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } $this->p = [ is_string($x) ? $this->factory->newInteger(pack('H*', $x)) : $x, is_string($y) ? $this->factory->newInteger(pack('H*', $y)) : $y ]; } /** * Retrieve the base point as an array * * @return array */ public function getBasePoint() { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } /* if (!isset($this->p)) { throw new \RuntimeException('setBasePoint needs to be called before this method'); } */ return $this->p; } /** * Adds two points on the curve * * @return FiniteField[] */ public function addPoint(array $p, array $q) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } if (!count($p) || !count($q)) { if (count($q)) { return $q; } if (count($p)) { return $p; } return []; } if (!isset($p[2]) || !isset($q[2])) { throw new \RuntimeException('Affine coordinates need to be manually converted to "Jacobi" coordinates or vice versa'); } if ($p[0]->equals($q[0])) { return !$p[1]->equals($q[1]) ? [] : $this->doublePoint($p); } // formulas from http://hyperelliptic.org/EFD/g12o/auto-shortw-jacobian.html list($x1, $y1, $z1) = $p; list($x2, $y2, $z2) = $q; $o1 = $z1->multiply($z1); $b = $x2->multiply($o1); if ($z2->equals($this->one)) { $d = $y2->multiply($o1)->multiply($z1); $e = $x1->add($b); $f = $y1->add($d); $z3 = $e->multiply($z1); $h = $f->multiply($x2)->add($z3->multiply($y2)); $i = $f->add($z3); $g = $z3->multiply($z3); $p1 = $this->a->multiply($g); $p2 = $f->multiply($i); $p3 = $e->multiply($e)->multiply($e); $x3 = $p1->add($p2)->add($p3); $y3 = $i->multiply($x3)->add($g->multiply($h)); return [$x3, $y3, $z3]; } $o2 = $z2->multiply($z2); $a = $x1->multiply($o2); $c = $y1->multiply($o2)->multiply($z2); $d = $y2->multiply($o1)->multiply($z1); $e = $a->add($b); $f = $c->add($d); $g = $e->multiply($z1); $h = $f->multiply($x2)->add($g->multiply($y2)); $z3 = $g->multiply($z2); $i = $f->add($z3); $p1 = $this->a->multiply($z3->multiply($z3)); $p2 = $f->multiply($i); $p3 = $e->multiply($e)->multiply($e); $x3 = $p1->add($p2)->add($p3); $y3 = $i->multiply($x3)->add($g->multiply($g)->multiply($h)); return [$x3, $y3, $z3]; } /** * Doubles a point on a curve * * @return FiniteField[] */ public function doublePoint(array $p) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } if (!count($p)) { return []; } if (!isset($p[2])) { throw new \RuntimeException('Affine coordinates need to be manually converted to "Jacobi" coordinates or vice versa'); } // formulas from http://hyperelliptic.org/EFD/g12o/auto-shortw-jacobian.html list($x1, $y1, $z1) = $p; $a = $x1->multiply($x1); $b = $a->multiply($a); if ($z1->equals($this->one)) { $x3 = $b->add($this->b); $z3 = clone $x1; $p1 = $a->add($y1)->add($z3)->multiply($this->b); $p2 = $a->add($y1)->multiply($b); $y3 = $p1->add($p2); return [$x3, $y3, $z3]; } $c = $z1->multiply($z1); $d = $c->multiply($c); $x3 = $b->add($this->b->multiply($d->multiply($d))); $z3 = $x1->multiply($c); $p1 = $b->multiply($z3); $p2 = $a->add($y1->multiply($z1))->add($z3)->multiply($x3); $y3 = $p1->add($p2); return [$x3, $y3, $z3]; } /** * Returns the X coordinate and the derived Y coordinate * * Not supported because it is covered by patents. * Quoting https://www.openssl.org/docs/man1.1.0/apps/ecparam.html , * * "Due to patent issues the compressed option is disabled by default for binary curves * and can be enabled by defining the preprocessor macro OPENSSL_EC_BIN_PT_COMP at * compile time." * * @return array */ public function derivePoint($m) { throw new \RuntimeException('Point compression on binary finite field elliptic curves is not supported'); } /** * Tests whether or not the x / y values satisfy the equation * * @return boolean */ public function verifyPoint(array $p) { list($x, $y) = $p; $lhs = $y->multiply($y); $lhs = $lhs->add($x->multiply($y)); $x2 = $x->multiply($x); $x3 = $x2->multiply($x); $rhs = $x3->add($this->a->multiply($x2))->add($this->b); return $lhs->equals($rhs); } /** * Returns the modulo * * @return \phpseclib3\Math\BigInteger */ public function getModulo() { return $this->modulo; } /** * Returns the a coefficient * * @return \phpseclib3\Math\PrimeField\Integer */ public function getA() { return $this->a; } /** * Returns the a coefficient * * @return \phpseclib3\Math\PrimeField\Integer */ public function getB() { return $this->b; } /** * Returns the affine point * * A Jacobian Coordinate is of the form (x, y, z). * To convert a Jacobian Coordinate to an Affine Point * you do (x / z^2, y / z^3) * * @return \phpseclib3\Math\PrimeField\Integer[] */ public function convertToAffine(array $p) { if (!isset($p[2])) { return $p; } list($x, $y, $z) = $p; $z = $this->one->divide($z); $z2 = $z->multiply($z); return [ $x->multiply($z2), $y->multiply($z2)->multiply($z) ]; } /** * Converts an affine point to a jacobian coordinate * * @return \phpseclib3\Math\PrimeField\Integer[] */ public function convertToInternal(array $p) { if (isset($p[2])) { return $p; } $p[2] = clone $this->one; $p['fresh'] = true; return $p; } } * @copyright 2019 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\BaseCurves; use phpseclib3\Crypt\EC\Curves\Curve25519; use phpseclib3\Math\BigInteger; use phpseclib3\Math\PrimeField; use phpseclib3\Math\PrimeField\Integer as PrimeInteger; /** * Curves over y^2 = x^3 + a*x + x * * @author Jim Wigginton */ class Montgomery extends Base { /** * Prime Field Integer factory * * @var \phpseclib3\Math\PrimeField */ protected $factory; /** * Cofficient for x * * @var object */ protected $a; /** * Constant used for point doubling * * @var object */ protected $a24; /** * The Number Zero * * @var object */ protected $zero; /** * The Number One * * @var object */ protected $one; /** * Base Point * * @var object */ protected $p; /** * The modulo * * @var BigInteger */ protected $modulo; /** * The Order * * @var BigInteger */ protected $order; /** * Sets the modulo */ public function setModulo(BigInteger $modulo) { $this->modulo = $modulo; $this->factory = new PrimeField($modulo); $this->zero = $this->factory->newInteger(new BigInteger()); $this->one = $this->factory->newInteger(new BigInteger(1)); } /** * Set coefficients a */ public function setCoefficients(BigInteger $a) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } $this->a = $this->factory->newInteger($a); $two = $this->factory->newInteger(new BigInteger(2)); $four = $this->factory->newInteger(new BigInteger(4)); $this->a24 = $this->a->subtract($two)->divide($four); } /** * Set x and y coordinates for the base point * * @param BigInteger|PrimeInteger $x * @param BigInteger|PrimeInteger $y * @return PrimeInteger[] */ public function setBasePoint($x, $y) { switch (true) { case !$x instanceof BigInteger && !$x instanceof PrimeInteger: throw new \UnexpectedValueException('Argument 1 passed to Prime::setBasePoint() must be an instance of either BigInteger or PrimeField\Integer'); case !$y instanceof BigInteger && !$y instanceof PrimeInteger: throw new \UnexpectedValueException('Argument 2 passed to Prime::setBasePoint() must be an instance of either BigInteger or PrimeField\Integer'); } if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } $this->p = [ $x instanceof BigInteger ? $this->factory->newInteger($x) : $x, $y instanceof BigInteger ? $this->factory->newInteger($y) : $y ]; } /** * Retrieve the base point as an array * * @return array */ public function getBasePoint() { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } /* if (!isset($this->p)) { throw new \RuntimeException('setBasePoint needs to be called before this method'); } */ return $this->p; } /** * Doubles and adds a point on a curve * * See https://tools.ietf.org/html/draft-ietf-tls-curve25519-01#appendix-A.1.3 * * @return FiniteField[][] */ private function doubleAndAddPoint(array $p, array $q, PrimeInteger $x1) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } if (!count($p) || !count($q)) { return []; } if (!isset($p[1])) { throw new \RuntimeException('Affine coordinates need to be manually converted to XZ coordinates'); } list($x2, $z2) = $p; list($x3, $z3) = $q; $a = $x2->add($z2); $aa = $a->multiply($a); $b = $x2->subtract($z2); $bb = $b->multiply($b); $e = $aa->subtract($bb); $c = $x3->add($z3); $d = $x3->subtract($z3); $da = $d->multiply($a); $cb = $c->multiply($b); $temp = $da->add($cb); $x5 = $temp->multiply($temp); $temp = $da->subtract($cb); $z5 = $x1->multiply($temp->multiply($temp)); $x4 = $aa->multiply($bb); $temp = static::class == Curve25519::class ? $bb : $aa; $z4 = $e->multiply($temp->add($this->a24->multiply($e))); return [ [$x4, $z4], [$x5, $z5] ]; } /** * Multiply a point on the curve by a scalar * * Uses the montgomery ladder technique as described here: * * https://en.wikipedia.org/wiki/Elliptic_curve_point_multiplication#Montgomery_ladder * https://github.com/phpecc/phpecc/issues/16#issuecomment-59176772 * * @return array */ public function multiplyPoint(array $p, BigInteger $d) { $p1 = [$this->one, $this->zero]; $alreadyInternal = isset($x[1]); $p2 = $this->convertToInternal($p); $x = $p[0]; $b = $d->toBits(); $b = str_pad($b, 256, '0', STR_PAD_LEFT); for ($i = 0; $i < strlen($b); $i++) { $b_i = (int) $b[$i]; if ($b_i) { list($p2, $p1) = $this->doubleAndAddPoint($p2, $p1, $x); } else { list($p1, $p2) = $this->doubleAndAddPoint($p1, $p2, $x); } } return $alreadyInternal ? $p1 : $this->convertToAffine($p1); } /** * Converts an affine point to an XZ coordinate * * From https://hyperelliptic.org/EFD/g1p/auto-montgom-xz.html * * XZ coordinates represent x y as X Z satsfying the following equations: * * x=X/Z * * @return \phpseclib3\Math\PrimeField\Integer[] */ public function convertToInternal(array $p) { if (empty($p)) { return [clone $this->zero, clone $this->one]; } if (isset($p[1])) { return $p; } $p[1] = clone $this->one; return $p; } /** * Returns the affine point * * @return \phpseclib3\Math\PrimeField\Integer[] */ public function convertToAffine(array $p) { if (!isset($p[1])) { return $p; } list($x, $z) = $p; return [$x->divide($z)]; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\BaseCurves; use phpseclib3\Common\Functions\Strings; use phpseclib3\Math\BigInteger; use phpseclib3\Math\Common\FiniteField\Integer; use phpseclib3\Math\PrimeField; use phpseclib3\Math\PrimeField\Integer as PrimeInteger; /** * Curves over y^2 = x^3 + a*x + b * * @author Jim Wigginton */ class Prime extends Base { /** * Prime Field Integer factory * * @var \phpseclib3\Math\PrimeFields */ protected $factory; /** * Cofficient for x^1 * * @var object */ protected $a; /** * Cofficient for x^0 * * @var object */ protected $b; /** * Base Point * * @var object */ protected $p; /** * The number one over the specified finite field * * @var object */ protected $one; /** * The number two over the specified finite field * * @var object */ protected $two; /** * The number three over the specified finite field * * @var object */ protected $three; /** * The number four over the specified finite field * * @var object */ protected $four; /** * The number eight over the specified finite field * * @var object */ protected $eight; /** * The modulo * * @var BigInteger */ protected $modulo; /** * The Order * * @var BigInteger */ protected $order; /** * Sets the modulo */ public function setModulo(BigInteger $modulo) { $this->modulo = $modulo; $this->factory = new PrimeField($modulo); $this->two = $this->factory->newInteger(new BigInteger(2)); $this->three = $this->factory->newInteger(new BigInteger(3)); // used by jacobian coordinates $this->one = $this->factory->newInteger(new BigInteger(1)); $this->four = $this->factory->newInteger(new BigInteger(4)); $this->eight = $this->factory->newInteger(new BigInteger(8)); } /** * Set coefficients a and b */ public function setCoefficients(BigInteger $a, BigInteger $b) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } $this->a = $this->factory->newInteger($a); $this->b = $this->factory->newInteger($b); } /** * Set x and y coordinates for the base point * * @param BigInteger|PrimeInteger $x * @param BigInteger|PrimeInteger $y * @return PrimeInteger[] */ public function setBasePoint($x, $y) { switch (true) { case !$x instanceof BigInteger && !$x instanceof PrimeInteger: throw new \UnexpectedValueException('Argument 1 passed to Prime::setBasePoint() must be an instance of either BigInteger or PrimeField\Integer'); case !$y instanceof BigInteger && !$y instanceof PrimeInteger: throw new \UnexpectedValueException('Argument 2 passed to Prime::setBasePoint() must be an instance of either BigInteger or PrimeField\Integer'); } if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } $this->p = [ $x instanceof BigInteger ? $this->factory->newInteger($x) : $x, $y instanceof BigInteger ? $this->factory->newInteger($y) : $y ]; } /** * Retrieve the base point as an array * * @return array */ public function getBasePoint() { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } /* if (!isset($this->p)) { throw new \RuntimeException('setBasePoint needs to be called before this method'); } */ return $this->p; } /** * Adds two "fresh" jacobian form on the curve * * @return FiniteField[] */ protected function jacobianAddPointMixedXY(array $p, array $q) { list($u1, $s1) = $p; list($u2, $s2) = $q; if ($u1->equals($u2)) { if (!$s1->equals($s2)) { return []; } else { return $this->doublePoint($p); } } $h = $u2->subtract($u1); $r = $s2->subtract($s1); $h2 = $h->multiply($h); $h3 = $h2->multiply($h); $v = $u1->multiply($h2); $x3 = $r->multiply($r)->subtract($h3)->subtract($v->multiply($this->two)); $y3 = $r->multiply( $v->subtract($x3) )->subtract( $s1->multiply($h3) ); return [$x3, $y3, $h]; } /** * Adds one "fresh" jacobian form on the curve * * The second parameter should be the "fresh" one * * @return FiniteField[] */ protected function jacobianAddPointMixedX(array $p, array $q) { list($u1, $s1, $z1) = $p; list($x2, $y2) = $q; $z12 = $z1->multiply($z1); $u2 = $x2->multiply($z12); $s2 = $y2->multiply($z12->multiply($z1)); if ($u1->equals($u2)) { if (!$s1->equals($s2)) { return []; } else { return $this->doublePoint($p); } } $h = $u2->subtract($u1); $r = $s2->subtract($s1); $h2 = $h->multiply($h); $h3 = $h2->multiply($h); $v = $u1->multiply($h2); $x3 = $r->multiply($r)->subtract($h3)->subtract($v->multiply($this->two)); $y3 = $r->multiply( $v->subtract($x3) )->subtract( $s1->multiply($h3) ); $z3 = $h->multiply($z1); return [$x3, $y3, $z3]; } /** * Adds two jacobian coordinates on the curve * * @return FiniteField[] */ protected function jacobianAddPoint(array $p, array $q) { list($x1, $y1, $z1) = $p; list($x2, $y2, $z2) = $q; $z12 = $z1->multiply($z1); $z22 = $z2->multiply($z2); $u1 = $x1->multiply($z22); $u2 = $x2->multiply($z12); $s1 = $y1->multiply($z22->multiply($z2)); $s2 = $y2->multiply($z12->multiply($z1)); if ($u1->equals($u2)) { if (!$s1->equals($s2)) { return []; } else { return $this->doublePoint($p); } } $h = $u2->subtract($u1); $r = $s2->subtract($s1); $h2 = $h->multiply($h); $h3 = $h2->multiply($h); $v = $u1->multiply($h2); $x3 = $r->multiply($r)->subtract($h3)->subtract($v->multiply($this->two)); $y3 = $r->multiply( $v->subtract($x3) )->subtract( $s1->multiply($h3) ); $z3 = $h->multiply($z1)->multiply($z2); return [$x3, $y3, $z3]; } /** * Adds two points on the curve * * @return FiniteField[] */ public function addPoint(array $p, array $q) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } if (!count($p) || !count($q)) { if (count($q)) { return $q; } if (count($p)) { return $p; } return []; } // use jacobian coordinates if (isset($p[2]) && isset($q[2])) { if (isset($p['fresh']) && isset($q['fresh'])) { return $this->jacobianAddPointMixedXY($p, $q); } if (isset($p['fresh'])) { return $this->jacobianAddPointMixedX($q, $p); } if (isset($q['fresh'])) { return $this->jacobianAddPointMixedX($p, $q); } return $this->jacobianAddPoint($p, $q); } if (isset($p[2]) || isset($q[2])) { throw new \RuntimeException('Affine coordinates need to be manually converted to Jacobi coordinates or vice versa'); } if ($p[0]->equals($q[0])) { if (!$p[1]->equals($q[1])) { return []; } else { // eg. doublePoint list($numerator, $denominator) = $this->doublePointHelper($p); } } else { $numerator = $q[1]->subtract($p[1]); $denominator = $q[0]->subtract($p[0]); } $slope = $numerator->divide($denominator); $x = $slope->multiply($slope)->subtract($p[0])->subtract($q[0]); $y = $slope->multiply($p[0]->subtract($x))->subtract($p[1]); return [$x, $y]; } /** * Returns the numerator and denominator of the slope * * @return FiniteField[] */ protected function doublePointHelper(array $p) { $numerator = $this->three->multiply($p[0])->multiply($p[0])->add($this->a); $denominator = $this->two->multiply($p[1]); return [$numerator, $denominator]; } /** * Doubles a jacobian coordinate on the curve * * @return FiniteField[] */ protected function jacobianDoublePoint(array $p) { list($x, $y, $z) = $p; $x2 = $x->multiply($x); $y2 = $y->multiply($y); $z2 = $z->multiply($z); $s = $this->four->multiply($x)->multiply($y2); $m1 = $this->three->multiply($x2); $m2 = $this->a->multiply($z2->multiply($z2)); $m = $m1->add($m2); $x1 = $m->multiply($m)->subtract($this->two->multiply($s)); $y1 = $m->multiply($s->subtract($x1))->subtract( $this->eight->multiply($y2->multiply($y2)) ); $z1 = $this->two->multiply($y)->multiply($z); return [$x1, $y1, $z1]; } /** * Doubles a "fresh" jacobian coordinate on the curve * * @return FiniteField[] */ protected function jacobianDoublePointMixed(array $p) { list($x, $y) = $p; $x2 = $x->multiply($x); $y2 = $y->multiply($y); $s = $this->four->multiply($x)->multiply($y2); $m1 = $this->three->multiply($x2); $m = $m1->add($this->a); $x1 = $m->multiply($m)->subtract($this->two->multiply($s)); $y1 = $m->multiply($s->subtract($x1))->subtract( $this->eight->multiply($y2->multiply($y2)) ); $z1 = $this->two->multiply($y); return [$x1, $y1, $z1]; } /** * Doubles a point on a curve * * @return FiniteField[] */ public function doublePoint(array $p) { if (!isset($this->factory)) { throw new \RuntimeException('setModulo needs to be called before this method'); } if (!count($p)) { return []; } // use jacobian coordinates if (isset($p[2])) { if (isset($p['fresh'])) { return $this->jacobianDoublePointMixed($p); } return $this->jacobianDoublePoint($p); } list($numerator, $denominator) = $this->doublePointHelper($p); $slope = $numerator->divide($denominator); $x = $slope->multiply($slope)->subtract($p[0])->subtract($p[0]); $y = $slope->multiply($p[0]->subtract($x))->subtract($p[1]); return [$x, $y]; } /** * Returns the X coordinate and the derived Y coordinate * * @return array */ public function derivePoint($m) { $y = ord(Strings::shift($m)); $x = new BigInteger($m, 256); $xp = $this->convertInteger($x); switch ($y) { case 2: $ypn = false; break; case 3: $ypn = true; break; default: throw new \RuntimeException('Coordinate not in recognized format'); } $temp = $xp->multiply($this->a); $temp = $xp->multiply($xp)->multiply($xp)->add($temp); $temp = $temp->add($this->b); $b = $temp->squareRoot(); if (!$b) { throw new \RuntimeException('Unable to derive Y coordinate'); } $bn = $b->isOdd(); $yp = $ypn == $bn ? $b : $b->negate(); return [$xp, $yp]; } /** * Tests whether or not the x / y values satisfy the equation * * @return boolean */ public function verifyPoint(array $p) { list($x, $y) = $p; $lhs = $y->multiply($y); $temp = $x->multiply($this->a); $temp = $x->multiply($x)->multiply($x)->add($temp); $rhs = $temp->add($this->b); return $lhs->equals($rhs); } /** * Returns the modulo * * @return \phpseclib3\Math\BigInteger */ public function getModulo() { return $this->modulo; } /** * Returns the a coefficient * * @return \phpseclib3\Math\PrimeField\Integer */ public function getA() { return $this->a; } /** * Returns the a coefficient * * @return \phpseclib3\Math\PrimeField\Integer */ public function getB() { return $this->b; } /** * Multiply and Add Points * * Adapted from: * https://github.com/indutny/elliptic/blob/725bd91/lib/elliptic/curve/base.js#L125 * * @return int[] */ public function multiplyAddPoints(array $points, array $scalars) { $length = count($points); foreach ($points as &$point) { $point = $this->convertToInternal($point); } $wnd = [$this->getNAFPoints($points[0], 7)]; $wndWidth = [isset($points[0]['nafwidth']) ? $points[0]['nafwidth'] : 7]; for ($i = 1; $i < $length; $i++) { $wnd[] = $this->getNAFPoints($points[$i], 1); $wndWidth[] = isset($points[$i]['nafwidth']) ? $points[$i]['nafwidth'] : 1; } $naf = []; // comb all window NAFs $max = 0; for ($i = $length - 1; $i >= 1; $i -= 2) { $a = $i - 1; $b = $i; if ($wndWidth[$a] != 1 || $wndWidth[$b] != 1) { $naf[$a] = $scalars[$a]->getNAF($wndWidth[$a]); $naf[$b] = $scalars[$b]->getNAF($wndWidth[$b]); $max = max(count($naf[$a]), count($naf[$b]), $max); continue; } $comb = [ $points[$a], // 1 null, // 3 null, // 5 $points[$b] // 7 ]; $comb[1] = $this->addPoint($points[$a], $points[$b]); $comb[2] = $this->addPoint($points[$a], $this->negatePoint($points[$b])); $index = [ -3, /* -1 -1 */ -1, /* -1 0 */ -5, /* -1 1 */ -7, /* 0 -1 */ 0, /* 0 -1 */ 7, /* 0 1 */ 5, /* 1 -1 */ 1, /* 1 0 */ 3 /* 1 1 */ ]; $jsf = self::getJSFPoints($scalars[$a], $scalars[$b]); $max = max(count($jsf[0]), $max); if ($max > 0) { $naf[$a] = array_fill(0, $max, 0); $naf[$b] = array_fill(0, $max, 0); } else { $naf[$a] = []; $naf[$b] = []; } for ($j = 0; $j < $max; $j++) { $ja = isset($jsf[0][$j]) ? $jsf[0][$j] : 0; $jb = isset($jsf[1][$j]) ? $jsf[1][$j] : 0; $naf[$a][$j] = $index[3 * ($ja + 1) + $jb + 1]; $naf[$b][$j] = 0; $wnd[$a] = $comb; } } $acc = []; $temp = [0, 0, 0, 0]; for ($i = $max; $i >= 0; $i--) { $k = 0; while ($i >= 0) { $zero = true; for ($j = 0; $j < $length; $j++) { $temp[$j] = isset($naf[$j][$i]) ? $naf[$j][$i] : 0; if ($temp[$j] != 0) { $zero = false; } } if (!$zero) { break; } $k++; $i--; } if ($i >= 0) { $k++; } while ($k--) { $acc = $this->doublePoint($acc); } if ($i < 0) { break; } for ($j = 0; $j < $length; $j++) { $z = $temp[$j]; $p = null; if ($z == 0) { continue; } $p = $z > 0 ? $wnd[$j][($z - 1) >> 1] : $this->negatePoint($wnd[$j][(-$z - 1) >> 1]); $acc = $this->addPoint($acc, $p); } } return $this->convertToAffine($acc); } /** * Precomputes NAF points * * Adapted from: * https://github.com/indutny/elliptic/blob/725bd91/lib/elliptic/curve/base.js#L351 * * @return int[] */ private function getNAFPoints(array $point, $wnd) { if (isset($point['naf'])) { return $point['naf']; } $res = [$point]; $max = (1 << $wnd) - 1; $dbl = $max == 1 ? null : $this->doublePoint($point); for ($i = 1; $i < $max; $i++) { $res[] = $this->addPoint($res[$i - 1], $dbl); } $point['naf'] = $res; /* $str = ''; foreach ($res as $re) { $re[0] = bin2hex($re[0]->toBytes()); $re[1] = bin2hex($re[1]->toBytes()); $str.= " ['$re[0]', '$re[1]'],\r\n"; } file_put_contents('temp.txt', $str); exit; */ return $res; } /** * Precomputes points in Joint Sparse Form * * Adapted from: * https://github.com/indutny/elliptic/blob/725bd91/lib/elliptic/utils.js#L96 * * @return int[] */ private static function getJSFPoints(Integer $k1, Integer $k2) { static $three; if (!isset($three)) { $three = new BigInteger(3); } $jsf = [[], []]; $k1 = $k1->toBigInteger(); $k2 = $k2->toBigInteger(); $d1 = 0; $d2 = 0; while ($k1->compare(new BigInteger(-$d1)) > 0 || $k2->compare(new BigInteger(-$d2)) > 0) { // first phase $m14 = $k1->testBit(0) + 2 * $k1->testBit(1); $m14 += $d1; $m14 &= 3; $m24 = $k2->testBit(0) + 2 * $k2->testBit(1); $m24 += $d2; $m24 &= 3; if ($m14 == 3) { $m14 = -1; } if ($m24 == 3) { $m24 = -1; } $u1 = 0; if ($m14 & 1) { // if $m14 is odd $m8 = $k1->testBit(0) + 2 * $k1->testBit(1) + 4 * $k1->testBit(2); $m8 += $d1; $m8 &= 7; $u1 = ($m8 == 3 || $m8 == 5) && $m24 == 2 ? -$m14 : $m14; } $jsf[0][] = $u1; $u2 = 0; if ($m24 & 1) { // if $m24 is odd $m8 = $k2->testBit(0) + 2 * $k2->testBit(1) + 4 * $k2->testBit(2); $m8 += $d2; $m8 &= 7; $u2 = ($m8 == 3 || $m8 == 5) && $m14 == 2 ? -$m24 : $m24; } $jsf[1][] = $u2; // second phase if (2 * $d1 == $u1 + 1) { $d1 = 1 - $d1; } if (2 * $d2 == $u2 + 1) { $d2 = 1 - $d2; } $k1 = $k1->bitwise_rightShift(1); $k2 = $k2->bitwise_rightShift(1); } return $jsf; } /** * Returns the affine point * * A Jacobian Coordinate is of the form (x, y, z). * To convert a Jacobian Coordinate to an Affine Point * you do (x / z^2, y / z^3) * * @return \phpseclib3\Math\PrimeField\Integer[] */ public function convertToAffine(array $p) { if (!isset($p[2])) { return $p; } list($x, $y, $z) = $p; $z = $this->one->divide($z); $z2 = $z->multiply($z); return [ $x->multiply($z2), $y->multiply($z2)->multiply($z) ]; } /** * Converts an affine point to a jacobian coordinate * * @return \phpseclib3\Math\PrimeField\Integer[] */ public function convertToInternal(array $p) { if (isset($p[2])) { return $p; } $p[2] = clone $this->one; $p['fresh'] = true; return $p; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Crypt\EC\BaseCurves; use phpseclib3\Math\BigInteger; use phpseclib3\Math\PrimeField; /** * Curves over y^2 = x^3 + b * * @author Jim Wigginton */ class KoblitzPrime extends Prime { /** * Basis * * @var list */ protected $basis; /** * Beta * * @var PrimeField\Integer */ protected $beta; // don't overwrite setCoefficients() with one that only accepts one parameter so that // one might be able to switch between KoblitzPrime and Prime more easily (for benchmarking // purposes). /** * Multiply and Add Points * * Uses a efficiently computable endomorphism to achieve a slight speedup * * Adapted from: * https://github.com/indutny/elliptic/blob/725bd91/lib/elliptic/curve/short.js#L219 * * @return int[] */ public function multiplyAddPoints(array $points, array $scalars) { static $zero, $one, $two; if (!isset($two)) { $two = new BigInteger(2); $one = new BigInteger(1); } if (!isset($this->beta)) { // get roots $inv = $this->one->divide($this->two)->negate(); $s = $this->three->negate()->squareRoot()->multiply($inv); $betas = [ $inv->add($s), $inv->subtract($s) ]; $this->beta = $betas[0]->compare($betas[1]) < 0 ? $betas[0] : $betas[1]; //echo strtoupper($this->beta->toHex(true)) . "\n"; exit; } if (!isset($this->basis)) { $factory = new PrimeField($this->order); $tempOne = $factory->newInteger($one); $tempTwo = $factory->newInteger($two); $tempThree = $factory->newInteger(new BigInteger(3)); $inv = $tempOne->divide($tempTwo)->negate(); $s = $tempThree->negate()->squareRoot()->multiply($inv); $lambdas = [ $inv->add($s), $inv->subtract($s) ]; $lhs = $this->multiplyPoint($this->p, $lambdas[0])[0]; $rhs = $this->p[0]->multiply($this->beta); $lambda = $lhs->equals($rhs) ? $lambdas[0] : $lambdas[1]; $this->basis = static::extendedGCD($lambda->toBigInteger(), $this->order); ///* foreach ($this->basis as $basis) { echo strtoupper($basis['a']->toHex(true)) . "\n"; echo strtoupper($basis['b']->toHex(true)) . "\n\n"; } exit; //*/ } $npoints = $nscalars = []; for ($i = 0; $i < count($points); $i++) { $p = $points[$i]; $k = $scalars[$i]->toBigInteger(); // begin split list($v1, $v2) = $this->basis; $c1 = $v2['b']->multiply($k); list($c1, $r) = $c1->divide($this->order); if ($this->order->compare($r->multiply($two)) <= 0) { $c1 = $c1->add($one); } $c2 = $v1['b']->negate()->multiply($k); list($c2, $r) = $c2->divide($this->order); if ($this->order->compare($r->multiply($two)) <= 0) { $c2 = $c2->add($one); } $p1 = $c1->multiply($v1['a']); $p2 = $c2->multiply($v2['a']); $q1 = $c1->multiply($v1['b']); $q2 = $c2->multiply($v2['b']); $k1 = $k->subtract($p1)->subtract($p2); $k2 = $q1->add($q2)->negate(); // end split $beta = [ $p[0]->multiply($this->beta), $p[1], clone $this->one ]; if (isset($p['naf'])) { $beta['naf'] = array_map(function ($p) { return [ $p[0]->multiply($this->beta), $p[1], clone $this->one ]; }, $p['naf']); $beta['nafwidth'] = $p['nafwidth']; } if ($k1->isNegative()) { $k1 = $k1->negate(); $p = $this->negatePoint($p); } if ($k2->isNegative()) { $k2 = $k2->negate(); $beta = $this->negatePoint($beta); } $pos = 2 * $i; $npoints[$pos] = $p; $nscalars[$pos] = $this->factory->newInteger($k1); $pos++; $npoints[$pos] = $beta; $nscalars[$pos] = $this->factory->newInteger($k2); } return parent::multiplyAddPoints($npoints, $nscalars); } /** * Returns the numerator and denominator of the slope * * @return FiniteField[] */ protected function doublePointHelper(array $p) { $numerator = $this->three->multiply($p[0])->multiply($p[0]); $denominator = $this->two->multiply($p[1]); return [$numerator, $denominator]; } /** * Doubles a jacobian coordinate on the curve * * See http://hyperelliptic.org/EFD/g1p/auto-shortw-jacobian-0.html#doubling-dbl-2009-l * * @return FiniteField[] */ protected function jacobianDoublePoint(array $p) { list($x1, $y1, $z1) = $p; $a = $x1->multiply($x1); $b = $y1->multiply($y1); $c = $b->multiply($b); $d = $x1->add($b); $d = $d->multiply($d)->subtract($a)->subtract($c)->multiply($this->two); $e = $this->three->multiply($a); $f = $e->multiply($e); $x3 = $f->subtract($this->two->multiply($d)); $y3 = $e->multiply($d->subtract($x3))->subtract( $this->eight->multiply($c) ); $z3 = $this->two->multiply($y1)->multiply($z1); return [$x3, $y3, $z3]; } /** * Doubles a "fresh" jacobian coordinate on the curve * * See http://hyperelliptic.org/EFD/g1p/auto-shortw-jacobian-0.html#doubling-mdbl-2007-bl * * @return FiniteField[] */ protected function jacobianDoublePointMixed(array $p) { list($x1, $y1) = $p; $xx = $x1->multiply($x1); $yy = $y1->multiply($y1); $yyyy = $yy->multiply($yy); $s = $x1->add($yy); $s = $s->multiply($s)->subtract($xx)->subtract($yyyy)->multiply($this->two); $m = $this->three->multiply($xx); $t = $m->multiply($m)->subtract($this->two->multiply($s)); $x3 = $t; $y3 = $s->subtract($t); $y3 = $m->multiply($y3)->subtract($this->eight->multiply($yyyy)); $z3 = $this->two->multiply($y1); return [$x3, $y3, $z3]; } /** * Tests whether or not the x / y values satisfy the equation * * @return boolean */ public function verifyPoint(array $p) { list($x, $y) = $p; $lhs = $y->multiply($y); $temp = $x->multiply($x)->multiply($x); $rhs = $temp->add($this->b); return $lhs->equals($rhs); } /** * Calculates the parameters needed from the Euclidean algorithm as discussed at * http://diamond.boisestate.edu/~liljanab/MATH308/GuideToECC.pdf#page=148 * * @param BigInteger $u * @param BigInteger $v * @return BigInteger[] */ protected static function extendedGCD(BigInteger $u, BigInteger $v) { $one = new BigInteger(1); $zero = new BigInteger(); $a = clone $one; $b = clone $zero; $c = clone $zero; $d = clone $one; $stop = $v->bitwise_rightShift($v->getLength() >> 1); $a1 = clone $zero; $b1 = clone $zero; $a2 = clone $zero; $b2 = clone $zero; $postGreatestIndex = 0; while (!$v->equals($zero)) { list($q) = $u->divide($v); $temp = $u; $u = $v; $v = $temp->subtract($v->multiply($q)); $temp = $a; $a = $c; $c = $temp->subtract($a->multiply($q)); $temp = $b; $b = $d; $d = $temp->subtract($b->multiply($q)); if ($v->compare($stop) > 0) { $a0 = $v; $b0 = $c; } else { $postGreatestIndex++; } if ($postGreatestIndex == 1) { $a1 = $v; $b1 = $c->negate(); } if ($postGreatestIndex == 2) { $rhs = $a0->multiply($a0)->add($b0->multiply($b0)); $lhs = $v->multiply($v)->add($b->multiply($b)); if ($lhs->compare($rhs) <= 0) { $a2 = $a0; $b2 = $b0->negate(); } else { $a2 = $v; $b2 = $c->negate(); } break; } } return [ ['a' => $a1, 'b' => $b1], ['a' => $a2, 'b' => $b2] ]; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC; use phpseclib3\Crypt\EC; /** * EC Parameters * * @author Jim Wigginton */ class Parameters extends EC { /** * Returns the parameters * * @param string $type * @param array $options optional * @return string */ public function toString($type = 'PKCS1', array $options = []) { $type = self::validatePlugin('Keys', 'PKCS1', 'saveParameters'); return $type::saveParameters($this->curve, $options); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common; use phpseclib3\Crypt\EC; use phpseclib3\Crypt\EC\BaseCurves\Montgomery as MontgomeryCurve; use phpseclib3\Crypt\EC\BaseCurves\TwistedEdwards as TwistedEdwardsCurve; use phpseclib3\Crypt\EC\Curves\Curve25519; use phpseclib3\Crypt\EC\Curves\Ed25519; use phpseclib3\Crypt\EC\Formats\Keys\PKCS1; use phpseclib3\Crypt\EC\Formats\Signature\ASN1 as ASN1Signature; use phpseclib3\Crypt\Hash; use phpseclib3\Exception\UnsupportedOperationException; use phpseclib3\Math\BigInteger; /** * EC Private Key * * @author Jim Wigginton */ class PrivateKey extends EC implements Common\PrivateKey { use Common\Traits\PasswordProtected; /** * Private Key dA * * sign() converts this to a BigInteger so one might wonder why this is a FiniteFieldInteger instead of * a BigInteger. That's because a FiniteFieldInteger, when converted to a byte string, is null padded by * a certain amount whereas a BigInteger isn't. * * @var object */ protected $dA; /** * @var string */ protected $secret; /** * Multiplies an encoded point by the private key * * Used by ECDH * * @param string $coordinates * @return string */ public function multiply($coordinates) { if ($this->curve instanceof MontgomeryCurve) { if ($this->curve instanceof Curve25519 && self::$engines['libsodium']) { return sodium_crypto_scalarmult($this->dA->toBytes(), $coordinates); } $point = [$this->curve->convertInteger(new BigInteger(strrev($coordinates), 256))]; $point = $this->curve->multiplyPoint($point, $this->dA); return strrev($point[0]->toBytes(true)); } if (!$this->curve instanceof TwistedEdwardsCurve) { $coordinates = "\0$coordinates"; } $point = PKCS1::extractPoint($coordinates, $this->curve); $point = $this->curve->multiplyPoint($point, $this->dA); if ($this->curve instanceof TwistedEdwardsCurve) { return $this->curve->encodePoint($point); } if (empty($point)) { throw new \RuntimeException('The infinity point is invalid'); } return "\4" . $point[0]->toBytes(true) . $point[1]->toBytes(true); } /** * Create a signature * * @see self::verify() * @param string $message * @return mixed */ public function sign($message) { if ($this->curve instanceof MontgomeryCurve) { throw new UnsupportedOperationException('Montgomery Curves cannot be used to create signatures'); } $dA = $this->dA; $order = $this->curve->getOrder(); $shortFormat = $this->shortFormat; $format = $this->sigFormat; if ($format === false) { return false; } if ($this->curve instanceof TwistedEdwardsCurve) { if ($this->curve instanceof Ed25519 && self::$engines['libsodium'] && !isset($this->context)) { $result = sodium_crypto_sign_detached($message, $this->withPassword()->toString('libsodium')); return $shortFormat == 'SSH2' ? Strings::packSSH2('ss', 'ssh-' . strtolower($this->getCurve()), $result) : $result; } // contexts (Ed25519ctx) are supported but prehashing (Ed25519ph) is not. // quoting https://tools.ietf.org/html/rfc8032#section-8.5 , // "The Ed25519ph and Ed448ph variants ... SHOULD NOT be used" $A = $this->curve->encodePoint($this->QA); $curve = $this->curve; $hash = new Hash($curve::HASH); $secret = substr($hash->hash($this->secret), $curve::SIZE); if ($curve instanceof Ed25519) { $dom = !isset($this->context) ? '' : 'SigEd25519 no Ed25519 collisions' . "\0" . chr(strlen($this->context)) . $this->context; } else { $context = isset($this->context) ? $this->context : ''; $dom = 'SigEd448' . "\0" . chr(strlen($context)) . $context; } // SHA-512(dom2(F, C) || prefix || PH(M)) $r = $hash->hash($dom . $secret . $message); $r = strrev($r); $r = new BigInteger($r, 256); list(, $r) = $r->divide($order); $R = $curve->multiplyPoint($curve->getBasePoint(), $r); $R = $curve->encodePoint($R); $k = $hash->hash($dom . $R . $A . $message); $k = strrev($k); $k = new BigInteger($k, 256); list(, $k) = $k->divide($order); $S = $k->multiply($dA)->add($r); list(, $S) = $S->divide($order); $S = str_pad(strrev($S->toBytes()), $curve::SIZE, "\0"); return $shortFormat == 'SSH2' ? Strings::packSSH2('ss', 'ssh-' . strtolower($this->getCurve()), $R . $S) : $R . $S; } if (self::$engines['OpenSSL'] && in_array($this->hash->getHash(), openssl_get_md_methods())) { $signature = ''; // altho PHP's OpenSSL bindings only supported EC key creation in PHP 7.1 they've long // supported signing / verification // we use specified curves to avoid issues with OpenSSL possibly not supporting a given named curve; // doing this may mean some curve-specific optimizations can't be used but idk if OpenSSL even // has curve-specific optimizations $result = openssl_sign($message, $signature, $this->toString('PKCS8', ['namedCurve' => false]), $this->hash->getHash()); if ($result) { if ($shortFormat == 'ASN1') { return $signature; } extract(ASN1Signature::load($signature)); return $shortFormat == 'SSH2' ? $format::save($r, $s, $this->getCurve()) : $format::save($r, $s); } } $e = $this->hash->hash($message); $e = new BigInteger($e, 256); $Ln = $this->hash->getLength() - $order->getLength(); $z = $Ln > 0 ? $e->bitwise_rightShift($Ln) : $e; while (true) { $k = BigInteger::randomRange(self::$one, $order->subtract(self::$one)); list($x, $y) = $this->curve->multiplyPoint($this->curve->getBasePoint(), $k); $x = $x->toBigInteger(); list(, $r) = $x->divide($order); if ($r->equals(self::$zero)) { continue; } $kinv = $k->modInverse($order); $temp = $z->add($dA->multiply($r)); $temp = $kinv->multiply($temp); list(, $s) = $temp->divide($order); if (!$s->equals(self::$zero)) { break; } } // the following is an RFC6979 compliant implementation of deterministic ECDSA // it's unused because it's mainly intended for use when a good CSPRNG isn't // available. if phpseclib's CSPRNG isn't good then even key generation is // suspect /* // if this were actually being used it'd probably be better if this lived in load() and createKey() $this->q = $this->curve->getOrder(); $dA = $this->dA->toBigInteger(); $this->x = $dA; $h1 = $this->hash->hash($message); $k = $this->computek($h1); list($x, $y) = $this->curve->multiplyPoint($this->curve->getBasePoint(), $k); $x = $x->toBigInteger(); list(, $r) = $x->divide($this->q); $kinv = $k->modInverse($this->q); $h1 = $this->bits2int($h1); $temp = $h1->add($dA->multiply($r)); $temp = $kinv->multiply($temp); list(, $s) = $temp->divide($this->q); */ return $shortFormat == 'SSH2' ? $format::save($r, $s, $this->getCurve()) : $format::save($r, $s); } /** * Returns the private key * * @param string $type * @param array $options optional * @return string */ public function toString($type, array $options = []) { $type = self::validatePlugin('Keys', $type, 'savePrivateKey'); return $type::savePrivateKey($this->dA, $this->curve, $this->QA, $this->secret, $this->password, $options); } /** * Returns the public key * * @see self::getPrivateKey() * @return mixed */ public function getPublicKey() { $format = 'PKCS8'; if ($this->curve instanceof MontgomeryCurve) { $format = 'MontgomeryPublic'; } $type = self::validatePlugin('Keys', $format, 'savePublicKey'); $key = $type::savePublicKey($this->curve, $this->QA); $key = EC::loadFormat($format, $key); if ($this->curve instanceof MontgomeryCurve) { return $key; } $key = $key ->withHash($this->hash->getHash()) ->withSignatureFormat($this->shortFormat); if ($this->curve instanceof TwistedEdwardsCurve) { $key = $key->withContext($this->context); } return $key; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\PKCS1 as Progenitor; use phpseclib3\Crypt\EC\BaseCurves\Base as BaseCurve; use phpseclib3\Crypt\EC\BaseCurves\Montgomery as MontgomeryCurve; use phpseclib3\Crypt\EC\BaseCurves\TwistedEdwards as TwistedEdwardsCurve; use phpseclib3\Exception\UnsupportedCurveException; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps; use phpseclib3\Math\BigInteger; /** * "PKCS1" (RFC5915) Formatted EC Key Handler * * @author Jim Wigginton */ abstract class PKCS1 extends Progenitor { use Common; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { self::initialize_static_variables(); if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } if (strpos($key, 'BEGIN EC PARAMETERS') && strpos($key, 'BEGIN EC PRIVATE KEY')) { $components = []; preg_match('#-*BEGIN EC PRIVATE KEY-*[^-]*-*END EC PRIVATE KEY-*#s', $key, $matches); $decoded = parent::load($matches[0], $password); $decoded = ASN1::decodeBER($decoded); if (!$decoded) { throw new \RuntimeException('Unable to decode BER'); } $ecPrivate = ASN1::asn1map($decoded[0], Maps\ECPrivateKey::MAP); if (!is_array($ecPrivate)) { throw new \RuntimeException('Unable to perform ASN1 mapping'); } if (isset($ecPrivate['parameters'])) { $components['curve'] = self::loadCurveByParam($ecPrivate['parameters']); } preg_match('#-*BEGIN EC PARAMETERS-*[^-]*-*END EC PARAMETERS-*#s', $key, $matches); $decoded = parent::load($matches[0], ''); $decoded = ASN1::decodeBER($decoded); if (!$decoded) { throw new \RuntimeException('Unable to decode BER'); } $ecParams = ASN1::asn1map($decoded[0], Maps\ECParameters::MAP); if (!is_array($ecParams)) { throw new \RuntimeException('Unable to perform ASN1 mapping'); } $ecParams = self::loadCurveByParam($ecParams); // comparing $ecParams and $components['curve'] directly won't work because they'll have different Math\Common\FiniteField classes // even if the modulo is the same if (isset($components['curve']) && self::encodeParameters($ecParams, false, []) != self::encodeParameters($components['curve'], false, [])) { throw new \RuntimeException('EC PARAMETERS does not correspond to EC PRIVATE KEY'); } if (!isset($components['curve'])) { $components['curve'] = $ecParams; } $components['dA'] = new BigInteger($ecPrivate['privateKey'], 256); $components['curve']->rangeCheck($components['dA']); $components['QA'] = isset($ecPrivate['publicKey']) ? self::extractPoint($ecPrivate['publicKey'], $components['curve']) : $components['curve']->multiplyPoint($components['curve']->getBasePoint(), $components['dA']); return $components; } $key = parent::load($key, $password); $decoded = ASN1::decodeBER($key); if (!$decoded) { throw new \RuntimeException('Unable to decode BER'); } $key = ASN1::asn1map($decoded[0], Maps\ECParameters::MAP); if (is_array($key)) { return ['curve' => self::loadCurveByParam($key)]; } $key = ASN1::asn1map($decoded[0], Maps\ECPrivateKey::MAP); if (!is_array($key)) { throw new \RuntimeException('Unable to perform ASN1 mapping'); } if (!isset($key['parameters'])) { throw new \RuntimeException('Key cannot be loaded without parameters'); } $components = []; $components['curve'] = self::loadCurveByParam($key['parameters']); $components['dA'] = new BigInteger($key['privateKey'], 256); $components['QA'] = isset($ecPrivate['publicKey']) ? self::extractPoint($ecPrivate['publicKey'], $components['curve']) : $components['curve']->multiplyPoint($components['curve']->getBasePoint(), $components['dA']); return $components; } /** * Convert EC parameters to the appropriate format * * @return string */ public static function saveParameters(BaseCurve $curve, array $options = []) { self::initialize_static_variables(); if ($curve instanceof TwistedEdwardsCurve || $curve instanceof MontgomeryCurve) { throw new UnsupportedCurveException('TwistedEdwards and Montgomery Curves are not supported'); } $key = self::encodeParameters($curve, false, $options); return "-----BEGIN EC PARAMETERS-----\r\n" . chunk_split(Strings::base64_encode($key), 64) . "-----END EC PARAMETERS-----\r\n"; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $privateKey * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @param string $secret optional * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $privateKey, BaseCurve $curve, array $publicKey, $secret = null, $password = '', array $options = []) { self::initialize_static_variables(); if ($curve instanceof TwistedEdwardsCurve || $curve instanceof MontgomeryCurve) { throw new UnsupportedCurveException('TwistedEdwards Curves are not supported'); } $publicKey = "\4" . $publicKey[0]->toBytes() . $publicKey[1]->toBytes(); $key = [ 'version' => 'ecPrivkeyVer1', 'privateKey' => $privateKey->toBytes(), 'parameters' => new ASN1\Element(self::encodeParameters($curve)), 'publicKey' => "\0" . $publicKey ]; $key = ASN1::encodeDER($key, Maps\ECPrivateKey::MAP); return self::wrapPrivateKey($key, 'EC', $password, $options); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Keys; use phpseclib3\Crypt\EC\BaseCurves\Montgomery as MontgomeryCurve; use phpseclib3\Crypt\EC\Curves\Curve25519; use phpseclib3\Crypt\EC\Curves\Curve448; use phpseclib3\Exception\UnsupportedFormatException; use phpseclib3\Math\BigInteger; /** * Montgomery Curve Private Key Handler * * @author Jim Wigginton */ abstract class MontgomeryPrivate { /** * Is invisible flag * */ const IS_INVISIBLE = true; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { switch (strlen($key)) { case 32: $curve = new Curve25519(); break; case 56: $curve = new Curve448(); break; default: throw new \LengthException('The only supported lengths are 32 and 56'); } $components = ['curve' => $curve]; $components['dA'] = new BigInteger($key, 256); $curve->rangeCheck($components['dA']); // note that EC::getEncodedCoordinates does some additional "magic" (it does strrev on the result) $components['QA'] = $components['curve']->multiplyPoint($components['curve']->getBasePoint(), $components['dA']); return $components; } /** * Convert an EC public key to the appropriate format * * @param \phpseclib3\Crypt\EC\BaseCurves\Montgomery $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @return string */ public static function savePublicKey(MontgomeryCurve $curve, array $publicKey) { return strrev($publicKey[0]->toBytes()); } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $privateKey * @param \phpseclib3\Crypt\EC\BaseCurves\Montgomery $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @param string $secret optional * @param string $password optional * @return string */ public static function savePrivateKey(BigInteger $privateKey, MontgomeryCurve $curve, array $publicKey, $secret = null, $password = '') { if (!empty($password) && is_string($password)) { throw new UnsupportedFormatException('MontgomeryPrivate private keys do not support encryption'); } return $privateKey->toBytes(); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Keys; use phpseclib3\Crypt\EC\Curves\Ed25519; use phpseclib3\Exception\UnsupportedFormatException; use phpseclib3\Math\BigInteger; /** * libsodium Key Handler * * @author Jim Wigginton */ abstract class libsodium { use Common; /** * Is invisible flag * */ const IS_INVISIBLE = true; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { switch (strlen($key)) { case 32: $public = $key; break; case 64: $private = substr($key, 0, 32); $public = substr($key, -32); break; case 96: $public = substr($key, -32); if (substr($key, 32, 32) != $public) { throw new \RuntimeException('Keys with 96 bytes should have the 2nd and 3rd set of 32 bytes match'); } $private = substr($key, 0, 32); break; default: throw new \RuntimeException('libsodium keys need to either be 32 bytes long, 64 bytes long or 96 bytes long'); } $curve = new Ed25519(); $components = ['curve' => $curve]; if (isset($private)) { $arr = $curve->extractSecret($private); $components['dA'] = $arr['dA']; $components['secret'] = $arr['secret']; } $components['QA'] = isset($public) ? self::extractPoint($public, $curve) : $curve->multiplyPoint($curve->getBasePoint(), $components['dA']); return $components; } /** * Convert an EC public key to the appropriate format * * @param \phpseclib3\Crypt\EC\Curves\Ed25519 $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @return string */ public static function savePublicKey(Ed25519 $curve, array $publicKey) { return $curve->encodePoint($publicKey); } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $privateKey * @param \phpseclib3\Crypt\EC\Curves\Ed25519 $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @param string $secret optional * @param string $password optional * @return string */ public static function savePrivateKey(BigInteger $privateKey, Ed25519 $curve, array $publicKey, $secret = null, $password = '') { if (!isset($secret)) { throw new \RuntimeException('Private Key does not have a secret set'); } if (strlen($secret) != 32) { throw new \RuntimeException('Private Key secret is not of the correct length'); } if (!empty($password) && is_string($password)) { throw new UnsupportedFormatException('libsodium private keys do not support encryption'); } return $secret . $curve->encodePoint($publicKey); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\PKCS8 as Progenitor; use phpseclib3\Crypt\EC\BaseCurves\Base as BaseCurve; use phpseclib3\Crypt\EC\BaseCurves\Montgomery as MontgomeryCurve; use phpseclib3\Crypt\EC\BaseCurves\TwistedEdwards as TwistedEdwardsCurve; use phpseclib3\Crypt\EC\Curves\Ed25519; use phpseclib3\Crypt\EC\Curves\Ed448; use phpseclib3\Exception\UnsupportedCurveException; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps; use phpseclib3\Math\BigInteger; /** * PKCS#8 Formatted EC Key Handler * * @author Jim Wigginton */ abstract class PKCS8 extends Progenitor { use Common; /** * OID Name * * @var array */ const OID_NAME = ['id-ecPublicKey', 'id-Ed25519', 'id-Ed448']; /** * OID Value * * @var string */ const OID_VALUE = ['1.2.840.10045.2.1', '1.3.101.112', '1.3.101.113']; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { // initialize_static_variables() is defined in both the trait and the parent class // when it's defined in two places it's the traits one that's called // the parent one is needed, as well, but the parent one is called by other methods // in the parent class as needed and in the context of the parent it's the parent // one that's called self::initialize_static_variables(); if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } $isPublic = strpos($key, 'PUBLIC') !== false; $key = parent::load($key, $password); $type = isset($key['privateKey']) ? 'privateKey' : 'publicKey'; switch (true) { case !$isPublic && $type == 'publicKey': throw new \UnexpectedValueException('Human readable string claims non-public key but DER encoded string claims public key'); case $isPublic && $type == 'privateKey': throw new \UnexpectedValueException('Human readable string claims public key but DER encoded string claims private key'); } switch ($key[$type . 'Algorithm']['algorithm']) { case 'id-Ed25519': case 'id-Ed448': return self::loadEdDSA($key); } $decoded = ASN1::decodeBER($key[$type . 'Algorithm']['parameters']->element); if (!$decoded) { throw new \RuntimeException('Unable to decode BER'); } $params = ASN1::asn1map($decoded[0], Maps\ECParameters::MAP); if (!$params) { throw new \RuntimeException('Unable to decode the parameters using Maps\ECParameters'); } $components = []; $components['curve'] = self::loadCurveByParam($params); if ($isPublic) { $components['QA'] = self::extractPoint("\0" . $key['publicKey'], $components['curve']); return $components; } $decoded = ASN1::decodeBER($key['privateKey']); if (!$decoded) { throw new \RuntimeException('Unable to decode BER'); } $key = ASN1::asn1map($decoded[0], Maps\ECPrivateKey::MAP); if (isset($key['parameters']) && $params != $key['parameters']) { throw new \RuntimeException('The PKCS8 parameter field does not match the private key parameter field'); } $components['dA'] = new BigInteger($key['privateKey'], 256); $components['curve']->rangeCheck($components['dA']); $components['QA'] = isset($key['publicKey']) ? self::extractPoint($key['publicKey'], $components['curve']) : $components['curve']->multiplyPoint($components['curve']->getBasePoint(), $components['dA']); return $components; } /** * Break a public or private EdDSA key down into its constituent components * * @return array */ private static function loadEdDSA(array $key) { $components = []; if (isset($key['privateKey'])) { $components['curve'] = $key['privateKeyAlgorithm']['algorithm'] == 'id-Ed25519' ? new Ed25519() : new Ed448(); // 0x04 == octet string // 0x20 == length (32 bytes) if (substr($key['privateKey'], 0, 2) != "\x04\x20") { throw new \RuntimeException('The first two bytes of the private key field should be 0x0420'); } $arr = $components['curve']->extractSecret(substr($key['privateKey'], 2)); $components['dA'] = $arr['dA']; $components['secret'] = $arr['secret']; } if (isset($key['publicKey'])) { if (!isset($components['curve'])) { $components['curve'] = $key['publicKeyAlgorithm']['algorithm'] == 'id-Ed25519' ? new Ed25519() : new Ed448(); } $components['QA'] = self::extractPoint($key['publicKey'], $components['curve']); } if (isset($key['privateKey']) && !isset($components['QA'])) { $components['QA'] = $components['curve']->multiplyPoint($components['curve']->getBasePoint(), $components['dA']); } return $components; } /** * Convert an EC public key to the appropriate format * * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @param array $options optional * @return string */ public static function savePublicKey(BaseCurve $curve, array $publicKey, array $options = []) { self::initialize_static_variables(); if ($curve instanceof MontgomeryCurve) { throw new UnsupportedCurveException('Montgomery Curves are not supported'); } if ($curve instanceof TwistedEdwardsCurve) { return self::wrapPublicKey( $curve->encodePoint($publicKey), null, $curve instanceof Ed25519 ? 'id-Ed25519' : 'id-Ed448' ); } $params = new ASN1\Element(self::encodeParameters($curve, false, $options)); $key = "\4" . $publicKey[0]->toBytes() . $publicKey[1]->toBytes(); return self::wrapPublicKey($key, $params, 'id-ecPublicKey'); } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $privateKey * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @param string $secret optional * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $privateKey, BaseCurve $curve, array $publicKey, $secret = null, $password = '', array $options = []) { self::initialize_static_variables(); if ($curve instanceof MontgomeryCurve) { throw new UnsupportedCurveException('Montgomery Curves are not supported'); } if ($curve instanceof TwistedEdwardsCurve) { return self::wrapPrivateKey( "\x04\x20" . $secret, [], null, $password, $curve instanceof Ed25519 ? 'id-Ed25519' : 'id-Ed448' ); } $publicKey = "\4" . $publicKey[0]->toBytes() . $publicKey[1]->toBytes(); $params = new ASN1\Element(self::encodeParameters($curve, false, $options)); $key = [ 'version' => 'ecPrivkeyVer1', 'privateKey' => $privateKey->toBytes(), //'parameters' => $params, 'publicKey' => "\0" . $publicKey ]; $key = ASN1::encodeDER($key, Maps\ECPrivateKey::MAP); return self::wrapPrivateKey($key, [], $params, $password, 'id-ecPublicKey', '', $options); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\EC\BaseCurves\Base as BaseCurve; use phpseclib3\Crypt\EC\BaseCurves\Montgomery as MontgomeryCurve; use phpseclib3\Crypt\EC\BaseCurves\Prime as PrimeCurve; use phpseclib3\Crypt\EC\BaseCurves\TwistedEdwards as TwistedEdwardsCurve; use phpseclib3\Exception\BadConfigurationException; use phpseclib3\Exception\UnsupportedCurveException; use phpseclib3\Math\BigInteger; /** * XML Formatted EC Key Handler * * @author Jim Wigginton */ abstract class XML { use Common; /** * Default namespace * * @var string */ private static $namespace; /** * Flag for using RFC4050 syntax * * @var bool */ private static $rfc4050 = false; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { self::initialize_static_variables(); if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } if (!class_exists('DOMDocument')) { throw new BadConfigurationException('The dom extension is not setup correctly on this system'); } $use_errors = libxml_use_internal_errors(true); $temp = self::isolateNamespace($key, 'http://www.w3.org/2009/xmldsig11#'); if ($temp) { $key = $temp; } $temp = self::isolateNamespace($key, 'http://www.w3.org/2001/04/xmldsig-more#'); if ($temp) { $key = $temp; } $dom = new \DOMDocument(); if (substr($key, 0, 5) != '' . $key . ''; } if (!$dom->loadXML($key)) { libxml_use_internal_errors($use_errors); throw new \UnexpectedValueException('Key does not appear to contain XML'); } $xpath = new \DOMXPath($dom); libxml_use_internal_errors($use_errors); $curve = self::loadCurveByParam($xpath); $pubkey = self::query($xpath, 'publickey', 'Public Key is not present'); $QA = self::query($xpath, 'ecdsakeyvalue')->length ? self::extractPointRFC4050($xpath, $curve) : self::extractPoint("\0" . $pubkey, $curve); libxml_use_internal_errors($use_errors); return compact('curve', 'QA'); } /** * Case-insensitive xpath query * * @param \DOMXPath $xpath * @param string $name * @param string $error optional * @param bool $decode optional * @return \DOMNodeList */ private static function query(\DOMXPath $xpath, $name, $error = null, $decode = true) { $query = '/'; $names = explode('/', $name); foreach ($names as $name) { $query .= "/*[translate(local-name(), 'ABCDEFGHIJKLMNOPQRSTUVWXYZ','abcdefghijklmnopqrstuvwxyz')='$name']"; } $result = $xpath->query($query); if (!isset($error)) { return $result; } if (!$result->length) { throw new \RuntimeException($error); } return $decode ? self::decodeValue($result->item(0)->textContent) : $result->item(0)->textContent; } /** * Finds the first element in the relevant namespace, strips the namespacing and returns the XML for that element. * * @param string $xml * @param string $ns */ private static function isolateNamespace($xml, $ns) { $dom = new \DOMDocument(); if (!$dom->loadXML($xml)) { return false; } $xpath = new \DOMXPath($dom); $nodes = $xpath->query("//*[namespace::*[.='$ns'] and not(../namespace::*[.='$ns'])]"); if (!$nodes->length) { return false; } $node = $nodes->item(0); $ns_name = $node->lookupPrefix($ns); if ($ns_name) { $node->removeAttributeNS($ns, $ns_name); } return $dom->saveXML($node); } /** * Decodes the value * * @param string $value */ private static function decodeValue($value) { return Strings::base64_decode(str_replace(["\r", "\n", ' ', "\t"], '', $value)); } /** * Extract points from an XML document * * @param \DOMXPath $xpath * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @return object[] */ private static function extractPointRFC4050(\DOMXPath $xpath, BaseCurve $curve) { $x = self::query($xpath, 'publickey/x'); $y = self::query($xpath, 'publickey/y'); if (!$x->length || !$x->item(0)->hasAttribute('Value')) { throw new \RuntimeException('Public Key / X coordinate not found'); } if (!$y->length || !$y->item(0)->hasAttribute('Value')) { throw new \RuntimeException('Public Key / Y coordinate not found'); } $point = [ $curve->convertInteger(new BigInteger($x->item(0)->getAttribute('Value'))), $curve->convertInteger(new BigInteger($y->item(0)->getAttribute('Value'))) ]; if (!$curve->verifyPoint($point)) { throw new \RuntimeException('Unable to verify that point exists on curve'); } return $point; } /** * Returns an instance of \phpseclib3\Crypt\EC\BaseCurves\Base based * on the curve parameters * * @param \DomXPath $xpath * @return \phpseclib3\Crypt\EC\BaseCurves\Base|false */ private static function loadCurveByParam(\DOMXPath $xpath) { $namedCurve = self::query($xpath, 'namedcurve'); if ($namedCurve->length == 1) { $oid = $namedCurve->item(0)->getAttribute('URN'); $oid = preg_replace('#[^\d.]#', '', $oid); $name = array_search($oid, self::$curveOIDs); if ($name === false) { throw new UnsupportedCurveException('Curve with OID of ' . $oid . ' is not supported'); } $curve = '\phpseclib3\Crypt\EC\Curves\\' . $name; if (!class_exists($curve)) { throw new UnsupportedCurveException('Named Curve of ' . $name . ' is not supported'); } return new $curve(); } $params = self::query($xpath, 'explicitparams'); if ($params->length) { return self::loadCurveByParamRFC4050($xpath); } $params = self::query($xpath, 'ecparameters'); if (!$params->length) { throw new \RuntimeException('No parameters are present'); } $fieldTypes = [ 'prime-field' => ['fieldid/prime/p'], 'gnb' => ['fieldid/gnb/m'], 'tnb' => ['fieldid/tnb/k'], 'pnb' => ['fieldid/pnb/k1', 'fieldid/pnb/k2', 'fieldid/pnb/k3'], 'unknown' => [] ]; foreach ($fieldTypes as $type => $queries) { foreach ($queries as $query) { $result = self::query($xpath, $query); if (!$result->length) { continue 2; } $param = preg_replace('#.*/#', '', $query); $$param = self::decodeValue($result->item(0)->textContent); } break; } $a = self::query($xpath, 'curve/a', 'A coefficient is not present'); $b = self::query($xpath, 'curve/b', 'B coefficient is not present'); $base = self::query($xpath, 'base', 'Base point is not present'); $order = self::query($xpath, 'order', 'Order is not present'); switch ($type) { case 'prime-field': $curve = new PrimeCurve(); $curve->setModulo(new BigInteger($p, 256)); $curve->setCoefficients( new BigInteger($a, 256), new BigInteger($b, 256) ); $point = self::extractPoint("\0" . $base, $curve); $curve->setBasePoint(...$point); $curve->setOrder(new BigInteger($order, 256)); return $curve; case 'gnb': case 'tnb': case 'pnb': default: throw new UnsupportedCurveException('Field Type of ' . $type . ' is not supported'); } } /** * Returns an instance of \phpseclib3\Crypt\EC\BaseCurves\Base based * on the curve parameters * * @param \DomXPath $xpath * @return \phpseclib3\Crypt\EC\BaseCurves\Base|false */ private static function loadCurveByParamRFC4050(\DOMXPath $xpath) { $fieldTypes = [ 'prime-field' => ['primefieldparamstype/p'], 'unknown' => [] ]; foreach ($fieldTypes as $type => $queries) { foreach ($queries as $query) { $result = self::query($xpath, $query); if (!$result->length) { continue 2; } $param = preg_replace('#.*/#', '', $query); $$param = $result->item(0)->textContent; } break; } $a = self::query($xpath, 'curveparamstype/a', 'A coefficient is not present', false); $b = self::query($xpath, 'curveparamstype/b', 'B coefficient is not present', false); $x = self::query($xpath, 'basepointparams/basepoint/ecpointtype/x', 'Base Point X is not present', false); $y = self::query($xpath, 'basepointparams/basepoint/ecpointtype/y', 'Base Point Y is not present', false); $order = self::query($xpath, 'order', 'Order is not present', false); switch ($type) { case 'prime-field': $curve = new PrimeCurve(); $p = str_replace(["\r", "\n", ' ', "\t"], '', $p); $curve->setModulo(new BigInteger($p)); $a = str_replace(["\r", "\n", ' ', "\t"], '', $a); $b = str_replace(["\r", "\n", ' ', "\t"], '', $b); $curve->setCoefficients( new BigInteger($a), new BigInteger($b) ); $x = str_replace(["\r", "\n", ' ', "\t"], '', $x); $y = str_replace(["\r", "\n", ' ', "\t"], '', $y); $curve->setBasePoint( new BigInteger($x), new BigInteger($y) ); $order = str_replace(["\r", "\n", ' ', "\t"], '', $order); $curve->setOrder(new BigInteger($order)); return $curve; default: throw new UnsupportedCurveException('Field Type of ' . $type . ' is not supported'); } } /** * Sets the namespace. dsig11 is the most common one. * * Set to null to unset. Used only for creating public keys. * * @param string $namespace */ public static function setNamespace($namespace) { self::$namespace = $namespace; } /** * Uses the XML syntax specified in https://tools.ietf.org/html/rfc4050 */ public static function enableRFC4050Syntax() { self::$rfc4050 = true; } /** * Uses the XML syntax specified in https://www.w3.org/TR/xmldsig-core/#sec-ECParameters */ public static function disableRFC4050Syntax() { self::$rfc4050 = false; } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @param array $options optional * @return string */ public static function savePublicKey(BaseCurve $curve, array $publicKey, array $options = []) { self::initialize_static_variables(); if ($curve instanceof TwistedEdwardsCurve || $curve instanceof MontgomeryCurve) { throw new UnsupportedCurveException('TwistedEdwards and Montgomery Curves are not supported'); } if (empty(static::$namespace)) { $pre = $post = ''; } else { $pre = static::$namespace . ':'; $post = ':' . static::$namespace; } if (self::$rfc4050) { return '<' . $pre . 'ECDSAKeyValue xmlns' . $post . '="http://www.w3.org/2001/04/xmldsig-more#">' . "\r\n" . self::encodeXMLParameters($curve, $pre, $options) . "\r\n" . '<' . $pre . 'PublicKey>' . "\r\n" . '<' . $pre . 'X Value="' . $publicKey[0] . '" />' . "\r\n" . '<' . $pre . 'Y Value="' . $publicKey[1] . '" />' . "\r\n" . '' . "\r\n" . ''; } $publicKey = "\4" . $publicKey[0]->toBytes() . $publicKey[1]->toBytes(); return '<' . $pre . 'ECDSAKeyValue xmlns' . $post . '="http://www.w3.org/2009/xmldsig11#">' . "\r\n" . self::encodeXMLParameters($curve, $pre, $options) . "\r\n" . '<' . $pre . 'PublicKey>' . Strings::base64_encode($publicKey) . '' . "\r\n" . ''; } /** * Encode Parameters * * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @param string $pre * @param array $options optional * @return string|false */ private static function encodeXMLParameters(BaseCurve $curve, $pre, array $options = []) { $result = self::encodeParameters($curve, true, $options); if (isset($result['namedCurve'])) { $namedCurve = '<' . $pre . 'NamedCurve URI="urn:oid:' . self::$curveOIDs[$result['namedCurve']] . '" />'; return self::$rfc4050 ? '' . str_replace('URI', 'URN', $namedCurve) . '' : $namedCurve; } if (self::$rfc4050) { $xml = '<' . $pre . 'ExplicitParams>' . "\r\n" . '<' . $pre . 'FieldParams>' . "\r\n"; $temp = $result['specifiedCurve']; switch ($temp['fieldID']['fieldType']) { case 'prime-field': $xml .= '<' . $pre . 'PrimeFieldParamsType>' . "\r\n" . '<' . $pre . 'P>' . $temp['fieldID']['parameters'] . '' . "\r\n" . '' . "\r\n"; $a = $curve->getA(); $b = $curve->getB(); list($x, $y) = $curve->getBasePoint(); break; default: throw new UnsupportedCurveException('Field Type of ' . $temp['fieldID']['fieldType'] . ' is not supported'); } $xml .= '' . "\r\n" . '<' . $pre . 'CurveParamsType>' . "\r\n" . '<' . $pre . 'A>' . $a . '' . "\r\n" . '<' . $pre . 'B>' . $b . '' . "\r\n" . '' . "\r\n" . '<' . $pre . 'BasePointParams>' . "\r\n" . '<' . $pre . 'BasePoint>' . "\r\n" . '<' . $pre . 'ECPointType>' . "\r\n" . '<' . $pre . 'X>' . $x . '' . "\r\n" . '<' . $pre . 'Y>' . $y . '' . "\r\n" . '' . "\r\n" . '' . "\r\n" . '<' . $pre . 'Order>' . $curve->getOrder() . '' . "\r\n" . '' . "\r\n" . '' . "\r\n"; return $xml; } if (isset($result['specifiedCurve'])) { $xml = '<' . $pre . 'ECParameters>' . "\r\n" . '<' . $pre . 'FieldID>' . "\r\n"; $temp = $result['specifiedCurve']; switch ($temp['fieldID']['fieldType']) { case 'prime-field': $xml .= '<' . $pre . 'Prime>' . "\r\n" . '<' . $pre . 'P>' . Strings::base64_encode($temp['fieldID']['parameters']->toBytes()) . '' . "\r\n" . '' . "\r\n" ; break; default: throw new UnsupportedCurveException('Field Type of ' . $temp['fieldID']['fieldType'] . ' is not supported'); } $xml .= '' . "\r\n" . '<' . $pre . 'Curve>' . "\r\n" . '<' . $pre . 'A>' . Strings::base64_encode($temp['curve']['a']) . '' . "\r\n" . '<' . $pre . 'B>' . Strings::base64_encode($temp['curve']['b']) . '' . "\r\n" . '' . "\r\n" . '<' . $pre . 'Base>' . Strings::base64_encode($temp['base']) . '' . "\r\n" . '<' . $pre . 'Order>' . Strings::base64_encode($temp['order']) . '' . "\r\n" . ''; return $xml; } } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\JWK as Progenitor; use phpseclib3\Crypt\EC\BaseCurves\Base as BaseCurve; use phpseclib3\Crypt\EC\BaseCurves\TwistedEdwards as TwistedEdwardsCurve; use phpseclib3\Crypt\EC\Curves\Ed25519; use phpseclib3\Crypt\EC\Curves\secp256k1; use phpseclib3\Crypt\EC\Curves\secp256r1; use phpseclib3\Crypt\EC\Curves\secp384r1; use phpseclib3\Crypt\EC\Curves\secp521r1; use phpseclib3\Exception\UnsupportedCurveException; use phpseclib3\Math\BigInteger; /** * JWK Formatted EC Handler * * @author Jim Wigginton */ abstract class JWK extends Progenitor { use Common; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { $key = parent::load($key, $password); switch ($key->kty) { case 'EC': switch ($key->crv) { case 'P-256': case 'P-384': case 'P-521': case 'secp256k1': break; default: throw new UnsupportedCurveException('Only P-256, P-384, P-521 and secp256k1 curves are accepted (' . $key->crv . ' provided)'); } break; case 'OKP': switch ($key->crv) { case 'Ed25519': case 'Ed448': break; default: throw new UnsupportedCurveException('Only Ed25519 and Ed448 curves are accepted (' . $key->crv . ' provided)'); } break; default: throw new \Exception('Only EC and OKP JWK keys are supported'); } $curve = '\phpseclib3\Crypt\EC\Curves\\' . str_replace('P-', 'nistp', $key->crv); $curve = new $curve(); if ($curve instanceof TwistedEdwardsCurve) { $QA = self::extractPoint(Strings::base64url_decode($key->x), $curve); if (!isset($key->d)) { return compact('curve', 'QA'); } $arr = $curve->extractSecret(Strings::base64url_decode($key->d)); return compact('curve', 'QA') + $arr; } $QA = [ $curve->convertInteger(new BigInteger(Strings::base64url_decode($key->x), 256)), $curve->convertInteger(new BigInteger(Strings::base64url_decode($key->y), 256)) ]; if (!$curve->verifyPoint($QA)) { throw new \RuntimeException('Unable to verify that point exists on curve'); } if (!isset($key->d)) { return compact('curve', 'QA'); } $dA = new BigInteger(Strings::base64url_decode($key->d), 256); $curve->rangeCheck($dA); return compact('curve', 'dA', 'QA'); } /** * Returns the alias that corresponds to a curve * * @return string */ private static function getAlias(BaseCurve $curve) { switch (true) { case $curve instanceof secp256r1: return 'P-256'; case $curve instanceof secp384r1: return 'P-384'; case $curve instanceof secp521r1: return 'P-521'; case $curve instanceof secp256k1: return 'secp256k1'; } $reflect = new \ReflectionClass($curve); $curveName = $reflect->isFinal() ? $reflect->getParentClass()->getShortName() : $reflect->getShortName(); throw new UnsupportedCurveException("$curveName is not a supported curve"); } /** * Return the array superstructure for an EC public key * * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @return array */ private static function savePublicKeyHelper(BaseCurve $curve, array $publicKey) { if ($curve instanceof TwistedEdwardsCurve) { return [ 'kty' => 'OKP', 'crv' => $curve instanceof Ed25519 ? 'Ed25519' : 'Ed448', 'x' => Strings::base64url_encode($curve->encodePoint($publicKey)) ]; } return [ 'kty' => 'EC', 'crv' => self::getAlias($curve), 'x' => Strings::base64url_encode($publicKey[0]->toBytes()), 'y' => Strings::base64url_encode($publicKey[1]->toBytes()) ]; } /** * Convert an EC public key to the appropriate format * * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @param array $options optional * @return string */ public static function savePublicKey(BaseCurve $curve, array $publicKey, array $options = []) { $key = self::savePublicKeyHelper($curve, $publicKey); return self::wrapKey($key, $options); } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $privateKey * @param \phpseclib3\Crypt\EC\Curves\Ed25519 $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @param string $secret optional * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $privateKey, BaseCurve $curve, array $publicKey, $secret = null, $password = '', array $options = []) { $key = self::savePublicKeyHelper($curve, $publicKey); $key['d'] = $curve instanceof TwistedEdwardsCurve ? $secret : $privateKey->toBytes(); $key['d'] = Strings::base64url_encode($key['d']); return self::wrapKey($key, $options); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\PuTTY as Progenitor; use phpseclib3\Crypt\EC\BaseCurves\Base as BaseCurve; use phpseclib3\Crypt\EC\BaseCurves\TwistedEdwards as TwistedEdwardsCurve; use phpseclib3\Math\BigInteger; /** * PuTTY Formatted EC Key Handler * * @author Jim Wigginton */ abstract class PuTTY extends Progenitor { use Common; /** * Public Handler * * @var string */ const PUBLIC_HANDLER = 'phpseclib3\Crypt\EC\Formats\Keys\OpenSSH'; /** * Supported Key Types * * @var array */ protected static $types = [ 'ecdsa-sha2-nistp256', 'ecdsa-sha2-nistp384', 'ecdsa-sha2-nistp521', 'ssh-ed25519' ]; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { $components = parent::load($key, $password); if (!isset($components['private'])) { return $components; } $private = $components['private']; $temp = Strings::base64_encode(Strings::packSSH2('s', $components['type']) . $components['public']); $components = OpenSSH::load($components['type'] . ' ' . $temp . ' ' . $components['comment']); if ($components['curve'] instanceof TwistedEdwardsCurve) { if (Strings::shift($private, 4) != "\0\0\0\x20") { throw new \RuntimeException('Length of ssh-ed25519 key should be 32'); } $arr = $components['curve']->extractSecret($private); $components['dA'] = $arr['dA']; $components['secret'] = $arr['secret']; } else { list($components['dA']) = Strings::unpackSSH2('i', $private); $components['curve']->rangeCheck($components['dA']); } return $components; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $privateKey * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @param string $secret optional * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $privateKey, BaseCurve $curve, array $publicKey, $secret = null, $password = false, array $options = []) { self::initialize_static_variables(); $public = explode(' ', OpenSSH::savePublicKey($curve, $publicKey)); $name = $public[0]; $public = Strings::base64_decode($public[1]); list(, $length) = unpack('N', Strings::shift($public, 4)); Strings::shift($public, $length); // PuTTY pads private keys with a null byte per the following: // https://github.com/github/putty/blob/a3d14d77f566a41fc61dfdc5c2e0e384c9e6ae8b/sshecc.c#L1926 if (!$curve instanceof TwistedEdwardsCurve) { $private = $privateKey->toBytes(); if (!(strlen($privateKey->toBits()) & 7)) { $private = "\0$private"; } } $private = $curve instanceof TwistedEdwardsCurve ? Strings::packSSH2('s', $secret) : Strings::packSSH2('s', $private); return self::wrapPrivateKey($public, $private, $name, $password, $options); } /** * Convert an EC public key to the appropriate format * * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @param \phpseclib3\Math\Common\FiniteField[] $publicKey * @return string */ public static function savePublicKey(BaseCurve $curve, array $publicKey) { $public = explode(' ', OpenSSH::savePublicKey($curve, $publicKey)); $type = $public[0]; $public = Strings::base64_decode($public[1]); list(, $length) = unpack('N', Strings::shift($public, 4)); Strings::shift($public, $length); return self::wrapPublicKey($public, $type); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Keys; use phpseclib3\Crypt\EC\BaseCurves\Montgomery as MontgomeryCurve; use phpseclib3\Crypt\EC\Curves\Curve25519; use phpseclib3\Crypt\EC\Curves\Curve448; use phpseclib3\Math\BigInteger; /** * Montgomery Public Key Handler * * @author Jim Wigginton */ abstract class MontgomeryPublic { /** * Is invisible flag * */ const IS_INVISIBLE = true; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { switch (strlen($key)) { case 32: $curve = new Curve25519(); break; case 56: $curve = new Curve448(); break; default: throw new \LengthException('The only supported lengths are 32 and 56'); } $components = ['curve' => $curve]; $components['QA'] = [$components['curve']->convertInteger(new BigInteger(strrev($key), 256))]; return $components; } /** * Convert an EC public key to the appropriate format * * @param \phpseclib3\Crypt\EC\BaseCurves\Montgomery $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @return string */ public static function savePublicKey(MontgomeryCurve $curve, array $publicKey) { return strrev($publicKey[0]->toBytes()); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\EC\BaseCurves\Base as BaseCurve; use phpseclib3\Crypt\EC\BaseCurves\Binary as BinaryCurve; use phpseclib3\Crypt\EC\BaseCurves\Prime as PrimeCurve; use phpseclib3\Crypt\EC\BaseCurves\TwistedEdwards as TwistedEdwardsCurve; use phpseclib3\Exception\UnsupportedCurveException; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps; use phpseclib3\Math\BigInteger; /** * Generic EC Key Parsing Helper functions * * @author Jim Wigginton */ trait Common { /** * Curve OIDs * * @var array */ private static $curveOIDs = []; /** * Child OIDs loaded * * @var bool */ protected static $childOIDsLoaded = false; /** * Use Named Curves * * @var bool */ private static $useNamedCurves = true; /** * Initialize static variables */ private static function initialize_static_variables() { if (empty(self::$curveOIDs)) { // the sec* curves are from the standards for efficient cryptography group // sect* curves are curves over binary finite fields // secp* curves are curves over prime finite fields // sec*r* curves are regular curves; sec*k* curves are koblitz curves // brainpool*r* curves are regular prime finite field curves // brainpool*t* curves are twisted versions of the brainpool*r* curves self::$curveOIDs = [ 'prime192v1' => '1.2.840.10045.3.1.1', // J.5.1, example 1 (aka secp192r1) 'prime192v2' => '1.2.840.10045.3.1.2', // J.5.1, example 2 'prime192v3' => '1.2.840.10045.3.1.3', // J.5.1, example 3 'prime239v1' => '1.2.840.10045.3.1.4', // J.5.2, example 1 'prime239v2' => '1.2.840.10045.3.1.5', // J.5.2, example 2 'prime239v3' => '1.2.840.10045.3.1.6', // J.5.2, example 3 'prime256v1' => '1.2.840.10045.3.1.7', // J.5.3, example 1 (aka secp256r1) // https://tools.ietf.org/html/rfc5656#section-10 'nistp256' => '1.2.840.10045.3.1.7', // aka secp256r1 'nistp384' => '1.3.132.0.34', // aka secp384r1 'nistp521' => '1.3.132.0.35', // aka secp521r1 'nistk163' => '1.3.132.0.1', // aka sect163k1 'nistp192' => '1.2.840.10045.3.1.1', // aka secp192r1 'nistp224' => '1.3.132.0.33', // aka secp224r1 'nistk233' => '1.3.132.0.26', // aka sect233k1 'nistb233' => '1.3.132.0.27', // aka sect233r1 'nistk283' => '1.3.132.0.16', // aka sect283k1 'nistk409' => '1.3.132.0.36', // aka sect409k1 'nistb409' => '1.3.132.0.37', // aka sect409r1 'nistt571' => '1.3.132.0.38', // aka sect571k1 // from https://tools.ietf.org/html/rfc5915 'secp192r1' => '1.2.840.10045.3.1.1', // aka prime192v1 'sect163k1' => '1.3.132.0.1', 'sect163r2' => '1.3.132.0.15', 'secp224r1' => '1.3.132.0.33', 'sect233k1' => '1.3.132.0.26', 'sect233r1' => '1.3.132.0.27', 'secp256r1' => '1.2.840.10045.3.1.7', // aka prime256v1 'sect283k1' => '1.3.132.0.16', 'sect283r1' => '1.3.132.0.17', 'secp384r1' => '1.3.132.0.34', 'sect409k1' => '1.3.132.0.36', 'sect409r1' => '1.3.132.0.37', 'secp521r1' => '1.3.132.0.35', 'sect571k1' => '1.3.132.0.38', 'sect571r1' => '1.3.132.0.39', // from http://www.secg.org/SEC2-Ver-1.0.pdf 'secp112r1' => '1.3.132.0.6', 'secp112r2' => '1.3.132.0.7', 'secp128r1' => '1.3.132.0.28', 'secp128r2' => '1.3.132.0.29', 'secp160k1' => '1.3.132.0.9', 'secp160r1' => '1.3.132.0.8', 'secp160r2' => '1.3.132.0.30', 'secp192k1' => '1.3.132.0.31', 'secp224k1' => '1.3.132.0.32', 'secp256k1' => '1.3.132.0.10', 'sect113r1' => '1.3.132.0.4', 'sect113r2' => '1.3.132.0.5', 'sect131r1' => '1.3.132.0.22', 'sect131r2' => '1.3.132.0.23', 'sect163r1' => '1.3.132.0.2', 'sect193r1' => '1.3.132.0.24', 'sect193r2' => '1.3.132.0.25', 'sect239k1' => '1.3.132.0.3', // from http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.202.2977&rep=rep1&type=pdf#page=36 /* 'c2pnb163v1' => '1.2.840.10045.3.0.1', // J.4.1, example 1 'c2pnb163v2' => '1.2.840.10045.3.0.2', // J.4.1, example 2 'c2pnb163v3' => '1.2.840.10045.3.0.3', // J.4.1, example 3 'c2pnb172w1' => '1.2.840.10045.3.0.4', // J.4.2, example 1 'c2tnb191v1' => '1.2.840.10045.3.0.5', // J.4.3, example 1 'c2tnb191v2' => '1.2.840.10045.3.0.6', // J.4.3, example 2 'c2tnb191v3' => '1.2.840.10045.3.0.7', // J.4.3, example 3 'c2onb191v4' => '1.2.840.10045.3.0.8', // J.4.3, example 4 'c2onb191v5' => '1.2.840.10045.3.0.9', // J.4.3, example 5 'c2pnb208w1' => '1.2.840.10045.3.0.10', // J.4.4, example 1 'c2tnb239v1' => '1.2.840.10045.3.0.11', // J.4.5, example 1 'c2tnb239v2' => '1.2.840.10045.3.0.12', // J.4.5, example 2 'c2tnb239v3' => '1.2.840.10045.3.0.13', // J.4.5, example 3 'c2onb239v4' => '1.2.840.10045.3.0.14', // J.4.5, example 4 'c2onb239v5' => '1.2.840.10045.3.0.15', // J.4.5, example 5 'c2pnb272w1' => '1.2.840.10045.3.0.16', // J.4.6, example 1 'c2pnb304w1' => '1.2.840.10045.3.0.17', // J.4.7, example 1 'c2tnb359v1' => '1.2.840.10045.3.0.18', // J.4.8, example 1 'c2pnb368w1' => '1.2.840.10045.3.0.19', // J.4.9, example 1 'c2tnb431r1' => '1.2.840.10045.3.0.20', // J.4.10, example 1 */ // http://www.ecc-brainpool.org/download/Domain-parameters.pdf // https://tools.ietf.org/html/rfc5639 'brainpoolP160r1' => '1.3.36.3.3.2.8.1.1.1', 'brainpoolP160t1' => '1.3.36.3.3.2.8.1.1.2', 'brainpoolP192r1' => '1.3.36.3.3.2.8.1.1.3', 'brainpoolP192t1' => '1.3.36.3.3.2.8.1.1.4', 'brainpoolP224r1' => '1.3.36.3.3.2.8.1.1.5', 'brainpoolP224t1' => '1.3.36.3.3.2.8.1.1.6', 'brainpoolP256r1' => '1.3.36.3.3.2.8.1.1.7', 'brainpoolP256t1' => '1.3.36.3.3.2.8.1.1.8', 'brainpoolP320r1' => '1.3.36.3.3.2.8.1.1.9', 'brainpoolP320t1' => '1.3.36.3.3.2.8.1.1.10', 'brainpoolP384r1' => '1.3.36.3.3.2.8.1.1.11', 'brainpoolP384t1' => '1.3.36.3.3.2.8.1.1.12', 'brainpoolP512r1' => '1.3.36.3.3.2.8.1.1.13', 'brainpoolP512t1' => '1.3.36.3.3.2.8.1.1.14' ]; ASN1::loadOIDs([ 'prime-field' => '1.2.840.10045.1.1', 'characteristic-two-field' => '1.2.840.10045.1.2', 'characteristic-two-basis' => '1.2.840.10045.1.2.3', // per http://www.secg.org/SEC1-Ver-1.0.pdf#page=84, gnBasis "not used here" 'gnBasis' => '1.2.840.10045.1.2.3.1', // NULL 'tpBasis' => '1.2.840.10045.1.2.3.2', // Trinomial 'ppBasis' => '1.2.840.10045.1.2.3.3' // Pentanomial ] + self::$curveOIDs); } } /** * Explicitly set the curve * * If the key contains an implicit curve phpseclib needs the curve * to be explicitly provided * * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve */ public static function setImplicitCurve(BaseCurve $curve) { self::$implicitCurve = $curve; } /** * Returns an instance of \phpseclib3\Crypt\EC\BaseCurves\Base based * on the curve parameters * * @param array $params * @return \phpseclib3\Crypt\EC\BaseCurves\Base|false */ protected static function loadCurveByParam(array $params) { if (count($params) > 1) { throw new \RuntimeException('No parameters are present'); } if (isset($params['namedCurve'])) { $curve = '\phpseclib3\Crypt\EC\Curves\\' . $params['namedCurve']; if (!class_exists($curve)) { throw new UnsupportedCurveException('Named Curve of ' . $params['namedCurve'] . ' is not supported'); } return new $curve(); } if (isset($params['implicitCurve'])) { if (!isset(self::$implicitCurve)) { throw new \RuntimeException('Implicit curves can be provided by calling setImplicitCurve'); } return self::$implicitCurve; } if (isset($params['specifiedCurve'])) { $data = $params['specifiedCurve']; switch ($data['fieldID']['fieldType']) { case 'prime-field': $curve = new PrimeCurve(); $curve->setModulo($data['fieldID']['parameters']); $curve->setCoefficients( new BigInteger($data['curve']['a'], 256), new BigInteger($data['curve']['b'], 256) ); $point = self::extractPoint("\0" . $data['base'], $curve); $curve->setBasePoint(...$point); $curve->setOrder($data['order']); return $curve; case 'characteristic-two-field': $curve = new BinaryCurve(); $params = ASN1::decodeBER($data['fieldID']['parameters']); $params = ASN1::asn1map($params[0], Maps\Characteristic_two::MAP); $modulo = [(int) $params['m']->toString()]; switch ($params['basis']) { case 'tpBasis': $modulo[] = (int) $params['parameters']->toString(); break; case 'ppBasis': $temp = ASN1::decodeBER($params['parameters']); $temp = ASN1::asn1map($temp[0], Maps\Pentanomial::MAP); $modulo[] = (int) $temp['k3']->toString(); $modulo[] = (int) $temp['k2']->toString(); $modulo[] = (int) $temp['k1']->toString(); } $modulo[] = 0; $curve->setModulo(...$modulo); $len = ceil($modulo[0] / 8); $curve->setCoefficients( Strings::bin2hex($data['curve']['a']), Strings::bin2hex($data['curve']['b']) ); $point = self::extractPoint("\0" . $data['base'], $curve); $curve->setBasePoint(...$point); $curve->setOrder($data['order']); return $curve; default: throw new UnsupportedCurveException('Field Type of ' . $data['fieldID']['fieldType'] . ' is not supported'); } } throw new \RuntimeException('No valid parameters are present'); } /** * Extract points from a string * * Supports both compressed and uncompressed points * * @param string $str * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @return object[] */ public static function extractPoint($str, BaseCurve $curve) { if ($curve instanceof TwistedEdwardsCurve) { // first step of point deciding as discussed at the following URL's: // https://tools.ietf.org/html/rfc8032#section-5.1.3 // https://tools.ietf.org/html/rfc8032#section-5.2.3 $y = $str; $y = strrev($y); $sign = (bool) (ord($y[0]) & 0x80); $y[0] = $y[0] & chr(0x7F); $y = new BigInteger($y, 256); if ($y->compare($curve->getModulo()) >= 0) { throw new \RuntimeException('The Y coordinate should not be >= the modulo'); } $point = $curve->recoverX($y, $sign); if (!$curve->verifyPoint($point)) { throw new \RuntimeException('Unable to verify that point exists on curve'); } return $point; } // the first byte of a bit string represents the number of bits in the last byte that are to be ignored but, // currently, bit strings wanting a non-zero amount of bits trimmed are not supported if (($val = Strings::shift($str)) != "\0") { throw new \UnexpectedValueException('extractPoint expects the first byte to be null - not ' . Strings::bin2hex($val)); } if ($str == "\0") { return []; } $keylen = strlen($str); $order = $curve->getLengthInBytes(); // point compression is being used if ($keylen == $order + 1) { return $curve->derivePoint($str); } // point compression is not being used if ($keylen == 2 * $order + 1) { preg_match("#(.)(.{{$order}})(.{{$order}})#s", $str, $matches); list(, $w, $x, $y) = $matches; if ($w != "\4") { throw new \UnexpectedValueException('The first byte of an uncompressed point should be 04 - not ' . Strings::bin2hex($val)); } $point = [ $curve->convertInteger(new BigInteger($x, 256)), $curve->convertInteger(new BigInteger($y, 256)) ]; if (!$curve->verifyPoint($point)) { throw new \RuntimeException('Unable to verify that point exists on curve'); } return $point; } throw new \UnexpectedValueException('The string representation of the points is not of an appropriate length'); } /** * Encode Parameters * * @todo Maybe at some point this could be moved to __toString() for each of the curves? * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @param bool $returnArray optional * @param array $options optional * @return string|false */ private static function encodeParameters(BaseCurve $curve, $returnArray = false, array $options = []) { $useNamedCurves = isset($options['namedCurve']) ? $options['namedCurve'] : self::$useNamedCurves; $reflect = new \ReflectionClass($curve); $name = $reflect->getShortName(); if ($useNamedCurves) { if (isset(self::$curveOIDs[$name])) { if ($reflect->isFinal()) { $reflect = $reflect->getParentClass(); $name = $reflect->getShortName(); } return $returnArray ? ['namedCurve' => $name] : ASN1::encodeDER(['namedCurve' => $name], Maps\ECParameters::MAP); } foreach (new \DirectoryIterator(__DIR__ . '/../../Curves/') as $file) { if ($file->getExtension() != 'php') { continue; } $testName = $file->getBasename('.php'); $class = 'phpseclib3\Crypt\EC\Curves\\' . $testName; $reflect = new \ReflectionClass($class); if ($reflect->isFinal()) { continue; } $candidate = new $class(); switch ($name) { case 'Prime': if (!$candidate instanceof PrimeCurve) { break; } if (!$candidate->getModulo()->equals($curve->getModulo())) { break; } if ($candidate->getA()->toBytes() != $curve->getA()->toBytes()) { break; } if ($candidate->getB()->toBytes() != $curve->getB()->toBytes()) { break; } list($candidateX, $candidateY) = $candidate->getBasePoint(); list($curveX, $curveY) = $curve->getBasePoint(); if ($candidateX->toBytes() != $curveX->toBytes()) { break; } if ($candidateY->toBytes() != $curveY->toBytes()) { break; } return $returnArray ? ['namedCurve' => $testName] : ASN1::encodeDER(['namedCurve' => $testName], Maps\ECParameters::MAP); case 'Binary': if (!$candidate instanceof BinaryCurve) { break; } if ($candidate->getModulo() != $curve->getModulo()) { break; } if ($candidate->getA()->toBytes() != $curve->getA()->toBytes()) { break; } if ($candidate->getB()->toBytes() != $curve->getB()->toBytes()) { break; } list($candidateX, $candidateY) = $candidate->getBasePoint(); list($curveX, $curveY) = $curve->getBasePoint(); if ($candidateX->toBytes() != $curveX->toBytes()) { break; } if ($candidateY->toBytes() != $curveY->toBytes()) { break; } return $returnArray ? ['namedCurve' => $testName] : ASN1::encodeDER(['namedCurve' => $testName], Maps\ECParameters::MAP); } } } $order = $curve->getOrder(); // we could try to calculate the order thusly: // https://crypto.stackexchange.com/a/27914/4520 // https://en.wikipedia.org/wiki/Schoof%E2%80%93Elkies%E2%80%93Atkin_algorithm if (!$order) { throw new \RuntimeException('Specified Curves need the order to be specified'); } $point = $curve->getBasePoint(); $x = $point[0]->toBytes(); $y = $point[1]->toBytes(); if ($curve instanceof PrimeCurve) { /* * valid versions are: * * ecdpVer1: * - neither the curve or the base point are generated verifiably randomly. * ecdpVer2: * - curve and base point are generated verifiably at random and curve.seed is present * ecdpVer3: * - base point is generated verifiably at random but curve is not. curve.seed is present */ // other (optional) parameters can be calculated using the methods discused at // https://crypto.stackexchange.com/q/28947/4520 $data = [ 'version' => 'ecdpVer1', 'fieldID' => [ 'fieldType' => 'prime-field', 'parameters' => $curve->getModulo() ], 'curve' => [ 'a' => $curve->getA()->toBytes(), 'b' => $curve->getB()->toBytes() ], 'base' => "\4" . $x . $y, 'order' => $order ]; return $returnArray ? ['specifiedCurve' => $data] : ASN1::encodeDER(['specifiedCurve' => $data], Maps\ECParameters::MAP); } if ($curve instanceof BinaryCurve) { $modulo = $curve->getModulo(); $basis = count($modulo); $m = array_shift($modulo); array_pop($modulo); // the last parameter should always be 0 //rsort($modulo); switch ($basis) { case 3: $basis = 'tpBasis'; $modulo = new BigInteger($modulo[0]); break; case 5: $basis = 'ppBasis'; // these should be in strictly ascending order (hence the commented out rsort above) $modulo = [ 'k1' => new BigInteger($modulo[2]), 'k2' => new BigInteger($modulo[1]), 'k3' => new BigInteger($modulo[0]) ]; $modulo = ASN1::encodeDER($modulo, Maps\Pentanomial::MAP); $modulo = new ASN1\Element($modulo); } $params = ASN1::encodeDER([ 'm' => new BigInteger($m), 'basis' => $basis, 'parameters' => $modulo ], Maps\Characteristic_two::MAP); $params = new ASN1\Element($params); $a = ltrim($curve->getA()->toBytes(), "\0"); if (!strlen($a)) { $a = "\0"; } $b = ltrim($curve->getB()->toBytes(), "\0"); if (!strlen($b)) { $b = "\0"; } $data = [ 'version' => 'ecdpVer1', 'fieldID' => [ 'fieldType' => 'characteristic-two-field', 'parameters' => $params ], 'curve' => [ 'a' => $a, 'b' => $b ], 'base' => "\4" . $x . $y, 'order' => $order ]; return $returnArray ? ['specifiedCurve' => $data] : ASN1::encodeDER(['specifiedCurve' => $data], Maps\ECParameters::MAP); } throw new UnsupportedCurveException('Curve cannot be serialized'); } /** * Use Specified Curve * * A specified curve has all the coefficients, the base points, etc, explicitely included. * A specified curve is a more verbose way of representing a curve */ public static function useSpecifiedCurve() { self::$useNamedCurves = false; } /** * Use Named Curve * * A named curve does not include any parameters. It is up to the EC parameters to * know what the coefficients, the base points, etc, are from the name of the curve. * A named curve is a more concise way of representing a curve */ public static function useNamedCurve() { self::$useNamedCurves = true; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\OpenSSH as Progenitor; use phpseclib3\Crypt\EC\BaseCurves\Base as BaseCurve; use phpseclib3\Crypt\EC\Curves\Ed25519; use phpseclib3\Exception\UnsupportedCurveException; use phpseclib3\Math\BigInteger; /** * OpenSSH Formatted EC Key Handler * * @author Jim Wigginton */ abstract class OpenSSH extends Progenitor { use Common; /** * Supported Key Types * * @var array */ protected static $types = [ 'ecdsa-sha2-nistp256', 'ecdsa-sha2-nistp384', 'ecdsa-sha2-nistp521', 'ssh-ed25519' ]; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { $parsed = parent::load($key, $password); if (isset($parsed['paddedKey'])) { $paddedKey = $parsed['paddedKey']; list($type) = Strings::unpackSSH2('s', $paddedKey); if ($type != $parsed['type']) { throw new \RuntimeException("The public and private keys are not of the same type ($type vs $parsed[type])"); } if ($type == 'ssh-ed25519') { list(, $key, $comment) = Strings::unpackSSH2('sss', $paddedKey); $key = libsodium::load($key); $key['comment'] = $comment; return $key; } list($curveName, $publicKey, $privateKey, $comment) = Strings::unpackSSH2('ssis', $paddedKey); $curve = self::loadCurveByParam(['namedCurve' => $curveName]); $curve->rangeCheck($privateKey); return [ 'curve' => $curve, 'dA' => $privateKey, 'QA' => self::extractPoint("\0$publicKey", $curve), 'comment' => $comment ]; } if ($parsed['type'] == 'ssh-ed25519') { if (Strings::shift($parsed['publicKey'], 4) != "\0\0\0\x20") { throw new \RuntimeException('Length of ssh-ed25519 key should be 32'); } $curve = new Ed25519(); $qa = self::extractPoint($parsed['publicKey'], $curve); } else { list($curveName, $publicKey) = Strings::unpackSSH2('ss', $parsed['publicKey']); $curveName = '\phpseclib3\Crypt\EC\Curves\\' . $curveName; $curve = new $curveName(); $qa = self::extractPoint("\0" . $publicKey, $curve); } return [ 'curve' => $curve, 'QA' => $qa, 'comment' => $parsed['comment'] ]; } /** * Returns the alias that corresponds to a curve * * @return string */ private static function getAlias(BaseCurve $curve) { self::initialize_static_variables(); $reflect = new \ReflectionClass($curve); $name = $reflect->getShortName(); $oid = self::$curveOIDs[$name]; $aliases = array_filter(self::$curveOIDs, function ($v) use ($oid) { return $v == $oid; }); $aliases = array_keys($aliases); for ($i = 0; $i < count($aliases); $i++) { if (in_array('ecdsa-sha2-' . $aliases[$i], self::$types)) { $alias = $aliases[$i]; break; } } if (!isset($alias)) { throw new UnsupportedCurveException($name . ' is not a curve that the OpenSSH plugin supports'); } return $alias; } /** * Convert an EC public key to the appropriate format * * @param \phpseclib3\Crypt\EC\BaseCurves\Base $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @param array $options optional * @return string */ public static function savePublicKey(BaseCurve $curve, array $publicKey, array $options = []) { $comment = isset($options['comment']) ? $options['comment'] : self::$comment; if ($curve instanceof Ed25519) { $key = Strings::packSSH2('ss', 'ssh-ed25519', $curve->encodePoint($publicKey)); if (isset($options['binary']) ? $options['binary'] : self::$binary) { return $key; } $key = 'ssh-ed25519 ' . base64_encode($key) . ' ' . $comment; return $key; } $alias = self::getAlias($curve); $points = "\4" . $publicKey[0]->toBytes() . $publicKey[1]->toBytes(); $key = Strings::packSSH2('sss', 'ecdsa-sha2-' . $alias, $alias, $points); if (isset($options['binary']) ? $options['binary'] : self::$binary) { return $key; } $key = 'ecdsa-sha2-' . $alias . ' ' . base64_encode($key) . ' ' . $comment; return $key; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $privateKey * @param \phpseclib3\Crypt\EC\Curves\Ed25519 $curve * @param \phpseclib3\Math\Common\FiniteField\Integer[] $publicKey * @param string $secret optional * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $privateKey, BaseCurve $curve, array $publicKey, $secret = null, $password = '', array $options = []) { if ($curve instanceof Ed25519) { if (!isset($secret)) { throw new \RuntimeException('Private Key does not have a secret set'); } if (strlen($secret) != 32) { throw new \RuntimeException('Private Key secret is not of the correct length'); } $pubKey = $curve->encodePoint($publicKey); $publicKey = Strings::packSSH2('ss', 'ssh-ed25519', $pubKey); $privateKey = Strings::packSSH2('sss', 'ssh-ed25519', $pubKey, $secret . $pubKey); return self::wrapPrivateKey($publicKey, $privateKey, $password, $options); } $alias = self::getAlias($curve); $points = "\4" . $publicKey[0]->toBytes() . $publicKey[1]->toBytes(); $publicKey = self::savePublicKey($curve, $publicKey, ['binary' => true]); $privateKey = Strings::packSSH2('sssi', 'ecdsa-sha2-' . $alias, $alias, $points, $privateKey); return self::wrapPrivateKey($publicKey, $privateKey, $password, $options); } } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Signature; use phpseclib3\File\ASN1 as Encoder; use phpseclib3\File\ASN1\Maps\EcdsaSigValue; use phpseclib3\Math\BigInteger; /** * ASN1 Signature Handler * * @author Jim Wigginton */ abstract class ASN1 { /** * Loads a signature * * @param string $sig * @return array */ public static function load($sig) { if (!is_string($sig)) { return false; } $decoded = Encoder::decodeBER($sig); if (empty($decoded)) { return false; } $components = Encoder::asn1map($decoded[0], EcdsaSigValue::MAP); return $components; } /** * Returns a signature in the appropriate format * * @param \phpseclib3\Math\BigInteger $r * @param \phpseclib3\Math\BigInteger $s * @return string */ public static function save(BigInteger $r, BigInteger $s) { return Encoder::encodeDER(compact('r', 's'), EcdsaSigValue::MAP); } } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Signature; use phpseclib3\Common\Functions\Strings; use phpseclib3\Math\BigInteger; /** * SSH2 Signature Handler * * @author Jim Wigginton */ abstract class SSH2 { /** * Loads a signature * * @param string $sig * @return mixed */ public static function load($sig) { if (!is_string($sig)) { return false; } $result = Strings::unpackSSH2('ss', $sig); if ($result === false) { return false; } list($type, $blob) = $result; switch ($type) { // see https://tools.ietf.org/html/rfc5656#section-3.1.2 case 'ecdsa-sha2-nistp256': case 'ecdsa-sha2-nistp384': case 'ecdsa-sha2-nistp521': break; default: return false; } $result = Strings::unpackSSH2('ii', $blob); if ($result === false) { return false; } return [ 'r' => $result[0], 's' => $result[1] ]; } /** * Returns a signature in the appropriate format * * @param \phpseclib3\Math\BigInteger $r * @param \phpseclib3\Math\BigInteger $s * @param string $curve * @return string */ public static function save(BigInteger $r, BigInteger $s, $curve) { switch ($curve) { case 'secp256r1': $curve = 'nistp256'; break; case 'secp384r1': $curve = 'nistp384'; break; case 'secp521r1': $curve = 'nistp521'; break; default: return false; } $blob = Strings::packSSH2('ii', $r, $s); return Strings::packSSH2('ss', 'ecdsa-sha2-' . $curve, $blob); } } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC\Formats\Signature; use phpseclib3\Crypt\Common\Formats\Signature\Raw as Progenitor; /** * Raw DSA Signature Handler * * @author Jim Wigginton */ abstract class Raw extends Progenitor { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\EC; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common; use phpseclib3\Crypt\EC; use phpseclib3\Crypt\EC\BaseCurves\Montgomery as MontgomeryCurve; use phpseclib3\Crypt\EC\BaseCurves\TwistedEdwards as TwistedEdwardsCurve; use phpseclib3\Crypt\EC\Curves\Ed25519; use phpseclib3\Crypt\EC\Formats\Keys\PKCS1; use phpseclib3\Crypt\EC\Formats\Signature\ASN1 as ASN1Signature; use phpseclib3\Crypt\Hash; use phpseclib3\Exception\UnsupportedOperationException; use phpseclib3\Math\BigInteger; /** * EC Public Key * * @author Jim Wigginton */ class PublicKey extends EC implements Common\PublicKey { use Common\Traits\Fingerprint; /** * Verify a signature * * @see self::verify() * @param string $message * @param string $signature * @return mixed */ public function verify($message, $signature) { if ($this->curve instanceof MontgomeryCurve) { throw new UnsupportedOperationException('Montgomery Curves cannot be used to create signatures'); } $shortFormat = $this->shortFormat; $format = $this->sigFormat; if ($format === false) { return false; } $order = $this->curve->getOrder(); if ($this->curve instanceof TwistedEdwardsCurve) { if ($shortFormat == 'SSH2') { list(, $signature) = Strings::unpackSSH2('ss', $signature); } if ($this->curve instanceof Ed25519 && self::$engines['libsodium'] && !isset($this->context)) { return sodium_crypto_sign_verify_detached($signature, $message, $this->toString('libsodium')); } $curve = $this->curve; if (strlen($signature) != 2 * $curve::SIZE) { return false; } $R = substr($signature, 0, $curve::SIZE); $S = substr($signature, $curve::SIZE); try { $R = PKCS1::extractPoint($R, $curve); $R = $this->curve->convertToInternal($R); } catch (\Exception $e) { return false; } $S = strrev($S); $S = new BigInteger($S, 256); if ($S->compare($order) >= 0) { return false; } $A = $curve->encodePoint($this->QA); if ($curve instanceof Ed25519) { $dom2 = !isset($this->context) ? '' : 'SigEd25519 no Ed25519 collisions' . "\0" . chr(strlen($this->context)) . $this->context; } else { $context = isset($this->context) ? $this->context : ''; $dom2 = 'SigEd448' . "\0" . chr(strlen($context)) . $context; } $hash = new Hash($curve::HASH); $k = $hash->hash($dom2 . substr($signature, 0, $curve::SIZE) . $A . $message); $k = strrev($k); $k = new BigInteger($k, 256); list(, $k) = $k->divide($order); $qa = $curve->convertToInternal($this->QA); $lhs = $curve->multiplyPoint($curve->getBasePoint(), $S); $rhs = $curve->multiplyPoint($qa, $k); $rhs = $curve->addPoint($rhs, $R); $rhs = $curve->convertToAffine($rhs); return $lhs[0]->equals($rhs[0]) && $lhs[1]->equals($rhs[1]); } $params = $format::load($signature); if ($params === false || count($params) != 2) { return false; } extract($params); if (self::$engines['OpenSSL'] && in_array($this->hash->getHash(), openssl_get_md_methods())) { $sig = $format != 'ASN1' ? ASN1Signature::save($r, $s) : $signature; $result = openssl_verify($message, $sig, $this->toString('PKCS8', ['namedCurve' => false]), $this->hash->getHash()); if ($result != -1) { return (bool) $result; } } $n_1 = $order->subtract(self::$one); if (!$r->between(self::$one, $n_1) || !$s->between(self::$one, $n_1)) { return false; } $e = $this->hash->hash($message); $e = new BigInteger($e, 256); $Ln = $this->hash->getLength() - $order->getLength(); $z = $Ln > 0 ? $e->bitwise_rightShift($Ln) : $e; $w = $s->modInverse($order); list(, $u1) = $z->multiply($w)->divide($order); list(, $u2) = $r->multiply($w)->divide($order); $u1 = $this->curve->convertInteger($u1); $u2 = $this->curve->convertInteger($u2); list($x1, $y1) = $this->curve->multiplyAddPoints( [$this->curve->getBasePoint(), $this->QA], [$u1, $u2] ); $x1 = $x1->toBigInteger(); list(, $x1) = $x1->divide($order); return $x1->equals($r); } /** * Returns the public key * * @param string $type * @param array $options optional * @return string */ public function toString($type, array $options = []) { $type = self::validatePlugin('Keys', $type, 'savePublicKey'); return $type::savePublicKey($this->curve, $this->QA, $options); } } * setKey('abcdefgh'); * * $plaintext = str_repeat('a', 1024); * * echo $rc2->decrypt($rc2->encrypt($plaintext)); * ?> * * * @author Patrick Monnerat * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Crypt\Common\BlockCipher; use phpseclib3\Exception\BadModeException; /** * Pure-PHP implementation of RC2. * */ class RC2 extends BlockCipher { /** * Block Length of the cipher * * @see \phpseclib3\Crypt\Common\SymmetricKey::block_size * @var int */ protected $block_size = 8; /** * The Key * * @see \phpseclib3\Crypt\Common\SymmetricKey::key * @see self::setKey() * @var string */ protected $key; /** * The Original (unpadded) Key * * @see \phpseclib3\Crypt\Common\SymmetricKey::key * @see self::setKey() * @see self::encrypt() * @see self::decrypt() * @var string */ private $orig_key; /** * Key Length (in bytes) * * @see \phpseclib3\Crypt\RC2::setKeyLength() * @var int */ protected $key_length = 16; // = 128 bits /** * The mcrypt specific name of the cipher * * @see \phpseclib3\Crypt\Common\SymmetricKey::cipher_name_mcrypt * @var string */ protected $cipher_name_mcrypt = 'rc2'; /** * Optimizing value while CFB-encrypting * * @see \phpseclib3\Crypt\Common\SymmetricKey::cfb_init_len * @var int */ protected $cfb_init_len = 500; /** * The key length in bits. * * {@internal Should be in range [1..1024].} * * {@internal Changing this value after setting the key has no effect.} * * @see self::setKeyLength() * @see self::setKey() * @var int */ private $default_key_length = 1024; /** * The key length in bits. * * {@internal Should be in range [1..1024].} * * @see self::isValidEnine() * @see self::setKey() * @var int */ private $current_key_length; /** * The Key Schedule * * @see self::setupKey() * @var array */ private $keys; /** * Key expansion randomization table. * Twice the same 256-value sequence to save a modulus in key expansion. * * @see self::setKey() * @var array */ private static $pitable = [ 0xD9, 0x78, 0xF9, 0xC4, 0x19, 0xDD, 0xB5, 0xED, 0x28, 0xE9, 0xFD, 0x79, 0x4A, 0xA0, 0xD8, 0x9D, 0xC6, 0x7E, 0x37, 0x83, 0x2B, 0x76, 0x53, 0x8E, 0x62, 0x4C, 0x64, 0x88, 0x44, 0x8B, 0xFB, 0xA2, 0x17, 0x9A, 0x59, 0xF5, 0x87, 0xB3, 0x4F, 0x13, 0x61, 0x45, 0x6D, 0x8D, 0x09, 0x81, 0x7D, 0x32, 0xBD, 0x8F, 0x40, 0xEB, 0x86, 0xB7, 0x7B, 0x0B, 0xF0, 0x95, 0x21, 0x22, 0x5C, 0x6B, 0x4E, 0x82, 0x54, 0xD6, 0x65, 0x93, 0xCE, 0x60, 0xB2, 0x1C, 0x73, 0x56, 0xC0, 0x14, 0xA7, 0x8C, 0xF1, 0xDC, 0x12, 0x75, 0xCA, 0x1F, 0x3B, 0xBE, 0xE4, 0xD1, 0x42, 0x3D, 0xD4, 0x30, 0xA3, 0x3C, 0xB6, 0x26, 0x6F, 0xBF, 0x0E, 0xDA, 0x46, 0x69, 0x07, 0x57, 0x27, 0xF2, 0x1D, 0x9B, 0xBC, 0x94, 0x43, 0x03, 0xF8, 0x11, 0xC7, 0xF6, 0x90, 0xEF, 0x3E, 0xE7, 0x06, 0xC3, 0xD5, 0x2F, 0xC8, 0x66, 0x1E, 0xD7, 0x08, 0xE8, 0xEA, 0xDE, 0x80, 0x52, 0xEE, 0xF7, 0x84, 0xAA, 0x72, 0xAC, 0x35, 0x4D, 0x6A, 0x2A, 0x96, 0x1A, 0xD2, 0x71, 0x5A, 0x15, 0x49, 0x74, 0x4B, 0x9F, 0xD0, 0x5E, 0x04, 0x18, 0xA4, 0xEC, 0xC2, 0xE0, 0x41, 0x6E, 0x0F, 0x51, 0xCB, 0xCC, 0x24, 0x91, 0xAF, 0x50, 0xA1, 0xF4, 0x70, 0x39, 0x99, 0x7C, 0x3A, 0x85, 0x23, 0xB8, 0xB4, 0x7A, 0xFC, 0x02, 0x36, 0x5B, 0x25, 0x55, 0x97, 0x31, 0x2D, 0x5D, 0xFA, 0x98, 0xE3, 0x8A, 0x92, 0xAE, 0x05, 0xDF, 0x29, 0x10, 0x67, 0x6C, 0xBA, 0xC9, 0xD3, 0x00, 0xE6, 0xCF, 0xE1, 0x9E, 0xA8, 0x2C, 0x63, 0x16, 0x01, 0x3F, 0x58, 0xE2, 0x89, 0xA9, 0x0D, 0x38, 0x34, 0x1B, 0xAB, 0x33, 0xFF, 0xB0, 0xBB, 0x48, 0x0C, 0x5F, 0xB9, 0xB1, 0xCD, 0x2E, 0xC5, 0xF3, 0xDB, 0x47, 0xE5, 0xA5, 0x9C, 0x77, 0x0A, 0xA6, 0x20, 0x68, 0xFE, 0x7F, 0xC1, 0xAD, 0xD9, 0x78, 0xF9, 0xC4, 0x19, 0xDD, 0xB5, 0xED, 0x28, 0xE9, 0xFD, 0x79, 0x4A, 0xA0, 0xD8, 0x9D, 0xC6, 0x7E, 0x37, 0x83, 0x2B, 0x76, 0x53, 0x8E, 0x62, 0x4C, 0x64, 0x88, 0x44, 0x8B, 0xFB, 0xA2, 0x17, 0x9A, 0x59, 0xF5, 0x87, 0xB3, 0x4F, 0x13, 0x61, 0x45, 0x6D, 0x8D, 0x09, 0x81, 0x7D, 0x32, 0xBD, 0x8F, 0x40, 0xEB, 0x86, 0xB7, 0x7B, 0x0B, 0xF0, 0x95, 0x21, 0x22, 0x5C, 0x6B, 0x4E, 0x82, 0x54, 0xD6, 0x65, 0x93, 0xCE, 0x60, 0xB2, 0x1C, 0x73, 0x56, 0xC0, 0x14, 0xA7, 0x8C, 0xF1, 0xDC, 0x12, 0x75, 0xCA, 0x1F, 0x3B, 0xBE, 0xE4, 0xD1, 0x42, 0x3D, 0xD4, 0x30, 0xA3, 0x3C, 0xB6, 0x26, 0x6F, 0xBF, 0x0E, 0xDA, 0x46, 0x69, 0x07, 0x57, 0x27, 0xF2, 0x1D, 0x9B, 0xBC, 0x94, 0x43, 0x03, 0xF8, 0x11, 0xC7, 0xF6, 0x90, 0xEF, 0x3E, 0xE7, 0x06, 0xC3, 0xD5, 0x2F, 0xC8, 0x66, 0x1E, 0xD7, 0x08, 0xE8, 0xEA, 0xDE, 0x80, 0x52, 0xEE, 0xF7, 0x84, 0xAA, 0x72, 0xAC, 0x35, 0x4D, 0x6A, 0x2A, 0x96, 0x1A, 0xD2, 0x71, 0x5A, 0x15, 0x49, 0x74, 0x4B, 0x9F, 0xD0, 0x5E, 0x04, 0x18, 0xA4, 0xEC, 0xC2, 0xE0, 0x41, 0x6E, 0x0F, 0x51, 0xCB, 0xCC, 0x24, 0x91, 0xAF, 0x50, 0xA1, 0xF4, 0x70, 0x39, 0x99, 0x7C, 0x3A, 0x85, 0x23, 0xB8, 0xB4, 0x7A, 0xFC, 0x02, 0x36, 0x5B, 0x25, 0x55, 0x97, 0x31, 0x2D, 0x5D, 0xFA, 0x98, 0xE3, 0x8A, 0x92, 0xAE, 0x05, 0xDF, 0x29, 0x10, 0x67, 0x6C, 0xBA, 0xC9, 0xD3, 0x00, 0xE6, 0xCF, 0xE1, 0x9E, 0xA8, 0x2C, 0x63, 0x16, 0x01, 0x3F, 0x58, 0xE2, 0x89, 0xA9, 0x0D, 0x38, 0x34, 0x1B, 0xAB, 0x33, 0xFF, 0xB0, 0xBB, 0x48, 0x0C, 0x5F, 0xB9, 0xB1, 0xCD, 0x2E, 0xC5, 0xF3, 0xDB, 0x47, 0xE5, 0xA5, 0x9C, 0x77, 0x0A, 0xA6, 0x20, 0x68, 0xFE, 0x7F, 0xC1, 0xAD ]; /** * Inverse key expansion randomization table. * * @see self::setKey() * @var array */ private static $invpitable = [ 0xD1, 0xDA, 0xB9, 0x6F, 0x9C, 0xC8, 0x78, 0x66, 0x80, 0x2C, 0xF8, 0x37, 0xEA, 0xE0, 0x62, 0xA4, 0xCB, 0x71, 0x50, 0x27, 0x4B, 0x95, 0xD9, 0x20, 0x9D, 0x04, 0x91, 0xE3, 0x47, 0x6A, 0x7E, 0x53, 0xFA, 0x3A, 0x3B, 0xB4, 0xA8, 0xBC, 0x5F, 0x68, 0x08, 0xCA, 0x8F, 0x14, 0xD7, 0xC0, 0xEF, 0x7B, 0x5B, 0xBF, 0x2F, 0xE5, 0xE2, 0x8C, 0xBA, 0x12, 0xE1, 0xAF, 0xB2, 0x54, 0x5D, 0x59, 0x76, 0xDB, 0x32, 0xA2, 0x58, 0x6E, 0x1C, 0x29, 0x64, 0xF3, 0xE9, 0x96, 0x0C, 0x98, 0x19, 0x8D, 0x3E, 0x26, 0xAB, 0xA5, 0x85, 0x16, 0x40, 0xBD, 0x49, 0x67, 0xDC, 0x22, 0x94, 0xBB, 0x3C, 0xC1, 0x9B, 0xEB, 0x45, 0x28, 0x18, 0xD8, 0x1A, 0x42, 0x7D, 0xCC, 0xFB, 0x65, 0x8E, 0x3D, 0xCD, 0x2A, 0xA3, 0x60, 0xAE, 0x93, 0x8A, 0x48, 0x97, 0x51, 0x15, 0xF7, 0x01, 0x0B, 0xB7, 0x36, 0xB1, 0x2E, 0x11, 0xFD, 0x84, 0x2D, 0x3F, 0x13, 0x88, 0xB3, 0x34, 0x24, 0x1B, 0xDE, 0xC5, 0x1D, 0x4D, 0x2B, 0x17, 0x31, 0x74, 0xA9, 0xC6, 0x43, 0x6D, 0x39, 0x90, 0xBE, 0xC3, 0xB0, 0x21, 0x6B, 0xF6, 0x0F, 0xD5, 0x99, 0x0D, 0xAC, 0x1F, 0x5C, 0x9E, 0xF5, 0xF9, 0x4C, 0xD6, 0xDF, 0x89, 0xE4, 0x8B, 0xFF, 0xC7, 0xAA, 0xE7, 0xED, 0x46, 0x25, 0xB6, 0x06, 0x5E, 0x35, 0xB5, 0xEC, 0xCE, 0xE8, 0x6C, 0x30, 0x55, 0x61, 0x4A, 0xFE, 0xA0, 0x79, 0x03, 0xF0, 0x10, 0x72, 0x7C, 0xCF, 0x52, 0xA6, 0xA7, 0xEE, 0x44, 0xD3, 0x9A, 0x57, 0x92, 0xD0, 0x5A, 0x7A, 0x41, 0x7F, 0x0E, 0x00, 0x63, 0xF2, 0x4F, 0x05, 0x83, 0xC9, 0xA1, 0xD4, 0xDD, 0xC4, 0x56, 0xF4, 0xD2, 0x77, 0x81, 0x09, 0x82, 0x33, 0x9F, 0x07, 0x86, 0x75, 0x38, 0x4E, 0x69, 0xF1, 0xAD, 0x23, 0x73, 0x87, 0x70, 0x02, 0xC2, 0x1E, 0xB8, 0x0A, 0xFC, 0xE6 ]; /** * Default Constructor. * * @param string $mode * @throws \InvalidArgumentException if an invalid / unsupported mode is provided */ public function __construct($mode) { parent::__construct($mode); if ($this->mode == self::MODE_STREAM) { throw new BadModeException('Block ciphers cannot be ran in stream mode'); } } /** * Test for engine validity * * This is mainly just a wrapper to set things up for \phpseclib3\Crypt\Common\SymmetricKey::isValidEngine() * * @see \phpseclib3\Crypt\Common\SymmetricKey::__construct() * @param int $engine * @return bool */ protected function isValidEngineHelper($engine) { switch ($engine) { case self::ENGINE_OPENSSL: if ($this->current_key_length != 128 || strlen($this->orig_key) < 16) { return false; } // quoting https://www.openssl.org/news/openssl-3.0-notes.html, OpenSSL 3.0.1 // "Moved all variations of the EVP ciphers CAST5, BF, IDEA, SEED, RC2, RC4, RC5, and DES to the legacy provider" // in theory openssl_get_cipher_methods() should catch this but, on GitHub Actions, at least, it does not if (version_compare(preg_replace('#OpenSSL (\d+\.\d+\.\d+) .*#', '$1', OPENSSL_VERSION_TEXT), '3.0.1', '>=')) { return false; } $this->cipher_name_openssl_ecb = 'rc2-ecb'; $this->cipher_name_openssl = 'rc2-' . $this->openssl_translate_mode(); } return parent::isValidEngineHelper($engine); } /** * Sets the key length. * * Valid key lengths are 8 to 1024. * Calling this function after setting the key has no effect until the next * \phpseclib3\Crypt\RC2::setKey() call. * * @param int $length in bits * @throws \LengthException if the key length isn't supported */ public function setKeyLength($length) { if ($length < 8 || $length > 1024) { throw new \LengthException('Key size of ' . $length . ' bits is not supported by this algorithm. Only keys between 1 and 1024 bits, inclusive, are supported'); } $this->default_key_length = $this->current_key_length = $length; $this->explicit_key_length = $length >> 3; } /** * Returns the current key length * * @return int */ public function getKeyLength() { return $this->current_key_length; } /** * Sets the key. * * Keys can be of any length. RC2, itself, uses 8 to 1024 bit keys (eg. * strlen($key) <= 128), however, we only use the first 128 bytes if $key * has more then 128 bytes in it, and set $key to a single null byte if * it is empty. * * @see \phpseclib3\Crypt\Common\SymmetricKey::setKey() * @param string $key * @param int|boolean $t1 optional Effective key length in bits. * @throws \LengthException if the key length isn't supported */ public function setKey($key, $t1 = false) { $this->orig_key = $key; if ($t1 === false) { $t1 = $this->default_key_length; } if ($t1 < 1 || $t1 > 1024) { throw new \LengthException('Key size of ' . $length . ' bits is not supported by this algorithm. Only keys between 1 and 1024 bits, inclusive, are supported'); } $this->current_key_length = $t1; if (strlen($key) < 1 || strlen($key) > 128) { throw new \LengthException('Key of size ' . strlen($key) . ' not supported by this algorithm. Only keys of sizes between 8 and 1024 bits, inclusive, are supported'); } $t = strlen($key); // The mcrypt RC2 implementation only supports effective key length // of 1024 bits. It is however possible to handle effective key // lengths in range 1..1024 by expanding the key and applying // inverse pitable mapping to the first byte before submitting it // to mcrypt. // Key expansion. $l = array_values(unpack('C*', $key)); $t8 = ($t1 + 7) >> 3; $tm = 0xFF >> (8 * $t8 - $t1); // Expand key. $pitable = self::$pitable; for ($i = $t; $i < 128; $i++) { $l[$i] = $pitable[$l[$i - 1] + $l[$i - $t]]; } $i = 128 - $t8; $l[$i] = $pitable[$l[$i] & $tm]; while ($i--) { $l[$i] = $pitable[$l[$i + 1] ^ $l[$i + $t8]]; } // Prepare the key for mcrypt. $l[0] = self::$invpitable[$l[0]]; array_unshift($l, 'C*'); $this->key = pack(...$l); $this->key_length = strlen($this->key); $this->changed = $this->nonIVChanged = true; $this->setEngine(); } /** * Encrypts a message. * * Mostly a wrapper for \phpseclib3\Crypt\Common\SymmetricKey::encrypt, with some additional OpenSSL handling code * * @see self::decrypt() * @param string $plaintext * @return string $ciphertext */ public function encrypt($plaintext) { if ($this->engine == self::ENGINE_OPENSSL) { $temp = $this->key; $this->key = $this->orig_key; $result = parent::encrypt($plaintext); $this->key = $temp; return $result; } return parent::encrypt($plaintext); } /** * Decrypts a message. * * Mostly a wrapper for \phpseclib3\Crypt\Common\SymmetricKey::decrypt, with some additional OpenSSL handling code * * @see self::encrypt() * @param string $ciphertext * @return string $plaintext */ public function decrypt($ciphertext) { if ($this->engine == self::ENGINE_OPENSSL) { $temp = $this->key; $this->key = $this->orig_key; $result = parent::decrypt($ciphertext); $this->key = $temp; return $result; } return parent::decrypt($ciphertext); } /** * Encrypts a block * * @see \phpseclib3\Crypt\Common\SymmetricKey::encryptBlock() * @see \phpseclib3\Crypt\Common\SymmetricKey::encrypt() * @param string $in * @return string */ protected function encryptBlock($in) { list($r0, $r1, $r2, $r3) = array_values(unpack('v*', $in)); $keys = $this->keys; $limit = 20; $actions = [$limit => 44, 44 => 64]; $j = 0; for (;;) { // Mixing round. $r0 = (($r0 + $keys[$j++] + ((($r1 ^ $r2) & $r3) ^ $r1)) & 0xFFFF) << 1; $r0 |= $r0 >> 16; $r1 = (($r1 + $keys[$j++] + ((($r2 ^ $r3) & $r0) ^ $r2)) & 0xFFFF) << 2; $r1 |= $r1 >> 16; $r2 = (($r2 + $keys[$j++] + ((($r3 ^ $r0) & $r1) ^ $r3)) & 0xFFFF) << 3; $r2 |= $r2 >> 16; $r3 = (($r3 + $keys[$j++] + ((($r0 ^ $r1) & $r2) ^ $r0)) & 0xFFFF) << 5; $r3 |= $r3 >> 16; if ($j === $limit) { if ($limit === 64) { break; } // Mashing round. $r0 += $keys[$r3 & 0x3F]; $r1 += $keys[$r0 & 0x3F]; $r2 += $keys[$r1 & 0x3F]; $r3 += $keys[$r2 & 0x3F]; $limit = $actions[$limit]; } } return pack('vvvv', $r0, $r1, $r2, $r3); } /** * Decrypts a block * * @see \phpseclib3\Crypt\Common\SymmetricKey::decryptBlock() * @see \phpseclib3\Crypt\Common\SymmetricKey::decrypt() * @param string $in * @return string */ protected function decryptBlock($in) { list($r0, $r1, $r2, $r3) = array_values(unpack('v*', $in)); $keys = $this->keys; $limit = 44; $actions = [$limit => 20, 20 => 0]; $j = 64; for (;;) { // R-mixing round. $r3 = ($r3 | ($r3 << 16)) >> 5; $r3 = ($r3 - $keys[--$j] - ((($r0 ^ $r1) & $r2) ^ $r0)) & 0xFFFF; $r2 = ($r2 | ($r2 << 16)) >> 3; $r2 = ($r2 - $keys[--$j] - ((($r3 ^ $r0) & $r1) ^ $r3)) & 0xFFFF; $r1 = ($r1 | ($r1 << 16)) >> 2; $r1 = ($r1 - $keys[--$j] - ((($r2 ^ $r3) & $r0) ^ $r2)) & 0xFFFF; $r0 = ($r0 | ($r0 << 16)) >> 1; $r0 = ($r0 - $keys[--$j] - ((($r1 ^ $r2) & $r3) ^ $r1)) & 0xFFFF; if ($j === $limit) { if ($limit === 0) { break; } // R-mashing round. $r3 = ($r3 - $keys[$r2 & 0x3F]) & 0xFFFF; $r2 = ($r2 - $keys[$r1 & 0x3F]) & 0xFFFF; $r1 = ($r1 - $keys[$r0 & 0x3F]) & 0xFFFF; $r0 = ($r0 - $keys[$r3 & 0x3F]) & 0xFFFF; $limit = $actions[$limit]; } } return pack('vvvv', $r0, $r1, $r2, $r3); } /** * Creates the key schedule * * @see \phpseclib3\Crypt\Common\SymmetricKey::setupKey() */ protected function setupKey() { if (!isset($this->key)) { $this->setKey(''); } // Key has already been expanded in \phpseclib3\Crypt\RC2::setKey(): // Only the first value must be altered. $l = unpack('Ca/Cb/v*', $this->key); array_unshift($l, self::$pitable[$l['a']] | ($l['b'] << 8)); unset($l['a']); unset($l['b']); $this->keys = $l; } /** * Setup the performance-optimized function for de/encrypt() * * @see \phpseclib3\Crypt\Common\SymmetricKey::setupInlineCrypt() */ protected function setupInlineCrypt() { // Init code for both, encrypt and decrypt. $init_crypt = '$keys = $this->keys;'; $keys = $this->keys; // $in is the current 8 bytes block which has to be en/decrypt $encrypt_block = $decrypt_block = ' $in = unpack("v4", $in); $r0 = $in[1]; $r1 = $in[2]; $r2 = $in[3]; $r3 = $in[4]; '; // Create code for encryption. $limit = 20; $actions = [$limit => 44, 44 => 64]; $j = 0; for (;;) { // Mixing round. $encrypt_block .= ' $r0 = (($r0 + ' . $keys[$j++] . ' + ((($r1 ^ $r2) & $r3) ^ $r1)) & 0xFFFF) << 1; $r0 |= $r0 >> 16; $r1 = (($r1 + ' . $keys[$j++] . ' + ((($r2 ^ $r3) & $r0) ^ $r2)) & 0xFFFF) << 2; $r1 |= $r1 >> 16; $r2 = (($r2 + ' . $keys[$j++] . ' + ((($r3 ^ $r0) & $r1) ^ $r3)) & 0xFFFF) << 3; $r2 |= $r2 >> 16; $r3 = (($r3 + ' . $keys[$j++] . ' + ((($r0 ^ $r1) & $r2) ^ $r0)) & 0xFFFF) << 5; $r3 |= $r3 >> 16;'; if ($j === $limit) { if ($limit === 64) { break; } // Mashing round. $encrypt_block .= ' $r0 += $keys[$r3 & 0x3F]; $r1 += $keys[$r0 & 0x3F]; $r2 += $keys[$r1 & 0x3F]; $r3 += $keys[$r2 & 0x3F];'; $limit = $actions[$limit]; } } $encrypt_block .= '$in = pack("v4", $r0, $r1, $r2, $r3);'; // Create code for decryption. $limit = 44; $actions = [$limit => 20, 20 => 0]; $j = 64; for (;;) { // R-mixing round. $decrypt_block .= ' $r3 = ($r3 | ($r3 << 16)) >> 5; $r3 = ($r3 - ' . $keys[--$j] . ' - ((($r0 ^ $r1) & $r2) ^ $r0)) & 0xFFFF; $r2 = ($r2 | ($r2 << 16)) >> 3; $r2 = ($r2 - ' . $keys[--$j] . ' - ((($r3 ^ $r0) & $r1) ^ $r3)) & 0xFFFF; $r1 = ($r1 | ($r1 << 16)) >> 2; $r1 = ($r1 - ' . $keys[--$j] . ' - ((($r2 ^ $r3) & $r0) ^ $r2)) & 0xFFFF; $r0 = ($r0 | ($r0 << 16)) >> 1; $r0 = ($r0 - ' . $keys[--$j] . ' - ((($r1 ^ $r2) & $r3) ^ $r1)) & 0xFFFF;'; if ($j === $limit) { if ($limit === 0) { break; } // R-mashing round. $decrypt_block .= ' $r3 = ($r3 - $keys[$r2 & 0x3F]) & 0xFFFF; $r2 = ($r2 - $keys[$r1 & 0x3F]) & 0xFFFF; $r1 = ($r1 - $keys[$r0 & 0x3F]) & 0xFFFF; $r0 = ($r0 - $keys[$r3 & 0x3F]) & 0xFFFF;'; $limit = $actions[$limit]; } } $decrypt_block .= '$in = pack("v4", $r0, $r1, $r2, $r3);'; // Creates the inline-crypt function $this->inline_crypt = $this->createInlineCryptFunction( [ 'init_crypt' => $init_crypt, 'encrypt_block' => $encrypt_block, 'decrypt_block' => $decrypt_block ] ); } } unpack('N*', $x), $blocks); it jumps up by an additional * ~90MB, yielding a 106x increase in memory usage. Consequently, it bcrypt calls a different * _encryptBlock() then the regular Blowfish does. That said, the Blowfish _encryptBlock() is * basically just a thin wrapper around the bcrypt _encryptBlock(), so there's that. * * This explains 3 of the 4 _encryptBlock() implementations. the last _encryptBlock() * implementation can best be understood by doing Ctrl + F and searching for where * self::$use_reg_intval is defined. * * # phpseclib's three different _setupKey() implementations * * Every bcrypt round is the equivalent of encrypting 512KB of data. Since OpenSSH uses 16 * rounds by default that's ~8MB of data that's essentially being encrypted whenever * you use bcrypt. That's a lot of data, however, bcrypt operates within tighter constraints * than regular Blowfish, so we can use that to our advantage. In particular, whereas Blowfish * supports variable length keys, in bcrypt, the initial "key" is the sha512 hash of the * password. sha512 hashes are 512 bits or 64 bytes long and thus the bcrypt keys are of a * fixed length whereas Blowfish keys are not of a fixed length. * * bcrypt actually has two different key expansion steps. The first one (expandstate) is * constantly XOR'ing every _encryptBlock() parameter against the salt prior _encryptBlock()'s * being called. The second one (expand0state) is more similar to Blowfish's _setupKey() * but it can still use the fixed length key optimization discussed above and can do away with * the pack() / unpack() calls. * * I suppose _setupKey() could be made to be a thin wrapper around expandstate() but idk it's * just a lot of work for very marginal benefits as _setupKey() is only called once for * regular Blowfish vs the 128 times it's called --per round-- with bcrypt. * * # blowfish + bcrypt in the same class * * Altho there's a lot of Blowfish code that bcrypt doesn't re-use, bcrypt does re-use the * initial S-boxes, the initial P-array and the int-only _encryptBlock() implementation. * * # Credit * * phpseclib's bcrypt implementation is based losely off of OpenSSH's implementation: * * https://github.com/openssh/openssh-portable/blob/master/openbsd-compat/bcrypt_pbkdf.c * * Here's a short example of how to use this library: * * setKey('12345678901234567890123456789012'); * * $plaintext = str_repeat('a', 1024); * * echo $blowfish->decrypt($blowfish->encrypt($plaintext)); * ?> * * * @author Jim Wigginton * @author Hans-Juergen Petrich * @copyright 2007 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt; use phpseclib3\Crypt\Common\BlockCipher; /** * Pure-PHP implementation of Blowfish. * * @author Jim Wigginton * @author Hans-Juergen Petrich */ class Blowfish extends BlockCipher { /** * Block Length of the cipher * * @see \phpseclib3\Crypt\Common\SymmetricKey::block_size * @var int */ protected $block_size = 8; /** * The mcrypt specific name of the cipher * * @see \phpseclib3\Crypt\Common\SymmetricKey::cipher_name_mcrypt * @var string */ protected $cipher_name_mcrypt = 'blowfish'; /** * Optimizing value while CFB-encrypting * * @see \phpseclib3\Crypt\Common\SymmetricKey::cfb_init_len * @var int */ protected $cfb_init_len = 500; /** * The fixed subkeys boxes ($sbox0 - $sbox3) with 256 entries each * * S-Box 0 * * @var array */ private static $sbox0 = [ 0xd1310ba6, 0x98dfb5ac, 0x2ffd72db, 0xd01adfb7, 0xb8e1afed, 0x6a267e96, 0xba7c9045, 0xf12c7f99, 0x24a19947, 0xb3916cf7, 0x0801f2e2, 0x858efc16, 0x636920d8, 0x71574e69, 0xa458fea3, 0xf4933d7e, 0x0d95748f, 0x728eb658, 0x718bcd58, 0x82154aee, 0x7b54a41d, 0xc25a59b5, 0x9c30d539, 0x2af26013, 0xc5d1b023, 0x286085f0, 0xca417918, 0xb8db38ef, 0x8e79dcb0, 0x603a180e, 0x6c9e0e8b, 0xb01e8a3e, 0xd71577c1, 0xbd314b27, 0x78af2fda, 0x55605c60, 0xe65525f3, 0xaa55ab94, 0x57489862, 0x63e81440, 0x55ca396a, 0x2aab10b6, 0xb4cc5c34, 0x1141e8ce, 0xa15486af, 0x7c72e993, 0xb3ee1411, 0x636fbc2a, 0x2ba9c55d, 0x741831f6, 0xce5c3e16, 0x9b87931e, 0xafd6ba33, 0x6c24cf5c, 0x7a325381, 0x28958677, 0x3b8f4898, 0x6b4bb9af, 0xc4bfe81b, 0x66282193, 0x61d809cc, 0xfb21a991, 0x487cac60, 0x5dec8032, 0xef845d5d, 0xe98575b1, 0xdc262302, 0xeb651b88, 0x23893e81, 0xd396acc5, 0x0f6d6ff3, 0x83f44239, 0x2e0b4482, 0xa4842004, 0x69c8f04a, 0x9e1f9b5e, 0x21c66842, 0xf6e96c9a, 0x670c9c61, 0xabd388f0, 0x6a51a0d2, 0xd8542f68, 0x960fa728, 0xab5133a3, 0x6eef0b6c, 0x137a3be4, 0xba3bf050, 0x7efb2a98, 0xa1f1651d, 0x39af0176, 0x66ca593e, 0x82430e88, 0x8cee8619, 0x456f9fb4, 0x7d84a5c3, 0x3b8b5ebe, 0xe06f75d8, 0x85c12073, 0x401a449f, 0x56c16aa6, 0x4ed3aa62, 0x363f7706, 0x1bfedf72, 0x429b023d, 0x37d0d724, 0xd00a1248, 0xdb0fead3, 0x49f1c09b, 0x075372c9, 0x80991b7b, 0x25d479d8, 0xf6e8def7, 0xe3fe501a, 0xb6794c3b, 0x976ce0bd, 0x04c006ba, 0xc1a94fb6, 0x409f60c4, 0x5e5c9ec2, 0x196a2463, 0x68fb6faf, 0x3e6c53b5, 0x1339b2eb, 0x3b52ec6f, 0x6dfc511f, 0x9b30952c, 0xcc814544, 0xaf5ebd09, 0xbee3d004, 0xde334afd, 0x660f2807, 0x192e4bb3, 0xc0cba857, 0x45c8740f, 0xd20b5f39, 0xb9d3fbdb, 0x5579c0bd, 0x1a60320a, 0xd6a100c6, 0x402c7279, 0x679f25fe, 0xfb1fa3cc, 0x8ea5e9f8, 0xdb3222f8, 0x3c7516df, 0xfd616b15, 0x2f501ec8, 0xad0552ab, 0x323db5fa, 0xfd238760, 0x53317b48, 0x3e00df82, 0x9e5c57bb, 0xca6f8ca0, 0x1a87562e, 0xdf1769db, 0xd542a8f6, 0x287effc3, 0xac6732c6, 0x8c4f5573, 0x695b27b0, 0xbbca58c8, 0xe1ffa35d, 0xb8f011a0, 0x10fa3d98, 0xfd2183b8, 0x4afcb56c, 0x2dd1d35b, 0x9a53e479, 0xb6f84565, 0xd28e49bc, 0x4bfb9790, 0xe1ddf2da, 0xa4cb7e33, 0x62fb1341, 0xcee4c6e8, 0xef20cada, 0x36774c01, 0xd07e9efe, 0x2bf11fb4, 0x95dbda4d, 0xae909198, 0xeaad8e71, 0x6b93d5a0, 0xd08ed1d0, 0xafc725e0, 0x8e3c5b2f, 0x8e7594b7, 0x8ff6e2fb, 0xf2122b64, 0x8888b812, 0x900df01c, 0x4fad5ea0, 0x688fc31c, 0xd1cff191, 0xb3a8c1ad, 0x2f2f2218, 0xbe0e1777, 0xea752dfe, 0x8b021fa1, 0xe5a0cc0f, 0xb56f74e8, 0x18acf3d6, 0xce89e299, 0xb4a84fe0, 0xfd13e0b7, 0x7cc43b81, 0xd2ada8d9, 0x165fa266, 0x80957705, 0x93cc7314, 0x211a1477, 0xe6ad2065, 0x77b5fa86, 0xc75442f5, 0xfb9d35cf, 0xebcdaf0c, 0x7b3e89a0, 0xd6411bd3, 0xae1e7e49, 0x00250e2d, 0x2071b35e, 0x226800bb, 0x57b8e0af, 0x2464369b, 0xf009b91e, 0x5563911d, 0x59dfa6aa, 0x78c14389, 0xd95a537f, 0x207d5ba2, 0x02e5b9c5, 0x83260376, 0x6295cfa9, 0x11c81968, 0x4e734a41, 0xb3472dca, 0x7b14a94a, 0x1b510052, 0x9a532915, 0xd60f573f, 0xbc9bc6e4, 0x2b60a476, 0x81e67400, 0x08ba6fb5, 0x571be91f, 0xf296ec6b, 0x2a0dd915, 0xb6636521, 0xe7b9f9b6, 0xff34052e, 0xc5855664, 0x53b02d5d, 0xa99f8fa1, 0x08ba4799, 0x6e85076a ]; /** * S-Box 1 * * @var array */ private static $sbox1 = [ 0x4b7a70e9, 0xb5b32944, 0xdb75092e, 0xc4192623, 0xad6ea6b0, 0x49a7df7d, 0x9cee60b8, 0x8fedb266, 0xecaa8c71, 0x699a17ff, 0x5664526c, 0xc2b19ee1, 0x193602a5, 0x75094c29, 0xa0591340, 0xe4183a3e, 0x3f54989a, 0x5b429d65, 0x6b8fe4d6, 0x99f73fd6, 0xa1d29c07, 0xefe830f5, 0x4d2d38e6, 0xf0255dc1, 0x4cdd2086, 0x8470eb26, 0x6382e9c6, 0x021ecc5e, 0x09686b3f, 0x3ebaefc9, 0x3c971814, 0x6b6a70a1, 0x687f3584, 0x52a0e286, 0xb79c5305, 0xaa500737, 0x3e07841c, 0x7fdeae5c, 0x8e7d44ec, 0x5716f2b8, 0xb03ada37, 0xf0500c0d, 0xf01c1f04, 0x0200b3ff, 0xae0cf51a, 0x3cb574b2, 0x25837a58, 0xdc0921bd, 0xd19113f9, 0x7ca92ff6, 0x94324773, 0x22f54701, 0x3ae5e581, 0x37c2dadc, 0xc8b57634, 0x9af3dda7, 0xa9446146, 0x0fd0030e, 0xecc8c73e, 0xa4751e41, 0xe238cd99, 0x3bea0e2f, 0x3280bba1, 0x183eb331, 0x4e548b38, 0x4f6db908, 0x6f420d03, 0xf60a04bf, 0x2cb81290, 0x24977c79, 0x5679b072, 0xbcaf89af, 0xde9a771f, 0xd9930810, 0xb38bae12, 0xdccf3f2e, 0x5512721f, 0x2e6b7124, 0x501adde6, 0x9f84cd87, 0x7a584718, 0x7408da17, 0xbc9f9abc, 0xe94b7d8c, 0xec7aec3a, 0xdb851dfa, 0x63094366, 0xc464c3d2, 0xef1c1847, 0x3215d908, 0xdd433b37, 0x24c2ba16, 0x12a14d43, 0x2a65c451, 0x50940002, 0x133ae4dd, 0x71dff89e, 0x10314e55, 0x81ac77d6, 0x5f11199b, 0x043556f1, 0xd7a3c76b, 0x3c11183b, 0x5924a509, 0xf28fe6ed, 0x97f1fbfa, 0x9ebabf2c, 0x1e153c6e, 0x86e34570, 0xeae96fb1, 0x860e5e0a, 0x5a3e2ab3, 0x771fe71c, 0x4e3d06fa, 0x2965dcb9, 0x99e71d0f, 0x803e89d6, 0x5266c825, 0x2e4cc978, 0x9c10b36a, 0xc6150eba, 0x94e2ea78, 0xa5fc3c53, 0x1e0a2df4, 0xf2f74ea7, 0x361d2b3d, 0x1939260f, 0x19c27960, 0x5223a708, 0xf71312b6, 0xebadfe6e, 0xeac31f66, 0xe3bc4595, 0xa67bc883, 0xb17f37d1, 0x018cff28, 0xc332ddef, 0xbe6c5aa5, 0x65582185, 0x68ab9802, 0xeecea50f, 0xdb2f953b, 0x2aef7dad, 0x5b6e2f84, 0x1521b628, 0x29076170, 0xecdd4775, 0x619f1510, 0x13cca830, 0xeb61bd96, 0x0334fe1e, 0xaa0363cf, 0xb5735c90, 0x4c70a239, 0xd59e9e0b, 0xcbaade14, 0xeecc86bc, 0x60622ca7, 0x9cab5cab, 0xb2f3846e, 0x648b1eaf, 0x19bdf0ca, 0xa02369b9, 0x655abb50, 0x40685a32, 0x3c2ab4b3, 0x319ee9d5, 0xc021b8f7, 0x9b540b19, 0x875fa099, 0x95f7997e, 0x623d7da8, 0xf837889a, 0x97e32d77, 0x11ed935f, 0x16681281, 0x0e358829, 0xc7e61fd6, 0x96dedfa1, 0x7858ba99, 0x57f584a5, 0x1b227263, 0x9b83c3ff, 0x1ac24696, 0xcdb30aeb, 0x532e3054, 0x8fd948e4, 0x6dbc3128, 0x58ebf2ef, 0x34c6ffea, 0xfe28ed61, 0xee7c3c73, 0x5d4a14d9, 0xe864b7e3, 0x42105d14, 0x203e13e0, 0x45eee2b6, 0xa3aaabea, 0xdb6c4f15, 0xfacb4fd0, 0xc742f442, 0xef6abbb5, 0x654f3b1d, 0x41cd2105, 0xd81e799e, 0x86854dc7, 0xe44b476a, 0x3d816250, 0xcf62a1f2, 0x5b8d2646, 0xfc8883a0, 0xc1c7b6a3, 0x7f1524c3, 0x69cb7492, 0x47848a0b, 0x5692b285, 0x095bbf00, 0xad19489d, 0x1462b174, 0x23820e00, 0x58428d2a, 0x0c55f5ea, 0x1dadf43e, 0x233f7061, 0x3372f092, 0x8d937e41, 0xd65fecf1, 0x6c223bdb, 0x7cde3759, 0xcbee7460, 0x4085f2a7, 0xce77326e, 0xa6078084, 0x19f8509e, 0xe8efd855, 0x61d99735, 0xa969a7aa, 0xc50c06c2, 0x5a04abfc, 0x800bcadc, 0x9e447a2e, 0xc3453484, 0xfdd56705, 0x0e1e9ec9, 0xdb73dbd3, 0x105588cd, 0x675fda79, 0xe3674340, 0xc5c43465, 0x713e38d8, 0x3d28f89e, 0xf16dff20, 0x153e21e7, 0x8fb03d4a, 0xe6e39f2b, 0xdb83adf7 ]; /** * S-Box 2 * * @var array */ private static $sbox2 = [ 0xe93d5a68, 0x948140f7, 0xf64c261c, 0x94692934, 0x411520f7, 0x7602d4f7, 0xbcf46b2e, 0xd4a20068, 0xd4082471, 0x3320f46a, 0x43b7d4b7, 0x500061af, 0x1e39f62e, 0x97244546, 0x14214f74, 0xbf8b8840, 0x4d95fc1d, 0x96b591af, 0x70f4ddd3, 0x66a02f45, 0xbfbc09ec, 0x03bd9785, 0x7fac6dd0, 0x31cb8504, 0x96eb27b3, 0x55fd3941, 0xda2547e6, 0xabca0a9a, 0x28507825, 0x530429f4, 0x0a2c86da, 0xe9b66dfb, 0x68dc1462, 0xd7486900, 0x680ec0a4, 0x27a18dee, 0x4f3ffea2, 0xe887ad8c, 0xb58ce006, 0x7af4d6b6, 0xaace1e7c, 0xd3375fec, 0xce78a399, 0x406b2a42, 0x20fe9e35, 0xd9f385b9, 0xee39d7ab, 0x3b124e8b, 0x1dc9faf7, 0x4b6d1856, 0x26a36631, 0xeae397b2, 0x3a6efa74, 0xdd5b4332, 0x6841e7f7, 0xca7820fb, 0xfb0af54e, 0xd8feb397, 0x454056ac, 0xba489527, 0x55533a3a, 0x20838d87, 0xfe6ba9b7, 0xd096954b, 0x55a867bc, 0xa1159a58, 0xcca92963, 0x99e1db33, 0xa62a4a56, 0x3f3125f9, 0x5ef47e1c, 0x9029317c, 0xfdf8e802, 0x04272f70, 0x80bb155c, 0x05282ce3, 0x95c11548, 0xe4c66d22, 0x48c1133f, 0xc70f86dc, 0x07f9c9ee, 0x41041f0f, 0x404779a4, 0x5d886e17, 0x325f51eb, 0xd59bc0d1, 0xf2bcc18f, 0x41113564, 0x257b7834, 0x602a9c60, 0xdff8e8a3, 0x1f636c1b, 0x0e12b4c2, 0x02e1329e, 0xaf664fd1, 0xcad18115, 0x6b2395e0, 0x333e92e1, 0x3b240b62, 0xeebeb922, 0x85b2a20e, 0xe6ba0d99, 0xde720c8c, 0x2da2f728, 0xd0127845, 0x95b794fd, 0x647d0862, 0xe7ccf5f0, 0x5449a36f, 0x877d48fa, 0xc39dfd27, 0xf33e8d1e, 0x0a476341, 0x992eff74, 0x3a6f6eab, 0xf4f8fd37, 0xa812dc60, 0xa1ebddf8, 0x991be14c, 0xdb6e6b0d, 0xc67b5510, 0x6d672c37, 0x2765d43b, 0xdcd0e804, 0xf1290dc7, 0xcc00ffa3, 0xb5390f92, 0x690fed0b, 0x667b9ffb, 0xcedb7d9c, 0xa091cf0b, 0xd9155ea3, 0xbb132f88, 0x515bad24, 0x7b9479bf, 0x763bd6eb, 0x37392eb3, 0xcc115979, 0x8026e297, 0xf42e312d, 0x6842ada7, 0xc66a2b3b, 0x12754ccc, 0x782ef11c, 0x6a124237, 0xb79251e7, 0x06a1bbe6, 0x4bfb6350, 0x1a6b1018, 0x11caedfa, 0x3d25bdd8, 0xe2e1c3c9, 0x44421659, 0x0a121386, 0xd90cec6e, 0xd5abea2a, 0x64af674e, 0xda86a85f, 0xbebfe988, 0x64e4c3fe, 0x9dbc8057, 0xf0f7c086, 0x60787bf8, 0x6003604d, 0xd1fd8346, 0xf6381fb0, 0x7745ae04, 0xd736fccc, 0x83426b33, 0xf01eab71, 0xb0804187, 0x3c005e5f, 0x77a057be, 0xbde8ae24, 0x55464299, 0xbf582e61, 0x4e58f48f, 0xf2ddfda2, 0xf474ef38, 0x8789bdc2, 0x5366f9c3, 0xc8b38e74, 0xb475f255, 0x46fcd9b9, 0x7aeb2661, 0x8b1ddf84, 0x846a0e79, 0x915f95e2, 0x466e598e, 0x20b45770, 0x8cd55591, 0xc902de4c, 0xb90bace1, 0xbb8205d0, 0x11a86248, 0x7574a99e, 0xb77f19b6, 0xe0a9dc09, 0x662d09a1, 0xc4324633, 0xe85a1f02, 0x09f0be8c, 0x4a99a025, 0x1d6efe10, 0x1ab93d1d, 0x0ba5a4df, 0xa186f20f, 0x2868f169, 0xdcb7da83, 0x573906fe, 0xa1e2ce9b, 0x4fcd7f52, 0x50115e01, 0xa70683fa, 0xa002b5c4, 0x0de6d027, 0x9af88c27, 0x773f8641, 0xc3604c06, 0x61a806b5, 0xf0177a28, 0xc0f586e0, 0x006058aa, 0x30dc7d62, 0x11e69ed7, 0x2338ea63, 0x53c2dd94, 0xc2c21634, 0xbbcbee56, 0x90bcb6de, 0xebfc7da1, 0xce591d76, 0x6f05e409, 0x4b7c0188, 0x39720a3d, 0x7c927c24, 0x86e3725f, 0x724d9db9, 0x1ac15bb4, 0xd39eb8fc, 0xed545578, 0x08fca5b5, 0xd83d7cd3, 0x4dad0fc4, 0x1e50ef5e, 0xb161e6f8, 0xa28514d9, 0x6c51133c, 0x6fd5c7e7, 0x56e14ec4, 0x362abfce, 0xddc6c837, 0xd79a3234, 0x92638212, 0x670efa8e, 0x406000e0 ]; /** * S-Box 3 * * @var array */ private static $sbox3 = [ 0x3a39ce37, 0xd3faf5cf, 0xabc27737, 0x5ac52d1b, 0x5cb0679e, 0x4fa33742, 0xd3822740, 0x99bc9bbe, 0xd5118e9d, 0xbf0f7315, 0xd62d1c7e, 0xc700c47b, 0xb78c1b6b, 0x21a19045, 0xb26eb1be, 0x6a366eb4, 0x5748ab2f, 0xbc946e79, 0xc6a376d2, 0x6549c2c8, 0x530ff8ee, 0x468dde7d, 0xd5730a1d, 0x4cd04dc6, 0x2939bbdb, 0xa9ba4650, 0xac9526e8, 0xbe5ee304, 0xa1fad5f0, 0x6a2d519a, 0x63ef8ce2, 0x9a86ee22, 0xc089c2b8, 0x43242ef6, 0xa51e03aa, 0x9cf2d0a4, 0x83c061ba, 0x9be96a4d, 0x8fe51550, 0xba645bd6, 0x2826a2f9, 0xa73a3ae1, 0x4ba99586, 0xef5562e9, 0xc72fefd3, 0xf752f7da, 0x3f046f69, 0x77fa0a59, 0x80e4a915, 0x87b08601, 0x9b09e6ad, 0x3b3ee593, 0xe990fd5a, 0x9e34d797, 0x2cf0b7d9, 0x022b8b51, 0x96d5ac3a, 0x017da67d, 0xd1cf3ed6, 0x7c7d2d28, 0x1f9f25cf, 0xadf2b89b, 0x5ad6b472, 0x5a88f54c, 0xe029ac71, 0xe019a5e6, 0x47b0acfd, 0xed93fa9b, 0xe8d3c48d, 0x283b57cc, 0xf8d56629, 0x79132e28, 0x785f0191, 0xed756055, 0xf7960e44, 0xe3d35e8c, 0x15056dd4, 0x88f46dba, 0x03a16125, 0x0564f0bd, 0xc3eb9e15, 0x3c9057a2, 0x97271aec, 0xa93a072a, 0x1b3f6d9b, 0x1e6321f5, 0xf59c66fb, 0x26dcf319, 0x7533d928, 0xb155fdf5, 0x03563482, 0x8aba3cbb, 0x28517711, 0xc20ad9f8, 0xabcc5167, 0xccad925f, 0x4de81751, 0x3830dc8e, 0x379d5862, 0x9320f991, 0xea7a90c2, 0xfb3e7bce, 0x5121ce64, 0x774fbe32, 0xa8b6e37e, 0xc3293d46, 0x48de5369, 0x6413e680, 0xa2ae0810, 0xdd6db224, 0x69852dfd, 0x09072166, 0xb39a460a, 0x6445c0dd, 0x586cdecf, 0x1c20c8ae, 0x5bbef7dd, 0x1b588d40, 0xccd2017f, 0x6bb4e3bb, 0xdda26a7e, 0x3a59ff45, 0x3e350a44, 0xbcb4cdd5, 0x72eacea8, 0xfa6484bb, 0x8d6612ae, 0xbf3c6f47, 0xd29be463, 0x542f5d9e, 0xaec2771b, 0xf64e6370, 0x740e0d8d, 0xe75b1357, 0xf8721671, 0xaf537d5d, 0x4040cb08, 0x4eb4e2cc, 0x34d2466a, 0x0115af84, 0xe1b00428, 0x95983a1d, 0x06b89fb4, 0xce6ea048, 0x6f3f3b82, 0x3520ab82, 0x011a1d4b, 0x277227f8, 0x611560b1, 0xe7933fdc, 0xbb3a792b, 0x344525bd, 0xa08839e1, 0x51ce794b, 0x2f32c9b7, 0xa01fbac9, 0xe01cc87e, 0xbcc7d1f6, 0xcf0111c3, 0xa1e8aac7, 0x1a908749, 0xd44fbd9a, 0xd0dadecb, 0xd50ada38, 0x0339c32a, 0xc6913667, 0x8df9317c, 0xe0b12b4f, 0xf79e59b7, 0x43f5bb3a, 0xf2d519ff, 0x27d9459c, 0xbf97222c, 0x15e6fc2a, 0x0f91fc71, 0x9b941525, 0xfae59361, 0xceb69ceb, 0xc2a86459, 0x12baa8d1, 0xb6c1075e, 0xe3056a0c, 0x10d25065, 0xcb03a442, 0xe0ec6e0e, 0x1698db3b, 0x4c98a0be, 0x3278e964, 0x9f1f9532, 0xe0d392df, 0xd3a0342b, 0x8971f21e, 0x1b0a7441, 0x4ba3348c, 0xc5be7120, 0xc37632d8, 0xdf359f8d, 0x9b992f2e, 0xe60b6f47, 0x0fe3f11d, 0xe54cda54, 0x1edad891, 0xce6279cf, 0xcd3e7e6f, 0x1618b166, 0xfd2c1d05, 0x848fd2c5, 0xf6fb2299, 0xf523f357, 0xa6327623, 0x93a83531, 0x56cccd02, 0xacf08162, 0x5a75ebb5, 0x6e163697, 0x88d273cc, 0xde966292, 0x81b949d0, 0x4c50901b, 0x71c65614, 0xe6c6c7bd, 0x327a140a, 0x45e1d006, 0xc3f27b9a, 0xc9aa53fd, 0x62a80f00, 0xbb25bfe2, 0x35bdd2f6, 0x71126905, 0xb2040222, 0xb6cbcf7c, 0xcd769c2b, 0x53113ec0, 0x1640e3d3, 0x38abbd60, 0x2547adf0, 0xba38209c, 0xf746ce76, 0x77afa1c5, 0x20756060, 0x85cbfe4e, 0x8ae88dd8, 0x7aaaf9b0, 0x4cf9aa7e, 0x1948c25c, 0x02fb8a8c, 0x01c36ae4, 0xd6ebe1f9, 0x90d4f869, 0xa65cdea0, 0x3f09252d, 0xc208e69f, 0xb74e6132, 0xce77e25b, 0x578fdfe3, 0x3ac372e6 ]; /** * P-Array consists of 18 32-bit subkeys * * @var array */ private static $parray = [ 0x243f6a88, 0x85a308d3, 0x13198a2e, 0x03707344, 0xa4093822, 0x299f31d0, 0x082efa98, 0xec4e6c89, 0x452821e6, 0x38d01377, 0xbe5466cf, 0x34e90c6c, 0xc0ac29b7, 0xc97c50dd, 0x3f84d5b5, 0xb5470917, 0x9216d5d9, 0x8979fb1b ]; /** * The BCTX-working Array * * Holds the expanded key [p] and the key-depended s-boxes [sb] * * @var array */ private $bctx; /** * Holds the last used key * * @var array */ private $kl; /** * The Key Length (in bytes) * {@internal The max value is 256 / 8 = 32, the min value is 128 / 8 = 16. Exists in conjunction with $Nk * because the encryption / decryption / key schedule creation requires this number and not $key_length. We could * derive this from $key_length or vice versa, but that'd mean we'd have to do multiple shift operations, so in lieu * of that, we'll just precompute it once.} * * @see \phpseclib3\Crypt\Common\SymmetricKey::setKeyLength() * @var int */ protected $key_length = 16; /** * Default Constructor. * * @param string $mode * @throws \InvalidArgumentException if an invalid / unsupported mode is provided */ public function __construct($mode) { parent::__construct($mode); if ($this->mode == self::MODE_STREAM) { throw new \InvalidArgumentException('Block ciphers cannot be ran in stream mode'); } } /** * Sets the key length. * * Key lengths can be between 32 and 448 bits. * * @param int $length */ public function setKeyLength($length) { if ($length < 32 || $length > 448) { throw new \LengthException('Key size of ' . $length . ' bits is not supported by this algorithm. Only keys of sizes between 32 and 448 bits are supported'); } $this->key_length = $length >> 3; parent::setKeyLength($length); } /** * Test for engine validity * * This is mainly just a wrapper to set things up for \phpseclib3\Crypt\Common\SymmetricKey::isValidEngine() * * @see \phpseclib3\Crypt\Common\SymmetricKey::isValidEngine() * @param int $engine * @return bool */ protected function isValidEngineHelper($engine) { if ($engine == self::ENGINE_OPENSSL) { if ($this->key_length < 16) { return false; } // quoting https://www.openssl.org/news/openssl-3.0-notes.html, OpenSSL 3.0.1 // "Moved all variations of the EVP ciphers CAST5, BF, IDEA, SEED, RC2, RC4, RC5, and DES to the legacy provider" // in theory openssl_get_cipher_methods() should catch this but, on GitHub Actions, at least, it does not if (version_compare(preg_replace('#OpenSSL (\d+\.\d+\.\d+) .*#', '$1', OPENSSL_VERSION_TEXT), '3.0.1', '>=')) { return false; } $this->cipher_name_openssl_ecb = 'bf-ecb'; $this->cipher_name_openssl = 'bf-' . $this->openssl_translate_mode(); } return parent::isValidEngineHelper($engine); } /** * Setup the key (expansion) * * @see \phpseclib3\Crypt\Common\SymmetricKey::_setupKey() */ protected function setupKey() { if (isset($this->kl['key']) && $this->key === $this->kl['key']) { // already expanded return; } $this->kl = ['key' => $this->key]; /* key-expanding p[] and S-Box building sb[] */ $this->bctx = [ 'p' => [], 'sb' => [ self::$sbox0, self::$sbox1, self::$sbox2, self::$sbox3 ] ]; // unpack binary string in unsigned chars $key = array_values(unpack('C*', $this->key)); $keyl = count($key); // with bcrypt $keyl will always be 16 (because the key is the sha512 of the key you provide) for ($j = 0, $i = 0; $i < 18; ++$i) { // xor P1 with the first 32-bits of the key, xor P2 with the second 32-bits ... for ($data = 0, $k = 0; $k < 4; ++$k) { $data = ($data << 8) | $key[$j]; if (++$j >= $keyl) { $j = 0; } } $this->bctx['p'][] = self::$parray[$i] ^ intval($data); } // encrypt the zero-string, replace P1 and P2 with the encrypted data, // encrypt P3 and P4 with the new P1 and P2, do it with all P-array and subkeys $data = "\0\0\0\0\0\0\0\0"; for ($i = 0; $i < 18; $i += 2) { list($l, $r) = array_values(unpack('N*', $data = $this->encryptBlock($data))); $this->bctx['p'][$i ] = $l; $this->bctx['p'][$i + 1] = $r; } for ($i = 0; $i < 4; ++$i) { for ($j = 0; $j < 256; $j += 2) { list($l, $r) = array_values(unpack('N*', $data = $this->encryptBlock($data))); $this->bctx['sb'][$i][$j ] = $l; $this->bctx['sb'][$i][$j + 1] = $r; } } } /** * Initialize Static Variables */ protected static function initialize_static_variables() { if (is_float(self::$sbox2[0])) { self::$sbox0 = array_map('intval', self::$sbox0); self::$sbox1 = array_map('intval', self::$sbox1); self::$sbox2 = array_map('intval', self::$sbox2); self::$sbox3 = array_map('intval', self::$sbox3); self::$parray = array_map('intval', self::$parray); } parent::initialize_static_variables(); } /** * bcrypt * * @param string $sha2pass * @param string $sha2salt * @access private * @return string */ private static function bcrypt_hash($sha2pass, $sha2salt) { $p = self::$parray; $sbox0 = self::$sbox0; $sbox1 = self::$sbox1; $sbox2 = self::$sbox2; $sbox3 = self::$sbox3; $cdata = array_values(unpack('N*', 'OxychromaticBlowfishSwatDynamite')); $sha2pass = array_values(unpack('N*', $sha2pass)); $sha2salt = array_values(unpack('N*', $sha2salt)); self::expandstate($sha2salt, $sha2pass, $sbox0, $sbox1, $sbox2, $sbox3, $p); for ($i = 0; $i < 64; $i++) { self::expand0state($sha2salt, $sbox0, $sbox1, $sbox2, $sbox3, $p); self::expand0state($sha2pass, $sbox0, $sbox1, $sbox2, $sbox3, $p); } for ($i = 0; $i < 64; $i++) { for ($j = 0; $j < 8; $j += 2) { // count($cdata) == 8 list($cdata[$j], $cdata[$j + 1]) = self::encryptBlockHelperFast($cdata[$j], $cdata[$j + 1], $sbox0, $sbox1, $sbox2, $sbox3, $p); } } return pack('L*', ...$cdata); } /** * Performs OpenSSH-style bcrypt * * @param string $pass * @param string $salt * @param int $keylen * @param int $rounds * @access public * @return string */ public static function bcrypt_pbkdf($pass, $salt, $keylen, $rounds) { self::initialize_static_variables(); if (PHP_INT_SIZE == 4) { throw new \RuntimeException('bcrypt is far too slow to be practical on 32-bit versions of PHP'); } $sha2pass = hash('sha512', $pass, true); $results = []; $count = 1; while (32 * count($results) < $keylen) { $countsalt = $salt . pack('N', $count++); $sha2salt = hash('sha512', $countsalt, true); $out = $tmpout = self::bcrypt_hash($sha2pass, $sha2salt); for ($i = 1; $i < $rounds; $i++) { $sha2salt = hash('sha512', $tmpout, true); $tmpout = self::bcrypt_hash($sha2pass, $sha2salt); $out ^= $tmpout; } $results[] = $out; } $output = ''; for ($i = 0; $i < 32; $i++) { foreach ($results as $result) { $output .= $result[$i]; } } return substr($output, 0, $keylen); } /** * Key expansion without salt * * @access private * @param int[] $key * @param int[] $sbox0 * @param int[] $sbox1 * @param int[] $sbox2 * @param int[] $sbox3 * @param int[] $p * @see self::_bcrypt_hash() */ private static function expand0state(array $key, array &$sbox0, array &$sbox1, array &$sbox2, array &$sbox3, array &$p) { // expand0state is basically the same thing as this: //return self::expandstate(array_fill(0, 16, 0), $key); // but this separate function eliminates a bunch of XORs and array lookups $p = [ $p[0] ^ $key[0], $p[1] ^ $key[1], $p[2] ^ $key[2], $p[3] ^ $key[3], $p[4] ^ $key[4], $p[5] ^ $key[5], $p[6] ^ $key[6], $p[7] ^ $key[7], $p[8] ^ $key[8], $p[9] ^ $key[9], $p[10] ^ $key[10], $p[11] ^ $key[11], $p[12] ^ $key[12], $p[13] ^ $key[13], $p[14] ^ $key[14], $p[15] ^ $key[15], $p[16] ^ $key[0], $p[17] ^ $key[1] ]; // @codingStandardsIgnoreStart list( $p[0], $p[1]) = self::encryptBlockHelperFast( 0, 0, $sbox0, $sbox1, $sbox2, $sbox3, $p); list( $p[2], $p[3]) = self::encryptBlockHelperFast($p[ 0], $p[ 1], $sbox0, $sbox1, $sbox2, $sbox3, $p); list( $p[4], $p[5]) = self::encryptBlockHelperFast($p[ 2], $p[ 3], $sbox0, $sbox1, $sbox2, $sbox3, $p); list( $p[6], $p[7]) = self::encryptBlockHelperFast($p[ 4], $p[ 5], $sbox0, $sbox1, $sbox2, $sbox3, $p); list( $p[8], $p[9]) = self::encryptBlockHelperFast($p[ 6], $p[ 7], $sbox0, $sbox1, $sbox2, $sbox3, $p); list($p[10], $p[11]) = self::encryptBlockHelperFast($p[ 8], $p[ 9], $sbox0, $sbox1, $sbox2, $sbox3, $p); list($p[12], $p[13]) = self::encryptBlockHelperFast($p[10], $p[11], $sbox0, $sbox1, $sbox2, $sbox3, $p); list($p[14], $p[15]) = self::encryptBlockHelperFast($p[12], $p[13], $sbox0, $sbox1, $sbox2, $sbox3, $p); list($p[16], $p[17]) = self::encryptBlockHelperFast($p[14], $p[15], $sbox0, $sbox1, $sbox2, $sbox3, $p); // @codingStandardsIgnoreEnd list($sbox0[0], $sbox0[1]) = self::encryptBlockHelperFast($p[16], $p[17], $sbox0, $sbox1, $sbox2, $sbox3, $p); for ($i = 2; $i < 256; $i += 2) { list($sbox0[$i], $sbox0[$i + 1]) = self::encryptBlockHelperFast($sbox0[$i - 2], $sbox0[$i - 1], $sbox0, $sbox1, $sbox2, $sbox3, $p); } list($sbox1[0], $sbox1[1]) = self::encryptBlockHelperFast($sbox0[254], $sbox0[255], $sbox0, $sbox1, $sbox2, $sbox3, $p); for ($i = 2; $i < 256; $i += 2) { list($sbox1[$i], $sbox1[$i + 1]) = self::encryptBlockHelperFast($sbox1[$i - 2], $sbox1[$i - 1], $sbox0, $sbox1, $sbox2, $sbox3, $p); } list($sbox2[0], $sbox2[1]) = self::encryptBlockHelperFast($sbox1[254], $sbox1[255], $sbox0, $sbox1, $sbox2, $sbox3, $p); for ($i = 2; $i < 256; $i += 2) { list($sbox2[$i], $sbox2[$i + 1]) = self::encryptBlockHelperFast($sbox2[$i - 2], $sbox2[$i - 1], $sbox0, $sbox1, $sbox2, $sbox3, $p); } list($sbox3[0], $sbox3[1]) = self::encryptBlockHelperFast($sbox2[254], $sbox2[255], $sbox0, $sbox1, $sbox2, $sbox3, $p); for ($i = 2; $i < 256; $i += 2) { list($sbox3[$i], $sbox3[$i + 1]) = self::encryptBlockHelperFast($sbox3[$i - 2], $sbox3[$i - 1], $sbox0, $sbox1, $sbox2, $sbox3, $p); } } /** * Key expansion with salt * * @access private * @param int[] $data * @param int[] $key * @param int[] $sbox0 * @param int[] $sbox1 * @param int[] $sbox2 * @param int[] $sbox3 * @param int[] $p * @see self::_bcrypt_hash() */ private static function expandstate(array $data, array $key, array &$sbox0, array &$sbox1, array &$sbox2, array &$sbox3, array &$p) { $p = [ $p[0] ^ $key[0], $p[1] ^ $key[1], $p[2] ^ $key[2], $p[3] ^ $key[3], $p[4] ^ $key[4], $p[5] ^ $key[5], $p[6] ^ $key[6], $p[7] ^ $key[7], $p[8] ^ $key[8], $p[9] ^ $key[9], $p[10] ^ $key[10], $p[11] ^ $key[11], $p[12] ^ $key[12], $p[13] ^ $key[13], $p[14] ^ $key[14], $p[15] ^ $key[15], $p[16] ^ $key[0], $p[17] ^ $key[1] ]; // @codingStandardsIgnoreStart list( $p[0], $p[1]) = self::encryptBlockHelperFast($data[ 0] , $data[ 1] , $sbox0, $sbox1, $sbox2, $sbox3, $p); list( $p[2], $p[3]) = self::encryptBlockHelperFast($data[ 2] ^ $p[ 0], $data[ 3] ^ $p[ 1], $sbox0, $sbox1, $sbox2, $sbox3, $p); list( $p[4], $p[5]) = self::encryptBlockHelperFast($data[ 4] ^ $p[ 2], $data[ 5] ^ $p[ 3], $sbox0, $sbox1, $sbox2, $sbox3, $p); list( $p[6], $p[7]) = self::encryptBlockHelperFast($data[ 6] ^ $p[ 4], $data[ 7] ^ $p[ 5], $sbox0, $sbox1, $sbox2, $sbox3, $p); list( $p[8], $p[9]) = self::encryptBlockHelperFast($data[ 8] ^ $p[ 6], $data[ 9] ^ $p[ 7], $sbox0, $sbox1, $sbox2, $sbox3, $p); list($p[10], $p[11]) = self::encryptBlockHelperFast($data[10] ^ $p[ 8], $data[11] ^ $p[ 9], $sbox0, $sbox1, $sbox2, $sbox3, $p); list($p[12], $p[13]) = self::encryptBlockHelperFast($data[12] ^ $p[10], $data[13] ^ $p[11], $sbox0, $sbox1, $sbox2, $sbox3, $p); list($p[14], $p[15]) = self::encryptBlockHelperFast($data[14] ^ $p[12], $data[15] ^ $p[13], $sbox0, $sbox1, $sbox2, $sbox3, $p); list($p[16], $p[17]) = self::encryptBlockHelperFast($data[ 0] ^ $p[14], $data[ 1] ^ $p[15], $sbox0, $sbox1, $sbox2, $sbox3, $p); // @codingStandardsIgnoreEnd list($sbox0[0], $sbox0[1]) = self::encryptBlockHelperFast($data[2] ^ $p[16], $data[3] ^ $p[17], $sbox0, $sbox1, $sbox2, $sbox3, $p); for ($i = 2, $j = 4; $i < 256; $i += 2, $j = ($j + 2) % 16) { // instead of 16 maybe count($data) would be better? list($sbox0[$i], $sbox0[$i + 1]) = self::encryptBlockHelperFast($data[$j] ^ $sbox0[$i - 2], $data[$j + 1] ^ $sbox0[$i - 1], $sbox0, $sbox1, $sbox2, $sbox3, $p); } list($sbox1[0], $sbox1[1]) = self::encryptBlockHelperFast($data[2] ^ $sbox0[254], $data[3] ^ $sbox0[255], $sbox0, $sbox1, $sbox2, $sbox3, $p); for ($i = 2, $j = 4; $i < 256; $i += 2, $j = ($j + 2) % 16) { list($sbox1[$i], $sbox1[$i + 1]) = self::encryptBlockHelperFast($data[$j] ^ $sbox1[$i - 2], $data[$j + 1] ^ $sbox1[$i - 1], $sbox0, $sbox1, $sbox2, $sbox3, $p); } list($sbox2[0], $sbox2[1]) = self::encryptBlockHelperFast($data[2] ^ $sbox1[254], $data[3] ^ $sbox1[255], $sbox0, $sbox1, $sbox2, $sbox3, $p); for ($i = 2, $j = 4; $i < 256; $i += 2, $j = ($j + 2) % 16) { list($sbox2[$i], $sbox2[$i + 1]) = self::encryptBlockHelperFast($data[$j] ^ $sbox2[$i - 2], $data[$j + 1] ^ $sbox2[$i - 1], $sbox0, $sbox1, $sbox2, $sbox3, $p); } list($sbox3[0], $sbox3[1]) = self::encryptBlockHelperFast($data[2] ^ $sbox2[254], $data[3] ^ $sbox2[255], $sbox0, $sbox1, $sbox2, $sbox3, $p); for ($i = 2, $j = 4; $i < 256; $i += 2, $j = ($j + 2) % 16) { list($sbox3[$i], $sbox3[$i + 1]) = self::encryptBlockHelperFast($data[$j] ^ $sbox3[$i - 2], $data[$j + 1] ^ $sbox3[$i - 1], $sbox0, $sbox1, $sbox2, $sbox3, $p); } } /** * Encrypts a block * * @param string $in * @return string */ protected function encryptBlock($in) { $p = $this->bctx['p']; // extract($this->bctx['sb'], EXTR_PREFIX_ALL, 'sb'); // slower $sb_0 = $this->bctx['sb'][0]; $sb_1 = $this->bctx['sb'][1]; $sb_2 = $this->bctx['sb'][2]; $sb_3 = $this->bctx['sb'][3]; $in = unpack('N*', $in); $l = $in[1]; $r = $in[2]; list($r, $l) = PHP_INT_SIZE == 4 ? self::encryptBlockHelperSlow($l, $r, $sb_0, $sb_1, $sb_2, $sb_3, $p) : self::encryptBlockHelperFast($l, $r, $sb_0, $sb_1, $sb_2, $sb_3, $p); return pack("N*", $r, $l); } /** * Fast helper function for block encryption * * @access private * @param int $x0 * @param int $x1 * @param int[] $sbox0 * @param int[] $sbox1 * @param int[] $sbox2 * @param int[] $sbox3 * @param int[] $p * @return int[] */ private static function encryptBlockHelperFast($x0, $x1, array $sbox0, array $sbox1, array $sbox2, array $sbox3, array $p) { $x0 ^= $p[0]; $x1 ^= ((($sbox0[($x0 & 0xFF000000) >> 24] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[1]; $x0 ^= ((($sbox0[($x1 & 0xFF000000) >> 24] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[2]; $x1 ^= ((($sbox0[($x0 & 0xFF000000) >> 24] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[3]; $x0 ^= ((($sbox0[($x1 & 0xFF000000) >> 24] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[4]; $x1 ^= ((($sbox0[($x0 & 0xFF000000) >> 24] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[5]; $x0 ^= ((($sbox0[($x1 & 0xFF000000) >> 24] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[6]; $x1 ^= ((($sbox0[($x0 & 0xFF000000) >> 24] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[7]; $x0 ^= ((($sbox0[($x1 & 0xFF000000) >> 24] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[8]; $x1 ^= ((($sbox0[($x0 & 0xFF000000) >> 24] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[9]; $x0 ^= ((($sbox0[($x1 & 0xFF000000) >> 24] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[10]; $x1 ^= ((($sbox0[($x0 & 0xFF000000) >> 24] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[11]; $x0 ^= ((($sbox0[($x1 & 0xFF000000) >> 24] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[12]; $x1 ^= ((($sbox0[($x0 & 0xFF000000) >> 24] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[13]; $x0 ^= ((($sbox0[($x1 & 0xFF000000) >> 24] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[14]; $x1 ^= ((($sbox0[($x0 & 0xFF000000) >> 24] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[15]; $x0 ^= ((($sbox0[($x1 & 0xFF000000) >> 24] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[16]; return [$x1 & 0xFFFFFFFF ^ $p[17], $x0 & 0xFFFFFFFF]; } /** * Slow helper function for block encryption * * @access private * @param int $x0 * @param int $x1 * @param int[] $sbox0 * @param int[] $sbox1 * @param int[] $sbox2 * @param int[] $sbox3 * @param int[] $p * @return int[] */ private static function encryptBlockHelperSlow($x0, $x1, array $sbox0, array $sbox1, array $sbox2, array $sbox3, array $p) { // -16777216 == intval(0xFF000000) on 32-bit PHP installs $x0 ^= $p[0]; $x1 ^= self::safe_intval((self::safe_intval($sbox0[(($x0 & -16777216) >> 24) & 0xFF] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[1]; $x0 ^= self::safe_intval((self::safe_intval($sbox0[(($x1 & -16777216) >> 24) & 0xFF] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[2]; $x1 ^= self::safe_intval((self::safe_intval($sbox0[(($x0 & -16777216) >> 24) & 0xFF] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[3]; $x0 ^= self::safe_intval((self::safe_intval($sbox0[(($x1 & -16777216) >> 24) & 0xFF] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[4]; $x1 ^= self::safe_intval((self::safe_intval($sbox0[(($x0 & -16777216) >> 24) & 0xFF] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[5]; $x0 ^= self::safe_intval((self::safe_intval($sbox0[(($x1 & -16777216) >> 24) & 0xFF] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[6]; $x1 ^= self::safe_intval((self::safe_intval($sbox0[(($x0 & -16777216) >> 24) & 0xFF] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[7]; $x0 ^= self::safe_intval((self::safe_intval($sbox0[(($x1 & -16777216) >> 24) & 0xFF] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[8]; $x1 ^= self::safe_intval((self::safe_intval($sbox0[(($x0 & -16777216) >> 24) & 0xFF] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[9]; $x0 ^= self::safe_intval((self::safe_intval($sbox0[(($x1 & -16777216) >> 24) & 0xFF] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[10]; $x1 ^= self::safe_intval((self::safe_intval($sbox0[(($x0 & -16777216) >> 24) & 0xFF] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[11]; $x0 ^= self::safe_intval((self::safe_intval($sbox0[(($x1 & -16777216) >> 24) & 0xFF] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[12]; $x1 ^= self::safe_intval((self::safe_intval($sbox0[(($x0 & -16777216) >> 24) & 0xFF] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[13]; $x0 ^= self::safe_intval((self::safe_intval($sbox0[(($x1 & -16777216) >> 24) & 0xFF] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[14]; $x1 ^= self::safe_intval((self::safe_intval($sbox0[(($x0 & -16777216) >> 24) & 0xFF] + $sbox1[($x0 & 0xFF0000) >> 16]) ^ $sbox2[($x0 & 0xFF00) >> 8]) + $sbox3[$x0 & 0xFF]) ^ $p[15]; $x0 ^= self::safe_intval((self::safe_intval($sbox0[(($x1 & -16777216) >> 24) & 0xFF] + $sbox1[($x1 & 0xFF0000) >> 16]) ^ $sbox2[($x1 & 0xFF00) >> 8]) + $sbox3[$x1 & 0xFF]) ^ $p[16]; return [$x1 ^ $p[17], $x0]; } /** * Decrypts a block * * @param string $in * @return string */ protected function decryptBlock($in) { $p = $this->bctx['p']; $sb_0 = $this->bctx['sb'][0]; $sb_1 = $this->bctx['sb'][1]; $sb_2 = $this->bctx['sb'][2]; $sb_3 = $this->bctx['sb'][3]; $in = unpack('N*', $in); $l = $in[1]; $r = $in[2]; for ($i = 17; $i > 2; $i -= 2) { $l ^= $p[$i]; $r ^= self::safe_intval((self::safe_intval($sb_0[$l >> 24 & 0xff] + $sb_1[$l >> 16 & 0xff]) ^ $sb_2[$l >> 8 & 0xff]) + $sb_3[$l & 0xff]); $r ^= $p[$i - 1]; $l ^= self::safe_intval((self::safe_intval($sb_0[$r >> 24 & 0xff] + $sb_1[$r >> 16 & 0xff]) ^ $sb_2[$r >> 8 & 0xff]) + $sb_3[$r & 0xff]); } return pack('N*', $r ^ $p[0], $l ^ $p[1]); } /** * Setup the performance-optimized function for de/encrypt() * * @see \phpseclib3\Crypt\Common\SymmetricKey::_setupInlineCrypt() */ protected function setupInlineCrypt() { $p = $this->bctx['p']; $init_crypt = ' static $sb_0, $sb_1, $sb_2, $sb_3; if (!$sb_0) { $sb_0 = $this->bctx["sb"][0]; $sb_1 = $this->bctx["sb"][1]; $sb_2 = $this->bctx["sb"][2]; $sb_3 = $this->bctx["sb"][3]; } '; $safeint = self::safe_intval_inline(); // Generating encrypt code: $encrypt_block = ' $in = unpack("N*", $in); $l = $in[1]; $r = $in[2]; '; for ($i = 0; $i < 16; $i += 2) { $encrypt_block .= ' $l^= ' . $p[$i] . '; $r^= ' . sprintf($safeint, '(' . sprintf($safeint, '$sb_0[$l >> 24 & 0xff] + $sb_1[$l >> 16 & 0xff]') . ' ^ $sb_2[$l >> 8 & 0xff]) + $sb_3[$l & 0xff]') . '; $r^= ' . $p[$i + 1] . '; $l^= ' . sprintf($safeint, '(' . sprintf($safeint, '$sb_0[$r >> 24 & 0xff] + $sb_1[$r >> 16 & 0xff]') . ' ^ $sb_2[$r >> 8 & 0xff]) + $sb_3[$r & 0xff]') . '; '; } $encrypt_block .= ' $in = pack("N*", $r ^ ' . $p[17] . ', $l ^ ' . $p[16] . ' ); '; // Generating decrypt code: $decrypt_block = ' $in = unpack("N*", $in); $l = $in[1]; $r = $in[2]; '; for ($i = 17; $i > 2; $i -= 2) { $decrypt_block .= ' $l^= ' . $p[$i] . '; $r^= ' . sprintf($safeint, '(' . sprintf($safeint, '$sb_0[$l >> 24 & 0xff] + $sb_1[$l >> 16 & 0xff]') . ' ^ $sb_2[$l >> 8 & 0xff]) + $sb_3[$l & 0xff]') . '; $r^= ' . $p[$i - 1] . '; $l^= ' . sprintf($safeint, '(' . sprintf($safeint, '$sb_0[$r >> 24 & 0xff] + $sb_1[$r >> 16 & 0xff]') . ' ^ $sb_2[$r >> 8 & 0xff]) + $sb_3[$r & 0xff]') . '; '; } $decrypt_block .= ' $in = pack("N*", $r ^ ' . $p[0] . ', $l ^ ' . $p[1] . ' ); '; $this->inline_crypt = $this->createInlineCryptFunction( [ 'init_crypt' => $init_crypt, 'init_encrypt' => '', 'init_decrypt' => '', 'encrypt_block' => $encrypt_block, 'decrypt_block' => $decrypt_block ] ); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA; use phpseclib3\Crypt\DSA; /** * DSA Parameters * * @author Jim Wigginton */ class Parameters extends DSA { /** * Returns the parameters * * @param string $type * @param array $options optional * @return string */ public function toString($type = 'PKCS1', array $options = []) { $type = self::validatePlugin('Keys', 'PKCS1', 'saveParameters'); return $type::saveParameters($this->p, $this->q, $this->g, $options); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA; use phpseclib3\Crypt\Common; use phpseclib3\Crypt\DSA; use phpseclib3\Crypt\DSA\Formats\Signature\ASN1 as ASN1Signature; use phpseclib3\Math\BigInteger; /** * DSA Private Key * * @author Jim Wigginton */ class PrivateKey extends DSA implements Common\PrivateKey { use Common\Traits\PasswordProtected; /** * DSA secret exponent x * * @var \phpseclib3\Math\BigInteger */ protected $x; /** * Returns the public key * * If you do "openssl rsa -in private.rsa -pubout -outform PEM" you get a PKCS8 formatted key * that contains a publicKeyAlgorithm AlgorithmIdentifier and a publicKey BIT STRING. * An AlgorithmIdentifier contains an OID and a parameters field. With RSA public keys this * parameters field is NULL. With DSA PKCS8 public keys it is not - it contains the p, q and g * variables. The publicKey BIT STRING contains, simply, the y variable. This can be verified * by getting a DSA PKCS8 public key: * * "openssl dsa -in private.dsa -pubout -outform PEM" * * ie. just swap out rsa with dsa in the rsa command above. * * A PKCS1 public key corresponds to the publicKey portion of the PKCS8 key. In the case of RSA * the publicKey portion /is/ the key. In the case of DSA it is not. You cannot verify a signature * without the parameters and the PKCS1 DSA public key format does not include the parameters. * * @see self::getPrivateKey() * @return mixed */ public function getPublicKey() { $type = self::validatePlugin('Keys', 'PKCS8', 'savePublicKey'); if (!isset($this->y)) { $this->y = $this->g->powMod($this->x, $this->p); } $key = $type::savePublicKey($this->p, $this->q, $this->g, $this->y); return DSA::loadFormat('PKCS8', $key) ->withHash($this->hash->getHash()) ->withSignatureFormat($this->shortFormat); } /** * Create a signature * * @see self::verify() * @param string $message * @return mixed */ public function sign($message) { $format = $this->sigFormat; if (self::$engines['OpenSSL'] && in_array($this->hash->getHash(), openssl_get_md_methods())) { $signature = ''; $result = openssl_sign($message, $signature, $this->toString('PKCS8'), $this->hash->getHash()); if ($result) { if ($this->shortFormat == 'ASN1') { return $signature; } extract(ASN1Signature::load($signature)); return $format::save($r, $s); } } $h = $this->hash->hash($message); $h = $this->bits2int($h); while (true) { $k = BigInteger::randomRange(self::$one, $this->q->subtract(self::$one)); $r = $this->g->powMod($k, $this->p); list(, $r) = $r->divide($this->q); if ($r->equals(self::$zero)) { continue; } $kinv = $k->modInverse($this->q); $temp = $h->add($this->x->multiply($r)); $temp = $kinv->multiply($temp); list(, $s) = $temp->divide($this->q); if (!$s->equals(self::$zero)) { break; } } // the following is an RFC6979 compliant implementation of deterministic DSA // it's unused because it's mainly intended for use when a good CSPRNG isn't // available. if phpseclib's CSPRNG isn't good then even key generation is // suspect /* $h1 = $this->hash->hash($message); $k = $this->computek($h1); $r = $this->g->powMod($k, $this->p); list(, $r) = $r->divide($this->q); $kinv = $k->modInverse($this->q); $h1 = $this->bits2int($h1); $temp = $h1->add($this->x->multiply($r)); $temp = $kinv->multiply($temp); list(, $s) = $temp->divide($this->q); */ return $format::save($r, $s); } /** * Returns the private key * * @param string $type * @param array $options optional * @return string */ public function toString($type, array $options = []) { $type = self::validatePlugin('Keys', $type, 'savePrivateKey'); if (!isset($this->y)) { $this->y = $this->g->powMod($this->x, $this->p); } return $type::savePrivateKey($this->p, $this->q, $this->g, $this->y, $this->x, $this->password, $options); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\PKCS1 as Progenitor; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps; use phpseclib3\Math\BigInteger; /** * PKCS#1 Formatted DSA Key Handler * * @author Jim Wigginton */ abstract class PKCS1 extends Progenitor { /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { $key = parent::load($key, $password); $decoded = ASN1::decodeBER($key); if (!$decoded) { throw new \RuntimeException('Unable to decode BER'); } $key = ASN1::asn1map($decoded[0], Maps\DSAParams::MAP); if (is_array($key)) { return $key; } $key = ASN1::asn1map($decoded[0], Maps\DSAPrivateKey::MAP); if (is_array($key)) { return $key; } $key = ASN1::asn1map($decoded[0], Maps\DSAPublicKey::MAP); if (is_array($key)) { return $key; } throw new \RuntimeException('Unable to perform ASN1 mapping'); } /** * Convert DSA parameters to the appropriate format * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @return string */ public static function saveParameters(BigInteger $p, BigInteger $q, BigInteger $g) { $key = [ 'p' => $p, 'q' => $q, 'g' => $g ]; $key = ASN1::encodeDER($key, Maps\DSAParams::MAP); return "-----BEGIN DSA PARAMETERS-----\r\n" . chunk_split(Strings::base64_encode($key), 64) . "-----END DSA PARAMETERS-----\r\n"; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @param \phpseclib3\Math\BigInteger $y * @param \phpseclib3\Math\BigInteger $x * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $p, BigInteger $q, BigInteger $g, BigInteger $y, BigInteger $x, $password = '', array $options = []) { $key = [ 'version' => 0, 'p' => $p, 'q' => $q, 'g' => $g, 'y' => $y, 'x' => $x ]; $key = ASN1::encodeDER($key, Maps\DSAPrivateKey::MAP); return self::wrapPrivateKey($key, 'DSA', $password, $options); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @param \phpseclib3\Math\BigInteger $y * @return string */ public static function savePublicKey(BigInteger $p, BigInteger $q, BigInteger $g, BigInteger $y) { $key = ASN1::encodeDER($y, Maps\DSAPublicKey::MAP); return self::wrapPublicKey($key, 'DSA'); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\PKCS8 as Progenitor; use phpseclib3\File\ASN1; use phpseclib3\File\ASN1\Maps; use phpseclib3\Math\BigInteger; /** * PKCS#8 Formatted DSA Key Handler * * @author Jim Wigginton */ abstract class PKCS8 extends Progenitor { /** * OID Name * * @var string */ const OID_NAME = 'id-dsa'; /** * OID Value * * @var string */ const OID_VALUE = '1.2.840.10040.4.1'; /** * Child OIDs loaded * * @var bool */ protected static $childOIDsLoaded = false; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } $isPublic = strpos($key, 'PUBLIC') !== false; $key = parent::load($key, $password); $type = isset($key['privateKey']) ? 'privateKey' : 'publicKey'; switch (true) { case !$isPublic && $type == 'publicKey': throw new \UnexpectedValueException('Human readable string claims non-public key but DER encoded string claims public key'); case $isPublic && $type == 'privateKey': throw new \UnexpectedValueException('Human readable string claims public key but DER encoded string claims private key'); } $decoded = ASN1::decodeBER($key[$type . 'Algorithm']['parameters']->element); if (!$decoded) { throw new \RuntimeException('Unable to decode BER of parameters'); } $components = ASN1::asn1map($decoded[0], Maps\DSAParams::MAP); if (!is_array($components)) { throw new \RuntimeException('Unable to perform ASN1 mapping on parameters'); } $decoded = ASN1::decodeBER($key[$type]); if (empty($decoded)) { throw new \RuntimeException('Unable to decode BER'); } $var = $type == 'privateKey' ? 'x' : 'y'; $components[$var] = ASN1::asn1map($decoded[0], Maps\DSAPublicKey::MAP); if (!$components[$var] instanceof BigInteger) { throw new \RuntimeException('Unable to perform ASN1 mapping'); } if (isset($key['meta'])) { $components['meta'] = $key['meta']; } return $components; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @param \phpseclib3\Math\BigInteger $y * @param \phpseclib3\Math\BigInteger $x * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $p, BigInteger $q, BigInteger $g, BigInteger $y, BigInteger $x, $password = '', array $options = []) { $params = [ 'p' => $p, 'q' => $q, 'g' => $g ]; $params = ASN1::encodeDER($params, Maps\DSAParams::MAP); $params = new ASN1\Element($params); $key = ASN1::encodeDER($x, Maps\DSAPublicKey::MAP); return self::wrapPrivateKey($key, [], $params, $password, null, '', $options); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @param \phpseclib3\Math\BigInteger $y * @param array $options optional * @return string */ public static function savePublicKey(BigInteger $p, BigInteger $q, BigInteger $g, BigInteger $y, array $options = []) { $params = [ 'p' => $p, 'q' => $q, 'g' => $g ]; $params = ASN1::encodeDER($params, Maps\DSAParams::MAP); $params = new ASN1\Element($params); $key = ASN1::encodeDER($y, Maps\DSAPublicKey::MAP); return self::wrapPublicKey($key, $params); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Exception\BadConfigurationException; use phpseclib3\Math\BigInteger; /** * XML Formatted DSA Key Handler * * @author Jim Wigginton */ abstract class XML { /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { if (!Strings::is_stringable($key)) { throw new \UnexpectedValueException('Key should be a string - not a ' . gettype($key)); } if (!class_exists('DOMDocument')) { throw new BadConfigurationException('The dom extension is not setup correctly on this system'); } $use_errors = libxml_use_internal_errors(true); $dom = new \DOMDocument(); if (substr($key, 0, 5) != '' . $key . ''; } if (!$dom->loadXML($key)) { libxml_use_internal_errors($use_errors); throw new \UnexpectedValueException('Key does not appear to contain XML'); } $xpath = new \DOMXPath($dom); $keys = ['p', 'q', 'g', 'y', 'j', 'seed', 'pgencounter']; foreach ($keys as $key) { // $dom->getElementsByTagName($key) is case-sensitive $temp = $xpath->query("//*[translate(local-name(), 'ABCDEFGHIJKLMNOPQRSTUVWXYZ','abcdefghijklmnopqrstuvwxyz')='$key']"); if (!$temp->length) { continue; } $value = new BigInteger(Strings::base64_decode($temp->item(0)->nodeValue), 256); switch ($key) { case 'p': // a prime modulus meeting the [DSS] requirements // Parameters P, Q, and G can be public and common to a group of users. They might be known // from application context. As such, they are optional but P and Q must either both appear // or both be absent $components['p'] = $value; break; case 'q': // an integer in the range 2**159 < Q < 2**160 which is a prime divisor of P-1 $components['q'] = $value; break; case 'g': // an integer with certain properties with respect to P and Q $components['g'] = $value; break; case 'y': // G**X mod P (where X is part of the private key and not made public) $components['y'] = $value; // the remaining options do not do anything case 'j': // (P - 1) / Q // Parameter J is available for inclusion solely for efficiency as it is calculatable from // P and Q case 'seed': // a DSA prime generation seed // Parameters seed and pgenCounter are used in the DSA prime number generation algorithm // specified in [DSS]. As such, they are optional but must either both be present or both // be absent case 'pgencounter': // a DSA prime generation counter } } libxml_use_internal_errors($use_errors); if (!isset($components['y'])) { throw new \UnexpectedValueException('Key is missing y component'); } switch (true) { case !isset($components['p']): case !isset($components['q']): case !isset($components['g']): return ['y' => $components['y']]; } return $components; } /** * Convert a public key to the appropriate format * * See https://www.w3.org/TR/xmldsig-core/#sec-DSAKeyValue * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @param \phpseclib3\Math\BigInteger $y * @return string */ public static function savePublicKey(BigInteger $p, BigInteger $q, BigInteger $g, BigInteger $y) { return "\r\n" . '

' . Strings::base64_encode($p->toBytes()) . "

\r\n" . ' ' . Strings::base64_encode($q->toBytes()) . "\r\n" . ' ' . Strings::base64_encode($g->toBytes()) . "\r\n" . ' ' . Strings::base64_encode($y->toBytes()) . "\r\n" . ''; } } 160 kinda useless, hence this handlers not supporting such keys. * * PHP version 5 * * @author Jim Wigginton * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\PuTTY as Progenitor; use phpseclib3\Math\BigInteger; /** * PuTTY Formatted DSA Key Handler * * @author Jim Wigginton */ abstract class PuTTY extends Progenitor { /** * Public Handler * * @var string */ const PUBLIC_HANDLER = 'phpseclib3\Crypt\DSA\Formats\Keys\OpenSSH'; /** * Algorithm Identifier * * @var array */ protected static $types = ['ssh-dss']; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { $components = parent::load($key, $password); if (!isset($components['private'])) { return $components; } extract($components); unset($components['public'], $components['private']); list($p, $q, $g, $y) = Strings::unpackSSH2('iiii', $public); list($x) = Strings::unpackSSH2('i', $private); return compact('p', 'q', 'g', 'y', 'x', 'comment'); } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @param \phpseclib3\Math\BigInteger $y * @param \phpseclib3\Math\BigInteger $x * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $p, BigInteger $q, BigInteger $g, BigInteger $y, BigInteger $x, $password = false, array $options = []) { if ($q->getLength() != 160) { throw new \InvalidArgumentException('SSH only supports keys with an N (length of Group Order q) of 160'); } $public = Strings::packSSH2('iiii', $p, $q, $g, $y); $private = Strings::packSSH2('i', $x); return self::wrapPrivateKey($public, $private, 'ssh-dss', $password, $options); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @param \phpseclib3\Math\BigInteger $y * @return string */ public static function savePublicKey(BigInteger $p, BigInteger $q, BigInteger $g, BigInteger $y) { if ($q->getLength() != 160) { throw new \InvalidArgumentException('SSH only supports keys with an N (length of Group Order q) of 160'); } return self::wrapPublicKey(Strings::packSSH2('iiii', $p, $q, $g, $y), 'ssh-dss'); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA\Formats\Keys; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\Formats\Keys\OpenSSH as Progenitor; use phpseclib3\Math\BigInteger; /** * OpenSSH Formatted DSA Key Handler * * @author Jim Wigginton */ abstract class OpenSSH extends Progenitor { /** * Supported Key Types * * @var array */ protected static $types = ['ssh-dss']; /** * Break a public or private key down into its constituent components * * @param string $key * @param string $password optional * @return array */ public static function load($key, $password = '') { $parsed = parent::load($key, $password); if (isset($parsed['paddedKey'])) { list($type) = Strings::unpackSSH2('s', $parsed['paddedKey']); if ($type != $parsed['type']) { throw new \RuntimeException("The public and private keys are not of the same type ($type vs $parsed[type])"); } list($p, $q, $g, $y, $x, $comment) = Strings::unpackSSH2('i5s', $parsed['paddedKey']); return compact('p', 'q', 'g', 'y', 'x', 'comment'); } list($p, $q, $g, $y) = Strings::unpackSSH2('iiii', $parsed['publicKey']); $comment = $parsed['comment']; return compact('p', 'q', 'g', 'y', 'comment'); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @param \phpseclib3\Math\BigInteger $y * @param array $options optional * @return string */ public static function savePublicKey(BigInteger $p, BigInteger $q, BigInteger $g, BigInteger $y, array $options = []) { if ($q->getLength() != 160) { throw new \InvalidArgumentException('SSH only supports keys with an N (length of Group Order q) of 160'); } // from : // string "ssh-dss" // mpint p // mpint q // mpint g // mpint y $DSAPublicKey = Strings::packSSH2('siiii', 'ssh-dss', $p, $q, $g, $y); if (isset($options['binary']) ? $options['binary'] : self::$binary) { return $DSAPublicKey; } $comment = isset($options['comment']) ? $options['comment'] : self::$comment; $DSAPublicKey = 'ssh-dss ' . base64_encode($DSAPublicKey) . ' ' . $comment; return $DSAPublicKey; } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @param \phpseclib3\Math\BigInteger $y * @param \phpseclib3\Math\BigInteger $x * @param string $password optional * @param array $options optional * @return string */ public static function savePrivateKey(BigInteger $p, BigInteger $q, BigInteger $g, BigInteger $y, BigInteger $x, $password = '', array $options = []) { $publicKey = self::savePublicKey($p, $q, $g, $y, ['binary' => true]); $privateKey = Strings::packSSH2('si5', 'ssh-dss', $p, $q, $g, $y, $x); return self::wrapPrivateKey($publicKey, $privateKey, $password, $options); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA\Formats\Keys; use phpseclib3\Math\BigInteger; /** * Raw DSA Key Handler * * @author Jim Wigginton */ abstract class Raw { /** * Break a public or private key down into its constituent components * * @param array $key * @param string $password optional * @return array */ public static function load($key, $password = '') { if (!is_array($key)) { throw new \UnexpectedValueException('Key should be a array - not a ' . gettype($key)); } switch (true) { case !isset($key['p']) || !isset($key['q']) || !isset($key['g']): case !$key['p'] instanceof BigInteger: case !$key['q'] instanceof BigInteger: case !$key['g'] instanceof BigInteger: case !isset($key['x']) && !isset($key['y']): case isset($key['x']) && !$key['x'] instanceof BigInteger: case isset($key['y']) && !$key['y'] instanceof BigInteger: throw new \UnexpectedValueException('Key appears to be malformed'); } $options = ['p' => 1, 'q' => 1, 'g' => 1, 'x' => 1, 'y' => 1]; return array_intersect_key($key, $options); } /** * Convert a private key to the appropriate format. * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @param \phpseclib3\Math\BigInteger $y * @param \phpseclib3\Math\BigInteger $x * @param string $password optional * @return string */ public static function savePrivateKey(BigInteger $p, BigInteger $q, BigInteger $g, BigInteger $y, BigInteger $x, $password = '') { return compact('p', 'q', 'g', 'y', 'x'); } /** * Convert a public key to the appropriate format * * @param \phpseclib3\Math\BigInteger $p * @param \phpseclib3\Math\BigInteger $q * @param \phpseclib3\Math\BigInteger $g * @param \phpseclib3\Math\BigInteger $y * @return string */ public static function savePublicKey(BigInteger $p, BigInteger $q, BigInteger $g, BigInteger $y) { return compact('p', 'q', 'g', 'y'); } } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA\Formats\Signature; use phpseclib3\File\ASN1 as Encoder; use phpseclib3\File\ASN1\Maps; use phpseclib3\Math\BigInteger; /** * ASN1 Signature Handler * * @author Jim Wigginton */ abstract class ASN1 { /** * Loads a signature * * @param string $sig * @return array|bool */ public static function load($sig) { if (!is_string($sig)) { return false; } $decoded = Encoder::decodeBER($sig); if (empty($decoded)) { return false; } $components = Encoder::asn1map($decoded[0], Maps\DssSigValue::MAP); return $components; } /** * Returns a signature in the appropriate format * * @param \phpseclib3\Math\BigInteger $r * @param \phpseclib3\Math\BigInteger $s * @return string */ public static function save(BigInteger $r, BigInteger $s) { return Encoder::encodeDER(compact('r', 's'), Maps\DssSigValue::MAP); } } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA\Formats\Signature; use phpseclib3\Common\Functions\Strings; use phpseclib3\Math\BigInteger; /** * SSH2 Signature Handler * * @author Jim Wigginton */ abstract class SSH2 { /** * Loads a signature * * @param string $sig * @return mixed */ public static function load($sig) { if (!is_string($sig)) { return false; } $result = Strings::unpackSSH2('ss', $sig); if ($result === false) { return false; } list($type, $blob) = $result; if ($type != 'ssh-dss' || strlen($blob) != 40) { return false; } return [ 'r' => new BigInteger(substr($blob, 0, 20), 256), 's' => new BigInteger(substr($blob, 20), 256) ]; } /** * Returns a signature in the appropriate format * * @param \phpseclib3\Math\BigInteger $r * @param \phpseclib3\Math\BigInteger $s * @return string */ public static function save(BigInteger $r, BigInteger $s) { if ($r->getLength() > 160 || $s->getLength() > 160) { return false; } return Strings::packSSH2( 'ss', 'ssh-dss', str_pad($r->toBytes(), 20, "\0", STR_PAD_LEFT) . str_pad($s->toBytes(), 20, "\0", STR_PAD_LEFT) ); } } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA\Formats\Signature; use phpseclib3\Crypt\Common\Formats\Signature\Raw as Progenitor; /** * Raw DSA Signature Handler * * @author Jim Wigginton */ abstract class Raw extends Progenitor { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Crypt\DSA; use phpseclib3\Crypt\Common; use phpseclib3\Crypt\DSA; use phpseclib3\Crypt\DSA\Formats\Signature\ASN1 as ASN1Signature; /** * DSA Public Key * * @author Jim Wigginton */ class PublicKey extends DSA implements Common\PublicKey { use Common\Traits\Fingerprint; /** * Verify a signature * * @see self::verify() * @param string $message * @param string $signature * @return mixed */ public function verify($message, $signature) { $format = $this->sigFormat; $params = $format::load($signature); if ($params === false || count($params) != 2) { return false; } extract($params); if (self::$engines['OpenSSL'] && in_array($this->hash->getHash(), openssl_get_md_methods())) { $sig = $format != 'ASN1' ? ASN1Signature::save($r, $s) : $signature; $result = openssl_verify($message, $sig, $this->toString('PKCS8'), $this->hash->getHash()); if ($result != -1) { return (bool) $result; } } $q_1 = $this->q->subtract(self::$one); if (!$r->between(self::$one, $q_1) || !$s->between(self::$one, $q_1)) { return false; } $w = $s->modInverse($this->q); $h = $this->hash->hash($message); $h = $this->bits2int($h); list(, $u1) = $h->multiply($w)->divide($this->q); list(, $u2) = $r->multiply($w)->divide($this->q); $v1 = $this->g->powMod($u1, $this->p); $v2 = $this->y->powMod($u2, $this->p); list(, $v) = $v1->multiply($v2)->divide($this->p); list(, $v) = $v->divide($this->q); return $v->equals($r); } /** * Returns the public key * * @param string $type * @param array $options optional * @return string */ public function toString($type, array $options = []) { $type = self::validatePlugin('Keys', $type, 'savePublicKey'); return $type::savePublicKey($this->p, $this->q, $this->g, $this->y, $options); } } * @copyright 2009 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\System\SSH\Agent; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Common\PrivateKey; use phpseclib3\Crypt\Common\PublicKey; use phpseclib3\Crypt\DSA; use phpseclib3\Crypt\EC; use phpseclib3\Crypt\RSA; use phpseclib3\Exception\UnsupportedAlgorithmException; use phpseclib3\System\SSH\Agent; use phpseclib3\System\SSH\Common\Traits\ReadBytes; /** * Pure-PHP ssh-agent client identity object * * Instantiation should only be performed by \phpseclib3\System\SSH\Agent class. * This could be thought of as implementing an interface that phpseclib3\Crypt\RSA * implements. ie. maybe a Net_SSH_Auth_PublicKey interface or something. * The methods in this interface would be getPublicKey and sign since those are the * methods phpseclib looks for to perform public key authentication. * * @author Jim Wigginton * @internal */ class Identity implements PrivateKey { use ReadBytes; // Signature Flags // See https://tools.ietf.org/html/draft-miller-ssh-agent-00#section-5.3 const SSH_AGENT_RSA2_256 = 2; const SSH_AGENT_RSA2_512 = 4; /** * Key Object * * @var PublicKey * @see self::getPublicKey() */ private $key; /** * Key Blob * * @var string * @see self::sign() */ private $key_blob; /** * Socket Resource * * @var resource * @see self::sign() */ private $fsock; /** * Signature flags * * @var int * @see self::sign() * @see self::setHash() */ private $flags = 0; /** * Curve Aliases * * @var array */ private static $curveAliases = [ 'secp256r1' => 'nistp256', 'secp384r1' => 'nistp384', 'secp521r1' => 'nistp521', 'Ed25519' => 'Ed25519' ]; /** * Default Constructor. * * @param resource $fsock */ public function __construct($fsock) { $this->fsock = $fsock; } /** * Set Public Key * * Called by \phpseclib3\System\SSH\Agent::requestIdentities() * * @param \phpseclib3\Crypt\Common\PublicKey $key */ public function withPublicKey(PublicKey $key) { if ($key instanceof EC) { if (is_array($key->getCurve()) || !isset(self::$curveAliases[$key->getCurve()])) { throw new UnsupportedAlgorithmException('The only supported curves are nistp256, nistp384, nistp512 and Ed25519'); } } $new = clone $this; $new->key = $key; return $new; } /** * Set Public Key * * Called by \phpseclib3\System\SSH\Agent::requestIdentities(). The key blob could be extracted from $this->key * but this saves a small amount of computation. * * @param string $key_blob */ public function withPublicKeyBlob($key_blob) { $new = clone $this; $new->key_blob = $key_blob; return $new; } /** * Get Public Key * * Wrapper for $this->key->getPublicKey() * * @param string $type optional * @return mixed */ public function getPublicKey($type = 'PKCS8') { return $this->key; } /** * Sets the hash * * @param string $hash */ public function withHash($hash) { $new = clone $this; $hash = strtolower($hash); if ($this->key instanceof RSA) { $new->flags = 0; switch ($hash) { case 'sha1': break; case 'sha256': $new->flags = self::SSH_AGENT_RSA2_256; break; case 'sha512': $new->flags = self::SSH_AGENT_RSA2_512; break; default: throw new UnsupportedAlgorithmException('The only supported hashes for RSA are sha1, sha256 and sha512'); } } if ($this->key instanceof EC) { switch ($this->key->getCurve()) { case 'secp256r1': $expectedHash = 'sha256'; break; case 'secp384r1': $expectedHash = 'sha384'; break; //case 'secp521r1': //case 'Ed25519': default: $expectedHash = 'sha512'; } if ($hash != $expectedHash) { throw new UnsupportedAlgorithmException('The only supported hash for ' . self::$curveAliases[$this->key->getCurve()] . ' is ' . $expectedHash); } } if ($this->key instanceof DSA) { if ($hash != 'sha1') { throw new UnsupportedAlgorithmException('The only supported hash for DSA is sha1'); } } return $new; } /** * Sets the padding * * Only PKCS1 padding is supported * * @param string $padding */ public function withPadding($padding) { if (!$this->key instanceof RSA) { throw new UnsupportedAlgorithmException('Only RSA keys support padding'); } if ($padding != RSA::SIGNATURE_PKCS1 && $padding != RSA::SIGNATURE_RELAXED_PKCS1) { throw new UnsupportedAlgorithmException('ssh-agent can only create PKCS1 signatures'); } return $this; } /** * Determines the signature padding mode * * Valid values are: ASN1, SSH2, Raw * * @param string $format */ public function withSignatureFormat($format) { if ($this->key instanceof RSA) { throw new UnsupportedAlgorithmException('Only DSA and EC keys support signature format setting'); } if ($format != 'SSH2') { throw new UnsupportedAlgorithmException('Only SSH2-formatted signatures are currently supported'); } return $this; } /** * Returns the curve * * Returns a string if it's a named curve, an array if not * * @return string|array */ public function getCurve() { if (!$this->key instanceof EC) { throw new UnsupportedAlgorithmException('Only EC keys have curves'); } return $this->key->getCurve(); } /** * Create a signature * * See "2.6.2 Protocol 2 private key signature request" * * @param string $message * @return string * @throws \RuntimeException on connection errors * @throws \phpseclib3\Exception\UnsupportedAlgorithmException if the algorithm is unsupported */ public function sign($message) { // the last parameter (currently 0) is for flags and ssh-agent only defines one flag (for ssh-dss): SSH_AGENT_OLD_SIGNATURE $packet = Strings::packSSH2( 'CssN', Agent::SSH_AGENTC_SIGN_REQUEST, $this->key_blob, $message, $this->flags ); $packet = Strings::packSSH2('s', $packet); if (strlen($packet) != fputs($this->fsock, $packet)) { throw new \RuntimeException('Connection closed during signing'); } $length = current(unpack('N', $this->readBytes(4))); $packet = $this->readBytes($length); list($type, $signature_blob) = Strings::unpackSSH2('Cs', $packet); if ($type != Agent::SSH_AGENT_SIGN_RESPONSE) { throw new \RuntimeException('Unable to retrieve signature'); } if (!$this->key instanceof RSA) { return $signature_blob; } list($type, $signature_blob) = Strings::unpackSSH2('ss', $signature_blob); return $signature_blob; } /** * Returns the private key * * @param string $type * @param array $options optional * @return string */ public function toString($type, array $options = []) { throw new \RuntimeException('ssh-agent does not provide a mechanism to get the private key'); } /** * Sets the password * * @param string|bool $password * @return never */ public function withPassword($password = false) { throw new \RuntimeException('ssh-agent does not provide a mechanism to get the private key'); } } * login('username', $agent)) { * exit('Login Failed'); * } * * echo $ssh->exec('pwd'); * echo $ssh->exec('ls -la'); * ?> * * * @author Jim Wigginton * @copyright 2014 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\System\SSH; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\PublicKeyLoader; use phpseclib3\Crypt\RSA; use phpseclib3\Exception\BadConfigurationException; use phpseclib3\Net\SSH2; use phpseclib3\System\SSH\Agent\Identity; /** * Pure-PHP ssh-agent client identity factory * * requestIdentities() method pumps out \phpseclib3\System\SSH\Agent\Identity objects * * @author Jim Wigginton */ class Agent { use Common\Traits\ReadBytes; // Message numbers // to request SSH1 keys you have to use SSH_AGENTC_REQUEST_RSA_IDENTITIES (1) const SSH_AGENTC_REQUEST_IDENTITIES = 11; // this is the SSH2 response; the SSH1 response is SSH_AGENT_RSA_IDENTITIES_ANSWER (2). const SSH_AGENT_IDENTITIES_ANSWER = 12; // the SSH1 request is SSH_AGENTC_RSA_CHALLENGE (3) const SSH_AGENTC_SIGN_REQUEST = 13; // the SSH1 response is SSH_AGENT_RSA_RESPONSE (4) const SSH_AGENT_SIGN_RESPONSE = 14; // Agent forwarding status // no forwarding requested and not active const FORWARD_NONE = 0; // request agent forwarding when opportune const FORWARD_REQUEST = 1; // forwarding has been request and is active const FORWARD_ACTIVE = 2; /** * Unused */ const SSH_AGENT_FAILURE = 5; /** * Socket Resource * * @var resource */ private $fsock; /** * Agent forwarding status * * @var int */ private $forward_status = self::FORWARD_NONE; /** * Buffer for accumulating forwarded authentication * agent data arriving on SSH data channel destined * for agent unix socket * * @var string */ private $socket_buffer = ''; /** * Tracking the number of bytes we are expecting * to arrive for the agent socket on the SSH data * channel * * @var int */ private $expected_bytes = 0; /** * Default Constructor * * @return \phpseclib3\System\SSH\Agent * @throws \phpseclib3\Exception\BadConfigurationException if SSH_AUTH_SOCK cannot be found * @throws \RuntimeException on connection errors */ public function __construct($address = null) { if (!$address) { switch (true) { case isset($_SERVER['SSH_AUTH_SOCK']): $address = $_SERVER['SSH_AUTH_SOCK']; break; case isset($_ENV['SSH_AUTH_SOCK']): $address = $_ENV['SSH_AUTH_SOCK']; break; default: throw new BadConfigurationException('SSH_AUTH_SOCK not found'); } } if (in_array('unix', stream_get_transports())) { $this->fsock = fsockopen('unix://' . $address, 0, $errno, $errstr); if (!$this->fsock) { throw new \RuntimeException("Unable to connect to ssh-agent (Error $errno: $errstr)"); } } else { if (substr($address, 0, 9) != '\\\\.\\pipe\\' || strpos(substr($address, 9), '\\') !== false) { throw new \RuntimeException('Address is not formatted as a named pipe should be'); } $this->fsock = fopen($address, 'r+b'); if (!$this->fsock) { throw new \RuntimeException('Unable to open address'); } } } /** * Request Identities * * See "2.5.2 Requesting a list of protocol 2 keys" * Returns an array containing zero or more \phpseclib3\System\SSH\Agent\Identity objects * * @return array * @throws \RuntimeException on receipt of unexpected packets */ public function requestIdentities() { if (!$this->fsock) { return []; } $packet = pack('NC', 1, self::SSH_AGENTC_REQUEST_IDENTITIES); if (strlen($packet) != fputs($this->fsock, $packet)) { throw new \RuntimeException('Connection closed while requesting identities'); } $length = current(unpack('N', $this->readBytes(4))); $packet = $this->readBytes($length); list($type, $keyCount) = Strings::unpackSSH2('CN', $packet); if ($type != self::SSH_AGENT_IDENTITIES_ANSWER) { throw new \RuntimeException('Unable to request identities'); } $identities = []; for ($i = 0; $i < $keyCount; $i++) { list($key_blob, $comment) = Strings::unpackSSH2('ss', $packet); $temp = $key_blob; list($key_type) = Strings::unpackSSH2('s', $temp); switch ($key_type) { case 'ssh-rsa': case 'ssh-dss': case 'ssh-ed25519': case 'ecdsa-sha2-nistp256': case 'ecdsa-sha2-nistp384': case 'ecdsa-sha2-nistp521': $key = PublicKeyLoader::load($key_type . ' ' . base64_encode($key_blob)); } // resources are passed by reference by default if (isset($key)) { $identity = (new Identity($this->fsock)) ->withPublicKey($key) ->withPublicKeyBlob($key_blob); $identities[] = $identity; unset($key); } } return $identities; } /** * Signal that agent forwarding should * be requested when a channel is opened * * @return void */ public function startSSHForwarding() { if ($this->forward_status == self::FORWARD_NONE) { $this->forward_status = self::FORWARD_REQUEST; } } /** * Request agent forwarding of remote server * * @param \phpseclib3\Net\SSH2 $ssh * @return bool */ private function request_forwarding(SSH2 $ssh) { if (!$ssh->requestAgentForwarding()) { return false; } $this->forward_status = self::FORWARD_ACTIVE; return true; } /** * On successful channel open * * This method is called upon successful channel * open to give the SSH Agent an opportunity * to take further action. i.e. request agent forwarding * * @param \phpseclib3\Net\SSH2 $ssh */ public function registerChannelOpen(SSH2 $ssh) { if ($this->forward_status == self::FORWARD_REQUEST) { $this->request_forwarding($ssh); } } /** * Forward data to SSH Agent and return data reply * * @param string $data * @return string Data from SSH Agent * @throws \RuntimeException on connection errors */ public function forwardData($data) { if ($this->expected_bytes > 0) { $this->socket_buffer .= $data; $this->expected_bytes -= strlen($data); } else { $agent_data_bytes = current(unpack('N', $data)); $current_data_bytes = strlen($data); $this->socket_buffer = $data; if ($current_data_bytes != $agent_data_bytes + 4) { $this->expected_bytes = ($agent_data_bytes + 4) - $current_data_bytes; return false; } } if (strlen($this->socket_buffer) != fwrite($this->fsock, $this->socket_buffer)) { throw new \RuntimeException('Connection closed attempting to forward data to SSH agent'); } $this->socket_buffer = ''; $this->expected_bytes = 0; $agent_reply_bytes = current(unpack('N', $this->readBytes(4))); $agent_reply_data = $this->readBytes($agent_reply_bytes); $agent_reply_data = current(unpack('a*', $agent_reply_data)); return pack('Na*', $agent_reply_bytes, $agent_reply_data); } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\System\SSH\Common\Traits; /** * ReadBytes trait * * @author Jim Wigginton */ trait ReadBytes { /** * Read data * * @param int $length * @throws \RuntimeException on connection errors */ public function readBytes($length) { $temp = fread($this->fsock, $length); if (strlen($temp) != $length) { throw new \RuntimeException("Expected $length bytes; got " . strlen($temp)); } return $temp; } } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * InsufficientSetupException * * @author Jim Wigginton */ class InsufficientSetupException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * ConnectionClosedException * * @author Jim Wigginton */ class ConnectionClosedException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * FileNotFoundException * * @author Jim Wigginton */ class FileNotFoundException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * UnableToConnectException * * @author Jim Wigginton */ class UnableToConnectException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * NoKeyLoadedException * * @author Jim Wigginton */ class NoKeyLoadedException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * UnsupportedCurveException * * @author Jim Wigginton */ class UnsupportedCurveException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * InconsistentSetupException * * @author Jim Wigginton */ class InconsistentSetupException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * BadModeException * * @author Jim Wigginton */ class BadModeException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * BadConfigurationException * * @author Jim Wigginton */ class BadConfigurationException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * UnsupportedAlgorithmException * * @author Jim Wigginton */ class UnsupportedAlgorithmException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * BadDecryptionException * * @author Jim Wigginton */ class BadDecryptionException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * UnsupportedOperationException * * @author Jim Wigginton */ class UnsupportedOperationException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * UnsupportedFormatException * * @author Jim Wigginton */ class UnsupportedFormatException extends \RuntimeException { } * @copyright 2015 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Exception; /** * NoSupportedAlgorithmsException * * @author Jim Wigginton */ class NoSupportedAlgorithmsException extends \RuntimeException { } * @copyright 2016 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Common\Functions; use ParagonIE\ConstantTime\Base64; use ParagonIE\ConstantTime\Base64UrlSafe; use ParagonIE\ConstantTime\Hex; use phpseclib3\Math\BigInteger; use phpseclib3\Math\Common\FiniteField; /** * Common String Functions * * @author Jim Wigginton */ abstract class Strings { /** * String Shift * * Inspired by array_shift * * @param string $string * @param int $index * @return string */ public static function shift(&$string, $index = 1) { $substr = substr($string, 0, $index); $string = substr($string, $index); return $substr; } /** * String Pop * * Inspired by array_pop * * @param string $string * @param int $index * @return string */ public static function pop(&$string, $index = 1) { $substr = substr($string, -$index); $string = substr($string, 0, -$index); return $substr; } /** * Parse SSH2-style string * * Returns either an array or a boolean if $data is malformed. * * Valid characters for $format are as follows: * * C = byte * b = boolean (true/false) * N = uint32 * Q = uint64 * s = string * i = mpint * L = name-list * * uint64 is not supported. * * @param string $format * @param string $data * @return mixed */ public static function unpackSSH2($format, &$data) { $format = self::formatPack($format); $result = []; for ($i = 0; $i < strlen($format); $i++) { switch ($format[$i]) { case 'C': case 'b': if (!strlen($data)) { throw new \LengthException('At least one byte needs to be present for successful C / b decodes'); } break; case 'N': case 'i': case 's': case 'L': if (strlen($data) < 4) { throw new \LengthException('At least four byte needs to be present for successful N / i / s / L decodes'); } break; case 'Q': if (strlen($data) < 8) { throw new \LengthException('At least eight byte needs to be present for successful N / i / s / L decodes'); } break; default: throw new \InvalidArgumentException('$format contains an invalid character'); } switch ($format[$i]) { case 'C': $result[] = ord(self::shift($data)); continue 2; case 'b': $result[] = ord(self::shift($data)) != 0; continue 2; case 'N': list(, $temp) = unpack('N', self::shift($data, 4)); $result[] = $temp; continue 2; case 'Q': // pack() added support for Q in PHP 5.6.3 and PHP 5.6 is phpseclib 3's minimum version // so in theory we could support this BUT, "64-bit format codes are not available for // 32-bit versions" and phpseclib works on 32-bit installs. on 32-bit installs // 64-bit floats can be used to get larger numbers then 32-bit signed ints would allow // for. sure, you're not gonna get the full precision of 64-bit numbers but just because // you need > 32-bit precision doesn't mean you need the full 64-bit precision extract(unpack('Nupper/Nlower', self::shift($data, 8))); $temp = $upper ? 4294967296 * $upper : 0; $temp += $lower < 0 ? ($lower & 0x7FFFFFFFF) + 0x80000000 : $lower; // $temp = hexdec(bin2hex(self::shift($data, 8))); $result[] = $temp; continue 2; } list(, $length) = unpack('N', self::shift($data, 4)); if (strlen($data) < $length) { throw new \LengthException("$length bytes needed; " . strlen($data) . ' bytes available'); } $temp = self::shift($data, $length); switch ($format[$i]) { case 'i': $result[] = new BigInteger($temp, -256); break; case 's': $result[] = $temp; break; case 'L': $result[] = explode(',', $temp); } } return $result; } /** * Create SSH2-style string * * @param string $format * @param string|int|float|array|bool ...$elements * @return string */ public static function packSSH2($format, ...$elements) { $format = self::formatPack($format); if (strlen($format) != count($elements)) { throw new \InvalidArgumentException('There must be as many arguments as there are characters in the $format string'); } $result = ''; for ($i = 0; $i < strlen($format); $i++) { $element = $elements[$i]; switch ($format[$i]) { case 'C': if (!is_int($element)) { throw new \InvalidArgumentException('Bytes must be represented as an integer between 0 and 255, inclusive.'); } $result .= pack('C', $element); break; case 'b': if (!is_bool($element)) { throw new \InvalidArgumentException('A boolean parameter was expected.'); } $result .= $element ? "\1" : "\0"; break; case 'Q': if (!is_int($element) && !is_float($element)) { throw new \InvalidArgumentException('An integer was expected.'); } // 4294967296 == 1 << 32 $result .= pack('NN', $element / 4294967296, $element); break; case 'N': if (is_float($element)) { $element = (int) $element; } if (!is_int($element)) { throw new \InvalidArgumentException('An integer was expected.'); } $result .= pack('N', $element); break; case 's': if (!self::is_stringable($element)) { throw new \InvalidArgumentException('A string was expected.'); } $result .= pack('Na*', strlen($element), $element); break; case 'i': if (!$element instanceof BigInteger && !$element instanceof FiniteField\Integer) { throw new \InvalidArgumentException('A phpseclib3\Math\BigInteger or phpseclib3\Math\Common\FiniteField\Integer object was expected.'); } $element = $element->toBytes(true); $result .= pack('Na*', strlen($element), $element); break; case 'L': if (!is_array($element)) { throw new \InvalidArgumentException('An array was expected.'); } $element = implode(',', $element); $result .= pack('Na*', strlen($element), $element); break; default: throw new \InvalidArgumentException('$format contains an invalid character'); } } return $result; } /** * Expand a pack string * * Converts C5 to CCCCC, for example. * * @param string $format * @return string */ private static function formatPack($format) { $parts = preg_split('#(\d+)#', $format, -1, PREG_SPLIT_DELIM_CAPTURE); $format = ''; for ($i = 1; $i < count($parts); $i += 2) { $format .= substr($parts[$i - 1], 0, -1) . str_repeat(substr($parts[$i - 1], -1), $parts[$i]); } $format .= $parts[$i - 1]; return $format; } /** * Convert binary data into bits * * bin2hex / hex2bin refer to base-256 encoded data as binary, whilst * decbin / bindec refer to base-2 encoded data as binary. For the purposes * of this function, bin refers to base-256 encoded data whilst bits refers * to base-2 encoded data * * @param string $x * @return string */ public static function bits2bin($x) { /* // the pure-PHP approach is faster than the GMP approach if (function_exists('gmp_export')) { return strlen($x) ? gmp_export(gmp_init($x, 2)) : gmp_init(0); } */ if (preg_match('#[^01]#', $x)) { throw new \RuntimeException('The only valid characters are 0 and 1'); } if (!defined('PHP_INT_MIN')) { define('PHP_INT_MIN', ~PHP_INT_MAX); } $length = strlen($x); if (!$length) { return ''; } $block_size = PHP_INT_SIZE << 3; $pad = $block_size - ($length % $block_size); if ($pad != $block_size) { $x = str_repeat('0', $pad) . $x; } $parts = str_split($x, $block_size); $str = ''; foreach ($parts as $part) { $xor = $part[0] == '1' ? PHP_INT_MIN : 0; $part[0] = '0'; $str .= pack( PHP_INT_SIZE == 4 ? 'N' : 'J', $xor ^ eval('return 0b' . $part . ';') ); } return ltrim($str, "\0"); } /** * Convert bits to binary data * * @param string $x * @return string */ public static function bin2bits($x, $trim = true) { /* // the pure-PHP approach is slower than the GMP approach BUT // i want to the pure-PHP version to be easily unit tested as well if (function_exists('gmp_import')) { return gmp_strval(gmp_import($x), 2); } */ $len = strlen($x); $mod = $len % PHP_INT_SIZE; if ($mod) { $x = str_pad($x, $len + PHP_INT_SIZE - $mod, "\0", STR_PAD_LEFT); } $bits = ''; if (PHP_INT_SIZE == 4) { $digits = unpack('N*', $x); foreach ($digits as $digit) { $bits .= sprintf('%032b', $digit); } } else { $digits = unpack('J*', $x); foreach ($digits as $digit) { $bits .= sprintf('%064b', $digit); } } return $trim ? ltrim($bits, '0') : $bits; } /** * Switch Endianness Bit Order * * @param string $x * @return string */ public static function switchEndianness($x) { $r = ''; for ($i = strlen($x) - 1; $i >= 0; $i--) { $b = ord($x[$i]); if (PHP_INT_SIZE === 8) { // 3 operations // from http://graphics.stanford.edu/~seander/bithacks.html#ReverseByteWith64BitsDiv $r .= chr((($b * 0x0202020202) & 0x010884422010) % 1023); } else { // 7 operations // from http://graphics.stanford.edu/~seander/bithacks.html#ReverseByteWith32Bits $p1 = ($b * 0x0802) & 0x22110; $p2 = ($b * 0x8020) & 0x88440; $r .= chr( (($p1 | $p2) * 0x10101) >> 16 ); } } return $r; } /** * Increment the current string * * @param string $var * @return string */ public static function increment_str(&$var) { if (function_exists('sodium_increment')) { $var = strrev($var); sodium_increment($var); $var = strrev($var); return $var; } for ($i = 4; $i <= strlen($var); $i += 4) { $temp = substr($var, -$i, 4); switch ($temp) { case "\xFF\xFF\xFF\xFF": $var = substr_replace($var, "\x00\x00\x00\x00", -$i, 4); break; case "\x7F\xFF\xFF\xFF": $var = substr_replace($var, "\x80\x00\x00\x00", -$i, 4); return $var; default: $temp = unpack('Nnum', $temp); $var = substr_replace($var, pack('N', $temp['num'] + 1), -$i, 4); return $var; } } $remainder = strlen($var) % 4; if ($remainder == 0) { return $var; } $temp = unpack('Nnum', str_pad(substr($var, 0, $remainder), 4, "\0", STR_PAD_LEFT)); $temp = substr(pack('N', $temp['num'] + 1), -$remainder); $var = substr_replace($var, $temp, 0, $remainder); return $var; } /** * Find whether the type of a variable is string (or could be converted to one) * * @param mixed $var * @return bool * @psalm-assert-if-true string|\Stringable $var */ public static function is_stringable($var) { return is_string($var) || (is_object($var) && method_exists($var, '__toString')); } /** * Constant Time Base64-decoding * * ParagoneIE\ConstantTime doesn't use libsodium if it's available so we'll do so * ourselves. see https://github.com/paragonie/constant_time_encoding/issues/39 * * @param string $data * @return string */ public static function base64_decode($data) { return function_exists('sodium_base642bin') ? sodium_base642bin($data, SODIUM_BASE64_VARIANT_ORIGINAL_NO_PADDING, '=') : Base64::decode($data); } /** * Constant Time Base64-decoding (URL safe) * * @param string $data * @return string */ public static function base64url_decode($data) { // return self::base64_decode(str_replace(['-', '_'], ['+', '/'], $data)); return function_exists('sodium_base642bin') ? sodium_base642bin($data, SODIUM_BASE64_VARIANT_URLSAFE_NO_PADDING, '=') : Base64UrlSafe::decode($data); } /** * Constant Time Base64-encoding * * @param string $data * @return string */ public static function base64_encode($data) { return function_exists('sodium_bin2base64') ? sodium_bin2base64($data, SODIUM_BASE64_VARIANT_ORIGINAL) : Base64::encode($data); } /** * Constant Time Base64-encoding (URL safe) * * @param string $data * @return string */ public static function base64url_encode($data) { // return str_replace(['+', '/'], ['-', '_'], self::base64_encode($data)); return function_exists('sodium_bin2base64') ? sodium_bin2base64($data, SODIUM_BASE64_VARIANT_URLSAFE) : Base64UrlSafe::encode($data); } /** * Constant Time Hex Decoder * * @param string $data * @return string */ public static function hex2bin($data) { return function_exists('sodium_hex2bin') ? sodium_hex2bin($data) : Hex::decode($data); } /** * Constant Time Hex Encoder * * @param string $data * @return string */ public static function bin2hex($data) { return function_exists('sodium_bin2hex') ? sodium_bin2hex($data) : Hex::encode($data); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License */ namespace phpseclib3\Math\PrimeField; use phpseclib3\Common\Functions\Strings; use phpseclib3\Math\BigInteger; use phpseclib3\Math\Common\FiniteField\Integer as Base; /** * Prime Finite Fields * * @author Jim Wigginton */ class Integer extends Base { /** * Holds the PrimeField's value * * @var BigInteger */ protected $value; /** * Keeps track of current instance * * @var int */ protected $instanceID; /** * Holds the PrimeField's modulo * * @var array */ protected static $modulo; /** * Holds a pre-generated function to perform modulo reductions * * @var array */ protected static $reduce; /** * Zero * * @var BigInteger */ protected static $zero; /** * Default constructor * * @param int $instanceID */ public function __construct($instanceID, BigInteger $num = null) { $this->instanceID = $instanceID; if (!isset($num)) { $this->value = clone static::$zero[static::class]; } else { $reduce = static::$reduce[$instanceID]; $this->value = $reduce($num); } } /** * Set the modulo for a given instance * * @param int $instanceID * @return void */ public static function setModulo($instanceID, BigInteger $modulo) { static::$modulo[$instanceID] = $modulo; } /** * Set the modulo for a given instance * * @param int $instanceID * @return void */ public static function setRecurringModuloFunction($instanceID, callable $function) { static::$reduce[$instanceID] = $function; if (!isset(static::$zero[static::class])) { static::$zero[static::class] = new BigInteger(); } } /** * Delete the modulo for a given instance */ public static function cleanupCache($instanceID) { unset(static::$modulo[$instanceID]); unset(static::$reduce[$instanceID]); } /** * Returns the modulo * * @param int $instanceID * @return BigInteger */ public static function getModulo($instanceID) { return static::$modulo[$instanceID]; } /** * Tests a parameter to see if it's of the right instance * * Throws an exception if the incorrect class is being utilized * * @return void */ public static function checkInstance(self $x, self $y) { if ($x->instanceID != $y->instanceID) { throw new \UnexpectedValueException('The instances of the two PrimeField\Integer objects do not match'); } } /** * Tests the equality of two numbers. * * @return bool */ public function equals(self $x) { static::checkInstance($this, $x); return $this->value->equals($x->value); } /** * Compares two numbers. * * @return int */ public function compare(self $x) { static::checkInstance($this, $x); return $this->value->compare($x->value); } /** * Adds two PrimeFieldIntegers. * * @return static */ public function add(self $x) { static::checkInstance($this, $x); $temp = new static($this->instanceID); $temp->value = $this->value->add($x->value); if ($temp->value->compare(static::$modulo[$this->instanceID]) >= 0) { $temp->value = $temp->value->subtract(static::$modulo[$this->instanceID]); } return $temp; } /** * Subtracts two PrimeFieldIntegers. * * @return static */ public function subtract(self $x) { static::checkInstance($this, $x); $temp = new static($this->instanceID); $temp->value = $this->value->subtract($x->value); if ($temp->value->isNegative()) { $temp->value = $temp->value->add(static::$modulo[$this->instanceID]); } return $temp; } /** * Multiplies two PrimeFieldIntegers. * * @return static */ public function multiply(self $x) { static::checkInstance($this, $x); return new static($this->instanceID, $this->value->multiply($x->value)); } /** * Divides two PrimeFieldIntegers. * * @return static */ public function divide(self $x) { static::checkInstance($this, $x); $denominator = $x->value->modInverse(static::$modulo[$this->instanceID]); return new static($this->instanceID, $this->value->multiply($denominator)); } /** * Performs power operation on a PrimeFieldInteger. * * @return static */ public function pow(BigInteger $x) { $temp = new static($this->instanceID); $temp->value = $this->value->powMod($x, static::$modulo[$this->instanceID]); return $temp; } /** * Calculates the square root * * @link https://en.wikipedia.org/wiki/Tonelli%E2%80%93Shanks_algorithm * @return static|false */ public function squareRoot() { static $one, $two; if (!isset($one)) { $one = new BigInteger(1); $two = new BigInteger(2); } $reduce = static::$reduce[$this->instanceID]; $p_1 = static::$modulo[$this->instanceID]->subtract($one); $q = clone $p_1; $s = BigInteger::scan1divide($q); list($pow) = $p_1->divide($two); for ($z = $one; !$z->equals(static::$modulo[$this->instanceID]); $z = $z->add($one)) { $temp = $z->powMod($pow, static::$modulo[$this->instanceID]); if ($temp->equals($p_1)) { break; } } $m = new BigInteger($s); $c = $z->powMod($q, static::$modulo[$this->instanceID]); $t = $this->value->powMod($q, static::$modulo[$this->instanceID]); list($temp) = $q->add($one)->divide($two); $r = $this->value->powMod($temp, static::$modulo[$this->instanceID]); while (!$t->equals($one)) { $i = clone $one; while (!$t->powMod($two->pow($i), static::$modulo[$this->instanceID])->equals($one)) { $i = $i->add($one); } if ($i->compare($m) >= 0) { return false; } $b = $c->powMod($two->pow($m->subtract($i)->subtract($one)), static::$modulo[$this->instanceID]); $m = $i; $c = $reduce($b->multiply($b)); $t = $reduce($t->multiply($c)); $r = $reduce($r->multiply($b)); } return new static($this->instanceID, $r); } /** * Is Odd? * * @return bool */ public function isOdd() { return $this->value->isOdd(); } /** * Negate * * A negative number can be written as 0-12. With modulos, 0 is the same thing as the modulo * so 0-12 is the same thing as modulo-12 * * @return static */ public function negate() { return new static($this->instanceID, static::$modulo[$this->instanceID]->subtract($this->value)); } /** * Converts an Integer to a byte string (eg. base-256). * * @return string */ public function toBytes() { $length = static::$modulo[$this->instanceID]->getLengthInBytes(); return str_pad($this->value->toBytes(), $length, "\0", STR_PAD_LEFT); } /** * Converts an Integer to a hex string (eg. base-16). * * @return string */ public function toHex() { return Strings::bin2hex($this->toBytes()); } /** * Converts an Integer to a bit string (eg. base-2). * * @return string */ public function toBits() { // return $this->value->toBits(); static $length; if (!isset($length)) { $length = static::$modulo[$this->instanceID]->getLength(); } return str_pad($this->value->toBits(), $length, '0', STR_PAD_LEFT); } /** * Returns the w-ary non-adjacent form (wNAF) * * @param int $w optional * @return array */ public function getNAF($w = 1) { $w++; $mask = new BigInteger((1 << $w) - 1); $sub = new BigInteger(1 << $w); //$sub = new BigInteger(1 << ($w - 1)); $d = $this->toBigInteger(); $d_i = []; $i = 0; while ($d->compare(static::$zero[static::class]) > 0) { if ($d->isOdd()) { // start mods $bigInteger = $d->testBit($w - 1) ? $d->bitwise_and($mask)->subtract($sub) : //$sub->subtract($d->bitwise_and($mask)) : $d->bitwise_and($mask); // end mods $d = $d->subtract($bigInteger); $d_i[$i] = (int) $bigInteger->toString(); } else { $d_i[$i] = 0; } $shift = !$d->equals(static::$zero[static::class]) && $d->bitwise_and($mask)->equals(static::$zero[static::class]) ? $w : 1; // $w or $w + 1? $d = $d->bitwise_rightShift($shift); while (--$shift > 0) { $d_i[++$i] = 0; } $i++; } return $d_i; } /** * Converts an Integer to a BigInteger * * @return BigInteger */ public function toBigInteger() { return clone $this->value; } /** * __toString() magic method * * @return string */ public function __toString() { return (string) $this->value; } /** * __debugInfo() magic method * * @return array */ public function __debugInfo() { return ['value' => $this->toHex()]; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math; use phpseclib3\Math\Common\FiniteField; use phpseclib3\Math\PrimeField\Integer; /** * Prime Finite Fields * * @author Jim Wigginton */ class PrimeField extends FiniteField { /** * Instance Counter * * @var int */ private static $instanceCounter = 0; /** * Keeps track of current instance * * @var int */ protected $instanceID; /** * Default constructor */ public function __construct(BigInteger $modulo) { //if (!$modulo->isPrime()) { // throw new \UnexpectedValueException('PrimeField requires a prime number be passed to the constructor'); //} $this->instanceID = self::$instanceCounter++; Integer::setModulo($this->instanceID, $modulo); Integer::setRecurringModuloFunction($this->instanceID, $modulo->createRecurringModuloFunction()); } /** * Use a custom defined modular reduction function * * @return void */ public function setReduction(\Closure $func) { $this->reduce = $func->bindTo($this, $this); } /** * Returns an instance of a dynamically generated PrimeFieldInteger class * * @return Integer */ public function newInteger(BigInteger $num) { return new Integer($this->instanceID, $num); } /** * Returns an integer on the finite field between one and the prime modulo * * @return Integer */ public function randomInteger() { static $one; if (!isset($one)) { $one = new BigInteger(1); } return new Integer($this->instanceID, BigInteger::randomRange($one, Integer::getModulo($this->instanceID))); } /** * Returns the length of the modulo in bytes * * @return int */ public function getLengthInBytes() { return Integer::getModulo($this->instanceID)->getLengthInBytes(); } /** * Returns the length of the modulo in bits * * @return int */ public function getLength() { return Integer::getModulo($this->instanceID)->getLength(); } /** * Destructor */ public function __destruct() { Integer::cleanupCache($this->instanceID); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\BCMath; use phpseclib3\Math\BigInteger\Engines\BCMath\Reductions\Barrett; /** * PHP Default Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class DefaultEngine extends Barrett { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\BCMath; use phpseclib3\Math\BigInteger\Engines\OpenSSL as Progenitor; /** * OpenSSL Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class OpenSSL extends Progenitor { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\BCMath\Reductions; use phpseclib3\Math\BigInteger\Engines\BCMath\Base; /** * PHP Barrett Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class Barrett extends Base { /** * Cache constants * * $cache[self::VARIABLE] tells us whether or not the cached data is still valid. * */ const VARIABLE = 0; /** * $cache[self::DATA] contains the cached data. * */ const DATA = 1; /** * Barrett Modular Reduction * * See {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=14 HAC 14.3.3} / * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=165 MPM 6.2.5} for more information. Modified slightly, * so as not to require negative numbers (initially, this script didn't support negative numbers). * * Employs "folding", as described at * {@link http://www.cosic.esat.kuleuven.be/publications/thesis-149.pdf#page=66 thesis-149.pdf#page=66}. To quote from * it, "the idea [behind folding] is to find a value x' such that x (mod m) = x' (mod m), with x' being smaller than x." * * Unfortunately, the "Barrett Reduction with Folding" algorithm described in thesis-149.pdf is not, as written, all that * usable on account of (1) its not using reasonable radix points as discussed in * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=162 MPM 6.2.2} and (2) the fact that, even with reasonable * radix points, it only works when there are an even number of digits in the denominator. The reason for (2) is that * (x >> 1) + (x >> 1) != x / 2 + x / 2. If x is even, they're the same, but if x is odd, they're not. See the in-line * comments for details. * * @param string $n * @param string $m * @return string */ protected static function reduce($n, $m) { static $cache = [ self::VARIABLE => [], self::DATA => [] ]; $m_length = strlen($m); if (strlen($n) > 2 * $m_length) { return bcmod($n, $m); } // if (m.length >> 1) + 2 <= m.length then m is too small and n can't be reduced if ($m_length < 5) { return self::regularBarrett($n, $m); } // n = 2 * m.length if (($key = array_search($m, $cache[self::VARIABLE])) === false) { $key = count($cache[self::VARIABLE]); $cache[self::VARIABLE][] = $m; $lhs = '1' . str_repeat('0', $m_length + ($m_length >> 1)); $u = bcdiv($lhs, $m, 0); $m1 = bcsub($lhs, bcmul($u, $m)); $cache[self::DATA][] = [ 'u' => $u, // m.length >> 1 (technically (m.length >> 1) + 1) 'm1' => $m1 // m.length ]; } else { extract($cache[self::DATA][$key]); } $cutoff = $m_length + ($m_length >> 1); $lsd = substr($n, -$cutoff); $msd = substr($n, 0, -$cutoff); $temp = bcmul($msd, $m1); // m.length + (m.length >> 1) $n = bcadd($lsd, $temp); // m.length + (m.length >> 1) + 1 (so basically we're adding two same length numbers) //if ($m_length & 1) { // return self::regularBarrett($n, $m); //} // (m.length + (m.length >> 1) + 1) - (m.length - 1) == (m.length >> 1) + 2 $temp = substr($n, 0, -$m_length + 1); // if even: ((m.length >> 1) + 2) + (m.length >> 1) == m.length + 2 // if odd: ((m.length >> 1) + 2) + (m.length >> 1) == (m.length - 1) + 2 == m.length + 1 $temp = bcmul($temp, $u); // if even: (m.length + 2) - ((m.length >> 1) + 1) = m.length - (m.length >> 1) + 1 // if odd: (m.length + 1) - ((m.length >> 1) + 1) = m.length - (m.length >> 1) $temp = substr($temp, 0, -($m_length >> 1) - 1); // if even: (m.length - (m.length >> 1) + 1) + m.length = 2 * m.length - (m.length >> 1) + 1 // if odd: (m.length - (m.length >> 1)) + m.length = 2 * m.length - (m.length >> 1) $temp = bcmul($temp, $m); // at this point, if m had an odd number of digits, we'd be subtracting a 2 * m.length - (m.length >> 1) digit // number from a m.length + (m.length >> 1) + 1 digit number. ie. there'd be an extra digit and the while loop // following this comment would loop a lot (hence our calling _regularBarrett() in that situation). $result = bcsub($n, $temp); //if (bccomp($result, '0') < 0) { if ($result[0] == '-') { $temp = '1' . str_repeat('0', $m_length + 1); $result = bcadd($result, $temp); } while (bccomp($result, $m) >= 0) { $result = bcsub($result, $m); } return $result; } /** * (Regular) Barrett Modular Reduction * * For numbers with more than four digits BigInteger::_barrett() is faster. The difference between that and this * is that this function does not fold the denominator into a smaller form. * * @param string $x * @param string $n * @return string */ private static function regularBarrett($x, $n) { static $cache = [ self::VARIABLE => [], self::DATA => [] ]; $n_length = strlen($n); if (strlen($x) > 2 * $n_length) { return bcmod($x, $n); } if (($key = array_search($n, $cache[self::VARIABLE])) === false) { $key = count($cache[self::VARIABLE]); $cache[self::VARIABLE][] = $n; $lhs = '1' . str_repeat('0', 2 * $n_length); $cache[self::DATA][] = bcdiv($lhs, $n, 0); } $temp = substr($x, 0, -$n_length + 1); $temp = bcmul($temp, $cache[self::DATA][$key]); $temp = substr($temp, 0, -$n_length - 1); $r1 = substr($x, -$n_length - 1); $r2 = substr(bcmul($temp, $n), -$n_length - 1); $result = bcsub($r1, $r2); //if (bccomp($result, '0') < 0) { if ($result[0] == '-') { $q = '1' . str_repeat('0', $n_length + 1); $result = bcadd($result, $q); } while (bccomp($result, $n) >= 0) { $result = bcsub($result, $n); } return $result; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\BCMath\Reductions; use phpseclib3\Math\BigInteger\Engines\BCMath; use phpseclib3\Math\BigInteger\Engines\BCMath\Base; /** * PHP Barrett Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class EvalBarrett extends Base { /** * Custom Reduction Function * * @see self::generateCustomReduction */ private static $custom_reduction; /** * Barrett Modular Reduction * * This calls a dynamically generated loop unrolled function that's specific to a given modulo. * Array lookups are avoided as are if statements testing for how many bits the host OS supports, etc. * * @param string $n * @param string $m * @return string */ protected static function reduce($n, $m) { $inline = self::$custom_reduction; return $inline($n); } /** * Generate Custom Reduction * * @param BCMath $m * @param string $class * @return callable|void */ protected static function generateCustomReduction(BCMath $m, $class) { $m_length = strlen($m); if ($m_length < 5) { $code = 'return bcmod($x, $n);'; eval('$func = function ($n) { ' . $code . '};'); self::$custom_reduction = $func; return; } $lhs = '1' . str_repeat('0', $m_length + ($m_length >> 1)); $u = bcdiv($lhs, $m, 0); $m1 = bcsub($lhs, bcmul($u, $m)); $cutoff = $m_length + ($m_length >> 1); $m = "'$m'"; $u = "'$u'"; $m1 = "'$m1'"; $code = ' $lsd = substr($n, -' . $cutoff . '); $msd = substr($n, 0, -' . $cutoff . '); $temp = bcmul($msd, ' . $m1 . '); $n = bcadd($lsd, $temp); $temp = substr($n, 0, ' . (-$m_length + 1) . '); $temp = bcmul($temp, ' . $u . '); $temp = substr($temp, 0, ' . (-($m_length >> 1) - 1) . '); $temp = bcmul($temp, ' . $m . '); $result = bcsub($n, $temp); if ($result[0] == \'-\') { $temp = \'1' . str_repeat('0', $m_length + 1) . '\'; $result = bcadd($result, $temp); } while (bccomp($result, ' . $m . ') >= 0) { $result = bcsub($result, ' . $m . '); } return $result;'; eval('$func = function ($n) { ' . $code . '};'); self::$custom_reduction = $func; return $func; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\BCMath; use phpseclib3\Math\BigInteger\Engines\BCMath; /** * Sliding Window Exponentiation Engine * * @author Jim Wigginton */ abstract class Base extends BCMath { /** * Cache constants * * $cache[self::VARIABLE] tells us whether or not the cached data is still valid. * */ const VARIABLE = 0; /** * $cache[self::DATA] contains the cached data. * */ const DATA = 1; /** * Test for engine validity * * @return bool */ public static function isValidEngine() { return static::class != __CLASS__; } /** * Performs modular exponentiation. * * @param BCMath $x * @param BCMath $e * @param BCMath $n * @param string $class * @return BCMath */ protected static function powModHelper(BCMath $x, BCMath $e, BCMath $n, $class) { if (empty($e->value)) { $temp = new $class(); $temp->value = '1'; return $x->normalize($temp); } return $x->normalize(static::slidingWindow($x, $e, $n, $class)); } /** * Modular reduction preparation * * @param string $x * @param string $n * @param string $class * @see self::slidingWindow() * @return string */ protected static function prepareReduce($x, $n, $class) { return static::reduce($x, $n); } /** * Modular multiply * * @param string $x * @param string $y * @param string $n * @param string $class * @see self::slidingWindow() * @return string */ protected static function multiplyReduce($x, $y, $n, $class) { return static::reduce(bcmul($x, $y), $n); } /** * Modular square * * @param string $x * @param string $n * @param string $class * @see self::slidingWindow() * @return string */ protected static function squareReduce($x, $n, $class) { return static::reduce(bcmul($x, $x), $n); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\BCMath; use phpseclib3\Math\BigInteger\Engines\BCMath; /** * Built-In BCMath Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class BuiltIn extends BCMath { /** * Performs modular exponentiation. * * @param BCMath $x * @param BCMath $e * @param BCMath $n * @return BCMath */ protected static function powModHelper(BCMath $x, BCMath $e, BCMath $n) { $temp = new BCMath(); $temp->value = bcpowmod($x->value, $e->value, $n->value); return $x->normalize($temp); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines; use phpseclib3\Crypt\RSA\Formats\Keys\PKCS8; use phpseclib3\Math\BigInteger; /** * OpenSSL Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class OpenSSL { /** * Test for engine validity * * @return bool */ public static function isValidEngine() { return extension_loaded('openssl') && static::class != __CLASS__; } /** * Performs modular exponentiation. * * @param Engine $x * @param Engine $e * @param Engine $n * @return Engine */ public static function powModHelper(Engine $x, Engine $e, Engine $n) { if ($n->getLengthInBytes() < 31 || $n->getLengthInBytes() > 16384) { throw new \OutOfRangeException('Only modulo between 31 and 16384 bits are accepted'); } $key = PKCS8::savePublicKey( new BigInteger($n), new BigInteger($e) ); $plaintext = str_pad($x->toBytes(), $n->getLengthInBytes(), "\0", STR_PAD_LEFT); // this is easily prone to failure. if the modulo is a multiple of 2 or 3 or whatever it // won't work and you'll get a "failure: error:0906D06C:PEM routines:PEM_read_bio:no start line" // error. i suppose, for even numbers, we could do what PHP\Montgomery.php does, but then what // about odd numbers divisible by 3, by 5, etc? if (!openssl_public_encrypt($plaintext, $result, $key, OPENSSL_NO_PADDING)) { throw new \UnexpectedValueException(openssl_error_string()); } $class = get_class($x); return new $class($result, 256); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines; /** * Pure-PHP 64-bit Engine. * * Uses 64-bit integers if int size is 8 bits * * @author Jim Wigginton */ class PHP64 extends PHP { // Constants used by PHP.php const BASE = 31; const BASE_FULL = 0x80000000; const MAX_DIGIT = 0x7FFFFFFF; const MSB = 0x40000000; /** * MAX10 in greatest MAX10LEN satisfying * MAX10 = 10**MAX10LEN <= 2**BASE. */ const MAX10 = 1000000000; /** * MAX10LEN in greatest MAX10LEN satisfying * MAX10 = 10**MAX10LEN <= 2**BASE. */ const MAX10LEN = 9; const MAX_DIGIT2 = 4611686018427387904; /** * Initialize a PHP64 BigInteger Engine instance * * @param int $base * @see parent::initialize() */ protected function initialize($base) { if ($base != 256 && $base != -256) { return parent::initialize($base); } $val = $this->value; $this->value = []; $vals = &$this->value; $i = strlen($val); if (!$i) { return; } while (true) { $i -= 4; if ($i < 0) { if ($i == -4) { break; } $val = substr($val, 0, 4 + $i); $val = str_pad($val, 4, "\0", STR_PAD_LEFT); if ($val == "\0\0\0\0") { break; } $i = 0; } list(, $digit) = unpack('N', substr($val, $i, 4)); $step = count($vals) & 7; if (!$step) { $digit &= static::MAX_DIGIT; $i++; } else { $shift = 8 - $step; $digit >>= $shift; $shift = 32 - $shift; $digit &= (1 << $shift) - 1; $temp = $i > 0 ? ord($val[$i - 1]) : 0; $digit |= ($temp << $shift) & 0x7F000000; } $vals[] = $digit; } while (end($vals) === 0) { array_pop($vals); } reset($vals); } /** * Test for engine validity * * @see parent::__construct() * @return bool */ public static function isValidEngine() { return PHP_INT_SIZE >= 8; } /** * Adds two BigIntegers. * * @param PHP64 $y * @return PHP64 */ public function add(PHP64 $y) { $temp = self::addHelper($this->value, $this->is_negative, $y->value, $y->is_negative); return $this->convertToObj($temp); } /** * Subtracts two BigIntegers. * * @param PHP64 $y * @return PHP64 */ public function subtract(PHP64 $y) { $temp = self::subtractHelper($this->value, $this->is_negative, $y->value, $y->is_negative); return $this->convertToObj($temp); } /** * Multiplies two BigIntegers. * * @param PHP64 $y * @return PHP64 */ public function multiply(PHP64 $y) { $temp = self::multiplyHelper($this->value, $this->is_negative, $y->value, $y->is_negative); return $this->convertToObj($temp); } /** * Divides two BigIntegers. * * Returns an array whose first element contains the quotient and whose second element contains the * "common residue". If the remainder would be positive, the "common residue" and the remainder are the * same. If the remainder would be negative, the "common residue" is equal to the sum of the remainder * and the divisor (basically, the "common residue" is the first positive modulo). * * @param PHP64 $y * @return array{PHP64, PHP64} */ public function divide(PHP64 $y) { return $this->divideHelper($y); } /** * Calculates modular inverses. * * Say you have (30 mod 17 * x mod 17) mod 17 == 1. x can be found using modular inverses. * @param PHP64 $n * @return false|PHP64 */ public function modInverse(PHP64 $n) { return $this->modInverseHelper($n); } /** * Calculates modular inverses. * * Say you have (30 mod 17 * x mod 17) mod 17 == 1. x can be found using modular inverses. * @param PHP64 $n * @return PHP64[] */ public function extendedGCD(PHP64 $n) { return $this->extendedGCDHelper($n); } /** * Calculates the greatest common divisor * * Say you have 693 and 609. The GCD is 21. * * @param PHP64 $n * @return PHP64 */ public function gcd(PHP64 $n) { return $this->extendedGCD($n)['gcd']; } /** * Logical And * * @param PHP64 $x * @return PHP64 */ public function bitwise_and(PHP64 $x) { return $this->bitwiseAndHelper($x); } /** * Logical Or * * @param PHP64 $x * @return PHP64 */ public function bitwise_or(PHP64 $x) { return $this->bitwiseOrHelper($x); } /** * Logical Exclusive Or * * @param PHP64 $x * @return PHP64 */ public function bitwise_xor(PHP64 $x) { return $this->bitwiseXorHelper($x); } /** * Compares two numbers. * * Although one might think !$x->compare($y) means $x != $y, it, in fact, means the opposite. The reason for this is * demonstrated thusly: * * $x > $y: $x->compare($y) > 0 * $x < $y: $x->compare($y) < 0 * $x == $y: $x->compare($y) == 0 * * Note how the same comparison operator is used. If you want to test for equality, use $x->equals($y). * * {@internal Could return $this->subtract($x), but that's not as fast as what we do do.} * * @param PHP64 $y * @return int in case < 0 if $this is less than $y; > 0 if $this is greater than $y, and 0 if they are equal. * @see self::equals() */ public function compare(PHP64 $y) { return parent::compareHelper($this->value, $this->is_negative, $y->value, $y->is_negative); } /** * Tests the equality of two numbers. * * If you need to see if one number is greater than or less than another number, use BigInteger::compare() * * @param PHP64 $x * @return bool */ public function equals(PHP64 $x) { return $this->value === $x->value && $this->is_negative == $x->is_negative; } /** * Performs modular exponentiation. * * @param PHP64 $e * @param PHP64 $n * @return PHP64 */ public function modPow(PHP64 $e, PHP64 $n) { return $this->powModOuter($e, $n); } /** * Performs modular exponentiation. * * Alias for modPow(). * * @param PHP64 $e * @param PHP64 $n * @return PHP64|false */ public function powMod(PHP64 $e, PHP64 $n) { return $this->powModOuter($e, $n); } /** * Generate a random prime number between a range * * If there's not a prime within the given range, false will be returned. * * @param PHP64 $min * @param PHP64 $max * @return false|PHP64 */ public static function randomRangePrime(PHP64 $min, PHP64 $max) { return self::randomRangePrimeOuter($min, $max); } /** * Generate a random number between a range * * Returns a random number between $min and $max where $min and $max * can be defined using one of the two methods: * * BigInteger::randomRange($min, $max) * BigInteger::randomRange($max, $min) * * @param PHP64 $min * @param PHP64 $max * @return PHP64 */ public static function randomRange(PHP64 $min, PHP64 $max) { return self::randomRangeHelper($min, $max); } /** * Performs exponentiation. * * @param PHP64 $n * @return PHP64 */ public function pow(PHP64 $n) { return $this->powHelper($n); } /** * Return the minimum BigInteger between an arbitrary number of BigIntegers. * * @param PHP64 ...$nums * @return PHP64 */ public static function min(PHP64 ...$nums) { return self::minHelper($nums); } /** * Return the maximum BigInteger between an arbitrary number of BigIntegers. * * @param PHP64 ...$nums * @return PHP64 */ public static function max(PHP64 ...$nums) { return self::maxHelper($nums); } /** * Tests BigInteger to see if it is between two integers, inclusive * * @param PHP64 $min * @param PHP64 $max * @return bool */ public function between(PHP64 $min, PHP64 $max) { return $this->compare($min) >= 0 && $this->compare($max) <= 0; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Random; use phpseclib3\Exception\BadConfigurationException; use phpseclib3\Math\BigInteger; /** * Base Engine. * * @author Jim Wigginton */ abstract class Engine implements \JsonSerializable { /* final protected */ const PRIMES = [ 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, 73, 79, 83, 89, 97, 101, 103, 107, 109, 113, 127, 131, 137, 139, 149, 151, 157, 163, 167, 173, 179, 181, 191, 193, 197, 199, 211, 223, 227, 229, 233, 239, 241, 251, 257, 263, 269, 271, 277, 281, 283, 293, 307, 311, 313, 317, 331, 337, 347, 349, 353, 359, 367, 373, 379, 383, 389, 397, 401, 409, 419, 421, 431, 433, 439, 443, 449, 457, 461, 463, 467, 479, 487, 491, 499, 503, 509, 521, 523, 541, 547, 557, 563, 569, 571, 577, 587, 593, 599, 601, 607, 613, 617, 619, 631, 641, 643, 647, 653, 659, 661, 673, 677, 683, 691, 701, 709, 719, 727, 733, 739, 743, 751, 757, 761, 769, 773, 787, 797, 809, 811, 821, 823, 827, 829, 839, 853, 857, 859, 863, 877, 881, 883, 887, 907, 911, 919, 929, 937, 941, 947, 953, 967, 971, 977, 983, 991, 997, ]; /** * BigInteger(0) * * @var array, static> */ protected static $zero = []; /** * BigInteger(1) * * @var array, static> */ protected static $one = []; /** * BigInteger(2) * * @var array, static> */ protected static $two = []; /** * Modular Exponentiation Engine * * @var array, class-string> */ protected static $modexpEngine; /** * Engine Validity Flag * * @var array, bool> */ protected static $isValidEngine; /** * Holds the BigInteger's value * * @var \GMP|string|array|int */ protected $value; /** * Holds the BigInteger's sign * * @var bool */ protected $is_negative; /** * Precision * * @see static::setPrecision() * @var int */ protected $precision = -1; /** * Precision Bitmask * * @see static::setPrecision() * @var static|false */ protected $bitmask = false; /** * Recurring Modulo Function * * @var callable */ protected $reduce; /** * Mode independent value used for serialization. * * @see self::__sleep() * @see self::__wakeup() * @var string */ protected $hex; /** * Default constructor * * @param int|numeric-string $x integer Base-10 number or base-$base number if $base set. * @param int $base */ public function __construct($x = 0, $base = 10) { if (!array_key_exists(static::class, static::$zero)) { static::$zero[static::class] = null; // Placeholder to prevent infinite loop. static::$zero[static::class] = new static(0); static::$one[static::class] = new static(1); static::$two[static::class] = new static(2); } // '0' counts as empty() but when the base is 256 '0' is equal to ord('0') or 48 // '0' is the only value like this per http://php.net/empty if (empty($x) && (abs($base) != 256 || $x !== '0')) { return; } switch ($base) { case -256: case 256: if ($base == -256 && (ord($x[0]) & 0x80)) { $this->value = ~$x; $this->is_negative = true; } else { $this->value = $x; $this->is_negative = false; } $this->initialize($base); if ($this->is_negative) { $temp = $this->add(new static('-1')); $this->value = $temp->value; } break; case -16: case 16: if ($base > 0 && $x[0] == '-') { $this->is_negative = true; $x = substr($x, 1); } $x = preg_replace('#^(?:0x)?([A-Fa-f0-9]*).*#', '$1', $x); $is_negative = false; if ($base < 0 && hexdec($x[0]) >= 8) { $this->is_negative = $is_negative = true; $x = Strings::bin2hex(~Strings::hex2bin($x)); } $this->value = $x; $this->initialize($base); if ($is_negative) { $temp = $this->add(new static('-1')); $this->value = $temp->value; } break; case -10: case 10: // (?value = preg_replace('#(?value) || $this->value == '-') { $this->value = '0'; } $this->initialize($base); break; case -2: case 2: if ($base > 0 && $x[0] == '-') { $this->is_negative = true; $x = substr($x, 1); } $x = preg_replace('#^([01]*).*#', '$1', $x); $temp = new static(Strings::bits2bin($x), 128 * $base); // ie. either -16 or +16 $this->value = $temp->value; if ($temp->is_negative) { $this->is_negative = true; } break; default: // base not supported, so we'll let $this == 0 } } /** * Sets engine type. * * Throws an exception if the type is invalid * * @param class-string $engine */ public static function setModExpEngine($engine) { $fqengine = '\\phpseclib3\\Math\\BigInteger\\Engines\\' . static::ENGINE_DIR . '\\' . $engine; if (!class_exists($fqengine) || !method_exists($fqengine, 'isValidEngine')) { throw new \InvalidArgumentException("$engine is not a valid engine"); } if (!$fqengine::isValidEngine()) { throw new BadConfigurationException("$engine is not setup correctly on this system"); } static::$modexpEngine[static::class] = $fqengine; } /** * Converts a BigInteger to a byte string (eg. base-256). * * Negative numbers are saved as positive numbers, unless $twos_compliment is set to true, at which point, they're * saved as two's compliment. * @return string */ protected function toBytesHelper() { $comparison = $this->compare(new static()); if ($comparison == 0) { return $this->precision > 0 ? str_repeat(chr(0), ($this->precision + 1) >> 3) : ''; } $temp = $comparison < 0 ? $this->add(new static(1)) : $this; $bytes = $temp->toBytes(); if (!strlen($bytes)) { // eg. if the number we're trying to convert is -1 $bytes = chr(0); } if (ord($bytes[0]) & 0x80) { $bytes = chr(0) . $bytes; } return $comparison < 0 ? ~$bytes : $bytes; } /** * Converts a BigInteger to a hex string (eg. base-16). * * @param bool $twos_compliment * @return string */ public function toHex($twos_compliment = false) { return Strings::bin2hex($this->toBytes($twos_compliment)); } /** * Converts a BigInteger to a bit string (eg. base-2). * * Negative numbers are saved as positive numbers, unless $twos_compliment is set to true, at which point, they're * saved as two's compliment. * * @param bool $twos_compliment * @return string */ public function toBits($twos_compliment = false) { $hex = $this->toBytes($twos_compliment); $bits = Strings::bin2bits($hex); $result = $this->precision > 0 ? substr($bits, -$this->precision) : ltrim($bits, '0'); if ($twos_compliment && $this->compare(new static()) > 0 && $this->precision <= 0) { return '0' . $result; } return $result; } /** * Calculates modular inverses. * * Say you have (30 mod 17 * x mod 17) mod 17 == 1. x can be found using modular inverses. * * {@internal See {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=21 HAC 14.64} for more information.} * * @param Engine $n * @return static|false */ protected function modInverseHelper(Engine $n) { // $x mod -$n == $x mod $n. $n = $n->abs(); if ($this->compare(static::$zero[static::class]) < 0) { $temp = $this->abs(); $temp = $temp->modInverse($n); return $this->normalize($n->subtract($temp)); } extract($this->extendedGCD($n)); /** * @var Engine $gcd * @var Engine $x */ if (!$gcd->equals(static::$one[static::class])) { return false; } $x = $x->compare(static::$zero[static::class]) < 0 ? $x->add($n) : $x; return $this->compare(static::$zero[static::class]) < 0 ? $this->normalize($n->subtract($x)) : $this->normalize($x); } /** * Serialize * * Will be called, automatically, when serialize() is called on a BigInteger object. * * @return array */ public function __sleep() { $this->hex = $this->toHex(true); $vars = ['hex']; if ($this->precision > 0) { $vars[] = 'precision'; } return $vars; } /** * Serialize * * Will be called, automatically, when unserialize() is called on a BigInteger object. * * @return void */ public function __wakeup() { $temp = new static($this->hex, -16); $this->value = $temp->value; $this->is_negative = $temp->is_negative; if ($this->precision > 0) { // recalculate $this->bitmask $this->setPrecision($this->precision); } } /** * JSON Serialize * * Will be called, automatically, when json_encode() is called on a BigInteger object. */ #[\ReturnTypeWillChange] public function jsonSerialize() { $result = ['hex' => $this->toHex(true)]; if ($this->precision > 0) { $result['precision'] = $this->precision; } return $result; } /** * Converts a BigInteger to a base-10 number. * * @return string */ public function __toString() { return $this->toString(); } /** * __debugInfo() magic method * * Will be called, automatically, when print_r() or var_dump() are called * * @return array */ public function __debugInfo() { $result = [ 'value' => '0x' . $this->toHex(true), 'engine' => basename(static::class) ]; return $this->precision > 0 ? $result + ['precision' => $this->precision] : $result; } /** * Set Precision * * Some bitwise operations give different results depending on the precision being used. Examples include left * shift, not, and rotates. * * @param int $bits */ public function setPrecision($bits) { if ($bits < 1) { $this->precision = -1; $this->bitmask = false; return; } $this->precision = $bits; $this->bitmask = static::setBitmask($bits); $temp = $this->normalize($this); $this->value = $temp->value; } /** * Get Precision * * Returns the precision if it exists, -1 if it doesn't * * @return int */ public function getPrecision() { return $this->precision; } /** * Set Bitmask * @return static * @param int $bits * @see self::setPrecision() */ protected static function setBitmask($bits) { return new static(chr((1 << ($bits & 0x7)) - 1) . str_repeat(chr(0xFF), $bits >> 3), 256); } /** * Logical Not * * @return Engine|string */ public function bitwise_not() { // calculuate "not" without regard to $this->precision // (will always result in a smaller number. ie. ~1 isn't 1111 1110 - it's 0) $temp = $this->toBytes(); if ($temp == '') { return $this->normalize(static::$zero[static::class]); } $pre_msb = decbin(ord($temp[0])); $temp = ~$temp; $msb = decbin(ord($temp[0])); if (strlen($msb) == 8) { $msb = substr($msb, strpos($msb, '0')); } $temp[0] = chr(bindec($msb)); // see if we need to add extra leading 1's $current_bits = strlen($pre_msb) + 8 * strlen($temp) - 8; $new_bits = $this->precision - $current_bits; if ($new_bits <= 0) { return $this->normalize(new static($temp, 256)); } // generate as many leading 1's as we need to. $leading_ones = chr((1 << ($new_bits & 0x7)) - 1) . str_repeat(chr(0xFF), $new_bits >> 3); self::base256_lshift($leading_ones, $current_bits); $temp = str_pad($temp, strlen($leading_ones), chr(0), STR_PAD_LEFT); return $this->normalize(new static($leading_ones | $temp, 256)); } /** * Logical Left Shift * * Shifts binary strings $shift bits, essentially multiplying by 2**$shift. * * @param string $x * @param int $shift * @return void */ protected static function base256_lshift(&$x, $shift) { if ($shift == 0) { return; } $num_bytes = $shift >> 3; // eg. floor($shift/8) $shift &= 7; // eg. $shift % 8 $carry = 0; for ($i = strlen($x) - 1; $i >= 0; --$i) { $temp = ord($x[$i]) << $shift | $carry; $x[$i] = chr($temp); $carry = $temp >> 8; } $carry = ($carry != 0) ? chr($carry) : ''; $x = $carry . $x . str_repeat(chr(0), $num_bytes); } /** * Logical Left Rotate * * Instead of the top x bits being dropped they're appended to the shifted bit string. * * @param int $shift * @return Engine */ public function bitwise_leftRotate($shift) { $bits = $this->toBytes(); if ($this->precision > 0) { $precision = $this->precision; if (static::FAST_BITWISE) { $mask = $this->bitmask->toBytes(); } else { $mask = $this->bitmask->subtract(new static(1)); $mask = $mask->toBytes(); } } else { $temp = ord($bits[0]); for ($i = 0; $temp >> $i; ++$i) { } $precision = 8 * strlen($bits) - 8 + $i; $mask = chr((1 << ($precision & 0x7)) - 1) . str_repeat(chr(0xFF), $precision >> 3); } if ($shift < 0) { $shift += $precision; } $shift %= $precision; if (!$shift) { return clone $this; } $left = $this->bitwise_leftShift($shift); $left = $left->bitwise_and(new static($mask, 256)); $right = $this->bitwise_rightShift($precision - $shift); $result = static::FAST_BITWISE ? $left->bitwise_or($right) : $left->add($right); return $this->normalize($result); } /** * Logical Right Rotate * * Instead of the bottom x bits being dropped they're prepended to the shifted bit string. * * @param int $shift * @return Engine */ public function bitwise_rightRotate($shift) { return $this->bitwise_leftRotate(-$shift); } /** * Returns the smallest and largest n-bit number * * @param int $bits * @return array{min: static, max: static} */ public static function minMaxBits($bits) { $bytes = $bits >> 3; $min = str_repeat(chr(0), $bytes); $max = str_repeat(chr(0xFF), $bytes); $msb = $bits & 7; if ($msb) { $min = chr(1 << ($msb - 1)) . $min; $max = chr((1 << $msb) - 1) . $max; } else { $min[0] = chr(0x80); } return [ 'min' => new static($min, 256), 'max' => new static($max, 256) ]; } /** * Return the size of a BigInteger in bits * * @return int */ public function getLength() { return strlen($this->toBits()); } /** * Return the size of a BigInteger in bytes * * @return int */ public function getLengthInBytes() { return strlen($this->toBytes()); } /** * Performs some pre-processing for powMod * * @param Engine $e * @param Engine $n * @return static|false */ protected function powModOuter(Engine $e, Engine $n) { $n = $this->bitmask !== false && $this->bitmask->compare($n) < 0 ? $this->bitmask : $n->abs(); if ($e->compare(new static()) < 0) { $e = $e->abs(); $temp = $this->modInverse($n); if ($temp === false) { return false; } return $this->normalize($temp->powModInner($e, $n)); } return $this->powModInner($e, $n); } /** * Sliding Window k-ary Modular Exponentiation * * Based on {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=27 HAC 14.85} / * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=210 MPM 7.7}. In a departure from those algorithims, * however, this function performs a modular reduction after every multiplication and squaring operation. * As such, this function has the same preconditions that the reductions being used do. * * @template T of Engine * @param Engine $x * @param Engine $e * @param Engine $n * @param class-string $class * @return T */ protected static function slidingWindow(Engine $x, Engine $e, Engine $n, $class) { static $window_ranges = [7, 25, 81, 241, 673, 1793]; // from BigInteger.java's oddModPow function //static $window_ranges = [0, 7, 36, 140, 450, 1303, 3529]; // from MPM 7.3.1 $e_bits = $e->toBits(); $e_length = strlen($e_bits); // calculate the appropriate window size. // $window_size == 3 if $window_ranges is between 25 and 81, for example. for ($i = 0, $window_size = 1; $i < count($window_ranges) && $e_length > $window_ranges[$i]; ++$window_size, ++$i) { } $n_value = $n->value; if (method_exists(static::class, 'generateCustomReduction')) { static::generateCustomReduction($n, $class); } // precompute $this^0 through $this^$window_size $powers = []; $powers[1] = static::prepareReduce($x->value, $n_value, $class); $powers[2] = static::squareReduce($powers[1], $n_value, $class); // we do every other number since substr($e_bits, $i, $j+1) (see below) is supposed to end // in a 1. ie. it's supposed to be odd. $temp = 1 << ($window_size - 1); for ($i = 1; $i < $temp; ++$i) { $i2 = $i << 1; $powers[$i2 + 1] = static::multiplyReduce($powers[$i2 - 1], $powers[2], $n_value, $class); } $result = new $class(1); $result = static::prepareReduce($result->value, $n_value, $class); for ($i = 0; $i < $e_length;) { if (!$e_bits[$i]) { $result = static::squareReduce($result, $n_value, $class); ++$i; } else { for ($j = $window_size - 1; $j > 0; --$j) { if (!empty($e_bits[$i + $j])) { break; } } // eg. the length of substr($e_bits, $i, $j + 1) for ($k = 0; $k <= $j; ++$k) { $result = static::squareReduce($result, $n_value, $class); } $result = static::multiplyReduce($result, $powers[bindec(substr($e_bits, $i, $j + 1))], $n_value, $class); $i += $j + 1; } } $temp = new $class(); $temp->value = static::reduce($result, $n_value, $class); return $temp; } /** * Generates a random number of a certain size * * Bit length is equal to $size * * @param int $size * @return Engine */ public static function random($size) { extract(static::minMaxBits($size)); /** * @var BigInteger $min * @var BigInteger $max */ return static::randomRange($min, $max); } /** * Generates a random prime number of a certain size * * Bit length is equal to $size * * @param int $size * @return Engine */ public static function randomPrime($size) { extract(static::minMaxBits($size)); /** * @var static $min * @var static $max */ return static::randomRangePrime($min, $max); } /** * Performs some pre-processing for randomRangePrime * * @param Engine $min * @param Engine $max * @return static|false */ protected static function randomRangePrimeOuter(Engine $min, Engine $max) { $compare = $max->compare($min); if (!$compare) { return $min->isPrime() ? $min : false; } elseif ($compare < 0) { // if $min is bigger then $max, swap $min and $max $temp = $max; $max = $min; $min = $temp; } $x = static::randomRange($min, $max); return static::randomRangePrimeInner($x, $min, $max); } /** * Generate a random number between a range * * Returns a random number between $min and $max where $min and $max * can be defined using one of the two methods: * * BigInteger::randomRange($min, $max) * BigInteger::randomRange($max, $min) * * @param Engine $min * @param Engine $max * @return Engine */ protected static function randomRangeHelper(Engine $min, Engine $max) { $compare = $max->compare($min); if (!$compare) { return $min; } elseif ($compare < 0) { // if $min is bigger then $max, swap $min and $max $temp = $max; $max = $min; $min = $temp; } if (!isset(static::$one[static::class])) { static::$one[static::class] = new static(1); } $max = $max->subtract($min->subtract(static::$one[static::class])); $size = strlen(ltrim($max->toBytes(), chr(0))); /* doing $random % $max doesn't work because some numbers will be more likely to occur than others. eg. if $max is 140 and $random's max is 255 then that'd mean both $random = 5 and $random = 145 would produce 5 whereas the only value of random that could produce 139 would be 139. ie. not all numbers would be equally likely. some would be more likely than others. creating a whole new random number until you find one that is within the range doesn't work because, for sufficiently small ranges, the likelihood that you'd get a number within that range would be pretty small. eg. with $random's max being 255 and if your $max being 1 the probability would be pretty high that $random would be greater than $max. phpseclib works around this using the technique described here: http://crypto.stackexchange.com/questions/5708/creating-a-small-number-from-a-cryptographically-secure-random-string */ $random_max = new static(chr(1) . str_repeat("\0", $size), 256); $random = new static(Random::string($size), 256); list($max_multiple) = $random_max->divide($max); $max_multiple = $max_multiple->multiply($max); while ($random->compare($max_multiple) >= 0) { $random = $random->subtract($max_multiple); $random_max = $random_max->subtract($max_multiple); $random = $random->bitwise_leftShift(8); $random = $random->add(new static(Random::string(1), 256)); $random_max = $random_max->bitwise_leftShift(8); list($max_multiple) = $random_max->divide($max); $max_multiple = $max_multiple->multiply($max); } list(, $random) = $random->divide($max); return $random->add($min); } /** * Performs some post-processing for randomRangePrime * * @param Engine $x * @param Engine $min * @param Engine $max * @return static|false */ protected static function randomRangePrimeInner(Engine $x, Engine $min, Engine $max) { if (!isset(static::$two[static::class])) { static::$two[static::class] = new static('2'); } $x->make_odd(); if ($x->compare($max) > 0) { // if $x > $max then $max is even and if $min == $max then no prime number exists between the specified range if ($min->equals($max)) { return false; } $x = clone $min; $x->make_odd(); } $initial_x = clone $x; while (true) { if ($x->isPrime()) { return $x; } $x = $x->add(static::$two[static::class]); if ($x->compare($max) > 0) { $x = clone $min; if ($x->equals(static::$two[static::class])) { return $x; } $x->make_odd(); } if ($x->equals($initial_x)) { return false; } } } /** * Sets the $t parameter for primality testing * * @return int */ protected function setupIsPrime() { $length = $this->getLengthInBytes(); // see HAC 4.49 "Note (controlling the error probability)" // @codingStandardsIgnoreStart if ($length >= 163) { $t = 2; } // floor(1300 / 8) else if ($length >= 106) { $t = 3; } // floor( 850 / 8) else if ($length >= 81 ) { $t = 4; } // floor( 650 / 8) else if ($length >= 68 ) { $t = 5; } // floor( 550 / 8) else if ($length >= 56 ) { $t = 6; } // floor( 450 / 8) else if ($length >= 50 ) { $t = 7; } // floor( 400 / 8) else if ($length >= 43 ) { $t = 8; } // floor( 350 / 8) else if ($length >= 37 ) { $t = 9; } // floor( 300 / 8) else if ($length >= 31 ) { $t = 12; } // floor( 250 / 8) else if ($length >= 25 ) { $t = 15; } // floor( 200 / 8) else if ($length >= 18 ) { $t = 18; } // floor( 150 / 8) else { $t = 27; } // @codingStandardsIgnoreEnd return $t; } /** * Tests Primality * * Uses the {@link http://en.wikipedia.org/wiki/Miller%E2%80%93Rabin_primality_test Miller-Rabin primality test}. * See {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap4.pdf#page=8 HAC 4.24} for more info. * * @param int $t * @return bool */ protected function testPrimality($t) { if (!$this->testSmallPrimes()) { return false; } $n = clone $this; $n_1 = $n->subtract(static::$one[static::class]); $n_2 = $n->subtract(static::$two[static::class]); $r = clone $n_1; $s = static::scan1divide($r); for ($i = 0; $i < $t; ++$i) { $a = static::randomRange(static::$two[static::class], $n_2); $y = $a->modPow($r, $n); if (!$y->equals(static::$one[static::class]) && !$y->equals($n_1)) { for ($j = 1; $j < $s && !$y->equals($n_1); ++$j) { $y = $y->modPow(static::$two[static::class], $n); if ($y->equals(static::$one[static::class])) { return false; } } if (!$y->equals($n_1)) { return false; } } } return true; } /** * Checks a numer to see if it's prime * * Assuming the $t parameter is not set, this function has an error rate of 2**-80. The main motivation for the * $t parameter is distributability. BigInteger::randomPrime() can be distributed across multiple pageloads * on a website instead of just one. * * @param int|bool $t * @return bool */ public function isPrime($t = false) { if (!$t) { $t = $this->setupIsPrime(); } return $this->testPrimality($t); } /** * Performs a few preliminary checks on root * * @param int $n * @return Engine */ protected function rootHelper($n) { if ($n < 1) { return clone static::$zero[static::class]; } // we want positive exponents if ($this->compare(static::$one[static::class]) < 0) { return clone static::$zero[static::class]; } // we want positive numbers if ($this->compare(static::$two[static::class]) < 0) { return clone static::$one[static::class]; } // n-th root of 1 or 2 is 1 return $this->rootInner($n); } /** * Calculates the nth root of a biginteger. * * Returns the nth root of a positive biginteger, where n defaults to 2 * * {@internal This function is based off of {@link http://mathforum.org/library/drmath/view/52605.html this page} and {@link http://stackoverflow.com/questions/11242920/calculating-nth-root-with-bcmath-in-php this stackoverflow question}.} * * @param int $n * @return Engine */ protected function rootInner($n) { $n = new static($n); // g is our guess number $g = static::$two[static::class]; // while (g^n < num) g=g*2 while ($g->pow($n)->compare($this) < 0) { $g = $g->multiply(static::$two[static::class]); } // if (g^n==num) num is a power of 2, we're lucky, end of job // == 0 bccomp(bcpow($g, $n), $n->value)==0 if ($g->pow($n)->equals($this) > 0) { $root = $g; return $this->normalize($root); } // if we're here num wasn't a power of 2 :( $og = $g; // og means original guess and here is our upper bound $g = $g->divide(static::$two[static::class])[0]; // g is set to be our lower bound $step = $og->subtract($g)->divide(static::$two[static::class])[0]; // step is the half of upper bound - lower bound $g = $g->add($step); // we start at lower bound + step , basically in the middle of our interval // while step>1 while ($step->compare(static::$one[static::class]) == 1) { $guess = $g->pow($n); $step = $step->divide(static::$two[static::class])[0]; $comp = $guess->compare($this); // compare our guess with real number switch ($comp) { case -1: // if guess is lower we add the new step $g = $g->add($step); break; case 1: // if guess is higher we sub the new step $g = $g->subtract($step); break; case 0: // if guess is exactly the num we're done, we return the value $root = $g; break 2; } } if ($comp == 1) { $g = $g->subtract($step); } // whatever happened, g is the closest guess we can make so return it $root = $g; return $this->normalize($root); } /** * Calculates the nth root of a biginteger. * * @param int $n * @return Engine */ public function root($n = 2) { return $this->rootHelper($n); } /** * Return the minimum BigInteger between an arbitrary number of BigIntegers. * * @param array $nums * @return Engine */ protected static function minHelper(array $nums) { if (count($nums) == 1) { return $nums[0]; } $min = $nums[0]; for ($i = 1; $i < count($nums); $i++) { $min = $min->compare($nums[$i]) > 0 ? $nums[$i] : $min; } return $min; } /** * Return the minimum BigInteger between an arbitrary number of BigIntegers. * * @param array $nums * @return Engine */ protected static function maxHelper(array $nums) { if (count($nums) == 1) { return $nums[0]; } $max = $nums[0]; for ($i = 1; $i < count($nums); $i++) { $max = $max->compare($nums[$i]) < 0 ? $nums[$i] : $max; } return $max; } /** * Create Recurring Modulo Function * * Sometimes it may be desirable to do repeated modulos with the same number outside of * modular exponentiation * * @return callable */ public function createRecurringModuloFunction() { $class = static::class; $fqengine = !method_exists(static::$modexpEngine[static::class], 'reduce') ? '\\phpseclib3\\Math\\BigInteger\\Engines\\' . static::ENGINE_DIR . '\\DefaultEngine' : static::$modexpEngine[static::class]; if (method_exists($fqengine, 'generateCustomReduction')) { $func = $fqengine::generateCustomReduction($this, static::class); return eval('return function(' . static::class . ' $x) use ($func, $class) { $r = new $class(); $r->value = $func($x->value); return $r; };'); } $n = $this->value; return eval('return function(' . static::class . ' $x) use ($n, $fqengine, $class) { $r = new $class(); $r->value = $fqengine::reduce($x->value, $n, $class); return $r; };'); } /** * Calculates the greatest common divisor and Bezout's identity. * * @param Engine $n * @return array{gcd: Engine, x: Engine, y: Engine} */ protected function extendedGCDHelper(Engine $n) { $u = clone $this; $v = clone $n; $one = new static(1); $zero = new static(); $a = clone $one; $b = clone $zero; $c = clone $zero; $d = clone $one; while (!$v->equals($zero)) { list($q) = $u->divide($v); $temp = $u; $u = $v; $v = $temp->subtract($v->multiply($q)); $temp = $a; $a = $c; $c = $temp->subtract($a->multiply($q)); $temp = $b; $b = $d; $d = $temp->subtract($b->multiply($q)); } return [ 'gcd' => $u, 'x' => $a, 'y' => $b ]; } /** * Bitwise Split * * Splits BigInteger's into chunks of $split bits * * @param int $split * @return Engine[] */ public function bitwise_split($split) { if ($split < 1) { throw new \RuntimeException('Offset must be greater than 1'); } $mask = static::$one[static::class]->bitwise_leftShift($split)->subtract(static::$one[static::class]); $num = clone $this; $vals = []; while (!$num->equals(static::$zero[static::class])) { $vals[] = $num->bitwise_and($mask); $num = $num->bitwise_rightShift($split); } return array_reverse($vals); } /** * Logical And * * @param Engine $x * @return Engine */ protected function bitwiseAndHelper(Engine $x) { $left = $this->toBytes(true); $right = $x->toBytes(true); $length = max(strlen($left), strlen($right)); $left = str_pad($left, $length, chr(0), STR_PAD_LEFT); $right = str_pad($right, $length, chr(0), STR_PAD_LEFT); return $this->normalize(new static($left & $right, -256)); } /** * Logical Or * * @param Engine $x * @return Engine */ protected function bitwiseOrHelper(Engine $x) { $left = $this->toBytes(true); $right = $x->toBytes(true); $length = max(strlen($left), strlen($right)); $left = str_pad($left, $length, chr(0), STR_PAD_LEFT); $right = str_pad($right, $length, chr(0), STR_PAD_LEFT); return $this->normalize(new static($left | $right, -256)); } /** * Logical Exclusive Or * * @param Engine $x * @return Engine */ protected function bitwiseXorHelper(Engine $x) { $left = $this->toBytes(true); $right = $x->toBytes(true); $length = max(strlen($left), strlen($right)); $left = str_pad($left, $length, chr(0), STR_PAD_LEFT); $right = str_pad($right, $length, chr(0), STR_PAD_LEFT); return $this->normalize(new static($left ^ $right, -256)); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines; use phpseclib3\Exception\BadConfigurationException; /** * GMP Engine. * * @author Jim Wigginton */ class GMP extends Engine { /** * Can Bitwise operations be done fast? * * @see parent::bitwise_leftRotate() * @see parent::bitwise_rightRotate() */ const FAST_BITWISE = true; /** * Engine Directory * * @see parent::setModExpEngine */ const ENGINE_DIR = 'GMP'; /** * Test for engine validity * * @return bool * @see parent::__construct() */ public static function isValidEngine() { return extension_loaded('gmp'); } /** * Default constructor * * @param mixed $x integer Base-10 number or base-$base number if $base set. * @param int $base * @see parent::__construct() */ public function __construct($x = 0, $base = 10) { if (!isset(static::$isValidEngine[static::class])) { static::$isValidEngine[static::class] = self::isValidEngine(); } if (!static::$isValidEngine[static::class]) { throw new BadConfigurationException('GMP is not setup correctly on this system'); } if ($x instanceof \GMP) { $this->value = $x; return; } $this->value = gmp_init(0); parent::__construct($x, $base); } /** * Initialize a GMP BigInteger Engine instance * * @param int $base * @see parent::__construct() */ protected function initialize($base) { switch (abs($base)) { case 256: $this->value = gmp_import($this->value); if ($this->is_negative) { $this->value = -$this->value; } break; case 16: $temp = $this->is_negative ? '-0x' . $this->value : '0x' . $this->value; $this->value = gmp_init($temp); break; case 10: $this->value = gmp_init(isset($this->value) ? $this->value : '0'); } } /** * Converts a BigInteger to a base-10 number. * * @return string */ public function toString() { return (string)$this->value; } /** * Converts a BigInteger to a bit string (eg. base-2). * * Negative numbers are saved as positive numbers, unless $twos_compliment is set to true, at which point, they're * saved as two's compliment. * * @param bool $twos_compliment * @return string */ public function toBits($twos_compliment = false) { $hex = $this->toHex($twos_compliment); $bits = gmp_strval(gmp_init($hex, 16), 2); if ($this->precision > 0) { $bits = substr($bits, -$this->precision); } if ($twos_compliment && $this->compare(new static()) > 0 && $this->precision <= 0) { return '0' . $bits; } return $bits; } /** * Converts a BigInteger to a byte string (eg. base-256). * * @param bool $twos_compliment * @return string */ public function toBytes($twos_compliment = false) { if ($twos_compliment) { return $this->toBytesHelper(); } if (gmp_cmp($this->value, gmp_init(0)) == 0) { return $this->precision > 0 ? str_repeat(chr(0), ($this->precision + 1) >> 3) : ''; } $temp = gmp_export($this->value); return $this->precision > 0 ? substr(str_pad($temp, $this->precision >> 3, chr(0), STR_PAD_LEFT), -($this->precision >> 3)) : ltrim($temp, chr(0)); } /** * Adds two BigIntegers. * * @param GMP $y * @return GMP */ public function add(GMP $y) { $temp = new self(); $temp->value = $this->value + $y->value; return $this->normalize($temp); } /** * Subtracts two BigIntegers. * * @param GMP $y * @return GMP */ public function subtract(GMP $y) { $temp = new self(); $temp->value = $this->value - $y->value; return $this->normalize($temp); } /** * Multiplies two BigIntegers. * * @param GMP $x * @return GMP */ public function multiply(GMP $x) { $temp = new self(); $temp->value = $this->value * $x->value; return $this->normalize($temp); } /** * Divides two BigIntegers. * * Returns an array whose first element contains the quotient and whose second element contains the * "common residue". If the remainder would be positive, the "common residue" and the remainder are the * same. If the remainder would be negative, the "common residue" is equal to the sum of the remainder * and the divisor (basically, the "common residue" is the first positive modulo). * * @param GMP $y * @return array{GMP, GMP} */ public function divide(GMP $y) { $quotient = new self(); $remainder = new self(); list($quotient->value, $remainder->value) = gmp_div_qr($this->value, $y->value); if (gmp_sign($remainder->value) < 0) { $remainder->value = $remainder->value + gmp_abs($y->value); } return [$this->normalize($quotient), $this->normalize($remainder)]; } /** * Compares two numbers. * * Although one might think !$x->compare($y) means $x != $y, it, in fact, means the opposite. The reason for this * is demonstrated thusly: * * $x > $y: $x->compare($y) > 0 * $x < $y: $x->compare($y) < 0 * $x == $y: $x->compare($y) == 0 * * Note how the same comparison operator is used. If you want to test for equality, use $x->equals($y). * * {@internal Could return $this->subtract($x), but that's not as fast as what we do do.} * * @param GMP $y * @return int in case < 0 if $this is less than $y; > 0 if $this is greater than $y, and 0 if they are equal. * @see self::equals() */ public function compare(GMP $y) { $r = gmp_cmp($this->value, $y->value); if ($r < -1) { $r = -1; } if ($r > 1) { $r = 1; } return $r; } /** * Tests the equality of two numbers. * * If you need to see if one number is greater than or less than another number, use BigInteger::compare() * * @param GMP $x * @return bool */ public function equals(GMP $x) { return $this->value == $x->value; } /** * Calculates modular inverses. * * Say you have (30 mod 17 * x mod 17) mod 17 == 1. x can be found using modular inverses. * * @param GMP $n * @return false|GMP */ public function modInverse(GMP $n) { $temp = new self(); $temp->value = gmp_invert($this->value, $n->value); return $temp->value === false ? false : $this->normalize($temp); } /** * Calculates the greatest common divisor and Bezout's identity. * * Say you have 693 and 609. The GCD is 21. Bezout's identity states that there exist integers x and y such that * 693*x + 609*y == 21. In point of fact, there are actually an infinite number of x and y combinations and which * combination is returned is dependent upon which mode is in use. See * {@link http://en.wikipedia.org/wiki/B%C3%A9zout%27s_identity Bezout's identity - Wikipedia} for more information. * * @param GMP $n * @return GMP[] */ public function extendedGCD(GMP $n) { extract(gmp_gcdext($this->value, $n->value)); return [ 'gcd' => $this->normalize(new self($g)), 'x' => $this->normalize(new self($s)), 'y' => $this->normalize(new self($t)) ]; } /** * Calculates the greatest common divisor * * Say you have 693 and 609. The GCD is 21. * * @param GMP $n * @return GMP */ public function gcd(GMP $n) { $r = gmp_gcd($this->value, $n->value); return $this->normalize(new self($r)); } /** * Absolute value. * * @return GMP */ public function abs() { $temp = new self(); $temp->value = gmp_abs($this->value); return $temp; } /** * Logical And * * @param GMP $x * @return GMP */ public function bitwise_and(GMP $x) { $temp = new self(); $temp->value = $this->value & $x->value; return $this->normalize($temp); } /** * Logical Or * * @param GMP $x * @return GMP */ public function bitwise_or(GMP $x) { $temp = new self(); $temp->value = $this->value | $x->value; return $this->normalize($temp); } /** * Logical Exclusive Or * * @param GMP $x * @return GMP */ public function bitwise_xor(GMP $x) { $temp = new self(); $temp->value = $this->value ^ $x->value; return $this->normalize($temp); } /** * Logical Right Shift * * Shifts BigInteger's by $shift bits, effectively dividing by 2**$shift. * * @param int $shift * @return GMP */ public function bitwise_rightShift($shift) { // 0xFFFFFFFF >> 2 == -1 (on 32-bit systems) // gmp_init('0xFFFFFFFF') >> 2 == gmp_init('0x3FFFFFFF') $temp = new self(); $temp->value = $this->value >> $shift; return $this->normalize($temp); } /** * Logical Left Shift * * Shifts BigInteger's by $shift bits, effectively multiplying by 2**$shift. * * @param int $shift * @return GMP */ public function bitwise_leftShift($shift) { $temp = new self(); $temp->value = $this->value << $shift; return $this->normalize($temp); } /** * Performs modular exponentiation. * * @param GMP $e * @param GMP $n * @return GMP */ public function modPow(GMP $e, GMP $n) { return $this->powModOuter($e, $n); } /** * Performs modular exponentiation. * * Alias for modPow(). * * @param GMP $e * @param GMP $n * @return GMP */ public function powMod(GMP $e, GMP $n) { return $this->powModOuter($e, $n); } /** * Performs modular exponentiation. * * @param GMP $e * @param GMP $n * @return GMP */ protected function powModInner(GMP $e, GMP $n) { $class = static::$modexpEngine[static::class]; return $class::powModHelper($this, $e, $n); } /** * Normalize * * Removes leading zeros and truncates (if necessary) to maintain the appropriate precision * * @param GMP $result * @return GMP */ protected function normalize(GMP $result) { $result->precision = $this->precision; $result->bitmask = $this->bitmask; if ($result->bitmask !== false) { $flip = $result->value < 0; if ($flip) { $result->value = -$result->value; } $result->value = $result->value & $result->bitmask->value; if ($flip) { $result->value = -$result->value; } } return $result; } /** * Performs some post-processing for randomRangePrime * * @param Engine $x * @param Engine $min * @param Engine $max * @return GMP */ protected static function randomRangePrimeInner(Engine $x, Engine $min, Engine $max) { $p = gmp_nextprime($x->value); if ($p <= $max->value) { return new self($p); } if ($min->value != $x->value) { $x = new self($x->value - 1); } return self::randomRangePrime($min, $x); } /** * Generate a random prime number between a range * * If there's not a prime within the given range, false will be returned. * * @param GMP $min * @param GMP $max * @return false|GMP */ public static function randomRangePrime(GMP $min, GMP $max) { return self::randomRangePrimeOuter($min, $max); } /** * Generate a random number between a range * * Returns a random number between $min and $max where $min and $max * can be defined using one of the two methods: * * BigInteger::randomRange($min, $max) * BigInteger::randomRange($max, $min) * * @param GMP $min * @param GMP $max * @return GMP */ public static function randomRange(GMP $min, GMP $max) { return self::randomRangeHelper($min, $max); } /** * Make the current number odd * * If the current number is odd it'll be unchanged. If it's even, one will be added to it. * * @see self::randomPrime() */ protected function make_odd() { gmp_setbit($this->value, 0); } /** * Tests Primality * * @param int $t * @return bool */ protected function testPrimality($t) { return gmp_prob_prime($this->value, $t) != 0; } /** * Calculates the nth root of a biginteger. * * Returns the nth root of a positive biginteger, where n defaults to 2 * * @param int $n * @return GMP */ protected function rootInner($n) { $root = new self(); $root->value = gmp_root($this->value, $n); return $this->normalize($root); } /** * Performs exponentiation. * * @param GMP $n * @return GMP */ public function pow(GMP $n) { $temp = new self(); $temp->value = $this->value ** $n->value; return $this->normalize($temp); } /** * Return the minimum BigInteger between an arbitrary number of BigIntegers. * * @param GMP ...$nums * @return GMP */ public static function min(GMP ...$nums) { return self::minHelper($nums); } /** * Return the maximum BigInteger between an arbitrary number of BigIntegers. * * @param GMP ...$nums * @return GMP */ public static function max(GMP ...$nums) { return self::maxHelper($nums); } /** * Tests BigInteger to see if it is between two integers, inclusive * * @param GMP $min * @param GMP $max * @return bool */ public function between(GMP $min, GMP $max) { return $this->compare($min) >= 0 && $this->compare($max) <= 0; } /** * Create Recurring Modulo Function * * Sometimes it may be desirable to do repeated modulos with the same number outside of * modular exponentiation * * @return callable */ public function createRecurringModuloFunction() { $temp = $this->value; return function (GMP $x) use ($temp) { return new GMP($x->value % $temp); }; } /** * Scan for 1 and right shift by that amount * * ie. $s = gmp_scan1($n, 0) and $r = gmp_div_q($n, gmp_pow(gmp_init('2'), $s)); * * @param GMP $r * @return int */ public static function scan1divide(GMP $r) { $s = gmp_scan1($r->value, 0); $r->value >>= $s; return $s; } /** * Is Odd? * * @return bool */ public function isOdd() { return gmp_testbit($this->value, 0); } /** * Tests if a bit is set * * @return bool */ public function testBit($x) { return gmp_testbit($this->value, $x); } /** * Is Negative? * * @return bool */ public function isNegative() { return gmp_sign($this->value) == -1; } /** * Negate * * Given $k, returns -$k * * @return GMP */ public function negate() { $temp = clone $this; $temp->value = -$this->value; return $temp; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines; use phpseclib3\Common\Functions\Strings; use phpseclib3\Exception\BadConfigurationException; /** * BCMath Engine. * * @author Jim Wigginton */ class BCMath extends Engine { /** * Can Bitwise operations be done fast? * * @see parent::bitwise_leftRotate() * @see parent::bitwise_rightRotate() */ const FAST_BITWISE = false; /** * Engine Directory * * @see parent::setModExpEngine */ const ENGINE_DIR = 'BCMath'; /** * Test for engine validity * * @return bool * @see parent::__construct() */ public static function isValidEngine() { return extension_loaded('bcmath'); } /** * Default constructor * * @param mixed $x integer Base-10 number or base-$base number if $base set. * @param int $base * @see parent::__construct() */ public function __construct($x = 0, $base = 10) { if (!isset(static::$isValidEngine[static::class])) { static::$isValidEngine[static::class] = self::isValidEngine(); } if (!static::$isValidEngine[static::class]) { throw new BadConfigurationException('BCMath is not setup correctly on this system'); } $this->value = '0'; parent::__construct($x, $base); } /** * Initialize a BCMath BigInteger Engine instance * * @param int $base * @see parent::__construct() */ protected function initialize($base) { switch (abs($base)) { case 256: // round $len to the nearest 4 $len = (strlen($this->value) + 3) & ~3; $x = str_pad($this->value, $len, chr(0), STR_PAD_LEFT); $this->value = '0'; for ($i = 0; $i < $len; $i += 4) { $this->value = bcmul($this->value, '4294967296', 0); // 4294967296 == 2**32 $this->value = bcadd( $this->value, 0x1000000 * ord($x[$i]) + ((ord($x[$i + 1]) << 16) | (ord( $x[$i + 2] ) << 8) | ord($x[$i + 3])), 0 ); } if ($this->is_negative) { $this->value = '-' . $this->value; } break; case 16: $x = (strlen($this->value) & 1) ? '0' . $this->value : $this->value; $temp = new self(Strings::hex2bin($x), 256); $this->value = $this->is_negative ? '-' . $temp->value : $temp->value; $this->is_negative = false; break; case 10: // explicitly casting $x to a string is necessary, here, since doing $x[0] on -1 yields different // results then doing it on '-1' does (modInverse does $x[0]) $this->value = $this->value === '-' ? '0' : (string)$this->value; } } /** * Converts a BigInteger to a base-10 number. * * @return string */ public function toString() { if ($this->value === '0') { return '0'; } return ltrim($this->value, '0'); } /** * Converts a BigInteger to a byte string (eg. base-256). * * @param bool $twos_compliment * @return string */ public function toBytes($twos_compliment = false) { if ($twos_compliment) { return $this->toBytesHelper(); } $value = ''; $current = $this->value; if ($current[0] == '-') { $current = substr($current, 1); } while (bccomp($current, '0', 0) > 0) { $temp = bcmod($current, '16777216'); $value = chr($temp >> 16) . chr($temp >> 8) . chr($temp) . $value; $current = bcdiv($current, '16777216', 0); } return $this->precision > 0 ? substr(str_pad($value, $this->precision >> 3, chr(0), STR_PAD_LEFT), -($this->precision >> 3)) : ltrim($value, chr(0)); } /** * Adds two BigIntegers. * * @param BCMath $y * @return BCMath */ public function add(BCMath $y) { $temp = new self(); $temp->value = bcadd($this->value, $y->value); return $this->normalize($temp); } /** * Subtracts two BigIntegers. * * @param BCMath $y * @return BCMath */ public function subtract(BCMath $y) { $temp = new self(); $temp->value = bcsub($this->value, $y->value); return $this->normalize($temp); } /** * Multiplies two BigIntegers. * * @param BCMath $x * @return BCMath */ public function multiply(BCMath $x) { $temp = new self(); $temp->value = bcmul($this->value, $x->value); return $this->normalize($temp); } /** * Divides two BigIntegers. * * Returns an array whose first element contains the quotient and whose second element contains the * "common residue". If the remainder would be positive, the "common residue" and the remainder are the * same. If the remainder would be negative, the "common residue" is equal to the sum of the remainder * and the divisor (basically, the "common residue" is the first positive modulo). * * @param BCMath $y * @return array{static, static} */ public function divide(BCMath $y) { $quotient = new self(); $remainder = new self(); $quotient->value = bcdiv($this->value, $y->value, 0); $remainder->value = bcmod($this->value, $y->value); if ($remainder->value[0] == '-') { $remainder->value = bcadd($remainder->value, $y->value[0] == '-' ? substr($y->value, 1) : $y->value, 0); } return [$this->normalize($quotient), $this->normalize($remainder)]; } /** * Calculates modular inverses. * * Say you have (30 mod 17 * x mod 17) mod 17 == 1. x can be found using modular inverses. * * @param BCMath $n * @return false|BCMath */ public function modInverse(BCMath $n) { return $this->modInverseHelper($n); } /** * Calculates the greatest common divisor and Bezout's identity. * * Say you have 693 and 609. The GCD is 21. Bezout's identity states that there exist integers x and y such that * 693*x + 609*y == 21. In point of fact, there are actually an infinite number of x and y combinations and which * combination is returned is dependent upon which mode is in use. See * {@link http://en.wikipedia.org/wiki/B%C3%A9zout%27s_identity Bezout's identity - Wikipedia} for more information. * * @param BCMath $n * @return array{gcd: static, x: static, y: static} */ public function extendedGCD(BCMath $n) { // it might be faster to use the binary xGCD algorithim here, as well, but (1) that algorithim works // best when the base is a power of 2 and (2) i don't think it'd make much difference, anyway. as is, // the basic extended euclidean algorithim is what we're using. $u = $this->value; $v = $n->value; $a = '1'; $b = '0'; $c = '0'; $d = '1'; while (bccomp($v, '0', 0) != 0) { $q = bcdiv($u, $v, 0); $temp = $u; $u = $v; $v = bcsub($temp, bcmul($v, $q, 0), 0); $temp = $a; $a = $c; $c = bcsub($temp, bcmul($a, $q, 0), 0); $temp = $b; $b = $d; $d = bcsub($temp, bcmul($b, $q, 0), 0); } return [ 'gcd' => $this->normalize(new static($u)), 'x' => $this->normalize(new static($a)), 'y' => $this->normalize(new static($b)) ]; } /** * Calculates the greatest common divisor * * Say you have 693 and 609. The GCD is 21. * * @param BCMath $n * @return BCMath */ public function gcd(BCMath $n) { extract($this->extendedGCD($n)); /** @var BCMath $gcd */ return $gcd; } /** * Absolute value. * * @return BCMath */ public function abs() { $temp = new static(); $temp->value = strlen($this->value) && $this->value[0] == '-' ? substr($this->value, 1) : $this->value; return $temp; } /** * Logical And * * @param BCMath $x * @return BCMath */ public function bitwise_and(BCMath $x) { return $this->bitwiseAndHelper($x); } /** * Logical Or * * @param BCMath $x * @return BCMath */ public function bitwise_or(BCMath $x) { return $this->bitwiseXorHelper($x); } /** * Logical Exclusive Or * * @param BCMath $x * @return BCMath */ public function bitwise_xor(BCMath $x) { return $this->bitwiseXorHelper($x); } /** * Logical Right Shift * * Shifts BigInteger's by $shift bits, effectively dividing by 2**$shift. * * @param int $shift * @return BCMath */ public function bitwise_rightShift($shift) { $temp = new static(); $temp->value = bcdiv($this->value, bcpow('2', $shift, 0), 0); return $this->normalize($temp); } /** * Logical Left Shift * * Shifts BigInteger's by $shift bits, effectively multiplying by 2**$shift. * * @param int $shift * @return BCMath */ public function bitwise_leftShift($shift) { $temp = new static(); $temp->value = bcmul($this->value, bcpow('2', $shift, 0), 0); return $this->normalize($temp); } /** * Compares two numbers. * * Although one might think !$x->compare($y) means $x != $y, it, in fact, means the opposite. The reason for this * is demonstrated thusly: * * $x > $y: $x->compare($y) > 0 * $x < $y: $x->compare($y) < 0 * $x == $y: $x->compare($y) == 0 * * Note how the same comparison operator is used. If you want to test for equality, use $x->equals($y). * * {@internal Could return $this->subtract($x), but that's not as fast as what we do do.} * * @param BCMath $y * @return int in case < 0 if $this is less than $y; > 0 if $this is greater than $y, and 0 if they are equal. * @see self::equals() */ public function compare(BCMath $y) { return bccomp($this->value, $y->value, 0); } /** * Tests the equality of two numbers. * * If you need to see if one number is greater than or less than another number, use BigInteger::compare() * * @param BCMath $x * @return bool */ public function equals(BCMath $x) { return $this->value == $x->value; } /** * Performs modular exponentiation. * * @param BCMath $e * @param BCMath $n * @return BCMath */ public function modPow(BCMath $e, BCMath $n) { return $this->powModOuter($e, $n); } /** * Performs modular exponentiation. * * Alias for modPow(). * * @param BCMath $e * @param BCMath $n * @return BCMath */ public function powMod(BCMath $e, BCMath $n) { return $this->powModOuter($e, $n); } /** * Performs modular exponentiation. * * @param BCMath $e * @param BCMath $n * @return BCMath */ protected function powModInner(BCMath $e, BCMath $n) { try { $class = static::$modexpEngine[static::class]; return $class::powModHelper($this, $e, $n, static::class); } catch (\Exception $err) { return BCMath\DefaultEngine::powModHelper($this, $e, $n, static::class); } } /** * Normalize * * Removes leading zeros and truncates (if necessary) to maintain the appropriate precision * * @param BCMath $result * @return BCMath */ protected function normalize(BCMath $result) { $result->precision = $this->precision; $result->bitmask = $this->bitmask; if ($result->bitmask !== false) { $result->value = bcmod($result->value, $result->bitmask->value); } return $result; } /** * Generate a random prime number between a range * * If there's not a prime within the given range, false will be returned. * * @param BCMath $min * @param BCMath $max * @return false|BCMath */ public static function randomRangePrime(BCMath $min, BCMath $max) { return self::randomRangePrimeOuter($min, $max); } /** * Generate a random number between a range * * Returns a random number between $min and $max where $min and $max * can be defined using one of the two methods: * * BigInteger::randomRange($min, $max) * BigInteger::randomRange($max, $min) * * @param BCMath $min * @param BCMath $max * @return BCMath */ public static function randomRange(BCMath $min, BCMath $max) { return self::randomRangeHelper($min, $max); } /** * Make the current number odd * * If the current number is odd it'll be unchanged. If it's even, one will be added to it. * * @see self::randomPrime() */ protected function make_odd() { if (!$this->isOdd()) { $this->value = bcadd($this->value, '1'); } } /** * Test the number against small primes. * * @see self::isPrime() */ protected function testSmallPrimes() { if ($this->value === '1') { return false; } if ($this->value === '2') { return true; } if ($this->value[strlen($this->value) - 1] % 2 == 0) { return false; } $value = $this->value; foreach (self::PRIMES as $prime) { $r = bcmod($this->value, $prime); if ($r == '0') { return $this->value == $prime; } } return true; } /** * Scan for 1 and right shift by that amount * * ie. $s = gmp_scan1($n, 0) and $r = gmp_div_q($n, gmp_pow(gmp_init('2'), $s)); * * @param BCMath $r * @return int * @see self::isPrime() */ public static function scan1divide(BCMath $r) { $r_value = &$r->value; $s = 0; // if $n was 1, $r would be 0 and this would be an infinite loop, hence our $this->equals(static::$one[static::class]) check earlier while ($r_value[strlen($r_value) - 1] % 2 == 0) { $r_value = bcdiv($r_value, '2', 0); ++$s; } return $s; } /** * Performs exponentiation. * * @param BCMath $n * @return BCMath */ public function pow(BCMath $n) { $temp = new self(); $temp->value = bcpow($this->value, $n->value); return $this->normalize($temp); } /** * Return the minimum BigInteger between an arbitrary number of BigIntegers. * * @param BCMath ...$nums * @return BCMath */ public static function min(BCMath ...$nums) { return self::minHelper($nums); } /** * Return the maximum BigInteger between an arbitrary number of BigIntegers. * * @param BCMath ...$nums * @return BCMath */ public static function max(BCMath ...$nums) { return self::maxHelper($nums); } /** * Tests BigInteger to see if it is between two integers, inclusive * * @param BCMath $min * @param BCMath $max * @return bool */ public function between(BCMath $min, BCMath $max) { return $this->compare($min) >= 0 && $this->compare($max) <= 0; } /** * Set Bitmask * * @param int $bits * @return Engine * @see self::setPrecision() */ protected static function setBitmask($bits) { $temp = parent::setBitmask($bits); return $temp->add(static::$one[static::class]); } /** * Is Odd? * * @return bool */ public function isOdd() { return $this->value[strlen($this->value) - 1] % 2 == 1; } /** * Tests if a bit is set * * @return bool */ public function testBit($x) { return bccomp( bcmod($this->value, bcpow('2', $x + 1, 0)), bcpow('2', $x, 0), 0 ) >= 0; } /** * Is Negative? * * @return bool */ public function isNegative() { return strlen($this->value) && $this->value[0] == '-'; } /** * Negate * * Given $k, returns -$k * * @return BCMath */ public function negate() { $temp = clone $this; if (!strlen($temp->value)) { return $temp; } $temp->value = $temp->value[0] == '-' ? substr($this->value, 1) : '-' . $this->value; return $temp; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines; use phpseclib3\Common\Functions\Strings; use phpseclib3\Exception\BadConfigurationException; /** * Pure-PHP Engine. * * @author Jim Wigginton */ abstract class PHP extends Engine { /**#@+ * Array constants * * Rather than create a thousands and thousands of new BigInteger objects in repeated function calls to add() and * multiply() or whatever, we'll just work directly on arrays, taking them in as parameters and returning them. * */ /** * $result[self::VALUE] contains the value. */ const VALUE = 0; /** * $result[self::SIGN] contains the sign. */ const SIGN = 1; /**#@-*/ /** * Karatsuba Cutoff * * At what point do we switch between Karatsuba multiplication and schoolbook long multiplication? * */ const KARATSUBA_CUTOFF = 25; /** * Can Bitwise operations be done fast? * * @see parent::bitwise_leftRotate() * @see parent::bitwise_rightRotate() */ const FAST_BITWISE = true; /** * Engine Directory * * @see parent::setModExpEngine */ const ENGINE_DIR = 'PHP'; /** * Default constructor * * @param mixed $x integer Base-10 number or base-$base number if $base set. * @param int $base * @return PHP * @see parent::__construct() */ public function __construct($x = 0, $base = 10) { if (!isset(static::$isValidEngine[static::class])) { static::$isValidEngine[static::class] = static::isValidEngine(); } if (!static::$isValidEngine[static::class]) { throw new BadConfigurationException(static::class . ' is not setup correctly on this system'); } $this->value = []; parent::__construct($x, $base); } /** * Initialize a PHP BigInteger Engine instance * * @param int $base * @see parent::__construct() */ protected function initialize($base) { switch (abs($base)) { case 16: $x = (strlen($this->value) & 1) ? '0' . $this->value : $this->value; $temp = new static(Strings::hex2bin($x), 256); $this->value = $temp->value; break; case 10: $temp = new static(); $multiplier = new static(); $multiplier->value = [static::MAX10]; $x = $this->value; if ($x[0] == '-') { $this->is_negative = true; $x = substr($x, 1); } $x = str_pad( $x, strlen($x) + ((static::MAX10LEN - 1) * strlen($x)) % static::MAX10LEN, 0, STR_PAD_LEFT ); while (strlen($x)) { $temp = $temp->multiply($multiplier); $temp = $temp->add(new static($this->int2bytes(substr($x, 0, static::MAX10LEN)), 256)); $x = substr($x, static::MAX10LEN); } $this->value = $temp->value; } } /** * Pads strings so that unpack may be used on them * * @param string $str * @return string */ protected function pad($str) { $length = strlen($str); $pad = 4 - (strlen($str) % 4); return str_pad($str, $length + $pad, "\0", STR_PAD_LEFT); } /** * Converts a BigInteger to a base-10 number. * * @return string */ public function toString() { if (!count($this->value)) { return '0'; } $temp = clone $this; $temp->bitmask = false; $temp->is_negative = false; $divisor = new static(); $divisor->value = [static::MAX10]; $result = ''; while (count($temp->value)) { list($temp, $mod) = $temp->divide($divisor); $result = str_pad( isset($mod->value[0]) ? $mod->value[0] : '', static::MAX10LEN, '0', STR_PAD_LEFT ) . $result; } $result = ltrim($result, '0'); if (empty($result)) { $result = '0'; } if ($this->is_negative) { $result = '-' . $result; } return $result; } /** * Converts a BigInteger to a byte string (eg. base-256). * * @param bool $twos_compliment * @return string */ public function toBytes($twos_compliment = false) { if ($twos_compliment) { return $this->toBytesHelper(); } if (!count($this->value)) { return $this->precision > 0 ? str_repeat(chr(0), ($this->precision + 1) >> 3) : ''; } $result = $this->bitwise_small_split(8); $result = implode('', array_map('chr', $result)); return $this->precision > 0 ? str_pad( substr($result, -(($this->precision + 7) >> 3)), ($this->precision + 7) >> 3, chr(0), STR_PAD_LEFT ) : $result; } /** * Performs addition. * * @param array $x_value * @param bool $x_negative * @param array $y_value * @param bool $y_negative * @return array */ protected static function addHelper(array $x_value, $x_negative, array $y_value, $y_negative) { $x_size = count($x_value); $y_size = count($y_value); if ($x_size == 0) { return [ self::VALUE => $y_value, self::SIGN => $y_negative ]; } elseif ($y_size == 0) { return [ self::VALUE => $x_value, self::SIGN => $x_negative ]; } // subtract, if appropriate if ($x_negative != $y_negative) { if ($x_value == $y_value) { return [ self::VALUE => [], self::SIGN => false ]; } $temp = self::subtractHelper($x_value, false, $y_value, false); $temp[self::SIGN] = self::compareHelper($x_value, false, $y_value, false) > 0 ? $x_negative : $y_negative; return $temp; } if ($x_size < $y_size) { $size = $x_size; $value = $y_value; } else { $size = $y_size; $value = $x_value; } $value[count($value)] = 0; // just in case the carry adds an extra digit $carry = 0; for ($i = 0, $j = 1; $j < $size; $i += 2, $j += 2) { //$sum = $x_value[$j] * static::BASE_FULL + $x_value[$i] + $y_value[$j] * static::BASE_FULL + $y_value[$i] + $carry; $sum = ($x_value[$j] + $y_value[$j]) * static::BASE_FULL + $x_value[$i] + $y_value[$i] + $carry; $carry = $sum >= static::MAX_DIGIT2; // eg. floor($sum / 2**52); only possible values (in any base) are 0 and 1 $sum = $carry ? $sum - static::MAX_DIGIT2 : $sum; $temp = static::BASE === 26 ? intval($sum / 0x4000000) : ($sum >> 31); $value[$i] = (int)($sum - static::BASE_FULL * $temp); // eg. a faster alternative to fmod($sum, 0x4000000) $value[$j] = $temp; } if ($j == $size) { // ie. if $y_size is odd $sum = $x_value[$i] + $y_value[$i] + $carry; $carry = $sum >= static::BASE_FULL; $value[$i] = $carry ? $sum - static::BASE_FULL : $sum; ++$i; // ie. let $i = $j since we've just done $value[$i] } if ($carry) { for (; $value[$i] == static::MAX_DIGIT; ++$i) { $value[$i] = 0; } ++$value[$i]; } return [ self::VALUE => self::trim($value), self::SIGN => $x_negative ]; } /** * Performs subtraction. * * @param array $x_value * @param bool $x_negative * @param array $y_value * @param bool $y_negative * @return array */ public static function subtractHelper(array $x_value, $x_negative, array $y_value, $y_negative) { $x_size = count($x_value); $y_size = count($y_value); if ($x_size == 0) { return [ self::VALUE => $y_value, self::SIGN => !$y_negative ]; } elseif ($y_size == 0) { return [ self::VALUE => $x_value, self::SIGN => $x_negative ]; } // add, if appropriate (ie. -$x - +$y or +$x - -$y) if ($x_negative != $y_negative) { $temp = self::addHelper($x_value, false, $y_value, false); $temp[self::SIGN] = $x_negative; return $temp; } $diff = self::compareHelper($x_value, $x_negative, $y_value, $y_negative); if (!$diff) { return [ self::VALUE => [], self::SIGN => false ]; } // switch $x and $y around, if appropriate. if ((!$x_negative && $diff < 0) || ($x_negative && $diff > 0)) { $temp = $x_value; $x_value = $y_value; $y_value = $temp; $x_negative = !$x_negative; $x_size = count($x_value); $y_size = count($y_value); } // at this point, $x_value should be at least as big as - if not bigger than - $y_value $carry = 0; for ($i = 0, $j = 1; $j < $y_size; $i += 2, $j += 2) { $sum = ($x_value[$j] - $y_value[$j]) * static::BASE_FULL + $x_value[$i] - $y_value[$i] - $carry; $carry = $sum < 0; // eg. floor($sum / 2**52); only possible values (in any base) are 0 and 1 $sum = $carry ? $sum + static::MAX_DIGIT2 : $sum; $temp = static::BASE === 26 ? intval($sum / 0x4000000) : ($sum >> 31); $x_value[$i] = (int)($sum - static::BASE_FULL * $temp); $x_value[$j] = $temp; } if ($j == $y_size) { // ie. if $y_size is odd $sum = $x_value[$i] - $y_value[$i] - $carry; $carry = $sum < 0; $x_value[$i] = $carry ? $sum + static::BASE_FULL : $sum; ++$i; } if ($carry) { for (; !$x_value[$i]; ++$i) { $x_value[$i] = static::MAX_DIGIT; } --$x_value[$i]; } return [ self::VALUE => self::trim($x_value), self::SIGN => $x_negative ]; } /** * Performs multiplication. * * @param array $x_value * @param bool $x_negative * @param array $y_value * @param bool $y_negative * @return array */ protected static function multiplyHelper(array $x_value, $x_negative, array $y_value, $y_negative) { //if ( $x_value == $y_value ) { // return [ // self::VALUE => self::square($x_value), // self::SIGN => $x_sign != $y_value // ]; //} $x_length = count($x_value); $y_length = count($y_value); if (!$x_length || !$y_length) { // a 0 is being multiplied return [ self::VALUE => [], self::SIGN => false ]; } return [ self::VALUE => min($x_length, $y_length) < 2 * self::KARATSUBA_CUTOFF ? self::trim(self::regularMultiply($x_value, $y_value)) : self::trim(self::karatsuba($x_value, $y_value)), self::SIGN => $x_negative != $y_negative ]; } /** * Performs Karatsuba multiplication on two BigIntegers * * See {@link http://en.wikipedia.org/wiki/Karatsuba_algorithm Karatsuba algorithm} and * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=120 MPM 5.2.3}. * * @param array $x_value * @param array $y_value * @return array */ private static function karatsuba(array $x_value, array $y_value) { $m = min(count($x_value) >> 1, count($y_value) >> 1); if ($m < self::KARATSUBA_CUTOFF) { return self::regularMultiply($x_value, $y_value); } $x1 = array_slice($x_value, $m); $x0 = array_slice($x_value, 0, $m); $y1 = array_slice($y_value, $m); $y0 = array_slice($y_value, 0, $m); $z2 = self::karatsuba($x1, $y1); $z0 = self::karatsuba($x0, $y0); $z1 = self::addHelper($x1, false, $x0, false); $temp = self::addHelper($y1, false, $y0, false); $z1 = self::karatsuba($z1[self::VALUE], $temp[self::VALUE]); $temp = self::addHelper($z2, false, $z0, false); $z1 = self::subtractHelper($z1, false, $temp[self::VALUE], false); $z2 = array_merge(array_fill(0, 2 * $m, 0), $z2); $z1[self::VALUE] = array_merge(array_fill(0, $m, 0), $z1[self::VALUE]); $xy = self::addHelper($z2, false, $z1[self::VALUE], $z1[self::SIGN]); $xy = self::addHelper($xy[self::VALUE], $xy[self::SIGN], $z0, false); return $xy[self::VALUE]; } /** * Performs long multiplication on two BigIntegers * * Modeled after 'multiply' in MutableBigInteger.java. * * @param array $x_value * @param array $y_value * @return array */ protected static function regularMultiply(array $x_value, array $y_value) { $x_length = count($x_value); $y_length = count($y_value); if (!$x_length || !$y_length) { // a 0 is being multiplied return []; } $product_value = self::array_repeat(0, $x_length + $y_length); // the following for loop could be removed if the for loop following it // (the one with nested for loops) initially set $i to 0, but // doing so would also make the result in one set of unnecessary adds, // since on the outermost loops first pass, $product->value[$k] is going // to always be 0 $carry = 0; for ($j = 0; $j < $x_length; ++$j) { // ie. $i = 0 $temp = $x_value[$j] * $y_value[0] + $carry; // $product_value[$k] == 0 $carry = static::BASE === 26 ? intval($temp / 0x4000000) : ($temp >> 31); $product_value[$j] = (int)($temp - static::BASE_FULL * $carry); } $product_value[$j] = $carry; // the above for loop is what the previous comment was talking about. the // following for loop is the "one with nested for loops" for ($i = 1; $i < $y_length; ++$i) { $carry = 0; for ($j = 0, $k = $i; $j < $x_length; ++$j, ++$k) { $temp = $product_value[$k] + $x_value[$j] * $y_value[$i] + $carry; $carry = static::BASE === 26 ? intval($temp / 0x4000000) : ($temp >> 31); $product_value[$k] = (int)($temp - static::BASE_FULL * $carry); } $product_value[$k] = $carry; } return $product_value; } /** * Divides two BigIntegers. * * Returns an array whose first element contains the quotient and whose second element contains the * "common residue". If the remainder would be positive, the "common residue" and the remainder are the * same. If the remainder would be negative, the "common residue" is equal to the sum of the remainder * and the divisor (basically, the "common residue" is the first positive modulo). * * @return array{static, static} * @internal This function is based off of * {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=9 HAC 14.20}. */ protected function divideHelper(PHP $y) { if (count($y->value) == 1) { list($q, $r) = $this->divide_digit($this->value, $y->value[0]); $quotient = new static(); $remainder = new static(); $quotient->value = $q; $remainder->value = [$r]; $quotient->is_negative = $this->is_negative != $y->is_negative; return [$this->normalize($quotient), $this->normalize($remainder)]; } $x = clone $this; $y = clone $y; $x_sign = $x->is_negative; $y_sign = $y->is_negative; $x->is_negative = $y->is_negative = false; $diff = $x->compare($y); if (!$diff) { $temp = new static(); $temp->value = [1]; $temp->is_negative = $x_sign != $y_sign; return [$this->normalize($temp), $this->normalize(static::$zero[static::class])]; } if ($diff < 0) { // if $x is negative, "add" $y. if ($x_sign) { $x = $y->subtract($x); } return [$this->normalize(static::$zero[static::class]), $this->normalize($x)]; } // normalize $x and $y as described in HAC 14.23 / 14.24 $msb = $y->value[count($y->value) - 1]; for ($shift = 0; !($msb & static::MSB); ++$shift) { $msb <<= 1; } $x->lshift($shift); $y->lshift($shift); $y_value = &$y->value; $x_max = count($x->value) - 1; $y_max = count($y->value) - 1; $quotient = new static(); $quotient_value = &$quotient->value; $quotient_value = self::array_repeat(0, $x_max - $y_max + 1); static $temp, $lhs, $rhs; if (!isset($temp)) { $temp = new static(); $lhs = new static(); $rhs = new static(); } if (static::class != get_class($temp)) { $temp = new static(); $lhs = new static(); $rhs = new static(); } $temp_value = &$temp->value; $rhs_value = &$rhs->value; // $temp = $y << ($x_max - $y_max-1) in base 2**26 $temp_value = array_merge(self::array_repeat(0, $x_max - $y_max), $y_value); while ($x->compare($temp) >= 0) { // calculate the "common residue" ++$quotient_value[$x_max - $y_max]; $x = $x->subtract($temp); $x_max = count($x->value) - 1; } for ($i = $x_max; $i >= $y_max + 1; --$i) { $x_value = &$x->value; $x_window = [ isset($x_value[$i]) ? $x_value[$i] : 0, isset($x_value[$i - 1]) ? $x_value[$i - 1] : 0, isset($x_value[$i - 2]) ? $x_value[$i - 2] : 0 ]; $y_window = [ $y_value[$y_max], ($y_max > 0) ? $y_value[$y_max - 1] : 0 ]; $q_index = $i - $y_max - 1; if ($x_window[0] == $y_window[0]) { $quotient_value[$q_index] = static::MAX_DIGIT; } else { $quotient_value[$q_index] = self::safe_divide( $x_window[0] * static::BASE_FULL + $x_window[1], $y_window[0] ); } $temp_value = [$y_window[1], $y_window[0]]; $lhs->value = [$quotient_value[$q_index]]; $lhs = $lhs->multiply($temp); $rhs_value = [$x_window[2], $x_window[1], $x_window[0]]; while ($lhs->compare($rhs) > 0) { --$quotient_value[$q_index]; $lhs->value = [$quotient_value[$q_index]]; $lhs = $lhs->multiply($temp); } $adjust = self::array_repeat(0, $q_index); $temp_value = [$quotient_value[$q_index]]; $temp = $temp->multiply($y); $temp_value = &$temp->value; if (count($temp_value)) { $temp_value = array_merge($adjust, $temp_value); } $x = $x->subtract($temp); if ($x->compare(static::$zero[static::class]) < 0) { $temp_value = array_merge($adjust, $y_value); $x = $x->add($temp); --$quotient_value[$q_index]; } $x_max = count($x_value) - 1; } // unnormalize the remainder $x->rshift($shift); $quotient->is_negative = $x_sign != $y_sign; // calculate the "common residue", if appropriate if ($x_sign) { $y->rshift($shift); $x = $y->subtract($x); } return [$this->normalize($quotient), $this->normalize($x)]; } /** * Divides a BigInteger by a regular integer * * abc / x = a00 / x + b0 / x + c / x * * @param array $dividend * @param int $divisor * @return array */ private static function divide_digit(array $dividend, $divisor) { $carry = 0; $result = []; for ($i = count($dividend) - 1; $i >= 0; --$i) { $temp = static::BASE_FULL * $carry + $dividend[$i]; $result[$i] = self::safe_divide($temp, $divisor); $carry = (int)($temp - $divisor * $result[$i]); } return [$result, $carry]; } /** * Single digit division * * Even if int64 is being used the division operator will return a float64 value * if the dividend is not evenly divisible by the divisor. Since a float64 doesn't * have the precision of int64 this is a problem so, when int64 is being used, * we'll guarantee that the dividend is divisible by first subtracting the remainder. * * @param int $x * @param int $y * @return int */ private static function safe_divide($x, $y) { if (static::BASE === 26) { return (int)($x / $y); } // static::BASE === 31 /** @var int */ return ($x - ($x % $y)) / $y; } /** * Convert an array / boolean to a PHP BigInteger object * * @param array $arr * @return static */ protected function convertToObj(array $arr) { $result = new static(); $result->value = $arr[self::VALUE]; $result->is_negative = $arr[self::SIGN]; return $this->normalize($result); } /** * Normalize * * Removes leading zeros and truncates (if necessary) to maintain the appropriate precision * * @param PHP $result * @return static */ protected function normalize(PHP $result) { $result->precision = $this->precision; $result->bitmask = $this->bitmask; $value = &$result->value; if (!count($value)) { $result->is_negative = false; return $result; } $value = static::trim($value); if (!empty($result->bitmask->value)) { $length = min(count($value), count($result->bitmask->value)); $value = array_slice($value, 0, $length); for ($i = 0; $i < $length; ++$i) { $value[$i] = $value[$i] & $result->bitmask->value[$i]; } $value = static::trim($value); } return $result; } /** * Compares two numbers. * * @param array $x_value * @param bool $x_negative * @param array $y_value * @param bool $y_negative * @return int * @see static::compare() */ protected static function compareHelper(array $x_value, $x_negative, array $y_value, $y_negative) { if ($x_negative != $y_negative) { return (!$x_negative && $y_negative) ? 1 : -1; } $result = $x_negative ? -1 : 1; if (count($x_value) != count($y_value)) { return (count($x_value) > count($y_value)) ? $result : -$result; } $size = max(count($x_value), count($y_value)); $x_value = array_pad($x_value, $size, 0); $y_value = array_pad($y_value, $size, 0); for ($i = count($x_value) - 1; $i >= 0; --$i) { if ($x_value[$i] != $y_value[$i]) { return ($x_value[$i] > $y_value[$i]) ? $result : -$result; } } return 0; } /** * Absolute value. * * @return PHP */ public function abs() { $temp = new static(); $temp->value = $this->value; return $temp; } /** * Trim * * Removes leading zeros * * @param list $value * @return list */ protected static function trim(array $value) { for ($i = count($value) - 1; $i >= 0; --$i) { if ($value[$i]) { break; } unset($value[$i]); } return $value; } /** * Logical Right Shift * * Shifts BigInteger's by $shift bits, effectively dividing by 2**$shift. * * @param int $shift * @return PHP */ public function bitwise_rightShift($shift) { $temp = new static(); // could just replace lshift with this, but then all lshift() calls would need to be rewritten // and I don't want to do that... $temp->value = $this->value; $temp->rshift($shift); return $this->normalize($temp); } /** * Logical Left Shift * * Shifts BigInteger's by $shift bits, effectively multiplying by 2**$shift. * * @param int $shift * @return PHP */ public function bitwise_leftShift($shift) { $temp = new static(); // could just replace _rshift with this, but then all _lshift() calls would need to be rewritten // and I don't want to do that... $temp->value = $this->value; $temp->lshift($shift); return $this->normalize($temp); } /** * Converts 32-bit integers to bytes. * * @param int $x * @return string */ private static function int2bytes($x) { return ltrim(pack('N', $x), chr(0)); } /** * Array Repeat * * @param int $input * @param int $multiplier * @return array */ protected static function array_repeat($input, $multiplier) { return $multiplier ? array_fill(0, $multiplier, $input) : []; } /** * Logical Left Shift * * Shifts BigInteger's by $shift bits. * * @param int $shift */ protected function lshift($shift) { if ($shift == 0) { return; } $num_digits = (int)($shift / static::BASE); $shift %= static::BASE; $shift = 1 << $shift; $carry = 0; for ($i = 0; $i < count($this->value); ++$i) { $temp = $this->value[$i] * $shift + $carry; $carry = static::BASE === 26 ? intval($temp / 0x4000000) : ($temp >> 31); $this->value[$i] = (int)($temp - $carry * static::BASE_FULL); } if ($carry) { $this->value[count($this->value)] = $carry; } while ($num_digits--) { array_unshift($this->value, 0); } } /** * Logical Right Shift * * Shifts BigInteger's by $shift bits. * * @param int $shift */ protected function rshift($shift) { if ($shift == 0) { return; } $num_digits = (int)($shift / static::BASE); $shift %= static::BASE; $carry_shift = static::BASE - $shift; $carry_mask = (1 << $shift) - 1; if ($num_digits) { $this->value = array_slice($this->value, $num_digits); } $carry = 0; for ($i = count($this->value) - 1; $i >= 0; --$i) { $temp = $this->value[$i] >> $shift | $carry; $carry = ($this->value[$i] & $carry_mask) << $carry_shift; $this->value[$i] = $temp; } $this->value = static::trim($this->value); } /** * Performs modular exponentiation. * * @param PHP $e * @param PHP $n * @return PHP */ protected function powModInner(PHP $e, PHP $n) { try { $class = static::$modexpEngine[static::class]; return $class::powModHelper($this, $e, $n, static::class); } catch (\Exception $err) { return PHP\DefaultEngine::powModHelper($this, $e, $n, static::class); } } /** * Performs squaring * * @param list $x * @return list */ protected static function square(array $x) { return count($x) < 2 * self::KARATSUBA_CUTOFF ? self::trim(self::baseSquare($x)) : self::trim(self::karatsubaSquare($x)); } /** * Performs traditional squaring on two BigIntegers * * Squaring can be done faster than multiplying a number by itself can be. See * {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=7 HAC 14.2.4} / * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=141 MPM 5.3} for more information. * * @param array $value * @return array */ protected static function baseSquare(array $value) { if (empty($value)) { return []; } $square_value = self::array_repeat(0, 2 * count($value)); for ($i = 0, $max_index = count($value) - 1; $i <= $max_index; ++$i) { $i2 = $i << 1; $temp = $square_value[$i2] + $value[$i] * $value[$i]; $carry = static::BASE === 26 ? intval($temp / 0x4000000) : ($temp >> 31); $square_value[$i2] = (int)($temp - static::BASE_FULL * $carry); // note how we start from $i+1 instead of 0 as we do in multiplication. for ($j = $i + 1, $k = $i2 + 1; $j <= $max_index; ++$j, ++$k) { $temp = $square_value[$k] + 2 * $value[$j] * $value[$i] + $carry; $carry = static::BASE === 26 ? intval($temp / 0x4000000) : ($temp >> 31); $square_value[$k] = (int)($temp - static::BASE_FULL * $carry); } // the following line can yield values larger 2**15. at this point, PHP should switch // over to floats. $square_value[$i + $max_index + 1] = $carry; } return $square_value; } /** * Performs Karatsuba "squaring" on two BigIntegers * * See {@link http://en.wikipedia.org/wiki/Karatsuba_algorithm Karatsuba algorithm} and * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=151 MPM 5.3.4}. * * @param array $value * @return array */ protected static function karatsubaSquare(array $value) { $m = count($value) >> 1; if ($m < self::KARATSUBA_CUTOFF) { return self::baseSquare($value); } $x1 = array_slice($value, $m); $x0 = array_slice($value, 0, $m); $z2 = self::karatsubaSquare($x1); $z0 = self::karatsubaSquare($x0); $z1 = self::addHelper($x1, false, $x0, false); $z1 = self::karatsubaSquare($z1[self::VALUE]); $temp = self::addHelper($z2, false, $z0, false); $z1 = self::subtractHelper($z1, false, $temp[self::VALUE], false); $z2 = array_merge(array_fill(0, 2 * $m, 0), $z2); $z1[self::VALUE] = array_merge(array_fill(0, $m, 0), $z1[self::VALUE]); $xx = self::addHelper($z2, false, $z1[self::VALUE], $z1[self::SIGN]); $xx = self::addHelper($xx[self::VALUE], $xx[self::SIGN], $z0, false); return $xx[self::VALUE]; } /** * Make the current number odd * * If the current number is odd it'll be unchanged. If it's even, one will be added to it. * * @see self::randomPrime() */ protected function make_odd() { $this->value[0] |= 1; } /** * Test the number against small primes. * * @see self::isPrime() */ protected function testSmallPrimes() { if ($this->value == [1]) { return false; } if ($this->value == [2]) { return true; } if (~$this->value[0] & 1) { return false; } $value = $this->value; foreach (static::PRIMES as $prime) { list(, $r) = self::divide_digit($value, $prime); if (!$r) { return count($value) == 1 && $value[0] == $prime; } } return true; } /** * Scan for 1 and right shift by that amount * * ie. $s = gmp_scan1($n, 0) and $r = gmp_div_q($n, gmp_pow(gmp_init('2'), $s)); * * @param PHP $r * @return int * @see self::isPrime() */ public static function scan1divide(PHP $r) { $r_value = &$r->value; for ($i = 0, $r_length = count($r_value); $i < $r_length; ++$i) { $temp = ~$r_value[$i] & static::MAX_DIGIT; for ($j = 1; ($temp >> $j) & 1; ++$j) { } if ($j <= static::BASE) { break; } } $s = static::BASE * $i + $j; $r->rshift($s); return $s; } /** * Performs exponentiation. * * @param PHP $n * @return PHP */ protected function powHelper(PHP $n) { if ($n->compare(static::$zero[static::class]) == 0) { return new static(1); } // n^0 = 1 $temp = clone $this; while (!$n->equals(static::$one[static::class])) { $temp = $temp->multiply($this); $n = $n->subtract(static::$one[static::class]); } return $temp; } /** * Is Odd? * * @return bool */ public function isOdd() { return (bool)($this->value[0] & 1); } /** * Tests if a bit is set * * @return bool */ public function testBit($x) { $digit = (int) floor($x / static::BASE); $bit = $x % static::BASE; if (!isset($this->value[$digit])) { return false; } return (bool)($this->value[$digit] & (1 << $bit)); } /** * Is Negative? * * @return bool */ public function isNegative() { return $this->is_negative; } /** * Negate * * Given $k, returns -$k * * @return static */ public function negate() { $temp = clone $this; $temp->is_negative = !$temp->is_negative; return $temp; } /** * Bitwise Split * * Splits BigInteger's into chunks of $split bits * * @param int $split * @return list */ public function bitwise_split($split) { if ($split < 1) { throw new \RuntimeException('Offset must be greater than 1'); } $width = (int)($split / static::BASE); if (!$width) { $arr = $this->bitwise_small_split($split); return array_map(function ($digit) { $temp = new static(); $temp->value = $digit != 0 ? [$digit] : []; return $temp; }, $arr); } $vals = []; $val = $this->value; $i = $overflow = 0; $len = count($val); while ($i < $len) { $digit = []; if (!$overflow) { $digit = array_slice($val, $i, $width); $i += $width; $overflow = $split % static::BASE; if ($overflow) { $mask = (1 << $overflow) - 1; $temp = isset($val[$i]) ? $val[$i] : 0; $digit[] = $temp & $mask; } } else { $remaining = static::BASE - $overflow; $tempsplit = $split - $remaining; $tempwidth = (int)($tempsplit / static::BASE + 1); $digit = array_slice($val, $i, $tempwidth); $i += $tempwidth; $tempoverflow = $tempsplit % static::BASE; if ($tempoverflow) { $tempmask = (1 << $tempoverflow) - 1; $temp = isset($val[$i]) ? $val[$i] : 0; $digit[] = $temp & $tempmask; } $newbits = 0; for ($j = count($digit) - 1; $j >= 0; $j--) { $temp = $digit[$j] & $mask; $digit[$j] = ($digit[$j] >> $overflow) | ($newbits << $remaining); $newbits = $temp; } $overflow = $tempoverflow; $mask = $tempmask; } $temp = new static(); $temp->value = static::trim($digit); $vals[] = $temp; } return array_reverse($vals); } /** * Bitwise Split where $split < static::BASE * * @param int $split * @return list */ private function bitwise_small_split($split) { $vals = []; $val = $this->value; $mask = (1 << $split) - 1; $i = $overflow = 0; $len = count($val); $val[] = 0; $remaining = static::BASE; while ($i != $len) { $digit = $val[$i] & $mask; $val[$i] >>= $split; if (!$overflow) { $remaining -= $split; $overflow = $split <= $remaining ? 0 : $split - $remaining; if (!$remaining) { $i++; $remaining = static::BASE; $overflow = 0; } } elseif (++$i != $len) { $tempmask = (1 << $overflow) - 1; $digit |= ($val[$i] & $tempmask) << $remaining; $val[$i] >>= $overflow; $remaining = static::BASE - $overflow; $overflow = $split <= $remaining ? 0 : $split - $remaining; } $vals[] = $digit; } while ($vals[count($vals) - 1] == 0) { unset($vals[count($vals) - 1]); } return array_reverse($vals); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\GMP; use phpseclib3\Math\BigInteger\Engines\GMP; /** * GMP Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class DefaultEngine extends GMP { /** * Performs modular exponentiation. * * @param GMP $x * @param GMP $e * @param GMP $n * @return GMP */ protected static function powModHelper(GMP $x, GMP $e, GMP $n) { $temp = new GMP(); $temp->value = gmp_powm($x->value, $e->value, $n->value); return $x->normalize($temp); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\PHP; use phpseclib3\Math\BigInteger\Engines\PHP\Reductions\EvalBarrett; /** * PHP Default Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class DefaultEngine extends EvalBarrett { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\PHP; use phpseclib3\Math\BigInteger\Engines\OpenSSL as Progenitor; /** * OpenSSL Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class OpenSSL extends Progenitor { } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\PHP\Reductions; use phpseclib3\Math\BigInteger\Engines\PHP\Base; /** * PHP Classic Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class Classic extends Base { /** * Regular Division * * @param array $x * @param array $n * @param string $class * @return array */ protected static function reduce(array $x, array $n, $class) { $lhs = new $class(); $lhs->value = $x; $rhs = new $class(); $rhs->value = $n; list(, $temp) = $lhs->divide($rhs); return $temp->value; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\PHP\Reductions; use phpseclib3\Math\BigInteger\Engines\PHP; /** * PHP Montgomery Modular Exponentiation Engine with interleaved multiplication * * @author Jim Wigginton */ abstract class MontgomeryMult extends Montgomery { /** * Montgomery Multiply * * Interleaves the montgomery reduction and long multiplication algorithms together as described in * {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=13 HAC 14.36} * * @see self::_prepMontgomery() * @see self::_montgomery() * @param array $x * @param array $y * @param array $m * @param class-string $class * @return array */ public static function multiplyReduce(array $x, array $y, array $m, $class) { // the following code, although not callable, can be run independently of the above code // although the above code performed better in my benchmarks the following could might // perform better under different circumstances. in lieu of deleting it it's just been // made uncallable static $cache = [ self::VARIABLE => [], self::DATA => [] ]; if (($key = array_search($m, $cache[self::VARIABLE])) === false) { $key = count($cache[self::VARIABLE]); $cache[self::VARIABLE][] = $m; $cache[self::DATA][] = self::modInverse67108864($m, $class); } $n = max(count($x), count($y), count($m)); $x = array_pad($x, $n, 0); $y = array_pad($y, $n, 0); $m = array_pad($m, $n, 0); $a = [self::VALUE => self::array_repeat(0, $n + 1)]; for ($i = 0; $i < $n; ++$i) { $temp = $a[self::VALUE][0] + $x[$i] * $y[0]; $temp = $temp - $class::BASE_FULL * ($class::BASE === 26 ? intval($temp / 0x4000000) : ($temp >> 31)); $temp = $temp * $cache[self::DATA][$key]; $temp = $temp - $class::BASE_FULL * ($class::BASE === 26 ? intval($temp / 0x4000000) : ($temp >> 31)); $temp = $class::addHelper($class::regularMultiply([$x[$i]], $y), false, $class::regularMultiply([$temp], $m), false); $a = $class::addHelper($a[self::VALUE], false, $temp[self::VALUE], false); $a[self::VALUE] = array_slice($a[self::VALUE], 1); } if (self::compareHelper($a[self::VALUE], false, $m, false) >= 0) { $a = $class::subtractHelper($a[self::VALUE], false, $m, false); } return $a[self::VALUE]; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\PHP\Reductions; use phpseclib3\Math\BigInteger\Engines\PHP\Base; /** * PHP Power Of Two Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class PowerOfTwo extends Base { /** * Prepare a number for use in Montgomery Modular Reductions * * @param array $x * @param array $n * @param string $class * @return array */ protected static function prepareReduce(array $x, array $n, $class) { return self::reduce($x, $n, $class); } /** * Power Of Two Reduction * * @param array $x * @param array $n * @param string $class * @return array */ protected static function reduce(array $x, array $n, $class) { $lhs = new $class(); $lhs->value = $x; $rhs = new $class(); $rhs->value = $n; $temp = new $class(); $temp->value = [1]; $result = $lhs->bitwise_and($rhs->subtract($temp)); return $result->value; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\PHP\Reductions; use phpseclib3\Math\BigInteger\Engines\PHP; use phpseclib3\Math\BigInteger\Engines\PHP\Base; /** * PHP Barrett Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class Barrett extends Base { /** * Barrett Modular Reduction * * See {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=14 HAC 14.3.3} / * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=165 MPM 6.2.5} for more information. Modified slightly, * so as not to require negative numbers (initially, this script didn't support negative numbers). * * Employs "folding", as described at * {@link http://www.cosic.esat.kuleuven.be/publications/thesis-149.pdf#page=66 thesis-149.pdf#page=66}. To quote from * it, "the idea [behind folding] is to find a value x' such that x (mod m) = x' (mod m), with x' being smaller than x." * * Unfortunately, the "Barrett Reduction with Folding" algorithm described in thesis-149.pdf is not, as written, all that * usable on account of (1) its not using reasonable radix points as discussed in * {@link http://math.libtomcrypt.com/files/tommath.pdf#page=162 MPM 6.2.2} and (2) the fact that, even with reasonable * radix points, it only works when there are an even number of digits in the denominator. The reason for (2) is that * (x >> 1) + (x >> 1) != x / 2 + x / 2. If x is even, they're the same, but if x is odd, they're not. See the in-line * comments for details. * * @param array $n * @param array $m * @param class-string $class * @return array */ protected static function reduce(array $n, array $m, $class) { static $cache = [ self::VARIABLE => [], self::DATA => [] ]; $m_length = count($m); // if (self::compareHelper($n, $static::square($m)) >= 0) { if (count($n) > 2 * $m_length) { $lhs = new $class(); $rhs = new $class(); $lhs->value = $n; $rhs->value = $m; list(, $temp) = $lhs->divide($rhs); return $temp->value; } // if (m.length >> 1) + 2 <= m.length then m is too small and n can't be reduced if ($m_length < 5) { return self::regularBarrett($n, $m, $class); } // n = 2 * m.length if (($key = array_search($m, $cache[self::VARIABLE])) === false) { $key = count($cache[self::VARIABLE]); $cache[self::VARIABLE][] = $m; $lhs = new $class(); $lhs_value = &$lhs->value; $lhs_value = self::array_repeat(0, $m_length + ($m_length >> 1)); $lhs_value[] = 1; $rhs = new $class(); $rhs->value = $m; list($u, $m1) = $lhs->divide($rhs); $u = $u->value; $m1 = $m1->value; $cache[self::DATA][] = [ 'u' => $u, // m.length >> 1 (technically (m.length >> 1) + 1) 'm1' => $m1 // m.length ]; } else { extract($cache[self::DATA][$key]); } $cutoff = $m_length + ($m_length >> 1); $lsd = array_slice($n, 0, $cutoff); // m.length + (m.length >> 1) $msd = array_slice($n, $cutoff); // m.length >> 1 $lsd = self::trim($lsd); $temp = $class::multiplyHelper($msd, false, $m1, false); // m.length + (m.length >> 1) $n = $class::addHelper($lsd, false, $temp[self::VALUE], false); // m.length + (m.length >> 1) + 1 (so basically we're adding two same length numbers) //if ($m_length & 1) { // return self::regularBarrett($n[self::VALUE], $m, $class); //} // (m.length + (m.length >> 1) + 1) - (m.length - 1) == (m.length >> 1) + 2 $temp = array_slice($n[self::VALUE], $m_length - 1); // if even: ((m.length >> 1) + 2) + (m.length >> 1) == m.length + 2 // if odd: ((m.length >> 1) + 2) + (m.length >> 1) == (m.length - 1) + 2 == m.length + 1 $temp = $class::multiplyHelper($temp, false, $u, false); // if even: (m.length + 2) - ((m.length >> 1) + 1) = m.length - (m.length >> 1) + 1 // if odd: (m.length + 1) - ((m.length >> 1) + 1) = m.length - (m.length >> 1) $temp = array_slice($temp[self::VALUE], ($m_length >> 1) + 1); // if even: (m.length - (m.length >> 1) + 1) + m.length = 2 * m.length - (m.length >> 1) + 1 // if odd: (m.length - (m.length >> 1)) + m.length = 2 * m.length - (m.length >> 1) $temp = $class::multiplyHelper($temp, false, $m, false); // at this point, if m had an odd number of digits, we'd be subtracting a 2 * m.length - (m.length >> 1) digit // number from a m.length + (m.length >> 1) + 1 digit number. ie. there'd be an extra digit and the while loop // following this comment would loop a lot (hence our calling _regularBarrett() in that situation). $result = $class::subtractHelper($n[self::VALUE], false, $temp[self::VALUE], false); while (self::compareHelper($result[self::VALUE], $result[self::SIGN], $m, false) >= 0) { $result = $class::subtractHelper($result[self::VALUE], $result[self::SIGN], $m, false); } return $result[self::VALUE]; } /** * (Regular) Barrett Modular Reduction * * For numbers with more than four digits BigInteger::_barrett() is faster. The difference between that and this * is that this function does not fold the denominator into a smaller form. * * @param array $x * @param array $n * @param string $class * @return array */ private static function regularBarrett(array $x, array $n, $class) { static $cache = [ self::VARIABLE => [], self::DATA => [] ]; $n_length = count($n); if (count($x) > 2 * $n_length) { $lhs = new $class(); $rhs = new $class(); $lhs->value = $x; $rhs->value = $n; list(, $temp) = $lhs->divide($rhs); return $temp->value; } if (($key = array_search($n, $cache[self::VARIABLE])) === false) { $key = count($cache[self::VARIABLE]); $cache[self::VARIABLE][] = $n; $lhs = new $class(); $lhs_value = &$lhs->value; $lhs_value = self::array_repeat(0, 2 * $n_length); $lhs_value[] = 1; $rhs = new $class(); $rhs->value = $n; list($temp, ) = $lhs->divide($rhs); // m.length $cache[self::DATA][] = $temp->value; } // 2 * m.length - (m.length - 1) = m.length + 1 $temp = array_slice($x, $n_length - 1); // (m.length + 1) + m.length = 2 * m.length + 1 $temp = $class::multiplyHelper($temp, false, $cache[self::DATA][$key], false); // (2 * m.length + 1) - (m.length - 1) = m.length + 2 $temp = array_slice($temp[self::VALUE], $n_length + 1); // m.length + 1 $result = array_slice($x, 0, $n_length + 1); // m.length + 1 $temp = self::multiplyLower($temp, false, $n, false, $n_length + 1, $class); // $temp == array_slice($class::regularMultiply($temp, false, $n, false)->value, 0, $n_length + 1) if (self::compareHelper($result, false, $temp[self::VALUE], $temp[self::SIGN]) < 0) { $corrector_value = self::array_repeat(0, $n_length + 1); $corrector_value[count($corrector_value)] = 1; $result = $class::addHelper($result, false, $corrector_value, false); $result = $result[self::VALUE]; } // at this point, we're subtracting a number with m.length + 1 digits from another number with m.length + 1 digits $result = $class::subtractHelper($result, false, $temp[self::VALUE], $temp[self::SIGN]); while (self::compareHelper($result[self::VALUE], $result[self::SIGN], $n, false) > 0) { $result = $class::subtractHelper($result[self::VALUE], $result[self::SIGN], $n, false); } return $result[self::VALUE]; } /** * Performs long multiplication up to $stop digits * * If you're going to be doing array_slice($product->value, 0, $stop), some cycles can be saved. * * @see self::regularBarrett() * @param array $x_value * @param bool $x_negative * @param array $y_value * @param bool $y_negative * @param int $stop * @param string $class * @return array */ private static function multiplyLower(array $x_value, $x_negative, array $y_value, $y_negative, $stop, $class) { $x_length = count($x_value); $y_length = count($y_value); if (!$x_length || !$y_length) { // a 0 is being multiplied return [ self::VALUE => [], self::SIGN => false ]; } if ($x_length < $y_length) { $temp = $x_value; $x_value = $y_value; $y_value = $temp; $x_length = count($x_value); $y_length = count($y_value); } $product_value = self::array_repeat(0, $x_length + $y_length); // the following for loop could be removed if the for loop following it // (the one with nested for loops) initially set $i to 0, but // doing so would also make the result in one set of unnecessary adds, // since on the outermost loops first pass, $product->value[$k] is going // to always be 0 $carry = 0; for ($j = 0; $j < $x_length; ++$j) { // ie. $i = 0, $k = $i $temp = $x_value[$j] * $y_value[0] + $carry; // $product_value[$k] == 0 $carry = $class::BASE === 26 ? intval($temp / 0x4000000) : ($temp >> 31); $product_value[$j] = (int) ($temp - $class::BASE_FULL * $carry); } if ($j < $stop) { $product_value[$j] = $carry; } // the above for loop is what the previous comment was talking about. the // following for loop is the "one with nested for loops" for ($i = 1; $i < $y_length; ++$i) { $carry = 0; for ($j = 0, $k = $i; $j < $x_length && $k < $stop; ++$j, ++$k) { $temp = $product_value[$k] + $x_value[$j] * $y_value[$i] + $carry; $carry = $class::BASE === 26 ? intval($temp / 0x4000000) : ($temp >> 31); $product_value[$k] = (int) ($temp - $class::BASE_FULL * $carry); } if ($k < $stop) { $product_value[$k] = $carry; } } return [ self::VALUE => self::trim($product_value), self::SIGN => $x_negative != $y_negative ]; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\PHP\Reductions; use phpseclib3\Math\BigInteger\Engines\PHP\Montgomery as Progenitor; /** * PHP Montgomery Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class Montgomery extends Progenitor { /** * Prepare a number for use in Montgomery Modular Reductions * * @param array $x * @param array $n * @param string $class * @return array */ protected static function prepareReduce(array $x, array $n, $class) { $lhs = new $class(); $lhs->value = array_merge(self::array_repeat(0, count($n)), $x); $rhs = new $class(); $rhs->value = $n; list(, $temp) = $lhs->divide($rhs); return $temp->value; } /** * Montgomery Multiply * * Interleaves the montgomery reduction and long multiplication algorithms together as described in * {@link http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf#page=13 HAC 14.36} * * @param array $x * @param array $n * @param string $class * @return array */ protected static function reduce(array $x, array $n, $class) { static $cache = [ self::VARIABLE => [], self::DATA => [] ]; if (($key = array_search($n, $cache[self::VARIABLE])) === false) { $key = count($cache[self::VARIABLE]); $cache[self::VARIABLE][] = $x; $cache[self::DATA][] = self::modInverse67108864($n, $class); } $k = count($n); $result = [self::VALUE => $x]; for ($i = 0; $i < $k; ++$i) { $temp = $result[self::VALUE][$i] * $cache[self::DATA][$key]; $temp = $temp - $class::BASE_FULL * ($class::BASE === 26 ? intval($temp / 0x4000000) : ($temp >> 31)); $temp = $class::regularMultiply([$temp], $n); $temp = array_merge(self::array_repeat(0, $i), $temp); $result = $class::addHelper($result[self::VALUE], false, $temp, false); } $result[self::VALUE] = array_slice($result[self::VALUE], $k); if (self::compareHelper($result, false, $n, false) >= 0) { $result = $class::subtractHelper($result[self::VALUE], false, $n, false); } return $result[self::VALUE]; } /** * Modular Inverse of a number mod 2**26 (eg. 67108864) * * Based off of the bnpInvDigit function implemented and justified in the following URL: * * {@link http://www-cs-students.stanford.edu/~tjw/jsbn/jsbn.js} * * The following URL provides more info: * * {@link http://groups.google.com/group/sci.crypt/msg/7a137205c1be7d85} * * As for why we do all the bitmasking... strange things can happen when converting from floats to ints. For * instance, on some computers, var_dump((int) -4294967297) yields int(-1) and on others, it yields * int(-2147483648). To avoid problems stemming from this, we use bitmasks to guarantee that ints aren't * auto-converted to floats. The outermost bitmask is present because without it, there's no guarantee that * the "residue" returned would be the so-called "common residue". We use fmod, in the last step, because the * maximum possible $x is 26 bits and the maximum $result is 16 bits. Thus, we have to be able to handle up to * 40 bits, which only 64-bit floating points will support. * * Thanks to Pedro Gimeno Fortea for input! * * @param array $x * @param string $class * @return int */ protected static function modInverse67108864(array $x, $class) // 2**26 == 67,108,864 { $x = -$x[0]; $result = $x & 0x3; // x**-1 mod 2**2 $result = ($result * (2 - $x * $result)) & 0xF; // x**-1 mod 2**4 $result = ($result * (2 - ($x & 0xFF) * $result)) & 0xFF; // x**-1 mod 2**8 $result = ($result * ((2 - ($x & 0xFFFF) * $result) & 0xFFFF)) & 0xFFFF; // x**-1 mod 2**16 $result = $class::BASE == 26 ? fmod($result * (2 - fmod($x * $result, $class::BASE_FULL)), $class::BASE_FULL) : // x**-1 mod 2**26 ($result * (2 - ($x * $result) % $class::BASE_FULL)) % $class::BASE_FULL; return $result & $class::MAX_DIGIT; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\PHP\Reductions; use phpseclib3\Math\BigInteger\Engines\PHP; use phpseclib3\Math\BigInteger\Engines\PHP\Base; /** * PHP Dynamic Barrett Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class EvalBarrett extends Base { /** * Custom Reduction Function * * @see self::generateCustomReduction */ private static $custom_reduction; /** * Barrett Modular Reduction * * This calls a dynamically generated loop unrolled function that's specific to a given modulo. * Array lookups are avoided as are if statements testing for how many bits the host OS supports, etc. * * @param array $n * @param array $m * @param string $class * @return array */ protected static function reduce(array $n, array $m, $class) { $inline = self::$custom_reduction; return $inline($n); } /** * Generate Custom Reduction * * @param PHP $m * @param string $class * @return callable */ protected static function generateCustomReduction(PHP $m, $class) { $m_length = count($m->value); if ($m_length < 5) { $code = ' $lhs = new ' . $class . '(); $lhs->value = $x; $rhs = new ' . $class . '(); $rhs->value = [' . implode(',', array_map(self::class . '::float2string', $m->value)) . ']; list(, $temp) = $lhs->divide($rhs); return $temp->value; '; eval('$func = function ($x) { ' . $code . '};'); self::$custom_reduction = $func; //self::$custom_reduction = \Closure::bind($func, $m, $class); return $func; } $lhs = new $class(); $lhs_value = &$lhs->value; $lhs_value = self::array_repeat(0, $m_length + ($m_length >> 1)); $lhs_value[] = 1; $rhs = new $class(); list($u, $m1) = $lhs->divide($m); if ($class::BASE != 26) { $u = $u->value; } else { $lhs_value = self::array_repeat(0, 2 * $m_length); $lhs_value[] = 1; $rhs = new $class(); list($u) = $lhs->divide($m); $u = $u->value; } $m = $m->value; $m1 = $m1->value; $cutoff = count($m) + (count($m) >> 1); $code = ' if (count($n) > ' . (2 * count($m)) . ') { $lhs = new ' . $class . '(); $rhs = new ' . $class . '(); $lhs->value = $n; $rhs->value = [' . implode(',', array_map(self::class . '::float2string', $m)) . ']; list(, $temp) = $lhs->divide($rhs); return $temp->value; } $lsd = array_slice($n, 0, ' . $cutoff . '); $msd = array_slice($n, ' . $cutoff . ');'; $code .= self::generateInlineTrim('msd'); $code .= self::generateInlineMultiply('msd', $m1, 'temp', $class); $code .= self::generateInlineAdd('lsd', 'temp', 'n', $class); $code .= '$temp = array_slice($n, ' . (count($m) - 1) . ');'; $code .= self::generateInlineMultiply('temp', $u, 'temp2', $class); $code .= self::generateInlineTrim('temp2'); $code .= $class::BASE == 26 ? '$temp = array_slice($temp2, ' . (count($m) + 1) . ');' : '$temp = array_slice($temp2, ' . ((count($m) >> 1) + 1) . ');'; $code .= self::generateInlineMultiply('temp', $m, 'temp2', $class); $code .= self::generateInlineTrim('temp2'); /* if ($class::BASE == 26) { $code.= '$n = array_slice($n, 0, ' . (count($m) + 1) . '); $temp2 = array_slice($temp2, 0, ' . (count($m) + 1) . ');'; } */ $code .= self::generateInlineSubtract2('n', 'temp2', 'temp', $class); $subcode = self::generateInlineSubtract1('temp', $m, 'temp2', $class); $subcode .= '$temp = $temp2;'; $code .= self::generateInlineCompare($m, 'temp', $subcode); $code .= 'return $temp;'; eval('$func = function ($n) { ' . $code . '};'); self::$custom_reduction = $func; return $func; //self::$custom_reduction = \Closure::bind($func, $m, $class); } /** * Inline Trim * * Removes leading zeros * * @param string $name * @return string */ private static function generateInlineTrim($name) { return ' for ($i = count($' . $name . ') - 1; $i >= 0; --$i) { if ($' . $name . '[$i]) { break; } unset($' . $name . '[$i]); }'; } /** * Inline Multiply (unknown, known) * * @param string $input * @param array $arr * @param string $output * @param string $class * @return string */ private static function generateInlineMultiply($input, array $arr, $output, $class) { if (!count($arr)) { return 'return [];'; } $regular = ' $length = count($' . $input . '); if (!$length) { $' . $output . ' = []; }else{ $' . $output . ' = array_fill(0, $length + ' . count($arr) . ', 0); $carry = 0;'; for ($i = 0; $i < count($arr); $i++) { $regular .= ' $subtemp = $' . $input . '[0] * ' . $arr[$i]; $regular .= $i ? ' + $carry;' : ';'; $regular .= '$carry = '; $regular .= $class::BASE === 26 ? 'intval($subtemp / 0x4000000);' : '$subtemp >> 31;'; $regular .= '$' . $output . '[' . $i . '] = '; if ($class::BASE === 26) { $regular .= '(int) ('; } $regular .= '$subtemp - ' . $class::BASE_FULL . ' * $carry'; $regular .= $class::BASE === 26 ? ');' : ';'; } $regular .= '$' . $output . '[' . count($arr) . '] = $carry;'; $regular .= ' for ($i = 1; $i < $length; ++$i) {'; for ($j = 0; $j < count($arr); $j++) { $regular .= $j ? '$k++;' : '$k = $i;'; $regular .= ' $subtemp = $' . $output . '[$k] + $' . $input . '[$i] * ' . $arr[$j]; $regular .= $j ? ' + $carry;' : ';'; $regular .= '$carry = '; $regular .= $class::BASE === 26 ? 'intval($subtemp / 0x4000000);' : '$subtemp >> 31;'; $regular .= '$' . $output . '[$k] = '; if ($class::BASE === 26) { $regular .= '(int) ('; } $regular .= '$subtemp - ' . $class::BASE_FULL . ' * $carry'; $regular .= $class::BASE === 26 ? ');' : ';'; } $regular .= '$' . $output . '[++$k] = $carry; $carry = 0;'; $regular .= '}}'; //if (count($arr) < 2 * self::KARATSUBA_CUTOFF) { //} return $regular; } /** * Inline Addition * * @param string $x * @param string $y * @param string $result * @param string $class * @return string */ private static function generateInlineAdd($x, $y, $result, $class) { $code = ' $length = max(count($' . $x . '), count($' . $y . ')); $' . $result . ' = array_pad($' . $x . ', $length + 1, 0); $_' . $y . ' = array_pad($' . $y . ', $length, 0); $carry = 0; for ($i = 0, $j = 1; $j < $length; $i+=2, $j+=2) { $sum = ($' . $result . '[$j] + $_' . $y . '[$j]) * ' . $class::BASE_FULL . ' + $' . $result . '[$i] + $_' . $y . '[$i] + $carry; $carry = $sum >= ' . self::float2string($class::MAX_DIGIT2) . '; $sum = $carry ? $sum - ' . self::float2string($class::MAX_DIGIT2) . ' : $sum;'; $code .= $class::BASE === 26 ? '$upper = intval($sum / 0x4000000); $' . $result . '[$i] = (int) ($sum - ' . $class::BASE_FULL . ' * $upper);' : '$upper = $sum >> 31; $' . $result . '[$i] = $sum - ' . $class::BASE_FULL . ' * $upper;'; $code .= ' $' . $result . '[$j] = $upper; } if ($j == $length) { $sum = $' . $result . '[$i] + $_' . $y . '[$i] + $carry; $carry = $sum >= ' . self::float2string($class::BASE_FULL) . '; $' . $result . '[$i] = $carry ? $sum - ' . self::float2string($class::BASE_FULL) . ' : $sum; ++$i; } if ($carry) { for (; $' . $result . '[$i] == ' . $class::MAX_DIGIT . '; ++$i) { $' . $result . '[$i] = 0; } ++$' . $result . '[$i]; }'; $code .= self::generateInlineTrim($result); return $code; } /** * Inline Subtraction 2 * * For when $known is more digits than $unknown. This is the harder use case to optimize for. * * @param string $known * @param string $unknown * @param string $result * @param string $class * @return string */ private static function generateInlineSubtract2($known, $unknown, $result, $class) { $code = ' $' . $result . ' = $' . $known . '; $carry = 0; $size = count($' . $unknown . '); for ($i = 0, $j = 1; $j < $size; $i+= 2, $j+= 2) { $sum = ($' . $known . '[$j] - $' . $unknown . '[$j]) * ' . $class::BASE_FULL . ' + $' . $known . '[$i] - $' . $unknown . '[$i] - $carry; $carry = $sum < 0; if ($carry) { $sum+= ' . self::float2string($class::MAX_DIGIT2) . '; } $subtemp = '; $code .= $class::BASE === 26 ? 'intval($sum / 0x4000000);' : '$sum >> 31;'; $code .= '$' . $result . '[$i] = '; if ($class::BASE === 26) { $code .= '(int) ('; } $code .= '$sum - ' . $class::BASE_FULL . ' * $subtemp'; if ($class::BASE === 26) { $code .= ')'; } $code .= '; $' . $result . '[$j] = $subtemp; } if ($j == $size) { $sum = $' . $known . '[$i] - $' . $unknown . '[$i] - $carry; $carry = $sum < 0; $' . $result . '[$i] = $carry ? $sum + ' . $class::BASE_FULL . ' : $sum; ++$i; } if ($carry) { for (; !$' . $result . '[$i]; ++$i) { $' . $result . '[$i] = ' . $class::MAX_DIGIT . '; } --$' . $result . '[$i]; }'; $code .= self::generateInlineTrim($result); return $code; } /** * Inline Subtraction 1 * * For when $unknown is more digits than $known. This is the easier use case to optimize for. * * @param string $unknown * @param array $known * @param string $result * @param string $class * @return string */ private static function generateInlineSubtract1($unknown, array $known, $result, $class) { $code = '$' . $result . ' = $' . $unknown . ';'; for ($i = 0, $j = 1; $j < count($known); $i += 2, $j += 2) { $code .= '$sum = $' . $unknown . '[' . $j . '] * ' . $class::BASE_FULL . ' + $' . $unknown . '[' . $i . '] - '; $code .= self::float2string($known[$j] * $class::BASE_FULL + $known[$i]); if ($i != 0) { $code .= ' - $carry'; } $code .= '; if ($carry = $sum < 0) { $sum+= ' . self::float2string($class::MAX_DIGIT2) . '; } $subtemp = '; $code .= $class::BASE === 26 ? 'intval($sum / 0x4000000);' : '$sum >> 31;'; $code .= ' $' . $result . '[' . $i . '] = '; if ($class::BASE === 26) { $code .= ' (int) ('; } $code .= '$sum - ' . $class::BASE_FULL . ' * $subtemp'; if ($class::BASE === 26) { $code .= ')'; } $code .= '; $' . $result . '[' . $j . '] = $subtemp;'; } $code .= '$i = ' . $i . ';'; if ($j == count($known)) { $code .= ' $sum = $' . $unknown . '[' . $i . '] - ' . $known[$i] . ' - $carry; $carry = $sum < 0; $' . $result . '[' . $i . '] = $carry ? $sum + ' . $class::BASE_FULL . ' : $sum; ++$i;'; } $code .= ' if ($carry) { for (; !$' . $result . '[$i]; ++$i) { $' . $result . '[$i] = ' . $class::MAX_DIGIT . '; } --$' . $result . '[$i]; }'; $code .= self::generateInlineTrim($result); return $code; } /** * Inline Comparison * * If $unknown >= $known then loop * * @param array $known * @param string $unknown * @param string $subcode * @return string */ private static function generateInlineCompare(array $known, $unknown, $subcode) { $uniqid = uniqid(); $code = 'loop_' . $uniqid . ': $clength = count($' . $unknown . '); switch (true) { case $clength < ' . count($known) . ': goto end_' . $uniqid . '; case $clength > ' . count($known) . ':'; for ($i = count($known) - 1; $i >= 0; $i--) { $code .= ' case $' . $unknown . '[' . $i . '] > ' . $known[$i] . ': goto subcode_' . $uniqid . '; case $' . $unknown . '[' . $i . '] < ' . $known[$i] . ': goto end_' . $uniqid . ';'; } $code .= ' default: // do subcode } subcode_' . $uniqid . ':' . $subcode . ' goto loop_' . $uniqid . '; end_' . $uniqid . ':'; return $code; } /** * Convert a float to a string * * If you do echo floatval(pow(2, 52)) you'll get 4.6116860184274E+18. It /can/ be displayed without a loss of * precision but displayed in this way there will be precision loss, hence the need for this method. * * @param int|float $num * @return string */ private static function float2string($num) { if (!is_float($num)) { return (string) $num; } if ($num < 0) { return '-' . self::float2string(abs($num)); } $temp = ''; while ($num) { $temp = fmod($num, 10) . $temp; $num = floor($num / 10); } return $temp; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\PHP; use phpseclib3\Math\BigInteger\Engines\PHP; /** * PHP Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class Base extends PHP { /** * Cache constants * * $cache[self::VARIABLE] tells us whether or not the cached data is still valid. * */ const VARIABLE = 0; /** * $cache[self::DATA] contains the cached data. * */ const DATA = 1; /** * Test for engine validity * * @return bool */ public static function isValidEngine() { return static::class != __CLASS__; } /** * Performs modular exponentiation. * * The most naive approach to modular exponentiation has very unreasonable requirements, and * and although the approach involving repeated squaring does vastly better, it, too, is impractical * for our purposes. The reason being that division - by far the most complicated and time-consuming * of the basic operations (eg. +,-,*,/) - occurs multiple times within it. * * Modular reductions resolve this issue. Although an individual modular reduction takes more time * then an individual division, when performed in succession (with the same modulo), they're a lot faster. * * The two most commonly used modular reductions are Barrett and Montgomery reduction. Montgomery reduction, * although faster, only works when the gcd of the modulo and of the base being used is 1. In RSA, when the * base is a power of two, the modulo - a product of two primes - is always going to have a gcd of 1 (because * the product of two odd numbers is odd), but what about when RSA isn't used? * * In contrast, Barrett reduction has no such constraint. As such, some bigint implementations perform a * Barrett reduction after every operation in the modpow function. Others perform Barrett reductions when the * modulo is even and Montgomery reductions when the modulo is odd. BigInteger.java's modPow method, however, * uses a trick involving the Chinese Remainder Theorem to factor the even modulo into two numbers - one odd and * the other, a power of two - and recombine them, later. This is the method that this modPow function uses. * {@link http://islab.oregonstate.edu/papers/j34monex.pdf Montgomery Reduction with Even Modulus} elaborates. * * @param PHP $x * @param PHP $e * @param PHP $n * @param string $class * @return PHP */ protected static function powModHelper(PHP $x, PHP $e, PHP $n, $class) { if (empty($e->value)) { $temp = new $class(); $temp->value = [1]; return $x->normalize($temp); } if ($e->value == [1]) { list(, $temp) = $x->divide($n); return $x->normalize($temp); } if ($e->value == [2]) { $temp = new $class(); $temp->value = $class::square($x->value); list(, $temp) = $temp->divide($n); return $x->normalize($temp); } return $x->normalize(static::slidingWindow($x, $e, $n, $class)); } /** * Modular reduction preparation * * @param array $x * @param array $n * @param string $class * @see self::slidingWindow() * @return array */ protected static function prepareReduce(array $x, array $n, $class) { return static::reduce($x, $n, $class); } /** * Modular multiply * * @param array $x * @param array $y * @param array $n * @param string $class * @see self::slidingWindow() * @return array */ protected static function multiplyReduce(array $x, array $y, array $n, $class) { $temp = $class::multiplyHelper($x, false, $y, false); return static::reduce($temp[self::VALUE], $n, $class); } /** * Modular square * * @param array $x * @param array $n * @param string $class * @see self::slidingWindow() * @return array */ protected static function squareReduce(array $x, array $n, $class) { return static::reduce($class::square($x), $n, $class); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines\PHP; use phpseclib3\Math\BigInteger\Engines\Engine; use phpseclib3\Math\BigInteger\Engines\PHP; use phpseclib3\Math\BigInteger\Engines\PHP\Reductions\PowerOfTwo; /** * PHP Montgomery Modular Exponentiation Engine * * @author Jim Wigginton */ abstract class Montgomery extends Base { /** * Test for engine validity * * @return bool */ public static function isValidEngine() { return static::class != __CLASS__; } /** * Performs modular exponentiation. * * @template T of Engine * @param Engine $x * @param Engine $e * @param Engine $n * @param class-string $class * @return T */ protected static function slidingWindow(Engine $x, Engine $e, Engine $n, $class) { // is the modulo odd? if ($n->value[0] & 1) { return parent::slidingWindow($x, $e, $n, $class); } // if it's not, it's even // find the lowest set bit (eg. the max pow of 2 that divides $n) for ($i = 0; $i < count($n->value); ++$i) { if ($n->value[$i]) { $temp = decbin($n->value[$i]); $j = strlen($temp) - strrpos($temp, '1') - 1; $j += $class::BASE * $i; break; } } // at this point, 2^$j * $n/(2^$j) == $n $mod1 = clone $n; $mod1->rshift($j); $mod2 = new $class(); $mod2->value = [1]; $mod2->lshift($j); $part1 = $mod1->value != [1] ? parent::slidingWindow($x, $e, $mod1, $class) : new $class(); $part2 = PowerOfTwo::slidingWindow($x, $e, $mod2, $class); $y1 = $mod2->modInverse($mod1); $y2 = $mod1->modInverse($mod2); $result = $part1->multiply($mod2); $result = $result->multiply($y1); $temp = $part2->multiply($mod1); $temp = $temp->multiply($y2); $result = $result->add($temp); list(, $result) = $result->divide($n); return $result; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://pear.php.net/package/Math_BigInteger */ namespace phpseclib3\Math\BigInteger\Engines; /** * Pure-PHP 32-bit Engine. * * Uses 64-bit floats if int size is 4 bits * * @author Jim Wigginton */ class PHP32 extends PHP { // Constants used by PHP.php const BASE = 26; const BASE_FULL = 0x4000000; const MAX_DIGIT = 0x3FFFFFF; const MSB = 0x2000000; /** * MAX10 in greatest MAX10LEN satisfying * MAX10 = 10**MAX10LEN <= 2**BASE. */ const MAX10 = 10000000; /** * MAX10LEN in greatest MAX10LEN satisfying * MAX10 = 10**MAX10LEN <= 2**BASE. */ const MAX10LEN = 7; const MAX_DIGIT2 = 4503599627370496; /** * Initialize a PHP32 BigInteger Engine instance * * @param int $base * @see parent::initialize() */ protected function initialize($base) { if ($base != 256 && $base != -256) { return parent::initialize($base); } $val = $this->value; $this->value = []; $vals = &$this->value; $i = strlen($val); if (!$i) { return; } while (true) { $i -= 4; if ($i < 0) { if ($i == -4) { break; } $val = substr($val, 0, 4 + $i); $val = str_pad($val, 4, "\0", STR_PAD_LEFT); if ($val == "\0\0\0\0") { break; } $i = 0; } list(, $digit) = unpack('N', substr($val, $i, 4)); if ($digit < 0) { $digit += 0xFFFFFFFF + 1; } $step = count($vals) & 3; if ($step) { $digit = floor($digit / pow(2, 2 * $step)); } if ($step != 3) { $digit &= static::MAX_DIGIT; $i++; } $vals[] = $digit; } while (end($vals) === 0) { array_pop($vals); } reset($vals); } /** * Test for engine validity * * @see parent::__construct() * @return bool */ public static function isValidEngine() { return PHP_INT_SIZE >= 4; } /** * Adds two BigIntegers. * * @param PHP32 $y * @return PHP32 */ public function add(PHP32 $y) { $temp = self::addHelper($this->value, $this->is_negative, $y->value, $y->is_negative); return $this->convertToObj($temp); } /** * Subtracts two BigIntegers. * * @param PHP32 $y * @return PHP32 */ public function subtract(PHP32 $y) { $temp = self::subtractHelper($this->value, $this->is_negative, $y->value, $y->is_negative); return $this->convertToObj($temp); } /** * Multiplies two BigIntegers. * * @param PHP32 $y * @return PHP32 */ public function multiply(PHP32 $y) { $temp = self::multiplyHelper($this->value, $this->is_negative, $y->value, $y->is_negative); return $this->convertToObj($temp); } /** * Divides two BigIntegers. * * Returns an array whose first element contains the quotient and whose second element contains the * "common residue". If the remainder would be positive, the "common residue" and the remainder are the * same. If the remainder would be negative, the "common residue" is equal to the sum of the remainder * and the divisor (basically, the "common residue" is the first positive modulo). * * @param PHP32 $y * @return array{PHP32, PHP32} */ public function divide(PHP32 $y) { return $this->divideHelper($y); } /** * Calculates modular inverses. * * Say you have (30 mod 17 * x mod 17) mod 17 == 1. x can be found using modular inverses. * @param PHP32 $n * @return false|PHP32 */ public function modInverse(PHP32 $n) { return $this->modInverseHelper($n); } /** * Calculates modular inverses. * * Say you have (30 mod 17 * x mod 17) mod 17 == 1. x can be found using modular inverses. * @param PHP32 $n * @return PHP32[] */ public function extendedGCD(PHP32 $n) { return $this->extendedGCDHelper($n); } /** * Calculates the greatest common divisor * * Say you have 693 and 609. The GCD is 21. * * @param PHP32 $n * @return PHP32 */ public function gcd(PHP32 $n) { return $this->extendedGCD($n)['gcd']; } /** * Logical And * * @param PHP32 $x * @return PHP32 */ public function bitwise_and(PHP32 $x) { return $this->bitwiseAndHelper($x); } /** * Logical Or * * @param PHP32 $x * @return PHP32 */ public function bitwise_or(PHP32 $x) { return $this->bitwiseOrHelper($x); } /** * Logical Exclusive Or * * @param PHP32 $x * @return PHP32 */ public function bitwise_xor(PHP32 $x) { return $this->bitwiseXorHelper($x); } /** * Compares two numbers. * * Although one might think !$x->compare($y) means $x != $y, it, in fact, means the opposite. The reason for this is * demonstrated thusly: * * $x > $y: $x->compare($y) > 0 * $x < $y: $x->compare($y) < 0 * $x == $y: $x->compare($y) == 0 * * Note how the same comparison operator is used. If you want to test for equality, use $x->equals($y). * * {@internal Could return $this->subtract($x), but that's not as fast as what we do do.} * * @param PHP32 $y * @return int in case < 0 if $this is less than $y; > 0 if $this is greater than $y, and 0 if they are equal. * @see self::equals() */ public function compare(PHP32 $y) { return $this->compareHelper($this->value, $this->is_negative, $y->value, $y->is_negative); } /** * Tests the equality of two numbers. * * If you need to see if one number is greater than or less than another number, use BigInteger::compare() * * @param PHP32 $x * @return bool */ public function equals(PHP32 $x) { return $this->value === $x->value && $this->is_negative == $x->is_negative; } /** * Performs modular exponentiation. * * @param PHP32 $e * @param PHP32 $n * @return PHP32 */ public function modPow(PHP32 $e, PHP32 $n) { return $this->powModOuter($e, $n); } /** * Performs modular exponentiation. * * Alias for modPow(). * * @param PHP32 $e * @param PHP32 $n * @return PHP32 */ public function powMod(PHP32 $e, PHP32 $n) { return $this->powModOuter($e, $n); } /** * Generate a random prime number between a range * * If there's not a prime within the given range, false will be returned. * * @param PHP32 $min * @param PHP32 $max * @return false|PHP32 */ public static function randomRangePrime(PHP32 $min, PHP32 $max) { return self::randomRangePrimeOuter($min, $max); } /** * Generate a random number between a range * * Returns a random number between $min and $max where $min and $max * can be defined using one of the two methods: * * BigInteger::randomRange($min, $max) * BigInteger::randomRange($max, $min) * * @param PHP32 $min * @param PHP32 $max * @return PHP32 */ public static function randomRange(PHP32 $min, PHP32 $max) { return self::randomRangeHelper($min, $max); } /** * Performs exponentiation. * * @param PHP32 $n * @return PHP32 */ public function pow(PHP32 $n) { return $this->powHelper($n); } /** * Return the minimum BigInteger between an arbitrary number of BigIntegers. * * @param PHP32 ...$nums * @return PHP32 */ public static function min(PHP32 ...$nums) { return self::minHelper($nums); } /** * Return the maximum BigInteger between an arbitrary number of BigIntegers. * * @param PHP32 ...$nums * @return PHP32 */ public static function max(PHP32 ...$nums) { return self::maxHelper($nums); } /** * Tests BigInteger to see if it is between two integers, inclusive * * @param PHP32 $min * @param PHP32 $max * @return bool */ public function between(PHP32 $min, PHP32 $max) { return $this->compare($min) >= 0 && $this->compare($max) <= 0; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License */ namespace phpseclib3\Math; use phpseclib3\Common\Functions\Strings; use phpseclib3\Math\BinaryField\Integer; use phpseclib3\Math\Common\FiniteField; /** * Binary Finite Fields * * @author Jim Wigginton */ class BinaryField extends FiniteField { /** * Instance Counter * * @var int */ private static $instanceCounter = 0; /** * Keeps track of current instance * * @var int */ protected $instanceID; /** @var BigInteger */ private $randomMax; /** * Default constructor */ public function __construct(...$indices) { $m = array_shift($indices); $val = str_repeat('0', $m) . '1'; foreach ($indices as $index) { $val[$index] = '1'; } $modulo = static::base2ToBase256(strrev($val)); $mStart = 2 * $m - 2; $t = ceil($m / 8); $finalMask = chr((1 << ($m % 8)) - 1); if ($finalMask == "\0") { $finalMask = "\xFF"; } $bitLen = $mStart + 1; $pad = ceil($bitLen / 8); $h = $bitLen & 7; $h = $h ? 8 - $h : 0; $r = rtrim(substr($val, 0, -1), '0'); $u = [static::base2ToBase256(strrev($r))]; for ($i = 1; $i < 8; $i++) { $u[] = static::base2ToBase256(strrev(str_repeat('0', $i) . $r)); } // implements algorithm 2.40 (in section 2.3.5) in "Guide to Elliptic Curve Cryptography" // with W = 8 $reduce = function ($c) use ($u, $mStart, $m, $t, $finalMask, $pad, $h) { $c = str_pad($c, $pad, "\0", STR_PAD_LEFT); for ($i = $mStart; $i >= $m;) { $g = $h >> 3; $mask = $h & 7; $mask = $mask ? 1 << (7 - $mask) : 0x80; for (; $mask > 0; $mask >>= 1, $i--, $h++) { if (ord($c[$g]) & $mask) { $temp = $i - $m; $j = $temp >> 3; $k = $temp & 7; $t1 = $j ? substr($c, 0, -$j) : $c; $length = strlen($t1); if ($length) { $t2 = str_pad($u[$k], $length, "\0", STR_PAD_LEFT); $temp = $t1 ^ $t2; $c = $j ? substr_replace($c, $temp, 0, $length) : $temp; } } } } $c = substr($c, -$t); if (strlen($c) == $t) { $c[0] = $c[0] & $finalMask; } return ltrim($c, "\0"); }; $this->instanceID = self::$instanceCounter++; Integer::setModulo($this->instanceID, $modulo); Integer::setRecurringModuloFunction($this->instanceID, $reduce); $this->randomMax = new BigInteger($modulo, 2); } /** * Returns an instance of a dynamically generated PrimeFieldInteger class * * @param string $num * @return Integer */ public function newInteger($num) { return new Integer($this->instanceID, $num instanceof BigInteger ? $num->toBytes() : $num); } /** * Returns an integer on the finite field between one and the prime modulo * * @return Integer */ public function randomInteger() { static $one; if (!isset($one)) { $one = new BigInteger(1); } return new Integer($this->instanceID, BigInteger::randomRange($one, $this->randomMax)->toBytes()); } /** * Returns the length of the modulo in bytes * * @return int */ public function getLengthInBytes() { return strlen(Integer::getModulo($this->instanceID)); } /** * Returns the length of the modulo in bits * * @return int */ public function getLength() { return strlen(Integer::getModulo($this->instanceID)) << 3; } /** * Converts a base-2 string to a base-256 string * * @param string $x * @param int|null $size * @return string */ public static function base2ToBase256($x, $size = null) { $str = Strings::bits2bin($x); $pad = strlen($x) >> 3; if (strlen($x) & 3) { $pad++; } $str = str_pad($str, $pad, "\0", STR_PAD_LEFT); if (isset($size)) { $str = str_pad($str, $size, "\0", STR_PAD_LEFT); } return $str; } /** * Converts a base-256 string to a base-2 string * * @param string $x * @return string */ public static function base256ToBase2($x) { if (function_exists('gmp_import')) { return gmp_strval(gmp_import($x), 2); } return Strings::bin2bits($x); } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License */ namespace phpseclib3\Math\BinaryField; use phpseclib3\Common\Functions\Strings; use phpseclib3\Math\BigInteger; use phpseclib3\Math\BinaryField; use phpseclib3\Math\Common\FiniteField\Integer as Base; /** * Binary Finite Fields * * @author Jim Wigginton */ class Integer extends Base { /** * Holds the BinaryField's value * * @var string */ protected $value; /** * Keeps track of current instance * * @var int */ protected $instanceID; /** * Holds the PrimeField's modulo * * @var array */ protected static $modulo; /** * Holds a pre-generated function to perform modulo reductions * * @var callable[] */ protected static $reduce; /** * Default constructor */ public function __construct($instanceID, $num = '') { $this->instanceID = $instanceID; if (!strlen($num)) { $this->value = ''; } else { $reduce = static::$reduce[$instanceID]; $this->value = $reduce($num); } } /** * Set the modulo for a given instance * @param int $instanceID * @param string $modulo */ public static function setModulo($instanceID, $modulo) { static::$modulo[$instanceID] = $modulo; } /** * Set the modulo for a given instance */ public static function setRecurringModuloFunction($instanceID, callable $function) { static::$reduce[$instanceID] = $function; } /** * Tests a parameter to see if it's of the right instance * * Throws an exception if the incorrect class is being utilized */ private static function checkInstance(self $x, self $y) { if ($x->instanceID != $y->instanceID) { throw new \UnexpectedValueException('The instances of the two BinaryField\Integer objects do not match'); } } /** * Tests the equality of two numbers. * * @return bool */ public function equals(self $x) { static::checkInstance($this, $x); return $this->value == $x->value; } /** * Compares two numbers. * * @return int */ public function compare(self $x) { static::checkInstance($this, $x); $a = $this->value; $b = $x->value; $length = max(strlen($a), strlen($b)); $a = str_pad($a, $length, "\0", STR_PAD_LEFT); $b = str_pad($b, $length, "\0", STR_PAD_LEFT); return strcmp($a, $b); } /** * Returns the degree of the polynomial * * @param string $x * @return int */ private static function deg($x) { $x = ltrim($x, "\0"); $xbit = decbin(ord($x[0])); $xlen = $xbit == '0' ? 0 : strlen($xbit); $len = strlen($x); if (!$len) { return -1; } return 8 * strlen($x) - 9 + $xlen; } /** * Perform polynomial division * * @return string[] * @link https://en.wikipedia.org/wiki/Polynomial_greatest_common_divisor#Euclidean_division */ private static function polynomialDivide($x, $y) { // in wikipedia's description of the algorithm, lc() is the leading coefficient. over a binary field that's // always going to be 1. $q = chr(0); $d = static::deg($y); $r = $x; while (($degr = static::deg($r)) >= $d) { $s = '1' . str_repeat('0', $degr - $d); $s = BinaryField::base2ToBase256($s); $length = max(strlen($s), strlen($q)); $q = !isset($q) ? $s : str_pad($q, $length, "\0", STR_PAD_LEFT) ^ str_pad($s, $length, "\0", STR_PAD_LEFT); $s = static::polynomialMultiply($s, $y); $length = max(strlen($r), strlen($s)); $r = str_pad($r, $length, "\0", STR_PAD_LEFT) ^ str_pad($s, $length, "\0", STR_PAD_LEFT); } return [ltrim($q, "\0"), ltrim($r, "\0")]; } /** * Perform polynomial multiplation in the traditional way * * @return string * @link https://en.wikipedia.org/wiki/Finite_field_arithmetic#Multiplication */ private static function regularPolynomialMultiply($x, $y) { $precomputed = [ltrim($x, "\0")]; $x = strrev(BinaryField::base256ToBase2($x)); $y = strrev(BinaryField::base256ToBase2($y)); if (strlen($x) == strlen($y)) { $length = strlen($x); } else { $length = max(strlen($x), strlen($y)); $x = str_pad($x, $length, '0'); $y = str_pad($y, $length, '0'); } $result = str_repeat('0', 2 * $length - 1); $result = BinaryField::base2ToBase256($result); $size = strlen($result); $x = strrev($x); // precompute left shift 1 through 7 for ($i = 1; $i < 8; $i++) { $precomputed[$i] = BinaryField::base2ToBase256($x . str_repeat('0', $i)); } for ($i = 0; $i < strlen($y); $i++) { if ($y[$i] == '1') { $temp = $precomputed[$i & 7] . str_repeat("\0", $i >> 3); $result ^= str_pad($temp, $size, "\0", STR_PAD_LEFT); } } return $result; } /** * Perform polynomial multiplation * * Uses karatsuba multiplication to reduce x-bit multiplications to a series of 32-bit multiplications * * @return string * @link https://en.wikipedia.org/wiki/Karatsuba_algorithm */ private static function polynomialMultiply($x, $y) { if (strlen($x) == strlen($y)) { $length = strlen($x); } else { $length = max(strlen($x), strlen($y)); $x = str_pad($x, $length, "\0", STR_PAD_LEFT); $y = str_pad($y, $length, "\0", STR_PAD_LEFT); } switch (true) { case PHP_INT_SIZE == 8 && $length <= 4: return $length != 4 ? self::subMultiply(str_pad($x, 4, "\0", STR_PAD_LEFT), str_pad($y, 4, "\0", STR_PAD_LEFT)) : self::subMultiply($x, $y); case PHP_INT_SIZE == 4 || $length > 32: return self::regularPolynomialMultiply($x, $y); } $m = $length >> 1; $x1 = substr($x, 0, -$m); $x0 = substr($x, -$m); $y1 = substr($y, 0, -$m); $y0 = substr($y, -$m); $z2 = self::polynomialMultiply($x1, $y1); $z0 = self::polynomialMultiply($x0, $y0); $z1 = self::polynomialMultiply( self::subAdd2($x1, $x0), self::subAdd2($y1, $y0) ); $z1 = self::subAdd3($z1, $z2, $z0); $xy = self::subAdd3( $z2 . str_repeat("\0", 2 * $m), $z1 . str_repeat("\0", $m), $z0 ); return ltrim($xy, "\0"); } /** * Perform polynomial multiplication on 2x 32-bit numbers, returning * a 64-bit number * * @param string $x * @param string $y * @return string * @link https://www.bearssl.org/constanttime.html#ghash-for-gcm */ private static function subMultiply($x, $y) { $x = unpack('N', $x)[1]; $y = unpack('N', $y)[1]; $x0 = $x & 0x11111111; $x1 = $x & 0x22222222; $x2 = $x & 0x44444444; $x3 = $x & 0x88888888; $y0 = $y & 0x11111111; $y1 = $y & 0x22222222; $y2 = $y & 0x44444444; $y3 = $y & 0x88888888; $z0 = ($x0 * $y0) ^ ($x1 * $y3) ^ ($x2 * $y2) ^ ($x3 * $y1); $z1 = ($x0 * $y1) ^ ($x1 * $y0) ^ ($x2 * $y3) ^ ($x3 * $y2); $z2 = ($x0 * $y2) ^ ($x1 * $y1) ^ ($x2 * $y0) ^ ($x3 * $y3); $z3 = ($x0 * $y3) ^ ($x1 * $y2) ^ ($x2 * $y1) ^ ($x3 * $y0); $z0 &= 0x1111111111111111; $z1 &= 0x2222222222222222; $z2 &= 0x4444444444444444; $z3 &= -8608480567731124088; // 0x8888888888888888 gets interpreted as a float $z = $z0 | $z1 | $z2 | $z3; return pack('J', $z); } /** * Adds two numbers * * @param string $x * @param string $y * @return string */ private static function subAdd2($x, $y) { $length = max(strlen($x), strlen($y)); $x = str_pad($x, $length, "\0", STR_PAD_LEFT); $y = str_pad($y, $length, "\0", STR_PAD_LEFT); return $x ^ $y; } /** * Adds three numbers * * @param string $x * @param string $y * @return string */ private static function subAdd3($x, $y, $z) { $length = max(strlen($x), strlen($y), strlen($z)); $x = str_pad($x, $length, "\0", STR_PAD_LEFT); $y = str_pad($y, $length, "\0", STR_PAD_LEFT); $z = str_pad($z, $length, "\0", STR_PAD_LEFT); return $x ^ $y ^ $z; } /** * Adds two BinaryFieldIntegers. * * @return static */ public function add(self $y) { static::checkInstance($this, $y); $length = strlen(static::$modulo[$this->instanceID]); $x = str_pad($this->value, $length, "\0", STR_PAD_LEFT); $y = str_pad($y->value, $length, "\0", STR_PAD_LEFT); return new static($this->instanceID, $x ^ $y); } /** * Subtracts two BinaryFieldIntegers. * * @return static */ public function subtract(self $x) { return $this->add($x); } /** * Multiplies two BinaryFieldIntegers. * * @return static */ public function multiply(self $y) { static::checkInstance($this, $y); return new static($this->instanceID, static::polynomialMultiply($this->value, $y->value)); } /** * Returns the modular inverse of a BinaryFieldInteger * * @return static */ public function modInverse() { $remainder0 = static::$modulo[$this->instanceID]; $remainder1 = $this->value; if ($remainder1 == '') { return new static($this->instanceID); } $aux0 = "\0"; $aux1 = "\1"; while ($remainder1 != "\1") { list($q, $r) = static::polynomialDivide($remainder0, $remainder1); $remainder0 = $remainder1; $remainder1 = $r; // the auxiliary in row n is given by the sum of the auxiliary in // row n-2 and the product of the quotient and the auxiliary in row // n-1 $temp = static::polynomialMultiply($aux1, $q); $aux = str_pad($aux0, strlen($temp), "\0", STR_PAD_LEFT) ^ str_pad($temp, strlen($aux0), "\0", STR_PAD_LEFT); $aux0 = $aux1; $aux1 = $aux; } $temp = new static($this->instanceID); $temp->value = ltrim($aux1, "\0"); return $temp; } /** * Divides two PrimeFieldIntegers. * * @return static */ public function divide(self $x) { static::checkInstance($this, $x); $x = $x->modInverse(); return $this->multiply($x); } /** * Negate * * A negative number can be written as 0-12. With modulos, 0 is the same thing as the modulo * so 0-12 is the same thing as modulo-12 * * @return object */ public function negate() { $x = str_pad($this->value, strlen(static::$modulo[$this->instanceID]), "\0", STR_PAD_LEFT); return new static($this->instanceID, $x ^ static::$modulo[$this->instanceID]); } /** * Returns the modulo * * @return string */ public static function getModulo($instanceID) { return static::$modulo[$instanceID]; } /** * Converts an Integer to a byte string (eg. base-256). * * @return string */ public function toBytes() { return str_pad($this->value, strlen(static::$modulo[$this->instanceID]), "\0", STR_PAD_LEFT); } /** * Converts an Integer to a hex string (eg. base-16). * * @return string */ public function toHex() { return Strings::bin2hex($this->toBytes()); } /** * Converts an Integer to a bit string (eg. base-2). * * @return string */ public function toBits() { //return str_pad(BinaryField::base256ToBase2($this->value), strlen(static::$modulo[$this->instanceID]), '0', STR_PAD_LEFT); return BinaryField::base256ToBase2($this->value); } /** * Converts an Integer to a BigInteger * * @return string */ public function toBigInteger() { return new BigInteger($this->value, 256); } /** * __toString() magic method * */ public function __toString() { return (string) $this->toBigInteger(); } /** * __debugInfo() magic method * */ public function __debugInfo() { return ['value' => $this->toHex()]; } } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License */ namespace phpseclib3\Math\Common\FiniteField; /** * Finite Field Integer * * @author Jim Wigginton */ abstract class Integer implements \JsonSerializable { /** * JSON Serialize * * Will be called, automatically, when json_encode() is called on a BigInteger object. * * PHP Serialize isn't supported because unserializing would require the factory be * serialized as well and that just sounds like too much */ #[\ReturnTypeWillChange] public function jsonSerialize() { return ['hex' => $this->toHex(true)]; } /** * Converts an Integer to a hex string (eg. base-16). * * @return string */ abstract public function toHex(); } * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License */ namespace phpseclib3\Math\Common; /** * Finite Fields * * @author Jim Wigginton */ abstract class FiniteField { } * add($b); * * echo $c->toString(); // outputs 5 * ?> * * * @author Jim Wigginton * @copyright 2017 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License */ namespace phpseclib3\Math; use phpseclib3\Exception\BadConfigurationException; use phpseclib3\Math\BigInteger\Engines\Engine; /** * Pure-PHP arbitrary precision integer arithmetic library. Supports base-2, base-10, base-16, and base-256 * numbers. * * @author Jim Wigginton */ class BigInteger implements \JsonSerializable { /** * Main Engine * * @var class-string */ private static $mainEngine; /** * Selected Engines * * @var list */ private static $engines; /** * The actual BigInteger object * * @var object */ private $value; /** * Mode independent value used for serialization. * * @see self::__sleep() * @see self::__wakeup() * @var string */ private $hex; /** * Precision (used only for serialization) * * @see self::__sleep() * @see self::__wakeup() * @var int */ private $precision; /** * Sets engine type. * * Throws an exception if the type is invalid * * @param string $main * @param list $modexps optional * @return void */ public static function setEngine($main, array $modexps = ['DefaultEngine']) { self::$engines = []; $fqmain = 'phpseclib3\\Math\\BigInteger\\Engines\\' . $main; if (!class_exists($fqmain) || !method_exists($fqmain, 'isValidEngine')) { throw new \InvalidArgumentException("$main is not a valid engine"); } if (!$fqmain::isValidEngine()) { throw new BadConfigurationException("$main is not setup correctly on this system"); } /** @var class-string $fqmain */ self::$mainEngine = $fqmain; if (!in_array('Default', $modexps)) { $modexps[] = 'DefaultEngine'; } $found = false; foreach ($modexps as $modexp) { try { $fqmain::setModExpEngine($modexp); $found = true; break; } catch (\Exception $e) { } } if (!$found) { throw new BadConfigurationException("No valid modular exponentiation engine found for $main"); } self::$engines = [$main, $modexp]; } /** * Returns the engine type * * @return string[] */ public static function getEngine() { self::initialize_static_variables(); return self::$engines; } /** * Initialize static variables */ private static function initialize_static_variables() { if (!isset(self::$mainEngine)) { $engines = [ ['GMP'], ['PHP64', ['OpenSSL']], ['BCMath', ['OpenSSL']], ['PHP32', ['OpenSSL']] ]; foreach ($engines as $engine) { try { self::setEngine($engine[0], isset($engine[1]) ? $engine[1] : []); break; } catch (\Exception $e) { } } } } /** * Converts base-2, base-10, base-16, and binary strings (base-256) to BigIntegers. * * If the second parameter - $base - is negative, then it will be assumed that the number's are encoded using * two's compliment. The sole exception to this is -10, which is treated the same as 10 is. * * @param string|int|BigInteger\Engines\Engine $x Base-10 number or base-$base number if $base set. * @param int $base */ public function __construct($x = 0, $base = 10) { self::initialize_static_variables(); if ($x instanceof self::$mainEngine) { $this->value = clone $x; } elseif ($x instanceof BigInteger\Engines\Engine) { $this->value = new static("$x"); $this->value->setPrecision($x->getPrecision()); } else { $this->value = new self::$mainEngine($x, $base); } } /** * Converts a BigInteger to a base-10 number. * * @return string */ public function toString() { return $this->value->toString(); } /** * __toString() magic method */ public function __toString() { return (string)$this->value; } /** * __debugInfo() magic method * * Will be called, automatically, when print_r() or var_dump() are called */ public function __debugInfo() { return $this->value->__debugInfo(); } /** * Converts a BigInteger to a byte string (eg. base-256). * * @param bool $twos_compliment * @return string */ public function toBytes($twos_compliment = false) { return $this->value->toBytes($twos_compliment); } /** * Converts a BigInteger to a hex string (eg. base-16). * * @param bool $twos_compliment * @return string */ public function toHex($twos_compliment = false) { return $this->value->toHex($twos_compliment); } /** * Converts a BigInteger to a bit string (eg. base-2). * * Negative numbers are saved as positive numbers, unless $twos_compliment is set to true, at which point, they're * saved as two's compliment. * * @param bool $twos_compliment * @return string */ public function toBits($twos_compliment = false) { return $this->value->toBits($twos_compliment); } /** * Adds two BigIntegers. * * @param BigInteger $y * @return BigInteger */ public function add(BigInteger $y) { return new static($this->value->add($y->value)); } /** * Subtracts two BigIntegers. * * @param BigInteger $y * @return BigInteger */ public function subtract(BigInteger $y) { return new static($this->value->subtract($y->value)); } /** * Multiplies two BigIntegers * * @param BigInteger $x * @return BigInteger */ public function multiply(BigInteger $x) { return new static($this->value->multiply($x->value)); } /** * Divides two BigIntegers. * * Returns an array whose first element contains the quotient and whose second element contains the * "common residue". If the remainder would be positive, the "common residue" and the remainder are the * same. If the remainder would be negative, the "common residue" is equal to the sum of the remainder * and the divisor (basically, the "common residue" is the first positive modulo). * * Here's an example: * * divide($b); * * echo $quotient->toString(); // outputs 0 * echo "\r\n"; * echo $remainder->toString(); // outputs 10 * ?> * * * @param BigInteger $y * @return BigInteger[] */ public function divide(BigInteger $y) { list($q, $r) = $this->value->divide($y->value); return [ new static($q), new static($r) ]; } /** * Calculates modular inverses. * * Say you have (30 mod 17 * x mod 17) mod 17 == 1. x can be found using modular inverses. * * @param BigInteger $n * @return BigInteger */ public function modInverse(BigInteger $n) { return new static($this->value->modInverse($n->value)); } /** * Calculates modular inverses. * * Say you have (30 mod 17 * x mod 17) mod 17 == 1. x can be found using modular inverses. * * @param BigInteger $n * @return BigInteger[] */ public function extendedGCD(BigInteger $n) { extract($this->value->extendedGCD($n->value)); /** * @var BigInteger $gcd * @var BigInteger $x * @var BigInteger $y */ return [ 'gcd' => new static($gcd), 'x' => new static($x), 'y' => new static($y) ]; } /** * Calculates the greatest common divisor * * Say you have 693 and 609. The GCD is 21. * * @param BigInteger $n * @return BigInteger */ public function gcd(BigInteger $n) { return new static($this->value->gcd($n->value)); } /** * Absolute value. * * @return BigInteger */ public function abs() { return new static($this->value->abs()); } /** * Set Precision * * Some bitwise operations give different results depending on the precision being used. Examples include left * shift, not, and rotates. * * @param int $bits */ public function setPrecision($bits) { $this->value->setPrecision($bits); } /** * Get Precision * * Returns the precision if it exists, false if it doesn't * * @return int|bool */ public function getPrecision() { return $this->value->getPrecision(); } /** * Serialize * * Will be called, automatically, when serialize() is called on a BigInteger object. * * __sleep() / __wakeup() have been around since PHP 4.0 * * \Serializable was introduced in PHP 5.1 and deprecated in PHP 8.1: * https://wiki.php.net/rfc/phase_out_serializable * * __serialize() / __unserialize() were introduced in PHP 7.4: * https://wiki.php.net/rfc/custom_object_serialization * * @return array */ public function __sleep() { $this->hex = $this->toHex(true); $vars = ['hex']; if ($this->getPrecision() > 0) { $vars[] = 'precision'; } return $vars; } /** * Serialize * * Will be called, automatically, when unserialize() is called on a BigInteger object. */ public function __wakeup() { $temp = new static($this->hex, -16); $this->value = $temp->value; if ($this->precision > 0) { // recalculate $this->bitmask $this->setPrecision($this->precision); } } /** * JSON Serialize * * Will be called, automatically, when json_encode() is called on a BigInteger object. */ #[\ReturnTypeWillChange] public function jsonSerialize() { $result = ['hex' => $this->toHex(true)]; if ($this->precision > 0) { $result['precision'] = $this->getPrecision(); } return $result; } /** * Performs modular exponentiation. * * @param BigInteger $e * @param BigInteger $n * @return BigInteger */ public function powMod(BigInteger $e, BigInteger $n) { return new static($this->value->powMod($e->value, $n->value)); } /** * Performs modular exponentiation. * * @param BigInteger $e * @param BigInteger $n * @return BigInteger */ public function modPow(BigInteger $e, BigInteger $n) { return new static($this->value->modPow($e->value, $n->value)); } /** * Compares two numbers. * * Although one might think !$x->compare($y) means $x != $y, it, in fact, means the opposite. The reason for this * is demonstrated thusly: * * $x > $y: $x->compare($y) > 0 * $x < $y: $x->compare($y) < 0 * $x == $y: $x->compare($y) == 0 * * Note how the same comparison operator is used. If you want to test for equality, use $x->equals($y). * * {@internal Could return $this->subtract($x), but that's not as fast as what we do do.} * * @param BigInteger $y * @return int in case < 0 if $this is less than $y; > 0 if $this is greater than $y, and 0 if they are equal. * @see self::equals() */ public function compare(BigInteger $y) { return $this->value->compare($y->value); } /** * Tests the equality of two numbers. * * If you need to see if one number is greater than or less than another number, use BigInteger::compare() * * @param BigInteger $x * @return bool */ public function equals(BigInteger $x) { return $this->value->equals($x->value); } /** * Logical Not * * @return BigInteger */ public function bitwise_not() { return new static($this->value->bitwise_not()); } /** * Logical And * * @param BigInteger $x * @return BigInteger */ public function bitwise_and(BigInteger $x) { return new static($this->value->bitwise_and($x->value)); } /** * Logical Or * * @param BigInteger $x * @return BigInteger */ public function bitwise_or(BigInteger $x) { return new static($this->value->bitwise_or($x->value)); } /** * Logical Exclusive Or * * @param BigInteger $x * @return BigInteger */ public function bitwise_xor(BigInteger $x) { return new static($this->value->bitwise_xor($x->value)); } /** * Logical Right Shift * * Shifts BigInteger's by $shift bits, effectively dividing by 2**$shift. * * @param int $shift * @return BigInteger */ public function bitwise_rightShift($shift) { return new static($this->value->bitwise_rightShift($shift)); } /** * Logical Left Shift * * Shifts BigInteger's by $shift bits, effectively multiplying by 2**$shift. * * @param int $shift * @return BigInteger */ public function bitwise_leftShift($shift) { return new static($this->value->bitwise_leftShift($shift)); } /** * Logical Left Rotate * * Instead of the top x bits being dropped they're appended to the shifted bit string. * * @param int $shift * @return BigInteger */ public function bitwise_leftRotate($shift) { return new static($this->value->bitwise_leftRotate($shift)); } /** * Logical Right Rotate * * Instead of the bottom x bits being dropped they're prepended to the shifted bit string. * * @param int $shift * @return BigInteger */ public function bitwise_rightRotate($shift) { return new static($this->value->bitwise_rightRotate($shift)); } /** * Returns the smallest and largest n-bit number * * @param int $bits * @return BigInteger[] */ public static function minMaxBits($bits) { self::initialize_static_variables(); $class = self::$mainEngine; extract($class::minMaxBits($bits)); /** @var BigInteger $min * @var BigInteger $max */ return [ 'min' => new static($min), 'max' => new static($max) ]; } /** * Return the size of a BigInteger in bits * * @return int */ public function getLength() { return $this->value->getLength(); } /** * Return the size of a BigInteger in bytes * * @return int */ public function getLengthInBytes() { return $this->value->getLengthInBytes(); } /** * Generates a random number of a certain size * * Bit length is equal to $size * * @param int $size * @return BigInteger */ public static function random($size) { self::initialize_static_variables(); $class = self::$mainEngine; return new static($class::random($size)); } /** * Generates a random prime number of a certain size * * Bit length is equal to $size * * @param int $size * @return BigInteger */ public static function randomPrime($size) { self::initialize_static_variables(); $class = self::$mainEngine; return new static($class::randomPrime($size)); } /** * Generate a random prime number between a range * * If there's not a prime within the given range, false will be returned. * * @param BigInteger $min * @param BigInteger $max * @return false|BigInteger */ public static function randomRangePrime(BigInteger $min, BigInteger $max) { $class = self::$mainEngine; return new static($class::randomRangePrime($min->value, $max->value)); } /** * Generate a random number between a range * * Returns a random number between $min and $max where $min and $max * can be defined using one of the two methods: * * BigInteger::randomRange($min, $max) * BigInteger::randomRange($max, $min) * * @param BigInteger $min * @param BigInteger $max * @return BigInteger */ public static function randomRange(BigInteger $min, BigInteger $max) { $class = self::$mainEngine; return new static($class::randomRange($min->value, $max->value)); } /** * Checks a numer to see if it's prime * * Assuming the $t parameter is not set, this function has an error rate of 2**-80. The main motivation for the * $t parameter is distributability. BigInteger::randomPrime() can be distributed across multiple pageloads * on a website instead of just one. * * @param int|bool $t * @return bool */ public function isPrime($t = false) { return $this->value->isPrime($t); } /** * Calculates the nth root of a biginteger. * * Returns the nth root of a positive biginteger, where n defaults to 2 * * @param int $n optional * @return BigInteger */ public function root($n = 2) { return new static($this->value->root($n)); } /** * Performs exponentiation. * * @param BigInteger $n * @return BigInteger */ public function pow(BigInteger $n) { return new static($this->value->pow($n->value)); } /** * Return the minimum BigInteger between an arbitrary number of BigIntegers. * * @param BigInteger ...$nums * @return BigInteger */ public static function min(BigInteger ...$nums) { $class = self::$mainEngine; $nums = array_map(function ($num) { return $num->value; }, $nums); return new static($class::min(...$nums)); } /** * Return the maximum BigInteger between an arbitrary number of BigIntegers. * * @param BigInteger ...$nums * @return BigInteger */ public static function max(BigInteger ...$nums) { $class = self::$mainEngine; $nums = array_map(function ($num) { return $num->value; }, $nums); return new static($class::max(...$nums)); } /** * Tests BigInteger to see if it is between two integers, inclusive * * @param BigInteger $min * @param BigInteger $max * @return bool */ public function between(BigInteger $min, BigInteger $max) { return $this->value->between($min->value, $max->value); } /** * Clone */ public function __clone() { $this->value = clone $this->value; } /** * Is Odd? * * @return bool */ public function isOdd() { return $this->value->isOdd(); } /** * Tests if a bit is set * * @param int $x * @return bool */ public function testBit($x) { return $this->value->testBit($x); } /** * Is Negative? * * @return bool */ public function isNegative() { return $this->value->isNegative(); } /** * Negate * * Given $k, returns -$k * * @return BigInteger */ public function negate() { return new static($this->value->negate()); } /** * Scan for 1 and right shift by that amount * * ie. $s = gmp_scan1($n, 0) and $r = gmp_div_q($n, gmp_pow(gmp_init('2'), $s)); * * @param BigInteger $r * @return int */ public static function scan1divide(BigInteger $r) { $class = self::$mainEngine; return $class::scan1divide($r->value); } /** * Create Recurring Modulo Function * * Sometimes it may be desirable to do repeated modulos with the same number outside of * modular exponentiation * * @return callable */ public function createRecurringModuloFunction() { $func = $this->value->createRecurringModuloFunction(); return function (BigInteger $x) use ($func) { return new static($func($x->value)); }; } /** * Bitwise Split * * Splits BigInteger's into chunks of $split bits * * @param int $split * @return BigInteger[] */ public function bitwise_split($split) { return array_map(function ($val) { return new static($val); }, $this->value->bitwise_split($split)); } } * login('username', 'password')) { * exit('Login Failed'); * } * * echo $ssh->exec('pwd'); * echo $ssh->exec('ls -la'); * ?> * * * * login('username', $key)) { * exit('Login Failed'); * } * * echo $ssh->read('username@username:~$'); * $ssh->write("ls -la\n"); * echo $ssh->read('username@username:~$'); * ?> * * * @author Jim Wigginton * @copyright 2007 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Net; use phpseclib3\Common\Functions\Strings; use phpseclib3\Crypt\Blowfish; use phpseclib3\Crypt\ChaCha20; use phpseclib3\Crypt\Common\AsymmetricKey; use phpseclib3\Crypt\Common\PrivateKey; use phpseclib3\Crypt\Common\PublicKey; use phpseclib3\Crypt\Common\SymmetricKey; use phpseclib3\Crypt\DH; use phpseclib3\Crypt\DSA; use phpseclib3\Crypt\EC; use phpseclib3\Crypt\Hash; use phpseclib3\Crypt\Random; use phpseclib3\Crypt\RC4; use phpseclib3\Crypt\Rijndael; use phpseclib3\Crypt\RSA; use phpseclib3\Crypt\TripleDES; // Used to do Diffie-Hellman key exchange and DSA/RSA signature verification. use phpseclib3\Crypt\Twofish; use phpseclib3\Exception\ConnectionClosedException; use phpseclib3\Exception\InsufficientSetupException; use phpseclib3\Exception\NoSupportedAlgorithmsException; use phpseclib3\Exception\UnableToConnectException; use phpseclib3\Exception\UnsupportedAlgorithmException; use phpseclib3\Exception\UnsupportedCurveException; use phpseclib3\Math\BigInteger; use phpseclib3\System\SSH\Agent; /** * Pure-PHP implementation of SSHv2. * * @author Jim Wigginton */ class SSH2 { /**#@+ * Compression Types * */ /** * No compression */ const NET_SSH2_COMPRESSION_NONE = 1; /** * zlib compression */ const NET_SSH2_COMPRESSION_ZLIB = 2; /** * zlib@openssh.com */ const NET_SSH2_COMPRESSION_ZLIB_AT_OPENSSH = 3; /**#@-*/ // Execution Bitmap Masks const MASK_CONSTRUCTOR = 0x00000001; const MASK_CONNECTED = 0x00000002; const MASK_LOGIN_REQ = 0x00000004; const MASK_LOGIN = 0x00000008; const MASK_SHELL = 0x00000010; const MASK_WINDOW_ADJUST = 0x00000020; /* * Channel constants * * RFC4254 refers not to client and server channels but rather to sender and recipient channels. we don't refer * to them in that way because RFC4254 toggles the meaning. the client sends a SSH_MSG_CHANNEL_OPEN message with * a sender channel and the server sends a SSH_MSG_CHANNEL_OPEN_CONFIRMATION in response, with a sender and a * recipient channel. at first glance, you might conclude that SSH_MSG_CHANNEL_OPEN_CONFIRMATION's sender channel * would be the same thing as SSH_MSG_CHANNEL_OPEN's sender channel, but it's not, per this snippet: * The 'recipient channel' is the channel number given in the original * open request, and 'sender channel' is the channel number allocated by * the other side. * * @see \phpseclib3\Net\SSH2::send_channel_packet() * @see \phpseclib3\Net\SSH2::get_channel_packet() */ const CHANNEL_EXEC = 1; // PuTTy uses 0x100 const CHANNEL_SHELL = 2; const CHANNEL_SUBSYSTEM = 3; const CHANNEL_AGENT_FORWARD = 4; const CHANNEL_KEEP_ALIVE = 5; /** * Returns the message numbers * * @see \phpseclib3\Net\SSH2::getLog() */ const LOG_SIMPLE = 1; /** * Returns the message content * * @see \phpseclib3\Net\SSH2::getLog() */ const LOG_COMPLEX = 2; /** * Outputs the content real-time */ const LOG_REALTIME = 3; /** * Dumps the content real-time to a file */ const LOG_REALTIME_FILE = 4; /** * Outputs the message numbers real-time */ const LOG_SIMPLE_REALTIME = 5; /** * Make sure that the log never gets larger than this * * @see \phpseclib3\Net\SSH2::getLog() */ const LOG_MAX_SIZE = 1048576; // 1024 * 1024 /** * Returns when a string matching $expect exactly is found * * @see \phpseclib3\Net\SSH2::read() */ const READ_SIMPLE = 1; /** * Returns when a string matching the regular expression $expect is found * * @see \phpseclib3\Net\SSH2::read() */ const READ_REGEX = 2; /** * Returns whenever a data packet is received. * * Some data packets may only contain a single character so it may be necessary * to call read() multiple times when using this option * * @see \phpseclib3\Net\SSH2::read() */ const READ_NEXT = 3; /** * The SSH identifier * * @var string */ private $identifier; /** * The Socket Object * * @var resource|closed-resource|null */ public $fsock; /** * Execution Bitmap * * The bits that are set represent functions that have been called already. This is used to determine * if a requisite function has been successfully executed. If not, an error should be thrown. * * @var int */ protected $bitmap = 0; /** * Error information * * @see self::getErrors() * @see self::getLastError() * @var array */ private $errors = []; /** * Server Identifier * * @see self::getServerIdentification() * @var string|false */ protected $server_identifier = false; /** * Key Exchange Algorithms * * @see self::getKexAlgorithims() * @var array|false */ private $kex_algorithms = false; /** * Key Exchange Algorithm * * @see self::getMethodsNegotiated() * @var string|false */ private $kex_algorithm = false; /** * Minimum Diffie-Hellman Group Bit Size in RFC 4419 Key Exchange Methods * * @see self::_key_exchange() * @var int */ private $kex_dh_group_size_min = 1536; /** * Preferred Diffie-Hellman Group Bit Size in RFC 4419 Key Exchange Methods * * @see self::_key_exchange() * @var int */ private $kex_dh_group_size_preferred = 2048; /** * Maximum Diffie-Hellman Group Bit Size in RFC 4419 Key Exchange Methods * * @see self::_key_exchange() * @var int */ private $kex_dh_group_size_max = 4096; /** * Server Host Key Algorithms * * @see self::getServerHostKeyAlgorithms() * @var array|false */ private $server_host_key_algorithms = false; /** * Supported Private Key Algorithms * * In theory this should be the same as the Server Host Key Algorithms but, in practice, * some servers (eg. Azure) will support rsa-sha2-512 as a server host key algorithm but * not a private key algorithm * * @see self::privatekey_login() * @var array|false */ private $supported_private_key_algorithms = false; /** * Encryption Algorithms: Client to Server * * @see self::getEncryptionAlgorithmsClient2Server() * @var array|false */ private $encryption_algorithms_client_to_server = false; /** * Encryption Algorithms: Server to Client * * @see self::getEncryptionAlgorithmsServer2Client() * @var array|false */ private $encryption_algorithms_server_to_client = false; /** * MAC Algorithms: Client to Server * * @see self::getMACAlgorithmsClient2Server() * @var array|false */ private $mac_algorithms_client_to_server = false; /** * MAC Algorithms: Server to Client * * @see self::getMACAlgorithmsServer2Client() * @var array|false */ private $mac_algorithms_server_to_client = false; /** * Compression Algorithms: Client to Server * * @see self::getCompressionAlgorithmsClient2Server() * @var array|false */ private $compression_algorithms_client_to_server = false; /** * Compression Algorithms: Server to Client * * @see self::getCompressionAlgorithmsServer2Client() * @var array|false */ private $compression_algorithms_server_to_client = false; /** * Languages: Server to Client * * @see self::getLanguagesServer2Client() * @var array|false */ private $languages_server_to_client = false; /** * Languages: Client to Server * * @see self::getLanguagesClient2Server() * @var array|false */ private $languages_client_to_server = false; /** * Preferred Algorithms * * @see self::setPreferredAlgorithms() * @var array */ private $preferred = []; /** * Block Size for Server to Client Encryption * * "Note that the length of the concatenation of 'packet_length', * 'padding_length', 'payload', and 'random padding' MUST be a multiple * of the cipher block size or 8, whichever is larger. This constraint * MUST be enforced, even when using stream ciphers." * * -- http://tools.ietf.org/html/rfc4253#section-6 * * @see self::__construct() * @see self::_send_binary_packet() * @var int */ private $encrypt_block_size = 8; /** * Block Size for Client to Server Encryption * * @see self::__construct() * @see self::_get_binary_packet() * @var int */ private $decrypt_block_size = 8; /** * Server to Client Encryption Object * * @see self::_get_binary_packet() * @var SymmetricKey|false */ private $decrypt = false; /** * Decryption Algorithm Name * * @var string|null */ private $decryptName; /** * Decryption Invocation Counter * * Used by GCM * * @var string|null */ private $decryptInvocationCounter; /** * Fixed Part of Nonce * * Used by GCM * * @var string|null */ private $decryptFixedPart; /** * Server to Client Length Encryption Object * * @see self::_get_binary_packet() * @var object */ private $lengthDecrypt = false; /** * Client to Server Encryption Object * * @see self::_send_binary_packet() * @var SymmetricKey|false */ private $encrypt = false; /** * Encryption Algorithm Name * * @var string|null */ private $encryptName; /** * Encryption Invocation Counter * * Used by GCM * * @var string|null */ private $encryptInvocationCounter; /** * Fixed Part of Nonce * * Used by GCM * * @var string|null */ private $encryptFixedPart; /** * Client to Server Length Encryption Object * * @see self::_send_binary_packet() * @var object */ private $lengthEncrypt = false; /** * Client to Server HMAC Object * * @see self::_send_binary_packet() * @var object */ private $hmac_create = false; /** * Client to Server HMAC Name * * @var string|false */ private $hmac_create_name; /** * Client to Server ETM * * @var int|false */ private $hmac_create_etm; /** * Server to Client HMAC Object * * @see self::_get_binary_packet() * @var object */ private $hmac_check = false; /** * Server to Client HMAC Name * * @var string|false */ private $hmac_check_name; /** * Server to Client ETM * * @var int|false */ private $hmac_check_etm; /** * Size of server to client HMAC * * We need to know how big the HMAC will be for the server to client direction so that we know how many bytes to read. * For the client to server side, the HMAC object will make the HMAC as long as it needs to be. All we need to do is * append it. * * @see self::_get_binary_packet() * @var int */ private $hmac_size = false; /** * Server Public Host Key * * @see self::getServerPublicHostKey() * @var string */ private $server_public_host_key; /** * Session identifier * * "The exchange hash H from the first key exchange is additionally * used as the session identifier, which is a unique identifier for * this connection." * * -- http://tools.ietf.org/html/rfc4253#section-7.2 * * @see self::_key_exchange() * @var string */ private $session_id = false; /** * Exchange hash * * The current exchange hash * * @see self::_key_exchange() * @var string */ private $exchange_hash = false; /** * Message Numbers * * @see self::__construct() * @var array * @access private */ private $message_numbers = []; /** * Disconnection Message 'reason codes' defined in RFC4253 * * @see self::__construct() * @var array * @access private */ private $disconnect_reasons = []; /** * SSH_MSG_CHANNEL_OPEN_FAILURE 'reason codes', defined in RFC4254 * * @see self::__construct() * @var array * @access private */ private $channel_open_failure_reasons = []; /** * Terminal Modes * * @link http://tools.ietf.org/html/rfc4254#section-8 * @see self::__construct() * @var array * @access private */ private $terminal_modes = []; /** * SSH_MSG_CHANNEL_EXTENDED_DATA's data_type_codes * * @link http://tools.ietf.org/html/rfc4254#section-5.2 * @see self::__construct() * @var array * @access private */ private $channel_extended_data_type_codes = []; /** * Send Sequence Number * * See 'Section 6.4. Data Integrity' of rfc4253 for more info. * * @see self::_send_binary_packet() * @var int */ private $send_seq_no = 0; /** * Get Sequence Number * * See 'Section 6.4. Data Integrity' of rfc4253 for more info. * * @see self::_get_binary_packet() * @var int */ private $get_seq_no = 0; /** * Server Channels * * Maps client channels to server channels * * @see self::get_channel_packet() * @see self::exec() * @var array */ protected $server_channels = []; /** * Channel Buffers * * If a client requests a packet from one channel but receives two packets from another those packets should * be placed in a buffer * * @see self::get_channel_packet() * @see self::exec() * @var array */ private $channel_buffers = []; /** * Channel Status * * Contains the type of the last sent message * * @see self::get_channel_packet() * @var array */ protected $channel_status = []; /** * Packet Size * * Maximum packet size indexed by channel * * @see self::send_channel_packet() * @var array */ private $packet_size_client_to_server = []; /** * Message Number Log * * @see self::getLog() * @var array */ private $message_number_log = []; /** * Message Log * * @see self::getLog() * @var array */ private $message_log = []; /** * The Window Size * * Bytes the other party can send before it must wait for the window to be adjusted (0x7FFFFFFF = 2GB) * * @var int * @see self::send_channel_packet() * @see self::exec() */ protected $window_size = 0x7FFFFFFF; /** * What we resize the window to * * When PuTTY resizes the window it doesn't add an additional 0x7FFFFFFF bytes - it adds 0x40000000 bytes. * Some SFTP clients (GoAnywhere) don't support adding 0x7FFFFFFF to the window size after the fact so * we'll just do what PuTTY does * * @var int * @see self::_send_channel_packet() * @see self::exec() */ private $window_resize = 0x40000000; /** * Window size, server to client * * Window size indexed by channel * * @see self::send_channel_packet() * @var array */ protected $window_size_server_to_client = []; /** * Window size, client to server * * Window size indexed by channel * * @see self::get_channel_packet() * @var array */ private $window_size_client_to_server = []; /** * Server signature * * Verified against $this->session_id * * @see self::getServerPublicHostKey() * @var string */ private $signature = ''; /** * Server signature format * * ssh-rsa or ssh-dss. * * @see self::getServerPublicHostKey() * @var string */ private $signature_format = ''; /** * Interactive Buffer * * @see self::read() * @var string */ private $interactiveBuffer = ''; /** * Current log size * * Should never exceed self::LOG_MAX_SIZE * * @see self::_send_binary_packet() * @see self::_get_binary_packet() * @var int */ private $log_size; /** * Timeout * * @see self::setTimeout() */ protected $timeout; /** * Current Timeout * * @see self::get_channel_packet() */ protected $curTimeout; /** * Keep Alive Interval * * @see self::setKeepAlive() */ private $keepAlive; /** * Real-time log file pointer * * @see self::_append_log() * @var resource|closed-resource */ private $realtime_log_file; /** * Real-time log file size * * @see self::_append_log() * @var int */ private $realtime_log_size; /** * Has the signature been validated? * * @see self::getServerPublicHostKey() * @var bool */ private $signature_validated = false; /** * Real-time log file wrap boolean * * @see self::_append_log() * @var bool */ private $realtime_log_wrap; /** * Flag to suppress stderr from output * * @see self::enableQuietMode() */ private $quiet_mode = false; /** * Time of first network activity * * @var float */ private $last_packet; /** * Exit status returned from ssh if any * * @var int */ private $exit_status; /** * Flag to request a PTY when using exec() * * @var bool * @see self::enablePTY() */ private $request_pty = false; /** * Flag set while exec() is running when using enablePTY() * * @var bool */ private $in_request_pty_exec = false; /** * Flag set after startSubsystem() is called * * @var bool */ private $in_subsystem; /** * Contents of stdError * * @var string */ private $stdErrorLog; /** * The Last Interactive Response * * @see self::_keyboard_interactive_process() * @var string */ private $last_interactive_response = ''; /** * Keyboard Interactive Request / Responses * * @see self::_keyboard_interactive_process() * @var array */ private $keyboard_requests_responses = []; /** * Banner Message * * Quoting from the RFC, "in some jurisdictions, sending a warning message before * authentication may be relevant for getting legal protection." * * @see self::_filter() * @see self::getBannerMessage() * @var string */ private $banner_message = ''; /** * Did read() timeout or return normally? * * @see self::isTimeout() * @var bool */ private $is_timeout = false; /** * Log Boundary * * @see self::_format_log() * @var string */ private $log_boundary = ':'; /** * Log Long Width * * @see self::_format_log() * @var int */ private $log_long_width = 65; /** * Log Short Width * * @see self::_format_log() * @var int */ private $log_short_width = 16; /** * Hostname * * @see self::__construct() * @see self::_connect() * @var string */ private $host; /** * Port Number * * @see self::__construct() * @see self::_connect() * @var int */ private $port; /** * Number of columns for terminal window size * * @see self::getWindowColumns() * @see self::setWindowColumns() * @see self::setWindowSize() * @var int */ private $windowColumns = 80; /** * Number of columns for terminal window size * * @see self::getWindowRows() * @see self::setWindowRows() * @see self::setWindowSize() * @var int */ private $windowRows = 24; /** * Crypto Engine * * @see self::setCryptoEngine() * @see self::_key_exchange() * @var int */ private static $crypto_engine = false; /** * A System_SSH_Agent for use in the SSH2 Agent Forwarding scenario * * @var Agent */ private $agent; /** * Connection storage to replicates ssh2 extension functionality: * {@link http://php.net/manual/en/wrappers.ssh2.php#refsect1-wrappers.ssh2-examples} * * @var array> */ private static $connections; /** * Send the identification string first? * * @var bool */ private $send_id_string_first = true; /** * Send the key exchange initiation packet first? * * @var bool */ private $send_kex_first = true; /** * Some versions of OpenSSH incorrectly calculate the key size * * @var bool */ private $bad_key_size_fix = false; /** * Should we try to re-connect to re-establish keys? * * @var bool */ private $retry_connect = false; /** * Binary Packet Buffer * * @var string|false */ private $binary_packet_buffer = false; /** * Preferred Signature Format * * @var string|false */ protected $preferred_signature_format = false; /** * Authentication Credentials * * @var array */ protected $auth = []; /** * Terminal * * @var string */ private $term = 'vt100'; /** * The authentication methods that may productively continue authentication. * * @see https://tools.ietf.org/html/rfc4252#section-5.1 * @var array|null */ private $auth_methods_to_continue = null; /** * Compression method * * @var int */ private $compress = self::NET_SSH2_COMPRESSION_NONE; /** * Decompression method * * @var int */ private $decompress = self::NET_SSH2_COMPRESSION_NONE; /** * Compression context * * @var resource|false|null */ private $compress_context; /** * Decompression context * * @var resource|object */ private $decompress_context; /** * Regenerate Compression Context * * @var bool */ private $regenerate_compression_context = false; /** * Regenerate Decompression Context * * @var bool */ private $regenerate_decompression_context = false; /** * Smart multi-factor authentication flag * * @var bool */ private $smartMFA = true; /** * Default Constructor. * * $host can either be a string, representing the host, or a stream resource. * * @param mixed $host * @param int $port * @param int $timeout * @see self::login() */ public function __construct($host, $port = 22, $timeout = 10) { $this->message_numbers = [ 1 => 'NET_SSH2_MSG_DISCONNECT', 2 => 'NET_SSH2_MSG_IGNORE', 3 => 'NET_SSH2_MSG_UNIMPLEMENTED', 4 => 'NET_SSH2_MSG_DEBUG', 5 => 'NET_SSH2_MSG_SERVICE_REQUEST', 6 => 'NET_SSH2_MSG_SERVICE_ACCEPT', 20 => 'NET_SSH2_MSG_KEXINIT', 21 => 'NET_SSH2_MSG_NEWKEYS', 30 => 'NET_SSH2_MSG_KEXDH_INIT', 31 => 'NET_SSH2_MSG_KEXDH_REPLY', 50 => 'NET_SSH2_MSG_USERAUTH_REQUEST', 51 => 'NET_SSH2_MSG_USERAUTH_FAILURE', 52 => 'NET_SSH2_MSG_USERAUTH_SUCCESS', 53 => 'NET_SSH2_MSG_USERAUTH_BANNER', 80 => 'NET_SSH2_MSG_GLOBAL_REQUEST', 81 => 'NET_SSH2_MSG_REQUEST_SUCCESS', 82 => 'NET_SSH2_MSG_REQUEST_FAILURE', 90 => 'NET_SSH2_MSG_CHANNEL_OPEN', 91 => 'NET_SSH2_MSG_CHANNEL_OPEN_CONFIRMATION', 92 => 'NET_SSH2_MSG_CHANNEL_OPEN_FAILURE', 93 => 'NET_SSH2_MSG_CHANNEL_WINDOW_ADJUST', 94 => 'NET_SSH2_MSG_CHANNEL_DATA', 95 => 'NET_SSH2_MSG_CHANNEL_EXTENDED_DATA', 96 => 'NET_SSH2_MSG_CHANNEL_EOF', 97 => 'NET_SSH2_MSG_CHANNEL_CLOSE', 98 => 'NET_SSH2_MSG_CHANNEL_REQUEST', 99 => 'NET_SSH2_MSG_CHANNEL_SUCCESS', 100 => 'NET_SSH2_MSG_CHANNEL_FAILURE' ]; $this->disconnect_reasons = [ 1 => 'NET_SSH2_DISCONNECT_HOST_NOT_ALLOWED_TO_CONNECT', 2 => 'NET_SSH2_DISCONNECT_PROTOCOL_ERROR', 3 => 'NET_SSH2_DISCONNECT_KEY_EXCHANGE_FAILED', 4 => 'NET_SSH2_DISCONNECT_RESERVED', 5 => 'NET_SSH2_DISCONNECT_MAC_ERROR', 6 => 'NET_SSH2_DISCONNECT_COMPRESSION_ERROR', 7 => 'NET_SSH2_DISCONNECT_SERVICE_NOT_AVAILABLE', 8 => 'NET_SSH2_DISCONNECT_PROTOCOL_VERSION_NOT_SUPPORTED', 9 => 'NET_SSH2_DISCONNECT_HOST_KEY_NOT_VERIFIABLE', 10 => 'NET_SSH2_DISCONNECT_CONNECTION_LOST', 11 => 'NET_SSH2_DISCONNECT_BY_APPLICATION', 12 => 'NET_SSH2_DISCONNECT_TOO_MANY_CONNECTIONS', 13 => 'NET_SSH2_DISCONNECT_AUTH_CANCELLED_BY_USER', 14 => 'NET_SSH2_DISCONNECT_NO_MORE_AUTH_METHODS_AVAILABLE', 15 => 'NET_SSH2_DISCONNECT_ILLEGAL_USER_NAME' ]; $this->channel_open_failure_reasons = [ 1 => 'NET_SSH2_OPEN_ADMINISTRATIVELY_PROHIBITED' ]; $this->terminal_modes = [ 0 => 'NET_SSH2_TTY_OP_END' ]; $this->channel_extended_data_type_codes = [ 1 => 'NET_SSH2_EXTENDED_DATA_STDERR' ]; $this->define_array( $this->message_numbers, $this->disconnect_reasons, $this->channel_open_failure_reasons, $this->terminal_modes, $this->channel_extended_data_type_codes, [60 => 'NET_SSH2_MSG_USERAUTH_PASSWD_CHANGEREQ'], [60 => 'NET_SSH2_MSG_USERAUTH_PK_OK'], [60 => 'NET_SSH2_MSG_USERAUTH_INFO_REQUEST', 61 => 'NET_SSH2_MSG_USERAUTH_INFO_RESPONSE'], // RFC 4419 - diffie-hellman-group-exchange-sha{1,256} [30 => 'NET_SSH2_MSG_KEXDH_GEX_REQUEST_OLD', 31 => 'NET_SSH2_MSG_KEXDH_GEX_GROUP', 32 => 'NET_SSH2_MSG_KEXDH_GEX_INIT', 33 => 'NET_SSH2_MSG_KEXDH_GEX_REPLY', 34 => 'NET_SSH2_MSG_KEXDH_GEX_REQUEST'], // RFC 5656 - Elliptic Curves (for curve25519-sha256@libssh.org) [30 => 'NET_SSH2_MSG_KEX_ECDH_INIT', 31 => 'NET_SSH2_MSG_KEX_ECDH_REPLY'] ); /** * Typehint is required due to a bug in Psalm: https://github.com/vimeo/psalm/issues/7508 * @var \WeakReference|SSH2 */ self::$connections[$this->getResourceId()] = class_exists('WeakReference') ? \WeakReference::create($this) : $this; if (is_resource($host)) { $this->fsock = $host; return; } if (Strings::is_stringable($host)) { $this->host = $host; $this->port = $port; $this->timeout = $timeout; } } /** * Set Crypto Engine Mode * * Possible $engine values: * OpenSSL, mcrypt, Eval, PHP * * @param int $engine */ public static function setCryptoEngine($engine) { self::$crypto_engine = $engine; } /** * Send Identification String First * * https://tools.ietf.org/html/rfc4253#section-4.2 says "when the connection has been established, * both sides MUST send an identification string". It does not say which side sends it first. In * theory it shouldn't matter but it is a fact of life that some SSH servers are simply buggy * */ public function sendIdentificationStringFirst() { $this->send_id_string_first = true; } /** * Send Identification String Last * * https://tools.ietf.org/html/rfc4253#section-4.2 says "when the connection has been established, * both sides MUST send an identification string". It does not say which side sends it first. In * theory it shouldn't matter but it is a fact of life that some SSH servers are simply buggy * */ public function sendIdentificationStringLast() { $this->send_id_string_first = false; } /** * Send SSH_MSG_KEXINIT First * * https://tools.ietf.org/html/rfc4253#section-7.1 says "key exchange begins by each sending * sending the [SSH_MSG_KEXINIT] packet". It does not say which side sends it first. In theory * it shouldn't matter but it is a fact of life that some SSH servers are simply buggy * */ public function sendKEXINITFirst() { $this->send_kex_first = true; } /** * Send SSH_MSG_KEXINIT Last * * https://tools.ietf.org/html/rfc4253#section-7.1 says "key exchange begins by each sending * sending the [SSH_MSG_KEXINIT] packet". It does not say which side sends it first. In theory * it shouldn't matter but it is a fact of life that some SSH servers are simply buggy * */ public function sendKEXINITLast() { $this->send_kex_first = false; } /** * Connect to an SSHv2 server * * @throws \UnexpectedValueException on receipt of unexpected packets * @throws \RuntimeException on other errors */ private function connect() { if ($this->bitmap & self::MASK_CONSTRUCTOR) { return; } $this->bitmap |= self::MASK_CONSTRUCTOR; $this->curTimeout = $this->timeout; $this->last_packet = microtime(true); if (!is_resource($this->fsock)) { $start = microtime(true); // with stream_select a timeout of 0 means that no timeout takes place; // with fsockopen a timeout of 0 means that you instantly timeout // to resolve this incompatibility a timeout of 100,000 will be used for fsockopen if timeout is 0 $this->fsock = @fsockopen($this->host, $this->port, $errno, $errstr, $this->curTimeout == 0 ? 100000 : $this->curTimeout); if (!$this->fsock) { $host = $this->host . ':' . $this->port; throw new UnableToConnectException(rtrim("Cannot connect to $host. Error $errno. $errstr")); } $elapsed = microtime(true) - $start; if ($this->curTimeout) { $this->curTimeout -= $elapsed; if ($this->curTimeout < 0) { throw new \RuntimeException('Connection timed out whilst attempting to open socket connection'); } } } $this->identifier = $this->generate_identifier(); if ($this->send_id_string_first) { fputs($this->fsock, $this->identifier . "\r\n"); } /* According to the SSH2 specs, "The server MAY send other lines of data before sending the version string. Each line SHOULD be terminated by a Carriage Return and Line Feed. Such lines MUST NOT begin with "SSH-", and SHOULD be encoded in ISO-10646 UTF-8 [RFC3629] (language is not specified). Clients MUST be able to process such lines." */ $data = ''; while (!feof($this->fsock) && !preg_match('#(.*)^(SSH-(\d\.\d+).*)#ms', $data, $matches)) { $line = ''; while (true) { if ($this->curTimeout) { if ($this->curTimeout < 0) { throw new \RuntimeException('Connection timed out whilst receiving server identification string'); } $read = [$this->fsock]; $write = $except = null; $start = microtime(true); $sec = (int) floor($this->curTimeout); $usec = (int) (1000000 * ($this->curTimeout - $sec)); if (@stream_select($read, $write, $except, $sec, $usec) === false) { throw new \RuntimeException('Connection timed out whilst receiving server identification string'); } $elapsed = microtime(true) - $start; $this->curTimeout -= $elapsed; } $temp = stream_get_line($this->fsock, 255, "\n"); if ($temp === false) { throw new \RuntimeException('Error reading from socket'); } if (strlen($temp) == 255) { continue; } $line .= "$temp\n"; // quoting RFC4253, "Implementers who wish to maintain // compatibility with older, undocumented versions of this protocol may // want to process the identification string without expecting the // presence of the carriage return character for reasons described in // Section 5 of this document." //if (substr($line, -2) == "\r\n") { // break; //} break; } $data .= $line; } if (feof($this->fsock)) { $this->bitmap = 0; throw new ConnectionClosedException('Connection closed by server'); } $extra = $matches[1]; if (defined('NET_SSH2_LOGGING')) { $this->append_log('<-', $matches[0]); $this->append_log('->', $this->identifier . "\r\n"); } $this->server_identifier = trim($temp, "\r\n"); if (strlen($extra)) { $this->errors[] = $data; } if (version_compare($matches[3], '1.99', '<')) { $this->bitmap = 0; throw new UnableToConnectException("Cannot connect to SSH $matches[3] servers"); } if (!$this->send_id_string_first) { fputs($this->fsock, $this->identifier . "\r\n"); } if (!$this->send_kex_first) { $response = $this->get_binary_packet(); if (is_bool($response) || !strlen($response) || ord($response[0]) != NET_SSH2_MSG_KEXINIT) { $this->bitmap = 0; throw new \UnexpectedValueException('Expected SSH_MSG_KEXINIT'); } $this->key_exchange($response); } if ($this->send_kex_first) { $this->key_exchange(); } $this->bitmap |= self::MASK_CONNECTED; return true; } /** * Generates the SSH identifier * * You should overwrite this method in your own class if you want to use another identifier * * @return string */ private function generate_identifier() { $identifier = 'SSH-2.0-phpseclib_3.0'; $ext = []; if (extension_loaded('sodium')) { $ext[] = 'libsodium'; } if (extension_loaded('openssl')) { $ext[] = 'openssl'; } elseif (extension_loaded('mcrypt')) { $ext[] = 'mcrypt'; } if (extension_loaded('gmp')) { $ext[] = 'gmp'; } elseif (extension_loaded('bcmath')) { $ext[] = 'bcmath'; } if (!empty($ext)) { $identifier .= ' (' . implode(', ', $ext) . ')'; } return $identifier; } /** * Key Exchange * * @return bool * @param string|bool $kexinit_payload_server optional * @throws \UnexpectedValueException on receipt of unexpected packets * @throws \RuntimeException on other errors * @throws \phpseclib3\Exception\NoSupportedAlgorithmsException when none of the algorithms phpseclib has loaded are compatible */ private function key_exchange($kexinit_payload_server = false) { $preferred = $this->preferred; $send_kex = true; $kex_algorithms = isset($preferred['kex']) ? $preferred['kex'] : SSH2::getSupportedKEXAlgorithms(); $server_host_key_algorithms = isset($preferred['hostkey']) ? $preferred['hostkey'] : SSH2::getSupportedHostKeyAlgorithms(); $s2c_encryption_algorithms = isset($preferred['server_to_client']['crypt']) ? $preferred['server_to_client']['crypt'] : SSH2::getSupportedEncryptionAlgorithms(); $c2s_encryption_algorithms = isset($preferred['client_to_server']['crypt']) ? $preferred['client_to_server']['crypt'] : SSH2::getSupportedEncryptionAlgorithms(); $s2c_mac_algorithms = isset($preferred['server_to_client']['mac']) ? $preferred['server_to_client']['mac'] : SSH2::getSupportedMACAlgorithms(); $c2s_mac_algorithms = isset($preferred['client_to_server']['mac']) ? $preferred['client_to_server']['mac'] : SSH2::getSupportedMACAlgorithms(); $s2c_compression_algorithms = isset($preferred['server_to_client']['comp']) ? $preferred['server_to_client']['comp'] : SSH2::getSupportedCompressionAlgorithms(); $c2s_compression_algorithms = isset($preferred['client_to_server']['comp']) ? $preferred['client_to_server']['comp'] : SSH2::getSupportedCompressionAlgorithms(); // some SSH servers have buggy implementations of some of the above algorithms switch (true) { case $this->server_identifier == 'SSH-2.0-SSHD': case substr($this->server_identifier, 0, 13) == 'SSH-2.0-DLINK': if (!isset($preferred['server_to_client']['mac'])) { $s2c_mac_algorithms = array_values(array_diff( $s2c_mac_algorithms, ['hmac-sha1-96', 'hmac-md5-96'] )); } if (!isset($preferred['client_to_server']['mac'])) { $c2s_mac_algorithms = array_values(array_diff( $c2s_mac_algorithms, ['hmac-sha1-96', 'hmac-md5-96'] )); } } $client_cookie = Random::string(16); $kexinit_payload_client = pack('Ca*', NET_SSH2_MSG_KEXINIT, $client_cookie); $kexinit_payload_client .= Strings::packSSH2( 'L10bN', $kex_algorithms, $server_host_key_algorithms, $c2s_encryption_algorithms, $s2c_encryption_algorithms, $c2s_mac_algorithms, $s2c_mac_algorithms, $c2s_compression_algorithms, $s2c_compression_algorithms, [], // language, client to server [], // language, server to client false, // first_kex_packet_follows 0 // reserved for future extension ); if ($kexinit_payload_server === false) { $this->send_binary_packet($kexinit_payload_client); $kexinit_payload_server = $this->get_binary_packet(); if ( is_bool($kexinit_payload_server) || !strlen($kexinit_payload_server) || ord($kexinit_payload_server[0]) != NET_SSH2_MSG_KEXINIT ) { $this->disconnect_helper(NET_SSH2_DISCONNECT_PROTOCOL_ERROR); throw new \UnexpectedValueException('Expected SSH_MSG_KEXINIT'); } $send_kex = false; } $response = $kexinit_payload_server; Strings::shift($response, 1); // skip past the message number (it should be SSH_MSG_KEXINIT) $server_cookie = Strings::shift($response, 16); list( $this->kex_algorithms, $this->server_host_key_algorithms, $this->encryption_algorithms_client_to_server, $this->encryption_algorithms_server_to_client, $this->mac_algorithms_client_to_server, $this->mac_algorithms_server_to_client, $this->compression_algorithms_client_to_server, $this->compression_algorithms_server_to_client, $this->languages_client_to_server, $this->languages_server_to_client, $first_kex_packet_follows ) = Strings::unpackSSH2('L10C', $response); $this->supported_private_key_algorithms = $this->server_host_key_algorithms; if ($send_kex) { $this->send_binary_packet($kexinit_payload_client); } // we need to decide upon the symmetric encryption algorithms before we do the diffie-hellman key exchange // we don't initialize any crypto-objects, yet - we do that, later. for now, we need the lengths to make the // diffie-hellman key exchange as fast as possible $decrypt = self::array_intersect_first($s2c_encryption_algorithms, $this->encryption_algorithms_server_to_client); $decryptKeyLength = $this->encryption_algorithm_to_key_size($decrypt); if ($decryptKeyLength === null) { $this->disconnect_helper(NET_SSH2_DISCONNECT_KEY_EXCHANGE_FAILED); throw new NoSupportedAlgorithmsException('No compatible server to client encryption algorithms found'); } $encrypt = self::array_intersect_first($c2s_encryption_algorithms, $this->encryption_algorithms_client_to_server); $encryptKeyLength = $this->encryption_algorithm_to_key_size($encrypt); if ($encryptKeyLength === null) { $this->disconnect_helper(NET_SSH2_DISCONNECT_KEY_EXCHANGE_FAILED); throw new NoSupportedAlgorithmsException('No compatible client to server encryption algorithms found'); } // through diffie-hellman key exchange a symmetric key is obtained $this->kex_algorithm = self::array_intersect_first($kex_algorithms, $this->kex_algorithms); if ($this->kex_algorithm === false) { $this->disconnect_helper(NET_SSH2_DISCONNECT_KEY_EXCHANGE_FAILED); throw new NoSupportedAlgorithmsException('No compatible key exchange algorithms found'); } $server_host_key_algorithm = self::array_intersect_first($server_host_key_algorithms, $this->server_host_key_algorithms); if ($server_host_key_algorithm === false) { $this->disconnect_helper(NET_SSH2_DISCONNECT_KEY_EXCHANGE_FAILED); throw new NoSupportedAlgorithmsException('No compatible server host key algorithms found'); } $mac_algorithm_out = self::array_intersect_first($c2s_mac_algorithms, $this->mac_algorithms_client_to_server); if ($mac_algorithm_out === false) { $this->disconnect_helper(NET_SSH2_DISCONNECT_KEY_EXCHANGE_FAILED); throw new NoSupportedAlgorithmsException('No compatible client to server message authentication algorithms found'); } $mac_algorithm_in = self::array_intersect_first($s2c_mac_algorithms, $this->mac_algorithms_server_to_client); if ($mac_algorithm_in === false) { $this->disconnect_helper(NET_SSH2_DISCONNECT_KEY_EXCHANGE_FAILED); throw new NoSupportedAlgorithmsException('No compatible server to client message authentication algorithms found'); } $compression_map = [ 'none' => self::NET_SSH2_COMPRESSION_NONE, 'zlib' => self::NET_SSH2_COMPRESSION_ZLIB, 'zlib@openssh.com' => self::NET_SSH2_COMPRESSION_ZLIB_AT_OPENSSH ]; $compression_algorithm_in = self::array_intersect_first($s2c_compression_algorithms, $this->compression_algorithms_server_to_client); if ($compression_algorithm_in === false) { $this->disconnect_helper(NET_SSH2_DISCONNECT_KEY_EXCHANGE_FAILED); throw new NoSupportedAlgorithmsException('No compatible server to client compression algorithms found'); } $this->decompress = $compression_map[$compression_algorithm_in]; $compression_algorithm_out = self::array_intersect_first($c2s_compression_algorithms, $this->compression_algorithms_client_to_server); if ($compression_algorithm_out === false) { $this->disconnect_helper(NET_SSH2_DISCONNECT_KEY_EXCHANGE_FAILED); throw new NoSupportedAlgorithmsException('No compatible client to server compression algorithms found'); } $this->compress = $compression_map[$compression_algorithm_out]; switch ($this->kex_algorithm) { case 'diffie-hellman-group15-sha512': case 'diffie-hellman-group16-sha512': case 'diffie-hellman-group17-sha512': case 'diffie-hellman-group18-sha512': case 'ecdh-sha2-nistp521': $kexHash = new Hash('sha512'); break; case 'ecdh-sha2-nistp384': $kexHash = new Hash('sha384'); break; case 'diffie-hellman-group-exchange-sha256': case 'diffie-hellman-group14-sha256': case 'ecdh-sha2-nistp256': case 'curve25519-sha256@libssh.org': case 'curve25519-sha256': $kexHash = new Hash('sha256'); break; default: $kexHash = new Hash('sha1'); } // Only relevant in diffie-hellman-group-exchange-sha{1,256}, otherwise empty. $exchange_hash_rfc4419 = ''; if (strpos($this->kex_algorithm, 'curve25519-sha256') === 0 || strpos($this->kex_algorithm, 'ecdh-sha2-nistp') === 0) { $curve = strpos($this->kex_algorithm, 'curve25519-sha256') === 0 ? 'Curve25519' : substr($this->kex_algorithm, 10); $ourPrivate = EC::createKey($curve); $ourPublicBytes = $ourPrivate->getPublicKey()->getEncodedCoordinates(); $clientKexInitMessage = 'NET_SSH2_MSG_KEX_ECDH_INIT'; $serverKexReplyMessage = 'NET_SSH2_MSG_KEX_ECDH_REPLY'; } else { if (strpos($this->kex_algorithm, 'diffie-hellman-group-exchange') === 0) { $dh_group_sizes_packed = pack( 'NNN', $this->kex_dh_group_size_min, $this->kex_dh_group_size_preferred, $this->kex_dh_group_size_max ); $packet = pack( 'Ca*', NET_SSH2_MSG_KEXDH_GEX_REQUEST, $dh_group_sizes_packed ); $this->send_binary_packet($packet); $this->updateLogHistory('UNKNOWN (34)', 'NET_SSH2_MSG_KEXDH_GEX_REQUEST'); $response = $this->get_binary_packet(); list($type, $primeBytes, $gBytes) = Strings::unpackSSH2('Css', $response); if ($type != NET_SSH2_MSG_KEXDH_GEX_GROUP) { $this->disconnect_helper(NET_SSH2_DISCONNECT_PROTOCOL_ERROR); throw new \UnexpectedValueException('Expected SSH_MSG_KEX_DH_GEX_GROUP'); } $this->updateLogHistory('NET_SSH2_MSG_KEXDH_REPLY', 'NET_SSH2_MSG_KEXDH_GEX_GROUP'); $prime = new BigInteger($primeBytes, -256); $g = new BigInteger($gBytes, -256); $exchange_hash_rfc4419 = $dh_group_sizes_packed . Strings::packSSH2( 'ss', $primeBytes, $gBytes ); $params = DH::createParameters($prime, $g); $clientKexInitMessage = 'NET_SSH2_MSG_KEXDH_GEX_INIT'; $serverKexReplyMessage = 'NET_SSH2_MSG_KEXDH_GEX_REPLY'; } else { $params = DH::createParameters($this->kex_algorithm); $clientKexInitMessage = 'NET_SSH2_MSG_KEXDH_INIT'; $serverKexReplyMessage = 'NET_SSH2_MSG_KEXDH_REPLY'; } $keyLength = min($kexHash->getLengthInBytes(), max($encryptKeyLength, $decryptKeyLength)); $ourPrivate = DH::createKey($params, 16 * $keyLength); // 2 * 8 * $keyLength $ourPublic = $ourPrivate->getPublicKey()->toBigInteger(); $ourPublicBytes = $ourPublic->toBytes(true); } $data = pack('CNa*', constant($clientKexInitMessage), strlen($ourPublicBytes), $ourPublicBytes); $this->send_binary_packet($data); switch ($clientKexInitMessage) { case 'NET_SSH2_MSG_KEX_ECDH_INIT': $this->updateLogHistory('NET_SSH2_MSG_KEXDH_INIT', 'NET_SSH2_MSG_KEX_ECDH_INIT'); break; case 'NET_SSH2_MSG_KEXDH_GEX_INIT': $this->updateLogHistory('UNKNOWN (32)', 'NET_SSH2_MSG_KEXDH_GEX_INIT'); } $response = $this->get_binary_packet(); list( $type, $server_public_host_key, $theirPublicBytes, $this->signature ) = Strings::unpackSSH2('Csss', $response); if ($type != constant($serverKexReplyMessage)) { $this->disconnect_helper(NET_SSH2_DISCONNECT_PROTOCOL_ERROR); throw new \UnexpectedValueException("Expected $serverKexReplyMessage"); } switch ($serverKexReplyMessage) { case 'NET_SSH2_MSG_KEX_ECDH_REPLY': $this->updateLogHistory('NET_SSH2_MSG_KEXDH_REPLY', 'NET_SSH2_MSG_KEX_ECDH_REPLY'); break; case 'NET_SSH2_MSG_KEXDH_GEX_REPLY': $this->updateLogHistory('UNKNOWN (33)', 'NET_SSH2_MSG_KEXDH_GEX_REPLY'); } $this->server_public_host_key = $server_public_host_key; list($public_key_format) = Strings::unpackSSH2('s', $server_public_host_key); if (strlen($this->signature) < 4) { throw new \LengthException('The signature needs at least four bytes'); } $temp = unpack('Nlength', substr($this->signature, 0, 4)); $this->signature_format = substr($this->signature, 4, $temp['length']); $keyBytes = DH::computeSecret($ourPrivate, $theirPublicBytes); if (($keyBytes & "\xFF\x80") === "\x00\x00") { $keyBytes = substr($keyBytes, 1); } elseif (($keyBytes[0] & "\x80") === "\x80") { $keyBytes = "\0$keyBytes"; } $this->exchange_hash = Strings::packSSH2( 's5', $this->identifier, $this->server_identifier, $kexinit_payload_client, $kexinit_payload_server, $this->server_public_host_key ); $this->exchange_hash .= $exchange_hash_rfc4419; $this->exchange_hash .= Strings::packSSH2( 's3', $ourPublicBytes, $theirPublicBytes, $keyBytes ); $this->exchange_hash = $kexHash->hash($this->exchange_hash); if ($this->session_id === false) { $this->session_id = $this->exchange_hash; } switch ($server_host_key_algorithm) { case 'rsa-sha2-256': case 'rsa-sha2-512': //case 'ssh-rsa': $expected_key_format = 'ssh-rsa'; break; default: $expected_key_format = $server_host_key_algorithm; } if ($public_key_format != $expected_key_format || $this->signature_format != $server_host_key_algorithm) { switch (true) { case $this->signature_format == $server_host_key_algorithm: case $server_host_key_algorithm != 'rsa-sha2-256' && $server_host_key_algorithm != 'rsa-sha2-512': case $this->signature_format != 'ssh-rsa': $this->disconnect_helper(NET_SSH2_DISCONNECT_HOST_KEY_NOT_VERIFIABLE); throw new \RuntimeException('Server Host Key Algorithm Mismatch (' . $this->signature_format . ' vs ' . $server_host_key_algorithm . ')'); } } $packet = pack('C', NET_SSH2_MSG_NEWKEYS); $this->send_binary_packet($packet); $response = $this->get_binary_packet(); if ($response === false) { $this->disconnect_helper(NET_SSH2_DISCONNECT_CONNECTION_LOST); throw new ConnectionClosedException('Connection closed by server'); } list($type) = Strings::unpackSSH2('C', $response); if ($type != NET_SSH2_MSG_NEWKEYS) { $this->disconnect_helper(NET_SSH2_DISCONNECT_PROTOCOL_ERROR); throw new \UnexpectedValueException('Expected SSH_MSG_NEWKEYS'); } $keyBytes = pack('Na*', strlen($keyBytes), $keyBytes); $this->encrypt = self::encryption_algorithm_to_crypt_instance($encrypt); if ($this->encrypt) { if (self::$crypto_engine) { $this->encrypt->setPreferredEngine(self::$crypto_engine); } if ($this->encrypt->getBlockLengthInBytes()) { $this->encrypt_block_size = $this->encrypt->getBlockLengthInBytes(); } $this->encrypt->disablePadding(); if ($this->encrypt->usesIV()) { $iv = $kexHash->hash($keyBytes . $this->exchange_hash . 'A' . $this->session_id); while ($this->encrypt_block_size > strlen($iv)) { $iv .= $kexHash->hash($keyBytes . $this->exchange_hash . $iv); } $this->encrypt->setIV(substr($iv, 0, $this->encrypt_block_size)); } switch ($encrypt) { case 'aes128-gcm@openssh.com': case 'aes256-gcm@openssh.com': $nonce = $kexHash->hash($keyBytes . $this->exchange_hash . 'A' . $this->session_id); $this->encryptFixedPart = substr($nonce, 0, 4); $this->encryptInvocationCounter = substr($nonce, 4, 8); // fall-through case 'chacha20-poly1305@openssh.com': break; default: $this->encrypt->enableContinuousBuffer(); } $key = $kexHash->hash($keyBytes . $this->exchange_hash . 'C' . $this->session_id); while ($encryptKeyLength > strlen($key)) { $key .= $kexHash->hash($keyBytes . $this->exchange_hash . $key); } switch ($encrypt) { case 'chacha20-poly1305@openssh.com': $encryptKeyLength = 32; $this->lengthEncrypt = self::encryption_algorithm_to_crypt_instance($encrypt); $this->lengthEncrypt->setKey(substr($key, 32, 32)); } $this->encrypt->setKey(substr($key, 0, $encryptKeyLength)); $this->encryptName = $encrypt; } $this->decrypt = self::encryption_algorithm_to_crypt_instance($decrypt); if ($this->decrypt) { if (self::$crypto_engine) { $this->decrypt->setPreferredEngine(self::$crypto_engine); } if ($this->decrypt->getBlockLengthInBytes()) { $this->decrypt_block_size = $this->decrypt->getBlockLengthInBytes(); } $this->decrypt->disablePadding(); if ($this->decrypt->usesIV()) { $iv = $kexHash->hash($keyBytes . $this->exchange_hash . 'B' . $this->session_id); while ($this->decrypt_block_size > strlen($iv)) { $iv .= $kexHash->hash($keyBytes . $this->exchange_hash . $iv); } $this->decrypt->setIV(substr($iv, 0, $this->decrypt_block_size)); } switch ($decrypt) { case 'aes128-gcm@openssh.com': case 'aes256-gcm@openssh.com': // see https://tools.ietf.org/html/rfc5647#section-7.1 $nonce = $kexHash->hash($keyBytes . $this->exchange_hash . 'B' . $this->session_id); $this->decryptFixedPart = substr($nonce, 0, 4); $this->decryptInvocationCounter = substr($nonce, 4, 8); // fall-through case 'chacha20-poly1305@openssh.com': break; default: $this->decrypt->enableContinuousBuffer(); } $key = $kexHash->hash($keyBytes . $this->exchange_hash . 'D' . $this->session_id); while ($decryptKeyLength > strlen($key)) { $key .= $kexHash->hash($keyBytes . $this->exchange_hash . $key); } switch ($decrypt) { case 'chacha20-poly1305@openssh.com': $decryptKeyLength = 32; $this->lengthDecrypt = self::encryption_algorithm_to_crypt_instance($decrypt); $this->lengthDecrypt->setKey(substr($key, 32, 32)); } $this->decrypt->setKey(substr($key, 0, $decryptKeyLength)); $this->decryptName = $decrypt; } /* The "arcfour128" algorithm is the RC4 cipher, as described in [SCHNEIER], using a 128-bit key. The first 1536 bytes of keystream generated by the cipher MUST be discarded, and the first byte of the first encrypted packet MUST be encrypted using the 1537th byte of keystream. -- http://tools.ietf.org/html/rfc4345#section-4 */ if ($encrypt == 'arcfour128' || $encrypt == 'arcfour256') { $this->encrypt->encrypt(str_repeat("\0", 1536)); } if ($decrypt == 'arcfour128' || $decrypt == 'arcfour256') { $this->decrypt->decrypt(str_repeat("\0", 1536)); } if (!$this->encrypt->usesNonce()) { list($this->hmac_create, $createKeyLength) = self::mac_algorithm_to_hash_instance($mac_algorithm_out); } else { $this->hmac_create = new \stdClass(); $this->hmac_create_name = $mac_algorithm_out; //$mac_algorithm_out = 'none'; $createKeyLength = 0; } if ($this->hmac_create instanceof Hash) { $key = $kexHash->hash($keyBytes . $this->exchange_hash . 'E' . $this->session_id); while ($createKeyLength > strlen($key)) { $key .= $kexHash->hash($keyBytes . $this->exchange_hash . $key); } $this->hmac_create->setKey(substr($key, 0, $createKeyLength)); $this->hmac_create_name = $mac_algorithm_out; $this->hmac_create_etm = preg_match('#-etm@openssh\.com$#', $mac_algorithm_out); } if (!$this->decrypt->usesNonce()) { list($this->hmac_check, $checkKeyLength) = self::mac_algorithm_to_hash_instance($mac_algorithm_in); $this->hmac_size = $this->hmac_check->getLengthInBytes(); } else { $this->hmac_check = new \stdClass(); $this->hmac_check_name = $mac_algorithm_in; //$mac_algorithm_in = 'none'; $checkKeyLength = 0; $this->hmac_size = 0; } if ($this->hmac_check instanceof Hash) { $key = $kexHash->hash($keyBytes . $this->exchange_hash . 'F' . $this->session_id); while ($checkKeyLength > strlen($key)) { $key .= $kexHash->hash($keyBytes . $this->exchange_hash . $key); } $this->hmac_check->setKey(substr($key, 0, $checkKeyLength)); $this->hmac_check_name = $mac_algorithm_in; $this->hmac_check_etm = preg_match('#-etm@openssh\.com$#', $mac_algorithm_in); } $this->regenerate_compression_context = $this->regenerate_decompression_context = true; return true; } /** * Maps an encryption algorithm name to the number of key bytes. * * @param string $algorithm Name of the encryption algorithm * @return int|null Number of bytes as an integer or null for unknown */ private function encryption_algorithm_to_key_size($algorithm) { if ($this->bad_key_size_fix && self::bad_algorithm_candidate($algorithm)) { return 16; } switch ($algorithm) { case 'none': return 0; case 'aes128-gcm@openssh.com': case 'aes128-cbc': case 'aes128-ctr': case 'arcfour': case 'arcfour128': case 'blowfish-cbc': case 'blowfish-ctr': case 'twofish128-cbc': case 'twofish128-ctr': return 16; case '3des-cbc': case '3des-ctr': case 'aes192-cbc': case 'aes192-ctr': case 'twofish192-cbc': case 'twofish192-ctr': return 24; case 'aes256-gcm@openssh.com': case 'aes256-cbc': case 'aes256-ctr': case 'arcfour256': case 'twofish-cbc': case 'twofish256-cbc': case 'twofish256-ctr': return 32; case 'chacha20-poly1305@openssh.com': return 64; } return null; } /** * Maps an encryption algorithm name to an instance of a subclass of * \phpseclib3\Crypt\Common\SymmetricKey. * * @param string $algorithm Name of the encryption algorithm * @return SymmetricKey|null */ private static function encryption_algorithm_to_crypt_instance($algorithm) { switch ($algorithm) { case '3des-cbc': return new TripleDES('cbc'); case '3des-ctr': return new TripleDES('ctr'); case 'aes256-cbc': case 'aes192-cbc': case 'aes128-cbc': return new Rijndael('cbc'); case 'aes256-ctr': case 'aes192-ctr': case 'aes128-ctr': return new Rijndael('ctr'); case 'blowfish-cbc': return new Blowfish('cbc'); case 'blowfish-ctr': return new Blowfish('ctr'); case 'twofish128-cbc': case 'twofish192-cbc': case 'twofish256-cbc': case 'twofish-cbc': return new Twofish('cbc'); case 'twofish128-ctr': case 'twofish192-ctr': case 'twofish256-ctr': return new Twofish('ctr'); case 'arcfour': case 'arcfour128': case 'arcfour256': return new RC4(); case 'aes128-gcm@openssh.com': case 'aes256-gcm@openssh.com': return new Rijndael('gcm'); case 'chacha20-poly1305@openssh.com': return new ChaCha20(); } return null; } /** * Maps an encryption algorithm name to an instance of a subclass of * \phpseclib3\Crypt\Hash. * * @param string $algorithm Name of the encryption algorithm * @return array{Hash, int}|null */ private static function mac_algorithm_to_hash_instance($algorithm) { switch ($algorithm) { case 'umac-64@openssh.com': case 'umac-64-etm@openssh.com': return [new Hash('umac-64'), 16]; case 'umac-128@openssh.com': case 'umac-128-etm@openssh.com': return [new Hash('umac-128'), 16]; case 'hmac-sha2-512': case 'hmac-sha2-512-etm@openssh.com': return [new Hash('sha512'), 64]; case 'hmac-sha2-256': case 'hmac-sha2-256-etm@openssh.com': return [new Hash('sha256'), 32]; case 'hmac-sha1': case 'hmac-sha1-etm@openssh.com': return [new Hash('sha1'), 20]; case 'hmac-sha1-96': return [new Hash('sha1-96'), 20]; case 'hmac-md5': return [new Hash('md5'), 16]; case 'hmac-md5-96': return [new Hash('md5-96'), 16]; } } /* * Tests whether or not proposed algorithm has a potential for issues * * @link https://www.chiark.greenend.org.uk/~sgtatham/putty/wishlist/ssh2-aesctr-openssh.html * @link https://bugzilla.mindrot.org/show_bug.cgi?id=1291 * @param string $algorithm Name of the encryption algorithm * @return bool */ private static function bad_algorithm_candidate($algorithm) { switch ($algorithm) { case 'arcfour256': case 'aes192-ctr': case 'aes256-ctr': return true; } return false; } /** * Login * * The $password parameter can be a plaintext password, a \phpseclib3\Crypt\RSA|EC|DSA object, a \phpseclib3\System\SSH\Agent object or an array * * @param string $username * @param string|AsymmetricKey|array[]|Agent|null ...$args * @return bool * @see self::_login() */ public function login($username, ...$args) { $this->auth[] = func_get_args(); // try logging with 'none' as an authentication method first since that's what // PuTTY does if (substr($this->server_identifier, 0, 15) != 'SSH-2.0-CoreFTP' && $this->auth_methods_to_continue === null) { if ($this->sublogin($username)) { return true; } if (!count($args)) { return false; } } return $this->sublogin($username, ...$args); } /** * Login Helper * * @param string $username * @param string ...$args * @return bool * @see self::_login_helper() */ protected function sublogin($username, ...$args) { if (!($this->bitmap & self::MASK_CONSTRUCTOR)) { $this->connect(); } if (empty($args)) { return $this->login_helper($username); } foreach ($args as $arg) { switch (true) { case $arg instanceof PublicKey: throw new \UnexpectedValueException('A PublicKey object was passed to the login method instead of a PrivateKey object'); case $arg instanceof PrivateKey: case $arg instanceof Agent: case is_array($arg): case Strings::is_stringable($arg): break; default: throw new \UnexpectedValueException('$password needs to either be an instance of \phpseclib3\Crypt\Common\PrivateKey, \System\SSH\Agent, an array or a string'); } } while (count($args)) { if (!$this->auth_methods_to_continue || !$this->smartMFA) { $newargs = $args; $args = []; } else { $newargs = []; foreach ($this->auth_methods_to_continue as $method) { switch ($method) { case 'publickey': foreach ($args as $key => $arg) { if ($arg instanceof PrivateKey || $arg instanceof Agent) { $newargs[] = $arg; unset($args[$key]); break; } } break; case 'keyboard-interactive': $hasArray = $hasString = false; foreach ($args as $arg) { if ($hasArray || is_array($arg)) { $hasArray = true; break; } if ($hasString || Strings::is_stringable($arg)) { $hasString = true; break; } } if ($hasArray && $hasString) { foreach ($args as $key => $arg) { if (is_array($arg)) { $newargs[] = $arg; break 2; } } } // fall-through case 'password': foreach ($args as $key => $arg) { $newargs[] = $arg; unset($args[$key]); break; } } } } if (!count($newargs)) { return false; } foreach ($newargs as $arg) { if ($this->login_helper($username, $arg)) { return true; } } } return false; } /** * Login Helper * * {@internal It might be worthwhile, at some point, to protect against {@link http://tools.ietf.org/html/rfc4251#section-9.3.9 traffic analysis} * by sending dummy SSH_MSG_IGNORE messages.} * * @param string $username * @param string|AsymmetricKey|array[]|Agent|null ...$args * @return bool * @throws \UnexpectedValueException on receipt of unexpected packets * @throws \RuntimeException on other errors */ private function login_helper($username, $password = null) { if (!($this->bitmap & self::MASK_CONNECTED)) { return false; } if (!($this->bitmap & self::MASK_LOGIN_REQ)) { $packet = Strings::packSSH2('Cs', NET_SSH2_MSG_SERVICE_REQUEST, 'ssh-userauth'); $this->send_binary_packet($packet); try { $response = $this->get_binary_packet(); } catch (\Exception $e) { if ($this->retry_connect) { $this->retry_connect = false; $this->connect(); return $this->login_helper($username, $password); } $this->disconnect_helper(NET_SSH2_DISCONNECT_CONNECTION_LOST); throw new ConnectionClosedException('Connection closed by server'); } list($type, $service) = Strings::unpackSSH2('Cs', $response); if ($type != NET_SSH2_MSG_SERVICE_ACCEPT || $service != 'ssh-userauth') { $this->disconnect_helper(NET_SSH2_DISCONNECT_PROTOCOL_ERROR); throw new \UnexpectedValueException('Expected SSH_MSG_SERVICE_ACCEPT'); } $this->bitmap |= self::MASK_LOGIN_REQ; } if (strlen($this->last_interactive_response)) { return !Strings::is_stringable($password) && !is_array($password) ? false : $this->keyboard_interactive_process($password); } if ($password instanceof PrivateKey) { return $this->privatekey_login($username, $password); } if ($password instanceof Agent) { return $this->ssh_agent_login($username, $password); } if (is_array($password)) { if ($this->keyboard_interactive_login($username, $password)) { $this->bitmap |= self::MASK_LOGIN; return true; } return false; } if (!isset($password)) { $packet = Strings::packSSH2( 'Cs3', NET_SSH2_MSG_USERAUTH_REQUEST, $username, 'ssh-connection', 'none' ); $this->send_binary_packet($packet); $response = $this->get_binary_packet(); list($type) = Strings::unpackSSH2('C', $response); switch ($type) { case NET_SSH2_MSG_USERAUTH_SUCCESS: $this->bitmap |= self::MASK_LOGIN; return true; case NET_SSH2_MSG_USERAUTH_FAILURE: list($auth_methods) = Strings::unpackSSH2('L', $response); $this->auth_methods_to_continue = $auth_methods; // fall-through default: return false; } } $packet = Strings::packSSH2( 'Cs3bs', NET_SSH2_MSG_USERAUTH_REQUEST, $username, 'ssh-connection', 'password', false, $password ); // remove the username and password from the logged packet if (!defined('NET_SSH2_LOGGING')) { $logged = null; } else { $logged = Strings::packSSH2( 'Cs3bs', NET_SSH2_MSG_USERAUTH_REQUEST, $username, 'ssh-connection', 'password', false, 'password' ); } $this->send_binary_packet($packet, $logged); $response = $this->get_binary_packet(); if ($response === false) { return false; } list($type) = Strings::unpackSSH2('C', $response); switch ($type) { case NET_SSH2_MSG_USERAUTH_PASSWD_CHANGEREQ: // in theory, the password can be changed $this->updateLogHistory('UNKNOWN (60)', 'NET_SSH2_MSG_USERAUTH_PASSWD_CHANGEREQ'); list($message) = Strings::unpackSSH2('s', $response); $this->errors[] = 'SSH_MSG_USERAUTH_PASSWD_CHANGEREQ: ' . $message; return $this->disconnect_helper(NET_SSH2_DISCONNECT_AUTH_CANCELLED_BY_USER); case NET_SSH2_MSG_USERAUTH_FAILURE: // can we use keyboard-interactive authentication? if not then either the login is bad or the server employees // multi-factor authentication list($auth_methods, $partial_success) = Strings::unpackSSH2('Lb', $response); $this->auth_methods_to_continue = $auth_methods; if (!$partial_success && in_array('keyboard-interactive', $auth_methods)) { if ($this->keyboard_interactive_login($username, $password)) { $this->bitmap |= self::MASK_LOGIN; return true; } return false; } return false; case NET_SSH2_MSG_USERAUTH_SUCCESS: $this->bitmap |= self::MASK_LOGIN; return true; } return false; } /** * Login via keyboard-interactive authentication * * See {@link http://tools.ietf.org/html/rfc4256 RFC4256} for details. This is not a full-featured keyboard-interactive authenticator. * * @param string $username * @param string|array $password * @return bool */ private function keyboard_interactive_login($username, $password) { $packet = Strings::packSSH2( 'Cs5', NET_SSH2_MSG_USERAUTH_REQUEST, $username, 'ssh-connection', 'keyboard-interactive', '', // language tag '' // submethods ); $this->send_binary_packet($packet); return $this->keyboard_interactive_process($password); } /** * Handle the keyboard-interactive requests / responses. * * @param string|array ...$responses * @return bool * @throws \RuntimeException on connection error */ private function keyboard_interactive_process(...$responses) { if (strlen($this->last_interactive_response)) { $response = $this->last_interactive_response; } else { $orig = $response = $this->get_binary_packet(); } list($type) = Strings::unpackSSH2('C', $response); switch ($type) { case NET_SSH2_MSG_USERAUTH_INFO_REQUEST: list( , // name; may be empty , // instruction; may be empty , // language tag; may be empty $num_prompts ) = Strings::unpackSSH2('s3N', $response); for ($i = 0; $i < count($responses); $i++) { if (is_array($responses[$i])) { foreach ($responses[$i] as $key => $value) { $this->keyboard_requests_responses[$key] = $value; } unset($responses[$i]); } } $responses = array_values($responses); if (isset($this->keyboard_requests_responses)) { for ($i = 0; $i < $num_prompts; $i++) { list( $prompt, // prompt - ie. "Password: "; must not be empty // echo ) = Strings::unpackSSH2('sC', $response); foreach ($this->keyboard_requests_responses as $key => $value) { if (substr($prompt, 0, strlen($key)) == $key) { $responses[] = $value; break; } } } } // see http://tools.ietf.org/html/rfc4256#section-3.2 if (strlen($this->last_interactive_response)) { $this->last_interactive_response = ''; } else { $this->updateLogHistory('UNKNOWN (60)', 'NET_SSH2_MSG_USERAUTH_INFO_REQUEST'); } if (!count($responses) && $num_prompts) { $this->last_interactive_response = $orig; return false; } /* After obtaining the requested information from the user, the client MUST respond with an SSH_MSG_USERAUTH_INFO_RESPONSE message. */ // see http://tools.ietf.org/html/rfc4256#section-3.4 $packet = $logged = pack('CN', NET_SSH2_MSG_USERAUTH_INFO_RESPONSE, count($responses)); for ($i = 0; $i < count($responses); $i++) { $packet .= Strings::packSSH2('s', $responses[$i]); $logged .= Strings::packSSH2('s', 'dummy-answer'); } $this->send_binary_packet($packet, $logged); $this->updateLogHistory('UNKNOWN (61)', 'NET_SSH2_MSG_USERAUTH_INFO_RESPONSE'); /* After receiving the response, the server MUST send either an SSH_MSG_USERAUTH_SUCCESS, SSH_MSG_USERAUTH_FAILURE, or another SSH_MSG_USERAUTH_INFO_REQUEST message. */ // maybe phpseclib should force close the connection after x request / responses? unless something like that is done // there could be an infinite loop of request / responses. return $this->keyboard_interactive_process(); case NET_SSH2_MSG_USERAUTH_SUCCESS: return true; case NET_SSH2_MSG_USERAUTH_FAILURE: list($auth_methods) = Strings::unpackSSH2('L', $response); $this->auth_methods_to_continue = $auth_methods; return false; } return false; } /** * Login with an ssh-agent provided key * * @param string $username * @param \phpseclib3\System\SSH\Agent $agent * @return bool */ private function ssh_agent_login($username, Agent $agent) { $this->agent = $agent; $keys = $agent->requestIdentities(); foreach ($keys as $key) { if ($this->privatekey_login($username, $key)) { return true; } } return false; } /** * Login with an RSA private key * * {@internal It might be worthwhile, at some point, to protect against {@link http://tools.ietf.org/html/rfc4251#section-9.3.9 traffic analysis} * by sending dummy SSH_MSG_IGNORE messages.} * * @param string $username * @param \phpseclib3\Crypt\Common\PrivateKey $privatekey * @return bool * @throws \RuntimeException on connection error */ private function privatekey_login($username, PrivateKey $privatekey) { $publickey = $privatekey->getPublicKey(); if ($publickey instanceof RSA) { $privatekey = $privatekey->withPadding(RSA::SIGNATURE_PKCS1); $algos = ['rsa-sha2-256', 'rsa-sha2-512', 'ssh-rsa']; if (isset($this->preferred['hostkey'])) { $algos = array_intersect($this->preferred['hostkey'], $algos); } $algo = self::array_intersect_first($algos, $this->supported_private_key_algorithms); switch ($algo) { case 'rsa-sha2-512': $hash = 'sha512'; $signatureType = 'rsa-sha2-512'; break; case 'rsa-sha2-256': $hash = 'sha256'; $signatureType = 'rsa-sha2-256'; break; //case 'ssh-rsa': default: $hash = 'sha1'; $signatureType = 'ssh-rsa'; } } elseif ($publickey instanceof EC) { $privatekey = $privatekey->withSignatureFormat('SSH2'); $curveName = $privatekey->getCurve(); switch ($curveName) { case 'Ed25519': $hash = 'sha512'; $signatureType = 'ssh-ed25519'; break; case 'secp256r1': // nistp256 $hash = 'sha256'; $signatureType = 'ecdsa-sha2-nistp256'; break; case 'secp384r1': // nistp384 $hash = 'sha384'; $signatureType = 'ecdsa-sha2-nistp384'; break; case 'secp521r1': // nistp521 $hash = 'sha512'; $signatureType = 'ecdsa-sha2-nistp521'; break; default: if (is_array($curveName)) { throw new UnsupportedCurveException('Specified Curves are not supported by SSH2'); } throw new UnsupportedCurveException('Named Curve of ' . $curveName . ' is not supported by phpseclib3\'s SSH2 implementation'); } } elseif ($publickey instanceof DSA) { $privatekey = $privatekey->withSignatureFormat('SSH2'); $hash = 'sha1'; $signatureType = 'ssh-dss'; } else { throw new UnsupportedAlgorithmException('Please use either an RSA key, an EC one or a DSA key'); } $publickeyStr = $publickey->toString('OpenSSH', ['binary' => true]); $part1 = Strings::packSSH2( 'Csss', NET_SSH2_MSG_USERAUTH_REQUEST, $username, 'ssh-connection', 'publickey' ); $part2 = Strings::packSSH2('ss', $signatureType, $publickeyStr); $packet = $part1 . chr(0) . $part2; $this->send_binary_packet($packet); $response = $this->get_binary_packet(); list($type) = Strings::unpackSSH2('C', $response); switch ($type) { case NET_SSH2_MSG_USERAUTH_FAILURE: list($auth_methods) = Strings::unpackSSH2('L', $response); if (in_array('publickey', $auth_methods) && substr($signatureType, 0, 9) == 'rsa-sha2-') { $this->supported_private_key_algorithms = array_diff($this->supported_private_key_algorithms, ['rsa-sha2-256', 'rsa-sha2-512']); return $this->privatekey_login($username, $privatekey); } $this->auth_methods_to_continue = $auth_methods; $this->errors[] = 'SSH_MSG_USERAUTH_FAILURE'; return false; case NET_SSH2_MSG_USERAUTH_PK_OK: // we'll just take it on faith that the public key blob and the public key algorithm name are as // they should be $this->updateLogHistory('UNKNOWN (60)', 'NET_SSH2_MSG_USERAUTH_PK_OK'); break; case NET_SSH2_MSG_USERAUTH_SUCCESS: $this->bitmap |= self::MASK_LOGIN; return true; default: $this->disconnect_helper(NET_SSH2_DISCONNECT_BY_APPLICATION); throw new ConnectionClosedException('Unexpected response to publickey authentication pt 1'); } $packet = $part1 . chr(1) . $part2; $privatekey = $privatekey->withHash($hash); $signature = $privatekey->sign(Strings::packSSH2('s', $this->session_id) . $packet); if ($publickey instanceof RSA) { $signature = Strings::packSSH2('ss', $signatureType, $signature); } $packet .= Strings::packSSH2('s', $signature); $this->send_binary_packet($packet); $response = $this->get_binary_packet(); list($type) = Strings::unpackSSH2('C', $response); switch ($type) { case NET_SSH2_MSG_USERAUTH_FAILURE: // either the login is bad or the server employs multi-factor authentication list($auth_methods) = Strings::unpackSSH2('L', $response); $this->auth_methods_to_continue = $auth_methods; return false; case NET_SSH2_MSG_USERAUTH_SUCCESS: $this->bitmap |= self::MASK_LOGIN; return true; } $this->disconnect_helper(NET_SSH2_DISCONNECT_BY_APPLICATION); throw new ConnectionClosedException('Unexpected response to publickey authentication pt 2'); } /** * Set Timeout * * $ssh->exec('ping 127.0.0.1'); on a Linux host will never return and will run indefinitely. setTimeout() makes it so it'll timeout. * Setting $timeout to false or 0 will mean there is no timeout. * * @param mixed $timeout */ public function setTimeout($timeout) { $this->timeout = $this->curTimeout = $timeout; } /** * Set Keep Alive * * Sends an SSH2_MSG_IGNORE message every x seconds, if x is a positive non-zero number. * * @param int $interval */ public function setKeepAlive($interval) { $this->keepAlive = $interval; } /** * Get the output from stdError * */ public function getStdError() { return $this->stdErrorLog; } /** * Execute Command * * If $callback is set to false then \phpseclib3\Net\SSH2::get_channel_packet(self::CHANNEL_EXEC) will need to be called manually. * In all likelihood, this is not a feature you want to be taking advantage of. * * @param string $command * @return string|bool * @psalm-return ($callback is callable ? bool : string|bool) * @throws \RuntimeException on connection error */ public function exec($command, callable $callback = null) { $this->curTimeout = $this->timeout; $this->is_timeout = false; $this->stdErrorLog = ''; if (!$this->isAuthenticated()) { return false; } if ($this->in_request_pty_exec) { throw new \RuntimeException('If you want to run multiple exec()\'s you will need to disable (and re-enable if appropriate) a PTY for each one.'); } // RFC4254 defines the (client) window size as "bytes the other party can send before it must wait for the window to // be adjusted". 0x7FFFFFFF is, at 2GB, the max size. technically, it should probably be decremented, but, // honestly, if you're transferring more than 2GB, you probably shouldn't be using phpseclib, anyway. // see http://tools.ietf.org/html/rfc4254#section-5.2 for more info $this->window_size_server_to_client[self::CHANNEL_EXEC] = $this->window_size; // 0x8000 is the maximum max packet size, per http://tools.ietf.org/html/rfc4253#section-6.1, although since PuTTy // uses 0x4000, that's what will be used here, as well. $packet_size = 0x4000; $packet = Strings::packSSH2( 'CsN3', NET_SSH2_MSG_CHANNEL_OPEN, 'session', self::CHANNEL_EXEC, $this->window_size_server_to_client[self::CHANNEL_EXEC], $packet_size ); $this->send_binary_packet($packet); $this->channel_status[self::CHANNEL_EXEC] = NET_SSH2_MSG_CHANNEL_OPEN; $this->get_channel_packet(self::CHANNEL_EXEC); if ($this->request_pty === true) { $terminal_modes = pack('C', NET_SSH2_TTY_OP_END); $packet = Strings::packSSH2( 'CNsCsN4s', NET_SSH2_MSG_CHANNEL_REQUEST, $this->server_channels[self::CHANNEL_EXEC], 'pty-req', 1, $this->term, $this->windowColumns, $this->windowRows, 0, 0, $terminal_modes ); $this->send_binary_packet($packet); $this->channel_status[self::CHANNEL_EXEC] = NET_SSH2_MSG_CHANNEL_REQUEST; if (!$this->get_channel_packet(self::CHANNEL_EXEC)) { $this->disconnect_helper(NET_SSH2_DISCONNECT_BY_APPLICATION); throw new \RuntimeException('Unable to request pseudo-terminal'); } $this->in_request_pty_exec = true; } // sending a pty-req SSH_MSG_CHANNEL_REQUEST message is unnecessary and, in fact, in most cases, slows things // down. the one place where it might be desirable is if you're doing something like \phpseclib3\Net\SSH2::exec('ping localhost &'). // with a pty-req SSH_MSG_CHANNEL_REQUEST, exec() will return immediately and the ping process will then // then immediately terminate. without such a request exec() will loop indefinitely. the ping process won't end but // neither will your script. // although, in theory, the size of SSH_MSG_CHANNEL_REQUEST could exceed the maximum packet size established by // SSH_MSG_CHANNEL_OPEN_CONFIRMATION, RFC4254#section-5.1 states that the "maximum packet size" refers to the // "maximum size of an individual data packet". ie. SSH_MSG_CHANNEL_DATA. RFC4254#section-5.2 corroborates. $packet = Strings::packSSH2( 'CNsCs', NET_SSH2_MSG_CHANNEL_REQUEST, $this->server_channels[self::CHANNEL_EXEC], 'exec', 1, $command ); $this->send_binary_packet($packet); $this->channel_status[self::CHANNEL_EXEC] = NET_SSH2_MSG_CHANNEL_REQUEST; if (!$this->get_channel_packet(self::CHANNEL_EXEC)) { return false; } $this->channel_status[self::CHANNEL_EXEC] = NET_SSH2_MSG_CHANNEL_DATA; if ($this->in_request_pty_exec) { return true; } $output = ''; while (true) { $temp = $this->get_channel_packet(self::CHANNEL_EXEC); switch (true) { case $temp === true: return is_callable($callback) ? true : $output; case $temp === false: return false; default: if (is_callable($callback)) { if ($callback($temp) === true) { $this->close_channel(self::CHANNEL_EXEC); return true; } } else { $output .= $temp; } } } } /** * Creates an interactive shell * * @see self::read() * @see self::write() * @return bool * @throws \UnexpectedValueException on receipt of unexpected packets * @throws \RuntimeException on other errors */ private function initShell() { if ($this->in_request_pty_exec === true) { return true; } $this->window_size_server_to_client[self::CHANNEL_SHELL] = $this->window_size; $packet_size = 0x4000; $packet = Strings::packSSH2( 'CsN3', NET_SSH2_MSG_CHANNEL_OPEN, 'session', self::CHANNEL_SHELL, $this->window_size_server_to_client[self::CHANNEL_SHELL], $packet_size ); $this->send_binary_packet($packet); $this->channel_status[self::CHANNEL_SHELL] = NET_SSH2_MSG_CHANNEL_OPEN; $this->get_channel_packet(self::CHANNEL_SHELL); $terminal_modes = pack('C', NET_SSH2_TTY_OP_END); $packet = Strings::packSSH2( 'CNsbsN4s', NET_SSH2_MSG_CHANNEL_REQUEST, $this->server_channels[self::CHANNEL_SHELL], 'pty-req', true, // want reply $this->term, $this->windowColumns, $this->windowRows, 0, 0, $terminal_modes ); $this->send_binary_packet($packet); $this->channel_status[self::CHANNEL_SHELL] = NET_SSH2_MSG_CHANNEL_REQUEST; if (!$this->get_channel_packet(self::CHANNEL_SHELL)) { throw new \RuntimeException('Unable to request pty'); } $packet = Strings::packSSH2( 'CNsb', NET_SSH2_MSG_CHANNEL_REQUEST, $this->server_channels[self::CHANNEL_SHELL], 'shell', true // want reply ); $this->send_binary_packet($packet); $response = $this->get_channel_packet(self::CHANNEL_SHELL); if ($response === false) { throw new \RuntimeException('Unable to request shell'); } $this->channel_status[self::CHANNEL_SHELL] = NET_SSH2_MSG_CHANNEL_DATA; $this->bitmap |= self::MASK_SHELL; return true; } /** * Return the channel to be used with read() / write() * * @see self::read() * @see self::write() * @return int */ private function get_interactive_channel() { switch (true) { case $this->in_subsystem: return self::CHANNEL_SUBSYSTEM; case $this->in_request_pty_exec: return self::CHANNEL_EXEC; default: return self::CHANNEL_SHELL; } } /** * Return an available open channel * * @return int */ private function get_open_channel() { $channel = self::CHANNEL_EXEC; do { if (isset($this->channel_status[$channel]) && $this->channel_status[$channel] == NET_SSH2_MSG_CHANNEL_OPEN) { return $channel; } } while ($channel++ < self::CHANNEL_SUBSYSTEM); return false; } /** * Request agent forwarding of remote server * * @return bool */ public function requestAgentForwarding() { $request_channel = $this->get_open_channel(); if ($request_channel === false) { return false; } $packet = Strings::packSSH2( 'CNsC', NET_SSH2_MSG_CHANNEL_REQUEST, $this->server_channels[$request_channel], 'auth-agent-req@openssh.com', 1 ); $this->channel_status[$request_channel] = NET_SSH2_MSG_CHANNEL_REQUEST; $this->send_binary_packet($packet); if (!$this->get_channel_packet($request_channel)) { return false; } $this->channel_status[$request_channel] = NET_SSH2_MSG_CHANNEL_OPEN; return true; } /** * Returns the output of an interactive shell * * Returns when there's a match for $expect, which can take the form of a string literal or, * if $mode == self::READ_REGEX, a regular expression. * * @see self::write() * @param string $expect * @param int $mode * @return string|bool|null * @throws \RuntimeException on connection error */ public function read($expect = '', $mode = self::READ_SIMPLE) { $this->curTimeout = $this->timeout; $this->is_timeout = false; if (!$this->isAuthenticated()) { throw new InsufficientSetupException('Operation disallowed prior to login()'); } if (!($this->bitmap & self::MASK_SHELL) && !$this->initShell()) { throw new \RuntimeException('Unable to initiate an interactive shell session'); } $channel = $this->get_interactive_channel(); if ($mode == self::READ_NEXT) { return $this->get_channel_packet($channel); } $match = $expect; while (true) { if ($mode == self::READ_REGEX) { preg_match($expect, substr($this->interactiveBuffer, -1024), $matches); $match = isset($matches[0]) ? $matches[0] : ''; } $pos = strlen($match) ? strpos($this->interactiveBuffer, $match) : false; if ($pos !== false) { return Strings::shift($this->interactiveBuffer, $pos + strlen($match)); } $response = $this->get_channel_packet($channel); if ($response === true) { $this->in_request_pty_exec = false; return Strings::shift($this->interactiveBuffer, strlen($this->interactiveBuffer)); } $this->interactiveBuffer .= $response; } } /** * Inputs a command into an interactive shell. * * @see SSH2::read() * @param string $cmd * @return void * @throws \RuntimeException on connection error */ public function write($cmd) { if (!$this->isAuthenticated()) { throw new InsufficientSetupException('Operation disallowed prior to login()'); } if (!($this->bitmap & self::MASK_SHELL) && !$this->initShell()) { throw new \RuntimeException('Unable to initiate an interactive shell session'); } $this->send_channel_packet($this->get_interactive_channel(), $cmd); } /** * Start a subsystem. * * Right now only one subsystem at a time is supported. To support multiple subsystem's stopSubsystem() could accept * a string that contained the name of the subsystem, but at that point, only one subsystem of each type could be opened. * To support multiple subsystem's of the same name maybe it'd be best if startSubsystem() generated a new channel id and * returns that and then that that was passed into stopSubsystem() but that'll be saved for a future date and implemented * if there's sufficient demand for such a feature. * * @see self::stopSubsystem() * @param string $subsystem * @return bool */ public function startSubsystem($subsystem) { $this->window_size_server_to_client[self::CHANNEL_SUBSYSTEM] = $this->window_size; $packet = Strings::packSSH2( 'CsN3', NET_SSH2_MSG_CHANNEL_OPEN, 'session', self::CHANNEL_SUBSYSTEM, $this->window_size, 0x4000 ); $this->send_binary_packet($packet); $this->channel_status[self::CHANNEL_SUBSYSTEM] = NET_SSH2_MSG_CHANNEL_OPEN; $this->get_channel_packet(self::CHANNEL_SUBSYSTEM); $packet = Strings::packSSH2( 'CNsCs', NET_SSH2_MSG_CHANNEL_REQUEST, $this->server_channels[self::CHANNEL_SUBSYSTEM], 'subsystem', 1, $subsystem ); $this->send_binary_packet($packet); $this->channel_status[self::CHANNEL_SUBSYSTEM] = NET_SSH2_MSG_CHANNEL_REQUEST; if (!$this->get_channel_packet(self::CHANNEL_SUBSYSTEM)) { return false; } $this->channel_status[self::CHANNEL_SUBSYSTEM] = NET_SSH2_MSG_CHANNEL_DATA; $this->bitmap |= self::MASK_SHELL; $this->in_subsystem = true; return true; } /** * Stops a subsystem. * * @see self::startSubsystem() * @return bool */ public function stopSubsystem() { $this->in_subsystem = false; $this->close_channel(self::CHANNEL_SUBSYSTEM); return true; } /** * Closes a channel * * If read() timed out you might want to just close the channel and have it auto-restart on the next read() call * */ public function reset() { $this->close_channel($this->get_interactive_channel()); } /** * Is timeout? * * Did exec() or read() return because they timed out or because they encountered the end? * */ public function isTimeout() { return $this->is_timeout; } /** * Disconnect * */ public function disconnect() { $this->disconnect_helper(NET_SSH2_DISCONNECT_BY_APPLICATION); if (isset($this->realtime_log_file) && is_resource($this->realtime_log_file)) { fclose($this->realtime_log_file); } unset(self::$connections[$this->getResourceId()]); } /** * Destructor. * * Will be called, automatically, if you're supporting just PHP5. If you're supporting PHP4, you'll need to call * disconnect(). * */ public function __destruct() { $this->disconnect(); } /** * Is the connection still active? * * @return bool */ public function isConnected() { return (bool) ($this->bitmap & self::MASK_CONNECTED); } /** * Have you successfully been logged in? * * @return bool */ public function isAuthenticated() { return (bool) ($this->bitmap & self::MASK_LOGIN); } /** * Pings a server connection, or tries to reconnect if the connection has gone down * * Inspired by http://php.net/manual/en/mysqli.ping.php * * @return bool */ public function ping() { if (!$this->isAuthenticated()) { if (!empty($this->auth)) { return $this->reconnect(); } return false; } $this->window_size_server_to_client[self::CHANNEL_KEEP_ALIVE] = $this->window_size; $packet_size = 0x4000; $packet = Strings::packSSH2( 'CsN3', NET_SSH2_MSG_CHANNEL_OPEN, 'session', self::CHANNEL_KEEP_ALIVE, $this->window_size_server_to_client[self::CHANNEL_KEEP_ALIVE], $packet_size ); try { $this->send_binary_packet($packet); $this->channel_status[self::CHANNEL_KEEP_ALIVE] = NET_SSH2_MSG_CHANNEL_OPEN; $response = $this->get_channel_packet(self::CHANNEL_KEEP_ALIVE); } catch (\RuntimeException $e) { return $this->reconnect(); } $this->close_channel(self::CHANNEL_KEEP_ALIVE); return true; } /** * In situ reconnect method * * @return boolean */ private function reconnect() { $this->reset_connection(NET_SSH2_DISCONNECT_CONNECTION_LOST); $this->retry_connect = true; $this->connect(); foreach ($this->auth as $auth) { $result = $this->login(...$auth); } return $result; } /** * Resets a connection for re-use * * @param int $reason */ protected function reset_connection($reason) { $this->disconnect_helper($reason); $this->decrypt = $this->encrypt = false; $this->decrypt_block_size = $this->encrypt_block_size = 8; $this->hmac_check = $this->hmac_create = false; $this->hmac_size = false; $this->session_id = false; $this->retry_connect = true; $this->get_seq_no = $this->send_seq_no = 0; } /** * Gets Binary Packets * * See '6. Binary Packet Protocol' of rfc4253 for more info. * * @see self::_send_binary_packet() * @param bool $skip_channel_filter * @return bool|string */ private function get_binary_packet($skip_channel_filter = false) { if ($skip_channel_filter) { if (!is_resource($this->fsock)) { throw new \InvalidArgumentException('fsock is not a resource.'); } $read = [$this->fsock]; $write = $except = null; if (!$this->curTimeout) { if ($this->keepAlive <= 0) { @stream_select($read, $write, $except, null); } else { if (!@stream_select($read, $write, $except, $this->keepAlive)) { $this->send_binary_packet(pack('CN', NET_SSH2_MSG_IGNORE, 0)); return $this->get_binary_packet(true); } } } else { if ($this->curTimeout < 0) { $this->is_timeout = true; return true; } $start = microtime(true); if ($this->keepAlive > 0 && $this->keepAlive < $this->curTimeout) { if (!@stream_select($read, $write, $except, $this->keepAlive)) { $this->send_binary_packet(pack('CN', NET_SSH2_MSG_IGNORE, 0)); $elapsed = microtime(true) - $start; $this->curTimeout -= $elapsed; return $this->get_binary_packet(true); } $elapsed = microtime(true) - $start; $this->curTimeout -= $elapsed; } $sec = (int) floor($this->curTimeout); $usec = (int) (1000000 * ($this->curTimeout - $sec)); // this can return a "stream_select(): unable to select [4]: Interrupted system call" error if (!@stream_select($read, $write, $except, $sec, $usec)) { $this->is_timeout = true; return true; } $elapsed = microtime(true) - $start; $this->curTimeout -= $elapsed; } } if (!is_resource($this->fsock) || feof($this->fsock)) { $this->bitmap = 0; $str = 'Connection closed (by server) prematurely'; if (isset($elapsed)) { $str .= ' ' . $elapsed . 's'; } throw new ConnectionClosedException($str); } $start = microtime(true); $raw = stream_get_contents($this->fsock, $this->decrypt_block_size); if (!strlen($raw)) { $this->bitmap = 0; throw new ConnectionClosedException('No data received from server'); } if ($this->decrypt) { switch ($this->decryptName) { case 'aes128-gcm@openssh.com': case 'aes256-gcm@openssh.com': $this->decrypt->setNonce( $this->decryptFixedPart . $this->decryptInvocationCounter ); Strings::increment_str($this->decryptInvocationCounter); $this->decrypt->setAAD($temp = Strings::shift($raw, 4)); extract(unpack('Npacket_length', $temp)); /** * @var integer $packet_length */ $raw .= $this->read_remaining_bytes($packet_length - $this->decrypt_block_size + 4); $stop = microtime(true); $tag = stream_get_contents($this->fsock, $this->decrypt_block_size); $this->decrypt->setTag($tag); $raw = $this->decrypt->decrypt($raw); $raw = $temp . $raw; $remaining_length = 0; break; case 'chacha20-poly1305@openssh.com': // This should be impossible, but we are checking anyway to narrow the type for Psalm. if (!($this->decrypt instanceof ChaCha20)) { throw new \LogicException('$this->decrypt is not a ' . ChaCha20::class); } $nonce = pack('N2', 0, $this->get_seq_no); $this->lengthDecrypt->setNonce($nonce); $temp = $this->lengthDecrypt->decrypt($aad = Strings::shift($raw, 4)); extract(unpack('Npacket_length', $temp)); /** * @var integer $packet_length */ $raw .= $this->read_remaining_bytes($packet_length - $this->decrypt_block_size + 4); $stop = microtime(true); $tag = stream_get_contents($this->fsock, 16); $this->decrypt->setNonce($nonce); $this->decrypt->setCounter(0); // this is the same approach that's implemented in Salsa20::createPoly1305Key() // but we don't want to use the same AEAD construction that RFC8439 describes // for ChaCha20-Poly1305 so we won't rely on it (see Salsa20::poly1305()) $this->decrypt->setPoly1305Key( $this->decrypt->encrypt(str_repeat("\0", 32)) ); $this->decrypt->setAAD($aad); $this->decrypt->setCounter(1); $this->decrypt->setTag($tag); $raw = $this->decrypt->decrypt($raw); $raw = $temp . $raw; $remaining_length = 0; break; default: if (!$this->hmac_check instanceof Hash || !$this->hmac_check_etm) { $raw = $this->decrypt->decrypt($raw); break; } extract(unpack('Npacket_length', $temp = Strings::shift($raw, 4))); /** * @var integer $packet_length */ $raw .= $this->read_remaining_bytes($packet_length - $this->decrypt_block_size + 4); $stop = microtime(true); $encrypted = $temp . $raw; $raw = $temp . $this->decrypt->decrypt($raw); $remaining_length = 0; } } if (strlen($raw) < 5) { $this->bitmap = 0; throw new \RuntimeException('Plaintext is too short'); } extract(unpack('Npacket_length/Cpadding_length', Strings::shift($raw, 5))); /** * @var integer $packet_length * @var integer $padding_length */ if (!isset($remaining_length)) { $remaining_length = $packet_length + 4 - $this->decrypt_block_size; } $buffer = $this->read_remaining_bytes($remaining_length); if (!isset($stop)) { $stop = microtime(true); } if (strlen($buffer)) { $raw .= $this->decrypt ? $this->decrypt->decrypt($buffer) : $buffer; } $payload = Strings::shift($raw, $packet_length - $padding_length - 1); $padding = Strings::shift($raw, $padding_length); // should leave $raw empty if ($this->hmac_check instanceof Hash) { $hmac = stream_get_contents($this->fsock, $this->hmac_size); if ($hmac === false || strlen($hmac) != $this->hmac_size) { $this->disconnect_helper(NET_SSH2_DISCONNECT_MAC_ERROR); throw new \RuntimeException('Error reading socket'); } $reconstructed = !$this->hmac_check_etm ? pack('NCa*', $packet_length, $padding_length, $payload . $padding) : $encrypted; if (($this->hmac_check->getHash() & "\xFF\xFF\xFF\xFF") == 'umac') { $this->hmac_check->setNonce("\0\0\0\0" . pack('N', $this->get_seq_no)); if ($hmac != $this->hmac_check->hash($reconstructed)) { $this->disconnect_helper(NET_SSH2_DISCONNECT_MAC_ERROR); throw new \RuntimeException('Invalid UMAC'); } } else { if ($hmac != $this->hmac_check->hash(pack('Na*', $this->get_seq_no, $reconstructed))) { $this->disconnect_helper(NET_SSH2_DISCONNECT_MAC_ERROR); throw new \RuntimeException('Invalid HMAC'); } } } switch ($this->decompress) { case self::NET_SSH2_COMPRESSION_ZLIB_AT_OPENSSH: if (!$this->isAuthenticated()) { break; } // fall-through case self::NET_SSH2_COMPRESSION_ZLIB: if ($this->regenerate_decompression_context) { $this->regenerate_decompression_context = false; $cmf = ord($payload[0]); $cm = $cmf & 0x0F; if ($cm != 8) { // deflate user_error("Only CM = 8 ('deflate') is supported ($cm)"); } $cinfo = ($cmf & 0xF0) >> 4; if ($cinfo > 7) { user_error("CINFO above 7 is not allowed ($cinfo)"); } $windowSize = 1 << ($cinfo + 8); $flg = ord($payload[1]); //$fcheck = $flg && 0x0F; if ((($cmf << 8) | $flg) % 31) { user_error('fcheck failed'); } $fdict = boolval($flg & 0x20); $flevel = ($flg & 0xC0) >> 6; $this->decompress_context = inflate_init(ZLIB_ENCODING_RAW, ['window' => $cinfo + 8]); $payload = substr($payload, 2); } if ($this->decompress_context) { $payload = inflate_add($this->decompress_context, $payload, ZLIB_PARTIAL_FLUSH); } } $this->get_seq_no++; if (defined('NET_SSH2_LOGGING')) { $current = microtime(true); $message_number = isset($this->message_numbers[ord($payload[0])]) ? $this->message_numbers[ord($payload[0])] : 'UNKNOWN (' . ord($payload[0]) . ')'; $message_number = '<- ' . $message_number . ' (since last: ' . round($current - $this->last_packet, 4) . ', network: ' . round($stop - $start, 4) . 's)'; $this->append_log($message_number, $payload); $this->last_packet = $current; } return $this->filter($payload, $skip_channel_filter); } /** * Read Remaining Bytes * * @see self::get_binary_packet() * @param int $remaining_length * @return string */ private function read_remaining_bytes($remaining_length) { if (!$remaining_length) { return ''; } $adjustLength = false; if ($this->decrypt) { switch (true) { case $this->decryptName == 'aes128-gcm@openssh.com': case $this->decryptName == 'aes256-gcm@openssh.com': case $this->decryptName == 'chacha20-poly1305@openssh.com': case $this->hmac_check instanceof Hash && $this->hmac_check_etm: $remaining_length += $this->decrypt_block_size - 4; $adjustLength = true; } } // quoting , // "implementations SHOULD check that the packet length is reasonable" // PuTTY uses 0x9000 as the actual max packet size and so to shall we // don't do this when GCM mode is used since GCM mode doesn't encrypt the length if ($remaining_length < -$this->decrypt_block_size || $remaining_length > 0x9000 || $remaining_length % $this->decrypt_block_size != 0) { if (!$this->bad_key_size_fix && self::bad_algorithm_candidate($this->decrypt ? $this->decryptName : '') && !($this->bitmap & SSH2::MASK_LOGIN)) { $this->bad_key_size_fix = true; $this->reset_connection(NET_SSH2_DISCONNECT_KEY_EXCHANGE_FAILED); return false; } throw new \RuntimeException('Invalid size'); } if ($adjustLength) { $remaining_length -= $this->decrypt_block_size - 4; } $buffer = ''; while ($remaining_length > 0) { $temp = stream_get_contents($this->fsock, $remaining_length); if ($temp === false || feof($this->fsock)) { $this->disconnect_helper(NET_SSH2_DISCONNECT_CONNECTION_LOST); throw new \RuntimeException('Error reading from socket'); } $buffer .= $temp; $remaining_length -= strlen($temp); } return $buffer; } /** * Filter Binary Packets * * Because some binary packets need to be ignored... * * @see self::_get_binary_packet() * @param string $payload * @param bool $skip_channel_filter * @return string|bool */ private function filter($payload, $skip_channel_filter) { switch (ord($payload[0])) { case NET_SSH2_MSG_DISCONNECT: Strings::shift($payload, 1); list($reason_code, $message) = Strings::unpackSSH2('Ns', $payload); $this->errors[] = 'SSH_MSG_DISCONNECT: ' . $this->disconnect_reasons[$reason_code] . "\r\n$message"; $this->bitmap = 0; return false; case NET_SSH2_MSG_IGNORE: $payload = $this->get_binary_packet($skip_channel_filter); break; case NET_SSH2_MSG_DEBUG: Strings::shift($payload, 2); // second byte is "always_display" list($message) = Strings::unpackSSH2('s', $payload); $this->errors[] = "SSH_MSG_DEBUG: $message"; $payload = $this->get_binary_packet($skip_channel_filter); break; case NET_SSH2_MSG_UNIMPLEMENTED: return false; case NET_SSH2_MSG_KEXINIT: if ($this->session_id !== false) { if (!$this->key_exchange($payload)) { $this->bitmap = 0; return false; } $payload = $this->get_binary_packet($skip_channel_filter); } } // see http://tools.ietf.org/html/rfc4252#section-5.4; only called when the encryption has been activated and when we haven't already logged in if (($this->bitmap & self::MASK_CONNECTED) && !$this->isAuthenticated() && !is_bool($payload) && ord($payload[0]) == NET_SSH2_MSG_USERAUTH_BANNER) { Strings::shift($payload, 1); list($this->banner_message) = Strings::unpackSSH2('s', $payload); $payload = $this->get_binary_packet(); } // only called when we've already logged in if (($this->bitmap & self::MASK_CONNECTED) && $this->isAuthenticated()) { if (is_bool($payload)) { return $payload; } switch (ord($payload[0])) { case NET_SSH2_MSG_CHANNEL_REQUEST: if (strlen($payload) == 31) { extract(unpack('cpacket_type/Nchannel/Nlength', $payload)); if (substr($payload, 9, $length) == 'keepalive@openssh.com' && isset($this->server_channels[$channel])) { if (ord(substr($payload, 9 + $length))) { // want reply $this->send_binary_packet(pack('CN', NET_SSH2_MSG_CHANNEL_SUCCESS, $this->server_channels[$channel])); } $payload = $this->get_binary_packet($skip_channel_filter); } } break; case NET_SSH2_MSG_CHANNEL_DATA: case NET_SSH2_MSG_CHANNEL_EXTENDED_DATA: case NET_SSH2_MSG_CHANNEL_CLOSE: case NET_SSH2_MSG_CHANNEL_EOF: if (!$skip_channel_filter && !empty($this->server_channels)) { $this->binary_packet_buffer = $payload; $this->get_channel_packet(true); $payload = $this->get_binary_packet(); } break; case NET_SSH2_MSG_GLOBAL_REQUEST: // see http://tools.ietf.org/html/rfc4254#section-4 Strings::shift($payload, 1); list($request_name) = Strings::unpackSSH2('s', $payload); $this->errors[] = "SSH_MSG_GLOBAL_REQUEST: $request_name"; try { $this->send_binary_packet(pack('C', NET_SSH2_MSG_REQUEST_FAILURE)); } catch (\RuntimeException $e) { return $this->disconnect_helper(NET_SSH2_DISCONNECT_BY_APPLICATION); } $payload = $this->get_binary_packet($skip_channel_filter); break; case NET_SSH2_MSG_CHANNEL_OPEN: // see http://tools.ietf.org/html/rfc4254#section-5.1 Strings::shift($payload, 1); list($data, $server_channel) = Strings::unpackSSH2('sN', $payload); switch ($data) { case 'auth-agent': case 'auth-agent@openssh.com': if (isset($this->agent)) { $new_channel = self::CHANNEL_AGENT_FORWARD; list( $remote_window_size, $remote_maximum_packet_size ) = Strings::unpackSSH2('NN', $payload); $this->packet_size_client_to_server[$new_channel] = $remote_window_size; $this->window_size_server_to_client[$new_channel] = $remote_maximum_packet_size; $this->window_size_client_to_server[$new_channel] = $this->window_size; $packet_size = 0x4000; $packet = pack( 'CN4', NET_SSH2_MSG_CHANNEL_OPEN_CONFIRMATION, $server_channel, $new_channel, $packet_size, $packet_size ); $this->server_channels[$new_channel] = $server_channel; $this->channel_status[$new_channel] = NET_SSH2_MSG_CHANNEL_OPEN_CONFIRMATION; $this->send_binary_packet($packet); } break; default: $packet = Strings::packSSH2( 'CN2ss', NET_SSH2_MSG_CHANNEL_OPEN_FAILURE, $server_channel, NET_SSH2_OPEN_ADMINISTRATIVELY_PROHIBITED, '', // description '' // language tag ); try { $this->send_binary_packet($packet); } catch (\RuntimeException $e) { return $this->disconnect_helper(NET_SSH2_DISCONNECT_BY_APPLICATION); } } $payload = $this->get_binary_packet($skip_channel_filter); break; case NET_SSH2_MSG_CHANNEL_WINDOW_ADJUST: Strings::shift($payload, 1); list($channel, $window_size) = Strings::unpackSSH2('NN', $payload); $this->window_size_client_to_server[$channel] += $window_size; $payload = ($this->bitmap & self::MASK_WINDOW_ADJUST) ? true : $this->get_binary_packet($skip_channel_filter); } } return $payload; } /** * Enable Quiet Mode * * Suppress stderr from output * */ public function enableQuietMode() { $this->quiet_mode = true; } /** * Disable Quiet Mode * * Show stderr in output * */ public function disableQuietMode() { $this->quiet_mode = false; } /** * Returns whether Quiet Mode is enabled or not * * @see self::enableQuietMode() * @see self::disableQuietMode() * @return bool */ public function isQuietModeEnabled() { return $this->quiet_mode; } /** * Enable request-pty when using exec() * */ public function enablePTY() { $this->request_pty = true; } /** * Disable request-pty when using exec() * */ public function disablePTY() { if ($this->in_request_pty_exec) { $this->close_channel(self::CHANNEL_EXEC); $this->in_request_pty_exec = false; } $this->request_pty = false; } /** * Returns whether request-pty is enabled or not * * @see self::enablePTY() * @see self::disablePTY() * @return bool */ public function isPTYEnabled() { return $this->request_pty; } /** * Gets channel data * * Returns the data as a string. bool(true) is returned if: * * - the server closes the channel * - if the connection times out * - if the channel status is CHANNEL_OPEN and the response was CHANNEL_OPEN_CONFIRMATION * - if the channel status is CHANNEL_REQUEST and the response was CHANNEL_SUCCESS * * bool(false) is returned if: * * - if the channel status is CHANNEL_REQUEST and the response was CHANNEL_FAILURE * * @param int $client_channel * @param bool $skip_extended * @return mixed * @throws \RuntimeException on connection error */ protected function get_channel_packet($client_channel, $skip_extended = false) { if (!empty($this->channel_buffers[$client_channel])) { switch ($this->channel_status[$client_channel]) { case NET_SSH2_MSG_CHANNEL_REQUEST: foreach ($this->channel_buffers[$client_channel] as $i => $packet) { switch (ord($packet[0])) { case NET_SSH2_MSG_CHANNEL_SUCCESS: case NET_SSH2_MSG_CHANNEL_FAILURE: unset($this->channel_buffers[$client_channel][$i]); return substr($packet, 1); } } break; default: return substr(array_shift($this->channel_buffers[$client_channel]), 1); } } while (true) { if ($this->binary_packet_buffer !== false) { $response = $this->binary_packet_buffer; $this->binary_packet_buffer = false; } else { $response = $this->get_binary_packet(true); if ($response === true && $this->is_timeout) { if ($client_channel == self::CHANNEL_EXEC && !$this->request_pty) { $this->close_channel($client_channel); } return true; } if ($response === false) { $this->disconnect_helper(NET_SSH2_DISCONNECT_CONNECTION_LOST); throw new ConnectionClosedException('Connection closed by server'); } } if ($client_channel == -1 && $response === true) { return true; } list($type, $channel) = Strings::unpackSSH2('CN', $response); // will not be setup yet on incoming channel open request if (isset($channel) && isset($this->channel_status[$channel]) && isset($this->window_size_server_to_client[$channel])) { $this->window_size_server_to_client[$channel] -= strlen($response); // resize the window, if appropriate if ($this->window_size_server_to_client[$channel] < 0) { // PuTTY does something more analogous to the following: //if ($this->window_size_server_to_client[$channel] < 0x3FFFFFFF) { $packet = pack('CNN', NET_SSH2_MSG_CHANNEL_WINDOW_ADJUST, $this->server_channels[$channel], $this->window_resize); $this->send_binary_packet($packet); $this->window_size_server_to_client[$channel] += $this->window_resize; } switch ($type) { case NET_SSH2_MSG_CHANNEL_EXTENDED_DATA: /* if ($client_channel == self::CHANNEL_EXEC) { $this->send_channel_packet($client_channel, chr(0)); } */ // currently, there's only one possible value for $data_type_code: NET_SSH2_EXTENDED_DATA_STDERR list($data_type_code, $data) = Strings::unpackSSH2('Ns', $response); $this->stdErrorLog .= $data; if ($skip_extended || $this->quiet_mode) { continue 2; } if ($client_channel == $channel && $this->channel_status[$channel] == NET_SSH2_MSG_CHANNEL_DATA) { return $data; } $this->channel_buffers[$channel][] = chr($type) . $data; continue 2; case NET_SSH2_MSG_CHANNEL_REQUEST: if ($this->channel_status[$channel] == NET_SSH2_MSG_CHANNEL_CLOSE) { continue 2; } list($value) = Strings::unpackSSH2('s', $response); switch ($value) { case 'exit-signal': list( , // FALSE $signal_name, , // core dumped $error_message ) = Strings::unpackSSH2('bsbs', $response); $this->errors[] = "SSH_MSG_CHANNEL_REQUEST (exit-signal): $signal_name"; if (strlen($error_message)) { $this->errors[count($this->errors) - 1] .= "\r\n$error_message"; } $this->send_binary_packet(pack('CN', NET_SSH2_MSG_CHANNEL_EOF, $this->server_channels[$client_channel])); $this->send_binary_packet(pack('CN', NET_SSH2_MSG_CHANNEL_CLOSE, $this->server_channels[$channel])); $this->channel_status[$channel] = NET_SSH2_MSG_CHANNEL_EOF; continue 3; case 'exit-status': list(, $this->exit_status) = Strings::unpackSSH2('CN', $response); // "The client MAY ignore these messages." // -- http://tools.ietf.org/html/rfc4254#section-6.10 continue 3; default: // "Some systems may not implement signals, in which case they SHOULD ignore this message." // -- http://tools.ietf.org/html/rfc4254#section-6.9 continue 3; } } switch ($this->channel_status[$channel]) { case NET_SSH2_MSG_CHANNEL_OPEN: switch ($type) { case NET_SSH2_MSG_CHANNEL_OPEN_CONFIRMATION: list( $this->server_channels[$channel], $window_size, $this->packet_size_client_to_server[$channel] ) = Strings::unpackSSH2('NNN', $response); if ($window_size < 0) { $window_size &= 0x7FFFFFFF; $window_size += 0x80000000; } $this->window_size_client_to_server[$channel] = $window_size; $result = $client_channel == $channel ? true : $this->get_channel_packet($client_channel, $skip_extended); $this->on_channel_open(); return $result; case NET_SSH2_MSG_CHANNEL_OPEN_FAILURE: $this->disconnect_helper(NET_SSH2_DISCONNECT_BY_APPLICATION); throw new \RuntimeException('Unable to open channel'); default: if ($client_channel == $channel) { $this->disconnect_helper(NET_SSH2_DISCONNECT_BY_APPLICATION); throw new \RuntimeException('Unexpected response to open request'); } return $this->get_channel_packet($client_channel, $skip_extended); } break; case NET_SSH2_MSG_CHANNEL_REQUEST: switch ($type) { case NET_SSH2_MSG_CHANNEL_SUCCESS: return true; case NET_SSH2_MSG_CHANNEL_FAILURE: return false; case NET_SSH2_MSG_CHANNEL_DATA: list($data) = Strings::unpackSSH2('s', $response); $this->channel_buffers[$channel][] = chr($type) . $data; return $this->get_channel_packet($client_channel, $skip_extended); default: $this->disconnect_helper(NET_SSH2_DISCONNECT_BY_APPLICATION); throw new \RuntimeException('Unable to fulfill channel request'); } case NET_SSH2_MSG_CHANNEL_CLOSE: return $type == NET_SSH2_MSG_CHANNEL_CLOSE ? true : $this->get_channel_packet($client_channel, $skip_extended); } } // ie. $this->channel_status[$channel] == NET_SSH2_MSG_CHANNEL_DATA switch ($type) { case NET_SSH2_MSG_CHANNEL_DATA: /* if ($channel == self::CHANNEL_EXEC) { // SCP requires null packets, such as this, be sent. further, in the case of the ssh.com SSH server // this actually seems to make things twice as fast. more to the point, the message right after // SSH_MSG_CHANNEL_DATA (usually SSH_MSG_IGNORE) won't block for as long as it would have otherwise. // in OpenSSH it slows things down but only by a couple thousandths of a second. $this->send_channel_packet($channel, chr(0)); } */ list($data) = Strings::unpackSSH2('s', $response); if ($channel == self::CHANNEL_AGENT_FORWARD) { $agent_response = $this->agent->forwardData($data); if (!is_bool($agent_response)) { $this->send_channel_packet($channel, $agent_response); } break; } if ($client_channel == $channel) { return $data; } $this->channel_buffers[$channel][] = chr($type) . $data; break; case NET_SSH2_MSG_CHANNEL_CLOSE: $this->curTimeout = 5; if ($this->bitmap & self::MASK_SHELL) { $this->bitmap &= ~self::MASK_SHELL; } if ($this->channel_status[$channel] != NET_SSH2_MSG_CHANNEL_EOF) { $this->send_binary_packet(pack('CN', NET_SSH2_MSG_CHANNEL_CLOSE, $this->server_channels[$channel])); } $this->channel_status[$channel] = NET_SSH2_MSG_CHANNEL_CLOSE; if ($client_channel == $channel) { return true; } // fall-through case NET_SSH2_MSG_CHANNEL_EOF: break; default: $this->disconnect_helper(NET_SSH2_DISCONNECT_BY_APPLICATION); throw new \RuntimeException("Error reading channel data ($type)"); } } } /** * Sends Binary Packets * * See '6. Binary Packet Protocol' of rfc4253 for more info. * * @param string $data * @param string $logged * @see self::_get_binary_packet() * @return void */ protected function send_binary_packet($data, $logged = null) { if (!is_resource($this->fsock) || feof($this->fsock)) { $this->bitmap = 0; throw new ConnectionClosedException('Connection closed prematurely'); } if (!isset($logged)) { $logged = $data; } switch ($this->compress) { case self::NET_SSH2_COMPRESSION_ZLIB_AT_OPENSSH: if (!$this->isAuthenticated()) { break; } // fall-through case self::NET_SSH2_COMPRESSION_ZLIB: if (!$this->regenerate_compression_context) { $header = ''; } else { $this->regenerate_compression_context = false; $this->compress_context = deflate_init(ZLIB_ENCODING_RAW, ['window' => 15]); $header = "\x78\x9C"; } if ($this->compress_context) { $data = $header . deflate_add($this->compress_context, $data, ZLIB_PARTIAL_FLUSH); } } // 4 (packet length) + 1 (padding length) + 4 (minimal padding amount) == 9 $packet_length = strlen($data) + 9; if ($this->encrypt && $this->encrypt->usesNonce()) { $packet_length -= 4; } // round up to the nearest $this->encrypt_block_size $packet_length += (($this->encrypt_block_size - 1) * $packet_length) % $this->encrypt_block_size; // subtracting strlen($data) is obvious - subtracting 5 is necessary because of packet_length and padding_length $padding_length = $packet_length - strlen($data) - 5; switch (true) { case $this->encrypt && $this->encrypt->usesNonce(): case $this->hmac_create instanceof Hash && $this->hmac_create_etm: $padding_length += 4; $packet_length += 4; } $padding = Random::string($padding_length); // we subtract 4 from packet_length because the packet_length field isn't supposed to include itself $packet = pack('NCa*', $packet_length - 4, $padding_length, $data . $padding); $hmac = ''; if ($this->hmac_create instanceof Hash && !$this->hmac_create_etm) { if (($this->hmac_create->getHash() & "\xFF\xFF\xFF\xFF") == 'umac') { $this->hmac_create->setNonce("\0\0\0\0" . pack('N', $this->send_seq_no)); $hmac = $this->hmac_create->hash($packet); } else { $hmac = $this->hmac_create->hash(pack('Na*', $this->send_seq_no, $packet)); } } if ($this->encrypt) { switch ($this->encryptName) { case 'aes128-gcm@openssh.com': case 'aes256-gcm@openssh.com': $this->encrypt->setNonce( $this->encryptFixedPart . $this->encryptInvocationCounter ); Strings::increment_str($this->encryptInvocationCounter); $this->encrypt->setAAD($temp = ($packet & "\xFF\xFF\xFF\xFF")); $packet = $temp . $this->encrypt->encrypt(substr($packet, 4)); break; case 'chacha20-poly1305@openssh.com': // This should be impossible, but we are checking anyway to narrow the type for Psalm. if (!($this->encrypt instanceof ChaCha20)) { throw new \LogicException('$this->encrypt is not a ' . ChaCha20::class); } $nonce = pack('N2', 0, $this->send_seq_no); $this->encrypt->setNonce($nonce); $this->lengthEncrypt->setNonce($nonce); $length = $this->lengthEncrypt->encrypt($packet & "\xFF\xFF\xFF\xFF"); $this->encrypt->setCounter(0); // this is the same approach that's implemented in Salsa20::createPoly1305Key() // but we don't want to use the same AEAD construction that RFC8439 describes // for ChaCha20-Poly1305 so we won't rely on it (see Salsa20::poly1305()) $this->encrypt->setPoly1305Key( $this->encrypt->encrypt(str_repeat("\0", 32)) ); $this->encrypt->setAAD($length); $this->encrypt->setCounter(1); $packet = $length . $this->encrypt->encrypt(substr($packet, 4)); break; default: $packet = $this->hmac_create instanceof Hash && $this->hmac_create_etm ? ($packet & "\xFF\xFF\xFF\xFF") . $this->encrypt->encrypt(substr($packet, 4)) : $this->encrypt->encrypt($packet); } } if ($this->hmac_create instanceof Hash && $this->hmac_create_etm) { if (($this->hmac_create->getHash() & "\xFF\xFF\xFF\xFF") == 'umac') { $this->hmac_create->setNonce("\0\0\0\0" . pack('N', $this->send_seq_no)); $hmac = $this->hmac_create->hash($packet); } else { $hmac = $this->hmac_create->hash(pack('Na*', $this->send_seq_no, $packet)); } } $this->send_seq_no++; $packet .= $this->encrypt && $this->encrypt->usesNonce() ? $this->encrypt->getTag() : $hmac; $start = microtime(true); $sent = @fputs($this->fsock, $packet); $stop = microtime(true); if (defined('NET_SSH2_LOGGING')) { $current = microtime(true); $message_number = isset($this->message_numbers[ord($logged[0])]) ? $this->message_numbers[ord($logged[0])] : 'UNKNOWN (' . ord($logged[0]) . ')'; $message_number = '-> ' . $message_number . ' (since last: ' . round($current - $this->last_packet, 4) . ', network: ' . round($stop - $start, 4) . 's)'; $this->append_log($message_number, $logged); $this->last_packet = $current; } if (strlen($packet) != $sent) { $this->bitmap = 0; throw new \RuntimeException("Only $sent of " . strlen($packet) . " bytes were sent"); } } /** * Logs data packets * * Makes sure that only the last 1MB worth of packets will be logged * * @param string $message_number * @param string $message */ private function append_log($message_number, $message) { $this->append_log_helper( NET_SSH2_LOGGING, $message_number, $message, $this->message_number_log, $this->message_log, $this->log_size, $this->realtime_log_file, $this->realtime_log_wrap, $this->realtime_log_size ); } /** * Logs data packet helper * * @param int $constant * @param string $message_number * @param string $message * @param array &$message_number_log * @param array &$message_log * @param int &$log_size * @param resource &$realtime_log_file * @param bool &$realtime_log_wrap * @param int &$realtime_log_size */ protected function append_log_helper($constant, $message_number, $message, array &$message_number_log, array &$message_log, &$log_size, &$realtime_log_file, &$realtime_log_wrap, &$realtime_log_size) { // remove the byte identifying the message type from all but the first two messages (ie. the identification strings) if (strlen($message_number) > 2) { Strings::shift($message); } switch ($constant) { // useful for benchmarks case self::LOG_SIMPLE: $message_number_log[] = $message_number; break; case self::LOG_SIMPLE_REALTIME: echo $message_number; echo PHP_SAPI == 'cli' ? "\r\n" : '
'; @flush(); @ob_flush(); break; // the most useful log for SSH2 case self::LOG_COMPLEX: $message_number_log[] = $message_number; $log_size += strlen($message); $message_log[] = $message; while ($log_size > self::LOG_MAX_SIZE) { $log_size -= strlen(array_shift($message_log)); array_shift($message_number_log); } break; // dump the output out realtime; packets may be interspersed with non packets, // passwords won't be filtered out and select other packets may not be correctly // identified case self::LOG_REALTIME: switch (PHP_SAPI) { case 'cli': $start = $stop = "\r\n"; break; default: $start = '
';
                        $stop = '
'; } echo $start . $this->format_log([$message], [$message_number]) . $stop; @flush(); @ob_flush(); break; // basically the same thing as self::LOG_REALTIME with the caveat that NET_SSH2_LOG_REALTIME_FILENAME // needs to be defined and that the resultant log file will be capped out at self::LOG_MAX_SIZE. // the earliest part of the log file is denoted by the first <<< START >>> and is not going to necessarily // at the beginning of the file case self::LOG_REALTIME_FILE: if (!isset($realtime_log_file)) { // PHP doesn't seem to like using constants in fopen() $filename = NET_SSH2_LOG_REALTIME_FILENAME; $fp = fopen($filename, 'w'); $realtime_log_file = $fp; } if (!is_resource($realtime_log_file)) { break; } $entry = $this->format_log([$message], [$message_number]); if ($realtime_log_wrap) { $temp = "<<< START >>>\r\n"; $entry .= $temp; fseek($realtime_log_file, ftell($realtime_log_file) - strlen($temp)); } $realtime_log_size += strlen($entry); if ($realtime_log_size > self::LOG_MAX_SIZE) { fseek($realtime_log_file, 0); $realtime_log_size = strlen($entry); $realtime_log_wrap = true; } fputs($realtime_log_file, $entry); } } /** * Sends channel data * * Spans multiple SSH_MSG_CHANNEL_DATAs if appropriate * * @param int $client_channel * @param string $data * @return void */ protected function send_channel_packet($client_channel, $data) { while (strlen($data)) { if (!$this->window_size_client_to_server[$client_channel]) { $this->bitmap ^= self::MASK_WINDOW_ADJUST; // using an invalid channel will let the buffers be built up for the valid channels $this->get_channel_packet(-1); $this->bitmap ^= self::MASK_WINDOW_ADJUST; } /* The maximum amount of data allowed is determined by the maximum packet size for the channel, and the current window size, whichever is smaller. -- http://tools.ietf.org/html/rfc4254#section-5.2 */ $max_size = min( $this->packet_size_client_to_server[$client_channel], $this->window_size_client_to_server[$client_channel] ); $temp = Strings::shift($data, $max_size); $packet = Strings::packSSH2( 'CNs', NET_SSH2_MSG_CHANNEL_DATA, $this->server_channels[$client_channel], $temp ); $this->window_size_client_to_server[$client_channel] -= strlen($temp); $this->send_binary_packet($packet); } } /** * Closes and flushes a channel * * \phpseclib3\Net\SSH2 doesn't properly close most channels. For exec() channels are normally closed by the server * and for SFTP channels are presumably closed when the client disconnects. This functions is intended * for SCP more than anything. * * @param int $client_channel * @param bool $want_reply * @return void */ private function close_channel($client_channel, $want_reply = false) { // see http://tools.ietf.org/html/rfc4254#section-5.3 $this->send_binary_packet(pack('CN', NET_SSH2_MSG_CHANNEL_EOF, $this->server_channels[$client_channel])); if (!$want_reply) { $this->send_binary_packet(pack('CN', NET_SSH2_MSG_CHANNEL_CLOSE, $this->server_channels[$client_channel])); } $this->channel_status[$client_channel] = NET_SSH2_MSG_CHANNEL_CLOSE; $this->curTimeout = 5; while (!is_bool($this->get_channel_packet($client_channel))) { } if ($this->is_timeout) { $this->disconnect(); } if ($want_reply) { $this->send_binary_packet(pack('CN', NET_SSH2_MSG_CHANNEL_CLOSE, $this->server_channels[$client_channel])); } if ($this->bitmap & self::MASK_SHELL) { $this->bitmap &= ~self::MASK_SHELL; } } /** * Disconnect * * @param int $reason * @return false */ protected function disconnect_helper($reason) { if ($this->bitmap & self::MASK_CONNECTED) { $data = Strings::packSSH2('CNss', NET_SSH2_MSG_DISCONNECT, $reason, '', ''); try { $this->send_binary_packet($data); } catch (\Exception $e) { } } $this->bitmap = 0; if (is_resource($this->fsock) && get_resource_type($this->fsock) === 'stream') { fclose($this->fsock); } return false; } /** * Define Array * * Takes any number of arrays whose indices are integers and whose values are strings and defines a bunch of * named constants from it, using the value as the name of the constant and the index as the value of the constant. * If any of the constants that would be defined already exists, none of the constants will be defined. * * @param mixed[] ...$args * @access protected */ protected function define_array(...$args) { foreach ($args as $arg) { foreach ($arg as $key => $value) { if (!defined($value)) { define($value, $key); } else { break 2; } } } } /** * Returns a log of the packets that have been sent and received. * * Returns a string if NET_SSH2_LOGGING == self::LOG_COMPLEX, an array if NET_SSH2_LOGGING == self::LOG_SIMPLE and false if !defined('NET_SSH2_LOGGING') * * @return array|false|string */ public function getLog() { if (!defined('NET_SSH2_LOGGING')) { return false; } switch (NET_SSH2_LOGGING) { case self::LOG_SIMPLE: return $this->message_number_log; case self::LOG_COMPLEX: $log = $this->format_log($this->message_log, $this->message_number_log); return PHP_SAPI == 'cli' ? $log : '
' . $log . '
'; default: return false; } } /** * Formats a log for printing * * @param array $message_log * @param array $message_number_log * @return string */ protected function format_log(array $message_log, array $message_number_log) { $output = ''; for ($i = 0; $i < count($message_log); $i++) { $output .= $message_number_log[$i] . "\r\n"; $current_log = $message_log[$i]; $j = 0; do { if (strlen($current_log)) { $output .= str_pad(dechex($j), 7, '0', STR_PAD_LEFT) . '0 '; } $fragment = Strings::shift($current_log, $this->log_short_width); $hex = substr(preg_replace_callback('#.#s', function ($matches) { return $this->log_boundary . str_pad(dechex(ord($matches[0])), 2, '0', STR_PAD_LEFT); }, $fragment), strlen($this->log_boundary)); // replace non ASCII printable characters with dots // http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters // also replace < with a . since < messes up the output on web browsers $raw = preg_replace('#[^\x20-\x7E]|<#', '.', $fragment); $output .= str_pad($hex, $this->log_long_width - $this->log_short_width, ' ') . $raw . "\r\n"; $j++; } while (strlen($current_log)); $output .= "\r\n"; } return $output; } /** * Helper function for agent->on_channel_open() * * Used when channels are created to inform agent * of said channel opening. Must be called after * channel open confirmation received * */ private function on_channel_open() { if (isset($this->agent)) { $this->agent->registerChannelOpen($this); } } /** * Returns the first value of the intersection of two arrays or false if * the intersection is empty. The order is defined by the first parameter. * * @param array $array1 * @param array $array2 * @return mixed False if intersection is empty, else intersected value. */ private static function array_intersect_first(array $array1, array $array2) { foreach ($array1 as $value) { if (in_array($value, $array2)) { return $value; } } return false; } /** * Returns all errors * * @return string[] */ public function getErrors() { return $this->errors; } /** * Returns the last error * * @return string */ public function getLastError() { $count = count($this->errors); if ($count > 0) { return $this->errors[$count - 1]; } } /** * Return the server identification. * * @return string|false */ public function getServerIdentification() { $this->connect(); return $this->server_identifier; } /** * Returns a list of algorithms the server supports * * @return array */ public function getServerAlgorithms() { $this->connect(); return [ 'kex' => $this->kex_algorithms, 'hostkey' => $this->server_host_key_algorithms, 'client_to_server' => [ 'crypt' => $this->encryption_algorithms_client_to_server, 'mac' => $this->mac_algorithms_client_to_server, 'comp' => $this->compression_algorithms_client_to_server, 'lang' => $this->languages_client_to_server ], 'server_to_client' => [ 'crypt' => $this->encryption_algorithms_server_to_client, 'mac' => $this->mac_algorithms_server_to_client, 'comp' => $this->compression_algorithms_server_to_client, 'lang' => $this->languages_server_to_client ] ]; } /** * Returns a list of KEX algorithms that phpseclib supports * * @return array */ public static function getSupportedKEXAlgorithms() { $kex_algorithms = [ // Elliptic Curve Diffie-Hellman Key Agreement (ECDH) using // Curve25519. See doc/curve25519-sha256@libssh.org.txt in the // libssh repository for more information. 'curve25519-sha256', 'curve25519-sha256@libssh.org', 'ecdh-sha2-nistp256', // RFC 5656 'ecdh-sha2-nistp384', // RFC 5656 'ecdh-sha2-nistp521', // RFC 5656 'diffie-hellman-group-exchange-sha256',// RFC 4419 'diffie-hellman-group-exchange-sha1', // RFC 4419 // Diffie-Hellman Key Agreement (DH) using integer modulo prime // groups. 'diffie-hellman-group14-sha256', 'diffie-hellman-group14-sha1', // REQUIRED 'diffie-hellman-group15-sha512', 'diffie-hellman-group16-sha512', 'diffie-hellman-group17-sha512', 'diffie-hellman-group18-sha512', 'diffie-hellman-group1-sha1', // REQUIRED ]; return $kex_algorithms; } /** * Returns a list of host key algorithms that phpseclib supports * * @return array */ public static function getSupportedHostKeyAlgorithms() { return [ 'ssh-ed25519', // https://tools.ietf.org/html/draft-ietf-curdle-ssh-ed25519-02 'ecdsa-sha2-nistp256', // RFC 5656 'ecdsa-sha2-nistp384', // RFC 5656 'ecdsa-sha2-nistp521', // RFC 5656 'rsa-sha2-256', // RFC 8332 'rsa-sha2-512', // RFC 8332 'ssh-rsa', // RECOMMENDED sign Raw RSA Key 'ssh-dss' // REQUIRED sign Raw DSS Key ]; } /** * Returns a list of symmetric key algorithms that phpseclib supports * * @return array */ public static function getSupportedEncryptionAlgorithms() { $algos = [ // from : 'aes128-gcm@openssh.com', 'aes256-gcm@openssh.com', // from : 'arcfour256', 'arcfour128', //'arcfour', // OPTIONAL the ARCFOUR stream cipher with a 128-bit key // CTR modes from : 'aes128-ctr', // RECOMMENDED AES (Rijndael) in SDCTR mode, with 128-bit key 'aes192-ctr', // RECOMMENDED AES with 192-bit key 'aes256-ctr', // RECOMMENDED AES with 256-bit key // from : // one of the big benefits of chacha20-poly1305 is speed. the problem is... // libsodium doesn't generate the poly1305 keys in the way ssh does and openssl's PHP bindings don't even // seem to support poly1305 currently. so even if libsodium or openssl are being used for the chacha20 // part, pure-PHP has to be used for the poly1305 part and that's gonna cause a big slow down. // speed-wise it winds up being faster to use AES (when openssl or mcrypt are available) and some HMAC // (which is always gonna be super fast to compute thanks to the hash extension, which // "is bundled and compiled into PHP by default") 'chacha20-poly1305@openssh.com', 'twofish128-ctr', // OPTIONAL Twofish in SDCTR mode, with 128-bit key 'twofish192-ctr', // OPTIONAL Twofish with 192-bit key 'twofish256-ctr', // OPTIONAL Twofish with 256-bit key 'aes128-cbc', // RECOMMENDED AES with a 128-bit key 'aes192-cbc', // OPTIONAL AES with a 192-bit key 'aes256-cbc', // OPTIONAL AES in CBC mode, with a 256-bit key 'twofish128-cbc', // OPTIONAL Twofish with a 128-bit key 'twofish192-cbc', // OPTIONAL Twofish with a 192-bit key 'twofish256-cbc', 'twofish-cbc', // OPTIONAL alias for "twofish256-cbc" // (this is being retained for historical reasons) 'blowfish-ctr', // OPTIONAL Blowfish in SDCTR mode 'blowfish-cbc', // OPTIONAL Blowfish in CBC mode '3des-ctr', // RECOMMENDED Three-key 3DES in SDCTR mode '3des-cbc', // REQUIRED three-key 3DES in CBC mode //'none' // OPTIONAL no encryption; NOT RECOMMENDED ]; if (self::$crypto_engine) { $engines = [self::$crypto_engine]; } else { $engines = [ 'libsodium', 'OpenSSL (GCM)', 'OpenSSL', 'mcrypt', 'Eval', 'PHP' ]; } $ciphers = []; foreach ($engines as $engine) { foreach ($algos as $algo) { $obj = self::encryption_algorithm_to_crypt_instance($algo); if ($obj instanceof Rijndael) { $obj->setKeyLength(preg_replace('#[^\d]#', '', $algo)); } switch ($algo) { case 'chacha20-poly1305@openssh.com': case 'arcfour128': case 'arcfour256': if ($engine != 'Eval') { continue 2; } break; case 'aes128-gcm@openssh.com': case 'aes256-gcm@openssh.com': if ($engine == 'OpenSSL') { continue 2; } $obj->setNonce('dummydummydu'); } if ($obj->isValidEngine($engine)) { $algos = array_diff($algos, [$algo]); $ciphers[] = $algo; } } } return $ciphers; } /** * Returns a list of MAC algorithms that phpseclib supports * * @return array */ public static function getSupportedMACAlgorithms() { return [ 'hmac-sha2-256-etm@openssh.com', 'hmac-sha2-512-etm@openssh.com', 'umac-64-etm@openssh.com', 'umac-128-etm@openssh.com', 'hmac-sha1-etm@openssh.com', // from : 'hmac-sha2-256',// RECOMMENDED HMAC-SHA256 (digest length = key length = 32) 'hmac-sha2-512',// OPTIONAL HMAC-SHA512 (digest length = key length = 64) // from : 'umac-64@openssh.com', 'umac-128@openssh.com', 'hmac-sha1-96', // RECOMMENDED first 96 bits of HMAC-SHA1 (digest length = 12, key length = 20) 'hmac-sha1', // REQUIRED HMAC-SHA1 (digest length = key length = 20) 'hmac-md5-96', // OPTIONAL first 96 bits of HMAC-MD5 (digest length = 12, key length = 16) 'hmac-md5', // OPTIONAL HMAC-MD5 (digest length = key length = 16) //'none' // OPTIONAL no MAC; NOT RECOMMENDED ]; } /** * Returns a list of compression algorithms that phpseclib supports * * @return array */ public static function getSupportedCompressionAlgorithms() { $algos = ['none']; // REQUIRED no compression if (function_exists('deflate_init')) { $algos[] = 'zlib@openssh.com'; // https://datatracker.ietf.org/doc/html/draft-miller-secsh-compression-delayed $algos[] = 'zlib'; } return $algos; } /** * Return list of negotiated algorithms * * Uses the same format as https://www.php.net/ssh2-methods-negotiated * * @return array */ public function getAlgorithmsNegotiated() { $this->connect(); $compression_map = [ self::NET_SSH2_COMPRESSION_NONE => 'none', self::NET_SSH2_COMPRESSION_ZLIB => 'zlib', self::NET_SSH2_COMPRESSION_ZLIB_AT_OPENSSH => 'zlib@openssh.com' ]; return [ 'kex' => $this->kex_algorithm, 'hostkey' => $this->signature_format, 'client_to_server' => [ 'crypt' => $this->encryptName, 'mac' => $this->hmac_create_name, 'comp' => $compression_map[$this->compress], ], 'server_to_client' => [ 'crypt' => $this->decryptName, 'mac' => $this->hmac_check_name, 'comp' => $compression_map[$this->decompress], ] ]; } /** * Allows you to set the terminal * * @param string $term */ public function setTerminal($term) { $this->term = $term; } /** * Accepts an associative array with up to four parameters as described at * * * @param array $methods */ public function setPreferredAlgorithms(array $methods) { $preferred = $methods; if (isset($preferred['kex'])) { $preferred['kex'] = array_intersect( $preferred['kex'], static::getSupportedKEXAlgorithms() ); } if (isset($preferred['hostkey'])) { $preferred['hostkey'] = array_intersect( $preferred['hostkey'], static::getSupportedHostKeyAlgorithms() ); } $keys = ['client_to_server', 'server_to_client']; foreach ($keys as $key) { if (isset($preferred[$key])) { $a = &$preferred[$key]; if (isset($a['crypt'])) { $a['crypt'] = array_intersect( $a['crypt'], static::getSupportedEncryptionAlgorithms() ); } if (isset($a['comp'])) { $a['comp'] = array_intersect( $a['comp'], static::getSupportedCompressionAlgorithms() ); } if (isset($a['mac'])) { $a['mac'] = array_intersect( $a['mac'], static::getSupportedMACAlgorithms() ); } } } $keys = [ 'kex', 'hostkey', 'client_to_server/crypt', 'client_to_server/comp', 'client_to_server/mac', 'server_to_client/crypt', 'server_to_client/comp', 'server_to_client/mac', ]; foreach ($keys as $key) { $p = $preferred; $m = $methods; $subkeys = explode('/', $key); foreach ($subkeys as $subkey) { if (!isset($p[$subkey])) { continue 2; } $p = $p[$subkey]; $m = $m[$subkey]; } if (count($p) != count($m)) { $diff = array_diff($m, $p); $msg = count($diff) == 1 ? ' is not a supported algorithm' : ' are not supported algorithms'; throw new UnsupportedAlgorithmException(implode(', ', $diff) . $msg); } } $this->preferred = $preferred; } /** * Returns the banner message. * * Quoting from the RFC, "in some jurisdictions, sending a warning message before * authentication may be relevant for getting legal protection." * * @return string */ public function getBannerMessage() { return $this->banner_message; } /** * Returns the server public host key. * * Caching this the first time you connect to a server and checking the result on subsequent connections * is recommended. Returns false if the server signature is not signed correctly with the public host key. * * @return string|false * @throws \RuntimeException on badly formatted keys * @throws \phpseclib3\Exception\NoSupportedAlgorithmsException when the key isn't in a supported format */ public function getServerPublicHostKey() { if (!($this->bitmap & self::MASK_CONSTRUCTOR)) { $this->connect(); } $signature = $this->signature; $server_public_host_key = base64_encode($this->server_public_host_key); if ($this->signature_validated) { return $this->bitmap ? $this->signature_format . ' ' . $server_public_host_key : false; } $this->signature_validated = true; switch ($this->signature_format) { case 'ssh-ed25519': case 'ecdsa-sha2-nistp256': case 'ecdsa-sha2-nistp384': case 'ecdsa-sha2-nistp521': $key = EC::loadFormat('OpenSSH', $server_public_host_key) ->withSignatureFormat('SSH2'); switch ($this->signature_format) { case 'ssh-ed25519': $hash = 'sha512'; break; case 'ecdsa-sha2-nistp256': $hash = 'sha256'; break; case 'ecdsa-sha2-nistp384': $hash = 'sha384'; break; case 'ecdsa-sha2-nistp521': $hash = 'sha512'; } $key = $key->withHash($hash); break; case 'ssh-dss': $key = DSA::loadFormat('OpenSSH', $server_public_host_key) ->withSignatureFormat('SSH2') ->withHash('sha1'); break; case 'ssh-rsa': case 'rsa-sha2-256': case 'rsa-sha2-512': // could be ssh-rsa, rsa-sha2-256, rsa-sha2-512 // we don't check here because we already checked in key_exchange // some signatures have the type embedded within the message and some don't list(, $signature) = Strings::unpackSSH2('ss', $signature); $key = RSA::loadFormat('OpenSSH', $server_public_host_key) ->withPadding(RSA::SIGNATURE_PKCS1); switch ($this->signature_format) { case 'rsa-sha2-512': $hash = 'sha512'; break; case 'rsa-sha2-256': $hash = 'sha256'; break; //case 'ssh-rsa': default: $hash = 'sha1'; } $key = $key->withHash($hash); break; default: $this->disconnect_helper(NET_SSH2_DISCONNECT_HOST_KEY_NOT_VERIFIABLE); throw new NoSupportedAlgorithmsException('Unsupported signature format'); } if (!$key->verify($this->exchange_hash, $signature)) { return $this->disconnect_helper(NET_SSH2_DISCONNECT_HOST_KEY_NOT_VERIFIABLE); }; return $this->signature_format . ' ' . $server_public_host_key; } /** * Returns the exit status of an SSH command or false. * * @return false|int */ public function getExitStatus() { if (is_null($this->exit_status)) { return false; } return $this->exit_status; } /** * Returns the number of columns for the terminal window size. * * @return int */ public function getWindowColumns() { return $this->windowColumns; } /** * Returns the number of rows for the terminal window size. * * @return int */ public function getWindowRows() { return $this->windowRows; } /** * Sets the number of columns for the terminal window size. * * @param int $value */ public function setWindowColumns($value) { $this->windowColumns = $value; } /** * Sets the number of rows for the terminal window size. * * @param int $value */ public function setWindowRows($value) { $this->windowRows = $value; } /** * Sets the number of columns and rows for the terminal window size. * * @param int $columns * @param int $rows */ public function setWindowSize($columns = 80, $rows = 24) { $this->windowColumns = $columns; $this->windowRows = $rows; } /** * To String Magic Method * * @return string */ #[\ReturnTypeWillChange] public function __toString() { return $this->getResourceId(); } /** * Get Resource ID * * We use {} because that symbols should not be in URL according to * {@link http://tools.ietf.org/html/rfc3986#section-2 RFC}. * It will safe us from any conflicts, because otherwise regexp will * match all alphanumeric domains. * * @return string */ public function getResourceId() { return '{' . spl_object_hash($this) . '}'; } /** * Return existing connection * * @param string $id * * @return bool|SSH2 will return false if no such connection */ public static function getConnectionByResourceId($id) { if (isset(self::$connections[$id])) { return self::$connections[$id] instanceof \WeakReference ? self::$connections[$id]->get() : self::$connections[$id]; } return false; } /** * Return all excising connections * * @return array */ public static function getConnections() { if (!class_exists('WeakReference')) { /** @var array */ return self::$connections; } $temp = []; foreach (self::$connections as $key => $ref) { $temp[$key] = $ref->get(); } return $temp; } /* * Update packet types in log history * * @param string $old * @param string $new */ private function updateLogHistory($old, $new) { if (defined('NET_SSH2_LOGGING') && NET_SSH2_LOGGING == self::LOG_COMPLEX) { $this->message_number_log[count($this->message_number_log) - 1] = str_replace( $old, $new, $this->message_number_log[count($this->message_number_log) - 1] ); } } /** * Return the list of authentication methods that may productively continue authentication. * * @see https://tools.ietf.org/html/rfc4252#section-5.1 * @return array|null */ public function getAuthMethodsToContinue() { return $this->auth_methods_to_continue; } /** * Enables "smart" multi-factor authentication (MFA) */ public function enableSmartMFA() { $this->smartMFA = true; } /** * Disables "smart" multi-factor authentication (MFA) */ public function disableSmartMFA() { $this->smartMFA = false; } } * login('username', 'password')) { * exit('Login Failed'); * } * * echo $sftp->pwd() . "\r\n"; * $sftp->put('filename.ext', 'hello, world!'); * print_r($sftp->nlist()); * ?> * * * @author Jim Wigginton * @copyright 2009 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Net; use phpseclib3\Common\Functions\Strings; use phpseclib3\Exception\FileNotFoundException; /** * Pure-PHP implementations of SFTP. * * @author Jim Wigginton */ class SFTP extends SSH2 { /** * SFTP channel constant * * \phpseclib3\Net\SSH2::exec() uses 0 and \phpseclib3\Net\SSH2::read() / \phpseclib3\Net\SSH2::write() use 1. * * @see \phpseclib3\Net\SSH2::send_channel_packet() * @see \phpseclib3\Net\SSH2::get_channel_packet() */ const CHANNEL = 0x100; /** * Reads data from a local file. * * @see \phpseclib3\Net\SFTP::put() */ const SOURCE_LOCAL_FILE = 1; /** * Reads data from a string. * * @see \phpseclib3\Net\SFTP::put() */ // this value isn't really used anymore but i'm keeping it reserved for historical reasons const SOURCE_STRING = 2; /** * Reads data from callback: * function callback($length) returns string to proceed, null for EOF * * @see \phpseclib3\Net\SFTP::put() */ const SOURCE_CALLBACK = 16; /** * Resumes an upload * * @see \phpseclib3\Net\SFTP::put() */ const RESUME = 4; /** * Append a local file to an already existing remote file * * @see \phpseclib3\Net\SFTP::put() */ const RESUME_START = 8; /** * Packet Types * * @see self::__construct() * @var array * @access private */ private $packet_types = []; /** * Status Codes * * @see self::__construct() * @var array * @access private */ private $status_codes = []; /** @var array */ private $attributes; /** @var array */ private $open_flags; /** @var array */ private $open_flags5; /** @var array */ private $file_types; /** * The Request ID * * The request ID exists in the off chance that a packet is sent out-of-order. Of course, this library doesn't support * concurrent actions, so it's somewhat academic, here. * * @var boolean * @see self::_send_sftp_packet() */ private $use_request_id = false; /** * The Packet Type * * The request ID exists in the off chance that a packet is sent out-of-order. Of course, this library doesn't support * concurrent actions, so it's somewhat academic, here. * * @var int * @see self::_get_sftp_packet() */ private $packet_type = -1; /** * Packet Buffer * * @var string * @see self::_get_sftp_packet() */ private $packet_buffer = ''; /** * Extensions supported by the server * * @var array * @see self::_initChannel() */ private $extensions = []; /** * Server SFTP version * * @var int * @see self::_initChannel() */ private $version; /** * Default Server SFTP version * * @var int * @see self::_initChannel() */ private $defaultVersion; /** * Preferred SFTP version * * @var int * @see self::_initChannel() */ private $preferredVersion = 3; /** * Current working directory * * @var string|bool * @see self::realpath() * @see self::chdir() */ private $pwd = false; /** * Packet Type Log * * @see self::getLog() * @var array */ private $packet_type_log = []; /** * Packet Log * * @see self::getLog() * @var array */ private $packet_log = []; /** * Real-time log file pointer * * @see self::_append_log() * @var resource|closed-resource */ private $realtime_log_file; /** * Real-time log file size * * @see self::_append_log() * @var int */ private $realtime_log_size; /** * Real-time log file wrap boolean * * @see self::_append_log() * @var bool */ private $realtime_log_wrap; /** * Current log size * * Should never exceed self::LOG_MAX_SIZE * * @var int */ private $log_size; /** * Error information * * @see self::getSFTPErrors() * @see self::getLastSFTPError() * @var array */ private $sftp_errors = []; /** * Stat Cache * * Rather than always having to open a directory and close it immediately there after to see if a file is a directory * we'll cache the results. * * @see self::_update_stat_cache() * @see self::_remove_from_stat_cache() * @see self::_query_stat_cache() * @var array */ private $stat_cache = []; /** * Max SFTP Packet Size * * @see self::__construct() * @see self::get() * @var int */ private $max_sftp_packet; /** * Stat Cache Flag * * @see self::disableStatCache() * @see self::enableStatCache() * @var bool */ private $use_stat_cache = true; /** * Sort Options * * @see self::_comparator() * @see self::setListOrder() * @var array */ protected $sortOptions = []; /** * Canonicalization Flag * * Determines whether or not paths should be canonicalized before being * passed on to the remote server. * * @see self::enablePathCanonicalization() * @see self::disablePathCanonicalization() * @see self::realpath() * @var bool */ private $canonicalize_paths = true; /** * Request Buffers * * @see self::_get_sftp_packet() * @var array */ private $requestBuffer = []; /** * Preserve timestamps on file downloads / uploads * * @see self::get() * @see self::put() * @var bool */ private $preserveTime = false; /** * Arbitrary Length Packets Flag * * Determines whether or not packets of any length should be allowed, * in cases where the server chooses the packet length (such as * directory listings). By default, packets are only allowed to be * 256 * 1024 bytes (SFTP_MAX_MSG_LENGTH from OpenSSH's sftp-common.h) * * @see self::enableArbitraryLengthPackets() * @see self::_get_sftp_packet() * @var bool */ private $allow_arbitrary_length_packets = false; /** * Was the last packet due to the channels being closed or not? * * @see self::get() * @see self::get_sftp_packet() * @var bool */ private $channel_close = false; /** * Has the SFTP channel been partially negotiated? * * @var bool */ private $partial_init = false; /** * Default Constructor. * * Connects to an SFTP server * * @param string $host * @param int $port * @param int $timeout */ public function __construct($host, $port = 22, $timeout = 10) { parent::__construct($host, $port, $timeout); $this->max_sftp_packet = 1 << 15; $this->packet_types = [ 1 => 'NET_SFTP_INIT', 2 => 'NET_SFTP_VERSION', 3 => 'NET_SFTP_OPEN', 4 => 'NET_SFTP_CLOSE', 5 => 'NET_SFTP_READ', 6 => 'NET_SFTP_WRITE', 7 => 'NET_SFTP_LSTAT', 9 => 'NET_SFTP_SETSTAT', 10 => 'NET_SFTP_FSETSTAT', 11 => 'NET_SFTP_OPENDIR', 12 => 'NET_SFTP_READDIR', 13 => 'NET_SFTP_REMOVE', 14 => 'NET_SFTP_MKDIR', 15 => 'NET_SFTP_RMDIR', 16 => 'NET_SFTP_REALPATH', 17 => 'NET_SFTP_STAT', 18 => 'NET_SFTP_RENAME', 19 => 'NET_SFTP_READLINK', 20 => 'NET_SFTP_SYMLINK', 21 => 'NET_SFTP_LINK', 101 => 'NET_SFTP_STATUS', 102 => 'NET_SFTP_HANDLE', 103 => 'NET_SFTP_DATA', 104 => 'NET_SFTP_NAME', 105 => 'NET_SFTP_ATTRS', 200 => 'NET_SFTP_EXTENDED' ]; $this->status_codes = [ 0 => 'NET_SFTP_STATUS_OK', 1 => 'NET_SFTP_STATUS_EOF', 2 => 'NET_SFTP_STATUS_NO_SUCH_FILE', 3 => 'NET_SFTP_STATUS_PERMISSION_DENIED', 4 => 'NET_SFTP_STATUS_FAILURE', 5 => 'NET_SFTP_STATUS_BAD_MESSAGE', 6 => 'NET_SFTP_STATUS_NO_CONNECTION', 7 => 'NET_SFTP_STATUS_CONNECTION_LOST', 8 => 'NET_SFTP_STATUS_OP_UNSUPPORTED', 9 => 'NET_SFTP_STATUS_INVALID_HANDLE', 10 => 'NET_SFTP_STATUS_NO_SUCH_PATH', 11 => 'NET_SFTP_STATUS_FILE_ALREADY_EXISTS', 12 => 'NET_SFTP_STATUS_WRITE_PROTECT', 13 => 'NET_SFTP_STATUS_NO_MEDIA', 14 => 'NET_SFTP_STATUS_NO_SPACE_ON_FILESYSTEM', 15 => 'NET_SFTP_STATUS_QUOTA_EXCEEDED', 16 => 'NET_SFTP_STATUS_UNKNOWN_PRINCIPAL', 17 => 'NET_SFTP_STATUS_LOCK_CONFLICT', 18 => 'NET_SFTP_STATUS_DIR_NOT_EMPTY', 19 => 'NET_SFTP_STATUS_NOT_A_DIRECTORY', 20 => 'NET_SFTP_STATUS_INVALID_FILENAME', 21 => 'NET_SFTP_STATUS_LINK_LOOP', 22 => 'NET_SFTP_STATUS_CANNOT_DELETE', 23 => 'NET_SFTP_STATUS_INVALID_PARAMETER', 24 => 'NET_SFTP_STATUS_FILE_IS_A_DIRECTORY', 25 => 'NET_SFTP_STATUS_BYTE_RANGE_LOCK_CONFLICT', 26 => 'NET_SFTP_STATUS_BYTE_RANGE_LOCK_REFUSED', 27 => 'NET_SFTP_STATUS_DELETE_PENDING', 28 => 'NET_SFTP_STATUS_FILE_CORRUPT', 29 => 'NET_SFTP_STATUS_OWNER_INVALID', 30 => 'NET_SFTP_STATUS_GROUP_INVALID', 31 => 'NET_SFTP_STATUS_NO_MATCHING_BYTE_RANGE_LOCK' ]; // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-7.1 // the order, in this case, matters quite a lot - see \phpseclib3\Net\SFTP::_parseAttributes() to understand why $this->attributes = [ 0x00000001 => 'NET_SFTP_ATTR_SIZE', 0x00000002 => 'NET_SFTP_ATTR_UIDGID', // defined in SFTPv3, removed in SFTPv4+ 0x00000080 => 'NET_SFTP_ATTR_OWNERGROUP', // defined in SFTPv4+ 0x00000004 => 'NET_SFTP_ATTR_PERMISSIONS', 0x00000008 => 'NET_SFTP_ATTR_ACCESSTIME', 0x00000010 => 'NET_SFTP_ATTR_CREATETIME', // SFTPv4+ 0x00000020 => 'NET_SFTP_ATTR_MODIFYTIME', 0x00000040 => 'NET_SFTP_ATTR_ACL', 0x00000100 => 'NET_SFTP_ATTR_SUBSECOND_TIMES', 0x00000200 => 'NET_SFTP_ATTR_BITS', // SFTPv5+ 0x00000400 => 'NET_SFTP_ATTR_ALLOCATION_SIZE', // SFTPv6+ 0x00000800 => 'NET_SFTP_ATTR_TEXT_HINT', 0x00001000 => 'NET_SFTP_ATTR_MIME_TYPE', 0x00002000 => 'NET_SFTP_ATTR_LINK_COUNT', 0x00004000 => 'NET_SFTP_ATTR_UNTRANSLATED_NAME', 0x00008000 => 'NET_SFTP_ATTR_CTIME', // 0x80000000 will yield a floating point on 32-bit systems and converting floating points to integers // yields inconsistent behavior depending on how php is compiled. so we left shift -1 (which, in // two's compliment, consists of all 1 bits) by 31. on 64-bit systems this'll yield 0xFFFFFFFF80000000. // that's not a problem, however, and 'anded' and a 32-bit number, as all the leading 1 bits are ignored. (PHP_INT_SIZE == 4 ? -1 : 0xFFFFFFFF) => 'NET_SFTP_ATTR_EXTENDED' ]; // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-04#section-6.3 // the flag definitions change somewhat in SFTPv5+. if SFTPv5+ support is added to this library, maybe name // the array for that $this->open5_flags and similarly alter the constant names. $this->open_flags = [ 0x00000001 => 'NET_SFTP_OPEN_READ', 0x00000002 => 'NET_SFTP_OPEN_WRITE', 0x00000004 => 'NET_SFTP_OPEN_APPEND', 0x00000008 => 'NET_SFTP_OPEN_CREATE', 0x00000010 => 'NET_SFTP_OPEN_TRUNCATE', 0x00000020 => 'NET_SFTP_OPEN_EXCL', 0x00000040 => 'NET_SFTP_OPEN_TEXT' // defined in SFTPv4 ]; // SFTPv5+ changed the flags up: // https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-8.1.1.3 $this->open_flags5 = [ // when SSH_FXF_ACCESS_DISPOSITION is a 3 bit field that controls how the file is opened 0x00000000 => 'NET_SFTP_OPEN_CREATE_NEW', 0x00000001 => 'NET_SFTP_OPEN_CREATE_TRUNCATE', 0x00000002 => 'NET_SFTP_OPEN_OPEN_EXISTING', 0x00000003 => 'NET_SFTP_OPEN_OPEN_OR_CREATE', 0x00000004 => 'NET_SFTP_OPEN_TRUNCATE_EXISTING', // the rest of the flags are not supported 0x00000008 => 'NET_SFTP_OPEN_APPEND_DATA', // "the offset field of SS_FXP_WRITE requests is ignored" 0x00000010 => 'NET_SFTP_OPEN_APPEND_DATA_ATOMIC', 0x00000020 => 'NET_SFTP_OPEN_TEXT_MODE', 0x00000040 => 'NET_SFTP_OPEN_BLOCK_READ', 0x00000080 => 'NET_SFTP_OPEN_BLOCK_WRITE', 0x00000100 => 'NET_SFTP_OPEN_BLOCK_DELETE', 0x00000200 => 'NET_SFTP_OPEN_BLOCK_ADVISORY', 0x00000400 => 'NET_SFTP_OPEN_NOFOLLOW', 0x00000800 => 'NET_SFTP_OPEN_DELETE_ON_CLOSE', 0x00001000 => 'NET_SFTP_OPEN_ACCESS_AUDIT_ALARM_INFO', 0x00002000 => 'NET_SFTP_OPEN_ACCESS_BACKUP', 0x00004000 => 'NET_SFTP_OPEN_BACKUP_STREAM', 0x00008000 => 'NET_SFTP_OPEN_OVERRIDE_OWNER', ]; // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-04#section-5.2 // see \phpseclib3\Net\SFTP::_parseLongname() for an explanation $this->file_types = [ 1 => 'NET_SFTP_TYPE_REGULAR', 2 => 'NET_SFTP_TYPE_DIRECTORY', 3 => 'NET_SFTP_TYPE_SYMLINK', 4 => 'NET_SFTP_TYPE_SPECIAL', 5 => 'NET_SFTP_TYPE_UNKNOWN', // the following types were first defined for use in SFTPv5+ // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-05#section-5.2 6 => 'NET_SFTP_TYPE_SOCKET', 7 => 'NET_SFTP_TYPE_CHAR_DEVICE', 8 => 'NET_SFTP_TYPE_BLOCK_DEVICE', 9 => 'NET_SFTP_TYPE_FIFO' ]; $this->define_array( $this->packet_types, $this->status_codes, $this->attributes, $this->open_flags, $this->open_flags5, $this->file_types ); if (!defined('NET_SFTP_QUEUE_SIZE')) { define('NET_SFTP_QUEUE_SIZE', 32); } if (!defined('NET_SFTP_UPLOAD_QUEUE_SIZE')) { define('NET_SFTP_UPLOAD_QUEUE_SIZE', 1024); } } /** * Check a few things before SFTP functions are called * * @return bool */ private function precheck() { if (!($this->bitmap & SSH2::MASK_LOGIN)) { return false; } if ($this->pwd === false) { return $this->init_sftp_connection(); } return true; } /** * Partially initialize an SFTP connection * * @throws \UnexpectedValueException on receipt of unexpected packets * @return bool */ private function partial_init_sftp_connection() { $this->window_size_server_to_client[self::CHANNEL] = $this->window_size; $packet = Strings::packSSH2( 'CsN3', NET_SSH2_MSG_CHANNEL_OPEN, 'session', self::CHANNEL, $this->window_size, 0x4000 ); $this->send_binary_packet($packet); $this->channel_status[self::CHANNEL] = NET_SSH2_MSG_CHANNEL_OPEN; $response = $this->get_channel_packet(self::CHANNEL, true); if ($response === true && $this->isTimeout()) { return false; } $packet = Strings::packSSH2( 'CNsbs', NET_SSH2_MSG_CHANNEL_REQUEST, $this->server_channels[self::CHANNEL], 'subsystem', true, 'sftp' ); $this->send_binary_packet($packet); $this->channel_status[self::CHANNEL] = NET_SSH2_MSG_CHANNEL_REQUEST; $response = $this->get_channel_packet(self::CHANNEL, true); if ($response === false) { // from PuTTY's psftp.exe $command = "test -x /usr/lib/sftp-server && exec /usr/lib/sftp-server\n" . "test -x /usr/local/lib/sftp-server && exec /usr/local/lib/sftp-server\n" . "exec sftp-server"; // we don't do $this->exec($command, false) because exec() operates on a different channel and plus the SSH_MSG_CHANNEL_OPEN that exec() does // is redundant $packet = Strings::packSSH2( 'CNsCs', NET_SSH2_MSG_CHANNEL_REQUEST, $this->server_channels[self::CHANNEL], 'exec', 1, $command ); $this->send_binary_packet($packet); $this->channel_status[self::CHANNEL] = NET_SSH2_MSG_CHANNEL_REQUEST; $response = $this->get_channel_packet(self::CHANNEL, true); if ($response === false) { return false; } } elseif ($response === true && $this->isTimeout()) { return false; } $this->channel_status[self::CHANNEL] = NET_SSH2_MSG_CHANNEL_DATA; $this->send_sftp_packet(NET_SFTP_INIT, "\0\0\0\3"); $response = $this->get_sftp_packet(); if ($this->packet_type != NET_SFTP_VERSION) { throw new \UnexpectedValueException('Expected NET_SFTP_VERSION. ' . 'Got packet type: ' . $this->packet_type); } $this->use_request_id = true; list($this->defaultVersion) = Strings::unpackSSH2('N', $response); while (!empty($response)) { list($key, $value) = Strings::unpackSSH2('ss', $response); $this->extensions[$key] = $value; } $this->partial_init = true; return true; } /** * (Re)initializes the SFTP channel * * @return bool */ private function init_sftp_connection() { if (!$this->partial_init && !$this->partial_init_sftp_connection()) { return false; } /* A Note on SFTPv4/5/6 support: states the following: "If the client wishes to interoperate with servers that support noncontiguous version numbers it SHOULD send '3'" Given that the server only sends its version number after the client has already done so, the above seems to be suggesting that v3 should be the default version. This makes sense given that v3 is the most popular. states the following; "If the server did not send the "versions" extension, or the version-from-list was not included, the server MAY send a status response describing the failure, but MUST then close the channel without processing any further requests." So what do you do if you have a client whose initial SSH_FXP_INIT packet says it implements v3 and a server whose initial SSH_FXP_VERSION reply says it implements v4 and only v4? If it only implements v4, the "versions" extension is likely not going to have been sent so version re-negotiation as discussed in draft-ietf-secsh-filexfer-13 would be quite impossible. As such, what \phpseclib3\Net\SFTP would do is close the channel and reopen it with a new and updated SSH_FXP_INIT packet. */ $this->version = $this->defaultVersion; if (isset($this->extensions['versions']) && (!$this->preferredVersion || $this->preferredVersion != $this->version)) { $versions = explode(',', $this->extensions['versions']); $supported = [6, 5, 4]; if ($this->preferredVersion) { $supported = array_diff($supported, [$this->preferredVersion]); array_unshift($supported, $this->preferredVersion); } foreach ($supported as $ver) { if (in_array($ver, $versions)) { if ($ver === $this->version) { break; } $this->version = (int) $ver; $packet = Strings::packSSH2('ss', 'version-select', "$ver"); $this->send_sftp_packet(NET_SFTP_EXTENDED, $packet); $response = $this->get_sftp_packet(); if ($this->packet_type != NET_SFTP_STATUS) { throw new \UnexpectedValueException('Expected NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } list($status) = Strings::unpackSSH2('N', $response); if ($status != NET_SFTP_STATUS_OK) { $this->logError($response, $status); throw new \UnexpectedValueException('Expected NET_SFTP_STATUS_OK. ' . ' Got ' . $status); } break; } } } /* SFTPv4+ defines a 'newline' extension. SFTPv3 seems to have unofficial support for it via 'newline@vandyke.com', however, I'm not sure what 'newline@vandyke.com' is supposed to do (the fact that it's unofficial means that it's not in the official SFTPv3 specs) and 'newline@vandyke.com' / 'newline' are likely not drop-in substitutes for one another due to the fact that 'newline' comes with a SSH_FXF_TEXT bitmask whereas it seems unlikely that 'newline@vandyke.com' would. */ /* if (isset($this->extensions['newline@vandyke.com'])) { $this->extensions['newline'] = $this->extensions['newline@vandyke.com']; unset($this->extensions['newline@vandyke.com']); } */ if ($this->version < 2 || $this->version > 6) { return false; } $this->pwd = true; try { $this->pwd = $this->realpath('.'); } catch (\UnexpectedValueException $e) { if (!$this->canonicalize_paths) { throw $e; } $this->$this->canonicalize_paths = false; $this->reset_connection(NET_SSH2_DISCONNECT_CONNECTION_LOST); } $this->update_stat_cache($this->pwd, []); return true; } /** * Disable the stat cache * */ public function disableStatCache() { $this->use_stat_cache = false; } /** * Enable the stat cache * */ public function enableStatCache() { $this->use_stat_cache = true; } /** * Clear the stat cache * */ public function clearStatCache() { $this->stat_cache = []; } /** * Enable path canonicalization * */ public function enablePathCanonicalization() { $this->canonicalize_paths = true; } /** * Disable path canonicalization * * If this is enabled then $sftp->pwd() will not return the canonicalized absolute path * */ public function disablePathCanonicalization() { $this->canonicalize_paths = false; } /** * Enable arbitrary length packets * */ public function enableArbitraryLengthPackets() { $this->allow_arbitrary_length_packets = true; } /** * Disable arbitrary length packets * */ public function disableArbitraryLengthPackets() { $this->allow_arbitrary_length_packets = false; } /** * Returns the current directory name * * @return string|bool */ public function pwd() { if (!$this->precheck()) { return false; } return $this->pwd; } /** * Logs errors * * @param string $response * @param int $status */ private function logError($response, $status = -1) { if ($status == -1) { list($status) = Strings::unpackSSH2('N', $response); } $error = $this->status_codes[$status]; if ($this->version > 2) { list($message) = Strings::unpackSSH2('s', $response); $this->sftp_errors[] = "$error: $message"; } else { $this->sftp_errors[] = $error; } } /** * Canonicalize the Server-Side Path Name * * SFTP doesn't provide a mechanism by which the current working directory can be changed, so we'll emulate it. Returns * the absolute (canonicalized) path. * * If canonicalize_paths has been disabled using disablePathCanonicalization(), $path is returned as-is. * * @see self::chdir() * @see self::disablePathCanonicalization() * @param string $path * @throws \UnexpectedValueException on receipt of unexpected packets * @return mixed */ public function realpath($path) { if ($this->precheck() === false) { return false; } if (!$this->canonicalize_paths) { if ($this->pwd === true) { return '.'; } if (!strlen($path) || $path[0] != '/') { $path = $this->pwd . '/' . $path; } $parts = explode('/', $path); $afterPWD = $beforePWD = []; foreach ($parts as $part) { switch ($part) { //case '': // some SFTP servers /require/ double /'s. see https://github.com/phpseclib/phpseclib/pull/1137 case '.': break; case '..': if (!empty($afterPWD)) { array_pop($afterPWD); } else { $beforePWD[] = '..'; } break; default: $afterPWD[] = $part; } } $beforePWD = count($beforePWD) ? implode('/', $beforePWD) : '.'; return $beforePWD . '/' . implode('/', $afterPWD); } if ($this->pwd === true) { // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.9 $this->send_sftp_packet(NET_SFTP_REALPATH, Strings::packSSH2('s', $path)); $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_NAME: // although SSH_FXP_NAME is implemented differently in SFTPv3 than it is in SFTPv4+, the following // should work on all SFTP versions since the only part of the SSH_FXP_NAME packet the following looks // at is the first part and that part is defined the same in SFTP versions 3 through 6. list(, $filename) = Strings::unpackSSH2('Ns', $response); return $filename; case NET_SFTP_STATUS: $this->logError($response); return false; default: throw new \UnexpectedValueException('Expected NET_SFTP_NAME or NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } } if (!strlen($path) || $path[0] != '/') { $path = $this->pwd . '/' . $path; } $path = explode('/', $path); $new = []; foreach ($path as $dir) { if (!strlen($dir)) { continue; } switch ($dir) { case '..': array_pop($new); // fall-through case '.': break; default: $new[] = $dir; } } return '/' . implode('/', $new); } /** * Changes the current directory * * @param string $dir * @throws \UnexpectedValueException on receipt of unexpected packets * @return bool */ public function chdir($dir) { if (!$this->precheck()) { return false; } // assume current dir if $dir is empty if ($dir === '') { $dir = './'; // suffix a slash if needed } elseif ($dir[strlen($dir) - 1] != '/') { $dir .= '/'; } $dir = $this->realpath($dir); // confirm that $dir is, in fact, a valid directory if ($this->use_stat_cache && is_array($this->query_stat_cache($dir))) { $this->pwd = $dir; return true; } // we could do a stat on the alleged $dir to see if it's a directory but that doesn't tell us // the currently logged in user has the appropriate permissions or not. maybe you could see if // the file's uid / gid match the currently logged in user's uid / gid but how there's no easy // way to get those with SFTP $this->send_sftp_packet(NET_SFTP_OPENDIR, Strings::packSSH2('s', $dir)); // see \phpseclib3\Net\SFTP::nlist() for a more thorough explanation of the following $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_HANDLE: $handle = substr($response, 4); break; case NET_SFTP_STATUS: $this->logError($response); return false; default: throw new \UnexpectedValueException('Expected NET_SFTP_HANDLE or NET_SFTP_STATUS' . 'Got packet type: ' . $this->packet_type); } if (!$this->close_handle($handle)) { return false; } $this->update_stat_cache($dir, []); $this->pwd = $dir; return true; } /** * Returns a list of files in the given directory * * @param string $dir * @param bool $recursive * @return array|false */ public function nlist($dir = '.', $recursive = false) { return $this->nlist_helper($dir, $recursive, ''); } /** * Helper method for nlist * * @param string $dir * @param bool $recursive * @param string $relativeDir * @return array|false */ private function nlist_helper($dir, $recursive, $relativeDir) { $files = $this->readlist($dir, false); // If we get an int back, then that is an "unexpected" status. // We do not have a file list, so return false. if (is_int($files)) { return false; } if (!$recursive || $files === false) { return $files; } $result = []; foreach ($files as $value) { if ($value == '.' || $value == '..') { $result[] = $relativeDir . $value; continue; } if (is_array($this->query_stat_cache($this->realpath($dir . '/' . $value)))) { $temp = $this->nlist_helper($dir . '/' . $value, true, $relativeDir . $value . '/'); $temp = is_array($temp) ? $temp : []; $result = array_merge($result, $temp); } else { $result[] = $relativeDir . $value; } } return $result; } /** * Returns a detailed list of files in the given directory * * @param string $dir * @param bool $recursive * @return array|false */ public function rawlist($dir = '.', $recursive = false) { $files = $this->readlist($dir, true); // If we get an int back, then that is an "unexpected" status. // We do not have a file list, so return false. if (is_int($files)) { return false; } if (!$recursive || $files === false) { return $files; } static $depth = 0; foreach ($files as $key => $value) { if ($depth != 0 && $key == '..') { unset($files[$key]); continue; } $is_directory = false; if ($key != '.' && $key != '..') { if ($this->use_stat_cache) { $is_directory = is_array($this->query_stat_cache($this->realpath($dir . '/' . $key))); } else { $stat = $this->lstat($dir . '/' . $key); $is_directory = $stat && $stat['type'] === NET_SFTP_TYPE_DIRECTORY; } } if ($is_directory) { $depth++; $files[$key] = $this->rawlist($dir . '/' . $key, true); $depth--; } else { $files[$key] = (object) $value; } } return $files; } /** * Reads a list, be it detailed or not, of files in the given directory * * @param string $dir * @param bool $raw * @return array|false * @throws \UnexpectedValueException on receipt of unexpected packets */ private function readlist($dir, $raw = true) { if (!$this->precheck()) { return false; } $dir = $this->realpath($dir . '/'); if ($dir === false) { return false; } // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.1.2 $this->send_sftp_packet(NET_SFTP_OPENDIR, Strings::packSSH2('s', $dir)); $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_HANDLE: // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-9.2 // since 'handle' is the last field in the SSH_FXP_HANDLE packet, we'll just remove the first four bytes that // represent the length of the string and leave it at that $handle = substr($response, 4); break; case NET_SFTP_STATUS: // presumably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED list($status) = Strings::unpackSSH2('N', $response); $this->logError($response, $status); return $status; default: throw new \UnexpectedValueException('Expected NET_SFTP_HANDLE or NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } $this->update_stat_cache($dir, []); $contents = []; while (true) { // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.2.2 // why multiple SSH_FXP_READDIR packets would be sent when the response to a single one can span arbitrarily many // SSH_MSG_CHANNEL_DATA messages is not known to me. $this->send_sftp_packet(NET_SFTP_READDIR, Strings::packSSH2('s', $handle)); $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_NAME: list($count) = Strings::unpackSSH2('N', $response); for ($i = 0; $i < $count; $i++) { list($shortname) = Strings::unpackSSH2('s', $response); // SFTPv4 "removed the long filename from the names structure-- it can now be // built from information available in the attrs structure." if ($this->version < 4) { list($longname) = Strings::unpackSSH2('s', $response); } $attributes = $this->parseAttributes($response); if (!isset($attributes['type']) && $this->version < 4) { $fileType = $this->parseLongname($longname); if ($fileType) { $attributes['type'] = $fileType; } } $contents[$shortname] = $attributes + ['filename' => $shortname]; if (isset($attributes['type']) && $attributes['type'] == NET_SFTP_TYPE_DIRECTORY && ($shortname != '.' && $shortname != '..')) { $this->update_stat_cache($dir . '/' . $shortname, []); } else { if ($shortname == '..') { $temp = $this->realpath($dir . '/..') . '/.'; } else { $temp = $dir . '/' . $shortname; } $this->update_stat_cache($temp, (object) ['lstat' => $attributes]); } // SFTPv6 has an optional boolean end-of-list field, but we'll ignore that, since the // final SSH_FXP_STATUS packet should tell us that, already. } break; case NET_SFTP_STATUS: list($status) = Strings::unpackSSH2('N', $response); if ($status != NET_SFTP_STATUS_EOF) { $this->logError($response, $status); return $status; } break 2; default: throw new \UnexpectedValueException('Expected NET_SFTP_NAME or NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } } if (!$this->close_handle($handle)) { return false; } if (count($this->sortOptions)) { uasort($contents, [&$this, 'comparator']); } return $raw ? $contents : array_map('strval', array_keys($contents)); } /** * Compares two rawlist entries using parameters set by setListOrder() * * Intended for use with uasort() * * @param array $a * @param array $b * @return int */ private function comparator(array $a, array $b) { switch (true) { case $a['filename'] === '.' || $b['filename'] === '.': if ($a['filename'] === $b['filename']) { return 0; } return $a['filename'] === '.' ? -1 : 1; case $a['filename'] === '..' || $b['filename'] === '..': if ($a['filename'] === $b['filename']) { return 0; } return $a['filename'] === '..' ? -1 : 1; case isset($a['type']) && $a['type'] === NET_SFTP_TYPE_DIRECTORY: if (!isset($b['type'])) { return 1; } if ($b['type'] !== $a['type']) { return -1; } break; case isset($b['type']) && $b['type'] === NET_SFTP_TYPE_DIRECTORY: return 1; } foreach ($this->sortOptions as $sort => $order) { if (!isset($a[$sort]) || !isset($b[$sort])) { if (isset($a[$sort])) { return -1; } if (isset($b[$sort])) { return 1; } return 0; } switch ($sort) { case 'filename': $result = strcasecmp($a['filename'], $b['filename']); if ($result) { return $order === SORT_DESC ? -$result : $result; } break; case 'mode': $a[$sort] &= 07777; $b[$sort] &= 07777; // fall-through default: if ($a[$sort] === $b[$sort]) { break; } return $order === SORT_ASC ? $a[$sort] - $b[$sort] : $b[$sort] - $a[$sort]; } } } /** * Defines how nlist() and rawlist() will be sorted - if at all. * * If sorting is enabled directories and files will be sorted independently with * directories appearing before files in the resultant array that is returned. * * Any parameter returned by stat is a valid sort parameter for this function. * Filename comparisons are case insensitive. * * Examples: * * $sftp->setListOrder('filename', SORT_ASC); * $sftp->setListOrder('size', SORT_DESC, 'filename', SORT_ASC); * $sftp->setListOrder(true); * Separates directories from files but doesn't do any sorting beyond that * $sftp->setListOrder(); * Don't do any sort of sorting * * @param string ...$args */ public function setListOrder(...$args) { $this->sortOptions = []; if (empty($args)) { return; } $len = count($args) & 0x7FFFFFFE; for ($i = 0; $i < $len; $i += 2) { $this->sortOptions[$args[$i]] = $args[$i + 1]; } if (!count($this->sortOptions)) { $this->sortOptions = ['bogus' => true]; } } /** * Save files / directories to cache * * @param string $path * @param mixed $value */ private function update_stat_cache($path, $value) { if ($this->use_stat_cache === false) { return; } // preg_replace('#^/|/(?=/)|/$#', '', $dir) == str_replace('//', '/', trim($path, '/')) $dirs = explode('/', preg_replace('#^/|/(?=/)|/$#', '', $path)); $temp = &$this->stat_cache; $max = count($dirs) - 1; foreach ($dirs as $i => $dir) { // if $temp is an object that means one of two things. // 1. a file was deleted and changed to a directory behind phpseclib's back // 2. it's a symlink. when lstat is done it's unclear what it's a symlink to if (is_object($temp)) { $temp = []; } if (!isset($temp[$dir])) { $temp[$dir] = []; } if ($i === $max) { if (is_object($temp[$dir]) && is_object($value)) { if (!isset($value->stat) && isset($temp[$dir]->stat)) { $value->stat = $temp[$dir]->stat; } if (!isset($value->lstat) && isset($temp[$dir]->lstat)) { $value->lstat = $temp[$dir]->lstat; } } $temp[$dir] = $value; break; } $temp = &$temp[$dir]; } } /** * Remove files / directories from cache * * @param string $path * @return bool */ private function remove_from_stat_cache($path) { $dirs = explode('/', preg_replace('#^/|/(?=/)|/$#', '', $path)); $temp = &$this->stat_cache; $max = count($dirs) - 1; foreach ($dirs as $i => $dir) { if (!is_array($temp)) { return false; } if ($i === $max) { unset($temp[$dir]); return true; } if (!isset($temp[$dir])) { return false; } $temp = &$temp[$dir]; } } /** * Checks cache for path * * Mainly used by file_exists * * @param string $path * @return mixed */ private function query_stat_cache($path) { $dirs = explode('/', preg_replace('#^/|/(?=/)|/$#', '', $path)); $temp = &$this->stat_cache; foreach ($dirs as $dir) { if (!is_array($temp)) { return null; } if (!isset($temp[$dir])) { return null; } $temp = &$temp[$dir]; } return $temp; } /** * Returns general information about a file. * * Returns an array on success and false otherwise. * * @param string $filename * @return array|false */ public function stat($filename) { if (!$this->precheck()) { return false; } $filename = $this->realpath($filename); if ($filename === false) { return false; } if ($this->use_stat_cache) { $result = $this->query_stat_cache($filename); if (is_array($result) && isset($result['.']) && isset($result['.']->stat)) { return $result['.']->stat; } if (is_object($result) && isset($result->stat)) { return $result->stat; } } $stat = $this->stat_helper($filename, NET_SFTP_STAT); if ($stat === false) { $this->remove_from_stat_cache($filename); return false; } if (isset($stat['type'])) { if ($stat['type'] == NET_SFTP_TYPE_DIRECTORY) { $filename .= '/.'; } $this->update_stat_cache($filename, (object) ['stat' => $stat]); return $stat; } $pwd = $this->pwd; $stat['type'] = $this->chdir($filename) ? NET_SFTP_TYPE_DIRECTORY : NET_SFTP_TYPE_REGULAR; $this->pwd = $pwd; if ($stat['type'] == NET_SFTP_TYPE_DIRECTORY) { $filename .= '/.'; } $this->update_stat_cache($filename, (object) ['stat' => $stat]); return $stat; } /** * Returns general information about a file or symbolic link. * * Returns an array on success and false otherwise. * * @param string $filename * @return array|false */ public function lstat($filename) { if (!$this->precheck()) { return false; } $filename = $this->realpath($filename); if ($filename === false) { return false; } if ($this->use_stat_cache) { $result = $this->query_stat_cache($filename); if (is_array($result) && isset($result['.']) && isset($result['.']->lstat)) { return $result['.']->lstat; } if (is_object($result) && isset($result->lstat)) { return $result->lstat; } } $lstat = $this->stat_helper($filename, NET_SFTP_LSTAT); if ($lstat === false) { $this->remove_from_stat_cache($filename); return false; } if (isset($lstat['type'])) { if ($lstat['type'] == NET_SFTP_TYPE_DIRECTORY) { $filename .= '/.'; } $this->update_stat_cache($filename, (object) ['lstat' => $lstat]); return $lstat; } $stat = $this->stat_helper($filename, NET_SFTP_STAT); if ($lstat != $stat) { $lstat = array_merge($lstat, ['type' => NET_SFTP_TYPE_SYMLINK]); $this->update_stat_cache($filename, (object) ['lstat' => $lstat]); return $stat; } $pwd = $this->pwd; $lstat['type'] = $this->chdir($filename) ? NET_SFTP_TYPE_DIRECTORY : NET_SFTP_TYPE_REGULAR; $this->pwd = $pwd; if ($lstat['type'] == NET_SFTP_TYPE_DIRECTORY) { $filename .= '/.'; } $this->update_stat_cache($filename, (object) ['lstat' => $lstat]); return $lstat; } /** * Returns general information about a file or symbolic link * * Determines information without calling \phpseclib3\Net\SFTP::realpath(). * The second parameter can be either NET_SFTP_STAT or NET_SFTP_LSTAT. * * @param string $filename * @param int $type * @throws \UnexpectedValueException on receipt of unexpected packets * @return array|false */ private function stat_helper($filename, $type) { // SFTPv4+ adds an additional 32-bit integer field - flags - to the following: $packet = Strings::packSSH2('s', $filename); $this->send_sftp_packet($type, $packet); $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_ATTRS: return $this->parseAttributes($response); case NET_SFTP_STATUS: $this->logError($response); return false; } throw new \UnexpectedValueException('Expected NET_SFTP_ATTRS or NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } /** * Truncates a file to a given length * * @param string $filename * @param int $new_size * @return bool */ public function truncate($filename, $new_size) { $attr = Strings::packSSH2('NQ', NET_SFTP_ATTR_SIZE, $new_size); return $this->setstat($filename, $attr, false); } /** * Sets access and modification time of file. * * If the file does not exist, it will be created. * * @param string $filename * @param int $time * @param int $atime * @throws \UnexpectedValueException on receipt of unexpected packets * @return bool */ public function touch($filename, $time = null, $atime = null) { if (!$this->precheck()) { return false; } $filename = $this->realpath($filename); if ($filename === false) { return false; } if (!isset($time)) { $time = time(); } if (!isset($atime)) { $atime = $time; } $attr = $this->version < 4 ? pack('N3', NET_SFTP_ATTR_ACCESSTIME, $atime, $time) : Strings::packSSH2('NQ2', NET_SFTP_ATTR_ACCESSTIME | NET_SFTP_ATTR_MODIFYTIME, $atime, $time); $packet = Strings::packSSH2('s', $filename); $packet .= $this->version >= 5 ? pack('N2', 0, NET_SFTP_OPEN_OPEN_EXISTING) : pack('N', NET_SFTP_OPEN_WRITE | NET_SFTP_OPEN_CREATE | NET_SFTP_OPEN_EXCL); $packet .= $attr; $this->send_sftp_packet(NET_SFTP_OPEN, $packet); $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_HANDLE: return $this->close_handle(substr($response, 4)); case NET_SFTP_STATUS: $this->logError($response); break; default: throw new \UnexpectedValueException('Expected NET_SFTP_HANDLE or NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } return $this->setstat($filename, $attr, false); } /** * Changes file or directory owner * * $uid should be an int for SFTPv3 and a string for SFTPv4+. Ideally the string * would be of the form "user@dns_domain" but it does not need to be. * `$sftp->getSupportedVersions()['version']` will return the specific version * that's being used. * * Returns true on success or false on error. * * @param string $filename * @param int|string $uid * @param bool $recursive * @return bool */ public function chown($filename, $uid, $recursive = false) { /* quoting , "To avoid a representation that is tied to a particular underlying implementation at the client or server, the use of UTF-8 strings has been chosen. The string should be of the form "user@dns_domain". This will allow for a client and server that do not use the same local representation the ability to translate to a common syntax that can be interpreted by both. In the case where there is no translation available to the client or server, the attribute value must be constructed without the "@"." phpseclib _could_ auto append the dns_domain to $uid BUT what if it shouldn't have one? phpseclib would have no way of knowing so rather than guess phpseclib will just use whatever value the user provided */ $attr = $this->version < 4 ? // quoting , // "if the owner or group is specified as -1, then that ID is not changed" pack('N3', NET_SFTP_ATTR_UIDGID, $uid, -1) : // quoting , // "If either the owner or group field is zero length, the field should be // considered absent, and no change should be made to that specific field // during a modification operation" Strings::packSSH2('Nss', NET_SFTP_ATTR_OWNERGROUP, $uid, ''); return $this->setstat($filename, $attr, $recursive); } /** * Changes file or directory group * * $gid should be an int for SFTPv3 and a string for SFTPv4+. Ideally the string * would be of the form "user@dns_domain" but it does not need to be. * `$sftp->getSupportedVersions()['version']` will return the specific version * that's being used. * * Returns true on success or false on error. * * @param string $filename * @param int|string $gid * @param bool $recursive * @return bool */ public function chgrp($filename, $gid, $recursive = false) { $attr = $this->version < 4 ? pack('N3', NET_SFTP_ATTR_UIDGID, -1, $gid) : Strings::packSSH2('Nss', NET_SFTP_ATTR_OWNERGROUP, '', $gid); return $this->setstat($filename, $attr, $recursive); } /** * Set permissions on a file. * * Returns the new file permissions on success or false on error. * If $recursive is true than this just returns true or false. * * @param int $mode * @param string $filename * @param bool $recursive * @throws \UnexpectedValueException on receipt of unexpected packets * @return mixed */ public function chmod($mode, $filename, $recursive = false) { if (is_string($mode) && is_int($filename)) { $temp = $mode; $mode = $filename; $filename = $temp; } $attr = pack('N2', NET_SFTP_ATTR_PERMISSIONS, $mode & 07777); if (!$this->setstat($filename, $attr, $recursive)) { return false; } if ($recursive) { return true; } $filename = $this->realpath($filename); // rather than return what the permissions *should* be, we'll return what they actually are. this will also // tell us if the file actually exists. // incidentally, SFTPv4+ adds an additional 32-bit integer field - flags - to the following: $packet = pack('Na*', strlen($filename), $filename); $this->send_sftp_packet(NET_SFTP_STAT, $packet); $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_ATTRS: $attrs = $this->parseAttributes($response); return $attrs['mode']; case NET_SFTP_STATUS: $this->logError($response); return false; } throw new \UnexpectedValueException('Expected NET_SFTP_ATTRS or NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } /** * Sets information about a file * * @param string $filename * @param string $attr * @param bool $recursive * @throws \UnexpectedValueException on receipt of unexpected packets * @return bool */ private function setstat($filename, $attr, $recursive) { if (!$this->precheck()) { return false; } $filename = $this->realpath($filename); if ($filename === false) { return false; } $this->remove_from_stat_cache($filename); if ($recursive) { $i = 0; $result = $this->setstat_recursive($filename, $attr, $i); $this->read_put_responses($i); return $result; } $packet = Strings::packSSH2('s', $filename); $packet .= $this->version >= 4 ? pack('a*Ca*', substr($attr, 0, 4), NET_SFTP_TYPE_UNKNOWN, substr($attr, 4)) : $attr; $this->send_sftp_packet(NET_SFTP_SETSTAT, $packet); /* "Because some systems must use separate system calls to set various attributes, it is possible that a failure response will be returned, but yet some of the attributes may be have been successfully modified. If possible, servers SHOULD avoid this situation; however, clients MUST be aware that this is possible." -- http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.6 */ $response = $this->get_sftp_packet(); if ($this->packet_type != NET_SFTP_STATUS) { throw new \UnexpectedValueException('Expected NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } list($status) = Strings::unpackSSH2('N', $response); if ($status != NET_SFTP_STATUS_OK) { $this->logError($response, $status); return false; } return true; } /** * Recursively sets information on directories on the SFTP server * * Minimizes directory lookups and SSH_FXP_STATUS requests for speed. * * @param string $path * @param string $attr * @param int $i * @return bool */ private function setstat_recursive($path, $attr, &$i) { if (!$this->read_put_responses($i)) { return false; } $i = 0; $entries = $this->readlist($path, true); if ($entries === false || is_int($entries)) { return $this->setstat($path, $attr, false); } // normally $entries would have at least . and .. but it might not if the directories // permissions didn't allow reading if (empty($entries)) { return false; } unset($entries['.'], $entries['..']); foreach ($entries as $filename => $props) { if (!isset($props['type'])) { return false; } $temp = $path . '/' . $filename; if ($props['type'] == NET_SFTP_TYPE_DIRECTORY) { if (!$this->setstat_recursive($temp, $attr, $i)) { return false; } } else { $packet = Strings::packSSH2('s', $temp); $packet .= $this->version >= 4 ? pack('Ca*', NET_SFTP_TYPE_UNKNOWN, $attr) : $attr; $this->send_sftp_packet(NET_SFTP_SETSTAT, $packet); $i++; if ($i >= NET_SFTP_QUEUE_SIZE) { if (!$this->read_put_responses($i)) { return false; } $i = 0; } } } $packet = Strings::packSSH2('s', $path); $packet .= $this->version >= 4 ? pack('Ca*', NET_SFTP_TYPE_UNKNOWN, $attr) : $attr; $this->send_sftp_packet(NET_SFTP_SETSTAT, $packet); $i++; if ($i >= NET_SFTP_QUEUE_SIZE) { if (!$this->read_put_responses($i)) { return false; } $i = 0; } return true; } /** * Return the target of a symbolic link * * @param string $link * @throws \UnexpectedValueException on receipt of unexpected packets * @return mixed */ public function readlink($link) { if (!$this->precheck()) { return false; } $link = $this->realpath($link); $this->send_sftp_packet(NET_SFTP_READLINK, Strings::packSSH2('s', $link)); $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_NAME: break; case NET_SFTP_STATUS: $this->logError($response); return false; default: throw new \UnexpectedValueException('Expected NET_SFTP_NAME or NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } list($count) = Strings::unpackSSH2('N', $response); // the file isn't a symlink if (!$count) { return false; } list($filename) = Strings::unpackSSH2('s', $response); return $filename; } /** * Create a symlink * * symlink() creates a symbolic link to the existing target with the specified name link. * * @param string $target * @param string $link * @throws \UnexpectedValueException on receipt of unexpected packets * @return bool */ public function symlink($target, $link) { if (!$this->precheck()) { return false; } //$target = $this->realpath($target); $link = $this->realpath($link); /* quoting https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-09#section-12.1 : Changed the SYMLINK packet to be LINK and give it the ability to create hard links. Also change it's packet number because many implementation implemented SYMLINK with the arguments reversed. Hopefully the new argument names make it clear which way is which. */ if ($this->version == 6) { $type = NET_SFTP_LINK; $packet = Strings::packSSH2('ssC', $link, $target, 1); } else { $type = NET_SFTP_SYMLINK; /* quoting http://bxr.su/OpenBSD/usr.bin/ssh/PROTOCOL#347 : 3.1. sftp: Reversal of arguments to SSH_FXP_SYMLINK When OpenSSH's sftp-server was implemented, the order of the arguments to the SSH_FXP_SYMLINK method was inadvertently reversed. Unfortunately, the reversal was not noticed until the server was widely deployed. Since fixing this to follow the specification would cause incompatibility, the current order was retained. For correct operation, clients should send SSH_FXP_SYMLINK as follows: uint32 id string targetpath string linkpath */ $packet = substr($this->server_identifier, 0, 15) == 'SSH-2.0-OpenSSH' ? Strings::packSSH2('ss', $target, $link) : Strings::packSSH2('ss', $link, $target); } $this->send_sftp_packet($type, $packet); $response = $this->get_sftp_packet(); if ($this->packet_type != NET_SFTP_STATUS) { throw new \UnexpectedValueException('Expected NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } list($status) = Strings::unpackSSH2('N', $response); if ($status != NET_SFTP_STATUS_OK) { $this->logError($response, $status); return false; } return true; } /** * Creates a directory. * * @param string $dir * @param int $mode * @param bool $recursive * @return bool */ public function mkdir($dir, $mode = -1, $recursive = false) { if (!$this->precheck()) { return false; } $dir = $this->realpath($dir); if ($recursive) { $dirs = explode('/', preg_replace('#/(?=/)|/$#', '', $dir)); if (empty($dirs[0])) { array_shift($dirs); $dirs[0] = '/' . $dirs[0]; } for ($i = 0; $i < count($dirs); $i++) { $temp = array_slice($dirs, 0, $i + 1); $temp = implode('/', $temp); $result = $this->mkdir_helper($temp, $mode); } return $result; } return $this->mkdir_helper($dir, $mode); } /** * Helper function for directory creation * * @param string $dir * @param int $mode * @return bool */ private function mkdir_helper($dir, $mode) { // send SSH_FXP_MKDIR without any attributes (that's what the \0\0\0\0 is doing) $this->send_sftp_packet(NET_SFTP_MKDIR, Strings::packSSH2('s', $dir) . "\0\0\0\0"); $response = $this->get_sftp_packet(); if ($this->packet_type != NET_SFTP_STATUS) { throw new \UnexpectedValueException('Expected NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } list($status) = Strings::unpackSSH2('N', $response); if ($status != NET_SFTP_STATUS_OK) { $this->logError($response, $status); return false; } if ($mode !== -1) { $this->chmod($mode, $dir); } return true; } /** * Removes a directory. * * @param string $dir * @throws \UnexpectedValueException on receipt of unexpected packets * @return bool */ public function rmdir($dir) { if (!$this->precheck()) { return false; } $dir = $this->realpath($dir); if ($dir === false) { return false; } $this->send_sftp_packet(NET_SFTP_RMDIR, Strings::packSSH2('s', $dir)); $response = $this->get_sftp_packet(); if ($this->packet_type != NET_SFTP_STATUS) { throw new \UnexpectedValueException('Expected NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } list($status) = Strings::unpackSSH2('N', $response); if ($status != NET_SFTP_STATUS_OK) { // presumably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED? $this->logError($response, $status); return false; } $this->remove_from_stat_cache($dir); // the following will do a soft delete, which would be useful if you deleted a file // and then tried to do a stat on the deleted file. the above, in contrast, does // a hard delete //$this->update_stat_cache($dir, false); return true; } /** * Uploads a file to the SFTP server. * * By default, \phpseclib3\Net\SFTP::put() does not read from the local filesystem. $data is dumped directly into $remote_file. * So, for example, if you set $data to 'filename.ext' and then do \phpseclib3\Net\SFTP::get(), you will get a file, twelve bytes * long, containing 'filename.ext' as its contents. * * Setting $mode to self::SOURCE_LOCAL_FILE will change the above behavior. With self::SOURCE_LOCAL_FILE, $remote_file will * contain as many bytes as filename.ext does on your local filesystem. If your filename.ext is 1MB then that is how * large $remote_file will be, as well. * * Setting $mode to self::SOURCE_CALLBACK will use $data as callback function, which gets only one parameter -- number * of bytes to return, and returns a string if there is some data or null if there is no more data * * If $data is a resource then it'll be used as a resource instead. * * Currently, only binary mode is supported. As such, if the line endings need to be adjusted, you will need to take * care of that, yourself. * * $mode can take an additional two parameters - self::RESUME and self::RESUME_START. These are bitwise AND'd with * $mode. So if you want to resume upload of a 300mb file on the local file system you'd set $mode to the following: * * self::SOURCE_LOCAL_FILE | self::RESUME * * If you wanted to simply append the full contents of a local file to the full contents of a remote file you'd replace * self::RESUME with self::RESUME_START. * * If $mode & (self::RESUME | self::RESUME_START) then self::RESUME_START will be assumed. * * $start and $local_start give you more fine grained control over this process and take precident over self::RESUME * when they're non-negative. ie. $start could let you write at the end of a file (like self::RESUME) or in the middle * of one. $local_start could let you start your reading from the end of a file (like self::RESUME_START) or in the * middle of one. * * Setting $local_start to > 0 or $mode | self::RESUME_START doesn't do anything unless $mode | self::SOURCE_LOCAL_FILE. * * {@internal ASCII mode for SFTPv4/5/6 can be supported by adding a new function - \phpseclib3\Net\SFTP::setMode().} * * @param string $remote_file * @param string|resource $data * @param int $mode * @param int $start * @param int $local_start * @param callable|null $progressCallback * @throws \UnexpectedValueException on receipt of unexpected packets * @throws \BadFunctionCallException if you're uploading via a callback and the callback function is invalid * @throws \phpseclib3\Exception\FileNotFoundException if you're uploading via a file and the file doesn't exist * @return bool */ public function put($remote_file, $data, $mode = self::SOURCE_STRING, $start = -1, $local_start = -1, $progressCallback = null) { if (!$this->precheck()) { return false; } $remote_file = $this->realpath($remote_file); if ($remote_file === false) { return false; } $this->remove_from_stat_cache($remote_file); if ($this->version >= 5) { $flags = NET_SFTP_OPEN_OPEN_OR_CREATE; } else { $flags = NET_SFTP_OPEN_WRITE | NET_SFTP_OPEN_CREATE; // according to the SFTP specs, NET_SFTP_OPEN_APPEND should "force all writes to append data at the end of the file." // in practice, it doesn't seem to do that. //$flags|= ($mode & self::RESUME) ? NET_SFTP_OPEN_APPEND : NET_SFTP_OPEN_TRUNCATE; } if ($start >= 0) { $offset = $start; } elseif ($mode & self::RESUME) { // if NET_SFTP_OPEN_APPEND worked as it should _size() wouldn't need to be called $size = $this->stat($remote_file)['size']; $offset = $size !== false ? $size : 0; } else { $offset = 0; if ($this->version >= 5) { $flags = NET_SFTP_OPEN_CREATE_TRUNCATE; } else { $flags |= NET_SFTP_OPEN_TRUNCATE; } } $this->remove_from_stat_cache($remote_file); $packet = Strings::packSSH2('s', $remote_file); $packet .= $this->version >= 5 ? pack('N3', 0, $flags, 0) : pack('N2', $flags, 0); $this->send_sftp_packet(NET_SFTP_OPEN, $packet); $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_HANDLE: $handle = substr($response, 4); break; case NET_SFTP_STATUS: $this->logError($response); return false; default: throw new \UnexpectedValueException('Expected NET_SFTP_HANDLE or NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.2.3 $dataCallback = false; switch (true) { case $mode & self::SOURCE_CALLBACK: if (!is_callable($data)) { throw new \BadFunctionCallException("\$data should be is_callable() if you specify SOURCE_CALLBACK flag"); } $dataCallback = $data; // do nothing break; case is_resource($data): $mode = $mode & ~self::SOURCE_LOCAL_FILE; $info = stream_get_meta_data($data); if (isset($info['wrapper_type']) && $info['wrapper_type'] == 'PHP' && $info['stream_type'] == 'Input') { $fp = fopen('php://memory', 'w+'); stream_copy_to_stream($data, $fp); rewind($fp); } else { $fp = $data; } break; case $mode & self::SOURCE_LOCAL_FILE: if (!is_file($data)) { throw new FileNotFoundException("$data is not a valid file"); } $fp = @fopen($data, 'rb'); if (!$fp) { return false; } } if (isset($fp)) { $stat = fstat($fp); $size = !empty($stat) ? $stat['size'] : 0; if ($local_start >= 0) { fseek($fp, $local_start); $size -= $local_start; } } elseif ($dataCallback) { $size = 0; } else { $size = strlen($data); } $sent = 0; $size = $size < 0 ? ($size & 0x7FFFFFFF) + 0x80000000 : $size; $sftp_packet_size = $this->max_sftp_packet; // make the SFTP packet be exactly the SFTP packet size by including the bytes in the NET_SFTP_WRITE packets "header" $sftp_packet_size -= strlen($handle) + 25; $i = $j = 0; while ($dataCallback || ($size === 0 || $sent < $size)) { if ($dataCallback) { $temp = $dataCallback($sftp_packet_size); if (is_null($temp)) { break; } } else { $temp = isset($fp) ? fread($fp, $sftp_packet_size) : substr($data, $sent, $sftp_packet_size); if ($temp === false || $temp === '') { break; } } $subtemp = $offset + $sent; $packet = pack('Na*N3a*', strlen($handle), $handle, $subtemp / 4294967296, $subtemp, strlen($temp), $temp); try { $this->send_sftp_packet(NET_SFTP_WRITE, $packet, $j); } catch (\Exception $e) { if ($mode & self::SOURCE_LOCAL_FILE) { fclose($fp); } throw $e; } $sent += strlen($temp); if (is_callable($progressCallback)) { $progressCallback($sent); } $i++; $j++; if ($i == NET_SFTP_UPLOAD_QUEUE_SIZE) { if (!$this->read_put_responses($i)) { $i = 0; break; } $i = 0; } } $result = $this->close_handle($handle); if (!$this->read_put_responses($i)) { if ($mode & self::SOURCE_LOCAL_FILE) { fclose($fp); } $this->close_handle($handle); return false; } if ($mode & SFTP::SOURCE_LOCAL_FILE) { if (isset($fp) && is_resource($fp)) { fclose($fp); } if ($this->preserveTime) { $stat = stat($data); $attr = $this->version < 4 ? pack('N3', NET_SFTP_ATTR_ACCESSTIME, $stat['atime'], $stat['mtime']) : Strings::packSSH2('NQ2', NET_SFTP_ATTR_ACCESSTIME | NET_SFTP_ATTR_MODIFYTIME, $stat['atime'], $stat['mtime']); if (!$this->setstat($remote_file, $attr, false)) { throw new \RuntimeException('Error setting file time'); } } } return $result; } /** * Reads multiple successive SSH_FXP_WRITE responses * * Sending an SSH_FXP_WRITE packet and immediately reading its response isn't as efficient as blindly sending out $i * SSH_FXP_WRITEs, in succession, and then reading $i responses. * * @param int $i * @return bool * @throws \UnexpectedValueException on receipt of unexpected packets */ private function read_put_responses($i) { while ($i--) { $response = $this->get_sftp_packet(); if ($this->packet_type != NET_SFTP_STATUS) { throw new \UnexpectedValueException('Expected NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } list($status) = Strings::unpackSSH2('N', $response); if ($status != NET_SFTP_STATUS_OK) { $this->logError($response, $status); break; } } return $i < 0; } /** * Close handle * * @param string $handle * @return bool * @throws \UnexpectedValueException on receipt of unexpected packets */ private function close_handle($handle) { $this->send_sftp_packet(NET_SFTP_CLOSE, pack('Na*', strlen($handle), $handle)); // "The client MUST release all resources associated with the handle regardless of the status." // -- http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.1.3 $response = $this->get_sftp_packet(); if ($this->packet_type != NET_SFTP_STATUS) { throw new \UnexpectedValueException('Expected NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } list($status) = Strings::unpackSSH2('N', $response); if ($status != NET_SFTP_STATUS_OK) { $this->logError($response, $status); return false; } return true; } /** * Downloads a file from the SFTP server. * * Returns a string containing the contents of $remote_file if $local_file is left undefined or a boolean false if * the operation was unsuccessful. If $local_file is defined, returns true or false depending on the success of the * operation. * * $offset and $length can be used to download files in chunks. * * @param string $remote_file * @param string|bool|resource|callable $local_file * @param int $offset * @param int $length * @param callable|null $progressCallback * @throws \UnexpectedValueException on receipt of unexpected packets * @return string|bool */ public function get($remote_file, $local_file = false, $offset = 0, $length = -1, $progressCallback = null) { if (!$this->precheck()) { return false; } $remote_file = $this->realpath($remote_file); if ($remote_file === false) { return false; } $packet = Strings::packSSH2('s', $remote_file); $packet .= $this->version >= 5 ? pack('N3', 0, NET_SFTP_OPEN_OPEN_EXISTING, 0) : pack('N2', NET_SFTP_OPEN_READ, 0); $this->send_sftp_packet(NET_SFTP_OPEN, $packet); $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_HANDLE: $handle = substr($response, 4); break; case NET_SFTP_STATUS: // presumably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED $this->logError($response); return false; default: throw new \UnexpectedValueException('Expected NET_SFTP_HANDLE or NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } if (is_resource($local_file)) { $fp = $local_file; $stat = fstat($fp); $res_offset = $stat['size']; } else { $res_offset = 0; if ($local_file !== false && !is_callable($local_file)) { $fp = fopen($local_file, 'wb'); if (!$fp) { return false; } } else { $content = ''; } } $fclose_check = $local_file !== false && !is_callable($local_file) && !is_resource($local_file); $start = $offset; $read = 0; while (true) { $i = 0; while ($i < NET_SFTP_QUEUE_SIZE && ($length < 0 || $read < $length)) { $tempoffset = $start + $read; $packet_size = $length > 0 ? min($this->max_sftp_packet, $length - $read) : $this->max_sftp_packet; $packet = Strings::packSSH2('sN3', $handle, $tempoffset / 4294967296, $tempoffset, $packet_size); try { $this->send_sftp_packet(NET_SFTP_READ, $packet, $i); } catch (\Exception $e) { if ($fclose_check) { fclose($fp); } throw $e; } $packet = null; $read += $packet_size; $i++; } if (!$i) { break; } $packets_sent = $i - 1; $clear_responses = false; while ($i > 0) { $i--; if ($clear_responses) { $this->get_sftp_packet($packets_sent - $i); continue; } else { $response = $this->get_sftp_packet($packets_sent - $i); } switch ($this->packet_type) { case NET_SFTP_DATA: $temp = substr($response, 4); $offset += strlen($temp); if ($local_file === false) { $content .= $temp; } elseif (is_callable($local_file)) { $local_file($temp); } else { fputs($fp, $temp); } if (is_callable($progressCallback)) { call_user_func($progressCallback, $offset); } $temp = null; break; case NET_SFTP_STATUS: // could, in theory, return false if !strlen($content) but we'll hold off for the time being $this->logError($response); $clear_responses = true; // don't break out of the loop yet, so we can read the remaining responses break; default: if ($fclose_check) { fclose($fp); } if ($this->channel_close) { $this->partial_init = false; $this->init_sftp_connection(); return false; } else { throw new \UnexpectedValueException('Expected NET_SFTP_DATA or NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } } $response = null; } if ($clear_responses) { break; } } if ($length > 0 && $length <= $offset - $start) { if ($local_file === false) { $content = substr($content, 0, $length); } else { ftruncate($fp, $length + $res_offset); } } if ($fclose_check) { fclose($fp); if ($this->preserveTime) { $stat = $this->stat($remote_file); touch($local_file, $stat['mtime'], $stat['atime']); } } if (!$this->close_handle($handle)) { return false; } // if $content isn't set that means a file was written to return isset($content) ? $content : true; } /** * Deletes a file on the SFTP server. * * @param string $path * @param bool $recursive * @return bool * @throws \UnexpectedValueException on receipt of unexpected packets */ public function delete($path, $recursive = true) { if (!$this->precheck()) { return false; } if (is_object($path)) { // It's an object. Cast it as string before we check anything else. $path = (string) $path; } if (!is_string($path) || $path == '') { return false; } $path = $this->realpath($path); if ($path === false) { return false; } // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.3 $this->send_sftp_packet(NET_SFTP_REMOVE, pack('Na*', strlen($path), $path)); $response = $this->get_sftp_packet(); if ($this->packet_type != NET_SFTP_STATUS) { throw new \UnexpectedValueException('Expected NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } // if $status isn't SSH_FX_OK it's probably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED list($status) = Strings::unpackSSH2('N', $response); if ($status != NET_SFTP_STATUS_OK) { $this->logError($response, $status); if (!$recursive) { return false; } $i = 0; $result = $this->delete_recursive($path, $i); $this->read_put_responses($i); return $result; } $this->remove_from_stat_cache($path); return true; } /** * Recursively deletes directories on the SFTP server * * Minimizes directory lookups and SSH_FXP_STATUS requests for speed. * * @param string $path * @param int $i * @return bool */ private function delete_recursive($path, &$i) { if (!$this->read_put_responses($i)) { return false; } $i = 0; $entries = $this->readlist($path, true); // The folder does not exist at all, so we cannot delete it. if ($entries === NET_SFTP_STATUS_NO_SUCH_FILE) { return false; } // Normally $entries would have at least . and .. but it might not if the directories // permissions didn't allow reading. If this happens then default to an empty list of files. if ($entries === false || is_int($entries)) { $entries = []; } unset($entries['.'], $entries['..']); foreach ($entries as $filename => $props) { if (!isset($props['type'])) { return false; } $temp = $path . '/' . $filename; if ($props['type'] == NET_SFTP_TYPE_DIRECTORY) { if (!$this->delete_recursive($temp, $i)) { return false; } } else { $this->send_sftp_packet(NET_SFTP_REMOVE, Strings::packSSH2('s', $temp)); $this->remove_from_stat_cache($temp); $i++; if ($i >= NET_SFTP_QUEUE_SIZE) { if (!$this->read_put_responses($i)) { return false; } $i = 0; } } } $this->send_sftp_packet(NET_SFTP_RMDIR, Strings::packSSH2('s', $path)); $this->remove_from_stat_cache($path); $i++; if ($i >= NET_SFTP_QUEUE_SIZE) { if (!$this->read_put_responses($i)) { return false; } $i = 0; } return true; } /** * Checks whether a file or directory exists * * @param string $path * @return bool */ public function file_exists($path) { if ($this->use_stat_cache) { if (!$this->precheck()) { return false; } $path = $this->realpath($path); $result = $this->query_stat_cache($path); if (isset($result)) { // return true if $result is an array or if it's an stdClass object return $result !== false; } } return $this->stat($path) !== false; } /** * Tells whether the filename is a directory * * @param string $path * @return bool */ public function is_dir($path) { $result = $this->get_stat_cache_prop($path, 'type'); if ($result === false) { return false; } return $result === NET_SFTP_TYPE_DIRECTORY; } /** * Tells whether the filename is a regular file * * @param string $path * @return bool */ public function is_file($path) { $result = $this->get_stat_cache_prop($path, 'type'); if ($result === false) { return false; } return $result === NET_SFTP_TYPE_REGULAR; } /** * Tells whether the filename is a symbolic link * * @param string $path * @return bool */ public function is_link($path) { $result = $this->get_lstat_cache_prop($path, 'type'); if ($result === false) { return false; } return $result === NET_SFTP_TYPE_SYMLINK; } /** * Tells whether a file exists and is readable * * @param string $path * @return bool */ public function is_readable($path) { if (!$this->precheck()) { return false; } $packet = Strings::packSSH2('sNN', $this->realpath($path), NET_SFTP_OPEN_READ, 0); $this->send_sftp_packet(NET_SFTP_OPEN, $packet); $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_HANDLE: return true; case NET_SFTP_STATUS: // presumably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED return false; default: throw new \UnexpectedValueException('Expected NET_SFTP_HANDLE or NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } } /** * Tells whether the filename is writable * * @param string $path * @return bool */ public function is_writable($path) { if (!$this->precheck()) { return false; } $packet = Strings::packSSH2('sNN', $this->realpath($path), NET_SFTP_OPEN_WRITE, 0); $this->send_sftp_packet(NET_SFTP_OPEN, $packet); $response = $this->get_sftp_packet(); switch ($this->packet_type) { case NET_SFTP_HANDLE: return true; case NET_SFTP_STATUS: // presumably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED return false; default: throw new \UnexpectedValueException('Expected SSH_FXP_HANDLE or SSH_FXP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } } /** * Tells whether the filename is writeable * * Alias of is_writable * * @param string $path * @return bool */ public function is_writeable($path) { return $this->is_writable($path); } /** * Gets last access time of file * * @param string $path * @return mixed */ public function fileatime($path) { return $this->get_stat_cache_prop($path, 'atime'); } /** * Gets file modification time * * @param string $path * @return mixed */ public function filemtime($path) { return $this->get_stat_cache_prop($path, 'mtime'); } /** * Gets file permissions * * @param string $path * @return mixed */ public function fileperms($path) { return $this->get_stat_cache_prop($path, 'mode'); } /** * Gets file owner * * @param string $path * @return mixed */ public function fileowner($path) { return $this->get_stat_cache_prop($path, 'uid'); } /** * Gets file group * * @param string $path * @return mixed */ public function filegroup($path) { return $this->get_stat_cache_prop($path, 'gid'); } /** * Gets file size * * @param string $path * @return mixed */ public function filesize($path) { return $this->get_stat_cache_prop($path, 'size'); } /** * Gets file type * * @param string $path * @return string|false */ public function filetype($path) { $type = $this->get_stat_cache_prop($path, 'type'); if ($type === false) { return false; } switch ($type) { case NET_SFTP_TYPE_BLOCK_DEVICE: return 'block'; case NET_SFTP_TYPE_CHAR_DEVICE: return 'char'; case NET_SFTP_TYPE_DIRECTORY: return 'dir'; case NET_SFTP_TYPE_FIFO: return 'fifo'; case NET_SFTP_TYPE_REGULAR: return 'file'; case NET_SFTP_TYPE_SYMLINK: return 'link'; default: return false; } } /** * Return a stat properity * * Uses cache if appropriate. * * @param string $path * @param string $prop * @return mixed */ private function get_stat_cache_prop($path, $prop) { return $this->get_xstat_cache_prop($path, $prop, 'stat'); } /** * Return an lstat properity * * Uses cache if appropriate. * * @param string $path * @param string $prop * @return mixed */ private function get_lstat_cache_prop($path, $prop) { return $this->get_xstat_cache_prop($path, $prop, 'lstat'); } /** * Return a stat or lstat properity * * Uses cache if appropriate. * * @param string $path * @param string $prop * @param string $type * @return mixed */ private function get_xstat_cache_prop($path, $prop, $type) { if (!$this->precheck()) { return false; } if ($this->use_stat_cache) { $path = $this->realpath($path); $result = $this->query_stat_cache($path); if (is_object($result) && isset($result->$type)) { return $result->{$type}[$prop]; } } $result = $this->$type($path); if ($result === false || !isset($result[$prop])) { return false; } return $result[$prop]; } /** * Renames a file or a directory on the SFTP server. * * If the file already exists this will return false * * @param string $oldname * @param string $newname * @return bool * @throws \UnexpectedValueException on receipt of unexpected packets */ public function rename($oldname, $newname) { if (!$this->precheck()) { return false; } $oldname = $this->realpath($oldname); $newname = $this->realpath($newname); if ($oldname === false || $newname === false) { return false; } // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.3 $packet = Strings::packSSH2('ss', $oldname, $newname); if ($this->version >= 5) { /* quoting https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-05#section-6.5 , 'flags' is 0 or a combination of: SSH_FXP_RENAME_OVERWRITE 0x00000001 SSH_FXP_RENAME_ATOMIC 0x00000002 SSH_FXP_RENAME_NATIVE 0x00000004 (none of these are currently supported) */ $packet .= "\0\0\0\0"; } $this->send_sftp_packet(NET_SFTP_RENAME, $packet); $response = $this->get_sftp_packet(); if ($this->packet_type != NET_SFTP_STATUS) { throw new \UnexpectedValueException('Expected NET_SFTP_STATUS. ' . 'Got packet type: ' . $this->packet_type); } // if $status isn't SSH_FX_OK it's probably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED list($status) = Strings::unpackSSH2('N', $response); if ($status != NET_SFTP_STATUS_OK) { $this->logError($response, $status); return false; } // don't move the stat cache entry over since this operation could very well change the // atime and mtime attributes //$this->update_stat_cache($newname, $this->query_stat_cache($oldname)); $this->remove_from_stat_cache($oldname); $this->remove_from_stat_cache($newname); return true; } /** * Parse Time * * See '7.7. Times' of draft-ietf-secsh-filexfer-13 for more info. * * @param string $key * @param int $flags * @param string $response * @return array */ private function parseTime($key, $flags, &$response) { $attr = []; list($attr[$key]) = Strings::unpackSSH2('Q', $response); if ($flags & NET_SFTP_ATTR_SUBSECOND_TIMES) { list($attr[$key . '-nseconds']) = Strings::unpackSSH2('N', $response); } return $attr; } /** * Parse Attributes * * See '7. File Attributes' of draft-ietf-secsh-filexfer-13 for more info. * * @param string $response * @return array */ protected function parseAttributes(&$response) { if ($this->version >= 4) { list($flags, $attr['type']) = Strings::unpackSSH2('NC', $response); } else { list($flags) = Strings::unpackSSH2('N', $response); } foreach ($this->attributes as $key => $value) { switch ($flags & $key) { case NET_SFTP_ATTR_UIDGID: if ($this->version > 3) { continue 2; } break; case NET_SFTP_ATTR_CREATETIME: case NET_SFTP_ATTR_MODIFYTIME: case NET_SFTP_ATTR_ACL: case NET_SFTP_ATTR_OWNERGROUP: case NET_SFTP_ATTR_SUBSECOND_TIMES: if ($this->version < 4) { continue 2; } break; case NET_SFTP_ATTR_BITS: if ($this->version < 5) { continue 2; } break; case NET_SFTP_ATTR_ALLOCATION_SIZE: case NET_SFTP_ATTR_TEXT_HINT: case NET_SFTP_ATTR_MIME_TYPE: case NET_SFTP_ATTR_LINK_COUNT: case NET_SFTP_ATTR_UNTRANSLATED_NAME: case NET_SFTP_ATTR_CTIME: if ($this->version < 6) { continue 2; } } switch ($flags & $key) { case NET_SFTP_ATTR_SIZE: // 0x00000001 // The size attribute is defined as an unsigned 64-bit integer. // The following will use floats on 32-bit platforms, if necessary. // As can be seen in the BigInteger class, floats are generally // IEEE 754 binary64 "double precision" on such platforms and // as such can represent integers of at least 2^50 without loss // of precision. Interpreted in filesize, 2^50 bytes = 1024 TiB. list($attr['size']) = Strings::unpackSSH2('Q', $response); break; case NET_SFTP_ATTR_UIDGID: // 0x00000002 (SFTPv3 only) list($attr['uid'], $attr['gid']) = Strings::unpackSSH2('NN', $response); break; case NET_SFTP_ATTR_PERMISSIONS: // 0x00000004 list($attr['mode']) = Strings::unpackSSH2('N', $response); $fileType = $this->parseMode($attr['mode']); if ($this->version < 4 && $fileType !== false) { $attr += ['type' => $fileType]; } break; case NET_SFTP_ATTR_ACCESSTIME: // 0x00000008 if ($this->version >= 4) { $attr += $this->parseTime('atime', $flags, $response); break; } list($attr['atime'], $attr['mtime']) = Strings::unpackSSH2('NN', $response); break; case NET_SFTP_ATTR_CREATETIME: // 0x00000010 (SFTPv4+) $attr += $this->parseTime('createtime', $flags, $response); break; case NET_SFTP_ATTR_MODIFYTIME: // 0x00000020 $attr += $this->parseTime('mtime', $flags, $response); break; case NET_SFTP_ATTR_ACL: // 0x00000040 // access control list // see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-04#section-5.7 // currently unsupported list($count) = Strings::unpackSSH2('N', $response); for ($i = 0; $i < $count; $i++) { list($type, $flag, $mask, $who) = Strings::unpackSSH2('N3s', $result); } break; case NET_SFTP_ATTR_OWNERGROUP: // 0x00000080 list($attr['owner'], $attr['$group']) = Strings::unpackSSH2('ss', $response); break; case NET_SFTP_ATTR_SUBSECOND_TIMES: // 0x00000100 break; case NET_SFTP_ATTR_BITS: // 0x00000200 (SFTPv5+) // see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-05#section-5.8 // currently unsupported // tells if you file is: // readonly, system, hidden, case inensitive, archive, encrypted, compressed, sparse // append only, immutable, sync list($attrib_bits, $attrib_bits_valid) = Strings::unpackSSH2('N2', $response); // if we were actually gonna implement the above it ought to be // $attr['attrib-bits'] and $attr['attrib-bits-valid'] // eg. - instead of _ break; case NET_SFTP_ATTR_ALLOCATION_SIZE: // 0x00000400 (SFTPv6+) // see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.4 // represents the number of bytes that the file consumes on the disk. will // usually be larger than the 'size' field list($attr['allocation-size']) = Strings::unpackSSH2('Q', $response); break; case NET_SFTP_ATTR_TEXT_HINT: // 0x00000800 // https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.10 // currently unsupported // tells if file is "known text", "guessed text", "known binary", "guessed binary" list($text_hint) = Strings::unpackSSH2('C', $response); // the above should be $attr['text-hint'] break; case NET_SFTP_ATTR_MIME_TYPE: // 0x00001000 // see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.11 list($attr['mime-type']) = Strings::unpackSSH2('s', $response); break; case NET_SFTP_ATTR_LINK_COUNT: // 0x00002000 // see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.12 list($attr['link-count']) = Strings::unpackSSH2('N', $response); break; case NET_SFTP_ATTR_UNTRANSLATED_NAME:// 0x00004000 // see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.13 list($attr['untranslated-name']) = Strings::unpackSSH2('s', $response); break; case NET_SFTP_ATTR_CTIME: // 0x00008000 // 'ctime' contains the last time the file attributes were changed. The // exact meaning of this field depends on the server. $attr += $this->parseTime('ctime', $flags, $response); break; case NET_SFTP_ATTR_EXTENDED: // 0x80000000 list($count) = Strings::unpackSSH2('N', $response); for ($i = 0; $i < $count; $i++) { list($key, $value) = Strings::unpackSSH2('ss', $response); $attr[$key] = $value; } } } return $attr; } /** * Attempt to identify the file type * * Quoting the SFTP RFC, "Implementations MUST NOT send bits that are not defined" but they seem to anyway * * @param int $mode * @return int */ private function parseMode($mode) { // values come from http://lxr.free-electrons.com/source/include/uapi/linux/stat.h#L12 // see, also, http://linux.die.net/man/2/stat switch ($mode & 0170000) {// ie. 1111 0000 0000 0000 case 0000000: // no file type specified - figure out the file type using alternative means return false; case 0040000: return NET_SFTP_TYPE_DIRECTORY; case 0100000: return NET_SFTP_TYPE_REGULAR; case 0120000: return NET_SFTP_TYPE_SYMLINK; // new types introduced in SFTPv5+ // http://tools.ietf.org/html/draft-ietf-secsh-filexfer-05#section-5.2 case 0010000: // named pipe (fifo) return NET_SFTP_TYPE_FIFO; case 0020000: // character special return NET_SFTP_TYPE_CHAR_DEVICE; case 0060000: // block special return NET_SFTP_TYPE_BLOCK_DEVICE; case 0140000: // socket return NET_SFTP_TYPE_SOCKET; case 0160000: // whiteout // "SPECIAL should be used for files that are of // a known type which cannot be expressed in the protocol" return NET_SFTP_TYPE_SPECIAL; default: return NET_SFTP_TYPE_UNKNOWN; } } /** * Parse Longname * * SFTPv3 doesn't provide any easy way of identifying a file type. You could try to open * a file as a directory and see if an error is returned or you could try to parse the * SFTPv3-specific longname field of the SSH_FXP_NAME packet. That's what this function does. * The result is returned using the * {@link http://tools.ietf.org/html/draft-ietf-secsh-filexfer-04#section-5.2 SFTPv4 type constants}. * * If the longname is in an unrecognized format bool(false) is returned. * * @param string $longname * @return mixed */ private function parseLongname($longname) { // http://en.wikipedia.org/wiki/Unix_file_types // http://en.wikipedia.org/wiki/Filesystem_permissions#Notation_of_traditional_Unix_permissions if (preg_match('#^[^/]([r-][w-][xstST-]){3}#', $longname)) { switch ($longname[0]) { case '-': return NET_SFTP_TYPE_REGULAR; case 'd': return NET_SFTP_TYPE_DIRECTORY; case 'l': return NET_SFTP_TYPE_SYMLINK; default: return NET_SFTP_TYPE_SPECIAL; } } return false; } /** * Sends SFTP Packets * * See '6. General Packet Format' of draft-ietf-secsh-filexfer-13 for more info. * * @param int $type * @param string $data * @param int $request_id * @see self::_get_sftp_packet() * @see self::send_channel_packet() * @return void */ private function send_sftp_packet($type, $data, $request_id = 1) { // in SSH2.php the timeout is cumulative per function call. eg. exec() will // timeout after 10s. but for SFTP.php it's cumulative per packet $this->curTimeout = $this->timeout; $packet = $this->use_request_id ? pack('NCNa*', strlen($data) + 5, $type, $request_id, $data) : pack('NCa*', strlen($data) + 1, $type, $data); $start = microtime(true); $this->send_channel_packet(self::CHANNEL, $packet); $stop = microtime(true); if (defined('NET_SFTP_LOGGING')) { $packet_type = '-> ' . $this->packet_types[$type] . ' (' . round($stop - $start, 4) . 's)'; $this->append_log($packet_type, $data); } } /** * Resets a connection for re-use * * @param int $reason */ protected function reset_connection($reason) { parent::reset_connection($reason); $this->use_request_id = false; $this->pwd = false; $this->requestBuffer = []; } /** * Receives SFTP Packets * * See '6. General Packet Format' of draft-ietf-secsh-filexfer-13 for more info. * * Incidentally, the number of SSH_MSG_CHANNEL_DATA messages has no bearing on the number of SFTP packets present. * There can be one SSH_MSG_CHANNEL_DATA messages containing two SFTP packets or there can be two SSH_MSG_CHANNEL_DATA * messages containing one SFTP packet. * * @see self::_send_sftp_packet() * @return string */ private function get_sftp_packet($request_id = null) { $this->channel_close = false; if (isset($request_id) && isset($this->requestBuffer[$request_id])) { $this->packet_type = $this->requestBuffer[$request_id]['packet_type']; $temp = $this->requestBuffer[$request_id]['packet']; unset($this->requestBuffer[$request_id]); return $temp; } // in SSH2.php the timeout is cumulative per function call. eg. exec() will // timeout after 10s. but for SFTP.php it's cumulative per packet $this->curTimeout = $this->timeout; $start = microtime(true); // SFTP packet length while (strlen($this->packet_buffer) < 4) { $temp = $this->get_channel_packet(self::CHANNEL, true); if ($temp === true) { if ($this->channel_status[self::CHANNEL] === NET_SSH2_MSG_CHANNEL_CLOSE) { $this->channel_close = true; } $this->packet_type = false; $this->packet_buffer = ''; return false; } $this->packet_buffer .= $temp; } if (strlen($this->packet_buffer) < 4) { throw new \RuntimeException('Packet is too small'); } extract(unpack('Nlength', Strings::shift($this->packet_buffer, 4))); /** @var integer $length */ $tempLength = $length; $tempLength -= strlen($this->packet_buffer); // 256 * 1024 is what SFTP_MAX_MSG_LENGTH is set to in OpenSSH's sftp-common.h if (!$this->allow_arbitrary_length_packets && !$this->use_request_id && $tempLength > 256 * 1024) { throw new \RuntimeException('Invalid Size'); } // SFTP packet type and data payload while ($tempLength > 0) { $temp = $this->get_channel_packet(self::CHANNEL, true); if ($temp === true) { if ($this->channel_status[self::CHANNEL] === NET_SSH2_MSG_CHANNEL_CLOSE) { $this->channel_close = true; } $this->packet_type = false; $this->packet_buffer = ''; return false; } $this->packet_buffer .= $temp; $tempLength -= strlen($temp); } $stop = microtime(true); $this->packet_type = ord(Strings::shift($this->packet_buffer)); if ($this->use_request_id) { extract(unpack('Npacket_id', Strings::shift($this->packet_buffer, 4))); // remove the request id $length -= 5; // account for the request id and the packet type } else { $length -= 1; // account for the packet type } $packet = Strings::shift($this->packet_buffer, $length); if (defined('NET_SFTP_LOGGING')) { $packet_type = '<- ' . $this->packet_types[$this->packet_type] . ' (' . round($stop - $start, 4) . 's)'; $this->append_log($packet_type, $packet); } if (isset($request_id) && $this->use_request_id && $packet_id != $request_id) { $this->requestBuffer[$packet_id] = [ 'packet_type' => $this->packet_type, 'packet' => $packet ]; return $this->get_sftp_packet($request_id); } return $packet; } /** * Logs data packets * * Makes sure that only the last 1MB worth of packets will be logged * * @param string $message_number * @param string $message */ private function append_log($message_number, $message) { $this->append_log_helper( NET_SFTP_LOGGING, $message_number, $message, $this->packet_type_log, $this->packet_log, $this->log_size, $this->realtime_log_file, $this->realtime_log_wrap, $this->realtime_log_size ); } /** * Returns a log of the packets that have been sent and received. * * Returns a string if NET_SFTP_LOGGING == self::LOG_COMPLEX, an array if NET_SFTP_LOGGING == self::LOG_SIMPLE and false if !defined('NET_SFTP_LOGGING') * * @return array|string */ public function getSFTPLog() { if (!defined('NET_SFTP_LOGGING')) { return false; } switch (NET_SFTP_LOGGING) { case self::LOG_COMPLEX: return $this->format_log($this->packet_log, $this->packet_type_log); break; //case self::LOG_SIMPLE: default: return $this->packet_type_log; } } /** * Returns all errors * * @return array */ public function getSFTPErrors() { return $this->sftp_errors; } /** * Returns the last error * * @return string */ public function getLastSFTPError() { return count($this->sftp_errors) ? $this->sftp_errors[count($this->sftp_errors) - 1] : ''; } /** * Get supported SFTP versions * * @return array */ public function getSupportedVersions() { if (!($this->bitmap & SSH2::MASK_LOGIN)) { return false; } if (!$this->partial_init) { $this->partial_init_sftp_connection(); } $temp = ['version' => $this->defaultVersion]; if (isset($this->extensions['versions'])) { $temp['extensions'] = $this->extensions['versions']; } return $temp; } /** * Get supported SFTP versions * * @return int|false */ public function getNegotiatedVersion() { if (!$this->precheck()) { return false; } return $this->version; } /** * Set preferred version * * If you're preferred version isn't supported then the highest supported * version of SFTP will be utilized. Set to null or false or int(0) to * unset the preferred version * * @param int $version */ public function setPreferredVersion($version) { $this->preferredVersion = $version; } /** * Disconnect * * @param int $reason * @return false */ protected function disconnect_helper($reason) { $this->pwd = false; return parent::disconnect_helper($reason); } /** * Enable Date Preservation * */ public function enableDatePreservation() { $this->preserveTime = true; } /** * Disable Date Preservation * */ public function disableDatePreservation() { $this->preserveTime = false; } } * @copyright 2013 Jim Wigginton * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link http://phpseclib.sourceforge.net */ namespace phpseclib3\Net\SFTP; use phpseclib3\Crypt\Common\PrivateKey; use phpseclib3\Net\SFTP; use phpseclib3\Net\SSH2; /** * SFTP Stream Wrapper * * @author Jim Wigginton */ class Stream { /** * SFTP instances * * Rather than re-create the connection we re-use instances if possible * * @var array */ public static $instances; /** * SFTP instance * * @var object */ private $sftp; /** * Path * * @var string */ private $path; /** * Mode * * @var string */ private $mode; /** * Position * * @var int */ private $pos; /** * Size * * @var int */ private $size; /** * Directory entries * * @var array */ private $entries; /** * EOF flag * * @var bool */ private $eof; /** * Context resource * * Technically this needs to be publicly accessible so PHP can set it directly * * @var resource */ public $context; /** * Notification callback function * * @var callable */ private $notification; /** * Registers this class as a URL wrapper. * * @param string $protocol The wrapper name to be registered. * @return bool True on success, false otherwise. */ public static function register($protocol = 'sftp') { if (in_array($protocol, stream_get_wrappers(), true)) { return false; } return stream_wrapper_register($protocol, get_called_class()); } /** * The Constructor * */ public function __construct() { if (defined('NET_SFTP_STREAM_LOGGING')) { echo "__construct()\r\n"; } } /** * Path Parser * * Extract a path from a URI and actually connect to an SSH server if appropriate * * If "notification" is set as a context parameter the message code for successful login is * NET_SSH2_MSG_USERAUTH_SUCCESS. For a failed login it's NET_SSH2_MSG_USERAUTH_FAILURE. * * @param string $path * @return string */ protected function parse_path($path) { $orig = $path; extract(parse_url($path) + ['port' => 22]); if (isset($query)) { $path .= '?' . $query; } elseif (preg_match('/(\?|\?#)$/', $orig)) { $path .= '?'; } if (isset($fragment)) { $path .= '#' . $fragment; } elseif ($orig[strlen($orig) - 1] == '#') { $path .= '#'; } if (!isset($host)) { return false; } if (isset($this->context)) { $context = stream_context_get_params($this->context); if (isset($context['notification'])) { $this->notification = $context['notification']; } } if (preg_match('/^{[a-z0-9]+}$/i', $host)) { $host = SSH2::getConnectionByResourceId($host); if ($host === false) { return false; } $this->sftp = $host; } else { if (isset($this->context)) { $context = stream_context_get_options($this->context); } if (isset($context[$scheme]['session'])) { $sftp = $context[$scheme]['session']; } if (isset($context[$scheme]['sftp'])) { $sftp = $context[$scheme]['sftp']; } if (isset($sftp) && $sftp instanceof SFTP) { $this->sftp = $sftp; return $path; } if (isset($context[$scheme]['username'])) { $user = $context[$scheme]['username']; } if (isset($context[$scheme]['password'])) { $pass = $context[$scheme]['password']; } if (isset($context[$scheme]['privkey']) && $context[$scheme]['privkey'] instanceof PrivateKey) { $pass = $context[$scheme]['privkey']; } if (!isset($user) || !isset($pass)) { return false; } // casting $pass to a string is necessary in the event that it's a \phpseclib3\Crypt\RSA object if (isset(self::$instances[$host][$port][$user][(string) $pass])) { $this->sftp = self::$instances[$host][$port][$user][(string) $pass]; } else { $this->sftp = new SFTP($host, $port); $this->sftp->disableStatCache(); if (isset($this->notification) && is_callable($this->notification)) { /* if !is_callable($this->notification) we could do this: user_error('fopen(): failed to call user notifier', E_USER_WARNING); the ftp wrapper gives errors like that when the notifier isn't callable. i've opted not to do that, however, since the ftp wrapper gives the line on which the fopen occurred as the line number - not the line that the user_error is on. */ call_user_func($this->notification, STREAM_NOTIFY_CONNECT, STREAM_NOTIFY_SEVERITY_INFO, '', 0, 0, 0); call_user_func($this->notification, STREAM_NOTIFY_AUTH_REQUIRED, STREAM_NOTIFY_SEVERITY_INFO, '', 0, 0, 0); if (!$this->sftp->login($user, $pass)) { call_user_func($this->notification, STREAM_NOTIFY_AUTH_RESULT, STREAM_NOTIFY_SEVERITY_ERR, 'Login Failure', NET_SSH2_MSG_USERAUTH_FAILURE, 0, 0); return false; } call_user_func($this->notification, STREAM_NOTIFY_AUTH_RESULT, STREAM_NOTIFY_SEVERITY_INFO, 'Login Success', NET_SSH2_MSG_USERAUTH_SUCCESS, 0, 0); } else { if (!$this->sftp->login($user, $pass)) { return false; } } self::$instances[$host][$port][$user][(string) $pass] = $this->sftp; } } return $path; } /** * Opens file or URL * * @param string $path * @param string $mode * @param int $options * @param string $opened_path * @return bool */ private function _stream_open($path, $mode, $options, &$opened_path) { $path = $this->parse_path($path); if ($path === false) { return false; } $this->path = $path; $this->size = $this->sftp->filesize($path); $this->mode = preg_replace('#[bt]$#', '', $mode); $this->eof = false; if ($this->size === false) { if ($this->mode[0] == 'r') { return false; } else { $this->sftp->touch($path); $this->size = 0; } } else { switch ($this->mode[0]) { case 'x': return false; case 'w': $this->sftp->truncate($path, 0); $this->size = 0; } } $this->pos = $this->mode[0] != 'a' ? 0 : $this->size; return true; } /** * Read from stream * * @param int $count * @return mixed */ private function _stream_read($count) { switch ($this->mode) { case 'w': case 'a': case 'x': case 'c': return false; } // commented out because some files - eg. /dev/urandom - will say their size is 0 when in fact it's kinda infinite //if ($this->pos >= $this->size) { // $this->eof = true; // return false; //} $result = $this->sftp->get($this->path, false, $this->pos, $count); if (isset($this->notification) && is_callable($this->notification)) { if ($result === false) { call_user_func($this->notification, STREAM_NOTIFY_FAILURE, STREAM_NOTIFY_SEVERITY_ERR, $this->sftp->getLastSFTPError(), NET_SFTP_OPEN, 0, 0); return 0; } // seems that PHP calls stream_read in 8k chunks call_user_func($this->notification, STREAM_NOTIFY_PROGRESS, STREAM_NOTIFY_SEVERITY_INFO, '', 0, strlen($result), $this->size); } if (empty($result)) { // ie. false or empty string $this->eof = true; return false; } $this->pos += strlen($result); return $result; } /** * Write to stream * * @param string $data * @return int|false */ private function _stream_write($data) { switch ($this->mode) { case 'r': return false; } $result = $this->sftp->put($this->path, $data, SFTP::SOURCE_STRING, $this->pos); if (isset($this->notification) && is_callable($this->notification)) { if (!$result) { call_user_func($this->notification, STREAM_NOTIFY_FAILURE, STREAM_NOTIFY_SEVERITY_ERR, $this->sftp->getLastSFTPError(), NET_SFTP_OPEN, 0, 0); return 0; } // seems that PHP splits up strings into 8k blocks before calling stream_write call_user_func($this->notification, STREAM_NOTIFY_PROGRESS, STREAM_NOTIFY_SEVERITY_INFO, '', 0, strlen($data), strlen($data)); } if ($result === false) { return false; } $this->pos += strlen($data); if ($this->pos > $this->size) { $this->size = $this->pos; } $this->eof = false; return strlen($data); } /** * Retrieve the current position of a stream * * @return int */ private function _stream_tell() { return $this->pos; } /** * Tests for end-of-file on a file pointer * * In my testing there are four classes functions that normally effect the pointer: * fseek, fputs / fwrite, fgets / fread and ftruncate. * * Only fgets / fread, however, results in feof() returning true. do fputs($fp, 'aaa') on a blank file and feof() * will return false. do fread($fp, 1) and feof() will then return true. do fseek($fp, 10) on ablank file and feof() * will return false. do fread($fp, 1) and feof() will then return true. * * @return bool */ private function _stream_eof() { return $this->eof; } /** * Seeks to specific location in a stream * * @param int $offset * @param int $whence * @return bool */ private function _stream_seek($offset, $whence) { switch ($whence) { case SEEK_SET: if ($offset < 0) { return false; } break; case SEEK_CUR: $offset += $this->pos; break; case SEEK_END: $offset += $this->size; } $this->pos = $offset; $this->eof = false; return true; } /** * Change stream options * * @param string $path * @param int $option * @param mixed $var * @return bool */ private function _stream_metadata($path, $option, $var) { $path = $this->parse_path($path); if ($path === false) { return false; } // stream_metadata was introduced in PHP 5.4.0 but as of 5.4.11 the constants haven't been defined // see http://www.php.net/streamwrapper.stream-metadata and https://bugs.php.net/64246 // and https://github.com/php/php-src/blob/master/main/php_streams.h#L592 switch ($option) { case 1: // PHP_STREAM_META_TOUCH $time = isset($var[0]) ? $var[0] : null; $atime = isset($var[1]) ? $var[1] : null; return $this->sftp->touch($path, $time, $atime); case 2: // PHP_STREAM_OWNER_NAME case 3: // PHP_STREAM_GROUP_NAME return false; case 4: // PHP_STREAM_META_OWNER return $this->sftp->chown($path, $var); case 5: // PHP_STREAM_META_GROUP return $this->sftp->chgrp($path, $var); case 6: // PHP_STREAM_META_ACCESS return $this->sftp->chmod($path, $var) !== false; } } /** * Retrieve the underlaying resource * * @param int $cast_as * @return resource */ private function _stream_cast($cast_as) { return $this->sftp->fsock; } /** * Advisory file locking * * @param int $operation * @return bool */ private function _stream_lock($operation) { return false; } /** * Renames a file or directory * * Attempts to rename oldname to newname, moving it between directories if necessary. * If newname exists, it will be overwritten. This is a departure from what \phpseclib3\Net\SFTP * does. * * @param string $path_from * @param string $path_to * @return bool */ private function _rename($path_from, $path_to) { $path1 = parse_url($path_from); $path2 = parse_url($path_to); unset($path1['path'], $path2['path']); if ($path1 != $path2) { return false; } $path_from = $this->parse_path($path_from); $path_to = parse_url($path_to); if ($path_from === false) { return false; } $path_to = $path_to['path']; // the $component part of parse_url() was added in PHP 5.1.2 // "It is an error if there already exists a file with the name specified by newpath." // -- http://tools.ietf.org/html/draft-ietf-secsh-filexfer-02#section-6.5 if (!$this->sftp->rename($path_from, $path_to)) { if ($this->sftp->stat($path_to)) { return $this->sftp->delete($path_to, true) && $this->sftp->rename($path_from, $path_to); } return false; } return true; } /** * Open directory handle * * The only $options is "whether or not to enforce safe_mode (0x04)". Since safe mode was deprecated in 5.3 and * removed in 5.4 I'm just going to ignore it. * * Also, nlist() is the best that this function is realistically going to be able to do. When an SFTP client * sends a SSH_FXP_READDIR packet you don't generally get info on just one file but on multiple files. Quoting * the SFTP specs: * * The SSH_FXP_NAME response has the following format: * * uint32 id * uint32 count * repeats count times: * string filename * string longname * ATTRS attrs * * @param string $path * @param int $options * @return bool */ private function _dir_opendir($path, $options) { $path = $this->parse_path($path); if ($path === false) { return false; } $this->pos = 0; $this->entries = $this->sftp->nlist($path); return $this->entries !== false; } /** * Read entry from directory handle * * @return mixed */ private function _dir_readdir() { if (isset($this->entries[$this->pos])) { return $this->entries[$this->pos++]; } return false; } /** * Rewind directory handle * * @return bool */ private function _dir_rewinddir() { $this->pos = 0; return true; } /** * Close directory handle * * @return bool */ private function _dir_closedir() { return true; } /** * Create a directory * * Only valid $options is STREAM_MKDIR_RECURSIVE * * @param string $path * @param int $mode * @param int $options * @return bool */ private function _mkdir($path, $mode, $options) { $path = $this->parse_path($path); if ($path === false) { return false; } return $this->sftp->mkdir($path, $mode, $options & STREAM_MKDIR_RECURSIVE); } /** * Removes a directory * * Only valid $options is STREAM_MKDIR_RECURSIVE per , however, * does not have a $recursive parameter as mkdir() does so I don't know how * STREAM_MKDIR_RECURSIVE is supposed to be set. Also, when I try it out with rmdir() I get 8 as * $options. What does 8 correspond to? * * @param string $path * @param int $options * @return bool */ private function _rmdir($path, $options) { $path = $this->parse_path($path); if ($path === false) { return false; } return $this->sftp->rmdir($path); } /** * Flushes the output * * See . Always returns true because \phpseclib3\Net\SFTP doesn't cache stuff before writing * * @return bool */ private function _stream_flush() { return true; } /** * Retrieve information about a file resource * * @return mixed */ private function _stream_stat() { $results = $this->sftp->stat($this->path); if ($results === false) { return false; } return $results; } /** * Delete a file * * @param string $path * @return bool */ private function _unlink($path) { $path = $this->parse_path($path); if ($path === false) { return false; } return $this->sftp->delete($path, false); } /** * Retrieve information about a file * * Ignores the STREAM_URL_STAT_QUIET flag because the entirety of \phpseclib3\Net\SFTP\Stream is quiet by default * might be worthwhile to reconstruct bits 12-16 (ie. the file type) if mode doesn't have them but we'll * cross that bridge when and if it's reached * * @param string $path * @param int $flags * @return mixed */ private function _url_stat($path, $flags) { $path = $this->parse_path($path); if ($path === false) { return false; } $results = $flags & STREAM_URL_STAT_LINK ? $this->sftp->lstat($path) : $this->sftp->stat($path); if ($results === false) { return false; } return $results; } /** * Truncate stream * * @param int $new_size * @return bool */ private function _stream_truncate($new_size) { if (!$this->sftp->truncate($this->path, $new_size)) { return false; } $this->eof = false; $this->size = $new_size; return true; } /** * Change stream options * * STREAM_OPTION_WRITE_BUFFER isn't supported for the same reason stream_flush isn't. * The other two aren't supported because of limitations in \phpseclib3\Net\SFTP. * * @param int $option * @param int $arg1 * @param int $arg2 * @return bool */ private function _stream_set_option($option, $arg1, $arg2) { return false; } /** * Close an resource * */ private function _stream_close() { } /** * __call Magic Method * * When you're utilizing an SFTP stream you're not calling the methods in this class directly - PHP is calling them for you. * Which kinda begs the question... what methods is PHP calling and what parameters is it passing to them? This function * lets you figure that out. * * If NET_SFTP_STREAM_LOGGING is defined all calls will be output on the screen and then (regardless of whether or not * NET_SFTP_STREAM_LOGGING is enabled) the parameters will be passed through to the appropriate method. * * @param string $name * @param array $arguments * @return mixed */ public function __call($name, array $arguments) { if (defined('NET_SFTP_STREAM_LOGGING')) { echo $name . '('; $last = count($arguments) - 1; foreach ($arguments as $i => $argument) { var_export($argument); if ($i != $last) { echo ','; } } echo ")\r\n"; } $name = '_' . $name; if (!method_exists($this, $name)) { return false; } return $this->$name(...$arguments); } } { "name": "phpseclib/phpseclib", "type": "library", "description": "PHP Secure Communications Library - Pure-PHP implementations of RSA, AES, SSH2, SFTP, X.509 etc.", "keywords": [ "security", "crypto", "cryptography", "encryption", "signature", "signing", "rsa", "aes", "blowfish", "twofish", "ssh", "sftp", "x509", "x.509", "asn1", "asn.1", "BigInteger" ], "homepage": "http://phpseclib.sourceforge.net", "license": "MIT", "authors": [ { "name": "Jim Wigginton", "email": "terrafrost@php.net", "role": "Lead Developer" }, { "name": "Patrick Monnerat", "email": "pm@datasphere.ch", "role": "Developer" }, { "name": "Andreas Fischer", "email": "bantu@phpbb.com", "role": "Developer" }, { "name": "Hans-Jürgen Petrich", "email": "petrich@tronic-media.com", "role": "Developer" }, { "name": "Graham Campbell", "email": "graham@alt-three.com", "role": "Developer" } ], "require": { "php": ">=5.6.1", "paragonie/constant_time_encoding": "^1|^2", "paragonie/random_compat": "^1.4|^2.0|^9.99.99" }, "require-dev": { "phpunit/phpunit": "*" }, "suggest": { "ext-libsodium": "SSH2/SFTP can make use of some algorithms provided by the libsodium-php extension.", "ext-openssl": "Install the OpenSSL extension in order to speed up a wide variety of cryptographic operations.", "ext-mcrypt": "Install the Mcrypt extension in order to speed up a few other cryptographic operations.", "ext-gmp": "Install the GMP (GNU Multiple Precision) extension in order to speed up arbitrary precision integer arithmetic operations.", "ext-dom": "Install the DOM extension to load XML formatted public keys." }, "autoload": { "files": [ "phpseclib/bootstrap.php" ], "psr-4": { "phpseclib3\\": "phpseclib/" } }, "autoload-dev": { "psr-4": { "phpseclib3\\Tests\\": "tests/" } }, "config": { "sort-packages": true } } { "name": "cash/lrucache", "type": "library", "description": "An efficient memory-based Least Recently Used (LRU) cache", "keywords": ["cache", "lru"], "homepage": "https://github.com/cash/LRUCache", "license": "MIT", "authors": [ { "name": "Cash Costello", "email": "cash.costello@gmail.com" } ], "minimum-stability": "stable", "require": { "php": ">=5.3.0" }, "autoload": { "psr-0": { "cash": "src/" } } } maximumSize = $size; } /** * Get the value cached with this key * * @param int|string $key The key. Strings that are ints are cast to ints. * @param mixed $default The value to be returned if key not found. (Optional) * @return mixed */ public function get($key, $default = null) { if (isset($this->data[$key])) { $this->recordAccess($key); return $this->data[$key]; } else { return $default; } } /** * Put something in the cache * * @param int|string $key The key. Strings that are ints are cast to ints. * @param mixed $value The value to cache */ public function put($key, $value) { if (isset($this->data[$key])) { $this->data[$key] = $value; $this->recordAccess($key); } else { $this->data[$key] = $value; if ($this->size() > $this->maximumSize) { // remove least recently used element (front of array) reset($this->data); unset($this->data[key($this->data)]); } } } /** * Get the number of elements in the cache * * @return int */ public function size() { return count($this->data); } /** * Does the cache contain an element with this key * * @param int|string $key The key * @return boolean */ public function containsKey($key) { return isset($this->data[$key]); } /** * Remove the element with this key. * * @param int|string $key The key * @return mixed Value or null if not set */ public function remove($key) { if (isset($this->data[$key])) { $value = $this->data[$key]; unset($this->data[$key]); return $value; } else { return null; } } /** * Clear the cache */ public function clear() { $this->data = array(); } /** * Moves the element from current position to end of array * * @param int|string $key The key */ protected function recordAccess($key) { $value = $this->data[$key]; unset($this->data[$key]); $this->data[$key] = $value; } }{ "name": "webmozart/assert", "description": "Assertions to validate method input/output with nice error messages.", "license": "MIT", "keywords": [ "assert", "check", "validate" ], "authors": [ { "name": "Bernhard Schussek", "email": "bschussek@gmail.com" } ], "require": { "php": "^7.2 || ^8.0", "ext-ctype": "*" }, "require-dev": { "phpunit/phpunit": "^8.5.13" }, "conflict": { "phpstan/phpstan": "<0.12.20", "vimeo/psalm": "<4.6.1 || 4.6.2" }, "autoload": { "psr-4": { "Webmozart\\Assert\\": "src/" } }, "autoload-dev": { "psr-4": { "Webmozart\\Assert\\Tests\\": "tests/", "Webmozart\\Assert\\Bin\\": "bin/src" } }, "extra": { "branch-alias": { "dev-master": "1.10-dev" } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Webmozart\Assert; class InvalidArgumentException extends \InvalidArgumentException { } $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allString($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::string($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrString($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::string($entry, $message); } } /** * @psalm-pure * @psalm-assert non-empty-string|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrStringNotEmpty($value, $message = '') { null === $value || static::stringNotEmpty($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allStringNotEmpty($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::stringNotEmpty($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrStringNotEmpty($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::stringNotEmpty($entry, $message); } } /** * @psalm-pure * @psalm-assert int|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrInteger($value, $message = '') { null === $value || static::integer($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allInteger($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::integer($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrInteger($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::integer($entry, $message); } } /** * @psalm-pure * @psalm-assert numeric|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIntegerish($value, $message = '') { null === $value || static::integerish($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIntegerish($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::integerish($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIntegerish($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::integerish($entry, $message); } } /** * @psalm-pure * @psalm-assert positive-int|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrPositiveInteger($value, $message = '') { null === $value || static::positiveInteger($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allPositiveInteger($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::positiveInteger($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrPositiveInteger($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::positiveInteger($entry, $message); } } /** * @psalm-pure * @psalm-assert float|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrFloat($value, $message = '') { null === $value || static::float($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allFloat($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::float($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrFloat($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::float($entry, $message); } } /** * @psalm-pure * @psalm-assert numeric|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNumeric($value, $message = '') { null === $value || static::numeric($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNumeric($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::numeric($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNumeric($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::numeric($entry, $message); } } /** * @psalm-pure * @psalm-assert positive-int|0|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNatural($value, $message = '') { null === $value || static::natural($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNatural($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::natural($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNatural($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::natural($entry, $message); } } /** * @psalm-pure * @psalm-assert bool|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrBoolean($value, $message = '') { null === $value || static::boolean($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allBoolean($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::boolean($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrBoolean($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::boolean($entry, $message); } } /** * @psalm-pure * @psalm-assert scalar|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrScalar($value, $message = '') { null === $value || static::scalar($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allScalar($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::scalar($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrScalar($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::scalar($entry, $message); } } /** * @psalm-pure * @psalm-assert object|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrObject($value, $message = '') { null === $value || static::object($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allObject($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::object($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrObject($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::object($entry, $message); } } /** * @psalm-pure * @psalm-assert resource|null $value * * @param mixed $value * @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrResource($value, $type = null, $message = '') { null === $value || static::resource($value, $type, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allResource($value, $type = null, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::resource($entry, $type, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrResource($value, $type = null, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::resource($entry, $type, $message); } } /** * @psalm-pure * @psalm-assert callable|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsCallable($value, $message = '') { null === $value || static::isCallable($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsCallable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isCallable($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsCallable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isCallable($entry, $message); } } /** * @psalm-pure * @psalm-assert array|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsArray($value, $message = '') { null === $value || static::isArray($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsArray($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isArray($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsArray($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isArray($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable|null $value * * @deprecated use "isIterable" or "isInstanceOf" instead * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsTraversable($value, $message = '') { null === $value || static::isTraversable($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @deprecated use "isIterable" or "isInstanceOf" instead * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsTraversable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isTraversable($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @deprecated use "isIterable" or "isInstanceOf" instead * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsTraversable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isTraversable($entry, $message); } } /** * @psalm-pure * @psalm-assert array|ArrayAccess|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsArrayAccessible($value, $message = '') { null === $value || static::isArrayAccessible($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsArrayAccessible($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isArrayAccessible($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsArrayAccessible($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isArrayAccessible($entry, $message); } } /** * @psalm-pure * @psalm-assert countable|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsCountable($value, $message = '') { null === $value || static::isCountable($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsCountable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isCountable($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsCountable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isCountable($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsIterable($value, $message = '') { null === $value || static::isIterable($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsIterable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isIterable($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsIterable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isIterable($entry, $message); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert ExpectedType|null $value * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsInstanceOf($value, $class, $message = '') { null === $value || static::isInstanceOf($value, $class, $message); } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert iterable $value * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsInstanceOf($value, $class, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isInstanceOf($entry, $class, $message); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert iterable $value * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsInstanceOf($value, $class, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isInstanceOf($entry, $class, $message); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNotInstanceOf($value, $class, $message = '') { null === $value || static::notInstanceOf($value, $class, $message); } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNotInstanceOf($value, $class, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::notInstanceOf($entry, $class, $message); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert iterable $value * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNotInstanceOf($value, $class, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::notInstanceOf($entry, $class, $message); } } /** * @psalm-pure * @psalm-param array $classes * * @param mixed $value * @param array $classes * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsInstanceOfAny($value, $classes, $message = '') { null === $value || static::isInstanceOfAny($value, $classes, $message); } /** * @psalm-pure * @psalm-param array $classes * * @param mixed $value * @param array $classes * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsInstanceOfAny($value, $classes, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isInstanceOfAny($entry, $classes, $message); } } /** * @psalm-pure * @psalm-param array $classes * * @param mixed $value * @param array $classes * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsInstanceOfAny($value, $classes, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isInstanceOfAny($entry, $classes, $message); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert ExpectedType|class-string|null $value * * @param object|string|null $value * @param string $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsAOf($value, $class, $message = '') { null === $value || static::isAOf($value, $class, $message); } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert iterable> $value * * @param iterable $value * @param string $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsAOf($value, $class, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isAOf($entry, $class, $message); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert iterable|null> $value * * @param iterable $value * @param string $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsAOf($value, $class, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isAOf($entry, $class, $message); } } /** * @psalm-pure * @psalm-template UnexpectedType of object * @psalm-param class-string $class * * @param object|string|null $value * @param string $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsNotA($value, $class, $message = '') { null === $value || static::isNotA($value, $class, $message); } /** * @psalm-pure * @psalm-template UnexpectedType of object * @psalm-param class-string $class * * @param iterable $value * @param string $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsNotA($value, $class, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isNotA($entry, $class, $message); } } /** * @psalm-pure * @psalm-template UnexpectedType of object * @psalm-param class-string $class * @psalm-assert iterable $value * @psalm-assert iterable|null> $value * * @param iterable $value * @param string $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsNotA($value, $class, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isNotA($entry, $class, $message); } } /** * @psalm-pure * @psalm-param array $classes * * @param object|string|null $value * @param string[] $classes * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsAnyOf($value, $classes, $message = '') { null === $value || static::isAnyOf($value, $classes, $message); } /** * @psalm-pure * @psalm-param array $classes * * @param iterable $value * @param string[] $classes * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsAnyOf($value, $classes, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isAnyOf($entry, $classes, $message); } } /** * @psalm-pure * @psalm-param array $classes * * @param iterable $value * @param string[] $classes * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsAnyOf($value, $classes, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isAnyOf($entry, $classes, $message); } } /** * @psalm-pure * @psalm-assert empty $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsEmpty($value, $message = '') { null === $value || static::isEmpty($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsEmpty($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::isEmpty($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsEmpty($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::isEmpty($entry, $message); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNotEmpty($value, $message = '') { null === $value || static::notEmpty($value, $message); } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNotEmpty($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::notEmpty($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNotEmpty($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::notEmpty($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNull($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::null($entry, $message); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNotNull($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::notNull($entry, $message); } } /** * @psalm-pure * @psalm-assert true|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrTrue($value, $message = '') { null === $value || static::true($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allTrue($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::true($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrTrue($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::true($entry, $message); } } /** * @psalm-pure * @psalm-assert false|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrFalse($value, $message = '') { null === $value || static::false($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allFalse($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::false($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrFalse($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::false($entry, $message); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNotFalse($value, $message = '') { null === $value || static::notFalse($value, $message); } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNotFalse($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::notFalse($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNotFalse($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::notFalse($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIp($value, $message = '') { null === $value || static::ip($value, $message); } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIp($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::ip($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIp($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::ip($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIpv4($value, $message = '') { null === $value || static::ipv4($value, $message); } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIpv4($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::ipv4($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIpv4($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::ipv4($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIpv6($value, $message = '') { null === $value || static::ipv6($value, $message); } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIpv6($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::ipv6($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIpv6($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::ipv6($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrEmail($value, $message = '') { null === $value || static::email($value, $message); } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allEmail($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::email($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrEmail($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::email($entry, $message); } } /** * @param array|null $values * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrUniqueValues($values, $message = '') { null === $values || static::uniqueValues($values, $message); } /** * @param iterable $values * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allUniqueValues($values, $message = '') { static::isIterable($values); foreach ($values as $entry) { static::uniqueValues($entry, $message); } } /** * @param iterable $values * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrUniqueValues($values, $message = '') { static::isIterable($values); foreach ($values as $entry) { null === $entry || static::uniqueValues($entry, $message); } } /** * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrEq($value, $expect, $message = '') { null === $value || static::eq($value, $expect, $message); } /** * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allEq($value, $expect, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::eq($entry, $expect, $message); } } /** * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrEq($value, $expect, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::eq($entry, $expect, $message); } } /** * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNotEq($value, $expect, $message = '') { null === $value || static::notEq($value, $expect, $message); } /** * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNotEq($value, $expect, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::notEq($entry, $expect, $message); } } /** * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNotEq($value, $expect, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::notEq($entry, $expect, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrSame($value, $expect, $message = '') { null === $value || static::same($value, $expect, $message); } /** * @psalm-pure * * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allSame($value, $expect, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::same($entry, $expect, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrSame($value, $expect, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::same($entry, $expect, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNotSame($value, $expect, $message = '') { null === $value || static::notSame($value, $expect, $message); } /** * @psalm-pure * * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNotSame($value, $expect, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::notSame($entry, $expect, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNotSame($value, $expect, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::notSame($entry, $expect, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrGreaterThan($value, $limit, $message = '') { null === $value || static::greaterThan($value, $limit, $message); } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allGreaterThan($value, $limit, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::greaterThan($entry, $limit, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrGreaterThan($value, $limit, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::greaterThan($entry, $limit, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrGreaterThanEq($value, $limit, $message = '') { null === $value || static::greaterThanEq($value, $limit, $message); } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allGreaterThanEq($value, $limit, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::greaterThanEq($entry, $limit, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrGreaterThanEq($value, $limit, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::greaterThanEq($entry, $limit, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrLessThan($value, $limit, $message = '') { null === $value || static::lessThan($value, $limit, $message); } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allLessThan($value, $limit, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::lessThan($entry, $limit, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrLessThan($value, $limit, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::lessThan($entry, $limit, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrLessThanEq($value, $limit, $message = '') { null === $value || static::lessThanEq($value, $limit, $message); } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allLessThanEq($value, $limit, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::lessThanEq($entry, $limit, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrLessThanEq($value, $limit, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::lessThanEq($entry, $limit, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $min * @param mixed $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrRange($value, $min, $max, $message = '') { null === $value || static::range($value, $min, $max, $message); } /** * @psalm-pure * * @param mixed $value * @param mixed $min * @param mixed $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allRange($value, $min, $max, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::range($entry, $min, $max, $message); } } /** * @psalm-pure * * @param mixed $value * @param mixed $min * @param mixed $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrRange($value, $min, $max, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::range($entry, $min, $max, $message); } } /** * @psalm-pure * * @param mixed $value * @param array $values * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrOneOf($value, $values, $message = '') { null === $value || static::oneOf($value, $values, $message); } /** * @psalm-pure * * @param mixed $value * @param array $values * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allOneOf($value, $values, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::oneOf($entry, $values, $message); } } /** * @psalm-pure * * @param mixed $value * @param array $values * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrOneOf($value, $values, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::oneOf($entry, $values, $message); } } /** * @psalm-pure * * @param mixed $value * @param array $values * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrInArray($value, $values, $message = '') { null === $value || static::inArray($value, $values, $message); } /** * @psalm-pure * * @param mixed $value * @param array $values * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allInArray($value, $values, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::inArray($entry, $values, $message); } } /** * @psalm-pure * * @param mixed $value * @param array $values * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrInArray($value, $values, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::inArray($entry, $values, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $subString * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrContains($value, $subString, $message = '') { null === $value || static::contains($value, $subString, $message); } /** * @psalm-pure * * @param iterable $value * @param string $subString * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allContains($value, $subString, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::contains($entry, $subString, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $subString * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrContains($value, $subString, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::contains($entry, $subString, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $subString * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNotContains($value, $subString, $message = '') { null === $value || static::notContains($value, $subString, $message); } /** * @psalm-pure * * @param iterable $value * @param string $subString * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNotContains($value, $subString, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::notContains($entry, $subString, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $subString * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNotContains($value, $subString, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::notContains($entry, $subString, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNotWhitespaceOnly($value, $message = '') { null === $value || static::notWhitespaceOnly($value, $message); } /** * @psalm-pure * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNotWhitespaceOnly($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::notWhitespaceOnly($entry, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNotWhitespaceOnly($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::notWhitespaceOnly($entry, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $prefix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrStartsWith($value, $prefix, $message = '') { null === $value || static::startsWith($value, $prefix, $message); } /** * @psalm-pure * * @param iterable $value * @param string $prefix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allStartsWith($value, $prefix, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::startsWith($entry, $prefix, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $prefix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrStartsWith($value, $prefix, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::startsWith($entry, $prefix, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $prefix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNotStartsWith($value, $prefix, $message = '') { null === $value || static::notStartsWith($value, $prefix, $message); } /** * @psalm-pure * * @param iterable $value * @param string $prefix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNotStartsWith($value, $prefix, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::notStartsWith($entry, $prefix, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $prefix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNotStartsWith($value, $prefix, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::notStartsWith($entry, $prefix, $message); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrStartsWithLetter($value, $message = '') { null === $value || static::startsWithLetter($value, $message); } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allStartsWithLetter($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::startsWithLetter($entry, $message); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrStartsWithLetter($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::startsWithLetter($entry, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $suffix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrEndsWith($value, $suffix, $message = '') { null === $value || static::endsWith($value, $suffix, $message); } /** * @psalm-pure * * @param iterable $value * @param string $suffix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allEndsWith($value, $suffix, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::endsWith($entry, $suffix, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $suffix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrEndsWith($value, $suffix, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::endsWith($entry, $suffix, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $suffix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNotEndsWith($value, $suffix, $message = '') { null === $value || static::notEndsWith($value, $suffix, $message); } /** * @psalm-pure * * @param iterable $value * @param string $suffix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNotEndsWith($value, $suffix, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::notEndsWith($entry, $suffix, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $suffix * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNotEndsWith($value, $suffix, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::notEndsWith($entry, $suffix, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $pattern * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrRegex($value, $pattern, $message = '') { null === $value || static::regex($value, $pattern, $message); } /** * @psalm-pure * * @param iterable $value * @param string $pattern * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allRegex($value, $pattern, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::regex($entry, $pattern, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $pattern * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrRegex($value, $pattern, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::regex($entry, $pattern, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $pattern * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrNotRegex($value, $pattern, $message = '') { null === $value || static::notRegex($value, $pattern, $message); } /** * @psalm-pure * * @param iterable $value * @param string $pattern * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNotRegex($value, $pattern, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::notRegex($entry, $pattern, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $pattern * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrNotRegex($value, $pattern, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::notRegex($entry, $pattern, $message); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrUnicodeLetters($value, $message = '') { null === $value || static::unicodeLetters($value, $message); } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allUnicodeLetters($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::unicodeLetters($entry, $message); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrUnicodeLetters($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::unicodeLetters($entry, $message); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrAlpha($value, $message = '') { null === $value || static::alpha($value, $message); } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allAlpha($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::alpha($entry, $message); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrAlpha($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::alpha($entry, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrDigits($value, $message = '') { null === $value || static::digits($value, $message); } /** * @psalm-pure * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allDigits($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::digits($entry, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrDigits($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::digits($entry, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrAlnum($value, $message = '') { null === $value || static::alnum($value, $message); } /** * @psalm-pure * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allAlnum($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::alnum($entry, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrAlnum($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::alnum($entry, $message); } } /** * @psalm-pure * @psalm-assert lowercase-string|null $value * * @param string|null $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrLower($value, $message = '') { null === $value || static::lower($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allLower($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::lower($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrLower($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::lower($entry, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrUpper($value, $message = '') { null === $value || static::upper($value, $message); } /** * @psalm-pure * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allUpper($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::upper($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrUpper($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::upper($entry, $message); } } /** * @psalm-pure * * @param string|null $value * @param int $length * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrLength($value, $length, $message = '') { null === $value || static::length($value, $length, $message); } /** * @psalm-pure * * @param iterable $value * @param int $length * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allLength($value, $length, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::length($entry, $length, $message); } } /** * @psalm-pure * * @param iterable $value * @param int $length * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrLength($value, $length, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::length($entry, $length, $message); } } /** * @psalm-pure * * @param string|null $value * @param int|float $min * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrMinLength($value, $min, $message = '') { null === $value || static::minLength($value, $min, $message); } /** * @psalm-pure * * @param iterable $value * @param int|float $min * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allMinLength($value, $min, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::minLength($entry, $min, $message); } } /** * @psalm-pure * * @param iterable $value * @param int|float $min * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrMinLength($value, $min, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::minLength($entry, $min, $message); } } /** * @psalm-pure * * @param string|null $value * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrMaxLength($value, $max, $message = '') { null === $value || static::maxLength($value, $max, $message); } /** * @psalm-pure * * @param iterable $value * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allMaxLength($value, $max, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::maxLength($entry, $max, $message); } } /** * @psalm-pure * * @param iterable $value * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrMaxLength($value, $max, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::maxLength($entry, $max, $message); } } /** * @psalm-pure * * @param string|null $value * @param int|float $min * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrLengthBetween($value, $min, $max, $message = '') { null === $value || static::lengthBetween($value, $min, $max, $message); } /** * @psalm-pure * * @param iterable $value * @param int|float $min * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allLengthBetween($value, $min, $max, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::lengthBetween($entry, $min, $max, $message); } } /** * @psalm-pure * * @param iterable $value * @param int|float $min * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrLengthBetween($value, $min, $max, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::lengthBetween($entry, $min, $max, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrFileExists($value, $message = '') { null === $value || static::fileExists($value, $message); } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allFileExists($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::fileExists($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrFileExists($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::fileExists($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrFile($value, $message = '') { null === $value || static::file($value, $message); } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allFile($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::file($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrFile($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::file($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrDirectory($value, $message = '') { null === $value || static::directory($value, $message); } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allDirectory($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::directory($entry, $message); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrDirectory($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::directory($entry, $message); } } /** * @param string|null $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrReadable($value, $message = '') { null === $value || static::readable($value, $message); } /** * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allReadable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::readable($entry, $message); } } /** * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrReadable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::readable($entry, $message); } } /** * @param string|null $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrWritable($value, $message = '') { null === $value || static::writable($value, $message); } /** * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allWritable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::writable($entry, $message); } } /** * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrWritable($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::writable($entry, $message); } } /** * @psalm-assert class-string|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrClassExists($value, $message = '') { null === $value || static::classExists($value, $message); } /** * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allClassExists($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::classExists($entry, $message); } } /** * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrClassExists($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::classExists($entry, $message); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert class-string|ExpectedType|null $value * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrSubclassOf($value, $class, $message = '') { null === $value || static::subclassOf($value, $class, $message); } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert iterable|ExpectedType> $value * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allSubclassOf($value, $class, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::subclassOf($entry, $class, $message); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert iterable|ExpectedType|null> $value * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrSubclassOf($value, $class, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::subclassOf($entry, $class, $message); } } /** * @psalm-assert class-string|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrInterfaceExists($value, $message = '') { null === $value || static::interfaceExists($value, $message); } /** * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allInterfaceExists($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::interfaceExists($entry, $message); } } /** * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrInterfaceExists($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::interfaceExists($entry, $message); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $interface * @psalm-assert class-string|null $value * * @param mixed $value * @param mixed $interface * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrImplementsInterface($value, $interface, $message = '') { null === $value || static::implementsInterface($value, $interface, $message); } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $interface * @psalm-assert iterable> $value * * @param mixed $value * @param mixed $interface * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allImplementsInterface($value, $interface, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::implementsInterface($entry, $interface, $message); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $interface * @psalm-assert iterable|null> $value * * @param mixed $value * @param mixed $interface * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrImplementsInterface($value, $interface, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::implementsInterface($entry, $interface, $message); } } /** * @psalm-pure * @psalm-param class-string|object|null $classOrObject * * @param string|object|null $classOrObject * @param mixed $property * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrPropertyExists($classOrObject, $property, $message = '') { null === $classOrObject || static::propertyExists($classOrObject, $property, $message); } /** * @psalm-pure * @psalm-param iterable $classOrObject * * @param iterable $classOrObject * @param mixed $property * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allPropertyExists($classOrObject, $property, $message = '') { static::isIterable($classOrObject); foreach ($classOrObject as $entry) { static::propertyExists($entry, $property, $message); } } /** * @psalm-pure * @psalm-param iterable $classOrObject * * @param iterable $classOrObject * @param mixed $property * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrPropertyExists($classOrObject, $property, $message = '') { static::isIterable($classOrObject); foreach ($classOrObject as $entry) { null === $entry || static::propertyExists($entry, $property, $message); } } /** * @psalm-pure * @psalm-param class-string|object|null $classOrObject * * @param string|object|null $classOrObject * @param mixed $property * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrPropertyNotExists($classOrObject, $property, $message = '') { null === $classOrObject || static::propertyNotExists($classOrObject, $property, $message); } /** * @psalm-pure * @psalm-param iterable $classOrObject * * @param iterable $classOrObject * @param mixed $property * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allPropertyNotExists($classOrObject, $property, $message = '') { static::isIterable($classOrObject); foreach ($classOrObject as $entry) { static::propertyNotExists($entry, $property, $message); } } /** * @psalm-pure * @psalm-param iterable $classOrObject * * @param iterable $classOrObject * @param mixed $property * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrPropertyNotExists($classOrObject, $property, $message = '') { static::isIterable($classOrObject); foreach ($classOrObject as $entry) { null === $entry || static::propertyNotExists($entry, $property, $message); } } /** * @psalm-pure * @psalm-param class-string|object|null $classOrObject * * @param string|object|null $classOrObject * @param mixed $method * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrMethodExists($classOrObject, $method, $message = '') { null === $classOrObject || static::methodExists($classOrObject, $method, $message); } /** * @psalm-pure * @psalm-param iterable $classOrObject * * @param iterable $classOrObject * @param mixed $method * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allMethodExists($classOrObject, $method, $message = '') { static::isIterable($classOrObject); foreach ($classOrObject as $entry) { static::methodExists($entry, $method, $message); } } /** * @psalm-pure * @psalm-param iterable $classOrObject * * @param iterable $classOrObject * @param mixed $method * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrMethodExists($classOrObject, $method, $message = '') { static::isIterable($classOrObject); foreach ($classOrObject as $entry) { null === $entry || static::methodExists($entry, $method, $message); } } /** * @psalm-pure * @psalm-param class-string|object|null $classOrObject * * @param string|object|null $classOrObject * @param mixed $method * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrMethodNotExists($classOrObject, $method, $message = '') { null === $classOrObject || static::methodNotExists($classOrObject, $method, $message); } /** * @psalm-pure * @psalm-param iterable $classOrObject * * @param iterable $classOrObject * @param mixed $method * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allMethodNotExists($classOrObject, $method, $message = '') { static::isIterable($classOrObject); foreach ($classOrObject as $entry) { static::methodNotExists($entry, $method, $message); } } /** * @psalm-pure * @psalm-param iterable $classOrObject * * @param iterable $classOrObject * @param mixed $method * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrMethodNotExists($classOrObject, $method, $message = '') { static::isIterable($classOrObject); foreach ($classOrObject as $entry) { null === $entry || static::methodNotExists($entry, $method, $message); } } /** * @psalm-pure * * @param array|null $array * @param string|int $key * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrKeyExists($array, $key, $message = '') { null === $array || static::keyExists($array, $key, $message); } /** * @psalm-pure * * @param iterable $array * @param string|int $key * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allKeyExists($array, $key, $message = '') { static::isIterable($array); foreach ($array as $entry) { static::keyExists($entry, $key, $message); } } /** * @psalm-pure * * @param iterable $array * @param string|int $key * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrKeyExists($array, $key, $message = '') { static::isIterable($array); foreach ($array as $entry) { null === $entry || static::keyExists($entry, $key, $message); } } /** * @psalm-pure * * @param array|null $array * @param string|int $key * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrKeyNotExists($array, $key, $message = '') { null === $array || static::keyNotExists($array, $key, $message); } /** * @psalm-pure * * @param iterable $array * @param string|int $key * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allKeyNotExists($array, $key, $message = '') { static::isIterable($array); foreach ($array as $entry) { static::keyNotExists($entry, $key, $message); } } /** * @psalm-pure * * @param iterable $array * @param string|int $key * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrKeyNotExists($array, $key, $message = '') { static::isIterable($array); foreach ($array as $entry) { null === $entry || static::keyNotExists($entry, $key, $message); } } /** * @psalm-pure * @psalm-assert array-key|null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrValidArrayKey($value, $message = '') { null === $value || static::validArrayKey($value, $message); } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allValidArrayKey($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::validArrayKey($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrValidArrayKey($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::validArrayKey($entry, $message); } } /** * @param Countable|array|null $array * @param int $number * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrCount($array, $number, $message = '') { null === $array || static::count($array, $number, $message); } /** * @param iterable $array * @param int $number * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allCount($array, $number, $message = '') { static::isIterable($array); foreach ($array as $entry) { static::count($entry, $number, $message); } } /** * @param iterable $array * @param int $number * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrCount($array, $number, $message = '') { static::isIterable($array); foreach ($array as $entry) { null === $entry || static::count($entry, $number, $message); } } /** * @param Countable|array|null $array * @param int|float $min * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrMinCount($array, $min, $message = '') { null === $array || static::minCount($array, $min, $message); } /** * @param iterable $array * @param int|float $min * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allMinCount($array, $min, $message = '') { static::isIterable($array); foreach ($array as $entry) { static::minCount($entry, $min, $message); } } /** * @param iterable $array * @param int|float $min * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrMinCount($array, $min, $message = '') { static::isIterable($array); foreach ($array as $entry) { null === $entry || static::minCount($entry, $min, $message); } } /** * @param Countable|array|null $array * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrMaxCount($array, $max, $message = '') { null === $array || static::maxCount($array, $max, $message); } /** * @param iterable $array * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allMaxCount($array, $max, $message = '') { static::isIterable($array); foreach ($array as $entry) { static::maxCount($entry, $max, $message); } } /** * @param iterable $array * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrMaxCount($array, $max, $message = '') { static::isIterable($array); foreach ($array as $entry) { null === $entry || static::maxCount($entry, $max, $message); } } /** * @param Countable|array|null $array * @param int|float $min * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrCountBetween($array, $min, $max, $message = '') { null === $array || static::countBetween($array, $min, $max, $message); } /** * @param iterable $array * @param int|float $min * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allCountBetween($array, $min, $max, $message = '') { static::isIterable($array); foreach ($array as $entry) { static::countBetween($entry, $min, $max, $message); } } /** * @param iterable $array * @param int|float $min * @param int|float $max * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrCountBetween($array, $min, $max, $message = '') { static::isIterable($array); foreach ($array as $entry) { null === $entry || static::countBetween($entry, $min, $max, $message); } } /** * @psalm-pure * @psalm-assert list|null $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsList($array, $message = '') { null === $array || static::isList($array, $message); } /** * @psalm-pure * @psalm-assert iterable $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsList($array, $message = '') { static::isIterable($array); foreach ($array as $entry) { static::isList($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsList($array, $message = '') { static::isIterable($array); foreach ($array as $entry) { null === $entry || static::isList($entry, $message); } } /** * @psalm-pure * @psalm-assert non-empty-list|null $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsNonEmptyList($array, $message = '') { null === $array || static::isNonEmptyList($array, $message); } /** * @psalm-pure * @psalm-assert iterable $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsNonEmptyList($array, $message = '') { static::isIterable($array); foreach ($array as $entry) { static::isNonEmptyList($entry, $message); } } /** * @psalm-pure * @psalm-assert iterable $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsNonEmptyList($array, $message = '') { static::isIterable($array); foreach ($array as $entry) { null === $entry || static::isNonEmptyList($entry, $message); } } /** * @psalm-pure * @psalm-template T * @psalm-param mixed|array|null $array * @psalm-assert array|null $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsMap($array, $message = '') { null === $array || static::isMap($array, $message); } /** * @psalm-pure * @psalm-template T * @psalm-param iterable> $array * @psalm-assert iterable> $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsMap($array, $message = '') { static::isIterable($array); foreach ($array as $entry) { static::isMap($entry, $message); } } /** * @psalm-pure * @psalm-template T * @psalm-param iterable|null> $array * @psalm-assert iterable|null> $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsMap($array, $message = '') { static::isIterable($array); foreach ($array as $entry) { null === $entry || static::isMap($entry, $message); } } /** * @psalm-pure * @psalm-template T * @psalm-param mixed|array|null $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrIsNonEmptyMap($array, $message = '') { null === $array || static::isNonEmptyMap($array, $message); } /** * @psalm-pure * @psalm-template T * @psalm-param iterable> $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allIsNonEmptyMap($array, $message = '') { static::isIterable($array); foreach ($array as $entry) { static::isNonEmptyMap($entry, $message); } } /** * @psalm-pure * @psalm-template T * @psalm-param iterable|null> $array * @psalm-assert iterable|null> $array * @psalm-assert iterable $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrIsNonEmptyMap($array, $message = '') { static::isIterable($array); foreach ($array as $entry) { null === $entry || static::isNonEmptyMap($entry, $message); } } /** * @psalm-pure * * @param string|null $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrUuid($value, $message = '') { null === $value || static::uuid($value, $message); } /** * @psalm-pure * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allUuid($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { static::uuid($entry, $message); } } /** * @psalm-pure * * @param iterable $value * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrUuid($value, $message = '') { static::isIterable($value); foreach ($value as $entry) { null === $entry || static::uuid($entry, $message); } } /** * @psalm-param class-string $class * * @param Closure|null $expression * @param string $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function nullOrThrows($expression, $class = 'Exception', $message = '') { null === $expression || static::throws($expression, $class, $message); } /** * @psalm-param class-string $class * * @param iterable $expression * @param string $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allThrows($expression, $class = 'Exception', $message = '') { static::isIterable($expression); foreach ($expression as $entry) { static::throws($entry, $class, $message); } } /** * @psalm-param class-string $class * * @param iterable $expression * @param string $class * @param string $message * * @throws InvalidArgumentException * * @return void */ public static function allNullOrThrows($expression, $class = 'Exception', $message = '') { static::isIterable($expression); foreach ($expression as $entry) { null === $entry || static::throws($entry, $class, $message); } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Webmozart\Assert; use ArrayAccess; use BadMethodCallException; use Closure; use Countable; use DateTime; use DateTimeImmutable; use Exception; use ResourceBundle; use SimpleXMLElement; use Throwable; use Traversable; /** * Efficient assertions to validate the input/output of your methods. * * @since 1.0 * * @author Bernhard Schussek */ class Assert { use Mixin; /** * @psalm-pure * @psalm-assert string $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function string($value, $message = '') { if (!\is_string($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a string. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert non-empty-string $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function stringNotEmpty($value, $message = '') { static::string($value, $message); static::notEq($value, '', $message); } /** * @psalm-pure * @psalm-assert int $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function integer($value, $message = '') { if (!\is_int($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an integer. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert numeric $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function integerish($value, $message = '') { if (!\is_numeric($value) || $value != (int) $value) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an integerish value. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert positive-int $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function positiveInteger($value, $message = '') { if (!(\is_int($value) && $value > 0)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a positive integer. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * @psalm-assert float $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function float($value, $message = '') { if (!\is_float($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a float. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert numeric $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function numeric($value, $message = '') { if (!\is_numeric($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a numeric. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert positive-int|0 $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function natural($value, $message = '') { if (!\is_int($value) || $value < 0) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a non-negative integer. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * @psalm-assert bool $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function boolean($value, $message = '') { if (!\is_bool($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a boolean. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert scalar $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function scalar($value, $message = '') { if (!\is_scalar($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a scalar. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert object $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function object($value, $message = '') { if (!\is_object($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an object. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert resource $value * * @param mixed $value * @param string|null $type type of resource this should be. @see https://www.php.net/manual/en/function.get-resource-type.php * @param string $message * * @throws InvalidArgumentException */ public static function resource($value, $type = null, $message = '') { if (!\is_resource($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a resource. Got: %s', static::typeToString($value) )); } if ($type && $type !== \get_resource_type($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a resource of type %2$s. Got: %s', static::typeToString($value), $type )); } } /** * @psalm-pure * @psalm-assert callable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function isCallable($value, $message = '') { if (!\is_callable($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a callable. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert array $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function isArray($value, $message = '') { if (!\is_array($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an array. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert iterable $value * * @deprecated use "isIterable" or "isInstanceOf" instead * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function isTraversable($value, $message = '') { @\trigger_error( \sprintf( 'The "%s" assertion is deprecated. You should stop using it, as it will soon be removed in 2.0 version. Use "isIterable" or "isInstanceOf" instead.', __METHOD__ ), \E_USER_DEPRECATED ); if (!\is_array($value) && !($value instanceof Traversable)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a traversable. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert array|ArrayAccess $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function isArrayAccessible($value, $message = '') { if (!\is_array($value) && !($value instanceof ArrayAccess)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an array accessible. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert countable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function isCountable($value, $message = '') { if ( !\is_array($value) && !($value instanceof Countable) && !($value instanceof ResourceBundle) && !($value instanceof SimpleXMLElement) ) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a countable. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-assert iterable $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function isIterable($value, $message = '') { if (!\is_array($value) && !($value instanceof Traversable)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an iterable. Got: %s', static::typeToString($value) )); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert ExpectedType $value * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException */ public static function isInstanceOf($value, $class, $message = '') { if (!($value instanceof $class)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an instance of %2$s. Got: %s', static::typeToString($value), $class )); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert !ExpectedType $value * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException */ public static function notInstanceOf($value, $class, $message = '') { if ($value instanceof $class) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an instance other than %2$s. Got: %s', static::typeToString($value), $class )); } } /** * @psalm-pure * @psalm-param array $classes * * @param mixed $value * @param array $classes * @param string $message * * @throws InvalidArgumentException */ public static function isInstanceOfAny($value, array $classes, $message = '') { foreach ($classes as $class) { if ($value instanceof $class) { return; } } static::reportInvalidArgument(\sprintf( $message ?: 'Expected an instance of any of %2$s. Got: %s', static::typeToString($value), \implode(', ', \array_map(array(static::class, 'valueToString'), $classes)) )); } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert ExpectedType|class-string $value * * @param object|string $value * @param string $class * @param string $message * * @throws InvalidArgumentException */ public static function isAOf($value, $class, $message = '') { static::string($class, 'Expected class as a string. Got: %s'); if (!\is_a($value, $class, \is_string($value))) { static::reportInvalidArgument(sprintf( $message ?: 'Expected an instance of this class or to this class among its parents "%2$s". Got: %s', static::valueToString($value), $class )); } } /** * @psalm-pure * @psalm-template UnexpectedType of object * @psalm-param class-string $class * @psalm-assert !UnexpectedType $value * @psalm-assert !class-string $value * * @param object|string $value * @param string $class * @param string $message * * @throws InvalidArgumentException */ public static function isNotA($value, $class, $message = '') { static::string($class, 'Expected class as a string. Got: %s'); if (\is_a($value, $class, \is_string($value))) { static::reportInvalidArgument(sprintf( $message ?: 'Expected an instance of this class or to this class among its parents other than "%2$s". Got: %s', static::valueToString($value), $class )); } } /** * @psalm-pure * @psalm-param array $classes * * @param object|string $value * @param string[] $classes * @param string $message * * @throws InvalidArgumentException */ public static function isAnyOf($value, array $classes, $message = '') { foreach ($classes as $class) { static::string($class, 'Expected class as a string. Got: %s'); if (\is_a($value, $class, \is_string($value))) { return; } } static::reportInvalidArgument(sprintf( $message ?: 'Expected an instance of any of this classes or any of those classes among their parents "%2$s". Got: %s', static::valueToString($value), \implode(', ', $classes) )); } /** * @psalm-pure * @psalm-assert empty $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function isEmpty($value, $message = '') { if (!empty($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an empty value. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * @psalm-assert !empty $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function notEmpty($value, $message = '') { if (empty($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a non-empty value. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * @psalm-assert null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function null($value, $message = '') { if (null !== $value) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected null. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * @psalm-assert !null $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function notNull($value, $message = '') { if (null === $value) { static::reportInvalidArgument( $message ?: 'Expected a value other than null.' ); } } /** * @psalm-pure * @psalm-assert true $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function true($value, $message = '') { if (true !== $value) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to be true. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * @psalm-assert false $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function false($value, $message = '') { if (false !== $value) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to be false. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * @psalm-assert !false $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function notFalse($value, $message = '') { if (false === $value) { static::reportInvalidArgument( $message ?: 'Expected a value other than false.' ); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function ip($value, $message = '') { if (false === \filter_var($value, \FILTER_VALIDATE_IP)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to be an IP. Got: %s', static::valueToString($value) )); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function ipv4($value, $message = '') { if (false === \filter_var($value, \FILTER_VALIDATE_IP, \FILTER_FLAG_IPV4)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to be an IPv4. Got: %s', static::valueToString($value) )); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function ipv6($value, $message = '') { if (false === \filter_var($value, \FILTER_VALIDATE_IP, \FILTER_FLAG_IPV6)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to be an IPv6. Got: %s', static::valueToString($value) )); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function email($value, $message = '') { if (false === \filter_var($value, FILTER_VALIDATE_EMAIL)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to be a valid e-mail address. Got: %s', static::valueToString($value) )); } } /** * Does non strict comparisons on the items, so ['3', 3] will not pass the assertion. * * @param array $values * @param string $message * * @throws InvalidArgumentException */ public static function uniqueValues(array $values, $message = '') { $allValues = \count($values); $uniqueValues = \count(\array_unique($values)); if ($allValues !== $uniqueValues) { $difference = $allValues - $uniqueValues; static::reportInvalidArgument(\sprintf( $message ?: 'Expected an array of unique values, but %s of them %s duplicated', $difference, (1 === $difference ? 'is' : 'are') )); } } /** * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException */ public static function eq($value, $expect, $message = '') { if ($expect != $value) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value equal to %2$s. Got: %s', static::valueToString($value), static::valueToString($expect) )); } } /** * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException */ public static function notEq($value, $expect, $message = '') { if ($expect == $value) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a different value than %s.', static::valueToString($expect) )); } } /** * @psalm-pure * * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException */ public static function same($value, $expect, $message = '') { if ($expect !== $value) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value identical to %2$s. Got: %s', static::valueToString($value), static::valueToString($expect) )); } } /** * @psalm-pure * * @param mixed $value * @param mixed $expect * @param string $message * * @throws InvalidArgumentException */ public static function notSame($value, $expect, $message = '') { if ($expect === $value) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value not identical to %s.', static::valueToString($expect) )); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException */ public static function greaterThan($value, $limit, $message = '') { if ($value <= $limit) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value greater than %2$s. Got: %s', static::valueToString($value), static::valueToString($limit) )); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException */ public static function greaterThanEq($value, $limit, $message = '') { if ($value < $limit) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value greater than or equal to %2$s. Got: %s', static::valueToString($value), static::valueToString($limit) )); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException */ public static function lessThan($value, $limit, $message = '') { if ($value >= $limit) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value less than %2$s. Got: %s', static::valueToString($value), static::valueToString($limit) )); } } /** * @psalm-pure * * @param mixed $value * @param mixed $limit * @param string $message * * @throws InvalidArgumentException */ public static function lessThanEq($value, $limit, $message = '') { if ($value > $limit) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value less than or equal to %2$s. Got: %s', static::valueToString($value), static::valueToString($limit) )); } } /** * Inclusive range, so Assert::(3, 3, 5) passes. * * @psalm-pure * * @param mixed $value * @param mixed $min * @param mixed $max * @param string $message * * @throws InvalidArgumentException */ public static function range($value, $min, $max, $message = '') { if ($value < $min || $value > $max) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value between %2$s and %3$s. Got: %s', static::valueToString($value), static::valueToString($min), static::valueToString($max) )); } } /** * A more human-readable alias of Assert::inArray(). * * @psalm-pure * * @param mixed $value * @param array $values * @param string $message * * @throws InvalidArgumentException */ public static function oneOf($value, array $values, $message = '') { static::inArray($value, $values, $message); } /** * Does strict comparison, so Assert::inArray(3, ['3']) does not pass the assertion. * * @psalm-pure * * @param mixed $value * @param array $values * @param string $message * * @throws InvalidArgumentException */ public static function inArray($value, array $values, $message = '') { if (!\in_array($value, $values, true)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected one of: %2$s. Got: %s', static::valueToString($value), \implode(', ', \array_map(array(static::class, 'valueToString'), $values)) )); } } /** * @psalm-pure * * @param string $value * @param string $subString * @param string $message * * @throws InvalidArgumentException */ public static function contains($value, $subString, $message = '') { if (false === \strpos($value, $subString)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to contain %2$s. Got: %s', static::valueToString($value), static::valueToString($subString) )); } } /** * @psalm-pure * * @param string $value * @param string $subString * @param string $message * * @throws InvalidArgumentException */ public static function notContains($value, $subString, $message = '') { if (false !== \strpos($value, $subString)) { static::reportInvalidArgument(\sprintf( $message ?: '%2$s was not expected to be contained in a value. Got: %s', static::valueToString($value), static::valueToString($subString) )); } } /** * @psalm-pure * * @param string $value * @param string $message * * @throws InvalidArgumentException */ public static function notWhitespaceOnly($value, $message = '') { if (\preg_match('/^\s*$/', $value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a non-whitespace string. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * * @param string $value * @param string $prefix * @param string $message * * @throws InvalidArgumentException */ public static function startsWith($value, $prefix, $message = '') { if (0 !== \strpos($value, $prefix)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to start with %2$s. Got: %s', static::valueToString($value), static::valueToString($prefix) )); } } /** * @psalm-pure * * @param string $value * @param string $prefix * @param string $message * * @throws InvalidArgumentException */ public static function notStartsWith($value, $prefix, $message = '') { if (0 === \strpos($value, $prefix)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value not to start with %2$s. Got: %s', static::valueToString($value), static::valueToString($prefix) )); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function startsWithLetter($value, $message = '') { static::string($value); $valid = isset($value[0]); if ($valid) { $locale = \setlocale(LC_CTYPE, 0); \setlocale(LC_CTYPE, 'C'); $valid = \ctype_alpha($value[0]); \setlocale(LC_CTYPE, $locale); } if (!$valid) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to start with a letter. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * * @param string $value * @param string $suffix * @param string $message * * @throws InvalidArgumentException */ public static function endsWith($value, $suffix, $message = '') { if ($suffix !== \substr($value, -\strlen($suffix))) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to end with %2$s. Got: %s', static::valueToString($value), static::valueToString($suffix) )); } } /** * @psalm-pure * * @param string $value * @param string $suffix * @param string $message * * @throws InvalidArgumentException */ public static function notEndsWith($value, $suffix, $message = '') { if ($suffix === \substr($value, -\strlen($suffix))) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value not to end with %2$s. Got: %s', static::valueToString($value), static::valueToString($suffix) )); } } /** * @psalm-pure * * @param string $value * @param string $pattern * @param string $message * * @throws InvalidArgumentException */ public static function regex($value, $pattern, $message = '') { if (!\preg_match($pattern, $value)) { static::reportInvalidArgument(\sprintf( $message ?: 'The value %s does not match the expected pattern.', static::valueToString($value) )); } } /** * @psalm-pure * * @param string $value * @param string $pattern * @param string $message * * @throws InvalidArgumentException */ public static function notRegex($value, $pattern, $message = '') { if (\preg_match($pattern, $value, $matches, PREG_OFFSET_CAPTURE)) { static::reportInvalidArgument(\sprintf( $message ?: 'The value %s matches the pattern %s (at offset %d).', static::valueToString($value), static::valueToString($pattern), $matches[0][1] )); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function unicodeLetters($value, $message = '') { static::string($value); if (!\preg_match('/^\p{L}+$/u', $value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to contain only Unicode letters. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function alpha($value, $message = '') { static::string($value); $locale = \setlocale(LC_CTYPE, 0); \setlocale(LC_CTYPE, 'C'); $valid = !\ctype_alpha($value); \setlocale(LC_CTYPE, $locale); if ($valid) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to contain only letters. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * * @param string $value * @param string $message * * @throws InvalidArgumentException */ public static function digits($value, $message = '') { $locale = \setlocale(LC_CTYPE, 0); \setlocale(LC_CTYPE, 'C'); $valid = !\ctype_digit($value); \setlocale(LC_CTYPE, $locale); if ($valid) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to contain digits only. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * * @param string $value * @param string $message * * @throws InvalidArgumentException */ public static function alnum($value, $message = '') { $locale = \setlocale(LC_CTYPE, 0); \setlocale(LC_CTYPE, 'C'); $valid = !\ctype_alnum($value); \setlocale(LC_CTYPE, $locale); if ($valid) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to contain letters and digits only. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * @psalm-assert lowercase-string $value * * @param string $value * @param string $message * * @throws InvalidArgumentException */ public static function lower($value, $message = '') { $locale = \setlocale(LC_CTYPE, 0); \setlocale(LC_CTYPE, 'C'); $valid = !\ctype_lower($value); \setlocale(LC_CTYPE, $locale); if ($valid) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to contain lowercase characters only. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * @psalm-assert !lowercase-string $value * * @param string $value * @param string $message * * @throws InvalidArgumentException */ public static function upper($value, $message = '') { $locale = \setlocale(LC_CTYPE, 0); \setlocale(LC_CTYPE, 'C'); $valid = !\ctype_upper($value); \setlocale(LC_CTYPE, $locale); if ($valid) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to contain uppercase characters only. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * * @param string $value * @param int $length * @param string $message * * @throws InvalidArgumentException */ public static function length($value, $length, $message = '') { if ($length !== static::strlen($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to contain %2$s characters. Got: %s', static::valueToString($value), $length )); } } /** * Inclusive min. * * @psalm-pure * * @param string $value * @param int|float $min * @param string $message * * @throws InvalidArgumentException */ public static function minLength($value, $min, $message = '') { if (static::strlen($value) < $min) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to contain at least %2$s characters. Got: %s', static::valueToString($value), $min )); } } /** * Inclusive max. * * @psalm-pure * * @param string $value * @param int|float $max * @param string $message * * @throws InvalidArgumentException */ public static function maxLength($value, $max, $message = '') { if (static::strlen($value) > $max) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to contain at most %2$s characters. Got: %s', static::valueToString($value), $max )); } } /** * Inclusive , so Assert::lengthBetween('asd', 3, 5); passes the assertion. * * @psalm-pure * * @param string $value * @param int|float $min * @param int|float $max * @param string $message * * @throws InvalidArgumentException */ public static function lengthBetween($value, $min, $max, $message = '') { $length = static::strlen($value); if ($length < $min || $length > $max) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a value to contain between %2$s and %3$s characters. Got: %s', static::valueToString($value), $min, $max )); } } /** * Will also pass if $value is a directory, use Assert::file() instead if you need to be sure it is a file. * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function fileExists($value, $message = '') { static::string($value); if (!\file_exists($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'The file %s does not exist.', static::valueToString($value) )); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function file($value, $message = '') { static::fileExists($value, $message); if (!\is_file($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'The path %s is not a file.', static::valueToString($value) )); } } /** * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function directory($value, $message = '') { static::fileExists($value, $message); if (!\is_dir($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'The path %s is no directory.', static::valueToString($value) )); } } /** * @param string $value * @param string $message * * @throws InvalidArgumentException */ public static function readable($value, $message = '') { if (!\is_readable($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'The path %s is not readable.', static::valueToString($value) )); } } /** * @param string $value * @param string $message * * @throws InvalidArgumentException */ public static function writable($value, $message = '') { if (!\is_writable($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'The path %s is not writable.', static::valueToString($value) )); } } /** * @psalm-assert class-string $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function classExists($value, $message = '') { if (!\class_exists($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an existing class name. Got: %s', static::valueToString($value) )); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $class * @psalm-assert class-string|ExpectedType $value * * @param mixed $value * @param string|object $class * @param string $message * * @throws InvalidArgumentException */ public static function subclassOf($value, $class, $message = '') { if (!\is_subclass_of($value, $class)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected a sub-class of %2$s. Got: %s', static::valueToString($value), static::valueToString($class) )); } } /** * @psalm-assert class-string $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function interfaceExists($value, $message = '') { if (!\interface_exists($value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an existing interface name. got %s', static::valueToString($value) )); } } /** * @psalm-pure * @psalm-template ExpectedType of object * @psalm-param class-string $interface * @psalm-assert class-string $value * * @param mixed $value * @param mixed $interface * @param string $message * * @throws InvalidArgumentException */ public static function implementsInterface($value, $interface, $message = '') { if (!\in_array($interface, \class_implements($value))) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an implementation of %2$s. Got: %s', static::valueToString($value), static::valueToString($interface) )); } } /** * @psalm-pure * @psalm-param class-string|object $classOrObject * * @param string|object $classOrObject * @param mixed $property * @param string $message * * @throws InvalidArgumentException */ public static function propertyExists($classOrObject, $property, $message = '') { if (!\property_exists($classOrObject, $property)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected the property %s to exist.', static::valueToString($property) )); } } /** * @psalm-pure * @psalm-param class-string|object $classOrObject * * @param string|object $classOrObject * @param mixed $property * @param string $message * * @throws InvalidArgumentException */ public static function propertyNotExists($classOrObject, $property, $message = '') { if (\property_exists($classOrObject, $property)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected the property %s to not exist.', static::valueToString($property) )); } } /** * @psalm-pure * @psalm-param class-string|object $classOrObject * * @param string|object $classOrObject * @param mixed $method * @param string $message * * @throws InvalidArgumentException */ public static function methodExists($classOrObject, $method, $message = '') { if (!(\is_string($classOrObject) || \is_object($classOrObject)) || !\method_exists($classOrObject, $method)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected the method %s to exist.', static::valueToString($method) )); } } /** * @psalm-pure * @psalm-param class-string|object $classOrObject * * @param string|object $classOrObject * @param mixed $method * @param string $message * * @throws InvalidArgumentException */ public static function methodNotExists($classOrObject, $method, $message = '') { if ((\is_string($classOrObject) || \is_object($classOrObject)) && \method_exists($classOrObject, $method)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected the method %s to not exist.', static::valueToString($method) )); } } /** * @psalm-pure * * @param array $array * @param string|int $key * @param string $message * * @throws InvalidArgumentException */ public static function keyExists($array, $key, $message = '') { if (!(isset($array[$key]) || \array_key_exists($key, $array))) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected the key %s to exist.', static::valueToString($key) )); } } /** * @psalm-pure * * @param array $array * @param string|int $key * @param string $message * * @throws InvalidArgumentException */ public static function keyNotExists($array, $key, $message = '') { if (isset($array[$key]) || \array_key_exists($key, $array)) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected the key %s to not exist.', static::valueToString($key) )); } } /** * Checks if a value is a valid array key (int or string). * * @psalm-pure * @psalm-assert array-key $value * * @param mixed $value * @param string $message * * @throws InvalidArgumentException */ public static function validArrayKey($value, $message = '') { if (!(\is_int($value) || \is_string($value))) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected string or integer. Got: %s', static::typeToString($value) )); } } /** * Does not check if $array is countable, this can generate a warning on php versions after 7.2. * * @param Countable|array $array * @param int $number * @param string $message * * @throws InvalidArgumentException */ public static function count($array, $number, $message = '') { static::eq( \count($array), $number, \sprintf( $message ?: 'Expected an array to contain %d elements. Got: %d.', $number, \count($array) ) ); } /** * Does not check if $array is countable, this can generate a warning on php versions after 7.2. * * @param Countable|array $array * @param int|float $min * @param string $message * * @throws InvalidArgumentException */ public static function minCount($array, $min, $message = '') { if (\count($array) < $min) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an array to contain at least %2$d elements. Got: %d', \count($array), $min )); } } /** * Does not check if $array is countable, this can generate a warning on php versions after 7.2. * * @param Countable|array $array * @param int|float $max * @param string $message * * @throws InvalidArgumentException */ public static function maxCount($array, $max, $message = '') { if (\count($array) > $max) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an array to contain at most %2$d elements. Got: %d', \count($array), $max )); } } /** * Does not check if $array is countable, this can generate a warning on php versions after 7.2. * * @param Countable|array $array * @param int|float $min * @param int|float $max * @param string $message * * @throws InvalidArgumentException */ public static function countBetween($array, $min, $max, $message = '') { $count = \count($array); if ($count < $min || $count > $max) { static::reportInvalidArgument(\sprintf( $message ?: 'Expected an array to contain between %2$d and %3$d elements. Got: %d', $count, $min, $max )); } } /** * @psalm-pure * @psalm-assert list $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException */ public static function isList($array, $message = '') { if (!\is_array($array)) { static::reportInvalidArgument( $message ?: 'Expected list - non-associative array.' ); } if ($array === \array_values($array)) { return; } $nextKey = -1; foreach ($array as $k => $v) { if ($k !== ++$nextKey) { static::reportInvalidArgument( $message ?: 'Expected list - non-associative array.' ); } } } /** * @psalm-pure * @psalm-assert non-empty-list $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException */ public static function isNonEmptyList($array, $message = '') { static::isList($array, $message); static::notEmpty($array, $message); } /** * @psalm-pure * @psalm-template T * @psalm-param mixed|array $array * @psalm-assert array $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException */ public static function isMap($array, $message = '') { if ( !\is_array($array) || \array_keys($array) !== \array_filter(\array_keys($array), '\is_string') ) { static::reportInvalidArgument( $message ?: 'Expected map - associative array with string keys.' ); } } /** * @psalm-pure * @psalm-template T * @psalm-param mixed|array $array * @psalm-assert array $array * @psalm-assert !empty $array * * @param mixed $array * @param string $message * * @throws InvalidArgumentException */ public static function isNonEmptyMap($array, $message = '') { static::isMap($array, $message); static::notEmpty($array, $message); } /** * @psalm-pure * * @param string $value * @param string $message * * @throws InvalidArgumentException */ public static function uuid($value, $message = '') { $value = \str_replace(array('urn:', 'uuid:', '{', '}'), '', $value); // The nil UUID is special form of UUID that is specified to have all // 128 bits set to zero. if ('00000000-0000-0000-0000-000000000000' === $value) { return; } if (!\preg_match('/^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$/', $value)) { static::reportInvalidArgument(\sprintf( $message ?: 'Value %s is not a valid UUID.', static::valueToString($value) )); } } /** * @psalm-param class-string $class * * @param Closure $expression * @param string $class * @param string $message * * @throws InvalidArgumentException */ public static function throws(Closure $expression, $class = 'Exception', $message = '') { static::string($class); $actual = 'none'; try { $expression(); } catch (Exception $e) { $actual = \get_class($e); if ($e instanceof $class) { return; } } catch (Throwable $e) { $actual = \get_class($e); if ($e instanceof $class) { return; } } static::reportInvalidArgument($message ?: \sprintf( 'Expected to throw "%s", got "%s"', $class, $actual )); } /** * @throws BadMethodCallException */ public static function __callStatic($name, $arguments) { if ('nullOr' === \substr($name, 0, 6)) { if (null !== $arguments[0]) { $method = \lcfirst(\substr($name, 6)); \call_user_func_array(array(static::class, $method), $arguments); } return; } if ('all' === \substr($name, 0, 3)) { static::isIterable($arguments[0]); $method = \lcfirst(\substr($name, 3)); $args = $arguments; foreach ($arguments[0] as $entry) { $args[0] = $entry; \call_user_func_array(array(static::class, $method), $args); } return; } throw new BadMethodCallException('No such method: '.$name); } /** * @param mixed $value * * @return string */ protected static function valueToString($value) { if (null === $value) { return 'null'; } if (true === $value) { return 'true'; } if (false === $value) { return 'false'; } if (\is_array($value)) { return 'array'; } if (\is_object($value)) { if (\method_exists($value, '__toString')) { return \get_class($value).': '.self::valueToString($value->__toString()); } if ($value instanceof DateTime || $value instanceof DateTimeImmutable) { return \get_class($value).': '.self::valueToString($value->format('c')); } return \get_class($value); } if (\is_resource($value)) { return 'resource'; } if (\is_string($value)) { return '"'.$value.'"'; } return (string) $value; } /** * @param mixed $value * * @return string */ protected static function typeToString($value) { return \is_object($value) ? \get_class($value) : \gettype($value); } protected static function strlen($value) { if (!\function_exists('mb_detect_encoding')) { return \strlen($value); } if (false === $encoding = \mb_detect_encoding($value)) { return \strlen($value); } return \mb_strlen($value, $encoding); } /** * @param string $message * * @throws InvalidArgumentException * * @psalm-pure this method is not supposed to perform side-effects * @psalm-return never */ protected static function reportInvalidArgument($message) { throw new InvalidArgumentException($message); } private function __construct() { } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 1.0.0 */ namespace LibDNS\Tools; use \RecursiveIteratorIterator; use \RecursiveDirectoryIterator; use \FilesystemIterator; error_reporting(0); ini_set('display_errors', 0); if (!isset($argv[1])) { $srcDir = getcwd(); } else if (in_array(strtolower($argv[1]), ['--help', '?', '/?'])) { exit("Syntax: " . __FILE__ . " [source directory]\n"); } else if (!is_dir($srcDir = $argv[1])) { exit("Invalid source directory\n\nSyntax: " . __FILE__ . " [source directory]\n"); } $srcDir = str_replace('\\', '/', $srcDir); $iterator = new RecursiveIteratorIterator( new RecursiveDirectoryIterator( $srcDir, FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO | FilesystemIterator::SKIP_DOTS ) ); $items = []; $stripLength = strlen($srcDir) + 1; $maxLength = 0; foreach ($iterator as $item) { if ($item->isFile() && $item->getFilename() !== 'autoload.php' && strtolower($item->getExtension()) === 'php') { $classPath = substr($item->getPath() . '\\' . $item->getBasename('.' . $item->getExtension()), $stripLength); $lookupName = strtolower(str_replace('/', '\\', $classPath)); $loadPath = "__DIR__ . '/$srcDir/" . str_replace('\\', '/', $classPath) . ".php'"; $length = strlen($classPath); if ($length > $maxLength) { $maxLength = $length; } $items[$lookupName] = $loadPath; } } unset($iterator); $output = <<<'PHP' $loadPath) { $output .= "\n " . str_pad("'" . $lookupName . "'", $maxLength, ' ', STR_PAD_RIGHT) . " => $loadPath,"; } $output .= <<<'PHP' ]; } $className = strtolower($className); if (isset($classMap[$className])) { /** @noinspection PhpIncludeInspection */ require $classMap[$className]; } }); PHP; file_put_contents(getcwd() . '/autoload.php', $output); { "name": "daverandom/libdns", "description": "DNS protocol implementation written in pure PHP", "license": "MIT", "keywords": ["dns"], "require": { "php": ">=7.0", "ext-ctype": "*" }, "autoload": { "psr-4": { "LibDNS\\": "src/" }, "files": ["src/functions.php"] }, "support": { "issues": "https://github.com/DaveRandom/LibDNS/issues" }, "suggest": { "ext-intl": "Required for IDN support" } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 1.0.0 */ namespace LibDNS\Examples; use \LibDNS\Messages\MessageFactory; use \LibDNS\Messages\MessageTypes; use \LibDNS\Records\QuestionFactory; use \LibDNS\Records\ResourceTypes; use \LibDNS\Records\ResourceQTypes; use \LibDNS\Encoder\EncoderFactory; use \LibDNS\Decoder\DecoderFactory; use \LibDNS\Records\TypeDefinitions\TypeDefinitionManagerFactory; // Config $queryName = 'google.com'; $serverIP = '8.8.8.8'; $requestTimeout = 3; require __DIR__ . '/autoload.php'; // Create question record $question = (new QuestionFactory)->create(ResourceQTypes::SOA); $question->setName($queryName); // Create request message $request = (new MessageFactory)->create(MessageTypes::QUERY); $request->getQuestionRecords()->add($question); $request->isRecursionDesired(true); // Encode request message $encoder = (new EncoderFactory)->create(); $requestPacket = $encoder->encode($request); echo "\n" . $queryName . ":\n"; // Send request $socket = stream_socket_client("udp://$serverIP:53"); stream_socket_sendto($socket, $requestPacket); $r = [$socket]; $w = $e = []; if (!stream_select($r, $w, $e, $requestTimeout)) { echo " Request timeout.\n"; exit; } // Create type definition manager for custom manipulation $typeDefs = (new TypeDefinitionManagerFactory)->create(); $typeDefs->getTypeDefinition(ResourceTypes::SOA)->setToStringFunction(function($mname, $rname, $serial, $refresh, $retry, $expire, $minimum) { return <<create($typeDefs); $responsePacket = fread($socket, 512); $response = $decoder->decode($responsePacket); // Handle response if ($response->getResponseCode() !== 0) { echo " Server returned error code " . $response->getResponseCode() . ".\n"; exit; } $answers = $response->getAnswerRecords(); if (count($answers)) { foreach ($response->getAnswerRecords() as $record) { /** @var \LibDNS\Records\Resource $record */ echo " " . $record->getData() . "\n"; } } else { echo " Not found.\n"; } __DIR__ . '/../src/Decoder/Decoder.php', 'libdns\decoder\decoderfactory' => __DIR__ . '/../src/Decoder/DecoderFactory.php', 'libdns\decoder\decodingcontext' => __DIR__ . '/../src/Decoder/DecodingContext.php', 'libdns\decoder\decodingcontextfactory' => __DIR__ . '/../src/Decoder/DecodingContextFactory.php', 'libdns\encoder\encoder' => __DIR__ . '/../src/Encoder/Encoder.php', 'libdns\encoder\encoderfactory' => __DIR__ . '/../src/Encoder/EncoderFactory.php', 'libdns\encoder\encodingcontext' => __DIR__ . '/../src/Encoder/EncodingContext.php', 'libdns\encoder\encodingcontextfactory' => __DIR__ . '/../src/Encoder/EncodingContextFactory.php', 'libdns\enumeration' => __DIR__ . '/../src/Enumeration.php', 'libdns\messages\message' => __DIR__ . '/../src/Messages/Message.php', 'libdns\messages\messagefactory' => __DIR__ . '/../src/Messages/MessageFactory.php', 'libdns\messages\messageopcodes' => __DIR__ . '/../src/Messages/MessageOpCodes.php', 'libdns\messages\messageresponsecodes' => __DIR__ . '/../src/Messages/MessageResponseCodes.php', 'libdns\messages\messagetypes' => __DIR__ . '/../src/Messages/MessageTypes.php', 'libdns\packets\labelregistry' => __DIR__ . '/../src/Packets/LabelRegistry.php', 'libdns\packets\packet' => __DIR__ . '/../src/Packets/Packet.php', 'libdns\packets\packetfactory' => __DIR__ . '/../src/Packets/PacketFactory.php', 'libdns\records\question' => __DIR__ . '/../src/Records/Question.php', 'libdns\records\questionfactory' => __DIR__ . '/../src/Records/QuestionFactory.php', 'libdns\records\rdata' => __DIR__ . '/../src/Records/RData.php', 'libdns\records\rdatabuilder' => __DIR__ . '/../src/Records/RDataBuilder.php', 'libdns\records\rdatafactory' => __DIR__ . '/../src/Records/RDataFactory.php', 'libdns\records\record' => __DIR__ . '/../src/Records/Record.php', 'libdns\records\recordcollection' => __DIR__ . '/../src/Records/RecordCollection.php', 'libdns\records\recordcollectionfactory' => __DIR__ . '/../src/Records/RecordCollectionFactory.php', 'libdns\records\recordtypes' => __DIR__ . '/../src/Records/RecordTypes.php', 'libdns\records\resource' => __DIR__ . '/../src/Records/Resource.php', 'libdns\records\resourcebuilder' => __DIR__ . '/../src/Records/ResourceBuilder.php', 'libdns\records\resourcebuilderfactory' => __DIR__ . '/../src/Records/ResourceBuilderFactory.php', 'libdns\records\resourceclasses' => __DIR__ . '/../src/Records/ResourceClasses.php', 'libdns\records\resourcefactory' => __DIR__ . '/../src/Records/ResourceFactory.php', 'libdns\records\resourceqclasses' => __DIR__ . '/../src/Records/ResourceQClasses.php', 'libdns\records\resourceqtypes' => __DIR__ . '/../src/Records/ResourceQTypes.php', 'libdns\records\resourcetypes' => __DIR__ . '/../src/Records/ResourceTypes.php', 'libdns\records\typedefinitions\fielddefinition' => __DIR__ . '/../src/Records/TypeDefinitions/FieldDefinition.php', 'libdns\records\typedefinitions\fielddefinitionfactory' => __DIR__ . '/../src/Records/TypeDefinitions/FieldDefinitionFactory.php', 'libdns\records\typedefinitions\typedefinition' => __DIR__ . '/../src/Records/TypeDefinitions/TypeDefinition.php', 'libdns\records\typedefinitions\typedefinitionfactory' => __DIR__ . '/../src/Records/TypeDefinitions/TypeDefinitionFactory.php', 'libdns\records\typedefinitions\typedefinitionmanager' => __DIR__ . '/../src/Records/TypeDefinitions/TypeDefinitionManager.php', 'libdns\records\typedefinitions\typedefinitionmanagerfactory' => __DIR__ . '/../src/Records/TypeDefinitions/TypeDefinitionManagerFactory.php', 'libdns\records\types\anything' => __DIR__ . '/../src/Records/Types/Anything.php', 'libdns\records\types\bitmap' => __DIR__ . '/../src/Records/Types/BitMap.php', 'libdns\records\types\char' => __DIR__ . '/../src/Records/Types/Char.php', 'libdns\records\types\characterstring' => __DIR__ . '/../src/Records/Types/CharacterString.php', 'libdns\records\types\domainname' => __DIR__ . '/../src/Records/Types/DomainName.php', 'libdns\records\types\ipv4address' => __DIR__ . '/../src/Records/Types/IPv4Address.php', 'libdns\records\types\ipv6address' => __DIR__ . '/../src/Records/Types/IPv6Address.php', 'libdns\records\types\long' => __DIR__ . '/../src/Records/Types/Long.php', 'libdns\records\types\short' => __DIR__ . '/../src/Records/Types/Short.php', 'libdns\records\types\type' => __DIR__ . '/../src/Records/Types/Type.php', 'libdns\records\types\typebuilder' => __DIR__ . '/../src/Records/Types/TypeBuilder.php', 'libdns\records\types\typefactory' => __DIR__ . '/../src/Records/Types/TypeFactory.php', 'libdns\records\types\types' => __DIR__ . '/../src/Records/Types/Types.php', ]; } $className = strtolower($className); if (isset($classMap[$className])) { /** @noinspection PhpIncludeInspection */ require $classMap[$className]; } }); * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 1.0.0 */ namespace LibDNS\Examples; use \LibDNS\Messages\MessageFactory; use \LibDNS\Messages\MessageTypes; use \LibDNS\Records\QuestionFactory; use \LibDNS\Records\ResourceQTypes; use \LibDNS\Encoder\EncoderFactory; use \LibDNS\Decoder\DecoderFactory; // Config $queryName = 'faß.de'; $serverIP = '8.8.8.8'; $requestTimeout = 3; require __DIR__ . '/autoload.php'; // Create question record $question = (new QuestionFactory)->create(ResourceQTypes::A); $question->setName($queryName); // Create request message $request = (new MessageFactory)->create(MessageTypes::QUERY); $request->getQuestionRecords()->add($question); $request->isRecursionDesired(true); // Encode request message $encoder = (new EncoderFactory)->create(); $requestPacket = $encoder->encode($request); echo "\n" . $queryName . ":\n"; // Send request $socket = stream_socket_client("udp://$serverIP:53"); stream_socket_sendto($socket, $requestPacket); $r = [$socket]; $w = $e = []; if (!stream_select($r, $w, $e, $requestTimeout)) { echo " Request timeout.\n"; exit; } // Decode response message $decoder = (new DecoderFactory)->create(); $responsePacket = fread($socket, 512); $response = $decoder->decode($responsePacket); // Handle response if ($response->getResponseCode() !== 0) { echo " Server returned error code " . $response->getResponseCode() . ".\n"; exit; } $answers = $response->getAnswerRecords(); if (count($answers)) { foreach ($response->getAnswerRecords() as $record) { /** @var \LibDNS\Records\Resource $record */ echo " " . $record->getData() . "\n"; } } else { echo " Not found.\n"; } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS; /** * Base class for enumerations to prevent instantiation * * @category LibDNS * @package LibDNS * @author Chris Wright */ abstract class Enumeration { final protected function __construct() { throw new \LogicException('Enumerations cannot be instantiated'); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Encoder; use \LibDNS\Packets\Packet; use \LibDNS\Packets\LabelRegistry; /** * Creates EncodingContext objects * * @category LibDNS * @package Encoder * @author Chris Wright */ class EncodingContextFactory { /** * Create a new EncodingContext object * * @param \LibDNS\Packets\Packet $packet The packet to be decoded * @param bool $compress Whether message compression is enabled * @return \LibDNS\Encoder\EncodingContext */ public function create(Packet $packet, bool $compress): EncodingContext { return new EncodingContext($packet, new LabelRegistry, $compress); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Encoder; use \LibDNS\Packets\PacketFactory; /** * Creates Encoder objects * * @category LibDNS * @package Encoder * @author Chris Wright */ class EncoderFactory { /** * Create a new Encoder object * * @return \LibDNS\Encoder\Encoder */ public function create(): Encoder { return new Encoder(new PacketFactory, new EncodingContextFactory); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Encoder; use \LibDNS\Packets\Packet; use \LibDNS\Packets\LabelRegistry; /** * Holds data associated with an encode operation * * @category LibDNS * @package Encoder * @author Chris Wright */ class EncodingContext { /** * @var \LibDNS\Packets\Packet */ private $packet; /** * @var \LibDNS\Packets\LabelRegistry */ private $labelRegistry; /** * @var bool */ private $compress; /** * @var bool */ private $truncate = false; /** * Constructor * * @param \LibDNS\Packets\Packet $packet * @param \LibDNS\Packets\LabelRegistry $labelRegistry * @param bool $compress */ public function __construct(Packet $packet, LabelRegistry $labelRegistry, bool $compress) { $this->packet = $packet; $this->labelRegistry = $labelRegistry; $this->compress = $compress; } /** * Get the packet * * @return \LibDNS\Packets\Packet */ public function getPacket(): Packet { return $this->packet; } /** * Get the label registry * * @return \LibDNS\Packets\LabelRegistry */ public function getLabelRegistry(): LabelRegistry { return $this->labelRegistry; } /** * Determine whether compression is enabled * * @return bool */ public function useCompression(): bool { return $this->compress; } /** * Determine or set whether the message is truncated * * @param bool $truncate * @return bool */ public function isTruncated(bool $truncate = null): bool { $result = $this->truncate; if ($truncate !== null) { $this->truncate = $truncate; } return $result; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Encoder; use \LibDNS\Packets\PacketFactory; use \LibDNS\Messages\Message; use \LibDNS\Records\Question; use \LibDNS\Records\Resource; use \LibDNS\Records\Types\Type; use \LibDNS\Records\Types\Anything; use \LibDNS\Records\Types\BitMap; use \LibDNS\Records\Types\Char; use \LibDNS\Records\Types\CharacterString; use \LibDNS\Records\Types\DomainName; use \LibDNS\Records\Types\IPv4Address; use \LibDNS\Records\Types\IPv6Address; use \LibDNS\Records\Types\Long; use \LibDNS\Records\Types\Short; /** * Encodes Message objects to raw network data * * @category LibDNS * @package Encoder * @author Chris Wright */ class Encoder { /** * @var \LibDNS\Packets\PacketFactory */ private $packetFactory; /** * @var \LibDNS\Encoder\EncodingContextFactory */ private $encodingContextFactory; /** * Constructor * * @param \LibDNS\Packets\PacketFactory $packetFactory * @param \LibDNS\Encoder\EncodingContextFactory $encodingContextFactory */ public function __construct(PacketFactory $packetFactory, EncodingContextFactory $encodingContextFactory) { $this->packetFactory = $packetFactory; $this->encodingContextFactory = $encodingContextFactory; } /** * Encode the header section of the message * * @param \LibDNS\Encoder\EncodingContext $encodingContext * @param \LibDNS\Messages\Message $message * @return string * @throws \UnexpectedValueException When the header section is invalid */ private function encodeHeader(EncodingContext $encodingContext, Message $message): string { $header = [ 'id' => $message->getID(), 'meta' => 0, 'qd' => $message->getQuestionRecords()->count(), 'an' => $message->getAnswerRecords()->count(), 'ns' => $message->getAuthorityRecords()->count(), 'ar' => $message->getAdditionalRecords()->count() ]; $header['meta'] |= $message->getType() << 15; $header['meta'] |= $message->getOpCode() << 11; $header['meta'] |= ((int) $message->isAuthoritative()) << 10; $header['meta'] |= ((int) $encodingContext->isTruncated()) << 9; $header['meta'] |= ((int) $message->isRecursionDesired()) << 8; $header['meta'] |= ((int) $message->isRecursionAvailable()) << 7; $header['meta'] |= $message->getResponseCode(); return \pack('n*', $header['id'], $header['meta'], $header['qd'], $header['an'], $header['ns'], $header['ar']); } /** * Encode an Anything field * * @param \LibDNS\Records\Types\Anything $anything * @return string */ private function encodeAnything(Anything $anything): string { return $anything->getValue(); } /** * Encode a BitMap field * * @param \LibDNS\Records\Types\BitMap $bitMap * @return string */ private function encodeBitMap(BitMap $bitMap): string { return $bitMap->getValue(); } /** * Encode a Char field * * @param \LibDNS\Records\Types\Char $char * @return string */ private function encodeChar(Char $char): string { return \chr($char->getValue()); } /** * Encode a CharacterString field * * @param \LibDNS\Records\Types\CharacterString $characterString * @return string */ private function encodeCharacterString(CharacterString $characterString): string { $data = $characterString->getValue(); return \chr(\strlen($data)) . $data; } /** * Encode a DomainName field * * @param \LibDNS\Records\Types\DomainName $domainName * @param \LibDNS\Encoder\EncodingContext $encodingContext * @return string */ private function encodeDomainName(DomainName $domainName, EncodingContext $encodingContext): string { $packetIndex = $encodingContext->getPacket()->getLength() + 12; $labelRegistry = $encodingContext->getLabelRegistry(); $result = ''; $labels = $domainName->getLabels(); if ($encodingContext->useCompression()) { do { $part = \implode('.', $labels); $index = $labelRegistry->lookupIndex($part); if ($index === null) { $labelRegistry->register($part, $packetIndex); $label = \array_shift($labels); $length = \strlen($label); $result .= \chr($length) . $label; $packetIndex += $length + 1; } else { $result .= \pack('n', 0b1100000000000000 | $index); break; } } while($labels); if (!$labels) { $result .= "\x00"; } } else { foreach ($labels as $label) { $result .= \chr(\strlen($label)) . $label; } $result .= "\x00"; } return $result; } /** * Encode an IPv4Address field * * @param \LibDNS\Records\Types\IPv4Address $ipv4Address * @return string */ private function encodeIPv4Address(IPv4Address $ipv4Address): string { $octets = $ipv4Address->getOctets(); return \pack('C*', $octets[0], $octets[1], $octets[2], $octets[3]); } /** * Encode an IPv6Address field * * @param \LibDNS\Records\Types\IPv6Address $ipv6Address * @return string */ private function encodeIPv6Address(IPv6Address $ipv6Address): string { $shorts = $ipv6Address->getShorts(); return \pack('n*', $shorts[0], $shorts[1], $shorts[2], $shorts[3], $shorts[4], $shorts[5], $shorts[6], $shorts[7]); } /** * Encode a Long field * * @param \LibDNS\Records\Types\Long $long * @return string */ private function encodeLong(Long $long): string { return \pack('N', $long->getValue()); } /** * Encode a Short field * * @param \LibDNS\Records\Types\Short $short * @return string */ private function encodeShort(Short $short): string { return \pack('n', $short->getValue()); } /** * Encode a type object * * @param \LibDNS\Encoder\EncodingContext $encodingContext * @param \LibDNS\Records\Types\Type $type * @return string */ private function encodeType(EncodingContext $encodingContext, Type $type): string { if ($type instanceof Anything) { $result = $this->encodeAnything($type); } else if ($type instanceof BitMap) { $result = $this->encodeBitMap($type); } else if ($type instanceof Char) { $result = $this->encodeChar($type); } else if ($type instanceof CharacterString) { $result = $this->encodeCharacterString($type); } else if ($type instanceof DomainName) { $result = $this->encodeDomainName($type, $encodingContext); } else if ($type instanceof IPv4Address) { $result = $this->encodeIPv4Address($type); } else if ($type instanceof IPv6Address) { $result = $this->encodeIPv6Address($type); } else if ($type instanceof Long) { $result = $this->encodeLong($type); } else if ($type instanceof Short) { $result = $this->encodeShort($type); } else { throw new \InvalidArgumentException('Unknown Type ' . \get_class($type)); } return $result; } /** * Encode a question record * * @param \LibDNS\Encoder\EncodingContext $encodingContext * @param \LibDNS\Records\Question $record */ private function encodeQuestionRecord(EncodingContext $encodingContext, Question $record) { if (!$encodingContext->isTruncated()) { $packet = $encodingContext->getPacket(); $name = $this->encodeDomainName($record->getName(), $encodingContext); $meta = \pack('n*', $record->getType(), $record->getClass()); if (12 + $packet->getLength() + \strlen($name) + 4 > 512) { $encodingContext->isTruncated(true); } else { $packet->write($name); $packet->write($meta); } } } /** * Encode a resource record * * @param \LibDNS\Encoder\EncodingContext $encodingContext * @param \LibDNS\Records\Resource $record */ private function encodeResourceRecord(EncodingContext $encodingContext, Resource $record) { if (!$encodingContext->isTruncated()) { $packet = $encodingContext->getPacket(); $name = $this->encodeDomainName($record->getName(), $encodingContext); $data = ''; foreach ($record->getData() as $field) { $data .= $this->encodeType($encodingContext, $field); } $meta = \pack('n2Nn', $record->getType(), $record->getClass(), $record->getTTL(), \strlen($data)); if (12 + $packet->getLength() + \strlen($name) + 10 + \strlen($data) > 512) { $encodingContext->isTruncated(true); } else { $packet->write($name); $packet->write($meta); $packet->write($data); } } } /** * Encode a Message to raw network data * * @param \LibDNS\Messages\Message $message The Message to encode * @param bool $compress Enable message compression * @return string */ public function encode(Message $message, $compress = true): string { $packet = $this->packetFactory->create(); $encodingContext = $this->encodingContextFactory->create($packet, $compress); foreach ($message->getQuestionRecords() as $record) { /** @var \LibDNS\Records\Question $record */ $this->encodeQuestionRecord($encodingContext, $record); } foreach ($message->getAnswerRecords() as $record) { /** @var \LibDNS\Records\Resource $record */ $this->encodeResourceRecord($encodingContext, $record); } foreach ($message->getAuthorityRecords() as $record) { /** @var \LibDNS\Records\Resource $record */ $this->encodeResourceRecord($encodingContext, $record); } foreach ($message->getAdditionalRecords() as $record) { /** @var \LibDNS\Records\Resource $record */ $this->encodeResourceRecord($encodingContext, $record); } return $this->encodeHeader($encodingContext, $message) . $packet->read($packet->getLength()); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Packets; /** * Represents a raw network data packet * * @category LibDNS * @package Packets * @author Chris Wright */ class Packet { /** * @var string */ private $data; /** * @var int Data length */ private $length; /** * @var int Read pointer */ private $pointer = 0; /** * Constructor * * @param string $data The initial packet raw data */ public function __construct(string $data = '') { $this->data = $data; $this->length = \strlen($this->data); } /** * Read bytes from the packet data * * @param int $length The number of bytes to read * @return string * @throws \OutOfBoundsException When the pointer position is invalid or the supplied length is negative */ public function read(int $length = null): string { if ($this->pointer > $this->length) { throw new \OutOfBoundsException('Pointer position invalid'); } if ($length === null) { $result = \substr($this->data, $this->pointer); $this->pointer = $this->length; } else { if ($length < 0) { throw new \OutOfBoundsException('Length must be a positive integer'); } $result = \substr($this->data, $this->pointer, $length); $this->pointer += $length; } return $result; } /** * Append data to the packet * * @param string $data The data to append * @return int The number of bytes written */ public function write(string $data): int { $length = \strlen($data); $this->data .= $data; $this->length += $length; return $length; } /** * Reset the read pointer */ public function reset() { $this->pointer = 0; } /** * Get the pointer index * * @return int */ public function getPointer(): int { return $this->pointer; } /** * Get the data length * * @return int */ public function getLength(): int { return $this->length; } /** * Get the number of remaining bytes from the pointer position * * @return int */ public function getBytesRemaining(): int { return $this->length - $this->pointer; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Packets; /** * Creates Packet objects * * @category LibDNS * @package Packets * @author Chris Wright */ class LabelRegistry { /** * @var int[] Map of labels to indexes */ private $labels = []; /** * @var string[][] Map of indexes to labels */ private $indexes = []; /** * Register a new relationship * * @param string|string[] $labels * @param int $index */ public function register($labels, int $index) { if (\is_array($labels)) { $labelsArr = $labels; $labelsStr = \implode('.', $labels); } else { $labelsArr = \explode('.', $labels); $labelsStr = (string) $labels; } if (!isset($this->labels[$labelsStr]) || $index < $this->labels[$labelsStr]) { $this->labels[$labelsStr] = $index; } $this->indexes[$index] = $labelsArr; } /** * Lookup the index of a label * * @param string $label * @return int|null */ public function lookupIndex(string $label) { return $this->labels[$label] ?? null; } /** * Lookup the label at an index * * @param int $index * @return string[]|null */ public function lookupLabel(int $index) { return $this->indexes[$index] ?? null; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Packets; /** * Creates Packet objects * * @category LibDNS * @package Packets * @author Chris Wright */ class PacketFactory { /** * Create a new Packet object * * @param string $data * @return \LibDNS\Packets\Packet */ public function create(string $data = ''): Packet { return new Packet($data); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Decoder; use \LibDNS\Packets\Packet; use \LibDNS\Packets\LabelRegistry; /** * Creates DecodingContext objects * * @category LibDNS * @package Decoder * @author Chris Wright */ class DecodingContextFactory { /** * Create a new DecodingContext object * * @param \LibDNS\Packets\Packet $packet The packet to be decoded * @return \LibDNS\Decoder\DecodingContext */ public function create(Packet $packet): DecodingContext { return new DecodingContext($packet, new LabelRegistry); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Decoder; use \LibDNS\Packets\Packet; use \LibDNS\Packets\LabelRegistry; /** * Holds data associated with a decode operation * * @category LibDNS * @package Decoder * @author Chris Wright */ class DecodingContext { /** * @var \LibDNS\Packets\Packet */ private $packet; /** * @var \LibDNS\Packets\LabelRegistry */ private $labelRegistry; /** * @var int */ private $expectedQuestionRecords = 0; /** * @var int */ private $expectedAnswerRecords = 0; /** * @var int */ private $expectedAuthorityRecords = 0; /** * @var int */ private $expectedAdditionalRecords = 0; /** * Constructor * * @param \LibDNS\Packets\Packet $packet * @param \LibDNS\Packets\LabelRegistry $labelRegistry */ public function __construct(Packet $packet, LabelRegistry $labelRegistry) { $this->packet = $packet; $this->labelRegistry = $labelRegistry; } /** * Get the packet * * @return \LibDNS\Packets\Packet */ public function getPacket(): Packet { return $this->packet; } /** * Get the label registry * * @return \LibDNS\Packets\LabelRegistry */ public function getLabelRegistry(): LabelRegistry { return $this->labelRegistry; } /** * Get the number of question records expected in the message * * @return int */ public function getExpectedQuestionRecords(): int { return $this->expectedQuestionRecords; } /** * Get the number of question records expected in the message * * @param int $expectedQuestionRecords */ public function setExpectedQuestionRecords(int $expectedQuestionRecords) { $this->expectedQuestionRecords = $expectedQuestionRecords; } /** * Get the number of answer records expected in the message * * @return int */ public function getExpectedAnswerRecords(): int { return $this->expectedAnswerRecords; } /** * Set the number of answer records expected in the message * * @param int $expectedAnswerRecords */ public function setExpectedAnswerRecords(int $expectedAnswerRecords) { $this->expectedAnswerRecords = $expectedAnswerRecords; } /** * Get the number of authority records expected in the message * * @return int */ public function getExpectedAuthorityRecords(): int { return $this->expectedAuthorityRecords; } /** * Set the number of authority records expected in the message * * @param int $expectedAuthorityRecords */ public function setExpectedAuthorityRecords(int $expectedAuthorityRecords) { $this->expectedAuthorityRecords = $expectedAuthorityRecords; } /** * Get the number of additional records expected in the message * * @return int */ public function getExpectedAdditionalRecords(): int { return $this->expectedAdditionalRecords; } /** * Set the number of additional records expected in the message * * @param int $expectedAdditionalRecords */ public function setExpectedAdditionalRecords(int $expectedAdditionalRecords) { $this->expectedAdditionalRecords = $expectedAdditionalRecords; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Decoder; use LibDNS\Messages\Message; use LibDNS\Messages\MessageFactory; use LibDNS\Packets\Packet; use LibDNS\Packets\PacketFactory; use LibDNS\Records\Question; use LibDNS\Records\QuestionFactory; use LibDNS\Records\Resource; use LibDNS\Records\ResourceBuilder; use LibDNS\Records\Types\Anything; use LibDNS\Records\Types\BitMap; use LibDNS\Records\Types\Char; use LibDNS\Records\Types\CharacterString; use LibDNS\Records\Types\DomainName; use LibDNS\Records\Types\IPv4Address; use LibDNS\Records\Types\IPv6Address; use LibDNS\Records\Types\Long; use LibDNS\Records\Types\Short; use LibDNS\Records\Types\Type; use LibDNS\Records\Types\TypeBuilder; use LibDNS\Records\Types\Types; /** * Decodes raw network data to Message objects * * @category LibDNS * @package Decoder * @author Chris Wright */ class Decoder { /** * @var \LibDNS\Packets\PacketFactory */ private $packetFactory; /** * @var \LibDNS\Messages\MessageFactory */ private $messageFactory; /** * @var \LibDNS\Records\QuestionFactory */ private $questionFactory; /** * @var \LibDNS\Records\ResourceBuilder */ private $resourceBuilder; /** * @var \LibDNS\Records\Types\TypeBuilder */ private $typeBuilder; /** * @var \LibDNS\Decoder\DecodingContextFactory */ private $decodingContextFactory; /** * @var bool */ private $allowTrailingData; /** * Constructor * * @param \LibDNS\Packets\PacketFactory $packetFactory * @param \LibDNS\Messages\MessageFactory $messageFactory * @param \LibDNS\Records\QuestionFactory $questionFactory * @param \LibDNS\Records\ResourceBuilder $resourceBuilder * @param \LibDNS\Records\Types\TypeBuilder $typeBuilder * @param \LibDNS\Decoder\DecodingContextFactory $decodingContextFactory * @param bool $allowTrailingData */ public function __construct( PacketFactory $packetFactory, MessageFactory $messageFactory, QuestionFactory $questionFactory, ResourceBuilder $resourceBuilder, TypeBuilder $typeBuilder, DecodingContextFactory $decodingContextFactory, bool $allowTrailingData = true ) { $this->packetFactory = $packetFactory; $this->messageFactory = $messageFactory; $this->questionFactory = $questionFactory; $this->resourceBuilder = $resourceBuilder; $this->typeBuilder = $typeBuilder; $this->decodingContextFactory = $decodingContextFactory; $this->allowTrailingData = $allowTrailingData; } /** * Read a specified number of bytes of data from a packet * * @param \LibDNS\Packets\Packet $packet * @param int $length * @return string * @throws \UnexpectedValueException When the read operation does not result in the requested number of bytes */ private function readDataFromPacket(Packet $packet, int $length): string { if ($packet->getBytesRemaining() < $length) { throw new \UnexpectedValueException('Decode error: Incomplete packet (tried to read ' . $length . ' bytes from index ' . $packet->getPointer()); } return $packet->read($length); } /** * Decode the header section of the message * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @param \LibDNS\Messages\Message $message * @throws \UnexpectedValueException When the header section is invalid */ private function decodeHeader(DecodingContext $decodingContext, Message $message) { $header = \unpack('nid/nmeta/nqd/nan/nns/nar', $this->readDataFromPacket($decodingContext->getPacket(), 12)); if (!$header) { throw new \UnexpectedValueException('Decode error: Header unpack failed'); } $message->setID($header['id']); $message->setType(($header['meta'] & 0b1000000000000000) >> 15); $message->setOpCode(($header['meta'] & 0b0111100000000000) >> 11); $message->isAuthoritative((bool)(($header['meta'] & 0b0000010000000000) >> 10)); $message->isTruncated((bool)(($header['meta'] & 0b0000001000000000) >> 9)); $message->isRecursionDesired((bool)(($header['meta'] & 0b0000000100000000) >> 8)); $message->isRecursionAvailable((bool)(($header['meta'] & 0b0000000010000000) >> 7)); $message->setResponseCode($header['meta'] & 0b0000000000001111); $decodingContext->setExpectedQuestionRecords($header['qd']); $decodingContext->setExpectedAnswerRecords($header['an']); $decodingContext->setExpectedAuthorityRecords($header['ns']); $decodingContext->setExpectedAdditionalRecords($header['ar']); } /** * Decode an Anything field * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @param \LibDNS\Records\Types\Anything $anything The object to populate with the result * @param int $length * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeAnything(DecodingContext $decodingContext, Anything $anything, int $length): int { $anything->setValue($this->readDataFromPacket($decodingContext->getPacket(), $length)); return $length; } /** * Decode a BitMap field * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @param \LibDNS\Records\Types\BitMap $bitMap The object to populate with the result * @param int $length * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeBitMap(DecodingContext $decodingContext, BitMap $bitMap, int $length): int { $bitMap->setValue($this->readDataFromPacket($decodingContext->getPacket(), $length)); return $length; } /** * Decode a Char field * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @param \LibDNS\Records\Types\Char $char The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeChar(DecodingContext $decodingContext, Char $char): int { $value = \unpack('C', $this->readDataFromPacket($decodingContext->getPacket(), 1))[1]; $char->setValue($value); return 1; } /** * Decode a CharacterString field * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @param \LibDNS\Records\Types\CharacterString $characterString The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeCharacterString(DecodingContext $decodingContext, CharacterString $characterString): int { $packet = $decodingContext->getPacket(); $length = \ord($this->readDataFromPacket($packet, 1)); $characterString->setValue($this->readDataFromPacket($packet, $length)); return $length + 1; } /** * Decode a DomainName field * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @param \LibDNS\Records\Types\DomainName $domainName The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeDomainName(DecodingContext $decodingContext, DomainName $domainName): int { $packet = $decodingContext->getPacket(); $startIndex = '0x' . \dechex($packet->getPointer()); $labelRegistry = $decodingContext->getLabelRegistry(); $labels = []; $totalLength = 0; while (++$totalLength && $length = \ord($this->readDataFromPacket($packet, 1))) { $labelType = $length & 0b11000000; if ($labelType === 0b00000000) { $index = $packet->getPointer() - 1; $label = $this->readDataFromPacket($packet, $length); \array_unshift($labels, [$index, $label]); $totalLength += $length; } else if ($labelType === 0b11000000) { $index = (($length & 0b00111111) << 8) | \ord($this->readDataFromPacket($packet, 1)); $ref = $labelRegistry->lookupLabel($index); if ($ref === null) { throw new \UnexpectedValueException('Decode error: Invalid compression pointer reference in domain name at position ' . $startIndex); } \array_unshift($labels, $ref); $totalLength++; break; } else { throw new \UnexpectedValueException('Decode error: Invalid label type ' . $labelType . 'in domain name at position ' . $startIndex); } } $result = []; foreach ($labels as $label) { if (\is_int($label[0])) { \array_unshift($result, $label[1]); $labelRegistry->register($result, $label[0]); } else { $result = $label; } } $domainName->setLabels($result); return $totalLength; } /** * Decode an IPv4Address field * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @param \LibDNS\Records\Types\IPv4Address $ipv4Address The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeIPv4Address(DecodingContext $decodingContext, IPv4Address $ipv4Address): int { $octets = \unpack('C4', $this->readDataFromPacket($decodingContext->getPacket(), 4)); $ipv4Address->setOctets($octets); return 4; } /** * Decode an IPv6Address field * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @param \LibDNS\Records\Types\IPv6Address $ipv6Address The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeIPv6Address(DecodingContext $decodingContext, IPv6Address $ipv6Address): int { $shorts = \unpack('n8', $this->readDataFromPacket($decodingContext->getPacket(), 16)); $ipv6Address->setShorts($shorts); return 16; } /** * Decode a Long field * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @param \LibDNS\Records\Types\Long $long The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeLong(DecodingContext $decodingContext, Long $long): int { $value = \unpack('N', $this->readDataFromPacket($decodingContext->getPacket(), 4))[1]; $long->setValue($value); return 4; } /** * Decode a Short field * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @param \LibDNS\Records\Types\Short $short The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeShort(DecodingContext $decodingContext, Short $short): int { $value = \unpack('n', $this->readDataFromPacket($decodingContext->getPacket(), 2))[1]; $short->setValue($value); return 2; } /** * Decode a Type field * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @param \LibDNS\Records\Types\Type $type The object to populate with the result * @param int $length Expected data length * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid * @throws \InvalidArgumentException When the Type subtype is unknown */ private function decodeType(DecodingContext $decodingContext, Type $type, int $length): int { if ($type instanceof Anything) { $result = $this->decodeAnything($decodingContext, $type, $length); } else if ($type instanceof BitMap) { $result = $this->decodeBitMap($decodingContext, $type, $length); } else if ($type instanceof Char) { $result = $this->decodeChar($decodingContext, $type); } else if ($type instanceof CharacterString) { $result = $this->decodeCharacterString($decodingContext, $type); } else if ($type instanceof DomainName) { $result = $this->decodeDomainName($decodingContext, $type); } else if ($type instanceof IPv4Address) { $result = $this->decodeIPv4Address($decodingContext, $type); } else if ($type instanceof IPv6Address) { $result = $this->decodeIPv6Address($decodingContext, $type); } else if ($type instanceof Long) { $result = $this->decodeLong($decodingContext, $type); } else if ($type instanceof Short) { $result = $this->decodeShort($decodingContext, $type); } else { throw new \InvalidArgumentException('Unknown Type ' . \get_class($type)); } return $result; } /** * Decode a question record * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @return \LibDNS\Records\Question * @throws \UnexpectedValueException When the record is invalid */ private function decodeQuestionRecord(DecodingContext $decodingContext): Question { /** @var \LibDNS\Records\Types\DomainName $domainName */ $domainName = $this->typeBuilder->build(Types::DOMAIN_NAME); $this->decodeDomainName($decodingContext, $domainName); $meta = \unpack('ntype/nclass', $this->readDataFromPacket($decodingContext->getPacket(), 4)); $question = $this->questionFactory->create($meta['type']); $question->setName($domainName); $question->setClass($meta['class']); return $question; } /** * Decode a resource record * * @param \LibDNS\Decoder\DecodingContext $decodingContext * @return \LibDNS\Records\Resource * @throws \UnexpectedValueException When the record is invalid * @throws \InvalidArgumentException When a type subtype is unknown */ private function decodeResourceRecord(DecodingContext $decodingContext): Resource { /** @var \LibDNS\Records\Types\DomainName $domainName */ $domainName = $this->typeBuilder->build(Types::DOMAIN_NAME); $this->decodeDomainName($decodingContext, $domainName); $meta = \unpack('ntype/nclass/Nttl/nlength', $this->readDataFromPacket($decodingContext->getPacket(), 10)); $resource = $this->resourceBuilder->build($meta['type']); $resource->setName($domainName); $resource->setClass($meta['class']); $resource->setTTL($meta['ttl']); $data = $resource->getData(); $remainingLength = $meta['length']; $fieldDef = $index = null; foreach ($resource->getData()->getTypeDefinition() as $index => $fieldDef) { $field = $this->typeBuilder->build($fieldDef->getType()); $remainingLength -= $this->decodeType($decodingContext, $field, $remainingLength); $data->setField($index, $field); } if ($fieldDef->allowsMultiple()) { while ($remainingLength) { $field = $this->typeBuilder->build($fieldDef->getType()); $remainingLength -= $this->decodeType($decodingContext, $field, $remainingLength); $data->setField(++$index, $field); } } if ($remainingLength !== 0) { throw new \UnexpectedValueException('Decode error: Invalid length for record data section'); } return $resource; } /** * Decode a Message from raw network data * * @param string $data The data string to decode * @return \LibDNS\Messages\Message * @throws \UnexpectedValueException When the packet data is invalid * @throws \InvalidArgumentException When a type subtype is unknown */ public function decode(string $data): Message { $packet = $this->packetFactory->create($data); $decodingContext = $this->decodingContextFactory->create($packet); $message = $this->messageFactory->create(); $this->decodeHeader($decodingContext, $message); $questionRecords = $message->getQuestionRecords(); $expected = $decodingContext->getExpectedQuestionRecords(); for ($i = 0; $i < $expected; $i++) { $questionRecords->add($this->decodeQuestionRecord($decodingContext)); } $answerRecords = $message->getAnswerRecords(); $expected = $decodingContext->getExpectedAnswerRecords(); for ($i = 0; $i < $expected; $i++) { $answerRecords->add($this->decodeResourceRecord($decodingContext)); } $authorityRecords = $message->getAuthorityRecords(); $expected = $decodingContext->getExpectedAuthorityRecords(); for ($i = 0; $i < $expected; $i++) { $authorityRecords->add($this->decodeResourceRecord($decodingContext)); } $additionalRecords = $message->getAdditionalRecords(); $expected = $decodingContext->getExpectedAdditionalRecords(); for ($i = 0; $i < $expected; $i++) { $additionalRecords->add($this->decodeResourceRecord($decodingContext)); } if (!$this->allowTrailingData && $packet->getBytesRemaining() !== 0) { throw new \UnexpectedValueException('Decode error: Unexpected data at end of packet'); } return $message; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Decoder; use \LibDNS\Packets\PacketFactory; use \LibDNS\Messages\MessageFactory; use \LibDNS\Records\RecordCollectionFactory; use \LibDNS\Records\QuestionFactory; use \LibDNS\Records\ResourceBuilder; use \LibDNS\Records\ResourceFactory; use \LibDNS\Records\RDataBuilder; use \LibDNS\Records\RDataFactory; use \LibDNS\Records\Types\TypeBuilder; use \LibDNS\Records\Types\TypeFactory; use \LibDNS\Records\TypeDefinitions\TypeDefinitionManager; use \LibDNS\Records\TypeDefinitions\TypeDefinitionFactory; use \LibDNS\Records\TypeDefinitions\FieldDefinitionFactory; /** * Creates Decoder objects * * @category LibDNS * @package Decoder * @author Chris Wright */ class DecoderFactory { /** * Create a new Decoder object * * @param \LibDNS\Records\TypeDefinitions\TypeDefinitionManager $typeDefinitionManager * @param bool $allowTrailingData * @return Decoder */ public function create(TypeDefinitionManager $typeDefinitionManager = null, bool $allowTrailingData = true): Decoder { $typeBuilder = new TypeBuilder(new TypeFactory); return new Decoder( new PacketFactory, new MessageFactory(new RecordCollectionFactory), new QuestionFactory, new ResourceBuilder( new ResourceFactory, new RDataBuilder( new RDataFactory, $typeBuilder ), $typeDefinitionManager ?: new TypeDefinitionManager( new TypeDefinitionFactory, new FieldDefinitionFactory ) ), $typeBuilder, new DecodingContextFactory, $allowTrailingData ); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Enumeration; /** * Enumeration of possible resource TYPE values * * @category LibDNS * @package Records * @author Chris Wright */ abstract class ResourceTypes extends Enumeration { const A = 1; const AAAA = 28; const AFSDB = 18; // const APL = 42; const CAA = 257; const CERT = 37; const CNAME = 5; const DHCID = 49; const DLV = 32769; const DNAME = 39; const DNSKEY = 48; const DS = 43; const HINFO = 13; // const HIP = 55; // const IPSECKEY = 45; const KEY = 25; const KX = 36; const ISDN = 20; const LOC = 29; const MB = 7; const MD = 3; const MF = 4; const MG = 8; const MINFO = 14; const MR = 9; const MX = 15; const NAPTR = 35; const NS = 2; // const NSEC = 47; // const NSEC3 = 50; // const NSEC3PARAM = 50; const NULL = 10; const PTR = 12; const RP = 17; // const RRSIG = 46; const RT = 21; const SIG = 24; const SOA = 6; const SPF = 99; const SRV = 33; const TXT = 16; const WKS = 11; const X25 = 19; } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Records\Types\Type; use \LibDNS\Records\TypeDefinitions\TypeDefinition; /** * Represents a data type comprising multiple simple types * * @category LibDNS * @package Records * @author Chris Wright */ class RData implements \IteratorAggregate, \Countable { /** * @var \LibDNS\Records\Types\Type[] The items that make up the complex type */ private $fields = []; /** * @var \LibDNS\Records\TypeDefinitions\TypeDefinition Structural definition of the fields */ private $typeDef; /** * Constructor * * @param \LibDNS\Records\TypeDefinitions\TypeDefinition $typeDef */ public function __construct(TypeDefinition $typeDef) { $this->typeDef = $typeDef; } /** * Magic method for type coersion to string * * @return string */ public function __toString() { if ($handler = $this->typeDef->getToStringFunction()) { $result = \call_user_func_array($handler, $this->fields); } else { $result = \implode(',', $this->fields); } return $result; } /** * Get the field indicated by the supplied index * * @param int $index * @return \LibDNS\Records\Types\Type * @throws \OutOfBoundsException When the supplied index does not refer to a valid field */ public function getField(int $index) { if (!isset($this->fields[$index])) { throw new \OutOfBoundsException('Index ' . $index . ' does not refer to a valid field'); } return $this->fields[$index]; } /** * Set the field indicated by the supplied index * * @param int $index * @param \LibDNS\Records\Types\Type $value * @throws \InvalidArgumentException When the supplied index/value pair does not match the type definition */ public function setField(int $index, Type $value) { if (!$this->typeDef->getFieldDefinition($index)->assertDataValid($value)) { throw new \InvalidArgumentException('The supplied value is not valid for the specified index'); } $this->fields[$index] = $value; } /** * Get the field indicated by the supplied name * * @param string $name * @return \LibDNS\Records\Types\Type * @throws \OutOfBoundsException When the supplied name does not refer to a valid field */ public function getFieldByName(string $name): Type { return $this->getField($this->typeDef->getFieldIndexByName($name)); } /** * Set the field indicated by the supplied name * * @param string $name * @param \LibDNS\Records\Types\Type $value * @throws \OutOfBoundsException When the supplied name does not refer to a valid field * @throws \InvalidArgumentException When the supplied value does not match the type definition */ public function setFieldByName(string $name, Type $value) { $this->setField($this->typeDef->getFieldIndexByName($name), $value); } /** * Get the structural definition of the fields * * @return \LibDNS\Records\TypeDefinitions\TypeDefinition */ public function getTypeDefinition(): TypeDefinition { return $this->typeDef; } /** * Retrieve an iterator (IteratorAggregate interface) * * @return \Iterator */ public function getIterator(): \Iterator { return new \ArrayIterator($this->fields); } /** * Get the number of fields (Countable interface) * * @return int */ public function count(): int { return \count($this->fields); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Records\TypeDefinitions\TypeDefinitionManager; /** * Builds Resource objects of a specific type * * @category LibDNS * @package Records * @author Chris Wright */ class ResourceBuilder { /** * @var \LibDNS\Records\ResourceFactory */ private $resourceFactory; /** * @var \LibDNS\Records\RDataBuilder */ private $rDataBuilder; /** * @var \LibDNS\Records\TypeDefinitions\TypeDefinitionManager */ private $typeDefinitionManager; /** * Constructor * * @param \LibDNS\Records\ResourceFactory $resourceFactory * @param \LibDNS\Records\RDataBuilder $rDataBuilder * @param \LibDNS\Records\TypeDefinitions\TypeDefinitionManager $typeDefinitionManager */ public function __construct(ResourceFactory $resourceFactory, RDataBuilder $rDataBuilder, TypeDefinitionManager $typeDefinitionManager) { $this->resourceFactory = $resourceFactory; $this->rDataBuilder = $rDataBuilder; $this->typeDefinitionManager = $typeDefinitionManager; } /** * Create a new Resource object * * @param int $type Type of the resource, can be indicated using the ResourceTypes enum * @return \LibDNS\Records\Resource */ public function build(int $type): Resource { $typeDefinition = $this->typeDefinitionManager->getTypeDefinition($type); $rData = $this->rDataBuilder->build($typeDefinition); return $this->resourceFactory->create($type, $rData); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; /** * Creates RecordCollection objects * * @category LibDNS * @package Records * @author Chris Wright */ class RecordCollectionFactory { /** * Create a new RecordCollection object * * @param int $type Can be indicated using the RecordTypes enum * @return \LibDNS\Records\RecordCollection * @throws \InvalidArgumentException When the specified record type is invalid */ public function create(int $type): RecordCollection { return new RecordCollection($type); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Records\Types\TypeFactory; /** * Represents a DNS question record * * @category LibDNS * @package Records * @author Chris Wright */ class Question extends Record { /** * Constructor * * @param \LibDNS\Records\Types\TypeFactory $typeFactory * @param int $type Resource type being requested, can be indicated using the ResourceQTypes enum */ public function __construct(TypeFactory $typeFactory, int $type) { $this->typeFactory = $typeFactory; $this->type = $type; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; use \LibDNS\Enumeration; /** * Enumeration of simple data types * * @category LibDNS * @package Types * @author Chris Wright */ final class Types extends Enumeration { const ANYTHING = 0b000000001; const BITMAP = 0b000000010; const CHAR = 0b000000100; const CHARACTER_STRING = 0b000001000; const DOMAIN_NAME = 0b000010000; const IPV4_ADDRESS = 0b000100000; const IPV6_ADDRESS = 0b001000000; const LONG = 0b010000000; const SHORT = 0b100000000; } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Represents a bit map * * @category LibDNS * @package Types * @author Chris Wright */ class BitMap extends Type { /** * @var string */ protected $value = ''; /** * Set the internal value * * @param string $value The new value */ public function setValue($value) { $this->value = (string)$value; } /** * Inspect the value of the bit at the specific index and optionally set a new value * * @param int $index * @param bool $newValue The new value * @return bool The old value */ public function isBitSet(int $index, bool $newValue = null): bool { $charIndex = (int)($index / 8); $bitMask = 0b10000000 >> ($index % 8); $result = false; if (isset($this->value[$charIndex])) { $result = (bool) (\ord($this->value[$charIndex]) & $bitMask); } if (isset($newValue) && $newValue != $result) { if (!isset($this->value[$charIndex])) { $this->value = \str_pad($this->value, $charIndex + 1, "\x00", STR_PAD_RIGHT); } $this->value[$charIndex] = \chr((\ord($this->value[$charIndex]) & ~$bitMask) | ($newValue ? $bitMask : 0)); } return $result; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Represents an 8-bit unsigned integer * * @category LibDNS * @package Types * @author Chris Wright */ class Char extends Type { /** * @var int */ protected $value = 0; /** * Set the internal value * * @param string $value The new value * @throws \UnderflowException When the supplied value is less than 0 * @throws \OverflowException When the supplied value is greater than 255 */ public function setValue($value) { $value = (int) $value; if ($value < 0) { throw new \UnderflowException('Char value must be in the range 0 - 255'); } else if ($value > 255) { throw new \OverflowException('Char value must be in the range 0 - 255'); } $this->value = $value; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Represents a 16-bit unsigned integer * * @category LibDNS * @package Types * @author Chris Wright */ class Short extends Type { /** * @var int */ protected $value = 0; /** * Set the internal value * * @param string $value The new value * @throws \UnderflowException When the supplied value is less than 0 * @throws \OverflowException When the supplied value is greater than 65535 */ public function setValue($value) { $value = (int)$value; if ($value < 0) { throw new \UnderflowException('Short integer value must be in the range 0 - 65535'); } else if ($value > 0xffff) { throw new \OverflowException('Short integer value must be in the range 0 - 65535'); } $this->value = $value; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Base class for simple data types * * @category LibDNS * @package Types * @author Chris Wright */ abstract class Type { /** * @var mixed The internal value */ protected $value; /** * Constructor * * @param string $value Internal value * @throws \RuntimeException When the supplied value is invalid */ public function __construct(string $value = null) { if (isset($value)) { $this->setValue($value); } } /** * Magic method for type coercion to string * * @return string */ public function __toString(): string { return (string) $this->value; } /** * Get the internal value * * @return mixed */ public function getValue() { return $this->value; } /** * Set the internal value * * @param string $value The new value * @throws \RuntimeException When the supplied value is invalid */ abstract public function setValue($value); } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Represents a 32-bit unsigned integer * * @category LibDNS * @package Types * @author Chris Wright */ class Long extends Type { /** * @var int */ protected $value = 0; /** * Set the internal value * * @param string $value The new value * @throws \UnderflowException When the supplied value is less than 0 * @throws \OverflowException When the supplied value is greater than 4294967296 */ public function setValue($value) { $value = (int)$value; if (\PHP_INT_SIZE > 4) { if ($value < 0) { throw new \UnderflowException('Long integer value must be in the range 0 - 4294967296'); } else if ($value > 0xffffffff) { throw new \OverflowException('Long integer value must be in the range 0 - 4294967296'); } } $this->value = $value; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Creates Type objects * * @category LibDNS * @package Types * @author Chris Wright */ class TypeFactory { /** * Create a new Anything object * * @param string $value * @return \LibDNS\Records\Types\Anything */ public function createAnything(string $value = null) { return new Anything($value); } /** * Create a new BitMap object * * @param string $value * @return \LibDNS\Records\Types\BitMap */ public function createBitMap(string $value = null) { return new BitMap($value); } /** * Create a new Char object * * @param int $value * @return \LibDNS\Records\Types\Char */ public function createChar(int $value = null) { return new Char((string)$value); } /** * Create a new CharacterString object * * @param string $value * @return \LibDNS\Records\Types\CharacterString */ public function createCharacterString(string $value = null) { return new CharacterString($value); } /** * Create a new DomainName object * * @param string|string[] $value * @return \LibDNS\Records\Types\DomainName */ public function createDomainName($value = null) { return new DomainName($value); } /** * Create a new IPv4Address object * * @param string|int[] $value * @return \LibDNS\Records\Types\IPv4Address */ public function createIPv4Address($value = null) { return new IPv4Address($value); } /** * Create a new IPv6Address object * * @param string|int[] $value * @return \LibDNS\Records\Types\IPv6Address */ public function createIPv6Address($value = null) { return new IPv6Address($value); } /** * Create a new Long object * * @param int $value * @return \LibDNS\Records\Types\Long */ public function createLong(int $value = null) { return new Long((string)$value); } /** * Create a new Short object * * @param int $value * @return \LibDNS\Records\Types\Short */ public function createShort(int $value = null) { return new Short((string)$value); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Builds Types from type definitions * * @category LibDNS * @package Types * @author Chris Wright */ class TypeBuilder { /** * @var \LibDNS\Records\Types\TypeFactory */ private $typeFactory; /** * Constructor * * @param \LibDNS\Records\Types\TypeFactory $typeFactory */ public function __construct(TypeFactory $typeFactory) { $this->typeFactory = $typeFactory; } /** * Build a new Type object corresponding to a resource record type * * @param int $type Data type, can be indicated using the Types enum * @return \LibDNS\Records\Types\Type */ public function build(int $type): Type { static $typeMap = [ Types::ANYTHING => 'createAnything', Types::BITMAP => 'createBitMap', Types::CHAR => 'createChar', Types::CHARACTER_STRING => 'createCharacterString', Types::DOMAIN_NAME => 'createDomainName', Types::IPV4_ADDRESS => 'createIPv4Address', Types::IPV6_ADDRESS => 'createIPv6Address', Types::LONG => 'createLong', Types::SHORT => 'createShort', ]; if (!isset($typeMap[$type])) { throw new \InvalidArgumentException('Invalid Type identifier ' . $type); } return $this->typeFactory->{$typeMap[$type]}(); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Represents an IPv6 address * * @category LibDNS * @package Types * @author Chris Wright */ class IPv6Address extends Type { /** * @var string */ protected $value = '::'; /** * @var int[] The shorts of the address */ private $shorts = [0, 0, 0, 0, 0, 0, 0, 0]; /** * Create a compressed string representation of an IPv6 address * * @param int[] $shorts Address shorts * @return string */ private function createCompressedString($shorts) { $compressLen = $compressPos = $currentLen = $currentPos = 0; $inBlock = false; for ($i = 0; $i < 8; $i++) { if ($shorts[$i] === 0) { if (!$inBlock) { $inBlock = true; $currentPos = $i; } $currentLen++; } else if ($inBlock) { if ($currentLen > $compressLen) { $compressLen = $currentLen; $compressPos = $currentPos; } $inBlock = false; $currentPos = $currentLen = 0; } $shorts[$i] = \dechex($shorts[$i]); } if ($inBlock) { $compressLen = $currentLen; $compressPos = $currentPos; } if ($compressLen > 1) { if ($compressLen === 8) { $replace = ['', '', '']; } else if ($compressPos === 0 || $compressPos + $compressLen === 8) { $replace = ['', '']; } else { $replace = ['']; } \array_splice($shorts, $compressPos, $compressLen, $replace); } return \implode(':', $shorts); } /** * Constructor * * @param string|int[] $value String representation or shorts list * @throws \UnexpectedValueException When the supplied value is not a valid IPv6 address */ public function __construct($value = null) { if (\is_array($value)) { $this->setShorts($value); } else { parent::__construct($value); } } /** * Set the internal value * * @param string $value The new value * @throws \UnexpectedValueException When the supplied value is outside the valid length range 0 - 65535 */ public function setValue($value) { $shorts = \explode(':', (string)$value); $count = \count($shorts); if ($count < 3 || $count > 8) { throw new \UnexpectedValueException('Value is not a valid IPv6 address: invalid short count'); } else if ($shorts[0] === '' && $shorts[1] === '') { $shorts = \array_pad($shorts, -8, '0'); } else if ($shorts[$count - 2] === '' && $shorts[$count - 1] === '') { $shorts = \array_pad($shorts, 8, '0'); } else if (false !== $pos = \array_search('', $shorts, true)) { \array_splice($shorts, $pos, 1, \array_fill(0, 8 - ($count - 1), '0')); } $this->setShorts(\array_map('hexdec', $shorts)); } /** * Get the address shorts * * @return int[] */ public function getShorts(): array { return $this->shorts; } /** * Set the address shorts * * @param int[] $shorts The new address shorts * @throws \UnexpectedValueException When the supplied short list is not a valid IPv6 address */ public function setShorts(array $shorts) { if (\count($shorts) !== 8) { throw new \UnexpectedValueException('Short list is not a valid IPv6 address: invalid short count'); } foreach ($shorts as &$short) { if ((!\is_int($short) && !\ctype_digit((string)$short)) || $short < 0x0000 || $short > 0xffff) { throw new \UnexpectedValueException('Short list is not a valid IPv6 address: invalid short value ' . $short); } $short = (int) $short; } $this->shorts = \array_values($shorts); $this->value = $this->createCompressedString($this->shorts); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Represents a fully qualified domain name * * @category LibDNS * @package Types * @author Chris Wright */ class DomainName extends Type { const FLAG_NO_COMPRESSION = \PHP_INT_SIZE === 4 ? -2147483648 : 0x80000000; /** * @var string */ protected $value = ''; /** * @var string[] The value as a list of labels */ private $labels = []; /** * Constructor * * @param string|string[] $value * @throws \UnexpectedValueException When the supplied value is not a valid domain name */ public function __construct($value = null) { if (\is_array($value)) { $this->setLabels($value); } else { parent::__construct($value); } } /** * Set the internal value * * @param string $value The new value * @throws \UnexpectedValueException When the supplied value is not a valid domain name */ public function setValue($value) { $this->setLabels(\explode('.', (string)$value)); } /** * Get the domain name labels * * @param bool $tldFirst Whether to return the label list ordered with the TLD label first * @return string[] */ public function getLabels($tldFirst = false): array { return $tldFirst ? \array_reverse($this->labels) : $this->labels; } /** * Set the domain name labels * * @param string[] $labels The new label list * @param bool $tldFirst Whether the supplied label list is ordered with the TLD label first * @throws \UnexpectedValueException When the supplied label list is not a valid domain name */ public function setLabels(array $labels, $tldFirst = false) { if (!$labels) { $this->labels = []; $this->value = ''; return; } $length = $count = 0; foreach ($labels as &$label) { $label = \LibDNS\normalize_name($label); $labelLength = \strlen($label); if ($labelLength > 63) { throw new \InvalidArgumentException('Label list is not a valid domain name: Label ' . $label . ' length exceeds 63 byte limit'); } $length += $labelLength + 1; $count++; } $tld = $tldFirst ? $labels[0] : $labels[$count - 1]; if ($tld === '') { $length--; } if ($length + 1 > 255) { throw new \InvalidArgumentException('Label list is not a valid domain name: Total length exceeds 255 byte limit'); } $this->labels = $tldFirst ? \array_reverse($labels) : $labels; $this->value = \implode('.', $this->labels); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Represents an IPv4 address * * @category LibDNS * @package Types * @author Chris Wright */ class IPv4Address extends Type { /** * @var string */ protected $value = '0.0.0.0'; /** * @var int[] The octets of the address */ private $octets = [0, 0, 0, 0]; /** * Constructor * * @param string|int[] $value String representation or octet list * @throws \UnexpectedValueException When the supplied value is not a valid IPv4 address */ public function __construct($value = null) { if (\is_array($value)) { $this->setOctets($value); } else { parent::__construct($value); } } /** * Set the internal value * * @param string $value The new value * @throws \UnexpectedValueException When the supplied value is outside the valid length range 0 - 65535 */ public function setValue($value) { $this->setOctets(\explode('.', (string)$value)); } /** * Get the address octets * * @return int[] */ public function getOctets(): array { return $this->octets; } /** * Set the address octets * * @param int[] $octets The new address octets * @throws \UnexpectedValueException When the supplied octet list is not a valid IPv4 address */ public function setOctets(array $octets) { if (\count($octets) !== 4) { throw new \UnexpectedValueException('Octet list is not a valid IPv4 address: invalid octet count'); } foreach ($octets as &$octet) { if ((!\is_int($octet) && !\ctype_digit((string)$octet)) || $octet < 0x00 || $octet > 0xff) { throw new \UnexpectedValueException('Octet list is not a valid IPv4 address: invalid octet value ' . $octet); } $octet = (int) $octet; } $this->octets = \array_values($octets); $this->value = \implode('.', $this->octets); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Represents a generic binary data string * * @category LibDNS * @package Types * @author Chris Wright */ class Anything extends Type { /** * @var string */ protected $value = ''; /** * Set the internal value * * @param string $value The new value * @throws \UnexpectedValueException When the supplied value is outside the valid length range 0 - 65535 */ public function setValue($value) { $value = (string)$value; if (\strlen($value) > 65535) { throw new \UnexpectedValueException('Untyped string length must be in the range 0 - 65535'); } $this->value = $value; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\Types; /** * Represents a binary character string * * @category LibDNS * @package Types * @author Chris Wright */ class CharacterString extends Type { /** * @var string */ protected $value = ''; /** * Set the internal value * * @param string $value The new value * @throws \UnexpectedValueException When the supplied value is outside the valid length range 0 - 255 */ public function setValue($value) { $value = (string)$value; if (\strlen($value) > 255) { throw new \UnexpectedValueException('Character string length must be in the range 0 - 255'); } $this->value = $value; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Records\Types\TypeBuilder; use \LibDNS\Records\Types\TypeFactory; use \LibDNS\Records\TypeDefinitions\TypeDefinitionManager; use \LibDNS\Records\TypeDefinitions\TypeDefinitionFactory; use \LibDNS\Records\TypeDefinitions\FieldDefinitionFactory; /** * Creates ResourceBuilder objects * * @category LibDNS * @package Records * @author Chris Wright */ class ResourceBuilderFactory { /** * Create a new ResourceBuilder object * * @param \LibDNS\Records\TypeDefinitions\TypeDefinitionManager $typeDefinitionManager * @return \LibDNS\Records\ResourceBuilder */ public function create(TypeDefinitionManager $typeDefinitionManager = null): ResourceBuilder { return new ResourceBuilder( new ResourceFactory, new RDataBuilder( new RDataFactory, new TypeBuilder(new TypeFactory) ), $typeDefinitionManager ?: new TypeDefinitionManager( new TypeDefinitionFactory, new FieldDefinitionFactory ) ); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Records\TypeDefinitions\TypeDefinition; /** * Creates RData objects * * @category LibDNS * @package Records * @author Chris Wright */ class RDataFactory { /** * Create a new RData object * * @param \LibDNS\Records\TypeDefinitions\TypeDefinition $typeDefinition * @return \LibDNS\Records\RData */ public function create(TypeDefinition $typeDefinition): RData { return new RData($typeDefinition); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Records\Types\TypeFactory; /** * Represents a DNS resource record * * @category LibDNS * @package Records * @author Chris Wright */ class Resource extends Record { /** * @var int Value of the resource's time-to-live property */ private $ttl; /** * @var \LibDNS\Records\RData */ private $data; /** * Constructor * * @param \LibDNS\Records\Types\TypeFactory $typeFactory * @param int $type Can be indicated using the ResourceTypes enum * @param \LibDNS\Records\RData $data */ public function __construct(TypeFactory $typeFactory, int $type, RData $data) { $this->typeFactory = $typeFactory; $this->type = $type; $this->data = $data; } /** * Get the value of the record TTL field * * @return int */ public function getTTL(): int { return $this->ttl; } /** * Set the value of the record TTL field * * @param int $ttl The new value * @throws \RangeException When the supplied value is outside the valid range 0 - 4294967296 */ public function setTTL(int $ttl) { if ($ttl < 0 || $ttl > 4294967296) { throw new \RangeException('Record class must be in the range 0 - 4294967296'); } $this->ttl = $ttl; } /** * Get the value of the resource data field * * @return \LibDNS\Records\RData */ public function getData(): RData { return $this->data; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\TypeDefinitions; /** * Defines a data type comprising multiple fields * * @category LibDNS * @package TypeDefinitions * @author Chris Wright */ class TypeDefinition implements \IteratorAggregate, \Countable { /** * @var FieldDefinitionFactory Creates FieldDefinition objects */ private $fieldDefFactory; /** * @var int Number of fields in the type */ private $fieldCount; /** * @var \LibDNS\Records\TypeDefinitions\FieldDefinition The last field defined by the type */ private $lastField; /** * @var int[] Map of field indexes to type identifiers */ private $fieldDefs = []; /** * @var int[] Map of field names to indexes */ private $fieldNameMap = []; /** * @var callable Custom implementation for __toString() handling */ private $toStringFunction; /** * Constructor * * @param FieldDefinitionFactory $fieldDefFactory * @param array $definition Structural definition of the fields * @throws \InvalidArgumentException When the type definition is invalid */ public function __construct(FieldDefinitionFactory $fieldDefFactory, array $definition) { $this->fieldDefFactory = $fieldDefFactory; if (isset($definition['__toString'])) { if (!\is_callable($definition['__toString'])) { throw new \InvalidArgumentException('Invalid type definition: __toString() implementation is not callable'); } $this->toStringFunction = $definition['__toString']; unset($definition['__toString']); } $this->fieldCount = \count($definition); $index = 0; foreach ($definition as $name => $type) { $this->registerField($index++, $name, $type); } } /** * Register a field from the type definition * * @param int $index * @param string $name * @param int $type * @throws \InvalidArgumentException When the field definition is invalid */ private function registerField(int $index, string $name, int $type) { if (!\preg_match('/^(?P[\w\-]+)(?P\+|\*)?(?P(?<=\+)\d+)?$/', \strtolower($name), $matches)) { throw new \InvalidArgumentException('Invalid field definition ' . $name . ': Syntax error'); } if (isset($matches['quantifier'])) { if ($index !== $this->fieldCount - 1) { throw new \InvalidArgumentException('Invalid field definition ' . $name . ': Quantifiers only allowed in last field'); } if (!isset($matches['minimum'])) { $matches['minimum'] = $matches['quantifier'] === '+' ? 1 : 0; } $allowsMultiple = true; $minimumValues = (int) $matches['minimum']; } else { $allowsMultiple = false; $minimumValues = 0; } $this->fieldDefs[$index] = $this->fieldDefFactory->create($index, $matches['name'], $type, $allowsMultiple, $minimumValues); if ($index === $this->fieldCount - 1) { $this->lastField = $this->fieldDefs[$index]; } $this->fieldNameMap[$matches['name']] = $index; } /** * Get the field definition indicated by the supplied index * * @param int $index * @return \LibDNS\Records\TypeDefinitions\FieldDefinition * @throws \OutOfBoundsException When the supplied index does not refer to a valid field */ public function getFieldDefinition(int $index): FieldDefinition { if (isset($this->fieldDefs[$index])) { $fieldDef = $this->fieldDefs[$index]; } else if ($index >= 0 && $this->lastField->allowsMultiple()) { $fieldDef = $this->lastField; } else { throw new \OutOfBoundsException('Index ' . $index . ' does not refer to a valid field'); } return $fieldDef; } /** * Get the field index indicated by the supplied name * * @param string $name * @return int * @throws \OutOfBoundsException When the supplied name does not refer to a valid field */ public function getFieldIndexByName($name): int { $fieldName = \strtolower($name); if (!isset($this->fieldNameMap[$fieldName])) { throw new \OutOfBoundsException('Name ' . $name . ' does not refer to a valid field'); } return $this->fieldNameMap[$fieldName]; } /** * Get the __toString() implementation * * @return callable|null */ public function getToStringFunction() { return $this->toStringFunction; } /** * Set the __toString() implementation * * @param callable $function */ public function setToStringFunction(callable $function) { $this->toStringFunction = $function; } /** * Retrieve an iterator (IteratorAggregate interface) * * @return \Iterator */ public function getIterator(): \Iterator { return new \ArrayIterator($this->fieldDefs); } /** * Get the number of fields (Countable interface) * * @return int */ public function count(): int { return $this->fieldCount; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\TypeDefinitions; /** * Creates TypeDefinition objects * * @category LibDNS * @package TypeDefinitions * @author Chris Wright */ class TypeDefinitionFactory { /** * Create a new TypeDefinition object * * @param FieldDefinitionFactory $fieldDefinitionFactory * @param int[] $definition Structural definition of the fields * @return \LibDNS\Records\TypeDefinitions\TypeDefinition * @throws \InvalidArgumentException When the type definition is invalid */ public function create(FieldDefinitionFactory $fieldDefinitionFactory, array $definition): TypeDefinition { return new TypeDefinition($fieldDefinitionFactory, $definition); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\TypeDefinitions; /** * Creates TypeDefinitionManager objects * * @category LibDNS * @package TypeDefinitions * @author Chris Wright */ class TypeDefinitionManagerFactory { /** * Create a new TypeDefinitionManager object * * @return \LibDNS\Records\TypeDefinitions\TypeDefinitionManager */ public function create(): TypeDefinitionManager { return new TypeDefinitionManager(new TypeDefinitionFactory, new FieldDefinitionFactory); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\TypeDefinitions; use \LibDNS\Records\ResourceTypes; use \LibDNS\Records\Types\Types; use \LibDNS\Records\Types\DomainName; /** * Holds data about how the RDATA sections of known resource record types are structured * * @category LibDNS * @package TypeDefinitions * @author Chris Wright */ class TypeDefinitionManager { /** * @var array[] How the RDATA sections of known resource record types are structured */ private $definitions = []; /** * @var array Cache of created definitions */ private $typeDefs = []; /** * @var \LibDNS\Records\TypeDefinitions\TypeDefinitionFactory */ private $typeDefFactory; /** * @var \LibDNS\Records\TypeDefinitions\FieldDefinitionFactory */ private $fieldDefFactory; /** * Constructor * * @param \LibDNS\Records\TypeDefinitions\TypeDefinitionFactory $typeDefFactory * @param \LibDNS\Records\TypeDefinitions\FieldDefinitionFactory $fieldDefFactory */ public function __construct(TypeDefinitionFactory $typeDefFactory, FieldDefinitionFactory $fieldDefFactory) { $this->typeDefFactory = $typeDefFactory; $this->fieldDefFactory = $fieldDefFactory; $this->setDefinitions(); } /** * Set the internal definitions structure */ private function setDefinitions() { // This is defined in a method because PHP doesn't let you define properties with // expressions at the class level. If anyone has a better way to do this I am open // to any and all suggestions. $this->definitions = [ ResourceTypes::A => [ // RFC 1035 'address' => Types::IPV4_ADDRESS, ], ResourceTypes::AAAA => [ // RFC 3596 'address' => Types::IPV6_ADDRESS, ], ResourceTypes::AFSDB => [ // RFC 1183 'subtype' => Types::SHORT, 'hostname' => Types::DOMAIN_NAME, ], ResourceTypes::CAA => [ // RFC 6844 'flags' => Types::DOMAIN_NAME, 'tag' => Types::CHARACTER_STRING, 'value' => Types::ANYTHING, ], ResourceTypes::CERT => [ // RFC 4398 'type' => Types::SHORT, 'key-tag' => Types::SHORT, 'algorithm' => Types::CHAR, 'certificate' => Types::ANYTHING, ], ResourceTypes::CNAME => [ // RFC 1035 'cname' => Types::DOMAIN_NAME, ], ResourceTypes::DHCID => [ // RFC 4701 'identifier-type' => Types::SHORT, 'digest-type' => Types::CHAR, 'digest' => Types::ANYTHING, ], ResourceTypes::DLV => [ // RFC 4034 'key-tag' => Types::SHORT, 'algorithm' => Types::CHAR, 'digest-type' => Types::CHAR, 'digest' => Types::ANYTHING, ], ResourceTypes::DNAME => [ // RFC 4034 'target' => Types::DOMAIN_NAME, ], ResourceTypes::DNSKEY => [ // RFC 6672 'flags' => Types::SHORT, 'protocol' => Types::CHAR, 'algorithm' => Types::CHAR, 'public-key' => Types::ANYTHING, ], ResourceTypes::DS => [ // RFC 4034 'key-tag' => Types::SHORT, 'algorithm' => Types::CHAR, 'digest-type' => Types::CHAR, 'digest' => Types::ANYTHING, ], ResourceTypes::HINFO => [ // RFC 1035 'cpu' => Types::CHARACTER_STRING, 'os' => Types::CHARACTER_STRING, ], ResourceTypes::ISDN => [ // RFC 1183 'isdn-address' => Types::CHARACTER_STRING, 'sa' => Types::CHARACTER_STRING, ], ResourceTypes::KEY => [ // RFC 2535 'flags' => Types::SHORT, 'protocol' => Types::CHAR, 'algorithm' => Types::CHAR, 'public-key' => Types::ANYTHING, ], ResourceTypes::KX => [ // RFC 2230 'preference' => Types::SHORT, 'exchange' => Types::DOMAIN_NAME, ], ResourceTypes::LOC => [ // RFC 1876 'version' => Types::CHAR, 'size' => Types::CHAR, 'horizontal-precision' => Types::CHAR, 'vertical-precision' => Types::CHAR, 'latitude' => Types::LONG, 'longitude' => Types::LONG, 'altitude' => Types::LONG, ], ResourceTypes::MB => [ // RFC 1035 'madname' => Types::DOMAIN_NAME, ], ResourceTypes::MD => [ // RFC 1035 'madname' => Types::DOMAIN_NAME, ], ResourceTypes::MF => [ // RFC 1035 'madname' => Types::DOMAIN_NAME, ], ResourceTypes::MG => [ // RFC 1035 'mgmname' => Types::DOMAIN_NAME, ], ResourceTypes::MINFO => [ // RFC 1035 'rmailbx' => Types::DOMAIN_NAME, 'emailbx' => Types::DOMAIN_NAME, ], ResourceTypes::MR => [ // RFC 1035 'newname' => Types::DOMAIN_NAME, ], ResourceTypes::MX => [ // RFC 1035 'preference' => Types::SHORT, 'exchange' => Types::DOMAIN_NAME, ], ResourceTypes::NAPTR => [ // RFC 3403 'order' => Types::SHORT, 'preference' => Types::SHORT, 'flags' => Types::CHARACTER_STRING, 'services' => Types::CHARACTER_STRING, 'regexp' => Types::CHARACTER_STRING, 'replacement' => Types::DOMAIN_NAME, ], ResourceTypes::NS => [ // RFC 1035 'nsdname' => Types::DOMAIN_NAME, ], ResourceTypes::NULL => [ // RFC 1035 'data' => Types::ANYTHING, ], ResourceTypes::PTR => [ // RFC 1035 'ptrdname' => Types::DOMAIN_NAME, ], ResourceTypes::RP => [ // RFC 1183 'mbox-dname' => Types::DOMAIN_NAME, 'txt-dname' => Types::DOMAIN_NAME, ], ResourceTypes::RT => [ // RFC 1183 'preference' => Types::SHORT, 'intermediate-host' => Types::DOMAIN_NAME, ], ResourceTypes::SIG => [ // RFC 4034 'type-covered' => Types::SHORT, 'algorithm' => Types::CHAR, 'labels' => Types::CHAR, 'original-ttl' => Types::LONG, 'signature-expiration' => Types::LONG, 'signature-inception' => Types::LONG, 'key-tag' => Types::SHORT, 'signers-name' => Types::DOMAIN_NAME, 'signature' => Types::ANYTHING, ], ResourceTypes::SOA => [ // RFC 1035 'mname' => Types::DOMAIN_NAME, 'rname' => Types::DOMAIN_NAME, 'serial' => Types::LONG, 'refresh' => Types::LONG, 'retry' => Types::LONG, 'expire' => Types::LONG, 'minimum' => Types::LONG, ], ResourceTypes::SPF => [ // RFC 4408 'data+' => Types::CHARACTER_STRING, ], ResourceTypes::SRV => [ // RFC 2782 'priority' => Types::SHORT, 'weight' => Types::SHORT, 'port' => Types::SHORT, 'name' => Types::DOMAIN_NAME | DomainName::FLAG_NO_COMPRESSION, ], ResourceTypes::TXT => [ // RFC 1035 'txtdata+' => Types::CHARACTER_STRING, ], ResourceTypes::WKS => [ // RFC 1035 'address' => Types::IPV4_ADDRESS, 'protocol' => Types::SHORT, 'bit-map' => Types::BITMAP, ], ResourceTypes::X25 => [ // RFC 1183 'psdn-address' => Types::CHARACTER_STRING, ], ]; } /** * Get a type definition for a record type if it is known * * @param int $recordType Resource type, can be indicated using the ResourceTypes enum * @return \LibDNS\Records\TypeDefinitions\TypeDefinition */ public function getTypeDefinition(int $recordType) { if (!isset($this->typeDefs[$recordType])) { $definition = isset($this->definitions[$recordType]) ? $this->definitions[$recordType] : ['data' => Types::ANYTHING]; $this->typeDefs[$recordType] = $this->typeDefFactory->create($this->fieldDefFactory, $definition); } return $this->typeDefs[$recordType]; } /** * Register a custom type definition * * @param int $recordType Resource type, can be indicated using the ResourceTypes enum * @param int[]|\LibDNS\Records\TypeDefinitions\TypeDefinition $definition * @throws \InvalidArgumentException When the type definition is invalid */ public function registerTypeDefinition(int $recordType, $definition) { if (!($definition instanceof TypeDefinition)) { if (!\is_array($definition)) { throw new \InvalidArgumentException('Definition must be an array or an instance of ' . __NAMESPACE__ . '\TypeDefinition'); } $definition = $this->typeDefFactory->create($this->fieldDefFactory, $definition); } $this->typeDefs[$recordType] = $definition; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\TypeDefinitions; /** * Creates FieldDefinition objects * * @category LibDNS * @package TypeDefinitions * @author Chris Wright */ class FieldDefinitionFactory { /** * Create a new FieldDefinition object * * @param int $index * @param string $name * @param int $type * @param bool $allowsMultiple * @param int $minimumValues * @return \LibDNS\Records\TypeDefinitions\FieldDefinition */ public function create(int $index, string $name, int $type, bool $allowsMultiple, int $minimumValues): FieldDefinition { return new FieldDefinition($index, $name, $type, $allowsMultiple, $minimumValues); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records\TypeDefinitions; use \LibDNS\Records\Types\Type; use \LibDNS\Records\Types\Anything; use \LibDNS\Records\Types\BitMap; use \LibDNS\Records\Types\Char; use \LibDNS\Records\Types\CharacterString; use \LibDNS\Records\Types\DomainName; use \LibDNS\Records\Types\IPv4Address; use \LibDNS\Records\Types\IPv6Address; use \LibDNS\Records\Types\Long; use \LibDNS\Records\Types\Short; use \LibDNS\Records\Types\Types; /** * Defines a field in a type * * @category LibDNS * @package TypeDefinitions * @author Chris Wright */ class FieldDefinition { /** * @var int */ private $index; /** * @var string */ private $name; /** * @var int */ private $type; /** * @var bool */ private $allowsMultiple; /** * @var int */ private $minimumValues; /** * Constructor * * @param int $index * @param string $name * @param int $type * @param bool $allowsMultiple * @param int $minimumValues */ public function __construct(int $index, string $name, int $type, bool $allowsMultiple, int $minimumValues) { $this->index = $index; $this->name = $name; $this->type = $type; $this->allowsMultiple = $allowsMultiple; $this->minimumValues = $minimumValues; } /** * Get the index of the field in the containing type * * @return int */ public function getIndex(): int { return $this->index; } /** * Get the name of the field * * @return string */ public function getName(): string { return $this->name; } /** * Get the type of the field * * @return int */ public function getType(): int { return $this->type; } /** * Determine whether the field allows multiple values * * @return bool */ public function allowsMultiple(): bool { return $this->allowsMultiple; } /** * Get the minimum number of values for the field * * @return int */ public function getMinimumValues(): int { return $this->minimumValues; } /** * Assert that a Type object is valid for this field * * @param \LibDNS\Records\Types\Type * @return bool */ public function assertDataValid(Type $value): bool { return (($this->type & Types::ANYTHING) && $value instanceof Anything) || (($this->type & Types::BITMAP) && $value instanceof BitMap) || (($this->type & Types::CHAR) && $value instanceof Char) || (($this->type & Types::CHARACTER_STRING) && $value instanceof CharacterString) || (($this->type & Types::DOMAIN_NAME) && $value instanceof DomainName) || (($this->type & Types::IPV4_ADDRESS) && $value instanceof IPv4Address) || (($this->type & Types::IPV6_ADDRESS) && $value instanceof IPv6Address) || (($this->type & Types::LONG) && $value instanceof Long) || (($this->type & Types::SHORT) && $value instanceof Short); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Records\Types\DomainName; /** * Represents a DNS record * * @category LibDNS * @package Records * @author Chris Wright */ abstract class Record { /** * @var \LibDNS\Records\Types\TypeFactory */ protected $typeFactory; /** * @var \LibDNS\Records\Types\DomainName */ protected $name; /** * @var int */ protected $type; /** * @var int */ protected $class = ResourceClasses::IN; /** * Get the value of the record name field * * @return \LibDNS\Records\Types\DomainName */ public function getName(): DomainName { return $this->name; } /** * Set the value of the record name field * * @param string|\LibDNS\Records\Types\DomainName $name * @throws \UnexpectedValueException When the supplied value is not a valid domain name */ public function setName($name) { if (!($name instanceof DomainName)) { $name = $this->typeFactory->createDomainName((string)$name); } $this->name = $name; } /** * Get the value of the record type field * * @return int */ public function getType(): int { return $this->type; } /** * Get the value of the record class field * * @return int */ public function getClass(): int { return $this->class; } /** * Set the value of the record class field * * @param int $class The new value, can be indicated using the ResourceClasses/ResourceQClasses enums * @throws \RangeException When the supplied value is outside the valid range 0 - 65535 */ public function setClass(int $class) { if ($class < 0 || $class > 65535) { throw new \RangeException('Record class must be in the range 0 - 65535'); } $this->class = $class; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Records\Types\TypeFactory; /** * Creates Resource objects * * @category LibDNS * @package Records * @author Chris Wright */ class ResourceFactory { /** * Create a new Resource object * * @param int $type Can be indicated using the ResourceTypes enum * @param \LibDNS\Records\RData $data * @return \LibDNS\Records\Resource */ public function create(int $type, RData $data): Resource { return new Resource(new TypeFactory, $type, $data); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Records\Types\TypeFactory; /** * Creates Question objects * * @category LibDNS * @package Records * @author Chris Wright */ class QuestionFactory { /** * Create a new Question object * * @param int $type The resource type * @return \LibDNS\Records\Question */ public function create(int $type): Question { return new Question(new TypeFactory, $type); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; /** * Enumeration of possible resource QTYPE values * * @category LibDNS * @package Records * @author Chris Wright */ final class ResourceQTypes extends ResourceTypes { const AXFR = 252; const MAILB = 253; const MAILA = 254; const ALL = 255; } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Enumeration; /** * Enumeration of possible record types * * @category LibDNS * @package Records * @author Chris Wright */ final class RecordTypes extends Enumeration { const QUESTION = 0; const RESOURCE = 1; } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Records\TypeDefinitions\TypeDefinition; use \LibDNS\Records\Types\TypeBuilder; /** * Creates RData objects * * @category LibDNS * @package Records * @author Chris Wright */ class RDataBuilder { /** * @var \LibDNS\Records\RDataFactory */ private $rDataFactory; /** * @var \LibDNS\Records\Types\TypeBuilder */ private $typeBuilder; /** * Constructor * * @param \LibDNS\Records\RDataFactory $rDataFactory * @param \LibDNS\Records\Types\TypeBuilder $typeBuilder */ public function __construct(RDataFactory $rDataFactory, TypeBuilder $typeBuilder) { $this->rDataFactory = $rDataFactory; $this->typeBuilder = $typeBuilder; } /** * Create a new RData object * * @param \LibDNS\Records\TypeDefinitions\TypeDefinition $typeDefinition * @return \LibDNS\Records\RData */ public function build(TypeDefinition $typeDefinition): RData { $rData = $this->rDataFactory->create($typeDefinition); foreach ($typeDefinition as $index => $type) { $rData->setField($index, $this->typeBuilder->build($type->getType())); } return $rData; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; /** * Collection of Record objects * * @category LibDNS * @package Records * @author Chris Wright */ class RecordCollection implements \IteratorAggregate, \Countable { /** * @var \LibDNS\Records\Record[] List of records held in the collection */ private $records = []; /** * @var \LibDNS\Records\Record[][] Map of Records in the collection grouped by record name */ private $nameMap = []; /** * @var int Number of Records in the collection */ private $length = 0; /** * @var int Whether the collection holds question or resource records */ private $type; /** * Constructor * * @param int $type Can be indicated using the RecordTypes enum * @throws \InvalidArgumentException When the specified record type is invalid */ public function __construct($type) { if ($type !== RecordTypes::QUESTION && $type !== RecordTypes::RESOURCE) { throw new \InvalidArgumentException('Record type must be QUESTION or RESOURCE'); } $this->type = $type; } /** * Add a record to the correct bucket in the name map * * @param \LibDNS\Records\Record $record The record to add */ private function addToNameMap(Record $record) { if (!isset($this->nameMap[$name = (string) $record->getName()])) { $this->nameMap[$name] = []; } $this->nameMap[$name][] = $record; } /** * Remove a record from the name map * * @param \LibDNS\Records\Record $record The record to remove */ private function removeFromNameMap(Record $record) { if (!empty($this->nameMap[$name = (string) $record->getName()])) { foreach ($this->nameMap[$name] as $key => $item) { if ($item === $record) { \array_splice($this->nameMap[$name], $key, 1); break; } } } if (empty($this->nameMap[$name])) { unset($this->nameMap[$name]); } } /** * Add a record to the collection * * @param \LibDNS\Records\Record $record The record to add * @throws \InvalidArgumentException When the wrong record type is supplied */ public function add(Record $record) { if (($this->type === RecordTypes::QUESTION && !($record instanceof Question)) || ($this->type === RecordTypes::RESOURCE && !($record instanceof Resource))) { throw new \InvalidArgumentException('Incorrect record type for this collection'); } $this->records[] = $record; $this->addToNameMap($record); $this->length++; } /** * Remove a record from the collection * * @param \LibDNS\Records\Record $record The record to remove */ public function remove(Record $record) { foreach ($this->records as $key => $item) { if ($item === $record) { array_splice($this->records, $key, 1); $this->removeFromNameMap($record); $this->length--; return; } } throw new \InvalidArgumentException('The supplied record is not a member of this collection'); } /** * Test whether the collection contains a specific record * * @param \LibDNS\Records\Record $record The record to search for * @param bool $sameInstance Whether to perform strict comparisons in search * @return bool */ public function contains(Record $record, bool $sameInstance = false): bool { return \in_array($record, $this->records, $sameInstance); } /** * Get all records in the collection that refer to the specified name * * @param string $name The name to match records against * @return \LibDNS\Records\Record[] */ public function getRecordsByName(string $name): array { return $this->nameMap[\strtolower($name)] ?? []; } /** * Get a record from the collection by index * * @param int $index Record index * @return \LibDNS\Records\Record * @throws \OutOfBoundsException When the supplied index does not refer to a valid record */ public function getRecordByIndex(int $index): Record { if (isset($this->records[$index])) { return $this->records[$index]; } throw new \OutOfBoundsException('The specified index ' . $index . ' does not exist in the collection'); } /** * Remove all records in the collection that refer to the specified name * * @param string $name The name to match records against * @return int The number of records removed */ public function clearRecordsByName(string $name): int { $count = 0; if (isset($this->nameMap[$name = \strtolower($name)])) { unset($this->nameMap[$name]); foreach ($this->records as $index => $record) { if ($record->getName() === $name) { unset($this->records[$index]); $count++; } } $this->records = \array_values($this->records); } return $count; } /** * Remove all records from the collection */ public function clear() { $this->records = $this->nameMap = []; $this->length = 0; } /** * Get a list of all names referenced by records in the collection * * @return string[] */ public function getNames(): array { return \array_keys($this->nameMap); } /** * Get whether the collection holds question or resource records * * @return int */ public function getType(): int { return $this->type; } /** * Retrieve an iterator (IteratorAggregate interface) * * @return \Iterator */ public function getIterator(): \Iterator { return new \ArrayIterator($this->records); } /** * Get the number of records in the collection (Countable interface) * * @return int */ public function count(): int { return $this->length; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; /** * Enumeration of possible resource QCLASS values * * @category LibDNS * @package Records * @author Chris Wright */ final class ResourceQClasses extends ResourceClasses { const ANY = 255; } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Records; use \LibDNS\Enumeration; /** * Enumeration of possible resource CLASS values * * @category LibDNS * @package Records * @author Chris Wright */ abstract class ResourceClasses extends Enumeration { const IN = 1; const CS = 2; const CH = 3; const HS = 4; } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Messages; use \LibDNS\Enumeration; /** * Enumeration of possible message types * * @category LibDNS * @package Messages * @author Chris Wright */ final class MessageTypes extends Enumeration { const QUERY = 0; const RESPONSE = 1; } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Messages; use \LibDNS\Enumeration; /** * Enumeration of possible message types * * @category LibDNS * @package Messages * @author Chris Wright */ final class MessageResponseCodes extends Enumeration { const NO_ERROR = 0; const FORMAT_ERROR = 1; const SERVER_FAILURE = 2; const NAME_ERROR = 3; const NOT_IMPLEMENTED = 4; const REFUSED = 5; } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Messages; use \LibDNS\Records\RecordCollectionFactory; /** * Factory which creates Message objects * * @category LibDNS * @package Messages * @author Chris Wright */ class MessageFactory { /** * Create a new Message object * * @param int $type Value of the message type field * @return \LibDNS\Messages\Message */ public function create(int $type = null): Message { return new Message(new RecordCollectionFactory, $type); } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Messages; use LibDNS\Records\RecordCollection; use \LibDNS\Records\RecordCollectionFactory; use \LibDNS\Records\RecordTypes; /** * Represents a DNS protocol message * * @category LibDNS * @package Messages * @author Chris Wright */ class Message { /** * @var int Unsigned short that identifies the DNS transaction */ private $id = 0; /** * @var int Indicates the type of the message, can be indicated using the MessageTypes enum */ private $type = -1; /** * @var int Message opcode, can be indicated using the MessageOpCodes enum */ private $opCode = MessageOpCodes::QUERY; /** * @var bool Whether a response message is authoritative */ private $authoritative = false; /** * @var bool Whether the message is truncated */ private $truncated = false; /** * @var bool Whether a query desires the server to recurse the lookup */ private $recursionDesired = true; /** * @var bool Whether a server could provide recursion in a response */ private $recursionAvailable = false; /** * @var int Message response code, can be indicated using the MessageResponseCodes enum */ private $responseCode = MessageResponseCodes::NO_ERROR; /** * @var \LibDNS\Records\RecordCollection Collection of question records */ private $questionRecords; /** * @var \LibDNS\Records\RecordCollection Collection of question records */ private $answerRecords; /** * @var \LibDNS\Records\RecordCollection Collection of authority records */ private $authorityRecords; /** * @var \LibDNS\Records\RecordCollection Collection of authority records */ private $additionalRecords; /** * Constructor * * @param \LibDNS\Records\RecordCollectionFactory $recordCollectionFactory Factory which makes RecordCollection objects * @param int $type Value of the message type field * @throws \RangeException When the supplied message type is outside the valid range 0 - 1 */ public function __construct(RecordCollectionFactory $recordCollectionFactory, int $type = null) { $this->questionRecords = $recordCollectionFactory->create(RecordTypes::QUESTION); $this->answerRecords = $recordCollectionFactory->create(RecordTypes::RESOURCE); $this->authorityRecords = $recordCollectionFactory->create(RecordTypes::RESOURCE); $this->additionalRecords = $recordCollectionFactory->create(RecordTypes::RESOURCE); if ($type !== null) { $this->setType($type); } } /** * Get the value of the message ID field * * @return int */ public function getID(): int { return $this->id; } /** * Set the value of the message ID field * * @param int $id The new value * @throws \RangeException When the supplied value is outside the valid range 0 - 65535 */ public function setID(int $id) { if ($id < 0 || $id > 65535) { throw new \RangeException('Message ID must be in the range 0 - 65535'); } $this->id = $id; } /** * Get the value of the message type field * * @return int */ public function getType(): int { return $this->type; } /** * Set the value of the message type field * * @param int $type The new value * @throws \RangeException When the supplied value is outside the valid range 0 - 1 */ public function setType(int $type) { if ($type < 0 || $type > 1) { throw new \RangeException('Message type must be in the range 0 - 1'); } $this->type = $type; } /** * Get the value of the message opcode field * * @return int */ public function getOpCode(): int { return $this->opCode; } /** * Set the value of the message opcode field * * @param int $opCode The new value * @throws \RangeException When the supplied value is outside the valid range 0 - 15 */ public function setOpCode(int $opCode) { if ($opCode < 0 || $opCode > 15) { throw new \RangeException('Message opcode must be in the range 0 - 15'); } $this->opCode = $opCode; } /** * Inspect the value of the authoritative field and optionally set a new value * * @param bool $newValue The new value * @return bool The old value */ public function isAuthoritative(bool $newValue = null): bool { $result = $this->authoritative; if ($newValue !== null) { $this->authoritative = $newValue; } return $result; } /** * Inspect the value of the truncated field and optionally set a new value * * @param bool $newValue The new value * @return bool The old value */ public function isTruncated(bool $newValue = null): bool { $result = $this->truncated; if ($newValue !== null) { $this->truncated = $newValue; } return $result; } /** * Inspect the value of the recusion desired field and optionally set a new value * * @param bool $newValue The new value * @return bool The old value */ public function isRecursionDesired(bool $newValue = null): bool { $result = $this->recursionDesired; if ($newValue !== null) { $this->recursionDesired = $newValue; } return $result; } /** * Inspect the value of the recursion available field and optionally set a new value * * @param bool $newValue The new value * @return bool The old value */ public function isRecursionAvailable(bool $newValue = null): bool { $result = $this->recursionAvailable; if ($newValue !== null) { $this->recursionAvailable = $newValue; } return $result; } /** * Get the value of the message response code field * * @return int */ public function getResponseCode(): int { return $this->responseCode; } /** * Set the value of the message response code field * * @param int $responseCode The new value * @throws \RangeException When the supplied value is outside the valid range 0 - 15 */ public function setResponseCode(int $responseCode) { if ($responseCode < 0 || $responseCode > 15) { throw new \RangeException('Message response code must be in the range 0 - 15'); } $this->responseCode = $responseCode; } /** * Get the question records collection * * @return \LibDNS\Records\RecordCollection */ public function getQuestionRecords(): RecordCollection { return $this->questionRecords; } /** * Get the answer records collection * * @return \LibDNS\Records\RecordCollection */ public function getAnswerRecords(): RecordCollection { return $this->answerRecords; } /** * Get the authority records collection * * @return \LibDNS\Records\RecordCollection */ public function getAuthorityRecords(): RecordCollection { return $this->authorityRecords; } /** * Get the additional records collection * * @return \LibDNS\Records\RecordCollection */ public function getAdditionalRecords(): RecordCollection { return $this->additionalRecords; } } * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace LibDNS\Messages; use \LibDNS\Enumeration; /** * Enumeration of possible message types * * @category LibDNS * @package Messages * @author Chris Wright */ final class MessageOpCodes extends Enumeration { const QUERY = 0; const IQUERY = 1; const STATUS = 2; } { "name": "PHP", "build": { "dockerfile": "Dockerfile", "args": { // Update VARIANT to pick a PHP version: 7, 7.4, 7.3 "VARIANT": "7.4", "INSTALL_NODE": "true", "NODE_VERSION": "lts/*" } }, // Set *default* container specific settings.json values on container create. "settings": { "terminal.integrated.shell.linux": "/bin/bash" }, // Add the IDs of extensions you want installed when the container is created. "extensions": [ "felixfbecker.php-debug", "felixfbecker.php-intellisense", "getpsalm.psalm-vscode-plugin", "junstyle.php-cs-fixer" ] // Use 'forwardPorts' to make a list of ports inside the container available locally. // "forwardPorts": [], // Use 'postCreateCommand' to run commands after the container is created. // "postCreateCommand": "php -v", // Uncomment to connect as a non-root user. See https://aka.ms/vscode-remote/containers/non-root. // "remoteUser": "vscode" } #!/usr/bin/env php . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ use danog\MadelineProto\Db\DbArray; use danog\MadelineProto\EventHandler; use danog\MadelineProto\Logger; use danog\MadelineProto\Settings; use danog\MadelineProto\Settings\Database\Mysql; use danog\MadelineProto\Settings\Database\Postgres; use danog\MadelineProto\Settings\Database\Redis; /* * Various ways to load MadelineProto */ if (file_exists('vendor/autoload.php')) { include 'vendor/autoload.php'; } else { if (!file_exists('madeline.php')) { copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php'); } /** * @psalm-suppress MissingFile */ include 'madeline.php'; } /** * Event handler class. */ class MyEventHandler extends EventHandler { /** * @var int|string Username or ID of bot admin */ const ADMIN = "danogentili"; // Change this /** * List of properties automatically stored in database (MySQL, Postgres, redis or memory). * @see https://docs.madelineproto.xyz/docs/DATABASE.html */ protected static array $dbProperties = [ 'dataStoredOnDb' => 'array' ]; /** * @var DbArray */ protected $dataStoredOnDb; /** * Get peer(s) where to report errors. * * @return int|string|array */ public function getReportPeers() { return [self::ADMIN]; } /** * Initialization logic. */ public function onStart() { $this->logger("The bot was started!"); var_dump(yield $this->getFullInfo('davtur19')); } /** * Handle updates from supergroups and channels. * * @param array $update Update * * @return void */ public function onUpdateNewChannelMessage(array $update): \Generator { return $this->onUpdateNewMessage($update); } /** * Handle updates from users. * * @param array $update Update * */ public function onUpdateNewMessage(array $update): \Generator { $this->logger($update); if ($update['message']['_'] === 'messageEmpty' || $update['message']['out'] ?? false) { return; } /* // Example code to json-dump all incoming updates (be wary of enabling it in chats) $res = \json_encode($update, JSON_PRETTY_PRINT); yield $this->messages->sendMessage(['peer' => $update, 'message' => "$res", 'reply_to_msg_id' => isset($update['message']['id']) ? $update['message']['id'] : null, 'parse_mode' => 'HTML']); if (isset($update['message']['media']) && $update['message']['media']['_'] !== 'messageMediaGame' && $update['message']['media']['_'] !== 'messageMediaWebPage') { yield $this->messages->sendMedia(['peer' => $update, 'message' => $update['message']['message'], 'media' => $update]); } */ // You can also use the built-in MadelineProto MySQL async driver! // Can be anything serializable, an array, an int, an object $myData = []; // Use the isset method to check whether some data exists in the database if (yield $this->dataStoredOnDb->isset('yourKey')) { // Always yield when fetching data $myData = yield $this->dataStoredOnDb['yourKey']; } $this->dataStoredOnDb['yourKey'] = $myData + ['moreStuff' => 'yay']; $this->dataStoredOnDb['otherKey'] = 0; unset($this->dataStoredOnDb['otherKey']); $this->logger("Count: ".(yield $this->dataStoredOnDb->count())); // You can even use an async iterator to iterate over the data $iterator = $this->dataStoredOnDb->getIterator(); while (yield $iterator->advance()) { [$key, $value] = $iterator->getCurrent(); $this->logger($key); $this->logger($value); } } } $settings = new Settings; $settings->getLogger()->setLevel(Logger::LEVEL_ULTRA_VERBOSE); // You can also use Redis, MySQL or PostgreSQL // $settings->setDb((new Redis)->setDatabase(0)->setPassword('pony')); // $settings->setDb((new Postgres)->setDatabase('MadelineProto')->setUsername('daniil')->setPassword('pony')); // $settings->setDb((new Mysql)->setDatabase('MadelineProto')->setUsername('daniil')->setPassword('pony')); // Reduce boilerplate with new wrapper method. // Also initializes error reporting, catching and reporting all errors surfacing from the event loop. MyEventHandler::startAndLoop('uwu.madeline', $settings); true, ]); } }; $config->getFinder() ->in(__DIR__ . '/src') ->in(__DIR__ . '/tests') ->in(__DIR__ . '/examples') ->in(__DIR__ . '/tools'); $cacheDir = getenv('TRAVIS') ? getenv('HOME') . '/.php-cs-fixer' : __DIR__; $config->setCacheFile($cacheDir . '/.php_cs.cache'); return $config; #!/usr/bin/env php . */ use danog\MadelineProto\API; use danog\MadelineProto\APIFactory; use danog\MadelineProto\Logger; use danog\MadelineProto\Magic; use danog\MadelineProto\MTProto; use danog\MadelineProto\Settings\Logger as SettingsLogger; use danog\MadelineProto\Tools; chdir($d=__DIR__.'/..'); require 'vendor/autoload.php'; Magic::start(); Logger::constructorFromSettings(new SettingsLogger); $logger = Logger::$default; set_error_handler(['\danog\MadelineProto\Exception', 'ExceptionErrorHandler']); $logger->logger('Merging constructor localization...', Logger::NOTICE); mergeExtracted(); $logger->logger('Loading schemas...', Logger::NOTICE); $schemas = loadSchemas(); $logger->logger('Upgrading layer...', Logger::NOTICE); $layer = maxLayer($schemas); layerUpgrade($layer); $logger->logger("Initing docs (layer $layer)...", Logger::NOTICE); $docs = [ [ 'tl_schema' => ['mtproto' => '', 'telegram' => "$d/schemas/TL_telegram_v$layer.tl", 'secret' => "$d/schemas/TL_secret.tl", 'td' => "$d/schemas/TL_td.tl"], 'title' => "MadelineProto API documentation (layer $layer)", 'description' => "MadelineProto API documentation (layer $layer)", 'output_dir' => "$d/docs/docs/API_docs", 'template' => "$d/docs/template", 'readme' => false, ], ]; $docs = array_merge($docs, initDocs($schemas)); $logger->logger('Creating annotations...', Logger::NOTICE); $doc = new \danog\MadelineProto\AnnotationsBuilder( $logger, $docs[0], dirname(__FILE__).'/../src/danog/MadelineProto/InternalDoc.php', [ 'API' => API::class, 'APIFactory' => APIFactory::class, 'MTProto' => MTProto::class ], 'danog\\MadelineProto' ); $doc->mkAnnotations(); $logger->logger('Creating docs...', Logger::NOTICE); foreach ($docs as $settings) { $doc = new \danog\MadelineProto\DocsBuilder($logger, $settings); $doc->mkDocs(); } chdir(__DIR__.'/..'); $logger->logger('Fixing readme...', Logger::NOTICE); $orderedfiles = []; $order = [ 'CREATING_A_CLIENT', 'LOGIN', 'FEATURES', 'REQUIREMENTS', 'INSTALLATION', 'UPDATES', 'DATABASE', 'SETTINGS', 'SELF', 'EXCEPTIONS', 'FLOOD_WAIT', 'LOGGING', 'CALLS', 'FILES', 'CHAT_INFO', 'DIALOGS', 'INLINE_BUTTONS', 'SECRET_CHATS', 'PROXY', 'ASYNC', 'USING_METHODS', 'CONTRIB', 'TEMPLATES', ]; $index = ''; $files = glob('docs/docs/docs/*md'); foreach ($files as $file) { $base = basename($file, '.md'); if ($base === 'UPDATES_INTERNAL') { continue; } $key = array_search($base, $order); if ($key !== false) { $orderedfiles[$key] = $file; } } ksort($orderedfiles); foreach ($orderedfiles as $key => $filename) { $lines = explode("\n", file_get_contents($filename)); while (end($lines) === '' || strpos(end($lines), 'Next')) { unset($lines[count($lines) - 1]); } if ($lines[0] === '---') { array_shift($lines); while ($lines[0] !== '---') { array_shift($lines); } array_shift($lines); } preg_match('|^# (.*)|', $lines[0], $matches); $title = $matches[1]; $description = str_replace('"', "'", Tools::toString($lines[2])); array_unshift( $lines, '---', 'title: "'.$title.'"', 'description: "'.$description.'"', 'nav_order: '.($key+4), 'image: https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png', '---' ); if (isset($orderedfiles[$key + 1])) { $nextfile = 'https://docs.madelineproto.xyz/docs/'.basename($orderedfiles[$key + 1], '.md').'.html'; $lines[count($lines)] = "\nNext section"; } else { $lines[count($lines)] = "\nNext section"; } file_put_contents($filename, implode("\n", $lines)); $file = file_get_contents($filename); preg_match_all('|( *)\* \[(.*)\]\((.*)\)|', $file, $matches); $file = 'https://docs.madelineproto.xyz/docs/'.basename($filename, '.md').'.html'; $index .= "* [$title]($file)\n"; if (basename($filename) !== 'FEATURES.md') { foreach ($matches[1] as $key => $match) { $spaces = " $match"; $name = $matches[2][$key]; if ($matches[3][$key][0] === '#') { $url = $file.$matches[3][$key]; } elseif (substr($matches[3][$key], 0, 3) === '../') { $url = 'https://docs.madelineproto.xyz/'.str_replace('.md', '.html', substr($matches[3][$key], 3)); } else { $url = $matches[3][$key]; } $index .= "$spaces* [$name]($url)\n"; if ($name === 'FULL API Documentation with descriptions') { $spaces .= ' '; preg_match_all('|\* (.*)|', file_get_contents('docs/docs/API_docs/methods/index.md'), $smatches); foreach ($smatches[1] as $key => $match) { if (str_contains($match, 'You cannot use this method directly')) { continue; } $match = str_replace('href="', 'href="https://docs.madelineproto.xyz/API_docs/methods/', $match); $index .= "$spaces* ".$match."\n"; } } } } } $logger->logger('Fixing readme...', Logger::NOTICE); $readme = explode('## ', file_get_contents('README.md')); foreach ($readme as &$section) { if (explode("\n", $section)[0] === 'Documentation') { $section = "Documentation\n\n".$index."\n"; } } $readme = implode('## ', $readme); file_put_contents('README.md', $readme); file_put_contents('docs/docs/index.md', '--- title: MadelineProto description: PHP client/server for the telegram MTProto protocol (a better tg-cli) nav_order: 1 image: https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png --- '.$readme); include 'phpdoc.php'; getMethods(), $methods); } $methods = array_unique($methods); function ssort($a, $b) { return strlen($b->getName())-strlen($a->getName()); } usort($methods, 'ssort'); $find = []; $replace = []; $findDocs = []; $replaceDocs = []; foreach ($methods as $methodObj) { $method = $methodObj->getName(); if (strpos($method, '__') === 0 || $method === 'async') { continue; } $method = Tools::fromCamelCase($method); $new = Tools::fromSnakeCase($method); $new = str_ireplace(['mtproto', 'api'], ['MTProto', 'API'], $new); $new = preg_replace('/TL$/i', 'TL', $new); if (!in_array($method, ['discardCallAsync', 'acceptCallAsync', 'requestCallAsync'])) { $new = preg_replace('/async$/i', '', $new); } $findDocs []= Tools::fromCamelCase($new).'('; $replaceDocs []= $new.'('; $findDocs []= $method.'('; $replaceDocs []= $new.'('; $findDocs []= Tools::fromCamelCase($new).'.'; $replaceDocs []= $new.'.'; $findDocs []= $method.'.'; $replaceDocs []= $new.'.'; $findDocs []= Tools::fromCamelCase($new).']'; $replaceDocs []= $new.']'; $findDocs []= $method.']'; $replaceDocs []= $new.']'; if (method_exists((string) $methodObj->getDeclaringClass(), preg_replace('/async$/i', '', $method))) { var_dump("Skipping $method => $new"); continue; } if (!function_exists($method)) { $find[] = "$method"; $replace[] = "$new"; continue; } $find[] = ">$method("; $replace[] = ">$new("; $find[] = ":$method("; $replace[] = ":$new("; $find[] = "function $method("; $replace[] = "function $new("; } foreach (new RegexIterator(new RecursiveIteratorIterator(new RecursiveDirectoryIterator(realpath('.'))), '/\.php$/') as $filename) { $filename = (string) $filename; $new = str_replace($find, $replace, $old = file_get_contents($filename)); do { file_put_contents($filename, $new); $new = str_replace($find, $replace, $old = file_get_contents($filename)); } while ($old !== $new); } exit; foreach (new RegexIterator(new RecursiveIteratorIterator(new RecursiveDirectoryIterator(realpath('docs'))), '/\.md$/') as $filename) { $filename = (string) $filename; $new = str_replace($findDocs, $replaceDocs, $old = file_get_contents($filename)); do { file_put_contents($filename, $new); $new = str_replace($findDocs, $replaceDocs, $old = file_get_contents($filename)); } while ($old !== $new); } $filename = 'README.md'; $new = str_replace($findDocs, $replaceDocs, $old = file_get_contents($filename)); do { file_put_contents($filename, $new); $new = str_replace($findDocs, $replaceDocs, $old = file_get_contents($filename)); } while ($old !== $new); getMethods(ReflectionMethod::IS_STATIC | ReflectionMethod::IS_PUBLIC); function ssort($a, $b) { return strlen($b->getName())-strlen($a->getName()); } usort($methods, 'ssort'); $find = []; $replace = []; $findDocs = []; $replaceDocs = []; foreach ($methods as $methodObj) { $method = $methodObj->getName(); $find[] = "\$this->$method("; $replace[] = "\\danog\\MadelineProto\\Tools::$method("; } foreach (new RegexIterator(new RecursiveIteratorIterator(new RecursiveDirectoryIterator(realpath('.'))), '/\.php$/') as $filename) { $filename = (string) $filename; $new = str_replace($find, $replace, $old = file_get_contents($filename)); do { file_put_contents($filename, $new); $new = str_replace($find, $replace, $old = file_get_contents($filename)); } while ($old !== $new); } exit; foreach (new RegexIterator(new RecursiveIteratorIterator(new RecursiveDirectoryIterator(realpath('docs'))), '/\.md$/') as $filename) { $filename = (string) $filename; $new = str_replace($findDocs, $replaceDocs, $old = file_get_contents($filename)); do { file_put_contents($filename, $new); $new = str_replace($findDocs, $replaceDocs, $old = file_get_contents($filename)); } while ($old !== $new); } $filename = 'README.md'; $new = str_replace($findDocs, $replaceDocs, $old = file_get_contents($filename)); do { file_put_contents($filename, $new); $new = str_replace($findDocs, $replaceDocs, $old = file_get_contents($filename)); } while ($old !== $new); #!/usr/bin/env php . */ if (!isset($argv[3])) { echo 'Usage: '.$argv[0].' inputDir output.phar ref'.PHP_EOL; die(1); } @unlink($argv[2]); $p = new Phar(__DIR__.'/../'.$argv[2], 0, $argv[2]); $p->buildFromDirectory(realpath($argv[1]), '/^((?!tests).)*(\.php|\.py|\.exe|\.tl|\.json|\.dat|\.h)$/i'); $p->addFromString('vendor/danog/madelineproto/.git/refs/heads/master', $argv[3]); $p->addFromString('.git/refs/heads/master', $argv[3]); $p->setStub(''); $value) { $key = preg_replace(['|flags\.\d+[?]|', '/Vector[<].*/'], ['', 'Vector t'], $key); $key = str_replace('param_hash_type_int', 'param_hash_type_Vector t', $key); Lang::$lang['en'][$key] = $value; } foreach (Lang::$lang['en'] as $key => $value) { if ($value === '') { unset(Lang::$lang['en'][$key]); } } foreach (json_decode(file_get_contents('docs/template/disallow.json'), true) as $key => $value) { Lang::$lang['en']["method_$key"] = $value; } } $line) { if (preg_match("/public function (\w*)[(]/", $line, $matches)) { $last_match = stripos($matches[1], 'async') === false ? $matches[1] : null; } if (preg_match('/function [(]/', $line) && stripos($line, 'public function') === false) { $last_match = 0; } if (strpos($line, 'yield') !== false) { if ($last_match) { echo "subbing $last_match for $line at $number in $file".PHP_EOL; $to_sub[] = $last_match; } elseif ($last_match === 0) { echo "============\nNOT SUBBING $last_match for $line at $number in $file\n============".PHP_EOL; $not_subbing[$file] = $file; } } } $input = []; $output = []; foreach ($to_sub as $func) { $input[] = "public function $func("; $output[] = "public function $func".'_async('; } if ($input) { file_put_contents($file, str_replace($input, $output, $filec)); } } var_dump(array_values($not_subbing)); isTrait(); }; PhpDocBuilder::fromNamespace() ->setFilter($filter) ->setOutput(__DIR__.'/../docs/docs/PHP/') ->setImage("https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png") ->addIndexFrontMatter('title', 'MadelineProto API') ->addIndexFrontMatter('description', 'MadelineProto PHP API reference') ->addIndexFrontMatter('has_children', 'true') ->addIndexFrontMatter('has_toc', 'false') ->addIndexFrontMatter('nav_order', '2') ->addFrontMatter('parent', 'MadelineProto API') ->run(); . */ require 'vendor/autoload.php'; $logger = new Logger(new SettingsLogger); set_error_handler(['\danog\MadelineProto\Exception', 'ExceptionErrorHandler']); if ($argc !== 3) { die("Usage: {$argv[0]} layernumberold layernumbernew\n"); } /** * Get TL info of layer. * * @param int $layer Layer number * * @return void */ function getTL($layer) { $layer = __DIR__."/../schemas/TL_telegram_v$layer.tl"; $layer = new class($layer) extends TL { public function __construct($layer) { $API = new class { }; $API->logger = Logger::$default; parent::__construct($API); $this->init((new TLSchema)->setAPISchema($layer)->setSecretSchema('')); } }; return ['methods' => $layer->getMethods(), 'constructors' => $layer->getConstructors()]; } function getUrl($constructor, $type) { $changed = str_replace('.', '_', $constructor); //return "[$constructor](https://github.com/danog/MadelineProtoDocs/blob/geochats/docs/API_docs/$type/$changed.md)"; return "[$constructor](https://docs.madelineproto.xyz/API_docs/$type/$changed.html)"; } $old = getTL($argv[1]); $new = getTL($argv[2]); $res = ''; foreach (['methods', 'constructors'] as $type) { $finder = $type === 'methods' ? 'findByMethod' : 'findByPredicate'; $key = $type === 'methods' ? 'method' : 'predicate'; // New constructors $res .= "\n\nNew ".ucfirst($type).":\n"; foreach ($new[$type]->by_id as $constructor) { $name = $constructor[$key]; if (!$old[$type]->$finder($name)) { $name = getUrl($name, $type); $res .= "- $name\n"; } } // Changed constructors $res .= "\n\nChanged ".ucfirst($type).":\n"; foreach ($new[$type]->by_id as $constructor) { $name = $constructor[$key]; if ($old[$type]->$finder($name)) { $new_args = $constructor['params']; $old_args = $old[$type]->$finder($name)['params']; $final_new_args = []; $final_old_args = []; foreach ($new_args as $arg) { $final_new_args[$arg['name']] = $arg['type']; } foreach ($old_args as $arg) { $final_old_args[$arg['name']] = $arg['type']; } $url = getUrl($name, $type); foreach ($final_new_args as $name => $ttype) { if (!isset($final_old_args[$name]) && $name !== 'flags' && $name !== 'flags2') { $res .= "Added $name param to $url\n"; } } foreach ($final_old_args as $name => $ttype) { if (!isset($final_new_args[$name]) && $name !== 'flags' && $name !== 'flags2') { $res .= "Removed $name param from $url\n"; } } } } // Deleted constructors $res .= "\n\nDeleted ".ucfirst($type).":\n"; foreach ($old[$type]->by_id as $constructor) { $name = $constructor[$key]; if (!$new[$type]->$finder($name)) { $res .= "- $name\n"; } } } $bot = new \danog\MadelineProto\API('layer.madeline'); $bot->start(); foreach (explode("\n\n", $res) as $chunk) { if (!$chunk || !trim(explode(':', $chunk)[1])) { continue; } $bot->messages->sendMessage(['peer' => 'danogentili', 'message' => $chunk, 'parse_mode' => 'markdown']); } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; class Lang { public static $lang = %s; // THIS WILL BE OVERWRITTEN BY $lang["en"] public static $current_lang = %s; }'; function fromCamelCase($input) { preg_match_all('!([A-Z][A-Z0-9]*(?=$|[A-Z][a-z0-9])|[A-Za-z][a-z0-9]+)!', $input, $matches); $ret = $matches[0]; foreach ($ret as &$match) { $match = $match == strtoupper($match) ? strtolower($match) : lcfirst($match); } return implode(' ', $ret); } foreach (Lang::$lang as $code => &$currentLang) { if ($code === 'en') { continue; } $currentLang = array_intersect_key($currentLang, Lang::$lang['en']); } $lang_code = readline('Enter the language you whish to localize: '); if (!isset(Lang::$lang[$lang_code])) { Lang::$lang[$lang_code] = Lang::$current_lang; echo 'New language detected!'.PHP_EOL.PHP_EOL; } else { echo 'Completing localization of existing language'.PHP_EOL.PHP_EOL; } $count = count(Lang::$lang[$lang_code]); $curcount = 0; ksort(Lang::$current_lang); foreach (Lang::$current_lang as $key => $value) { if (!(Lang::$lang[$lang_code][$key] ?? '')) { Lang::$lang[$lang_code][$key] = $value; } if (Lang::$lang[$lang_code][$key] === '' || (Lang::$lang[$lang_code][$key] === Lang::$lang['en'][$key] && Lang::$lang[$lang_code][$key] !== 'Bot')) { $value = Lang::$lang[$lang_code][$key]; if (in_array($key, ['v_error', 'v_tgerror'])) { $value = hex2bin($value); } if ($value == '') { $value = $key; } Lang::$lang[$lang_code][$key] = readline($value.' => '); /* if ($param_name === 'nonce' && $param_type === 'int128') { Lang::$lang[$lang_code][$key] = 'Random number for cryptographic security'; } elseif ($param_name === 'server_nonce' && $param_type === 'int128') { Lang::$lang[$lang_code][$key] = 'Random number for cryptographic security, given by server'; } elseif ($param_name === 'random_id' && $param_type === 'long') { Lang::$lang[$lang_code][$key] = 'Random number for cryptographic security'; } else elseif (\strpos($value, 'Update ') === 0) { if (!$param_name && \strpos($key, 'object_') === 0) { $value = \str_replace('Update ', '', $value).' update'; } //} elseif (ctype_lower($value[0])) { } else { Lang::$lang[$lang_code][$key] = \readline($value.' => '); if (Lang::$lang[$lang_code][$key] === '') { if ($param_name) { $l = \str_replace('_', ' ', $param_name); } else { $l = \explode('.', $method_name); $l = fromCamelCase(\end($l)); } $l = \ucfirst(\strtolower($l)); if (\preg_match('/ empty$/', $l)) { $l = 'Empty '.\strtolower(\preg_replace('/ empty$/', '', $l)); } foreach (['id', 'url', 'dc'] as $upper) { $l = \str_replace([\ucfirst($upper), ' '.$upper], [\strtoupper($upper), ' '.\strtoupper($upper)], $l); } if (\in_array($param_type, ['Bool', 'true', 'false'])) { $l .= '?'; } Lang::$lang[$lang_code][$key] = $l; echo 'Using default value '.Lang::$lang[$lang_code][$key].PHP_EOL; } }*/ Lang::$lang[$lang_code][$key] = ucfirst(Lang::$lang[$lang_code][$key]); if (in_array($key, ['v_error', 'v_tgerror'])) { Lang::$lang[$lang_code][$key] = bin2hex(Lang::$lang[$lang_code][$key]); } file_put_contents('src/danog/MadelineProto/Lang.php', sprintf($template, var_export(Lang::$lang, true), var_export(Lang::$lang['en'], true))); echo 'OK, '.($curcount * 100 / $count).'% done. edit src/danog/MadelineProto/Lang.php to fix mistakes.'.PHP_EOL; } $curcount++; } file_put_contents('src/danog/MadelineProto/Lang.php', sprintf($template, var_export(Lang::$lang, true), var_export(Lang::$lang['en'], true))); echo 'OK. edit src/danog/MadelineProto/Lang.php to fix mistakes.'.PHP_EOL; = 2) { \define(\MADELINE_WORKER_TYPE::class, \array_shift($arguments)); \define(\MADELINE_WORKER_ARGS::class, $arguments); } else { die('MadelineProto loader: you must include this file in another PHP script, see https://docs.madelineproto.xyz for more info.'.PHP_EOL); } \define('MADELINE_REAL_ROOT', \dirname($backtrace[0]["file"])); } $this->version = (string) \min(81, (int) (PHP_MAJOR_VERSION.PHP_MINOR_VERSION)); \define('MADELINE_PHAR_GLOB', \getcwd().DIRECTORY_SEPARATOR."madeline*-{$this->version}.phar"); \define('MADELINE_RELEASE_URL', \sprintf(self::RELEASE_TEMPLATE, $this->version)); } /** * Destructor. */ public function __destruct() { if ($this->lockInstaller) { \flock($this->lockInstaller, LOCK_UN); \fclose($this->lockInstaller); $this->lockInstaller = null; } } /** * Extract composer package versions from phar. * * @return array */ private static function extractVersions(?string $release): array { $release ??= ''; $phar = "madeline-$release.phar"; $packages = ['danog/madelineproto' => 'old']; if (!\file_exists("phar://$phar/vendor/composer/installed.json")) { return $packages; } $composer = \json_decode(\file_get_contents("phar://$phar/vendor/composer/installed.json"), true) ?: []; if (!isset($composer['packages'])) { return $packages; } foreach ($composer['packages'] as $dep) { $name = $dep['name']; if (\strpos($name, 'phabel/transpiler') === 0) { $name = \explode('/', $name, 3)[2]; } $version = $dep['version_normalized']; if ($name === 'danog/madelineproto' && \substr($version, 0, 2) === '90') { $version = \substr($version, 2); } $packages[$name] = $version; } return $packages; } /** * Report installs to composer. */ private static function reportComposer(?string $local_release, ?string $remote_release): void { $previous = self::extractVersions($local_release); $current = self::extractVersions($remote_release); $postData = ['downloads' => []]; foreach ($current as $name => $version) { if (isset($previous[$name]) && $previous[$name] === $version) { continue; } $postData['downloads'][] = [ 'name' => $name, 'version' => $version ]; } $phpVersion = 'PHP '.PHP_MAJOR_VERSION.'.'.PHP_MINOR_VERSION.'.'.PHP_RELEASE_VERSION; $opts = ['http' => [ 'method' => 'POST', 'header' => [ 'Content-Type: application/json', \sprintf( 'User-Agent: Composer/%s (%s; %s; %s; %s%s)', 'MProto v7', \function_exists('php_uname') ? @\php_uname('s') : 'Unknown', \function_exists('php_uname') ? @\php_uname('r') : 'Unknown', $phpVersion, 'streams', \getenv('CI') ? '; CI' : '' ) ], 'content' => \json_encode($postData), 'timeout' => 6, ], ]; @\file_get_contents("https://packagist.org/downloads/", false, \stream_context_create($opts)); } /** * Load phar file. */ private static function load(?string $release): mixed { if ($release === null) { if ((PHP_MAJOR_VERSION === 8 && PHP_MINOR_VERSION < 1) || PHP_MAJOR_VERSION <= 7) { throw new \Exception('MadelineProto requires at least PHP 8.1.'); } throw new \Exception('Could not download MadelineProto, please check your internet connection and PHP configuration!'); } $phar = "madeline-$release.phar"; if (!self::$lock) { self::$lock = \fopen("$phar.lock", 'c'); } \flock(self::$lock, LOCK_SH); $result = require_once $phar; if (\defined('MADELINE_WORKER_TYPE') && \constant('MADELINE_WORKER_TYPE') === 'madeline-ipc') { require_once "phar://$phar/vendor/danog/madelineproto/src/danog/MadelineProto/Ipc/Runner/entry.php"; } return $result; } /** * Unlock phar. * */ public static function unlock(): void { \flock(self::$lock, LOCK_UN); } /** * Lock installer. */ private function lock(string $version): bool { if ($this->lockInstaller) { return true; } $this->lockInstaller = \fopen($version, 'w'); return \flock($this->lockInstaller, LOCK_EX|LOCK_NB); } /** * Install MadelineProto. */ public function install() { $remote_release = \file_get_contents(MADELINE_RELEASE_URL) ?: null; $madeline_phar = "madeline-$remote_release.phar"; $madeline_version = "madeline-{$this->version}.phar.version"; if (\file_exists($madeline_version)) { $local_release = \file_get_contents($madeline_version) ?: null; } else { \touch($madeline_version); $local_release = null; } \define('HAD_MADELINE_PHAR', !!$local_release); if (($remote_release === $local_release && \file_exists($madeline_phar)) || $remote_release === null) { return self::load($local_release); } if (!$this->lock($madeline_version)) { \flock($this->lockInstaller, LOCK_EX); return $this->install(); } if (!\file_exists($madeline_phar)) { for ($x = 0; $x < 10; $x++) { $pharTest = \file_get_contents(\sprintf(self::PHAR_TEMPLATE, $this->version, $remote_release.$x)); if ($pharTest && \strpos($pharTest, $remote_release) !== false) { $phar = $pharTest; unset($pharTest); break; } \sleep(1); } if (!isset($phar)) { return self::load($local_release); } self::$lock = \fopen("$madeline_phar.lock", 'w'); \flock(self::$lock, LOCK_EX); \file_put_contents($madeline_phar, $phar); unset($phar); self::reportComposer($local_release, $remote_release); } \fwrite($this->lockInstaller, $remote_release); \fflush($this->lockInstaller); return self::load($remote_release); } } return (new \danog\MadelineProto\Installer)->install(); { "liteservers": [ { "ip": 861606190, "port": 9999, "id": { "@type": "pub.ed25519", "key": "T10NJq2tgx6LpTHj734fSNYJ6S2w1hTdFRXJaj5st80" } } ], "validator": { "@type": "validator.config.global", "zero_state": { "workchain": -1, "shard": -9223372036854775808, "seqno": 0, "root_hash": "F6OpKZKqvqeFp6CQmFomXNMfMj2EnaUSOXN+Mh+wVWk=", "file_hash": "XplPz01CXAps5qeSWUtxcyBfdAo5zVb1N979KLSKD24=" } } } { "liteservers": [ { "ip": 1137658550, "port": 4924, "id": { "@type": "pub.ed25519", "key": "peJTw/arlRfssgTuf9BMypJzqOi7SXEqSPSWiEw2U1M=" } } ], "validator": { "@type": "validator.config.global", "zero_state": { "workchain": -1, "shard": -9223372036854775808, "seqno": 0, "root_hash": "F6OpKZKqvqeFp6CQmFomXNMfMj2EnaUSOXN+Mh+wVWk=", "file_hash": "XplPz01CXAps5qeSWUtxcyBfdAo5zVb1N979KLSKD24=" } } } async(true); $API->loop( function () use ($API) { yield $API->connect(__DIR__.'/ton-lite-client-test1.config.json'); $API->logger(yield $API->liteServer->getTime()); } ); { "name": "danog/madelineproto", "description": "PHP implementation of telegram's MTProto protocol.", "type": "project", "license": "AGPL-3.0-only", "homepage": "https://docs.madelineproto.xyz", "keywords": [ "telegram", "mtproto", "protocol", "bytes", "messenger", "client", "PHP", "video", "stickers", "audio", "files", "GB" ], "conflict": { "krakjoe/pthreads-polyfill": "*", "ext-pthreads": "*" }, "require": { "php-64bit": ">=8.1", "danog/primemodule": "^1", "erusev/parsedown": "^1.7", "symfony/polyfill-mbstring": "*", "ext-mbstring": "*", "ext-json": "*", "ext-xml": "*", "ext-dom": "*", "ext-filter": "*", "ext-hash": "*", "ext-zlib": "*", "ext-fileinfo": "*", "amphp/amp": "^2", "amphp/http-client": "^4", "amphp/socket": "^1", "amphp/dns": "^1", "amphp/byte-stream": "^1", "amphp/file": "^2", "amphp/mysql": "^2", "amphp/postgres": "^1.2", "danog/dns-over-https": "^0.2", "amphp/http-client-cookies": "^1", "danog/tg-file-decoder": "^0.1", "danog/magicalserializer": "^1.0", "league/uri": "^6", "danog/ipc": "^0.1", "amphp/log": "^1.1", "danog/loop": "^0.1.0", "phpseclib/phpseclib": "^3", "amphp/redis": "^1.0", "symfony/polyfill-php80": "^1.18", "amphp/websocket-client": "^1.0", "psr/http-factory": "^1.0", "psr/log": "^1|^2|^3", "webmozart/assert": "^1.11" }, "require-dev": { "phpdocumentor/reflection-docblock": "^5.2", "ext-ctype": "*", "danog/phpdoc": "^0.1.7", "phpunit/phpunit": "^9", "bamarni/composer-bin-plugin": "1.5.0", "roave/security-advisories": "dev-latest", "symfony/yaml": "^6.0" }, "suggest": { "ext-primemodule": "Install the primemodule and FFI extensions to speed up MadelineProto (https://prime.madelineproto.xyz)", "ext-ffi": "Install the primemodule and FFI extensions to speed up MadelineProto (https://prime.madelineproto.xyz)", "ext-pdo": "Install pdo extension to support database used as cache", "ext-openssl": "Install the openssl extension for faster crypto", "ext-gmp": "Install the gmp extension for faster crypto" }, "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "autoload": { "psr-4": { "danog\\MadelineProto\\": "src/danog/MadelineProto" }, "files": [ "src/BigIntegor.php", "src/polyfill.php" ] }, "autoload-dev": { "psr-4": { "danog\\MadelineProto\\Test\\": "tests/danog/MadelineProto" }, "files": [ "tools/build_docs/schemas.php", "tools/build_docs/merge.php", "tools/build_docs/layerUpgrade.php" ] }, "scripts": { "build": [ "@docs", "@phpdoc", "@docs-fix", "@cs-fix", "@psalm" ], "phpdoc": [ "@phpdocInternal", "@phpdocMain" ], "check": [ "@cs", "@test" ], "test-php7": "tests/test-conversion.sh 70", "test-php56": "tests/test-conversion.sh 5", "cs": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff --dry-run", "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff", "psalm": "psalm", "phpdocMain": "php tools/phpdoc.php", "docs": "php tools/build_docs.php", "docs-fix": "tools/fix_docs.sh", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text --config tests/phpunit.xml", "bin": "echo 'bin not installed'", "post-install-cmd": ["@composer bin all install --ansi"], "post-update-cmd": ["@composer bin all update --ansi"] }, "extra": { "phabel": { "revision": 0 } }, "config": { "allow-plugins": { "bamarni/composer-bin-plugin": true, "phabel/phabel": true } } } #!/usr/bin/env php . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ use danog\MadelineProto\APIWrapper; use danog\MadelineProto\Settings; /* * Various ways to load MadelineProto */ if (file_exists(__DIR__.'/../vendor/autoload.php')) { include 'vendor/autoload.php'; } else { if (!file_exists('madeline.php')) { copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php'); } include 'madeline.php'; } class SecretHandler extends \danog\MadelineProto\EventHandler { private $sent = [-440592694 => true]; public function __construct(?APIWrapper $API) { parent::__construct($API); $this->sent = []; } /** * @var int|string Username or ID of bot admin */ const ADMIN = "danogentili"; // Change this /** * Get peer(s) where to report errors. * * @return int|string|array */ public function getReportPeers() { return [self::ADMIN]; } /** * Handle updates from users. * * @param array $update Update * */ public function onUpdateNewMessage(array $update): \Generator { if ($update['message']['message'] === 'request') { yield $this->requestSecretChat($update); } if ($update['message']['message'] === 'ping') { yield $this->messages->sendMessage(['message' => 'lmao', 'peer' => $update]); } } /** * Handle secret chat messages. * * @param array $update Update * */ public function onUpdateNewEncryptedMessage(array $update): \Generator { if (isset($update['message']['decrypted_message']['media'])) { $this->logger(yield $this->downloadToDir($update, '.')); } if (isset($this->sent[$update['message']['chat_id']])) { return; } $secret_media = []; // Photo uploaded as document, secret chat $secret_media['document_photo'] = ['peer' => $update, 'file' => 'tests/faust.jpg', 'message' => ['_' => 'decryptedMessage', 'ttl' => 0, 'message' => '', 'media' => ['_' => 'decryptedMessageMediaDocument', 'thumb' => file_get_contents('tests/faust.preview.jpg'), 'thumb_w' => 90, 'thumb_h' => 90, 'mime_type' => mime_content_type('tests/faust.jpg'), 'caption' => 'This file was uploaded using MadelineProto', 'file_name' => 'faust.jpg', 'size' => filesize('tests/faust.jpg'), 'attributes' => [['_' => 'documentAttributeImageSize', 'w' => 1280, 'h' => 914]]]]]; // Photo, secret chat $secret_media['photo'] = ['peer' => $update, 'file' => 'tests/faust.jpg', 'message' => ['_' => 'decryptedMessage', 'ttl' => 0, 'message' => '', 'media' => ['_' => 'decryptedMessageMediaPhoto', 'thumb' => file_get_contents('tests/faust.preview.jpg'), 'thumb_w' => 90, 'thumb_h' => 90, 'caption' => 'This file was uploaded using MadelineProto', 'size' => filesize('tests/faust.jpg'), 'w' => 1280, 'h' => 914]]]; // GIF, secret chat $secret_media['gif'] = ['peer' => $update, 'file' => 'tests/pony.mp4', 'message' => ['_' => 'decryptedMessage', 'ttl' => 0, 'message' => '', 'media' => ['_' => 'decryptedMessageMediaDocument', 'thumb' => file_get_contents('tests/pony.preview.jpg'), 'thumb_w' => 90, 'thumb_h' => 90, 'mime_type' => mime_content_type('tests/pony.mp4'), 'caption' => 'test', 'file_name' => 'pony.mp4', 'size' => filesize('tests/faust.jpg'), 'attributes' => [['_' => 'documentAttributeAnimated']]]]]; // Sticker, secret chat $secret_media['sticker'] = ['peer' => $update, 'file' => 'tests/lel.webp', 'message' => ['_' => 'decryptedMessage', 'ttl' => 0, 'message' => '', 'media' => ['_' => 'decryptedMessageMediaDocument', 'thumb' => file_get_contents('tests/lel.preview.jpg'), 'thumb_w' => 90, 'thumb_h' => 90, 'mime_type' => mime_content_type('tests/lel.webp'), 'caption' => 'test', 'file_name' => 'lel.webp', 'size' => filesize('tests/lel.webp'), 'attributes' => [['_' => 'documentAttributeSticker', 'alt' => 'LEL', 'stickerset' => ['_' => 'inputStickerSetEmpty']]]]]]; // Document, secrey chat $secret_media['document'] = ['peer' => $update, 'file' => 'tests/60', 'message' => ['_' => 'decryptedMessage', 'ttl' => 0, 'message' => '', 'media' => ['_' => 'decryptedMessageMediaDocument', 'thumb' => file_get_contents('tests/faust.preview.jpg'), 'thumb_w' => 90, 'thumb_h' => 90, 'mime_type' => 'magic/magic', 'caption' => 'test', 'file_name' => 'magic.magic', 'size' => filesize('tests/60'), 'attributes' => [['_' => 'documentAttributeFilename', 'file_name' => 'fairy']]]]]; // Video, secret chat $secret_media['video'] = ['peer' => $update, 'file' => 'tests/swing.mp4', 'message' => ['_' => 'decryptedMessage', 'ttl' => 0, 'message' => '', 'media' => ['_' => 'decryptedMessageMediaDocument', 'thumb' => file_get_contents('tests/swing.preview.jpg'), 'thumb_w' => 90, 'thumb_h' => 90, 'mime_type' => mime_content_type('tests/swing.mp4'), 'caption' => 'test', 'file_name' => 'swing.mp4', 'size' => filesize('tests/swing.mp4'), 'attributes' => [['_' => 'documentAttributeVideo', 'duration' => 5, 'w' => 1280, 'h' => 720]]]]]; // audio, secret chat $secret_media['audio'] = ['peer' => $update, 'file' => 'tests/mosconi.mp3', 'message' => ['_' => 'decryptedMessage', 'ttl' => 0, 'message' => '', 'media' => ['_' => 'decryptedMessageMediaDocument', 'thumb' => file_get_contents('tests/faust.preview.jpg'), 'thumb_w' => 90, 'thumb_h' => 90, 'mime_type' => mime_content_type('tests/mosconi.mp3'), 'caption' => 'test', 'file_name' => 'mosconi.mp3', 'size' => filesize('tests/mosconi.mp3'), 'attributes' => [['_' => 'documentAttributeAudio', 'voice' => false, 'duration' => 1, 'title' => 'AH NON LO SO IO', 'performer' => 'IL DIO GERMANO MOSCONI']]]]]; $secret_media['voice'] = ['peer' => $update, 'file' => 'tests/mosconi.mp3', 'message' => ['_' => 'decryptedMessage', 'ttl' => 0, 'message' => '', 'media' => ['_' => 'decryptedMessageMediaDocument', 'thumb' => file_get_contents('tests/faust.preview.jpg'), 'thumb_w' => 90, 'thumb_h' => 90, 'mime_type' => mime_content_type('tests/mosconi.mp3'), 'caption' => 'test', 'file_name' => 'mosconi.mp3', 'size' => filesize('tests/mosconi.mp3'), 'attributes' => [['_' => 'documentAttributeAudio', 'voice' => true, 'duration' => 1, 'title' => 'AH NON LO SO IO', 'performer' => 'IL DIO GERMANO MOSCONI']]]]]; foreach ($secret_media as $type => $smessage) { $promises = $this->messages->sendEncryptedFile($smessage); } yield $promises; $i = 0; while ($i < 10) { $this->logger("SENDING MESSAGE $i TO ".$update['message']['chat_id']); // You can also use the sendEncrypted parameter for more options in secret chats yield $this->messages->sendMessage(['peer' => $update, 'message' => (string) ($i++)]); } $this->sent[$update['message']['chat_id']] = true; } } $settings = new Settings; SecretHandler::startAndLoop('secret.madeline', $settings); #!/usr/bin/env php . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ if (function_exists('memprof_enable')) { memprof_enable(); } use Amp\Http\Server\HttpServer; use danog\MadelineProto\API; use danog\MadelineProto\APIWrapper; use danog\MadelineProto\MTProtoTools\Files; use danog\MadelineProto\RPCErrorException; use danog\MadelineProto\Settings; use danog\MadelineProto\Tools; use League\Uri\Contracts\UriException; /* * Various ways to load MadelineProto */ if (file_exists('vendor/autoload.php')) { include 'vendor/autoload.php'; } else { if (!file_exists('madeline.php')) { copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php'); } include 'madeline.php'; } /** * Event handler class. */ class MyEventHandler extends \danog\MadelineProto\EventHandler { const START = "Send me a file URL and I will download it and send it to you!\n\n". "Usage: `https://example.com`\n". "Usage: `https://example.com file name.ext`\n\n". "I can also rename Telegram files, just send me any file and I will rename it!\n\n". "Max 1.5GB, parallel upload and download powered by @MadelineProto."; /** * @var int|string Username or ID of bot admin */ const ADMIN = 'danogentili'; // Change this /** * Get peer(s) where to report errors. * * @return int|string|array */ public function getReportPeers() { return [self::ADMIN]; } /** * Whether to allow uploads. */ private $UPLOAD; /** * Array of media objects. * * @var array */ private $states = []; /** * Constructor. * * @param ?API $API API */ public function __construct(?APIWrapper $API) { $this->UPLOAD = class_exists(HttpServer::class); parent::__construct($API); } public function onStart() { $this->adminId = yield $this->getInfo(self::ADMIN)['bot_api_id']; } /** * Handle updates from channels and supergroups. * * @param array $update Update * * @return \Generator */ public function onUpdateNewChannelMessage(array $update) { //yield $this->onUpdateNewMessage($update); } /** * Handle updates from users. * * @param array $update Update * */ public function onUpdateNewMessage(array $update): \Generator { if ($update['message']['out'] ?? false) { return; } if ($update['message']['_'] !== 'message') { return; } try { $peer = yield $this->getInfo($update); $peerId = $peer['bot_api_id']; $messageId = $update['message']['id']; if ($this->UPLOAD && $update['message']['message'] === '/getUrl') { yield $this->messages->sendMessage(['peer' => $peerId, 'message' => 'Give me a file: ', 'reply_to_msg_id' => $messageId]); $this->states[$peerId] = $this->UPLOAD; return; } if ($update['message']['message'] === '/start') { return $this->messages->sendMessage(['peer' => $peerId, 'message' => self::START, 'parse_mode' => 'Markdown', 'reply_to_msg_id' => $messageId]); } if ($update['message']['message'] === '/report' && $peerId === $this->adminId) { memprof_dump_callgrind($stm = fopen("php://memory", "w")); fseek($stm, 0); yield $this->messages->sendMedia(['peer' => $peerId, 'media' => ['_' => 'inputMediaUploadedDocument', 'file' => $stm, 'attributes' => [['_' => 'documentAttributeFilename', 'file_name' => 'callgrind.out']]]]); fclose($stm); return; } if (isset($update['message']['media']['_']) && $update['message']['media']['_'] !== 'messageMediaWebPage') { if ($this->UPLOAD && ($this->states[$peerId] ?? false) === $this->UPLOAD) { unset($this->states[$peerId]); $update = Files::extractBotAPIFile(yield $this->MTProtoToBotAPI($update)); $file = [$update['file_size'], $update['mime_type']]; var_dump($update['file_id'].'.'.Tools::base64urlEncode(json_encode($file))."/".$update['file_name']); return; } yield $this->messages->sendMessage(['peer' => $peerId, 'message' => 'Give me a new name for this file: ', 'reply_to_msg_id' => $messageId]); $this->states[$peerId] = $update['message']['media']; return; } if (isset($this->states[$peerId])) { $name = $update['message']['message']; $url = $this->states[$peerId]; unset($this->states[$peerId]); } else { $url = explode(' ', $update['message']['message'], 2); $name = trim($url[1] ?? basename($update['message']['message'])); $url = trim($url[0]); if (!$url) { return; } if (stripos($url, 'http') !== 0) { $url = "http://$url"; } } $id = yield $this->messages->sendMessage(['peer' => $peerId, 'message' => 'Preparing...', 'reply_to_msg_id' => $messageId]); if (!isset($id['id'])) { $this->report(json_encode($id)); foreach ($id['updates'] as $updat) { if (isset($updat['id'])) { $id = $updat['id']; break; } } } else { $id = $id['id']; } $url = new \danog\MadelineProto\FileCallback( $url, function ($progress, $speed, $time) use ($peerId, $id) { $this->logger("Upload progress: $progress%"); static $prev = 0; $now = time(); if ($now - $prev < 10 && $progress < 100) { return; } $prev = $now; try { yield $this->messages->editMessage(['peer' => $peerId, 'id' => $id, 'message' => "Upload progress: $progress%\nSpeed: $speed mbps\nTime elapsed since start: $time"], ['FloodWaitLimit' => 0]); } catch (\danog\MadelineProto\RPCErrorException $e) { } } ); yield $this->messages->sendMedia( [ 'peer' => $peerId, 'reply_to_msg_id' => $messageId, 'media' => [ '_' => 'inputMediaUploadedDocument', 'file' => $url, 'attributes' => [ ['_' => 'documentAttributeFilename', 'file_name' => $name] ] ], 'message' => 'Powered by @MadelineProto!', 'parse_mode' => 'Markdown' ] ); if (in_array($peer['type'], ['channel', 'supergroup'])) { yield $this->channels->deleteMessages(['channel' => $peerId, 'id' => [$id]]); } else { yield $this->messages->deleteMessages(['revoke' => true, 'id' => [$id]]); } } catch (\Throwable $e) { if (strpos($e->getMessage(), 'Could not connect to URI') === false && !($e instanceof UriException) && strpos($e->getMessage(), 'URI') === false) { $this->report((string) $e); $this->logger((string) $e, \danog\MadelineProto\Logger::FATAL_ERROR); } if ($e instanceof RPCErrorException && $e->rpc === 'FILE_PARTS_INVALID') { $this->report(json_encode($url)); } try { yield $this->messages->editMessage(['peer' => $peerId, 'id' => $id, 'message' => 'Error: '.$e->getMessage()]); } catch (\Throwable $e) { $this->logger((string) $e, \danog\MadelineProto\Logger::FATAL_ERROR); } } } } $settings = new Settings; $settings->getConnection() ->setMinMediaSocketCount(20) ->setMaxMediaSocketCount(1000); // IMPORTANT: for security reasons, upload by URL will still be allowed $settings->getFiles()->setAllowAutomaticUpload(true); // Reduce boilerplate with new wrapper method. // Also initializes error reporting, catching and reporting all errors surfacing from the event loop. MyEventHandler::startAndLoop(($argv[1] ?? 'bot').'.madeline', $settings); #!/usr/bin/env php . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ use danog\MadelineProto\API; use danog\MadelineProto\EventHandler; use danog\MadelineProto\Logger; /* * Various ways to load MadelineProto */ if (file_exists('vendor/autoload.php')) { include 'vendor/autoload.php'; } else { if (!file_exists('madeline.php')) { copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php'); } include 'madeline.php'; } /** * Event handler class. */ class MyEventHandler extends EventHandler { /** * @var int|string Username or ID of bot admin */ const ADMIN = "danogentili"; // Change this /** * Get peer(s) where to report errors. * * @return int|string|array */ public function getReportPeers() { return [self::ADMIN]; } /** * Handle updates from supergroups and channels. * * @param array $update Update * */ public function onUpdateNewChannelMessage(array $update): \Generator { return $this->onUpdateNewMessage($update); } /** * Handle updates from users. * * @param array $update Update * */ public function onUpdateNewMessage(array $update): \Generator { if ($update['message']['_'] === 'messageEmpty' || $update['message']['out'] ?? false) { return; } $res = json_encode($update, JSON_PRETTY_PRINT); yield $this->messages->sendMessage(['peer' => $update, 'message' => "$res", 'reply_to_msg_id' => isset($update['message']['id']) ? $update['message']['id'] : null, 'parse_mode' => 'HTML']); if (isset($update['message']['media']) && $update['message']['media']['_'] !== 'messageMediaGame') { yield $this->messages->sendMedia(['peer' => $update, 'message' => $update['message']['message'], 'media' => $update]); } } } $MadelineProtos = []; foreach ([ 'bot.madeline' => 'Bot Login', 'user.madeline' => 'Userbot login', 'user2.madeline' => 'Userbot login (2)' ] as $session => $message) { Logger::log($message, Logger::WARNING); $MadelineProtos []= new API($session); } API::startAndLoopMulti($MadelineProtos, MyEventHandler::class); . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ require '../vendor/autoload.php'; $MadelineProto = new \danog\MadelineProto\API('index.madeline'); $me = $MadelineProto->start(); $me = $MadelineProto->getSelf(); \danog\MadelineProto\Logger::log($me); if (!$me['bot']) { $MadelineProto->messages->sendMessage(['peer' => '@danogentili', 'message' => "Hi!\nThanks for creating MadelineProto! <3"]); $MadelineProto->channels->joinChannel(['channel' => '@MadelineProto']); try { $MadelineProto->messages->importChatInvite(['hash' => 'https://t.me/joinchat/Bgrajz6K-aJKu0IpGsLpBg']); } catch (\danog\MadelineProto\RPCErrorException $e) { } $MadelineProto->messages->sendMessage(['peer' => 'https://t.me/joinchat/Bgrajz6K-aJKu0IpGsLpBg', 'message' => 'Testing MadelineProto!']); } echo 'OK, done!'.PHP_EOL; setUri('127.0.0.1:5432'); // postgres db default connection inforamtion $database->setUsername('wsudo'); // postgres db username $database->setPassword('12345678'); // postgres db password $database->setDatabase('MyBotsData');// which database madeline proto will store datas in that /* create default settings object */ $settings = new Settings; /* set and merge database settings to main settings */ $settings->setDb($database); /* create madeline proto session */ $MadelineProto = new API('madeline.session', $settings); /* start madeline proto workers */ $MadelineProto->start(); setUri('127.0.0.1:3306'); // local mysql service connection with default port $database->setUsername('Wsudo'); // mysql service username $database->setPassword('12345678'); // mysql service password $database->setDatabase('MyBotsData');// which database madeline proto will store datas in that /* create default settings object */ $settings = new Settings; /* set and merge database settings to main settings */ $settings->setDb($database); /* create madeline proto session */ $MadelineProto = new API('madeline.session', $settings); /* start madeline proto workers */ $MadelineProto->start(); setUri('127.0.0.1:6379');// redis service connection information with default port $database->setDatabase(0); // redis database number $database->setPassword('wsudo'); // redis service password /* create default settings object */ $settings = new Settings; /* set and merge database settings to main settings */ $settings->setDb($database); /* create madeline proto session */ $MadelineProto = new API('madeline.session', $settings); /* start madeline proto workers */ $MadelineProto->start(); setCleanup(true); // set clean up befor serialize session $database->setEnableFullPeerDb(false);// madeline proto could fetch peers full information ?? $database->setEnablePeerInfoDb(true); // enable peer basic info option /* create default settings object */ $settings = new Settings; /* set and merge database settings to main settings */ $settings->setDb($database); /* create madeline proto session */ $MadelineProto = new API('madeline.session', $settings); /* start madeline proto workers */ $MadelineProto->start(); #!/usr/bin/env php . * * @author Alexander Panlratov * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ /* * Various ways to load MadelineProto */ if (file_exists('vendor/autoload.php')) { include 'vendor/autoload.php'; } else { if (!file_exists('madeline.php')) { copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php'); } /** * @psalm-suppress MissingFile */ include 'madeline.php'; } $MadelineProto = new \danog\MadelineProto\API('bot.madeline'); $MadelineProto->async(true); $MadelineProto->loop(static function () use ($MadelineProto) { yield $MadelineProto->start(); $lastMessageId = 0; $threads = 5; $step = 20; $totalMessages = 0; $start = microtime(true); while (true) { $promises = []; for ($i = 0; $i < $threads; $i++) { $promises[] = $MadelineProto->messages->getMessages(['id' => range($lastMessageId+1, $lastMessageId+$step)]); $lastMessageId +=$step; } $results = yield \Amp\Promise\all($promises); foreach ($results as $result) { foreach ($result['messages'] as $message) { if ($message['_'] === 'messageEmpty') { break 3; } $totalMessages++; yield $MadelineProto->echo("\rTotal messages processed: {$totalMessages}"); } } }; $time = microtime(true)-$start; yield $MadelineProto->echo("\nTime: {$time}\n"); }); . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace phpseclib\Math { if (PHP_MAJOR_VERSION < 7 && !(\class_exists(\Phar::class) && \Phar::running() || \defined('TESTING_VERSIONS'))) { throw new \Exception('MadelineProto requires php 7 to run natively, use phar.madelineproto.xyz to run on PHP 5.6'); } if (\defined('HHVM_VERSION')) { $engines = [['PHP64', ['OpenSSL']], ['BCMath', ['OpenSSL']], ['PHP32', ['OpenSSL']]]; foreach ($engines as $engine) { try { \phpseclib3\Math\BigInteger::setEngine($engine[0], isset($engine[1]) ? $engine[1] : []); break; } catch (\Exception $e) { } } } class BigIntegor { } } namespace tgseclib\Math { use phpseclib3\Math\BigInteger as MathBigInteger; use Serializable; class BigInteger implements Serializable { public MathBigInteger $real; public function serialize(): void { //throw new \Exception("Can't serialize legacy class!"); } public function unserialize($data): void { $r = \unserialize($data); $this->real = new MathBigInteger($r['hex'], -16); if (isset($r['precision'])) { // recalculate $this->bitmask $this->real->setPrecision($r['precision']); } } public function __serialize(): array { return ['real' => $this->real]; } public function __unserialize(array $data): void { $this->real = $data['real']; } } } 'openFile', 'stat' => 'getStatus', 'lstat' => 'getLinkStatus', 'size' => 'getSize', 'isdir' => 'isDirectory', 'mtime' => 'getModificationTime', 'atime' => 'getAccessTime', 'ctime' => 'getCreationTime', 'symlink' => 'createSymlink', 'link' => 'createHardlink', 'readlink' => 'resolveSymlink', 'rename' => 'move', 'unlink' => 'deleteFile', 'rmdir' => 'deleteDirectory', 'scandir' => 'listFiles', 'chmod' => 'changePermissions', 'chown' => 'changeOwner', 'get' => 'read', 'put' => 'write', 'mkdir' => 'createDirectory', ] as $old => $new) { $ampFilePolyfill .= "function $old(...\$args) { return $new(...\$args); }"; } $ampFilePolyfill .= "}"; eval($ampFilePolyfill); unset($ampFilePolyfill); . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Http\Client\HttpClientBuilder; use Amp\Http\Client\Request; /** * Indicates an error returned by Telegram's API. */ class RPCErrorException extends \Exception { use TL\PrettyException; /** * RPC error code. */ public string $rpc = ''; private $fetched = false; public static $descriptions = ['RPC_MCGET_FAIL' => 'Telegram is having internal issues, please try again later.', 'RPC_CALL_FAIL' => 'Telegram is having internal issues, please try again later.', 'USER_PRIVACY_RESTRICTED' => "The user's privacy settings do not allow you to do this", 'CHANNEL_PRIVATE' => "You haven't joined this channel/supergroup", 'USER_IS_BOT' => "Bots can't send messages to other bots", 'BOT_METHOD_INVALID' => 'This method cannot be run by a bot', 'PHONE_CODE_EXPIRED' => 'The phone code you provided has expired, this may happen if it was sent to any chat on telegram (if the code is sent through a telegram chat (not the official account) to avoid it append or prepend to the code some chars)', 'USERNAME_INVALID' => 'The provided username is not valid', 'ACCESS_TOKEN_INVALID' => 'The provided token is not valid', 'ACTIVE_USER_REQUIRED' => 'The method is only available to already activated users', 'FIRSTNAME_INVALID' => 'The first name is invalid', 'LASTNAME_INVALID' => 'The last name is invalid', 'PHONE_NUMBER_INVALID' => 'The phone number is invalid', 'PHONE_CODE_HASH_EMPTY' => 'phone_code_hash is missing', 'PHONE_CODE_EMPTY' => 'phone_code is missing', 'API_ID_INVALID' => 'The api_id/api_hash combination is invalid', 'PHONE_NUMBER_OCCUPIED' => 'The phone number is already in use', 'PHONE_NUMBER_UNOCCUPIED' => 'The phone number is not yet being used', 'USERS_TOO_FEW' => 'Not enough users (to create a chat, for example)', 'USERS_TOO_MUCH' => 'The maximum number of users has been exceeded (to create a chat, for example)', 'TYPE_CONSTRUCTOR_INVALID' => 'The type constructor is invalid', 'FILE_PART_INVALID' => 'The file part number is invalid', 'FILE_PARTS_INVALID' => 'The number of file parts is invalid', 'MD5_CHECKSUM_INVALID' => 'The MD5 checksums do not match', 'PHOTO_INVALID_DIMENSIONS' => 'The photo dimensions are invalid', 'FIELD_NAME_INVALID' => 'The field with the name FIELD_NAME is invalid', 'FIELD_NAME_EMPTY' => 'The field with the name FIELD_NAME is missing', 'MSG_WAIT_FAILED' => 'A waiting call returned an error', 'USERNAME_NOT_OCCUPIED' => 'The provided username is not occupied', 'PHONE_NUMBER_BANNED' => 'The provided phone number is banned from telegram', 'AUTH_KEY_UNREGISTERED' => 'The authorization key has expired', 'INVITE_HASH_EXPIRED' => 'The invite link has expired', 'USER_DEACTIVATED' => 'The user was deactivated', 'USER_ALREADY_PARTICIPANT' => 'The user is already in the group', 'MESSAGE_ID_INVALID' => 'The provided message id is invalid', 'PEER_ID_INVALID' => 'The provided peer id is invalid', 'CHAT_ID_INVALID' => 'The provided chat id is invalid', 'MESSAGE_DELETE_FORBIDDEN' => "You can't delete one of the messages you tried to delete, most likely because it is a service message.", 'CHAT_ADMIN_REQUIRED' => 'You must be an admin in this chat to do this', -429 => 'Too many requests', 'PEER_FLOOD' => "You are spamreported, you can't do this"]; public static $errorMethodMap = []; private $caller = ''; public static function localizeMessage($method, int $code, string $error) { if (!$method || !$code || !$error) { return $error; } $error = \preg_replace('/\\d+$/', "X", $error); $description = self::$descriptions[$error] ?? ''; if (!isset(self::$errorMethodMap[$code][$method][$error]) || !isset(self::$descriptions[$error])) { Tools::callFork((function () use ($method, $code, $error) { try { $res = \json_decode( yield (yield HttpClientBuilder::buildDefault() ->request(new Request('https://rpc.pwrtelegram.xyz/?method='.$method.'&code='.$code.'&error='.$error)) )->getBody()->buffer(), true ); if (isset($res['ok']) && $res['ok'] && isset($res['result'])) { $description = $res['result']; RPCErrorException::$descriptions[$error] = $description; RPCErrorException::$errorMethodMap[$code][$method][$error] = $error; } } catch (\Throwable $e) { } })()); } if (!$description) { return $error; } return $description; } public function __toString() { $this->localized ??= self::localizeMessage($this->caller, $this->code, $this->message); $result = \sprintf(\danog\MadelineProto\Lang::$current_lang['rpc_tg_error'], $this->localized." ({$this->code})", $this->rpc, $this->file, $this->line.PHP_EOL, \danog\MadelineProto\Magic::$revision.PHP_EOL.PHP_EOL).PHP_EOL.$this->getTLTrace().PHP_EOL; if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg') { $result = \str_replace(PHP_EOL, '
'.PHP_EOL, $result); } return $result; } /** * Get localized error name. * */ public function getLocalization(): string { $this->localized ??= self::localizeMessage($this->caller, $this->code, $this->message); return $this->localized; } /** * Set localized error name. * */ public function setLocalization(string $localization): void { $this->localized = $localization; } public function __construct($message = null, $code = 0, $caller = '', Exception $previous = null) { $this->rpc = $message; parent::__construct($message, $code, $previous); if (\is_string($caller)) { $this->prettifyTL($caller); $this->caller = $caller; $additional = []; foreach ($this->getTrace() as $level) { if (isset($level['function']) && $level['function'] === 'methodCall') { $this->line = $level['line']; $this->file = $level['file']; } } } $this->getLocalization(); /* if (\in_array($this->rpc, ['CHANNEL_PRIVATE', -404, -429, 'USERNAME_NOT_OCCUPIED', 'ACCESS_TOKEN_INVALID', 'AUTH_KEY_UNREGISTERED', 'SESSION_PASSWORD_NEEDED', 'PHONE_NUMBER_UNOCCUPIED', 'PEER_ID_INVALID', 'CHAT_ID_INVALID', 'USERNAME_INVALID', 'CHAT_WRITE_FORBIDDEN', 'CHAT_ADMIN_REQUIRED', 'PEER_FLOOD'])) { return; } if (\strpos($this->rpc, 'FLOOD_WAIT_') !== false) { return; } $message === 'Telegram is having internal issues, please try again later.' ? \Rollbar\Rollbar::log(\Rollbar\Payload\Level::critical(), $message) : \Rollbar\Rollbar::log(\Rollbar\Payload\Level::error(), $this, $additional); */ } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; /** * Indicates a security error. */ class SecurityException extends \Exception { } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\ByteStream\ResourceOutputStream; use Amp\Failure; use Amp\Loop; use danog\MadelineProto\Settings\Logger as SettingsLogger; use Psr\Log\LoggerInterface; use function Amp\ByteStream\getStderr; use function Amp\ByteStream\getStdout; /** * Logger class. */ class Logger { /** * @internal ANSI foreground color escapes */ const FOREGROUND = ['default' => 39, 'black' => 30, 'red' => 31, 'green' => 32, 'yellow' => 33, 'blue' => 34, 'magenta' => 35, 'cyan' => 36, 'light_gray' => 37, 'dark_gray' => 90, 'light_red' => 91, 'light_green' => 92, 'light_yellow' => 93, 'light_blue' => 94, 'light_magenta' => 95, 'light_cyan' => 96, 'white' => 97]; /** * @internal ANSI background color escapes */ const BACKGROUND = ['default' => 49, 'black' => 40, 'red' => 41, 'magenta' => 45, 'yellow' => 43, 'green' => 42, 'blue' => 44, 'cyan' => 46, 'light_gray' => 47, 'dark_gray' => 100, 'light_red' => 101, 'light_green' => 102, 'light_yellow' => 103, 'light_blue' => 104, 'light_magenta' => 105, 'light_cyan' => 106, 'white' => 107]; /** * @internal ANSI modifier escapes */ const SET = ['bold' => 1, 'dim' => 2, 'underlined' => 3, 'blink' => 4, 'reverse' => 5, 'hidden' => 6]; /** * @internal ANSI reset modifier escapes */ const RESET = ['all' => 0, 'bold' => 21, 'dim' => 22, 'underlined' => 24, 'blink' => 25, 'reverse' => 26, 'hidden' => 28]; /** * Logging mode. * * @var integer */ public $mode = 0; /** * Optional logger parameter. * * @var null|string|callable */ public $optional = null; /** * Logger prefix. * * @var string */ public $prefix = ''; /** * Logging level. * * @var integer */ public $level = self::NOTICE; /** * Logging colors. * * @var array */ public $colors = []; /** * Newline. * * @var string */ public $newline = "\n"; /** * Logfile. * * @var ResourceOutputStream */ public $stdout; /** * Default logger instance. * * @var self */ public static $default; /** * Whether the AGPL notice was printed. * * @var boolean */ public static $printed = false; /** * Log rotation loop ID. */ private string $rotateId = ''; /** * PSR logger. */ private PsrLogger $psr; /** * Ultra verbose logging. * * @internal */ const ULTRA_VERBOSE = 5; /** * Verbose logging. * * @internal */ const VERBOSE = 4; /** * Notice logging. * * @internal */ const NOTICE = 3; /** * Warning logging. * * @internal */ const WARNING = 2; /** * Error logging. * * @internal */ const ERROR = 1; /** * Log only fatal errors. * * @internal */ const FATAL_ERROR = 0; /** * Disable logger (DEPRECATED). * * @internal * @deprecated */ const NO_LOGGER = 0; /** * Default logger (syslog). * * @internal */ const DEFAULT_LOGGER = 1; /** * File logger. * * @internal */ const FILE_LOGGER = 2; /** * Echo logger. * * @internal */ const ECHO_LOGGER = 3; /** * Callable logger. * * @internal */ const CALLABLE_LOGGER = 4; /** * Ultra verbose level. */ const LEVEL_ULTRA_VERBOSE = self::ULTRA_VERBOSE; /** * Verbose level. */ const LEVEL_VERBOSE = self::VERBOSE; /** * Notice level. */ const LEVEL_NOTICE = self::NOTICE; /** * Warning level. */ const LEVEL_WARNING = self::WARNING; /** * Error level. */ const LEVEL_ERROR = self::ERROR; /** * Fatal error level. */ const LEVEL_FATAL = self::FATAL_ERROR; /** * Default logger (syslog). */ const LOGGER_DEFAULT = self::DEFAULT_LOGGER; /** * Echo logger. */ const LOGGER_ECHO = self::ECHO_LOGGER; /** * File logger. */ const LOGGER_FILE = self::FILE_LOGGER; /** * Callable logger. */ const LOGGER_CALLABLE = self::CALLABLE_LOGGER; /** * Construct global static logger from MadelineProto settings. * * @param SettingsLogger $settings Settings instance * */ public static function constructorFromSettings(SettingsLogger $settings): self { return self::$default = new self($settings); } /** * Construct logger. * */ public function __construct(SettingsLogger $settings, string $prefix = '') { $this->psr = new PsrLogger($this); $this->prefix = $prefix === '' ? '' : ', '.$prefix; $this->mode = $settings->getType(); $this->optional = $settings->getExtra(); $this->level = $settings->getLevel(); $maxSize = $settings->getMaxSize(); if ($this->mode === self::FILE_LOGGER) { if (!$this->optional || !\file_exists(\pathinfo($this->optional, PATHINFO_DIRNAME))) { $this->optional = Magic::$script_cwd.DIRECTORY_SEPARATOR.'MadelineProto.log'; } if (!\str_ends_with($this->optional, '.log')) { $this->optional .= '.log'; } if ($maxSize !== -1 && \file_exists($this->optional) && \filesize($this->optional) > $maxSize) { \file_put_contents($this->optional, ''); } } $this->colors[self::ULTRA_VERBOSE] = \implode(';', [self::FOREGROUND['light_gray'], self::SET['dim']]); $this->colors[self::VERBOSE] = \implode(';', [self::FOREGROUND['green'], self::SET['bold']]); $this->colors[self::NOTICE] = \implode(';', [self::FOREGROUND['yellow'], self::SET['bold']]); $this->colors[self::WARNING] = \implode(';', [self::FOREGROUND['white'], self::SET['dim'], self::BACKGROUND['red']]); $this->colors[self::ERROR] = \implode(';', [self::FOREGROUND['white'], self::SET['bold'], self::BACKGROUND['red']]); $this->colors[self::FATAL_ERROR] = \implode(';', [self::FOREGROUND['red'], self::SET['bold'], self::BACKGROUND['light_gray']]); $this->newline = PHP_EOL; if ($this->mode === self::ECHO_LOGGER) { $this->stdout = getStdout(); if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg') { $this->newline = '
'.$this->newline; } } elseif ($this->mode === self::FILE_LOGGER) { $this->stdout = new ResourceOutputStream(\fopen($this->optional, 'a')); if ($maxSize !== -1) { $optional = &$this->optional; $stdout = &$this->stdout; $this->rotateId = Loop::repeat( 10*1000, static function () use ($maxSize, $optional, &$stdout): void { \clearstatcache(true, $optional); if (\file_exists($optional) && \filesize($optional) >= $maxSize) { \ftruncate($stdout->getResource(), 0); self::log("Automatically truncated logfile to $maxSize"); } } ); Loop::unreference($this->rotateId); } } elseif ($this->mode === self::DEFAULT_LOGGER) { $result = @\ini_get('error_log'); if ($result === 'syslog') { $this->stdout = getStderr(); } elseif ($result) { $this->stdout = new ResourceOutputStream(\fopen($result, 'a+')); } else { $this->stdout = getStderr(); } } self::$default = $this; if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg') { try { \error_reporting(E_ALL); \ini_set('log_errors', "1"); \ini_set('error_log', $this->mode === self::FILE_LOGGER ? $this->optional : Magic::$script_cwd.DIRECTORY_SEPARATOR.'MadelineProto.log'); } catch (\danog\MadelineProto\Exception $e) { $this->logger('Could not enable PHP logging'); } } } /** * Destructor function. */ public function __destruct() { if ($this->rotateId) { Loop::cancel($this->rotateId); } } /** * Log a message. * * @param mixed $param Message * @param int $level Logging level * */ public static function log($param, int $level = self::NOTICE): void { if (!\is_null(self::$default)) { self::$default->logger($param, $level, \basename(\debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 1)[0]['file'], '.php')); } else { echo $param.PHP_EOL; } } /** * Log a message. * * @param mixed $param Message to log * @param int $level Logging level * @param string $file File that originated the message * */ public function logger($param, int $level = self::NOTICE, string $file = ''): void { if ($level > $this->level) { return; } if (Magic::$suspendPeriodicLogging) { Magic::$suspendPeriodicLogging->promise()->onResolve(fn () => $this->logger($param, $level, $file)); return; } if (!self::$printed) { self::$printed = true; $this->colors[self::NOTICE] = \implode(';', [self::FOREGROUND['light_gray'], self::SET['bold'], self::BACKGROUND['blue']]); $this->logger('MadelineProto'); $this->logger('Copyright (C) 2016-'.\date('Y').' Daniil Gentili'); $this->logger('Licensed under AGPLv3'); $this->logger('https://github.com/danog/MadelineProto'); $this->colors[self::NOTICE] = \implode(';', [self::FOREGROUND['yellow'], self::SET['bold']]); } if ($this->mode === self::CALLABLE_LOGGER) { \call_user_func_array($this->optional, [$param, $level]); return; } $prefix = $this->prefix; if ($param instanceof \Throwable) { $param = (string) $param; } elseif (!\is_string($param)) { $param = \json_encode($param, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES); } if (empty($file)) { $file = \basename(\debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 1)[0]['file'], '.php'); } $param = \str_pad($file.$prefix.': ', 16 + \strlen($prefix))."\t".$param; if ($this->mode === self::DEFAULT_LOGGER) { if ($this->stdout->write($param.$this->newline) instanceof Failure) { \error_log($param); } return; } $param = Magic::$isatty ? "\33[".$this->colors[$level].'m'.$param."\33[0m".$this->newline : $param.$this->newline; if ($this->stdout->write($param) instanceof Failure) { switch ($this->mode) { case self::ECHO_LOGGER: echo $param; break; case self::FILE_LOGGER: \file_put_contents($this->optional, $param, FILE_APPEND); break; } } } /** * Get PSR logger. * */ public function getPsrLogger(): LoggerInterface { return $this->psr; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools; use Amp\Promise; use danog\MadelineProto\Db\DbArray; use danog\MadelineProto\Db\DbPropertiesTrait; use danog\MadelineProto\MTProto; use danog\MadelineProto\TL\TLCallback; /** * Manages min peers. */ class MinDatabase implements TLCallback { use DbPropertiesTrait; const SWITCH_CONSTRUCTORS = ['inputChannel', 'inputUser', 'inputPeerUser', 'inputPeerChannel']; const CATCH_PEERS = ['message', 'messageService', 'peerUser', 'peerChannel', 'messageEntityMentionName', 'messageFwdHeader', 'messageActionChatCreate', 'messageActionChatAddUser', 'messageActionChatDeleteUser', 'messageActionChatJoinedByLink']; const ORIGINS = ['message', 'messageService']; /** * References indexed by location. * * @var DbArray */ private $db; /** * Temporary cache during deserialization. * * @var array */ private $cache = []; /** * Instance of MTProto. * * @var \danog\MadelineProto\MTProto */ private $API; /** * Whether we cleaned up old database information. * * @var boolean */ private $clean = false; /** * List of properties stored in database (memory or external). * @see DbPropertiesFactory */ protected static array $dbProperties = [ 'db' => 'array', ]; public function __construct(MTProto $API) { $this->API = $API; } public function __sleep() { return ['db', 'API', 'clean']; } public function init(): \Generator { yield from $this->initDb($this->API); if (!$this->API->getSettings()->getDb()->getEnableMinDb()) { yield $this->db->clear(); } if ($this->clean) { return; } \Amp\Loop::defer(function () { $iterator = $this->db->getIterator(); while (yield $iterator->advance()) { [$id, $origin] = $iterator->getCurrent(); if (!isset($origin['peer']) || $origin['peer'] === $id) { $this->db->unset($id); } } $this->clean = true; }); } public function getMethodCallbacks(): array { return []; } public function getMethodBeforeCallbacks(): array { return []; } public function getConstructorCallbacks(): array { return \array_merge(\array_fill_keys(self::CATCH_PEERS, [[$this, 'addPeer']]), \array_fill_keys(self::ORIGINS, [[$this, 'addOrigin']])); } public function getConstructorBeforeCallbacks(): array { return \array_fill_keys(self::ORIGINS, [[$this, 'addOriginContext']]); } public function getConstructorSerializeCallbacks(): array { return \array_fill_keys(self::SWITCH_CONSTRUCTORS, [$this, 'populateFrom']); } public function getTypeMismatchCallbacks(): array { return []; } public function reset(): void { if ($this->cache) { $this->API->logger->logger('Found '.\count($this->cache).' pending contexts', \danog\MadelineProto\Logger::ERROR); $this->cache = []; } } public function addPeer(array $location): bool { $peers = []; switch ($location['_']) { case 'messageFwdHeader': if (isset($location['from_id'])) { $peers[$this->API->getId($location['from_id'])] = true; } if (isset($location['channel_id'])) { $peers[$this->API->toSupergroup($location['channel_id'])] = true; } break; case 'messageActionChatCreate': case 'messageActionChatAddUser': foreach ($location['users'] as $user) { $peers[$user] = true; } break; case 'message': $peers[$this->API->getId($location['peer_id'])] = true; if (isset($location['from_id'])) { $peers[$this->API->getId($location['from_id'])] = true; } break; default: $peers[$this->API->getId($location)] = true; } $this->API->logger->logger("Caching peer location info from location from {$location['_']}", \danog\MadelineProto\Logger::ULTRA_VERBOSE); $key = \count($this->cache) - 1; foreach ($peers as $id => $true) { $this->cache[$key][$id] = $id; } return true; } public function addOriginContext(string $type): void { $this->API->logger->logger("Adding peer origin context for {$type}!", \danog\MadelineProto\Logger::ULTRA_VERBOSE); $this->cache[] = []; } public function addOrigin(array $data = []): void { $cache = \array_pop($this->cache); if ($cache === null) { throw new \danog\MadelineProto\Exception('Trying to add origin with no origin context set'); } $origin = []; switch ($data['_']) { case 'message': case 'messageService': $origin['peer'] = $this->API->getId($data); $origin['msg_id'] = $data['id']; break; default: throw new \danog\MadelineProto\Exception("Unknown origin type provided: {$data['_']}"); } foreach ($cache as $id) { if ($origin['peer'] === $id) { continue; } $this->db[$id] = $origin; } $this->API->logger->logger("Added origin ({$data['_']}) to ".\count($cache).' peer locations', \danog\MadelineProto\Logger::ULTRA_VERBOSE); } public function populateFrom(array $object): \Generator { if (!($object['min'] ?? false)) { return $object; } $id = $this->API->getId($object); $dbObject = yield $this->db[$id]; if ($dbObject) { $new = \array_merge($object, $dbObject); $new['_'] .= 'FromMessage'; $new['peer'] = yield from $this->API->getInputPeer($new['peer']); if ($new['peer']['min']) { $this->API->logger->logger("Don't have origin peer subinfo with min peer {$id}, this may fail"); return $object; } return $new; } $this->API->logger->logger("Don't have origin info with min peer {$id}, this may fail"); return $object; } /** * Check if location info is available for peer. * * @param float|int $id Peer ID * * @psalm-return Promise */ public function hasPeer($id): Promise { return $this->db->isset($id); } public function __debugInfo() { return ['MinDatabase instance '.\spl_object_hash($this)]; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools; use Amp\Promise; use AssertionError; use danog\Decoder\FileId; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceDialogPhoto; use danog\MadelineProto\Db\DbArray; use danog\MadelineProto\Logger; use danog\MadelineProto\Magic; use danog\MadelineProto\MTProto; use danog\MadelineProto\RPCErrorException; use danog\MadelineProto\Settings; use danog\MadelineProto\Tools; use InvalidArgumentException; use Webmozart\Assert\Assert; use const danog\Decoder\PHOTOSIZE_SOURCE_DIALOGPHOTO_BIG; use const danog\Decoder\PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL; use const danog\Decoder\PROFILE_PHOTO; /** * Manages peers. * * @property Settings $settings Settings */ trait PeerHandler { /** * Convert MTProto channel ID to bot API channel ID. * * @param int $id MTProto channel ID * */ public static function toSupergroup($id): int { return Magic::ZERO_CHANNEL_ID - $id; } /** * Convert bot API channel ID to MTProto channel ID. * * @param int $id Bot API channel ID * */ public static function fromSupergroup($id): int { return (-$id) + Magic::ZERO_CHANNEL_ID; } /** * Check whether provided bot API ID is a channel. * * @param int $id Bot API ID * * @return boolean */ public static function isSupergroup($id): bool { return $id < Magic::ZERO_CHANNEL_ID; } /** * Set support info. * * @param array $support Support info * * @internal * */ public function addSupport(array $support): void { $this->supportUser = $support['user']['id']; } /** * Add user info. * * @param array $user User info * * @throws \danog\MadelineProto\Exception */ public function addUser(array $user): \Generator { if ($user['_'] === 'userEmpty') { return; } if ($user['_'] !== 'user') { throw new AssertionError('Invalid user type '.$user['_']); } if ($user['id'] === ($this->authorization['user']['id'] ?? null)) { $this->authorization['user'] = $user; } $existingChat = yield $this->chats[$user['id']]; if (!isset($user['access_hash']) && !($user['min'] ?? false)) { if (isset($existingChat['access_hash'])) { $this->logger->logger("No access hash with user {$user['id']}, using backup"); $user['access_hash'] = $existingChat['access_hash']; } else { Assert::null($existingChat); try { yield $this->methodCallAsyncRead('users.getUsers', ['id' => [[ '_' => 'inputUser', 'user_id' => $user['id'], 'access_hash' => 0 ]]]); return; } catch (RPCErrorException $e) { $this->logger->logger("An error occurred while trying to fetch the missing access_hash for user {$user['id']}: {$e->getMessage()}", Logger::FATAL_ERROR); } foreach ($this->getUsernames($user) as $username) { if ((yield from $this->resolveUsername($username)) === $user['id']) { return; } } return; } } if ($existingChat !== $user) { $this->logger->logger("Updated user {$user['id']}", Logger::ULTRA_VERBOSE); if (($user['min'] ?? false) && !($existingChat['min'] ?? false)) { $this->logger->logger("{$user['id']} is min, filling missing fields", Logger::ULTRA_VERBOSE); if (isset($existingChat['access_hash'])) { $user['min'] = false; $user['access_hash'] = $existingChat['access_hash']; } } yield from $this->decacheChatUsername($user['id'], $existingChat); yield from $this->cacheChatUsername($user['id'], $user); if (!$this->getSettings()->getDb()->getEnablePeerInfoDb()) { $user = [ '_' => $user['_'], 'id' => $user['id'], 'access_hash' => $user['access_hash'] ?? null, 'min' => $user['min'] ?? false, ]; } yield $this->chats->set($user['id'], $user); } } /** * Add chat to database. * * @param array $chat Chat * * @internal * * @psalm-return \Generator */ public function addChat($chat): \Generator { if ($chat['_'] === 'chat' || $chat['_'] === 'chatEmpty' || $chat['_'] === 'chatForbidden' ) { $existingChat = yield $this->chats[-$chat['id']]; if (!$existingChat || $existingChat !== $chat) { $this->logger->logger("Updated chat -{$chat['id']}", Logger::ULTRA_VERBOSE); if (!$this->getSettings()->getDb()->getEnablePeerInfoDb()) { $chat = [ '_' => $chat['_'], 'id' => $chat['id'], 'access_hash' => $chat['access_hash'] ?? null, 'min' => $chat['min'] ?? false, ]; } yield $this->chats->set(-$chat['id'], $chat); } return; } if ($chat['_'] === 'channelEmpty') { return; } if ($chat['_'] !== 'channel' && $chat['_'] !== 'channelForbidden') { throw new InvalidArgumentException("Invalid chat type ".$chat['_']); } $bot_api_id = $this->toSupergroup($chat['id']); $existingChat = yield $this->chats[$bot_api_id]; if (!isset($chat['access_hash']) && !($chat['min'] ?? false)) { if (isset($existingChat['access_hash'])) { $this->logger->logger("No access hash with channel {$bot_api_id}, using backup"); $chat['access_hash'] = $existingChat['access_hash']; } else { Assert::null($existingChat); try { yield $this->methodCallAsyncRead('channels.getChannels', ['id' => [[ '_' => 'inputChannel', 'channel_id' => $chat['id'], 'access_hash' => 0 ]]]); return; } catch (RPCErrorException $e) { $this->logger->logger("An error occurred while trying to fetch the missing access_hash for channel {$bot_api_id}: {$e->getMessage()}", Logger::FATAL_ERROR); } foreach ($this->getUsernames($chat) as $username) { if ((yield from $this->resolveUsername($username)) === $bot_api_id) { return; } } return; } } if ($existingChat !== $chat) { yield from $this->decacheChatUsername($bot_api_id, $existingChat); yield from $this->cacheChatUsername($bot_api_id, $chat); $this->logger->logger("Updated chat {$bot_api_id}", Logger::ULTRA_VERBOSE); if (($chat['min'] ?? false) && $existingChat && !($existingChat['min'] ?? false)) { $this->logger->logger("{$bot_api_id} is min, filling missing fields", Logger::ULTRA_VERBOSE); $newchat = $existingChat; foreach (['title', 'username', 'usernames', 'photo', 'banned_rights', 'megagroup', 'verified'] as $field) { if (isset($chat[$field])) { $newchat[$field] = $chat[$field]; } } $chat = $newchat; } if (!$this->getSettings()->getDb()->getEnablePeerInfoDb()) { $chat = [ '_' => $chat['_'], 'id' => $chat['id'], 'access_hash' => $chat['access_hash'] ?? null, 'min' => $chat['min'] ?? false, ]; } yield $this->chats->set($bot_api_id, $chat); } } private function cacheChatUsername(int $id, array $chat): \Generator { if (!$this->getSettings()->getDb()->getEnableUsernameDb()) { return; } foreach ($this->getUsernames($chat) as $username) { yield $this->usernames->offsetSet($username, $id); } } private function decacheChatUsername(int $id, ?array $chat): \Generator { if (!$chat || !$this->getSettings()->getDb()->getEnableUsernameDb()) { return; } foreach ($this->getUsernames($chat) as $username) { if ((yield $this->usernames->offsetGet($username)) === $id) { yield $this->usernames->unset($username); } } } /** * @return list */ private static function getUsernames(array $constructor): array { $usernames = []; if ($constructor['_'] === 'user' || $constructor['_'] === 'channel') { if (isset($constructor['username'])) { $usernames []= \strtolower($constructor['username']); } foreach ($constructor['usernames'] ?? [] as ['username' => $username]) { $usernames []= \strtolower($username); } } return $usernames; } /** * Check if peer is present in internal peer database. * * @param mixed $id Peer * * @psalm-return \Generator */ public function peerIsset($id): \Generator { try { return yield $this->chats->isset($this->getId($id, MTProto::INFO_TYPE_ID)); } catch (\danog\MadelineProto\Exception $e) { return false; } catch (\danog\MadelineProto\RPCErrorException $e) { if ($e->rpc === 'CHAT_FORBIDDEN') { return true; } if ($e->rpc === 'CHANNEL_PRIVATE') { return true; } return false; } } /** * Check if all peer entities are in db. * * @param array $entities Entity list * * @internal * * @return \Generator */ public function entitiesPeerIsset(array $entities): \Generator { try { foreach ($entities as $entity) { if ($entity['_'] === 'messageEntityMentionName' || $entity['_'] === 'inputMessageEntityMentionName') { if (!(yield from $this->peerIsset($entity['user_id']))) { return false; } } } } catch (\danog\MadelineProto\Exception $e) { return false; } return true; } /** * Check if fwd peer is set. * * @param array $fwd Forward info * * @internal */ public function fwdPeerIsset(array $fwd): \Generator { try { if (isset($fwd['user_id']) && !(yield from $this->peerIsset($fwd['user_id']))) { return false; } if (isset($fwd['channel_id']) && !(yield from $this->peerIsset($this->toSupergroup($fwd['channel_id'])))) { return false; } } catch (\danog\MadelineProto\Exception $e) { return false; } return true; } /** * Get folder ID from object. * * @param mixed $id Object * * @return ?int */ public static function getFolderId($id): ?int { if (!\is_array($id)) { return null; } if (!isset($id['folder_id'])) { return null; } return $id['folder_id']; } /** * Get bot API ID from peer object. * * @param mixed $id Peer */ public function getId($id): ?int { if (\is_array($id)) { switch ($id['_']) { case 'updateDialogPinned': case 'updateDialogUnreadMark': case 'updateNotifySettings': $id = $id['peer']; // no break case 'updateDraftMessage': case 'inputDialogPeer': case 'dialogPeer': case 'inputNotifyPeer': case 'notifyPeer': case 'dialog': case 'help.proxyDataPromo': case 'updateChatDefaultBannedRights': case 'folderPeer': case 'inputFolderPeer': return $this->getId($id['peer']); case 'inputUserFromMessage': case 'inputPeerUserFromMessage': return $id['user_id']; case 'inputChannelFromMessage': case 'inputPeerChannelFromMessage': case 'updateChannelParticipant': return $this->toSupergroup($id['channel_id']); case 'inputUserSelf': case 'inputPeerSelf': return $this->authorization['user']['id']; case 'user': return $id['id']; case 'userFull': return $id['id']; case 'inputPeerUser': case 'inputUser': case 'peerUser': case 'messageEntityMentionName': case 'messageActionChatDeleteUser': return $id['user_id']; case 'messageActionChatJoinedByLink': return $id['inviter_id']; case 'chat': case 'chatForbidden': case 'chatFull': return -$id['id']; case 'inputPeerChat': case 'peerChat': return -$id['chat_id']; case 'channelForbidden': case 'channel': case 'channelFull': return $this->toSupergroup($id['id']); case 'inputPeerChannel': case 'inputChannel': case 'peerChannel': return $this->toSupergroup($id['channel_id']); case 'message': case 'messageService': if (!isset($id['from_id']) // No other option // It's a channel/chat, 100% what we need || $id['peer_id']['_'] !== 'peerUser' // It is a user, and it's not ourselves || $id['peer_id']['user_id'] !== $this->authorization['user']['id'] ) { return $this->getId($id['peer_id']); } return $this->getId($id['from_id']); case 'updateChannelReadMessagesContents': case 'updateChannelAvailableMessages': case 'updateChannel': case 'updateChannelWebPage': case 'updateChannelMessageViews': case 'updateReadChannelInbox': case 'updateReadChannelOutbox': case 'updateDeleteChannelMessages': case 'updateChannelPinnedMessage': case 'updateChannelTooLong': return $this->toSupergroup($id['channel_id']); case 'updateChatParticipants': $id = $id['participants']; // no break case 'updateChatUserTyping': case 'updateChatParticipantAdd': case 'updateChatParticipantDelete': case 'updateChatParticipantAdmin': case 'updateChatAdmins': case 'updateChatPinnedMessage': return -$id['chat_id']; case 'updateUserTyping': case 'updateUserStatus': case 'updateUserName': case 'updateUserPhoto': case 'updateUserPhone': case 'updateUserBlocked': case 'updateContactRegistered': case 'updateContactLink': case 'updateBotInlineQuery': case 'updateInlineBotCallbackQuery': case 'updateBotInlineSend': case 'updateBotCallbackQuery': case 'updateBotPrecheckoutQuery': case 'updateBotShippingQuery': case 'updateUserPinnedMessage': case 'updateUser': case 'contact': return $id['user_id']; case 'updatePhoneCall': return $id['phone_call']->getOtherID(); case 'updateReadHistoryInbox': case 'updateReadHistoryOutbox': return $this->getId($id['peer']); case 'updateNewMessage': case 'updateNewChannelMessage': case 'updateEditMessage': case 'updateEditChannelMessage': return $this->getId($id['message']); default: throw new \danog\MadelineProto\Exception('Invalid constructor given '.$id['_']); } } if (\is_string($id)) { if (\strpos($id, '#') !== false) { if (\preg_match('/^channel#(\\d*)/', $id, $matches)) { return $this->toSupergroup($matches[1]); } if (\preg_match('/^chat#(\\d*)/', $id, $matches)) { $id = '-'.$matches[1]; } if (\preg_match('/^user#(\\d*)/', $id, $matches)) { return $matches[1]; } } } if (\is_numeric($id)) { if (\is_string($id)) { $id = (int) $id; } return $id; } return null; } /** * Get InputPeer object. * * @internal * * @param mixed $id Peer */ public function getInputPeer($id): \Generator { return $this->getInfo($id, MTProto::INFO_TYPE_PEER); } /** * Get InputUser/InputChannel object. * * @internal * * @param mixed $id Peer */ public function getInputConstructor($id): \Generator { return $this->getInfo($id, MTProto::INFO_TYPE_CONSTRUCTOR); } public array $caching_full_info = []; /** * Get info about peer, returns an Info object. * * @param mixed $id Peer * @param MTProto::INFO_TYPE_* $type Whether to generate an Input*, an InputPeer or the full set of constructors * * @see https://docs.madelineproto.xyz/Info.html * * @return \Generator Info object * * @template TConstructor * @psalm-param array{_: TConstructor}|mixed $id * * @return (((mixed|string)[]|mixed|string)[]|int|mixed|string)[] * * @psalm-return \Generator|array, mixed, array{ * TConstructor: array * InputPeer: array{_: string, user_id?: mixed, access_hash?: mixed, min?: mixed, chat_id?: mixed, channel_id?: mixed}, * Peer: array{_: string, user_id?: mixed, chat_id?: mixed, channel_id?: mixed}, * DialogPeer: array{_: string, peer: array{_: string, user_id?: mixed, chat_id?: mixed, channel_id?: mixed}}, * NotifyPeer: array{_: string, peer: array{_: string, user_id?: mixed, chat_id?: mixed, channel_id?: mixed}}, * InputDialogPeer: array{_: string, peer: array{_: string, user_id?: mixed, access_hash?: mixed, min?: mixed, chat_id?: mixed, channel_id?: mixed}}, * InputNotifyPeer: array{_: string, peer: array{_: string, user_id?: mixed, access_hash?: mixed, min?: mixed, chat_id?: mixed, channel_id?: mixed}}, * bot_api_id: int|string, * user_id?: int, * chat_id?: int, * channel_id?: int, * InputUser?: array{_: string, user_id?: int, access_hash?: mixed, min?: bool}, * InputChannel?: array{_: string, channel_id: int, access_hash: mixed, min: bool}, * type: string * }>|int|array{_: string, user_id?: mixed, access_hash?: mixed, min?: mixed, chat_id?: mixed, channel_id?: mixed}|array{_: string, user_id?: int, access_hash?: mixed, min?: bool}|array{_: string, channel_id: int, access_hash: mixed, min: bool} */ public function getInfo($id, int $type = MTProto::INFO_TYPE_ALL): \Generator { if (\is_array($id)) { switch ($id['_']) { case 'updateEncryption': return $this->getSecretChat($id['chat']['id']); case 'inputEncryptedChat': case 'updateEncryptedChatTyping': case 'updateEncryptedMessagesRead': return $this->getSecretChat($id['chat_id']); case 'updateNewEncryptedMessage': $id = $id['message']; // no break case 'encryptedMessage': case 'encryptedMessageService': $id = $id['chat_id']; if (!isset($this->secret_chats[$id])) { throw new \danog\MadelineProto\Exception(\danog\MadelineProto\Lang::$current_lang['sec_peer_not_in_db']); } return $this->secret_chats[$id]; } } $folder_id = $this->getFolderId($id); $try_id = $this->getId($id); if ($try_id !== null) { $id = $try_id; } if (\is_numeric($id)) { $id = (int) $id; Assert::true($id !== 0); if (!yield $this->chats[$id]) { try { $this->logger->logger("Try fetching {$id} with access hash 0"); if ($this->isSupergroup($id)) { yield from $this->addChat([ '_' => 'channel', 'id' => $this->fromSupergroup($id) ]); } elseif ($id < 0) { yield from $this->methodCallAsyncRead('messages.getChats', ['id' => [-$id]]); } else { yield from $this->addUser([ '_' => 'user', 'id' => $id ]); } } catch (\danog\MadelineProto\Exception $e) { $this->logger->logger($e->getMessage(), Logger::WARNING); } catch (\danog\MadelineProto\RPCErrorException $e) { $this->logger->logger($e->getMessage(), Logger::WARNING); } } $chat = yield $this->chats[$id]; if (!$chat) { throw new \danog\MadelineProto\Exception('This peer is not present in the internal peer database'); } if (($chat['min'] ?? false) && yield $this->minDatabase->hasPeer($id) && !isset($this->caching_full_info[$id]) ) { $this->caching_full_info[$id] = true; $this->logger->logger("Only have min peer for {$id} in database, trying to fetch full info"); try { if ($id < 0) { yield from $this->methodCallAsyncRead('channels.getChannels', ['id' => [$this->genAll($chat, $folder_id, MTProto::INFO_TYPE_CONSTRUCTOR)]]); } else { yield from $this->methodCallAsyncRead('users.getUsers', ['id' => [$this->genAll($chat, $folder_id, MTProto::INFO_TYPE_CONSTRUCTOR)]]); } } catch (\danog\MadelineProto\Exception $e) { $this->logger->logger($e->getMessage(), Logger::WARNING); } catch (\danog\MadelineProto\RPCErrorException $e) { $this->logger->logger($e->getMessage(), Logger::WARNING); } finally { unset($this->caching_full_info[$id]); } } try { return $this->genAll($chat, $folder_id, $type); } catch (\danog\MadelineProto\Exception $e) { if ($e->getMessage() === 'This peer is not present in the internal peer database') { yield $this->chats->unset($id);/** @uses DbArray::offsetUnset() */ } throw $e; } } if ($r = Tools::parseLink($id)) { [$invite, $content] = $r; if ($invite) { $invite = yield from $this->methodCallAsyncRead('messages.checkChatInvite', ['hash' => $content]); if (isset($invite['chat'])) { return yield from $this->getInfo($invite['chat'], $type); } throw new \danog\MadelineProto\Exception('You have not joined this chat'); } else { $id = $content; } } $id = \strtolower(\str_replace('@', '', $id)); if ($id === 'me') { return yield from $this->getInfo($this->authorization['user']['id'], $type); } if ($id === 'support') { if (!$this->supportUser) { yield from $this->methodCallAsyncRead('help.getSupport', [], $this->settings->getDefaultDcParams()); } return yield from $this->getInfo($this->supportUser, $type); } if ($bot_api_id = yield $this->usernames[$id]) { return yield from $this->getInfo($bot_api_id, $type); } if ($bot_api_id = yield from $this->resolveUsername($id)) { return yield from $this->getInfo($bot_api_id, $type); } throw new \danog\MadelineProto\Exception('This peer is not present in the internal peer database'); } /** * @template TConstructor * @psalm-param array{_: TConstructor} $constructor * @psalm-param bool|null $type * * @return (((mixed|string)[]|mixed|string)[]|int|mixed|string)[] * * @psalm-return array{ * TConstructor: array * InputPeer: array{_: string, user_id?: mixed, access_hash?: mixed, min?: mixed, chat_id?: mixed, channel_id?: mixed}, * Peer: array{_: string, user_id?: mixed, chat_id?: mixed, channel_id?: mixed}, * DialogPeer: array{_: string, peer: array{_: string, user_id?: mixed, chat_id?: mixed, channel_id?: mixed}}, * NotifyPeer: array{_: string, peer: array{_: string, user_id?: mixed, chat_id?: mixed, channel_id?: mixed}}, * InputDialogPeer: array{_: string, peer: array{_: string, user_id?: mixed, access_hash?: mixed, min?: mixed, chat_id?: mixed, channel_id?: mixed}}, * InputNotifyPeer: array{_: string, peer: array{_: string, user_id?: mixed, access_hash?: mixed, min?: mixed, chat_id?: mixed, channel_id?: mixed}}, * bot_api_id: int|string, * user_id?: int, * chat_id?: int, * channel_id?: int, * InputUser?: {_: string, user_id?: int, access_hash?: mixed, min?: bool}, * InputChannel?: {_: string, channel_id: int, access_hash: mixed, min: bool}, * type: string * } */ private function genAll($constructor, $folder_id, int $type) { if ($type === MTProto::INFO_TYPE_CONSTRUCTOR) { if ($constructor['_'] === 'user') { return ($constructor['self'] ?? false) ? ['_' => 'inputUserSelf'] : ['_' => 'inputUser', 'user_id' => $constructor['id'], 'access_hash' => $constructor['access_hash'], 'min' => $constructor['min']]; } if ($constructor['_'] === 'channel') { return ['_' => 'inputChannel', 'channel_id' => $constructor['id'], 'access_hash' => $constructor['access_hash'], 'min' => $constructor['min']]; } } if ($type === MTProto::INFO_TYPE_PEER) { if ($constructor['_'] === 'user') { return ($constructor['self'] ?? false) ? ['_' => 'inputPeerSelf'] : ['_' => 'inputPeerUser', 'user_id' => $constructor['id'], 'access_hash' => $constructor['access_hash'], 'min' => $constructor['min']]; } if ($constructor['_'] === 'channel') { return ['_' => 'inputPeerChannel', 'channel_id' => $constructor['id'], 'access_hash' => $constructor['access_hash'], 'min' => $constructor['min']]; } if ($constructor['_'] === 'chat' || $constructor['_'] === 'chatForbidden') { return ['_' => 'inputPeerChat', 'chat_id' => $constructor['id']]; } } if ($type === MTProto::INFO_TYPE_ID) { if ($constructor['_'] === 'user') { return $constructor['id']; } if ($constructor['_'] === 'channel') { return $this->toSupergroup($constructor['id']); } if ($constructor['_'] === 'chat' || $constructor['_'] === 'chatForbidden') { return -$constructor['id']; } } if ($type === MTProto::INFO_TYPE_USERNAMES) { return $this->getUsernames($constructor); } $res = [$this->TL->getConstructors()->findByPredicate($constructor['_'])['type'] => $constructor]; switch ($constructor['_']) { case 'user': if ($constructor['self'] ?? false) { $res['InputPeer'] = ['_' => 'inputPeerSelf']; $res['InputUser'] = ['_' => 'inputUserSelf']; } elseif (isset($constructor['access_hash'])) { $res['InputPeer'] = ['_' => 'inputPeerUser', 'user_id' => $constructor['id'], 'access_hash' => $constructor['access_hash'], 'min' => $constructor['min']]; $res['InputUser'] = ['_' => 'inputUser', 'user_id' => $constructor['id'], 'access_hash' => $constructor['access_hash'], 'min' => $constructor['min']]; } else { throw new \danog\MadelineProto\Exception('This peer is not present in the internal peer database'); } $res['Peer'] = ['_' => 'peerUser', 'user_id' => $constructor['id']]; $res['DialogPeer'] = ['_' => 'dialogPeer', 'peer' => $res['Peer']]; $res['NotifyPeer'] = ['_' => 'notifyPeer', 'peer' => $res['Peer']]; $res['InputDialogPeer'] = ['_' => 'inputDialogPeer', 'peer' => $res['InputPeer']]; $res['InputNotifyPeer'] = ['_' => 'inputNotifyPeer', 'peer' => $res['InputPeer']]; $res['user_id'] = $constructor['id']; $res['bot_api_id'] = $constructor['id']; $res['type'] = $constructor['bot'] ?? false ? 'bot' : 'user'; break; case 'chat': case 'chatForbidden': $res['InputPeer'] = ['_' => 'inputPeerChat', 'chat_id' => $constructor['id']]; $res['Peer'] = ['_' => 'peerChat', 'chat_id' => $constructor['id']]; $res['DialogPeer'] = ['_' => 'dialogPeer', 'peer' => $res['Peer']]; $res['NotifyPeer'] = ['_' => 'notifyPeer', 'peer' => $res['Peer']]; $res['InputDialogPeer'] = ['_' => 'inputDialogPeer', 'peer' => $res['InputPeer']]; $res['InputNotifyPeer'] = ['_' => 'inputNotifyPeer', 'peer' => $res['InputPeer']]; $res['chat_id'] = $constructor['id']; $res['bot_api_id'] = -$constructor['id']; $res['type'] = 'chat'; break; case 'channel': if (!isset($constructor['access_hash'])) { throw new \danog\MadelineProto\Exception('This peer is not present in the internal peer database'); } $res['InputPeer'] = ['_' => 'inputPeerChannel', 'channel_id' => $constructor['id'], 'access_hash' => $constructor['access_hash'], 'min' => $constructor['min']]; $res['Peer'] = ['_' => 'peerChannel', 'channel_id' => $constructor['id']]; $res['DialogPeer'] = ['_' => 'dialogPeer', 'peer' => $res['Peer']]; $res['NotifyPeer'] = ['_' => 'notifyPeer', 'peer' => $res['Peer']]; $res['InputDialogPeer'] = ['_' => 'inputDialogPeer', 'peer' => $res['InputPeer']]; $res['InputNotifyPeer'] = ['_' => 'inputNotifyPeer', 'peer' => $res['InputPeer']]; $res['InputChannel'] = ['_' => 'inputChannel', 'channel_id' => $constructor['id'], 'access_hash' => $constructor['access_hash'], 'min' => $constructor['min']]; $res['channel_id'] = $constructor['id']; $res['bot_api_id'] = $this->toSupergroup($constructor['id']); $res['type'] = $constructor['megagroup'] ?? false ? 'supergroup' : 'channel'; break; case 'channelForbidden': throw new \danog\MadelineProto\Exception('This peer is not present in the internal peer database'); default: throw new \danog\MadelineProto\Exception('Invalid constructor given '.$constructor['_']); } if ($folder_id) { $res['FolderPeer'] = ['_' => 'folderPeer', 'peer' => $res['Peer'], 'folder_id' => $folder_id]; $res['InputFolderPeer'] = ['_' => 'inputFolderPeer', 'peer' => $res['InputPeer'], 'folder_id' => $folder_id]; } return $res; } /** * Refresh peer cache for a certain peer. * * @param mixed $id The peer to refresh */ public function refreshPeerCache($id): \Generator { $id = (yield from $this->getInfo($id))['bot_api_id']; if ($this->isSupergroup($id)) { yield from $this->methodCallAsyncRead('channels.getChannels', ['id' => [$this->genAll(yield $this->chats[$id], 0, MTProto::INFO_TYPE_CONSTRUCTOR)]]); } elseif ($id < 0) { yield from $this->methodCallAsyncRead('messages.getChats', ['id' => [$id]]); } else { yield from $this->methodCallAsyncRead('users.getUsers', ['id' => [$this->genAll(yield $this->chats[$id], 0, MTProto::INFO_TYPE_CONSTRUCTOR)]]); } } /** * Refresh full peer cache for a certain peer. * * @param mixed $id The peer to refresh */ public function refreshFullPeerCache($id): \Generator { yield $this->full_chats->unset((yield from $this->getFullInfo($id))['bot_api_id']); yield from $this->getFullInfo($id); } /** * When were full info for this chat last cached. * * @param mixed $id Chat ID * * @return \Generator */ public function fullChatLastUpdated($id): \Generator { return (yield $this->full_chats[$id])['last_update'] ?? 0; } /** * Get full info about peer, returns an FullInfo object. * * @param mixed $id Peer * * @see https://docs.madelineproto.xyz/FullInfo.html * * @return \Generator FullInfo object * * @psalm-return \Generator */ public function getFullInfo($id): \Generator { $partial = (yield from $this->getInfo($id)); if (\time() - (yield from $this->fullChatLastUpdated($partial['bot_api_id'])) < $this->getSettings()->getPeer()->getFullInfoCacheTime()) { return \array_merge($partial, yield $this->full_chats[$partial['bot_api_id']]); } $full = null; switch ($partial['type']) { case 'user': case 'bot': yield from $this->methodCallAsyncRead('users.getFullUser', ['id' => $partial['InputUser']]); break; case 'chat': yield from $this->methodCallAsyncRead('messages.getFullChat', $partial); break; case 'channel': case 'supergroup': yield from $this->methodCallAsyncRead('channels.getFullChannel', ['channel' => $partial['InputChannel']]); break; } return \array_merge($partial, yield $this->full_chats[$partial['bot_api_id']]); } /** * @internal */ public function addFullChat(array $full): \Generator { yield $this->full_chats->offsetSet( $this->getId($full), [ 'full' => $full, 'last_update' => \time() ] ); } /** * Get full info about peer (including full list of channel members), returns a Chat object. * * @param mixed $id Peer * * @see https://docs.madelineproto.xyz/Chat.html * * @return \Generator Chat object */ public function getPwrChat($id, bool $fullfetch = true): \Generator { $full = $fullfetch && $this->getSettings()->getDb()->getEnableFullPeerDb() ? yield from $this->getFullInfo($id) : yield from $this->getInfo($id); $res = ['id' => $full['bot_api_id'], 'type' => $full['type']]; switch ($full['type']) { case 'user': case 'bot': foreach (['first_name', 'last_name', 'username', 'usernames', 'verified', 'restricted', 'restriction_reason', 'status', 'bot_inline_placeholder', 'access_hash', 'phone', 'lang_code', 'bot_nochats'] as $key) { if (isset($full['User'][$key])) { $res[$key] = $full['User'][$key]; } } foreach (['about', 'bot_info', 'phone_calls_available', 'phone_calls_private', 'common_chats_count', 'can_pin_message', 'pinned_msg_id', 'notify_settings'] as $key) { if (isset($full['full'][$key])) { $res[$key] = $full['full'][$key]; } } if (isset($full['full']['profile_photo']['sizes'])) { $res['photo'] = $full['full']['profile_photo']; } break; case 'chat': foreach (['title', 'participants_count', 'admin', 'admins_enabled'] as $key) { if (isset($full['Chat'][$key])) { $res[$key] = $full['Chat'][$key]; } } foreach (['bot_info', 'pinned_msg_id', 'notify_settings'] as $key) { if (isset($full['full'][$key])) { $res[$key] = $full['full'][$key]; } } if (isset($res['admins_enabled'])) { $res['all_members_are_administrators'] = !$res['admins_enabled']; } if (isset($full['full']['chat_photo']['sizes'])) { $res['photo'] = $full['full']['chat_photo']; } if (isset($full['full']['exported_invite']['link'])) { $res['invite'] = $full['full']['exported_invite']['link']; } if (isset($full['full']['participants']['participants'])) { $res['participants'] = $full['full']['participants']['participants']; } break; case 'channel': case 'supergroup': foreach (['title', 'democracy', 'restricted', 'restriction_reason', 'access_hash', 'username', 'usernames', 'signatures'] as $key) { if (isset($full['Chat'][$key])) { $res[$key] = $full['Chat'][$key]; } } foreach (['read_inbox_max_id', 'read_outbox_max_id', 'hidden_prehistory', 'bot_info', 'notify_settings', 'can_set_stickers', 'stickerset', 'can_view_participants', 'can_set_username', 'participants_count', 'admins_count', 'kicked_count', 'banned_count', 'migrated_from_chat_id', 'migrated_from_max_id', 'pinned_msg_id', 'about', 'hidden_prehistory', 'available_min_id', 'can_view_stats', 'online_count'] as $key) { if (isset($full['full'][$key])) { $res[$key] = $full['full'][$key]; } } if (isset($full['full']['chat_photo']['sizes'])) { $res['photo'] = $full['full']['chat_photo']; } if (isset($full['full']['exported_invite']['link'])) { $res['invite'] = $full['full']['exported_invite']['link']; } if (isset($full['full']['participants']['participants'])) { $res['participants'] = $full['full']['participants']['participants']; } break; } if (isset($res['participants']) && $fullfetch) { foreach ($res['participants'] as $key => $participant) { $newres = []; $newres['user'] = (yield from $this->getPwrChat($participant['user_id'] ?? $participant['peer'], false)); if (isset($participant['inviter_id'])) { $newres['inviter'] = (yield from $this->getPwrChat($participant['inviter_id'], false)); } if (isset($participant['promoted_by'])) { $newres['promoted_by'] = (yield from $this->getPwrChat($participant['promoted_by'], false)); } if (isset($participant['kicked_by'])) { $newres['kicked_by'] = (yield from $this->getPwrChat($participant['kicked_by'], false)); } if (isset($participant['date'])) { $newres['date'] = $participant['date']; } if (isset($participant['admin_rights'])) { $newres['admin_rights'] = $participant['admin_rights']; } if (isset($participant['banned_rights'])) { $newres['banned_rights'] = $participant['banned_rights']; } if (isset($participant['can_edit'])) { $newres['can_edit'] = $participant['can_edit']; } if (isset($participant['left'])) { $newres['left'] = $participant['left']; } switch ($participant['_']) { case 'chatParticipant': $newres['role'] = 'user'; break; case 'chatParticipantAdmin': $newres['role'] = 'admin'; break; case 'chatParticipantCreator': $newres['role'] = 'creator'; break; } $res['participants'][$key] = $newres; } } if (!isset($res['participants']) && $fullfetch && \in_array($res['type'], ['supergroup', 'channel'])) { $total_count = (isset($res['participants_count']) ? $res['participants_count'] : 0) + (isset($res['admins_count']) ? $res['admins_count'] : 0) + (isset($res['kicked_count']) ? $res['kicked_count'] : 0) + (isset($res['banned_count']) ? $res['banned_count'] : 0); $res['participants'] = []; $filters = ['channelParticipantsAdmins', 'channelParticipantsBots']; $promises = []; foreach ($filters as $filter) { $promises []= $this->fetchParticipants($full['InputChannel'], $filter, '', $total_count, $res); } yield Tools::all($promises); $q = ''; $filters = ['channelParticipantsSearch', 'channelParticipantsKicked', 'channelParticipantsBanned']; $promises = []; foreach ($filters as $filter) { $promises []= $this->recurseAlphabetSearchParticipants($full['InputChannel'], $filter, $q, $total_count, $res, 0); } yield Tools::all($promises); $this->logger->logger('Fetched '.\count($res['participants'])." out of {$total_count}"); $res['participants'] = \array_values($res['participants']); } if (!$fullfetch) { unset($res['participants']); } if (isset($res['photo'])) { $photo = []; foreach ([ 'small' => $res['photo']['sizes'][0], 'big' => Tools::maxSize($res['photo']['sizes']), ] as $type => $size) { $fileId = new FileId; $fileId->setId($res['photo']['id']); $fileId->setAccessHash($res['photo']['access_hash']); $fileId->setFileReference($res['photo']['file_reference']); $fileId->setDcId($res['photo']['dc_id']); $fileId->setType(PROFILE_PHOTO); $photoSize = new PhotoSizeSourceDialogPhoto($type === 'small' ? PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL : PHOTOSIZE_SOURCE_DIALOGPHOTO_BIG); $photoSize->setDialogId($res['id']); $photoSize->setDialogAccessHash($res['access_hash'] ?? 0); $fileId->setPhotoSizeSource($photoSize); $photo[$type.'_file_id'] = (string) $fileId; $photo[$type.'_file_unique_id'] = $fileId->getUniqueBotAPI(); } $res['photo'] += $photo; } return $res; } private function recurseAlphabetSearchParticipants($channel, $filter, $q, $total_count, &$res, int $depth): \Generator { if (!(yield from $this->fetchParticipants($channel, $filter, $q, $total_count, $res))) { return []; } $promises = []; for ($x = 'a'; $x !== 'aa' && $total_count > \count($res['participants']); $x++) { $promises []= $this->recurseAlphabetSearchParticipants($channel, $filter, $q.$x, $total_count, $res, $depth + 1); } if ($depth > 2) { return $promises; } $yielded = [...yield Tools::all($promises)]; while ($yielded) { $newYielded = []; foreach (\array_chunk($yielded, 10) as $promises) { $newYielded = \array_merge($newYielded, ...(yield Tools::all($promises))); } $yielded = $newYielded; } return []; } private function fetchParticipants($channel, $filter, $q, $total_count, &$res): \Generator { $offset = 0; $limit = 200; $has_more = false; $cached = false; $last_count = -1; do { try { $gres = yield from $this->methodCallAsyncRead('channels.getParticipants', ['channel' => $channel, 'filter' => ['_' => $filter, 'q' => $q], 'offset' => $offset, 'limit' => $limit, 'hash' => $hash = yield from $this->getParticipantsHash($channel, $filter, $q, $offset, $limit)], ['datacenter' => $this->datacenter->curdc, 'heavy' => true]); } catch (\danog\MadelineProto\RPCErrorException $e) { if ($e->rpc === 'CHAT_ADMIN_REQUIRED') { $this->logger->logger($e->rpc); return $has_more; } throw $e; } if ($cached = ($gres['_'] === 'channels.channelParticipantsNotModified')) { $gres = yield $this->fetchParticipantsCache($channel, $filter, $q, $offset, $limit); } else { $this->storeParticipantsCache($gres, $channel, $filter, $q, $offset, $limit); } if ($last_count !== -1 && $last_count !== $gres['count']) { $has_more = true; } else { $last_count = $gres['count']; } $promises = []; foreach ($gres['participants'] as $participant) { $promises []= Tools::call((function () use (&$res, $participant) { $newres = []; $newres['user'] = (yield from $this->getPwrChat($participant['user_id'] ?? $participant['peer'], false)); if (isset($participant['inviter_id'])) { $newres['inviter'] = (yield from $this->getPwrChat($participant['inviter_id'], false)); } if (isset($participant['kicked_by'])) { $newres['kicked_by'] = (yield from $this->getPwrChat($participant['kicked_by'], false)); } if (isset($participant['promoted_by'])) { $newres['promoted_by'] = (yield from $this->getPwrChat($participant['promoted_by'], false)); } if (isset($participant['date'])) { $newres['date'] = $participant['date']; } if (isset($participant['rank'])) { $newres['rank'] = $participant['rank']; } if (isset($participant['admin_rights'])) { $newres['admin_rights'] = $participant['admin_rights']; } if (isset($participant['banned_rights'])) { $newres['banned_rights'] = $participant['banned_rights']; } switch ($participant['_']) { case 'channelParticipantSelf': $newres['role'] = 'user'; break; case 'channelParticipant': $newres['role'] = 'user'; break; case 'channelParticipantCreator': $newres['role'] = 'creator'; break; case 'channelParticipantAdmin': $newres['role'] = 'admin'; break; case 'channelParticipantBanned': $newres['role'] = 'banned'; break; } $res['participants'][$participant['user_id'] ?? $this->getId($participant['peer'])] = $newres; })()); } yield Tools::all($promises); $this->logger->logger('Fetched '.\count($gres['participants'])." channel participants with filter {$filter}, query {$q}, offset {$offset}, limit {$limit}, hash {$hash}: ".($cached ? 'cached' : 'not cached').', '.($offset + \count($gres['participants'])).' participants out of '.$gres['count'].', in total fetched '.\count($res['participants']).' out of '.$total_count); $offset += \count($gres['participants']); } while (\count($gres['participants'])); if ($offset === $limit) { return true; } return $has_more; } /** * Key for participatns cache. * * @param integer $channelId * @param integer $offset * @param integer $limit */ private static function participantsKey(int $channelId, string $filter, string $q, int $offset, int $limit): string { return "$channelId'$filter'$q'$offset'$limit"; } private function fetchParticipantsCache($channel, $filter, $q, $offset, $limit): Promise { return $this->channelParticipants[$this->participantsKey($channel['channel_id'], $filter, $q, $offset, $limit)]; } private function storeParticipantsCache($gres, $channel, $filter, $q, $offset, $limit): void { unset($gres['users']); $ids = []; foreach ($gres['participants'] as $participant) { if (isset($participant['user_id'])) { $ids[] = $participant['user_id']; } } \sort($ids, SORT_NUMERIC); $gres['hash'] = \danog\MadelineProto\Tools::genVectorHash($ids); $this->channelParticipants[$this->participantsKey($channel['channel_id'], $filter, $q, $offset, $limit)] = $gres; } private function getParticipantsHash($channel, $filter, $q, $offset, $limit): \Generator { return (yield $this->channelParticipants[$this->participantsKey($channel['channel_id'], $filter, $q, $offset, $limit)])['hash'] ?? 0; } private array $caching_simple_username = []; /** * @param string $username Username */ private function resolveUsername(string $username): \Generator { $username = \strtolower(\str_replace('@', '', $username)); if (!$username) { return null; } if (isset($this->caching_simple_username[$username])) { // Used to avoid possible issues from addUser return null; } $this->caching_simple_username[$username] = true; $result = null; try { $result = $this->getId( (yield from $this->methodCallAsyncRead('contacts.resolveUsername', ['username' => $username]))['peer'] ); } catch (\danog\MadelineProto\RPCErrorException $e) { $this->logger->logger('Username resolution failed with error '.$e->getMessage(), Logger::ERROR); if (\strpos($e->rpc, 'FLOOD_WAIT_') === 0 || $e->rpc === 'AUTH_KEY_UNREGISTERED' || $e->rpc === 'USERNAME_INVALID') { throw $e; } } finally { unset($this->caching_simple_username[$username]); } return $result; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools\Crypt; /** * Openssl IGE implementation. * * @internal */ final class IGEOpenssl extends IGE { protected function __construct(private string $key, string $iv) { $this->iv_part_1 = \substr($iv, 0, 16); $this->iv_part_2 = \substr($iv, 16); } public function encrypt(string $plaintext): string { $ciphertext = ""; for ($i = 0, $length = \strlen($plaintext); $i < $length; $i += 16) { $plain = \substr($plaintext, $i, 16); $cipher = \openssl_encrypt($plain ^ $this->iv_part_1, 'aes-256-ecb', $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING) ^ $this->iv_part_2; $ciphertext .= $cipher; $this->iv_part_1 = $cipher; $this->iv_part_2 = $plain; } return $ciphertext; } public function decrypt(string $ciphertext): string { $plaintext = ""; for ($i = 0, $length = \strlen($ciphertext); $i < $length; $i += 16) { $cipher = \substr($ciphertext, $i, 16); $plain = \openssl_decrypt($cipher ^ $this->iv_part_2, 'aes-256-ecb', $this->key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING) ^ $this->iv_part_1; $plaintext .= $plain; $this->iv_part_1 = $cipher; $this->iv_part_2 = $plain; } return $plaintext; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools\Crypt; use danog\MadelineProto\Magic; /** * Continuous mode IGE implementation. * * @internal */ abstract class IGE { /** * IV part 1. * * @var string */ protected $iv_part_1; /** * IV part 2. * * @var string */ protected $iv_part_2; /** * Instantiate appropriate handler. * */ public static function getInstance(string $key, string $iv): IGE { if (Magic::$hasOpenssl) { return new IGEOpenssl($key, $iv); } return new IGEPhpseclib($key, $iv); } abstract protected function __construct(string $key, string $iv); abstract public function encrypt(string $plaintext): string; abstract public function decrypt(string $ciphertext): string; } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools\Crypt; use phpseclib3\Crypt\AES; /** * Phpseclib IGE implementation. * * @internal */ final class IGEPhpseclib extends IGE { private AES $instance; protected function __construct(string $key, string $iv) { $this->instance = new AES('ecb'); $this->instance->setKey($key); $this->instance->disablePadding(); $this->iv_part_1 = \substr($iv, 0, 16); $this->iv_part_2 = \substr($iv, 16); } public function encrypt(string $plaintext): string { $ciphertext = ""; for ($i = 0, $length = \strlen($plaintext); $i < $length; $i += 16) { $plain = \substr($plaintext, $i, 16); $cipher = $this->instance->encrypt($plain ^ $this->iv_part_1) ^ $this->iv_part_2; $ciphertext .= $cipher; $this->iv_part_1 = $cipher; $this->iv_part_2 = $plain; } return $ciphertext; } public function decrypt(string $ciphertext): string { $plaintext = ""; for ($i = 0, $length = \strlen($ciphertext); $i < $length; $i += 16) { $cipher = \substr($ciphertext, $i, 16); $plain = $this->instance->decrypt($cipher ^ $this->iv_part_2) ^ $this->iv_part_1; $plaintext .= $plain; $this->iv_part_1 = $cipher; $this->iv_part_2 = $plain; } return $plaintext; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools; use danog\MadelineProto\Logger; use danog\MadelineProto\Magic; use danog\MadelineProto\MTProtoTools\Crypt\IGE; use phpseclib3\Crypt\AES; use phpseclib3\Math\BigInteger; abstract class Crypt { /** * AES KDF function for MTProto v2. * * @param string $msg_key Message key * @param string $auth_key Auth key * @param boolean $to_server To server/from server direction * * @internal * */ public static function aesCalculate(string $msg_key, string $auth_key, bool $to_server = true): array { $x = $to_server ? 0 : 8; $sha256_a = \hash('sha256', $msg_key.\substr($auth_key, $x, 36), true); $sha256_b = \hash('sha256', \substr($auth_key, 40 + $x, 36).$msg_key, true); $aes_key = \substr($sha256_a, 0, 8).\substr($sha256_b, 8, 16).\substr($sha256_a, 24, 8); $aes_iv = \substr($sha256_b, 0, 8).\substr($sha256_a, 8, 16).\substr($sha256_b, 24, 8); return [$aes_key, $aes_iv]; } /** * AES KDF function for MTProto v1. * * @param string $msg_key Message key * @param string $auth_key Auth key * @param boolean $to_server To server/from server direction * * @internal * */ public static function oldAesCalculate(string $msg_key, string $auth_key, bool $to_server = true): array { $x = $to_server ? 0 : 8; $sha1_a = \sha1($msg_key.\substr($auth_key, $x, 32), true); $sha1_b = \sha1(\substr($auth_key, 32 + $x, 16).$msg_key.\substr($auth_key, 48 + $x, 16), true); $sha1_c = \sha1(\substr($auth_key, 64 + $x, 32).$msg_key, true); $sha1_d = \sha1($msg_key.\substr($auth_key, 96 + $x, 32), true); $aes_key = \substr($sha1_a, 0, 8).\substr($sha1_b, 8, 12).\substr($sha1_c, 4, 12); $aes_iv = \substr($sha1_a, 8, 12).\substr($sha1_b, 0, 8).\substr($sha1_c, 16, 4).\substr($sha1_d, 0, 8); return [$aes_key, $aes_iv]; } /** * CTR encrypt. * * @param string $message Message to encrypt * @param string $key Key * @param string $iv IV * * @internal * */ public static function ctrEncrypt(string $message, string $key, string $iv): string { $cipher = new AES('ctr'); $cipher->setKey($key); $cipher->setIV($iv); return @$cipher->encrypt($message); } /** * IGE encrypt. * * @param string $plaintext Message to encrypt * @param string $key Key * @param string $iv IV * * @internal * */ public static function igeEncrypt(string $plaintext, string $key, string $iv): string { if (Magic::$hasOpenssl) { $iv_part_1 = \substr($iv, 0, 16); $iv_part_2 = \substr($iv, 16); $ciphertext = ""; for ($i = 0, $length = \strlen($plaintext); $i < $length; $i += 16) { $plain = \substr($plaintext, $i, 16); $cipher = \openssl_encrypt($plain ^ $iv_part_1, 'aes-256-ecb', $key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING) ^ $iv_part_2; $ciphertext .= $cipher; $iv_part_1 = $cipher; $iv_part_2 = $plain; } return $ciphertext; } return IGE::getInstance($key, $iv)->encrypt($plaintext); } /** * IGE decrypt. * * @param string $ciphertext Message to decrypt * @param string $key Key * @param string $iv IV * * @internal * */ public static function igeDecrypt(string $ciphertext, string $key, string $iv): string { if (Magic::$hasOpenssl) { $iv_part_1 = \substr($iv, 0, 16); $iv_part_2 = \substr($iv, 16); $plaintext = ""; for ($i = 0, $length = \strlen($ciphertext); $i < $length; $i += 16) { $cipher = \substr($ciphertext, $i, 16); $plain = \openssl_decrypt($cipher ^ $iv_part_2, 'aes-256-ecb', $key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PADDING) ^ $iv_part_1; $plaintext .= $plain; $iv_part_1 = $cipher; $iv_part_2 = $plain; } return $plaintext; } return IGE::getInstance($key, $iv)->decrypt($ciphertext); } /** * Check validity of g_a parameters. * * * @internal * */ public static function checkG(BigInteger $g_a, BigInteger $p): bool { /* * *********************************************************************** * Check validity of g_a * 1 < g_a < p - 1 */ Logger::log('Executing g_a check (1/2)...', \danog\MadelineProto\Logger::VERBOSE); if ($g_a->compare(\danog\MadelineProto\Magic::$one) <= 0 || $g_a->compare($p->subtract(\danog\MadelineProto\Magic::$one)) >= 0) { throw new \danog\MadelineProto\SecurityException('g_a is invalid (1 < g_a < p - 1 is false).'); } Logger::log('Executing g_a check (2/2)...', \danog\MadelineProto\Logger::VERBOSE); if ($g_a->compare(\danog\MadelineProto\Magic::$twoe1984) < 0 || $g_a->compare($p->subtract(\danog\MadelineProto\Magic::$twoe1984)) >= 0) { throw new \danog\MadelineProto\SecurityException('g_a is invalid (2^1984 < g_a < p - 2^1984 is false).'); } return true; } /** * Check validity of p and g parameters. * * * @internal * * @return boolean */ public static function checkPG(BigInteger $p, BigInteger $g): bool { /* * *********************************************************************** * Check validity of dh_prime * Is it a prime? */ Logger::log('Executing p/g checks (1/2)...', \danog\MadelineProto\Logger::VERBOSE); if (!$p->isPrime()) { throw new \danog\MadelineProto\SecurityException("p isn't a safe 2048-bit prime (p isn't a prime)."); } /* * *********************************************************************** * Check validity of p * Is (p - 1) / 2 a prime? * * Almost always fails */ /* $this->logger->logger('Executing p/g checks (2/3)...', \danog\MadelineProto\Logger::VERBOSE); if (!$p->subtract(\danog\MadelineProto\Magic::$one)->divide(\danog\MadelineProto\Magic::$two)[0]->isPrime()) { throw new \danog\MadelineProto\SecurityException("p isn't a safe 2048-bit prime ((p - 1) / 2 isn't a prime)."); } */ /* * *********************************************************************** * Check validity of p * 2^2047 < p < 2^2048 */ Logger::log('Executing p/g checks (2/2)...', \danog\MadelineProto\Logger::VERBOSE); if ($p->compare(\danog\MadelineProto\Magic::$twoe2047) <= 0 || $p->compare(\danog\MadelineProto\Magic::$twoe2048) >= 0) { throw new \danog\MadelineProto\SecurityException("g isn't a safe 2048-bit prime (2^2047 < p < 2^2048 is false)."); } /* * *********************************************************************** * Check validity of g * 1 < g < p - 1 */ Logger::log('Executing g check...', \danog\MadelineProto\Logger::VERBOSE); if ($g->compare(\danog\MadelineProto\Magic::$one) <= 0 || $g->compare($p->subtract(\danog\MadelineProto\Magic::$one)) >= 0) { throw new \danog\MadelineProto\SecurityException('g is invalid (1 < g < p - 1 is false).'); } return true; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools; use Amp\Http\Status; /** * Obtain response information for file to server. */ class ResponseInfo { private const POWERED_BY = "

Powered by MadelineProto

"; private const NO_CACHE = [ 'Cache-Control' => ['no-store, no-cache, must-revalidate, max-age=0', 'post-check=0, pre-check=0'], 'Pragma' => 'no-cache' ]; /** * Whether to serve file. */ private bool $serve = false; /** * Serving range. */ private array $serveRange = []; /** * HTTP response code. */ private int $code = Status::OK; /** * Header array. */ private array $headers = []; /** * Parse headers. * * @param string $method HTTP method * @param array $headers HTTP headers * @param array $messageMedia Media info */ private function __construct(string $method, array $headers, array $messageMedia) { if (isset($headers['range'])) { $range = \explode('=', $headers['range'], 2); if (\count($range) == 1) { $range[1] = ''; } [$size_unit, $range_orig] = $range; if ($size_unit == 'bytes') { //multiple ranges could be specified at the same time, but for simplicity only serve the first range //http://tools.ietf.org/id/draft-ietf-http-range-retrieval-00.txt $list = \explode(',', $range_orig, 2); if (\count($list) == 1) { $list[1] = ''; } [$range, $extra_ranges] = $list; } else { $this->serve = false; $this->code = Status::RANGE_NOT_SATISFIABLE; $this->headers = self::NO_CACHE; return; } } else { $range = ''; } $listseek = \explode('-', $range, 2); if (\count($listseek) == 1) { $listseek[1] = ''; } [$seek_start, $seek_end] = $listseek; $size = $messageMedia['size'] ?? 0; $seek_end = empty($seek_end) ? ($size - 1) : \min(\abs(\intval($seek_end)), $size - 1); if (!empty($seek_start) && $seek_end < \abs(\intval($seek_start))) { $this->serve = false; $this->code = Status::RANGE_NOT_SATISFIABLE; $this->headers = self::NO_CACHE; return; } $seek_start = empty($seek_start) ? 0 : \abs(\intval($seek_start)); $this->serve = $method !== 'HEAD'; if ($seek_start > 0 || $seek_end < $size - 1) { $this->code = Status::PARTIAL_CONTENT; $this->headers['Content-Range'] = "bytes $seek_start-$seek_end/$size"; $this->headers['Content-Length'] = $seek_end - $seek_start + 1; } elseif ($size > 0) { $this->headers['Content-Length'] = $size; } $this->headers['Content-Type'] = $messageMedia['mime']; $this->headers['Cache-Control'] = 'max-age=31556926'; $this->headers['Content-Transfer-Encoding'] = 'Binary'; $this->headers['Accept-Ranges'] = 'bytes'; if ($this->serve) { if ($seek_start === 0 && $seek_end === -1) { $this->serveRange = [0, -1]; } else { $this->serveRange = [$seek_start, $seek_end + 1]; } } } /** * Parse headers. * * @param string $method HTTP method * @param array $headers HTTP headers * @param array $messageMedia Media info * */ public static function parseHeaders(string $method, array $headers, array $messageMedia): self { return new self($method, $headers, $messageMedia); } /** * Get explanation for HTTP code. * */ public function getCodeExplanation(): string { $reason = Status::getReason($this->code); $body = "

{$this->code} $reason


"; if ($this->code === Status::RANGE_NOT_SATISFIABLE) { $body .= "

Could not use selected range.

"; } $body .= self::POWERED_BY; $body .= ""; return $body; } /** * Whether to serve file. * * @return bool Whether to serve file */ public function shouldServe(): bool { return $this->serve; } /** * Get serving range. * * @return array HTTP serving range */ public function getServeRange(): array { return $this->serveRange; } /** * Get HTTP response code. * * @return int HTTP response code */ public function getCode(): int { return $this->code; } /** * Get header array. * * @return array Header array */ public function getHeaders(): array { return $this->headers; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools; use Amp\Loop; use danog\MadelineProto\Db\DbArray; use danog\MadelineProto\Db\DbPropertiesTrait; use danog\MadelineProto\Exception; use danog\MadelineProto\MTProto; use danog\MadelineProto\MTProto\OutgoingMessage; use danog\MadelineProto\TL\TLCallback; /** * Manages upload and download of files. */ class ReferenceDatabase implements TLCallback { use DbPropertiesTrait; // Reference from a document const DOCUMENT_LOCATION = 0; // Reference from a photo const PHOTO_LOCATION = 1; // Reference from a photo location (can only be photo location) const PHOTO_LOCATION_LOCATION = 2; // Peer + photo ID const USER_PHOTO_ORIGIN = 0; // Peer (default photo ID) const PEER_PHOTO_ORIGIN = 1; // set ID const STICKER_SET_ID_ORIGIN = 2; // Peer + msg ID const MESSAGE_ORIGIN = 3; // const SAVED_GIFS_ORIGIN = 4; // const STICKER_SET_RECENT_ORIGIN = 5; // const STICKER_SET_FAVED_ORIGIN = 6; // emoticon const STICKER_SET_EMOTICON_ORIGIN = 8; // const WALLPAPER_ORIGIN = 9; const LOCATION_CONTEXT = [ //'inputFileLocation' => self::PHOTO_LOCATION_LOCATION, // DEPRECATED 'inputDocumentFileLocation' => self::DOCUMENT_LOCATION, 'inputPhotoFileLocation' => self::PHOTO_LOCATION, 'inputPhoto' => self::PHOTO_LOCATION, 'inputDocument' => self::DOCUMENT_LOCATION, ]; const METHOD_CONTEXT = ['photos.updateProfilePhoto' => self::USER_PHOTO_ORIGIN, 'photos.getUserPhotos' => self::USER_PHOTO_ORIGIN, 'photos.uploadProfilePhoto' => self::USER_PHOTO_ORIGIN, 'messages.getStickers' => self::STICKER_SET_EMOTICON_ORIGIN]; const CONSTRUCTOR_CONTEXT = ['message' => self::MESSAGE_ORIGIN, 'messageService' => self::MESSAGE_ORIGIN, 'chatFull' => self::PEER_PHOTO_ORIGIN, 'channelFull' => self::PEER_PHOTO_ORIGIN, 'chat' => self::PEER_PHOTO_ORIGIN, 'channel' => self::PEER_PHOTO_ORIGIN, 'updateUserPhoto' => self::USER_PHOTO_ORIGIN, 'user' => self::USER_PHOTO_ORIGIN, 'userFull' => self::USER_PHOTO_ORIGIN, 'wallPaper' => self::WALLPAPER_ORIGIN, 'messages.savedGifs' => self::SAVED_GIFS_ORIGIN, 'messages.recentStickers' => self::STICKER_SET_RECENT_ORIGIN, 'messages.favedStickers' => self::STICKER_SET_FAVED_ORIGIN, 'messages.stickerSet' => self::STICKER_SET_ID_ORIGIN, 'document' => self::STICKER_SET_ID_ORIGIN]; /** * References indexed by location. * * @var DbArray */ private $db; private $cache = []; private $cacheContexts = []; private $refreshed = []; private $API; private $refresh = false; private $refreshCount = 0; /** * List of properties stored in database (memory or external). * @see DbPropertiesFactory */ protected static array $dbProperties = [ 'db' => 'array', ]; public function __construct(MTProto $API) { $this->API = $API; } public function __sleep() { return ['db', 'API']; } public function init(): \Generator { yield from $this->initDb($this->API); //Clear table on each start to fix fatals with invalid references //Loop::defer(fn () =>yield $this->db->clear()); //Clear table every day //Loop::repeat(24*1000*3600, fn () =>yield $this->db->clear()); } public function getMethodCallbacks(): array { return \array_fill_keys(\array_keys(self::METHOD_CONTEXT), [[$this, 'addOriginMethod']]); } public function getMethodBeforeCallbacks(): array { return \array_fill_keys(\array_keys(self::METHOD_CONTEXT), [[$this, 'addOriginMethodContext']]); } public function getConstructorCallbacks(): array { return \array_merge(\array_fill_keys(['document', 'photo', 'fileLocation'], [[$this, 'addReference']]), \array_fill_keys(\array_keys(self::CONSTRUCTOR_CONTEXT), [[$this, 'addOrigin']]), ['document' => [[$this, 'addReference'], [$this, 'addOrigin']]]); } public function getConstructorBeforeCallbacks(): array { return \array_fill_keys(\array_keys(self::CONSTRUCTOR_CONTEXT), [[$this, 'addOriginContext']]); } public function getConstructorSerializeCallbacks(): array { return \array_fill_keys(\array_keys(self::LOCATION_CONTEXT), [$this, 'populateReference']); } public function getTypeMismatchCallbacks(): array { return []; } public function reset(): void { if ($this->cacheContexts) { $this->API->logger->logger('Found '.\count($this->cacheContexts).' pending contexts', \danog\MadelineProto\Logger::ERROR); $this->cacheContexts = []; } if ($this->cache) { $this->API->logger->logger('Found pending locations', \danog\MadelineProto\Logger::ERROR); $this->cache = []; } } public function addReference(array $location): bool { if (!$this->cacheContexts) { $this->API->logger->logger('Trying to add reference out of context, report the following message to @danogentili!', \danog\MadelineProto\Logger::ERROR); $frames = []; $previous = ''; foreach (\debug_backtrace(0) as $k => $frame) { if (isset($frame['function']) && $frame['function'] === 'deserialize') { if (isset($frame['args'][1]['subtype'])) { if ($frame['args'][1]['subtype'] === $previous) { continue; } $frames[] = $frame['args'][1]['subtype']; $previous = $frame['args'][1]['subtype']; } elseif (isset($frame['args'][1]['type'])) { if ($frame['args'][1]['type'] === '') { break; } if ($frame['args'][1]['type'] === $previous) { continue; } $frames[] = $frame['args'][1]['type']; $previous = $frame['args'][1]['type']; } } } $frames = \array_reverse($frames); $tlTrace = \array_shift($frames); foreach ($frames as $frame) { $tlTrace .= "['".$frame."']"; } $this->API->logger->logger($tlTrace, \danog\MadelineProto\Logger::ERROR); return false; } if (!isset($location['file_reference'])) { $this->API->logger->logger("Object {$location['_']} does not have reference", \danog\MadelineProto\Logger::ERROR); return false; } $key = \count($this->cacheContexts) - 1; switch ($location['_']) { case 'document': $locationType = self::DOCUMENT_LOCATION; break; case 'photo': $locationType = self::PHOTO_LOCATION; break; case 'fileLocation': $locationType = self::PHOTO_LOCATION_LOCATION; break; default: throw new Exception('Unknown location type provided: '.$location['_']); } $this->API->logger->logger("Caching reference from location of type {$locationType} from {$location['_']}", \danog\MadelineProto\Logger::ULTRA_VERBOSE); if (!isset($this->cache[$key])) { $this->cache[$key] = []; } $this->cache[$key][self::serializeLocation($locationType, $location)] = (string) $location['file_reference']; return true; } public function addOriginContext(string $type): void { if (!isset(self::CONSTRUCTOR_CONTEXT[$type])) { throw new \danog\MadelineProto\Exception("Unknown origin type provided: {$type}"); } $originContext = self::CONSTRUCTOR_CONTEXT[$type]; //$this->API->logger->logger("Adding origin context {$originContext} for {$type}!", \danog\MadelineProto\Logger::ULTRA_VERBOSE); $this->cacheContexts[] = $originContext; } public function addOrigin(array $data = []): \Generator { $key = \count($this->cacheContexts) - 1; if ($key === -1) { throw new \danog\MadelineProto\Exception('Trying to add origin with no origin context set'); } $originType = \array_pop($this->cacheContexts); if (!isset($this->cache[$key])) { //$this->API->logger->logger("Removing origin context {$originType} for {$data['_']}, nothing in the reference cache!", \danog\MadelineProto\Logger::ULTRA_VERBOSE); return; } $cache = $this->cache[$key]; unset($this->cache[$key]); $origin = []; switch ($data['_']) { case 'message': case 'messageService': $origin['peer'] = $this->API->getId($data); $origin['msg_id'] = $data['id']; break; case 'messages.savedGifs': case 'messages.recentStickers': case 'messages.favedStickers': case 'wallPaper': break; case 'user': $origin['max_id'] = $data['photo']['photo_id']; $origin['offset'] = -1; $origin['limit'] = 1; $origin['user_id'] = $data['id']; break; case 'updateUserPhoto': $origin['max_id'] = $data['photo']['photo_id']; $origin['offset'] = -1; $origin['limit'] = 1; $origin['user_id'] = $data['user_id']; break; case 'userFull': $origin['max_id'] = $data['profile_photo']['id']; $origin['offset'] = -1; $origin['limit'] = 1; $origin['user_id'] = $data['id']; break; case 'chatFull': case 'chat': $origin['peer'] = -$data['id']; break; case 'channelFull': case 'channel': $origin['peer'] = $this->API::toSupergroup($data['id']); break; case 'document': foreach ($data['attributes'] as $attribute) { if ($attribute['_'] === 'documentAttributeSticker' && $attribute['stickerset']['_'] !== 'inputStickerSetEmpty') { $origin['stickerset'] = $attribute['stickerset']; } } if (!isset($origin['stickerset'])) { $key = \count($this->cacheContexts) - 1; if (!isset($this->cache[$key])) { $this->cache[$key] = []; } foreach ($cache as $location => $reference) { $this->cache[$key][$location] = $reference; } $this->API->logger->logger("Skipped origin {$originType} ({$data['_']}) for ".\count($cache).' references', \danog\MadelineProto\Logger::ULTRA_VERBOSE); return; } break; case 'messages.stickerSet': $origin['stickerset'] = ['_' => 'inputStickerSetID', 'id' => $data['set']['id'], 'access_hash' => $data['set']['access_hash']]; break; default: throw new \danog\MadelineProto\Exception("Unknown origin type provided: {$data['_']}"); } foreach ($cache as $location => $reference) { yield from $this->storeReference($location, $reference, $originType, $origin); } $this->API->logger->logger("Added origin {$originType} ({$data['_']}) to ".\count($cache).' references', \danog\MadelineProto\Logger::ULTRA_VERBOSE); } public function addOriginMethodContext(string $type): void { if (!isset(self::METHOD_CONTEXT[$type])) { throw new \danog\MadelineProto\Exception("Unknown origin type provided: {$type}"); } $originContext = self::METHOD_CONTEXT[$type]; $this->API->logger->logger("Adding origin context {$originContext} for {$type}!", \danog\MadelineProto\Logger::ULTRA_VERBOSE); $this->cacheContexts[] = $originContext; } public function addOriginMethod(OutgoingMessage $data, array $res): \Generator { $key = \count($this->cacheContexts) - 1; if ($key === -1) { throw new \danog\MadelineProto\Exception('Trying to add origin with no origin context set'); } $constructor = $data->getConstructor(); $originType = \array_pop($this->cacheContexts); if (!isset($this->cache[$key])) { $this->API->logger->logger("Removing origin context {$originType} for {$constructor}, nothing in the reference cache!", \danog\MadelineProto\Logger::ULTRA_VERBOSE); return; } $cache = $this->cache[$key]; unset($this->cache[$key]); $origin = []; $body = $data->getBodyOrEmpty(); switch ($body ?? '') { case 'photos.updateProfilePhoto': $origin['max_id'] = $res['photo_id'] ?? 0; $origin['offset'] = -1; $origin['limit'] = 1; $origin['user_id'] = $this->API->authorization['user']['id']; break; case 'photos.uploadProfilePhoto': $origin['max_id'] = $res['photo']['id']; $origin['offset'] = -1; $origin['limit'] = 1; $origin['user_id'] = $this->API->authorization['user']['id']; break; case 'photos.getUserPhotos': $origin['user_id'] = $body['user_id']; $origin['offset'] = -1; $origin['limit'] = 1; $count = 0; foreach ($res['photos'] as $photo) { $origin['max_id'] = $photo['id']; $dc_id = $photo['dc_id']; $location = self::serializeLocation(self::PHOTO_LOCATION, $photo); if (isset($cache[$location])) { $reference = $cache[$location]; unset($cache[$location]); yield from $this->storeReference($location, $reference, $originType, $origin); $count++; } if (isset($photo['sizes'])) { foreach ($photo['sizes'] as $size) { if (isset($size['location'])) { $size['location']['dc_id'] = $dc_id; $location = self::serializeLocation(self::PHOTO_LOCATION_LOCATION, $size['location']); if (isset($cache[$location])) { $reference = $cache[$location]; unset($cache[$location]); yield from $this->storeReference($location, $reference, $originType, $origin); $count++; } } } } } $this->API->logger->logger("Added origin {$originType} ($constructor) to {$count} references", \danog\MadelineProto\Logger::ULTRA_VERBOSE); return; case 'messages.getStickers': $origin['emoticon'] = $body['emoticon']; break; default: throw new \danog\MadelineProto\Exception("Unknown origin type provided: {$constructor}"); } foreach ($cache as $location => $reference) { yield from $this->storeReference($location, $reference, $originType, $origin); } $this->API->logger->logger("Added origin {$originType} ({$constructor}) to ".\count($cache).' references', \danog\MadelineProto\Logger::ULTRA_VERBOSE); } public function storeReference(string $location, string $reference, int $originType, array $origin): \Generator { $locationValue = yield $this->db[$location]; if (!$locationValue) { $locationValue = ['origins' => []]; } $locationValue['reference'] = $reference; $locationValue['origins'][$originType] = $origin; $this->db[$location] = $locationValue; if ($this->refresh) { $this->refreshed[$location] = true; } $key = \count($this->cacheContexts) - 1; if ($key >= 0) { $this->cache[$key][$location] = $reference; } } public function refreshNext(bool $refresh = false): void { if ($this->refreshCount === 1 && !$refresh) { $this->refreshed = []; $this->refreshCount--; $this->refresh = false; } elseif ($this->refreshCount === 0 && $refresh) { $this->refreshed = []; $this->refreshCount++; $this->refresh = true; } elseif ($this->refreshCount === 0 && !$refresh) { } elseif ($refresh) { $this->refreshCount++; } elseif (!$refresh) { $this->refreshCount--; } } public function refreshReference(int $locationType, array $location): \Generator { return $this->refreshReferenceInternal(self::serializeLocation($locationType, $location)); } public function refreshReferenceInternal(string $location): \Generator { if (isset($this->refreshed[$location])) { $this->API->logger->logger('Reference already refreshed!', \danog\MadelineProto\Logger::VERBOSE); return (yield $this->db[$location])['reference']; } $locationValue = yield $this->db[$location]; \ksort($locationValue['origins']); $this->db[$location] = $locationValue; $count = 0; foreach ((yield $this->db[$location])['origins'] as $originType => &$origin) { $count++; $this->API->logger->logger("Try {$count} refreshing file reference with origin type {$originType}", \danog\MadelineProto\Logger::VERBOSE); switch ($originType) { // Peer + msg ID case self::MESSAGE_ORIGIN: if (\is_array($origin['peer'])) { $origin['peer'] = $this->API->getId($origin['peer']); } if ($origin['peer'] < 0) { yield from $this->API->methodCallAsyncRead('channels.getMessages', ['channel' => $origin['peer'], 'id' => [$origin['msg_id']]], $this->API->getSettings()->getDefaultDcParams()); break; } yield from $this->API->methodCallAsyncRead('messages.getMessages', ['id' => [$origin['msg_id']]], $this->API->getSettings()->getDefaultDcParams()); break; // Peer + photo ID case self::PEER_PHOTO_ORIGIN: $fullChat = yield $this->API->full_chats[$origin['peer']]; if (isset($fullChat['last_update'])) { $fullChat['last_update'] = 0; $this->API->full_chats[$origin['peer']] = $fullChat; } $this->API->getFullInfo($origin['peer']); break; // Peer (default photo ID) case self::USER_PHOTO_ORIGIN: yield from $this->API->methodCallAsyncRead('photos.getUserPhotos', $origin, $this->API->getSettings()->getDefaultDcParams()); break; case self::SAVED_GIFS_ORIGIN: yield from $this->API->methodCallAsyncRead('messages.getSavedGifs', $origin, $this->API->getSettings()->getDefaultDcParams()); break; case self::STICKER_SET_ID_ORIGIN: yield from $this->API->methodCallAsyncRead('messages.getStickerSet', $origin, $this->API->getSettings()->getDefaultDcParams()); break; case self::STICKER_SET_RECENT_ORIGIN: yield from $this->API->methodCallAsyncRead('messages.getRecentStickers', $origin, $this->API->getSettings()->getDefaultDcParams()); break; case self::STICKER_SET_FAVED_ORIGIN: yield from $this->API->methodCallAsyncRead('messages.getFavedStickers', $origin, $this->API->getSettings()->getDefaultDcParams()); break; case self::STICKER_SET_EMOTICON_ORIGIN: yield from $this->API->methodCallAsyncRead('messages.getStickers', $origin, $this->API->getSettings()->getDefaultDcParams()); break; case self::WALLPAPER_ORIGIN: yield from $this->API->methodCallAsyncRead('account.getWallPapers', $origin, $this->API->getSettings()->getDefaultDcParams()); break; default: throw new \danog\MadelineProto\Exception("Unknown origin type {$originType}"); } if (isset($this->refreshed[$location])) { return (yield $this->db[$location])['reference']; } } throw new Exception('Did not refresh reference'); } public function populateReference(array $object): \Generator { $object['file_reference'] = yield from $this->getReference(self::LOCATION_CONTEXT[$object['_']], $object); return $object; } public function getReference(int $locationType, array $location): \Generator { $locationString = self::serializeLocation($locationType, $location); if (!isset((yield $this->db[$locationString])['reference'])) { if (isset($location['file_reference'])) { $this->API->logger->logger("Using outdated file reference for location of type {$locationType} object {$location['_']}", \danog\MadelineProto\Logger::ULTRA_VERBOSE); return $location['file_reference']; } if (!$this->refresh) { $this->API->logger->logger("Using null file reference for location of type {$locationType} object {$location['_']}", \danog\MadelineProto\Logger::ULTRA_VERBOSE); return ''; } throw new \danog\MadelineProto\Exception("Could not find file reference for location of type {$locationType} object {$location['_']}"); } $this->API->logger->logger("Getting file reference for location of type {$locationType} object {$location['_']}", \danog\MadelineProto\Logger::ULTRA_VERBOSE); if ($this->refresh) { return $this->refreshReferenceInternal($locationString); } return (yield $this->db[$locationString])['reference']; } private static function serializeLocation(int $locationType, array $location): string { switch ($locationType) { case self::DOCUMENT_LOCATION: case self::PHOTO_LOCATION: return $locationType.(\is_int($location['id']) ? \danog\MadelineProto\Tools::packSignedLong($location['id']) : $location['id']); case self::PHOTO_LOCATION_LOCATION: $dc_id = \danog\MadelineProto\Tools::packSignedInt($location['dc_id']); $volume_id = \is_int($location['volume_id']) ? \danog\MadelineProto\Tools::packSignedLong($location['volume_id']) : $location['volume_id']; $local_id = \danog\MadelineProto\Tools::packSignedInt($location['local_id']); return $locationType.$dc_id.$volume_id.$local_id; } throw new \danog\MadelineProto\Exception("Invalid location type specified!"); } public function __debugInfo() { return ['ReferenceDatabase instance '.\spl_object_hash($this)]; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools; /** * Stores the state of updates. */ class UpdatesState { /** * PTS. */ private int $pts = 1; /** * QTS. */ private int $qts = -1; /** * Seq. */ private int $seq = 0; /** * Date. */ private int $date = 1; /** * Channel ID. * * @var int */ private $channelId; /** * Is busy? */ private bool $syncLoading = false; /** * Init function. * * @param array $init Initial parameters * @param int $channelId Channel ID */ public function __construct(array $init = [], int $channelId = 0) { $this->channelId = $channelId; $this->update($init); } /** * Sleep function. * * @return array Parameters to serialize */ public function __sleep() { return $this->channelId ? ['pts', 'channelId'] : ['pts', 'qts', 'seq', 'date', 'channelId']; } /** * Wakeup function. */ public function __wakeup(): void { /** @psalm-suppress DocblockTypeContradiction */ if ($this->channelId === false) { $this->channelId = 0; } } /** * Is this state relative to a channel? * */ public function isChannel(): bool { return (bool) $this->channelId; } /** * Get the channel ID. * */ public function getChannel(): int { return $this->channelId; } /** * Are we currently busy? * * @param bool|null $set Update the currently busy flag * */ public function syncLoading(bool $set = null): bool { if ($set !== null) { $this->syncLoading = $set; } return $this->syncLoading; } /** * Update multiple parameters. * * @param array $init Parameters to update * */ public function update(array $init): self { foreach ($this->channelId ? ['pts'] : ['pts', 'qts', 'seq', 'date'] as $param) { if (isset($init[$param])) { $this->{$param}($init[$param]); } } return $this; } /** * Get/set PTS. * * @param int $set PTS to set * * @return int PTS */ public function pts(int $set = 0): int { if ($set !== 0 && $set > $this->pts) { $this->pts = $set; } return $this->pts; } /** * Get/set QTS. * * @param int $set QTS to set * * @return int QTS */ public function qts(int $set = 0): int { if ($set !== 0 && $set > $this->qts) { $this->qts = $set; } return $this->qts; } /** * Get/set seq. * * @param int $set Seq to set * * @return int seq */ public function seq(int $set = 0): int { if ($set !== 0 && $set > $this->seq) { $this->seq = $set; } return $this->seq; } /** * Get/set date. * * @param int $set Date to set * * @return int Date */ public function date(int $set = 0): int { if ($set !== 0 && $set > $this->date) { $this->date = $set; } return $this->date; } /** * Check validity of PTS contained in update. * * @param array $update Update * * @return int -1 if it's too old, 0 if it's ok, 1 if it's too new */ public function checkPts(array $update): int { return $update['pts'] - ($this->pts + $update['pts_count']); } /** * Check validity of seq contained in update. * * @param int $seq Seq * * @return int -1 if it's too old, 0 if it's ok, 1 if it's too new */ public function checkSeq(int $seq): int { return $seq ? $seq - ($this->seq + 1) : $seq; } } getFile(); } if (\is_string($messageMedia) && ($size === null || $mime === null || $name === null)) { throw new \danog\MadelineProto\Exception('downloadToBrowser only supports bot file IDs if the file size and MIME type are also specified in the third and fourth parameters of the method.'); } $headers = []; if (isset($_SERVER['HTTP_RANGE'])) { $headers['range'] = $_SERVER['HTTP_RANGE']; } $messageMedia = yield from $this->getDownloadInfo($messageMedia); $messageMedia['size'] ??= $size; $messageMedia['mime'] ??= $mime; if ($name) { $messageMedia['name'] = $name; } $result = ResponseInfo::parseHeaders( $_SERVER['REQUEST_METHOD'], $headers, $messageMedia ); foreach ($result->getHeaders() as $key => $value) { if (\is_array($value)) { foreach ($value as $subValue) { \header("$key: $subValue", false); } } else { \header("$key: $value"); } } \http_response_code($result->getCode()); if (!\in_array($result->getCode(), [Status::OK, Status::PARTIAL_CONTENT])) { yield Tools::echo($result->getCodeExplanation()); } elseif ($result->shouldServe()) { if (!empty($messageMedia['name']) && !empty($messageMedia['ext'])) { \header("Content-Disposition: inline; filename=\"{$messageMedia['name']}{$messageMedia['ext']}\""); } if (\ob_get_level()) { \ob_end_flush(); \ob_implicit_flush(); } yield from $this->downloadToStream($messageMedia, \fopen('php://output', 'w'), $cb, ...$result->getServeRange()); } } /** * Download file to stream. * * @param mixed $messageMedia File to download * @param mixed|FileCallbackInterface $stream Stream where to download file * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param int $offset Offset where to start downloading * @param int $end Offset where to end download * * * @psalm-return \Generator|\Amp\Promise|mixed, mixed, mixed> */ public function downloadToStream($messageMedia, $stream, $cb = null, int $offset = 0, int $end = -1): \Generator { $messageMedia = yield from $this->getDownloadInfo($messageMedia); if (\is_object($stream) && $stream instanceof FileCallbackInterface) { $cb = $stream; $stream = yield $stream->getFile(); } /** @var $stream \Amp\ByteStream\OutputStream */ if (!\is_object($stream)) { $stream = new ResourceOutputStream($stream); } if (!$stream instanceof OutputStream) { throw new Exception("Invalid stream provided"); } $seekable = false; if (\method_exists($stream, 'seek')) { try { yield $stream->seek($offset); $seekable = true; } catch (StreamException $e) { } } $lock = new LocalMutex; $callable = static function (string $payload, int $offset) use ($stream, $seekable, $lock): \Generator { /** @var Lock */ $l = yield $lock->acquire(); try { if ($seekable) { while ($stream->tell() !== $offset) { yield $stream->seek($offset); } } yield $stream->write($payload); } finally { $l->release(); } return \strlen($payload); }; return yield from $this->downloadToCallable($messageMedia, $callable, $cb, $seekable, $offset, $end); } /** * Download file to amphp/http-server response. * * Supports HEAD requests and content-ranges for parallel and resumed downloads. * * @param array|string $messageMedia File to download * @param ServerRequest $request Request * @param callable $cb Status callback (can also use FileCallback) * @param ?int $size Size of file to download, required for bot API file IDs. * @param ?string $name Name of file to download, required for bot API file IDs. * @param ?string $mime MIME type of file to download, required for bot API file IDs. * * @return \Generator Returned response * * @psalm-return \Generator */ public function downloadToResponse($messageMedia, ServerRequest $request, ?callable $cb = null, ?int $size = null, ?string $mime = null, ?string $name = null): \Generator { if (\is_object($messageMedia) && $messageMedia instanceof FileCallbackInterface) { $cb = $messageMedia; $messageMedia = yield $messageMedia->getFile(); } if (\is_string($messageMedia) && ($size === null || $mime === null || $name === null)) { throw new \danog\MadelineProto\Exception('downloadToBrowser only supports bot file IDs if the file size and MIME type are also specified in the third and fourth parameters of the method.'); } $messageMedia = yield from $this->getDownloadInfo($messageMedia); $messageMedia['size'] ??= $size; $messageMedia['mime'] ??= $mime; if ($name) { $messageMedia['name'] = $name; } $result = ResponseInfo::parseHeaders( $request->getMethod(), \array_map(fn (array $headers) => $headers[0], $request->getHeaders()), $messageMedia ); $body = null; if ($result->shouldServe()) { $body = new IteratorStream( new Producer( function (callable $emit) use (&$messageMedia, &$cb, &$result) { $emit = static function (string $payload) use ($emit): \Generator { yield $emit($payload); return \strlen($payload); }; yield Tools::call($this->downloadToCallable($messageMedia, $emit, $cb, false, ...$result->getServeRange())); } ) ); } elseif (!\in_array($result->getCode(), [Status::OK, Status::PARTIAL_CONTENT])) { $body = $result->getCodeExplanation(); } $response = new Response($result->getCode(), $result->getHeaders(), $body); if ($result->shouldServe() && !empty($result->getHeaders()['Content-Length'])) { $response->setHeader('content-length', $result->getHeaders()['Content-Length']); if (!empty($messageMedia['name']) && !empty($messageMedia['ext'])) { $response->setHeader('content-disposition', "inline; filename=\"{$messageMedia['name']}{$messageMedia['ext']}\""); } } return $response; } /** * Upload file to secret chat. * * @param FileCallbackInterface|string|array $file File, URL or Telegram file to upload * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * * * @psalm-return \Generator|\Amp\Promise<\Amp\Ipc\Sync\ChannelledSocket>|\Amp\Promise|\Amp\Promise|\Amp\Promise|\danog\MadelineProto\Stream\StreamInterface|array|int|mixed, mixed, mixed> */ public function uploadEncrypted($file, string $fileName = '', $cb = null): \Generator { return $this->upload($file, $fileName, $cb, true); } /** * Upload file. * * @param FileCallbackInterface|string|array $file File, URL or Telegram file to upload * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Generator|\Amp\Promise<\Amp\Ipc\Sync\ChannelledSocket>|\Amp\Promise|\Amp\Promise|\Amp\Promise|\danog\MadelineProto\Stream\StreamInterface|array|int|mixed, mixed, mixed> */ public function upload($file, string $fileName = '', $cb = null, bool $encrypted = false): \Generator { if (\is_object($file) && $file instanceof FileCallbackInterface) { $cb = $file; $file = yield $file->getFile(); } if (\is_string($file) || \is_object($file) && \method_exists($file, '__toString')) { if (\filter_var($file, FILTER_VALIDATE_URL)) { return yield from $this->uploadFromUrl($file, 0, $fileName, $cb, $encrypted); } } elseif (\is_array($file)) { return yield from $this->uploadFromTgfile($file, $cb, $encrypted); } if (\is_resource($file) || (\is_object($file) && $file instanceof InputStream)) { return yield from $this->uploadFromStream($file, 0, '', $fileName, $cb, $encrypted); } /** @var Settings */ $settings = $this instanceof Client ? yield $this->getSettings() : $this->settings; if (!$settings->getFiles()->getAllowAutomaticUpload()) { return yield from $this->uploadFromUrl($file, 0, $fileName, $cb, $encrypted); } $file = Tools::absolute($file); if (!yield exists($file)) { throw new \danog\MadelineProto\Exception(\danog\MadelineProto\Lang::$current_lang['file_not_exist']); } if (empty($fileName)) { $fileName = \basename($file); } $size = yield getSize($file); if ($size > 512 * 1024 * 8000) { throw new \danog\MadelineProto\Exception('Given file is too big!'); } $stream = yield openFile($file, 'rb'); $mime = Extension::getMimeFromFile($file); try { return yield from $this->uploadFromStream($stream, $size, $mime, $fileName, $cb, $encrypted); } finally { yield $stream->close(); } } /** * Upload file from stream. * * @param mixed $stream PHP resource or AMPHP async stream * @param integer $size File size * @param string $mime Mime type * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Generator|\Amp\Promise|\danog\MadelineProto\Stream\StreamInterface|array|int|mixed, mixed, mixed> */ public function uploadFromStream($stream, int $size, string $mime, string $fileName = '', $cb = null, bool $encrypted = false): \Generator { if (\is_object($stream) && $stream instanceof FileCallbackInterface) { $cb = $stream; $stream = yield $stream->getFile(); } /* @var $stream \Amp\ByteStream\OutputStream */ if (!\is_object($stream)) { $stream = new ResourceInputStream($stream); } if (!$stream instanceof InputStream) { throw new Exception("Invalid stream provided"); } $seekable = false; if (\method_exists($stream, 'seek')) { try { yield $stream->seek(0); $seekable = true; } catch (StreamException $e) { } } $created = false; if ($stream instanceof File) { $lock = new LocalMutex; $callable = static function (int $offset, int $size) use ($stream, $seekable, $lock): \Generator { /** @var Lock */ $l = yield $lock->acquire(); try { if ($seekable) { while ($stream->tell() !== $offset) { yield $stream->seek($offset); } } return yield $stream->read($size); } finally { $l->release(); } }; } else { if (!$stream instanceof BufferedRawStream) { $ctx = (new ConnectionContext())->addStream(PremadeStream::class, $stream)->addStream(SimpleBufferedRawStream::class); $stream = (yield from $ctx->getStream()); $created = true; } $callable = static function (int $offset, int $size) use ($stream): \Generator { $reader = yield $stream->getReadBuffer($l); try { return yield $reader->bufferRead($size); } catch (\danog\MadelineProto\NothingInTheSocketException $e) { $reader = yield $stream->getReadBuffer($size); return yield $reader->bufferRead($size); } }; $seekable = false; } if (!$size && $seekable && \method_exists($stream, 'tell')) { yield $stream->seek(0, \SEEK_END); $size = yield $stream->tell(); yield $stream->seek(0); } elseif (!$size) { $this->logger->logger("No content length for stream, caching first"); $body = $stream; $stream = new BlockingFile(\fopen('php://temp', 'r+b'), 'php://temp', 'r+b'); while (null !== ($chunk = yield $body->read())) { yield $stream->write($chunk); } $size = $stream->tell(); if (!$size) { throw new Exception('Wrong size!'); } yield $stream->seek(0); return yield from $this->uploadFromStream($stream, $size, $mime, $fileName, $cb, $encrypted); } $res = (yield from $this->uploadFromCallable($callable, $size, $mime, $fileName, $cb, $seekable, $encrypted)); if ($created) { $stream->disconnect(); } return $res; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools; use danog\MadelineProto\Exception; use danog\MadelineProto\Magic; use danog\MadelineProto\SecurityException; use phpseclib3\Math\BigInteger; /** * Manages SRP password calculation. * * @author Daniil Gentili * @link https://docs.madelineproto.xyz MadelineProto documentation */ class PasswordCalculator { /** * The algorithm to use for calculating the hash of new passwords (a PasswordKdfAlgo object). * * @var array */ private $new_algo; /** * A secure random string that can be used to compute the password. * * @var string */ private $secure_random = ''; /** * The algorithm to use for calculatuing the hash of the current password (a PasswordKdfAlgo object). * * @var array */ private $current_algo; /** * SRP b parameter. * * @var BigInteger */ private $srp_B; /** * SRP b parameter for hashing. * * @var string */ private $srp_BForHash; /** * SRP ID. * * @var [type] */ private $srp_id; /** * Logger. * * @var \danog\MadelineProto\Logger */ public $logger; /** * Initialize logger. * * @param \danog\MadelineProto\Logger $logger */ public function __construct($logger) { $this->logger = $logger; } /** * Popupate 2FA configuration. * * @param array $object 2FA configuration object obtained using account.getPassword * */ public function addInfo(array $object): void { if ($object['_'] !== 'account.password') { throw new Exception('Wrong constructor'); } if ($object['has_secure_values']) { //throw new Exception('Cannot parse secure values'); } if ($object['has_password']) { switch ($object['current_algo']['_']) { case 'passwordKdfAlgoUnknown': throw new Exception('Update your client to continue'); case 'passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow': $object['current_algo']['g'] = new BigInteger($object['current_algo']['g']); $object['current_algo']['p'] = new BigInteger((string) $object['current_algo']['p'], 256); Crypt::checkPG($object['current_algo']['p'], $object['current_algo']['g']); $object['current_algo']['gForHash'] = \str_pad($object['current_algo']['g']->toBytes(), 256, \chr(0), \STR_PAD_LEFT); $object['current_algo']['pForHash'] = \str_pad($object['current_algo']['p']->toBytes(), 256, \chr(0), \STR_PAD_LEFT); break; default: throw new Exception("Unknown KDF algo {$object['current_algo']['_']}"); } $this->current_algo = $object['current_algo']; $object['srp_B'] = new BigInteger((string) $object['srp_B'], 256); if ($object['srp_B']->compare(\danog\MadelineProto\Magic::$zero) < 0) { throw new SecurityException('srp_B < 0'); } if ($object['srp_B']->compare($object['current_algo']['p']) > 0) { throw new SecurityException('srp_B > p'); } $this->srp_B = $object['srp_B']; $this->srp_BForHash = \str_pad($object['srp_B']->toBytes(), 256, \chr(0), \STR_PAD_LEFT); $this->srp_id = $object['srp_id']; } else { $this->current_algo = null; $this->srp_B = null; $this->srp_BForHash = null; $this->srp_id = null; } switch ($object['new_algo']['_']) { case 'passwordKdfAlgoUnknown': throw new Exception('Update your client to continue'); case 'passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow': $object['new_algo']['g'] = new BigInteger($object['new_algo']['g']); $object['new_algo']['p'] = new BigInteger((string) $object['new_algo']['p'], 256); Crypt::checkPG($object['new_algo']['p'], $object['new_algo']['g']); $object['new_algo']['gForHash'] = \str_pad($object['new_algo']['g']->toBytes(), 256, \chr(0), \STR_PAD_LEFT); $object['new_algo']['pForHash'] = \str_pad($object['new_algo']['p']->toBytes(), 256, \chr(0), \STR_PAD_LEFT); break; default: throw new Exception("Unknown KDF algo {$object['new_algo']['_']}"); } $this->new_algo = $object['new_algo']; $this->secure_random = $object['secure_random']; } /** * Create a random string (eventually prefixed by the specified string). * * @param string $prefix Prefix * @return string Salt */ public function createSalt(string $prefix = ''): string { return $prefix.\danog\MadelineProto\Tools::random(32); } /** * Hash specified data using the salt with SHA256. * * The result will be the SHA256 hash of the salt concatenated with the data concatenated with the salt * * @param string $data Data to hash * @param string $salt Salt * @return string Hash */ public function hashSha256(string $data, string $salt): string { return \hash('sha256', $salt.$data.$salt, true); } /** * Hashes the specified password. * * @param string $password Password * @param string $client_salt Client salt * @param string $server_salt Server salt * @return string Resulting hash */ public function hashPassword(string $password, string $client_salt, string $server_salt): string { $buf = $this->hashSha256($password, $client_salt); $buf = $this->hashSha256($buf, $server_salt); $hash = \hash_pbkdf2('sha512', $buf, $client_salt, 100000, 0, true); return $this->hashSha256($hash, $server_salt); } /** * Get the InputCheckPassword object for checking the validity of a password using account.checkPassword. * * @param string $password The password * @return array InputCheckPassword object */ public function getCheckPassword(string $password): array { if ($password === '' || !$this->current_algo) { return ['_' => 'inputCheckPasswordEmpty']; } $client_salt = $this->current_algo['salt1']; $server_salt = $this->current_algo['salt2']; $g = $this->current_algo['g']; $gForHash = $this->current_algo['gForHash']; $p = $this->current_algo['p']; $pForHash = $this->current_algo['pForHash']; $B = $this->srp_B; $BForHash = $this->srp_BForHash; $id = $this->srp_id; $x = new BigInteger($this->hashPassword($password, $client_salt, $server_salt), 256); $g_x = $g->powMod($x, $p); $k = new BigInteger(\hash('sha256', $pForHash.$gForHash, true), 256); $kg_x = $k->multiply($g_x)->powMod(Magic::$one, $p); $a = new BigInteger(\danog\MadelineProto\Tools::random(2048 / 8), 256); $A = $g->powMod($a, $p); Crypt::checkG($A, $p); $AForHash = \str_pad($A->toBytes(), 256, \chr(0), \STR_PAD_LEFT); $b_kg_x = $B->powMod(Magic::$one, $p)->subtract($kg_x); $u = new BigInteger(\hash('sha256', $AForHash.$BForHash, true), 256); $ux = $u->multiply($x); $a_ux = $a->add($ux); $S = $b_kg_x->powMod($a_ux, $p); $SForHash = \str_pad($S->toBytes(), 256, \chr(0), \STR_PAD_LEFT); $K = \hash('sha256', $SForHash, true); $h1 = \hash('sha256', $pForHash, true); $h2 = \hash('sha256', $gForHash, true); $h1 ^= $h2; $M1 = \hash('sha256', $h1.\hash('sha256', $client_salt, true).\hash('sha256', $server_salt, true).$AForHash.$BForHash.$K, true); return ['_' => 'inputCheckPasswordSRP', 'srp_id' => $id, 'A' => $AForHash, 'M1' => $M1]; } /** * Get parameters to be passed to the account.updatePasswordSettings to update/set a 2FA password. * * The input params array can contain password, new_password, email and hint params. * * @param array $params Input params * @return array account.updatePasswordSettings parameters */ public function getPassword(array $params): array { $oldPassword = $this->getCheckPassword($params['password'] ?? ''); $return = ['password' => $oldPassword, 'new_settings' => ['_' => 'account.passwordInputSettings', 'new_algo' => ['_' => 'passwordKdfAlgoUnknown'], 'new_password_hash' => '', 'hint' => '']]; $new_settings =& $return['new_settings']; if (isset($params['new_password']) && $params['new_password'] !== '') { $client_salt = $this->createSalt($this->new_algo['salt1']); $server_salt = $this->new_algo['salt2']; $g = $this->new_algo['g']; $p = $this->new_algo['p']; $pForHash = $this->new_algo['pForHash']; $x = new BigInteger($this->hashPassword($params['new_password'], $client_salt, $server_salt), 256); $v = $g->powMod($x, $p); $vForHash = \str_pad($v->toBytes(), 256, \chr(0), \STR_PAD_LEFT); $new_settings['new_algo'] = ['_' => 'passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow', 'salt1' => $client_salt, 'salt2' => $server_salt, 'g' => (int) $g->toString(), 'p' => $pForHash]; $new_settings['new_password_hash'] = $vForHash; $new_settings['hint'] = $params['hint'] ?? ''; if (isset($params['email'])) { $new_settings['email'] = $params['email']; } } return $return; } } auth_mutex ??= new LocalMutex; $lock = yield $this->auth_mutex->acquire(); $this->logger("Initing authorization..."); $this->initing_authorization = true; try { $main = []; $media = []; foreach ($this->datacenter->getDataCenterConnections() as $socket) { if (!$socket->hasCtx()) { continue; } if ($socket->isMedia()) { $media []= [$socket, 'initAuthorization']; } else { $main []= [$socket, 'initAuthorization']; } } if ($main) { $first = \array_shift($main)(); yield from $first; } yield Tools::all(\array_map(fn ($cb) => $cb(), $main)); yield Tools::all(\array_map(fn ($cb) => $cb(), $media)); } finally { $lock->release(); $this->logger("Done initing authorization!"); $this->initing_authorization = false; } $this->startUpdateSystem(true); } /** * Get diffie-hellman configuration. * * @return \Generator */ public function getDhConfig(): \Generator { $dh_config = yield from $this->methodCallAsyncRead('messages.getDhConfig', ['version' => $this->dh_config['version'], 'random_length' => 0]); if ($dh_config['_'] === 'messages.dhConfigNotModified') { $this->logger->logger('DH configuration not modified', \danog\MadelineProto\Logger::VERBOSE); return $this->dh_config; } $dh_config['p'] = new BigInteger((string) $dh_config['p'], 256); $dh_config['g'] = new BigInteger($dh_config['g']); Crypt::checkPG($dh_config['p'], $dh_config['g']); return $this->dh_config = $dh_config; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools; use Amp\Deferred; use Amp\Loop; use Amp\Promise; use danog\MadelineProto\Logger; use danog\MadelineProto\Loop\Update\FeedLoop; use danog\MadelineProto\Loop\Update\UpdateLoop; use danog\MadelineProto\MTProto; use danog\MadelineProto\RPCErrorException; use danog\MadelineProto\Settings; use danog\MadelineProto\TL\TL; use danog\MadelineProto\TL\Types\Button; use danog\MadelineProto\Tools; /** * Manages updates. * * @extend MTProto * @property Settings $settings Settings * @property TL $TL TL */ trait UpdateHandler { /** * Update handler callback. * * @var ?callable */ private $updateHandler; private $got_state = false; private $channels_state; public $updates = []; public $updates_key = 0; /** * Get updates. * * @param array $params Params * * @internal * * * @psalm-return \Generator, mixed, list|mixed> */ public function getUpdates($params = []): \Generator { $this->updateHandler = MTProto::GETUPDATES_HANDLER; $params = MTProto::DEFAULT_GETUPDATES_PARAMS + $params; if (empty($this->updates)) { $params['timeout'] *= 1000; yield Tools::timeoutWithDefault($this->waitUpdate(), $params['timeout'] ?: 100000); } if (empty($this->updates)) { return $this->updates; } if ($params['offset'] < 0) { $params['offset'] = \array_reverse(\array_keys((array) $this->updates))[\abs($params['offset']) - 1]; } $updates = []; foreach ($this->updates as $key => $value) { if ($params['offset'] > $key) { unset($this->updates[$key]); } elseif ($params['limit'] === null || \count($updates) < $params['limit']) { $updates[] = ['update_id' => $key, 'update' => $value]; } } $this->updates = \array_slice($this->updates, 0, \count($this->updates), true); return $updates; } private ?Deferred $update_deferred = null; /** * Wait for update. * * @internal * */ public function waitUpdate(): Promise { $this->update_deferred = new Deferred(); return $this->update_deferred->promise(); } /** * Signal update. * * @internal * */ public function signalUpdate(): void { if ($this->update_deferred) { $deferred = $this->update_deferred; $this->update_deferred = null; Loop::defer(fn () => $deferred->resolve()); } } /** * Check message ID. * * @param array $message Message * * @internal * * @return boolean */ public function checkMsgId(array $message): bool { if (!isset($message['peer_id'])) { return true; } try { $peer_id = $this->getId($message['peer_id']); } catch (\danog\MadelineProto\Exception $e) { return true; } catch (\danog\MadelineProto\RPCErrorException $e) { return true; } $message_id = $message['id']; if (!isset($this->msg_ids[$peer_id]) || $message_id > $this->msg_ids[$peer_id]) { $this->msg_ids[$peer_id] = $message_id; return true; } return false; } /** * Get channel state. * * @internal * * @psalm-return */ public function loadUpdateState(): \Generator { if (!$this->got_state) { $this->got_state = true; $this->channels_state->get(0, yield from $this->getUpdatesState()); } return $this->channels_state->get(0); } /** * Load channel state. * * @param ?int $channelId Channel ID * @param array $init Init * * @internal * * @return UpdatesState|UpdatesState[] */ public function loadChannelState($channelId = null, $init = []) { return $this->channels_state->get($channelId, $init); } /** * Get channel states. * * @internal * * @return CombinedUpdatesState */ public function getChannelStates() { return $this->channels_state; } /** * Get update state. * * @internal * */ public function getUpdatesState(): \Generator { $data = yield from $this->methodCallAsyncRead('updates.getState', [], $this->settings->getDefaultDcParams()); yield from $this->getCdnConfig($this->settings->getDefaultDc()); return $data; } /** * Extract a message constructor from an Updates constructor. * * @psalm-return \Generator */ public function extractMessage(array $updates): \Generator { return (yield from $this->extractMessageUpdate($updates))['message']; } /** * Extract an update message constructor from an Updates constructor. * * @psalm-return \Generator */ public function extractMessageUpdate(array $updates): \Generator { $result = null; foreach ((yield from $this->extractUpdates($updates)) as $update) { if (\in_array($update['_'], ['updateNewMessage', 'updateNewChannelMessage', 'updateEditMessage', 'updateEditChannelMessage'])) { if ($result !== null) { throw new \danog\MadelineProto\Exception("Found more than one update of type message, use extractUpdates to extract all updates"); } $result = $update; } } if ($result === null) { throw new \danog\MadelineProto\Exception("Could not find any message in the updates!"); } return $result; } /** * Extract Update constructors from an Updates constructor. * * @psalm-return \Generator> */ public function extractUpdates(array $updates): \Generator { switch ($updates['_']) { case 'updates': case 'updatesCombined': return $updates['updates']; case 'updateShort': return [$updates['update']]; case 'updateShortSentMessage': $updates['user_id'] = yield from $this->getInfo($updates['request']['body']['peer'], MTProto::INFO_TYPE_ID); // no break case 'updateShortMessage': case 'updateShortChatMessage': $updates = \array_merge($updates['request']['body'] ?? [], $updates); unset($updates['request']); $from_id = isset($updates['from_id']) ? $updates['from_id'] : ($updates['out'] ? $this->authorization['user']['id'] : $updates['user_id']); $to_id = isset($updates['chat_id']) ? -$updates['chat_id'] : ($updates['out'] ? $updates['user_id'] : $this->authorization['user']['id']); $message = $updates; $message['_'] = 'message'; $message['from_id'] = yield from $this->getInfo($from_id, MTProto::INFO_TYPE_PEER); $message['peer_id'] = yield from $this->getInfo($to_id, MTProto::INFO_TYPE_PEER); $this->populateMessageFlags($message); return [['_' => 'updateNewMessage', 'message' => $message, 'pts' => $updates['pts'], 'pts_count' => $updates['pts_count']]]; default: throw new \danog\MadelineProto\ResponseException('Unrecognized update received: '.$updates['_']); } } private function populateMessageFlags(array &$message): void { $new = ['_' => 'message']; foreach ($this->TL->getConstructors()->findByPredicate('message')['params'] as $param) { if (isset($message[$param['name']]) && $param['name'] !== 'flags') { $new[$param['name']] = $message[$param['name']]; } elseif ($param['type'] === 'true') { $new[$param['name']] = false; } } $message = $new; if (isset($message['reply_markup']['rows'])) { foreach ($message['reply_markup']['rows'] as $key => $row) { foreach ($row['buttons'] as $bkey => $button) { $message['reply_markup']['rows'][$key]['buttons'][$bkey] = $button instanceof Button ? $button : new Button($this, $message, $button); } } } } /** * @param array $updates Updates * @param array $actual_updates Actual updates for deferred * * @internal * */ public function handleUpdates($updates, $actual_updates = null): \Generator { if ($actual_updates) { $updates = $actual_updates; } $this->logger->logger('Parsing updates ('.$updates['_'].') received via the socket...', \danog\MadelineProto\Logger::VERBOSE); switch ($updates['_']) { case 'updates': case 'updatesCombined': $result = []; foreach ($updates['updates'] as $key => $update) { if ($update['_'] === 'updateNewMessage' || $update['_'] === 'updateReadMessagesContents' || $update['_'] === 'updateEditMessage' || $update['_'] === 'updateDeleteMessages' || $update['_'] === 'updateReadHistoryInbox' || $update['_'] === 'updateReadHistoryOutbox' || $update['_'] === 'updateWebPage' || $update['_'] === 'updateMessageID') { $result[yield from $this->feeders[FeedLoop::GENERIC]->feedSingle($update)] = true; unset($updates['updates'][$key]); } } $this->seqUpdater->addPendingWakeups($result); if ($updates['updates']) { if ($updates['_'] === 'updatesCombined') { $updates['options'] = ['seq_start' => $updates['seq_start'], 'seq_end' => $updates['seq'], 'date' => $updates['date']]; } else { $updates['options'] = ['seq_start' => $updates['seq'], 'seq_end' => $updates['seq'], 'date' => $updates['date']]; } $this->seqUpdater->feed($updates); } $this->seqUpdater->resume(); break; case 'updateShort': $this->feeders[yield from $this->feeders[FeedLoop::GENERIC]->feedSingle($updates['update'])]->resume(); break; case 'updateShortSentMessage': if (!isset($updates['request']['body'])) { break; } $updates['user_id'] = yield from $this->getInfo($updates['request']['body']['peer'], MTProto::INFO_TYPE_ID); // no break case 'updateShortMessage': case 'updateShortChatMessage': $updates = \array_merge($updates['request']['body'] ?? [], $updates); unset($updates['request']); $from_id = isset($updates['from_id']) ? $updates['from_id'] : ($updates['out'] ? $this->authorization['user']['id'] : $updates['user_id']); $to_id = isset($updates['chat_id']) ? -$updates['chat_id'] : ($updates['out'] ? $updates['user_id'] : $this->authorization['user']['id']); if (!((yield from $this->peerIsset($from_id)) || !((yield from $this->peerIsset($to_id)) || isset($updates['via_bot_id']) && !((yield from $this->peerIsset($updates['via_bot_id'])) || isset($updates['entities']) && !((yield from $this->entitiesPeerIsset($updates['entities'])) || isset($updates['fwd_from']) && !(yield from $this->fwdPeerIsset($updates['fwd_from']))))))) { yield $this->updaters[FeedLoop::GENERIC]->resume(); return; } $message = $updates; $message['_'] = 'message'; try { $message['from_id'] = (yield from $this->getInfo($from_id))['Peer']; $message['peer_id'] = (yield from $this->getInfo($to_id))['Peer']; } catch (\danog\MadelineProto\Exception $e) { $this->logger->logger('Still did not get user in database, postponing update', \danog\MadelineProto\Logger::ERROR); break; } catch (\danog\MadelineProto\RPCErrorException $e) { $this->logger->logger('Still did not get user in database, postponing update', \danog\MadelineProto\Logger::ERROR); break; } $this->populateMessageFlags($message); $update = ['_' => 'updateNewMessage', 'message' => $message, 'pts' => $updates['pts'], 'pts_count' => $updates['pts_count']]; $this->feeders[yield from $this->feeders[FeedLoop::GENERIC]->feedSingle($update)]->resume(); break; case 'updatesTooLong': $this->updaters[UpdateLoop::GENERIC]->resume(); break; default: throw new \danog\MadelineProto\ResponseException('Unrecognized update received: '.\var_export($updates, true)); break; } } /** * Save update. * * @param array $update Update to save * * @internal * */ public function saveUpdate(array $update): \Generator { if ($update['_'] === 'updateConfig') { $this->config['expires'] = 0; yield from $this->getConfig(); } if (\in_array($update['_'], ['updateUser', 'updateUserName', 'updateUserPhone', 'updateUserBlocked', 'updateUserPhoto', 'updateContactRegistered', 'updateContactLink']) && $this->getSettings()->getDb()->getEnableFullPeerDb()) { $id = $this->getId($update); $chat = yield $this->full_chats[$id]; $chat['last_update'] = 0; $this->full_chats[$id] = $chat; yield from $this->getFullInfo($id); } if ($update['_'] === 'updateDcOptions') { $this->logger->logger('Got new dc options', \danog\MadelineProto\Logger::VERBOSE); $this->config['dc_options'] = $update['dc_options']; yield from $this->parseConfig(); return; } if ($update['_'] === 'updatePhoneCall') { if (!\class_exists('\\danog\\MadelineProto\\VoIP')) { $this->logger->logger('The php-libtgvoip extension is required to accept and manage calls. See daniil.it/MadelineProto for more info.', \danog\MadelineProto\Logger::WARNING); return; } switch ($update['phone_call']['_']) { case 'phoneCallRequested': if (isset($this->calls[$update['phone_call']['id']])) { return; } $controller = new \danog\MadelineProto\VoIP(false, $update['phone_call']['admin_id'], $this, \danog\MadelineProto\VoIP::CALL_STATE_INCOMING); $controller->setCall($update['phone_call']); $controller->storage = ['g_a_hash' => $update['phone_call']['g_a_hash']]; $controller->storage['video'] = $update['phone_call']['video'] ?? false; $update['phone_call'] = $this->calls[$update['phone_call']['id']] = $controller; break; case 'phoneCallAccepted': if (!(yield from $this->confirmCall($update['phone_call']))) { return; } $update['phone_call'] = $this->calls[$update['phone_call']['id']]; break; case 'phoneCall': if (!(yield from $this->completeCall($update['phone_call']))) { return; } $update['phone_call'] = $this->calls[$update['phone_call']['id']]; break; case 'phoneCallDiscarded': if (!isset($this->calls[$update['phone_call']['id']])) { return; } return $this->calls[$update['phone_call']['id']]->discard($update['phone_call']['reason'] ?? ['_' => 'phoneCallDiscardReasonDisconnect'], [], $update['phone_call']['need_debug'] ?? false); } } if ($update['_'] === 'updateNewEncryptedMessage' && !isset($update['message']['decrypted_message'])) { if (isset($update['qts'])) { $cur_state = (yield from $this->loadUpdateState()); if ($cur_state->qts() === -1) { $cur_state->qts($update['qts']); } if ($update['qts'] < $cur_state->qts()) { $this->logger->logger('Duplicate update. update qts: '.$update['qts'].' <= current qts '.$cur_state->qts().', chat id: '.$update['message']['chat_id'], \danog\MadelineProto\Logger::ERROR); return false; } if ($update['qts'] > $cur_state->qts() + 1) { $this->logger->logger('Qts hole. Fetching updates manually: update qts: '.$update['qts'].' > current qts '.$cur_state->qts().'+1, chat id: '.$update['message']['chat_id'], \danog\MadelineProto\Logger::ERROR); $this->updaters[UpdateLoop::GENERIC]->resumeDefer(); return false; } $this->logger->logger('Applying qts: '.$update['qts'].' over current qts '.$cur_state->qts().', chat id: '.$update['message']['chat_id'], \danog\MadelineProto\Logger::VERBOSE); yield from $this->methodCallAsyncRead('messages.receivedQueue', ['max_qts' => $cur_state->qts($update['qts'])], $this->settings->getDefaultDcParams()); } if (!isset($this->secret_chats[$update['message']['chat_id']])) { $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['secret_chat_skipping'], $update['message']['chat_id'])); return false; } $this->secretFeeders[$update['message']['chat_id']]->feed($update); $this->secretFeeders[$update['message']['chat_id']]->resume(); return; } /* if ($update['_'] === 'updateEncryptedChatTyping') { $update = ['_' => 'updateUserTyping', 'user_id' => $this->encrypted_chats[$update['chat_id']]['user_id'], 'action' => ['_' => 'sendMessageTypingAction']]; } */ if ($update['_'] === 'updateEncryption') { switch ($update['chat']['_']) { case 'encryptedChatRequested': if (!$this->settings->getSecretChats()->canAccept($update['chat']['admin_id'])) { return; } $this->logger->logger('Accepting secret chat '.$update['chat']['id'], \danog\MadelineProto\Logger::NOTICE); try { yield from $this->acceptSecretChat($update['chat']); } catch (RPCErrorException $e) { $this->logger->logger("Error while accepting secret chat: {$e}", Logger::FATAL_ERROR); } break; case 'encryptedChatDiscarded': $this->logger->logger('Deleting secret chat '.$update['chat']['id'].' because it was revoked by the other user (it was probably accepted by another client)', \danog\MadelineProto\Logger::NOTICE); if (isset($this->secret_chats[$update['chat']['id']])) { unset($this->secret_chats[$update['chat']['id']]); } if (isset($this->temp_requested_secret_chats[$update['chat']['id']])) { unset($this->temp_requested_secret_chats[$update['chat']['id']]); } if (isset($this->temp_rekeyed_secret_chats[$update['chat']['id']])) { unset($this->temp_rekeyed_secret_chats[$update['chat']['id']]); } break; case 'encryptedChat': $this->logger->logger('Completing creation of secret chat '.$update['chat']['id'], \danog\MadelineProto\Logger::NOTICE); yield from $this->completeSecretChat($update['chat']); break; } //$this->logger->logger($update, \danog\MadelineProto\Logger::NOTICE); } //if ($update['_'] === 'updateServiceNotification' && strpos($update['type'], 'AUTH_KEY_DROP_') === 0) { //} if (!$this->updateHandler) { return; } if (isset($update['message']['_']) && $update['message']['_'] === 'messageEmpty') { return; } if (isset($update['message']['from_id']['user_id'])) { if ($update['message']['from_id']['user_id'] === $this->authorization['user']['id']) { $update['message']['out'] = true; } } elseif (!isset($update['message']['from_id']) && isset($update['message']['peer_id']['user_id']) && $update['message']['peer_id']['user_id'] === $this->authorization['user']['id']) { $update['message']['out'] = true; } if (!isset($update['message']['from_id']) && isset($update['message']['peer_id']['user_id'])) { $update['message']['from_id'] = $update['message']['peer_id']; } if (isset($update['message']['peer_id'])) { $update['message']['to_id'] = $update['message']['peer_id']; } // First save to array, then once the feed loop signals resumal of loop, resume and handle $this->updates[$this->updates_key++] = $update; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools; use Amp\Deferred; use Amp\File\Driver\BlockingFile; use Amp\Http\Client\Request; use Amp\Http\Status; use Amp\Promise; use Amp\Success; use danog\MadelineProto\Exception; use danog\MadelineProto\FileCallbackInterface; use danog\MadelineProto\MTProto; use danog\MadelineProto\MTProtoTools\Crypt\IGE; use danog\MadelineProto\Settings; use danog\MadelineProto\Tools; use function Amp\File\exists; use function Amp\File\getSize; use function Amp\File\openFile; use function Amp\File\touch as touchAsync; use function Amp\Promise\all; /** * Manages upload and download of files. * * @property Settings $settings Settings */ trait Files { use FilesLogic; /** * Upload file from URL. * * @param string|FileCallbackInterface $url URL of file * @param integer $size Size of file * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Generator|\Amp\Promise|\Amp\Promise|\danog\MadelineProto\Stream\StreamInterface|array|int|mixed, mixed, mixed> */ public function uploadFromUrl($url, int $size = 0, string $fileName = '', $cb = null, bool $encrypted = false): \Generator { if (\is_object($url) && $url instanceof FileCallbackInterface) { $cb = $url; $url = yield $url->getFile(); } /** @var $response \Amp\Http\Client\Response */ $request = new Request($url); $request->setTransferTimeout(10 * 1000 * 3600); $request->setBodySizeLimit(512 * 1024 * 8000); $response = yield $this->datacenter->getHTTPClient()->request($request); if (200 !== ($status = $response->getStatus())) { throw new Exception("Wrong status code: {$status} ".$response->getReason()); } $mime = \trim(\explode(';', $response->getHeader('content-type') ?? 'application/octet-stream')[0]); $size = $response->getHeader('content-length') ?? $size; $stream = $response->getBody(); if (!$size) { $this->logger->logger("No content length for {$url}, caching first"); $body = $stream; $stream = new BlockingFile(\fopen('php://temp', 'r+b'), 'php://temp', 'r+b'); while (null !== ($chunk = yield $body->read())) { yield $stream->write($chunk); } $size = $stream->tell(); if (!$size) { throw new Exception('Wrong size!'); } yield $stream->seek(0); } return yield from $this->uploadFromStream($stream, $size, $mime, $fileName, $cb, $encrypted); } /** * Upload file from callable. * * The callable must accept two parameters: int $offset, int $size * The callable must return a string with the contest of the file at the specified offset and size. * * @param mixed $callable Callable * @param integer $size File size * @param string $mime Mime type * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $seekable Whether chunks can be fetched out of order * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Generator, mixed, array{_: string, id: string, parts: int, name: string, mime_type: string, key_fingerprint?: mixed, key?: mixed, iv?: mixed, md5_checksum: string}> */ public function uploadFromCallable(callable $callable, int $size, string $mime, string $fileName = '', $cb = null, bool $seekable = true, bool $encrypted = false): \Generator { if (\is_object($callable) && $callable instanceof FileCallbackInterface) { $cb = $callable; $callable = yield $callable->getFile(); } if (!\is_callable($callable)) { throw new Exception('Invalid callable provided'); } if ($cb === null) { $cb = function ($percent): void { $this->logger->logger('Upload status: '.$percent.'%', \danog\MadelineProto\Logger::NOTICE); }; } $datacenter = $this->settings->getDefaultDc(); if ($this->datacenter->has($datacenter.'_media')) { $datacenter .= '_media'; } $part_size = 512 * 1024; $parallel_chunks = $this->settings->getFiles()->getUploadParallelChunks(); $part_total_num = (int) \ceil($size / $part_size); $part_num = 0; $method = $size > 10 * 1024 * 1024 ? 'upload.saveBigFilePart' : 'upload.saveFilePart'; $constructor = 'input'.($encrypted === true ? 'Encrypted' : '').($size > 10 * 1024 * 1024 ? 'FileBig' : 'File').($encrypted === true ? 'Uploaded' : ''); $file_id = Tools::random(8); $ige = null; $fingerprint = null; $iv = null; $key = null; if ($encrypted === true) { $key = Tools::random(32); $iv = Tools::random(32); $digest = \hash('md5', $key.$iv, true); $fingerprint = Tools::unpackSignedInt(\substr($digest, 0, 4) ^ \substr($digest, 4, 4)); $ige = IGE::getInstance($key, $iv); $seekable = false; } //$ctx = \hash_init('md5'); $promises = []; $speed = 0; $time = 0; $cb = function () use ($cb, $part_total_num, &$speed, &$time): void { static $cur = 0; $cur++; Tools::callFork($cb($cur * 100 / $part_total_num, $speed, $time)); }; $callable = static function (int $part_num) use ($file_id, $part_total_num, $part_size, $callable, $ige): \Generator { $bytes = yield $callable($part_num * $part_size, $part_size); if ($ige) { $bytes = $ige->encrypt(\str_pad($bytes, $part_size, \chr(0))); } //\hash_update($ctx, $bytes); return ['file_id' => $file_id, 'file_part' => $part_num, 'file_total_parts' => $part_total_num, 'bytes' => $bytes]; }; $resPromises = []; $exception = null; $start = \microtime(true); while ($part_num < $part_total_num) { $resa = $callable($part_num); $writePromise = Tools::call($this->methodCallAsyncWrite($method, $resa, ['heavy' => true, 'file' => true, 'datacenter' => &$datacenter])); if (!$seekable) { yield $writePromise; } $writePromise->onResolve(function ($e, $readDeferred) use ($cb, $part_num, &$resPromises, &$exception): \Generator { if ($e) { $this->logger("Got exception while uploading: {$e}"); $exception = $e; return; } $resPromises[] = $readDeferred->promise(); try { // Wrote chunk! if (!yield Tools::call($readDeferred->promise())) { throw new \danog\MadelineProto\Exception('Upload of part '.$part_num.' failed'); } // Got OK from server for chunk! $cb(); } catch (\Throwable $e) { $this->logger("Got exception while uploading: {$e}"); $exception = $e; } }); $promises[] = $writePromise; ++$part_num; if (!($part_num % $parallel_chunks)) { // By default, 10 mb at a time, for a typical bandwidth of 1gbps (run the code in this every second) yield Tools::all($promises); $promises = []; if ($exception) { throw $exception; } $time = \microtime(true) - $start; $speed = (int) ($size * 8 / $time) / 1000000; $this->logger->logger("Partial upload time: {$time}"); $this->logger->logger("Partial upload speed: {$speed} mbps"); } } yield all($promises); yield all($resPromises); $time = \microtime(true) - $start; $speed = (int) ($size * 8 / $time) / 1000000; $this->logger->logger("Total upload time: {$time}"); $this->logger->logger("Total upload speed: {$speed} mbps"); $constructor = ['_' => $constructor, 'id' => $file_id, 'parts' => $part_total_num, 'name' => $fileName, 'mime_type' => $mime]; if ($encrypted === true) { $constructor['key_fingerprint'] = $fingerprint; $constructor['key'] = $key; $constructor['iv'] = $iv; $constructor['size'] = $size; } $constructor['md5_checksum'] = ''; //\hash_final($ctx); return $constructor; } /** * Reupload telegram file. * * @param mixed $media Telegram file * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Generator */ public function uploadFromTgfile($media, $cb = null, bool $encrypted = false): \Generator { if (\is_object($media) && $media instanceof FileCallbackInterface) { $cb = $media; $media = yield $media->getFile(); } $media = (yield from $this->getDownloadInfo($media)); if (!isset($media['size'], $media['mime'])) { throw new Exception('Wrong file provided!'); } $size = $media['size']; $mime = $media['mime']; $chunk_size = 512 * 1024; $bridge = new class($size, $chunk_size, $cb) { /** * Read promises. * * @var Deferred[] */ private $read = []; /** * Read promises (write lenth). * * @var int[] */ private $wrote = []; /** * Write promises. * * @var Deferred[] */ private $write = []; /** * Part size. * * @var int */ private $partSize; /** * Offset for callback. * * @var int */ private $offset = 0; /** * Callback. * * @var ?callable */ private $cb; /** * Constructor. * * @param integer $size Total file size * @param integer $partSize Part size * @param ?callable $cb Callback */ public function __construct(int $size, int $partSize, ?callable $cb) { for ($x = 0; $x < $size; $x += $partSize) { $this->read[] = new Deferred(); $this->write[] = new Deferred(); $this->wrote[] = $size - $x < $partSize ? $size - $x : $partSize; } $this->partSize = $partSize; $this->cb = $cb; } /** * Read chunk. * * @param integer $offset Offset * @param integer $size Chunk size * */ public function read(int $offset, int $size): Promise { $offset /= $this->partSize; return $this->write[$offset]->promise(); } /** * Write chunk. * * @param string $data Data * @param integer $offset Offset * */ public function write(string $data, int $offset): Promise { $offset /= $this->partSize; $this->write[$offset]->resolve($data); return $this->read[$offset]->promise(); } /** * Read callback, called when the chunk is read and fully resent. * * @param mixed ...$params Params to be passed to cb * */ public function callback(...$params): void { $offset = $this->offset++; $this->read[$offset]->resolve($this->wrote[$offset]); if ($this->cb) { Tools::callFork(($this->cb)(...$params)); } } }; $reader = [$bridge, 'read']; $writer = [$bridge, 'write']; $cb = [$bridge, 'callback']; $read = $this->uploadFromCallable($reader, $size, $mime, '', $cb, true, $encrypted); $write = $this->downloadToCallable($media, $writer, null, true, 0, -1, $chunk_size); [$res] = yield Tools::all([$read, $write]); return $res; } private function genAllFile($media): \Generator { $res = [$this->TL->getConstructors()->findByPredicate($media['_'])['type'] => $media]; switch ($media['_']) { case 'messageMediaPoll': $res['Poll'] = $media['poll']; $res['InputMedia'] = ['_' => 'inputMediaPoll', 'poll' => $res['Poll']]; if (isset($res['Poll']['quiz']) && $res['Poll']['quiz']) { if (empty($media['results']['results'])) { //quizzes need a correct answer throw new \danog\MadelineProto\Exception('No poll results'); } foreach ($media['results']['results'] as $answer) { if ($answer['correct']) { $res['InputMedia']['correct_answers'][] = $answer['option']; } } } if (isset($media['results']['solution'])) { $res['InputMedia']['solution'] = $media['results']['solution']; } if (isset($media['results']['solution_entities'])) { $res['InputMedia']['solution_entities'] = $media['results']['solution_entities']; } break; case 'updateMessagePoll': $res['Poll'] = $media['poll']; $res['InputMedia'] = ['_' => 'inputMediaPoll', 'poll' => $res['Poll']]; $res['MessageMedia'] = ['_' => 'messageMediaPoll', 'poll' => $res['Poll'], 'results' => $media['results']]; if (isset($res['Poll']['quiz']) && $res['Poll']['quiz']) { if (empty($media['results']['results'])) { //quizzes need a correct answer throw new \danog\MadelineProto\Exception('No poll results'); } foreach ($media['results']['results'] as $answer) { if ($answer['correct']) { $res['InputMedia']['correct_answers'][] = $answer['option']; } } } if (isset($media['results']['solution'])) { $res['InputMedia']['solution'] = $media['results']['solution']; } if (isset($media['results']['solution_entities'])) { $res['InputMedia']['solution_entities'] = $media['results']['solution_entities']; } break; case 'messageMediaPhoto': if (!isset($media['photo']['access_hash'])) { throw new \danog\MadelineProto\Exception('No access hash'); } $res['Photo'] = $media['photo']; $res['InputPhoto'] = ['_' => 'inputPhoto', 'id' => $media['photo']['id'], 'access_hash' => $media['photo']['access_hash'], 'file_reference' => yield from $this->referenceDatabase->getReference(ReferenceDatabase::PHOTO_LOCATION, $media['photo'])]; $res['InputMedia'] = ['_' => 'inputMediaPhoto', 'id' => $res['InputPhoto']]; if (isset($media['ttl_seconds'])) { $res['InputMedia']['ttl_seconds'] = $media['ttl_seconds']; } break; case 'messageMediaDocument': if (!isset($media['document']['access_hash'])) { throw new \danog\MadelineProto\Exception('No access hash'); } $res['Document'] = $media['document']; $res['InputDocument'] = ['_' => 'inputDocument', 'id' => $media['document']['id'], 'access_hash' => $media['document']['access_hash'], 'file_reference' => yield from $this->referenceDatabase->getReference(ReferenceDatabase::DOCUMENT_LOCATION, $media['document'])]; $res['InputMedia'] = ['_' => 'inputMediaDocument', 'id' => $res['InputDocument']]; if (isset($media['ttl_seconds'])) { $res['InputMedia']['ttl_seconds'] = $media['ttl_seconds']; } break; case 'messageMediaDice': $res['InputMedia'] = ['_' => 'inputMediaDice', 'emoticon' => $media['emoticon']]; break; case 'poll': $res['InputMedia'] = ['_' => 'inputMediaPoll', 'poll' => $res['Poll']]; break; case 'document': if (!isset($media['access_hash'])) { throw new \danog\MadelineProto\Exception('No access hash'); } $res['InputDocument'] = ['_' => 'inputDocument', 'id' => $media['id'], 'access_hash' => $media['access_hash'], 'file_reference' => yield from $this->referenceDatabase->getReference(ReferenceDatabase::DOCUMENT_LOCATION, $media)]; $res['InputMedia'] = ['_' => 'inputMediaDocument', 'id' => $res['InputDocument']]; $res['MessageMedia'] = ['_' => 'messageMediaDocument', 'document' => $media]; break; case 'photo': if (!isset($media['access_hash'])) { throw new \danog\MadelineProto\Exception('No access hash'); } $res['InputPhoto'] = ['_' => 'inputPhoto', 'id' => $media['id'], 'access_hash' => $media['access_hash'], 'file_reference' => yield from $this->referenceDatabase->getReference(ReferenceDatabase::PHOTO_LOCATION, $media)]; $res['InputMedia'] = ['_' => 'inputMediaPhoto', 'id' => $res['InputPhoto']]; $res['MessageMedia'] = ['_' => 'messageMediaPhoto', 'photo' => $media]; break; default: throw new \danog\MadelineProto\Exception("Could not convert media object of type {$media['_']}"); } return $res; } /** * Get info about file. * * @param mixed $constructor File ID * * @return \Generator */ public function getFileInfo($constructor): \Generator { if (\is_string($constructor)) { $constructor = $this->unpackFileId($constructor); if (isset($constructor['MessageMedia'])) { $constructor = $constructor['MessageMedia']; } elseif (isset($constructor['InputMedia'])) { return $constructor; } elseif (isset($constructor['Chat']) || isset($constructor['User'])) { throw new Exception("Chat photo file IDs can't be reused to resend chat photos, please use getPwrChat()['photo'], instead"); } } switch ($constructor['_']) { case 'updateNewMessage': case 'updateNewChannelMessage': case 'updateEditMessage': case 'updateEditChannelMessage': $constructor = $constructor['message']; // no break case 'message': $constructor = $constructor['media']; } return yield from $this->genAllFile($constructor); } /** * Get download info of the propic of a user * Returns an array with the following structure:. * * `$info['ext']` - The file extension * `$info['name']` - The file name, without the extension * `$info['mime']` - The file mime type * `$info['size']` - The file size * * * @return \Generator */ public function getPropicInfo($data): \Generator { return yield from $this->getDownloadInfo(yield $this->chats[yield from $this->getInfo($data, MTProto::INFO_TYPE_ID)]); } /** * Extract file info from bot API message. * * @param array $info Bot API message object * * @return ?array */ public static function extractBotAPIFile(array $info): ?array { foreach (TYPES as $type) { if (isset($info[$type]) && \is_array($info[$type])) { $method = $type; break; } } if (!isset($method)) { return null; } $info = $info[$method]; if ($method === 'photo') { $info = $info[0]; } $info['file_type'] = $method; return $info; } /** * Get download info of file * Returns an array with the following structure:. * * `$info['ext']` - The file extension * `$info['name']` - The file name, without the extension * `$info['mime']` - The file mime type * `$info['size']` - The file size * * @param mixed $messageMedia File ID * * @return \Generator */ public function getDownloadInfo($messageMedia): \Generator { if (\is_string($messageMedia)) { $messageMedia = $this->unpackFileId($messageMedia); if (isset($messageMedia['InputFileLocation'])) { return $messageMedia; } $messageMedia = $messageMedia['MessageMedia'] ?? $messageMedia['User'] ?? $messageMedia['Chat']; } if (!isset($messageMedia['_'])) { if (!isset($messageMedia['InputFileLocation']) && !isset($messageMedia['file_id'])) { $messageMedia = self::extractBotAPIFile($messageMedia) ?? $messageMedia; } if (isset($messageMedia['file_id'])) { $res = yield from $this->getDownloadInfo($messageMedia['file_id']); $pathinfo = \pathinfo($messageMedia['file_name']); if (isset($pathinfo['extension'])) { $res['ext'] = '.'.$pathinfo['extension']; } $res['name'] = $pathinfo['filename']; return $res; } return $messageMedia; } $res = []; switch ($messageMedia['_']) { // Updates case 'updateNewMessage': case 'updateNewChannelMessage': case 'updateEditMessage': case 'updateEditChannelMessage': $messageMedia = $messageMedia['message']; // no break case 'message': return yield from $this->getDownloadInfo($messageMedia['media']); case 'updateNewEncryptedMessage': $messageMedia = $messageMedia['message']; // Secret media // no break case 'encryptedMessage': if ($messageMedia['decrypted_message']['media']['_'] === 'decryptedMessageMediaExternalDocument') { return yield from $this->getDownloadInfo($messageMedia['decrypted_message']['media']); } $res['InputFileLocation'] = ['_' => 'inputEncryptedFileLocation', 'id' => $messageMedia['file']['id'], 'access_hash' => $messageMedia['file']['access_hash'], 'dc_id' => $messageMedia['file']['dc_id']]; $res['size'] = $messageMedia['decrypted_message']['media']['size']; $res['key_fingerprint'] = $messageMedia['file']['key_fingerprint']; $res['key'] = $messageMedia['decrypted_message']['media']['key']; $res['iv'] = $messageMedia['decrypted_message']['media']['iv']; if (isset($messageMedia['decrypted_message']['media']['file_name'])) { $pathinfo = \pathinfo($messageMedia['decrypted_message']['media']['file_name']); if (isset($pathinfo['extension'])) { $res['ext'] = '.'.$pathinfo['extension']; } $res['name'] = $pathinfo['filename']; } if (isset($messageMedia['decrypted_message']['media']['mime_type'])) { $res['mime'] = $messageMedia['decrypted_message']['media']['mime_type']; } elseif ($messageMedia['decrypted_message']['media']['_'] === 'decryptedMessageMediaPhoto') { $res['mime'] = 'image/jpeg'; } if (isset($messageMedia['decrypted_message']['media']['attributes'])) { foreach ($messageMedia['decrypted_message']['media']['attributes'] as $attribute) { switch ($attribute['_']) { case 'documentAttributeFilename': $pathinfo = \pathinfo($attribute['file_name']); if (isset($pathinfo['extension'])) { $res['ext'] = '.'.$pathinfo['extension']; } $res['name'] = $pathinfo['filename']; break; case 'documentAttributeAudio': $audio = $attribute; break; } } } if (isset($audio) && isset($audio['title']) && !isset($res['name'])) { $res['name'] = $audio['title']; if (isset($audio['performer'])) { $res['name'] .= ' - '.$audio['performer']; } } if (!isset($res['ext']) || $res['ext'] === '') { $res['ext'] = Tools::getExtensionFromLocation($res['InputFileLocation'], Tools::getExtensionFromMime($res['mime'] ?? 'image/jpeg')); } if (!isset($res['mime']) || $res['mime'] === '') { $res['mime'] = Tools::getMimeFromExtension($res['ext'], 'image/jpeg'); } if (!isset($res['name']) || $res['name'] === '') { $res['name'] = Tools::unpackSignedLongString($messageMedia['file']['access_hash']); } return $res; // Wallpapers case 'wallPaper': return $this->getDownloadInfo($messageMedia['document']); // Photos case 'photo': case 'messageMediaPhoto': if ($messageMedia['_'] == 'photo') { $messageMedia = ['_' => 'messageMediaPhoto', 'photo' => $messageMedia, 'ttl_seconds' => 0]; } $res['MessageMedia'] = $messageMedia; $messageMedia = $messageMedia['photo']; $size = Tools::maxSize($messageMedia['sizes']); if (isset($size['volume_id'])) { $res['InputFileLocation'] = [ '_' => 'inputPhotoLegacyFileLocation', 'id' => $messageMedia['id'], 'access_hash' => $messageMedia['access_hash'], 'dc_id' => $messageMedia['dc_id'], 'file_reference' => yield from $this->referenceDatabase->getReference(ReferenceDatabase::PHOTO_LOCATION, $messageMedia), 'volume_id' => $size['volume_id'], 'local_id' => $size['local_id'], 'secret' => $size['secret'], ]; } else { $res = \array_merge($res, yield from $this->getDownloadInfo($size)); $res['InputFileLocation'] = [ '_' => 'inputPhotoFileLocation', 'id' => $messageMedia['id'], 'access_hash' => $messageMedia['access_hash'], 'dc_id' => $messageMedia['dc_id'], 'file_reference' => yield from $this->referenceDatabase->getReference(ReferenceDatabase::PHOTO_LOCATION, $messageMedia), 'thumb_size' => $res['thumb_size'] ?? 'x', ]; } $res['name'] = Tools::unpackSignedLongString($messageMedia['id']).'_'.($res['thumb_size'] ?? 'x').'_'.$messageMedia['dc_id']; $res['ext'] = '.jpg'; $res['mime'] = 'image/jpeg'; return $res; case 'user': case 'folder': case 'channel': case 'chat': case 'updateUserPhoto': $res = (yield from $this->getDownloadInfo($messageMedia['photo'])); if (\is_array($messageMedia) && ($messageMedia['min'] ?? false) && isset($messageMedia['access_hash'])) { // bot API file ID $messageMedia['min'] = false; $peer = $this->genAll($messageMedia, null, MTProto::INFO_TYPE_PEER); } else { $peer = yield from $this->getInfo($messageMedia, MTProto::INFO_TYPE_PEER); } $res['InputFileLocation'] = [ '_' => 'inputPeerPhotoFileLocation', 'big' => true, 'peer' => $peer, 'photo_id' => $res['InputFileLocation']['photo_id'] ]; $res['name'] = Tools::unpackSignedLongString($messageMedia['id']).'_'.($res['thumb_size'] ?? 'x').'_'.$messageMedia['photo']['dc_id']; $res['ext'] = '.jpg'; $res['mime'] = 'image/jpeg'; return $res; case 'userProfilePhoto': case 'chatPhoto': $res['InputFileLocation']['has_video'] = $messageMedia['has_video'] ?? false; $res['InputFileLocation']['photo_id'] = $messageMedia['photo_id']; $res['InputFileLocation']['dc_id'] = $messageMedia['dc_id']; return $res; case 'photoStrippedSize': $res['size'] = \strlen($messageMedia['bytes']['bytes'] ?? $messageMedia['bytes']); $res['data'] = $messageMedia['bytes']; $res['thumb_size'] = 'JPG'; return $res; case 'photoCachedSize': $res['size'] = \strlen($messageMedia['bytes']); $res['data'] = $messageMedia['bytes']; $res['thumb_size'] = $messageMedia['type']; return $res; case 'photoSize': $res['thumb_size'] = $messageMedia['type']; //$res['thumb_size'] = $size; if (isset($messageMedia['size'])) { $res['size'] = $messageMedia['size']; } return $res; case 'photoSizeProgressive': $res['thumb_size'] = $messageMedia['type']; if (isset($messageMedia['sizes'])) { $res['size'] = \end($messageMedia['sizes']); } return $res; // Documents case 'decryptedMessageMediaExternalDocument': case 'document': $messageMedia = ['_' => 'messageMediaDocument', 'ttl_seconds' => 0, 'document' => $messageMedia]; // no break case 'messageMediaDocument': $res['MessageMedia'] = $messageMedia; foreach ($messageMedia['document']['attributes'] as $attribute) { switch ($attribute['_']) { case 'documentAttributeFilename': $pathinfo = \pathinfo($attribute['file_name']); if (isset($pathinfo['extension'])) { $res['ext'] = '.'.$pathinfo['extension']; } $res['name'] = $pathinfo['filename']; break; case 'documentAttributeAudio': $audio = $attribute; break; } } if (isset($audio) && isset($audio['title']) && !isset($res['name'])) { $res['name'] = $audio['title']; if (isset($audio['performer'])) { $res['name'] .= ' - '.$audio['performer']; } } $res['InputFileLocation'] = ['_' => 'inputDocumentFileLocation', 'id' => $messageMedia['document']['id'], 'access_hash' => $messageMedia['document']['access_hash'], 'version' => isset($messageMedia['document']['version']) ? $messageMedia['document']['version'] : 0, 'dc_id' => $messageMedia['document']['dc_id'], 'file_reference' => yield from $this->referenceDatabase->getReference(ReferenceDatabase::DOCUMENT_LOCATION, $messageMedia['document'])]; if (!isset($res['ext']) || $res['ext'] === '') { $res['ext'] = Tools::getExtensionFromLocation($res['InputFileLocation'], Tools::getExtensionFromMime($messageMedia['document']['mime_type'])); } if (!isset($res['name']) || $res['name'] === '') { $res['name'] = Tools::unpackSignedLongString($messageMedia['document']['access_hash']); } if (isset($messageMedia['document']['size'])) { $res['size'] = $messageMedia['document']['size']; } $res['name'] .= '_'.Tools::unpackSignedLongString($messageMedia['document']['id']); $res['mime'] = $messageMedia['document']['mime_type']; return $res; default: throw new \danog\MadelineProto\Exception('Invalid constructor provided: '.$messageMedia['_']); } } /** * Download file to directory. * * @param mixed $messageMedia File to download * @param string|FileCallbackInterface $dir Directory where to download the file * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * * * @psalm-return \Generator|\Amp\Promise<\Amp\Ipc\Sync\ChannelledSocket>|\Amp\Promise|\Amp\Promise|array|bool|mixed, mixed, false|string> */ public function downloadToDir($messageMedia, $dir, $cb = null): \Generator { if (\is_object($dir) && $dir instanceof FileCallbackInterface) { $cb = $dir; $dir = yield $dir->getFile(); } $messageMedia = (yield from $this->getDownloadInfo($messageMedia)); return yield from $this->downloadToFile($messageMedia, $dir.'/'.$messageMedia['name'].$messageMedia['ext'], $cb); } /** * Download file. * * @param mixed $messageMedia File to download * @param string|FileCallbackInterface $file Downloaded file path * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * * @return \Generator Downloaded file path * * @psalm-return \Generator|\Amp\Promise<\Amp\Ipc\Sync\ChannelledSocket>|\Amp\Promise|\Amp\Promise|array|bool|mixed, mixed, false|string> */ public function downloadToFile($messageMedia, $file, $cb = null): \Generator { if (\is_object($file) && $file instanceof FileCallbackInterface) { $cb = $file; $file = yield $file->getFile(); } $file = Tools::absolute(\preg_replace('|/+|', '/', $file)); if (!yield exists($file)) { yield touchAsync($file); } $file = \realpath($file); $messageMedia = (yield from $this->getDownloadInfo($messageMedia)); $size = yield getSize($file); $stream = yield openFile($file, 'cb'); $this->logger->logger('Waiting for lock of file to download...'); $unlock = yield Tools::flock("$file.lock", LOCK_EX); $this->logger->logger('Got lock of file to download'); try { yield from $this->downloadToStream($messageMedia, $stream, $cb, $size, -1); } finally { $unlock(); \unlink("$file.lock"); yield $stream->close(); } return $file; } /** * Download file to callable. * The callable must accept two parameters: string $payload, int $offset * The callable will be called (possibly out of order, depending on the value of $seekable). * The callable should return the number of written bytes. * * @param mixed $messageMedia File to download * @param callable|FileCallbackInterface $callable Chunk callback * @param callable $cb Status callback (DEPRECATED, use FileCallbackInterface) * @param bool $seekable Whether the callable can be called out of order * @param int $offset Offset where to start downloading * @param int $end Offset where to stop downloading (inclusive) * @param int $part_size Size of each chunk * * * @psalm-return \Generator */ public function downloadToCallable($messageMedia, callable $callable, $cb = null, bool $seekable = true, int $offset = 0, int $end = -1, int $part_size = null): \Generator { $messageMedia = (yield from $this->getDownloadInfo($messageMedia)); if (\is_object($callable) && $callable instanceof FileCallbackInterface) { $cb = $callable; $callable = yield $callable->getFile(); } if (!\is_callable($callable)) { throw new Exception('Wrong callable provided'); } if ($cb === null) { $cb = function ($percent): void { $this->logger->logger('Download status: '.$percent.'%', \danog\MadelineProto\Logger::NOTICE); }; } if ($end === -1 && isset($messageMedia['size'])) { $end = $messageMedia['size']; } $part_size = $part_size ?? 1024 * 1024; $parallel_chunks = $this->settings->getFiles()->getDownloadParallelChunks(); $datacenter = $messageMedia['InputFileLocation']['dc_id'] ?? $this->settings->getDefaultDc(); if ($this->datacenter->has($datacenter.'_media')) { $datacenter .= '_media'; } if (isset($messageMedia['key'])) { $digest = \hash('md5', $messageMedia['key'].$messageMedia['iv'], true); $fingerprint = Tools::unpackSignedInt(\substr($digest, 0, 4) ^ \substr($digest, 4, 4)); if ($fingerprint !== $messageMedia['key_fingerprint']) { throw new \danog\MadelineProto\Exception('Fingerprint mismatch!'); } $ige = IGE::getInstance($messageMedia['key'], $messageMedia['iv']); $seekable = false; } if ($offset === $end) { $cb(100, 0, 0); return true; } $params = []; $start_at = $offset % $part_size; $probable_end = $end !== -1 ? $end : 512 * 1024 * 8000; $breakOut = false; for ($x = $offset - $start_at; $x < $probable_end; $x += $part_size) { $end_at = $part_size; if ($end !== -1 && $x + $part_size > $end) { $end_at = $end % $part_size; $breakOut = true; } $params[] = ['offset' => $x, 'limit' => $part_size, 'part_start_at' => $start_at, 'part_end_at' => $end_at]; $start_at = 0; if ($breakOut) { break; } } if (!$params) { $cb(100, 0, 0); return true; } $count = \count($params); $time = 0; $speed = 0; $origCb = $cb; $cb = static function () use ($cb, $count, &$time, &$speed): void { static $cur = 0; $cur++; Tools::callFork($cb($cur * 100 / $count, $time, $speed)); }; $cdn = false; $params[0]['previous_promise'] = new Success(true); $start = \microtime(true); $old_dc = null; $size = yield from $this->downloadPart($messageMedia, $cdn, $datacenter, $old_dc, $ige, $cb, $initParam = \array_shift($params), $callable, $seekable); if ($initParam['part_end_at'] - $initParam['part_start_at'] !== $size) { // Premature end for undefined length files $origCb(100, 0, 0); return true; } $parallel_chunks = $seekable ? $parallel_chunks : 1; if ($params) { $previous_promise = new Success(true); $promises = []; foreach ($params as $key => $param) { $param['previous_promise'] = $previous_promise; $previous_promise = Tools::call($this->downloadPart($messageMedia, $cdn, $datacenter, $old_dc, $ige, $cb, $param, $callable, $seekable)); $previous_promise->onResolve(static function ($e, $res) use (&$size): void { if ($res) { $size += $res; } }); $promises[] = $previous_promise; if (!($key % $parallel_chunks)) { // 20 mb at a time, for a typical bandwidth of 1gbps $res = yield Tools::all($promises); $promises = []; foreach ($res as $r) { if (!$r) { break 2; } } $time = \microtime(true) - $start; $speed = (int) ($size * 8 / $time) / 1000000; $this->logger->logger("Partial download time: {$time}"); $this->logger->logger("Partial download speed: {$speed} mbps"); } } if ($promises) { yield Tools::all($promises); } } $time = \microtime(true) - $start; $speed = (int) ($size * 8 / $time) / 1000000; $this->logger->logger("Total download time: {$time}"); $this->logger->logger("Total download speed: {$speed} mbps"); if ($cdn) { $this->clearCdnHashes($messageMedia['file_token']); } if (!isset($messageMedia['size'])) { $origCb(100, $time, $speed); } return true; } /** * Download file part. * * @param array $messageMedia File object * @param bool $cdn Whether this is a CDN file * @param string $datacenter DC ID * @param ?string $old_dc Previous DC ID * @param IGE $ige IGE decryptor instance * @param callable $cb Status callback * @param array $offset Offset * @param callable $callable Chunk callback * @param boolean $seekable Whether the download file is seekable * @param boolean $postpone Whether to postpone method call * */ private function downloadPart(&$messageMedia, bool &$cdn, &$datacenter, &$old_dc, &$ige, $cb, array $offset, $callable, bool $seekable, bool $postpone = false): \Generator { static $method = [ false => 'upload.getFile', // non-cdn true => 'upload.getCdnFile', ]; do { if (!$cdn) { $basic_param = ['location' => $messageMedia['InputFileLocation']]; } else { $basic_param = ['file_token' => $messageMedia['file_token']]; } //$x = 0; while (true) { try { $res = yield from $this->methodCallAsyncRead($method[$cdn], $basic_param + $offset, ['heavy' => true, 'file' => true, 'FloodWaitLimit' => 0, 'datacenter' => &$datacenter, 'postpone' => $postpone]); break; } catch (\danog\MadelineProto\RPCErrorException $e) { if (\strpos($e->rpc, 'FLOOD_WAIT_') === 0) { yield Tools::sleep(1); continue; } switch ($e->rpc) { case 'FILE_TOKEN_INVALID': $cdn = false; continue 3; default: throw $e; } } } if ($res['_'] === 'upload.fileCdnRedirect') { $cdn = true; $messageMedia['file_token'] = $res['file_token']; $messageMedia['cdn_key'] = $res['encryption_key']; $messageMedia['cdn_iv'] = $res['encryption_iv']; $old_dc = $datacenter; $datacenter = $res['dc_id'].'_cdn'; if (!$this->datacenter->has($datacenter)) { $this->config['expires'] = -1; yield from $this->getConfig([]); } $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['stored_on_cdn'], \danog\MadelineProto\Logger::NOTICE); continue; } elseif ($res['_'] === 'upload.cdnFileReuploadNeeded') { $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['cdn_reupload'], \danog\MadelineProto\Logger::NOTICE); yield from $this->getConfig([]); try { $this->addCdnHashes($messageMedia['file_token'], yield from $this->methodCallAsyncRead('upload.reuploadCdnFile', ['file_token' => $messageMedia['file_token'], 'request_token' => $res['request_token']], ['heavy' => true, 'datacenter' => $old_dc])); } catch (\danog\MadelineProto\RPCErrorException $e) { switch ($e->rpc) { case 'FILE_TOKEN_INVALID': case 'REQUEST_TOKEN_INVALID': $cdn = false; continue 2; default: throw $e; } } continue; } $res['bytes'] = (string) $res['bytes']; if ($cdn === false && $res['type']['_'] === 'storage.fileUnknown' && $res['bytes'] === '') { $datacenter = 0; } while ($cdn === false && $res['type']['_'] === 'storage.fileUnknown' && $res['bytes'] === '' && $this->datacenter->has(++$datacenter)) { $res = yield from $this->methodCallAsyncRead('upload.getFile', $basic_param + $offset, ['heavy' => true, 'file' => true, 'FloodWaitLimit' => 0, 'datacenter' => $datacenter]); } if ($res['bytes'] === '') { return 0; } if (isset($messageMedia['cdn_key'])) { $ivec = \substr($messageMedia['cdn_iv'], 0, 12).\pack('N', $offset['offset'] >> 4); $res['bytes'] = Crypt::ctrEncrypt($res['bytes'], $messageMedia['cdn_key'], $ivec); $this->checkCdnHash($messageMedia['file_token'], $offset['offset'], $res['bytes'], $old_dc); } if (isset($messageMedia['key'])) { $res['bytes'] = $ige->decrypt($res['bytes']); } if ($offset['part_start_at'] || $offset['part_end_at'] !== $offset['limit']) { $res['bytes'] = \substr($res['bytes'], $offset['part_start_at'], $offset['part_end_at'] - $offset['part_start_at']); } if (!$seekable) { yield $offset['previous_promise']; } $res = yield $callable($res['bytes'], $offset['offset'] + $offset['part_start_at']); $cb(); return $res; } while (true); } private $cdn_hashes = []; private function addCdnHashes($file, $hashes): void { if (!isset($this->cdn_hashes[$file])) { $this->cdn_hashes = []; } foreach ($hashes as $hash) { $this->cdn_hashes[$file][$hash['offset']] = ['limit' => $hash['limit'], 'hash' => (string) $hash['hash']]; } } private function checkCdnHash($file, $offset, $data, &$datacenter): \Generator { while (\strlen($data)) { if (!isset($this->cdn_hashes[$file][$offset])) { $this->addCdnHashes($file, yield from $this->methodCallAsyncRead('upload.getCdnFileHashes', ['file_token' => $file, 'offset' => $offset], ['datacenter' => $datacenter])); } if (!isset($this->cdn_hashes[$file][$offset])) { throw new \danog\MadelineProto\Exception('Could not fetch CDN hashes for offset '.$offset); } if (\hash('sha256', \substr($data, 0, $this->cdn_hashes[$file][$offset]['limit']), true) !== $this->cdn_hashes[$file][$offset]['hash']) { throw new \danog\MadelineProto\SecurityException('CDN hash mismatch for offset '.$offset); } $data = \substr($data, $this->cdn_hashes[$file][$offset]['limit']); $offset += $this->cdn_hashes[$file][$offset]['limit']; } return true; } /** * @return true */ private function clearCdnHashes($file): bool { unset($this->cdn_hashes[$file]); return true; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools; use danog\MadelineProto\Settings; /** * Manages method and object calls. * * @property Settings $settings Settings */ trait CallHandler { /** * Synchronous wrapper for methodCall. * * @param string $method Method name * @param array|\Generator $args Arguments * @param array $aargs Additional arguments * * @psalm-param array|\Generator $args * */ public function methodCall(string $method, $args = [], array $aargs = ['msg_id' => null]) { return \danog\MadelineProto\Tools::wait($this->methodCallAsyncRead($method, $args, $aargs)); } /** * Call method and wait asynchronously for response. * * If the $aargs['noResponse'] is true, will not wait for a response. * * @param string $method Method name * @param array|\Generator $args Arguments * @param array $aargs Additional arguments * * @psalm-param array|\Generator $args * */ public function methodCallAsyncRead(string $method, $args = [], array $aargs = ['msg_id' => null]): \Generator { return yield from (yield from $this->datacenter->waitGetConnection($aargs['datacenter'] ?? $this->datacenter->curdc))->methodCallAsyncRead($method, $args, $aargs); } /** * Call method and make sure it is asynchronously sent. * * @param string $method Method name * @param array|\Generator $args Arguments * @param array $aargs Additional arguments * * @psalm-param array|\Generator $args * */ public function methodCallAsyncWrite(string $method, $args = [], array $aargs = ['msg_id' => null]): \Generator { return yield from (yield from $this->datacenter->waitGetConnection($aargs['datacenter'] ?? $this->datacenter->curdc))->methodCallAsyncWrite($method, $args, $aargs); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoTools; /** * Stores multiple update states. * * @internal */ class CombinedUpdatesState { /** * Update states. * * @var array */ private $states = []; /** * Constructor function. * * @param array $init Initial array of states */ public function __construct($init = []) { $this->states[false] = new UpdatesState(); if (!\is_array($init)) { return; } foreach ($init as $channel => $state) { if (\is_array($state)) { $state = new UpdatesState($state, $channel); } $this->states[$channel] = $state; } } /** * Get or update multiple parameters. * * @param int $channel Channel to get info about (optional, if not provided returns the entire info array) * @param array $init Parameters to update * * @return UpdatesState|UpdatesState[] */ public function get(int $channel = null, array $init = []) { if ($channel === null) { return $this->states; } if (!isset($this->states[$channel])) { return $this->states[$channel] = new UpdatesState($init, $channel); } return $this->states[$channel]->update($init); } /** * Remove update state. * * @param int $channel Channel whose state should be removed * */ public function remove(int $channel): void { if (isset($this->states[$channel])) { unset($this->states[$channel]); } } /** * Check if update state is present. * * @param int $channel Channel ID * */ public function has(int $channel): bool { return isset($this->states[$channel]); } /** * Are we currently busy? * * @param int $channel Channel to get info about * @param bool|null $set Busy flag to set before returning * */ public function syncLoading(int $channel, bool $set = null): bool { return $this->get($channel)->syncLoading($set); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Dns\Resolver; use Amp\Http\Client\HttpClient; use Amp\Loop; use Amp\Promise; use Amp\Success; use Closure; use danog\MadelineProto\Async\AsyncConstruct; use danog\MadelineProto\Db\DbArray; use danog\MadelineProto\Db\DbPropertiesFactory; use danog\MadelineProto\Db\DbPropertiesTrait; use danog\MadelineProto\Db\MemoryArray; use danog\MadelineProto\Ipc\Server; use danog\MadelineProto\Loop\Generic\PeriodicLoopInternal; use danog\MadelineProto\Loop\Update\FeedLoop; use danog\MadelineProto\Loop\Update\SecretFeedLoop; use danog\MadelineProto\Loop\Update\SeqLoop; use danog\MadelineProto\Loop\Update\UpdateLoop; use danog\MadelineProto\MTProtoTools\CombinedUpdatesState; use danog\MadelineProto\MTProtoTools\MinDatabase; use danog\MadelineProto\MTProtoTools\ReferenceDatabase; use danog\MadelineProto\MTProtoTools\UpdatesState; use danog\MadelineProto\Settings\Database\Memory; use danog\MadelineProto\Settings\TLSchema; use danog\MadelineProto\TL\TL; use danog\MadelineProto\TL\TLCallback; use Psr\Log\LoggerInterface; use function Amp\File\getSize; use function Amp\File\touch as touchAsync; /** * Manages all of the mtproto stuff. * * @internal */ class MTProto extends AsyncConstruct implements TLCallback { use \danog\Serializable; use \danog\MadelineProto\MTProtoTools\AuthKeyHandler; use \danog\MadelineProto\MTProtoTools\CallHandler; use \danog\MadelineProto\MTProtoTools\PeerHandler; use \danog\MadelineProto\MTProtoTools\UpdateHandler; use \danog\MadelineProto\MTProtoTools\Files; use \danog\MadelineProto\SecretChats\AuthKeyHandler; use \danog\MadelineProto\SecretChats\MessageHandler; use \danog\MadelineProto\SecretChats\ResponseHandler; use \danog\MadelineProto\SecretChats\SeqNoHandler; use \danog\MadelineProto\TL\Conversion\BotAPI; use \danog\MadelineProto\TL\Conversion\BotAPIFiles; use \danog\MadelineProto\TL\Conversion\TD; use \danog\MadelineProto\VoIP\AuthKeyHandler; use \danog\MadelineProto\Wrappers\Ads; use \danog\MadelineProto\Wrappers\Button; use \danog\MadelineProto\Wrappers\DialogHandler; use \danog\MadelineProto\Wrappers\Events; use \danog\MadelineProto\Wrappers\Webhook; use \danog\MadelineProto\Wrappers\Callback; use \danog\MadelineProto\Wrappers\Login; use \danog\MadelineProto\Wrappers\Loop; use \danog\MadelineProto\Wrappers\Noop; use \danog\MadelineProto\Wrappers\Start; use \danog\MadelineProto\Wrappers\Templates; use \danog\MadelineProto\Wrappers\TOS; use DbPropertiesTrait; private const RSA_KEYS = [ "-----BEGIN RSA PUBLIC KEY-----\n". "MIIBCgKCAQEA6LszBcC1LGzyr992NzE0ieY+BSaOW622Aa9Bd4ZHLl+TuFQ4lo4g\n". "5nKaMBwK/BIb9xUfg0Q29/2mgIR6Zr9krM7HjuIcCzFvDtr+L0GQjae9H0pRB2OO\n". "62cECs5HKhT5DZ98K33vmWiLowc621dQuwKWSQKjWf50XYFw42h21P2KXUGyp2y/\n". "+aEyZ+uVgLLQbRA1dEjSDZ2iGRy12Mk5gpYc397aYp438fsJoHIgJ2lgMv5h7WY9\n". "t6N/byY9Nw9p21Og3AoXSL2q/2IJ1WRUhebgAdGVMlV1fkuOQoEzR7EdpqtQD9Cs\n". "5+bfo3Nhmcyvk5ftB0WkJ9z6bNZ7yxrP8wIDAQAB\n". "-----END RSA PUBLIC KEY-----" ]; private const TEST_RSA_KEYS = [ "-----BEGIN RSA PUBLIC KEY-----\n". "MIIBCgKCAQEAyMEdY1aR+sCR3ZSJrtztKTKqigvO/vBfqACJLZtS7QMgCGXJ6XIR\n". "yy7mx66W0/sOFa7/1mAZtEoIokDP3ShoqF4fVNb6XeqgQfaUHd8wJpDWHcR2OFwv\n". "plUUI1PLTktZ9uW2WE23b+ixNwJjJGwBDJPQEQFBE+vfmH0JP503wr5INS1poWg/\n". "j25sIWeYPHYeOrFp/eXaqhISP6G+q2IeTaWTXpwZj4LzXq5YOpk4bYEQ6mvRq7D1\n". "aHWfYmlEGepfaYR8Q0YqvvhYtMte3ITnuSJs171+GDqpdKcSwHnd6FudwGO4pcCO\n". "j4WcDuXc2CTHgH8gFTNhp/Y8/SpDOhvn9QIDAQAB\n". "-----END RSA PUBLIC KEY-----" ]; /** * Internal version of MadelineProto. * * Increased every time the default settings array or something big changes * * @internal * * @var int */ const V = 162; /** * Release version. * * @var string */ const RELEASE = '7.0'; /** * We're not logged in. * * @var int */ const NOT_LOGGED_IN = 0; /** * We're waiting for the login code. * * @var int */ const WAITING_CODE = 1; /** * We're waiting for parameters to sign up. * * @var int */ const WAITING_SIGNUP = -1; /** * We're waiting for the 2FA password. * * @var int */ const WAITING_PASSWORD = 2; /** * We're logged in. * * @var int */ const LOGGED_IN = 3; /** * Bad message error codes. * * @internal * * @var array */ const BAD_MSG_ERROR_CODES = [16 => 'msg_id too low (most likely, client time is wrong; it would be worthwhile to synchronize it using msg_id notifications and re-send the original message with the correct msg_id or wrap it in a container with a new msg_id if the original message had waited too long on the client to be transmitted)', 17 => 'msg_id too high (similar to the previous case, the client time has to be synchronized, and the message re-sent with the correct msg_id)', 18 => 'incorrect two lower order msg_id bits (the server expects client message msg_id to be divisible by 4)', 19 => 'container msg_id is the same as msg_id of a previously received message (this must never happen)', 20 => 'message too old, and it cannot be verified whether the server has received a message with this msg_id or not', 32 => 'msg_seqno too low (the server has already received a message with a lower msg_id but with either a higher or an equal and odd seqno)', 33 => 'msg_seqno too high (similarly, there is a message with a higher msg_id but with either a lower or an equal and odd seqno)', 34 => 'an even msg_seqno expected (irrelevant message), but odd received', 35 => 'odd msg_seqno expected (relevant message), but even received', 48 => 'incorrect server salt (in this case, the bad_server_salt response is received with the correct salt, and the message is to be re-sent with it)', 64 => 'invalid container']; /** * Localized message info flags. * * @internal * * @var array */ const MSGS_INFO_FLAGS = [1 => 'nothing is known about the message (msg_id too low, the other party may have forgotten it)', 2 => 'message not received (msg_id falls within the range of stored identifiers; however, the other party has certainly not received a message like that)', 3 => 'message not received (msg_id too high; however, the other party has certainly not received it yet)', 4 => 'message received (note that this response is also at the same time a receipt acknowledgment)', 8 => ' and message already acknowledged', 16 => ' and message not requiring acknowledgment', 32 => ' and RPC query contained in message being processed or processing already complete', 64 => ' and content-related response to message already generated', 128 => ' and other party knows for a fact that message is already received']; /** * Secret chat was not found. * * @var int */ const SECRET_EMPTY = 0; /** * Secret chat was requested. * * @var int */ const SECRET_REQUESTED = 1; /** * Secret chat was found. * * @var int */ const SECRET_READY = 2; /** * @internal */ const GETUPDATES_HANDLER = 'getUpdates'; /** * @internal */ const TD_PARAMS_CONVERSION = ['updateNewMessage' => ['_' => 'updateNewMessage', 'disable_notification' => ['message', 'silent'], 'message' => ['message']], 'message' => ['_' => 'message', 'id' => ['id'], 'sender_user_id' => ['from_id'], 'chat_id' => ['peer_id', 'choose_chat_id_from_botapi'], 'send_state' => ['choose_incoming_or_sent'], 'can_be_edited' => ['choose_can_edit'], 'can_be_deleted' => ['choose_can_delete'], 'is_post' => ['post'], 'date' => ['date'], 'edit_date' => ['edit_date'], 'forward_info' => ['fwd_info', 'choose_forward_info'], 'reply_to_message_id' => ['reply_to_msg_id'], 'ttl' => ['choose_ttl'], 'ttl_expires_in' => ['choose_ttl_expires_in'], 'via_bot_user_id' => ['via_bot_id'], 'views' => ['views'], 'content' => ['choose_message_content'], 'reply_markup' => ['reply_markup']], 'messages.sendMessage' => ['chat_id' => ['peer'], 'reply_to_message_id' => ['reply_to_msg_id'], 'disable_notification' => ['silent'], 'from_background' => ['background'], 'input_message_content' => ['choose_message_content'], 'reply_markup' => ['reply_markup']]]; /** * @internal */ const TD_REVERSE = ['sendMessage' => 'messages.sendMessage']; /** * @internal */ const TD_IGNORE = ['updateMessageID']; /** * Whether to generate only peer information. */ const INFO_TYPE_PEER = 0; /** * Whether to generate only constructor information. */ const INFO_TYPE_CONSTRUCTOR = 1; /** * Whether to generate only ID information. */ const INFO_TYPE_ID = 2; /** * Whether to generate all information. */ const INFO_TYPE_ALL = 3; /** * Whether to generate all usernames. */ const INFO_TYPE_USERNAMES = 4; /** * @internal */ const BOTAPI_PARAMS_CONVERSION = ['disable_web_page_preview' => 'no_webpage', 'disable_notification' => 'silent', 'reply_to_message_id' => 'reply_to_msg_id', 'chat_id' => 'peer', 'text' => 'message']; /** * @internal */ const DEFAULT_GETUPDATES_PARAMS = ['offset' => 0, 'limit' => null, 'timeout' => 100]; /** * Array of references to all instances of MTProto. * * This seems like a recipe for memory leaks, but this is actually required to allow saving the session on shutdown. * When using a network I/O-based database+the EvDriver of AMPHP, calling die(); causes premature garbage collection of the event loop. * This garbage collection happens always, even if a reference to the event handler is already present elsewhere (probably ev dark magic). * * Finally, this causes the process to hang on shutdown, since the database driver cannot receive a reply from the server, because the event loop is down. * * To avoid this, we store each MTProto instance in here (unreferencing on shutdown in unreference()), and call serialize() on all instances before calling die; in Magic. * * @var self[] */ public static array $references = []; /** * Instance of wrapper API. * * @var APIWrapper */ public $wrapper; /** * PWRTelegram webhook URL. * * @var boolean|string */ public $hook_url = false; /** * Settings object. * * @var Settings */ public $settings; /** * Config array. * * @var array */ private $config = ['expires' => -1]; /** * TOS info. * * @var array */ private $tos = ['expires' => 0, 'accepted' => true]; /** * Whether we're initing authorization. * * @var boolean */ private $initing_authorization = false; /** * Authorization info (User). * * @var array|null */ public $authorization = null; /** * Whether we're authorized. * * @var int * @psalm-var self::NOT_LOGGED_IN|self::WAITING_*|self::LOGGED_IN */ public $authorized = self::NOT_LOGGED_IN; /** * Main authorized DC ID. * * @var integer */ public $authorized_dc = -1; /** * RSA keys. * * @var array */ private $rsa_keys = []; /** * RSA keys. * * @var array */ private $test_rsa_keys = []; /** * CDN RSA keys. * * @var array */ private $cdn_rsa_keys = []; /** * Diffie-hellman config. * * @var array */ private $dh_config = ['version' => 0]; /** * Internal peer database. * * @var DbArray|Promise[] */ public $chats; /** * Cache of usernames for chats. * * @var DbArray|Promise[] */ public $usernames; /** * Cached parameters for fetching channel participants. * * @var DbArray|Promise[] */ public $channelParticipants; /** * When we last stored data in remote peer database (now doesn't exist anymore). * * @var integer */ public $last_stored = 0; /** * Temporary array of data to be sent to remote peer database. * * @var array */ public $qres = []; /** * Full chat info database. * * @var DbArray|Promise[] */ public $full_chats; /** * Sponsored message database. * * @var DbArray */ public $sponsoredMessages; /** * Latest chat message ID map for update handling. * * @var array */ private $msg_ids = []; /** * Version integer for upgrades. * * @var integer */ private $v = 0; /** * Cached getdialogs params. * * @var array */ private $dialog_params = ['limit' => 0, 'offset_date' => 0, 'offset_id' => 0, 'offset_peer' => ['_' => 'inputPeerEmpty'], 'count' => 0]; /** * Support user ID. * * @var integer */ private $supportUser = 0; /** * File reference database. * * @var \danog\MadelineProto\MTProtoTools\ReferenceDatabase */ public $referenceDatabase; /** * min database. * * @var \danog\MadelineProto\MTProtoTools\MinDatabase */ public $minDatabase; /** * TOS check loop. */ public ?PeriodicLoopInternal $checkTosLoop = null; /** * Phone config loop. */ public ?PeriodicLoopInternal $phoneConfigLoop = null; /** * Config loop. */ public ?PeriodicLoopInternal $configLoop = null; /** * Call checker loop. */ private ?PeriodicLoopInternal $callCheckerLoop = null; /** * Autoserialization loop. */ private ?PeriodicLoopInternal $serializeLoop = null; /** * SEQ update loop. */ private ?SeqLoop $seqUpdater = null; /** * IPC server. */ private ?Server $ipcServer = null; /** * Feeder loops. * * @var array<\danog\MadelineProto\Loop\Update\FeedLoop> */ public $feeders = []; /** * Secret chat feeder loops. * * @var array<\danog\MadelineProto\Loop\Update\SecretFeedLoop> */ public $secretFeeders = []; /** * Updater loops. * * @var array<\danog\MadelineProto\Loop\Update\UpdateLoop> */ public $updaters = []; /** * DataCenter instance. * * @var DataCenter */ public $datacenter; /** * Logger instance. * * @var Logger */ public $logger; /** * TL serializer. * * @var \danog\MadelineProto\TL\TL */ private $TL; /** * Snitch. */ private Snitch $snitch; /** * DC list. */ protected array $dcList = [ 'test' => [ // Test datacenters 'ipv4' => [ // ipv4 addresses 2 => [ // The rest will be fetched using help.getConfig 'ip_address' => '149.154.167.40', 'port' => 443, 'media_only' => false, 'tcpo_only' => false, ], ], 'ipv6' => [ // ipv6 addresses 2 => [ // The rest will be fetched using help.getConfig 'ip_address' => '2001:067c:04e8:f002:0000:0000:0000:000e', 'port' => 443, 'media_only' => false, 'tcpo_only' => false, ], ], ], 'main' => [ // Main datacenters 'ipv4' => [ // ipv4 addresses 2 => [ // The rest will be fetched using help.getConfig 'ip_address' => '149.154.167.51', 'port' => 443, 'media_only' => false, 'tcpo_only' => false, ], ], 'ipv6' => [ // ipv6 addresses 2 => [ // The rest will be fetched using help.getConfig 'ip_address' => '2001:067c:04e8:f002:0000:0000:0000:000a', 'port' => 443, 'media_only' => false, 'tcpo_only' => false, ], ], ] ]; /** * Nullcache array for storing main session file to DB. * * @var DbArray|Promise[] */ public $session; /** * List of properties stored in database (memory or external). * @see DbPropertiesFactory */ protected static array $dbProperties = [ 'chats' => 'array', 'full_chats' => 'array', 'sponsoredMessages' => 'array', 'channelParticipants' => 'array', 'usernames' => 'array', 'session' => [ 'type' => 'array', 'config' => ['enableCache' => false] ] ]; /** * Serialize session, returning object to serialize to db. * */ public function serializeSession(object $data): \Generator { if (!isset($this->session) || !$this->session || $this->session instanceof MemoryArray) { return $data; } yield $this->session->set('data', $data); return $this->session; } /** * @internal * @return array */ public function getRsaKeys(bool $test, bool $cdn): array { if ($cdn) { return $this->cdn_rsa_keys; } if ($test) { return $this->test_rsa_keys; } return $this->rsa_keys; } /** * Serialize all instances. * * CALLED ONLY ON SHUTDOWN. * */ public static function serializeAll(): void { static $done = false; if ($done) { return; } $done = true; Logger::log('Prompting final serialization (SHUTDOWN)...'); foreach (self::$references as $instance) { Tools::wait($instance->wrapper->serialize()); } Logger::log('Done final serialization (SHUTDOWN)!'); } /** * Constructor function. * * @param Settings|SettingsEmpty $settings Settings * @param ?APIWrapper $wrapper API wrapper * */ public function __magic_construct(SettingsAbstract $settings, ?APIWrapper $wrapper = null): void { if (static::class !== self::class || !$wrapper) { return; } self::$references[\spl_object_hash($this)] = $this; $this->wrapper = $wrapper; $this->setInitPromise($this->__construct_async($settings)); } /** * Async constructor function. * * @param Settings|SettingsEmpty $settings Settings * */ public function __construct_async(SettingsAbstract $settings): \Generator { // Initialize needed stuffs Magic::start(); // Parse and store settings $this->updateSettingsInternal($settings); // Actually instantiate needed classes like a boss yield from $this->cleanupProperties(); // Start IPC server if (!$this->ipcServer) { try { $this->ipcServer = new Server($this); $this->ipcServer->setSettings($this->settings->getIpc()); $this->ipcServer->setIpcPath($this->wrapper->session); } catch (\Throwable $e) { $this->logger->logger("Error while starting IPC server: $e", Logger::FATAL_ERROR); } } try { $this->ipcServer->start(); } catch (\Throwable $e) { if (Magic::$isIpcWorker) { throw $e; } $this->logger->logger("Error while starting IPC server: $e", Logger::FATAL_ERROR); } // Load rsa keys $this->rsa_keys = []; foreach (self::RSA_KEYS as $key) { $key = yield from RSA::load($this->TL, $key); $this->rsa_keys[$key->fp] = $key; } $this->test_rsa_keys = []; foreach (self::TEST_RSA_KEYS as $key) { $key = yield from RSA::load($this->TL, $key); $this->test_rsa_keys[$key->fp] = $key; } // (re)-initialize TL $callbacks = [$this]; if ($this->settings->getDb()->getEnableFileReferenceDb()) { $callbacks []= $this->referenceDatabase; } if (!($this->authorization['user']['bot'] ?? false) && $this->settings->getDb()->getEnableMinDb()) { $callbacks[] = $this->minDatabase; } $this->TL->init($this->settings->getSchema(), $callbacks); yield from $this->connectToAllDcs(); $this->startLoops(); $this->datacenter->curdc = 2; if ((!isset($this->authorization['user']['bot']) || !$this->authorization['user']['bot']) && $this->datacenter->getDataCenterConnection($this->datacenter->curdc)->hasTempAuthKey()) { try { $nearest_dc = yield from $this->methodCallAsyncRead('help.getNearestDc', []); $this->logger->logger(\sprintf(Lang::$current_lang['nearest_dc'], $nearest_dc['country'], $nearest_dc['nearest_dc']), Logger::NOTICE); if ($nearest_dc['nearest_dc'] != $nearest_dc['this_dc']) { $this->settings->setDefaultDc($this->datacenter->curdc = (int) $nearest_dc['nearest_dc']); } } catch (RPCErrorException $e) { if ($e->rpc !== 'BOT_METHOD_INVALID') { throw $e; } } } yield from $this->getConfig([]); $this->startUpdateSystem(true); $this->v = self::V; $this->settings->applyChanges(); GarbageCollector::start(); } /** * Set API wrapper needed for triggering serialization functions. * * @internal */ public function setWrapper(APIWrapper $wrapper): void { $this->wrapper = $wrapper; } /** * Get API wrapper. * * @internal */ public function getWrapper(): APIWrapper { return $this->wrapper; } /** * Sleep function. * */ public function __sleep(): array { $db = $this->settings->getDb(); if ($db instanceof Memory && $db->getCleanup()) { Tools::wait($this->cleanup()); } $res = [ // Databases 'chats', 'full_chats', 'referenceDatabase', 'minDatabase', 'channelParticipants', 'usernames', 'sponsoredMessages', 'tmpDbPrefix', // Misc caching 'dialog_params', 'last_stored', 'qres', 'supportUser', 'tos', // Event handler 'event_handler', 'event_handler_instance', 'loop_callback', 'updates', 'updates_key', 'hook_url', // Web login template 'webTemplate', // Settings 'settings', 'config', 'dcList', // Authorization keys 'datacenter', // Authorization state 'authorization', 'authorized', 'authorized_dc', // Authorization cache 'rsa_keys', 'test_rsa_keys', 'dh_config', // Update state 'got_state', 'channels_state', 'msg_ids', // Version 'v', // TL 'TL', // Secret chats 'secret_chats', 'temp_requested_secret_chats', 'temp_rekeyed_secret_chats', // Report URI 'reportDest', 'calls', 'snitch', ]; if (!$this->updateHandler instanceof Closure) { $res[] = 'updateHandler'; } return $res; } /** * Cleanup memory and session file. * */ public function cleanup(): \Generator { $this->referenceDatabase = new ReferenceDatabase($this); yield from $this->referenceDatabase->init(); $callbacks = [$this]; if ($this->settings->getDb()->getEnableFileReferenceDb()) { $callbacks[] = $this->referenceDatabase; } if ($this->settings->getDb()->getEnableMinDb() && !($this->authorization['user']['bot'] ?? false)) { $callbacks[] = $this->minDatabase; } $this->TL->updateCallbacks($callbacks); } private function fillUsernamesCache(): \Generator { if (!$this->settings->getDb()->getEnableUsernameDb()) { yield $this->usernames->clear(); return; } if (!yield $this->usernames->count()) { $this->logger('Filling database cache. This can take few minutes.', Logger::WARNING); $iterator = $this->chats->getIterator(); while (yield $iterator->advance()) { [$id, $chat] = $iterator->getCurrent(); if (isset($chat['username'])) { $this->usernames[\strtolower($chat['username'])] = $id; } foreach ($chat['usernames'] ?? [] as ['username' => $username]) { $this->usernames[\strtolower($username)] = $id; } } $this->logger('Cache filled.', Logger::WARNING); } } /** * Logger. * * @param string $param Parameter * @param int $level Logging level * @param string $file File where the message originated * */ public function logger($param, int $level = Logger::NOTICE, string $file = ''): void { if ($file === null) { $file = \basename(\debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 1)[0]['file'], '.php'); } isset($this->logger) ? $this->logger->logger($param, $level, $file) : Logger::$default->logger($param, $level, $file); } /** * Get TL namespaces. * */ public function getMethodNamespaces(): array { return $this->TL->getMethodNamespaces(); } /** * Get namespaced methods (method => namespace). * */ public function getMethodsNamespaced(): array { return $this->TL->getMethodsNamespaced(); } /** * Get TL serializer. * */ public function getTL(): \danog\MadelineProto\TL\TL { return $this->TL; } /** * Get logger. */ public function getLogger(): Logger { return $this->logger; } /** * Get PSR logger. */ public function getPsrLogger(): LoggerInterface { return $this->logger->getPsrLogger(); } /** * Get async HTTP client. * */ public function getHTTPClient(): HttpClient { return $this->datacenter->getHTTPClient(); } /** * Get async DNS client. * */ public function getDNSClient(): Resolver { return $this->datacenter->getDNSClient(); } /** * Get contents of remote file asynchronously. * * @param string $url URL * * * @psalm-return \Generator, mixed, string> */ public function fileGetContents(string $url): \Generator { return $this->datacenter->fileGetContents($url); } /** * Get all datacenter connections. * * @return array */ public function getDataCenterConnections(): array { return $this->datacenter->getDataCenterConnections(); } /** * Get main DC ID. * * @return int|string */ public function getDataCenterId() { return $this->datacenter->curdc; } /** * Prompt serialization of instance. * * @internal * */ public function serialize(): void { if ($this->wrapper && $this->inited()) { $this->wrapper->serialize(); } } /** * Start all internal loops. * */ private function startLoops(): void { if (!$this->callCheckerLoop) { $this->callCheckerLoop = new PeriodicLoopInternal($this, [$this, 'checkCalls'], 'call check', 10 * 1000); } if (!$this->serializeLoop) { $this->serializeLoop = new PeriodicLoopInternal($this, [$this, 'serialize'], 'serialize', $this->settings->getSerialization()->getInterval() * 1000); } if (!$this->phoneConfigLoop) { $this->phoneConfigLoop = new PeriodicLoopInternal($this, [$this, 'getPhoneConfig'], 'phone config', 24 * 3600 * 1000); } if (!$this->configLoop) { $this->configLoop = new PeriodicLoopInternal($this, [$this, 'getConfig'], 'config', 24 * 3600 * 1000); } if (!$this->ipcServer) { try { $this->ipcServer = new Server($this); $this->ipcServer->setSettings($this->settings->getIpc()); $this->ipcServer->setIpcPath($this->wrapper->session); } catch (\Throwable $e) { $this->logger->logger("Error while starting IPC server: $e", Logger::FATAL_ERROR); } } $this->callCheckerLoop->start(); $this->serializeLoop->start(); $this->phoneConfigLoop->start(); $this->configLoop->start(); try { $this->ipcServer->start(); } catch (\Throwable $e) { if (Magic::$isIpcWorker) { throw $e; } $this->logger->logger("Error while starting IPC server: $e", Logger::FATAL_ERROR); } } /** * Stop all internal loops. * */ private function stopLoops(): void { if ($this->callCheckerLoop) { $this->callCheckerLoop->signal(true); $this->callCheckerLoop = null; } if ($this->serializeLoop) { $this->serializeLoop->signal(true); $this->serializeLoop = null; } if ($this->phoneConfigLoop) { $this->phoneConfigLoop->signal(true); $this->phoneConfigLoop = null; } if ($this->configLoop) { $this->configLoop->signal(true); $this->configLoop = null; } if ($this->ipcServer) { $this->ipcServer->signal(null); $this->ipcServer = null; } } /** * Clean up properties from previous versions of MadelineProto. * * @internal * * * @psalm-return \Generator */ private function cleanupProperties(): \Generator { if (!$this->channels_state instanceof CombinedUpdatesState) { $this->channels_state = new CombinedUpdatesState($this->channels_state); } if (isset($this->updates_state)) { if (!$this->updates_state instanceof UpdatesState) { $this->updates_state = new UpdatesState($this->updates_state); } $this->channels_state->__construct([UpdateLoop::GENERIC => $this->updates_state]); unset($this->updates_state); } if (!isset($this->datacenter)) { $this->datacenter ??= new DataCenter($this, $this->dcList, $this->settings->getConnection()); } if (!isset($this->snitch)) { $this->snitch = new Snitch; } $db = []; if (!isset($this->referenceDatabase)) { $this->referenceDatabase = new ReferenceDatabase($this); $db []= $this->referenceDatabase->init(); } else { $db []= $this->referenceDatabase->init(); } if (!isset($this->minDatabase)) { $this->minDatabase = new MinDatabase($this); $db []= $this->minDatabase->init(); } else { $db []= $this->minDatabase->init(); } if (!isset($this->TL)) { $this->TL = new TL($this); $callbacks = [$this, $this->referenceDatabase]; if (!($this->authorization['user']['bot'] ?? false)) { $callbacks[] = $this->minDatabase; } $this->TL->init($this->settings->getSchema(), $callbacks); } $db []= $this->initDb($this); yield Tools::all($db); yield from $this->fillUsernamesCache(); if (!$this->settings->getDb()->getEnableFullPeerDb()) { yield $this->full_chats->clear(); } if (!$this->settings->getDb()->getEnablePeerInfoDb()) { if (yield $this->chats->isset(0)) { return; } $this->logger("Cleaning up peer database..."); $k = 0; $total = yield $this->chats->count(); $iterator = $this->chats->getIterator(); while (yield $iterator->advance()) { [$key, $value] = $iterator->getCurrent(); $value = [ '_' => $value['_'], 'id' => $value['id'], 'access_hash' => $value['access_hash'] ?? null, 'min' => $value['min'] ?? false, ]; $k++; if ($k % 500 === 0 || $k === $total) { $this->logger("Cleaning up peer database ($k/$total)..."); yield $this->chats->set($key, $value); } else { $this->chats->set($key, $value); } } yield $this->chats->set(0, []); $this->logger("Cleaned up peer database!"); } elseif (yield $this->chats->isset(0)) { $this->chats->unset(0); } } /** * Upgrade MadelineProto instance. * * @throws Exception * @throws RPCErrorException * @throws \Throwable */ private function upgradeMadelineProto(): \Generator { if (!isset($this->snitch)) { $this->snitch = new Snitch; } $this->logger->logger(Lang::$current_lang['serialization_ofd'], Logger::WARNING); foreach ($this->datacenter->getDataCenterConnections() as $dc_id => $socket) { if ($this->authorized === self::LOGGED_IN && \strpos($dc_id, '_') === false && $socket->hasPermAuthKey() && $socket->hasTempAuthKey()) { $socket->bind(); $socket->authorized(true); } } $this->settings->setSchema(new TLSchema); yield from $this->initDb($this); if (!isset($this->secret_chats)) { $this->secret_chats = []; } $iterator = $this->full_chats->getIterator(); while (yield $iterator->advance()) { [$id, $full] = $iterator->getCurrent(); if (isset($full['full'], $full['last_update'])) { yield $this->full_chats->set($id, ['full' => $full['full'], 'last_update' => $full['last_update']]); } } if (isset($this->channel_participants)) { if (\is_array($this->channel_participants)) { foreach ($this->channel_participants as $channelId => $filters) { foreach ($filters as $filter => $qs) { foreach ($qs as $q => $offsets) { foreach ($offsets as $offset => $limits) { foreach ($limits as $limit => $data) { $this->channelParticipants[$this->participantsKey($channelId, $filter, $q, $offset, $limit)] = $data; } } } } unset($this->channel_participants[$channelId]); } } else { self::$dbProperties['channel_participants'] = 'array'; yield from $this->initDb($this); $iterator = $this->channel_participants->getIterator(); while (yield $iterator->advance()) { [$channelId, $filters] = $iterator->getCurrent(); foreach ($filters as $filter => $qs) { foreach ($qs as $q => $offsets) { foreach ($offsets as $offset => $limits) { foreach ($limits as $limit => $data) { $this->channelParticipants[$this->participantsKey($channelId, $filter, $q, $offset, $limit)] = $data; } } } } unset($this->channel_participants[$channelId]); } } } foreach ($this->secret_chats as $key => &$chat) { if (!\is_array($chat)) { unset($this->secret_chats[$key]); continue; } if ($chat['layer'] >= 73) { $chat['mtproto'] = 2; } else { $chat['mtproto'] = 1; } } unset($chat); $this->resetMTProtoSession(true, true); $this->config = ['expires' => -1]; $this->dh_config = ['version' => 0]; yield from $this->__construct_async($this->settings); foreach ($this->secret_chats as $chat => $data) { try { if (isset($this->secret_chats[$chat]) && $this->secret_chats[$chat]['InputEncryptedChat'] !== null) { yield from $this->notifyLayer($chat); } } catch (\danog\MadelineProto\RPCErrorException $e) { } } } /** * Post-deserialization initialization function. * * @param Settings|SettingsEmpty $settings New settings * @param APIWrapper $wrapper API wrapper * * @internal * */ public function wakeup(SettingsAbstract $settings, APIWrapper $wrapper): \Generator { // Set reference to itself self::$references[\spl_object_hash($this)] = $this; // Set API wrapper $this->wrapper = $wrapper; // BC stuff if ($this->authorized === true) { $this->authorized = self::LOGGED_IN; } if (!isset($this->snitch)) { $this->snitch = new Snitch; } // Convert old array settings to new settings object if (\is_array($this->settings)) { if (($this->settings['updates']['callback'] ?? '') === 'getUpdatesUpdateHandler') { /** @psalm-suppress InvalidPropertyAssignmentValue */ $this->settings['updates']['callback'] = [$this, 'getUpdatesUpdateHandler']; } if (\is_callable($this->settings['updates']['callback'] ?? null)) { $this->updateHandler = $this->settings['updates']['callback']; } /** @psalm-suppress InvalidArrayOffset */ $this->dcList = $this->settings['connection'] ?? $this->dcList; } $this->settings = Settings::parseFromLegacy($this->settings); // Clean up phone call array foreach ($this->calls as $id => $controller) { if (!\is_object($controller)) { unset($this->calls[$id]); } elseif ($controller->getCallState() === VoIP::CALL_STATE_ENDED) { $controller->setMadeline($this); $controller->discard(); } else { $controller->setMadeline($this); } } $this->forceInit(false); $this->setInitPromise($this->wakeupAsync($settings)); return $this->initAsynchronously(); } /** * Async wakeup function. * * @param Settings|SettingsEmpty $settings New settings * */ private function wakeupAsync(SettingsAbstract $settings): \Generator { // Setup one-time stuffs Magic::start(); $this->settings->getConnection()->init(); // Setup logger $this->setupLogger(); // Setup language Lang::$current_lang =& Lang::$lang['en']; if (Lang::$lang[$this->settings->getAppInfo()->getLangCode()] ?? false) { Lang::$current_lang =& Lang::$lang[$this->settings->getAppInfo()->getLangCode()]; } // Reset MTProto session (not related to user session) $this->resetMTProtoSession(); // Update settings from constructor $this->updateSettingsInternal($settings); // Session update process for BC $forceDialogs = false; if (!isset($this->v) || $this->v !== self::V || $this->settings->getSchema()->needsUpgrade()) { yield from $this->upgradeMadelineProto(); $forceDialogs = true; } // Cleanup old properties, init new stuffs yield from $this->cleanupProperties(); // Update TL callbacks $callbacks = [$this]; if ($this->settings->getDb()->getEnableFileReferenceDb()) { $callbacks[] = $this->referenceDatabase; } if ($this->settings->getDb()->getEnableMinDb() && !($this->authorization['user']['bot'] ?? false)) { $callbacks[] = $this->minDatabase; } // Connect to all DCs, start internal loops yield from $this->connectToAllDcs(); if (yield from $this->fullGetSelf()) { $this->authorized = self::LOGGED_IN; $this->setupLogger(); $this->startLoops(); yield from $this->getCdnConfig($this->datacenter->curdc); yield from $this->initAuthorization(); } else { $this->startLoops(); } // onStart event handler if ($this->event_handler && \class_exists($this->event_handler) && \is_subclass_of($this->event_handler, EventHandler::class)) { yield from $this->setEventHandler($this->event_handler); } else { if ($this->updateHandler === [$this, 'eventUpdateHandler']) { $this->setNoop(); } $this->event_handler = null; $this->event_handler_instance = null; } $this->startUpdateSystem(true); if ($this->authorized === self::LOGGED_IN && !$this->authorization['user']['bot'] && $this->settings->getPeer()->getCacheAllPeersOnStartup()) { yield from $this->getDialogs($forceDialogs); } if ($this->authorized === self::LOGGED_IN) { $this->logger->logger(Lang::$current_lang['getupdates_deserialization'], Logger::NOTICE); yield $this->updaters[UpdateLoop::GENERIC]->resume(); } $this->updaters[UpdateLoop::GENERIC]->start(); GarbageCollector::start(); } /** * Unreference instance, allowing destruction. * * @internal * */ public function unreference(): void { if (!isset($this->logger)) { $this->logger = new Logger(new \danog\MadelineProto\Settings\Logger); } $this->logger->logger("Will unreference instance"); if (isset(self::$references[\spl_object_hash($this)])) { unset(self::$references[\spl_object_hash($this)]); } $this->stopLoops(); if (isset($this->seqUpdater)) { $this->seqUpdater->signal(true); } if (isset($this->channels_state)) { $channelIds = []; foreach ($this->channels_state->get() as $state) { $channelIds[] = $state->getChannel(); } \sort($channelIds); foreach ($channelIds as $channelId) { if (isset($this->feeders[$channelId])) { $this->feeders[$channelId]->signal(true); } if (isset($this->updaters[$channelId])) { $this->updaters[$channelId]->signal(true); } } } if (isset($this->datacenter)) { foreach ($this->datacenter->getDataCenterConnections() as $datacenter) { $datacenter->setExtra($this); $datacenter->disconnect(); } } $this->logger->logger("Unreferenced instance"); } /** * Destructor. */ public function __destruct() { $this->logger('Shutting down MadelineProto (MTProto)'); $this->unreference(); $this->logger("Successfully destroyed MadelineProto"); } /** * Restart IPC server instance. * * @internal */ public function restartIpcServer(): Promise { return new Success(); // Can only be called from client } /** * Whether we're an IPC client instance. * * @return boolean */ public function isIpc(): bool { return false; } /** * Whether we're an IPC server process (as opposed to an event handler). * * @return boolean */ public function isIpcWorker(): bool { return Magic::$isIpcWorker; } /** * Parse, update and store settings. * * @param SettingsAbstract $settings Settings * */ public function updateSettings(SettingsAbstract $settings): \Generator { $this->updateSettingsInternal($settings); if ($this->settings->getDb()->hasChanged()) { yield from $this->initDb($this); $this->settings->getDb()->applyChanges(); } if ($this->settings->getIpc()->hasChanged()) { $this->ipcServer->setSettings($this->settings->getIpc()->applyChanges()); } if ($this->settings->getSerialization()->hasChanged()) { $this->serializeLoop->signal(true); $this->serializeLoop = new PeriodicLoopInternal($this, [$this, 'serialize'], 'serialize', $this->settings->getSerialization()->applyChanges()->getInterval() * 1000); } if ($this->settings->getAuth()->hasChanged() || $this->settings->getConnection()->hasChanged() || $this->settings->getSchema()->hasChanged() || $this->settings->getSchema()->needsUpgrade()) { yield from $this->__construct_async($this->settings); } } /** * Parse, update and store settings. * * @param SettingsAbstract $settings Settings * */ private function updateSettingsInternal(SettingsAbstract $settings): void { if ($settings instanceof SettingsEmpty) { if (!isset($this->settings)) { $this->settings = new Settings; } else { return; } } else { if (!isset($this->settings)) { if ($settings instanceof Settings) { $this->settings = $settings; } else { $this->settings = new Settings; $this->settings->merge($settings); } } else { $this->settings->merge($settings); } } if (!$this->settings->getAppInfo()->hasApiInfo()) { throw new \danog\MadelineProto\Exception(Lang::$current_lang['api_not_set'], 0, null, 'MadelineProto', 1); } // Setup logger if ($this->settings->getLogger()->hasChanged() || !$this->logger) { $this->setupLogger(); } } /** * Return current settings. * */ public function getSettings(): Settings { return $this->settings; } /** * Setup logger. * */ public function setupLogger(): void { $this->logger = new Logger( $this->settings->getLogger(), $this->authorization['user']['username'] ?? $this->authorization['user']['id'] ?? '' ); } /** * Reset all MTProto sessions. * * @param boolean $de Whether to reset the session ID * @param boolean $auth_key Whether to reset the auth key * * @internal * */ public function resetMTProtoSession(bool $de = true, bool $auth_key = false): void { if (!\is_object($this->datacenter)) { throw new Exception(Lang::$current_lang['session_corrupted']); } foreach ($this->datacenter->getDataCenterConnections() as $id => $socket) { if ($de) { $socket->resetSession(); } if ($auth_key) { $socket->setAuthKey(null); } } } /** * Check if connected to datacenter using HTTP. * * @param string $datacenter DC ID * * @internal * * @return boolean */ public function isHttp(string $datacenter): bool { return $this->datacenter->isHttp($datacenter); } /** * Checks whether all datacenters are authorized. * * @return boolean */ public function hasAllAuth(): bool { if ($this->isInitingAuthorization()) { $this->logger("Initing auth"); return false; } foreach ($this->datacenter->getDataCenterConnections() as $id => $dc) { if ((!$dc->isAuthorized() || !$dc->hasTempAuthKey()) && !$dc->isCDN()) { $this->logger("Initing auth $id"); return false; } } return true; } /** * Whether we're initing authorization. * * @internal * * @return boolean */ public function isInitingAuthorization() { return $this->initing_authorization; } /** * Connects to all datacenters and if necessary creates authorization keys, binds them and writes client info. * * @param boolean $reconnectAll Whether to reconnect to all DCs * */ public function connectToAllDcs(bool $reconnectAll = true): \Generator { $this->channels_state->get(FeedLoop::GENERIC); foreach ($this->channels_state->get() as $state) { $channelId = $state->getChannel(); if (!isset($this->feeders[$channelId])) { $this->feeders[$channelId] = new FeedLoop($this, $channelId); } if (!isset($this->updaters[$channelId])) { $this->updaters[$channelId] = new UpdateLoop($this, $channelId); } } if (!isset($this->seqUpdater)) { $this->seqUpdater = new SeqLoop($this); } $this->datacenter->__construct($this, $this->dcList, $this->settings->getConnection(), $reconnectAll); $dcs = []; foreach ($this->datacenter->getDcs() as $new_dc) { $dcs[] = $this->datacenter->dcConnect($new_dc); } yield \danog\MadelineProto\Tools::all($dcs); yield from $this->initAuthorization(); yield from $this->parseConfig(); $dcs = []; foreach ($this->datacenter->getDcs(false) as $new_dc) { $dcs[] = $this->datacenter->dcConnect($new_dc); } yield \danog\MadelineProto\Tools::all($dcs); yield from $this->initAuthorization(); yield from $this->parseConfig(); yield from $this->getPhoneConfig(); } /** * Clean up MadelineProto session after logout. * * @internal * * @return \Generator */ public function resetSession(): \Generator { if (isset($this->seqUpdater)) { $this->seqUpdater->signal(true); unset($this->seqUpdater); } $channelIds = []; foreach ($this->channels_state->get() as $state) { $channelIds[] = $state->getChannel(); } \sort($channelIds); foreach ($channelIds as $channelId) { if (isset($this->feeders[$channelId])) { $this->feeders[$channelId]->signal(true); unset($this->feeders[$channelId]); } if (isset($this->updaters[$channelId])) { $this->updaters[$channelId]->signal(true); unset($this->updaters[$channelId]); } } foreach ($this->datacenter->getDataCenterConnections() as $socket) { $socket->authorized(false); } $this->channels_state = new CombinedUpdatesState(); $this->got_state = false; $this->msg_ids = []; $this->authorized = self::NOT_LOGGED_IN; $this->authorized_dc = -1; $this->authorization = null; $this->updates = []; $this->secret_chats = []; yield from $this->initDb($this, true); $this->tos = ['expires' => 0, 'accepted' => true]; $this->dialog_params = ['_' => 'MadelineProto.dialogParams', 'limit' => 0, 'offset_date' => 0, 'offset_id' => 0, 'offset_peer' => ['_' => 'inputPeerEmpty'], 'count' => 0]; $this->referenceDatabase = new ReferenceDatabase($this); yield from $this->referenceDatabase->init(); $this->minDatabase = new MinDatabase($this); yield from $this->minDatabase->init(); } /** * Reset the update state and fetch all updates from the beginning. * */ public function resetUpdateState(): void { if (isset($this->seqUpdater)) { $this->seqUpdater->signal(true); } $channelIds = []; $newStates = []; foreach ($this->channels_state->get() as $state) { $channelIds[] = $state->getChannel(); $channelId = $state->getChannel(); $pts = $state->pts(); $pts = $channelId ? \max(1, $pts - 1000000) : ($pts > 4000000 ? $pts - 1000000 : \max(1, $pts - 1000000)); $newStates[$channelId] = new UpdatesState(['pts' => $pts], $channelId); } \sort($channelIds); foreach ($channelIds as $channelId) { if (isset($this->feeders[$channelId])) { $this->feeders[$channelId]->signal(true); } if (isset($this->updaters[$channelId])) { $this->updaters[$channelId]->signal(true); } } $this->channels_state->__construct($newStates); $this->startUpdateSystem(); } /** * Start the update system. * * @param boolean $anyway Force start update system? * * @internal * */ public function startUpdateSystem($anyway = false): void { if (!$this->inited() && !$anyway) { $this->logger("Not starting update system"); return; } $this->logger("Starting update system"); foreach ($this->secret_chats as $id => $chat) { if (!isset($this->secretFeeders[$id])) { $this->secretFeeders[$id] = new SecretFeedLoop($this, $id); } $this->secretFeeders[$id]->start(); if (isset($this->secretFeeders[$id])) { $this->secretFeeders[$id]->resume(); } } if (!isset($this->seqUpdater)) { $this->seqUpdater = new SeqLoop($this); } $this->channels_state->get(FeedLoop::GENERIC); $channelIds = []; foreach ($this->channels_state->get() as $state) { $channelIds[] = $state->getChannel(); } \sort($channelIds); foreach ($channelIds as $channelId) { if (!isset($this->feeders[$channelId])) { $this->feeders[$channelId] = new FeedLoop($this, $channelId); } if (!isset($this->updaters[$channelId])) { $this->updaters[$channelId] = new UpdateLoop($this, $channelId); } $this->feeders[$channelId]->start(); if (isset($this->feeders[$channelId])) { $this->feeders[$channelId]->resume(); } $this->updaters[$channelId]->start(); if (isset($this->updaters[$channelId])) { $this->updaters[$channelId]->resume(); } } $this->flushAll(); $this->seqUpdater->start(); $this->seqUpdater->resume(); } /** * Flush all datacenter connections. * */ private function flushAll(): void { foreach ($this->datacenter->getDataCenterConnections() as $datacenter) { $datacenter->flush(); } } /** * Store shared phone config. * * @param mixed $watcherId Watcher ID * * @internal * * @return \Generator */ public function getPhoneConfig($watcherId = null): \Generator { if ($this->authorized === self::LOGGED_IN && \class_exists(VoIPServerConfigInternal::class) && !$this->authorization['user']['bot'] && $this->datacenter->getDataCenterConnection($this->settings->getDefaultDc())->hasTempAuthKey()) { $this->logger->logger('Fetching phone config...'); VoIPServerConfig::updateDefault(yield from $this->methodCallAsyncRead('phone.getCallConfig', [], $this->settings->getDefaultDcParams())); } } /** * Store RSA keys for CDN datacenters. * * @param string $datacenter DC ID * */ public function getCdnConfig(string $datacenter): \Generator { try { foreach ((yield from $this->methodCallAsyncRead('help.getCdnConfig', [], ['datacenter' => $datacenter]))['public_keys'] as $curkey) { $curkey = yield from RSA::load($this->TL, $curkey['public_key']); $this->cdn_rsa_keys[$curkey->fp] = $curkey; } } catch (\danog\MadelineProto\TL\Exception $e) { $this->logger->logger($e->getMessage(), \danog\MadelineProto\Logger::FATAL_ERROR); } } /** * Get cached server-side config. * */ public function getCachedConfig(): array { return $this->config; } /** * Get cached (or eventually re-fetch) server-side config. * * @param array $config Current config * @param array $options Options for method call * */ public function getConfig(array $config = [], array $options = []): \Generator { if ($this->config['expires'] > \time()) { return $this->config; } $this->config = empty($config) ? yield from $this->methodCallAsyncRead('help.getConfig', $config, $options ?: $this->settings->getDefaultDcParams()) : $config; yield from $this->parseConfig(); $this->logger->logger(Lang::$current_lang['config_updated'], Logger::NOTICE); $this->logger->logger($this->config, Logger::NOTICE); return $this->config; } /** * @internal */ public function addConfig(array $config): void { $this->config = $config; } /** * Parse cached config. * */ private function parseConfig(): \Generator { if (isset($this->config['dc_options'])) { $options = $this->config['dc_options']; unset($this->config['dc_options']); yield from $this->parseDcOptions($options); } } /** * Parse DC options from config. * * @param array $dc_options DC options * */ private function parseDcOptions(array $dc_options): \Generator { $previous = $this->dcList; foreach ($dc_options as $dc) { $test = $this->config['test_mode'] ? 'test' : 'main'; $id = $dc['id']; if ($dc['static']) { continue; } if ($dc['cdn']) { $id .= '_cdn'; } $id .= $dc['media_only'] ? '_media' : ''; $ipv6 = $dc['ipv6'] ? 'ipv6' : 'ipv4'; if (\is_numeric($id)) { $id = (int) $id; } unset($dc['cdn'], $dc['media_only'], $dc['id'], $dc['ipv6']); $this->dcList[$test][$ipv6][$id] = $dc; } $curdc = $this->datacenter->curdc; if ($previous !== $this->dcList && (!$this->datacenter->has($curdc) || $this->datacenter->getDataCenterConnection($curdc)->byIPAddress())) { $this->logger->logger('Got new DC options, reconnecting'); yield from $this->connectToAllDcs(false); } $this->datacenter->curdc = $curdc; } /** * Get info about the logged-in user, cached. * * Use fullGetSelf to bypass the cache. * */ public function getSelf(): array|false { return $this->authorization['user'] ?? false; } /** * Returns whether the current user is a premium user, cached. */ public function isPremium(): bool { return $this->getSelf()['premium']; } /** * Get info about the logged-in user, not cached. * * @return \Generator */ public function fullGetSelf(): \Generator { try { $this->authorization = ['user' => (yield from $this->methodCallAsyncRead('users.getUsers', ['id' => [['_' => 'inputUserSelf']]]))[0]]; } catch (RPCErrorException $e) { $this->logger->logger($e->getMessage()); return false; } return $this->authorization['user']; } /** * Get authorization info. * */ public function getAuthorization(): int { return $this->authorized; } /** * Get current password hint. * */ public function getHint(): string { if ($this->authorized !== self::WAITING_PASSWORD) { throw new Exception("Not waiting for the password!"); } return $this->authorization['hint']; } /** * IDs of peers where to report errors. * * @var int[] */ private $reportDest = []; /** * Check if has report peers. * * @return boolean */ public function hasReportPeers(): bool { return (bool) $this->reportDest; } /** * Get a message to show to the user when starting the bot. * */ public function getWebMessage(string $message): string { Logger::log($message); $warning = ''; if (!$this->hasReportPeers() && $this->hasEventHandler()) { Logger::log("!!! Warning: no report peers are set, please add the following method to your event handler !!!", Logger::FATAL_ERROR); Logger::log("!!! public function getReportPeers() { return '@yourtelegramusername'; } !!!", Logger::FATAL_ERROR); $warning .= "

Warning: no report peers are set, please add the following method to your event handler:

"; $warning .= "public function getReportPeers() { return '@yourtelegramusername'; }"; } if (!Magic::$hasOpenssl) { $warning .= "

Warning: the openssl extension is not installed, please install it to speed up MadelineProto

"; } return "

$message

$warning"; } /** * Set peer(s) where to send errors occurred in the event loop. * * @param int|string $userOrId Username(s) or peer ID(s) * */ public function setReportPeers($userOrId): \Generator { if (!(\is_array($userOrId) && !isset($userOrId['_']) && !isset($userOrId['id']))) { $userOrId = [$userOrId]; } foreach ($userOrId as $k => &$peer) { try { $peer = (yield from $this->getInfo($peer))['bot_api_id']; if ($peer === 101374607) { unset($userOrId[$k]); } } catch (\Throwable $e) { unset($userOrId[$k]); $this->logger("Could not obtain info about report peer $peer: $e", Logger::FATAL_ERROR); } } /** @var int[] $userOrId */ $this->reportDest = $userOrId; } /** * Report an error to the previously set peer. * * @param string $message Error to report * @param string $parseMode Parse mode * */ public function report(string $message, string $parseMode = ''): \Generator { if (!$this->reportDest) { return; } $file = null; if ($this->settings->getLogger()->getType() === Logger::FILE_LOGGER && $path = $this->settings->getLogger()->getExtra()) { yield touchAsync($path); if (!yield getSize($path)) { $message = "!!! WARNING !!!\nThe logfile is empty, please DO NOT delete the logfile to avoid errors in MadelineProto!\n\n$message"; } else { $file = yield from $this->methodCallAsyncRead( 'messages.uploadMedia', [ 'peer' => $this->reportDest[0], 'media' => [ '_' => 'inputMediaUploadedDocument', 'file' => $path, 'attributes' => [ ['_' => 'documentAttributeFilename', 'file_name' => 'MadelineProto.log'] ] ] ] ); } } $sent = true; foreach ($this->reportDest as $id) { try { yield from $this->methodCallAsyncRead('messages.sendMessage', ['peer' => $id, 'message' => $message, 'parse_mode' => $parseMode]); if ($file) { yield from $this->methodCallAsyncRead('messages.sendMedia', ['peer' => $id, 'media' => $file]); } $sent &= true; } catch (\Throwable $e) { $sent &= false; $this->logger("While reporting to $id: $e", Logger::FATAL_ERROR); } } if ($sent && $file) { \ftruncate($this->logger->stdout->getResource(), 0); $this->logger->logger("Reported!"); } } /** * Get full list of MTProto and API methods. * */ public function getAllMethods(): array { $methods = []; foreach ($this->getTL()->getMethods()->by_id as $method) { $methods[] = $method['method']; } return \array_merge($methods, \get_class_methods(InternalDoc::class)); } /** * Called right before serialization of method starts. * * Pass the method name * */ public function getMethodCallbacks(): array { return []; } /** * Called right before serialization of method starts. * * Pass the method name * */ public function getMethodBeforeCallbacks(): array { return []; } /** * Called right after deserialization of object, passing the final object. * */ public function getConstructorCallbacks(): array { return \array_merge( \array_fill_keys(['chat', 'chatEmpty', 'chatForbidden', 'channel', 'channelEmpty', 'channelForbidden'], [[$this, 'addChat']]), \array_fill_keys(['user', 'userEmpty'], [[$this, 'addUser']]), \array_fill_keys(['chatFull', 'channelFull', 'userFull'], [[$this, 'addFullChat']]), ['help.support' => [[$this, 'addSupport']]], ['config' => [[$this, 'addConfig']]] ); } /** * Called right before deserialization of object. * * Pass only the constructor name * */ public function getConstructorBeforeCallbacks(): array { return []; } /** * Called right before serialization of constructor. * * Passed the object, will return a modified version. * */ public function getConstructorSerializeCallbacks(): array { return []; } /** * Called if objects of the specified type cannot be serialized. * * Passed the unserializable object, * will try to convert it to an object of the proper type. * */ public function getTypeMismatchCallbacks(): array { return \array_merge( \array_fill_keys( [ 'InputPeer', ], [$this, 'getInputPeer'] ), \array_fill_keys( [ 'InputUser', 'InputChannel', ], [$this, 'getInputConstructor'] ), \array_fill_keys( [ 'User', 'Chat', 'Peer', 'InputDialogPeer', 'InputNotifyPeer' ], [$this, 'getInfo'] ), \array_fill_keys( [ 'InputMedia', 'InputDocument', 'InputPhoto' ], [$this, 'getFileInfo'] ), \array_fill_keys( ['InputFileLocation'], [$this, 'getDownloadInfo'] ) ); } /** * Get debug information for var_dump. * */ public function __debugInfo(): array { $vars = \get_object_vars($this); unset($vars['full_chats'], $vars['chats'], $vars['referenceDatabase'], $vars['minDatabase'], $vars['TL']); return $vars; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\CancellationToken; use Amp\MultiReasonException; use Amp\NullCancellationToken; use Amp\Promise; use Amp\Socket\ConnectContext; use Amp\Socket\Connector; class ContextConnector implements Connector { private $dataCenter; private $logger; private $fromDns = false; public function __construct(DataCenter $dataCenter, bool $fromDns = false) { $this->dataCenter = $dataCenter; $this->fromDns = $fromDns; $this->logger = $dataCenter->getAPI()->getLogger(); } public function connect(string $uri, ?ConnectContext $context = null, ?CancellationToken $token = null): Promise { return Tools::call((function () use ($uri, $context, $token): \Generator { $ctx = $context ?? new ConnectContext(); $token = $token ?? new NullCancellationToken(); $ctxs = $this->dataCenter->generateContexts(0, $uri, $ctx); if (empty($ctxs)) { throw new Exception("No contexts for raw connection to URI {$uri}"); } foreach ($ctxs as $ctx) { /* @var $ctx \danog\MadelineProto\Stream\ConnectionContext */ try { $ctx->setIsDns($this->fromDns); $ctx->setCancellationToken($token); $result = (yield from $ctx->getStream()); $this->logger->logger('OK!', \danog\MadelineProto\Logger::WARNING); return $result->getSocket(); } catch (\Throwable $e) { if (\defined('MADELINEPROTO_TEST') && \constant("MADELINEPROTO_TEST") === 'pony') { throw $e; } $this->logger->logger('Connection failed: '.$e, \danog\MadelineProto\Logger::ERROR); if ($e instanceof MultiReasonException) { foreach ($e->getReasons() as $reason) { $this->logger->logger('Multireason: '.$reason, \danog\MadelineProto\Logger::ERROR); } } } } throw new \danog\MadelineProto\Exception("Could not connect to URI {$uri}"); })()); } } exportAuthorization() instead, see https://docs.madelineproto.xyz/docs/LOGIN.html. * * Parameters: * * `int` **dc_id** - Number of a target data-center * * @param array $params Parameters * * @return auth.ExportedAuthorization */ public function exportAuthorization($params); /** * You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html. * * Parameters: * * `long` **id** - User ID * * `bytes` **bytes** - Authorization key * * @param array $params Parameters * * @return auth.Authorization */ public function importAuthorization($params); /** * You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info. * * Parameters: * * `long` **perm_auth_key_id** - Permanent auth\_key\_id to bind to * * `long` **nonce** - Random long from [Binding message contents](#binding-message-contents) * * `int` **expires_at** - Unix timestamp to invalidate temporary key, see [Binding message contents](#binding-message-contents) * * `bytes` **encrypted_message** - See [Generating encrypted\_message](#generating-encrypted-message) * * @param array $params Parameters * * @return bool */ public function bindTempAuthKey($params); /** * You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info). * * Parameters: * * `int` **api_id** - Application identifier (see. [App configuration](https://core.telegram.org/myapp)) * * `string` **api_hash** - Application identifier hash (see. [App configuration](https://core.telegram.org/myapp)) * * `string` **bot_auth_token** - Bot token (see [bots](https://core.telegram.org/bots)) * * @param array $params Parameters * * @return auth.Authorization */ public function importBotAuthorization($params); /** * You cannot use this method directly, use the complete2falogin method instead (see https://docs.madelineproto.xyz for more info). * * Parameters: * * `InputCheckPasswordSRP` **password** - The account's password (see [SRP](https://core.telegram.org/api/srp)) * * @param array $params Parameters * * @return auth.Authorization */ public function checkPassword($params); /** * Request recovery code of a [2FA password](https://core.telegram.org/api/srp), only for accounts with a [recovery email configured](https://core.telegram.org/api/srp#email-verification). * * @return auth.PasswordRecovery */ public function requestPasswordRecovery(); /** * Reset the [2FA password](https://core.telegram.org/api/srp) using the recovery code sent using [auth.requestPasswordRecovery](https://docs.madelineproto.xyz/API_docs/methods/auth.requestPasswordRecovery.html). * * Parameters: * * `string` **code** - Code received via email * * `account.PasswordInputSettings` **new_settings** - Optional: New password * * @param array $params Parameters * * @return auth.Authorization */ public function recoverPassword($params); /** * Resend the login code via another medium, the phone code type is determined by the return value of the previous auth.sendCode/auth.resendCode: see [login](https://core.telegram.org/api/auth) for more info. * * Parameters: * * `string` **phone_number** - The phone number * * `string` **phone_code_hash** - The phone code hash obtained from [auth.sendCode](https://docs.madelineproto.xyz/API_docs/methods/auth.sendCode.html) * * @param array $params Parameters * * @return auth.SentCode */ public function resendCode($params); /** * Cancel the login verification code. * * Parameters: * * `string` **phone_number** - Phone number * * `string` **phone_code_hash** - Phone code hash from [auth.sendCode](https://docs.madelineproto.xyz/API_docs/methods/auth.sendCode.html) * * @param array $params Parameters * * @return bool */ public function cancelCode($params); /** * Delete all temporary authorization keys **except for** the ones specified. * * Parameters: * * `[long]` **except_auth_keys** - The auth keys that **shouldn't** be dropped. * * @param array $params Parameters * * @return bool */ public function dropTempAuthKeys($params); /** * Generate a login token, for [login via QR code](https://core.telegram.org/api/qr-login). * The generated login token should be encoded using base64url, then shown as a `tg://login?token=base64encodedtoken` [deep link »](https://core.telegram.org/api/links#qr-code-login-links) in the QR code. * * For more info, see [login via QR code](https://core.telegram.org/api/qr-login). * * Parameters: * * `int` **api_id** - Application identifier (see. [App configuration](https://core.telegram.org/myapp)) * * `string` **api_hash** - Application identifier hash (see. [App configuration](https://core.telegram.org/myapp)) * * `[long]` **except_ids** - List of already logged-in user IDs, to prevent logging in twice with the same user * * @param array $params Parameters * * @return auth.LoginToken */ public function exportLoginToken($params); /** * Login using a redirected login token, generated in case of DC mismatch during [QR code login](https://core.telegram.org/api/qr-login). * * For more info, see [login via QR code](https://core.telegram.org/api/qr-login). * * Parameters: * * `bytes` **token** - Login token * * @param array $params Parameters * * @return auth.LoginToken */ public function importLoginToken($params); /** * Accept QR code login token, logging in the app that generated it. * * Returns info about the new session. * * For more info, see [login via QR code](https://core.telegram.org/api/qr-login). * * Parameters: * * `bytes` **token** - Login token embedded in QR code, for more info, see [login via QR code](https://core.telegram.org/api/qr-login). * * @param array $params Parameters * * @return Authorization */ public function acceptLoginToken($params); /** * Check if the [2FA recovery code](https://core.telegram.org/api/srp) sent using [auth.requestPasswordRecovery](https://docs.madelineproto.xyz/API_docs/methods/auth.requestPasswordRecovery.html) is valid, before passing it to [auth.recoverPassword](https://docs.madelineproto.xyz/API_docs/methods/auth.recoverPassword.html). * * Parameters: * * `string` **code** - Code received via email * * @param array $params Parameters * * @return bool */ public function checkRecoveryPassword($params); /** * * * Parameters: * * `int` **api_id** - * * `string` **api_hash** - * * `string` **web_auth_token** -. * * @param array $params Parameters * * @return auth.Authorization */ public function importWebTokenAuthorization($params); } interface account { /** * Register device to receive [PUSH notifications](https://core.telegram.org/api/push-updates). * * Parameters: * * `boolean` **no_muted** - Optional: Avoid receiving (silent and invisible background) notifications. Useful to save battery. * * `int` **token_type** - Device token type.
**Possible values**:
`1` \- APNS (device token for apple push)
`2` \- FCM (firebase token for google firebase)
`3` \- MPNS (channel URI for microsoft push)
`4` \- Simple push (endpoint for firefox's simple push API)
`5` \- Ubuntu phone (token for ubuntu push)
`6` \- Blackberry (token for blackberry push)
`7` \- Unused
`8` \- WNS (windows push)
`9` \- APNS VoIP (token for apple push VoIP)
`10` \- Web push (web push, see below)
`11` \- MPNS VoIP (token for microsoft push VoIP)
`12` \- Tizen (token for tizen push)

For `10` web push, the token must be a JSON-encoded object containing the keys described in [PUSH updates](https://core.telegram.org/api/push-updates) * * `string` **token** - Device token * * `Bool` **app_sandbox** - If [(boolTrue)](https://docs.madelineproto.xyz/API_docs/constructors/boolTrue.html) is transmitted, a sandbox-certificate will be used during transmission. * * `bytes` **secret** - For FCM and APNS VoIP, optional encryption key used to encrypt push notifications * * `[long]` **other_uids** - List of user identifiers of other users currently using the client * * @param array $params Parameters * * @return bool */ public function registerDevice($params); /** * Deletes a device by its token, stops sending PUSH-notifications to it. * * Parameters: * * `int` **token_type** - Device token type.
**Possible values**:
`1` \- APNS (device token for apple push)
`2` \- FCM (firebase token for google firebase)
`3` \- MPNS (channel URI for microsoft push)
`4` \- Simple push (endpoint for firefox's simple push API)
`5` \- Ubuntu phone (token for ubuntu push)
`6` \- Blackberry (token for blackberry push)
`7` \- Unused
`8` \- WNS (windows push)
`9` \- APNS VoIP (token for apple push VoIP)
`10` \- Web push (web push, see below)
`11` \- MPNS VoIP (token for microsoft push VoIP)
`12` \- Tizen (token for tizen push)

For `10` web push, the token must be a JSON-encoded object containing the keys described in [PUSH updates](https://core.telegram.org/api/push-updates) * * `string` **token** - Device token * * `[long]` **other_uids** - List of user identifiers of other users currently using the client * * @param array $params Parameters * * @return bool */ public function unregisterDevice($params); /** * Edits notification settings from a given user/group, from all users/all groups. * * Parameters: * * `InputNotifyPeer` **peer** - Notification source * * `InputPeerNotifySettings` **settings** - Notification settings * * @param array $params Parameters * * @return bool */ public function updateNotifySettings($params); /** * Gets current notification settings for a given user/group, from all users/all groups. * * Parameters: * * `InputNotifyPeer` **peer** - Notification source * * @param array $params Parameters * * @return PeerNotifySettings */ public function getNotifySettings($params); /** * Resets all notification settings from users and groups. * * @return bool */ public function resetNotifySettings(); /** * Updates user profile. * * Parameters: * * `string` **first_name** - Optional: New user first name * * `string` **last_name** - Optional: New user last name * * `string` **about** - Optional: New bio * * @param array $params Parameters * * @return User */ public function updateProfile($params); /** * Updates online user status. * * Parameters: * * `Bool` **offline** - If [(boolTrue)](https://docs.madelineproto.xyz/API_docs/constructors/boolTrue.html) is transmitted, user status will change to [(userStatusOffline)](https://docs.madelineproto.xyz/API_docs/constructors/userStatusOffline.html). * * @param array $params Parameters * * @return bool */ public function updateStatus($params); /** * Returns a list of available [wallpapers](https://core.telegram.org/api/wallpapers). * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return account.WallPapers */ public function getWallPapers($params); /** * Report a peer for violation of telegram's Terms of Service. * * Parameters: * * `InputPeer` **peer** - The peer to report * * `ReportReason` **reason** - The reason why this peer is being reported * * `string` **message** - Comment for report moderation * * @param array $params Parameters * * @return bool */ public function reportPeer($params); /** * Validates a username and checks availability. * * Parameters: * * `string` **username** - username
Accepted characters: A-z (case-insensitive), 0-9 and underscores.
Length: 5-32 characters. * * @param array $params Parameters * * @return bool */ public function checkUsername($params); /** * Changes username for the current user. * * Parameters: * * `string` **username** - username or empty string if username is to be removed
Accepted characters: a-z (case-insensitive), 0-9 and underscores.
Length: 5-32 characters. * * @param array $params Parameters * * @return User */ public function updateUsername($params); /** * Get privacy settings of current account. * * Parameters: * * `InputPrivacyKey` **key** - Peer category whose privacy settings should be fetched * * @param array $params Parameters * * @return account.PrivacyRules */ public function getPrivacy($params); /** * Change privacy settings of current account. * * Parameters: * * `InputPrivacyKey` **key** - Peers to which the privacy rules apply * * `[InputPrivacyRule]` **rules** - New privacy rules * * @param array $params Parameters * * @return account.PrivacyRules */ public function setPrivacy($params); /** * Delete the user's account from the telegram servers. * * Can also be used to delete the account of a user that provided the login code, but forgot the 2FA password and no recovery method is configured, see [here »](https://core.telegram.org/api/srp#password-recovery) for more info on password recovery, and [here »](https://core.telegram.org/api/account-deletion) for more info on account deletion. * * Parameters: * * `string` **reason** - Why is the account being deleted, can be empty * * `InputCheckPasswordSRP` **password** - Optional: [2FA password](https://core.telegram.org/api/srp): this field can be omitted even for accounts with 2FA enabled: in this case account account deletion will be delayed by 7 days [as specified in the docs »](https://core.telegram.org/api/account-deletion) * * @param array $params Parameters * * @return bool */ public function deleteAccount($params); /** * Get days to live of account. * * @return AccountDaysTTL */ public function getAccountTTL(); /** * Set account self-destruction period. * * Parameters: * * `AccountDaysTTL` **ttl** - Time to live in days * * @param array $params Parameters * * @return bool */ public function setAccountTTL($params); /** * Verify a new phone number to associate to the current account. * * Parameters: * * `string` **phone_number** - New phone number * * `CodeSettings` **settings** - Phone code settings * * @param array $params Parameters * * @return auth.SentCode */ public function sendChangePhoneCode($params); /** * Change the phone number of the current account. * * Parameters: * * `string` **phone_number** - New phone number * * `string` **phone_code_hash** - Phone code hash received when calling [account.sendChangePhoneCode](https://docs.madelineproto.xyz/API_docs/methods/account.sendChangePhoneCode.html) * * `string` **phone_code** - Phone code received when calling [account.sendChangePhoneCode](https://docs.madelineproto.xyz/API_docs/methods/account.sendChangePhoneCode.html) * * @param array $params Parameters * * @return User */ public function changePhone($params); /** * When client-side passcode lock feature is enabled, will not show message texts in incoming [PUSH notifications](https://core.telegram.org/api/push-updates). * * Parameters: * * `int` **period** - Inactivity period after which to start hiding message texts in [PUSH notifications](https://core.telegram.org/api/push-updates). * * @param array $params Parameters * * @return bool */ public function updateDeviceLocked($params); /** * Get logged-in sessions. * * @return account.Authorizations */ public function getAuthorizations(); /** * Log out an active [authorized session](https://core.telegram.org/api/auth) by its hash. * * Parameters: * * `long` **hash** - Session hash * * @param array $params Parameters * * @return bool */ public function resetAuthorization($params); /** * Obtain configuration for two-factor authorization with password. * * @return account.Password */ public function getPassword(); /** * You cannot use this method directly; use $MadelineProto->update2fa($params), instead (see https://docs.madelineproto.xyz for more info). * * Parameters: * * `InputCheckPasswordSRP` **password** - The password (see [SRP](https://core.telegram.org/api/srp)) * * @param array $params Parameters * * @return account.PasswordSettings */ public function getPasswordSettings($params); /** * You cannot use this method directly; use $MadelineProto->update2fa($params), instead (see https://docs.madelineproto.xyz for more info). * * Parameters: * * `InputCheckPasswordSRP` **password** - The old password (see [SRP](https://core.telegram.org/api/srp)) * * `account.PasswordInputSettings` **new_settings** - The new password (see [SRP](https://core.telegram.org/api/srp)) * * @param array $params Parameters * * @return bool */ public function updatePasswordSettings($params); /** * Send confirmation code to cancel account deletion, for more info [click here »](https://core.telegram.org/api/account-deletion). * * Parameters: * * `string` **hash** - The hash from the service notification, for more info [click here »](https://core.telegram.org/api/account-deletion) * * `CodeSettings` **settings** - Phone code settings * * @param array $params Parameters * * @return auth.SentCode */ public function sendConfirmPhoneCode($params); /** * Confirm a phone number to cancel account deletion, for more info [click here »](https://core.telegram.org/api/account-deletion). * * Parameters: * * `string` **phone_code_hash** - Phone code hash, for more info [click here »](https://core.telegram.org/api/account-deletion) * * `string` **phone_code** - SMS code, for more info [click here »](https://core.telegram.org/api/account-deletion) * * @param array $params Parameters * * @return bool */ public function confirmPhone($params); /** * Get temporary payment password. * * Parameters: * * `InputCheckPasswordSRP` **password** - SRP password parameters * * `int` **period** - Time during which the temporary password will be valid, in seconds; should be between 60 and 86400 * * @param array $params Parameters * * @return account.TmpPassword */ public function getTmpPassword($params); /** * Get web [login widget](https://core.telegram.org/widgets/login) authorizations. * * @return account.WebAuthorizations */ public function getWebAuthorizations(); /** * Log out an active web [telegram login](https://core.telegram.org/widgets/login) session. * * Parameters: * * `long` **hash** - [Session](https://docs.madelineproto.xyz/API_docs/constructors/webAuthorization.html) hash * * @param array $params Parameters * * @return bool */ public function resetWebAuthorization($params); /** * Reset all active web [telegram login](https://core.telegram.org/widgets/login) sessions. * * @return bool */ public function resetWebAuthorizations(); /** * Get all saved [Telegram Passport](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption). * * @return of SecureValue[] */ public function getAllSecureValues(); /** * Get saved [Telegram Passport](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption). * * Parameters: * * `[SecureValueType]` **types** - Requested value types * * @param array $params Parameters * * @return of SecureValue[] */ public function getSecureValue($params); /** * Securely save [Telegram Passport](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption). * * Parameters: * * `InputSecureValue` **value** - Secure value, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption) * * `long` **secure_secret_id** - Passport secret hash, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption) * * @param array $params Parameters * * @return SecureValue */ public function saveSecureValue($params); /** * Delete stored [Telegram Passport](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption). * * Parameters: * * `[SecureValueType]` **types** - Document types to delete * * @param array $params Parameters * * @return bool */ public function deleteSecureValue($params); /** * Returns a Telegram Passport authorization form for sharing data with a service. * * Parameters: * * `long` **bot_id** - User identifier of the service's bot * * `string` **scope** - Telegram Passport element types requested by the service * * `string` **public_key** - Service's public key * * @param array $params Parameters * * @return account.AuthorizationForm */ public function getAuthorizationForm($params); /** * Sends a Telegram Passport authorization form, effectively sharing data with the service. * * Parameters: * * `long` **bot_id** - Bot ID * * `string` **scope** - Telegram Passport element types requested by the service * * `string` **public_key** - Service's public key * * `[SecureValueHash]` **value_hashes** - Types of values sent and their hashes * * `SecureCredentialsEncrypted` **credentials** - Encrypted values * * @param array $params Parameters * * @return bool */ public function acceptAuthorization($params); /** * Send the verification phone code for telegram [passport](https://core.telegram.org/passport). * * Parameters: * * `string` **phone_number** - The phone number to verify * * `CodeSettings` **settings** - Phone code settings * * @param array $params Parameters * * @return auth.SentCode */ public function sendVerifyPhoneCode($params); /** * Verify a phone number for telegram [passport](https://core.telegram.org/passport). * * Parameters: * * `string` **phone_number** - Phone number * * `string` **phone_code_hash** - Phone code hash received from the call to [account.sendVerifyPhoneCode](https://docs.madelineproto.xyz/API_docs/methods/account.sendVerifyPhoneCode.html) * * `string` **phone_code** - Code received after the call to [account.sendVerifyPhoneCode](https://docs.madelineproto.xyz/API_docs/methods/account.sendVerifyPhoneCode.html) * * @param array $params Parameters * * @return bool */ public function verifyPhone($params); /** * Send an email verification code. * * Parameters: * * `EmailVerifyPurpose` **purpose** - * * `string` **email** - The email where to send the code. * * @param array $params Parameters * * @return account.SentEmailCode */ public function sendVerifyEmailCode($params); /** * Verify an email address. * * Parameters: * * `EmailVerifyPurpose` **purpose** - * * `EmailVerification` **verification** - * * @param array $params Parameters * * @return account.EmailVerified */ public function verifyEmail($params); /** * Initialize account takeout session. * * Parameters: * * `boolean` **contacts** - Optional: Whether to export contacts * * `boolean` **message_users** - Optional: Whether to export messages in private chats * * `boolean` **message_chats** - Optional: Whether to export messages in [basic groups](https://core.telegram.org/api/channel#basic-groups) * * `boolean` **message_megagroups** - Optional: Whether to export messages in [supergroups](https://core.telegram.org/api/channel#supergroups) * * `boolean` **message_channels** - Optional: Whether to export messages in [channels](https://core.telegram.org/api/channel#channels) * * `boolean` **files** - Optional: Whether to export files * * `long` **file_max_size** - Optional: Maximum size of files to export * * @param array $params Parameters * * @return account.Takeout */ public function initTakeoutSession($params); /** * Finish account takeout session. * * Parameters: * * `boolean` **success** - Optional: Data exported successfully * * @param array $params Parameters * * @return bool */ public function finishTakeoutSession($params); /** * Verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp). * * Parameters: * * `string` **code** - The phone code that was received after [setting a recovery email](https://core.telegram.org/api/srp#email-verification) * * @param array $params Parameters * * @return bool */ public function confirmPasswordEmail($params); /** * Resend the code to verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp). * * @return bool */ public function resendPasswordEmail(); /** * Cancel the code that was sent to verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp). * * @return bool */ public function cancelPasswordEmail(); /** * Whether the user will receive notifications when contacts sign up. * * @return bool */ public function getContactSignUpNotification(); /** * Toggle contact sign up notifications. * * Parameters: * * `Bool` **silent** - Whether to disable contact sign up notifications * * @param array $params Parameters * * @return bool */ public function setContactSignUpNotification($params); /** * Returns list of chats with non-default notification settings. * * Parameters: * * `boolean` **compare_sound** - Optional: If true, chats with non-default sound will also be returned * * `InputNotifyPeer` **peer** - Optional: If specified, only chats of the specified category will be returned * * @param array $params Parameters * * @return Updates */ public function getNotifyExceptions($params); /** * Get info about a certain [wallpaper](https://core.telegram.org/api/wallpapers). * * Parameters: * * `InputWallPaper` **wallpaper** - The [wallpaper](https://core.telegram.org/api/wallpapers) to get info about * * @param array $params Parameters * * @return WallPaper */ public function getWallPaper($params); /** * Create and upload a new [wallpaper](https://core.telegram.org/api/wallpapers). * * Parameters: * * `InputFile` **file** - The JPG/PNG wallpaper * * `string` **mime_type** - MIME type of uploaded wallpaper * * `WallPaperSettings` **settings** - Wallpaper settings * * @param array $params Parameters * * @return WallPaper */ public function uploadWallPaper($params); /** * Install/uninstall [wallpaper](https://core.telegram.org/api/wallpapers). * * Parameters: * * `InputWallPaper` **wallpaper** - [Wallpaper](https://core.telegram.org/api/wallpapers) to install or uninstall * * `Bool` **unsave** - Uninstall wallpaper? * * `WallPaperSettings` **settings** - Wallpaper settings * * @param array $params Parameters * * @return bool */ public function saveWallPaper($params); /** * Install [wallpaper](https://core.telegram.org/api/wallpapers). * * Parameters: * * `InputWallPaper` **wallpaper** - [Wallpaper](https://core.telegram.org/api/wallpapers) to install * * `WallPaperSettings` **settings** - [Wallpaper](https://core.telegram.org/api/wallpapers) settings * * @param array $params Parameters * * @return bool */ public function installWallPaper($params); /** * Delete all installed [wallpapers](https://core.telegram.org/api/wallpapers), reverting to the default wallpaper set. * * @return bool */ public function resetWallPapers(); /** * Get media autodownload settings. * * @return account.AutoDownloadSettings */ public function getAutoDownloadSettings(); /** * Change media autodownload settings. * * Parameters: * * `boolean` **low** - Optional: Whether to save media in the low data usage preset * * `boolean` **high** - Optional: Whether to save media in the high data usage preset * * `AutoDownloadSettings` **settings** - Media autodownload settings * * @param array $params Parameters * * @return bool */ public function saveAutoDownloadSettings($params); /** * Upload theme. * * Parameters: * * `InputFile` **file** - [Previously uploaded](https://core.telegram.org/api/themes#uploading-theme-files) theme file with platform-specific colors for UI components, can be left unset when creating themes that only modify the wallpaper or accent colors. * * `InputFile` **thumb** - Optional: Thumbnail * * `string` **file_name** - File name * * `string` **mime_type** - MIME type, must be `application/x-tgtheme-{format}`, where `format` depends on the client * * @param array $params Parameters * * @return Document */ public function uploadTheme($params); /** * Create a theme. * * Parameters: * * `string` **slug** - Unique theme ID used to generate [theme deep links](https://core.telegram.org/api/links#theme-links), can be empty to autogenerate a random ID. * * `string` **title** - Theme name * * `InputDocument` **document** - Optional: Theme file * * `[InputThemeSettings]` **settings** - Optional: Theme settings, multiple values can be provided for the different base themes (day/night mode, etc). * * @param array $params Parameters * * @return Theme */ public function createTheme($params); /** * Update theme. * * Parameters: * * `string` **format** - Theme format, a string that identifies the theming engines supported by the client * * `InputTheme` **theme** - Theme to update * * `string` **slug** - Optional: Unique theme ID * * `string` **title** - Optional: Theme name * * `InputDocument` **document** - Optional: Theme file * * `[InputThemeSettings]` **settings** - Optional: Theme settings * * @param array $params Parameters * * @return Theme */ public function updateTheme($params); /** * Save a theme. * * Parameters: * * `InputTheme` **theme** - Theme to save * * `Bool` **unsave** - Unsave * * @param array $params Parameters * * @return bool */ public function saveTheme($params); /** * Install a theme. * * Parameters: * * `boolean` **dark** - Optional: Whether to install the dark version * * `InputTheme` **theme** - Optional: Theme to install * * `string` **format** - Optional: Theme format, a string that identifies the theming engines supported by the client * * `BaseTheme` **base_theme** - Optional: Indicates a basic theme provided by all clients * * @param array $params Parameters * * @return bool */ public function installTheme($params); /** * Get theme information. * * Parameters: * * `string` **format** - Theme format, a string that identifies the theming engines supported by the client * * `InputTheme` **theme** - Theme * * @param array $params Parameters * * @return Theme */ public function getTheme($params); /** * Get installed themes. * * Parameters: * * `string` **format** - Theme format, a string that identifies the theming engines supported by the client * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return account.Themes */ public function getThemes($params); /** * Set sensitive content settings (for viewing or hiding NSFW content). * * Parameters: * * `boolean` **sensitive_enabled** - Optional: Enable NSFW content * * @param array $params Parameters * * @return bool */ public function setContentSettings($params); /** * Get sensitive content settings. * * @return account.ContentSettings */ public function getContentSettings(); /** * Get info about multiple [wallpapers](https://core.telegram.org/api/wallpapers). * * Parameters: * * `[InputWallPaper]` **wallpapers** - [Wallpapers](https://core.telegram.org/api/wallpapers) to fetch info about * * @param array $params Parameters * * @return of WallPaper[] */ public function getMultiWallPapers($params); /** * Get global privacy settings. * * @return GlobalPrivacySettings */ public function getGlobalPrivacySettings(); /** * Set global privacy settings. * * Parameters: * * `GlobalPrivacySettings` **settings** - Global privacy settings * * @param array $params Parameters * * @return GlobalPrivacySettings */ public function setGlobalPrivacySettings($params); /** * Report a profile photo of a dialog. * * Parameters: * * `InputPeer` **peer** - The dialog * * `InputPhoto` **photo_id** - Dialog photo ID * * `ReportReason` **reason** - Report reason * * `string` **message** - Comment for report moderation * * @param array $params Parameters * * @return bool */ public function reportProfilePhoto($params); /** * Initiate a 2FA password reset: can only be used if the user is already logged-in, [see here for more info »](https://core.telegram.org/api/srp#password-reset). * * @return account.ResetPasswordResult */ public function resetPassword(); /** * Abort a pending 2FA password reset, [see here for more info »](https://core.telegram.org/api/srp#password-reset). * * @return bool */ public function declinePasswordReset(); /** * Get all available chat themes. * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return account.Themes */ public function getChatThemes($params); /** * Set time-to-live of current session. * * Parameters: * * `int` **authorization_ttl_days** - Time-to-live of current session in days * * @param array $params Parameters * * @return bool */ public function setAuthorizationTTL($params); /** * Change authorization settings. * * Parameters: * * `long` **hash** - Session ID from the [authorization](https://docs.madelineproto.xyz/API_docs/constructors/authorization.html) constructor, fetchable using [account.getAuthorizations](https://docs.madelineproto.xyz/API_docs/methods/account.getAuthorizations.html) * * `Bool` **encrypted_requests_disabled** - Optional: Whether to enable or disable receiving encrypted chats: if the flag is not set, the previous setting is not changed * * `Bool` **call_requests_disabled** - Optional: Whether to enable or disable receiving calls: if the flag is not set, the previous setting is not changed * * @param array $params Parameters * * @return bool */ public function changeAuthorizationSettings($params); /** * Fetch saved notification sounds. * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return account.SavedRingtones */ public function getSavedRingtones($params); /** * Save or remove saved notification sound. * * If the notification sound is already in MP3 format, [account.savedRingtone](https://docs.madelineproto.xyz/API_docs/constructors/account.savedRingtone.html) will be returned. * Otherwise, it will be automatically converted and a [account.savedRingtoneConverted](https://docs.madelineproto.xyz/API_docs/constructors/account.savedRingtoneConverted.html) will be returned, containing a new [document](https://docs.madelineproto.xyz/API_docs/constructors/document.html) object that should be used to refer to the ringtone from now on (ie when deleting it using the `unsave` parameter, or when downloading it). * * Parameters: * * `InputDocument` **id** - Notification sound uploaded using [account.uploadRingtone](https://docs.madelineproto.xyz/API_docs/methods/account.uploadRingtone.html) * * `Bool` **unsave** - Whether to add or delete the notification sound * * @param array $params Parameters * * @return account.SavedRingtone */ public function saveRingtone($params); /** * Upload notification sound, use [account.saveRingtone](https://docs.madelineproto.xyz/API_docs/methods/account.saveRingtone.html) to convert it and add it to the list of saved notification sounds. * * Parameters: * * `InputFile` **file** - Notification sound * * `string` **file_name** - File name * * `string` **mime_type** - MIME type of file * * @param array $params Parameters * * @return Document */ public function uploadRingtone($params); /** * * * Parameters: * * `EmojiStatus` **emoji_status** -. * * @param array $params Parameters * * @return bool */ public function updateEmojiStatus($params); /** * * * Parameters: * * `long` **hash** -. * * @param array $params Parameters * * @return account.EmojiStatuses */ public function getDefaultEmojiStatuses($params); /** * * * Parameters: * * `long` **hash** -. * * @param array $params Parameters * * @return account.EmojiStatuses */ public function getRecentEmojiStatuses($params); /** * * * @return bool */ public function clearRecentEmojiStatuses(); /** * * * Parameters: * * `[string]` **order** -. * * @param array $params Parameters * * @return bool */ public function reorderUsernames($params); /** * * * Parameters: * * `string` **username** - * * `Bool` **active** -. * * @param array $params Parameters * * @return bool */ public function toggleUsername($params); } interface users { /** * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info). * * Parameters: * * `[InputUser]` **id** - List of user identifiers * * @param array $params Parameters * * @return of User[] */ public function getUsers($params); /** * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info). * * Parameters: * * `InputUser` **id** - User ID * * @param array $params Parameters * * @return users.UserFull */ public function getFullUser($params); /** * Notify the user that the sent [passport](https://core.telegram.org/passport) data contains some errors The user will not be able to re-submit their Passport data to you until the errors are fixed (the contents of the field for which you returned the error must change). * * Use this if the data submitted by the user doesn't satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues. * * Parameters: * * `InputUser` **id** - The user * * `[SecureValueError]` **errors** - Errors * * @param array $params Parameters * * @return bool */ public function setSecureValueErrors($params); } interface contacts { /** * Get contact by telegram IDs. * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return of int[] */ public function getContactIDs($params); /** * Returns the list of contact statuses. * * @return of ContactStatus[] */ public function getStatuses(); /** * Returns the current user's contact list. * * Parameters: * * `long` **hash** - If there already is a full contact list on the client, a [hash](https://core.telegram.org/api/offsets#hash-generation) of a the list of contact IDs in ascending order may be passed in this parameter. If the contact set was not changed, [(contacts.contactsNotModified)](https://docs.madelineproto.xyz/API_docs/constructors/contacts.contactsNotModified.html) will be returned. * * @param array $params Parameters * * @return contacts.Contacts */ public function getContacts($params); /** * Imports contacts: saves a full list on the server, adds already registered contacts to the contact list, returns added contacts and their info. * * Use [contacts.addContact](https://docs.madelineproto.xyz/API_docs/methods/contacts.addContact.html) to add Telegram contacts without actually using their phone number. * * Parameters: * * `[InputContact]` **contacts** - List of contacts to import * * @param array $params Parameters * * @return contacts.ImportedContacts */ public function importContacts($params); /** * Deletes several contacts from the list. * * Parameters: * * `[InputUser]` **id** - User ID list * * @param array $params Parameters * * @return Updates */ public function deleteContacts($params); /** * Delete contacts by phone number. * * Parameters: * * `[string]` **phones** - Phone numbers * * @param array $params Parameters * * @return bool */ public function deleteByPhones($params); /** * Adds the user to the blacklist. * * Parameters: * * `InputPeer` **id** - User ID * * @param array $params Parameters * * @return bool */ public function block($params); /** * Deletes the user from the blacklist. * * Parameters: * * `InputPeer` **id** - User ID * * @param array $params Parameters * * @return bool */ public function unblock($params); /** * Returns the list of blocked users. * * Parameters: * * `int` **offset** - The number of list elements to be skipped * * `int` **limit** - The number of list elements to be returned * * @param array $params Parameters * * @return contacts.Blocked */ public function getBlocked($params); /** * Returns users found by username substring. * * Parameters: * * `string` **q** - Target substring * * `int` **limit** - Maximum number of users to be returned * * @param array $params Parameters * * @return contacts.Found */ public function search($params); /** * You cannot use this method directly, use the resolveUsername, getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info). * * Parameters: * * `string` **username** - @username to resolve * * @param array $params Parameters * * @return contacts.ResolvedPeer */ public function resolveUsername($params); /** * Get most used peers. * * Parameters: * * `boolean` **correspondents** - Optional: Users we've chatted most frequently with * * `boolean` **bots_pm** - Optional: Most used bots * * `boolean` **bots_inline** - Optional: Most used inline bots * * `boolean` **phone_calls** - Optional: Most frequently called users * * `boolean` **forward_users** - Optional: Users to which the users often forwards messages to * * `boolean` **forward_chats** - Optional: Chats to which the users often forwards messages to * * `boolean` **groups** - Optional: Often-opened groups and supergroups * * `boolean` **channels** - Optional: Most frequently visited channels * * `int` **offset** - Offset for [pagination](https://core.telegram.org/api/offsets) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return contacts.TopPeers */ public function getTopPeers($params); /** * Reset [rating](https://core.telegram.org/api/top-rating) of top peer. * * Parameters: * * `TopPeerCategory` **category** - Top peer category * * `InputPeer` **peer** - Peer whose rating should be reset * * @param array $params Parameters * * @return bool */ public function resetTopPeerRating($params); /** * Delete saved contacts. * * @return bool */ public function resetSaved(); /** * Get all contacts. * * @return of SavedContact[] */ public function getSaved(); /** * Enable/disable [top peers](https://core.telegram.org/api/top-rating). * * Parameters: * * `Bool` **enabled** - Enable/disable * * @param array $params Parameters * * @return bool */ public function toggleTopPeers($params); /** * Add an existing telegram user as contact. * * Use [contacts.importContacts](https://docs.madelineproto.xyz/API_docs/methods/contacts.importContacts.html) to add contacts by phone number, without knowing their Telegram ID. * * Parameters: * * `boolean` **add_phone_privacy_exception** - Optional: Allow the other user to see our phone number? * * `InputUser` **id** - Telegram ID of the other user * * `string` **first_name** - First name * * `string` **last_name** - Last name * * `string` **phone** - User's phone number * * @param array $params Parameters * * @return Updates */ public function addContact($params); /** * If the [peer settings](https://docs.madelineproto.xyz/API_docs/constructors/peerSettings.html) of a new user allow us to add them as contact, add that user as contact. * * Parameters: * * `InputUser` **id** - The user to add as contact * * @param array $params Parameters * * @return Updates */ public function acceptContact($params); /** * Get contacts near you. * * Parameters: * * `boolean` **background** - Optional: While the geolocation of the current user is public, clients should update it in the background every half-an-hour or so, while setting this flag.
Do this only if the new location is more than 1 KM away from the previous one, or if the previous location is unknown. * * `InputGeoPoint` **geo_point** - Geolocation * * `int` **self_expires** - Optional: If set, the geolocation of the current user will be public for the specified number of seconds; pass 0x7fffffff to disable expiry, 0 to make the current geolocation private; if the flag isn't set, no changes will be applied. * * @param array $params Parameters * * @return Updates */ public function getLocated($params); /** * Stop getting notifications about [thread replies](https://core.telegram.org/api/threads) of a certain user in `@replies`. * * Parameters: * * `boolean` **delete_message** - Optional: Whether to delete the specified message as well * * `boolean` **delete_history** - Optional: Whether to delete all `@replies` messages from this user as well * * `boolean` **report_spam** - Optional: Whether to also report this user for spam * * `int` **msg_id** - ID of the message in the [@replies](https://core.telegram.org/api/threads#replies) chat * * @param array $params Parameters * * @return Updates */ public function blockFromReplies($params); /** * Resolve a phone number to get user info, if their privacy settings allow it. * * Parameters: * * `string` **phone** - Phone number in international format, possibly obtained from a [phone number deep link](https://core.telegram.org/api/links#phone-number-links). * * @param array $params Parameters * * @return contacts.ResolvedPeer */ public function resolvePhone($params); /** * * * @return ExportedContactToken */ public function exportContactToken(); /** * * * Parameters: * * `string` **token** -. * * @param array $params Parameters * * @return User */ public function importContactToken($params); } interface messages { /** * Please use the [event handler](https://docs.madelineproto.xyz/docs/UPDATES.html). * * Parameters: * * `[InputMessage]` **id** - Message ID list * * @param array $params Parameters * * @return messages.Messages */ public function getMessages($params); /** * Returns the current user dialog list. * * Parameters: * * `boolean` **exclude_pinned** - Optional: Exclude pinned dialogs * * `int` **folder_id** - Optional: [Peer folder ID, for more info click here](https://core.telegram.org/api/folders#peer-folders) * * `int` **offset_date** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `InputPeer` **offset_peer** - [Offset peer for pagination](https://core.telegram.org/api/offsets) * * `int` **limit** - Number of list elements to be returned * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.Dialogs */ public function getDialogs($params); /** * Please use the [event handler](https://docs.madelineproto.xyz/docs/UPDATES.html). * * Parameters: * * `InputPeer` **peer** - Target peer * * `int` **offset_id** - Only return messages starting from the specified message ID * * `int` **offset_date** - Only return messages sent before the specified date * * `int` **add_offset** - Number of list elements to be skipped, negative values are also accepted. * * `int` **limit** - Number of results to return * * `int` **max_id** - If a positive value was transferred, the method will return only messages with IDs less than **max\_id** * * `int` **min_id** - If a positive value was transferred, the method will return only messages with IDs more than **min\_id** * * `long` **hash** - [Result hash](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.Messages */ public function getHistory($params); /** * Returns found messages. * * Parameters: * * `InputPeer` **peer** - User or chat, histories with which are searched, or [(inputPeerEmpty)](https://docs.madelineproto.xyz/API_docs/constructors/inputPeerEmpty.html) constructor for global search * * `string` **q** - Text search request * * `InputPeer` **from_id** - Optional: Only return messages sent by the specified user ID * * `int` **top_msg_id** - Optional: [Thread ID](https://core.telegram.org/api/threads) * * `MessagesFilter` **filter** - Filter to return only specified message types * * `int` **min_date** - If a positive value was transferred, only messages with a sending date bigger than the transferred one will be returned * * `int` **max_date** - If a positive value was transferred, only messages with a sending date smaller than the transferred one will be returned * * `int` **offset_id** - Only return messages starting from the specified message ID * * `int` **add_offset** - [Additional offset](https://core.telegram.org/api/offsets) * * `int` **limit** - [Number of results to return](https://core.telegram.org/api/offsets) * * `int` **max_id** - [Maximum message ID to return](https://core.telegram.org/api/offsets) * * `int` **min_id** - [Minimum message ID to return](https://core.telegram.org/api/offsets) * * `long` **hash** - [Hash](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.Messages */ public function search($params); /** * Marks message history as read. * * Parameters: * * `InputPeer` **peer** - Target user or group * * `int` **max_id** - If a positive value is passed, only messages with identifiers less or equal than the given one will be read * * @param array $params Parameters * * @return messages.AffectedMessages */ public function readHistory($params); /** * Deletes communication history. * * Parameters: * * `boolean` **just_clear** - Optional: Just clear history for the current user, without actually removing messages for every chat user * * `boolean` **revoke** - Optional: Whether to delete the message history for all chat participants * * `InputPeer` **peer** - User or chat, communication history of which will be deleted * * `int` **max_id** - Maximum ID of message to delete * * `int` **min_date** - Optional: Delete all messages newer than this UNIX timestamp * * `int` **max_date** - Optional: Delete all messages older than this UNIX timestamp * * @param array $params Parameters * * @return messages.AffectedHistory */ public function deleteHistory($params); /** * Deletes messages by their identifiers. * * Parameters: * * `boolean` **revoke** - Optional: Whether to delete messages for all participants of the chat * * `[int]` **id** - Message ID list * * @param array $params Parameters * * @return messages.AffectedMessages */ public function deleteMessages($params); /** * Confirms receipt of messages by a client, cancels PUSH-notification sending. * * Parameters: * * `int` **max_id** - Maximum message ID available in a client. * * @param array $params Parameters * * @return of ReceivedNotifyMessage[] */ public function receivedMessages($params); /** * Sends a current user typing event (see [SendMessageAction](https://docs.madelineproto.xyz/API_docs/types/SendMessageAction.html) for all event types) to a conversation partner or group. * * Parameters: * * `InputPeer` **peer** - Target user or group * * `int` **top_msg_id** - Optional: [Thread ID](https://core.telegram.org/api/threads) * * `SendMessageAction` **action** - Type of action * * @param array $params Parameters * * @return bool */ public function setTyping($params); /** * Sends a message to a chat. * * Parameters: * * `boolean` **no_webpage** - Optional: Set this flag to disable generation of the webpage preview * * `boolean` **silent** - Optional: Send this message silently (no notifications for the receivers) * * `boolean` **background** - Optional: Send this message as background message * * `boolean` **clear_draft** - Optional: Clear the draft field * * `boolean` **noforwards** - Optional: Only for bots, disallows forwarding and saving of the messages, even if the destination chat doesn't have [content protection](https://telegram.org/blog/protected-content-delete-by-date-and-more) enabled * * `boolean` **update_stickersets_order** - Optional: * * `InputPeer` **peer** - The destination where the message will be sent * * `int` **reply_to_msg_id** - Optional: The message ID to which this message will reply to * * `int` **top_msg_id** - Optional: * * `string` **message** - The message * * `ReplyMarkup` **reply_markup** - Optional: Reply markup for sending bot buttons * * `[MessageEntity]` **entities** - Optional: Message [entities](https://core.telegram.org/api/entities) for sending styled text * * `int` **schedule_date** - Optional: Scheduled message date for [scheduled messages](https://core.telegram.org/api/scheduled-messages) * * `InputPeer` **send_as** - Optional: Send this message as the specified peer * * @param array $params Parameters * * @return Updates */ public function sendMessage($params); /** * Send a media. * * Parameters: * * `boolean` **silent** - Optional: Send message silently (no notification should be triggered) * * `boolean` **background** - Optional: Send message in background * * `boolean` **clear_draft** - Optional: Clear the draft * * `boolean` **noforwards** - Optional: Only for bots, disallows forwarding and saving of the messages, even if the destination chat doesn't have [content protection](https://telegram.org/blog/protected-content-delete-by-date-and-more) enabled * * `boolean` **update_stickersets_order** - Optional: * * `InputPeer` **peer** - Destination * * `int` **reply_to_msg_id** - Optional: Message ID to which this message should reply to * * `int` **top_msg_id** - Optional: * * `InputMedia` **media** - Attached media * * `string` **message** - Caption * * `ReplyMarkup` **reply_markup** - Optional: Reply markup for bot keyboards * * `[MessageEntity]` **entities** - Optional: Message [entities](https://core.telegram.org/api/entities) for styled text * * `int` **schedule_date** - Optional: Scheduled message date for [scheduled messages](https://core.telegram.org/api/scheduled-messages) * * `InputPeer` **send_as** - Optional: Send this message as the specified peer * * @param array $params Parameters * * @return Updates */ public function sendMedia($params); /** * Forwards messages by their IDs. * * Parameters: * * `boolean` **silent** - Optional: Whether to send messages silently (no notification will be triggered on the destination clients) * * `boolean` **background** - Optional: Whether to send the message in background * * `boolean` **with_my_score** - Optional: When forwarding games, whether to include your score in the game * * `boolean` **drop_author** - Optional: Whether to forward messages without quoting the original author * * `boolean` **drop_media_captions** - Optional: Whether to strip captions from media * * `boolean` **noforwards** - Optional: Only for bots, disallows further re-forwarding and saving of the messages, even if the destination chat doesn't have [content protection](https://telegram.org/blog/protected-content-delete-by-date-and-more) enabled * * `InputPeer` **from_peer** - Source of messages * * `[int]` **id** - IDs of messages * * `InputPeer` **to_peer** - Destination peer * * `int` **top_msg_id** - Optional: * * `int` **schedule_date** - Optional: Scheduled message date for scheduled messages * * `InputPeer` **send_as** - Optional: Forward the messages as the specified peer * * @param array $params Parameters * * @return Updates */ public function forwardMessages($params); /** * Report a new incoming chat for spam, if the [peer settings](https://docs.madelineproto.xyz/API_docs/constructors/peerSettings.html) of the chat allow us to do that. * * Parameters: * * `InputPeer` **peer** - Peer to report * * @param array $params Parameters * * @return bool */ public function reportSpam($params); /** * Get peer settings. * * Parameters: * * `InputPeer` **peer** - The peer * * @param array $params Parameters * * @return messages.PeerSettings */ public function getPeerSettings($params); /** * Report a message in a chat for violation of telegram's Terms of Service. * * Parameters: * * `InputPeer` **peer** - Peer * * `[int]` **id** - IDs of messages to report * * `ReportReason` **reason** - Why are these messages being reported * * `string` **message** - Comment for report moderation * * @param array $params Parameters * * @return bool */ public function report($params); /** * Returns chat basic info on their IDs. * * Parameters: * * `[long]` **id** - List of chat IDs * * @param array $params Parameters * * @return messages.Chats */ public function getChats($params); /** * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info). * * Parameters: * * `InputPeer` **chat_id** - * * @param array $params Parameters * * @return messages.ChatFull */ public function getFullChat($params); /** * Changes chat name and sends a service message on it. * * Parameters: * * `InputPeer` **chat_id** - * * `string` **title** - New chat name, different from the old one * * @param array $params Parameters * * @return Updates */ public function editChatTitle($params); /** * Changes chat photo and sends a service message on it. * * Parameters: * * `InputPeer` **chat_id** - * * `InputChatPhoto` **photo** - Photo to be set * * @param array $params Parameters * * @return Updates */ public function editChatPhoto($params); /** * Adds a user to a chat and sends a service message on it. * * Parameters: * * `InputPeer` **chat_id** - * * `InputUser` **user_id** - User ID to be added * * `int` **fwd_limit** - Number of last messages to be forwarded * * @param array $params Parameters * * @return Updates */ public function addChatUser($params); /** * Deletes a user from a chat and sends a service message on it. * * Parameters: * * `boolean` **revoke_history** - Optional: Remove the entire chat history of the specified user in this chat. * * `InputPeer` **chat_id** - * * `InputUser` **user_id** - User ID to be deleted * * @param array $params Parameters * * @return Updates */ public function deleteChatUser($params); /** * Creates a new chat. * * Parameters: * * `[InputUser]` **users** - List of user IDs to be invited * * `string` **title** - Chat name * * `int` **ttl_period** - Optional: * * @param array $params Parameters * * @return Updates */ public function createChat($params); /** * You cannot use this method directly, instead use $MadelineProto->getDhConfig();. * * Parameters: * * `int` **version** - Value of the **version** parameter from [messages.dhConfig](https://docs.madelineproto.xyz/API_docs/constructors/messages.dhConfig.html), available at the client * * `int` **random_length** - Length of the required random sequence * * @param array $params Parameters * * @return messages.DhConfig */ public function getDhConfig($params); /** * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats. * * Parameters: * * `InputUser` **user_id** - User ID * * `bytes` **g_a** - `A = g ^ a mod p`, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange) * * @param array $params Parameters * * @return EncryptedChat */ public function requestEncryption($params); /** * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats. * * Parameters: * * `InputEncryptedChat` **peer** - Secret chat ID * * `bytes` **g_b** - `B = g ^ b mod p`, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange) * * `long` **key_fingerprint** - 64-bit fingerprint of the received key * * @param array $params Parameters * * @return EncryptedChat */ public function acceptEncryption($params); /** * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats. * * Parameters: * * `boolean` **delete_history** - Optional: Whether to delete the entire chat history for the other user as well * * `int` **chat_id** - Secret chat ID * * @param array $params Parameters * * @return bool */ public function discardEncryption($params); /** * Send typing event by the current user to a secret chat. * * Parameters: * * `InputEncryptedChat` **peer** - Secret chat ID * * `Bool` **typing** - Typing.
**Possible values**:
[(boolTrue)](https://docs.madelineproto.xyz/API_docs/constructors/boolTrue.html), if the user started typing and more than **5 seconds** have passed since the last request
[(boolFalse)](https://docs.madelineproto.xyz/API_docs/constructors/boolFalse.html), if the user stopped typing * * @param array $params Parameters * * @return bool */ public function setEncryptedTyping($params); /** * Marks message history within a secret chat as read. * * Parameters: * * `InputEncryptedChat` **peer** - Secret chat ID * * `int` **max_date** - Maximum date value for received messages in history * * @param array $params Parameters * * @return bool */ public function readEncryptedHistory($params); /** * Sends a text message to a secret chat. * * Parameters: * * `boolean` **silent** - Optional: Send encrypted message without a notification * * `InputEncryptedChat` **peer** - Secret chat ID * * `DecryptedMessage` **message** - * * @param array $params Parameters * * @return messages.SentEncryptedMessage */ public function sendEncrypted($params); /** * Sends a message with a file attachment to a secret chat. * * Parameters: * * `boolean` **silent** - Optional: Whether to send the file without triggering a notification * * `InputEncryptedChat` **peer** - Secret chat ID * * `DecryptedMessage` **message** - * * `InputEncryptedFile` **file** - File attachment for the secret chat * * @param array $params Parameters * * @return messages.SentEncryptedMessage */ public function sendEncryptedFile($params); /** * Sends a service message to a secret chat. * * Parameters: * * `InputEncryptedChat` **peer** - Secret chat ID * * `DecryptedMessage` **message** - * * @param array $params Parameters * * @return messages.SentEncryptedMessage */ public function sendEncryptedService($params); /** * You cannot use this method directly. * * Parameters: * * `int` **max_qts** - Maximum qts value available at the client * * @param array $params Parameters * * @return of long[] */ public function receivedQueue($params); /** * Report a secret chat for spam. * * Parameters: * * `InputEncryptedChat` **peer** - The secret chat to report * * @param array $params Parameters * * @return bool */ public function reportEncryptedSpam($params); /** * Notifies the sender about the recipient having listened a voice message or watched a video. * * Parameters: * * `[int]` **id** - Message ID list * * @param array $params Parameters * * @return messages.AffectedMessages */ public function readMessageContents($params); /** * Get stickers by emoji. * * Parameters: * * `string` **emoticon** - The emoji * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.Stickers */ public function getStickers($params); /** * Get all installed stickers. * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.AllStickers */ public function getAllStickers($params); /** * Get preview of webpage. * * Parameters: * * `string` **message** - Message from which to extract the preview * * `[MessageEntity]` **entities** - Optional: [Message entities for styled text](https://core.telegram.org/api/entities) * * @param array $params Parameters * * @return MessageMedia */ public function getWebPagePreview($params); /** * Export an invite link for a chat. * * Parameters: * * `boolean` **legacy_revoke_permanent** - Optional: Legacy flag, reproducing legacy behavior of this method: if set, revokes all previous links before creating a new one. Kept for bot API BC, should not be used by modern clients. * * `boolean` **request_needed** - Optional: Whether admin confirmation is required before admitting each separate user into the chat * * `InputPeer` **peer** - Chat * * `int` **expire_date** - Optional: Expiration date * * `int` **usage_limit** - Optional: Maximum number of users that can join using this link * * `string` **title** - Optional: Description of the invite link, visible only to administrators * * @param array $params Parameters * * @return ExportedChatInvite */ public function exportChatInvite($params); /** * Check the validity of a chat invite link and get basic info about it. * * Parameters: * * `string` **hash** - Invite hash from [chat invite deep link »](https://core.telegram.org/api/links#chat-invite-links). * * @param array $params Parameters * * @return ChatInvite */ public function checkChatInvite($params); /** * Import a chat invite and join a private chat/supergroup/channel. * * Parameters: * * `string` **hash** - `hash` from a [chat invite deep link](https://core.telegram.org/api/links#chat-invite-links) * * @param array $params Parameters * * @return Updates */ public function importChatInvite($params); /** * Get info about a stickerset. * * Parameters: * * `InputStickerSet` **stickerset** - Stickerset * * `[int]` **hash** - Optional: [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.StickerSet */ public function getStickerSet($params); /** * Install a stickerset. * * Parameters: * * `InputStickerSet` **stickerset** - Stickerset to install * * `Bool` **archived** - Whether to archive stickerset * * @param array $params Parameters * * @return messages.StickerSetInstallResult */ public function installStickerSet($params); /** * Uninstall a stickerset. * * Parameters: * * `InputStickerSet` **stickerset** - The stickerset to uninstall * * @param array $params Parameters * * @return bool */ public function uninstallStickerSet($params); /** * Start a conversation with a bot using a [deep linking parameter](https://core.telegram.org/api/links#bot-links). * * Parameters: * * `InputUser` **bot** - The bot * * `InputPeer` **peer** - The chat where to start the bot, can be the bot's private chat or a group * * `string` **start_param** - [Deep linking parameter](https://core.telegram.org/api/links#bot-links) * * @param array $params Parameters * * @return Updates */ public function startBot($params); /** * Get and increase the view counter of a message sent or forwarded from a [channel](https://core.telegram.org/api/channel). * * Parameters: * * `InputPeer` **peer** - Peer where the message was found * * `[int]` **id** - ID of message * * `Bool` **increment** - Whether to mark the message as viewed and increment the view counter * * @param array $params Parameters * * @return messages.MessageViews */ public function getMessagesViews($params); /** * Make a user admin in a [basic group](https://core.telegram.org/api/channel#basic-groups). * * Parameters: * * `InputPeer` **chat_id** - * * `InputUser` **user_id** - The user to make admin * * `Bool` **is_admin** - Whether to make them admin * * @param array $params Parameters * * @return bool */ public function editChatAdmin($params); /** * Turn a [basic group into a supergroup](https://core.telegram.org/api/channel#migration). * * Parameters: * * `InputPeer` **chat_id** - * * @param array $params Parameters * * @return Updates */ public function migrateChat($params); /** * Search for messages and peers globally. * * Parameters: * * `int` **folder_id** - Optional: [Peer folder ID, for more info click here](https://core.telegram.org/api/folders#peer-folders) * * `string` **q** - Query * * `MessagesFilter` **filter** - Global search filter * * `int` **min_date** - If a positive value was specified, the method will return only messages with date bigger than min\_date * * `int` **max_date** - If a positive value was transferred, the method will return only messages with date smaller than max\_date * * `int` **offset_rate** - Initially 0, then set to the [`next_rate` parameter of messages.messagesSlice](https://docs.madelineproto.xyz/API_docs/constructors/messages.messagesSlice.html) * * `InputPeer` **offset_peer** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **limit** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.Messages */ public function searchGlobal($params); /** * Reorder installed stickersets. * * Parameters: * * `boolean` **masks** - Optional: Reorder mask stickersets * * `boolean` **emojis** - Optional: Reorder [custom emoji stickersets](https://core.telegram.org/api/custom-emoji) * * `[long]` **order** - New stickerset order by stickerset IDs * * @param array $params Parameters * * @return bool */ public function reorderStickerSets($params); /** * Get a document by its SHA256 hash, mainly used for gifs. * * Parameters: * * `bytes` **sha256** - SHA256 of file * * `long` **size** - Size of the file in bytes * * `string` **mime_type** - Mime type * * @param array $params Parameters * * @return Document */ public function getDocumentByHash($params); /** * Get saved GIFs. * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.SavedGifs */ public function getSavedGifs($params); /** * Add GIF to saved gifs list. * * Parameters: * * `InputDocument` **id** - GIF to save * * `Bool` **unsave** - Whether to remove GIF from saved gifs list * * @param array $params Parameters * * @return bool */ public function saveGif($params); /** * Query an inline bot. * * Parameters: * * `InputUser` **bot** - The bot to query * * `InputPeer` **peer** - The currently opened chat * * `InputGeoPoint` **geo_point** - Optional: The geolocation, if requested * * `string` **query** - The query * * `string` **offset** - The offset within the results, will be passed directly as-is to the bot. * * @param array $params Parameters * * @return messages.BotResults */ public function getInlineBotResults($params); /** * Answer an inline query, for bots only. * * Parameters: * * `boolean` **gallery** - Optional: Set this flag if the results are composed of media files * * `boolean` **private** - Optional: Set this flag if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query * * `long` **query_id** - Unique identifier for the answered query * * `[InputBotInlineResult]` **results** - Vector of results for the inline query * * `int` **cache_time** - The maximum amount of time in seconds that the result of the inline query may be cached on the server. Defaults to 300. * * `string` **next_offset** - Optional: Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don't support pagination. Offset length can't exceed 64 bytes. * * `InlineBotSwitchPM` **switch_pm** - Optional: If passed, clients will display a button with specified text that switches the user to a private chat with the bot and sends the bot a start message with a certain parameter. * * @param array $params Parameters * * @return bool */ public function setInlineBotResults($params); /** * Send a result obtained using [messages.getInlineBotResults](https://docs.madelineproto.xyz/API_docs/methods/messages.getInlineBotResults.html). * * Parameters: * * `boolean` **silent** - Optional: Whether to send the message silently (no notification will be triggered on the other client) * * `boolean` **background** - Optional: Whether to send the message in background * * `boolean` **clear_draft** - Optional: Whether to clear the [draft](https://core.telegram.org/api/drafts) * * `boolean` **hide_via** - Optional: Whether to hide the `via @botname` in the resulting message (only for bot usernames encountered in the [config](https://docs.madelineproto.xyz/API_docs/constructors/config.html)) * * `InputPeer` **peer** - Destination * * `int` **reply_to_msg_id** - Optional: ID of the message this message should reply to * * `int` **top_msg_id** - Optional: * * `long` **query_id** - Query ID from [messages.getInlineBotResults](https://docs.madelineproto.xyz/API_docs/methods/messages.getInlineBotResults.html) * * `string` **id** - Result ID from [messages.getInlineBotResults](https://docs.madelineproto.xyz/API_docs/methods/messages.getInlineBotResults.html) * * `int` **schedule_date** - Optional: Scheduled message date for scheduled messages * * `InputPeer` **send_as** - Optional: Send this message as the specified peer * * @param array $params Parameters * * @return Updates */ public function sendInlineBotResult($params); /** * Find out if a media message's caption can be edited. * * Parameters: * * `InputPeer` **peer** - Peer where the media was sent * * `int` **id** - ID of message * * @param array $params Parameters * * @return messages.MessageEditData */ public function getMessageEditData($params); /** * Edit message. * * Parameters: * * `boolean` **no_webpage** - Optional: Disable webpage preview * * `InputPeer` **peer** - Where was the message sent * * `int` **id** - ID of the message to edit * * `string` **message** - Optional: New message * * `InputMedia` **media** - Optional: New attached media * * `ReplyMarkup` **reply_markup** - Optional: Reply markup for inline keyboards * * `[MessageEntity]` **entities** - Optional: [Message entities for styled text](https://core.telegram.org/api/entities) * * `int` **schedule_date** - Optional: Scheduled message date for [scheduled messages](https://core.telegram.org/api/scheduled-messages) * * @param array $params Parameters * * @return Updates */ public function editMessage($params); /** * Edit an inline bot message. * * Parameters: * * `boolean` **no_webpage** - Optional: Disable webpage preview * * `InputBotInlineMessageID` **id** - Sent inline message ID * * `string` **message** - Optional: Message * * `InputMedia` **media** - Optional: Media * * `ReplyMarkup` **reply_markup** - Optional: Reply markup for inline keyboards * * `[MessageEntity]` **entities** - Optional: [Message entities for styled text](https://core.telegram.org/api/entities) * * @param array $params Parameters * * @return bool */ public function editInlineBotMessage($params); /** * Press an inline callback button and get a callback answer from the bot. * * Parameters: * * `boolean` **game** - Optional: Whether this is a "play game" button * * `InputPeer` **peer** - Where was the inline keyboard sent * * `int` **msg_id** - ID of the Message with the inline keyboard * * `bytes` **data** - Optional: Callback data * * `InputCheckPasswordSRP` **password** - Optional: For buttons [requiring you to verify your identity with your 2FA password](https://docs.madelineproto.xyz/API_docs/constructors/keyboardButtonCallback.html), the SRP payload generated using [SRP](https://core.telegram.org/api/srp). * * @param array $params Parameters * * @return messages.BotCallbackAnswer */ public function getBotCallbackAnswer($params); /** * Set the callback answer to a user button press (bots only). * * Parameters: * * `boolean` **alert** - Optional: Whether to show the message as a popup instead of a toast notification * * `long` **query_id** - Query ID * * `string` **message** - Optional: Popup to show * * `string` **url** - Optional: URL to open * * `int` **cache_time** - Cache validity * * @param array $params Parameters * * @return bool */ public function setBotCallbackAnswer($params); /** * Get dialog info of specified peers. * * Parameters: * * `[InputDialogPeer]` **peers** - Peers * * @param array $params Parameters * * @return messages.PeerDialogs */ public function getPeerDialogs($params); /** * Save a message [draft](https://core.telegram.org/api/drafts) associated to a chat. * * Parameters: * * `boolean` **no_webpage** - Optional: Disable generation of the webpage preview * * `int` **reply_to_msg_id** - Optional: Message ID the message should reply to * * `int` **top_msg_id** - Optional: * * `InputPeer` **peer** - Destination of the message that should be sent * * `string` **message** - The draft * * `[MessageEntity]` **entities** - Optional: Message [entities](https://core.telegram.org/api/entities) for styled text * * @param array $params Parameters * * @return bool */ public function saveDraft($params); /** * Return all message [drafts](https://core.telegram.org/api/drafts). * Returns all the latest [updateDraftMessage](https://docs.madelineproto.xyz/API_docs/constructors/updateDraftMessage.html) updates related to all chats with drafts. * * @return Updates */ public function getAllDrafts(); /** * Get featured stickers. * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.FeaturedStickers */ public function getFeaturedStickers($params); /** * Mark new featured stickers as read. * * Parameters: * * `[long]` **id** - IDs of stickersets to mark as read * * @param array $params Parameters * * @return bool */ public function readFeaturedStickers($params); /** * Get recent stickers. * * Parameters: * * `boolean` **attached** - Optional: Get stickers recently attached to photo or video files * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.RecentStickers */ public function getRecentStickers($params); /** * Add/remove sticker from recent stickers list. * * Parameters: * * `boolean` **attached** - Optional: Whether to add/remove stickers recently attached to photo or video files * * `InputDocument` **id** - Sticker * * `Bool` **unsave** - Whether to save or unsave the sticker * * @param array $params Parameters * * @return bool */ public function saveRecentSticker($params); /** * Clear recent stickers. * * Parameters: * * `boolean` **attached** - Optional: Set this flag to clear the list of stickers recently attached to photo or video files * * @param array $params Parameters * * @return bool */ public function clearRecentStickers($params); /** * Get all archived stickers. * * Parameters: * * `boolean` **masks** - Optional: Get [mask stickers](https://core.telegram.org/api/stickers#mask-stickers) * * `boolean` **emojis** - Optional: Get [custom emoji stickers](https://core.telegram.org/api/custom-emoji) * * `long` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.ArchivedStickers */ public function getArchivedStickers($params); /** * Get installed mask stickers. * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.AllStickers */ public function getMaskStickers($params); /** * Get stickers attached to a photo or video. * * Parameters: * * `InputStickeredMedia` **media** - Stickered media * * @param array $params Parameters * * @return of StickerSetCovered[] */ public function getAttachedStickers($params); /** * Use this method to set the score of the specified user in a game sent as a normal message (bots only). * * Parameters: * * `boolean` **edit_message** - Optional: Set this flag if the game message should be automatically edited to include the current scoreboard * * `boolean` **force** - Optional: Set this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters * * `InputPeer` **peer** - Unique identifier of target chat * * `int` **id** - Identifier of the sent message * * `InputUser` **user_id** - User identifier * * `int` **score** - New score * * @param array $params Parameters * * @return Updates */ public function setGameScore($params); /** * Use this method to set the score of the specified user in a game sent as an inline message (bots only). * * Parameters: * * `boolean` **edit_message** - Optional: Set this flag if the game message should be automatically edited to include the current scoreboard * * `boolean` **force** - Optional: Set this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters * * `InputBotInlineMessageID` **id** - ID of the inline message * * `InputUser` **user_id** - User identifier * * `int` **score** - New score * * @param array $params Parameters * * @return bool */ public function setInlineGameScore($params); /** * Get highscores of a game. * * Parameters: * * `InputPeer` **peer** - Where was the game sent * * `int` **id** - ID of message with game media attachment * * `InputUser` **user_id** - Get high scores made by a certain user * * @param array $params Parameters * * @return messages.HighScores */ public function getGameHighScores($params); /** * Get highscores of a game sent using an inline bot. * * Parameters: * * `InputBotInlineMessageID` **id** - ID of inline message * * `InputUser` **user_id** - Get high scores of a certain user * * @param array $params Parameters * * @return messages.HighScores */ public function getInlineGameHighScores($params); /** * Get chats in common with a user. * * Parameters: * * `InputUser` **user_id** - User ID * * `long` **max_id** - Maximum ID of chat to return (see [pagination](https://core.telegram.org/api/offsets)) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.Chats */ public function getCommonChats($params); /** * Get all chats, channels and supergroups. * * Parameters: * * `[long]` **except_ids** - Except these chats/channels/supergroups * * @param array $params Parameters * * @return messages.Chats */ public function getAllChats($params); /** * Get [instant view](https://instantview.telegram.org) page. * * Parameters: * * `string` **url** - URL of IV page to fetch * * `[int]` **hash** - Optional: [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return WebPage */ public function getWebPage($params); /** * Pin/unpin a dialog. * * Parameters: * * `boolean` **pinned** - Optional: Whether to pin or unpin the dialog * * `InputDialogPeer` **peer** - The dialog to pin * * @param array $params Parameters * * @return bool */ public function toggleDialogPin($params); /** * Reorder pinned dialogs. * * Parameters: * * `boolean` **force** - Optional: If set, dialogs pinned server-side but not present in the `order` field will be unpinned. * * `int` **folder_id** - [Peer folder ID, for more info click here](https://core.telegram.org/api/folders#peer-folders) * * `[InputDialogPeer]` **order** - New dialog order * * @param array $params Parameters * * @return bool */ public function reorderPinnedDialogs($params); /** * Get pinned dialogs. * * Parameters: * * `int` **folder_id** - [Peer folder ID, for more info click here](https://core.telegram.org/api/folders#peer-folders) * * @param array $params Parameters * * @return messages.PeerDialogs */ public function getPinnedDialogs($params); /** * If you sent an invoice requesting a shipping address and the parameter is\_flexible was specified, the bot will receive an [updateBotShippingQuery](https://docs.madelineproto.xyz/API_docs/constructors/updateBotShippingQuery.html) update. Use this method to reply to shipping queries. * * Parameters: * * `long` **query_id** - Unique identifier for the query to be answered * * `string` **error** - Optional: Error message in human readable form that explains why it is impossible to complete the order (e.g. "Sorry, delivery to your desired address is unavailable"). Telegram will display this message to the user. * * `[ShippingOption]` **shipping_options** - Optional: A vector of available shipping options. * * @param array $params Parameters * * @return bool */ public function setBotShippingResults($params); /** * Once the user has confirmed their payment and shipping details, the bot receives an [updateBotPrecheckoutQuery](https://docs.madelineproto.xyz/API_docs/constructors/updateBotPrecheckoutQuery.html) update. * Use this method to respond to such pre-checkout queries. * **Note**: Telegram must receive an answer within 10 seconds after the pre-checkout query was sent. * * Parameters: * * `boolean` **success** - Optional: Set this flag if everything is alright (goods are available, etc.) and the bot is ready to proceed with the order, otherwise do not set it, and set the `error` field, instead * * `long` **query_id** - Unique identifier for the query to be answered * * `string` **error** - Optional: Required if the `success` isn't set. Error message in human readable form that explains the reason for failure to proceed with the checkout (e.g. "Sorry, somebody just bought the last of our amazing black T-shirts while you were busy filling out your payment details. Please choose a different color or garment!"). Telegram will display this message to the user. * * @param array $params Parameters * * @return bool */ public function setBotPrecheckoutResults($params); /** * Upload a file and associate it to a chat (without actually sending it to the chat). * * Parameters: * * `InputPeer` **peer** - The chat, can be [inputPeerEmpty](https://docs.madelineproto.xyz/API_docs/constructors/inputPeerEmpty.html) for bots and [inputPeerSelf](https://docs.madelineproto.xyz/API_docs/constructors/inputPeerSelf.html) for users. * * `InputMedia` **media** - File uploaded in chunks as described in [files »](https://core.telegram.org/api/files) * * @param array $params Parameters * * @return MessageMedia */ public function uploadMedia($params); /** * Notify the other user in a private chat that a screenshot of the chat was taken. * * Parameters: * * `InputPeer` **peer** - Other user * * `int` **reply_to_msg_id** - ID of message that was screenshotted, can be 0 * * @param array $params Parameters * * @return Updates */ public function sendScreenshotNotification($params); /** * Get faved stickers. * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.FavedStickers */ public function getFavedStickers($params); /** * Mark or unmark a sticker as favorite. * * Parameters: * * `InputDocument` **id** - Sticker in question * * `Bool` **unfave** - Whether to add or remove a sticker from favorites * * @param array $params Parameters * * @return bool */ public function faveSticker($params); /** * Get unread messages where we were mentioned. * * Parameters: * * `InputPeer` **peer** - Peer where to look for mentions * * `int` **top_msg_id** - Optional: * * `int` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **add_offset** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * `int` **max_id** - Maximum message ID to return, [see pagination](https://core.telegram.org/api/offsets) * * `int` **min_id** - Minimum message ID to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.Messages */ public function getUnreadMentions($params); /** * Mark mentions as read. * * Parameters: * * `InputPeer` **peer** - Dialog * * `int` **top_msg_id** - Optional: * * @param array $params Parameters * * @return messages.AffectedHistory */ public function readMentions($params); /** * Get live location history of a certain user. * * Parameters: * * `InputPeer` **peer** - User * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.Messages */ public function getRecentLocations($params); /** * Send an [album or grouped media](https://core.telegram.org/api/files#albums-grouped-media). * * Parameters: * * `boolean` **silent** - Optional: Whether to send the album silently (no notification triggered) * * `boolean` **background** - Optional: Send in background? * * `boolean` **clear_draft** - Optional: Whether to clear [drafts](https://core.telegram.org/api/drafts) * * `boolean` **noforwards** - Optional: Only for bots, disallows forwarding and saving of the messages, even if the destination chat doesn't have [content protection](https://telegram.org/blog/protected-content-delete-by-date-and-more) enabled * * `boolean` **update_stickersets_order** - Optional: * * `InputPeer` **peer** - The destination chat * * `int` **reply_to_msg_id** - Optional: The message to reply to * * `int` **top_msg_id** - Optional: * * `[InputSingleMedia]` **multi_media** - The medias to send * * `int` **schedule_date** - Optional: Scheduled message date for scheduled messages * * `InputPeer` **send_as** - Optional: Send this message as the specified peer * * @param array $params Parameters * * @return Updates */ public function sendMultiMedia($params); /** * Upload encrypted file and associate it to a secret chat. * * Parameters: * * `InputEncryptedChat` **peer** - The secret chat to associate the file to * * `InputEncryptedFile` **file** - The file * * @param array $params Parameters * * @return EncryptedFile */ public function uploadEncryptedFile($params); /** * Search for stickersets. * * Parameters: * * `boolean` **exclude_featured** - Optional: Exclude featured stickersets from results * * `string` **q** - Query string * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.FoundStickerSets */ public function searchStickerSets($params); /** * Get message ranges for saving the user's chat history. * * @return of MessageRange[] */ public function getSplitRanges(); /** * Manually mark dialog as unread. * * Parameters: * * `boolean` **unread** - Optional: Mark as unread/read * * `InputDialogPeer` **peer** - Dialog * * @param array $params Parameters * * @return bool */ public function markDialogUnread($params); /** * Get dialogs manually marked as unread. * * @return of DialogPeer[] */ public function getDialogUnreadMarks(); /** * Clear all [drafts](https://core.telegram.org/api/drafts). * * @return bool */ public function clearAllDrafts(); /** * Pin a message. * * Parameters: * * `boolean` **silent** - Optional: Pin the message silently, without triggering a notification * * `boolean` **unpin** - Optional: Whether the message should unpinned or pinned * * `boolean` **pm_oneside** - Optional: Whether the message should only be pinned on the local side of a one-to-one chat * * `InputPeer` **peer** - The peer where to pin the message * * `int` **id** - The message to pin or unpin * * @param array $params Parameters * * @return Updates */ public function updatePinnedMessage($params); /** * Vote in a [poll](https://docs.madelineproto.xyz/API_docs/constructors/poll.html). * * Parameters: * * `InputPeer` **peer** - The chat where the poll was sent * * `int` **msg_id** - The message ID of the poll * * `[bytes]` **options** - The options that were chosen * * @param array $params Parameters * * @return Updates */ public function sendVote($params); /** * Get poll results. * * Parameters: * * `InputPeer` **peer** - Peer where the poll was found * * `int` **msg_id** - Message ID of poll message * * @param array $params Parameters * * @return Updates */ public function getPollResults($params); /** * Get count of online users in a chat. * * Parameters: * * `InputPeer` **peer** - The chat * * @param array $params Parameters * * @return ChatOnlines */ public function getOnlines($params); /** * Edit the description of a [group/supergroup/channel](https://core.telegram.org/api/channel). * * Parameters: * * `InputPeer` **peer** - The [group/supergroup/channel](https://core.telegram.org/api/channel). * * `string` **about** - The new description * * @param array $params Parameters * * @return bool */ public function editChatAbout($params); /** * Edit the default banned rights of a [channel/supergroup/group](https://core.telegram.org/api/channel). * * Parameters: * * `InputPeer` **peer** - The peer * * `ChatBannedRights` **banned_rights** - The new global rights * * @param array $params Parameters * * @return Updates */ public function editChatDefaultBannedRights($params); /** * Get localized emoji keywords. * * Parameters: * * `string` **lang_code** - Language code * * @param array $params Parameters * * @return EmojiKeywordsDifference */ public function getEmojiKeywords($params); /** * Get changed emoji keywords. * * Parameters: * * `string` **lang_code** - Language code * * `int` **from_version** - Previous emoji keyword localization version * * @param array $params Parameters * * @return EmojiKeywordsDifference */ public function getEmojiKeywordsDifference($params); /** * Get info about an emoji keyword localization. * * Parameters: * * `[string]` **lang_codes** - Language codes * * @param array $params Parameters * * @return of EmojiLanguage[] */ public function getEmojiKeywordsLanguages($params); /** * Returns an HTTP URL which can be used to automatically log in into translation platform and suggest new emoji replacements. The URL will be valid for 30 seconds after generation. * * Parameters: * * `string` **lang_code** - Language code for which the emoji replacements will be suggested * * @param array $params Parameters * * @return EmojiURL */ public function getEmojiURL($params); /** * Get the number of results that would be found by a [messages.search](https://docs.madelineproto.xyz/API_docs/methods/messages.search.html) call with the same parameters. * * Parameters: * * `InputPeer` **peer** - Peer where to search * * `int` **top_msg_id** - Optional: * * `[MessagesFilter]` **filters** - Search filters * * @param array $params Parameters * * @return of messages.SearchCounter[] */ public function getSearchCounters($params); /** * Get more info about a Seamless Telegram Login authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization). * * Parameters: * * `InputPeer` **peer** - Optional: Peer where the message is located * * `int` **msg_id** - Optional: The message * * `int` **button_id** - Optional: The ID of the button with the authorization request * * `string` **url** - Optional: URL used for [link URL authorization, click here for more info »](https://core.telegram.org/api/url-authorization#link-url-authorization) * * @param array $params Parameters * * @return UrlAuthResult */ public function requestUrlAuth($params); /** * Use this to accept a Seamless Telegram Login authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization). * * Parameters: * * `boolean` **write_allowed** - Optional: Set this flag to allow the bot to send messages to you (if requested) * * `InputPeer` **peer** - Optional: The location of the message * * `int` **msg_id** - Optional: Message ID of the message with the login button * * `int` **button_id** - Optional: ID of the login button * * `string` **url** - Optional: URL used for [link URL authorization, click here for more info »](https://core.telegram.org/api/url-authorization#link-url-authorization) * * @param array $params Parameters * * @return UrlAuthResult */ public function acceptUrlAuth($params); /** * Should be called after the user hides the report spam/add as contact bar of a new chat, effectively prevents the user from executing the actions specified in the [peer's settings](https://docs.madelineproto.xyz/API_docs/constructors/peerSettings.html). * * Parameters: * * `InputPeer` **peer** - Peer * * @param array $params Parameters * * @return bool */ public function hidePeerSettingsBar($params); /** * Get scheduled messages. * * Parameters: * * `InputPeer` **peer** - Peer * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.Messages */ public function getScheduledHistory($params); /** * Get scheduled messages. * * Parameters: * * `InputPeer` **peer** - Peer * * `[int]` **id** - IDs of scheduled messages * * @param array $params Parameters * * @return messages.Messages */ public function getScheduledMessages($params); /** * Send scheduled messages right away. * * Parameters: * * `InputPeer` **peer** - Peer * * `[int]` **id** - Scheduled message IDs * * @param array $params Parameters * * @return Updates */ public function sendScheduledMessages($params); /** * Delete scheduled messages. * * Parameters: * * `InputPeer` **peer** - Peer * * `[int]` **id** - Scheduled message IDs * * @param array $params Parameters * * @return Updates */ public function deleteScheduledMessages($params); /** * Get poll results for non-anonymous polls. * * Parameters: * * `InputPeer` **peer** - Chat where the poll was sent * * `int` **id** - Message ID * * `bytes` **option** - Optional: Get only results for the specified poll `option` * * `string` **offset** - Optional: Offset for results, taken from the `next_offset` field of [messages.votesList](https://docs.madelineproto.xyz/API_docs/constructors/messages.votesList.html), initially an empty string.
Note: if no more results are available, the method call will return an empty `next_offset`; thus, avoid providing the `next_offset` returned in [messages.votesList](https://docs.madelineproto.xyz/API_docs/constructors/messages.votesList.html) if it is empty, to avoid an infinite loop. * * `int` **limit** - Number of results to return * * @param array $params Parameters * * @return messages.VotesList */ public function getPollVotes($params); /** * Apply changes to multiple stickersets. * * Parameters: * * `boolean` **uninstall** - Optional: Uninstall the specified stickersets * * `boolean` **archive** - Optional: Archive the specified stickersets * * `boolean` **unarchive** - Optional: Unarchive the specified stickersets * * `[InputStickerSet]` **stickersets** - Stickersets to act upon * * @param array $params Parameters * * @return bool */ public function toggleStickerSets($params); /** * Get [folders](https://core.telegram.org/api/folders). * * @return of DialogFilter[] */ public function getDialogFilters(); /** * Get [suggested folders](https://core.telegram.org/api/folders). * * @return of DialogFilterSuggested[] */ public function getSuggestedDialogFilters(); /** * Update [folder](https://core.telegram.org/api/folders). * * Parameters: * * `int` **id** - [Folder](https://core.telegram.org/api/folders) ID * * `DialogFilter` **filter** - Optional: [Folder](https://core.telegram.org/api/folders) info * * @param array $params Parameters * * @return bool */ public function updateDialogFilter($params); /** * Reorder [folders](https://core.telegram.org/api/folders). * * Parameters: * * `[int]` **order** - New [folder](https://core.telegram.org/api/folders) order * * @param array $params Parameters * * @return bool */ public function updateDialogFiltersOrder($params); /** * Method for fetching previously featured stickers. * * Parameters: * * `int` **offset** - Offset * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.FeaturedStickers */ public function getOldFeaturedStickers($params); /** * Get messages in a reply thread. * * Parameters: * * `InputPeer` **peer** - Peer * * `int` **msg_id** - Message ID * * `int` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **offset_date** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **add_offset** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * `int` **max_id** - If a positive value was transferred, the method will return only messages with ID smaller than max\_id * * `int` **min_id** - If a positive value was transferred, the method will return only messages with ID bigger than min\_id * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.Messages */ public function getReplies($params); /** * Get [discussion message](https://core.telegram.org/api/threads) from the [associated discussion group](https://core.telegram.org/api/discussion) of a channel to show it on top of the comment section, without actually joining the group. * * Parameters: * * `InputPeer` **peer** - [Channel ID](https://core.telegram.org/api/channel) * * `int` **msg_id** - Message ID * * @param array $params Parameters * * @return messages.DiscussionMessage */ public function getDiscussionMessage($params); /** * Mark a [thread](https://core.telegram.org/api/threads) as read. * * Parameters: * * `InputPeer` **peer** - Group ID * * `int` **msg_id** - ID of message that started the thread * * `int` **read_max_id** - ID up to which thread messages were read * * @param array $params Parameters * * @return bool */ public function readDiscussion($params); /** * [Unpin](https://core.telegram.org/api/pin) all pinned messages. * * Parameters: * * `InputPeer` **peer** - Chat where to unpin * * `int` **top_msg_id** - Optional: * * @param array $params Parameters * * @return messages.AffectedHistory */ public function unpinAllMessages($params); /** * Delete a [chat](https://core.telegram.org/api/channel). * * Parameters: * * `InputPeer` **chat_id** - * * @param array $params Parameters * * @return bool */ public function deleteChat($params); /** * Delete the entire phone call history. * * Parameters: * * `boolean` **revoke** - Optional: Whether to remove phone call history for participants as well * * @param array $params Parameters * * @return messages.AffectedFoundMessages */ public function deletePhoneCallHistory($params); /** * Obtains information about a chat export file, generated by a foreign chat app, [click here for more info about imported chats »](https://core.telegram.org/api/import). * * Parameters: * * `string` **import_head** - Beginning of the message file; up to 100 lines. * * @param array $params Parameters * * @return messages.HistoryImportParsed */ public function checkHistoryImport($params); /** * Import chat history from a foreign chat app into a specific Telegram chat, [click here for more info about imported chats »](https://core.telegram.org/api/import). * * Parameters: * * `InputPeer` **peer** - The Telegram chat where the [history should be imported](https://core.telegram.org/api/import). * * `InputFile` **file** - File with messages to import. * * `int` **media_count** - Number of media files associated with the chat that will be uploaded using [messages.uploadImportedMedia](https://docs.madelineproto.xyz/API_docs/methods/messages.uploadImportedMedia.html). * * @param array $params Parameters * * @return messages.HistoryImport */ public function initHistoryImport($params); /** * Upload a media file associated with an [imported chat, click here for more info »](https://core.telegram.org/api/import). * * Parameters: * * `InputPeer` **peer** - The Telegram chat where the media will be imported * * `long` **import_id** - Identifier of a [history import session](https://core.telegram.org/api/import), returned by [messages.initHistoryImport](https://docs.madelineproto.xyz/API_docs/methods/messages.initHistoryImport.html) * * `string` **file_name** - File name * * `InputMedia` **media** - Media metadata * * @param array $params Parameters * * @return MessageMedia */ public function uploadImportedMedia($params); /** * Complete the [history import process](https://core.telegram.org/api/import), importing all messages into the chat. * To be called only after initializing the import with [messages.initHistoryImport](https://docs.madelineproto.xyz/API_docs/methods/messages.initHistoryImport.html) and uploading all files using [messages.uploadImportedMedia](https://docs.madelineproto.xyz/API_docs/methods/messages.uploadImportedMedia.html). * * Parameters: * * `InputPeer` **peer** - The Telegram chat where the messages should be [imported, click here for more info »](https://core.telegram.org/api/import) * * `long` **import_id** - Identifier of a history import session, returned by [messages.initHistoryImport](https://docs.madelineproto.xyz/API_docs/methods/messages.initHistoryImport.html). * * @param array $params Parameters * * @return bool */ public function startHistoryImport($params); /** * Get info about the chat invites of a specific chat. * * Parameters: * * `boolean` **revoked** - Optional: Whether to fetch revoked chat invites * * `InputPeer` **peer** - Chat * * `InputUser` **admin_id** - Whether to only fetch chat invites from this admin * * `int` **offset_date** - Optional: [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `string` **offset_link** - Optional: [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.ExportedChatInvites */ public function getExportedChatInvites($params); /** * Get info about a chat invite. * * Parameters: * * `InputPeer` **peer** - Chat * * `string` **link** - Invite link * * @param array $params Parameters * * @return messages.ExportedChatInvite */ public function getExportedChatInvite($params); /** * Edit an exported chat invite. * * Parameters: * * `boolean` **revoked** - Optional: Whether to revoke the chat invite * * `InputPeer` **peer** - Chat * * `string` **link** - Invite link * * `int` **expire_date** - Optional: New expiration date * * `int` **usage_limit** - Optional: Maximum number of users that can join using this link * * `Bool` **request_needed** - Optional: Whether admin confirmation is required before admitting each separate user into the chat * * `string` **title** - Optional: Description of the invite link, visible only to administrators * * @param array $params Parameters * * @return messages.ExportedChatInvite */ public function editExportedChatInvite($params); /** * Delete all revoked chat invites. * * Parameters: * * `InputPeer` **peer** - Chat * * `InputUser` **admin_id** - ID of the admin that originally generated the revoked chat invites * * @param array $params Parameters * * @return bool */ public function deleteRevokedExportedChatInvites($params); /** * Delete a chat invite. * * Parameters: * * `InputPeer` **peer** - Peer * * `string` **link** - Invite link * * @param array $params Parameters * * @return bool */ public function deleteExportedChatInvite($params); /** * Get info about chat invites generated by admins. * * Parameters: * * `InputPeer` **peer** - Chat * * @param array $params Parameters * * @return messages.ChatAdminsWithInvites */ public function getAdminsWithInvites($params); /** * Get info about the users that joined the chat using a specific chat invite. * * Parameters: * * `boolean` **requested** - Optional: If set, only returns info about users with pending [join requests »](https://core.telegram.org/api/invites#join-requests) * * `InputPeer` **peer** - Chat * * `string` **link** - Optional: Invite link * * `string` **q** - Optional: Search for a user in the pending [join requests »](https://core.telegram.org/api/invites#join-requests) list: only available when the `requested` flag is set, cannot be used together with a specific `link`. * * `int` **offset_date** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `InputUser` **offset_user** - User ID for [pagination](https://core.telegram.org/api/offsets) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.ChatInviteImporters */ public function getChatInviteImporters($params); /** * Set maximum Time-To-Live of all messages in the specified chat. * * Parameters: * * `InputPeer` **peer** - The dialog * * `int` **period** - Automatically delete all messages sent in the chat after this many seconds * * @param array $params Parameters * * @return Updates */ public function setHistoryTTL($params); /** * Check whether chat history exported from another chat app can be [imported into a specific Telegram chat, click here for more info »](https://core.telegram.org/api/import). * * If the check succeeds, and no RPC errors are returned, a [messages.CheckedHistoryImportPeer](https://docs.madelineproto.xyz/API_docs/types/messages.CheckedHistoryImportPeer.html) constructor will be returned, with a confirmation text to be shown to the user, before actually initializing the import. * * Parameters: * * `InputPeer` **peer** - The chat where we want to [import history »](https://core.telegram.org/api/import). * * @param array $params Parameters * * @return messages.CheckedHistoryImportPeer */ public function checkHistoryImportPeer($params); /** * Change the chat theme of a certain chat. * * Parameters: * * `InputPeer` **peer** - Private chat where to change theme * * `string` **emoticon** - Emoji, identifying a specific chat theme; a list of chat themes can be fetched using [account.getChatThemes](https://docs.madelineproto.xyz/API_docs/methods/account.getChatThemes.html) * * @param array $params Parameters * * @return Updates */ public function setChatTheme($params); /** * Get which users read a specific message: only available for groups and supergroups with less than [`chat_read_mark_size_threshold` members](https://core.telegram.org/api/config#chat-read-mark-size-threshold), read receipts will be stored for [`chat_read_mark_expire_period` seconds after the message was sent](https://core.telegram.org/api/config#chat-read-mark-expire-period), see [client configuration for more info »](https://core.telegram.org/api/config#client-configuration). * * Parameters: * * `InputPeer` **peer** - Dialog * * `int` **msg_id** - Message ID * * @param array $params Parameters * * @return of long[] */ public function getMessageReadParticipants($params); /** * Returns information about the next messages of the specified type in the chat split by days. * * Returns the results in reverse chronological order. * Can return partial results for the last returned day. * * Parameters: * * `InputPeer` **peer** - Peer where to search * * `MessagesFilter` **filter** - Message filter, [inputMessagesFilterEmpty](https://docs.madelineproto.xyz/API_docs/constructors/inputMessagesFilterEmpty.html), [inputMessagesFilterMyMentions](https://docs.madelineproto.xyz/API_docs/constructors/inputMessagesFilterMyMentions.html) filters are not supported by this method. * * `int` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **offset_date** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.SearchResultsCalendar */ public function getSearchResultsCalendar($params); /** * Returns sparse positions of messages of the specified type in the chat to be used for shared media scroll implementation. * * Returns the results in reverse chronological order (i.e., in order of decreasing message\_id). * * Parameters: * * `InputPeer` **peer** - Peer where to search * * `MessagesFilter` **filter** - Message filter, [inputMessagesFilterEmpty](https://docs.madelineproto.xyz/API_docs/constructors/inputMessagesFilterEmpty.html), [inputMessagesFilterMyMentions](https://docs.madelineproto.xyz/API_docs/constructors/inputMessagesFilterMyMentions.html) filters are not supported by this method. * * `int` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.SearchResultsPositions */ public function getSearchResultsPositions($params); /** * Dismiss or approve a chat [join request](https://core.telegram.org/api/invites#join-requests) related to a specific chat or channel. * * Parameters: * * `boolean` **approved** - Optional: Whether to dismiss or approve the chat [join request »](https://core.telegram.org/api/invites#join-requests) * * `InputPeer` **peer** - The chat or channel * * `InputUser` **user_id** - The user whose [join request »](https://core.telegram.org/api/invites#join-requests) should be dismissed or approved * * @param array $params Parameters * * @return Updates */ public function hideChatJoinRequest($params); /** * Dismiss or approve all [join requests](https://core.telegram.org/api/invites#join-requests) related to a specific chat or channel. * * Parameters: * * `boolean` **approved** - Optional: Whether to dismiss or approve all chat [join requests »](https://core.telegram.org/api/invites#join-requests) * * `InputPeer` **peer** - The chat or channel * * `string` **link** - Optional: Only dismiss or approve [join requests »](https://core.telegram.org/api/invites#join-requests) initiated using this invite link * * @param array $params Parameters * * @return Updates */ public function hideAllChatJoinRequests($params); /** * Enable or disable [content protection](https://telegram.org/blog/protected-content-delete-by-date-and-more) on a channel or chat. * * Parameters: * * `InputPeer` **peer** - The chat or channel * * `Bool` **enabled** - Enable or disable content protection * * @param array $params Parameters * * @return Updates */ public function toggleNoForwards($params); /** * Change the default peer that should be used when sending messages to a specific group. * * Parameters: * * `InputPeer` **peer** - Group * * `InputPeer` **send_as** - The default peer that should be used when sending messages to the group * * @param array $params Parameters * * @return bool */ public function saveDefaultSendAs($params); /** * React to message. * * Parameters: * * `boolean` **big** - Optional: Whether a bigger and longer reaction should be shown * * `boolean` **add_to_recent** - Optional: * * `InputPeer` **peer** - Peer * * `int` **msg_id** - Message ID to react to * * `[Reaction]` **reaction** - Optional: * * @param array $params Parameters * * @return Updates */ public function sendReaction($params); /** * Get [message reactions »](https://core.telegram.org/api/reactions). * * Parameters: * * `InputPeer` **peer** - Peer * * `[int]` **id** - Message IDs * * @param array $params Parameters * * @return Updates */ public function getMessagesReactions($params); /** * Get [message reaction](https://core.telegram.org/api/reactions) list, along with the sender of each reaction. * * Parameters: * * `InputPeer` **peer** - Peer * * `int` **id** - Message ID * * `Reaction` **reaction** - Optional: * * `string` **offset** - Optional: Offset (typically taken from the `next_offset` field of the returned [messages.MessageReactionsList](https://docs.madelineproto.xyz/API_docs/types/messages.MessageReactionsList.html)) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.MessageReactionsList */ public function getMessageReactionsList($params); /** * Change the set of [message reactions »](https://core.telegram.org/api/reactions) that can be used in a certain group, supergroup or channel. * * Parameters: * * `InputPeer` **peer** - Group where to apply changes * * `ChatReactions` **available_reactions** - * * @param array $params Parameters * * @return Updates */ public function setChatAvailableReactions($params); /** * Obtain available [message reactions »](https://core.telegram.org/api/reactions). * * Parameters: * * `[int]` **hash** - Optional: [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.AvailableReactions */ public function getAvailableReactions($params); /** * Change default emoji reaction to use in the quick reaction menu: the value is synced across devices and can be fetched using [help.getConfig, `reactions_default` field](https://docs.madelineproto.xyz/API_docs/methods/help.getConfig.html). * * Parameters: * * `Reaction` **reaction** - * * @param array $params Parameters * * @return bool */ public function setDefaultReaction($params); /** * Translate a given text. * * Parameters: * * `InputPeer` **peer** - Optional: If the text is a chat message, the peer ID * * `int` **msg_id** - Optional: If the text is a chat message, the message ID * * `string` **text** - Optional: The text to translate * * `string` **from_lang** - Optional: Two-letter ISO 639-1 language code of the language from which the message is translated, if not set will be autodetected * * `string` **to_lang** - Two-letter ISO 639-1 language code of the language to which the message is translated * * @param array $params Parameters * * @return messages.TranslatedText */ public function translateText($params); /** * Get unread reactions to messages you sent. * * Parameters: * * `InputPeer` **peer** - Peer * * `int` **top_msg_id** - Optional: * * `int` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **add_offset** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * `int` **max_id** - Only return reactions for messages up until this message ID * * `int` **min_id** - Only return reactions for messages starting from this message ID * * @param array $params Parameters * * @return messages.Messages */ public function getUnreadReactions($params); /** * Mark [message reactions »](https://core.telegram.org/api/reactions) as read. * * Parameters: * * `InputPeer` **peer** - Peer * * `int` **top_msg_id** - Optional: * * @param array $params Parameters * * @return messages.AffectedHistory */ public function readReactions($params); /** * View and search recently sent media. * This method does not support pagination. * * Parameters: * * `string` **q** - Optional search query * * `MessagesFilter` **filter** - Message filter * * `int` **limit** - Maximum number of results to return (max 100). * * @param array $params Parameters * * @return messages.Messages */ public function searchSentMedia($params); /** * Returns installed attachment menu [bot web apps »](https://core.telegram.org/api/bots/attach). * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return AttachMenuBots */ public function getAttachMenuBots($params); /** * Returns attachment menu entry for a [bot web app that can be launched from the attachment menu »](https://core.telegram.org/api/bots/attach). * * Parameters: * * `InputUser` **bot** - Bot ID * * @param array $params Parameters * * @return AttachMenuBotsBot */ public function getAttachMenuBot($params); /** * Enable or disable [web bot attachment menu »](https://core.telegram.org/api/bots/attach). * * Parameters: * * `boolean` **write_allowed** - Optional: * * `InputUser` **bot** - Bot ID * * `Bool` **enabled** - Toggle * * @param array $params Parameters * * @return bool */ public function toggleBotInAttachMenu($params); /** * Open a [bot web app](https://core.telegram.org/bots/webapps), sending over user information after user confirmation. * * After calling this method, until the user closes the webview, [messages.prolongWebView](https://docs.madelineproto.xyz/API_docs/methods/messages.prolongWebView.html) must be called every 60 seconds. * * Parameters: * * `boolean` **from_bot_menu** - Optional: Whether the webview was opened by clicking on the bot's [menu button »](https://core.telegram.org/api/bots/menu). * * `boolean` **silent** - Optional: Whether the inline message that will be sent by the bot on behalf of the user once the web app interaction is [terminated](https://docs.madelineproto.xyz/API_docs/methods/messages.sendWebViewResultMessage.html) should be sent silently (no notifications for the receivers). * * `InputPeer` **peer** - Dialog where the web app is being opened, and where the resulting message will be sent (see the [docs for more info »](https://core.telegram.org/api/bots/webapps)). * * `InputUser` **bot** - Bot that owns the [web app](https://core.telegram.org/api/bots/webapps) * * `string` **url** - Optional: [Web app URL](https://core.telegram.org/api/bots/webapps) * * `string` **start_param** - Optional: If the web app was opened from the attachment menu using a [attachment menu deep link](https://core.telegram.org/api/links#bot-attachment-menu-links), `start_param` should contain the `data` from the `startattach` parameter. * * `DataJSON` **theme_params** - Optional: Theme parameters for the web app * * `string` **platform** - * * `int` **reply_to_msg_id** - Optional: Whether the inline message that will be sent by the bot on behalf of the user once the web app interaction is [terminated](https://docs.madelineproto.xyz/API_docs/methods/messages.sendWebViewResultMessage.html) should be sent in reply to this message ID. * * `int` **top_msg_id** - Optional: * * `InputPeer` **send_as** - Optional: Open the web app as the specified peer, sending the resulting the message as the specified peer. * * @param array $params Parameters * * @return WebViewResult */ public function requestWebView($params); /** * Indicate to the server (from the user side) that the user is still using a web app. * * Parameters: * * `boolean` **silent** - Optional: Whether the inline message that will be sent by the bot on behalf of the user once the web app interaction is [terminated](https://docs.madelineproto.xyz/API_docs/methods/messages.sendWebViewResultMessage.html) should be sent silently (no notifications for the receivers). * * `InputPeer` **peer** - Dialog where the web app was opened. * * `InputUser` **bot** - Bot that owns the [web app](https://core.telegram.org/api/bots/webapps) * * `long` **query_id** - Web app interaction ID obtained from [messages.requestWebView](https://docs.madelineproto.xyz/API_docs/methods/messages.requestWebView.html) * * `int` **reply_to_msg_id** - Optional: Whether the inline message that will be sent by the bot on behalf of the user once the web app interaction is [terminated](https://docs.madelineproto.xyz/API_docs/methods/messages.sendWebViewResultMessage.html) should be sent in reply to this message ID. * * `int` **top_msg_id** - Optional: * * `InputPeer` **send_as** - Optional: Open the web app as the specified peer * * @param array $params Parameters * * @return bool */ public function prolongWebView($params); /** * Open a [bot web app](https://core.telegram.org/api/bots/webapps). * * Parameters: * * `InputUser` **bot** - Bot that owns the webapp * * `string` **url** - Web app URL * * `DataJSON` **theme_params** - Optional: Theme parameters * * `string` **platform** - * * @param array $params Parameters * * @return SimpleWebViewResult */ public function requestSimpleWebView($params); /** * Terminate webview interaction started with [messages.requestWebView](https://docs.madelineproto.xyz/API_docs/methods/messages.requestWebView.html), sending the specified message to the chat on behalf of the user. * * Parameters: * * `string` **bot_query_id** - Webview interaction ID obtained from [messages.requestWebView](https://docs.madelineproto.xyz/API_docs/methods/messages.requestWebView.html) * * `InputBotInlineResult` **result** - Message to send * * @param array $params Parameters * * @return WebViewMessageSent */ public function sendWebViewResultMessage($params); /** * Used by the user to relay data from an opened [reply keyboard bot web app](https://core.telegram.org/api/bots/webapps) to the bot that owns it. * * Parameters: * * `InputUser` **bot** - Bot that owns the web app * * `string` **button_text** - Text of the [keyboardButtonSimpleWebView](https://docs.madelineproto.xyz/API_docs/constructors/keyboardButtonSimpleWebView.html) that was pressed to open the web app. * * `string` **data** - Data to relay to the bot, obtained from a [`web_app_data_send` JS event](https://core.telegram.org/api/web-events#web-app-data-send). * * @param array $params Parameters * * @return Updates */ public function sendWebViewData($params); /** * [Transcribe voice message](https://core.telegram.org/api/transcribe). * * Parameters: * * `InputPeer` **peer** - Peer ID where the voice message was sent * * `int` **msg_id** - Voice message ID * * @param array $params Parameters * * @return messages.TranscribedAudio */ public function transcribeAudio($params); /** * Rate [transcribed voice message](https://core.telegram.org/api/transcribe). * * Parameters: * * `InputPeer` **peer** - Peer where the voice message was sent * * `int` **msg_id** - Message ID * * `long` **transcription_id** - Transcription ID * * `Bool` **good** - Whether the transcription was correct * * @param array $params Parameters * * @return bool */ public function rateTranscribedAudio($params); /** * Fetch [custom emoji stickers »](https://core.telegram.org/api/custom-emoji). * * Returns a list of [documents](https://docs.madelineproto.xyz/API_docs/constructors/document.html) with the animated custom emoji in TGS format, and a [documentAttributeCustomEmoji](https://docs.madelineproto.xyz/API_docs/constructors/documentAttributeCustomEmoji.html) attribute with the original emoji and info about the emoji stickerset this custom emoji belongs to. * * Parameters: * * `[long]` **document_id** - [Custom emoji](https://core.telegram.org/api/custom-emoji) IDs from a [messageEntityCustomEmoji](https://docs.madelineproto.xyz/API_docs/constructors/messageEntityCustomEmoji.html). * * @param array $params Parameters * * @return of Document[] */ public function getCustomEmojiDocuments($params); /** * Gets the list of currently installed [custom emoji stickersets](https://core.telegram.org/api/custom-emoji). * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.AllStickers */ public function getEmojiStickers($params); /** * Gets featured custom emoji stickersets. * * Parameters: * * `long` **hash** - [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return messages.FeaturedStickers */ public function getFeaturedEmojiStickers($params); /** * * * Parameters: * * `InputPeer` **peer** - * * `int` **id** - * * `InputPeer` **reaction_peer** -. * * @param array $params Parameters * * @return bool */ public function reportReaction($params); /** * * * Parameters: * * `int` **limit** - * * `long` **hash** -. * * @param array $params Parameters * * @return messages.Reactions */ public function getTopReactions($params); /** * * * Parameters: * * `int` **limit** - * * `long` **hash** -. * * @param array $params Parameters * * @return messages.Reactions */ public function getRecentReactions($params); /** * * * @return bool */ public function clearRecentReactions(); /** * * * Parameters: * * `InputPeer` **peer** - * * `[int]` **id** -. * * @param array $params Parameters * * @return Updates */ public function getExtendedMedia($params); /** * * * Parameters: * * `int` **period** -. * * @param array $params Parameters * * @return bool */ public function setDefaultHistoryTTL($params); /** * * * @return DefaultHistoryTTL */ public function getDefaultHistoryTTL(); } interface updates { /** * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates. * * @return updates.State */ public function getState(); /** * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates. * * Parameters: * * `int` **pts** - PTS, see [updates](https://core.telegram.org/api/updates). * * `int` **pts_total_limit** - Optional: For fast updating: if provided and `pts + pts_total_limit < remote pts`, [updates.differenceTooLong](https://docs.madelineproto.xyz/API_docs/constructors/updates.differenceTooLong.html) will be returned.
Simply tells the server to not return the difference if it is bigger than `pts_total_limit`
If the remote pts is too big (> ~4000000), this field will default to 1000000 * * `int` **date** - date, see [updates](https://core.telegram.org/api/updates). * * `int` **qts** - QTS, see [updates](https://core.telegram.org/api/updates). * * @param array $params Parameters * * @return updates.Difference */ public function getDifference($params); /** * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates. * * Parameters: * * `boolean` **force** - Optional: Set to true to skip some possibly unneeded updates and reduce server-side load * * `InputChannel` **channel** - The channel * * `ChannelMessagesFilter` **filter** - Messsage filter * * `int` **pts** - Persistent timestamp (see [updates](https://core.telegram.org/api/updates)) * * `int` **limit** - How many updates to fetch, max `100000`
Ordinary (non-bot) users are supposed to pass `10-100` * * @param array $params Parameters * * @return updates.ChannelDifference */ public function getChannelDifference($params); } interface photos { /** * Installs a previously uploaded photo as a profile photo. * * Parameters: * * `boolean` **fallback** - Optional: * * `InputPhoto` **id** - Input photo * * @param array $params Parameters * * @return photos.Photo */ public function updateProfilePhoto($params); /** * Updates current user profile photo. * * Parameters: * * `boolean` **fallback** - Optional: * * `InputFile` **file** - Optional: File saved in parts by means of [upload.saveFilePart](https://docs.madelineproto.xyz/API_docs/methods/upload.saveFilePart.html) method * * `InputFile` **video** - Optional: [Animated profile picture](https://core.telegram.org/api/files#animated-profile-pictures) video * * `double` **video_start_ts** - Optional: Floating point UNIX timestamp in seconds, indicating the frame of the video that should be used as static preview. * * @param array $params Parameters * * @return photos.Photo */ public function uploadProfilePhoto($params); /** * Deletes profile photos. The method returns a list of successfully deleted photo IDs. * * Parameters: * * `[InputPhoto]` **id** - Input photos to delete * * @param array $params Parameters * * @return of long[] */ public function deletePhotos($params); /** * Returns the list of user photos. * * Parameters: * * `InputUser` **user_id** - User ID * * `int` **offset** - Number of list elements to be skipped * * `long` **max_id** - If a positive value was transferred, the method will return only photos with IDs less than the set one * * `int` **limit** - Number of list elements to be returned * * @param array $params Parameters * * @return photos.Photos */ public function getUserPhotos($params); /** * * * Parameters: * * `boolean` **suggest** - Optional: * * `boolean` **save** - Optional: * * `InputUser` **user_id** - * * `InputFile` **file** - Optional: * * `InputFile` **video** - Optional: * * `double` **video_start_ts** - Optional:. * * @param array $params Parameters * * @return photos.Photo */ public function uploadContactProfilePhoto($params); } interface upload { /** * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. * * Parameters: * * `long` **file_id** - Random file identifier created by the client * * `int` **file_part** - Numerical order of a part * * `bytes` **bytes** - Binary data, contend of a part * * @param array $params Parameters * * @return bool */ public function saveFilePart($params); /** * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. * * Parameters: * * `boolean` **precise** - Optional: Disable some checks on limit and offset values, useful for example to stream videos by keyframes * * `boolean` **cdn_supported** - Optional: Whether the current client supports [CDN downloads](https://core.telegram.org/cdn) * * `InputFileLocation` **location** - File location * * `long` **offset** - Number of bytes to be skipped * * `int` **limit** - Number of bytes to be returned * * @param array $params Parameters * * @return upload.File */ public function getFile($params); /** * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. * * Parameters: * * `long` **file_id** - Random file id, created by the client * * `int` **file_part** - Part sequence number * * `int` **file_total_parts** - Total number of parts * * `bytes` **bytes** - Binary data, part contents * * @param array $params Parameters * * @return bool */ public function saveBigFilePart($params); /** * Returns content of a web file, by proxying the request through telegram, see the [webfile docs for more info](https://core.telegram.org/api/files#downloading-webfiles). * * **Note**: the query must be sent to the DC specified in the `webfile_dc_id` [MTProto configuration field](https://core.telegram.org/api/config#mtproto-configuration). * * Parameters: * * `InputWebFileLocation` **location** - The file to download * * `int` **offset** - Number of bytes to be skipped * * `int` **limit** - Number of bytes to be returned * * @param array $params Parameters * * @return upload.WebFile */ public function getWebFile($params); /** * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. * * Parameters: * * `bytes` **file_token** - File token * * `long` **offset** - Offset of chunk to download * * `int` **limit** - Length of chunk to download * * @param array $params Parameters * * @return upload.CdnFile */ public function getCdnFile($params); /** * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. * * Parameters: * * `bytes` **file_token** - File token * * `bytes` **request_token** - Request token * * @param array $params Parameters * * @return of FileHash[] */ public function reuploadCdnFile($params); /** * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. * * Parameters: * * `bytes` **file_token** - File * * `long` **offset** - Offset from which to start getting hashes * * @param array $params Parameters * * @return of FileHash[] */ public function getCdnFileHashes($params); /** * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. * * Parameters: * * `InputFileLocation` **location** - File * * `long` **offset** - Offset from which to get file hashes * * @param array $params Parameters * * @return of FileHash[] */ public function getFileHashes($params); } interface help { /** * Returns current configuration, including data center configuration. * * @return Config */ public function getConfig(); /** * Returns info on data center nearest to the user. * * @return NearestDc */ public function getNearestDc(); /** * Returns information on update availability for the current application. * * Parameters: * * `string` **source** - Source * * @param array $params Parameters * * @return help.AppUpdate */ public function getAppUpdate($params); /** * Returns localized text of a text message with an invitation. * * @return help.InviteText */ public function getInviteText(); /** * Returns the support user for the "ask a question" feature. * * @return help.Support */ public function getSupport(); /** * Get changelog of current app. * Typically, an [updates](https://docs.madelineproto.xyz/API_docs/constructors/updates.html) constructor will be returned, containing one or more [updateServiceNotification](https://docs.madelineproto.xyz/API_docs/constructors/updateServiceNotification.html) updates with app-specific changelogs. * * Parameters: * * `string` **prev_app_version** - Previous app version * * @param array $params Parameters * * @return Updates */ public function getAppChangelog($params); /** * Informs the server about the number of pending bot updates if they haven't been processed for a long time; for bots only. * * Parameters: * * `int` **pending_updates_count** - Number of pending updates * * `string` **message** - Error message, if present * * @param array $params Parameters * * @return bool */ public function setBotUpdatesStatus($params); /** * Get configuration for [CDN](https://core.telegram.org/cdn) file downloads. * * @return CdnConfig */ public function getCdnConfig(); /** * Get recently used `t.me` links. * * When installing official applications from "Download Telegram" buttons present in [t.me](https://t.me) pages, a referral parameter is passed to applications after installation. * If, after downloading the application, the user creates a new account (instead of logging into an existing one), the referral parameter should be imported using this method, which returns the [t.me](https://t.me) pages the user recently opened, before installing Telegram. * * Parameters: * * `string` **referer** - Referrer * * @param array $params Parameters * * @return help.RecentMeUrls */ public function getRecentMeUrls($params); /** * Look for updates of telegram's terms of service. * * @return help.TermsOfServiceUpdate */ public function getTermsOfServiceUpdate(); /** * Accept the new terms of service. * * Parameters: * * `DataJSON` **id** - ID of terms of service * * @param array $params Parameters * * @return bool */ public function acceptTermsOfService($params); /** * Get info about an unsupported deep link, see [here for more info »](https://core.telegram.org/api/links#unsupported-links). * * Parameters: * * `string` **path** - Path component of a `tg:` link * * @param array $params Parameters * * @return help.DeepLinkInfo */ public function getDeepLinkInfo($params); /** * Get app-specific configuration, see [client configuration](https://core.telegram.org/api/config#client-configuration) for more info on the result. * * @return JSONValue */ public function getAppConfig(); /** * Saves logs of application on the server. * * Parameters: * * `[InputAppEvent]` **events** - List of input events * * @param array $params Parameters * * @return bool */ public function saveAppLog($params); /** * Get [passport](https://core.telegram.org/passport) configuration. * * Parameters: * * `[int]` **hash** - Optional: [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return help.PassportConfig */ public function getPassportConfig($params); /** * Get localized name of the telegram support user. * * @return help.SupportName */ public function getSupportName(); /** * Internal use. * * Parameters: * * `InputUser` **user_id** - User ID * * @param array $params Parameters * * @return help.UserInfo */ public function getUserInfo($params); /** * Internal use. * * Parameters: * * `InputUser` **user_id** - User * * `string` **message** - Message * * `[MessageEntity]` **entities** - [Message entities for styled text](https://core.telegram.org/api/entities) * * @param array $params Parameters * * @return help.UserInfo */ public function editUserInfo($params); /** * Get MTProxy/Public Service Announcement information. * * @return help.PromoData */ public function getPromoData(); /** * Hide MTProxy/Public Service Announcement information. * * Parameters: * * `InputPeer` **peer** - Peer to hide * * @param array $params Parameters * * @return bool */ public function hidePromoData($params); /** * Dismiss a [suggestion, see here for more info »](https://core.telegram.org/api/config#suggestions). * * Parameters: * * `InputPeer` **peer** - In the case of pending suggestions in [channels](https://docs.madelineproto.xyz/API_docs/constructors/channelFull.html), the channel ID. * * `string` **suggestion** - [Suggestion, see here for more info »](https://core.telegram.org/api/config#suggestions). * * @param array $params Parameters * * @return bool */ public function dismissSuggestion($params); /** * Get name, ISO code, localized name and phone codes/patterns of all available countries. * * Parameters: * * `string` **lang_code** - Language code of the current user * * `[int]` **hash** - Optional: [Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation) * * @param array $params Parameters * * @return help.CountriesList */ public function getCountriesList($params); /** * Get Telegram Premium promotion information. * * @return help.PremiumPromo */ public function getPremiumPromo(); } interface channels { /** * Mark [channel/supergroup](https://core.telegram.org/api/channel) history as read. * * Parameters: * * `InputChannel` **channel** - [Channel/supergroup](https://core.telegram.org/api/channel) * * `int` **max_id** - ID of message up to which messages should be marked as read * * @param array $params Parameters * * @return bool */ public function readHistory($params); /** * Delete messages in a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: * * `InputChannel` **channel** - [Channel/supergroup](https://core.telegram.org/api/channel) * * `[int]` **id** - IDs of messages to delete * * @param array $params Parameters * * @return messages.AffectedMessages */ public function deleteMessages($params); /** * Reports some messages from a user in a supergroup as spam; requires administrator rights in the supergroup. * * Parameters: * * `InputChannel` **channel** - Supergroup * * `InputPeer` **participant** - Participant whose messages should be reported * * `[int]` **id** - IDs of spam messages * * @param array $params Parameters * * @return bool */ public function reportSpam($params); /** * Please use the [event handler](https://docs.madelineproto.xyz/docs/UPDATES.html). * * Parameters: * * `InputChannel` **channel** - Channel/supergroup * * `[InputMessage]` **id** - IDs of messages to get * * @param array $params Parameters * * @return messages.Messages */ public function getMessages($params); /** * Get the participants of a [supergroup/channel](https://core.telegram.org/api/channel). * * Parameters: * * `InputChannel` **channel** - Channel * * `ChannelParticipantsFilter` **filter** - Which participant types to fetch * * `int` **offset** - [Offset](https://core.telegram.org/api/offsets) * * `int` **limit** - [Limit](https://core.telegram.org/api/offsets) * * `long` **hash** - [Hash](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return channels.ChannelParticipants */ public function getParticipants($params); /** * Get info about a [channel/supergroup](https://core.telegram.org/api/channel) participant. * * Parameters: * * `InputChannel` **channel** - Channel/supergroup * * `InputPeer` **participant** - Participant to get info about * * @param array $params Parameters * * @return channels.ChannelParticipant */ public function getParticipant($params); /** * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info). * * Parameters: * * `[InputChannel]` **id** - IDs of channels/supergroups to get info about * * @param array $params Parameters * * @return messages.Chats */ public function getChannels($params); /** * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info). * * Parameters: * * `InputChannel` **channel** - The [channel](https://core.telegram.org/api/channel#channels), [supergroup](https://core.telegram.org/api/channel#supergroups) or [gigagroup](https://core.telegram.org/api/channel#gigagroups) to get info about * * @param array $params Parameters * * @return messages.ChatFull */ public function getFullChannel($params); /** * Create a [supergroup/channel](https://core.telegram.org/api/channel). * * Parameters: * * `boolean` **broadcast** - Optional: Whether to create a [channel](https://core.telegram.org/api/channel) * * `boolean` **megagroup** - Optional: Whether to create a [supergroup](https://core.telegram.org/api/channel) * * `boolean` **for_import** - Optional: Whether the supergroup is being created to import messages from a foreign chat service using [messages.initHistoryImport](https://docs.madelineproto.xyz/API_docs/methods/messages.initHistoryImport.html) * * `string` **title** - Channel title * * `string` **about** - Channel description * * `InputGeoPoint` **geo_point** - Optional: Geogroup location * * `string` **address** - Optional: Geogroup address * * `int` **ttl_period** - Optional: * * @param array $params Parameters * * @return Updates */ public function createChannel($params); /** * Modify the admin rights of a user in a [supergroup/channel](https://core.telegram.org/api/channel). * * Parameters: * * `InputChannel` **channel** - The [supergroup/channel](https://core.telegram.org/api/channel). * * `InputUser` **user_id** - The ID of the user whose admin rights should be modified * * `ChatAdminRights` **admin_rights** - The admin rights * * `string` **rank** - Indicates the role (rank) of the admin in the group: just an arbitrary string * * @param array $params Parameters * * @return Updates */ public function editAdmin($params); /** * Edit the name of a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: * * `InputChannel` **channel** - Channel/supergroup * * `string` **title** - New name * * @param array $params Parameters * * @return Updates */ public function editTitle($params); /** * Change the photo of a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: * * `InputChannel` **channel** - Channel/supergroup whose photo should be edited * * `InputChatPhoto` **photo** - New photo * * @param array $params Parameters * * @return Updates */ public function editPhoto($params); /** * Check if a username is free and can be assigned to a channel/supergroup. * * Parameters: * * `InputChannel` **channel** - The [channel/supergroup](https://core.telegram.org/api/channel) that will assigned the specified username * * `string` **username** - The username to check * * @param array $params Parameters * * @return bool */ public function checkUsername($params); /** * Change the username of a supergroup/channel. * * Parameters: * * `InputChannel` **channel** - Channel * * `string` **username** - New username * * @param array $params Parameters * * @return bool */ public function updateUsername($params); /** * Join a channel/supergroup. * * Parameters: * * `InputChannel` **channel** - Channel/supergroup to join * * @param array $params Parameters * * @return Updates */ public function joinChannel($params); /** * Leave a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: * * `InputChannel` **channel** - [Channel/supergroup](https://core.telegram.org/api/channel) to leave * * @param array $params Parameters * * @return Updates */ public function leaveChannel($params); /** * Invite users to a channel/supergroup. * * Parameters: * * `InputChannel` **channel** - Channel/supergroup * * `[InputUser]` **users** - Users to invite * * @param array $params Parameters * * @return Updates */ public function inviteToChannel($params); /** * Delete a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: * * `InputChannel` **channel** - [Channel/supergroup](https://core.telegram.org/api/channel) to delete * * @param array $params Parameters * * @return Updates */ public function deleteChannel($params); /** * Get link and embed info of a message in a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: * * `boolean` **grouped** - Optional: Whether to include other grouped media (for albums) * * `boolean` **thread** - Optional: Whether to also include a thread ID, if available, inside of the link * * `InputChannel` **channel** - Channel * * `int` **id** - Message ID * * @param array $params Parameters * * @return ExportedMessageLink */ public function exportMessageLink($params); /** * Enable/disable message signatures in channels. * * Parameters: * * `InputChannel` **channel** - Channel * * `Bool` **enabled** - Value * * @param array $params Parameters * * @return Updates */ public function toggleSignatures($params); /** * Get [channels/supergroups/geogroups](https://core.telegram.org/api/channel) we're admin in. Usually called when the user exceeds the [limit](https://docs.madelineproto.xyz/API_docs/constructors/config.html) for owned public [channels/supergroups/geogroups](https://core.telegram.org/api/channel), and the user is given the choice to remove one of his channels/supergroups/geogroups. * * Parameters: * * `boolean` **by_location** - Optional: Get geogroups * * `boolean` **check_limit** - Optional: If set and the user has reached the limit of owned public [channels/supergroups/geogroups](https://core.telegram.org/api/channel), instead of returning the channel list one of the specified [errors](#possible-errors) will be returned.
Useful to check if a new public channel can indeed be created, even before asking the user to enter a channel username to use in [channels.checkUsername](https://docs.madelineproto.xyz/API_docs/methods/channels.checkUsername.html)/[channels.updateUsername](https://docs.madelineproto.xyz/API_docs/methods/channels.updateUsername.html). * * @param array $params Parameters * * @return messages.Chats */ public function getAdminedPublicChannels($params); /** * Ban/unban/kick a user in a [supergroup/channel](https://core.telegram.org/api/channel). * * Parameters: * * `InputChannel` **channel** - The [supergroup/channel](https://core.telegram.org/api/channel). * * `InputPeer` **participant** - Participant to ban * * `ChatBannedRights` **banned_rights** - The banned rights * * @param array $params Parameters * * @return Updates */ public function editBanned($params); /** * Get the admin log of a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: * * `InputChannel` **channel** - Channel * * `string` **q** - Search query, can be empty * * `ChannelAdminLogEventsFilter` **events_filter** - Optional: Event filter * * `[InputUser]` **admins** - Optional: Only show events from these admins * * `long` **max_id** - Maximum ID of message to return (see [pagination](https://core.telegram.org/api/offsets)) * * `long` **min_id** - Minimum ID of message to return (see [pagination](https://core.telegram.org/api/offsets)) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return channels.AdminLogResults */ public function getAdminLog($params); /** * Associate a stickerset to the supergroup. * * Parameters: * * `InputChannel` **channel** - Supergroup * * `InputStickerSet` **stickerset** - The stickerset to associate * * @param array $params Parameters * * @return bool */ public function setStickers($params); /** * Mark [channel/supergroup](https://core.telegram.org/api/channel) message contents as read. * * Parameters: * * `InputChannel` **channel** - [Channel/supergroup](https://core.telegram.org/api/channel) * * `[int]` **id** - IDs of messages whose contents should be marked as read * * @param array $params Parameters * * @return bool */ public function readMessageContents($params); /** * Delete the history of a [supergroup](https://core.telegram.org/api/channel). * * Parameters: * * `boolean` **for_everyone** - Optional: Whether the history should be deleted for everyone * * `InputChannel` **channel** - [Supergroup](https://core.telegram.org/api/channel) whose history must be deleted * * `int` **max_id** - ID of message **up to which** the history must be deleted * * @param array $params Parameters * * @return Updates */ public function deleteHistory($params); /** * Hide/unhide message history for new channel/supergroup users. * * Parameters: * * `InputChannel` **channel** - Channel/supergroup * * `Bool` **enabled** - Hide/unhide * * @param array $params Parameters * * @return Updates */ public function togglePreHistoryHidden($params); /** * Get a list of [channels/supergroups](https://core.telegram.org/api/channel) we left. * * Parameters: * * `int` **offset** - Offset for [pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.Chats */ public function getLeftChannels($params); /** * Get all groups that can be used as [discussion groups](https://core.telegram.org/api/discussion). * * Returned [basic group chats](https://core.telegram.org/api/channel#basic-groups) must be first upgraded to [supergroups](https://core.telegram.org/api/channel#supergroups) before they can be set as a discussion group. * To set a returned supergroup as a discussion group, access to its old messages must be enabled using [channels.togglePreHistoryHidden](https://docs.madelineproto.xyz/API_docs/methods/channels.togglePreHistoryHidden.html), first. * * @return messages.Chats */ public function getGroupsForDiscussion(); /** * Associate a group to a channel as [discussion group](https://core.telegram.org/api/discussion) for that channel. * * Parameters: * * `InputChannel` **broadcast** - Channel * * `InputChannel` **group** - [Discussion group](https://core.telegram.org/api/discussion) to associate to the channel * * @param array $params Parameters * * @return bool */ public function setDiscussionGroup($params); /** * Transfer channel ownership. * * Parameters: * * `InputChannel` **channel** - Channel * * `InputUser` **user_id** - New channel owner * * `InputCheckPasswordSRP` **password** - [2FA password](https://core.telegram.org/api/srp) of account * * @param array $params Parameters * * @return Updates */ public function editCreator($params); /** * Edit location of geogroup. * * Parameters: * * `InputChannel` **channel** - [Geogroup](https://core.telegram.org/api/channel) * * `InputGeoPoint` **geo_point** - New geolocation * * `string` **address** - Address string * * @param array $params Parameters * * @return bool */ public function editLocation($params); /** * Toggle supergroup slow mode: if enabled, users will only be able to send one message every `seconds` seconds. * * Parameters: * * `InputChannel` **channel** - The [supergroup](https://core.telegram.org/api/channel) * * `int` **seconds** - Users will only be able to send one message every `seconds` seconds, `0` to disable the limitation * * @param array $params Parameters * * @return Updates */ public function toggleSlowMode($params); /** * Get inactive channels and supergroups. * * @return messages.InactiveChats */ public function getInactiveChannels(); /** * Convert a [supergroup](https://core.telegram.org/api/channel) to a [gigagroup](https://core.telegram.org/api/channel), when requested by [channel suggestions](https://core.telegram.org/api/config#channel-suggestions). * * Parameters: * * `InputChannel` **channel** - The [supergroup](https://core.telegram.org/api/channel) to convert * * @param array $params Parameters * * @return Updates */ public function convertToGigagroup($params); /** * Mark a specific sponsored message as read. * * Parameters: * * `InputChannel` **channel** - Peer * * @param array $params Parameters * * @return bool */ public function viewSponsoredMessage($params); /** * Get a list of sponsored messages. * * Parameters: * * `InputChannel` **channel** - Peer * * @param array $params Parameters * * @return messages.SponsoredMessages */ public function getSponsoredMessages($params); /** * Obtains a list of peers that can be used to send messages in a specific group. * * Parameters: * * `InputPeer` **peer** - The group where we intend to send messages * * @param array $params Parameters * * @return channels.SendAsPeers */ public function getSendAs($params); /** * Delete all messages sent by a specific participant of a given supergroup. * * Parameters: * * `InputChannel` **channel** - Supergroup * * `InputPeer` **participant** - The participant whose messages should be deleted * * @param array $params Parameters * * @return messages.AffectedHistory */ public function deleteParticipantHistory($params); /** * Set whether all users [should join a discussion group in order to comment on a post »](https://core.telegram.org/api/discussion#requiring-users-to-join-the-group). * * Parameters: * * `InputChannel` **channel** - Discussion group * * `Bool` **enabled** - Toggle * * @param array $params Parameters * * @return Updates */ public function toggleJoinToSend($params); /** * Set whether all users should [request admin approval to join the group »](https://core.telegram.org/api/invites#join-requests). * * Parameters: * * `InputChannel` **channel** - Group * * `Bool` **enabled** - Toggle * * @param array $params Parameters * * @return Updates */ public function toggleJoinRequest($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `[string]` **order** -. * * @param array $params Parameters * * @return bool */ public function reorderUsernames($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `string` **username** - * * `Bool` **active** -. * * @param array $params Parameters * * @return bool */ public function toggleUsername($params); /** * * * Parameters: * * `InputChannel` **channel** -. * * @param array $params Parameters * * @return bool */ public function deactivateAllUsernames($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `Bool` **enabled** -. * * @param array $params Parameters * * @return Updates */ public function toggleForum($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `string` **title** - * * `int` **icon_color** - Optional: * * `long` **icon_emoji_id** - Optional: * * `InputPeer` **send_as** - Optional:. * * @param array $params Parameters * * @return Updates */ public function createForumTopic($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `string` **q** - Optional: * * `int` **offset_date** - * * `int` **offset_id** - * * `int` **offset_topic** - * * `int` **limit** -. * * @param array $params Parameters * * @return messages.ForumTopics */ public function getForumTopics($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `[int]` **topics** -. * * @param array $params Parameters * * @return messages.ForumTopics */ public function getForumTopicsByID($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `int` **topic_id** - * * `string` **title** - Optional: * * `long` **icon_emoji_id** - Optional: * * `Bool` **closed** - Optional: * * `Bool` **hidden** - Optional:. * * @param array $params Parameters * * @return Updates */ public function editForumTopic($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `int` **topic_id** - * * `Bool` **pinned** -. * * @param array $params Parameters * * @return Updates */ public function updatePinnedForumTopic($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `int` **top_msg_id** -. * * @param array $params Parameters * * @return messages.AffectedHistory */ public function deleteTopicHistory($params); /** * * * Parameters: * * `boolean` **force** - Optional: * * `InputChannel` **channel** - * * `[int]` **order** -. * * @param array $params Parameters * * @return Updates */ public function reorderPinnedForumTopics($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `Bool` **enabled** -. * * @param array $params Parameters * * @return Updates */ public function toggleAntiSpam($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `int` **msg_id** -. * * @param array $params Parameters * * @return bool */ public function reportAntiSpamFalsePositive($params); /** * * * Parameters: * * `InputChannel` **channel** - * * `Bool` **enabled** -. * * @param array $params Parameters * * @return Updates */ public function toggleParticipantsHidden($params); } interface bots { /** * Sends a custom request; for bots only. * * Parameters: * * `string` **custom_method** - The method name * * `DataJSON` **params** - JSON-serialized method parameters * * @param array $params Parameters * * @return DataJSON */ public function sendCustomRequest($params); /** * Answers a custom query; for bots only. * * Parameters: * * `long` **query_id** - Identifier of a custom query * * `DataJSON` **data** - JSON-serialized answer to the query * * @param array $params Parameters * * @return bool */ public function answerWebhookJSONQuery($params); /** * Set bot command list. * * Parameters: * * `BotCommandScope` **scope** - Command scope * * `string` **lang_code** - Language code * * `[BotCommand]` **commands** - Bot commands * * @param array $params Parameters * * @return bool */ public function setBotCommands($params); /** * Clear bot commands for the specified bot scope and language code. * * Parameters: * * `BotCommandScope` **scope** - Command scope * * `string` **lang_code** - Language code * * @param array $params Parameters * * @return bool */ public function resetBotCommands($params); /** * Obtain a list of bot commands for the specified bot scope and language code. * * Parameters: * * `BotCommandScope` **scope** - Command scope * * `string` **lang_code** - Language code * * @param array $params Parameters * * @return of BotCommand[] */ public function getBotCommands($params); /** * Sets the [menu button action »](https://core.telegram.org/api/bots/menu) for a given user or for all users. * * Parameters: * * `InputUser` **user_id** - User ID * * `BotMenuButton` **button** - Bot menu button action * * @param array $params Parameters * * @return bool */ public function setBotMenuButton($params); /** * Gets the menu button action for a given user or for all users, previously set using [bots.setBotMenuButton](https://docs.madelineproto.xyz/API_docs/methods/bots.setBotMenuButton.html); users can see this information in the [botInfo](https://docs.madelineproto.xyz/API_docs/constructors/botInfo.html) constructor. * * Parameters: * * `InputUser` **user_id** - User ID or empty for the default menu button. * * @param array $params Parameters * * @return BotMenuButton */ public function getBotMenuButton($params); /** * Set the default [suggested admin rights](https://core.telegram.org/api/rights#suggested-bot-rights) for bots being added as admins to channels, see [here for more info on how to handle them »](https://core.telegram.org/api/rights#suggested-bot-rights). * * Parameters: * * `ChatAdminRights` **admin_rights** - Admin rights * * @param array $params Parameters * * @return bool */ public function setBotBroadcastDefaultAdminRights($params); /** * Set the default [suggested admin rights](https://core.telegram.org/api/rights#suggested-bot-rights) for bots being added as admins to groups, see [here for more info on how to handle them »](https://core.telegram.org/api/rights#suggested-bot-rights). * * Parameters: * * `ChatAdminRights` **admin_rights** - Admin rights * * @param array $params Parameters * * @return bool */ public function setBotGroupDefaultAdminRights($params); } interface payments { /** * Get a payment form. * * Parameters: * * `InputInvoice` **invoice** - Invoice * * `DataJSON` **theme_params** - Optional: A JSON object with the following keys, containing color theme information (integers, RGB24) to pass to the payment provider, to apply in eventual verification pages:
`bg_color` \- Background color
`text_color` \- Text color
`hint_color` \- Hint text color
`link_color` \- Link color
`button_color` \- Button color
`button_text_color` \- Button text color * * @param array $params Parameters * * @return payments.PaymentForm */ public function getPaymentForm($params); /** * Get payment receipt. * * Parameters: * * `InputPeer` **peer** - The peer where the payment receipt was sent * * `int` **msg_id** - Message ID of receipt * * @param array $params Parameters * * @return payments.PaymentReceipt */ public function getPaymentReceipt($params); /** * Submit requested order information for validation. * * Parameters: * * `boolean` **save** - Optional: Save order information to re-use it for future orders * * `InputInvoice` **invoice** - Invoice * * `PaymentRequestedInfo` **info** - Requested order information * * @param array $params Parameters * * @return payments.ValidatedRequestedInfo */ public function validateRequestedInfo($params); /** * Send compiled payment form. * * Parameters: * * `long` **form_id** - Form ID * * `InputInvoice` **invoice** - Invoice * * `string` **requested_info_id** - Optional: ID of saved and validated [order info](https://docs.madelineproto.xyz/API_docs/constructors/payments.validatedRequestedInfo.html) * * `string` **shipping_option_id** - Optional: Chosen shipping option ID * * `InputPaymentCredentials` **credentials** - Payment credentials * * `long` **tip_amount** - Optional: Tip, in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). * * @param array $params Parameters * * @return payments.PaymentResult */ public function sendPaymentForm($params); /** * Get saved payment information. * * @return payments.SavedInfo */ public function getSavedInfo(); /** * Clear saved payment information. * * Parameters: * * `boolean` **credentials** - Optional: Remove saved payment credentials * * `boolean` **info** - Optional: Clear the last order settings saved by the user * * @param array $params Parameters * * @return bool */ public function clearSavedInfo($params); /** * Get info about a credit card. * * Parameters: * * `string` **number** - Credit card number * * @param array $params Parameters * * @return payments.BankCardData */ public function getBankCardData($params); /** * Generate an [invoice deep link](https://core.telegram.org/api/links#invoice-links). * * Parameters: * * `InputMedia` **invoice_media** - Invoice * * @param array $params Parameters * * @return payments.ExportedInvoice */ public function exportInvoice($params); /** * Informs server about a purchase made through the App Store: for official applications only. * * Parameters: * * `bytes` **receipt** - Receipt * * `InputStorePaymentPurpose` **purpose** - Payment purpose * * @param array $params Parameters * * @return Updates */ public function assignAppStoreTransaction($params); /** * Informs server about a purchase made through the Play Store: for official applications only. * * Parameters: * * `DataJSON` **receipt** - Receipt * * `InputStorePaymentPurpose` **purpose** - Payment purpose * * @param array $params Parameters * * @return Updates */ public function assignPlayMarketTransaction($params); /** * Checks whether Telegram Premium purchase is possible. Must be called before in-store Premium purchase, official apps only. * * Parameters: * * `InputStorePaymentPurpose` **purpose** - Payment purpose * * @param array $params Parameters * * @return bool */ public function canPurchasePremium($params); } interface stickers { /** * Create a stickerset, bots only. * * Parameters: * * `boolean` **masks** - Optional: Whether this is a mask stickerset * * `boolean` **animated** - Optional: Whether this is an animated stickerset * * `boolean` **videos** - Optional: Whether this is a video stickerset * * `InputUser` **user_id** - Stickerset owner * * `string` **title** - Stickerset name, `1-64` chars * * `string` **short_name** - Short name of sticker set, to be used in [sticker deep links »](https://core.telegram.org/api/links#stickerset-links). Can contain only english letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and, **if called by a bot**, must end in `"_by_"`. `` is case insensitive. 1-64 characters. * * `InputDocument` **thumb** - Optional: Thumbnail * * `[InputStickerSetItem]` **stickers** - Stickers * * `string` **software** - Optional: Used when [importing stickers using the sticker import SDKs](https://core.telegram.org/import-stickers), specifies the name of the software that created the stickers * * @param array $params Parameters * * @return messages.StickerSet */ public function createStickerSet($params); /** * Remove a sticker from the set where it belongs, bots only. The sticker set must have been created by the bot. * * Parameters: * * `InputDocument` **sticker** - The sticker to remove * * @param array $params Parameters * * @return messages.StickerSet */ public function removeStickerFromSet($params); /** * Changes the absolute position of a sticker in the set to which it belongs; for bots only. The sticker set must have been created by the bot. * * Parameters: * * `InputDocument` **sticker** - The sticker * * `int` **position** - The new position of the sticker, zero-based * * @param array $params Parameters * * @return messages.StickerSet */ public function changeStickerPosition($params); /** * Add a sticker to a stickerset, bots only. The sticker set must have been created by the bot. * * Parameters: * * `InputStickerSet` **stickerset** - The stickerset * * `InputStickerSetItem` **sticker** - The sticker * * @param array $params Parameters * * @return messages.StickerSet */ public function addStickerToSet($params); /** * Set stickerset thumbnail. * * Parameters: * * `InputStickerSet` **stickerset** - Stickerset * * `InputDocument` **thumb** - Thumbnail * * @param array $params Parameters * * @return messages.StickerSet */ public function setStickerSetThumb($params); /** * Check whether the given short name is available. * * Parameters: * * `string` **short_name** - Short name * * @param array $params Parameters * * @return bool */ public function checkShortName($params); /** * Suggests a short name for a given stickerpack name. * * Parameters: * * `string` **title** - Sticker pack name * * @param array $params Parameters * * @return stickers.SuggestedShortName */ public function suggestShortName($params); } interface phone { /** * Get phone call configuration to be passed to libtgvoip's shared config. * * @return DataJSON */ public function getCallConfig(); /** * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls. * * Parameters: * * `boolean` **video** - Optional: Whether to start a video call * * `InputUser` **user_id** - Destination of the phone call * * `bytes` **g_a_hash** - [Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls) * * `PhoneCallProtocol` **protocol** - Phone call settings * * @param array $params Parameters * * @return phone.PhoneCall */ public function requestCall($params); /** * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls. * * Parameters: * * `InputPhoneCall` **peer** - The call to accept * * `bytes` **g_b** - [Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls) * * `PhoneCallProtocol` **protocol** - Phone call settings * * @param array $params Parameters * * @return phone.PhoneCall */ public function acceptCall($params); /** * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls. * * Parameters: * * `InputPhoneCall` **peer** - The phone call * * `bytes` **g_a** - [Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls) * * `long` **key_fingerprint** - Key fingerprint * * `PhoneCallProtocol` **protocol** - Phone call settings * * @param array $params Parameters * * @return phone.PhoneCall */ public function confirmCall($params); /** * Optional: notify the server that the user is currently busy in a call: this will automatically refuse all incoming phone calls until the current phone call is ended. * * Parameters: * * `InputPhoneCall` **peer** - The phone call we're currently in * * @param array $params Parameters * * @return bool */ public function receivedCall($params); /** * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls. * * Parameters: * * `boolean` **video** - Optional: Whether this is a video call * * `InputPhoneCall` **peer** - The phone call * * `int` **duration** - Call duration * * `PhoneCallDiscardReason` **reason** - Why was the call discarded * * `long` **connection_id** - Preferred libtgvoip relay ID * * @param array $params Parameters * * @return Updates */ public function discardCall($params); /** * Rate a call, returns info about the rating message sent to the official VoIP bot. * * Parameters: * * `boolean` **user_initiative** - Optional: Whether the user decided on their own initiative to rate the call * * `InputPhoneCall` **peer** - The call to rate * * `int` **rating** - Rating in `1-5` stars * * `string` **comment** - An additional comment * * @param array $params Parameters * * @return Updates */ public function setCallRating($params); /** * Send phone call debug data to server. * * Parameters: * * `InputPhoneCall` **peer** - Phone call * * `DataJSON` **debug** - Debug statistics obtained from libtgvoip * * @param array $params Parameters * * @return bool */ public function saveCallDebug($params); /** * Send VoIP signaling data. * * Parameters: * * `InputPhoneCall` **peer** - Phone call * * `bytes` **data** - Signaling payload * * @param array $params Parameters * * @return bool */ public function sendSignalingData($params); /** * Create a group call or livestream. * * Parameters: * * `boolean` **rtmp_stream** - Optional: Whether RTMP stream support should be enabled: only the [group/supergroup/channel](https://core.telegram.org/api/channel) owner can use this flag. * * `InputPeer` **peer** - Associate the group call or livestream to the provided [group/supergroup/channel](https://core.telegram.org/api/channel) * * `string` **title** - Optional: Call title * * `int` **schedule_date** - Optional: For scheduled group call or livestreams, the absolute date when the group call will start * * @param array $params Parameters * * @return Updates */ public function createGroupCall($params); /** * Join a group call. * * Parameters: * * `boolean` **muted** - Optional: If set, the user will be muted by default upon joining. * * `boolean` **video_stopped** - Optional: If set, the user's video will be disabled by default upon joining. * * `InputGroupCall` **call** - The group call * * `InputPeer` **join_as** - Join the group call, presenting yourself as the specified user/channel * * `string` **invite_hash** - Optional: The invitation hash from the [invite link »](https://core.telegram.org/api/links#voice-chatvideo-chatlivestream-links), if provided allows speaking in a livestream or muted group chat. * * `DataJSON` **params** - WebRTC parameters * * @param array $params Parameters * * @return Updates */ public function joinGroupCall($params); /** * Leave a group call. * * Parameters: * * `InputGroupCall` **call** - The group call * * `int` **source** - Your source ID * * @param array $params Parameters * * @return Updates */ public function leaveGroupCall($params); /** * Invite a set of users to a group call. * * Parameters: * * `InputGroupCall` **call** - The group call * * `[InputUser]` **users** - The users to invite. * * @param array $params Parameters * * @return Updates */ public function inviteToGroupCall($params); /** * Terminate a group call. * * Parameters: * * `InputGroupCall` **call** - The group call to terminate * * @param array $params Parameters * * @return Updates */ public function discardGroupCall($params); /** * Change group call settings. * * Parameters: * * `boolean` **reset_invite_hash** - Optional: Invalidate existing invite links * * `InputGroupCall` **call** - Group call * * `Bool` **join_muted** - Optional: Whether all users will that join this group call are muted by default upon joining the group call * * @param array $params Parameters * * @return Updates */ public function toggleGroupCallSettings($params); /** * Get info about a group call. * * Parameters: * * `InputGroupCall` **call** - The group call * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return phone.GroupCall */ public function getGroupCall($params); /** * Get group call participants. * * Parameters: * * `InputGroupCall` **call** - Group call * * `[InputPeer]` **ids** - If specified, will fetch group participant info about the specified peers * * `[int]` **sources** - If specified, will fetch group participant info about the specified WebRTC source IDs * * `string` **offset** - Offset for results, taken from the `next_offset` field of [phone.groupParticipants](https://docs.madelineproto.xyz/API_docs/constructors/phone.groupParticipants.html), initially an empty string.
Note: if no more results are available, the method call will return an empty `next_offset`; thus, avoid providing the `next_offset` returned in [phone.groupParticipants](https://docs.madelineproto.xyz/API_docs/constructors/phone.groupParticipants.html) if it is empty, to avoid an infinite loop. * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return phone.GroupParticipants */ public function getGroupParticipants($params); /** * Check whether the group call Server Forwarding Unit is currently receiving the streams with the specified WebRTC source IDs. * Returns an intersection of the source IDs specified in `sources`, and the source IDs currently being forwarded by the SFU. * * Parameters: * * `InputGroupCall` **call** - Group call * * `[int]` **sources** - Source IDs * * @param array $params Parameters * * @return of int[] */ public function checkGroupCall($params); /** * Start or stop recording a group call: the recorded audio and video streams will be automatically sent to `Saved messages` (the chat with ourselves). * * Parameters: * * `boolean` **start** - Optional: Whether to start or stop recording * * `boolean` **video** - Optional: Whether to also record video streams * * `InputGroupCall` **call** - The group call or livestream * * `string` **title** - Optional: Recording title * * `Bool` **video_portrait** - Optional: If video stream recording is enabled, whether to record in portrait or landscape mode * * @param array $params Parameters * * @return Updates */ public function toggleGroupCallRecord($params); /** * Edit information about a given group call participant. * * Note: [flags](https://core.telegram.org/mtproto/TL-combinators#conditional-fields).N?[Bool](https://docs.madelineproto.xyz/API_docs/types/Bool.html) parameters can have three possible values: * * - If the [TL flag](https://core.telegram.org/mtproto/TL-combinators#conditional-fields) is not set, the previous value will not be changed. * - If the [TL flag](https://core.telegram.org/mtproto/TL-combinators#conditional-fields) is set and contains a [boolTrue](https://docs.madelineproto.xyz/API_docs/constructors/boolTrue.html), the previous value will be overwritten to `true`. * - If the [TL flag](https://core.telegram.org/mtproto/TL-combinators#conditional-fields) is set and contains a [boolFalse](https://docs.madelineproto.xyz/API_docs/constructors/boolFalse.html), the previous value will be overwritten to `false`. * * Parameters: * * `InputGroupCall` **call** - The group call * * `InputPeer` **participant** - The group call participant (can also be the user itself) * * `Bool` **muted** - Optional: Whether to mute or unmute the specified participant * * `int` **volume** - Optional: New volume * * `Bool` **raise_hand** - Optional: Raise or lower hand * * `Bool` **video_stopped** - Optional: Start or stop the video stream * * `Bool` **video_paused** - Optional: Pause or resume the video stream * * `Bool` **presentation_paused** - Optional: Pause or resume the screen sharing stream * * @param array $params Parameters * * @return Updates */ public function editGroupCallParticipant($params); /** * Edit the title of a group call or livestream. * * Parameters: * * `InputGroupCall` **call** - Group call * * `string` **title** - New title * * @param array $params Parameters * * @return Updates */ public function editGroupCallTitle($params); /** * Get a list of peers that can be used to join a group call, presenting yourself as a specific user/channel. * * Parameters: * * `InputPeer` **peer** - The dialog whose group call or livestream we're trying to join * * @param array $params Parameters * * @return phone.JoinAsPeers */ public function getGroupCallJoinAs($params); /** * Get an [invite link](https://core.telegram.org/api/links#voice-chatvideo-chatlivestream-links) for a group call or livestream. * * Parameters: * * `boolean` **can_self_unmute** - Optional: For livestreams or muted group chats, if set, users that join using this link will be able to speak without explicitly requesting permission by (for example by raising their hand). * * `InputGroupCall` **call** - The group call * * @param array $params Parameters * * @return phone.ExportedGroupCallInvite */ public function exportGroupCallInvite($params); /** * Subscribe or unsubscribe to a scheduled group call. * * Parameters: * * `InputGroupCall` **call** - Scheduled group call * * `Bool` **subscribed** - Enable or disable subscription * * @param array $params Parameters * * @return Updates */ public function toggleGroupCallStartSubscription($params); /** * Start a scheduled group call. * * Parameters: * * `InputGroupCall` **call** - The scheduled group call * * @param array $params Parameters * * @return Updates */ public function startScheduledGroupCall($params); /** * Set the default peer that will be used to join a group call in a specific dialog. * * Parameters: * * `InputPeer` **peer** - The dialog * * `InputPeer` **join_as** - The default peer that will be used to join group calls in this dialog, presenting yourself as a specific user/channel. * * @param array $params Parameters * * @return bool */ public function saveDefaultGroupCallJoinAs($params); /** * Start screen sharing in a call. * * Parameters: * * `InputGroupCall` **call** - The group call * * `DataJSON` **params** - WebRTC parameters * * @param array $params Parameters * * @return Updates */ public function joinGroupCallPresentation($params); /** * Stop screen sharing in a group call. * * Parameters: * * `InputGroupCall` **call** - The group call * * @param array $params Parameters * * @return Updates */ public function leaveGroupCallPresentation($params); /** * Get info about RTMP streams in a group call or livestream. * This method should be invoked to the same group/channel-related DC used for [downloading livestream chunks](https://core.telegram.org/api/files#downloading-files). * As usual, the media DC is preferred, if available. * * Parameters: * * `InputGroupCall` **call** - Group call or livestream * * @param array $params Parameters * * @return phone.GroupCallStreamChannels */ public function getGroupCallStreamChannels($params); /** * Get RTMP URL and stream key for RTMP livestreams. Can be used even before creating the actual RTMP livestream with [phone.createGroupCall](https://docs.madelineproto.xyz/API_docs/methods/phone.createGroupCall.html) (the `rtmp_stream` flag must be set). * * Parameters: * * `InputPeer` **peer** - Peer to livestream into * * `Bool` **revoke** - Whether to revoke the previous stream key or simply return the existing one * * @param array $params Parameters * * @return phone.GroupCallStreamRtmpUrl */ public function getGroupCallStreamRtmpUrl($params); /** * Save phone call debug information. * * Parameters: * * `InputPhoneCall` **peer** - Phone call * * `InputFile` **file** - Logs * * @param array $params Parameters * * @return bool */ public function saveCallLog($params); } interface langpack { /** * Get localization pack strings. * * Parameters: * * `string` **lang_pack** - Language pack name, usually obtained from a [language pack link](https://core.telegram.org/api/links#language-pack-links) * * `string` **lang_code** - Language code * * @param array $params Parameters * * @return LangPackDifference */ public function getLangPack($params); /** * Get strings from a language pack. * * Parameters: * * `string` **lang_pack** - Language pack name, usually obtained from a [language pack link](https://core.telegram.org/api/links#language-pack-links) * * `string` **lang_code** - Language code * * `[string]` **keys** - Strings to get * * @param array $params Parameters * * @return of LangPackString[] */ public function getStrings($params); /** * Get new strings in language pack. * * Parameters: * * `string` **lang_pack** - Language pack * * `string` **lang_code** - Language code * * `int` **from_version** - Previous localization pack version * * @param array $params Parameters * * @return LangPackDifference */ public function getDifference($params); /** * Get information about all languages in a localization pack. * * Parameters: * * `string` **lang_pack** - Language pack * * @param array $params Parameters * * @return of LangPackLanguage[] */ public function getLanguages($params); /** * Get information about a language in a localization pack. * * Parameters: * * `string` **lang_pack** - Language pack name, usually obtained from a [language pack link](https://core.telegram.org/api/links#language-pack-links) * * `string` **lang_code** - Language code * * @param array $params Parameters * * @return LangPackLanguage */ public function getLanguage($params); } interface folders { /** * Edit peers in [peer folder](https://core.telegram.org/api/folders#peer-folders). * * Parameters: * * `[InputFolderPeer]` **folder_peers** - New peer list * * @param array $params Parameters * * @return Updates */ public function editPeerFolders($params); /** * Delete a [peer folder](https://core.telegram.org/api/folders#peer-folders). * * Parameters: * * `int` **folder_id** - [Peer folder ID, for more info click here](https://core.telegram.org/api/folders#peer-folders) * * @param array $params Parameters * * @return Updates */ public function deleteFolder($params); } interface stats { /** * Get [channel statistics](https://core.telegram.org/api/stats). * * Parameters: * * `boolean` **dark** - Optional: Whether to enable dark theme for graph colors * * `InputChannel` **channel** - The channel * * @param array $params Parameters * * @return stats.BroadcastStats */ public function getBroadcastStats($params); /** * Load [channel statistics graph](https://core.telegram.org/api/stats) asynchronously. * * Parameters: * * `string` **token** - Graph token from [statsGraphAsync](https://docs.madelineproto.xyz/API_docs/constructors/statsGraphAsync.html) constructor * * `long` **x** - Optional: Zoom value, if required * * @param array $params Parameters * * @return StatsGraph */ public function loadAsyncGraph($params); /** * Get [supergroup statistics](https://core.telegram.org/api/stats). * * Parameters: * * `boolean` **dark** - Optional: Whether to enable dark theme for graph colors * * `InputChannel` **channel** - [Supergroup ID](https://core.telegram.org/api/channel) * * @param array $params Parameters * * @return stats.MegagroupStats */ public function getMegagroupStats($params); /** * Obtains a list of messages, indicating to which other public channels was a channel message forwarded. * Will return a list of [messages](https://docs.madelineproto.xyz/API_docs/constructors/message.html) with `peer_id` equal to the public channel to which this message was forwarded. * * Parameters: * * `InputChannel` **channel** - Source channel * * `int` **msg_id** - Source message ID * * `int` **offset_rate** - Initially 0, then set to the `next_rate` parameter of [messages.messagesSlice](https://docs.madelineproto.xyz/API_docs/constructors/messages.messagesSlice.html) * * `InputPeer` **offset_peer** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * * @return messages.Messages */ public function getMessagePublicForwards($params); /** * Get [message statistics](https://core.telegram.org/api/stats). * * Parameters: * * `boolean` **dark** - Optional: Whether to enable dark theme for graph colors * * `InputChannel` **channel** - Channel ID * * `int` **msg_id** - Message ID * * @param array $params Parameters * * @return stats.MessageStats */ public function getMessageStats($params); } class InternalDoc extends APIFactory { /** * Convert MTProto parameters to bot API parameters. * * @param array $data Data * * @return \Amp\Promise */ public function MTProtoToBotAPI(array $data, array $extra = []) { return $this->__call(__FUNCTION__, [$data, $extra]); } /** * MTProto to TD params. * * @param mixed $params Params * * @return \Amp\Promise */ public function MTProtoToTd(&$params, array $extra = []) { return $this->__call(__FUNCTION__, [$params, $extra]); } /** * MTProto to TDCLI params. * * @param mixed $params Params * * @return \Amp\Promise */ public function MTProtoToTdcli($params, array $extra = []) { return $this->__call(__FUNCTION__, [$params, $extra]); } /** * Accept call. * * @param array $call Call * * @return \Amp\Promise */ public function acceptCall(array $call, array $extra = []) { return $this->__call(__FUNCTION__, [$call, $extra]); } /** * Accept secret chat. * * @param array $params Secret chat ID * * @return \Amp\Promise */ public function acceptSecretChat($params, array $extra = []) { return $this->__call(__FUNCTION__, [$params, $extra]); } /** * Accept terms of service update. * * @return \Amp\Promise */ public function acceptTos(array $extra = []) { return $this->__call(__FUNCTION__, [$extra]); } /** * Add user info. * * @param array $user User info * * @throws \danog\MadelineProto\Exception * @return \Amp\Promise */ public function addUser(array $user, array $extra = []) { return $this->__call(__FUNCTION__, [$user, $extra]); } /** * Call promise $b after promise $a. * * @param \Generator|Promise $a Promise A * @param \Generator|Promise $b Promise B * * @psalm-suppress InvalidScope * * @return Amp\Promise */ public static function after($a, $b) { return \danog\MadelineProto\Tools::after($a, $b); } /** * Returns a promise that succeeds when all promises succeed, and fails if any promise fails. * Returned promise succeeds with an array of values used to succeed each contained promise, with keys corresponding to the array of promises. * * @param array<\Generator|Promise> $promises Promises * * @return Amp\Promise */ public static function all(array $promises) { return \danog\MadelineProto\Tools::all($promises); } /** * Returns a promise that is resolved when all promises are resolved. The returned promise will not fail. * * @param array $promises Promises * * @return Amp\Promise */ public static function any(array $promises) { return \danog\MadelineProto\Tools::any($promises); } /** * Create array. * * @param mixed ...$params Params * */ public static function arr(...$params): array { return \danog\MadelineProto\Tools::arr(...$params); } /** * base64URL decode. * * @param string $data Data to decode * */ public static function base64urlDecode(string $data): string { return \danog\MadelineProto\Tools::base64urlDecode($data); } /** * Base64URL encode. * * @param string $data Data to encode * */ public static function base64urlEncode(string $data): string { return \danog\MadelineProto\Tools::base64urlEncode($data); } /** * Convert bot API parameters to MTProto parameters. * * @param array $arguments Arguments * * @psalm-return array|\Amp\Promise */ public function botAPIToMTProto(array $arguments) { return $this->__call(__FUNCTION__, [$arguments]); } /** * Login as bot. * * @param string $token Bot token * * @return \Amp\Promise */ public function botLogin(string $token, array $extra = []) { return $this->__call(__FUNCTION__, [$token, $extra]); } /** * Convert generator, promise or any other value to a promise. * * @param \Generator|Promise|mixed $promise * * @template TReturn * @psalm-param \Generator|Promise|TReturn $promise * * @psalm-return Promise * @return Amp\Promise */ public static function call($promise) { return \danog\MadelineProto\Tools::call($promise); } /** * Call promise in background. * * @param \Generator|Promise $promise Promise to resolve * @param ?\Generator|Promise $actual Promise to resolve instead of $promise * @param string $file File * * @psalm-suppress InvalidScope * * @return \Amp\Promise|mixed */ public static function callFork($promise, $actual = null, $file = '') { return \danog\MadelineProto\Tools::callFork($promise, $actual, $file); } /** * Call promise in background, deferring execution. * * @param \Generator|Promise $promise Promise to resolve * */ public static function callForkDefer($promise): void { \danog\MadelineProto\Tools::callForkDefer($promise); } /** * Get call status. * * @param int $id Call ID * * @psalm-return int|\Amp\Promise */ public function callStatus($id) { return $this->__call(__FUNCTION__, [$id]); } /** * Check for terms of service update. * * Will throw a \danog\MadelineProto\Exception if a new TOS is available. * * @return \Amp\Promise */ public function checkTos(array $extra = []) { return $this->__call(__FUNCTION__, [$extra]); } /** * Cleanup memory and session file. * * @return \Amp\Promise */ public function cleanup(array $extra = []) { return $this->__call(__FUNCTION__, [$extra]); } /** * Close connection with client, connected via web. * * @param string $message Message * */ public static function closeConnection($message): void { \danog\MadelineProto\Tools::closeConnection($message); } /** * Complete 2FA login. * * @param string $password Password * * @return \Amp\Promise */ public function complete2faLogin(string $password, array $extra = []) { return $this->__call(__FUNCTION__, [$password, $extra]); } /** * Complete call handshake. * * @param array $params Params * * @return \Amp\Promise */ public function completeCall(array $params, array $extra = []) { return $this->__call(__FUNCTION__, [$params, $extra]); } /** * Complet user login using login code. * * @param string $code Login code * * @return \Amp\Promise */ public function completePhoneLogin($code, array $extra = []) { return $this->__call(__FUNCTION__, [$code, $extra]); } /** * Complete signup to Telegram. * * @param string $first_name First name * @param string $last_name Last name * * @return \Amp\Promise */ public function completeSignup(string $first_name, string $last_name = '', array $extra = []) { return $this->__call(__FUNCTION__, [$first_name, $last_name, $extra]); } /** * Confirm call. * * @param array $params Params * * @return \Amp\Promise */ public function confirmCall(array $params, array $extra = []) { return $this->__call(__FUNCTION__, [$params, $extra]); } /** * Connects to all datacenters and if necessary creates authorization keys, binds them and writes client info. * * @param boolean $reconnectAll Whether to reconnect to all DCs * * @return \Amp\Promise */ public function connectToAllDcs(bool $reconnectAll = true, array $extra = []) { return $this->__call(__FUNCTION__, [$reconnectAll, $extra]); } /** * Decline terms of service update. * * THIS WILL DELETE YOUR ACCOUNT! * * @return \Amp\Promise */ public function declineTos(array $extra = []) { return $this->__call(__FUNCTION__, [$extra]); } /** * Discard call. * * @param array $call Call * @param array $rating Rating * @param boolean $need_debug Need debug? * * @return \Amp\Promise */ public function discardCall(array $call, array $reason, array $rating = [ ], bool $need_debug = true, array $extra = []) { return $this->__call(__FUNCTION__, [$call, $reason, $rating, $need_debug, $extra]); } /** * Discard secret chat. * * @param int $chat Secret chat ID * * @return \Amp\Promise */ public function discardSecretChat(int $chat, array $extra = []) { return $this->__call(__FUNCTION__, [$chat, $extra]); } /** * Download file to browser. * * Supports HEAD requests and content-ranges for parallel and resumed downloads. * * @param array|string $messageMedia File to download * @param ?callable $cb Status callback (can also use FileCallback) * @param ?int $size Size of file to download, required for bot API file IDs. * @param ?string $mime MIME type of file to download, required for bot API file IDs. * @param ?string $name Name of file to download, required for bot API file IDs. * * @return \Amp\Promise */ public function downloadToBrowser($messageMedia, ?callable $cb = null, ?int $size = null, ?string $name = null, ?string $mime = null, array $extra = []) { return $this->__call(__FUNCTION__, [$messageMedia, $cb, $size, $name, $mime, $extra]); } /** * Download file to callable. * The callable must accept two parameters: string $payload, int $offset * The callable will be called (possibly out of order, depending on the value of $seekable). * The callable should return the number of written bytes. * * @param mixed $messageMedia File to download * @param callable|FileCallbackInterface $callable Chunk callback * @param callable $cb Status callback (DEPRECATED, use FileCallbackInterface) * @param bool $seekable Whether the callable can be called out of order * @param int $offset Offset where to start downloading * @param int $end Offset where to stop downloading (inclusive) * @param int $part_size Size of each chunk * * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function downloadToCallable($messageMedia, callable $callable, $cb = null, bool $seekable = true, int $offset = 0, int $end = -1, ?int $part_size = null, array $extra = []) { return $this->__call(__FUNCTION__, [$messageMedia, $callable, $cb, $seekable, $offset, $end, $part_size, $extra]); } /** * Download file to directory. * * @param mixed $messageMedia File to download * @param string|FileCallbackInterface $dir Directory where to download the file * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function downloadToDir($messageMedia, $dir, $cb = null, array $extra = []) { return $this->__call(__FUNCTION__, [$messageMedia, $dir, $cb, $extra]); } /** * Download file. * * @param mixed $messageMedia File to download * @param string|FileCallbackInterface $file Downloaded file path * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * * @return \Amp\Promise Downloaded file path * * @psalm-return \Amp\Promise */ public function downloadToFile($messageMedia, $file, $cb = null, array $extra = []) { return $this->__call(__FUNCTION__, [$messageMedia, $file, $cb, $extra]); } /** * Download file to amphp/http-server response. * * Supports HEAD requests and content-ranges for parallel and resumed downloads. * * @param array|string $messageMedia File to download * @param ServerRequest $request Request * @param callable $cb Status callback (can also use FileCallback) * @param ?int $size Size of file to download, required for bot API file IDs. * @param ?string $name Name of file to download, required for bot API file IDs. * @param ?string $mime MIME type of file to download, required for bot API file IDs. * * @return \Amp\Promise Returned response * * @psalm-return \Amp\Promise<\Amp\Http\Server\Response> */ public function downloadToResponse($messageMedia, \Amp\Http\Server\Request $request, ?callable $cb = null, ?int $size = null, ?string $mime = null, ?string $name = null, array $extra = []) { return $this->__call(__FUNCTION__, [$messageMedia, $request, $cb, $size, $mime, $name, $extra]); } /** * Download file to stream. * * @param mixed $messageMedia File to download * @param mixed|FileCallbackInterface $stream Stream where to download file * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param int $offset Offset where to start downloading * @param int $end Offset where to end download * * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function downloadToStream($messageMedia, $stream, $cb = null, int $offset = 0, int $end = -1, array $extra = []) { return $this->__call(__FUNCTION__, [$messageMedia, $stream, $cb, $offset, $end, $extra]); } /** * Asynchronously write to stdout/browser. * * @param string $string Message to echo * * @return Amp\Promise */ public static function echo(string $string) { return \danog\MadelineProto\Tools::echo($string); } /** * Get final element of array. * * @param array $what Array * */ public static function end(array $what) { return \danog\MadelineProto\Tools::end($what); } /** * Export authorization. * * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function exportAuthorization(array $extra = []) { return $this->__call(__FUNCTION__, [$extra]); } /** * Extract file info from bot API message. * * @param array $info Bot API message object * * @return ?array */ public static function extractBotAPIFile(array $info): ?array { return \danog\MadelineProto\MTProto::extractBotAPIFile($info); } /** * Extract a message constructor from an Updates constructor. * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function extractMessage(array $updates, array $extra = []) { return $this->__call(__FUNCTION__, [$updates, $extra]); } /** * Extract an update message constructor from an Updates constructor. * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function extractMessageUpdate(array $updates, array $extra = []) { return $this->__call(__FUNCTION__, [$updates, $extra]); } /** * Extract Update constructors from an Updates constructor. * * @psalm-return \Amp\Promise> * @return \Amp\Promise */ public function extractUpdates(array $updates, array $extra = []) { return $this->__call(__FUNCTION__, [$updates, $extra]); } /** * Get contents of remote file asynchronously. * * @param string $url URL * * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function fileGetContents(string $url, array $extra = []) { return $this->__call(__FUNCTION__, [$url, $extra]); } /** * Returns a promise that succeeds when the first promise succeeds, and fails only if all promises fail. * * @param array $promises Promises * * @return Amp\Promise */ public static function first(array $promises) { return \danog\MadelineProto\Tools::first($promises); } /** * Asynchronously lock a file * Resolves with a callbable that MUST eventually be called in order to release the lock. * * @param string $file File to lock * @param integer $operation Locking mode * @param float $polling Polling interval * @param ?Promise $token Cancellation token * @param ?callable $failureCb Failure callback, called only once if the first locking attempt fails. * * @return \Amp\Promise<$token is null ? callable : ?callable> */ public static function flock(string $file, int $operation, float $polling = 0.1, ?\Amp\Promise $token = null, $failureCb = null) { return \danog\MadelineProto\Tools::flock($file, $operation, $polling, $token, $failureCb); } /** * Convert bot API channel ID to MTProto channel ID. * * @param int $id Bot API channel ID * */ public static function fromSupergroup($id): int { return \danog\MadelineProto\MTProto::fromSupergroup($id); } /** * When were full info for this chat last cached. * * @param mixed $id Chat ID * * @return \Amp\Promise */ public function fullChatLastUpdated($id, array $extra = []) { return $this->__call(__FUNCTION__, [$id, $extra]); } /** * Get info about the logged-in user, not cached. * * @return \Amp\Promise */ public function fullGetSelf(array $extra = []) { return $this->__call(__FUNCTION__, [$extra]); } /** * Generate MTProto vector hash. * * @param array $ints IDs * * @return string Vector hash */ public static function genVectorHash(array $ints): string { return \danog\MadelineProto\Tools::genVectorHash($ints); } /** * Get full list of MTProto and API methods. * * @psalm-return array|\Amp\Promise */ public function getAllMethods() { return $this->__call(__FUNCTION__, []); } /** * Get authorization info. * * @psalm-return int|\Amp\Promise */ public function getAuthorization() { return $this->__call(__FUNCTION__, []); } /** * Get cached server-side config. * * @psalm-return array|\Amp\Promise */ public function getCachedConfig() { return $this->__call(__FUNCTION__, []); } /** * Get call info. * * @param int $call Call ID * * @psalm-return array|\Amp\Promise */ public function getCall($call) { return $this->__call(__FUNCTION__, [$call]); } /** * Store RSA keys for CDN datacenters. * * @param string $datacenter DC ID * * @return \Amp\Promise */ public function getCdnConfig(string $datacenter, array $extra = []) { return $this->__call(__FUNCTION__, [$datacenter, $extra]); } /** * Get cached (or eventually re-fetch) server-side config. * * @param array $config Current config * @param array $options Options for method call * * @return \Amp\Promise */ public function getConfig(array $config = [ ], array $options = [ ], array $extra = []) { return $this->__call(__FUNCTION__, [$config, $options, $extra]); } /** * Get async DNS client. * * @psalm-return \Amp\Dns\Resolver|\Amp\Promise<\Amp\Dns\Resolver> */ public function getDNSClient() { return $this->__call(__FUNCTION__, []); } /** * Get all datacenter connections. * * @psalm-return array|\Amp\Promise> */ public function getDataCenterConnections() { return $this->__call(__FUNCTION__, []); } /** * Get main DC ID. * * @return int|string */ public function getDataCenterId(array $extra = []) { return $this->__call(__FUNCTION__, [$extra]); } /** * Get diffie-hellman configuration. * * @return \Amp\Promise */ public function getDhConfig(array $extra = []) { return $this->__call(__FUNCTION__, [$extra]); } /** * Get dialog peers. * * @param boolean $force Whether to refetch all dialogs ignoring cache * * * @psalm-return \Amp\Promise> * @return \Amp\Promise */ public function getDialogs(bool $force = true, array $extra = []) { return $this->__call(__FUNCTION__, [$force, $extra]); } /** * Get download info of file * Returns an array with the following structure:. * * `$info['ext']` - The file extension * `$info['name']` - The file name, without the extension * `$info['mime']` - The file mime type * `$info['size']` - The file size * * @param mixed $messageMedia File ID * * @return \Amp\Promise */ public function getDownloadInfo($messageMedia, array $extra = []) { return $this->__call(__FUNCTION__, [$messageMedia, $extra]); } /** * Get event handler. * * @psalm-return \danog\MadelineProto\EventHandler|\Amp\Promise<\danog\MadelineProto\EventHandler> */ public function getEventHandler() { return $this->__call(__FUNCTION__, []); } /** * Get extension from file location. * * @param mixed $location File location * @param string $default Default extension * */ public static function getExtensionFromLocation($location, string $default): string { return \danog\MadelineProto\TL\Conversion\Extension::getExtensionFromLocation($location, $default); } /** * Get extension from mime type. * * @param string $mime MIME type * */ public static function getExtensionFromMime(string $mime): string { return \danog\MadelineProto\TL\Conversion\Extension::getExtensionFromMime($mime); } /** * Get info about file. * * @param mixed $constructor File ID * * @return \Amp\Promise */ public function getFileInfo($constructor, array $extra = []) { return $this->__call(__FUNCTION__, [$constructor, $extra]); } /** * Get folder ID from object. * * @param mixed $id Object * * @return ?int */ public static function getFolderId($id): ?int { return \danog\MadelineProto\MTProto::getFolderId($id); } /** * Get full info of all dialogs. * * @param boolean $force Whether to refetch all dialogs ignoring cache * * @return \Amp\Promise */ public function getFullDialogs(bool $force = true, array $extra = []) { return $this->__call(__FUNCTION__, [$force, $extra]); } /** * Get full info about peer, returns an FullInfo object. * * @param mixed $id Peer * * @see https://docs.madelineproto.xyz/FullInfo.html * * @return \Amp\Promise FullInfo object * * @psalm-return \Amp\Promise */ public function getFullInfo($id, array $extra = []) { return $this->__call(__FUNCTION__, [$id, $extra]); } /** * Get async HTTP client. * * @psalm-return \Amp\Http\Client\HttpClient|\Amp\Promise<\Amp\Http\Client\HttpClient> */ public function getHTTPClient() { return $this->__call(__FUNCTION__, []); } /** * Get current password hint. * * @psalm-return string|\Amp\Promise */ public function getHint() { return $this->__call(__FUNCTION__, []); } /** * Get bot API ID from peer object. * * @param mixed $id Peer * @psalm-return ??int|\Amp\Promise */ public function getId($id) { return $this->__call(__FUNCTION__, [$id]); } /** * Get info about peer, returns an Info object. * * @param mixed $id Peer * @param MTProto::INFO_TYPE_* $type Whether to generate an Input*, an InputPeer or the full set of constructors * * @see https://docs.madelineproto.xyz/Info.html * * @return \Amp\Promise Info object * * @template TConstructor * @psalm-param array{_: TConstructor}|mixed $id * * @return (((mixed|string)[]|mixed|string)[]|int|mixed|string)[] * * @psalm-return \Generator|array, mixed, array{ * TConstructor: array * InputPeer: array{_: string, user_id?: mixed, access_hash?: mixed, min?: mixed, chat_id?: mixed, channel_id?: mixed}, * Peer: array{_: string, user_id?: mixed, chat_id?: mixed, channel_id?: mixed}, * DialogPeer: array{_: string, peer: array{_: string, user_id?: mixed, chat_id?: mixed, channel_id?: mixed}}, * NotifyPeer: array{_: string, peer: array{_: string, user_id?: mixed, chat_id?: mixed, channel_id?: mixed}}, * InputDialogPeer: array{_: string, peer: array{_: string, user_id?: mixed, access_hash?: mixed, min?: mixed, chat_id?: mixed, channel_id?: mixed}}, * InputNotifyPeer: array{_: string, peer: array{_: string, user_id?: mixed, access_hash?: mixed, min?: mixed, chat_id?: mixed, channel_id?: mixed}}, * bot_api_id: int|string, * user_id?: int, * chat_id?: int, * channel_id?: int, * InputUser?: array{_: string, user_id?: int, access_hash?: mixed, min?: bool}, * InputChannel?: array{_: string, channel_id: int, access_hash: mixed, min: bool}, * type: string * }>|int|array{_: string, user_id?: mixed, access_hash?: mixed, min?: mixed, chat_id?: mixed, channel_id?: mixed}|array{_: string, user_id?: int, access_hash?: mixed, min?: bool}|array{_: string, channel_id: int, access_hash: mixed, min: bool} */ public function getInfo($id, int $type = \danog\MadelineProto\MTProto::INFO_TYPE_ALL, array $extra = []) { return $this->__call(__FUNCTION__, [$id, $type, $extra]); } /** * Get logger. * @psalm-return \danog\MadelineProto\Logger|\Amp\Promise<\danog\MadelineProto\Logger> */ public function getLogger() { return $this->__call(__FUNCTION__, []); } /** * Get TL namespaces. * * @psalm-return array|\Amp\Promise */ public function getMethodNamespaces() { return $this->__call(__FUNCTION__, []); } /** * Get namespaced methods (method => namespace). * * @psalm-return array|\Amp\Promise */ public function getMethodsNamespaced() { return $this->__call(__FUNCTION__, []); } /** * Get mime type from buffer. * * @param string $buffer Buffer * */ public static function getMimeFromBuffer(string $buffer): string { return \danog\MadelineProto\TL\Conversion\Extension::getMimeFromBuffer($buffer); } /** * Get mime type from file extension. * * @param string $extension File extension * @param string $default Default mime type * */ public static function getMimeFromExtension(string $extension, string $default): string { return \danog\MadelineProto\TL\Conversion\Extension::getMimeFromExtension($extension, $default); } /** * Get mime type of file. * * @param string $file File * */ public static function getMimeFromFile(string $file): string { return \danog\MadelineProto\TL\Conversion\Extension::getMimeFromFile($file); } /** * Get download info of the propic of a user * Returns an array with the following structure:. * * `$info['ext']` - The file extension * `$info['name']` - The file name, without the extension * `$info['mime']` - The file mime type * `$info['size']` - The file size * * * @return \Amp\Promise */ public function getPropicInfo($data, array $extra = []) { return $this->__call(__FUNCTION__, [$data, $extra]); } /** * Get PSR logger. * @psalm-return \Psr\Log\LoggerInterface|\Amp\Promise<\Psr\Log\LoggerInterface> */ public function getPsrLogger() { return $this->__call(__FUNCTION__, []); } /** * Get full info about peer (including full list of channel members), returns a Chat object. * * @param mixed $id Peer * * @see https://docs.madelineproto.xyz/Chat.html * * @return \Amp\Promise Chat object */ public function getPwrChat($id, bool $fullfetch = true, array $extra = []) { return $this->__call(__FUNCTION__, [$id, $fullfetch, $extra]); } /** * Get secret chat. * * @param array|int $chat Secret chat ID * * @psalm-return array|\Amp\Promise */ public function getSecretChat($chat) { return $this->__call(__FUNCTION__, [$chat]); } /** * Get info about the logged-in user, cached. * * Use fullGetSelf to bypass the cache. * * @psalm-return array|false|\Amp\Promise */ public function getSelf() { return $this->__call(__FUNCTION__, []); } /** * Return current settings. * * @psalm-return \danog\MadelineProto\Settings|\Amp\Promise<\danog\MadelineProto\Settings> */ public function getSettings() { return $this->__call(__FUNCTION__, []); } /** * Get sponsored messages for channel. * This method will return an array of [sponsored message objects](https://docs.madelineproto.xyz/API_docs/constructors/sponsoredMessage.html). * * See [the API documentation](https://core.telegram.org/api/sponsored-messages) for more info on how to handle sponsored messages. * * @param int|array $peer Channel ID, or Update, or Message, or Peer. * @return \Amp\Promise */ public function getSponsoredMessages($peer, array $extra = []) { return $this->__call(__FUNCTION__, [$peer, $extra]); } /** * Get TL serializer. * * @psalm-return \danog\MadelineProto\TL\TL|\Amp\Promise<\danog\MadelineProto\TL\TL> */ public function getTL() { return $this->__call(__FUNCTION__, []); } /** * Accesses a private variable from an object. * * @param object $obj Object * @param string $var Attribute name * * @psalm-suppress InvalidScope * * @access public */ public static function getVar($obj, string $var) { return \danog\MadelineProto\Tools::getVar($obj, $var); } /** * Get a message to show to the user when starting the bot. * * @psalm-return string|\Amp\Promise */ public function getWebMessage(string $message) { return $this->__call(__FUNCTION__, [$message]); } /** * Get web template. * * @psalm-return string|\Amp\Promise */ public function getWebTemplate() { return $this->__call(__FUNCTION__, []); } /** * Checks whether all datacenters are authorized. * * @psalm-return bool|\Amp\Promise */ public function hasAllAuth() { return $this->__call(__FUNCTION__, []); } /** * Check if an event handler instance is present. * * @psalm-return bool|\Amp\Promise */ public function hasEventHandler() { return $this->__call(__FUNCTION__, []); } /** * Check if has report peers. * * @psalm-return bool|\Amp\Promise */ public function hasReportPeers() { return $this->__call(__FUNCTION__, []); } /** * Check whether secret chat exists. * * @param array|int $chat Secret chat ID * * @psalm-return bool|\Amp\Promise */ public function hasSecretChat($chat) { return $this->__call(__FUNCTION__, [$chat]); } /** * Checks private property exists in an object. * * @param object $obj Object * @param string $var Attribute name * * @psalm-suppress InvalidScope * * @access public */ public static function hasVar($obj, string $var): bool { return \danog\MadelineProto\Tools::hasVar($obj, $var); } /** * Import authorization. * * @param array $authorization Authorization info * @param int $mainDcID Main DC ID * * @return \Amp\Promise */ public function importAuthorization(array $authorization, int $mainDcID, array $extra = []) { return $this->__call(__FUNCTION__, [$authorization, $mainDcID, $extra]); } /** * Inflate stripped photosize to full JPG payload. * * @param string $stripped Stripped photosize * * @return string JPG payload */ public static function inflateStripped(string $stripped): string { return \danog\MadelineProto\Tools::inflateStripped($stripped); } /** * Initialize self-restart hack. * * @psalm-return void|\Amp\Promise */ public function initSelfRestart(): void { $this->__call(__FUNCTION__, []); } /** * Whether this is altervista. * * @return boolean */ public static function isAltervista(): bool { return \danog\MadelineProto\Tools::isAltervista(); } /** * Check if is array or similar (traversable && countable && arrayAccess). * * @param mixed $var Value to check * * @return boolean */ public static function isArrayOrAlike($var): bool { return \danog\MadelineProto\Tools::isArrayOrAlike($var); } /** * Whether we're an IPC client instance. * * @psalm-return bool|\Amp\Promise */ public function isIpc() { return $this->__call(__FUNCTION__, []); } /** * Whether we're an IPC server process (as opposed to an event handler). * * @psalm-return bool|\Amp\Promise */ public function isIpcWorker() { return $this->__call(__FUNCTION__, []); } /** * Returns whether the current user is a premium user, cached. * @psalm-return bool|\Amp\Promise */ public function isPremium() { return $this->__call(__FUNCTION__, []); } /** * Check whether provided bot API ID is a channel. * * @param int $id Bot API ID * * @return boolean */ public static function isSupergroup($id): bool { return \danog\MadelineProto\MTProto::isSupergroup($id); } /** * Logger. * * @param string $param Parameter * @param int $level Logging level * @param string $file File where the message originated * * @psalm-return void|\Amp\Promise */ public function logger($param, int $level = \danog\MadelineProto\Logger::NOTICE, string $file = ''): void { $this->__call(__FUNCTION__, [$param, $level, $file]); } /** * Log out currently logged in user. * * @return \Amp\Promise */ public function logout(array $extra = []) { return $this->__call(__FUNCTION__, [$extra]); } /** * Start MadelineProto's update handling loop, or run the provided async callable. * * @param callable|null $callback Async callable to run * * @return \Amp\Promise */ public function loop($callback = null, array $extra = []) { return $this->__call(__FUNCTION__, [$callback, $extra]); } /** * Start MadelineProto's update handling loop in background. * * @return Amp\Promise */ public function loopFork(array $extra = []) { return $this->__call(__FUNCTION__, [$extra]); } /** * Escape string for markdown. * * @param string $hwat String to escape * */ public static function markdownEscape(string $hwat): string { return \danog\MadelineProto\StrTools::markdownEscape($hwat); } /** * Telegram UTF-8 multibyte split. * * @param string $text Text * @param integer $length Length * * @return array */ public static function mbStrSplit(string $text, int $length): array { return \danog\MadelineProto\StrTools::mbStrSplit($text, $length); } /** * Get Telegram UTF-8 length of string. * * @param string $text Text * * @return float|int */ public static function mbStrlen(string $text) { return \danog\MadelineProto\StrTools::mbStrlen($text); } /** * Telegram UTF-8 multibyte substring. * * @param string $text Text to substring * @param integer $offset Offset * @param ?int $length Length * */ public static function mbSubstr(string $text, int $offset, $length = null): string { return \danog\MadelineProto\StrTools::mbSubstr($text, $offset, $length); } /** * Call method and wait asynchronously for response. * * If the $aargs['noResponse'] is true, will not wait for a response. * * @param string $method Method name * @param array|\Generator $args Arguments * @param array $aargs Additional arguments * * @psalm-param array|\Generator $args * * @return \Amp\Promise */ public function methodCall(string $method, $args = [ ], array $aargs = [ 'msg_id' => null, ], array $extra = []) { return $this->__call(__FUNCTION__, [$method, $args, $aargs, $extra]); } /** * Call method and make sure it is asynchronously sent. * * @param string $method Method name * @param array|\Generator $args Arguments * @param array $aargs Additional arguments * * @psalm-param array|\Generator $args * * @return \Amp\Promise */ public function methodCallWrite(string $method, $args = [ ], array $aargs = [ 'msg_id' => null, ], array $extra = []) { return $this->__call(__FUNCTION__, [$method, $args, $aargs, $extra]); } /** * Escape method name. * * @param string $method Method name * */ public static function methodEscape(string $method): string { return \danog\MadelineProto\StrTools::methodEscape($method); } /** * Convert double to binary version. * * @param float $value Value to convert * */ public static function packDouble(float $value): string { return \danog\MadelineProto\Tools::packDouble($value); } /** * Convert integer to base256 signed int. * * @param integer $value Value to convert * */ public static function packSignedInt(int $value): string { return \danog\MadelineProto\Tools::packSignedInt($value); } /** * Convert integer to base256 long. * * @param int $value Value to convert * */ public static function packSignedLong(int $value): string { return \danog\MadelineProto\Tools::packSignedLong($value); } /** * Convert value to unsigned base256 int. * * @param int $value Value * */ public static function packUnsignedInt(int $value): string { return \danog\MadelineProto\Tools::packUnsignedInt($value); } /** * Check if peer is present in internal peer database. * * @param mixed $id Peer * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function peerIsset($id, array $extra = []) { return $this->__call(__FUNCTION__, [$id, $extra]); } /** * Login as user. * * @param string $number Phone number * @param integer $sms_type SMS type * * @return \Amp\Promise */ public function phoneLogin($number, $sms_type = 5, array $extra = []) { return $this->__call(__FUNCTION__, [$number, $sms_type, $extra]); } /** * Positive modulo * Works just like the % (modulus) operator, only returns always a postive number. * * @param int $a A * @param int $b B * * @return int Modulo */ public static function posmod(int $a, int $b): int { return \danog\MadelineProto\Tools::posmod($a, $b); } /** * Get random string of specified length. * * @param integer $length Length * * @return string Random string */ public static function random(int $length): string { return \danog\MadelineProto\Tools::random($length); } /** * Get random integer. * * @param integer $modulus Modulus * */ public static function randomInt(int $modulus = 0): int { return \danog\MadelineProto\Tools::randomInt($modulus); } /** * Asynchronously read line. * * @param string $prompt Prompt * * @return \Amp\Promise */ public static function readLine(string $prompt = '') { return \danog\MadelineProto\Tools::readLine($prompt); } /** * Refresh full peer cache for a certain peer. * * @param mixed $id The peer to refresh * @return \Amp\Promise */ public function refreshFullPeerCache($id, array $extra = []) { return $this->__call(__FUNCTION__, [$id, $extra]); } /** * Refresh peer cache for a certain peer. * * @param mixed $id The peer to refresh * @return \Amp\Promise */ public function refreshPeerCache($id, array $extra = []) { return $this->__call(__FUNCTION__, [$id, $extra]); } /** * Rekey secret chat. * * @param int $chat Secret chat to rekey * * @return \Amp\Promise */ public function rekey(int $chat, array $extra = []) { return $this->__call(__FUNCTION__, [$chat, $extra]); } /** * Report an error to the previously set peer. * * @param string $message Error to report * @param string $parseMode Parse mode * * @return \Amp\Promise */ public function report(string $message, string $parseMode = '', array $extra = []) { return $this->__call(__FUNCTION__, [$message, $parseMode, $extra]); } /** * Request VoIP call. * * @param mixed $user User * * @return \Amp\Promise */ public function requestCall($user, array $extra = []) { return $this->__call(__FUNCTION__, [$user, $extra]); } /** * Request secret chat. * * @param mixed $user User to start secret chat with * * @return \Amp\Promise */ public function requestSecretChat($user, array $extra = []) { return $this->__call(__FUNCTION__, [$user, $extra]); } /** * Reset the update state and fetch all updates from the beginning. * * @psalm-return void|\Amp\Promise */ public function resetUpdateState(): void { $this->__call(__FUNCTION__, []); } /** * Restart update loop. * * @psalm-return void|\Amp\Promise */ public function restart(): void { $this->__call(__FUNCTION__, []); } /** * Rethrow error catched in strand. * * @param \Throwable $e Exception * @param string $file File where the strand started * * @psalm-suppress InvalidScope * */ public static function rethrow(\Throwable $e, $file = ''): void { \danog\MadelineProto\Tools::rethrow($e, $file); } /** * null-byte RLE decode. * * @param string $string Data to decode * */ public static function rleDecode(string $string): string { return \danog\MadelineProto\Tools::rleDecode($string); } /** * null-byte RLE encode. * * @param string $string Data to encode * */ public static function rleEncode(string $string): string { return \danog\MadelineProto\Tools::rleEncode($string); } /** * Get secret chat status. * * @param int $chat Chat ID * * @psalm-return int|\Amp\Promise */ public function secretChatStatus(int $chat) { return $this->__call(__FUNCTION__, [$chat]); } /** * Serialize all instances. * * CALLED ONLY ON SHUTDOWN. * */ public static function serializeAll(): void { \danog\MadelineProto\MTProto::serializeAll(); } /** * Set update handling callback. * * @param callable $callback Callback * * @psalm-return void|\Amp\Promise */ public function setCallback($callback): void { $this->__call(__FUNCTION__, [$callback]); } /** * Set event handler. * * @param class-string $eventHandler Event handler * * @return \Amp\Promise */ public function setEventHandler(string $eventHandler, array $extra = []) { return $this->__call(__FUNCTION__, [$eventHandler, $extra]); } /** * Set NOOP update handler, ignoring all updates. * * @psalm-return void|\Amp\Promise */ public function setNoop(): void { $this->__call(__FUNCTION__, []); } /** * Set peer(s) where to send errors occurred in the event loop. * * @param int|string $userOrId Username(s) or peer ID(s) * * @return \Amp\Promise */ public function setReportPeers($userOrId, array $extra = []) { return $this->__call(__FUNCTION__, [$userOrId, $extra]); } /** * Sets a private variable in an object. * * @param object $obj Object * @param string $var Attribute name * @param mixed $val Attribute value * * @psalm-suppress InvalidScope * * * @access public */ public static function setVar($obj, string $var, &$val): void { \danog\MadelineProto\Tools::setVar($obj, $var, $val); } /** * Set web template. * * @param string $template Template * * @psalm-return void|\Amp\Promise */ public function setWebTemplate(string $template): void { $this->__call(__FUNCTION__, [$template]); } /** * Set webhook update handler. * * @param string $hook_url Webhook URL * @param string $pem_path PEM path for self-signed certificate * * @psalm-return void|\Amp\Promise */ public function setWebhook(string $hook_url, string $pem_path = ''): void { $this->__call(__FUNCTION__, [$hook_url, $pem_path]); } /** * Setup logger. * * @psalm-return void|\Amp\Promise */ public function setupLogger(): void { $this->__call(__FUNCTION__, []); } /** * Asynchronously sleep. * * @param int|float $time Number of seconds to sleep for * * @return Amp\Promise */ public static function sleep($time) { return \danog\MadelineProto\Tools::sleep($time); } /** * Resolves with a two-item array delineating successful and failed Promise results. * The returned promise will only fail if the given number of required promises fail. * * @param array $promises Promises * * @return Amp\Promise */ public static function some(array $promises) { return \danog\MadelineProto\Tools::some($promises); } /** * Log in to telegram (via CLI or web). * * @return \Amp\Promise */ public function start(array $extra = []) { return $this->__call(__FUNCTION__, [$extra]); } /** * Stop update loop. * * @psalm-return void|\Amp\Promise */ public function stop(): void { $this->__call(__FUNCTION__, []); } /** * Convert TD to MTProto parameters. * * @param array $params Parameters * * @return \Amp\Promise */ public function tdToMTProto(array $params, array $extra = []) { return $this->__call(__FUNCTION__, [$params, $extra]); } /** * Convert TD parameters to tdcli. * * @param mixed $params Parameters * */ public function tdToTdcli($params, array $extra = []) { return $this->__call(__FUNCTION__, [$params, $extra]); } /** * Convert tdcli parameters to tdcli. * * @param array $params Params * @param array $key Key * * @psalm-return array|\Amp\Promise */ public function tdcliToTd(&$params, $key = null) { return $this->__call(__FUNCTION__, [$params, $key]); } /** * Create an artificial timeout for any \Generator or Promise. * * @param \Generator|Promise $promise * @param integer $timeout * * @return Amp\Promise */ public static function timeout($promise, int $timeout) { return \danog\MadelineProto\Tools::timeout($promise, $timeout); } /** * Creates an artificial timeout for any `Promise`. * * If the promise is resolved before the timeout expires, the result is returned * * If the timeout expires before the promise is resolved, a default value is returned * * @template TReturnAlt * @template TReturn * @template TGenerator as \Generator * * @param Promise|Generator $promise Promise to which the timeout is applied. * @param int $timeout Timeout in milliseconds. * * @psalm-param Promise|TGenerator $promise Promise to which the timeout is applied. * @psalm-param TReturnAlt $default * * @return \Amp\Promise|Promise * * @throws \TypeError If $promise is not an instance of \Amp\Promise, \Generator or \React\Promise\PromiseInterface. */ public static function timeoutWithDefault($promise, int $timeout, $default = null) { return \danog\MadelineProto\Tools::timeoutWithDefault($promise, $timeout, $default); } /** * Convert to camelCase. * * @param string $input String * */ public static function toCamelCase(string $input): string { return \danog\MadelineProto\StrTools::toCamelCase($input); } /** * Convert to snake_case. * * @param string $input String * */ public static function toSnakeCase(string $input): string { return \danog\MadelineProto\StrTools::toSnakeCase($input); } /** * Convert MTProto channel ID to bot API channel ID. * * @param int $id MTProto channel ID * */ public static function toSupergroup($id): int { return \danog\MadelineProto\MTProto::toSupergroup($id); } /** * Escape type name. * * @param string $type String to escape * */ public static function typeEscape(string $type): string { return \danog\MadelineProto\StrTools::typeEscape($type); } /** * Unpack binary double. * * @param string $value Value to unpack * */ public static function unpackDouble(string $value): float { return \danog\MadelineProto\Tools::unpackDouble($value); } /** * Unpack bot API file ID. * * @param string $fileId Bot API file ID * * @psalm-return array|\Amp\Promise */ public function unpackFileId(string $fileId) { return $this->__call(__FUNCTION__, [$fileId]); } /** * Unpack base256 signed int. * * @param string $value base256 int * * @return integer */ public static function unpackSignedInt(string $value): int { return \danog\MadelineProto\Tools::unpackSignedInt($value); } /** * Unpack base256 signed long. * * @param string $value base256 long * * @return integer */ public static function unpackSignedLong(string $value): int { return \danog\MadelineProto\Tools::unpackSignedLong($value); } /** * Unpack base256 signed long to string. * * @param string|int|array $value base256 long * */ public static function unpackSignedLongString($value): string { return \danog\MadelineProto\Tools::unpackSignedLongString($value); } /** * Unset event handler. * * @param bool $disableUpdateHandling Whether to also disable internal update handling (will cause errors, otherwise will simply use the NOOP handler) * * @psalm-return void|\Amp\Promise */ public function unsetEventHandler(bool $disableUpdateHandling = false): void { $this->__call(__FUNCTION__, [$disableUpdateHandling]); } /** * Update the 2FA password. * * The params array can contain password, new_password, email and hint params. * * @param array $params The params * * @return \Amp\Promise */ public function update2fa(array $params, array $extra = []) { return $this->__call(__FUNCTION__, [$params, $extra]); } /** * Parse, update and store settings. * * @param SettingsAbstract $settings Settings * * @return \Amp\Promise */ public function updateSettings(\danog\MadelineProto\SettingsAbstract $settings, array $extra = []) { return $this->__call(__FUNCTION__, [$settings, $extra]); } /** * Upload file. * * @param FileCallbackInterface|string|array $file File, URL or Telegram file to upload * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function upload($file, string $fileName = '', $cb = null, bool $encrypted = false, array $extra = []) { return $this->__call(__FUNCTION__, [$file, $fileName, $cb, $encrypted, $extra]); } /** * Upload file to secret chat. * * @param FileCallbackInterface|string|array $file File, URL or Telegram file to upload * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function uploadEncrypted($file, string $fileName = '', $cb = null, array $extra = []) { return $this->__call(__FUNCTION__, [$file, $fileName, $cb, $extra]); } /** * Upload file from callable. * * The callable must accept two parameters: int $offset, int $size * The callable must return a string with the contest of the file at the specified offset and size. * * @param mixed $callable Callable * @param integer $size File size * @param string $mime Mime type * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $seekable Whether chunks can be fetched out of order * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function uploadFromCallable(callable $callable, int $size, string $mime, string $fileName = '', $cb = null, bool $seekable = true, bool $encrypted = false, array $extra = []) { return $this->__call(__FUNCTION__, [$callable, $size, $mime, $fileName, $cb, $seekable, $encrypted, $extra]); } /** * Upload file from stream. * * @param mixed $stream PHP resource or AMPHP async stream * @param integer $size File size * @param string $mime Mime type * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function uploadFromStream($stream, int $size, string $mime, string $fileName = '', $cb = null, bool $encrypted = false, array $extra = []) { return $this->__call(__FUNCTION__, [$stream, $size, $mime, $fileName, $cb, $encrypted, $extra]); } /** * Reupload telegram file. * * @param mixed $media Telegram file * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function uploadFromTgfile($media, $cb = null, bool $encrypted = false, array $extra = []) { return $this->__call(__FUNCTION__, [$media, $cb, $encrypted, $extra]); } /** * Upload file from URL. * * @param string|FileCallbackInterface $url URL of file * @param integer $size Size of file * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Amp\Promise * @return \Amp\Promise */ public function uploadFromUrl($url, int $size = 0, string $fileName = '', $cb = null, bool $encrypted = false, array $extra = []) { return $this->__call(__FUNCTION__, [$url, $size, $fileName, $cb, $encrypted, $extra]); } /** * Mark sponsored message as read. * * @param int|array $peer Channel ID, or Update, or Message, or Peer. * @param string|array{random_id: string} $message Random ID or sponsored message to mark as read. * * @return \Amp\Promise Bool */ public function viewSponsoredMessage($peer, $message, array $extra = []) { return $this->__call(__FUNCTION__, [$peer, $message, $extra]); } /** * Synchronously wait for a promise|generator. * * @param \Generator|Promise $promise The promise to wait for * @param boolean $ignoreSignal Whether to ignore shutdown signals * */ public static function wait($promise, $ignoreSignal = false) { return \danog\MadelineProto\Tools::wait($promise, $ignoreSignal); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Deferred; use Amp\Promise; use Amp\Success; use Amp\Sync\LocalMutex; use danog\MadelineProto\Loop\Generic\PeriodicLoopInternal; use danog\MadelineProto\MTProto\AuthKey; use danog\MadelineProto\MTProto\OutgoingMessage; use danog\MadelineProto\MTProto\PermAuthKey; use danog\MadelineProto\MTProto\TempAuthKey; use danog\MadelineProto\MTProtoTools\Crypt; use danog\MadelineProto\Settings\Connection as ConnectionSettings; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\MTProtoTransport\HttpsStream; use danog\MadelineProto\Stream\MTProtoTransport\HttpStream; use danog\MadelineProto\Stream\Transport\WssStream; use JsonSerializable; /** * Datacenter connection. */ class DataCenterConnection implements JsonSerializable { const READ_WEIGHT = 1; const READ_WEIGHT_MEDIA = 5; const WRITE_WEIGHT = 10; /** * Promise for connection. * * @var Promise */ private $connectionsPromise; /** * Deferred for connection. * * @var Deferred */ private $connectionsDeferred; /** * Temporary auth key. * * @var TempAuthKey|null */ private $tempAuthKey; /** * Permanent auth key. * * @var PermAuthKey|null */ private $permAuthKey; /** * Connections open to a certain DC. * * @var array */ private $connections = []; /** * Connection weights. * * @var array */ private $availableConnections = []; /** * Main API instance. * * @var \danog\MadelineProto\MTProto */ private $API; /** * Connection context. * * @var ConnectionContext */ private $ctx; /** * DC ID. * * @var string */ private $datacenter; /** * Linked DC ID. * * @var string */ private $linked; /** * Loop to keep weights at sane value. */ private ?PeriodicLoopInternal $robinLoop = null; /** * Decrement roundrobin weight by this value if busy reading. * * @var integer */ private $decRead = 1; /** * Decrement roundrobin weight by this value if busy writing. * * @var integer */ private $decWrite = 10; /** * Backed up messages. * * @var array */ private $backup = []; /** * Whether this socket has to be reconnected. * * @var boolean */ private $needsReconnect = false; /** * Indicate if this socket needs to be reconnected. * * @param boolean $needsReconnect Whether the socket has to be reconnected * */ public function needReconnect(bool $needsReconnect): void { $this->needsReconnect = $needsReconnect; } /** * Whether this sockets needs to be reconnected. * * @return boolean */ public function shouldReconnect(): bool { return $this->needsReconnect; } private ?LocalMutex $initingAuth = null; /** * Init auth keys for single DC. * * @internal * */ public function initAuthorization(): \Generator { $logger = $this->API->logger; $this->initingAuth ??= new LocalMutex; $lock = yield $this->initingAuth->acquire(); try { $logger->logger("Initing auth for DC {$this->datacenter}", Logger::NOTICE); yield from $this->waitGetConnection(); $connection = $this->getAuthConnection(); $this->createSession(); $cdn = $this->isCDN(); $media = $this->isMedia(); $pfs = $this->API->settings->getAuth()->getPfs(); if (!$this->hasTempAuthKey() || !$this->hasPermAuthKey() || !$this->isBound()) { if (!$this->hasPermAuthKey() && !$cdn && !$media) { $logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['gen_perm_auth_key'], $this->datacenter), \danog\MadelineProto\Logger::NOTICE); $this->setPermAuthKey(yield from $connection->createAuthKey(false)); } if ($media) { $this->link(\intval($this->datacenter)); if ($this->hasTempAuthKey()) { return; } } if ($pfs) { if (!$cdn) { $logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['gen_temp_auth_key'], $this->datacenter), \danog\MadelineProto\Logger::NOTICE); $this->setTempAuthKey(null); $this->setTempAuthKey(yield from $connection->createAuthKey(true)); yield from $this->bindTempAuthKey(); yield from $connection->methodCallAsyncRead('help.getConfig', []); yield from $this->syncAuthorization(); } elseif (!$this->hasTempAuthKey()) { $logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['gen_temp_auth_key'], $this->datacenter), \danog\MadelineProto\Logger::NOTICE); $this->setTempAuthKey(yield from $connection->createAuthKey(true)); } } else { if (!$cdn) { $this->bind(false); yield from $connection->methodCallAsyncRead('help.getConfig', []); yield from $this->syncAuthorization(); } elseif (!$this->hasTempAuthKey()) { $logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['gen_temp_auth_key'], $this->datacenter), \danog\MadelineProto\Logger::NOTICE); $this->setTempAuthKey(yield from $connection->createAuthKey(true)); } } $this->flush(); } elseif (!$cdn) { yield from $this->syncAuthorization(); } } finally { $lock->release(); } if ($this->hasTempAuthKey()) { $connection->pingHttpWaiter(); } } /** * Bind temporary and permanent auth keys. * * * @internal * * * @psalm-return \Generator */ public function bindTempAuthKey(): \Generator { $connection = $this->getAuthConnection(); $logger = $this->API->logger; $expires_in = $this->API->settings->getAuth()->getDefaultTempAuthKeyExpiresIn(); for ($retry_id_total = 1; $retry_id_total <= $this->API->settings->getAuth()->getMaxAuthTries(); $retry_id_total++) { try { $logger->logger('Binding authorization keys...', \danog\MadelineProto\Logger::VERBOSE); $nonce = \danog\MadelineProto\Tools::random(8); $expires_at = \time() + $expires_in; $temp_auth_key_id = $this->getTempAuthKey()->getID(); $perm_auth_key_id = $this->getPermAuthKey()->getID(); $temp_session_id = $connection->session_id; $message_data = (yield from $this->API->getTL()->serializeObject(['type' => ''], ['_' => 'bind_auth_key_inner', 'nonce' => $nonce, 'temp_auth_key_id' => $temp_auth_key_id, 'perm_auth_key_id' => $perm_auth_key_id, 'temp_session_id' => $temp_session_id, 'expires_at' => $expires_at], 'bindTempAuthKey_inner')); $message_id = $connection->msgIdHandler->generateMessageId(); $seq_no = 0; $encrypted_data = \danog\MadelineProto\Tools::random(16).$message_id.\pack('VV', $seq_no, \strlen($message_data)).$message_data; $message_key = \substr(\sha1($encrypted_data, true), -16); $padding = \danog\MadelineProto\Tools::random(\danog\MadelineProto\Tools::posmod(-\strlen($encrypted_data), 16)); list($aes_key, $aes_iv) = Crypt::oldAesCalculate($message_key, $this->getPermAuthKey()->getAuthKey()); $encrypted_message = $this->getPermAuthKey()->getID().$message_key.Crypt::igeEncrypt($encrypted_data.$padding, $aes_key, $aes_iv); $res = yield from $connection->methodCallAsyncRead('auth.bindTempAuthKey', ['perm_auth_key_id' => $perm_auth_key_id, 'nonce' => $nonce, 'expires_at' => $expires_at, 'encrypted_message' => $encrypted_message], ['msg_id' => $message_id]); if ($res === true) { $logger->logger("Bound temporary and permanent authorization keys, DC {$this->datacenter}", \danog\MadelineProto\Logger::NOTICE); $this->bind(); return true; } } catch (\danog\MadelineProto\SecurityException $e) { $logger->logger('An exception occurred while generating the authorization key: '.$e->getMessage().' Retrying (try number '.$retry_id_total.')...', \danog\MadelineProto\Logger::WARNING); } catch (\danog\MadelineProto\Exception $e) { $logger->logger('An exception occurred while generating the authorization key: '.$e->getMessage().' Retrying (try number '.$retry_id_total.')...', \danog\MadelineProto\Logger::WARNING); } catch (\danog\MadelineProto\RPCErrorException $e) { $logger->logger('An RPCErrorException occurred while generating the authorization key: '.$e->getMessage().' Retrying (try number '.$retry_id_total.')...', \danog\MadelineProto\Logger::WARNING); } } throw new \danog\MadelineProto\SecurityException('An error occurred while binding temporary and permanent authorization keys.'); } /** * Sync authorization data between DCs. * */ private function syncAuthorization(): \Generator { $socket = $this->getAuthConnection(); $logger = $this->API->logger; if ($this->API->authorized === MTProto::LOGGED_IN && !$this->isAuthorized()) { foreach ($this->API->datacenter->getDataCenterConnections() as $authorized_dc_id => $authorized_socket) { if ($this->API->authorized_dc !== -1 && $authorized_dc_id !== $this->API->authorized_dc) { continue; } if ($authorized_socket->hasTempAuthKey() && $authorized_socket->hasPermAuthKey() && $authorized_socket->isAuthorized() && $this->API->authorized === MTProto::LOGGED_IN && !$this->isAuthorized() && !$authorized_socket->isCDN() ) { try { $logger->logger('Trying to copy authorization from DC '.$authorized_dc_id.' to DC '.$this->datacenter); $exported_authorization = yield from $this->API->methodCallAsyncRead('auth.exportAuthorization', ['dc_id' => \preg_replace('|_.*|', '', $this->datacenter)], ['datacenter' => $authorized_dc_id]); $authorization = yield from $socket->methodCallAsyncRead('auth.importAuthorization', $exported_authorization); $this->authorized(true); break; } catch (\danog\MadelineProto\Exception $e) { $logger->logger('Failure while syncing authorization from DC '.$authorized_dc_id.' to DC '.$this->datacenter.': '.$e->getMessage(), \danog\MadelineProto\Logger::ERROR); } catch (\danog\MadelineProto\RPCErrorException $e) { $logger->logger('Failure while syncing authorization from DC '.$authorized_dc_id.' to DC '.$this->datacenter.': '.$e->getMessage(), \danog\MadelineProto\Logger::ERROR); if ($e->rpc === 'DC_ID_INVALID') { break; } } // Turns out this DC isn't authorized after all } } } } /** * Get auth key. * * @param boolean $temp Whether to fetch the temporary auth key * */ public function getAuthKey(bool $temp = true): AuthKey { if ($this->{$temp ? 'tempAuthKey' : 'permAuthKey'} === null) { throw new NothingInTheSocketException(); } return $this->{$temp ? 'tempAuthKey' : 'permAuthKey'}; } /** * Check if auth key is present. * * */ public function hasAuthKey(bool $temp = true): bool { return $this->{$temp ? 'tempAuthKey' : 'permAuthKey'} !== null && $this->{$temp ? 'tempAuthKey' : 'permAuthKey'}->hasAuthKey(); } /** * Set auth key. * * @param AuthKey|null $key The auth key * */ public function setAuthKey(?AuthKey $key, bool $temp = true): void { $this->{$temp ? 'tempAuthKey' : 'permAuthKey'} = $key; } /** * Get temporary authorization key. * */ public function getTempAuthKey(): TempAuthKey { return $this->getAuthKey(true); } /** * Get permanent authorization key. * */ public function getPermAuthKey(): PermAuthKey { return $this->getAuthKey(false); } /** * Check if has temporary authorization key. * * @return boolean */ public function hasTempAuthKey(): bool { return $this->hasAuthKey(true); } /** * Check if has permanent authorization key. * * @return boolean */ public function hasPermAuthKey(): bool { return $this->hasAuthKey(false); } /** * Set temporary authorization key. * * @param TempAuthKey|null $key Auth key * */ public function setTempAuthKey(?TempAuthKey $key): void { $this->setAuthKey($key, true); } /** * Set permanent authorization key. * * @param PermAuthKey|null $key Auth key * */ public function setPermAuthKey(?PermAuthKey $key): void { $this->setAuthKey($key, false); } /** * Bind temporary and permanent auth keys. * * @param bool $pfs Whether to bind using PFS * */ public function bind(bool $pfs = true): void { if (!$pfs && !$this->tempAuthKey) { $this->tempAuthKey = new TempAuthKey(); } $this->tempAuthKey->bind($this->permAuthKey, $pfs); } /** * Check if auth keys are bound. * * @return boolean */ public function isBound(): bool { return $this->tempAuthKey ? $this->tempAuthKey->isBound() : false; } /** * Check if we are logged in. * * @return boolean */ public function isAuthorized(): bool { return $this->hasTempAuthKey() ? $this->getTempAuthKey()->isAuthorized() : false; } /** * Set the authorized boolean. * * @param boolean $authorized Whether we are authorized * */ public function authorized(bool $authorized): void { if ($authorized) { $this->getTempAuthKey()->authorized($authorized); } elseif ($this->hasTempAuthKey()) { $this->getTempAuthKey()->authorized($authorized); } } /** * Link permanent authorization info of main DC to media DC. * * @param string $dc Main DC ID * */ public function link(string $dc): void { $this->linked = $dc; $this->permAuthKey =& $this->API->datacenter->getDataCenterConnection($dc)->permAuthKey; } /** * Reset MTProto sessions. * */ public function resetSession(): void { foreach ($this->connections as $socket) { $socket->resetSession(); } } /** * Create MTProto sessions if needed. * */ public function createSession(): void { foreach ($this->connections as $socket) { $socket->createSession(); } } /** * Flush all pending packets. * */ public function flush(): void { $this->API->logger->logger("Flushing pending messages, DC {$this->datacenter}", \danog\MadelineProto\Logger::NOTICE); foreach ($this->connections as $socket) { $socket->flush(); } } /** * Get connection context. * */ public function getCtx(): ConnectionContext { return $this->ctx; } /** * Has connection context? * */ public function hasCtx(): bool { return isset($this->ctx); } /** * Connect function. * * @param ConnectionContext $ctx Connection context * @param int $id Optional connection ID to reconnect * */ public function connect(ConnectionContext $ctx, int $id = -1): \Generator { $this->API->logger->logger("Trying shared connection via {$ctx} ({$id})"); $this->ctx = $ctx->getCtx(); $this->datacenter = $ctx->getDc(); $media = $ctx->isMedia() || $ctx->isCDN(); $count = $media ? $this->API->getSettings()->getConnection()->getMinMediaSocketCount() : 1; if ($count > 1) { if (!$this->robinLoop) { $this->robinLoop = new PeriodicLoopInternal($this->API, [$this, 'even'], "robin loop DC {$this->datacenter}", $this->API->getSettings()->getConnection()->getRobinPeriod() * 1000); } $this->robinLoop->start(); } $this->decRead = $media ? self::READ_WEIGHT_MEDIA : self::READ_WEIGHT; $this->decWrite = self::WRITE_WEIGHT; if ($id === -1 || !isset($this->connections[$id])) { if ($this->connections) { $this->API->logger->logger("Already connected!", Logger::WARNING); return; } yield from $this->connectMore($count); yield $this->restoreBackup(); $this->connectionsPromise = new Success(); if ($this->connectionsDeferred) { $connectionsDeferred = $this->connectionsDeferred; $this->connectionsDeferred = null; $connectionsDeferred->resolve(); } } else { $this->availableConnections[$id] = 0; yield from $this->connections[$id]->connect($ctx); } } /** * Connect to the DC using count more sockets. * * @param integer $count Number of sockets to open * */ private function connectMore(int $count): \Generator { $ctx = $this->ctx->getCtx(); $count += $previousCount = \count($this->connections); for ($x = $previousCount; $x < $count; $x++) { $connection = new Connection(); $connection->setExtra($this, $x); yield from $connection->connect($ctx); $this->connections[$x] = $connection; $this->availableConnections[$x] = 0; $ctx = $this->ctx->getCtx(); } } /** * Signal that a connection ID disconnected. * * @param integer $id Connection ID * */ public function signalDisconnect(int $id): void { $backup = $this->connections[$id]->backupSession(); $list = ''; foreach ($backup as $k => $message) { if ($message->getConstructor() === 'msgs_state_req' || $message->getConstructor() === 'ping_delay_disconnect' || $message->isUnencrypted()) { unset($backup[$k]); continue; } $list .= $message->getConstructor(); $list .= ', '; } $this->API->logger->logger("Backed up {$list} from DC {$this->datacenter}.{$id}"); $this->backup = \array_merge($this->backup, $backup); unset($this->connections[$id], $this->availableConnections[$id]); } /** * Close all connections to DC. * */ public function disconnect(): void { $this->connectionsDeferred = new Deferred(); $this->connectionsPromise = $this->connectionsDeferred->promise(); $this->API->logger->logger("Disconnecting from shared DC {$this->datacenter}"); if ($this->robinLoop) { $this->robinLoop->signal(true); $this->robinLoop = null; } $before = \count($this->backup); foreach ($this->connections as $connection) { $connection->disconnect(); } $count = \count($this->backup) - $before; $this->API->logger->logger("Backed up {$count}, added to {$before} existing messages) from DC {$this->datacenter}"); $this->connections = []; $this->availableConnections = []; } /** * Reconnect to DC. * */ public function reconnect(): \Generator { $this->API->logger->logger("Reconnecting shared DC {$this->datacenter}"); $this->disconnect(); yield from $this->connect($this->ctx); } /** * Restore backed up messages. * */ public function restoreBackup(): void { $backup = $this->backup; $this->backup = []; $count = \count($backup); $this->API->logger->logger("Restoring {$count} messages to DC {$this->datacenter}"); /** @var OutgoingMessage */ foreach ($backup as $message) { if ($message->hasSeqno()) { $message->setSeqno(null); } if ($message->hasMsgId()) { $message->setMsgId(null); } if (!($message->getState() & OutgoingMessage::STATE_REPLIED)) { Tools::callFork($this->getConnection()->sendMessage($message, false)); } } $this->flush(); } /** * Get connection for authorization. * */ public function getAuthConnection(): Connection { return $this->connections[0]; } /** * Check if any connection is available. * * @param integer $id Connection ID * * @return bool|int */ public function hasConnection(int $id = -1) { return $id < 0 ? \count($this->connections) : isset($this->connections[$id]); } /** * Get best socket in round robin, asynchronously. * * * @psalm-return \Generator */ public function waitGetConnection(): \Generator { if (empty($this->availableConnections)) { yield $this->connectionsPromise; } return $this->getConnection(); } /** * Get best socket in round robin. * * @param integer $id Connection ID, for manual fetching * */ public function getConnection(int $id = -1): Connection { if ($id >= 0) { return $this->connections[$id]; } if (\count($this->availableConnections) <= 1) { return $this->connections[0]; } $max = \max($this->availableConnections); $key = \array_search($max, $this->availableConnections); // Decrease to implement round robin $this->availableConnections[$key]--; return $this->connections[$key]; } /** * Even out round robin values. * */ public function even(): void { if (!$this->availableConnections) { return; } $min = \min($this->availableConnections); if ($min < 50) { foreach ($this->availableConnections as &$count) { $count += 50; } } elseif ($min < 100) { $max = $this->isMedia() || $this->isCDN() ? $this->API->getSettings()->getConnection()->getMaxMediaSocketCount() : 1; if (\count($this->availableConnections) < $max) { $this->connectMore(2); } else { foreach ($this->availableConnections as &$value) { $value += 1000; } } } } /** * Indicate that one of the sockets is busy reading. * * @param boolean $reading Whether we're busy reading * @param int $x Connection ID * */ public function reading(bool $reading, int $x): void { if (!isset($this->availableConnections[$x])) { return; } $this->availableConnections[$x] += $reading ? -$this->decRead : $this->decRead; } /** * Indicate that one of the sockets is busy writing. * * @param boolean $writing Whether we're busy writing * @param int $x Connection ID * */ public function writing(bool $writing, int $x): void { if (!isset($this->availableConnections[$x])) { return; } $this->availableConnections[$x] += $writing ? -$this->decWrite : $this->decWrite; } /** * Set main instance. * * @param MTProto $API Main instance * */ public function setExtra($API): void { $this->API = $API; } /** * Get main instance. * * @return MTProto */ public function getExtra() { return $this->API; } /** * Check if is an HTTP connection. * * @return boolean */ public function isHttp(): bool { return \in_array($this->ctx->getStreamName(), [HttpStream::class, HttpsStream::class]); } /** * Check if is connected directly by IP address. * * @return boolean */ public function byIPAddress(): bool { return !$this->ctx->hasStreamName(WssStream::class) && !$this->ctx->hasStreamName(HttpsStream::class); } /** * Check if is a media connection. * * @return boolean */ public function isMedia(): bool { return $this->ctx->isMedia(); } /** * Check if is a CDN connection. * * @return boolean */ public function isCDN(): bool { return $this->ctx->isCDN(); } /** * Get DC-specific settings. * */ public function getSettings(): ConnectionSettings { return $this->API->getSettings()->getConnection(); } /** * Get global settings. * */ public function getGenericSettings(): Settings { return $this->API->getSettings(); } /** * JSON serialize function. * */ public function jsonSerialize(): array { return $this->linked ? ['linked' => $this->linked, 'tempAuthKey' => $this->tempAuthKey] : ['permAuthKey' => $this->permAuthKey, 'tempAuthKey' => $this->tempAuthKey]; } /** * Sleep function. * * @internal * * @return array */ public function __sleep() { return $this->linked ? ['linked', 'tempAuthKey'] : ['permAuthKey', 'tempAuthKey']; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; class APIFactory extends AbstractAPIFactory { /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var stats */ public $stats; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var folders */ public $folders; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var langpack */ public $langpack; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var phone */ public $phone; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var stickers */ public $stickers; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var payments */ public $payments; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var bots */ public $bots; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var channels */ public $channels; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var help */ public $help; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var upload */ public $upload; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var photos */ public $photos; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var updates */ public $updates; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var messages */ public $messages; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var contacts */ public $contacts; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var users */ public $users; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var account */ public $account; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var auth */ public $auth; } self::$memoryConsumption + self::$memoryDiffMb) { \gc_collect_cycles(); self::$memoryConsumption = self::getMemoryConsumption(); $cleanedMemory = $currentMemory - self::$memoryConsumption; if (!Magic::$suspendPeriodicLogging) { Logger::log("gc_collect_cycles done. Cleaned memory: $cleanedMemory Mb", Logger::VERBOSE); } } }); if (!\defined('MADELINE_RELEASE_URL')) { return; } $client = HttpClientBuilder::buildDefault(); $request = new Request(MADELINE_RELEASE_URL); self::$cleanupLoop = new PeriodicLoop(function () use ($client, $request): \Generator { try { $latest = yield $client->request($request); Magic::$version_latest = yield $latest->getBody()->buffer(); if (Magic::$version !== Magic::$version_latest) { Logger::log("!!!!!!!!!!!!! An update of MadelineProto is required, shutting down worker! !!!!!!!!!!!!!", Logger::FATAL_ERROR); self::$cleanupLoop->signal(true); if (Magic::$isIpcWorker) { die; } return; } foreach (\glob(MADELINE_PHAR_GLOB) as $path) { $base = \basename($path); if ($base === "madeline-".Magic::$version.".phar") { continue; } $f = \fopen("$path.lock", 'c'); if (\flock($f, LOCK_EX|LOCK_NB)) { \fclose($f); \unlink($path); \unlink("$path.lock"); } else { \fclose($f); } } } catch (\Throwable $e) { Logger::log("An error occurred in the phar cleanup loop: $e", Logger::FATAL_ERROR); } }, "Phar cleanup loop", 60*1000); self::$cleanupLoop->start(); } private static function getMemoryConsumption(): int { $memory = \round(\memory_get_usage()/1024/1024, 1); if (!Magic::$suspendPeriodicLogging) { Logger::log("Memory consumption: $memory Mb", Logger::ULTRA_VERBOSE); } return (int) $memory; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TON; use danog\MadelineProto\Logger; use danog\MadelineProto\Settings\Logger as SettingsLogger; use danog\MadelineProto\Settings\TLSchema; use danog\MadelineProto\TL\TL; use danog\MadelineProto\Tools; use function Amp\File\read; /** * TON API. */ class Lite { /** * Lite client config. * * @var array */ private $config; /** * Misc settings. * */ private SettingsLogger $settings; /** * TL serializer instance. * * @var \danog\MadelineProto\TL\TL */ private $TL; /** * Logger instance. * * @var Logger */ public $logger; /** * Liteserver connections. * * @var ADNLConnection[] */ private $connections = []; /** * Construct settings. * */ public function __construct(SettingsLogger $settings) { $this->settings = $settings; $this->logger = Logger::constructorFromSettings($this->settings); $schema = new TLSchema; $schema->setOther(['lite_api' => __DIR__.'/../../../../schemas/TON/lite_api.tl', 'ton_api' => __DIR__.'/../../../../schemas/TON/ton_api.tl']); /** @psalm-suppress InvalidArgument */ $this->TL = new TL($this); $this->TL->init($schema); } /** * Connect to the lite endpoints specified in the config file. * * @param string $config Path to config file * */ public function connect(string $config): \Generator { $config = \json_decode(yield read($config), true); $config['_'] = 'liteclient.config.global'; $config = Tools::convertJsonTL($config); $config['validator']['init_block'] = $config['validator']['init_block'] ?? $config['validator']['zero_state']; [$this->config] = $this->TL->deserialize(yield from $this->TL->serializeObject(['type' => ''], $config, 'cleanup')); foreach ($this->config['liteservers'] as $lite) { $this->connections[] = $connection = new ADNLConnection($this->TL); yield from $connection->connect($lite); } } /** * Logger. * * @param string $param Parameter * @param int $level Logging level * @param string $file File where the message originated * */ public function logger($param, int $level = Logger::NOTICE, string $file = ''): void { if ($file === null) { $file = \basename(\debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 1)[0]['file'], '.php'); } isset($this->logger) ? $this->logger->logger($param, $level, $file) : Logger::$default->logger($param, $level, $file); } /** * Call lite method. * * @param string $methodName Method name * @param array $args Arguments * */ public function methodCall(string $methodName, array $args = [], array $aargs = []): \Generator { $data = (yield from $this->TL->serializeMethod($methodName, $args)); $data = (yield from $this->TL->serializeMethod('liteServer.query', ['data' => $data])); return yield from $this->connections[\rand(0, \count($this->connections) - 1)]->query($data); } /** * Asynchronously run async callable. * * @param callable $func Function * */ public function loop(callable $func): \Generator { return yield $func(); } /** * Convert parameters. * * @param array $parameters Parameters * */ public function botAPItoMTProto(array $parameters): \Generator { return $parameters; yield; } /** * Get TL method namespaces. * */ public function getMethodNamespaces(): array { return $this->TL->getMethodNamespaces(); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TON; use Amp\Deferred; use Amp\Socket\ConnectContext; use danog\MadelineProto\Magic; use danog\MadelineProto\MTProtoTools\Crypt; use danog\MadelineProto\Stream\ADNLTransport\ADNLStream; use danog\MadelineProto\Stream\Common\BufferedRawStream; use danog\MadelineProto\Stream\Common\CtrStream; use danog\MadelineProto\Stream\Common\HashedBufferedStream; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\StreamInterface; use danog\MadelineProto\Stream\Transport\DefaultStream; use danog\MadelineProto\TL\TL; use danog\MadelineProto\Tools; use Exception; use phpseclib3\Crypt\DH; use phpseclib3\Crypt\EC; use phpseclib3\Crypt\EC\Curves\Curve25519; use phpseclib3\Crypt\EC\PrivateKey; use phpseclib3\Crypt\EC\PublicKey; use phpseclib3\Math\BigInteger; class ADNLConnection { /** * TL serializer instance. * * @var TL */ private $TL; /** * ADNL stream instance. * * @var StreamInterface */ private $stream; /** * Request list. * * @var array */ private $requests = []; /** * Construct class. * * @param TL $TL TL instance */ public function __construct(TL $TL) { $this->TL = $TL; } /** * Connect to specified ADNL endpoint. * * @param array $endpoint Endpoint * */ public function connect(array $endpoint): \Generator { if ($endpoint['_'] !== 'liteserver.desc') { throw new \InvalidArgumentException('Only liteservers are supported at the moment!'); } if ($endpoint['id']['_'] !== 'pub.ed25519') { throw new \InvalidArgumentException('Only ECDH is supported at the moment!'); } $random = Tools::random(256 - 32 - 64); //$random = strrev(hex2bin(strrev('9E7C27765D12CE634414F0875D55CE5C58E7A9D58CD45C57CAB516D1241B7864691E5B0AFC4ECB54BFF2CEFC2060F1D45F5B5DEB76A9EF6471D75816AAAEC83CD7DE39EE99B9E980B6C0D4565A916D00908613E63657D5539118F89A14FD73ABB8ECD3AC26C287EEBD0FA44F52B315F01DD60F486EFF4C5B4D71EA6F443358FF141E7294BBBB5D7C079F16BD46C28A12507E1948722E7121B94C3B5C7832ADE7'))); $s1 = \substr($random, 0, 32); $s2 = \substr($random, 32, 32); $v1 = \substr($random, 64, 16); $v2 = \substr($random, 80, 16); $obf = ['decrypt' => ['key' => $s1, 'iv' => $v1], 'encrypt' => ['key' => $s2, 'iv' => $v2]]; // Generating new private/public params $private = EC::createKey('Ed25519'); $public = $private->getPublicKey(); $public = \strrev(Tools::getVar($public, 'QA')[1]->toBytes()); $private = \strrev(Tools::getVar($private, 'dA')->toBytes()); $private = PrivateKey::loadFormat('MontgomeryPrivate', $private); // Transpose their public $key = $endpoint['id']['key']; $key[31] = $key[31] & \chr(127); $curve = new Curve25519(); $modulo = Tools::getVar($curve, "modulo"); $y = new BigInteger(\strrev($key), 256); $y2 = clone $y; $y = $y->add(Magic::$one); $y2 = $y2->subtract(Magic::$one); $y2 = $modulo->subtract($y2)->powMod(Magic::$one, $modulo); $y2 = $y2->modInverse($modulo); $key = \strrev($y->multiply($y2)->powMod(Magic::$one, $modulo)->toBytes()); $peerPublic = PublicKey::loadFormat('MontgomeryPublic', $key); // Generate secret $secret = DH::computeSecret($private, $peerPublic); // Encrypting random with obf keys $digest = \hash('sha256', $random, true); $key = \substr($secret, 0, 16).\substr($digest, 16, 16); $iv = \substr($digest, 0, 4).\substr($secret, 20, 12); $encryptedRandom = Crypt::ctrEncrypt($random, $key, $iv); // Generating plaintext init payload $payload = \hash('sha256', yield from $this->TL->serializeObject(['type' => ''], $endpoint['id'], 'key'), true); $payload .= $public; $payload .= $digest; $payload .= $encryptedRandom; $ip = \long2ip(\unpack('V', Tools::packSignedInt($endpoint['ip']))[1]); $port = $endpoint['port']; $ctx = (new ConnectionContext())->setSocketContext(new ConnectContext())->setUri("tcp://{$ip}:{$port}")->addStream(DefaultStream::class)->addStream(BufferedRawStream::class)->addStream(CtrStream::class, $obf)->addStream(HashedBufferedStream::class, 'sha256')->addStream(ADNLStream::class); $this->stream = (yield from $ctx->getStream($payload)); Tools::callFork((function (): \Generator { //yield Tools::sleep(1); while (true) { $buffer = yield $this->stream->getReadBuffer($length); if ($length) { $data = yield $buffer->bufferRead($length); $data = $this->TL->deserialize($data)[0]; if ($data['_'] !== 'adnl.message.answer') { throw new Exception('Wrong answer type: '.$data['_']); } $this->requests[$data['query_id']]->resolve($this->TL->deserialize((string) $data['answer'])[0]); } } })()); } /** * Send ADNL query. * * @param string $payload Payload to send * */ public function query(string $payload): \Generator { $data = (yield from $this->TL->serializeObject(['type' => ''], ['_' => 'adnl.message.query', 'query_id' => $id = Tools::random(32), 'query' => $payload], '')); (yield $this->stream->getWriteBuffer(\strlen($data)))->bufferWrite($data); $this->requests[$id] = new Deferred(); return $this->requests[$id]->promise(); } } $promises Promises * * @return \Amp\Promise */ public function all(array $promises) { return \danog\MadelineProto\Tools::all($promises); } /** * Returns a promise that is resolved when all promises are resolved. The returned promise will not fail. * * @param array $promises Promises * * @return \Amp\Promise */ public function any(array $promises) { return \danog\MadelineProto\Tools::any($promises); } /** * Create array. * * @param mixed ...$params Params * */ public function arr(...$params): array { return \danog\MadelineProto\Tools::arr(...$params); } /** * base64URL decode. * * @param string $data Data to decode * */ public function base64urlDecode(string $data): string { return \danog\MadelineProto\Tools::base64urlDecode($data); } /** * Base64URL encode. * * @param string $data Data to encode * */ public function base64urlEncode(string $data): string { return \danog\MadelineProto\Tools::base64urlEncode($data); } /** * Convert parameters. * * @param array $parameters Parameters * * @return \Amp\Promise */ public function botAPItoMTProto(array $parameters, array $extra = []) { return $this->__call(__FUNCTION__, [$parameters, $extra]); } /** * Convert generator, promise or any other value to a promise. * * @param \Generator|Promise|mixed $promise * * @template TReturn * @psalm-param \Generator|Promise|TReturn $promise * * @return \Amp\Promise * @psalm-return Promise */ public function call($promise) { return \danog\MadelineProto\Tools::call($promise); } /** * Call promise in background. * * @param \Generator|Promise $promise Promise to resolve * @param ?\Generator|Promise $actual Promise to resolve instead of $promise * @param string $file File * * @psalm-suppress InvalidScope * * @return \Amp\Promise|mixed */ public function callFork($promise, $actual = null, $file = '') { return \danog\MadelineProto\Tools::callFork($promise, $actual, $file); } /** * Call promise in background, deferring execution. * * @param \Generator|Promise $promise Promise to resolve * */ public function callForkDefer($promise): void { \danog\MadelineProto\Tools::callForkDefer($promise); } /** * Close connection with client, connected via web. * * @param string $message Message * * @return void */ public function closeConnection($message) { return \danog\MadelineProto\Tools::closeConnection($message); } /** * Connect to the lite endpoints specified in the config file. * * @param string $config Path to config file * * @return \Amp\Promise */ public function connect(string $config, array $extra = []) { return $this->__call(__FUNCTION__, [$config, $extra]); } /** * Asynchronously write to stdout/browser. * * @param string $string Message to echo * * @return \Amp\Promise */ public function echo(string $string) { return \danog\MadelineProto\Tools::echo($string); } /** * Get final element of array. * * @param array $what Array * */ public function end(array $what) { return \danog\MadelineProto\Tools::end($what); } /** * Returns a promise that succeeds when the first promise succeeds, and fails only if all promises fail. * * @param array $promises Promises * * @return \Amp\Promise */ public function first(array $promises) { return \danog\MadelineProto\Tools::first($promises); } /** * Asynchronously lock a file * Resolves with a callbable that MUST eventually be called in order to release the lock. * * @param string $file File to lock * @param integer $operation Locking mode * @param float $polling Polling interval * @param ?Promise $token Cancellation token * @param ?callable $failureCb Failure callback, called only once if the first locking attempt fails. * * @return \Amp\Promise<$token is null ? callable : ?callable> */ public function flock(string $file, int $operation, float $polling = 0.1, ?\Amp\Promise $token = null, $failureCb = null) { return \danog\MadelineProto\Tools::flock($file, $operation, $polling, $token, $failureCb); } /** * Generate MTProto vector hash. * * @param array $ints IDs * * @return string Vector hash */ public function genVectorHash(array $ints): string { return \danog\MadelineProto\Tools::genVectorHash($ints); } /** * Get extension from file location. * * @param mixed $location File location * @param string $default Default extension * */ public function getExtensionFromLocation($location, string $default): string { return \danog\MadelineProto\TL\Conversion\Extension::getExtensionFromLocation($location, $default); } /** * Get extension from mime type. * * @param string $mime MIME type * */ public function getExtensionFromMime(string $mime): string { return \danog\MadelineProto\TL\Conversion\Extension::getExtensionFromMime($mime); } /** * Get TL method namespaces. * * @psalm-return array|\Amp\Promise */ public function getMethodNamespaces() { return $this->__call(__FUNCTION__, []); } /** * Get mime type from buffer. * * @param string $buffer Buffer * */ public function getMimeFromBuffer(string $buffer): string { return \danog\MadelineProto\TL\Conversion\Extension::getMimeFromBuffer($buffer); } /** * Get mime type from file extension. * * @param string $extension File extension * @param string $default Default mime type * */ public function getMimeFromExtension(string $extension, string $default): string { return \danog\MadelineProto\TL\Conversion\Extension::getMimeFromExtension($extension, $default); } /** * Get mime type of file. * * @param string $file File * */ public function getMimeFromFile(string $file): string { return \danog\MadelineProto\TL\Conversion\Extension::getMimeFromFile($file); } /** * Accesses a private variable from an object. * * @param object $obj Object * @param string $var Attribute name * * @psalm-suppress InvalidScope * * @access public */ public function getVar($obj, string $var) { return \danog\MadelineProto\Tools::getVar($obj, $var); } /** * Checks private property exists in an object. * * @param object $obj Object * @param string $var Attribute name * * @psalm-suppress InvalidScope * * @access public */ public function hasVar($obj, string $var): bool { return \danog\MadelineProto\Tools::hasVar($obj, $var); } /** * Inflate stripped photosize to full JPG payload. * * @param string $stripped Stripped photosize * * @return string JPG payload */ public function inflateStripped(string $stripped): string { return \danog\MadelineProto\Tools::inflateStripped($stripped); } /** * Whether this is altervista. * * @return boolean */ public function isAltervista(): bool { return \danog\MadelineProto\Tools::isAltervista(); } /** * Check if is array or similar (traversable && countable && arrayAccess). * * @param mixed $var Value to check * * @return boolean */ public function isArrayOrAlike($var): bool { return \danog\MadelineProto\Tools::isArrayOrAlike($var); } /** * Logger. * * @param string $param Parameter * @param int $level Logging level * @param string $file File where the message originated * * @psalm-return void|\Amp\Promise */ public function logger($param, int $level = \danog\MadelineProto\Logger::NOTICE, string $file = ''): void { $this->__call(__FUNCTION__, [$param, $level, $file]); } /** * Asynchronously run async callable. * * @param callable $func Function * * @return \Amp\Promise */ public function loop(callable $func, array $extra = []) { return $this->__call(__FUNCTION__, [$func, $extra]); } /** * Escape string for markdown. * * @param string $hwat String to escape * */ public function markdownEscape(string $hwat): string { return \danog\MadelineProto\StrTools::markdownEscape($hwat); } /** * Call lite method. * * @param string $methodName Method name * @param array $args Arguments * * @return \Amp\Promise */ public function methodCall(string $methodName, array $args = [ ], array $aargs = [ ], array $extra = []) { return $this->__call(__FUNCTION__, [$methodName, $args, $aargs, $extra]); } /** * Escape method name. * * @param string $method Method name * */ public function methodEscape(string $method): string { return \danog\MadelineProto\StrTools::methodEscape($method); } /** * Convert double to binary version. * * @param float $value Value to convert * */ public function packDouble(float $value): string { return \danog\MadelineProto\Tools::packDouble($value); } /** * Convert integer to base256 signed int. * * @param integer $value Value to convert * */ public function packSignedInt(int $value): string { return \danog\MadelineProto\Tools::packSignedInt($value); } /** * Convert integer to base256 long. * * @param int $value Value to convert * */ public function packSignedLong(int $value): string { return \danog\MadelineProto\Tools::packSignedLong($value); } /** * Convert value to unsigned base256 int. * * @param int $value Value * */ public function packUnsignedInt(int $value): string { return \danog\MadelineProto\Tools::packUnsignedInt($value); } /** * Positive modulo * Works just like the % (modulus) operator, only returns always a postive number. * * @param int $a A * @param int $b B * * @return int Modulo */ public function posmod(int $a, int $b): int { return \danog\MadelineProto\Tools::posmod($a, $b); } /** * Get random string of specified length. * * @param integer $length Length * * @return string Random string */ public function random(int $length): string { return \danog\MadelineProto\Tools::random($length); } /** * Get random integer. * * @param integer $modulus Modulus * */ public function randomInt(int $modulus = 0): int { return \danog\MadelineProto\Tools::randomInt($modulus); } /** * Asynchronously read line. * * @param string $prompt Prompt * * @return \Amp\Promise */ public function readLine(string $prompt = '') { return \danog\MadelineProto\Tools::readLine($prompt); } /** * Rethrow error catched in strand. * * @param \Throwable $e Exception * @param string $file File where the strand started * * @psalm-suppress InvalidScope * */ public function rethrow(\Throwable $e, $file = ''): void { \danog\MadelineProto\Tools::rethrow($e, $file); } /** * null-byte RLE decode. * * @param string $string Data to decode * */ public function rleDecode(string $string): string { return \danog\MadelineProto\Tools::rleDecode($string); } /** * null-byte RLE encode. * * @param string $string Data to encode * */ public function rleEncode(string $string): string { return \danog\MadelineProto\Tools::rleEncode($string); } /** * Sets a private variable in an object. * * @param object $obj Object * @param string $var Attribute name * @param mixed $val Attribute value * * @psalm-suppress InvalidScope * * * @access public */ public function setVar($obj, string $var, &$val): void { \danog\MadelineProto\Tools::setVar($obj, $var, $val); } /** * Asynchronously sleep. * * @param int|float $time Number of seconds to sleep for * * @return \Amp\Promise */ public function sleep($time) { return \danog\MadelineProto\Tools::sleep($time); } /** * Resolves with a two-item array delineating successful and failed Promise results. * The returned promise will only fail if the given number of required promises fail. * * @param array $promises Promises * * @return \Amp\Promise */ public function some(array $promises) { return \danog\MadelineProto\Tools::some($promises); } /** * Create an artificial timeout for any \Generator or Promise. * * @param \Generator|Promise $promise * @param integer $timeout * * @return \Amp\Promise */ public function timeout($promise, int $timeout) { return \danog\MadelineProto\Tools::timeout($promise, $timeout); } /** * Creates an artificial timeout for any `Promise`. * * If the promise is resolved before the timeout expires, the result is returned * * If the timeout expires before the promise is resolved, a default value is returned * * @template TReturnAlt * @template TReturn * @template TGenerator as \Generator * * @param Promise|Generator $promise Promise to which the timeout is applied. * @param int $timeout Timeout in milliseconds. * * @psalm-param Promise|TGenerator $promise Promise to which the timeout is applied. * @psalm-param TReturnAlt $default * * @return \Amp\Promise|Promise * * @throws \TypeError If $promise is not an instance of \Amp\Promise, \Generator or \React\Promise\PromiseInterface. */ public function timeoutWithDefault($promise, int $timeout, $default = null) { return \danog\MadelineProto\Tools::timeoutWithDefault($promise, $timeout, $default); } /** * Convert to camelCase. * * @param string $input String * */ public function toCamelCase(string $input): string { return \danog\MadelineProto\StrTools::toCamelCase($input); } /** * Convert to snake_case. * * @param string $input String * */ public function toSnakeCase(string $input): string { return \danog\MadelineProto\StrTools::toSnakeCase($input); } /** * Escape type name. * * @param string $type String to escape * */ public function typeEscape(string $type): string { return \danog\MadelineProto\StrTools::typeEscape($type); } /** * Unpack binary double. * * @param string $value Value to unpack * */ public function unpackDouble(string $value): float { return \danog\MadelineProto\Tools::unpackDouble($value); } /** * Unpack base256 signed int. * * @param string $value base256 int * * @return integer */ public function unpackSignedInt(string $value): int { return \danog\MadelineProto\Tools::unpackSignedInt($value); } /** * Unpack base256 signed long. * * @param string $value base256 long * * @return integer */ public function unpackSignedLong(string $value): int { return \danog\MadelineProto\Tools::unpackSignedLong($value); } /** * Unpack base256 signed long to string. * * @param string|int|array $value base256 long * */ public function unpackSignedLongString($value): string { return \danog\MadelineProto\Tools::unpackSignedLongString($value); } /** * Synchronously wait for a promise|generator. * * @param \Generator|Promise $promise The promise to wait for * @param boolean $ignoreSignal Whether to ignore shutdown signals * */ public function wait($promise, $ignoreSignal = false) { return \danog\MadelineProto\Tools::wait($promise, $ignoreSignal); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TON; use danog\MadelineProto\AbstractAPIFactory; class APIFactory extends AbstractAPIFactory { /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var http */ public $http; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var engine */ public $engine; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var adnl */ public $adnl; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var tonNode */ public $tonNode; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var validatorSession */ public $validatorSession; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var catchain */ public $catchain; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var overlay */ public $overlay; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var dht */ public $dht; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var tcp */ public $tcp; /** * @internal this is a internal property generated by build_docs.php, don't change manually * * @var liteServer */ public $liteServer; /** * Just proxy async requests to API. * * @param string $name Method name * @param array $arguments Arguments * @psalm-suppress UndefinedThisPropertyFetch */ public function __call_async(string $name, array $arguments): \Generator { $lower_name = \strtolower($name); if ($this->namespace !== '' || !isset($this->methods[$lower_name])) { $name = $this->namespace.$name; $aargs = isset($arguments[1]) && \is_array($arguments[1]) ? $arguments[1] : []; $aargs['apifactory'] = true; $args = isset($arguments[0]) && \is_array($arguments[0]) ? $arguments[0] : []; return yield from $this->API->methodCall($name, $args, $aargs); } return yield $this->methods[$lower_name](...$arguments); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TON; use danog\MadelineProto\Magic; use danog\MadelineProto\Settings\Logger; /** * TON API. */ class API extends InternalDoc { /** * Construct API. * * @param Logger $settings Settings */ public function __construct(Logger $settings) { Magic::start(); $this->API = new Lite($settings); foreach (\get_class_methods($this->API) as $method) { $this->methods[$method] = [$this->API, \strtolower($method)]; } foreach ($this->API->getMethodNamespaces() as $namespace) { $this->{$namespace} = new APIFactory($namespace, $this->API, $this->async); } } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use danog\MadelineProto\TL\Conversion\DOMEntities; use danog\MadelineProto\TL\Conversion\Extension; use Parsedown; /** * Some tools. */ abstract class StrTools extends Extension { /** * Get Telegram UTF-8 length of string. * * @param string $text Text * * @return float|int */ public static function mbStrlen(string $text) { $length = 0; $textlength = \strlen($text); for ($x = 0; $x < $textlength; $x++) { $char = \ord($text[$x]); if (($char & 0xc0) != 0x80) { $length += 1 + ($char >= 0xf0); } } return $length; } /** * Telegram UTF-8 multibyte substring. * * @param string $text Text to substring * @param integer $offset Offset * @param ?int $length Length * */ public static function mbSubstr(string $text, int $offset, $length = null): string { return \mb_convert_encoding( \substr( \mb_convert_encoding($text, 'UTF-16'), $offset<<1, $length === null ? null : ($length<<1) ), 'UTF-8', 'UTF-16' ); } /** * Telegram UTF-8 multibyte split. * * @param string $text Text * @param integer $length Length * * @return array */ public static function mbStrSplit(string $text, int $length): array { $result = []; foreach (\str_split(\mb_convert_encoding($text, 'UTF-16'), $length<<1) as $chunk) { $result []= \mb_convert_encoding($chunk, 'UTF-8', 'UTF-16'); } return $result; } /** * Convert to camelCase. * * @param string $input String * */ public static function toCamelCase(string $input): string { return \lcfirst(\str_replace('_', '', \ucwords($input, '_'))); } /** * Convert to snake_case. * * @param string $input String * */ public static function toSnakeCase(string $input): string { \preg_match_all('!([A-Z][A-Z0-9]*(?=$|[A-Z][a-z0-9])|[A-Za-z][a-z0-9]+)!', $input, $matches); $ret = $matches[0]; foreach ($ret as &$match) { $match = $match == \strtoupper($match) ? \strtolower($match) : \lcfirst($match); } return \implode('_', $ret); } /** * Escape string for markdown. * * @param string $hwat String to escape * */ public static function markdownEscape(string $hwat): string { return \str_replace('_', '\\_', $hwat); } /** * Escape type name. * * @param string $type String to escape * */ public static function typeEscape(string $type): string { $type = \str_replace(['<', '>'], ['_of_', ''], $type); return \preg_replace('/.*_of_/', '', $type); } /** * Escape method name. * * @param string $method Method name * */ public static function methodEscape(string $method): string { return \str_replace('.', '->', $method); } /** * Strip markdown tags. * * @internal * */ public static function toString(string $markdown): string { if ($markdown === '') { return $markdown; } return (new DOMEntities(Parsedown::instance()->text($markdown)))->message; } } startupTime = \microtime(true); $this->startupId = $startupId; $this->exception = $exception ? new ExitFailure($exception) : null; } /** * Get startup time. * */ public function getStartupTime(): float { return $this->startupTime; } /** * Get startup ID. * */ public function getStartupId(): int { return $this->startupId; } /** * Get exception. * * @return ?\Throwable */ public function getException(): ?\Throwable { return $this->exception ? $this->exception->getException() : null; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Ipc; use Amp\Ipc\IpcServer; use Amp\Ipc\Sync\ChannelledSocket; use Amp\Loop; use Amp\Promise; use danog\MadelineProto\Exception; use danog\MadelineProto\SessionPaths; /** * IPC callback server. */ class ServerCallback extends Server { /** * Timeout watcher list, indexed by socket ID. * * @var array */ private $watcherList = []; /** * Timeout watcher list, indexed by socket ID. * * @var array */ private $socketList = []; /** * Counter. */ private int $id = 0; /** * Set IPC path. * * @param SessionPaths $session Session * */ public function setIpcPath(SessionPaths $session): void { $this->server = new IpcServer($session->getIpcCallbackPath()); } /** * Client handler loop. * * @param ChannelledSocket $socket Client * * @return Promise */ protected function clientLoop(ChannelledSocket $socket) { $id = $this->id++; $this->API->logger("Accepted IPC callback connection, assigning ID $id!"); $this->socketList[$id] = $socket; $this->watcherList[$id] = Loop::delay(30*1000, function () use ($id): void { unset($this->watcherList[$id], $this->socketList[$id]); }); return $socket->send($id); } /** * Unwrap value. * */ protected function unwrap(Wrapper $wrapper) { $id = $wrapper->getRemoteId(); if (!isset($this->socketList[$id])) { throw new Exception("IPC timeout, could not find callback socket!"); } $socket = $this->socketList[$id]; Loop::cancel($this->watcherList[$id]); unset($this->watcherList[$id], $this->socketList[$id]); return $wrapper->unwrap($socket); } } */ public static function start(string $session, int $startupId): Promise { if (\PHP_SAPI === "cli") { $binary = \PHP_BINARY; } else { $binary = self::$binaryPath ?? self::locateBinary(); } $options = [ "html_errors" => "0", "display_errors" => "0", "log_errors" => "1", ]; $runner = self::getScriptPath(); $command = [ $binary, ...self::formatOptions($options), $runner, 'madeline-ipc', $session, $startupId ]; $command = \implode(" ", \array_map('Amp\\Process\\escapeArguments', $command)); Logger::log("Starting process with $command"); $params = [ 'argv' => ['madeline-ipc', $session, $startupId], 'cwd' => Magic::getcwd() ]; $envVars = \array_merge( \array_filter($_SERVER, fn ($v, $k): bool => \is_string($v) && !\in_array($k, self::CGI_VARS), ARRAY_FILTER_USE_BOTH), ['QUERY_STRING' => \http_build_query($params)] ); $resDeferred = new Deferred; $runner = IS_WINDOWS ? new WindowsRunner : new Runner; $handle = $runner->start($command, null, $envVars); $handle->pidDeferred->promise()->onResolve(function (?\Throwable $e, ?int $pid) use ($handle, $runner, $resDeferred): void { if ($e) { Logger::log("Got exception while starting process worker: $e"); $resDeferred->resolve($e); return; } Tools::callFork(self::readUnref($handle->stdout)); Tools::callFork(self::readUnref($handle->stderr)); $runner->join($handle)->onResolve(function (?\Throwable $e, ?int $res) use ($runner, $handle, $resDeferred): void { $runner->destroy($handle); if ($e) { Logger::log("Got exception from process worker: $e"); $resDeferred->fail($e); } else { Logger::log("Process worker exited with $res!"); $resDeferred->fail(new Exception("Process worker exited with $res!")); } }); }); return $resDeferred->promise(); } /** * Unreference and read data from fd, logging results. * */ private static function readUnref(ProcessInputStream $stream): \Generator { $stream->unreference(); $lastLine = ''; try { while (($chunk = yield $stream->read()) !== null) { $chunk = \explode("\n", \str_replace(["\r", "\n\n"], "\n", $chunk)); $lastLine .= \array_shift($chunk); while ($chunk) { Logger::log("Got message from worker: $lastLine"); $lastLine = \array_shift($chunk); } } } catch (\Throwable $e) { Logger::log("An error occurred while reading the process status: $e"); } finally { Logger::log("Got final message from worker: $lastLine"); } } private static function locateBinary(): string { $executable = \strncasecmp(\PHP_OS, "WIN", 3) === 0 ? "php.exe" : "php"; $paths = \array_filter(\explode(\PATH_SEPARATOR, \getenv("PATH"))); $paths[] = \PHP_BINDIR; $paths = \array_unique($paths); foreach ($paths as $path) { $path .= \DIRECTORY_SEPARATOR.$executable; if (\is_executable($path)) { return self::$binaryPath = $path; } } throw new \Error("Could not locate PHP executable binary"); } /** * Format PHP options. * * @return list */ private static function formatOptions(array $options): array { $result = []; foreach ($options as $option => $value) { $result[] = \sprintf("-d%s=%s", $option, $value); } return $result; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ use danog\MadelineProto\API; use danog\MadelineProto\Ipc\IpcState; use danog\MadelineProto\Ipc\Server; use danog\MadelineProto\Logger; use danog\MadelineProto\Magic; use danog\MadelineProto\SessionPaths; use danog\MadelineProto\Settings\Ipc; use danog\MadelineProto\Shutdown; use danog\MadelineProto\Tools; (static function (): void { if (defined('MADELINE_ENTRY')) { // Already called return; } define('MADELINE_ENTRY', 1); if (!defined('MADELINE_WORKER_TYPE')) { if (count(debug_backtrace(0)) !== 1) { // We're not being included directly return; } $arguments = []; if (isset($GLOBALS['argv']) && !empty($GLOBALS['argv'])) { $arguments = array_slice($GLOBALS['argv'], 1); } elseif (isset($_GET['argv']) && !empty($_GET['argv'])) { $arguments = $_GET['argv']; } if (count($arguments) < 2) { trigger_error("Not enough arguments!", E_USER_ERROR); exit(1); } define('MADELINE_WORKER_TYPE', array_shift($arguments)); define('MADELINE_WORKER_ARGS', $arguments); } if (defined('SIGHUP')) { try { pcntl_signal(SIGHUP, fn () => null); } catch (\Throwable $e) { } } if (!class_exists(API::class)) { $paths = [ dirname(__DIR__, 7)."/autoload.php", dirname(__DIR__, 5)."/vendor/autoload.php", ]; foreach ($paths as $path) { if (file_exists($path)) { $autoloadPath = $path; break; } } if (!isset($autoloadPath)) { trigger_error("Could not locate autoload.php in any of the following files: ".implode(", ", $paths), E_USER_ERROR); exit(1); } include $autoloadPath; } if (\MADELINE_WORKER_TYPE === 'madeline-ipc') { $ipcPath = \MADELINE_WORKER_ARGS[0]; if (!file_exists($ipcPath)) { trigger_error("IPC session $ipcPath does not exist!", E_USER_ERROR); exit(1); } if (function_exists('cli_set_process_title')) { @cli_set_process_title("MadelineProto worker $ipcPath"); } if (function_exists('posix_setsid')) { @posix_setsid(); } if (isset($_GET['cwd'])) { @chdir($_GET['cwd']); } define('MADELINE_WORKER', 1); $runnerId = \MADELINE_WORKER_ARGS[1]; $session = new SessionPaths($ipcPath); try { Magic::start(); Magic::$script_cwd = $_GET['cwd'] ?? Magic::getcwd(); $API = new API($ipcPath, (new Ipc)->setSlow(true)); $API->init(); $API->initSelfRestart(); while (true) { try { Tools::wait($session->storeIpcState(new IpcState($runnerId))); Tools::wait(Server::waitShutdown()); Shutdown::removeCallback('restarter'); return; } catch (\Throwable $e) { Logger::log((string) $e, Logger::FATAL_ERROR); Tools::wait($API->report("Surfaced: $e")); } } } catch (\Throwable $e) { echo "$e"; echo "Got exception in IPC server, exiting..."; Logger::log("$e", Logger::FATAL_ERROR); Logger::log("Got exception in IPC server, exiting...", Logger::FATAL_ERROR); $ipc = Tools::wait($session->getIpcState()); if (!($ipc && $ipc->getStartupId() === $runnerId && !$ipc->getException())) { Logger::log("Reporting error!"); Tools::wait($session->storeIpcState(new IpcState($runnerId, $e))); Logger::log("Reported error!"); } else { Logger::log("Not reporting error!"); } } } })(); */ public static function start(string $session, int $startupId): Promise { if (!isset($_SERVER['SERVER_NAME']) || !$_SERVER['SERVER_NAME']) { return new Failure(new \Exception("Can't start the web runner!")); } if (!self::$runPath) { $uri = \parse_url('tcp://'.$_SERVER['SERVER_NAME'].$_SERVER['REQUEST_URI'], PHP_URL_PATH); if (\substr($uri, -1) === '/') { // http://example.com/path/ (assumed index.php) $uri .= 'index'; // Add fake file name } $uri = \str_replace('//', '/', $uri); $rootDir = \debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS); $rootDir = \end($rootDir)['file'] ?? ''; if (!$rootDir) { throw new ContextException('Could not get entry file!'); } $rootDir = \dirname($rootDir).DIRECTORY_SEPARATOR; $uriDir = \str_replace('/', DIRECTORY_SEPARATOR, \dirname($uri)); if ($uriDir !== '/' && $uriDir !== '\\') { $uriDir .= DIRECTORY_SEPARATOR; } if (\substr($rootDir, -\strlen($uriDir)) !== $uriDir) { throw new ContextException("Mismatch between absolute root dir ($rootDir) and URI dir ($uriDir)"); } // Absolute root of (presumably) readable document root $absoluteRootDir = \substr($rootDir, 0, \strlen($rootDir)-\strlen($uriDir)).DIRECTORY_SEPARATOR; $runPath = self::getScriptPath($absoluteRootDir); if (\substr($runPath, 0, \strlen($absoluteRootDir)) === $absoluteRootDir) { // Process runner is within readable document root self::$runPath = \substr($runPath, \strlen($absoluteRootDir)-1); } else { $contents = \file_get_contents(self::SCRIPT_PATH); $contents = \str_replace("__DIR__", \var_export($absoluteRootDir, true), $contents); $suffix = \bin2hex(\random_bytes(10)); $runPath = $absoluteRootDir."/madeline-ipc-".$suffix.".php"; \file_put_contents($runPath, $contents); self::$runPath = \substr($runPath, \strlen($absoluteRootDir)-1); \register_shutdown_function(static function () use ($runPath): void { @\unlink($runPath); }); } self::$runPath = \str_replace(DIRECTORY_SEPARATOR, '/', self::$runPath); self::$runPath = \str_replace('//', '/', self::$runPath); } $params = [ 'argv' => ['madeline-ipc', $session, $startupId], 'cwd' => Magic::getcwd() ]; $params = \http_build_query($params); foreach (($_SERVER['HTTPS'] ?? 'off') === 'on' ? ['tls', 'tcp'] : ['tcp', 'tls'] as $proto) { try { $address = $proto.'://'.$_SERVER['SERVER_NAME']; $port = $_SERVER['SERVER_PORT']; $res = \fsockopen($address, $port); break; } catch (\Throwable $e) { Logger::log("Error while connecting to ourselves: $e"); } } if (!isset($res)) { throw new Exception("Could not connect to ourselves, please check the server configuration!"); } $uri = self::$runPath.'?'.$params; $payload = "GET $uri HTTP/1.1\r\nHost: {$_SERVER['SERVER_NAME']}\r\n\r\n"; // We don't care for results or timeouts here, PHP doesn't count IOwait time as execution time anyway // Technically should use amphp/socket, but I guess it's OK to not introduce another dependency just for a socket that will be used once. \fwrite($res, $payload); self::$resources []= $res; return new Success(true); } } */ abstract public static function start(string $session, int $startupId): Promise; } , array})[] */ private array $callbackIds = []; /** * Callback ID. */ private int $id = 0; /** * Remote socket ID. */ private int $remoteId = 0; /** * Constructor. * * @param mixed $data Payload data * * @psalm-return \Generator|Promise, mixed, Wrapper> */ public static function create(&$data, SessionPaths $session, Logger $logger): \Generator { $instance = new self; $instance->data = &$data; $instance->logger = $logger; $instance->run = false; $logger->logger("Connecting to callback IPC server..."); $instance->server = yield connect($session->getIpcCallbackPath()); $logger->logger("Connected to callback IPC server!"); $instance->remoteId = yield $instance->server->receive(); $logger->logger("Got ID {$instance->remoteId} from callback IPC server!"); Tools::callFork($instance->receiverLoop()); return $instance; } /** * Serialization function. * */ public function __sleep(): array { return ['data', 'callbackIds', 'remoteId']; } /** * Wrap a certain callback object. * * @param object|callable $callback Callback to wrap * @param bool $wrapObjects Whether to wrap object methods, too * * @param-out int $callback Callback ID * */ public function wrap(&$callback, bool $wrapObjects = true): void { if (\is_object($callback) && $wrapObjects) { $ids = []; foreach (\get_class_methods($callback) as $method) { $id = $this->id++; $this->callbacks[$id] = [$callback, $method]; $ids[$method] = $id; } $class = Obj::class; if ($callback instanceof ByteStreamInputStream) { $class = \method_exists($callback, 'seek') ? InputStream::class : SeekableInputStream::class; } elseif ($callback instanceof ByteStreamOutputStream) { $class = \method_exists($callback, 'seek') ? OutputStream::class : SeekableOutputStream::class; } elseif ($callback instanceof FileCallbackInterface) { $class = FileCallback::class; } $callback = [$class, $ids]; // Will be re-filled later $this->callbackIds[] = &$callback; } elseif (\is_callable($callback)) { $id = $this->id++; $this->callbacks[$id] = self::copy($callback); $callback = $id; $this->callbackIds[] = &$callback; } } /** * Get copy of data. * */ private static function copy($data) { return $data; } /** * Receiver loop. * */ private function receiverLoop(): \Generator { $id = 0; $payload = null; try { while ($payload = yield $this->server->receive()) { Tools::callFork($this->clientRequest($id++, $payload)); } } finally { yield $this->server->disconnect(); } } /** * Handle client request. * * @param integer $id Request ID * @param array $payload Payload * */ private function clientRequest(int $id, $payload): \Generator { try { $result = $this->callbacks[$payload[0]](...$payload[1]); $result = $result instanceof \Generator ? yield from $result : yield $result; } catch (\Throwable $e) { $this->logger->logger("Got error while calling reverse IPC method: $e", Logger::ERROR); $result = new ExitFailure($e); } try { yield $this->server->send([$id, $result]); } catch (\Throwable $e) { $this->logger->logger("Got error while trying to send result of reverse method: $e", Logger::ERROR); try { yield $this->server->send([$id, new ExitFailure($e)]); } catch (\Throwable $e) { $this->logger->logger("Got error while trying to send error of error of reverse method: $e", Logger::ERROR); } } } /** * Get remote socket ID. * * @internal * */ public function getRemoteId(): int { return $this->remoteId; } /** * Set socket and unwrap data. * * @param ChannelledSocket $server Socket. * * @internal * */ public function unwrap(ChannelledSocket $server) { $this->server = $server; Tools::callFork($this->loopInternal()); foreach ($this->callbackIds as &$id) { if (\is_int($id)) { $id = fn (...$args): \Generator => $this->__call($id, $args); } else { [$class, $ids] = $id; $id = new $class($this, $ids); } } return $this->data; } } * * @throws PendingReadError Thrown if another read operation is still pending. */ public function read(): Promise { return Tools::call($this->__call('read')); } } */ private array $methods = []; /** * Wrapper. */ private Wrapper $wrapper; /** * Constructor. * */ public function __construct(Wrapper $wrapper, array $methods) { $this->wrapper = $wrapper; $this->methods = $methods; } /** * Call method. * * * @return \Generator */ public function __call(string $name, array $arguments = []): \Generator { return $this->wrapper->__call($this->methods[$name], $arguments); } } session->getIpcCallbackPath(), $this->logger); foreach ($args as &$arg) { $new->wrap($arg); } return $this->__call(__FUNCTION__, $new); } } __call('getFile'); } /** * Invoke callback. * * @param float $percent Percent * @param float $speed Speed in mbps * @param float $time Time * * @psalm-suppress MethodSignatureMismatch * */ public function __invoke($percent, $speed, $time) { return $this->__call('__invoke', [$percent, $speed, $time]); } } __call('write', [$data])); } /** * Marks the stream as no longer writable. Optionally writes a final data chunk before. Note that this is not the * same as forcefully closing the stream. This method waits for all pending writes to complete before closing the * stream. Socket streams implementing this interface should only close the writable side of the stream. * * @param string $finalData Bytes to write. * * @return Promise Succeeds once the data has been successfully written to the stream. * * @throws ClosedException If the stream has already been closed. * @throws StreamException If writing to the stream fails. */ public function end(string $finalData = ""): Promise { return Tools::call($this->__call('write', [$finalData])); } } New offset position. */ public function seek(int $position, int $whence = \SEEK_SET): Promise { return Tools::call($this->__call('seek', [$position, $whence])); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Ipc; use Amp\Deferred; use Amp\Ipc\IpcServer; use Amp\Ipc\Sync\ChannelledSocket; use Amp\Promise; use Amp\Success; use danog\Loop\SignalLoop; use danog\MadelineProto\Exception as Exception; use danog\MadelineProto\Ipc\Runner\ProcessRunner; use danog\MadelineProto\Ipc\Runner\WebRunner; use danog\MadelineProto\Logger; use danog\MadelineProto\Loop\InternalLoop; use danog\MadelineProto\SessionPaths; use danog\MadelineProto\Settings\Ipc; use danog\MadelineProto\Tools; use function Amp\Promise\first; /** * IPC server. */ class Server extends SignalLoop { use InternalLoop; /** * Server version. */ const VERSION = 1; /** * Shutdown server. */ const SHUTDOWN = 0; /** * Boolean to shut down worker, if started. */ private static bool $shutdown = false; /** * Deferred to shut down worker, if started. */ private static ?Deferred $shutdownDeferred = null; /** * Boolean whether to shut down worker, if started. */ private static bool $shutdownNow = false; /** * IPC server. */ protected IpcServer $server; /** * Callback IPC server. */ private ServerCallback $callback; /** * IPC settings. */ private Ipc $settings; /** * Set IPC path. * * @param SessionPaths $session Session * */ public function setIpcPath(SessionPaths $session): void { self::$shutdownDeferred ??= new Deferred; $this->server = new IpcServer($session->getIpcPath()); $this->callback = new ServerCallback($this->API); $this->callback->setIpcPath($session); } public function start(): bool { return $this instanceof ServerCallback ? parent::start() : $this->callback->start() && parent::start(); } /** * Start IPC server in background. * * @param SessionPaths $session Session path * */ public static function startMe(SessionPaths $session): Promise { $id = Tools::randomInt(2000000000); $started = false; $promises = []; try { Logger::log("Starting IPC server $session (process)"); $promises []= ProcessRunner::start($session, $id); $started = true; $promises []= WebRunner::start($session, $id); return Tools::call(self::monitor($session, $id, $started, first($promises))); } catch (\Throwable $e) { Logger::log($e); } try { Logger::log("Starting IPC server $session (web)"); $promises []= WebRunner::start($session, $id); $started = true; } catch (\Throwable $e) { Logger::log($e); } return Tools::call(self::monitor($session, $id, $started, $promises ? first($promises) : (new Deferred)->promise())); } /** * Monitor session. * * @param Promise $cancelConnect * */ private static function monitor(SessionPaths $session, int $id, bool $started, Promise $cancelConnect): \Generator { if (!$started) { Logger::log("It looks like the server couldn't be started, trying to connect anyway..."); } $count = 0; while (true) { $state = yield $session->getIpcState(); if ($state && $state->getStartupId() === $id) { if ($e = $state->getException()) { Logger::log("IPC server got exception $e"); return $e; } Logger::log("IPC server started successfully!"); return true; } elseif (!$started && $count > 0 && $count > 2*($state ? 3 : 1)) { return new Exception("We couldn't start the IPC server, please check the logs!"); } try { yield Tools::timeoutWithDefault($cancelConnect, 500, null); $cancelConnect = (new Deferred)->promise(); } catch (\Throwable $e) { Logger::log("$e"); Logger::log("Could not start IPC server, please check the logs for more details!"); return $e; } $count++; } return false; } /** * Wait for shutdown. * */ public static function waitShutdown(): Promise { if (self::$shutdownNow) { return new Success; } self::$shutdownDeferred ??= new Deferred; return self::$shutdownDeferred->promise(); } /** * Shutdown. * */ final public function shutdown(): void { $this->signal(null); if (self::$shutdownDeferred) { self::$shutdownNow = true; $deferred = self::$shutdownDeferred; self::$shutdownDeferred = null; $deferred->resolve(); } } /** * Main loop. * */ public function loop(): \Generator { while ($socket = yield $this->waitSignal($this->server->accept())) { Tools::callFork($this->clientLoop($socket)); } $this->server->close(); if (isset($this->callback)) { $this->callback->signal(null); } } /** * Client handler loop. * * @param ChannelledSocket $socket Client * * @return \Generator|Promise */ protected function clientLoop(ChannelledSocket $socket) { $this->API->logger("Accepted IPC client connection!"); $id = 0; $payload = null; try { while ($payload = yield $socket->receive()) { Tools::callFork($this->clientRequest($socket, $id++, $payload)); } } catch (\Throwable $e) { Logger::log("Exception in IPC connection: $e"); } finally { try { yield $socket->disconnect(); } catch (\Throwable $e) { } if ($payload === self::SHUTDOWN) { $this->shutdown(); } } } /** * Handle client request. * * @param ChannelledSocket $socket Socket * @param array{0: string, 1: array|Wrapper} $payload Payload * */ private function clientRequest(ChannelledSocket $socket, int $id, $payload): \Generator { try { yield from $this->API->initAsynchronously(); if ($payload[1] instanceof Wrapper) { $wrapper = $payload[1]; $payload[1] = $this->callback->unwrap($wrapper); } $result = $this->API->{$payload[0]}(...$payload[1]); $result = $result instanceof \Generator ? yield from $result : ($result instanceof Promise ? yield $result : $result); } catch (\Throwable $e) { $this->API->logger("Got error while calling IPC method: $e", Logger::ERROR); $result = new ExitFailure($e); } finally { if (isset($wrapper)) { try { yield $wrapper->disconnect(); } catch (\Throwable $e) { } } } try { yield $socket->send([$id, $result]); } catch (\Throwable $e) { $this->API->logger("Got error while trying to send result of {$payload[0]}: $e", Logger::ERROR); try { yield $socket->send([$id, new ExitFailure($e)]); } catch (\Throwable $e) { $this->API->logger("Got error while trying to send error of error of {$payload[0]}: $e", Logger::ERROR); } } } /** * Get the name of the loop. * */ public function __toString(): string { return "IPC server"; } /** * Set IPC settings. * * @param Ipc $settings IPC settings * */ public function setSettings(Ipc $settings): self { $this->settings = $settings; return $this; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Ipc; use Amp\Deferred; use Amp\Ipc\Sync\ChannelledSocket; use Amp\Promise; use danog\MadelineProto\Logger; use function Amp\Ipc\connect; /** * IPC client. */ abstract class ClientAbstract { /** * IPC server socket. */ protected ChannelledSocket $server; /** * Requests promise array. * * @var Deferred[] */ private array $requests = []; /** * Wrappers array. * * @var Wrapper[] */ private array $wrappers = []; /** * Whether to run loop. */ protected bool $run = true; /** * Logger instance. */ public Logger $logger; protected function __construct() { } /** * Logger. * * @param string $param Parameter * @param int $level Logging level * @param string $file File where the message originated * */ public function logger($param, int $level = Logger::NOTICE, string $file = ''): void { if ($file === null) { $file = \basename(\debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 1)[0]['file'], '.php'); } isset($this->logger) ? $this->logger->logger($param, $level, $file) : Logger::$default->logger($param, $level, $file); } /** * Main loop. * */ protected function loopInternal(): \Generator { do { while (true) { $payload = null; try { $payload = yield $this->server->receive(); } catch (\Throwable $e) { Logger::log("Got exception while receiving in IPC client: $e"); } if (!$payload) { break; } [$id, $payload] = $payload; if (!isset($this->requests[$id])) { Logger::log("Got response for non-existing ID $id!"); } else { $promise = $this->requests[$id]; unset($this->requests[$id]); if (isset($this->wrappers[$id])) { yield $this->wrappers[$id]->disconnect(); unset($this->wrappers[$id]); } if ($payload instanceof ExitFailure) { $promise->fail($payload->getException()); } else { $promise->resolve($payload); } unset($promise); } } if ($this->run) { $this->logger("Reconnecting to IPC server!"); try { yield $this->server->disconnect(); } catch (\Throwable $e) { } if ($this instanceof Client) { try { yield Server::startMe($this->session); $this->server = yield connect($this->session->getIpcPath()); } catch (\Throwable $e) { Logger::log("Got exception while reconnecting in IPC client: $e"); } } else { return; } } } while ($this->run); } /** * Disconnect cleanly from main instance. * * * @psalm-return \Generator */ public function disconnect(): \Generator { $this->run = false; yield $this->server->disconnect(); foreach ($this->wrappers as $w) { yield from $w->disconnect(); } } /** * Call function. * * @param string|int $function Function name * @param array|Wrapper $arguments Arguments * */ public function __call($function, $arguments): \Generator { $this->requests []= $deferred = new Deferred; if ($arguments instanceof Wrapper) { $this->wrappers[\count($this->requests) - 1] = $arguments; } yield $this->server->send([$function, $arguments]); return yield $deferred->promise(); } } type = \get_class($exception); $this->message = $exception->getMessage(); $this->code = $exception->getCode(); $this->trace = flattenThrowableBacktrace($exception); if (\method_exists($exception, 'getTLTrace')) { $this->tlTrace = $exception->getTLTrace(); } if ($exception instanceof RPCErrorException) { $this->localized = $exception->getLocalization(); } if ($previous = $exception->getPrevious()) { $this->previous = new self($previous); } } public function getException(): object { $previous = $this->previous ? $this->previous->getException() : null; try { $exception = new $this->type($this->message, $this->code, $previous); } catch (TypeError) { $exception = new \RuntimeException($this->message, $this->code, $previous); } if ($this->tlTrace) { $exception->setTLTrace($this->tlTrace); } if ($this->localized) { $exception->setLocalization($this->localized); } return $exception; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Ipc; use Amp\Ipc\Sync\ChannelledSocket; use Amp\Promise; use danog\MadelineProto\Exception; use danog\MadelineProto\FileCallbackInterface; use danog\MadelineProto\Logger; use danog\MadelineProto\MTProtoTools\FilesLogic; use danog\MadelineProto\SessionPaths; use danog\MadelineProto\Tools; /** * IPC client. */ class Client extends ClientAbstract { use \danog\MadelineProto\Wrappers\Start; use \danog\MadelineProto\Wrappers\Templates; use FilesLogic; /** * Instances. */ private static array $instances = []; /** * Returns an instance of a client by session name. * */ public static function giveInstanceBySession(string $session): Client { return self::$instances[$session]; } /** * Whether the wrapper API is async. */ public bool $async; /** * Session. */ protected SessionPaths $session; /** * Constructor function. * * @param SessionPaths $session Session paths * @param Logger $logger Logger * @param bool $async Whether the wrapper API is async */ public function __construct(ChannelledSocket $server, SessionPaths $session, Logger $logger, bool &$async) { $this->async = &$async; $this->logger = $logger; $this->server = $server; $this->session = $session; self::$instances[$session->getLegacySessionPath()] = $this; Tools::callFork($this->loopInternal()); } /** * Run the provided async callable. * * @param callable $callback Async callable to run * */ public function loop(callable $callback): \Generator { return yield $callback(); } /** * Unreference. * */ public function unreference(): void { try { Tools::wait($this->disconnect()); } catch (\Throwable $e) { $this->logger("An error occurred while disconnecting the client: $e"); } if (isset(self::$instances[$this->session->getLegacySessionPath()])) { unset(self::$instances[$this->session->getLegacySessionPath()]); } } /** * Stop IPC server instance. * * @internal */ public function stopIpcServer(): Promise { $this->run = false; return $this->server->send(Server::SHUTDOWN); } /** * Restart IPC server instance. * * @internal */ public function restartIpcServer(): Promise { return $this->server->send(Server::SHUTDOWN); } /** * Whether we're an IPC client instance. * * @return boolean */ public function isIpc(): bool { return true; } /** * Upload file from URL. * * @param string|FileCallbackInterface $url URL of file * @param integer $size Size of file * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $encrypted Whether to encrypt file for secret chats * */ public function uploadFromUrl($url, int $size = 0, string $fileName = '', $cb = null, bool $encrypted = false): \Generator { if (\is_object($url) && $url instanceof FileCallbackInterface) { $cb = $url; $url = yield $url->getFile(); } $params = [$url, $size, $fileName, &$cb, $encrypted]; $wrapper = yield from Wrapper::create($params, $this->session, $this->logger); $wrapper->wrap($cb, false); return yield from $this->__call('uploadFromUrl', $wrapper); } /** * Upload file from callable. * * The callable must accept two parameters: int $offset, int $size * The callable must return a string with the contest of the file at the specified offset and size. * * @param mixed $callable Callable * @param integer $size File size * @param string $mime Mime type * @param string $fileName File name * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $seekable Whether chunks can be fetched out of order * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Generator|Promise, mixed, mixed> */ public function uploadFromCallable(callable $callable, int $size, string $mime, string $fileName = '', $cb = null, bool $seekable = true, bool $encrypted = false): \Generator { if (\is_object($callable) && $callable instanceof FileCallbackInterface) { $cb = $callable; $callable = yield $callable->getFile(); } $params = [&$callable, $size, $mime, $fileName, &$cb, $seekable, $encrypted]; $wrapper = yield from Wrapper::create($params, $this->session, $this->logger); $wrapper->wrap($cb, false); $wrapper->wrap($callable, false); return yield from $this->__call('uploadFromCallable', $wrapper); } /** * Reupload telegram file. * * @param mixed $media Telegram file * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * @param boolean $encrypted Whether to encrypt file for secret chats * * * @psalm-return \Generator|Promise, mixed, mixed> */ public function uploadFromTgfile($media, $cb = null, bool $encrypted = false): \Generator { if (\is_object($media) && $media instanceof FileCallbackInterface) { $cb = $media; $media = yield $media->getFile(); } $params = [$media, &$cb, $encrypted]; $wrapper = yield from Wrapper::create($params, $this->session, $this->logger); $wrapper->wrap($cb, false); return yield from $this->__call('uploadFromTgfile', $wrapper); } /** * Call method and wait asynchronously for response. * * If the $aargs['noResponse'] is true, will not wait for a response. * * @param string $method Method name * @param array|\Generator $args Arguments * @param array $aargs Additional arguments * * @psalm-param array|\Generator $args * * @return \Generator */ public function methodCallAsyncRead(string $method, $args, array $aargs) { if (\is_array($args)) { if (($method === 'messages.editInlineBotMessage' || $method === 'messages.uploadMedia' || $method === 'messages.sendMedia' || $method === 'messages.editMessage') && isset($args['media']['file']) && $args['media']['file'] instanceof FileCallbackInterface ) { $params = [$method, &$args, $aargs]; $wrapper = yield from Wrapper::create($params, $this->session, $this->logger); $wrapper->wrap($args['media']['file'], true); return yield from $this->__call('methodCallAsyncRead', $wrapper); } elseif ($method === 'messages.sendMultiMedia' && isset($args['multi_media'])) { $params = [$method, &$args, $aargs]; $wrapper = yield from Wrapper::create($params, $this->session, $this->logger); foreach ($args['multi_media'] as &$media) { if (isset($media['media']['file']) && $media['media']['file'] instanceof FileCallbackInterface) { $wrapper->wrap($media['media']['file'], true); } } return yield from $this->__call('methodCallAsyncRead', $wrapper); } } return yield from $this->__call('methodCallAsyncRead', [$method, $args, $aargs]); } /** * Download file to directory. * * @param mixed $messageMedia File to download * @param string|FileCallbackInterface $dir Directory where to download the file * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * * @return \Generator Downloaded file path * * @psalm-return \Generator|Promise, mixed, mixed> */ public function downloadToDir($messageMedia, $dir, $cb = null): \Generator { if (\is_object($dir) && $dir instanceof FileCallbackInterface) { $cb = $dir; $dir = yield $dir->getFile(); } $params = [$messageMedia, $dir, &$cb]; $wrapper = yield from Wrapper::create($params, $this->session, $this->logger); $wrapper->wrap($cb, false); return yield from $this->__call('downloadToDir', $wrapper); } /** * Download file. * * @param mixed $messageMedia File to download * @param string|FileCallbackInterface $file Downloaded file path * @param callable $cb Callback (DEPRECATED, use FileCallbackInterface) * * @return \Generator Downloaded file path * * @psalm-return \Generator|Promise, mixed, mixed> */ public function downloadToFile($messageMedia, $file, $cb = null): \Generator { if (\is_object($file) && $file instanceof FileCallbackInterface) { $cb = $file; $file = yield $file->getFile(); } $params = [$messageMedia, $file, &$cb]; $wrapper = yield from Wrapper::create($params, $this->session, $this->logger); $wrapper->wrap($cb, false); return yield from $this->__call('downloadToFile', $wrapper); } /** * Download file to callable. * The callable must accept two parameters: string $payload, int $offset * The callable will be called (possibly out of order, depending on the value of $seekable). * The callable should return the number of written bytes. * * @param mixed $messageMedia File to download * @param callable|FileCallbackInterface $callable Chunk callback * @param callable $cb Status callback (DEPRECATED, use FileCallbackInterface) * @param bool $seekable Whether the callable can be called out of order * @param int $offset Offset where to start downloading * @param int $end Offset where to stop downloading (inclusive) * @param int $part_size Size of each chunk * * * @psalm-return \Generator|Promise, mixed, mixed> */ public function downloadToCallable($messageMedia, callable $callable, $cb = null, bool $seekable = true, int $offset = 0, int $end = -1, int $part_size = null): \Generator { $messageMedia = (yield from $this->getDownloadInfo($messageMedia)); if (\is_object($callable) && $callable instanceof FileCallbackInterface) { $cb = $callable; $callable = yield $callable->getFile(); } $params = [$messageMedia, &$callable, &$cb, $seekable, $offset, $end, $part_size, ]; $wrapper = yield from Wrapper::create($params, $this->session, $this->logger); $wrapper->wrap($callable, false); $wrapper->wrap($cb, false); return yield from $this->__call('downloadToCallable', $wrapper); } /** * Placeholder. * * @param mixed ...$params Params * */ public function setEventHandler(...$params): void { throw new Exception("Can't use ".__FUNCTION__." in an IPC client instance, please use startAndLoop, instead!"); } /** * Placeholder. * * @param mixed ...$params Params * */ public function getEventHandler(...$params): void { throw new Exception("Can't use ".__FUNCTION__." in an IPC client instance, please use startAndLoop, instead!"); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Http\Client\Cookie\InMemoryCookieJar; use Amp\Http\Client\Request; /** * Wrapper for my.telegram.org. */ class MyTelegramOrgWrapper { /** * Whether we're logged in. */ private bool $logged = false; /** * Login hash. */ private string $hash = ''; /** * Phone number. * */ private string $number = ''; /** * Creation hash. */ private string $creation_hash = ''; /** * Settings. * * @var Settings */ private $settings; /** * Async setting. */ private bool $async = true; /** * Datacenter instance. */ private DataCenter $datacenter; /** * Cooke jar. * * @var InMemoryCookieJar */ private $jar; /** * Endpoint. */ private const MY_TELEGRAM_URL = 'https://my.telegram.org'; /** * Sleep function. * */ public function __sleep(): array { return ['logged', 'hash', 'number', 'creation_hash', 'settings', 'async', 'jar']; } /** * Constructor. * * @param array|Settings $settings */ public function __construct($settings) { $this->settings = Settings::parseFromLegacy($settings); if (!$this->settings instanceof Settings) { $settings = new Settings; $settings->merge($this->settings); $this->settings = $settings; } $this->__wakeup(); } /** * Wakeup function. * */ public function __wakeup(): void { if (!$this->settings) { $this->settings = new Settings; } elseif (\is_array($this->settings)) { $this->settings = Settings::parseFromLegacy($this->settings); if (!$this->settings instanceof Settings) { $settings = new Settings; $settings->merge($this->settings); $this->settings = $settings; } } if (!$this->jar || !$this->jar instanceof InMemoryCookieJar) { $this->jar = new InMemoryCookieJar(); } $this->datacenter = new DataCenter(new class(new Logger($this->settings->getLogger())) { public Logger $logger; public function __construct(Logger $logger) { $this->logger = $logger; } public function getLogger(): Logger { return $this->logger; } }, [], $this->settings->getConnection(), true, $this->jar); } /** * Login. * * @param string $number Phone number * */ public function login(string $number): \Generator { $this->number = $number; $request = new Request(self::MY_TELEGRAM_URL.'/auth/send_password', 'POST'); $request->setBody(\http_build_query(['phone' => $number])); $request->setHeaders($this->getHeaders('origin')); $response = yield $this->datacenter->getHTTPClient()->request($request); $result = yield $response->getBody()->buffer(); $resulta = \json_decode($result, true); if (!isset($resulta['random_hash'])) { throw new Exception($result); } $this->hash = $resulta['random_hash']; } /** * Complete login. * * @param string $password Password * */ public function completeLogin(string $password): \Generator { if ($this->logged) { throw new Exception('Already logged in!'); } $request = new Request(self::MY_TELEGRAM_URL.'/auth/login', 'POST'); $request->setBody(\http_build_query(['phone' => $this->number, 'random_hash' => $this->hash, 'password' => $password])); $request->setHeaders($this->getHeaders('origin')); $request->setHeader('user-agent', 'Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.13) Gecko/20080311 Firefox/2.0.0.13'); $response = yield $this->datacenter->getHTTPClient()->request($request); $result = yield $response->getBody()->buffer(); switch ($result) { case 'true': //Logger::log(['Login OK'], Logger::VERBOSE); break; default: throw new Exception($result); } return $this->logged = true; } /** * Whether we are logged in. * * @return boolean */ public function loggedIn(): bool { return $this->logged; } /** * Check if an app was already created. * */ public function hasApp(): \Generator { if (!$this->logged) { throw new Exception('Not logged in!'); } $request = new Request(self::MY_TELEGRAM_URL.'/apps'); $request->setHeaders($this->getHeaders('refer')); $response = yield $this->datacenter->getHTTPClient()->request($request); $result = yield $response->getBody()->buffer(); $title = \explode('', \explode('', $result)[1])[0]; switch ($title) { case 'App configuration': return true; case 'Create new application': $this->creation_hash = \explode('"/>', \explode('<input type="hidden" name="hash" value="', $result)[1])[0]; return false; } $this->logged = false; throw new Exception($title); } /** * Get the currently created app. * */ public function getApp(): \Generator { if (!$this->logged) { throw new Exception('Not logged in!'); } $request = new Request(self::MY_TELEGRAM_URL.'/apps'); $request->setHeaders($this->getHeaders('refer')); $response = yield $this->datacenter->getHTTPClient()->request($request); $result = yield $response->getBody()->buffer(); $cose = \explode('<label for="app_id" class="col-md-4 text-right control-label">App api_id:</label> <div class="col-md-7"> <span class="form-control input-xlarge uneditable-input" onclick="this.select();"><strong>', $result); $asd = \explode('</strong></span>', $cose[1]); $api_id = $asd[0]; $cose = \explode('<label for="app_hash" class="col-md-4 text-right control-label">App api_hash:</label> <div class="col-md-7"> <span class="form-control input-xlarge uneditable-input" onclick="this.select();">', $result); $asd = \explode('</span>', $cose[1]); $api_hash = $asd[0]; return ['api_id' => (int) $api_id, 'api_hash' => $api_hash]; } /** * Create an app. * * @param array $settings App parameters * */ public function createApp(array $settings): \Generator { if (!$this->logged) { throw new Exception('Not logged in!'); } if (yield from $this->hasApp()) { throw new Exception('The app was already created!'); } $request = new Request(self::MY_TELEGRAM_URL.'/apps/create', 'POST'); $request->setHeaders($this->getHeaders('app')); $request->setBody(\http_build_query(['hash' => $this->creation_hash, 'app_title' => $settings['app_title'], 'app_shortname' => $settings['app_shortname'], 'app_url' => $settings['app_url'], 'app_platform' => $settings['app_platform'], 'app_desc' => $settings['app_desc']])); $response = yield $this->datacenter->getHTTPClient()->request($request); $result = yield $response->getBody()->buffer(); if ($result) { throw new Exception(\html_entity_decode($result)); } $request = new Request(self::MY_TELEGRAM_URL.'/apps'); $request->setHeaders($this->getHeaders('refer')); $response = yield $this->datacenter->getHTTPClient()->request($request); $result = yield $response->getBody()->buffer(); $title = \explode('', \explode('', $result)[1])[0]; if ($title === 'Create new application') { $this->creation_hash = \explode('"/>', \explode('<input type="hidden" name="hash" value="', $result)[1])[0]; throw new \danog\MadelineProto\Exception('App creation failed'); } $cose = \explode('<label for="app_id" class="col-md-4 text-right control-label">App api_id:</label> <div class="col-md-7"> <span class="form-control input-xlarge uneditable-input" onclick="this.select();"><strong>', $result); $asd = \explode('</strong></span>', $cose['1']); $api_id = $asd['0']; $cose = \explode('<label for="app_hash" class="col-md-4 text-right control-label">App api_hash:</label> <div class="col-md-7"> <span class="form-control input-xlarge uneditable-input" onclick="this.select();">', $result); $asd = \explode('</span>', $cose['1']); $api_hash = $asd['0']; return ['api_id' => (int) $api_id, 'api_hash' => $api_hash]; } /** * Function for generating curl request headers. * * @param string $httpType Origin * */ private function getHeaders(string $httpType): array { // Common header flags. $headers = []; $headers[] = 'Dnt: 1'; $headers[] = 'Connection: keep-alive'; $headers[] = 'Accept-Language: it-IT,it;q=0.8,en-US;q=0.6,en;q=0.4'; $headers[] = 'User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.133 Safari/537.36'; // Add additional headers based on the type of request. switch ($httpType) { case 'origin': $headers[] = 'Origin: '.self::MY_TELEGRAM_URL; //$headers[] = 'Accept-Encoding: gzip, deflate, br'; $headers[] = 'Content-Type: application/x-www-form-urlencoded; charset=UTF-8'; $headers[] = 'Accept: application/json, text/javascript, */*; q=0.01'; $headers[] = 'Referer: '.self::MY_TELEGRAM_URL.'/auth'; $headers[] = 'X-Requested-With: XMLHttpRequest'; break; case 'refer': //$headers[] = 'Accept-Encoding: gzip, deflate, sdch, br'; $headers[] = 'Upgrade-Insecure-Requests: 1'; $headers[] = 'Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8'; $headers[] = 'Referer: '.self::MY_TELEGRAM_URL; $headers[] = 'Cache-Control: max-age=0'; break; case 'app': $headers[] = 'Origin: '.self::MY_TELEGRAM_URL; //$headers[] = 'Accept-Encoding: gzip, deflate, br'; $headers[] = 'Content-Type: application/x-www-form-urlencoded; charset=UTF-8'; $headers[] = 'Accept: */*'; $headers[] = 'Referer: '.self::MY_TELEGRAM_URL.'/apps'; $headers[] = 'X-Requested-With: XMLHttpRequest'; break; } $final_headers = []; foreach ($headers as $header) { list($key, $value) = \explode(':', $header, 2); $final_headers[\trim($key)] = \trim($value); } return $final_headers; } /** * Enable or disable async. * * @param boolean $async Async * */ public function async(bool $async): void { $this->async = $async; } /** * Run specified callable synchronously. * * @param callable $callable Callable * */ public function loop(callable $callable) { return Tools::wait($callable()); } /** * Call function. * * @param string $name Function name * @param array $arguments Arguments * */ public function __call(string $name, array $arguments) { $name .= '_async'; $async = \is_array(\end($arguments)) && isset(\end($arguments)['async']) ? \end($arguments)['async'] : $this->async; if (!\method_exists($this, $name)) { throw new Exception("{$name} does not exist!"); } return $async ? $this->{$name}(...$arguments) : Tools::wait($this->{$name}(...$arguments)); } } <?php /* Copyright 2016-2018 Daniil Gentili (https://daniil.it) This file is part of MadelineProto. MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU General Public License along with MadelineProto. If not, see <http://www.gnu.org/licenses/>. */ namespace danog\MadelineProto\VoIP; trait AckHandler { public function seqgt($s1, $s2) { return $s1 > $s2; } public function received_packet($last_ack_id, $packet_seq_no, $ack_mask) { if ($this->seqgt($packet_seq_no, $this->session_in_seq_no)) { $diff = $packet_seq_no - $this->session_in_seq_no; if ($diff > 31) { $this->received_timestamp_map = \array_fill(0, 32, 0); } else { $remaining = 32-$diff; for ($x = 0; $x < $remaining; $x++) { $this->received_timestamp_map[$diff+$x] = $this->received_timestamp_map[$x]; } for ($x = 1; $x < $diff; $x++) { $this->received_timestamp_map[$x] = 0; } $this->received_timestamp_map[0] = \microtime(true); } $this->session_in_seq_no = $packet_seq_no; } elseif (($diff = $this->session_in_seq_no - $packet_seq_no) < 32) { if (!$this->received_timestamp_map[$diff]) { \danog\MadelineProto\Logger::log("Got duplicate $packet_seq_no"); return false; } $this->received_timestamp_map[$diff] = \microtime(true); } else { \danog\MadelineProto\Logger::log("Packet $packet_seq_no is out of order and too late"); return false; } if ($this->seqgt($last_ack_id, $this->session_out_seq_no)) { $diff = $last_ack_id - $this->session_out_seq_no; if ($diff > 31) { $this->remote_ack_timestamp_map = \array_fill(0, 32, 0); } else { $remaining = 32-$diff; for ($x = 0; $x < $remaining; $x++) { $this->remote_ack_timestamp_map[$diff+$x] = $this->remote_ack_timestamp_map[$x]; } for ($x = 1; $x < $diff; $x++) { $this->remote_ack_timestamp_map[$x] = 0; } $this->remote_ack_timestamp_map[0] = \microtime(true); } $this->session_out_seq_no = $last_ack_id; for ($x = 1; $x < 32; $x++) { if (!$this->remote_ack_timestamp_map[$x] && ($ack_mask >> 32-$x) & 1) { $this->remote_ack_timestamp_map[$x] = \microtime(true); } } } return true; } } <?php /** * AuthKeyHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\VoIP; use danog\MadelineProto\Loop\Update\UpdateLoop; use danog\MadelineProto\MTProtoTools\Crypt; use danog\MadelineProto\Tools; /** * Manages the creation of the authorization key. * * https://core.telegram.org/mtproto/auth_key * https://core.telegram.org/mtproto/samples-auth_key */ trait AuthKeyHandler { private $calls = []; /** * Accept call from VoIP instance. * * @param \danog\MadelineProto\VoIP $instance Call instance * @param array $user User * * @internal * */ public function acceptCallFrom($instance, $user) { $promise = Tools::call((function () use ($instance, $user) { if (!$res = yield from $this->acceptCall($user)) { $instance->discard(); return false; } return $instance; })()); if ($this->wrapper && $this->wrapper->isAsync()) { return $promise; } return Tools::wait($promise); } /** * Undocumented function. * * @param \danog\MadelineProto\VoIP $instance Call instance * @param array $call Call info * @param array $reason Discard reason * @param array $rating Rating * @param boolean $need_debug Needs debug? * * @internal * */ public function discardCallFrom($instance, $call, $reason, $rating = [], $need_debug = true) { $promise = Tools::call(function () use ($instance, $call, $reason, $rating, $need_debug) { if (!$res = yield from $this->discardCall($call, $reason, $rating, $need_debug)) { return false; } return $instance; }); if ($this->wrapper && $this->wrapper->isAsync()) { return $promise; } return Tools::wait($promise); } /** * Request VoIP call. * * @param mixed $user User * */ public function requestCall($user): \Generator { if (!\class_exists('\\danog\\MadelineProto\\VoIP')) { throw \danog\MadelineProto\Exception::extension('libtgvoip'); } $user = (yield from $this->getInfo($user)); if (!isset($user['InputUser']) || $user['InputUser']['_'] === 'inputUserSelf') { throw new \danog\MadelineProto\Exception(\danog\MadelineProto\Lang::$current_lang['peer_not_in_db']); } $user = $user['InputUser']; $this->logger->logger(\sprintf("Calling %s...", $user['user_id']), \danog\MadelineProto\Logger::VERBOSE); $dh_config = (yield from $this->getDhConfig()); $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['generating_a'], \danog\MadelineProto\Logger::VERBOSE); $a = \phpseclib3\Math\BigInteger::randomRange(\danog\MadelineProto\Magic::$two, $dh_config['p']->subtract(\danog\MadelineProto\Magic::$two)); $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['generating_g_a'], \danog\MadelineProto\Logger::VERBOSE); $g_a = $dh_config['g']->powMod($a, $dh_config['p']); Crypt::checkG($g_a, $dh_config['p']); $controller = new \danog\MadelineProto\VoIP(true, $user['user_id'], $this, \danog\MadelineProto\VoIP::CALL_STATE_REQUESTED); $controller->storage = ['a' => $a, 'g_a' => \str_pad($g_a->toBytes(), 256, \chr(0), \STR_PAD_LEFT)]; $res = yield from $this->methodCallAsyncRead('phone.requestCall', ['user_id' => $user, 'g_a_hash' => \hash('sha256', $g_a->toBytes(), true), 'protocol' => ['_' => 'phoneCallProtocol', 'udp_p2p' => true, 'udp_reflector' => true, 'min_layer' => 65, 'max_layer' => \danog\MadelineProto\VoIP::getConnectionMaxLayer()]]); $controller->setCall($res['phone_call']); $this->calls[$res['phone_call']['id']] = $controller; yield $this->updaters[UpdateLoop::GENERIC]->resume(); return $controller; } /** * Accept call. * * @param array $call Call * */ public function acceptCall(array $call): \Generator { if (!\class_exists('\\danog\\MadelineProto\\VoIP')) { throw new \danog\MadelineProto\Exception(); } if ($this->callStatus($call['id']) !== \danog\MadelineProto\VoIP::CALL_STATE_ACCEPTED) { $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['call_error_1'], $call['id'])); return false; } $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['accepting_call'], $this->calls[$call['id']]->getOtherID()), \danog\MadelineProto\Logger::VERBOSE); $dh_config = (yield from $this->getDhConfig()); $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['generating_b'], \danog\MadelineProto\Logger::VERBOSE); $b = \phpseclib3\Math\BigInteger::randomRange(\danog\MadelineProto\Magic::$two, $dh_config['p']->subtract(\danog\MadelineProto\Magic::$two)); $g_b = $dh_config['g']->powMod($b, $dh_config['p']); Crypt::checkG($g_b, $dh_config['p']); try { $res = yield from $this->methodCallAsyncRead('phone.acceptCall', ['peer' => ['id' => $call['id'], 'access_hash' => $call['access_hash'], '_' => 'inputPhoneCall'], 'g_b' => $g_b->toBytes(), 'protocol' => ['_' => 'phoneCallProtocol', 'udp_reflector' => true, 'udp_p2p' => true, 'min_layer' => 65, 'max_layer' => \danog\MadelineProto\VoIP::getConnectionMaxLayer()]]); } catch (\danog\MadelineProto\RPCErrorException $e) { if ($e->rpc === 'CALL_ALREADY_ACCEPTED') { $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['call_already_accepted'], $call['id'])); return true; } if ($e->rpc === 'CALL_ALREADY_DECLINED') { $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['call_already_declined']); yield from $this->discardCall($call['id'], ['_' => 'phoneCallDiscardReasonHangup']); return false; } throw $e; } $this->calls[$res['phone_call']['id']]->storage['b'] = $b; yield $this->updaters[UpdateLoop::GENERIC]->resume(); return true; } /** * Confirm call. * * @param array $params Params * */ public function confirmCall(array $params): \Generator { if (!\class_exists('\\danog\\MadelineProto\\VoIP')) { throw \danog\MadelineProto\Exception::extension('libtgvoip'); } if ($this->callStatus($params['id']) !== \danog\MadelineProto\VoIP::CALL_STATE_REQUESTED) { $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['call_error_2'], $params['id'])); return false; } $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['call_confirming'], $this->calls[$params['id']]->getOtherID()), \danog\MadelineProto\Logger::VERBOSE); $dh_config = (yield from $this->getDhConfig()); $params['g_b'] = new \phpseclib3\Math\BigInteger((string) $params['g_b'], 256); Crypt::checkG($params['g_b'], $dh_config['p']); $key = \str_pad($params['g_b']->powMod($this->calls[$params['id']]->storage['a'], $dh_config['p'])->toBytes(), 256, \chr(0), \STR_PAD_LEFT); try { $res = (yield from $this->methodCallAsyncRead('phone.confirmCall', ['key_fingerprint' => \substr(\sha1($key, true), -8), 'peer' => ['id' => $params['id'], 'access_hash' => $params['access_hash'], '_' => 'inputPhoneCall'], 'g_a' => $this->calls[$params['id']]->storage['g_a'], 'protocol' => ['_' => 'phoneCallProtocol', 'udp_reflector' => true, 'min_layer' => 65, 'max_layer' => \danog\MadelineProto\VoIP::getConnectionMaxLayer()]]))['phone_call']; } catch (\danog\MadelineProto\RPCErrorException $e) { if ($e->rpc === 'CALL_ALREADY_ACCEPTED') { $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['call_already_accepted'], $params['id'])); return true; } if ($e->rpc === 'CALL_ALREADY_DECLINED') { $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['call_already_declined']); yield from $this->discardCall($params['id'], ['_' => 'phoneCallDiscardReasonHangup']); return false; } throw $e; } $this->calls[$params['id']]->setCall($res); $visualization = []; $length = new \phpseclib3\Math\BigInteger(\count(\danog\MadelineProto\Magic::$emojis)); foreach (\str_split(\hash('sha256', $key.\str_pad($this->calls[$params['id']]->storage['g_a'], 256, \chr(0), \STR_PAD_LEFT), true), 8) as $number) { $number[0] = \chr(\ord($number[0]) & 0x7f); $visualization[] = \danog\MadelineProto\Magic::$emojis[(int) (new \phpseclib3\Math\BigInteger($number, 256))->divide($length)[1]->toString()]; } $this->calls[$params['id']]->setVisualization($visualization); $this->calls[$params['id']]->configuration['endpoints'] = \array_merge($res['connections'], $this->calls[$params['id']]->configuration['endpoints']); $this->calls[$params['id']]->configuration = \array_merge(['recv_timeout' => $this->config['call_receive_timeout_ms'] / 1000, 'init_timeout' => $this->config['call_connect_timeout_ms'] / 1000, 'data_saving' => \danog\MadelineProto\VoIP::DATA_SAVING_NEVER, 'enable_NS' => true, 'enable_AEC' => true, 'enable_AGC' => true, 'auth_key' => $key, 'auth_key_id' => \substr(\sha1($key, true), -8), 'call_id' => \substr(\hash('sha256', $key, true), -16), 'network_type' => \danog\MadelineProto\VoIP::NET_TYPE_ETHERNET], $this->calls[$params['id']]->configuration); $this->calls[$params['id']]->parseConfig(); $res = $this->calls[$params['id']]->startTheMagic(); return $res; } /** * Complete call handshake. * * @param array $params Params * */ public function completeCall(array $params): \Generator { if (!\class_exists('\\danog\\MadelineProto\\VoIP')) { throw \danog\MadelineProto\Exception::extension('libtgvoip'); } if ($this->callStatus($params['id']) !== \danog\MadelineProto\VoIP::CALL_STATE_ACCEPTED || !isset($this->calls[$params['id']]->storage['b'])) { $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['call_error_3'], $params['id'])); return false; } $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['call_completing'], $this->calls[$params['id']]->getOtherID()), \danog\MadelineProto\Logger::VERBOSE); $dh_config = (yield from $this->getDhConfig()); if (\hash('sha256', $params['g_a_or_b'], true) != $this->calls[$params['id']]->storage['g_a_hash']) { throw new \danog\MadelineProto\SecurityException(\danog\MadelineProto\Lang::$current_lang['invalid_g_a']); } $params['g_a_or_b'] = new \phpseclib3\Math\BigInteger((string) $params['g_a_or_b'], 256); Crypt::checkG($params['g_a_or_b'], $dh_config['p']); $key = \str_pad($params['g_a_or_b']->powMod($this->calls[$params['id']]->storage['b'], $dh_config['p'])->toBytes(), 256, \chr(0), \STR_PAD_LEFT); if (\substr(\sha1($key, true), -8) != $params['key_fingerprint']) { throw new \danog\MadelineProto\SecurityException(\danog\MadelineProto\Lang::$current_lang['fingerprint_invalid']); } $visualization = []; $length = new \phpseclib3\Math\BigInteger(\count(\danog\MadelineProto\Magic::$emojis)); foreach (\str_split(\hash('sha256', $key.\str_pad($params['g_a_or_b']->toBytes(), 256, \chr(0), \STR_PAD_LEFT), true), 8) as $number) { $number[0] = \chr(\ord($number[0]) & 0x7f); $visualization[] = \danog\MadelineProto\Magic::$emojis[(int) (new \phpseclib3\Math\BigInteger($number, 256))->divide($length)[1]->toString()]; } $this->calls[$params['id']]->setVisualization($visualization); $this->calls[$params['id']]->configuration['endpoints'] = \array_merge($params['connections'], $this->calls[$params['id']]->configuration['endpoints']); $this->calls[$params['id']]->configuration = \array_merge(['recv_timeout' => $this->config['call_receive_timeout_ms'] / 1000, 'init_timeout' => $this->config['call_connect_timeout_ms'] / 1000, 'data_saving' => \danog\MadelineProto\VoIP::DATA_SAVING_NEVER, 'enable_NS' => true, 'enable_AEC' => true, 'enable_AGC' => true, 'auth_key' => $key, 'auth_key_id' => \substr(\sha1($key, true), -8), 'call_id' => \substr(\hash('sha256', $key, true), -16), 'network_type' => \danog\MadelineProto\VoIP::NET_TYPE_ETHERNET], $this->calls[$params['id']]->configuration); $this->calls[$params['id']]->parseConfig(); return $this->calls[$params['id']]->startTheMagic(); } /** * Get call status. * * @param int $id Call ID * * @return integer */ public function callStatus($id): int { if (!\class_exists('\\danog\\MadelineProto\\VoIP')) { throw \danog\MadelineProto\Exception::extension('libtgvoip'); } if (isset($this->calls[$id])) { return $this->calls[$id]->getCallState(); } return \danog\MadelineProto\VoIP::CALL_STATE_NONE; } /** * Get call info. * * @param int $call Call ID * */ public function getCall($call): array { if (!\class_exists('\\danog\\MadelineProto\\VoIP')) { throw \danog\MadelineProto\Exception::extension('libtgvoip'); } return $this->calls[$call]; } /** * Discard call. * * @param array $call Call * @param array $rating Rating * @param boolean $need_debug Need debug? * */ public function discardCall(array $call, array $reason, array $rating = [], bool $need_debug = true): \Generator { if (!\class_exists('\\danog\\MadelineProto\\VoIP')) { throw \danog\MadelineProto\Exception::extension('libtgvoip'); } if (!isset($this->calls[$call['id']])) { return; } $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['call_discarding'], $call['id']), \danog\MadelineProto\Logger::VERBOSE); try { $res = yield from $this->methodCallAsyncRead('phone.discardCall', ['peer' => $call, 'duration' => \time() - $this->calls[$call['id']]->whenCreated(), 'connection_id' => $this->calls[$call['id']]->getPreferredRelayID(), 'reason' => $reason]); } catch (\danog\MadelineProto\RPCErrorException $e) { if (!\in_array($e->rpc, ['CALL_ALREADY_DECLINED', 'CALL_ALREADY_ACCEPTED'])) { throw $e; } } if (!empty($rating)) { $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['call_set_rating'], $call['id']), \danog\MadelineProto\Logger::VERBOSE); yield from $this->methodCallAsyncRead('phone.setCallRating', ['peer' => $call, 'rating' => $rating['rating'], 'comment' => $rating['comment']]); } if ($need_debug && isset($this->calls[$call['id']])) { $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['call_debug_saving'], $call['id']), \danog\MadelineProto\Logger::VERBOSE); yield from $this->methodCallAsyncRead('phone.saveCallDebug', ['peer' => $call, 'debug' => $this->calls[$call['id']]->getDebugLog()]); } $update = ['_' => 'updatePhoneCall', 'phone_call' => $this->calls[$call['id']]]; $this->updates[$this->updates_key++] = $update; unset($this->calls[$call['id']]); } /** * Check state of calls. * * @internal * */ public function checkCalls(): void { \array_walk($this->calls, function ($controller, $id): void { if ($controller->getCallState() === \danog\MadelineProto\VoIP::CALL_STATE_ENDED) { $this->logger("Discarding ended call..."); $controller->discard(); unset($this->calls[$id]); } }); } } <?php /* Copyright 2016-2018 Daniil Gentili (https://daniil.it) This file is part of MadelineProto. MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU General Public License along with MadelineProto. If not, see <http://www.gnu.org/licenses/>. */ namespace danog\MadelineProto\VoIP; use danog\MadelineProto\TL\Exception; use danog\MadelineProto\Tools; /** * Manages packing and unpacking of messages, and the list of sent and received messages. */ trait MessageHandler { public function pack_string($object) { $l = \strlen($object); $concat = ''; if ($l <= 253) { $concat .= \chr($l); $concat .= $object; $concat .= \pack('@'.Tools::posmod(-$l - 1, 4)); } else { $concat .= \chr(254); $concat .= \substr(Tools::packSignedInt($l), 0, 3); $concat .= $object; $concat .= \pack('@'.Tools::posmod(-$l, 4)); } return $concat; } public function unpack_string($stream) { $l = \ord(\stream_get_contents($stream, 1)); if ($l > 254) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['length_too_big']); } if ($l === 254) { $long_len = \unpack('V', \stream_get_contents($stream, 3).\chr(0))[1]; $x = \stream_get_contents($stream, $long_len); $resto = Tools::posmod(-$long_len, 4); if ($resto > 0) { \stream_get_contents($stream, $resto); } } else { $x = \stream_get_contents($stream, $l); $resto = Tools::posmod(-($l + 1), 4); if ($resto > 0) { \stream_get_contents($stream, $resto); } } return $x; } public function send_message($args, $datacenter = null) { if ($datacenter === null) { return $this->send_message($args, \reset($this->sockets)); } $message = ''; switch ($args['_']) { // streamTypeSimple codec:int8 = StreamType; // // packetInit#1 protocol:int min_protocol:int flags:# data_saving_enabled:flags.0?true audio_streams:byteVector<streamTypeSimple> video_streams:byteVector<streamTypeSimple> = Packet; case \danog\MadelineProto\VoIP::PKT_INIT: $message .= Tools::packSignedInt($args['protocol']); $message .= Tools::packSignedInt($args['min_protocol']); $flags = 0; $flags = isset($args['data_saving_enabled']) && $args['data_saving_enabled'] ? $flags | 1 : $flags & ~1; $message .= Tools::packUnsignedInt($flags); $message .= \chr(\count($args['audio_streams'])); foreach ($args['audio_streams'] as $codec) { $message .= $codec; } $message .= \chr(0); $message .= \chr(\count($args['video_streams'])); foreach ($args['video_streams'] as $codec) { $message .= \chr($codec); } break; // streamType id:int8 type:int8 codec:int8 frame_duration:int16 enabled:int8 = StreamType; // // packetInitAck#2 protocol:int min_protocol:int all_streams:byteVector<streamType> = Packet; case \danog\MadelineProto\VoIP::PKT_INIT_ACK: $message .= Tools::packSignedInt($args['protocol']); $message .= Tools::packSignedInt($args['min_protocol']); $message .= \chr(\count($args['all_streams'])); foreach ($args['all_streams'] as $stream) { $message .= \chr($stream['id']); $message .= \chr($stream['type']); $message .= $stream['codec']; $message .= \pack('v', $stream['frame_duration']); $message .= \chr($stream['enabled']); } break; // streamTypeState id:int8 enabled:int8 = StreamType; // packetStreamState#3 state:streamTypeState = Packet; case \danog\MadelineProto\VoIP::PKT_STREAM_STATE: $message .= \chr($args['id']); $message .= \chr($args['enabled']); break; // streamData flags:int2 stream_id:int6 has_more_flags:flags.1?true length:(flags.0?int16:int8) timestamp:int data:byteArray = StreamData; // packetStreamData#4 stream_data:streamData = Packet; case \danog\MadelineProto\VoIP::PKT_STREAM_DATA: $length = \strlen($args['data']); $flags = 0; $flags = $length > 255 ? $flags | 1 : $flags & ~1; $flags = isset($args['has_more_flags']) && $args['has_more_flags'] ? $flags | 2 : $flags & ~2; $flags = $flags << 6; $flags = $flags | $args['stream_id']; $message .= \chr($flags); $message .= $length > 255 ? \pack('v', $length) : \chr($length); $message .= Tools::packUnsignedInt($args['timestamp']); $message .= $args['data']; break; /*case \danog\MadelineProto\VoIP::PKT_UPDATE_STREAMS: break; case \danog\MadelineProto\VoIP::PKT_PING: break;*/ case \danog\MadelineProto\VoIP::PKT_PONG: $message .= Tools::packUnsignedInt($args['out_seq_no']); break; case \danog\MadelineProto\VoIP::PKT_STREAM_DATA_X2: for ($x = 0; $x < 2; $x++) { $length = \strlen($args[$x]['data']); $flags = 0; $flags = $length > 255 ? $flags | 1 : $flags & ~1; $flags = isset($args[$x]['has_more_flags']) && $args[$x]['has_more_flags'] ? $flags | 2 : $flags & ~2; $flags = $flags << 6; $flags = $flags | $args[$x]['stream_id']; $message .= \chr($flags); $message .= $length > 255 ? \pack('v', $length) : \chr($length); $message .= Tools::packUnsignedInt($args[$x]['timestamp']); $message .= $args[$x]['data']; } break; case \danog\MadelineProto\VoIP::PKT_STREAM_DATA_X3: for ($x = 0; $x < 3; $x++) { $length = \strlen($args[$x]['data']); $flags = 0; $flags = $length > 255 ? $flags | 1 : $flags & ~1; $flags = isset($args[$x]['has_more_flags']) && $args[$x]['has_more_flags'] ? $flags | 2 : $flags & ~2; $flags = $flags << 6; $flags = $flags | $args[$x]['stream_id']; $message .= \chr($flags); $message .= $length > 255 ? \pack('v', $length) : \chr($length); $message .= Tools::packUnsignedInt($args[$x]['timestamp']); $message .= $args[$x]['data']; } break; // packetLanEndpoint#A address:int port:int = Packet; case \danog\MadelineProto\VoIP::PKT_LAN_ENDPOINT: $message .= Tools::packSignedInt($args['address']); $message .= Tools::packSignedInt($args['port']); break; // packetNetworkChanged#B flags:# data_saving_enabled:flags.0?true = Packet; case \danog\MadelineProto\VoIP::PKT_NETWORK_CHANGED: $message .= Tools::packSignedInt(isset($args['data_saving_enabled']) && $args['data_saving_enabled'] ? 1 : 0); break; // packetSwitchPreferredRelay#C relay_id:long = Packet; case \danog\MadelineProto\VoIP::PKT_SWITCH_PREF_RELAY: $message .= Tools::packSignedLong($args['relay_d']); break; /*case \danog\MadelineProto\VoIP::PKT_SWITCH_TO_P2P: break; case \danog\MadelineProto\VoIP::PKT_NOP: break;*/ } $ack_mask = 0; for ($x=0;$x<32;$x++) { if ($this->received_timestamp_map[$x]>0) { $ack_mask|=1; } if ($x<31) { $ack_mask<<=1; } } if ($this->peerVersion >= 8 || (!$this->peerVersion && true)) { $payload = \chr($args['_']); $payload .= Tools::packUnsignedInt($this->session_in_seq_no); $payload .= Tools::packUnsignedInt($this->session_out_seq_no); $payload .= Tools::packUnsignedInt($ack_mask); $payload .= \chr(0); $payload .= $message; } elseif (\in_array($this->voip_state, [\danog\MadelineProto\VoIP::STATE_WAIT_INIT, \danog\MadelineProto\VoIP::STATE_WAIT_INIT_ACK])) { $payload = $this->TLID_DECRYPTED_AUDIO_BLOCK; $payload .= Tools::random(8); $payload .= \chr(7); $payload .= Tools::random(7); $flags = 0; $flags = $flags | 4; // call_id $flags = $flags | 16; // seqno $flags = $flags | 32; // ack mask $flags = $flags | 8; // proto $flags = isset($args['extra']) ? $flags | 2 : $flags & ~2; // extra $flags = \strlen($message) ? $flags | 1 : $flags & ~1; // raw_data $flags = $flags | ($args['_'] << 24); $payload .= Tools::packUnsignedInt($flags); $payload .= $this->configuration['call_id']; $payload .= Tools::packUnsignedInt($this->session_in_seq_no); $payload .= Tools::packUnsignedInt($this->session_out_seq_no); $payload .= Tools::packUnsignedInt($ack_mask); $payload .= \danog\MadelineProto\VoIP::PROTO_ID; if ($flags & 2) { $payload .= $this->pack_string($args['extra']); } if ($flags & 1) { $payload .= $this->pack_string($message); } } else { $payload = $this->TLID_SIMPLE_AUDIO_BLOCK; $payload .= Tools::random(8); $payload .= \chr(7); $payload .= Tools::random(7); $message = \chr($args['_']).Tools::packUnsignedInt($this->session_in_seq_no).Tools::packUnsignedInt($this->session_out_seq_no).Tools::packUnsignedInt($ack_mask).$message; $payload .= $this->pack_string($message); } $this->session_out_seq_no++; return $datacenter->write($payload); } /** * Reading connection and receiving message from server. */ public function recv_message(Endpoint $endpoint) { if (!$payload = yield from $endpoint->read()) { return null; } $result = []; switch ($crc = \stream_get_contents($payload, 4)) { case $this->TLID_DECRYPTED_AUDIO_BLOCK: \stream_get_contents($payload, 8); $this->unpack_string($payload); $flags = \unpack('V', \stream_get_contents($payload, 4))[1]; $result['_'] = $flags >> 24; if ($flags & 4) { if (\stream_get_contents($payload, 16) !== $this->configuration['call_id']) { \danog\MadelineProto\Logger::log('Call ID mismatch', \danog\MadelineProto\Logger::ERROR); return false; } } if ($flags & 16) { $in_seq_no = \unpack('V', \stream_get_contents($payload, 4))[1]; $out_seq_no = \unpack('V', \stream_get_contents($payload, 4))[1]; } if ($flags & 32) { $ack_mask = \unpack('V', \stream_get_contents($payload, 4))[1]; } if ($flags & 8) { if (\stream_get_contents($payload, 4) !== \danog\MadelineProto\VoIP::PROTO_ID) { \danog\MadelineProto\Logger::log('Protocol mismatch', \danog\MadelineProto\Logger::ERROR); return false; } } if ($flags & 2) { $result['extra'] = $this->unpack_string($payload); } $message = \fopen('php://memory', 'rw+b'); if ($flags & 1) { \fwrite($message, $this->unpack_string($payload)); \fseek($message, 0); } break; case $this->TLID_SIMPLE_AUDIO_BLOCK: \stream_get_contents($payload, 8); $this->unpack_string($payload); $flags = \unpack('V', \stream_get_contents($payload, 4))[1]; $message = \fopen('php://memory', 'rw+b'); \fwrite($message, $this->unpack_string($payload)); \fseek($message, 0); $result['_'] = \ord(\stream_get_contents($message, 1)); $in_seq_no = \unpack('V', \stream_get_contents($message, 4))[1]; $out_seq_no = \unpack('V', \stream_get_contents($message, 4))[1]; $ack_mask = \unpack('V', \stream_get_contents($message, 4))[1]; break; case $this->TLID_REFLECTOR_SELF_INFO: $result['date'] = Tools::unpackSignedInt(\stream_get_contents($payload, 4)); $result['query_id'] = Tools::unpackSignedLong(\stream_get_contents($payload, 8)); $result['my_ip'] = \stream_get_contents($payload, 16); $result['my_port'] = Tools::unpackSignedInt(\stream_get_contents($payload, 4)); return $result; case $this->TLID_REFLECTOR_PEER_INFO: $result['my_address'] = Tools::unpackSignedInt(\stream_get_contents($payload, 4)); $result['my_port'] = Tools::unpackSignedInt(\stream_get_contents($payload, 4)); $result['peer_address'] = Tools::unpackSignedInt(\stream_get_contents($payload, 4)); $result['peer_port'] = Tools::unpackSignedInt(\stream_get_contents($payload, 4)); return $result; default: if ($this->peerVersion >= 8 || (!$this->peerVersion && true)) { \fseek($payload, 0); $result['_'] = \ord(\stream_get_contents($payload, 1)); $in_seq_no = \unpack('V', \stream_get_contents($payload, 4))[1]; $out_seq_no = \unpack('V', \stream_get_contents($payload, 4))[1]; $ack_mask = \unpack('V', \stream_get_contents($payload, 4))[1]; $flags = \ord(\stream_get_contents($payload, 1)); if ($flags & 1) { $result['extra'] = []; $count = \ord(\stream_get_contents($payload, 1)); for ($x = 0; $x < $count; $x++) { $len = \ord(\stream_get_contents($payload, 1)); $result['extra'][]= \stream_get_contents($payload, $len); } } $message = \fopen('php://memory', 'rw+b'); \fwrite($message, \stream_get_contents($payload)); \fseek($message, 0); } else { \danog\MadelineProto\Logger::log('Unknown packet received: '.\bin2hex($crc), \danog\MadelineProto\Logger::ERROR); return false; } } if (!$this->received_packet($in_seq_no, $out_seq_no, $ack_mask)) { return yield from $this->recv_message($endpoint); } switch ($result['_']) { // streamTypeSimple codec:int8 = StreamType; // // packetInit#1 protocol:int min_protocol:int flags:# data_saving_enabled:flags.0?true audio_streams:byteVector<streamTypeSimple> video_streams:byteVector<streamTypeSimple> = Packet; case \danog\MadelineProto\VoIP::PKT_INIT: $result['protocol'] = $this->peerVersion = Tools::unpackSignedInt(\stream_get_contents($message, 4)); $result['min_protocol'] = Tools::unpackSignedInt(\stream_get_contents($message, 4)); $flags = \unpack('V', \stream_get_contents($message, 4))[1]; $result['data_saving_enabled'] = (bool) ($flags & 1); $result['audio_streams'] = []; $length = \ord(\stream_get_contents($message, 1)); for ($x = 0; $x < $length; $x++) { $result['audio_streams'][$x] = \stream_get_contents($message, 4); } break; // streamType id:int8 type:int8 codec:int8 frame_duration:int16 enabled:int8 = StreamType; // // packetInitAck#2 protocol:int min_protocol:int all_streams:byteVector<streamType> = Packet; case \danog\MadelineProto\VoIP::PKT_INIT_ACK: $result['protocol'] = Tools::unpackSignedInt(\stream_get_contents($message, 4)); $result['min_protocol'] = Tools::unpackSignedInt(\stream_get_contents($message, 4)); $result['all_streams'] = []; $length = \ord(\stream_get_contents($message, 1)); for ($x = 0; $x < $length; $x++) { $result['all_streams'][$x]['id'] = \ord(\stream_get_contents($message, 1)); $result['all_streams'][$x]['type'] = \stream_get_contents($message, 4); $result['all_streams'][$x]['codec'] = \ord(\stream_get_contents($message, 1)); $result['all_streams'][$x]['frame_duration'] = \unpack('v', \stream_get_contents($message, 2))[1]; $result['all_streams'][$x]['enabled'] = \ord(\stream_get_contents($message, 1)); } break; // streamTypeState id:int8 enabled:int8 = StreamType; // packetStreamState#3 state:streamTypeState = Packet; case \danog\MadelineProto\VoIP::PKT_STREAM_STATE: $result['id'] = \ord(\stream_get_contents($message, 1)); $result['enabled'] = \ord(\stream_get_contents($message, 1)); break; // streamData flags:int2 stream_id:int6 has_more_flags:flags.1?true length:(flags.0?int16:int8) timestamp:int data:byteArray = StreamData; // packetStreamData#4 stream_data:streamData = Packet; case \danog\MadelineProto\VoIP::PKT_STREAM_DATA: $flags = \ord(\stream_get_contents($message, 1)); $result['stream_id'] = $flags & 0x3F; $flags = ($flags & 0xC0) >> 6; $result['has_more_flags'] = (bool) ($flags & 2); $length = $flags & 1 ? \unpack('v', \stream_get_contents($message, 2))[1] : \ord(\stream_get_contents($message, 1)); $result['timestamp'] = \unpack('V', \stream_get_contents($message, 4))[1]; $result['data'] = \stream_get_contents($message, $length); break; /*case \danog\MadelineProto\VoIP::PKT_UPDATE_STREAMS: break; case \danog\MadelineProto\VoIP::PKT_PING: break;*/ case \danog\MadelineProto\VoIP::PKT_PONG: if (\fstat($payload)['size'] - \ftell($payload)) { $result['out_seq_no'] = \unpack('V', \stream_get_contents($payload, 4))[1]; } break; case \danog\MadelineProto\VoIP::PKT_STREAM_DATA_X2: for ($x = 0; $x < 2; $x++) { $flags = \ord(\stream_get_contents($message, 1)); $result[$x]['stream_id'] = $flags & 0x3F; $flags = ($flags & 0xC0) >> 6; $result[$x]['has_more_flags'] = (bool) ($flags & 2); $length = $flags & 1 ? \unpack('v', \stream_get_contents($message, 2))[1] : \ord(\stream_get_contents($message, 1)); $result[$x]['timestamp'] = \unpack('V', \stream_get_contents($message, 4))[1]; $result[$x]['data'] = \stream_get_contents($message, $length); } break; case \danog\MadelineProto\VoIP::PKT_STREAM_DATA_X3: for ($x = 0; $x < 3; $x++) { $flags = \ord(\stream_get_contents($message, 1)); $result[$x]['stream_id'] = $flags & 0x3F; $flags = ($flags & 0xC0) >> 6; $result[$x]['has_more_flags'] = (bool) ($flags & 2); $length = $flags & 1 ? \unpack('v', \stream_get_contents($message, 2))[1] : \ord(\stream_get_contents($message, 1)); $result[$x]['timestamp'] = \unpack('V', \stream_get_contents($message, 4))[1]; $result[$x]['data'] = \stream_get_contents($message, $length); } break; // packetLanEndpoint#A address:int port:int = Packet; case \danog\MadelineProto\VoIP::PKT_LAN_ENDPOINT: $result['address'] = \unpack('V', \stream_get_contents($payload, 4))[1]; $result['port'] = \unpack('V', \stream_get_contents($payload, 4))[1]; break; // packetNetworkChanged#B flags:# data_saving_enabled:flags.0?true = Packet; case \danog\MadelineProto\VoIP::PKT_NETWORK_CHANGED: $result['data_saving_enabled'] = (bool) (\unpack('V', \stream_get_contents($payload, 4))[1] & 1); break; // packetSwitchPreferredRelay#C relay_id:long = Packet; case \danog\MadelineProto\VoIP::PKT_SWITCH_PREF_RELAY: $result['relay_id'] = Tools::unpackSignedLong(\stream_get_contents($payload, 8)); break; /*case \danog\MadelineProto\VoIP::PKT_SWITCH_TO_P2P: break; case \danog\MadelineProto\VoIP::PKT_NOP: break;*/ } return $result; } } <?php namespace danog\MadelineProto\VoIP; use Amp\Promise; use Amp\Socket\EncryptableSocket; use Amp\Success; use danog\MadelineProto\MTProto\PermAuthKey; use danog\MadelineProto\MTProtoTools\Crypt; use danog\MadelineProto\VoIP; use function Amp\Socket\connect; class Endpoint { /** * IP address. */ private string $ip; /** * Port. */ private int $port; /** * Peer tag. */ private string $peerTag; /** * Whether we're a reflector. */ private bool $reflector; /** * Call instance. */ private VoIP $instance; /** * The socket. */ private ?EncryptableSocket $socket = null; /** * Whether we're the creator. */ private bool $creator; /** * The auth key. */ private PermAuthKey $authKey; /** * Create endpoint. * * @param integer $port */ public function __construct(string $ip, int $port, string $peerTag, bool $reflector, VoIP $instance) { $this->ip = $ip; $this->port = $port; $this->peerTag = $peerTag; $this->reflector = $reflector; $this->instance = $instance; $this->creator = $instance->isCreator(); $this->authKey = $instance->getAuthKey(); } /** * Connect to endpoint. * */ public function connect(): \Generator { $this->socket = yield connect("udp://{$this->ip}:{$this->port}"); } /** * Disconnect from endpoint. * */ public function disconnect(): Promise { if ($this->socket !== null) { $this->socket->close(); $this->socket = null; } return new Success(); } /** * Read packet. * */ public function read(): \Generator { do { $packet = yield $this->socket->read(); if ($packet === null) { return null; } $payload = \fopen('php://memory', 'rw+b'); \fwrite($payload, $packet); \fseek($payload, 0); $hasPeerTag = false; if ($this->instance->getPeerVersion() < 9 || $this->reflector) { $hasPeerTag = true; if (\stream_get_contents($payload, 16) !== $this->peerTag) { \danog\MadelineProto\Logger::log("Received packet has wrong peer tag", \danog\MadelineProto\Logger::ERROR); continue; } } if (\stream_get_contents($payload, 12) === "\0\0\0\0\0\0\0\0\0\0\0\0") { $payload = \stream_get_contents($payload); } else { \fseek($payload, $hasPeerTag ? 16 : 0); $message_key = \stream_get_contents($payload, 16); [$aes_key, $aes_iv] = Crypt::aesCalculate($message_key, $this->authKey->getAuthKey(), !$this->creator); $encrypted_data = \stream_get_contents($payload); $packet = Crypt::igeDecrypt($encrypted_data, $aes_key, $aes_iv); if ($message_key != \substr(\hash('sha256', \substr($this->authKey->getAuthKey(), 88 + ($this->creator ? 8 : 0), 32).$packet, true), 8, 16)) { \danog\MadelineProto\Logger::log("msg_key mismatch!", \danog\MadelineProto\Logger::ERROR); return false; } $innerLen = \unpack('v', \substr($packet, 0, 2))[1]; if ($innerLen > \strlen($packet)) { \danog\MadelineProto\Logger::log("Received packet has wrong inner length!", \danog\MadelineProto\Logger::ERROR); return false; } $packet = \substr($packet, 2); } $stream = \fopen('php://memory', 'rw+b'); \fwrite($stream, $packet); \fseek($stream, 0); return $stream; } while (true); } /** * Write data. * */ public function write(string $payload): Promise { if ($this->socket === null) { return new Success(0); } $plaintext = \pack('v', \strlen($payload)).$payload; $padding = 16 - (\strlen($plaintext) % 16); if ($padding < 16) { $padding += 16; } $plaintext .= \danog\MadelineProto\Tools::random($padding); $message_key = \substr(\hash('sha256', \substr($this->authKey->getAuthKey(), 88 + ($this->creator ? 0 : 8), 32).$plaintext, true), 8, 16); list($aes_key, $aes_iv) = Crypt::aesCalculate($message_key, $this->authKey->getAuthKey(), $this->creator); $payload = $message_key.Crypt::igeEncrypt($plaintext, $aes_key, $aes_iv); if ($this->instance->getPeerVersion() < 9 || $this->reflector) { $payload = $this->peerTag.$payload; } return $this->socket->write($payload); } /** * Get peer tag. * */ public function getPeerTag(): string { return $this->peerTag; } } <?php /** * PTSException module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; /** * Internal error indicating a problem with Telegram's servers. */ class PTSException extends \Exception { use TL\PrettyException; public function __toString() { return static::class.($this->message !== '' ? ': ' : '').$this->message.PHP_EOL.'TL Trace:'.PHP_EOL.PHP_EOL.$this->getTLTrace().PHP_EOL; } public function __construct($message, $file = '') { parent::__construct($message); $this->prettifyTL($file); } } <?php /** * Lang module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; class Lang { public static $lang = [ 'it' => [ 'phpseclib_fork' => 'Per favore installa questo fork di phpseclib: https://github.com/danog/phpseclib', 'nearest_dc' => 'Siamo in %s, il DC più vicino è %d.', 'serialization_ofd' => 'La serializzazione non è aggiornata, reistanziamento dell\'oggetto in corso!', 'getupdates_deserialization' => 'Ottenimento aggiornamenti dopo deserializzazione...', 'api_not_set' => 'Devi specificare una chiave ed un ID API, ottienili su https://my.telegram.org', 'session_corrupted' => 'La sessione si è corrotta!', 'gen_perm_auth_key' => 'Generando chiave di autorizzazione permanente per il DC %s...', 'gen_temp_auth_key' => 'Generando chiave di autorizzazione temporanea per il DC %s...', 'write_client_info' => 'Scrittura info sul client (eseguendo nel contempo il metodo %s)...', 'config_updated' => 'La configurazione è stata aggiornata!', 'length_not_4' => 'The specified base256 32-bit integer must be exactly 4 bytes long.', 'length_not_8' => 'The specified base256 64-bit integer must be exactly 8 bytes long.', 'value_bigger_than_2147483647' => 'Il valore fornito (%s) è maggiore di 2147483647', 'value_smaller_than_2147483648' => 'Il valore fornito (%s) è minore di -2147483648', 'value_bigger_than_9223372036854775807' => 'Il valore fornito (%s) è maggiore di 9223372036854775807', 'value_smaller_than_9223372036854775808' => 'Il valore fornito (%s) è minore di -9223372036854775808', 'value_bigger_than_4294967296' => 'Il valore fornito (%s) è maggiore di 4294967296', 'value_smaller_than_0' => 'Il valore fornito (%s) è minore di 0', 'encode_double_error' => 'Non sono riuscito a codificare il numero a virgola mobile fornito', 'file_not_exist' => 'Il file specificato non esiste', 'deserialization_error' => 'C\'è stato un errore durante la deserializzazione', 'rpc_tg_error' => 'Telegram ha ritornato un errore RPC: %s (%s), causato da %s:%s%sTL trace:', 'v_error' => '506572206661766f726520616767696f726e612071756573746120696e7374616c6c617a696f6e65206469204d6164656c696e6550726f746f20636f6e206769742070756c6c206520636f6d706f73657220757064617465', 'v_tgerror' => '506572206661766f726520616767696f726e61207068702d6c69627467766f6970', 'protocol_invalid' => 'È stato fornito un protocollo non valido', 'script_not_exist' => 'Lo script fornito non esiste', 'madelineproto_ready' => 'MadelineProto è pronto!', 'logout_ok' => 'Il logout è stato eseguito correttamente!', 'already_loggedIn' => 'Questa istanza di MadelineProto è già loggata, prima faccio il logout...', 'login_ok' => 'Il login è stato eseguito correttamente!', 'login_user' => 'Sto eseguendo il login come utente normale...', 'login_bot' => 'Sto eseguendo il login come bot...', 'login_code_sending' => 'Sto inviando il codice...', 'login_code_sent' => 'Il codice è stato inviato correttamente! Una volta ricevuto il codice dovrai usare la funzione completePhoneLogin.', 'login_code_uncalled' => 'Non sto aspettando il codice! Usa la funzione phoneLogin.', 'login_2fa_enabled' => 'L\'autenticazione a due fattori è abilitata, dovrai chiamare il metodo complete2falogin...', 'login_need_signup' => 'Questo numero non è registrato su telegram, dovrai chiamare la funzione completeSignup...', 'login_auth_key' => 'Sto facendo il login con la chiave di autorizzazione...', 'not_loggedIn' => 'Non ho ancora fatto il login!', 'signup_uncalled' => 'Chiama prima le funzioni phoneLogin e completePhoneLogin.', 'signing_up' => 'Mi sto registrando su telegram come utente normale...', 'signup_ok' => 'Mi sono registrato su Telegram!', '2fa_uncalled' => 'Non sto aspettando la password, chiama prima le funzioni phoneLogin e completePhoneLogin!', 'libtgvoip_required' => 'È necessario installare l\'estensione php-libtgvoip per accettare e gestire chiamate vocali, vistate https://docs.madelineproto.xyz per più info.', 'peer_not_in_db' => 'Questo utente/gruppo/canale non è presente nel database interno MadelineProto', 'generating_a' => 'Sto generando a...', 'generating_g_a' => 'Sto generando g_a...', 'call_error_1' => 'Impossibile trovare ed accettare la chiamata %s', 'accepting_call' => 'Sto accettando una chiamata da %s...', 'generating_b' => 'Sto generando b...', 'call_already_accepted' => 'La chiamata %s è già stata accettata.', 'call_already_declined' => 'La chiamata %s è già stata annullata.', 'call_error_2' => 'Impossibile trovare e confermare la chiamata %s', 'call_confirming' => 'Sto confermando una chiamata da %s', 'call_error_3' => 'Impossibile trovare e completare la chiamata %s', 'call_completing' => 'Sto completando una chiamata da %s...', 'invalid_g_a' => 'g_a non valido!', 'fingerprint_invalid' => 'fingerprint della chiave non valido!', 'call_discarding' => 'Sto rifiutando la chiamata %s...', 'call_set_rating' => 'Sto inviando la recensione della chiamata %s...', 'call_debug_saving' => 'Sto inviando i dati di debug della chiamata %s...', 'TL_loading' => 'Sto caricando gli schemi TL...', 'file_parsing' => 'Leggendo %s...', 'crc32_mismatch' => 'CRC32 non valido (%s diverso da %s) per %s', 'src_file_invalid' => 'È stato fornito un file sorgente non valido: ', 'translating_obj' => 'Traducendo gli oggetti...', 'translating_methods' => 'Traducendo i metodi...', 'bool_error' => 'Non sono riuscito ad estrarre un booleano', 'not_numeric' => 'Il valore fornito non è numerico', 'long_not_16' => 'Il valore fornito non è lungo 16 byte', 'long_not_32' => 'Il valore fornito non è lungo 32 byte', 'long_not_64' => 'Il valore fornito non è lungo 64 byte', 'array_invalid' => 'Il valore fornito non è un array', 'predicate_not_set' => 'Il predicato (valore sotto chiave _, esempio [\'_\' => \'inputPeer\']) non è impostato!', 'type_extract_error' => 'Impossibile estrarre il tipo "%s"', 'method_not_found' => 'Impossibile trovare il seguente metodo: ', 'params_missing' => 'Non hai fornito un parametro obbligatorio, rileggi la documentazione API', 'sec_peer_not_in_db' => 'La chat segreta non è presente nel database interno MadelineProto', 'stream_handle_invalid' => 'Il valore fornito non è uno stream', 'length_too_big' => 'Il valore fornito è troppo lungo', 'type_extract_error_id' => 'Non sono riuscito ad estrarre il tipo %s con ID %s', 'constructor_not_found' => 'Costruttore non trovato per tipo: ', 'rand_bytes_too_small' => 'random_bytes è troppo corto!', 'botapi_conversion_error' => 'Non sono risucito a convertire %s in un oggetto bot API', 'non_text_conversion' => 'Non posso ancora convertire messaggi media', 'last_byte_invalid' => 'L\'ultimo byte non è valido', 'file_type_invalid' => 'È stato fornito un tipo file errato', 'secret_chat_skipping' => 'Non ho la chat segreta %s nel database, ignorando messaggio', 'fingerprint_mismatch' => 'Fingerprint della chiave non valido', 'msg_data_length_too_big' => 'message_data_length è troppo grande', 'length_not_divisible_16' => 'La lunghezza dei dati decifrati non è divisibile per 16', 'done' => 'Fatto!', 'cdn_reupload' => 'Il file non è disponibile sul nostro CDN, richiedo la copia!', 'stored_on_cdn' => 'Il file è scaricabile tramite CDN!', 'apiAppInstructionsAuto0' => 'Inserisci il nome dell\'app, può essere qualsiasi cosa: ', 'apiAppInstructionsAuto1' => 'Inserisci il nome ridotto dell\'app, caratteri alfanumerici: ', 'apiAppInstructionsAuto2' => 'Inserisci il sito internet dell\'app, oppure t.me/username: ', 'apiAppInstructionsAuto3' => 'Inserisci la piattaforma dell\'app: ', 'apiAppInstructionsAuto4' => 'Descrivi la tua app: ', 'apiAppInstructionsManual0' => 'titolo dell\'app, può essere qualsiasi cosa', 'apiAppInstructionsManual1' => 'il nome ridotto dell\'app, caratteri alfanumerici: ', 'apiAppInstructionsManual2' => 'L\'indirizzo del tuo sito, oppure t.me/username', 'apiAppInstructionsManual3' => 'Qualsiasi', 'apiAppInstructionsManual4' => 'Descrivi la tua app', 'apiAutoPrompt0' => 'Inserisci un numero di telefono che è già registrato su Telegram: ', 'apiAutoPrompt1' => 'Inserisci il codice di verifica che hai ricevuto su Telegram: ', 'apiChooseManualAutoTip' => 'Nota che puoi anche fornire i parametri API direttamente nelle impostazioni: %s', 'apiChoosePrompt' => 'La tua scelta (m/a): ', 'apiError' => 'ERRORE: %s. Prova ancora.', 'apiManualInstructions0' => 'Effettua il login su https://my.telegram.org', 'apiManualInstructions1' => 'Vai su API development tools', 'apiManualInstructions2' => 'Clicca su create application', 'apiManualPrompt0' => 'Inserisci il tuo API ID: ', 'apiManualPrompt1' => 'Inserisci il tuo API hash: ', 'apiParamsError' => 'Non hai fornito tutti i parametri richiesti!', 'loginBot' => 'Inserisci il tuo bot token: ', 'loginChoosePrompt' => 'Vuoi effettuare il login come utente o come bot (u/b)? ', 'loginNoCode' => 'Non hai fornito un codice di verifica!', 'loginNoName' => 'Non hai fornito un nome!', 'loginNoPass' => 'Non hai fornito la password!', 'loginUser' => 'Inserisci il tuo numero di telefono: ', 'loginUserPass' => 'Inserisci la tua password (suggerimento %s): ', 'loginUserPassHint' => 'Suggerimento: %s', 'loginUserPassWeb' => 'Inserisci la tua password: ', 'loginUserCode' => 'Inserisci il codice di verifica: ', 'signupFirstName' => 'Inserisci il tuo nome: ', 'signupFirstNameWeb' => 'Nome', 'signupLastName' => 'Inserisci il tuo cognome: ', 'signupLastNameWeb' => 'Cognome', 'signupWeb' => 'Registrazione', 'go' => 'Vai', 'loginChoosePromptWeb' => 'Vuoi effettuare il login come utente o come bot?', 'loginOptionBot' => 'Bot', 'loginOptionUser' => 'Utente', 'loginBotTokenWeb' => 'Token del bot', 'loginUserPhoneCodeWeb' => 'Codice di verifica', 'loginUserPhoneWeb' => 'Numero di telefono', 'apiAutoWeb' => 'Inserisci un numero di telefono <b>già registrato su Telegram</b> per ottenere l'API ID', 'apiChooseManualAuto' => 'You did not define a valid API ID/API hash. Do you want to define it now manually, or automatically? (m/a)', 'apiManualWeb' => 'Inserisci il tuo API ID e API hash', 'apiAppInstructionsAutoTypeOther' => 'Altro (specificare nella descrizione)', 'apiAppWeb' => 'Inserire informazioni API', 'apiChooseAutomaticallyWeb' => 'Automaticamente', 'apiChooseManualAutoTipWeb' => 'Nota che puoi anche fornire i parametri API direttamente nelle <a target="_blank" href="%s">impostazioni</a>.', 'apiChooseManualAutoWeb' => 'Vuoi configurare il tuo API ID/hash manualmente o automaticamente?', 'apiChooseManuallyWeb' => 'Manualmente', ], 'en' => [ 'go' => 'Go', 'apiChooseManualAuto' => 'Do you want to enter the API id and the API hash manually or automatically? (m/a)', 'apiChooseManualAutoWeb' => 'Do you want to enter the API id and the API hash manually or automatically?', 'apiChooseManualAutoTip' => 'Note that you can also provide them directly in the code using the settings: %s', 'apiChooseManualAutoTipWeb' => 'Note that you can also provide them directly in the code using the <a target="_blank" href="%s">settings</a>.', 'apiChoosePrompt' => 'Your choice (m/a): ', 'apiChooseAutomaticallyWeb' => 'Automatically', 'apiChooseManuallyWeb' => 'Manually', 'apiManualInstructions0' => 'Login to https://my.telegram.org', 'apiManualInstructions1' => 'Go to API development tools', 'apiManualInstructions2' => 'Click on create application', 'apiAppInstructionsManual0' => 'your app\'s name, can be anything', 'apiAppInstructionsManual1' => 'your app\'s short name, alphanumeric, 5-32 characters', 'apiAppInstructionsManual2' => 'your app/website\'s URL, or t.me/yourusername', 'apiAppInstructionsManual3' => 'anything', 'apiAppInstructionsManual4' => 'Describe your app here', 'apiManualWeb' => 'Enter your API ID and API hash', 'apiManualPrompt0' => 'Enter your API ID: ', 'apiManualPrompt1' => 'Enter your API hash: ', 'apiAutoWeb' => 'Enter a phone number that is <b>already registered</b> on telegram to get the API ID', 'apiAutoPrompt0' => 'Enter a phone number that is already registered on Telegram: ', 'apiAutoPrompt1' => 'Enter the verification code you received in Telegram: ', 'apiAppWeb' => 'Enter API information', 'apiAppInstructionsAuto0' => 'Enter the app\'s name, can be anything: ', 'apiAppInstructionsAuto1' => 'Enter the app\'s short name, alphanumeric, 5-32 characters: ', 'apiAppInstructionsAuto2' => 'Enter the app/website\'s URL, or t.me/yourusername: ', 'apiAppInstructionsAuto3' => 'Enter the app platform: ', 'apiAppInstructionsAuto4' => 'Describe your app: ', 'apiAppInstructionsAutoTypeOther' => 'Other (specify in description)', 'apiParamsError' => 'You didn\'t provide all of the required parameters!', 'apiError' => 'ERROR: %s. Try again.', 'loginChoosePrompt' => 'Do you want to login as user or bot (u/b)? ', 'loginChoosePromptWeb' => 'Do you want to login as user or bot?', 'loginOptionBot' => 'Bot', 'loginOptionUser' => 'User', 'loginBot' => 'Enter your bot token: ', 'loginUser' => 'Enter your phone number: ', 'loginUserCode' => 'Enter the code: ', 'loginUserPass' => 'Enter your password (hint %s): ', 'loginUserPassWeb' => 'Enter your password: ', 'loginUserPassHint' => 'Hint: %s', 'signupFirstName' => 'Enter your first name: ', 'signupLastName' => 'Enter your last name (can be empty): ', 'signupWeb' => 'Sign up please', 'signupFirstNameWeb' => 'First name', 'signupLastNameWeb' => 'Last name', 'loginNoCode' => 'You didn\'t provide a phone code!', 'loginNoPass' => 'You didn\'t provide the password!', 'loginNoName' => 'You didn\'t provide the first name!', 'loginBotTokenWeb' => 'Bot token', 'loginUserPhoneWeb' => 'Phone number', 'loginUserPhoneCodeWeb' => 'Code', 'done' => 'Done!', 'cdn_reupload' => 'File is not stored on CDN, requesting reupload!', 'stored_on_cdn' => 'File is stored on CDN!', 'phpseclib_fork' => 'Please install this fork of phpseclib: https://github.com/danog/phpseclib', 'nearest_dc' => 'We\'re in %s, nearest DC is %d.', 'serialization_ofd' => 'Serialization is out of date, reconstructing object!', 'getupdates_deserialization' => 'Getting updates after deserialization...', 'api_not_set' => 'You must provide an api key and an api id, get your own @ my.telegram.org', 'session_corrupted' => 'The session is corrupted!', 'gen_perm_auth_key' => 'Generating permanent authorization key for DC %s...', 'gen_temp_auth_key' => 'Generating temporary authorization key for DC %s...', 'write_client_info' => 'Writing client info (also executing %s)...', 'config_updated' => 'Updated config!', 'length_not_4' => 'The specified base256 32-bit integer must be exactly 4 bytes long.', 'length_not_8' => 'The specified base256 64-bit integer must be exactly 8 bytes long.', 'value_bigger_than_2147483647' => 'Provided value %s is bigger than 2147483647', 'value_smaller_than_2147483648' => 'Provided value %s is smaller than -2147483648', 'value_bigger_than_9223372036854775807' => 'Provided value %s is bigger than 9223372036854775807', 'value_smaller_than_9223372036854775808' => 'Provided value %s is smaller than -9223372036854775808', 'value_bigger_than_4294967296' => 'Provided value %s is bigger than 4294967296', 'value_smaller_than_0' => 'Provided value %s is smaller than 0', 'encode_double_error' => 'Could not properly encode double', 'file_not_exist' => 'File does not exist', 'deserialization_error' => 'An error occurred on deserialization', 'rpc_tg_error' => 'Telegram returned an RPC error: %s (%s), caused by %s:%s%sTL trace:', 'v_error' => '506c656173652075706461746520746f20746865206c61746573742076657273696f6e206f66204d6164656c696e6550726f746f2e', 'v_tgerror' => '506c6561736520757064617465207068702d6c69627467766f6970', 'protocol_invalid' => 'Connection: invalid protocol specified.', 'script_not_exist' => 'Provided script does not exist', 'madelineproto_ready' => 'MadelineProto is ready!', 'logout_ok' => 'Logged out successfully!', 'already_loggedIn' => 'This instance of MadelineProto is already logged in. Logging out first...', 'login_ok' => 'Logged in successfully!', 'login_user' => 'Logging in as a normal user...', 'login_bot' => 'Logging in as a bot...', 'login_code_sending' => 'Sending code...', 'login_code_sent' => 'Code sent successfully! Once you receive the code you should use the completePhoneLogin function.', 'login_code_uncalled' => 'I\'m not waiting for the code! Please call the phoneLogin method first', 'login_2fa_enabled' => '2FA enabled, you will have to call the complete2falogin function...', 'login_need_signup' => 'An account has not been created for this number, you will have to call the completeSignup function...', 'login_auth_key' => 'Logging in using auth key...', 'not_loggedIn' => 'I\'m not logged in!', 'signup_uncalled' => 'I\'m not waiting to signup! Please call the phoneLogin and the completePhoneLogin methods first!', 'signing_up' => 'Signing up as a normal user...', 'signup_ok' => 'Signed up in successfully!', '2fa_uncalled' => 'I\'m not waiting for the password! Please call the phoneLogin and the completePhoneLogin methods first!', 'libtgvoip_required' => 'The php-libtgvoip extension is required to accept and manage calls. See daniil.it/MadelineProto for more info.', 'peer_not_in_db' => 'This peer is not present in the internal peer database', 'generating_a' => 'Generating a...', 'generating_g_a' => 'Generating g_a...', 'call_error_1' => 'Could not find and accept call %s', 'accepting_call' => 'Accepting call from %s...', 'generating_b' => 'Generating b...', 'call_already_accepted' => 'Call %s already accepted', 'call_already_declined' => 'Call %s already declined', 'call_error_2' => 'Could not find and confirm call %s', 'call_confirming' => 'Confirming call from %s...', 'call_error_3' => 'Could not find and complete call %s', 'call_completing' => 'Completing call from %s...', 'invalid_g_a' => 'Invalid g_a!', 'fingerprint_invalid' => 'Invalid key fingerprint!', 'call_discarding' => 'Discarding call %s...', 'call_set_rating' => 'Setting rating for call %s...', 'call_debug_saving' => 'Saving debug data for call %s...', 'TL_loading' => 'Loading TL schemes...', 'file_parsing' => 'Parsing %s...', 'crc32_mismatch' => 'CRC32 mismatch (%s, %s) for %s', 'src_file_invalid' => 'Invalid source file was provided: ', 'translating_obj' => 'Translating objects...', 'translating_methods' => 'Translating methods...', 'bool_error' => 'Could not extract boolean', 'not_numeric' => 'Given value isn\'t numeric', 'long_not_16' => 'Given value is not 16 bytes long', 'long_not_32' => 'Given value is not 32 bytes long', 'long_not_64' => 'Given value is not 64 bytes long', 'array_invalid' => 'You didn\'t provide a valid array', 'predicate_not_set' => 'Predicate (value under _) was not set!', 'type_extract_error' => 'Could not extract type "%s", you should update MadelineProto!', 'method_not_found' => 'Could not find method: ', 'params_missing' => 'Missing required parameter', 'sec_peer_not_in_db' => 'This secret peer is not present in the internal peer database', 'stream_handle_invalid' => 'An invalid stream handle was provided.', 'length_too_big' => 'Length is too big', 'type_extract_error_id' => 'Could not extract type: %s with id %s, you should update MadelineProto!', 'constructor_not_found' => 'Constructor not found for type: ', 'rand_bytes_too_small' => 'Random_bytes is too small!', 'botapi_conversion_error' => 'Can\'t convert %s to a bot API object', 'non_text_conversion' => 'Can\'t convert non text messages yet!', 'last_byte_invalid' => 'Invalid last byte', 'file_type_invalid' => 'Invalid file type detected (%s)', 'secret_chat_skipping' => 'I do not have the secret chat %s in the database, skipping message...', 'fingerprint_mismatch' => 'Key fingerprint mismatch', 'msg_data_length_too_big' => 'Message_data_length is too big', 'length_not_divisible_16' => 'Length of decrypted data is not divisible by 16', ], ]; // THIS WILL BE OVERWRITTEN BY $lang["en"] public static $current_lang = [ 'go' => 'Go', 'apiChooseManualAuto' => 'Do you want to enter the API id and the API hash manually or automatically? (m/a)', 'apiChooseManualAutoWeb' => 'Do you want to enter the API id and the API hash manually or automatically?', 'apiChooseManualAutoTip' => 'Note that you can also provide them directly in the code using the settings: %s', 'apiChooseManualAutoTipWeb' => 'Note that you can also provide them directly in the code using the <a href="%s">settings</a>.', 'apiChoosePrompt' => 'Your choice (m/a): ', 'apiChooseAutomaticallyWeb' => 'Automatically', 'apiChooseManuallyWeb' => 'Manually', 'apiManualInstructions0' => 'Login to https://my.telegram.org', 'apiManualInstructions1' => 'Go to API development tools', 'apiManualInstructions2' => 'Click on create application', 'apiAppInstructionsManual0' => 'your app\'s name, can be anything', 'apiAppInstructionsManual1' => 'your app\'s short name, alphanumeric, 5-32 characters', 'apiAppInstructionsManual2' => 'your app/website\'s URL, or t.me/yourusername', 'apiAppInstructionsManual3' => 'anything', 'apiAppInstructionsManual4' => 'Describe your app here', 'apiManualWeb' => 'Enter your API ID and API hash', 'apiManualPrompt0' => 'Enter your API ID: ', 'apiManualPrompt1' => 'Enter your API hash: ', 'apiAutoWeb' => 'Enter a phone number that is <b>already registered</b> on telegram to get the API ID', 'apiAutoPrompt0' => 'Enter a phone number that is already registered on Telegram: ', 'apiAutoPrompt1' => 'Enter the verification code you received in Telegram: ', 'apiAppWeb' => 'Enter API information', 'apiAppInstructionsAuto0' => 'Enter the app\'s name, can be anything: ', 'apiAppInstructionsAuto1' => 'Enter the app\'s short name, alphanumeric, 5-32 characters: ', 'apiAppInstructionsAuto2' => 'Enter the app/website\'s URL, or t.me/yourusername: ', 'apiAppInstructionsAuto3' => 'Enter the app platform: ', 'apiAppInstructionsAuto4' => 'Describe your app: ', 'apiAppInstructionsAutoTypeOther' => 'Other (specify in description)', 'apiParamsError' => 'You didn\'t provide all of the required parameters!', 'apiError' => 'ERROR: %s. Try again.', 'loginChoosePrompt' => 'Do you want to login as user or bot (u/b)? ', 'loginChoosePromptWeb' => 'Do you want to login as user or bot?', 'loginOptionBot' => 'Bot', 'loginOptionUser' => 'User', 'loginBot' => 'Enter your bot token: ', 'loginUser' => 'Enter your phone number: ', 'loginUserCode' => 'Enter the code: ', 'loginUserPass' => 'Enter your password (hint %s): ', 'loginUserPassWeb' => 'Enter your password: ', 'loginUserPassHint' => 'Hint: %s', 'signupFirstName' => 'Enter your first name: ', 'signupLastName' => 'Enter your last name (can be empty): ', 'signupWeb' => 'Sign up please', 'signupFirstNameWeb' => 'First name', 'signupLastNameWeb' => 'Last name', 'loginNoCode' => 'You didn\'t provide a phone code!', 'loginNoPass' => 'You didn\'t provide the password!', 'loginNoName' => 'You didn\'t provide the first name!', 'loginBotTokenWeb' => 'Bot token', 'loginUserPhoneWeb' => 'Phone number', 'loginUserPhoneCodeWeb' => 'Code', 'done' => 'Done!', 'cdn_reupload' => 'File is not stored on CDN, requesting reupload!', 'stored_on_cdn' => 'File is stored on CDN!', 'phpseclib_fork' => 'Please install this fork of phpseclib: https://github.com/danog/phpseclib', 'nearest_dc' => 'We\'re in %s, nearest DC is %d.', 'serialization_ofd' => 'Serialization is out of date, reconstructing object!', 'getupdates_deserialization' => 'Getting updates after deserialization...', 'api_not_set' => 'You must provide an api key and an api id, get your own @ my.telegram.org', 'session_corrupted' => 'The session is corrupted!', 'gen_perm_auth_key' => 'Generating permanent authorization key for DC %s...', 'gen_temp_auth_key' => 'Generating temporary authorization key for DC %s...', 'write_client_info' => 'Writing client info (also executing %s)...', 'config_updated' => 'Updated config!', 'length_not_4' => 'The specified base256 32-bit integer must be exactly 4 bytes long.', 'length_not_8' => 'The specified base256 64-bit integer must be exactly 8 bytes long.', 'value_bigger_than_2147483647' => 'Provided value %s is bigger than 2147483647', 'value_smaller_than_2147483648' => 'Provided value %s is smaller than -2147483648', 'value_bigger_than_9223372036854775807' => 'Provided value %s is bigger than 9223372036854775807', 'value_smaller_than_9223372036854775808' => 'Provided value %s is smaller than -9223372036854775808', 'value_bigger_than_4294967296' => 'Provided value %s is bigger than 4294967296', 'value_smaller_than_0' => 'Provided value %s is smaller than 0', 'encode_double_error' => 'Could not properly encode double', 'file_not_exist' => 'File does not exist', 'deserialization_error' => 'An error occurred on deserialization', 'rpc_tg_error' => 'Telegram returned an RPC error: %s (%s), caused by %s:%s%sTL trace:', 'v_error' => '506c656173652075706461746520746f20746865206c61746573742076657273696f6e206f66204d6164656c696e6550726f746f2e', 'v_tgerror' => '506c6561736520757064617465207068702d6c69627467766f6970', 'protocol_invalid' => 'Connection: invalid protocol specified.', 'script_not_exist' => 'Provided script does not exist', 'madelineproto_ready' => 'MadelineProto is ready!', 'logout_ok' => 'Logged out successfully!', 'already_loggedIn' => 'This instance of MadelineProto is already logged in. Logging out first...', 'login_ok' => 'Logged in successfully!', 'login_user' => 'Logging in as a normal user...', 'login_bot' => 'Logging in as a bot...', 'login_code_sending' => 'Sending code...', 'login_code_sent' => 'Code sent successfully! Once you receive the code you should use the completePhoneLogin function.', 'login_code_uncalled' => 'I\'m not waiting for the code! Please call the phoneLogin method first', 'login_2fa_enabled' => '2FA enabled, you will have to call the complete2falogin function...', 'login_need_signup' => 'An account has not been created for this number, you will have to call the completeSignup function...', 'login_auth_key' => 'Logging in using auth key...', 'not_loggedIn' => 'I\'m not logged in!', 'signup_uncalled' => 'I\'m not waiting to signup! Please call the phoneLogin and the completePhoneLogin methods first!', 'signing_up' => 'Signing up as a normal user...', 'signup_ok' => 'Signed up in successfully!', '2fa_uncalled' => 'I\'m not waiting for the password! Please call the phoneLogin and the completePhoneLogin methods first!', 'libtgvoip_required' => 'The php-libtgvoip extension is required to accept and manage calls. See daniil.it/MadelineProto for more info.', 'peer_not_in_db' => 'This peer is not present in the internal peer database', 'generating_a' => 'Generating a...', 'generating_g_a' => 'Generating g_a...', 'call_error_1' => 'Could not find and accept call %s', 'accepting_call' => 'Accepting call from %s...', 'generating_b' => 'Generating b...', 'call_already_accepted' => 'Call %s already accepted', 'call_already_declined' => 'Call %s already declined', 'call_error_2' => 'Could not find and confirm call %s', 'call_confirming' => 'Confirming call from %s...', 'call_error_3' => 'Could not find and complete call %s', 'call_completing' => 'Completing call from %s...', 'invalid_g_a' => 'Invalid g_a!', 'fingerprint_invalid' => 'Invalid key fingerprint!', 'call_discarding' => 'Discarding call %s...', 'call_set_rating' => 'Setting rating for call %s...', 'call_debug_saving' => 'Saving debug data for call %s...', 'TL_loading' => 'Loading TL schemes...', 'file_parsing' => 'Parsing %s...', 'crc32_mismatch' => 'CRC32 mismatch (%s, %s) for %s', 'src_file_invalid' => 'Invalid source file was provided: ', 'translating_obj' => 'Translating objects...', 'translating_methods' => 'Translating methods...', 'bool_error' => 'Could not extract boolean', 'not_numeric' => 'Given value isn\'t numeric', 'long_not_16' => 'Given value is not 16 bytes long', 'long_not_32' => 'Given value is not 32 bytes long', 'long_not_64' => 'Given value is not 64 bytes long', 'array_invalid' => 'You didn\'t provide a valid array', 'predicate_not_set' => 'Predicate (value under _) was not set!', 'type_extract_error' => 'Could not extract type "%s", you should update MadelineProto!', 'method_not_found' => 'Could not find method: ', 'params_missing' => 'Missing required parameter', 'sec_peer_not_in_db' => 'This secret peer is not present in the internal peer database', 'stream_handle_invalid' => 'An invalid stream handle was provided.', 'length_too_big' => 'Length is too big', 'type_extract_error_id' => 'Could not extract type: %s with id %s, you should update MadelineProto!', 'constructor_not_found' => 'Constructor not found for type: ', 'rand_bytes_too_small' => 'Random_bytes is too small!', 'botapi_conversion_error' => 'Can\'t convert %s to a bot API object', 'non_text_conversion' => 'Can\'t convert non text messages yet!', 'last_byte_invalid' => 'Invalid last byte', 'file_type_invalid' => 'Invalid file type detected (%s)', 'secret_chat_skipping' => 'I do not have the secret chat %s in the database, skipping message...', 'fingerprint_mismatch' => 'Key fingerprint mismatch', 'msg_data_length_too_big' => 'Message_data_length is too big', 'length_not_divisible_16' => 'Length of decrypted data is not divisible by 16', ]; } <?php /** * TOS module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; /** * Manages terms of service. */ trait TOS { /** * Check for terms of service update. * * Will throw a \danog\MadelineProto\Exception if a new TOS is available. * */ public function checkTos(): \Generator { if ($this->authorized === self::LOGGED_IN && !$this->authorization['user']['bot']) { if ($this->tos['expires'] < \time()) { $this->logger->logger('Fetching TOS...'); $this->tos = yield from $this->methodCallAsyncRead('help.getTermsOfServiceUpdate', []); $this->tos['accepted'] = $this->tos['_'] === 'help.termsOfServiceUpdateEmpty'; } if (!$this->tos['accepted']) { $this->logger->logger('Telegram has updated their Terms Of Service', \danog\MadelineProto\Logger::ERROR); $this->logger->logger('Accept the TOS before proceeding by calling $MadelineProto->acceptTos().', \danog\MadelineProto\Logger::ERROR); $this->logger->logger('You can also decline the TOS by calling $MadelineProto->declineTos().', \danog\MadelineProto\Logger::ERROR); $this->logger->logger('By declining the TOS, the currently logged in account will be PERMANENTLY DELETED.', \danog\MadelineProto\Logger::FATAL_ERROR); $this->logger->logger('Read the following TOS very carefully: ', \danog\MadelineProto\Logger::ERROR); $this->logger->logger($this->tos); throw new \danog\MadelineProto\Exception('TOS action required, check the logs', 0, null, 'MadelineProto', 1); } } } /** * Accept terms of service update. * */ public function acceptTos(): \Generator { $this->tos['accepted'] = yield from $this->methodCallAsyncRead('help.acceptTermsOfService', ['id' => $this->tos['terms_of_service']['id']]); if ($this->tos['accepted']) { $this->logger->logger('TOS accepted successfully'); } else { throw new \danog\MadelineProto\Exception('An error occurred while accepting the TOS'); } } /** * Decline terms of service update. * * THIS WILL DELETE YOUR ACCOUNT! * */ public function declineTos(): \Generator { yield from $this->methodCallAsyncRead('account.deleteAccount', ['reason' => 'Decline ToS update']); yield from $this->logout(); } } <?php /** * Callback module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; use Amp\Promise; use danog\MadelineProto\Tools; /** * Manages clicking buttons. */ trait Button { /** * Click on button. * * @internal * * * @return Promise|true */ public function clickInternal(bool $donotwait, string $method, array $parameters) { $internal = $donotwait ? 'methodCallAsyncWrite' : 'methodCallAsyncRead'; $result = $this->{$internal}($method, $parameters); if ($donotwait) { Tools::callFork($result); } return $donotwait ? true : $result; } } <?php /** * DialogHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; use danog\MadelineProto\MTProto; use danog\MadelineProto\Settings; /** * Dialog handler. * * @property Settings $settings Settings */ trait DialogHandler { /** * Get dialog peers. * * @param boolean $force Whether to refetch all dialogs ignoring cache * * * @psalm-return \Generator<int, \Amp\Promise<bool>, mixed, list<mixed>> */ public function getDialogs(bool $force = true): \Generator { if ($this->authorization['user']['bot']) { $res = []; /** @uses DbArray::getIterator() */ $iterator = $this->chats->getIterator(); while (yield $iterator->advance()) { [, $chat] = $iterator->getCurrent(); try { $res[] = $this->genAll($chat, null, MTProto::INFO_TYPE_ALL)['Peer']; } catch (\Throwable $e) { continue; } } return $res; } $res = []; foreach (yield from $this->getFullDialogs($force) as $dialog) { $res[] = $dialog['peer']; } return $res; } /** * Get full info of all dialogs. * * @param boolean $force Whether to refetch all dialogs ignoring cache * */ public function getFullDialogs(bool $force = true): \Generator { if ($force || !isset($this->dialog_params['offset_date']) || \is_null($this->dialog_params['offset_date']) || !isset($this->dialog_params['offset_id']) || \is_null($this->dialog_params['offset_id']) || !isset($this->dialog_params['offset_peer']) || \is_null($this->dialog_params['offset_peer']) || !isset($this->dialog_params['count']) || \is_null($this->dialog_params['count'])) { $this->dialog_params = ['limit' => 100, 'offset_date' => 0, 'offset_id' => 0, 'offset_peer' => ['_' => 'inputPeerEmpty'], 'count' => 0, 'hash' => 0]; } if (!isset($this->dialog_params['hash'])) { $this->dialog_params['hash'] = 0; } $res = ['dialogs' => [0], 'count' => 1]; $datacenter = $this->datacenter->curdc; $dialogs = []; $this->logger->logger("Getting dialogs..."); while ($this->dialog_params['count'] < $res['count']) { $res = yield from $this->methodCallAsyncRead('messages.getDialogs', $this->dialog_params, ['datacenter' => $datacenter, 'FloodWaitLimit' => 100]); $last_peer = 0; $last_date = 0; $last_id = 0; $res['messages'] = \array_reverse($res['messages'] ?? []); foreach (\array_reverse($res['dialogs'] ?? []) as $dialog) { $id = $this->getId($dialog['peer']); if (!isset($dialogs[$id])) { $dialogs[$id] = $dialog; } if (!$last_date) { if (!$last_peer) { $last_peer = $id; } if (!$last_id) { $last_id = $dialog['top_message']; } foreach ($res['messages'] as $message) { if ($message['_'] !== 'messageEmpty' && $this->getId($message) === $last_peer && $last_id === $message['id']) { $last_date = $message['date']; break; } } } } if ($last_date) { $this->dialog_params['offset_date'] = $last_date; $this->dialog_params['offset_peer'] = $last_peer; $this->dialog_params['offset_id'] = $last_id; $this->dialog_params['count'] = \count($dialogs); } else { break; } if (!isset($res['count'])) { break; } } return $dialogs; } } <?php /** * Events module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; use danog\MadelineProto\EventHandler; use danog\MadelineProto\Settings; use danog\MadelineProto\Tools; /** * Event handler. * * @property Settings $settings Settings */ trait Events { /** * Event handler class name. * * @var class-string<EventHandler> */ public $event_handler; /** * Event handler instance. * * @var EventHandler|null */ private $event_handler_instance; /** * Event handler method list. * * @var array<string, callable> */ private $eventHandlerMethods = []; /** * Initialize event handler. * * @param class-string<EventHandler> $eventHandler * */ private function initEventHandler(string $eventHandler): void { $this->event_handler = $eventHandler; if (!$this->event_handler_instance instanceof $this->event_handler) { $class_name = $this->event_handler; $this->event_handler_instance = new $class_name($this->wrapper); } $this->event_handler_instance->initInternal($this->wrapper); } /** * Set event handler. * * @param class-string<EventHandler> $eventHandler Event handler * */ public function setEventHandler(string $eventHandler): \Generator { if (!\is_subclass_of($eventHandler, EventHandler::class)) { throw new \danog\MadelineProto\Exception('Wrong event handler was defined'); } $this->initEventHandler($eventHandler); $this->eventHandlerMethods = []; $this->loop_callback = null; foreach (\get_class_methods($this->event_handler) as $method) { if ($method === 'onLoop') { $this->loop_callback = [$this->event_handler_instance, 'onLoop']; } elseif ($method === 'onAny') { foreach ($this->getTL()->getConstructors()->by_id as $constructor) { if ($constructor['type'] === 'Update' && !isset($this->eventHandlerMethods[$constructor['predicate']])) { $this->eventHandlerMethods[$constructor['predicate']] = [$this->event_handler_instance, 'onAny']; } } } else { $method_name = \lcfirst(\substr($method, 2)); if (($constructor = $this->getTL()->getConstructors()->findByPredicate($method_name)) && $constructor['type'] === 'Update') { $this->eventHandlerMethods[$method_name] = [$this->event_handler_instance, $method]; } } } yield from $this->setReportPeers($this->event_handler_instance->getReportPeers()); Tools::callFork($this->event_handler_instance->startInternal()); $this->updateHandler = [$this, 'eventUpdateHandler']; if ($this->inited()) { $this->startUpdateSystem(); } } /** * Unset event handler. * * @param bool $disableUpdateHandling Whether to also disable internal update handling (will cause errors, otherwise will simply use the NOOP handler) * */ public function unsetEventHandler(bool $disableUpdateHandling = false): void { $this->event_handler = null; $this->event_handler_instance = null; $this->eventHandlerMethods = []; $this->setNoop(); } /** * Get event handler. * */ public function getEventHandler(): EventHandler { return $this->event_handler_instance; } /** * Check if an event handler instance is present. * * @return boolean */ public function hasEventHandler(): bool { return isset($this->event_handler_instance); } /** * Event update handler. * * @param array $update Update * * @return void * * @internal Internal event handler */ public function eventUpdateHandler(array $update) { if (isset($this->eventHandlerMethods[$update['_']])) { return $this->eventHandlerMethods[$update['_']]($update); } } } <?php /** * Noop module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; trait Noop { /** * Set NOOP update handler, ignoring all updates. * */ public function setNoop(): void { $this->updateHandler = null; $this->updates = []; $this->startUpdateSystem(); } /** * Noop update handler. * * @internal * */ public static function noop(): void { } } <?php /** * Login module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; use danog\MadelineProto\MTProto; use danog\MadelineProto\MTProto\PermAuthKey; use danog\MadelineProto\MTProtoTools\PasswordCalculator; use danog\MadelineProto\Settings; /** * Manages logging in and out. * * @property Settings $settings Settings */ trait Login { /** * Log out currently logged in user. * */ public function logout(): \Generator { yield from $this->methodCallAsyncRead('auth.logOut', []); yield from $this->resetSession(); $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['logout_ok'], \danog\MadelineProto\Logger::NOTICE); $this->startUpdateSystem(); return true; } /** * Login as bot. * * @param string $token Bot token * */ public function botLogin(string $token): \Generator { if ($this->authorized === MTProto::LOGGED_IN) { return; } $callbacks = [$this, $this->referenceDatabase]; $this->TL->updateCallbacks($callbacks); $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_bot'], \danog\MadelineProto\Logger::NOTICE); $this->authorization = yield from $this->methodCallAsyncRead( 'auth.importBotAuthorization', [ 'bot_auth_token' => $token, 'api_id' => $this->settings->getAppInfo()->getApiId(), 'api_hash' => $this->settings->getAppInfo()->getApiHash(), ] ); $this->authorized = MTProto::LOGGED_IN; $this->authorized_dc = $this->datacenter->curdc; $this->datacenter->getDataCenterConnection($this->datacenter->curdc)->authorized(true); $this->updates = []; $this->updates_key = 0; yield from $this->initAuthorization(); $this->startUpdateSystem(); $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_ok'], \danog\MadelineProto\Logger::NOTICE); return $this->authorization; } /** * Login as user. * * @param string $number Phone number * @param integer $sms_type SMS type * */ public function phoneLogin($number, $sms_type = 5): \Generator { if ($this->authorized === MTProto::LOGGED_IN) { $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['already_loggedIn'], \danog\MadelineProto\Logger::NOTICE); yield from $this->logout(); } $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_code_sending'], \danog\MadelineProto\Logger::NOTICE); $this->authorization = yield from $this->methodCallAsyncRead( 'auth.sendCode', [ 'settings' => ['_' => 'codeSettings'], 'phone_number' => $number, 'sms_type' => $sms_type, 'api_id' => $this->settings->getAppInfo()->getApiId(), 'api_hash' => $this->settings->getAppInfo()->getApiHash(), 'lang_code' => $this->settings->getAppInfo()->getLangCode() ] ); $this->authorized_dc = $this->datacenter->curdc; $this->authorization['phone_number'] = $number; //$this->authorization['_'] .= 'MP'; $this->authorized = MTProto::WAITING_CODE; $this->updates = []; $this->updates_key = 0; $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_code_sent'], \danog\MadelineProto\Logger::NOTICE); return $this->authorization; } /** * Complet user login using login code. * * @param string $code Login code * */ public function completePhoneLogin($code): \Generator { if ($this->authorized !== MTProto::WAITING_CODE) { throw new \danog\MadelineProto\Exception(\danog\MadelineProto\Lang::$current_lang['login_code_uncalled']); } $this->authorized = MTProto::NOT_LOGGED_IN; $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_user'], \danog\MadelineProto\Logger::NOTICE); try { $authorization = yield from $this->methodCallAsyncRead('auth.signIn', ['phone_number' => $this->authorization['phone_number'], 'phone_code_hash' => $this->authorization['phone_code_hash'], 'phone_code' => (string) $code]); } catch (\danog\MadelineProto\RPCErrorException $e) { if ($e->rpc === 'SESSION_PASSWORD_NEEDED') { $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_2fa_enabled'], \danog\MadelineProto\Logger::NOTICE); $this->authorization = yield from $this->methodCallAsyncRead('account.getPassword', []); if (!isset($this->authorization['hint'])) { $this->authorization['hint'] = ''; } $this->authorized = MTProto::WAITING_PASSWORD; return $this->authorization; } if ($e->rpc === 'PHONE_NUMBER_UNOCCUPIED') { $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_need_signup'], \danog\MadelineProto\Logger::NOTICE); $this->authorized = MTProto::WAITING_SIGNUP; $this->authorization['phone_code'] = $code; return ['_' => 'account.needSignup']; } throw $e; } if ($authorization['_'] === 'auth.authorizationSignUpRequired') { $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_need_signup'], \danog\MadelineProto\Logger::NOTICE); $this->authorized = MTProto::WAITING_SIGNUP; $this->authorization['phone_code'] = $code; $authorization['_'] = 'account.needSignup'; return $authorization; } $this->authorized = MTProto::LOGGED_IN; $this->authorization = $authorization; $this->datacenter->getDataCenterConnection($this->datacenter->curdc)->authorized(true); yield from $this->initAuthorization(); yield from $this->getPhoneConfig(); $this->startUpdateSystem(); $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_ok'], \danog\MadelineProto\Logger::NOTICE); return $this->authorization; } /** * Import authorization. * * @param array<int, string> $authorization Authorization info * @param int $mainDcID Main DC ID * */ public function importAuthorization(array $authorization, int $mainDcID): \Generator { if ($this->authorized === MTProto::LOGGED_IN) { $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['already_loggedIn'], \danog\MadelineProto\Logger::NOTICE); yield from $this->logout(); } $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_auth_key'], \danog\MadelineProto\Logger::NOTICE); foreach ($this->datacenter->getDataCenterConnections() as $connection) { $connection->resetSession(); $connection->setPermAuthKey(null); $connection->setTempAuthKey(null); $connection->authorized(false); } foreach ($authorization as $dc_id => $auth_key) { $this->logger->logger("Setting auth key in DC $dc_id", \danog\MadelineProto\Logger::NOTICE); if (!\is_array($auth_key)) { $auth_key = ['auth_key' => $auth_key]; } $auth_key = new PermAuthKey($auth_key); $auth_key->authorized(true); $dataCenterConnection = $this->datacenter->getDataCenterConnection($dc_id); $dataCenterConnection->setPermAuthKey($auth_key); } $this->authorized_dc = $mainDcID; $this->authorized = MTProto::LOGGED_IN; yield from $this->connectToAllDcs(true); yield from $this->initAuthorization(); yield from $this->getPhoneConfig(); $res = (yield from $this->fullGetSelf()); $callbacks = [$this, $this->referenceDatabase]; if (!($this->authorization['user']['bot'] ?? false)) { $callbacks[] = $this->minDatabase; } $this->TL->updateCallbacks($callbacks); $this->startUpdateSystem(); return $res; } /** * Export authorization. * * * @psalm-return \Generator<mixed, array|bool, mixed, array{0: int|string, 1: string}> */ public function exportAuthorization(): \Generator { if ($this->authorized !== MTProto::LOGGED_IN) { throw new \danog\MadelineProto\Exception(\danog\MadelineProto\Lang::$current_lang['not_loggedIn']); } yield from $this->fullGetSelf(); $this->authorized_dc = $this->datacenter->curdc; return [$this->datacenter->curdc, $this->datacenter->getDataCenterConnection($this->datacenter->curdc)->getPermAuthKey()->getAuthKey()]; } /** * Complete signup to Telegram. * * @param string $first_name First name * @param string $last_name Last name * */ public function completeSignup(string $first_name, string $last_name = ''): \Generator { if ($this->authorized !== MTProto::WAITING_SIGNUP) { throw new \danog\MadelineProto\Exception(\danog\MadelineProto\Lang::$current_lang['signup_uncalled']); } $this->authorized = MTProto::NOT_LOGGED_IN; $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['signing_up'], \danog\MadelineProto\Logger::NOTICE); $this->authorization = yield from $this->methodCallAsyncRead('auth.signUp', ['phone_number' => $this->authorization['phone_number'], 'phone_code_hash' => $this->authorization['phone_code_hash'], 'phone_code' => $this->authorization['phone_code'], 'first_name' => $first_name, 'last_name' => $last_name]); $this->authorized = MTProto::LOGGED_IN; $this->datacenter->getDataCenterConnection($this->datacenter->curdc)->authorized(true); yield from $this->initAuthorization(); yield from $this->getPhoneConfig(); $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['signup_ok'], \danog\MadelineProto\Logger::NOTICE); $this->startUpdateSystem(); return $this->authorization; } /** * Complete 2FA login. * * @param string $password Password * */ public function complete2faLogin(string $password): \Generator { if ($this->authorized !== MTProto::WAITING_PASSWORD) { throw new \danog\MadelineProto\Exception(\danog\MadelineProto\Lang::$current_lang['2fa_uncalled']); } $this->authorized = MTProto::NOT_LOGGED_IN; $hasher = new PasswordCalculator($this->logger); $hasher->addInfo(yield from $this->methodCallAsyncRead('account.getPassword', [])); $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_user'], \danog\MadelineProto\Logger::NOTICE); $this->authorization = yield from $this->methodCallAsyncRead('auth.checkPassword', ['password' => $hasher->getCheckPassword($password)]); $this->authorized = MTProto::LOGGED_IN; $this->datacenter->getDataCenterConnection($this->datacenter->curdc)->authorized(true); yield from $this->initAuthorization(); $this->logger->logger(\danog\MadelineProto\Lang::$current_lang['login_ok'], \danog\MadelineProto\Logger::NOTICE); yield from $this->getPhoneConfig(); $this->startUpdateSystem(); return $this->authorization; } /** * Update the 2FA password. * * The params array can contain password, new_password, email and hint params. * * @param array $params The params * */ public function update2fa(array $params): \Generator { $hasher = new PasswordCalculator($this->logger); $hasher->addInfo(yield from $this->methodCallAsyncRead('account.getPassword', [])); return yield from $this->methodCallAsyncRead('account.updatePasswordSettings', $hasher->getPassword($params)); } } <?php /** * Start module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; use danog\MadelineProto\Ipc\Client; use danog\MadelineProto\Lang; use danog\MadelineProto\MTProto; use danog\MadelineProto\Settings; use danog\MadelineProto\Tools; /** * Manages simple logging in and out. * * @property Settings $settings Settings */ trait Start { /** * Log in to telegram (via CLI or web). * */ public function start(): \Generator { if ((yield $this->getAuthorization()) === MTProto::LOGGED_IN) { return $this instanceof Client ? yield from $this->getSelf() : yield from $this->fullGetSelf(); } if ($this->getWebTemplate() === 'legacy') { if ($this instanceof Client) { $settings = yield from $this->getSettings(); } else { $settings = $this->settings; } $this->setWebTemplate($settings->getTemplates()->getHtmlTemplate()); } if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') { if (\strpos(yield Tools::readLine(Lang::$current_lang['loginChoosePrompt']), 'b') !== false) { yield from $this->botLogin(yield Tools::readLine(Lang::$current_lang['loginBot'])); } else { yield from $this->phoneLogin(yield Tools::readLine(Lang::$current_lang['loginUser'])); $authorization = (yield from $this->completePhoneLogin(yield Tools::readLine(Lang::$current_lang['loginUserCode']))); if ($authorization['_'] === 'account.password') { $authorization = (yield from $this->complete2faLogin(yield Tools::readLine(\sprintf(Lang::$current_lang['loginUserPass'], $authorization['hint'])))); } if ($authorization['_'] === 'account.needSignup') { $authorization = (yield from $this->completeSignup(yield Tools::readLine(Lang::$current_lang['signupFirstName']), yield Tools::readLine(Lang::$current_lang['signupLastName']))); } } $this->serialize(); return yield from $this->fullGetSelf(); } if ((yield $this->getAuthorization()) === MTProto::NOT_LOGGED_IN) { if (isset($_POST['phone_number'])) { yield from $this->webPhoneLogin(); } elseif (isset($_POST['token'])) { yield from $this->webBotLogin(); } else { yield from $this->webEcho(); } } elseif ((yield $this->getAuthorization()) === MTProto::WAITING_CODE) { if (isset($_POST['phone_code'])) { yield from $this->webCompletePhoneLogin(); } else { yield from $this->webEcho(Lang::$current_lang['loginNoCode']); } } elseif ((yield $this->getAuthorization()) === MTProto::WAITING_PASSWORD) { if (isset($_POST['password'])) { yield from $this->webComplete2faLogin(); } else { yield from $this->webEcho(Lang::$current_lang['loginNoPass']); } } elseif ((yield $this->getAuthorization()) === MTProto::WAITING_SIGNUP) { if (isset($_POST['first_name'])) { yield from $this->webCompleteSignup(); } else { yield from $this->webEcho(Lang::$current_lang['loginNoName']); } } if ((yield $this->getAuthorization()) === MTProto::LOGGED_IN) { $this->serialize(); return yield from $this->fullGetSelf(); } exit; } private function webPhoneLogin(): \Generator { try { yield from $this->phoneLogin($_POST['phone_number']); yield from $this->webEcho(); } catch (\danog\MadelineProto\RPCErrorException $e) { yield from $this->webEcho(\sprintf(Lang::$current_lang['apiError'], $e->getMessage())); } catch (\danog\MadelineProto\Exception $e) { yield from $this->webEcho(\sprintf(Lang::$current_lang['apiError'], $e->getMessage())); } } private function webCompletePhoneLogin(): \Generator { try { yield from $this->completePhoneLogin($_POST['phone_code']); yield from $this->webEcho(); } catch (\danog\MadelineProto\RPCErrorException $e) { yield from $this->webEcho(\sprintf(Lang::$current_lang['apiError'], $e->getMessage())); } catch (\danog\MadelineProto\Exception $e) { yield from $this->webEcho(\sprintf(Lang::$current_lang['apiError'], $e->getMessage())); } } private function webComplete2faLogin(): \Generator { try { yield from $this->complete2faLogin($_POST['password']); yield from $this->webEcho(); } catch (\danog\MadelineProto\RPCErrorException $e) { yield from $this->webEcho(\sprintf(Lang::$current_lang['apiError'], $e->getMessage())); } catch (\danog\MadelineProto\Exception $e) { yield from $this->webEcho(\sprintf(Lang::$current_lang['apiError'], $e->getMessage())); } } private function webCompleteSignup(): \Generator { try { yield from $this->completeSignup($_POST['first_name'], isset($_POST['last_name']) ? $_POST['last_name'] : ''); yield from $this->webEcho(); } catch (\danog\MadelineProto\RPCErrorException $e) { yield from $this->webEcho(\sprintf(Lang::$current_lang['apiError'], $e->getMessage())); } catch (\danog\MadelineProto\Exception $e) { yield from $this->webEcho(\sprintf(Lang::$current_lang['apiError'], $e->getMessage())); } } private function webBotLogin(): \Generator { try { yield from $this->botLogin($_POST['token']); yield from $this->webEcho(); } catch (\danog\MadelineProto\RPCErrorException $e) { yield from $this->webEcho(\sprintf(Lang::$current_lang['apiError'], $e->getMessage())); } catch (\danog\MadelineProto\Exception $e) { yield from $this->webEcho(\sprintf(Lang::$current_lang['apiError'], $e->getMessage())); } } } <?php /** * Templates module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; use \danog\MadelineProto\MTProto; use danog\MadelineProto\Ipc\Client; use danog\MadelineProto\Lang; use function Amp\ByteStream\getOutputBufferStream; trait Templates { /** * Echo page to console. * * @param string $message Error message * */ private function webEcho(string $message = ''): \Generator { $auth = yield $this->getAuthorization(); $form = null; if ($auth === MTProto::NOT_LOGGED_IN) { if (isset($_POST['type'])) { if ($_POST['type'] === 'phone') { $title = \str_replace(':', '', Lang::$current_lang['loginUser']); $phone = \htmlentities(Lang::$current_lang['loginUserPhoneWeb']); $form = "<input type='text' name='phone_number' placeholder='$phone' required/>"; } else { $title = \str_replace(':', '', Lang::$current_lang['loginBot']); $token = \htmlentities(Lang::$current_lang['loginBotTokenWeb']); $form = "<input type='text' name='token' placeholder='$token' required/>"; } } else { $title = Lang::$current_lang['loginChoosePromptWeb']; $optionBot = \htmlentities(Lang::$current_lang['loginOptionBot']); $optionUser = \htmlentities(Lang::$current_lang['loginOptionUser']); $form = "<select name='type'><option value='phone'>$optionUser</option><option value='bot'>$optionBot</option></select>"; } } elseif ($auth === MTProto::WAITING_CODE) { $title = \str_replace(':', '', Lang::$current_lang['loginUserCode']); $phone = \htmlentities(Lang::$current_lang['loginUserPhoneCodeWeb']); $form = "<input type='text' name='phone_code' placeholder='$phone' required/>"; } elseif ($auth === MTProto::WAITING_PASSWORD) { $title = Lang::$current_lang['loginUserPassWeb']; $hint = \htmlentities(\sprintf( Lang::$current_lang['loginUserPassHint'], /** @psalm-suppress InvalidIterator */ $this instanceof Client ? yield from $this->getHint() : $this->getHint() )); $form = "<input type='password' name='password' placeholder='$hint' required/>"; } elseif ($auth === MTProto::WAITING_SIGNUP) { $title = Lang::$current_lang['signupWeb']; $firstName = Lang::$current_lang['signupFirstNameWeb']; $lastName = Lang::$current_lang['signupLastNameWeb']; $form = "<input type='text' name='first_name' placeholder='$firstName' required/><input type='text' name='last_name' placeholder='$lastName'/>"; } else { return; } $title = \htmlentities($title); $message = \htmlentities($message); return getOutputBufferStream()->write($this->webEchoTemplate("$title<br><b>$message</b>", $form)); } /** * Web template. * * @var string */ private $webTemplate = 'legacy'; /** * Format message according to template. * * @param string $message Message * @param string $form Form contents * */ private function webEchoTemplate(string $message, string $form): string { return \sprintf($this->webTemplate, $message, $form, Lang::$current_lang['go']); } /** * Get web template. * */ public function getWebTemplate(): string { return $this->webTemplate; } /** * Set web template. * * @param string $template Template * */ public function setWebTemplate(string $template): void { $this->webTemplate = $template; } } <?php /** * Loop module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; use Amp\Loop as AmpLoop; use Amp\Promise; use danog\MadelineProto\Settings; use danog\MadelineProto\Shutdown; use danog\MadelineProto\Tools; /** * Manages logging in and out. * * @property Settings $settings Settings */ trait Loop { private $loop_callback; /** * Whether to stop the loop. * * @var boolean */ private $stopLoop = false; /** * Initialize self-restart hack. * */ public function initSelfRestart(): void { static $inited = false; if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg' && !$inited) { $needs_restart = true; try { if (\function_exists('set_time_limit')) { \set_time_limit(-1); } } catch (\danog\MadelineProto\Exception $e) { $needs_restart = true; } if (isset($_REQUEST['MadelineSelfRestart'])) { $this->logger->logger("Self-restarted, restart token ".$_REQUEST['MadelineSelfRestart']); } $this->logger->logger($needs_restart ? 'Will self-restart' : 'Will not self-restart'); if ($needs_restart) { $this->logger->logger("Adding restart callback!"); $logger = $this->logger; $id = Shutdown::addCallback(static function () use (&$logger): void { $address = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on' ? 'tls' : 'tcp').'://'.$_SERVER['SERVER_NAME']; $port = $_SERVER['SERVER_PORT']; $uri = $_SERVER['REQUEST_URI']; $params = $_GET; $params['MadelineSelfRestart'] = Tools::randomInt(); $url = \explode('?', $uri, 2)[0] ?? ''; $query = \http_build_query($params); $uri = \implode('?', [$url, $query]); $payload = $_SERVER['REQUEST_METHOD'].' '.$uri." HTTP/1.1\r\n".'Host: '.$_SERVER['SERVER_NAME']."\r\n\r\n"; $logger->logger("Connecting to {$address}:{$port}"); $a = \fsockopen($address, $port); $logger->logger("Sending self-restart payload"); $logger->logger($payload); \fwrite($a, $payload); $logger->logger("Payload sent with token {$params['MadelineSelfRestart']}, waiting for self-restart"); // Keep around resource for a bit more $GLOBALS['MadelineShutdown'] = $a; $logger->logger("Shutdown of self-restart callback"); }, 'restarter'); $this->logger->logger("Added restart callback with ID $id!"); } $this->logger->logger("Done webhost init process!"); Tools::closeConnection($this->getWebMessage("The bot was started!")); $inited = true; } elseif (PHP_SAPI === 'cli') { try { if (\function_exists('shell_exec') && \file_exists('/data/data/com.termux/files/usr/bin/termux-wake-lock')) { \shell_exec('/data/data/com.termux/files/usr/bin/termux-wake-lock'); } } catch (\Throwable $e) { } } } /** * Start MadelineProto's update handling loop, or run the provided async callable. * * @param callable|null $callback Async callable to run * */ public function loop($callback = null): \Generator { if (\is_callable($callback)) { $this->logger->logger('Running async callable'); return (yield $callback()); } if ($callback instanceof Promise) { $this->logger->logger('Resolving async promise'); return (yield $callback); } if (!$this->authorized) { $this->logger->logger('Not authorized, not starting event loop', \danog\MadelineProto\Logger::FATAL_ERROR); return false; } if ($this->updateHandler === self::GETUPDATES_HANDLER) { $this->logger->logger('Getupdates event handler is enabled, exiting from loop', \danog\MadelineProto\Logger::FATAL_ERROR); return false; } $this->logger->logger('Starting event loop'); if (!\is_callable($this->loop_callback)) { $this->loop_callback = null; } $this->initSelfRestart(); $this->startUpdateSystem(); $this->logger->logger('Started update loop', \danog\MadelineProto\Logger::NOTICE); $this->stopLoop = false; if ($this->loop_callback !== null) { $repeat = AmpLoop::repeat(1000, fn () => Tools::callFork(($this->loop_callback)())); } do { if (!$this->updateHandler) { yield $this->waitUpdate(); if (!$this->updateHandler) { $this->logger->logger('Exiting update loop, no handler!', \danog\MadelineProto\Logger::NOTICE); continue; } } while ($this->updates) { $updates = $this->updates; $this->updates = []; foreach ($updates as $update) { $r = ($this->updateHandler)($update); if (\is_object($r)) { \danog\MadelineProto\Tools::callFork($r); } } $updates = []; } yield $this->waitUpdate(); $this->logger->logger('Resuming update loop!', \danog\MadelineProto\Logger::VERBOSE); } while (!$this->stopLoop); $this->logger->logger('Exiting update loop!', \danog\MadelineProto\Logger::NOTICE); $this->stopLoop = false; if (isset($repeat)) { AmpLoop::cancel($repeat); } } /** * Stop update loop. * */ public function stop(): void { \danog\MadelineProto\Shutdown::removeCallback('restarter'); $this->restart(); } /** * Restart update loop. * */ public function restart(): void { $this->stopLoop = true; $this->signalUpdate(); } /** * Start MadelineProto's update handling loop in background. * */ public function loopFork(): Promise { return Tools::callFork($this->loop()); } } <?php /** * Callback module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; /** * Manages logging in and out. */ trait Callback { /** * Set update handling callback. * * @param callable $callback Callback * */ public function setCallback($callback): void { $this->updateHandler = $callback; $this->startUpdateSystem(); } } <?php /** * Webhook module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; use Amp\Http\Client\Request; use danog\MadelineProto\Settings; /** * Manages logging in and out. * * @property Settings $settings */ trait Webhook { /** * Set webhook update handler. * * @param string $hook_url Webhook URL * @param string $pem_path PEM path for self-signed certificate * */ public function setWebhook(string $hook_url, string $pem_path = ''): void { $this->pem_path = $pem_path; $this->hook_url = $hook_url; $this->updateHandler = [$this, 'pwrWebhook']; $this->startUpdateSystem(); } /** * Send update to webhook. * * @param array $update Update * */ private function pwrWebhook(array $update): void { $payload = \json_encode($update); if ($payload === '') { $this->logger->logger($update, $payload, \json_last_error_msg()); $this->logger->logger('EMPTY UPDATE'); return; } \danog\MadelineProto\Tools::callFork((function () use ($payload): \Generator { $request = new Request($this->hook_url, 'POST'); $request->setHeader('content-type', 'application/json'); $request->setBody($payload); $result = yield (yield $this->datacenter->getHTTPClient()->request($request))->getBody()->buffer(); $this->logger->logger('Result of webhook query is '.$result, \danog\MadelineProto\Logger::NOTICE); $result = \json_decode($result, true); if (\is_array($result) && isset($result['method']) && $result['method'] != '' && \is_string($result['method'])) { try { $this->logger->logger('Reverse webhook command returned', yield from $this->methodCallAsyncRead($result['method'], $result)); } catch (\Throwable $e) { $this->logger->logger("Reverse webhook command returned: {$e}"); } } })()); } } <?php /** * Ads module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Wrappers; use danog\MadelineProto\Db\DbArray; /** * Manages ads. * * @property DbArray $sponsoredMessages */ trait Ads { /** * Get sponsored messages for channel. * This method will return an array of [sponsored message objects](https://docs.madelineproto.xyz/API_docs/constructors/sponsoredMessage.html). * * See [the API documentation](https://core.telegram.org/api/sponsored-messages) for more info on how to handle sponsored messages. * * @param int|array $peer Channel ID, or Update, or Message, or Peer. */ public function getSponsoredMessages($peer): \Generator { $peer = (yield from $this->getInfo($peer))['bot_api_id']; $cache = yield $this->sponsoredMessages[$peer]; if ($cache && $cache[0] > \time()) { return $cache[1]; } $result = (yield from $this->methodCallAsyncRead('channels.getSponsoredMessages', ['channel' => $peer]))['messages']; $this->sponsoredMessages->set($peer, [\time() + 5*60, $result]); return $result; } /** * Mark sponsored message as read. * * @param int|array $peer Channel ID, or Update, or Message, or Peer. * @param string|array{random_id: string} $message Random ID or sponsored message to mark as read. * * @return \Generator Bool */ public function viewSponsoredMessage($peer, $message): \Generator { if (\is_array($message)) { $message = $message['random_id']; } return $this->methodCallAsyncRead('channels.viewSponsoredMessage', ['channel' => $peer, 'random_id' => $message]); } } <?php /** * Serialization module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Deferred; use Amp\Ipc\Sync\ChannelledSocket; use Amp\Loop; use Amp\Promise; use danog\MadelineProto\Db\DbPropertiesFactory; use danog\MadelineProto\Db\DriverArray; use danog\MadelineProto\Ipc\Server; use danog\MadelineProto\MTProtoSession\Session; use danog\MadelineProto\Settings\DatabaseAbstract; use function Amp\File\exists; use function Amp\File\read; use function Amp\Ipc\connect; /** * Manages serialization of the MadelineProto instance. */ abstract class Serialization { /** * Header for session files. */ const PHP_HEADER = '<?php __HALT_COMPILER();'; /** * Serialization version. */ const VERSION = 2; /** * Unserialize session. * * Logic for deserialization is as follows. * - If the session is unlocked * - Try starting IPC server: * - Fetch light state * - If don't need event handler * - Unlock * - Fork * - Lock (fork) * - Deserialize full (fork) * - Start IPC server (fork) * - Store IPC state (fork) * - If need event handler * - If have event handler class * - Deserialize full * - Start IPC server * - Store IPC state * - Else Fallthrough * - Wait for a new IPC state for a maximum of 30 seconds, then throw * - Execute original request via IPC * * - If the session is locked * - In parallel (concurrent): * - The IPC server should be running, connect * - Try starting full session * - Fetch light state * - If don't need event handler * - Wait lock * - Unlock * - Fork * - Lock (fork) * - Deserialize full (fork) * - Start IPC server (fork) * - Store IPC state (fork) * - If need event handler and have event handler class * - Wait lock * - Deserialize full * - Start IPC server * - Store IPC state * - Wait for a new IPC session for a maximum of 30 seconds, then throw * - Execute original request via IPC * * * * - If receiving a startAndLoop or setEventHandler request on an IPC session: * - Shutdown remote IPC server * - Deserialize full * - Start IPC server * - Store IPC state * * @param SessionPaths $session Session name * @param SettingsAbstract $settings Settings * @param bool $forceFull Whether to force full session deserialization * * @internal * * * @psalm-return \Generator<void, mixed, mixed, array{0: ChannelledSocket|APIWrapper|\Throwable|null|0, 1: callable|null}> */ public static function unserialize(SessionPaths $session, SettingsAbstract $settings, bool $forceFull = false): \Generator { if (yield exists($session->getSessionPath())) { // Is new session $isNew = true; } elseif (yield exists($session->getLegacySessionPath())) { // Is old session $isNew = false; } else { // No session exists yet, lock for when we create it return [null, yield from Tools::flockGenerator($session->getLockPath(), LOCK_EX, 1)]; } //Logger::log('Waiting for exclusive session lock...'); $warningId = Loop::delay(1000, static function () use (&$warningId): void { Logger::log("It seems like the session is busy."); /*if (\defined(\MADELINE_WORKER::class)) { Logger::log("Exiting since we're in a worker"); Magic::shutdown(1); }*/ Logger::log("Telegram does not support starting multiple instances of the same session, make sure no other instance of the session is running."); $warningId = Loop::repeat(5000, fn () => Logger::log('Still waiting for exclusive session lock...')); Loop::unreference($warningId); }); Loop::unreference($warningId); $lightState = null; $cancelFlock = new Deferred; $cancelIpc = new Deferred; $canContinue = true; $ipcSocket = null; $unlock = yield from Tools::flockGenerator($session->getLockPath(), LOCK_EX, 1, $cancelFlock->promise(), $forceFull ? null : static function () use ($session, $cancelFlock, $cancelIpc, &$canContinue, &$ipcSocket, &$lightState): void { $cancelFull = static function () use (&$cancelFlock): void { if ($cancelFlock !== null) { $copy = $cancelFlock; $cancelFlock = null; $copy->resolve(true); } }; $ipcSocket = Tools::call(self::tryConnect($session->getIpcPath(), $cancelIpc->promise(), $cancelFull)); $session->getLightState()->onResolve(static function (?\Throwable $e, ?LightState $res) use ($cancelFull, &$canContinue, &$lightState): void { if ($res) { $lightState = $res; if (!$res->canStartIpc()) { $canContinue = false; $cancelFull(); } } else { $lightState = false; } }); }); Loop::cancel($warningId); if (!$unlock) { // Canceled, don't have lock return $ipcSocket; } if (!$canContinue) { // Have lock, can't use it Logger::log("Session has event handler, but it's not started.", Logger::ERROR); Logger::log("We don't have access to the event handler class, so we can't start it.", Logger::ERROR); Logger::log("Please start the event handler or unset it to use the IPC server.", Logger::ERROR); $unlock(); return $ipcSocket; } try { /** @var LightState */ $lightState ??= yield $session->getLightState(); } catch (\Throwable $e) { } if ($lightState && !$forceFull) { if (!$class = $lightState->getEventHandler()) { // Unlock and fork $unlock(); $cancelIpc->resolve(Server::startMe($session)); return $ipcSocket ?? yield from self::tryConnect($session->getIpcPath(), $cancelIpc->promise()); } elseif (!\class_exists($class)) { // Have lock, can't use it $unlock(); Logger::log("Session has event handler, but it's not started.", Logger::ERROR); Logger::log("We don't have access to the event handler class, so we can't start it.", Logger::ERROR); Logger::log("Please start the event handler or unset it to use the IPC server.", Logger::ERROR); return $ipcSocket ?? yield from self::tryConnect($session->getIpcPath(), $cancelIpc->promise()); } } $tempId = Shutdown::addCallback($unlock = static function () use ($unlock): void { Logger::log("Unlocking exclusive session lock!"); $unlock(); Logger::log("Unlocked exclusive session lock!"); }); Logger::log("Got exclusive session lock!"); if ($isNew) { $unserialized = yield from $session->unserialize(); if ($unserialized instanceof DriverArray) { Logger::log("Extracting session from database..."); if ($settings instanceof Settings) { $settings = $settings->getDb(); } if ($settings instanceof DatabaseAbstract) { $tableName = (string) $unserialized; $unserialized = yield DbPropertiesFactory::get( $settings, $tableName, DbPropertiesFactory::TYPE_ARRAY, $unserialized ); } else { yield from $unserialized->initStartup(); } $unserialized = yield $unserialized['data']; if (!$unserialized) { throw new Exception("Could not extract session from database!"); } } } else { $unserialized = yield from self::legacyUnserialize($session->getLegacySessionPath()); } if ($unserialized === false) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['deserialization_error']); } Shutdown::removeCallback($tempId); return [$unserialized, $unlock]; } /** * Try connecting to IPC socket. * * @param string $ipcPath IPC path * @param Promise $cancelConnect Cancelation token (triggers cancellation of connection) * @param ?callable(): void $cancelFull Cancelation token source (can trigger cancellation of full unserialization) * * @psalm-param Promise<\Throwable|null> $cancelConnect * * @psalm-return \Generator<mixed, mixed, mixed, array{0: ChannelledSocket|\Throwable|0, 1: null}> */ public static function tryConnect(string $ipcPath, Promise $cancelConnect, ?callable $cancelFull = null): \Generator { for ($x = 0; $x < 60; $x++) { Logger::log("MadelineProto is starting, please wait..."); try { \clearstatcache(true, $ipcPath); $socket = yield connect($ipcPath); Logger::log("Connected to IPC socket!"); if ($cancelFull) { $cancelFull(); } return [$socket, null]; } catch (\Throwable $e) { $e = $e->getMessage(); if ($e !== 'The endpoint does not exist!') { Logger::log("$e while connecting to IPC socket"); } } if ($res = yield Tools::timeoutWithDefault($cancelConnect, 1000, null)) { if ($res instanceof \Throwable) { return [$res, null]; } $cancelConnect = (new Deferred)->promise(); } } return [0, null]; } /** * Deserialize legacy session. * */ private static function legacyUnserialize(string $session): \Generator { $tounserialize = yield read($session); try { $unserialized = \unserialize($tounserialize); } catch (\danog\MadelineProto\Bug74586Exception $e) { \class_exists('\\Volatile'); $tounserialize = \str_replace('O:26:"danog\\MadelineProto\\Button":', 'O:35:"danog\\MadelineProto\\TL\\Types\\Button":', $tounserialize); foreach (['RSA', 'TL\\TLMethods', 'TL\\TLConstructors', 'MTProto', 'API', 'DataCenter', 'Connection', 'TL\\Types\\Button', 'TL\\Types\\Bytes', 'APIFactory'] as $class) { \class_exists('\\danog\\MadelineProto\\'.$class); } $unserialized = \danog\Serialization::unserialize($tounserialize); } catch (\danog\MadelineProto\Exception $e) { if ($e->getFile() === 'MadelineProto' && $e->getLine() === 1) { throw $e; } if (\defined('MADELINEPROTO_TEST') && \constant("MADELINEPROTO_TEST") === 'pony') { throw $e; } \class_exists('\\Volatile'); foreach (['RSA', 'TL\\TLMethods', 'TL\\TLConstructors', 'MTProto', 'API', 'DataCenter', 'Connection', 'TL\\Types\\Button', 'TL\\Types\\Bytes', 'APIFactory'] as $class) { \class_exists('\\danog\\MadelineProto\\'.$class); } $changed = false; if (\strpos($tounserialize, 'O:26:"danog\\MadelineProto\\Button":') !== false) { Logger::log("SUBBING BUTTONS!"); $tounserialize = \str_replace('O:26:"danog\\MadelineProto\\Button":', 'O:35:"danog\\MadelineProto\\TL\\Types\\Button":', $tounserialize); $changed = true; } if (\strpos($e->getMessage(), "Erroneous data format for unserializing 'phpseclib\\Math\\BigInteger'") === 0) { Logger::log("SUBBING BIGINTEGOR!"); $tounserialize = \str_replace('phpseclib\\Math\\BigInteger', 'phpseclib\\Math\\BigIntegor', $tounserialize); $changed = true; } if (\strpos($tounserialize, 'C:25:"phpseclib\\Math\\BigInteger"') !== false) { Logger::log("SUBBING TGSECLIB old!"); $tounserialize = \str_replace('C:25:"phpseclib\\Math\\BigInteger"', 'C:26:"phpseclib3\\Math\\BigInteger"', $tounserialize); $changed = true; } Logger::log((string) $e, Logger::ERROR); if (!$changed) { throw $e; } try { $unserialized = \danog\Serialization::unserialize($tounserialize); } catch (\Throwable $e) { $unserialized = \unserialize($tounserialize); } } catch (\Throwable $e) { Logger::log((string) $e, Logger::ERROR); throw $e; } if ($unserialized instanceof \danog\PlaceHolder) { $unserialized = \danog\Serialization::unserialize($tounserialize); } return $unserialized; } } <?php /** * DocsBuilder module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use danog\MadelineProto\Settings\TLSchema; use danog\MadelineProto\TL\TL; // This code was written a few years ago: it is garbage, and has to be rewritten class DocsBuilder { const DEFAULT_TEMPLATES = [ 'User' => ['User', 'InputUser', 'Chat', 'InputChannel', 'Peer', 'InputDialogPeer', 'DialogPeer', 'InputPeer', 'NotifyPeer', 'InputNotifyPeer'], 'ReplyMarkup' => ['ReplyMarkup'], 'InputFile' => ['InputFile', 'InputEncryptedFile'], 'InputEncryptedChat' => ['InputEncryptedChat'], 'PhoneCall' => ['PhoneCall'], 'InputPhoto' => ['InputPhoto'], 'InputDocument' => ['InputDocument'], 'InputMedia' => ['InputMedia'], 'InputMessage' => ['InputMessage'], 'KeyboardButton' => ['KeyboardButton'], ]; use \danog\MadelineProto\DocsBuilder\Methods; use \danog\MadelineProto\DocsBuilder\Constructors; public $td = false; protected array $settings; protected string $index; protected Logger $logger; protected TL $TL; protected array $tdDescriptions; public function __construct(Logger $logger, array $settings) { $this->logger = $logger; \set_error_handler(['\\danog\\MadelineProto\\Exception', 'ExceptionErrorHandler']); /** @psalm-suppress InvalidArgument */ $this->TL = new TL(new class($logger) { public function __construct($logger) { $this->logger = $logger; } }); $new = new TLSchema; $new->mergeArray($settings); $this->TL->init($new); if (isset($settings['tl_schema']['td']) && !isset($settings['tl_schema']['telegram'])) { $this->td = true; } $this->settings = $settings; if (!\file_exists($this->settings['output_dir'])) { \mkdir($this->settings['output_dir']); } \chdir($this->settings['output_dir']); $this->index = $settings['readme'] ? 'README.md' : 'index.md'; foreach (\glob($this->settings['template']."/*") as $template) { $this->templates[\basename($template, '.md')] = \file_get_contents($template); } } /** * Documentation templates. * * @var array */ protected $templates = []; public $types = []; public $any = '*'; public function mkDocs(): void { \danog\MadelineProto\Logger::log('Generating documentation index...', \danog\MadelineProto\Logger::NOTICE); \file_put_contents($this->index, $this->template('index', $this->settings['description'])); $this->mkMethods(); $this->mkConstructors(); foreach (\glob('types/*') as $unlink) { \unlink($unlink); } if (\file_exists('types')) { \rmdir('types'); } \mkdir('types'); \ksort($this->types); $index = ''; \danog\MadelineProto\Logger::log('Generating types documentation...', \danog\MadelineProto\Logger::NOTICE); foreach ($this->types as $otype => $keys) { $type = StrTools::typeEscape($otype); $index .= '['.StrTools::markdownEscape($type).'](/API_docs/types/'.$type.'.md)<a name="'.$type.'"></a> '; $constructors = ''; foreach ($keys['constructors'] as $data) { $predicate = $data['predicate'].(isset($data['layer']) && $data['layer'] !== '' ? '_'.$data['layer'] : ''); $md_predicate = StrTools::markdownEscape($predicate); $constructors .= "[$md_predicate](/API_docs/constructors/$predicate.md) \n\n"; } $methods = ''; foreach ($keys['methods'] as $data) { $name = $data['method']; $md_name = \str_replace(['.', '_'], ['->', '\\_'], $name); $methods .= "[\$MadelineProto->$md_name](/API_docs/methods/$name.md) \n\n"; } $symFile = \str_replace('.', '_', $type); $redir = $symFile !== $type ? "\nredirect_from: /API_docs/types/{$symFile}.html" : ''; $header = ''; if (!isset($this->settings['td'])) { foreach (self::DEFAULT_TEMPLATES as $template => $types) { if (\in_array($type, $types)) { $header .= $this->template($template, $type); } } } if (isset($this->tdDescriptions['types'][$otype])) { $header = "{$this->tdDescriptions['types'][$otype]}\n\n$header"; } $header = \sprintf( $this->templates['Type'], $type, $redir, StrTools::markdownEscape($type), $header, $constructors, $methods ); \file_put_contents('types/'.$type.'.md', $header); } \danog\MadelineProto\Logger::log('Generating types index...', \danog\MadelineProto\Logger::NOTICE); \file_put_contents('types/'.$this->index, $this->templates['types-index'].$index); \danog\MadelineProto\Logger::log('Generating additional types...', \danog\MadelineProto\Logger::NOTICE); foreach (['string', 'bytes', 'int', 'int53', 'long', 'int128', 'int256', 'int512', 'double', 'Bool', 'DataJSON', '!X'] as $type) { \file_put_contents("types/$type.md", $this->templates[$type]); } foreach (['boolFalse', 'boolTrue', 'null', 'photoStrippedSize'] as $constructor) { \file_put_contents("constructors/$constructor.md", $this->templates[$constructor]); } \danog\MadelineProto\Logger::log('Done!', \danog\MadelineProto\Logger::NOTICE); } public static function addToLang(string $key, string $value = '', bool $force = false): void { if (!isset(\danog\MadelineProto\Lang::$lang['en'][$key]) || $force) { \danog\MadelineProto\Lang::$lang['en'][$key] = $value; } } /** * Get formatted template string. * * @param string $name Template name * @param string ...$params Params * */ protected function template(string $name, string ...$params): string { return \sprintf($this->templates[$name], ...$params); } } <?php /** * DataCenter module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Dns\Config; use Amp\Dns\ConfigLoader; use Amp\Dns\Resolver; use Amp\Dns\Rfc1035StubResolver; use Amp\Dns\UnixConfigLoader; use Amp\Dns\WindowsConfigLoader; use Amp\DoH\DoHConfig; use Amp\DoH\Nameserver; use Amp\DoH\Rfc8484StubResolver; use Amp\Http\Client\Connection\DefaultConnectionFactory; use Amp\Http\Client\Connection\UnlimitedConnectionPool; use Amp\Http\Client\Cookie\CookieInterceptor; use Amp\Http\Client\Cookie\CookieJar; use Amp\Http\Client\Cookie\InMemoryCookieJar; use Amp\Http\Client\HttpClient; use Amp\Http\Client\HttpClientBuilder; use Amp\Http\Client\Request; use Amp\Promise; use Amp\Socket\ConnectContext; use Amp\Socket\DnsConnector; use Amp\Websocket\Client\Handshake; use Amp\Websocket\Client\Rfc6455Connector; use danog\MadelineProto\MTProto\PermAuthKey; use danog\MadelineProto\MTProto\TempAuthKey; use danog\MadelineProto\Settings\Connection as ConnectionSettings; use danog\MadelineProto\Stream\Common\BufferedRawStream; use danog\MadelineProto\Stream\Common\UdpBufferedStream; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\MTProtoTransport\AbridgedStream; use danog\MadelineProto\Stream\MTProtoTransport\FullStream; use danog\MadelineProto\Stream\MTProtoTransport\HttpsStream; use danog\MadelineProto\Stream\MTProtoTransport\HttpStream; use danog\MadelineProto\Stream\MTProtoTransport\IntermediatePaddedStream; use danog\MadelineProto\Stream\MTProtoTransport\IntermediateStream; use danog\MadelineProto\Stream\MTProtoTransport\ObfuscatedStream; use danog\MadelineProto\Stream\Transport\DefaultStream; use danog\MadelineProto\Stream\Transport\WssStream; use danog\MadelineProto\Stream\Transport\WsStream; /** * Manages datacenters. */ class DataCenter { use \danog\Serializable; /** * All socket connections to DCs. * * @var array<string|int, DataCenterConnection> */ public $sockets = []; /** * Current DC ID. * * @var string|int */ public $curdc = 0; /** * Main instance. * * @var MTProto */ private $API; /** * DC list. * * @var array */ private $dclist = []; /** * Settings. * * @var ConnectionSettings */ private $settings; /** * HTTP client. * * @var \Amp\Http\Client\HttpClient */ private $HTTPClient; /** * DNS over HTTPS client. * * @var Rfc8484StubResolver|Rfc1035StubResolver */ private $DoHClient; /** * Non-proxied DNS over HTTPS client. * * @var Rfc8484StubResolver|Rfc1035StubResolver */ private $nonProxiedDoHClient; /** * Cookie jar. * * @var \Amp\Http\Client\Cookie\CookieJar */ private $CookieJar; /** * DNS connector. * * @var DNSConnector */ private $dnsConnector; /** * DoH connector. */ private Rfc6455Connector $webSocketConnector; public function __sleep() { return ['sockets', 'curdc', 'dclist', 'settings']; } public function __wakeup(): void { if (\is_array($this->settings)) { $settings = new ConnectionSettings; $settings->mergeArray(['connection_settings' => $this->settings]); $this->settings = $settings; } $array = []; foreach ($this->sockets as $id => $socket) { if ($socket instanceof \danog\MadelineProto\Connection) { if (isset($socket->temp_auth_key) && $socket->temp_auth_key) { $array[$id]['tempAuthKey'] = $socket->temp_auth_key; } if (isset($socket->auth_key) && $socket->auth_key) { $array[$id]['permAuthKey'] = $socket->auth_key; /** @psalm-suppress UndefinedPropertyFetch */ $array[$id]['permAuthKey']['authorized'] = $socket->authorized; } $array[$id] = []; } } $this->setDataCenterConnections($array); } /** * Set auth key information from saved auth array. * * @param array $saved Saved auth array * */ public function setDataCenterConnections(array $saved): void { foreach ($saved as $id => $data) { $connection = $this->sockets[$id] = new DataCenterConnection(); if (isset($data['permAuthKey'])) { $connection->setPermAuthKey(new PermAuthKey($data['permAuthKey'])); } if (isset($data['linked'])) { continue; } if (isset($data['tempAuthKey'])) { $connection->setTempAuthKey(new TempAuthKey($data['tempAuthKey'])); if (($data['tempAuthKey']['bound'] ?? false) && $connection->hasPermAuthKey()) { $connection->bind(); } } unset($saved[$id]); } foreach ($saved as $id => $data) { $connection = $this->sockets[$id]; $connection->link($data['linked']); if (isset($data['tempAuthKey'])) { $connection->setTempAuthKey(new TempAuthKey($data['tempAuthKey'])); if (($data['tempAuthKey']['bound'] ?? false) && $connection->hasPermAuthKey()) { $connection->bind(); } } } } /** * Constructor function. * * @param MTProto $API Main MTProto instance * @param array $dclist DC IP list * @param ConnectionSettings $settings Settings * @param boolean $reconnectAll Whether to reconnect to all DCs or just to changed ones * @param CookieJar $jar Cookie jar * */ public function __magic_construct($API, array $dclist, ConnectionSettings $settings, bool $reconnectAll = true, CookieJar $jar = null): void { $this->API = $API; $changed = []; $changedSettings = $settings->hasChanged(); if (!$reconnectAll) { $changed = []; $test = $API->getCachedConfig()['test_mode'] ?? false ? 'test' : 'main'; foreach ($dclist[$test] as $ipv6 => $dcs) { foreach ($dcs as $id => $dc) { if ($dc !== ($this->dclist[$test][$ipv6][$id] ?? [])) { $changed[$id] = true; } } } } $this->dclist = $dclist; $this->settings = $settings; foreach ($this->sockets as $key => $socket) { if ($socket instanceof DataCenterConnection && !\strpos($key, '_bk')) { if ($reconnectAll || isset($changed[$id])) { $this->API->logger->logger("Disconnecting all before reconnect!"); $socket->needReconnect(true); $socket->setExtra($this->API); $socket->disconnect(); } } else { unset($this->sockets[$key]); } } if ($reconnectAll || $changedSettings || !$this->CookieJar) { $configProvider = new class implements ConfigLoader { private function loadConfigGenerator(): \Generator { $loader = \stripos(PHP_OS, "win") === 0 ? new WindowsConfigLoader() : new UnixConfigLoader(); try { return yield $loader->loadConfig(); } catch (\Throwable) { return new Config([ '1.1.1.1', '1.0.0.1', '[2606:4700:4700::1111]', '[2606:4700:4700::1001]', ]); } } public function loadConfig(): Promise { return Tools::call($this->loadConfigGenerator()); } }; $this->CookieJar = $jar ?? new InMemoryCookieJar(); $this->HTTPClient = (new HttpClientBuilder())->interceptNetwork(new CookieInterceptor($this->CookieJar))->usingPool(new UnlimitedConnectionPool(new DefaultConnectionFactory(new ContextConnector($this))))->build(); $DoHHTTPClient = (new HttpClientBuilder())->interceptNetwork(new CookieInterceptor($this->CookieJar))->usingPool(new UnlimitedConnectionPool(new DefaultConnectionFactory(new ContextConnector($this, true))))->build(); $DoHConfig = new DoHConfig([new Nameserver('https://mozilla.cloudflare-dns.com/dns-query'), new Nameserver('https://dns.google/resolve')], $DoHHTTPClient); $nonProxiedDoHConfig = new DoHConfig([new Nameserver('https://mozilla.cloudflare-dns.com/dns-query'), new Nameserver('https://dns.google/resolve')]); $this->DoHClient = Magic::$altervista || Magic::$zerowebhost || !$settings->getUseDoH() ? new Rfc1035StubResolver(null, $configProvider) : new Rfc8484StubResolver($DoHConfig); $this->nonProxiedDoHClient = Magic::$altervista || Magic::$zerowebhost || !$settings->getUseDoH() ? new Rfc1035StubResolver(null, $configProvider) : new Rfc8484StubResolver($nonProxiedDoHConfig); $this->dnsConnector = new DnsConnector(new Rfc1035StubResolver(null, $configProvider)); $this->webSocketConnector = new Rfc6455Connector($this->HTTPClient); } $this->settings->applyChanges(); } /** * Set VoIP endpoints. * * @param array $endpoints Endpoints * */ public function setVoIPEndpoints(array $endpoints): void { } /** * Connect to specified DC. * * @param string $dc_number DC to connect to * @param integer $id Connection ID to re-establish (optional) * * @return \Generator<bool> */ public function dcConnect(string $dc_number, int $id = -1): \Generator { $old = isset($this->sockets[$dc_number]) && ($this->sockets[$dc_number]->shouldReconnect() || $id !== -1 && $this->sockets[$dc_number]->hasConnection($id) && $this->sockets[$dc_number]->getConnection($id)->shouldReconnect()); if (isset($this->sockets[$dc_number]) && !$old) { $this->API->logger("Not reconnecting to DC {$dc_number} ({$id})"); return false; } $ctxs = $this->generateContexts($dc_number); if (empty($ctxs)) { return false; } foreach ($ctxs as $ctx) { try { if ($old) { $this->API->logger->logger("Reconnecting to DC {$dc_number} ({$id}) from existing", Logger::WARNING); $this->sockets[$dc_number]->setExtra($this->API); yield from $this->sockets[$dc_number]->connect($ctx, $id); } else { $this->API->logger->logger("Connecting to DC {$dc_number} from scratch", Logger::WARNING); $this->sockets[$dc_number] = new DataCenterConnection(); $this->sockets[$dc_number]->setExtra($this->API); yield from $this->sockets[$dc_number]->connect($ctx); } if ($ctx->getIpv6()) { Magic::setIpv6(true); } $this->API->logger->logger('OK!', Logger::WARNING); return true; } catch (\Throwable $e) { if (\defined("MADELINEPROTO_TEST") && \constant("MADELINEPROTO_TEST") === 'pony') { throw $e; } $this->API->logger->logger("Connection failed ({$dc_number}): ".$e->getMessage(), Logger::ERROR); } } throw new Exception("Could not connect to DC {$dc_number}"); } /** * Generate contexts. * * @param integer $dc_number DC ID to generate contexts for * @param string $uri URI * @param ConnectContext $context Connection context * * @return ConnectionContext[] */ public function generateContexts($dc_number = 0, string $uri = '', ConnectContext $context = null): array { $ctxs = []; $combos = []; $test = $this->settings->getTestMode() ? 'test' : 'main'; $ipv6 = $this->settings->getIpv6() ? 'ipv6' : 'ipv4'; switch ($this->settings->getProtocol()) { case AbridgedStream::class: $default = [[DefaultStream::class, []], [BufferedRawStream::class, []], [AbridgedStream::class, []]]; break; case IntermediateStream::class: $default = [[DefaultStream::class, []], [BufferedRawStream::class, []], [IntermediateStream::class, []]]; break; case IntermediatePaddedStream::class: $default = [[DefaultStream::class, []], [BufferedRawStream::class, []], [IntermediatePaddedStream::class, []]]; break; case FullStream::class: $default = [[DefaultStream::class, []], [BufferedRawStream::class, []], [FullStream::class, []]]; break; case HttpStream::class: $default = [[DefaultStream::class, []], [BufferedRawStream::class, []], [HttpStream::class, []]]; break; case HttpsStream::class: $default = [[DefaultStream::class, []], [BufferedRawStream::class, []], [HttpsStream::class, []]]; break; case UdpBufferedStream::class: $default = [[DefaultStream::class, []], [UdpBufferedStream::class, []]]; break; default: throw new Exception(Lang::$current_lang['protocol_invalid']); } if ($this->settings->getObfuscated() && !\in_array($default[2][0], [HttpsStream::class, HttpStream::class])) { $default = [[DefaultStream::class, []], [BufferedRawStream::class, []], [ObfuscatedStream::class, []], \end($default)]; } if ($this->settings->getTransport() && !\in_array($default[2][0], [HttpsStream::class, HttpStream::class])) { switch ($this->settings->getTransport()) { case DefaultStream::class: if ($this->settings->getObfuscated()) { $default = [[DefaultStream::class, []], [BufferedRawStream::class, []], [ObfuscatedStream::class, []], \end($default)]; } break; case WssStream::class: $default = [[DefaultStream::class, []], [WssStream::class, []], [BufferedRawStream::class, []], [ObfuscatedStream::class, []], \end($default)]; break; case WsStream::class: $default = [[DefaultStream::class, []], [WsStream::class, []], [BufferedRawStream::class, []], [ObfuscatedStream::class, []], \end($default)]; break; } } if (!$dc_number) { $default = [[DefaultStream::class, []], [BufferedRawStream::class, []]]; } $combos[] = $default; if ($this->settings->getRetry()) { $only = $this->dclist[$test][$ipv6][$dc_number]['tcpo_only'] ?? false; if ($only || isset($this->dclist[$test][$ipv6][$dc_number]['secret'])) { $extra = isset($this->dclist[$test][$ipv6][$dc_number]['secret']) ? ['secret' => $this->dclist[$test][$ipv6][$dc_number]['secret']] : []; $combo = [[DefaultStream::class, []], [BufferedRawStream::class, []], [ObfuscatedStream::class, $extra], [IntermediatePaddedStream::class, []]]; if ($only) { \array_unshift($combos, $combo); } else { $combos []= $combo; } } $proxyCombos = []; foreach ($this->settings->getProxies() as $proxy => $extras) { if (!$dc_number && $proxy === ObfuscatedStream::class) { continue; } foreach ($extras as $extra) { if ($proxy === ObfuscatedStream::class && \in_array(\strlen($extra['secret']), [17, 34])) { $combos[] = [[DefaultStream::class, []], [BufferedRawStream::class, []], [$proxy, $extra], [IntermediatePaddedStream::class, []]]; } foreach ($combos as $orig) { $combo = []; if ($proxy === ObfuscatedStream::class) { $combo = $orig; if ($combo[\count($combo) - 2][0] === ObfuscatedStream::class) { $combo[\count($combo) - 2][1] = $extra; } else { $mtproto = \end($combo); $combo[\count($combo) - 1] = [$proxy, $extra]; $combo[] = $mtproto; } } else { if ($orig[1][0] === BufferedRawStream::class) { [$first, $second] = [\array_slice($orig, 0, 2), \array_slice($orig, 2)]; $first[] = [$proxy, $extra]; $combo = \array_merge($first, $second); } elseif (\in_array($orig[1][0], [WsStream::class, WssStream::class])) { [$first, $second] = [\array_slice($orig, 0, 1), \array_slice($orig, 1)]; $first[] = [BufferedRawStream::class, []]; $first[] = [$proxy, $extra]; $combo = \array_merge($first, $second); } } $proxyCombos []= $combo; } } } $combos = \array_merge($proxyCombos, $combos); if ($dc_number) { $combos[] = [[DefaultStream::class, []], [BufferedRawStream::class, []], [HttpsStream::class, []]]; } $combos = \array_unique($combos, SORT_REGULAR); } /* @var $context \Amp\ConnectContext */ $context = $context ?? (new ConnectContext())->withMaxAttempts(1)->withConnectTimeout(1000 * $this->settings->getTimeout())->withBindTo($this->settings->getBindTo()); foreach ($combos as $combo) { foreach ([true, false] as $useDoH) { $ipv6Combos = [ $this->settings->getIpv6() ? 'ipv6' : 'ipv4', $this->settings->getIpv6() ? 'ipv4' : 'ipv6' ]; foreach ($ipv6Combos as $ipv6) { // This is only for non-MTProto connections if (!$dc_number) { /* @var $ctx \danog\MadelineProto\Stream\ConnectionContext */ $ctx = (new ConnectionContext())->setSocketContext($context)->setUri($uri)->setIpv6($ipv6 === 'ipv6'); foreach ($combo as $stream) { if ($stream[0] === DefaultStream::class && $stream[1] === []) { $stream[1] = $useDoH ? new DoHConnector($this, $ctx) : $this->dnsConnector; } /** @var array{0: class-string, 1: mixed} $stream */ $ctx->addStream(...$stream); } $ctxs[] = $ctx; continue; } // This is only for MTProto connections if (!isset($this->dclist[$test][$ipv6][$dc_number]['ip_address'])) { continue; } $address = $this->dclist[$test][$ipv6][$dc_number]['ip_address']; if ($ipv6 === 'ipv6') { $address = "[$address]"; } $port = $this->dclist[$test][$ipv6][$dc_number]['port']; foreach (\array_unique([$port, 443, 80, 88, 5222]) as $port) { $stream = \end($combo)[0]; if ($stream === HttpsStream::class) { if (\strpos($dc_number, '_cdn') !== false) { continue; } $subdomain = $this->settings->getSslSubdomains()[\preg_replace('/\\D+/', '', $dc_number)]; if (\strpos($dc_number, '_media') !== false) { $subdomain .= '-1'; } $path = $this->settings->getTestMode() ? 'apiw_test1' : 'apiw1'; $uri = 'tcp://'.$subdomain.'.web.telegram.org:'.$port.'/'.$path; } elseif ($stream === HttpStream::class) { $uri = 'tcp://'.$address.':'.$port.'/api'; } else { $uri = 'tcp://'.$address.':'.$port; } if ($combo[1][0] === WssStream::class) { $subdomain = $this->settings->getSslSubdomains()[\preg_replace('/\\D+/', '', $dc_number)]; if (\strpos($dc_number, '_media') !== false) { $subdomain .= '-1'; } $path = $this->settings->getTestMode() ? 'apiws_test' : 'apiws'; $uri = 'tcp://'.$subdomain.'.web.telegram.org:'.$port.'/'.$path; } elseif ($combo[1][0] === WsStream::class) { $subdomain = $this->settings->getSslSubdomains()[\preg_replace('/\\D+/', '', $dc_number)]; if (\strpos($dc_number, '_media') !== false) { $subdomain .= '-1'; } $path = $this->settings->getTestMode() ? 'apiws_test' : 'apiws'; //$uri = 'tcp://' . $subdomain . '.web.telegram.org:' . $port . '/' . $path; $uri = 'tcp://'.$address.':'.$port.'/'.$path; } /* @var $ctx \danog\MadelineProto\Stream\ConnectionContext */ $ctx = (new ConnectionContext())->setDc($dc_number)->setTest($this->settings->getTestMode())->setSocketContext($context)->setUri($uri)->setIpv6($ipv6 === 'ipv6'); foreach ($combo as $stream) { if ($stream[0] === DefaultStream::class && $stream[1] === []) { $stream[1] = $useDoH ? new DoHConnector($this, $ctx) : $this->dnsConnector; } if (\in_array($stream[0], [WsStream::class, WssStream::class]) && $stream[1] === []) { if (!\class_exists(Handshake::class)) { throw new Exception('Please install amphp/websocket-client by running "composer require amphp/websocket-client:dev-master"'); } $stream[1] = $this->webSocketConnector; } /** @var array{0: class-string, 1: mixed} $stream */ $ctx->addStream(...$stream); } $ctxs[] = $ctx; } } } } if (empty($ctxs)) { unset($this->sockets[$dc_number]); $this->API->logger->logger("No info for DC {$dc_number}", Logger::ERROR); } elseif (\defined('MADELINEPROTO_TEST') && \constant("MADELINEPROTO_TEST") === 'pony') { return [$ctxs[0]]; } return $ctxs; } /** * Get main API. * * @return MTProto */ public function getAPI() { return $this->API; } /** * Get async HTTP client. * */ public function getHTTPClient(): HttpClient { return $this->HTTPClient; } /** * Get async HTTP client cookies. * */ public function getCookieJar(): CookieJar { return $this->CookieJar; } /** * Get DNS over HTTPS async DNS client. * */ public function getDNSClient(): Resolver { return $this->DoHClient; } /** * Get non-proxied DNS over HTTPS async DNS client. * */ public function getNonProxiedDNSClient(): Resolver { return $this->nonProxiedDoHClient; } /** * Get contents of file. * * @param string $url URL to fetch * * * @psalm-return \Generator<int, \Amp\Promise<string>, mixed, string> */ public function fileGetContents(string $url): \Generator { return yield (yield $this->getHTTPClient()->request(new Request($url)))->getBody()->buffer(); } /** * Get Connection instance for authorization. * * @param string $dc DC ID * */ public function getAuthConnection(string $dc): Connection { return $this->sockets[$dc]->getAuthConnection(); } /** * Get Connection instance. * * @param string $dc DC ID * */ public function getConnection(string $dc): Connection { return $this->sockets[$dc]->getConnection(); } /** * Get Connection instance asynchronously. * * @param string $dc DC ID * * * @psalm-return \Generator<int, \Amp\Promise, mixed, Connection> */ public function waitGetConnection(string $dc): \Generator { return $this->sockets[$dc]->waitGetConnection(); } /** * Get DataCenterConnection instance. * * @param string $dc DC ID * */ public function getDataCenterConnection(string $dc): DataCenterConnection { return $this->sockets[$dc]; } /** * Get all DataCenterConnection instances. * * @return array<int|string, DataCenterConnection> */ public function getDataCenterConnections(): array { return $this->sockets; } /** * Check if a DC is present. * * @param string $dc DC ID * * @return boolean */ public function has(string $dc): bool { return isset($this->sockets[$dc]); } /** * Check if connected to datacenter using HTTP. * * @param string $datacenter DC ID * * @return boolean */ public function isHttp(string $datacenter) { return $this->sockets[$datacenter]->isHttp(); } /** * Check if connected to datacenter directly using IP address. * * @param string $datacenter DC ID * * @return boolean */ public function byIPAddress(string $datacenter): bool { return $this->sockets[$datacenter]->byIPAddress(); } /** * Get all DC IDs. * * @param boolean $all Whether to get all possible DC IDs, or only connected ones * */ public function getDcs($all = true): array { $test = $this->settings->getTestMode() ? 'test' : 'main'; $ipv6 = $this->settings->getIpv6() ? 'ipv6' : 'ipv4'; return $all ? \array_keys((array) $this->dclist[$test][$ipv6]) : \array_keys((array) $this->sockets); } } <?php /** * Async constructor abstract class. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Async; use Amp\Promise; use danog\MadelineProto\Tools; /** * Async constructor class. * * Manages asynchronous construction and wakeup of classes * * @author Daniil Gentili <daniil@daniil.it> */ class AsyncConstruct { /** * Async init promise. * * @var Promise|\Generator|null|boolean */ private $asyncInitPromise; /** * Blockingly init. * */ public function init(): void { if ($this->asyncInitPromise) { Tools::wait($this->asyncInitPromise); $this->asyncInitPromise = null; } } /** * Asynchronously init. * */ public function initAsynchronously(): \Generator { if ($this->asyncInitPromise) { yield $this->asyncInitPromise; $this->asyncInitPromise = null; } } /** * Check if we've already inited. * * @return boolean */ public function inited(): bool { return !$this->asyncInitPromise; } /** * Mark instance as (de)inited forcefully. * * @param boolean $inited Whether to mark the instance as inited or deinited * */ public function forceInit(bool $inited): void { $this->asyncInitPromise = $inited ? null : true; } /** * Set init promise. * * @param Promise|\Generator $promise Promise * * @internal * */ public function setInitPromise($promise): void { $this->asyncInitPromise = Tools::call($promise); } } <?php /** * MTProto permanent auth key. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProto; /** * MTProto permanent auth key. */ class PermAuthKey extends AuthKey { /** * Whether this auth key is authorized (as in associated to an account on Telegram). * * @var boolean */ private $authorized = false; /** * Constructor function. * * @param array $old Old auth key array */ public function __construct(array $old = []) { parent::__construct($old); if (isset($old['authorized'])) { $this->authorized($old['authorized']); } } /** * Check if we are logged in. * * @return boolean */ public function isAuthorized(): bool { return $this->authorized; } /** * Set the authorized boolean. * * @param boolean $authorized Whether we are authorized * */ public function authorized(bool $authorized): void { $this->authorized = $authorized; } /** * JSON serialization function. * */ public function jsonSerialize(): array { return ['auth_key' => 'pony'.\base64_encode($this->authKey), 'server_salt' => $this->serverSalt, 'authorized' => $this->authorized]; } /** * Sleep function. * * @return array */ public function __sleep() { return ['authKey', 'id', 'serverSalt', 'authorized']; } } <?php /** * Outgoing message. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProto; use Amp\Deferred; use Amp\Loop; use Amp\Promise; use danog\MadelineProto\Exception; use danog\MadelineProto\MTProtoSession\MsgIdHandler; /** * Outgoing message. * * @internal */ class OutgoingMessage extends Message { /** * The message was created. */ const STATE_PENDING = 0; /** * The message was sent. */ const STATE_SENT = 1; /** * The message was acked. */ const STATE_ACKED = 2; /** * We got a reply to the message. */ const STATE_REPLIED = self::STATE_ACKED | 4; /** * State of message. * * @psalm-var self::STATE_* */ private int $state = self::STATE_PENDING; /** * Constructor name. */ private string $constructor; /** * Constructor type. */ private string $type; /** * Whether this is a method. */ private bool $method; /** * Resolution deferred. */ private ?Deferred $promise = null; /** * Send deferred. */ private ?Deferred $sendPromise = null; /** * Whether this is an unencrypted message. */ private bool $unencrypted; /** * Message body. * * @var \Generator|array|null */ private $body; /** * Serialized body. */ private ?string $serializedBody = null; /** * Whether this message is related to a user, as in getting a successful reply means we have auth. */ private bool $userRelated = false; /** * Whether this message is related to a file upload, as in getting a redirect should redirect to a media server. */ private bool $fileRelated = false; /** * Custom flood wait limit for this bot. */ private ?int $floodWaitLimit = null; /** * Whether we should try converting the result to a bot API object. */ private bool $botAPI = false; /** * Whether we should refresh references upon serialization of this message. */ private bool $refreshReferences = false; /** * Queue ID. */ private ?string $queueId = null; /** * When was this message sent. */ private int $sent = 0; /** * Number of times this message was sent. */ private int $tries = 0; /** * Create outgoing message. * * @param \Generator|array $body Body * @param string $constructor Constructor name * @param string $type Constructor type * @param boolean $method Is this a method? * @param boolean $unencrypted Is this an unencrypted message? */ public function __construct($body, string $constructor, string $type, bool $method, bool $unencrypted) { $this->body = $body; $this->constructor = $constructor; $this->type = $type; $this->method = $method; $this->unencrypted = $unencrypted; if ($method) { $this->promise = new Deferred; } $this->contentRelated = !isset(Message::NOT_CONTENT_RELATED[$constructor]); } /** * Signal that we're trying to send the message. * */ public function trySend(): void { if (!isset($this->sendPromise)) { $this->sendPromise = new Deferred; } $this->tries++; } /** * Signal that the message was sent. * */ public function sent(): void { if ($this->state & self::STATE_REPLIED) { //throw new Exception("Trying to resend already replied message $this!"); } $this->state |= self::STATE_SENT; $this->sent = \time(); if (isset($this->sendPromise)) { $sendPromise = $this->sendPromise; $this->sendPromise = null; $sendPromise->resolve($this->promise ?? true); } } /** * Set reply to message. * * @param Promise|mixed $result */ public function reply($result): void { if ($this->state & self::STATE_REPLIED) { throw new Exception("Trying to double reply to message $this!"); } $this->serializedBody = null; $this->body = null; $this->state |= self::STATE_REPLIED; if ($this->promise) { // Sometimes can get an RPC error for constructors $promise = $this->promise; $this->promise = null; Loop::defer(fn () => $promise->resolve($result)); } } /** * ACK message. * */ public function ack(): void { $this->state |= self::STATE_ACKED; } /** * Get state of message. * * @psalm-return self::STATE_* */ public function getState(): int { return $this->state; } /** * Get message body. * */ public function getBody(): \Generator { return $this->body instanceof \Generator ? yield from $this->body : $this->body; } /** * Get message body or empty array. * */ public function getBodyOrEmpty(): array { return \is_array($this->body) ? $this->body : []; } /** * Check if we have a body. * * @return boolean */ public function hasBody(): bool { return $this->body !== null; } /** * Get serialized body. * * @return ?string */ public function getSerializedBody(): ?string { return $this->serializedBody; } /** * Check if we have a serialized body. * * @return boolean */ public function hasSerializedBody(): bool { return $this->serializedBody !== null; } /** * Get number of times this message was sent. * */ public function getTries(): int { return $this->tries; } /** * Get constructor name. * */ public function getConstructor(): string { return $this->constructor; } /** * Get constructor type. * */ public function getType(): string { return $this->type; } /** * Get whether this is a method. * */ public function isMethod(): bool { return $this->method; } /** * Get whether this is an unencrypted message. * */ public function isUnencrypted(): bool { return $this->unencrypted; } /** * Get whether this is an encrypted message. * */ public function isEncrypted(): bool { return !$this->unencrypted; } /** * Get whether this message is related to a user, as in getting a successful reply means we have auth. * */ public function isUserRelated(): bool { return $this->userRelated; } /** * Get whether we should refresh references upon serialization of this message. * */ public function shouldRefreshReferences(): bool { return $this->refreshReferences; } /** * Get queue ID. * * @return ?string */ public function getQueueId(): ?string { return $this->queueId; } /** * Get whether we have a queue ID. * */ public function hasQueue(): bool { return $this->queueId !== null; } /** * Set serialized body. * * @param string $serializedBody Serialized body. * */ public function setSerializedBody(string $serializedBody): self { $this->serializedBody = $serializedBody; return $this; } /** * Set whether this message is related to a user, as in getting a successful reply means we have auth. * * @param bool $userRelated Whether this message is related to a user, as in getting a successful reply means we have auth. * */ public function setUserRelated(bool $userRelated): self { $this->userRelated = $userRelated; return $this; } /** * Set whether we should refresh references upon serialization of this message. * * @param bool $refreshReferences Whether we should refresh references upon serialization of this message. * */ public function setRefreshReferences(bool $refreshReferences): self { $this->refreshReferences = $refreshReferences; return $this; } /** * Set queue ID. * * @param ?string $queueId Queue ID. * */ public function setQueueId(?string $queueId): self { $this->queueId = $queueId; return $this; } /** * Get when was this message sent. * */ public function getSent(): int { return $this->sent; } /** * Check if the message was sent. * * @return boolean */ public function wasSent(): bool { return (bool) ($this->state & self::STATE_SENT); } /** * Check if can garbage collect this message. * * @return boolean */ public function canGarbageCollect(): bool { if ($this->state & self::STATE_REPLIED) { return true; } if (!$this->hasPromise()) { return true; } return false; } /** * For logging. * * @return string */ public function __toString() { if ($this->msgId) { $msgId = MsgIdHandler::toString($this->msgId); return "{$this->constructor} with message ID $msgId"; } return $this->constructor; } /** * Set resolution deferred. * * @param Deferred $promise Resolution deferred. * */ public function setPromise(Deferred $promise): self { $this->promise = $promise; return $this; } /** * Wait for message to be sent. * */ public function getSendPromise(): Promise { if (!$this->sendPromise) { throw new Exception("Message was already sent, can't get send promise!"); } return $this->sendPromise->promise(); } /** * Check if we have a promise. * */ public function hasPromise(): bool { return $this->promise !== null; } /** * Get promise. * */ public function getPromise(): Promise { return $this->promise->promise(); } /** * Reset sent time to trigger resending. * */ public function resetSent(): self { $this->sent = 0; return $this; } /** * Get whether we should try converting the result to a bot API object. * */ public function getBotAPI(): bool { return $this->botAPI; } /** * Set whether we should try converting the result to a bot API object. * * @param bool $botAPI Whether we should try converting the result to a bot API object * */ public function setBotAPI(bool $botAPI): self { $this->botAPI = $botAPI; return $this; } /** * Get whether this message is related to a file upload, as in getting a redirect should redirect to a media server. * */ public function isFileRelated(): bool { return $this->fileRelated; } /** * Set whether this message is related to a file upload, as in getting a redirect should redirect to a media server. * * @param bool $fileRelated Whether this message is related to a file upload, as in getting a redirect should redirect to a media server. * */ public function setFileRelated(bool $fileRelated): self { $this->fileRelated = $fileRelated; return $this; } /** * Get custom flood wait limit for this bot. * * @return ?int */ public function getFloodWaitLimit(): ?int { return $this->floodWaitLimit; } /** * Set custom flood wait limit for this bot. * * @param ?int $floodWaitLimit Custom flood wait limit for this bot * */ public function setFloodWaitLimit(?int $floodWaitLimit): self { $this->floodWaitLimit = $floodWaitLimit; return $this; } /** * Set when was this message sent. * * @param int $sent When was this message sent. * */ public function setSent(int $sent): self { $this->sent = $sent; return $this; } } <?php /** * Message. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProto; /** * MTProto message. * * @internal */ abstract class Message { public const NOT_CONTENT_RELATED = [ //'rpc_result' => true, //'rpc_error' => true, 'rpc_drop_answer' => true, 'rpc_answer_unknown' => true, 'rpc_answer_dropped_running' => true, 'rpc_answer_dropped' => true, 'get_future_salts' => true, 'future_salt' => true, 'future_salts' => true, 'ping' => true, 'pong' => true, 'ping_delay_disconnect' => true, 'destroy_session' => true, 'destroy_session_ok' => true, 'destroy_session_none' => true, //'new_session_created' => true, 'msg_container' => true, 'msg_copy' => true, 'gzip_packed' => true, 'http_wait' => true, 'msgs_ack' => true, 'bad_msg_notification' => true, 'bad_server_salt' => true, 'msgs_state_req' => true, 'msgs_state_info' => true, 'msgs_all_info' => true, 'msg_detailed_info' => true, 'msg_new_detailed_info' => true, 'msg_resend_req' => true, 'msg_resend_ans_req' => true, ]; /** * My message ID. */ protected $msgId = null; /** * Sequence number. */ protected ?int $seqNo = null; /** * Whether constructor is content related. */ protected bool $contentRelated; /** * Get whether constructor is content related. * */ public function isContentRelated(): bool { return $this->contentRelated; } /** * Get my message ID. * */ public function getMsgId() { return $this->msgId; } /** * Set my message ID. * * @param mixed $msgId My message ID * */ public function setMsgId($msgId): self { $this->msgId = $msgId; return $this; } /** * Check if we have a message ID. * * @return boolean */ public function hasMsgId(): bool { return $this->msgId !== null; } /** * Get sequence number. * * @return ?int */ public function getSeqNo(): ?int { return $this->seqNo; } /** * Has sequence number. * */ public function hasSeqNo(): bool { return isset($this->seqNo); } /** * Set sequence number. * * @param ?int $seqNo Sequence number * */ public function setSeqNo(?int $seqNo): self { $this->seqNo = $seqNo; return $this; } /** * Check whether this message can be garbage collected. * * @return boolean */ abstract public function canGarbageCollect(): bool; } <?php /** * Container message. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProto; /** * Outgoing container message. * * @internal */ class Container extends OutgoingMessage { /** * Message IDs. * */ private array $ids = []; /** * Constructor. * */ public function __construct(array $ids) { $this->ids = $ids; parent::__construct([], 'msg_container', '', false, false); } /** * Get message IDs. * */ public function getIds(): array { return $this->ids; } } <?php /** * Outgoing message. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProto; use Amp\Deferred; use Amp\Promise; use danog\MadelineProto\Tools; /** * Incoming message. * * @internal */ class IncomingMessage extends Message { /** * We have received this message. */ const STATE_RECEIVED = 4; /** * We have acknowledged this message. */ const STATE_ACKED = 8; /** * We have read the contents of this message. */ const STATE_READ = 128; /** * Response field map. */ private const RESPONSE_ID_MAP = [ 'rpc_result' => 'req_msg_id', 'future_salts' => 'req_msg_id', 'msgs_state_info' => 'req_msg_id', 'bad_server_salt' => 'bad_msg_id', 'bad_msg_notification' => 'bad_msg_id', 'pong' => 'msg_id', ]; /** * State. */ private int $state = self::STATE_RECEIVED; /** * Receive date. */ private int $received; /** * Deserialized response content. */ private array $content; /** * Was present in container. */ private bool $fromContainer; /** * DB side effects to be resolved before using the content. * * @var Promise[] */ private $sideEffects = []; /** * Constructor. * * @param array $content Content * @param boolean $fromContainer Whether this message was in a container */ public function __construct(array $content, string $msgId, bool $fromContainer = false) { $this->content = $content; $this->fromContainer = $fromContainer; $this->msgId = $msgId; $this->received = \time(); $this->contentRelated = !isset(Message::NOT_CONTENT_RELATED[$content['_']]); if (!$this->contentRelated) { $this->state |= 16; // message not requiring acknowledgment } } /** * Get deserialized response content. * */ public function getContent(): array { return $this->content; } /** * Get was present in container. * */ public function isFromContainer(): bool { return $this->fromContainer; } /** * Get log line. * * @param int|string $dc DC ID * */ public function log($dc): string { if ($this->fromContainer) { return "Inside of container, received {$this->content['_']} from DC $dc"; } return "Received {$this->content['_']} from DC $dc"; } /** * Get message type. * */ public function getType(): string { return $this->content['_']; } /** * Get message type. * */ public function __toString(): string { return $this->content['_']; } /** * We have acked this message. * */ public function ack(): void { $this->state |= self::STATE_ACKED; } /** * Read this message, clearing its contents. * */ public function read(): array { $this->state |= self::STATE_READ; $content = $this->content; $this->content = ['_' => $content['_']]; return $content; } /** * Check if this message can be garbage collected. * * @return boolean */ public function canGarbageCollect(): bool { return (bool) ($this->state & self::STATE_READ); } /** * Get ID of message to which this message replies. * */ public function getRequestId(): string { return $this->content[self::RESPONSE_ID_MAP[$this->content['_']]]; } /** * Get state. * */ public function getState(): int { return $this->state; } /** * Set DB side effects to be resolved before using the content. * * @param Promise[] $sideEffects DB side effects to be resolved before using the content * */ public function setSideEffects(array $sideEffects): self { $this->sideEffects = $sideEffects; return $this; } /** * Get DB side effects to be resolved before using the specified content. * * @template T * * @param T $return Return value * * @psalm-return ?Promise<T> */ public function getSideEffects($return): ?Promise { if (!$this->sideEffects) { return null; } $deferred = new Deferred; $result = $deferred->promise(); $pending = \count($this->sideEffects); foreach ($this->sideEffects as $promise) { $promise = Tools::call($promise); $promise->onResolve(function ($exception, $value) use (&$deferred, &$pending, $return): void { if ($pending === 0) { return; } if ($exception) { $pending = 0; $deferred->fail($exception); $deferred = null; return; } if (0 === --$pending) { $deferred->resolve($return); } }); } $this->sideEffects = []; return $result; } /** * Get receive date. * */ public function getReceived(): int { return $this->received; } } <?php /** * MTProto Auth key. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProto; use JsonSerializable; use Webmozart\Assert\Assert; /** * MTProto auth key. */ abstract class AuthKey implements JsonSerializable { /** * Auth key. * * @var ?string */ protected $authKey; /** * Auth key ID. * * @var ?string */ protected $id; /** * Server salt. * * @var ?string */ protected $serverSalt; /** * Constructor function. * * @param array $old Old auth key array */ public function __construct(array $old = []) { if (isset($old['auth_key'])) { if (\strlen($old['auth_key']) !== 2048 / 8 && \strpos($old['authkey'], 'pony') === 0) { $old['auth_key'] = \base64_decode(\substr($old['auth_key'], 4)); } $this->setAuthKey($old['auth_key']); } if (isset($old['server_salt'])) { $this->setServerSalt($old['server_salt']); } } /** * Set auth key. * * @param string $authKey Authorization key * */ public function setAuthKey(string $authKey): void { $this->authKey = $authKey; $this->id = \substr(\sha1($authKey, true), -8); } /** * Check if auth key is present. * * @return boolean */ public function hasAuthKey(): bool { return $this->authKey !== null && $this->serverSalt !== null; } /** * Get auth key. * */ public function getAuthKey(): string { Assert::notNull($this->authKey); return $this->authKey; } /** * Get auth key ID. * */ public function getID(): string { Assert::notNull($this->id); return $this->id; } /** * Set server salt. * * @param string $salt Server salt * */ public function setServerSalt(string $salt): void { $this->serverSalt = $salt; } /** * Get server salt. * */ public function getServerSalt(): string { Assert::notNull($this->serverSalt); return $this->serverSalt; } /** * Check if has server salt. * * @return boolean */ public function hasServerSalt(): bool { return $this->serverSalt !== null; } /** * Check if we are logged in. * * @return boolean */ abstract public function isAuthorized(): bool; /** * Set the authorized boolean. * * @param boolean $authorized Whether we are authorized * */ abstract public function authorized(bool $authorized): void; } <?php /** * MTProto temporary auth key. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProto; use JsonSerializable; /** * MTProto temporary auth key. */ class TempAuthKey extends AuthKey implements JsonSerializable { /** * Bound auth key instance. * * @var PermAuthKey|null */ private $bound; /** * Expiration date. * * @var int */ private $expires = 0; /** * Whether the connection is inited for this auth key. * * @var boolean */ protected $inited = false; /** * Constructor function. * * @param array $old Old auth key array */ public function __construct(array $old = []) { parent::__construct($old); if (isset($old['expires'])) { $this->expires($old['expires']); } if (isset($old['connection_inited']) && $old['connection_inited']) { $this->init($old['connection_inited']); } } /** * Init or deinit connection for auth key. * * @param boolean $init Init or deinit * */ public function init(bool $init = true): void { $this->inited = $init; } /** * Check if connection is inited for auth key. * * @return boolean */ public function isInited(): bool { return $this->inited; } /** * Bind auth key. * * @param PermAuthKey|null $bound Permanent auth key * @param bool $pfs Whether to bind using PFS * */ public function bind(?PermAuthKey $bound, bool $pfs = true): void { $this->bound = $bound; if (!$pfs) { foreach (['authKey', 'id', 'serverSalt'] as $key) { $this->{$key} =& $bound->{$key}; } } } /** * Check if auth key is bound. * * @return boolean */ public function isBound(): bool { return $this->bound !== null; } /** * Check if we are logged in. * * @return boolean */ public function isAuthorized(): bool { return $this->bound ? $this->bound->isAuthorized() : false; } /** * Set the authorized boolean. * * @param boolean $authorized Whether we are authorized * */ public function authorized(bool $authorized): void { $this->bound->authorized($authorized); } /** * Set expiration date of temporary auth key. * * @param integer $expires Expiration date * */ public function expires(int $expires): void { $this->expires = $expires; } /** * Check if auth key has expired. * * @return boolean */ public function expired(): bool { return \time() > $this->expires; } /** * JSON serialization function. * */ public function jsonSerialize(): array { return ['auth_key' => 'pony'.\base64_encode($this->authKey), 'server_salt' => $this->serverSalt, 'bound' => $this->isBound(), 'expires' => $this->expires, 'connection_inited' => $this->inited]; } /** * Sleep function. * * @return array */ public function __sleep() { return ['authKey', 'id', 'serverSalt', 'bound', 'expires', 'inited']; } /** * Wakeup function. * */ public function __wakeup(): void { $this->inited = (bool) $this->inited; } } <?php /** * IPC light state. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; /** * Light state. * * @internal */ final class LightState { /** * Event handler class name. * * @var null|class-string<EventHandler> */ private ?string $eventHandler = null; public function __construct(MTProto $API) { if ($API->hasEventHandler()) { $this->eventHandler = \get_class($API->getEventHandler()); } } /** * Check whether we can start IPC. * * @return boolean */ public function canStartIpc(): bool { return !$this->eventHandler || \class_exists($this->eventHandler); } /** * Get event handler class name. * * @return null|class-string<EventHandler> */ public function getEventHandler(): ?string { return $this->eventHandler; } } <?php /** * ApiStart module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\ApiWrappers; use danog\MadelineProto\Lang; use danog\MadelineProto\Magic; use danog\MadelineProto\MyTelegramOrgWrapper; use danog\MadelineProto\Settings; use danog\MadelineProto\Tools; use function Amp\ByteStream\getStdout; /** * Manages simple logging in and out. */ trait Start { /** * Start API ID generation process. * * @param Settings $settings Settings * */ private function APIStart(Settings $settings): \Generator { if (Magic::$isIpcWorker) { throw new \danog\MadelineProto\Exception('Not inited!'); } if ($this->getWebAPITemplate() === 'legacy') { $this->setWebAPITemplate($settings->getTemplates()->getHtmlTemplate()); } $app = null; if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') { $stdout = getStdout(); $prepare = Lang::$current_lang['apiChooseManualAuto'].PHP_EOL; $prepare .= \sprintf(Lang::$current_lang['apiChooseManualAutoTip'], 'https://docs.madelineproto.xyz/docs/SETTINGS.html'); $prepare .= PHP_EOL; yield $stdout->write($prepare); if (\strpos(yield Tools::readLine(Lang::$current_lang['apiChoosePrompt']), 'm') !== false) { yield $stdout->write("1) ".Lang::$current_lang['apiManualInstructions0'].PHP_EOL); yield $stdout->write("2) ".Lang::$current_lang['apiManualInstructions1'].PHP_EOL); yield $stdout->write("3) "); foreach (['App title', 'Short name', 'URL', 'Platform', 'Description'] as $k => $key) { yield $stdout->write($k ? " $key: " : "$key: "); yield $stdout->write(Lang::$current_lang["apiAppInstructionsManual$k"].PHP_EOL); } yield $stdout->write("4) ".Lang::$current_lang['apiManualInstructions2'].PHP_EOL); $app['api_id'] = yield Tools::readLine("5) ".Lang::$current_lang['apiManualPrompt0']); $app['api_hash'] = yield Tools::readLine("6) ".Lang::$current_lang['apiManualPrompt1']); return $app; } $this->myTelegramOrgWrapper = new \danog\MadelineProto\MyTelegramOrgWrapper($settings); yield from $this->myTelegramOrgWrapper->login(yield Tools::readLine(Lang::$current_lang['apiAutoPrompt0'])); yield from $this->myTelegramOrgWrapper->completeLogin(yield Tools::readLine(Lang::$current_lang['apiAutoPrompt1'])); if (!(yield from $this->myTelegramOrgWrapper->hasApp())) { $app_title = yield Tools::readLine(Lang::$current_lang['apiAppInstructionsAuto0']); $short_name = yield Tools::readLine(Lang::$current_lang['apiAppInstructionsAuto1']); $url = yield Tools::readLine(Lang::$current_lang['apiAppInstructionsAuto2']); $description = yield Tools::readLine(Lang::$current_lang['apiAppInstructionsAuto4']); $app = (yield from $this->myTelegramOrgWrapper->createApp(['app_title' => $app_title, 'app_shortname' => $short_name, 'app_url' => $url, 'app_platform' => 'web', 'app_desc' => $description])); } else { $app = (yield from $this->myTelegramOrgWrapper->getApp()); } return $app; } $this->gettingApiId = true; if (!isset($this->myTelegramOrgWrapper)) { if (isset($_POST['api_id']) && isset($_POST['api_hash'])) { $app['api_id'] = (int) $_POST['api_id']; $app['api_hash'] = $_POST['api_hash']; $this->gettingApiId = false; return $app; } elseif (isset($_POST['phone_number'])) { yield from $this->webAPIPhoneLogin($settings); } else { yield $this->webAPIEcho(); } } elseif (!$this->myTelegramOrgWrapper->loggedIn()) { if (isset($_POST['code'])) { yield from $this->webAPICompleteLogin(); if (yield from $this->myTelegramOrgWrapper->hasApp()) { return yield from $this->myTelegramOrgWrapper->getApp(); } yield $this->webAPIEcho(); } elseif (isset($_POST['api_id']) && isset($_POST['api_hash'])) { $app['api_id'] = (int) $_POST['api_id']; $app['api_hash'] = $_POST['api_hash']; $this->gettingApiId = false; return $app; } elseif (isset($_POST['phone_number'])) { yield from $this->webAPIPhoneLogin($settings); } else { $this->myTelegramOrgWrapper = null; yield $this->webAPIEcho(); } } else { if (isset($_POST['app_title'], $_POST['app_shortname'], $_POST['app_url'], $_POST['app_platform'], $_POST['app_desc'])) { $app = (yield from $this->webAPICreateApp()); $this->gettingApiId = false; return $app; } yield $this->webAPIEcho(Lang::$current_lang['apiParamsError']); } return null; } private function webAPIPhoneLogin(Settings $settings): \Generator { try { $this->myTelegramOrgWrapper = new MyTelegramOrgWrapper($settings); yield from $this->myTelegramOrgWrapper->login($_POST['phone_number']); yield $this->webAPIEcho(); } catch (\Throwable $e) { yield $this->webAPIEcho(\sprintf(Lang::$current_lang['apiError'], 'Please use manual mode: '.$e->getMessage())); } } private function webAPICompleteLogin(): \Generator { try { yield from $this->myTelegramOrgWrapper->completeLogin($_POST['code']); } catch (\danog\MadelineProto\RPCErrorException $e) { yield $this->webAPIEcho(\sprintf(Lang::$current_lang['apiError'], 'Please use manual mode: '.$e->getMessage())); } catch (\danog\MadelineProto\Exception $e) { yield $this->webAPIEcho(\sprintf(Lang::$current_lang['apiError'], 'Please use manual mode: '.$e->getMessage())); } } private function webAPICreateApp(): \Generator { try { $params = $_POST; unset($params['creating_app']); $app = (yield from $this->myTelegramOrgWrapper->createApp($params)); return $app; } catch (\danog\MadelineProto\RPCErrorException $e) { yield $this->webAPIEcho(\sprintf(Lang::$current_lang['apiError'], 'Please use manual mode: '.$e->getMessage())); } catch (\danog\MadelineProto\Exception $e) { yield $this->webAPIEcho(\sprintf(Lang::$current_lang['apiError'], 'Please use manual mode: '.$e->getMessage())); } } } <?php /** * ApiTemplates module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\ApiWrappers; use Amp\Promise; use danog\MadelineProto\Lang; use function Amp\ByteStream\getOutputBufferStream; trait Templates { /** * API template. * * @var string */ private $webApiTemplate = 'legacy'; /** * Generate page from template. * * @param string $message Message * @param string $form Form * */ private function webAPIEchoTemplate(string $message, string $form): string { return \sprintf($this->webApiTemplate, $message, $form, Lang::$current_lang['go']); } /** * Get web API login HTML template string. * */ public function getWebAPITemplate(): string { return $this->webApiTemplate; } /** * Set web API login HTML template string. * */ public function setWebAPITemplate(string $template): void { $this->webApiTemplate = $template; } /** * Echo to browser. * * @param string $message Message to echo * */ private function webAPIEcho(string $message = ''): Promise { $message = \htmlentities($message); if (!isset($this->myTelegramOrgWrapper)) { if (isset($_POST['type'])) { if ($_POST['type'] === 'manual') { $title = \htmlentities(Lang::$current_lang['apiManualWeb']); $title .= "<br><b>$message</b>"; $title .= "<ol>"; $title .= "<li>".\str_replace('https://my.telegram.org', '<a href="https://my.telegram.org" target="_blank">https://my.telegram.org</a>', \htmlentities(Lang::$current_lang['apiManualInstructions0']))."</li>"; $title .= "<li>".\htmlentities(Lang::$current_lang['apiManualInstructions1'])."</li>"; $title .= "<li><ul>"; foreach (['App title', 'Short name', 'URL', 'Platform', 'Description'] as $k => $key) { $title .= "<li>$key: "; $title .= \htmlentities(Lang::$current_lang["apiAppInstructionsManual$k"]); $title .= "</li>"; } $title .= "</li></ul>"; $title .= "<li>".\htmlentities(Lang::$current_lang['apiManualInstructions2'])."</li>"; $title .= "</ol>"; $form = '<input type="string" name="api_id" placeholder="API ID" required/>'; $form .= '<input type="string" name="api_hash" placeholder="API hash" required/>'; } else { $title = Lang::$current_lang['apiAutoWeb']; $title .= "<br><b>$message</b>"; $phone = \htmlentities(Lang::$current_lang['loginUserPhoneWeb']); $form = "<input type='text' name='phone_number' placeholder='$phone' required/>"; } } else { if ($message) { $message = '<br><br>'.$message; } $title = \htmlentities(Lang::$current_lang['apiChooseManualAutoWeb']); $title .= "<br>"; $title .= \sprintf(Lang::$current_lang['apiChooseManualAutoTipWeb'], 'https://docs.madelineproto.xyz/docs/SETTINGS.html'); $title .= "<b>$message</b>"; $automatically = \htmlentities(Lang::$current_lang['apiChooseAutomaticallyWeb']); $manually = \htmlentities(Lang::$current_lang['apiChooseManuallyWeb']); $form = "<select name='type'><option value='automatic'>$automatically</option><option value='manual'>$manually</option></select>"; } } else { if (!$this->myTelegramOrgWrapper->loggedIn()) { $title = \htmlentities(Lang::$current_lang['loginUserCode']); $title .= "<br><b>$message</b>"; $code = \htmlentities(Lang::$current_lang['loginUserPhoneCodeWeb']); $form = "<input type='text' name='code' placeholder='$code' required/>"; } else { $title = \htmlentities(Lang::$current_lang['apiAppWeb']); $title .= "<br><b>$message</b>"; $form = '<input type="hidden" name="creating_app" value="yes" required/>'; foreach (['app_title', 'app_shortname', 'app_url', 'app_platform', 'app_desc'] as $k => $field) { $desc = \htmlentities(Lang::$current_lang["apiAppInstructionsAuto$k"]); if ($field == 'app_platform') { $form .= "$desc<br>"; foreach ([ 'android' => 'Android', 'ios' => 'iOS', 'wp' => 'Windows Phone', 'bb' => 'BlackBerry', 'desktop' => 'Desktop', 'web' => 'Web', 'ubp' => 'Ubuntu phone', 'other' => \htmlentities(Lang::$current_lang['apiAppInstructionsAutoTypeOther']) ] as $key => $desc) { $form .= "<label><input type='radio' name='app_platform' value='$key' checked> $desc</label>"; } } elseif ($field === 'app_desc') { $form .= "$desc<br><textarea name='$field' required></textarea><br><br>"; } else { $form .= "$desc<br><input type='text' name='$field' required/><br><br>"; } } } } return getOutputBufferStream()->write($this->webAPIEchoTemplate($title, $form)); } } <?php namespace danog\MadelineProto; use ReflectionClass; use ReflectionProperty; abstract class SettingsAbstract { /** * Whether this setting was changed. * * @var boolean */ protected $changed = true; /** * Merge legacy settings array. * * @param array $settings Settings array * * @internal * */ public function mergeArray(array $settings): void { } /** * Merge with other settings instance. * * * @internal * */ public function merge(self $other): void { $class = new ReflectionClass($other); $defaults = $class->getDefaultProperties(); foreach ($class->getProperties(ReflectionProperty::IS_PROTECTED|ReflectionProperty::IS_PUBLIC) as $property) { $name = $property->getName(); if ($name === 'changed') { continue; } $uc = \ucfirst($name); if (isset($other->{$name}) && ( !isset($defaults[$name]) || ( $other->{$name} !== $defaults[$name] // Isn't equal to the default value || $other->{$name} !== $this->{$name} // Is equal, but current value is not the default one ) ) && ( !isset($this->{$name}) || $other->{$name} !== $this->{$name} ) ) { $this->{"set$uc"}($other->{$name}); $this->changed = true; } } } /** * Convert array of legacy array property names to new camel case names. * * @param array $properties Properties * */ protected static function toCamel(array $properties): array { $result = []; foreach ($properties as $prop) { $result['set'.\ucfirst(Tools::toCamelCase($prop))] = $prop; } return $result; } /** * Get whether this setting was changed, also applies changes. * * @internal * * @return boolean */ public function hasChanged(): bool { return $this->changed; } /** * Apply changes. * * @internal * * @return static */ public function applyChanges(): self { $this->changed = false; return $this; } /** * @deprecated * * @return static */ public function __call(string $name, array $arguments): mixed { return $this; } } <?php /** * Coroutine (modified version of AMP Coroutine). * * The MIT License (MIT) * * 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. * * @copyright 2015-2018 amphp * @copyright 2016 PHP Asynchronous Interoperability Group * @license https://opensource.org/licenses/MIT MIT */ namespace danog\MadelineProto; use Amp\Failure; use Amp\Internal; use Amp\Promise; use Amp\Success; use JsonSerializable; use ReflectionGenerator; /** * Creates a promise from a generator function yielding promises. * * When a promise is yielded, execution of the generator is interrupted until the promise is resolved. A success * value is sent into the generator, while a failure reason is thrown into the generator. Using a coroutine, * asynchronous code can be written without callbacks and be structured like synchronous code. */ final class Coroutine implements Promise, \ArrayAccess, JsonSerializable { use Internal\Placeholder { fail as internalFail; } /** @var \Generator */ private $generator; /** @var callable(\Throwable|null $exception, mixed $value): void */ private $onResolve; /** @var bool Used to control iterative coroutine continuation. */ private $immediate = true; /** @var \Throwable|null Promise failure reason when executing next coroutine step, null at all other times. */ private $exception; /** @var mixed Promise success value when executing next coroutine step, null at all other times. */ private $value; /** @var ?self Reference to coroutine that started this coroutine */ private $parentCoroutine; public function __construct(\Generator $generator) { $this->generator = $generator; try { $yielded = $this->generator->current(); while (!$yielded instanceof Promise) { if (!$this->generator->valid()) { if (PHP_MAJOR_VERSION >= 7) { $this->resolve($this->generator->getReturn()); } else { $this->resolve(null); } return; } if ($yielded instanceof \Generator) { $yielded = new self($yielded); } else { $yielded = $this->generator->send($yielded); } } if ($yielded instanceof self) { $yielded->parentCoroutine = $this; } } catch (\Throwable $exception) { $this->fail($exception); return; } /* * @param \Throwable|null $exception Exception to be thrown into the generator. * @param mixed $value Value to be sent into the generator. */ $this->onResolve = function ($exception, $value): void { $this->exception = $exception; $this->value = $value; if (!$this->immediate) { $this->immediate = true; return; } try { do { if ($this->exception) { // Throw exception at current execution point. $yielded = $this->throw($this->exception); } else { // Send the new value and execute to next yield statement. $yielded = $this->generator->send($this->value); } while (!$yielded instanceof Promise) { if (!$this->generator->valid()) { if (PHP_MAJOR_VERSION >= 7) { $this->resolve($this->generator->getReturn()); } else { $this->resolve(null); } $this->onResolve = null; return; } if ($yielded instanceof \Generator) { $yielded = new self($yielded); } else { $yielded = $this->generator->send($yielded); } } if ($yielded instanceof self) { $yielded->parentCoroutine = $this; } $this->immediate = false; $yielded->onResolve($this->onResolve); } while ($this->immediate); $this->immediate = true; } catch (\Throwable $exception) { $this->fail($exception); $this->onResolve = null; } finally { $this->exception = null; $this->value = null; } }; $yielded->onResolve($this->onResolve); } /** * Throw exception into the generator. * * @param \Throwable $reason Exception * * @internal * */ public function throw(\Throwable $reason) { if (\method_exists($reason, 'updateTLTrace')) { $reason->updateTLTrace($this->getTrace()); } return $this->generator->throw($reason); } /** * @param \Throwable $reason Failure reason. * */ public function fail(\Throwable $reason): void { $this->resolve(new Failure($reason)); } public function offsetExists(mixed $offset): bool { throw new Exception('isset is not supported, please yield the entire Coroutine first!'); } /** * Get data at an array offset asynchronously. * * @param mixed $offset Offset * */ public function offsetGet(mixed $offset): Promise { return Tools::call((function () use ($offset): \Generator { $result = yield $this; return $result[$offset]; })()); } #[\ReturnTypeWillChange] public function offsetSet(mixed $offset, mixed $value): Promise { return Tools::call((function () use ($offset, $value): \Generator { $result = yield $this; if ($offset === null) { return $result[] = $value; } return $result[$offset] = $value; })()); } #[\ReturnTypeWillChange] public function offsetUnset(mixed $offset): Promise { return Tools::call((function () use ($offset): \Generator { $result = yield $this; unset($result[$offset]); })()); } /** * Get an attribute asynchronously. * * @param string $offset Offset * * @return Promise */ public function __get(string $offset) { return Tools::call((function () use ($offset): \Generator { $result = yield $this; return $result->{$offset}; })()); } public function __call(string $name, array $arguments) { return Tools::call((function () use ($name, $arguments): \Generator { $result = yield $this; return $result->{$name}(...$arguments); })()); } /** * Get current stack trace for running coroutine. * */ public function getTrace(): array { $frames = []; try { $reflector = new ReflectionGenerator($this->generator); $frames = $reflector->getTrace(); $frames[] = \array_merge($this->parentCoroutine ? $this->parentCoroutine->getFrame() : [], ['function' => $reflector->getFunction()->getName(), 'args' => []]); } catch (\Throwable $e) { } if ($this->parentCoroutine) { $frames = \array_merge($frames, $this->parentCoroutine->getTrace()); } return $frames; } /** * Get current execution frame. * */ public function getFrame(): array { try { $reflector = new ReflectionGenerator($this->generator); return ['file' => $reflector->getExecutingFile(), 'line' => $reflector->getExecutingLine()]; } catch (\Throwable $e) { } return []; } private const WARNING = 'To obtain a result from a Coroutine object, yield the result or disable async (not recommended). See https://docs.madelineproto.xyz/docs/ASYNC.html for more information on async.'; public function __debugInfo() { return [self::WARNING]; } /** * Obtain. * */ public function jsonSerialize(): string { return self::WARNING; } } <?php /** * VoIPServerConfig. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; if (\class_exists(VoIPServerConfig::class)) { return; } /** * Manages storage of VoIP server config. */ class VoIPServerConfig { /** * The configuration. * * @var array */ private static $_config = []; /** * The default configuration. * * @var array */ private static $_configDefault = []; /** * Update shared call settings. * * @param array $config The settings * */ public static function update(array $config): void { self::$_config = $config; } /** * Get shared call settings. * * @return array The settings */ public static function get(): array { return self::$_config; } /** * Update default shared call settings. * * @param array $configDefault The settings * */ public static function updateDefault(array $configDefault): void { self::$_configDefault = $configDefault; } /** * Get default shared call settings. * * @return array The settings */ public static function getDefault(): array { return self::$_configDefault; } /** * Get final settings. * */ public static function getFinal(): array { return \array_merge(self::$_configDefault, self::$_config); } } <?php /** * AuthKeyHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\SecretChats; use danog\MadelineProto\Loop\Update\SecretFeedLoop; use danog\MadelineProto\Loop\Update\UpdateLoop; use danog\MadelineProto\MTProto; use danog\MadelineProto\MTProtoTools\Crypt; /** * Manages secret chats. * * https://core.telegram.org/api/end-to-end */ trait AuthKeyHandler { /** * Temporary requested secret chats. * * @var array */ protected $temp_requested_secret_chats = []; /** * Secret chats. * * @var array */ protected $secret_chats = []; /** * Accept secret chat. * * @param array $params Secret chat ID * */ public function acceptSecretChat($params): \Generator { //$this->logger->logger($params['id'],$this->secretChatStatus($params['id'])); if ($this->secretChatStatus($params['id']) !== 0) { //$this->logger->logger($this->secretChatStatus($params['id'])); $this->logger->logger("I've already accepted secret chat ".$params['id']); return false; } $dh_config = (yield from $this->getDhConfig()); $this->logger->logger('Generating b...', \danog\MadelineProto\Logger::VERBOSE); $b = new \phpseclib3\Math\BigInteger(\danog\MadelineProto\Tools::random(256), 256); $params['g_a'] = new \phpseclib3\Math\BigInteger((string) $params['g_a'], 256); Crypt::checkG($params['g_a'], $dh_config['p']); $key = ['auth_key' => \str_pad($params['g_a']->powMod($b, $dh_config['p'])->toBytes(), 256, \chr(0), \STR_PAD_LEFT)]; //$this->logger->logger($key); $key['fingerprint'] = \substr(\sha1($key['auth_key'], true), -8); $key['visualization_orig'] = \substr(\sha1($key['auth_key'], true), 16); $key['visualization_46'] = \substr(\hash('sha256', $key['auth_key'], true), 20); $this->secret_chats[$params['id']] = [ 'key' => $key, 'admin' => false, 'user_id' => $params['admin_id'], 'InputEncryptedChat' => [ '_' => 'inputEncryptedChat', 'chat_id' => $params['id'], 'access_hash' => $params['access_hash'] ], 'in_seq_no_x' => 1, 'out_seq_no_x' => 0, 'in_seq_no' => 0, 'out_seq_no' => 0, 'layer' => 8, 'ttl' => 0, 'ttr' => 100, 'updated' => \time(), 'incoming' => [], 'outgoing' => [], 'created' => \time(), 'rekeying' => [0], 'key_x' => 'from server', 'mtproto' => 1 ]; $this->secretFeeders[$params['id']] = new SecretFeedLoop($this, $params['id']); $this->secretFeeders[$params['id']]->start(); $this->secretFeeders[$params['id']]->resume(); $g_b = $dh_config['g']->powMod($b, $dh_config['p']); Crypt::checkG($g_b, $dh_config['p']); yield from $this->methodCallAsyncRead('messages.acceptEncryption', ['peer' => $params['id'], 'g_b' => $g_b->toBytes(), 'key_fingerprint' => $key['fingerprint']]); yield from $this->notifyLayer($params['id']); $this->logger->logger('Secret chat '.$params['id'].' accepted successfully!', \danog\MadelineProto\Logger::NOTICE); } /** * Request secret chat. * * @param mixed $user User to start secret chat with * */ public function requestSecretChat($user): \Generator { $user = (yield from $this->getInfo($user)); if (!isset($user['InputUser'])) { throw new \danog\MadelineProto\Exception('This peer is not present in the internal peer database'); } $user = $user['InputUser']; $this->logger->logger('Creating secret chat with '.$user['user_id'].'...', \danog\MadelineProto\Logger::VERBOSE); $dh_config = (yield from $this->getDhConfig()); $this->logger->logger('Generating a...', \danog\MadelineProto\Logger::VERBOSE); $a = new \phpseclib3\Math\BigInteger(\danog\MadelineProto\Tools::random(256), 256); $this->logger->logger('Generating g_a...', \danog\MadelineProto\Logger::VERBOSE); $g_a = $dh_config['g']->powMod($a, $dh_config['p']); Crypt::checkG($g_a, $dh_config['p']); $res = yield from $this->methodCallAsyncRead('messages.requestEncryption', ['user_id' => $user, 'g_a' => $g_a->toBytes()]); $this->temp_requested_secret_chats[$res['id']] = $a; $this->updaters[UpdateLoop::GENERIC]->resume(); $this->logger->logger('Secret chat '.$res['id'].' requested successfully!', \danog\MadelineProto\Logger::NOTICE); return $res['id']; } /** * Complete secret chat. * * @param array $params Secret chat * */ private function completeSecretChat(array $params): \Generator { if ($this->secretChatStatus($params['id']) !== 1) { //$this->logger->logger($this->secretChatStatus($params['id'])); $this->logger->logger('Could not find and complete secret chat '.$params['id']); return false; } $dh_config = (yield from $this->getDhConfig()); $params['g_a_or_b'] = new \phpseclib3\Math\BigInteger((string) $params['g_a_or_b'], 256); Crypt::checkG($params['g_a_or_b'], $dh_config['p']); $key = ['auth_key' => \str_pad($params['g_a_or_b']->powMod($this->temp_requested_secret_chats[$params['id']], $dh_config['p'])->toBytes(), 256, \chr(0), \STR_PAD_LEFT)]; unset($this->temp_requested_secret_chats[$params['id']]); $key['fingerprint'] = \substr(\sha1($key['auth_key'], true), -8); //$this->logger->logger($key); if ($key['fingerprint'] !== $params['key_fingerprint']) { yield from $this->discardSecretChat($params['id']); throw new \danog\MadelineProto\SecurityException('Invalid key fingerprint!'); } $key['visualization_orig'] = \substr(\sha1($key['auth_key'], true), 16); $key['visualization_46'] = \substr(\hash('sha256', $key['auth_key'], true), 20); $this->secret_chats[$params['id']] = ['key' => $key, 'admin' => true, 'user_id' => $params['participant_id'], 'InputEncryptedChat' => ['chat_id' => $params['id'], 'access_hash' => $params['access_hash'], '_' => 'inputEncryptedChat'], 'in_seq_no_x' => 0, 'out_seq_no_x' => 1, 'in_seq_no' => 0, 'out_seq_no' => 0, 'layer' => 8, 'ttl' => 0, 'ttr' => 100, 'updated' => \time(), 'incoming' => [], 'outgoing' => [], 'created' => \time(), 'rekeying' => [0], 'key_x' => 'to server', 'mtproto' => 1]; $this->secretFeeders[$params['id']] = new SecretFeedLoop($this, $params['id']); $this->secretFeeders[$params['id']]->start(); $this->secretFeeders[$params['id']]->resume(); yield from $this->notifyLayer($params['id']); $this->logger->logger('Secret chat '.$params['id'].' completed successfully!', \danog\MadelineProto\Logger::NOTICE); } private function notifyLayer($chat): \Generator { yield from $this->methodCallAsyncRead('messages.sendEncryptedService', ['peer' => $chat, 'message' => ['_' => 'decryptedMessageService', 'action' => ['_' => 'decryptedMessageActionNotifyLayer', 'layer' => $this->TL->getSecretLayer()]]]); } /** * Temporary rekeyed secret chats. * * @var array */ protected $temp_rekeyed_secret_chats = []; /** * Rekey secret chat. * * @param int $chat Secret chat to rekey * */ public function rekey(int $chat): \Generator { if ($this->secret_chats[$chat]['rekeying'][0] !== 0) { return; } $this->logger->logger('Rekeying secret chat '.$chat.'...', \danog\MadelineProto\Logger::VERBOSE); $dh_config = (yield from $this->getDhConfig()); $this->logger->logger('Generating a...', \danog\MadelineProto\Logger::VERBOSE); $a = new \phpseclib3\Math\BigInteger(\danog\MadelineProto\Tools::random(256), 256); $this->logger->logger('Generating g_a...', \danog\MadelineProto\Logger::VERBOSE); $g_a = $dh_config['g']->powMod($a, $dh_config['p']); Crypt::checkG($g_a, $dh_config['p']); $e = \danog\MadelineProto\Tools::random(8); $this->temp_rekeyed_secret_chats[$e] = $a; $this->secret_chats[$chat]['rekeying'] = [1, $e]; yield from $this->methodCallAsyncRead('messages.sendEncryptedService', ['peer' => $chat, 'message' => ['_' => 'decryptedMessageService', 'action' => ['_' => 'decryptedMessageActionRequestKey', 'g_a' => $g_a->toBytes(), 'exchange_id' => $e]]]); $this->updaters[UpdateLoop::GENERIC]->resume(); return $e; } /** * Accept rekeying. * * @param int $chat Chat * @param array $params Parameters * */ private function acceptRekey(int $chat, array $params): \Generator { if ($this->secret_chats[$chat]['rekeying'][0] !== 0) { $my_exchange_id = new \phpseclib3\Math\BigInteger($this->secret_chats[$chat]['rekeying'][1], -256); $other_exchange_id = new \phpseclib3\Math\BigInteger($params['exchange_id'], -256); //$this->logger->logger($my, $params); if ($my_exchange_id->compare($other_exchange_id) > 0) { return; } if ($my_exchange_id->compare($other_exchange_id) === 0) { $this->secret_chats[$chat]['rekeying'] = [0]; return; } } $this->logger->logger('Accepting rekeying of secret chat '.$chat.'...', \danog\MadelineProto\Logger::VERBOSE); $dh_config = (yield from $this->getDhConfig()); $this->logger->logger('Generating b...', \danog\MadelineProto\Logger::VERBOSE); $b = new \phpseclib3\Math\BigInteger(\danog\MadelineProto\Tools::random(256), 256); $params['g_a'] = new \phpseclib3\Math\BigInteger((string) $params['g_a'], 256); Crypt::checkG($params['g_a'], $dh_config['p']); $key = ['auth_key' => \str_pad($params['g_a']->powMod($b, $dh_config['p'])->toBytes(), 256, \chr(0), \STR_PAD_LEFT)]; $key['fingerprint'] = \substr(\sha1($key['auth_key'], true), -8); $key['visualization_orig'] = $this->secret_chats[$chat]['key']['visualization_orig']; $key['visualization_46'] = \substr(\hash('sha256', $key['auth_key'], true), 20); $this->temp_rekeyed_secret_chats[$params['exchange_id']] = $key; $this->secret_chats[$chat]['rekeying'] = [2, $params['exchange_id']]; $g_b = $dh_config['g']->powMod($b, $dh_config['p']); Crypt::checkG($g_b, $dh_config['p']); yield from $this->methodCallAsyncRead('messages.sendEncryptedService', ['peer' => $chat, 'message' => ['_' => 'decryptedMessageService', 'action' => ['_' => 'decryptedMessageActionAcceptKey', 'g_b' => $g_b->toBytes(), 'exchange_id' => $params['exchange_id'], 'key_fingerprint' => $key['fingerprint']]]]); $this->updaters[UpdateLoop::GENERIC]->resume(); } /** * Commit rekeying of secret chat. * * @param int $chat Chat * @param array $params Parameters * */ private function commitRekey(int $chat, array $params): \Generator { if ($this->secret_chats[$chat]['rekeying'][0] !== 1 || !isset($this->temp_rekeyed_secret_chats[$params['exchange_id']])) { $this->secret_chats[$chat]['rekeying'] = [0]; return; } $this->logger->logger('Committing rekeying of secret chat '.$chat.'...', \danog\MadelineProto\Logger::VERBOSE); $dh_config = (yield from $this->getDhConfig()); $params['g_b'] = new \phpseclib3\Math\BigInteger((string) $params['g_b'], 256); Crypt::checkG($params['g_b'], $dh_config['p']); $key = ['auth_key' => \str_pad($params['g_b']->powMod($this->temp_rekeyed_secret_chats[$params['exchange_id']], $dh_config['p'])->toBytes(), 256, \chr(0), \STR_PAD_LEFT)]; $key['fingerprint'] = \substr(\sha1($key['auth_key'], true), -8); $key['visualization_orig'] = $this->secret_chats[$chat]['key']['visualization_orig']; $key['visualization_46'] = \substr(\hash('sha256', $key['auth_key'], true), 20); if ($key['fingerprint'] !== $params['key_fingerprint']) { yield from $this->methodCallAsyncRead('messages.sendEncryptedService', ['peer' => $chat, 'message' => ['_' => 'decryptedMessageService', 'action' => ['_' => 'decryptedMessageActionAbortKey', 'exchange_id' => $params['exchange_id']]]]); throw new \danog\MadelineProto\SecurityException('Invalid key fingerprint!'); } yield from $this->methodCallAsyncRead('messages.sendEncryptedService', ['peer' => $chat, 'message' => ['_' => 'decryptedMessageService', 'action' => ['_' => 'decryptedMessageActionCommitKey', 'exchange_id' => $params['exchange_id'], 'key_fingerprint' => $key['fingerprint']]]]); unset($this->temp_rekeyed_secret_chats[$params['exchange_id']]); $this->secret_chats[$chat]['rekeying'] = [0]; $this->secret_chats[$chat]['old_key'] = $this->secret_chats[$chat]['key']; $this->secret_chats[$chat]['key'] = $key; $this->secret_chats[$chat]['ttr'] = 100; $this->secret_chats[$chat]['updated'] = \time(); $this->updaters[UpdateLoop::GENERIC]->resume(); } /** * Complete rekeying. * * @param int $chat Chat * @param array $params Parameters * */ private function completeRekey(int $chat, array $params): \Generator { if ($this->secret_chats[$chat]['rekeying'][0] !== 2 || !isset($this->temp_rekeyed_secret_chats[$params['exchange_id']]['fingerprint'])) { return; } if ($this->temp_rekeyed_secret_chats[$params['exchange_id']]['fingerprint'] !== $params['key_fingerprint']) { yield from $this->methodCallAsyncRead('messages.sendEncryptedService', ['peer' => $chat, 'message' => ['_' => 'decryptedMessageService', 'action' => ['_' => 'decryptedMessageActionAbortKey', 'exchange_id' => $params['exchange_id']]]]); throw new \danog\MadelineProto\SecurityException('Invalid key fingerprint!'); } $this->logger->logger('Completing rekeying of secret chat '.$chat.'...', \danog\MadelineProto\Logger::VERBOSE); $this->secret_chats[$chat]['rekeying'] = [0]; $this->secret_chats[$chat]['old_key'] = $this->secret_chats[$chat]['key']; $this->secret_chats[$chat]['key'] = $this->temp_rekeyed_secret_chats[$params['exchange_id']]; $this->secret_chats[$chat]['ttr'] = 100; $this->secret_chats[$chat]['updated'] = \time(); unset($this->temp_rekeyed_secret_chats[$params['exchange_id']]); yield from $this->methodCallAsyncRead('messages.sendEncryptedService', ['peer' => $chat, 'message' => ['_' => 'decryptedMessageService', 'action' => ['_' => 'decryptedMessageActionNoop']]]); $this->logger->logger('Secret chat '.$chat.' rekeyed successfully!', \danog\MadelineProto\Logger::VERBOSE); return true; } /** * Get secret chat status. * * @param int $chat Chat ID * * @return int One of MTProto::SECRET_EMPTY, MTProto::SECRET_REQUESTED, MTProto::SECRET_READY */ public function secretChatStatus(int $chat): int { if (isset($this->secret_chats[$chat])) { return MTProto::SECRET_READY; } if (isset($this->temp_requested_secret_chats[$chat])) { return MTProto::SECRET_REQUESTED; } return MTProto::SECRET_EMPTY; } /** * Get secret chat. * * @param array|int $chat Secret chat ID * */ public function getSecretChat($chat): array { return $this->secret_chats[\is_array($chat) ? $chat['chat_id'] : $chat]; } /** * Check whether secret chat exists. * * @param array|int $chat Secret chat ID * * @return boolean */ public function hasSecretChat($chat): bool { return isset($this->secret_chats[\is_array($chat) ? $chat['chat_id'] : $chat]); } /** * Discard secret chat. * * @param int $chat Secret chat ID * */ public function discardSecretChat(int $chat): \Generator { $this->logger->logger('Discarding secret chat '.$chat.'...', \danog\MadelineProto\Logger::VERBOSE); if (isset($this->secret_chats[$chat])) { unset($this->secret_chats[$chat]); } if (isset($this->temp_requested_secret_chats[$chat])) { unset($this->temp_requested_secret_chats[$chat]); } try { yield from $this->methodCallAsyncRead('messages.discardEncryption', ['chat_id' => $chat]); } catch (\danog\MadelineProto\RPCErrorException $e) { if ($e->rpc !== 'ENCRYPTION_ALREADY_DECLINED') { throw $e; } } } } <?php /** * MessageHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\SecretChats; use Amp\Deferred; use Amp\Promise; use danog\MadelineProto\MTProtoTools\Crypt; /** * Manages packing and unpacking of messages, and the list of sent and received messages. */ trait MessageHandler { /** * Secret queue. * * @var Promise[] */ private $secretQueue = []; /** * Encrypt secret chat message. * * @param integer $chat_id Chat ID * @param array $message Message to encrypt * @param Deferred $queuePromise Queue promise * * @internal * */ public function encryptSecretMessage(int $chat_id, array $message, Deferred $queuePromise): \Generator { if (!isset($this->secret_chats[$chat_id])) { $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['secret_chat_skipping'], $chat_id)); return false; } $message['random_id'] = \danog\MadelineProto\Tools::random(8); $this->secret_chats[$chat_id]['ttr']--; if ($this->secret_chats[$chat_id]['layer'] > 8) { if (($this->secret_chats[$chat_id]['ttr'] <= 0 || \time() - $this->secret_chats[$chat_id]['updated'] > 7 * 24 * 60 * 60) && $this->secret_chats[$chat_id]['rekeying'][0] === 0) { yield from $this->rekey($chat_id); } if (isset($this->secretQueue[$chat_id])) { $promise = $this->secretQueue[$chat_id]; $this->secretQueue[$chat_id] = $queuePromise->promise(); yield $promise; } else { $this->secretQueue[$chat_id] = $queuePromise->promise(); } $message = ['_' => 'decryptedMessageLayer', 'layer' => $this->secret_chats[$chat_id]['layer'], 'in_seq_no' => $this->generateSecretInSeqNo($chat_id), 'out_seq_no' => $this->generateSecretOutSeqNo($chat_id), 'message' => $message]; $this->secret_chats[$chat_id]['out_seq_no']++; } $this->secret_chats[$chat_id]['outgoing'][$this->secret_chats[$chat_id]['out_seq_no']] = $message; $constructor = $this->secret_chats[$chat_id]['layer'] === 8 ? 'DecryptedMessage' : 'DecryptedMessageLayer'; $message = yield from $this->TL->serializeObject(['type' => $constructor], $message, $constructor, $this->secret_chats[$chat_id]['layer']); $message = \danog\MadelineProto\Tools::packUnsignedInt(\strlen($message)).$message; if ($this->secret_chats[$chat_id]['mtproto'] === 2) { $padding = \danog\MadelineProto\Tools::posmod(-\strlen($message), 16); if ($padding < 12) { $padding += 16; } $message .= \danog\MadelineProto\Tools::random($padding); $message_key = \substr(\hash('sha256', \substr($this->secret_chats[$chat_id]['key']['auth_key'], 88 + ($this->secret_chats[$chat_id]['admin'] ? 0 : 8), 32).$message, true), 8, 16); list($aes_key, $aes_iv) = Crypt::aesCalculate($message_key, $this->secret_chats[$chat_id]['key']['auth_key'], $this->secret_chats[$chat_id]['admin']); } else { $message_key = \substr(\sha1($message, true), -16); list($aes_key, $aes_iv) = Crypt::oldAesCalculate($message_key, $this->secret_chats[$chat_id]['key']['auth_key'], true); $message .= \danog\MadelineProto\Tools::random(\danog\MadelineProto\Tools::posmod(-\strlen($message), 16)); } $message = $this->secret_chats[$chat_id]['key']['fingerprint'].$message_key.Crypt::igeEncrypt($message, $aes_key, $aes_iv); return $message; } /** * Handle encrypted update. * * @internal * */ public function handleEncryptedUpdate(array $message): \Generator { if (!isset($this->secret_chats[$message['message']['chat_id']])) { $this->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['secret_chat_skipping'], $message['message']['chat_id'])); return false; } $auth_key_id = \substr($message['message']['bytes'], 0, 8); $old = false; if ($auth_key_id !== $this->secret_chats[$message['message']['chat_id']]['key']['fingerprint']) { if (isset($this->secret_chats[$message['message']['chat_id']]['old_key']['fingerprint'])) { if ($auth_key_id !== $this->secret_chats[$message['message']['chat_id']]['old_key']['fingerprint']) { yield from $this->discardSecretChat($message['message']['chat_id']); throw new \danog\MadelineProto\SecurityException(\danog\MadelineProto\Lang::$current_lang['fingerprint_mismatch']); } $old = true; } else { yield from $this->discardSecretChat($message['message']['chat_id']); throw new \danog\MadelineProto\SecurityException(\danog\MadelineProto\Lang::$current_lang['fingerprint_mismatch']); } } $message_key = \substr($message['message']['bytes'], 8, 16); $encrypted_data = \substr($message['message']['bytes'], 24); if ($this->secret_chats[$message['message']['chat_id']]['mtproto'] === 2) { $this->logger->logger('Trying MTProto v2 decryption for chat '.$message['message']['chat_id'].'...', \danog\MadelineProto\Logger::NOTICE); try { $message_data = $this->tryMTProtoV2Decrypt($message_key, $message['message']['chat_id'], $old, $encrypted_data); $this->logger->logger('MTProto v2 decryption OK for chat '.$message['message']['chat_id'].'...', \danog\MadelineProto\Logger::NOTICE); } catch (\danog\MadelineProto\SecurityException $e) { $this->logger->logger('MTProto v2 decryption failed with message '.$e->getMessage().', trying MTProto v1 decryption for chat '.$message['message']['chat_id'].'...', \danog\MadelineProto\Logger::NOTICE); $message_data = $this->tryMTProtoV1Decrypt($message_key, $message['message']['chat_id'], $old, $encrypted_data); $this->logger->logger('MTProto v1 decryption OK for chat '.$message['message']['chat_id'].'...', \danog\MadelineProto\Logger::NOTICE); $this->secret_chats[$message['message']['chat_id']]['mtproto'] = 1; } } else { $this->logger->logger('Trying MTProto v1 decryption for chat '.$message['message']['chat_id'].'...', \danog\MadelineProto\Logger::NOTICE); try { $message_data = $this->tryMTProtoV1Decrypt($message_key, $message['message']['chat_id'], $old, $encrypted_data); $this->logger->logger('MTProto v1 decryption OK for chat '.$message['message']['chat_id'].'...', \danog\MadelineProto\Logger::NOTICE); } catch (\danog\MadelineProto\SecurityException $e) { $this->logger->logger('MTProto v1 decryption failed with message '.$e->getMessage().', trying MTProto v2 decryption for chat '.$message['message']['chat_id'].'...', \danog\MadelineProto\Logger::NOTICE); $message_data = $this->tryMTProtoV2Decrypt($message_key, $message['message']['chat_id'], $old, $encrypted_data); $this->logger->logger('MTProto v2 decryption OK for chat '.$message['message']['chat_id'].'...', \danog\MadelineProto\Logger::NOTICE); $this->secret_chats[$message['message']['chat_id']]['mtproto'] = 2; } } [$deserialized, $sideEffects] = $this->TL->deserialize($message_data, ['type' => '']); if ($sideEffects) { yield $sideEffects; } $this->secret_chats[$message['message']['chat_id']]['ttr']--; if (($this->secret_chats[$message['message']['chat_id']]['ttr'] <= 0 || \time() - $this->secret_chats[$message['message']['chat_id']]['updated'] > 7 * 24 * 60 * 60) && $this->secret_chats[$message['message']['chat_id']]['rekeying'][0] === 0) { yield from $this->rekey($message['message']['chat_id']); } unset($message['message']['bytes']); $message['message']['decrypted_message'] = $deserialized; $this->secret_chats[$message['message']['chat_id']]['incoming'][$this->secret_chats[$message['message']['chat_id']]['in_seq_no']] = $message['message']; yield from $this->handleDecryptedUpdate($message); return true; } /** * @return false|string */ private function tryMTProtoV1Decrypt($message_key, $chat_id, $old, $encrypted_data) { list($aes_key, $aes_iv) = Crypt::oldAesCalculate($message_key, $this->secret_chats[$chat_id][$old ? 'old_key' : 'key']['auth_key'], true); $decrypted_data = Crypt::igeDecrypt($encrypted_data, $aes_key, $aes_iv); $message_data_length = \unpack('V', \substr($decrypted_data, 0, 4))[1]; $message_data = \substr($decrypted_data, 4, $message_data_length); if ($message_data_length > \strlen($decrypted_data)) { throw new \danog\MadelineProto\SecurityException(\danog\MadelineProto\Lang::$current_lang['msg_data_length_too_big']); } if ($message_key != \substr(\sha1(\substr($decrypted_data, 0, 4 + $message_data_length), true), -16)) { throw new \danog\MadelineProto\SecurityException('Msg_key mismatch'); } if (\strlen($decrypted_data) - 4 - $message_data_length > 15) { throw new \danog\MadelineProto\SecurityException('difference between message_data_length and the length of the remaining decrypted buffer is too big'); } if (\strlen($decrypted_data) % 16 != 0) { throw new \danog\MadelineProto\SecurityException(\danog\MadelineProto\Lang::$current_lang['length_not_divisible_16']); } return $message_data; } /** * @return false|string */ private function tryMTProtoV2Decrypt($message_key, $chat_id, $old, $encrypted_data) { list($aes_key, $aes_iv) = Crypt::aesCalculate($message_key, $this->secret_chats[$chat_id][$old ? 'old_key' : 'key']['auth_key'], !$this->secret_chats[$chat_id]['admin']); $decrypted_data = Crypt::igeDecrypt($encrypted_data, $aes_key, $aes_iv); if ($message_key != \substr(\hash('sha256', \substr($this->secret_chats[$chat_id][$old ? 'old_key' : 'key']['auth_key'], 88 + ($this->secret_chats[$chat_id]['admin'] ? 8 : 0), 32).$decrypted_data, true), 8, 16)) { throw new \danog\MadelineProto\SecurityException('Msg_key mismatch'); } $message_data_length = \unpack('V', \substr($decrypted_data, 0, 4))[1]; $message_data = \substr($decrypted_data, 4, $message_data_length); if ($message_data_length > \strlen($decrypted_data)) { throw new \danog\MadelineProto\SecurityException(\danog\MadelineProto\Lang::$current_lang['msg_data_length_too_big']); } if (\strlen($decrypted_data) - 4 - $message_data_length < 12) { throw new \danog\MadelineProto\SecurityException('padding is too small'); } if (\strlen($decrypted_data) - 4 - $message_data_length > 1024) { throw new \danog\MadelineProto\SecurityException('padding is too big'); } if (\strlen($decrypted_data) % 16 != 0) { throw new \danog\MadelineProto\SecurityException(\danog\MadelineProto\Lang::$current_lang['length_not_divisible_16']); } return $message_data; } } <?php /** * SeqNoHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\SecretChats; use danog\MadelineProto\Logger; /** * Manages sequence numbers. */ trait SeqNoHandler { private function checkSecretInSeqNo($chat_id, $seqno): \Generator { $seqno = ($seqno - $this->secret_chats[$chat_id]['out_seq_no_x']) / 2; $last = 0; foreach ($this->secret_chats[$chat_id]['incoming'] as $message) { if (isset($message['decrypted_message']['in_seq_no'])) { if (($message['decrypted_message']['in_seq_no'] - $this->secret_chats[$chat_id]['out_seq_no_x']) / 2 < $last) { $this->logger->logger("Discarding secret chat $chat_id, in_seq_no is not increasing", Logger::LEVEL_FATAL); yield from $this->discardSecretChat($chat_id); throw new \danog\MadelineProto\SecurityException('in_seq_no is not increasing'); } $last = ($message['decrypted_message']['in_seq_no'] - $this->secret_chats[$chat_id]['out_seq_no_x']) / 2; } } if ($seqno > $this->secret_chats[$chat_id]['out_seq_no'] + 1) { $this->logger->logger("Discarding secret chat $chat_id, in_seq_no is too big", Logger::LEVEL_FATAL); yield from $this->discardSecretChat($chat_id); throw new \danog\MadelineProto\SecurityException('in_seq_no is too big'); } return true; } private function checkSecretOutSeqNo($chat_id, $seqno): \Generator { $seqno = ($seqno - $this->secret_chats[$chat_id]['in_seq_no_x']) / 2; $C = 0; foreach ($this->secret_chats[$chat_id]['incoming'] as $message) { if (isset($message['decrypted_message']['out_seq_no']) && $C < $this->secret_chats[$chat_id]['in_seq_no']) { $temp = ($message['decrypted_message']['out_seq_no'] - $this->secret_chats[$chat_id]['in_seq_no_x']) / 2; if ($temp !== $C) { $this->logger->logger("Discarding secret chat $chat_id, out_seq_no hole: should be $C, is $temp", Logger::LEVEL_FATAL); yield from $this->discardSecretChat($chat_id); throw new \danog\MadelineProto\SecurityException("out_seq_no hole: should be $C, is $temp"); } $C++; } } //$this->logger->logger($C, $seqno); if ($seqno < $C) { // <= C $this->logger->logger('WARNING: dropping repeated message with seqno '.$seqno); return false; } if ($seqno > $C) { // > C+1 $this->logger->logger("Discarding secret chat $chat_id, out_seq_no gap detected: ($seqno > $C)", Logger::LEVEL_FATAL); yield from $this->discardSecretChat($chat_id); throw new \danog\MadelineProto\SecurityException('WARNING: out_seq_no gap detected ('.$seqno.' > '.$C.')!'); } return true; } private function generateSecretInSeqNo($chat) { return $this->secret_chats[$chat]['layer'] > 8 ? $this->secret_chats[$chat]['in_seq_no'] * 2 + $this->secret_chats[$chat]['in_seq_no_x'] : -1; } private function generateSecretOutSeqNo($chat) { return $this->secret_chats[$chat]['layer'] > 8 ? $this->secret_chats[$chat]['out_seq_no'] * 2 + $this->secret_chats[$chat]['out_seq_no_x'] : -1; } } <?php /** * ResponseHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\SecretChats; /** * Manages responses. */ trait ResponseHandler { private function handleDecryptedUpdate(array $update): \Generator { $chatId = $update['message']['chat_id']; $decryptedMessage = $update['message']['decrypted_message']; if ($decryptedMessage['_'] === 'decryptedMessage') { yield from $this->saveUpdate($update); return; } if ($decryptedMessage['_'] === 'decryptedMessageService') { $action = $decryptedMessage['action']; switch ($action['_']) { case 'decryptedMessageActionRequestKey': yield from $this->acceptRekey($chatId, $action); return; case 'decryptedMessageActionAcceptKey': yield from $this->commitRekey($chatId, $action); return; case 'decryptedMessageActionCommitKey': yield from $this->completeRekey($chatId, $action); return; case 'decryptedMessageActionNotifyLayer': $this->secret_chats[$chatId]['layer'] = $action['layer']; if ($action['layer'] >= 17 && \time() - $this->secret_chats[$chatId]['created'] > 15) { yield from $this->notifyLayer($chatId); } if ($action['layer'] >= 73) { $this->secret_chats[$chatId]['mtproto'] = 2; } return; case 'decryptedMessageActionSetMessageTTL': $this->secret_chats[$chatId]['ttl'] = $action['ttl_seconds']; yield from $this->saveUpdate($update); return; case 'decryptedMessageActionNoop': return; case 'decryptedMessageActionResend': $action['start_seq_no'] -= $this->secret_chats[$chatId]['out_seq_no_x']; $action['end_seq_no'] -= $this->secret_chats[$chatId]['out_seq_no_x']; $action['start_seq_no'] /= 2; $action['end_seq_no'] /= 2; $this->logger->logger('Resending messages for secret chat '.$chatId, \danog\MadelineProto\Logger::WARNING); foreach ($this->secret_chats[$chatId]['outgoing'] as $seq => $message) { if ($seq >= $action['start_seq_no'] && $seq <= $action['end_seq_no']) { yield from $this->methodCallAsyncRead('messages.sendEncrypted', ['peer' => $chatId, 'message' => $message]); } } return; default: yield from $this->saveUpdate($update); } return; } if ($decryptedMessage['_'] === 'decryptedMessageLayer') { if ((yield from $this->checkSecretOutSeqNo($chatId, $decryptedMessage['out_seq_no'])) && (yield from $this->checkSecretInSeqNo($chatId, $decryptedMessage['in_seq_no']))) { $this->secret_chats[$chatId]['in_seq_no']++; if ($decryptedMessage['layer'] >= 17 && $decryptedMessage['layer'] !== $this->secret_chats[$chatId]['layer']) { $this->secret_chats[$chatId]['layer'] = $decryptedMessage['layer']; if ($decryptedMessage['layer'] >= 17 && \time() - $this->secret_chats[$chatId]['created'] > 15) { yield from $this->notifyLayer($chatId); } } $update['message']['decrypted_message'] = $decryptedMessage['message']; yield from $this->handleDecryptedUpdate($update); } return; } throw new \danog\MadelineProto\ResponseException('Unrecognized decrypted message received: '.\var_export($update, true)); } } <?php /** * FileCallback module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; /** * File callback interface. */ class FileCallback implements FileCallbackInterface { /** * File to download/upload. * */ private $file; /** * Callback. * * @var callable */ private $callback; /** * Construct file callback. * * @param mixed $file File to download/upload * @param callable $callback Callback */ public function __construct($file, callable $callback) { $this->file = $file; $this->callback = $callback; } /** * Get file. * */ public function getFile() { return $this->file; } /** * Invoke callback. * * @param int $percent Percent * @param int $speed Speed in mbps * @param int $time Time * */ public function __invoke($percent, $speed, $time) { $callback = $this->callback; return $callback($percent, $speed, $time); } } <?php /** * API wrapper module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Promise; use Amp\Success; use danog\MadelineProto\Ipc\Client; use function Amp\File\openFile; final class APIWrapper { /** * MTProto instance. * * @var MTProto|null|Client */ private $API = null; /** * Session path. */ public SessionPaths $session; /** * Getting API ID flag. * */ private bool $gettingApiId = false; /** * Web API template. * */ private string $webApiTemplate = ''; /** * My.telegram.org wrapper. * * @var ?MyTelegramOrgWrapper */ private $myTelegramOrgWrapper; /** * Serialization date. * * @var integer */ private int $serialized = 0; /** * Whether lua is being used. * * @internal * * @var boolean */ private bool $lua = false; /** * Whether async is enabled. * * @internal * * @var boolean */ private bool $async = false; /** * AbstractAPIFactory instance. * */ private AbstractAPIFactory $factory; /** * Property storage. */ public array $storage = []; /** * API wrapper. * * @param API $API API instance to wrap * @param AbstractAPIFactory $factory Factory */ public function __construct(API $API, AbstractAPIFactory $factory) { self::link($this, $API); $this->factory = $factory; } /** * Link two APIWrapper and API instances. * * @param API|APIWrapper $a Instance to which link * @param API|APIWrapper $b Instance from which link * */ public static function link($a, $b): void { foreach (self::properties() as $var) { Tools::setVar($a, $var, Tools::getVar($b, $var)); } Tools::setVar($a, 'session', Tools::getVar($b, 'session')); } /** * Property list. * */ public static function properties(): array { return ['API', 'webApiTemplate', 'gettingApiId', 'myTelegramOrgWrapper', 'storage', 'lua']; } /** * Sleep function. * */ public function __sleep(): array { return self::properties(); } /** * Get MTProto instance. * * @return Client|MTProto|null */ public function &getAPI() { return $this->API; } /** * Whether async is being used. * * @return boolean */ public function isAsync(): bool { return $this->async; } /** * Get API factory. * */ public function getFactory(): AbstractAPIFactory { return $this->factory; } /** * Get IPC path. * * @internal * */ public function getIpcPath(): string { return $this->session->getIpcPath(); } /** * Serialize session. * * @return Promise<bool> */ public function serialize(): Promise { if ($this->API === null && !$this->gettingApiId) { return new Success(false); } if ($this->API instanceof Client) { return new Success(false); } return Tools::callFork((function (): \Generator { if ($this->API) { yield from $this->API->initAsynchronously(); } yield from $this->session->serialize( $this->API ? yield from $this->API->serializeSession($this) : $this, $this->session->getSessionPath() ); if ($this->API) { yield from $this->session->storeLightState($this->API); } // Truncate legacy session yield (yield openFile($this->session->getLegacySessionPath(), 'w'))->close(); if (!Magic::$suspendPeriodicLogging) { Logger::log('Saved session!'); } return true; })()); } /** * Get session path. * */ public function getSession(): SessionPaths { return $this->session; } } <?php /** * AckHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoSession; use danog\MadelineProto\DataCenterConnection; use danog\MadelineProto\Logger; use danog\MadelineProto\MTProto\IncomingMessage; use danog\MadelineProto\MTProto\OutgoingMessage; /** * Manages acknowledgement of messages. * * @property DataCenterConnection $shared */ trait AckHandler { /** * Acknowledge outgoing message ID. * * @param string|int $message_id Message Id * * @return boolean */ public function ackOutgoingMessageId($message_id): bool { // The server acknowledges that it received my message if (!isset($this->outgoing_messages[$message_id])) { $this->logger->logger("WARNING: Couldn't find message id ".$message_id.' in the array of outgoing messages. Maybe try to increase its size?', \danog\MadelineProto\Logger::WARNING); return false; } return true; } /** * We have gotten a response for an outgoing message. * * */ public function gotResponseForOutgoingMessage(OutgoingMessage $outgoingMessage): void { // The server acknowledges that it received my message if (isset($this->new_outgoing[$outgoingMessage->getMsgId()])) { unset($this->new_outgoing[$outgoingMessage->getMsgId()]); } else { $this->logger->logger("Could not find $outgoingMessage in new_outgoing!", Logger::FATAL_ERROR); } } /** * Acknowledge incoming message ID. * * @param IncomingMessage $message Message * */ public function ackIncomingMessage(IncomingMessage $message): void { // Not exactly true, but we don't care $message->ack(); $message_id = $message->getMsgId(); // I let the server know that I received its message $this->ack_queue[$message_id] = $message_id; } /** * Check if there are some pending calls. * * @return boolean */ public function hasPendingCalls(): bool { $timeout = $this->shared->getSettings()->getTimeout(); $pfs = $this->shared->getGenericSettings()->getAuth()->getPfs(); $unencrypted = !$this->shared->hasTempAuthKey(); $notBound = !$this->shared->isBound(); $pfsNotBound = $pfs && $notBound; /** @var OutgoingMessage */ foreach ($this->new_outgoing as $message) { if ($message->wasSent() && $message->getSent() + $timeout < \time() && $message->isUnencrypted() === $unencrypted && $message->getConstructor() !== 'msgs_state_req') { if (!$unencrypted && $pfsNotBound && $message->getConstructor() !== 'auth.bindTempAuthKey') { continue; } return true; } } return false; } /** * Get all pending calls (also clear pending state requests). * */ public function getPendingCalls(): array { $settings = $this->shared->getSettings(); $global = $this->shared->getGenericSettings(); $dropTimeout = $global->getRpc()->getRpcTimeout(); $timeout = $settings->getTimeout(); $pfs = $global->getAuth()->getPfs(); $unencrypted = !$this->shared->hasTempAuthKey(); $notBound = !$this->shared->isBound(); $pfsNotBound = $pfs && $notBound; $result = []; /** @var OutgoingMessage $message */ foreach ($this->new_outgoing as $message_id => $message) { if ($message->wasSent() && $message->getSent() + $timeout < \time() && $message->isUnencrypted() === $unencrypted ) { if (!$unencrypted && $pfsNotBound && $message->getConstructor() !== 'auth.bindTempAuthKey') { continue; } if ($message->getConstructor() === 'msgs_state_req' || $message->getConstructor() === 'ping_delay_disconnect') { unset($this->new_outgoing[$message_id], $this->outgoing_messages[$message_id]); continue; } if ($message->getSent() + $dropTimeout < \time()) { $this->handleReject($message, new \danog\MadelineProto\Exception("Request timeout")); continue; } if ($message->getState() & OutgoingMessage::STATE_REPLIED) { $this->logger->logger("Already replied to message $message, but still in new_outgoing"); unset($this->new_outgoing[$message_id]); continue; } $result[] = $message_id; } } return $result; } } <?php /** * Session module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoSession; use danog\MadelineProto\Connection; use danog\MadelineProto\MTProto; use danog\MadelineProto\MTProto\IncomingMessage; use danog\MadelineProto\MTProto\OutgoingMessage; /** * Manages MTProto session-specific data. * * @extends Connection */ trait Session { use AuthKeyHandler; use AckHandler; use ResponseHandler; use SeqNoHandler; use CallHandler; use Reliable; /** * Incoming message array. * * @var IncomingMessage[] */ public $incoming_messages = []; /** * Outgoing message array. * * @var OutgoingMessage[] */ public $outgoing_messages = []; /** * New incoming message ID array. * * @var IncomingMessage[] */ public $new_incoming = []; /** * New outgoing message array. * * @var OutgoingMessage[] */ public $new_outgoing = []; /** * Pending outgoing messages. * * @var OutgoingMessage[] */ public $pendingOutgoing = []; /** * Pending outgoing key. * * @var string */ public $pendingOutgoingKey = 'a'; /** * Time delta with server. * * @var integer */ public $time_delta = 0; /** * Call queue. * * @var array */ public $call_queue = []; /** * Ack queue. * * @var array */ public $ack_queue = []; /** * Message ID handler. * * @var MsgIdHandler */ public $msgIdHandler; /** * Reset MTProto session. * */ public function resetSession(): void { $this->API->logger->logger("Resetting session in DC {$this->datacenterId}...", \danog\MadelineProto\Logger::WARNING); $this->session_id = \danog\MadelineProto\Tools::random(8); $this->session_in_seq_no = 0; $this->session_out_seq_no = 0; if (!isset($this->msgIdHandler)) { $this->msgIdHandler = MsgIdHandler::createInstance($this); } foreach ($this->outgoing_messages as &$msg) { if ($msg->hasMsgId()) { $msg->setMsgId(null); } if ($msg->hasSeqNo()) { $msg->setSeqNo(null); } } } /** * Cleanup incoming and outgoing messages. * */ public function cleanupSession(): void { $count = 0; $incoming = []; foreach ($this->incoming_messages as $key => $message) { if ($message->canGarbageCollect()) { $count++; } else { $this->API->logger->logger("Can't garbage collect $message in DC {$this->datacenter}, not handled yet!", \danog\MadelineProto\Logger::VERBOSE); $incoming[$key] = $message; } } $this->incoming_messages = $incoming; $total = \count($this->incoming_messages); if ($count+$total) { $this->API->logger->logger("Garbage collected $count incoming messages in DC {$this->datacenter}, $total left", \danog\MadelineProto\Logger::VERBOSE); } $count = 0; $outgoing = []; foreach ($this->outgoing_messages as $key => $message) { if ($message->canGarbageCollect()) { $count++; } else { $ago = \time() - $message->getSent(); if ($ago > 2) { $this->API->logger->logger("Can't garbage collect $message in DC {$this->datacenter} sent $ago seconds ago, no response has been received or it wasn't yet handled!", \danog\MadelineProto\Logger::VERBOSE); } $outgoing[$key] = $message; } } $this->outgoing_messages = $outgoing; $total = \count($this->outgoing_messages); if ($count+$total) { $this->API->logger->logger("Garbage collected $count outgoing messages in DC {$this->datacenter}, $total left", \danog\MadelineProto\Logger::VERBOSE); } } /** * Create MTProto session if needed. * */ public function createSession(): void { if ($this->session_id === null) { $this->resetSession(); } } /** * Backup eventual unsent messages before session deletion. * * @return OutgoingMessage[] */ public function backupSession(): array { $pending = \array_values($this->pendingOutgoing); return \array_merge($pending, $this->new_outgoing); } } <?php /** * MsgIdHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoSession; use danog\MadelineProto\Connection; use danog\MadelineProto\Logger; use danog\MadelineProto\Magic; use danog\MadelineProto\MTProtoSession\MsgIdHandler\MsgIdHandler64; /** * Manages message ids. */ abstract class MsgIdHandler { /** * Session instance. */ protected Connection $session; /** * Constructor. * * @param Connection $session Session */ private function __construct(Connection $session) { $this->session = $session; } /** * Create MsgIdHandler instance. * * @param Connection $session Session * */ public static function createInstance(Connection $session): self { return new MsgIdHandler64($session); } /** * Check validity of given message ID. * * @param string $newMessageId New message ID * @param array $aargs Params * */ abstract public function checkMessageId($newMessageId, array $aargs): void; /** * Generate outgoing message ID. * */ abstract public function generateMessageId(): string; /** * Get maximum message ID. * * @param boolean $incoming Incoming or outgoing message ID * */ abstract public function getMaxId(bool $incoming); /** * Get readable representation of message ID. * */ abstract protected static function toStringInternal(string $messageId): string; /** * Cleanup incoming and outgoing messages. * */ public function cleanup(): void { $usage = \memory_get_usage(); $this->session->cleanupSession(); $cleaned = \round(($usage - \memory_get_usage())/1024/1024, 1); if ($cleaned && !Magic::$suspendPeriodicLogging) { $this->session->API->logger->logger("Zend hashmap reallocation done. Cleaned memory: $cleaned Mb", Logger::VERBOSE); } } /** * Get readable representation of message ID. * */ public static function toString(string $messageId): string { return MsgIdHandler64::toStringInternal($messageId); } } <?php /** * AuthKeyHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoSession; use Amp\Http\Client\Request; use danog\MadelineProto\DataCenterConnection; use danog\MadelineProto\Exception; use danog\MadelineProto\Logger; use danog\MadelineProto\MTProto; use danog\MadelineProto\MTProto\PermAuthKey; use danog\MadelineProto\MTProto\TempAuthKey; use danog\MadelineProto\MTProtoTools\Crypt; use danog\MadelineProto\RPCErrorException; use danog\MadelineProto\SecurityException; use danog\MadelineProto\Tools; use danog\PrimeModule; use phpseclib3\Math\BigInteger; /** * Manages the creation of the authorization key. * * https://core.telegram.org/mtproto/auth_key * https://core.telegram.org/mtproto/samples-auth_key * * @property DataCenterConnection $shared * @property string $datacenter * @property MTProto $API * @property Logger $logger */ trait AuthKeyHandler { /** * Create authorization key. * * * @psalm-return \Generator<mixed, mixed|string, mixed, ($temp is false ? \danog\MadelineProto\MTProto\PermAuthKey : \danog\MadelineProto\MTProto\TempAuthKey)|null> */ public function createAuthKey(bool $temp): \Generator { $expires_in = $temp ? $this->API->settings->getAuth()->getDefaultTempAuthKeyExpiresIn() : -1; $cdn = $this->isCDN(); $media = $this->isMedia(); $test = $this->API->settings->getConnection()->getTestMode(); $datacenter_id = \preg_replace('|_.*|', '', $this->datacenter) + ($this->API->settings->getConnection()->getTestMode() ? 10000 : 0); if ($media) { $datacenter_id = -$datacenter_id; } for ($retry_id_total = 1; $retry_id_total <= $this->API->settings->getAuth()->getMaxAuthTries(); $retry_id_total++) { try { $this->logger->logger("Requesting pq...", \danog\MadelineProto\Logger::VERBOSE); /** * *********************************************************************** * Make pq request, DH exchange initiation. * * @method req_pq_multi * * @param [ * int128 $nonce : The value of nonce is selected randomly by the client (random number) and identifies the client within this communication * ] * * @return ResPQ [ * int128 $nonce : The value of nonce is selected randomly by the server * int128 $server_nonce : The value of server_nonce is selected randomly by the server * string $pq : This is a representation of a natural number (in binary big endian format). This number is the product of two different odd prime numbers * Vector long $server_public_key_fingerprints : This is a list of public RSA key fingerprints * ] */ $nonce = \danog\MadelineProto\Tools::random(16); $ResPQ = yield from $this->methodCallAsyncRead('req_pq_multi', ['nonce' => $nonce]); /* * *********************************************************************** * Check if the client's nonce and the server's nonce are the same */ if ($ResPQ['nonce'] !== $nonce) { throw new \danog\MadelineProto\SecurityException('wrong nonce'); } /* * *********************************************************************** * Find our key in the server_public_key_fingerprints vector */ foreach ($this->API->getRsaKeys($test, $cdn) as $curkey) { if (\in_array($curkey->fp, $ResPQ['server_public_key_fingerprints'])) { $key = $curkey; } } if (!isset($key)) { if ($cdn) { $this->logger->logger("Could not find required CDN public key, postponing CDN handshake..."); return; } throw new \danog\MadelineProto\SecurityException("Couldn't find any of our keys in the server_public_key_fingerprints vector."); } $pq_bytes = $ResPQ['pq']; $server_nonce = $ResPQ['server_nonce']; /* * *********************************************************************** * Compute p and q */ $ok = false; $pq = Tools::unpackSignedLong(\strrev($pq_bytes)); foreach ([ 'native_single_cpp', 'python_single_alt', 'python_single', 'native_single', ] as $method) { $this->logger->logger("Factorizing with $method (please wait, might take a while)"); if ($method !== 'native_single_cpp') { $this->logger->logger("Install https://prime.madelineproto.xyz and the FFI extension to speed this up!"); } $p = 0; $q = 0; try { if ($method === 'wolfram') { $p = yield from $this->wolframSingle($pq); } else { $p = PrimeModule::$method($pq); } } catch (\Throwable $e) { $this->logger->logger("While factorizing with $method: $e"); } if ($p) { $q = $pq / $p; if ($p > $q) { list($p, $q) = [$q, $p]; } if ($pq === $p*$q) { $ok = true; break; } } } if (!$ok) { throw new \danog\MadelineProto\SecurityException("Couldn't compute p and q, install prime.madelineproto.xyz to fix. Original pq: {$pq}, computed p: {$p}, computed q: {$q}, computed pq: ".$p*$q); } $this->logger->logger('Factorization '.$pq.' = '.$p.' * '.$q, \danog\MadelineProto\Logger::VERBOSE); /* * *********************************************************************** * Serialize object for req_DH_params */ $p_bytes = \strrev(Tools::packUnsignedInt($p)); $q_bytes = \strrev(Tools::packUnsignedInt($q)); $new_nonce = \danog\MadelineProto\Tools::random(32); $data_unserialized = ['_' => 'p_q_inner_data'.($expires_in < 0 ? '' : '_temp').'_dc', 'pq' => $pq_bytes, 'p' => $p_bytes, 'q' => $q_bytes, 'nonce' => $nonce, 'server_nonce' => $server_nonce, 'new_nonce' => $new_nonce, 'expires_in' => $expires_in, 'dc' => $datacenter_id]; $p_q_inner_data = (yield from $this->API->getTL()->serializeObject(['type' => ''], $data_unserialized, 'p_q_inner_data')); /* * *********************************************************************** * Encrypt serialized object */ if (\strlen($p_q_inner_data) > 144) { throw new SecurityException('p_q_inner_data is too long!'); } $data_with_padding = $p_q_inner_data.Tools::random(192 - \strlen($p_q_inner_data)); $data_pad_reversed = \strrev($data_with_padding); do { $temp_key = Tools::random(32); $data_with_hash = $data_pad_reversed.\hash('sha256', $temp_key.$data_with_padding, true); $aes_encrypted = Crypt::igeEncrypt($data_with_hash, $temp_key, \str_repeat("\0", 32)); $temp_key_xor = $temp_key ^ \hash('sha256', $aes_encrypted, true); $key_aes_encrypted_bigint = new BigInteger($temp_key_xor.$aes_encrypted, 256); } while ($key_aes_encrypted_bigint->compare($key->n) >= 0); $encrypted_data = $key->encrypt($key_aes_encrypted_bigint); $this->logger->logger('Starting Diffie Hellman key exchange', \danog\MadelineProto\Logger::VERBOSE); /* * *********************************************************************** * Starting Diffie Hellman key exchange, Server authentication * @method req_DH_params * @param [ * int128 $nonce : The value of nonce is selected randomly by the client (random number) and identifies the client within this communication * int128 $server_nonce : The value of server_nonce is selected randomly by the server * string $p : The value of BigInteger * string $q : The value of BigInteger * long $public_key_fingerprint : This is our key in the server_public_key_fingerprints vector * string $encrypted_data * ] * @return Server_DH_Params [ * int128 $nonce : The value of nonce is selected randomly by the server * int128 $server_nonce : The value of server_nonce is selected randomly by the server * string $new_nonce_hash : Return this value if server responds with server_DH_params_fail * string $encrypted_answer : Return this value if server responds with server_DH_params_ok * ] */ // $server_dh_params = yield from $this->methodCallAsyncRead('req_DH_params', ['nonce' => $nonce, 'server_nonce' => $server_nonce, 'p' => $p_bytes, 'q' => $q_bytes, 'public_key_fingerprint' => $key->fp, 'encrypted_data' => $encrypted_data]); /* * *********************************************************************** * Check if the client's nonce and the server's nonce are the same */ if ($nonce != $server_dh_params['nonce']) { throw new \danog\MadelineProto\SecurityException('wrong nonce.'); } /* * *********************************************************************** * Check if server_nonce and new server_nonce are the same */ if ($server_nonce != $server_dh_params['server_nonce']) { throw new \danog\MadelineProto\SecurityException('wrong server nonce.'); } /* * *********************************************************************** * Check valid new nonce hash if return from server * new nonce hash return in server_DH_params_fail */ if (isset($server_dh_params['new_nonce_hash']) && \substr(\sha1($new_nonce), -32) != $server_dh_params['new_nonce_hash']) { throw new \danog\MadelineProto\SecurityException('wrong new nonce hash.'); } /* * *********************************************************************** * Get key, iv and decrypt answer */ $encrypted_answer = $server_dh_params['encrypted_answer']; $tmp_aes_key = \sha1($new_nonce.$server_nonce, true).\substr(\sha1($server_nonce.$new_nonce, true), 0, 12); $tmp_aes_iv = \substr(\sha1($server_nonce.$new_nonce, true), 12, 8).\sha1($new_nonce.$new_nonce, true).\substr($new_nonce, 0, 4); $answer_with_hash = Crypt::igeDecrypt($encrypted_answer, $tmp_aes_key, $tmp_aes_iv); /* * *********************************************************************** * Separate answer and hash */ $answer_hash = \substr($answer_with_hash, 0, 20); /** @var string */ $answer = \substr($answer_with_hash, 20); /* * *********************************************************************** * Deserialize answer * @return Server_DH_inner_data [ * int128 $nonce : The value of nonce is selected randomly by the client (random number) and identifies the client within this communication * int128 $server_nonce : The value of server_nonce is selected randomly by the server * int $g * string $dh_prime * string $g_a * int $server_time * ] */ [$server_DH_inner_data] = $this->API->getTL()->deserialize($answer, ['type' => '']); /* * *********************************************************************** * Do some checks */ $server_DH_inner_data_length = $this->API->getTL()->getLength($answer); if (\sha1(\substr($answer, 0, $server_DH_inner_data_length), true) != $answer_hash) { throw new \danog\MadelineProto\SecurityException('answer_hash mismatch.'); } if ($nonce != $server_DH_inner_data['nonce']) { throw new \danog\MadelineProto\SecurityException('wrong nonce'); } if ($server_nonce != $server_DH_inner_data['server_nonce']) { throw new \danog\MadelineProto\SecurityException('wrong server nonce'); } $g = new BigInteger($server_DH_inner_data['g']); $g_a = new BigInteger((string) $server_DH_inner_data['g_a'], 256); $dh_prime = new BigInteger((string) $server_DH_inner_data['dh_prime'], 256); /* * *********************************************************************** * Time delta */ $server_time = $server_DH_inner_data['server_time']; $this->time_delta = $server_time - \time(); $this->logger->logger(\sprintf('Server-client time delta = %.1f s', $this->time_delta), \danog\MadelineProto\Logger::VERBOSE); Crypt::checkPG($dh_prime, $g); Crypt::checkG($g_a, $dh_prime); for ($retry_id = 0; $retry_id <= $this->API->settings->getAuth()->getMaxAuthTries(); $retry_id++) { $this->logger->logger('Generating b...', \danog\MadelineProto\Logger::VERBOSE); $b = new BigInteger(\danog\MadelineProto\Tools::random(256), 256); $this->logger->logger('Generating g_b...', \danog\MadelineProto\Logger::VERBOSE); $g_b = $g->powMod($b, $dh_prime); Crypt::checkG($g_b, $dh_prime); /* * *********************************************************************** * Check validity of g_b * 1 < g_b < dh_prime - 1 */ $this->logger->logger('Executing g_b check...', \danog\MadelineProto\Logger::VERBOSE); if ($g_b->compare(\danog\MadelineProto\Magic::$one) <= 0 || $g_b->compare($dh_prime->subtract(\danog\MadelineProto\Magic::$one)) >= 0) { throw new \danog\MadelineProto\SecurityException('g_b is invalid (1 < g_b < dh_prime - 1 is false).'); } $this->logger->logger('Preparing client_DH_inner_data...', \danog\MadelineProto\Logger::VERBOSE); $g_b_str = $g_b->toBytes(); /* * *********************************************************************** * serialize client_DH_inner_data * @method client_DH_inner_data * @param Server_DH_inner_data [ * int128 $nonce : The value of nonce is selected randomly by the client (random number) and identifies the client within this communication * int128 $server_nonce : The value of server_nonce is selected randomly by the server * long $retry_id : First attempt * string $g_b : g^b mod dh_prime * ] */ $data = (yield from $this->API->getTL()->serializeObject(['type' => ''], ['_' => 'client_DH_inner_data', 'nonce' => $nonce, 'server_nonce' => $server_nonce, 'retry_id' => $retry_id, 'g_b' => $g_b_str], 'client_DH_inner_data')); /* * *********************************************************************** * encrypt client_DH_inner_data */ $data_with_sha = \sha1($data, true).$data; $data_with_sha_padded = $data_with_sha.\danog\MadelineProto\Tools::random(\danog\MadelineProto\Tools::posmod(-\strlen($data_with_sha), 16)); $encrypted_data = Crypt::igeEncrypt($data_with_sha_padded, $tmp_aes_key, $tmp_aes_iv); $this->logger->logger('Executing set_client_DH_params...', \danog\MadelineProto\Logger::VERBOSE); /* * *********************************************************************** * Send set_client_DH_params query * @method set_client_DH_params * @param Server_DH_inner_data [ * int128 $nonce : The value of nonce is selected randomly by the client (random number) and identifies the client within this communication * int128 $server_nonce : The value of server_nonce is selected randomly by the server * string $encrypted_data * ] * @return Set_client_DH_params_answer [ * string $_ : This value is dh_gen_ok, dh_gen_retry OR dh_gen_fail * int128 $server_nonce : The value of server_nonce is selected randomly by the server * int128 $new_nonce_hash1 : Return this value if server responds with dh_gen_ok * int128 $new_nonce_hash2 : Return this value if server responds with dh_gen_retry * int128 $new_nonce_hash2 : Return this value if server responds with dh_gen_fail * ] */ $Set_client_DH_params_answer = yield from $this->methodCallAsyncRead('set_client_DH_params', ['nonce' => $nonce, 'server_nonce' => $server_nonce, 'encrypted_data' => $encrypted_data]); /* * *********************************************************************** * Generate auth_key */ $this->logger->logger('Generating authorization key...', \danog\MadelineProto\Logger::VERBOSE); $auth_key = $g_a->powMod($b, $dh_prime); $auth_key_str = $auth_key->toBytes(); $auth_key_sha = \sha1($auth_key_str, true); $auth_key_aux_hash = \substr($auth_key_sha, 0, 8); $new_nonce_hash1 = \substr(\sha1($new_nonce.\chr(1).$auth_key_aux_hash, true), -16); $new_nonce_hash2 = \substr(\sha1($new_nonce.\chr(2).$auth_key_aux_hash, true), -16); $new_nonce_hash3 = \substr(\sha1($new_nonce.\chr(3).$auth_key_aux_hash, true), -16); /* * *********************************************************************** * Check if the client's nonce and the server's nonce are the same */ if ($Set_client_DH_params_answer['nonce'] != $nonce) { throw new \danog\MadelineProto\SecurityException('wrong nonce.'); } /* * *********************************************************************** * Check if server_nonce and new server_nonce are the same */ if ($Set_client_DH_params_answer['server_nonce'] != $server_nonce) { throw new \danog\MadelineProto\SecurityException('wrong server nonce'); } /* * *********************************************************************** * Check Set_client_DH_params_answer type */ switch ($Set_client_DH_params_answer['_']) { case 'dh_gen_ok': if ($Set_client_DH_params_answer['new_nonce_hash1'] != $new_nonce_hash1) { throw new \danog\MadelineProto\SecurityException('wrong new_nonce_hash1'); } $this->logger->logger('Diffie Hellman key exchange processed successfully!', \danog\MadelineProto\Logger::VERBOSE); $key = $expires_in < 0 ? new PermAuthKey() : new TempAuthKey(); if ($expires_in >= 0) { $key->expires(\time() + $expires_in); } $key->setServerSalt(\substr($new_nonce, 0, 8) ^ \substr($server_nonce, 0, 8)); $key->setAuthKey($auth_key_str); $this->logger->logger('Auth key generated', \danog\MadelineProto\Logger::NOTICE); return $key; case 'dh_gen_retry': if ($Set_client_DH_params_answer['new_nonce_hash2'] != $new_nonce_hash2) { throw new \danog\MadelineProto\SecurityException('wrong new_nonce_hash_2'); } //repeat foreach $this->logger->logger('Retrying Auth', \danog\MadelineProto\Logger::VERBOSE); break; case 'dh_gen_fail': if ($Set_client_DH_params_answer['new_nonce_hash3'] != $new_nonce_hash3) { throw new \danog\MadelineProto\SecurityException('wrong new_nonce_hash_3'); } $this->logger->logger('Auth Failed', \danog\MadelineProto\Logger::WARNING); break 2; default: throw new \danog\MadelineProto\SecurityException('Response Error'); break; } } } catch (SecurityException|Exception|RPCErrorException $e) { $this->logger->logger("An exception occurred while generating the authorization key in DC {$this->datacenter}: ".$e->getMessage().' in '.\basename($e->getFile(), '.php').' on line '.$e->getLine().'. Retrying...', \danog\MadelineProto\Logger::WARNING); yield from $this->reconnect(); } catch (\Throwable $e) { $this->logger->logger("An exception occurred while generating the authorization key in DC {$this->datacenter}: ".$e.PHP_EOL.' Retrying (try number '.$retry_id_total.')...', \danog\MadelineProto\Logger::WARNING); yield from $this->reconnect(); } } if (!$cdn) { throw new \danog\MadelineProto\SecurityException('Auth Failed, please check the logfile for more information, make sure to install https://prime.madelineproto.xyz!'); } } /** * Factorize number asynchronously using the wolfram API. * * @param string|integer $what Number to factorize * * * @psalm-return \Generator<int, \Amp\Promise<string>, mixed, false|int|string> */ private function wolframSingle($what): \Generator { $code = (yield from $this->API->datacenter->fileGetContents('http://www.wolframalpha.com/api/v1/code')); $query = 'Do prime factorization of '.$what; $params = ['async' => true, 'banners' => 'raw', 'debuggingdata' => false, 'format' => 'moutput', 'formattimeout' => 8, 'input' => $query, 'output' => 'JSON', 'proxycode' => \json_decode($code, true)['code']]; $url = 'https://www.wolframalpha.com/input/json.jsp?'.\http_build_query($params); $request = new Request($url); $request->setHeader('referer', 'https://www.wolframalpha.com/input/?i='.\urlencode($query)); $res = \json_decode(yield (yield $this->API->datacenter->getHTTPClient()->request($request))->getBody()->buffer(), true); if (!isset($res['queryresult']['pods'])) { return false; } $fres = false; foreach ($res['queryresult']['pods'] as $cur) { if ($cur['id'] === 'Divisors') { $fres = \explode(', ', \preg_replace(["/{\\d+, /", "/, \\d+}\$/"], '', $cur['subpods'][0]['moutput'])); break; } } if (\is_array($fres)) { $fres = $fres[0]; $newval = \intval($fres); if (\is_int($newval)) { $fres = $newval; } return $fres; } return false; } } <?php /** * MsgIdHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoSession\MsgIdHandler; use danog\MadelineProto\MTProtoSession\MsgIdHandler; use danog\MadelineProto\Tools; /** * Manages message ids. */ class MsgIdHandler64 extends MsgIdHandler { /** * Maximum incoming ID. * * @var int */ private $maxIncomingId = 0; /** * Maximum outgoing ID. * * @var int */ private $maxOutgoingId = 0; /** * Check validity of given message ID. * * @param string $newMessageId New message ID * @param array $aargs Params * */ public function checkMessageId($newMessageId, array $aargs): void { $newMessageId = \is_integer($newMessageId) ? $newMessageId : Tools::unpackSignedLong($newMessageId); $minMessageId = (\time() + $this->session->time_delta - 300) << 32; if ($newMessageId < $minMessageId) { $this->session->API->logger->logger('Given message id ('.$newMessageId.') is too old compared to the min value ('.$minMessageId.').', \danog\MadelineProto\Logger::WARNING); } $maxMessageId = (\time() + $this->session->time_delta + 30) << 32; if ($newMessageId > $maxMessageId) { throw new \danog\MadelineProto\Exception('Given message id ('.$newMessageId.') is too new compared to the max value ('.$maxMessageId.'). Please sync your date using NTP.'); } if ($aargs['outgoing']) { if ($newMessageId % 4) { throw new \danog\MadelineProto\Exception('Given message id ('.$newMessageId.') is not divisible by 4. Please sync your date using NTP.'); } if ($newMessageId <= $this->maxOutgoingId) { throw new \danog\MadelineProto\Exception('Given message id ('.$newMessageId.') is lower than or equal to the current limit ('.$this->maxOutgoingId.'). Please sync your date using NTP.'); } $this->maxOutgoingId = $newMessageId; } else { if (!($newMessageId % 2)) { throw new \danog\MadelineProto\Exception('message id mod 4 != 1 or 3'); } $key = $this->maxIncomingId; if ($aargs['container']) { if ($newMessageId >= $key) { $this->session->API->logger->logger('Given message id ('.$newMessageId.') is bigger than or equal to the current limit ('.$key.'). Please sync your date using NTP.', \danog\MadelineProto\Logger::ULTRA_VERBOSE); } } else { if ($newMessageId <= $key) { $this->session->API->logger->logger('Given message id ('.$newMessageId.') is lower than or equal to the current limit ('.$key.'). Please sync your date using NTP.', \danog\MadelineProto\Logger::ULTRA_VERBOSE); } } $this->maxIncomingId = $newMessageId; } } /** * Generate message ID. * */ public function generateMessageId(): string { $messageId = (\time() + $this->session->time_delta) << 32; if ($messageId <= $this->maxOutgoingId) { $messageId = $this->maxOutgoingId + 4; } $this->checkMessageId($messageId, ['outgoing' => true, 'container' => false]); return Tools::packSignedLong($messageId); } /** * Get maximum message ID. * * @param boolean $incoming Incoming or outgoing message ID * */ public function getMaxId(bool $incoming) { return $this->{$incoming ? 'maxIncomingId' : 'maxOutgoingId'}; } /** * Get readable representation of message ID. * */ protected static function toStringInternal(string $messageId): string { return (string) Tools::unpackSignedLong($messageId); } } <?php /** * SeqNoHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoSession; use danog\MadelineProto\MTProto\IncomingMessage; /** * Manages sequence number. */ trait SeqNoHandler { public $session_out_seq_no = 0; public $session_in_seq_no = 0; /** * @var ?string */ public $session_id; public function generateOutSeqNo($contentRelated) { $in = $contentRelated ? 1 : 0; $value = $this->session_out_seq_no; $this->session_out_seq_no += $in; //$this->API->logger->logger("OUT: $value + $in = ".$this->session_out_seq_no); return $value * 2 + $in; } public function checkInSeqNo(IncomingMessage $message): void { if ($message->hasSeqNo()) { $seq_no = $this->generateInSeqNo($message->isContentRelated()); if ($seq_no !== $message->getSeqNo()) { if ($message->isContentRelated()) { $this->session_in_seq_no -= 1; } $this->API->logger->logger('SECURITY WARNING: Seqno mismatch (should be '.$seq_no.', is '.$message->getSeqNo().", $message)", \danog\MadelineProto\Logger::ULTRA_VERBOSE); } } } public function generateInSeqNo($contentRelated) { $in = $contentRelated ? 1 : 0; $value = $this->session_in_seq_no; $this->session_in_seq_no += $in; //$this->API->logger->logger("IN: $value + $in = ".$this->session_in_seq_no); return $value * 2 + $in; } } <?php /** * ResponseHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoSession; use Amp\Deferred; use Amp\Failure; use Amp\Loop; use danog\MadelineProto\Coroutine; use danog\MadelineProto\Logger; use danog\MadelineProto\Loop\Update\UpdateLoop; use danog\MadelineProto\MTProto; use danog\MadelineProto\MTProto\IncomingMessage; use danog\MadelineProto\MTProto\OutgoingMessage; use danog\MadelineProto\Tools; /** * Manages responses. * * @extend Session */ trait ResponseHandler { public $n = 0; public function handleMessages(): void { while ($this->new_incoming) { \reset($this->new_incoming); $current_msg_id = \key($this->new_incoming); /** @var IncomingMessage */ $message = $this->new_incoming[$current_msg_id]; unset($this->new_incoming[$current_msg_id]); $this->logger->logger($message->log($this->datacenter), Logger::ULTRA_VERBOSE); $type = $message->getType(); if ($type !== 'msg_container') { $this->checkInSeqNo($message); } switch ($type) { case 'msgs_ack': foreach ($message->read()['msg_ids'] as $msg_id) { // Acknowledge that the server received my message $this->ackOutgoingMessageId($msg_id); } break; case 'rpc_result': $this->ackIncomingMessage($message); // no break case 'future_salts': case 'msgs_state_info': case 'bad_server_salt': case 'bad_msg_notification': case 'pong': $this->handleResponse($message); break; case 'new_session_created': $this->ackIncomingMessage($message); $this->shared->getTempAuthKey()->setServerSalt($message->read()['server_salt']); if ($this->API->authorized === MTProto::LOGGED_IN && !$this->API->isInitingAuthorization() && $this->API->datacenter->getDataCenterConnection($this->API->datacenter->curdc)->hasTempAuthKey() && isset($this->API->updaters[UpdateLoop::GENERIC])) { $this->API->updaters[UpdateLoop::GENERIC]->resumeDefer(); } break; case 'msg_container': foreach ($message->read()['messages'] as $message) { $this->msgIdHandler->checkMessageId($message['msg_id'], ['outgoing' => false, 'container' => true]); $newMessage = new IncomingMessage($message['body'], $message['msg_id'], true); $newMessage->setSeqNo($message['seqno']); $this->new_incoming[$message['msg_id']] = $this->incoming_messages[$message['msg_id']] = $newMessage; } unset($newMessage, $message); \ksort($this->new_incoming); break; case 'msg_copy': $this->ackIncomingMessage($message); $content = $message->read(); $referencedMsgId = $content['msg_id']; if (isset($this->incoming_messages[$referencedMsgId])) { $this->ackIncomingMessage($this->incoming_messages[$referencedMsgId]); } else { $this->msgIdHandler->checkMessageId($referencedMsgId, ['outgoing' => false, 'container' => true]); $message = new IncomingMessage($content['orig_message'], $referencedMsgId); $this->new_incoming[$referencedMsgId] = $this->incoming_messages[$referencedMsgId] = $message; unset($message); } unset($content, $referencedMsgId); break; case 'http_wait': $this->logger->logger($message->read(), Logger::NOTICE); break; case 'msgs_state_req': $this->sendMsgsStateInfo($message->read()['msg_ids'], $current_msg_id); break; case 'msgs_all_info': $this->onMsgsAllInfo($message->read()); break; case 'msg_detailed_info': $this->onMsgDetailedInfo($message->read()); break; case 'msg_new_detailed_info': $this->onNewMsgDetailedInfo($message->read()); break; case 'msg_resend_req': $this->onMsgResendReq($message->read(), $current_msg_id); break; case 'msg_resend_ans_req': $this->onMsgResendAnsReq($message->read(), $current_msg_id); break; default: $this->ackIncomingMessage($message); $response_type = $this->API->getTL()->getConstructors()->findByPredicate($message->getContent()['_'])['type']; if ($response_type == 'Updates') { if (!$this->isCdn()) { Tools::callForkDefer($this->API->handleUpdates($message->read())); } break; } $this->logger->logger('Trying to assign a response of type ' . $response_type . ' to its request...', Logger::VERBOSE); foreach ($this->new_outgoing as $expecting_msg_id => $expecting) { if (!$type = $expecting->getType()) { continue; } $this->logger->logger("Does the request of return type $type match?", Logger::VERBOSE); if ($response_type === $type) { $this->logger->logger('Yes', Logger::VERBOSE); $this->handleResponse($message, $expecting_msg_id); break 2; } $this->logger->logger('No', Logger::VERBOSE); } $this->logger->logger('Dunno how to handle ' . PHP_EOL . \var_export($message->read(), true), Logger::FATAL_ERROR); break; } } $this->new_incoming = []; if ($this->pendingOutgoing) { $this->writer->resume(); } } public function handleReject(OutgoingMessage $message, \Throwable $data): void { $this->gotResponseForOutgoingMessage($message); $message->reply(new Failure($data)); } /** * Handle RPC response. * * @param IncomingMessage $message Incoming message * @param string $requestId Request ID * */ private function handleResponse(IncomingMessage $message, $requestId = null): void { $requestId ??= $message->getRequestId(); $response = $message->read(); if (!isset($this->outgoing_messages[$requestId])) { $requestId = MsgIdHandler::toString($requestId); $this->logger->logger("Got a reponse $message with message ID $requestId, but there is no request!", Logger::FATAL_ERROR); return; } /** @var OutgoingMessage */ $request = $this->outgoing_messages[$requestId]; if ($request->getState() & OutgoingMessage::STATE_REPLIED) { $this->logger->logger("Already got a response to $request, but there is another reply $message with message ID $requestId!", Logger::FATAL_ERROR); return; } if ($response['_'] === 'rpc_result') { $response = $response['result']; } $constructor = $response['_'] ?? ''; if ($constructor === 'rpc_error') { try { $exception = $this->handleRpcError($request, $response); } catch (\Throwable $e) { $exception = $e; } if ($exception) { $this->handleReject($request, $exception); } return; } if ($constructor === 'bad_server_salt' || $constructor === 'bad_msg_notification') { $this->logger->logger('Received bad_msg_notification: ' . MTProto::BAD_MSG_ERROR_CODES[$response['error_code']], Logger::WARNING); switch ($response['error_code']) { case 48: $this->shared->getTempAuthKey()->setServerSalt($response['new_server_salt']); $this->methodRecall('', ['message_id' => $requestId, 'postpone' => true]); return; case 20: $request->setMsgId(null); $request->setSeqNo(null); $this->methodRecall('', ['message_id' => $requestId, 'postpone' => true]); return; case 16: case 17: $this->time_delta = (int) (new \phpseclib3\Math\BigInteger(\strrev($message->getMsgId()), 256))->bitwise_rightShift(32)->subtract(new \phpseclib3\Math\BigInteger(\time()))->toString(); $this->logger->logger('Set time delta to ' . $this->time_delta, Logger::WARNING); $this->API->resetMTProtoSession(); $this->shared->setTempAuthKey(null); Tools::callFork((function () use ($requestId): \Generator { yield from $this->API->initAuthorization(); $this->methodRecall('', ['message_id' => $requestId]); })()); return; } $this->handleReject($request, new \danog\MadelineProto\RPCErrorException('Received bad_msg_notification: ' . MTProto::BAD_MSG_ERROR_CODES[$response['error_code']], $response['error_code'], $request->getConstructor())); return; } if ($request->isMethod() && $request->getConstructor() !== 'auth.bindTempAuthKey' && $this->shared->hasTempAuthKey() && !$this->shared->getTempAuthKey()->isInited()) { $this->shared->getTempAuthKey()->init(true); } $botAPI = $request->getBotAPI(); if (isset($response['_']) && !$this->isCdn() && $this->API->getTL()->getConstructors()->findByPredicate($response['_'])['type'] === 'Updates') { $body = $request->getBodyOrEmpty(); $trimmed = $body; if (isset($trimmed['peer'])) { try { $trimmed['peer'] = \is_string($body['peer']) ? $body['peer'] : $this->API->getId($body['peer']); } catch (\Throwable $e) { } } if (isset($trimmed['message'])) { $trimmed['message'] = (string) $body['message']; } $response['request'] = ['_' => $request->getConstructor(), 'body' => $trimmed]; unset($body); Tools::callForkDefer($this->API->handleUpdates($response)); } $this->gotResponseForOutgoingMessage($request); if ($side = $message->getSideEffects($response)) { if ($botAPI) { $deferred = new Deferred; $promise = $deferred->promise(); $side->onResolve(function (?\Throwable $error, $result) use ($deferred): void { if ($error) { $deferred->fail($error); return; } $deferred->resolve(new Coroutine($this->API->MTProtoToBotAPI($result))); }); $request->reply($promise); } else { $request->reply($side); } } else { if ($botAPI) { $request->reply(new Coroutine($this->API->MTProtoToBotAPI($response))); } else { $request->reply($response); } } } public function handleRpcError(OutgoingMessage $request, array $response): ?\Throwable { if ($request->isMethod() && $request->getConstructor() !== 'auth.bindTempAuthKey' && $this->shared->hasTempAuthKey() && !$this->shared->getTempAuthKey()->isInited()) { $this->shared->getTempAuthKey()->init(true); } if (\in_array($response['error_message'], ['PERSISTENT_TIMESTAMP_EMPTY', 'PERSISTENT_TIMESTAMP_INVALID'])) { return new \danog\MadelineProto\PTSException($response['error_message']); } if ($response['error_message'] === 'PERSISTENT_TIMESTAMP_OUTDATED') { $response['error_code'] = 500; } if (\strpos($response['error_message'], 'FILE_REFERENCE_') === 0) { $this->logger->logger("Got {$response['error_message']}, refreshing file reference and repeating method call..."); $this->gotResponseForOutgoingMessage($request); $msgId = $request->getMsgId(); $request->setRefreshReferences(true); $request->setMsgId(null); $request->setSeqNo(null); $this->methodRecall('', ['message_id' => $msgId, 'postpone' => true]); return null; } switch ($response['error_code']) { case 500: case -500: if ($response['error_message'] === 'MSG_WAIT_FAILED') { $this->call_queue[$request->getQueueId()] = []; $this->methodRecall('', ['message_id' => $request->getMsgId(), 'postpone' => true]); return null; } if (\in_array($response['error_message'], ['MSGID_DECREASE_RETRY', 'HISTORY_GET_FAILED', 'RPC_CONNECT_FAILED', 'RPC_CALL_FAIL', 'PERSISTENT_TIMESTAMP_OUTDATED', 'RPC_MCGET_FAIL', 'no workers running', 'No workers running'])) { Loop::delay(1 * 1000, [$this, 'methodRecall'], ['message_id' => $request->getMsgId()]); return null; } return new \danog\MadelineProto\RPCErrorException($response['error_message'], $response['error_code'], $request->getConstructor()); case 303: $this->API->datacenter->curdc = $datacenter = (int) \preg_replace('/[^0-9]+/', '', $response['error_message']); if ($request->isFileRelated() && $this->API->datacenter->has($datacenter . '_media')) { $datacenter .= '_media'; } if ($request->isUserRelated()) { $this->API->settings->setDefaultDc($this->API->authorized_dc = $this->API->datacenter->curdc); } Loop::defer([$this, 'methodRecall'], ['message_id' => $request->getMsgId(), 'datacenter' => $datacenter]); //$this->API->methodRecall('', ['message_id' => $requestId, 'datacenter' => $datacenter, 'postpone' => true]); return null; case 401: switch ($response['error_message']) { case 'USER_DEACTIVATED': case 'USER_DEACTIVATED_BAN': case 'SESSION_REVOKED': case 'SESSION_EXPIRED': $this->logger->logger($response['error_message'], Logger::FATAL_ERROR); if (\in_array($response['error_message'], ['USER_DEACTIVATED', 'USER_DEACTIVATED_BAN'], true)) { $this->logger->logger('!!!!!!! WARNING !!!!!!!', Logger::FATAL_ERROR); $this->logger->logger("Telegram's flood prevention system suspended this account.", Logger::ERROR); $this->logger->logger('To continue, manual verification is required.', Logger::FATAL_ERROR); $phone = isset($this->API->authorization['user']['phone']) ? '+' . $this->API->authorization['user']['phone'] : 'you are currently using'; $this->logger->logger('Send an email to recover@telegram.org, asking to unban the phone number ' . $phone . ', and shortly describe what will you do with this phone number.', Logger::FATAL_ERROR); $this->logger->logger('Then login again.', Logger::FATAL_ERROR); $this->logger->logger('If you intentionally deleted this account, ignore this message.', Logger::FATAL_ERROR); } throw new \danog\MadelineProto\RPCErrorException($response['error_message'], $response['error_code'], $request->getConstructor()); case 'AUTH_KEY_UNREGISTERED': case 'AUTH_KEY_INVALID': if ($this->API->authorized !== MTProto::LOGGED_IN) { $this->gotResponseForOutgoingMessage($request); Tools::callFork((function () use ($request, $response): \Generator { yield from $this->API->initAuthorization(); $this->handleReject($request, new \danog\MadelineProto\RPCErrorException($response['error_message'], $response['error_code'], $request->getConstructor())); })()); return null; } $this->session_id = null; $this->shared->setTempAuthKey(null); $this->shared->setPermAuthKey(null); $this->logger->logger("Auth key not registered in DC {$this->datacenter} with RPC error {$response['error_message']}, resetting temporary and permanent auth keys...", Logger::ERROR); if ($this->API->authorized_dc == $this->datacenter && $this->API->authorized === MTProto::LOGGED_IN) { $this->logger->logger('Permanent auth key was main authorized key, logging out...', Logger::FATAL_ERROR); $this->logger->logger('!!!!!!! WARNING !!!!!!!', Logger::FATAL_ERROR); $this->logger->logger("Telegram's flood prevention system suspended this account.", Logger::ERROR); $this->logger->logger('To continue, manual verification is required.', Logger::FATAL_ERROR); $phone = isset($this->API->authorization['user']['phone']) ? '+' . $this->API->authorization['user']['phone'] : 'you are currently using'; $this->logger->logger('Send an email to recover@telegram.org, asking to unban the phone number ' . $phone . ', and quickly describe what will you do with this phone number.', Logger::FATAL_ERROR); $this->logger->logger('Then login again.', Logger::FATAL_ERROR); $this->logger->logger('If you intentionally deleted this account, ignore this message.', Logger::FATAL_ERROR); throw new \danog\MadelineProto\RPCErrorException($response['error_message'], $response['error_code'], $request->getConstructor()); } Tools::callFork((function () use ($request): \Generator { yield from $this->API->initAuthorization(); $this->methodRecall('', ['message_id' => $request->getMsgId()]); })()); return null; case 'AUTH_KEY_PERM_EMPTY': $this->logger->logger('Temporary auth key not bound, resetting temporary auth key...', Logger::ERROR); $this->shared->setTempAuthKey(null); Tools::callFork((function () use ($request): \Generator { yield from $this->API->initAuthorization(); $this->methodRecall('', ['message_id' => $request->getMsgId()]); })()); return null; } return new \danog\MadelineProto\RPCErrorException($response['error_message'], $response['error_code'], $request->getConstructor()); case 420: $seconds = \preg_replace('/[^0-9]+/', '', $response['error_message']); $limit = $request->getFloodWaitLimit() ?? $this->API->settings->getRPC()->getFloodTimeout(); if (\is_numeric($seconds) && $seconds < $limit) { $this->logger->logger("Flood, waiting $seconds seconds before repeating async call of $request...", Logger::NOTICE); $this->gotResponseForOutgoingMessage($request); $msgId = $request->getMsgId(); $request->setSent(($request->getSent() ?? \time()) + $seconds); $request->setMsgId(null); $request->setSeqNo(null); Loop::delay($seconds * 1000, [$this, 'methodRecall'], ['message_id' => $msgId]); return null; } // no break default: return new \danog\MadelineProto\RPCErrorException($response['error_message'], $response['error_code'], $request->getConstructor()); } } } <?php /** * CallHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoSession; use Amp\Deferred; use danog\MadelineProto\MTProto\Container; use danog\MadelineProto\MTProto\OutgoingMessage; use danog\MadelineProto\TL\Exception; use danog\MadelineProto\Tools; /** * Manages method and object calls. */ trait CallHandler { /** * Recall method. * * @param string $watcherId Watcher ID for defer * @param array $args Args * */ public function methodRecall(string $watcherId, array $args): void { $message_id = $args['message_id']; $postpone = $args['postpone'] ?? false; $datacenter = $args['datacenter'] ?? false; if ($datacenter === $this->datacenter) { $datacenter = false; } $message_ids = ($this->outgoing_messages[$message_id] ?? null) instanceof Container ? $this->outgoing_messages[$message_id]->getIds() : [$message_id]; foreach ($message_ids as $message_id) { if (isset($this->outgoing_messages[$message_id]) && !$this->outgoing_messages[$message_id]->canGarbageCollect()) { if ($datacenter) { /** @var OutgoingMessage */ $message = $this->outgoing_messages[$message_id]; $this->gotResponseForOutgoingMessage($message); $message->setMsgId(null); $message->setSeqNo(null); Tools::call($this->API->datacenter->waitGetConnection($datacenter))->onResolve(function ($e, $r) use ($message): void { Tools::callFork($r->sendMessage($message, false)); }); } else { /** @var OutgoingMessage */ $message = $this->outgoing_messages[$message_id]; if (!$message->hasSeqNo()) { $this->gotResponseForOutgoingMessage($message); } Tools::callFork($this->sendMessage($message, false)); } } else { $this->logger->logger('Could not resend '.($this->outgoing_messages[$message_id] ?? $message_id)); } } if (!$postpone) { if ($datacenter) { $this->API->datacenter->getDataCenterConnection($datacenter)->flush(); } else { $this->flush(); } } } /** * Call method and wait asynchronously for response. * * If the $aargs['noResponse'] is true, will not wait for a response. * * @param string $method Method name * @param array|\Generator $args Arguments * @param array $aargs Additional arguments * * @psalm-param array|\Generator<mixed, mixed, mixed, array> $args * */ public function methodCallAsyncRead(string $method, $args = [], array $aargs = ['msg_id' => null]): \Generator { $readDeferred = yield from $this->methodCallAsyncWrite($method, $args, $aargs); if (\is_array($readDeferred)) { $readDeferred = Tools::all(\array_map(fn (Deferred $value) => $value->promise(), $readDeferred)); } else { $readDeferred = $readDeferred->promise(); } if (!($aargs['noResponse'] ?? false)) { return yield $readDeferred; } } /** * Call method and make sure it is asynchronously sent (generator). * * @param string $method Method name * @param array|\Generator $args Arguments * @param array $aargs Additional arguments * * @psalm-param array|\Generator<mixed, mixed, mixed, array> $args * */ public function methodCallAsyncWrite(string $method, $args = [], array $aargs = ['msg_id' => null]): \Generator { if (\is_array($args) && isset($args['id']['_']) && isset($args['id']['dc_id']) && ($args['id']['_'] === 'inputBotInlineMessageID' || $args['id']['_'] === 'inputBotInlineMessageID64') && $this->datacenter != $args['id']['dc_id']) { $aargs['datacenter'] = $args['id']['dc_id']; return yield from $this->API->methodCallAsyncWrite($method, $args, $aargs); } if (($aargs['file'] ?? false) && !$this->isMedia() && $this->API->datacenter->has($this->datacenter.'_media')) { $this->logger->logger('Using media DC'); $aargs['datacenter'] = $this->datacenter.'_media'; return yield from $this->API->methodCallAsyncWrite($method, $args, $aargs); } if (\in_array($method, ['messages.setEncryptedTyping', 'messages.readEncryptedHistory', 'messages.sendEncrypted', 'messages.sendEncryptedFile', 'messages.sendEncryptedService', 'messages.receivedQueue'])) { $aargs['queue'] = 'secret'; } if (\is_array($args)) { if (isset($args['multiple'])) { $aargs['multiple'] = true; } if (isset($args['message']) && \is_string($args['message']) && \mb_strlen($args['message'], 'UTF-8') > (yield from $this->API->getConfig())['message_length_max'] && \mb_strlen($this->API->parseMode($args)['message'], 'UTF-8') > (yield from $this->API->getConfig())['message_length_max']) { $args = $this->API->splitToChunks($args); $promises = []; $aargs['queue'] = $method; $aargs['multiple'] = true; } if (isset($aargs['multiple'])) { $new_aargs = $aargs; $new_aargs['postpone'] = true; unset($new_aargs['multiple']); if (isset($args['multiple'])) { unset($args['multiple']); } $promises = []; foreach ($args as $single_args) { $promises[] = Tools::call($this->methodCallAsyncWrite($method, $single_args, $new_aargs)); } if (!isset($aargs['postpone'])) { $this->writer->resume(); } return yield Tools::all($promises); } $args = $this->API->botAPIToMTProto($args); if (isset($args['ping_id']) && \is_int($args['ping_id'])) { $args['ping_id'] = Tools::packSignedLong($args['ping_id']); } } $methodInfo = $this->API->getTL()->getMethods()->findByMethod($method); if (!$methodInfo) { throw new Exception("Could not find method $method!"); } $message = new OutgoingMessage( $args, $method, $methodInfo['type'], true, !$this->shared->hasTempAuthKey() && \strpos($method, '.') === false && $method !== 'ping_delay_disconnect' ); if (isset($aargs['queue'])) { $message->setQueueId($aargs['queue']); } if ($method === 'users.getUsers' && $args === ['id' => [['_' => 'inputUserSelf']]] || $method === 'auth.exportAuthorization' || $method === 'updates.getDifference') { $message->setUserRelated(true); } if (isset($aargs['msg_id'])) { $message->setMsgId($aargs['msg_id']); } if ($aargs['file'] ?? false) { $message->setFileRelated(true); } if ($aargs['botAPI'] ?? false) { $message->setBotAPI(true); } if (isset($aargs['FloodWaitLimit'])) { $message->setFloodWaitLimit($aargs['FloodWaitLimit']); } $aargs['postpone'] = $aargs['postpone'] ?? false; $deferred = yield from $this->sendMessage($message, !$aargs['postpone']); $this->checker->resume(); return $deferred; } /** * Send object and make sure it is asynchronously sent (generator). * * @param string $object Object name * @param array $args Arguments * @param array $aargs Additional arguments * */ public function objectCall(string $object, $args = [], array $aargs = ['msg_id' => null]): \Generator { $message = new OutgoingMessage( $args, $object, '', false, !$this->shared->hasTempAuthKey() ); if (isset($aargs['promise'])) { $message->setPromise($aargs['promise']); } $aargs['postpone'] = $aargs['postpone'] ?? false; return yield from $this->sendMessage($message, !$aargs['postpone']); } } <?php /** * Reliable module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\MTProtoSession; use danog\MadelineProto\MTProto; use danog\MadelineProto\Tools; /** * Manages responses. */ trait Reliable { /** * Called when receiving a new_msg_detailed_info. * */ public function onNewMsgDetailedInfo(array $content): void { if (isset($this->incoming_messages[$content['answer_msg_id']])) { $this->ackIncomingMessage($this->incoming_messages[$content['answer_msg_id']]); } else { Tools::callFork($this->objectCall('msg_resend_req', ['msg_ids' => [$content['answer_msg_id']]], ['postpone' => true])); } } /** * Called when receiving a msg_detailed_info. * */ public function onMsgDetailedInfo(array $content): void { if (isset($this->outgoing_messages[$content['msg_id']])) { $this->onNewMsgDetailedInfo($content); } } /** * Called when receiving a msg_resend_req. * * @param string $current_msg_id */ public function onMsgResendReq(array $content, $current_msg_id): void { $ok = true; foreach ($content['msg_ids'] as $msg_id) { if (!isset($this->outgoing_messages[$msg_id]) || isset($this->incoming_messages[$msg_id])) { $ok = false; } } if ($ok) { foreach ($content['msg_ids'] as $msg_id) { $this->methodRecall('', ['message_id' => $msg_id, 'postpone' => true]); } } else { $this->sendMsgsStateInfo($content['msg_ids'], $current_msg_id); } } /** * Called when receiving a msg_resend_ans_req. * * @param string $current_msg_id */ public function onMsgResendAnsReq(array $content, $current_msg_id): void { $this->sendMsgsStateInfo($content['msg_ids'], $current_msg_id); } /** * Called when receiving a msgs_all_info. * */ public function onMsgsAllInfo(array $content): void { foreach ($content['msg_ids'] as $key => $msg_id) { $info = \ord($content['info'][$key]); $msg_id = MsgIdHandler::toString($msg_id); $status = 'Status for message id '.$msg_id.': '; /*if ($info & 4) { *$this->gotResponseForOutgoingMessageId($msg_id); *} */ foreach (MTProto::MSGS_INFO_FLAGS as $flag => $description) { if (($info & $flag) !== 0) { $status .= $description; } } $this->logger->logger($status, \danog\MadelineProto\Logger::NOTICE); } } /** * Send state info for message IDs. * * @param array $msg_ids Message IDs to send info about * @param string|int $req_msg_id Message ID of msgs_state_req that initiated this * */ public function sendMsgsStateInfo(array $msg_ids, $req_msg_id): void { $this->logger->logger('Sending state info for '.\count($msg_ids).' message IDs'); $info = ''; foreach ($msg_ids as $msg_id) { $cur_info = 0; if (!isset($this->incoming_messages[$msg_id])) { $msg_id = new \phpseclib3\Math\BigInteger(\strrev($msg_id), 256); if ((new \phpseclib3\Math\BigInteger(\time() + $this->time_delta + 30))->bitwise_leftShift(32)->compare($msg_id) < 0) { $this->logger->logger("Do not know anything about {$msg_id} and it is too big"); $cur_info |= 3; } elseif ((new \phpseclib3\Math\BigInteger(\time() + $this->time_delta - 300))->bitwise_leftShift(32)->compare($msg_id) > 0) { $this->logger->logger("Do not know anything about {$msg_id} and it is too small"); $cur_info |= 1; } else { $this->logger->logger("Do not know anything about {$msg_id}"); $cur_info |= 2; } } else { $this->logger->logger("Know about {$msg_id}"); $cur_info = $this->incoming_messages[$msg_id]->getState(); } $info .= \chr($cur_info); } Tools::callFork($this->objectCall('msgs_state_info', ['req_msg_id' => $req_msg_id, 'info' => $info], ['postpone' => true])); } } <?php namespace danog\MadelineProto\Db; use Amp\Iterator; use Amp\Producer; use Amp\Promise; use Amp\Redis\Redis as RedisRedis; use Amp\Success; use danog\MadelineProto\Db\Driver\Redis as Redis; use danog\MadelineProto\Logger; use danog\MadelineProto\Settings\Database\Redis as DatabaseRedis; use Generator; use function Amp\call; /** * Redis database backend. */ class RedisArray extends DriverArray { protected DatabaseRedis $dbSettings; private RedisRedis $db; // Legacy protected array $settings; /** * Initialize on startup. * */ public function initStartup(): \Generator { return $this->initConnection($this->dbSettings); } /** * * @psalm-return Generator<int, Success<null>, mixed, void> */ protected function prepareTable(): Generator { yield new Success; } protected function renameTable(string $from, string $to): \Generator { Logger::log("Moving data from {$from} to {$to}", Logger::WARNING); $from = "va:$from"; $to = "va:$to"; $request = $this->db->scan($from.'*'); $lenK = \strlen($from); while (yield $request->advance()) { $oldKey = $request->getCurrent(); $newKey = $to.\substr($oldKey, $lenK); $value = yield $this->db->get($oldKey); $this->db->set($newKey, $value); $this->db->delete($oldKey); } } /** * Initialize connection. * * @param DatabaseRedis $settings */ public function initConnection($settings): \Generator { if (!isset($this->db)) { $this->db = yield from Redis::getConnection($settings); } } /** * Get redis key name. * */ private function rKey(string $key): string { return 'va:'.$this->table.':'.$key; } /** * Get redis ts name. * */ private function tsKey(string $key): string { return 'ts:'.$this->table.$key; } /** * Get iterator key. * */ private function itKey(): string { return 'va:'.$this->table.'*'; } /** * Set value for an offset. * * @link https://php.net/manual/en/arrayiterator.offsetset.php * * @param string $index <p> * The index to set for. * </p> * * @throws \Throwable */ public function set(string|int $index, mixed $value): Promise { if ($this->hasCache($index) && $this->getCache($index) === $value) { return new Success(); } $this->setCache($index, $value); $request = $this->db->set($this->rKey($index), \serialize($value)); //Ensure that cache is synced with latest insert in case of concurrent requests. $request->onResolve(fn () => $this->setCache($index, $value)); return $request; } public function offsetGet(mixed $offset): Promise { $offset = (string) $offset; return call(function () use ($offset) { if ($this->hasCache($offset)) { return $this->getCache($offset); } $value = yield $this->db->get($this->rKey($offset)); if ($value !== null && $value = \unserialize($value)) { $this->setCache($offset, $value); } return $value; }); } public function unset(string|int $key): Promise { $this->unsetCache($key); return $this->db->delete($this->rkey($key)); } /** * Get array copy. * * @return Promise<array> * @throws \Throwable */ #[\ReturnTypeWillChange] public function getArrayCopy(): Promise { return call(function () { $iterator = $this->getIterator(); $result = []; while (yield $iterator->advance()) { [$key, $value] = $iterator->getCurrent(); $result[$key] = $value; } return $result; }); } public function getIterator(): Iterator { return new Producer(function (callable $emit) { $request = $this->db->scan($this->itKey()); $len = \strlen($this->rKey('')); while (yield $request->advance()) { $key = $request->getCurrent(); yield $emit([\substr($key, $len), \unserialize(yield $this->db->get($key))]); } }); } /** * Count elements. * * @link https://php.net/manual/en/arrayiterator.count.php * @return Promise<int> The number of elements or public properties in the associated * array or object, respectively. * @throws \Throwable */ public function count(): Promise { return call(function () { $request = $this->db->scan($this->itKey()); $count = 0; while (yield $request->advance()) { $count++; } return $count; }); } /** * Clear all elements. * */ public function clear(): Promise { $this->clearCache(); return call(function () { $request = $this->db->scan($this->itKey()); $keys = []; $k = 0; while (yield $request->advance()) { $keys[$k++] = $request->getCurrent(); if ($k === 10) { yield $this->db->delete(...$keys); $keys = []; $k = 0; } } if (!empty($keys)) { yield $this->db->delete(...$keys); } }); } } <?php namespace danog\MadelineProto\Db; use danog\MadelineProto\MTProto; use danog\MadelineProto\Tools; /** * Include this trait and call DbPropertiesTrait::initDb to use MadelineProto's database backend for properties. * * You will have to define a `$dbProperties` static array property, with a list of properties you want to store to a database. * * @see DbPropertiesFactory For a list of allowed property types * * @property array<string, DbPropertiesFactory::TYPE_*> $dbProperties */ trait DbPropertiesTrait { public ?string $tmpDbPrefix = null; /** * Initialize database instance. * * @internal * * @param boolean $reset */ public function initDb(MTProto $MadelineProto, bool $reset = false): \Generator { if (empty(static::$dbProperties)) { throw new \LogicException(static::class.' must have $dbProperties'); } $dbSettings = $MadelineProto->settings->getDb(); $prefix = static::getSessionId($MadelineProto); $promises = []; foreach (static::$dbProperties as $property => $type) { if ($reset) { unset($this->{$property}); } else { $table = "{$prefix}_{$property}"; $promises[$property] = DbPropertiesFactory::get($dbSettings, $table, $type, $this->{$property}); } } $promises = yield Tools::all($promises); foreach ($promises as $key => $data) { $this->{$key} = $data; } } private static function getSessionId(MTProto $madelineProto): string { $result = $madelineProto->getSelf()['id'] ?? null; if (!$result) { $madelineProto->tmpDbPrefix ??= 'tmp_'.\str_replace('0', '', \spl_object_hash($madelineProto)); $result = $madelineProto->tmpDbPrefix; } $className = \explode('\\', static::class); $result .= '_'.\end($className); return $result; } } <?php namespace danog\MadelineProto\Db; use Amp\Promise; use danog\MadelineProto\Settings\Database\DatabaseAbstract as DatabaseDatabaseAbstract; use danog\MadelineProto\Settings\Database\Memory; use danog\MadelineProto\Settings\Database\Mysql; use danog\MadelineProto\Settings\Database\Postgres; use danog\MadelineProto\Settings\Database\Redis; use danog\MadelineProto\Settings\DatabaseAbstract; /** * This factory class initializes the correct database backend for MadelineProto. */ abstract class DbPropertiesFactory { /** * Indicates a simple K-V array stored in a database backend. * Values can be objects or other arrays, but when lots of nesting is required, it's best to split the array into multiple arrays. */ const TYPE_ARRAY = 'array'; /** * @param self::TYPE_*|array $propertyType * @param DriverArray|null $value * * @return Promise<DbType> * * @internal * * @uses \danog\MadelineProto\Db\MemoryArray * @uses \danog\MadelineProto\Db\MysqlArray * @uses \danog\MadelineProto\Db\PostgresArray * @uses \danog\MadelineProto\Db\RedisArray */ public static function get(DatabaseAbstract $dbSettings, string $table, $propertyType, $value = null): Promise { $config = $propertyType['config'] ?? []; $propertyType = \is_array($propertyType) ? $propertyType['type'] : $propertyType; $propertyType = \strtolower($propertyType); $class = $dbSettings instanceof DatabaseDatabaseAbstract && (!($config['enableCache'] ?? true) || !$dbSettings->getCacheTtl()) ? __NAMESPACE__.'\\NullCache' : __NAMESPACE__; switch (true) { case $dbSettings instanceof Memory: $class .= '\\Memory'; break; case $dbSettings instanceof Mysql: $class .= '\\Mysql'; break; case $dbSettings instanceof Postgres: $class .= '\\Postgres'; break; case $dbSettings instanceof Redis: $class .= '\\Redis'; break; default: throw new \InvalidArgumentException("Unknown dbType: ".\get_class($dbSettings)); } /** @var DbType $class */ switch (\strtolower($propertyType)) { case self::TYPE_ARRAY: $class .= 'Array'; break; default: throw new \InvalidArgumentException("Unknown $propertyType: {$propertyType}"); } return $class::getInstance($table, $value, $dbSettings); } } <?php namespace danog\MadelineProto\Db; use Amp\Loop; use danog\MadelineProto\Logger; /** * Array caching trait. */ trait ArrayCacheTrait { /** * @var array<mixed> */ private array $cache = []; /** * @var array<int> */ private array $ttl = []; private int $cacheTtl = 5 * 60; /** * Cache cleanup watcher ID. */ private ?string $cacheCleanupId = null; protected function setCacheTtl(int $ttl): void { $this->cacheTtl = $ttl; } protected function getCache(string $key) { $this->ttl[$key] = \time() + $this->cacheTtl; return $this->cache[$key]; } protected function hasCache(string $key): bool { return isset($this->ttl[$key]); } /** * Save item in cache. * */ protected function setCache(string $key, $value): void { $this->cache[$key] = $value; $this->ttl[$key] = \time() + $this->cacheTtl; } /** * Remove key from cache. * */ protected function unsetCache(string $key): void { unset($this->cache[$key], $this->ttl[$key]); } protected function startCacheCleanupLoop(): void { $this->cacheCleanupId = Loop::repeat( \max(1000, ($this->cacheTtl * 1000) / 5), fn () => $this->cleanupCache(), ); } protected function stopCacheCleanupLoop(): void { if ($this->cacheCleanupId) { Loop::cancel($this->cacheCleanupId); $this->cacheCleanupId = null; } } protected function clearCache(): void { $this->cache = []; $this->ttl = []; } /** * Remove all keys from cache. */ private function cleanupCache(): void { $newValues = []; $newTtl = []; $now = \time(); $oldCount = 0; foreach ($this->ttl as $key => $ttl) { if ($ttl < $now) { $oldCount++; } else { $newTtl[$key] = $this->ttl[$key]; $newValues[$key] = $this->cache[$key]; } } $this->ttl = $newTtl; $this->cache = $newValues; Logger::log( \sprintf( "cache for table: %s; keys left: %s; keys removed: %s", (string) $this, \count($this->cache), $oldCount ), Logger::VERBOSE ); } } <?php namespace danog\MadelineProto\Db; use Amp\Postgres\ConnectionConfig; use Amp\Promise; use danog\MadelineProto\Db\Driver\Postgres; use danog\MadelineProto\Exception; use danog\MadelineProto\Logger; use danog\MadelineProto\Settings\Database\Postgres as DatabasePostgres; /** * Postgres database backend. */ class PostgresArray extends SqlArray { public DatabasePostgres $dbSettings; // Legacy protected array $settings; /** * Prepare statements. * * @param SqlArray::STATEMENT_* $type * */ protected function getSqlQuery(int $type): string { switch ($type) { case SqlArray::SQL_GET: return "SELECT value FROM \"{$this->table}\" WHERE key = :index"; case SqlArray::SQL_SET: return " INSERT INTO \"{$this->table}\" (key,value) VALUES (:index, :value) ON CONFLICT (key) DO UPDATE SET value = :value "; case SqlArray::SQL_UNSET: return " DELETE FROM \"{$this->table}\" WHERE key = :index "; case SqlArray::SQL_COUNT: return " SELECT count(key) as count FROM \"{$this->table}\" "; case SqlArray::SQL_ITERATE: return " SELECT key, value FROM \"{$this->table}\" "; case SqlArray::SQL_CLEAR: return " DELETE FROM \"{$this->table}\" "; } throw new Exception("An invalid statement type $type was provided!"); } /** * Initialize on startup. * */ public function initStartup(): \Generator { $this->setTable($this->table); yield from $this->initConnection($this->dbSettings); } /** * Initialize connection. * * @param DatabasePostgres $settings */ public function initConnection($settings): \Generator { $config = ConnectionConfig::fromString("host=".\str_replace("tcp://", "", $settings->getUri())); $host = $config->getHost(); $port = $config->getPort(); $this->pdo = new \PDO( "pgsql:host={$host};port={$port}", $settings->getUsername(), $settings->getPassword() ); if (!isset($this->db)) { $this->db = yield from Postgres::getConnection($settings); } } protected function getValue(string $value): mixed { return \unserialize(\hex2bin($value)); } protected function setValue(mixed $value): string { return \bin2hex(\serialize($value)); } /** * Create table for property. * * * @throws \Throwable * * @psalm-return \Generator<int, Promise, mixed, void> */ protected function prepareTable(): \Generator { Logger::log("Creating/checking table {$this->table}", Logger::WARNING); yield $this->db->query(" CREATE TABLE IF NOT EXISTS \"{$this->table}\" ( \"key\" VARCHAR(255) PRIMARY KEY NOT NULL, \"value\" TEXT NOT NULL ); "); } protected function renameTable(string $from, string $to): \Generator { Logger::log("Moving data from {$from} to {$to}", Logger::WARNING); yield $this->db->query(/** @lang PostgreSQL */ " ALTER TABLE \"$from\" RENAME TO \"$to\"; "); } } <?php namespace danog\MadelineProto\Db; use Amp\Promise; use danog\MadelineProto\Settings\Database\DatabaseAbstract; interface DbType { /** * @param null|DbType|array $previous * @param DatabaseAbstract $settings * * @return Promise<self> */ public static function getInstance(string $table, $previous, $settings): Promise; } <?php namespace danog\MadelineProto\Db; use Amp\Iterator; use Amp\Producer; use Amp\Promise; use Amp\Success; use danog\MadelineProto\Logger; use danog\MadelineProto\Settings\Database\Memory; use function Amp\call; /** * Memory database backend. */ class MemoryArray extends \ArrayIterator implements DbArray { public function __construct($array = [], $flags = 0) { parent::__construct((array) $array, $flags | self::STD_PROP_LIST); } /** * Get instance. * * @param Memory $settings * @return Promise<self> */ public static function getInstance(string $table, $previous, $settings): Promise { return call(static function () use ($previous) { if ($previous instanceof MemoryArray) { return $previous; } if ($previous instanceof DbArray) { Logger::log("Loading database to memory. Please wait.", Logger::WARNING); if ($previous instanceof DriverArray) { yield from $previous->initStartup(); } $temp = yield $previous->getArrayCopy(); yield $previous->clear(); $previous = $temp; } return new static($previous); }); } public function set(string|int $key, mixed $value): Promise { parent::offsetSet($key, $value); return new Success(); } public function isset(string|int $key): Promise { return new Success(parent::offsetExists($key)); } public function unset(string|int $key): Promise { parent::offsetUnset($key); return new Success(); } public function offsetExists(mixed $offset): bool { throw new \RuntimeException('Native isset not support promises. Use isset method'); } public function offsetGet(mixed $offset): Promise { return new Success(parent::offsetExists($offset) ? parent::offsetGet($offset) : null); } public function offsetUnset(mixed $offset): void { parent::offsetUnset($offset); } #[\ReturnTypeWillChange] public function count(): Promise { return new Success(parent::count()); } #[\ReturnTypeWillChange] public function getArrayCopy(): Promise { return new Success(parent::getArrayCopy()); } public function clear(): Promise { parent::__construct([], parent::getFlags()); return new Success(); } public function getIterator(): Iterator { return new Producer(function (callable $emit) { foreach ($this as $key => $value) { yield $emit([$key, $value]); } }); } } <?php namespace danog\MadelineProto\Db\Driver; use Amp\Redis\Config; use Amp\Redis\Redis as RedisRedis; use Amp\Redis\RemoteExecutorFactory; use danog\MadelineProto\Settings\Database\Redis as DatabaseRedis; /** * Redis driver wrapper. * * @internal */ class Redis { /** @var RedisRedis[] */ private static array $connections = []; /** * * @throws \Amp\Sql\ConnectionException * @throws \Amp\Sql\FailureException * @throws \Throwable * * * @psalm-return \Generator<int, \Amp\Promise<void>, mixed, RedisRedis> */ public static function getConnection(DatabaseRedis $settings): \Generator { $dbKey = $settings->getKey(); if (empty(static::$connections[$dbKey])) { $config = Config::fromUri($settings->getUri()) ->withPassword($settings->getPassword()) ->withDatabase($settings->getDatabase()); static::$connections[$dbKey] = new RedisRedis((new RemoteExecutorFactory($config))->createQueryExecutor()); yield static::$connections[$dbKey]->ping(); } return static::$connections[$dbKey]; } } <?php namespace danog\MadelineProto\Db\Driver; use Amp\Postgres\ConnectionConfig; use Amp\Postgres\Pool; use danog\MadelineProto\Logger; use danog\MadelineProto\Settings\Database\Postgres as DatabasePostgres; use function Amp\Postgres\Pool; /** * Postgres driver wrapper. * * @internal */ class Postgres { /** @var Pool[] */ private static array $connections = []; /** * * * @throws \Amp\Sql\ConnectionException * @throws \Amp\Sql\FailureException * @throws \Throwable * * @return \Generator<Pool> */ public static function getConnection(DatabasePostgres $settings): \Generator { $dbKey = $settings->getKey(); if (empty(static::$connections[$dbKey])) { $config = ConnectionConfig::fromString("host=".\str_replace("tcp://", "", $settings->getUri())) ->withUser($settings->getUsername()) ->withPassword($settings->getPassword()) ->withDatabase($settings->getDatabase()); yield from static::createDb($config); static::$connections[$dbKey] = new Pool($config, $settings->getMaxConnections(), $settings->getIdleTimeout()); } return static::$connections[$dbKey]; } /** * * @throws \Amp\Sql\ConnectionException * @throws \Amp\Sql\FailureException * @throws \Throwable */ private static function createDb(ConnectionConfig $config): \Generator { try { $db = $config->getDatabase(); $user = $config->getUser(); $connection = pool($config->withDatabase(null)); $result = yield $connection->query("SELECT * FROM pg_database WHERE datname = '{$db}'"); while (yield $result->advance()) { $row = $result->getCurrent(); if ($row===false) { yield $connection->query(" CREATE DATABASE {$db} OWNER {$user} ENCODING utf8 "); } } yield $connection->query(" CREATE OR REPLACE FUNCTION update_ts() RETURNS TRIGGER AS $$ BEGIN IF row(NEW.*) IS DISTINCT FROM row(OLD.*) THEN NEW.ts = now(); RETURN NEW; ELSE RETURN OLD; END IF; END; $$ language 'plpgsql' "); $connection->close(); } catch (\Throwable $e) { Logger::log($e->getMessage(), Logger::ERROR); } } } <?php namespace danog\MadelineProto\Db\Driver; use Amp\Mysql\ConnectionConfig; use Amp\Mysql\Pool; use danog\MadelineProto\Logger; use danog\MadelineProto\Settings\Database\Mysql as DatabaseMysql; use function Amp\Mysql\Pool; /** * MySQL driver wrapper. * * @internal */ class Mysql { /** @var Pool[] */ private static array $connections = []; /** * * * @throws \Amp\Sql\ConnectionException * @throws \Amp\Sql\FailureException * @throws \Throwable * * @return \Generator<Pool> */ public static function getConnection(DatabaseMysql $settings): \Generator { $dbKey = $settings->getKey(); if (empty(static::$connections[$dbKey])) { $config = ConnectionConfig::fromString("host=".\str_replace("tcp://", "", $settings->getUri())) ->withUser($settings->getUsername()) ->withPassword($settings->getPassword()) ->withDatabase($settings->getDatabase()); yield from static::createDb($config); static::$connections[$dbKey] = new Pool($config, $settings->getMaxConnections(), $settings->getIdleTimeout()); } return static::$connections[$dbKey]; } /** * * @throws \Amp\Sql\ConnectionException * @throws \Amp\Sql\FailureException * @throws \Throwable * */ private static function createDb(ConnectionConfig $config): \Generator { try { $db = $config->getDatabase(); $connection = pool($config->withDatabase(null)); yield $connection->query(" CREATE DATABASE IF NOT EXISTS `{$db}` CHARACTER SET 'utf8mb4' COLLATE 'utf8mb4_general_ci' "); $connection->close(); } catch (\Throwable $e) { Logger::log($e->getMessage(), Logger::ERROR); } } } <?php namespace danog\MadelineProto\Db; use Amp\Mysql\ConnectionConfig; use Amp\Promise; use danog\MadelineProto\Db\Driver\Mysql; use danog\MadelineProto\Exception; use danog\MadelineProto\Logger; use danog\MadelineProto\Settings\Database\Mysql as DatabaseMysql; /** * MySQL database backend. */ class MysqlArray extends SqlArray { protected DatabaseMysql $dbSettings; // Legacy protected array $settings; /** * Initialize on startup. * */ public function initStartup(): \Generator { $this->setTable($this->table); yield from $this->initConnection($this->dbSettings); } /** * Prepare statements. * * @param SqlArray::STATEMENT_* $type * */ protected function getSqlQuery(int $type): string { switch ($type) { case SqlArray::SQL_GET: return "SELECT `value` FROM `{$this->table}` WHERE `key` = :index LIMIT 1"; case SqlArray::SQL_SET: return " REPLACE INTO `{$this->table}` SET `key` = :index, `value` = :value "; case SqlArray::SQL_UNSET: return " DELETE FROM `{$this->table}` WHERE `key` = :index "; case SqlArray::SQL_COUNT: return " SELECT count(`key`) as `count` FROM `{$this->table}` "; case SqlArray::SQL_ITERATE: return " SELECT `key`, `value` FROM `{$this->table}` "; case SqlArray::SQL_CLEAR: return " DELETE FROM `{$this->table}` "; } throw new Exception("An invalid statement type $type was provided!"); } /** * Initialize connection. * * @param DatabaseMysql $settings */ public function initConnection($settings): \Generator { $config = ConnectionConfig::fromString("host=".\str_replace("tcp://", "", $settings->getUri())); $host = $config->getHost(); $port = $config->getPort(); $this->pdo = new \PDO( "mysql:host={$host};port={$port};charset=UTF8", $settings->getUsername(), $settings->getPassword() ); if (!isset($this->db)) { $this->db = yield from Mysql::getConnection($settings); } } /** * Create table for property. * * * @throws \Throwable * * @psalm-return \Generator<int, Promise, mixed, mixed> */ protected function prepareTable(): \Generator { Logger::log("Creating/checking table {$this->table}", Logger::WARNING); return yield $this->db->query(" CREATE TABLE IF NOT EXISTS `{$this->table}` ( `key` VARCHAR(255) NOT NULL, `value` MEDIUMBLOB NULL, `ts` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`key`) ) ENGINE = InnoDB CHARACTER SET 'utf8mb4' COLLATE 'utf8mb4_general_ci' "); } protected function renameTable(string $from, string $to): \Generator { Logger::log("Moving data from {$from} to {$to}", Logger::WARNING); yield $this->db->query(" REPLACE INTO `{$to}` SELECT * FROM `{$from}`; "); yield $this->db->query(" DROP TABLE `{$from}`; "); } } <?php namespace danog\MadelineProto\Db\NullCache; use danog\MadelineProto\Db\RedisArray as DbRedisArray; /** * Redis database backend, no caching. * * @internal */ class RedisArray extends DbRedisArray { use NullCacheTrait; } <?php namespace danog\MadelineProto\Db\NullCache; /** * Trait that disables database caching. * * @internal */ trait NullCacheTrait { protected function setCacheTtl(int $ttl): void { } protected function hasCache(string $key): bool { return false; } /** * @return null */ protected function getCache(string $key) { throw new \RuntimeException('Not implemented!'); } /** * Save item in cache. * */ protected function setCache(string $key, $value): void { } /** * Remove key from cache. * */ protected function unsetCache(string $key): void { } protected function clearCache(): void { } protected function startCacheCleanupLoop(): void { } protected function stopCacheCleanupLoop(): void { } } <?php namespace danog\MadelineProto\Db\NullCache; use danog\MadelineProto\Db\PostgresArray as DbPostgresArray; /** * Postgres database backend, no caching. * * @internal */ class PostgresArray extends DbPostgresArray { use NullCacheTrait; } <?php namespace danog\MadelineProto\Db\NullCache; use danog\MadelineProto\Db\MysqlArray as DbMysqlArray; /** * MySQL database backend, no caching. * * @internal */ class MysqlArray extends DbMysqlArray { use NullCacheTrait; } <?php namespace danog\MadelineProto\Db; use Amp\Iterator; use Amp\Promise; /** * DB array interface. * * @template T as mixed */ interface DbArray extends DbType, \ArrayAccess { /** * Get Array copy. * * @psalm-return Promise<array<string|int, T>> * */ public function getArrayCopy(): Promise; /** * Check if element is set. * * * @psalm-return Promise<bool> * */ public function isset(string|int $key): Promise; /** * Unset element. * * * @psalm-return Promise<mixed> * */ public function unset(string|int $key): Promise; /** * Set element. * * * @psalm-param T $value * */ public function set(string|int $key, mixed $value): Promise; /** * Get element. * * @param string|int $index * * @psalm-return Promise<T> * */ public function offsetGet(mixed $index): Promise; /** * Set element. * * @param string|int $index * * @psalm-param T $value * * @return void */ #[\ReturnTypeWillChange] public function offsetSet(mixed $index, mixed $value); /** * @deprecated * @internal * @see DbArray::unset(); * * Unset element. * * @param string|int $index Offset */ public function offsetUnset(mixed $index): void; /** * @deprecated * @internal * @see DbArray::isset(); * * */ public function offsetExists(mixed $index): bool; /** * Count number of elements. * * @return Promise<integer> */ public function count(): Promise; /** * Clear all elements. * */ public function clear(): Promise; /** * Get iterator. * * @return Iterator<array{0: string|int, 1: T}> */ public function getIterator(): Iterator; } <?php namespace danog\MadelineProto\Db; use Amp\Iterator; use Amp\Producer; use Amp\Promise; use Amp\Sql\CommandResult; use Amp\Sql\Pool; use Amp\Sql\ResultSet; use Amp\Success; use Throwable; use Webmozart\Assert\Assert; use function Amp\call; /** * Generic SQL database backend. */ abstract class SqlArray extends DriverArray { protected Pool $db; //Pdo driver used for value quoting, to prevent sql injections. protected \PDO $pdo; protected const SQL_GET = 0; protected const SQL_SET = 1; protected const SQL_UNSET = 2; protected const SQL_COUNT = 3; protected const SQL_ITERATE = 4; protected const SQL_CLEAR = 5; /** * @var array<self::SQL_*, string> */ private array $queries = []; /** * Prepare statements. * * @param SqlArray::SQL_* $type * */ abstract protected function getSqlQuery(int $type): string; public function setTable(string $table): DriverArray { $this->table = $table; $this->queries = [ self::SQL_GET => $this->getSqlQuery(self::SQL_GET), self::SQL_SET => $this->getSqlQuery(self::SQL_SET), self::SQL_UNSET => $this->getSqlQuery(self::SQL_UNSET), self::SQL_COUNT => $this->getSqlQuery(self::SQL_COUNT), self::SQL_ITERATE => $this->getSqlQuery(self::SQL_ITERATE), self::SQL_CLEAR => $this->getSqlQuery(self::SQL_CLEAR), ]; return $this; } /** * Deserialize retrieved value. */ protected function getValue(string $value): mixed { return \unserialize($value); } /** * Serialize retrieved value. */ protected function setValue(mixed $value): string { return \serialize($value); } /** * @return Iterator<array{0: string, 1: mixed}> */ public function getIterator(): Iterator { return new Producer(function (callable $emit) { $request = yield $this->execute($this->queries[self::SQL_ITERATE]); while (yield $request->advance()) { $row = $request->getCurrent(); yield $emit([$row['key'], $this->getValue($row['value'])]); } }); } #[\ReturnTypeWillChange] public function getArrayCopy(): Promise { return call(function () { $iterator = $this->getIterator(); $result = []; while (yield $iterator->advance()) { [$key, $value] = $iterator->getCurrent(); $result[$key] = $value; } return $result; }); } public function offsetGet(mixed $key): Promise { $key = (string) $key; if ($this->hasCache($key)) { return new Success($this->getCache($key)); } return call(function () use ($key) { $row = yield $this->execute($this->queries[self::SQL_GET], ['index' => $key]); if (!yield $row->advance()) { return null; } $row = $row->getCurrent(); if ($value = $this->getValue($row['value'])) { $this->setCache($key, $value); } return $value; }); } public function set(string|int $key, mixed $value): Promise { $key = (string) $key; if ($this->hasCache($key) && $this->getCache($key) === $value) { return new Success(); } $this->setCache($key, $value); $request = $this->execute( $this->queries[self::SQL_SET], [ 'index' => $key, 'value' => $this->setValue($value), ] ); //Ensure that cache is synced with latest insert in case of concurrent requests. $request->onResolve(function (?Throwable $err, ?CommandResult $result) use ($key, $value): void { if ($err) { throw $err; } Assert::greaterThanEq($result->getAffectedRowCount(), 1); $this->setCache($key, $value); }); return $request; } /** * Unset value for an offset. * * @link https://php.net/manual/en/arrayiterator.offsetunset.php * * * @return Promise<array> * @throws \Throwable */ public function unset(string|int $key): Promise { $key = (string) $key; $this->unsetCache($key); return $this->execute( $this->queries[self::SQL_UNSET], ['index' => $key] ); } /** * Count elements. * * @link https://php.net/manual/en/arrayiterator.count.php * @return Promise<int> The number of elements or public properties in the associated * array or object, respectively. * @throws \Throwable */ public function count(): Promise { return call(function () { /** @var ResultSet */ $row = yield $this->execute($this->queries[self::SQL_COUNT]); Assert::true(yield $row->advance()); return $row->getCurrent()['count']; }); } /** * Clear all elements. * * @return Promise<CommandResult> */ public function clear(): Promise { $this->clearCache(); return $this->execute($this->queries[self::SQL_CLEAR]); } /** * Perform async request to db. * * * @psalm-param self::STATEMENT_* $stmt * * @return Promise<CommandResult|ResultSet> * @throws \Throwable */ protected function execute(string $sql, array $params = []): Promise { if ( isset($params['index']) && !\mb_check_encoding($params['index'], 'UTF-8') ) { $params['index'] = \mb_convert_encoding($params['index'], 'UTF-8'); } foreach ($params as $key => $value) { $value = $this->pdo->quote($value); $sql = \str_replace(":$key", $value, $sql); } return $this->db->query($sql); } } <?php namespace danog\MadelineProto\Db; use Amp\Promise; use danog\MadelineProto\Logger; use danog\MadelineProto\Settings\Database\DatabaseAbstract; use danog\MadelineProto\Settings\Database\Memory; use danog\MadelineProto\SettingsAbstract; use ReflectionClass; use function Amp\call; /** * Array caching trait. */ abstract class DriverArray implements DbArray { protected string $table; use ArrayCacheTrait; /** * Initialize connection. */ abstract public function initConnection(DatabaseAbstract $settings): \Generator; /** * Initialize on startup. * */ abstract public function initStartup(): \Generator; /** * Create table for property. * * * @throws \Throwable */ abstract protected function prepareTable(): \Generator; /** * Rename table. * */ abstract protected function renameTable(string $from, string $to): \Generator; /** * Get the value of table. * */ public function getTable(): string { return $this->table; } /** * Set the value of table. * * */ public function setTable(string $table): self { $this->table = $table; return $this; } /** * Check if key isset. * * @param mixed $key * * @return Promise<bool> true if the offset exists, otherwise false */ public function isset(string|int $key): Promise { return call(function () use ($key) { return null !== yield $this->offsetGet($key); }); } /** * @param DbArray|array|null $previous * @param DatabaseAbstract $settings * * * @psalm-return Promise<static> */ public static function getInstance(string $table, $previous, $settings): Promise { $instance = new static(); $instance->setTable($table); /** @psalm-suppress UndefinedPropertyAssignment */ $instance->dbSettings = $settings; $instance->setCacheTtl($settings->getCacheTtl()); $instance->startCacheCleanupLoop(); return call(static function () use ($instance, $previous, $settings) { yield from $instance->initConnection($settings); yield from $instance->prepareTable(); if (static::getClassName($previous) !== static::getClassName($instance)) { if ($previous instanceof DriverArray) { yield from $previous->initStartup(); } yield from static::renameTmpTable($instance, $previous); yield from static::migrateDataToDb($instance, $previous); } return $instance; }); } /** * Rename table of old database, if the new one is not a temporary table name. * * Otherwise, simply change name of table in new database to match old table name. * * @param self $new New db * @param DbArray|array|null $old Old db * */ protected static function renameTmpTable(self $new, $old): \Generator { if ($old instanceof SqlArray && $old->getTable()) { if ( $old->getTable() !== $new->getTable() && !\str_starts_with($new->getTable(), 'tmp') ) { yield from $new->renameTable($old->getTable(), $new->getTable()); } else { $new->setTable($old->getTable()); } } } /** * @param DbArray|array|null $old * * @throws \Throwable */ protected static function migrateDataToDb(self $new, $old): \Generator { if (!empty($old) && static::getClassName($old) !== static::getClassName($new)) { if (!$old instanceof DbArray) { $old = yield MemoryArray::getInstance('', $old, new Memory); } Logger::log('Converting '.\get_class($old).' to '.\get_class($new), Logger::ERROR); $counter = 0; $total = yield $old->count(); $iterator = $old->getIterator(); while (yield $iterator->advance()) { $counter++; if ($counter % 500 === 0 || $counter === $total) { yield $new->set(...$iterator->getCurrent()); Logger::log("Loading data to table {$new}: $counter/$total", Logger::WARNING); } else { $new->set(...$iterator->getCurrent()); } $new->clearCache(); } yield $old->clear(); Logger::log('Converting database done.', Logger::ERROR); } } public function __destruct() { $this->stopCacheCleanupLoop(); } /** * Get the value of table. * */ public function __toString(): string { return $this->table; } /** * Sleep function. * */ public function __sleep(): array { return ['table', 'dbSettings']; } public function __wakeup(): void { if (isset($this->settings) && \is_array($this->settings)) { $clazz = (new ReflectionClass($this))->getProperty('dbSettings')->getType()->getName(); /** * @var SettingsAbstract * @psalm-suppress UndefinedThisPropertyAssignment */ $this->dbSettings = new $clazz; $this->dbSettings->mergeArray($this->settings); unset($this->settings); } } final public function offsetExists($index): bool { throw new \RuntimeException('Native isset not support promises. Use isset method'); } final public function offsetSet(mixed $index, mixed $value): void { $this->set($index, $value); } final public function offsetUnset(mixed $index): void { $this->unset($index); } protected static function getClassName($instance): ?string { if ($instance === null) { return null; } elseif (\is_array($instance)) { return 'Array'; } return \str_replace('NullCache\\', '', \get_class($instance)); } } <?php /** * NothingInTheSocketException module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; class NothingInTheSocketException extends \Exception { } <?php /** * API module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Deferred; use Amp\Ipc\Sync\ChannelledSocket; use Amp\Loop; use danog\MadelineProto\Ipc\Client; use danog\MadelineProto\Ipc\Server; use danog\MadelineProto\Settings\Ipc as SettingsIpc; use danog\MadelineProto\Settings\Logger as SettingsLogger; /** * Main API wrapper for MadelineProto. */ class API extends InternalDoc { /** * Release version. * * @var string */ const RELEASE = MTProto::RELEASE; /** * We're not logged in. * * @var int */ const NOT_LOGGED_IN = MTProto::NOT_LOGGED_IN; /** * We're waiting for the login code. * * @var int */ const WAITING_CODE = MTProto::WAITING_CODE; /** * We're waiting for parameters to sign up. * * @var int */ const WAITING_SIGNUP = MTProto::WAITING_SIGNUP; /** * We're waiting for the 2FA password. * * @var int */ const WAITING_PASSWORD = MTProto::WAITING_PASSWORD; /** * We're logged in. * * @var int */ const LOGGED_IN = MTProto::LOGGED_IN; /** * Secret chat was not found. * * @var int */ const SECRET_EMPTY = MTProto::SECRET_EMPTY; /** * Secret chat was requested. * * @var int */ const SECRET_REQUESTED = MTProto::SECRET_REQUESTED; /** * Secret chat was found. * * @var int */ const SECRET_READY = MTProto::SECRET_READY; use \danog\Serializable; use \danog\MadelineProto\ApiWrappers\Start; use \danog\MadelineProto\ApiWrappers\Templates; /** * Session paths. * * @internal * @var SessionPaths */ public $session; /** * Instance of MadelineProto. * * @var null|MTProto|Client */ public $API; /** * Storage for externally set properties to be serialized. * */ protected array $storage = []; /** * Whether we're getting our API ID. * * @internal * * @var boolean */ private bool $gettingApiId = false; /** * my.telegram.org API wrapper. * * @internal * * @var null|MyTelegramOrgWrapper */ private $myTelegramOrgWrapper; /** * Whether this is an old instance. * * @var boolean */ private bool $oldInstance = false; /** * Whether we're destructing. * * @var boolean */ private bool $destructing = false; /** * API wrapper (to avoid circular references). * * @var APIWrapper */ private $wrapper; /** * Unlock callback. * * @var ?callable */ private $unlock = null; /** * Magic constructor function. * * @param string $session Session name * @param array|Settings $settings Settings * */ public function __magic_construct(string $session, $settings = []): void { Magic::start(true); $settings = Settings::parseFromLegacy($settings); $this->session = new SessionPaths($session); $this->wrapper = new APIWrapper($this, $this->exportNamespace()); $this->setInitPromise($this->internalInitAPI($settings)); foreach (\get_class_vars(APIFactory::class) as $key => $var) { if (\in_array($key, ['namespace', 'API', 'lua', 'async', 'asyncAPIPromise', 'methods'])) { continue; } if (!$this->{$key}) { $this->{$key} = $this->exportNamespace($key); } } } /** * Async constructor function. * * @param Settings|SettingsEmpty|SettingsIpc $settings Settings * */ private function internalInitAPI(SettingsAbstract $settings): \Generator { Logger::constructorFromSettings($settings instanceof Settings ? $settings->getLogger() : ($settings instanceof SettingsLogger ? $settings : new SettingsLogger)); if (yield from $this->connectToMadelineProto($settings)) { return; // OK } if (!$settings instanceof Settings) { $newSettings = new Settings; $newSettings->merge($settings); $settings = $newSettings; } $appInfo = $settings->getAppInfo(); if (!$appInfo->hasApiInfo()) { $app = yield from $this->APIStart($settings); if (!$app) { $this->forceInit(true); die(); } $appInfo->setApiId($app['api_id']); $appInfo->setApiHash($app['api_hash']); } $this->API = new MTProto($settings, $this->wrapper); yield from $this->API->initAsynchronously(); $this->APIFactory(); $this->logger->logger(Lang::$current_lang['madelineproto_ready'], Logger::NOTICE); } /** * Reconnect to full instance. * */ protected function reconnectFull(): \Generator { if (!$this->API) { yield from $this->initAsynchronously(); } if ($this->API instanceof Client) { $this->logger->logger("Restarting to full instance..."); try { if (!isset($_GET['MadelineSelfRestart']) && ((yield $this->hasEventHandler()) || !(yield $this->isIpcWorker()))) { $this->logger->logger("Restarting to full instance: the bot is already running!"); Tools::closeConnection(yield $this->getWebMessage("The bot is already running!")); return false; } $this->logger->logger("Restarting to full instance: stopping IPC server..."); yield $this->API->stopIpcServer(); $this->logger->logger("Restarting to full instance: disconnecting from IPC server..."); yield $this->API->disconnect(); } catch (SecurityException $e) { throw $e; } catch (\Throwable $e) { $this->logger->logger("Restarting to full instance: error $e"); } $this->logger->logger("Restarting to full instance: reconnecting..."); $cancel = new Deferred; $cb = function () use ($cancel, &$cb): \Generator { [$result] = yield from Serialization::tryConnect($this->session->getIpcPath(), $cancel->promise()); if ($result instanceof ChannelledSocket) { try { if (!$this->API instanceof Client) { $this->logger->logger("Restarting to full instance (again): the bot is already running!"); yield $result->disconnect(); return; } $API = new Client($result, $this->session, Logger::$default, $this->async); if ((yield from $API->hasEventHandler()) || !(yield from $API->isIpcWorker())) { $this->logger->logger("Restarting to full instance (again): the bot is already running!"); yield $API->disconnect(); $API->unreference(); return; } $this->logger->logger("Restarting to full instance: stopping another IPC server..."); yield $API->stopIpcServer(); $this->logger->logger("Restarting to full instance: disconnecting from IPC server..."); yield $API->disconnect(); $API->unreference(); } catch (SecurityException $e) { throw $e; } catch (\Throwable $e) { $this->logger->logger("Restarting to full instance: error in stop loop $e"); } Tools::callFork($cb()); } }; Tools::callFork($cb()); yield from $this->connectToMadelineProto(new SettingsEmpty, true); $cancel->resolve(new Exception('Connected!')); } return true; } /** * Connect to MadelineProto. * * @param SettingsAbstract $settings Settings * @param bool $forceFull Whether to force full initialization * */ protected function connectToMadelineProto(SettingsAbstract $settings, bool $forceFull = false, bool $tryReconnect = true): \Generator { if ($settings instanceof SettingsIpc) { $forceFull = $forceFull || $settings->getSlow(); } elseif ($settings instanceof Settings) { $forceFull = $forceFull || $settings->getIpc()->getSlow(); } $forceFull = $forceFull || isset($_GET['MadelineSelfRestart']) || Magic::$altervista; [$unserialized, $this->unlock] = yield Tools::timeoutWithDefault( Serialization::unserialize($this->session, $settings, $forceFull), 30000, [0, null] ); if ($unserialized === 0) { // Timeout Logger::log("!!! Could not connect to MadelineProto, please check and report the logs for more details. !!!", Logger::FATAL_ERROR); if (!$tryReconnect || (\defined('MADELINEPROTO_TEST') && \constant("MADELINEPROTO_TEST") === 'testing')) { throw new Exception('Could not connect to MadelineProto, please check the MadelineProto.log file to debug!'); } Logger::log("!!! Reconnecting using slower method. !!!", Logger::FATAL_ERROR); // IPC server error, try fetching full session return yield from $this->connectToMadelineProto($settings, true, false); } elseif ($unserialized instanceof \Throwable) { // IPC server error, try fetching full session return yield from $this->connectToMadelineProto($settings, true); } elseif ($unserialized instanceof ChannelledSocket) { // Success, IPC client $this->API = new Client($unserialized, $this->session, Logger::$default, $this->async); $this->APIFactory(); return true; } elseif ($unserialized) { // Success, full session if ($this->API) { $this->API->unreference(); $this->API = null; } $unserialized->storage = $unserialized->storage ?? []; $unserialized->session = $this->session; APIWrapper::link($this, $unserialized); APIWrapper::link($this->wrapper, $this); AbstractAPIFactory::link($this->wrapper->getFactory(), $this); if (isset($this->API)) { $this->storage = $this->API->storage ?? $this->storage; unset($unserialized); if ($settings instanceof SettingsIpc) { $settings = new SettingsEmpty; } $this->methods = self::getInternalMethodList($this->API, MTProto::class); yield from $this->API->wakeup($settings, $this->wrapper); $this->APIFactory(); $this->logger->logger(Lang::$current_lang['madelineproto_ready'], Logger::NOTICE); return true; } } return false; } /** * Wakeup function. * */ public function __wakeup(): void { $this->oldInstance = true; } /** * Destruct function. * * @internal */ public function __destruct() { $this->init(); if (!$this->oldInstance) { $this->logger->logger('Shutting down MadelineProto ('.static::class.')'); $this->destructing = true; if ($this->API) { if ($this->API instanceof Tools) { $this->API->destructing = true; } $this->API->unreference(); } if (isset($this->wrapper) && (!Magic::$signaled || $this->gettingApiId)) { $this->logger->logger('Prompting final serialization...'); Tools::wait($this->wrapper->serialize()); $this->logger->logger('Done final serialization!'); } if ($this->unlock) { ($this->unlock)(); } } elseif ($this->logger) { $this->logger->logger('Shutting down MadelineProto (old deserialized instance of API)'); } } /** * Init API wrapper. * */ private function APIFactory(): void { if ($this->API && $this->API->inited()) { if ($this->API instanceof MTProto) { foreach ($this->API->getMethodNamespaces() as $namespace) { if (!$this->{$namespace}) { $this->{$namespace} = $this->exportNamespace($namespace); } } } $this->methods = self::getInternalMethodList($this->API, MTProto::class); } } /** * Start MadelineProto and the event handler (enables async). * * Also initializes error reporting, catching and reporting all errors surfacing from the event loop. * * @param string $eventHandler Event handler class name * */ public function startAndLoop(string $eventHandler): void { $errors = []; $started = false; while (true) { try { Tools::wait($this->startAndLoopAsyncInternal($eventHandler, $started)); return; } catch (SecurityException $e) { throw $e; } catch (\Throwable $e) { if (\str_starts_with($e->getMessage(), 'Could not connect to DC ')) { throw $e; } $t = \time(); $errors = [$t => $errors[$t] ?? 0]; $errors[$t]++; if ($errors[$t] > 10 && (!$this->inited() || !$started)) { $this->logger->logger("More than 10 errors in a second and not inited, exiting!", Logger::FATAL_ERROR); return; } echo $e; $this->logger->logger((string) $e, Logger::FATAL_ERROR); $this->report("Surfaced: $e"); } } } /** * Start multiple instances of MadelineProto and the event handlers (enables async). * * @param API[] $instances Instances of madeline * @param string[]|string $eventHandler Event handler(s) * */ public static function startAndLoopMulti(array $instances, $eventHandler): void { if (\is_string($eventHandler)) { $eventHandler = \array_fill_keys(\array_keys($instances), $eventHandler); } $errors = []; $started = \array_fill_keys(\array_keys($instances), false); $instanceOne = \array_values($instances)[0]; while (true) { try { $promises = []; foreach ($instances as $k => $instance) { $instance->start(['async' => false]); $promises []= $instance->startAndLoopAsyncInternal($eventHandler[$k], $started[$k]); } Tools::wait(Tools::all($promises)); return; } catch (SecurityException $e) { throw $e; } catch (\Throwable $e) { $t = \time(); $errors = [$t => $errors[$t] ?? 0]; $errors[$t]++; if ($errors[$t] > 10 && \array_sum($started) !== \count($eventHandler)) { $instanceOne->logger("More than 10 errors in a second and not inited, exiting!", Logger::FATAL_ERROR); return; } echo $e; $instanceOne->logger((string) $e, Logger::FATAL_ERROR); $instanceOne->report("Surfaced: $e"); } } } /** * Start MadelineProto and the event handler (enables async). * * Also initializes error reporting, catching and reporting all errors surfacing from the event loop. * * @param string $eventHandler Event handler class name * */ public function startAndLoopAsync(string $eventHandler): \Generator { $started = false; return $this->startAndLoopAsyncInternal($eventHandler, $started); } /** * Start MadelineProto and the event handler (enables async). * * Also initializes error reporting, catching and reporting all errors surfacing from the event loop. * * @param string $eventHandler Event handler class name * */ private function startAndLoopAsyncInternal(string $eventHandler, bool &$started): \Generator { $this->async(true); yield $this->start(); if (!yield from $this->reconnectFull()) { return; } $errors = []; while (true) { try { yield $this->setEventHandler($eventHandler); $started = true; /** @var API $this->API */ return yield from $this->API->loop(); } catch (SecurityException $e) { throw $e; } catch (\Throwable $e) { $t = \time(); $errors = [$t => $errors[$t] ?? 0]; $errors[$t]++; if ($errors[$t] > 10 && (!$this->inited() || !$started)) { $this->logger->logger("More than 10 errors in a second and not inited, exiting!", Logger::FATAL_ERROR); return; } echo $e; $this->logger->logger((string) $e, Logger::FATAL_ERROR); $this->report("Surfaced: $e"); } } } /** * Get attribute. * * @param string $name Attribute nam * * @internal * */ public function &__get(string $name) { if ($name === 'logger') { if (isset($this->API)) { return $this->API->logger; } return Logger::$default; } return $this->storage[$name]; } /** * Set an attribute. * * @param string $name Name * @param mixed $value Value * * @internal * */ public function __set(string $name, $value) { return $this->storage[$name] = $value; } /** * Whether an attribute exists. * * @param string $name Attribute name * * @return boolean */ public function __isset(string $name): bool { return isset($this->storage[$name]); } /** * Unset attribute. * * @param string $name Attribute name * */ public function __unset(string $name): void { unset($this->storage[$name]); } } <?php /** * ResponseException module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; /** * Indicates an error thrown when an unexpected response is received from telegram's servers. */ class ResponseException extends \Exception { } bot_thumbnail#0 dc_id:int id:long access_hash:long volume_id:long = File; bot_profile_photo#1 dc_id:int id:long access_hash:long volume_id:long = File; bot_photo#2 dc_id:int id:long access_hash:long volume_id:long = File; bot_voice#3 dc_id:int id:long access_hash:long = File; bot_video#4 dc_id:int id:long access_hash:long = File; bot_document#5 dc_id:int id:long access_hash:long = File; bot_encrypted#6 dc_id:int id:long access_hash:long = File; bot_temp#7 dc_id:int id:long access_hash:long = File; bot_sticker#8 dc_id:int id:long access_hash:long = File; bot_audio#9 dc_id:int id:long access_hash:long = File; bot_gif#A dc_id:int id:long access_hash:long = File; bot_encrypted_thumbnail#B dc_id:int id:long access_hash:long = File; bot_wallpaper#C dc_id:int id:long access_hash:long = File; bot_video_note#D dc_id:int id:long access_hash:long = File; bot_secure_raw#F dc_id:int id:long access_hash:long = File; bot_secure#10 dc_id:int id:long access_hash:long = File; bot_background#11 dc_id:int id:long access_hash:long = File; bot_size#12 dc_id:int id:long access_hash:long = File; <?php /** * Buffer interface. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream; /** * Buffer interface. * * @author Daniil Gentili <daniil@daniil.it> */ interface BufferInterface extends ReadBufferInterface, WriteBufferInterface { } <?php namespace danog\MadelineProto\Stream\Ogg; use Amp\Emitter; use danog\MadelineProto\Exception; use danog\MadelineProto\Logger; use danog\MadelineProto\Stream\BufferedStreamInterface; use danog\MadelineProto\Stream\BufferInterface; /** * Async OGG stream reader. * * @author Charles-Édouard Coste <contact@ccoste.fr> * @author Daniil Gentili <daniil@daniil.it> */ class Ogg { private const CAPTURE_PATTERN = "\x4f\x67\x67\x53"; // ASCII encoded "OggS" string private const BOS = 2; private const EOS = 4; const STATE_READ_HEADER = 0; const STATE_READ_COMMENT = 1; const STATE_STREAMING = 3; const STATE_END = 4; /** * Required frame duration in microseconds. */ private int $frameDuration = 60000; /** * Current total frame duration in microseconds. */ private int $currentDuration = 0; /** * Current OPUS payload. */ private string $opusPayload = ''; /** * OGG Stream count. */ private int $streamCount; /** * Buffered stream interface. */ private BufferInterface $stream; /** * Pack format. */ private string $packFormat; /** * OPUS packet emitter. */ private Emitter $emitter; private function __construct() { } /** * Constructor. * * @param BufferedStreamInterface $stream The stream * @param int $frameDuration Required frame duration, microseconds * * @psalm-return \Generator<mixed, mixed, mixed, self> */ public static function init(BufferedStreamInterface $stream, int $frameDuration): \Generator { $self = new self; $self->frameDuration = $frameDuration; $self->stream = yield $stream->getReadBuffer($l); $self->emitter = new Emitter; $pack_format = [ 'stream_structure_version' => 'C', 'header_type_flag' => 'C', 'granule_position' => 'P', 'bitstream_serial_number' => 'V', 'page_sequence_number' => 'V', 'CRC_checksum' => 'V', 'number_page_segments' => 'C' ]; $self->packFormat = \implode( '/', \array_map( fn (string $v, string $k): string => $v.$k, $pack_format, \array_keys($pack_format) ) ); return $self; } /** * Read OPUS length. * * @param integer $offset * @return integer */ private function readLen(string $content, int &$offset): int { $len = \ord($content[$offset++]); if ($len > 251) { $len += \ord($content[$offset++]) << 2; } return $len; } /** * OPUS state machine. * */ private function opusStateMachine(string $content): \Generator { $curStream = 0; $offset = 0; $len = \strlen($content); while ($offset < $len) { $selfDelimited = $curStream++ < $this->streamCount - 1; $sizes = []; $preOffset = $offset; $toc = \ord($content[$offset++]); $stereo = $toc & 4; $conf = $toc >> 3; $c = $toc & 3; if ($conf < 12) { $frameDuration = $conf % 4; if ($frameDuration === 0) { $frameDuration = 10000; } else { $frameDuration *= 20000; } } elseif ($conf < 16) { $frameDuration = 2**($conf % 2) * 10000; } else { $frameDuration = 2**($conf % 4) * 2500; } $paddingLen = 0; if ($c === 0) { // Exactly 1 frame $sizes []= $selfDelimited ? $this->readLen($content, $offset) : $len - $offset; } elseif ($c === 1) { // Exactly 2 frames, equal size $size = $selfDelimited ? $this->readLen($content, $offset) : ($len - $offset)/2; $sizes []= $size; $sizes []= $size; } elseif ($c === 2) { // Exactly 2 frames, different size $size = $this->readLen($content, $offset); $sizes []= $size; $sizes []= $selfDelimited ? $this->readLen($content, $offset) : $len - ($offset + $size); } else { // Arbitrary number of frames $ch = \ord($content[$offset++]); $len--; $count = $ch & 0x3F; $vbr = $ch & 0x80; $padding = $ch & 0x40; if ($padding) { $paddingLen = $padding = \ord($content[$offset++]); while ($padding === 255) { $padding = \ord($content[$offset++]); $paddingLen += $padding - 1; } } if ($vbr) { if (!$selfDelimited) { $count -= 1; } for ($x = 0; $x < $count; $x++) { $sizes[]= $this->readLen($content, $offset); } if (!$selfDelimited) { $sizes []= ($len - ($offset + $padding)); } } else { // CBR $size = $selfDelimited ? $this->readLen($content, $offset) : ($len - ($offset + $padding)) / $count; \array_push($sizes, ...\array_fill(0, $count, $size)); } } $totalDuration = \count($sizes) * $frameDuration; if (!$selfDelimited && $totalDuration + $this->currentDuration <= $this->frameDuration) { $this->currentDuration += $totalDuration; $sum = \array_sum($sizes); $this->opusPayload .= \substr($content, $preOffset, ($offset - $preOffset) + $sum + $paddingLen); if ($this->currentDuration === $this->frameDuration) { yield $this->emitter->emit($this->opusPayload); $this->opusPayload = ''; $this->currentDuration = 0; } $offset += $sum; $offset += $paddingLen; continue; } foreach ($sizes as $size) { $this->opusPayload .= \chr($toc & ~3); $this->opusPayload .= \substr($content, $offset, $size); $offset += $size; $this->currentDuration += $frameDuration; if ($this->currentDuration >= $this->frameDuration) { if ($this->currentDuration > $this->frameDuration) { Logger::log("Emitting packet with duration {$this->currentDuration} but need {$this->frameDuration}, please reconvert the OGG file with a proper frame size.", Logger::WARNING); } yield $this->emitter->emit($this->opusPayload); $this->opusPayload = ''; $this->currentDuration = 0; } } $offset += $paddingLen; } } /** * Read frames. * */ public function read(): \Generator { $state = self::STATE_READ_HEADER; $content = ''; while (true) { $init = yield $this->stream->bufferRead(4+23); if (empty($init)) { $this->emitter->complete(); return false; // EOF } if (\substr($init, 0, 4) !== self::CAPTURE_PATTERN) { throw new Exception("Bad capture pattern"); } /*$headers = \unpack( $this->packFormat, \substr($init, 4) ); if ($headers['stream_structure_version'] != 0x00) { throw new Exception("Bad stream version"); } $granule_diff = $headers['granule_position'] - $granule; $granule = $headers['granule_position']; $continuation = (bool) ($headers['header_type_flag'] & 0x01); $firstPage = (bool) ($headers['header_type_flag'] & 0x02); $lastPage = (bool) ($headers['header_type_flag'] & 0x04); */ $segments = \unpack( 'C*', yield $this->stream->bufferRead(\ord($init[26])) ); //$serial = $headers['bitstream_serial_number']; /*if ($headers['header_type_flag'] & Ogg::BOS) { $this->emit('ogg:stream:start', [$serial]); } elseif ($headers['header_type_flag'] & Ogg::EOS) { $this->emit('ogg:stream:end', [$serial]); } else { $this->emit('ogg:stream:continue', [$serial]); }*/ $sizeAccumulated = 0; foreach ($segments as $segment_size) { $sizeAccumulated += $segment_size; if ($segment_size < 255) { $content .= yield $this->stream->bufferRead($sizeAccumulated); if ($state === self::STATE_STREAMING) { yield from $this->opusStateMachine($content); } elseif ($state === self::STATE_READ_HEADER) { if (\substr($content, 0, 8) !== 'OpusHead') { throw new \RuntimeException("This is not an OPUS stream!"); } $opus_head = \unpack('Cversion/Cchannel_count/vpre_skip/Vsample_rate/voutput_gain/Cchannel_mapping_family/', \substr($content, 8)); if ($opus_head['channel_mapping_family']) { $opus_head['channel_mapping'] = \unpack('Cstream_count/Ccoupled_count/C*channel_mapping', \substr($content, 19)); } else { $opus_head['channel_mapping'] = [ 'stream_count' => 1, 'coupled_count' => $opus_head['channel_count'] - 1, 'channel_mapping' => [0] ]; if ($opus_head['channel_count'] === 2) { $opus_head['channel_mapping']['channel_mapping'][] = 1; } } $this->streamCount = $opus_head['channel_mapping']['stream_count']; $state = self::STATE_READ_COMMENT; } elseif ($state === self::STATE_READ_COMMENT) { $vendor_string_length = \unpack('V', \substr($content, 8, 4))[1]; $result = []; $result['vendor_string'] = \substr($content, 12, $vendor_string_length); $comment_count = \unpack('V', \substr($content, 12+$vendor_string_length, 4))[1]; $offset = 16+$vendor_string_length; for ($x = 0; $x < $comment_count; $x++) { $length = \unpack('V', \substr($content, $offset, 4))[1]; $result['comments'][$x] = \substr($content, $offset += 4, $length); $offset += $length; } $state = self::STATE_STREAMING; } $content = ''; $sizeAccumulated = 0; } } } } /** * Get OPUS packet emitter. * */ public function getEmitter(): Emitter { return $this->emitter; } } <?php /** * Generic stream proxy interface. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream; /** * Stream proxy interface. * * @author Daniil Gentili <daniil@daniil.it> */ interface ProxyStreamInterface { /** * Set extra proxy data. * * @param mixed $extra Proxy data * */ public function setExtra($extra): void; } <?php /** * Buffer interface. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream; use Amp\Promise; /** * Write buffer interface. * * @author Daniil Gentili <daniil@daniil.it> */ interface WriteBufferInterface { /** * Write data asynchronously. * * @param string $data Data to write * */ public function bufferWrite(string $data): Promise; } <?php /** * Raw stream interface. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream; use Amp\ByteStream\InputStream; use Amp\ByteStream\OutputStream; /** * Raw stream interface. * * @author Daniil Gentili <daniil@daniil.it> */ interface RawStreamInterface extends InputStream, OutputStream, StreamInterface { } <?php /** * Generic stream interface. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream; use Amp\Promise; use Amp\Socket\EncryptableSocket; use Amp\Socket\Socket; /** * Generic stream interface. * * @author Daniil Gentili <daniil@daniil.it> */ interface StreamInterface { /** * Connect to a server. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator; /** * Disconnect from the server. */ public function disconnect(): Promise; /** * Get underlying AMPHP socket resource. * * @return EncryptableSocket */ public function getSocket(): Socket; } <?php /** * ADNL stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\ADNLTransport; use Amp\Socket\EncryptableSocket; use danog\MadelineProto\Stream\Async\BufferedStream; use danog\MadelineProto\Stream\BufferedStreamInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\MTProtoBufferInterface; use danog\MadelineProto\Stream\RawStreamInterface; use danog\MadelineProto\Tools; /** * ADNL stream wrapper. * * Manages ADNL envelope * * @author Daniil Gentili <daniil@daniil.it> */ class ADNLStream implements BufferedStreamInterface, MTProtoBufferInterface { use BufferedStream; private $stream; /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $this->stream = yield from $ctx->getStream($header); } /** * Async close. * */ public function disconnect(): \Amp\Promise { return $this->stream->disconnect(); } /** * Get write buffer asynchronously. * * @param int $length Length of data that is going to be written to the write buffer * */ public function getWriteBufferGenerator(int $length, string $append = ''): \Generator { $length += 64; $buffer = yield $this->stream->getWriteBuffer($length + 4, $append); yield $buffer->bufferWrite(\pack('V', $length)); $this->stream->startWriteHash(); $this->stream->checkWriteHash($length - 32); yield $buffer->bufferWrite(Tools::random(32)); return $buffer; } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBufferGenerator(&$length): \Generator { $buffer = yield $this->stream->getReadBuffer($l); $length = \unpack('V', yield $buffer->bufferRead(4))[1] - 32; $this->stream->startReadHash(); $this->stream->checkReadHash($length); yield $buffer->bufferRead(32); $length -= 32; return $buffer; } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->stream->getSocket(); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } public static function getName(): string { return __CLASS__; } } <?php /** * Raw stream helper trait. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Async; use Amp\Promise; /** * Raw stream helper trait. * * Wraps the asynchronous generator methods with asynchronous promise-based methods * * @author Daniil Gentili <daniil@daniil.it> */ trait RawStream { public function read(): Promise { return \danog\MadelineProto\Tools::call($this->readGenerator()); } public function write(string $data): Promise { return \danog\MadelineProto\Tools::call($this->writeGenerator($data)); } public function end(string $finalData = ''): Promise { if (\method_exists($this, 'endGenerator')) { return \danog\MadelineProto\Tools::call($this->endGenerator($finalData)); } $promise = $this->write($finalData); $promise->onResolve(fn () => $this->disconnect()); return $promise; } } <?php /** * Buffered stream helper trait. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Async; use Amp\Promise; /** * Buffered stream helper trait. * * Wraps the asynchronous generator methods with asynchronous promise-based methods * * @author Daniil Gentili <daniil@daniil.it> */ trait BufferedStream { /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBuffer(&$length): Promise { return \danog\MadelineProto\Tools::call($this->getReadBufferGenerator($length)); } /** * Get write buffer asynchronously. * * @param int $length Total length of data that is going to be piped in the buffer * @param string $append Data to append after entire buffer is written * */ public function getWriteBuffer(int $length, string $append = ''): Promise { return \danog\MadelineProto\Tools::call($this->getWriteBufferGenerator($length, $append)); } } <?php /** * Buffer helper trait. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Async; use Amp\Promise; /** * Buffer helper trait. * * Wraps the asynchronous generator methods with asynchronous promise-based methods * * @author Daniil Gentili <daniil@daniil.it> */ trait Buffer { public function bufferRead(int $length): Promise { return \danog\MadelineProto\Tools::call($this->bufferReadGenerator($length)); } public function bufferWrite(string $data): Promise { return \danog\MadelineProto\Tools::call($this->bufferWriteGenerator($data)); } } <?php /** * MTProto buffer interface. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream; /** * MTProto buffer interface, for reading transport MTProto header info. * * @author Daniil Gentili <daniil@daniil.it> */ interface MTProtoBufferInterface { } <?php /** * Buffered proxy stream interface. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream; /** * Buffered proxy stream interface. * * @author Daniil Gentili <daniil@daniil.it> */ interface BufferedProxyStreamInterface extends BufferedStreamInterface, ProxyStreamInterface { } <?php /** * Buffer interface. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream; use Amp\Promise; /** * Read buffer interface. * * @author Daniil Gentili <daniil@daniil.it> */ interface ReadBufferInterface { /** * Read data asynchronously. * * @param int $length How much data to read * */ public function bufferRead(int $length): Promise; } <?php /** * Abridged stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\MTProtoTransport; use Amp\Socket\EncryptableSocket; use danog\MadelineProto\Stream\Async\BufferedStream; use danog\MadelineProto\Stream\BufferedStreamInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\MTProtoBufferInterface; use danog\MadelineProto\Stream\RawStreamInterface; /** * Abridged stream wrapper. * * @author Daniil Gentili <daniil@daniil.it> */ class AbridgedStream implements BufferedStreamInterface, MTProtoBufferInterface { use BufferedStream; private $stream; /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $this->stream = (yield from $ctx->getStream(\chr(239).$header)); } /** * Async close. * */ public function disconnect(): \Amp\Promise { return $this->stream->disconnect(); } /** * Get write buffer asynchronously. * * @param int $length Length of data that is going to be written to the write buffer * */ public function getWriteBufferGenerator(int $length, string $append = ''): \Generator { $length >>= 2; if ($length < 127) { $message = \chr($length); } else { $message = \chr(127).\substr(\pack('V', $length), 0, 3); } $buffer = yield $this->stream->getWriteBuffer(\strlen($message) + $length, $append); yield $buffer->bufferWrite($message); return $buffer; } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBufferGenerator(&$length): \Generator { $buffer = yield $this->stream->getReadBuffer($l); $length = \ord(yield $buffer->bufferRead(1)); if ($length >= 127) { $length = \unpack('V', (yield $buffer->bufferRead(3))."\0")[1]; } $length <<= 2; return $buffer; } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->stream->getSocket(); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } public static function getName(): string { return __CLASS__; } } <?php /** * TCP Intermediate stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\MTProtoTransport; use Amp\Socket\EncryptableSocket; use danog\MadelineProto\Stream\Async\BufferedStream; use danog\MadelineProto\Stream\BufferedStreamInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\MTProtoBufferInterface; use danog\MadelineProto\Stream\RawStreamInterface; /** * TCP Intermediate stream wrapper. * * Manages obfuscated2 encryption/decryption * * @author Daniil Gentili <daniil@daniil.it> */ class IntermediateStream implements BufferedStreamInterface, MTProtoBufferInterface { use BufferedStream; private $stream; /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $this->stream = (yield from $ctx->getStream(\str_repeat(\chr(238), 4).$header)); } /** * Async close. * */ public function disconnect(): \Amp\Promise { return $this->stream->disconnect(); } /** * Get write buffer asynchronously. * * @param int $length Length of data that is going to be written to the write buffer * */ public function getWriteBufferGenerator(int $length, string $append = ''): \Generator { $buffer = yield $this->stream->getWriteBuffer($length + 4, $append); yield $buffer->bufferWrite(\pack('V', $length)); return $buffer; } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBufferGenerator(&$length): \Generator { $buffer = yield $this->stream->getReadBuffer($l); $length = \unpack('V', yield $buffer->bufferRead(4))[1]; return $buffer; } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->stream->getSocket(); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } public static function getName(): string { return __CLASS__; } } <?php /** * TCP full stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\MTProtoTransport; use Amp\Socket\EncryptableSocket; use danog\MadelineProto\Stream\Async\BufferedStream; use danog\MadelineProto\Stream\BufferedStreamInterface; use danog\MadelineProto\Stream\Common\HashedBufferedStream; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\MTProtoBufferInterface; use danog\MadelineProto\Stream\RawStreamInterface; /** * TCP full stream wrapper. * * Manages obfuscated2 encryption/decryption * * @author Daniil Gentili <daniil@daniil.it> */ class FullStream implements BufferedStreamInterface, MTProtoBufferInterface { use BufferedStream; private $stream; private $in_seq_no = -1; private $out_seq_no = -1; /** * Stream to use as data source. * * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $this->in_seq_no = -1; $this->out_seq_no = -1; $this->stream = new HashedBufferedStream(); $this->stream->setExtra('crc32b_rev'); return $this->stream->connect($ctx, $header); } /** * Async close. * */ public function disconnect(): \Amp\Promise { return $this->stream->disconnect(); } /** * Get write buffer asynchronously. * * @param int $length Length of data that is going to be written to the write buffer * */ public function getWriteBufferGenerator(int $length, string $append = ''): \Generator { $this->stream->startWriteHash(); $this->stream->checkWriteHash($length + 8); $buffer = yield $this->stream->getWriteBuffer($length + 12, $append); $this->out_seq_no++; $buffer->bufferWrite(\pack('VV', $length + 12, $this->out_seq_no)); return $buffer; } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBufferGenerator(&$length): \Generator { $this->stream->startReadHash(); $buffer = yield $this->stream->getReadBuffer($l); $read_length = \unpack('V', yield $buffer->bufferRead(4))[1]; $length = $read_length - 12; $this->stream->checkReadHash($read_length - 8); $this->in_seq_no++; $in_seq_no = \unpack('V', yield $buffer->bufferRead(4))[1]; if ($in_seq_no != $this->in_seq_no) { throw new \danog\MadelineProto\Exception('Incoming seq_no mismatch'); } return $buffer; } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->stream->getSocket(); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } public static function getName(): string { return __CLASS__; } } <?php /** * TCP Intermediate stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\MTProtoTransport; use Amp\Socket\EncryptableSocket; use danog\MadelineProto\Stream\Async\BufferedStream; use danog\MadelineProto\Stream\BufferedStreamInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\MTProtoBufferInterface; use danog\MadelineProto\Stream\RawStreamInterface; /** * TCP Intermediate stream wrapper. * * Manages obfuscated2 encryption/decryption * * @author Daniil Gentili <daniil@daniil.it> */ class IntermediatePaddedStream implements BufferedStreamInterface, MTProtoBufferInterface { use BufferedStream; private $stream; /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $this->stream = (yield from $ctx->getStream(\str_repeat(\chr(221), 4).$header)); } /** * Async close. * */ public function disconnect(): \Amp\Promise { return $this->stream->disconnect(); } /** * Get write buffer asynchronously. * * @param int $length Length of data that is going to be written to the write buffer * */ public function getWriteBufferGenerator(int $length, string $append = ''): \Generator { $padding_length = \danog\MadelineProto\Tools::randomInt($modulus = 16); $buffer = yield $this->stream->getWriteBuffer(4 + $length + $padding_length, $append.\danog\MadelineProto\Tools::random($padding_length)); yield $buffer->bufferWrite(\pack('V', $padding_length + $length)); return $buffer; } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBufferGenerator(&$length): \Generator { $buffer = yield $this->stream->getReadBuffer($l); $length = \unpack('V', yield $buffer->bufferRead(4))[1]; return $buffer; } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->stream->getSocket(); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } public static function getName(): string { return __CLASS__; } } <?php /** * HTTP stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\MTProtoTransport; use Amp\Promise; use Amp\Socket\EncryptableSocket; use Amp\Success; use danog\MadelineProto\Stream\Async\BufferedStream; use danog\MadelineProto\Stream\BufferedProxyStreamInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\MTProtoBufferInterface; use danog\MadelineProto\Stream\RawStreamInterface; use Psr\Http\Message\UriInterface; /** * HTTP stream wrapper. * * @author Daniil Gentili <daniil@daniil.it> */ class HttpStream implements MTProtoBufferInterface, BufferedProxyStreamInterface { use BufferedStream; /** * Stream. * * @var RawStreamInterface */ protected $stream; private $code; private $ctx; private $header = ''; /** * URI of the HTTP API. */ private UriInterface $uri; /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $this->ctx = $ctx->getCtx(); $this->stream = (yield from $ctx->getStream($header)); $this->uri = $ctx->getUri(); } /** * Set proxy data. * * @param array $extra Proxy parameters * */ public function setExtra($extra): void { if (isset($extra['user']) && isset($extra['password'])) { $this->header = \base64_encode($extra['user'].':'.$extra['password'])."\r\n"; } } /** * Async close. * */ public function disconnect(): \Amp\Promise { return $this->stream->disconnect(); } /** * Get write buffer asynchronously. * * @param int $length Length of data that is going to be written to the write buffer * */ public function getWriteBufferGenerator(int $length, string $append = ''): \Generator { $headers = 'POST '.$this->uri->getPath()." HTTP/1.1\r\nHost: ".$this->uri->getHost().':'.$this->uri->getPort()."\r\n"."Content-Type: application/x-www-form-urlencoded\r\nConnection: keep-alive\r\nKeep-Alive: timeout=100000, max=10000000\r\nContent-Length: ".$length.$this->header."\r\n\r\n"; $buffer = yield $this->stream->getWriteBuffer(\strlen($headers) + $length, $append); yield $buffer->bufferWrite($headers); return $buffer; } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBufferGenerator(&$length): \Generator { $buffer = yield $this->stream->getReadBuffer($l); $headers = ''; $was_crlf = false; while (true) { $piece = yield $buffer->bufferRead(2); $headers .= $piece; if ($piece === "\n\r") { // Assume end of headers with \r\n\r\n $headers .= yield $buffer->bufferRead(1); break; } if ($was_crlf && $piece === "\r\n") { break; } $was_crlf = $piece === "\r\n"; } $headers = \explode("\r\n", $headers); list($protocol, $code, $description) = \explode(' ', $headers[0], 3); list($protocol, $protocol_version) = \explode('/', $protocol); if ($protocol !== 'HTTP') { throw new \danog\MadelineProto\Exception('Wrong protocol'); } $code = (int) $code; unset($headers[0]); if (\array_pop($headers).\array_pop($headers) !== '') { throw new \danog\MadelineProto\Exception('Wrong last header'); } foreach ($headers as $key => $current_header) { unset($headers[$key]); $current_header = \explode(':', $current_header, 2); $headers[\strtolower($current_header[0])] = \trim($current_header[1]); } $close = $protocol === 'HTTP/1.0'; if (isset($headers['connection'])) { $close = \strtolower($headers['connection']) === 'close'; } if ($code !== 200) { $read = ''; if (isset($headers['content-length'])) { $read = yield $buffer->bufferRead((int) $headers['content-length']); } if ($close) { $this->disconnect(); yield from $this->connect($this->ctx); } \danog\MadelineProto\Logger::log($read); $this->code = \danog\MadelineProto\Tools::packSignedInt(-$code); $length = 4; return $this; } if ($close) { $this->stream->disconnect(); yield $this->stream->connect($this->ctx); } if (isset($headers['content-length'])) { $length = (int) $headers['content-length']; } return $buffer; } public function bufferRead(int $length): Promise { return new Success($this->code); } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->stream->getSocket(); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } public static function getName(): string { return __CLASS__; } } <?php /** * Obfuscated2 stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\MTProtoTransport; use danog\MadelineProto\Stream\BufferedProxyStreamInterface; use danog\MadelineProto\Stream\Common\CtrStream; use danog\MadelineProto\Stream\ConnectionContext; /** * Obfuscated2 stream wrapper. * * Manages obfuscated2 encryption/decryption * * @author Daniil Gentili <daniil@daniil.it> */ class ObfuscatedStream extends CtrStream implements BufferedProxyStreamInterface { private $stream; private $extra; /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { if (isset($this->extra['address'])) { $ctx = $ctx->getCtx(); $ctx->setUri('tcp://'.$this->extra['address'].':'.$this->extra['port']); } do { $random = \danog\MadelineProto\Tools::random(64); } while (\in_array(\substr($random, 0, 4), ['PVrG', 'GET ', 'POST', 'HEAD', \str_repeat(\chr(238), 4), \str_repeat(\chr(221), 4)]) || $random[0] === \chr(0xef) || \substr($random, 4, 4) === "\0\0\0\0"); if (\strlen($header) === 1) { $header = \str_repeat($header, 4); } $random = \substr_replace($random, $header.\substr($random, 56 + \strlen($header)), 56); $random = \substr_replace($random, \pack('s', $ctx->getIntDc()).\substr($random, 60 + 2), 60); $reversed = \strrev($random); $key = \substr($random, 8, 32); $keyRev = \substr($reversed, 8, 32); if (isset($this->extra['secret'])) { $key = \hash('sha256', $key.$this->extra['secret'], true); $keyRev = \hash('sha256', $keyRev.$this->extra['secret'], true); } $iv = \substr($random, 40, 16); $ivRev = \substr($reversed, 40, 16); parent::setExtra(['encrypt' => ['key' => $key, 'iv' => $iv], 'decrypt' => ['key' => $keyRev, 'iv' => $ivRev]]); yield from parent::connect($ctx); $random = \substr_replace($random, \substr(@$this->getEncryptor()->encrypt($random), 56, 8), 56, 8); yield $this->getStream()->write($random); } /** * Set extra. * * @param array $extra Extra * */ public function setExtra($extra): void { if (isset($extra['secret'])) { if (\strlen($extra['secret']) > 17) { $extra['secret'] = \hex2bin($extra['secret']); } if (\strlen($extra['secret']) == 17) { $extra['secret'] = \substr($extra['secret'], 1, 16); } } $this->extra = $extra; } public static function getName(): string { return __CLASS__; } } <?php /** * HTTPS stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\MTProtoTransport; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\MTProtoBufferInterface; use danog\MadelineProto\Stream\RawStreamInterface; /** * HTTPS stream wrapper. * * @author Daniil Gentili <daniil@daniil.it> */ class HttpsStream extends HttpStream implements MTProtoBufferInterface { /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { return parent::connect($ctx->getCtx()->secure(true), $header); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } public static function getName(): string { return __CLASS__; } } <?php /** * Socks5 stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Proxy; use Amp\Promise; use Amp\Socket\ClientTlsContext; use Amp\Socket\EncryptableSocket; use danog\MadelineProto\Stream\Async\RawStream; use danog\MadelineProto\Stream\BufferedProxyStreamInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\RawProxyStreamInterface; use danog\MadelineProto\Stream\RawStreamInterface; /** * Socks5 stream wrapper. * * @author Daniil Gentili <daniil@daniil.it> */ class SocksProxy implements RawProxyStreamInterface, BufferedProxyStreamInterface { private const REPS = [0 => 'succeeded', 1 => 'general SOCKS server failure', 2 => 'connection not allowed by ruleset', 3 => 'Network unreachable', 4 => 'Host unreachable', 5 => 'Connection refused', 6 => 'TTL expired', 7 => 'Command not supported', 8 => 'Address type not supported']; use RawStream; /** * Stream. * * @var RawStreamInterface */ protected $stream; private $extra; /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $ctx = $ctx->getCtx(); $uri = $ctx->getUri(); $secure = $ctx->isSecure(); if ($secure) { $ctx->setSocketContext($ctx->getSocketContext()->withTlsContext(new ClientTlsContext($uri->getHost()))); } $ctx->setUri('tcp://'.$this->extra['address'].':'.$this->extra['port'])->secure(false); $methods = \chr(0); if (isset($this->extra['username']) && isset($this->extra['password'])) { $methods .= \chr(2); } $this->stream = (yield from $ctx->getStream(\chr(5).\chr(\strlen($methods)).$methods)); $l = 2; $buffer = yield $this->stream->getReadBuffer($l); $version = \ord(yield $buffer->bufferRead(1)); $method = \ord(yield $buffer->bufferRead(1)); if ($version !== 5) { throw new \danog\MadelineProto\Exception("Wrong SOCKS5 version: {$version}"); } if ($method === 2) { $auth = \chr(1).\chr(\strlen($this->extra['username'])).$this->extra['username'].\chr(\strlen($this->extra['password'])).$this->extra['password']; yield $this->stream->write($auth); $buffer = yield $this->stream->getReadBuffer($l); $version = \ord(yield $buffer->bufferRead(1)); $result = \ord(yield $buffer->bufferRead(1)); if ($version !== 1) { throw new \danog\MadelineProto\Exception("Wrong authorized SOCKS version: {$version}"); } if ($result !== 0) { throw new \danog\MadelineProto\Exception("Wrong authorization status: {$version}"); } } elseif ($method !== 0) { throw new \danog\MadelineProto\Exception("Wrong method: {$method}"); } $payload = \pack('C3', 0x5, 0x1, 0x0); try { $ip = \inet_pton($uri->getHost()); $payload .= $ip ? \pack('C1', \strlen($ip) === 4 ? 0x1 : 0x4).$ip : \pack('C2', 0x3, \strlen($uri->getHost())).$uri->getHost(); } catch (\danog\MadelineProto\Exception $e) { $payload .= \pack('C2', 0x3, \strlen($uri->getHost())).$uri->getHost(); } $payload .= \pack('n', $uri->getPort()); yield $this->stream->write($payload); $l = 4; $buffer = yield $this->stream->getReadBuffer($l); $version = \ord(yield $buffer->bufferRead(1)); if ($version !== 5) { throw new \danog\MadelineProto\Exception("Wrong SOCKS5 version: {$version}"); } $rep = \ord(yield $buffer->bufferRead(1)); if ($rep !== 0) { $rep = self::REPS[$rep] ?? $rep; throw new \danog\MadelineProto\Exception("Wrong SOCKS5 rep: {$rep}"); } $rsv = \ord(yield $buffer->bufferRead(1)); if ($rsv !== 0) { throw new \danog\MadelineProto\Exception("Wrong socks5 final RSV: {$rsv}"); } switch (\ord(yield $buffer->bufferRead(1))) { case 1: $buffer = yield $this->stream->getReadBuffer($l); $ip = \inet_ntop(yield $buffer->bufferRead(4)); break; case 4: $l = 16; $buffer = yield $this->stream->getReadBuffer($l); $ip = \inet_ntop(yield $buffer->bufferRead(16)); break; case 3: $l = 1; $buffer = yield $this->stream->getReadBuffer($l); $length = \ord(yield $buffer->bufferRead(1)); $buffer = yield $this->stream->getReadBuffer($length); $ip = yield $buffer->bufferRead($length); break; } $l = 2; $buffer = yield $this->stream->getReadBuffer($l); $port = \unpack('n', yield $buffer->bufferRead(2))[1]; \danog\MadelineProto\Logger::log(['Connected to '.$ip.':'.$port.' via socks5']); if ($secure) { yield $this->getSocket()->setupTls(); } if (\strlen($header)) { yield (yield $this->stream->getWriteBuffer(\strlen($header)))->bufferWrite($header); } } /** * Async close. * */ public function disconnect(): \Amp\Promise { return $this->stream->disconnect(); } /** * Get write buffer asynchronously. * * @param int $length Length of data that is going to be written to the write buffer * */ public function getWriteBuffer(int $length, string $append = ''): Promise { return $this->stream->getWriteBuffer($length, $append); } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBuffer(&$length): Promise { return $this->stream->getReadBuffer($length); } public function read(): Promise { return $this->stream->read(); } public function write(string $data): Promise { return $this->stream->write($data); } /** * Sets proxy data. * * @param array $extra Proxy data * */ public function setExtra($extra): void { $this->extra = $extra; } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->stream->getSocket(); } public static function getName(): string { return __CLASS__; } } <?php /** * HTTP proxy stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Proxy; use Amp\Promise; use Amp\Socket\ClientTlsContext; use Amp\Socket\EncryptableSocket; use danog\MadelineProto\Stream\Async\RawStream; use danog\MadelineProto\Stream\BufferedProxyStreamInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\RawProxyStreamInterface; use danog\MadelineProto\Stream\RawStreamInterface; /** * HTTP proxy stream wrapper. * * @author Daniil Gentili <daniil@daniil.it> */ class HttpProxy implements RawProxyStreamInterface, BufferedProxyStreamInterface { use RawStream; /** * Stream. * * @var RawStreamInterface */ protected $stream; private $extra; /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $ctx = $ctx->getCtx(); $uri = $ctx->getUri(); $secure = $ctx->isSecure(); if ($secure) { $ctx->setSocketContext($ctx->getSocketContext()->withTlsContext(new ClientTlsContext($uri->getHost()))); } $ctx->setUri('tcp://'.$this->extra['address'].':'.$this->extra['port'])->secure(false); $this->stream = (yield from $ctx->getStream()); $address = $uri->getHost(); $port = $uri->getPort(); try { if (\strlen(\inet_pton($address) === 16)) { $address = '['.$address.']'; } } catch (\danog\MadelineProto\Exception $e) { } yield $this->stream->write("CONNECT {$address}:{$port} HTTP/1.1\r\nHost: {$address}:{$port}\r\nAccept: */*\r\n".$this->getProxyAuthHeader()."Connection: keep-Alive\r\n\r\n"); $buffer = yield $this->stream->getReadBuffer($l); $headers = ''; $was_crlf = false; while (true) { $piece = yield $buffer->bufferRead(2); $headers .= $piece; if ($piece === "\n\r") { // Assume end of headers with \r\n\r\n $headers .= yield $buffer->bufferRead(1); break; } if ($was_crlf && $piece === "\r\n") { break; } $was_crlf = $piece === "\r\n"; } $headers = \explode("\r\n", $headers); list($protocol, $code, $description) = \explode(' ', $headers[0], 3); list($protocol, $protocol_version) = \explode('/', $protocol); if ($protocol !== 'HTTP') { throw new \danog\MadelineProto\Exception('Wrong protocol'); } $code = (int) $code; unset($headers[0]); if (\array_pop($headers).\array_pop($headers) !== '') { throw new \danog\MadelineProto\Exception('Wrong last header'); } foreach ($headers as $key => $current_header) { unset($headers[$key]); $current_header = \explode(':', $current_header, 2); $headers[\strtolower($current_header[0])] = \trim($current_header[1]); } $close = $protocol === 'HTTP/1.0'; if (isset($headers['connection'])) { $close = \strtolower($headers['connection']) === 'close'; } if ($code !== 200) { $read = ''; if (isset($headers['content-length'])) { $read = yield $buffer->bufferRead((int) $headers['content-length']); } if ($close) { $this->disconnect(); yield $this->connect($ctx); } \danog\MadelineProto\Logger::log(\trim($read)); throw new \danog\MadelineProto\Exception($description, $code); } if ($close) { yield $this->stream->disconnect(); yield $this->stream->connect($ctx); } if (isset($headers['content-length'])) { $length = (int) $headers['content-length']; $read = yield $buffer->bufferRead($length); } if ($secure) { yield $this->getSocket()->setupTls(); } \danog\MadelineProto\Logger::log('Connected to '.$address.':'.$port.' via http'); if (\strlen($header)) { yield (yield $this->stream->getWriteBuffer(\strlen($header)))->bufferWrite($header); } } /** * Async close. * */ public function disconnect(): \Amp\Promise { return $this->stream->disconnect(); } /** * Get write buffer asynchronously. * * @param int $length Length of data that is going to be written to the write buffer * */ public function getWriteBuffer(int $length, string $append = ''): Promise { return $this->stream->getWriteBuffer($length, $append); } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBuffer(&$length): Promise { return $this->stream->getReadBuffer($length); } public function read(): Promise { return $this->stream->read(); } public function write(string $data): Promise { return $this->stream->write($data); } private function getProxyAuthHeader(): string { if (!isset($this->extra['username']) || !isset($this->extra['password'])) { return ''; } return 'Proxy-Authorization: Basic '.\base64_encode($this->extra['username'].':'.$this->extra['password'])."\r\n"; } /** * Sets proxy data. * * @param array $extra Proxy data * */ public function setExtra($extra): void { $this->extra = $extra; } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->stream->getSocket(); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } public static function getName(): string { return __CLASS__; } } <?php /** * Websocket TLS stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Transport; use danog\MadelineProto\Stream\ConnectionContext; /** * Websocket TLS stream wrapper. * * @author Daniil Gentili <daniil@daniil.it> */ class WssStream extends WsStream { /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { return parent::connect($ctx->getCtx()->secure(true), $header); } public static function getName(): string { return __CLASS__; } } <?php /** * Premade stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Transport; use Amp\ByteStream\ClosedException; use Amp\CancellationToken; use Amp\Promise; use Amp\Socket\Socket; use Amp\Success; use danog\MadelineProto\Stream\Async\RawStream; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\ProxyStreamInterface; use danog\MadelineProto\Stream\RawStreamInterface; /** * Premade stream wrapper. * * Manages reading data in chunks * * @author Daniil Gentili <daniil@daniil.it> */ class PremadeStream implements RawStreamInterface, ProxyStreamInterface { use RawStream; private $stream; public function __construct() { } public function setupTls(?CancellationToken $cancellationToken = null): \Amp\Promise { return $this->stream->setupTls($cancellationToken); } public function getStream() { return $this->stream; } public function connect(ConnectionContext $ctx, string $header = ''): \Generator { if ($header !== '') { yield $this->stream->write($header); } } /** * Async chunked read. * */ public function read(): Promise { return $this->stream ? $this->stream->read() : new \Amp\Success(null); } /** * Async write. * * @param string $data Data to write * */ public function write(string $data): Promise { if (!$this->stream) { throw new ClosedException("MadelineProto stream was disconnected"); } return $this->stream->write($data); } /** * Async close. */ public function disconnect(): Promise { try { if ($this->stream) { if (\method_exists($this->stream, 'close')) { $this->stream->close(); } $this->stream = null; } } catch (\Throwable $e) { \danog\MadelineProto\Logger::log('Got exception while closing stream: '.$e->getMessage()); } return new Success(); } public function close(): void { $this->disconnect(); } /** * {@inheritdoc} * */ public function getSocket(): Socket { return $this->stream; } /** * {@inheritdoc} */ public function setExtra($extra): void { $this->stream = $extra; } public static function getName(): string { return __CLASS__; } } <?php /** * Default stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Transport; use Amp\ByteStream\ClosedException; use Amp\CancellationToken; use Amp\Promise; use Amp\Socket\ClientTlsContext; use Amp\Socket\Connector; use Amp\Socket\EncryptableSocket; use Amp\Socket\Socket; use Amp\Success; use danog\MadelineProto\Stream\Async\RawStream; use danog\MadelineProto\Stream\ProxyStreamInterface; use danog\MadelineProto\Stream\RawStreamInterface; use function Amp\Socket\connector; /** * Default stream wrapper. * * Manages reading data in chunks * * @author Daniil Gentili <daniil@daniil.it> */ class DefaultStream implements RawStreamInterface, ProxyStreamInterface { use RawStream; /** * Socket. * * @var ?EncryptableSocket */ protected $stream; /** * Connector. * * @var Connector */ private $connector; public function setupTls(?CancellationToken $cancellationToken = null): \Amp\Promise { return $this->stream->setupTls($cancellationToken); } /** * @return EncryptableSocket */ public function getStream() { return $this->stream; } public function connect(\danog\MadelineProto\Stream\ConnectionContext $ctx, string $header = ''): \Generator { $ctx = $ctx->getCtx(); $uri = $ctx->getUri(); $secure = $ctx->isSecure(); if ($secure) { $ctx->setSocketContext($ctx->getSocketContext()->withTlsContext(new ClientTlsContext($uri->getHost()))); } $this->stream = (yield ($this->connector ?? connector())->connect((string) $uri, $ctx->getSocketContext(), $ctx->getCancellationToken())); if ($secure) { yield $this->stream->setupTls(); } yield $this->stream->write($header); } /** * Async chunked read. * */ public function read(): Promise { return $this->stream ? $this->stream->read() : new \Amp\Success(null); } /** * Async write. * * @param string $data Data to write * */ public function write(string $data): Promise { if (!$this->stream) { throw new ClosedException("MadelineProto stream was disconnected"); } return $this->stream->write($data); } /** * Close. */ public function disconnect(): Promise { try { if ($this->stream) { $this->stream->close(); $this->stream = null; } } catch (\Throwable $e) { \danog\MadelineProto\Logger::log('Got exception while closing stream: '.$e->getMessage()); } return new Success(); } /** * Close. * */ public function close(): void { $this->disconnect(); } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->stream; } public function setExtra($extra): void { $this->connector = $extra; } public static function getName(): string { return __CLASS__; } } <?php /** * Websocket stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Transport; use Amp\Http\Client\HttpClientBuilder; use Amp\Promise; use Amp\Socket\EncryptableSocket; use Amp\Success; use Amp\Websocket\Client\Connection; use Amp\Websocket\Client\Connector; use Amp\Websocket\Client\Handshake; use Amp\Websocket\Client\Rfc6455Connector; use Amp\Websocket\ClosedException; use Amp\Websocket\Message; use danog\MadelineProto\Stream\Async\RawStream; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\ProxyStreamInterface; use danog\MadelineProto\Stream\RawStreamInterface; use function Amp\Websocket\Client\connector; /** * Websocket stream wrapper. * * @author Daniil Gentili <daniil@daniil.it> */ class WsStream implements RawStreamInterface, ProxyStreamInterface { use RawStream; /** * Websocket stream. * * @var Connection */ private $stream; /** * Websocket message. * * @var Message */ private $message; /** * Websocket Connector. * * @var Connector */ private $connector; /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { if (!\class_exists(Handshake::class)) { throw new \danog\MadelineProto\Exception('Please install amphp/websocket-client by running "composer require amphp/websocket-client:dev-master"'); } $this->dc = $ctx->getIntDc(); $uri = $ctx->getStringUri(); $uri = \str_replace('tcp://', $ctx->isSecure() ? 'wss://' : 'ws://', $uri); $handshake = new Handshake($uri); $this->stream = yield ($this->connector ?? new Rfc6455Connector(HttpClientBuilder::buildDefault()))->connect($handshake, $ctx->getCancellationToken()); if (\strlen($header)) { yield $this->write($header); } } /** * Async close. */ public function disconnect(): Promise { try { $this->stream->close(); } catch (\Throwable $e) { } return new Success(); } public function readGenerator(): \Generator { try { if (!$this->message || ($data = yield $this->message->buffer()) === null) { $this->message = yield $this->stream->receive(); if (!$this->message) { return null; } $data = yield $this->message->buffer(); $this->message = null; } } catch (\Throwable $e) { if ($e instanceof ClosedException && $e->getReason() !== 'Client closed the underlying TCP connection') { throw $e; } return null; } return $data; } /** * Async write. * * @param string $data Data to write * */ public function write(string $data): \Amp\Promise { return $this->stream->sendBinary($data); } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->stream->getSocket(); } public function setExtra($extra): void { if ($extra instanceof Connector) { $this->connector = $extra; } } public static function getName(): string { return __CLASS__; } } <?php /** * Raw stream proxy interface. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream; /** * Raw stream proxy interface. * * @author Daniil Gentili <daniil@daniil.it> */ interface RawProxyStreamInterface extends RawStreamInterface, ProxyStreamInterface { } <?php /** * Buffered stream interface. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream; use Amp\Promise; /** * Buffered stream interface. * * @author Daniil Gentili <daniil@daniil.it> */ interface BufferedStreamInterface extends StreamInterface { /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * * @psalm-return Promise<BufferInterface> */ public function getReadBuffer(&$length): Promise; /** * Get write buffer asynchronously. * * @param int $length Total length of data that is going to be piped in the buffer * */ public function getWriteBuffer(int $length, string $append = ''): Promise; /** * Get stream name. * * Is supposed to return __CLASS__ * */ public static function getName(): string; /** * Get underlying stream resource. * */ public function getStream(): RawStreamInterface; } <?php /** * Buffered raw stream. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Common; use Amp\ByteStream\ClosedException; use Amp\File\File; use Amp\Promise; use Amp\Socket\Socket; use Amp\Success; use danog\MadelineProto\Exception; use danog\MadelineProto\Stream\BufferedStreamInterface; use danog\MadelineProto\Stream\BufferInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\ProxyStreamInterface; use danog\MadelineProto\Stream\RawStreamInterface; /** * Buffered raw stream. * * @author Daniil Gentili <daniil@daniil.it> */ class FileBufferedStream implements BufferedStreamInterface, BufferInterface, ProxyStreamInterface, RawStreamInterface { private File $stream; private int $append_after; private string $append; /** * Connect. * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { if ($header !== '') { yield $this->stream->write($header); } } /** * Async chunked read. * */ public function read(): Promise { if (!$this->stream) { throw new ClosedException("MadelineProto stream was disconnected"); } return $this->stream->read(); } /** * Async write. * * @param string $data Data to write * */ public function write(string $data): Promise { if (!$this->stream) { throw new ClosedException("MadelineProto stream was disconnected"); } return $this->stream->write($data); } /** * Async write. * * */ public function end(string $finalData = ''): Promise { if (!$this->stream) { throw new ClosedException("MadelineProto stream was disconnected"); } return $this->stream->end($finalData); } /** * Async close. */ public function disconnect(): Promise { if ($this->stream) { $this->stream = null; } return new Success(); } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBuffer(&$length): Promise { if (!$this->stream) { throw new ClosedException("MadelineProto stream was disconnected"); } return new \Amp\Success($this); } /** * Get write buffer asynchronously. * * @param int $length Total length of data that is going to be piped in the buffer * */ public function getWriteBuffer(int $length, string $append = ''): Promise { if (\strlen($append)) { $this->append = $append; $this->append_after = $length - \strlen($append); } return new \Amp\Success($this); } /** * Read data asynchronously. * * @param int $length Amount of data to read * */ public function bufferRead(int $length): Promise { return $this->stream->read($length); } /** * Async write. * * @param string $data Data to write * */ public function bufferWrite(string $data): Promise { if ($this->append_after) { $this->append_after -= \strlen($data); if ($this->append_after === 0) { $data .= $this->append; $this->append = ''; } elseif ($this->append_after < 0) { $this->append_after = 0; $this->append = ''; throw new Exception('Tried to send too much out of frame data, cannot append'); } } return $this->write($data); } /** * Set file handle. * * @param File $extra */ public function setExtra($extra): void { $this->stream = $extra; } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { throw new \RuntimeException("Can't get underlying RawStreamInterface, is a File handle!"); } /** * {@inheritDoc} */ public function getSocket(): Socket { throw new \RuntimeException("Can't get underlying socket, is a File handle!"); } /** * Get class name. * */ public static function getName(): string { return __CLASS__; } } <?php /** * AES CTR stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Common; use Amp\Promise; use Amp\Socket\EncryptableSocket; use danog\MadelineProto\Stream\Async\Buffer; use danog\MadelineProto\Stream\Async\BufferedStream; use danog\MadelineProto\Stream\BufferedProxyStreamInterface; use danog\MadelineProto\Stream\BufferInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\RawStreamInterface; use phpseclib3\Crypt\AES; /** * AES CTR stream wrapper. * * Manages AES CTR encryption/decryption * * @author Daniil Gentili <daniil@daniil.it> */ class CtrStream implements BufferedProxyStreamInterface, BufferInterface { use Buffer; use BufferedStream; private $encrypt; private $decrypt; private $stream; private $write_buffer; private $read_buffer; private $extra; private $append = ''; private $append_after = 0; /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $this->encrypt = new \phpseclib3\Crypt\AES('ctr'); $this->encrypt->enableContinuousBuffer(); $this->encrypt->setKey($this->extra['encrypt']['key']); $this->encrypt->setIV($this->extra['encrypt']['iv']); $this->decrypt = new \phpseclib3\Crypt\AES('ctr'); $this->decrypt->enableContinuousBuffer(); $this->decrypt->setKey($this->extra['decrypt']['key']); $this->decrypt->setIV($this->extra['decrypt']['iv']); $this->stream = (yield from $ctx->getStream($header)); } /** * Async close. * */ public function disconnect(): \Amp\Promise { return $this->stream->disconnect(); } /** * Get write buffer asynchronously. * * @param int $length Length of data that is going to be written to the write buffer * */ public function getWriteBufferGenerator(int $length, string $append = ''): \Generator { $this->write_buffer = yield $this->stream->getWriteBuffer($length); if (\strlen($append)) { $this->append = $append; $this->append_after = $length - \strlen($append); } return $this; } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBufferGenerator(&$length): \Generator { $this->read_buffer = yield $this->stream->getReadBuffer($length); return $this; } /** * Decrypts read data asynchronously. * * * @return \Generator That resolves with a string when the provided promise is resolved and the data is decrypted */ public function bufferReadGenerator(int $length): \Generator { return @$this->decrypt->encrypt(yield $this->read_buffer->bufferRead($length)); } /** * Writes data to the stream. * * @param string $data Bytes to write. * * @return Promise Succeeds once the data has been successfully written to the stream. */ public function bufferWrite(string $data): Promise { if ($this->append_after) { $this->append_after -= \strlen($data); if ($this->append_after === 0) { $data .= $this->append; $this->append = ''; } elseif ($this->append_after < 0) { $this->append_after = 0; $this->append = ''; throw new \danog\MadelineProto\Exception('Tried to send too much out of frame data, cannot append'); } } return $this->write_buffer->bufferWrite(@$this->encrypt->encrypt($data)); } /** * Set obfuscation keys/IVs. * * @param array $data Keys * */ public function setExtra($data): void { $this->extra = $data; } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->stream->getSocket(); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } public function getEncryptor(): AES { return $this->encrypt; } public function getDecryptor(): AES { return $this->decrypt; } public static function getName(): string { return __CLASS__; } } <?php /** * Buffered raw stream. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Common; use Amp\ByteStream\ClosedException; use Amp\Promise; use Amp\Success; use danog\MadelineProto\Exception; use danog\MadelineProto\Stream\Async\RawStream; use danog\MadelineProto\Stream\BufferedStreamInterface; use danog\MadelineProto\Stream\BufferInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\RawStreamInterface; /** * Buffered raw stream. * * @author Daniil Gentili <daniil@daniil.it> */ class BufferedRawStream implements BufferedStreamInterface, BufferInterface, RawStreamInterface { use RawStream; private const MAX_SIZE = 10 * 1024 * 1024; protected $stream; protected $memory_stream; private $append = ''; private $append_after = 0; /** * Asynchronously connect to a TCP/TLS server. * * @param ConnectionContext $ctx Connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $this->stream = yield from $ctx->getStream($header); $this->memory_stream = \fopen('php://memory', 'r+'); return true; } /** * Async chunked read. * */ public function read(): Promise { if (!$this->stream) { throw new ClosedException("MadelineProto stream was disconnected"); } return $this->stream->read(); } /** * Async write. * * @param string $data Data to write * */ public function write(string $data): Promise { if (!$this->stream) { throw new ClosedException("MadelineProto stream was disconnected"); } return $this->stream->write($data); } /** * Async close. */ public function disconnect(): Promise { if ($this->memory_stream) { \fclose($this->memory_stream); $this->memory_stream = null; } if ($this->stream) { $this->stream->disconnect(); $this->stream = null; } return new Success(); } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBuffer(&$length): Promise { if (!$this->stream) { throw new ClosedException("MadelineProto stream was disconnected"); } $size = \fstat($this->memory_stream)['size']; $offset = \ftell($this->memory_stream); $length = $size - $offset; if ($length === 0 || $size > self::MAX_SIZE) { $new_memory_stream = \fopen('php://memory', 'r+'); if ($length) { \fwrite($new_memory_stream, \fread($this->memory_stream, $length)); \fseek($new_memory_stream, 0); } \fclose($this->memory_stream); $this->memory_stream = $new_memory_stream; } return new \Amp\Success($this); } /** * Get write buffer asynchronously. * * @param int $length Total length of data that is going to be piped in the buffer * */ public function getWriteBuffer(int $length, string $append = ''): Promise { if (\strlen($append)) { $this->append = $append; $this->append_after = $length - \strlen($append); } return new \Amp\Success($this); } /** * Read data asynchronously. * * @param int $length Amount of data to read * */ public function bufferRead(int $length): Promise { if (!$this->stream) { throw new ClosedException("MadelineProto stream was disconnected"); } $size = \fstat($this->memory_stream)['size']; $offset = \ftell($this->memory_stream); $buffer_length = $size - $offset; if ($buffer_length >= $length) { return new Success(\fread($this->memory_stream, $length)); } return \danog\MadelineProto\Tools::call($this->bufferReadGenerator($length)); } /** * Read data asynchronously. * * @param int $length Amount of data to read * */ public function bufferReadGenerator(int $length): \Generator { $size = \fstat($this->memory_stream)['size']; $offset = \ftell($this->memory_stream); $buffer_length = $size - $offset; if ($buffer_length < $length && $buffer_length) { \fseek($this->memory_stream, $offset + $buffer_length); } while ($buffer_length < $length) { $chunk = yield $this->read(); if ($chunk === null) { $this->disconnect(); throw new \danog\MadelineProto\NothingInTheSocketException(); } \fwrite($this->memory_stream, $chunk); $buffer_length += \strlen($chunk); } \fseek($this->memory_stream, $offset); return \fread($this->memory_stream, $length); } /** * Async write. * * @param string $data Data to write * */ public function bufferWrite(string $data): Promise { if ($this->append_after) { $this->append_after -= \strlen($data); if ($this->append_after === 0) { $data .= $this->append; $this->append = ''; } elseif ($this->append_after < 0) { $this->append_after = 0; $this->append = ''; throw new Exception('Tried to send too much out of frame data, cannot append'); } } return $this->write($data); } /** * Get remaining data from buffer. * */ public function bufferClear(): string { $size = \fstat($this->memory_stream)['size']; $offset = \ftell($this->memory_stream); $buffer_length = $size - $offset; $data = \fread($this->memory_stream, $buffer_length); \fclose($this->memory_stream); $this->memory_stream = null; return $data; } /** * {@inheritdoc} * */ public function getSocket(): \Amp\Socket\Socket { return $this->stream->getSocket(); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } /** * Get class name. * */ public static function getName(): string { return __CLASS__; } } <?php /** * Buffered raw stream. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Common; use danog\MadelineProto\Stream\BufferedStreamInterface; use danog\MadelineProto\Stream\BufferInterface; use danog\MadelineProto\Stream\RawStreamInterface; /** * Buffered raw stream, that simply returns less data on EOF instead of throwing. * * @author Daniil Gentili <daniil@daniil.it> */ class SimpleBufferedRawStream extends BufferedRawStream implements BufferedStreamInterface, BufferInterface, RawStreamInterface { /** * Read data asynchronously. * * @param int $length Amount of data to read * */ public function bufferReadGenerator(int $length): \Generator { $size = \fstat($this->memory_stream)['size']; $offset = \ftell($this->memory_stream); $buffer_length = $size - $offset; if ($buffer_length < $length && $buffer_length) { \fseek($this->memory_stream, $offset + $buffer_length); } while ($buffer_length < $length) { $chunk = yield $this->read(); if ($chunk === null) { break; } \fwrite($this->memory_stream, $chunk); $buffer_length += \strlen($chunk); } \fseek($this->memory_stream, $offset); return \fread($this->memory_stream, $length); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } /** * Get class name. * */ public static function getName(): string { return __CLASS__; } } <?php /** * Hash stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Common; use Amp\Promise; use danog\MadelineProto\Stream\Async\BufferedStream; use danog\MadelineProto\Stream\BufferedProxyStreamInterface; use danog\MadelineProto\Stream\BufferInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\RawStreamInterface; /** * Hash stream wrapper. * * @author Daniil Gentili <daniil@daniil.it> */ class HashedBufferedStream implements BufferedProxyStreamInterface, BufferInterface { use BufferedStream; private $hash_name; private $read_hash; private $write_hash; private $write_buffer; private $write_check_after = 0; private $write_check_pos = 0; private $read_buffer; private $read_check_after = 0; private $read_check_pos = 0; private $stream; private $rev = false; /** * Enable read hashing. * */ public function startReadHash(): void { $this->read_hash = \hash_init($this->hash_name); } /** * Check the read hash after N bytes are read. * * @param int $after The number of bytes to read before checking the hash * */ public function checkReadHash(int $after): void { $this->read_check_after = $after; } /** * Stop read hashing and get final hash. * */ public function getReadHash(): string { $hash = \hash_final($this->read_hash, true); if ($this->rev) { $hash = \strrev($hash); } $this->read_hash = null; $this->read_check_after = 0; $this->read_check_pos = 0; return $hash; } /** * Check if we are read hashing. * */ public function hasReadHash(): bool { return $this->read_hash !== null; } /** * Enable write hashing. * */ public function startWriteHash(): void { $this->write_hash = \hash_init($this->hash_name); } /** * Write the write hash after N bytes are read. * * @param int $after The number of bytes to read before writing the hash * */ public function checkWriteHash(int $after): void { $this->write_check_after = $after; } /** * Stop write hashing and get final hash. * */ public function getWriteHash(): string { $hash = \hash_final($this->write_hash, true); if ($this->rev) { $hash = \strrev($hash); } $this->write_hash = null; $this->write_check_after = 0; $this->write_check_pos = 0; return $hash; } /** * Check if we are write hashing. * */ public function hasWriteHash(): bool { return $this->write_hash !== null; } /** * Hashes read data asynchronously. * * @param int $length Read and hash $length bytes * * @return \Generator That resolves with a string when the provided promise is resolved and the data is added to the hashing context */ public function bufferReadGenerator(int $length): \Generator { if ($this->read_check_after && $length + $this->read_check_pos >= $this->read_check_after) { if ($length + $this->read_check_pos > $this->read_check_after) { throw new \danog\MadelineProto\Exception('Tried to read too much out of frame data'); } $data = yield $this->read_buffer->bufferRead($length); \hash_update($this->read_hash, $data); $hash = $this->getReadHash(); if ($hash !== yield $this->read_buffer->bufferRead(\strlen($hash))) { throw new \danog\MadelineProto\Exception('Hash mismatch'); } return $data; } $data = yield $this->read_buffer->bufferRead($length); \hash_update($this->read_hash, $data); if ($this->read_check_after) { $this->read_check_pos += $length; } return $data; } /** * Set the hash algorithm. * * @param string $hash Algorithm name * */ public function setExtra($hash): void { $rev = \strpos($hash, '_rev'); $this->rev = false; if ($rev !== false) { $hash = \substr($hash, 0, $rev); $this->rev = true; } $this->hash_name = $hash; } /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $this->write_hash = null; $this->write_check_after = 0; $this->write_check_pos = 0; $this->read_hash = null; $this->read_check_after = 0; $this->read_check_pos = 0; $this->stream = (yield from $ctx->getStream($header)); } /** * Async close. * */ public function disconnect(): \Amp\Promise { return $this->stream->disconnect(); } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * */ public function getReadBufferGenerator(&$length): \Generator { //if ($this->read_hash) { $this->read_buffer = yield $this->stream->getReadBuffer($length); return $this; //} //return yield $this->stream->getReadBuffer($length); } /** * Get write buffer asynchronously. * * @param int $length Length of data that is going to be written to the write buffer * */ public function getWriteBufferGenerator(int $length, string $append = ''): \Generator { //if ($this->write_hash) { $this->write_buffer = yield $this->stream->getWriteBuffer($length, $append); return $this; //} //return yield $this->stream->getWriteBuffer($length, $append); } /** * Reads data from the stream. * * @return Promise Resolves with a string when new data is available or `null` if the stream has closed. */ public function bufferRead(int $length): Promise { if ($this->read_hash === null) { return $this->read_buffer->bufferRead($length); } return \danog\MadelineProto\Tools::call($this->bufferReadGenerator($length)); } /** * Writes data to the stream. * * @param string $data Bytes to write. * * @return Promise Succeeds once the data has been successfully written to the stream. */ public function bufferWrite(string $data): Promise { if ($this->write_hash === null) { return $this->write_buffer->bufferWrite($data); } $length = \strlen($data); if ($this->write_check_after && $length + $this->write_check_pos >= $this->write_check_after) { if ($length + $this->write_check_pos > $this->write_check_after) { throw new \danog\MadelineProto\Exception('Too much out of frame data was sent, cannot check hash'); } \hash_update($this->write_hash, $data); return $this->write_buffer->bufferWrite($data.$this->getWriteHash()); } if ($this->write_check_after) { $this->write_check_pos += $length; } if ($this->write_hash) { \hash_update($this->write_hash, $data); } return $this->write_buffer->bufferWrite($data); } /** * {@inheritdoc} * */ public function getSocket(): \Amp\Socket\Socket { return $this->stream->getSocket(); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this->stream; } public static function getName(): string { return __CLASS__; } } <?php /** * UDP stream wrapper. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream\Common; use Amp\ByteStream\ClosedException; use Amp\Failure; use Amp\Promise; use Amp\Socket\EncryptableSocket; use Amp\Success; use danog\MadelineProto\Exception; use danog\MadelineProto\Stream\Async\BufferedStream; use danog\MadelineProto\Stream\BufferedStreamInterface; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\MTProtoBufferInterface; use danog\MadelineProto\Stream\RawStreamInterface; use danog\MadelineProto\Stream\ReadBufferInterface; use danog\MadelineProto\Stream\Transport\DefaultStream; use danog\MadelineProto\Stream\WriteBufferInterface; /** * UDP stream wrapper. * * @author Daniil Gentili <daniil@daniil.it> */ class UdpBufferedStream extends DefaultStream implements BufferedStreamInterface, MTProtoBufferInterface { use BufferedStream; /** * Connect to stream. * * @param ConnectionContext $ctx The connection context * */ public function connect(ConnectionContext $ctx, string $header = ''): \Generator { $this->stream = (yield from $ctx->getStream($header)); } /** * Async close. * */ public function disconnect(): \Amp\Promise { return $this->stream->disconnect(); } /** * Get read buffer asynchronously. * * @param int $length Length of payload, as detected by this layer * * * @psalm-return \Generator<int, Promise, mixed, Failure<mixed>|Success<object>> */ public function getReadBufferGenerator(&$length): \Generator { if (!$this->stream) { return new Failure(new ClosedException("MadelineProto stream was disconnected")); } $chunk = yield $this->read(); if ($chunk === null) { $this->disconnect(); throw new \danog\MadelineProto\NothingInTheSocketException(); } $length = \strlen($chunk); return new Success(new class($chunk) implements ReadBufferInterface { /** * Buffer. * * @var resource */ private $buffer; /** * Constructor function. * * @param string $buf Buffer */ public function __construct(string $buf) { $this->buffer = \fopen('php://memory', 'r+'); \fwrite($this->buffer, $buf); \fseek($this->buffer, 0); } /** * Read data from buffer. * * @param integer $length Length * * @return Promise<string> */ public function bufferRead(int $length): Promise { return new Success(\fread($this->buffer, $length)); } /** * Destructor function. */ public function __destruct() { \fclose($this->buffer); } }); } /** * Get write buffer asynchronously. * * @param int $length Total length of data that is going to be piped in the buffer * */ public function getWriteBuffer(int $length, string $append = ''): Promise { return new Success(new class($length, $append, $this) implements WriteBufferInterface { private int $length; private string $append; private int $append_after; private RawStreamInterface $stream; private string $data = ''; /** * Constructor function. * * @param integer $length */ public function __construct(int $length, string $append, RawStreamInterface $rawStreamInterface) { $this->stream = $rawStreamInterface; $this->length = $length; if (\strlen($append)) { $this->append = $append; $this->append_after = $length - \strlen($append); } } /** * Async write. * * @param string $data Data to write * */ public function bufferWrite(string $data): Promise { $this->data .= $data; if ($this->append_after) { $this->append_after -= \strlen($data); if ($this->append_after === 0) { $this->data .= $this->append; $this->append = ''; return $this->stream->write($this->data); } elseif ($this->append_after < 0) { $this->append_after = 0; $this->append = ''; throw new Exception('Tried to send too much out of frame data, cannot append'); } } return new Success(\strlen($data)); } }); } /** * {@inheritdoc} * */ public function getSocket(): EncryptableSocket { return $this->getSocket(); } /** * {@inheritDoc} * */ public function getStream(): RawStreamInterface { return $this; } public static function getName(): string { return __CLASS__; } } <?php /** * Connection context. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Stream; use Amp\CancellationToken; use Amp\Socket\ConnectContext; use danog\MadelineProto\Exception; use danog\MadelineProto\Stream\MTProtoTransport\ObfuscatedStream; use danog\MadelineProto\Stream\Transport\DefaultStream; use League\Uri\Http; use Psr\Http\Message\UriInterface; /** * Connection context class. * * Is responsible for maintaining state about a certain connection to a DC. * That includes the Stream chain that is required to use the connection, the connection URI, and other connection-related data. * * @author Daniil Gentili <daniil@daniil.it> */ class ConnectionContext { /** * Whether to use a secure socket. * * @var bool */ private $secure = false; /** * Whether to use test servers. * * @var bool */ private $test = false; /** * Whether to use media servers. * * @var bool */ private $media = false; /** * Whether to use CDN servers. * * @var bool */ private $cdn = false; /** * The connection URI. * * @var UriInterface */ private $uri; /** * Whether this connection context will be used by the DNS client. * * @var bool */ private $isDns = false; /** * Socket context. * * @var \Amp\Socket\ConnectContext */ private $socketContext; /** * Cancellation token. * * @var \Amp\CancellationToken */ private $cancellationToken; /** * The telegram DC ID. * * @var int */ private $dc = 0; /** * Whether to use IPv6. * * @var bool */ private $ipv6 = false; /** * An array of arrays containing an array with the stream name and the extra parameter to pass to it. * * @var array<0: class-string, 1: mixed>[] */ private $nextStreams = []; /** * The current stream key. * * @var int */ private $key = 0; /** * Read callback. * * @var callable */ private $readCallback; /** * Set the socket context. * * */ public function setSocketContext(ConnectContext $socketContext): self { $this->socketContext = $socketContext; return $this; } /** * Get the socket context. * */ public function getSocketContext(): ConnectContext { return $this->socketContext; } /** * Set the connection URI. * * @param string|UriInterface $uri * */ public function setUri($uri): self { $this->uri = $uri instanceof UriInterface ? $uri : Http::createFromString($uri); return $this; } /** * Get the URI as a string. * */ public function getStringUri(): string { return (string) $this->uri; } /** * Get the URI. * */ public function getUri(): UriInterface { return $this->uri; } /** * Set the cancellation token. * * @param CancellationToken $cancellationToken * */ public function setCancellationToken($cancellationToken): self { $this->cancellationToken = $cancellationToken; return $this; } /** * Get the cancellation token. * * @return CancellationToken */ public function getCancellationToken() { return $this->cancellationToken; } /** * Return a clone of the current connection context. * */ public function getCtx(): self { return clone $this; } /** * Set the test boolean. * * */ public function setTest(bool $test): self { $this->test = $test; return $this; } /** * Whether this is a test connection. * */ public function isTest(): bool { return $this->test; } /** * Whether this is a media connection. * */ public function isMedia(): bool { return $this->media; } /** * Whether this is a CDN connection. * */ public function isCDN(): bool { return $this->cdn; } /** * Whether this connection context will only be used by the DNS client. * */ public function isDns(): bool { return $this->isDns; } /** * Whether this connection context will only be used by the DNS client. * * @param boolean $isDns */ public function setIsDns(bool $isDns): self { $this->isDns = $isDns; return $this; } /** * Set the secure boolean. * * */ public function secure(bool $secure): self { $this->secure = $secure; return $this; } /** * Whether to use TLS with socket connections. * */ public function isSecure(): bool { return $this->secure; } /** * Set the DC ID. * * @param string|int $dc * */ public function setDc($dc): self { $int = \intval($dc); if (!(1 <= $int && $int <= 1000)) { throw new Exception("Invalid DC id provided: {$dc}"); } $this->dc = $dc; $this->media = \strpos($dc, '_media') !== false; $this->cdn = \strpos($dc, '_cdn') !== false; return $this; } /** * Get the DC ID. * * @return string|int */ public function getDc() { return $this->dc; } /** * Get the int DC ID. * * @return string|int */ public function getIntDc() { $dc = \intval($this->dc); if ($this->test) { $dc += 10000; } if ($this->media) { $dc = -$dc; } return $dc; } /** * Whether to use ipv6. * * */ public function setIpv6(bool $ipv6): self { $this->ipv6 = $ipv6; return $this; } /** * Whether to use ipv6. * */ public function getIpv6(): bool { return $this->ipv6; } /** * Add a stream to the stream chain. * * * @psalm-param class-string $streamName * */ public function addStream(string $streamName, $extra = null): self { $this->nextStreams[] = [$streamName, $extra]; $this->key = \count($this->nextStreams) - 1; return $this; } /** * Set read callback, called every time the socket reads at least a byte. * * @param callable $callable Read callback * */ public function setReadCallback(callable $callable): void { $this->readCallback = $callable; } /** * Check if a read callback is present. * * @return boolean */ public function hasReadCallback(): bool { return $this->readCallback !== null; } /** * Get read callback. * */ public function getReadCallback(): callable { return $this->readCallback; } /** * Get the current stream name from the stream chain. * */ public function getStreamName(): string { return $this->nextStreams[$this->key][0]; } /** * Check if has stream within stream chain. * * @param string $stream Stream name * * @return boolean */ public function hasStreamName(string $stream): bool { foreach ($this->nextStreams as list($name)) { if ($name === $stream) { return true; } } return false; } /** * Get a stream from the stream chain. * * @return \Generator<StreamInterface> */ public function getStream(string $buffer = ''): \Generator { list($clazz, $extra) = $this->nextStreams[$this->key--]; $obj = new $clazz(); if ($obj instanceof ProxyStreamInterface) { $obj->setExtra($extra); } yield from $obj->connect($this, $buffer); return $obj; } /** * Get the inputClientProxy proxy MTProto object. * * @return array */ public function getInputClientProxy(): ?array { foreach ($this->nextStreams as $couple) { list($streamName, $extra) = $couple; if ($streamName === ObfuscatedStream::class && isset($extra['address'])) { $extra['_'] = 'inputClientProxy'; return $extra; } } return null; } /** * Get a description "name" of the context. * */ public function getName(): string { $string = $this->getStringUri(); if ($this->isSecure()) { $string .= ' (TLS)'; } $string .= $this->isTest() ? ' test' : ' main'; $string .= ' DC '; $string .= $this->getDc(); $string .= ', via '; $string .= $this->getIpv6() ? 'ipv6' : 'ipv4'; $string .= ' using '; foreach (\array_reverse($this->nextStreams) as $k => $stream) { if ($k) { $string .= ' => '; } $string .= \preg_replace('/.*\\\\/', '', $stream[0]); if ($stream[1] && $stream[0] !== DefaultStream::class) { $string .= ' ('.\json_encode($stream[1]).')'; } } return $string; } /** * Returns a representation of the context. * * @return string */ public function __toString() { return $this->getName(); } } <?php /** * Exception module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; /** * Basic exception. */ class Exception extends \Exception { use TL\PrettyException; public function __toString() { return $this->file === 'MadelineProto' ? $this->message : '\\danog\\MadelineProto\\Exception'.($this->message !== '' ? ': ' : '').$this->message.' in '.$this->file.':'.$this->line.PHP_EOL.\danog\MadelineProto\Magic::$revision.PHP_EOL.'TL Trace:'.PHP_EOL.$this->getTLTrace(); } public function __construct($message = null, $code = 0, self $previous = null, $file = null, $line = null) { $this->prettifyTL(); if ($file !== null) { $this->file = $file; } if ($line !== null) { $this->line = $line; } parent::__construct($message, $code, $previous); if (\strpos($message, 'socket_accept') === false && !\in_array(\basename($this->file), ['PKCS8.php', 'PSS.php']) ) { \danog\MadelineProto\Logger::log($message.' in '.\basename($this->file).':'.$this->line, \danog\MadelineProto\Logger::FATAL_ERROR); } } /** * Complain about missing extensions. * * @param string $extensionName Extension name * */ public static function extension(string $extensionName): self { $additional = 'Try running sudo apt-get install php'.PHP_MAJOR_VERSION.'.'.PHP_MINOR_VERSION.'-'.$extensionName.'.'; if ($extensionName === 'libtgvoip') { $additional = 'Follow the instructions @ https://voip.madelineproto.xyz to install it.'; } elseif ($extensionName === 'prime') { $additional = 'Follow the instructions @ https://prime.madelineproto.xyz to install it.'; } $message = 'MadelineProto requires the '.$extensionName.' extension to run. '.$additional; if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg') { echo $message.'<br>'; } $file = 'MadelineProto'; $line = 1; return new self($message, 0, null, $file, $line); } /** * ExceptionErrorHandler. * * Error handler * * @return false */ public static function exceptionErrorHandler($errno = 0, $errstr = null, $errfile = null, $errline = null): bool { $errfileReplaced = \preg_replace('/phabel-transpiler\d+\./', '', $errfile ?? ''); // If error is suppressed with @, don't throw an exception if (\error_reporting() === 0 || \strpos($errstr, 'headers already sent') || \strpos($errstr, 'Creation of dynamic property') !== false || $errfileReplaced && ( \strpos($errfileReplaced, DIRECTORY_SEPARATOR.'amphp'.DIRECTORY_SEPARATOR) !== false || \strpos($errfileReplaced, DIRECTORY_SEPARATOR.'league'.DIRECTORY_SEPARATOR) !== false || \strpos($errfileReplaced, DIRECTORY_SEPARATOR.'phpseclib'.DIRECTORY_SEPARATOR) !== false ) ) { return false; } throw new self($errstr, $errno, null, $errfile, $errline); } /** * ExceptionErrorHandler. * * Error handler * */ public static function exceptionHandler($exception): void { Logger::log($exception, Logger::FATAL_ERROR); Magic::shutdown(1); } } <?php /** * Bug74586Exception module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; class Bug74586Exception extends \Exception { } <?php /** * DataCenter DoH proxying AMPHP connector. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\CancellationToken; use Amp\Deferred; use Amp\Dns\Record; use Amp\Dns\TimeoutException; use Amp\Loop; use Amp\NullCancellationToken; use Amp\Promise; use Amp\Socket\ConnectContext; use Amp\Socket\ConnectException; use Amp\Socket\Connector; use Amp\Socket\ResourceSocket; use danog\MadelineProto\Stream\ConnectionContext; use function Amp\Socket\Internal\parseUri; class DoHConnector implements Connector { /** * Datacenter instance. * * @property DataCenter $dataCenter */ private $dataCenter; /** * Connection context. * * @var ConnectionContext */ private $ctx; public function __construct(DataCenter $dataCenter, ConnectionContext $ctx) { $this->dataCenter = $dataCenter; $this->ctx = $ctx; } public function connect(string $uri, ?ConnectContext $context = null, ?CancellationToken $token = null): Promise { return Tools::call((function () use ($uri, $context, $token): \Generator { $socketContext = $context ?? new ConnectContext(); $token = $token ?? new NullCancellationToken(); $attempt = 0; $uris = []; $failures = []; [$scheme, $host, $port] = parseUri($uri); if ($host[0] === '[') { $host = \substr($host, 1, -1); } if ($port === 0 || @\inet_pton($host)) { // Host is already an IP address or file path. $uris = [$uri]; } else { // Host is not an IP address, so resolve the domain name. // When we're connecting to a host, we may need to resolve the domain name, first. // The resolution is usually done using DNS over HTTPS. // // The DNS over HTTPS resolver needs to resolve the domain name of the DOH server: // this is handled internally by the DNS over HTTPS client, // by redirecting the resolution request to the plain DNS client. // // However, if the DoH connection is proxied with a proxy that has a domain name itself, // we cannot resolve it with the DoH resolver, since this will cause an infinite loop // // resolve host.com => (DoH resolver) => resolve dohserver.com => (simple resolver) => OK // // |> resolve dohserver.com => (simple resolver) => OK // resolve host.com => (DoH resolver) =| // |> resolve proxy.com => (non-proxied resolver) => OK // // // This means that we must detect if the domain name we're trying to resolve is a proxy domain name. // // Here, we simply check if the connection URI has changed since we first set it: // this would indicate that a proxy class has changed the connection URI to the proxy URI. // if ($this->ctx->isDns()) { $records = yield $this->dataCenter->getNonProxiedDNSClient()->resolve($host, $socketContext->getDnsTypeRestriction()); } else { $records = yield $this->dataCenter->getDNSClient()->resolve($host, $socketContext->getDnsTypeRestriction()); } \usort($records, function (Record $a, Record $b) { return $a->getType() - $b->getType(); }); if ($this->ctx->getIpv6()) { $records = \array_reverse($records); } foreach ($records as $record) { /** @var Record $record */ if ($record->getType() === Record::AAAA) { $uris[] = \sprintf("%s://[%s]:%d", $scheme, $record->getValue(), $port); } else { $uris[] = \sprintf("%s://%s:%d", $scheme, $record->getValue(), $port); } } } $flags = \STREAM_CLIENT_CONNECT | \STREAM_CLIENT_ASYNC_CONNECT; $timeout = $socketContext->getConnectTimeout(); $e = null; foreach ($uris as $builtUri) { try { $streamContext = \stream_context_create($socketContext->withoutTlsContext()->toStreamContextArray()); /** @psalm-suppress NullArgument */ if (!($socket = @\stream_socket_client($builtUri, $errno, $errstr, null, $flags, $streamContext))) { throw new ConnectException(\sprintf('Connection to %s failed: [Error #%d] %s%s', $uri, $errno, $errstr, $failures ? '; previous attempts: '.\implode($failures) : ''), $errno); } \stream_set_blocking($socket, false); $deferred = new Deferred(); /** @psalm-suppress InvalidArgument */ $watcher = Loop::onWritable($socket, [$deferred, 'resolve']); $id = $token->subscribe([$deferred, 'fail']); try { yield Promise\timeout($deferred->promise(), $timeout); } catch (TimeoutException $e) { throw new ConnectException(\sprintf('Connecting to %s failed: timeout exceeded (%d ms)%s', $uri, $timeout, $failures ? '; previous attempts: '.\implode($failures) : ''), 110); // See ETIMEDOUT in http://www.virtsync.com/c-error-codes-include-errno } finally { Loop::cancel($watcher); $token->unsubscribe($id); } // The following hack looks like the only way to detect connection refused errors with PHP's stream sockets. if (\stream_socket_get_name($socket, true) === false) { \fclose($socket); throw new ConnectException(\sprintf('Connection to %s refused%s', $uri, $failures ? '; previous attempts: '.\implode($failures) : ''), 111); // See ECONNREFUSED in http://www.virtsync.com/c-error-codes-include-errno } } catch (ConnectException $e) { // Includes only error codes used in this file, as error codes on other OS families might be different. // In fact, this might show a confusing error message on OS families that return 110 or 111 by itself. $knownReasons = [110 => 'connection timeout', 111 => 'connection refused']; $code = $e->getCode(); $reason = $knownReasons[$code] ?? 'Error #'.$code; if (++$attempt === $socketContext->getMaxAttempts()) { break; } $failures[] = "{$uri} ({$reason})"; continue; // Could not connect to host, try next host in the list. } return ResourceSocket::fromClientSocket($socket, $socketContext->getTlsContext()); } // This is reached if either all URIs failed or the maximum number of attempts is reached. /** @noinspection PhpUndefinedVariableInspection */ if ($e) { throw $e; } })()); } } <?php /** * Conversion module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use danog\MadelineProto\MTProtoTools\Crypt; class Conversion { /** * Prepare API instance. * * @param array<int, string> $authorization Authorization info * @param SettingsAbstract|array $settings * * @return \Generator<mixed, mixed, mixed, API> */ public static function importAuthorization(array $authorization, int $main_dc_id, string $session, $settings): \Generator { $settings = Settings::parseFromLegacyFull($settings); $settings->getIpc()->setSlow(true); $settings->getLogger()->setLevel(Logger::ULTRA_VERBOSE); $settings->getAuth()->setPfs(true); $MadelineProto = new \danog\MadelineProto\API($session, $settings); yield $MadelineProto->help->getConfig(); yield $MadelineProto->logger("About to import auth!", Logger::FATAL_ERROR); yield $MadelineProto->importAuthorization($authorization, $main_dc_id); return $MadelineProto; } public static function telethon(string $session, string $new_session, $settings = []): \Generator { if (!\extension_loaded('sqlite3')) { throw new Exception(['extension', 'sqlite3']); } if (!isset(\pathinfo($session)['extension'])) { $session .= '.session'; } $session = Tools::absolute($session); $sqlite = new \PDO("sqlite:$session"); $sqlite->setAttribute(\PDO::ATTR_ERRMODE, \PDO::ERRMODE_EXCEPTION); $sessions = $sqlite->query('SELECT * FROM sessions')->fetchAll(); $dcs = []; foreach ($sessions as $dc) { $dcs[$dc['dc_id']] = $dc['auth_key']; } return self::importAuthorization($dcs, $dc['dc_id'], $new_session, $settings); } public static function pyrogram(string $session, string $new_session, $settings = []): \Generator { \set_error_handler(['\\danog\\MadelineProto\\Exception', 'ExceptionErrorHandler']); if (!isset(\pathinfo($session)['extension'])) { $session .= '.session'; } $session = Tools::absolute($session); $session = \json_decode(\file_get_contents($session), true); $session['auth_key'] = \base64_decode(\implode('', $session['auth_key'])); $settings['connection_settings']['all']['test_mode'] = $session['test_mode']; return self::importAuthorization([$session['dc_id'] => $session['auth_key']], $session['dc_id'], $new_session, $settings); } public static function zerobias($session, $new_session, $settings = []) { \set_error_handler(['\\danog\\MadelineProto\\Exception', 'ExceptionErrorHandler']); if (\is_string($session)) { $session = \json_decode($session, true); } $dc = $session['dc']; $key = \hex2bin($session["dc$dc".'_auth_key']); return yield from self::importAuthorization([$dc => $key], $dc, $new_session, $settings); } public static function tdesktop_md5($data) { $result = ''; foreach (\str_split(\md5($data), 2) as $byte) { $result .= \strrev($byte); } return \strtoupper($result); } const FILEOPTION_SAFE = 1; const FILEOPTION_USER = 2; public static $tdesktop_base_path; public static $tdesktop_user_base_path; public static $tdesktop_key; public static function tdesktop_fopen($fileName, $options = self::FILEOPTION_SAFE|self::FILEOPTION_USER) { $name = ($options & self::FILEOPTION_USER ? self::$tdesktop_user_base_path : self::$tdesktop_base_path).$fileName; $totry = []; foreach (['0', '1', 's'] as $x) { if (\file_exists($name.$x)) { $totry[] = \fopen($name.$x, 'rb'); } } foreach ($totry as $fp) { if (\stream_get_contents($fp, 4) !== 'TDF$') { \danog\MadelineProto\Logger::log('Wrong magic', Logger::ERROR); continue; } $versionBytes = \stream_get_contents($fp, 4); $version = Tools::unpackSignedInt($versionBytes); \danog\MadelineProto\Logger::log("TDesktop version: $version"); $data = \stream_get_contents($fp); $md5 = \substr($data, -16); $data = \substr($data, 0, -16); $length = \pack('l', \strlen($data)); $length = \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev($length) : $length; if (\md5($data.$length.$versionBytes.'TDF$', true) !== $md5) { \danog\MadelineProto\Logger::log('Wrong MD5', Logger::ERROR); } $res = \fopen('php://memory', 'rw+b'); \fwrite($res, $data); \fseek($res, 0); return $res; } throw new Exception("Could not open $fileName"); } public static function tdesktop_fopen_encrypted($fileName, $options = 3) { $f = self::tdesktop_fopen($fileName, $options); $data = self::tdesktop_read_bytearray($f); $res = self::tdesktop_decrypt($data, self::$tdesktop_key); $length = \unpack('V', \stream_get_contents($res, 4))[1]; if ($length > \fstat($res)['size'] || $length < 4) { throw new \danog\MadelineProto\Exception('Wrong length'); } return $res; } public static function tdesktop_read_bytearray($fp, bool $asString = false) { $length = Tools::unpackSignedInt(\strrev(\stream_get_contents($fp, 4))); $data = $length > 0 ? \stream_get_contents($fp, $length) : ''; if ($asString) { return $data; } $res = \fopen('php://memory', 'rw+b'); \fwrite($res, $data); \fseek($res, 0); return $res; } public static function tdesktop_decrypt($data, $auth_key) { $message_key = \stream_get_contents($data, 16); $encrypted_data = \stream_get_contents($data); list($aes_key, $aes_iv) = Crypt::oldAesCalculate($message_key, $auth_key, false); $decrypted_data = Crypt::igeDecrypt($encrypted_data, $aes_key, $aes_iv); if ($message_key != \substr(\sha1($decrypted_data, true), 0, 16)) { throw new \danog\MadelineProto\SecurityException('msg_key mismatch'); } $res = \fopen('php://memory', 'rw+b'); \fwrite($res, $decrypted_data); \fseek($res, 0); return $res; } const dbiKey = 0x00; const dbiUser = 0x01; const dbiDcOptionOldOld = 0x02; const dbiChatSizeMax = 0x03; const dbiMutePeer = 0x04; const dbiSendKey = 0x05; const dbiAutoStart = 0x06; const dbiStartMinimized = 0x07; const dbiSoundNotify = 0x08; const dbiWorkMode = 0x09; const dbiSeenTrayTooltip = 0x0a; const dbiDesktopNotify = 0x0b; const dbiAutoUpdate = 0x0c; const dbiLastUpdateCheck = 0x0d; const dbiWindowPosition = 0x0e; const dbiConnectionTypeOld = 0x0f; // 0x10 reserved const dbiDefaultAttach = 0x11; const dbiCatsAndDogs = 0x12; const dbiReplaceEmojis = 0x13; const dbiAskDownloadPath = 0x14; const dbiDownloadPathOld = 0x15; const dbiScale = 0x16; const dbiEmojiTabOld = 0x17; const dbiRecentEmojiOldOld = 0x18; const dbiLoggedPhoneNumber = 0x19; const dbiMutedPeers = 0x1a; // 0x1b reserved const dbiNotifyView = 0x1c; const dbiSendToMenu = 0x1d; const dbiCompressPastedImage = 0x1e; const dbiLangOld = 0x1f; const dbiLangFileOld = 0x20; const dbiTileBackground = 0x21; const dbiAutoLock = 0x22; const dbiDialogLastPath = 0x23; const dbiRecentEmojiOld = 0x24; const dbiEmojiVariantsOld = 0x25; const dbiRecentStickers = 0x26; const dbiDcOptionOld = 0x27; const dbiTryIPv6 = 0x28; const dbiSongVolume = 0x29; const dbiWindowsNotificationsOld = 0x30; const dbiIncludeMuted = 0x31; const dbiMegagroupSizeMax = 0x32; const dbiDownloadPath = 0x33; const dbiAutoDownload = 0x34; const dbiSavedGifsLimit = 0x35; const dbiShowingSavedGifsOld = 0x36; const dbiAutoPlay = 0x37; const dbiAdaptiveForWide = 0x38; const dbiHiddenPinnedMessages = 0x39; const dbiRecentEmoji = 0x3a; const dbiEmojiVariants = 0x3b; const dbiDialogsMode = 0x40; const dbiModerateMode = 0x41; const dbiVideoVolume = 0x42; const dbiStickersRecentLimit = 0x43; const dbiNativeNotifications = 0x44; const dbiNotificationsCount = 0x45; const dbiNotificationsCorner = 0x46; const dbiThemeKey = 0x47; const dbiDialogsWidthRatioOld = 0x48; const dbiUseExternalVideoPlayer = 0x49; const dbiDcOptions = 0x4a; const dbiMtpAuthorization = 0x4b; const dbiLastSeenWarningSeenOld = 0x4c; const dbiAuthSessionSettings = 0x4d; const dbiLangPackKey = 0x4e; const dbiConnectionType = 0x4f; const dbiStickersFavedLimit = 0x50; const dbiSuggestStickersByEmoji = 0x51; const dbiEncryptedWithSalt = 333; const dbiEncrypted = 444; // 500-600 reserved const dbiVersion = 666; public static function tdesktop(string $session, string $new_session, $settings = []) { \set_error_handler(['\\danog\\MadelineProto\\Exception', 'ExceptionErrorHandler']); $settings['old_session_key'] ??= 'data'; $settings['old_session_passcode'] ??= ''; if (\basename($session) !== 'tdata') { $session .= DIRECTORY_SEPARATOR.'tdata'; } list($part_one_md5, $part_two_md5) = \str_split(self::tdesktop_md5($settings['old_session_key']), 16); self::$tdesktop_base_path = $session.DIRECTORY_SEPARATOR; self::$tdesktop_user_base_path = self::$tdesktop_base_path.$part_one_md5.DIRECTORY_SEPARATOR; $data = self::tdesktop_fopen('map'); $salt = self::tdesktop_read_bytearray($data, true); $encryptedKey = self::tdesktop_read_bytearray($data); if (\strlen($salt)) { $keyIterCount = \strlen($settings['old_session_passcode']) ? 4000 : 4; $passKey = \openssl_pbkdf2($settings['old_session_passcode'], $salt, 256, $keyIterCount); self::$tdesktop_key = \stream_get_contents( self::tdesktop_read_bytearray( self::tdesktop_decrypt($encryptedKey, $passKey) ) ); } else { $key = 'key_'.$settings['old_session_key']; $data = self::tdesktop_fopen($key, self::FILEOPTION_SAFE); $salt = self::tdesktop_read_bytearray($data, true); if (\strlen($salt) !== 32) { throw new Exception("Length of salt is wrong!"); } $encryptedKey = self::tdesktop_read_bytearray($data); $encryptedInfo = self::tdesktop_read_bytearray($data); $hash = \hash('sha512', $salt.$settings['old_session_passcode'].$salt, true); $iterCount = \strlen($settings['old_session_passcode']) ? 100000 : 1; $passKey = \openssl_pbkdf2($hash, $salt, 256, $iterCount, 'sha512'); $key = self::tdesktop_read_bytearray(self::tdesktop_decrypt($encryptedKey, $passKey), true); $info = self::tdesktop_read_bytearray(self::tdesktop_decrypt($encryptedInfo, $key)); self::$tdesktop_key = $key; $count = Tools::unpackSignedInt(\strrev(\stream_get_contents($info, 4))); Logger::log("Number of accounts: $count"); for ($i = 0; $i != $count; $i++) { $idx = Tools::unpackSignedInt(\strrev(\stream_get_contents($info, 4))); if ($idx >= 0) { $dataName = $settings['old_session_key']; if ($idx > 0) { $dataName = $settings['old_session_key'].'#'.($idx+1); } [$part_one_md5] = \str_split(self::tdesktop_md5($dataName), 16); } } } $main = self::tdesktop_fopen_encrypted($part_one_md5, self::FILEOPTION_SAFE); $auth_keys = []; while (!\feof($main)) { $magic = Tools::unpackSignedInt(\strrev(\stream_get_contents($main, 4))); switch ($magic) { case self::dbiDcOptionOldOld: \stream_get_contents($main, 4); self::tdesktop_read_bytearray($main); self::tdesktop_read_bytearray($main); \stream_get_contents($main, 4); break; case self::dbiDcOptionOld: \stream_get_contents($main, 8); self::tdesktop_read_bytearray($main); \stream_get_contents($main, 4); break; case self::dbiDcOptions: self::tdesktop_read_bytearray($main); break; case self::dbiUser: \stream_get_contents($main, 4); $main_dc_id = Tools::unpackSignedInt(\strrev(\stream_get_contents($main, 4))); break; case self::dbiKey: $auth_keys[Tools::unpackSignedInt(\strrev(\stream_get_contents($main, 4)))] = \stream_get_contents($main, 256); break; case self::dbiMtpAuthorization: $main = self::tdesktop_read_bytearray($main); //stream_get_contents($main, 4); $user_id = Tools::unpackSignedInt(\strrev(\stream_get_contents($main, 4))); $main_dc_id = Tools::unpackSignedInt(\strrev(\stream_get_contents($main, 4))); $length = Tools::unpackSignedInt(\strrev(\stream_get_contents($main, 4))); for ($x = 0; $x < $length; $x++) { $dc = Tools::unpackSignedInt(\strrev(\stream_get_contents($main, 4))); $auth_key = \stream_get_contents($main, 256); if ($dc <= 5) { $auth_keys[$dc] = $auth_key; } } break 2; case self::dbiAutoDownload: \stream_get_contents($main, 12); break; case self::dbiDialogsMode: \stream_get_contents($main, 8); break; case self::dbiAuthSessionSettings: self::tdesktop_read_bytearray($main); break; case self::dbiConnectionTypeOld: switch (Tools::unpackSignedInt(\strrev(\stream_get_contents($main, 4)))) { case 2: case 3: self::tdesktop_read_bytearray($main); \stream_get_contents($main, 4); self::tdesktop_read_bytearray($main); self::tdesktop_read_bytearray($main); break; } break; case self::dbiConnectionType: \stream_get_contents($main, 8); self::tdesktop_read_bytearray($main); \stream_get_contents($main, 4); self::tdesktop_read_bytearray($main); self::tdesktop_read_bytearray($main); break; case self::dbiThemeKey: case self::dbiLangPackKey: case self::dbiMutePeer: \stream_get_contents($main, 8); break; case self::dbiWindowPosition: \stream_get_contents($main, 24); break; case self::dbiLoggedPhoneNumber: self::tdesktop_read_bytearray($main); break; case self::dbiMutedPeers: $length = Tools::unpackSignedInt(\strrev(\stream_get_contents($main, 4))); for ($x = 0; $x < $length; $x++) { \stream_get_contents($main, 8); } // no break case self::dbiDownloadPathOld: self::tdesktop_read_bytearray($main); break; case self::dbiDialogLastPath: self::tdesktop_read_bytearray($main); break; case self::dbiDownloadPath: self::tdesktop_read_bytearray($main); self::tdesktop_read_bytearray($main); break; default: throw new \Exception("Unknown type $magic"); break; } } return yield from self::importAuthorization($auth_keys, $main_dc_id, $new_session, $settings); } } <?php /** * FileCallbackInterface module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; /** * File callback interface. */ interface FileCallbackInterface { /** * Get file. * */ public function getFile(); /** * Invoke callback. * * @param float $percent Percent * @param float $speed Speed in mbps * @param float $time Time * */ public function __invoke($percent, $speed, $time); } /////////////////////////////// /////////////////// Layer cons /////////////////////////////// //invokeAfterMsg#cb9f372d msg_id:long query:!X = X; //invokeAfterMsgs#3dc4b4f0 msg_ids:Vector<long> query:!X = X; //invokeWithLayer1#53835315 query:!X = X; //invokeWithLayer2#289dd1f6 query:!X = X; //invokeWithLayer3#b7475268 query:!X = X; //invokeWithLayer4#dea0d430 query:!X = X; //invokeWithLayer5#417a57ae query:!X = X; //invokeWithLayer6#3a64d54d query:!X = X; //invokeWithLayer7#a5be56d3 query:!X = X; //invokeWithLayer8#e9abd9fd query:!X = X; //invokeWithLayer9#76715a63 query:!X = X; //invokeWithLayer10#39620c41 query:!X = X; //invokeWithLayer11#a6b88fdf query:!X = X; //invokeWithLayer12#dda60d3c query:!X = X; //invokeWithLayer13#427c8ea2 query:!X = X; //invokeWithLayer14#2b9b08fa query:!X = X; //invokeWithLayer15#b4418b64 query:!X = X; //invokeWithLayer16#cf5f0987 query:!X = X; //invokeWithLayer17#50858a19 query:!X = X; //invokeWithLayer18#1c900537 query:!X = X; //invokeWithLayer#da9b0d0d layer:int query:!X = X; // after 18 layer /////////////////////////////// ///////// Main application API /////////////////////////////// boolFalse#bc799737 = Bool; boolTrue#997275b5 = Bool; true#3fedd339 = True; vector#1cb5c415 {t:Type} # [ t ] = Vector t; error#c4b9f9bb code:int text:string = Error; null#56730bcc = Null; inputPeerEmpty#7f3b18ea = InputPeer; inputPeerSelf#7da07ec9 = InputPeer; inputPeerChat#35a95cb9 chat_id:long = InputPeer; inputPeerUser#dde8a54c user_id:long access_hash:long = InputPeer; inputPeerChannel#27bcbbfc channel_id:long access_hash:long = InputPeer; inputPeerUserFromMessage#a87b0a1c peer:InputPeer msg_id:int user_id:long = InputPeer; inputPeerChannelFromMessage#bd2a0840 peer:InputPeer msg_id:int channel_id:long = InputPeer; inputUserEmpty#b98886cf = InputUser; inputUserSelf#f7c1b13f = InputUser; inputUser#f21158c6 user_id:long access_hash:long = InputUser; inputUserFromMessage#1da448e2 peer:InputPeer msg_id:int user_id:long = InputUser; inputPhoneContact#f392b7f4 client_id:long phone:string first_name:string last_name:string = InputContact; inputFile#f52ff27f id:long parts:int name:string md5_checksum:string = InputFile; inputFileBig#fa4f0bb5 id:long parts:int name:string = InputFile; inputMediaEmpty#9664f57f = InputMedia; inputMediaUploadedPhoto#1e287d04 flags:# spoiler:flags.2?true file:InputFile stickers:flags.0?Vector<InputDocument> ttl_seconds:flags.1?int = InputMedia; inputMediaPhoto#b3ba0635 flags:# spoiler:flags.1?true id:InputPhoto ttl_seconds:flags.0?int = InputMedia; inputMediaGeoPoint#f9c44144 geo_point:InputGeoPoint = InputMedia; inputMediaContact#f8ab7dfb phone_number:string first_name:string last_name:string vcard:string = InputMedia; inputMediaUploadedDocument#5b38c6c1 flags:# nosound_video:flags.3?true force_file:flags.4?true spoiler:flags.5?true file:InputFile thumb:flags.2?InputFile mime_type:string attributes:Vector<DocumentAttribute> stickers:flags.0?Vector<InputDocument> ttl_seconds:flags.1?int = InputMedia; inputMediaDocument#33473058 flags:# spoiler:flags.2?true id:InputDocument ttl_seconds:flags.0?int query:flags.1?string = InputMedia; inputMediaVenue#c13d1c11 geo_point:InputGeoPoint title:string address:string provider:string venue_id:string venue_type:string = InputMedia; inputMediaPhotoExternal#e5bbfe1a flags:# spoiler:flags.1?true url:string ttl_seconds:flags.0?int = InputMedia; inputMediaDocumentExternal#fb52dc99 flags:# spoiler:flags.1?true url:string ttl_seconds:flags.0?int = InputMedia; inputMediaGame#d33f43f3 id:InputGame = InputMedia; inputMediaInvoice#8eb5a6d5 flags:# title:string description:string photo:flags.0?InputWebDocument invoice:Invoice payload:bytes provider:string provider_data:DataJSON start_param:flags.1?string extended_media:flags.2?InputMedia = InputMedia; inputMediaGeoLive#971fa843 flags:# stopped:flags.0?true geo_point:InputGeoPoint heading:flags.2?int period:flags.1?int proximity_notification_radius:flags.3?int = InputMedia; inputMediaPoll#f94e5f1 flags:# poll:Poll correct_answers:flags.0?Vector<bytes> solution:flags.1?string solution_entities:flags.1?Vector<MessageEntity> = InputMedia; inputMediaDice#e66fbf7b emoticon:string = InputMedia; inputChatPhotoEmpty#1ca48f57 = InputChatPhoto; inputChatUploadedPhoto#c642724e flags:# file:flags.0?InputFile video:flags.1?InputFile video_start_ts:flags.2?double = InputChatPhoto; inputChatPhoto#8953ad37 id:InputPhoto = InputChatPhoto; inputGeoPointEmpty#e4c123d6 = InputGeoPoint; inputGeoPoint#48222faf flags:# lat:double long:double accuracy_radius:flags.0?int = InputGeoPoint; inputPhotoEmpty#1cd7bf0d = InputPhoto; inputPhoto#3bb3b94a id:long access_hash:long file_reference:bytes = InputPhoto; inputFileLocation#dfdaabe1 volume_id:long local_id:int secret:long file_reference:bytes = InputFileLocation; inputEncryptedFileLocation#f5235d55 id:long access_hash:long = InputFileLocation; inputDocumentFileLocation#bad07584 id:long access_hash:long file_reference:bytes thumb_size:string = InputFileLocation; inputSecureFileLocation#cbc7ee28 id:long access_hash:long = InputFileLocation; inputTakeoutFileLocation#29be5899 = InputFileLocation; inputPhotoFileLocation#40181ffe id:long access_hash:long file_reference:bytes thumb_size:string = InputFileLocation; inputPhotoLegacyFileLocation#d83466f3 id:long access_hash:long file_reference:bytes volume_id:long local_id:int secret:long = InputFileLocation; inputPeerPhotoFileLocation#37257e99 flags:# big:flags.0?true peer:InputPeer photo_id:long = InputFileLocation; inputStickerSetThumb#9d84f3db stickerset:InputStickerSet thumb_version:int = InputFileLocation; inputGroupCallStream#598a92a flags:# call:InputGroupCall time_ms:long scale:int video_channel:flags.0?int video_quality:flags.0?int = InputFileLocation; peerUser#59511722 user_id:long = Peer; peerChat#36c6019a chat_id:long = Peer; peerChannel#a2a5371e channel_id:long = Peer; storage.fileUnknown#aa963b05 = storage.FileType; storage.filePartial#40bc6f52 = storage.FileType; storage.fileJpeg#7efe0e = storage.FileType; storage.fileGif#cae1aadf = storage.FileType; storage.filePng#a4f63c0 = storage.FileType; storage.filePdf#ae1e508d = storage.FileType; storage.fileMp3#528a0677 = storage.FileType; storage.fileMov#4b09ebbc = storage.FileType; storage.fileMp4#b3cea0e4 = storage.FileType; storage.fileWebp#1081464c = storage.FileType; userEmpty#d3bc4b7a id:long = User; user#8f97c628 flags:# self:flags.10?true contact:flags.11?true mutual_contact:flags.12?true deleted:flags.13?true bot:flags.14?true bot_chat_history:flags.15?true bot_nochats:flags.16?true verified:flags.17?true restricted:flags.18?true min:flags.20?true bot_inline_geo:flags.21?true support:flags.23?true scam:flags.24?true apply_min_photo:flags.25?true fake:flags.26?true bot_attach_menu:flags.27?true premium:flags.28?true attach_menu_enabled:flags.29?true flags2:# id:long access_hash:flags.0?long first_name:flags.1?string last_name:flags.2?string username:flags.3?string phone:flags.4?string photo:flags.5?UserProfilePhoto status:flags.6?UserStatus bot_info_version:flags.14?int restriction_reason:flags.18?Vector<RestrictionReason> bot_inline_placeholder:flags.19?string lang_code:flags.22?string emoji_status:flags.30?EmojiStatus usernames:flags2.0?Vector<Username> = User; userProfilePhotoEmpty#4f11bae1 = UserProfilePhoto; userProfilePhoto#82d1f706 flags:# has_video:flags.0?true personal:flags.2?true photo_id:long stripped_thumb:flags.1?bytes dc_id:int = UserProfilePhoto; userStatusEmpty#9d05049 = UserStatus; userStatusOnline#edb93949 expires:int = UserStatus; userStatusOffline#8c703f was_online:int = UserStatus; userStatusRecently#e26f42f1 = UserStatus; userStatusLastWeek#7bf09fc = UserStatus; userStatusLastMonth#77ebc742 = UserStatus; chatEmpty#29562865 id:long = Chat; chat#41cbf256 flags:# creator:flags.0?true left:flags.2?true deactivated:flags.5?true call_active:flags.23?true call_not_empty:flags.24?true noforwards:flags.25?true id:long title:string photo:ChatPhoto participants_count:int date:int version:int migrated_to:flags.6?InputChannel admin_rights:flags.14?ChatAdminRights default_banned_rights:flags.18?ChatBannedRights = Chat; chatForbidden#6592a1a7 id:long title:string = Chat; channel#83259464 flags:# creator:flags.0?true left:flags.2?true broadcast:flags.5?true verified:flags.7?true megagroup:flags.8?true restricted:flags.9?true signatures:flags.11?true min:flags.12?true scam:flags.19?true has_link:flags.20?true has_geo:flags.21?true slowmode_enabled:flags.22?true call_active:flags.23?true call_not_empty:flags.24?true fake:flags.25?true gigagroup:flags.26?true noforwards:flags.27?true join_to_send:flags.28?true join_request:flags.29?true forum:flags.30?true flags2:# id:long access_hash:flags.13?long title:string username:flags.6?string photo:ChatPhoto date:int restriction_reason:flags.9?Vector<RestrictionReason> admin_rights:flags.14?ChatAdminRights banned_rights:flags.15?ChatBannedRights default_banned_rights:flags.18?ChatBannedRights participants_count:flags.17?int usernames:flags2.0?Vector<Username> = Chat; channelForbidden#17d493d5 flags:# broadcast:flags.5?true megagroup:flags.8?true id:long access_hash:long title:string until_date:flags.16?int = Chat; chatFull#c9d31138 flags:# can_set_username:flags.7?true has_scheduled:flags.8?true id:long about:string participants:ChatParticipants chat_photo:flags.2?Photo notify_settings:PeerNotifySettings exported_invite:flags.13?ExportedChatInvite bot_info:flags.3?Vector<BotInfo> pinned_msg_id:flags.6?int folder_id:flags.11?int call:flags.12?InputGroupCall ttl_period:flags.14?int groupcall_default_join_as:flags.15?Peer theme_emoticon:flags.16?string requests_pending:flags.17?int recent_requesters:flags.17?Vector<long> available_reactions:flags.18?ChatReactions = ChatFull; channelFull#f2355507 flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true flags2:# can_delete_channel:flags2.0?true antispam:flags2.1?true participants_hidden:flags2.2?true id:long about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?long migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?long location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall ttl_period:flags.24?int pending_suggestions:flags.25?Vector<string> groupcall_default_join_as:flags.26?Peer theme_emoticon:flags.27?string requests_pending:flags.28?int recent_requesters:flags.28?Vector<long> default_send_as:flags.29?Peer available_reactions:flags.30?ChatReactions = ChatFull; chatParticipant#c02d4007 user_id:long inviter_id:long date:int = ChatParticipant; chatParticipantCreator#e46bcee4 user_id:long = ChatParticipant; chatParticipantAdmin#a0933f5b user_id:long inviter_id:long date:int = ChatParticipant; chatParticipantsForbidden#8763d3e1 flags:# chat_id:long self_participant:flags.0?ChatParticipant = ChatParticipants; chatParticipants#3cbc93f8 chat_id:long participants:Vector<ChatParticipant> version:int = ChatParticipants; chatPhotoEmpty#37c1011c = ChatPhoto; chatPhoto#1c6e1c11 flags:# has_video:flags.0?true photo_id:long stripped_thumb:flags.1?bytes dc_id:int = ChatPhoto; messageEmpty#90a6ca84 flags:# id:int peer_id:flags.0?Peer = Message; message#38116ee0 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true from_scheduled:flags.18?true legacy:flags.19?true edit_hide:flags.21?true pinned:flags.24?true noforwards:flags.26?true id:int from_id:flags.8?Peer peer_id:Peer fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader date:int message:string media:flags.9?MessageMedia reply_markup:flags.6?ReplyMarkup entities:flags.7?Vector<MessageEntity> views:flags.10?int forwards:flags.10?int replies:flags.23?MessageReplies edit_date:flags.15?int post_author:flags.16?string grouped_id:flags.17?long reactions:flags.20?MessageReactions restriction_reason:flags.22?Vector<RestrictionReason> ttl_period:flags.25?int = Message; messageService#2b085862 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true legacy:flags.19?true id:int from_id:flags.8?Peer peer_id:Peer reply_to:flags.3?MessageReplyHeader date:int action:MessageAction ttl_period:flags.25?int = Message; messageMediaEmpty#3ded6320 = MessageMedia; messageMediaPhoto#695150d7 flags:# spoiler:flags.3?true photo:flags.0?Photo ttl_seconds:flags.2?int = MessageMedia; messageMediaGeo#56e0d474 geo:GeoPoint = MessageMedia; messageMediaContact#70322949 phone_number:string first_name:string last_name:string vcard:string user_id:long = MessageMedia; messageMediaUnsupported#9f84f49e = MessageMedia; messageMediaDocument#9cb070d7 flags:# nopremium:flags.3?true spoiler:flags.4?true document:flags.0?Document ttl_seconds:flags.2?int = MessageMedia; messageMediaWebPage#a32dd600 webpage:WebPage = MessageMedia; messageMediaVenue#2ec0533f geo:GeoPoint title:string address:string provider:string venue_id:string venue_type:string = MessageMedia; messageMediaGame#fdb19008 game:Game = MessageMedia; messageMediaInvoice#f6a548d3 flags:# shipping_address_requested:flags.1?true test:flags.3?true title:string description:string photo:flags.0?WebDocument receipt_msg_id:flags.2?int currency:string total_amount:long start_param:string extended_media:flags.4?MessageExtendedMedia = MessageMedia; messageMediaGeoLive#b940c666 flags:# geo:GeoPoint heading:flags.0?int period:int proximity_notification_radius:flags.1?int = MessageMedia; messageMediaPoll#4bd6e798 poll:Poll results:PollResults = MessageMedia; messageMediaDice#3f7ee58b value:int emoticon:string = MessageMedia; messageActionEmpty#b6aef7b0 = MessageAction; messageActionChatCreate#bd47cbad title:string users:Vector<long> = MessageAction; messageActionChatEditTitle#b5a1ce5a title:string = MessageAction; messageActionChatEditPhoto#7fcb13a8 photo:Photo = MessageAction; messageActionChatDeletePhoto#95e3fbef = MessageAction; messageActionChatAddUser#15cefd00 users:Vector<long> = MessageAction; messageActionChatDeleteUser#a43f30cc user_id:long = MessageAction; messageActionChatJoinedByLink#31224c3 inviter_id:long = MessageAction; messageActionChannelCreate#95d2ac92 title:string = MessageAction; messageActionChatMigrateTo#e1037f92 channel_id:long = MessageAction; messageActionChannelMigrateFrom#ea3948e9 title:string chat_id:long = MessageAction; messageActionPinMessage#94bd38ed = MessageAction; messageActionHistoryClear#9fbab604 = MessageAction; messageActionGameScore#92a72876 game_id:long score:int = MessageAction; messageActionPaymentSentMe#8f31b327 flags:# recurring_init:flags.2?true recurring_used:flags.3?true currency:string total_amount:long payload:bytes info:flags.0?PaymentRequestedInfo shipping_option_id:flags.1?string charge:PaymentCharge = MessageAction; messageActionPaymentSent#96163f56 flags:# recurring_init:flags.2?true recurring_used:flags.3?true currency:string total_amount:long invoice_slug:flags.0?string = MessageAction; messageActionPhoneCall#80e11a7f flags:# video:flags.2?true call_id:long reason:flags.0?PhoneCallDiscardReason duration:flags.1?int = MessageAction; messageActionScreenshotTaken#4792929b = MessageAction; messageActionCustomAction#fae69f56 message:string = MessageAction; messageActionBotAllowed#abe9affe domain:string = MessageAction; messageActionSecureValuesSentMe#1b287353 values:Vector<SecureValue> credentials:SecureCredentialsEncrypted = MessageAction; messageActionSecureValuesSent#d95c6154 types:Vector<SecureValueType> = MessageAction; messageActionContactSignUp#f3f25f76 = MessageAction; messageActionGeoProximityReached#98e0d697 from_id:Peer to_id:Peer distance:int = MessageAction; messageActionGroupCall#7a0d7f42 flags:# call:InputGroupCall duration:flags.0?int = MessageAction; messageActionInviteToGroupCall#502f92f7 call:InputGroupCall users:Vector<long> = MessageAction; messageActionSetMessagesTTL#3c134d7b flags:# period:int auto_setting_from:flags.0?long = MessageAction; messageActionGroupCallScheduled#b3a07661 call:InputGroupCall schedule_date:int = MessageAction; messageActionSetChatTheme#aa786345 emoticon:string = MessageAction; messageActionChatJoinedByRequest#ebbca3cb = MessageAction; messageActionWebViewDataSentMe#47dd8079 text:string data:string = MessageAction; messageActionWebViewDataSent#b4c38cb5 text:string = MessageAction; messageActionGiftPremium#aba0f5c6 currency:string amount:long months:int = MessageAction; messageActionTopicCreate#d999256 flags:# title:string icon_color:int icon_emoji_id:flags.0?long = MessageAction; messageActionTopicEdit#c0944820 flags:# title:flags.0?string icon_emoji_id:flags.1?long closed:flags.2?Bool hidden:flags.3?Bool = MessageAction; messageActionSuggestProfilePhoto#57de635e photo:Photo = MessageAction; messageActionAttachMenuBotAllowed#e7e75f97 = MessageAction; dialog#d58a08c6 flags:# pinned:flags.2?true unread_mark:flags.3?true peer:Peer top_message:int read_inbox_max_id:int read_outbox_max_id:int unread_count:int unread_mentions_count:int unread_reactions_count:int notify_settings:PeerNotifySettings pts:flags.0?int draft:flags.1?DraftMessage folder_id:flags.4?int ttl_period:flags.5?int = Dialog; dialogFolder#71bd134c flags:# pinned:flags.2?true folder:Folder peer:Peer top_message:int unread_muted_peers_count:int unread_unmuted_peers_count:int unread_muted_messages_count:int unread_unmuted_messages_count:int = Dialog; photoEmpty#2331b22d id:long = Photo; photo#fb197a65 flags:# has_stickers:flags.0?true id:long access_hash:long file_reference:bytes date:int sizes:Vector<PhotoSize> video_sizes:flags.1?Vector<VideoSize> dc_id:int = Photo; photoSizeEmpty#e17e23c type:string = PhotoSize; photoSize#75c78e60 type:string w:int h:int size:int = PhotoSize; photoCachedSize#21e1ad6 type:string w:int h:int bytes:bytes = PhotoSize; photoStrippedSize#e0b0bc2e type:string bytes:bytes = PhotoSize; photoSizeProgressive#fa3efb95 type:string w:int h:int sizes:Vector<int> = PhotoSize; photoPathSize#d8214d41 type:string bytes:bytes = PhotoSize; geoPointEmpty#1117dd5f = GeoPoint; geoPoint#b2a2f663 flags:# long:double lat:double access_hash:long accuracy_radius:flags.0?int = GeoPoint; auth.sentCode#5e002502 flags:# type:auth.SentCodeType phone_code_hash:string next_type:flags.1?auth.CodeType timeout:flags.2?int = auth.SentCode; auth.authorization#33fb7bb8 flags:# setup_password_required:flags.1?true otherwise_relogin_days:flags.1?int tmp_sessions:flags.0?int user:User = auth.Authorization; auth.authorizationSignUpRequired#44747e9a flags:# terms_of_service:flags.0?help.TermsOfService = auth.Authorization; auth.exportedAuthorization#b434e2b8 id:long bytes:bytes = auth.ExportedAuthorization; inputNotifyPeer#b8bc5b0c peer:InputPeer = InputNotifyPeer; inputNotifyUsers#193b4417 = InputNotifyPeer; inputNotifyChats#4a95e84e = InputNotifyPeer; inputNotifyBroadcasts#b1db7c7e = InputNotifyPeer; inputNotifyForumTopic#5c467992 peer:InputPeer top_msg_id:int = InputNotifyPeer; inputPeerNotifySettings#df1f002b flags:# show_previews:flags.0?Bool silent:flags.1?Bool mute_until:flags.2?int sound:flags.3?NotificationSound = InputPeerNotifySettings; peerNotifySettings#a83b0426 flags:# show_previews:flags.0?Bool silent:flags.1?Bool mute_until:flags.2?int ios_sound:flags.3?NotificationSound android_sound:flags.4?NotificationSound other_sound:flags.5?NotificationSound = PeerNotifySettings; peerSettings#a518110d flags:# report_spam:flags.0?true add_contact:flags.1?true block_contact:flags.2?true share_contact:flags.3?true need_contacts_exception:flags.4?true report_geo:flags.5?true autoarchived:flags.7?true invite_members:flags.8?true request_chat_broadcast:flags.10?true geo_distance:flags.6?int request_chat_title:flags.9?string request_chat_date:flags.9?int = PeerSettings; wallPaper#a437c3ed id:long flags:# creator:flags.0?true default:flags.1?true pattern:flags.3?true dark:flags.4?true access_hash:long slug:string document:Document settings:flags.2?WallPaperSettings = WallPaper; wallPaperNoFile#e0804116 id:long flags:# default:flags.1?true dark:flags.4?true settings:flags.2?WallPaperSettings = WallPaper; inputReportReasonSpam#58dbcab8 = ReportReason; inputReportReasonViolence#1e22c78d = ReportReason; inputReportReasonPornography#2e59d922 = ReportReason; inputReportReasonChildAbuse#adf44ee3 = ReportReason; inputReportReasonOther#c1e4a2b1 = ReportReason; inputReportReasonCopyright#9b89f93a = ReportReason; inputReportReasonGeoIrrelevant#dbd4feed = ReportReason; inputReportReasonFake#f5ddd6e7 = ReportReason; inputReportReasonIllegalDrugs#a8eb2be = ReportReason; inputReportReasonPersonalDetails#9ec7863d = ReportReason; userFull#f8d32aed flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights premium_gifts:flags.19?Vector<PremiumGiftOption> = UserFull; contact#145ade0b user_id:long mutual:Bool = Contact; importedContact#c13e3c50 user_id:long client_id:long = ImportedContact; contactStatus#16d9703b user_id:long status:UserStatus = ContactStatus; contacts.contactsNotModified#b74ba9d2 = contacts.Contacts; contacts.contacts#eae87e42 contacts:Vector<Contact> saved_count:int users:Vector<User> = contacts.Contacts; contacts.importedContacts#77d01c3b imported:Vector<ImportedContact> popular_invites:Vector<PopularContact> retry_contacts:Vector<long> users:Vector<User> = contacts.ImportedContacts; contacts.blocked#ade1591 blocked:Vector<PeerBlocked> chats:Vector<Chat> users:Vector<User> = contacts.Blocked; contacts.blockedSlice#e1664194 count:int blocked:Vector<PeerBlocked> chats:Vector<Chat> users:Vector<User> = contacts.Blocked; messages.dialogs#15ba6c40 dialogs:Vector<Dialog> messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Dialogs; messages.dialogsSlice#71e094f3 count:int dialogs:Vector<Dialog> messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Dialogs; messages.dialogsNotModified#f0e3e596 count:int = messages.Dialogs; messages.messages#8c718e87 messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Messages; messages.messagesSlice#3a54685e flags:# inexact:flags.1?true count:int next_rate:flags.0?int offset_id_offset:flags.2?int messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Messages; messages.channelMessages#c776ba4e flags:# inexact:flags.1?true pts:int count:int offset_id_offset:flags.2?int messages:Vector<Message> topics:Vector<ForumTopic> chats:Vector<Chat> users:Vector<User> = messages.Messages; messages.messagesNotModified#74535f21 count:int = messages.Messages; messages.chats#64ff9fd5 chats:Vector<Chat> = messages.Chats; messages.chatsSlice#9cd81144 count:int chats:Vector<Chat> = messages.Chats; messages.chatFull#e5d7d19c full_chat:ChatFull chats:Vector<Chat> users:Vector<User> = messages.ChatFull; messages.affectedHistory#b45c69d1 pts:int pts_count:int offset:int = messages.AffectedHistory; inputMessagesFilterEmpty#57e2f66c = MessagesFilter; inputMessagesFilterPhotos#9609a51c = MessagesFilter; inputMessagesFilterVideo#9fc00e65 = MessagesFilter; inputMessagesFilterPhotoVideo#56e9f0e4 = MessagesFilter; inputMessagesFilterDocument#9eddf188 = MessagesFilter; inputMessagesFilterUrl#7ef0dd87 = MessagesFilter; inputMessagesFilterGif#ffc86587 = MessagesFilter; inputMessagesFilterVoice#50f5c392 = MessagesFilter; inputMessagesFilterMusic#3751b49e = MessagesFilter; inputMessagesFilterChatPhotos#3a20ecb8 = MessagesFilter; inputMessagesFilterPhoneCalls#80c99768 flags:# missed:flags.0?true = MessagesFilter; inputMessagesFilterRoundVoice#7a7c17a4 = MessagesFilter; inputMessagesFilterRoundVideo#b549da53 = MessagesFilter; inputMessagesFilterMyMentions#c1f8e69a = MessagesFilter; inputMessagesFilterGeo#e7026d0d = MessagesFilter; inputMessagesFilterContacts#e062db83 = MessagesFilter; inputMessagesFilterPinned#1bb00451 = MessagesFilter; updateNewMessage#1f2b0afd message:Message pts:int pts_count:int = Update; updateMessageID#4e90bfd6 id:int random_id:long = Update; updateDeleteMessages#a20db0e5 messages:Vector<int> pts:int pts_count:int = Update; updateUserTyping#c01e857f user_id:long action:SendMessageAction = Update; updateChatUserTyping#83487af0 chat_id:long from_id:Peer action:SendMessageAction = Update; updateChatParticipants#7761198 participants:ChatParticipants = Update; updateUserStatus#e5bdf8de user_id:long status:UserStatus = Update; updateUserName#a7848924 user_id:long first_name:string last_name:string usernames:Vector<Username> = Update; updateNewEncryptedMessage#12bcbd9a message:EncryptedMessage qts:int = Update; updateEncryptedChatTyping#1710f156 chat_id:int = Update; updateEncryption#b4a2e88d chat:EncryptedChat date:int = Update; updateEncryptedMessagesRead#38fe25b7 chat_id:int max_date:int date:int = Update; updateChatParticipantAdd#3dda5451 chat_id:long user_id:long inviter_id:long date:int version:int = Update; updateChatParticipantDelete#e32f3d77 chat_id:long user_id:long version:int = Update; updateDcOptions#8e5e9873 dc_options:Vector<DcOption> = Update; updateNotifySettings#bec268ef peer:NotifyPeer notify_settings:PeerNotifySettings = Update; updateServiceNotification#ebe46819 flags:# popup:flags.0?true inbox_date:flags.1?int type:string message:string media:MessageMedia entities:Vector<MessageEntity> = Update; updatePrivacy#ee3b272a key:PrivacyKey rules:Vector<PrivacyRule> = Update; updateUserPhone#5492a13 user_id:long phone:string = Update; updateReadHistoryInbox#9c974fdf flags:# folder_id:flags.0?int peer:Peer max_id:int still_unread_count:int pts:int pts_count:int = Update; updateReadHistoryOutbox#2f2f21bf peer:Peer max_id:int pts:int pts_count:int = Update; updateWebPage#7f891213 webpage:WebPage pts:int pts_count:int = Update; updateReadMessagesContents#68c13933 messages:Vector<int> pts:int pts_count:int = Update; updateChannelTooLong#108d941f flags:# channel_id:long pts:flags.0?int = Update; updateChannel#635b4c09 channel_id:long = Update; updateNewChannelMessage#62ba04d9 message:Message pts:int pts_count:int = Update; updateReadChannelInbox#922e6e10 flags:# folder_id:flags.0?int channel_id:long max_id:int still_unread_count:int pts:int = Update; updateDeleteChannelMessages#c32d5b12 channel_id:long messages:Vector<int> pts:int pts_count:int = Update; updateChannelMessageViews#f226ac08 channel_id:long id:int views:int = Update; updateChatParticipantAdmin#d7ca61a2 chat_id:long user_id:long is_admin:Bool version:int = Update; updateNewStickerSet#688a30aa stickerset:messages.StickerSet = Update; updateStickerSetsOrder#bb2d201 flags:# masks:flags.0?true emojis:flags.1?true order:Vector<long> = Update; updateStickerSets#31c24808 flags:# masks:flags.0?true emojis:flags.1?true = Update; updateSavedGifs#9375341e = Update; updateBotInlineQuery#496f379c flags:# query_id:long user_id:long query:string geo:flags.0?GeoPoint peer_type:flags.1?InlineQueryPeerType offset:string = Update; updateBotInlineSend#12f12a07 flags:# user_id:long query:string geo:flags.0?GeoPoint id:string msg_id:flags.1?InputBotInlineMessageID = Update; updateEditChannelMessage#1b3f4df7 message:Message pts:int pts_count:int = Update; updateBotCallbackQuery#b9cfc48d flags:# query_id:long user_id:long peer:Peer msg_id:int chat_instance:long data:flags.0?bytes game_short_name:flags.1?string = Update; updateEditMessage#e40370a3 message:Message pts:int pts_count:int = Update; updateInlineBotCallbackQuery#691e9052 flags:# query_id:long user_id:long msg_id:InputBotInlineMessageID chat_instance:long data:flags.0?bytes game_short_name:flags.1?string = Update; updateReadChannelOutbox#b75f99a9 channel_id:long max_id:int = Update; updateDraftMessage#1b49ec6d flags:# peer:Peer top_msg_id:flags.0?int draft:DraftMessage = Update; updateReadFeaturedStickers#571d2742 = Update; updateRecentStickers#9a422c20 = Update; updateConfig#a229dd06 = Update; updatePtsChanged#3354678f = Update; updateChannelWebPage#2f2ba99f channel_id:long webpage:WebPage pts:int pts_count:int = Update; updateDialogPinned#6e6fe51c flags:# pinned:flags.0?true folder_id:flags.1?int peer:DialogPeer = Update; updatePinnedDialogs#fa0f3ca2 flags:# folder_id:flags.1?int order:flags.0?Vector<DialogPeer> = Update; updateBotWebhookJSON#8317c0c3 data:DataJSON = Update; updateBotWebhookJSONQuery#9b9240a6 query_id:long data:DataJSON timeout:int = Update; updateBotShippingQuery#b5aefd7d query_id:long user_id:long payload:bytes shipping_address:PostAddress = Update; updateBotPrecheckoutQuery#8caa9a96 flags:# query_id:long user_id:long payload:bytes info:flags.0?PaymentRequestedInfo shipping_option_id:flags.1?string currency:string total_amount:long = Update; updatePhoneCall#ab0f6b1e phone_call:PhoneCall = Update; updateLangPackTooLong#46560264 lang_code:string = Update; updateLangPack#56022f4d difference:LangPackDifference = Update; updateFavedStickers#e511996d = Update; updateChannelReadMessagesContents#ea29055d flags:# channel_id:long top_msg_id:flags.0?int messages:Vector<int> = Update; updateContactsReset#7084a7be = Update; updateChannelAvailableMessages#b23fc698 channel_id:long available_min_id:int = Update; updateDialogUnreadMark#e16459c3 flags:# unread:flags.0?true peer:DialogPeer = Update; updateMessagePoll#aca1657b flags:# poll_id:long poll:flags.0?Poll results:PollResults = Update; updateChatDefaultBannedRights#54c01850 peer:Peer default_banned_rights:ChatBannedRights version:int = Update; updateFolderPeers#19360dc0 folder_peers:Vector<FolderPeer> pts:int pts_count:int = Update; updatePeerSettings#6a7e7366 peer:Peer settings:PeerSettings = Update; updatePeerLocated#b4afcfb0 peers:Vector<PeerLocated> = Update; updateNewScheduledMessage#39a51dfb message:Message = Update; updateDeleteScheduledMessages#90866cee peer:Peer messages:Vector<int> = Update; updateTheme#8216fba3 theme:Theme = Update; updateGeoLiveViewed#871fb939 peer:Peer msg_id:int = Update; updateLoginToken#564fe691 = Update; updateMessagePollVote#106395c9 poll_id:long user_id:long options:Vector<bytes> qts:int = Update; updateDialogFilter#26ffde7d flags:# id:int filter:flags.0?DialogFilter = Update; updateDialogFilterOrder#a5d72105 order:Vector<int> = Update; updateDialogFilters#3504914f = Update; updatePhoneCallSignalingData#2661bf09 phone_call_id:long data:bytes = Update; updateChannelMessageForwards#d29a27f4 channel_id:long id:int forwards:int = Update; updateReadChannelDiscussionInbox#d6b19546 flags:# channel_id:long top_msg_id:int read_max_id:int broadcast_id:flags.0?long broadcast_post:flags.0?int = Update; updateReadChannelDiscussionOutbox#695c9e7c channel_id:long top_msg_id:int read_max_id:int = Update; updatePeerBlocked#246a4b22 peer_id:Peer blocked:Bool = Update; updateChannelUserTyping#8c88c923 flags:# channel_id:long top_msg_id:flags.0?int from_id:Peer action:SendMessageAction = Update; updatePinnedMessages#ed85eab5 flags:# pinned:flags.0?true peer:Peer messages:Vector<int> pts:int pts_count:int = Update; updatePinnedChannelMessages#5bb98608 flags:# pinned:flags.0?true channel_id:long messages:Vector<int> pts:int pts_count:int = Update; updateChat#f89a6a4e chat_id:long = Update; updateGroupCallParticipants#f2ebdb4e call:InputGroupCall participants:Vector<GroupCallParticipant> version:int = Update; updateGroupCall#14b24500 chat_id:long call:GroupCall = Update; updatePeerHistoryTTL#bb9bb9a5 flags:# peer:Peer ttl_period:flags.0?int = Update; updateChatParticipant#d087663a flags:# chat_id:long date:int actor_id:long user_id:long prev_participant:flags.0?ChatParticipant new_participant:flags.1?ChatParticipant invite:flags.2?ExportedChatInvite qts:int = Update; updateChannelParticipant#985d3abb flags:# channel_id:long date:int actor_id:long user_id:long prev_participant:flags.0?ChannelParticipant new_participant:flags.1?ChannelParticipant invite:flags.2?ExportedChatInvite qts:int = Update; updateBotStopped#c4870a49 user_id:long date:int stopped:Bool qts:int = Update; updateGroupCallConnection#b783982 flags:# presentation:flags.0?true params:DataJSON = Update; updateBotCommands#4d712f2e peer:Peer bot_id:long commands:Vector<BotCommand> = Update; updatePendingJoinRequests#7063c3db peer:Peer requests_pending:int recent_requesters:Vector<long> = Update; updateBotChatInviteRequester#11dfa986 peer:Peer date:int user_id:long about:string invite:ExportedChatInvite qts:int = Update; updateMessageReactions#5e1b3cb8 flags:# peer:Peer msg_id:int top_msg_id:flags.0?int reactions:MessageReactions = Update; updateAttachMenuBots#17b7a20b = Update; updateWebViewResultSent#1592b79d query_id:long = Update; updateBotMenuButton#14b85813 bot_id:long button:BotMenuButton = Update; updateSavedRingtones#74d8be99 = Update; updateTranscribedAudio#84cd5a flags:# pending:flags.0?true peer:Peer msg_id:int transcription_id:long text:string = Update; updateReadFeaturedEmojiStickers#fb4c496c = Update; updateUserEmojiStatus#28373599 user_id:long emoji_status:EmojiStatus = Update; updateRecentEmojiStatuses#30f443db = Update; updateRecentReactions#6f7863f4 = Update; updateMoveStickerSetToTop#86fccf85 flags:# masks:flags.0?true emojis:flags.1?true stickerset:long = Update; updateMessageExtendedMedia#5a73a98c peer:Peer msg_id:int extended_media:MessageExtendedMedia = Update; updateChannelPinnedTopic#192efbe3 flags:# pinned:flags.0?true channel_id:long topic_id:int = Update; updateChannelPinnedTopics#fe198602 flags:# channel_id:long order:flags.0?Vector<int> = Update; updateUser#20529438 user_id:long = Update; updates.state#a56c2a3e pts:int qts:int date:int seq:int unread_count:int = updates.State; updates.differenceEmpty#5d75a138 date:int seq:int = updates.Difference; updates.difference#f49ca0 new_messages:Vector<Message> new_encrypted_messages:Vector<EncryptedMessage> other_updates:Vector<Update> chats:Vector<Chat> users:Vector<User> state:updates.State = updates.Difference; updates.differenceSlice#a8fb1981 new_messages:Vector<Message> new_encrypted_messages:Vector<EncryptedMessage> other_updates:Vector<Update> chats:Vector<Chat> users:Vector<User> intermediate_state:updates.State = updates.Difference; updates.differenceTooLong#4afe8f6d pts:int = updates.Difference; updatesTooLong#e317af7e = Updates; updateShortMessage#313bc7f8 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int user_id:long message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates; updateShortChatMessage#4d6deea5 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int from_id:long chat_id:long message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates; updateShort#78d4dec1 update:Update date:int = Updates; updatesCombined#725b04c3 updates:Vector<Update> users:Vector<User> chats:Vector<Chat> date:int seq_start:int seq:int = Updates; updates#74ae4240 updates:Vector<Update> users:Vector<User> chats:Vector<Chat> date:int seq:int = Updates; updateShortSentMessage#9015e101 flags:# out:flags.1?true id:int pts:int pts_count:int date:int media:flags.9?MessageMedia entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates; photos.photos#8dca6aa5 photos:Vector<Photo> users:Vector<User> = photos.Photos; photos.photosSlice#15051f54 count:int photos:Vector<Photo> users:Vector<User> = photos.Photos; photos.photo#20212ca8 photo:Photo users:Vector<User> = photos.Photo; upload.file#96a18d5 type:storage.FileType mtime:int bytes:bytes = upload.File; upload.fileCdnRedirect#f18cda44 dc_id:int file_token:bytes encryption_key:bytes encryption_iv:bytes file_hashes:Vector<FileHash> = upload.File; dcOption#18b7a10d flags:# ipv6:flags.0?true media_only:flags.1?true tcpo_only:flags.2?true cdn:flags.3?true static:flags.4?true this_port_only:flags.5?true id:int ip_address:string port:int secret:flags.10?bytes = DcOption; config#232566ac flags:# phonecalls_enabled:flags.1?true default_p2p_contacts:flags.3?true preload_featured_stickers:flags.4?true ignore_phone_entities:flags.5?true revoke_pm_inbox:flags.6?true blocked_mode:flags.8?true pfs_enabled:flags.13?true force_try_ipv6:flags.14?true date:int expires:int test_mode:Bool this_dc:int dc_options:Vector<DcOption> dc_txt_domain_name:string chat_size_max:int megagroup_size_max:int forwarded_count_max:int online_update_period_ms:int offline_blur_timeout_ms:int offline_idle_timeout_ms:int online_cloud_timeout_ms:int notify_cloud_delay_ms:int notify_default_delay_ms:int push_chat_period_ms:int push_chat_limit:int saved_gifs_limit:int edit_time_limit:int revoke_time_limit:int revoke_pm_time_limit:int rating_e_decay:int stickers_recent_limit:int stickers_faved_limit:int channels_read_media_period:int tmp_sessions:flags.0?int pinned_dialogs_count_max:int pinned_infolder_count_max:int call_receive_timeout_ms:int call_ring_timeout_ms:int call_connect_timeout_ms:int call_packet_timeout_ms:int me_url_prefix:string autoupdate_url_prefix:flags.7?string gif_search_username:flags.9?string venue_search_username:flags.10?string img_search_username:flags.11?string static_maps_provider:flags.12?string caption_length_max:int message_length_max:int webfile_dc_id:int suggested_lang_code:flags.2?string lang_pack_version:flags.2?int base_lang_pack_version:flags.2?int reactions_default:flags.15?Reaction = Config; nearestDc#8e1a1775 country:string this_dc:int nearest_dc:int = NearestDc; help.appUpdate#ccbbce30 flags:# can_not_skip:flags.0?true id:int version:string text:string entities:Vector<MessageEntity> document:flags.1?Document url:flags.2?string sticker:flags.3?Document = help.AppUpdate; help.noAppUpdate#c45a6536 = help.AppUpdate; help.inviteText#18cb9f78 message:string = help.InviteText; encryptedChatEmpty#ab7ec0a0 id:int = EncryptedChat; encryptedChatWaiting#66b25953 id:int access_hash:long date:int admin_id:long participant_id:long = EncryptedChat; encryptedChatRequested#48f1d94c flags:# folder_id:flags.0?int id:int access_hash:long date:int admin_id:long participant_id:long g_a:bytes = EncryptedChat; encryptedChat#61f0d4c7 id:int access_hash:long date:int admin_id:long participant_id:long g_a_or_b:bytes key_fingerprint:long = EncryptedChat; encryptedChatDiscarded#1e1c7c45 flags:# history_deleted:flags.0?true id:int = EncryptedChat; inputEncryptedChat#f141b5e1 chat_id:int access_hash:long = InputEncryptedChat; encryptedFileEmpty#c21f497e = EncryptedFile; encryptedFile#a8008cd8 id:long access_hash:long size:long dc_id:int key_fingerprint:int = EncryptedFile; inputEncryptedFileEmpty#1837c364 = InputEncryptedFile; inputEncryptedFileUploaded#64bd0306 id:long parts:int md5_checksum:string key_fingerprint:int = InputEncryptedFile; inputEncryptedFile#5a17b5e5 id:long access_hash:long = InputEncryptedFile; inputEncryptedFileBigUploaded#2dc173c8 id:long parts:int key_fingerprint:int = InputEncryptedFile; encryptedMessage#ed18c118 random_id:long chat_id:int date:int bytes:bytes file:EncryptedFile = EncryptedMessage; encryptedMessageService#23734b06 random_id:long chat_id:int date:int bytes:bytes = EncryptedMessage; messages.dhConfigNotModified#c0e24635 random:bytes = messages.DhConfig; messages.dhConfig#2c221edd g:int p:bytes version:int random:bytes = messages.DhConfig; messages.sentEncryptedMessage#560f8935 date:int = messages.SentEncryptedMessage; messages.sentEncryptedFile#9493ff32 date:int file:EncryptedFile = messages.SentEncryptedMessage; inputDocumentEmpty#72f0eaae = InputDocument; inputDocument#1abfb575 id:long access_hash:long file_reference:bytes = InputDocument; documentEmpty#36f8c871 id:long = Document; document#8fd4c4d8 flags:# id:long access_hash:long file_reference:bytes date:int mime_type:string size:long thumbs:flags.0?Vector<PhotoSize> video_thumbs:flags.1?Vector<VideoSize> dc_id:int attributes:Vector<DocumentAttribute> = Document; help.support#17c6b5f6 phone_number:string user:User = help.Support; notifyPeer#9fd40bd8 peer:Peer = NotifyPeer; notifyUsers#b4c83b4c = NotifyPeer; notifyChats#c007cec3 = NotifyPeer; notifyBroadcasts#d612e8ef = NotifyPeer; notifyForumTopic#226e6308 peer:Peer top_msg_id:int = NotifyPeer; sendMessageTypingAction#16bf744e = SendMessageAction; sendMessageCancelAction#fd5ec8f5 = SendMessageAction; sendMessageRecordVideoAction#a187d66f = SendMessageAction; sendMessageUploadVideoAction#e9763aec progress:int = SendMessageAction; sendMessageRecordAudioAction#d52f73f7 = SendMessageAction; sendMessageUploadAudioAction#f351d7ab progress:int = SendMessageAction; sendMessageUploadPhotoAction#d1d34a26 progress:int = SendMessageAction; sendMessageUploadDocumentAction#aa0cd9e4 progress:int = SendMessageAction; sendMessageGeoLocationAction#176f8ba1 = SendMessageAction; sendMessageChooseContactAction#628cbc6f = SendMessageAction; sendMessageGamePlayAction#dd6a8f48 = SendMessageAction; sendMessageRecordRoundAction#88f27fbc = SendMessageAction; sendMessageUploadRoundAction#243e1c66 progress:int = SendMessageAction; speakingInGroupCallAction#d92c2285 = SendMessageAction; sendMessageHistoryImportAction#dbda9246 progress:int = SendMessageAction; sendMessageChooseStickerAction#b05ac6b1 = SendMessageAction; sendMessageEmojiInteraction#25972bcb emoticon:string msg_id:int interaction:DataJSON = SendMessageAction; sendMessageEmojiInteractionSeen#b665902e emoticon:string = SendMessageAction; contacts.found#b3134d9d my_results:Vector<Peer> results:Vector<Peer> chats:Vector<Chat> users:Vector<User> = contacts.Found; inputPrivacyKeyStatusTimestamp#4f96cb18 = InputPrivacyKey; inputPrivacyKeyChatInvite#bdfb0426 = InputPrivacyKey; inputPrivacyKeyPhoneCall#fabadc5f = InputPrivacyKey; inputPrivacyKeyPhoneP2P#db9e70d2 = InputPrivacyKey; inputPrivacyKeyForwards#a4dd4c08 = InputPrivacyKey; inputPrivacyKeyProfilePhoto#5719bacc = InputPrivacyKey; inputPrivacyKeyPhoneNumber#352dafa = InputPrivacyKey; inputPrivacyKeyAddedByPhone#d1219bdd = InputPrivacyKey; inputPrivacyKeyVoiceMessages#aee69d68 = InputPrivacyKey; privacyKeyStatusTimestamp#bc2eab30 = PrivacyKey; privacyKeyChatInvite#500e6dfa = PrivacyKey; privacyKeyPhoneCall#3d662b7b = PrivacyKey; privacyKeyPhoneP2P#39491cc8 = PrivacyKey; privacyKeyForwards#69ec56a3 = PrivacyKey; privacyKeyProfilePhoto#96151fed = PrivacyKey; privacyKeyPhoneNumber#d19ae46d = PrivacyKey; privacyKeyAddedByPhone#42ffd42b = PrivacyKey; privacyKeyVoiceMessages#697f414 = PrivacyKey; inputPrivacyValueAllowContacts#d09e07b = InputPrivacyRule; inputPrivacyValueAllowAll#184b35ce = InputPrivacyRule; inputPrivacyValueAllowUsers#131cc67f users:Vector<InputUser> = InputPrivacyRule; inputPrivacyValueDisallowContacts#ba52007 = InputPrivacyRule; inputPrivacyValueDisallowAll#d66b66c9 = InputPrivacyRule; inputPrivacyValueDisallowUsers#90110467 users:Vector<InputUser> = InputPrivacyRule; inputPrivacyValueAllowChatParticipants#840649cf chats:Vector<long> = InputPrivacyRule; inputPrivacyValueDisallowChatParticipants#e94f0f86 chats:Vector<long> = InputPrivacyRule; privacyValueAllowContacts#fffe1bac = PrivacyRule; privacyValueAllowAll#65427b82 = PrivacyRule; privacyValueAllowUsers#b8905fb2 users:Vector<long> = PrivacyRule; privacyValueDisallowContacts#f888fa1a = PrivacyRule; privacyValueDisallowAll#8b73e763 = PrivacyRule; privacyValueDisallowUsers#e4621141 users:Vector<long> = PrivacyRule; privacyValueAllowChatParticipants#6b134e8e chats:Vector<long> = PrivacyRule; privacyValueDisallowChatParticipants#41c87565 chats:Vector<long> = PrivacyRule; account.privacyRules#50a04e45 rules:Vector<PrivacyRule> chats:Vector<Chat> users:Vector<User> = account.PrivacyRules; accountDaysTTL#b8d0afdf days:int = AccountDaysTTL; documentAttributeImageSize#6c37c15c w:int h:int = DocumentAttribute; documentAttributeAnimated#11b58939 = DocumentAttribute; documentAttributeSticker#6319d612 flags:# mask:flags.1?true alt:string stickerset:InputStickerSet mask_coords:flags.0?MaskCoords = DocumentAttribute; documentAttributeVideo#ef02ce6 flags:# round_message:flags.0?true supports_streaming:flags.1?true duration:int w:int h:int = DocumentAttribute; documentAttributeAudio#9852f9c6 flags:# voice:flags.10?true duration:int title:flags.0?string performer:flags.1?string waveform:flags.2?bytes = DocumentAttribute; documentAttributeFilename#15590068 file_name:string = DocumentAttribute; documentAttributeHasStickers#9801d2f7 = DocumentAttribute; documentAttributeCustomEmoji#fd149899 flags:# free:flags.0?true text_color:flags.1?true alt:string stickerset:InputStickerSet = DocumentAttribute; messages.stickersNotModified#f1749a22 = messages.Stickers; messages.stickers#30a6ec7e hash:long stickers:Vector<Document> = messages.Stickers; stickerPack#12b299d4 emoticon:string documents:Vector<long> = StickerPack; messages.allStickersNotModified#e86602c3 = messages.AllStickers; messages.allStickers#cdbbcebb hash:long sets:Vector<StickerSet> = messages.AllStickers; messages.affectedMessages#84d19185 pts:int pts_count:int = messages.AffectedMessages; webPageEmpty#eb1477e8 id:long = WebPage; webPagePending#c586da1c id:long date:int = WebPage; webPage#e89c45b2 flags:# id:long url:string display_url:string hash:int type:flags.0?string site_name:flags.1?string title:flags.2?string description:flags.3?string photo:flags.4?Photo embed_url:flags.5?string embed_type:flags.5?string embed_width:flags.6?int embed_height:flags.6?int duration:flags.7?int author:flags.8?string document:flags.9?Document cached_page:flags.10?Page attributes:flags.12?Vector<WebPageAttribute> = WebPage; webPageNotModified#7311ca11 flags:# cached_page_views:flags.0?int = WebPage; authorization#ad01d61d flags:# current:flags.0?true official_app:flags.1?true password_pending:flags.2?true encrypted_requests_disabled:flags.3?true call_requests_disabled:flags.4?true hash:long device_model:string platform:string system_version:string api_id:int app_name:string app_version:string date_created:int date_active:int ip:string country:string region:string = Authorization; account.authorizations#4bff8ea0 authorization_ttl_days:int authorizations:Vector<Authorization> = account.Authorizations; account.password#957b50fb flags:# has_recovery:flags.0?true has_secure_values:flags.1?true has_password:flags.2?true current_algo:flags.2?PasswordKdfAlgo srp_B:flags.2?bytes srp_id:flags.2?long hint:flags.3?string email_unconfirmed_pattern:flags.4?string new_algo:PasswordKdfAlgo new_secure_algo:SecurePasswordKdfAlgo secure_random:bytes pending_reset_date:flags.5?int login_email_pattern:flags.6?string = account.Password; account.passwordSettings#9a5c33e5 flags:# email:flags.0?string secure_settings:flags.1?SecureSecretSettings = account.PasswordSettings; account.passwordInputSettings#c23727c9 flags:# new_algo:flags.0?PasswordKdfAlgo new_password_hash:flags.0?bytes hint:flags.0?string email:flags.1?string new_secure_settings:flags.2?SecureSecretSettings = account.PasswordInputSettings; auth.passwordRecovery#137948a5 email_pattern:string = auth.PasswordRecovery; receivedNotifyMessage#a384b779 id:int flags:int = ReceivedNotifyMessage; chatInviteExported#ab4a819 flags:# revoked:flags.0?true permanent:flags.5?true request_needed:flags.6?true link:string admin_id:long date:int start_date:flags.4?int expire_date:flags.1?int usage_limit:flags.2?int usage:flags.3?int requested:flags.7?int title:flags.8?string = ExportedChatInvite; chatInvitePublicJoinRequests#ed107ab7 = ExportedChatInvite; chatInviteAlready#5a686d7c chat:Chat = ChatInvite; chatInvite#300c44c1 flags:# channel:flags.0?true broadcast:flags.1?true public:flags.2?true megagroup:flags.3?true request_needed:flags.6?true title:string about:flags.5?string photo:Photo participants_count:int participants:flags.4?Vector<User> = ChatInvite; chatInvitePeek#61695cb0 chat:Chat expires:int = ChatInvite; inputStickerSetEmpty#ffb62b95 = InputStickerSet; inputStickerSetID#9de7a269 id:long access_hash:long = InputStickerSet; inputStickerSetShortName#861cc8a0 short_name:string = InputStickerSet; inputStickerSetAnimatedEmoji#28703c8 = InputStickerSet; inputStickerSetDice#e67f520e emoticon:string = InputStickerSet; inputStickerSetAnimatedEmojiAnimations#cde3739 = InputStickerSet; inputStickerSetPremiumGifts#c88b3b02 = InputStickerSet; inputStickerSetEmojiGenericAnimations#4c4d4ce = InputStickerSet; inputStickerSetEmojiDefaultStatuses#29d0f5ee = InputStickerSet; inputStickerSetEmojiDefaultTopicIcons#44c1f8e9 = InputStickerSet; stickerSet#2dd14edc flags:# archived:flags.1?true official:flags.2?true masks:flags.3?true animated:flags.5?true videos:flags.6?true emojis:flags.7?true installed_date:flags.0?int id:long access_hash:long title:string short_name:string thumbs:flags.4?Vector<PhotoSize> thumb_dc_id:flags.4?int thumb_version:flags.4?int thumb_document_id:flags.8?long count:int hash:int = StickerSet; messages.stickerSet#6e153f16 set:StickerSet packs:Vector<StickerPack> keywords:Vector<StickerKeyword> documents:Vector<Document> = messages.StickerSet; messages.stickerSetNotModified#d3f924eb = messages.StickerSet; botCommand#c27ac8c7 command:string description:string = BotCommand; botInfo#8f300b57 flags:# user_id:flags.0?long description:flags.1?string description_photo:flags.4?Photo description_document:flags.5?Document commands:flags.2?Vector<BotCommand> menu_button:flags.3?BotMenuButton = BotInfo; keyboardButton#a2fa4880 text:string = KeyboardButton; keyboardButtonUrl#258aff05 text:string url:string = KeyboardButton; keyboardButtonCallback#35bbdb6b flags:# requires_password:flags.0?true text:string data:bytes = KeyboardButton; keyboardButtonRequestPhone#b16a6c29 text:string = KeyboardButton; keyboardButtonRequestGeoLocation#fc796b3f text:string = KeyboardButton; keyboardButtonSwitchInline#568a748 flags:# same_peer:flags.0?true text:string query:string = KeyboardButton; keyboardButtonGame#50f41ccf text:string = KeyboardButton; keyboardButtonBuy#afd93fbb text:string = KeyboardButton; keyboardButtonUrlAuth#10b78d29 flags:# text:string fwd_text:flags.0?string url:string button_id:int = KeyboardButton; inputKeyboardButtonUrlAuth#d02e7fd4 flags:# request_write_access:flags.0?true text:string fwd_text:flags.1?string url:string bot:InputUser = KeyboardButton; keyboardButtonRequestPoll#bbc7515d flags:# quiz:flags.0?Bool text:string = KeyboardButton; inputKeyboardButtonUserProfile#e988037b text:string user_id:InputUser = KeyboardButton; keyboardButtonUserProfile#308660c1 text:string user_id:long = KeyboardButton; keyboardButtonWebView#13767230 text:string url:string = KeyboardButton; keyboardButtonSimpleWebView#a0c0505c text:string url:string = KeyboardButton; keyboardButtonRow#77608b83 buttons:Vector<KeyboardButton> = KeyboardButtonRow; replyKeyboardHide#a03e5b85 flags:# selective:flags.2?true = ReplyMarkup; replyKeyboardForceReply#86b40b08 flags:# single_use:flags.1?true selective:flags.2?true placeholder:flags.3?string = ReplyMarkup; replyKeyboardMarkup#85dd99d1 flags:# resize:flags.0?true single_use:flags.1?true selective:flags.2?true persistent:flags.4?true rows:Vector<KeyboardButtonRow> placeholder:flags.3?string = ReplyMarkup; replyInlineMarkup#48a30254 rows:Vector<KeyboardButtonRow> = ReplyMarkup; messageEntityUnknown#bb92ba95 offset:int length:int = MessageEntity; messageEntityMention#fa04579d offset:int length:int = MessageEntity; messageEntityHashtag#6f635b0d offset:int length:int = MessageEntity; messageEntityBotCommand#6cef8ac7 offset:int length:int = MessageEntity; messageEntityUrl#6ed02538 offset:int length:int = MessageEntity; messageEntityEmail#64e475c2 offset:int length:int = MessageEntity; messageEntityBold#bd610bc9 offset:int length:int = MessageEntity; messageEntityItalic#826f8b60 offset:int length:int = MessageEntity; messageEntityCode#28a20571 offset:int length:int = MessageEntity; messageEntityPre#73924be0 offset:int length:int language:string = MessageEntity; messageEntityTextUrl#76a6d327 offset:int length:int url:string = MessageEntity; messageEntityMentionName#dc7b1140 offset:int length:int user_id:long = MessageEntity; inputMessageEntityMentionName#208e68c9 offset:int length:int user_id:InputUser = MessageEntity; messageEntityPhone#9b69e34b offset:int length:int = MessageEntity; messageEntityCashtag#4c4e743f offset:int length:int = MessageEntity; messageEntityUnderline#9c4e7e8b offset:int length:int = MessageEntity; messageEntityStrike#bf0693d4 offset:int length:int = MessageEntity; messageEntityBlockquote#20df5d0 offset:int length:int = MessageEntity; messageEntityBankCard#761e6af4 offset:int length:int = MessageEntity; messageEntitySpoiler#32ca960f offset:int length:int = MessageEntity; messageEntityCustomEmoji#c8cf05f8 offset:int length:int document_id:long = MessageEntity; inputChannelEmpty#ee8c1e86 = InputChannel; inputChannel#f35aec28 channel_id:long access_hash:long = InputChannel; inputChannelFromMessage#5b934f9d peer:InputPeer msg_id:int channel_id:long = InputChannel; contacts.resolvedPeer#7f077ad9 peer:Peer chats:Vector<Chat> users:Vector<User> = contacts.ResolvedPeer; messageRange#ae30253 min_id:int max_id:int = MessageRange; updates.channelDifferenceEmpty#3e11affb flags:# final:flags.0?true pts:int timeout:flags.1?int = updates.ChannelDifference; updates.channelDifferenceTooLong#a4bcc6fe flags:# final:flags.0?true timeout:flags.1?int dialog:Dialog messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = updates.ChannelDifference; updates.channelDifference#2064674e flags:# final:flags.0?true pts:int timeout:flags.1?int new_messages:Vector<Message> other_updates:Vector<Update> chats:Vector<Chat> users:Vector<User> = updates.ChannelDifference; channelMessagesFilterEmpty#94d42ee7 = ChannelMessagesFilter; channelMessagesFilter#cd77d957 flags:# exclude_new_messages:flags.1?true ranges:Vector<MessageRange> = ChannelMessagesFilter; channelParticipant#c00c07c0 user_id:long date:int = ChannelParticipant; channelParticipantSelf#35a8bfa7 flags:# via_request:flags.0?true user_id:long inviter_id:long date:int = ChannelParticipant; channelParticipantCreator#2fe601d3 flags:# user_id:long admin_rights:ChatAdminRights rank:flags.0?string = ChannelParticipant; channelParticipantAdmin#34c3bb53 flags:# can_edit:flags.0?true self:flags.1?true user_id:long inviter_id:flags.1?long promoted_by:long date:int admin_rights:ChatAdminRights rank:flags.2?string = ChannelParticipant; channelParticipantBanned#6df8014e flags:# left:flags.0?true peer:Peer kicked_by:long date:int banned_rights:ChatBannedRights = ChannelParticipant; channelParticipantLeft#1b03f006 peer:Peer = ChannelParticipant; channelParticipantsRecent#de3f3c79 = ChannelParticipantsFilter; channelParticipantsAdmins#b4608969 = ChannelParticipantsFilter; channelParticipantsKicked#a3b54985 q:string = ChannelParticipantsFilter; channelParticipantsBots#b0d1865b = ChannelParticipantsFilter; channelParticipantsBanned#1427a5e1 q:string = ChannelParticipantsFilter; channelParticipantsSearch#656ac4b q:string = ChannelParticipantsFilter; channelParticipantsContacts#bb6ae88d q:string = ChannelParticipantsFilter; channelParticipantsMentions#e04b5ceb flags:# q:flags.0?string top_msg_id:flags.1?int = ChannelParticipantsFilter; channels.channelParticipants#9ab0feaf count:int participants:Vector<ChannelParticipant> chats:Vector<Chat> users:Vector<User> = channels.ChannelParticipants; channels.channelParticipantsNotModified#f0173fe9 = channels.ChannelParticipants; channels.channelParticipant#dfb80317 participant:ChannelParticipant chats:Vector<Chat> users:Vector<User> = channels.ChannelParticipant; help.termsOfService#780a0310 flags:# popup:flags.0?true id:DataJSON text:string entities:Vector<MessageEntity> min_age_confirm:flags.1?int = help.TermsOfService; messages.savedGifsNotModified#e8025ca2 = messages.SavedGifs; messages.savedGifs#84a02a0d hash:long gifs:Vector<Document> = messages.SavedGifs; inputBotInlineMessageMediaAuto#3380c786 flags:# message:string entities:flags.1?Vector<MessageEntity> reply_markup:flags.2?ReplyMarkup = InputBotInlineMessage; inputBotInlineMessageText#3dcd7a87 flags:# no_webpage:flags.0?true message:string entities:flags.1?Vector<MessageEntity> reply_markup:flags.2?ReplyMarkup = InputBotInlineMessage; inputBotInlineMessageMediaGeo#96929a85 flags:# geo_point:InputGeoPoint heading:flags.0?int period:flags.1?int proximity_notification_radius:flags.3?int reply_markup:flags.2?ReplyMarkup = InputBotInlineMessage; inputBotInlineMessageMediaVenue#417bbf11 flags:# geo_point:InputGeoPoint title:string address:string provider:string venue_id:string venue_type:string reply_markup:flags.2?ReplyMarkup = InputBotInlineMessage; inputBotInlineMessageMediaContact#a6edbffd flags:# phone_number:string first_name:string last_name:string vcard:string reply_markup:flags.2?ReplyMarkup = InputBotInlineMessage; inputBotInlineMessageGame#4b425864 flags:# reply_markup:flags.2?ReplyMarkup = InputBotInlineMessage; inputBotInlineMessageMediaInvoice#d7e78225 flags:# title:string description:string photo:flags.0?InputWebDocument invoice:Invoice payload:bytes provider:string provider_data:DataJSON reply_markup:flags.2?ReplyMarkup = InputBotInlineMessage; inputBotInlineResult#88bf9319 flags:# id:string type:string title:flags.1?string description:flags.2?string url:flags.3?string thumb:flags.4?InputWebDocument content:flags.5?InputWebDocument send_message:InputBotInlineMessage = InputBotInlineResult; inputBotInlineResultPhoto#a8d864a7 id:string type:string photo:InputPhoto send_message:InputBotInlineMessage = InputBotInlineResult; inputBotInlineResultDocument#fff8fdc4 flags:# id:string type:string title:flags.1?string description:flags.2?string document:InputDocument send_message:InputBotInlineMessage = InputBotInlineResult; inputBotInlineResultGame#4fa417f2 id:string short_name:string send_message:InputBotInlineMessage = InputBotInlineResult; botInlineMessageMediaAuto#764cf810 flags:# message:string entities:flags.1?Vector<MessageEntity> reply_markup:flags.2?ReplyMarkup = BotInlineMessage; botInlineMessageText#8c7f65e2 flags:# no_webpage:flags.0?true message:string entities:flags.1?Vector<MessageEntity> reply_markup:flags.2?ReplyMarkup = BotInlineMessage; botInlineMessageMediaGeo#51846fd flags:# geo:GeoPoint heading:flags.0?int period:flags.1?int proximity_notification_radius:flags.3?int reply_markup:flags.2?ReplyMarkup = BotInlineMessage; botInlineMessageMediaVenue#8a86659c flags:# geo:GeoPoint title:string address:string provider:string venue_id:string venue_type:string reply_markup:flags.2?ReplyMarkup = BotInlineMessage; botInlineMessageMediaContact#18d1cdc2 flags:# phone_number:string first_name:string last_name:string vcard:string reply_markup:flags.2?ReplyMarkup = BotInlineMessage; botInlineMessageMediaInvoice#354a9b09 flags:# shipping_address_requested:flags.1?true test:flags.3?true title:string description:string photo:flags.0?WebDocument currency:string total_amount:long reply_markup:flags.2?ReplyMarkup = BotInlineMessage; botInlineResult#11965f3a flags:# id:string type:string title:flags.1?string description:flags.2?string url:flags.3?string thumb:flags.4?WebDocument content:flags.5?WebDocument send_message:BotInlineMessage = BotInlineResult; botInlineMediaResult#17db940b flags:# id:string type:string photo:flags.0?Photo document:flags.1?Document title:flags.2?string description:flags.3?string send_message:BotInlineMessage = BotInlineResult; messages.botResults#947ca848 flags:# gallery:flags.0?true query_id:long next_offset:flags.1?string switch_pm:flags.2?InlineBotSwitchPM results:Vector<BotInlineResult> cache_time:int users:Vector<User> = messages.BotResults; exportedMessageLink#5dab1af4 link:string html:string = ExportedMessageLink; messageFwdHeader#5f777dce flags:# imported:flags.7?true from_id:flags.0?Peer from_name:flags.5?string date:int channel_post:flags.2?int post_author:flags.3?string saved_from_peer:flags.4?Peer saved_from_msg_id:flags.4?int psa_type:flags.6?string = MessageFwdHeader; auth.codeTypeSms#72a3158c = auth.CodeType; auth.codeTypeCall#741cd3e3 = auth.CodeType; auth.codeTypeFlashCall#226ccefb = auth.CodeType; auth.codeTypeMissedCall#d61ad6ee = auth.CodeType; auth.codeTypeFragmentSms#6ed998c = auth.CodeType; auth.sentCodeTypeApp#3dbb5986 length:int = auth.SentCodeType; auth.sentCodeTypeSms#c000bba2 length:int = auth.SentCodeType; auth.sentCodeTypeCall#5353e5a7 length:int = auth.SentCodeType; auth.sentCodeTypeFlashCall#ab03c6d9 pattern:string = auth.SentCodeType; auth.sentCodeTypeMissedCall#82006484 prefix:string length:int = auth.SentCodeType; auth.sentCodeTypeEmailCode#5a159841 flags:# apple_signin_allowed:flags.0?true google_signin_allowed:flags.1?true email_pattern:string length:int next_phone_login_date:flags.2?int = auth.SentCodeType; auth.sentCodeTypeSetUpEmailRequired#a5491dea flags:# apple_signin_allowed:flags.0?true google_signin_allowed:flags.1?true = auth.SentCodeType; auth.sentCodeTypeFragmentSms#d9565c39 url:string length:int = auth.SentCodeType; messages.botCallbackAnswer#36585ea4 flags:# alert:flags.1?true has_url:flags.3?true native_ui:flags.4?true message:flags.0?string url:flags.2?string cache_time:int = messages.BotCallbackAnswer; messages.messageEditData#26b5dde6 flags:# caption:flags.0?true = messages.MessageEditData; inputBotInlineMessageID#890c3d89 dc_id:int id:long access_hash:long = InputBotInlineMessageID; inputBotInlineMessageID64#b6d915d7 dc_id:int owner_id:long id:int access_hash:long = InputBotInlineMessageID; inlineBotSwitchPM#3c20629f text:string start_param:string = InlineBotSwitchPM; messages.peerDialogs#3371c354 dialogs:Vector<Dialog> messages:Vector<Message> chats:Vector<Chat> users:Vector<User> state:updates.State = messages.PeerDialogs; topPeer#edcdc05b peer:Peer rating:double = TopPeer; topPeerCategoryBotsPM#ab661b5b = TopPeerCategory; topPeerCategoryBotsInline#148677e2 = TopPeerCategory; topPeerCategoryCorrespondents#637b7ed = TopPeerCategory; topPeerCategoryGroups#bd17a14a = TopPeerCategory; topPeerCategoryChannels#161d9628 = TopPeerCategory; topPeerCategoryPhoneCalls#1e76a78c = TopPeerCategory; topPeerCategoryForwardUsers#a8406ca9 = TopPeerCategory; topPeerCategoryForwardChats#fbeec0f0 = TopPeerCategory; topPeerCategoryPeers#fb834291 category:TopPeerCategory count:int peers:Vector<TopPeer> = TopPeerCategoryPeers; contacts.topPeersNotModified#de266ef5 = contacts.TopPeers; contacts.topPeers#70b772a8 categories:Vector<TopPeerCategoryPeers> chats:Vector<Chat> users:Vector<User> = contacts.TopPeers; contacts.topPeersDisabled#b52c939d = contacts.TopPeers; draftMessageEmpty#1b0c841a flags:# date:flags.0?int = DraftMessage; draftMessage#fd8e711f flags:# no_webpage:flags.1?true reply_to_msg_id:flags.0?int message:string entities:flags.3?Vector<MessageEntity> date:int = DraftMessage; messages.featuredStickersNotModified#c6dc0c66 count:int = messages.FeaturedStickers; messages.featuredStickers#be382906 flags:# premium:flags.0?true hash:long count:int sets:Vector<StickerSetCovered> unread:Vector<long> = messages.FeaturedStickers; messages.recentStickersNotModified#b17f890 = messages.RecentStickers; messages.recentStickers#88d37c56 hash:long packs:Vector<StickerPack> stickers:Vector<Document> dates:Vector<int> = messages.RecentStickers; messages.archivedStickers#4fcba9c8 count:int sets:Vector<StickerSetCovered> = messages.ArchivedStickers; messages.stickerSetInstallResultSuccess#38641628 = messages.StickerSetInstallResult; messages.stickerSetInstallResultArchive#35e410a8 sets:Vector<StickerSetCovered> = messages.StickerSetInstallResult; stickerSetCovered#6410a5d2 set:StickerSet cover:Document = StickerSetCovered; stickerSetMultiCovered#3407e51b set:StickerSet covers:Vector<Document> = StickerSetCovered; stickerSetFullCovered#40d13c0e set:StickerSet packs:Vector<StickerPack> keywords:Vector<StickerKeyword> documents:Vector<Document> = StickerSetCovered; stickerSetNoCovered#77b15d1c set:StickerSet = StickerSetCovered; maskCoords#aed6dbb2 n:int x:double y:double zoom:double = MaskCoords; inputStickeredMediaPhoto#4a992157 id:InputPhoto = InputStickeredMedia; inputStickeredMediaDocument#438865b id:InputDocument = InputStickeredMedia; game#bdf9653b flags:# id:long access_hash:long short_name:string title:string description:string photo:Photo document:flags.0?Document = Game; inputGameID#32c3e77 id:long access_hash:long = InputGame; inputGameShortName#c331e80a bot_id:InputUser short_name:string = InputGame; highScore#73a379eb pos:int user_id:long score:int = HighScore; messages.highScores#9a3bfd99 scores:Vector<HighScore> users:Vector<User> = messages.HighScores; textEmpty#dc3d824f = RichText; textPlain#744694e0 text:string = RichText; textBold#6724abc4 text:RichText = RichText; textItalic#d912a59c text:RichText = RichText; textUnderline#c12622c4 text:RichText = RichText; textStrike#9bf8bb95 text:RichText = RichText; textFixed#6c3f19b9 text:RichText = RichText; textUrl#3c2884c1 text:RichText url:string webpage_id:long = RichText; textEmail#de5a0dd6 text:RichText email:string = RichText; textConcat#7e6260d7 texts:Vector<RichText> = RichText; textSubscript#ed6a8504 text:RichText = RichText; textSuperscript#c7fb5e01 text:RichText = RichText; textMarked#34b8621 text:RichText = RichText; textPhone#1ccb966a text:RichText phone:string = RichText; textImage#81ccf4f document_id:long w:int h:int = RichText; textAnchor#35553762 text:RichText name:string = RichText; pageBlockUnsupported#13567e8a = PageBlock; pageBlockTitle#70abc3fd text:RichText = PageBlock; pageBlockSubtitle#8ffa9a1f text:RichText = PageBlock; pageBlockAuthorDate#baafe5e0 author:RichText published_date:int = PageBlock; pageBlockHeader#bfd064ec text:RichText = PageBlock; pageBlockSubheader#f12bb6e1 text:RichText = PageBlock; pageBlockParagraph#467a0766 text:RichText = PageBlock; pageBlockPreformatted#c070d93e text:RichText language:string = PageBlock; pageBlockFooter#48870999 text:RichText = PageBlock; pageBlockDivider#db20b188 = PageBlock; pageBlockAnchor#ce0d37b0 name:string = PageBlock; pageBlockList#e4e88011 items:Vector<PageListItem> = PageBlock; pageBlockBlockquote#263d7c26 text:RichText caption:RichText = PageBlock; pageBlockPullquote#4f4456d3 text:RichText caption:RichText = PageBlock; pageBlockPhoto#1759c560 flags:# photo_id:long caption:PageCaption url:flags.0?string webpage_id:flags.0?long = PageBlock; pageBlockVideo#7c8fe7b6 flags:# autoplay:flags.0?true loop:flags.1?true video_id:long caption:PageCaption = PageBlock; pageBlockCover#39f23300 cover:PageBlock = PageBlock; pageBlockEmbed#a8718dc5 flags:# full_width:flags.0?true allow_scrolling:flags.3?true url:flags.1?string html:flags.2?string poster_photo_id:flags.4?long w:flags.5?int h:flags.5?int caption:PageCaption = PageBlock; pageBlockEmbedPost#f259a80b url:string webpage_id:long author_photo_id:long author:string date:int blocks:Vector<PageBlock> caption:PageCaption = PageBlock; pageBlockCollage#65a0fa4d items:Vector<PageBlock> caption:PageCaption = PageBlock; pageBlockSlideshow#31f9590 items:Vector<PageBlock> caption:PageCaption = PageBlock; pageBlockChannel#ef1751b5 channel:Chat = PageBlock; pageBlockAudio#804361ea audio_id:long caption:PageCaption = PageBlock; pageBlockKicker#1e148390 text:RichText = PageBlock; pageBlockTable#bf4dea82 flags:# bordered:flags.0?true striped:flags.1?true title:RichText rows:Vector<PageTableRow> = PageBlock; pageBlockOrderedList#9a8ae1e1 items:Vector<PageListOrderedItem> = PageBlock; pageBlockDetails#76768bed flags:# open:flags.0?true blocks:Vector<PageBlock> title:RichText = PageBlock; pageBlockRelatedArticles#16115a96 title:RichText articles:Vector<PageRelatedArticle> = PageBlock; pageBlockMap#a44f3ef6 geo:GeoPoint zoom:int w:int h:int caption:PageCaption = PageBlock; phoneCallDiscardReasonMissed#85e42301 = PhoneCallDiscardReason; phoneCallDiscardReasonDisconnect#e095c1a0 = PhoneCallDiscardReason; phoneCallDiscardReasonHangup#57adc690 = PhoneCallDiscardReason; phoneCallDiscardReasonBusy#faf7e8c9 = PhoneCallDiscardReason; dataJSON#7d748d04 data:string = DataJSON; labeledPrice#cb296bf8 label:string amount:long = LabeledPrice; invoice#3e85a91b flags:# test:flags.0?true name_requested:flags.1?true phone_requested:flags.2?true email_requested:flags.3?true shipping_address_requested:flags.4?true flexible:flags.5?true phone_to_provider:flags.6?true email_to_provider:flags.7?true recurring:flags.9?true currency:string prices:Vector<LabeledPrice> max_tip_amount:flags.8?long suggested_tip_amounts:flags.8?Vector<long> recurring_terms_url:flags.9?string = Invoice; paymentCharge#ea02c27e id:string provider_charge_id:string = PaymentCharge; postAddress#1e8caaeb street_line1:string street_line2:string city:string state:string country_iso2:string post_code:string = PostAddress; paymentRequestedInfo#909c3f94 flags:# name:flags.0?string phone:flags.1?string email:flags.2?string shipping_address:flags.3?PostAddress = PaymentRequestedInfo; paymentSavedCredentialsCard#cdc27a1f id:string title:string = PaymentSavedCredentials; webDocument#1c570ed1 url:string access_hash:long size:int mime_type:string attributes:Vector<DocumentAttribute> = WebDocument; webDocumentNoProxy#f9c8bcc6 url:string size:int mime_type:string attributes:Vector<DocumentAttribute> = WebDocument; inputWebDocument#9bed434d url:string size:int mime_type:string attributes:Vector<DocumentAttribute> = InputWebDocument; inputWebFileLocation#c239d686 url:string access_hash:long = InputWebFileLocation; inputWebFileGeoPointLocation#9f2221c9 geo_point:InputGeoPoint access_hash:long w:int h:int zoom:int scale:int = InputWebFileLocation; inputWebFileAudioAlbumThumbLocation#f46fe924 flags:# small:flags.2?true document:flags.0?InputDocument title:flags.1?string performer:flags.1?string = InputWebFileLocation; upload.webFile#21e753bc size:int mime_type:string file_type:storage.FileType mtime:int bytes:bytes = upload.WebFile; payments.paymentForm#a0058751 flags:# can_save_credentials:flags.2?true password_missing:flags.3?true form_id:long bot_id:long title:string description:string photo:flags.5?WebDocument invoice:Invoice provider_id:long url:string native_provider:flags.4?string native_params:flags.4?DataJSON additional_methods:flags.6?Vector<PaymentFormMethod> saved_info:flags.0?PaymentRequestedInfo saved_credentials:flags.1?Vector<PaymentSavedCredentials> users:Vector<User> = payments.PaymentForm; payments.validatedRequestedInfo#d1451883 flags:# id:flags.0?string shipping_options:flags.1?Vector<ShippingOption> = payments.ValidatedRequestedInfo; payments.paymentResult#4e5f810d updates:Updates = payments.PaymentResult; payments.paymentVerificationNeeded#d8411139 url:string = payments.PaymentResult; payments.paymentReceipt#70c4fe03 flags:# date:int bot_id:long provider_id:long title:string description:string photo:flags.2?WebDocument invoice:Invoice info:flags.0?PaymentRequestedInfo shipping:flags.1?ShippingOption tip_amount:flags.3?long currency:string total_amount:long credentials_title:string users:Vector<User> = payments.PaymentReceipt; payments.savedInfo#fb8fe43c flags:# has_saved_credentials:flags.1?true saved_info:flags.0?PaymentRequestedInfo = payments.SavedInfo; inputPaymentCredentialsSaved#c10eb2cf id:string tmp_password:bytes = InputPaymentCredentials; inputPaymentCredentials#3417d728 flags:# save:flags.0?true data:DataJSON = InputPaymentCredentials; inputPaymentCredentialsApplePay#aa1c39f payment_data:DataJSON = InputPaymentCredentials; inputPaymentCredentialsGooglePay#8ac32801 payment_token:DataJSON = InputPaymentCredentials; account.tmpPassword#db64fd34 tmp_password:bytes valid_until:int = account.TmpPassword; shippingOption#b6213cdf id:string title:string prices:Vector<LabeledPrice> = ShippingOption; inputStickerSetItem#ffa0a496 flags:# document:InputDocument emoji:string mask_coords:flags.0?MaskCoords = InputStickerSetItem; inputPhoneCall#1e36fded id:long access_hash:long = InputPhoneCall; phoneCallEmpty#5366c915 id:long = PhoneCall; phoneCallWaiting#c5226f17 flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long protocol:PhoneCallProtocol receive_date:flags.0?int = PhoneCall; phoneCallRequested#14b0ed0c flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long g_a_hash:bytes protocol:PhoneCallProtocol = PhoneCall; phoneCallAccepted#3660c311 flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long g_b:bytes protocol:PhoneCallProtocol = PhoneCall; phoneCall#967f7c67 flags:# p2p_allowed:flags.5?true video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long g_a_or_b:bytes key_fingerprint:long protocol:PhoneCallProtocol connections:Vector<PhoneConnection> start_date:int = PhoneCall; phoneCallDiscarded#50ca4de1 flags:# need_rating:flags.2?true need_debug:flags.3?true video:flags.6?true id:long reason:flags.0?PhoneCallDiscardReason duration:flags.1?int = PhoneCall; phoneConnection#9cc123c7 flags:# tcp:flags.0?true id:long ip:string ipv6:string port:int peer_tag:bytes = PhoneConnection; phoneConnectionWebrtc#635fe375 flags:# turn:flags.0?true stun:flags.1?true id:long ip:string ipv6:string port:int username:string password:string = PhoneConnection; phoneCallProtocol#fc878fc8 flags:# udp_p2p:flags.0?true udp_reflector:flags.1?true min_layer:int max_layer:int library_versions:Vector<string> = PhoneCallProtocol; phone.phoneCall#ec82e140 phone_call:PhoneCall users:Vector<User> = phone.PhoneCall; upload.cdnFileReuploadNeeded#eea8e46e request_token:bytes = upload.CdnFile; upload.cdnFile#a99fca4f bytes:bytes = upload.CdnFile; cdnPublicKey#c982eaba dc_id:int public_key:string = CdnPublicKey; cdnConfig#5725e40a public_keys:Vector<CdnPublicKey> = CdnConfig; langPackString#cad181f6 key:string value:string = LangPackString; langPackStringPluralized#6c47ac9f flags:# key:string zero_value:flags.0?string one_value:flags.1?string two_value:flags.2?string few_value:flags.3?string many_value:flags.4?string other_value:string = LangPackString; langPackStringDeleted#2979eeb2 key:string = LangPackString; langPackDifference#f385c1f6 lang_code:string from_version:int version:int strings:Vector<LangPackString> = LangPackDifference; langPackLanguage#eeca5ce3 flags:# official:flags.0?true rtl:flags.2?true beta:flags.3?true name:string native_name:string lang_code:string base_lang_code:flags.1?string plural_code:string strings_count:int translated_count:int translations_url:string = LangPackLanguage; channelAdminLogEventActionChangeTitle#e6dfb825 prev_value:string new_value:string = ChannelAdminLogEventAction; channelAdminLogEventActionChangeAbout#55188a2e prev_value:string new_value:string = ChannelAdminLogEventAction; channelAdminLogEventActionChangeUsername#6a4afc38 prev_value:string new_value:string = ChannelAdminLogEventAction; channelAdminLogEventActionChangePhoto#434bd2af prev_photo:Photo new_photo:Photo = ChannelAdminLogEventAction; channelAdminLogEventActionToggleInvites#1b7907ae new_value:Bool = ChannelAdminLogEventAction; channelAdminLogEventActionToggleSignatures#26ae0971 new_value:Bool = ChannelAdminLogEventAction; channelAdminLogEventActionUpdatePinned#e9e82c18 message:Message = ChannelAdminLogEventAction; channelAdminLogEventActionEditMessage#709b2405 prev_message:Message new_message:Message = ChannelAdminLogEventAction; channelAdminLogEventActionDeleteMessage#42e047bb message:Message = ChannelAdminLogEventAction; channelAdminLogEventActionParticipantJoin#183040d3 = ChannelAdminLogEventAction; channelAdminLogEventActionParticipantLeave#f89777f2 = ChannelAdminLogEventAction; channelAdminLogEventActionParticipantInvite#e31c34d8 participant:ChannelParticipant = ChannelAdminLogEventAction; channelAdminLogEventActionParticipantToggleBan#e6d83d7e prev_participant:ChannelParticipant new_participant:ChannelParticipant = ChannelAdminLogEventAction; channelAdminLogEventActionParticipantToggleAdmin#d5676710 prev_participant:ChannelParticipant new_participant:ChannelParticipant = ChannelAdminLogEventAction; channelAdminLogEventActionChangeStickerSet#b1c3caa7 prev_stickerset:InputStickerSet new_stickerset:InputStickerSet = ChannelAdminLogEventAction; channelAdminLogEventActionTogglePreHistoryHidden#5f5c95f1 new_value:Bool = ChannelAdminLogEventAction; channelAdminLogEventActionDefaultBannedRights#2df5fc0a prev_banned_rights:ChatBannedRights new_banned_rights:ChatBannedRights = ChannelAdminLogEventAction; channelAdminLogEventActionStopPoll#8f079643 message:Message = ChannelAdminLogEventAction; channelAdminLogEventActionChangeLinkedChat#50c7ac8 prev_value:long new_value:long = ChannelAdminLogEventAction; channelAdminLogEventActionChangeLocation#e6b76ae prev_value:ChannelLocation new_value:ChannelLocation = ChannelAdminLogEventAction; channelAdminLogEventActionToggleSlowMode#53909779 prev_value:int new_value:int = ChannelAdminLogEventAction; channelAdminLogEventActionStartGroupCall#23209745 call:InputGroupCall = ChannelAdminLogEventAction; channelAdminLogEventActionDiscardGroupCall#db9f9140 call:InputGroupCall = ChannelAdminLogEventAction; channelAdminLogEventActionParticipantMute#f92424d2 participant:GroupCallParticipant = ChannelAdminLogEventAction; channelAdminLogEventActionParticipantUnmute#e64429c0 participant:GroupCallParticipant = ChannelAdminLogEventAction; channelAdminLogEventActionToggleGroupCallSetting#56d6a247 join_muted:Bool = ChannelAdminLogEventAction; channelAdminLogEventActionParticipantJoinByInvite#5cdada77 invite:ExportedChatInvite = ChannelAdminLogEventAction; channelAdminLogEventActionExportedInviteDelete#5a50fca4 invite:ExportedChatInvite = ChannelAdminLogEventAction; channelAdminLogEventActionExportedInviteRevoke#410a134e invite:ExportedChatInvite = ChannelAdminLogEventAction; channelAdminLogEventActionExportedInviteEdit#e90ebb59 prev_invite:ExportedChatInvite new_invite:ExportedChatInvite = ChannelAdminLogEventAction; channelAdminLogEventActionParticipantVolume#3e7f6847 participant:GroupCallParticipant = ChannelAdminLogEventAction; channelAdminLogEventActionChangeHistoryTTL#6e941a38 prev_value:int new_value:int = ChannelAdminLogEventAction; channelAdminLogEventActionParticipantJoinByRequest#afb6144a invite:ExportedChatInvite approved_by:long = ChannelAdminLogEventAction; channelAdminLogEventActionToggleNoForwards#cb2ac766 new_value:Bool = ChannelAdminLogEventAction; channelAdminLogEventActionSendMessage#278f2868 message:Message = ChannelAdminLogEventAction; channelAdminLogEventActionChangeAvailableReactions#be4e0ef8 prev_value:ChatReactions new_value:ChatReactions = ChannelAdminLogEventAction; channelAdminLogEventActionChangeUsernames#f04fb3a9 prev_value:Vector<string> new_value:Vector<string> = ChannelAdminLogEventAction; channelAdminLogEventActionToggleForum#2cc6383 new_value:Bool = ChannelAdminLogEventAction; channelAdminLogEventActionCreateTopic#58707d28 topic:ForumTopic = ChannelAdminLogEventAction; channelAdminLogEventActionEditTopic#f06fe208 prev_topic:ForumTopic new_topic:ForumTopic = ChannelAdminLogEventAction; channelAdminLogEventActionDeleteTopic#ae168909 topic:ForumTopic = ChannelAdminLogEventAction; channelAdminLogEventActionPinTopic#5d8d353b flags:# prev_topic:flags.0?ForumTopic new_topic:flags.1?ForumTopic = ChannelAdminLogEventAction; channelAdminLogEventActionToggleAntiSpam#64f36dfc new_value:Bool = ChannelAdminLogEventAction; channelAdminLogEvent#1fad68cd id:long date:int user_id:long action:ChannelAdminLogEventAction = ChannelAdminLogEvent; channels.adminLogResults#ed8af74d events:Vector<ChannelAdminLogEvent> chats:Vector<Chat> users:Vector<User> = channels.AdminLogResults; channelAdminLogEventsFilter#ea107ae4 flags:# join:flags.0?true leave:flags.1?true invite:flags.2?true ban:flags.3?true unban:flags.4?true kick:flags.5?true unkick:flags.6?true promote:flags.7?true demote:flags.8?true info:flags.9?true settings:flags.10?true pinned:flags.11?true edit:flags.12?true delete:flags.13?true group_call:flags.14?true invites:flags.15?true send:flags.16?true forums:flags.17?true = ChannelAdminLogEventsFilter; popularContact#5ce14175 client_id:long importers:int = PopularContact; messages.favedStickersNotModified#9e8fa6d3 = messages.FavedStickers; messages.favedStickers#2cb51097 hash:long packs:Vector<StickerPack> stickers:Vector<Document> = messages.FavedStickers; recentMeUrlUnknown#46e1d13d url:string = RecentMeUrl; recentMeUrlUser#b92c09e2 url:string user_id:long = RecentMeUrl; recentMeUrlChat#b2da71d2 url:string chat_id:long = RecentMeUrl; recentMeUrlChatInvite#eb49081d url:string chat_invite:ChatInvite = RecentMeUrl; recentMeUrlStickerSet#bc0a57dc url:string set:StickerSetCovered = RecentMeUrl; help.recentMeUrls#e0310d7 urls:Vector<RecentMeUrl> chats:Vector<Chat> users:Vector<User> = help.RecentMeUrls; inputSingleMedia#1cc6e91f flags:# media:InputMedia random_id:long message:string entities:flags.0?Vector<MessageEntity> = InputSingleMedia; webAuthorization#a6f8f452 hash:long bot_id:long domain:string browser:string platform:string date_created:int date_active:int ip:string region:string = WebAuthorization; account.webAuthorizations#ed56c9fc authorizations:Vector<WebAuthorization> users:Vector<User> = account.WebAuthorizations; inputMessageID#a676a322 id:int = InputMessage; inputMessageReplyTo#bad88395 id:int = InputMessage; inputMessagePinned#86872538 = InputMessage; inputMessageCallbackQuery#acfa1a7e id:int query_id:long = InputMessage; inputDialogPeer#fcaafeb7 peer:InputPeer = InputDialogPeer; inputDialogPeerFolder#64600527 folder_id:int = InputDialogPeer; dialogPeer#e56dbf05 peer:Peer = DialogPeer; dialogPeerFolder#514519e2 folder_id:int = DialogPeer; messages.foundStickerSetsNotModified#d54b65d = messages.FoundStickerSets; messages.foundStickerSets#8af09dd2 hash:long sets:Vector<StickerSetCovered> = messages.FoundStickerSets; fileHash#f39b035c offset:long limit:int hash:bytes = FileHash; inputClientProxy#75588b3f address:string port:int = InputClientProxy; help.termsOfServiceUpdateEmpty#e3309f7f expires:int = help.TermsOfServiceUpdate; help.termsOfServiceUpdate#28ecf961 expires:int terms_of_service:help.TermsOfService = help.TermsOfServiceUpdate; inputSecureFileUploaded#3334b0f0 id:long parts:int md5_checksum:string file_hash:bytes secret:bytes = InputSecureFile; inputSecureFile#5367e5be id:long access_hash:long = InputSecureFile; secureFileEmpty#64199744 = SecureFile; secureFile#7d09c27e id:long access_hash:long size:long dc_id:int date:int file_hash:bytes secret:bytes = SecureFile; secureData#8aeabec3 data:bytes data_hash:bytes secret:bytes = SecureData; securePlainPhone#7d6099dd phone:string = SecurePlainData; securePlainEmail#21ec5a5f email:string = SecurePlainData; secureValueTypePersonalDetails#9d2a81e3 = SecureValueType; secureValueTypePassport#3dac6a00 = SecureValueType; secureValueTypeDriverLicense#6e425c4 = SecureValueType; secureValueTypeIdentityCard#a0d0744b = SecureValueType; secureValueTypeInternalPassport#99a48f23 = SecureValueType; secureValueTypeAddress#cbe31e26 = SecureValueType; secureValueTypeUtilityBill#fc36954e = SecureValueType; secureValueTypeBankStatement#89137c0d = SecureValueType; secureValueTypeRentalAgreement#8b883488 = SecureValueType; secureValueTypePassportRegistration#99e3806a = SecureValueType; secureValueTypeTemporaryRegistration#ea02ec33 = SecureValueType; secureValueTypePhone#b320aadb = SecureValueType; secureValueTypeEmail#8e3ca7ee = SecureValueType; secureValue#187fa0ca flags:# type:SecureValueType data:flags.0?SecureData front_side:flags.1?SecureFile reverse_side:flags.2?SecureFile selfie:flags.3?SecureFile translation:flags.6?Vector<SecureFile> files:flags.4?Vector<SecureFile> plain_data:flags.5?SecurePlainData hash:bytes = SecureValue; inputSecureValue#db21d0a7 flags:# type:SecureValueType data:flags.0?SecureData front_side:flags.1?InputSecureFile reverse_side:flags.2?InputSecureFile selfie:flags.3?InputSecureFile translation:flags.6?Vector<InputSecureFile> files:flags.4?Vector<InputSecureFile> plain_data:flags.5?SecurePlainData = InputSecureValue; secureValueHash#ed1ecdb0 type:SecureValueType hash:bytes = SecureValueHash; secureValueErrorData#e8a40bd9 type:SecureValueType data_hash:bytes field:string text:string = SecureValueError; secureValueErrorFrontSide#be3dfa type:SecureValueType file_hash:bytes text:string = SecureValueError; secureValueErrorReverseSide#868a2aa5 type:SecureValueType file_hash:bytes text:string = SecureValueError; secureValueErrorSelfie#e537ced6 type:SecureValueType file_hash:bytes text:string = SecureValueError; secureValueErrorFile#7a700873 type:SecureValueType file_hash:bytes text:string = SecureValueError; secureValueErrorFiles#666220e9 type:SecureValueType file_hash:Vector<bytes> text:string = SecureValueError; secureValueError#869d758f type:SecureValueType hash:bytes text:string = SecureValueError; secureValueErrorTranslationFile#a1144770 type:SecureValueType file_hash:bytes text:string = SecureValueError; secureValueErrorTranslationFiles#34636dd8 type:SecureValueType file_hash:Vector<bytes> text:string = SecureValueError; secureCredentialsEncrypted#33f0ea47 data:bytes hash:bytes secret:bytes = SecureCredentialsEncrypted; account.authorizationForm#ad2e1cd8 flags:# required_types:Vector<SecureRequiredType> values:Vector<SecureValue> errors:Vector<SecureValueError> users:Vector<User> privacy_policy_url:flags.0?string = account.AuthorizationForm; account.sentEmailCode#811f854f email_pattern:string length:int = account.SentEmailCode; help.deepLinkInfoEmpty#66afa166 = help.DeepLinkInfo; help.deepLinkInfo#6a4ee832 flags:# update_app:flags.0?true message:string entities:flags.1?Vector<MessageEntity> = help.DeepLinkInfo; savedPhoneContact#1142bd56 phone:string first_name:string last_name:string date:int = SavedContact; account.takeout#4dba4501 id:long = account.Takeout; passwordKdfAlgoUnknown#d45ab096 = PasswordKdfAlgo; passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow#3a912d4a salt1:bytes salt2:bytes g:int p:bytes = PasswordKdfAlgo; securePasswordKdfAlgoUnknown#4a8537 = SecurePasswordKdfAlgo; securePasswordKdfAlgoPBKDF2HMACSHA512iter100000#bbf2dda0 salt:bytes = SecurePasswordKdfAlgo; securePasswordKdfAlgoSHA512#86471d92 salt:bytes = SecurePasswordKdfAlgo; secureSecretSettings#1527bcac secure_algo:SecurePasswordKdfAlgo secure_secret:bytes secure_secret_id:long = SecureSecretSettings; inputCheckPasswordEmpty#9880f658 = InputCheckPasswordSRP; inputCheckPasswordSRP#d27ff082 srp_id:long A:bytes M1:bytes = InputCheckPasswordSRP; secureRequiredType#829d99da flags:# native_names:flags.0?true selfie_required:flags.1?true translation_required:flags.2?true type:SecureValueType = SecureRequiredType; secureRequiredTypeOneOf#27477b4 types:Vector<SecureRequiredType> = SecureRequiredType; help.passportConfigNotModified#bfb9f457 = help.PassportConfig; help.passportConfig#a098d6af hash:int countries_langs:DataJSON = help.PassportConfig; inputAppEvent#1d1b1245 time:double type:string peer:long data:JSONValue = InputAppEvent; jsonObjectValue#c0de1bd9 key:string value:JSONValue = JSONObjectValue; jsonNull#3f6d7b68 = JSONValue; jsonBool#c7345e6a value:Bool = JSONValue; jsonNumber#2be0dfa4 value:double = JSONValue; jsonString#b71e767a value:string = JSONValue; jsonArray#f7444763 value:Vector<JSONValue> = JSONValue; jsonObject#99c1d49d value:Vector<JSONObjectValue> = JSONValue; pageTableCell#34566b6a flags:# header:flags.0?true align_center:flags.3?true align_right:flags.4?true valign_middle:flags.5?true valign_bottom:flags.6?true text:flags.7?RichText colspan:flags.1?int rowspan:flags.2?int = PageTableCell; pageTableRow#e0c0c5e5 cells:Vector<PageTableCell> = PageTableRow; pageCaption#6f747657 text:RichText credit:RichText = PageCaption; pageListItemText#b92fb6cd text:RichText = PageListItem; pageListItemBlocks#25e073fc blocks:Vector<PageBlock> = PageListItem; pageListOrderedItemText#5e068047 num:string text:RichText = PageListOrderedItem; pageListOrderedItemBlocks#98dd8936 num:string blocks:Vector<PageBlock> = PageListOrderedItem; pageRelatedArticle#b390dc08 flags:# url:string webpage_id:long title:flags.0?string description:flags.1?string photo_id:flags.2?long author:flags.3?string published_date:flags.4?int = PageRelatedArticle; page#98657f0d flags:# part:flags.0?true rtl:flags.1?true v2:flags.2?true url:string blocks:Vector<PageBlock> photos:Vector<Photo> documents:Vector<Document> views:flags.3?int = Page; help.supportName#8c05f1c9 name:string = help.SupportName; help.userInfoEmpty#f3ae2eed = help.UserInfo; help.userInfo#1eb3758 message:string entities:Vector<MessageEntity> author:string date:int = help.UserInfo; pollAnswer#6ca9c2e9 text:string option:bytes = PollAnswer; poll#86e18161 id:long flags:# closed:flags.0?true public_voters:flags.1?true multiple_choice:flags.2?true quiz:flags.3?true question:string answers:Vector<PollAnswer> close_period:flags.4?int close_date:flags.5?int = Poll; pollAnswerVoters#3b6ddad2 flags:# chosen:flags.0?true correct:flags.1?true option:bytes voters:int = PollAnswerVoters; pollResults#dcb82ea3 flags:# min:flags.0?true results:flags.1?Vector<PollAnswerVoters> total_voters:flags.2?int recent_voters:flags.3?Vector<long> solution:flags.4?string solution_entities:flags.4?Vector<MessageEntity> = PollResults; chatOnlines#f041e250 onlines:int = ChatOnlines; statsURL#47a971e0 url:string = StatsURL; chatAdminRights#5fb224d5 flags:# change_info:flags.0?true post_messages:flags.1?true edit_messages:flags.2?true delete_messages:flags.3?true ban_users:flags.4?true invite_users:flags.5?true pin_messages:flags.7?true add_admins:flags.9?true anonymous:flags.10?true manage_call:flags.11?true other:flags.12?true manage_topics:flags.13?true = ChatAdminRights; chatBannedRights#9f120418 flags:# view_messages:flags.0?true send_messages:flags.1?true send_media:flags.2?true send_stickers:flags.3?true send_gifs:flags.4?true send_games:flags.5?true send_inline:flags.6?true embed_links:flags.7?true send_polls:flags.8?true change_info:flags.10?true invite_users:flags.15?true pin_messages:flags.17?true manage_topics:flags.18?true until_date:int = ChatBannedRights; inputWallPaper#e630b979 id:long access_hash:long = InputWallPaper; inputWallPaperSlug#72091c80 slug:string = InputWallPaper; inputWallPaperNoFile#967a462e id:long = InputWallPaper; account.wallPapersNotModified#1c199183 = account.WallPapers; account.wallPapers#cdc3858c hash:long wallpapers:Vector<WallPaper> = account.WallPapers; codeSettings#8a6469c2 flags:# allow_flashcall:flags.0?true current_number:flags.1?true allow_app_hash:flags.4?true allow_missed_call:flags.5?true logout_tokens:flags.6?Vector<bytes> = CodeSettings; wallPaperSettings#1dc1bca4 flags:# blur:flags.1?true motion:flags.2?true background_color:flags.0?int second_background_color:flags.4?int third_background_color:flags.5?int fourth_background_color:flags.6?int intensity:flags.3?int rotation:flags.4?int = WallPaperSettings; autoDownloadSettings#8efab953 flags:# disabled:flags.0?true video_preload_large:flags.1?true audio_preload_next:flags.2?true phonecalls_less_data:flags.3?true photo_size_max:int video_size_max:long file_size_max:long video_upload_maxbitrate:int = AutoDownloadSettings; account.autoDownloadSettings#63cacf26 low:AutoDownloadSettings medium:AutoDownloadSettings high:AutoDownloadSettings = account.AutoDownloadSettings; emojiKeyword#d5b3b9f9 keyword:string emoticons:Vector<string> = EmojiKeyword; emojiKeywordDeleted#236df622 keyword:string emoticons:Vector<string> = EmojiKeyword; emojiKeywordsDifference#5cc761bd lang_code:string from_version:int version:int keywords:Vector<EmojiKeyword> = EmojiKeywordsDifference; emojiURL#a575739d url:string = EmojiURL; emojiLanguage#b3fb5361 lang_code:string = EmojiLanguage; folder#ff544e65 flags:# autofill_new_broadcasts:flags.0?true autofill_public_groups:flags.1?true autofill_new_correspondents:flags.2?true id:int title:string photo:flags.3?ChatPhoto = Folder; inputFolderPeer#fbd2c296 peer:InputPeer folder_id:int = InputFolderPeer; folderPeer#e9baa668 peer:Peer folder_id:int = FolderPeer; messages.searchCounter#e844ebff flags:# inexact:flags.1?true filter:MessagesFilter count:int = messages.SearchCounter; urlAuthResultRequest#92d33a0e flags:# request_write_access:flags.0?true bot:User domain:string = UrlAuthResult; urlAuthResultAccepted#8f8c0e4e url:string = UrlAuthResult; urlAuthResultDefault#a9d6db1f = UrlAuthResult; channelLocationEmpty#bfb5ad8b = ChannelLocation; channelLocation#209b82db geo_point:GeoPoint address:string = ChannelLocation; peerLocated#ca461b5d peer:Peer expires:int distance:int = PeerLocated; peerSelfLocated#f8ec284b expires:int = PeerLocated; restrictionReason#d072acb4 platform:string reason:string text:string = RestrictionReason; inputTheme#3c5693e9 id:long access_hash:long = InputTheme; inputThemeSlug#f5890df1 slug:string = InputTheme; theme#a00e67d6 flags:# creator:flags.0?true default:flags.1?true for_chat:flags.5?true id:long access_hash:long slug:string title:string document:flags.2?Document settings:flags.3?Vector<ThemeSettings> emoticon:flags.6?string installs_count:flags.4?int = Theme; account.themesNotModified#f41eb622 = account.Themes; account.themes#9a3d8c6d hash:long themes:Vector<Theme> = account.Themes; auth.loginToken#629f1980 expires:int token:bytes = auth.LoginToken; auth.loginTokenMigrateTo#68e9916 dc_id:int token:bytes = auth.LoginToken; auth.loginTokenSuccess#390d5c5e authorization:auth.Authorization = auth.LoginToken; account.contentSettings#57e28221 flags:# sensitive_enabled:flags.0?true sensitive_can_change:flags.1?true = account.ContentSettings; messages.inactiveChats#a927fec5 dates:Vector<int> chats:Vector<Chat> users:Vector<User> = messages.InactiveChats; baseThemeClassic#c3a12462 = BaseTheme; baseThemeDay#fbd81688 = BaseTheme; baseThemeNight#b7b31ea8 = BaseTheme; baseThemeTinted#6d5f77ee = BaseTheme; baseThemeArctic#5b11125a = BaseTheme; inputThemeSettings#8fde504f flags:# message_colors_animated:flags.2?true base_theme:BaseTheme accent_color:int outbox_accent_color:flags.3?int message_colors:flags.0?Vector<int> wallpaper:flags.1?InputWallPaper wallpaper_settings:flags.1?WallPaperSettings = InputThemeSettings; themeSettings#fa58b6d4 flags:# message_colors_animated:flags.2?true base_theme:BaseTheme accent_color:int outbox_accent_color:flags.3?int message_colors:flags.0?Vector<int> wallpaper:flags.1?WallPaper = ThemeSettings; webPageAttributeTheme#54b56617 flags:# documents:flags.0?Vector<Document> settings:flags.1?ThemeSettings = WebPageAttribute; messageUserVote#34d247b4 user_id:long option:bytes date:int = MessageUserVote; messageUserVoteInputOption#3ca5b0ec user_id:long date:int = MessageUserVote; messageUserVoteMultiple#8a65e557 user_id:long options:Vector<bytes> date:int = MessageUserVote; messages.votesList#823f649 flags:# count:int votes:Vector<MessageUserVote> users:Vector<User> next_offset:flags.0?string = messages.VotesList; bankCardOpenUrl#f568028a url:string name:string = BankCardOpenUrl; payments.bankCardData#3e24e573 title:string open_urls:Vector<BankCardOpenUrl> = payments.BankCardData; dialogFilter#7438f7e8 flags:# contacts:flags.0?true non_contacts:flags.1?true groups:flags.2?true broadcasts:flags.3?true bots:flags.4?true exclude_muted:flags.11?true exclude_read:flags.12?true exclude_archived:flags.13?true id:int title:string emoticon:flags.25?string pinned_peers:Vector<InputPeer> include_peers:Vector<InputPeer> exclude_peers:Vector<InputPeer> = DialogFilter; dialogFilterDefault#363293ae = DialogFilter; dialogFilterSuggested#77744d4a filter:DialogFilter description:string = DialogFilterSuggested; statsDateRangeDays#b637edaf min_date:int max_date:int = StatsDateRangeDays; statsAbsValueAndPrev#cb43acde current:double previous:double = StatsAbsValueAndPrev; statsPercentValue#cbce2fe0 part:double total:double = StatsPercentValue; statsGraphAsync#4a27eb2d token:string = StatsGraph; statsGraphError#bedc9822 error:string = StatsGraph; statsGraph#8ea464b6 flags:# json:DataJSON zoom_token:flags.0?string = StatsGraph; messageInteractionCounters#ad4fc9bd msg_id:int views:int forwards:int = MessageInteractionCounters; stats.broadcastStats#bdf78394 period:StatsDateRangeDays followers:StatsAbsValueAndPrev views_per_post:StatsAbsValueAndPrev shares_per_post:StatsAbsValueAndPrev enabled_notifications:StatsPercentValue growth_graph:StatsGraph followers_graph:StatsGraph mute_graph:StatsGraph top_hours_graph:StatsGraph interactions_graph:StatsGraph iv_interactions_graph:StatsGraph views_by_source_graph:StatsGraph new_followers_by_source_graph:StatsGraph languages_graph:StatsGraph recent_message_interactions:Vector<MessageInteractionCounters> = stats.BroadcastStats; help.promoDataEmpty#98f6ac75 expires:int = help.PromoData; help.promoData#8c39793f flags:# proxy:flags.0?true expires:int peer:Peer chats:Vector<Chat> users:Vector<User> psa_type:flags.1?string psa_message:flags.2?string = help.PromoData; videoSize#de33b094 flags:# type:string w:int h:int size:int video_start_ts:flags.0?double = VideoSize; statsGroupTopPoster#9d04af9b user_id:long messages:int avg_chars:int = StatsGroupTopPoster; statsGroupTopAdmin#d7584c87 user_id:long deleted:int kicked:int banned:int = StatsGroupTopAdmin; statsGroupTopInviter#535f779d user_id:long invitations:int = StatsGroupTopInviter; stats.megagroupStats#ef7ff916 period:StatsDateRangeDays members:StatsAbsValueAndPrev messages:StatsAbsValueAndPrev viewers:StatsAbsValueAndPrev posters:StatsAbsValueAndPrev growth_graph:StatsGraph members_graph:StatsGraph new_members_by_source_graph:StatsGraph languages_graph:StatsGraph messages_graph:StatsGraph actions_graph:StatsGraph top_hours_graph:StatsGraph weekdays_graph:StatsGraph top_posters:Vector<StatsGroupTopPoster> top_admins:Vector<StatsGroupTopAdmin> top_inviters:Vector<StatsGroupTopInviter> users:Vector<User> = stats.MegagroupStats; globalPrivacySettings#bea2f424 flags:# archive_and_mute_new_noncontact_peers:flags.0?Bool = GlobalPrivacySettings; help.countryCode#4203c5ef flags:# country_code:string prefixes:flags.0?Vector<string> patterns:flags.1?Vector<string> = help.CountryCode; help.country#c3878e23 flags:# hidden:flags.0?true iso2:string default_name:string name:flags.1?string country_codes:Vector<help.CountryCode> = help.Country; help.countriesListNotModified#93cc1f32 = help.CountriesList; help.countriesList#87d0759e countries:Vector<help.Country> hash:int = help.CountriesList; messageViews#455b853d flags:# views:flags.0?int forwards:flags.1?int replies:flags.2?MessageReplies = MessageViews; messages.messageViews#b6c4f543 views:Vector<MessageViews> chats:Vector<Chat> users:Vector<User> = messages.MessageViews; messages.discussionMessage#a6341782 flags:# messages:Vector<Message> max_id:flags.0?int read_inbox_max_id:flags.1?int read_outbox_max_id:flags.2?int unread_count:int chats:Vector<Chat> users:Vector<User> = messages.DiscussionMessage; messageReplyHeader#a6d57763 flags:# reply_to_scheduled:flags.2?true forum_topic:flags.3?true reply_to_msg_id:int reply_to_peer_id:flags.0?Peer reply_to_top_id:flags.1?int = MessageReplyHeader; messageReplies#83d60fc2 flags:# comments:flags.0?true replies:int replies_pts:int recent_repliers:flags.1?Vector<Peer> channel_id:flags.0?long max_id:flags.2?int read_max_id:flags.3?int = MessageReplies; peerBlocked#e8fd8014 peer_id:Peer date:int = PeerBlocked; stats.messageStats#8999f295 views_graph:StatsGraph = stats.MessageStats; groupCallDiscarded#7780bcb4 id:long access_hash:long duration:int = GroupCall; groupCall#d597650c flags:# join_muted:flags.1?true can_change_join_muted:flags.2?true join_date_asc:flags.6?true schedule_start_subscribed:flags.8?true can_start_video:flags.9?true record_video_active:flags.11?true rtmp_stream:flags.12?true listeners_hidden:flags.13?true id:long access_hash:long participants_count:int title:flags.3?string stream_dc_id:flags.4?int record_start_date:flags.5?int schedule_date:flags.7?int unmuted_video_count:flags.10?int unmuted_video_limit:int version:int = GroupCall; inputGroupCall#d8aa840f id:long access_hash:long = InputGroupCall; groupCallParticipant#eba636fe flags:# muted:flags.0?true left:flags.1?true can_self_unmute:flags.2?true just_joined:flags.4?true versioned:flags.5?true min:flags.8?true muted_by_you:flags.9?true volume_by_admin:flags.10?true self:flags.12?true video_joined:flags.15?true peer:Peer date:int active_date:flags.3?int source:int volume:flags.7?int about:flags.11?string raise_hand_rating:flags.13?long video:flags.6?GroupCallParticipantVideo presentation:flags.14?GroupCallParticipantVideo = GroupCallParticipant; phone.groupCall#9e727aad call:GroupCall participants:Vector<GroupCallParticipant> participants_next_offset:string chats:Vector<Chat> users:Vector<User> = phone.GroupCall; phone.groupParticipants#f47751b6 count:int participants:Vector<GroupCallParticipant> next_offset:string chats:Vector<Chat> users:Vector<User> version:int = phone.GroupParticipants; inlineQueryPeerTypeSameBotPM#3081ed9d = InlineQueryPeerType; inlineQueryPeerTypePM#833c0fac = InlineQueryPeerType; inlineQueryPeerTypeChat#d766c50a = InlineQueryPeerType; inlineQueryPeerTypeMegagroup#5ec4be43 = InlineQueryPeerType; inlineQueryPeerTypeBroadcast#6334ee9a = InlineQueryPeerType; messages.historyImport#1662af0b id:long = messages.HistoryImport; messages.historyImportParsed#5e0fb7b9 flags:# pm:flags.0?true group:flags.1?true title:flags.2?string = messages.HistoryImportParsed; messages.affectedFoundMessages#ef8d3e6c pts:int pts_count:int offset:int messages:Vector<int> = messages.AffectedFoundMessages; chatInviteImporter#8c5adfd9 flags:# requested:flags.0?true user_id:long date:int about:flags.2?string approved_by:flags.1?long = ChatInviteImporter; messages.exportedChatInvites#bdc62dcc count:int invites:Vector<ExportedChatInvite> users:Vector<User> = messages.ExportedChatInvites; messages.exportedChatInvite#1871be50 invite:ExportedChatInvite users:Vector<User> = messages.ExportedChatInvite; messages.exportedChatInviteReplaced#222600ef invite:ExportedChatInvite new_invite:ExportedChatInvite users:Vector<User> = messages.ExportedChatInvite; messages.chatInviteImporters#81b6b00a count:int importers:Vector<ChatInviteImporter> users:Vector<User> = messages.ChatInviteImporters; chatAdminWithInvites#f2ecef23 admin_id:long invites_count:int revoked_invites_count:int = ChatAdminWithInvites; messages.chatAdminsWithInvites#b69b72d7 admins:Vector<ChatAdminWithInvites> users:Vector<User> = messages.ChatAdminsWithInvites; messages.checkedHistoryImportPeer#a24de717 confirm_text:string = messages.CheckedHistoryImportPeer; phone.joinAsPeers#afe5623f peers:Vector<Peer> chats:Vector<Chat> users:Vector<User> = phone.JoinAsPeers; phone.exportedGroupCallInvite#204bd158 link:string = phone.ExportedGroupCallInvite; groupCallParticipantVideoSourceGroup#dcb118b7 semantics:string sources:Vector<int> = GroupCallParticipantVideoSourceGroup; groupCallParticipantVideo#67753ac8 flags:# paused:flags.0?true endpoint:string source_groups:Vector<GroupCallParticipantVideoSourceGroup> audio_source:flags.1?int = GroupCallParticipantVideo; stickers.suggestedShortName#85fea03f short_name:string = stickers.SuggestedShortName; botCommandScopeDefault#2f6cb2ab = BotCommandScope; botCommandScopeUsers#3c4f04d8 = BotCommandScope; botCommandScopeChats#6fe1a881 = BotCommandScope; botCommandScopeChatAdmins#b9aa606a = BotCommandScope; botCommandScopePeer#db9d897d peer:InputPeer = BotCommandScope; botCommandScopePeerAdmins#3fd863d1 peer:InputPeer = BotCommandScope; botCommandScopePeerUser#a1321f3 peer:InputPeer user_id:InputUser = BotCommandScope; account.resetPasswordFailedWait#e3779861 retry_date:int = account.ResetPasswordResult; account.resetPasswordRequestedWait#e9effc7d until_date:int = account.ResetPasswordResult; account.resetPasswordOk#e926d63e = account.ResetPasswordResult; sponsoredMessage#3a836df8 flags:# recommended:flags.5?true show_peer_photo:flags.6?true random_id:bytes from_id:flags.3?Peer chat_invite:flags.4?ChatInvite chat_invite_hash:flags.4?string channel_post:flags.2?int start_param:flags.0?string message:string entities:flags.1?Vector<MessageEntity> = SponsoredMessage; messages.sponsoredMessages#c9ee1d87 flags:# posts_between:flags.0?int messages:Vector<SponsoredMessage> chats:Vector<Chat> users:Vector<User> = messages.SponsoredMessages; messages.sponsoredMessagesEmpty#1839490f = messages.SponsoredMessages; searchResultsCalendarPeriod#c9b0539f date:int min_msg_id:int max_msg_id:int count:int = SearchResultsCalendarPeriod; messages.searchResultsCalendar#147ee23c flags:# inexact:flags.0?true count:int min_date:int min_msg_id:int offset_id_offset:flags.1?int periods:Vector<SearchResultsCalendarPeriod> messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.SearchResultsCalendar; searchResultPosition#7f648b67 msg_id:int date:int offset:int = SearchResultsPosition; messages.searchResultsPositions#53b22baf count:int positions:Vector<SearchResultsPosition> = messages.SearchResultsPositions; channels.sendAsPeers#f496b0c6 peers:Vector<SendAsPeer> chats:Vector<Chat> users:Vector<User> = channels.SendAsPeers; users.userFull#3b6d152e full_user:UserFull chats:Vector<Chat> users:Vector<User> = users.UserFull; messages.peerSettings#6880b94d settings:PeerSettings chats:Vector<Chat> users:Vector<User> = messages.PeerSettings; auth.loggedOut#c3a2835f flags:# future_auth_token:flags.0?bytes = auth.LoggedOut; reactionCount#a3d1cb80 flags:# chosen_order:flags.0?int reaction:Reaction count:int = ReactionCount; messageReactions#4f2b9479 flags:# min:flags.0?true can_see_list:flags.2?true results:Vector<ReactionCount> recent_reactions:flags.1?Vector<MessagePeerReaction> = MessageReactions; messages.messageReactionsList#31bd492d flags:# count:int reactions:Vector<MessagePeerReaction> chats:Vector<Chat> users:Vector<User> next_offset:flags.0?string = messages.MessageReactionsList; availableReaction#c077ec01 flags:# inactive:flags.0?true premium:flags.2?true reaction:string title:string static_icon:Document appear_animation:Document select_animation:Document activate_animation:Document effect_animation:Document around_animation:flags.1?Document center_icon:flags.1?Document = AvailableReaction; messages.availableReactionsNotModified#9f071957 = messages.AvailableReactions; messages.availableReactions#768e3aad hash:int reactions:Vector<AvailableReaction> = messages.AvailableReactions; messages.translateNoResult#67ca4737 = messages.TranslatedText; messages.translateResultText#a214f7d0 text:string = messages.TranslatedText; messagePeerReaction#b156fe9c flags:# big:flags.0?true unread:flags.1?true peer_id:Peer reaction:Reaction = MessagePeerReaction; groupCallStreamChannel#80eb48af channel:int scale:int last_timestamp_ms:long = GroupCallStreamChannel; phone.groupCallStreamChannels#d0e482b2 channels:Vector<GroupCallStreamChannel> = phone.GroupCallStreamChannels; phone.groupCallStreamRtmpUrl#2dbf3432 url:string key:string = phone.GroupCallStreamRtmpUrl; attachMenuBotIconColor#4576f3f0 name:string color:int = AttachMenuBotIconColor; attachMenuBotIcon#b2a7386b flags:# name:string icon:Document colors:flags.0?Vector<AttachMenuBotIconColor> = AttachMenuBotIcon; attachMenuBot#c8aa2cd2 flags:# inactive:flags.0?true has_settings:flags.1?true request_write_access:flags.2?true bot_id:long short_name:string peer_types:Vector<AttachMenuPeerType> icons:Vector<AttachMenuBotIcon> = AttachMenuBot; attachMenuBotsNotModified#f1d88a5c = AttachMenuBots; attachMenuBots#3c4301c0 hash:long bots:Vector<AttachMenuBot> users:Vector<User> = AttachMenuBots; attachMenuBotsBot#93bf667f bot:AttachMenuBot users:Vector<User> = AttachMenuBotsBot; webViewResultUrl#c14557c query_id:long url:string = WebViewResult; simpleWebViewResultUrl#882f76bb url:string = SimpleWebViewResult; webViewMessageSent#c94511c flags:# msg_id:flags.0?InputBotInlineMessageID = WebViewMessageSent; botMenuButtonDefault#7533a588 = BotMenuButton; botMenuButtonCommands#4258c205 = BotMenuButton; botMenuButton#c7b57ce6 text:string url:string = BotMenuButton; account.savedRingtonesNotModified#fbf6e8b1 = account.SavedRingtones; account.savedRingtones#c1e92cc5 hash:long ringtones:Vector<Document> = account.SavedRingtones; notificationSoundDefault#97e8bebe = NotificationSound; notificationSoundNone#6f0c34df = NotificationSound; notificationSoundLocal#830b9ae4 title:string data:string = NotificationSound; notificationSoundRingtone#ff6c8049 id:long = NotificationSound; account.savedRingtone#b7263f6d = account.SavedRingtone; account.savedRingtoneConverted#1f307eb7 document:Document = account.SavedRingtone; attachMenuPeerTypeSameBotPM#7d6be90e = AttachMenuPeerType; attachMenuPeerTypeBotPM#c32bfa1a = AttachMenuPeerType; attachMenuPeerTypePM#f146d31f = AttachMenuPeerType; attachMenuPeerTypeChat#509113f = AttachMenuPeerType; attachMenuPeerTypeBroadcast#7bfbdefc = AttachMenuPeerType; inputInvoiceMessage#c5b56859 peer:InputPeer msg_id:int = InputInvoice; inputInvoiceSlug#c326caef slug:string = InputInvoice; payments.exportedInvoice#aed0cbd9 url:string = payments.ExportedInvoice; messages.transcribedAudio#93752c52 flags:# pending:flags.0?true transcription_id:long text:string = messages.TranscribedAudio; help.premiumPromo#5334759c status_text:string status_entities:Vector<MessageEntity> video_sections:Vector<string> videos:Vector<Document> period_options:Vector<PremiumSubscriptionOption> users:Vector<User> = help.PremiumPromo; inputStorePaymentPremiumSubscription#a6751e66 flags:# restore:flags.0?true = InputStorePaymentPurpose; inputStorePaymentGiftPremium#616f7fe8 user_id:InputUser currency:string amount:long = InputStorePaymentPurpose; premiumGiftOption#74c34319 flags:# months:int currency:string amount:long bot_url:string store_product:flags.0?string = PremiumGiftOption; paymentFormMethod#88f8f21b url:string title:string = PaymentFormMethod; emojiStatusEmpty#2de11aae = EmojiStatus; emojiStatus#929b619d document_id:long = EmojiStatus; emojiStatusUntil#fa30a8c7 document_id:long until:int = EmojiStatus; account.emojiStatusesNotModified#d08ce645 = account.EmojiStatuses; account.emojiStatuses#90c467d1 hash:long statuses:Vector<EmojiStatus> = account.EmojiStatuses; reactionEmpty#79f5d419 = Reaction; reactionEmoji#1b2286b8 emoticon:string = Reaction; reactionCustomEmoji#8935fc73 document_id:long = Reaction; chatReactionsNone#eafc32bc = ChatReactions; chatReactionsAll#52928bca flags:# allow_custom:flags.0?true = ChatReactions; chatReactionsSome#661d4037 reactions:Vector<Reaction> = ChatReactions; messages.reactionsNotModified#b06fdbdf = messages.Reactions; messages.reactions#eafdf716 hash:long reactions:Vector<Reaction> = messages.Reactions; emailVerifyPurposeLoginSetup#4345be73 phone_number:string phone_code_hash:string = EmailVerifyPurpose; emailVerifyPurposeLoginChange#527d22eb = EmailVerifyPurpose; emailVerifyPurposePassport#bbf51685 = EmailVerifyPurpose; emailVerificationCode#922e55a9 code:string = EmailVerification; emailVerificationGoogle#db909ec2 token:string = EmailVerification; emailVerificationApple#96d074fd token:string = EmailVerification; account.emailVerified#2b96cd1b email:string = account.EmailVerified; account.emailVerifiedLogin#e1bb0d61 email:string sent_code:auth.SentCode = account.EmailVerified; premiumSubscriptionOption#b6f11ebe flags:# current:flags.1?true can_purchase_upgrade:flags.2?true months:int currency:string amount:long bot_url:string store_product:flags.0?string = PremiumSubscriptionOption; sendAsPeer#b81c7034 flags:# premium_required:flags.0?true peer:Peer = SendAsPeer; messageExtendedMediaPreview#ad628cc8 flags:# w:flags.0?int h:flags.0?int thumb:flags.1?PhotoSize video_duration:flags.2?int = MessageExtendedMedia; messageExtendedMedia#ee479c64 media:MessageMedia = MessageExtendedMedia; stickerKeyword#fcfeb29c document_id:long keyword:Vector<string> = StickerKeyword; username#b4073647 flags:# editable:flags.0?true active:flags.1?true username:string = Username; forumTopicDeleted#23f109b id:int = ForumTopic; forumTopic#71701da9 flags:# my:flags.1?true closed:flags.2?true pinned:flags.3?true short:flags.5?true hidden:flags.6?true id:int date:int title:string icon_color:int icon_emoji_id:flags.0?long top_message:int read_inbox_max_id:int read_outbox_max_id:int unread_count:int unread_mentions_count:int unread_reactions_count:int from_id:Peer notify_settings:PeerNotifySettings draft:flags.4?DraftMessage = ForumTopic; messages.forumTopics#367617d3 flags:# order_by_create_date:flags.0?true count:int topics:Vector<ForumTopic> messages:Vector<Message> chats:Vector<Chat> users:Vector<User> pts:int = messages.ForumTopics; defaultHistoryTTL#43b46b20 period:int = DefaultHistoryTTL; exportedContactToken#41bf109b url:string expires:int = ExportedContactToken; ---functions--- invokeAfterMsg#cb9f372d {X:Type} msg_id:long query:!X = X; invokeAfterMsgs#3dc4b4f0 {X:Type} msg_ids:Vector<long> query:!X = X; initConnection#c1cd5ea9 {X:Type} flags:# api_id:int device_model:string system_version:string app_version:string system_lang_code:string lang_pack:string lang_code:string proxy:flags.0?InputClientProxy params:flags.1?JSONValue query:!X = X; invokeWithLayer#da9b0d0d {X:Type} layer:int query:!X = X; invokeWithoutUpdates#bf9459b7 {X:Type} query:!X = X; invokeWithMessagesRange#365275f2 {X:Type} range:MessageRange query:!X = X; invokeWithTakeout#aca9fd2e {X:Type} takeout_id:long query:!X = X; auth.sendCode#a677244f phone_number:string api_id:int api_hash:string settings:CodeSettings = auth.SentCode; auth.signUp#80eee427 phone_number:string phone_code_hash:string first_name:string last_name:string = auth.Authorization; auth.signIn#8d52a951 flags:# phone_number:string phone_code_hash:string phone_code:flags.0?string email_verification:flags.1?EmailVerification = auth.Authorization; auth.logOut#3e72ba19 = auth.LoggedOut; auth.resetAuthorizations#9fab0d1a = Bool; auth.exportAuthorization#e5bfffcd dc_id:int = auth.ExportedAuthorization; auth.importAuthorization#a57a7dad id:long bytes:bytes = auth.Authorization; auth.bindTempAuthKey#cdd42a05 perm_auth_key_id:long nonce:long expires_at:int encrypted_message:bytes = Bool; auth.importBotAuthorization#67a3ff2c flags:int api_id:int api_hash:string bot_auth_token:string = auth.Authorization; auth.checkPassword#d18b4d16 password:InputCheckPasswordSRP = auth.Authorization; auth.requestPasswordRecovery#d897bc66 = auth.PasswordRecovery; auth.recoverPassword#37096c70 flags:# code:string new_settings:flags.0?account.PasswordInputSettings = auth.Authorization; auth.resendCode#3ef1a9bf phone_number:string phone_code_hash:string = auth.SentCode; auth.cancelCode#1f040578 phone_number:string phone_code_hash:string = Bool; auth.dropTempAuthKeys#8e48a188 except_auth_keys:Vector<long> = Bool; auth.exportLoginToken#b7e085fe api_id:int api_hash:string except_ids:Vector<long> = auth.LoginToken; auth.importLoginToken#95ac5ce4 token:bytes = auth.LoginToken; auth.acceptLoginToken#e894ad4d token:bytes = Authorization; auth.checkRecoveryPassword#d36bf79 code:string = Bool; auth.importWebTokenAuthorization#2db873a9 api_id:int api_hash:string web_auth_token:string = auth.Authorization; account.registerDevice#ec86017a flags:# no_muted:flags.0?true token_type:int token:string app_sandbox:Bool secret:bytes other_uids:Vector<long> = Bool; account.unregisterDevice#6a0d3206 token_type:int token:string other_uids:Vector<long> = Bool; account.updateNotifySettings#84be5b93 peer:InputNotifyPeer settings:InputPeerNotifySettings = Bool; account.getNotifySettings#12b3ad31 peer:InputNotifyPeer = PeerNotifySettings; account.resetNotifySettings#db7e1747 = Bool; account.updateProfile#78515775 flags:# first_name:flags.0?string last_name:flags.1?string about:flags.2?string = User; account.updateStatus#6628562c offline:Bool = Bool; account.getWallPapers#7967d36 hash:long = account.WallPapers; account.reportPeer#c5ba3d86 peer:InputPeer reason:ReportReason message:string = Bool; account.checkUsername#2714d86c username:string = Bool; account.updateUsername#3e0bdd7c username:string = User; account.getPrivacy#dadbc950 key:InputPrivacyKey = account.PrivacyRules; account.setPrivacy#c9f81ce8 key:InputPrivacyKey rules:Vector<InputPrivacyRule> = account.PrivacyRules; account.deleteAccount#a2c0cf74 flags:# reason:string password:flags.0?InputCheckPasswordSRP = Bool; account.getAccountTTL#8fc711d = AccountDaysTTL; account.setAccountTTL#2442485e ttl:AccountDaysTTL = Bool; account.sendChangePhoneCode#82574ae5 phone_number:string settings:CodeSettings = auth.SentCode; account.changePhone#70c32edb phone_number:string phone_code_hash:string phone_code:string = User; account.updateDeviceLocked#38df3532 period:int = Bool; account.getAuthorizations#e320c158 = account.Authorizations; account.resetAuthorization#df77f3bc hash:long = Bool; account.getPassword#548a30f5 = account.Password; account.getPasswordSettings#9cd4eaf9 password:InputCheckPasswordSRP = account.PasswordSettings; account.updatePasswordSettings#a59b102f password:InputCheckPasswordSRP new_settings:account.PasswordInputSettings = Bool; account.sendConfirmPhoneCode#1b3faa88 hash:string settings:CodeSettings = auth.SentCode; account.confirmPhone#5f2178c3 phone_code_hash:string phone_code:string = Bool; account.getTmpPassword#449e0b51 password:InputCheckPasswordSRP period:int = account.TmpPassword; account.getWebAuthorizations#182e6d6f = account.WebAuthorizations; account.resetWebAuthorization#2d01b9ef hash:long = Bool; account.resetWebAuthorizations#682d2594 = Bool; account.getAllSecureValues#b288bc7d = Vector<SecureValue>; account.getSecureValue#73665bc2 types:Vector<SecureValueType> = Vector<SecureValue>; account.saveSecureValue#899fe31d value:InputSecureValue secure_secret_id:long = SecureValue; account.deleteSecureValue#b880bc4b types:Vector<SecureValueType> = Bool; account.getAuthorizationForm#a929597a bot_id:long scope:string public_key:string = account.AuthorizationForm; account.acceptAuthorization#f3ed4c73 bot_id:long scope:string public_key:string value_hashes:Vector<SecureValueHash> credentials:SecureCredentialsEncrypted = Bool; account.sendVerifyPhoneCode#a5a356f9 phone_number:string settings:CodeSettings = auth.SentCode; account.verifyPhone#4dd3a7f6 phone_number:string phone_code_hash:string phone_code:string = Bool; account.sendVerifyEmailCode#98e037bb purpose:EmailVerifyPurpose email:string = account.SentEmailCode; account.verifyEmail#32da4cf purpose:EmailVerifyPurpose verification:EmailVerification = account.EmailVerified; account.initTakeoutSession#8ef3eab0 flags:# contacts:flags.0?true message_users:flags.1?true message_chats:flags.2?true message_megagroups:flags.3?true message_channels:flags.4?true files:flags.5?true file_max_size:flags.5?long = account.Takeout; account.finishTakeoutSession#1d2652ee flags:# success:flags.0?true = Bool; account.confirmPasswordEmail#8fdf1920 code:string = Bool; account.resendPasswordEmail#7a7f2a15 = Bool; account.cancelPasswordEmail#c1cbd5b6 = Bool; account.getContactSignUpNotification#9f07c728 = Bool; account.setContactSignUpNotification#cff43f61 silent:Bool = Bool; account.getNotifyExceptions#53577479 flags:# compare_sound:flags.1?true peer:flags.0?InputNotifyPeer = Updates; account.getWallPaper#fc8ddbea wallpaper:InputWallPaper = WallPaper; account.uploadWallPaper#dd853661 file:InputFile mime_type:string settings:WallPaperSettings = WallPaper; account.saveWallPaper#6c5a5b37 wallpaper:InputWallPaper unsave:Bool settings:WallPaperSettings = Bool; account.installWallPaper#feed5769 wallpaper:InputWallPaper settings:WallPaperSettings = Bool; account.resetWallPapers#bb3b9804 = Bool; account.getAutoDownloadSettings#56da0b3f = account.AutoDownloadSettings; account.saveAutoDownloadSettings#76f36233 flags:# low:flags.0?true high:flags.1?true settings:AutoDownloadSettings = Bool; account.uploadTheme#1c3db333 flags:# file:InputFile thumb:flags.0?InputFile file_name:string mime_type:string = Document; account.createTheme#652e4400 flags:# slug:string title:string document:flags.2?InputDocument settings:flags.3?Vector<InputThemeSettings> = Theme; account.updateTheme#2bf40ccc flags:# format:string theme:InputTheme slug:flags.0?string title:flags.1?string document:flags.2?InputDocument settings:flags.3?Vector<InputThemeSettings> = Theme; account.saveTheme#f257106c theme:InputTheme unsave:Bool = Bool; account.installTheme#c727bb3b flags:# dark:flags.0?true theme:flags.1?InputTheme format:flags.2?string base_theme:flags.3?BaseTheme = Bool; account.getTheme#3a5869ec format:string theme:InputTheme = Theme; account.getThemes#7206e458 format:string hash:long = account.Themes; account.setContentSettings#b574b16b flags:# sensitive_enabled:flags.0?true = Bool; account.getContentSettings#8b9b4dae = account.ContentSettings; account.getMultiWallPapers#65ad71dc wallpapers:Vector<InputWallPaper> = Vector<WallPaper>; account.getGlobalPrivacySettings#eb2b4cf6 = GlobalPrivacySettings; account.setGlobalPrivacySettings#1edaaac2 settings:GlobalPrivacySettings = GlobalPrivacySettings; account.reportProfilePhoto#fa8cc6f5 peer:InputPeer photo_id:InputPhoto reason:ReportReason message:string = Bool; account.resetPassword#9308ce1b = account.ResetPasswordResult; account.declinePasswordReset#4c9409f6 = Bool; account.getChatThemes#d638de89 hash:long = account.Themes; account.setAuthorizationTTL#bf899aa0 authorization_ttl_days:int = Bool; account.changeAuthorizationSettings#40f48462 flags:# hash:long encrypted_requests_disabled:flags.0?Bool call_requests_disabled:flags.1?Bool = Bool; account.getSavedRingtones#e1902288 hash:long = account.SavedRingtones; account.saveRingtone#3dea5b03 id:InputDocument unsave:Bool = account.SavedRingtone; account.uploadRingtone#831a83a2 file:InputFile file_name:string mime_type:string = Document; account.updateEmojiStatus#fbd3de6b emoji_status:EmojiStatus = Bool; account.getDefaultEmojiStatuses#d6753386 hash:long = account.EmojiStatuses; account.getRecentEmojiStatuses#f578105 hash:long = account.EmojiStatuses; account.clearRecentEmojiStatuses#18201aae = Bool; account.reorderUsernames#ef500eab order:Vector<string> = Bool; account.toggleUsername#58d6b376 username:string active:Bool = Bool; users.getUsers#d91a548 id:Vector<InputUser> = Vector<User>; users.getFullUser#b60f5918 id:InputUser = users.UserFull; users.setSecureValueErrors#90c894b5 id:InputUser errors:Vector<SecureValueError> = Bool; contacts.getContactIDs#7adc669d hash:long = Vector<int>; contacts.getStatuses#c4a353ee = Vector<ContactStatus>; contacts.getContacts#5dd69e12 hash:long = contacts.Contacts; contacts.importContacts#2c800be5 contacts:Vector<InputContact> = contacts.ImportedContacts; contacts.deleteContacts#96a0e00 id:Vector<InputUser> = Updates; contacts.deleteByPhones#1013fd9e phones:Vector<string> = Bool; contacts.block#68cc1411 id:InputPeer = Bool; contacts.unblock#bea65d50 id:InputPeer = Bool; contacts.getBlocked#f57c350f offset:int limit:int = contacts.Blocked; contacts.search#11f812d8 q:string limit:int = contacts.Found; contacts.resolveUsername#f93ccba3 username:string = contacts.ResolvedPeer; contacts.getTopPeers#973478b6 flags:# correspondents:flags.0?true bots_pm:flags.1?true bots_inline:flags.2?true phone_calls:flags.3?true forward_users:flags.4?true forward_chats:flags.5?true groups:flags.10?true channels:flags.15?true offset:int limit:int hash:long = contacts.TopPeers; contacts.resetTopPeerRating#1ae373ac category:TopPeerCategory peer:InputPeer = Bool; contacts.resetSaved#879537f1 = Bool; contacts.getSaved#82f1e39f = Vector<SavedContact>; contacts.toggleTopPeers#8514bdda enabled:Bool = Bool; contacts.addContact#e8f463d0 flags:# add_phone_privacy_exception:flags.0?true id:InputUser first_name:string last_name:string phone:string = Updates; contacts.acceptContact#f831a20f id:InputUser = Updates; contacts.getLocated#d348bc44 flags:# background:flags.1?true geo_point:InputGeoPoint self_expires:flags.0?int = Updates; contacts.blockFromReplies#29a8962c flags:# delete_message:flags.0?true delete_history:flags.1?true report_spam:flags.2?true msg_id:int = Updates; contacts.resolvePhone#8af94344 phone:string = contacts.ResolvedPeer; contacts.exportContactToken#f8654027 = ExportedContactToken; contacts.importContactToken#13005788 token:string = User; messages.getMessages#63c66506 id:Vector<InputMessage> = messages.Messages; messages.getDialogs#a0f4cb4f flags:# exclude_pinned:flags.0?true folder_id:flags.1?int offset_date:int offset_id:int offset_peer:InputPeer limit:int hash:long = messages.Dialogs; messages.getHistory#4423e6c5 peer:InputPeer offset_id:int offset_date:int add_offset:int limit:int max_id:int min_id:int hash:long = messages.Messages; messages.search#a0fda762 flags:# peer:InputPeer q:string from_id:flags.0?InputPeer top_msg_id:flags.1?int filter:MessagesFilter min_date:int max_date:int offset_id:int add_offset:int limit:int max_id:int min_id:int hash:long = messages.Messages; messages.readHistory#e306d3a peer:InputPeer max_id:int = messages.AffectedMessages; messages.deleteHistory#b08f922a flags:# just_clear:flags.0?true revoke:flags.1?true peer:InputPeer max_id:int min_date:flags.2?int max_date:flags.3?int = messages.AffectedHistory; messages.deleteMessages#e58e95d2 flags:# revoke:flags.0?true id:Vector<int> = messages.AffectedMessages; messages.receivedMessages#5a954c0 max_id:int = Vector<ReceivedNotifyMessage>; messages.setTyping#58943ee2 flags:# peer:InputPeer top_msg_id:flags.0?int action:SendMessageAction = Bool; messages.sendMessage#1cc20387 flags:# no_webpage:flags.1?true silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true peer:InputPeer reply_to_msg_id:flags.0?int top_msg_id:flags.9?int message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.10?int send_as:flags.13?InputPeer = Updates; messages.sendMedia#7547c966 flags:# silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true peer:InputPeer reply_to_msg_id:flags.0?int top_msg_id:flags.9?int media:InputMedia message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.10?int send_as:flags.13?InputPeer = Updates; messages.forwardMessages#c661bbc4 flags:# silent:flags.5?true background:flags.6?true with_my_score:flags.8?true drop_author:flags.11?true drop_media_captions:flags.12?true noforwards:flags.14?true from_peer:InputPeer id:Vector<int> random_id:Vector<long> to_peer:InputPeer top_msg_id:flags.9?int schedule_date:flags.10?int send_as:flags.13?InputPeer = Updates; messages.reportSpam#cf1592db peer:InputPeer = Bool; messages.getPeerSettings#efd9a6a2 peer:InputPeer = messages.PeerSettings; messages.report#8953ab4e peer:InputPeer id:Vector<int> reason:ReportReason message:string = Bool; messages.getChats#49e9528f id:Vector<long> = messages.Chats; messages.getFullChat#aeb00b34 chat_id:long = messages.ChatFull; messages.editChatTitle#73783ffd chat_id:long title:string = Updates; messages.editChatPhoto#35ddd674 chat_id:long photo:InputChatPhoto = Updates; messages.addChatUser#f24753e3 chat_id:long user_id:InputUser fwd_limit:int = Updates; messages.deleteChatUser#a2185cab flags:# revoke_history:flags.0?true chat_id:long user_id:InputUser = Updates; messages.createChat#34a818 flags:# users:Vector<InputUser> title:string ttl_period:flags.0?int = Updates; messages.getDhConfig#26cf8950 version:int random_length:int = messages.DhConfig; messages.requestEncryption#f64daf43 user_id:InputUser random_id:int g_a:bytes = EncryptedChat; messages.acceptEncryption#3dbc0415 peer:InputEncryptedChat g_b:bytes key_fingerprint:long = EncryptedChat; messages.discardEncryption#f393aea0 flags:# delete_history:flags.0?true chat_id:int = Bool; messages.setEncryptedTyping#791451ed peer:InputEncryptedChat typing:Bool = Bool; messages.readEncryptedHistory#7f4b690a peer:InputEncryptedChat max_date:int = Bool; messages.sendEncrypted#44fa7a15 flags:# silent:flags.0?true peer:InputEncryptedChat random_id:long data:bytes = messages.SentEncryptedMessage; messages.sendEncryptedFile#5559481d flags:# silent:flags.0?true peer:InputEncryptedChat random_id:long data:bytes file:InputEncryptedFile = messages.SentEncryptedMessage; messages.sendEncryptedService#32d439a4 peer:InputEncryptedChat random_id:long data:bytes = messages.SentEncryptedMessage; messages.receivedQueue#55a5bb66 max_qts:int = Vector<long>; messages.reportEncryptedSpam#4b0c8c0f peer:InputEncryptedChat = Bool; messages.readMessageContents#36a73f77 id:Vector<int> = messages.AffectedMessages; messages.getStickers#d5a5d3a1 emoticon:string hash:long = messages.Stickers; messages.getAllStickers#b8a0a1a8 hash:long = messages.AllStickers; messages.getWebPagePreview#8b68b0cc flags:# message:string entities:flags.3?Vector<MessageEntity> = MessageMedia; messages.exportChatInvite#a02ce5d5 flags:# legacy_revoke_permanent:flags.2?true request_needed:flags.3?true peer:InputPeer expire_date:flags.0?int usage_limit:flags.1?int title:flags.4?string = ExportedChatInvite; messages.checkChatInvite#3eadb1bb hash:string = ChatInvite; messages.importChatInvite#6c50051c hash:string = Updates; messages.getStickerSet#c8a0ec74 stickerset:InputStickerSet hash:int = messages.StickerSet; messages.installStickerSet#c78fe460 stickerset:InputStickerSet archived:Bool = messages.StickerSetInstallResult; messages.uninstallStickerSet#f96e55de stickerset:InputStickerSet = Bool; messages.startBot#e6df7378 bot:InputUser peer:InputPeer random_id:long start_param:string = Updates; messages.getMessagesViews#5784d3e1 peer:InputPeer id:Vector<int> increment:Bool = messages.MessageViews; messages.editChatAdmin#a85bd1c2 chat_id:long user_id:InputUser is_admin:Bool = Bool; messages.migrateChat#a2875319 chat_id:long = Updates; messages.searchGlobal#4bc6589a flags:# folder_id:flags.0?int q:string filter:MessagesFilter min_date:int max_date:int offset_rate:int offset_peer:InputPeer offset_id:int limit:int = messages.Messages; messages.reorderStickerSets#78337739 flags:# masks:flags.0?true emojis:flags.1?true order:Vector<long> = Bool; messages.getDocumentByHash#b1f2061f sha256:bytes size:long mime_type:string = Document; messages.getSavedGifs#5cf09635 hash:long = messages.SavedGifs; messages.saveGif#327a30cb id:InputDocument unsave:Bool = Bool; messages.getInlineBotResults#514e999d flags:# bot:InputUser peer:InputPeer geo_point:flags.0?InputGeoPoint query:string offset:string = messages.BotResults; messages.setInlineBotResults#eb5ea206 flags:# gallery:flags.0?true private:flags.1?true query_id:long results:Vector<InputBotInlineResult> cache_time:int next_offset:flags.2?string switch_pm:flags.3?InlineBotSwitchPM = Bool; messages.sendInlineBotResult#d3fbdccb flags:# silent:flags.5?true background:flags.6?true clear_draft:flags.7?true hide_via:flags.11?true peer:InputPeer reply_to_msg_id:flags.0?int top_msg_id:flags.9?int random_id:long query_id:long id:string schedule_date:flags.10?int send_as:flags.13?InputPeer = Updates; messages.getMessageEditData#fda68d36 peer:InputPeer id:int = messages.MessageEditData; messages.editMessage#48f71778 flags:# no_webpage:flags.1?true peer:InputPeer id:int message:flags.11?string media:flags.14?InputMedia reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.15?int = Updates; messages.editInlineBotMessage#83557dba flags:# no_webpage:flags.1?true id:InputBotInlineMessageID message:flags.11?string media:flags.14?InputMedia reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> = Bool; messages.getBotCallbackAnswer#9342ca07 flags:# game:flags.1?true peer:InputPeer msg_id:int data:flags.0?bytes password:flags.2?InputCheckPasswordSRP = messages.BotCallbackAnswer; messages.setBotCallbackAnswer#d58f130a flags:# alert:flags.1?true query_id:long message:flags.0?string url:flags.2?string cache_time:int = Bool; messages.getPeerDialogs#e470bcfd peers:Vector<InputDialogPeer> = messages.PeerDialogs; messages.saveDraft#b4331e3f flags:# no_webpage:flags.1?true reply_to_msg_id:flags.0?int top_msg_id:flags.2?int peer:InputPeer message:string entities:flags.3?Vector<MessageEntity> = Bool; messages.getAllDrafts#6a3f8d65 = Updates; messages.getFeaturedStickers#64780b14 hash:long = messages.FeaturedStickers; messages.readFeaturedStickers#5b118126 id:Vector<long> = Bool; messages.getRecentStickers#9da9403b flags:# attached:flags.0?true hash:long = messages.RecentStickers; messages.saveRecentSticker#392718f8 flags:# attached:flags.0?true id:InputDocument unsave:Bool = Bool; messages.clearRecentStickers#8999602d flags:# attached:flags.0?true = Bool; messages.getArchivedStickers#57f17692 flags:# masks:flags.0?true emojis:flags.1?true offset_id:long limit:int = messages.ArchivedStickers; messages.getMaskStickers#640f82b8 hash:long = messages.AllStickers; messages.getAttachedStickers#cc5b67cc media:InputStickeredMedia = Vector<StickerSetCovered>; messages.setGameScore#8ef8ecc0 flags:# edit_message:flags.0?true force:flags.1?true peer:InputPeer id:int user_id:InputUser score:int = Updates; messages.setInlineGameScore#15ad9f64 flags:# edit_message:flags.0?true force:flags.1?true id:InputBotInlineMessageID user_id:InputUser score:int = Bool; messages.getGameHighScores#e822649d peer:InputPeer id:int user_id:InputUser = messages.HighScores; messages.getInlineGameHighScores#f635e1b id:InputBotInlineMessageID user_id:InputUser = messages.HighScores; messages.getCommonChats#e40ca104 user_id:InputUser max_id:long limit:int = messages.Chats; messages.getAllChats#875f74be except_ids:Vector<long> = messages.Chats; messages.getWebPage#32ca8f91 url:string hash:int = WebPage; messages.toggleDialogPin#a731e257 flags:# pinned:flags.0?true peer:InputDialogPeer = Bool; messages.reorderPinnedDialogs#3b1adf37 flags:# force:flags.0?true folder_id:int order:Vector<InputDialogPeer> = Bool; messages.getPinnedDialogs#d6b94df2 folder_id:int = messages.PeerDialogs; messages.setBotShippingResults#e5f672fa flags:# query_id:long error:flags.0?string shipping_options:flags.1?Vector<ShippingOption> = Bool; messages.setBotPrecheckoutResults#9c2dd95 flags:# success:flags.1?true query_id:long error:flags.0?string = Bool; messages.uploadMedia#519bc2b1 peer:InputPeer media:InputMedia = MessageMedia; messages.sendScreenshotNotification#c97df020 peer:InputPeer reply_to_msg_id:int random_id:long = Updates; messages.getFavedStickers#4f1aaa9 hash:long = messages.FavedStickers; messages.faveSticker#b9ffc55b id:InputDocument unfave:Bool = Bool; messages.getUnreadMentions#f107e790 flags:# peer:InputPeer top_msg_id:flags.0?int offset_id:int add_offset:int limit:int max_id:int min_id:int = messages.Messages; messages.readMentions#36e5bf4d flags:# peer:InputPeer top_msg_id:flags.0?int = messages.AffectedHistory; messages.getRecentLocations#702a40e0 peer:InputPeer limit:int hash:long = messages.Messages; messages.sendMultiMedia#b6f11a1c flags:# silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true peer:InputPeer reply_to_msg_id:flags.0?int top_msg_id:flags.9?int multi_media:Vector<InputSingleMedia> schedule_date:flags.10?int send_as:flags.13?InputPeer = Updates; messages.uploadEncryptedFile#5057c497 peer:InputEncryptedChat file:InputEncryptedFile = EncryptedFile; messages.searchStickerSets#35705b8a flags:# exclude_featured:flags.0?true q:string hash:long = messages.FoundStickerSets; messages.getSplitRanges#1cff7e08 = Vector<MessageRange>; messages.markDialogUnread#c286d98f flags:# unread:flags.0?true peer:InputDialogPeer = Bool; messages.getDialogUnreadMarks#22e24e22 = Vector<DialogPeer>; messages.clearAllDrafts#7e58ee9c = Bool; messages.updatePinnedMessage#d2aaf7ec flags:# silent:flags.0?true unpin:flags.1?true pm_oneside:flags.2?true peer:InputPeer id:int = Updates; messages.sendVote#10ea6184 peer:InputPeer msg_id:int options:Vector<bytes> = Updates; messages.getPollResults#73bb643b peer:InputPeer msg_id:int = Updates; messages.getOnlines#6e2be050 peer:InputPeer = ChatOnlines; messages.editChatAbout#def60797 peer:InputPeer about:string = Bool; messages.editChatDefaultBannedRights#a5866b41 peer:InputPeer banned_rights:ChatBannedRights = Updates; messages.getEmojiKeywords#35a0e062 lang_code:string = EmojiKeywordsDifference; messages.getEmojiKeywordsDifference#1508b6af lang_code:string from_version:int = EmojiKeywordsDifference; messages.getEmojiKeywordsLanguages#4e9963b2 lang_codes:Vector<string> = Vector<EmojiLanguage>; messages.getEmojiURL#d5b10c26 lang_code:string = EmojiURL; messages.getSearchCounters#ae7cc1 flags:# peer:InputPeer top_msg_id:flags.0?int filters:Vector<MessagesFilter> = Vector<messages.SearchCounter>; messages.requestUrlAuth#198fb446 flags:# peer:flags.1?InputPeer msg_id:flags.1?int button_id:flags.1?int url:flags.2?string = UrlAuthResult; messages.acceptUrlAuth#b12c7125 flags:# write_allowed:flags.0?true peer:flags.1?InputPeer msg_id:flags.1?int button_id:flags.1?int url:flags.2?string = UrlAuthResult; messages.hidePeerSettingsBar#4facb138 peer:InputPeer = Bool; messages.getScheduledHistory#f516760b peer:InputPeer hash:long = messages.Messages; messages.getScheduledMessages#bdbb0464 peer:InputPeer id:Vector<int> = messages.Messages; messages.sendScheduledMessages#bd38850a peer:InputPeer id:Vector<int> = Updates; messages.deleteScheduledMessages#59ae2b16 peer:InputPeer id:Vector<int> = Updates; messages.getPollVotes#b86e380e flags:# peer:InputPeer id:int option:flags.0?bytes offset:flags.1?string limit:int = messages.VotesList; messages.toggleStickerSets#b5052fea flags:# uninstall:flags.0?true archive:flags.1?true unarchive:flags.2?true stickersets:Vector<InputStickerSet> = Bool; messages.getDialogFilters#f19ed96d = Vector<DialogFilter>; messages.getSuggestedDialogFilters#a29cd42c = Vector<DialogFilterSuggested>; messages.updateDialogFilter#1ad4a04a flags:# id:int filter:flags.0?DialogFilter = Bool; messages.updateDialogFiltersOrder#c563c1e4 order:Vector<int> = Bool; messages.getOldFeaturedStickers#7ed094a1 offset:int limit:int hash:long = messages.FeaturedStickers; messages.getReplies#22ddd30c peer:InputPeer msg_id:int offset_id:int offset_date:int add_offset:int limit:int max_id:int min_id:int hash:long = messages.Messages; messages.getDiscussionMessage#446972fd peer:InputPeer msg_id:int = messages.DiscussionMessage; messages.readDiscussion#f731a9f4 peer:InputPeer msg_id:int read_max_id:int = Bool; messages.unpinAllMessages#ee22b9a8 flags:# peer:InputPeer top_msg_id:flags.0?int = messages.AffectedHistory; messages.deleteChat#5bd0ee50 chat_id:long = Bool; messages.deletePhoneCallHistory#f9cbe409 flags:# revoke:flags.0?true = messages.AffectedFoundMessages; messages.checkHistoryImport#43fe19f3 import_head:string = messages.HistoryImportParsed; messages.initHistoryImport#34090c3b peer:InputPeer file:InputFile media_count:int = messages.HistoryImport; messages.uploadImportedMedia#2a862092 peer:InputPeer import_id:long file_name:string media:InputMedia = MessageMedia; messages.startHistoryImport#b43df344 peer:InputPeer import_id:long = Bool; messages.getExportedChatInvites#a2b5a3f6 flags:# revoked:flags.3?true peer:InputPeer admin_id:InputUser offset_date:flags.2?int offset_link:flags.2?string limit:int = messages.ExportedChatInvites; messages.getExportedChatInvite#73746f5c peer:InputPeer link:string = messages.ExportedChatInvite; messages.editExportedChatInvite#bdca2f75 flags:# revoked:flags.2?true peer:InputPeer link:string expire_date:flags.0?int usage_limit:flags.1?int request_needed:flags.3?Bool title:flags.4?string = messages.ExportedChatInvite; messages.deleteRevokedExportedChatInvites#56987bd5 peer:InputPeer admin_id:InputUser = Bool; messages.deleteExportedChatInvite#d464a42b peer:InputPeer link:string = Bool; messages.getAdminsWithInvites#3920e6ef peer:InputPeer = messages.ChatAdminsWithInvites; messages.getChatInviteImporters#df04dd4e flags:# requested:flags.0?true peer:InputPeer link:flags.1?string q:flags.2?string offset_date:int offset_user:InputUser limit:int = messages.ChatInviteImporters; messages.setHistoryTTL#b80e5fe4 peer:InputPeer period:int = Updates; messages.checkHistoryImportPeer#5dc60f03 peer:InputPeer = messages.CheckedHistoryImportPeer; messages.setChatTheme#e63be13f peer:InputPeer emoticon:string = Updates; messages.getMessageReadParticipants#2c6f97b7 peer:InputPeer msg_id:int = Vector<long>; messages.getSearchResultsCalendar#49f0bde9 peer:InputPeer filter:MessagesFilter offset_id:int offset_date:int = messages.SearchResultsCalendar; messages.getSearchResultsPositions#6e9583a3 peer:InputPeer filter:MessagesFilter offset_id:int limit:int = messages.SearchResultsPositions; messages.hideChatJoinRequest#7fe7e815 flags:# approved:flags.0?true peer:InputPeer user_id:InputUser = Updates; messages.hideAllChatJoinRequests#e085f4ea flags:# approved:flags.0?true peer:InputPeer link:flags.1?string = Updates; messages.toggleNoForwards#b11eafa2 peer:InputPeer enabled:Bool = Updates; messages.saveDefaultSendAs#ccfddf96 peer:InputPeer send_as:InputPeer = Bool; messages.sendReaction#d30d78d4 flags:# big:flags.1?true add_to_recent:flags.2?true peer:InputPeer msg_id:int reaction:flags.0?Vector<Reaction> = Updates; messages.getMessagesReactions#8bba90e6 peer:InputPeer id:Vector<int> = Updates; messages.getMessageReactionsList#461b3f48 flags:# peer:InputPeer id:int reaction:flags.0?Reaction offset:flags.1?string limit:int = messages.MessageReactionsList; messages.setChatAvailableReactions#feb16771 peer:InputPeer available_reactions:ChatReactions = Updates; messages.getAvailableReactions#18dea0ac hash:int = messages.AvailableReactions; messages.setDefaultReaction#4f47a016 reaction:Reaction = Bool; messages.translateText#24ce6dee flags:# peer:flags.0?InputPeer msg_id:flags.0?int text:flags.1?string from_lang:flags.2?string to_lang:string = messages.TranslatedText; messages.getUnreadReactions#3223495b flags:# peer:InputPeer top_msg_id:flags.0?int offset_id:int add_offset:int limit:int max_id:int min_id:int = messages.Messages; messages.readReactions#54aa7f8e flags:# peer:InputPeer top_msg_id:flags.0?int = messages.AffectedHistory; messages.searchSentMedia#107e31a0 q:string filter:MessagesFilter limit:int = messages.Messages; messages.getAttachMenuBots#16fcc2cb hash:long = AttachMenuBots; messages.getAttachMenuBot#77216192 bot:InputUser = AttachMenuBotsBot; messages.toggleBotInAttachMenu#69f59d69 flags:# write_allowed:flags.0?true bot:InputUser enabled:Bool = Bool; messages.requestWebView#178b480b flags:# from_bot_menu:flags.4?true silent:flags.5?true peer:InputPeer bot:InputUser url:flags.1?string start_param:flags.3?string theme_params:flags.2?DataJSON platform:string reply_to_msg_id:flags.0?int top_msg_id:flags.9?int send_as:flags.13?InputPeer = WebViewResult; messages.prolongWebView#7ff34309 flags:# silent:flags.5?true peer:InputPeer bot:InputUser query_id:long reply_to_msg_id:flags.0?int top_msg_id:flags.9?int send_as:flags.13?InputPeer = Bool; messages.requestSimpleWebView#299bec8e flags:# bot:InputUser url:string theme_params:flags.0?DataJSON platform:string = SimpleWebViewResult; messages.sendWebViewResultMessage#a4314f5 bot_query_id:string result:InputBotInlineResult = WebViewMessageSent; messages.sendWebViewData#dc0242c8 bot:InputUser random_id:long button_text:string data:string = Updates; messages.transcribeAudio#269e9a49 peer:InputPeer msg_id:int = messages.TranscribedAudio; messages.rateTranscribedAudio#7f1d072f peer:InputPeer msg_id:int transcription_id:long good:Bool = Bool; messages.getCustomEmojiDocuments#d9ab0f54 document_id:Vector<long> = Vector<Document>; messages.getEmojiStickers#fbfca18f hash:long = messages.AllStickers; messages.getFeaturedEmojiStickers#ecf6736 hash:long = messages.FeaturedStickers; messages.reportReaction#3f64c076 peer:InputPeer id:int reaction_peer:InputPeer = Bool; messages.getTopReactions#bb8125ba limit:int hash:long = messages.Reactions; messages.getRecentReactions#39461db2 limit:int hash:long = messages.Reactions; messages.clearRecentReactions#9dfeefb4 = Bool; messages.getExtendedMedia#84f80814 peer:InputPeer id:Vector<int> = Updates; messages.setDefaultHistoryTTL#9eb51445 period:int = Bool; messages.getDefaultHistoryTTL#658b7188 = DefaultHistoryTTL; updates.getState#edd4882a = updates.State; updates.getDifference#25939651 flags:# pts:int pts_total_limit:flags.0?int date:int qts:int = updates.Difference; updates.getChannelDifference#3173d78 flags:# force:flags.0?true channel:InputChannel filter:ChannelMessagesFilter pts:int limit:int = updates.ChannelDifference; photos.updateProfilePhoto#1c3d5956 flags:# fallback:flags.0?true id:InputPhoto = photos.Photo; photos.uploadProfilePhoto#89f30f69 flags:# fallback:flags.3?true file:flags.0?InputFile video:flags.1?InputFile video_start_ts:flags.2?double = photos.Photo; photos.deletePhotos#87cf7f2f id:Vector<InputPhoto> = Vector<long>; photos.getUserPhotos#91cd32a8 user_id:InputUser offset:int max_id:long limit:int = photos.Photos; photos.uploadContactProfilePhoto#b91a83bf flags:# suggest:flags.3?true save:flags.4?true user_id:InputUser file:flags.0?InputFile video:flags.1?InputFile video_start_ts:flags.2?double = photos.Photo; upload.saveFilePart#b304a621 file_id:long file_part:int bytes:bytes = Bool; upload.getFile#be5335be flags:# precise:flags.0?true cdn_supported:flags.1?true location:InputFileLocation offset:long limit:int = upload.File; upload.saveBigFilePart#de7b673d file_id:long file_part:int file_total_parts:int bytes:bytes = Bool; upload.getWebFile#24e6818d location:InputWebFileLocation offset:int limit:int = upload.WebFile; upload.getCdnFile#395f69da file_token:bytes offset:long limit:int = upload.CdnFile; upload.reuploadCdnFile#9b2754a8 file_token:bytes request_token:bytes = Vector<FileHash>; upload.getCdnFileHashes#91dc3f31 file_token:bytes offset:long = Vector<FileHash>; upload.getFileHashes#9156982a location:InputFileLocation offset:long = Vector<FileHash>; help.getConfig#c4f9186b = Config; help.getNearestDc#1fb33026 = NearestDc; help.getAppUpdate#522d5a7d source:string = help.AppUpdate; help.getInviteText#4d392343 = help.InviteText; help.getSupport#9cdf08cd = help.Support; help.getAppChangelog#9010ef6f prev_app_version:string = Updates; help.setBotUpdatesStatus#ec22cfcd pending_updates_count:int message:string = Bool; help.getCdnConfig#52029342 = CdnConfig; help.getRecentMeUrls#3dc0f114 referer:string = help.RecentMeUrls; help.getTermsOfServiceUpdate#2ca51fd1 = help.TermsOfServiceUpdate; help.acceptTermsOfService#ee72f79a id:DataJSON = Bool; help.getDeepLinkInfo#3fedc75f path:string = help.DeepLinkInfo; help.getAppConfig#98914110 = JSONValue; help.saveAppLog#6f02f748 events:Vector<InputAppEvent> = Bool; help.getPassportConfig#c661ad08 hash:int = help.PassportConfig; help.getSupportName#d360e72c = help.SupportName; help.getUserInfo#38a08d3 user_id:InputUser = help.UserInfo; help.editUserInfo#66b91b70 user_id:InputUser message:string entities:Vector<MessageEntity> = help.UserInfo; help.getPromoData#c0977421 = help.PromoData; help.hidePromoData#1e251c95 peer:InputPeer = Bool; help.dismissSuggestion#f50dbaa1 peer:InputPeer suggestion:string = Bool; help.getCountriesList#735787a8 lang_code:string hash:int = help.CountriesList; help.getPremiumPromo#b81b93d4 = help.PremiumPromo; channels.readHistory#cc104937 channel:InputChannel max_id:int = Bool; channels.deleteMessages#84c1fd4e channel:InputChannel id:Vector<int> = messages.AffectedMessages; channels.reportSpam#f44a8315 channel:InputChannel participant:InputPeer id:Vector<int> = Bool; channels.getMessages#ad8c9a23 channel:InputChannel id:Vector<InputMessage> = messages.Messages; channels.getParticipants#77ced9d0 channel:InputChannel filter:ChannelParticipantsFilter offset:int limit:int hash:long = channels.ChannelParticipants; channels.getParticipant#a0ab6cc6 channel:InputChannel participant:InputPeer = channels.ChannelParticipant; channels.getChannels#a7f6bbb id:Vector<InputChannel> = messages.Chats; channels.getFullChannel#8736a09 channel:InputChannel = messages.ChatFull; channels.createChannel#91006707 flags:# broadcast:flags.0?true megagroup:flags.1?true for_import:flags.3?true title:string about:string geo_point:flags.2?InputGeoPoint address:flags.2?string ttl_period:flags.4?int = Updates; channels.editAdmin#d33c8902 channel:InputChannel user_id:InputUser admin_rights:ChatAdminRights rank:string = Updates; channels.editTitle#566decd0 channel:InputChannel title:string = Updates; channels.editPhoto#f12e57c9 channel:InputChannel photo:InputChatPhoto = Updates; channels.checkUsername#10e6bd2c channel:InputChannel username:string = Bool; channels.updateUsername#3514b3de channel:InputChannel username:string = Bool; channels.joinChannel#24b524c5 channel:InputChannel = Updates; channels.leaveChannel#f836aa95 channel:InputChannel = Updates; channels.inviteToChannel#199f3a6c channel:InputChannel users:Vector<InputUser> = Updates; channels.deleteChannel#c0111fe3 channel:InputChannel = Updates; channels.exportMessageLink#e63fadeb flags:# grouped:flags.0?true thread:flags.1?true channel:InputChannel id:int = ExportedMessageLink; channels.toggleSignatures#1f69b606 channel:InputChannel enabled:Bool = Updates; channels.getAdminedPublicChannels#f8b036af flags:# by_location:flags.0?true check_limit:flags.1?true = messages.Chats; channels.editBanned#96e6cd81 channel:InputChannel participant:InputPeer banned_rights:ChatBannedRights = Updates; channels.getAdminLog#33ddf480 flags:# channel:InputChannel q:string events_filter:flags.0?ChannelAdminLogEventsFilter admins:flags.1?Vector<InputUser> max_id:long min_id:long limit:int = channels.AdminLogResults; channels.setStickers#ea8ca4f9 channel:InputChannel stickerset:InputStickerSet = Bool; channels.readMessageContents#eab5dc38 channel:InputChannel id:Vector<int> = Bool; channels.deleteHistory#9baa9647 flags:# for_everyone:flags.0?true channel:InputChannel max_id:int = Updates; channels.togglePreHistoryHidden#eabbb94c channel:InputChannel enabled:Bool = Updates; channels.getLeftChannels#8341ecc0 offset:int = messages.Chats; channels.getGroupsForDiscussion#f5dad378 = messages.Chats; channels.setDiscussionGroup#40582bb2 broadcast:InputChannel group:InputChannel = Bool; channels.editCreator#8f38cd1f channel:InputChannel user_id:InputUser password:InputCheckPasswordSRP = Updates; channels.editLocation#58e63f6d channel:InputChannel geo_point:InputGeoPoint address:string = Bool; channels.toggleSlowMode#edd49ef0 channel:InputChannel seconds:int = Updates; channels.getInactiveChannels#11e831ee = messages.InactiveChats; channels.convertToGigagroup#b290c69 channel:InputChannel = Updates; channels.viewSponsoredMessage#beaedb94 channel:InputChannel random_id:bytes = Bool; channels.getSponsoredMessages#ec210fbf channel:InputChannel = messages.SponsoredMessages; channels.getSendAs#dc770ee peer:InputPeer = channels.SendAsPeers; channels.deleteParticipantHistory#367544db channel:InputChannel participant:InputPeer = messages.AffectedHistory; channels.toggleJoinToSend#e4cb9580 channel:InputChannel enabled:Bool = Updates; channels.toggleJoinRequest#4c2985b6 channel:InputChannel enabled:Bool = Updates; channels.reorderUsernames#b45ced1d channel:InputChannel order:Vector<string> = Bool; channels.toggleUsername#50f24105 channel:InputChannel username:string active:Bool = Bool; channels.deactivateAllUsernames#a245dd3 channel:InputChannel = Bool; channels.toggleForum#a4298b29 channel:InputChannel enabled:Bool = Updates; channels.createForumTopic#f40c0224 flags:# channel:InputChannel title:string icon_color:flags.0?int icon_emoji_id:flags.3?long random_id:long send_as:flags.2?InputPeer = Updates; channels.getForumTopics#de560d1 flags:# channel:InputChannel q:flags.0?string offset_date:int offset_id:int offset_topic:int limit:int = messages.ForumTopics; channels.getForumTopicsByID#b0831eb9 channel:InputChannel topics:Vector<int> = messages.ForumTopics; channels.editForumTopic#f4dfa185 flags:# channel:InputChannel topic_id:int title:flags.0?string icon_emoji_id:flags.1?long closed:flags.2?Bool hidden:flags.3?Bool = Updates; channels.updatePinnedForumTopic#6c2d9026 channel:InputChannel topic_id:int pinned:Bool = Updates; channels.deleteTopicHistory#34435f2d channel:InputChannel top_msg_id:int = messages.AffectedHistory; channels.reorderPinnedForumTopics#2950a18f flags:# force:flags.0?true channel:InputChannel order:Vector<int> = Updates; channels.toggleAntiSpam#68f3e4eb channel:InputChannel enabled:Bool = Updates; channels.reportAntiSpamFalsePositive#a850a693 channel:InputChannel msg_id:int = Bool; channels.toggleParticipantsHidden#6a6e7854 channel:InputChannel enabled:Bool = Updates; bots.sendCustomRequest#aa2769ed custom_method:string params:DataJSON = DataJSON; bots.answerWebhookJSONQuery#e6213f4d query_id:long data:DataJSON = Bool; bots.setBotCommands#517165a scope:BotCommandScope lang_code:string commands:Vector<BotCommand> = Bool; bots.resetBotCommands#3d8de0f9 scope:BotCommandScope lang_code:string = Bool; bots.getBotCommands#e34c0dd6 scope:BotCommandScope lang_code:string = Vector<BotCommand>; bots.setBotMenuButton#4504d54f user_id:InputUser button:BotMenuButton = Bool; bots.getBotMenuButton#9c60eb28 user_id:InputUser = BotMenuButton; bots.setBotBroadcastDefaultAdminRights#788464e1 admin_rights:ChatAdminRights = Bool; bots.setBotGroupDefaultAdminRights#925ec9ea admin_rights:ChatAdminRights = Bool; payments.getPaymentForm#37148dbb flags:# invoice:InputInvoice theme_params:flags.0?DataJSON = payments.PaymentForm; payments.getPaymentReceipt#2478d1cc peer:InputPeer msg_id:int = payments.PaymentReceipt; payments.validateRequestedInfo#b6c8f12b flags:# save:flags.0?true invoice:InputInvoice info:PaymentRequestedInfo = payments.ValidatedRequestedInfo; payments.sendPaymentForm#2d03522f flags:# form_id:long invoice:InputInvoice requested_info_id:flags.0?string shipping_option_id:flags.1?string credentials:InputPaymentCredentials tip_amount:flags.2?long = payments.PaymentResult; payments.getSavedInfo#227d824b = payments.SavedInfo; payments.clearSavedInfo#d83d70c1 flags:# credentials:flags.0?true info:flags.1?true = Bool; payments.getBankCardData#2e79d779 number:string = payments.BankCardData; payments.exportInvoice#f91b065 invoice_media:InputMedia = payments.ExportedInvoice; payments.assignAppStoreTransaction#80ed747d receipt:bytes purpose:InputStorePaymentPurpose = Updates; payments.assignPlayMarketTransaction#dffd50d3 receipt:DataJSON purpose:InputStorePaymentPurpose = Updates; payments.canPurchasePremium#9fc19eb6 purpose:InputStorePaymentPurpose = Bool; stickers.createStickerSet#9021ab67 flags:# masks:flags.0?true animated:flags.1?true videos:flags.4?true user_id:InputUser title:string short_name:string thumb:flags.2?InputDocument stickers:Vector<InputStickerSetItem> software:flags.3?string = messages.StickerSet; stickers.removeStickerFromSet#f7760f51 sticker:InputDocument = messages.StickerSet; stickers.changeStickerPosition#ffb6d4ca sticker:InputDocument position:int = messages.StickerSet; stickers.addStickerToSet#8653febe stickerset:InputStickerSet sticker:InputStickerSetItem = messages.StickerSet; stickers.setStickerSetThumb#9a364e30 stickerset:InputStickerSet thumb:InputDocument = messages.StickerSet; stickers.checkShortName#284b3639 short_name:string = Bool; stickers.suggestShortName#4dafc503 title:string = stickers.SuggestedShortName; phone.getCallConfig#55451fa9 = DataJSON; phone.requestCall#42ff96ed flags:# video:flags.0?true user_id:InputUser random_id:int g_a_hash:bytes protocol:PhoneCallProtocol = phone.PhoneCall; phone.acceptCall#3bd2b4a0 peer:InputPhoneCall g_b:bytes protocol:PhoneCallProtocol = phone.PhoneCall; phone.confirmCall#2efe1722 peer:InputPhoneCall g_a:bytes key_fingerprint:long protocol:PhoneCallProtocol = phone.PhoneCall; phone.receivedCall#17d54f61 peer:InputPhoneCall = Bool; phone.discardCall#b2cbc1c0 flags:# video:flags.0?true peer:InputPhoneCall duration:int reason:PhoneCallDiscardReason connection_id:long = Updates; phone.setCallRating#59ead627 flags:# user_initiative:flags.0?true peer:InputPhoneCall rating:int comment:string = Updates; phone.saveCallDebug#277add7e peer:InputPhoneCall debug:DataJSON = Bool; phone.sendSignalingData#ff7a9383 peer:InputPhoneCall data:bytes = Bool; phone.createGroupCall#48cdc6d8 flags:# rtmp_stream:flags.2?true peer:InputPeer random_id:int title:flags.0?string schedule_date:flags.1?int = Updates; phone.joinGroupCall#b132ff7b flags:# muted:flags.0?true video_stopped:flags.2?true call:InputGroupCall join_as:InputPeer invite_hash:flags.1?string params:DataJSON = Updates; phone.leaveGroupCall#500377f9 call:InputGroupCall source:int = Updates; phone.inviteToGroupCall#7b393160 call:InputGroupCall users:Vector<InputUser> = Updates; phone.discardGroupCall#7a777135 call:InputGroupCall = Updates; phone.toggleGroupCallSettings#74bbb43d flags:# reset_invite_hash:flags.1?true call:InputGroupCall join_muted:flags.0?Bool = Updates; phone.getGroupCall#41845db call:InputGroupCall limit:int = phone.GroupCall; phone.getGroupParticipants#c558d8ab call:InputGroupCall ids:Vector<InputPeer> sources:Vector<int> offset:string limit:int = phone.GroupParticipants; phone.checkGroupCall#b59cf977 call:InputGroupCall sources:Vector<int> = Vector<int>; phone.toggleGroupCallRecord#f128c708 flags:# start:flags.0?true video:flags.2?true call:InputGroupCall title:flags.1?string video_portrait:flags.2?Bool = Updates; phone.editGroupCallParticipant#a5273abf flags:# call:InputGroupCall participant:InputPeer muted:flags.0?Bool volume:flags.1?int raise_hand:flags.2?Bool video_stopped:flags.3?Bool video_paused:flags.4?Bool presentation_paused:flags.5?Bool = Updates; phone.editGroupCallTitle#1ca6ac0a call:InputGroupCall title:string = Updates; phone.getGroupCallJoinAs#ef7c213a peer:InputPeer = phone.JoinAsPeers; phone.exportGroupCallInvite#e6aa647f flags:# can_self_unmute:flags.0?true call:InputGroupCall = phone.ExportedGroupCallInvite; phone.toggleGroupCallStartSubscription#219c34e6 call:InputGroupCall subscribed:Bool = Updates; phone.startScheduledGroupCall#5680e342 call:InputGroupCall = Updates; phone.saveDefaultGroupCallJoinAs#575e1f8c peer:InputPeer join_as:InputPeer = Bool; phone.joinGroupCallPresentation#cbea6bc4 call:InputGroupCall params:DataJSON = Updates; phone.leaveGroupCallPresentation#1c50d144 call:InputGroupCall = Updates; phone.getGroupCallStreamChannels#1ab21940 call:InputGroupCall = phone.GroupCallStreamChannels; phone.getGroupCallStreamRtmpUrl#deb3abbf peer:InputPeer revoke:Bool = phone.GroupCallStreamRtmpUrl; phone.saveCallLog#41248786 peer:InputPhoneCall file:InputFile = Bool; langpack.getLangPack#f2f2330a lang_pack:string lang_code:string = LangPackDifference; langpack.getStrings#efea3803 lang_pack:string lang_code:string keys:Vector<string> = Vector<LangPackString>; langpack.getDifference#cd984aa5 lang_pack:string lang_code:string from_version:int = LangPackDifference; langpack.getLanguages#42c6978f lang_pack:string = Vector<LangPackLanguage>; langpack.getLanguage#6a596502 lang_pack:string lang_code:string = LangPackLanguage; folders.editPeerFolders#6847d0ab folder_peers:Vector<InputFolderPeer> = Updates; folders.deleteFolder#1c295881 folder_id:int = Updates; stats.getBroadcastStats#ab42441a flags:# dark:flags.0?true channel:InputChannel = stats.BroadcastStats; stats.loadAsyncGraph#621d5fa0 flags:# token:string x:flags.0?long = StatsGraph; stats.getMegagroupStats#dcdf8607 flags:# dark:flags.0?true channel:InputChannel = stats.MegagroupStats; stats.getMessagePublicForwards#5630281b channel:InputChannel msg_id:int offset_rate:int offset_peer:InputPeer offset_id:int limit:int = messages.Messages; stats.getMessageStats#b6e0a3f5 flags:# dark:flags.0?true channel:InputChannel msg_id:int = stats.MessageStats; // LAYER 151 <?php /** * TL callback module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL; /** * Interface for managing TL serialization callbacks. */ interface TLCallback { /** * Called after serializing a method. * * @internal * * @var int */ const METHOD_CALLBACK = 0; /** * Called before serializing a method. * * @internal * * @var int */ const METHOD_BEFORE_CALLBACK = 1; /** * Called after serializing a constructor. * * @internal * * @var int */ const CONSTRUCTOR_CALLBACK = 2; /** * Called before serializing a constructor. * * @internal * * @var int */ const CONSTRUCTOR_BEFORE_CALLBACK = 3; /** * Called on constructor serialization. * * @internal * * @var int */ const CONSTRUCTOR_SERIALIZE_CALLBACK = 4; /** * Called if objects of the specified type cannot be serialized. * * @internal * * @var int */ const TYPE_MISMATCH_CALLBACK = 5; /** * Called after serialization of method. * * Pass the method name and arguments * */ public function getMethodCallbacks(): array; /** * Called right before serialization of method starts. * * Pass the method name * */ public function getMethodBeforeCallbacks(): array; /** * Called right after deserialization of object, passing the final object. * */ public function getConstructorCallbacks(): array; /** * Called right before deserialization of object. * * Pass only the constructor name * */ public function getConstructorBeforeCallbacks(): array; /** * Called right before serialization of constructor. * * Passed the object, will return a modified version. * */ public function getConstructorSerializeCallbacks(): array; /** * Called if objects of the specified type cannot be serialized. * * Passed the unserializable object, * will try to convert it to an object of the proper type. * */ public function getTypeMismatchCallbacks(): array; } <?php /** * TLMethods module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL; class TLMethods { use \danog\Serializable; use TLParams; public $by_id = []; public $by_method = []; public $method_namespace = []; public function __sleep(): array { return ['by_id', 'by_method', 'method_namespace']; } public function add(array $json_dict): void { $this->by_id[$json_dict['id']] = ['method' => $json_dict['method'], 'type' => $json_dict['type'], 'params' => $json_dict['params']]; $this->by_method[$json_dict['method']] = $json_dict['id']; $namespace = \explode('.', $json_dict['method']); if (isset($namespace[1])) { $this->method_namespace[] = [$namespace[0] => $namespace[1]]; } $this->parseParams($json_dict['id']); } public function findById(string $id) { if (isset($this->by_id[$id])) { $method = $this->by_id[$id]; $method['id'] = $id; return $method; } return false; } public function findByMethod(string $method_name) { if (isset($this->by_method[$method_name])) { $method = $this->by_id[$this->by_method[$method_name]]; $method['id'] = $this->by_method[$method_name]; return $method; } return false; } } <?php /** * TLConstructors module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL; class TLConstructors { use \danog\Serializable; use TLParams; public $by_id = []; public $by_predicate_and_layer = []; public $layers = []; public function __sleep() { return ['by_predicate_and_layer', 'by_id', 'layers']; } public function add(array $json_dict, string $scheme_type): void { if (isset($this->by_id[$json_dict['id']]) && (!isset($this->by_id[$json_dict['id']]['layer']) || $this->by_id[$json_dict['id']]['layer'] > $json_dict['layer'])) { return; } $predicate = (string) (($scheme_type === 'mtproto' && $json_dict['predicate'] === 'message' ? 'MT' : '').$json_dict['predicate']); $this->by_id[$json_dict['id']] = ['predicate' => $predicate, 'params' => $json_dict['params'], 'type' => ($scheme_type === 'mtproto' && $json_dict['type'] === 'Message' ? 'MT' : '').$json_dict['type']]; if ($scheme_type === 'secret') { $this->by_id[$json_dict['id']]['layer'] = $json_dict['layer']; $this->layers[$json_dict['layer']] = $json_dict['layer']; \ksort($this->layers); } else { $json_dict['layer'] = ''; } $this->by_predicate_and_layer[$predicate.$json_dict['layer']] = $json_dict['id']; $this->parseParams($json_dict['id'], $scheme_type === 'mtproto'); } public function findByType(string $type) { foreach ($this->by_id as $id => $constructor) { if ($constructor['type'] === $type) { $constructor['id'] = $id; return $constructor; } } return false; } public function findByPredicate(string $predicate, int $layer = -1) { if ($layer !== -1) { $chosenid = null; foreach ($this->layers as $alayer) { if ($alayer <= $layer) { if (isset($this->by_predicate_and_layer[$predicate.$alayer])) { $chosenid = $this->by_predicate_and_layer[$predicate.$alayer]; } } elseif (!isset($chosenid)) { $chosenid = $this->by_predicate_and_layer[$predicate.$alayer]; } } if (!isset($chosenid)) { return $this->findByPredicate($predicate); } $constructor = $this->by_id[$chosenid]; $constructor['id'] = $chosenid; return $constructor; } if (isset($this->by_predicate_and_layer[$predicate])) { $constructor = $this->by_id[$this->by_predicate_and_layer[$predicate]]; $constructor['id'] = $this->by_predicate_and_layer[$predicate]; return $constructor; } return false; } /** * Find constructor by ID. * * @param string $id Constructor ID * * @return array|false */ public function findById(string $id) { if (isset($this->by_id[$id])) { $constructor = $this->by_id[$id]; $constructor['id'] = $id; return $constructor; } return false; } } <?php /** * PrettyException module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL; /** * Handle async stack traces. */ trait PrettyException { /** * TL trace. * * @var string */ public $tlTrace = ''; /** * Method name. * * @var string */ private $method = ''; /** * Whether the TL trace was updated. * * @var boolean */ private $updated = false; /** * Update TL trace. * * */ public function updateTLTrace(array $trace): void { if (!$this->updated) { $this->updated = true; $this->prettifyTL($this->method, $trace); } } /** * Get TL trace. * */ public function getTLTrace(): string { return $this->tlTrace; } /** * Set TL trace. * * @param string $tlTrace TL trace * */ public function setTLTrace(string $tlTrace): void { $this->tlTrace = $tlTrace; } /** * Generate async trace. * * @param string $init Method name * @param array $trace Async trace * */ public function prettifyTL(string $init = '', array $trace = null): void { $this->method = $init; $previous_trace = $this->tlTrace; $this->tlTrace = ''; $eol = PHP_EOL; if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg') { $eol = '<br>'.PHP_EOL; } $tl = false; foreach (\array_reverse($trace ?? $this->getTrace()) as $k => $frame) { if (isset($frame['function']) && \in_array($frame['function'], ['serializeParams', 'serializeObject'])) { if (($frame['args'][2] ?? '') !== '') { $this->tlTrace .= $tl ? "['".$frame['args'][2]."']" : "While serializing: \t".$frame['args'][2]; $tl = true; } } else { if ($tl) { $this->tlTrace .= $eol; } if (isset($frame['function']) && ($frame['function'] === 'handle_rpc_error' && $k === \count($this->getTrace()) - 1) || $frame['function'] === 'unserialize') { continue; } $this->tlTrace .= isset($frame['file']) ? \str_pad(\basename($frame['file']).'('.$frame['line'].'):', 20)."\t" : ''; $this->tlTrace .= isset($frame['function']) ? $frame['function'].'(' : ''; $this->tlTrace .= isset($frame['args']) ? \substr(\json_encode($frame['args']), 1, -1) : ''; $this->tlTrace .= ')'; $this->tlTrace .= $eol; $tl = false; } } $this->tlTrace .= $init !== '' ? "['".$init."']" : ''; $this->tlTrace = \implode($eol, \array_reverse(\explode($eol, $this->tlTrace))); if ($previous_trace) { $this->tlTrace .= $eol.$eol; $this->tlTrace .= "Previous TL trace:{$eol}"; $this->tlTrace .= $previous_trace; } } } <?php /** * TL module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL; use Amp\Promise; use danog\MadelineProto\MTProto; use danog\MadelineProto\MTProto\OutgoingMessage; use danog\MadelineProto\Settings\TLSchema; use danog\MadelineProto\TL\Types\Button; use danog\MadelineProto\Tools; /** * TL serialization. */ class TL { /** * Highest available secret chat layer version. * * @var integer */ private $secretLayer = -1; /** * Constructors. * * @var TLConstructors */ private $constructors; /** * Methods. * * @var TLMethods */ private $methods; /** * TD Constructors. * * @var TLConstructors */ private $tdConstructors; /** * TD Methods. * * @var TLMethods */ private $tdMethods; /** * Descriptions. * * @var array */ private $tdDescriptions; /** * TL callbacks. * * @var array */ private $callbacks = []; /** * API instance. * * @var \danog\MadelineProto\MTProto */ private $API; /** * Constructor function. * * @param MTProto $API API instance */ public function __construct($API = null) { $this->API = $API; } /** * Get secret chat layer version. * * @return integer */ public function getSecretLayer(): int { return $this->secretLayer; } /** * Get constructors. * * */ public function getConstructors(bool $td = false): TLConstructors { return $td ? $this->tdConstructors : $this->constructors; } /** * Get methods. * * */ public function getMethods(bool $td = false): TLMethods { return $td ? $this->tdMethods : $this->methods; } /** * Get TL descriptions. * */ public function &getDescriptions(): array { return $this->tdDescriptions; } /** * Initialize TL parser. * * @param TLSchema $files Scheme files * @param TLCallback[] $objects TL Callback objects * */ public function init(TLSchema $files, array $objects = []): void { $this->API->logger->logger(\danog\MadelineProto\Lang::$current_lang['TL_loading'], \danog\MadelineProto\Logger::VERBOSE); $this->updateCallbacks($objects); $this->constructors = new TLConstructors(); $this->methods = new TLMethods(); $this->tdConstructors = new TLConstructors(); $this->tdMethods = new TLMethods(); $this->tdDescriptions = ['types' => [], 'constructors' => [], 'methods' => []]; foreach (\array_filter([ 'api' => $files->getAPISchema(), 'mtproto' => $files->getMTProtoSchema(), 'secret' => $files->getSecretSchema(), ...$files->getOther() ]) as $scheme_type => $file) { $this->API->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['file_parsing'], \basename($file)), \danog\MadelineProto\Logger::VERBOSE); $filec = \file_get_contents(Tools::absolute($file)); $TL_dict = \json_decode($filec, true); if ($TL_dict === null) { $TL_dict = ['methods' => [], 'constructors' => []]; $type = 'constructors'; $layer = null; $tl_file = \explode("\n", $filec); $key = 0; $e = null; $class = null; $dparams = []; $lineBuf = ''; foreach ($tl_file as $line) { $line = \rtrim($line); if (\preg_match('|^//@|', $line)) { $list = \explode(' @', \str_replace('//', ' ', $line)); foreach ($list as $elem) { if ($elem === '') { continue; } $elem = \explode(' ', $elem, 2); if ($elem[0] === 'class') { $elem = \explode(' ', $elem[1], 2); $class = $elem[0]; continue; } if ($elem[0] === 'description') { if (!\is_null($class)) { $this->tdDescriptions['types'][$class] = $elem[1]; $class = null; } else { $e = $elem[1]; } continue; } if ($elem[0] === 'param_description') { $elem[0] = 'description'; } $dparams[$elem[0]] = $elem[1]; } continue; } $line = \preg_replace(['|//.*|', '|^\\s+$|'], '', $line); if ($line === '') { continue; } if ($line === '---functions---') { $type = 'methods'; continue; } if ($line === '---types---') { $type = 'constructors'; continue; } if (\preg_match('|^===(\\d*)===|', $line, $matches)) { $layer = (int) $matches[1]; continue; } if (\strpos($line, 'vector#') === 0) { continue; } if (\strpos($line, ' ?= ') !== false) { continue; } $line = \preg_replace(['/[(]([\\w\\.]+) ([\\w\\.]+)[)]/', '/\\s+/'], ['$1<$2>', ' '], $line); if (\strpos($line, ';') === false) { $lineBuf .= $line; continue; } elseif ($lineBuf) { $lineBuf .= $line; $line = $lineBuf; $lineBuf = ''; } $name = \preg_replace(['/#.*/', '/\\s.*/'], '', $line); if (\in_array($name, ['bytes', 'int128', 'int256', 'int512', 'int', 'long', 'double', 'string', 'bytes', 'object', 'function'])) { /*if (!(\in_array($scheme_type, ['ton_api', 'lite_api']) && $name === 'bytes')) { continue; }*/ continue; } if (\in_array($scheme_type, ['ton_api', 'lite_api'])) { $clean = \preg_replace(['/;/', '/#[a-f0-9]+ /', '/ [a-zA-Z0-9_]+\\:flags\\.[0-9]+\\?true/', '/[<]/', '/[>]/', '/ /', '/^ /', '/ $/', '/{/', '/}/'], ['', ' ', '', ' ', ' ', ' ', '', '', '', ''], $line); } else { $clean = \preg_replace(['/:bytes /', '/;/', '/#[a-f0-9]+ /', '/ [a-zA-Z0-9_]+\\:flags\\.[0-9]+\\?true/', '/[<]/', '/[>]/', '/ /', '/^ /', '/ $/', '/\\?bytes /', '/{/', '/}/'], [':string ', '', ' ', '', ' ', ' ', ' ', '', '', '?string ', '', ''], $line); } $id = \hash('crc32b', $clean); if (\preg_match('/^[^\\s]+#([a-f0-9]*)/i', $line, $matches)) { $nid = \str_pad($matches[1], 8, '0', \STR_PAD_LEFT); if ($id !== $nid) { $this->API->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['crc32_mismatch'], $id, $nid, $line), \danog\MadelineProto\Logger::ERROR); } $id = $nid; } if (!\is_null($e)) { $this->tdDescriptions[$type][$name] = ['description' => $e, 'params' => $dparams]; $e = null; $dparams = []; } $TL_dict[$type][$key][$type === 'constructors' ? 'predicate' : 'method'] = $name; $TL_dict[$type][$key]['id'] = $a = \strrev(\hex2bin($id)); $TL_dict[$type][$key]['params'] = []; $TL_dict[$type][$key]['type'] = \preg_replace(['/.+\\s+=\\s+/', '/;/'], '', $line); if ($layer !== null) { $TL_dict[$type][$key]['layer'] = $layer; } if ($name !== 'vector' && $TL_dict[$type][$key]['type'] !== 'Vector t') { foreach (\explode(' ', \preg_replace(['/^[^\\s]+\\s/', '/=\\s[^\\s]+/', '/\\s$/'], '', $line)) as $param) { if ($param === '') { continue; } if ($param[0] === '{') { continue; } if ($param === '#') { continue; } $explode = \explode(':', $param); $TL_dict[$type][$key]['params'][] = ['name' => $explode[0], 'type' => $explode[1]]; } } $key++; } } else { foreach ($TL_dict['constructors'] as $key => $value) { $TL_dict['constructors'][$key]['id'] = \danog\MadelineProto\Tools::packSignedInt($TL_dict['constructors'][$key]['id']); } foreach ($TL_dict['methods'] as $key => $value) { $TL_dict['methods'][$key]['id'] = \danog\MadelineProto\Tools::packSignedInt($TL_dict['methods'][$key]['id']); } } if (empty($TL_dict) || empty($TL_dict['constructors']) || !isset($TL_dict['methods'])) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['src_file_invalid'].$file); } $this->API->logger->logger(\danog\MadelineProto\Lang::$current_lang['translating_obj'], \danog\MadelineProto\Logger::ULTRA_VERBOSE); foreach ($TL_dict['constructors'] as $elem) { if ($scheme_type === 'secret') { $this->secretLayer = \max($this->secretLayer, $elem['layer']); } $this->{$scheme_type === 'td' ? 'tdConstructors' : 'constructors'}->add($elem, $scheme_type); } $this->API->logger->logger(\danog\MadelineProto\Lang::$current_lang['translating_methods'], \danog\MadelineProto\Logger::ULTRA_VERBOSE); foreach ($TL_dict['methods'] as $elem) { $this->{$scheme_type === 'td' ? 'tdMethods' : 'methods'}->add($elem); if ($scheme_type === 'secret') { $this->secretLayer = \max($this->secretLayer, $elem['layer']); } } } if (isset($files->getOther()['td'])) { foreach ($this->tdConstructors->by_id as $id => $data) { $name = $data['predicate']; if ($this->constructors->findById($id) === false) { unset($this->tdDescriptions['constructors'][$name]); } else { if (!\count($this->tdDescriptions['constructors'][$name]['params'])) { continue; } foreach ($this->tdDescriptions['constructors'][$name]['params'] as $k => $param) { $this->tdDescriptions['constructors'][$name]['params'][$k] = \str_replace('nullable', 'optional', $param); } } } foreach ($this->tdMethods->by_id as $id => $data) { $name = $data['method']; if ($this->methods->findById($id) === false) { unset($this->tdDescriptions['methods'][$name]); } else { foreach ($this->tdDescriptions['methods'][$name]['params'] as $k => $param) { $this->tdDescriptions['constructors'][$name]['params'][$k] = \str_replace('nullable', 'optional', $param); } } } } $files->upgrade(); } /** * Get TL namespaces. * */ public function getMethodNamespaces(): array { $res = []; foreach ($this->methods->method_namespace as $pair) { $a = \key($pair); $res[$a] = $a; } return $res; } /** * Get namespaced methods (method => namespace). * */ public function getMethodsNamespaced(): array { return $this->methods->method_namespace; } /** * Update TL callbacks. * * @param TLCallback[] $objects TL callbacks * */ public function updateCallbacks(array $objects): void { $this->callbacks = []; foreach ($objects as $object) { if (!isset(\class_implements(\get_class($object))[TLCallback::class])) { throw new Exception('Invalid callback object provided!'); } $new = [TLCallback::METHOD_BEFORE_CALLBACK => $object->getMethodBeforeCallbacks(), TLCallback::METHOD_CALLBACK => $object->getMethodCallbacks(), TLCallback::CONSTRUCTOR_BEFORE_CALLBACK => $object->getConstructorBeforeCallbacks(), TLCallback::CONSTRUCTOR_CALLBACK => $object->getConstructorCallbacks(), TLCallback::CONSTRUCTOR_SERIALIZE_CALLBACK => $object->getConstructorSerializeCallbacks(), TLCallback::TYPE_MISMATCH_CALLBACK => $object->getTypeMismatchCallbacks()]; foreach ($new as $type => $values) { foreach ($values as $match => $callback) { if (!isset($this->callbacks[$type][$match])) { $this->callbacks[$type][$match] = []; } if (\in_array($type, [TLCallback::TYPE_MISMATCH_CALLBACK, TLCallback::CONSTRUCTOR_SERIALIZE_CALLBACK])) { $this->callbacks[$type][$match] = $callback; } else { $this->callbacks[$type][$match] = \array_merge($callback, $this->callbacks[$type][$match]); } } } } } /** * Deserialize bool. * * @param string $id Constructor ID * */ private function deserializeBool(string $id): bool { $tl_elem = $this->constructors->findById($id); if ($tl_elem === false) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['bool_error']); } return $tl_elem['predicate'] === 'boolTrue'; } /** * Serialize TL object. * * @param array $type TL type definition * @param mixed $object Object to serialize * @param string $ctx Context * @param integer $layer Layer version * * * @psalm-return \Generator<int|mixed, array|mixed, mixed, false|mixed|null|string> */ public function serializeObject(array $type, $object, $ctx, int $layer = -1): \Generator { if ($object instanceof \Generator) { $object = yield from $object; } switch ($type['type']) { case 'int': if (!\is_numeric($object)) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['not_numeric']); } return \danog\MadelineProto\Tools::packSignedInt($object); case '#': if (!\is_numeric($object)) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['not_numeric']); } return \danog\MadelineProto\Tools::packUnsignedInt($object); case 'long': if (\is_object($object)) { return \str_pad(\strrev($object->toBytes()), 8, \chr(0)); } if (\is_string($object) && \strlen($object) === 8) { return $object; } if (\is_string($object) && \strlen($object) === 9 && $object[0] === 'a') { return \substr($object, 1); } if (\is_array($object) && $type['name'] === 'hash') { return \danog\MadelineProto\Tools::genVectorHash($object); } if (\is_array($object) && \count($object) === 2) { return \pack('l2', ...$object); // For bot API on 32bit } if (!\is_numeric($object)) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['not_numeric']); } return \danog\MadelineProto\Tools::packSignedLong($object); case 'int128': if (\strlen($object) !== 16) { $object = \base64_decode($object); if (\strlen($object) !== 16) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['long_not_16']); } } return (string) $object; case 'int256': if (\strlen($object) !== 32) { $object = \base64_decode($object); if (\strlen($object) !== 32) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['long_not_32']); } } return (string) $object; case 'int512': if (\strlen($object) !== 64) { $object = \base64_decode($object); if (\strlen($object) !== 64) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['long_not_64']); } } return (string) $object; case 'double': return \danog\MadelineProto\Tools::packDouble($object); case 'string': if (!\is_string($object)) { throw new Exception("You didn't provide a valid string"); } //$object = \pack('C*', ...\unpack('C*', $object)); $l = \strlen($object); $concat = ''; if ($l <= 253) { $concat .= \chr($l); $concat .= $object; $concat .= \pack('@'.\danog\MadelineProto\Tools::posmod(-$l - 1, 4)); } else { $concat .= \chr(254); $concat .= \substr(\danog\MadelineProto\Tools::packSignedInt($l), 0, 3); $concat .= $object; $concat .= \pack('@'.\danog\MadelineProto\Tools::posmod(-$l, 4)); } return $concat; case 'bytes': if (\is_array($object) && isset($object['_']) && $object['_'] === 'bytes') { $object = \base64_decode($object['bytes']); } if (!\is_string($object) && !$object instanceof \danog\MadelineProto\TL\Types\Bytes) { throw new Exception("You didn't provide a valid string"); } $l = \strlen($object); $concat = ''; if ($l <= 253) { $concat .= \chr($l); $concat .= $object; $concat .= \pack('@'.\danog\MadelineProto\Tools::posmod(-$l - 1, 4)); } else { $concat .= \chr(254); $concat .= \substr(\danog\MadelineProto\Tools::packSignedInt($l), 0, 3); $concat .= $object; $concat .= \pack('@'.\danog\MadelineProto\Tools::posmod(-$l, 4)); } return $concat; case 'Bool': return $this->constructors->findByPredicate((bool) $object ? 'boolTrue' : 'boolFalse')['id']; case 'true': return; case '!X': return $object; case 'Vector t': if (!\is_array($object)) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['array_invalid']); } if (isset($object['_'])) { throw new Exception('You must provide an array of '.$type['subtype'].' objects, not a '.$type['subtype']." object. Example: [['_' => ".$type['subtype'].', ... ]]'); } $concat = $this->constructors->findByPredicate('vector')['id']; $concat .= \danog\MadelineProto\Tools::packUnsignedInt(\count($object)); foreach ($object as $k => $current_object) { $concat .= (yield from $this->serializeObject(['type' => $type['subtype']], $current_object, $k, $layer)); } return $concat; case 'vector': if (!\is_array($object)) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['array_invalid']); } $concat = \danog\MadelineProto\Tools::packUnsignedInt(\count($object)); foreach ($object as $k => $current_object) { $concat .= (yield from $this->serializeObject(['type' => $type['subtype']], $current_object, $k, $layer)); } return $concat; case 'Object': if (\is_string($object)) { return $object; } } if ($type['type'] === 'InputMessage' && !\is_array($object)) { $object = ['_' => 'inputMessageID', 'id' => $object]; } elseif (isset($this->callbacks[TLCallback::TYPE_MISMATCH_CALLBACK][$type['type']]) && (!\is_array($object) || isset($object['_']) && $this->constructors->findByPredicate($object['_'])['type'] !== $type['type'])) { $object = $this->callbacks[TLCallback::TYPE_MISMATCH_CALLBACK][$type['type']]($object); $object = $object instanceof \Generator ? yield from $object : yield $object; if (!isset($object['_'])) { if (!isset($object[$type['type']])) { throw new \danog\MadelineProto\Exception("Could not convert {$type['type']} object"); } $object = $object[$type['type']]; } } if (!isset($object['_'])) { $constructorData = $this->constructors->findByPredicate($type['type'], $layer); if ($constructorData === false) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['predicate_not_set']); } $auto = true; $object['_'] = $constructorData['predicate']; } if (isset($this->callbacks[TLCallback::CONSTRUCTOR_SERIALIZE_CALLBACK][$object['_']])) { $object = yield $this->callbacks[TLCallback::CONSTRUCTOR_SERIALIZE_CALLBACK][$object['_']]($object); } $predicate = $object['_']; $constructorData = $this->constructors->findByPredicate($predicate, $layer); if ($constructorData === false) { $this->API->logger->logger($object, \danog\MadelineProto\Logger::FATAL_ERROR); throw new Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['type_extract_error'], $predicate)); } if ($bare = $type['type'] != '' && $type['type'][0] === '%') { $type['type'] = \substr($type['type'], 1); } if ($predicate === $type['type']) { $bare = true; } if ($predicate === 'messageEntityMentionName') { $constructorData = $this->constructors->findByPredicate('inputMessageEntityMentionName'); } $concat = $bare ? '' : $constructorData['id']; return $concat.(yield from $this->serializeParams($constructorData, $object, '', $layer, null)); } /** * Serialize method. * * @param string $method Method name * @param mixed $arguments Arguments * * * @psalm-return \Generator<int|mixed, Promise|Promise<\Amp\File\File>|Promise<\Amp\Ipc\Sync\ChannelledSocket>|Promise<int>|Promise<mixed>|Promise<null|string>|Promise<string>|\danog\MadelineProto\Stream\StreamInterface|array|int|mixed, mixed, string> */ public function serializeMethod(string $method, $arguments): \Generator { $tl = $this->methods->findByMethod($method); if ($tl === false) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['method_not_found'].$method); } return $tl['id'].(yield from $this->serializeParams($tl, $arguments, $method, -1, $arguments['queuePromise'] ?? null)); } /** * Serialize parameters. * * @param array $tl TL object definition * @param array $arguments Arguments * @param string $ctx Context * @param integer $layer Layer * * * @psalm-return \Generator<int|mixed, Promise|Promise<\Amp\File\File>|Promise<\Amp\Ipc\Sync\ChannelledSocket>|Promise<int>|Promise<mixed>|Promise<null|string>|\danog\MadelineProto\Stream\StreamInterface|array|int|mixed, mixed, string> */ private function serializeParams(array $tl, $arguments, $ctx, int $layer, $promise): \Generator { $serialized = ''; $arguments = $this->API->botAPIToMTProto($arguments instanceof Button ? $arguments->jsonSerialize() : $arguments); foreach ($tl['params'] as $cur_flag) { if (isset($cur_flag['pow'])) { $arguments[$cur_flag['flag']] ??= 0; switch ($cur_flag['type']) { case 'true': $arguments[$cur_flag['flag']] = isset($arguments[$cur_flag['name']]) && $arguments[$cur_flag['name']] ? $arguments[$cur_flag['flag']] | $cur_flag['pow'] : $arguments[$cur_flag['flag']] & ~$cur_flag['pow']; unset($arguments[$cur_flag['name']]); break; case 'Bool': $arguments[$cur_flag['name']] = isset($arguments[$cur_flag['name']]) && $arguments[$cur_flag['name']] && ($arguments[$cur_flag['flag']] & $cur_flag['pow']) != 0; if (($arguments[$cur_flag['flag']] & $cur_flag['pow']) === 0) { unset($arguments[$cur_flag['name']]); } break; default: $arguments[$cur_flag['flag']] = isset($arguments[$cur_flag['name']]) && $arguments[$cur_flag['name']] !== null ? $arguments[$cur_flag['flag']] | $cur_flag['pow'] : $arguments[$cur_flag['flag']] & ~$cur_flag['pow']; break; } } } foreach ($tl['params'] as $current_argument) { if (!isset($arguments[$current_argument['name']])) { if (isset($current_argument['pow']) && ($current_argument['type'] === 'true' || ($arguments[$current_argument['flag']] & $current_argument['pow']) === 0)) { //$this->API->logger->logger('Skipping '.$current_argument['name'].' of type '.$current_argument['type'); continue; } if ($current_argument['name'] === 'random_bytes') { $serialized .= yield from $this->serializeObject(['type' => 'bytes'], \danog\MadelineProto\Tools::random(15 + 4 * \danog\MadelineProto\Tools::randomInt($modulus = 3)), 'random_bytes'); continue; } if ($current_argument['name'] === 'data' && isset($tl['method']) && \in_array($tl['method'], ['messages.sendEncrypted', 'messages.sendEncryptedFile', 'messages.sendEncryptedService']) && isset($arguments['message'])) { $serialized .= yield from $this->serializeObject($current_argument, yield from $this->API->encryptSecretMessage($arguments['peer']['chat_id'], $arguments['message'], $promise), 'data'); continue; } if ($current_argument['name'] === 'random_id') { switch ($current_argument['type']) { case 'long': $serialized .= \danog\MadelineProto\Tools::random(8); continue 2; case 'int': $serialized .= \danog\MadelineProto\Tools::random(4); continue 2; case 'Vector t': if (isset($arguments['id'])) { $serialized .= $this->constructors->findByPredicate('vector')['id']; $serialized .= \danog\MadelineProto\Tools::packUnsignedInt(\count($arguments['id'])); $serialized .= \danog\MadelineProto\Tools::random(8 * \count($arguments['id'])); continue 2; } } } if ($current_argument['name'] === 'hash' && $current_argument['type'] === 'long') { $serialized .= \pack('@8'); continue; } if ($current_argument['name'] === 'hash' && $current_argument['type'] === 'int') { $serialized .= \pack('@4'); continue; } if ($current_argument['name'] === 'flags' && $current_argument['type'] === 'int') { $serialized .= \pack('@4'); continue; } if ($tl['type'] === 'InputMedia' && $current_argument['name'] === 'mime_type') { $serialized .= (yield from $this->serializeObject($current_argument, $arguments['file']['mime_type'], $current_argument['name'], $layer)); continue; } if ($tl['type'] === 'DocumentAttribute' && \in_array($current_argument['name'], ['w', 'h', 'duration'])) { $serialized .= \pack('@4'); continue; } if (\in_array($current_argument['type'], ['bytes', 'string', 'int'])) { $serialized .= \pack('@4'); continue; } if (($id = $this->constructors->findByPredicate(\lcfirst($current_argument['type']).'Empty', isset($tl['layer']) ? $tl['layer'] : -1)) && $id['type'] === $current_argument['type']) { $serialized .= $id['id']; continue; } if (($id = $this->constructors->findByPredicate('input'.$current_argument['type'].'Empty', isset($tl['layer']) ? $tl['layer'] : -1)) && $id['type'] === $current_argument['type']) { $serialized .= $id['id']; continue; } switch ($current_argument['type']) { case 'Vector t': case 'vector': $arguments[$current_argument['name']] = []; break; case 'DataJSON': case '%DataJSON': $arguments[$current_argument['name']] = null; break; default: throw new Exception("Missing required parameter ".$current_argument['name']); } } if (\in_array($current_argument['type'], ['DataJSON', '%DataJSON'])) { $arguments[$current_argument['name']] = ['_' => 'dataJSON', 'data' => \json_encode($arguments[$current_argument['name']])]; } if (isset($current_argument['subtype']) && \in_array($current_argument['subtype'], ['DataJSON', '%DataJSON'])) { \array_walk($arguments[$current_argument['name']], function (&$arg): void { $arg = ['_' => 'dataJSON', 'data' => \json_encode($arg)]; }); } if ($current_argument['type'] === 'InputFile' && (!\is_array($arguments[$current_argument['name']]) || !(isset($arguments[$current_argument['name']]['_']) && $this->constructors->findByPredicate($arguments[$current_argument['name']]['_'])['type'] === 'InputFile'))) { $arguments[$current_argument['name']] = (yield from $this->API->upload($arguments[$current_argument['name']])); } if ($current_argument['type'] === 'InputEncryptedChat' && (!\is_array($arguments[$current_argument['name']]) || isset($arguments[$current_argument['name']]['_']) && $this->constructors->findByPredicate($arguments[$current_argument['name']]['_'])['type'] !== $current_argument['type'])) { if (\is_array($arguments[$current_argument['name']])) { $arguments[$current_argument['name']] = (yield from $this->API->getInfo($arguments[$current_argument['name']]))['InputEncryptedChat']; } else { if (!$this->API->hasSecretChat($arguments[$current_argument['name']])) { throw new \danog\MadelineProto\Exception(\danog\MadelineProto\Lang::$current_lang['sec_peer_not_in_db']); } $arguments[$current_argument['name']] = $this->API->getSecretChat($arguments[$current_argument['name']])['InputEncryptedChat']; } } //$this->API->logger->logger('Serializing '.$current_argument['name'].' of type '.$current_argument['type'); $serialized .= (yield from $this->serializeObject($current_argument, $arguments[$current_argument['name']], $current_argument['name'], $layer)); } return $serialized; } /** * Get length of TL payload. * * @param resource|string $stream Stream * @param array $type Type identifier * */ public function getLength($stream, $type = ['type' => '']): int { if (\is_string($stream)) { $res = \fopen('php://memory', 'rw+b'); \fwrite($res, $stream); \fseek($res, 0); $stream = $res; } elseif (!\is_resource($stream)) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['stream_handle_invalid']); } $promises = []; $this->deserializeInternal($stream, $promises, $type); return \ftell($stream); } /** * Deserialize TL object. * * @param string|resource $stream Stream * @param array $type Type identifier * * @psalm-return array{0: mixed, 1: \Amp\Promise[]} */ public function deserialize($stream, $type = ['type' => '']): array { $promises = []; $result = $this->deserializeInternal($stream, $promises, $type); return [ $result, $promises ]; } /** * Deserialize TL object. * * @param string|resource $stream Stream * @param Promise[] &$promises Promise array * @param array $type Type identifier * */ private function deserializeInternal($stream, array &$promises, array $type) { if (\is_string($stream)) { $res = \fopen('php://memory', 'rw+b'); \fwrite($res, $stream); \fseek($res, 0); $stream = $res; } elseif (!\is_resource($stream)) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['stream_handle_invalid']); } switch ($type['type']) { case 'Bool': return $this->deserializeBool(\stream_get_contents($stream, 4)); case 'int': return \danog\MadelineProto\Tools::unpackSignedInt(\stream_get_contents($stream, 4)); case '#': return \unpack('V', \stream_get_contents($stream, 4))[1]; case 'long': if (isset($type['idstrlong'])) { return \stream_get_contents($stream, 8); } return isset($type['strlong']) ? \stream_get_contents($stream, 8) : \danog\MadelineProto\Tools::unpackSignedLong(\stream_get_contents($stream, 8)); case 'double': return \danog\MadelineProto\Tools::unpackDouble(\stream_get_contents($stream, 8)); case 'int128': return \stream_get_contents($stream, 16); case 'int256': return \stream_get_contents($stream, 32); case 'int512': return \stream_get_contents($stream, 64); case 'string': case 'bytes': $l = \ord(\stream_get_contents($stream, 1)); if ($l > 254) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['length_too_big']); } if ($l === 254) { $long_len = \unpack('V', \stream_get_contents($stream, 3).\chr(0))[1]; $x = \stream_get_contents($stream, $long_len); $resto = \danog\MadelineProto\Tools::posmod(-$long_len, 4); if ($resto > 0) { \stream_get_contents($stream, $resto); } } else { $x = $l ? \stream_get_contents($stream, $l) : ''; $resto = \danog\MadelineProto\Tools::posmod(-($l + 1), 4); if ($resto > 0) { \stream_get_contents($stream, $resto); } } if (!\is_string($x)) { throw new Exception("Generated value isn't a string"); } return $type['type'] === 'bytes' ? new Types\Bytes($x) : $x; case 'Vector t': $id = \stream_get_contents($stream, 4); $constructorData = $this->constructors->findById($id); if ($constructorData === false) { $constructorData = $this->methods->findById($id); $constructorData['predicate'] = 'method_'.$constructorData['method']; } if ($constructorData === false) { throw new Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['type_extract_error_id'], $type['type'], \bin2hex(\strrev($id)))); } switch ($constructorData['predicate']) { case 'gzip_packed': return $this->deserializeInternal( \gzdecode( $this->deserializeInternal( $stream, $promises, ['type' => 'bytes', 'connection' => $type['connection']] ) ), $promises, ['type' => '', 'connection' => $type['connection']] ); case 'Vector t': case 'vector': break; default: throw new Exception('Invalid vector constructor: '.$constructorData['predicate']); } // no break case 'vector': $count = \unpack('V', \stream_get_contents($stream, 4))[1]; $result = []; $type['type'] = $type['subtype']; for ($i = 0; $i < $count; $i++) { $result[] = $this->deserializeInternal($stream, $promises, $type); } return $result; } if ($type['type'] != '' && $type['type'][0] === '%') { $checkType = \substr($type['type'], 1); $constructorData = $this->constructors->findByType($checkType); if ($constructorData === false) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['constructor_not_found'].$checkType); } } else { $constructorData = $this->constructors->findByPredicate($type['type']); if ($constructorData === false) { $id = \stream_get_contents($stream, 4); $constructorData = $this->constructors->findById($id); if ($constructorData === false) { $constructorData = $this->methods->findById($id); if ($constructorData === false) { throw new Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['type_extract_error_id'], $type['type'], \bin2hex(\strrev($id)))); } $constructorData['predicate'] = 'method_'.$constructorData['method']; } } } if ($constructorData['predicate'] === 'gzip_packed') { if (!isset($type['subtype'])) { $type['subtype'] = ''; } return $this->deserializeInternal( \gzdecode( $this->deserializeInternal( $stream, $promises, ['type' => 'bytes'] ) ), $promises, ['type' => '', 'connection' => $type['connection'], 'subtype' => $type['subtype']] ); } if ($constructorData['type'] === 'Vector t') { $constructorData['connection'] = $type['connection']; $constructorData['subtype'] = $type['subtype'] ?? ''; $constructorData['type'] = 'vector'; return $this->deserializeInternal($stream, $promises, $constructorData); } if ($constructorData['predicate'] === 'boolTrue') { return true; } if ($constructorData['predicate'] === 'boolFalse') { return false; } $x = ['_' => $constructorData['predicate']]; if (isset($this->callbacks[TLCallback::CONSTRUCTOR_BEFORE_CALLBACK][$x['_']])) { foreach ($this->callbacks[TLCallback::CONSTRUCTOR_BEFORE_CALLBACK][$x['_']] as $callback) { $callback($x['_']); } } foreach ($constructorData['params'] as $arg) { if (isset($arg['pow'])) { switch ($arg['type']) { case 'true': $x[$arg['name']] = ($x[$arg['flag']] & $arg['pow']) !== 0; continue 2; case 'Bool': if (($x[$arg['flag']] & $arg['pow']) === 0) { $x[$arg['name']] = false; continue 2; } // no break default: if (($x[$arg['flag']] & $arg['pow']) === 0) { continue 2; } } } if (\in_array($arg['name'], ['msg_ids', 'msg_id', 'bad_msg_id', 'req_msg_id', 'answer_msg_id', 'first_msg_id'])) { $arg['idstrlong'] = true; } if (\in_array($arg['name'], ['key_fingerprint', 'server_salt', 'new_server_salt', 'server_public_key_fingerprints', 'ping_id', 'exchange_id'])) { $arg['strlong'] = true; } if (\in_array($arg['name'], ['peer_tag', 'file_token', 'cdn_key', 'cdn_iv'])) { $arg['type'] = 'string'; } if ($x['_'] === 'rpc_result' && $arg['name'] === 'result' && isset($type['connection']->outgoing_messages[$x['req_msg_id']])) { /** @var OutgoingMessage */ $message = $type['connection']->outgoing_messages[$x['req_msg_id']]; foreach ($this->callbacks[TLCallback::METHOD_BEFORE_CALLBACK][$message->getConstructor()] ?? [] as $callback) { $callback($type['connection']->outgoing_messages[$x['req_msg_id']]->getConstructor()); } if ($message->getType() && \stripos($message->getType(), '<') !== false) { $arg['subtype'] = \str_replace(['Vector<', '>'], '', $message->getType()); } } if (isset($type['connection'])) { $arg['connection'] = $type['connection']; } $x[$arg['name']] = $this->deserializeInternal($stream, $promises, $arg); if ($arg['name'] === 'random_bytes') { if (\strlen($x[$arg['name']]) < 15) { throw new \danog\MadelineProto\SecurityException(\danog\MadelineProto\Lang::$current_lang['rand_bytes_too_small']); } unset($x[$arg['name']]); } } if ($x['_'] === 'dataJSON') { return \json_decode($x['data'], true); } elseif ($constructorData['type'] === 'JSONValue') { switch ($x['_']) { case 'jsonNull': return; case 'jsonObject': $res = []; foreach ($x['value'] as $pair) { $res[$pair['key']] = $pair['value']; } return $res; default: return $x['value']; } } elseif ($x['_'] === 'photoStrippedSize') { $x['inflated'] = new Types\Bytes(Tools::inflateStripped($x['bytes'])); } if (isset($this->callbacks[TLCallback::CONSTRUCTOR_CALLBACK][$x['_']])) { foreach ($this->callbacks[TLCallback::CONSTRUCTOR_CALLBACK][$x['_']] as $callback) { $promise = \danog\MadelineProto\Tools::callFork($callback($x)); if ($promise instanceof Promise) { $promises []= $promise; } } } elseif ($x['_'] === 'rpc_result' && isset($type['connection']->outgoing_messages[$x['req_msg_id']]) && isset($this->callbacks[TLCallback::METHOD_CALLBACK][$type['connection']->outgoing_messages[$x['req_msg_id']]->getConstructor()])) { foreach ($this->callbacks[TLCallback::METHOD_CALLBACK][$type['connection']->outgoing_messages[$x['req_msg_id']]->getConstructor()] as $callback) { $callback($type['connection']->outgoing_messages[$x['req_msg_id']], $x['result']); } } if ($x['_'] === 'message' && isset($x['reply_markup']['rows'])) { foreach ($x['reply_markup']['rows'] as $key => $row) { foreach ($row['buttons'] as $bkey => $button) { $x['reply_markup']['rows'][$key]['buttons'][$bkey] = new Types\Button($this->API, $x, $button); } } } unset($x['flags'], $x['flags2']); return $x; } } <?php /** * Button module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL\Types; use danog\MadelineProto\API; use danog\MadelineProto\Ipc\Client; use danog\MadelineProto\MTProto; use danog\MadelineProto\Tools; /** * Clickable button. */ class Button implements \JsonSerializable, \ArrayAccess { /** * Button data. * * @psalm-var array<array-key, mixed> */ private array $button = []; /** * Session name. */ private string $session = ''; /** * MTProto instance. * * @var MTProto|Client|null */ private $API = null; /** * Message ID. */ private int $id; /** * Peer ID. * * @var array|int */ private $peer; /** * Constructor function. * * @param MTProto $API API instance * @param array $message Message * @param array $button Button info */ public function __construct(MTProto $API, array $message, array $button) { if (!isset($message['from_id']) // No other option // It's a channel/chat, 100% what we need || $message['peer_id']['_'] !== 'peerUser' // It is a user, and it's not ourselves || $message['peer_id']['user_id'] !== $API->authorization['user']['id'] ) { $this->peer = $message['peer_id']; } else { $this->peer = $message['from_id']; } $this->button = $button; $this->id = $message['id']; $this->API = $API; $this->session = $API->getWrapper()->getSession()->getLegacySessionPath(); } /** * Sleep function. * */ public function __sleep(): array { return ['button', 'peer', 'id', 'session']; } /** * Click on button. * * @param boolean $donotwait Whether to wait for the result of the method * */ public function click(bool $donotwait = true) { if (!isset($this->API)) { $this->API = Client::giveInstanceBySession($this->session); } $async = $this->API instanceof Client ? $this->API->async : $this->API->wrapper->isAsync(); switch ($this->button['_']) { default: return false; case 'keyboardButtonUrl': return $this->button['url']; case 'keyboardButton': $res = $this->API->clickInternal($donotwait, 'messages.sendMessage', ['peer' => $this->peer, 'message' => $this->button['text'], 'reply_to_msg_id' => $this->id]); break; case 'keyboardButtonCallback': $res = $this->API->clickInternal($donotwait, 'messages.getBotCallbackAnswer', ['peer' => $this->peer, 'msg_id' => $this->id, 'data' => $this->button['data']]); break; case 'keyboardButtonGame': $res = $this->API->clickInternal($donotwait, 'messages.getBotCallbackAnswer', ['peer' => $this->peer, 'msg_id' => $this->id, 'game' => true]); break; } return $async ? $res : Tools::wait($res); } /** * Get debug info. * */ public function __debugInfo(): array { $res = \get_object_vars($this); unset($res['API']); return $res; } /** * Serialize button. * */ public function jsonSerialize(): array { return $this->button; } /** * Set button info. * * @param mixed $name Offset * @param mixed $value Value * */ public function offsetSet(mixed $name, mixed $value): void { if ($name === null) { $this->button[] = $value; } else { $this->button[$name] = $value; } } /** * Get button info. * * @param mixed $name Field name * */ public function offsetGet(mixed $name): mixed { return $this->button[$name]; } /** * Unset button info. * * @param mixed $name Offset * */ public function offsetUnset(mixed $name): void { unset($this->button[$name]); } /** * Check if button field exists. * * @param mixed $name Offset * * @return boolean */ public function offsetExists(mixed $name): bool { return isset($this->button[$name]); } } <?php /** * Bytes module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL\Types; /** * Bytes wrapper. */ class Bytes implements \JsonSerializable, \ArrayAccess { /** * Bytes. * * @var string Bytes */ private string $bytes; /** * Constructor function. * * @param string $bytes Contents */ public function __construct(string $bytes) { $this->bytes = $bytes; } /** * Sleep function. * */ public function __sleep(): array { return ['bytes']; } /** * Cast bytes to string. * */ public function __toString(): string { return $this->bytes; } /** * Obtain values for JSON-encoding. * */ public function jsonSerialize(): array { return ['_' => 'bytes', 'bytes' => \base64_encode($this->bytes)]; } /** * Set char at offset. * * @param integer|null $offset Offset * @param string $value Char * */ public function offsetSet(mixed $offset, mixed $value): void { if ($offset === null) { $this->bytes .= $value; } else { $this->bytes[$offset] = $value; } } /** * Get char at offset. * * @param integer $offset Name * * @return string */ public function offsetGet(mixed $offset): mixed { return $this->bytes[$offset]; } /** * Unset char at offset. * * @param integer $offset Offset * */ public function offsetUnset(mixed $offset): void { unset($this->bytes[$offset]); } /** * Check if char at offset exists. * * @param integer $offset Offset * * @return boolean */ public function offsetExists(mixed $offset): bool { return isset($this->bytes[$offset]); } } <?php /** * BotAPIFiles module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL\Conversion; use danog\Decoder\FileId; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceDialogPhoto; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceLegacy; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceStickersetThumbnail; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceThumbnail; use danog\MadelineProto\API; use const danog\Decoder\ANIMATION; use const danog\Decoder\AUDIO; use const danog\Decoder\DOCUMENT; use const danog\Decoder\PHOTO; use const danog\Decoder\PHOTOSIZE_SOURCE_THUMBNAIL; use const danog\Decoder\PROFILE_PHOTO; use const danog\Decoder\STICKER; use const danog\Decoder\THUMBNAIL; use const danog\Decoder\VIDEO; use const danog\Decoder\VIDEO_NOTE; use const danog\Decoder\VOICE; trait BotAPIFiles { private function photosizeToBotAPI($photoSize, $photo, $thumbnail = false): array { $fileId = new FileId; $fileId->setId($photo['id'] ?? 0); $fileId->setAccessHash($photo['access_hash'] ?? 0); $fileId->setFileReference($photo['file_reference'] ?? ''); $fileId->setDcId($photo['dc_id'] ?? 0); if (isset($photoSize['location']['local_id'])) { $fileId->setLocalId($photoSize['location']['local_id']); $fileId->setVolumeId($photoSize['location']['volume_id']); } $photoSizeSource = new PhotoSizeSourceThumbnail(PHOTOSIZE_SOURCE_THUMBNAIL); $photoSizeSource->setThumbType($photoSize['type']); if ($photo['_'] === 'photo') { $photoSizeSource->setThumbFileType(PHOTO); $fileId->setType(PHOTO); } else { $photoSizeSource->setThumbFileType(THUMBNAIL); $fileId->setType(THUMBNAIL); } $fileId->setPhotoSizeSource($photoSizeSource); return [ 'file_id' => (string) $fileId, 'file_unique_id' => $fileId->getUniqueBotAPI(), 'width' => $photoSize['w'], 'height' => $photoSize['h'], 'file_size' => $photoSize['size'] ?? (isset($photoSize['sizes']) ? \end($photoSize['sizes']) : \strlen($photoSize['bytes'])), 'mime_type' => 'image/jpeg', 'file_name' => isset($photoSize['location']) ? $photoSize['location']['volume_id'].'_'.$photoSize['location']['local_id'].'.jpg' : $photo['id'].'.jpg' ]; } /** * Unpack bot API file ID. * * @param string $fileId Bot API file ID * * @return array Unpacked file ID */ public function unpackFileId(string $fileId): array { $fileId = FileId::fromBotAPI($fileId); $this->logger("Got file ID with version {$fileId->getVersion()}.{$fileId->getSubVersion()}"); if (!\in_array($fileId->getVersion(), [2, 4])) { throw new Exception("Invalid bot API file ID version {$fileId->getVersion()}"); } $photoSize = $fileId->hasPhotoSizeSource() ? $fileId->getPhotoSizeSource() : null; $res = null; switch ($fileId->getType()) { case PROFILE_PHOTO: /** * @var PhotoSizeSourceDialogPhoto $photoSize */ if ($photoSize->getDialogId() < 0) { $res['Chat'] = [ '_' => $photoSize->getDialogId() < -1000000000000 ? 'channel' : 'chat', 'id' => $photoSize->getDialogId() < -1000000000000 ? API::fromSupergroup($photoSize->getDialogId()) : -$photoSize->getDialogId(), 'access_hash' => $photoSize->getDialogAccessHash(), 'photo' => [ '_' => 'chatPhoto', 'dc_id' => $fileId->getDcId(), 'photo_id' => $fileId->getId(), ], 'min' => true ]; if ($fileId->hasVolumeId()) { $res['photo'][$photoSize->isSmallDialogPhoto() ? 'photo_small' : 'photo_big'] = [ '_' => 'fileLocationToBeDeprecated', 'volume_id' => $fileId->getVolumeId(), 'local_id' => $fileId->getLocalId() ]; } return $res; } $res['User'] = [ '_' => 'user', 'id' => $photoSize->getDialogId(), 'access_hash' => $photoSize->getDialogAccessHash(), 'photo' => [ '_' => 'userProfilePhoto', 'dc_id' => $fileId->getDcId(), 'photo_id' => $fileId->getId(), ], 'min' => true ]; if ($fileId->hasVolumeId()) { $res['photo'][$photoSize->isSmallDialogPhoto() ? 'photo_small' : 'photo_big'] = [ '_' => 'fileLocationToBeDeprecated', 'volume_id' => $fileId->getVolumeId(), 'local_id' => $fileId->getLocalId() ]; } return $res; case THUMBNAIL: /** * @var PhotoSizeSourceThumbnail $photoSize */ $res['InputFileLocation'] = [ '_' => $photoSize->getThumbFileType() === THUMBNAIL ? 'inputDocumentFileLocation' : 'inputPhotoFileLocation', 'id' => $fileId->getId(), 'access_hash' => $fileId->getAccessHash(), 'file_reference' => $fileId->getFileReference(), 'thumb_size' => $photoSize->getThumbType() ]; $res['name'] = $fileId->getId().'_'.$photoSize->getThumbType(); $res['ext'] = 'jpg'; $res['mime'] = 'image/jpeg'; $res['InputMedia'] = [ '_' => $photoSize->getThumbFileType() === THUMBNAIL ? 'inputMediaDocument' : 'inputMediaPhoto', 'id' => [ '_' => $photoSize->getThumbFileType() === THUMBNAIL ? 'inputDocument' : 'inputPhoto', 'id' => $fileId->getId(), 'access_hash' => $fileId->getAccessHash(), 'file_reference' => $fileId->getFileReference(), ] ]; if ($res['InputMedia']['id'] === 'inputPhoto') { $res['InputMedia']['id']['sizes'] = [ [ '_' => 'photoSize', 'type' => $photoSize->getThumbType(), ] ]; } return $res; case PHOTO: $constructor = [ '_' => 'photo', 'id' => $fileId->getId(), 'access_hash' => $fileId->getAccessHash(), 'file_reference' => $fileId->getFileReference(), 'dc_id' => $fileId->getDcId(), 'sizes' => [] ]; $constructor['sizes'][] = [ '_' => 'photoSize', 'type' => $photoSize instanceof PhotoSizeSourceThumbnail ? $photoSize->getThumbType() : '', 'location' => [ '_' => $photoSize instanceof PhotoSizeSourceLegacy ? 'fileLocation' : 'fileLocationToBeDeprecated', 'dc_id' => $fileId->getDcId(), 'local_id' => $fileId->hasLocalId() ? $fileId->getLocalId() : null, 'volume_id' => $fileId->hasVolumeId() ? $fileId->getVolumeId() : null, 'secret' => $photoSize instanceof PhotoSizeSourceLegacy ? $photoSize->getSecret() : '' ] ]; $res['MessageMedia'] = [ '_' => 'messageMediaPhoto', 'photo' => $constructor, 'caption' => '' ]; return $res; case VOICE: $attribute = [ '_' => 'documentAttributeAudio', 'voice' => true ]; break; case VIDEO: $attribute = [ '_' => 'documentAttributeVideo', 'round_message' => false ]; break; case DOCUMENT: $attribute = []; break; case STICKER: $attribute = [ '_' => 'documentAttributeSticker', 'alt' => '' ]; if ($photoSize instanceof PhotoSizeSourceStickersetThumbnail) { $attribute['stickerset'] = [ '_' => 'inputStickerSetID', 'id' => $photoSize->getStickerSetId(), 'access_hash' => $photoSize->getStickerSetAccessHash() ]; } break; case AUDIO: $attribute = ['_' => 'documentAttributeAudio', 'voice' => false]; break; case ANIMATION: $attribute = ['_' => 'documentAttributeAnimated']; break; case VIDEO_NOTE: $attribute = ['_' => 'documentAttributeVideo', 'round_message' => true]; break; default: throw new Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['file_type_invalid'], $fileId->getTypeName())); } $constructor = [ '_' => 'document', 'id' => $fileId->getId(), 'access_hash' => $fileId->getAccessHash(), 'file_reference' => $fileId->getFileReference(), 'dc_id' => $fileId->getDcId(), 'mime_type' => 'application/octet-stream', 'attributes' => $attribute ? [$attribute] : [] ]; $res['MessageMedia'] = ['_' => 'messageMediaDocument', 'document' => $constructor, 'caption' => '']; return $res; } } <?php namespace danog\MadelineProto\TL\Conversion; use danog\MadelineProto\StrTools; use DOMNode; use DOMText; final class DOMEntities { /** * @readonly */ public array $entities = []; /** * @readonly */ public array $buttons = []; /** * @readonly */ public string $message = ''; public function __construct(string $html) { $dom = new \DOMDocument(); $html = \preg_replace("/\<br(\s*)?\/?\>/i", "\n", $html); $dom->loadxml("<body>" . \trim($html) . "</body>"); $this->parseNode($dom->getElementsByTagName('body')->item(0), 0); } /** * @return integer Length of the node */ private function parseNode(DOMNode|DOMText $node, int $offset): int { if ($node instanceof DOMText) { $this->message .= $node->wholeText; return StrTools::mbStrlen($node->wholeText); } if ($node->nodeName === 'br') { $this->message .= "\n"; return 1; } $entity = match ($node->nodeName) { 's', 'strike', 'del' =>['_' => 'messageEntityStrike'], 'u' => ['_' => 'messageEntityUnderline'], 'blockquote' => ['_' => 'messageEntityBlockquote'], 'b', 'strong' => ['_' => 'messageEntityBold'], 'i', 'em' => ['_' => 'messageEntityItalic'], 'code' => ['_' => 'messageEntityCode'], 'spoiler', 'tg-spoiler' => ['_' => 'messageEntitySpoiler'], 'pre' => ['_' => 'messageEntityPre', 'language' => $node->getAttribute('language') ?? ''], 'a' => $this->handleA($node), default => null, }; $length = 0; foreach ($node->childNodes as $sub) { $length += $this->parseNode($sub, $offset+$length); } if ($entity !== null) { $lengthReal = $length; for ($x = \strlen($this->message)-1; $x >= 0; $x--) { if (!( $this->message[$x] === ' ' || $this->message[$x] === "\r" || $this->message[$x] === "\n" )) { break; } $lengthReal--; } if ($lengthReal > 0) { $entity['offset'] = $offset; $entity['length'] = $lengthReal; $this->entities []= $entity; } } return $length; } private function handleA(DOMNode $node): array { $href = $node->getAttribute('href'); if (\preg_match('|^mention:(.+)|', $href, $matches) || \preg_match('|^tg://user\\?id=(.+)|', $href, $matches)) { return ['_' => 'inputMessageEntityMentionName', 'user_id' => $matches[1]]; } if (\preg_match('|^emoji:(\d+)$|', $href, $matches)) { return ['_' => 'messageEntityCustomEmoji', 'document_id' => (int) $matches[1]]; } if (\preg_match('|^buttonurl:(.+)|', $href)) { if (\strpos(\substr($href, -4), '|:new|') !== false) { $this->buttons[] = ['_' => 'keyboardButtonUrl', 'text' => $text, 'url' => \str_replace(['buttonurl:', ':new'], '', $href), 'new' => true]; } else { $this->buttons[] = ['_' => 'keyboardButtonUrl', 'text' => $text, 'url' => \str_replace('buttonurl:', '', $href)]; } return null; } return ['_' => 'messageEntityTextUrl', 'url' => $href]; } } <?php /** * BotAPI module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL\Conversion; use danog\Decoder\FileId; use danog\MadelineProto\Logger; use danog\MadelineProto\MTProto; use danog\MadelineProto\StrTools; use danog\MadelineProto\Tools; use const danog\Decoder\TYPES_IDS; trait BotAPI { private function htmlEntityDecode(string $stuff): string { return \html_entity_decode(\preg_replace('#< *br */? *>#', "\n", $stuff)); } /** * @return ((bool|mixed|string)[][]|string)[][] * * @psalm-return array<int|int, array{_: string, buttons: array<int|int, array{_: string, text: mixed, same_peer?: bool, query?: mixed, data?: mixed, url?: mixed}>}> */ private function parseButtons($rows): array { $newrows = []; $key = 0; $button_key = 0; foreach ($rows as $row) { $newrows[$key] = ['_' => 'keyboardButtonRow', 'buttons' => []]; foreach ($row as $button) { $newrows[$key]['buttons'][$button_key] = ['_' => 'keyboardButton', 'text' => $button['text']]; if (isset($button['url'])) { $newrows[$key]['buttons'][$button_key]['_'] = 'keyboardButtonUrl'; $newrows[$key]['buttons'][$button_key]['url'] = $button['url']; } elseif (isset($button['callback_data'])) { $newrows[$key]['buttons'][$button_key]['_'] = 'keyboardButtonCallback'; $newrows[$key]['buttons'][$button_key]['data'] = $button['callback_data']; } elseif (isset($button['switch_inline_query'])) { $newrows[$key]['buttons'][$button_key]['_'] = 'keyboardButtonSwitchInline'; $newrows[$key]['buttons'][$button_key]['same_peer'] = false; $newrows[$key]['buttons'][$button_key]['query'] = $button['switch_inline_query']; } elseif (isset($button['switch_inline_query_current_chat'])) { $newrows[$key]['buttons'][$button_key]['_'] = 'keyboardButtonSwitchInline'; $newrows[$key]['buttons'][$button_key]['same_peer'] = true; $newrows[$key]['buttons'][$button_key]['query'] = $button['switch_inline_query_current_chat']; } elseif (isset($button['callback_game'])) { $newrows[$key]['buttons'][$button_key]['_'] = 'keyboardButtonGame'; $newrows[$key]['buttons'][$button_key]['text'] = $button['callback_game']; } elseif (isset($button['request_contact']) && $button['request_contact']) { $newrows[$key]['buttons'][$button_key]['_'] = 'keyboardButtonRequestPhone'; } elseif (isset($button['request_location']) && $button['request_location']) { $newrows[$key]['buttons'][$button_key]['_'] = 'keyboardButtonRequestGeoLocation'; } $button_key++; } $key++; } return $newrows; } private function parseReplyMarkup($markup) { if (isset($markup['force_reply']) && $markup['force_reply']) { $markup['_'] = 'replyKeyboardForceReply'; unset($markup['force_reply']); } if (isset($markup['remove_keyboard']) && $markup['remove_keyboard']) { $markup['_'] = 'replyKeyboardHide'; unset($markup['remove_keyboard']); } if (isset($markup['keyboard'])) { $markup['_'] = 'replyKeyboardMarkup'; if (isset($markup['resize_keyboard'])) { $markup['resize'] = $markup['resize_keyboard']; unset($markup['resize_keyboard']); } if (isset($markup['one_time_keyboard'])) { $markup['single_use'] = $markup['one_time_keyboard']; unset($markup['one_time_keyboard']); } $markup['rows'] = $this->parseButtons($markup['keyboard']); unset($markup['keyboard']); } if (isset($markup['inline_keyboard'])) { $markup['_'] = 'replyInlineMarkup'; $markup['rows'] = $this->parseButtons($markup['inline_keyboard']); unset($markup['inline_keyboard']); } return $markup; } /** * Convert MTProto parameters to bot API parameters. * * @param array $data Data * * @return \Generator<array> */ public function MTProtoToBotAPI(array $data): \Generator { $newd = []; if (!isset($data['_'])) { foreach ($data as $key => $element) { $newd[$key] = (yield from $this->MTProtoToBotAPI($element)); } return $newd; } $res = null; switch ($data['_']) { case 'updates': case 'updatesCombined': case 'updateShort': case 'updateShortSentMessage': case 'updateShortMessage': case 'updateShortChatMessage': $data = yield from $this->extractMessageUpdate($data); // no break case 'updateNewChannelMessage': case 'updateNewMessage': $data = $data['message']; // no break case 'message': $newd['message_id'] = $data['id']; $newd['date'] = $data['date']; $newd['text'] = $data['message']; $newd['post'] = $data['post']; $newd['silent'] = $data['silent']; if (isset($data['from_id'])) { $newd['from'] = (yield from $this->getPwrChat($data['from_id'])); } $newd['chat'] = (yield from $this->getPwrChat($data['peer_id'])); if (isset($data['entities'])) { $newd['entities'] = (yield from $this->MTProtoToBotAPI($data['entities'])); } if (isset($data['views'])) { $newd['views'] = $data['views']; } if (isset($data['edit_date'])) { $newd['edit_date'] = $data['edit_date']; } if (isset($data['via_bot_id'])) { $newd['via_bot'] = (yield from $this->getPwrChat($data['via_bot_id'])); } if (isset($data['fwd_from']['from_id'])) { $newd['forward_from'] = (yield from $this->getPwrChat($data['fwd_from']['from_id'])); } if (isset($data['fwd_from']['channel_id'])) { try { $newd['forward_from_chat'] = yield from $this->getPwrChat(MTProto::toSupergroup($data['fwd_from']['channel_id'])); } catch (\Throwable $e) { } } if (isset($data['fwd_from']['date'])) { $newd['forward_date'] = $data['fwd_from']['date']; } if (isset($data['fwd_from']['channel_post'])) { $newd['forward_from_message_id'] = $data['fwd_from']['channel_post']; } if (isset($data['media'])) { $newd = \array_merge($newd, yield from $this->MTProtoToBotAPI($data['media'])); } return $newd; case 'messageEntityMention': unset($data['_']); $data['type'] = 'mention'; return $data; case 'messageEntityHashtag': unset($data['_']); $data['type'] = 'hashtag'; return $data; case 'messageEntityBotCommand': unset($data['_']); $data['type'] = 'bot_command'; return $data; case 'messageEntityUrl': unset($data['_']); $data['type'] = 'url'; return $data; case 'messageEntityEmail': unset($data['_']); $data['type'] = 'email'; return $data; case 'messageEntityBold': unset($data['_']); $data['type'] = 'bold'; return $data; case 'messageEntityStrike': unset($data['_']); $data['type'] = 'strikethrough'; return $data; case 'messageEntitySpoiler': unset($data['_']); $data['type'] = 'spoiler'; return $data; case 'messageEntityUnderline': unset($data['_']); $data['type'] = 'underline'; return $data; case 'messageEntityItalic': unset($data['_']); $data['type'] = 'italic'; return $data; case 'messageEntityCode': unset($data['_']); $data['type'] = 'code'; return $data; case 'messageEntityPre': unset($data['_']); $data['type'] = 'pre'; return $data; case 'messageEntityTextUrl': unset($data['_']); $data['type'] = 'text_url'; return $data; case 'messageEntityMentionName': unset($data['_']); $data['type'] = 'text_mention'; $data['user'] = (yield from $this->getPwrChat($data['user_id'])); unset($data['user_id']); return $data; case 'messageMediaPhoto': if (isset($data['caption'])) { $res['caption'] = $data['caption']; } $res['photo'] = []; foreach ($data['photo']['sizes'] as $key => $photo) { if (\in_array($photo['_'], ['photoCachedSize', 'photoSize', 'photoSizeProgressive'])) { $res['photo'][$key] = $this->photosizeToBotAPI($photo, $data['photo']); } } return $res; case 'messageMediaEmpty': return []; case 'messageMediaDocument': $type_name = 'document'; $res = []; if (isset($data['document']['thumbs']) && $data['document']['thumbs'] && \in_array(\end($data['document']['thumbs'])['_'], ['photoCachedSize', 'photoSize', 'photoSizeProgressive'])) { $res['thumb'] = $this->photosizeToBotAPI(\end($data['document']['thumbs']), $data['document'], true); } foreach ($data['document']['attributes'] as $attribute) { switch ($attribute['_']) { case 'documentAttributeFilename': $pathinfo = \pathinfo($attribute['file_name']); $res['ext'] = isset($pathinfo['extension']) ? '.'.$pathinfo['extension'] : ''; $res['file_name'] = $pathinfo['filename']; break; case 'documentAttributeAudio': $audio = $attribute; $type_name = $attribute['voice'] ? 'voice' :'audio'; $res['duration'] = $attribute['duration']; if (isset($attribute['performer'])) { $res['performer'] = $attribute['performer']; } if (isset($attribute['title'])) { $res['title'] = $attribute['title']; } if (isset($attribute['waveform'])) { $res['title'] = $attribute['waveform']; } break; case 'documentAttributeVideo': $type_name = $attribute['round_message'] ? 'video_note' : 'video'; $res['width'] = $attribute['w']; $res['height'] = $attribute['h']; $res['duration'] = $attribute['duration']; break; case 'documentAttributeImageSize': $res['width'] = $attribute['w']; $res['height'] = $attribute['h']; break; case 'documentAttributeAnimated': $type_name = 'animation'; $res['animated'] = true; break; case 'documentAttributeHasStickers': $res['has_stickers'] = true; break; case 'documentAttributeSticker': $type_name = 'sticker'; $res['mask'] = $attribute['mask']; $res['emoji'] = $attribute['alt']; $res['sticker_set'] = $attribute['stickerset']; if (isset($attribute['mask_coords'])) { $res['mask_coords'] = $attribute['mask_coords']; } break; } } if (isset($audio) && isset($audio['title']) && !isset($res['file_name'])) { $res['file_name'] = $audio['title']; if (isset($audio['performer'])) { $res['file_name'] .= ' - '.$audio['performer']; } } if (!isset($res['file_name'])) { $res['file_name'] = $data['document']['access_hash']; } $res['file_name'] .= '_'.$data['document']['id']; if (isset($res['ext'])) { $res['file_name'] .= $res['ext']; unset($res['ext']); } else { $res['file_name'] .= Tools::getExtensionFromMime($data['document']['mime_type']); } $res['file_size'] = $data['document']['size']; $res['mime_type'] = $data['document']['mime_type']; $fileId = new FileId; $fileId->setId($data['document']['id']); $fileId->setAccessHash($data['document']['access_hash']); $fileId->setFileReference($data['document']['file_reference'] ?? ''); $fileId->setDcId($data['document']['dc_id']); $fileId->setType(TYPES_IDS[$type_name]); $res['file_id'] = (string) $fileId; $res['file_unique_id'] = $fileId->getUniqueBotAPI(); return [$type_name => $res, 'caption' => $data['caption'] ?? '']; default: throw new Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['botapi_conversion_error'], $data['_'])); } } /** * Convert bot API parameters to MTProto parameters. * * @param array $arguments Arguments * */ public function botAPIToMTProto(array $arguments): array { foreach (self::BOTAPI_PARAMS_CONVERSION as $bot => $mtproto) { if (isset($arguments[$bot]) && !isset($arguments[$mtproto])) { $arguments[$mtproto] = $arguments[$bot]; //unset($arguments[$bot]); } } if (isset($arguments['reply_markup'])) { $arguments['reply_markup'] = $this->parseReplyMarkup($arguments['reply_markup']); } if (isset($arguments['parse_mode'])) { $arguments = $this->parseMode($arguments); } return $arguments; } /** * Convert markdown and HTML messages. * * @param array $arguments Arguments * * @internal * * @return \Generator<array> */ public function parseMode(array $arguments) { if (($arguments['message'] ?? '') === '' || !isset($arguments['parse_mode'])) { return $arguments; } if (!(\is_string($arguments['message']) || \is_object($arguments['message']) && \method_exists($arguments['message'], '__toString'))) { throw new Exception('Messages can only be strings'); } if (isset($arguments['parse_mode']['_'])) { $arguments['parse_mode'] = \str_replace('textParseMode', '', $arguments['parse_mode']['_']); } if (\stripos($arguments['parse_mode'], 'markdown') !== false) { $arguments['message'] = \Parsedown::instance()->line($arguments['message']); $arguments['parse_mode'] = 'HTML'; } if (\stripos($arguments['parse_mode'], 'html') !== false) { $entities = new DOMEntities($arguments['message']); $arguments['message'] = $entities->message; $arguments['entities'] = \array_merge($arguments['entities'] ?? [], $entities->entities); if ($entities->buttons) { $arguments['reply_markup'] = $this->buildRows($entities->buttons); } unset($arguments['parse_mode']); } return $arguments; } /** * Split too long message into chunks. * * @param array $args Arguments * * @internal */ public function splitToChunks($args): array { $args = $this->parseMode($args); if (!isset($args['entities'])) { $args['entities'] = []; } $max_length = isset($args['media']) ? $this->config['caption_length_max'] : $this->config['message_length_max']; $max_entity_length = 100; $max_entity_size = 8110; $text_arr = []; foreach ($this->multipleExplodeKeepDelimiters(["\n"], $args['message']) as $word) { if (\mb_strlen($word, 'UTF-8') > $max_length) { foreach (StrTools::mbStrSplit($word, $max_length) as $vv) { $text_arr[] = $vv; } } else { $text_arr[] = $word; } } $multiple_args_base = \array_merge($args, ['entities' => [], 'parse_mode' => 'text', 'message' => '']); $multiple_args = [$multiple_args_base]; $i = 0; foreach ($text_arr as $word) { if (StrTools::mbStrlen($multiple_args[$i]['message'].$word) <= $max_length) { $multiple_args[$i]['message'] .= $word; } else { $i++; $multiple_args[$i] = $multiple_args_base; $multiple_args[$i]['message'] .= $word; } } $i = 0; $offset = 0; for ($k = 0; $k < \count($args['entities']); $k++) { $entity = $args['entities'][$k]; do { while ($entity['offset'] > $offset + StrTools::mbStrlen($multiple_args[$i]['message'])) { $offset += StrTools::mbStrlen($multiple_args[$i]['message']); $i++; } $entity['offset'] -= $offset; if ($entity['offset'] + $entity['length'] > StrTools::mbStrlen($multiple_args[$i]['message'])) { $newentity = $entity; $newentity['length'] = $entity['length'] - (StrTools::mbStrlen($multiple_args[$i]['message']) - $entity['offset']); $entity['length'] = StrTools::mbStrlen($multiple_args[$i]['message']) - $entity['offset']; $offset += $entity['length']; //StrTools::mbStrlen($multiple_args[$i]['message']); $newentity['offset'] = $offset; $prev_length = StrTools::mbStrlen($multiple_args[$i]['message']); $multiple_args[$i]['message'] = \rtrim($multiple_args[$i]['message']); $diff = $prev_length - StrTools::mbStrlen($multiple_args[$i]['message']); if ($diff) { $entity['length'] -= $diff; foreach ($args['entities'] as $key => &$eentity) { if ($key > $k) { $eentity['offset'] -= $diff; } } } $multiple_args[$i]['entities'][] = $entity; $i++; $entity = $newentity; continue; } $prev_length = StrTools::mbStrlen($multiple_args[$i]['message']); $multiple_args[$i]['message'] = \rtrim($multiple_args[$i]['message']); $diff = $prev_length - StrTools::mbStrlen($multiple_args[$i]['message']); if ($diff) { $entity['length'] -= $diff; foreach ($args['entities'] as $key => &$eentity) { if ($key > $k) { $eentity['offset'] -= $diff; } } } $multiple_args[$i]['entities'][] = $entity; break; } while (true); } $total = 0; foreach ($multiple_args as $args) { if (\count($args['entities']) > $max_entity_length) { $total += \count($args['entities']) - $max_entity_length; } $c = 0; foreach ($args['entities'] as $entity) { if (isset($entity['url'])) { $c += \strlen($entity['url']); } } if ($c >= $max_entity_size) { $this->logger->logger('Entity size limit possibly exceeded, you may get an error indicating that the entities are too long. Reduce the number of entities and/or size of the URLs used.', Logger::FATAL_ERROR); } } if ($total) { $this->logger->logger("Too many entities, {$total} entities will be truncated", Logger::FATAL_ERROR); } return $multiple_args; } /** * @return string[] * * @psalm-return list<string> */ private function multipleExplodeKeepDelimiters($delimiters, $string): array { $initialArray = \explode(\chr(1), \str_replace($delimiters, \chr(1), $string)); $finalArray = []; /** @var int */ $delimOffset = 0; foreach ($initialArray as $item) { $delimOffset += StrTools::mbStrlen($item); /** @var int $delimOffset */ $finalArray[] = $item.($delimOffset < StrTools::mbStrlen($string) ? $string[$delimOffset] : ''); $delimOffset++; } return $finalArray; } /** * @return ((array|string)[][]|string)[] * * @psalm-return array{_: string, rows: list<array{_: string, buttons: list<mixed>}>} */ private function buildRows($button_list): array { $end = false; $rows = []; $buttons = []; $cols = 0; foreach ($button_list as $button) { if (isset($button['new'])) { if (\count($buttons) == 0) { $buttons[] = $button; } else { $row = ['_' => 'keyboardButtonRow', 'buttons' => $buttons]; $rows[] = $row; $buttons = [$button]; } } else { $buttons[] = $button; $end = true; } } if ($end) { $row = ['_' => 'keyboardButtonRow', 'buttons' => $buttons]; $rows[] = $row; } return ['_' => 'replyInlineMarkup', 'rows' => $rows]; } } <?php /** * Exception module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL\Conversion; /** * TL conversion exception. */ class Exception extends \Exception { use \danog\MadelineProto\TL\PrettyException; public function __toString() { $result = static::class.($this->message !== '' ? ': ' : '').$this->message.PHP_EOL.\danog\MadelineProto\Magic::$revision.PHP_EOL.'TL Trace:'.PHP_EOL.PHP_EOL.$this->getTLTrace().PHP_EOL; if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg') { $result = \str_replace(PHP_EOL, '<br>'.PHP_EOL, $result); } return $result; } public function __construct($message, $file = '') { parent::__construct($message); $this->prettifyTL($file); } } <?php /** * TD module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL\Conversion; trait TD { /** * Convert tdcli parameters to tdcli. * * @param array $params Params * @param array $key Key * */ public function tdcliToTd(&$params, $key = null): array { if (!\is_array($params)) { return $params; } if (!isset($params['ID'])) { \array_walk($params, [$this, 'tdcliToTd']); return $params; } foreach ($params as $key => $value) { $value = $this->tdcliToTd($value); if (\preg_match('/_$/', $key)) { $params[\preg_replace('/_$/', '', $key)] = $value; unset($params[$key]); } } $params['_'] = \lcfirst($params['ID']); unset($params['ID']); return $params; } /** * Convert TD to MTProto parameters. * * @param array $params Parameters * * @return \Generator<array> */ public function tdToMTProto(array $params): \Generator { $newparams = ['_' => self::TD_REVERSE[$params['_']]]; foreach (self::TD_PARAMS_CONVERSION[$newparams['_']] as $td => $mtproto) { if (\is_array($mtproto)) { switch (\end($mtproto)) { case 'choose_message_content': switch ($params[$td]['_']) { case 'inputMessageText': $params[$td]['_'] = 'messages.sendMessage'; if (isset($params['disable_web_page_preview'])) { $newparams['no_webpage'] = $params[$td]['disable_web_page_preview']; } $newparams = \array_merge($params[$td], $newparams); break; default: throw new Exception(\danog\MadelineProto\Lang::$current_lang['non_text_conversion']); } break; default: $newparams[$mtproto[0]] = isset($params[$td]) ? $params[$td] : null; if (\is_array($newparams[$mtproto[0]])) { $newparams[$mtproto[0]] = (yield from $this->MTProtoToTd($newparams[$mtproto[0]])); } } } } return $newparams; } /** * MTProto to TDCLI params. * * @param mixed $params Params * */ public function MTProtoToTdcli($params): \Generator { return $this->tdToTdcli(yield from $this->MTProtoToTd($params)); } /** * MTProto to TD params. * * @param mixed $params Params * */ public function MTProtoToTd(&$params): \Generator { if (!\is_array($params)) { return $params; } if (!isset($params['_'])) { \array_walk($params, [$this, 'mtprotoToTd']); return $params; } $newparams = ['_' => $params['_']]; if (\in_array($params['_'], self::TD_IGNORE)) { return $params; } foreach (self::TD_PARAMS_CONVERSION[$params['_']] as $td => $mtproto) { if (\is_string($mtproto)) { $newparams[$td] = $mtproto; } else { switch (\end($mtproto)) { case 'choose_chat_id_from_botapi': $newparams[$td] = (yield from $this->getInfo($params[$mtproto[0]]))['bot_api_id'] == $this->authorization['user']['id'] ? $this->getId($params['from_id']) : (yield from $this->getInfo($params[$mtproto[0]]))['bot_api_id']; break; case 'choose_incoming_or_sent': $newparams[$td] = ['_' => $params['out'] ? 'messageIsSuccessfullySent' : 'messageIsIncoming']; break; case 'choose_can_edit': $newparams[$td] = !isset($params['fwd_from']) && $params['out']; break; case 'choose_can_delete': $newparams[$td] = $params['out']; break; case 'choose_forward_info': if (isset($params['fwd_from'])) { $newparams[$td] = ['_' => 'messageForwardedFromUser']; if (isset($params['fwd_from']['channel_id'])) { $newparams[$td] = ['_' => 'messageForwardedPost', 'chat_id' => '-100'.$params['fwd_from']['channel_id']]; } $newparams[$td]['date'] = $params['fwd_from']['date']; if (isset($params['fwd_from']['channel_post'])) { $newparams[$td]['channel_post'] = $params['fwd_from']['channel_post']; } if (isset($params['fwd_from']['from_id'])) { $newparams[$td]['sender_user_id'] = $this->getId($params['fwd_from']['from_id']); } } else { $newparams[$td] = null; } break; case 'choose_ttl': $newparams[$td] = isset($params['ttl']) ? $params['ttl'] : 0; break; case 'choose_ttl_expires_in': $newparams[$td] = $newparams['ttl'] - \microtime(true); break; case 'choose_message_content': if ($params['message'] !== '') { $newparams[$td] = ['_' => 'messageText', 'text' => $params['message']]; if (isset($params['media']['_']) && $params['media']['_'] === 'messageMediaWebPage') { $newparams[$td]['web_page'] = (yield from $this->MTProtoToTd($params['media']['webpage'])); } if (isset($params['entities'])) { $newparams[$td]['entities'] = $params['entities']; } } else { throw new Exception(\danog\MadelineProto\Lang::$current_lang['non_text_conversion']); } break; default: if (isset($mtproto[1])) { $newparams[$td] = isset($params[$mtproto[0]][$mtproto[1]]) ? $params[$mtproto[0]][$mtproto[1]] : null; } else { $newparams[$td] = isset($params[$mtproto[0]]) ? $params[$mtproto[0]] : null; } if (\is_array($newparams[$td])) { $newparams[$td] = (yield from $this->MTProtoToTd($newparams[$td])); } } } } return $newparams; } /** * Convert TD parameters to tdcli. * * @param mixed $params Parameters * */ public function tdToTdcli($params) { if (!\is_array($params)) { return $params; } $newparams = []; foreach ($params as $key => $value) { if ($key === '_') { $newparams['ID'] = \ucfirst($value); } else { if (!\is_numeric($key) && !\str_ends_with($key, '_')) { $key = $key.'_'; } $newparams[$key] = $this->tdToTdcli($value); } } return $newparams; } } <?php /* Copyright 2016-2020 Daniil Gentili (https://daniil.it) This file is part of MadelineProto. MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU General Public License along with MadelineProto. If not, see <http://www.gnu.org/licenses/>. */ namespace danog\MadelineProto\TL\Conversion; use danog\MadelineProto\Magic; /** * Manages generation of extensions for files. */ abstract class Extension { public const ALL_MIMES = ['webp' => [0 => 'image/webp'], 'png' => [0 => 'image/png', 1 => 'image/x-png'], 'bmp' => [0 => 'image/bmp', 1 => 'image/x-bmp', 2 => 'image/x-bitmap', 3 => 'image/x-xbitmap', 4 => 'image/x-win-bitmap', 5 => 'image/x-windows-bmp', 6 => 'image/ms-bmp', 7 => 'image/x-ms-bmp', 8 => 'application/bmp', 9 => 'application/x-bmp', 10 => 'application/x-win-bitmap'], 'gif' => [0 => 'image/gif'], 'jpeg' => [0 => 'image/jpeg', 1 => 'image/pjpeg'], 'xspf' => [0 => 'application/xspf+xml'], 'vlc' => [0 => 'application/videolan'], 'wmv' => [0 => 'video/x-ms-wmv', 1 => 'video/x-ms-asf'], 'au' => [0 => 'audio/x-au'], 'ac3' => [0 => 'audio/ac3'], 'flac' => [0 => 'audio/x-flac'], 'ogg' => [0 => 'audio/ogg', 1 => 'video/ogg', 2 => 'application/ogg'], 'kmz' => [0 => 'application/vnd.google-earth.kmz'], 'kml' => [0 => 'application/vnd.google-earth.kml+xml'], 'rtx' => [0 => 'text/richtext'], 'rtf' => [0 => 'text/rtf'], 'jar' => [0 => 'application/java-archive', 1 => 'application/x-java-application', 2 => 'application/x-jar'], 'zip' => [0 => 'application/x-zip', 1 => 'application/zip', 2 => 'application/x-zip-compressed', 3 => 'application/s-compressed', 4 => 'multipart/x-zip'], '7zip' => [0 => 'application/x-compressed'], 'xml' => [0 => 'application/xml', 1 => 'text/xml'], 'svg' => [0 => 'image/svg+xml'], '3g2' => [0 => 'video/3gpp2'], '3gp' => [0 => 'video/3gp', 1 => 'video/3gpp'], 'mp4' => [0 => 'video/mp4'], 'm4a' => [0 => 'audio/x-m4a'], 'f4v' => [0 => 'video/x-f4v'], 'flv' => [0 => 'video/x-flv'], 'webm' => [0 => 'video/webm'], 'aac' => [0 => 'audio/x-acc'], 'm4u' => [0 => 'application/vnd.mpegurl'], 'pdf' => [0 => 'application/pdf', 1 => 'application/octet-stream'], 'pptx' => [0 => 'application/vnd.openxmlformats-officedocument.presentationml.presentation'], 'ppt' => [0 => 'application/powerpoint', 1 => 'application/vnd.ms-powerpoint', 2 => 'application/vnd.ms-office', 3 => 'application/msword'], 'docx' => [0 => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'], 'xlsx' => [0 => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 1 => 'application/vnd.ms-excel'], 'xl' => [0 => 'application/excel'], 'xls' => [0 => 'application/msexcel', 1 => 'application/x-msexcel', 2 => 'application/x-ms-excel', 3 => 'application/x-excel', 4 => 'application/x-dos_ms_excel', 5 => 'application/xls', 6 => 'application/x-xls'], 'xsl' => [0 => 'text/xsl'], 'mpeg' => [0 => 'video/mpeg'], 'mov' => [0 => 'video/quicktime'], 'avi' => [0 => 'video/x-msvideo', 1 => 'video/msvideo', 2 => 'video/avi', 3 => 'application/x-troff-msvideo'], 'movie' => [0 => 'video/x-sgi-movie'], 'log' => [0 => 'text/x-log'], 'txt' => [0 => 'text/plain'], 'css' => [0 => 'text/css'], 'html' => [0 => 'text/html'], 'wav' => [0 => 'audio/x-wav', 1 => 'audio/wave', 2 => 'audio/wav'], 'xhtml' => [0 => 'application/xhtml+xml'], 'tar' => [0 => 'application/x-tar'], 'tgz' => [0 => 'application/x-gzip-compressed'], 'psd' => [0 => 'application/x-photoshop', 1 => 'image/vnd.adobe.photoshop'], 'exe' => [0 => 'application/x-msdownload'], 'js' => [0 => 'application/x-javascript'], 'mp3' => [0 => 'audio/mpeg', 1 => 'audio/mpg', 2 => 'audio/mpeg3', 3 => 'audio/mp3'], 'rar' => [0 => 'application/x-rar', 1 => 'application/rar', 2 => 'application/x-rar-compressed'], 'gzip' => [0 => 'application/x-gzip'], 'hqx' => [0 => 'application/mac-binhex40', 1 => 'application/mac-binhex', 2 => 'application/x-binhex40', 3 => 'application/x-mac-binhex40'], 'cpt' => [0 => 'application/mac-compactpro'], 'bin' => [0 => 'application/macbinary', 1 => 'application/mac-binary', 2 => 'application/x-binary', 3 => 'application/x-macbinary'], 'oda' => [0 => 'application/oda'], 'ai' => [0 => 'application/postscript'], 'smil' => [0 => 'application/smil'], 'mif' => [0 => 'application/vnd.mif'], 'wbxml' => [0 => 'application/wbxml'], 'wmlc' => [0 => 'application/wmlc'], 'dcr' => [0 => 'application/x-director'], 'dvi' => [0 => 'application/x-dvi'], 'gtar' => [0 => 'application/x-gtar'], 'php' => [0 => 'application/x-httpd-php', 1 => 'application/php', 2 => 'application/x-php', 3 => 'text/php', 4 => 'text/x-php', 5 => 'application/x-httpd-php-source'], 'swf' => [0 => 'application/x-shockwave-flash'], 'sit' => [0 => 'application/x-stuffit'], 'z' => [0 => 'application/x-compress'], 'mid' => [0 => 'audio/midi'], 'aif' => [0 => 'audio/x-aiff', 1 => 'audio/aiff'], 'ram' => [0 => 'audio/x-pn-realaudio'], 'rpm' => [0 => 'audio/x-pn-realaudio-plugin'], 'ra' => [0 => 'audio/x-realaudio'], 'rv' => [0 => 'video/vnd.rn-realvideo'], 'jp2' => [0 => 'image/jp2', 1 => 'video/mj2', 2 => 'image/jpx', 3 => 'image/jpm'], 'tiff' => [0 => 'image/tiff'], 'eml' => [0 => 'message/rfc822'], 'pem' => [0 => 'application/x-x509-user-cert', 1 => 'application/x-pem-file'], 'p10' => [0 => 'application/x-pkcs10', 1 => 'application/pkcs10'], 'p12' => [0 => 'application/x-pkcs12'], 'p7a' => [0 => 'application/x-pkcs7-signature'], 'p7c' => [0 => 'application/pkcs7-mime', 1 => 'application/x-pkcs7-mime'], 'p7r' => [0 => 'application/x-pkcs7-certreqresp'], 'p7s' => [0 => 'application/pkcs7-signature'], 'crt' => [0 => 'application/x-x509-ca-cert', 1 => 'application/pkix-cert'], 'crl' => [0 => 'application/pkix-crl', 1 => 'application/pkcs-crl'], 'pgp' => [0 => 'application/pgp'], 'gpg' => [0 => 'application/gpg-keys'], 'rsa' => [0 => 'application/x-pkcs7'], 'ics' => [0 => 'text/calendar'], 'zsh' => [0 => 'text/x-scriptzsh'], 'cdr' => [0 => 'application/cdr', 1 => 'application/coreldraw', 2 => 'application/x-cdr', 3 => 'application/x-coreldraw', 4 => 'image/cdr', 5 => 'image/x-cdr', 6 => 'zz-application/zz-winassoc-cdr'], 'wma' => [0 => 'audio/x-ms-wma'], 'vcf' => [0 => 'text/x-vcard'], 'srt' => [0 => 'text/srt'], 'vtt' => [0 => 'text/vtt'], 'ico' => [0 => 'image/x-icon', 1 => 'image/x-ico', 2 => 'image/vnd.microsoft.icon'], 'csv' => [0 => 'text/x-comma-separated-values', 1 => 'text/comma-separated-values', 2 => 'application/vnd.msexcel'], 'json' => [0 => 'application/json', 1 => 'text/json']]; /** * Get mime type from file extension. * * @param string $extension File extension * @param string $default Default mime type * */ public static function getMimeFromExtension(string $extension, string $default): string { $ext = \ltrim($extension, '.'); if (isset(self::ALL_MIMES[$ext])) { return self::ALL_MIMES[$ext][0]; } return $default; } /** * Get extension from mime type. * * @param string $mime MIME type * */ public static function getExtensionFromMime(string $mime): string { return Magic::$allMimes[$mime] ?? ''; } /** * Get extension from file location. * * @param mixed $location File location * @param string $default Default extension * */ public static function getExtensionFromLocation($location, string $default): string { return $default; } /** * Get mime type of file. * * @param string $file File * */ public static function getMimeFromFile(string $file): string { $finfo = new \finfo(FILEINFO_MIME_TYPE); return $finfo->file($file); } /** * Get mime type from buffer. * * @param string $buffer Buffer * */ public static function getMimeFromBuffer(string $buffer): string { $finfo = new \finfo(FILEINFO_MIME_TYPE); return $finfo->buffer($buffer); } } <?php namespace danog\MadelineProto\TL\Conversion; /** * Entities module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Mahdi <mahdi.talaee1379@gmail.com> * @copyright 2022 Mahdi <mahdi.talaee1379@gmail.com> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ final class Entities { private int $offset = 0; /** * setOffset * setOffset for text. * * */ private function setOffset(string $start, mixed $end = "</a>"): void { $this->setOffset[$this->offset][] = $start; $this->setOffset2[$this->offset + $this->length][] = $end; } /** * checkEntity * checkEntity in text and identify it. * * * */ private function checkEntity(object|array $entity, &$type): array { if (\is_object($entity)) { $entity = (array) $entity; } if (\is_array($entity)) { if (!isset($entity["offset"])) { throw new Exception('Can\'t find field "offset"'); } if (!isset($entity["length"])) { throw new Exception('Can\'t find field "length"'); } if (!isset($entity["_"])) { throw new Exception('Can\'t find field "type"'); } if (\is_array($entity["_"]) || \is_object($entity["_"])) { throw new Exception('Field "type" must be of type String'); } if ( \is_array($entity["offset"]) || \is_object($entity["offset"]) || (string) (int) $entity["offset"] !== (string) $entity["offset"] ) { throw new Exception('Field "offset" must be of type Integer'); } if ( \is_array($entity["length"]) || \is_object($entity["length"]) || (string) (int) $entity["length"] !== (string) $entity["length"] ) { throw new Exception('Field "length" must be of type Integer'); } $this->offset = (int) $entity["offset"]; $this->length = (int) $entity["length"]; $type = $this->getEntityCode($entity["_"]); return $entity; } throw new Exception("expected an Object"); } /** * entitiesToHtml * Covert entities to html tags. * * * * */ public function entitiesToHtml( string $text, array|object $entities = [], bool $specialchars = true ): string { $this->setOffset = []; $this->setOffset2 = []; $utf16 = $this->encode($text); foreach ($entities as $entity) { $entity = $this->checkEntity($entity, $type); if ($type == CODE) { $this->setOffset("<code>", "</code>"); } elseif ($type == TEXTURL && isset($entity["url"])) { $this->setOffset('<a href="' . $entity["url"] . '">'); } elseif ($type == TEXTMENTION) { $this->setOffset( '<a href="tg://user?id=' . ($entity["user"]["id"] ?? ($entity["user_id"] ?? 0)) . '">' ); } elseif ($type == PRE) { if (isset($entity["language"])) { $this->setOffset( '<pre><code class="language-' . $entity["language"] . '">', "</code></pre>" ); } else { $this->setOffset("<pre>", "</pre>"); } } elseif ($type == BOLD) { $this->setOffset("<b>", "</b>"); } elseif ($type == SPOILER) { $this->setOffset("<span class=\"tg-spoiler\">", "</span>"); } elseif ($type == ITALIC) { $this->setOffset("<i>", "</i>"); } elseif ($type == STRIKE) { $this->setOffset("<s>", "</s>"); } elseif ($type == UNDERLINE) { $this->setOffset("<u>", "</u>"); } } foreach ($this->setOffset2 as $key => $value) { if (!isset($this->setOffset[$key])) { $this->setOffset[$key] = []; } $this->setOffset[$key] = \array_merge( \array_reverse($this->setOffset2[$key]), $this->setOffset[$key] ); } $htmlext = ""; $deltag = [ "&" . "\0" . "a" . "\0" . "m" . "\0" . "p" . "\0" . ";" . "\0" . "", "&" . "\0" . "l" . "\0" . "t" . "\0" . ";" . "\0" . "", "&" . "\0" . "g" . "\0" . "t" . "\0" . ";" . "\0" . "", ]; $deltag2 = [ '/&\\000/', '/\\<\\000/', '/\\>\\000/', ]; for ($offset = 0; $offset < \strlen($utf16) / 2; $offset++) { $t = \substr($utf16, $offset * 2, 2); if (isset($this->setOffset[$offset])) { foreach ($this->setOffset[$offset] as $tt) { $htmlext .= $this->encode($tt); } unset($this->setOffset[$offset]); } $htmlext .= $specialchars ? \preg_replace($deltag2, $deltag, $t) : $t; } foreach ($this->setOffset as $off) { foreach ($off as $tt) { $htmlext .= $this->encode($tt); } } return $this->decode($htmlext); } /** * entitiesToMarkdownV1 * Covert entities to html tags v1 (Telegram version). * * * * */ public function entitiesToMarkdownV1( string $text, object|array $entities = [], bool $slashmarkdown = true ): string { $this->setOffset = []; $this->setOffset2 = []; $utf16 = $this->encode($text); foreach ($entities as $entity) { $entity = $this->checkEntity($entity, $type); if ($type == CODE) { $this->setOffset("`", "`"); } elseif ($type == TEXTURL && isset($entity["url"])) { $this->setOffset("[", "](" . $entity["url"] . ")"); } elseif ($type == TEXTMENTION) { $this->setOffset( "[", "](tg://user?id=" . ($entity["user"]["id"] ?? ($entity["user_id"] ?? 0)) . ")" ); } elseif ($type == PRE) { if (isset($entity["language"])) { $this->setOffset("```" . $entity["language"] . "\n", "```"); } else { $this->setOffset("```", "```"); } } elseif ($type == BOLD) { $this->setOffset("*", "*"); } elseif ($type == ITALIC) { $this->setOffset("_", "_"); } } foreach ($this->setOffset2 as $key => $value) { if (!isset($this->setOffset[$key])) { $this->setOffset[$key] = []; } $this->setOffset[$key] = \array_merge( \array_reverse($this->setOffset2[$key]), $this->setOffset[$key] ); } $htmlext = ""; $deltag = [ "\\" . "\0" . "_" . "\0" . "", "\\" . "\0" . "*" . "\0" . "", "\\" . "\0" . "`" . "\0" . "", "\\" . "\0" . "[" . "\0" . "", ]; $deltag2 = [ '/_\\000/', '/\\*\\000/', '/`\\000/', '/\\[\\000/', ]; for ($offset = 0; $offset < \strlen($utf16) / 2; $offset++) { $t = \substr($utf16, $offset * 2, 2); if (isset($this->setOffset[$offset])) { foreach ($this->setOffset[$offset] as $tt) { $htmlext .= $this->encode($tt); } unset($this->setOffset[$offset]); } $htmlext .= $slashmarkdown ? \preg_replace($deltag2, $deltag, $t) : $t; } foreach ($this->setOffset as $off) { foreach ($off as $tt) { $htmlext .= $this->encode($tt); } } return $this->decode($htmlext); } /** * entitiesToMarkdown * convert given entities to markdown. * * * * */ public function entitiesToMarkdown( string $text, object|array $entities = [], bool $slashmarkdown = true ): string { $this->setOffset = []; $this->setOffset2 = []; $utf16 = $this->encode($text); foreach ($entities as $entity) { $entity = $this->checkEntity($entity, $type); if ($type == CODE) { $this->setOffset("`", "`"); } elseif ($type == TEXTURL && isset($entity["url"])) { $this->setOffset("[", "](" . $entity["url"] . ")"); } elseif ($type == TEXTMENTION) { $this->setOffset( "[", "](tg://user?id=" . ($entity["user"]["id"] ?? ($entity["user_id"] ?? 0)) . ")" ); } elseif ($type == PRE) { if (isset($entity["language"])) { $this->setOffset("```" . $entity["language"] . "\n", "```"); } else { $this->setOffset("```", "```"); } } elseif ($type == SPOILER) { $this->setOffset("||", "||"); } elseif ($type == BOLD) { $this->setOffset("**", "**"); } elseif ($type == ITALIC) { $this->setOffset("__", "__"); } elseif ($type == STRIKE) { $this->setOffset("~~", "~~"); } elseif ($type == UNDERLINE) { $this->setOffset("_", "_"); } } foreach ($this->setOffset2 as $key => $value) { if (!isset($this->setOffset[$key])) { $this->setOffset[$key] = []; } $this->setOffset[$key] = \array_merge( \array_reverse($this->setOffset2[$key]), $this->setOffset[$key] ); } $htmlext = ""; $deltag = [ "\\" . "\0" . "_" . "\0" . "", "\\" . "\0" . "*" . "\0" . "", "\\" . "\0" . "[" . "\0" . "", "\\" . "\0" . "]" . "\0" . "", "\\" . "\0" . "(" . "\0" . "", "\\" . "\0" . ")" . "\0" . "", "\\" . "\0" . "~" . "\0" . "", "\\" . "\0" . "" . "\0" . "", "\\" . "\0" . ">" . "\0" . "", "\\" . "\0" . "#" . "\0" . "", "\\" . "\0" . "+" . "\0" . "", "\\" . "\0" . "-" . "\0" . "", "\\" . "\0" . "=" . "\0" . "", "\\" . "\0" . "|" . "\0" . "", "\\" . "\0" . "{" . "\0" . "", "\\" . "\0" . "}" . "\0" . "", "\\" . "\0" . "." . "\0" . "", "\\" . "\0" . "!" . "\0" . "", ]; $deltag2 = [ '/_\\000/', '/\\*\\000/', '/\\[\\000/', '/\\]\\000/', '/\\(\\000/', '/\\)\\000/', '/~\\000/', '/`\\000/', '/\\>\\000/', '/\\#\\000/', '/\\+\\000/', '/\\-\\000/', '/\\=\\000/', '/\\|\\000/', '/\\{\\000/', '/\\}\\000/', '/\\.\\000/', '/\\!\\000/', ]; for ($offset = 0; $offset < \strlen($utf16) / 2; $offset++) { $t = \substr($utf16, $offset * 2, 2); if (isset($this->setOffset[$offset])) { foreach ($this->setOffset[$offset] as $tt) { $htmlext .= $this->encode($tt); } unset($this->setOffset[$offset]); } $htmlext .= $slashmarkdown ? \preg_replace($deltag2, $deltag, $t) : $t; } foreach ($this->setOffset as $off) { foreach ($off as $tt) { $htmlext .= $this->encode($tt); } } return $this->decode($htmlext); } /** * markdownV1ToHtml * convert markdownv1 to html. */ public function markdownV1ToHtml(string $str): string { $str = \str_replace(["&", "<", ">"], ["&", "<", ">"], $str); $len = \mb_strlen($str); $backslash = ["_", "*", "`", "["]; $marks = []; $marksi = -1; $i = 0; $is = function ($string) use (&$i, &$str) { return \mb_substr($str, $i, \mb_strlen($string)) == $string; }; $find = function ($str, $find, &$i) use ($backslash) { $findlen = \mb_strlen($find); $newstr = ""; for ($i = 0; $i < \mb_strlen($str); $i++) { $curchar = \mb_substr($str, $i, 1); if ( $curchar == "\\" && \in_array(\mb_substr($str, $i + 1, 1), $backslash) ) { $newstr .= \mb_substr($str, $i + 1, 1); $i++; } elseif (\mb_substr($str, $i, $findlen) == $find) { return $newstr; } else { $newstr .= $curchar; } } return false; }; $html = ""; $htmli = 0; $setstr = function ($starttag) use (&$html, &$htmli): void { $html .= $starttag; $htmli += \mb_strlen($starttag); }; $i = 0; $setmark = function ($mark, &$currentmarki = 0, $fakemark = false) use ( &$marks, &$marksi, &$htmli, &$i ) { if ($marksi === -1 || $marks[$marksi][0] !== $mark) { $marksi++; $marks[$marksi] = [ $fakemark == false ? $mark : $fakemark, $htmli, $i, ]; return true; } $currentmarki = $marks[$marksi][1]; unset($marks[$marksi]); $marksi--; return false; }; $currentmarki = 0; $setstr2 = function ($endtag, $starttaglen) use ( &$setstr, &$html, &$htmli, &$currentmarki ): void { if ($htmli - $currentmarki > $starttaglen) { $setstr($endtag); } else { $htmli -= $starttaglen; $html = \mb_substr($html, 0, $htmli); } }; for ($i = 0; $i < $len; $i++) { $curchar = \mb_substr($str, $i, 1); if ( $curchar == "\\" && \in_array(\mb_substr($str, $i + 1, 1), $backslash) ) { $setstr(\mb_substr($str, $i + 1, 1)); $i++; } elseif ($curchar == "*") { if ($setmark("*", $currentmarki)) { $setstr("<b>"); } else { $setstr2("</b>", 3); } } elseif ($curchar == "_") { if ($setmark($curchar, $currentmarki)) { $setstr("<i>"); } else { $setstr2("</i>", 3); } } elseif ($curchar == "[") { $setmark("[", $currentmarki, "]"); } elseif ($curchar == "]") { if (!$setmark("]", $currentmarki, false) && $is("](")) { $txt = \mb_substr( $html, $currentmarki, $htmli - $currentmarki ); if ($txt !== "") { $i++; $strfind = $find(\mb_substr($str, $i + 1), ")", $pos); if ($strfind !== false) { $i += $pos + 1; $html = \mb_substr($html, 0, $currentmarki) . '<a href="' . $strfind . '">' . $txt . "</a>"; $htmli = \mb_strlen($html); } } } } elseif ($curchar == "`") { if ($is("```")) { $i += 2; $strfind = $find(\mb_substr($str, $i + 1), "```", $pos); if ($strfind !== false) { $i += $pos + 3; if ($strfind !== "") { $lang = ""; $ex = \explode("\n", $f, 2); if (isset($ex[1])) { $exx = \explode(" ", $ex[0], 2); if (isset($exx[1])) { $ex[1] = " " . $exx[1]; } $lang = \trim($exx[0]); $strfind = $ex[1]; } if ($lang) { $strfind = \trim($f); if ($strfind !== "") { $setstr( '<pre><code class="language-' . $lang . '">' . $strfind . "</code></pre>" ); } } else { $setstr("<pre>" . $strfind . "</pre>"); } } } else { throw new Exception( 'Can\'t find end of Pre entity at byte offset ' . $i ); } } else { $strfind = $find(\mb_substr($str, $i + 1), "`", $pos); if ($strfind !== false) { if ($strfind !== "") { $setstr("<code>" . $strfind . "</code>"); } $i += $pos + 1; } else { throw new Exception( 'Can\'t find end of Code entity at byte offset ' . $i ); } } } elseif (\in_array($curchar, $backslash)) { throw new Exception( "Character '$curchar' is reserved and must be escaped with the preceding '\'" ); } else { $setstr($curchar); } } foreach ($marks as $mark) { $ar = [ "*" => "Bold", "_" => "Italic", "]" => "TextUrl", ]; throw new Exception( 'Can\'t find end of ' . ($ar[$mark[0]] ?? $mark[0]) . " entity at byte offset " . $mark[2] ); } return $html; } /** * markdownToHtml * convert html tags to markdown format. */ public function markdownToHtml(string $str): string { $str = \str_replace(["&", "<", ">"], ["&", "<", ">"], $str); $len = \mb_strlen($str); $backslash = [ "_", "*", "[", "]", "(", ")", "~", "`", ">", "#", "+", "-", "=", "|", "{", "}", ".", "!", ]; $marks = []; $marksi = -1; $i = 0; $is = function ($string) use (&$i, &$str) { return \mb_substr($str, $i, \mb_strlen($string)) == $string; }; $find = function ($str, $find, &$i) use ($backslash) { $findlen = \mb_strlen($find); $newstr = ""; for ($i = 0; $i < \mb_strlen($str); $i++) { $curchar = \mb_substr($str, $i, 1); if ( $curchar == "\\" && \in_array(\mb_substr($str, $i + 1, 1), $backslash) ) { $newstr .= \mb_substr($str, $i + 1, 1); $i++; } elseif (\mb_substr($str, $i, $findlen) == $find) { return $newstr; } else { $newstr .= $curchar; } } return false; }; $html = ""; $htmli = 0; $setstr = function ($starttag) use (&$html, &$htmli): void { $html .= $starttag; $htmli += \mb_strlen($starttag); }; $i = 0; $setmark = function ($mark, &$currentmarki = 0, $fakemark = false) use ( &$marks, &$marksi, &$htmli, &$i ) { if ($marksi === -1 || $marks[$marksi][0] !== $mark) { $marksi++; $marks[$marksi] = [ $fakemark == false ? $mark : $fakemark, $htmli, $i, ]; return true; } $currentmarki = $marks[$marksi][1]; unset($marks[$marksi]); $marksi--; return false; }; $currentmarki = 0; $setstr2 = function ($endtag, $starttaglen) use ( &$setstr, &$html, &$htmli, &$currentmarki ): void { if ($htmli - $currentmarki > $starttaglen) { $setstr($endtag); } else { $htmli -= $starttaglen; $html = \mb_substr($html, 0, $htmli); } }; for ($i = 0; $i < $len; $i++) { $curchar = \mb_substr($str, $i, 1); if ( $curchar == "\\" && \in_array(\mb_substr($str, $i + 1, 1), $backslash) ) { $setstr(\mb_substr($str, $i + 1, 1)); $i++; } elseif ($curchar == "*") { $tag = "i"; if ( ($marksi === -1 || $marks[$marksi][0] !== $curchar) && $is("**") ) { $curchar = "**"; $tag = "b"; $i++; } if ($setmark($curchar, $currentmarki)) { $setstr("<$tag>"); } else { $setstr2("</$tag>", 3); } } elseif ($curchar == "_") { $tag = "u"; if ( ($marksi === -1 || $marks[$marksi][0] !== $curchar) && $is("__") ) { $curchar = "__"; $tag = "i"; $i++; } if ($setmark($curchar, $currentmarki)) { $setstr("<$tag>"); } else { $setstr2("</$tag>", 3); } } elseif ($curchar == "~" && $is("~~")) { if ($setmark("~~", $currentmarki)) { $setstr("<s>"); } else { $setstr2("</s>", 3); } $i++; } elseif ($curchar == "|" && $is("||")) { if ($setmark("||", $currentmarki)) { $setstr('<span class="tg-spoiler">'); } else { $setstr2("</span>", 25); } $i++; } elseif ($curchar == "[") { $setmark("[", $currentmarki, "]"); } elseif ($curchar == "]") { if (!$setmark("]", $currentmarki, false) && $is("](")) { $txt = \mb_substr( $html, $currentmarki, $htmli - $currentmarki ); if ($txt !== "") { $i++; $strfind = $find(\mb_substr($str, $i + 1), ")", $pos); if ($strfind !== false) { $i += $pos + 1; $html = \mb_substr($html, 0, $currentmarki) . '<a href="' . $strfind . '">' . $txt . "</a>"; $htmli = \mb_strlen($html); } } } } elseif ($curchar == "`") { if ($is("```")) { $i += 2; $strfind = $find(\mb_substr($str, $i + 1), "```", $pos); if ($strfind !== false) { $i += $pos + 3; if ($strfind !== "") { $lang = ""; $ex = \explode("\n", $f, 2); if (isset($ex[1])) { $exx = \explode(" ", $ex[0], 2); if (isset($exx[1])) { $ex[1] = " " . $exx[1]; } $lang = \trim($exx[0]); $strfind = $ex[1]; } if ($lang) { $strfind = \trim($f); if ($strfind !== "") { $setstr( '<pre><code class="language-' . $lang . '">' . $strfind . "</code></pre>" ); } } else { $setstr("<pre>" . $strfind . "</pre>"); } } } else { throw new Exception( 'Can\'t find end of Pre entity at byte offset ' . $i ); } } else { $strfind = $find(\mb_substr($str, $i + 1), "`", $pos); if ($strfind !== false) { if ($strfind !== "") { $setstr("<code>" . $strfind . "</code>"); } $i += $pos + 1; } else { throw new Exception( 'Can\'t find end of Code entity at byte offset ' . $i ); } } } elseif (\in_array($curchar, $backslash)) { throw new Exception( "Character '$curchar' is reserved and must be escaped with the preceding '\'" ); } else { $setstr($curchar); } } foreach ($marks as $mark) { $ar = [ "**" => "Bold", "__" => "Italic", "*" => "Italic", "_" => "Underline", "~~" => "Strikethrough", "]" => "TextUrl", "||" => "Spoiler", ]; throw new Exception( 'Can\'t find end of ' . ($ar[$mark[0]] ?? $mark[0]) . " entity at byte offset " . $mark[2] ); } return $html; } /** * htmlToEntities * convert html tags to entities. */ public function htmlToEntities(string $text): DOMEntities { return new DOMEntities($text); } /** * markdownToEntities * convert markdown format to entities. */ public function markdownToEntities(string $text): DOMEntities { return $this->htmlToEntities( $this->markdownToHtml($text) ); } /** * markdownV1ToEntities * convert markdownV1 to entities. */ public function markdownV1ToEntities(string $text): DOMEntities { return $this->htmlToEntities( $this->markdownV1ToHtml($text) ); } /** * markdownhtmlToEntities * convert mixed format(with markdown and html) to entities. */ public function markdownhtmlToEntities(string $text): DOMEntities { return $this->htmlToEntities( $this->markdownToHtml($text, false) ); } /** * markdownV1htmlToEntities * convert mixed format(with markdownv1 and html) to entities. */ public function markdownV1htmlToEntities(string $text): DOMEntities { return $this->htmlToEntities( $this->markdownV1ToHtml($text, false), ); } /** * htmlToMarkdown * convert html tags to markdown format. */ public function htmlToMarkdown(string $str, bool $slashmarkdown = true): string { $entities = $this->htmlToEntities($str); return $this->entitiesToMarkdown($entities->message, $entities->entities, $slashmarkdown); } /** * htmlToMarkdownv1 * convert html tags to markdownv1 format. */ public function htmlToMarkdownv1(string $str, bool $slashmarkdown = true): string { $entities = $this->htmlToEntities($str); return $this->entitiesToMarkdownV1($entities->message, $entities->entities, $slashmarkdown); } /** * parseText (main function) * function return formated text with entities or tags or format it to markdown & markdownv1. * * @param non-empty-string $text * @param "html"|"markdown"|"markdownv1"|"markdownv2"|"markdownhtml"|"markdownv2html"|"markdownv1html" $mode * */ public function parseText(string $text, string $mode = "html"): DOMEntities { return match ($mode) { 'html' => $this->htmlToEntities($text), 'markdown', 'markdownv2' => $this->markdownToEntities($text), 'markdownv1' => $this->markdownV1ToEntities($text), 'markdownhtml', 'markdownv2html' => $this->markdownhtmlToEntities($text), 'markdownv1html' => $this->markdownV1htmlToEntities($text), default => throw new Exception("unsupported mode") }; } } <?php /** * Exception module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL; /** * TL deserialization exception. */ class Exception extends \Exception { use PrettyException; public function __toString() { $result = static::class.($this->message !== '' ? ': ' : '').$this->message.PHP_EOL.\danog\MadelineProto\Magic::$revision.PHP_EOL.'TL Trace:'.PHP_EOL.PHP_EOL.$this->getTLTrace().PHP_EOL; if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg') { $result = \str_replace(PHP_EOL, '<br>'.PHP_EOL, $result); } return $result; } public function __construct($message, $file = '') { parent::__construct($message); $this->prettifyTL($file); } } <?php /** * TLParams module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\TL; trait TLParams { public function parseParams($key, $mtproto = false): void { foreach ($this->by_id[$key]['params'] as $kkey => $param) { if (\preg_match('/([^.]+)\\.(\\d+)\\?(.+)/', $param['type'], $matches)) { $param['flag'] = $matches[1]; $param['pow'] = \pow(2, $matches[2]); $param['type'] = $matches[3]; } if (\preg_match('/^(v|V)ector\\<(.*)\\>$/', $param['type'], $matches)) { $param['type'] = $matches[1] === 'v' ? 'vector' : 'Vector t'; $param['subtype'] = $matches[2]; $param['subtype'] = ($mtproto && $param['subtype'] === 'Message' ? 'MT' : '').$param['subtype']; $param['subtype'] = $mtproto && $param['subtype'] === '%Message' ? '%MTMessage' : $param['subtype']; } $param['type'] = ($mtproto && $param['type'] === 'Message' ? 'MT' : '').$param['type']; $param['type'] = $mtproto && $param['type'] === '%Message' ? '%MTMessage' : $param['type']; $this->by_id[$key]['params'][$kkey] = $param; } } } <?php /** * Shutdown module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; /** * Class that controls script shutdown. */ class Shutdown { /** * Callbacks to call on shutdown. * * @var array<callable> */ private static $callbacks = []; /** * Whether the main shutdown was registered. * * @var boolean */ private static $registered = false; /** * Incremental ID for new callback. * * @var integer */ private static $id = 0; /** * Function to be called on shutdown. * */ private static function shutdown(): void { foreach (self::$callbacks as $callback) { $callback(); } self::$callbacks = []; Magic::shutdown(0); } /** * Add a callback for script shutdown. * * @param callable $callback The callback to set * @param null|string $id The optional callback ID * * @return int|string The callback ID */ public static function addCallback($callback, $id = null) { if (!$id) { $id = self::$id++; } self::$callbacks[$id] = $callback; if (!self::$registered) { \register_shutdown_function(fn () => self::shutdown()); self::$registered = true; } return $id; } /** * Remove a callback from the script shutdown callable list. * * @param null|string|int $id The optional callback ID * * @return bool true if the callback was removed correctly, false otherwise */ public static function removeCallback($id) { if (isset(self::$callbacks[$id])) { unset(self::$callbacks[$id]); return true; } return false; } } <?php /** * EventHandler module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Sync\LocalMutex; use danog\MadelineProto\Db\DbPropertiesTrait; /** * Event handler. */ abstract class EventHandler extends InternalDoc { use DbPropertiesTrait { DbPropertiesTrait::initDb as private internalInitDb; } /** * Whether the event handler was started. */ private bool $startedInternal = false; private ?LocalMutex $startMutex = null; /** * API instance. */ protected MTProto $API; public function __construct($API) // BC { } /** * Start MadelineProto and the event handler (enables async). * * Also initializes error reporting, catching and reporting all errors surfacing from the event loop. * * @param string $session Session name * @param SettingsAbstract $settings Settings * */ final public static function startAndLoop(string $session, SettingsAbstract $settings): void { $API = new API($session, $settings); $API->startAndLoop(static::class); } /** * Start MadelineProto as a bot and the event handler (enables async). * * Also initializes error reporting, catching and reporting all errors surfacing from the event loop. * * @param string $session Session name * @param string $token Bot token * @param SettingsAbstract $settings Settings * */ final public static function startAndLoopBot(string $session, string $token, SettingsAbstract $settings): void { $API = new API($session, $settings); $API->botLogin($token); $API->startAndLoop(static::class); } /** * Internal constructor. * * @internal * * @param APIWrapper $MadelineProto MadelineProto instance * */ public function initInternal(APIWrapper $MadelineProto): void { self::link($this, $MadelineProto->getFactory()); $this->API =& $MadelineProto->getAPI(); foreach ($this->API->getMethodNamespaces() as $namespace) { $this->{$namespace} = $this->exportNamespace($namespace); } } /** * Start method handler. * * @internal * */ public function startInternal(): \Generator { $this->startMutex ??= new LocalMutex; $lock = yield $this->startMutex->acquire(); try { if ($this->startedInternal) { return; } if (isset(static::$dbProperties)) { yield from $this->internalInitDb($this->API); } if (\method_exists($this, 'onStart')) { yield $this->onStart(); } $this->startedInternal = true; } finally { $lock->release(); } } /** * Get peers where to send error reports. * * @return array|string|int */ public function getReportPeers() { return []; } /** * Get API instance. * */ public function getAPI(): MTProto { return $this->API; } } <?php /** * RSA module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use danog\MadelineProto\TL\TL; use phpseclib3\Math\BigInteger; /** * RSA class. */ class RSA { use \danog\Serializable; /** * Exponent. * * @var \phpseclib3\Math\BigInteger */ public $e; /** * Modulus. * * @var \phpseclib3\Math\BigInteger */ public $n; /** * Fingerprint. * * @var string */ public $fp; /** * Load RSA key. * * @param TL $TL TL serializer * @param string $rsa_key RSA key * * * @psalm-return \Generator<int|mixed, array|mixed, mixed, self> */ public static function load(TL $TL, string $rsa_key): \Generator { $key = \phpseclib3\Crypt\RSA::load($rsa_key); $instance = new self; $instance->n = Tools::getVar($key, 'modulus'); $instance->e = Tools::getVar($key, 'exponent'); $instance->fp = \substr(\sha1((yield from $TL->serializeObject(['type' => 'bytes'], $instance->n->toBytes(), 'key')).(yield from $TL->serializeObject(['type' => 'bytes'], $instance->e->toBytes(), 'key')), true), -8); return $instance; } /** * Private constructor. */ private function __construct() { } /** * Sleep function. * */ public function __sleep(): array { return ['e', 'n', 'fp']; } public function __wakeup(): void { foreach ($this->__sleep() as $bigint) { if ($this->{$bigint} instanceof \tgseclib\Math\BigInteger) { $this->{$bigint} = $this->{$bigint}->real; } } } /** * Encrypt data. * * @param BigInteger $data Data to encrypt * */ public function encrypt(BigInteger $data): string { return \str_pad($data->powMod($this->e, $this->n)->toBytes(), 256, "\0", STR_PAD_LEFT); } } <?php /** * Lua module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; /** * Lua interface. */ class Lua { public API $MadelineProto; protected $Lua; protected string $script; public function __construct(string $script, API $MadelineProto) { if (!\file_exists($script)) { throw new Exception(\danog\MadelineProto\Lang::$current_lang['script_not_exist']); } $this->MadelineProto = $MadelineProto; $this->script = $script; $this->__wakeup(); } public function __sleep() { return ['MadelineProto', 'script']; } public function __wakeup(): void { if (!\class_exists(\Lua::class)) { throw Exception::extension('lua'); } $this->Lua = new \Lua($this->script); $this->madelineproto_lua = 1; $this->Lua->registerCallback('tdcliFunction', [$this, 'tdcliFunction']); $this->Lua->registerCallback('madelineFunction', [$this, 'madelineFunction']); $this->Lua->registerCallback('var_dump', 'var_dump'); foreach (\get_class_methods($this->MadelineProto->API) as $method) { $this->Lua->registerCallback($method, [$this->MadelineProto, $method]); } $methods = []; foreach ($this->MadelineProto->getMethodsNamespaced() as $pair) { $namespace = \key($pair); $method = $pair[$namespace]; if ($namespace === 'upload') { continue; } $methods[$namespace][$method] = [$this->MadelineProto->{$namespace}, $method]; } foreach ($this->MadelineProto->getMethodsNamespaced() as $pair) { $namespace = \key($pair); $method = $pair[$namespace]; if ($namespace === 'upload') { continue; } $this->{$namespace} = $methods[$namespace]; } $this->MadelineProto->lua = true; foreach ($this->MadelineProto->getMethodsNamespaced() as $pair) { $namespace = \key($pair); $this->MadelineProto->{$namespace}->lua = true; } } /** * @return \Generator|int */ public function tdcliFunction($params, $cb = null, $cb_extra = null) { $params = $this->MadelineProto->td_to_mtproto($this->MadelineProto->tdcliToTd($params)); if ($params === 0) { return 0; } $result = $this->MadelineProto->API->methodCall($params['_'], $params); if (\is_callable($cb)) { $cb($this->MadelineProto->mtproto_to_td($result), $cb_extra); } return $result; } public function madelineFunction($params, $cb = null, $cb_extra = null) { $result = $this->MadelineProto->API->methodCall($params['_'], $params); if (\is_callable($cb)) { $cb($result, $cb_extra); } self::convertObjects($result); return $result; } public function tdcliUpdateCallback($update): void { $this->Lua->tdcliUpdateCallback($this->MadelineProto->mtproto_to_tdcli($update)); } private function convertArray($array) { if (!\is_array($array)) { return $array; } if ($this->is_seqential($array)) { return \array_flip(\array_map(function ($el) { return $el + 1; }, \array_flip($array))); } } private function isSequential(array $arr): bool { if ([] === $arr) { return false; } return isset($arr[0]) && \array_keys($arr) === \range(0, \count($arr) - 1); } public function __get($name) { if ($name === 'API') { return $this->MadelineProto->API; } return $this->Lua->{$name}; } public function __call($name, $params) { self::convertObjects($params); try { return $this->Lua->{$name}(...$params); } catch (\danog\MadelineProto\RPCErrorException $e) { return ['error_code' => $e->getCode(), 'error' => $e->getMessage()]; } catch (\danog\MadelineProto\Exception $e) { return ['error_code' => $e->getCode(), 'error' => $e->getMessage()]; } catch (\danog\MadelineProto\TL\Exception $e) { return ['error_code' => $e->getCode(), 'error' => $e->getMessage()]; } catch (\danog\MadelineProto\NothingInTheSocketException $e) { return ['error_code' => $e->getCode(), 'error' => $e->getMessage()]; } catch (\danog\MadelineProto\PTSException $e) { return ['error_code' => $e->getCode(), 'error' => $e->getMessage()]; } catch (\danog\MadelineProto\SecurityException $e) { return ['error_code' => $e->getCode(), 'error' => $e->getMessage()]; } catch (\danog\MadelineProto\TL\Conversion\Exception $e) { return ['error_code' => $e->getCode(), 'error' => $e->getMessage()]; } } public function __set($name, $value) { return $this->Lua->{$name} = $value; } public static function convertObjects(&$data): void { \array_walk_recursive($data, function (&$value, $key): void { if (\is_object($value) && !$value instanceof \phpseclib3\Math\BigInteger) { $newval = []; foreach (\get_class_methods($value) as $name) { $newval[$name] = [$value, $name]; } foreach ($value as $key => $name) { if ($key === 'madeline') { continue; } $newval[$key] = $name; } if ($newval === []) { $newval = $value->__toString(); } $value = $newval; } }); } } <?php /** * APIFactory module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use danog\MadelineProto\Async\AsyncConstruct; use danog\MadelineProto\Ipc\Client; use InvalidArgumentException; abstract class AbstractAPIFactory extends AsyncConstruct { /** * Namespace. * * @internal * */ private string $namespace = ''; /** * Whether lua is being used. * * @internal * * @var boolean */ public bool $lua = false; /** * Whether async is enabled. * * @internal * * @var boolean */ protected bool $async = false; /** * Method list. * * @var array<string, callable> */ protected array $methods = []; /** * Main API instance. */ private API $mainAPI; /** * Export APIFactory instance with the specified namespace. * * @param string $namespace Namespace * */ protected function exportNamespace(string $namespace = ''): self { $class = \array_reverse(\array_values(\class_parents(static::class)))[$namespace ? 2 : 3]; $instance = new $class; $instance->namespace = $namespace ? $namespace.'.' : ''; self::link($instance, $this); return $instance; } /** * Link two APIFactory instances. * * @param self $a First instance * @param self $b Second instance * */ protected static function link(self $a, self $b): void { $a->lua =& $b->lua; $a->async =& $b->async; $a->methods =& $b->methods; if ($b instanceof API) { $a->mainAPI = $b; $b->mainAPI = $b; } elseif ($a instanceof API) { $a->mainAPI = $a; $b->mainAPI = $a; } else { $a->mainAPI =& $b->mainAPI; } if (!$b->inited()) { $a->setInitPromise($b->initAsynchronously()); } } /** * Enable or disable async. * * @param bool $async Whether to enable or disable async * */ public function async(bool $async): void { $this->async = $async; } /** * Call async wrapper function. * * @param string $name Method name * @param array $arguments Arguments * * @internal * */ public function __call(string $name, array $arguments) { if ($arguments && !isset($arguments[0])) { $arguments = [$arguments]; } $yielded = Tools::call($this->__call_async($name, $arguments)); $async = !$this->lua && ((\is_array(\end($arguments)) ? \end($arguments) : [])['async'] ?? ($this->async && $name !== 'loop')); if ($async) { return $yielded; } $yielded = Tools::wait($yielded); if (!$this->lua) { return $yielded; } try { Lua::convertObjects($yielded); return $yielded; } catch (\Throwable $e) { return ['error_code' => $e->getCode(), 'error' => $e->getMessage()]; } } /** * Info to dump. * */ public function __debugInfo(): array { $keys = APIWrapper::properties(); $res = []; foreach ($keys as $key) { if (Tools::hasVar($this, $key)) { $res[$key] = Tools::getVar($this, $key); } } return $res; } /** * Sleep function. * * @return array */ public function __sleep() { return []; } /** * Call async wrapper function. * * @param string $name Method name * @param array $arguments Arguments * * @internal * */ public function __call_async(string $name, array $arguments): \Generator { yield from $this->initAsynchronously(); $lower_name = \strtolower($name); if ($this->namespace !== '' || !isset($this->methods[$lower_name])) { $name = $this->namespace.$name; $aargs = isset($arguments[1]) && \is_array($arguments[1]) ? $arguments[1] : []; $aargs['apifactory'] = true; $args = isset($arguments[0]) && \is_array($arguments[0]) ? $arguments[0] : []; if (isset($args[0]) && !isset($args['multiple'])) { throw new InvalidArgumentException("Parameter names must be provided!"); } return yield from $this->mainAPI->API->methodCallAsyncRead($name, $args, $aargs); } if ($lower_name === 'seteventhandler' || ($lower_name === 'loop' && !isset($arguments[0])) ) { yield from $this->mainAPI->reconnectFull(); } $res = $this->methods[$lower_name](...$arguments); return $res instanceof \Generator ? yield from $res : yield $res; } /** * Get fully resolved method list for object, including snake_case and camelCase variants. * * @param API|MTProto|Client $value Value * @param string $class Custom class name * */ protected static function getInternalMethodList($value, string $class = null): array { return \array_map(fn ($method) => [$value, $method], self::getInternalMethodListClass($class ?? \get_class($value))); } /** * Get fully resolved method list for object, including snake_case and camelCase variants. * * @param string $class Class name * */ protected static function getInternalMethodListClass(string $class): array { static $cache = []; if (isset($cache[$class])) { return $cache[$class]; } $methods = \get_class_methods($class); foreach ($methods as $method) { if ($method == 'methodCallAsyncRead') { unset($methods[\array_search('methodCall', $methods)]); } elseif (\stripos($method, 'async') !== false) { if (\strpos($method, '_async') !== false) { unset($methods[\array_search(\str_ireplace('_async', '', $method), $methods)]); } else { unset($methods[\array_search(\str_ireplace('async', '', $method), $methods)]); } } } $finalMethods = []; foreach ($methods as $method) { $actual_method = $method; if ($method == 'methodCallAsyncRead') { $method = 'methodCall'; } elseif (\stripos($method, 'async') !== false) { if (\strpos($method, '_async') !== false) { $method = \str_ireplace('_async', '', $method); } else { $method = \str_ireplace('async', '', $method); } } $finalMethods[\strtolower($method)] = $actual_method; if (\strpos($method, '_') !== false) { $finalMethods[\strtolower(\str_replace('_', '', $method))] = $actual_method; } else { $finalMethods[\strtolower(StrTools::toSnakeCase($method))] = $actual_method; } } $cache[$class] = $finalMethods; return $finalMethods; } } <?php /** * Connection module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\ByteStream\ClosedException; use Amp\Deferred; use Amp\Failure; use danog\MadelineProto\Loop\Connection\CheckLoop; use danog\MadelineProto\Loop\Connection\CleanupLoop; use danog\MadelineProto\Loop\Connection\HttpWaitLoop; use danog\MadelineProto\Loop\Connection\PingLoop; use danog\MadelineProto\Loop\Connection\ReadLoop; use danog\MadelineProto\Loop\Connection\WriteLoop; use danog\MadelineProto\MTProto\OutgoingMessage; use danog\MadelineProto\MTProtoSession\Session; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\MTProtoTransport\HttpsStream; use danog\MadelineProto\Stream\MTProtoTransport\HttpStream; use danog\MadelineProto\Stream\StreamInterface; /** * Connection class. * * Manages connection to Telegram datacenters * * @internal * * @author Daniil Gentili <daniil@daniil.it> */ class Connection { use Session; use \danog\Serializable; /** * Writer loop. * * @var \danog\MadelineProto\Loop\Connection\WriteLoop */ protected $writer; /** * Reader loop. * * @var \danog\MadelineProto\Loop\Connection\ReadLoop */ protected $reader; /** * Checker loop. * * @var \danog\MadelineProto\Loop\Connection\CheckLoop */ protected $checker; /** * Waiter loop. * * @var \danog\MadelineProto\Loop\Connection\HttpWaitLoop */ protected $waiter; /** * Ping loop. * * @var \danog\MadelineProto\Loop\Connection\PingLoop */ protected $pinger; /** * Cleanup loop. * * @var \danog\MadelineProto\Loop\Connection\CleanupLoop */ protected $cleanup; /** * The actual socket. * * @var StreamInterface */ public $stream; /** * Connection context. * * @var ConnectionContext */ private $ctx; /** * HTTP request count. * * @var integer */ private $httpReqCount = 0; /** * HTTP response count. * * @var integer */ private $httpResCount = 0; /** * Date of last chunk received. * */ private float $lastChunk = 0; /** * Logger instance. * * @var Logger */ protected $logger; /** * Main instance. * * @var MTProto */ public $API; /** * Shared connection instance. * * @var DataCenterConnection */ protected $shared; /** * DC ID. * * @var string */ protected $datacenter; /** * Connection ID. * * @var int */ private $id = 0; /** * DC ID and connection ID concatenated. * */ private $datacenterId = ''; /** * Whether this socket has to be reconnected. * * @var boolean */ private $needsReconnect = false; /** * Indicate if this socket needs to be reconnected. * * @param boolean $needsReconnect Whether the socket has to be reconnected * */ public function needReconnect(bool $needsReconnect): void { $this->needsReconnect = $needsReconnect; } /** * Whether this sockets needs to be reconnected. * * @return boolean */ public function shouldReconnect(): bool { return $this->needsReconnect; } /** * Set writing boolean. * * @param boolean $writing * */ public function writing(bool $writing): void { $this->shared->writing($writing, $this->id); } /** * Set reading boolean. * * @param boolean $reading * */ public function reading(bool $reading): void { $this->shared->reading($reading, $this->id); } /** * Tell the class that we have read a chunk of data from the socket. * */ public function haveRead(): void { $this->lastChunk = \microtime(true); } /** * Get the receive date of the latest chunk of data from the socket. * */ public function getLastChunk(): float { return $this->lastChunk; } /** * Indicate a received HTTP response. * */ public function httpReceived(): void { $this->httpResCount++; } /** * Count received HTTP responses. * * @return integer */ public function countHttpReceived(): int { return $this->httpResCount; } /** * Indicate a sent HTTP request. * */ public function httpSent(): void { $this->httpReqCount++; } /** * Count sent HTTP requests. * * @return integer */ public function countHttpSent(): int { return $this->httpReqCount; } /** * Get connection ID. * * @return integer */ public function getID(): int { return $this->id; } /** * Get datacenter concatenated with connection ID. * */ public function getDatacenterID(): string { return $this->datacenterId; } /** * Get connection context. * */ public function getCtx(): ConnectionContext { return $this->ctx; } /** * Check if is an HTTP connection. * * @return boolean */ public function isHttp(): bool { return \in_array($this->ctx->getStreamName(), [HttpStream::class, HttpsStream::class]); } /** * Check if is a media connection. * * @return boolean */ public function isMedia(): bool { return $this->ctx->isMedia(); } /** * Check if is a CDN connection. * * @return boolean */ public function isCDN(): bool { return $this->ctx->isCDN(); } /** * Connects to a telegram DC using the specified protocol, proxy and connection parameters. * * @param ConnectionContext $ctx Connection context * * * @psalm-return \Generator<mixed, StreamInterface, mixed, void> */ public function connect(ConnectionContext $ctx): \Generator { $this->ctx = $ctx->getCtx(); $this->datacenter = $ctx->getDc(); $this->datacenterId = $this->datacenter . '.' . $this->id; $this->API->logger->logger("Connecting to DC {$this->datacenterId}", \danog\MadelineProto\Logger::WARNING); $this->createSession(); $ctx->setReadCallback([$this, 'haveRead']); $this->stream = (yield from $ctx->getStream()); $this->API->logger->logger("Connected to DC {$this->datacenterId}!", \danog\MadelineProto\Logger::WARNING); if ($this->needsReconnect) { $this->needsReconnect = false; } $this->httpReqCount = 0; $this->httpResCount = 0; if (!isset($this->writer)) { $this->writer = new WriteLoop($this); } if (!isset($this->reader)) { $this->reader = new ReadLoop($this); } if (!isset($this->checker)) { $this->checker = new CheckLoop($this); } if (!isset($this->cleanup)) { $this->cleanup = new CleanupLoop($this); } if (!isset($this->waiter)) { $this->waiter = new HttpWaitLoop($this); } if (!isset($this->pinger) && !$this->ctx->isMedia() && !$this->ctx->isCDN()) { $this->pinger = new PingLoop($this); } foreach ($this->new_outgoing as $message_id => $message) { if ($message->isUnencrypted()) { if (!($message->getState() & OutgoingMessage::STATE_REPLIED)) { $message->reply(new Failure(new Exception('Restart because we were reconnected'))); } unset($this->new_outgoing[$message_id], $this->outgoing_messages[$message_id]); } } $this->writer->start(); $this->reader->start(); if (!$this->checker->start()) { $this->checker->resume(); } $this->cleanup->start(); $this->waiter->start(); if ($this->pinger) { $this->pinger->start(); } /*if (!isset($this->r)) { $this->r = true; Tools::callFork((function () { yield Tools::sleep(3); yield from $this->reconnect(); })()); }*/ } /** * Apply method abstractions. * * @param string $method Method name * @param array $arguments Arguments * * @return \Generator Whether we need to resolve a queue promise */ private function methodAbstractions(string &$method, array &$arguments): \Generator { if ($method === 'messages.importChatInvite' && isset($arguments['hash']) && \is_string($arguments['hash']) && $r = Tools::parseLink($arguments['hash'])) { [$invite, $content] = $r; if ($invite) { $arguments['hash'] = $content; } else { $method = 'channels.joinChannel'; $arguments['channel'] = $content; } } elseif ($method === 'messages.checkChatInvite' && isset($arguments['hash']) && \is_string($arguments['hash']) && $r = Tools::parseLink($arguments['hash'])) { [$invite, $content] = $r; if (!$invite) { throw new TL\Exception('This is not an invite link!'); } $arguments['hash'] = $content; } elseif ($method === 'channels.joinChannel' && isset($arguments['channel']) && \is_string($arguments['channel']) && $r = Tools::parseLink($arguments['channel'])) { [$invite, $content] = $r; if ($invite) { $method = 'messages.importChatInvite'; $arguments['hash'] = $content; } else { $arguments['channel'] = $content; } } elseif ($method === 'messages.sendMessage' && isset($arguments['peer']['_']) && \in_array($arguments['peer']['_'], ['inputEncryptedChat', 'updateEncryption', 'updateEncryptedChatTyping', 'updateEncryptedMessagesRead', 'updateNewEncryptedMessage', 'encryptedMessage', 'encryptedMessageService'])) { $method = 'messages.sendEncrypted'; $arguments = ['peer' => $arguments['peer'], 'message' => $arguments]; if (!isset($arguments['message']['_'])) { $arguments['message']['_'] = 'decryptedMessage'; } if (!isset($arguments['message']['ttl'])) { $arguments['message']['ttl'] = 0; } if (isset($arguments['message']['reply_to_msg_id'])) { $arguments['message']['reply_to_random_id'] = $arguments['message']['reply_to_msg_id']; } } elseif ($method === 'messages.sendMultiMedia') { foreach ($arguments['multi_media'] as &$singleMedia) { if ($singleMedia['media']['_'] === 'inputMediaUploadedPhoto' || $singleMedia['media']['_'] === 'inputMediaUploadedDocument' ) { $singleMedia['media'] = yield from $this->methodCallAsyncRead('messages.uploadMedia', ['peer' => $arguments['peer'], 'media' => $singleMedia['media']]); } } $this->logger->logger($arguments); } elseif ($method === 'messages.sendEncryptedFile' || $method === 'messages.uploadEncryptedFile') { if (isset($arguments['file'])) { if ((!\is_array($arguments['file']) || !(isset($arguments['file']['_']) && $this->API->getTL()->getConstructors()->findByPredicate($arguments['file']['_']) === 'InputEncryptedFile')) && $this->API->getSettings()->getFiles()->getAllowAutomaticUpload()) { $arguments['file'] = (yield from $this->API->uploadEncrypted($arguments['file'])); } if (isset($arguments['file']['key'])) { $arguments['message']['media']['key'] = $arguments['file']['key']; } if (isset($arguments['file']['iv'])) { $arguments['message']['media']['iv'] = $arguments['file']['iv']; } if (isset($arguments['file']['size'])) { $arguments['message']['media']['size'] = $arguments['file']['size']; } } $arguments['queuePromise'] = new Deferred; return $arguments['queuePromise']; } elseif (\in_array($method, ['messages.addChatUser', 'messages.deleteChatUser', 'messages.editChatAdmin', 'messages.editChatPhoto', 'messages.editChatTitle', 'messages.getFullChat', 'messages.exportChatInvite', 'messages.editChatAdmin', 'messages.migrateChat']) && isset($arguments['chat_id']) && (!\is_numeric($arguments['chat_id']) || $arguments['chat_id'] < 0)) { $res = yield from $this->API->getInfo($arguments['chat_id']); if ($res['type'] !== 'chat') { throw new \danog\MadelineProto\Exception('chat_id is not a chat id (only normal groups allowed, not supergroups)!'); } $arguments['chat_id'] = $res['chat_id']; } elseif ($method === 'photos.updateProfilePhoto') { if (isset($arguments['id'])) { if (!\is_array($arguments['id'])) { $method = 'photos.uploadProfilePhoto'; $arguments['file'] = $arguments['id']; } } elseif (isset($arguments['file'])) { $method = 'photos.uploadProfilePhoto'; } } elseif ($method === 'photos.uploadProfilePhoto') { if (isset($arguments['file'])) { if (\is_array($arguments['file']) && !\in_array($arguments['file']['_'], ['inputFile', 'inputFileBig'])) { $method = 'photos.uploadProfilePhoto'; $arguments['id'] = $arguments['file']; } } elseif (isset($arguments['id'])) { $method = 'photos.updateProfilePhoto'; } } elseif ($method === 'messages.uploadMedia') { if (!isset($arguments['peer']) && !$this->API->getSelf()['bot']) { $arguments['peer'] = 'me'; } } elseif ($method === 'channels.deleteUserHistory') { $method = 'channels.deleteParticipantHistory'; if (isset($arguments['user_id'])) { $arguments['participant'] = $arguments['user_id']; } } if ($method === 'messages.sendEncrypted' || $method === 'messages.sendEncryptedService') { $arguments['queuePromise'] = new Deferred; return $arguments['queuePromise']; } return null; } /** * Send an MTProto message. * * @param OutgoingMessage $message The message to send * @param boolean $flush Whether to flush the message right away * */ public function sendMessage(OutgoingMessage $message, bool $flush = true): \Generator { $message->trySend(); $promise = $message->getSendPromise(); if (!$message->hasSerializedBody() || $message->shouldRefreshReferences()) { $body = yield from $message->getBody(); if ($message->shouldRefreshReferences()) { $this->API->referenceDatabase->refreshNext(true); } if ($message->isMethod()) { $method = $message->getConstructor(); $queuePromise = yield from $this->methodAbstractions($method, $body); $body = yield from $this->API->getTL()->serializeMethod($method, $body); } else { $body['_'] = $message->getConstructor(); $body = yield from $this->API->getTL()->serializeObject(['type' => ''], $body, $message->getConstructor()); } if ($message->shouldRefreshReferences()) { $this->API->referenceDatabase->refreshNext(false); } $message->setSerializedBody($body); unset($body); } $this->pendingOutgoing[$this->pendingOutgoingKey++] = $message; if (isset($queuePromise)) { $queuePromise->resolve(); } if ($flush && isset($this->writer)) { $this->writer->resumeDeferOnce(); } return yield $promise; } /** * Flush pending packets. * */ public function flush(): void { if (isset($this->writer)) { $this->writer->resumeDeferOnce(); } } /** * Resume HttpWaiter. * */ public function pingHttpWaiter(): void { if (isset($this->waiter)) { $this->waiter->resume(); } if (isset($this->pinger)) { $this->pinger->resume(); } } /** * Connect main instance. * * @param DataCenterConnection $extra Shared instance * @param int $id Connection ID * */ public function setExtra($extra, int $id): void { $this->shared = $extra; $this->id = $id; $this->API = $extra->getExtra(); $this->logger = $this->API->logger; } /** * Get main instance. * */ public function getExtra(): MTProto { return $this->API; } /** * Get shared connection instance. * */ public function getShared(): DataCenterConnection { return $this->shared; } /** * Disconnect from DC. * * @param bool $temporary Whether the disconnection is temporary, triggered by the reconnect method * */ public function disconnect(bool $temporary = false): void { $this->API->logger->logger("Disconnecting from DC {$this->datacenterId}"); $this->needsReconnect = true; foreach (['reader', 'writer', 'checker', 'waiter', 'updater', 'pinger', 'cleanup'] as $loop) { if (isset($this->{$loop}) && $this->{$loop}) { $this->{$loop}->signal($loop === 'reader' ? new NothingInTheSocketException() : true); } } if ($this->stream) { try { $this->stream->disconnect(); } catch (ClosedException $e) { $this->API->logger->logger($e); } } if (!$temporary) { $this->shared->signalDisconnect($this->id); } $this->API->logger->logger("Disconnected from DC {$this->datacenterId}"); } /** * Reconnect to DC. * */ public function reconnect(): \Generator { $this->API->logger->logger("Reconnecting DC {$this->datacenterId}"); $this->disconnect(true); yield from $this->API->datacenter->dcConnect($this->ctx->getDc(), $this->id); } /** * Get name. * */ public function getName(): string { return __CLASS__; } } <?php /** * Tools module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Deferred; use Amp\Failure; use Amp\Loop; use Amp\Promise; use Amp\Success; use Amp\TimeoutException; use function Amp\ByteStream\getOutputBufferStream; use function Amp\ByteStream\getStdin; use function Amp\ByteStream\getStdout; use function Amp\delay; use function Amp\File\exists; use function Amp\File\touch as touchAsync; use function Amp\Promise\all; use function Amp\Promise\any; use function Amp\Promise\first; use function Amp\Promise\some; use function Amp\Promise\timeout; use function Amp\Promise\wait; /** * Some tools. */ abstract class Tools extends StrTools { /** * Boolean to avoid problems with exceptions thrown by forked strands, see tools. * * @var boolean */ public bool $destructing = false; /** * Sanify TL obtained from JSON for TL serialization. * * @param array $input Data to sanitize * * @internal * */ public static function convertJsonTL(array $input): array { $cb = static function (&$val) use (&$cb): void { if (isset($val['@type'])) { $val['_'] = $val['@type']; } elseif (\is_array($val)) { \array_walk($val, $cb); } }; \array_walk($input, $cb); return $input; } /** * Generate MTProto vector hash. * * @param array $ints IDs * * @return string Vector hash */ public static function genVectorHash(array $ints): string { $hash = 0; foreach ($ints as $id) { $hash = $hash ^ ($id >> 21); $hash = $hash ^ ($id << 35); $hash = $hash ^ ($id >> 4); $hash = $hash + $id; } return Tools::packSignedLong($hash); } /** * Get random integer. * * @param integer $modulus Modulus * */ public static function randomInt(int $modulus = 0): int { if ($modulus === 0) { $modulus = PHP_INT_MAX; } try { return \random_int(0, PHP_INT_MAX) % $modulus; } catch (\Exception $e) { // random_compat will throw an Exception, which in PHP 5 does not implement Throwable } catch (\Throwable $e) { // If a sufficient source of randomness is unavailable, random_bytes() will throw an // object that implements the Throwable interface (Exception, TypeError, Error). // We don't actually need to do anything here. The string() method should just continue // as normal. } $number = self::unpackSignedLong(self::random(8)); return ($number & PHP_INT_MAX) % $modulus; } /** * Get random string of specified length. * * @param integer $length Length * * @return string Random string */ public static function random(int $length): string { return $length === 0 ? '' : \phpseclib3\Crypt\Random::string($length); } /** * Positive modulo * Works just like the % (modulus) operator, only returns always a postive number. * * @param int $a A * @param int $b B * * @return int Modulo */ public static function posmod(int $a, int $b): int { $resto = $a % $b; return $resto < 0 ? $resto + \abs($b) : $resto; } /** * Unpack base256 signed int. * * @param string $value base256 int * * @return integer */ public static function unpackSignedInt(string $value): int { if (\strlen($value) !== 4) { throw new TL\Exception(\danog\MadelineProto\Lang::$current_lang['length_not_4']); } return \unpack('l', \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev($value) : $value)[1]; } /** * Unpack base256 signed long. * * @param string $value base256 long * * @return integer */ public static function unpackSignedLong(string $value): int { if (\strlen($value) !== 8) { throw new TL\Exception(\danog\MadelineProto\Lang::$current_lang['length_not_8']); } return \unpack('q', \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev($value) : $value)[1]; } /** * Unpack base256 signed long to string. * * @param string|int|array $value base256 long * */ public static function unpackSignedLongString($value): string { if (\is_int($value)) { return (string) $value; } if (\is_array($value) && \count($value) === 2) { $value = \pack('l2', $value); } if (\strlen($value) !== 8) { throw new TL\Exception(\danog\MadelineProto\Lang::$current_lang['length_not_8']); } return (string) self::unpackSignedLong($value); } /** * Convert integer to base256 signed int. * * @param integer $value Value to convert * */ public static function packSignedInt(int $value): string { if ($value > 2147483647) { throw new TL\Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['value_bigger_than_2147483647'], $value)); } if ($value < -2147483648) { throw new TL\Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['value_smaller_than_2147483648'], $value)); } $res = \pack('l', $value); return \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev($res) : $res; } /** * Convert integer to base256 long. * * @param int $value Value to convert * */ public static function packSignedLong(int $value): string { return \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev(\pack('q', $value)) : \pack('q', $value); } /** * Convert value to unsigned base256 int. * * @param int $value Value * */ public static function packUnsignedInt(int $value): string { if ($value > 4294967295) { throw new TL\Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['value_bigger_than_4294967296'], $value)); } if ($value < 0) { throw new TL\Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['value_smaller_than_0'], $value)); } return \pack('V', $value); } /** * Convert double to binary version. * * @param float $value Value to convert * */ public static function packDouble(float $value): string { $res = \pack('d', $value); if (\strlen($res) !== 8) { throw new TL\Exception(\danog\MadelineProto\Lang::$current_lang['encode_double_error']); } return \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev($res) : $res; } /** * Unpack binary double. * * @param string $value Value to unpack * */ public static function unpackDouble(string $value): float { if (\strlen($value) !== 8) { throw new TL\Exception(\danog\MadelineProto\Lang::$current_lang['length_not_8']); } return \unpack('d', \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev($value) : $value)[1]; } /** * Synchronously wait for a promise|generator. * * @param \Generator|Promise $promise The promise to wait for * @param boolean $ignoreSignal Whether to ignore shutdown signals * */ public static function wait($promise, $ignoreSignal = false) { if ($promise instanceof \Generator) { $promise = new Coroutine($promise); } elseif (!$promise instanceof Promise) { return $promise; } $exception = null; $value = null; $resolved = false; do { try { //Logger::log("Starting event loop..."); Loop::run(function () use (&$resolved, &$value, &$exception, $promise): void { $promise->onResolve(function ($e, $v) use (&$resolved, &$value, &$exception): void { Loop::stop(); $resolved = true; $exception = $e; $value = $v; }); }); } catch (\Throwable $throwable) { Logger::log('Loop exceptionally stopped without resolving the promise', Logger::FATAL_ERROR); Logger::log((string) $throwable, Logger::FATAL_ERROR); throw $throwable; } } while (!$resolved && !(Magic::$signaled && !$ignoreSignal)); if ($exception) { throw $exception; } return $value; } /** * Returns a promise that succeeds when all promises succeed, and fails if any promise fails. * Returned promise succeeds with an array of values used to succeed each contained promise, with keys corresponding to the array of promises. * * @param array<\Generator|Promise> $promises Promises * */ public static function all(array $promises): Promise { foreach ($promises as &$promise) { $promise = self::call($promise); } /** @var Promise[] $promises */ return all($promises); } /** * Returns a promise that is resolved when all promises are resolved. The returned promise will not fail. * * @param array<Promise|\Generator> $promises Promises * */ public static function any(array $promises): Promise { foreach ($promises as &$promise) { $promise = self::call($promise); } /** @var Promise[] $promises */ return any($promises); } /** * Resolves with a two-item array delineating successful and failed Promise results. * The returned promise will only fail if the given number of required promises fail. * * @param array<Promise|\Generator> $promises Promises * */ public static function some(array $promises): Promise { foreach ($promises as &$promise) { $promise = self::call($promise); } /** @var Promise[] $promises */ return some($promises); } /** * Returns a promise that succeeds when the first promise succeeds, and fails only if all promises fail. * * @param array<Promise|\Generator> $promises Promises * */ public static function first(array $promises): Promise { foreach ($promises as &$promise) { $promise = self::call($promise); } /** @var Promise[] $promises */ return first($promises); } /** * Create an artificial timeout for any \Generator or Promise. * * @param \Generator|Promise $promise * @param integer $timeout * */ public static function timeout($promise, int $timeout): Promise { $promise = self::call($promise); $deferred = new Deferred; $watcher = Loop::delay($timeout, static function () use (&$deferred): void { $temp = $deferred; // prevent double resolve $deferred = null; $temp->fail(new TimeoutException); }); //Loop::unreference($watcher); $promise->onResolve(function () use (&$deferred, $promise, $watcher): void { if ($deferred !== null) { Loop::cancel($watcher); $deferred->resolve($promise); } }); return $deferred->promise(); } /** * Creates an artificial timeout for any `Promise`. * * If the promise is resolved before the timeout expires, the result is returned * * If the timeout expires before the promise is resolved, a default value is returned * * @template TReturnAlt * @template TReturn * @template TGenerator as \Generator<mixed, mixed, mixed, TReturn> * * @param Promise|Generator $promise Promise to which the timeout is applied. * @param int $timeout Timeout in milliseconds. * * @psalm-param Promise<TReturn>|TGenerator $promise Promise to which the timeout is applied. * @psalm-param TReturnAlt $default * * @return Promise<TReturn>|Promise<TReturnAlt> * * @throws \TypeError If $promise is not an instance of \Amp\Promise, \Generator or \React\Promise\PromiseInterface. */ public static function timeoutWithDefault($promise, int $timeout, $default = null): Promise { $promise = self::call($promise); $deferred = new Deferred; $watcher = Loop::delay($timeout, static function () use (&$deferred, $default): void { $temp = $deferred; // prevent double resolve $deferred = null; $temp->resolve($default); }); //Loop::unreference($watcher); $promise->onResolve(function () use (&$deferred, $promise, $watcher): void { if ($deferred !== null) { Loop::cancel($watcher); $deferred->resolve($promise); } }); return $deferred->promise(); } /** * Convert generator, promise or any other value to a promise. * * @param \Generator|Promise|mixed $promise * * @template TReturn * @psalm-param \Generator<mixed, mixed, mixed, TReturn>|Promise<TReturn>|TReturn $promise * * @psalm-return Promise<TReturn> */ public static function call($promise): Promise { if ($promise instanceof \Generator) { $promise = new Coroutine($promise); } elseif (!$promise instanceof Promise) { return new Success($promise); } return $promise; } /** * Call promise in background. * * @param \Generator|Promise $promise Promise to resolve * @param ?\Generator|Promise $actual Promise to resolve instead of $promise * @param string $file File * * @psalm-suppress InvalidScope * * @return Promise|mixed */ public static function callFork($promise, $actual = null, $file = '') { if ($actual) { $promise = $actual; } if ($promise instanceof \Generator) { $promise = new Coroutine($promise); } if ($promise instanceof Promise) { $promise->onResolve(function ($e, $res) use ($file): void { if ($e) { if (isset($this)) { $this->rethrow($e, $file); } else { self::rethrow($e, $file); } } }); } return $promise; } /** * Call promise in background, deferring execution. * * @param \Generator|Promise $promise Promise to resolve * */ public static function callForkDefer($promise): void { Loop::defer(fn () => self::callFork($promise)); } /** * Rethrow error catched in strand. * * @param \Throwable $e Exception * @param string $file File where the strand started * * @psalm-suppress InvalidScope * */ public static function rethrow(\Throwable $e, $file = ''): void { $zis = isset($this) ? $this : null; $logger = isset($zis->logger) ? $zis->logger : Logger::$default; if ($file) { $file = " started @ {$file}"; } if ($logger) { $logger->logger("Got the following exception within a forked strand{$file}, trying to rethrow"); } if ($e->getMessage() === "Cannot get return value of a generator that hasn't returned") { $logger->logger("Well you know, this might actually not be the actual exception, scroll up in the logs to see the actual exception"); if (!$zis || !$zis->destructing) { Promise\rethrow(new Failure($e)); } } else { if ($logger) { $logger->logger($e); } Promise\rethrow(new Failure($e)); } } /** * Call promise $b after promise $a. * * @param \Generator|Promise $a Promise A * @param \Generator|Promise $b Promise B * * @psalm-suppress InvalidScope * */ public static function after($a, $b): Promise { $a = self::call($a); $deferred = new Deferred(); $a->onResolve(static function ($e, $res) use ($b, $deferred): void { if ($e) { if (isset($this)) { $this->rethrow($e); } else { self::rethrow($e); } return; } $b = self::call($b); $b->onResolve(function ($e, $res) use ($deferred): void { if ($e) { if (isset($this)) { $this->rethrow($e); } else { self::rethrow($e); } return; } $deferred->resolve($res); }); }); return $deferred->promise(); } /** * Asynchronously lock a file * Resolves with a callbable that MUST eventually be called in order to release the lock. * * @param string $file File to lock * @param integer $operation Locking mode * @param float $polling Polling interval * @param ?Promise $token Cancellation token * @param ?callable $failureCb Failure callback, called only once if the first locking attempt fails. * * @return Promise<$token is null ? callable : ?callable> */ public static function flock(string $file, int $operation, float $polling = 0.1, ?Promise $token = null, $failureCb = null): Promise { return self::call(Tools::flockGenerator($file, $operation, $polling, $token, $failureCb)); } /** * Asynchronously lock a file (internal generator function). * * @param string $file File to lock * @param integer $operation Locking mode * @param float $polling Polling interval * @param ?Promise $token Cancellation token * @param ?callable $failureCb Failure callback, called only once if the first locking attempt fails. * * @internal Generator function * * @psalm-return \Generator<mixed, mixed, mixed, ?callable> */ public static function flockGenerator(string $file, int $operation, float $polling, ?Promise $token = null, $failureCb = null): \Generator { $polling *= 1000; $polling = (int) $polling; if (!yield exists($file)) { yield touchAsync($file); } $operation |= LOCK_NB; $res = \fopen($file, 'c'); do { $result = \flock($res, $operation); if (!$result) { if ($failureCb) { $failureCb(); $failureCb = null; } if ($token) { if (yield Tools::timeoutWithDefault($token, $polling, false)) { return; } } else { yield delay($polling); } } } while (!$result); return static function () use (&$res): void { if ($res) { \flock($res, LOCK_UN); \fclose($res); $res = null; } }; } /** * Asynchronously sleep. * * @param int|float $time Number of seconds to sleep for * */ public static function sleep($time): Promise { return new \Amp\Delayed((int) ($time * 1000)); } /** * Asynchronously read line. * * @param string $prompt Prompt * * @return Promise<string> */ public static function readLine(string $prompt = ''): Promise { return self::call(Tools::readLineGenerator($prompt)); } /** * Asynchronously read line (generator function). * * @param string $prompt Prompt * * @internal Generator function * * * @psalm-return \Generator<int, Promise|Promise<null|string>, mixed, mixed|null> */ public static function readLineGenerator(string $prompt = ''): \Generator { try { Magic::togglePeriodicLogging(); $stdin = getStdin(); $stdout = getStdout(); if ($prompt) { yield $stdout->write($prompt); } static $lines = ['']; while (\count($lines) < 2 && ($chunk = yield $stdin->read()) !== null) { $chunk = \explode("\n", \str_replace(["\r", "\n\n"], "\n", $chunk)); $lines[\count($lines) - 1] .= \array_shift($chunk); $lines = \array_merge($lines, $chunk); } } finally { Magic::togglePeriodicLogging(); } return \array_shift($lines); } /** * Asynchronously write to stdout/browser. * * @param string $string Message to echo * */ public static function echo(string $string): Promise { return getOutputBufferStream()->write($string); } /** * Check if is array or similar (traversable && countable && arrayAccess). * * @param mixed $var Value to check * * @return boolean */ public static function isArrayOrAlike($var): bool { return \is_array($var) || $var instanceof \ArrayAccess && $var instanceof \Traversable && $var instanceof \Countable; } /** * Create array. * * @param mixed ...$params Params * */ public static function arr(...$params): array { return $params; } /** * base64URL decode. * * @param string $data Data to decode * */ public static function base64urlDecode(string $data): string { return \base64_decode(\str_pad(\strtr($data, '-_', '+/'), \strlen($data) % 4, '=', STR_PAD_RIGHT)); } /** * Base64URL encode. * * @param string $data Data to encode * */ public static function base64urlEncode(string $data): string { return \rtrim(\strtr(\base64_encode($data), '+/', '-_'), '='); } /** * null-byte RLE decode. * * @param string $string Data to decode * */ public static function rleDecode(string $string): string { $new = ''; $last = ''; $null = \chr(0); foreach (\str_split($string) as $cur) { if ($last === $null) { $new .= \str_repeat($last, \ord($cur)); $last = ''; } else { $new .= $last; $last = $cur; } } $string = $new.$last; return $string; } /** * null-byte RLE encode. * * @param string $string Data to encode * */ public static function rleEncode(string $string): string { $new = ''; $count = 0; $null = \chr(0); foreach (\str_split($string) as $cur) { if ($cur === $null) { $count++; } else { if ($count > 0) { $new .= $null.\chr($count); $count = 0; } $new .= $cur; } } return $new; } /** * Inflate stripped photosize to full JPG payload. * * @param string $stripped Stripped photosize * * @return string JPG payload */ public static function inflateStripped(string $stripped): string { if (\strlen($stripped) < 3 || \ord($stripped[0]) !== 1) { return $stripped; } $header = "\xff\xd8\xff\xe0\x00\x10\x4a\x46\x49". "\x46\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00\x43\x00\x28\x1c". "\x1e\x23\x1e\x19\x28\x23\x21\x23\x2d\x2b\x28\x30\x3c\x64\x41\x3c\x37\x37". "\x3c\x7b\x58\x5d\x49\x64\x91\x80\x99\x96\x8f\x80\x8c\x8a\xa0\xb4\xe6\xc3". "\xa0\xaa\xda\xad\x8a\x8c\xc8\xff\xcb\xda\xee\xf5\xff\xff\xff\x9b\xc1\xff". "\xff\xff\xfa\xff\xe6\xfd\xff\xf8\xff\xdb\x00\x43\x01\x2b\x2d\x2d\x3c\x35". "\x3c\x76\x41\x41\x76\xf8\xa5\x8c\xa5\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8". "\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8". "\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8". "\xf8\xf8\xf8\xf8\xf8\xff\xc0\x00\x11\x08\x00\x00\x00\x00\x03\x01\x22\x00". "\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01". "\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08". "\x09\x0a\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05". "\x04\x04\x00\x00\x01\x7d\x01\x02\x03\x00\x04\x11\x05\x12\x21\x31\x41\x06". "\x13\x51\x61\x07\x22\x71\x14\x32\x81\x91\xa1\x08\x23\x42\xb1\xc1\x15\x52". "\xd1\xf0\x24\x33\x62\x72\x82\x09\x0a\x16\x17\x18\x19\x1a\x25\x26\x27\x28". "\x29\x2a\x34\x35\x36\x37\x38\x39\x3a\x43\x44\x45\x46\x47\x48\x49\x4a\x53". "\x54\x55\x56\x57\x58\x59\x5a\x63\x64\x65\x66\x67\x68\x69\x6a\x73\x74\x75". "\x76\x77\x78\x79\x7a\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96". "\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6". "\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6". "\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4". "\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01". "\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08". "\x09\x0a\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05". "\x04\x04\x00\x01\x02\x77\x00\x01\x02\x03\x11\x04\x05\x21\x31\x06\x12\x41". "\x51\x07\x61\x71\x13\x22\x32\x81\x08\x14\x42\x91\xa1\xb1\xc1\x09\x23\x33". "\x52\xf0\x15\x62\x72\xd1\x0a\x16\x24\x34\xe1\x25\xf1\x17\x18\x19\x1a\x26". "\x27\x28\x29\x2a\x35\x36\x37\x38\x39\x3a\x43\x44\x45\x46\x47\x48\x49\x4a". "\x53\x54\x55\x56\x57\x58\x59\x5a\x63\x64\x65\x66\x67\x68\x69\x6a\x73\x74". "\x75\x76\x77\x78\x79\x7a\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94". "\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4". "\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4". "\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4". "\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00". "\x3f\x00"; static $footer = "\xff\xd9"; $header[164] = $stripped[1]; $header[166] = $stripped[2]; return $header.\substr($stripped, 3).$footer; } /** * Close connection with client, connected via web. * * @param string $message Message * */ public static function closeConnection($message): void { if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg' || isset($GLOBALS['exited']) || \headers_sent() || isset($_GET['MadelineSelfRestart']) || Magic::$isIpcWorker) { return; } $buffer = @\ob_get_clean() ?: ''; $buffer .= $message; \ignore_user_abort(true); \header('Connection: close'); \header('Content-Type: text/html'); echo $buffer; \flush(); $GLOBALS['exited'] = true; if (\function_exists('fastcgi_finish_request')) { fastcgi_finish_request(); } } /** * Get maximum photo size. * * @internal * */ public static function maxSize(array $sizes): array { $maxPixels = 0; $max = null; foreach ($sizes as $size) { if (isset($size['w'], $size['h'])) { $curPixels = $size['w'] * $size['h']; if ($curPixels > $maxPixels) { $maxPixels = $curPixels; $max = $size; } } } if (!$max) { $maxType = 0; foreach ($sizes as $size) { $curType = \ord($size['type']); if ($curType > $maxType) { $maxType = $curType; $max = $size; } } } return $max; } /** * Get final element of array. * * @param array $what Array * */ public static function end(array $what) { return \end($what); } /** * Whether this is altervista. * * @return boolean */ public static function isAltervista(): bool { return Magic::$altervista; } /** * Checks private property exists in an object. * * @param object $obj Object * @param string $var Attribute name * * @psalm-suppress InvalidScope * * @access public */ public static function hasVar($obj, string $var): bool { return \Closure::bind( function () use ($var) { return isset($this->{$var}); }, $obj, \get_class($obj) )->__invoke(); } /** * Accesses a private variable from an object. * * @param object $obj Object * @param string $var Attribute name * * @psalm-suppress InvalidScope * * @access public */ public static function &getVar($obj, string $var) { return \Closure::bind( function &() use ($var) { return $this->{$var}; }, $obj, \get_class($obj) )->__invoke(); } /** * Sets a private variable in an object. * * @param object $obj Object * @param string $var Attribute name * @param mixed $val Attribute value * * @psalm-suppress InvalidScope * * * @access public */ public static function setVar($obj, string $var, &$val): void { \Closure::bind( function () use ($var, &$val): void { $this->{$var} =& $val; }, $obj, \get_class($obj) )->__invoke(); } /** * Get absolute path to file, related to session path. * * @param string $file File * * @internal * */ public static function absolute(string $file): string { if (($file[0] ?? '') !== '/' && ($file[1] ?? '') !== ':' && !\in_array(\substr($file, 0, 4), ['phar', 'http'])) { $file = Magic::getcwd().DIRECTORY_SEPARATOR.$file; } return $file; } /** * Parse t.me link. * * @internal * * @return array{0: bool, 1: string}|null */ public static function parseLink(string $link): ?array { if (\preg_match('@([a-z0-9_-]*)\\.(?:t|telegram)\.(?:me|dog)@', $link, $matches)) { if ($matches[1] !== 'www') { return [false, $matches[1]]; } } if (\preg_match('@(?:t|telegram)\\.(?:me|dog)/(joinchat/|\+)?([a-z0-9_-]*)@i', $link, $matches)) { return [!!$matches[1], $matches[2]]; } return null; } } <?php /** * Magic module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Deferred; use Amp\Loop; use Amp\Loop\Driver; use danog\MadelineProto\TL\Conversion\Extension; use ReflectionClass; use function Amp\ByteStream\getStdin; use function Amp\File\read; use function Amp\Log\hasColorSupport; use function Amp\Promise\wait; class Magic { const ZERO_CHANNEL_ID = -1000000000000; /** * Static storage. * * @var array */ public static $storage = []; /** * Whether this system is bigendian. * * @var boolean */ public static $BIG_ENDIAN = false; /** * Whether this is a TTY console. * * @var boolean */ public static $isatty = false; /** * Whether we're in a fork. * * @var boolean */ public static $isFork = false; /** * Whether this is an IPC worker. */ public static bool $isIpcWorker = false; /** * Whether we can get our PID. * * @var boolean */ public static $can_getmypid = true; /** * Whether we can amphp/parallel. * * @var boolean */ public static $can_parallel = false; /** * Whether we can get our CWD. * * @var boolean */ public static $can_getcwd = false; /** * Whether we've processed forks. * * @var boolean */ public static $processed_fork = false; /** * Whether we can use ipv6. * * @var bool */ public static $ipv6 = false; /** * Our PID. * * @var int */ public static $pid; /** * Whether we've inited all light constants. * * @var boolean */ private static $initedLight = false; /** * Whether we've inited all static constants. * * @var boolean */ private static $inited = false; /** * Whether we've inited the ipv6 property. * * @var boolean */ private static $initedIpv6 = false; /** * Bigint zero. * * @var \phpseclib3\Math\BigInteger */ public static $zero; /** * Bigint one. * * @var \phpseclib3\Math\BigInteger */ public static $one; /** * Bigint two. * * @var \phpseclib3\Math\BigInteger */ public static $two; /** * Bigint 2^1984. * * @var \phpseclib3\Math\BigInteger */ public static $twoe1984; /** * Bigint 2^2047. * * @var \phpseclib3\Math\BigInteger */ public static $twoe2047; /** * Bigint 2^2048. * * @var \phpseclib3\Math\BigInteger */ public static $twoe2048; /** * Decoded UTF8 emojis for call fingerprint. * * @var array */ public static $emojis; /** * MadelineProto revision. * * @var string */ public static $revision; /** * MadelineProto version (clean). * * @var string */ public static $version; /** * Latest MadelineProto version. * * @var string */ public static $version_latest; /** * Our CWD. * * @var string */ public static $cwd; /** * Caller script CWD. * * @var string */ public static $script_cwd; /** * Whether we're running on altervista. * * @var boolean */ public static $altervista = false; /** * Wether we're running on 000webhost (yuck). * * @var boolean */ public static $zerowebhost = false; /** * Whether a signal was sent to the processand the system must shut down. * * @var boolean */ public static $signaled = false; /** * Whether to suspend certain stdout log printing, when reading input. * * @var ?Deferred */ public static $suspendPeriodicLogging; /** * All mime types. * * @var array<string, string> */ public static $allMimes = []; /** * Whether the openssl extension is loaded. * * @var boolean */ public static bool $hasOpenssl = false; /** * Encoded emojis. * * @var string */ const JSON_EMOJIS = '["\\ud83d\\ude09","\\ud83d\\ude0d","\\ud83d\\ude1b","\\ud83d\\ude2d","\\ud83d\\ude31","\\ud83d\\ude21","\\ud83d\\ude0e","\\ud83d\\ude34","\\ud83d\\ude35","\\ud83d\\ude08","\\ud83d\\ude2c","\\ud83d\\ude07","\\ud83d\\ude0f","\\ud83d\\udc6e","\\ud83d\\udc77","\\ud83d\\udc82","\\ud83d\\udc76","\\ud83d\\udc68","\\ud83d\\udc69","\\ud83d\\udc74","\\ud83d\\udc75","\\ud83d\\ude3b","\\ud83d\\ude3d","\\ud83d\\ude40","\\ud83d\\udc7a","\\ud83d\\ude48","\\ud83d\\ude49","\\ud83d\\ude4a","\\ud83d\\udc80","\\ud83d\\udc7d","\\ud83d\\udca9","\\ud83d\\udd25","\\ud83d\\udca5","\\ud83d\\udca4","\\ud83d\\udc42","\\ud83d\\udc40","\\ud83d\\udc43","\\ud83d\\udc45","\\ud83d\\udc44","\\ud83d\\udc4d","\\ud83d\\udc4e","\\ud83d\\udc4c","\\ud83d\\udc4a","\\u270c","\\u270b","\\ud83d\\udc50","\\ud83d\\udc46","\\ud83d\\udc47","\\ud83d\\udc49","\\ud83d\\udc48","\\ud83d\\ude4f","\\ud83d\\udc4f","\\ud83d\\udcaa","\\ud83d\\udeb6","\\ud83c\\udfc3","\\ud83d\\udc83","\\ud83d\\udc6b","\\ud83d\\udc6a","\\ud83d\\udc6c","\\ud83d\\udc6d","\\ud83d\\udc85","\\ud83c\\udfa9","\\ud83d\\udc51","\\ud83d\\udc52","\\ud83d\\udc5f","\\ud83d\\udc5e","\\ud83d\\udc60","\\ud83d\\udc55","\\ud83d\\udc57","\\ud83d\\udc56","\\ud83d\\udc59","\\ud83d\\udc5c","\\ud83d\\udc53","\\ud83c\\udf80","\\ud83d\\udc84","\\ud83d\\udc9b","\\ud83d\\udc99","\\ud83d\\udc9c","\\ud83d\\udc9a","\\ud83d\\udc8d","\\ud83d\\udc8e","\\ud83d\\udc36","\\ud83d\\udc3a","\\ud83d\\udc31","\\ud83d\\udc2d","\\ud83d\\udc39","\\ud83d\\udc30","\\ud83d\\udc38","\\ud83d\\udc2f","\\ud83d\\udc28","\\ud83d\\udc3b","\\ud83d\\udc37","\\ud83d\\udc2e","\\ud83d\\udc17","\\ud83d\\udc34","\\ud83d\\udc11","\\ud83d\\udc18","\\ud83d\\udc3c","\\ud83d\\udc27","\\ud83d\\udc25","\\ud83d\\udc14","\\ud83d\\udc0d","\\ud83d\\udc22","\\ud83d\\udc1b","\\ud83d\\udc1d","\\ud83d\\udc1c","\\ud83d\\udc1e","\\ud83d\\udc0c","\\ud83d\\udc19","\\ud83d\\udc1a","\\ud83d\\udc1f","\\ud83d\\udc2c","\\ud83d\\udc0b","\\ud83d\\udc10","\\ud83d\\udc0a","\\ud83d\\udc2b","\\ud83c\\udf40","\\ud83c\\udf39","\\ud83c\\udf3b","\\ud83c\\udf41","\\ud83c\\udf3e","\\ud83c\\udf44","\\ud83c\\udf35","\\ud83c\\udf34","\\ud83c\\udf33","\\ud83c\\udf1e","\\ud83c\\udf1a","\\ud83c\\udf19","\\ud83c\\udf0e","\\ud83c\\udf0b","\\u26a1","\\u2614","\\u2744","\\u26c4","\\ud83c\\udf00","\\ud83c\\udf08","\\ud83c\\udf0a","\\ud83c\\udf93","\\ud83c\\udf86","\\ud83c\\udf83","\\ud83d\\udc7b","\\ud83c\\udf85","\\ud83c\\udf84","\\ud83c\\udf81","\\ud83c\\udf88","\\ud83d\\udd2e","\\ud83c\\udfa5","\\ud83d\\udcf7","\\ud83d\\udcbf","\\ud83d\\udcbb","\\u260e","\\ud83d\\udce1","\\ud83d\\udcfa","\\ud83d\\udcfb","\\ud83d\\udd09","\\ud83d\\udd14","\\u23f3","\\u23f0","\\u231a","\\ud83d\\udd12","\\ud83d\\udd11","\\ud83d\\udd0e","\\ud83d\\udca1","\\ud83d\\udd26","\\ud83d\\udd0c","\\ud83d\\udd0b","\\ud83d\\udebf","\\ud83d\\udebd","\\ud83d\\udd27","\\ud83d\\udd28","\\ud83d\\udeaa","\\ud83d\\udeac","\\ud83d\\udca3","\\ud83d\\udd2b","\\ud83d\\udd2a","\\ud83d\\udc8a","\\ud83d\\udc89","\\ud83d\\udcb0","\\ud83d\\udcb5","\\ud83d\\udcb3","\\u2709","\\ud83d\\udceb","\\ud83d\\udce6","\\ud83d\\udcc5","\\ud83d\\udcc1","\\u2702","\\ud83d\\udccc","\\ud83d\\udcce","\\u2712","\\u270f","\\ud83d\\udcd0","\\ud83d\\udcda","\\ud83d\\udd2c","\\ud83d\\udd2d","\\ud83c\\udfa8","\\ud83c\\udfac","\\ud83c\\udfa4","\\ud83c\\udfa7","\\ud83c\\udfb5","\\ud83c\\udfb9","\\ud83c\\udfbb","\\ud83c\\udfba","\\ud83c\\udfb8","\\ud83d\\udc7e","\\ud83c\\udfae","\\ud83c\\udccf","\\ud83c\\udfb2","\\ud83c\\udfaf","\\ud83c\\udfc8","\\ud83c\\udfc0","\\u26bd","\\u26be","\\ud83c\\udfbe","\\ud83c\\udfb1","\\ud83c\\udfc9","\\ud83c\\udfb3","\\ud83c\\udfc1","\\ud83c\\udfc7","\\ud83c\\udfc6","\\ud83c\\udfca","\\ud83c\\udfc4","\\u2615","\\ud83c\\udf7c","\\ud83c\\udf7a","\\ud83c\\udf77","\\ud83c\\udf74","\\ud83c\\udf55","\\ud83c\\udf54","\\ud83c\\udf5f","\\ud83c\\udf57","\\ud83c\\udf71","\\ud83c\\udf5a","\\ud83c\\udf5c","\\ud83c\\udf61","\\ud83c\\udf73","\\ud83c\\udf5e","\\ud83c\\udf69","\\ud83c\\udf66","\\ud83c\\udf82","\\ud83c\\udf70","\\ud83c\\udf6a","\\ud83c\\udf6b","\\ud83c\\udf6d","\\ud83c\\udf6f","\\ud83c\\udf4e","\\ud83c\\udf4f","\\ud83c\\udf4a","\\ud83c\\udf4b","\\ud83c\\udf52","\\ud83c\\udf47","\\ud83c\\udf49","\\ud83c\\udf53","\\ud83c\\udf51","\\ud83c\\udf4c","\\ud83c\\udf50","\\ud83c\\udf4d","\\ud83c\\udf46","\\ud83c\\udf45","\\ud83c\\udf3d","\\ud83c\\udfe1","\\ud83c\\udfe5","\\ud83c\\udfe6","\\u26ea","\\ud83c\\udff0","\\u26fa","\\ud83c\\udfed","\\ud83d\\uddfb","\\ud83d\\uddfd","\\ud83c\\udfa0","\\ud83c\\udfa1","\\u26f2","\\ud83c\\udfa2","\\ud83d\\udea2","\\ud83d\\udea4","\\u2693","\\ud83d\\ude80","\\u2708","\\ud83d\\ude81","\\ud83d\\ude82","\\ud83d\\ude8b","\\ud83d\\ude8e","\\ud83d\\ude8c","\\ud83d\\ude99","\\ud83d\\ude97","\\ud83d\\ude95","\\ud83d\\ude9b","\\ud83d\\udea8","\\ud83d\\ude94","\\ud83d\\ude92","\\ud83d\\ude91","\\ud83d\\udeb2","\\ud83d\\udea0","\\ud83d\\ude9c","\\ud83d\\udea6","\\u26a0","\\ud83d\\udea7","\\u26fd","\\ud83c\\udfb0","\\ud83d\\uddff","\\ud83c\\udfaa","\\ud83c\\udfad","\\ud83c\\uddef\\ud83c\\uddf5","\\ud83c\\uddf0\\ud83c\\uddf7","\\ud83c\\udde9\\ud83c\\uddea","\\ud83c\\udde8\\ud83c\\uddf3","\\ud83c\\uddfa\\ud83c\\uddf8","\\ud83c\\uddeb\\ud83c\\uddf7","\\ud83c\\uddea\\ud83c\\uddf8","\\ud83c\\uddee\\ud83c\\uddf9","\\ud83c\\uddf7\\ud83c\\uddfa","\\ud83c\\uddec\\ud83c\\udde7","1\\u20e3","2\\u20e3","3\\u20e3","4\\u20e3","5\\u20e3","6\\u20e3","7\\u20e3","8\\u20e3","9\\u20e3","0\\u20e3","\\ud83d\\udd1f","\\u2757","\\u2753","\\u2665","\\u2666","\\ud83d\\udcaf","\\ud83d\\udd17","\\ud83d\\udd31","\\ud83d\\udd34","\\ud83d\\udd35","\\ud83d\\udd36","\\ud83d\\udd37"]'; /** * Initialize magic constants. * * @param bool $light Use lightweight initialization routine * */ public static function start(bool $light = false): void { if (self::$inited || (self::$initedLight && $light)) { return; } if (PHP_INT_SIZE < 8) { throw new \danog\MadelineProto\Exception('A 64-bit build of PHP is required to run MadelineProto, PHP 8.0+ recommended.', 0, null, 'MadelineProto', 1); } if (!self::$initedLight) { // Setup error reporting \set_error_handler([Exception::class, 'ExceptionErrorHandler']); \set_exception_handler([Exception::class, 'ExceptionHandler']); self::$isIpcWorker = \defined('MADELINE_WORKER_TYPE') ? \MADELINE_WORKER_TYPE === 'madeline-ipc' : false; // Important, obtain root relative to caller script $backtrace = \debug_backtrace(0); self::$script_cwd = self::$cwd = \dirname(\end($backtrace)['file']); if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg') { try { \error_reporting(E_ALL); \ini_set('log_errors', 1); \ini_set('error_log', Magic::$script_cwd.DIRECTORY_SEPARATOR.'MadelineProto.log'); } catch (\Throwable $e) { //$this->logger->logger('Could not enable PHP logging'); } } try { \ini_set('memory_limit', -1); } catch (\Throwable $e) { } // Check if we're in a console, for colorful log output try { self::$isatty = \defined('STDOUT') && hasColorSupport(); } catch (\Throwable $e) { } try { self::$cwd = \getcwd(); self::$can_getcwd = true; } catch (\Throwable $e) { } try { if (\function_exists('set_time_limit')) { \set_time_limit(-1); } } catch (\Throwable $e) { } // Define signal handlers if (\defined('SIGINT')) { //if (function_exists('pcntl_async_signals')) pcntl_async_signals(true); try { \pcntl_signal(SIGINT, fn () => null); \pcntl_signal(SIGINT, SIG_DFL); Loop::unreference(Loop::onSignal(SIGINT, static function (): void { Logger::log('Got sigint', Logger::FATAL_ERROR); Magic::shutdown(self::$isIpcWorker ? 0 : 1); })); Loop::unreference(Loop::onSignal(SIGTERM, static function (): void { Logger::log('Got sigterm', Logger::FATAL_ERROR); Magic::shutdown(self::$isIpcWorker ? 0 : 1); })); } catch (\Throwable $e) { } } self::$altervista = isset($_SERVER['SERVER_ADMIN']) && \strpos($_SERVER['SERVER_ADMIN'], 'altervista.org'); self::$zerowebhost = isset($_SERVER['SERVER_ADMIN']) && \strpos($_SERVER['SERVER_ADMIN'], '000webhost.io'); self::$initedLight = true; if ($light) { if (!\defined('AMP_WORKER')) { \define('AMP_WORKER', true); } return; } } foreach (['xml', 'fileinfo', 'json', 'mbstring'] as $extension) { if (!\extension_loaded($extension)) { throw Exception::extension($extension); } } self::$BIG_ENDIAN = \pack('L', 1) === \pack('N', 1); if (\class_exists('\\danog\\MadelineProto\\VoIP')) { if (!\defined('\\danog\\MadelineProto\\VoIP::PHP_LIBTGVOIP_VERSION') || !\in_array(\danog\MadelineProto\VoIP::PHP_LIBTGVOIP_VERSION, ['1.5.0'])) { throw new \danog\MadelineProto\Exception(\hex2bin(\danog\MadelineProto\Lang::$current_lang['v_tgerror']), 0, null, 'MadelineProto', 1); } } self::$hasOpenssl = \extension_loaded('openssl'); self::$emojis = \json_decode(self::JSON_EMOJIS); self::$zero = new \phpseclib3\Math\BigInteger(0); self::$one = new \phpseclib3\Math\BigInteger(1); self::$two = new \phpseclib3\Math\BigInteger(2); self::$twoe1984 = new \phpseclib3\Math\BigInteger('010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000', 16); self::$twoe2047 = new \phpseclib3\Math\BigInteger('80000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000', 16); self::$twoe2048 = new \phpseclib3\Math\BigInteger('0100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000', 16); self::$can_getmypid = !self::$altervista && !self::$zerowebhost; if (\file_exists(__DIR__.'/../../../.git/refs/heads/master')) { self::$version = null; try { self::$version = @\file_get_contents(__DIR__.'/../../../.git/refs/heads/master'); } catch (\Throwable $e) { } } if (self::$version) { self::$revision = 'Revision: '.self::$version; self::$version_latest = null; try { $php = (string) \min(81, (int) (PHP_MAJOR_VERSION.PHP_MINOR_VERSION)); self::$version_latest = @\file_get_contents("https://phar.madelineproto.xyz/release$php"); } catch (\Throwable $e) { } if (self::$version_latest !== self::$version) { self::$revision .= ' (AN UPDATE IS REQUIRED)'; }; } self::$can_parallel = false; if ((PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') && !(\class_exists(\Phar::class) && \Phar::running())) { try { $back = \debug_backtrace(0); if (!\defined('AMP_WORKER')) { \define('AMP_WORKER', 1); } $promise = read(\end($back)['file']); do { try { if (wait($promise)) { self::$can_parallel = true; break; } } catch (\Throwable $e) { if ($e->getMessage() !== 'Loop stopped without resolving the promise') { throw $e; } } } while (true); } catch (\Throwable $e) { } } if (!self::$can_parallel && !\defined('AMP_WORKER')) { \define('AMP_WORKER', 1); } try { $res = \json_decode(@\file_get_contents('https://rpc.madelineproto.xyz/v3.json'), true); } catch (\Throwable $e) { } if (isset($res, $res['ok']) && $res['ok']) { RPCErrorException::$errorMethodMap = $res['result']; RPCErrorException::$descriptions += $res['human_result']; } foreach (Extension::ALL_MIMES as $ext => $mimes) { $ext = ".$ext"; foreach ($mimes as $mime) { if (!isset(self::$allMimes[$mime])) { self::$allMimes[$mime] = $ext; } } } self::$inited = true; } /** * Check if this is a POSIX fork of the main PHP process. * * @return boolean */ public static function isFork() { if (self::$isFork) { return true; } if (!self::$can_getmypid) { return false; } try { if (self::$pid === null) { self::$pid = \getmypid(); } return self::$isFork = self::$pid !== \getmypid(); } catch (\Throwable $e) { return self::$can_getmypid = false; } } /** * Get current working directory. * */ public static function getcwd(): string { return self::$can_getcwd ? \getcwd() : self::$cwd; } /** * Shutdown system. * * @param int $code Exit code * */ public static function shutdown(int $code = 0): void { self::$signaled = true; if (\defined('STDIN')) { getStdin()->unreference(); } if ($code !== 0) { $driver = Loop::get(); $reflectionClass = new ReflectionClass(Driver::class); $reflectionProperty = $reflectionClass->getProperty('watchers'); $reflectionProperty->setAccessible(true); foreach (\array_keys($reflectionProperty->getValue($driver)) as $key) { $driver->unreference($key); } } MTProto::serializeAll(); Loop::stop(); if (\class_exists(Installer::class)) { Installer::unlock(); } die($code); } /** * Toggle periodic logging. */ public static function togglePeriodicLogging(): void { if (self::$suspendPeriodicLogging) { $deferred = self::$suspendPeriodicLogging; self::$suspendPeriodicLogging = null; $deferred->resolve(); } else { self::$suspendPeriodicLogging = new Deferred; } } /** * Set whether we can use ipv6. * * @param bool $ipv6 Whether we can use ipv6. * */ public static function setIpv6(bool $ipv6): void { if (!self::$initedIpv6) { self::$ipv6 = $ipv6; self::$initedIpv6 = true; } } } <?php /** * MadelineProto fileserver. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Files; use Amp\Http\Server\HttpServer; use danog\MadelineProto\Exception; /** * MadelineProto fileserver. */ class Server { /** * Constructor function. */ public function __construct() { if (!\class_exists(HttpServer::class)) { throw new Exception("Please install https://github.com/amphp/http-server to use this module (composer require amphp/http-server)"); } } } <?php /* Copyright 2016-2018 Daniil Gentili (https://daniil.it) This file is part of MadelineProto. MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU General Public License along with MadelineProto. If not, see <http://www.gnu.org/licenses/>. */ namespace danog\MadelineProto; use Amp\Delayed; use Amp\Loop; use danog\MadelineProto\MTProto\PermAuthKey; use danog\MadelineProto\Stream\Common\FileBufferedStream; use danog\MadelineProto\Stream\ConnectionContext; use danog\MadelineProto\Stream\Ogg\Ogg; use danog\MadelineProto\VoIP\Endpoint; use SplQueue; use function Amp\File\openFile; if (\extension_loaded('php-libtgvoip')) { return; } class VoIP { use \danog\MadelineProto\VoIP\MessageHandler; use \danog\MadelineProto\VoIP\AckHandler; const PHP_LIBTGVOIP_VERSION = '1.5.0'; const STATE_CREATED = 0; const STATE_WAIT_INIT = 1; const STATE_WAIT_INIT_ACK = 2; const STATE_ESTABLISHED = 3; const STATE_FAILED = 4; const STATE_RECONNECTING = 5; const TGVOIP_ERROR_UNKNOWN = 0; const TGVOIP_ERROR_INCOMPATIBLE = 1; const TGVOIP_ERROR_TIMEOUT = 2; const TGVOIP_ERROR_AUDIO_IO = 3; const NET_TYPE_UNKNOWN = 0; const NET_TYPE_GPRS = 1; const NET_TYPE_EDGE = 2; const NET_TYPE_3G = 3; const NET_TYPE_HSPA = 4; const NET_TYPE_LTE = 5; const NET_TYPE_WIFI = 6; const NET_TYPE_ETHERNET = 7; const NET_TYPE_OTHER_HIGH_SPEED = 8; const NET_TYPE_OTHER_LOW_SPEED = 9; const NET_TYPE_DIALUP = 10; const NET_TYPE_OTHER_MOBILE = 11; const DATA_SAVING_NEVER = 0; const DATA_SAVING_MOBILE = 1; const DATA_SAVING_ALWAYS = 2; const PROXY_NONE = 0; const PROXY_SOCKS5 = 1; const AUDIO_STATE_NONE = -1; const AUDIO_STATE_CREATED = 0; const AUDIO_STATE_CONFIGURED = 1; const AUDIO_STATE_RUNNING = 2; const CALL_STATE_NONE = -1; const CALL_STATE_REQUESTED = 0; const CALL_STATE_INCOMING = 1; const CALL_STATE_ACCEPTED = 2; const CALL_STATE_CONFIRMED = 3; const CALL_STATE_READY = 4; const CALL_STATE_ENDED = 5; const PKT_INIT = 1; const PKT_INIT_ACK = 2; const PKT_STREAM_STATE = 3; const PKT_STREAM_DATA = 4; const PKT_UPDATE_STREAMS = 5; const PKT_PING = 6; const PKT_PONG = 7; const PKT_STREAM_DATA_X2 = 8; const PKT_STREAM_DATA_X3 = 9; const PKT_LAN_ENDPOINT = 10; const PKT_NETWORK_CHANGED = 11; const PKT_SWITCH_PREF_RELAY = 12; const PKT_SWITCH_TO_P2P = 13; const PKT_NOP = 14; const TLID_DECRYPTED_AUDIO_BLOCK_HEX = 'dbf948c1'; const TLID_SIMPLE_AUDIO_BLOCK_HEX = 'cc0d0e76'; const TLID_REFLECTOR_SELF_INFO_HEX = 'c01572c7'; const TLID_REFLECTOR_PEER_INFO_HEX = '27D9371C'; const PROTO_ID = 'GrVP'; const PROTOCOL_VERSION = 9; const MIN_PROTOCOL_VERSION = 9; const STREAM_TYPE_AUDIO = 1; const STREAM_TYPE_VIDEO = 2; const CODEC_OPUS = 'SUPO'; private $TLID_DECRYPTED_AUDIO_BLOCK; private $TLID_SIMPLE_AUDIO_BLOCK; private $TLID_REFLECTOR_SELF_INFO; private $TLID_REFLECTOR_PEER_INFO; private MTProto $MadelineProto; public MTProto $madeline; public $received_timestamp_map = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]; public $remote_ack_timestamp_map = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]; public $session_out_seq_no = 0; public $session_in_seq_no = 0; public $voip_state = 0; public $configuration = ['endpoints' => [], 'shared_config' => []]; public $storage = []; public $internalStorage = []; private $signal = 0; private int $callState; private $callID; private $creatorID; private $otherID; private $protocol; private $visualization; private $holdFiles = []; private $inputFiles = []; private $outputFile; private $isPlaying = false; private bool $creator; private PermAuthKey $authKey; private int $peerVersion = 0; /** * @var Endpoint[] */ private array $sockets = []; /** * Timeout watcher. */ private string $timeoutWatcher; /** * Last incoming timestamp. * * @var float */ private $lastIncomingTimestamp = 0.0; /** * The outgoing timestamp. * * @var int */ private $timestamp = 0; /** * Packet queue. * * @var SplQueue */ private $packetQueue; /** * Temporary holdfile array. */ private array $tempHoldFiles = []; /** * Sleep function. * * @return array */ public function __sleep() { $vars = \get_object_vars($this); unset($vars['sockets'], $vars['timeoutWatcher']); return \array_keys($vars); } /** * Wakeup function. */ public function __wakeup(): void { if ($this->voip_state === self::STATE_ESTABLISHED) { $this->voip_state = self::STATE_CREATED; $this->startTheMagic(); } } /** * Constructor. * * @param boolean $creator * @param integer $otherID * @param integer $callState */ public function __construct(bool $creator, int $otherID, MTProto $MadelineProto, int $callState) { $this->creator = $creator; $this->otherID = $otherID; $this->madeline = $this->MadelineProto = $MadelineProto; $this->callState = $callState; $this->packetQueue = new SplQueue; $this->TLID_REFLECTOR_SELF_INFO = \strrev(\hex2bin(self::TLID_REFLECTOR_SELF_INFO_HEX)); $this->TLID_REFLECTOR_PEER_INFO = \strrev(\hex2bin(self::TLID_REFLECTOR_PEER_INFO_HEX)); $this->TLID_DECRYPTED_AUDIO_BLOCK = \strrev(\hex2bin(self::TLID_DECRYPTED_AUDIO_BLOCK_HEX)); $this->TLID_SIMPLE_AUDIO_BLOCK = \strrev(\hex2bin(self::TLID_SIMPLE_AUDIO_BLOCK_HEX)); } /** * Get max layer. * * @return integer */ public static function getConnectionMaxLayer(): int { return 92; } /** * Get debug string. * */ public function getDebugString(): string { return ''; } /** * Set call constructor. * */ public function setCall(array $callID): void { $this->protocol = $callID['protocol']; $this->callID = [ '_' => 'inputPhoneCall', 'id' => $callID['id'], 'access_hash' => $callID['access_hash'] ]; } /** * Set emojis. * */ public function setVisualization(array $visualization): void { $this->visualization = $visualization; } /** * Get emojis. * */ public function getVisualization(): array { return $this->visualization; } /** * Discard call. * * @param array $reason * @param array $rating * @param boolean $debug * @return self|false */ public function discard($reason = ['_' => 'phoneCallDiscardReasonDisconnect'], $rating = [], $debug = false) { if (($this->callState ?? self::CALL_STATE_ENDED) === self::CALL_STATE_ENDED || empty($this->configuration)) { return false; } $this->callState = self::CALL_STATE_ENDED; Logger::log("Now closing $this"); if (isset($this->timeoutWatcher)) { Loop::cancel($this->timeoutWatcher); } Logger::log("Closing all sockets in $this"); foreach ($this->sockets as $socket) { $socket->disconnect(); } Logger::log("Closed all sockets, discarding $this"); return Tools::callFork($this->MadelineProto->discardCall($this->callID, $reason, $rating, $debug)); } public function __destruct() { $this->discard(['_' => 'phoneCallDiscardReasonDisconnect']); } /** * Accept call. * * @return self|false */ public function accept() { if ($this->callState !== self::CALL_STATE_INCOMING) { return false; } $this->callState = self::CALL_STATE_ACCEPTED; Tools::call($this->MadelineProto->acceptCall($this->callID))->onResolve(function ($e, $res): void { if ($e || !$res) { $this->discard(['_' => 'phoneCallDiscardReasonDisconnect']); } }); return $this; } /** * Start the actual call. */ public function startTheMagic(): self { if ($this->voip_state !== self::STATE_CREATED) { return $this; } $this->voip_state = self::STATE_WAIT_INIT; $this->timeoutWatcher = Loop::repeat(10000, function (): void { if (\microtime(true) - $this->lastIncomingTimestamp > 10) { $this->discard(['_' => 'phoneCallDiscardReasonDisconnect']); } }); Tools::callFork((function () { $this->authKey = new PermAuthKey(); $this->authKey->setAuthKey($this->configuration['auth_key']); foreach ($this->configuration['endpoints'] as $endpoint) { $this->sockets['v6 '.$endpoint['id']] = new Endpoint('['.$endpoint['ipv6'].']', $endpoint['port'], $endpoint['peer_tag'], true, $this); $this->sockets['v4 '.$endpoint['id']] = new Endpoint($endpoint['ip'], $endpoint['port'], $endpoint['peer_tag'], true, $this); } foreach ($this->sockets as $k => $socket) { try { yield from $socket->connect(); } catch (\Throwable $e) { unset($this->sockets[$k]); } } foreach ($this->sockets as $socket) { $this->send_message(['_' => self::PKT_INIT, 'protocol' => self::PROTOCOL_VERSION, 'min_protocol' => self::MIN_PROTOCOL_VERSION, 'audio_streams' => [self::CODEC_OPUS], 'video_streams' => []], $socket); Tools::callFork((function () use ($socket) { while ($payload = yield from $this->recv_message($socket)) { $this->lastIncomingTimestamp = \microtime(true); Tools::callFork($this->handlePacket($socket, $payload)); } Logger::log("Exiting VoIP read loop in $this!"); })()); } })()); return $this; } /** * Handle incoming packet. */ private function handlePacket(Endpoint $socket, array $packet): \Generator { switch ($packet['_']) { case self::PKT_INIT: //$this->voip_state = self::STATE_WAIT_INIT_ACK; $this->send_message(['_' => self::PKT_INIT_ACK, 'protocol' => self::PROTOCOL_VERSION, 'min_protocol' => self::MIN_PROTOCOL_VERSION, 'all_streams' => [['id' => 0, 'type' => self::STREAM_TYPE_AUDIO, 'codec' => self::CODEC_OPUS, 'frame_duration' => 60, 'enabled' => 1]]], $socket); yield from $this->startWriteLoop($socket); break; case self::PKT_INIT_ACK: yield from $this->startWriteLoop($socket); break; case self::PKT_STREAM_DATA: $cnt = 1; break; case self::PKT_STREAM_DATA_X2: $cnt = 2; break; case self::PKT_STREAM_DATA_X3: $cnt = 3; break; } if (isset($cnt)) { } } /** * Start write loop. * */ private function startWriteLoop(Endpoint $socket): \Generator { if ($this->voip_state === self::STATE_ESTABLISHED) { return; } $this->voip_state = self::STATE_ESTABLISHED; $this->tempHoldFiles = []; while (true) { $file = \array_shift($this->inputFiles); if (!$file) { if (empty($this->tempHoldFiles)) { $this->tempHoldFiles = $this->holdFiles; } if (empty($this->tempHoldFiles)) { return; } $file = \array_shift($this->tempHoldFiles); } $it = yield from $this->openFile($file); if ($this->MadelineProto->getSettings()->getVoip()->getPreloadAudio()) { while (yield $it->advance()) { $this->packetQueue->enqueue($it->getCurrent()); } $t = (\microtime(true) / 1000) + 60; while (!$this->packetQueue->isEmpty()) { if (!yield $this->send_message(['_' => self::PKT_STREAM_DATA, 'stream_id' => 0, 'data' => $this->packetQueue->dequeue(), 'timestamp' => $this->timestamp], $socket)) { Logger::log("Exiting VoIP write loop in $this!"); return; } //Logger::log("Writing {$this->timestamp} in $this!"); yield new Delayed((int) ($t - (\microtime(true) / 1000))); $t = (\microtime(true) / 1000) + 60; $this->timestamp += 60; } } else { $t = (\microtime(true) / 1000) + 60; while (yield $it->advance()) { if (!yield $this->send_message(['_' => self::PKT_STREAM_DATA, 'stream_id' => 0, 'data' => $it->getCurrent(), 'timestamp' => $this->timestamp], $socket)) { Logger::log("Exiting VoIP write loop in $this!"); return; } //Logger::log("Writing {$this->timestamp} in $this!"); yield new Delayed((int) ($t - (\microtime(true) / 1000))); $t = (\microtime(true) / 1000) + 60; $this->timestamp += 60; } } } } /** * Open OGG file for reading. * */ private function openFile(string $file): \Generator { $ctx = new ConnectionContext; $ctx->addStream(FileBufferedStream::class, yield openFile($file, 'r')); $stream = yield from $ctx->getStream(); $ogg = yield from Ogg::init($stream, 60000); $it = $ogg->getEmitter()->iterate(); Tools::callFork($ogg->read()); return $it; } /** * Play file. * */ public function play(string $file): self { $this->inputFiles[] = $file; return $this; } /** * Play file. * */ public function then(string $file): self { $this->inputFiles[] = $file; return $this; } /** * Files to play on hold. * */ public function playOnHold(array $files): self { $this->holdFiles = $files; return $this; } /** * Set output file. * */ public function setOutputFile(string $file): self { $this->outputFile = $file; return $this; } /** * Unset output file. * */ public function unsetOutputFile(): self { $this->outputFile = null; return $this; } /** * Set MadelineProto instance. * */ public function setMadeline(MTProto $MadelineProto): void { $this->MadelineProto = $this->madeline = $MadelineProto; } /** * Get call protocol. * */ public function getProtocol(): array { return $this->protocol; } /** * Get ID of other user. * */ public function getOtherID(): int { return $this->otherID; } /** * Get call ID. * * @return string|int */ public function getCallID() { return $this->callID; } /** * Get creation date. * * @return int|bool */ public function whenCreated() { return isset($this->internalStorage['created']) ? $this->internalStorage['created'] : false; } /** * Parse config. * */ public function parseConfig(): void { } /** * Get call state. * */ public function getCallState(): int { return $this->callState ?? self::CALL_STATE_ENDED; } /** * Get library version. * */ public function getVersion(): string { return 'libponyvoip-1.0'; } /** * Get preferred relay ID. * * @return integer */ public function getPreferredRelayID(): int { return 0; } /** * Get last error. * */ public function getLastError(): string { return ''; } /** * Get debug log. * */ public function getDebugLog(): string { return ''; } /** * Get signal bar count. */ public function getSignalBarsCount(): int { return $this->signal; } /** * Get the value of creator. * */ public function isCreator(): bool { return $this->creator; } /** * Get the value of authKey. * */ public function getAuthKey(): PermAuthKey { return $this->authKey; } /** * Get the value of peerVersion. * */ public function getPeerVersion(): int { return $this->peerVersion; } /** * Get call representation. * * @return string */ public function __toString() { $id = $this->callID['id']; return "call {$id} with {$this->otherID}"; } } <?php /** * API module. * * This file is part of MadelineProto. * MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. * MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * You should have received a copy of the GNU General Public License along with MadelineProto. * If not, see <http://www.gnu.org/licenses/>. * * @author Daniil Gentili <daniil@daniil.it> * @copyright 2016-2020 Daniil Gentili <daniil@daniil.it> * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; \class_alias(API::class, '\\danog\\MadelineProto\\FastAPI'); <?php namespace danog\MadelineProto; use danog\MadelineProto\Settings\AppInfo; use danog\MadelineProto\Settings\Auth; use danog\MadelineProto\Settings\Connection; use danog\MadelineProto\Settings\Database\Memory as DatabaseMemory; use danog\MadelineProto\Settings\Database\Mysql; use danog\MadelineProto\Settings\Database\Postgres; use danog\MadelineProto\Settings\Database\Redis; use danog\MadelineProto\Settings\DatabaseAbstract; use danog\MadelineProto\Settings\Files; use danog\MadelineProto\Settings\Ipc; use danog\MadelineProto\Settings\Logger; use danog\MadelineProto\Settings\Peer; use danog\MadelineProto\Settings\RPC; use danog\MadelineProto\Settings\SecretChats; use danog\MadelineProto\Settings\Serialization; use danog\MadelineProto\Settings\Templates; use danog\MadelineProto\Settings\TLSchema; use danog\MadelineProto\Settings\VoIP; /** * Settings class used for configuring MadelineProto. */ class Settings extends SettingsAbstract { /** * App information. */ protected AppInfo $appInfo; /** * Cryptography settings. */ protected Auth $auth; /** * Connection settings. */ protected Connection $connection; /** * File management settings. */ protected Files $files; /** * IPC server settings. */ protected Ipc $ipc; /** * Logger settings. */ protected Logger $logger; /** * Peer database settings. */ protected Peer $peer; /** * RPC settings. */ protected RPC $rpc; /** * Secret chat settings. */ protected SecretChats $secretChats; /** * Serialization settings. */ protected Serialization $serialization; /** * TL schema settings. */ protected TLSchema $schema; /** * DatabaseAbstract settings. */ protected DatabaseAbstract $db; /** * Template settings. */ protected Templates $templates; /** * VoIP settings. */ protected VoIP $voip; /** * Create settings object from possibly legacy settings array. * * @internal * * @param SettingsAbstract|array $settings Settings * */ public static function parseFromLegacy($settings): SettingsAbstract { if (\is_array($settings)) { if (empty($settings)) { return new SettingsEmpty; } $settingsNew = new Settings; $settingsNew->mergeArray($settings); return $settingsNew; } return $settings; } /** * Create full settings object from possibly legacy settings array. * * @internal * * @param SettingsAbstract|array $settings Settings * */ public static function parseFromLegacyFull($settings): Settings { $settings = self::parseFromLegacy($settings); if (!$settings instanceof Settings) { $newSettings = new Settings; $newSettings->merge($settings); $settings = $newSettings; } return $settings; } /** * Constructor. */ public function __construct() { $this->appInfo = new AppInfo; $this->auth = new Auth; $this->connection = new Connection; $this->files = new Files; $this->logger = new Logger; $this->peer = new Peer; $this->rpc = new RPC; $this->secretChats = new SecretChats; $this->serialization = new Serialization; $this->schema = new TLSchema; $this->db = new DatabaseMemory; $this->templates = new Templates; $this->ipc = new IPc; $this->voip = new VoIP; } public function __wakeup(): void { if (!isset($this->voip)) { $this->voip = new VoIP; } } /** * Merge legacy array settings. * * @param array $settings Settings * * @internal * */ public function mergeArray(array $settings): void { $this->appInfo->mergeArray($settings); $this->auth->mergeArray($settings); $this->connection->mergeArray($settings); $this->files->mergeArray($settings); $this->logger->mergeArray($settings); $this->peer->mergeArray($settings); $this->rpc->mergeArray($settings); $this->secretChats->mergeArray($settings); $this->serialization->mergeArray($settings); $this->schema->mergeArray($settings); $this->ipc->mergeArray($settings); $this->voip->mergeArray($settings); switch ($settings['db']['type'] ?? 'memory') { case 'memory': $this->db = new DatabaseMemory; break; case 'mysql': $this->db = new Mysql; break; case 'postgres': $this->db = new Postgres; break; case 'redis': $this->db = new Redis; break; } $this->db->mergeArray($settings); } /** * Merge another instance of settings. * * @param SettingsAbstract $settings Settings * */ public function merge(SettingsAbstract $settings): void { if (!$settings instanceof self) { if ($settings instanceof AppInfo) { $this->appInfo->merge($settings); } elseif ($settings instanceof Auth) { $this->auth->merge($settings); } elseif ($settings instanceof Connection) { $this->connection->merge($settings); } elseif ($settings instanceof Files) { $this->files->merge($settings); } elseif ($settings instanceof Logger) { $this->logger->merge($settings); } elseif ($settings instanceof Peer) { $this->peer->merge($settings); } elseif ($settings instanceof RPC) { $this->rpc->merge($settings); } elseif ($settings instanceof SecretChats) { $this->secretChats->merge($settings); } elseif ($settings instanceof Serialization) { $this->serialization->merge($settings); } elseif ($settings instanceof TLSchema) { $this->schema->merge($settings); } elseif ($settings instanceof Ipc) { $this->ipc->merge($settings); } elseif ($settings instanceof Templates) { $this->templates->merge($settings); } elseif ($settings instanceof VoIP) { $this->voip->merge($settings); } elseif ($settings instanceof DatabaseAbstract) { if (!$this->db instanceof $settings) { $this->db = $settings; } else { $this->db->merge($settings); } } return; } $this->appInfo->merge($settings->appInfo); $this->auth->merge($settings->auth); $this->connection->merge($settings->connection); $this->files->merge($settings->files); $this->logger->merge($settings->logger); $this->peer->merge($settings->peer); $this->rpc->merge($settings->rpc); $this->secretChats->merge($settings->secretChats); $this->serialization->merge($settings->serialization); $this->schema->merge($settings->schema); $this->ipc->merge($settings->ipc); $this->templates->merge($settings->templates); $this->voip->merge($settings->voip); if (!$this->db instanceof $settings->db) { $this->db = $settings->db; } else { $this->db->merge($settings->db); } } /** * Get default DC ID. * * @return integer */ public function getDefaultDc(): int { return $this->connection->getDefaultDc(); } /** * Get default DC params. * */ public function getDefaultDcParams(): array { return $this->connection->getDefaultDcParams(); } /** * Set default DC ID. * * @param int $dc DC ID * */ public function setDefaultDc(int $dc): self { $this->connection->setDefaultDc($dc); return $this; } /** * Get app information. * */ public function getAppInfo(): AppInfo { return $this->appInfo; } /** * Set app information. * * @param AppInfo $appInfo App information. * */ public function setAppInfo(AppInfo $appInfo): self { $this->appInfo = $appInfo; return $this; } /** * Get cryptography settings. * */ public function getAuth(): Auth { return $this->auth; } /** * Set cryptography settings. * * @param Auth $auth Cryptography settings. * */ public function setAuth(Auth $auth): self { $this->auth = $auth; return $this; } /** * Get connection settings. * */ public function getConnection(): Connection { return $this->connection; } /** * Set connection settings. * * @param Connection $connection Connection settings. * */ public function setConnection(Connection $connection): self { $this->connection = $connection; return $this; } /** * Get file management settings. * */ public function getFiles(): Files { return $this->files; } /** * Set file management settings. * * @param Files $files File management settings. * */ public function setFiles(Files $files): self { $this->files = $files; return $this; } /** * Get logger settings. * */ public function getLogger(): Logger { return $this->logger; } /** * Set logger settings. * * @param Logger $logger Logger settings. * */ public function setLogger(Logger $logger): self { $this->logger = $logger; return $this; } /** * Get peer database settings. * */ public function getPeer(): Peer { return $this->peer; } /** * Set peer database settings. * * @param Peer $peer Peer database settings. * */ public function setPeer(Peer $peer): self { $this->peer = $peer; return $this; } /** * Get RPC settings. * */ public function getRpc(): RPC { return $this->rpc; } /** * Set RPC settings. * * @param RPC $rpc RPC settings. * */ public function setRpc(RPC $rpc): self { $this->rpc = $rpc; return $this; } /** * Get secret chat settings. * */ public function getSecretChats(): SecretChats { return $this->secretChats; } /** * Set secret chat settings. * * @param SecretChats $secretChats Secret chat settings. * */ public function setSecretChats(SecretChats $secretChats): self { $this->secretChats = $secretChats; return $this; } /** * Get serialization settings. * */ public function getSerialization(): Serialization { return $this->serialization; } /** * Set serialization settings. * * @param Serialization $serialization Serialization settings. * */ public function setSerialization(Serialization $serialization): self { $this->serialization = $serialization; return $this; } /** * Get TL schema settings. * */ public function getSchema(): TLSchema { return $this->schema; } /** * Set TL schema settings. * * @param TLSchema $schema TL schema settings. * */ public function setSchema(TLSchema $schema): self { $this->schema = $schema; return $this; } /** * Get database settings. * */ public function getDb(): DatabaseAbstract { return $this->db; } /** * Set database settings. * * @param DatabaseAbstract $db DatabaseAbstract settings. * */ public function setDb(DatabaseAbstract $db): self { $this->db = $db; return $this; } /** * Get IPC server settings. * */ public function getIpc(): Ipc { return $this->ipc; } /** * Set IPC server settings. * * @param Ipc $ipc IPC server settings. * */ public function setIpc(Ipc $ipc): self { $this->ipc = $ipc; return $this; } public function applyChanges(): SettingsAbstract { foreach (\get_object_vars($this) as $setting) { if ($setting instanceof SettingsAbstract) { $setting->applyChanges(); } } return $this; } /** * Get template settings. * */ public function getTemplates(): Templates { return $this->templates; } /** * Set template settings. * * @param Templates $templates Template settings * */ public function setTemplates(Templates $templates): self { $this->templates = $templates; return $this; } /** * Get voIP settings. * */ public function getVoip(): VoIP { return $this->voip; } /** * Set voIP settings. * * @param VoIP $voip VoIP settings. * */ public function setVoip(VoIP $voip): self { $this->voip = $voip; return $this; } } <?php namespace danog\MadelineProto; use Psr\Log\AbstractLogger; use Psr\Log\LogLevel; /** * PSR-3 wrapper for MadelineProto's Logger. */ class PsrLogger extends AbstractLogger { private const LEVEL_MAP = [ LogLevel::EMERGENCY => Logger::LEVEL_FATAL, LogLevel::ALERT => Logger::LEVEL_FATAL, LogLevel::CRITICAL => Logger::LEVEL_FATAL, LogLevel::ERROR => Logger::LEVEL_ERROR, LogLevel::WARNING => Logger::LEVEL_WARNING, LogLevel::NOTICE => Logger::LEVEL_NOTICE, LogLevel::INFO => Logger::LEVEL_VERBOSE, LogLevel::DEBUG => Logger::LEVEL_ULTRA_VERBOSE ]; /** * Logger. */ private Logger $logger; /** * Constructor. * */ public function __construct(Logger $logger) { $this->logger = $logger; } /** * Logs with an arbitrary level. * * @param string $message * @param mixed[] $context * * * @throws \Psr\Log\InvalidArgumentException */ public function log($level, $message, array $context = []): void { $this->logger->logger($message, self::LEVEL_MAP[$level]); } } <?php namespace danog\MadelineProto\Settings; use danog\MadelineProto\Logger as MadelineProtoLogger; use danog\MadelineProto\Magic; use danog\MadelineProto\SettingsAbstract; use danog\MadelineProto\Tools; /** * Logger settings. */ class Logger extends SettingsAbstract { /** * Logger type. * * @var MadelineProtoLogger::LOGGER_* $type Logger type. */ protected int $type; /** * Extra parameter for logger. * * @var null|callable|string */ protected $extra; /** * Logging level. * * @var MadelineProtoLogger::LEVEL_* */ protected int $level = MadelineProtoLogger::LEVEL_VERBOSE; /** * Maximum filesize for logger, in case of file logging. */ protected int $maxSize = 1 * 1024 * 1024; public function mergeArray(array $settings): void { if (!isset($settings['logger']['logger_param']) && isset($settings['logger']['param'])) { $settings['logger']['logger_param'] = $settings['logger']['param']; } if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg' && isset($settings['logger']['logger_param']) && $settings['logger']['logger_param'] === 'MadelineProto.log') { $settings['logger']['logger_param'] = Magic::$script_cwd.'/MadelineProto.log'; } switch ($settings['logger']['logger_level'] ?? null) { case 'ULTRA_VERBOSE': $settings['logger']['logger_level'] = 5; break; case 'VERBOSE': $settings['logger']['logger_level'] = 4; break; case 'NOTICE': $settings['logger']['logger_level'] = 3; break; case 'WARNING': $settings['logger']['logger_level'] = 2; break; case 'ERROR': $settings['logger']['logger_level'] = 1; break; case 'FATAL ERROR': $settings['logger']['logger_level'] = 0; break; } if (isset($settings['logger']['logger'])) { $this->setType($settings['logger']['logger']); } if (isset($settings['logger']['logger_param'])) { $this->setExtra($settings['logger']['logger_param']); } if (isset($settings['logger']['logger_level'])) { $this->setLevel($settings['logger']['logger_level']); } if (isset($settings['logger']['max_size'])) { $this->setMaxSize($settings['logger']['max_size'] ?? 1 * 1024 * 1024); } $this->init(); } public function __construct() { $this->type = (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') ? MadelineProtoLogger::ECHO_LOGGER : MadelineProtoLogger::FILE_LOGGER; Magic::start(true); $this->extra = Magic::$script_cwd.'/MadelineProto.log'; } public function __sleep() { return $this->extra instanceof \Closure ? ['type', 'extra', 'level', 'maxSize'] : ['type', 'level', 'maxSize']; } /** * Wakeup function. */ public function __wakeup(): void { $this->type = (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') ? MadelineProtoLogger::ECHO_LOGGER : MadelineProtoLogger::FILE_LOGGER; if (!$this->extra && $this->type === MadelineProtoLogger::FILE_LOGGER) { $this->extra = Magic::$script_cwd.'/MadelineProto.log'; } $this->init(); } /** * Initialize global logging. * */ private function init(): void { Magic::start(false); MadelineProtoLogger::constructorFromSettings($this); } /** * Get $type Logger type. * * @return MadelineProtoLogger::LOGGER_* */ public function getType(): int { return \defined('MADELINE_WORKER') ? MadelineProtoLogger::FILE_LOGGER : $this->type; } /** * Set $type Logger type. * * @param MadelineProtoLogger::LOGGER_* $type $type Logger type. * */ public function setType(int $type): self { if ($type === MadelineProtoLogger::NO_LOGGER) { $type = (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') ? MadelineProtoLogger::ECHO_LOGGER : MadelineProtoLogger::FILE_LOGGER; } $this->type = $type; return $this; } /** * Get extra parameter for logger. * * @return null|callable|string */ public function getExtra() { return $this->type === MadelineProtoLogger::FILE_LOGGER ? Tools::absolute($this->extra) : $this->extra; } /** * Set extra parameter for logger. * * @param null|callable|string $extra Extra parameter for logger. * */ public function setExtra($extra): self { if ($this->type === MadelineProtoLogger::CALLABLE_LOGGER && !\is_callable($extra)) { $this->setType((PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') ? MadelineProtoLogger::ECHO_LOGGER : MadelineProtoLogger::FILE_LOGGER); return $this; } $this->extra = $extra; return $this; } /** * Get logging level. * * @return MadelineProtoLogger::LEVEL_* */ public function getLevel(): int { return $this->level; } /** * Set logging level. * * @param MadelineProtoLogger::LEVEL_* $level Logging level. * */ public function setLevel(int $level): self { $this->level = \max($level, MadelineProtoLogger::NOTICE); return $this; } /** * Get maximum filesize for logger, in case of file logging. * */ public function getMaxSize(): int { return $this->maxSize; } /** * Set maximum filesize for logger, in case of file logging. * * @param int $maxSize Maximum filesize for logger, in case of file logging. * */ public function setMaxSize(int $maxSize): self { $this->maxSize = $maxSize === -1 ? $maxSize : \max($maxSize, 25 * 1024 * 1024); return $this; } } <?php namespace danog\MadelineProto\Settings; use danog\MadelineProto\SettingsAbstract; /** * TL schema settings. */ class TLSchema extends SettingsAbstract { /** * TL layer version. */ protected int $layer = 151; /** * API schema path. */ protected string $APISchema = __DIR__ . '/../TL_telegram_v151.tl'; /** * MTProto schema path. */ protected string $MTProtoSchema = __DIR__.'/../TL_mtproto_v1.tl'; /** * Secret schema path. */ protected string $secretSchema = __DIR__.'/../TL_secret.tl'; /** * @internal Other schemas */ protected array $other = []; /** * Whether the scheme was upgraded. */ private bool $wasUpgraded = true; public function mergeArray(array $settings): void { $settings = $settings['tl_schema'] ?? []; if (isset($settings['layer'])) { $this->setLayer($settings['layer']); } $src = $settings['src'] ?? $settings; if (isset($src['mtproto'])) { $this->setMTProtoSchema($src['mtproto']); } if (isset($src['telegram'])) { $this->setAPISchema($src['telegram']); } if (isset($src['secret'])) { $this->setSecretSchema($src['secret']); } } /** * Upgrade scheme autonomously. */ public function __wakeup(): void { // Scheme was upgraded or path has changed if (!\file_exists($this->APISchema)) { $new = new self; $this->setAPISchema($new->getAPISchema()); $this->setMTProtoSchema($new->getMTProtoSchema()); $this->setSecretSchema($new->getSecretSchema()); $this->setLayer($this->getLayer()); $this->wasUpgraded = true; } } /** * Returns whether the TL parser should re-parse the TL schemes. * * @return boolean */ public function needsUpgrade(): bool { return $this->wasUpgraded; } /** * Signal that scheme was re-parsed. * */ public function upgrade(): void { $this->wasUpgraded = false; } /** * Get TL layer version. * */ public function getLayer(): int { return $this->layer; } /** * Set TL layer version. * * @param int $layer TL layer version. * */ public function setLayer(int $layer): self { $this->layer = $layer; return $this; } /** * Get MTProto schema path. * */ public function getMTProtoSchema(): string { return $this->MTProtoSchema; } /** * Set MTProto schema path. * * @param string $MTProtoSchema MTProto schema path. * */ public function setMTProtoSchema(string $MTProtoSchema): self { $this->MTProtoSchema = $MTProtoSchema; return $this; } /** * Get API schema path. * */ public function getAPISchema(): string { return $this->APISchema; } /** * Set API schema path. * * @param string $APISchema API schema path. * */ public function setAPISchema(string $APISchema): self { $this->APISchema = $APISchema; return $this; } /** * Get secret schema path. * */ public function getSecretSchema(): string { return $this->secretSchema; } /** * Set secret schema path. * * @param string $secretSchema Secret schema path. * */ public function setSecretSchema(string $secretSchema): self { $this->secretSchema = $secretSchema; return $this; } /** * Get the value of other. * */ public function getOther(): array { return $this->other; } /** * Set the value of other. * * */ public function setOther(array $other): self { $this->other = $other; return $this; } } <?php namespace danog\MadelineProto\Settings; use danog\MadelineProto\SettingsAbstract; /** * Serialization settings. */ class Serialization extends SettingsAbstract { /** * Serialization interval, in seconds. */ protected int $interval = 30; public function mergeArray(array $settings): void { if (isset($settings['serialization']['serialization_interval'])) { $this->setInterval($settings['serialization']['serialization_interval']); } } /** * Get serialization interval, in seconds. * */ public function getInterval(): int { return $this->interval; } /** * Set serialization interval, in seconds. * * @param int $interval Serialization interval, in seconds. * */ public function setInterval(int $interval): self { $this->interval = $interval; return $this; } } <?php namespace danog\MadelineProto\Settings; use danog\MadelineProto\Magic; use danog\MadelineProto\SettingsAbstract; /** * IPC server settings. */ class Ipc extends SettingsAbstract { public function __construct() { Magic::start(true); } public function mergeArray(array $settings): void { } /** * Get WARNING: this will cause slow startup if enabled. * */ public function getSlow(): bool { return Magic::$isIpcWorker; } } <?php namespace danog\MadelineProto\Settings; use danog\MadelineProto\SettingsAbstract; /** * Web and CLI template settings for login. */ class Templates extends SettingsAbstract { /** * Web template used for querying app information. */ protected string $htmlTemplate = '<!DOCTYPE html><html><head><title>MadelineProto

MadelineProto

%s

%s
'; /** * Get web template used for querying app information. * */ public function getHtmlTemplate(): string { return $this->htmlTemplate; } /** * Set web template used for querying app information. * * @param string $htmlTemplate Web template used for querying app information. * */ public function setHtmlTemplate(string $htmlTemplate): self { $this->htmlTemplate = $htmlTemplate; return $this; } } setUri($settings['host'].(isset($settings['port']) ? ':'.($settings['port']) : '')); } parent::mergeArray($settings); } /** * Get database number. * */ public function getDatabase(): int { return $this->database; } /** * Set database number. * * @param int $database Database number. * */ public function setDatabase($database): self { $this->database = $database; return $this; } /** * Get database URI. * */ public function getUri(): string { return $this->uri; } /** * Set database URI. * * @param string $uri Database URI. * */ public function setUri(string $uri): self { $this->uri = $uri; return $this; } } setUri("tcp://".($settings['host']).(isset($settings['port']) ? ':'.($settings['port']) : '')); } parent::mergeArray($settings); } } setCleanup($settings['serialization']['cleanup_before_serialization']); } } /** * Get whether to cleanup the memory before serializing. * */ public function getCleanup(): bool { return $this->cleanup; } /** * Set whether to cleanup the memory before serializing. * * @param bool $cleanup Whether to cleanup the memory before serializing. * */ public function setCleanup(bool $cleanup): self { $this->cleanup = $cleanup; return $this; } } setUri("tcp://".($settings['host']).(isset($settings['port']) ? ':'.($settings['port']) : '')); } parent::mergeArray($settings); } } $array) { if (isset($settings[$array])) { $this->{$object}($settings[$array]); } } if (isset($settings['user'])) { $this->setUsername($settings['user']); } parent::mergeArray($settings); } /** * Get maximum connection limit. * */ public function getMaxConnections(): int { return $this->maxConnections; } /** * Set maximum connection limit. * * @param int $maxConnections Maximum connection limit. * */ public function setMaxConnections(int $maxConnections): self { $this->maxConnections = $maxConnections; return $this; } /** * Get idle timeout. * */ public function getIdleTimeout(): int { return $this->idleTimeout; } /** * Set idle timeout. * * @param int $idleTimeout Idle timeout. * */ public function setIdleTimeout(int $idleTimeout): self { $this->idleTimeout = $idleTimeout; return $this; } /** * Get database name. * */ public function getDatabase(): string { return $this->database; } /** * Set database name. * * @param string $database Database name. * */ public function setDatabase($database): self { $this->database = $database; return $this; } /** * Get username. * */ public function getUsername(): string { return $this->username; } /** * Set username. * * @param string $username Username. * */ public function setUsername(string $username): self { $this->username = $username; return $this; } /** * Get database URI. * */ public function getUri(): string { return $this->uri; } /** * Set database URI. * * @param string $uri Database URI. * */ public function setUri(string $uri): self { $this->uri = $uri; return $this; } } $array) { if (isset($settings[$array])) { $this->{$object}($settings[$array]); } } } /** * Get DB key. * */ public function getKey(): string { $uri = \parse_url($this->getUri()); $host = $uri['host'] ?? ''; $port = $uri['port'] ?? ''; return "$host:$port:".$this->getDatabase(); } /** * Get for how long to keep records in memory after last read, for cached backends. * */ public function getCacheTtl(): int { return $this->cacheTtl; } /** * Set for how long to keep records in memory after last read, for cached backends. * * The cache TTL identifier can be a string like '+5 minutes'. * When data is retrieved from a database it is stored in memory. * This helps to reduce latency, improve speed and reduce mysql/postgres/redis load. * Data will be removed from the cache if last access was more than this amount of time. * Clean up is done once per minute. * * @param int|string $cacheTtl For how long to keep records in memory after last read, for cached backends. * */ public function setCacheTtl($cacheTtl): self { $this->cacheTtl = \is_int($cacheTtl) ? $cacheTtl : \strtotime($cacheTtl) - \time(); return $this; } /** * Get password. * */ public function getPassword(): string { return $this->password; } /** * Set password. * * @param string $password Password. * */ public function setPassword(string $password): self { $this->password = $password; return $this; } /** * Get database name/ID. * * @return string|int */ abstract public function getDatabase(); /** * Get database URI. * */ abstract public function getUri(): string; /** * Set database name/ID. * * @param int|string $database */ abstract public function setDatabase($database): self; /** * Set database URI. * */ abstract public function setUri(string $uri): self; } setRpcTimeout($settings['connection_settings']['all']['drop_timeout']); } if (isset($settings['flood_timeout']['wait_if_lt'])) { $this->setFloodTimeout($settings['flood_timeout']['wait_if_lt']); } if (isset($settings['msg_array_limit']['call_queue'])) { $this->setLimitCallQueue($settings['msg_array_limit']['call_queue']); } if (isset($settings['requests']['gzip_encode_if_gt'])) { $this->setLimitCallQueue($settings['requests']['gzip_encode_if_gt']); } } /** * Get RPC timeout. * */ public function getRpcTimeout(): int { return $this->rpcTimeout; } /** * Set RPC timeout. * * @param int $rpcTimeout RPC timeout. * */ public function setRpcTimeout(int $rpcTimeout): self { $this->rpcTimeout = $rpcTimeout; return $this; } /** * Get flood timeout: if FLOOD_WAIT_ time is bigger than this, throw exception instead of waiting asynchronously. * */ public function getFloodTimeout(): int { return $this->floodTimeout; } /** * Set flood timeout: if FLOOD_WAIT_ time is bigger than this, throw exception instead of waiting asynchronously. * * @param int $floodTimeout Flood timeout: if FLOOD_WAIT_ time is bigger than this, throw exception instead of waiting asynchronously * */ public function setFloodTimeout(int $floodTimeout): self { $this->floodTimeout = $floodTimeout; return $this; } /** * Get maximum number of messages to consider when using call queues. * */ public function getLimitCallQueue(): int { return $this->limitCallQueue; } /** * Set maximum number of messages to consider when using call queues. * * @param int $limitCallQueue Maximum number of messages to consider when using call queues * */ public function setLimitCallQueue(int $limitCallQueue): self { $this->limitCallQueue = $limitCallQueue; return $this; } /** * Get encode payload with GZIP if bigger than. * */ public function getGzipEncodeIfGt(): int { return $this->gzipEncodeIfGt; } /** * Set encode payload with GZIP if bigger than. * * @param int $gzipEncodeIfGt Encode payload with GZIP if bigger than * */ public function setGzipEncodeIfGt(int $gzipEncodeIfGt): self { $this->gzipEncodeIfGt = $gzipEncodeIfGt; return $this; } } $array) { if (isset($settings['peer'][$array])) { $this->{$object}($settings['peer'][$array]); } } } /** * Get cache time for full peer information (seconds). * */ public function getFullInfoCacheTime(): int { return $this->fullInfoCacheTime; } /** * Set cache time for full peer information (seconds). * * @param int $fullInfoCacheTime Cache time for full peer information (seconds). * */ public function setFullInfoCacheTime(int $fullInfoCacheTime): self { $this->fullInfoCacheTime = $fullInfoCacheTime; return $this; } /** * Get should madeline fetch the full member list of every group it meets? * */ public function getFullFetch(): bool { return $this->fullFetch; } /** * Set should madeline fetch the full member list of every group it meets? * * @param bool $fullFetch Should madeline fetch the full member list of every group it meets? * */ public function setFullFetch(bool $fullFetch): self { $this->fullFetch = $fullFetch; return $this; } /** * Get whether to cache all peers on startup for userbots. * */ public function getCacheAllPeersOnStartup(): bool { return $this->cacheAllPeersOnStartup; } /** * Set whether to cache all peers on startup for userbots. * * @param bool $cacheAllPeersOnStartup Whether to cache all peers on startup for userbots. * */ public function setCacheAllPeersOnStartup(bool $cacheAllPeersOnStartup): self { $this->cacheAllPeersOnStartup = $cacheAllPeersOnStartup; return $this; } } pfs = \extension_loaded('gmp'); } public function mergeArray(array $settings): void { foreach (self::toCamel([ 'default_temp_auth_key_expires_in', ]) as $object => $array) { if (isset($settings['authorization'][$array])) { $this->{$object}($settings['authorization'][$array]); } } if (isset($settings['connection_settings']['all']['pfs'])) { $this->setPfs($settings['connection_settings']['all']['pfs']); } } /** * Get validity period of the binding of temporary and permanent keys. * */ public function getDefaultTempAuthKeyExpiresIn(): int { return $this->defaultTempAuthKeyExpiresIn; } /** * Set validity period of the binding of temporary and permanent keys. * * @param int $defaultTempAuthKeyExpiresIn Validity period of the binding of temporary and permanent keys. * */ public function setDefaultTempAuthKeyExpiresIn(int $defaultTempAuthKeyExpiresIn): self { $this->defaultTempAuthKeyExpiresIn = $defaultTempAuthKeyExpiresIn; return $this; } /** * Get whether to use PFS. * */ public function getPfs(): bool { return $this->pfs; } /** * Set whether to use PFS. * * @param bool $pfs Whether to use PFS * */ public function setPfs(bool $pfs): self { $this->pfs = $pfs; return $this; } /** * Get max tries for generating auth key. * */ public function getMaxAuthTries(): int { return $this->maxAuthTries; } /** * Set max tries for generating auth key. * * @param int $maxAuthTries Max tries for generating auth key * */ public function setMaxAuthTries(int $maxAuthTries): self { $this->maxAuthTries = $maxAuthTries; return $this; } } */ protected $accept = true; public function mergeArray(array $settings): void { if (isset($settings['secret_chats']['accept_chats'])) { $this->setAccept($settings['secret_chats']['accept_chats']); } } /** * Get boolean or array of IDs. * * @return bool|array */ public function getAccept() { return $this->accept; } /** * Set boolean or array of IDs. * * @param bool|array $accept Boolean or array of IDs * */ public function setAccept($accept): self { $this->accept = $accept; return $this; } /** * Can we accept this chat. * * @internal * * @param integer $id * @return boolean */ public function canAccept(int $id): bool { if (!$this->accept) { return false; } if ($this->accept === true) { return true; } return \in_array($id, $this->accept); } } deviceModel = \php_uname('s'); } catch (\Throwable $e) { $this->deviceModel = 'Web server'; } // Detect system version try { $this->systemVersion = \php_uname('r'); } catch (\Throwable $e) { $this->systemVersion = PHP_VERSION; } // Detect language Lang::$current_lang =& Lang::$lang[$this->langCode]; if (isset($_SERVER['HTTP_ACCEPT_LANGUAGE'])) { $this->setLangCode(\substr($_SERVER['HTTP_ACCEPT_LANGUAGE'], 0, 2)); } elseif (isset($_SERVER['LANG'])) { $this->setLangCode(\explode('_', $_SERVER['LANG'])[0]); } $this->init(); } public function __wakeup(): void { $this->init(); } public function init(): void { Magic::start(true); // Detect language pack if (isset(Lang::$lang[$this->langCode])) { Lang::$current_lang =& Lang::$lang[$this->langCode]; } $this->appVersion = MTProto::RELEASE.' ('.MTProto::V.', '.Magic::$version.')'; } public function mergeArray(array $settings): void { foreach (self::toCamel([ 'api_id', 'api_hash', 'device_model', 'system_version', 'app_version', 'lang_code', 'lang_pack' ]) as $object => $array) { if (isset($settings['app_info'][$array])) { $this->{$object}($settings['app_info'][$array]); } } } /** * Check if the settings have API ID/hash information. * * @return boolean */ public function hasApiInfo(): bool { return isset($this->apiHash, $this->apiId) && $this->apiId; } /** * Get API ID. * */ public function getApiId(): int { if (!isset($this->apiId)) { throw new Exception(Lang::$current_lang['api_not_set']); } return $this->apiId; } /** * Set API ID. * * @param int $apiId API ID. * */ public function setApiId(int $apiId): self { $this->apiId = $apiId; if ($apiId === 6) { // TG DEV NOTICE: these app info spoofing measures were implemented for NON-MALICIOUS purposes. // All accounts registered with a custom API ID require manual verification through recover@telegram.org, to avoid instant permabans. // This makes usage of all MTProto libraries very difficult, at least for new users. // To help a bit, when the android API ID is used, the android app infos are spoofed too. // THE ANDROID API HASH IS NOT PRESENT IN THIS REPOSITORY, AND WILL NOT BE GIVEN TO EVERYONE. // This measure was NOT created with the intent to aid spammers, flooders, and other scum. // // I understand that automated account registration through headless libraries may indicate the creation of a botnet, // ...and I understand why these automatic bans were implemented in the first place. // Manual requests to activate numbers through recover@telegram.org will still be required for the majority of users of this library, // ...those that choose to user their own API ID for their application. // // To be honest, I wrote this feature just for me, since I honestly don't want to // ...go through the hassle of registering => recovering => logging in to every account I use for my services (mainly webradios and test userbots) $this->deviceModel = 'LGENexus 5'; $this->systemVersion = 'SDK 28'; $this->appVersion = '4.9.1 (13613)'; $this->langPack = 'android'; } return $this; } /** * Get API hash. * */ public function getApiHash(): string { if (!isset($this->apiHash)) { throw new Exception(Lang::$current_lang['api_not_set']); } return $this->apiHash; } /** * Set API hash. * * @param string $apiHash API hash. * */ public function setApiHash(string $apiHash): self { $this->apiHash = $apiHash; return $this; } /** * Get device model. * */ public function getDeviceModel(): string { return $this->deviceModel; } /** * Set device model. * * @param string $deviceModel Device model. * */ public function setDeviceModel(string $deviceModel): self { $this->deviceModel = $deviceModel; return $this; } /** * Get system version. * */ public function getSystemVersion(): string { return $this->systemVersion; } /** * Set system version. * * @param string $systemVersion System version. * */ public function setSystemVersion(string $systemVersion): self { $this->systemVersion = $systemVersion; return $this; } /** * Get app version. * */ public function getAppVersion(): string { return $this->appVersion; } /** * Set app version. * * @param string $appVersion App version. * */ public function setAppVersion(string $appVersion): self { $this->appVersion = $appVersion; return $this; } /** * Get language code. * */ public function getLangCode(): string { return $this->langCode; } /** * Set language code. * * @param string $langCode Language code. * */ public function setLangCode(string $langCode): self { $this->langCode = $langCode; if (isset(Lang::$lang[$this->langCode])) { Lang::$current_lang =& Lang::$lang[$this->langCode]; } return $this; } /** * Get language pack. * */ public function getLangPack(): string { return $this->langPack; } /** * Set language pack. * * @param string $langPack Language pack. * */ public function setLangPack(string $langPack): self { $this->langPack = $langPack; return $this; } } 2]; /** * Protocol identifier. * * @var class-string */ protected string $protocol = AbridgedStream::class; /** * Transport identifier. * * @var class-string */ protected string $transport = DefaultStream::class; /** * Proxy identifiers. * * @var array, array> */ protected array $proxy = []; /** * Whether to use the obfuscated protocol. */ protected bool $obfuscated = false; /** * Whether we're in test mode. */ protected bool $testMode = false; /** * Whether to use ipv6. */ protected bool $ipv6 = false; /** * Connection timeout. */ protected int $timeout = 2; /** * Ping interval. */ protected int $pingInterval = 60; /** * Whether to retry connection. */ protected bool $retry = true; /** * Whether to use DNS over HTTPS. */ protected bool $useDoH = true; /** * Bind on specific address and port. */ private ?string $bindTo = null; /** * Subdomains of web.telegram.org for https protocol. */ protected array $sslSubdomains = [ 1 => 'pluto', 2 => 'venus', 3 => 'aurora', 4 => 'vesta', 5 => 'flora', ]; public function mergeArray(array $settings): void { if (isset($settings['connection']['ssl_subdomains'])) { $this->setSslSubdomains($settings['connection']['ssl_subdomains']); } $settings = $settings['connection_settings'] ?? []; if (isset($settings['media_socket_count']['min'])) { $this->setMinMediaSocketCount($settings['media_socket_count']['min']); } if (isset($settings['media_socket_count']['max'])) { $this->setMaxMediaSocketCount($settings['media_socket_count']['max']); } foreach (self::toCamel([ 'robin_period', 'default_dc', 'pfs' ]) as $object => $array) { if (isset($settings[$array])) { $this->{$object}($settings[$array]); } } $settings = $settings['all'] ?? []; foreach (self::toCamel([ 'test_mode', 'ipv6', 'timeout', 'obfuscated', ]) as $object => $array) { if (isset($settings[$array])) { $this->{$object}($settings[$array]); } } if (isset($settings['do_not_retry'])) { $this->setRetry(false); } if (isset($settings['proxy'])) { $isProxyArray = \is_iterable($settings['proxy']); foreach ($isProxyArray ? $settings['proxy'] : [$settings['proxy']] as $key => $proxy) { if ($proxy === '\\Socket') { $proxy = DefaultStream::class; } elseif ($proxy === '\\SocksProxy') { $proxy = SocksProxy::class; } elseif ($proxy === '\\HttpProxy') { $proxy = HttpProxy::class; } elseif ($proxy === '\\MTProxySocket') { $proxy = ObfuscatedStream::class; } if ($proxy !== DefaultStream::class) { $this->addProxy($proxy, $isProxyArray ? $settings['proxy_extra'][$key] : $settings['proxy_extra']); } } } if (isset($settings['transport'])) { $transport = $settings['transport']; if ($transport === 'tcp') { $transport = DefaultStream::class; } elseif ($transport === 'ws') { $transport = WsStream::class; } elseif ($transport === 'wss') { $transport = WssStream::class; } $this->setTransport($transport); } if (isset($settings['protocol'])) { $protocol = $settings['protocol']; switch ($protocol) { case 'abridged': case 'tcp_abridged': $protocol = AbridgedStream::class; break; case 'intermediate': case 'tcp_intermediate': $protocol = AbridgedStream::class; break; case 'obfuscated2': $this->setObfuscated(true); // no break case 'intermediate_padded': case 'tcp_intermediate_padded': $protocol = IntermediatePaddedStream::class; break; case 'full': case 'tcp_full': $protocol = FullStream::class; break; case 'http': $protocol = HttpStream::class; break; case 'https': $protocol = HttpsStream::class; break; case 'udp': $protocol = UdpBufferedStream::class; break; } $this->setProtocol($protocol); } } public function __construct() { $this->init(); } public function __wakeup(): void { $this->init(); } public function init(): void { Magic::start(true); if (Magic::$altervista) { $this->addProxy(HttpProxy::class, ['address' => 'localhost', 'port' => 80]); $this->setProtocol(HttpStream::class); } else { $this->removeProxy(HttpProxy::class, ['address' => 'localhost', 'port' => 80]); } } /** * Get protocol identifier. * */ public function getProtocol(): string { return $this->protocol; } /** * Set protocol identifier. * * Available MTProto transport protocols (smaller overhead is better): * * * `\danog\MadelineProto\Stream\MTProtoTransport\AbridgedStream`: Lightest protocol available * * Overhead: Very small * * Minimum envelope length: 1 byte (length) * * Maximum envelope length: 4 bytes (length) * * * `\danog\MadelineProto\Stream\MTProtoTransport\IntermediateStream`: I guess they like having multiple protocols * * Overhead: small * * Minimum envelope length: 4 bytes (length) * * Maximum envelope length: 4 bytes (length) * * * `\danog\MadelineProto\Stream\MTProtoTransport\IntermediatePaddedStream`: Padded version of the intermediate protocol, to use with obfuscation enabled to bypass ISP blocks * * Overhead: small-medium * * Minimum envelope length: random * * Maximum envelope length: random * * * `\danog\MadelineProto\Stream\MTProtoTransport\FullStream`: The basic MTProto transport protocol * * Overhead: medium * * Minimum envelope length: 12 bytes (length+seqno+crc) * * Maximum envelope length: 12 bytes (length+seqno+crc) * * Pros: * * Initial integrity check with crc32 * * Transport sequence number check * * * Cons: * * Initial integrity check with crc32 is not that useful since the TCP protocol already uses it internally * * Transport sequence number check is also not that useful since transport sequence numbers are not encrypted and thus cannot be used to avoid replay attacks, and MadelineProto already uses MTProto sequence numbers and message ids for that. * * * `\danog\MadelineProto\Stream\MTProtoTransport\HttpStream`: MTProto over HTTP for browsers and webhosts * * Overhead: medium * * Pros: * * Can be used on restricted webhosts or browsers * * Cons: * * Very big envelope length * * * `\danog\MadelineProto\Stream\MTProtoTransport\HttpsStream`: MTProto over HTTPS for browsers and webhosts, very secure * * Overhead: high * * Pros: * * Can be used on restricted webhosts or browsers * * Provides an additional layer of security by trasmitting data over TLS * * Integrity checks with HMAC built into TLS * * Sequence number checks built into TLS * * Cons: * * Very big envelope length * * Requires an additional round of encryption * * @param class-string $protocol Protocol identifier * */ public function setProtocol(string $protocol): self { if (!isset(\class_implements($protocol)[MTProtoBufferInterface::class])) { throw new Exception("An invalid protocol was specified!"); } $this->protocol = $protocol; return $this; } /** * Get whether to use ipv6. * */ public function getIpv6(): bool { return $this->ipv6; } /** * Set whether to use ipv6. * * @param bool $ipv6 Whether to use ipv6 * */ public function setIpv6(bool $ipv6): self { $this->ipv6 = $ipv6; return $this; } /** * Get subdomains of web.telegram.org for https protocol. * */ public function getSslSubdomains(): array { return $this->sslSubdomains; } /** * Set subdomains of web.telegram.org for https protocol. * * @param array $sslSubdomains Subdomains of web.telegram.org for https protocol. * */ public function setSslSubdomains(array $sslSubdomains): self { $this->sslSubdomains = $sslSubdomains; return $this; } /** * Get minimum media socket count. * */ public function getMinMediaSocketCount(): int { return $this->minMediaSocketCount; } /** * Set minimum media socket count. * * @param int $minMediaSocketCount Minimum media socket count. * */ public function setMinMediaSocketCount(int $minMediaSocketCount): self { $this->minMediaSocketCount = $minMediaSocketCount; return $this; } /** * Get maximum media socket count. * */ public function getMaxMediaSocketCount(): int { return $this->maxMediaSocketCount; } /** * Set maximum media socket count. * * @param int $maxMediaSocketCount Maximum media socket count. * */ public function setMaxMediaSocketCount(int $maxMediaSocketCount): self { $this->maxMediaSocketCount = $maxMediaSocketCount; return $this; } /** * Get robin period (seconds). * */ public function getRobinPeriod(): int { return $this->robinPeriod; } /** * Set robin period (seconds). * * @param int $robinPeriod Robin period (seconds). * */ public function setRobinPeriod(int $robinPeriod): self { $this->robinPeriod = $robinPeriod; return $this; } /** * Get default DC ID. * */ public function getDefaultDc(): int { return $this->defaultDc; } /** * Get default DC params. * */ public function getDefaultDcParams(): array { return $this->defaultDcParams; } /** * Set default DC ID. * * @param int $defaultDc Default DC ID. * */ public function setDefaultDc(int $defaultDc): self { $this->defaultDc = $defaultDc; $this->defaultDcParams = ['datacenter' => $defaultDc]; return $this; } /** * Get proxy identifiers. * * @psalm-return array, array> */ public function getProxies(): array { return $this->proxy; } /** * Add proxy identifier to list, one of:. * * * `\danog\MadelineProto\Stream\MTProtoTransport\ObfuscatedStream::class` * * `\danog\MadelineProto\Stream\Proxy\HttpProxy::class` * * `\danog\MadelineProto\Stream\Proxy\SocksProxy::class` * * @param class-string $proxy Proxy identifier * @param array $extra Extra * */ public function addProxy(string $proxy, array $extra = []): self { if (!isset(\class_implements($proxy)[StreamInterface::class])) { throw new Exception("An invalid proxy class was specified!"); } if (!isset($this->proxy[$proxy])) { $this->proxy[$proxy] = []; } $this->proxy[$proxy][] = $extra; return $this; } /** * Set proxies. * * @param array $proxies Proxies * */ public function setProxy(array $proxies): self { $this->proxy = $proxies; return $this; } /** * Clear proxies. * */ public function clearProxies(): self { $this->proxy = []; return $this; } /** * Remove specific proxy pair. * * */ public function removeProxy(string $proxy, array $extra): self { if (!isset($this->proxy[$proxy])) { return $this; } if (false === $index = \array_search($extra, $this->proxy[$proxy])) { return $this; } unset($this->proxy[$proxy][$index]); if (empty($this->proxy[$proxy])) { unset($this->proxy[$proxy]); } return $this; } /** * Get whether to use the obfuscated protocol: useful to bypass ISP blocks. * */ public function getObfuscated(): bool { return $this->obfuscated; } /** * Set whether to use the obfuscated protocol: useful to bypass ISP blocks. * * @param bool $obfuscated Whether to use the obfuscated protocol. * */ public function setObfuscated(bool $obfuscated): self { $this->obfuscated = $obfuscated; return $this; } /** * Get whether we're in test mode. * */ public function getTestMode(): bool { return $this->testMode; } /** * Set whether we're in test mode. * * @param bool $testMode Whether we're in test mode. * */ public function setTestMode(bool $testMode): self { $this->testMode = $testMode; return $this; } /** * Get transport identifier. * * @return class-string */ public function getTransport(): string { return $this->transport; } /** * Sets the transport protocol to use when connecting to telegram. * Not supported by HTTP and HTTPS protocols, obfuscation must be enabled. * * * `danog\MadelineProto\Stream\Transport`: Default TCP transport * * `danog\MadelineProto\Stream\WsTransport`: Plain websocket transport * * `danog\MadelineProto\Stream\WssTransport`: TLS websocket transport * * @param class-string $transport Transport identifier. * */ public function setTransport(string $transport): self { if (!isset(\class_implements($transport)[RawStreamInterface::class])) { throw new Exception("An invalid transport was specified!"); } $this->transport = $transport; return $this; } /** * Get whether to retry connection. * */ public function getRetry(): bool { return $this->retry; } /** * Set whether to retry connection. * * @param bool $retry Whether to retry connection. * */ public function setRetry(bool $retry): self { $this->retry = $retry; return $this; } /** * Get connection timeout. * */ public function getTimeout(): int { return $this->timeout; } /** * Set connection timeout. * * @param int $timeout Connection timeout. * */ public function setTimeout(int $timeout): self { $this->timeout = $timeout; return $this; } /** * Get ping interval. * */ public function getPingInterval(): int { return $this->pingInterval; } /** * Set ping interval. * * @param int $pingInterval Ping interval * */ public function setPingInterval(int $pingInterval): self { $this->pingInterval = $pingInterval; return $this; } /** * Get whether to use DNS over HTTPS. * */ public function getUseDoH(): bool { return $this->useDoH; } /** * Set whether to use DNS over HTTPS. * * @param bool $useDoH Whether to use DNS over HTTPS * */ public function setUseDoH(bool $useDoH): self { $this->useDoH = $useDoH; return $this; } /** * Get bind on specific address and port. * * @return ?string */ public function getBindTo(): ?string { return $this->bindTo; } /** * Set bind on specific address and port. * * @param ?string $bindTo Bind on specific address and port. * */ public function setBindTo(?string $bindTo): self { $this->bindTo = $bindTo; return $this; } } setAllowAutomaticUpload($settings['upload']['allow_automatic_upload']); } if (isset($settings['download']['report_broken_media'])) { $this->setReportBrokenMedia($settings['download']['report_broken_media']); } if (isset($settings['upload']['parallel_chunks'])) { $this->setUploadParallelChunks($settings['upload']['parallel_chunks']); } if (isset($settings['download']['parallel_chunks'])) { $this->setDownloadParallelChunks($settings['download']['parallel_chunks']); } } /** * Get allow automatic upload of files from file paths present in constructors? * */ public function getAllowAutomaticUpload(): bool { return $this->allowAutomaticUpload; } /** * Set allow automatic upload of files from file paths present in constructors? * * @param bool $allowAutomaticUpload Allow automatic upload of files from file paths present in constructors? * */ public function setAllowAutomaticUpload(bool $allowAutomaticUpload): self { $this->allowAutomaticUpload = $allowAutomaticUpload; return $this; } /** * Get upload parallel chunk count. * */ public function getUploadParallelChunks(): int { return $this->uploadParallelChunks; } /** * Set upload parallel chunk count. * * @param int $uploadParallelChunks Upload parallel chunk count * */ public function setUploadParallelChunks(int $uploadParallelChunks): self { $this->uploadParallelChunks = $uploadParallelChunks; return $this; } /** * Get download parallel chunk count. * */ public function getDownloadParallelChunks(): int { return $this->downloadParallelChunks; } /** * Set download parallel chunk count. * * @param int $downloadParallelChunks Download parallel chunk count * */ public function setDownloadParallelChunks(int $downloadParallelChunks): self { $this->downloadParallelChunks = $downloadParallelChunks; return $this; } /** * Get whether to report undownloadable media to TSF. * */ public function getReportBrokenMedia(): bool { return $this->reportBrokenMedia; } /** * Set whether to report undownloadable media to TSF. * * @param bool $reportBrokenMedia Whether to report undownloadable media to TSF * */ public function setReportBrokenMedia(bool $reportBrokenMedia): self { $this->reportBrokenMedia = $reportBrokenMedia; return $this; } } enableFileReferenceDb; } /** * Set whether to enable the file reference database. If disabled, will break file downloads. * * @param bool $enableFileReferenceDb Whether to enable the file reference database. If disabled, will break file downloads. * */ public function setEnableFileReferenceDb(bool $enableFileReferenceDb): self { $this->enableFileReferenceDb = $enableFileReferenceDb; return $this; } /** * Get whether to enable the min database. If disabled, will break sendMessage (and other methods) in certain conditions. * */ public function getEnableMinDb(): bool { return $this->enableMinDb; } /** * Set whether to enable the min database. If disabled, will break sendMessage (and other methods) in certain conditions. * * @param bool $enableMinDb Whether to enable the min database. If disabled, will break sendMessage (and other methods) in certain conditions. * */ public function setEnableMinDb(bool $enableMinDb): self { $this->enableMinDb = $enableMinDb; return $this; } /** * Get whether to enable the username database. If disabled, will break sendMessage (and other methods) with usernames. * */ public function getEnableUsernameDb(): bool { return $this->enableUsernameDb; } /** * Set whether to enable the username database. If disabled, will break sendMessage (and other methods) with usernames. * * @param bool $enableUsernameDb Whether to enable the username database. If disabled, will break sendMessage (and other methods) with usernames. * */ public function setEnableUsernameDb(bool $enableUsernameDb): self { $this->enableUsernameDb = $enableUsernameDb; return $this; } /** * Get whether to enable the full peer info database. If disabled, will break getFullInfo. * */ public function getEnableFullPeerDb(): bool { return $this->enableFullPeerDb; } /** * Set whether to enable the full peer info database. If disabled, will break getFullInfo. * * @param bool $enableFullPeerDb Whether to enable the full peer info database. If disabled, will break getFullInfo. * */ public function setEnableFullPeerDb(bool $enableFullPeerDb): self { $this->enableFullPeerDb = $enableFullPeerDb; return $this; } /** * Get whether to enable the peer info database. If disabled, will break getInfo. * */ public function getEnablePeerInfoDb(): bool { return $this->enablePeerInfoDb; } /** * Set whether to enable the peer info database. If disabled, will break getInfo. * * @param bool $enablePeerInfoDb Whether to enable the peer info database. If disabled, will break getInfo. * */ public function setEnablePeerInfoDb(bool $enablePeerInfoDb): self { $this->enablePeerInfoDb = $enablePeerInfoDb; return $this; } } preloadAudio; } /** * Set whether to preload all songs in memory. * * @param bool $preloadAudio Whether to preload all songs in memory * */ public function setPreloadAudio(bool $preloadAudio): self { $this->preloadAudio = $preloadAudio; return $this; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Generic; use danog\Loop\Generic\PeriodicLoop as GenericPeriodicLoop; use danog\MadelineProto\Loop\InternalLoop; use danog\MadelineProto\MTProto; /** * {@inheritDoc} * * @internal For internal use */ class PeriodicLoopInternal extends GenericPeriodicLoop { use InternalLoop { __construct as private init; } /** * Constructor. * * @param MTProto $API API instance * @param callable $callable Method * @param string $name Loop name * @param int|null $interval Interval */ public function __construct(MTProto $API, callable $callable, string $name, ?int $interval) { $this->init($API); parent::__construct($callable, $name, $interval); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Generic; use Amp\Promise; use danog\Loop\Generic\GenericLoop as GenericGenericLoop; use danog\MadelineProto\InternalDoc; use danog\MadelineProto\Loop\APILoop; /** * {@inheritDoc} * * @deprecated Use the danog/loop API instead */ class GenericLoop extends GenericGenericLoop { use APILoop { __construct as private init; } /** * Constructor. * * @param InternalDoc $API API instance * @param callable $callable Method * @param string $name Loop name */ public function __construct(InternalDoc $API, callable $callable, string $name) { $this->init($API); parent::__construct($callable, $name); } /** * Pause the loop. * * @param ?int $time For how long to pause the loop, if null will pause forever (until resume is called from outside of the loop) * * @return Promise Resolved when the loop is resumed */ public function pause(?int $time = null): Promise { return parent::pause(\is_integer($time) ? $time * 1000 : $time); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Generic; use danog\Loop\Generic\PeriodicLoop as GenericPeriodicLoop; use danog\MadelineProto\InternalDoc; use danog\MadelineProto\Loop\APILoop; /** * {@inheritDoc} * * @deprecated Use the danog/loop API instead */ class PeriodicLoop extends GenericPeriodicLoop { use APILoop { __construct as private init; } /** * Constructor. * * @param InternalDoc $API API instance * @param callable $callable Method * @param string $name Loop name * @param ?int $interval Interval */ public function __construct(InternalDoc $API, callable $callable, string $name, ?int $interval) { $this->init($API); parent::__construct($callable, $name, $interval === null ? $interval : $interval * 1000); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop; use danog\MadelineProto\EventHandler; use danog\MadelineProto\InternalDoc; /** * API loop trait. */ trait APILoop { use LoggerLoop { __construct as private setLogger; } /** * API instance. */ protected InternalDoc $API; /** * Constructor. * * @param InternalDoc $API API instance */ public function __construct(InternalDoc $API) { $this->API = $API; $this->setLogger($API instanceof EventHandler ? $API->getAPI()->getLogger() : $API->logger); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop; use danog\MadelineProto\Logger; use danog\MadelineProto\MTProto; trait InternalLoop { use LoggerLoop { __construct as private setLogger; } /** * API instance. */ protected MTProto $API; /** * Constructor. * * @param MTProto $API API instance */ public function __construct(MTProto $API) { $this->API = $API; $this->setLogger($API->getLogger()); } private function waitForAuthOrSignal(bool $waitAfter = true): \Generator { $API = $this->API; while (!$API->hasAllAuth()) { $waitAfter = false; $API->logger->logger("Waiting for auth in {$this}"); if (yield $this->waitSignal($this->pause())) { $API->logger->logger("Exiting in {$this} while waiting for auth (init)!", Logger::LEVEL_ULTRA_VERBOSE); return true; } } if (!$waitAfter) { return false; } if (yield $this->waitSignal($this->pause())) { $API->logger->logger("Exiting in {$this} due to signal!", Logger::LEVEL_ULTRA_VERBOSE); return true; } return false; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop; use danog\MadelineProto\Logger; use danog\MadelineProto\Tools; trait LoggerLoop { /** * Whether the loop was started. */ private bool $started = false; /** * Logger instance. */ protected Logger $logger; /** * Constructor. * * @param Logger $logger Logger instance */ public function __construct(Logger $logger) { $this->logger = $logger; } /** * Start the loop. * * Returns false if the loop is already running. * */ public function start(): bool { if ($this->started) { return false; } Tools::callFork((function (): \Generator { $this->startedLoop(); try { yield from $this->loop(); } finally { $this->exitedLoop(); } })()); return true; } /** * Check whether loop is running. * * @return boolean */ public function isRunning(): bool { return $this->started; } /** * Signal that loop has started. * */ protected function startedLoop(): void { $this->started = true; $this->logger->logger("Entered $this", Logger::ULTRA_VERBOSE); parent::startedLoop(); } /** * Signal that loop has exited. * */ protected function exitedLoop(): void { $this->started = false; $this->logger->logger("Exited $this", Logger::ULTRA_VERBOSE); parent::exitedLoop(); } /** * Report pause, can be overriden for logging. * * @param integer $timeout Pause duration, 0 = forever * */ protected function reportPause(int $timeout): void { $this->logger->logger( "Pausing $this for $timeout", Logger::ULTRA_VERBOSE ); } /** * Get loop name. * */ abstract public function __toString(): string; } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Connection; use danog\Loop\ResumableSignalLoop; use danog\MadelineProto\Logger; /** * Ping loop. * * @author Daniil Gentili */ class PingLoop extends ResumableSignalLoop { use Common; /** * Main loop. * */ public function loop(): \Generator { $API = $this->API; $datacenter = $this->datacenter; $connection = $this->connection; $shared = $this->datacenterConnection; $timeout = $shared->getSettings()->getPingInterval(); $timeoutMs = $timeout * 1000; $timeoutDisconnect = $timeout+15; while (true) { while (!$shared->hasTempAuthKey()) { $API->logger->logger("Waiting for temp key in {$this}", Logger::LEVEL_ULTRA_VERBOSE); if (yield $this->waitSignal($this->pause())) { $API->logger->logger("Exiting in {$this} while waiting for temp key (init)!", Logger::LEVEL_ULTRA_VERBOSE); return; } } $API->logger->logger("Ping DC {$datacenter}"); try { yield from $connection->methodCallAsyncRead('ping_delay_disconnect', ['ping_id' => \random_bytes(8), 'disconnect_delay' => $timeoutDisconnect]); } catch (\Throwable $e) { $API->logger->logger("Error while pinging DC {$datacenter}"); $API->logger->logger((string) $e); } if (yield $this->waitSignal($this->pause($timeoutMs))) { $API->logger->logger("Exiting in {$this} due to signal!", Logger::LEVEL_ULTRA_VERBOSE); return; } } } /** * Get loop name. * */ public function __toString(): string { return "Ping loop in DC {$this->datacenter}"; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Connection; use danog\Loop\ResumableSignalLoop; use danog\MadelineProto\MTProto\OutgoingMessage; /** * HttpWait loop. * * @author Daniil Gentili */ class HttpWaitLoop extends ResumableSignalLoop { use Common; /** * Main loop. * */ public function loop(): \Generator { $API = $this->API; $datacenter = $this->datacenter; $connection = $this->connection; $shared = $this->datacenterConnection; if (!$shared->isHttp()) { return; } while (true) { if (yield $this->waitSignal($this->pause())) { return; } if (!$connection->isHttp()) { return; } while (!$shared->hasTempAuthKey()) { if (yield $this->waitSignal($this->pause())) { return; } } $API->logger->logger("DC {$datacenter}: request {$connection->countHttpSent()}, response {$connection->countHttpReceived()}"); if ($connection->countHttpSent() === $connection->countHttpReceived() && (!empty($connection->pendingOutgoing) || !empty($connection->new_outgoing) && !$connection->hasPendingCalls())) { yield from $connection->sendMessage( new OutgoingMessage( ['max_wait' => 30000, 'wait_after' => 0, 'max_delay' => 0], 'http_wait', '', false, false ) ); } $API->logger->logger("DC {$datacenter}: request {$connection->countHttpSent()}, response {$connection->countHttpReceived()}"); } } /** * Loop name. * */ public function __toString(): string { return "HTTP wait loop in DC {$this->datacenter}"; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Connection; use danog\MadelineProto\Connection; use danog\MadelineProto\DataCenterConnection; use danog\MadelineProto\Loop\InternalLoop; /** * RPC call status check loop. * * @author Daniil Gentili */ trait Common { use InternalLoop { __construct as private init; } /** * Connection instance. */ protected Connection $connection; /** * DC ID. * */ protected string $datacenter; /** * DataCenterConnection instance. */ protected DataCenterConnection $datacenterConnection; /** * Constructor function. * * @param Connection $connection Connection */ public function __construct(Connection $connection) { $this->init($connection->getExtra()); $this->connection = $connection; $this->datacenter = $connection->getDatacenterID(); $this->datacenterConnection = $connection->getShared(); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Connection; use Amp\Deferred; use Amp\Loop; use danog\Loop\ResumableSignalLoop; use danog\MadelineProto\Tools; /** * RPC call status check loop. * * @author Daniil Gentili */ class CheckLoop extends ResumableSignalLoop { use Common; /** * Main loop. * */ public function loop(): \Generator { $API = $this->API; $datacenter = $this->datacenter; $connection = $this->connection; $shared = $this->datacenterConnection; $timeout = $shared->getSettings()->getTimeout(); $timeoutMs = $timeout * 1000; $timeoutResend = $timeout * $timeout; // Typically 25 seconds, good enough while (true) { while (empty($connection->new_outgoing)) { if (yield $this->waitSignal($this->pause())) { return; } } if (!$connection->hasPendingCalls()) { if (yield $this->waitSignal($this->pause($timeoutMs))) { return; } continue; } $last_msgid = $connection->msgIdHandler->getMaxId(true); $last_chunk = $connection->getLastChunk(); if ($shared->hasTempAuthKey()) { $full_message_ids = $connection->getPendingCalls(); foreach (\array_chunk($full_message_ids, 8192) as $message_ids) { $deferred = new Deferred(); $deferred->promise()->onResolve(function ($e, $result) use ($message_ids, $API, $connection, $datacenter, $timeoutResend): void { if ($e) { $API->logger("Got exception in check loop for DC {$datacenter}"); $API->logger((string) $e); return; } $reply = []; foreach (\str_split($result['info']) as $key => $chr) { $message_id = $message_ids[$key]; if (!isset($connection->outgoing_messages[$message_id])) { $API->logger->logger('Already got response for and forgot about message ID '.$message_id); continue; } if (!isset($connection->new_outgoing[$message_id])) { $API->logger->logger('Already got response for '.$connection->outgoing_messages[$message_id]); continue; } $message = $connection->new_outgoing[$message_id]; $chr = \ord($chr); switch ($chr & 7) { case 0: $API->logger->logger("Wrong message status 0 for $message", \danog\MadelineProto\Logger::FATAL_ERROR); break; case 1: case 2: case 3: if ($message->getConstructor() === 'msgs_state_req') { $connection->gotResponseForOutgoingMessage($message); break; } $API->logger->logger("Message $message not received by server, resending...", \danog\MadelineProto\Logger::ERROR); $connection->methodRecall('watcherId', ['message_id' => $message_id, 'postpone' => true]); break; case 4: if ($chr & 32) { if ($message->getSent() + $timeoutResend < \time()) { $API->logger->logger("Message $message received by server and is being processed for way too long, resending request...", \danog\MadelineProto\Logger::ERROR); $connection->methodRecall('', ['message_id' => $message_id, 'postpone' => true]); } else { $API->logger->logger("Message $message received by server and is being processed, waiting...", \danog\MadelineProto\Logger::ERROR); } } elseif ($chr & 64) { $API->logger->logger("Message $message received by server and was already processed, requesting reply...", \danog\MadelineProto\Logger::ERROR); $reply[] = $message_id; } elseif ($chr & 128) { $API->logger->logger("Message $message received by server and was already sent, requesting reply...", \danog\MadelineProto\Logger::ERROR); $reply[] = $message_id; } else { $API->logger->logger("Message $message received by server, waiting...", \danog\MadelineProto\Logger::ERROR); $reply[] = $message_id; } } } /* if ($reply) { $deferred= new Deferred; $deferred->promise()->onResolve(fn($e, $res) => var_dump(ord($res['info'][0]))); \danog\MadelineProto\Tools::callFork($connection->objectCall('msg_resend_req', ['msg_ids' => $reply], ['postpone' => true, 'promise' => $deferred])); }*/ $connection->flush(); }); $list = ''; // Don't edit this here pls foreach ($message_ids as $message_id) { $list .= $connection->outgoing_messages[$message_id]->getConstructor().', '; } $API->logger->logger("Still missing {$list} on DC {$datacenter}, sending state request", \danog\MadelineProto\Logger::ERROR); yield from $connection->objectCall('msgs_state_req', ['msg_ids' => $message_ids], ['promise' => $deferred]); } } else { foreach ($connection->new_outgoing as $message_id => $message) { if ($message->wasSent() && $message->getSent() + $timeout < \time() && $message->isUnencrypted() ) { $API->logger->logger("Still missing $message on DC $datacenter, resending", \danog\MadelineProto\Logger::ERROR); $connection->methodRecall('', ['message_id' => $message->getMsgId(), 'postpone' => true]); } } $connection->flush(); } if (yield $this->waitSignal($this->pause($timeoutMs))) { return; } if ($connection->msgIdHandler->getMaxId(true) === $last_msgid && $connection->getLastChunk() === $last_chunk) { $API->logger->logger("We did not receive a response for {$timeout} seconds: reconnecting and exiting check loop on DC {$datacenter}"); //$this->exitedLoop(); Tools::callForkDefer($connection->reconnect()); return; } } } /** * Loop name. * */ public function __toString(): string { return "check loop in DC {$this->datacenter}"; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Connection; use Amp\ByteStream\PendingReadError; use Amp\ByteStream\StreamException; use Amp\Loop; use Amp\Websocket\ClosedException; use danog\Loop\SignalLoop; use danog\MadelineProto\Logger; use danog\MadelineProto\MTProto\IncomingMessage; use danog\MadelineProto\MTProtoTools\Crypt; use danog\MadelineProto\NothingInTheSocketException; use danog\MadelineProto\SecurityException; use danog\MadelineProto\Tools; /** * Socket read loop. * * @author Daniil Gentili */ class ReadLoop extends SignalLoop { use Common; /** * Main loop. * */ public function loop(): \Generator { $API = $this->API; $datacenter = $this->datacenter; $connection = $this->connection; $shared = $this->datacenterConnection; while (true) { try { $error = yield $this->waitSignal($this->readMessage()); } catch (NothingInTheSocketException|StreamException|PendingReadError|\Error $e) { if ($connection->shouldReconnect()) { return; } Tools::callForkDefer((function () use ($API, $connection, $datacenter, $e): \Generator { $API->logger->logger($e); $API->logger->logger("Got nothing in the socket in DC {$datacenter}, reconnecting...", Logger::ERROR); yield from $connection->reconnect(); })()); return; } catch (SecurityException $e) { $connection->resetSession(); $API->logger->logger("Got security exception in DC {$datacenter}, reconnecting...", Logger::ERROR); yield from $connection->reconnect(); throw $e; } if (\is_int($error)) { //$this->exitedLoop(); Tools::callForkDefer((function () use ($error, $shared, $connection, $datacenter, $API): \Generator { if ($error === -404) { if ($shared->hasTempAuthKey()) { $API->logger->logger("WARNING: Resetting auth key in DC {$datacenter}...", Logger::WARNING); $shared->setTempAuthKey(null); $shared->resetSession(); foreach ($connection->new_outgoing as $message) { $message->resetSent(); } yield from $shared->reconnect(); yield from $API->initAuthorization(); } else { yield from $connection->reconnect(); } } elseif ($error === -1) { $API->logger->logger("WARNING: Got quick ack from DC {$datacenter}", Logger::WARNING); yield from $connection->reconnect(); } elseif ($error === 0) { $API->logger->logger("Got NOOP from DC {$datacenter}", Logger::WARNING); yield from $connection->reconnect(); } elseif ($error === -429) { $API->logger->logger("Got -429 from DC {$datacenter}", Logger::WARNING); yield Tools::sleep(3); yield from $connection->reconnect(); } else { yield from $connection->reconnect(); throw new \danog\MadelineProto\RPCErrorException($error, $error); } })()); return; } $connection->httpReceived(); Loop::defer([$connection, 'handleMessages']); if ($shared->isHttp()) { Loop::defer([$connection, 'pingHttpWaiter']); } } } public function readMessage(): \Generator { $API = $this->API; $datacenter = $this->datacenter; $connection = $this->connection; $shared = $this->datacenterConnection; if ($connection->shouldReconnect()) { $API->logger->logger('Not reading because connection is old'); throw new NothingInTheSocketException(); } try { $buffer = yield $connection->stream->getReadBuffer($payload_length); } catch (ClosedException $e) { $API->logger->logger($e->getReason()); if (\strpos($e->getReason(), ' ') === 0) { $payload = -\substr($e->getReason(), 7); $API->logger->logger("Received {$payload} from DC ".$datacenter, Logger::ERROR); return $payload; } throw $e; } if ($payload_length === 4) { $payload = \danog\MadelineProto\Tools::unpackSignedInt(yield $buffer->bufferRead(4)); $API->logger->logger("Received {$payload} from DC ".$datacenter, Logger::ULTRA_VERBOSE); return $payload; } $connection->reading(true); try { $auth_key_id = yield $buffer->bufferRead(8); if ($auth_key_id === "\0\0\0\0\0\0\0\0") { $message_id = yield $buffer->bufferRead(8); $connection->msgIdHandler->checkMessageId($message_id, ['outgoing' => false, 'container' => false]); $message_length = \unpack('V', yield $buffer->bufferRead(4))[1]; $message_data = yield $buffer->bufferRead($message_length); $left = $payload_length - $message_length - 4 - 8 - 8; if ($left) { $API->logger->logger('Padded unencrypted message', Logger::ULTRA_VERBOSE); if ($left < (-$message_length & 15)) { $API->logger->logger('Protocol padded unencrypted message', Logger::ULTRA_VERBOSE); } yield $buffer->bufferRead($left); } } elseif ($auth_key_id === $shared->getTempAuthKey()->getID()) { $message_key = yield $buffer->bufferRead(16); list($aes_key, $aes_iv) = Crypt::aesCalculate($message_key, $shared->getTempAuthKey()->getAuthKey(), false); $payload_length -= 24; $left = $payload_length & 15; $payload_length -= $left; $decrypted_data = Crypt::igeDecrypt(yield $buffer->bufferRead($payload_length), $aes_key, $aes_iv); if ($left) { yield $buffer->bufferRead($left); } if ($message_key != \substr(\hash('sha256', \substr($shared->getTempAuthKey()->getAuthKey(), 96, 32).$decrypted_data, true), 8, 16)) { throw new \danog\MadelineProto\SecurityException('msg_key mismatch'); } /* $server_salt = substr($decrypted_data, 0, 8); if ($server_salt != $shared->getTempAuthKey()->getServerSalt()) { $API->logger->logger('WARNING: Server salt mismatch (my server salt '.$shared->getTempAuthKey()->getServerSalt().' is not equal to server server salt '.$server_salt.').', Logger::WARNING); } */ $session_id = \substr($decrypted_data, 8, 8); if ($session_id !== $connection->session_id) { $API->logger->logger("Session ID mismatch", Logger::FATAL_ERROR); $connection->resetSession(); throw new NothingInTheSocketException(); } $message_id = \substr($decrypted_data, 16, 8); $connection->msgIdHandler->checkMessageId($message_id, ['outgoing' => false, 'container' => false]); $seq_no = \unpack('V', \substr($decrypted_data, 24, 4))[1]; $message_data_length = \unpack('V', \substr($decrypted_data, 28, 4))[1]; if ($message_data_length > \strlen($decrypted_data)) { throw new \danog\MadelineProto\SecurityException('message_data_length is too big'); } if (\strlen($decrypted_data) - 32 - $message_data_length < 12) { throw new \danog\MadelineProto\SecurityException('padding is too small'); } if (\strlen($decrypted_data) - 32 - $message_data_length > 1024) { throw new \danog\MadelineProto\SecurityException('padding is too big'); } if ($message_data_length < 0) { throw new \danog\MadelineProto\SecurityException('message_data_length not positive'); } if ($message_data_length % 4 != 0) { throw new \danog\MadelineProto\SecurityException('message_data_length not divisible by 4'); } $message_data = \substr($decrypted_data, 32, $message_data_length); } else { $API->logger->logger('Got unknown auth_key id', Logger::ERROR); return -404; } [$deserialized, $sideEffects] = $API->getTL()->deserialize($message_data, ['type' => '', 'connection' => $connection]); if (isset($API->referenceDatabase)) { $API->referenceDatabase->reset(); } $message = new IncomingMessage($deserialized, $message_id); if (isset($seq_no)) { $message->setSeqNo($seq_no); } if ($sideEffects) { $message->setSideEffects($sideEffects); } $connection->new_incoming[$message_id] = $connection->incoming_messages[$message_id] = $message; $API->logger->logger('Received payload from DC '.$datacenter, Logger::ULTRA_VERBOSE); } finally { $connection->reading(false); } return true; } /** * Get loop name. * */ public function __toString(): string { return "read loop in DC {$this->datacenter}"; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Connection; use Amp\Loop; use danog\Loop\ResumableSignalLoop; /** * Message cleanup loop. * * @author Daniil Gentili */ class CleanupLoop extends ResumableSignalLoop { use Common; /** * Main loop. * */ public function loop(): \Generator { $connection = $this->connection; while (!yield $this->waitSignal($this->pause(1000))) { if (isset($connection->msgIdHandler)) { $connection->msgIdHandler->cleanup(); } } } /** * Loop name. * */ public function __toString(): string { return "cleanup loop in DC {$this->datacenter}"; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Connection; use Amp\ByteStream\StreamException; use Amp\Loop; use danog\Loop\ResumableSignalLoop; use danog\MadelineProto\Logger; use danog\MadelineProto\MTProto\Container; use danog\MadelineProto\MTProto\OutgoingMessage; use danog\MadelineProto\MTProtoTools\Crypt; use danog\MadelineProto\Tools; /** * Socket write loop. * * @author Daniil Gentili */ class WriteLoop extends ResumableSignalLoop { const MAX_COUNT = 1020; private const MAX_SIZE = 1 << 15; const MAX_IDS = 8192; use Common; /** * Main loop. * */ public function loop(): \Generator { $API = $this->API; $connection = $this->connection; $shared = $this->datacenterConnection; $datacenter = $this->datacenter; $please_wait = false; while (true) { while (empty($connection->pendingOutgoing) || $please_wait) { if ($connection->shouldReconnect()) { $API->logger->logger('Not writing because connection is old'); return; } $please_wait = false; $API->logger->logger("Waiting in {$this}", Logger::ULTRA_VERBOSE); if (yield $this->waitSignal($this->pause())) { $API->logger->logger("Exiting {$this}", Logger::ULTRA_VERBOSE); return; } $API->logger->logger("Done waiting in {$this}", Logger::ULTRA_VERBOSE); if ($connection->shouldReconnect()) { $API->logger->logger('Not writing because connection is old'); return; } } $connection->writing(true); try { $please_wait = yield from $this->{$shared->hasTempAuthKey() ? 'encryptedWriteLoop' : 'unencryptedWriteLoop'}(); } catch (StreamException $e) { if ($connection->shouldReconnect()) { return; } Tools::callForkDefer((function () use ($API, $connection, $datacenter, $e): \Generator { $API->logger->logger($e); $API->logger->logger("Got nothing in the socket in DC {$datacenter}, reconnecting...", Logger::ERROR); yield from $connection->reconnect(); })()); return; } finally { $connection->writing(false); } //$connection->waiter->resume(); } } public function unencryptedWriteLoop(): \Generator { $API = $this->API; $datacenter = $this->datacenter; $connection = $this->connection; $shared = $this->datacenterConnection; while ($connection->pendingOutgoing) { $skipped_all = true; foreach ($connection->pendingOutgoing as $k => $message) { if ($shared->hasTempAuthKey()) { return; } if ($message->isEncrypted()) { continue; } if ($message->getState() & OutgoingMessage::STATE_REPLIED) { unset($connection->pendingOutgoing[$k]); continue; } $skipped_all = false; $API->logger->logger("Sending $message as unencrypted message to DC $datacenter", \danog\MadelineProto\Logger::ULTRA_VERBOSE); $message_id = $message->getMsgId() ?? $connection->msgIdHandler->generateMessageId(); $length = \strlen($message->getSerializedBody()); $pad_length = -$length & 15; $pad_length += 16 * \danog\MadelineProto\Tools::randomInt($modulus = 16); $pad = \danog\MadelineProto\Tools::random($pad_length); $buffer = yield $connection->stream->getWriteBuffer(8 + 8 + 4 + $pad_length + $length); yield $buffer->bufferWrite("\0\0\0\0\0\0\0\0".$message_id.\danog\MadelineProto\Tools::packUnsignedInt($length).$message->getSerializedBody().$pad); $connection->httpSent(); $API->logger->logger("Sent $message as unencrypted message to DC $datacenter!", \danog\MadelineProto\Logger::ULTRA_VERBOSE); unset($connection->pendingOutgoing[$k]); $message->setMsgId($message_id); $connection->outgoing_messages[$message_id] = $message; $connection->new_outgoing[$message_id] = $message; $message->sent(); } if ($skipped_all) { return true; } } } public function encryptedWriteLoop(): \Generator { $API = $this->API; $datacenter = $this->datacenter; $connection = $this->connection; $shared = $this->datacenterConnection; do { if (!$shared->hasTempAuthKey()) { return; } if ($shared->isHttp() && empty($connection->pendingOutgoing)) { return; } \ksort($connection->pendingOutgoing); $messages = []; $keys = []; $total_length = 0; $count = 0; $skipped = false; $has_seq = false; $has_state = false; $has_resend = false; $has_http_wait = false; foreach ($connection->pendingOutgoing as $k => $message) { if ($message->isUnencrypted()) { continue; } if ($message->getState() & OutgoingMessage::STATE_REPLIED) { unset($connection->pendingOutgoing[$k]); $API->logger->logger("Skipping resending of $message, we already got a reply in DC $datacenter"); continue; } if ($message instanceof Container) { unset($connection->pendingOutgoing[$k]); continue; } $constructor = $message->getConstructor(); if ($shared->getGenericSettings()->getAuth()->getPfs() && !$shared->isBound() && !$connection->isCDN() && $message->isMethod() && !\in_array($constructor, ['http_wait', 'auth.bindTempAuthKey'])) { $API->logger->logger("Skipping $message due to unbound keys in DC $datacenter"); $skipped = true; continue; } if ($constructor === 'http_wait') { $has_http_wait = true; } if ($constructor === 'msgs_state_req') { if ($has_state) { $API->logger->logger("Already have a state request queued for the current container in DC {$datacenter}"); continue; } $has_state = true; } if ($constructor === 'msg_resend_req') { if ($has_resend) { continue; } $has_resend = true; } $body_length = \strlen($message->getSerializedBody()); $actual_length = $body_length + 32; if ($total_length && $total_length + $actual_length > 32760 || $count >= 1020) { $API->logger->logger('Length overflow, postponing part of payload', \danog\MadelineProto\Logger::ULTRA_VERBOSE); break; } if ($message->hasSeqNo()) { $has_seq = true; } $message_id = $message->getMsgId() ?? $connection->msgIdHandler->generateMessageId(); $API->logger->logger("Sending $message as encrypted message to DC $datacenter", \danog\MadelineProto\Logger::ULTRA_VERBOSE); $MTmessage = [ '_' => 'MTmessage', 'msg_id' => $message_id, 'body' => $message->getSerializedBody(), 'seqno' => $message->getSeqNo() ?? $connection->generateOutSeqNo($message->isContentRelated()) ]; if ($message->isMethod() && $constructor !== 'http_wait' && $constructor !== 'ping_delay_disconnect' && $constructor !== 'auth.bindTempAuthKey') { if (!$shared->getTempAuthKey()->isInited()) { if ($constructor === 'help.getConfig' || $constructor === 'upload.getCdnFile') { $API->logger->logger(\sprintf(\danog\MadelineProto\Lang::$current_lang['write_client_info'], $constructor), \danog\MadelineProto\Logger::NOTICE); $MTmessage['body'] = (yield from $API->getTL()->serializeMethod('invokeWithLayer', ['layer' => $API->settings->getSchema()->getLayer(), 'query' => yield from $API->getTL()->serializeMethod('initConnection', ['api_id' => $API->settings->getAppInfo()->getApiId(), 'api_hash' => $API->settings->getAppInfo()->getApiHash(), 'device_model' => !$connection->isCDN() ? $API->settings->getAppInfo()->getDeviceModel() : 'n/a', 'system_version' => !$connection->isCDN() ? $API->settings->getAppInfo()->getSystemVersion() : 'n/a', 'app_version' => $API->settings->getAppInfo()->getAppVersion(), 'system_lang_code' => $API->settings->getAppInfo()->getLangCode(), 'lang_code' => $API->settings->getAppInfo()->getLangCode(), 'lang_pack' => $API->settings->getAppInfo()->getLangPack(), 'proxy' => $connection->getCtx()->getInputClientProxy(), 'query' => $MTmessage['body']])])); } else { $API->logger->logger("Skipping $message due to uninited connection in DC $datacenter"); $skipped = true; continue; } } elseif ($message->hasQueue()) { $queueId = $message->getQueueId(); if (!isset($connection->call_queue[$queueId])) { $connection->call_queue[$queueId] = []; } $MTmessage['body'] = (yield from $API->getTL()->serializeMethod('invokeAfterMsgs', ['msg_ids' => $connection->call_queue[$queueId], 'query' => $MTmessage['body']])); $connection->call_queue[$queueId][$message_id] = $message_id; if (\count($connection->call_queue[$queueId]) > $API->settings->getRpc()->getLimitCallQueue()) { \reset($connection->call_queue[$queueId]); $key = \key($connection->call_queue[$queueId]); unset($connection->call_queue[$queueId][$key]); } } // TODO /* if ($API->settings['requests']['gzip_encode_if_gt'] !== -1 && ($l = strlen($MTmessage['body'])) > $API->settings['requests']['gzip_encode_if_gt']) { if (($g = strlen($gzipped = gzencode($MTmessage['body']))) < $l) { $MTmessage['body'] = yield $API->getTL()->serializeObject(['type' => ''], ['_' => 'gzip_packed', 'packed_data' => $gzipped], 'gzipped data'); $API->logger->logger('Using GZIP compression for ' . $constructor . ', saved ' . ($l - $g) . ' bytes of data, reduced call size by ' . $g * 100 / $l . '%', \danog\MadelineProto\Logger::ULTRA_VERBOSE); } unset($gzipped); }*/ } $body_length = \strlen($MTmessage['body']); $actual_length = $body_length + 32; if ($total_length && $total_length + $actual_length > 32760) { $API->logger->logger('Length overflow, postponing part of payload', \danog\MadelineProto\Logger::ULTRA_VERBOSE); break; } $count++; $total_length += $actual_length; $MTmessage['bytes'] = $body_length; $messages[] = $MTmessage; $keys[$k] = $message_id; $message->setSeqNo($MTmessage['seqno']) ->setMsgId($MTmessage['msg_id']); } $MTmessage = null; $acks = \array_slice($connection->ack_queue, 0, self::MAX_COUNT); if ($ackCount = \count($acks)) { $API->logger->logger("Adding msgs_ack", Logger::ULTRA_VERBOSE); $body = yield from $this->API->getTL()->serializeObject(['type' => ''], ['_' => 'msgs_ack', 'msg_ids' => $acks], 'msgs_ack'); $messages []= [ '_' => 'MTmessage', 'msg_id' => $connection->msgIdHandler->generateMessageId(), 'body' => $body, 'seqno' => $connection->generateOutSeqNo(false), 'bytes' => \strlen($body) ]; $count++; unset($acks, $body); } if ($shared->isHttp() && !$has_http_wait) { $API->logger->logger("Adding http_wait", Logger::ULTRA_VERBOSE); $body = yield from $this->API->getTL()->serializeObject(['type' => ''], ['_' => 'http_wait', 'max_wait' => 30000, 'wait_after' => 0, 'max_delay' => 0], 'http_wait'); $messages []= [ '_' => 'MTmessage', 'msg_id' => $connection->msgIdHandler->generateMessageId(), 'body' => $body, 'seqno' => $connection->generateOutSeqNo(true), 'bytes' => \strlen($body) ]; $count++; unset($body); } if ($count > 1 || $has_seq) { $API->logger->logger("Wrapping in msg_container ({$count} messages of total size {$total_length}) as encrypted message for DC {$datacenter}", \danog\MadelineProto\Logger::ULTRA_VERBOSE); $message_id = $connection->msgIdHandler->generateMessageId(); $connection->pendingOutgoing[$connection->pendingOutgoingKey] = new Container(\array_values($keys)); $keys[$connection->pendingOutgoingKey++] = $message_id; $message_data = yield from $API->getTL()->serializeObject(['type' => ''], ['_' => 'msg_container', 'messages' => $messages], 'container'); $message_data_length = \strlen($message_data); $seq_no = $connection->generateOutSeqNo(false); } elseif ($count) { $message = $messages[0]; $message_data = $message['body']; $message_data_length = $message['bytes']; $message_id = $message['msg_id']; $seq_no = $message['seqno']; } else { $API->logger->logger("NO MESSAGE SENT in DC {$datacenter}", \danog\MadelineProto\Logger::WARNING); return true; } unset($messages); $plaintext = $shared->getTempAuthKey()->getServerSalt().$connection->session_id.$message_id.\pack('VV', $seq_no, $message_data_length).$message_data; $padding = \danog\MadelineProto\Tools::posmod(-\strlen($plaintext), 16); if ($padding < 12) { $padding += 16; } $padding = \danog\MadelineProto\Tools::random($padding); $message_key = \substr(\hash('sha256', \substr($shared->getTempAuthKey()->getAuthKey(), 88, 32).$plaintext.$padding, true), 8, 16); list($aes_key, $aes_iv) = Crypt::aesCalculate($message_key, $shared->getTempAuthKey()->getAuthKey()); $message = $shared->getTempAuthKey()->getID().$message_key.Crypt::igeEncrypt($plaintext.$padding, $aes_key, $aes_iv); $buffer = yield $connection->stream->getWriteBuffer(\strlen($message)); yield $buffer->bufferWrite($message); $connection->httpSent(); $API->logger->logger("Sent encrypted payload to DC {$datacenter}", \danog\MadelineProto\Logger::ULTRA_VERBOSE); if ($ackCount) { $connection->ack_queue = \array_slice($connection->ack_queue, $ackCount); } foreach ($keys as $key => $message_id) { $message = $connection->pendingOutgoing[$key]; unset($connection->pendingOutgoing[$key]); $connection->outgoing_messages[$message_id] = $message; if ($message->hasPromise()) { $connection->new_outgoing[$message_id] = $message; } $message->sent(); } } while ($connection->pendingOutgoing && !$skipped); if (empty($connection->pendingOutgoing)) { $connection->pendingOutgoing = []; $connection->pendingOutgoingKey = 'a'; } return $skipped; } /** * Get loop name. * */ public function __toString(): string { return "write loop in DC {$this->datacenter}"; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Update; use danog\Loop\ResumableSignalLoop; use danog\MadelineProto\Exception; use danog\MadelineProto\Logger; use danog\MadelineProto\Loop\InternalLoop; use danog\MadelineProto\MTProto; use danog\MadelineProto\PTSException; use danog\MadelineProto\RPCErrorException; /** * Update loop. * * @author Daniil Gentili */ class UpdateLoop extends ResumableSignalLoop { use InternalLoop { __construct as private init; } /** * Main loop ID. */ const GENERIC = 0; private $toPts; /** * Loop name. */ private int $channelId; /** * Feed loop. */ private ?FeedLoop $feeder = null; /** * Constructor. * * @param integer $channelId */ public function __construct(MTProto $API, int $channelId) { $this->init($API); $this->channelId = $channelId; } /** * Main loop. * */ public function loop(): \Generator { $API = $this->API; $feeder = $this->feeder = $API->feeders[$this->channelId]; if (yield from $this->waitForAuthOrSignal()) { return; } $this->state = $state = $this->channelId === self::GENERIC ? yield from $API->loadUpdateState() : $API->loadChannelState($this->channelId); $timeout = 10; $first = true; while (true) { if (yield from $this->waitForAuthOrSignal(false)) { return; } $result = []; $toPts = $this->toPts; $this->toPts = null; while (true) { if ($this->channelId) { $API->logger->logger('Resumed and fetching '.$this->channelId.' difference...', \danog\MadelineProto\Logger::ULTRA_VERBOSE); if ($state->pts() <= 1) { $limit = 10; } elseif ($API->authorization['user']['bot']) { $limit = 100000; } else { $limit = 100; } $request_pts = $state->pts(); try { $difference = yield from $API->methodCallAsyncRead('updates.getChannelDifference', ['channel' => $this->API->toSupergroup($this->channelId), 'filter' => ['_' => 'channelMessagesFilterEmpty'], 'pts' => $request_pts, 'limit' => $limit, 'force' => true], ['datacenter' => $API->datacenter->curdc, 'postpone' => $first]); } catch (RPCErrorException $e) { if (\in_array($e->rpc, ['CHANNEL_PRIVATE', 'CHAT_FORBIDDEN', 'CHANNEL_INVALID', 'USER_BANNED_IN_CHANNEL'])) { $feeder->signal(true); unset($API->updaters[$this->channelId], $API->feeders[$this->channelId]); $API->getChannelStates()->remove($this->channelId); $API->logger->logger("Channel private, exiting {$this}"); return true; } throw $e; } catch (Exception $e) { if (\in_array($e->getMessage(), ['This peer is not present in the internal peer database'])) { $feeder->signal(true); $API->getChannelStates()->remove($this->channelId); unset($API->updaters[$this->channelId], $API->feeders[$this->channelId]); $API->logger->logger("Channel private, exiting {$this}"); return true; } throw $e; } catch (PTSException $e) { $API->logger->logger("Got PTS exception, exiting update loop for $this: $e", Logger::FATAL_ERROR); return true; } if (isset($difference['timeout'])) { $timeout = $difference['timeout']; } $timeout = \min(10, $timeout); $API->logger->logger('Got '.$difference['_'], \danog\MadelineProto\Logger::ULTRA_VERBOSE); switch ($difference['_']) { case 'updates.channelDifferenceEmpty': $state->update($difference); unset($difference); break 2; case 'updates.channelDifference': if ($request_pts >= $difference['pts'] && $request_pts > 1) { $API->logger->logger("The PTS ({$difference['pts']}) I got with getDifference is smaller than the PTS I requested ".$state->pts().', using '.($state->pts() + 1), \danog\MadelineProto\Logger::VERBOSE); $difference['pts'] = $request_pts + 1; } $result += (yield from $feeder->feed($difference['other_updates'])); $state->update($difference); $feeder->saveMessages($difference['new_messages']); if (!$difference['final']) { if ($difference['pts'] >= $toPts) { unset($difference); break 2; } unset($difference); break; } unset($difference); break 2; case 'updates.channelDifferenceTooLong': if (isset($difference['dialog']['pts'])) { $difference['pts'] = $difference['dialog']['pts']; } $state->update($difference); $feeder->saveMessages($difference['messages']); unset($difference); break; default: throw new \danog\MadelineProto\Exception('Unrecognized update difference received: '.\var_export($difference, true)); } } else { $API->logger->logger('Resumed and fetching normal difference...', \danog\MadelineProto\Logger::ULTRA_VERBOSE); $difference = yield from $API->methodCallAsyncRead('updates.getDifference', ['pts' => $state->pts(), 'date' => $state->date(), 'qts' => $state->qts()], $API->settings->getDefaultDcParams()); $API->logger->logger('Got '.$difference['_'], \danog\MadelineProto\Logger::ULTRA_VERBOSE); switch ($difference['_']) { case 'updates.differenceEmpty': $state->update($difference); unset($difference); break 2; case 'updates.difference': $state->qts($difference['state']['qts']); foreach ($difference['new_encrypted_messages'] as &$encrypted) { $encrypted = ['_' => 'updateNewEncryptedMessage', 'message' => $encrypted]; } $result += (yield from $feeder->feed($difference['other_updates'])); $result += (yield from $feeder->feed($difference['new_encrypted_messages'])); $state->update($difference['state']); $feeder->saveMessages($difference['new_messages']); unset($difference); break 2; case 'updates.differenceSlice': $state->qts($difference['intermediate_state']['qts']); foreach ($difference['new_encrypted_messages'] as &$encrypted) { $encrypted = ['_' => 'updateNewEncryptedMessage', 'message' => $encrypted]; } $result += (yield from $feeder->feed($difference['other_updates'])); $result += (yield from $feeder->feed($difference['new_encrypted_messages'])); $state->update($difference['intermediate_state']); $feeder->saveMessages($difference['new_messages']); if ($difference['intermediate_state']['pts'] >= $toPts) { unset($difference); break 2; } unset($difference); break; case 'updates.differenceTooLong': $state->update($difference); unset($difference); break; default: throw new \danog\MadelineProto\Exception('Unrecognized update difference received: '.\var_export($difference, true)); } } } $API->logger->logger("Finished parsing updates in {$this}, now resuming feeders", Logger::ULTRA_VERBOSE); foreach ($result as $channelId => $_) { $API->feeders[$channelId]->resumeDefer(); } $API->logger->logger("Finished resuming feeders in {$this}, signaling updates", Logger::ULTRA_VERBOSE); $API->signalUpdate(); $API->logger->logger("Finished signaling updates in {$this}, pausing for $timeout seconds", Logger::ULTRA_VERBOSE); $first = false; if (yield $this->waitSignal($this->pause($timeout * 1000))) { $API->logger->logger("Exiting {$this} due to signal"); return; } } } public function setLimit(int $toPts): void { $this->toPts = $toPts; } /** * Get loop name. * */ public function __toString(): string { return $this->channelId ? "getUpdate loop channel {$this->channelId}" : 'getUpdate loop generic'; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Update; use danog\Loop\ResumableSignalLoop; use danog\MadelineProto\Loop\InternalLoop; use danog\MadelineProto\MTProto; use danog\MadelineProto\SecurityException; /** * Secret feed loop. * * @author Daniil Gentili */ class SecretFeedLoop extends ResumableSignalLoop { use InternalLoop { __construct as private init; } /** * Incoming secret updates array. */ private array $incomingUpdates = []; /** * Secret chat ID. */ private int $secretId; /** * Constructor. * * @param MTProto $API API instance * @param integer $secretId Secret chat ID */ public function __construct(MTProto $API, int $secretId) { $this->init($API); $this->secretId = $secretId; } /** * Main loop. * */ public function loop(): \Generator { $API = $this->API; if (yield from $this->waitForAuthOrSignal()) { return; } while (true) { $API->logger->logger("Resumed {$this}"); while ($this->incomingUpdates) { $updates = $this->incomingUpdates; $this->incomingUpdates = []; foreach ($updates as $update) { try { if (!yield from $API->handleEncryptedUpdate($update)) { $API->logger->logger("Secret chat deleted, exiting $this..."); unset($API->secretFeeders[$this->secretId]); return; } } catch (SecurityException $e) { $API->logger->logger("Secret chat deleted, exiting $this..."); unset($API->secretFeeders[$this->secretId]); throw $e; } } $updates = null; } if (yield from $this->waitForAuthOrSignal()) { return; } } } /** * Feed incoming update to loop. * */ public function feed(array $update): void { $this->incomingUpdates []= $update; } public function __toString(): string { return "secret chat feed loop {$this->secretId}"; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Update; use danog\Loop\ResumableSignalLoop; use danog\MadelineProto\Loop\InternalLoop; use danog\MadelineProto\MTProto; use danog\MadelineProto\MTProtoTools\UpdatesState; /** * Update feed loop. * * @author Daniil Gentili */ class FeedLoop extends ResumableSignalLoop { use InternalLoop { __construct as private init; } /** * Main loop ID. */ const GENERIC = 0; /** * Incoming updates array. */ private array $incomingUpdates = []; /** * Parsed updates array. */ private array $parsedUpdates = []; /** * Channel ID. */ private int $channelId; /** * Update loop. * * @var UpdateLoop */ private ?UpdateLoop $updater = null; /** * Update state. */ private ?UpdatesState $state = null; /** * Constructor. * * @param MTProto $API API instance * @param integer $channelId Constructor */ public function __construct(MTProto $API, int $channelId = 0) { $this->init($API); $this->channelId = $channelId; } /** * Main loop. * */ public function loop(): \Generator { $API = $this->API; $this->updater = $API->updaters[$this->channelId]; if (yield from $this->waitForAuthOrSignal()) { return; } $this->state = $this->channelId === self::GENERIC ? yield from $API->loadUpdateState() : $API->loadChannelState($this->channelId); while (true) { $API->logger->logger("Resumed {$this}"); while ($this->incomingUpdates) { $updates = $this->incomingUpdates; $this->incomingUpdates = []; yield from $this->parse($updates); $updates = null; } while ($this->parsedUpdates) { $parsedUpdates = $this->parsedUpdates; $this->parsedUpdates = []; foreach ($parsedUpdates as $update) { yield from $API->saveUpdate($update); } $parsedUpdates = null; $this->API->signalUpdate(); } if (yield from $this->waitForAuthOrSignal()) { return; } } } public function parse(array $updates): \Generator { \reset($updates); while ($updates) { $key = \key($updates); $update = $updates[$key]; unset($updates[$key]); if ($update['_'] === 'updateChannelTooLong') { $this->API->logger->logger('Got channel too long update, getting difference...', \danog\MadelineProto\Logger::VERBOSE); yield $this->updater->resume(); continue; } if (isset($update['pts'], $update['pts_count'])) { $logger = function ($msg) use ($update): void { $pts_count = $update['pts_count']; $mid = isset($update['message']['id']) ? $update['message']['id'] : '-'; $mypts = $this->state->pts(); $computed = $mypts + $pts_count; $this->API->logger->logger("{$msg}. My pts: {$mypts}, remote pts: {$update['pts']}, computed pts: {$computed}, msg id: {$mid}, channel id: {$this->channelId}", \danog\MadelineProto\Logger::ULTRA_VERBOSE); }; $result = $this->state->checkPts($update); if ($result < 0) { $logger('PTS duplicate'); continue; } if ($result > 0) { $logger('PTS hole'); $this->updater->setLimit($this->state->pts() + $result); yield $this->updater->resume(); $updates = \array_merge($this->incomingUpdates, $updates); $this->incomingUpdates = []; continue; } if (isset($update['message']['id'], $update['message']['peer_id']) && !\in_array($update['_'], ['updateEditMessage', 'updateEditChannelMessage', 'updateMessageID'])) { if (!$this->API->checkMsgId($update['message'])) { $logger('MSGID duplicate'); continue; } } $logger('PTS OK'); $this->state->pts($update['pts']); } $this->save($update); } } public function feed(array $updates): \Generator { $result = []; foreach ($updates as $update) { $result[yield from $this->feedSingle($update)] = true; } return $result; } public function feedSingle(array $update): \Generator { $channelId = self::GENERIC; switch ($update['_']) { case 'updateNewChannelMessage': case 'updateEditChannelMessage': $channelId = isset($update['message']['peer_id']['channel_id']) ? $update['message']['peer_id']['channel_id'] : self::GENERIC; if (!$channelId) { return false; } break; case 'updateChannelWebPage': case 'updateDeleteChannelMessages': $channelId = $update['channel_id']; break; case 'updateChannelTooLong': $channelId = isset($update['channel_id']) ? $update['channel_id'] : self::GENERIC; if (!isset($update['pts'])) { $update['pts'] = 1; } break; } if ($channelId && !$this->API->getChannelStates()->has($channelId)) { $this->API->loadChannelState($channelId, $update); if (!isset($this->API->feeders[$channelId])) { $this->API->feeders[$channelId] = new self($this->API, $channelId); } if (!isset($this->API->updaters[$channelId])) { $this->API->updaters[$channelId] = new UpdateLoop($this->API, $channelId); } $this->API->feeders[$channelId]->start(); $this->API->updaters[$channelId]->start(); } switch ($update['_']) { case 'updateNewMessage': case 'updateEditMessage': case 'updateNewChannelMessage': case 'updateEditChannelMessage': $to = false; $from = false; $via_bot = false; $entities = false; if ($update['message']['_'] !== 'messageEmpty' && ( ( $from = isset($update['message']['from_id']) && !(yield from $this->API->peerIsset($update['message']['from_id'])) ) || ( $to = !(yield from $this->API->peerIsset($update['message']['peer_id'])) ) || ( $via_bot = isset($update['message']['via_bot_id']) && !(yield from $this->API->peerIsset($update['message']['via_bot_id'])) ) || ( $entities = isset($update['message']['entities']) && !(yield from $this->API->entitiesPeerIsset($update['message']['entities'])) ) ) ) { $log = ''; if ($from) { $from_id = $this->API->getId($update['message']['from_id']); $log .= "from_id {$from_id}, "; } if ($to) { $log .= 'peer_id '.\json_encode($update['message']['peer_id']).', '; } if ($via_bot) { $log .= "via_bot {$update['message']['via_bot_id']}, "; } if ($entities) { $log .= 'entities '.\json_encode($update['message']['entities']).', '; } $this->API->logger->logger("Not enough data: for message update {$log}, getting difference...", \danog\MadelineProto\Logger::VERBOSE); $update = ['_' => 'updateChannelTooLong']; if ($channelId && $to) { $channelId = self::GENERIC; } } break; default: if ($channelId && !(yield from $this->API->peerIsset($this->API->toSupergroup($channelId)))) { $this->API->logger->logger('Skipping update, I do not have the channel id '.$channelId, \danog\MadelineProto\Logger::ERROR); return false; } break; } if ($channelId !== $this->channelId) { if (isset($this->API->feeders[$channelId])) { return yield from $this->API->feeders[$channelId]->feedSingle($update); } elseif ($this->channelId) { return yield from $this->API->feeders[self::GENERIC]->feedSingle($update); } } $this->API->logger->logger('Was fed an update of type '.$update['_']." in {$this}...", \danog\MadelineProto\Logger::ULTRA_VERBOSE); $this->incomingUpdates[] = $update; return $this->channelId; } public function save($update): void { $this->parsedUpdates[] = $update; } public function saveMessages($messages): void { foreach ($messages as $message) { if (!$this->API->checkMsgId($message)) { $this->API->logger->logger("MSGID duplicate ({$message['id']}) in {$this}"); continue; } if ($message['_'] !== 'messageEmpty') { $this->API->logger->logger('Getdiff fed me message of type '.$message['_']." in {$this}...", \danog\MadelineProto\Logger::VERBOSE); } $this->parsedUpdates[] = ['_' => $this->channelId === self::GENERIC ? 'updateNewMessage' : 'updateNewChannelMessage', 'message' => $message, 'pts' => -1, 'pts_count' => -1]; } } public function __toString(): string { return !$this->channelId ? 'update feed loop generic' : "update feed loop channel {$this->channelId}"; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\Loop\Update; use danog\Loop\ResumableSignalLoop; use danog\MadelineProto\Logger; use danog\MadelineProto\Loop\InternalLoop; use danog\MadelineProto\MTProtoTools\UpdatesState; /** * update feed loop. * * @author Daniil Gentili */ class SeqLoop extends ResumableSignalLoop { use InternalLoop; /** * Incoming updates. */ private array $incomingUpdates = []; /** * Update feeder. */ private ?FeedLoop $feeder = null; /** * Pending updates. */ private array $pendingWakeups = []; /** * State. */ private ?UpdatesState $state = null; /** * Main loop. * */ public function loop(): \Generator { $API = $this->API; $this->feeder = $API->feeders[FeedLoop::GENERIC]; if (yield from $this->waitForAuthOrSignal()) { return; } $this->state = (yield from $API->loadUpdateState()); while (true) { $API->logger->logger("Resumed $this!", Logger::LEVEL_ULTRA_VERBOSE); while ($this->incomingUpdates) { $updates = $this->incomingUpdates; $this->incomingUpdates = []; yield from $this->parse($updates); $updates = null; } while ($this->pendingWakeups) { \reset($this->pendingWakeups); $channelId = \key($this->pendingWakeups); unset($this->pendingWakeups[$channelId]); if (isset($this->API->feeders[$channelId])) { $this->API->feeders[$channelId]->resume(); } } if (yield from $this->waitForAuthOrSignal()) { return; } } } public function parse(array $updates): \Generator { \reset($updates); while ($updates) { $options = []; $key = \key($updates); $update = $updates[$key]; unset($updates[$key]); $options = $update['options']; $seq_start = $options['seq_start']; $seq_end = $options['seq_end']; $result = $this->state->checkSeq($seq_start); if ($result > 0) { $this->API->logger->logger('Seq hole. seq_start: '.$seq_start.' != cur seq: '.($this->state->seq() + 1), \danog\MadelineProto\Logger::ERROR); yield $this->pause(1000); if (!$this->incomingUpdates) { yield $this->API->updaters[UpdateLoop::GENERIC]->resume(); } $this->incomingUpdates = \array_merge($this->incomingUpdates, [$update], $updates); continue; } if ($result < 0) { $this->API->logger->logger('Seq too old. seq_start: '.$seq_start.' != cur seq: '.($this->state->seq() + 1), \danog\MadelineProto\Logger::ERROR); continue; } $this->state->seq($seq_end); if (isset($options['date'])) { $this->state->date($options['date']); } yield from $this->save($update); } } /** * @param (array|mixed)[] $updates */ public function feed(array $updates): void { $this->API->logger->logger('Was fed updates of type '.$updates['_'].'...', \danog\MadelineProto\Logger::VERBOSE); $this->incomingUpdates[] = $updates; } /** * @var array{updates: array} $updates */ public function save(array $updates): \Generator { $this->pendingWakeups += (yield from $this->feeder->feed($updates['updates'])); } /** * @param true[] $wakeups */ public function addPendingWakeups(array $wakeups): void { $this->pendingWakeups += $wakeups; } public function __toString(): string { return 'update seq loop'; } } ===8=== decryptedMessage#1f814f1f random_id:long random_bytes:bytes message:string media:DecryptedMessageMedia = DecryptedMessage; decryptedMessageService#aa48327d random_id:long random_bytes:bytes action:DecryptedMessageAction = DecryptedMessage; decryptedMessageMediaEmpty#89f5c4a = DecryptedMessageMedia; decryptedMessageMediaPhoto#32798a8c thumb:bytes thumb_w:int thumb_h:int w:int h:int size:int key:bytes iv:bytes = DecryptedMessageMedia; decryptedMessageMediaVideo#4cee6ef3 thumb:bytes thumb_w:int thumb_h:int duration:int w:int h:int size:int key:bytes iv:bytes = DecryptedMessageMedia; decryptedMessageMediaGeoPoint#35480a59 lat:double long:double = DecryptedMessageMedia; decryptedMessageMediaContact#588a0a97 phone_number:string first_name:string last_name:string user_id:int = DecryptedMessageMedia; decryptedMessageActionSetMessageTTL#a1733aec ttl_seconds:int = DecryptedMessageAction; decryptedMessageMediaDocument#b095434b thumb:bytes thumb_w:int thumb_h:int file_name:string mime_type:string size:int key:bytes iv:bytes = DecryptedMessageMedia; decryptedMessageMediaAudio#6080758f duration:int size:int key:bytes iv:bytes = DecryptedMessageMedia; decryptedMessageActionReadMessages#c4f40be random_ids:Vector = DecryptedMessageAction; decryptedMessageActionDeleteMessages#65614304 random_ids:Vector = DecryptedMessageAction; decryptedMessageActionScreenshotMessages#8ac1f475 random_ids:Vector = DecryptedMessageAction; decryptedMessageActionFlushHistory#6719e45c = DecryptedMessageAction; ===17=== decryptedMessage#204d3878 random_id:long ttl:int message:string media:DecryptedMessageMedia = DecryptedMessage; decryptedMessageService#73164160 random_id:long action:DecryptedMessageAction = DecryptedMessage; decryptedMessageMediaVideo#524a415d thumb:bytes thumb_w:int thumb_h:int duration:int mime_type:string w:int h:int size:int key:bytes iv:bytes = DecryptedMessageMedia; decryptedMessageMediaAudio#57e0a9cb duration:int mime_type:string size:int key:bytes iv:bytes = DecryptedMessageMedia; decryptedMessageLayer#1be31789 random_bytes:bytes layer:int in_seq_no:int out_seq_no:int message:DecryptedMessage = DecryptedMessageLayer; sendMessageTypingAction#16bf744e = SendMessageAction; sendMessageCancelAction#fd5ec8f5 = SendMessageAction; sendMessageRecordVideoAction#a187d66f = SendMessageAction; sendMessageUploadVideoAction#92042ff7 = SendMessageAction; sendMessageRecordAudioAction#d52f73f7 = SendMessageAction; sendMessageUploadAudioAction#e6ac8a6f = SendMessageAction; sendMessageUploadPhotoAction#990a3c1a = SendMessageAction; sendMessageUploadDocumentAction#8faee98e = SendMessageAction; sendMessageGeoLocationAction#176f8ba1 = SendMessageAction; sendMessageChooseContactAction#628cbc6f = SendMessageAction; decryptedMessageActionResend#511110b0 start_seq_no:int end_seq_no:int = DecryptedMessageAction; decryptedMessageActionNotifyLayer#f3048883 layer:int = DecryptedMessageAction; decryptedMessageActionTyping#ccb27641 action:SendMessageAction = DecryptedMessageAction; ===20=== decryptedMessageActionRequestKey#f3c9611b exchange_id:long g_a:bytes = DecryptedMessageAction; decryptedMessageActionAcceptKey#6fe1735b exchange_id:long g_b:bytes key_fingerprint:long = DecryptedMessageAction; decryptedMessageActionAbortKey#dd05ec6b exchange_id:long = DecryptedMessageAction; decryptedMessageActionCommitKey#ec2e0b9b exchange_id:long key_fingerprint:long = DecryptedMessageAction; decryptedMessageActionNoop#a82fdd63 = DecryptedMessageAction; ===23=== documentAttributeImageSize#6c37c15c w:int h:int = DocumentAttribute; documentAttributeAnimated#11b58939 = DocumentAttribute; documentAttributeSticker#fb0a5727 = DocumentAttribute; documentAttributeVideo#5910cccb duration:int w:int h:int = DocumentAttribute; documentAttributeAudio#51448e5 duration:int = DocumentAttribute; documentAttributeFilename#15590068 file_name:string = DocumentAttribute; photoSizeEmpty#e17e23c type:string = PhotoSize; photoSize#77bfb61b type:string location:FileLocation w:int h:int size:int = PhotoSize; photoCachedSize#e9a734fa type:string location:FileLocation w:int h:int bytes:bytes = PhotoSize; fileLocationUnavailable#7c596b46 volume_id:long local_id:int secret:long = FileLocation; fileLocation#53d69076 dc_id:int volume_id:long local_id:int secret:long = FileLocation; decryptedMessageMediaExternalDocument#fa95b0dd id:long access_hash:long date:int mime_type:string size:int thumb:PhotoSize dc_id:int attributes:Vector = DecryptedMessageMedia; ===45=== decryptedMessage#36b091de flags:# random_id:long ttl:int message:string media:flags.9?DecryptedMessageMedia entities:flags.7?Vector via_bot_name:flags.11?string reply_to_random_id:flags.3?long = DecryptedMessage; decryptedMessageMediaPhoto#f1fa8d78 thumb:bytes thumb_w:int thumb_h:int w:int h:int size:int key:bytes iv:bytes caption:string = DecryptedMessageMedia; decryptedMessageMediaVideo#970c8c0e thumb:bytes thumb_w:int thumb_h:int duration:int mime_type:string w:int h:int size:int key:bytes iv:bytes caption:string = DecryptedMessageMedia; decryptedMessageMediaDocument#7afe8ae2 thumb:bytes thumb_w:int thumb_h:int mime_type:string size:int key:bytes iv:bytes attributes:Vector caption:string = DecryptedMessageMedia; documentAttributeSticker#3a556302 alt:string stickerset:InputStickerSet = DocumentAttribute; documentAttributeAudio#ded218e0 duration:int title:string performer:string = DocumentAttribute; messageEntityUnknown#bb92ba95 offset:int length:int = MessageEntity; messageEntityMention#fa04579d offset:int length:int = MessageEntity; messageEntityHashtag#6f635b0d offset:int length:int = MessageEntity; messageEntityBotCommand#6cef8ac7 offset:int length:int = MessageEntity; messageEntityUrl#6ed02538 offset:int length:int = MessageEntity; messageEntityEmail#64e475c2 offset:int length:int = MessageEntity; messageEntityBold#bd610bc9 offset:int length:int = MessageEntity; messageEntityItalic#826f8b60 offset:int length:int = MessageEntity; messageEntityCode#28a20571 offset:int length:int = MessageEntity; messageEntityPre#73924be0 offset:int length:int language:string = MessageEntity; messageEntityTextUrl#76a6d327 offset:int length:int url:string = MessageEntity; inputStickerSetShortName#861cc8a0 short_name:string = InputStickerSet; inputStickerSetEmpty#ffb62b95 = InputStickerSet; decryptedMessageMediaVenue#8a0df56f lat:double long:double title:string address:string provider:string venue_id:string = DecryptedMessageMedia; decryptedMessageMediaWebPage#e50511d8 url:string = DecryptedMessageMedia; ===46=== documentAttributeAudio#9852f9c6 flags:# voice:flags.10?true duration:int title:flags.0?string performer:flags.1?string waveform:flags.2?bytes = DocumentAttribute; ===66=== documentAttributeVideo#ef02ce6 flags:# round_message:flags.0?true duration:int w:int h:int = DocumentAttribute; sendMessageRecordRoundAction#88f27fbc = SendMessageAction; sendMessageUploadRoundAction#bb718624 = SendMessageAction; ===73=== decryptedMessage#91cc4674 flags:# no_webpage:flags.1?true silent:flags.5?true random_id:long ttl:int message:string media:flags.9?DecryptedMessageMedia entities:flags.7?Vector via_bot_name:flags.11?string reply_to_random_id:flags.3?long grouped_id:flags.17?long = DecryptedMessage; ===101=== messageEntityUnderline#9c4e7e8b offset:int length:int = MessageEntity; messageEntityStrike#bf0693d4 offset:int length:int = MessageEntity; messageEntityBlockquote#20df5d0 offset:int length:int = MessageEntity; ===143=== decryptedMessageMediaDocument#8e4c064c thumb:bytes thumb_w:int thumb_h:int mime_type:string size:long key:bytes iv:bytes attributes:Vector caption:string = DecryptedMessageMedia; ===144=== messageEntitySpoiler#32ca960f offset:int length:int = MessageEntity; messageEntityCustomEmoji#c8cf05f8 offset:int length:int document_id:long = MessageEntity; . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Promise; use danog\MadelineProto\Settings\TLSchema; use danog\MadelineProto\TL\TL; use danog\MadelineProto\TL\TLCallback; use phpDocumentor\Reflection\DocBlockFactory; use ReflectionNamedType; use ReflectionUnionType; class AnnotationsBuilder { /** * Reflection classes. */ private array $reflectionClasses = []; /** * Logger. */ private Logger $logger; /** * Namespace. */ private string $namespace; /** * TL instance. */ private TL $TL; /** * Settings. */ private array $settings; /** * Output file. */ private string $output; public function __construct(Logger $logger, array $settings, string $output, array $reflectionClasses, string $namespace) { $this->reflectionClasses = $reflectionClasses; $this->logger = $logger; $this->namespace = $namespace; /** @psalm-suppress InvalidArgument */ $this->TL = new TL(new class($logger) { public Logger $logger; public function __construct(Logger $logger) { $this->logger = $logger; } }); $tlSchema = new TLSchema; $tlSchema->mergeArray($settings); $this->TL->init($tlSchema); $this->settings = $settings; $this->output = $output; } public function mkAnnotations(): void { \danog\MadelineProto\Logger::log('Generating annotations...', \danog\MadelineProto\Logger::NOTICE); $this->setProperties(); $this->createInternalClasses(); } /** * Open file of class APIFactory * Insert properties * save the file with new content. * */ private function setProperties(): void { \danog\MadelineProto\Logger::log('Generating properties...', \danog\MadelineProto\Logger::NOTICE); $fixture = DocBlockFactory::createInstance(); $class = new \ReflectionClass($this->reflectionClasses['APIFactory']); $content = \file_get_contents($filename = $class->getFileName()); foreach ($class->getProperties() as $property) { if ($raw_docblock = $property->getDocComment()) { $docblock = $fixture->create($raw_docblock); if ($docblock->hasTag('internal')) { $content = \str_replace("\n ".$raw_docblock."\n public \$".$property->getName().';', '', $content); } } } foreach ($this->TL->getMethodNamespaces() as $namespace) { $content = \preg_replace('/(class( \\w+[,]?){0,}\\n{\\n)/', '${1}'." /**\n"." * @internal this is a internal property generated by build_docs.php, don't change manually\n"." *\n"." * @var {$namespace}\n"." */\n"." public \${$namespace};\n", $content); } \file_put_contents($filename, $content); } /** * Create internalDoc. * */ private function createInternalClasses(): void { \danog\MadelineProto\Logger::log('Creating internal classes...', \danog\MadelineProto\Logger::NOTICE); $handle = \fopen($this->output, 'w'); \fwrite($handle, "namespace}; class InternalDoc extends APIFactory {}"); $class = new \ReflectionClass($this->reflectionClasses['API']); $methods = $class->getMethods(\ReflectionMethod::IS_STATIC | \ReflectionMethod::IS_PUBLIC); $ignoreMethods = ['fetchserializableobject']; foreach ($methods as $method) { $ignoreMethods[$method->getName()] = $method->getName(); } $class = new \ReflectionClass(TLCallback::class); $methods = $class->getMethods(\ReflectionMethod::IS_STATIC | \ReflectionMethod::IS_PUBLIC); foreach ($methods as $method) { $ignoreMethods[$method->getName()] = $method->getName(); } \fclose($handle); $handle = \fopen($this->output, 'w'); $internalDoc = []; foreach ($this->TL->getMethods()->by_id as $id => $data) { if (!\strpos($data['method'], '.')) { continue; } list($namespace, $method) = \explode('.', $data['method']); if (!\in_array($namespace, $this->TL->getMethodNamespaces())) { continue; } $internalDoc[$namespace][$method]['title'] = \str_replace(['](../', '.md'], ['](https://docs.madelineproto.xyz/API_docs/', '.html'], Lang::$lang['en']["method_{$data['method']}"] ?? ''); $type = \str_ireplace(['vector<', '>'], [' of ', '[]'], $data['type']); foreach ($data['params'] as $param) { if (\in_array($param['name'], ['flags', 'flags2', 'random_id', 'random_bytes'])) { continue; } if ($param['name'] === 'data' && $type === 'messages.SentEncryptedMessage') { $param['name'] = 'message'; $param['type'] = 'DecryptedMessage'; } if ($param['name'] === 'chat_id' && $data['method'] !== 'messages.discardEncryption') { $param['type'] = 'InputPeer'; } if ($param['name'] === 'hash' && $param['type'] === 'int') { $param['pow'] = 'hi'; $param['type'] = 'Vector t'; $param['subtype'] = 'int'; } $stype = 'type'; if (isset($param['subtype'])) { $stype = 'subtype'; } $ptype = $param[$stype]; switch ($ptype) { case 'true': case 'false': $ptype = 'boolean'; } $ptype = $stype === 'type' ? $ptype : "[{$ptype}]"; $opt = $param['pow'] ?? false ? 'Optional: ' : ''; $internalDoc[$namespace][$method]['attr'][$param['name']] = ['type' => $ptype, 'description' => \str_replace(['](../', '.md'], ['](https://docs.madelineproto.xyz/API_docs/', '.html'], $opt.(Lang::$lang['en']["method_{$data['method']}_param_{$param['name']}_type_{$param['type']}"] ?? ''))]; } if ($type === 'Bool') { $type = \strtolower($type); } $internalDoc[$namespace][$method]['return'] = $type; } $class = new \ReflectionClass($this->reflectionClasses['MTProto']); $methods = $class->getMethods((\ReflectionMethod::IS_STATIC & \ReflectionMethod::IS_PUBLIC) | \ReflectionMethod::IS_PUBLIC); $class = new \ReflectionClass(Tools::class); $methods = \array_merge($methods, $class->getMethods((\ReflectionMethod::IS_STATIC & \ReflectionMethod::IS_PUBLIC) | \ReflectionMethod::IS_PUBLIC)); foreach ($methods as $key => $method) { $name = $method->getName(); if ($method == 'methodCallAsyncRead') { unset($methods[\array_search('methodCall', $methods)]); } elseif (\strpos($name, '__') === 0) { unset($methods[$key]); } elseif (\stripos($name, 'async') !== false) { if (\strpos($name, '_async') !== false) { unset($methods[\array_search(\str_ireplace('_async', '', $method), $methods)]); } else { unset($methods[\array_search(\str_ireplace('async', '', $method), $methods)]); } } } $sortedMethods = []; foreach ($methods as $method) { $sortedMethods[$method->getName()] = $method; } \ksort($sortedMethods); $methods = \array_values($sortedMethods); foreach ($methods as $method) { $name = $method->getName(); if (isset($ignoreMethods[$name])) { continue; } if (\strpos($method->getDocComment() ?? '', '@internal') !== false) { continue; } $static = $method->isStatic(); if (!$static) { $code = \file_get_contents($method->getFileName()); $code = \implode("\n", \array_slice(\explode("\n", $code), $method->getStartLine(), $method->getEndLine() - $method->getStartLine())); if (\strpos($code, '$this') === false) { Logger::log("{$name} should be STATIC!", Logger::FATAL_ERROR); } } if ($name == 'methodCallAsyncRead') { $name = 'methodCall'; } elseif (\stripos($name, 'async') !== false) { if (\strpos($name, '_async') !== false) { $name = \str_ireplace('_async', '', $name); } else { $name = \str_ireplace('async', '', $name); } } $name = StrTools::toCamelCase($name); $name = \str_ireplace(['mtproto', 'api'], ['MTProto', 'API'], $name); $doc = 'public '; if ($static) { $doc .= 'static '; } $doc .= 'function '; $doc .= $name; $doc .= '('; $paramList = ''; $hasVariadic = false; foreach ($method->getParameters() as $param) { if ($type = $param->getType()) { if ($type instanceof ReflectionNamedType) { if ($type->allowsNull()) { $doc .= '?'; } if (!$type->isBuiltin()) { $doc .= '\\'; } $doc .= $type->getName(); $doc .= ' '; } elseif ($type instanceof ReflectionUnionType) { foreach ($type->getTypes() as $t) { if (!$t->isBuiltin()) { $doc .= '\\'; } $doc .= $t->getName(); $doc .= '|'; } $doc[\strlen($doc)-1] = ' '; } } else { Logger::log($name.'.'.$param->getName()." has no type!", Logger::WARNING); } if ($param->isVariadic()) { $doc .= '...'; } if ($param->isPassedByReference()) { $doc .= '&'; } $doc .= '$'; $doc .= $param->getName(); if ($param->isOptional() && !$param->isVariadic()) { $doc .= ' = '; if ($param->isDefaultValueConstant()) { $doc .= '\\'.\str_replace(['NULL', 'self'], ['null', 'danog\\MadelineProto\\MTProto'], $param->getDefaultValueConstantName()); } else { $doc .= \str_replace('NULL', 'null', \var_export($param->getDefaultValue(), true)); } } $doc .= ', '; if ($param->isVariadic()) { $hasVariadic = true; $paramList .= '...'; } $paramList .= '$'.$param->getName().', '; } $type = $method->getReturnType(); $hasReturnValue = $type !== null; if ($type instanceof ReflectionNamedType && \in_array($type->getName(), [\Generator::class, Promise::class])) { $hasReturnValue = false; } if (!$hasVariadic && !$static && !$hasReturnValue) { $paramList .= '$extra, '; $doc .= 'array $extra = []'; } $doc = \rtrim($doc, ', '); $paramList = \rtrim($paramList, ', '); $doc .= ")"; $async = true; if ($hasReturnValue && $static) { $doc .= ': '; if ($type->allowsNull()) { $doc .= '?'; } if (!$type->isBuiltin()) { $doc .= '\\'; } $doc .= $type->getName() === 'self' ? $this->reflectionClasses['API'] : $type->getName(); $async = false; } if ($method->getDeclaringClass()->getName() == Tools::class) { $async = false; } if ($method->getDeclaringClass()->getName() == StrTools::class) { $async = false; } $finalParamList = $hasVariadic ? "Tools::arr({$paramList})" : "[{$paramList}]"; $ret = $type && $type instanceof ReflectionNamedType && \in_array($type->getName(), ['self', 'void']) ? '' : 'return'; $doc .= "\n{\n"; if ($async) { $doc .= " {$ret} \$this->__call(__FUNCTION__, {$finalParamList});\n"; } elseif (!$static) { $doc .= " {$ret} \$this->API->{$name}({$paramList});\n"; } else { $doc .= " {$ret} \\".$method->getDeclaringClass()->getName()."::".$name."({$paramList});\n"; } if (!$ret && $type->getName() === 'self') { $doc .= " return \$this;\n"; } $doc .= "}\n"; if (!$method->getDocComment()) { Logger::log("{$name} has no PHPDOC!", Logger::FATAL_ERROR); } if (!$type) { Logger::log("{$name} has no return type!", Logger::FATAL_ERROR); } $promise = '\\'.Promise::class; $phpdoc = $method->getDocComment() ?? ''; if (!\str_contains($phpdoc, '@return')) { if (!\trim($phpdoc)) { $phpdoc = '/** @return '.$type.' */'; } else { $phpdoc = \str_replace('*/', ' * @return '.$type."\n */", $phpdoc); } } $phpdoc = \str_replace("@return \\Generator", "@return $promise", $phpdoc); $phpdoc = \str_replace("@return \\Promise", "@return $promise", $phpdoc); $phpdoc = \str_replace("@return Generator", "@return $promise", $phpdoc); $phpdoc = \str_replace("@return Promise", "@return $promise", $phpdoc); if ($hasReturnValue && $async && \preg_match("/@return (.*)/", $phpdoc, $matches)) { $ret = $matches[1]; $new = $ret; if ($type && !\str_contains($ret, '<')) { $new = ''; if ($type instanceof ReflectionNamedType) { if ($type->allowsNull()) { $new .= '?'; } if (!$type->isBuiltin()) { $new .= '\\'; } $new .= $type->getName() === 'self' ? $this->reflectionClasses['API'] : $type; } elseif ($type instanceof ReflectionUnionType) { foreach ($type->getTypes() as $t) { if (!$t->isBuiltin()) { $new .= '\\'; } $new .= $t->getName() === 'self' ? $this->reflectionClasses['API'] : $t; $new .= '|'; } $new = \substr($new, 0, -1); } } $phpdoc = \str_replace("@return ".$ret, "@return mixed", $phpdoc); if (!\str_contains($phpdoc, '@psalm-return')) { $phpdoc = \str_replace("@return ", "@psalm-return $new|$promise<$new>\n * @return ", $phpdoc); } } $phpdoc = \preg_replace( "/@psalm-return \\\\Generator<(?:[^,]+), (?:[^,]+), (?:[^,]+), (.+)>/", "@psalm-return $promise<$1>", $phpdoc ); $internalDoc['InternalDoc'][$name]['method'] = $phpdoc; $internalDoc['InternalDoc'][$name]['method'] .= "\n ".\implode("\n ", \explode("\n", $doc)); } \fwrite($handle, "namespace};\n"); foreach ($internalDoc as $namespace => $methods) { if ($namespace === 'InternalDoc') { \fwrite($handle, "\nclass {$namespace} extends APIFactory\n{\n"); } else { \fwrite($handle, "\ninterface {$namespace}\n{"); } foreach ($methods as $method => $properties) { if (isset($properties['method'])) { \fwrite($handle, $properties['method']); continue; } $title = \implode("\n * ", \explode("\n", $properties['title'])); \fwrite($handle, "\n /**\n"); \fwrite($handle, " * {$title}\n"); \fwrite($handle, " *\n"); if (isset($properties['attr'])) { \fwrite($handle, " * Parameters: \n"); $longest = [0, 0, 0]; foreach ($properties['attr'] as $name => $param) { $longest[0] = \max($longest[0], \strlen($param['type'])); $longest[1] = \max($longest[1], \strlen($name)); $longest[2] = \max($longest[2], \strlen($param['description'])); } foreach ($properties['attr'] as $name => $param) { $param['type'] = \str_pad('`'.$param['type'].'`', $longest[0] + 2); $name = \str_pad('**'.$name.'**', $longest[1] + 4); $param['description'] = \str_pad($param['description'], $longest[2]); \fwrite($handle, " * * {$param['type']} {$name} - {$param['description']}\n"); } \fwrite($handle, " * \n"); \fwrite($handle, " * @param array \$params Parameters\n"); \fwrite($handle, " *\n"); } \fwrite($handle, " * @return {$properties['return']}\n"); \fwrite($handle, " */\n"); \fwrite($handle, " public function {$method}("); if (isset($properties['attr'])) { \fwrite($handle, '$params'); } \fwrite($handle, ");\n"); } \fwrite($handle, "}\n"); } \fclose($handle); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\DocsBuilder; use danog\MadelineProto\StrTools; use danog\MadelineProto\Tools; trait Methods { public function mkMethods(): void { static $bots; if (!$bots) { $bots = \json_decode(\file_get_contents('https://rpc.madelineproto.xyz/bot.json'), true)['result']; } static $errors; if (!$errors) { $errors = \json_decode(\file_get_contents('https://rpc.madelineproto.xyz/v4.json'), true); } $new = ['result' => []]; foreach ($errors['result'] as $code => $suberrors) { foreach ($suberrors as $method => $suberrors) { if (!isset($new[$method])) { $new[$method] = []; } foreach ($suberrors as $error) { $new['result'][$method][] = [$error, $code]; } } } foreach (\glob('methods/'.$this->any) as $unlink) { \unlink($unlink); } if (\file_exists('methods')) { \rmdir('methods'); } \mkdir('methods'); $this->docs_methods = []; $this->human_docs_methods = []; $this->logger->logger('Generating methods documentation...', \danog\MadelineProto\Logger::NOTICE); foreach ($this->TL->getMethods($this->td)->by_id as $id => $data) { $method = $data['method']; $phpMethod = StrTools::methodEscape($method); $type = \str_replace(['<', '>'], ['_of_', ''], $data['type']); $php_type = \preg_replace('/.*_of_/', '', $type); if (!isset($this->types[$php_type])) { $this->types[$php_type] = ['methods' => [], 'constructors' => []]; } if (!\in_array($data, $this->types[$php_type]['methods'])) { $this->types[$php_type]['methods'][] = $data; } $params = ''; foreach ($data['params'] as $param) { if (\in_array($param['name'], ['flags', 'flags2', 'random_id', 'random_bytes'])) { continue; } if ($param['name'] === 'data' && $type === 'messages_SentEncryptedMessage' && !isset($this->settings['td'])) { $param['name'] = 'message'; $param['type'] = 'DecryptedMessage'; } if ($param['name'] === 'chat_id' && $method !== 'messages.discardEncryption' && !isset($this->settings['td'])) { $param['type'] = 'InputPeer'; } $type_or_subtype = isset($param['subtype']) ? 'subtype' : 'type'; $type_or_bare_type = \ctype_upper(Tools::end(\explode('.', $param[$type_or_subtype]))[0]) || \in_array($param[$type_or_subtype], ['!X', 'X', 'bytes', 'true', 'false', 'double', 'string', 'Bool', 'int', 'long', 'int128', 'int256', 'int512', 'int53']) ? 'types' : 'constructors'; $param[$type_or_subtype] = \str_replace(['true', 'false'], ['Bool', 'Bool'], $param[$type_or_subtype]); $param[$type_or_subtype] = '['.StrTools::markdownEscape($param[$type_or_subtype]).'](/API_docs/'.$type_or_bare_type.'/'.$param[$type_or_subtype].'.md)'; $params .= $param['name'].": ".(isset($param['subtype']) ? '\\['.$param[$type_or_subtype].'\\]' : $param[$type_or_subtype]).', '; } if (!isset($this->tdDescriptions['methods'][$method])) { $this->addToLang('method_'.$method); if (\danog\MadelineProto\Lang::$lang['en']['method_'.$method] !== '') { $this->tdDescriptions['methods'][$method]['description'] = \danog\MadelineProto\Lang::$lang['en']['method_'.$method]; } } $md_method = '['.$phpMethod.'](/API_docs/methods/'.$method.'.md)'; $this->docs_methods[$method] = '$MadelineProto->'.$md_method.'(\\['.$params.'\\]) === [$'.StrTools::markdownEscape($type).'](/API_docs/types/'.$php_type.'.md) '; if (isset($this->tdDescriptions['methods'][$method])) { $desc = StrTools::toString(\trim(\explode("\n", $this->tdDescriptions['methods'][$method]['description'])[0], '.')); $this->human_docs_methods[$this->tdDescriptions['methods'][$method]['description'].': '.$method] = '* '.$desc.': '.$method.' '; } $params = ''; $lua_params = ''; $pwr_params = ''; $json_params = ''; $table = empty($data['params']) ? '' : '### Parameters: | Name | Type | Required | |----------|---------------|----------| '; if (isset($this->tdDescriptions['methods'][$method]) && !empty($data['params'])) { $table = '### Parameters: | Name | Type | Description | Required | |----------|---------------|-------------|----------| '; } $hasentities = false; $hasreplymarkup = false; $hasmessage = false; foreach ($data['params'] as $param) { if (\in_array($param['name'], ['flags', 'flags2', 'random_id', 'random_bytes'])) { continue; } if ($param['name'] === 'data' && $type === 'messages_SentEncryptedMessage' && !isset($this->settings['td'])) { $param['name'] = 'message'; $param['type'] = 'DecryptedMessage'; } if ($param['name'] === 'chat_id' && $method !== 'messages.discardEncryption' && !isset($this->settings['td'])) { $param['type'] = 'InputPeer'; } if (!isset($this->tdDescriptions['methods'][$method]['params'][$param['name']])) { if (isset($this->tdDescriptions['methods'][$method]['description'])) { $this->tdDescriptions['methods'][$method]['params'][$param['name']] = \danog\MadelineProto\Lang::$lang['en']['method_'.$method.'_param_'.$param['name'].'_type_'.$param['type']] ?? ''; } } if ($param['name'] === 'hash' && ($param['type'] === 'long' || $param['type'] === 'int')) { $param['pow'] = 'hi'; $param['type'] = 'Vector t'; $param['subtype'] = 'long'; } $ptype = $param[$type_or_subtype = isset($param['subtype']) ? 'subtype' : 'type']; switch ($ptype) { case 'true': case 'false': $ptype = 'Bool'; } $human_ptype = $ptype; if (\in_array($ptype, ['InputDialogPeer', 'DialogPeer', 'NotifyPeer', 'InputNotifyPeer', 'User', 'InputUser', 'Chat', 'InputChannel', 'Peer', 'InputPeer']) && !isset($this->settings['td'])) { $human_ptype = 'Username, chat ID, Update, Message or '.$ptype; } if (\in_array($ptype, ['InputMedia', 'InputPhoto', 'InputDocument']) && !isset($this->settings['td'])) { $human_ptype = 'MessageMedia, Update, Message or '.$ptype; } if (\in_array($ptype, ['InputMessage']) && !isset($this->settings['td'])) { $human_ptype = 'Message ID or '.$ptype; } if (\in_array($ptype, ['InputEncryptedChat']) && !isset($this->settings['td'])) { $human_ptype = 'Secret chat ID, Update, EncryptedMessage or '.$ptype; } if (\in_array($ptype, ['InputFile']) && !isset($this->settings['td'])) { $human_ptype = 'File path or '.$ptype; } if (\in_array($ptype, ['InputEncryptedFile']) && !isset($this->settings['td'])) { $human_ptype = 'File path or '.$ptype; } $type_or_bare_type = \ctype_upper(Tools::end(\explode('.', $param[$type_or_subtype]))[0]) || \in_array($param[$type_or_subtype], ['!X', 'X', 'bytes', 'true', 'false', 'double', 'string', 'Bool', 'int', 'long', 'int128', 'int256', 'int512', 'int53']) ? 'types' : 'constructors'; if (isset($this->tdDescriptions['methods'][$method])) { $table .= '|'.StrTools::markdownEscape($param['name']).'|'.(isset($param['subtype']) ? 'Array of ' : '').'['.StrTools::markdownEscape($human_ptype).'](/API_docs/'.$type_or_bare_type.'/'.$ptype.'.md) | '.$this->tdDescriptions['methods'][$method]['params'][$param['name']].' | '.(isset($param['pow']) || $param['type'] === 'int' || ($id = $this->TL->getConstructors($this->td)->findByPredicate(\lcfirst($param['type']).'Empty')) && $id['type'] === $param['type'] || ($id = $this->TL->getConstructors($this->td)->findByPredicate('input'.$param['type'].'Empty')) && $id['type'] === $param['type'] ? 'Optional' : 'Yes').'|'; } else { $table .= '|'.StrTools::markdownEscape($param['name']).'|'.(isset($param['subtype']) ? 'Array of ' : '').'['.StrTools::markdownEscape($human_ptype).'](/API_docs/'.$type_or_bare_type.'/'.$ptype.'.md) | '.(isset($param['pow']) || ($param['type'] === 'long' && $param['name'] === 'hash')|| ($id = $this->TL->getConstructors($this->td)->findByPredicate(\lcfirst($param['type']).'Empty')) && $id['type'] === $param['type'] || ($id = $this->TL->getConstructors($this->td)->findByPredicate('input'.$param['type'].'Empty')) && $id['type'] === $param['type'] ? 'Optional' : 'Yes').'|'; } $table .= PHP_EOL; $pptype = \in_array($ptype, ['string', 'bytes']) ? "'".$ptype."'" : $ptype; $ppptype = \in_array($ptype, ['string']) ? '"'.$ptype.'"' : $ptype; $ppptype = \in_array($ptype, ['bytes']) ? '{"_": "bytes", "bytes":"base64 encoded '.$ptype.'"}' : $ppptype; $params .= $param['name'].": "; $params .= (isset($param['subtype']) ? '['.$pptype.', '.$pptype.']' : $pptype).', '; $json_params .= '"'.$param['name'].'": '.(isset($param['subtype']) ? '['.$ppptype.']' : $ppptype).', '; $pwr_params .= $param['name'].' - Json encoded '.(isset($param['subtype']) ? ' array of '.$ptype : $ptype)."\n\n"; $lua_params .= $param['name'].'='; $lua_params .= (isset($param['subtype']) ? '{'.$pptype.'}' : $pptype).', '; if ($param['name'] === 'reply_markup') { $hasreplymarkup = true; } if ($param['name'] === 'message') { $hasmessage = true; } if ($param['name'] === 'entities') { $hasentities = true; $table .= '|parse\\_mode| [string](/API_docs/types/string.md) | Whether to parse HTML or Markdown markup in the message| Optional | '; $params .= "parse_mode: 'string', "; $lua_params .= "parseMode='string', "; $json_params .= '"parseMode": "string"'; $pwr_params = "parseMode - string\n"; } } $description = isset($this->tdDescriptions['methods'][$method]) ? $this->tdDescriptions['methods'][$method]['description'] : $method.' parameters, return type and example'; $symFile = \str_replace('.', '_', $method); $redir = $symFile !== $method ? "\nredirect_from: /API_docs/methods/{$symFile}.html" : ''; $description = \str_replace('"', "'", \rtrim(\explode("\n", $description)[0], ':')); $header = $this->template('Method', $method, $description, $redir, StrTools::markdownEscape($method)); if ($this->td) { $header .= "YOU CANNOT USE THIS METHOD IN MADELINEPROTO\n\n\n\n\n"; } if (\in_array($method, ['messages.getHistory', 'messages.getMessages', 'channels.getMessages'])) { $header .= "# Warning: flood wait\n**Warning: this method is prone to rate limiting with flood waits, please use the [updates event handler, instead »](/docs/UPDATES.html#async-event-driven)**\n\n"; $header .= "# Warning: non-realtime results\n**Warning: this method is not suitable for receiving messages in real-time from chats and users, please use the [updates event handler, instead »](/docs/UPDATES.html#async-event-driven)**\n\n"; $header .= "# Warning: this is probably NOT what you need\nYou probably need to use the [updates event handler, instead »](/docs/UPDATES.html#async-event-driven) :)\n\n"; } $header .= isset($this->tdDescriptions['methods'][$method]) ? $this->tdDescriptions['methods'][$method]['description'].PHP_EOL.PHP_EOL : ''; $table .= ' '; $return = '### Return type: ['.StrTools::markdownEscape($type).'](/API_docs/types/'.$php_type.'.md) '; $bot = !\in_array($method, $bots); $example = ''; if (!isset($this->settings['td'])) { $example .= '### Can bots use this method: **'.($bot ? 'YES' : 'NO')."**\n\n\n"; $example .= \str_replace('[]', '', $this->template('method-example', \str_replace('.', '_', $type), $phpMethod, $params, $method, $lua_params)); if ($hasreplymarkup) { $example .= $this->template('reply_markup'); } if ($hasmessage) { $example .= $this->template('chunks', StrTools::markdownEscape($type), $php_type); } if ($hasentities) { $example .= $this->template('parse_mode'); } if (isset($new['result'][$method])) { $example .= '### Errors | Code | Type | Description | |------|----------|---------------| '; foreach ($new['result'][$method] as $error) { [$error, $code] = $error; $example .= "|{$code}|{$error}|".$errors['human_result'][$error][0].'|'."\n"; } $example .= "\n\n"; } } \file_put_contents('methods/'.$method.'.md', $header.$table.$return.$example); } $this->logger->logger('Generating methods index...', \danog\MadelineProto\Logger::NOTICE); \ksort($this->docs_methods); \ksort($this->human_docs_methods); $last_namespace = ''; foreach ($this->docs_methods as $method => &$value) { $new_namespace = \preg_replace('/_.*/', '', $method); $br = $new_namespace != $last_namespace ? '***

' : ''; $value = $br.$value; $last_namespace = $new_namespace; } \file_put_contents('methods/api_'.$this->index, $this->template('methods-api-index', $this->index, \implode('', $this->docs_methods))); \file_put_contents('methods/'.$this->index, $this->template('methods-index', $this->index, \implode('', $this->human_docs_methods))); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\DocsBuilder; use danog\MadelineProto\StrTools; use danog\MadelineProto\Tools; trait Constructors { public function mkConstructors(): void { foreach (\glob('constructors/'.$this->any) as $unlink) { \unlink($unlink); } if (\file_exists('constructors')) { \rmdir('constructors'); } \mkdir('constructors'); $this->docs_constructors = []; $this->logger->logger('Generating constructors documentation...', \danog\MadelineProto\Logger::NOTICE); $got = []; foreach ($this->TL->getConstructors($this->td)->by_predicate_and_layer as $predicate => $id) { $data = $this->TL->getConstructors($this->td)->by_id[$id]; if (isset($got[$id])) { $data['layer'] = ''; } $got[$id] = ''; $layer = isset($data['layer']) && $data['layer'] !== '' ? '_'.$data['layer'] : ''; $type = $data['type']; $constructor = $data['predicate']; $php_type = Tools::typeEscape($type); $php_constructor = Tools::typeEscape($constructor); if (!isset($this->types[$php_type])) { $this->types[$php_type] = ['constructors' => [], 'methods' => []]; } if (!\in_array($data, $this->types[$php_type]['constructors'])) { $this->types[$php_type]['constructors'][] = $data; } $params = ''; foreach ($data['params'] as $param) { if (\in_array($param['name'], ['flags', 'flags2', 'random_id', 'random_bytes'])) { continue; } if ($type === 'EncryptedMessage' && $param['name'] === 'bytes' && !isset($this->settings['td'])) { $param['name'] = 'decrypted_message'; $param['type'] = 'DecryptedMessage'; } $type_or_subtype = isset($param['subtype']) ? 'subtype' : 'type'; $type_or_bare_type = \ctype_upper(Tools::end(\explode('.', $param[$type_or_subtype]))[0]) || \in_array($param[$type_or_subtype], ['!X', 'X', 'bytes', 'true', 'false', 'double', 'string', 'Bool', 'int53', 'int', 'long', 'int128', 'int256', 'int512']) ? 'types' : 'constructors'; $param[$type_or_subtype] = \str_replace(['true', 'false'], ['Bool', 'Bool'], $param[$type_or_subtype]); if (\preg_match('/%/', $param[$type_or_subtype])) { $param[$type_or_subtype] = $this->TL->getConstructors($this->td)->findByType(\str_replace('%', '', $param[$type_or_subtype]))['predicate']; } if (\substr($param[$type_or_subtype], -1) === '>') { $param[$type_or_subtype] = \substr($param[$type_or_subtype], 0, -1); } $params .= "'".$param['name']."' => "; $param[$type_or_subtype] = '['.Tools::markdownEscape($param[$type_or_subtype]).'](/API_docs/'.$type_or_bare_type.'/'.$param[$type_or_subtype].'.md)'; $params .= (isset($param['subtype']) ? '\\['.$param[$type_or_subtype].'\\]' : $param[$type_or_subtype]).', '; } $md_constructor = StrTools::markdownEscape($constructor.$layer); $this->docs_constructors[$constructor] = '[$'.$md_constructor.'](/API_docs/constructors/'.$php_constructor.$layer.'.md) = \\['.$params.'\\]; '; $table = empty($data['params']) ? '' : '### Attributes: | Name | Type | Required | |----------|---------------|----------| '; if (!isset($this->TL->getDescriptions()['constructors'][$constructor])) { $this->addToLang('object_'.$constructor); if (\danog\MadelineProto\Lang::$lang['en']['object_'.$constructor] !== '') { /** @psalm-suppress InvalidArrayAssignment */ $this->TL->getDescriptions()['constructors'][$constructor]['description'] = \danog\MadelineProto\Lang::$lang['en']['object_'.$constructor]; } } if (isset($this->TL->getDescriptions()['constructors'][$constructor]) && !empty($data['params'])) { $table = '### Attributes: | Name | Type | Required | Description | |----------|---------------|----------|-------------| '; } $params = ''; $lua_params = ''; $pwr_params = ''; $hasreplymarkup = false; $hasentities = false; foreach ($data['params'] as $param) { if (\in_array($param['name'], ['flags', 'flags2', 'random_id', 'random_bytes'])) { continue; } if ($type === 'EncryptedMessage' && $param['name'] === 'bytes' && !isset($this->settings['td'])) { $param['name'] = 'decrypted_message'; $param['type'] = 'DecryptedMessage'; } if ($type === 'DecryptedMessageMedia' && \in_array($param['name'], ['key', 'iv'])) { unset(\danog\MadelineProto\Lang::$lang['en']['object_'.$constructor.'_param_'.$param['name'].'_type_'.$param['type']]); continue; } $ptype = $param[isset($param['subtype']) ? 'subtype' : 'type']; if (\preg_match('/%/', $ptype)) { $ptype = $this->TL->getConstructors($this->td)->findByType(\str_replace('%', '', $ptype))['predicate']; } $type_or_bare_type = (\ctype_upper(Tools::end(\explode('_', $ptype))[0]) || \in_array($ptype, ['!X', 'X', 'bytes', 'true', 'false', 'double', 'string', 'Bool', 'int53', 'int', 'long', 'int128', 'int256', 'int512'])) && $ptype !== 'MTmessage' ? 'types' : 'constructors'; if (\substr($ptype, -1) === '>') { $ptype = \substr($ptype, 0, -1); } switch ($ptype) { case 'true': case 'false': $ptype = 'Bool'; } $human_ptype = $ptype; if (\strpos($type, 'Input') === 0 && \in_array($ptype, ['User', 'InputUser', 'Chat', 'InputChannel', 'Peer', 'InputDialogPeer', 'DialogPeer', 'NotifyPeer', 'InputNotifyPeer', 'InputPeer']) && !isset($this->settings['td'])) { $human_ptype = 'Username, chat ID, Update, Message or '.$ptype; } if (\strpos($type, 'Input') === 0 && \in_array($ptype, ['InputMedia', 'InputDocument', 'InputPhoto']) && !isset($this->settings['td'])) { $human_ptype = 'MessageMedia, Message, Update or '.$ptype; } if (\in_array($ptype, ['InputMessage']) && !isset($this->settings['td'])) { $human_ptype = 'Message ID or '.$ptype; } if (\in_array($ptype, ['InputEncryptedChat']) && !isset($this->settings['td'])) { $human_ptype = 'Secret chat ID, Update, EncryptedMessage or '.$ptype; } if (\in_array($ptype, ['InputFile']) && !isset($this->settings['td'])) { $human_ptype = 'File path or '.$ptype; } if (\in_array($ptype, ['InputEncryptedFile']) && !isset($this->settings['td'])) { $human_ptype = 'File path or '.$ptype; } $table .= '|'.StrTools::markdownEscape($param['name']).'|'.(isset($param['subtype']) ? 'Array of ' : '').'['.StrTools::markdownEscape($human_ptype).'](/API_docs/'.$type_or_bare_type.'/'.$ptype.'.md) | '.(isset($param['pow']) || $this->TL->getConstructors($this->td)->findByPredicate(\lcfirst($param['type']).'Empty') || $data['type'] === 'InputMedia' && $param['name'] === 'mime_type' || $data['type'] === 'DocumentAttribute' && \in_array($param['name'], ['w', 'h', 'duration']) ? 'Optional' : 'Yes').'|'; if (!isset($this->TL->getDescriptions()['constructors'][$constructor]['params'][$param['name']])) { $this->addToLang('object_'.$constructor.'_param_'.$param['name'].'_type_'.$param['type']); if (isset($this->TL->getDescriptions()['constructors'][$constructor]['description'])) { /** @psalm-suppress InvalidArrayAssignment */ $this->TL->getDescriptions()['constructors'][$constructor]['params'][$param['name']] = \danog\MadelineProto\Lang::$lang['en']['object_'.$constructor.'_param_'.$param['name'].'_type_'.$param['type']]; } } if (isset($this->TL->getDescriptions()['constructors'][$constructor]['params'][$param['name']]) && $this->TL->getDescriptions()['constructors'][$constructor]['params'][$param['name']]) { $table .= $this->TL->getDescriptions()['constructors'][$constructor]['params'][$param['name']].'|'; } $table .= PHP_EOL; $pptype = \in_array($ptype, ['string', 'bytes']) ? "'".$ptype."'" : $ptype; $ppptype = \in_array($ptype, ['string']) ? '"'.$ptype.'"' : $ptype; $ppptype = \in_array($ptype, ['bytes']) ? '{"_": "bytes", "bytes":"base64 encoded '.$ptype.'"}' : $ppptype; $params .= ", '".$param['name']."' => "; $params .= isset($param['subtype']) ? '['.$pptype.', '.$pptype.']' : $pptype; $lua_params .= ', '.$param['name'].'='; $lua_params .= isset($param['subtype']) ? '{'.$pptype.'}' : $pptype; $pwr_params .= ', "'.$param['name'].'": '.(isset($param['subtype']) ? '['.$ppptype.']' : $ppptype); if ($param['name'] === 'reply_markup') { $hasreplymarkup = true; } if ($param['name'] === 'entities' && $constructor === 'inputSingleMedia') { $hasentities = true; $table .= '|parse\\_mode| [string](/API_docs/types/string.md) | Whether to parse HTML or Markdown markup in the message| Optional | '; $params .= "parse_mode: 'string', "; $lua_params .= "parseMode='string', "; $pwr_params = "parseMode - string\n"; } } $params = "['_' => '".$constructor."'".$params.']'; $lua_params = "{_='".$constructor."'".$lua_params.'}'; $pwr_params = '{"_": "'.$constructor.'"'.$pwr_params.'}'; $description = isset($this->TL->getDescriptions()['constructors'][$constructor]) ? $this->TL->getDescriptions()['constructors'][$constructor]['description'] : $constructor.' attributes, type and example'; $symFile = \str_replace('.', '_', $constructor.$layer); $redir = $symFile !== $constructor.$layer ? "\nredirect_from: /API_docs/constructors/{$symFile}.html" : ''; $description = \str_replace('"', "'", Tools::toString(\rtrim(\explode("\n", $description)[0], ':'))); $header = '--- title: "'.$constructor.'" description: "'.$description.'" nav_exclude: true image: https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png'.$redir.' --- # Constructor: '.StrTools::markdownEscape($constructor.$layer).' [Back to constructors index](/API_docs/constructors/index.md) '; $table .= ' '; if (isset($this->TL->getDescriptions()['constructors'][$constructor])) { $header .= $this->TL->getDescriptions()['constructors'][$constructor]['description'].PHP_EOL.PHP_EOL; } $type = '### Type: ['.StrTools::markdownEscape($php_type).'](/API_docs/types/'.$php_type.'.md) '; $example = ''; if (!isset($this->settings['td'])) { if ($hasreplymarkup) { $example = $this->template('reply_markup'); } if ($hasentities) { $example = $this->template('parse_mode'); } $example .= $this->template('constructor-example', \str_replace('.', '_', $constructor.$layer), $params, $lua_params); } \file_put_contents('constructors/'.$constructor.$layer.'.md', $header.$table.$type.$example); } $this->logger->logger('Generating constructors index...', \danog\MadelineProto\Logger::NOTICE); \ksort($this->docs_constructors); $last_namespace = ''; foreach ($this->docs_constructors as $constructor => &$value) { $new_namespace = \preg_replace('/_.*/', '', $constructor); $br = $new_namespace != $last_namespace ? "***\n

" : ''; $value = $br.$value; $last_namespace = $new_namespace; } \file_put_contents('constructors/'.$this->index, $this->template('constructors-index', \implode('', $this->docs_constructors))); } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; use Amp\Promise; use Amp\Success; use danog\MadelineProto\Ipc\IpcState; use function Amp\File\exists; use function Amp\File\openFile; use function Amp\File\put; use function Amp\File\rename as renameAsync; use function Amp\File\stat; /** * Session path information. */ class SessionPaths { /** * Legacy session path. */ private string $legacySessionPath; /** * Session path. */ private string $sessionPath; /** * Session lock path. */ private string $lockPath; /** * IPC socket path. */ private string $ipcPath; /** * IPC callback socket path. */ private string $ipcCallbackPath; /** * IPC light state path. */ private string $ipcStatePath; /** * Light state path. */ private string $lightStatePath; /** * Light state. */ private ?LightState $lightState = null; /** * Construct session info from session name. * * @param string $session Session name */ public function __construct(string $session) { $session = Tools::absolute($session); $this->legacySessionPath = $session; $this->sessionPath = "$session.safe.php"; $this->lightStatePath = "$session.lightState.php"; $this->lockPath = "$session.lock"; $this->ipcPath = "$session.ipc"; $this->ipcCallbackPath = "$session.callback.ipc"; $this->ipcStatePath = "$session.ipcState.php"; } /** * Serialize object to file. * */ public function serialize(object $object, string $path): \Generator { Logger::log("Waiting for exclusive lock of $path.lock..."); $unlock = yield from Tools::flockGenerator("$path.lock", LOCK_EX, 0.1); try { Logger::log("Got exclusive lock of $path.lock..."); $object = Serialization::PHP_HEADER .\chr(Serialization::VERSION) .\chr(PHP_MAJOR_VERSION) .\chr(PHP_MINOR_VERSION) .\serialize($object); yield put( "$path.temp.php", $object ); yield renameAsync("$path.temp.php", $path); } finally { $unlock(); } } /** * Deserialize new object. * * @param string $path Object path, defaults to session path * * * @psalm-return \Generator */ public function unserialize(string $path = ''): \Generator { $path = $path ?: $this->sessionPath; if (!yield exists($path)) { return null; } $headerLen = \strlen(Serialization::PHP_HEADER); Logger::log("Waiting for shared lock of $path.lock...", Logger::ULTRA_VERBOSE); $unlock = yield from Tools::flockGenerator("$path.lock", LOCK_SH, 0.1); try { Logger::log("Got shared lock of $path.lock...", Logger::ULTRA_VERBOSE); $file = yield openFile($path, 'rb'); $size = yield stat($path); $size = $size['size'] ?? $headerLen; yield $file->seek($headerLen++); $v = \ord(yield $file->read(1)); if ($v === Serialization::VERSION) { $php = yield $file->read(2); $major = \ord($php[0]); $minor = \ord($php[1]); if (\version_compare("$major.$minor", PHP_VERSION) > 0) { throw new Exception("Cannot deserialize session created on newer PHP $major.$minor, currently using PHP ".PHP_MAJOR_VERSION.'.'.PHP_MINOR_VERSION.', please upgrade to the latest version of PHP!'); } $headerLen += 2; } $unserialized = \unserialize((yield $file->read($size - $headerLen)) ?? ''); yield $file->close(); } finally { $unlock(); } return $unserialized; } /** * Get session path. * */ public function __toString(): string { return $this->legacySessionPath; } /** * Get legacy session path. * */ public function getLegacySessionPath(): string { return $this->legacySessionPath; } /** * Get session path. * */ public function getSessionPath(): string { return $this->sessionPath; } /** * Get lock path. * */ public function getLockPath(): string { return $this->lockPath; } /** * Get IPC socket path. * */ public function getIpcPath(): string { return $this->ipcPath; } /** * Get IPC light state path. * */ public function getIpcStatePath(): string { return $this->ipcStatePath; } /** * Get IPC state. * * @psalm-suppress InvalidReturnType * @return Promise */ public function getIpcState(): Promise { return Tools::call($this->unserialize($this->ipcStatePath)); } /** * Store IPC state. * */ public function storeIpcState(IpcState $state): \Generator { return $this->serialize($state, $this->getIpcStatePath()); } /** * Get light state path. * */ public function getLightStatePath(): string { return $this->lightStatePath; } /** * Get light state. * * @psalm-suppress InvalidReturnType * @return Promise */ public function getLightState(): Promise { if ($this->lightState) { return new Success($this->lightState); } $promise = Tools::call($this->unserialize($this->lightStatePath)); $promise->onResolve(function (?\Throwable $e, ?LightState $res): void { if ($res) { $this->lightState = $res; } }); return $promise; } /** * Store light state. * */ public function storeLightState(MTProto $state): \Generator { $this->lightState = new LightState($state); return $this->serialize($this->lightState, $this->getLightStatePath()); } /** * Get IPC callback socket path. * */ public function getIpcCallbackPath(): string { return $this->ipcCallbackPath; } } . * * @author Daniil Gentili * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto; /** * Snitch. */ class Snitch { /** * Maximum starts without a phar file. */ const MAX_NO_PHAR_STARTS = 3; /** * Whether madeline.phar was downloaded from scratch. */ private array $hadInstalled = []; /** * Called before serialization. * * @return array */ public function __sleep() { return ['hadInstalled']; } /** * Wakeup function. */ public function __wakeup(): void { if (\defined('HAD_MADELINE_PHAR')) { $this->hadInstalled []= \HAD_MADELINE_PHAR; if (\count($this->hadInstalled) > self::MAX_NO_PHAR_STARTS) { \array_shift($this->hadInstalled); if (!\array_sum($this->hadInstalled)) { // For three times, MadelineProto was started with no phar file $this->die(); } } } } /** * Die. * */ private function die(): void { Shutdown::removeCallback('restarter'); $message = "Please do not remove madeline.phar or madeline.php, or else MadelineProto will crash. If you have any problem with MadelineProto, report it to https://github.com/danog/MadelineProto or https://t.me/pwrtelegramgroup"; Logger::log($message, Logger::FATAL_ERROR); \file_put_contents(Magic::$cwd.DIRECTORY_SEPARATOR.'DO_NOT_REMOVE_MADELINEPROTO_LOG_SESSION', $message); die("$message\n"); } } resPQ#05162463 nonce:int128 server_nonce:int128 pq:string server_public_key_fingerprints:Vector = ResPQ; vector {t:Type} # [ t ] = Vector t; p_q_inner_data_dc#a9f55f95 pq:string p:string q:string nonce:int128 server_nonce:int128 new_nonce:int256 dc:int = P_Q_inner_data; p_q_inner_data_temp_dc#56fddf88 pq:string p:string q:string nonce:int128 server_nonce:int128 new_nonce:int256 dc:int expires_in:int = P_Q_inner_data; p_q_inner_data pq:string p:string q:string nonce:int128 server_nonce:int128 new_nonce:int256 = P_Q_inner_data; p_q_inner_data_temp pq:string p:string q:string nonce:int128 server_nonce:int128 new_nonce:int256 expires_in:int = P_Q_inner_data; server_DH_params_fail#79cb045d nonce:int128 server_nonce:int128 new_nonce_hash:int128 = Server_DH_Params; server_DH_params_ok#d0e8075c nonce:int128 server_nonce:int128 encrypted_answer:string = Server_DH_Params; server_DH_inner_data#b5890dba nonce:int128 server_nonce:int128 g:int dh_prime:string g_a:string server_time:int = Server_DH_inner_data; client_DH_inner_data#6643b654 nonce:int128 server_nonce:int128 retry_id:long g_b:string = Client_DH_Inner_Data; dh_gen_ok#3bcbf734 nonce:int128 server_nonce:int128 new_nonce_hash1:int128 = Set_client_DH_params_answer; dh_gen_retry#46dc1fb9 nonce:int128 server_nonce:int128 new_nonce_hash2:int128 = Set_client_DH_params_answer; dh_gen_fail#a69dae02 nonce:int128 server_nonce:int128 new_nonce_hash3:int128 = Set_client_DH_params_answer; bind_auth_key_inner#75a3f765 nonce:long temp_auth_key_id:long perm_auth_key_id:long temp_session_id:long expires_at:int = BindAuthKeyInner; rpc_result#f35c6d01 req_msg_id:long result:Object = RpcResult; rpc_error#2144ca19 error_code:int error_message:string = RpcError; rpc_answer_unknown#5e2ad36e = RpcDropAnswer; rpc_answer_dropped_running#cd78e586 = RpcDropAnswer; rpc_answer_dropped#a43ad8b7 msg_id:long seq_no:int bytes:int = RpcDropAnswer; future_salt#0949d9dc valid_since:int valid_until:int salt:long = FutureSalt; future_salts#ae500895 req_msg_id:long now:int salts:vector = FutureSalts; pong#347773c5 msg_id:long ping_id:long = Pong; destroy_session_ok#e22045fc session_id:long = DestroySessionRes; destroy_session_none#62d350c9 session_id:long = DestroySessionRes; new_session_created#9ec20908 first_msg_id:long unique_id:long server_salt:long = NewSession; msg_container#73f1f8dc messages:vector<%Message> = MessageContainer; message msg_id:long seqno:int bytes:int body:Object = Message; msg_copy#e06046b2 orig_message:Message = MessageCopy; gzip_packed#3072cfa1 packed_data:bytes = Object; msgs_ack#62d6b459 msg_ids:Vector = MsgsAck; bad_msg_notification#a7eff811 bad_msg_id:long bad_msg_seqno:int error_code:int = BadMsgNotification; bad_server_salt#edab447b bad_msg_id:long bad_msg_seqno:int error_code:int new_server_salt:long = BadMsgNotification; msg_resend_ans_req#8610baeb msg_ids:Vector = MsgResendReq; msg_resend_req#7d861a08 msg_ids:Vector = MsgResendReq; msgs_state_req#da69fb52 msg_ids:Vector = MsgsStateReq; msgs_state_info#04deb57d req_msg_id:long info:string = MsgsStateInfo; msgs_all_info#8cc0d131 msg_ids:Vector info:string = MsgsAllInfo; msg_detailed_info#276d3ec6 msg_id:long answer_msg_id:long bytes:int status:int = MsgDetailedInfo; msg_new_detailed_info#809db6df answer_msg_id:long bytes:int status:int = MsgDetailedInfo; rsa_public_key n:string e:string = RSAPublicKey; http_wait#9299359f max_delay:int wait_after:int max_wait:int = HttpWait; ---functions--- req_pq_multi#be7e8ef1 nonce:int128 = ResPQ; req_pq nonce:int128 = ResPQ; req_DH_params#d712e4be nonce:int128 server_nonce:int128 p:string q:string public_key_fingerprint:long encrypted_data:string = Server_DH_Params; set_client_DH_params#f5045f1f nonce:int128 server_nonce:int128 encrypted_data:string = Set_client_DH_params_answer; rpc_drop_answer#58e4a740 req_msg_id:long = RpcDropAnswer; get_future_salts#b921bd04 num:int = FutureSalts; ping#7abe77ec ping_id:long = Pong; ping_delay_disconnect#f3427b8c ping_id:long disconnect_delay:int = Pong; destroy_session#e7512126 session_id:long = DestroySessionRes; //test.useGzipPacked = GzipPacked; //test.useServerDhInnerData = Server_DH_inner_data; //test.useNewSessionCreated = NewSession; //test.useMsgsAck = MsgsAck; //test.useBadMsgNotification = BadMsgNotification; //test.useOther key:rsa_public_key p_q_data:P_Q_inner_data dh_data:client_DH_inner_data = RpcError; getFinder() ->in(__DIR__ . '/src') ->in(__DIR__ . '/tests'); $cacheDir = getenv('TRAVIS') ? getenv('HOME') . '/.php-cs-fixer' : __DIR__; $config->setCacheFile($cacheDir . '/.php_cs.cache'); return $config; { "name": "danog/tg-file-decoder", "description": "Decode Telegram bot API file IDs", "type": "project", "license": "AGPL-3.0-only", "keywords": ["telegram", "mtproto", "bot API", "file ID", "video", "stickers", "audio", "files"], "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "require": { "php": ">=8.1" }, "require-dev": { "phpunit/phpunit": "^9", "amphp/php-cs-fixer-config": "dev-master" }, "autoload": { "psr-4": { "danog\\Decoder\\": "src/" }, "files": [ "src/type.php" ] }, "autoload-dev": { "psr-4": { "danog\\Decoder\\Test\\": "tests" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff --dry-run", "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text --configuration phpunit.xml.dist" }, "config": { "allow-plugins": { "phabel/phabel": true } } } . * * @author Daniil Gentili * @copyright 2016-2019 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://github.com/tg-file-decoder Documentation */ namespace danog\Decoder\PhotoSizeSource; use danog\Decoder\PhotoSizeSource; use const danog\Decoder\TYPES; /** * Represents source of photosize. */ class PhotoSizeSourceThumbnail extends PhotoSizeSource { /** * File type of original file. * * @var int */ private $_thumbFileType; /** * Thumbnail size. * * @var string */ private $_thumbType; /** * Get file type of original file. * * @return int */ public function getThumbFileType(): int { return $this->_thumbFileType; } /** * Get file type of original file as string. * * @return string */ public function getThumbFileTypeString(): string { return TYPES[$this->_thumbFileType]; } /** * Set file type of original file. * * @param int $_thumbFileType File type of original file * * @return self */ public function setThumbFileType(int $_thumbFileType): self { $this->_thumbFileType = $_thumbFileType; return $this; } /** * Get thumbnail size. * * @return string */ public function getThumbType(): string { return $this->_thumbType; } /** * Set thumbnail size. * * @param string $_thumbType Thumbnail size * * @return self */ public function setThumbType(string $_thumbType): self { $this->_thumbType = $_thumbType; return $this; } } . * * @author Daniil Gentili * @copyright 2016-2019 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://github.com/tg-file-decoder Documentation */ namespace danog\Decoder\PhotoSizeSource; use danog\Decoder\PhotoSizeSource; /** * Represents source of photosize. * * @extends PhotoSizeSource */ class PhotoSizeSourceLegacy extends PhotoSizeSource { /** * Secret legacy ID. * * @var int */ private $_secret; /** * Get secret legacy ID. * * @return int */ public function getSecret() { return $this->_secret; } /** * Set secret legacy ID. * * @param int $_secret Secret legacy ID * * @return self */ public function setSecret($_secret): self { $this->_secret = $_secret; return $this; } } . * * @author Daniil Gentili * @copyright 2016-2019 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://github.com/tg-file-decoder Documentation */ namespace danog\Decoder\PhotoSizeSource; use danog\Decoder\PhotoSizeSource; use const danog\Decoder\PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL; use const danog\Decoder\PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL_LEGACY; /** * Represents source of photosize. * * @extends PhotoSizeSource */ class PhotoSizeSourceDialogPhoto extends PhotoSizeSource { /** * ID of dialog. * * @var int */ private $_dialogId; /** * Access hash of dialog. * * @var int */ private $_dialogAccessHash; /** * Get dialog ID. * * @return int */ public function getDialogId() { return $this->_dialogId; } /** * Set dialog ID. * * @param int $id Dialog ID * * @return self */ public function setDialogId($id): self { $this->_dialogId = $id; return $this; } /** * Get access hash of dialog. * * @return int */ public function getDialogAccessHash() { return $this->_dialogAccessHash; } /** * Set access hash of dialog. * * @param int $dialogAccessHash Access hash of dialog * * @return self */ public function setDialogAccessHash($dialogAccessHash): self { $this->_dialogAccessHash = $dialogAccessHash; return $this; } /** * Get whether the big or small version of the photo is being used. * * @return bool */ public function isSmallDialogPhoto(): bool { return \in_array($this->getType(), [PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL_LEGACY, PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL]); } } . * * @author Daniil Gentili * @copyright 2016-2019 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://github.com/tg-file-decoder Documentation */ namespace danog\Decoder\PhotoSizeSource; use danog\Decoder\PhotoSizeSource; /** * Represents source of photosize. * * @extends PhotoSizeSource */ class PhotoSizeSourceStickersetThumbnail extends PhotoSizeSource { /** * Stickerset ID. * * @var int */ private $_stickerSetId; /** * Stickerset access hash. * * @var int */ private $_stickerSetAccessHash; /** * Get stickerset ID. * * @return int */ public function getStickerSetId() { return $this->_stickerSetId; } /** * Set stickerset ID. * * @param int $_stickerSetId Stickerset ID * * @return self */ public function setStickerSetId($_stickerSetId): self { $this->_stickerSetId = $_stickerSetId; return $this; } /** * Get stickerset access hash. * * @return int */ public function getStickerSetAccessHash() { return $this->_stickerSetAccessHash; } /** * Set stickerset access hash. * * @param int $_stickerSetAccessHash Stickerset access hash * * @return self */ public function setStickerSetAccessHash($_stickerSetAccessHash): self { $this->_stickerSetAccessHash = $_stickerSetAccessHash; return $this; } } . * * @author Daniil Gentili * @copyright 2016-2019 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://github.com/tg-file-decoder Documentation */ namespace danog\Decoder\PhotoSizeSource; use danog\Decoder\PhotoSizeSource; /** * Represents source of photosize. * * @extends PhotoSizeSource */ class PhotoSizeSourceStickersetThumbnailVersion extends PhotoSizeSource { /** * Stickerset ID. * * @var int */ private $_stickerSetId; /** * Stickerset access hash. * * @var int */ private $_stickerSetAccessHash; /** * Stickerset version. * * @var int */ private $_stickerSetVersion; /** * Get stickerset ID. * * @return int */ public function getStickerSetId() { return $this->_stickerSetId; } /** * Set stickerset ID. * * @param int $_stickerSetId Stickerset ID * * @return self */ public function setStickerSetId($_stickerSetId): self { $this->_stickerSetId = $_stickerSetId; return $this; } /** * Get stickerset access hash. * * @return int */ public function getStickerSetAccessHash() { return $this->_stickerSetAccessHash; } /** * Set stickerset access hash. * * @param int $_stickerSetAccessHash Stickerset access hash * * @return self */ public function setStickerSetAccessHash($_stickerSetAccessHash): self { $this->_stickerSetAccessHash = $_stickerSetAccessHash; return $this; } /** * Get stickerset version. * * @return int */ public function getStickerSetVersion(): int { return $this->_stickerSetVersion; } /** * Set stickerset version. * * @param int $_stickerSetVersion Stickerset version. * * @return self */ public function setStickerSetVersion(int $_stickerSetVersion): self { $this->_stickerSetVersion = $_stickerSetVersion; return $this; } } . * * @author Daniil Gentili * @copyright 2016-2019 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://github.com/tg-file-decoder Documentation */ namespace danog\Decoder; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceLegacy; /** * Represents source of photosize. * * @template T */ abstract class PhotoSizeSource { /** * Source type. * * @var int */ private $_type; /** * Set photosize source type. * * @param integer $type Type */ public function __construct(int $type) { $this->_type = $type; return $this; } /** * Get photosize source type. * * @return integer * * @psalm-return ( * T is PhotoSizeSourceLegacy ? * ? \danog\Decoder\PHOTOSIZE_SOURCE_LEGACY * : (T is PhotoSizeSourceDialogPhoto * ? \danog\Decoder\PHOTOSIZE_SOURCE_DIALOGPHOTO_* * (T is PhotoSizeSourceStickersetThumbnail * ? \danog\Decoder\PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL * : \danog\Decoder\PHOTOSIZE_SOURCE_THUMBNAIL * ) * ) * * @internal Internal use */ public function getType(): int { return $this->_type; } } . * * @author Daniil Gentili * @copyright 2016-2019 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://github.com/tg-file-decoder Documentation */ namespace danog\Decoder; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceDialogPhoto; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceLegacy; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceStickersetThumbnail; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceStickersetThumbnailVersion; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceThumbnail; /** * Represents decoded bot API file ID. */ class FileId { /** * Bot API file ID version. * * @var int */ private $_version = 4; /** * Bot API file ID subversion. * * @var int */ private $_subVersion = 41; /** * DC ID. * * @var int */ private $_dcId = 0; /** * File type. * * @var int */ private $_type = 0; /** * File reference. * * @var string */ private $_fileReference = ''; /** * File URL for weblocation. * * @var string */ private $_url = ''; /** * File id. * * @var int */ private $_id; /** * File access hash. * * @var int */ private $_accessHash; /** * Photo volume ID. * * @var int */ private $_volumeId; /** * Photo local ID. * * @var int */ private $_localId; /** * Photo size source. * * @var PhotoSizeSource */ private $_photoSizeSource; /** * Basic constructor function. */ public function __construct() { } /** * Decode file ID from bot API file ID. * * @param string $fileId File ID * * @return self */ public static function fromBotAPI(string $fileId): self { $result = new self; $resultArray = internalDecode($fileId); $result->setVersion($resultArray['version']); $result->setSubVersion($resultArray['subVersion']); $result->setType($resultArray['typeId']); $result->setDcId($resultArray['dc_id']); $result->setAccessHash($resultArray['access_hash']); if ($resultArray['hasReference']) { $result->setFileReference($resultArray['fileReference']); } if ($resultArray['hasWebLocation']) { $result->setUrl($resultArray['url']); return $result; } $result->setId($resultArray['id']); if ($result->getType() <= PHOTO) { if (isset($resultArray['volume_id'])) { $result->setVolumeId($resultArray['volume_id']); } if (isset($resultArray['local_id'])) { $result->setLocalId($resultArray['local_id']); } switch ($resultArray['photosize_source']) { case PHOTOSIZE_SOURCE_LEGACY: case PHOTOSIZE_SOURCE_FULL_LEGACY: $photoSizeSource = new PhotoSizeSourceLegacy($resultArray['photosize_source']); $photoSizeSource->setSecret($resultArray['secret']); break; case PHOTOSIZE_SOURCE_THUMBNAIL: $photoSizeSource = new PhotoSizeSourceThumbnail($resultArray['photosize_source']); $photoSizeSource->setThumbType($resultArray['thumbnail_type']); $photoSizeSource->setThumbFileType($resultArray['file_type']); break; case PHOTOSIZE_SOURCE_DIALOGPHOTO_BIG_LEGACY: case PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL_LEGACY: case PHOTOSIZE_SOURCE_DIALOGPHOTO_BIG: case PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL: $photoSizeSource = new PhotoSizeSourceDialogPhoto($resultArray['photosize_source']); $photoSizeSource->setDialogId($resultArray['dialog_id']); $photoSizeSource->setDialogAccessHash($resultArray['dialog_access_hash']); break; case PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL: case PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL_LEGACY: $photoSizeSource = new PhotoSizeSourceStickersetThumbnail($resultArray['photosize_source']); $photoSizeSource->setStickerSetId($resultArray['sticker_set_id']); $photoSizeSource->setStickerSetAccessHash($resultArray['sticker_set_access_hash']); break; case PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL_VERSION: $photoSizeSource = new PhotoSizeSourceStickersetThumbnailVersion($resultArray['photosize_source']); $photoSizeSource->setStickerSetId($resultArray['sticker_set_id']); $photoSizeSource->setStickerSetAccessHash($resultArray['sticker_set_access_hash']); $photoSizeSource->setStickerSetVersion($resultArray['sticker_version']); break; } $result->setPhotoSizeSource($photoSizeSource); } return $result; } /** * Get bot API file ID. * * @return string */ public function getBotAPI(): string { $type = $this->getType(); if ($this->hasFileReference()) { $type |= FILE_REFERENCE_FLAG; } if ($this->hasUrl()) { $type |= WEB_LOCATION_FLAG; } $fileId = \pack('VV', $type, $this->getDcId()); if ($this->hasFileReference()) { $fileId .= packTLString($this->getFileReference()); } if ($this->hasUrl()) { $fileId .= packTLString($this->getUrl()); $fileId .= packLong($this->getAccessHash()); return base64urlEncode(rleEncode($fileId)); } $fileId .= packLong($this->getId()); $fileId .= packLong($this->getAccessHash()); if ($this->getType() <= PHOTO) { $photoSize = $this->getPhotoSizeSource(); $fileId .= \pack('V', $photoSize->getType()); switch ($photoSize->getType()) { case PHOTOSIZE_SOURCE_LEGACY: $fileId .= packLong($photoSize->getSecret()); break; case PHOTOSIZE_SOURCE_FULL_LEGACY: $fileId .= packLong($this->getVolumeId()); $fileId .= packLong($photoSize->getSecret()); $fileId .= \pack('l', $this->getLocalId()); break; case PHOTOSIZE_SOURCE_THUMBNAIL: $fileId .= \pack('Va4', $photoSize->getThumbFileType(), $photoSize->getThumbType()); break; case PHOTOSIZE_SOURCE_DIALOGPHOTO_BIG: case PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL: case PHOTOSIZE_SOURCE_DIALOGPHOTO_BIG_LEGACY: case PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL_LEGACY: $fileId .= packLongBig($photoSize->getDialogId()); $fileId .= packLong($photoSize->getDialogAccessHash()); break; case PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL: case PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL_LEGACY: $fileId .= packLong($photoSize->getStickerSetId()); $fileId .= packLong($photoSize->getStickerSetAccessHash()); break; case PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL_VERSION: $fileId .= packLong($photoSize->getStickerSetId()); $fileId .= packLong($photoSize->getStickerSetAccessHash()); $fileId .= \pack('l', $photoSize->getStickerSetVersion()); break; } if ($photoSize->getType() >= PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL_LEGACY && $photoSize->getType() <= PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL_LEGACY) { $fileId .= packLong($this->getVolumeId()); $fileId .= \pack('l', $this->getLocalId()); } } if ($this->getVersion() >= 4) { $fileId .= \chr($this->getSubVersion()); } $fileId .= \chr($this->getVersion()); return base64urlEncode(rleEncode($fileId)); } /** * Get unique file ID from file ID. * * @return UniqueFileId */ public function getUnique(): UniqueFileId { return UniqueFileId::fromFileId($this); } /** * Get unique bot API file ID from file ID. * * @return string */ public function getUniqueBotAPI(): string { return UniqueFileId::fromFileId($this)->getUniqueBotAPI(); } /** * Get bot API file ID. * * @return string */ public function __toString(): string { return $this->getBotAPI(); } /** * Get bot API file ID version. * * @return int */ public function getVersion(): int { return $this->_version; } /** * Set bot API file ID version. * * @param int $_version Bot API file ID version. * * @return self */ public function setVersion(int $_version): self { $this->_version = $_version; return $this; } /** * Get bot API file ID subversion. * * @return int */ public function getSubVersion(): int { return $this->_subVersion; } /** * Set bot API file ID subversion. * * @param int $_subVersion Bot API file ID subversion. * * @return self */ public function setSubVersion(int $_subVersion): self { $this->_subVersion = $_subVersion; return $this; } /** * Get file type. * * @return int */ public function getType(): int { return $this->_type; } /** * Get file type as string. * * @return string */ public function getTypeName(): string { return TYPES[$this->_type]; } /** * Set file type. * * @param int $_type File type. * * @return self */ public function setType(int $_type): self { $this->_type = $_type; return $this; } /** * Get file reference. * * @return string */ public function getFileReference(): string { return $this->_fileReference; } /** * Set file reference. * * @param string $_fileReference File reference. * * @return self */ public function setFileReference(string $_fileReference): self { $this->_fileReference = $_fileReference; return $this; } /** * Check if has file reference. * * @return boolean */ public function hasFileReference(): bool { return !empty($this->_fileReference); } /** * Get file URL for weblocation. * * @return string */ public function getUrl(): string { return $this->_url; } /** * Check if has file URL. * * @return boolean */ public function hasUrl(): bool { return !empty($this->_url); } /** * Set file URL for weblocation. * * @param string $_url File URL for weblocation. * * @return self */ public function setUrl(string $_url): self { $this->_url = $_url; return $this; } /** * Get file id. * * @return int */ public function getId() { return $this->_id; } /** * Set file id. * * @param int $_id File id. * * @return self */ public function setId($_id): self { $this->_id = $_id; return $this; } /** * Check if has file id. * * @return bool */ public function hasId(): bool { return isset($this->_id); } /** * Get file access hash. * * @return int */ public function getAccessHash() { return $this->_accessHash; } /** * Set file access hash. * * @param int $_accessHash File access hash. * * @return self */ public function setAccessHash($_accessHash): self { $this->_accessHash = $_accessHash; return $this; } /** * Get photo volume ID. * * @return int */ public function getVolumeId() { return $this->_volumeId; } /** * Set photo volume ID. * * @param int $_volumeId Photo volume ID. * * @return self */ public function setVolumeId($_volumeId): self { $this->_volumeId = $_volumeId; return $this; } /** * Check if has volume ID. * * @return boolean */ public function hasVolumeId(): bool { return isset($this->_volumeId); } /** * Get photo local ID. * * @return int */ public function getLocalId(): int { return $this->_localId; } /** * Set photo local ID. * * @param int $_localId Photo local ID. * * @return self */ public function setLocalId(int $_localId): self { $this->_localId = $_localId; return $this; } /** * Check if has local ID. * * @return boolean */ public function hasLocalId(): bool { return isset($this->_localId); } /** * Get photo size source. * * @return PhotoSizeSource */ public function getPhotoSizeSource(): PhotoSizeSource { return $this->_photoSizeSource; } /** * Set photo size source. * * @param PhotoSizeSource $_photoSizeSource Photo size source. * * @return self */ public function setPhotoSizeSource(PhotoSizeSource $_photoSizeSource): self { $this->_photoSizeSource = $_photoSizeSource; return $this; } /** * Check if has photo size source. * * @return boolean */ public function hasPhotoSizeSource(): bool { return isset($this->_photoSizeSource); } /** * Get dC ID. * * @return int */ public function getDcId(): int { return $this->_dcId; } /** * Set dC ID. * * @param int $_dcId DC ID. * * @return self */ public function setDcId(int $_dcId): self { $this->_dcId = $_dcId; return $this; } } . * * @author Daniil Gentili * @copyright 2016-2019 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://github.com/tg-file-decoder Documentation */ namespace danog\Decoder; /** * Thumbnail. */ const THUMBNAIL = 0; /** * Profile photo. * Used for users and channels, chat photos are normal PHOTOs. */ const PROFILE_PHOTO = 1; /** * Normal photos. */ const PHOTO = 2; /** * Voice messages. */ const VOICE = 3; /** * Video. */ const VIDEO = 4; /** * Document. */ const DOCUMENT = 5; /** * Secret chat document. */ const ENCRYPTED = 6; /** * Temporary document. */ const TEMP = 7; /** * Sticker. */ const STICKER = 8; /** * Music. */ const AUDIO = 9; /** * GIF. */ const ANIMATION = 10; /** * Encrypted thumbnail. */ const ENCRYPTED_THUMBNAIL = 11; /** * Wallpaper. */ const WALLPAPER = 12; /** * Round video. */ const VIDEO_NOTE = 13; /** * Passport raw file. */ const SECURE_RAW = 14; /** * Passport file. */ const SECURE = 15; /** * Background. */ const BACKGROUND = 16; /** * Size. */ const SIZE = 17; const NONE = 18; const TYPES = [ THUMBNAIL => 'thumbnail', PROFILE_PHOTO => 'profile_photo', PHOTO => 'photo', VOICE => 'voice', VIDEO => 'video', DOCUMENT => 'document', ENCRYPTED => 'encrypted', TEMP => 'temp', STICKER => 'sticker', AUDIO => 'audio', ANIMATION => 'animation', ENCRYPTED_THUMBNAIL => 'encrypted_thumbnail', WALLPAPER => 'wallpaper', VIDEO_NOTE => 'video_note', SECURE_RAW => 'secure_raw', SECURE => 'secure', BACKGROUND => 'background', SIZE => 'size' ]; const TYPES_IDS = [ 'thumbnail' => THUMBNAIL, 'profile_photo' => PROFILE_PHOTO, 'photo' => PHOTO, 'voice' => VOICE, 'video' => VIDEO, 'document' => DOCUMENT, 'encrypted' => ENCRYPTED, 'temp' => TEMP, 'sticker' => STICKER, 'audio' => AUDIO, 'animation' => ANIMATION, 'encrypted_thumbnail' => ENCRYPTED_THUMBNAIL, 'wallpaper' => WALLPAPER, 'video_note' => VIDEO_NOTE, 'secure_raw' => SECURE_RAW, 'secure' => SECURE, 'background' => BACKGROUND, 'size' => SIZE ]; const UNIQUE_WEB = 0; const UNIQUE_PHOTO = 1; const UNIQUE_DOCUMENT = 2; const UNIQUE_SECURE = 3; const UNIQUE_ENCRYPTED = 4; const UNIQUE_TEMP = 5; const UNIQUE_TYPES = [ UNIQUE_WEB => 'web', UNIQUE_PHOTO => 'photo', UNIQUE_DOCUMENT => 'document', UNIQUE_SECURE => 'secure', UNIQUE_ENCRYPTED => 'encrypted', UNIQUE_TEMP => 'temp' ]; const UNIQUE_TYPES_IDS = [ 'web' => UNIQUE_WEB, 'photo' => UNIQUE_PHOTO, 'document' => UNIQUE_DOCUMENT, 'secure' => UNIQUE_SECURE, 'encrypted' => UNIQUE_ENCRYPTED, 'temp' => UNIQUE_TEMP ]; const FULL_UNIQUE_MAP = [ PHOTO => UNIQUE_PHOTO, PROFILE_PHOTO => UNIQUE_PHOTO, THUMBNAIL => UNIQUE_PHOTO, ENCRYPTED_THUMBNAIL => UNIQUE_PHOTO, WALLPAPER => UNIQUE_PHOTO, VIDEO => UNIQUE_DOCUMENT, VOICE => UNIQUE_DOCUMENT, DOCUMENT => UNIQUE_DOCUMENT, STICKER => UNIQUE_DOCUMENT, AUDIO => UNIQUE_DOCUMENT, ANIMATION => UNIQUE_DOCUMENT, VIDEO_NOTE => UNIQUE_DOCUMENT, BACKGROUND => UNIQUE_DOCUMENT, SECURE => UNIQUE_SECURE, SECURE_RAW => UNIQUE_SECURE, ENCRYPTED => UNIQUE_ENCRYPTED, TEMP => UNIQUE_TEMP ]; const PHOTOSIZE_SOURCE_LEGACY = 0; const PHOTOSIZE_SOURCE_THUMBNAIL = 1; const PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL = 2; const PHOTOSIZE_SOURCE_DIALOGPHOTO_BIG = 3; const PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL = 4; const PHOTOSIZE_SOURCE_FULL_LEGACY = 5; const PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL_LEGACY = 6; const PHOTOSIZE_SOURCE_DIALOGPHOTO_BIG_LEGACY = 7; const PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL_LEGACY = 8; const PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL_VERSION = 9; const WEB_LOCATION_FLAG = 1 << 24; const FILE_REFERENCE_FLAG = 1 << 25; const LONG = PHP_INT_SIZE === 8 ? 'Q' : 'l2'; $BIG_ENDIAN = \pack('L', 1) === \pack('N', 1); /** * Unpack long properly, returns an actual number in any case. * * @param string $field Field to unpack * * @return string|int */ function unpackLong(string $field) { if (PHP_INT_SIZE === 8) { /** @psalm-suppress InvalidGlobal */ global $BIG_ENDIAN; // Evil return \unpack('q', $BIG_ENDIAN ? \strrev($field) : $field)[1]; } if (\class_exists(\tgseclib\Math\BigInteger::class)) { return (string) new \tgseclib\Math\BigInteger(\strrev($field), -256); } if (\class_exists(\phpseclib\Math\BigInteger::class)) { return (string) new \phpseclib\Math\BigInteger(\strrev($field), -256); } throw new \Error('Please install phpseclib to unpack bot API file IDs'); } /** * Pack string long. * * @param string|int $field * * @return string */ function packLongBig($field): string { if (PHP_INT_SIZE === 8) { /** @psalm-suppress InvalidGlobal */ global $BIG_ENDIAN; // Evil $res = \pack('q', $field); return $BIG_ENDIAN ? \strrev($res) : $res; } if (\class_exists(\tgseclib\Math\BigInteger::class)) { return (new \tgseclib\Math\BigInteger($field))->toBytes(); } if (\class_exists(\phpseclib\Math\BigInteger::class)) { return (new \phpseclib\Math\BigInteger($field))->toBytes(); } throw new \Error('Please install phpseclib to unpack bot API file IDs'); } /** * Fix long parameters in case of 32 bit systems. * * @param array $params Parameters * @param string $field 64-bit field * * @return void */ function fixLong(array &$params, string $field) { if (PHP_INT_SIZE === 8) { return; } $params[$field] = [ $params[$field.'1'], $params[$field.'2'], ]; unset($params[$field.'1'], $params[$field.'2']); } /** * Encode long to string. * * @param string|int|int[] $fields Fields to encode * * @return string */ function packLong($fields): string { if (\is_string($fields)) { // Already encoded, we hope return $fields; } if (PHP_INT_SIZE === 8) { return \pack(LONG, $fields); } return \pack(LONG, ...$fields); } /** * Base64URL decode. * * @param string $data Data to decode * * @internal * * @return string */ function base64urlDecode(string $data): string { return \base64_decode(\str_pad(\strtr($data, '-_', '+/'), \strlen($data) % 4, '=', STR_PAD_RIGHT)); } /** * Base64URL encode. * * @param string $data Data to encode * * @internal * * @return string */ function base64urlEncode(string $data): string { return \rtrim(\strtr(\base64_encode($data), '+/', '-_'), '='); } /** * Null-byte RLE decode. * * @param string $string Data to decode * * @internal * * @return string */ function rleDecode(string $string): string { $new = ''; $last = ''; $null = "\0"; foreach (\str_split($string) as $cur) { if ($last === $null) { $new .= \str_repeat($last, \ord($cur)); $last = ''; } else { $new .= $last; $last = $cur; } } $string = $new.$last; return $string; } /** * Null-byte RLE encode. * * @param string $string Data to encode * * @internal * * @return string */ function rleEncode(string $string): string { $new = ''; $count = 0; $null = "\0"; foreach (\str_split($string) as $cur) { if ($cur === $null) { ++$count; } else { if ($count > 0) { $new .= $null.\chr($count); $count = 0; } $new .= $cur; } } if ($count > 0) { $new .= $null.\chr($count); $count = 0; } return $new; } /** * Positive modulo * Works just like the % (modulus) operator, only returns always a postive number. * * @param int $a A * @param int $b B * * @internal * * @return int Modulo */ function posmod(int $a, int $b): int { $resto = $a % $b; return $resto < 0 ? $resto + \abs($b) : $resto; } /** * Read TL string. * * @param mixed $stream Byte stream * * @internal * * @return string */ function readTLString($stream): string { $l = \ord(\stream_get_contents($stream, 1)); if ($l > 254) { throw new \InvalidArgumentException("Length too big!"); } if ($l === 254) { $long_len = \unpack('V', \stream_get_contents($stream, 3).\chr(0))[1]; $x = \stream_get_contents($stream, $long_len); $resto = posmod(-$long_len, 4); if ($resto > 0) { \stream_get_contents($stream, $resto); } } else { $x = $l ? \stream_get_contents($stream, $l) : ''; $resto = posmod(-($l + 1), 4); if ($resto > 0) { \stream_get_contents($stream, $resto); } } return $x; } /** * Pack TL string. * * @param string $string String * * @return string */ function packTLString(string $string): string { $l = \strlen($string); $concat = ''; if ($l <= 253) { $concat .= \chr($l); $concat .= $string; $concat .= \pack('@'.posmod(-$l - 1, 4)); } else { $concat .= \chr(254); $concat .= \substr(\pack('V', $l), 0, 3); $concat .= $string; $concat .= \pack('@'.posmod(-$l, 4)); } return $concat; } /** * Internal decode function. * * I know that you will use this directly giuseppe * * @param string $fileId Bot API file ID * * @internal * * @return array */ function internalDecode(string $fileId): array { $orig = $fileId; $fileId = rleDecode(base64urlDecode($fileId)); $result = []; $result['version'] = \ord($fileId[\strlen($fileId) - 1]); $result['subVersion'] = $result['version'] === 4 ? \ord($fileId[\strlen($fileId) - 2]) : 0; $result += \unpack('VtypeId/Vdc_id', $fileId); $result['hasReference'] = (bool) ($result['typeId'] & FILE_REFERENCE_FLAG); $result['hasWebLocation'] = (bool) ($result['typeId'] & WEB_LOCATION_FLAG); $result['typeId'] &= ~FILE_REFERENCE_FLAG; $result['typeId'] &= ~WEB_LOCATION_FLAG; if (!isset(TYPES[$result['typeId']])) { throw new \InvalidArgumentException("Invalid file type provided: {$result['typeId']}"); } $result['type'] = TYPES[$result['typeId']]; $res = \fopen('php://memory', 'rw+b'); \fwrite($res, \substr($fileId, 8)); \fseek($res, 0); $fileId = $res; if ($result['hasReference']) { $result['fileReference'] = readTLString($fileId); } if ($result['hasWebLocation']) { $result['url'] = readTLString($fileId); $result['access_hash'] = \unpack(LONG.'access_hash', \stream_get_contents($fileId, 8)); fixLong($result, 'access_hash'); return $result; } $result += \unpack(LONG.'id/'.LONG.'access_hash', \stream_get_contents($fileId, 16)); fixLong($result, 'id'); fixLong($result, 'access_hash'); if ($result['typeId'] <= PHOTO) { $parsePhotoSize = function () use (&$result, &$fileId) { $result['photosize_source'] = $result['subVersion'] >= 4 ? \unpack('V', \stream_get_contents($fileId, 4))[1] : 0; switch ($result['photosize_source']) { case PHOTOSIZE_SOURCE_LEGACY: $result += \unpack(LONG.'secret', \stream_get_contents($fileId, 8)); fixLong($result, 'secret'); break; case PHOTOSIZE_SOURCE_THUMBNAIL: $result += \unpack('Vfile_type/athumbnail_type', \stream_get_contents($fileId, 8)); break; case PHOTOSIZE_SOURCE_DIALOGPHOTO_BIG: case PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL: $result['photo_size'] = $result['photosize_source'] === PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL ? 'photo_small' : 'photo_big'; $result['dialog_id'] = unpackLong(\stream_get_contents($fileId, 8)); $result['dialog_access_hash'] = \unpack(LONG, \stream_get_contents($fileId, 8))[1]; fixLong($result, 'dialog_access_hash'); break; case PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL: $result += \unpack(LONG.'sticker_set_id/'.LONG.'sticker_set_access_hash', \stream_get_contents($fileId, 16)); fixLong($result, 'sticker_set_id'); fixLong($result, 'sticker_set_access_hash'); break; case PHOTOSIZE_SOURCE_FULL_LEGACY: $result += \unpack(LONG.'volume_id/'.LONG.'secret/llocal_id', \stream_get_contents($fileId, 20)); fixLong($result, 'volume_id'); fixLong($result, 'secret'); break; case PHOTOSIZE_SOURCE_DIALOGPHOTO_BIG_LEGACY: case PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL_LEGACY: $result['photo_size'] = $result['photosize_source'] === PHOTOSIZE_SOURCE_DIALOGPHOTO_SMALL_LEGACY ? 'photo_small' : 'photo_big'; $result['dialog_id'] = unpackLong(\stream_get_contents($fileId, 8)); $result['dialog_access_hash'] = \unpack(LONG, \stream_get_contents($fileId, 8))[1]; fixLong($result, 'dialog_access_hash'); $result += \unpack(LONG.'volume_id/llocal_id', \stream_get_contents($fileId, 12)); fixLong($result, 'volume_id'); break; case PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL_LEGACY: $result += \unpack(LONG.'sticker_set_id/'.LONG.'sticker_set_access_hash', \stream_get_contents($fileId, 16)); fixLong($result, 'sticker_set_id'); fixLong($result, 'sticker_set_access_hash'); $result += \unpack(LONG.'volume_id/llocal_id', \stream_get_contents($fileId, 12)); fixLong($result, 'volume_id'); break; case PHOTOSIZE_SOURCE_STICKERSET_THUMBNAIL_VERSION: $result += \unpack(LONG.'sticker_set_id/'.LONG.'sticker_set_access_hash/lsticker_version', \stream_get_contents($fileId, 20)); fixLong($result, 'sticker_set_id'); fixLong($result, 'sticker_set_access_hash'); break; } }; if ($result['subVersion'] >= 32) { $parsePhotoSize(); } else { $result += \unpack(LONG.'volume_id', \stream_get_contents($fileId, 8)); fixLong($result, 'volume_id'); if ($result['subVersion'] >= 22) { $parsePhotoSize(); $result += \unpack('llocal_id', \stream_get_contents($fileId, 4)); } else { $result += \unpack(LONG.'secret/llocal_id', \stream_get_contents($fileId, 12)); fixLong($result, 'volume_id'); fixLong($result, 'secret'); } } } $l = \fstat($fileId)['size'] - \ftell($fileId); $l -= $result['version'] >= 4 ? 2 : 1; if ($l > 0) { \trigger_error("File ID $orig has $l bytes of leftover data"); } return $result; } /** * Internal decode function. * * I know that you will use this directly giuseppe * * @param string $fileId Bot API file ID * * @internal * * @return array */ function internalDecodeUnique(string $fileId): array { $orig = $fileId; $fileId = rleDecode(base64urlDecode($fileId)); $result = \unpack('VtypeId', $fileId); if (!isset(UNIQUE_TYPES[$result['typeId']])) { throw new \InvalidArgumentException("Invalid file type provided: {$result['typeId']}"); } $result['type'] = UNIQUE_TYPES[$result['typeId']]; $fileId = \substr($fileId, 4); if ($result['typeId'] === UNIQUE_WEB) { $res = \fopen('php://memory', 'rw+b'); \fwrite($res, $fileId); \fseek($res, 0); $fileId = $res; $result['url'] = readTLString($fileId); $l = \fstat($fileId)['size'] - \ftell($fileId); } elseif (\strlen($fileId) === 12) { // Legacy photos $result += \unpack(LONG.'volume_id/llocal_id', $fileId); fixLong($result, 'volume_id'); $l = 0; } elseif (\strlen($fileId) === 9) { // Dialog photos/thumbnails $result += \unpack(LONG.'id/CsubType', $fileId); fixLong($result, 'id'); $l = 0; } elseif (\strlen($fileId) === 13) { // Stickerset ID/version $result += \unpack('CsubType/'.LONG.'sticker_set_id/lsticker_set_version', $fileId); fixLong($result, 'sticker_set_id'); $l = 0; } elseif (\strlen($fileId) === 8) { // Any other document $result += \unpack(LONG.'id', $fileId); fixLong($result, 'id'); $l = 0; } else { $l = \strlen($fileId); } if ($l > 0) { \trigger_error("Unique file ID $orig has $l bytes of leftover data"); } return $result; } . * * @author Daniil Gentili * @copyright 2016-2019 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * * @link https://github.com/tg-file-decoder Documentation */ namespace danog\Decoder; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceDialogPhoto; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceStickersetThumbnailVersion; use danog\Decoder\PhotoSizeSource\PhotoSizeSourceThumbnail; /** * Represents decoded unique bot API file ID. */ class UniqueFileId { /** * File type. * * @var int */ private $_type = NONE; /** * File ID. * * @var int */ private $_id; /** * Photo volume ID. * * @var int */ private $_volumeId; /** * Photo local ID. * * @var int */ private $_localId; /** * Photo subtype. * * @var int */ private $_subType; /** * Sticker set ID. * * @var int */ private $_stickerSetId; /** * Sticker set version. * * @var int */ private $_stickerSetVersion; /** * Weblocation URL. * * @var string */ private $_url; /** * Basic constructor function. */ public function __construct() { } /** * Get unique bot API file ID. * * @return string */ public function __toString(): string { return $this->getUniqueBotAPI(); } /** * Get unique bot API file ID. * * @return string */ public function getUniqueBotAPI(): string { $fileId = \pack('V', $this->getType()); if ($this->getType() === UNIQUE_WEB) { $fileId .= packTLString($this->getUrl()); } elseif ($this->getType() === UNIQUE_PHOTO) { if ($this->hasVolumeId()) { $fileId .= packLong($this->getVolumeId()); $fileId .= \pack('l', $this->getLocalId()); } elseif ($this->hasStickerSetId()) { $fileId .= \chr($this->getSubType()); $fileId .= packLong($this->getStickerSetId()); $fileId .= \pack('l', $this->getStickerSetVersion()); } else { $fileId .= packLong($this->getId()); $fileId .= \chr($this->getSubType()); } } elseif ($this->hasId()) { $fileId .= packLong($this->getId()); } return base64urlEncode(rleEncode($fileId)); } /** * Decode unique bot API file ID. * * @param string $fileId Bot API file ID * * @return self */ public static function fromUniqueBotAPI(string $fileId): self { $result = new self(); $resultArray = internalDecodeUnique($fileId); $result->setType($resultArray['typeId']); if ($result->getType() === UNIQUE_WEB) { $result->setUrl($resultArray['url']); } elseif ($result->getType() === UNIQUE_PHOTO) { if (isset($resultArray['volume_id'])) { $result->setVolumeId($resultArray['volume_id']); $result->setLocalId($resultArray['local_id']); } elseif (isset($resultArray['id'])) { $result->setId($resultArray['id']); $result->setSubType($resultArray['subType']); } elseif (isset($resultArray['sticker_set_id'])) { $result->setStickerSetId($resultArray['sticker_set_id']); $result->setStickerSetVersion($resultArray['sticker_set_version']); $result->setSubType($resultArray['subType']); } } elseif (isset($resultArray['id'])) { $result->setId($resultArray['id']); } return $result; } /** * Convert full bot API file ID to unique file ID. * * @param string $fileId Full bot API file ID * * @return self */ public static function fromBotAPI(string $fileId): self { return FileId::fromBotAPI($fileId)->getUnique(); } /** * Turn full file ID into unique file ID. * * @param FileId $fileId Full file ID * * @return self */ public static function fromFileId(FileId $fileId): self { $result = new self(); $result->setType(FULL_UNIQUE_MAP[$fileId->getType()]); if ($result->hasUrl()) { $result->setType(UNIQUE_WEB); } if ($result->getType() === UNIQUE_WEB) { $result->setUrl($fileId->getUrl()); } elseif ($result->getType() === UNIQUE_PHOTO) { if ($fileId->hasVolumeId()) { $result->setVolumeId($fileId->getVolumeId()); $result->setLocalId($fileId->getLocalId()); } elseif ($fileId->hasId()) { $result->setId($fileId->getId()); $photoSize = $fileId->getPhotoSizeSource(); if ($photoSize instanceof PhotoSizeSourceThumbnail) { $type = $photoSize->getThumbType(); if ($type === 'a') { $type = \chr(0); } elseif ($type === 'c') { $type = \chr(1); } else { $type = \chr(\ord($type)+5); } $result->setSubType(\ord($type)); } elseif ($photoSize instanceof PhotoSizeSourceDialogPhoto) { $result->setSubType($photoSize->isSmallDialogPhoto() ? 0 : 1); } elseif ($photoSize instanceof PhotoSizeSourceStickersetThumbnailVersion) { $result->setSubType(2); $result->setStickerSetId($photoSize->getStickerSetId()); $result->setStickerSetVersion($photoSize->getStickerSetVersion()); } } } elseif ($fileId->hasId()) { $result->setId($fileId->getId()); } return $result; } /** * Get unique file type as string. * * @return string */ public function getTypeName(): string { return UNIQUE_TYPES[$this->_type]; } /** * Get unique file type. * * @return int */ public function getType(): int { return $this->_type; } /** * Set file type. * * @param int $_type File type. * * @return self */ public function setType(int $_type): self { $this->_type = $_type; return $this; } /** * Get file ID. * * @return int */ public function getId() { return $this->_id; } /** * Set file ID. * * @param int $_id File ID. * * @return self */ public function setId($_id): self { $this->_id = $_id; return $this; } /** * Check if has ID. * * @return boolean */ public function hasId(): bool { return isset($this->_id); } /** * Get photo volume ID. * * @return int */ public function getVolumeId() { return $this->_volumeId; } /** * Set photo volume ID. * * @param int $_volumeId Photo volume ID. * * @return self */ public function setVolumeId($_volumeId): self { $this->_volumeId = $_volumeId; return $this; } /** * Check if has volume ID. * * @return boolean */ public function hasVolumeId(): bool { return isset($this->_volumeId); } /** * Get photo local ID. * * @return int */ public function getLocalId(): int { return $this->_localId; } /** * Set photo local ID. * * @param int $_localId Photo local ID. * * @return self */ public function setLocalId(int $_localId): self { $this->_localId = $_localId; return $this; } /** * Check if has local ID. * * @return boolean */ public function hasLocalId(): bool { return isset($this->_localId); } /** * Get weblocation URL. * * @return string */ public function getUrl(): string { return $this->_url; } /** * Set weblocation URL. * * @param string $_url Weblocation URL * * @return self */ public function setUrl(string $_url): self { $this->_url = $_url; return $this; } /** * Check if has weblocation URL. * * @return boolean */ public function hasUrl(): bool { return isset($this->_url); } /** * Get photo subtype. * * @return int */ public function getSubType(): int { return $this->_subType; } /** * Has photo subtype? * * @return bool */ public function hasSubType(): bool { return isset($this->_subType); } /** * Set photo subtype. * * @param int $_subType Photo subtype * * @return self */ public function setSubType(int $_subType): self { $this->_subType = $_subType; return $this; } /** * Get sticker set ID. * * @return int */ public function getStickerSetId() { return $this->_stickerSetId; } /** * Has sticker set ID? * * @return bool */ public function hasStickerSetId(): bool { return isset($this->_stickerSetId); } /** * Set sticker set ID. * * @param int $_stickerSetId Sticker set ID * * @return self */ public function setStickerSetId($_stickerSetId): self { $this->_stickerSetId = $_stickerSetId; return $this; } /** * Get sticker set version. * * @return int */ public function getStickerSetVersion(): int { return $this->_stickerSetVersion; } /** * Has sticker set version. * * @return bool */ public function hasStickerSetVersion(): bool { return isset($this->_stickerSetVersion); } /** * Set sticker set version. * * @param int $_stickerSetVersion Sticker set version * * @return self */ public function setStickerSetVersion(int $_stickerSetVersion): self { $this->_stickerSetVersion = $_stickerSetVersion; return $this; } } validateNameserver($nameserver); } $this->nameservers = $nameservers; $this->httpClient = $httpClient ?? HttpClientBuilder::buildDefault(); $this->cache = $cache ?? new ArrayCache(5000/* default gc interval */, 256/* size */); $this->configLoader = $configLoader ?? (\stripos(PHP_OS, "win") === 0 ? new WindowsConfigLoader : new UnixConfigLoader); $this->subResolver = $resolver ?? new Rfc1035StubResolver(null, $this->configLoader); } private function validateNameserver($nameserver) { if (!($nameserver instanceof Nameserver)) { throw new ConfigException("Invalid nameserver: {$nameserver}"); } } public function getNameservers(): array { return $this->nameservers; } public function isNameserver($string): bool { foreach ($this->nameservers as $nameserver) { if ($nameserver->getHost() === $string) { return true; } } return false; } public function getHttpClient(): DelegateHttpClient { return $this->httpClient; } public function getCache(): Cache { return $this->cache; } public function getConfigLoader(): ConfigLoader { return $this->configLoader; } public function getSubResolver(): Resolver { return $this->subResolver; } } getSubResolver(); if ($resolver instanceof Rfc8484StubResolver) { throw new ConfigException("Can't use Rfc8484StubResolver as subresolver for Rfc8484StubResolver"); } $this->cache = $config->getCache(); $this->configLoader = $config->getConfigLoader(); $this->subResolver = $resolver; $this->dohConfig = $config; $this->questionFactory = new QuestionFactory; } /** @inheritdoc */ public function resolve(string $name, int $typeRestriction = null): Promise { if ($typeRestriction !== null && $typeRestriction !== Record::A && $typeRestriction !== Record::AAAA) { throw new \Error("Invalid value for parameter 2: null|Record::A|Record::AAAA expected"); } return call(function () use ($name, $typeRestriction) { if (!$this->config) { try { yield $this->reloadConfig(); } catch (ConfigException $e) { $this->config = new Config(['0.0.0.0'], []); } } switch ($typeRestriction) { case Record::A: if (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) { return [new Record($name, Record::A, null)]; } elseif (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { throw new DnsException("Got an IPv6 address, but type is restricted to IPv4"); } break; case Record::AAAA: if (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { return [new Record($name, Record::AAAA, null)]; } elseif (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) { throw new DnsException("Got an IPv4 address, but type is restricted to IPv6"); } break; default: if (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) { return [new Record($name, Record::A, null)]; } elseif (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { return [new Record($name, Record::AAAA, null)]; } break; } $name = normalizeName($name); if ($records = $this->queryHosts($name, $typeRestriction)) { return $records; } // Follow RFC 6761 and never send queries for localhost to the caching DNS server // Usually, these queries are already resolved via queryHosts() if ($name === 'localhost') { return $typeRestriction === Record::AAAA ? [new Record('::1', Record::AAAA, null)] : [new Record('127.0.0.1', Record::A, null)]; } if ($this->dohConfig->isNameserver($name)) { // Work around an OPCache issue that returns an empty array with "return yield ...", // so assign to a variable first and return after the try block. // // See https://github.com/amphp/dns/issues/58. // See https://bugs.php.net/bug.php?id=74840. $records = yield $this->subResolver->resolve($name, $typeRestriction); return $records; } for ($redirects = 0; $redirects < 5; $redirects++) { try { if ($typeRestriction) { $records = yield $this->query($name, $typeRestriction); } else { try { list(, $records) = yield Promise\some([ $this->query($name, Record::A), $this->query($name, Record::AAAA), ]); $records = \array_merge(...$records); break; // Break redirect loop, otherwise we query the same records 5 times } catch (MultiReasonException $e) { $errors = []; foreach ($e->getReasons() as $reason) { if ($reason instanceof NoRecordException) { throw $reason; } $error = (string) $reason;//->getMessage(); if ($reason instanceof MultiReasonException) { $reasons = []; foreach ($reason->getReasons() as $reason) { $reasons []= (string) $reason;//->getMessage(); } $error .= " (".\implode(", ", $reasons).")"; } $errors[] = $error; } throw new DnsException("All query attempts failed for {$name}: ".\implode(", ", $errors), 0, $e); } } } catch (NoRecordException $e) { try { /** @var Record[] $cnameRecords */ $cnameRecords = yield $this->query($name, Record::CNAME); $name = $cnameRecords[0]->getValue(); continue; } catch (NoRecordException $e) { /** @var Record[] $dnameRecords */ $dnameRecords = yield $this->query($name, Record::DNAME); $name = $dnameRecords[0]->getValue(); continue; } } } return $records; }); } /** * Reloads the configuration in the background. * * Once it's finished, the configuration will be used for new requests. * * @return Promise */ public function reloadConfig(): Promise { if ($this->pendingConfig) { return $this->pendingConfig; } $promise = call(function () { yield $this->subResolver->reloadConfig(); $this->config = yield $this->configLoader->loadConfig(); }); $this->pendingConfig = $promise; $promise->onResolve(function () { $this->pendingConfig = null; }); return $promise; } private function queryHosts(string $name, int $typeRestriction = null): array { $hosts = $this->config->getKnownHosts(); $records = []; $returnIPv4 = $typeRestriction === null || $typeRestriction === Record::A; $returnIPv6 = $typeRestriction === null || $typeRestriction === Record::AAAA; if ($returnIPv4 && isset($hosts[Record::A][$name])) { $records[] = new Record($hosts[Record::A][$name], Record::A, null); } if ($returnIPv6 && isset($hosts[Record::AAAA][$name])) { $records[] = new Record($hosts[Record::AAAA][$name], Record::AAAA, null); } return $records; } /** @inheritdoc */ public function query(string $name, int $type): Promise { $pendingQueryKey = $type." ".$name; if (isset($this->pendingQueries[$pendingQueryKey])) { return $this->pendingQueries[$pendingQueryKey]; } $promise = call(function () use ($name, $type) { if (!$this->config) { try { yield $this->reloadConfig(); } catch (ConfigException $e) { $this->config = new Config(['0.0.0.0'], []); } } $name = $this->normalizeName($name, $type); $question = $this->createQuestion($name, $type); if (null !== $cachedValue = yield $this->cache->get($this->getCacheKey($name, $type))) { return $this->decodeCachedResult($name, $type, $cachedValue); } /** @var Nameserver[] $nameservers */ $nameservers = $this->dohConfig->getNameservers(); $attempts = $this->config->getAttempts() * \count($nameservers); $attempt = 0; /** @var Socket $socket */ $nameserver = $nameservers[0]; $socket = $this->getSocket($nameserver); $attemptDescription = []; $exceptions = []; while ($attempt < $attempts) { try { $attemptDescription[] = $nameserver; /** @var Message $response */ try { $response = yield $socket->ask($question, $this->config->getTimeout()); } catch (DoHException $e) { // Defer call, because it might interfere with the unreference() call in Internal\Socket otherwise $exceptions []= $e; $i = ++$attempt % \count($nameservers); $nameserver = $nameservers[$i]; $socket = $this->getSocket($nameserver); continue; } catch (NoRecordException $e) { // Defer call, because it might interfere with the unreference() call in Internal\Socket otherwise $i = ++$attempt % \count($nameservers); $nameserver = $nameservers[$i]; $socket = $this->getSocket($nameserver); continue; } $this->assertAcceptableResponse($response); if ($response->isTruncated()) { throw new DnsException("Server returned a truncated response for '{$name}' (".Record::getName($type).")"); } $answers = $response->getAnswerRecords(); $result = []; $ttls = []; /** @var \LibDNS\Records\Resource $record */ foreach ($answers as $record) { $recordType = $record->getType(); $result[$recordType][] = (string) $record->getData(); // Cache for max one day $ttls[$recordType] = \min($ttls[$recordType] ?? 86400, $record->getTTL()); } foreach ($result as $recordType => $records) { // We don't care here whether storing in the cache fails $this->cache->set($this->getCacheKey($name, $recordType), \json_encode($records), $ttls[$recordType]); } if (!isset($result[$type])) { // "it MUST NOT cache it for longer than five (5) minutes" per RFC 2308 section 7.1 $this->cache->set($this->getCacheKey($name, $type), \json_encode([]), 300); throw new NoRecordException("No records returned for '{$name}' (".Record::getName($type).")"); } return \array_map(function ($data) use ($type, $ttls) { return new Record($data, $type, $ttls[$type]); }, $result[$type]); } catch (TimeoutException $e) { // Defer call, because it might interfere with the unreference() call in Internal\Socket otherwise $i = ++$attempt % \count($nameservers); $nameserver = $nameservers[$i]; $socket = $this->getSocket($nameserver); continue; } } $timeout = new TimeoutException(\sprintf( "No response for '%s' (%s) from any nameserver after %d attempts, tried %s", $name, Record::getName($type), $attempts, \implode(", ", $attemptDescription) )); if (!$exceptions) { throw $timeout; } throw new MultiReasonException($exceptions, $timeout->getMessage()); }); $this->pendingQueries[$type." ".$name] = $promise; $promise->onResolve(function () use ($name, $type) { unset($this->pendingQueries[$type." ".$name]); }); return $promise; } private function normalizeName(string $name, int $type) { if ($type === Record::PTR) { if (($packedIp = @\inet_pton($name)) !== false) { if (isset($packedIp[4])) { // IPv6 $name = \wordwrap(\strrev(\bin2hex($packedIp)), 1, ".", true).".ip6.arpa"; } else { // IPv4 $name = \inet_ntop(\strrev($packedIp)).".in-addr.arpa"; } } } elseif (\in_array($type, [Record::A, Record::AAAA])) { $name = normalizeName($name); } return $name; } /** * @param string $name * @param int $type * * @return \LibDNS\Records\Question */ private function createQuestion(string $name, int $type): Question { if (0 > $type || 0xffff < $type) { $message = \sprintf('%d does not correspond to a valid record type (must be between 0 and 65535).', $type); throw new \Error($message); } $question = $this->questionFactory->create($type); $question->setName($name); return $question; } private function getCacheKey(string $name, int $type): string { return self::CACHE_PREFIX.$name."#".$type; } private function decodeCachedResult(string $name, int $type, string $encoded) { $decoded = \json_decode($encoded, true); if (!$decoded) { throw new NoRecordException("No records returned for {$name} (cached result)"); } $result = []; foreach ($decoded as $data) { $result[] = new Record($data, $type); } return $result; } private function getSocket(Nameserver $nameserver) { $uri = $nameserver->getUri(); if (isset($this->sockets[$uri])) { return $this->sockets[$uri]; } $this->sockets[$uri] = HttpsSocket::connect($this->dohConfig->getHttpClient(), $nameserver); return $this->sockets[$uri]; } private function assertAcceptableResponse(Message $response) { if ($response->getResponseCode() !== 0) { throw new DnsException(\sprintf("Server returned error code: %d", $response->getResponseCode())); } } } uri = $uri; $this->type = $type; $this->headers = $headers; $this->host = \parse_url($uri, PHP_URL_HOST); } public function getUri(): string { return $this->uri; } public function getHost(): string { return $this->host; } public function getHeaders(): array { return $this->headers; } public function getType(): int { return $this->type; } public function __toString(): string { return $this->uri; /* switch ($this->type) { case self::RFC8484_GET: return "{$this->uri} RFC 8484 GET"; case self::RFC8484_POST: return "{$this->uri} RFC 8484 POST"; case self::GOOGLE_JSON: return "{$this->uri} google JSON"; }*/ } } */ abstract public static function connect(DelegateHttpClient $httpClient, Nameserver $nameserver): self; /** * @param Message $message * * @return Promise */ abstract protected function resolve(Message $message): Promise; protected function __construct() { $this->messageFactory = new MessageFactory; $this->onResolve = function (\Throwable $exception = null, Message $message = null) { if ($exception) { $this->error($exception); return; } \assert($message instanceof Message); $id = $message->getId(); // Ignore duplicate and invalid responses. if (isset($this->pending[$id]) && $this->matchesQuestion($message, $this->pending[$id]->question)) { /** @var Deferred $deferred */ $deferred = $this->pending[$id]->deferred; unset($this->pending[$id]); $deferred->resolve($message); } }; } /** * @param \LibDNS\Records\Question $question * @param int $timeout * * @return \Amp\Promise<\LibDNS\Messages\Message> */ final public function ask(Question $question, int $timeout): Promise { return call(function () use ($question, $timeout) { if (\count($this->pending) > self::MAX_CONCURRENT_REQUESTS) { $deferred = new Deferred; $this->queue[] = $deferred; yield $deferred->promise(); } do { $id = \random_int(0, 0xffff); } while (isset($this->pending[$id])); $deferred = new Deferred; $pending = new class { use Amp\Struct; public $deferred; public $question; }; $pending->deferred = $deferred; $pending->question = $question; $this->pending[$id] = $pending; $message = $this->createMessage($question, $id); try { $response = $this->resolve($message); } catch (StreamException $exception) { $exception = new DnsException("Sending the request failed", 0, $exception); $this->error($exception); throw $exception; } $response->onResolve($this->onResolve); try { // Work around an OPCache issue that returns an empty array with "return yield ...", // so assign to a variable first and return after the try block. // // See https://github.com/amphp/dns/issues/58. // See https://bugs.php.net/bug.php?id=74840. $result = yield Promise\timeout($deferred->promise(), $timeout); } catch (Amp\TimeoutException $exception) { unset($this->pending[$id]); throw new TimeoutException("Didn't receive a response within {$timeout} milliseconds."); } finally { if ($this->queue) { $deferred = \array_shift($this->queue); $deferred->resolve(); } } return $result; }); } private function error(\Throwable $exception) { if (empty($this->pending)) { return; } if (!$exception instanceof DnsException && !$exception instanceof DoHException) { $message = "Unexpected error during resolution: ".$exception->getMessage(); $exception = new DnsException($message, 0, $exception); } $pending = $this->pending; $this->pending = []; foreach ($pending as $pendingQuestion) { /** @var Deferred $deferred */ $deferred = $pendingQuestion->deferred; $deferred->fail($exception); } } final protected function createMessage(Question $question, int $id): Message { $request = $this->messageFactory->create(MessageTypes::QUERY); $request->getQuestionRecords()->add($question); $request->isRecursionDesired(true); $request->setID($id); return $request; } private function matchesQuestion(Message $message, Question $question): bool { if ($message->getType() !== MessageTypes::RESPONSE) { return false; } $questionRecords = $message->getQuestionRecords(); // We only ever ask one question at a time if (\count($questionRecords) !== 1) { return false; } $questionRecord = $questionRecords->getIterator()->current(); if ($questionRecord->getClass() !== $question->getClass()) { return false; } if ($questionRecord->getType() !== $question->getType()) { return false; } if ($questionRecord->getName()->getValue() !== $question->getName()->getValue()) { return false; } return true; } } httpClient = $httpClient; $this->nameserver = $nameserver; if ($nameserver->getType() !== Nameserver::GOOGLE_JSON) { $this->encoder = (new EncoderFactory)->create(); $this->decoder = (new DecoderFactory)->create(); } else { $this->encoder = (new QueryEncoderFactory)->create(); $this->decoder = (new JsonDecoderFactory)->create(); } parent::__construct(); } protected function resolve(Message $message): Promise { $id = $message->getID(); switch ($this->nameserver->getType()) { case Nameserver::RFC8484_GET: $data = $this->encoder->encode($message); $request = new Request($this->nameserver->getUri().'?'.\http_build_query(['dns' => \base64_encode($data), 'ct' => 'application/dns-message']), "GET"); $request->setHeader('accept', 'application/dns-message'); $request->setHeaders($this->nameserver->getHeaders()); break; case Nameserver::RFC8484_POST: $data = $this->encoder->encode($message); $request = new Request($this->nameserver->getUri(), "POST"); $request->setBody($data); $request->setHeader('content-type', 'application/dns-message'); $request->setHeader('accept', 'application/dns-message'); $request->setHeader('content-length', \strlen($data)); $request->setHeaders($this->nameserver->getHeaders()); break; case Nameserver::GOOGLE_JSON: $data = $this->encoder->encode($message); $request = new Request($this->nameserver->getUri().'?'.$data, "GET"); $request->setHeader('accept', 'application/dns-json'); $request->setHeaders($this->nameserver->getHeaders()); break; } $response = $this->httpClient->request($request); return call(function () use ($response, $id) { $response = yield $response; if ($response->getStatus() !== 200) { throw new DoHException("HTTP result !== 200: ".$response->getStatus()." ".$response->getReason(), $response->getStatus()); } $response = yield $response->getBody()->buffer(); switch ($this->nameserver->getType()) { case Nameserver::RFC8484_GET: case Nameserver::RFC8484_POST: return $this->decoder->decode($response); case Nameserver::GOOGLE_JSON: return $this->decoder->decode($response, $id); } }); } } =7.0", "amphp/cache": "^1", "amphp/parser": "^1", "danog/libdns-json": "^0.1", "daverandom/libdns": "^2.0.1", "amphp/amp": "^2", "amphp/http-client": "^4", "amphp/dns": "^1", "ext-filter": "*", "ext-json": "*" }, "require-dev": { "amphp/phpunit-util": "^1", "phpunit/phpunit": "^6", "amphp/php-cs-fixer-config": "dev-master" }, "autoload": { "psr-4": { "Amp\\DoH\\": "lib" } }, "autoload-dev": { "psr-4": { "Amp\\DoH\\Test\\": "test" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff --dry-run", "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" } } start(); $recvUri = yield $process->receive(); if ($uri) { $this->assertEquals($uri, $recvUri); } $client = yield connect($recvUri); $this->assertInstanceOf(ChannelledSocket::class, $client); yield $client->send('ping'); $this->assertEquals('pong', yield $client->receive()); yield $client->disconnect(); $this->assertNull(yield $process->join()); } /** @dataProvider provideUriType */ public function testIPCDisconectWhileReading(string $uri, int $type) { $process = new Process([__DIR__.'/Fixtures/echoServer.php', $uri, $type]); yield $process->start(); $recvUri = yield $process->receive(); if ($uri) { $this->assertEquals($uri, $recvUri); } $client = yield connect($recvUri); $this->assertInstanceOf(ChannelledSocket::class, $client); asyncCall( static function () use ($client) { while (yield $client->receive()); } ); yield $client->disconnect(); $this->assertNull(yield $process->join()); } public function provideUriType(): \Generator { foreach (['', \sys_get_temp_dir().'/pony', \sys_get_temp_dir().'/'.\str_repeat('a', 200)] as $uri) { if (\strncasecmp(\PHP_OS, "WIN", 3) === 0) { yield [$uri, IpcServer::TYPE_AUTO]; yield [$uri, IpcServer::TYPE_TCP]; } else { yield [$uri, IpcServer::TYPE_AUTO]; yield [$uri, IpcServer::TYPE_TCP]; if (\strlen($uri) < 200) { yield [$uri, IpcServer::TYPE_UNIX]; } yield [$uri, IpcServer::TYPE_FIFO]; } } } } send($server->getUri()); $socket = yield $server->accept(); if (!$socket instanceof ChannelledSocket) { throw new \RuntimeException('Socket is not instance of ChannelledSocket'); } while (yield $socket->receive()); yield $socket->disconnect(); $server->close(); return $server->accept(); }; send($server->getUri()); $socket = yield $server->accept(); if (!$socket instanceof ChannelledSocket) { throw new \RuntimeException('Socket is not instance of ChannelledSocket'); } $ping = yield $socket->receive(); if ($ping !== 'ping') { throw new \RuntimeException("Received $ping instead of ping!"); } yield $socket->send('pong'); yield $socket->disconnect(); $server->close(); return $server->accept(); }; uri = $uri; $isWindows = \strncasecmp(\PHP_OS, "WIN", 3) === 0; if ($isWindows) { if ($type === self::TYPE_AUTO || $type === self::TYPE_TCP) { $types = [self::TYPE_TCP]; } else { throw new \RuntimeException("Cannot use FIFOs and UNIX sockets on windows"); } } elseif ($type === self::TYPE_AUTO) { $types = []; if (\strlen($uri) <= 104) { $types []= self::TYPE_UNIX; } $types []= self::TYPE_FIFO; $types []= self::TYPE_TCP; } else { $types = []; if ($type & self::TYPE_UNIX && \strlen($uri) <= 104) { $types []= self::TYPE_UNIX; } if ($type & self::TYPE_TCP) { $types []= self::TYPE_TCP; } if ($type & self::TYPE_FIFO) { $types []= self::TYPE_FIFO; } } $errors = []; foreach ($types as $type) { if ($type === self::TYPE_FIFO) { try { if (!\posix_mkfifo($uri, 0777)) { $errors[$type] = "could not create the FIFO socket"; continue; } } catch (\Throwable $e) { $errors[$type] = "could not create the FIFO socket: $e"; continue; } $error = ''; try { // Open in r+w mode to prevent blocking if there is no reader $this->server = \fopen($uri, 'r+'); } catch (\Throwable $e) { $error = "$e"; } if ($this->server) { \stream_set_blocking($this->server, false); break; } $errors[$type] = "could not connect to the FIFO socket: $error"; } else { $listenUri = $type === self::TYPE_TCP ? "tcp://127.0.0.1:0" : "unix://".$uri; $errno = -1; $errstr = 'no error'; try { $this->server = \stream_socket_server($listenUri, $errno, $errstr, \STREAM_SERVER_BIND | \STREAM_SERVER_LISTEN); } catch (\Throwable $e) { $errstr = "exception: $e"; } if ($this->server) { if ($type === self::TYPE_TCP) { try { $name = \stream_socket_get_name($this->server, false); $port = \substr($name, \strrpos($name, ":") + 1); if (!\file_put_contents($this->uri, "tcp://127.0.0.1:".$port)) { $errors[$type] = 'could not create URI file'; $this->server = null; } } catch (\Throwable $e) { $errors[$type] = "could not create URI file: $e"; $this->server = null; } if (!$this->server) { continue; } } break; } $errors[$type] = "(errno: $errno) $errstr"; } } if (!$this->server) { throw new IpcServerException($errors); } $acceptor = &$this->acceptor; $this->watcher = Loop::onReadable($this->server, static function (string $watcher, $server) use (&$acceptor, $type): void { if ($type === self::TYPE_FIFO) { $length = \unpack('v', \fread($server, 2))[1]; if (!$length) { return; // Could not accept, wrong length read } $prefix = \fread($server, $length); $sockets = [ $prefix.'1', $prefix.'2', ]; foreach ($sockets as $k => &$socket) { if (@\filetype($socket) !== 'fifo') { if ($k) { \fclose($sockets[0]); } return; // Is not a FIFO } // Open in either read or write mode to send a close signal when done if (!$socket = \fopen($socket, $k ? 'w' : 'r')) { if ($k) { \fclose($sockets[0]); } return; // Could not open fifo } } $channel = new ChannelledSocket(...$sockets); } else { // Error reporting suppressed since stream_socket_accept() emits E_WARNING on client accept failure. if (!$client = @\stream_socket_accept($server, 0)) { // Timeout of 0 to be non-blocking. return; // Accepting client failed. } $channel = new ChannelledSocket($client, $client); } $deferred = $acceptor; $acceptor = null; \assert($deferred !== null); $deferred->resolve($channel); if (!$acceptor) { Loop::disable($watcher); } }); Loop::disable($this->watcher); } public function __destruct() { $this->close(); } /** * @return Promise * * @throws PendingAcceptError If another accept request is pending. */ public function accept(): Promise { if ($this->acceptor) { throw new PendingAcceptError; } if (!$this->server) { return new Success(); // Resolve with null when server is closed. } $this->acceptor = new Deferred; Loop::enable($this->watcher); return $this->acceptor->promise(); } /** * Closes the server and stops accepting connections. Any socket clients accepted will not be closed. */ public function close(): void { Loop::cancel($this->watcher); if ($this->acceptor) { $acceptor = $this->acceptor; $this->acceptor = null; $acceptor->resolve(); } if ($this->server) { \fclose($this->server); $this->server = null; } if ($this->uri !== null) { @\unlink($this->uri); $this->uri = null; } } /** * @return bool */ public function isClosed(): bool { return $this->server === null; } /** * References the accept watcher. * * @see Loop::reference() */ final public function reference(): void { Loop::reference($this->watcher); } /** * Unreferences the accept watcher. * * @see Loop::unreference() */ final public function unreference(): void { Loop::unreference($this->watcher); } /** * Get endpoint to which clients should connect. * * @return string */ public function getUri(): string { return $this->uri; } } */ function connect(string $uri): Promise { return call(static function () use ($uri) { if (!\file_exists($uri)) { throw new \RuntimeException("The endpoint does not exist!"); } $type = \filetype($uri); if ($type !== 'fifo') { if ($type === 'file') { $uri = \file_get_contents($uri); } else { $uri = "unix://$uri"; } if (!$socket = \stream_socket_client($uri, $errno, $errstr, 5, \STREAM_CLIENT_CONNECT)) { $message = "Could not connect to IPC socket"; if ($error = \error_get_last()) { $message .= \sprintf(" Errno: %d; %s", $error["type"], $error["message"]); } throw new \RuntimeException($message); } return new ChannelledSocket($socket, $socket); } $suffix = \bin2hex(\random_bytes(10)); $prefix = \sys_get_temp_dir()."/amp-".$suffix.".fifo"; if (\strlen($prefix) > 0xFFFF) { throw new \RuntimeException('Prefix is too long!'); } $sockets = [ $prefix."2", $prefix."1", ]; foreach ($sockets as $k => &$socket) { if (!\posix_mkfifo($socket, 0777)) { throw new \RuntimeException('Could not create FIFO client socket!'); } \register_shutdown_function(static function () use ($socket): void { @\unlink($socket); }); if (!$socket = \fopen($socket, 'r+')) { // Open in r+w mode to prevent blocking if there is no reader throw new \RuntimeException("Could not open FIFO client socket"); } } if (!$tempSocket = \fopen($uri, 'r+')) { // Open in r+w mode to prevent blocking if there is no reader throw new \RuntimeException("Could not connect to FIFO server"); } \stream_set_blocking($tempSocket, false); \stream_set_write_buffer($tempSocket, 0); if (!\fwrite($tempSocket, \pack('v', \strlen($prefix)).$prefix)) { \fclose($tempSocket); $tempSocket = null; throw new \RuntimeException("Failure sending request to FIFO server"); } \fclose($tempSocket); $tempSocket = null; return new ChannelledSocket(...$sockets); }); } channel = new ChannelledStream( $this->read = new ResourceInputStream($read), $this->write = new ResourceOutputStream($write) ); } /** * {@inheritdoc} */ public function receive(): Promise { if ($this->closed) { return new Success(); } return call(function (): \Generator { $this->reading = true; $data = yield $this->channel->receive(); $this->reading = false; if ($data instanceof ChannelCloseReq) { yield $this->channel->send(new ChannelCloseAck); $this->state = self::GOT_FIN_MASK; yield $this->disconnect(); if ($this->closePromise) { $this->closePromise->resolve($data); } return null; } elseif ($data instanceof ChannelCloseAck) { $this->closePromise->resolve($data); return null; } return $data; }); } /** * Cleanly disconnect from other endpoint. * * @return Promise */ public function disconnect(): Promise { if ($this->closed) { return new Success(); } return call(function (): \Generator { if ($this->reading) { $this->closePromise = new Deferred; } yield $this->channel->send(new ChannelCloseReq); do { $data = yield ($this->closePromise ? $this->closePromise->promise() : $this->channel->receive()); if ($this->closePromise) { $this->closePromise = null; } if ($data instanceof ChannelCloseReq) { yield $this->channel->send(new ChannelCloseAck); $this->state |= self::GOT_FIN_MASK; } elseif ($data instanceof ChannelCloseAck) { $this->state |= self::GOT_ACK_MASK; } } while ($this->state !== self::GOT_ALL_MASK); $this->closed = true; $this->close(); }); } /** * {@inheritdoc} */ public function send($data): Promise { if ($this->closed) { throw new ChannelException('The channel was already closed!'); } return $this->channel->send($data); } /** * {@inheritdoc} */ public function unreference() { $this->read->unreference(); } /** * {@inheritdoc} */ public function reference() { $this->read->reference(); } /** * Closes the read and write resource streams. */ private function close() { $this->read->close(); $this->write->close(); } } Resolves with the return value of $callback or fails if $callback * throws an exception. */ public function synchronized(callable $callback): Promise; /** * @return \Amp\Promise A promise for the value inside the parcel. */ public function unwrap(): Promise; } name = $name; $this->trace = $trace; } /** * Returns the class name of the uncaught exception. * * @return string */ public function getName(): string { return $this->name; } /** * Gets the stack trace at the point the panic occurred. * * @return string */ public function getPanicTrace(): string { return $this->trace; } } * * @throws \Amp\Ipc\Context\StatusError Thrown if the context has not been started. * @throws \Amp\Ipc\Sync\SynchronizationError If the context has not been started or the context * unexpectedly ends. * @throws \Amp\Ipc\Sync\ChannelException If receiving from the channel fails. * @throws \Amp\Ipc\Sync\SerializationException If unserializing the data fails. */ public function receive(): Promise; /** * @param mixed $data * * @return \Amp\Promise Resolves with the number of bytes sent on the channel. * * @throws \Amp\Ipc\Context\StatusError Thrown if the context has not been started. * @throws \Amp\Ipc\Sync\SynchronizationError If the context has not been started or the context * unexpectedly ends. * @throws \Amp\Ipc\Sync\ChannelException If sending on the channel fails. * @throws \Error If an ExitResult object is given. * @throws \Amp\Ipc\Sync\SerializationException If serializing the data fails. */ public function send($data): Promise; } read = $read; $this->write = $write; $this->received = new \SplQueue; $this->parser = new ChannelParser([$this->received, 'push']); } /** * {@inheritdoc} */ public function send($data): Promise { return call(function () use ($data) { try { return yield $this->write->write($this->parser->encode($data)); } catch (StreamException $exception) { throw new ChannelException("Sending on the channel failed. Did the context die?", 0, $exception); } }); } /** * {@inheritdoc} */ public function receive(): Promise { return call(function () { while ($this->received->isEmpty()) { try { $chunk = yield $this->read->read(); } catch (StreamException $exception) { throw new ChannelException("Reading from the channel failed. Did the context die?", 0, $exception); } if ($chunk === null) { throw new ChannelException("The channel closed unexpectedly. Did the context die?"); } $this->parser->push($chunk); } return $this->received->shift(); }); } } 'UNIX', IpcServer::TYPE_TCP => 'TCP', IpcServer::TYPE_FIFO => 'FIFO', ]; public function __construct( array $messages, int $code = 0, \Throwable $previous = null ) { $message = "Could not create IPC server: "; foreach ($messages as $type => $error) { $message .= self::TYPE_MAP[$type].": $error; "; } parent::__construct($message, $code, $previous); } } { "name": "danog/ipc", "description": "IPC component for Amp.", "keywords": [ "asynchronous", "async", "concurrent", "multi-threading", "multi-processing" ], "homepage": "https://github.com/danog/ipc", "license": "MIT", "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Stephen Coakley", "email": "me@stephencoakley.com" } ], "require": { "php": ">=7.1", "amphp/byte-stream": "^1", "amphp/parser": "^1" }, "require-dev": { "amphp/amp": "^2.4", "amphp/parallel": "^1.3", "phpunit/phpunit": "^7 | ^8 | ^9", "amphp/phpunit-util": "^1.3", "amphp/php-cs-fixer-config": "dev-master" }, "autoload": { "psr-4": { "Amp\\Ipc\\": "lib" }, "files": [ "lib/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Ipc\\Test\\": "test" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "php-cs-fixer fix -v --diff --dry-run", "cs-fix": "php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" } } receive()) { echo "Received $payload".PHP_EOL; } echo "Closed connection".PHP_EOL; }; $channel = yield connect(\sys_get_temp_dir().'/test'); asyncCall($clientHandler, $channel); yield $channel->send('ping'); }); receive()) { echo "Received $payload".PHP_EOL; if ($payload === 'ping') { yield $socket->send('pong'); yield $socket->disconnect(); } } echo "Closed connection".PHP_EOL."==========".PHP_EOL; }; $server = listen(\sys_get_temp_dir().'/test'); while ($socket = yield $server->accept()) { asyncCall($clientHandler, $socket); } }); { "name": "danog/magicalserializer", "description": "Serialize Volatile, Threaded or any other internal PHP class!", "type": "library", "license": "AGPL-3.0-only", "homepage": "https://daniil.it/MagicalSerializer", "keywords": ["pthreads", "volatile", "serialize", "threading", "serializable"], "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "autoload": { "psr-0": { "danog\\": "src/" } } } . */ namespace danog; class Serialization { public static $extracted = []; public static function unserialize($data) { foreach (get_declared_classes() as $class) { if (isset(class_uses($class)['danog\Serializable'])) { $namelength = strlen($class); if (strpos($data, 'O:'.$namelength.':"'.$class.'":') === false) { continue; } $data = explode('O:'.$namelength.':"'.$class.'":', $data); $stringdata = array_shift($data); foreach ($data as $chunk) { list($attributecount, $value) = explode(':{', $chunk, 2); $attributecount++; $stringdata .= 'O:17:"danog\PlaceHolder":'.$attributecount.':{s:21:"originalclassnamepony";s:'.$namelength.':"'.$class.'";'.$value; } $data = $stringdata; } } self::$extracted = []; $data = self::extractponyobject(unserialize($data)); self::$extracted = []; return $data; } public static function extractponyobject($orig) { if (isset($orig->realactualponyobject)) { return self::extractponyobject($orig->realactualponyobject); } if (is_array($orig) || $orig instanceof \Volatile) { foreach ($orig as $key => $value) { $orig[$key] = self::extractponyobject($value); } return $orig; } if (is_object($orig) && !isset(self::$extracted[$hash = spl_object_hash($orig)])) { self::$extracted[$hash] = true; foreach ($orig as $key => $value) { $orig->{$key} = self::extractponyobject($value); } } return $orig; } public static function serialize($object, $not_compatible = false) { self::$extracted = []; $object = serialize(self::createserializableobject($object)); self::$extracted = []; if ($not_compatible === true) { return $object; } $object = explode('O:17:"danog\PlaceHolder":', $object); $newobject = array_shift($object); foreach ($object as $chunk) { list($attributecount, $value) = explode(':{', $chunk, 2); $attributecount--; list($pre, $value) = explode('s:21:"originalclassnamepony";s:', $value, 2); list($length, $value) = explode(':', $value, 2); $classname = substr($value, 1, $length); $value = $pre.substr($value, $length + 3); $newobject .= 'O:'.strlen($classname).':"'.$classname.'":'.$attributecount.':{'.$value; } return $newobject; } public static function createserializableobject($orig) { if (is_object($orig) && $orig instanceof \danog\MadelineProto\VoIP) { $orig = false; } if (is_object($orig)) { if (isset(self::$extracted[$hash = spl_object_hash($orig)])) { return self::$extracted[$hash]; } if (method_exists($orig, 'fetchserializableobject')) { return $orig->fetchserializableobject($hash); } self::$extracted[$hash] = $orig; } if (is_array($orig) || $orig instanceof \Volatile) { foreach ($orig as $key => $value) { $orig[$key] = self::createserializableobject($value); } } return $orig; } } . */ namespace danog; trait Serializable { final public function __construct(...$params) { if (count($params) === 1 && is_array($params[0]) && isset($params[0]['originalclassnamepony'])) { unset($params[0]['originalclassnamepony']); foreach ($params[0] as $key => $value) { if (strpos($key, chr(0).get_class($this).chr(0)) === 0) { $key = substr($key, strlen(get_class($this)) + 2); } elseif (strpos($key, chr(0).'*'.chr(0)) === 0) { $key = substr($key, 3); } elseif ($key[0] === "\0") { $key = substr($key, 1); } $this->{$key} = \danog\Serialization::extractponyobject($value); } return; } if (method_exists($this, '__magic_construct')) { $this->__magic_construct(...$params); } elseif (method_exists($this, '___construct')) { $this->___construct(...$params); } } final public function fetchserializableobject($hash) { $values = get_object_vars($this); if (method_exists($this, '__sleep')) { $newvalues = []; foreach ($this->__sleep() as $key) { $newvalues[$key] = $values[$key]; } $values = $newvalues; } return new \danog\PlaceHolder($hash, get_class($this), $values); } } . */ namespace danog; class PlaceHolder { public function __construct($hash, $originalclassnamepony, $elements) { Serialization::$extracted[$hash] = $this; $this->originalclassnamepony = $originalclassnamepony; foreach ($elements as $key => $value) { $this->{$key} = Serialization::createserializableobject($value); } } public function __wakeup() { $this->realactualponyobject = new $this->originalclassnamepony(get_object_vars($this)); if (method_exists($this->realactualponyobject, '__wakeup')) { $this->realactualponyobject->__wakeup(); } } } a = ['lel', ['lel', [new a()]]]; $a->b = new a(); $a->b->c = [new a()]; $a->b->c[0]->d = 'cos'; $a->b->c[0]->e = new b(); $a->b->c[0]->e->f = new a(); $a = [$a]; file_put_contents('test', serialize($a)); var_dump(serialize($a), $a); var_dump(unserialize(file_get_contents('testb'))); . */ namespace danog; use FFI; class PrimeModule { public static function native_single($what) { if (!is_int($what)) { return false; } foreach ([2, 3, 5, 7, 11, 13, 17, 19, 23] as $s) { if ($what % $s === 0) { return $s; } } $g = 0; $it = 0; for ($i = 0; $i < 3 || $it < 1000; $i++) { $t = ((rand(0, 127) & 15) + 17) % $what; $x = (rand() % ($what - 1)) + 1; $y = $x; $lim = 1 << ($i + 18); for ($j = 1; $j <= $lim; $j++) { $it++; $a = $x; $b = $x; $c = $t; while ($b) { if ($b & 1) { $c += $a; if ($c >= $what) { $c -= $what; } } $a += $a; if ($a >= $what) { $a -= $what; } $b >>= 1; } $x = $c; $z = ($x < $y) ? $what + $x - $y : $x - $y; $g = self::gcd($z, $what); if ($g != 1) { break; } if (!($j & ($j - 1))) { $y = $x; } } if ($g > 1 && $g < $what) { break; } } if ($g > 1 && $g < $what) { return $g; } return $what; } public static function native($what) { $res = [self::native_single($what)]; while (array_product($res) !== $what) { $res[] = self::native_single($what / array_product($res)); } return $res; } public static function python_single($what) { if (function_exists('shell_exec')) { $res = trim(shell_exec('timeout 10 python2 '.__DIR__.'/prime.py '.$what.' 2>&1') ?? ''); if ($res == '' || is_null($res) || !is_numeric($res)) { copy(__DIR__.'/prime.py', getcwd().'/.prime.py'); $res = trim(shell_exec('timeout 10 python2 '.getcwd().'/.prime.py '.$what.' 2>&1') ?? ''); unlink(getcwd().'/.prime.py'); if ($res == '' || is_null($res) || !is_numeric($res)) { return false; } } $newval = intval($res); if (is_int($newval)) { $res = $newval; } if ($res === 0) { return false; } return $res; } return false; } public static function python($what) { $res = [self::python_single($what)]; if ($res[0] === false) { return false; } while (array_product($res) !== $what) { $res[] = self::python_single($what / array_product($res)); } return $res; } public static function python_single_alt($what) { if (function_exists('shell_exec')) { $res = trim(shell_exec('python '.__DIR__.'/alt_prime.py '.$what.' 2>&1') ?? ''); if ($res == '' || is_null($res) || !is_numeric($res)) { copy(__DIR__.'/alt_prime.py', getcwd().'/.alt_prime.py'); $res = trim(shell_exec('python '.getcwd().'/.alt_prime.py '.$what.' 2>&1') ?? ''); unlink(getcwd().'/.alt_prime.py'); if ($res == '' || is_null($res) || !is_numeric($res)) { return false; } } $newval = intval($res); if (is_int($newval)) { $res = $newval; } if ($res === 0) { return false; } return $res; } return false; } public static function python_alt($what) { $res = [self::python_single_alt($what)]; if ($res[0] === false) { return false; } while (array_product($res) !== $what) { $res[] = self::python_single_alt($what / array_product($res)); } return $res; } public static function wolfram_single($what) { $query = 'Do prime factorization of '.$what; $params = [ 'async' => true, 'banners' => 'raw', 'debuggingdata' => false, 'format' => 'moutput', 'formattimeout' => 8, 'input' => $query, 'output' => 'JSON', 'proxycode' => json_decode(file_get_contents('http://www.wolframalpha.com/api/v1/code'), true)['code'], ]; $url = 'https://www.wolframalpha.com/input/json.jsp?'.http_build_query($params); $ch = curl_init(); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Referer: https://www.wolframalpha.com/input/?i='.urlencode($query)]); curl_setopt($ch, CURLOPT_URL, $url); $res = json_decode(curl_exec($ch), true); curl_close($ch); $fres = false; if (!isset($res['queryresult']['pods'])) { return false; } foreach ($res['queryresult']['pods'] as $cur) { if ($cur['id'] === 'Divisors') { $fres = explode(', ', preg_replace(["/{\d+, /", "/, \d+}$/"], '', $cur['subpods'][0]['moutput'])); break; } } if (is_array($fres)) { $fres = $fres[0]; $newval = intval($fres); if (is_int($newval)) { $fres = $newval; } return $fres; } return false; } public static function wolfram($what) { $res = [self::wolfram_single($what)]; while (array_product($res) !== $what) { $res[] = self::wolfram_single($what / array_product($res)); } return $res; } private static ?FFI $ffi = null; public static function native_single_cpp($what) { if (!extension_loaded('primemodule')) { if (class_exists(FFI::class)) { try { self::$ffi = FFI::load('/usr/include/primemodule-ffi.h'); $result = self::$ffi->factorizeFFI((string) $what); if ($result > 0) { return $result; } } catch (\Throwable $e) { } return false; } return false; } try { return factorize($what); } catch (\Exception $e) { return false; } } public static function native_cpp($what) { $res = [self::native_single_cpp($what)]; if ($res[0] == false) { return false; } while (($product = array_product($res)) !== $what) { if ($product == 0) { return false; } $res[] = self::native_single_cpp($what / $product); } return $res; } public static function auto_single($what) { $res = self::native_single_cpp($what); if ($res !== false) { return $res; } $res = self::python_single_alt($what); if ($res !== false) { return $res; } $res = self::python_single($what); if ($res !== false) { return $res; } $res = self::native_single((int) $what); if ($res !== false) { return $res; } $res = self::wolfram_single($what); if ($res !== false) { return $res; } return false; } public static function auto($what) { $res = self::native_cpp($what); if (is_array($res)) { return $res; } $res = self::python_alt($what); if (is_array($res)) { return $res; } $res = self::python($what); if (is_array($res)) { return $res; } $res = self::native((int) $what); if (is_array($res)) { return $res; } $res = self::wolfram($what); if (is_array($res)) { return $res; } return false; } private static function gcd($a, $b) { if ($a == $b) { return $a; } while ($b > 0) { list($a, $b) = [$b, self::posmod($a, $b)]; } return $a; } private static function posmod($a, $b) { $resto = $a % $b; if ($resto < 0) { $resto += abs($b); } return $resto; } private function primesbelow($N) { $correction = ($N % 6 > 1) ? true : false; $N_Array = [$N, $N - 1, $N + 4, $N + 3, $N + 2, $N + 1]; $N = $N_Array[$N % 6]; $sieve = []; for ($i = 0; $i < (int) $N / 3; $i++) { $sieve[$i] = true; } $sieve[0] = false; for ($i = 0; $i < (int) ((int) pow($N, 0.5) / 3) + 1; $i++) { if ($sieve[$i]) { $k = (3 * $i + 1) | 1; $startIndex1 = (int) ($k * $k / 3); $period = 2 * $k; for ($j = $startIndex1; $j < count($sieve); $j = $j + $period) { $sieve[$j] = false; } $startIndex2 = (int) (($k * $k + 4 * $k - 2 * $k * ($i % 2)) / 3); $period = 2 * $k; for ($k = $startIndex2; $k < count($sieve); $k = $k + $period) { $sieve[$k] = false; } } } $resultArray = [2, 3]; $t = 1; for ($i = 1; $i < (int) ($N / 3) - $correction; $i++) { if ($sieve[$i]) { $resultArray[$t + 1] = (3 * $i + 1) | 1; $t++; } } return $resultArray; } private function isprime($n, $precision = 7) { $smallprimeset = $this->primesbelow(100000); $_smallprimeset = 100000; if ($n == 1 || $n % 2 == 0) { return false; } elseif ($n < 1) { throw new Exception('Out of bounds, first argument must be > 0'); } elseif ($n < $_smallprimeset) { return in_array($n, $smallprimeset); } $d = $n - 1; $s = 0; while ($d % 2 == 0) { $d = (int) ($d / 2); $s += 1; } for ($i = 0; $i < $precision; $i++) { // random.randrange(2, n - 2) means: // $a = mt_rand(2, $n - 3); // maybe $n would be bigger that PHP_MAX_INT $a = mt_rand(2, 1084); $x = bcpowmod($a, $d, $n); if ($x == 1 || $x == $n - 1) { continue; } $flagfound = 0; for ($j = 0; $j < $s - 1; $j++) { $x = bcpowmod($x, 2, $n); if ($x == 1) { return false; } if ($x == $n - 1) { $flagfound = 1; break; } } if ($flagfound == 0) { return false; } } return true; } private function pollard_brent($n) { $n = (int) $n; if ($n % 2 == 0) { return 2; } if (bcmod($n, 2) == 0) { return 2; } if (bcmod($n, 3) == 0) { return 3; } // $y = mt_rand(1, $n-1); // $c = mt_rand(1, $n-1); // $m = mt_rand(1, $n-1); // Again, $n may be bigger than PHP_MAX_INT // also, small numbers has a big affect in a good performance $y = 2; $c = 3; $m = 4; $g = 1; $r = 1; $q = 1; while ($g == 1) { $x = $y; for ($i = 0; $i < $r; $i++) { // $y = gmp_mod( (bcpowmod($y, 2, $n) + $c) , $n); $y = bcmod((bcpowmod($y, 2, $n) + $c), $n); } $k = 0; while ($k < $r && $g == 1) { $ys = $y; for ($j = 0; $j < min($m, $r - $k); $j++) { // $y = gmp_mod( (bcpowmod($y, 2, $n) + $c), $n ); $y = bcmod((bcpowmod($y, 2, $n) + $c), $n); // $q = gmp_mod($q * abs($x-$y), $n); $mul = bcmul($q, abs($x - $y)); $q = bcmod($mul, $n); } $g = $this->gcd2($q, $n); $k += $m; } $r *= 2; } if ($g == $n) { while (true) { // $ys = ( bcpowmod($ys, 2, $n) + $c ) % $n; $ys = bcmod((bcpowmod($ys, 2, $n) + $c), $n); $g = $this->gcd2(abs($x - $ys), $n); if ($g > 1) { break; } } } return $g; } public function primefactors($n, $sort = false) { $smallprimes = $this->primesbelow(10000); $factors = []; $limit = bcadd(bcsqrt($n), 1); foreach ($smallprimes as $checker) { if ($checker > $limit) { break; } // while (gmp_mod($n, $checker) == 0) { while (bcmod($n, $checker) == 0) { array_push($factors, $checker); $n = bcdiv($n, $checker); $limit = bcadd(bcsqrt($n), 1); if ($checker > $limit) { break; } } } if ($n < 2) { return $factors; } while ($n > 1) { if ($this->isprime($n)) { array_push($factors, $n); break; } $factor = $this->pollard_brent($n); $factors = array_merge($factors, $this->primefactors($factor)); $n = (int) ($n / $factor); } if ($sort) { sort($factors); } return $factors; } private function gcd2($a, $b) { if ($a == $b) { return $a; } while ($b > 0) { $a2 = $a; $a = $b; $b = bcmod($a2, $b); } return $a; } } # NOTICE!!! This is copied from https://stackoverflow.com/questions/4643647/fast-prime-factorization-module import sys import random def primesbelow(N): # http://stackoverflow.com/questions/2068372/fastest-way-to-list-all-primes-below-n-in-python/3035188#3035188 #""" Input N>=6, Returns a list of primes, 2 <= p < N """ correction = N % 6 > 1 N = {0:N, 1:N-1, 2:N+4, 3:N+3, 4:N+2, 5:N+1}[N%6] sieve = [True] * (N // 3) sieve[0] = False for i in range(int(N ** .5) // 3 + 1): if sieve[i]: k = (3 * i + 1) | 1 sieve[k*k // 3::2*k] = [False] * ((N//6 - (k*k)//6 - 1)//k + 1) sieve[(k*k + 4*k - 2*k*(i%2)) // 3::2*k] = [False] * ((N // 6 - (k*k + 4*k - 2*k*(i%2))//6 - 1) // k + 1) return [2, 3] + [(3 * i + 1) | 1 for i in range(1, N//3 - correction) if sieve[i]] smallprimeset = set(primesbelow(100000)) _smallprimeset = 100000 def isprime(n, precision=7): # http://en.wikipedia.org/wiki/Miller-Rabin_primality_test#Algorithm_and_running_time if n == 1 or n % 2 == 0: return False elif n < 1: raise ValueError("Out of bounds, first argument must be > 0") elif n < _smallprimeset: return n in smallprimeset d = n - 1 s = 0 while d % 2 == 0: d //= 2 s += 1 for repeat in range(precision): a = random.randrange(2, n - 2) x = pow(a, d, n) if x == 1 or x == n - 1: continue for r in range(s - 1): x = pow(x, 2, n) if x == 1: return False if x == n - 1: break else: return False return True # https://comeoncodeon.wordpress.com/2010/09/18/pollard-rho-brent-integer-factorization/ def pollard_brent(n): if n % 2 == 0: return 2 if n % 3 == 0: return 3 y, c, m = random.randint(1, n-1), random.randint(1, n-1), random.randint(1, n-1) g, r, q = 1, 1, 1 while g == 1: x = y for i in range(r): y = (pow(y, 2, n) + c) % n k = 0 while k < r and g==1: ys = y for i in range(min(m, r-k)): y = (pow(y, 2, n) + c) % n q = q * abs(x-y) % n g = gcd(q, n) k += m r *= 2 if g == n: while True: ys = (pow(ys, 2, n) + c) % n g = gcd(abs(x - ys), n) if g > 1: break return g smallprimes = primesbelow(10000) # might seem low, but 1000*1000 = 1000000, so this will fully factor every composite < 1000000 def primefactors(n, sort=False): factors = [] limit = int(n ** .5) + 1 for checker in smallprimes: if checker > limit: break while n % checker == 0: factors.append(checker) n //= checker limit = int(n ** .5) + 1 if checker > limit: break if n < 2: return factors while n > 1: if isprime(n): factors.append(n) break factor = pollard_brent(n) # trial division did not fully factor, switch to pollard-brent factors.extend(primefactors(factor)) # recurse to factor the not necessarily prime factor returned by pollard-brent n //= factor if sort: factors.sort() return factors def factorization(n): factors = {} for p1 in primefactors(n): try: factors[p1] += 1 except KeyError: factors[p1] = 1 return factors totients = {} def totient(n): if n == 0: return 1 try: return totients[n] except KeyError: pass tot = 1 for p, exp in factorization(n).items(): tot *= (p - 1) * p ** (exp - 1) totients[n] = tot return tot def gcd(a, b): if a == b: return a while b > 0: a, b = b, a % b return a def lcm(a, b): return abs(a * b) // gcd(a, b) print(primefactors(int(sys.argv[1]))[0])import sys from math import log # Multiple Polynomial Quadratic Sieve def mpqs(n, verbose=False): if verbose: time1 = clock() root_n = isqrt(n) root_2n = isqrt(n+n) # formula chosen by experimentation # seems to be close to optimal for n < 10^50 bound = int(5 * log(n, 10)**2) prime = [] mod_root = [] log_p = [] num_prime = 0 # find a number of small primes for which n is a quadratic residue p = 2 while p < bound or num_prime < 3: # legendre (n|p) is only defined for odd p if p > 2: leg = legendre(n, p) else: leg = n & 1 if leg == 1: prime += [p] mod_root += [int(mod_sqrt(n, p))] log_p += [log(p, 10)] num_prime += 1 elif leg == 0: return p p = next_prime(p) # size of the sieve x_max = len(prime)*60 # maximum value on the sieved range m_val = (x_max * root_2n) >> 1 # fudging the threshold down a bit makes it easier to find powers of primes as factors # as well as partial-partial relationships, but it also makes the smoothness check slower. # there's a happy medium somewhere, depending on how efficient the smoothness check is thresh = log(m_val, 10) * 0.735 # skip small primes. they contribute very little to the log sum # and add a lot of unnecessary entries to the table # instead, fudge the threshold down a bit, assuming ~1/4 of them pass min_prime = int(thresh*3) fudge = sum(log_p[i] for i,p in enumerate(prime) if p < min_prime)/4 thresh -= fudge smooth = [] used_prime = set() partial = {} num_smooth = 0 num_used_prime = 0 num_partial = 0 num_poly = 0 root_A = isqrt(root_2n / x_max) while True: # find an integer value A such that: # A is =~ sqrt(2*n) / x_max # A is a perfect square # sqrt(A) is prime, and n is a quadratic residue mod sqrt(A) while True: root_A = next_prime(root_A) leg = legendre(n, root_A) if leg == 1: break elif leg == 0: return root_A A = root_A * root_A # solve for an adequate B # B*B is a quadratic residue mod n, such that B*B-A*C = n # this is unsolvable if n is not a quadratic residue mod sqrt(A) b = mod_sqrt(n, root_A) B = (b + (n - b*b) * mod_inv(b + b, root_A))%A # B*B-A*C = n <=> C = (B*B-n)/A C = (B*B - n) / A num_poly += 1 # sieve for prime factors sums = [0.0]*(2*x_max) i = 0 for p in prime: if p < min_prime: i += 1 continue logp = log_p[i] inv_A = mod_inv(A, p) # modular root of the quadratic a = int(((mod_root[i] - B) * inv_A)%p) b = int(((p - mod_root[i] - B) * inv_A)%p) k = 0 while k < x_max: if k+a < x_max: sums[k+a] += logp if k+b < x_max: sums[k+b] += logp if k: sums[k-a+x_max] += logp sums[k-b+x_max] += logp k += p i += 1 # check for smooths i = 0 for v in sums: if v > thresh: x = x_max-i if i > x_max else i vec = set() sqr = [] # because B*B-n = A*C # (A*x+B)^2 - n = A*A*x*x+2*A*B*x + B*B - n # = A*(A*x*x+2*B*x+C) # gives the congruency # (A*x+B)^2 = A*(A*x*x+2*B*x+C) (mod n) # because A is chosen to be square, it doesn't need to be sieved val = sieve_val = A*x*x + 2*B*x + C if sieve_val < 0: vec = set([-1]) sieve_val = -sieve_val for p in prime: while sieve_val%p == 0: if p in vec: # keep track of perfect square factors # to avoid taking the sqrt of a gigantic number at the end sqr += [p] vec ^= set([p]) sieve_val = int(sieve_val / p) if sieve_val == 1: # smooth smooth += [(vec, (sqr, (A*x+B), root_A))] used_prime |= vec elif sieve_val in partial: # combine two partials to make a (xor) smooth # that is, every prime factor with an odd power is in our factor base pair_vec, pair_vals = partial[sieve_val] sqr += list(vec & pair_vec) + [sieve_val] vec ^= pair_vec smooth += [(vec, (sqr + pair_vals[0], (A*x+B)*pair_vals[1], root_A*pair_vals[2]))] used_prime |= vec num_partial += 1 else: # save partial for later pairing partial[sieve_val] = (vec, (sqr, A*x+B, root_A)) i += 1 num_smooth = len(smooth) num_used_prime = len(used_prime) if num_smooth > num_used_prime: used_prime_list = sorted(list(used_prime)) # set up bit fields for gaussian elimination masks = [] mask = 1 bit_fields = [0]*num_used_prime for vec, vals in smooth: masks += [mask] i = 0 for p in used_prime_list: if p in vec: bit_fields[i] |= mask i += 1 mask <<= 1 # row echelon form col_offset = 0 null_cols = [] for col in xrange(num_smooth): pivot = col-col_offset == num_used_prime or bit_fields[col-col_offset] & masks[col] == 0 for row in xrange(col+1-col_offset, num_used_prime): if bit_fields[row] & masks[col]: if pivot: bit_fields[col-col_offset], bit_fields[row] = bit_fields[row], bit_fields[col-col_offset] pivot = False else: bit_fields[row] ^= bit_fields[col-col_offset] if pivot: null_cols += [col] col_offset += 1 # reduced row echelon form for row in xrange(num_used_prime): # lowest set bit mask = bit_fields[row] & -bit_fields[row] for up_row in xrange(row): if bit_fields[up_row] & mask: bit_fields[up_row] ^= bit_fields[row] # check for non-trivial congruencies for col in null_cols: all_vec, (lh, rh, rA) = smooth[col] lhs = lh # sieved values (left hand side) rhs = [rh] # sieved values - n (right hand side) rAs = [rA] # root_As (cofactor of lhs) i = 0 for field in bit_fields: if field & masks[col]: vec, (lh, rh, rA) = smooth[i] lhs += list(all_vec & vec) + lh all_vec ^= vec rhs += [rh] rAs += [rA] i += 1 factor = gcd(list_prod(rAs)*list_prod(lhs) - list_prod(rhs), n) if factor != 1 and factor != n: break else: continue break return factor # divide and conquer list product def list_prod(a): size = len(a) if size == 1: return a[0] return list_prod(a[:size>>1]) * list_prod(a[size>>1:]) # greatest common divisor of a and b def gcd(a, b): while b: a, b = b, a%b return a # modular inverse of a mod m def mod_inv(a, m): a = int(a%m) x, u = 0, 1 while a: x, u = u, x - (m/a)*u m, a = a, m%a return x # legendre symbol (a|m) # note: returns m-1 if a is a non-residue, instead of -1 def legendre(a, m): return pow(a, (m-1) >> 1, m) # modular sqrt(n) mod p # p must be prime def mod_sqrt(n, p): a = n%p if p%4 == 3: return pow(a, (p+1) >> 2, p) elif p%8 == 5: v = pow(a << 1, (p-5) >> 3, p) i = ((a*v*v << 1) % p) - 1 return (a*v*i)%p elif p%8 == 1: # Shank's method q = p-1 e = 0 while q&1 == 0: e += 1 q >>= 1 n = 2 while legendre(n, p) != p-1: n += 1 w = pow(a, q, p) x = pow(a, (q+1) >> 1, p) y = pow(n, q, p) r = e while True: if w == 1: return x v = w k = 0 while v != 1 and k+1 < r: v = (v*v)%p k += 1 if k == 0: return x d = pow(y, 1 << (r-k-1), p) x = (x*d)%p y = (d*d)%p w = (w*y)%p r = k else: # p == 2 return a #integer sqrt of n def isqrt(n): n = int(n) c = int(n*4/3) d = c.bit_length() a = d>>1 if d&1: x = 1 << a y = (x + (n >> a)) >> 1 else: x = (3 << a) >> 2 y = (x + (c >> a)) >> 1 if x != y: x = y y = int(x + n/x) >> 1 while y < x: x = y y = int(x + n/x) >> 1 return x # strong probable prime def is_sprp(n, b=2): if n < 2: return False d = n-1 s = 0 while d&1 == 0: s += 1 d >>= 1 x = pow(b, d, n) if x == 1 or x == n-1: return True for r in xrange(1, s): x = (x * x)%n if x == 1: return False elif x == n-1: return True return False # lucas probable prime # assumes D = 1 (mod 4), (D|n) = -1 def is_lucas_prp(n, D): P = 1 Q = (1-D) >> 2 # n+1 = 2**r*s where s is odd s = n+1 r = 0 while s&1 == 0: r += 1 s >>= 1 # calculate the bit reversal of (odd) s # e.g. 19 (10011) <=> 25 (11001) t = 0 while s: if s&1: t += 1 s -= 1 else: t <<= 1 s >>= 1 # use the same bit reversal process to calculate the sth Lucas number # keep track of q = Q**n as we go U = 0 V = 2 q = 1 # mod_inv(2, n) inv_2 = (n+1) >> 1 while t: if t&1: # U, V of n+1 U, V = ((U + V) * inv_2)%n, ((D*U + V) * inv_2)%n q = (q * Q)%n t -= 1 else: # U, V of n*2 U, V = (U * V)%n, (V * V - 2 * q)%n q = (q * q)%n t >>= 1 # double s until we have the 2**r*sth Lucas number while r: U, V = (U * V)%n, (V * V - 2 * q)%n q = (q * q)%n r -= 1 # primality check # if n is prime, n divides the n+1st Lucas number, given the assumptions return U == 0 # primes less than 212 small_primes = set([ 2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, 73, 79, 83, 89, 97,101,103,107,109,113, 127,131,137,139,149,151,157,163,167,173, 179,181,191,193,197,199,211]) # pre-calced sieve of eratosthenes for n = 2, 3, 5, 7 indices = [ 1, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, 73, 79, 83, 89, 97,101,103,107,109,113,121,127,131, 137,139,143,149,151,157,163,167,169,173, 179,181,187,191,193,197,199,209] # distances between sieve values offsets = [ 10, 2, 4, 2, 4, 6, 2, 6, 4, 2, 4, 6, 6, 2, 6, 4, 2, 6, 4, 6, 8, 4, 2, 4, 2, 4, 8, 6, 4, 6, 2, 4, 6, 2, 6, 6, 4, 2, 4, 6, 2, 6, 4, 2, 4, 2,10, 2] max_int = 2147483647 # an 'almost certain' primality check def is_prime(n): if n < 212: return n in small_primes for p in small_primes: if n%p == 0: return False # if n is a 32-bit integer, perform full trial division if n <= max_int: i = 211 while i*i < n: for o in offsets: i += o if n%i == 0: return False return True # Baillie-PSW # this is technically a probabalistic test, but there are no known pseudoprimes if not is_sprp(n, 2): return False # idea shamelessly stolen from Mathmatica # if n is a 2-sprp and a 3-sprp, n is necessarily square-free if not is_sprp(n, 3): return False a = 5 s = 2 # if n is a perfect square, this will never terminate while legendre(a, n) != n-1: s = -s a = s-a return is_lucas_prp(n, a) # next prime strictly larger than n def next_prime(n): if n < 2: return 2 # first odd larger than n n = (n + 1) | 1 if n < 212: while True: if n in small_primes: return n n += 2 # find our position in the sieve rotation via binary search x = int(n%210) s = 0 e = 47 m = 24 while m != e: if indices[m] < x: s = m m = (s + e + 1) >> 1 else: e = m m = (s + e) >> 1 i = int(n + (indices[m] - x)) # adjust offsets offs = offsets[m:] + offsets[:m] while True: for o in offs: if is_prime(i): return i i += o print(mpqs(int(sys.argv[1]))) { "name": "danog/primemodule", "description": "Prime module capable of doing prime factorization of huge numbers very quickly.\"", "type": "library", "license": "AGPL-3.0-only", "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "require": { "php": "^8.0" }, "suggest": { "ext-primemodule": "Install the native C++ extension for extremely fast factorization (https://prime.madelineproto.xyz)" }, "autoload": { "psr-0": { "danog\\": "lib/" } }, "config": { "allow-plugins": { "phabel/phabel": true } }, "require-dev": { "phabel/phabel": "^1" }, "extra": { "phabel": { "revision": 0 } } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test; use danog\Loop\Loop; use danog\Loop\ResumableLoop; use danog\Loop\ResumableSignalLoop; use danog\Loop\SignalLoop; use danog\Loop\Test\Interfaces\BasicInterface; use danog\Loop\Test\Traits\Basic; use danog\Loop\Test\Traits\BasicException; use function Amp\delay; class LoopTest extends Fixtures { /** * Test basic loop. * * @param BasicInterface $loop Loop * * @return \Generator * * @dataProvider provideBasic */ public function testLoop(BasicInterface $loop): \Generator { $this->assertPreStart($loop); $this->assertTrue($loop->start()); $this->assertAfterStart($loop); yield delay(110); $this->assertFinal($loop); } /** * Test basic exception in loop. * * @param BasicInterface $loop Loop * * @return void * * @dataProvider provideBasicExceptions */ public function testException(BasicInterface $loop): void { $this->expectException(\RuntimeException::class); $this->assertPreStart($loop); $this->assertTrue($loop->start()); $this->assertFalse($loop->isRunning()); $this->assertTrue($loop->inited()); $this->assertEquals(1, $loop->startCounter()); $this->assertEquals(1, $loop->endCounter()); } /** * Provide loop implementations. * * @return array */ public function provideBasic(): array { return [ [new class() extends Loop implements BasicInterface { use Basic; }], [new class() extends SignalLoop implements BasicInterface { use Basic; }], [new class() extends ResumableLoop implements BasicInterface { use Basic; }], [new class() extends ResumableSignalLoop implements BasicInterface { use Basic; }] ]; } /** * Provide loop implementations. * * @return array */ public function provideBasicExceptions(): array { return [ [new class() extends Loop implements BasicInterface { use BasicException; }], [new class() extends SignalLoop implements BasicInterface { use BasicException; }], [new class() extends ResumableLoop implements BasicInterface { use BasicException; }], [new class() extends ResumableSignalLoop implements BasicInterface { use BasicException; }] ]; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test; use Amp\PHPUnit\AsyncTestCase; use Amp\Promise; use danog\Loop\Test\Interfaces\BasicInterface; /** * Fixtures. */ abstract class Fixtures extends AsyncTestCase { const LOOP_NAME = 'PONY'; /** * Check if promise has been resolved afterwards. * * @param Promise $promise Promise * * @return boolean */ protected static function isResolved(Promise $promise): bool { $resolved = false; $promise->onResolve(static function ($e, $res) use (&$resolved) { if ($e) { throw $e; } $resolved = true; }); return $resolved; } /** * Execute pre-start assertions. * * @param BasicInterface $loop Loop * * @return void */ protected function assertPreStart(BasicInterface $loop) { $this->assertEquals(self::LOOP_NAME, "$loop"); $this->assertFalse($loop->isRunning()); $this->assertFalse($loop->ran()); $this->assertFalse($loop->inited()); $this->assertEquals(0, $loop->startCounter()); $this->assertEquals(0, $loop->endCounter()); } /** * Execute after-start assertions. * * @param BasicInterface $loop Loop * @param bool $running Whether we should expect the loop to be running * * @return void */ protected function assertAfterStart(BasicInterface $loop, bool $running = true) { $this->assertTrue($loop->inited()); if ($running) { $this->assertFalse($loop->ran()); } $this->assertEquals($running, $loop->isRunning(), $running); $this->assertEquals(1, $loop->startCounter()); $this->assertEquals($running ? 0 : 1, $loop->endCounter()); $this->assertEquals($running, !$loop->start()); } /** * Execute final assertions. * * @param BasicInterface $loop Loop * * @return void */ protected function assertFinal(BasicInterface $loop) { $this->assertTrue($loop->ran()); $this->assertFalse($loop->isRunning()); $this->assertTrue($loop->inited()); $this->assertEquals(1, $loop->startCounter()); $this->assertEquals(1, $loop->endCounter()); } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test; use Amp\Loop; use danog\Loop\ResumableSignalLoop; use danog\Loop\SignalLoop; use danog\Loop\Test\Interfaces\SignalInterface; use danog\Loop\Test\Traits\Signal; use function Amp\delay; class SignalTest extends Fixtures { /** * Test signaling loop. * * @param SignalInterface $loop Loop * * @return \Generator * * @dataProvider provideSignal */ public function testSignal(SignalInterface $loop): \Generator { $loop->setInterval(500); // Wait 0.5 seconds before returning null $this->assertPreStart($loop); $this->assertTrue($loop->start()); $this->assertAfterStart($loop); $loop->signal(true); $this->assertTrue($loop->getPayload()); $this->assertAfterStart($loop); $loop->signal(false); $this->assertFalse($loop->getPayload()); $this->assertAfterStart($loop); $loop->signal(null); $this->assertNull($loop->getPayload()); $this->assertAfterStart($loop); $loop->signal("test"); $this->assertEquals("test", $loop->getPayload()); $this->assertAfterStart($loop); $loop->signal($obj = new class { }); $this->assertEquals($obj, $loop->getPayload()); $this->assertAfterStart($loop); $loop->setInterval(100); // Wait 0.1 seconds before returning null $loop->signal(true); // Move along loop to apply new interval yield delay(110); $this->assertNull($loop->getPayload()); // Result of sleep $loop->signal($e = new \RuntimeException('Test')); $this->assertEquals($e, $loop->getException()); $this->assertFinal($loop); $loop = null; } /** * Provide resumable loop implementations. * * @return array */ public function provideSignal(): array { return [ [new class() extends SignalLoop implements SignalInterface { use Signal; }], [new class() extends ResumableSignalLoop implements SignalInterface { use Signal; }], ]; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test; use Amp\PHPUnit\AsyncTestCase; use Amp\Promise; use Amp\Success; use danog\Loop\Generic\GenericLoop; use danog\Loop\Loop; use danog\Loop\Test\Interfaces\LoggingPauseInterface; use danog\Loop\Test\Traits\Basic; use danog\Loop\Test\Traits\LoggingPause; use function Amp\delay; class GenericTest extends AsyncTestCase { /** * Test basic loop. * * @param bool $stopSig Whether to stop with signal * * @return \Generator * * @dataProvider provideTrueFalse */ public function testGeneric(bool $stopSig): \Generator { $runCount = 0; $pauseTime = GenericLoop::PAUSE; $callable = function () use (&$runCount, &$pauseTime, &$zis) { $zis = $this; $runCount++; return $pauseTime; }; yield from $this->fixtureAssertions($callable, $runCount, $pauseTime, $stopSig, $zis, true); $obj = new class() { public $pauseTime = GenericLoop::PAUSE; public $runCount = 0; public function run() { $this->runCount++; return $this->pauseTime; } }; yield from $this->fixtureAssertions([$obj, 'run'], $obj->runCount, $obj->pauseTime, $stopSig, $zisNew, false); $obj = new class() { public $pauseTime = GenericLoop::PAUSE; public $runCount = 0; public function run() { $this->runCount++; return $this->pauseTime; } }; yield from $this->fixtureAssertions(\Closure::fromCallable([$obj, 'run']), $obj->runCount, $obj->pauseTime, $stopSig, $zisNew, false); } /** * Test generator loop. * * @param bool $stopSig Whether to stop with signal * * @return \Generator * * @dataProvider provideTrueFalse */ public function testGenerator(bool $stopSig): \Generator { $runCount = 0; $pauseTime = GenericLoop::PAUSE; $callable = function () use (&$runCount, &$pauseTime, &$zis): \Generator { $zis = $this; yield delay(1); $runCount++; return $pauseTime; }; yield from $this->fixtureAssertions($callable, $runCount, $pauseTime, $stopSig, $zis, true); $obj = new class() { public $pauseTime = GenericLoop::PAUSE; public $runCount = 0; public function run(): \Generator { yield delay(1); $this->runCount++; return $this->pauseTime; } }; yield from $this->fixtureAssertions([$obj, 'run'], $obj->runCount, $obj->pauseTime, $stopSig, $zisNew, false); $obj = new class() { public $pauseTime = GenericLoop::PAUSE; public $runCount = 0; public function run(): \Generator { yield delay(1); $this->runCount++; return $this->pauseTime; } }; yield from $this->fixtureAssertions(\Closure::fromCallable([$obj, 'run']), $obj->runCount, $obj->pauseTime, $stopSig, $zisNew, false); } /** * Test promise loop. * * @param bool $stopSig Whether to stop with signal * * @return \Generator * * @dataProvider provideTrueFalse */ public function testPromise(bool $stopSig): \Generator { $runCount = 0; $pauseTime = GenericLoop::PAUSE; $callable = function () use (&$runCount, &$pauseTime, &$zis): Promise { $zis = $this; $runCount++; return new Success($pauseTime); }; yield from $this->fixtureAssertions($callable, $runCount, $pauseTime, $stopSig, $zis, true); $obj = new class() { public $pauseTime = GenericLoop::PAUSE; public $runCount = 0; public function run(): Promise { $this->runCount++; return new Success($this->pauseTime); } }; yield from $this->fixtureAssertions([$obj, 'run'], $obj->runCount, $obj->pauseTime, $stopSig, $zisNew, false); $obj = new class() { public $pauseTime = GenericLoop::PAUSE; public $runCount = 0; public function run(): Promise { $this->runCount++; return new Success($this->pauseTime); } }; yield from $this->fixtureAssertions(\Closure::fromCallable([$obj, 'run']), $obj->runCount, $obj->pauseTime, $stopSig, $zisNew, false); } /** * Fixture assertions for started loop. * * @param LoggingPauseInterface $loop Loop * * @return void */ private function fixtureStarted(LoggingPauseInterface $loop): void { $this->assertTrue($loop->isRunning()); $this->assertEquals(1, $loop->startCounter()); $this->assertEquals(0, $loop->endCounter()); } /** * Run fixture assertions. * * @param callable $closure Closure * @param integer $runCount Run count * @param ?integer $pauseTime Pause time * @param bool $stopSig Whether to stop with signal * @param bool $zis Reference to closure's this * @param bool $checkZis Whether to check zis * * @return \Generator */ private function fixtureAssertions(callable $closure, int &$runCount, ?int &$pauseTime, bool $stopSig, &$zis, bool $checkZis): \Generator { $loop = new class($closure, Fixtures::LOOP_NAME) extends GenericLoop implements LoggingPauseInterface { use LoggingPause; }; $this->assertEquals(Fixtures::LOOP_NAME, "$loop"); $this->assertFalse($loop->isRunning()); $this->assertEquals(0, $loop->startCounter()); $this->assertEquals(0, $loop->endCounter()); $this->assertEquals(0, $runCount); $this->assertEquals(0, $loop->getPauseCount()); $loop->start(); yield delay(2); if ($checkZis) { $this->assertEquals($loop, $zis); } else { $this->assertNull($zis); } $this->fixtureStarted($loop); $this->assertEquals(1, $runCount); $this->assertEquals(1, $loop->getPauseCount()); $this->assertEquals(0, $loop->getLastPause()); $pauseTime = 100; $loop->resume(); yield delay(2); $this->fixtureStarted($loop); $this->assertEquals(2, $runCount); $this->assertEquals(2, $loop->getPauseCount()); $this->assertEquals(100, $loop->getLastPause()); yield delay(48); $this->fixtureStarted($loop); $this->assertEquals(2, $runCount); $this->assertEquals(2, $loop->getPauseCount()); $this->assertEquals(100, $loop->getLastPause()); yield delay(60); $this->fixtureStarted($loop); $this->assertEquals(3, $runCount); $this->assertEquals(3, $loop->getPauseCount()); $this->assertEquals(100, $loop->getLastPause()); $loop->resume(); yield delay(1); $this->assertEquals(4, $runCount); $this->assertEquals(4, $loop->getPauseCount()); $this->assertEquals(100, $loop->getLastPause()); if ($stopSig) { $loop->signal(true); } else { $pauseTime = GenericLoop::STOP; $loop->resume(); } yield delay(1); $this->assertEquals($stopSig ? 4 : 5, $runCount); $this->assertEquals(4, $loop->getPauseCount()); $this->assertEquals(100, $loop->getLastPause()); $this->assertFalse($loop->isRunning()); $this->assertEquals(1, $loop->startCounter()); $this->assertEquals(1, $loop->endCounter()); } /** * Provide true false. * * @return array */ public function provideTrueFalse(): array { return [ [true], [false] ]; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test; use Amp\PHPUnit\AsyncTestCase; use Amp\Promise; use Amp\Success; use danog\Loop\Generic\PeriodicLoop; use danog\Loop\Loop; use danog\Loop\Test\Interfaces\LoggingInterface; use danog\Loop\Test\Traits\Basic; use danog\Loop\Test\Traits\Logging; use function Amp\delay; class PeriodicTest extends AsyncTestCase { /** * Test basic loop. * * @param bool $stopSig Whether to stop with signal * * @return \Generator * * @dataProvider provideTrueFalse */ public function testGeneric(bool $stopSig): \Generator { $runCount = 0; $retValue = false; $callable = function () use (&$runCount, &$retValue, &$zis) { $zis = $this; $runCount++; return $retValue; }; yield from $this->fixtureAssertions($callable, $runCount, $retValue, $stopSig, $zis, true); $obj = new class() { public $retValue = false; public $runCount = 0; public function run() { $this->runCount++; return $this->retValue; } }; yield from $this->fixtureAssertions([$obj, 'run'], $obj->runCount, $obj->retValue, $stopSig, $zisNew, false); $obj = new class() { public $retValue = false; public $runCount = 0; public function run() { $this->runCount++; return $this->retValue; } }; yield from $this->fixtureAssertions(\Closure::fromCallable([$obj, 'run']), $obj->runCount, $obj->retValue, $stopSig, $zisNew, false); } /** * Test generator loop. * * @param bool $stopSig Whether to stop with signal * * @return \Generator * * @dataProvider provideTrueFalse */ public function testGenerator(bool $stopSig): \Generator { $runCount = 0; $retValue = false; $callable = function () use (&$runCount, &$retValue, &$zis): \Generator { $zis = $this; yield delay(1); $runCount++; return $retValue; }; yield from $this->fixtureAssertions($callable, $runCount, $retValue, $stopSig, $zis, true); $obj = new class() { public $retValue = false; public $runCount = 0; public function run(): \Generator { yield delay(1); $this->runCount++; return $this->retValue; } }; yield from $this->fixtureAssertions([$obj, 'run'], $obj->runCount, $obj->retValue, $stopSig, $zisNew, false); $obj = new class() { public $retValue = false; public $runCount = 0; public function run(): \Generator { yield delay(1); $this->runCount++; return $this->retValue; } }; yield from $this->fixtureAssertions(\Closure::fromCallable([$obj, 'run']), $obj->runCount, $obj->retValue, $stopSig, $zisNew, false); } /** * Test promise loop. * * @param bool $stopSig Whether to stop with signal * * @return \Generator * * @dataProvider provideTrueFalse */ public function testPromise(bool $stopSig): \Generator { $runCount = 0; $retValue = false; $callable = function () use (&$runCount, &$retValue, &$zis): Promise { $zis = $this; $runCount++; return new Success($retValue); }; yield from $this->fixtureAssertions($callable, $runCount, $retValue, $stopSig, $zis, true); $obj = new class() { public $retValue = false; public $runCount = 0; public function run(): Promise { $this->runCount++; return new Success($this->retValue); } }; yield from $this->fixtureAssertions([$obj, 'run'], $obj->runCount, $obj->retValue, $stopSig, $zisNew, false); $obj = new class() { public $retValue = false; public $runCount = 0; public function run(): Promise { $this->runCount++; return new Success($this->retValue); } }; yield from $this->fixtureAssertions(\Closure::fromCallable([$obj, 'run']), $obj->runCount, $obj->retValue, $stopSig, $zisNew, false); } /** * Fixture assertions for started loop. * * @param LoggingInterface $loop Loop * * @return void */ private function fixtureStarted(LoggingInterface $loop): void { $this->assertTrue($loop->isRunning()); $this->assertEquals(1, $loop->startCounter()); $this->assertEquals(0, $loop->endCounter()); } /** * Run fixture assertions. * * @param callable $closure Closure * @param integer $runCount Run count * @param bool $retValue Pause time * @param bool $stopSig Whether to stop with signal * @param bool $zis Reference to closure's this * @param bool $checkZis Whether to check zis * * @return \Generator */ private function fixtureAssertions(callable $closure, int &$runCount, bool &$retValue, bool $stopSig, &$zis, bool $checkZis): \Generator { $loop = new class($closure, Fixtures::LOOP_NAME, 100) extends PeriodicLoop implements LoggingInterface { use Logging; }; $this->assertEquals(Fixtures::LOOP_NAME, "$loop"); $this->assertFalse($loop->isRunning()); $this->assertEquals(0, $loop->startCounter()); $this->assertEquals(0, $loop->endCounter()); $this->assertEquals(0, $runCount); $loop->start(); yield delay(2); if ($checkZis) { $this->assertEquals($loop, $zis); } else { $this->assertNull($zis); } $this->fixtureStarted($loop); $this->assertEquals(1, $runCount); yield delay(48); $this->fixtureStarted($loop); $this->assertEquals(1, $runCount); yield delay(60); $this->fixtureStarted($loop); $this->assertEquals(2, $runCount); $loop->resume(); yield delay(1); $this->assertEquals(3, $runCount); if ($stopSig) { $loop->signal(true); } else { $retValue = true; $loop->resume(); } yield delay(1); $this->assertEquals($stopSig ? 3 : 4, $runCount); $this->assertFalse($loop->isRunning()); $this->assertEquals(1, $loop->startCounter()); $this->assertEquals(1, $loop->endCounter()); } /** * Provide true false. * * @return array */ public function provideTrueFalse(): array { return [ [true], [false] ]; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Traits; use danog\Loop\Test\LoopTest; use Generator; use function Amp\delay; trait Basic { use Logging; /** * Check whether the loop inited. * * @var bool */ private $inited = false; /** * Check whether the loop ran. * * @var bool */ private $ran = false; /** * Check whether the loop inited. * * @return boolean */ public function inited(): bool { return $this->inited; } /** * Check whether the loop ran. * * @return boolean */ public function ran(): bool { return $this->ran; } /** * Loop implementation. * * @return Generator */ public function loop(): Generator { $this->inited = true; yield delay(100); $this->ran = true; } /** * Get loop name. * * @return string */ public function __toString(): string { return LoopTest::LOOP_NAME; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Traits; use danog\Loop\Interfaces\ResumableLoopInterface; use Generator; use function Amp\delay; trait Signal { use Resumable; /** * Signaled payload. * * @var mixed */ private $payload; /** * Signaled exception. * * @var ?\Throwable */ private $exception; /** * Get signaled payload. * * @return mixed */ public function getPayload() { return $this->payload; } /** * Get signaled exception. * * @return \Throwable */ public function getException(): ?\Throwable { return $this->exception; } /** * Test waiting signal on interval. * * @param integer $interval Interval * * @return \Generator */ private function testGenerator(int $interval): \Generator { yield delay($interval); } /** * Loop implementation. * * @return Generator */ public function loop(): Generator { $this->inited = true; try { while (true) { $this->payload = yield $this->waitSignal($this instanceof ResumableLoopInterface ? $this->pause($this->interval) : $this->testGenerator($this->interval)); } } catch (\Throwable $e) { $this->exception = $e; } $this->ran = true; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Traits; trait Logging { /** * Check whether the loop started. * * @var int */ private $startCounter = 0; /** * Check whether the loop ended. * * @var int */ private $endCounter = 0; /** * Signal that loop started. * * @return void */ protected function startedLoop(): void { $this->startCounter++; parent::startedLoop(); } /** * Signal that loop ended. * * @return void */ protected function exitedLoop(): void { $this->endCounter++; parent::exitedLoop(); } /** * Get start counter. * * @return integer */ public function startCounter(): int { return $this->startCounter; } /** * Get end counter. * * @return integer */ public function endCounter(): int { return $this->endCounter; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Traits; use function Amp\delay; trait LoggingPause { use Logging; /** * Number of times loop was paused. * * @var integer */ private $pauseCount = 0; /** * Last pause delay. * * @var int */ private $lastPause = 0; /** * Get number of times loop was paused. * * @return integer */ public function getPauseCount(): int { return $this->pauseCount; } /** * Get last pause. * * @return integer */ public function getLastPause(): int { return $this->lastPause; } /** * Report pause, can be overriden for logging. * * @param integer $timeout Pause duration, 0 = forever * * @return void */ protected function reportPause(int $timeout): void { parent::reportPause($timeout); $this->pauseCount++; $this->lastPause= $timeout; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Traits; use Generator; trait Resumable { use Basic; /** * Set interval. * * @var ?int */ protected $interval = 100; /** * Set sleep interval. * * @param ?int $interval Interval * * @return void */ public function setInterval(?int $interval): void { $this->interval = $interval; } /** * Loop implementation. * * @return Generator */ public function loop(): Generator { $this->inited = true; yield $this->pause($this->interval); $this->ran = true; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Traits; use Generator; trait BasicException { use Basic; /** * Loop implementation. * * @return Generator */ public function loop(): Generator { $this->inited = true; throw new \RuntimeException('Threw exception!'); $this->ran = true; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test; use danog\Loop\Interfaces\ResumableLoopInterface; use danog\Loop\ResumableLoop; use danog\Loop\ResumableSignalLoop; use danog\Loop\Test\Interfaces\ResumableInterface; use danog\Loop\Test\Traits\Resumable; use function Amp\delay; class ResumableTest extends Fixtures { /** * Test pausing loop. * * @param ResumableInterface $loop Loop * * @return \Generator * * @dataProvider provideResumable */ public function testResumable(ResumableInterface $loop): \Generator { $paused = $loop->resume(); // Returned promise will resolve on next pause $this->assertPreStart($loop); $this->assertTrue($loop->start()); $this->assertAfterStart($loop); yield delay(10); $this->assertTrue(self::isResolved($paused)); yield delay(100); $this->assertFinal($loop); } /** * Test pausing loop with negative value. * * @param ResumableInterface $loop Loop * * @return \Generator * * @dataProvider provideResumable */ public function testResumableNegative(ResumableInterface $loop) { $paused = $loop->resume(); // Will resolve on next pause $loop->setInterval(-1); // Will not pause, and finish right away! $this->assertPreStart($loop); $this->assertTrue($loop->start()); yield delay(1); $this->assertFalse(self::isResolved($paused)); // Did not pause // Invert the order as the afterTest assertions will begin the test anew $this->assertFinal($loop); $this->assertAfterStart($loop, false); } /** * Test pausing loop forever, or for 10 seconds, prematurely resuming it. * * @param ResumableInterface $loop Loop * @param ?int $interval Interval * @param bool $deferred Deferred * * @return \Generator * * @dataProvider provideResumableInterval */ public function testResumableForeverPremature(ResumableInterface $loop, ?int $interval, bool $deferred): \Generator { $paused = $deferred ? $loop->resumeDefer() : $loop->resume(); // Will resolve on next pause if ($deferred) { yield delay(1); // Avoid resuming after starting } $loop->setInterval($interval); $this->assertPreStart($loop); $this->assertTrue($loop->start()); $this->assertAfterStart($loop); yield delay(1); $this->assertTrue(self::isResolved($paused)); // Did pause $paused = $deferred ? $loop->resumeDefer() : $loop->resume(); if ($deferred) { $this->assertAfterStart($loop); yield delay(1); } $this->assertFinal($loop); yield delay(1); $this->assertFalse(self::isResolved($paused)); // Did not pause again } /** * Test pausing loop and then resuming it with deferOnce. * * @param ResumableInterface $loop Loop * * @return \Generator * * @dataProvider provideResumable */ public function testResumableDeferOnce(ResumableInterface $loop): \Generator { $paused1 = $loop->resumeDeferOnce(); // Will resolve on next pause $paused2 = $loop->resumeDeferOnce(); // Will resolve on next pause yield delay(1); // Avoid resuming after starting $loop->setInterval(10000); $this->assertPreStart($loop); $this->assertTrue($loop->start()); $this->assertAfterStart($loop); yield delay(1); $this->assertTrue(self::isResolved($paused1)); // Did pause $this->assertTrue(self::isResolved($paused2)); // Did pause $paused1 = $loop->resumeDeferOnce(); $paused2 = $loop->resumeDeferOnce(); $this->assertAfterStart($loop); yield delay(1); $this->assertFinal($loop); yield delay(1); $this->assertFalse(self::isResolved($paused1)); // Did not pause again $this->assertFalse(self::isResolved($paused2)); // Did not pause again } /** * Provide resumable loop implementations. * * @return array * * @psalm-return array> */ public function provideResumable(): array { return [ [new class() extends ResumableLoop implements ResumableInterface, ResumableLoopInterface { use Resumable; }], [new class() extends ResumableSignalLoop implements ResumableInterface, ResumableLoopInterface { use Resumable; }], ]; } /** * Provide resumable loop implementations and interval. * * @return \Generator */ public function provideResumableInterval(): \Generator { foreach ([true, false] as $deferred) { foreach ([10000, null] as $interval) { foreach ($this->provideResumable() as $params) { $params[] = $interval; $params[] = $deferred; yield $params; } } } } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Interfaces; use danog\Loop\Interfaces\SignalLoopInterface; /** * Signal loop test interface. * * @author Daniil Gentili */ interface SignalInterface extends BasicInterface, IntervalInterface, SignalLoopInterface { /** * Get signaled payload. * * @return mixed */ public function getPayload(); /** * Get signaled exception. * * @return ?\Throwable */ public function getException(): ?\Throwable; } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Interfaces; use danog\Loop\Interfaces\ResumableLoopInterface; /** * Resumable loop test interface. * * @author Daniil Gentili */ interface ResumableInterface extends BasicInterface, IntervalInterface, ResumableLoopInterface { } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Interfaces; use danog\Loop\Interfaces\LoopInterface; /** * Basic loop test interface. * * @author Daniil Gentili */ interface BasicInterface extends LoopInterface, LoggingInterface { /** * Check whether the loop inited. * * @return boolean */ public function inited(): bool; /** * Check whether the loop ran. * * @return boolean */ public function ran(): bool; } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Interfaces; /** * Resumable loop test interface. * * @author Daniil Gentili */ interface IntervalInterface { /** * Set sleep interval. * * @param ?int $interval Interval * * @return void */ public function setInterval(?int $interval): void; } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Interfaces; use danog\Loop\Interfaces\LoopInterface; /** * Basic loop test interface. * * @author Daniil Gentili */ interface LoggingPauseInterface extends LoopInterface, LoggingInterface { /** * Get number of times loop was paused. * * @return integer */ public function getPauseCount(): int; /** * Get last pause. * * @return integer */ public function getLastPause(): int; } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Test\Interfaces; use danog\Loop\Interfaces\LoopInterface; /** * Basic loop test interface. * * @author Daniil Gentili */ interface LoggingInterface extends LoopInterface { /** * Get start counter. * * @return integer */ public function startCounter(): int; /** * Get end counter. * * @return integer */ public function endCounter(): int; } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop; use danog\Loop\Interfaces\ResumableLoopInterface; use danog\Loop\Interfaces\SignalLoopInterface; use danog\Loop\Traits\ResumableLoop; use danog\Loop\Traits\SignalLoop; /** * Resumable signal loop abstract class. * * @author Daniil Gentili */ abstract class ResumableSignalLoop implements ResumableLoopInterface, SignalLoopInterface { use ResumableLoop; use SignalLoop; } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop; use danog\Loop\Interfaces\ResumableLoopInterface; use danog\Loop\Traits\ResumableLoop as TraitsResumableLoop; /** * Resumable loop abstract class. * * @author Daniil Gentili */ abstract class ResumableLoop implements ResumableLoopInterface { use TraitsResumableLoop; } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop; use danog\Loop\Interfaces\SignalLoopInterface; use danog\Loop\Traits\Loop; use danog\Loop\Traits\SignalLoop as TraitsSignalLoop; /** * Signal loop abstract class. * * @author Daniil Gentili */ abstract class SignalLoop implements SignalLoopInterface { use Loop; use TraitsSignalLoop; } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Generic; use Amp\Promise; use danog\Loop\ResumableSignalLoop; /** * Generic loop, runs single callable. * * The return value of the callable can be: * * A number - the loop will be paused for the specified number of seconds * * GenericLoop::STOP - The loop will stop * * GenericLoop::PAUSE - The loop will pause forever (or until loop is `resumed()` * from outside the loop) * * GenericLoop::CONTINUE - Return this if you want to rerun the loop immediately * * If the callable does not return anything, * the loop will behave is if GenericLoop::PAUSE was returned. * * The loop can be stopped from the outside by signaling `true`. * * @template T as int|null * @template TGenerator as \Generator,mixed,Promise|T> * @template TPromise as Promise * * @template TCallable as T|TPromise|TGenerator * * @author Daniil Gentili */ class GenericLoop extends ResumableSignalLoop { /** * Stop the loop. */ const STOP = -1; /** * Pause the loop. */ const PAUSE = null; /** * Rerun the loop. */ const CONTINUE = 0; /** * Callable. * * @var callable * * @psalm-var callable():TCallable */ protected $callable; /** * Loop name. * * @var string */ protected $name; /** * Constructor. * * If possible, the callable will be bound to the current instance of the loop. * * @param callable $callable Callable to run * @param string $name Loop name * * @psalm-param callable():TCallable $callable Callable to run */ public function __construct(callable $callable, string $name) { if ($callable instanceof \Closure) { try { $callable = $callable->bindTo($this); } catch (\Throwable $e) { // Might cause an error for wrapped object methods } } $this->callable = $callable; $this->name = $name; } /** * Loop implementation. * * @return \Generator */ public function loop(): \Generator { $callable = $this->callable; while (true) { /** @psalm-var ?int|TGenerator|TPromise */ $timeout = $callable(); if ($timeout instanceof \Generator) { /** @psalm-var ?int */ $timeout = yield from $timeout; } elseif ($timeout instanceof Promise) { /** @psalm-var ?int */ $timeout = yield $timeout; } if ($timeout === self::PAUSE) { $this->reportPause(0); } elseif ($timeout > 0) { $this->reportPause($timeout); } /** @psalm-suppress MixedArgument */ if ($timeout === self::STOP || yield $this->waitSignal($this->pause($timeout))) { break; } } } /** * Report pause, can be overriden for logging. * * @param integer $timeout Pause duration, 0 = forever * * @return void */ protected function reportPause(int $timeout): void { } /** * Get loop name, provided to constructor. * * @return string */ public function __toString(): string { return $this->name; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Generic; use Amp\Promise; use danog\Loop\ResumableSignalLoop; /** * Periodic loop. * * Runs a callback at a periodic interval. * * The loop can be stopped from the outside or * from the inside by signaling or returning `true`. * * @template T as bool * @template TGenerator as \Generator,mixed,Promise|T> * @template TPromise as Promise * * @template TCallable as T|TPromise|TGenerator * * @author Daniil Gentili */ class PeriodicLoop extends ResumableSignalLoop { /** * Callback. * * @var callable * * @psalm-var callable():TCallable */ private $callback; /** * Loop name. * * @var string */ private $name; /** * Loop interval. * * @var ?int */ private $interval; /** * Constructor. * * If possible, the callable will be bound to the current instance of the loop. * * @param callable $callback Callback to call * @param string $name Loop name * @param ?int $interval Loop interval * * @psalm-param callable():TCallable $callback Callable to run */ public function __construct(callable $callback, string $name, ?int $interval) { if ($callback instanceof \Closure) { try { $callback = $callback->bindTo($this); } catch (\Throwable $e) { // Might cause an error for wrapped object methods } } $this->callback = $callback; $this->name = $name; $this->interval = $interval; } /** * Loop implementation. * * @return \Generator */ public function loop(): \Generator { $callback = $this->callback; while (true) { $result = $callback(); if ($result instanceof \Generator) { /** @psalm-var TGenerator */ $result = yield from $result; } elseif ($result instanceof Promise) { /** @psalm-var TPromise */ $result = yield $result; } if ($result === true) { break; } /** @var ?bool */ $result = yield $this->waitSignal($this->pause($this->interval)); if ($result === true) { break; } } } /** * Get name of the loop, passed to the constructor. * * @return string */ public function __toString(): string { return $this->name; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop; use danog\Loop\Interfaces\LoopInterface; use danog\Loop\Traits\Loop as TraitsLoop; /** * Loop abstract class. * * @author Daniil Gentili */ abstract class Loop implements LoopInterface { use TraitsLoop; } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Traits; use Amp\Deferred; use Amp\Loop as AmpLoop; use Amp\Promise; use Amp\Success; use Closure; /** * Resumable loop helper trait. * * @author Daniil Gentili */ trait ResumableLoop { use Loop { exitedLoop as private parentExitedLoop; } /** * Resume deferred. * * @var ?Deferred */ private $resume; /** * Pause deferred. * * @var ?Deferred */ private $pause; /** * Resume timer ID. * * @var ?string */ private $resumeTimer; /** * Resume deferred ID. * * @var ?string */ private $resumeDeferred; /** * Pause the loop. * * @param ?int $time For how long to pause the loop, if null will pause forever (until resume is called from outside of the loop) * * @return Promise Resolved when the loop is resumed */ public function pause(?int $time = null): Promise { if (!\is_null($time)) { if ($time <= 0) { return new Success(0); } if ($this->resumeTimer) { AmpLoop::cancel($this->resumeTimer); $this->resumeTimer = null; } /** @psalm-suppress MixedArgumentTypeCoercion */ $this->resumeTimer = AmpLoop::delay($time, \Closure::fromCallable([$this, 'resumeInternal'])); } $pause = $this->pause; $this->pause = new Deferred(); if ($pause) { /** * @psalm-suppress InvalidArgument */ AmpLoop::defer([$pause, 'resolve']); } $this->resume = new Deferred(); return $this->resume->promise(); } /** * Resume the loop. * * @return Promise Resolved when the loop is paused again */ public function resume(): Promise { if (!$this->pause) { $this->pause = new Deferred; } $promise = $this->pause->promise(); $this->resumeInternal(); return $promise; } /** * Defer resuming the loop to next tick. * * @return Promise Resolved when the loop is paused again */ public function resumeDefer(): Promise { /** @psalm-suppress MixedArgumentTypeCoercion */ AmpLoop::defer(Closure::fromCallable([$this, 'resumeInternal'])); if (!$this->pause) { $this->pause = new Deferred; } return $this->pause->promise(); } /** * Defer resuming the loop to next tick. * * Multiple consecutive calls will yield only one resume. * * @return Promise Resolved when the loop is paused again */ public function resumeDeferOnce(): Promise { if (!$this->resumeDeferred) { $this->resumeDeferred = AmpLoop::defer(function () { $this->resumeDeferred = null; $this->resumeInternal(); }); } if (!$this->pause) { $this->pause = new Deferred; } return $this->pause->promise(); } /** * Internal resume function. * * @return void */ private function resumeInternal(): void { if ($this->resumeTimer) { $storedWatcherId = $this->resumeTimer; AmpLoop::cancel($storedWatcherId); $this->resumeTimer = null; } if ($this->resume) { $resume = $this->resume; $this->resume = null; $resume->resolve(); } } /** * Signal that loop has exIited. * * @return void */ protected function exitedLoop(): void { $this->parentExitedLoop(); if ($this->resumeTimer) { AmpLoop::cancel($this->resumeTimer); $this->resumeTimer = null; } } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Traits; use Amp\Coroutine; use Amp\Deferred; use Amp\Promise; /** * Signal loop helper trait. * * @author Daniil Gentili */ trait SignalLoop { /** * Signal deferred. * * @var ?Deferred */ private $signalDeferred; /** * Send signal to loop. * * @param mixed|\Throwable $what Data to signal * * @return void */ public function signal($what): void { if ($this->signalDeferred) { $deferred = $this->signalDeferred; $this->signalDeferred = null; if ($what instanceof \Throwable) { $deferred->fail($what); } else { $deferred->resolve($what); } } } /** * Resolve the promise or return|throw the signal. * * @param Promise|\Generator $promise The original promise or generator * * @return Promise * * @template T * * @psalm-param Promise|\Generator,mixed,Promise|T> $promise The original promise or generator * * @psalm-return Promise */ public function waitSignal($promise): Promise { if ($promise instanceof \Generator) { /** @psalm-suppress MixedArgumentTypeCoercion */ $promise = new Coroutine($promise); } $this->signalDeferred = new Deferred(); $combinedPromise = $this->signalDeferred->promise(); $promise->onResolve( function () use ($promise) { if ($this->signalDeferred !== null) { $deferred = $this->signalDeferred; $this->signalDeferred = null; $deferred->resolve($promise); } } ); return $combinedPromise; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Traits; use Amp\Promise; use function Amp\asyncCall; /** * Loop helper trait. * * Wraps the asynchronous generator methods with asynchronous promise-based methods * * @author Daniil Gentili */ trait Loop { /** * Whether the loop was started. * * @var bool */ private $started = false; /** * Start the loop. * * Returns false if the loop is already running. * * @return bool */ public function start(): bool { if ($this->started) { return false; } asyncCall(function (): \Generator { $this->startedLoop(); try { yield from $this->loop(); } finally { $this->exitedLoop(); } }); return true; } /** * Signal that loop has exIited. * * @return void */ protected function exitedLoop(): void { $this->started = false; } /** * Signal that loop has started. * * @return void */ protected function startedLoop(): void { $this->started = true; } /** * Check whether loop is running. * * @return boolean */ public function isRunning(): bool { return $this->started; } } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Interfaces; /** * Loop interface. * * @author Daniil Gentili */ interface LoopInterface { /** * Start the loop. * * Returns false if the loop is already running. * * @return bool */ public function start(): bool; /** * The actual loop function. * * @return \Generator */ public function loop(): \Generator; /** * Get name of the loop. * * @return string */ public function __toString(): string; /** * Check whether loop is running. * * @return boolean */ public function isRunning(): bool; } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Interfaces; use Amp\Promise; /** * Signal loop interface. * * @author Daniil Gentili */ interface SignalLoopInterface extends LoopInterface { /** * Send a signal to the the loop. * * @param \Throwable|mixed $data Signal to send * * @return void */ public function signal($data): void; /** * Resolve the promise or return|throw the signal. * * @param Promise|\Generator $promise The original promise or generator * * @return Promise * * @template T * * @psalm-param Promise|\Generator,mixed,Promise|T> $promise The original promise or generator * * @psalm-return Promise */ public function waitSignal($promise): Promise; } * @copyright 2016-2020 Daniil Gentili * @license https://opensource.org/licenses/MIT MIT */ namespace danog\Loop\Interfaces; use Amp\Promise; /** * Resumable loop interface. * * @author Daniil Gentili */ interface ResumableLoopInterface extends LoopInterface { /** * Pause the loop. * * @param ?int $time Milliseconds for how long to pause the loop, if null will pause forever (until resume is called from outside of the loop) * * @return Promise Resolved when the loop is resumed */ public function pause(?int $time = null): Promise; /** * Resume the loop. * * @return Promise Resolved when the loop is paused again */ public function resume(): Promise; /** * Defer resuming the loop to next tick. * * @return Promise Resolved when the loop is paused again */ public function resumeDefer(): Promise; /** * Defer resuming the loop to next tick. * * Multiple consecutive calls will yield only one resume. * * @return Promise Resolved when the loop is paused again */ public function resumeDeferOnce(): Promise; } { "name": "danog/loop", "description": "Loop abstraction for AMPHP.", "keywords": [ "asynchronous", "async", "concurrent", "multi-threading", "multi-processing" ], "homepage": "https://github.com/danog/loop", "license": "MIT", "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "require": { "php": ">=7.1", "amphp/amp": "^2" }, "require-dev": { "phpunit/phpunit": "^7 | ^8 | ^9", "amphp/phpunit-util": "^1.3", "amphp/php-cs-fixer-config": "dev-master", "vimeo/psalm": "dev-master" }, "autoload": { "psr-4": { "danog\\Loop\\": "lib" } }, "autoload-dev": { "psr-4": { "danog\\Loop\\Test\\": "test" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "php-cs-fixer fix -v --diff --dry-run", "cs-fix": "php-cs-fixer fix -v --diff", "test": "phpdbg -qrr -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" } } start(); yield delay(100); $loops []= $loop; } yield delay(5000); echo "Resuming prematurely all loops!".PHP_EOL; foreach ($loops as $loop) { $loop->resume(); } echo "OK done, waiting 5 more seconds!".PHP_EOL; yield delay(5000); echo "Closing all loops!".PHP_EOL; yield delay(10); }); start(); yield delay(100); $loops []= $loop; } yield delay(5000); echo "Resuming prematurely all loops!".PHP_EOL; foreach ($loops as $loop) { $loop->resume(); } echo "OK done, waiting 5 more seconds!".PHP_EOL; yield delay(5000); echo "Closing all loops!".PHP_EOL; yield delay(10); }); name = $name; } /** * Main loop. * * @return \Generator */ public function loop(): \Generator { $number = 0; while (true) { if (yield $this->waitSignal($this->pause(1000))) { echo "Got exit signal in $this!".PHP_EOL; return; } echo "$this: $number".PHP_EOL; $number++; } } /** * Get loop name. * * @return string */ public function __toString(): string { return $this->name; } } Loop::run(function () { /** @var ResSigLoop[] */ $loops = []; for ($x = 0; $x < 10; $x++) { $loop = new ResSigLoop("Loop number $x"); $loop->start(); yield delay(100); $loops []= $loop; } yield delay(5000); echo "Resuming prematurely all loops!".PHP_EOL; foreach ($loops as $loop) { $loop->resume(); } echo "OK done, waiting 5 more seconds!".PHP_EOL; yield delay(5000); echo "Closing all loops!".PHP_EOL; foreach ($loops as $loop) { $loop->signal(true); } }); name = $name; } /** * Main loop. * * @return \Generator */ public function loop(): \Generator { $number = 0; while (true) { yield $this->pause(1000); echo "$this: $number".PHP_EOL; $number++; } } // Optionally, we can also define logging methods /** * Started loop. * * @return void */ protected function startedLoop(): void { parent::startedLoop(); echo "Started loop $this!".PHP_EOL; } /** * Exited loop. * * @return void */ protected function exitedLoop(): void { parent::exitedLoop(); echo "Exited loop $this!".PHP_EOL; } // End of logging methods /** * Get loop name. * * @return string */ public function __toString(): string { return $this->name; } } AmpLoop::run(function () { $loops = []; for ($x = 0; $x < 10; $x++) { $loop = new MyLoop("Loop number $x"); $loop->start(); yield delay(100); $loops []= $loop; } yield delay(5000); echo "Resuming prematurely all loops!".PHP_EOL; foreach ($loops as $loop) { $loop->resume(); } }); name = $name; } /** * Main loop. * * @return \Generator */ public function loop(): \Generator { $number = 0; while (true) { if (yield $this->waitSignal(delay(1000))) { echo "Got exit signal in $this!".PHP_EOL; return; } echo "$this: $number".PHP_EOL; $number++; } } /** * Get loop name. * * @return string */ public function __toString(): string { return $this->name; } } Loop::run(function () { /** @var SigLoop[] */ $loops = []; for ($x = 0; $x < 10; $x++) { $loop = new SigLoop("Loop number $x"); $loop->start(); yield delay(100); $loops []= $loop; } yield delay(5000); echo "Closing all loops!".PHP_EOL; foreach ($loops as $loop) { $loop->signal(true); } }); callable = $callable; $this->name = $name; } /** * Main loop. * * @return \Generator */ public function loop(): \Generator { $callable = $this->callable; $number = 0; while (true) { $number = yield from $callable($number); echo "$this: $number".PHP_EOL; } } // Optionally, we can also define logging methods /** * Started loop. * * @return void */ protected function startedLoop(): void { parent::startedLoop(); echo "Started loop $this!".PHP_EOL; } /** * Exited loop. * * @return void */ protected function exitedLoop(): void { parent::exitedLoop(); echo "Exited loop $this!".PHP_EOL; } // End of logging methods /** * Get loop name. * * @return string */ public function __toString(): string { return $this->name; } } AmpLoop::run(function () { $function = function (int $number): \Generator { yield delay(1000); return $number + 1; }; $loops = []; for ($x = 0; $x < 10; $x++) { $loop = new MyLoop($function, "Loop number $x"); $loop->start(); yield delay(100); $loops []= $loop; } }); assertInstanceOf(JsonDecoder::class, (new JsonDecoderFactory)->create()); } } create(); $response = $decoder->decode($message, $requestId); $this->assertInstanceOf(Message::class, $response); $this->assertEquals(MessageTypes::RESPONSE, $response->getType()); } public function provideValidJsonPayloads() { return [ [ '{ "Status": 0, "TC": false, "RD": true, "RA": true, "AD": false, "CD": false, "Question": [ { "name": "apple.com.", "type": 1 } ], "Answer": [ { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.178.96.59" }, { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.172.224.47" }, { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.142.160.59" } ], "Additional": [ ], "edns_client_subnet": "12.34.56.78/0" }', 2, ], [ '{"Status": 0,"TC": false,"RD": true, "RA": true, "AD": true,"CD": false,"Question":[{"name": "example.com.", "type": 28}],"Answer":[{"name": "example.com.", "type": 28, "TTL": 7092, "data": "2606:2800:220:1:248:1893:25c8:1946"}]}', 3, ], [ '{"Status": 0,"TC": false,"RD": true, "RA": true, "AD": false,"CD": false,"Question":[{"name": "daniil.it.", "type": 1}],"Answer":[{"name": "daniil.it.", "type": 1, "TTL": 300, "data": "104.27.146.166"},{"name": "daniil.it.", "type": 1, "TTL": 300, "data": "104.27.147.166"}]}', 3, ], [ '{"Status": 0,"TC": false,"RD": true, "RA": true, "AD": false,"CD": false,"Question":[{"name": "amphp.org.", "type": 15}],"Answer":[{"name": "amphp.org.", "type": 15, "TTL": 86400, "data": "0 mail.negativeion.net."}]}', 3, ], [ '{"Status": 0,"TC": false,"RD": true,"RA": true,"AD": false,"CD": false,"Question":[ {"name": "daniil.it.","type": 6}],"Answer":[ {"name": "daniil.it.","type": 6,"TTL": 3493,"data": "cruz.ns.cloudflare.com. dns.cloudflare.com. 2031387933 10000 2400 604800 3600"}]}', 3, ], ]; } /** * Test decoding of invalid JSON DNS payloads. * * @param string $message * @param int $requestId * @return void * * @dataProvider provideInvalidJsonPayloads */ public function testDecodesInvalidJsonPayloads($message, $requestId) { $decoder = (new JsonDecoderFactory)->create(); $this->expectException(\InvalidArgumentException::class); $decoder->decode($message, $requestId); } public function provideInvalidJsonPayloads() { return [ [ '{lmfao "Status": 0, "TC": false, "RD": true, "RA": true, "AD": false, "CD": false, "Question": [ { "name": "apple.com.", "type": 1 } ], "Answer": [ { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.178.96.59" }, { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.172.224.47" }, { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.142.160.59" } ], "Additional": [ ], "edns_client_subnet": "12.34.56.78/0" }', 2, ], [ 'xd{"Status": 0,"TC": false,"RD": true, "RA": true, "AD": true,"CD": false,"Question":[{"name": "example.com.", "type": 28}],"Answer":[{"name": "example.com.", "type": 28, "TTL": 7092, "data": "2606:2800:220:1:248:1893:25c8:1946"}]}', 3, ], [ 'whaaa{"Status": 0,"TC": false,"RD": true, "RA": true, "AD": false,"CD": false,"Question":[{"name": "daniil.it.", "type": 1}],"Answer":[{"name": "daniil.it.", "type": 1, "TTL": 300, "data": "104.27.146.166"},{"name": "daniil.it.", "type": 1, "TTL": 300, "data": "104.27.147.166"}]}', 3, ], [ 'xdxdxxxxx{"Status": 0,"TC": false,"RD": true, "RA": true, "AD": false,"CD": false,"Question":[{"name": "amphp.org.", "type": 15}],"Answer":[{"name": "amphp.org.", "type": 15, "TTL": 86400, "data": "0 mail.negativeion.net."}]}', 3, ], [ '{"TC": false,"RD": true, "RA": true, "AD": false,"CD": false,"Question":[{"name": "amphp.org.", "type": 15}],"Answer":[{"name": "amphp.org.", "type": 15, "TTL": 86400, "data": "0 mail.negativeion.net."}]}', 3, ], [ '{"Status": 0,"RD": true, "RA": true, "AD": false,"CD": false,"Question":[{"name": "amphp.org.", "type": 15}],"Answer":[{"name": "amphp.org.", "type": 15, "TTL": 86400, "data": "0 mail.negativeion.net."}]}', 3, ], [ '{"Status": 0,"TC": false,"RA": true, "AD": false,"CD": false,"Question":[{"name": "amphp.org.", "type": 15}],"Answer":[{"name": "amphp.org.", "type": 15, "TTL": 86400, "data": "0 mail.negativeion.net."}]}', 3, ], [ '{"Status": 0,"TC": false,"RD": true, "AD": false,"CD": false,"Question":[{"name": "amphp.org.", "type": 15}],"Answer":[{"name": "amphp.org.", "type": 15, "TTL": 86400, "data": "0 mail.negativeion.net."}]}', 3, ], [ 'xd', 0 ], ]; } } assertInstanceOf(QueryEncoder::class, (new QueryEncoderFactory)->create()); } } create(); $response = $decoder->decode($message, 0); $response->setType(MessageTypes::QUERY); $encoder = (new QueryEncoderFactory)->create(); $request = $encoder->encode($response); $this->assertInternalType('string', $request, "Got a ".\gettype($request)." instead of a string"); \parse_str($request, $output); $this->assertNotEmpty($output); $this->assertArrayHasKey('cd', $output); $this->assertArrayHasKey('do', $output); $this->assertArrayHasKey('ct', $output); $this->assertArrayHasKey('type', $output); $this->assertArrayHasKey('name', $output); $this->assertEquals($output['cd'], 0); $this->assertEquals($output['do'], 0); $this->assertEquals($output['ct'], 'application/dns-json'); $this->assertEquals($output['type'], $response->getQuestionRecords()->getRecordByIndex(0)->getType()); $this->assertEquals($output['name'], \implode('.', $response->getQuestionRecords()->getRecordByIndex(0)->getName()->getLabels())); } public function provideValidQueryPayloads() { return [ [ '{ "Status": 0, "TC": false, "RD": true, "RA": true, "AD": false, "CD": false, "Question": [ { "name": "apple.com.", "type": 1 } ], "Answer": [ { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.178.96.59" }, { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.172.224.47" }, { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.142.160.59" } ], "Additional": [ ], "edns_client_subnet": "12.34.56.78/0" }', 2 ], [ '{"Status": 0,"TC": false,"RD": true, "RA": true, "AD": true,"CD": false,"Question":[{"name": "example.com.", "type": 28}],"Answer":[{"name": "example.com.", "type": 28, "TTL": 7092, "data": "2606:2800:220:1:248:1893:25c8:1946"}]}', 3 ], [ '{"Status": 0,"TC": false,"RD": true, "RA": true, "AD": false,"CD": false,"Question":[{"name": "daniil.it.", "type": 1}],"Answer":[{"name": "daniil.it.", "type": 1, "TTL": 300, "data": "104.27.146.166"},{"name": "daniil.it.", "type": 1, "TTL": 300, "data": "104.27.147.166"}]}', 3 ], [ '{"Status": 0,"TC": false,"RD": true, "RA": true, "AD": false,"CD": false,"Question":[{"name": "amphp.org.", "type": 15}],"Answer":[{"name": "amphp.org.", "type": 15, "TTL": 86400, "data": "0 mail.negativeion.net."}]}', 3 ], ]; } /** * Test query encoding of invalid DNS payloads. * * @param $request * @return void * * @dataProvider provideInvalidQueryPayloads */ public function testEncodesInvalidQueryPayloads($request) { $encoder = (new QueryEncoderFactory)->create(); $this->expectException(\InvalidArgumentException::class); $encoder->encode($request); } public function provideInvalidQueryPayloads() { $decoder = (new JsonDecoderFactory)->create(); return [ [ $decoder->decode( '{ "Status": 0, "TC": false, "RD": true, "RA": true, "AD": false, "CD": false, "Question": [ { "name": "apple.com.", "type": 1 } ], "Answer": [ { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.178.96.59" }, { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.172.224.47" }, { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.142.160.59" } ], "Additional": [ ], "edns_client_subnet": "12.34.56.78/0" }', 2 ) ], [ $decoder->decode( '{ "Status": 0, "TC": false, "RD": true, "RA": true, "AD": false, "CD": false, "Question": [ ], "Answer": [ { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.178.96.59" }, { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.172.224.47" }, { "name": "apple.com.", "type": 1, "TTL": 3599, "data": "17.142.160.59" } ], "Additional": [ ], "edns_client_subnet": "12.34.56.78/0" }', 2 ) ], ]; } } , Chris Wright * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace danog\LibDNSJson; use \LibDNS\Messages\Message; use LibDNS\Messages\MessageTypes; /** * Encodes Message objects to query strings. * * @category LibDNS * @package Encoder * @author Daniil Gentili , Chris Wright */ class QueryEncoder { /** * Encode a Message to URL payload. * * @param \LibDNS\Messages\Message $message The Message to encode * @return string */ public function encode(Message $message): string { if ($message->getType() !== MessageTypes::QUERY) { throw new \InvalidArgumentException('Invalid question: is not a question record'); } $questions = $message->getQuestionRecords(); if ($questions->count() === 0) { throw new \InvalidArgumentException('Invalid question: 0 question records provided'); } $question = $questions->getRecordByIndex(0); return \http_build_query( [ 'cd' => 0, // Do not disable result validation 'do' => 0, // Do not send me DNSSEC data 'type' => $question->getType(), // Record type being requested 'name' => \implode('.', $question->getName()->getLabels()), // Record name being requested 'ct' => 'application/dns-json', // Content-type of request ] ); } } , Chris Wright */ class JsonDecoder { /** * @var \LibDNS\Packets\PacketFactory */ private $packetFactory; /** * @var \LibDNS\Messages\MessageFactory */ private $messageFactory; /** * @var \LibDNS\Records\QuestionFactory */ private $questionFactory; /** * @var \LibDNS\Records\ResourceBuilder */ private $resourceBuilder; /** * @var \LibDNS\Records\Types\TypeBuilder */ private $typeBuilder; /** * @var \LibDNS\Decoder\DecodingContextFactory */ private $decodingContextFactory; /** * Constructor. * * @param \LibDNS\Packets\PacketFactory $packetFactory * @param \LibDNS\Messages\MessageFactory $messageFactory * @param \LibDNS\Records\QuestionFactory $questionFactory * @param \LibDNS\Records\ResourceBuilder $resourceBuilder * @param \LibDNS\Records\Types\TypeBuilder $typeBuilder * @param \LibDNS\Decoder\DecodingContextFactory $decodingContextFactory * @param bool $allowTrailingData */ public function __construct( PacketFactory $packetFactory, MessageFactory $messageFactory, QuestionFactory $questionFactory, ResourceBuilder $resourceBuilder, TypeBuilder $typeBuilder, DecodingContextFactory $decodingContextFactory ) { $this->packetFactory = $packetFactory; $this->messageFactory = $messageFactory; $this->questionFactory = $questionFactory; $this->resourceBuilder = $resourceBuilder; $this->typeBuilder = $typeBuilder; $this->decodingContextFactory = $decodingContextFactory; } /** * Decode a question record. * * * @return \LibDNS\Records\Question * @throws \UnexpectedValueException When the record is invalid */ private function decodeQuestionRecord(array $record): Question { /** @var \LibDNS\Records\Types\DomainName $domainName */ $domainName = $this->typeBuilder->build(Types::DOMAIN_NAME); $labels = \explode('.', $record['name']); if (!empty($last = \array_pop($labels))) { $labels[] = $last; } $domainName->setLabels($labels); $question = $this->questionFactory->create($record['type']); $question->setName($domainName); //$question->setClass($meta['class']); return $question; } /** * Decode a resource record. * * * @return \LibDNS\Records\Resource * @throws \UnexpectedValueException When the record is invalid * @throws \InvalidArgumentException When a type subtype is unknown */ private function decodeResourceRecord(array $record): Resource { /** @var \LibDNS\Records\Types\DomainName $domainName */ $domainName = $this->typeBuilder->build(Types::DOMAIN_NAME); $labels = \explode('.', $record['name']); if (!empty($last = \array_pop($labels))) { $labels[] = $last; } $domainName->setLabels($labels); /* @var \LibDNS\Records\Resource $resource */ $resource = $this->resourceBuilder->build($record['type']); $resource->setName($domainName); //$resource->setClass($meta['class']); $resource->setTTL($record['TTL']); $data = $resource->getData(); $typeDef = $data->getTypeDefinition(); $record['data'] = explode(' ', $record['data'], $typeDef->count()); $fieldDef = $index = null; foreach ($data->getTypeDefinition() as $index => $fieldDef) { $field = $this->typeBuilder->build($fieldDef->getType()); $this->decodeType($field, $record['data'][$index]); $data->setField($index, $field); } return $resource; } /** * Decode a Type field. * * * @param \LibDNS\Records\Types\Type $type The object to populate with the result * @throws \UnexpectedValueException When the packet data is invalid * @throws \InvalidArgumentException When the Type subtype is unknown */ private function decodeType(Type $type, $data) { if ($type instanceof Anything) { $this->decodeAnything($type, $data); } elseif ($type instanceof BitMap) { $this->decodeBitMap($type, $data); } elseif ($type instanceof Char) { $this->decodeChar($type, $data); } elseif ($type instanceof CharacterString) { $this->decodeCharacterString($type, $data); } elseif ($type instanceof DomainName) { $this->decodeDomainName($type, $data); } elseif ($type instanceof IPv4Address) { $this->decodeIPv4Address($type, $data); } elseif ($type instanceof IPv6Address) { $this->decodeIPv6Address($type, $data); } elseif ($type instanceof Long) { $this->decodeLong($type, $data); } elseif ($type instanceof Short) { $this->decodeShort($type, $data); } else { throw new \InvalidArgumentException('Unknown Type '.\get_class($type)); } } /** * Decode an Anything field. * * * @param \LibDNS\Records\Types\Anything $anything The object to populate with the result * @param int $length * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeAnything(Anything $anything, $data) { $anything->setValue(\hex2bin($data)); } /** * Decode a BitMap field. * * * @param \LibDNS\Records\Types\BitMap $bitMap The object to populate with the result * @param int $length * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeBitMap(BitMap $bitMap, $data) { $bitMap->setValue(\hex2bin($data)); } /** * Decode a Char field. * * * @param \LibDNS\Records\Types\Char $char The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeChar(Char $char, $result) { $value = \unpack('C', $result)[1]; $char->setValue($value); } /** * Decode a CharacterString field. * * * @param \LibDNS\Records\Types\CharacterString $characterString The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeCharacterString(CharacterString $characterString, $result) { $characterString->setValue($result); } /** * Decode a DomainName field. * * * @param \LibDNS\Records\Types\DomainName $domainName The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeDomainName(DomainName $domainName, $result) { $labels = \explode('.', $result); if (!empty($last = \array_pop($labels))) { $labels[] = $last; } $domainName->setLabels($labels); } /** * Decode an IPv4Address field. * * * @param \LibDNS\Records\Types\IPv4Address $ipv4Address The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeIPv4Address(IPv4Address $ipv4Address, $result) { $octets = \unpack('C4', \inet_pton($result)); $ipv4Address->setOctets($octets); } /** * Decode an IPv6Address field. * * * @param \LibDNS\Records\Types\IPv6Address $ipv6Address The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeIPv6Address(IPv6Address $ipv6Address, $result) { $shorts = \unpack('n8', \inet_pton($result)); $ipv6Address->setShorts($shorts); } /** * Decode a Long field. * * * @param \LibDNS\Records\Types\Long $long The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeLong(Long $long, $result) { $long->setValue((int) $result); } /** * Decode a Short field. * * * @param \LibDNS\Records\Types\Short $short The object to populate with the result * @return int The number of packet bytes consumed by the operation * @throws \UnexpectedValueException When the packet data is invalid */ private function decodeShort(Short $short, $result) { $short->setValue((int) $result); } /** * Decode a Message from JSON-encoded string. * * @param string $data The data string to decode * @param int $requestId The message ID to set * @return \LibDNS\Messages\Message * @throws \UnexpectedValueException When the packet data is invalid * @throws \InvalidArgumentException When a type subtype is unknown */ public function decode(string $result, int $requestId): Message { $result = \json_decode($result, true); if ($result === false) { $error = \json_last_error_msg(); throw new \InvalidArgumentException("Could not decode JSON DNS payload ($error)"); } if (!isset($result['Status'], $result['TC'], $result['RD'], $result['RA'])) { throw new \InvalidArgumentException('Wrong reply from server, missing required fields'); } $message = $this->messageFactory->create(); $decodingContext = $this->decodingContextFactory->create($this->packetFactory->create()); //$message->isAuthoritative(true); $message->setType(MessageTypes::RESPONSE); $message->setID($requestId); $message->setResponseCode($result['Status']); $message->isTruncated($result['TC']); $message->isRecursionDesired($result['RD']); $message->isRecursionAvailable($result['RA']); $decodingContext->setExpectedQuestionRecords(isset($result['Question']) ? \count($result['Question']) : 0); $decodingContext->setExpectedAnswerRecords(isset($result['Answer']) ? \count($result['Answer']) : 0); $decodingContext->setExpectedAuthorityRecords(0); $decodingContext->setExpectedAdditionalRecords(isset($result['Additional']) ? \count($result['Additional']) : 0); $questionRecords = $message->getQuestionRecords(); $expected = $decodingContext->getExpectedQuestionRecords(); for ($i = 0; $i < $expected; $i++) { $questionRecords->add($this->decodeQuestionRecord($result['Question'][$i])); } $answerRecords = $message->getAnswerRecords(); $expected = $decodingContext->getExpectedAnswerRecords(); for ($i = 0; $i < $expected; $i++) { $answerRecords->add($this->decodeResourceRecord($result['Answer'][$i])); } $authorityRecords = $message->getAuthorityRecords(); $expected = $decodingContext->getExpectedAuthorityRecords(); for ($i = 0; $i < $expected; $i++) { $authorityRecords->add($this->decodeResourceRecord($result['Authority'][$i])); } $additionalRecords = $message->getAdditionalRecords(); $expected = $decodingContext->getExpectedAdditionalRecords(); for ($i = 0; $i < $expected; $i++) { $additionalRecords->add($this->decodeResourceRecord($result['Additional'][$i])); } return $message; } } , Chris Wright * @copyright Copyright (c) Chris Wright , * @license http://www.opensource.org/licenses/mit-license.html MIT License */ namespace danog\LibDNSJson; use \LibDNS\Messages\MessageFactory; use \LibDNS\Packets\PacketFactory; use \LibDNS\Records\QuestionFactory; use \LibDNS\Records\RDataBuilder; use \LibDNS\Records\RDataFactory; use \LibDNS\Records\RecordCollectionFactory; use \LibDNS\Records\ResourceBuilder; use \LibDNS\Records\ResourceFactory; use \LibDNS\Records\TypeDefinitions\FieldDefinitionFactory; use \LibDNS\Records\TypeDefinitions\TypeDefinitionFactory; use \LibDNS\Records\TypeDefinitions\TypeDefinitionManager; use \LibDNS\Records\Types\TypeBuilder; use \LibDNS\Records\Types\TypeFactory; use LibDNS\Decoder\DecodingContextFactory; /** * Creates JsonDecoder objects. * * @author Daniil Gentili , Chris Wright */ class JsonDecoderFactory { /** * Create a new JsonDecoder object. * * @param \LibDNS\Records\TypeDefinitions\TypeDefinitionManager $typeDefinitionManager * @return JsonDecoder */ public function create(TypeDefinitionManager $typeDefinitionManager = null): JsonDecoder { $typeBuilder = new TypeBuilder(new TypeFactory); return new JsonDecoder( new PacketFactory, new MessageFactory(new RecordCollectionFactory), new QuestionFactory, new ResourceBuilder( new ResourceFactory, new RDataBuilder( new RDataFactory, $typeBuilder ), $typeDefinitionManager ?: new TypeDefinitionManager( new TypeDefinitionFactory, new FieldDefinitionFactory ) ), $typeBuilder, new DecodingContextFactory ); } } , Chris Wright * @copyright Copyright (c) Chris Wright * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 2.0.0 */ namespace danog\LibDNSJson; /** * Creates QueryEncoder objects. * * @category LibDNS * @package Encoder * @author Daniil Gentili , Chris Wright */ class QueryEncoderFactory { /** * Create a new Encoder object. * * @return \LibDNS\Encoder\Encoder */ public function create(): QueryEncoder { return new QueryEncoder(); } } { "name": "danog/libdns-json", "homepage": "https://github.com/danog/libdns-json", "description": "Encoder/decoder for google's JSON DNS message format based on libdns", "keywords": [ "dns", "doh", "dns-over-https", "https", "json", "libdns", "message" ], "license": "MIT", "authors": [{ "name": "Daniil Gentili", "email": "daniil@daniil.it" }, { "name": "Chris Wright", "email": "addr@daverandom.com" } ], "require": { "php": ">=7.0", "daverandom/libdns": "^2.0.1", "ext-json": "*" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "phpunit/phpunit": "^6" }, "autoload": { "psr-4": { "danog\\LibDNSJson\\": "lib" } }, "autoload-dev": { "psr-4": { "danog\\LibDNSJson\\Test\\": "test" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff --dry-run", "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" } }{ "name": "league/uri-interfaces", "description" : "Common interface for URI representation", "keywords": [ "url", "uri", "rfc3986", "rfc3987" ], "license": "MIT", "homepage": "http://github.com/thephpleague/uri-interfaces", "authors": [ { "name" : "Ignace Nyamagana Butera", "email" : "nyamsprod@gmail.com", "homepage" : "https://nyamsprod.com" } ], "funding": [ { "type": "github", "url": "https://github.com/sponsors/nyamsprod" } ], "require": { "php" : "^7.2 || ^8.0", "ext-json": "*" }, "require-dev": { "friendsofphp/php-cs-fixer": "^2.19", "phpstan/phpstan": "^0.12.90", "phpstan/phpstan-strict-rules": "^0.12.9", "phpstan/phpstan-phpunit": "^0.12.19", "phpunit/phpunit": "^8.5.15 || ^9.5" }, "autoload": { "psr-4": { "League\\Uri\\": "src/" } }, "scripts": { "phpunit": "phpunit --coverage-text", "phpcs": "php-cs-fixer fix --dry-run --diff -vvv --allow-risky=yes --ansi", "phpcs:fix": "php-cs-fixer fix -vvv --allow-risky=yes --ansi", "phpstan": "phpstan analyse -l max -c phpstan.neon src --ansi --memory-limit 192M", "test": [ "@phpunit", "@phpstan", "@phpcs:fix" ] }, "scripts-descriptions": { "phpunit": "Runs package test suite", "phpstan": "Runs complete codebase static analysis", "phpcs": "Runs coding style testing", "phpcs:fix": "Fix coding style issues", "test": "Runs all tests" }, "extra": { "branch-alias": { "dev-master": "2.x-dev" } }, "suggest": { "ext-intl": "to use the IDNA feature", "symfony/intl": "to use the IDNA feature via Symfony Polyfill" } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; interface HostInterface extends UriComponentInterface { /** * Returns the ascii representation. */ public function toAscii(): ?string; /** * Returns the unicode representation. */ public function toUnicode(): ?string; /** * Returns the IP version. * * If the host is a not an IP this method will return null */ public function getIpVersion(): ?string; /** * Returns the IP component If the Host is an IP address. * * If the host is a not an IP this method will return null */ public function getIp(): ?string; /** * Tells whether the host is a domain name. */ public function isDomain(): bool; /** * Tells whether the host is an IP Address. */ public function isIp(): bool; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; use Throwable; interface UriException extends Throwable { } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; interface DataPathInterface extends PathInterface { /** * Retrieve the data mime type associated to the URI. * * If no mimetype is present, this method MUST return the default mimetype 'text/plain'. * * @see http://tools.ietf.org/html/rfc2397#section-2 */ public function getMimeType(): string; /** * Retrieve the parameters associated with the Mime Type of the URI. * * If no parameters is present, this method MUST return the default parameter 'charset=US-ASCII'. * * @see http://tools.ietf.org/html/rfc2397#section-2 */ public function getParameters(): string; /** * Retrieve the mediatype associated with the URI. * * If no mediatype is present, this method MUST return the default parameter 'text/plain;charset=US-ASCII'. * * @see http://tools.ietf.org/html/rfc2397#section-3 * * @return string The URI scheme. */ public function getMediaType(): string; /** * Retrieves the data string. * * Retrieves the data part of the path. If no data part is provided return * a empty string */ public function getData(): string; /** * Tells whether the data is binary safe encoded. */ public function isBinaryData(): bool; /** * Save the data to a specific file. */ public function save(string $path, string $mode = 'w'): \SplFileObject; /** * Returns an instance where the data part is base64 encoded. * * This method MUST retain the state of the current instance, and return * an instance where the data part is base64 encoded */ public function toBinary(): self; /** * Returns an instance where the data part is url encoded following RFC3986 rules. * * This method MUST retain the state of the current instance, and return * an instance where the data part is url encoded */ public function toAscii(): self; /** * Return an instance with the specified mediatype parameters. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified mediatype parameters. * * Users must provide encoded characters. * * An empty parameters value is equivalent to removing the parameter. */ public function withParameters(string $parameters): self; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; interface IpHostInterface extends HostInterface { /** * Returns whether or not the host is an IPv4 address. */ public function isIpv4(): bool; /** * Returns whether or not the host is an IPv6 address. */ public function isIpv6(): bool; /** * Returns whether or not the host is an IPv6 address. */ public function isIpFuture(): bool; /** * Returns whether or not the host has a ZoneIdentifier. * * @see http://tools.ietf.org/html/rfc6874#section-4 */ public function hasZoneIdentifier(): bool; /** * Returns an host without its zone identifier according to RFC6874. * * This method MUST retain the state of the current instance, and return * an instance without the host zone identifier according to RFC6874 * * @see http://tools.ietf.org/html/rfc6874#section-4 */ public function withoutZoneIdentifier(): self; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; use League\Uri\Exceptions\SyntaxError; /** * @extends \IteratorAggregate */ interface DomainHostInterface extends \Countable, HostInterface, \IteratorAggregate { /** * Returns the labels total number. */ public function count(): int; /** * Iterate over the Domain labels. * * @return \Iterator */ public function getIterator(): \Iterator; /** * Retrieves a single host label. * * If the label offset has not been set, returns the null value. */ public function get(int $offset): ?string; /** * Returns the associated key for a specific label or all the keys. * * @param ?string $label * * @return int[] */ public function keys(?string $label = null): array; /** * Tells whether the domain is absolute. */ public function isAbsolute(): bool; /** * Prepends a label to the host. */ public function prepend(string $label): self; /** * Appends a label to the host. */ public function append(string $label): self; /** * Returns an instance with its Root label. * * @see https://tools.ietf.org/html/rfc3986#section-3.2.2 */ public function withRootLabel(): self; /** * Returns an instance without its Root label. * * @see https://tools.ietf.org/html/rfc3986#section-3.2.2 */ public function withoutRootLabel(): self; /** * Returns an instance with the modified label. * * This method MUST retain the state of the current instance, and return * an instance that contains the new label * * If $key is non-negative, the added label will be the label at $key position from the start. * If $key is negative, the added label will be the label at $key position from the end. * * @throws SyntaxError If the key is invalid */ public function withLabel(int $key, string $label): self; /** * Returns an instance without the specified label. * * This method MUST retain the state of the current instance, and return * an instance that contains the modified component * * If $key is non-negative, the removed label will be the label at $key position from the start. * If $key is negative, the removed label will be the label at $key position from the end. * * @param int ...$keys * * @throws SyntaxError If the key is invalid */ public function withoutLabel(int ...$keys): self; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; use League\Uri\Exceptions\IdnSupportMissing; use League\Uri\Exceptions\SyntaxError; interface UriComponentInterface extends \JsonSerializable { /** * Returns the instance content. * * If the instance is defined, the value returned MUST be encoded according to the * selected encoding algorithm. In any case, the value MUST NOT double-encode any character * depending on the selected encoding algorithm. * * To determine what characters to encode, please refer to RFC 3986, Sections 2 and 3. * or RFC 3987 Section 3. By default the content is encoded according to RFC3986 * * If the instance is not defined null is returned */ public function getContent(): ?string; /** * Returns the instance string representation. * * If the instance is defined, the value returned MUST be percent-encoded, * but MUST NOT double-encode any characters. To determine what characters * to encode, please refer to RFC 3986, Sections 2 and 3. * * If the instance is not defined an empty string is returned */ public function __toString(): string; /** * Returns the instance json representation. * * If the instance is defined, the value returned MUST be percent-encoded, * but MUST NOT double-encode any characters. To determine what characters * to encode, please refer to RFC 3986 or RFC 1738. * * If the instance is not defined null is returned */ public function jsonSerialize(): ?string; /** * Returns the instance string representation with its optional URI delimiters. * * The value returned MUST be percent-encoded, but MUST NOT double-encode any * characters. To determine what characters to encode, please refer to RFC 3986, * Sections 2 and 3. * * If the instance is not defined an empty string is returned */ public function getUriComponent(): string; /** * Returns an instance with the specified content. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified content. * * Users can provide both encoded and decoded content characters. * * A null value is equivalent to removing the component content. * * * @param ?string $content * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. * @throws IdnSupportMissing for component or transformations * requiring IDN support when IDN support is not present * or misconfigured. */ public function withContent(?string $content): self; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; interface PortInterface extends UriComponentInterface { /** * Returns the integer representation of the Port. */ public function toInt(): ?int; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; use League\Uri\Exceptions\SyntaxError; interface PathInterface extends UriComponentInterface { /** * Returns the decoded path. */ public function decoded(): string; /** * Returns whether or not the path is absolute or relative. */ public function isAbsolute(): bool; /** * Returns whether or not the path has a trailing delimiter. */ public function hasTrailingSlash(): bool; /** * Returns an instance without dot segments. * * This method MUST retain the state of the current instance, and return * an instance that contains the path component normalized by removing * the dot segment. * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withoutDotSegments(): self; /** * Returns an instance with a leading slash. * * This method MUST retain the state of the current instance, and return * an instance that contains the path component with a leading slash * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withLeadingSlash(): self; /** * Returns an instance without a leading slash. * * This method MUST retain the state of the current instance, and return * an instance that contains the path component without a leading slash * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withoutLeadingSlash(): self; /** * Returns an instance with a trailing slash. * * This method MUST retain the state of the current instance, and return * an instance that contains the path component with a trailing slash * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withTrailingSlash(): self; /** * Returns an instance without a trailing slash. * * This method MUST retain the state of the current instance, and return * an instance that contains the path component without a trailing slash * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withoutTrailingSlash(): self; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; use League\Uri\Exceptions\IdnSupportMissing; use League\Uri\Exceptions\SyntaxError; interface AuthorityInterface extends UriComponentInterface { /** * Returns the host component of the authority. */ public function getHost(): ?string; /** * Returns the port component of the authority. */ public function getPort(): ?int; /** * Returns the user information component of the authority. */ public function getUserInfo(): ?string; /** * Return an instance with the specified host. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified host. * * A null value provided for the host is equivalent to removing the host * information. * * @param ?string $host * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. * @throws IdnSupportMissing for component or transformations * requiring IDN support when IDN support is not present * or misconfigured. */ public function withHost(?string $host): self; /** * Return an instance with the specified port. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified port. * * A null value provided for the port is equivalent to removing the port * information. * * @param ?int $port * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withPort(?int $port): self; /** * Return an instance with the specified user information. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified user information. * * Password is optional, but the user information MUST include the * user; a null value for the user is equivalent to removing user * information. * * @param ?string $user * @param ?string $password * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withUserInfo(?string $user, ?string $password = null): self; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; use League\Uri\Exceptions\IdnSupportMissing; use League\Uri\Exceptions\SyntaxError; interface UriInterface extends \JsonSerializable { /** * Returns the string representation as a URI reference. * * @see http://tools.ietf.org/html/rfc3986#section-4.1 */ public function __toString(): string; /** * Returns the string representation as a URI reference. * * @see http://tools.ietf.org/html/rfc3986#section-4.1 * @see ::__toString */ public function jsonSerialize(): string; /** * Retrieve the scheme component of the URI. * * If no scheme is present, this method MUST return a null value. * * The value returned MUST be normalized to lowercase, per RFC 3986 * Section 3.1. * * The trailing ":" character is not part of the scheme and MUST NOT be * added. * * @see https://tools.ietf.org/html/rfc3986#section-3.1 */ public function getScheme(): ?string; /** * Retrieve the authority component of the URI. * * If no scheme is present, this method MUST return a null value. * * If the port component is not set or is the standard port for the current * scheme, it SHOULD NOT be included. * * @see https://tools.ietf.org/html/rfc3986#section-3.2 */ public function getAuthority(): ?string; /** * Retrieve the user information component of the URI. * * If no scheme is present, this method MUST return a null value. * * If a user is present in the URI, this will return that value; * additionally, if the password is also present, it will be appended to the * user value, with a colon (":") separating the values. * * The trailing "@" character is not part of the user information and MUST * NOT be added. */ public function getUserInfo(): ?string; /** * Retrieve the host component of the URI. * * If no host is present this method MUST return a null value. * * The value returned MUST be normalized to lowercase, per RFC 3986 * Section 3.2.2. * * @see http://tools.ietf.org/html/rfc3986#section-3.2.2 */ public function getHost(): ?string; /** * Retrieve the port component of the URI. * * If a port is present, and it is non-standard for the current scheme, * this method MUST return it as an integer. If the port is the standard port * used with the current scheme, this method SHOULD return null. * * If no port is present, and no scheme is present, this method MUST return * a null value. * * If no port is present, but a scheme is present, this method MAY return * the standard port for that scheme, but SHOULD return null. */ public function getPort(): ?int; /** * Retrieve the path component of the URI. * * The path can either be empty or absolute (starting with a slash) or * rootless (not starting with a slash). Implementations MUST support all * three syntaxes. * * Normally, the empty path "" and absolute path "/" are considered equal as * defined in RFC 7230 Section 2.7.3. But this method MUST NOT automatically * do this normalization because in contexts with a trimmed base path, e.g. * the front controller, this difference becomes significant. It's the task * of the user to handle both "" and "/". * * The value returned MUST be percent-encoded, but MUST NOT double-encode * any characters. To determine what characters to encode, please refer to * RFC 3986, Sections 2 and 3.3. * * As an example, if the value should include a slash ("/") not intended as * delimiter between path segments, that value MUST be passed in encoded * form (e.g., "%2F") to the instance. * * @see https://tools.ietf.org/html/rfc3986#section-2 * @see https://tools.ietf.org/html/rfc3986#section-3.3 */ public function getPath(): string; /** * Retrieve the query string of the URI. * * If no host is present this method MUST return a null value. * * The leading "?" character is not part of the query and MUST NOT be * added. * * The value returned MUST be percent-encoded, but MUST NOT double-encode * any characters. To determine what characters to encode, please refer to * RFC 3986, Sections 2 and 3.4. * * As an example, if a value in a key/value pair of the query string should * include an ampersand ("&") not intended as a delimiter between values, * that value MUST be passed in encoded form (e.g., "%26") to the instance. * * @see https://tools.ietf.org/html/rfc3986#section-2 * @see https://tools.ietf.org/html/rfc3986#section-3.4 */ public function getQuery(): ?string; /** * Retrieve the fragment component of the URI. * * If no host is present this method MUST return a null value. * * The leading "#" character is not part of the fragment and MUST NOT be * added. * * The value returned MUST be percent-encoded, but MUST NOT double-encode * any characters. To determine what characters to encode, please refer to * RFC 3986, Sections 2 and 3.5. * * @see https://tools.ietf.org/html/rfc3986#section-2 * @see https://tools.ietf.org/html/rfc3986#section-3.5 */ public function getFragment(): ?string; /** * Return an instance with the specified scheme. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified scheme. * * A null value provided for the scheme is equivalent to removing the scheme * information. * * @param ?string $scheme * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withScheme(?string $scheme): self; /** * Return an instance with the specified user information. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified user information. * * Password is optional, but the user information MUST include the * user; a null value for the user is equivalent to removing user * information. * * @param ?string $user * @param ?string $password * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withUserInfo(?string $user, ?string $password = null): self; /** * Return an instance with the specified host. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified host. * * A null value provided for the host is equivalent to removing the host * information. * * @param ?string $host * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. * @throws IdnSupportMissing for component or transformations * requiring IDN support when IDN support is not present * or misconfigured. */ public function withHost(?string $host): self; /** * Return an instance with the specified port. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified port. * * A null value provided for the port is equivalent to removing the port * information. * * @param ?int $port * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withPort(?int $port): self; /** * Return an instance with the specified path. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified path. * * The path can either be empty or absolute (starting with a slash) or * rootless (not starting with a slash). Implementations MUST support all * three syntaxes. * * Users can provide both encoded and decoded path characters. * Implementations ensure the correct encoding as outlined in getPath(). * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withPath(string $path): self; /** * Return an instance with the specified query string. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified query string. * * Users can provide both encoded and decoded query characters. * Implementations ensure the correct encoding as outlined in getQuery(). * * A null value provided for the query is equivalent to removing the query * information. * * @param ?string $query * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withQuery(?string $query): self; /** * Return an instance with the specified URI fragment. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified URI fragment. * * Users can provide both encoded and decoded fragment characters. * Implementations ensure the correct encoding as outlined in getFragment(). * * A null value provided for the fragment is equivalent to removing the fragment * information. * * @param ?string $fragment * * @throws SyntaxError for invalid component or transformations * that would result in a object in invalid state. */ public function withFragment(?string $fragment): self; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; interface FragmentInterface extends UriComponentInterface { /** * Returns the decoded fragment. */ public function decoded(): ?string; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; /** * @extends \IteratorAggregate */ interface QueryInterface extends \Countable, \IteratorAggregate, UriComponentInterface { /** * Returns the query separator. */ public function getSeparator(): string; /** * Returns the number of key/value pairs present in the object. */ public function count(): int; /** * Returns an iterator allowing to go through all key/value pairs contained in this object. * * The pair is represented as an array where the first value is the pair key * and the second value the pair value. * * The key of each pair is a string * The value of each pair is a scalar or the null value * * @return \Iterator */ public function getIterator(): \Iterator; /** * Returns an iterator allowing to go through all key/value pairs contained in this object. * * The return type is as a Iterator where its offset is the pair key and its value the pair value. * * The key of each pair is a string * The value of each pair is a scalar or the null value * * @return iterable */ public function pairs(): iterable; /** * Tells whether a pair with a specific name exists. * * @see https://url.spec.whatwg.org/#dom-urlsearchparams-has */ public function has(string $key): bool; /** * Returns the first value associated to the given pair name. * * If no value is found null is returned * * @see https://url.spec.whatwg.org/#dom-urlsearchparams-get */ public function get(string $key): ?string; /** * Returns all the values associated to the given pair name as an array or all * the instance pairs. * * If no value is found an empty array is returned * * @see https://url.spec.whatwg.org/#dom-urlsearchparams-getall * * @return array */ public function getAll(string $key): array; /** * Returns the store PHP variables as elements of an array. * * The result is similar as PHP parse_str when used with its * second argument with the difference that variable names are * not mangled. * * If a key is submitted it will returns the value attached to it or null * * @see http://php.net/parse_str * @see https://wiki.php.net/rfc/on_demand_name_mangling * * @param ?string $key * @return mixed the collection of stored PHP variables or the empty array if no input is given, * the single value of a stored PHP variable or null if the variable is not present in the collection */ public function params(?string $key = null); /** * Returns the RFC1738 encoded query. */ public function toRFC1738(): ?string; /** * Returns the RFC3986 encoded query. * * @see ::getContent */ public function toRFC3986(): ?string; /** * Returns an instance with a different separator. * * This method MUST retain the state of the current instance, and return * an instance that contains the query component with a different separator */ public function withSeparator(string $separator): self; /** * Sorts the query string by offset, maintaining offset to data correlations. * * This method MUST retain the state of the current instance, and return * an instance that contains the modified query * * @see https://url.spec.whatwg.org/#dom-urlsearchparams-sort */ public function sort(): self; /** * Returns an instance without duplicate key/value pair. * * This method MUST retain the state of the current instance, and return * an instance that contains the query component normalized by removing * duplicate pairs whose key/value are the same. */ public function withoutDuplicates(): self; /** * Returns an instance without empty key/value where the value is the null value. * * This method MUST retain the state of the current instance, and return * an instance that contains the query component normalized by removing * empty pairs. * * A pair is considered empty if its value is equal to the null value */ public function withoutEmptyPairs(): self; /** * Returns an instance where numeric indices associated to PHP's array like key are removed. * * This method MUST retain the state of the current instance, and return * an instance that contains the query component normalized so that numeric indexes * are removed from the pair key value. * * ie.: toto[3]=bar[3]&foo=bar becomes toto[]=bar[3]&foo=bar */ public function withoutNumericIndices(): self; /** * Returns an instance with the a new key/value pair added to it. * * This method MUST retain the state of the current instance, and return * an instance that contains the modified query * * If the pair already exists the value will replace the existing value. * * @see https://url.spec.whatwg.org/#dom-urlsearchparams-set * * @param ?string $value */ public function withPair(string $key, ?string $value): self; /** * Returns an instance with the new pairs set to it. * * This method MUST retain the state of the current instance, and return * an instance that contains the modified query * * @see ::withPair */ public function merge(string $query): self; /** * Returns an instance without the specified keys. * * This method MUST retain the state of the current instance, and return * an instance that contains the modified component * * @param string ...$keys */ public function withoutPair(string ...$keys): self; /** * Returns a new instance with a specified key/value pair appended as a new pair. * * This method MUST retain the state of the current instance, and return * an instance that contains the modified query * * @param ?string $value */ public function appendTo(string $key, ?string $value): self; /** * Returns an instance with the new pairs appended to it. * * This method MUST retain the state of the current instance, and return * an instance that contains the modified query * * If the pair already exists the value will be added to it. */ public function append(string $query): self; /** * Returns an instance without the specified params. * * This method MUST retain the state of the current instance, and return * an instance that contains the modified component without PHP's value. * PHP's mangled is not taken into account. * * @param string ...$keys */ public function withoutParam(string ...$keys): self; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; interface UserInfoInterface extends UriComponentInterface { /** * Returns the user component part. */ public function getUser(): ?string; /** * Returns the pass component part. */ public function getPass(): ?string; /** * Returns an instance with the specified user and/or pass. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified user. * * An empty user is equivalent to removing the user information. * * @param ?string $user * @param ?string $pass */ public function withUserInfo(?string $user, ?string $pass = null): self; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Contracts; use League\Uri\Exceptions\SyntaxError; /** * @extends \IteratorAggregate */ interface SegmentedPathInterface extends \Countable, \IteratorAggregate, PathInterface { /** * Returns the total number of segments in the path. */ public function count(): int; /** * Iterate over the path segment. * * @return \Iterator */ public function getIterator(): \Iterator; /** * Returns parent directory's path. */ public function getDirname(): string; /** * Returns the path basename. */ public function getBasename(): string; /** * Returns the basename extension. */ public function getExtension(): string; /** * Retrieves a single path segment. * * If the segment offset has not been set, returns null. */ public function get(int $offset): ?string; /** * Returns the associated key for a specific segment. * * If a value is specified only the keys associated with * the given value will be returned * * @param ?string $segment * * @return int[] */ public function keys(?string $segment = null): array; /** * Appends a segment to the path. */ public function append(string $segment): self; /** * Prepends a segment to the path. */ public function prepend(string $segment): self; /** * Returns an instance with the modified segment. * * This method MUST retain the state of the current instance, and return * an instance that contains the new segment * * If $key is non-negative, the added segment will be the segment at $key position from the start. * If $key is negative, the added segment will be the segment at $key position from the end. * * @param ?string $segment * * @throws SyntaxError If the key is invalid */ public function withSegment(int $key, ?string $segment): self; /** * Returns an instance without the specified segment. * * This method MUST retain the state of the current instance, and return * an instance that contains the modified component * * If $key is non-negative, the removed segment will be the segment at $key position from the start. * If $key is negative, the removed segment will be the segment at $key position from the end. * * @param int ...$keys remaining keys to remove * * @throws SyntaxError If the key is invalid */ public function withoutSegment(int ...$keys): self; /** * Returns an instance without duplicate delimiters. * * This method MUST retain the state of the current instance, and return * an instance that contains the path component normalized by removing * multiple consecutive empty segment */ public function withoutEmptySegments(): self; /** * Returns an instance with the specified parent directory's path. * * This method MUST retain the state of the current instance, and return * an instance that contains the extension basename modified. * * @param ?string $path */ public function withDirname(?string $path): self; /** * Returns an instance with the specified basename. * * This method MUST retain the state of the current instance, and return * an instance that contains the extension basename modified. * * @param ?string $basename */ public function withBasename(?string $basename): self; /** * Returns an instance with the specified basename extension. * * This method MUST retain the state of the current instance, and return * an instance that contains the extension basename modified. * * @param ?string $extension */ public function withExtension(?string $extension): self; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Exceptions; use League\Uri\Contracts\UriException; class FileinfoSupportMissing extends \RuntimeException implements UriException { } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Exceptions; use League\Uri\Idna\IdnaInfo; final class IdnaConversionFailed extends SyntaxError { /** @var IdnaInfo|null */ private $idnaInfo; private function __construct(string $message, IdnaInfo $idnaInfo = null) { parent::__construct($message); $this->idnaInfo = $idnaInfo; } public static function dueToIDNAError(string $domain, IdnaInfo $idnaInfo): self { return new self( 'The host `'.$domain.'` is invalid : '.implode(', ', $idnaInfo->errorList()).' .', $idnaInfo ); } public static function dueToInvalidHost(string $domain): self { return new self('The host `'.$domain.'` is not a valid IDN host'); } public function idnaInfo(): ?IdnaInfo { return $this->idnaInfo; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Exceptions; use League\Uri\Contracts\UriException; class SyntaxError extends \InvalidArgumentException implements UriException { } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Exceptions; use League\Uri\Contracts\UriException; class IdnSupportMissing extends \RuntimeException implements UriException { } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Idna; use League\Uri\Exceptions\IdnaConversionFailed; use League\Uri\Exceptions\IdnSupportMissing; use League\Uri\Exceptions\SyntaxError; use function defined; use function function_exists; use function idn_to_ascii; use function idn_to_utf8; use function rawurldecode; use const INTL_IDNA_VARIANT_UTS46; /** * @see https://unicode-org.github.io/icu-docs/apidoc/released/icu4c/uidna_8h.html */ final class Idna { private const REGEXP_IDNA_PATTERN = '/[^\x20-\x7f]/'; private const MAX_DOMAIN_LENGTH = 253; private const MAX_LABEL_LENGTH = 63; /** * General registered name regular expression. * * @see https://tools.ietf.org/html/rfc3986#section-3.2.2 * @see https://regex101.com/r/fptU8V/1 */ private const REGEXP_REGISTERED_NAME = '/ (?(DEFINE) (?[a-z0-9_~\-]) # . is missing as it is used to separate labels (?[!$&\'()*+,;=]) (?%[A-F0-9]{2}) (?(?:(?&unreserved)|(?&sub_delims)|(?&encoded))*) ) ^(?:(?®_name)\.)*(?®_name)\.?$ /ix'; /** * IDNA options. */ public const IDNA_DEFAULT = 0; public const IDNA_ALLOW_UNASSIGNED = 1; public const IDNA_USE_STD3_RULES = 2; public const IDNA_CHECK_BIDI = 4; public const IDNA_CHECK_CONTEXTJ = 8; public const IDNA_NONTRANSITIONAL_TO_ASCII = 0x10; public const IDNA_NONTRANSITIONAL_TO_UNICODE = 0x20; public const IDNA_CHECK_CONTEXTO = 0x40; /** * IDNA errors. */ public const ERROR_NONE = 0; public const ERROR_EMPTY_LABEL = 1; public const ERROR_LABEL_TOO_LONG = 2; public const ERROR_DOMAIN_NAME_TOO_LONG = 4; public const ERROR_LEADING_HYPHEN = 8; public const ERROR_TRAILING_HYPHEN = 0x10; public const ERROR_HYPHEN_3_4 = 0x20; public const ERROR_LEADING_COMBINING_MARK = 0x40; public const ERROR_DISALLOWED = 0x80; public const ERROR_PUNYCODE = 0x100; public const ERROR_LABEL_HAS_DOT = 0x200; public const ERROR_INVALID_ACE_LABEL = 0x400; public const ERROR_BIDI = 0x800; public const ERROR_CONTEXTJ = 0x1000; public const ERROR_CONTEXTO_PUNCTUATION = 0x2000; public const ERROR_CONTEXTO_DIGITS = 0x4000; /** * IDNA default options. */ public const IDNA2008_ASCII = self::IDNA_NONTRANSITIONAL_TO_ASCII | self::IDNA_CHECK_BIDI | self::IDNA_USE_STD3_RULES | self::IDNA_CHECK_CONTEXTJ; public const IDNA2008_UNICODE = self::IDNA_NONTRANSITIONAL_TO_UNICODE | self::IDNA_CHECK_BIDI | self::IDNA_USE_STD3_RULES | self::IDNA_CHECK_CONTEXTJ; /** * @codeCoverageIgnore */ private static function supportsIdna(): void { static $idnSupport; if (null === $idnSupport) { $idnSupport = function_exists('\idn_to_ascii') && defined('\INTL_IDNA_VARIANT_UTS46'); } if (!$idnSupport) { throw new IdnSupportMissing('IDN host can not be processed. Verify that ext/intl is installed for IDN support and that ICU is at least version 4.6.'); } } /** * Converts the input to its IDNA ASCII form. * * This method returns the string converted to IDN ASCII form * * @throws SyntaxError if the string can not be converted to ASCII using IDN UTS46 algorithm */ public static function toAscii(string $domain, int $options): IdnaInfo { $domain = rawurldecode($domain); if (1 === preg_match(self::REGEXP_IDNA_PATTERN, $domain)) { self::supportsIdna(); /* @param-out array{errors: int, isTransitionalDifferent: bool, result: string} $idnaInfo */ idn_to_ascii($domain, $options, INTL_IDNA_VARIANT_UTS46, $idnaInfo); if ([] === $idnaInfo) { return IdnaInfo::fromIntl([ 'result' => strtolower($domain), 'isTransitionalDifferent' => false, 'errors' => self::validateDomainAndLabelLength($domain), ]); } /* @var array{errors: int, isTransitionalDifferent: bool, result: string} $idnaInfo */ return IdnaInfo::fromIntl($idnaInfo); } $error = self::ERROR_NONE; if (1 !== preg_match(self::REGEXP_REGISTERED_NAME, $domain)) { $error |= self::ERROR_DISALLOWED; } return IdnaInfo::fromIntl([ 'result' => strtolower($domain), 'isTransitionalDifferent' => false, 'errors' => self::validateDomainAndLabelLength($domain) | $error, ]); } /** * Converts the input to its IDNA UNICODE form. * * This method returns the string converted to IDN UNICODE form * * @throws SyntaxError if the string can not be converted to UNICODE using IDN UTS46 algorithm */ public static function toUnicode(string $domain, int $options): IdnaInfo { $domain = rawurldecode($domain); if (false === stripos($domain, 'xn--')) { return IdnaInfo::fromIntl(['result' => $domain, 'isTransitionalDifferent' => false, 'errors' => self::ERROR_NONE]); } self::supportsIdna(); /* @param-out array{errors: int, isTransitionalDifferent: bool, result: string} $idnaInfo */ idn_to_utf8($domain, $options, INTL_IDNA_VARIANT_UTS46, $idnaInfo); if ([] === $idnaInfo) { throw IdnaConversionFailed::dueToInvalidHost($domain); } /* @var array{errors: int, isTransitionalDifferent: bool, result: string} $idnaInfo */ return IdnaInfo::fromIntl($idnaInfo); } /** * Adapted from https://github.com/TRowbotham/idna. * * @see https://github.com/TRowbotham/idna/blob/master/src/Idna.php#L236 */ private static function validateDomainAndLabelLength(string $domain): int { $error = self::ERROR_NONE; $labels = explode('.', $domain); $maxDomainSize = self::MAX_DOMAIN_LENGTH; $length = count($labels); // If the last label is empty and it is not the first label, then it is the root label. // Increase the max size by 1, making it 254, to account for the root label's "." // delimiter. This also means we don't need to check the last label's length for being too // long. if ($length > 1 && $labels[$length - 1] === '') { ++$maxDomainSize; array_pop($labels); } if (strlen($domain) > $maxDomainSize) { $error |= self::ERROR_DOMAIN_NAME_TOO_LONG; } foreach ($labels as $label) { if (strlen($label) > self::MAX_LABEL_LENGTH) { $error |= self::ERROR_LABEL_TOO_LONG; break; } } return $error; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Idna; use function array_filter; use const ARRAY_FILTER_USE_KEY; /** * @see https://unicode-org.github.io/icu-docs/apidoc/released/icu4c/uidna_8h.html */ final class IdnaInfo { private const ERRORS = [ Idna::ERROR_EMPTY_LABEL => 'a non-final domain name label (or the whole domain name) is empty', Idna::ERROR_LABEL_TOO_LONG => 'a domain name label is longer than 63 bytes', Idna::ERROR_DOMAIN_NAME_TOO_LONG => 'a domain name is longer than 255 bytes in its storage form', Idna::ERROR_LEADING_HYPHEN => 'a label starts with a hyphen-minus ("-")', Idna::ERROR_TRAILING_HYPHEN => 'a label ends with a hyphen-minus ("-")', Idna::ERROR_HYPHEN_3_4 => 'a label contains hyphen-minus ("-") in the third and fourth positions', Idna::ERROR_LEADING_COMBINING_MARK => 'a label starts with a combining mark', Idna::ERROR_DISALLOWED => 'a label or domain name contains disallowed characters', Idna::ERROR_PUNYCODE => 'a label starts with "xn--" but does not contain valid Punycode', Idna::ERROR_LABEL_HAS_DOT => 'a label contains a dot=full stop', Idna::ERROR_INVALID_ACE_LABEL => 'An ACE label does not contain a valid label string', Idna::ERROR_BIDI => 'a label does not meet the IDNA BiDi requirements (for right-to-left characters)', Idna::ERROR_CONTEXTJ => 'a label does not meet the IDNA CONTEXTJ requirements', Idna::ERROR_CONTEXTO_DIGITS => 'a label does not meet the IDNA CONTEXTO requirements for digits', Idna::ERROR_CONTEXTO_PUNCTUATION => 'a label does not meet the IDNA CONTEXTO requirements for punctuation characters. Some punctuation characters "Would otherwise have been DISALLOWED" but are allowed in certain contexts', ]; /** @var string */ private $result; /** @var bool */ private $isTransitionalDifferent; /** @var int */ private $errors; /** * @var array */ private $errorList; private function __construct(string $result, bool $isTransitionalDifferent, int $errors) { $this->result = $result; $this->errors = $errors; $this->isTransitionalDifferent = $isTransitionalDifferent; $this->errorList = array_filter( self::ERRORS, function (int $error): bool { return 0 !== ($error & $this->errors); }, ARRAY_FILTER_USE_KEY ); } /** * @param array{result:string, isTransitionalDifferent:bool, errors:int} $infos */ public static function fromIntl(array $infos): self { return new self($infos['result'], $infos['isTransitionalDifferent'], $infos['errors']); } /** * @param array{result:string, isTransitionalDifferent:bool, errors:int} $properties */ public static function __set_state(array $properties): self { return self::fromIntl($properties); } public function result(): string { return $this->result; } public function isTransitionalDifferent(): bool { return $this->isTransitionalDifferent; } public function errors(): int { return $this->errors; } public function error(int $error): ?string { return $this->errorList[$error] ?? null; } /** * @return array */ public function errorList(): array { return $this->errorList; } } { "name": "league/uri", "type": "library", "description" : "URI manipulation library", "keywords": [ "url", "uri", "rfc3986", "rfc3987", "rfc6570", "psr-7", "parse_url", "http", "https", "ws", "ftp", "data-uri", "file-uri", "middleware", "parse_str", "query-string", "querystring", "hostname", "uri-template" ], "license": "MIT", "homepage": "https://uri.thephpleague.com", "authors": [ { "name" : "Ignace Nyamagana Butera", "email" : "nyamsprod@gmail.com", "homepage" : "https://nyamsprod.com" } ], "support": { "forum": "https://thephpleague.slack.com", "docs": "https://uri.thephpleague.com", "issues": "https://github.com/thephpleague/uri/issues" }, "funding": [ { "type": "github", "url": "https://github.com/sponsors/nyamsprod" } ], "require": { "php": "^8.1", "ext-json": "*", "psr/http-message": "^1.0.1", "league/uri-interfaces": "^2.3" }, "require-dev": { "friendsofphp/php-cs-fixer": "^v3.9.5", "nyholm/psr7": "^1.5.1", "php-http/psr7-integration-tests": "^1.1.1", "phpbench/phpbench": "^1.2.6", "phpstan/phpstan": "^1.8.5", "phpstan/phpstan-deprecation-rules": "^1.0", "phpstan/phpstan-phpunit": "^1.1.1", "phpstan/phpstan-strict-rules": "^1.4.3", "phpunit/phpunit": "^9.5.24", "psr/http-factory": "^1.0.1" }, "autoload": { "psr-4": { "League\\Uri\\": "src" } }, "autoload-dev": { "psr-4": { "LeagueTest\\Uri\\": "tests" } }, "conflict": { "league/uri-schemes": "^1.0" }, "scripts": { "benchmark": "phpbench run src --report=default", "phpcs": "php-cs-fixer fix -v --diff --dry-run --allow-risky=yes --ansi", "phpcs:fix": "php-cs-fixer fix -vvv --allow-risky=yes --ansi", "phpstan": "phpstan analyse -l max -c phpstan.neon src --ansi --memory-limit=256M", "phpunit": "XDEBUG_MODE=coverage phpunit --coverage-text", "test": [ "@phpunit", "@phpstan", "@phpcs" ] }, "scripts-descriptions": { "phpcs": "Runs coding style test suite", "phpstan": "Runs complete codebase static analysis", "phpunit": "Runs unit and functional testing", "test": "Runs full test suite" }, "suggest": { "league/uri-components" : "Needed to easily manipulate URI objects", "ext-intl" : "Needed to improve host validation", "ext-fileinfo": "Needed to create Data URI from a filepath", "psr/http-factory": "Needed to use the URI factory" }, "extra": { "branch-alias": { "dev-master": "6.x-dev" } }, "config": { "sort-packages": true } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri; use JsonSerializable; use League\Uri\Contracts\UriInterface; use League\Uri\Exceptions\SyntaxError; use Psr\Http\Message\UriInterface as Psr7UriInterface; use Stringable; use function is_scalar; final class Http implements Psr7UriInterface, JsonSerializable { private function __construct(private readonly UriInterface $uri) { $this->validate($this->uri); } /** * Validate the submitted uri against PSR-7 UriInterface. * * @throws SyntaxError if the given URI does not follow PSR-7 UriInterface rules */ private function validate(UriInterface $uri): void { if (null === $uri->getScheme() && '' === $uri->getHost()) { throw new SyntaxError('An URI without scheme can not contains a empty host string according to PSR-7: '.$uri); } $port = $uri->getPort(); if (null !== $port && ($port < 0 || $port > 65535)) { throw new SyntaxError('The URI port is outside the established TCP and UDP port ranges: '.$uri); } } /** * @param array{uri:UriInterface} $components */ public static function __set_state(array $components): self { return new self($components['uri']); } /** * Create a new instance from a string. */ public static function createFromString(Stringable|UriInterface|String $uri = ''): self { return new self(Uri::createFromString($uri)); } /** * Create a new instance from a hash of parse_url parts. * * @param array $components a hash representation of the URI similar * to PHP parse_url function result */ public static function createFromComponents(array $components): self { return new self(Uri::createFromComponents($components)); } /** * Create a new instance from the environment. */ public static function createFromServer(array $server): self { return new self(Uri::createFromServer($server)); } /** * Create a new instance from a URI and a Base URI. * * The returned URI must be absolute. */ public static function createFromBaseUri( Stringable|UriInterface|String $uri, Stringable|UriInterface|String $base_uri = null ): self { return new self(Uri::createFromBaseUri($uri, $base_uri)); } /** * Create a new instance from a URI object. */ public static function createFromUri(Psr7UriInterface|UriInterface $uri): self { if ($uri instanceof UriInterface) { return new self($uri); } return new self(Uri::createFromUri($uri)); } /** * {@inheritDoc} */ public function getScheme(): string { return (string) $this->uri->getScheme(); } /** * {@inheritDoc} */ public function getAuthority(): string { return (string) $this->uri->getAuthority(); } /** * {@inheritDoc} */ public function getUserInfo(): string { return (string) $this->uri->getUserInfo(); } /** * {@inheritDoc} */ public function getHost(): string { return (string) $this->uri->getHost(); } /** * {@inheritDoc} */ public function getPort(): ?int { return $this->uri->getPort(); } /** * {@inheritDoc} */ public function getPath(): string { return $this->uri->getPath(); } /** * {@inheritDoc} */ public function getQuery(): string { return (string) $this->uri->getQuery(); } /** * {@inheritDoc} */ public function getFragment(): string { return (string) $this->uri->getFragment(); } /** * {@inheritDoc} */ public function __toString(): string { return $this->uri->__toString(); } /** * {@inheritDoc} */ public function jsonSerialize(): string { return $this->uri->__toString(); } /** * Safely stringify input when possible for League UriInterface compatibility. * * @throws SyntaxError */ private function filterInput(mixed $str): string|null { if (!is_scalar($str) && !$str instanceof Stringable) { throw new SyntaxError('The component must be a string, a scalar or a Stringable object; `'.gettype($str).'` given.'); } $str = (string) $str; if ('' === $str) { return null; } return $str; } private function newInstance(UriInterface $uri): self { if ((string) $uri === (string) $this->uri) { return $this; } return new self($uri); } /** * {@inheritDoc} */ public function withScheme($scheme): self { return $this->newInstance($this->uri->withScheme($this->filterInput($scheme))); } /** * {@inheritDoc} */ public function withUserInfo($user, $password = null): self { return $this->newInstance($this->uri->withUserInfo($this->filterInput($user), $password)); } /** * {@inheritDoc} */ public function withHost($host): self { return $this->newInstance($this->uri->withHost($this->filterInput($host))); } /** * {@inheritDoc} */ public function withPort($port): self { return $this->newInstance($this->uri->withPort($port)); } /** * {@inheritDoc} */ public function withPath($path): self { return $this->newInstance($this->uri->withPath($path)); } /** * {@inheritDoc} */ public function withQuery($query): self { return $this->newInstance($this->uri->withQuery($this->filterInput($query))); } /** * {@inheritDoc} */ public function withFragment($fragment): self { return $this->newInstance($this->uri->withFragment($this->filterInput($fragment))); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri; use Psr\Http\Message\UriFactoryInterface; use Psr\Http\Message\UriInterface; final class HttpFactory implements UriFactoryInterface { public function createUri(string $uri = ''): UriInterface { return Http::createFromString($uri); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri; use League\Uri\Contracts\UriInterface; use Psr\Http\Message\UriInterface as Psr7UriInterface; use function explode; use function implode; use function preg_replace_callback; use function rawurldecode; final class UriInfo { private const REGEXP_ENCODED_CHARS = ',%(2[D|E]|3\d|4[1-9|A-F]|5[\d|A|F]|6[1-9|A-F]|7[\d|E]),i'; private const WHATWG_SPECIAL_SCHEMES = ['ftp', 'http', 'https', 'ws', 'wss']; /** * @codeCoverageIgnore */ private function __construct() { } private static function emptyComponentValue(Psr7UriInterface|UriInterface $uri): ?string { return $uri instanceof Psr7UriInterface ? '' : null; } /** * Normalizes an URI for comparison. */ private static function normalize(Psr7UriInterface|UriInterface $uri): Psr7UriInterface|UriInterface { $null = self::emptyComponentValue($uri); $path = $uri->getPath(); if ('/' === ($path[0] ?? '') || '' !== $uri->getScheme().$uri->getAuthority()) { $path = UriResolver::resolve($uri, $uri->withPath('')->withQuery($null))->getPath(); } $query = $uri->getQuery(); $fragment = $uri->getFragment(); $fragmentOrig = $fragment; $pairs = null === $query ? [] : explode('&', $query); sort($pairs, SORT_REGULAR); $replace = static fn (array $matches): string => rawurldecode($matches[0]); $retval = preg_replace_callback(self::REGEXP_ENCODED_CHARS, $replace, [$path, implode('&', $pairs), $fragment]); if (null !== $retval) { [$path, $query, $fragment] = $retval + ['', $null, $null]; } if ($null !== $uri->getAuthority() && '' === $path) { $path = '/'; } return $uri ->withHost(Uri::createFromComponents(['host' => $uri->getHost()])->getHost()) ->withPath($path) ->withQuery([] === $pairs ? $null : $query) ->withFragment($null === $fragmentOrig ? $fragmentOrig : $fragment); } /** * Tells whether the URI represents an absolute URI. */ public static function isAbsolute(Psr7UriInterface|UriInterface $uri): bool { return self::emptyComponentValue($uri) !== $uri->getScheme(); } /** * Tell whether the URI represents a network path. */ public static function isNetworkPath(Psr7UriInterface|UriInterface $uri): bool { $null = self::emptyComponentValue($uri); return $null === $uri->getScheme() && $null !== $uri->getAuthority(); } /** * Tells whether the URI represents an absolute path. */ public static function isAbsolutePath(Psr7UriInterface|UriInterface $uri): bool { $null = self::emptyComponentValue($uri); return $null === $uri->getScheme() && $null === $uri->getAuthority() && '/' === ($uri->getPath()[0] ?? ''); } /** * Tell whether the URI represents a relative path. * */ public static function isRelativePath(Psr7UriInterface|UriInterface $uri): bool { $null = self::emptyComponentValue($uri); return $null === $uri->getScheme() && $null === $uri->getAuthority() && '/' !== ($uri->getPath()[0] ?? ''); } /** * Tells whether both URI refers to the same document. */ public static function isSameDocument(Psr7UriInterface|UriInterface $uri, Psr7UriInterface|UriInterface $base_uri): bool { $uri = self::normalize($uri); $base_uri = self::normalize($base_uri); return (string) $uri->withFragment($uri instanceof Psr7UriInterface ? '' : null) === (string) $base_uri->withFragment($base_uri instanceof Psr7UriInterface ? '' : null); } /** * Returns the URI origin property as defined by WHATWG URL living standard. * * {@see https://url.spec.whatwg.org/#origin} * * For URI without a special scheme the method returns null * For URI with the file scheme the method will return null (as this is left to the implementation decision) * For URI with a special scheme the method returns the scheme followed by its authority (without the userinfo part) */ public static function getOrigin(Psr7UriInterface|UriInterface $uri): ?string { $scheme = $uri->getScheme(); if ('blob' === $scheme) { $uri = Uri::createFromString($uri->getPath()); $scheme = $uri->getScheme(); } if (in_array($scheme, self::WHATWG_SPECIAL_SCHEMES, true)) { $null = self::emptyComponentValue($uri); return (string) $uri->withFragment($null)->withQuery($null)->withPath('')->withUserInfo($null, null); } return null; } /** * Tells whether two URI do not share the same origin. * * @see UriInfo::getOrigin() */ public static function isCrossOrigin(Psr7UriInterface|UriInterface $uri, Psr7UriInterface|UriInterface $base_uri): bool { return null === ($uriString = self::getOrigin(Uri::createFromUri($uri))) || null === ($baseUriString = self::getOrigin(Uri::createFromUri($base_uri))) || $uriString !== $baseUriString; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri; use League\Uri\Contracts\UriException; use League\Uri\Contracts\UriInterface; use League\Uri\Exceptions\SyntaxError; use League\Uri\Exceptions\TemplateCanNotBeExpanded; use League\Uri\UriTemplate\Template; use League\Uri\UriTemplate\VariableBag; use Stringable; /** * Defines the URI Template syntax and the process for expanding a URI Template into a URI reference. * * @link https://tools.ietf.org/html/rfc6570 * @package League\Uri * @author Ignace Nyamagana Butera * @since 6.1.0 * * Based on GuzzleHttp\UriTemplate class in Guzzle v6.5. * @link https://github.com/guzzle/guzzle/blob/6.5/src/UriTemplate.php */ final class UriTemplate { public readonly Template $template; public readonly VariableBag $defaultVariables; /** * @throws SyntaxError if the template syntax is invalid * @throws TemplateCanNotBeExpanded if the template variables are invalid */ public function __construct(Template|Stringable|string $template, VariableBag|array $defaultVariables = []) { $this->template = $template instanceof Template ? $template : Template::createFromString($template); $this->defaultVariables = $this->filterVariables($defaultVariables); } public static function __set_state(array $properties): self { return new self($properties['template'], $properties['defaultVariables']); } /** * Filters out variables for the given template. * * @param array> $variables */ private function filterVariables(VariableBag|array $variables): VariableBag { return array_reduce( $this->template->variableNames, function (VariableBag $curry, string $name) use ($variables): VariableBag { if (isset($variables[$name])) { $curry[$name] = $variables[$name]; } return $curry; }, new VariableBag() ); } /** * The template string. */ public function getTemplate(): string { return $this->template->value; } /** * Returns the names of the variables in the template, in order. * * @return string[] */ public function getVariableNames(): array { return $this->template->variableNames; } /** * Returns the default values used to expand the template. * * The returned list only contains variables whose name is part of the current template. * * @return array */ public function getDefaultVariables(): array { return $this->defaultVariables->all(); } /** * Returns a new instance with the updated default variables. * * This method MUST retain the state of the current instance, and return * an instance that contains the modified default variables. * * If present, variables whose name is not part of the current template * possible variable names are removed. */ public function withDefaultVariables(VariableBag|array $defaultDefaultVariables): self { return new self($this->template, $defaultDefaultVariables); } /** * @throws TemplateCanNotBeExpanded if the variable contains nested array values * @throws UriException if the resulting expansion can not be converted to a UriInterface instance */ public function expand(VariableBag|array $variables = []): UriInterface { return Uri::createFromString( $this->template->expand( $this->filterVariables($variables)->replace($this->defaultVariables) ) ); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri; use League\Uri\Contracts\UriInterface; use Psr\Http\Message\UriInterface as Psr7UriInterface; use function array_pop; use function array_reduce; use function count; use function end; use function explode; use function implode; use function in_array; use function str_repeat; use function strpos; use function substr; final class UriResolver { /** * @var array */ const DOT_SEGMENTS = ['.' => 1, '..' => 1]; /** * @codeCoverageIgnore */ private function __construct() { } /** * Resolves an URI against a base URI using RFC3986 rules. * * If the first argument is a UriInterface the method returns a UriInterface object * If the first argument is a Psr7UriInterface the method returns a Psr7UriInterface object */ public static function resolve(Psr7UriInterface|UriInterface $uri, Psr7UriInterface|UriInterface $base_uri): Psr7UriInterface|UriInterface { $null = $uri instanceof Psr7UriInterface ? '' : null; if ($null !== $uri->getScheme()) { return $uri ->withPath(self::removeDotSegments($uri->getPath())); } if ($null !== $uri->getAuthority()) { return $uri ->withScheme($base_uri->getScheme()) ->withPath(self::removeDotSegments($uri->getPath())); } $user = $null; $pass = null; $userInfo = $base_uri->getUserInfo(); if (null !== $userInfo) { [$user, $pass] = explode(':', $userInfo, 2) + [1 => null]; } [$uri_path, $uri_query] = self::resolvePathAndQuery($uri, $base_uri); return $uri ->withPath(self::removeDotSegments($uri_path)) ->withQuery($uri_query) ->withHost($base_uri->getHost()) ->withPort($base_uri->getPort()) ->withUserInfo((string) $user, $pass) ->withScheme($base_uri->getScheme()) ; } /** * Remove dot segments from the URI path. */ private static function removeDotSegments(string $path): string { if (!str_contains($path, '.')) { return $path; } $old_segments = explode('/', $path); $new_path = implode('/', array_reduce($old_segments, UriResolver::reducer(...), [])); if (isset(self::DOT_SEGMENTS[end($old_segments)])) { $new_path .= '/'; } // @codeCoverageIgnoreStart // added because some PSR-7 implementations do not respect RFC3986 if (str_starts_with($path, '/') && !str_starts_with($new_path, '/')) { return '/'.$new_path; } // @codeCoverageIgnoreEnd return $new_path; } /** * Remove dot segments. * * @return array */ private static function reducer(array $carry, string $segment): array { if ('..' === $segment) { array_pop($carry); return $carry; } if (!isset(self::DOT_SEGMENTS[$segment])) { $carry[] = $segment; } return $carry; } /** * Resolves an URI path and query component. * * @return array{0:string, 1:string|null} */ private static function resolvePathAndQuery( Psr7UriInterface|UriInterface $uri, Psr7UriInterface|UriInterface $base_uri ): array { $target_path = $uri->getPath(); $target_query = $uri->getQuery(); $null = $uri instanceof Psr7UriInterface ? '' : null; $baseNull = $base_uri instanceof Psr7UriInterface ? '' : null; if (str_starts_with($target_path, '/')) { return [$target_path, $target_query]; } if ('' === $target_path) { if ($null === $target_query) { $target_query = $base_uri->getQuery(); } $target_path = $base_uri->getPath(); //@codeCoverageIgnoreStart //because some PSR-7 Uri implementations allow this RFC3986 forbidden construction if ($baseNull !== $base_uri->getAuthority() && !str_starts_with($target_path, '/')) { $target_path = '/'.$target_path; } //@codeCoverageIgnoreEnd return [$target_path, $target_query]; } $base_path = $base_uri->getPath(); if ($baseNull !== $base_uri->getAuthority() && '' === $base_path) { $target_path = '/'.$target_path; } if ('' !== $base_path) { $segments = explode('/', $base_path); array_pop($segments); if ([] !== $segments) { $target_path = implode('/', $segments).'/'.$target_path; } } return [$target_path, $target_query]; } /** * Relativizes an URI according to a base URI. * * This method MUST retain the state of the submitted URI instance, and return * an URI instance of the same type that contains the applied modifications. * * This method MUST be transparent when dealing with error and exceptions. * It MUST not alter of silence them apart from validating its own parameters. */ public static function relativize( Psr7UriInterface|UriInterface $uri, Psr7UriInterface|UriInterface $base_uri ): Psr7UriInterface|UriInterface { $uri = self::formatHost($uri); $base_uri = self::formatHost($base_uri); if (!self::isRelativizable($uri, $base_uri)) { return $uri; } $null = $uri instanceof Psr7UriInterface ? '' : null; $uri = $uri->withScheme($null)->withPort(null)->withUserInfo($null)->withHost($null); $target_path = $uri->getPath(); if ($target_path !== $base_uri->getPath()) { return $uri->withPath(self::relativizePath($target_path, $base_uri->getPath())); } if (self::componentEquals('query', $uri, $base_uri)) { return $uri->withPath('')->withQuery($null); } if ($null === $uri->getQuery()) { return $uri->withPath(self::formatPathWithEmptyBaseQuery($target_path)); } return $uri->withPath(''); } /** * Tells whether the component value from both URI object equals. */ private static function componentEquals( string $property, Psr7UriInterface|UriInterface $uri, Psr7UriInterface|UriInterface $base_uri ): bool { return self::getComponent($property, $uri) === self::getComponent($property, $base_uri); } /** * Returns the component value from the submitted URI object. */ private static function getComponent(string $property, Psr7UriInterface|UriInterface $uri): ?string { $component = match ($property) { 'query' => $uri->getQuery(), 'authority' => $uri->getAuthority(), default => $uri->getScheme(), //scheme }; if ($uri instanceof Psr7UriInterface && '' === $component) { return null; } return $component; } /** * Filter the URI object. */ private static function formatHost(Psr7UriInterface|UriInterface $uri): Psr7UriInterface|UriInterface { if (!$uri instanceof Psr7UriInterface) { return $uri; } $host = $uri->getHost(); if ('' === $host) { return $uri; } return $uri->withHost((string) Uri::createFromComponents(['host' => $host])->getHost()); } /** * Tells whether the submitted URI object can be relativize. */ private static function isRelativizable( Psr7UriInterface|UriInterface $uri, Psr7UriInterface|UriInterface $base_uri ): bool { return !UriInfo::isRelativePath($uri) && self::componentEquals('scheme', $uri, $base_uri) && self::componentEquals('authority', $uri, $base_uri); } /** * Relatives the URI for an authority-less target URI. */ private static function relativizePath(string $path, string $basepath): string { $base_segments = self::getSegments($basepath); $target_segments = self::getSegments($path); $target_basename = array_pop($target_segments); array_pop($base_segments); foreach ($base_segments as $offset => $segment) { if (!isset($target_segments[$offset]) || $segment !== $target_segments[$offset]) { break; } unset($base_segments[$offset], $target_segments[$offset]); } $target_segments[] = $target_basename; return self::formatPath( str_repeat('../', count($base_segments)).implode('/', $target_segments), $basepath ); } /** * returns the path segments. * * @return string[] */ private static function getSegments(string $path): array { if ('' !== $path && '/' === $path[0]) { $path = substr($path, 1); } return explode('/', $path); } /** * Formatting the path to keep a valid URI. */ private static function formatPath(string $path, string $basepath): string { if ('' === $path) { return in_array($basepath, ['', '/'], true) ? $basepath : './'; } if (false === ($colon_pos = strpos($path, ':'))) { return $path; } $slash_pos = strpos($path, '/'); if (false === $slash_pos || $colon_pos < $slash_pos) { return "./$path"; } return $path; } /** * Formatting the path to keep a resolvable URI. */ private static function formatPathWithEmptyBaseQuery(string $path): string { $target_segments = self::getSegments($path); /** @var string $basename */ $basename = end($target_segments); return '' === $basename ? './' : $basename; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\Exceptions; use InvalidArgumentException; use League\Uri\Contracts\UriException; class TemplateCanNotBeExpanded extends InvalidArgumentException implements UriException { public static function dueToUnableToProcessValueListWithPrefix(string $variableName): self { return new self('The ":" modifier can not be applied on "'.$variableName.'" since it is a list of values.'); } public static function dueToNestedListOfValue(string $variableName): self { return new self('The "'.$variableName.'" can not be a nested list.'); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri; use League\Uri\Exceptions\IdnaConversionFailed; use League\Uri\Exceptions\IdnSupportMissing; use League\Uri\Exceptions\SyntaxError; use League\Uri\Idna\Idna; use Stringable; use function array_merge; use function explode; use function filter_var; use function inet_pton; use function preg_match; use function rawurldecode; use function sprintf; use function strpos; use function substr; use const FILTER_FLAG_IPV6; use const FILTER_VALIDATE_IP; /** * A class to parse a URI string according to RFC3986. * * @link https://tools.ietf.org/html/rfc3986 * @package League\Uri * @author Ignace Nyamagana Butera * @since 6.0.0 */ final class UriString { /** * Default URI component values. */ private const URI_COMPONENTS = [ 'scheme' => null, 'user' => null, 'pass' => null, 'host' => null, 'port' => null, 'path' => '', 'query' => null, 'fragment' => null, ]; /** * Simple URI which do not need any parsing. */ private const URI_SCHORTCUTS = [ '' => [], '#' => ['fragment' => ''], '?' => ['query' => ''], '?#' => ['query' => '', 'fragment' => ''], '/' => ['path' => '/'], '//' => ['host' => ''], ]; /** * Range of invalid characters in URI string. */ private const REGEXP_INVALID_URI_CHARS = '/[\x00-\x1f\x7f]/'; /** * RFC3986 regular expression URI splitter. * * @link https://tools.ietf.org/html/rfc3986#appendix-B */ private const REGEXP_URI_PARTS = ',^ (?(?[^:/?\#]+):)? # URI scheme component (?//(?[^/?\#]*))? # URI authority part (?[^?\#]*) # URI path component (?\?(?[^\#]*))? # URI query component (?\#(?.*))? # URI fragment component ,x'; /** * URI scheme regular expresssion. * * @link https://tools.ietf.org/html/rfc3986#section-3.1 */ private const REGEXP_URI_SCHEME = '/^([a-z][a-z\d+.-]*)?$/i'; /** * IPvFuture regular expression. * * @link https://tools.ietf.org/html/rfc3986#section-3.2.2 */ private const REGEXP_IP_FUTURE = '/^ v(?[A-F0-9])+\. (?: (?[a-z0-9_~\-\.])| (?[!$&\'()*+,;=:]) # also include the : character )+ $/ix'; /** * General registered name regular expression. * * @link https://tools.ietf.org/html/rfc3986#section-3.2.2 */ private const REGEXP_REGISTERED_NAME = '/(?(DEFINE) (?[a-z0-9_~\-]) # . is missing as it is used to separate labels (?[!$&\'()*+,;=]) (?%[A-F0-9]{2}) (?(?:(?&unreserved)|(?&sub_delims)|(?&encoded))*) ) ^(?:(?®_name)\.)*(?®_name)\.?$/ix'; /** * Invalid characters in host regular expression. * * @link https://tools.ietf.org/html/rfc3986#section-3.2.2 */ private const REGEXP_INVALID_HOST_CHARS = '/ [:\/?#\[\]@ ] # gen-delims characters as well as the space character /ix'; /** * Invalid path for URI without scheme and authority regular expression. * * @link https://tools.ietf.org/html/rfc3986#section-3.3 */ private const REGEXP_INVALID_PATH = ',^(([^/]*):)(.*)?/,'; /** * Host and Port splitter regular expression. */ private const REGEXP_HOST_PORT = ',^(?\[.*\]|[^:]*)(:(?.*))?$,'; /** * IDN Host detector regular expression. */ private const REGEXP_IDN_PATTERN = '/[^\x20-\x7f]/'; /** * Only the address block fe80::/10 can have a Zone ID attach to * let's detect the link local significant 10 bits. */ private const ZONE_ID_ADDRESS_BLOCK = "\xfe\x80"; /** * Generate an URI string representation from its parsed representation * returned by League\UriString::parse() or PHP's parse_url. * * If you supply your own array, you are responsible for providing * valid components without their URI delimiters. * * @link https://tools.ietf.org/html/rfc3986#section-5.3 * @link https://tools.ietf.org/html/rfc3986#section-7.5 * * @param array{scheme:?string, user:?string, pass:?string, host:?string, port:?int, path:?string, query:?string, fragment:?string} $components */ public static function build(array $components): string { $result = $components['path'] ?? ''; if (isset($components['query'])) { $result .= '?'.$components['query']; } if (isset($components['fragment'])) { $result .= '#'.$components['fragment']; } $scheme = null; if (isset($components['scheme'])) { $scheme = $components['scheme'].':'; } if (!isset($components['host'])) { return $scheme.$result; } $scheme .= '//'; $authority = $components['host']; if (isset($components['port'])) { $authority .= ':'.$components['port']; } if (!isset($components['user'])) { return $scheme.$authority.$result; } $authority = '@'.$authority; if (!isset($components['pass'])) { return $scheme.$components['user'].$authority.$result; } return $scheme.$components['user'].':'.$components['pass'].$authority.$result; } /** * Parse an URI string into its components. * * This method parses a URI and returns an associative array containing any * of the various components of the URI that are present. * * * $components = (new Parser())->parse('http://foo@test.example.com:42?query#'); * var_export($components); * //will display * array( * 'scheme' => 'http', // the URI scheme component * 'user' => 'foo', // the URI user component * 'pass' => null, // the URI pass component * 'host' => 'test.example.com', // the URI host component * 'port' => 42, // the URI port component * 'path' => '', // the URI path component * 'query' => 'query', // the URI query component * 'fragment' => '', // the URI fragment component * ); * * * The returned array is similar to PHP's parse_url return value with the following * differences: * *
    *
  • All components are always present in the returned array
    • *
  • Empty and undefined component are treated differently. And empty component is * set to the empty string while an undefined component is set to the `null` value.
    • *
  • The path component is never undefined
    • *
  • The method parses the URI following the RFC3986 rules but you are still * required to validate the returned components against its related scheme specific rules.
    • *
* * @link https://tools.ietf.org/html/rfc3986 * * @param Stringable|string|int|float $uri any scalar or stringable object * * @throws SyntaxError if the URI contains invalid characters * @throws SyntaxError if the URI contains an invalid scheme * @throws SyntaxError if the URI contains an invalid path * * @return array{scheme:?string, user:?string, pass:?string, host:?string, port:?int, path:string, query:?string, fragment:?string} */ public static function parse(Stringable|string|int|float $uri): array { $uri = (string) $uri; if (isset(self::URI_SCHORTCUTS[$uri])) { /** @var array{scheme:?string, user:?string, pass:?string, host:?string, port:?int, path:string, query:?string, fragment:?string} $components */ $components = array_merge(self::URI_COMPONENTS, self::URI_SCHORTCUTS[$uri]); return $components; } if (1 === preg_match(self::REGEXP_INVALID_URI_CHARS, $uri)) { throw new SyntaxError(sprintf('The uri `%s` contains invalid characters', $uri)); } //if the first character is a known URI delimiter parsing can be simplified $first_char = $uri[0]; //The URI is made of the fragment only if ('#' === $first_char) { [, $fragment] = explode('#', $uri, 2); $components = self::URI_COMPONENTS; $components['fragment'] = $fragment; return $components; } //The URI is made of the query and fragment if ('?' === $first_char) { [, $partial] = explode('?', $uri, 2); [$query, $fragment] = explode('#', $partial, 2) + [1 => null]; $components = self::URI_COMPONENTS; $components['query'] = $query; $components['fragment'] = $fragment; return $components; } //use RFC3986 URI regexp to split the URI preg_match(self::REGEXP_URI_PARTS, $uri, $parts); $parts += ['query' => '', 'fragment' => '']; if (':' === $parts['scheme'] || 1 !== preg_match(self::REGEXP_URI_SCHEME, $parts['scontent'])) { throw new SyntaxError(sprintf('The uri `%s` contains an invalid scheme', $uri)); } if ('' === $parts['scheme'].$parts['authority'] && 1 === preg_match(self::REGEXP_INVALID_PATH, $parts['path'])) { throw new SyntaxError(sprintf('The uri `%s` contains an invalid path.', $uri)); } /** @var array{scheme:?string, user:?string, pass:?string, host:?string, port:?int, path:string, query:?string, fragment:?string} $components */ $components = array_merge( self::URI_COMPONENTS, '' === $parts['authority'] ? [] : self::parseAuthority($parts['acontent']), [ 'path' => $parts['path'], 'scheme' => '' === $parts['scheme'] ? null : $parts['scontent'], 'query' => '' === $parts['query'] ? null : $parts['qcontent'], 'fragment' => '' === $parts['fragment'] ? null : $parts['fcontent'], ] ); return $components; } /** * Parses the URI authority part. * * @link https://tools.ietf.org/html/rfc3986#section-3.2 * * @throws SyntaxError If the port component is invalid * * @return array{user:?string, pass:?string, host:?string, port:?int} */ private static function parseAuthority(string $authority): array { $components = ['user' => null, 'pass' => null, 'host' => '', 'port' => null]; if ('' === $authority) { return $components; } $parts = explode('@', $authority, 2); if (isset($parts[1])) { [$components['user'], $components['pass']] = explode(':', $parts[0], 2) + [1 => null]; } preg_match(self::REGEXP_HOST_PORT, $parts[1] ?? $parts[0], $matches); $matches += ['port' => '']; $components['port'] = self::filterPort($matches['port']); $components['host'] = self::filterHost($matches['host']); return $components; } /** * Filter and format the port component. * * @link https://tools.ietf.org/html/rfc3986#section-3.2.2 * * @throws SyntaxError if the registered name is invalid */ private static function filterPort(string $port): ?int { if ('' === $port) { return null; } if (1 === preg_match('/^\d*$/', $port)) { return (int) $port; } throw new SyntaxError(sprintf('The port `%s` is invalid', $port)); } /** * Returns whether a hostname is valid. * * @link https://tools.ietf.org/html/rfc3986#section-3.2.2 * * @throws SyntaxError if the registered name is invalid */ private static function filterHost(string $host): string { if ('' === $host) { return $host; } if ('[' !== $host[0] || !str_ends_with($host, ']')) { return self::filterRegisteredName($host); } if (!self::isIpHost(substr($host, 1, -1))) { throw new SyntaxError(sprintf('Host `%s` is invalid : the IP host is malformed', $host)); } return $host; } /** * Returns whether the host is an IPv4 or a registered named. * * @link https://tools.ietf.org/html/rfc3986#section-3.2.2 * * @throws SyntaxError if the registered name is invalid * @throws IdnSupportMissing if IDN support or ICU requirement are not available or met. */ private static function filterRegisteredName(string $host): string { $formatted_host = rawurldecode($host); if (1 === preg_match(self::REGEXP_REGISTERED_NAME, $formatted_host)) { return $host; } //to test IDN host non-ascii characters must be present in the host if (1 !== preg_match(self::REGEXP_IDN_PATTERN, $formatted_host)) { throw new SyntaxError(sprintf('Host `%s` is invalid : the host is not a valid registered name', $host)); } $info = Idna::toAscii($host, Idna::IDNA2008_ASCII); if (0 !== $info->errors()) { throw IdnaConversionFailed::dueToIDNAError($host, $info); } return $host; } /** * Validates a IPv6/IPvfuture host. * * @link https://tools.ietf.org/html/rfc3986#section-3.2.2 * @link https://tools.ietf.org/html/rfc6874#section-2 * @link https://tools.ietf.org/html/rfc6874#section-4 */ private static function isIpHost(string $ip_host): bool { if (false !== filter_var($ip_host, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { return true; } if (1 === preg_match(self::REGEXP_IP_FUTURE, $ip_host, $matches)) { return !in_array($matches['version'], ['4', '6'], true); } $pos = strpos($ip_host, '%'); if (false === $pos || 1 === preg_match( self::REGEXP_INVALID_HOST_CHARS, rawurldecode(substr($ip_host, $pos)) )) { return false; } $ip_host = substr($ip_host, 0, $pos); return false !== filter_var($ip_host, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6) && str_starts_with((string)inet_pton($ip_host), self::ZONE_ID_ADDRESS_BLOCK); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri; use finfo; use League\Uri\Contracts\UriInterface; use League\Uri\Exceptions\FileinfoSupportMissing; use League\Uri\Exceptions\IdnaConversionFailed; use League\Uri\Exceptions\IdnSupportMissing; use League\Uri\Exceptions\SyntaxError; use League\Uri\Idna\Idna; use Psr\Http\Message\UriInterface as Psr7UriInterface; use SensitiveParameter; use Stringable; use TypeError; use function array_filter; use function array_key_first; use function array_map; use function base64_decode; use function base64_encode; use function count; use function explode; use function file_get_contents; use function filter_var; use function implode; use function in_array; use function inet_pton; use function is_int; use function is_scalar; use function is_string; use function ltrim; use function preg_match; use function preg_replace; use function preg_replace_callback; use function rawurlencode; use function str_contains; use function str_replace; use function strlen; use function strpos; use function strspn; use function strtolower; use function substr; use const FILEINFO_MIME; use const FILTER_FLAG_IPV4; use const FILTER_FLAG_IPV6; use const FILTER_NULL_ON_FAILURE; use const FILTER_VALIDATE_BOOLEAN; use const FILTER_VALIDATE_IP; final class Uri implements UriInterface { /** * RFC3986 invalid characters. * * @link https://tools.ietf.org/html/rfc3986#section-2.2 * * @var string */ private const REGEXP_INVALID_CHARS = '/[\x00-\x1f\x7f]/'; /** * RFC3986 Sub delimiter characters regular expression pattern. * * @link https://tools.ietf.org/html/rfc3986#section-2.2 * * @var string */ private const REGEXP_CHARS_SUBDELIM = "\!\$&'\(\)\*\+,;\=%"; /** * RFC3986 unreserved characters regular expression pattern. * * @link https://tools.ietf.org/html/rfc3986#section-2.3 * * @var string */ private const REGEXP_CHARS_UNRESERVED = 'A-Za-z\d_\-\.~'; /** * RFC3986 schema regular expression pattern. * * @link https://tools.ietf.org/html/rfc3986#section-3.1 */ private const REGEXP_SCHEME = ',^[a-z]([-a-z\d+.]+)?$,i'; /** * RFC3986 host identified by a registered name regular expression pattern. * * @link https://tools.ietf.org/html/rfc3986#section-3.2.2 */ private const REGEXP_HOST_REGNAME = '/^( (?[a-z\d_~\-\.])| (?[!$&\'()*+,;=])| (?%[A-F\d]{2}) )+$/x'; /** * RFC3986 delimiters of the generic URI components regular expression pattern. * * @link https://tools.ietf.org/html/rfc3986#section-2.2 */ private const REGEXP_HOST_GEN_DELIMS = '/[:\/?#\[\]@ ]/'; // Also includes space. /** * RFC3986 IPvFuture regular expression pattern. * * @link https://tools.ietf.org/html/rfc3986#section-3.2.2 */ private const REGEXP_HOST_IPFUTURE = '/^ v(?[A-F\d])+\. (?: (?[a-z\d_~\-\.])| (?[!$&\'()*+,;=:]) # also include the : character )+ $/ix'; /** * RFC3986 IPvFuture host and port component. */ private const REGEXP_HOST_PORT = ',^(?(\[.*]|[^:])*)(:(?[^/?#]*))?$,x'; /** * Significant 10 bits of IP to detect Zone ID regular expression pattern. */ private const HOST_ADDRESS_BLOCK = "\xfe\x80"; /** * Regular expression pattern to for file URI. * contains the volume but not the volume separator. * The volume separator may be URL-encoded (`|` as `%7C`) by ::formatPath(), * so we account for that here. */ private const REGEXP_FILE_PATH = ',^(?/)?(?[a-zA-Z])(?:[:|\|]|%7C)(?.*)?,'; /** * Mimetype regular expression pattern. * * @link https://tools.ietf.org/html/rfc2397 */ private const REGEXP_MIMETYPE = ',^\w+/[-.\w]+(?:\+[-.\w]+)?$,'; /** * Base64 content regular expression pattern. * * @link https://tools.ietf.org/html/rfc2397 */ private const REGEXP_BINARY = ',(;|^)base64$,'; /** * Windows file path string regular expression pattern. * contains both the volume and volume separator. */ private const REGEXP_WINDOW_PATH = ',^(?[a-zA-Z][:|\|]),'; /** * Supported schemes and corresponding default port. * * @var array */ private const SCHEME_DEFAULT_PORT = [ 'data' => null, 'file' => null, 'ftp' => 21, 'gopher' => 70, 'http' => 80, 'https' => 443, 'ws' => 80, 'wss' => 443, ]; /** * Maximum number of formatted host cached. * * @var int */ private const MAXIMUM_FORMATTED_HOST_CACHED = 100; /** * All ASCII letters sorted by typical frequency of occurrence. * * @var string */ private const ASCII = "\x20\x65\x69\x61\x73\x6E\x74\x72\x6F\x6C\x75\x64\x5D\x5B\x63\x6D\x70\x27\x0A\x67\x7C\x68\x76\x2E\x66\x62\x2C\x3A\x3D\x2D\x71\x31\x30\x43\x32\x2A\x79\x78\x29\x28\x4C\x39\x41\x53\x2F\x50\x22\x45\x6A\x4D\x49\x6B\x33\x3E\x35\x54\x3C\x44\x34\x7D\x42\x7B\x38\x46\x77\x52\x36\x37\x55\x47\x4E\x3B\x4A\x7A\x56\x23\x48\x4F\x57\x5F\x26\x21\x4B\x3F\x58\x51\x25\x59\x5C\x09\x5A\x2B\x7E\x5E\x24\x40\x60\x7F\x00\x01\x02\x03\x04\x05\x06\x07\x08\x0B\x0C\x0D\x0E\x0F\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1A\x1B\x1C\x1D\x1E\x1F"; private ?string $scheme; private ?string $user_info; private ?string $host; private ?int $port; private ?string $authority; private string $path; private ?string $query; private ?string $fragment; private ?string $uri; private function __construct( ?string $scheme, ?string $user, #[SensitiveParameter] ?string $pass, ?string $host, ?int $port, string $path, ?string $query, ?string $fragment ) { $this->scheme = $this->formatScheme($scheme); $this->user_info = $this->formatUserInfo($user, $pass); $this->host = $this->formatHost($host); $this->port = $this->formatPort($port); $this->authority = $this->setAuthority(); $this->path = $this->formatPath($path); $this->query = $this->formatQueryAndFragment($query); $this->fragment = $this->formatQueryAndFragment($fragment); $this->assertValidState(); } /** * Format the Scheme and Host component. * * @throws SyntaxError if the scheme is invalid */ private function formatScheme(?string $scheme): ?string { if (null === $scheme || array_key_exists($scheme, self::SCHEME_DEFAULT_PORT)) { return $scheme; } $formatted_scheme = strtolower($scheme); if (array_key_exists($formatted_scheme, self::SCHEME_DEFAULT_PORT) || 1 === preg_match(self::REGEXP_SCHEME, $formatted_scheme)) { return $formatted_scheme; } throw new SyntaxError('The scheme `'.$scheme.'` is invalid.'); } /** * Set the UserInfo component. */ private function formatUserInfo( ?string $user, #[SensitiveParameter] ?string $password ): ?string { if (null === $user) { return null; } static $user_pattern = '/[^%'.self::REGEXP_CHARS_UNRESERVED.self::REGEXP_CHARS_SUBDELIM.']++|%(?![A-Fa-f\d]{2})/'; $user = preg_replace_callback($user_pattern, Uri::urlEncodeMatch(...), $user); if (null === $password) { return $user; } static $password_pattern = '/[^%:'.self::REGEXP_CHARS_UNRESERVED.self::REGEXP_CHARS_SUBDELIM.']++|%(?![A-Fa-f\d]{2})/'; return $user.':'.preg_replace_callback($password_pattern, Uri::urlEncodeMatch(...), $password); } /** * Returns the RFC3986 encoded string matched. */ private static function urlEncodeMatch(array $matches): string { return rawurlencode($matches[0]); } /** * Validate and Format the Host component. */ private function formatHost(?string $host): ?string { if (null === $host || '' === $host) { return $host; } static $formattedHostCache = []; if (isset($formattedHostCache[$host])) { return $formattedHostCache[$host]; } $formattedHost = '[' === $host[0] ? $this->formatIp($host) : $this->formatRegisteredName($host); $formattedHostCache[$host] = $formattedHost; if (self::MAXIMUM_FORMATTED_HOST_CACHED < count($formattedHostCache)) { unset($formattedHostCache[array_key_first($formattedHostCache)]); } return $formattedHost; } /** * Validate and format a registered name. * * The host is converted to its ascii representation if needed * * @throws IdnSupportMissing if the submitted host required missing or misconfigured IDN support * @throws SyntaxError if the submitted host is not a valid registered name */ private function formatRegisteredName(string $host): string { $formatted_host = rawurldecode($host); if (1 === preg_match(self::REGEXP_HOST_REGNAME, $formatted_host)) { return $formatted_host; } if (1 === preg_match(self::REGEXP_HOST_GEN_DELIMS, $formatted_host)) { throw new SyntaxError('The host `'.$host.'` is invalid : a registered name can not contain URI delimiters or spaces.'); } $info = Idna::toAscii($host, Idna::IDNA2008_ASCII); if (0 !== $info->errors()) { throw IdnaConversionFailed::dueToIDNAError($host, $info); } return $info->result(); } /** * Validate and Format the IPv6/IPvfuture host. * * @throws SyntaxError if the submitted host is not a valid IP host */ private function formatIp(string $host): string { $ip = substr($host, 1, -1); if (false !== filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { return $host; } if (1 === preg_match(self::REGEXP_HOST_IPFUTURE, $ip, $matches) && !in_array($matches['version'], ['4', '6'], true)) { return $host; } $pos = strpos($ip, '%'); if (false === $pos) { throw new SyntaxError('The host `'.$host.'` is invalid : the IP host is malformed.'); } if (1 === preg_match(self::REGEXP_HOST_GEN_DELIMS, rawurldecode(substr($ip, $pos)))) { throw new SyntaxError('The host `'.$host.'` is invalid : the IP host is malformed.'); } $ip = substr($ip, 0, $pos); if (false === filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { throw new SyntaxError('The host `'.$host.'` is invalid : the IP host is malformed.'); } //Only the address block fe80::/10 can have a Zone ID attach to //let's detect the link local significant 10 bits if (str_starts_with((string)inet_pton($ip), self::HOST_ADDRESS_BLOCK)) { return $host; } throw new SyntaxError('The host `'.$host.'` is invalid : the IP host is malformed.'); } /** * Format the Port component. * * @throws SyntaxError */ private function formatPort(Stringable|string|int|null $port = null): ?int { if (null === $port || '' === $port) { return null; } if (!is_int($port) && !(is_string($port) && 1 === preg_match('/^\d*$/', $port))) { throw new SyntaxError('The port is expected to be an integer or a string representing an integer; '.gettype($port).' given.'); } $port = (int) $port; if (0 > $port) { throw new SyntaxError('The port `'.$port.'` is invalid.'); } $defaultPort = self::SCHEME_DEFAULT_PORT[$this->scheme] ?? null; if ($defaultPort === $port) { return null; } return $port; } public static function __set_state(array $components): self { $components['user'] = null; $components['pass'] = null; if (null !== $components['user_info']) { [$components['user'], $components['pass']] = explode(':', $components['user_info'], 2) + [1 => null]; } return new self( $components['scheme'], $components['user'], $components['pass'], $components['host'], $components['port'], $components['path'], $components['query'], $components['fragment'] ); } /** * Creates a new instance from a URI and a Base URI. * * The returned URI must be absolute. */ public static function createFromBaseUri( Stringable|UriInterface|String $uri, Stringable|UriInterface|String $base_uri = null ): UriInterface { if (!$uri instanceof UriInterface) { $uri = self::createFromString($uri); } if (null === $base_uri) { if (null === $uri->getScheme()) { throw new SyntaxError('the URI `'.$uri.'` must be absolute.'); } if (null === $uri->getAuthority()) { return $uri; } /** @var UriInterface $uri */ $uri = UriResolver::resolve($uri, $uri->withFragment(null)->withQuery(null)->withPath('')); return $uri; } if (!$base_uri instanceof UriInterface) { $base_uri = self::createFromString($base_uri); } if (null === $base_uri->getScheme()) { throw new SyntaxError('the base URI `'.$base_uri.'` must be absolute.'); } /** @var UriInterface $uri */ $uri = UriResolver::resolve($uri, $base_uri); return $uri; } /** * Create a new instance from a string. */ public static function createFromString(Stringable|string $uri = ''): self { $components = UriString::parse($uri); return new self( $components['scheme'], $components['user'], $components['pass'], $components['host'], $components['port'], $components['path'], $components['query'], $components['fragment'] ); } /** * Create a new instance from a hash representation of the URI similar * to PHP parse_url function result. */ public static function createFromComponents(array $components = []): self { $components += [ 'scheme' => null, 'user' => null, 'pass' => null, 'host' => null, 'port' => null, 'path' => '', 'query' => null, 'fragment' => null, ]; return new self( $components['scheme'], $components['user'], $components['pass'], $components['host'], $components['port'], $components['path'], $components['query'], $components['fragment'] ); } /** * Create a new instance from a data file path. * * @param resource|null $context * * @throws FileinfoSupportMissing If ext/fileinfo is not installed * @throws SyntaxError If the file does not exist or is not readable */ public static function createFromDataPath(string $path, $context = null): self { static $finfo_support = null; $finfo_support = $finfo_support ?? class_exists(finfo::class); // @codeCoverageIgnoreStart if (!$finfo_support) { throw new FileinfoSupportMissing('Please install ext/fileinfo to use the '.__METHOD__.'() method.'); } // @codeCoverageIgnoreEnd $file_args = [$path, false]; $mime_args = [$path, FILEINFO_MIME]; if (null !== $context) { $file_args[] = $context; $mime_args[] = $context; } set_error_handler(fn (int $errno, string $errstr, string $errfile, int $errline) => true); $raw = file_get_contents(...$file_args); restore_error_handler(); if (false === $raw) { throw new SyntaxError('The file `'.$path.'` does not exist or is not readable.'); } $mimetype = (string) (new finfo(FILEINFO_MIME))->file(...$mime_args); return Uri::createFromComponents([ 'scheme' => 'data', 'path' => str_replace(' ', '', $mimetype.';base64,'.base64_encode($raw)), ]); } /** * Create a new instance from a Unix path string. */ public static function createFromUnixPath(string $uri = ''): self { $uri = implode('/', array_map(rawurlencode(...), explode('/', $uri))); if ('/' !== ($uri[0] ?? '')) { return Uri::createFromComponents(['path' => $uri]); } return Uri::createFromComponents(['path' => $uri, 'scheme' => 'file', 'host' => '']); } /** * Create a new instance from a local Windows path string. */ public static function createFromWindowsPath(string $uri = ''): self { $root = ''; if (1 === preg_match(self::REGEXP_WINDOW_PATH, $uri, $matches)) { $root = substr($matches['root'], 0, -1).':'; $uri = substr($uri, strlen($root)); } $uri = str_replace('\\', '/', $uri); $uri = implode('/', array_map(rawurlencode(...), explode('/', $uri))); //Local Windows absolute path if ('' !== $root) { return Uri::createFromComponents(['path' => '/'.$root.$uri, 'scheme' => 'file', 'host' => '']); } //UNC Windows Path if (!str_starts_with($uri, '//')) { return Uri::createFromComponents(['path' => $uri]); } $parts = explode('/', substr($uri, 2), 2) + [1 => null]; return Uri::createFromComponents(['host' => $parts[0], 'path' => '/'.$parts[1], 'scheme' => 'file']); } /** * Create a new instance from a URI object. */ public static function createFromUri(Psr7UriInterface|UriInterface $uri): self { if ($uri instanceof UriInterface) { $user_info = $uri->getUserInfo(); $user = null; $pass = null; if (null !== $user_info) { [$user, $pass] = explode(':', $user_info, 2) + [1 => null]; } return new self( $uri->getScheme(), $user, $pass, $uri->getHost(), $uri->getPort(), $uri->getPath(), $uri->getQuery(), $uri->getFragment() ); } $scheme = $uri->getScheme(); if ('' === $scheme) { $scheme = null; } $fragment = $uri->getFragment(); if ('' === $fragment) { $fragment = null; } $query = $uri->getQuery(); if ('' === $query) { $query = null; } $host = $uri->getHost(); if ('' === $host) { $host = null; } $user_info = $uri->getUserInfo(); $user = null; $pass = null; if ('' !== $user_info) { [$user, $pass] = explode(':', $user_info, 2) + [1 => null]; } return new self( $scheme, $user, $pass, $host, $uri->getPort(), $uri->getPath(), $query, $fragment ); } /** * Create a new instance from the environment. */ public static function createFromServer(array $server): self { $components = ['scheme' => self::fetchScheme($server)]; [$components['user'], $components['pass']] = self::fetchUserInfo($server); [$components['host'], $components['port']] = self::fetchHostname($server); [$components['path'], $components['query']] = self::fetchRequestUri($server); return Uri::createFromComponents($components); } /** * Returns the environment scheme. */ private static function fetchScheme(array $server): string { $server += ['HTTPS' => '']; $res = filter_var($server['HTTPS'], FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE); return false !== $res ? 'https' : 'http'; } /** * Returns the environment user info. * * @return non-empty-array{0:?string, 1:?string} */ private static function fetchUserInfo(array $server): array { $server += ['PHP_AUTH_USER' => null, 'PHP_AUTH_PW' => null, 'HTTP_AUTHORIZATION' => '']; $user = $server['PHP_AUTH_USER']; $pass = $server['PHP_AUTH_PW']; if (str_starts_with(strtolower($server['HTTP_AUTHORIZATION']), 'basic')) { $userinfo = base64_decode(substr($server['HTTP_AUTHORIZATION'], 6), true); if (false === $userinfo) { throw new SyntaxError('The user info could not be detected'); } [$user, $pass] = explode(':', $userinfo, 2) + [1 => null]; } if (null !== $user) { $user = rawurlencode($user); } if (null !== $pass) { $pass = rawurlencode($pass); } return [$user, $pass]; } /** * Returns the environment host. * * @throws SyntaxError If the host can not be detected * * @return array{0:string|null, 1:int|null} */ private static function fetchHostname(array $server): array { $server += ['SERVER_PORT' => null]; if (null !== $server['SERVER_PORT']) { $server['SERVER_PORT'] = (int) $server['SERVER_PORT']; } if (isset($server['HTTP_HOST']) && 1 === preg_match(self::REGEXP_HOST_PORT, $server['HTTP_HOST'], $matches)) { if (isset($matches['port'])) { $matches['port'] = (int) $matches['port']; } return [ $matches['host'], $matches['port'] ?? $server['SERVER_PORT'], ]; } if (!isset($server['SERVER_ADDR'])) { throw new SyntaxError('The host could not be detected'); } if (false === filter_var($server['SERVER_ADDR'], FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) { $server['SERVER_ADDR'] = '['.$server['SERVER_ADDR'].']'; } return [$server['SERVER_ADDR'], $server['SERVER_PORT']]; } /** * Returns the environment path. * * @return non-empty-array{0:?string, 1:?string} */ private static function fetchRequestUri(array $server): array { $server += ['IIS_WasUrlRewritten' => null, 'UNENCODED_URL' => '', 'PHP_SELF' => '', 'QUERY_STRING' => null]; if ('1' === $server['IIS_WasUrlRewritten'] && '' !== $server['UNENCODED_URL']) { return explode('?', $server['UNENCODED_URL'], 2) + [1 => null]; } if (isset($server['REQUEST_URI'])) { [$path] = explode('?', $server['REQUEST_URI'], 2); $query = ('' !== $server['QUERY_STRING']) ? $server['QUERY_STRING'] : null; return [$path, $query]; } return [$server['PHP_SELF'], $server['QUERY_STRING']]; } /** * Generate the URI authority part. */ private function setAuthority(): ?string { $authority = null; if (null !== $this->user_info) { $authority = $this->user_info.'@'; } if (null !== $this->host) { $authority .= $this->host; } if (null !== $this->port) { $authority .= ':'.$this->port; } return $authority; } /** * Format the Path component. */ private function formatPath(string $path): string { if ('data' === $this->scheme) { $path = $this->formatDataPath($path); } if ('/' !== $path) { static $pattern = '/[^'.self::REGEXP_CHARS_UNRESERVED.self::REGEXP_CHARS_SUBDELIM.':@\/}{]++|%(?![A-Fa-f\d]{2})/'; $path = (string) preg_replace_callback($pattern, Uri::urlEncodeMatch(...), $path); } if ('file' === $this->scheme) { $path = $this->formatFilePath($path); } return $path; } /** * Filter the Path component. * * @link https://tools.ietf.org/html/rfc2397 * * @throws SyntaxError If the path is not compliant with RFC2397 */ private function formatDataPath(string $path): string { if ('' == $path) { return 'text/plain;charset=us-ascii,'; } if (strlen($path) !== strspn($path, self::ASCII) || !str_contains($path, ',')) { throw new SyntaxError('The path `'.$path.'` is invalid according to RFC2937.'); } $parts = explode(',', $path, 2) + [1 => null]; $mediatype = explode(';', (string) $parts[0], 2) + [1 => null]; $data = (string) $parts[1]; $mimetype = $mediatype[0]; if (null === $mimetype || '' === $mimetype) { $mimetype = 'text/plain'; } $parameters = $mediatype[1]; if (null === $parameters || '' === $parameters) { $parameters = 'charset=us-ascii'; } $this->assertValidPath($mimetype, $parameters, $data); return $mimetype.';'.$parameters.','.$data; } /** * Assert the path is a compliant with RFC2397. * * @link https://tools.ietf.org/html/rfc2397 * * @throws SyntaxError If the mediatype or the data are not compliant with the RFC2397 */ private function assertValidPath(string $mimetype, string $parameters, string $data): void { if (1 !== preg_match(self::REGEXP_MIMETYPE, $mimetype)) { throw new SyntaxError('The path mimetype `'.$mimetype.'` is invalid.'); } $is_binary = 1 === preg_match(self::REGEXP_BINARY, $parameters, $matches); if ($is_binary) { $parameters = substr($parameters, 0, - strlen($matches[0])); } $res = array_filter(array_filter(explode(';', $parameters), $this->validateParameter(...))); if ([] !== $res) { throw new SyntaxError('The path paremeters `'.$parameters.'` is invalid.'); } if (!$is_binary) { return; } $res = base64_decode($data, true); if (false === $res || $data !== base64_encode($res)) { throw new SyntaxError('The path data `'.$data.'` is invalid.'); } } /** * Validate mediatype parameter. */ private function validateParameter(string $parameter): bool { $properties = explode('=', $parameter); return 2 != count($properties) || 'base64' === strtolower($properties[0]); } /** * Format path component for file scheme. */ private function formatFilePath(string $path): string { $replace = static function (array $matches): string { return $matches['delim'].$matches['volume'].':'.$matches['rest']; }; return (string) preg_replace_callback(self::REGEXP_FILE_PATH, $replace, $path); } /** * Format the Query or the Fragment component. * * Returns a array containing: *
    *
  • the formatted component (a string or null)
    • *
  • a boolean flag telling wether the delimiter is to be added to the component * when building the URI string representation
    • *
*/ private function formatQueryAndFragment(?string $component): ?string { if (null === $component || '' === $component) { return $component; } static $pattern = '/[^'.self::REGEXP_CHARS_UNRESERVED.self::REGEXP_CHARS_SUBDELIM.':@\/?]++|%(?![A-Fa-f\d]{2})/'; return preg_replace_callback($pattern, Uri::urlEncodeMatch(...), $component); } /** * assert the URI internal state is valid. * * @link https://tools.ietf.org/html/rfc3986#section-3 * @link https://tools.ietf.org/html/rfc3986#section-3.3 * * @throws SyntaxError if the URI is in an invalid state according to RFC3986 * @throws SyntaxError if the URI is in an invalid state according to scheme specific rules */ private function assertValidState(): void { if (null !== $this->authority && ('' !== $this->path && '/' !== $this->path[0])) { throw new SyntaxError('If an authority is present the path must be empty or start with a `/`.'); } if (null === $this->authority && str_starts_with($this->path, '//')) { throw new SyntaxError('If there is no authority the path `'.$this->path.'` can not start with a `//`.'); } $pos = strpos($this->path, ':'); if (null === $this->authority && null === $this->scheme && false !== $pos && !str_contains(substr($this->path, 0, $pos), '/') ) { throw new SyntaxError('In absence of a scheme and an authority the first path segment cannot contain a colon (":") character.'); } $this->uri = null; if (! match ($this->scheme) { 'data' => $this->isUriWithSchemeAndPathOnly(), 'file' => $this->isUriWithSchemeHostAndPathOnly(), 'ftp', 'gopher' => $this->isNonEmptyHostUriWithoutFragmentAndQuery(), 'http', 'https' => $this->isNonEmptyHostUri(), 'ws', 'wss' => $this->isNonEmptyHostUriWithoutFragment(), default => true, }) { throw new SyntaxError('The uri `'.$this.'` is invalid for the `'.$this->scheme.'` scheme.'); } } /** * URI validation for URI schemes which allows only scheme and path components. */ private function isUriWithSchemeAndPathOnly(): bool { return null === $this->authority && null === $this->query && null === $this->fragment; } /** * URI validation for URI schemes which allows only scheme, host and path components. */ private function isUriWithSchemeHostAndPathOnly(): bool { return null === $this->user_info && null === $this->port && null === $this->query && null === $this->fragment && !('' != $this->scheme && null === $this->host); } /** * URI validation for URI schemes which disallow the empty '' host. */ private function isNonEmptyHostUri(): bool { return '' !== $this->host && !(null !== $this->scheme && null === $this->host); } /** * URI validation for URIs schemes which disallow the empty '' host * and forbids the fragment component. */ private function isNonEmptyHostUriWithoutFragment(): bool { return $this->isNonEmptyHostUri() && null === $this->fragment; } /** * URI validation for URIs schemes which disallow the empty '' host * and forbids fragment and query components. */ private function isNonEmptyHostUriWithoutFragmentAndQuery(): bool { return $this->isNonEmptyHostUri() && null === $this->fragment && null === $this->query; } /** * Generate the URI string representation from its components. * * @link https://tools.ietf.org/html/rfc3986#section-5.3 */ private function getUriString( ?string $scheme, ?string $authority, string $path, ?string $query, ?string $fragment ): string { if (null !== $scheme) { $scheme = $scheme.':'; } if (null !== $authority) { $authority = '//'.$authority; } if (null !== $query) { $query = '?'.$query; } if (null !== $fragment) { $fragment = '#'.$fragment; } return $scheme.$authority.$path.$query.$fragment; } public function toString(): string { return $this->uri ??= $this->getUriString( $this->scheme, $this->authority, $this->path, $this->query, $this->fragment ); } /** * {@inheritDoc} */ public function __toString(): string { return $this->toString(); } /** * {@inheritDoc} */ public function jsonSerialize(): string { return $this->toString(); } /** * @return array{ * scheme:?string, * user_info:?string, * host:?string, * port:?int, * path:string, * query:?string, * fragment:?string * } */ public function __debugInfo(): array { return [ 'scheme' => $this->scheme, 'user_info' => isset($this->user_info) ? preg_replace(',:(.*).?$,', ':***', $this->user_info) : null, 'host' => $this->host, 'port' => $this->port, 'path' => $this->path, 'query' => $this->query, 'fragment' => $this->fragment, ]; } /** * {@inheritDoc} */ public function getScheme(): ?string { return $this->scheme; } /** * {@inheritDoc} */ public function getAuthority(): ?string { return $this->authority; } /** * {@inheritDoc} */ public function getUserInfo(): ?string { return $this->user_info; } /** * {@inheritDoc} */ public function getHost(): ?string { return $this->host; } /** * {@inheritDoc} */ public function getPort(): ?int { return $this->port; } /** * {@inheritDoc} */ public function getPath(): string { if (str_starts_with($this->path, '//')) { return '/'.ltrim($this->path, '/'); } return $this->path; } /** * {@inheritDoc} */ public function getQuery(): ?string { return $this->query; } /** * {@inheritDoc} */ public function getFragment(): ?string { return $this->fragment; } /** * {@inheritDoc} */ public function withScheme($scheme): UriInterface { $scheme = $this->formatScheme($this->filterString($scheme)); if ($scheme === $this->scheme) { return $this; } $clone = clone $this; $clone->scheme = $scheme; $clone->port = $clone->formatPort($clone->port); $clone->authority = $clone->setAuthority(); $clone->assertValidState(); return $clone; } /** * Filter a string. * * @param mixed $str the value to evaluate as a string * * @throws SyntaxError if the submitted data can not be converted to string */ private function filterString(mixed $str): ?string { if (null === $str) { return null; } if (!is_scalar($str) && !$str instanceof Stringable) { throw new SyntaxError('The component must be a string, a scalar or a Stringable object; `'.gettype($str).'` given.'); } $str = (string) $str; if (1 !== preg_match(self::REGEXP_INVALID_CHARS, $str)) { return $str; } throw new SyntaxError('The component `'.$str.'` contains invalid characters.'); } /** * {@inheritDoc} */ public function withUserInfo( $user, #[SensitiveParameter] $password = null ): UriInterface { $user_info = null; $user = $this->filterString($user); if (null !== $password) { $password = $this->filterString($password); } if ('' !== $user) { $user_info = $this->formatUserInfo($user, $password); } if ($user_info === $this->user_info) { return $this; } $clone = clone $this; $clone->user_info = $user_info; $clone->authority = $clone->setAuthority(); $clone->assertValidState(); return $clone; } /** * {@inheritDoc} */ public function withHost($host): UriInterface { $host = $this->formatHost($this->filterString($host)); if ($host === $this->host) { return $this; } $clone = clone $this; $clone->host = $host; $clone->authority = $clone->setAuthority(); $clone->assertValidState(); return $clone; } /** * {@inheritDoc} */ public function withPort($port): UriInterface { $port = $this->formatPort($port); if ($port === $this->port) { return $this; } $clone = clone $this; $clone->port = $port; $clone->authority = $clone->setAuthority(); $clone->assertValidState(); return $clone; } /** * {@inheritDoc} * * @param string|object $path */ public function withPath($path): UriInterface { $path = $this->filterString($path); if (null === $path) { throw new TypeError('A path must be a string NULL given.'); } $path = $this->formatPath($path); if ($path === $this->path) { return $this; } $clone = clone $this; $clone->path = $path; $clone->assertValidState(); return $clone; } /** * {@inheritDoc} */ public function withQuery($query): UriInterface { $query = $this->formatQueryAndFragment($this->filterString($query)); if ($query === $this->query) { return $this; } $clone = clone $this; $clone->query = $query; $clone->assertValidState(); return $clone; } /** * {@inheritDoc} */ public function withFragment($fragment): UriInterface { $fragment = $this->formatQueryAndFragment($this->filterString($fragment)); if ($fragment === $this->fragment) { return $this; } $clone = clone $this; $clone->fragment = $fragment; $clone->assertValidState(); return $clone; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\UriTemplate; use League\Uri\Exceptions\SyntaxError; use League\Uri\Exceptions\TemplateCanNotBeExpanded; use Stringable; use function array_unique; use function preg_match_all; use function preg_replace; use function str_contains; use const PREG_SET_ORDER; final class Template { /** * Expression regular expression pattern. */ private const REGEXP_EXPRESSION_DETECTOR = '/\{[^}]*}/x'; /** @var array */ private array $expressions = []; /** @var array */ public readonly array $variableNames; private function __construct(public readonly string $value, Expression ...$expressions) { $variableNames = []; foreach ($expressions as $expression) { $this->expressions[$expression->value] = $expression; $variableNames = [...$variableNames, ...$expression->variableNames]; } $this->variableNames = array_unique($variableNames); } /** * @param array{value:string, template?:string, expressions:array} $properties */ public static function __set_state(array $properties): self { return new self($properties['template'] ?? $properties['value'], ...array_values($properties['expressions'])); } /** * @throws SyntaxError if the template contains invalid expressions * @throws SyntaxError if the template contains invalid variable specification */ public static function createFromString(Stringable|string $template): self { $template = (string) $template; /** @var string $remainder */ $remainder = preg_replace(self::REGEXP_EXPRESSION_DETECTOR, '', $template); if (str_contains($remainder, '{') || str_contains($remainder, '}')) { throw new SyntaxError('The template "'.$template.'" contains invalid expressions.'); } $names = []; preg_match_all(self::REGEXP_EXPRESSION_DETECTOR, $template, $findings, PREG_SET_ORDER); $arguments = []; foreach ($findings as $finding) { if (!isset($names[$finding[0]])) { $arguments[] = Expression::createFromString($finding[0]); $names[$finding[0]] = 1; } } return new self($template, ...$arguments); } /** * @deprecated since version 6.6.0 use the readonly property instead * @codeCoverageIgnore */ public function toString(): string { return $this->value; } /** * @deprecated since version 6.6.0 use the readonly property instead * @codeCoverageIgnore * * @return array */ public function variableNames(): array { return $this->variableNames; } /** * @throws TemplateCanNotBeExpanded if the variables is an array and a ":" modifier needs to be applied * @throws TemplateCanNotBeExpanded if the variables contains nested array values */ public function expand(VariableBag $variables): string { $uriString = $this->value; /** @var Expression $expression */ foreach ($this->expressions as $pattern => $expression) { $uriString = str_replace($pattern, $expression->expand($variables), $uriString); } return $uriString; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\UriTemplate; use ArrayAccess; use Countable; use League\Uri\Exceptions\TemplateCanNotBeExpanded; use Stringable; use function is_bool; use function is_object; use function is_scalar; /** * @implements ArrayAccess> */ final class VariableBag implements ArrayAccess, Countable { /** * @var array> */ private array $variables = []; /** * @param iterable> $variables */ public function __construct(iterable $variables = []) { foreach ($variables as $name => $value) { $this->assign($name, $value); } } public function count(): int { return count($this->variables); } /** * @param array{variables: array>} $properties */ public static function __set_state(array $properties): self { return new self($properties['variables']); } public function offsetExists(mixed $offset): bool { return array_key_exists($offset, $this->variables); } public function offsetUnset(mixed $offset): void { unset($this->variables[$offset]); } public function offsetSet(mixed $offset, mixed $value): void { $this->assign($offset, $value); /* @phpstan-ignore-line */ } public function offsetGet(mixed $offset): mixed { return $this->fetch($offset); } /** * @return array> */ public function all(): array { return $this->variables; } /** * Tells whether the bag is empty or not. */ public function isEmpty(): bool { return [] === $this->variables; } /** * Fetches the variable value if none found returns null. * * @return null|string|array */ public function fetch(string $name): null|string|array { return $this->variables[$name] ?? null; } /** * @param string|bool|int|float|null|array $value */ public function assign(string $name, string|bool|int|float|array|null $value): void { $this->variables[$name] = $this->normalizeValue($value, $name, true); } /** * @param Stringable|string|float|int|bool|null $value the value to be expanded * * @throws TemplateCanNotBeExpanded if the value contains nested list */ private function normalizeValue(Stringable|array|string|float|int|bool|null $value, string $name, bool $isNestedListAllowed): array|string { return match (true) { is_bool($value) => true === $value ? '1' : '0', (null === $value || is_scalar($value) || is_object($value)) => (string) $value, !$isNestedListAllowed => throw TemplateCanNotBeExpanded::dueToNestedListOfValue($name), default => array_map(fn ($var): array|string => self::normalizeValue($var, $name, false), $value), }; } /** * Replaces elements from passed variables into the current instance. */ public function replace(VariableBag $variables): self { return new self($this->variables + $variables->variables); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\UriTemplate; use League\Uri\Exceptions\SyntaxError; use function preg_match; final class VarSpecifier { /** * Variables specification regular expression pattern. * * @link https://tools.ietf.org/html/rfc6570#section-2.3 */ private const REGEXP_VARSPEC = '/^ (?(?:[A-z0-9_\.]|%[0-9a-fA-F]{2})+) (?\:(?\d+)|\*)? $/x'; private function __construct( public readonly string $name, public readonly string $modifier, public readonly int $position ) { } /** * @param array{name: string, modifier:string, position:int} $properties */ public static function __set_state(array $properties): self { return new self($properties['name'], $properties['modifier'], $properties['position']); } public static function createFromString(string $specification): self { if (1 !== preg_match(self::REGEXP_VARSPEC, $specification, $parsed)) { throw new SyntaxError('The variable specification "'.$specification.'" is invalid.'); } $parsed += ['modifier' => '', 'position' => '']; if ('' !== $parsed['position']) { $parsed['position'] = (int) $parsed['position']; $parsed['modifier'] = ':'; } if ('' === $parsed['position']) { $parsed['position'] = 0; } if (10000 <= $parsed['position']) { throw new SyntaxError('The variable specification "'.$specification.'" is invalid the position modifier must be lower than 10000.'); } return new self($parsed['name'], $parsed['modifier'], $parsed['position']); } public function toString(): string { if (0 < $this->position) { return $this->name.$this->modifier.$this->position; } return $this->name.$this->modifier; } /** * @codeCoverageIgnore * @deprecated since version 6.6.0 use the readonly property instead */ public function name(): string { return $this->name; } /** * @codeCoverageIgnore * @deprecated since version 6.6.0 use the readonly property instead */ public function modifier(): string { return $this->modifier; } /** * @codeCoverageIgnore * @deprecated since version 6.6.0 use the readonly property instead */ public function position(): int { return $this->position; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri\UriTemplate; use League\Uri\Exceptions\SyntaxError; use League\Uri\Exceptions\TemplateCanNotBeExpanded; use function array_filter; use function array_map; use function array_unique; use function explode; use function implode; use function preg_match; use function rawurlencode; use function str_replace; use function substr; final class Expression { /** * Expression regular expression pattern. * * @link https://tools.ietf.org/html/rfc6570#section-2.2 */ private const REGEXP_EXPRESSION = '/^\{ (?: (?[\.\/;\?&\=,\!@\|\+#])? (?[^\}]*) ) \}$/x'; /** * Reserved Operator characters. * * @link https://tools.ietf.org/html/rfc6570#section-2.2 */ private const RESERVED_OPERATOR = '=,!@|'; /** * Processing behavior according to the expression type operator. * * @link https://tools.ietf.org/html/rfc6570#appendix-A */ private const OPERATOR_HASH_LOOKUP = [ '' => ['prefix' => '', 'joiner' => ',', 'query' => false], '+' => ['prefix' => '', 'joiner' => ',', 'query' => false], '#' => ['prefix' => '#', 'joiner' => ',', 'query' => false], '.' => ['prefix' => '.', 'joiner' => '.', 'query' => false], '/' => ['prefix' => '/', 'joiner' => '/', 'query' => false], ';' => ['prefix' => ';', 'joiner' => ';', 'query' => true], '?' => ['prefix' => '?', 'joiner' => '&', 'query' => true], '&' => ['prefix' => '&', 'joiner' => '&', 'query' => true], ]; /** @var array */ private array $varSpecifiers; private string $joiner; /** @var array */ public readonly array $variableNames; public readonly string $value; private function __construct(private string $operator, VarSpecifier ...$varSpecifiers) { $this->varSpecifiers = $varSpecifiers; $this->joiner = self::OPERATOR_HASH_LOOKUP[$operator]['joiner']; $this->variableNames = array_unique(array_map( static fn (VarSpecifier $varSpecifier): string => $varSpecifier->name, $varSpecifiers )); $this->value = '{'.$operator.implode(',', array_map( static fn (VarSpecifier $varSpecifier): string => $varSpecifier->toString(), $varSpecifiers )).'}'; } /** * @param array{operator:string, varSpecifiers:array} $properties */ public static function __set_state(array $properties): self { return new self($properties['operator'], ...$properties['varSpecifiers']); } /** * @throws SyntaxError if the expression is invalid * @throws SyntaxError if the operator used in the expression is invalid * @throws SyntaxError if the variable specifiers is invalid */ public static function createFromString(string $expression): self { if (1 !== preg_match(self::REGEXP_EXPRESSION, $expression, $parts)) { throw new SyntaxError('The expression "'.$expression.'" is invalid.'); } /** @var array{operator:string, variables:string} $parts */ $parts = $parts + ['operator' => '']; if ('' !== $parts['operator'] && str_contains(self::RESERVED_OPERATOR, $parts['operator'])) { throw new SyntaxError('The operator used in the expression "'.$expression.'" is reserved.'); } return new Expression($parts['operator'], ...array_map( static fn (string $varSpec): VarSpecifier => VarSpecifier::createFromString($varSpec), explode(',', $parts['variables']) )); } /** * Returns the expression string representation. * * @deprecated since version 6.6.0 use the readonly property instead * @codeCoverageIgnore */ public function toString(): string { return $this->value; } /** * @deprecated since version 6.6.0 use the readonly property instead * @codeCoverageIgnore * * @return array */ public function variableNames(): array { return $this->variableNames; } public function expand(VariableBag $variables): string { $parts = []; foreach ($this->varSpecifiers as $varSpecifier) { $parts[] = $this->replace($varSpecifier, $variables); } $expanded = implode($this->joiner, array_filter($parts, static fn ($value): bool => '' !== $value)); if ('' === $expanded) { return $expanded; } $prefix = self::OPERATOR_HASH_LOOKUP[$this->operator]['prefix']; if ('' === $prefix) { return $expanded; } return $prefix.$expanded; } /** * Replaces an expression with the given variables. * * @throws TemplateCanNotBeExpanded if the variables is an array and a ":" modifier needs to be applied * @throws TemplateCanNotBeExpanded if the variables contains nested array values */ private function replace(VarSpecifier $varSpec, VariableBag $variables): string { $value = $variables->fetch($varSpec->name); if (null === $value) { return ''; } $useQuery = self::OPERATOR_HASH_LOOKUP[$this->operator]['query']; [$expanded, $actualQuery] = $this->inject($value, $varSpec, $useQuery); if (!$actualQuery) { return $expanded; } if ('&' !== $this->joiner && '' === $expanded) { return $varSpec->name; } return $varSpec->name.'='.$expanded; } /** * @param string|array $value * * @return array{0:string, 1:bool} */ private function inject(array|string $value, VarSpecifier $varSpec, bool $useQuery): array { if (is_string($value)) { return $this->replaceString($value, $varSpec, $useQuery); } return $this->replaceList($value, $varSpec, $useQuery); } /** * Expands an expression using a string value. * * @return array{0:string, 1:bool} */ private function replaceString(string $value, VarSpecifier $varSpec, bool $useQuery): array { if (':' === $varSpec->modifier) { $value = substr($value, 0, $varSpec->position); } if (in_array($this->operator, ['+', '#'], true)) { return [$this->decodeReserved(rawurlencode($value)), $useQuery]; } return [rawurlencode($value), $useQuery]; } /** * Expands an expression using a list of values. * * @param array $value * * @throws TemplateCanNotBeExpanded if the variables is an array and a ":" modifier needs to be applied * * @return array{0:string, 1:bool} */ private function replaceList(array $value, VarSpecifier $varSpec, bool $useQuery): array { if ([] === $value) { return ['', false]; } if (':' === $varSpec->modifier) { throw TemplateCanNotBeExpanded::dueToUnableToProcessValueListWithPrefix($varSpec->name); } $pairs = []; $isList = array_is_list($value); foreach ($value as $key => $var) { if (!$isList) { $key = rawurlencode((string) $key); } $var = rawurlencode($var); if (in_array($this->operator, ['+', '#'], true)) { $var = $this->decodeReserved($var); } if ('*' === $varSpec->modifier) { if (!$isList) { $var = $key.'='.$var; } elseif ($key > 0 && $useQuery) { $var = $varSpec->name.'='.$var; } } $pairs[$key] = $var; } if ('*' === $varSpec->modifier) { if (!$isList) { // Don't prepend the value name when using the `explode` modifier with an associative array. $useQuery = false; } return [implode($this->joiner, $pairs), $useQuery]; } if (!$isList) { // When an associative array is encountered and the `explode` modifier is not set, then // the result must be a comma separated list of keys followed by their respective values. foreach ($pairs as $offset => &$data) { $data = $offset.','.$data; } unset($data); } return [implode(',', $pairs), $useQuery]; } /** * Removes percent encoding on reserved characters (used with + and # modifiers). */ private function decodeReserved(string $str): string { static $delimiters = [ ':', '/', '?', '#', '[', ']', '@', '!', '$', '&', '\'', '(', ')', '*', '+', ',', ';', '=', ]; static $delimitersEncoded = [ '%3A', '%2F', '%3F', '%23', '%5B', '%5D', '%40', '%21', '%24', '%26', '%27', '%28', '%29', '%2A', '%2B', '%2C', '%3B', '%3D', ]; return str_replace($delimitersEncoded, $delimiters, $str); } } { "name": "league/uri-parser", "type": "library", "description" : "userland URI parser RFC 3986 compliant", "keywords": [ "url", "uri", "rfc3986", "rfc3987", "parse_url", "parser" ], "license": "MIT", "homepage": "https://github.com/thephpleague/uri-parser", "authors": [ { "name" : "Ignace Nyamagana Butera", "email" : "nyamsprod@gmail.com", "homepage" : "https://nyamsprod.com" } ], "require": { "php" : ">=7.0.0" }, "require-dev": { "friendsofphp/php-cs-fixer": "^2.0", "phpunit/phpunit" : "^6.0", "phpstan/phpstan": "^0.9.2", "phpstan/phpstan-strict-rules": "^0.9.0", "phpstan/phpstan-phpunit": "^0.9.4" }, "autoload": { "psr-4": { "League\\Uri\\": "src" }, "files": ["src/functions_include.php"] }, "autoload-dev": { "psr-4": { "LeagueTest\\Uri\\Parser\\": "tests" } }, "suggest": { "ext-intl" : "Allow parsing RFC3987 compliant hosts", "league/uri-schemes": "Allow validating and normalizing URI parsing results" }, "scripts": { "phpcs": "php-cs-fixer fix -v --diff --dry-run --allow-risky=yes;", "phpstan-src": "phpstan analyse -l 7 -c phpstan.src.neon src", "phpstan-tests": "phpstan analyse -l 7 -c phpstan.tests.neon tests", "phpstan": [ "@phpstan-src", "@phpstan-tests" ], "phpunit": "phpunit --coverage-text", "test": [ "@phpunit", "@phpcs", "@phpstan" ] }, "extra": { "branch-alias": { "dev-master": "1.x-dev" } }, "config": { "sort-packages": true } } * @license https://github.com/thephpleague/uri-parser/blob/master/LICENSE (MIT License) * @version 1.4.1 * @link https://uri.thephpleague.com/parser/ * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri; /** * Returns whether the URI host component is valid according to RFC3986. * * @see https://tools.ietf.org/html/rfc3986#section-3.2.2 * @see Parser::isHost() */ function is_host(string $host): bool { static $parser; $parser = $parser ?? new Parser(); return $parser->isHost($host); } /** * Returns whether the URI port component is valid according to RFC3986. * * @see https://tools.ietf.org/html/rfc3986#section-3.2.3 * @see Parser::isPort() */ function is_port($port): bool { static $parser; $parser = $parser ?? new Parser(); return $parser->isPort($port); } /** * Returns whether the URI scheme component is valid according to RFC3986. * * @see https://tools.ietf.org/html/rfc3986#section-3.1 * @see Parser::isScheme() */ function is_scheme(string $scheme): bool { static $parser; $parser = $parser ?? new Parser(); return $parser->isScheme($scheme); } /** * Parse an URI string into its components. * * This method parses a URL and returns an associative array containing any * of the various components of the URL that are present. * * @see https://tools.ietf.org/html/rfc3986 * @see https://tools.ietf.org/html/rfc3986#section-2 * @see Parser::parse() * * @throws Exception if the URI contains invalid characters */ function parse(string $uri): array { static $parser; $parser = $parser ?? new Parser(); return $parser->parse($uri); } /** * Generate an URI string representation from its parsed representation * returned by League\Uri\Parser::parse() or PHP's parse_url. * * If you supply your own array, you are responsible for providing * valid components without their URI delimiters. * * For security reasons the password (pass) component has been deprecated * as per RFC3986 and is never returned in the URI string * * @see https://tools.ietf.org/html/rfc3986#section-5.3 * @see https://tools.ietf.org/html/rfc3986#section-7.5 */ function build(array $components): string { $uri = $components['path'] ?? ''; if (isset($components['query'])) { $uri .= '?'.$components['query']; } if (isset($components['fragment'])) { $uri .= '#'.$components['fragment']; } if (isset($components['host'])) { $authority = $components['host']; if (isset($components['port'])) { $authority .= ':'.$components['port']; } if (isset($components['user'])) { $authority = $components['user'].'@'.$authority; } $uri = '//'.$authority.$uri; } if (isset($components['scheme'])) { return $components['scheme'].':'.$uri; } return $uri; } * @license https://github.com/thephpleague/uri-parser/blob/master/LICENSE (MIT License) * @version 1.4.1 * @link https://uri.thephpleague.com/parser/ * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri; use InvalidArgumentException; /** * An exception thrown on parse attempts of invalid URIs. * * @see https://tools.ietf.org/html/rfc3986 * @package League\Uri * @author Ignace Nyamagana Butera * @since 0.2.0 */ class Exception extends InvalidArgumentException { /** * Returns a new Instance from an error in URI characters. * * @return static */ public static function createFromInvalidCharacters(string $uri) { return new static(sprintf('The submitted uri `%s` contains invalid characters', $uri)); } /** * Returns a new Instance from an error in URI characters. * * @return static */ public static function createFromInvalidScheme(string $uri) { return new static(sprintf('The submitted uri `%s` contains an invalid scheme', $uri)); } /** * Returns a new Instance from an error in Host validation. * * @return static */ public static function createFromInvalidHost(string $host) { return new static(sprintf('The submitted host `%s` is invalid', $host)); } /** * Returns a new Instance from an error in port validation. * * @return static */ public static function createFromInvalidHostname(string $hostname) { return new static(sprintf('The submitted hostname `%s` is invalid', $hostname)); } /** * Returns a new Instance from an error in port validation. * * @param string|int $port * * @return static */ public static function createFromInvalidPort($port) { return new static(sprintf('The submitted port `%s` is invalid', $port)); } /** * Returns a new Instance from an error in Uri path component. * * @return static */ public static function createFromInvalidPath(string $uri) { return new static(sprintf('The submitted uri `%s` contains an invalid path', $uri)); } } * @license https://github.com/thephpleague/uri-parser/blob/master/LICENSE (MIT License) * @version 1.4.1 * @link https://uri.thephpleague.com/parser/ * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri; /** * An exception thrown if the IDN support is missing or * the ICU is not at least version 4.6. * * @see https://tools.ietf.org/html/rfc3986 * @package League\Uri * @author Ignace Nyamagana Butera * @since 1.4.0 */ class MissingIdnSupport extends Exception { } * @license https://github.com/thephpleague/uri-parser/blob/master/LICENSE (MIT License) * @version 1.4.1 * @link https://uri.thephpleague.com/parser/ * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ if (!function_exists('League\Uri\parse')) { require __DIR__.'/functions.php'; } * @license https://github.com/thephpleague/uri-parser/blob/master/LICENSE (MIT License) * @version 1.4.1 * @link https://uri.thephpleague.com/parser/ * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\Uri; use UnexpectedValueException; /** * A class to parse a URI string according to RFC3986. * * @see https://tools.ietf.org/html/rfc3986 * @package League\Uri * @author Ignace Nyamagana Butera * @since 0.1.0 */ class Parser { /** @deprecated 1.4.0 will be removed in the next major point release */ const INVALID_URI_CHARS = "\x00\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0A\x0B\x0C\x0D\x0E\x0F\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1A\x1B\x1C\x1D\x1E\x1F\x7F"; /** @deprecated 1.4.0 will be removed in the next major point release */ const SCHEME_VALID_STARTING_CHARS = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'; /** @deprecated 1.4.0 will be removed in the next major point release */ const SCHEME_VALID_CHARS = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+.-'; /** @deprecated 1.4.0 will be removed in the next major point release */ const LABEL_VALID_STARTING_CHARS = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'; /** @deprecated 1.4.0 will be removed in the next major point release */ const LOCAL_LINK_PREFIX = '1111111010'; const URI_COMPONENTS = [ 'scheme' => null, 'user' => null, 'pass' => null, 'host' => null, 'port' => null, 'path' => '', 'query' => null, 'fragment' => null, ]; /** @deprecated 1.4.0 will be removed in the next major point release */ const SUB_DELIMITERS = '!$&\'()*+,;='; /** * Returns whether a scheme is valid. * * @see https://tools.ietf.org/html/rfc3986#section-3.1 */ public function isScheme(string $scheme): bool { static $pattern = '/^[a-z][a-z0-9\+\.\-]*$/i'; return '' === $scheme || 1 === preg_match($pattern, $scheme); } /** * Returns whether a hostname is valid. * * @see https://tools.ietf.org/html/rfc3986#section-3.2.2 */ public function isHost(string $host): bool { return '' === $host || $this->isIpHost($host) || $this->isRegisteredName($host); } /** * Validate a IPv6/IPvfuture host. * * @see http://tools.ietf.org/html/rfc3986#section-3.2.2 * @see http://tools.ietf.org/html/rfc6874#section-2 * @see http://tools.ietf.org/html/rfc6874#section-4 */ private function isIpHost(string $host): bool { if ('[' !== ($host[0] ?? '') || ']' !== substr($host, -1)) { return false; } $ip = substr($host, 1, -1); if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { return true; } static $ip_future = '/^ v(?[A-F0-9])+\. (?: (?[a-z0-9_~\-\.])| (?[!$&\'()*+,;=:]) # also include the : character )+ $/ix'; if (1 === preg_match($ip_future, $ip, $matches) && !in_array($matches['version'], ['4', '6'], true)) { return true; } if (false === ($pos = strpos($ip, '%'))) { return false; } static $gen_delims = '/[:\/?#\[\]@ ]/'; // Also includes space. if (1 === preg_match($gen_delims, rawurldecode(substr($ip, $pos)))) { return false; } $ip = substr($ip, 0, $pos); if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { return false; } //Only the address block fe80::/10 can have a Zone ID attach to //let's detect the link local significant 10 bits static $address_block = "\xfe\x80"; return 0 === strpos((string) inet_pton($ip), $address_block); } /** * Returns whether the host is an IPv4 or a registered named. * * @see http://tools.ietf.org/html/rfc3986#section-3.2.2 * * @throws MissingIdnSupport if the registered name contains non-ASCII characters * and IDN support or ICU requirement are not available or met. * */ protected function isRegisteredName(string $host): bool { // Note that unreserved is purposely missing . as it is used to separate labels. static $reg_name = '/(?(DEFINE) (?[a-z0-9_~\-]) (?[!$&\'()*+,;=]) (?%[A-F0-9]{2}) (?(?:(?&unreserved)|(?&sub_delims)|(?&encoded))*) ) ^(?:(?®_name)\.)*(?®_name)\.?$/ix'; if (1 === preg_match($reg_name, $host)) { return true; } //to test IDN host non-ascii characters must be present in the host static $idn_pattern = '/[^\x20-\x7f]/'; if (1 !== preg_match($idn_pattern, $host)) { return false; } static $idn_support = null; $idn_support = $idn_support ?? function_exists('idn_to_ascii') && defined('INTL_IDNA_VARIANT_UTS46'); // @codeCoverageIgnoreStart // added because it is not possible in travis to disabled the ext/intl extension // see travis issue https://github.com/travis-ci/travis-ci/issues/4701 if (!$idn_support) { throw new MissingIdnSupport(sprintf('the host `%s` could not be processed for IDN. Verify that ext/intl is installed for IDN support and that ICU is at least version 4.6.', $host)); } // @codeCoverageIgnoreEnd $ascii_host = idn_to_ascii($host, IDNA_NONTRANSITIONAL_TO_ASCII, INTL_IDNA_VARIANT_UTS46, $arr); // @codeCoverageIgnoreStart if (false === $ascii_host && 0 === $arr['errors']) { throw new UnexpectedValueException(sprintf('The Intl extension is misconfigured for %s, please correct this issue before proceeding.', PHP_OS)); } // @codeCoverageIgnoreEnd return 0 === $arr['errors']; } /** * Returns whether a port is valid. * * @see https://tools.ietf.org/html/rfc3986#section-3.2.2 */ public function isPort($port): bool { static $pattern = '/^[0-9]+$/'; if (null === $port || '' === $port) { return true; } return 1 === preg_match($pattern, (string) $port); } /** * Parse a URI string into its components. * * @see Parser::parse * * @throws Exception if the URI contains invalid characters */ public function __invoke(string $uri): array { return $this->parse($uri); } /** * Parse an URI string into its components. * * This method parses a URI and returns an associative array containing any * of the various components of the URI that are present. * * * $components = (new Parser())->parse('http://foo@test.example.com:42?query#'); * var_export($components); * //will display * array( * 'scheme' => 'http', // the URI scheme component * 'user' => 'foo', // the URI user component * 'pass' => null, // the URI pass component * 'host' => 'test.example.com', // the URI host component * 'port' => 42, // the URI port component * 'path' => '', // the URI path component * 'query' => 'query', // the URI query component * 'fragment' => '', // the URI fragment component * ); * * * The returned array is similar to PHP's parse_url return value with the following * differences: * *
    *
  • All components are always present in the returned array
    • *
  • Empty and undefined component are treated differently. And empty component is * set to the empty string while an undefined component is set to the `null` value.
    • *
  • The path component is never undefined
    • *
  • The method parses the URI following the RFC3986 rules but you are still * required to validate the returned components against its related scheme specific rules.
    • *
* * @see https://tools.ietf.org/html/rfc3986 * @see https://tools.ietf.org/html/rfc3986#section-2 * * @throws Exception if the URI contains invalid characters */ public function parse(string $uri): array { static $pattern = '/[\x00-\x1f\x7f]/'; //simple URI which do not need any parsing static $simple_uri = [ '' => [], '#' => ['fragment' => ''], '?' => ['query' => ''], '?#' => ['query' => '', 'fragment' => ''], '/' => ['path' => '/'], '//' => ['host' => ''], ]; if (isset($simple_uri[$uri])) { return array_merge(self::URI_COMPONENTS, $simple_uri[$uri]); } if (1 === preg_match($pattern, $uri)) { throw Exception::createFromInvalidCharacters($uri); } //if the first character is a known URI delimiter parsing can be simplified $first_char = $uri[0]; //The URI is made of the fragment only if ('#' === $first_char) { $components = self::URI_COMPONENTS; $components['fragment'] = (string) substr($uri, 1); return $components; } //The URI is made of the query and fragment if ('?' === $first_char) { $components = self::URI_COMPONENTS; list($components['query'], $components['fragment']) = explode('#', substr($uri, 1), 2) + [1 => null]; return $components; } //The URI does not contain any scheme part if (0 === strpos($uri, '//')) { return $this->parseSchemeSpecificPart($uri); } //The URI is made of a path, query and fragment if ('/' === $first_char || false === strpos($uri, ':')) { return $this->parsePathQueryAndFragment($uri); } //Fallback parser return $this->fallbackParser($uri); } /** * Extract components from a URI without a scheme part. * * The URI MUST start with the authority component * preceded by its delimiter the double slash ('//') * * Example: //user:pass@host:42/path?query#fragment * * The authority MUST adhere to the RFC3986 requirements. * * If the URI contains a path component, it MUST be empty or absolute * according to RFC3986 path classification. * * This method returns an associative array containing all URI components. * * @see https://tools.ietf.org/html/rfc3986#section-3.2 * @see https://tools.ietf.org/html/rfc3986#section-3.3 * * @throws Exception If any component of the URI is invalid */ protected function parseSchemeSpecificPart(string $uri): array { //We remove the authority delimiter $remaining_uri = (string) substr($uri, 2); $components = self::URI_COMPONENTS; //Parsing is done from the right upmost part to the left //1 - detect fragment, query and path part if any list($remaining_uri, $components['fragment']) = explode('#', $remaining_uri, 2) + [1 => null]; list($remaining_uri, $components['query']) = explode('?', $remaining_uri, 2) + [1 => null]; if (false !== strpos($remaining_uri, '/')) { list($remaining_uri, $components['path']) = explode('/', $remaining_uri, 2) + [1 => null]; $components['path'] = '/'.$components['path']; } //2 - The $remaining_uri represents the authority part //if the authority part is empty parsing is simplified if ('' === $remaining_uri) { $components['host'] = ''; return $components; } //otherwise we split the authority into the user information and the hostname parts $parts = explode('@', $remaining_uri, 2); $hostname = $parts[1] ?? $parts[0]; $user_info = isset($parts[1]) ? $parts[0] : null; if (null !== $user_info) { list($components['user'], $components['pass']) = explode(':', $user_info, 2) + [1 => null]; } list($components['host'], $components['port']) = $this->parseHostname($hostname); return $components; } /** * Parse and validate the URI hostname. * * @throws Exception If the hostname is invalid */ protected function parseHostname(string $hostname): array { if (false === strpos($hostname, '[')) { list($host, $port) = explode(':', $hostname, 2) + [1 => null]; return [$this->filterHost($host), $this->filterPort($port)]; } $delimiter_offset = strpos($hostname, ']') + 1; if (isset($hostname[$delimiter_offset]) && ':' !== $hostname[$delimiter_offset]) { throw Exception::createFromInvalidHostname($hostname); } return [ $this->filterHost(substr($hostname, 0, $delimiter_offset)), $this->filterPort(substr($hostname, ++$delimiter_offset)), ]; } /** * validate the host component. * * @param string|null $host * * @throws Exception If the hostname is invalid * * @return string|null */ protected function filterHost($host) { if (null === $host || $this->isHost($host)) { return $host; } throw Exception::createFromInvalidHost($host); } /** * Validate a port number. * * An exception is raised for ports outside the established TCP and UDP port ranges. * * @param mixed $port the port number * * @throws Exception If the port number is invalid. * * @return null|int */ protected function filterPort($port) { static $pattern = '/^[0-9]+$/'; if (null === $port || false === $port || '' === $port) { return null; } if (1 !== preg_match($pattern, (string) $port)) { throw Exception::createFromInvalidPort($port); } return (int) $port; } /** * Extract Components from an URI without scheme or authority part. * * The URI contains a path component and MUST adhere to path requirements * of RFC3986. The path can be * * * path = path-abempty ; begins with "/" or is empty * / path-absolute ; begins with "/" but not "//" * / path-noscheme ; begins with a non-colon segment * / path-rootless ; begins with a segment * / path-empty ; zero characters * * * ex: path?q#f * ex: /path * ex: /pa:th#f * * This method returns an associative array containing all URI components. * * @see https://tools.ietf.org/html/rfc3986#section-3.3 * * @throws Exception If the path component is invalid */ protected function parsePathQueryAndFragment(string $uri): array { //No scheme is present so we ensure that the path respects RFC3986 if (false !== ($pos = strpos($uri, ':')) && false === strpos(substr($uri, 0, $pos), '/')) { throw Exception::createFromInvalidPath($uri); } $components = self::URI_COMPONENTS; //Parsing is done from the right upmost part to the left //1 - detect the fragment part if any list($remaining_uri, $components['fragment']) = explode('#', $uri, 2) + [1 => null]; //2 - detect the query and the path part list($components['path'], $components['query']) = explode('?', $remaining_uri, 2) + [1 => null]; return $components; } /** * Extract components from an URI containing a colon. * * Depending on the colon ":" position and on the string * composition before the presence of the colon, the URI * will be considered to have an scheme or not. * *
    *
  • In case no valid scheme is found according to RFC3986 the URI will * be parsed as an URI without a scheme and an authority
    • *
  • In case an authority part is detected the URI specific part is parsed * as an URI without scheme
    • *
* * ex: email:johndoe@thephpleague.com?subject=Hellow%20World! * * This method returns an associative array containing all * the URI components. * * @see https://tools.ietf.org/html/rfc3986#section-3.1 * @see Parser::parsePathQueryAndFragment * @see Parser::parseSchemeSpecificPart * * @throws Exception If the URI scheme component is empty */ protected function fallbackParser(string $uri): array { //1 - we split the URI on the first detected colon character $parts = explode(':', $uri, 2); $remaining_uri = $parts[1] ?? $parts[0]; $scheme = isset($parts[1]) ? $parts[0] : null; //1.1 - a scheme can not be empty (ie a URI can not start with a colon) if ('' === $scheme) { throw Exception::createFromInvalidScheme($uri); } //2 - depending on the scheme presence and validity we will differ the parsing //2.1 - If the scheme part is invalid the URI may be an URI with a path-noscheme // let's differ the parsing to the Parser::parsePathQueryAndFragment method if (!$this->isScheme($scheme)) { return $this->parsePathQueryAndFragment($uri); } $components = self::URI_COMPONENTS; $components['scheme'] = $scheme; //2.2 - if no scheme specific part is detect parsing is finished if ('' == $remaining_uri) { return $components; } //2.3 - if the scheme specific part is a double forward slash if ('//' === $remaining_uri) { $components['host'] = ''; return $components; } //2.4 - if the scheme specific part starts with double forward slash // we differ the remaining parsing to the Parser::parseSchemeSpecificPart method if (0 === strpos($remaining_uri, '//')) { $components = $this->parseSchemeSpecificPart($remaining_uri); $components['scheme'] = $scheme; return $components; } //2.5 - Parsing is done from the right upmost part to the left from the scheme specific part //2.5.1 - detect the fragment part if any list($remaining_uri, $components['fragment']) = explode('#', $remaining_uri, 2) + [1 => null]; //2.5.2 - detect the part and query part if any list($components['path'], $components['query']) = explode('?', $remaining_uri, 2) + [1 => null]; return $components; } /** * Convert a registered name label to its IDNA ASCII form. * * DEPRECATION WARNING! This method will be removed in the next major point release * * @deprecated 1.4.0 this method is no longer used to validate RFC3987 compliant host component * @codeCoverageIgnore * * Conversion is done only if the label contains none valid label characters * if a '%' sub delimiter is detected the label MUST be rawurldecode prior to * making the conversion * * @return string|false */ protected function toAscii(string $label) { trigger_error( self::class.'::'.__METHOD__.' is deprecated and will be removed in the next major point release', E_USER_DEPRECATED ); if (false !== strpos($label, '%')) { $label = rawurldecode($label); } static $idn_support = null; $idn_support = $idn_support ?? function_exists('idn_to_ascii') && defined('INTL_IDNA_VARIANT_UTS46'); if (!$idn_support) { throw new MissingIdnSupport(sprintf('the label `%s` could not be processed for IDN. Verify that ext/intl is installed for IDN support and that ICU is at least version 4.6.', $label)); } $ascii_host = idn_to_ascii($label, IDNA_NONTRANSITIONAL_TO_ASCII, INTL_IDNA_VARIANT_UTS46, $arr); if (false === $ascii_host && 0 === $arr['errors']) { throw new UnexpectedValueException(sprintf('The Intl extension is misconfigured for %s, please correct this issue before proceeding.', PHP_OS)); } return $ascii_host; } /** * Returns whether the registered name label is valid. * * DEPRECATION WARNING! This method will be removed in the next major point release * * @deprecated 1.4.0 this method is no longer used to validated the host component * @codeCoverageIgnore * * A valid registered name label MUST conform to the following ABNF * * reg-name = *( unreserved / pct-encoded / sub-delims ) * * @see https://tools.ietf.org/html/rfc3986#section-3.2.2 * * @param string $label */ protected function isHostLabel($label): bool { trigger_error( self::class.'::'.__METHOD__.' is deprecated and will be removed in the next major point release', E_USER_DEPRECATED ); return '' != $label && 63 >= strlen($label) && strlen($label) == strspn($label, self::LABEL_VALID_STARTING_CHARS.'-_~'.self::SUB_DELIMITERS); } /** * Validate an IPv6 host. * * DEPRECATION WARNING! This method will be removed in the next major point release * * @deprecated 1.4.0 this method is no longer used to validated the host component * @codeCoverageIgnore * * @see http://tools.ietf.org/html/rfc6874#section-2 * @see http://tools.ietf.org/html/rfc6874#section-4 */ protected function isIpv6Host(string $ipv6): bool { trigger_error( self::class.'::'.__METHOD__.' is deprecated and will be removed in the next major point release', E_USER_DEPRECATED ); if ('[' !== ($ipv6[0] ?? '') || ']' !== substr($ipv6, -1)) { return false; } $ipv6 = substr($ipv6, 1, -1); if (false === ($pos = strpos($ipv6, '%'))) { return (bool) filter_var($ipv6, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6); } $scope = rawurldecode(substr($ipv6, $pos)); if (strlen($scope) !== strcspn($scope, '?#@[]')) { return false; } $ipv6 = substr($ipv6, 0, $pos); if (!filter_var($ipv6, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { return false; } //Only the address block fe80::/10 can have a Zone ID attach to //let's detect the link local significant 10 bits return 0 === strpos((string) inet_pton($ipv6), "\xfe\x80"); } } { "name": "monolog/monolog", "description": "Sends your logs to files, sockets, inboxes, databases and various web services", "keywords": ["log", "logging", "psr-3"], "homepage": "https://github.com/Seldaek/monolog", "type": "library", "license": "MIT", "authors": [ { "name": "Jordi Boggiano", "email": "j.boggiano@seld.be", "homepage": "https://seld.be" } ], "require": { "php": ">=7.2", "psr/log": "^1.0.1 || ^2.0 || ^3.0" }, "require-dev": { "ext-json": "*", "aws/aws-sdk-php": "^2.4.9 || ^3.0", "doctrine/couchdb": "~1.0@dev", "elasticsearch/elasticsearch": "^7 || ^8", "graylog2/gelf-php": "^1.4.2", "guzzlehttp/guzzle": "^7.4", "guzzlehttp/psr7": "^2.2", "mongodb/mongodb": "^1.8", "php-amqplib/php-amqplib": "~2.4 || ^3", "phpspec/prophecy": "^1.15", "phpstan/phpstan": "^0.12.91", "phpunit/phpunit": "^8.5.14", "predis/predis": "^1.1 || ^2.0", "rollbar/rollbar": "^1.3 || ^2 || ^3", "ruflin/elastica": "^7", "swiftmailer/swiftmailer": "^5.3|^6.0", "symfony/mailer": "^5.4 || ^6", "symfony/mime": "^5.4 || ^6" }, "suggest": { "graylog2/gelf-php": "Allow sending log messages to a GrayLog2 server", "doctrine/couchdb": "Allow sending log messages to a CouchDB server", "ruflin/elastica": "Allow sending log messages to an Elastic Search server", "elasticsearch/elasticsearch": "Allow sending log messages to an Elasticsearch server via official client", "php-amqplib/php-amqplib": "Allow sending log messages to an AMQP server using php-amqplib", "ext-amqp": "Allow sending log messages to an AMQP server (1.0+ required)", "ext-mongodb": "Allow sending log messages to a MongoDB server (via driver)", "mongodb/mongodb": "Allow sending log messages to a MongoDB server (via library)", "aws/aws-sdk-php": "Allow sending log messages to AWS services like DynamoDB", "rollbar/rollbar": "Allow sending log messages to Rollbar", "ext-mbstring": "Allow to work properly with unicode symbols", "ext-sockets": "Allow sending log messages to a Syslog server (via UDP driver)", "ext-curl": "Required to send log messages using the IFTTTHandler, the LogglyHandler, the SendGridHandler, the SlackWebhookHandler or the TelegramBotHandler", "ext-openssl": "Required to send log messages using SSL" }, "autoload": { "psr-4": {"Monolog\\": "src/Monolog"} }, "autoload-dev": { "psr-4": {"Monolog\\": "tests/Monolog"} }, "provide": { "psr/log-implementation": "1.0.0 || 2.0.0 || 3.0.0" }, "extra": { "branch-alias": { "dev-main": "2.x-dev" } }, "scripts": { "test": "@php vendor/bin/phpunit", "phpstan": "@php vendor/bin/phpstan analyse" }, "config": { "lock": false, "sort-packages": true, "platform-check": false, "allow-plugins": { "composer/package-versions-deprecated": true } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog; use DateTimeZone; use Monolog\Handler\HandlerInterface; use Psr\Log\LoggerInterface; use Psr\Log\InvalidArgumentException; use Psr\Log\LogLevel; use Throwable; use Stringable; /** * Monolog log channel * * It contains a stack of Handlers and a stack of Processors, * and uses them to store records that are added to it. * * @author Jordi Boggiano * * @phpstan-type Level Logger::DEBUG|Logger::INFO|Logger::NOTICE|Logger::WARNING|Logger::ERROR|Logger::CRITICAL|Logger::ALERT|Logger::EMERGENCY * @phpstan-type LevelName 'DEBUG'|'INFO'|'NOTICE'|'WARNING'|'ERROR'|'CRITICAL'|'ALERT'|'EMERGENCY' * @phpstan-type Record array{message: string, context: mixed[], level: Level, level_name: LevelName, channel: string, datetime: \DateTimeImmutable, extra: mixed[]} */ class Logger implements LoggerInterface, ResettableInterface { /** * Detailed debug information */ public const DEBUG = 100; /** * Interesting events * * Examples: User logs in, SQL logs. */ public const INFO = 200; /** * Uncommon events */ public const NOTICE = 250; /** * Exceptional occurrences that are not errors * * Examples: Use of deprecated APIs, poor use of an API, * undesirable things that are not necessarily wrong. */ public const WARNING = 300; /** * Runtime errors */ public const ERROR = 400; /** * Critical conditions * * Example: Application component unavailable, unexpected exception. */ public const CRITICAL = 500; /** * Action must be taken immediately * * Example: Entire website down, database unavailable, etc. * This should trigger the SMS alerts and wake you up. */ public const ALERT = 550; /** * Urgent alert. */ public const EMERGENCY = 600; /** * Monolog API version * * This is only bumped when API breaks are done and should * follow the major version of the library * * @var int */ public const API = 2; /** * This is a static variable and not a constant to serve as an extension point for custom levels * * @var array $levels Logging levels with the levels as key * * @phpstan-var array $levels Logging levels with the levels as key */ protected static $levels = [ self::DEBUG => 'DEBUG', self::INFO => 'INFO', self::NOTICE => 'NOTICE', self::WARNING => 'WARNING', self::ERROR => 'ERROR', self::CRITICAL => 'CRITICAL', self::ALERT => 'ALERT', self::EMERGENCY => 'EMERGENCY', ]; /** * Mapping between levels numbers defined in RFC 5424 and Monolog ones * * @phpstan-var array $rfc_5424_levels */ private const RFC_5424_LEVELS = [ 7 => self::DEBUG, 6 => self::INFO, 5 => self::NOTICE, 4 => self::WARNING, 3 => self::ERROR, 2 => self::CRITICAL, 1 => self::ALERT, 0 => self::EMERGENCY, ]; /** * @var string */ protected $name; /** * The handler stack * * @var HandlerInterface[] */ protected $handlers; /** * Processors that will process all log records * * To process records of a single handler instead, add the processor on that specific handler * * @var callable[] */ protected $processors; /** * @var bool */ protected $microsecondTimestamps = true; /** * @var DateTimeZone */ protected $timezone; /** * @var callable|null */ protected $exceptionHandler; /** * @var int Keeps track of depth to prevent infinite logging loops */ private $logDepth = 0; /** * @var bool Whether to detect infinite logging loops * * This can be disabled via {@see useLoggingLoopDetection} if you have async handlers that do not play well with this */ private $detectCycles = true; /** * @psalm-param array $processors * * @param string $name The logging channel, a simple descriptive name that is attached to all log records * @param HandlerInterface[] $handlers Optional stack of handlers, the first one in the array is called first, etc. * @param callable[] $processors Optional array of processors * @param DateTimeZone|null $timezone Optional timezone, if not provided date_default_timezone_get() will be used */ public function __construct(string $name, array $handlers = [], array $processors = [], ?DateTimeZone $timezone = null) { $this->name = $name; $this->setHandlers($handlers); $this->processors = $processors; $this->timezone = $timezone ?: new DateTimeZone(date_default_timezone_get() ?: 'UTC'); } public function getName(): string { return $this->name; } /** * Return a new cloned instance with the name changed */ public function withName(string $name): self { $new = clone $this; $new->name = $name; return $new; } /** * Pushes a handler on to the stack. */ public function pushHandler(HandlerInterface $handler): self { array_unshift($this->handlers, $handler); return $this; } /** * Pops a handler from the stack * * @throws \LogicException If empty handler stack */ public function popHandler(): HandlerInterface { if (!$this->handlers) { throw new \LogicException('You tried to pop from an empty handler stack.'); } return array_shift($this->handlers); } /** * Set handlers, replacing all existing ones. * * If a map is passed, keys will be ignored. * * @param HandlerInterface[] $handlers */ public function setHandlers(array $handlers): self { $this->handlers = []; foreach (array_reverse($handlers) as $handler) { $this->pushHandler($handler); } return $this; } /** * @return HandlerInterface[] */ public function getHandlers(): array { return $this->handlers; } /** * Adds a processor on to the stack. */ public function pushProcessor(callable $callback): self { array_unshift($this->processors, $callback); return $this; } /** * Removes the processor on top of the stack and returns it. * * @throws \LogicException If empty processor stack * @return callable */ public function popProcessor(): callable { if (!$this->processors) { throw new \LogicException('You tried to pop from an empty processor stack.'); } return array_shift($this->processors); } /** * @return callable[] */ public function getProcessors(): array { return $this->processors; } /** * Control the use of microsecond resolution timestamps in the 'datetime' * member of new records. * * As of PHP7.1 microseconds are always included by the engine, so * there is no performance penalty and Monolog 2 enabled microseconds * by default. This function lets you disable them though in case you want * to suppress microseconds from the output. * * @param bool $micro True to use microtime() to create timestamps */ public function useMicrosecondTimestamps(bool $micro): self { $this->microsecondTimestamps = $micro; return $this; } public function useLoggingLoopDetection(bool $detectCycles): self { $this->detectCycles = $detectCycles; return $this; } /** * Adds a log record. * * @param int $level The logging level (a Monolog or RFC 5424 level) * @param string $message The log message * @param mixed[] $context The log context * @param DateTimeImmutable $datetime Optional log date to log into the past or future * @return bool Whether the record has been processed * * @phpstan-param Level $level */ public function addRecord(int $level, string $message, array $context = [], DateTimeImmutable $datetime = null): bool { if (isset(self::RFC_5424_LEVELS[$level])) { $level = self::RFC_5424_LEVELS[$level]; } if ($this->detectCycles) { $this->logDepth += 1; } if ($this->logDepth === 3) { $this->warning('A possible infinite logging loop was detected and aborted. It appears some of your handler code is triggering logging, see the previous log record for a hint as to what may be the cause.'); return false; } elseif ($this->logDepth >= 5) { // log depth 4 is let through so we can log the warning above return false; } try { $record = null; foreach ($this->handlers as $handler) { if (null === $record) { // skip creating the record as long as no handler is going to handle it if (!$handler->isHandling(['level' => $level])) { continue; } $levelName = static::getLevelName($level); $record = [ 'message' => $message, 'context' => $context, 'level' => $level, 'level_name' => $levelName, 'channel' => $this->name, 'datetime' => $datetime ?? new DateTimeImmutable($this->microsecondTimestamps, $this->timezone), 'extra' => [], ]; try { foreach ($this->processors as $processor) { $record = $processor($record); } } catch (Throwable $e) { $this->handleException($e, $record); return true; } } // once the record exists, send it to all handlers as long as the bubbling chain is not interrupted try { if (true === $handler->handle($record)) { break; } } catch (Throwable $e) { $this->handleException($e, $record); return true; } } } finally { if ($this->detectCycles) { $this->logDepth--; } } return null !== $record; } /** * Ends a log cycle and frees all resources used by handlers. * * Closing a Handler means flushing all buffers and freeing any open resources/handles. * Handlers that have been closed should be able to accept log records again and re-open * themselves on demand, but this may not always be possible depending on implementation. * * This is useful at the end of a request and will be called automatically on every handler * when they get destructed. */ public function close(): void { foreach ($this->handlers as $handler) { $handler->close(); } } /** * Ends a log cycle and resets all handlers and processors to their initial state. * * Resetting a Handler or a Processor means flushing/cleaning all buffers, resetting internal * state, and getting it back to a state in which it can receive log records again. * * This is useful in case you want to avoid logs leaking between two requests or jobs when you * have a long running process like a worker or an application server serving multiple requests * in one process. */ public function reset(): void { foreach ($this->handlers as $handler) { if ($handler instanceof ResettableInterface) { $handler->reset(); } } foreach ($this->processors as $processor) { if ($processor instanceof ResettableInterface) { $processor->reset(); } } } /** * Gets all supported logging levels. * * @return array Assoc array with human-readable level names => level codes. * @phpstan-return array */ public static function getLevels(): array { return array_flip(static::$levels); } /** * Gets the name of the logging level. * * @throws \Psr\Log\InvalidArgumentException If level is not defined * * @phpstan-param Level $level * @phpstan-return LevelName */ public static function getLevelName(int $level): string { if (!isset(static::$levels[$level])) { throw new InvalidArgumentException('Level "'.$level.'" is not defined, use one of: '.implode(', ', array_keys(static::$levels))); } return static::$levels[$level]; } /** * Converts PSR-3 levels to Monolog ones if necessary * * @param string|int $level Level number (monolog) or name (PSR-3) * @throws \Psr\Log\InvalidArgumentException If level is not defined * * @phpstan-param Level|LevelName|LogLevel::* $level * @phpstan-return Level */ public static function toMonologLevel($level): int { if (is_string($level)) { if (is_numeric($level)) { /** @phpstan-ignore-next-line */ return intval($level); } // Contains chars of all log levels and avoids using strtoupper() which may have // strange results depending on locale (for example, "i" will become "İ" in Turkish locale) $upper = strtr($level, 'abcdefgilmnortuwy', 'ABCDEFGILMNORTUWY'); if (defined(__CLASS__.'::'.$upper)) { return constant(__CLASS__ . '::' . $upper); } throw new InvalidArgumentException('Level "'.$level.'" is not defined, use one of: '.implode(', ', array_keys(static::$levels) + static::$levels)); } if (!is_int($level)) { throw new InvalidArgumentException('Level "'.var_export($level, true).'" is not defined, use one of: '.implode(', ', array_keys(static::$levels) + static::$levels)); } return $level; } /** * Checks whether the Logger has a handler that listens on the given level * * @phpstan-param Level $level */ public function isHandling(int $level): bool { $record = [ 'level' => $level, ]; foreach ($this->handlers as $handler) { if ($handler->isHandling($record)) { return true; } } return false; } /** * Set a custom exception handler that will be called if adding a new record fails * * The callable will receive an exception object and the record that failed to be logged */ public function setExceptionHandler(?callable $callback): self { $this->exceptionHandler = $callback; return $this; } public function getExceptionHandler(): ?callable { return $this->exceptionHandler; } /** * Adds a log record at an arbitrary level. * * This method allows for compatibility with common interfaces. * * @param mixed $level The log level (a Monolog, PSR-3 or RFC 5424 level) * @param string|Stringable $message The log message * @param mixed[] $context The log context * * @phpstan-param Level|LevelName|LogLevel::* $level */ public function log($level, $message, array $context = []): void { if (!is_int($level) && !is_string($level)) { throw new \InvalidArgumentException('$level is expected to be a string or int'); } if (isset(self::RFC_5424_LEVELS[$level])) { $level = self::RFC_5424_LEVELS[$level]; } $level = static::toMonologLevel($level); $this->addRecord($level, (string) $message, $context); } /** * Adds a log record at the DEBUG level. * * This method allows for compatibility with common interfaces. * * @param string|Stringable $message The log message * @param mixed[] $context The log context */ public function debug($message, array $context = []): void { $this->addRecord(static::DEBUG, (string) $message, $context); } /** * Adds a log record at the INFO level. * * This method allows for compatibility with common interfaces. * * @param string|Stringable $message The log message * @param mixed[] $context The log context */ public function info($message, array $context = []): void { $this->addRecord(static::INFO, (string) $message, $context); } /** * Adds a log record at the NOTICE level. * * This method allows for compatibility with common interfaces. * * @param string|Stringable $message The log message * @param mixed[] $context The log context */ public function notice($message, array $context = []): void { $this->addRecord(static::NOTICE, (string) $message, $context); } /** * Adds a log record at the WARNING level. * * This method allows for compatibility with common interfaces. * * @param string|Stringable $message The log message * @param mixed[] $context The log context */ public function warning($message, array $context = []): void { $this->addRecord(static::WARNING, (string) $message, $context); } /** * Adds a log record at the ERROR level. * * This method allows for compatibility with common interfaces. * * @param string|Stringable $message The log message * @param mixed[] $context The log context */ public function error($message, array $context = []): void { $this->addRecord(static::ERROR, (string) $message, $context); } /** * Adds a log record at the CRITICAL level. * * This method allows for compatibility with common interfaces. * * @param string|Stringable $message The log message * @param mixed[] $context The log context */ public function critical($message, array $context = []): void { $this->addRecord(static::CRITICAL, (string) $message, $context); } /** * Adds a log record at the ALERT level. * * This method allows for compatibility with common interfaces. * * @param string|Stringable $message The log message * @param mixed[] $context The log context */ public function alert($message, array $context = []): void { $this->addRecord(static::ALERT, (string) $message, $context); } /** * Adds a log record at the EMERGENCY level. * * This method allows for compatibility with common interfaces. * * @param string|Stringable $message The log message * @param mixed[] $context The log context */ public function emergency($message, array $context = []): void { $this->addRecord(static::EMERGENCY, (string) $message, $context); } /** * Sets the timezone to be used for the timestamp of log records. */ public function setTimezone(DateTimeZone $tz): self { $this->timezone = $tz; return $this; } /** * Returns the timezone to be used for the timestamp of log records. */ public function getTimezone(): DateTimeZone { return $this->timezone; } /** * Delegates exception management to the custom exception handler, * or throws the exception if no custom handler is set. * * @param array $record * @phpstan-param Record $record */ protected function handleException(Throwable $e, array $record): void { if (!$this->exceptionHandler) { throw $e; } ($this->exceptionHandler)($e, $record); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog; /** * Handler or Processor implementing this interface will be reset when Logger::reset() is called. * * Resetting ends a log cycle gets them back to their initial state. * * Resetting a Handler or a Processor means flushing/cleaning all buffers, resetting internal * state, and getting it back to a state in which it can receive log records again. * * This is useful in case you want to avoid logs leaking between two requests or jobs when you * have a long running process like a worker or an application server serving multiple requests * in one process. * * @author Grégoire Pineau */ interface ResettableInterface { /** * @return void */ public function reset(); } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\FormatterInterface; use Monolog\ResettableInterface; /** * Forwards records to multiple handlers * * @author Lenar Lõhmus * * @phpstan-import-type Record from \Monolog\Logger */ class GroupHandler extends Handler implements ProcessableHandlerInterface, ResettableInterface { use ProcessableHandlerTrait; /** @var HandlerInterface[] */ protected $handlers; /** @var bool */ protected $bubble; /** * @param HandlerInterface[] $handlers Array of Handlers. * @param bool $bubble Whether the messages that are handled can bubble up the stack or not */ public function __construct(array $handlers, bool $bubble = true) { foreach ($handlers as $handler) { if (!$handler instanceof HandlerInterface) { throw new \InvalidArgumentException('The first argument of the GroupHandler must be an array of HandlerInterface instances.'); } } $this->handlers = $handlers; $this->bubble = $bubble; } /** * {@inheritDoc} */ public function isHandling(array $record): bool { foreach ($this->handlers as $handler) { if ($handler->isHandling($record)) { return true; } } return false; } /** * {@inheritDoc} */ public function handle(array $record): bool { if ($this->processors) { /** @var Record $record */ $record = $this->processRecord($record); } foreach ($this->handlers as $handler) { $handler->handle($record); } return false === $this->bubble; } /** * {@inheritDoc} */ public function handleBatch(array $records): void { if ($this->processors) { $processed = []; foreach ($records as $record) { $processed[] = $this->processRecord($record); } /** @var Record[] $records */ $records = $processed; } foreach ($this->handlers as $handler) { $handler->handleBatch($records); } } public function reset() { $this->resetProcessors(); foreach ($this->handlers as $handler) { if ($handler instanceof ResettableInterface) { $handler->reset(); } } } public function close(): void { parent::close(); foreach ($this->handlers as $handler) { $handler->close(); } } /** * {@inheritDoc} */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { foreach ($this->handlers as $handler) { if ($handler instanceof FormattableHandlerInterface) { $handler->setFormatter($formatter); } } return $this; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\FormatterInterface; /** * Sampling handler * * A sampled event stream can be useful for logging high frequency events in * a production environment where you only need an idea of what is happening * and are not concerned with capturing every occurrence. Since the decision to * handle or not handle a particular event is determined randomly, the * resulting sampled log is not guaranteed to contain 1/N of the events that * occurred in the application, but based on the Law of large numbers, it will * tend to be close to this ratio with a large number of attempts. * * @author Bryan Davis * @author Kunal Mehta * * @phpstan-import-type Record from \Monolog\Logger * @phpstan-import-type Level from \Monolog\Logger */ class SamplingHandler extends AbstractHandler implements ProcessableHandlerInterface, FormattableHandlerInterface { use ProcessableHandlerTrait; /** * @var HandlerInterface|callable * @phpstan-var HandlerInterface|callable(Record|array{level: Level}|null, HandlerInterface): HandlerInterface */ protected $handler; /** * @var int $factor */ protected $factor; /** * @psalm-param HandlerInterface|callable(Record|array{level: Level}|null, HandlerInterface): HandlerInterface $handler * * @param callable|HandlerInterface $handler Handler or factory callable($record|null, $samplingHandler). * @param int $factor Sample factor (e.g. 10 means every ~10th record is sampled) */ public function __construct($handler, int $factor) { parent::__construct(); $this->handler = $handler; $this->factor = $factor; if (!$this->handler instanceof HandlerInterface && !is_callable($this->handler)) { throw new \RuntimeException("The given handler (".json_encode($this->handler).") is not a callable nor a Monolog\Handler\HandlerInterface object"); } } public function isHandling(array $record): bool { return $this->getHandler($record)->isHandling($record); } public function handle(array $record): bool { if ($this->isHandling($record) && mt_rand(1, $this->factor) === 1) { if ($this->processors) { /** @var Record $record */ $record = $this->processRecord($record); } $this->getHandler($record)->handle($record); } return false === $this->bubble; } /** * Return the nested handler * * If the handler was provided as a factory callable, this will trigger the handler's instantiation. * * @phpstan-param Record|array{level: Level}|null $record * * @return HandlerInterface */ public function getHandler(array $record = null) { if (!$this->handler instanceof HandlerInterface) { $this->handler = ($this->handler)($record, $this); if (!$this->handler instanceof HandlerInterface) { throw new \RuntimeException("The factory callable should return a HandlerInterface"); } } return $this->handler; } /** * {@inheritDoc} */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { $handler = $this->getHandler(); if ($handler instanceof FormattableHandlerInterface) { $handler->setFormatter($formatter); return $this; } throw new \UnexpectedValueException('The nested handler of type '.get_class($handler).' does not support formatters.'); } /** * {@inheritDoc} */ public function getFormatter(): FormatterInterface { $handler = $this->getHandler(); if ($handler instanceof FormattableHandlerInterface) { return $handler->getFormatter(); } throw new \UnexpectedValueException('The nested handler of type '.get_class($handler).' does not support formatters.'); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Utils; /** * Logs to syslog service. * * usage example: * * $log = new Logger('application'); * $syslog = new SyslogHandler('myfacility', 'local6'); * $formatter = new LineFormatter("%channel%.%level_name%: %message% %extra%"); * $syslog->setFormatter($formatter); * $log->pushHandler($syslog); * * @author Sven Paulus */ class SyslogHandler extends AbstractSyslogHandler { /** @var string */ protected $ident; /** @var int */ protected $logopts; /** * @param string $ident * @param string|int $facility Either one of the names of the keys in $this->facilities, or a LOG_* facility constant * @param int $logopts Option flags for the openlog() call, defaults to LOG_PID */ public function __construct(string $ident, $facility = LOG_USER, $level = Logger::DEBUG, bool $bubble = true, int $logopts = LOG_PID) { parent::__construct($facility, $level, $bubble); $this->ident = $ident; $this->logopts = $logopts; } /** * {@inheritDoc} */ public function close(): void { closelog(); } /** * {@inheritDoc} */ protected function write(array $record): void { if (!openlog($this->ident, $this->logopts, $this->facility)) { throw new \LogicException('Can\'t open syslog for ident "'.$this->ident.'" and facility "'.$this->facility.'"' . Utils::getRecordMessageForException($record)); } syslog($this->logLevels[$record['level']], (string) $record['formatted']); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Gelf\PublisherInterface; use Monolog\Logger; use Monolog\Formatter\GelfMessageFormatter; use Monolog\Formatter\FormatterInterface; /** * Handler to send messages to a Graylog2 (http://www.graylog2.org) server * * @author Matt Lehner * @author Benjamin Zikarsky */ class GelfHandler extends AbstractProcessingHandler { /** * @var PublisherInterface the publisher object that sends the message to the server */ protected $publisher; /** * @param PublisherInterface $publisher a gelf publisher object */ public function __construct(PublisherInterface $publisher, $level = Logger::DEBUG, bool $bubble = true) { parent::__construct($level, $bubble); $this->publisher = $publisher; } /** * {@inheritDoc} */ protected function write(array $record): void { $this->publisher->publish($record['formatted']); } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new GelfMessageFormatter(); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\ResettableInterface; use Monolog\Processor\ProcessorInterface; /** * Helper trait for implementing ProcessableInterface * * @author Jordi Boggiano * * @phpstan-import-type Record from \Monolog\Logger */ trait ProcessableHandlerTrait { /** * @var callable[] * @phpstan-var array */ protected $processors = []; /** * {@inheritDoc} */ public function pushProcessor(callable $callback): HandlerInterface { array_unshift($this->processors, $callback); return $this; } /** * {@inheritDoc} */ public function popProcessor(): callable { if (!$this->processors) { throw new \LogicException('You tried to pop from an empty processor stack.'); } return array_shift($this->processors); } /** * Processes a record. * * @phpstan-param Record $record * @phpstan-return Record */ protected function processRecord(array $record): array { foreach ($this->processors as $processor) { $record = $processor($record); } return $record; } protected function resetProcessors(): void { foreach ($this->processors as $processor) { if ($processor instanceof ResettableInterface) { $processor->reset(); } } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\ResettableInterface; use Monolog\Formatter\FormatterInterface; /** * This simple wrapper class can be used to extend handlers functionality. * * Example: A custom filtering that can be applied to any handler. * * Inherit from this class and override handle() like this: * * public function handle(array $record) * { * if ($record meets certain conditions) { * return false; * } * return $this->handler->handle($record); * } * * @author Alexey Karapetov */ class HandlerWrapper implements HandlerInterface, ProcessableHandlerInterface, FormattableHandlerInterface, ResettableInterface { /** * @var HandlerInterface */ protected $handler; public function __construct(HandlerInterface $handler) { $this->handler = $handler; } /** * {@inheritDoc} */ public function isHandling(array $record): bool { return $this->handler->isHandling($record); } /** * {@inheritDoc} */ public function handle(array $record): bool { return $this->handler->handle($record); } /** * {@inheritDoc} */ public function handleBatch(array $records): void { $this->handler->handleBatch($records); } /** * {@inheritDoc} */ public function close(): void { $this->handler->close(); } /** * {@inheritDoc} */ public function pushProcessor(callable $callback): HandlerInterface { if ($this->handler instanceof ProcessableHandlerInterface) { $this->handler->pushProcessor($callback); return $this; } throw new \LogicException('The wrapped handler does not implement ' . ProcessableHandlerInterface::class); } /** * {@inheritDoc} */ public function popProcessor(): callable { if ($this->handler instanceof ProcessableHandlerInterface) { return $this->handler->popProcessor(); } throw new \LogicException('The wrapped handler does not implement ' . ProcessableHandlerInterface::class); } /** * {@inheritDoc} */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { if ($this->handler instanceof FormattableHandlerInterface) { $this->handler->setFormatter($formatter); return $this; } throw new \LogicException('The wrapped handler does not implement ' . FormattableHandlerInterface::class); } /** * {@inheritDoc} */ public function getFormatter(): FormatterInterface { if ($this->handler instanceof FormattableHandlerInterface) { return $this->handler->getFormatter(); } throw new \LogicException('The wrapped handler does not implement ' . FormattableHandlerInterface::class); } public function reset() { if ($this->handler instanceof ResettableInterface) { $this->handler->reset(); } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler\SyslogUdp; use Monolog\Utils; use Socket; class UdpSocket { protected const DATAGRAM_MAX_LENGTH = 65023; /** @var string */ protected $ip; /** @var int */ protected $port; /** @var resource|Socket|null */ protected $socket = null; public function __construct(string $ip, int $port = 514) { $this->ip = $ip; $this->port = $port; } /** * @param string $line * @param string $header * @return void */ public function write($line, $header = "") { $this->send($this->assembleMessage($line, $header)); } public function close(): void { if (is_resource($this->socket) || $this->socket instanceof Socket) { socket_close($this->socket); $this->socket = null; } } /** * @return resource|Socket */ protected function getSocket() { if (null !== $this->socket) { return $this->socket; } $domain = AF_INET; $protocol = SOL_UDP; // Check if we are using unix sockets. if ($this->port === 0) { $domain = AF_UNIX; $protocol = IPPROTO_IP; } $this->socket = socket_create($domain, SOCK_DGRAM, $protocol) ?: null; if (null === $this->socket) { throw new \RuntimeException('The UdpSocket to '.$this->ip.':'.$this->port.' could not be opened via socket_create'); } return $this->socket; } protected function send(string $chunk): void { socket_sendto($this->getSocket(), $chunk, strlen($chunk), $flags = 0, $this->ip, $this->port); } protected function assembleMessage(string $line, string $header): string { $chunkSize = static::DATAGRAM_MAX_LENGTH - strlen($header); return $header . Utils::substr($line, 0, $chunkSize); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; /** * Exception can be thrown if an extension for a handler is missing * * @author Christian Bergau */ class MissingExtensionException extends \Exception { } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Utils; use Monolog\Formatter\FlowdockFormatter; use Monolog\Formatter\FormatterInterface; /** * Sends notifications through the Flowdock push API * * This must be configured with a FlowdockFormatter instance via setFormatter() * * Notes: * API token - Flowdock API token * * @author Dominik Liebler * @see https://www.flowdock.com/api/push * * @phpstan-import-type FormattedRecord from AbstractProcessingHandler */ class FlowdockHandler extends SocketHandler { /** * @var string */ protected $apiToken; /** * @throws MissingExtensionException if OpenSSL is missing */ public function __construct( string $apiToken, $level = Logger::DEBUG, bool $bubble = true, bool $persistent = false, float $timeout = 0.0, float $writingTimeout = 10.0, ?float $connectionTimeout = null, ?int $chunkSize = null ) { if (!extension_loaded('openssl')) { throw new MissingExtensionException('The OpenSSL PHP extension is required to use the FlowdockHandler'); } parent::__construct( 'ssl://api.flowdock.com:443', $level, $bubble, $persistent, $timeout, $writingTimeout, $connectionTimeout, $chunkSize ); $this->apiToken = $apiToken; } /** * {@inheritDoc} */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { if (!$formatter instanceof FlowdockFormatter) { throw new \InvalidArgumentException('The FlowdockHandler requires an instance of Monolog\Formatter\FlowdockFormatter to function correctly'); } return parent::setFormatter($formatter); } /** * Gets the default formatter. */ protected function getDefaultFormatter(): FormatterInterface { throw new \InvalidArgumentException('The FlowdockHandler must be configured (via setFormatter) with an instance of Monolog\Formatter\FlowdockFormatter to function correctly'); } /** * {@inheritDoc} */ protected function write(array $record): void { parent::write($record); $this->closeSocket(); } /** * {@inheritDoc} */ protected function generateDataStream(array $record): string { $content = $this->buildContent($record); return $this->buildHeader($content) . $content; } /** * Builds the body of API call * * @phpstan-param FormattedRecord $record */ private function buildContent(array $record): string { return Utils::jsonEncode($record['formatted']['flowdock']); } /** * Builds the header of the API Call */ private function buildHeader(string $content): string { $header = "POST /v1/messages/team_inbox/" . $this->apiToken . " HTTP/1.1\r\n"; $header .= "Host: api.flowdock.com\r\n"; $header .= "Content-Type: application/json\r\n"; $header .= "Content-Length: " . strlen($content) . "\r\n"; $header .= "\r\n"; return $header; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\LineFormatter; use Monolog\Logger; /** * Sends logs to Fleep.io using Webhook integrations * * You'll need a Fleep.io account to use this handler. * * @see https://fleep.io/integrations/webhooks/ Fleep Webhooks Documentation * @author Ando Roots * * @phpstan-import-type FormattedRecord from AbstractProcessingHandler */ class FleepHookHandler extends SocketHandler { protected const FLEEP_HOST = 'fleep.io'; protected const FLEEP_HOOK_URI = '/hook/'; /** * @var string Webhook token (specifies the conversation where logs are sent) */ protected $token; /** * Construct a new Fleep.io Handler. * * For instructions on how to create a new web hook in your conversations * see https://fleep.io/integrations/webhooks/ * * @param string $token Webhook token * @throws MissingExtensionException */ public function __construct( string $token, $level = Logger::DEBUG, bool $bubble = true, bool $persistent = false, float $timeout = 0.0, float $writingTimeout = 10.0, ?float $connectionTimeout = null, ?int $chunkSize = null ) { if (!extension_loaded('openssl')) { throw new MissingExtensionException('The OpenSSL PHP extension is required to use the FleepHookHandler'); } $this->token = $token; $connectionString = 'ssl://' . static::FLEEP_HOST . ':443'; parent::__construct( $connectionString, $level, $bubble, $persistent, $timeout, $writingTimeout, $connectionTimeout, $chunkSize ); } /** * Returns the default formatter to use with this handler * * Overloaded to remove empty context and extra arrays from the end of the log message. * * @return LineFormatter */ protected function getDefaultFormatter(): FormatterInterface { return new LineFormatter(null, null, true, true); } /** * Handles a log record */ public function write(array $record): void { parent::write($record); $this->closeSocket(); } /** * {@inheritDoc} */ protected function generateDataStream(array $record): string { $content = $this->buildContent($record); return $this->buildHeader($content) . $content; } /** * Builds the header of the API Call */ private function buildHeader(string $content): string { $header = "POST " . static::FLEEP_HOOK_URI . $this->token . " HTTP/1.1\r\n"; $header .= "Host: " . static::FLEEP_HOST . "\r\n"; $header .= "Content-Type: application/x-www-form-urlencoded\r\n"; $header .= "Content-Length: " . strlen($content) . "\r\n"; $header .= "\r\n"; return $header; } /** * Builds the body of API call * * @phpstan-param FormattedRecord $record */ private function buildContent(array $record): string { $dataArray = [ 'message' => $record['formatted'], ]; return http_build_query($dataArray); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use MongoDB\Driver\BulkWrite; use MongoDB\Driver\Manager; use MongoDB\Client; use Monolog\Logger; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\MongoDBFormatter; /** * Logs to a MongoDB database. * * Usage example: * * $log = new \Monolog\Logger('application'); * $client = new \MongoDB\Client('mongodb://localhost:27017'); * $mongodb = new \Monolog\Handler\MongoDBHandler($client, 'logs', 'prod'); * $log->pushHandler($mongodb); * * The above examples uses the MongoDB PHP library's client class; however, the * MongoDB\Driver\Manager class from ext-mongodb is also supported. */ class MongoDBHandler extends AbstractProcessingHandler { /** @var \MongoDB\Collection */ private $collection; /** @var Client|Manager */ private $manager; /** @var string */ private $namespace; /** * Constructor. * * @param Client|Manager $mongodb MongoDB library or driver client * @param string $database Database name * @param string $collection Collection name */ public function __construct($mongodb, string $database, string $collection, $level = Logger::DEBUG, bool $bubble = true) { if (!($mongodb instanceof Client || $mongodb instanceof Manager)) { throw new \InvalidArgumentException('MongoDB\Client or MongoDB\Driver\Manager instance required'); } if ($mongodb instanceof Client) { $this->collection = $mongodb->selectCollection($database, $collection); } else { $this->manager = $mongodb; $this->namespace = $database . '.' . $collection; } parent::__construct($level, $bubble); } protected function write(array $record): void { if (isset($this->collection)) { $this->collection->insertOne($record['formatted']); } if (isset($this->manager, $this->namespace)) { $bulk = new BulkWrite; $bulk->insert($record["formatted"]); $this->manager->executeBulkWrite($this->namespace, $bulk); } } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new MongoDBFormatter; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler\Curl; use CurlHandle; /** * This class is marked as internal and it is not under the BC promise of the package. * * @internal */ final class Util { /** @var array */ private static $retriableErrorCodes = [ CURLE_COULDNT_RESOLVE_HOST, CURLE_COULDNT_CONNECT, CURLE_HTTP_NOT_FOUND, CURLE_READ_ERROR, CURLE_OPERATION_TIMEOUTED, CURLE_HTTP_POST_ERROR, CURLE_SSL_CONNECT_ERROR, ]; /** * Executes a CURL request with optional retries and exception on failure * * @param resource|CurlHandle $ch curl handler * @param int $retries * @param bool $closeAfterDone * @return bool|string @see curl_exec */ public static function execute($ch, int $retries = 5, bool $closeAfterDone = true) { while ($retries--) { $curlResponse = curl_exec($ch); if ($curlResponse === false) { $curlErrno = curl_errno($ch); if (false === in_array($curlErrno, self::$retriableErrorCodes, true) || !$retries) { $curlError = curl_error($ch); if ($closeAfterDone) { curl_close($ch); } throw new \RuntimeException(sprintf('Curl error (code %d): %s', $curlErrno, $curlError)); } continue; } if ($closeAfterDone) { curl_close($ch); } return $curlResponse; } return false; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Aws\Sdk; use Aws\DynamoDb\DynamoDbClient; use Monolog\Formatter\FormatterInterface; use Aws\DynamoDb\Marshaler; use Monolog\Formatter\ScalarFormatter; use Monolog\Logger; /** * Amazon DynamoDB handler (http://aws.amazon.com/dynamodb/) * * @link https://github.com/aws/aws-sdk-php/ * @author Andrew Lawson */ class DynamoDbHandler extends AbstractProcessingHandler { public const DATE_FORMAT = 'Y-m-d\TH:i:s.uO'; /** * @var DynamoDbClient */ protected $client; /** * @var string */ protected $table; /** * @var int */ protected $version; /** * @var Marshaler */ protected $marshaler; public function __construct(DynamoDbClient $client, string $table, $level = Logger::DEBUG, bool $bubble = true) { /** @phpstan-ignore-next-line */ if (defined('Aws\Sdk::VERSION') && version_compare(Sdk::VERSION, '3.0', '>=')) { $this->version = 3; $this->marshaler = new Marshaler; } else { $this->version = 2; } $this->client = $client; $this->table = $table; parent::__construct($level, $bubble); } /** * {@inheritDoc} */ protected function write(array $record): void { $filtered = $this->filterEmptyFields($record['formatted']); if ($this->version === 3) { $formatted = $this->marshaler->marshalItem($filtered); } else { /** @phpstan-ignore-next-line */ $formatted = $this->client->formatAttributes($filtered); } $this->client->putItem([ 'TableName' => $this->table, 'Item' => $formatted, ]); } /** * @param mixed[] $record * @return mixed[] */ protected function filterEmptyFields(array $record): array { return array_filter($record, function ($value) { return !empty($value) || false === $value || 0 === $value; }); } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new ScalarFormatter(self::DATE_FORMAT); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use DateTimeInterface; use Monolog\Logger; use Monolog\Handler\SyslogUdp\UdpSocket; use Monolog\Utils; /** * A Handler for logging to a remote syslogd server. * * @author Jesper Skovgaard Nielsen * @author Dominik Kukacka */ class SyslogUdpHandler extends AbstractSyslogHandler { const RFC3164 = 0; const RFC5424 = 1; const RFC5424e = 2; /** @var array */ private $dateFormats = array( self::RFC3164 => 'M d H:i:s', self::RFC5424 => \DateTime::RFC3339, self::RFC5424e => \DateTime::RFC3339_EXTENDED, ); /** @var UdpSocket */ protected $socket; /** @var string */ protected $ident; /** @var self::RFC* */ protected $rfc; /** * @param string $host Either IP/hostname or a path to a unix socket (port must be 0 then) * @param int $port Port number, or 0 if $host is a unix socket * @param string|int $facility Either one of the names of the keys in $this->facilities, or a LOG_* facility constant * @param bool $bubble Whether the messages that are handled can bubble up the stack or not * @param string $ident Program name or tag for each log message. * @param int $rfc RFC to format the message for. * @throws MissingExtensionException * * @phpstan-param self::RFC* $rfc */ public function __construct(string $host, int $port = 514, $facility = LOG_USER, $level = Logger::DEBUG, bool $bubble = true, string $ident = 'php', int $rfc = self::RFC5424) { if (!extension_loaded('sockets')) { throw new MissingExtensionException('The sockets extension is required to use the SyslogUdpHandler'); } parent::__construct($facility, $level, $bubble); $this->ident = $ident; $this->rfc = $rfc; $this->socket = new UdpSocket($host, $port); } protected function write(array $record): void { $lines = $this->splitMessageIntoLines($record['formatted']); $header = $this->makeCommonSyslogHeader($this->logLevels[$record['level']], $record['datetime']); foreach ($lines as $line) { $this->socket->write($line, $header); } } public function close(): void { $this->socket->close(); } /** * @param string|string[] $message * @return string[] */ private function splitMessageIntoLines($message): array { if (is_array($message)) { $message = implode("\n", $message); } $lines = preg_split('/$\R?^/m', (string) $message, -1, PREG_SPLIT_NO_EMPTY); if (false === $lines) { $pcreErrorCode = preg_last_error(); throw new \RuntimeException('Could not preg_split: ' . $pcreErrorCode . ' / ' . Utils::pcreLastErrorMessage($pcreErrorCode)); } return $lines; } /** * Make common syslog header (see rfc5424 or rfc3164) */ protected function makeCommonSyslogHeader(int $severity, DateTimeInterface $datetime): string { $priority = $severity + $this->facility; if (!$pid = getmypid()) { $pid = '-'; } if (!$hostname = gethostname()) { $hostname = '-'; } if ($this->rfc === self::RFC3164) { // see https://github.com/phpstan/phpstan/issues/5348 // @phpstan-ignore-next-line $dateNew = $datetime->setTimezone(new \DateTimeZone('UTC')); $date = $dateNew->format($this->dateFormats[$this->rfc]); return "<$priority>" . $date . " " . $hostname . " " . $this->ident . "[" . $pid . "]: "; } $date = $datetime->format($this->dateFormats[$this->rfc]); return "<$priority>1 " . $date . " " . $hostname . " " . $this->ident . " " . $pid . " - - "; } /** * Inject your own socket, mainly used for testing */ public function setSocket(UdpSocket $socket): self { $this->socket = $socket; return $this; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; /** * @author Robert Kaufmann III */ class LogEntriesHandler extends SocketHandler { /** * @var string */ protected $logToken; /** * @param string $token Log token supplied by LogEntries * @param bool $useSSL Whether or not SSL encryption should be used. * @param string $host Custom hostname to send the data to if needed * * @throws MissingExtensionException If SSL encryption is set to true and OpenSSL is missing */ public function __construct( string $token, bool $useSSL = true, $level = Logger::DEBUG, bool $bubble = true, string $host = 'data.logentries.com', bool $persistent = false, float $timeout = 0.0, float $writingTimeout = 10.0, ?float $connectionTimeout = null, ?int $chunkSize = null ) { if ($useSSL && !extension_loaded('openssl')) { throw new MissingExtensionException('The OpenSSL PHP plugin is required to use SSL encrypted connection for LogEntriesHandler'); } $endpoint = $useSSL ? 'ssl://' . $host . ':443' : $host . ':80'; parent::__construct( $endpoint, $level, $bubble, $persistent, $timeout, $writingTimeout, $connectionTimeout, $chunkSize ); $this->logToken = $token; } /** * {@inheritDoc} */ protected function generateDataStream(array $record): string { return $this->logToken . ' ' . $record['formatted']; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Aws\Sqs\SqsClient; use Monolog\Logger; use Monolog\Utils; /** * Writes to any sqs queue. * * @author Martijn van Calker */ class SqsHandler extends AbstractProcessingHandler { /** 256 KB in bytes - maximum message size in SQS */ protected const MAX_MESSAGE_SIZE = 262144; /** 100 KB in bytes - head message size for new error log */ protected const HEAD_MESSAGE_SIZE = 102400; /** @var SqsClient */ private $client; /** @var string */ private $queueUrl; public function __construct(SqsClient $sqsClient, string $queueUrl, $level = Logger::DEBUG, bool $bubble = true) { parent::__construct($level, $bubble); $this->client = $sqsClient; $this->queueUrl = $queueUrl; } /** * {@inheritDoc} */ protected function write(array $record): void { if (!isset($record['formatted']) || 'string' !== gettype($record['formatted'])) { throw new \InvalidArgumentException('SqsHandler accepts only formatted records as a string' . Utils::getRecordMessageForException($record)); } $messageBody = $record['formatted']; if (strlen($messageBody) >= static::MAX_MESSAGE_SIZE) { $messageBody = Utils::substr($messageBody, 0, static::HEAD_MESSAGE_SIZE); } $this->client->sendMessage([ 'QueueUrl' => $this->queueUrl, 'MessageBody' => $messageBody, ]); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use InvalidArgumentException; use Monolog\Logger; use Monolog\Utils; /** * Stores logs to files that are rotated every day and a limited number of files are kept. * * This rotation is only intended to be used as a workaround. Using logrotate to * handle the rotation is strongly encouraged when you can use it. * * @author Christophe Coevoet * @author Jordi Boggiano */ class RotatingFileHandler extends StreamHandler { public const FILE_PER_DAY = 'Y-m-d'; public const FILE_PER_MONTH = 'Y-m'; public const FILE_PER_YEAR = 'Y'; /** @var string */ protected $filename; /** @var int */ protected $maxFiles; /** @var bool */ protected $mustRotate; /** @var \DateTimeImmutable */ protected $nextRotation; /** @var string */ protected $filenameFormat; /** @var string */ protected $dateFormat; /** * @param string $filename * @param int $maxFiles The maximal amount of files to keep (0 means unlimited) * @param int|null $filePermission Optional file permissions (default (0644) are only for owner read/write) * @param bool $useLocking Try to lock log file before doing any writes */ public function __construct(string $filename, int $maxFiles = 0, $level = Logger::DEBUG, bool $bubble = true, ?int $filePermission = null, bool $useLocking = false) { $this->filename = Utils::canonicalizePath($filename); $this->maxFiles = $maxFiles; $this->nextRotation = new \DateTimeImmutable('tomorrow'); $this->filenameFormat = '{filename}-{date}'; $this->dateFormat = static::FILE_PER_DAY; parent::__construct($this->getTimedFilename(), $level, $bubble, $filePermission, $useLocking); } /** * {@inheritDoc} */ public function close(): void { parent::close(); if (true === $this->mustRotate) { $this->rotate(); } } /** * {@inheritDoc} */ public function reset() { parent::reset(); if (true === $this->mustRotate) { $this->rotate(); } } public function setFilenameFormat(string $filenameFormat, string $dateFormat): self { if (!preg_match('{^[Yy](([/_.-]?m)([/_.-]?d)?)?$}', $dateFormat)) { throw new InvalidArgumentException( 'Invalid date format - format must be one of '. 'RotatingFileHandler::FILE_PER_DAY ("Y-m-d"), RotatingFileHandler::FILE_PER_MONTH ("Y-m") '. 'or RotatingFileHandler::FILE_PER_YEAR ("Y"), or you can set one of the '. 'date formats using slashes, underscores and/or dots instead of dashes.' ); } if (substr_count($filenameFormat, '{date}') === 0) { throw new InvalidArgumentException( 'Invalid filename format - format must contain at least `{date}`, because otherwise rotating is impossible.' ); } $this->filenameFormat = $filenameFormat; $this->dateFormat = $dateFormat; $this->url = $this->getTimedFilename(); $this->close(); return $this; } /** * {@inheritDoc} */ protected function write(array $record): void { // on the first record written, if the log is new, we should rotate (once per day) if (null === $this->mustRotate) { $this->mustRotate = null === $this->url || !file_exists($this->url); } if ($this->nextRotation <= $record['datetime']) { $this->mustRotate = true; $this->close(); } parent::write($record); } /** * Rotates the files. */ protected function rotate(): void { // update filename $this->url = $this->getTimedFilename(); $this->nextRotation = new \DateTimeImmutable('tomorrow'); // skip GC of old logs if files are unlimited if (0 === $this->maxFiles) { return; } $logFiles = glob($this->getGlobPattern()); if (false === $logFiles) { // failed to glob return; } if ($this->maxFiles >= count($logFiles)) { // no files to remove return; } // Sorting the files by name to remove the older ones usort($logFiles, function ($a, $b) { return strcmp($b, $a); }); foreach (array_slice($logFiles, $this->maxFiles) as $file) { if (is_writable($file)) { // suppress errors here as unlink() might fail if two processes // are cleaning up/rotating at the same time set_error_handler(function (int $errno, string $errstr, string $errfile, int $errline): bool { return false; }); unlink($file); restore_error_handler(); } } $this->mustRotate = false; } protected function getTimedFilename(): string { $fileInfo = pathinfo($this->filename); $timedFilename = str_replace( ['{filename}', '{date}'], [$fileInfo['filename'], date($this->dateFormat)], $fileInfo['dirname'] . '/' . $this->filenameFormat ); if (isset($fileInfo['extension'])) { $timedFilename .= '.'.$fileInfo['extension']; } return $timedFilename; } protected function getGlobPattern(): string { $fileInfo = pathinfo($this->filename); $glob = str_replace( ['{filename}', '{date}'], [$fileInfo['filename'], str_replace( ['Y', 'y', 'm', 'd'], ['[0-9][0-9][0-9][0-9]', '[0-9][0-9]', '[0-9][0-9]', '[0-9][0-9]'], $this->dateFormat) ], $fileInfo['dirname'] . '/' . $this->filenameFormat ); if (isset($fileInfo['extension'])) { $glob .= '.'.$fileInfo['extension']; } return $glob; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\LineFormatter; use Monolog\Formatter\FormatterInterface; use Monolog\Logger; use Monolog\Utils; /** * Stores to PHP error_log() handler. * * @author Elan Ruusamäe */ class ErrorLogHandler extends AbstractProcessingHandler { public const OPERATING_SYSTEM = 0; public const SAPI = 4; /** @var int */ protected $messageType; /** @var bool */ protected $expandNewlines; /** * @param int $messageType Says where the error should go. * @param bool $expandNewlines If set to true, newlines in the message will be expanded to be take multiple log entries */ public function __construct(int $messageType = self::OPERATING_SYSTEM, $level = Logger::DEBUG, bool $bubble = true, bool $expandNewlines = false) { parent::__construct($level, $bubble); if (false === in_array($messageType, self::getAvailableTypes(), true)) { $message = sprintf('The given message type "%s" is not supported', print_r($messageType, true)); throw new \InvalidArgumentException($message); } $this->messageType = $messageType; $this->expandNewlines = $expandNewlines; } /** * @return int[] With all available types */ public static function getAvailableTypes(): array { return [ self::OPERATING_SYSTEM, self::SAPI, ]; } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new LineFormatter('[%datetime%] %channel%.%level_name%: %message% %context% %extra%'); } /** * {@inheritDoc} */ protected function write(array $record): void { if (!$this->expandNewlines) { error_log((string) $record['formatted'], $this->messageType); return; } $lines = preg_split('{[\r\n]+}', (string) $record['formatted']); if ($lines === false) { $pcreErrorCode = preg_last_error(); throw new \RuntimeException('Failed to preg_split formatted string: ' . $pcreErrorCode . ' / '. Utils::pcreLastErrorMessage($pcreErrorCode)); } foreach ($lines as $line) { error_log($line, $this->messageType); } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler\Slack; use Monolog\Logger; use Monolog\Utils; use Monolog\Formatter\NormalizerFormatter; use Monolog\Formatter\FormatterInterface; /** * Slack record utility helping to log to Slack webhooks or API. * * @author Greg Kedzierski * @author Haralan Dobrev * @see https://api.slack.com/incoming-webhooks * @see https://api.slack.com/docs/message-attachments * * @phpstan-import-type FormattedRecord from \Monolog\Handler\AbstractProcessingHandler * @phpstan-import-type Record from \Monolog\Logger */ class SlackRecord { public const COLOR_DANGER = 'danger'; public const COLOR_WARNING = 'warning'; public const COLOR_GOOD = 'good'; public const COLOR_DEFAULT = '#e3e4e6'; /** * Slack channel (encoded ID or name) * @var string|null */ private $channel; /** * Name of a bot * @var string|null */ private $username; /** * User icon e.g. 'ghost', 'http://example.com/user.png' * @var string|null */ private $userIcon; /** * Whether the message should be added to Slack as attachment (plain text otherwise) * @var bool */ private $useAttachment; /** * Whether the the context/extra messages added to Slack as attachments are in a short style * @var bool */ private $useShortAttachment; /** * Whether the attachment should include context and extra data * @var bool */ private $includeContextAndExtra; /** * Dot separated list of fields to exclude from slack message. E.g. ['context.field1', 'extra.field2'] * @var string[] */ private $excludeFields; /** * @var ?FormatterInterface */ private $formatter; /** * @var NormalizerFormatter */ private $normalizerFormatter; /** * @param string[] $excludeFields */ public function __construct( ?string $channel = null, ?string $username = null, bool $useAttachment = true, ?string $userIcon = null, bool $useShortAttachment = false, bool $includeContextAndExtra = false, array $excludeFields = array(), FormatterInterface $formatter = null ) { $this ->setChannel($channel) ->setUsername($username) ->useAttachment($useAttachment) ->setUserIcon($userIcon) ->useShortAttachment($useShortAttachment) ->includeContextAndExtra($includeContextAndExtra) ->excludeFields($excludeFields) ->setFormatter($formatter); if ($this->includeContextAndExtra) { $this->normalizerFormatter = new NormalizerFormatter(); } } /** * Returns required data in format that Slack * is expecting. * * @phpstan-param FormattedRecord $record * @phpstan-return mixed[] */ public function getSlackData(array $record): array { $dataArray = array(); $record = $this->removeExcludedFields($record); if ($this->username) { $dataArray['username'] = $this->username; } if ($this->channel) { $dataArray['channel'] = $this->channel; } if ($this->formatter && !$this->useAttachment) { /** @phpstan-ignore-next-line */ $message = $this->formatter->format($record); } else { $message = $record['message']; } if ($this->useAttachment) { $attachment = array( 'fallback' => $message, 'text' => $message, 'color' => $this->getAttachmentColor($record['level']), 'fields' => array(), 'mrkdwn_in' => array('fields'), 'ts' => $record['datetime']->getTimestamp(), 'footer' => $this->username, 'footer_icon' => $this->userIcon, ); if ($this->useShortAttachment) { $attachment['title'] = $record['level_name']; } else { $attachment['title'] = 'Message'; $attachment['fields'][] = $this->generateAttachmentField('Level', $record['level_name']); } if ($this->includeContextAndExtra) { foreach (array('extra', 'context') as $key) { if (empty($record[$key])) { continue; } if ($this->useShortAttachment) { $attachment['fields'][] = $this->generateAttachmentField( (string) $key, $record[$key] ); } else { // Add all extra fields as individual fields in attachment $attachment['fields'] = array_merge( $attachment['fields'], $this->generateAttachmentFields($record[$key]) ); } } } $dataArray['attachments'] = array($attachment); } else { $dataArray['text'] = $message; } if ($this->userIcon) { if (filter_var($this->userIcon, FILTER_VALIDATE_URL)) { $dataArray['icon_url'] = $this->userIcon; } else { $dataArray['icon_emoji'] = ":{$this->userIcon}:"; } } return $dataArray; } /** * Returns a Slack message attachment color associated with * provided level. */ public function getAttachmentColor(int $level): string { switch (true) { case $level >= Logger::ERROR: return static::COLOR_DANGER; case $level >= Logger::WARNING: return static::COLOR_WARNING; case $level >= Logger::INFO: return static::COLOR_GOOD; default: return static::COLOR_DEFAULT; } } /** * Stringifies an array of key/value pairs to be used in attachment fields * * @param mixed[] $fields */ public function stringify(array $fields): string { /** @var Record $fields */ $normalized = $this->normalizerFormatter->format($fields); $hasSecondDimension = count(array_filter($normalized, 'is_array')); $hasNonNumericKeys = !count(array_filter(array_keys($normalized), 'is_numeric')); return $hasSecondDimension || $hasNonNumericKeys ? Utils::jsonEncode($normalized, JSON_PRETTY_PRINT|Utils::DEFAULT_JSON_FLAGS) : Utils::jsonEncode($normalized, Utils::DEFAULT_JSON_FLAGS); } /** * Channel used by the bot when posting * * @param ?string $channel * * @return static */ public function setChannel(?string $channel = null): self { $this->channel = $channel; return $this; } /** * Username used by the bot when posting * * @param ?string $username * * @return static */ public function setUsername(?string $username = null): self { $this->username = $username; return $this; } public function useAttachment(bool $useAttachment = true): self { $this->useAttachment = $useAttachment; return $this; } public function setUserIcon(?string $userIcon = null): self { $this->userIcon = $userIcon; if (\is_string($userIcon)) { $this->userIcon = trim($userIcon, ':'); } return $this; } public function useShortAttachment(bool $useShortAttachment = false): self { $this->useShortAttachment = $useShortAttachment; return $this; } public function includeContextAndExtra(bool $includeContextAndExtra = false): self { $this->includeContextAndExtra = $includeContextAndExtra; if ($this->includeContextAndExtra) { $this->normalizerFormatter = new NormalizerFormatter(); } return $this; } /** * @param string[] $excludeFields */ public function excludeFields(array $excludeFields = []): self { $this->excludeFields = $excludeFields; return $this; } public function setFormatter(?FormatterInterface $formatter = null): self { $this->formatter = $formatter; return $this; } /** * Generates attachment field * * @param string|mixed[] $value * * @return array{title: string, value: string, short: false} */ private function generateAttachmentField(string $title, $value): array { $value = is_array($value) ? sprintf('```%s```', substr($this->stringify($value), 0, 1990)) : $value; return array( 'title' => ucfirst($title), 'value' => $value, 'short' => false, ); } /** * Generates a collection of attachment fields from array * * @param mixed[] $data * * @return array */ private function generateAttachmentFields(array $data): array { /** @var Record $data */ $normalized = $this->normalizerFormatter->format($data); $fields = array(); foreach ($normalized as $key => $value) { $fields[] = $this->generateAttachmentField((string) $key, $value); } return $fields; } /** * Get a copy of record with fields excluded according to $this->excludeFields * * @phpstan-param FormattedRecord $record * * @return mixed[] */ private function removeExcludedFields(array $record): array { foreach ($this->excludeFields as $field) { $keys = explode('.', $field); $node = &$record; $lastKey = end($keys); foreach ($keys as $key) { if (!isset($node[$key])) { break; } if ($lastKey === $key) { unset($node[$key]); break; } $node = &$node[$key]; } } return $record; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Psr\Log\LogLevel; /** * Blackhole * * Any record it can handle will be thrown away. This can be used * to put on top of an existing stack to override it temporarily. * * @author Jordi Boggiano * * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger */ class NullHandler extends Handler { /** * @var int */ private $level; /** * @param string|int $level The minimum logging level at which this handler will be triggered * * @phpstan-param Level|LevelName|LogLevel::* $level */ public function __construct($level = Logger::DEBUG) { $this->level = Logger::toMonologLevel($level); } /** * {@inheritDoc} */ public function isHandling(array $record): bool { return $record['level'] >= $this->level; } /** * {@inheritDoc} */ public function handle(array $record): bool { return $record['level'] >= $this->level; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\LineFormatter; /** * Common syslog functionality * * @phpstan-import-type Level from \Monolog\Logger */ abstract class AbstractSyslogHandler extends AbstractProcessingHandler { /** @var int */ protected $facility; /** * Translates Monolog log levels to syslog log priorities. * @var array * @phpstan-var array */ protected $logLevels = [ Logger::DEBUG => LOG_DEBUG, Logger::INFO => LOG_INFO, Logger::NOTICE => LOG_NOTICE, Logger::WARNING => LOG_WARNING, Logger::ERROR => LOG_ERR, Logger::CRITICAL => LOG_CRIT, Logger::ALERT => LOG_ALERT, Logger::EMERGENCY => LOG_EMERG, ]; /** * List of valid log facility names. * @var array */ protected $facilities = [ 'auth' => LOG_AUTH, 'authpriv' => LOG_AUTHPRIV, 'cron' => LOG_CRON, 'daemon' => LOG_DAEMON, 'kern' => LOG_KERN, 'lpr' => LOG_LPR, 'mail' => LOG_MAIL, 'news' => LOG_NEWS, 'syslog' => LOG_SYSLOG, 'user' => LOG_USER, 'uucp' => LOG_UUCP, ]; /** * @param string|int $facility Either one of the names of the keys in $this->facilities, or a LOG_* facility constant */ public function __construct($facility = LOG_USER, $level = Logger::DEBUG, bool $bubble = true) { parent::__construct($level, $bubble); if (!defined('PHP_WINDOWS_VERSION_BUILD')) { $this->facilities['local0'] = LOG_LOCAL0; $this->facilities['local1'] = LOG_LOCAL1; $this->facilities['local2'] = LOG_LOCAL2; $this->facilities['local3'] = LOG_LOCAL3; $this->facilities['local4'] = LOG_LOCAL4; $this->facilities['local5'] = LOG_LOCAL5; $this->facilities['local6'] = LOG_LOCAL6; $this->facilities['local7'] = LOG_LOCAL7; } else { $this->facilities['local0'] = 128; // LOG_LOCAL0 $this->facilities['local1'] = 136; // LOG_LOCAL1 $this->facilities['local2'] = 144; // LOG_LOCAL2 $this->facilities['local3'] = 152; // LOG_LOCAL3 $this->facilities['local4'] = 160; // LOG_LOCAL4 $this->facilities['local5'] = 168; // LOG_LOCAL5 $this->facilities['local6'] = 176; // LOG_LOCAL6 $this->facilities['local7'] = 184; // LOG_LOCAL7 } // convert textual description of facility to syslog constant if (is_string($facility) && array_key_exists(strtolower($facility), $this->facilities)) { $facility = $this->facilities[strtolower($facility)]; } elseif (!in_array($facility, array_values($this->facilities), true)) { throw new \UnexpectedValueException('Unknown facility value "'.$facility.'" given'); } $this->facility = $facility; } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new LineFormatter('%channel%.%level_name%: %message% %context% %extra%'); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; /** * Forwards records to multiple handlers suppressing failures of each handler * and continuing through to give every handler a chance to succeed. * * @author Craig D'Amelio * * @phpstan-import-type Record from \Monolog\Logger */ class WhatFailureGroupHandler extends GroupHandler { /** * {@inheritDoc} */ public function handle(array $record): bool { if ($this->processors) { /** @var Record $record */ $record = $this->processRecord($record); } foreach ($this->handlers as $handler) { try { $handler->handle($record); } catch (\Throwable $e) { // What failure? } } return false === $this->bubble; } /** * {@inheritDoc} */ public function handleBatch(array $records): void { if ($this->processors) { $processed = array(); foreach ($records as $record) { $processed[] = $this->processRecord($record); } /** @var Record[] $records */ $records = $processed; } foreach ($this->handlers as $handler) { try { $handler->handleBatch($records); } catch (\Throwable $e) { // What failure? } } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\ResettableInterface; use Monolog\Formatter\FormatterInterface; /** * Buffers all records until closing the handler and then pass them as batch. * * This is useful for a MailHandler to send only one mail per request instead of * sending one per log message. * * @author Christophe Coevoet * * @phpstan-import-type Record from \Monolog\Logger */ class BufferHandler extends AbstractHandler implements ProcessableHandlerInterface, FormattableHandlerInterface { use ProcessableHandlerTrait; /** @var HandlerInterface */ protected $handler; /** @var int */ protected $bufferSize = 0; /** @var int */ protected $bufferLimit; /** @var bool */ protected $flushOnOverflow; /** @var Record[] */ protected $buffer = []; /** @var bool */ protected $initialized = false; /** * @param HandlerInterface $handler Handler. * @param int $bufferLimit How many entries should be buffered at most, beyond that the oldest items are removed from the buffer. * @param bool $flushOnOverflow If true, the buffer is flushed when the max size has been reached, by default oldest entries are discarded */ public function __construct(HandlerInterface $handler, int $bufferLimit = 0, $level = Logger::DEBUG, bool $bubble = true, bool $flushOnOverflow = false) { parent::__construct($level, $bubble); $this->handler = $handler; $this->bufferLimit = $bufferLimit; $this->flushOnOverflow = $flushOnOverflow; } /** * {@inheritDoc} */ public function handle(array $record): bool { if ($record['level'] < $this->level) { return false; } if (!$this->initialized) { // __destructor() doesn't get called on Fatal errors register_shutdown_function([$this, 'close']); $this->initialized = true; } if ($this->bufferLimit > 0 && $this->bufferSize === $this->bufferLimit) { if ($this->flushOnOverflow) { $this->flush(); } else { array_shift($this->buffer); $this->bufferSize--; } } if ($this->processors) { /** @var Record $record */ $record = $this->processRecord($record); } $this->buffer[] = $record; $this->bufferSize++; return false === $this->bubble; } public function flush(): void { if ($this->bufferSize === 0) { return; } $this->handler->handleBatch($this->buffer); $this->clear(); } public function __destruct() { // suppress the parent behavior since we already have register_shutdown_function() // to call close(), and the reference contained there will prevent this from being // GC'd until the end of the request } /** * {@inheritDoc} */ public function close(): void { $this->flush(); $this->handler->close(); } /** * Clears the buffer without flushing any messages down to the wrapped handler. */ public function clear(): void { $this->bufferSize = 0; $this->buffer = []; } public function reset() { $this->flush(); parent::reset(); $this->resetProcessors(); if ($this->handler instanceof ResettableInterface) { $this->handler->reset(); } } /** * {@inheritDoc} */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { if ($this->handler instanceof FormattableHandlerInterface) { $this->handler->setFormatter($formatter); return $this; } throw new \UnexpectedValueException('The nested handler of type '.get_class($this->handler).' does not support formatters.'); } /** * {@inheritDoc} */ public function getFormatter(): FormatterInterface { if ($this->handler instanceof FormattableHandlerInterface) { return $this->handler->getFormatter(); } throw new \UnexpectedValueException('The nested handler of type '.get_class($this->handler).' does not support formatters.'); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Psr\Log\LoggerInterface; use Monolog\Formatter\FormatterInterface; /** * Proxies log messages to an existing PSR-3 compliant logger. * * If a formatter is configured, the formatter's output MUST be a string and the * formatted message will be fed to the wrapped PSR logger instead of the original * log record's message. * * @author Michael Moussa */ class PsrHandler extends AbstractHandler implements FormattableHandlerInterface { /** * PSR-3 compliant logger * * @var LoggerInterface */ protected $logger; /** * @var FormatterInterface|null */ protected $formatter; /** * @param LoggerInterface $logger The underlying PSR-3 compliant logger to which messages will be proxied */ public function __construct(LoggerInterface $logger, $level = Logger::DEBUG, bool $bubble = true) { parent::__construct($level, $bubble); $this->logger = $logger; } /** * {@inheritDoc} */ public function handle(array $record): bool { if (!$this->isHandling($record)) { return false; } if ($this->formatter) { $formatted = $this->formatter->format($record); $this->logger->log(strtolower($record['level_name']), (string) $formatted, $record['context']); } else { $this->logger->log(strtolower($record['level_name']), $record['message'], $record['context']); } return false === $this->bubble; } /** * Sets the formatter. * * @param FormatterInterface $formatter */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { $this->formatter = $formatter; return $this; } /** * Gets the formatter. * * @return FormatterInterface */ public function getFormatter(): FormatterInterface { if (!$this->formatter) { throw new \LogicException('No formatter has been set and this handler does not have a default formatter'); } return $this->formatter; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use RuntimeException; use Monolog\Logger; use Monolog\Utils; /** * Handler send logs to Telegram using Telegram Bot API. * * How to use: * 1) Create telegram bot with https://telegram.me/BotFather * 2) Create a telegram channel where logs will be recorded. * 3) Add created bot from step 1 to the created channel from step 2. * * Use telegram bot API key from step 1 and channel name with '@' prefix from step 2 to create instance of TelegramBotHandler * * @link https://core.telegram.org/bots/api * * @author Mazur Alexandr * * @phpstan-import-type Record from \Monolog\Logger */ class TelegramBotHandler extends AbstractProcessingHandler { private const BOT_API = 'https://api.telegram.org/bot'; /** * The available values of parseMode according to the Telegram api documentation */ private const AVAILABLE_PARSE_MODES = [ 'HTML', 'MarkdownV2', 'Markdown', // legacy mode without underline and strikethrough, use MarkdownV2 instead ]; /** * The maximum number of characters allowed in a message according to the Telegram api documentation */ private const MAX_MESSAGE_LENGTH = 4096; /** * Telegram bot access token provided by BotFather. * Create telegram bot with https://telegram.me/BotFather and use access token from it. * @var string */ private $apiKey; /** * Telegram channel name. * Since to start with '@' symbol as prefix. * @var string */ private $channel; /** * The kind of formatting that is used for the message. * See available options at https://core.telegram.org/bots/api#formatting-options * or in AVAILABLE_PARSE_MODES * @var ?string */ private $parseMode; /** * Disables link previews for links in the message. * @var ?bool */ private $disableWebPagePreview; /** * Sends the message silently. Users will receive a notification with no sound. * @var ?bool */ private $disableNotification; /** * True - split a message longer than MAX_MESSAGE_LENGTH into parts and send in multiple messages. * False - truncates a message that is too long. * @var bool */ private $splitLongMessages; /** * Adds 1-second delay between sending a split message (according to Telegram API to avoid 429 Too Many Requests). * @var bool */ private $delayBetweenMessages; /** * @param string $apiKey Telegram bot access token provided by BotFather * @param string $channel Telegram channel name * @param bool $splitLongMessages Split a message longer than MAX_MESSAGE_LENGTH into parts and send in multiple messages * @param bool $delayBetweenMessages Adds delay between sending a split message according to Telegram API * @throws MissingExtensionException */ public function __construct( string $apiKey, string $channel, $level = Logger::DEBUG, bool $bubble = true, string $parseMode = null, bool $disableWebPagePreview = null, bool $disableNotification = null, bool $splitLongMessages = false, bool $delayBetweenMessages = false ) { if (!extension_loaded('curl')) { throw new MissingExtensionException('The curl extension is needed to use the TelegramBotHandler'); } parent::__construct($level, $bubble); $this->apiKey = $apiKey; $this->channel = $channel; $this->setParseMode($parseMode); $this->disableWebPagePreview($disableWebPagePreview); $this->disableNotification($disableNotification); $this->splitLongMessages($splitLongMessages); $this->delayBetweenMessages($delayBetweenMessages); } public function setParseMode(string $parseMode = null): self { if ($parseMode !== null && !in_array($parseMode, self::AVAILABLE_PARSE_MODES)) { throw new \InvalidArgumentException('Unknown parseMode, use one of these: ' . implode(', ', self::AVAILABLE_PARSE_MODES) . '.'); } $this->parseMode = $parseMode; return $this; } public function disableWebPagePreview(bool $disableWebPagePreview = null): self { $this->disableWebPagePreview = $disableWebPagePreview; return $this; } public function disableNotification(bool $disableNotification = null): self { $this->disableNotification = $disableNotification; return $this; } /** * True - split a message longer than MAX_MESSAGE_LENGTH into parts and send in multiple messages. * False - truncates a message that is too long. * @param bool $splitLongMessages * @return $this */ public function splitLongMessages(bool $splitLongMessages = false): self { $this->splitLongMessages = $splitLongMessages; return $this; } /** * Adds 1-second delay between sending a split message (according to Telegram API to avoid 429 Too Many Requests). * @param bool $delayBetweenMessages * @return $this */ public function delayBetweenMessages(bool $delayBetweenMessages = false): self { $this->delayBetweenMessages = $delayBetweenMessages; return $this; } /** * {@inheritDoc} */ public function handleBatch(array $records): void { /** @var Record[] $messages */ $messages = []; foreach ($records as $record) { if (!$this->isHandling($record)) { continue; } if ($this->processors) { /** @var Record $record */ $record = $this->processRecord($record); } $messages[] = $record; } if (!empty($messages)) { $this->send((string)$this->getFormatter()->formatBatch($messages)); } } /** * @inheritDoc */ protected function write(array $record): void { $this->send($record['formatted']); } /** * Send request to @link https://api.telegram.org/bot on SendMessage action. * @param string $message */ protected function send(string $message): void { $messages = $this->handleMessageLength($message); foreach ($messages as $key => $msg) { if ($this->delayBetweenMessages && $key > 0) { sleep(1); } $this->sendCurl($msg); } } protected function sendCurl(string $message): void { $ch = curl_init(); $url = self::BOT_API . $this->apiKey . '/SendMessage'; curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([ 'text' => $message, 'chat_id' => $this->channel, 'parse_mode' => $this->parseMode, 'disable_web_page_preview' => $this->disableWebPagePreview, 'disable_notification' => $this->disableNotification, ])); $result = Curl\Util::execute($ch); if (!is_string($result)) { throw new RuntimeException('Telegram API error. Description: No response'); } $result = json_decode($result, true); if ($result['ok'] === false) { throw new RuntimeException('Telegram API error. Description: ' . $result['description']); } } /** * Handle a message that is too long: truncates or splits into several * @param string $message * @return string[] */ private function handleMessageLength(string $message): array { $truncatedMarker = ' (...truncated)'; if (!$this->splitLongMessages && strlen($message) > self::MAX_MESSAGE_LENGTH) { return [Utils::substr($message, 0, self::MAX_MESSAGE_LENGTH - strlen($truncatedMarker)) . $truncatedMarker]; } return str_split($message, self::MAX_MESSAGE_LENGTH); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\LineFormatter; use Monolog\Formatter\FormatterInterface; use Monolog\Logger; /** * Logs to a Redis key using rpush * * usage example: * * $log = new Logger('application'); * $redis = new RedisHandler(new Predis\Client("tcp://localhost:6379"), "logs", "prod"); * $log->pushHandler($redis); * * @author Thomas Tourlourat * * @phpstan-import-type FormattedRecord from AbstractProcessingHandler */ class RedisHandler extends AbstractProcessingHandler { /** @var \Predis\Client<\Predis\Client>|\Redis */ private $redisClient; /** @var string */ private $redisKey; /** @var int */ protected $capSize; /** * @param \Predis\Client<\Predis\Client>|\Redis $redis The redis instance * @param string $key The key name to push records to * @param int $capSize Number of entries to limit list size to, 0 = unlimited */ public function __construct($redis, string $key, $level = Logger::DEBUG, bool $bubble = true, int $capSize = 0) { if (!(($redis instanceof \Predis\Client) || ($redis instanceof \Redis))) { throw new \InvalidArgumentException('Predis\Client or Redis instance required'); } $this->redisClient = $redis; $this->redisKey = $key; $this->capSize = $capSize; parent::__construct($level, $bubble); } /** * {@inheritDoc} */ protected function write(array $record): void { if ($this->capSize) { $this->writeCapped($record); } else { $this->redisClient->rpush($this->redisKey, $record["formatted"]); } } /** * Write and cap the collection * Writes the record to the redis list and caps its * * @phpstan-param FormattedRecord $record */ protected function writeCapped(array $record): void { if ($this->redisClient instanceof \Redis) { $mode = defined('\Redis::MULTI') ? \Redis::MULTI : 1; $this->redisClient->multi($mode) ->rpush($this->redisKey, $record["formatted"]) ->ltrim($this->redisKey, -$this->capSize, -1) ->exec(); } else { $redisKey = $this->redisKey; $capSize = $this->capSize; $this->redisClient->transaction(function ($tx) use ($record, $redisKey, $capSize) { $tx->rpush($redisKey, $record["formatted"]); $tx->ltrim($redisKey, -$capSize, -1); }); } } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new LineFormatter(); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; /** * Base Handler class providing basic close() support as well as handleBatch * * @author Jordi Boggiano */ abstract class Handler implements HandlerInterface { /** * {@inheritDoc} */ public function handleBatch(array $records): void { foreach ($records as $record) { $this->handle($record); } } /** * {@inheritDoc} */ public function close(): void { } public function __destruct() { try { $this->close(); } catch (\Throwable $e) { // do nothing } } public function __sleep() { $this->close(); $reflClass = new \ReflectionClass($this); $keys = []; foreach ($reflClass->getProperties() as $reflProp) { if (!$reflProp->isStatic()) { $keys[] = $reflProp->getName(); } } return $keys; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Formatter\NormalizerFormatter; use Monolog\Formatter\FormatterInterface; use Doctrine\CouchDB\CouchDBClient; /** * CouchDB handler for Doctrine CouchDB ODM * * @author Markus Bachmann */ class DoctrineCouchDBHandler extends AbstractProcessingHandler { /** @var CouchDBClient */ private $client; public function __construct(CouchDBClient $client, $level = Logger::DEBUG, bool $bubble = true) { $this->client = $client; parent::__construct($level, $bubble); } /** * {@inheritDoc} */ protected function write(array $record): void { $this->client->postDocument($record['formatted']); } protected function getDefaultFormatter(): FormatterInterface { return new NormalizerFormatter; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; trait WebRequestRecognizerTrait { /** * Checks if PHP's serving a web request * @return bool */ protected function isWebRequest(): bool { return 'cli' !== \PHP_SAPI && 'phpdbg' !== \PHP_SAPI; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\FormatterInterface; /** * Interface to describe loggers that have a formatter * * @author Jordi Boggiano */ interface FormattableHandlerInterface { /** * Sets the formatter. * * @param FormatterInterface $formatter * @return HandlerInterface self */ public function setFormatter(FormatterInterface $formatter): HandlerInterface; /** * Gets the formatter. * * @return FormatterInterface */ public function getFormatter(): FormatterInterface; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Utils; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\LineFormatter; use Symfony\Component\Mailer\MailerInterface; use Symfony\Component\Mailer\Transport\TransportInterface; use Symfony\Component\Mime\Email; /** * SymfonyMailerHandler uses Symfony's Mailer component to send the emails * * @author Jordi Boggiano * * @phpstan-import-type Record from \Monolog\Logger */ class SymfonyMailerHandler extends MailHandler { /** @var MailerInterface|TransportInterface */ protected $mailer; /** @var Email|callable(string, Record[]): Email */ private $emailTemplate; /** * @psalm-param Email|callable(string, Record[]): Email $email * * @param MailerInterface|TransportInterface $mailer The mailer to use * @param callable|Email $email An email template, the subject/body will be replaced */ public function __construct($mailer, $email, $level = Logger::ERROR, bool $bubble = true) { parent::__construct($level, $bubble); $this->mailer = $mailer; $this->emailTemplate = $email; } /** * {@inheritDoc} */ protected function send(string $content, array $records): void { $this->mailer->send($this->buildMessage($content, $records)); } /** * Gets the formatter for the Swift_Message subject. * * @param string|null $format The format of the subject */ protected function getSubjectFormatter(?string $format): FormatterInterface { return new LineFormatter($format); } /** * Creates instance of Email to be sent * * @param string $content formatted email body to be sent * @param array $records Log records that formed the content * * @phpstan-param Record[] $records */ protected function buildMessage(string $content, array $records): Email { $message = null; if ($this->emailTemplate instanceof Email) { $message = clone $this->emailTemplate; } elseif (is_callable($this->emailTemplate)) { $message = ($this->emailTemplate)($content, $records); } if (!$message instanceof Email) { $record = reset($records); throw new \InvalidArgumentException('Could not resolve message as instance of Email or a callable returning it' . ($record ? Utils::getRecordMessageForException($record) : '')); } if ($records) { $subjectFormatter = $this->getSubjectFormatter($message->getSubject()); $message->subject($subjectFormatter->format($this->getHighestRecord($records))); } if ($this->isHtmlBody($content)) { if (null !== ($charset = $message->getHtmlCharset())) { $message->html($content, $charset); } else { $message->html($content); } } else { if (null !== ($charset = $message->getTextCharset())) { $message->text($content, $charset); } else { $message->text($content); } } return $message->date(new \DateTimeImmutable()); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\FormatterInterface; use Monolog\Logger; use Monolog\Utils; use Monolog\Handler\Slack\SlackRecord; /** * Sends notifications through Slack Webhooks * * @author Haralan Dobrev * @see https://api.slack.com/incoming-webhooks */ class SlackWebhookHandler extends AbstractProcessingHandler { /** * Slack Webhook token * @var string */ private $webhookUrl; /** * Instance of the SlackRecord util class preparing data for Slack API. * @var SlackRecord */ private $slackRecord; /** * @param string $webhookUrl Slack Webhook URL * @param string|null $channel Slack channel (encoded ID or name) * @param string|null $username Name of a bot * @param bool $useAttachment Whether the message should be added to Slack as attachment (plain text otherwise) * @param string|null $iconEmoji The emoji name to use (or null) * @param bool $useShortAttachment Whether the the context/extra messages added to Slack as attachments are in a short style * @param bool $includeContextAndExtra Whether the attachment should include context and extra data * @param string[] $excludeFields Dot separated list of fields to exclude from slack message. E.g. ['context.field1', 'extra.field2'] */ public function __construct( string $webhookUrl, ?string $channel = null, ?string $username = null, bool $useAttachment = true, ?string $iconEmoji = null, bool $useShortAttachment = false, bool $includeContextAndExtra = false, $level = Logger::CRITICAL, bool $bubble = true, array $excludeFields = array() ) { if (!extension_loaded('curl')) { throw new MissingExtensionException('The curl extension is needed to use the SlackWebhookHandler'); } parent::__construct($level, $bubble); $this->webhookUrl = $webhookUrl; $this->slackRecord = new SlackRecord( $channel, $username, $useAttachment, $iconEmoji, $useShortAttachment, $includeContextAndExtra, $excludeFields ); } public function getSlackRecord(): SlackRecord { return $this->slackRecord; } public function getWebhookUrl(): string { return $this->webhookUrl; } /** * {@inheritDoc} */ protected function write(array $record): void { $postData = $this->slackRecord->getSlackData($record); $postString = Utils::jsonEncode($postData); $ch = curl_init(); $options = array( CURLOPT_URL => $this->webhookUrl, CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => array('Content-type: application/json'), CURLOPT_POSTFIELDS => $postString, ); if (defined('CURLOPT_SAFE_UPLOAD')) { $options[CURLOPT_SAFE_UPLOAD] = true; } curl_setopt_array($ch, $options); Curl\Util::execute($ch); } public function setFormatter(FormatterInterface $formatter): HandlerInterface { parent::setFormatter($formatter); $this->slackRecord->setFormatter($formatter); return $this; } public function getFormatter(): FormatterInterface { $formatter = parent::getFormatter(); $this->slackRecord->setFormatter($formatter); return $formatter; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Formatter\FormatterInterface; /** * Handler to only pass log messages when a certain threshold of number of messages is reached. * * This can be useful in cases of processing a batch of data, but you're for example only interested * in case it fails catastrophically instead of a warning for 1 or 2 events. Worse things can happen, right? * * Usage example: * * ``` * $log = new Logger('application'); * $handler = new SomeHandler(...) * * // Pass all warnings to the handler when more than 10 & all error messages when more then 5 * $overflow = new OverflowHandler($handler, [Logger::WARNING => 10, Logger::ERROR => 5]); * * $log->pushHandler($overflow); *``` * * @author Kris Buist */ class OverflowHandler extends AbstractHandler implements FormattableHandlerInterface { /** @var HandlerInterface */ private $handler; /** @var int[] */ private $thresholdMap = [ Logger::DEBUG => 0, Logger::INFO => 0, Logger::NOTICE => 0, Logger::WARNING => 0, Logger::ERROR => 0, Logger::CRITICAL => 0, Logger::ALERT => 0, Logger::EMERGENCY => 0, ]; /** * Buffer of all messages passed to the handler before the threshold was reached * * @var mixed[][] */ private $buffer = []; /** * @param HandlerInterface $handler * @param int[] $thresholdMap Dictionary of logger level => threshold */ public function __construct( HandlerInterface $handler, array $thresholdMap = [], $level = Logger::DEBUG, bool $bubble = true ) { $this->handler = $handler; foreach ($thresholdMap as $thresholdLevel => $threshold) { $this->thresholdMap[$thresholdLevel] = $threshold; } parent::__construct($level, $bubble); } /** * Handles a record. * * All records may be passed to this method, and the handler should discard * those that it does not want to handle. * * The return value of this function controls the bubbling process of the handler stack. * Unless the bubbling is interrupted (by returning true), the Logger class will keep on * calling further handlers in the stack with a given log record. * * {@inheritDoc} */ public function handle(array $record): bool { if ($record['level'] < $this->level) { return false; } $level = $record['level']; if (!isset($this->thresholdMap[$level])) { $this->thresholdMap[$level] = 0; } if ($this->thresholdMap[$level] > 0) { // The overflow threshold is not yet reached, so we're buffering the record and lowering the threshold by 1 $this->thresholdMap[$level]--; $this->buffer[$level][] = $record; return false === $this->bubble; } if ($this->thresholdMap[$level] == 0) { // This current message is breaking the threshold. Flush the buffer and continue handling the current record foreach ($this->buffer[$level] ?? [] as $buffered) { $this->handler->handle($buffered); } $this->thresholdMap[$level]--; unset($this->buffer[$level]); } $this->handler->handle($record); return false === $this->bubble; } /** * {@inheritDoc} */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { if ($this->handler instanceof FormattableHandlerInterface) { $this->handler->setFormatter($formatter); return $this; } throw new \UnexpectedValueException('The nested handler of type '.get_class($this->handler).' does not support formatters.'); } /** * {@inheritDoc} */ public function getFormatter(): FormatterInterface { if ($this->handler instanceof FormattableHandlerInterface) { return $this->handler->getFormatter(); } throw new \UnexpectedValueException('The nested handler of type '.get_class($this->handler).' does not support formatters.'); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Utils; /** * Stores to any stream resource * * Can be used to store into php://stderr, remote and local files, etc. * * @author Jordi Boggiano * * @phpstan-import-type FormattedRecord from AbstractProcessingHandler */ class StreamHandler extends AbstractProcessingHandler { /** @const int */ protected const MAX_CHUNK_SIZE = 2147483647; /** @const int 10MB */ protected const DEFAULT_CHUNK_SIZE = 10 * 1024 * 1024; /** @var int */ protected $streamChunkSize; /** @var resource|null */ protected $stream; /** @var ?string */ protected $url = null; /** @var ?string */ private $errorMessage = null; /** @var ?int */ protected $filePermission; /** @var bool */ protected $useLocking; /** @var true|null */ private $dirCreated = null; /** * @param resource|string $stream If a missing path can't be created, an UnexpectedValueException will be thrown on first write * @param int|null $filePermission Optional file permissions (default (0644) are only for owner read/write) * @param bool $useLocking Try to lock log file before doing any writes * * @throws \InvalidArgumentException If stream is not a resource or string */ public function __construct($stream, $level = Logger::DEBUG, bool $bubble = true, ?int $filePermission = null, bool $useLocking = false) { parent::__construct($level, $bubble); if (($phpMemoryLimit = Utils::expandIniShorthandBytes(ini_get('memory_limit'))) !== false) { if ($phpMemoryLimit > 0) { // use max 10% of allowed memory for the chunk size, and at least 100KB $this->streamChunkSize = min(static::MAX_CHUNK_SIZE, max((int) ($phpMemoryLimit / 10), 100 * 1024)); } else { // memory is unlimited, set to the default 10MB $this->streamChunkSize = static::DEFAULT_CHUNK_SIZE; } } else { // no memory limit information, set to the default 10MB $this->streamChunkSize = static::DEFAULT_CHUNK_SIZE; } if (is_resource($stream)) { $this->stream = $stream; stream_set_chunk_size($this->stream, $this->streamChunkSize); } elseif (is_string($stream)) { $this->url = Utils::canonicalizePath($stream); } else { throw new \InvalidArgumentException('A stream must either be a resource or a string.'); } $this->filePermission = $filePermission; $this->useLocking = $useLocking; } /** * {@inheritDoc} */ public function close(): void { if ($this->url && is_resource($this->stream)) { fclose($this->stream); } $this->stream = null; $this->dirCreated = null; } /** * Return the currently active stream if it is open * * @return resource|null */ public function getStream() { return $this->stream; } /** * Return the stream URL if it was configured with a URL and not an active resource * * @return string|null */ public function getUrl(): ?string { return $this->url; } /** * @return int */ public function getStreamChunkSize(): int { return $this->streamChunkSize; } /** * {@inheritDoc} */ protected function write(array $record): void { if (!is_resource($this->stream)) { $url = $this->url; if (null === $url || '' === $url) { throw new \LogicException('Missing stream url, the stream can not be opened. This may be caused by a premature call to close().' . Utils::getRecordMessageForException($record)); } $this->createDir($url); $this->errorMessage = null; set_error_handler([$this, 'customErrorHandler']); $stream = fopen($url, 'a'); if ($this->filePermission !== null) { @chmod($url, $this->filePermission); } restore_error_handler(); if (!is_resource($stream)) { $this->stream = null; throw new \UnexpectedValueException(sprintf('The stream or file "%s" could not be opened in append mode: '.$this->errorMessage, $url) . Utils::getRecordMessageForException($record)); } stream_set_chunk_size($stream, $this->streamChunkSize); $this->stream = $stream; } $stream = $this->stream; if (!is_resource($stream)) { throw new \LogicException('No stream was opened yet' . Utils::getRecordMessageForException($record)); } if ($this->useLocking) { // ignoring errors here, there's not much we can do about them flock($stream, LOCK_EX); } $this->streamWrite($stream, $record); if ($this->useLocking) { flock($stream, LOCK_UN); } } /** * Write to stream * @param resource $stream * @param array $record * * @phpstan-param FormattedRecord $record */ protected function streamWrite($stream, array $record): void { fwrite($stream, (string) $record['formatted']); } private function customErrorHandler(int $code, string $msg): bool { $this->errorMessage = preg_replace('{^(fopen|mkdir)\(.*?\): }', '', $msg); return true; } private function getDirFromStream(string $stream): ?string { $pos = strpos($stream, '://'); if ($pos === false) { return dirname($stream); } if ('file://' === substr($stream, 0, 7)) { return dirname(substr($stream, 7)); } return null; } private function createDir(string $url): void { // Do not try to create dir if it has already been tried. if ($this->dirCreated) { return; } $dir = $this->getDirFromStream($url); if (null !== $dir && !is_dir($dir)) { $this->errorMessage = null; set_error_handler([$this, 'customErrorHandler']); $status = mkdir($dir, 0777, true); restore_error_handler(); if (false === $status && !is_dir($dir) && strpos((string) $this->errorMessage, 'File exists') === false) { throw new \UnexpectedValueException(sprintf('There is no existing directory at "%s" and it could not be created: '.$this->errorMessage, $dir)); } } $this->dirCreated = true; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\LineFormatter; use Monolog\Utils; use function count; use function headers_list; use function stripos; use function trigger_error; use const E_USER_DEPRECATED; /** * Handler sending logs to browser's javascript console with no browser extension required * * @author Olivier Poitrey * * @phpstan-import-type FormattedRecord from AbstractProcessingHandler */ class BrowserConsoleHandler extends AbstractProcessingHandler { /** @var bool */ protected static $initialized = false; /** @var FormattedRecord[] */ protected static $records = []; protected const FORMAT_HTML = 'html'; protected const FORMAT_JS = 'js'; protected const FORMAT_UNKNOWN = 'unknown'; /** * {@inheritDoc} * * Formatted output may contain some formatting markers to be transferred to `console.log` using the %c format. * * Example of formatted string: * * You can do [[blue text]]{color: blue} or [[green background]]{background-color: green; color: white} */ protected function getDefaultFormatter(): FormatterInterface { return new LineFormatter('[[%channel%]]{macro: autolabel} [[%level_name%]]{font-weight: bold} %message%'); } /** * {@inheritDoc} */ protected function write(array $record): void { // Accumulate records static::$records[] = $record; // Register shutdown handler if not already done if (!static::$initialized) { static::$initialized = true; $this->registerShutdownFunction(); } } /** * Convert records to javascript console commands and send it to the browser. * This method is automatically called on PHP shutdown if output is HTML or Javascript. */ public static function send(): void { $format = static::getResponseFormat(); if ($format === self::FORMAT_UNKNOWN) { return; } if (count(static::$records)) { if ($format === self::FORMAT_HTML) { static::writeOutput(''); } elseif ($format === self::FORMAT_JS) { static::writeOutput(static::generateScript()); } static::resetStatic(); } } public function close(): void { self::resetStatic(); } public function reset() { parent::reset(); self::resetStatic(); } /** * Forget all logged records */ public static function resetStatic(): void { static::$records = []; } /** * Wrapper for register_shutdown_function to allow overriding */ protected function registerShutdownFunction(): void { if (PHP_SAPI !== 'cli') { register_shutdown_function(['Monolog\Handler\BrowserConsoleHandler', 'send']); } } /** * Wrapper for echo to allow overriding */ protected static function writeOutput(string $str): void { echo $str; } /** * Checks the format of the response * * If Content-Type is set to application/javascript or text/javascript -> js * If Content-Type is set to text/html, or is unset -> html * If Content-Type is anything else -> unknown * * @return string One of 'js', 'html' or 'unknown' * @phpstan-return self::FORMAT_* */ protected static function getResponseFormat(): string { // Check content type foreach (headers_list() as $header) { if (stripos($header, 'content-type:') === 0) { return static::getResponseFormatFromContentType($header); } } return self::FORMAT_HTML; } /** * @return string One of 'js', 'html' or 'unknown' * @phpstan-return self::FORMAT_* */ protected static function getResponseFormatFromContentType(string $contentType): string { // This handler only works with HTML and javascript outputs // text/javascript is obsolete in favour of application/javascript, but still used if (stripos($contentType, 'application/javascript') !== false || stripos($contentType, 'text/javascript') !== false) { return self::FORMAT_JS; } if (stripos($contentType, 'text/html') !== false) { return self::FORMAT_HTML; } return self::FORMAT_UNKNOWN; } private static function generateScript(): string { $script = []; foreach (static::$records as $record) { $context = static::dump('Context', $record['context']); $extra = static::dump('Extra', $record['extra']); if (empty($context) && empty($extra)) { $script[] = static::call_array('log', static::handleStyles($record['formatted'])); } else { $script = array_merge( $script, [static::call_array('groupCollapsed', static::handleStyles($record['formatted']))], $context, $extra, [static::call('groupEnd')] ); } } return "(function (c) {if (c && c.groupCollapsed) {\n" . implode("\n", $script) . "\n}})(console);"; } /** * @return string[] */ private static function handleStyles(string $formatted): array { $args = []; $format = '%c' . $formatted; preg_match_all('/\[\[(.*?)\]\]\{([^}]*)\}/s', $format, $matches, PREG_OFFSET_CAPTURE | PREG_SET_ORDER); foreach (array_reverse($matches) as $match) { $args[] = '"font-weight: normal"'; $args[] = static::quote(static::handleCustomStyles($match[2][0], $match[1][0])); $pos = $match[0][1]; $format = Utils::substr($format, 0, $pos) . '%c' . $match[1][0] . '%c' . Utils::substr($format, $pos + strlen($match[0][0])); } $args[] = static::quote('font-weight: normal'); $args[] = static::quote($format); return array_reverse($args); } private static function handleCustomStyles(string $style, string $string): string { static $colors = ['blue', 'green', 'red', 'magenta', 'orange', 'black', 'grey']; static $labels = []; $style = preg_replace_callback('/macro\s*:(.*?)(?:;|$)/', function (array $m) use ($string, &$colors, &$labels) { if (trim($m[1]) === 'autolabel') { // Format the string as a label with consistent auto assigned background color if (!isset($labels[$string])) { $labels[$string] = $colors[count($labels) % count($colors)]; } $color = $labels[$string]; return "background-color: $color; color: white; border-radius: 3px; padding: 0 2px 0 2px"; } return $m[1]; }, $style); if (null === $style) { $pcreErrorCode = preg_last_error(); throw new \RuntimeException('Failed to run preg_replace_callback: ' . $pcreErrorCode . ' / ' . Utils::pcreLastErrorMessage($pcreErrorCode)); } return $style; } /** * @param mixed[] $dict * @return mixed[] */ private static function dump(string $title, array $dict): array { $script = []; $dict = array_filter($dict); if (empty($dict)) { return $script; } $script[] = static::call('log', static::quote('%c%s'), static::quote('font-weight: bold'), static::quote($title)); foreach ($dict as $key => $value) { $value = json_encode($value); if (empty($value)) { $value = static::quote(''); } $script[] = static::call('log', static::quote('%s: %o'), static::quote((string) $key), $value); } return $script; } private static function quote(string $arg): string { return '"' . addcslashes($arg, "\"\n\\") . '"'; } /** * @param mixed $args */ private static function call(...$args): string { $method = array_shift($args); if (!is_string($method)) { throw new \UnexpectedValueException('Expected the first arg to be a string, got: '.var_export($method, true)); } return static::call_array($method, $args); } /** * @param mixed[] $args */ private static function call_array(string $method, array $args): string { return 'c.' . $method . '(' . implode(', ', $args) . ');'; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; /** * Inspired on LogEntriesHandler. * * @author Robert Kaufmann III * @author Gabriel Machado */ class InsightOpsHandler extends SocketHandler { /** * @var string */ protected $logToken; /** * @param string $token Log token supplied by InsightOps * @param string $region Region where InsightOps account is hosted. Could be 'us' or 'eu'. * @param bool $useSSL Whether or not SSL encryption should be used * * @throws MissingExtensionException If SSL encryption is set to true and OpenSSL is missing */ public function __construct( string $token, string $region = 'us', bool $useSSL = true, $level = Logger::DEBUG, bool $bubble = true, bool $persistent = false, float $timeout = 0.0, float $writingTimeout = 10.0, ?float $connectionTimeout = null, ?int $chunkSize = null ) { if ($useSSL && !extension_loaded('openssl')) { throw new MissingExtensionException('The OpenSSL PHP plugin is required to use SSL encrypted connection for InsightOpsHandler'); } $endpoint = $useSSL ? 'ssl://' . $region . '.data.logs.insight.rapid7.com:443' : $region . '.data.logs.insight.rapid7.com:80'; parent::__construct( $endpoint, $level, $bubble, $persistent, $timeout, $writingTimeout, $connectionTimeout, $chunkSize ); $this->logToken = $token; } /** * {@inheritDoc} */ protected function generateDataStream(array $record): string { return $this->logToken . ' ' . $record['formatted']; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Handler\FingersCrossed\ErrorLevelActivationStrategy; use Monolog\Handler\FingersCrossed\ActivationStrategyInterface; use Monolog\Logger; use Monolog\ResettableInterface; use Monolog\Formatter\FormatterInterface; use Psr\Log\LogLevel; /** * Buffers all records until a certain level is reached * * The advantage of this approach is that you don't get any clutter in your log files. * Only requests which actually trigger an error (or whatever your actionLevel is) will be * in the logs, but they will contain all records, not only those above the level threshold. * * You can then have a passthruLevel as well which means that at the end of the request, * even if it did not get activated, it will still send through log records of e.g. at least a * warning level. * * You can find the various activation strategies in the * Monolog\Handler\FingersCrossed\ namespace. * * @author Jordi Boggiano * * @phpstan-import-type Record from \Monolog\Logger * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger */ class FingersCrossedHandler extends Handler implements ProcessableHandlerInterface, ResettableInterface, FormattableHandlerInterface { use ProcessableHandlerTrait; /** * @var callable|HandlerInterface * @phpstan-var callable(?Record, HandlerInterface): HandlerInterface|HandlerInterface */ protected $handler; /** @var ActivationStrategyInterface */ protected $activationStrategy; /** @var bool */ protected $buffering = true; /** @var int */ protected $bufferSize; /** @var Record[] */ protected $buffer = []; /** @var bool */ protected $stopBuffering; /** * @var ?int * @phpstan-var ?Level */ protected $passthruLevel; /** @var bool */ protected $bubble; /** * @psalm-param HandlerInterface|callable(?Record, HandlerInterface): HandlerInterface $handler * * @param callable|HandlerInterface $handler Handler or factory callable($record|null, $fingersCrossedHandler). * @param int|string|ActivationStrategyInterface $activationStrategy Strategy which determines when this handler takes action, or a level name/value at which the handler is activated * @param int $bufferSize How many entries should be buffered at most, beyond that the oldest items are removed from the buffer. * @param bool $bubble Whether the messages that are handled can bubble up the stack or not * @param bool $stopBuffering Whether the handler should stop buffering after being triggered (default true) * @param int|string $passthruLevel Minimum level to always flush to handler on close, even if strategy not triggered * * @phpstan-param Level|LevelName|LogLevel::* $passthruLevel * @phpstan-param Level|LevelName|LogLevel::*|ActivationStrategyInterface $activationStrategy */ public function __construct($handler, $activationStrategy = null, int $bufferSize = 0, bool $bubble = true, bool $stopBuffering = true, $passthruLevel = null) { if (null === $activationStrategy) { $activationStrategy = new ErrorLevelActivationStrategy(Logger::WARNING); } // convert simple int activationStrategy to an object if (!$activationStrategy instanceof ActivationStrategyInterface) { $activationStrategy = new ErrorLevelActivationStrategy($activationStrategy); } $this->handler = $handler; $this->activationStrategy = $activationStrategy; $this->bufferSize = $bufferSize; $this->bubble = $bubble; $this->stopBuffering = $stopBuffering; if ($passthruLevel !== null) { $this->passthruLevel = Logger::toMonologLevel($passthruLevel); } if (!$this->handler instanceof HandlerInterface && !is_callable($this->handler)) { throw new \RuntimeException("The given handler (".json_encode($this->handler).") is not a callable nor a Monolog\Handler\HandlerInterface object"); } } /** * {@inheritDoc} */ public function isHandling(array $record): bool { return true; } /** * Manually activate this logger regardless of the activation strategy */ public function activate(): void { if ($this->stopBuffering) { $this->buffering = false; } $this->getHandler(end($this->buffer) ?: null)->handleBatch($this->buffer); $this->buffer = []; } /** * {@inheritDoc} */ public function handle(array $record): bool { if ($this->processors) { /** @var Record $record */ $record = $this->processRecord($record); } if ($this->buffering) { $this->buffer[] = $record; if ($this->bufferSize > 0 && count($this->buffer) > $this->bufferSize) { array_shift($this->buffer); } if ($this->activationStrategy->isHandlerActivated($record)) { $this->activate(); } } else { $this->getHandler($record)->handle($record); } return false === $this->bubble; } /** * {@inheritDoc} */ public function close(): void { $this->flushBuffer(); $this->getHandler()->close(); } public function reset() { $this->flushBuffer(); $this->resetProcessors(); if ($this->getHandler() instanceof ResettableInterface) { $this->getHandler()->reset(); } } /** * Clears the buffer without flushing any messages down to the wrapped handler. * * It also resets the handler to its initial buffering state. */ public function clear(): void { $this->buffer = []; $this->reset(); } /** * Resets the state of the handler. Stops forwarding records to the wrapped handler. */ private function flushBuffer(): void { if (null !== $this->passthruLevel) { $level = $this->passthruLevel; $this->buffer = array_filter($this->buffer, function ($record) use ($level) { return $record['level'] >= $level; }); if (count($this->buffer) > 0) { $this->getHandler(end($this->buffer))->handleBatch($this->buffer); } } $this->buffer = []; $this->buffering = true; } /** * Return the nested handler * * If the handler was provided as a factory callable, this will trigger the handler's instantiation. * * @return HandlerInterface * * @phpstan-param Record $record */ public function getHandler(array $record = null) { if (!$this->handler instanceof HandlerInterface) { $this->handler = ($this->handler)($record, $this); if (!$this->handler instanceof HandlerInterface) { throw new \RuntimeException("The factory callable should return a HandlerInterface"); } } return $this->handler; } /** * {@inheritDoc} */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { $handler = $this->getHandler(); if ($handler instanceof FormattableHandlerInterface) { $handler->setFormatter($formatter); return $this; } throw new \UnexpectedValueException('The nested handler of type '.get_class($handler).' does not support formatters.'); } /** * {@inheritDoc} */ public function getFormatter(): FormatterInterface { $handler = $this->getHandler(); if ($handler instanceof FormattableHandlerInterface) { return $handler->getFormatter(); } throw new \UnexpectedValueException('The nested handler of type '.get_class($handler).' does not support formatters.'); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Elastic\Elasticsearch\Response\Elasticsearch; use Throwable; use RuntimeException; use Monolog\Logger; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\ElasticsearchFormatter; use InvalidArgumentException; use Elasticsearch\Common\Exceptions\RuntimeException as ElasticsearchRuntimeException; use Elasticsearch\Client; use Elastic\Elasticsearch\Exception\InvalidArgumentException as ElasticInvalidArgumentException; use Elastic\Elasticsearch\Client as Client8; /** * Elasticsearch handler * * @link https://www.elastic.co/guide/en/elasticsearch/client/php-api/current/index.html * * Simple usage example: * * $client = \Elasticsearch\ClientBuilder::create() * ->setHosts($hosts) * ->build(); * * $options = array( * 'index' => 'elastic_index_name', * 'type' => 'elastic_doc_type', * ); * $handler = new ElasticsearchHandler($client, $options); * $log = new Logger('application'); * $log->pushHandler($handler); * * @author Avtandil Kikabidze */ class ElasticsearchHandler extends AbstractProcessingHandler { /** * @var Client|Client8 */ protected $client; /** * @var mixed[] Handler config options */ protected $options = []; /** * @var bool */ private $needsType; /** * @param Client|Client8 $client Elasticsearch Client object * @param mixed[] $options Handler configuration */ public function __construct($client, array $options = [], $level = Logger::DEBUG, bool $bubble = true) { if (!$client instanceof Client && !$client instanceof Client8) { throw new \TypeError('Elasticsearch\Client or Elastic\Elasticsearch\Client instance required'); } parent::__construct($level, $bubble); $this->client = $client; $this->options = array_merge( [ 'index' => 'monolog', // Elastic index name 'type' => '_doc', // Elastic document type 'ignore_error' => false, // Suppress Elasticsearch exceptions ], $options ); if ($client instanceof Client8 || $client::VERSION[0] === '7') { $this->needsType = false; // force the type to _doc for ES8/ES7 $this->options['type'] = '_doc'; } else { $this->needsType = true; } } /** * {@inheritDoc} */ protected function write(array $record): void { $this->bulkSend([$record['formatted']]); } /** * {@inheritDoc} */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { if ($formatter instanceof ElasticsearchFormatter) { return parent::setFormatter($formatter); } throw new InvalidArgumentException('ElasticsearchHandler is only compatible with ElasticsearchFormatter'); } /** * Getter options * * @return mixed[] */ public function getOptions(): array { return $this->options; } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new ElasticsearchFormatter($this->options['index'], $this->options['type']); } /** * {@inheritDoc} */ public function handleBatch(array $records): void { $documents = $this->getFormatter()->formatBatch($records); $this->bulkSend($documents); } /** * Use Elasticsearch bulk API to send list of documents * * @param array[] $records Records + _index/_type keys * @throws \RuntimeException */ protected function bulkSend(array $records): void { try { $params = [ 'body' => [], ]; foreach ($records as $record) { $params['body'][] = [ 'index' => $this->needsType ? [ '_index' => $record['_index'], '_type' => $record['_type'], ] : [ '_index' => $record['_index'], ], ]; unset($record['_index'], $record['_type']); $params['body'][] = $record; } /** @var Elasticsearch */ $responses = $this->client->bulk($params); if ($responses['errors'] === true) { throw $this->createExceptionFromResponses($responses); } } catch (Throwable $e) { if (! $this->options['ignore_error']) { throw new RuntimeException('Error sending messages to Elasticsearch', 0, $e); } } } /** * Creates elasticsearch exception from responses array * * Only the first error is converted into an exception. * * @param mixed[]|Elasticsearch $responses returned by $this->client->bulk() */ protected function createExceptionFromResponses($responses): Throwable { foreach ($responses['items'] ?? [] as $item) { if (isset($item['index']['error'])) { return $this->createExceptionFromError($item['index']['error']); } } if (class_exists(ElasticInvalidArgumentException::class)) { return new ElasticInvalidArgumentException('Elasticsearch failed to index one or more records.'); } return new ElasticsearchRuntimeException('Elasticsearch failed to index one or more records.'); } /** * Creates elasticsearch exception from error array * * @param mixed[] $error */ protected function createExceptionFromError(array $error): Throwable { $previous = isset($error['caused_by']) ? $this->createExceptionFromError($error['caused_by']) : null; if (class_exists(ElasticInvalidArgumentException::class)) { return new ElasticInvalidArgumentException($error['type'] . ': ' . $error['reason'], 0, $previous); } return new ElasticsearchRuntimeException($error['type'] . ': ' . $error['reason'], 0, $previous); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Utils; use Monolog\Formatter\NormalizerFormatter; use Monolog\Formatter\FormatterInterface; /** * Class to record a log on a NewRelic application. * Enabling New Relic High Security mode may prevent capture of useful information. * * This handler requires a NormalizerFormatter to function and expects an array in $record['formatted'] * * @see https://docs.newrelic.com/docs/agents/php-agent * @see https://docs.newrelic.com/docs/accounts-partnerships/accounts/security/high-security */ class NewRelicHandler extends AbstractProcessingHandler { /** * Name of the New Relic application that will receive logs from this handler. * * @var ?string */ protected $appName; /** * Name of the current transaction * * @var ?string */ protected $transactionName; /** * Some context and extra data is passed into the handler as arrays of values. Do we send them as is * (useful if we are using the API), or explode them for display on the NewRelic RPM website? * * @var bool */ protected $explodeArrays; /** * {@inheritDoc} * * @param string|null $appName * @param bool $explodeArrays * @param string|null $transactionName */ public function __construct( $level = Logger::ERROR, bool $bubble = true, ?string $appName = null, bool $explodeArrays = false, ?string $transactionName = null ) { parent::__construct($level, $bubble); $this->appName = $appName; $this->explodeArrays = $explodeArrays; $this->transactionName = $transactionName; } /** * {@inheritDoc} */ protected function write(array $record): void { if (!$this->isNewRelicEnabled()) { throw new MissingExtensionException('The newrelic PHP extension is required to use the NewRelicHandler'); } if ($appName = $this->getAppName($record['context'])) { $this->setNewRelicAppName($appName); } if ($transactionName = $this->getTransactionName($record['context'])) { $this->setNewRelicTransactionName($transactionName); unset($record['formatted']['context']['transaction_name']); } if (isset($record['context']['exception']) && $record['context']['exception'] instanceof \Throwable) { newrelic_notice_error($record['message'], $record['context']['exception']); unset($record['formatted']['context']['exception']); } else { newrelic_notice_error($record['message']); } if (isset($record['formatted']['context']) && is_array($record['formatted']['context'])) { foreach ($record['formatted']['context'] as $key => $parameter) { if (is_array($parameter) && $this->explodeArrays) { foreach ($parameter as $paramKey => $paramValue) { $this->setNewRelicParameter('context_' . $key . '_' . $paramKey, $paramValue); } } else { $this->setNewRelicParameter('context_' . $key, $parameter); } } } if (isset($record['formatted']['extra']) && is_array($record['formatted']['extra'])) { foreach ($record['formatted']['extra'] as $key => $parameter) { if (is_array($parameter) && $this->explodeArrays) { foreach ($parameter as $paramKey => $paramValue) { $this->setNewRelicParameter('extra_' . $key . '_' . $paramKey, $paramValue); } } else { $this->setNewRelicParameter('extra_' . $key, $parameter); } } } } /** * Checks whether the NewRelic extension is enabled in the system. * * @return bool */ protected function isNewRelicEnabled(): bool { return extension_loaded('newrelic'); } /** * Returns the appname where this log should be sent. Each log can override the default appname, set in this * handler's constructor, by providing the appname in it's context. * * @param mixed[] $context */ protected function getAppName(array $context): ?string { if (isset($context['appname'])) { return $context['appname']; } return $this->appName; } /** * Returns the name of the current transaction. Each log can override the default transaction name, set in this * handler's constructor, by providing the transaction_name in it's context * * @param mixed[] $context */ protected function getTransactionName(array $context): ?string { if (isset($context['transaction_name'])) { return $context['transaction_name']; } return $this->transactionName; } /** * Sets the NewRelic application that should receive this log. */ protected function setNewRelicAppName(string $appName): void { newrelic_set_appname($appName); } /** * Overwrites the name of the current transaction */ protected function setNewRelicTransactionName(string $transactionName): void { newrelic_name_transaction($transactionName); } /** * @param string $key * @param mixed $value */ protected function setNewRelicParameter(string $key, $value): void { if (null === $value || is_scalar($value)) { newrelic_add_custom_parameter($key, $value); } else { newrelic_add_custom_parameter($key, Utils::jsonEncode($value, null, true)); } } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new NormalizerFormatter(); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Utils; /** * IFTTTHandler uses cURL to trigger IFTTT Maker actions * * Register a secret key and trigger/event name at https://ifttt.com/maker * * value1 will be the channel from monolog's Logger constructor, * value2 will be the level name (ERROR, WARNING, ..) * value3 will be the log record's message * * @author Nehal Patel */ class IFTTTHandler extends AbstractProcessingHandler { /** @var string */ private $eventName; /** @var string */ private $secretKey; /** * @param string $eventName The name of the IFTTT Maker event that should be triggered * @param string $secretKey A valid IFTTT secret key */ public function __construct(string $eventName, string $secretKey, $level = Logger::ERROR, bool $bubble = true) { if (!extension_loaded('curl')) { throw new MissingExtensionException('The curl extension is needed to use the IFTTTHandler'); } $this->eventName = $eventName; $this->secretKey = $secretKey; parent::__construct($level, $bubble); } /** * {@inheritDoc} */ public function write(array $record): void { $postData = [ "value1" => $record["channel"], "value2" => $record["level_name"], "value3" => $record["message"], ]; $postString = Utils::jsonEncode($postData); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://maker.ifttt.com/trigger/" . $this->eventName . "/with/key/" . $this->secretKey); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $postString); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Content-Type: application/json", ]); Curl\Util::execute($ch); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; /** * Base Handler class providing the Handler structure, including processors and formatters * * Classes extending it should (in most cases) only implement write($record) * * @author Jordi Boggiano * @author Christophe Coevoet * * @phpstan-import-type LevelName from \Monolog\Logger * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type Record from \Monolog\Logger * @phpstan-type FormattedRecord array{message: string, context: mixed[], level: Level, level_name: LevelName, channel: string, datetime: \DateTimeImmutable, extra: mixed[], formatted: mixed} */ abstract class AbstractProcessingHandler extends AbstractHandler implements ProcessableHandlerInterface, FormattableHandlerInterface { use ProcessableHandlerTrait; use FormattableHandlerTrait; /** * {@inheritDoc} */ public function handle(array $record): bool { if (!$this->isHandling($record)) { return false; } if ($this->processors) { /** @var Record $record */ $record = $this->processRecord($record); } $record['formatted'] = $this->getFormatter()->format($record); $this->write($record); return false === $this->bubble; } /** * Writes the record down to the log of the implementing handler * * @phpstan-param FormattedRecord $record */ abstract protected function write(array $record): void; /** * @return void */ public function reset() { parent::reset(); $this->resetProcessors(); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Utils; use Psr\Log\LogLevel; /** * Sends notifications through the pushover api to mobile phones * * @author Sebastian Göttschkes * @see https://www.pushover.net/api * * @phpstan-import-type FormattedRecord from AbstractProcessingHandler * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger */ class PushoverHandler extends SocketHandler { /** @var string */ private $token; /** @var array */ private $users; /** @var string */ private $title; /** @var string|int|null */ private $user = null; /** @var int */ private $retry; /** @var int */ private $expire; /** @var int */ private $highPriorityLevel; /** @var int */ private $emergencyLevel; /** @var bool */ private $useFormattedMessage = false; /** * All parameters that can be sent to Pushover * @see https://pushover.net/api * @var array */ private $parameterNames = [ 'token' => true, 'user' => true, 'message' => true, 'device' => true, 'title' => true, 'url' => true, 'url_title' => true, 'priority' => true, 'timestamp' => true, 'sound' => true, 'retry' => true, 'expire' => true, 'callback' => true, ]; /** * Sounds the api supports by default * @see https://pushover.net/api#sounds * @var string[] */ private $sounds = [ 'pushover', 'bike', 'bugle', 'cashregister', 'classical', 'cosmic', 'falling', 'gamelan', 'incoming', 'intermission', 'magic', 'mechanical', 'pianobar', 'siren', 'spacealarm', 'tugboat', 'alien', 'climb', 'persistent', 'echo', 'updown', 'none', ]; /** * @param string $token Pushover api token * @param string|array $users Pushover user id or array of ids the message will be sent to * @param string|null $title Title sent to the Pushover API * @param bool $useSSL Whether to connect via SSL. Required when pushing messages to users that are not * the pushover.net app owner. OpenSSL is required for this option. * @param string|int $highPriorityLevel The minimum logging level at which this handler will start * sending "high priority" requests to the Pushover API * @param string|int $emergencyLevel The minimum logging level at which this handler will start * sending "emergency" requests to the Pushover API * @param int $retry The retry parameter specifies how often (in seconds) the Pushover servers will * send the same notification to the user. * @param int $expire The expire parameter specifies how many seconds your notification will continue * to be retried for (every retry seconds). * * @phpstan-param string|array $users * @phpstan-param Level|LevelName|LogLevel::* $highPriorityLevel * @phpstan-param Level|LevelName|LogLevel::* $emergencyLevel */ public function __construct( string $token, $users, ?string $title = null, $level = Logger::CRITICAL, bool $bubble = true, bool $useSSL = true, $highPriorityLevel = Logger::CRITICAL, $emergencyLevel = Logger::EMERGENCY, int $retry = 30, int $expire = 25200, bool $persistent = false, float $timeout = 0.0, float $writingTimeout = 10.0, ?float $connectionTimeout = null, ?int $chunkSize = null ) { $connectionString = $useSSL ? 'ssl://api.pushover.net:443' : 'api.pushover.net:80'; parent::__construct( $connectionString, $level, $bubble, $persistent, $timeout, $writingTimeout, $connectionTimeout, $chunkSize ); $this->token = $token; $this->users = (array) $users; $this->title = $title ?: (string) gethostname(); $this->highPriorityLevel = Logger::toMonologLevel($highPriorityLevel); $this->emergencyLevel = Logger::toMonologLevel($emergencyLevel); $this->retry = $retry; $this->expire = $expire; } protected function generateDataStream(array $record): string { $content = $this->buildContent($record); return $this->buildHeader($content) . $content; } /** * @phpstan-param FormattedRecord $record */ private function buildContent(array $record): string { // Pushover has a limit of 512 characters on title and message combined. $maxMessageLength = 512 - strlen($this->title); $message = ($this->useFormattedMessage) ? $record['formatted'] : $record['message']; $message = Utils::substr($message, 0, $maxMessageLength); $timestamp = $record['datetime']->getTimestamp(); $dataArray = [ 'token' => $this->token, 'user' => $this->user, 'message' => $message, 'title' => $this->title, 'timestamp' => $timestamp, ]; if (isset($record['level']) && $record['level'] >= $this->emergencyLevel) { $dataArray['priority'] = 2; $dataArray['retry'] = $this->retry; $dataArray['expire'] = $this->expire; } elseif (isset($record['level']) && $record['level'] >= $this->highPriorityLevel) { $dataArray['priority'] = 1; } // First determine the available parameters $context = array_intersect_key($record['context'], $this->parameterNames); $extra = array_intersect_key($record['extra'], $this->parameterNames); // Least important info should be merged with subsequent info $dataArray = array_merge($extra, $context, $dataArray); // Only pass sounds that are supported by the API if (isset($dataArray['sound']) && !in_array($dataArray['sound'], $this->sounds)) { unset($dataArray['sound']); } return http_build_query($dataArray); } private function buildHeader(string $content): string { $header = "POST /1/messages.json HTTP/1.1\r\n"; $header .= "Host: api.pushover.net\r\n"; $header .= "Content-Type: application/x-www-form-urlencoded\r\n"; $header .= "Content-Length: " . strlen($content) . "\r\n"; $header .= "\r\n"; return $header; } protected function write(array $record): void { foreach ($this->users as $user) { $this->user = $user; parent::write($record); $this->closeSocket(); } $this->user = null; } /** * @param int|string $value * * @phpstan-param Level|LevelName|LogLevel::* $value */ public function setHighPriorityLevel($value): self { $this->highPriorityLevel = Logger::toMonologLevel($value); return $this; } /** * @param int|string $value * * @phpstan-param Level|LevelName|LogLevel::* $value */ public function setEmergencyLevel($value): self { $this->emergencyLevel = Logger::toMonologLevel($value); return $this; } /** * Use the formatted message? */ public function useFormattedMessage(bool $value): self { $this->useFormattedMessage = $value; return $this; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Processor\ProcessorInterface; /** * Interface to describe loggers that have processors * * @author Jordi Boggiano * * @phpstan-import-type Record from \Monolog\Logger */ interface ProcessableHandlerInterface { /** * Adds a processor in the stack. * * @psalm-param ProcessorInterface|callable(Record): Record $callback * * @param ProcessorInterface|callable $callback * @return HandlerInterface self */ public function pushProcessor(callable $callback): HandlerInterface; /** * Removes the processor on top of the stack and returns it. * * @psalm-return ProcessorInterface|callable(Record): Record $callback * * @throws \LogicException In case the processor stack is empty * @return callable|ProcessorInterface */ public function popProcessor(): callable; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Elastica\Document; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\ElasticaFormatter; use Monolog\Logger; use Elastica\Client; use Elastica\Exception\ExceptionInterface; /** * Elastic Search handler * * Usage example: * * $client = new \Elastica\Client(); * $options = array( * 'index' => 'elastic_index_name', * 'type' => 'elastic_doc_type', Types have been removed in Elastica 7 * ); * $handler = new ElasticaHandler($client, $options); * $log = new Logger('application'); * $log->pushHandler($handler); * * @author Jelle Vink */ class ElasticaHandler extends AbstractProcessingHandler { /** * @var Client */ protected $client; /** * @var mixed[] Handler config options */ protected $options = []; /** * @param Client $client Elastica Client object * @param mixed[] $options Handler configuration */ public function __construct(Client $client, array $options = [], $level = Logger::DEBUG, bool $bubble = true) { parent::__construct($level, $bubble); $this->client = $client; $this->options = array_merge( [ 'index' => 'monolog', // Elastic index name 'type' => 'record', // Elastic document type 'ignore_error' => false, // Suppress Elastica exceptions ], $options ); } /** * {@inheritDoc} */ protected function write(array $record): void { $this->bulkSend([$record['formatted']]); } /** * {@inheritDoc} */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { if ($formatter instanceof ElasticaFormatter) { return parent::setFormatter($formatter); } throw new \InvalidArgumentException('ElasticaHandler is only compatible with ElasticaFormatter'); } /** * @return mixed[] */ public function getOptions(): array { return $this->options; } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new ElasticaFormatter($this->options['index'], $this->options['type']); } /** * {@inheritDoc} */ public function handleBatch(array $records): void { $documents = $this->getFormatter()->formatBatch($records); $this->bulkSend($documents); } /** * Use Elasticsearch bulk API to send list of documents * * @param Document[] $documents * * @throws \RuntimeException */ protected function bulkSend(array $documents): void { try { $this->client->addDocuments($documents); } catch (ExceptionInterface $e) { if (!$this->options['ignore_error']) { throw new \RuntimeException("Error sending messages to Elasticsearch", 0, $e); } } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Psr\Log\LogLevel; /** * Used for testing purposes. * * It records all records and gives you access to them for verification. * * @author Jordi Boggiano * * @method bool hasEmergency($record) * @method bool hasAlert($record) * @method bool hasCritical($record) * @method bool hasError($record) * @method bool hasWarning($record) * @method bool hasNotice($record) * @method bool hasInfo($record) * @method bool hasDebug($record) * * @method bool hasEmergencyRecords() * @method bool hasAlertRecords() * @method bool hasCriticalRecords() * @method bool hasErrorRecords() * @method bool hasWarningRecords() * @method bool hasNoticeRecords() * @method bool hasInfoRecords() * @method bool hasDebugRecords() * * @method bool hasEmergencyThatContains($message) * @method bool hasAlertThatContains($message) * @method bool hasCriticalThatContains($message) * @method bool hasErrorThatContains($message) * @method bool hasWarningThatContains($message) * @method bool hasNoticeThatContains($message) * @method bool hasInfoThatContains($message) * @method bool hasDebugThatContains($message) * * @method bool hasEmergencyThatMatches($message) * @method bool hasAlertThatMatches($message) * @method bool hasCriticalThatMatches($message) * @method bool hasErrorThatMatches($message) * @method bool hasWarningThatMatches($message) * @method bool hasNoticeThatMatches($message) * @method bool hasInfoThatMatches($message) * @method bool hasDebugThatMatches($message) * * @method bool hasEmergencyThatPasses($message) * @method bool hasAlertThatPasses($message) * @method bool hasCriticalThatPasses($message) * @method bool hasErrorThatPasses($message) * @method bool hasWarningThatPasses($message) * @method bool hasNoticeThatPasses($message) * @method bool hasInfoThatPasses($message) * @method bool hasDebugThatPasses($message) * * @phpstan-import-type Record from \Monolog\Logger * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger */ class TestHandler extends AbstractProcessingHandler { /** @var Record[] */ protected $records = []; /** @var array */ protected $recordsByLevel = []; /** @var bool */ private $skipReset = false; /** * @return array * * @phpstan-return Record[] */ public function getRecords() { return $this->records; } /** * @return void */ public function clear() { $this->records = []; $this->recordsByLevel = []; } /** * @return void */ public function reset() { if (!$this->skipReset) { $this->clear(); } } /** * @return void */ public function setSkipReset(bool $skipReset) { $this->skipReset = $skipReset; } /** * @param string|int $level Logging level value or name * * @phpstan-param Level|LevelName|LogLevel::* $level */ public function hasRecords($level): bool { return isset($this->recordsByLevel[Logger::toMonologLevel($level)]); } /** * @param string|array $record Either a message string or an array containing message and optionally context keys that will be checked against all records * @param string|int $level Logging level value or name * * @phpstan-param array{message: string, context?: mixed[]}|string $record * @phpstan-param Level|LevelName|LogLevel::* $level */ public function hasRecord($record, $level): bool { if (is_string($record)) { $record = array('message' => $record); } return $this->hasRecordThatPasses(function ($rec) use ($record) { if ($rec['message'] !== $record['message']) { return false; } if (isset($record['context']) && $rec['context'] !== $record['context']) { return false; } return true; }, $level); } /** * @param string|int $level Logging level value or name * * @phpstan-param Level|LevelName|LogLevel::* $level */ public function hasRecordThatContains(string $message, $level): bool { return $this->hasRecordThatPasses(function ($rec) use ($message) { return strpos($rec['message'], $message) !== false; }, $level); } /** * @param string|int $level Logging level value or name * * @phpstan-param Level|LevelName|LogLevel::* $level */ public function hasRecordThatMatches(string $regex, $level): bool { return $this->hasRecordThatPasses(function (array $rec) use ($regex): bool { return preg_match($regex, $rec['message']) > 0; }, $level); } /** * @param string|int $level Logging level value or name * @return bool * * @psalm-param callable(Record, int): mixed $predicate * @phpstan-param Level|LevelName|LogLevel::* $level */ public function hasRecordThatPasses(callable $predicate, $level) { $level = Logger::toMonologLevel($level); if (!isset($this->recordsByLevel[$level])) { return false; } foreach ($this->recordsByLevel[$level] as $i => $rec) { if ($predicate($rec, $i)) { return true; } } return false; } /** * {@inheritDoc} */ protected function write(array $record): void { $this->recordsByLevel[$record['level']][] = $record; $this->records[] = $record; } /** * @param string $method * @param mixed[] $args * @return bool */ public function __call($method, $args) { if (preg_match('/(.*)(Debug|Info|Notice|Warning|Error|Critical|Alert|Emergency)(.*)/', $method, $matches) > 0) { $genericMethod = $matches[1] . ('Records' !== $matches[3] ? 'Record' : '') . $matches[3]; $level = constant('Monolog\Logger::' . strtoupper($matches[2])); $callback = [$this, $genericMethod]; if (is_callable($callback)) { $args[] = $level; return call_user_func_array($callback, $args); } } throw new \BadMethodCallException('Call to undefined method ' . get_class($this) . '::' . $method . '()'); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\JsonFormatter; use Monolog\Logger; /** * CouchDB handler * * @author Markus Bachmann */ class CouchDBHandler extends AbstractProcessingHandler { /** @var mixed[] */ private $options; /** * @param mixed[] $options */ public function __construct(array $options = [], $level = Logger::DEBUG, bool $bubble = true) { $this->options = array_merge([ 'host' => 'localhost', 'port' => 5984, 'dbname' => 'logger', 'username' => null, 'password' => null, ], $options); parent::__construct($level, $bubble); } /** * {@inheritDoc} */ protected function write(array $record): void { $basicAuth = null; if ($this->options['username']) { $basicAuth = sprintf('%s:%s@', $this->options['username'], $this->options['password']); } $url = 'http://'.$basicAuth.$this->options['host'].':'.$this->options['port'].'/'.$this->options['dbname']; $context = stream_context_create([ 'http' => [ 'method' => 'POST', 'content' => $record['formatted'], 'ignore_errors' => true, 'max_redirects' => 0, 'header' => 'Content-type: application/json', ], ]); if (false === @file_get_contents($url, false, $context)) { throw new \RuntimeException(sprintf('Could not connect to %s', $url)); } } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new JsonFormatter(JsonFormatter::BATCH_MODE_JSON, false); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; /** * SendGridrHandler uses the SendGrid API v2 function to send Log emails, more information in https://sendgrid.com/docs/API_Reference/Web_API/mail.html * * @author Ricardo Fontanelli */ class SendGridHandler extends MailHandler { /** * The SendGrid API User * @var string */ protected $apiUser; /** * The SendGrid API Key * @var string */ protected $apiKey; /** * The email addresses to which the message will be sent * @var string */ protected $from; /** * The email addresses to which the message will be sent * @var string[] */ protected $to; /** * The subject of the email * @var string */ protected $subject; /** * @param string $apiUser The SendGrid API User * @param string $apiKey The SendGrid API Key * @param string $from The sender of the email * @param string|string[] $to The recipients of the email * @param string $subject The subject of the mail */ public function __construct(string $apiUser, string $apiKey, string $from, $to, string $subject, $level = Logger::ERROR, bool $bubble = true) { if (!extension_loaded('curl')) { throw new MissingExtensionException('The curl extension is needed to use the SendGridHandler'); } parent::__construct($level, $bubble); $this->apiUser = $apiUser; $this->apiKey = $apiKey; $this->from = $from; $this->to = (array) $to; $this->subject = $subject; } /** * {@inheritDoc} */ protected function send(string $content, array $records): void { $message = []; $message['api_user'] = $this->apiUser; $message['api_key'] = $this->apiKey; $message['from'] = $this->from; foreach ($this->to as $recipient) { $message['to[]'] = $recipient; } $message['subject'] = $this->subject; $message['date'] = date('r'); if ($this->isHtmlBody($content)) { $message['html'] = $content; } else { $message['text'] = $content; } $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, 'https://api.sendgrid.com/api/mail.send.json'); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($message)); Curl\Util::execute($ch, 2); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\HtmlFormatter; /** * Base class for all mail handlers * * @author Gyula Sallai * * @phpstan-import-type Record from \Monolog\Logger */ abstract class MailHandler extends AbstractProcessingHandler { /** * {@inheritDoc} */ public function handleBatch(array $records): void { $messages = []; foreach ($records as $record) { if ($record['level'] < $this->level) { continue; } /** @var Record $message */ $message = $this->processRecord($record); $messages[] = $message; } if (!empty($messages)) { $this->send((string) $this->getFormatter()->formatBatch($messages), $messages); } } /** * Send a mail with the given content * * @param string $content formatted email body to be sent * @param array $records the array of log records that formed this content * * @phpstan-param Record[] $records */ abstract protected function send(string $content, array $records): void; /** * {@inheritDoc} */ protected function write(array $record): void { $this->send((string) $record['formatted'], [$record]); } /** * @phpstan-param non-empty-array $records * @phpstan-return Record */ protected function getHighestRecord(array $records): array { $highestRecord = null; foreach ($records as $record) { if ($highestRecord === null || $highestRecord['level'] < $record['level']) { $highestRecord = $record; } } return $highestRecord; } protected function isHtmlBody(string $body): bool { return ($body[0] ?? null) === '<'; } /** * Gets the default formatter. * * @return FormatterInterface */ protected function getDefaultFormatter(): FormatterInterface { return new HtmlFormatter(); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\LogmaticFormatter; /** * @author Julien Breux */ class LogmaticHandler extends SocketHandler { /** * @var string */ private $logToken; /** * @var string */ private $hostname; /** * @var string */ private $appname; /** * @param string $token Log token supplied by Logmatic. * @param string $hostname Host name supplied by Logmatic. * @param string $appname Application name supplied by Logmatic. * @param bool $useSSL Whether or not SSL encryption should be used. * * @throws MissingExtensionException If SSL encryption is set to true and OpenSSL is missing */ public function __construct( string $token, string $hostname = '', string $appname = '', bool $useSSL = true, $level = Logger::DEBUG, bool $bubble = true, bool $persistent = false, float $timeout = 0.0, float $writingTimeout = 10.0, ?float $connectionTimeout = null, ?int $chunkSize = null ) { if ($useSSL && !extension_loaded('openssl')) { throw new MissingExtensionException('The OpenSSL PHP extension is required to use SSL encrypted connection for LogmaticHandler'); } $endpoint = $useSSL ? 'ssl://api.logmatic.io:10515' : 'api.logmatic.io:10514'; $endpoint .= '/v1/'; parent::__construct( $endpoint, $level, $bubble, $persistent, $timeout, $writingTimeout, $connectionTimeout, $chunkSize ); $this->logToken = $token; $this->hostname = $hostname; $this->appname = $appname; } /** * {@inheritDoc} */ protected function generateDataStream(array $record): string { return $this->logToken . ' ' . $record['formatted']; } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { $formatter = new LogmaticFormatter(); if (!empty($this->hostname)) { $formatter->setHostname($this->hostname); } if (!empty($this->appname)) { $formatter->setAppname($this->appname); } return $formatter; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler\FingersCrossed; use Monolog\Logger; use Psr\Log\LogLevel; /** * Error level based activation strategy. * * @author Johannes M. Schmitt * * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger */ class ErrorLevelActivationStrategy implements ActivationStrategyInterface { /** * @var Level */ private $actionLevel; /** * @param int|string $actionLevel Level or name or value * * @phpstan-param Level|LevelName|LogLevel::* $actionLevel */ public function __construct($actionLevel) { $this->actionLevel = Logger::toMonologLevel($actionLevel); } public function isHandlerActivated(array $record): bool { return $record['level'] >= $this->actionLevel; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler\FingersCrossed; /** * Interface for activation strategies for the FingersCrossedHandler. * * @author Johannes M. Schmitt * * @phpstan-import-type Record from \Monolog\Logger */ interface ActivationStrategyInterface { /** * Returns whether the given record activates the handler. * * @phpstan-param Record $record */ public function isHandlerActivated(array $record): bool; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler\FingersCrossed; use Monolog\Logger; use Psr\Log\LogLevel; /** * Channel and Error level based monolog activation strategy. Allows to trigger activation * based on level per channel. e.g. trigger activation on level 'ERROR' by default, except * for records of the 'sql' channel; those should trigger activation on level 'WARN'. * * Example: * * * $activationStrategy = new ChannelLevelActivationStrategy( * Logger::CRITICAL, * array( * 'request' => Logger::ALERT, * 'sensitive' => Logger::ERROR, * ) * ); * $handler = new FingersCrossedHandler(new StreamHandler('php://stderr'), $activationStrategy); * * * @author Mike Meessen * * @phpstan-import-type Record from \Monolog\Logger * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger */ class ChannelLevelActivationStrategy implements ActivationStrategyInterface { /** * @var Level */ private $defaultActionLevel; /** * @var array */ private $channelToActionLevel; /** * @param int|string $defaultActionLevel The default action level to be used if the record's category doesn't match any * @param array $channelToActionLevel An array that maps channel names to action levels. * * @phpstan-param array $channelToActionLevel * @phpstan-param Level|LevelName|LogLevel::* $defaultActionLevel */ public function __construct($defaultActionLevel, array $channelToActionLevel = []) { $this->defaultActionLevel = Logger::toMonologLevel($defaultActionLevel); $this->channelToActionLevel = array_map('Monolog\Logger::toMonologLevel', $channelToActionLevel); } /** * @phpstan-param Record $record */ public function isHandlerActivated(array $record): bool { if (isset($this->channelToActionLevel[$record['channel']])) { return $record['level'] >= $this->channelToActionLevel[$record['channel']]; } return $record['level'] >= $this->defaultActionLevel; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\LineFormatter; /** * Helper trait for implementing FormattableInterface * * @author Jordi Boggiano */ trait FormattableHandlerTrait { /** * @var ?FormatterInterface */ protected $formatter; /** * {@inheritDoc} */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { $this->formatter = $formatter; return $this; } /** * {@inheritDoc} */ public function getFormatter(): FormatterInterface { if (!$this->formatter) { $this->formatter = $this->getDefaultFormatter(); } return $this->formatter; } /** * Gets the default formatter. * * Overwrite this if the LineFormatter is not a good default for your handler. */ protected function getDefaultFormatter(): FormatterInterface { return new LineFormatter(); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Formatter\LineFormatter; /** * NativeMailerHandler uses the mail() function to send the emails * * @author Christophe Coevoet * @author Mark Garrett */ class NativeMailerHandler extends MailHandler { /** * The email addresses to which the message will be sent * @var string[] */ protected $to; /** * The subject of the email * @var string */ protected $subject; /** * Optional headers for the message * @var string[] */ protected $headers = []; /** * Optional parameters for the message * @var string[] */ protected $parameters = []; /** * The wordwrap length for the message * @var int */ protected $maxColumnWidth; /** * The Content-type for the message * @var string|null */ protected $contentType; /** * The encoding for the message * @var string */ protected $encoding = 'utf-8'; /** * @param string|string[] $to The receiver of the mail * @param string $subject The subject of the mail * @param string $from The sender of the mail * @param int $maxColumnWidth The maximum column width that the message lines will have */ public function __construct($to, string $subject, string $from, $level = Logger::ERROR, bool $bubble = true, int $maxColumnWidth = 70) { parent::__construct($level, $bubble); $this->to = (array) $to; $this->subject = $subject; $this->addHeader(sprintf('From: %s', $from)); $this->maxColumnWidth = $maxColumnWidth; } /** * Add headers to the message * * @param string|string[] $headers Custom added headers */ public function addHeader($headers): self { foreach ((array) $headers as $header) { if (strpos($header, "\n") !== false || strpos($header, "\r") !== false) { throw new \InvalidArgumentException('Headers can not contain newline characters for security reasons'); } $this->headers[] = $header; } return $this; } /** * Add parameters to the message * * @param string|string[] $parameters Custom added parameters */ public function addParameter($parameters): self { $this->parameters = array_merge($this->parameters, (array) $parameters); return $this; } /** * {@inheritDoc} */ protected function send(string $content, array $records): void { $contentType = $this->getContentType() ?: ($this->isHtmlBody($content) ? 'text/html' : 'text/plain'); if ($contentType !== 'text/html') { $content = wordwrap($content, $this->maxColumnWidth); } $headers = ltrim(implode("\r\n", $this->headers) . "\r\n", "\r\n"); $headers .= 'Content-type: ' . $contentType . '; charset=' . $this->getEncoding() . "\r\n"; if ($contentType === 'text/html' && false === strpos($headers, 'MIME-Version:')) { $headers .= 'MIME-Version: 1.0' . "\r\n"; } $subject = $this->subject; if ($records) { $subjectFormatter = new LineFormatter($this->subject); $subject = $subjectFormatter->format($this->getHighestRecord($records)); } $parameters = implode(' ', $this->parameters); foreach ($this->to as $to) { mail($to, $subject, $content, $headers, $parameters); } } public function getContentType(): ?string { return $this->contentType; } public function getEncoding(): string { return $this->encoding; } /** * @param string $contentType The content type of the email - Defaults to text/plain. Use text/html for HTML messages. */ public function setContentType(string $contentType): self { if (strpos($contentType, "\n") !== false || strpos($contentType, "\r") !== false) { throw new \InvalidArgumentException('The content type can not contain newline characters to prevent email header injection'); } $this->contentType = $contentType; return $this; } public function setEncoding(string $encoding): self { if (strpos($encoding, "\n") !== false || strpos($encoding, "\r") !== false) { throw new \InvalidArgumentException('The encoding can not contain newline characters to prevent email header injection'); } $this->encoding = $encoding; return $this; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; /** * No-op * * This handler handles anything, but does nothing, and does not stop bubbling to the rest of the stack. * This can be used for testing, or to disable a handler when overriding a configuration without * influencing the rest of the stack. * * @author Roel Harbers */ class NoopHandler extends Handler { /** * {@inheritDoc} */ public function isHandling(array $record): bool { return true; } /** * {@inheritDoc} */ public function handle(array $record): bool { return false; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Rollbar\RollbarLogger; use Throwable; use Monolog\Logger; /** * Sends errors to Rollbar * * If the context data contains a `payload` key, that is used as an array * of payload options to RollbarLogger's log method. * * Rollbar's context info will contain the context + extra keys from the log record * merged, and then on top of that a few keys: * * - level (rollbar level name) * - monolog_level (monolog level name, raw level, as rollbar only has 5 but monolog 8) * - channel * - datetime (unix timestamp) * * @author Paul Statezny */ class RollbarHandler extends AbstractProcessingHandler { /** * @var RollbarLogger */ protected $rollbarLogger; /** @var string[] */ protected $levelMap = [ Logger::DEBUG => 'debug', Logger::INFO => 'info', Logger::NOTICE => 'info', Logger::WARNING => 'warning', Logger::ERROR => 'error', Logger::CRITICAL => 'critical', Logger::ALERT => 'critical', Logger::EMERGENCY => 'critical', ]; /** * Records whether any log records have been added since the last flush of the rollbar notifier * * @var bool */ private $hasRecords = false; /** @var bool */ protected $initialized = false; /** * @param RollbarLogger $rollbarLogger RollbarLogger object constructed with valid token */ public function __construct(RollbarLogger $rollbarLogger, $level = Logger::ERROR, bool $bubble = true) { $this->rollbarLogger = $rollbarLogger; parent::__construct($level, $bubble); } /** * {@inheritDoc} */ protected function write(array $record): void { if (!$this->initialized) { // __destructor() doesn't get called on Fatal errors register_shutdown_function(array($this, 'close')); $this->initialized = true; } $context = $record['context']; $context = array_merge($context, $record['extra'], [ 'level' => $this->levelMap[$record['level']], 'monolog_level' => $record['level_name'], 'channel' => $record['channel'], 'datetime' => $record['datetime']->format('U'), ]); if (isset($context['exception']) && $context['exception'] instanceof Throwable) { $exception = $context['exception']; unset($context['exception']); $toLog = $exception; } else { $toLog = $record['message']; } // @phpstan-ignore-next-line $this->rollbarLogger->log($context['level'], $toLog, $context); $this->hasRecords = true; } public function flush(): void { if ($this->hasRecords) { $this->rollbarLogger->flush(); $this->hasRecords = false; } } /** * {@inheritDoc} */ public function close(): void { $this->flush(); } /** * {@inheritDoc} */ public function reset() { $this->flush(); parent::reset(); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; /** * Stores to any socket - uses fsockopen() or pfsockopen(). * * @author Pablo de Leon Belloc * @see http://php.net/manual/en/function.fsockopen.php * * @phpstan-import-type Record from \Monolog\Logger * @phpstan-import-type FormattedRecord from AbstractProcessingHandler */ class SocketHandler extends AbstractProcessingHandler { /** @var string */ private $connectionString; /** @var float */ private $connectionTimeout; /** @var resource|null */ private $resource; /** @var float */ private $timeout; /** @var float */ private $writingTimeout; /** @var ?int */ private $lastSentBytes = null; /** @var ?int */ private $chunkSize; /** @var bool */ private $persistent; /** @var ?int */ private $errno = null; /** @var ?string */ private $errstr = null; /** @var ?float */ private $lastWritingAt = null; /** * @param string $connectionString Socket connection string * @param bool $persistent Flag to enable/disable persistent connections * @param float $timeout Socket timeout to wait until the request is being aborted * @param float $writingTimeout Socket timeout to wait until the request should've been sent/written * @param float|null $connectionTimeout Socket connect timeout to wait until the connection should've been * established * @param int|null $chunkSize Sets the chunk size. Only has effect during connection in the writing cycle * * @throws \InvalidArgumentException If an invalid timeout value (less than 0) is passed. */ public function __construct( string $connectionString, $level = Logger::DEBUG, bool $bubble = true, bool $persistent = false, float $timeout = 0.0, float $writingTimeout = 10.0, ?float $connectionTimeout = null, ?int $chunkSize = null ) { parent::__construct($level, $bubble); $this->connectionString = $connectionString; if ($connectionTimeout !== null) { $this->validateTimeout($connectionTimeout); } $this->connectionTimeout = $connectionTimeout ?? (float) ini_get('default_socket_timeout'); $this->persistent = $persistent; $this->validateTimeout($timeout); $this->timeout = $timeout; $this->validateTimeout($writingTimeout); $this->writingTimeout = $writingTimeout; $this->chunkSize = $chunkSize; } /** * Connect (if necessary) and write to the socket * * {@inheritDoc} * * @throws \UnexpectedValueException * @throws \RuntimeException */ protected function write(array $record): void { $this->connectIfNotConnected(); $data = $this->generateDataStream($record); $this->writeToSocket($data); } /** * We will not close a PersistentSocket instance so it can be reused in other requests. */ public function close(): void { if (!$this->isPersistent()) { $this->closeSocket(); } } /** * Close socket, if open */ public function closeSocket(): void { if (is_resource($this->resource)) { fclose($this->resource); $this->resource = null; } } /** * Set socket connection to be persistent. It only has effect before the connection is initiated. */ public function setPersistent(bool $persistent): self { $this->persistent = $persistent; return $this; } /** * Set connection timeout. Only has effect before we connect. * * @see http://php.net/manual/en/function.fsockopen.php */ public function setConnectionTimeout(float $seconds): self { $this->validateTimeout($seconds); $this->connectionTimeout = $seconds; return $this; } /** * Set write timeout. Only has effect before we connect. * * @see http://php.net/manual/en/function.stream-set-timeout.php */ public function setTimeout(float $seconds): self { $this->validateTimeout($seconds); $this->timeout = $seconds; return $this; } /** * Set writing timeout. Only has effect during connection in the writing cycle. * * @param float $seconds 0 for no timeout */ public function setWritingTimeout(float $seconds): self { $this->validateTimeout($seconds); $this->writingTimeout = $seconds; return $this; } /** * Set chunk size. Only has effect during connection in the writing cycle. */ public function setChunkSize(int $bytes): self { $this->chunkSize = $bytes; return $this; } /** * Get current connection string */ public function getConnectionString(): string { return $this->connectionString; } /** * Get persistent setting */ public function isPersistent(): bool { return $this->persistent; } /** * Get current connection timeout setting */ public function getConnectionTimeout(): float { return $this->connectionTimeout; } /** * Get current in-transfer timeout */ public function getTimeout(): float { return $this->timeout; } /** * Get current local writing timeout * * @return float */ public function getWritingTimeout(): float { return $this->writingTimeout; } /** * Get current chunk size */ public function getChunkSize(): ?int { return $this->chunkSize; } /** * Check to see if the socket is currently available. * * UDP might appear to be connected but might fail when writing. See http://php.net/fsockopen for details. */ public function isConnected(): bool { return is_resource($this->resource) && !feof($this->resource); // on TCP - other party can close connection. } /** * Wrapper to allow mocking * * @return resource|false */ protected function pfsockopen() { return @pfsockopen($this->connectionString, -1, $this->errno, $this->errstr, $this->connectionTimeout); } /** * Wrapper to allow mocking * * @return resource|false */ protected function fsockopen() { return @fsockopen($this->connectionString, -1, $this->errno, $this->errstr, $this->connectionTimeout); } /** * Wrapper to allow mocking * * @see http://php.net/manual/en/function.stream-set-timeout.php * * @return bool */ protected function streamSetTimeout() { $seconds = floor($this->timeout); $microseconds = round(($this->timeout - $seconds) * 1e6); if (!is_resource($this->resource)) { throw new \LogicException('streamSetTimeout called but $this->resource is not a resource'); } return stream_set_timeout($this->resource, (int) $seconds, (int) $microseconds); } /** * Wrapper to allow mocking * * @see http://php.net/manual/en/function.stream-set-chunk-size.php * * @return int|bool */ protected function streamSetChunkSize() { if (!is_resource($this->resource)) { throw new \LogicException('streamSetChunkSize called but $this->resource is not a resource'); } if (null === $this->chunkSize) { throw new \LogicException('streamSetChunkSize called but $this->chunkSize is not set'); } return stream_set_chunk_size($this->resource, $this->chunkSize); } /** * Wrapper to allow mocking * * @return int|bool */ protected function fwrite(string $data) { if (!is_resource($this->resource)) { throw new \LogicException('fwrite called but $this->resource is not a resource'); } return @fwrite($this->resource, $data); } /** * Wrapper to allow mocking * * @return mixed[]|bool */ protected function streamGetMetadata() { if (!is_resource($this->resource)) { throw new \LogicException('streamGetMetadata called but $this->resource is not a resource'); } return stream_get_meta_data($this->resource); } private function validateTimeout(float $value): void { if ($value < 0) { throw new \InvalidArgumentException("Timeout must be 0 or a positive float (got $value)"); } } private function connectIfNotConnected(): void { if ($this->isConnected()) { return; } $this->connect(); } /** * @phpstan-param FormattedRecord $record */ protected function generateDataStream(array $record): string { return (string) $record['formatted']; } /** * @return resource|null */ protected function getResource() { return $this->resource; } private function connect(): void { $this->createSocketResource(); $this->setSocketTimeout(); $this->setStreamChunkSize(); } private function createSocketResource(): void { if ($this->isPersistent()) { $resource = $this->pfsockopen(); } else { $resource = $this->fsockopen(); } if (is_bool($resource)) { throw new \UnexpectedValueException("Failed connecting to $this->connectionString ($this->errno: $this->errstr)"); } $this->resource = $resource; } private function setSocketTimeout(): void { if (!$this->streamSetTimeout()) { throw new \UnexpectedValueException("Failed setting timeout with stream_set_timeout()"); } } private function setStreamChunkSize(): void { if ($this->chunkSize && !$this->streamSetChunkSize()) { throw new \UnexpectedValueException("Failed setting chunk size with stream_set_chunk_size()"); } } private function writeToSocket(string $data): void { $length = strlen($data); $sent = 0; $this->lastSentBytes = $sent; while ($this->isConnected() && $sent < $length) { if (0 == $sent) { $chunk = $this->fwrite($data); } else { $chunk = $this->fwrite(substr($data, $sent)); } if ($chunk === false) { throw new \RuntimeException("Could not write to socket"); } $sent += $chunk; $socketInfo = $this->streamGetMetadata(); if (is_array($socketInfo) && $socketInfo['timed_out']) { throw new \RuntimeException("Write timed-out"); } if ($this->writingIsTimedOut($sent)) { throw new \RuntimeException("Write timed-out, no data sent for `{$this->writingTimeout}` seconds, probably we got disconnected (sent $sent of $length)"); } } if (!$this->isConnected() && $sent < $length) { throw new \RuntimeException("End-of-file reached, probably we got disconnected (sent $sent of $length)"); } } private function writingIsTimedOut(int $sent): bool { // convert to ms if (0.0 == $this->writingTimeout) { return false; } if ($sent !== $this->lastSentBytes) { $this->lastWritingAt = microtime(true); $this->lastSentBytes = $sent; return false; } else { usleep(100); } if ((microtime(true) - $this->lastWritingAt) >= $this->writingTimeout) { $this->closeSocket(); return true; } return false; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Psr\Log\LogLevel; /** * Simple handler wrapper that deduplicates log records across multiple requests * * It also includes the BufferHandler functionality and will buffer * all messages until the end of the request or flush() is called. * * This works by storing all log records' messages above $deduplicationLevel * to the file specified by $deduplicationStore. When further logs come in at the end of the * request (or when flush() is called), all those above $deduplicationLevel are checked * against the existing stored logs. If they match and the timestamps in the stored log is * not older than $time seconds, the new log record is discarded. If no log record is new, the * whole data set is discarded. * * This is mainly useful in combination with Mail handlers or things like Slack or HipChat handlers * that send messages to people, to avoid spamming with the same message over and over in case of * a major component failure like a database server being down which makes all requests fail in the * same way. * * @author Jordi Boggiano * * @phpstan-import-type Record from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger * @phpstan-import-type Level from \Monolog\Logger */ class DeduplicationHandler extends BufferHandler { /** * @var string */ protected $deduplicationStore; /** * @var Level */ protected $deduplicationLevel; /** * @var int */ protected $time; /** * @var bool */ private $gc = false; /** * @param HandlerInterface $handler Handler. * @param string $deduplicationStore The file/path where the deduplication log should be kept * @param string|int $deduplicationLevel The minimum logging level for log records to be looked at for deduplication purposes * @param int $time The period (in seconds) during which duplicate entries should be suppressed after a given log is sent through * @param bool $bubble Whether the messages that are handled can bubble up the stack or not * * @phpstan-param Level|LevelName|LogLevel::* $deduplicationLevel */ public function __construct(HandlerInterface $handler, ?string $deduplicationStore = null, $deduplicationLevel = Logger::ERROR, int $time = 60, bool $bubble = true) { parent::__construct($handler, 0, Logger::DEBUG, $bubble, false); $this->deduplicationStore = $deduplicationStore === null ? sys_get_temp_dir() . '/monolog-dedup-' . substr(md5(__FILE__), 0, 20) .'.log' : $deduplicationStore; $this->deduplicationLevel = Logger::toMonologLevel($deduplicationLevel); $this->time = $time; } public function flush(): void { if ($this->bufferSize === 0) { return; } $passthru = null; foreach ($this->buffer as $record) { if ($record['level'] >= $this->deduplicationLevel) { $passthru = $passthru || !$this->isDuplicate($record); if ($passthru) { $this->appendRecord($record); } } } // default of null is valid as well as if no record matches duplicationLevel we just pass through if ($passthru === true || $passthru === null) { $this->handler->handleBatch($this->buffer); } $this->clear(); if ($this->gc) { $this->collectLogs(); } } /** * @phpstan-param Record $record */ private function isDuplicate(array $record): bool { if (!file_exists($this->deduplicationStore)) { return false; } $store = file($this->deduplicationStore, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES); if (!is_array($store)) { return false; } $yesterday = time() - 86400; $timestampValidity = $record['datetime']->getTimestamp() - $this->time; $expectedMessage = preg_replace('{[\r\n].*}', '', $record['message']); for ($i = count($store) - 1; $i >= 0; $i--) { list($timestamp, $level, $message) = explode(':', $store[$i], 3); if ($level === $record['level_name'] && $message === $expectedMessage && $timestamp > $timestampValidity) { return true; } if ($timestamp < $yesterday) { $this->gc = true; } } return false; } private function collectLogs(): void { if (!file_exists($this->deduplicationStore)) { return; } $handle = fopen($this->deduplicationStore, 'rw+'); if (!$handle) { throw new \RuntimeException('Failed to open file for reading and writing: ' . $this->deduplicationStore); } flock($handle, LOCK_EX); $validLogs = []; $timestampValidity = time() - $this->time; while (!feof($handle)) { $log = fgets($handle); if ($log && substr($log, 0, 10) >= $timestampValidity) { $validLogs[] = $log; } } ftruncate($handle, 0); rewind($handle); foreach ($validLogs as $log) { fwrite($handle, $log); } flock($handle, LOCK_UN); fclose($handle); $this->gc = false; } /** * @phpstan-param Record $record */ private function appendRecord(array $record): void { file_put_contents($this->deduplicationStore, $record['datetime']->getTimestamp() . ':' . $record['level_name'] . ':' . preg_replace('{[\r\n].*}', '', $record['message']) . "\n", FILE_APPEND); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\JsonFormatter; use PhpAmqpLib\Message\AMQPMessage; use PhpAmqpLib\Channel\AMQPChannel; use AMQPExchange; /** * @phpstan-import-type Record from \Monolog\Logger */ class AmqpHandler extends AbstractProcessingHandler { /** * @var AMQPExchange|AMQPChannel $exchange */ protected $exchange; /** @var array */ private $extraAttributes = []; /** * @return array */ public function getExtraAttributes(): array { return $this->extraAttributes; } /** * Configure extra attributes to pass to the AMQPExchange (if you are using the amqp extension) * * @param array $extraAttributes One of content_type, content_encoding, * message_id, user_id, app_id, delivery_mode, * priority, timestamp, expiration, type * or reply_to, headers. * @return AmqpHandler */ public function setExtraAttributes(array $extraAttributes): self { $this->extraAttributes = $extraAttributes; return $this; } /** * @var string */ protected $exchangeName; /** * @param AMQPExchange|AMQPChannel $exchange AMQPExchange (php AMQP ext) or PHP AMQP lib channel, ready for use * @param string|null $exchangeName Optional exchange name, for AMQPChannel (PhpAmqpLib) only */ public function __construct($exchange, ?string $exchangeName = null, $level = Logger::DEBUG, bool $bubble = true) { if ($exchange instanceof AMQPChannel) { $this->exchangeName = (string) $exchangeName; } elseif (!$exchange instanceof AMQPExchange) { throw new \InvalidArgumentException('PhpAmqpLib\Channel\AMQPChannel or AMQPExchange instance required'); } elseif ($exchangeName) { @trigger_error('The $exchangeName parameter can only be passed when using PhpAmqpLib, if using an AMQPExchange instance configure it beforehand', E_USER_DEPRECATED); } $this->exchange = $exchange; parent::__construct($level, $bubble); } /** * {@inheritDoc} */ protected function write(array $record): void { $data = $record["formatted"]; $routingKey = $this->getRoutingKey($record); if ($this->exchange instanceof AMQPExchange) { $attributes = [ 'delivery_mode' => 2, 'content_type' => 'application/json', ]; if ($this->extraAttributes) { $attributes = array_merge($attributes, $this->extraAttributes); } $this->exchange->publish( $data, $routingKey, 0, $attributes ); } else { $this->exchange->basic_publish( $this->createAmqpMessage($data), $this->exchangeName, $routingKey ); } } /** * {@inheritDoc} */ public function handleBatch(array $records): void { if ($this->exchange instanceof AMQPExchange) { parent::handleBatch($records); return; } foreach ($records as $record) { if (!$this->isHandling($record)) { continue; } /** @var Record $record */ $record = $this->processRecord($record); $data = $this->getFormatter()->format($record); $this->exchange->batch_basic_publish( $this->createAmqpMessage($data), $this->exchangeName, $this->getRoutingKey($record) ); } $this->exchange->publish_batch(); } /** * Gets the routing key for the AMQP exchange * * @phpstan-param Record $record */ protected function getRoutingKey(array $record): string { $routingKey = sprintf('%s.%s', $record['level_name'], $record['channel']); return strtolower($routingKey); } private function createAmqpMessage(string $data): AMQPMessage { return new AMQPMessage( $data, [ 'delivery_mode' => 2, 'content_type' => 'application/json', ] ); } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new JsonFormatter(JsonFormatter::BATCH_MODE_JSON, false); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; /** * Interface that all Monolog Handlers must implement * * @author Jordi Boggiano * * @phpstan-import-type Record from \Monolog\Logger * @phpstan-import-type Level from \Monolog\Logger */ interface HandlerInterface { /** * Checks whether the given record will be handled by this handler. * * This is mostly done for performance reasons, to avoid calling processors for nothing. * * Handlers should still check the record levels within handle(), returning false in isHandling() * is no guarantee that handle() will not be called, and isHandling() might not be called * for a given record. * * @param array $record Partial log record containing only a level key * * @return bool * * @phpstan-param array{level: Level} $record */ public function isHandling(array $record): bool; /** * Handles a record. * * All records may be passed to this method, and the handler should discard * those that it does not want to handle. * * The return value of this function controls the bubbling process of the handler stack. * Unless the bubbling is interrupted (by returning true), the Logger class will keep on * calling further handlers in the stack with a given log record. * * @param array $record The record to handle * @return bool true means that this handler handled the record, and that bubbling is not permitted. * false means the record was either not processed or that this handler allows bubbling. * * @phpstan-param Record $record */ public function handle(array $record): bool; /** * Handles a set of records at once. * * @param array $records The records to handle (an array of record arrays) * * @phpstan-param Record[] $records */ public function handleBatch(array $records): void; /** * Closes the handler. * * Ends a log cycle and frees all resources used by the handler. * * Closing a Handler means flushing all buffers and freeing any open resources/handles. * * Implementations have to be idempotent (i.e. it should be possible to call close several times without breakage) * and ideally handlers should be able to reopen themselves on handle() after they have been closed. * * This is useful at the end of a request and will be called automatically when the object * is destroyed if you extend Monolog\Handler\Handler. * * If you are thinking of calling this method yourself, most likely you should be * calling ResettableInterface::reset instead. Have a look. */ public function close(): void; } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\LogglyFormatter; use function array_key_exists; use CurlHandle; /** * Sends errors to Loggly. * * @author Przemek Sobstel * @author Adam Pancutt * @author Gregory Barchard */ class LogglyHandler extends AbstractProcessingHandler { protected const HOST = 'logs-01.loggly.com'; protected const ENDPOINT_SINGLE = 'inputs'; protected const ENDPOINT_BATCH = 'bulk'; /** * Caches the curl handlers for every given endpoint. * * @var resource[]|CurlHandle[] */ protected $curlHandlers = []; /** @var string */ protected $token; /** @var string[] */ protected $tag = []; /** * @param string $token API token supplied by Loggly * * @throws MissingExtensionException If the curl extension is missing */ public function __construct(string $token, $level = Logger::DEBUG, bool $bubble = true) { if (!extension_loaded('curl')) { throw new MissingExtensionException('The curl extension is needed to use the LogglyHandler'); } $this->token = $token; parent::__construct($level, $bubble); } /** * Loads and returns the shared curl handler for the given endpoint. * * @param string $endpoint * * @return resource|CurlHandle */ protected function getCurlHandler(string $endpoint) { if (!array_key_exists($endpoint, $this->curlHandlers)) { $this->curlHandlers[$endpoint] = $this->loadCurlHandle($endpoint); } return $this->curlHandlers[$endpoint]; } /** * Starts a fresh curl session for the given endpoint and returns its handler. * * @param string $endpoint * * @return resource|CurlHandle */ private function loadCurlHandle(string $endpoint) { $url = sprintf("https://%s/%s/%s/", static::HOST, $endpoint, $this->token); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); return $ch; } /** * @param string[]|string $tag */ public function setTag($tag): self { $tag = !empty($tag) ? $tag : []; $this->tag = is_array($tag) ? $tag : [$tag]; return $this; } /** * @param string[]|string $tag */ public function addTag($tag): self { if (!empty($tag)) { $tag = is_array($tag) ? $tag : [$tag]; $this->tag = array_unique(array_merge($this->tag, $tag)); } return $this; } protected function write(array $record): void { $this->send($record["formatted"], static::ENDPOINT_SINGLE); } public function handleBatch(array $records): void { $level = $this->level; $records = array_filter($records, function ($record) use ($level) { return ($record['level'] >= $level); }); if ($records) { $this->send($this->getFormatter()->formatBatch($records), static::ENDPOINT_BATCH); } } protected function send(string $data, string $endpoint): void { $ch = $this->getCurlHandler($endpoint); $headers = ['Content-Type: application/json']; if (!empty($this->tag)) { $headers[] = 'X-LOGGLY-TAG: '.implode(',', $this->tag); } curl_setopt($ch, CURLOPT_POSTFIELDS, $data); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); Curl\Util::execute($ch, 5, false); } protected function getDefaultFormatter(): FormatterInterface { return new LogglyFormatter(); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\NormalizerFormatter; use Monolog\Logger; /** * Handler sending logs to Zend Monitor * * @author Christian Bergau * @author Jason Davis * * @phpstan-import-type FormattedRecord from AbstractProcessingHandler */ class ZendMonitorHandler extends AbstractProcessingHandler { /** * Monolog level / ZendMonitor Custom Event priority map * * @var array */ protected $levelMap = []; /** * @throws MissingExtensionException */ public function __construct($level = Logger::DEBUG, bool $bubble = true) { if (!function_exists('zend_monitor_custom_event')) { throw new MissingExtensionException( 'You must have Zend Server installed with Zend Monitor enabled in order to use this handler' ); } //zend monitor constants are not defined if zend monitor is not enabled. $this->levelMap = [ Logger::DEBUG => \ZEND_MONITOR_EVENT_SEVERITY_INFO, Logger::INFO => \ZEND_MONITOR_EVENT_SEVERITY_INFO, Logger::NOTICE => \ZEND_MONITOR_EVENT_SEVERITY_INFO, Logger::WARNING => \ZEND_MONITOR_EVENT_SEVERITY_WARNING, Logger::ERROR => \ZEND_MONITOR_EVENT_SEVERITY_ERROR, Logger::CRITICAL => \ZEND_MONITOR_EVENT_SEVERITY_ERROR, Logger::ALERT => \ZEND_MONITOR_EVENT_SEVERITY_ERROR, Logger::EMERGENCY => \ZEND_MONITOR_EVENT_SEVERITY_ERROR, ]; parent::__construct($level, $bubble); } /** * {@inheritDoc} */ protected function write(array $record): void { $this->writeZendMonitorCustomEvent( Logger::getLevelName($record['level']), $record['message'], $record['formatted'], $this->levelMap[$record['level']] ); } /** * Write to Zend Monitor Events * @param string $type Text displayed in "Class Name (custom)" field * @param string $message Text displayed in "Error String" * @param array $formatted Displayed in Custom Variables tab * @param int $severity Set the event severity level (-1,0,1) * * @phpstan-param FormattedRecord $formatted */ protected function writeZendMonitorCustomEvent(string $type, string $message, array $formatted, int $severity): void { zend_monitor_custom_event($type, $message, $formatted, $severity); } /** * {@inheritDoc} */ public function getDefaultFormatter(): FormatterInterface { return new NormalizerFormatter(); } /** * @return array */ public function getLevelMap(): array { return $this->levelMap; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\ResettableInterface; use Psr\Log\LogLevel; /** * Base Handler class providing basic level/bubble support * * @author Jordi Boggiano * * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger */ abstract class AbstractHandler extends Handler implements ResettableInterface { /** * @var int * @phpstan-var Level */ protected $level = Logger::DEBUG; /** @var bool */ protected $bubble = true; /** * @param int|string $level The minimum logging level at which this handler will be triggered * @param bool $bubble Whether the messages that are handled can bubble up the stack or not * * @phpstan-param Level|LevelName|LogLevel::* $level */ public function __construct($level = Logger::DEBUG, bool $bubble = true) { $this->setLevel($level); $this->bubble = $bubble; } /** * {@inheritDoc} */ public function isHandling(array $record): bool { return $record['level'] >= $this->level; } /** * Sets minimum logging level at which this handler will be triggered. * * @param Level|LevelName|LogLevel::* $level Level or level name * @return self */ public function setLevel($level): self { $this->level = Logger::toMonologLevel($level); return $this; } /** * Gets minimum logging level at which this handler will be triggered. * * @return int * * @phpstan-return Level */ public function getLevel(): int { return $this->level; } /** * Sets the bubbling behavior. * * @param bool $bubble true means that this handler allows bubbling. * false means that bubbling is not permitted. * @return self */ public function setBubble(bool $bubble): self { $this->bubble = $bubble; return $this; } /** * Gets the bubbling behavior. * * @return bool true means that this handler allows bubbling. * false means that bubbling is not permitted. */ public function getBubble(): bool { return $this->bubble; } /** * {@inheritDoc} */ public function reset() { } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\LineFormatter; use Monolog\Formatter\FormatterInterface; use Monolog\Logger; use Monolog\Utils; use PhpConsole\Connector; use PhpConsole\Handler as VendorPhpConsoleHandler; use PhpConsole\Helper; /** * Monolog handler for Google Chrome extension "PHP Console" * * Display PHP error/debug log messages in Google Chrome console and notification popups, executes PHP code remotely * * Usage: * 1. Install Google Chrome extension [now dead and removed from the chrome store] * 2. See overview https://github.com/barbushin/php-console#overview * 3. Install PHP Console library https://github.com/barbushin/php-console#installation * 4. Example (result will looks like http://i.hizliresim.com/vg3Pz4.png) * * $logger = new \Monolog\Logger('all', array(new \Monolog\Handler\PHPConsoleHandler())); * \Monolog\ErrorHandler::register($logger); * echo $undefinedVar; * $logger->debug('SELECT * FROM users', array('db', 'time' => 0.012)); * PC::debug($_SERVER); // PHP Console debugger for any type of vars * * @author Sergey Barbushin https://www.linkedin.com/in/barbushin * * @phpstan-import-type Record from \Monolog\Logger * @deprecated Since 2.8.0 and 3.2.0, PHPConsole is abandoned and thus we will drop this handler in Monolog 4 */ class PHPConsoleHandler extends AbstractProcessingHandler { /** @var array */ private $options = [ 'enabled' => true, // bool Is PHP Console server enabled 'classesPartialsTraceIgnore' => ['Monolog\\'], // array Hide calls of classes started with... 'debugTagsKeysInContext' => [0, 'tag'], // bool Is PHP Console server enabled 'useOwnErrorsHandler' => false, // bool Enable errors handling 'useOwnExceptionsHandler' => false, // bool Enable exceptions handling 'sourcesBasePath' => null, // string Base path of all project sources to strip in errors source paths 'registerHelper' => true, // bool Register PhpConsole\Helper that allows short debug calls like PC::debug($var, 'ta.g.s') 'serverEncoding' => null, // string|null Server internal encoding 'headersLimit' => null, // int|null Set headers size limit for your web-server 'password' => null, // string|null Protect PHP Console connection by password 'enableSslOnlyMode' => false, // bool Force connection by SSL for clients with PHP Console installed 'ipMasks' => [], // array Set IP masks of clients that will be allowed to connect to PHP Console: array('192.168.*.*', '127.0.0.1') 'enableEvalListener' => false, // bool Enable eval request to be handled by eval dispatcher(if enabled, 'password' option is also required) 'dumperDetectCallbacks' => false, // bool Convert callback items in dumper vars to (callback SomeClass::someMethod) strings 'dumperLevelLimit' => 5, // int Maximum dumped vars array or object nested dump level 'dumperItemsCountLimit' => 100, // int Maximum dumped var same level array items or object properties number 'dumperItemSizeLimit' => 5000, // int Maximum length of any string or dumped array item 'dumperDumpSizeLimit' => 500000, // int Maximum approximate size of dumped vars result formatted in JSON 'detectDumpTraceAndSource' => false, // bool Autodetect and append trace data to debug 'dataStorage' => null, // \PhpConsole\Storage|null Fixes problem with custom $_SESSION handler(see http://goo.gl/Ne8juJ) ]; /** @var Connector */ private $connector; /** * @param array $options See \Monolog\Handler\PHPConsoleHandler::$options for more details * @param Connector|null $connector Instance of \PhpConsole\Connector class (optional) * @throws \RuntimeException */ public function __construct(array $options = [], ?Connector $connector = null, $level = Logger::DEBUG, bool $bubble = true) { if (!class_exists('PhpConsole\Connector')) { throw new \RuntimeException('PHP Console library not found. See https://github.com/barbushin/php-console#installation'); } parent::__construct($level, $bubble); $this->options = $this->initOptions($options); $this->connector = $this->initConnector($connector); } /** * @param array $options * * @return array */ private function initOptions(array $options): array { $wrongOptions = array_diff(array_keys($options), array_keys($this->options)); if ($wrongOptions) { throw new \RuntimeException('Unknown options: ' . implode(', ', $wrongOptions)); } return array_replace($this->options, $options); } private function initConnector(?Connector $connector = null): Connector { if (!$connector) { if ($this->options['dataStorage']) { Connector::setPostponeStorage($this->options['dataStorage']); } $connector = Connector::getInstance(); } if ($this->options['registerHelper'] && !Helper::isRegistered()) { Helper::register(); } if ($this->options['enabled'] && $connector->isActiveClient()) { if ($this->options['useOwnErrorsHandler'] || $this->options['useOwnExceptionsHandler']) { $handler = VendorPhpConsoleHandler::getInstance(); $handler->setHandleErrors($this->options['useOwnErrorsHandler']); $handler->setHandleExceptions($this->options['useOwnExceptionsHandler']); $handler->start(); } if ($this->options['sourcesBasePath']) { $connector->setSourcesBasePath($this->options['sourcesBasePath']); } if ($this->options['serverEncoding']) { $connector->setServerEncoding($this->options['serverEncoding']); } if ($this->options['password']) { $connector->setPassword($this->options['password']); } if ($this->options['enableSslOnlyMode']) { $connector->enableSslOnlyMode(); } if ($this->options['ipMasks']) { $connector->setAllowedIpMasks($this->options['ipMasks']); } if ($this->options['headersLimit']) { $connector->setHeadersLimit($this->options['headersLimit']); } if ($this->options['detectDumpTraceAndSource']) { $connector->getDebugDispatcher()->detectTraceAndSource = true; } $dumper = $connector->getDumper(); $dumper->levelLimit = $this->options['dumperLevelLimit']; $dumper->itemsCountLimit = $this->options['dumperItemsCountLimit']; $dumper->itemSizeLimit = $this->options['dumperItemSizeLimit']; $dumper->dumpSizeLimit = $this->options['dumperDumpSizeLimit']; $dumper->detectCallbacks = $this->options['dumperDetectCallbacks']; if ($this->options['enableEvalListener']) { $connector->startEvalRequestsListener(); } } return $connector; } public function getConnector(): Connector { return $this->connector; } /** * @return array */ public function getOptions(): array { return $this->options; } public function handle(array $record): bool { if ($this->options['enabled'] && $this->connector->isActiveClient()) { return parent::handle($record); } return !$this->bubble; } /** * Writes the record down to the log of the implementing handler */ protected function write(array $record): void { if ($record['level'] < Logger::NOTICE) { $this->handleDebugRecord($record); } elseif (isset($record['context']['exception']) && $record['context']['exception'] instanceof \Throwable) { $this->handleExceptionRecord($record); } else { $this->handleErrorRecord($record); } } /** * @phpstan-param Record $record */ private function handleDebugRecord(array $record): void { $tags = $this->getRecordTags($record); $message = $record['message']; if ($record['context']) { $message .= ' ' . Utils::jsonEncode($this->connector->getDumper()->dump(array_filter($record['context'])), null, true); } $this->connector->getDebugDispatcher()->dispatchDebug($message, $tags, $this->options['classesPartialsTraceIgnore']); } /** * @phpstan-param Record $record */ private function handleExceptionRecord(array $record): void { $this->connector->getErrorsDispatcher()->dispatchException($record['context']['exception']); } /** * @phpstan-param Record $record */ private function handleErrorRecord(array $record): void { $context = $record['context']; $this->connector->getErrorsDispatcher()->dispatchError( $context['code'] ?? null, $context['message'] ?? $record['message'], $context['file'] ?? null, $context['line'] ?? null, $this->options['classesPartialsTraceIgnore'] ); } /** * @phpstan-param Record $record * @return string */ private function getRecordTags(array &$record) { $tags = null; if (!empty($record['context'])) { $context = & $record['context']; foreach ($this->options['debugTagsKeysInContext'] as $key) { if (!empty($context[$key])) { $tags = $context[$key]; if ($key === 0) { array_shift($context); } else { unset($context[$key]); } break; } } } return $tags ?: strtolower($record['level_name']); } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new LineFormatter('%message%'); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\ResettableInterface; use Monolog\Formatter\FormatterInterface; use Psr\Log\LogLevel; /** * Simple handler wrapper that filters records based on a list of levels * * It can be configured with an exact list of levels to allow, or a min/max level. * * @author Hennadiy Verkh * @author Jordi Boggiano * * @phpstan-import-type Record from \Monolog\Logger * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger */ class FilterHandler extends Handler implements ProcessableHandlerInterface, ResettableInterface, FormattableHandlerInterface { use ProcessableHandlerTrait; /** * Handler or factory callable($record, $this) * * @var callable|HandlerInterface * @phpstan-var callable(?Record, HandlerInterface): HandlerInterface|HandlerInterface */ protected $handler; /** * Minimum level for logs that are passed to handler * * @var int[] * @phpstan-var array */ protected $acceptedLevels; /** * Whether the messages that are handled can bubble up the stack or not * * @var bool */ protected $bubble; /** * @psalm-param HandlerInterface|callable(?Record, HandlerInterface): HandlerInterface $handler * * @param callable|HandlerInterface $handler Handler or factory callable($record|null, $filterHandler). * @param int|array $minLevelOrList A list of levels to accept or a minimum level if maxLevel is provided * @param int|string $maxLevel Maximum level to accept, only used if $minLevelOrList is not an array * @param bool $bubble Whether the messages that are handled can bubble up the stack or not * * @phpstan-param Level|LevelName|LogLevel::*|array $minLevelOrList * @phpstan-param Level|LevelName|LogLevel::* $maxLevel */ public function __construct($handler, $minLevelOrList = Logger::DEBUG, $maxLevel = Logger::EMERGENCY, bool $bubble = true) { $this->handler = $handler; $this->bubble = $bubble; $this->setAcceptedLevels($minLevelOrList, $maxLevel); if (!$this->handler instanceof HandlerInterface && !is_callable($this->handler)) { throw new \RuntimeException("The given handler (".json_encode($this->handler).") is not a callable nor a Monolog\Handler\HandlerInterface object"); } } /** * @phpstan-return array */ public function getAcceptedLevels(): array { return array_flip($this->acceptedLevels); } /** * @param int|string|array $minLevelOrList A list of levels to accept or a minimum level or level name if maxLevel is provided * @param int|string $maxLevel Maximum level or level name to accept, only used if $minLevelOrList is not an array * * @phpstan-param Level|LevelName|LogLevel::*|array $minLevelOrList * @phpstan-param Level|LevelName|LogLevel::* $maxLevel */ public function setAcceptedLevels($minLevelOrList = Logger::DEBUG, $maxLevel = Logger::EMERGENCY): self { if (is_array($minLevelOrList)) { $acceptedLevels = array_map('Monolog\Logger::toMonologLevel', $minLevelOrList); } else { $minLevelOrList = Logger::toMonologLevel($minLevelOrList); $maxLevel = Logger::toMonologLevel($maxLevel); $acceptedLevels = array_values(array_filter(Logger::getLevels(), function ($level) use ($minLevelOrList, $maxLevel) { return $level >= $minLevelOrList && $level <= $maxLevel; })); } $this->acceptedLevels = array_flip($acceptedLevels); return $this; } /** * {@inheritDoc} */ public function isHandling(array $record): bool { return isset($this->acceptedLevels[$record['level']]); } /** * {@inheritDoc} */ public function handle(array $record): bool { if (!$this->isHandling($record)) { return false; } if ($this->processors) { /** @var Record $record */ $record = $this->processRecord($record); } $this->getHandler($record)->handle($record); return false === $this->bubble; } /** * {@inheritDoc} */ public function handleBatch(array $records): void { $filtered = []; foreach ($records as $record) { if ($this->isHandling($record)) { $filtered[] = $record; } } if (count($filtered) > 0) { $this->getHandler($filtered[count($filtered) - 1])->handleBatch($filtered); } } /** * Return the nested handler * * If the handler was provided as a factory callable, this will trigger the handler's instantiation. * * @return HandlerInterface * * @phpstan-param Record $record */ public function getHandler(array $record = null) { if (!$this->handler instanceof HandlerInterface) { $this->handler = ($this->handler)($record, $this); if (!$this->handler instanceof HandlerInterface) { throw new \RuntimeException("The factory callable should return a HandlerInterface"); } } return $this->handler; } /** * {@inheritDoc} */ public function setFormatter(FormatterInterface $formatter): HandlerInterface { $handler = $this->getHandler(); if ($handler instanceof FormattableHandlerInterface) { $handler->setFormatter($formatter); return $this; } throw new \UnexpectedValueException('The nested handler of type '.get_class($handler).' does not support formatters.'); } /** * {@inheritDoc} */ public function getFormatter(): FormatterInterface { $handler = $this->getHandler(); if ($handler instanceof FormattableHandlerInterface) { return $handler->getFormatter(); } throw new \UnexpectedValueException('The nested handler of type '.get_class($handler).' does not support formatters.'); } public function reset() { $this->resetProcessors(); if ($this->getHandler() instanceof ResettableInterface) { $this->getHandler()->reset(); } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\FormatterInterface; use Monolog\Logger; use Monolog\Utils; use Monolog\Handler\Slack\SlackRecord; /** * Sends notifications through Slack API * * @author Greg Kedzierski * @see https://api.slack.com/ * * @phpstan-import-type FormattedRecord from AbstractProcessingHandler */ class SlackHandler extends SocketHandler { /** * Slack API token * @var string */ private $token; /** * Instance of the SlackRecord util class preparing data for Slack API. * @var SlackRecord */ private $slackRecord; /** * @param string $token Slack API token * @param string $channel Slack channel (encoded ID or name) * @param string|null $username Name of a bot * @param bool $useAttachment Whether the message should be added to Slack as attachment (plain text otherwise) * @param string|null $iconEmoji The emoji name to use (or null) * @param bool $useShortAttachment Whether the context/extra messages added to Slack as attachments are in a short style * @param bool $includeContextAndExtra Whether the attachment should include context and extra data * @param string[] $excludeFields Dot separated list of fields to exclude from slack message. E.g. ['context.field1', 'extra.field2'] * @throws MissingExtensionException If no OpenSSL PHP extension configured */ public function __construct( string $token, string $channel, ?string $username = null, bool $useAttachment = true, ?string $iconEmoji = null, $level = Logger::CRITICAL, bool $bubble = true, bool $useShortAttachment = false, bool $includeContextAndExtra = false, array $excludeFields = array(), bool $persistent = false, float $timeout = 0.0, float $writingTimeout = 10.0, ?float $connectionTimeout = null, ?int $chunkSize = null ) { if (!extension_loaded('openssl')) { throw new MissingExtensionException('The OpenSSL PHP extension is required to use the SlackHandler'); } parent::__construct( 'ssl://slack.com:443', $level, $bubble, $persistent, $timeout, $writingTimeout, $connectionTimeout, $chunkSize ); $this->slackRecord = new SlackRecord( $channel, $username, $useAttachment, $iconEmoji, $useShortAttachment, $includeContextAndExtra, $excludeFields ); $this->token = $token; } public function getSlackRecord(): SlackRecord { return $this->slackRecord; } public function getToken(): string { return $this->token; } /** * {@inheritDoc} */ protected function generateDataStream(array $record): string { $content = $this->buildContent($record); return $this->buildHeader($content) . $content; } /** * Builds the body of API call * * @phpstan-param FormattedRecord $record */ private function buildContent(array $record): string { $dataArray = $this->prepareContentData($record); return http_build_query($dataArray); } /** * @phpstan-param FormattedRecord $record * @return string[] */ protected function prepareContentData(array $record): array { $dataArray = $this->slackRecord->getSlackData($record); $dataArray['token'] = $this->token; if (!empty($dataArray['attachments'])) { $dataArray['attachments'] = Utils::jsonEncode($dataArray['attachments']); } return $dataArray; } /** * Builds the header of the API Call */ private function buildHeader(string $content): string { $header = "POST /api/chat.postMessage HTTP/1.1\r\n"; $header .= "Host: slack.com\r\n"; $header .= "Content-Type: application/x-www-form-urlencoded\r\n"; $header .= "Content-Length: " . strlen($content) . "\r\n"; $header .= "\r\n"; return $header; } /** * {@inheritDoc} */ protected function write(array $record): void { parent::write($record); $this->finalizeWrite(); } /** * Finalizes the request by reading some bytes and then closing the socket * * If we do not read some but close the socket too early, slack sometimes * drops the request entirely. */ protected function finalizeWrite(): void { $res = $this->getResource(); if (is_resource($res)) { @fread($res, 2048); } $this->closeSocket(); } public function setFormatter(FormatterInterface $formatter): HandlerInterface { parent::setFormatter($formatter); $this->slackRecord->setFormatter($formatter); return $this; } public function getFormatter(): FormatterInterface { $formatter = parent::getFormatter(); $this->slackRecord->setFormatter($formatter); return $formatter; } /** * Channel used by the bot when posting */ public function setChannel(string $channel): self { $this->slackRecord->setChannel($channel); return $this; } /** * Username used by the bot when posting */ public function setUsername(string $username): self { $this->slackRecord->setUsername($username); return $this; } public function useAttachment(bool $useAttachment): self { $this->slackRecord->useAttachment($useAttachment); return $this; } public function setIconEmoji(string $iconEmoji): self { $this->slackRecord->setUserIcon($iconEmoji); return $this; } public function useShortAttachment(bool $useShortAttachment): self { $this->slackRecord->useShortAttachment($useShortAttachment); return $this; } public function includeContextAndExtra(bool $includeContextAndExtra): self { $this->slackRecord->includeContextAndExtra($includeContextAndExtra); return $this; } /** * @param string[] $excludeFields */ public function excludeFields(array $excludeFields): self { $this->slackRecord->excludeFields($excludeFields); return $this; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; /** * Stores to STDIN of any process, specified by a command. * * Usage example: * 
 * $log = new Logger('myLogger');
 * $log->pushHandler(new ProcessHandler('/usr/bin/php /var/www/monolog/someScript.php'));
 *
* * @author Kolja Zuelsdorf */ class ProcessHandler extends AbstractProcessingHandler { /** * Holds the process to receive data on its STDIN. * * @var resource|bool|null */ private $process; /** * @var string */ private $command; /** * @var string|null */ private $cwd; /** * @var resource[] */ private $pipes = []; /** * @var array */ protected const DESCRIPTOR_SPEC = [ 0 => ['pipe', 'r'], // STDIN is a pipe that the child will read from 1 => ['pipe', 'w'], // STDOUT is a pipe that the child will write to 2 => ['pipe', 'w'], // STDERR is a pipe to catch the any errors ]; /** * @param string $command Command for the process to start. Absolute paths are recommended, * especially if you do not use the $cwd parameter. * @param string|null $cwd "Current working directory" (CWD) for the process to be executed in. * @throws \InvalidArgumentException */ public function __construct(string $command, $level = Logger::DEBUG, bool $bubble = true, ?string $cwd = null) { if ($command === '') { throw new \InvalidArgumentException('The command argument must be a non-empty string.'); } if ($cwd === '') { throw new \InvalidArgumentException('The optional CWD argument must be a non-empty string or null.'); } parent::__construct($level, $bubble); $this->command = $command; $this->cwd = $cwd; } /** * Writes the record down to the log of the implementing handler * * @throws \UnexpectedValueException */ protected function write(array $record): void { $this->ensureProcessIsStarted(); $this->writeProcessInput($record['formatted']); $errors = $this->readProcessErrors(); if (empty($errors) === false) { throw new \UnexpectedValueException(sprintf('Errors while writing to process: %s', $errors)); } } /** * Makes sure that the process is actually started, and if not, starts it, * assigns the stream pipes, and handles startup errors, if any. */ private function ensureProcessIsStarted(): void { if (is_resource($this->process) === false) { $this->startProcess(); $this->handleStartupErrors(); } } /** * Starts the actual process and sets all streams to non-blocking. */ private function startProcess(): void { $this->process = proc_open($this->command, static::DESCRIPTOR_SPEC, $this->pipes, $this->cwd); foreach ($this->pipes as $pipe) { stream_set_blocking($pipe, false); } } /** * Selects the STDERR stream, handles upcoming startup errors, and throws an exception, if any. * * @throws \UnexpectedValueException */ private function handleStartupErrors(): void { $selected = $this->selectErrorStream(); if (false === $selected) { throw new \UnexpectedValueException('Something went wrong while selecting a stream.'); } $errors = $this->readProcessErrors(); if (is_resource($this->process) === false || empty($errors) === false) { throw new \UnexpectedValueException( sprintf('The process "%s" could not be opened: ' . $errors, $this->command) ); } } /** * Selects the STDERR stream. * * @return int|bool */ protected function selectErrorStream() { $empty = []; $errorPipes = [$this->pipes[2]]; return stream_select($errorPipes, $empty, $empty, 1); } /** * Reads the errors of the process, if there are any. * * @codeCoverageIgnore * @return string Empty string if there are no errors. */ protected function readProcessErrors(): string { return (string) stream_get_contents($this->pipes[2]); } /** * Writes to the input stream of the opened process. * * @codeCoverageIgnore */ protected function writeProcessInput(string $string): void { fwrite($this->pipes[0], $string); } /** * {@inheritDoc} */ public function close(): void { if (is_resource($this->process)) { foreach ($this->pipes as $pipe) { fclose($pipe); } proc_close($this->process); $this->process = null; } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\ChromePHPFormatter; use Monolog\Formatter\FormatterInterface; use Monolog\Logger; use Monolog\Utils; /** * Handler sending logs to the ChromePHP extension (http://www.chromephp.com/) * * This also works out of the box with Firefox 43+ * * @author Christophe Coevoet * * @phpstan-import-type Record from \Monolog\Logger */ class ChromePHPHandler extends AbstractProcessingHandler { use WebRequestRecognizerTrait; /** * Version of the extension */ protected const VERSION = '4.0'; /** * Header name */ protected const HEADER_NAME = 'X-ChromeLogger-Data'; /** * Regular expression to detect supported browsers (matches any Chrome, or Firefox 43+) */ protected const USER_AGENT_REGEX = '{\b(?:Chrome/\d+(?:\.\d+)*|HeadlessChrome|Firefox/(?:4[3-9]|[5-9]\d|\d{3,})(?:\.\d)*)\b}'; /** @var bool */ protected static $initialized = false; /** * Tracks whether we sent too much data * * Chrome limits the headers to 4KB, so when we sent 3KB we stop sending * * @var bool */ protected static $overflowed = false; /** @var mixed[] */ protected static $json = [ 'version' => self::VERSION, 'columns' => ['label', 'log', 'backtrace', 'type'], 'rows' => [], ]; /** @var bool */ protected static $sendHeaders = true; public function __construct($level = Logger::DEBUG, bool $bubble = true) { parent::__construct($level, $bubble); if (!function_exists('json_encode')) { throw new \RuntimeException('PHP\'s json extension is required to use Monolog\'s ChromePHPHandler'); } } /** * {@inheritDoc} */ public function handleBatch(array $records): void { if (!$this->isWebRequest()) { return; } $messages = []; foreach ($records as $record) { if ($record['level'] < $this->level) { continue; } /** @var Record $message */ $message = $this->processRecord($record); $messages[] = $message; } if (!empty($messages)) { $messages = $this->getFormatter()->formatBatch($messages); self::$json['rows'] = array_merge(self::$json['rows'], $messages); $this->send(); } } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new ChromePHPFormatter(); } /** * Creates & sends header for a record * * @see sendHeader() * @see send() */ protected function write(array $record): void { if (!$this->isWebRequest()) { return; } self::$json['rows'][] = $record['formatted']; $this->send(); } /** * Sends the log header * * @see sendHeader() */ protected function send(): void { if (self::$overflowed || !self::$sendHeaders) { return; } if (!self::$initialized) { self::$initialized = true; self::$sendHeaders = $this->headersAccepted(); if (!self::$sendHeaders) { return; } self::$json['request_uri'] = $_SERVER['REQUEST_URI'] ?? ''; } $json = Utils::jsonEncode(self::$json, Utils::DEFAULT_JSON_FLAGS & ~JSON_UNESCAPED_UNICODE, true); $data = base64_encode($json); if (strlen($data) > 3 * 1024) { self::$overflowed = true; $record = [ 'message' => 'Incomplete logs, chrome header size limit reached', 'context' => [], 'level' => Logger::WARNING, 'level_name' => Logger::getLevelName(Logger::WARNING), 'channel' => 'monolog', 'datetime' => new \DateTimeImmutable(), 'extra' => [], ]; self::$json['rows'][count(self::$json['rows']) - 1] = $this->getFormatter()->format($record); $json = Utils::jsonEncode(self::$json, Utils::DEFAULT_JSON_FLAGS & ~JSON_UNESCAPED_UNICODE, true); $data = base64_encode($json); } if (trim($data) !== '') { $this->sendHeader(static::HEADER_NAME, $data); } } /** * Send header string to the client */ protected function sendHeader(string $header, string $content): void { if (!headers_sent() && self::$sendHeaders) { header(sprintf('%s: %s', $header, $content)); } } /** * Verifies if the headers are accepted by the current user agent */ protected function headersAccepted(): bool { if (empty($_SERVER['HTTP_USER_AGENT'])) { return false; } return preg_match(static::USER_AGENT_REGEX, $_SERVER['HTTP_USER_AGENT']) === 1; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Utils; /** * Logs to Cube. * * @link https://github.com/square/cube/wiki * @author Wan Chen * @deprecated Since 2.8.0 and 3.2.0, Cube appears abandoned and thus we will drop this handler in Monolog 4 */ class CubeHandler extends AbstractProcessingHandler { /** @var resource|\Socket|null */ private $udpConnection = null; /** @var resource|\CurlHandle|null */ private $httpConnection = null; /** @var string */ private $scheme; /** @var string */ private $host; /** @var int */ private $port; /** @var string[] */ private $acceptedSchemes = ['http', 'udp']; /** * Create a Cube handler * * @throws \UnexpectedValueException when given url is not a valid url. * A valid url must consist of three parts : protocol://host:port * Only valid protocols used by Cube are http and udp */ public function __construct(string $url, $level = Logger::DEBUG, bool $bubble = true) { $urlInfo = parse_url($url); if ($urlInfo === false || !isset($urlInfo['scheme'], $urlInfo['host'], $urlInfo['port'])) { throw new \UnexpectedValueException('URL "'.$url.'" is not valid'); } if (!in_array($urlInfo['scheme'], $this->acceptedSchemes)) { throw new \UnexpectedValueException( 'Invalid protocol (' . $urlInfo['scheme'] . ').' . ' Valid options are ' . implode(', ', $this->acceptedSchemes) ); } $this->scheme = $urlInfo['scheme']; $this->host = $urlInfo['host']; $this->port = (int) $urlInfo['port']; parent::__construct($level, $bubble); } /** * Establish a connection to an UDP socket * * @throws \LogicException when unable to connect to the socket * @throws MissingExtensionException when there is no socket extension */ protected function connectUdp(): void { if (!extension_loaded('sockets')) { throw new MissingExtensionException('The sockets extension is required to use udp URLs with the CubeHandler'); } $udpConnection = socket_create(AF_INET, SOCK_DGRAM, 0); if (false === $udpConnection) { throw new \LogicException('Unable to create a socket'); } $this->udpConnection = $udpConnection; if (!socket_connect($this->udpConnection, $this->host, $this->port)) { throw new \LogicException('Unable to connect to the socket at ' . $this->host . ':' . $this->port); } } /** * Establish a connection to an http server * * @throws \LogicException when unable to connect to the socket * @throws MissingExtensionException when no curl extension */ protected function connectHttp(): void { if (!extension_loaded('curl')) { throw new MissingExtensionException('The curl extension is required to use http URLs with the CubeHandler'); } $httpConnection = curl_init('http://'.$this->host.':'.$this->port.'/1.0/event/put'); if (false === $httpConnection) { throw new \LogicException('Unable to connect to ' . $this->host . ':' . $this->port); } $this->httpConnection = $httpConnection; curl_setopt($this->httpConnection, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($this->httpConnection, CURLOPT_RETURNTRANSFER, true); } /** * {@inheritDoc} */ protected function write(array $record): void { $date = $record['datetime']; $data = ['time' => $date->format('Y-m-d\TH:i:s.uO')]; unset($record['datetime']); if (isset($record['context']['type'])) { $data['type'] = $record['context']['type']; unset($record['context']['type']); } else { $data['type'] = $record['channel']; } $data['data'] = $record['context']; $data['data']['level'] = $record['level']; if ($this->scheme === 'http') { $this->writeHttp(Utils::jsonEncode($data)); } else { $this->writeUdp(Utils::jsonEncode($data)); } } private function writeUdp(string $data): void { if (!$this->udpConnection) { $this->connectUdp(); } socket_send($this->udpConnection, $data, strlen($data), 0); } private function writeHttp(string $data): void { if (!$this->httpConnection) { $this->connectHttp(); } if (null === $this->httpConnection) { throw new \LogicException('No connection could be established'); } curl_setopt($this->httpConnection, CURLOPT_POSTFIELDS, '['.$data.']'); curl_setopt($this->httpConnection, CURLOPT_HTTPHEADER, [ 'Content-Type: application/json', 'Content-Length: ' . strlen('['.$data.']'), ]); Curl\Util::execute($this->httpConnection, 5, false); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\LineFormatter; use Monolog\Formatter\FormatterInterface; use Monolog\Logger; /** * Sends the message to a Redis Pub/Sub channel using PUBLISH * * usage example: * * $log = new Logger('application'); * $redis = new RedisPubSubHandler(new Predis\Client("tcp://localhost:6379"), "logs", Logger::WARNING); * $log->pushHandler($redis); * * @author Gaëtan Faugère */ class RedisPubSubHandler extends AbstractProcessingHandler { /** @var \Predis\Client<\Predis\Client>|\Redis */ private $redisClient; /** @var string */ private $channelKey; /** * @param \Predis\Client<\Predis\Client>|\Redis $redis The redis instance * @param string $key The channel key to publish records to */ public function __construct($redis, string $key, $level = Logger::DEBUG, bool $bubble = true) { if (!(($redis instanceof \Predis\Client) || ($redis instanceof \Redis))) { throw new \InvalidArgumentException('Predis\Client or Redis instance required'); } $this->redisClient = $redis; $this->channelKey = $key; parent::__construct($level, $bubble); } /** * {@inheritDoc} */ protected function write(array $record): void { $this->redisClient->publish($this->channelKey, $record["formatted"]); } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new LineFormatter(); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Throwable; /** * Forwards records to at most one handler * * If a handler fails, the exception is suppressed and the record is forwarded to the next handler. * * As soon as one handler handles a record successfully, the handling stops there. * * @phpstan-import-type Record from \Monolog\Logger */ class FallbackGroupHandler extends GroupHandler { /** * {@inheritDoc} */ public function handle(array $record): bool { if ($this->processors) { /** @var Record $record */ $record = $this->processRecord($record); } foreach ($this->handlers as $handler) { try { $handler->handle($record); break; } catch (Throwable $e) { // What throwable? } } return false === $this->bubble; } /** * {@inheritDoc} */ public function handleBatch(array $records): void { if ($this->processors) { $processed = []; foreach ($records as $record) { $processed[] = $this->processRecord($record); } /** @var Record[] $records */ $records = $processed; } foreach ($this->handlers as $handler) { try { $handler->handleBatch($records); break; } catch (Throwable $e) { // What throwable? } } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Monolog\Utils; use Monolog\Formatter\FormatterInterface; use Monolog\Formatter\LineFormatter; use Swift_Message; use Swift; /** * SwiftMailerHandler uses Swift_Mailer to send the emails * * @author Gyula Sallai * * @phpstan-import-type Record from \Monolog\Logger * @deprecated Since Monolog 2.6. Use SymfonyMailerHandler instead. */ class SwiftMailerHandler extends MailHandler { /** @var \Swift_Mailer */ protected $mailer; /** @var Swift_Message|callable(string, Record[]): Swift_Message */ private $messageTemplate; /** * @psalm-param Swift_Message|callable(string, Record[]): Swift_Message $message * * @param \Swift_Mailer $mailer The mailer to use * @param callable|Swift_Message $message An example message for real messages, only the body will be replaced */ public function __construct(\Swift_Mailer $mailer, $message, $level = Logger::ERROR, bool $bubble = true) { parent::__construct($level, $bubble); @trigger_error('The SwiftMailerHandler is deprecated since Monolog 2.6. Use SymfonyMailerHandler instead.', E_USER_DEPRECATED); $this->mailer = $mailer; $this->messageTemplate = $message; } /** * {@inheritDoc} */ protected function send(string $content, array $records): void { $this->mailer->send($this->buildMessage($content, $records)); } /** * Gets the formatter for the Swift_Message subject. * * @param string|null $format The format of the subject */ protected function getSubjectFormatter(?string $format): FormatterInterface { return new LineFormatter($format); } /** * Creates instance of Swift_Message to be sent * * @param string $content formatted email body to be sent * @param array $records Log records that formed the content * @return Swift_Message * * @phpstan-param Record[] $records */ protected function buildMessage(string $content, array $records): Swift_Message { $message = null; if ($this->messageTemplate instanceof Swift_Message) { $message = clone $this->messageTemplate; $message->generateId(); } elseif (is_callable($this->messageTemplate)) { $message = ($this->messageTemplate)($content, $records); } if (!$message instanceof Swift_Message) { $record = reset($records); throw new \InvalidArgumentException('Could not resolve message as instance of Swift_Message or a callable returning it' . ($record ? Utils::getRecordMessageForException($record) : '')); } if ($records) { $subjectFormatter = $this->getSubjectFormatter($message->getSubject()); $message->setSubject($subjectFormatter->format($this->getHighestRecord($records))); } $mime = 'text/plain'; if ($this->isHtmlBody($content)) { $mime = 'text/html'; } $message->setBody($content, $mime); /** @phpstan-ignore-next-line */ if (version_compare(Swift::VERSION, '6.0.0', '>=')) { $message->setDate(new \DateTimeImmutable()); } else { /** @phpstan-ignore-next-line */ $message->setDate(time()); } return $message; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Formatter\WildfireFormatter; use Monolog\Formatter\FormatterInterface; /** * Simple FirePHP Handler (http://www.firephp.org/), which uses the Wildfire protocol. * * @author Eric Clemmons (@ericclemmons) * * @phpstan-import-type FormattedRecord from AbstractProcessingHandler */ class FirePHPHandler extends AbstractProcessingHandler { use WebRequestRecognizerTrait; /** * WildFire JSON header message format */ protected const PROTOCOL_URI = 'http://meta.wildfirehq.org/Protocol/JsonStream/0.2'; /** * FirePHP structure for parsing messages & their presentation */ protected const STRUCTURE_URI = 'http://meta.firephp.org/Wildfire/Structure/FirePHP/FirebugConsole/0.1'; /** * Must reference a "known" plugin, otherwise headers won't display in FirePHP */ protected const PLUGIN_URI = 'http://meta.firephp.org/Wildfire/Plugin/FirePHP/Library-FirePHPCore/0.3'; /** * Header prefix for Wildfire to recognize & parse headers */ protected const HEADER_PREFIX = 'X-Wf'; /** * Whether or not Wildfire vendor-specific headers have been generated & sent yet * @var bool */ protected static $initialized = false; /** * Shared static message index between potentially multiple handlers * @var int */ protected static $messageIndex = 1; /** @var bool */ protected static $sendHeaders = true; /** * Base header creation function used by init headers & record headers * * @param array $meta Wildfire Plugin, Protocol & Structure Indexes * @param string $message Log message * * @return array Complete header string ready for the client as key and message as value * * @phpstan-return non-empty-array */ protected function createHeader(array $meta, string $message): array { $header = sprintf('%s-%s', static::HEADER_PREFIX, join('-', $meta)); return [$header => $message]; } /** * Creates message header from record * * @return array * * @phpstan-return non-empty-array * * @see createHeader() * * @phpstan-param FormattedRecord $record */ protected function createRecordHeader(array $record): array { // Wildfire is extensible to support multiple protocols & plugins in a single request, // but we're not taking advantage of that (yet), so we're using "1" for simplicity's sake. return $this->createHeader( [1, 1, 1, self::$messageIndex++], $record['formatted'] ); } /** * {@inheritDoc} */ protected function getDefaultFormatter(): FormatterInterface { return new WildfireFormatter(); } /** * Wildfire initialization headers to enable message parsing * * @see createHeader() * @see sendHeader() * * @return array */ protected function getInitHeaders(): array { // Initial payload consists of required headers for Wildfire return array_merge( $this->createHeader(['Protocol', 1], static::PROTOCOL_URI), $this->createHeader([1, 'Structure', 1], static::STRUCTURE_URI), $this->createHeader([1, 'Plugin', 1], static::PLUGIN_URI) ); } /** * Send header string to the client */ protected function sendHeader(string $header, string $content): void { if (!headers_sent() && self::$sendHeaders) { header(sprintf('%s: %s', $header, $content)); } } /** * Creates & sends header for a record, ensuring init headers have been sent prior * * @see sendHeader() * @see sendInitHeaders() */ protected function write(array $record): void { if (!self::$sendHeaders || !$this->isWebRequest()) { return; } // WildFire-specific headers must be sent prior to any messages if (!self::$initialized) { self::$initialized = true; self::$sendHeaders = $this->headersAccepted(); if (!self::$sendHeaders) { return; } foreach ($this->getInitHeaders() as $header => $content) { $this->sendHeader($header, $content); } } $header = $this->createRecordHeader($record); if (trim(current($header)) !== '') { $this->sendHeader(key($header), current($header)); } } /** * Verifies if the headers are accepted by the current user agent */ protected function headersAccepted(): bool { if (!empty($_SERVER['HTTP_USER_AGENT']) && preg_match('{\bFirePHP/\d+\.\d+\b}', $_SERVER['HTTP_USER_AGENT'])) { return true; } return isset($_SERVER['HTTP_X_FIREPHP_VERSION']); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Logger; use Swift; use Swift_Message; /** * MandrillHandler uses cURL to send the emails to the Mandrill API * * @author Adam Nicholson */ class MandrillHandler extends MailHandler { /** @var Swift_Message */ protected $message; /** @var string */ protected $apiKey; /** * @psalm-param Swift_Message|callable(): Swift_Message $message * * @param string $apiKey A valid Mandrill API key * @param callable|Swift_Message $message An example message for real messages, only the body will be replaced */ public function __construct(string $apiKey, $message, $level = Logger::ERROR, bool $bubble = true) { parent::__construct($level, $bubble); if (!$message instanceof Swift_Message && is_callable($message)) { $message = $message(); } if (!$message instanceof Swift_Message) { throw new \InvalidArgumentException('You must provide either a Swift_Message instance or a callable returning it'); } $this->message = $message; $this->apiKey = $apiKey; } /** * {@inheritDoc} */ protected function send(string $content, array $records): void { $mime = 'text/plain'; if ($this->isHtmlBody($content)) { $mime = 'text/html'; } $message = clone $this->message; $message->setBody($content, $mime); /** @phpstan-ignore-next-line */ if (version_compare(Swift::VERSION, '6.0.0', '>=')) { $message->setDate(new \DateTimeImmutable()); } else { /** @phpstan-ignore-next-line */ $message->setDate(time()); } $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, 'https://mandrillapp.com/api/1.0/messages/send-raw.json'); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([ 'key' => $this->apiKey, 'raw_message' => (string) $message, 'async' => false, ])); Curl\Util::execute($ch); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog; use DateTimeZone; /** * Overrides default json encoding of date time objects * * @author Menno Holtkamp * @author Jordi Boggiano */ class DateTimeImmutable extends \DateTimeImmutable implements \JsonSerializable { /** * @var bool */ private $useMicroseconds; public function __construct(bool $useMicroseconds, ?DateTimeZone $timezone = null) { $this->useMicroseconds = $useMicroseconds; parent::__construct('now', $timezone); } public function jsonSerialize(): string { if ($this->useMicroseconds) { return $this->format('Y-m-d\TH:i:s.uP'); } return $this->format('Y-m-d\TH:i:sP'); } public function __toString(): string { return $this->jsonSerialize(); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Test; use Monolog\Logger; use Monolog\DateTimeImmutable; use Monolog\Formatter\FormatterInterface; /** * Lets you easily generate log records and a dummy formatter for testing purposes * * @author Jordi Boggiano * * @phpstan-import-type Record from \Monolog\Logger * @phpstan-import-type Level from \Monolog\Logger * * @internal feel free to reuse this to test your own handlers, this is marked internal to avoid issues with PHPStorm https://github.com/Seldaek/monolog/issues/1677 */ class TestCase extends \PHPUnit\Framework\TestCase { public function tearDown(): void { parent::tearDown(); if (isset($this->handler)) { unset($this->handler); } } /** * @param mixed[] $context * * @return array Record * * @phpstan-param Level $level * @phpstan-return Record */ protected function getRecord(int $level = Logger::WARNING, string $message = 'test', array $context = []): array { return [ 'message' => (string) $message, 'context' => $context, 'level' => $level, 'level_name' => Logger::getLevelName($level), 'channel' => 'test', 'datetime' => new DateTimeImmutable(true), 'extra' => [], ]; } /** * @phpstan-return Record[] */ protected function getMultipleRecords(): array { return [ $this->getRecord(Logger::DEBUG, 'debug message 1'), $this->getRecord(Logger::DEBUG, 'debug message 2'), $this->getRecord(Logger::INFO, 'information'), $this->getRecord(Logger::WARNING, 'warning'), $this->getRecord(Logger::ERROR, 'error'), ]; } protected function getIdentityFormatter(): FormatterInterface { $formatter = $this->createMock(FormatterInterface::class); $formatter->expects($this->any()) ->method('format') ->will($this->returnCallback(function ($record) { return $record['message']; })); return $formatter; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog; use Psr\Log\LoggerInterface; use Psr\Log\LogLevel; /** * Monolog error handler * * A facility to enable logging of runtime errors, exceptions and fatal errors. * * Quick setup: ErrorHandler::register($logger); * * @author Jordi Boggiano */ class ErrorHandler { /** @var LoggerInterface */ private $logger; /** @var ?callable */ private $previousExceptionHandler = null; /** @var array an array of class name to LogLevel::* constant mapping */ private $uncaughtExceptionLevelMap = []; /** @var callable|true|null */ private $previousErrorHandler = null; /** @var array an array of E_* constant to LogLevel::* constant mapping */ private $errorLevelMap = []; /** @var bool */ private $handleOnlyReportedErrors = true; /** @var bool */ private $hasFatalErrorHandler = false; /** @var LogLevel::* */ private $fatalLevel = LogLevel::ALERT; /** @var ?string */ private $reservedMemory = null; /** @var ?array{type: int, message: string, file: string, line: int, trace: mixed} */ private $lastFatalData = null; /** @var int[] */ private static $fatalErrors = [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR]; public function __construct(LoggerInterface $logger) { $this->logger = $logger; } /** * Registers a new ErrorHandler for a given Logger * * By default it will handle errors, exceptions and fatal errors * * @param LoggerInterface $logger * @param array|false $errorLevelMap an array of E_* constant to LogLevel::* constant mapping, or false to disable error handling * @param array|false $exceptionLevelMap an array of class name to LogLevel::* constant mapping, or false to disable exception handling * @param LogLevel::*|null|false $fatalLevel a LogLevel::* constant, null to use the default LogLevel::ALERT or false to disable fatal error handling * @return ErrorHandler */ public static function register(LoggerInterface $logger, $errorLevelMap = [], $exceptionLevelMap = [], $fatalLevel = null): self { /** @phpstan-ignore-next-line */ $handler = new static($logger); if ($errorLevelMap !== false) { $handler->registerErrorHandler($errorLevelMap); } if ($exceptionLevelMap !== false) { $handler->registerExceptionHandler($exceptionLevelMap); } if ($fatalLevel !== false) { $handler->registerFatalHandler($fatalLevel); } return $handler; } /** * @param array $levelMap an array of class name to LogLevel::* constant mapping * @return $this */ public function registerExceptionHandler(array $levelMap = [], bool $callPrevious = true): self { $prev = set_exception_handler(function (\Throwable $e): void { $this->handleException($e); }); $this->uncaughtExceptionLevelMap = $levelMap; foreach ($this->defaultExceptionLevelMap() as $class => $level) { if (!isset($this->uncaughtExceptionLevelMap[$class])) { $this->uncaughtExceptionLevelMap[$class] = $level; } } if ($callPrevious && $prev) { $this->previousExceptionHandler = $prev; } return $this; } /** * @param array $levelMap an array of E_* constant to LogLevel::* constant mapping * @return $this */ public function registerErrorHandler(array $levelMap = [], bool $callPrevious = true, int $errorTypes = -1, bool $handleOnlyReportedErrors = true): self { $prev = set_error_handler([$this, 'handleError'], $errorTypes); $this->errorLevelMap = array_replace($this->defaultErrorLevelMap(), $levelMap); if ($callPrevious) { $this->previousErrorHandler = $prev ?: true; } else { $this->previousErrorHandler = null; } $this->handleOnlyReportedErrors = $handleOnlyReportedErrors; return $this; } /** * @param LogLevel::*|null $level a LogLevel::* constant, null to use the default LogLevel::ALERT * @param int $reservedMemorySize Amount of KBs to reserve in memory so that it can be freed when handling fatal errors giving Monolog some room in memory to get its job done */ public function registerFatalHandler($level = null, int $reservedMemorySize = 20): self { register_shutdown_function([$this, 'handleFatalError']); $this->reservedMemory = str_repeat(' ', 1024 * $reservedMemorySize); $this->fatalLevel = null === $level ? LogLevel::ALERT : $level; $this->hasFatalErrorHandler = true; return $this; } /** * @return array */ protected function defaultExceptionLevelMap(): array { return [ 'ParseError' => LogLevel::CRITICAL, 'Throwable' => LogLevel::ERROR, ]; } /** * @return array */ protected function defaultErrorLevelMap(): array { return [ E_ERROR => LogLevel::CRITICAL, E_WARNING => LogLevel::WARNING, E_PARSE => LogLevel::ALERT, E_NOTICE => LogLevel::NOTICE, E_CORE_ERROR => LogLevel::CRITICAL, E_CORE_WARNING => LogLevel::WARNING, E_COMPILE_ERROR => LogLevel::ALERT, E_COMPILE_WARNING => LogLevel::WARNING, E_USER_ERROR => LogLevel::ERROR, E_USER_WARNING => LogLevel::WARNING, E_USER_NOTICE => LogLevel::NOTICE, E_STRICT => LogLevel::NOTICE, E_RECOVERABLE_ERROR => LogLevel::ERROR, E_DEPRECATED => LogLevel::NOTICE, E_USER_DEPRECATED => LogLevel::NOTICE, ]; } /** * @phpstan-return never */ private function handleException(\Throwable $e): void { $level = LogLevel::ERROR; foreach ($this->uncaughtExceptionLevelMap as $class => $candidate) { if ($e instanceof $class) { $level = $candidate; break; } } $this->logger->log( $level, sprintf('Uncaught Exception %s: "%s" at %s line %s', Utils::getClass($e), $e->getMessage(), $e->getFile(), $e->getLine()), ['exception' => $e] ); if ($this->previousExceptionHandler) { ($this->previousExceptionHandler)($e); } if (!headers_sent() && !ini_get('display_errors')) { http_response_code(500); } exit(255); } /** * @private * * @param mixed[] $context */ public function handleError(int $code, string $message, string $file = '', int $line = 0, ?array $context = []): bool { if ($this->handleOnlyReportedErrors && !(error_reporting() & $code)) { return false; } // fatal error codes are ignored if a fatal error handler is present as well to avoid duplicate log entries if (!$this->hasFatalErrorHandler || !in_array($code, self::$fatalErrors, true)) { $level = $this->errorLevelMap[$code] ?? LogLevel::CRITICAL; $this->logger->log($level, self::codeToString($code).': '.$message, ['code' => $code, 'message' => $message, 'file' => $file, 'line' => $line]); } else { $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS); array_shift($trace); // Exclude handleError from trace $this->lastFatalData = ['type' => $code, 'message' => $message, 'file' => $file, 'line' => $line, 'trace' => $trace]; } if ($this->previousErrorHandler === true) { return false; } elseif ($this->previousErrorHandler) { return (bool) ($this->previousErrorHandler)($code, $message, $file, $line, $context); } return true; } /** * @private */ public function handleFatalError(): void { $this->reservedMemory = ''; if (is_array($this->lastFatalData)) { $lastError = $this->lastFatalData; } else { $lastError = error_get_last(); } if ($lastError && in_array($lastError['type'], self::$fatalErrors, true)) { $trace = $lastError['trace'] ?? null; $this->logger->log( $this->fatalLevel, 'Fatal Error ('.self::codeToString($lastError['type']).'): '.$lastError['message'], ['code' => $lastError['type'], 'message' => $lastError['message'], 'file' => $lastError['file'], 'line' => $lastError['line'], 'trace' => $trace] ); if ($this->logger instanceof Logger) { foreach ($this->logger->getHandlers() as $handler) { $handler->close(); } } } } /** * @param int $code */ private static function codeToString($code): string { switch ($code) { case E_ERROR: return 'E_ERROR'; case E_WARNING: return 'E_WARNING'; case E_PARSE: return 'E_PARSE'; case E_NOTICE: return 'E_NOTICE'; case E_CORE_ERROR: return 'E_CORE_ERROR'; case E_CORE_WARNING: return 'E_CORE_WARNING'; case E_COMPILE_ERROR: return 'E_COMPILE_ERROR'; case E_COMPILE_WARNING: return 'E_COMPILE_WARNING'; case E_USER_ERROR: return 'E_USER_ERROR'; case E_USER_WARNING: return 'E_USER_WARNING'; case E_USER_NOTICE: return 'E_USER_NOTICE'; case E_STRICT: return 'E_STRICT'; case E_RECOVERABLE_ERROR: return 'E_RECOVERABLE_ERROR'; case E_DEPRECATED: return 'E_DEPRECATED'; case E_USER_DEPRECATED: return 'E_USER_DEPRECATED'; } return 'Unknown PHP error'; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; /** * Adds a tags array into record * * @author Martijn Riemers */ class TagProcessor implements ProcessorInterface { /** @var string[] */ private $tags; /** * @param string[] $tags */ public function __construct(array $tags = []) { $this->setTags($tags); } /** * @param string[] $tags */ public function addTags(array $tags = []): self { $this->tags = array_merge($this->tags, $tags); return $this; } /** * @param string[] $tags */ public function setTags(array $tags = []): self { $this->tags = $tags; return $this; } /** * {@inheritDoc} */ public function __invoke(array $record): array { $record['extra']['tags'] = $this->tags; return $record; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; use Monolog\Logger; use Psr\Log\LogLevel; /** * Injects Git branch and Git commit SHA in all records * * @author Nick Otter * @author Jordi Boggiano * * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger */ class GitProcessor implements ProcessorInterface { /** @var int */ private $level; /** @var array{branch: string, commit: string}|array|null */ private static $cache = null; /** * @param string|int $level The minimum logging level at which this Processor will be triggered * * @phpstan-param Level|LevelName|LogLevel::* $level */ public function __construct($level = Logger::DEBUG) { $this->level = Logger::toMonologLevel($level); } /** * {@inheritDoc} */ public function __invoke(array $record): array { // return if the level is not high enough if ($record['level'] < $this->level) { return $record; } $record['extra']['git'] = self::getGitInfo(); return $record; } /** * @return array{branch: string, commit: string}|array */ private static function getGitInfo(): array { if (self::$cache) { return self::$cache; } $branches = `git branch -v --no-abbrev`; if ($branches && preg_match('{^\* (.+?)\s+([a-f0-9]{40})(?:\s|$)}m', $branches, $matches)) { return self::$cache = [ 'branch' => $matches[1], 'commit' => $matches[2], ]; } return self::$cache = []; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; /** * Injects value of gethostname in all records */ class HostnameProcessor implements ProcessorInterface { /** @var string */ private static $host; public function __construct() { self::$host = (string) gethostname(); } /** * {@inheritDoc} */ public function __invoke(array $record): array { $record['extra']['hostname'] = self::$host; return $record; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; use Monolog\Utils; /** * Processes a record's message according to PSR-3 rules * * It replaces {foo} with the value from $context['foo'] * * @author Jordi Boggiano */ class PsrLogMessageProcessor implements ProcessorInterface { public const SIMPLE_DATE = "Y-m-d\TH:i:s.uP"; /** @var string|null */ private $dateFormat; /** @var bool */ private $removeUsedContextFields; /** * @param string|null $dateFormat The format of the timestamp: one supported by DateTime::format * @param bool $removeUsedContextFields If set to true the fields interpolated into message gets unset */ public function __construct(?string $dateFormat = null, bool $removeUsedContextFields = false) { $this->dateFormat = $dateFormat; $this->removeUsedContextFields = $removeUsedContextFields; } /** * {@inheritDoc} */ public function __invoke(array $record): array { if (false === strpos($record['message'], '{')) { return $record; } $replacements = []; foreach ($record['context'] as $key => $val) { $placeholder = '{' . $key . '}'; if (strpos($record['message'], $placeholder) === false) { continue; } if (is_null($val) || is_scalar($val) || (is_object($val) && method_exists($val, "__toString"))) { $replacements[$placeholder] = $val; } elseif ($val instanceof \DateTimeInterface) { if (!$this->dateFormat && $val instanceof \Monolog\DateTimeImmutable) { // handle monolog dates using __toString if no specific dateFormat was asked for // so that it follows the useMicroseconds flag $replacements[$placeholder] = (string) $val; } else { $replacements[$placeholder] = $val->format($this->dateFormat ?: static::SIMPLE_DATE); } } elseif (is_object($val)) { $replacements[$placeholder] = '[object '.Utils::getClass($val).']'; } elseif (is_array($val)) { $replacements[$placeholder] = 'array'.Utils::jsonEncode($val, null, true); } else { $replacements[$placeholder] = '['.gettype($val).']'; } if ($this->removeUsedContextFields) { unset($record['context'][$key]); } } $record['message'] = strtr($record['message'], $replacements); return $record; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; use Monolog\Logger; use Psr\Log\LogLevel; /** * Injects line/file:class/function where the log message came from * * Warning: This only works if the handler processes the logs directly. * If you put the processor on a handler that is behind a FingersCrossedHandler * for example, the processor will only be called once the trigger level is reached, * and all the log records will have the same file/line/.. data from the call that * triggered the FingersCrossedHandler. * * @author Jordi Boggiano * * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger */ class IntrospectionProcessor implements ProcessorInterface { /** @var int */ private $level; /** @var string[] */ private $skipClassesPartials; /** @var int */ private $skipStackFramesCount; /** @var string[] */ private $skipFunctions = [ 'call_user_func', 'call_user_func_array', ]; /** * @param string|int $level The minimum logging level at which this Processor will be triggered * @param string[] $skipClassesPartials * * @phpstan-param Level|LevelName|LogLevel::* $level */ public function __construct($level = Logger::DEBUG, array $skipClassesPartials = [], int $skipStackFramesCount = 0) { $this->level = Logger::toMonologLevel($level); $this->skipClassesPartials = array_merge(['Monolog\\'], $skipClassesPartials); $this->skipStackFramesCount = $skipStackFramesCount; } /** * {@inheritDoc} */ public function __invoke(array $record): array { // return if the level is not high enough if ($record['level'] < $this->level) { return $record; } $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS); // skip first since it's always the current method array_shift($trace); // the call_user_func call is also skipped array_shift($trace); $i = 0; while ($this->isTraceClassOrSkippedFunction($trace, $i)) { if (isset($trace[$i]['class'])) { foreach ($this->skipClassesPartials as $part) { if (strpos($trace[$i]['class'], $part) !== false) { $i++; continue 2; } } } elseif (in_array($trace[$i]['function'], $this->skipFunctions)) { $i++; continue; } break; } $i += $this->skipStackFramesCount; // we should have the call source now $record['extra'] = array_merge( $record['extra'], [ 'file' => isset($trace[$i - 1]['file']) ? $trace[$i - 1]['file'] : null, 'line' => isset($trace[$i - 1]['line']) ? $trace[$i - 1]['line'] : null, 'class' => isset($trace[$i]['class']) ? $trace[$i]['class'] : null, 'callType' => isset($trace[$i]['type']) ? $trace[$i]['type'] : null, 'function' => isset($trace[$i]['function']) ? $trace[$i]['function'] : null, ] ); return $record; } /** * @param array[] $trace */ private function isTraceClassOrSkippedFunction(array $trace, int $index): bool { if (!isset($trace[$index])) { return false; } return isset($trace[$index]['class']) || in_array($trace[$index]['function'], $this->skipFunctions); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; use Monolog\ResettableInterface; /** * Adds a unique identifier into records * * @author Simon Mönch */ class UidProcessor implements ProcessorInterface, ResettableInterface { /** @var string */ private $uid; public function __construct(int $length = 7) { if ($length > 32 || $length < 1) { throw new \InvalidArgumentException('The uid length must be an integer between 1 and 32'); } $this->uid = $this->generateUid($length); } /** * {@inheritDoc} */ public function __invoke(array $record): array { $record['extra']['uid'] = $this->uid; return $record; } public function getUid(): string { return $this->uid; } public function reset() { $this->uid = $this->generateUid(strlen($this->uid)); } private function generateUid(int $length): string { return substr(bin2hex(random_bytes((int) ceil($length / 2))), 0, $length); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; /** * Injects memory_get_usage in all records * * @see Monolog\Processor\MemoryProcessor::__construct() for options * @author Rob Jensen */ class MemoryUsageProcessor extends MemoryProcessor { /** * {@inheritDoc} */ public function __invoke(array $record): array { $usage = memory_get_usage($this->realUsage); if ($this->useFormatting) { $usage = $this->formatBytes($usage); } $record['extra']['memory_usage'] = $usage; return $record; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; /** * Injects memory_get_peak_usage in all records * * @see Monolog\Processor\MemoryProcessor::__construct() for options * @author Rob Jensen */ class MemoryPeakUsageProcessor extends MemoryProcessor { /** * {@inheritDoc} */ public function __invoke(array $record): array { $usage = memory_get_peak_usage($this->realUsage); if ($this->useFormatting) { $usage = $this->formatBytes($usage); } $record['extra']['memory_peak_usage'] = $usage; return $record; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; /** * Injects url/method and remote IP of the current web request in all records * * @author Jordi Boggiano */ class WebProcessor implements ProcessorInterface { /** * @var array|\ArrayAccess */ protected $serverData; /** * Default fields * * Array is structured as [key in record.extra => key in $serverData] * * @var array */ protected $extraFields = [ 'url' => 'REQUEST_URI', 'ip' => 'REMOTE_ADDR', 'http_method' => 'REQUEST_METHOD', 'server' => 'SERVER_NAME', 'referrer' => 'HTTP_REFERER', 'user_agent' => 'HTTP_USER_AGENT', ]; /** * @param array|\ArrayAccess|null $serverData Array or object w/ ArrayAccess that provides access to the $_SERVER data * @param array|array|null $extraFields Field names and the related key inside $serverData to be added (or just a list of field names to use the default configured $serverData mapping). If not provided it defaults to: [url, ip, http_method, server, referrer] + unique_id if present in server data */ public function __construct($serverData = null, array $extraFields = null) { if (null === $serverData) { $this->serverData = &$_SERVER; } elseif (is_array($serverData) || $serverData instanceof \ArrayAccess) { $this->serverData = $serverData; } else { throw new \UnexpectedValueException('$serverData must be an array or object implementing ArrayAccess.'); } $defaultEnabled = ['url', 'ip', 'http_method', 'server', 'referrer']; if (isset($this->serverData['UNIQUE_ID'])) { $this->extraFields['unique_id'] = 'UNIQUE_ID'; $defaultEnabled[] = 'unique_id'; } if (null === $extraFields) { $extraFields = $defaultEnabled; } if (isset($extraFields[0])) { foreach (array_keys($this->extraFields) as $fieldName) { if (!in_array($fieldName, $extraFields)) { unset($this->extraFields[$fieldName]); } } } else { $this->extraFields = $extraFields; } } /** * {@inheritDoc} */ public function __invoke(array $record): array { // skip processing if for some reason request data // is not present (CLI or wonky SAPIs) if (!isset($this->serverData['REQUEST_URI'])) { return $record; } $record['extra'] = $this->appendExtraFields($record['extra']); return $record; } public function addExtraField(string $extraName, string $serverName): self { $this->extraFields[$extraName] = $serverName; return $this; } /** * @param mixed[] $extra * @return mixed[] */ private function appendExtraFields(array $extra): array { foreach ($this->extraFields as $extraName => $serverName) { $extra[$extraName] = $this->serverData[$serverName] ?? null; } return $extra; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; /** * Some methods that are common for all memory processors * * @author Rob Jensen */ abstract class MemoryProcessor implements ProcessorInterface { /** * @var bool If true, get the real size of memory allocated from system. Else, only the memory used by emalloc() is reported. */ protected $realUsage; /** * @var bool If true, then format memory size to human readable string (MB, KB, B depending on size) */ protected $useFormatting; /** * @param bool $realUsage Set this to true to get the real size of memory allocated from system. * @param bool $useFormatting If true, then format memory size to human readable string (MB, KB, B depending on size) */ public function __construct(bool $realUsage = true, bool $useFormatting = true) { $this->realUsage = $realUsage; $this->useFormatting = $useFormatting; } /** * Formats bytes into a human readable string if $this->useFormatting is true, otherwise return $bytes as is * * @param int $bytes * @return string|int Formatted string if $this->useFormatting is true, otherwise return $bytes as int */ protected function formatBytes(int $bytes) { if (!$this->useFormatting) { return $bytes; } if ($bytes > 1024 * 1024) { return round($bytes / 1024 / 1024, 2).' MB'; } elseif ($bytes > 1024) { return round($bytes / 1024, 2).' KB'; } return $bytes . ' B'; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; use Monolog\Logger; use Psr\Log\LogLevel; /** * Injects Hg branch and Hg revision number in all records * * @author Jonathan A. Schweder * * @phpstan-import-type LevelName from \Monolog\Logger * @phpstan-import-type Level from \Monolog\Logger */ class MercurialProcessor implements ProcessorInterface { /** @var Level */ private $level; /** @var array{branch: string, revision: string}|array|null */ private static $cache = null; /** * @param int|string $level The minimum logging level at which this Processor will be triggered * * @phpstan-param Level|LevelName|LogLevel::* $level */ public function __construct($level = Logger::DEBUG) { $this->level = Logger::toMonologLevel($level); } /** * {@inheritDoc} */ public function __invoke(array $record): array { // return if the level is not high enough if ($record['level'] < $this->level) { return $record; } $record['extra']['hg'] = self::getMercurialInfo(); return $record; } /** * @return array{branch: string, revision: string}|array */ private static function getMercurialInfo(): array { if (self::$cache) { return self::$cache; } $result = explode(' ', trim(`hg id -nb`)); if (count($result) >= 3) { return self::$cache = [ 'branch' => $result[1], 'revision' => $result[2], ]; } return self::$cache = []; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; /** * An optional interface to allow labelling Monolog processors. * * @author Nicolas Grekas * * @phpstan-import-type Record from \Monolog\Logger */ interface ProcessorInterface { /** * @return array The processed record * * @phpstan-param Record $record * @phpstan-return Record */ public function __invoke(array $record); } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Processor; /** * Adds value of getmypid into records * * @author Andreas Hörnicke */ class ProcessIdProcessor implements ProcessorInterface { /** * {@inheritDoc} */ public function __invoke(array $record): array { $record['extra']['process_id'] = getmypid(); return $record; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Attribute; /** * A reusable attribute to help configure a class or a method as a processor. * * Using it offers no guarantee: it needs to be leveraged by a Monolog third-party consumer. * * Using it with the Monolog library only has no effect at all: processors should still be turned into a callable if * needed and manually pushed to the loggers and to the processable handlers. */ #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)] class AsMonologProcessor { /** @var string|null */ public $channel = null; /** @var string|null */ public $handler = null; /** @var string|null */ public $method = null; /** * @param string|null $channel The logging channel the processor should be pushed to. * @param string|null $handler The handler the processor should be pushed to. * @param string|null $method The method that processes the records (if the attribute is used at the class level). */ public function __construct( ?string $channel = null, ?string $handler = null, ?string $method = null ) { $this->channel = $channel; $this->handler = $handler; $this->method = $method; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use Monolog\Logger; use Monolog\Utils; /** * Formats incoming records into an HTML table * * This is especially useful for html email logging * * @author Tiago Brito */ class HtmlFormatter extends NormalizerFormatter { /** * Translates Monolog log levels to html color priorities. * * @var array */ protected $logLevels = [ Logger::DEBUG => '#CCCCCC', Logger::INFO => '#28A745', Logger::NOTICE => '#17A2B8', Logger::WARNING => '#FFC107', Logger::ERROR => '#FD7E14', Logger::CRITICAL => '#DC3545', Logger::ALERT => '#821722', Logger::EMERGENCY => '#000000', ]; /** * @param string|null $dateFormat The format of the timestamp: one supported by DateTime::format */ public function __construct(?string $dateFormat = null) { parent::__construct($dateFormat); } /** * Creates an HTML table row * * @param string $th Row header content * @param string $td Row standard cell content * @param bool $escapeTd false if td content must not be html escaped */ protected function addRow(string $th, string $td = ' ', bool $escapeTd = true): string { $th = htmlspecialchars($th, ENT_NOQUOTES, 'UTF-8'); if ($escapeTd) { $td = '
'.htmlspecialchars($td, ENT_NOQUOTES, 'UTF-8').'
'; } return "\n$th:\n".$td."\n"; } /** * Create a HTML h1 tag * * @param string $title Text to be in the h1 * @param int $level Error level * @return string */ protected function addTitle(string $title, int $level): string { $title = htmlspecialchars($title, ENT_NOQUOTES, 'UTF-8'); return '

'.$title.'

'; } /** * Formats a log record. * * @return string The formatted record */ public function format(array $record): string { $output = $this->addTitle($record['level_name'], $record['level']); $output .= ''; $output .= $this->addRow('Message', (string) $record['message']); $output .= $this->addRow('Time', $this->formatDate($record['datetime'])); $output .= $this->addRow('Channel', $record['channel']); if ($record['context']) { $embeddedTable = '
'; foreach ($record['context'] as $key => $value) { $embeddedTable .= $this->addRow((string) $key, $this->convertToString($value)); } $embeddedTable .= '
'; $output .= $this->addRow('Context', $embeddedTable, false); } if ($record['extra']) { $embeddedTable = ''; foreach ($record['extra'] as $key => $value) { $embeddedTable .= $this->addRow((string) $key, $this->convertToString($value)); } $embeddedTable .= '
'; $output .= $this->addRow('Extra', $embeddedTable, false); } return $output.''; } /** * Formats a set of log records. * * @return string The formatted set of records */ public function formatBatch(array $records): string { $message = ''; foreach ($records as $record) { $message .= $this->format($record); } return $message; } /** * @param mixed $data */ protected function convertToString($data): string { if (null === $data || is_scalar($data)) { return (string) $data; } $data = $this->normalize($data); return Utils::jsonEncode($data, JSON_PRETTY_PRINT | Utils::DEFAULT_JSON_FLAGS, true); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use Monolog\Logger; /** * Formats a log message according to the ChromePHP array format * * @author Christophe Coevoet */ class ChromePHPFormatter implements FormatterInterface { /** * Translates Monolog log levels to Wildfire levels. * * @var array */ private $logLevels = [ Logger::DEBUG => 'log', Logger::INFO => 'info', Logger::NOTICE => 'info', Logger::WARNING => 'warn', Logger::ERROR => 'error', Logger::CRITICAL => 'error', Logger::ALERT => 'error', Logger::EMERGENCY => 'error', ]; /** * {@inheritDoc} */ public function format(array $record) { // Retrieve the line and file if set and remove them from the formatted extra $backtrace = 'unknown'; if (isset($record['extra']['file'], $record['extra']['line'])) { $backtrace = $record['extra']['file'].' : '.$record['extra']['line']; unset($record['extra']['file'], $record['extra']['line']); } $message = ['message' => $record['message']]; if ($record['context']) { $message['context'] = $record['context']; } if ($record['extra']) { $message['extra'] = $record['extra']; } if (count($message) === 1) { $message = reset($message); } return [ $record['channel'], $message, $backtrace, $this->logLevels[$record['level']], ]; } /** * {@inheritDoc} */ public function formatBatch(array $records) { $formatted = []; foreach ($records as $record) { $formatted[] = $this->format($record); } return $formatted; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; /** * Interface for formatters * * @author Jordi Boggiano * * @phpstan-import-type Record from \Monolog\Logger */ interface FormatterInterface { /** * Formats a log record. * * @param array $record A record to format * @return mixed The formatted record * * @phpstan-param Record $record */ public function format(array $record); /** * Formats a set of log records. * * @param array $records A set of records to format * @return mixed The formatted set of records * * @phpstan-param Record[] $records */ public function formatBatch(array $records); } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; /** * Formats data into an associative array of scalar values. * Objects and arrays will be JSON encoded. * * @author Andrew Lawson */ class ScalarFormatter extends NormalizerFormatter { /** * {@inheritDoc} * * @phpstan-return array $record */ public function format(array $record): array { $result = []; foreach ($record as $key => $value) { $result[$key] = $this->normalizeValue($value); } return $result; } /** * @param mixed $value * @return scalar|null */ protected function normalizeValue($value) { $normalized = $this->normalize($value); if (is_array($normalized)) { return $this->toJson($normalized, true); } return $normalized; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use Throwable; /** * Encodes whatever record data is passed to it as json * * This can be useful to log to databases or remote APIs * * @author Jordi Boggiano * * @phpstan-import-type Record from \Monolog\Logger */ class JsonFormatter extends NormalizerFormatter { public const BATCH_MODE_JSON = 1; public const BATCH_MODE_NEWLINES = 2; /** @var self::BATCH_MODE_* */ protected $batchMode; /** @var bool */ protected $appendNewline; /** @var bool */ protected $ignoreEmptyContextAndExtra; /** @var bool */ protected $includeStacktraces = false; /** * @param self::BATCH_MODE_* $batchMode */ public function __construct(int $batchMode = self::BATCH_MODE_JSON, bool $appendNewline = true, bool $ignoreEmptyContextAndExtra = false, bool $includeStacktraces = false) { $this->batchMode = $batchMode; $this->appendNewline = $appendNewline; $this->ignoreEmptyContextAndExtra = $ignoreEmptyContextAndExtra; $this->includeStacktraces = $includeStacktraces; parent::__construct(); } /** * The batch mode option configures the formatting style for * multiple records. By default, multiple records will be * formatted as a JSON-encoded array. However, for * compatibility with some API endpoints, alternative styles * are available. */ public function getBatchMode(): int { return $this->batchMode; } /** * True if newlines are appended to every formatted record */ public function isAppendingNewlines(): bool { return $this->appendNewline; } /** * {@inheritDoc} */ public function format(array $record): string { $normalized = $this->normalize($record); if (isset($normalized['context']) && $normalized['context'] === []) { if ($this->ignoreEmptyContextAndExtra) { unset($normalized['context']); } else { $normalized['context'] = new \stdClass; } } if (isset($normalized['extra']) && $normalized['extra'] === []) { if ($this->ignoreEmptyContextAndExtra) { unset($normalized['extra']); } else { $normalized['extra'] = new \stdClass; } } return $this->toJson($normalized, true) . ($this->appendNewline ? "\n" : ''); } /** * {@inheritDoc} */ public function formatBatch(array $records): string { switch ($this->batchMode) { case static::BATCH_MODE_NEWLINES: return $this->formatBatchNewlines($records); case static::BATCH_MODE_JSON: default: return $this->formatBatchJson($records); } } /** * @return self */ public function includeStacktraces(bool $include = true): self { $this->includeStacktraces = $include; return $this; } /** * Return a JSON-encoded array of records. * * @phpstan-param Record[] $records */ protected function formatBatchJson(array $records): string { return $this->toJson($this->normalize($records), true); } /** * Use new lines to separate records instead of a * JSON-encoded array. * * @phpstan-param Record[] $records */ protected function formatBatchNewlines(array $records): string { $instance = $this; $oldNewline = $this->appendNewline; $this->appendNewline = false; array_walk($records, function (&$value, $key) use ($instance) { $value = $instance->format($value); }); $this->appendNewline = $oldNewline; return implode("\n", $records); } /** * Normalizes given $data. * * @param mixed $data * * @return mixed */ protected function normalize($data, int $depth = 0) { if ($depth > $this->maxNormalizeDepth) { return 'Over '.$this->maxNormalizeDepth.' levels deep, aborting normalization'; } if (is_array($data)) { $normalized = []; $count = 1; foreach ($data as $key => $value) { if ($count++ > $this->maxNormalizeItemCount) { $normalized['...'] = 'Over '.$this->maxNormalizeItemCount.' items ('.count($data).' total), aborting normalization'; break; } $normalized[$key] = $this->normalize($value, $depth + 1); } return $normalized; } if (is_object($data)) { if ($data instanceof \DateTimeInterface) { return $this->formatDate($data); } if ($data instanceof Throwable) { return $this->normalizeException($data, $depth); } // if the object has specific json serializability we want to make sure we skip the __toString treatment below if ($data instanceof \JsonSerializable) { return $data; } if (method_exists($data, '__toString')) { return $data->__toString(); } return $data; } if (is_resource($data)) { return parent::normalize($data); } return $data; } /** * Normalizes given exception with or without its own stack trace based on * `includeStacktraces` property. * * {@inheritDoc} */ protected function normalizeException(Throwable $e, int $depth = 0): array { $data = parent::normalizeException($e, $depth); if (!$this->includeStacktraces) { unset($data['trace']); } return $data; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use Monolog\Logger; /** * Serializes a log message according to Wildfire's header requirements * * @author Eric Clemmons (@ericclemmons) * @author Christophe Coevoet * @author Kirill chEbba Chebunin * * @phpstan-import-type Level from \Monolog\Logger */ class WildfireFormatter extends NormalizerFormatter { /** * Translates Monolog log levels to Wildfire levels. * * @var array */ private $logLevels = [ Logger::DEBUG => 'LOG', Logger::INFO => 'INFO', Logger::NOTICE => 'INFO', Logger::WARNING => 'WARN', Logger::ERROR => 'ERROR', Logger::CRITICAL => 'ERROR', Logger::ALERT => 'ERROR', Logger::EMERGENCY => 'ERROR', ]; /** * @param string|null $dateFormat The format of the timestamp: one supported by DateTime::format */ public function __construct(?string $dateFormat = null) { parent::__construct($dateFormat); // http headers do not like non-ISO-8559-1 characters $this->removeJsonEncodeOption(JSON_UNESCAPED_UNICODE); } /** * {@inheritDoc} * * @return string */ public function format(array $record): string { // Retrieve the line and file if set and remove them from the formatted extra $file = $line = ''; if (isset($record['extra']['file'])) { $file = $record['extra']['file']; unset($record['extra']['file']); } if (isset($record['extra']['line'])) { $line = $record['extra']['line']; unset($record['extra']['line']); } /** @var mixed[] $record */ $record = $this->normalize($record); $message = ['message' => $record['message']]; $handleError = false; if ($record['context']) { $message['context'] = $record['context']; $handleError = true; } if ($record['extra']) { $message['extra'] = $record['extra']; $handleError = true; } if (count($message) === 1) { $message = reset($message); } if (isset($record['context']['table'])) { $type = 'TABLE'; $label = $record['channel'] .': '. $record['message']; $message = $record['context']['table']; } else { $type = $this->logLevels[$record['level']]; $label = $record['channel']; } // Create JSON object describing the appearance of the message in the console $json = $this->toJson([ [ 'Type' => $type, 'File' => $file, 'Line' => $line, 'Label' => $label, ], $message, ], $handleError); // The message itself is a serialization of the above JSON object + it's length return sprintf( '%d|%s|', strlen($json), $json ); } /** * {@inheritDoc} * * @phpstan-return never */ public function formatBatch(array $records) { throw new \BadMethodCallException('Batch formatting does not make sense for the WildfireFormatter'); } /** * {@inheritDoc} * * @return null|scalar|array|object */ protected function normalize($data, int $depth = 0) { if (is_object($data) && !$data instanceof \DateTimeInterface) { return $data; } return parent::normalize($data, $depth); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use Monolog\Logger; use Gelf\Message; use Monolog\Utils; /** * Serializes a log message to GELF * @see http://docs.graylog.org/en/latest/pages/gelf.html * * @author Matt Lehner * * @phpstan-import-type Level from \Monolog\Logger */ class GelfMessageFormatter extends NormalizerFormatter { protected const DEFAULT_MAX_LENGTH = 32766; /** * @var string the name of the system for the Gelf log message */ protected $systemName; /** * @var string a prefix for 'extra' fields from the Monolog record (optional) */ protected $extraPrefix; /** * @var string a prefix for 'context' fields from the Monolog record (optional) */ protected $contextPrefix; /** * @var int max length per field */ protected $maxLength; /** * Translates Monolog log levels to Graylog2 log priorities. * * @var array * * @phpstan-var array */ private $logLevels = [ Logger::DEBUG => 7, Logger::INFO => 6, Logger::NOTICE => 5, Logger::WARNING => 4, Logger::ERROR => 3, Logger::CRITICAL => 2, Logger::ALERT => 1, Logger::EMERGENCY => 0, ]; public function __construct(?string $systemName = null, ?string $extraPrefix = null, string $contextPrefix = 'ctxt_', ?int $maxLength = null) { if (!class_exists(Message::class)) { throw new \RuntimeException('Composer package graylog2/gelf-php is required to use Monolog\'s GelfMessageFormatter'); } parent::__construct('U.u'); $this->systemName = (is_null($systemName) || $systemName === '') ? (string) gethostname() : $systemName; $this->extraPrefix = is_null($extraPrefix) ? '' : $extraPrefix; $this->contextPrefix = $contextPrefix; $this->maxLength = is_null($maxLength) ? self::DEFAULT_MAX_LENGTH : $maxLength; } /** * {@inheritDoc} */ public function format(array $record): Message { $context = $extra = []; if (isset($record['context'])) { /** @var mixed[] $context */ $context = parent::normalize($record['context']); } if (isset($record['extra'])) { /** @var mixed[] $extra */ $extra = parent::normalize($record['extra']); } if (!isset($record['datetime'], $record['message'], $record['level'])) { throw new \InvalidArgumentException('The record should at least contain datetime, message and level keys, '.var_export($record, true).' given'); } $message = new Message(); $message ->setTimestamp($record['datetime']) ->setShortMessage((string) $record['message']) ->setHost($this->systemName) ->setLevel($this->logLevels[$record['level']]); // message length + system name length + 200 for padding / metadata $len = 200 + strlen((string) $record['message']) + strlen($this->systemName); if ($len > $this->maxLength) { $message->setShortMessage(Utils::substr($record['message'], 0, $this->maxLength)); } if (isset($record['channel'])) { $message->setFacility($record['channel']); } if (isset($extra['line'])) { $message->setLine($extra['line']); unset($extra['line']); } if (isset($extra['file'])) { $message->setFile($extra['file']); unset($extra['file']); } foreach ($extra as $key => $val) { $val = is_scalar($val) || null === $val ? $val : $this->toJson($val); $len = strlen($this->extraPrefix . $key . $val); if ($len > $this->maxLength) { $message->setAdditional($this->extraPrefix . $key, Utils::substr((string) $val, 0, $this->maxLength)); continue; } $message->setAdditional($this->extraPrefix . $key, $val); } foreach ($context as $key => $val) { $val = is_scalar($val) || null === $val ? $val : $this->toJson($val); $len = strlen($this->contextPrefix . $key . $val); if ($len > $this->maxLength) { $message->setAdditional($this->contextPrefix . $key, Utils::substr((string) $val, 0, $this->maxLength)); continue; } $message->setAdditional($this->contextPrefix . $key, $val); } /** @phpstan-ignore-next-line */ if (null === $message->getFile() && isset($context['exception']['file'])) { if (preg_match("/^(.+):([0-9]+)$/", $context['exception']['file'], $matches)) { $message->setFile($matches[1]); $message->setLine($matches[2]); } } return $message; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; /** * Encodes message information into JSON in a format compatible with Loggly. * * @author Adam Pancutt */ class LogglyFormatter extends JsonFormatter { /** * Overrides the default batch mode to new lines for compatibility with the * Loggly bulk API. */ public function __construct(int $batchMode = self::BATCH_MODE_NEWLINES, bool $appendNewline = false) { parent::__construct($batchMode, $appendNewline); } /** * Appends the 'timestamp' parameter for indexing by Loggly. * * @see https://www.loggly.com/docs/automated-parsing/#json * @see \Monolog\Formatter\JsonFormatter::format() */ public function format(array $record): string { if (isset($record["datetime"]) && ($record["datetime"] instanceof \DateTimeInterface)) { $record["timestamp"] = $record["datetime"]->format("Y-m-d\TH:i:s.uO"); unset($record["datetime"]); } return parent::format($record); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use DateTimeInterface; use Monolog\LogRecord; /** * Encodes message information into JSON in a format compatible with Cloud logging. * * @see https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry * * @author Luís Cobucci */ final class GoogleCloudLoggingFormatter extends JsonFormatter { /** {@inheritdoc} **/ public function format(array $record): string { // Re-key level for GCP logging $record['severity'] = $record['level_name']; $record['timestamp'] = $record['datetime']->format(DateTimeInterface::RFC3339_EXTENDED); // Remove keys that are not used by GCP unset($record['level'], $record['level_name'], $record['datetime']); return parent::format($record); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use Monolog\Utils; /** * Formats incoming records into a one-line string * * This is especially useful for logging to files * * @author Jordi Boggiano * @author Christophe Coevoet */ class LineFormatter extends NormalizerFormatter { public const SIMPLE_FORMAT = "[%datetime%] %channel%.%level_name%: %message% %context% %extra%\n"; /** @var string */ protected $format; /** @var bool */ protected $allowInlineLineBreaks; /** @var bool */ protected $ignoreEmptyContextAndExtra; /** @var bool */ protected $includeStacktraces; /** @var ?callable */ protected $stacktracesParser; /** * @param string|null $format The format of the message * @param string|null $dateFormat The format of the timestamp: one supported by DateTime::format * @param bool $allowInlineLineBreaks Whether to allow inline line breaks in log entries * @param bool $ignoreEmptyContextAndExtra */ public function __construct(?string $format = null, ?string $dateFormat = null, bool $allowInlineLineBreaks = false, bool $ignoreEmptyContextAndExtra = false, bool $includeStacktraces = false) { $this->format = $format === null ? static::SIMPLE_FORMAT : $format; $this->allowInlineLineBreaks = $allowInlineLineBreaks; $this->ignoreEmptyContextAndExtra = $ignoreEmptyContextAndExtra; $this->includeStacktraces($includeStacktraces); parent::__construct($dateFormat); } public function includeStacktraces(bool $include = true, ?callable $parser = null): self { $this->includeStacktraces = $include; if ($this->includeStacktraces) { $this->allowInlineLineBreaks = true; $this->stacktracesParser = $parser; } return $this; } public function allowInlineLineBreaks(bool $allow = true): self { $this->allowInlineLineBreaks = $allow; return $this; } public function ignoreEmptyContextAndExtra(bool $ignore = true): self { $this->ignoreEmptyContextAndExtra = $ignore; return $this; } /** * {@inheritDoc} */ public function format(array $record): string { $vars = parent::format($record); $output = $this->format; foreach ($vars['extra'] as $var => $val) { if (false !== strpos($output, '%extra.'.$var.'%')) { $output = str_replace('%extra.'.$var.'%', $this->stringify($val), $output); unset($vars['extra'][$var]); } } foreach ($vars['context'] as $var => $val) { if (false !== strpos($output, '%context.'.$var.'%')) { $output = str_replace('%context.'.$var.'%', $this->stringify($val), $output); unset($vars['context'][$var]); } } if ($this->ignoreEmptyContextAndExtra) { if (empty($vars['context'])) { unset($vars['context']); $output = str_replace('%context%', '', $output); } if (empty($vars['extra'])) { unset($vars['extra']); $output = str_replace('%extra%', '', $output); } } foreach ($vars as $var => $val) { if (false !== strpos($output, '%'.$var.'%')) { $output = str_replace('%'.$var.'%', $this->stringify($val), $output); } } // remove leftover %extra.xxx% and %context.xxx% if any if (false !== strpos($output, '%')) { $output = preg_replace('/%(?:extra|context)\..+?%/', '', $output); if (null === $output) { $pcreErrorCode = preg_last_error(); throw new \RuntimeException('Failed to run preg_replace: ' . $pcreErrorCode . ' / ' . Utils::pcreLastErrorMessage($pcreErrorCode)); } } return $output; } public function formatBatch(array $records): string { $message = ''; foreach ($records as $record) { $message .= $this->format($record); } return $message; } /** * @param mixed $value */ public function stringify($value): string { return $this->replaceNewlines($this->convertToString($value)); } protected function normalizeException(\Throwable $e, int $depth = 0): string { $str = $this->formatException($e); if ($previous = $e->getPrevious()) { do { $depth++; if ($depth > $this->maxNormalizeDepth) { $str .= '\n[previous exception] Over ' . $this->maxNormalizeDepth . ' levels deep, aborting normalization'; break; } $str .= "\n[previous exception] " . $this->formatException($previous); } while ($previous = $previous->getPrevious()); } return $str; } /** * @param mixed $data */ protected function convertToString($data): string { if (null === $data || is_bool($data)) { return var_export($data, true); } if (is_scalar($data)) { return (string) $data; } return $this->toJson($data, true); } protected function replaceNewlines(string $str): string { if ($this->allowInlineLineBreaks) { if (0 === strpos($str, '{')) { $str = preg_replace('/(?getCode(); if ($e instanceof \SoapFault) { if (isset($e->faultcode)) { $str .= ' faultcode: ' . $e->faultcode; } if (isset($e->faultactor)) { $str .= ' faultactor: ' . $e->faultactor; } if (isset($e->detail)) { if (is_string($e->detail)) { $str .= ' detail: ' . $e->detail; } elseif (is_object($e->detail) || is_array($e->detail)) { $str .= ' detail: ' . $this->toJson($e->detail, true); } } } $str .= '): ' . $e->getMessage() . ' at ' . $e->getFile() . ':' . $e->getLine() . ')'; if ($this->includeStacktraces) { $str .= $this->stacktracesParser($e); } return $str; } private function stacktracesParser(\Throwable $e): string { $trace = $e->getTraceAsString(); if ($this->stacktracesParser) { $trace = $this->stacktracesParserCustom($trace); } return "\n[stacktrace]\n" . $trace . "\n"; } private function stacktracesParserCustom(string $trace): string { return implode("\n", array_filter(array_map($this->stacktracesParser, explode("\n", $trace)))); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; /** * Encodes message information into JSON in a format compatible with Logmatic. * * @author Julien Breux */ class LogmaticFormatter extends JsonFormatter { protected const MARKERS = ["sourcecode", "php"]; /** * @var string */ protected $hostname = ''; /** * @var string */ protected $appname = ''; public function setHostname(string $hostname): self { $this->hostname = $hostname; return $this; } public function setAppname(string $appname): self { $this->appname = $appname; return $this; } /** * Appends the 'hostname' and 'appname' parameter for indexing by Logmatic. * * @see http://doc.logmatic.io/docs/basics-to-send-data * @see \Monolog\Formatter\JsonFormatter::format() */ public function format(array $record): string { if (!empty($this->hostname)) { $record["hostname"] = $this->hostname; } if (!empty($this->appname)) { $record["appname"] = $this->appname; } $record["@marker"] = static::MARKERS; return parent::format($record); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use Monolog\DateTimeImmutable; use Monolog\Utils; use Throwable; /** * Normalizes incoming records to remove objects/resources so it's easier to dump to various targets * * @author Jordi Boggiano */ class NormalizerFormatter implements FormatterInterface { public const SIMPLE_DATE = "Y-m-d\TH:i:sP"; /** @var string */ protected $dateFormat; /** @var int */ protected $maxNormalizeDepth = 9; /** @var int */ protected $maxNormalizeItemCount = 1000; /** @var int */ private $jsonEncodeOptions = Utils::DEFAULT_JSON_FLAGS; /** * @param string|null $dateFormat The format of the timestamp: one supported by DateTime::format */ public function __construct(?string $dateFormat = null) { $this->dateFormat = null === $dateFormat ? static::SIMPLE_DATE : $dateFormat; if (!function_exists('json_encode')) { throw new \RuntimeException('PHP\'s json extension is required to use Monolog\'s NormalizerFormatter'); } } /** * {@inheritDoc} * * @param mixed[] $record */ public function format(array $record) { return $this->normalize($record); } /** * {@inheritDoc} */ public function formatBatch(array $records) { foreach ($records as $key => $record) { $records[$key] = $this->format($record); } return $records; } public function getDateFormat(): string { return $this->dateFormat; } public function setDateFormat(string $dateFormat): self { $this->dateFormat = $dateFormat; return $this; } /** * The maximum number of normalization levels to go through */ public function getMaxNormalizeDepth(): int { return $this->maxNormalizeDepth; } public function setMaxNormalizeDepth(int $maxNormalizeDepth): self { $this->maxNormalizeDepth = $maxNormalizeDepth; return $this; } /** * The maximum number of items to normalize per level */ public function getMaxNormalizeItemCount(): int { return $this->maxNormalizeItemCount; } public function setMaxNormalizeItemCount(int $maxNormalizeItemCount): self { $this->maxNormalizeItemCount = $maxNormalizeItemCount; return $this; } /** * Enables `json_encode` pretty print. */ public function setJsonPrettyPrint(bool $enable): self { if ($enable) { $this->jsonEncodeOptions |= JSON_PRETTY_PRINT; } else { $this->jsonEncodeOptions &= ~JSON_PRETTY_PRINT; } return $this; } /** * @param mixed $data * @return null|scalar|array */ protected function normalize($data, int $depth = 0) { if ($depth > $this->maxNormalizeDepth) { return 'Over ' . $this->maxNormalizeDepth . ' levels deep, aborting normalization'; } if (null === $data || is_scalar($data)) { if (is_float($data)) { if (is_infinite($data)) { return ($data > 0 ? '' : '-') . 'INF'; } if (is_nan($data)) { return 'NaN'; } } return $data; } if (is_array($data)) { $normalized = []; $count = 1; foreach ($data as $key => $value) { if ($count++ > $this->maxNormalizeItemCount) { $normalized['...'] = 'Over ' . $this->maxNormalizeItemCount . ' items ('.count($data).' total), aborting normalization'; break; } $normalized[$key] = $this->normalize($value, $depth + 1); } return $normalized; } if ($data instanceof \DateTimeInterface) { return $this->formatDate($data); } if (is_object($data)) { if ($data instanceof Throwable) { return $this->normalizeException($data, $depth); } if ($data instanceof \JsonSerializable) { /** @var null|scalar|array $value */ $value = $data->jsonSerialize(); } elseif (method_exists($data, '__toString')) { /** @var string $value */ $value = $data->__toString(); } else { // the rest is normalized by json encoding and decoding it /** @var null|scalar|array $value */ $value = json_decode($this->toJson($data, true), true); } return [Utils::getClass($data) => $value]; } if (is_resource($data)) { return sprintf('[resource(%s)]', get_resource_type($data)); } return '[unknown('.gettype($data).')]'; } /** * @return mixed[] */ protected function normalizeException(Throwable $e, int $depth = 0) { if ($depth > $this->maxNormalizeDepth) { return ['Over ' . $this->maxNormalizeDepth . ' levels deep, aborting normalization']; } if ($e instanceof \JsonSerializable) { return (array) $e->jsonSerialize(); } $data = [ 'class' => Utils::getClass($e), 'message' => $e->getMessage(), 'code' => (int) $e->getCode(), 'file' => $e->getFile().':'.$e->getLine(), ]; if ($e instanceof \SoapFault) { if (isset($e->faultcode)) { $data['faultcode'] = $e->faultcode; } if (isset($e->faultactor)) { $data['faultactor'] = $e->faultactor; } if (isset($e->detail)) { if (is_string($e->detail)) { $data['detail'] = $e->detail; } elseif (is_object($e->detail) || is_array($e->detail)) { $data['detail'] = $this->toJson($e->detail, true); } } } $trace = $e->getTrace(); foreach ($trace as $frame) { if (isset($frame['file'])) { $data['trace'][] = $frame['file'].':'.$frame['line']; } } if ($previous = $e->getPrevious()) { $data['previous'] = $this->normalizeException($previous, $depth + 1); } return $data; } /** * Return the JSON representation of a value * * @param mixed $data * @throws \RuntimeException if encoding fails and errors are not ignored * @return string if encoding fails and ignoreErrors is true 'null' is returned */ protected function toJson($data, bool $ignoreErrors = false): string { return Utils::jsonEncode($data, $this->jsonEncodeOptions, $ignoreErrors); } /** * @return string */ protected function formatDate(\DateTimeInterface $date) { // in case the date format isn't custom then we defer to the custom DateTimeImmutable // formatting logic, which will pick the right format based on whether useMicroseconds is on if ($this->dateFormat === self::SIMPLE_DATE && $date instanceof DateTimeImmutable) { return (string) $date; } return $date->format($this->dateFormat); } public function addJsonEncodeOption(int $option): self { $this->jsonEncodeOptions |= $option; return $this; } public function removeJsonEncodeOption(int $option): self { $this->jsonEncodeOptions &= ~$option; return $this; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use MongoDB\BSON\Type; use MongoDB\BSON\UTCDateTime; use Monolog\Utils; /** * Formats a record for use with the MongoDBHandler. * * @author Florian Plattner */ class MongoDBFormatter implements FormatterInterface { /** @var bool */ private $exceptionTraceAsString; /** @var int */ private $maxNestingLevel; /** @var bool */ private $isLegacyMongoExt; /** * @param int $maxNestingLevel 0 means infinite nesting, the $record itself is level 1, $record['context'] is 2 * @param bool $exceptionTraceAsString set to false to log exception traces as a sub documents instead of strings */ public function __construct(int $maxNestingLevel = 3, bool $exceptionTraceAsString = true) { $this->maxNestingLevel = max($maxNestingLevel, 0); $this->exceptionTraceAsString = $exceptionTraceAsString; $this->isLegacyMongoExt = extension_loaded('mongodb') && version_compare((string) phpversion('mongodb'), '1.1.9', '<='); } /** * {@inheritDoc} * * @return mixed[] */ public function format(array $record): array { /** @var mixed[] $res */ $res = $this->formatArray($record); return $res; } /** * {@inheritDoc} * * @return array */ public function formatBatch(array $records): array { $formatted = []; foreach ($records as $key => $record) { $formatted[$key] = $this->format($record); } return $formatted; } /** * @param mixed[] $array * @return mixed[]|string Array except when max nesting level is reached then a string "[...]" */ protected function formatArray(array $array, int $nestingLevel = 0) { if ($this->maxNestingLevel > 0 && $nestingLevel > $this->maxNestingLevel) { return '[...]'; } foreach ($array as $name => $value) { if ($value instanceof \DateTimeInterface) { $array[$name] = $this->formatDate($value, $nestingLevel + 1); } elseif ($value instanceof \Throwable) { $array[$name] = $this->formatException($value, $nestingLevel + 1); } elseif (is_array($value)) { $array[$name] = $this->formatArray($value, $nestingLevel + 1); } elseif (is_object($value) && !$value instanceof Type) { $array[$name] = $this->formatObject($value, $nestingLevel + 1); } } return $array; } /** * @param mixed $value * @return mixed[]|string */ protected function formatObject($value, int $nestingLevel) { $objectVars = get_object_vars($value); $objectVars['class'] = Utils::getClass($value); return $this->formatArray($objectVars, $nestingLevel); } /** * @return mixed[]|string */ protected function formatException(\Throwable $exception, int $nestingLevel) { $formattedException = [ 'class' => Utils::getClass($exception), 'message' => $exception->getMessage(), 'code' => (int) $exception->getCode(), 'file' => $exception->getFile() . ':' . $exception->getLine(), ]; if ($this->exceptionTraceAsString === true) { $formattedException['trace'] = $exception->getTraceAsString(); } else { $formattedException['trace'] = $exception->getTrace(); } return $this->formatArray($formattedException, $nestingLevel); } protected function formatDate(\DateTimeInterface $value, int $nestingLevel): UTCDateTime { if ($this->isLegacyMongoExt) { return $this->legacyGetMongoDbDateTime($value); } return $this->getMongoDbDateTime($value); } private function getMongoDbDateTime(\DateTimeInterface $value): UTCDateTime { return new UTCDateTime((int) floor(((float) $value->format('U.u')) * 1000)); } /** * This is needed to support MongoDB Driver v1.19 and below * * See https://github.com/mongodb/mongo-php-driver/issues/426 * * It can probably be removed in 2.1 or later once MongoDB's 1.2 is released and widely adopted */ private function legacyGetMongoDbDateTime(\DateTimeInterface $value): UTCDateTime { $milliseconds = floor(((float) $value->format('U.u')) * 1000); $milliseconds = (PHP_INT_SIZE == 8) //64-bit OS? ? (int) $milliseconds : (string) $milliseconds; // @phpstan-ignore-next-line return new UTCDateTime($milliseconds); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use Monolog\Utils; /** * Class FluentdFormatter * * Serializes a log message to Fluentd unix socket protocol * * Fluentd config: * * * type unix * path /var/run/td-agent/td-agent.sock * * * Monolog setup: * * $logger = new Monolog\Logger('fluent.tag'); * $fluentHandler = new Monolog\Handler\SocketHandler('unix:///var/run/td-agent/td-agent.sock'); * $fluentHandler->setFormatter(new Monolog\Formatter\FluentdFormatter()); * $logger->pushHandler($fluentHandler); * * @author Andrius Putna */ class FluentdFormatter implements FormatterInterface { /** * @var bool $levelTag should message level be a part of the fluentd tag */ protected $levelTag = false; public function __construct(bool $levelTag = false) { if (!function_exists('json_encode')) { throw new \RuntimeException('PHP\'s json extension is required to use Monolog\'s FluentdUnixFormatter'); } $this->levelTag = $levelTag; } public function isUsingLevelsInTag(): bool { return $this->levelTag; } public function format(array $record): string { $tag = $record['channel']; if ($this->levelTag) { $tag .= '.' . strtolower($record['level_name']); } $message = [ 'message' => $record['message'], 'context' => $record['context'], 'extra' => $record['extra'], ]; if (!$this->levelTag) { $message['level'] = $record['level']; $message['level_name'] = $record['level_name']; } return Utils::jsonEncode([$tag, $record['datetime']->getTimestamp(), $message]); } public function formatBatch(array $records): string { $message = ''; foreach ($records as $record) { $message .= $this->format($record); } return $message; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; /** * formats the record to be used in the FlowdockHandler * * @author Dominik Liebler */ class FlowdockFormatter implements FormatterInterface { /** * @var string */ private $source; /** * @var string */ private $sourceEmail; public function __construct(string $source, string $sourceEmail) { $this->source = $source; $this->sourceEmail = $sourceEmail; } /** * {@inheritDoc} * * @return mixed[] */ public function format(array $record): array { $tags = [ '#logs', '#' . strtolower($record['level_name']), '#' . $record['channel'], ]; foreach ($record['extra'] as $value) { $tags[] = '#' . $value; } $subject = sprintf( 'in %s: %s - %s', $this->source, $record['level_name'], $this->getShortMessage($record['message']) ); $record['flowdock'] = [ 'source' => $this->source, 'from_address' => $this->sourceEmail, 'subject' => $subject, 'content' => $record['message'], 'tags' => $tags, 'project' => $this->source, ]; return $record; } /** * {@inheritDoc} * * @return mixed[][] */ public function formatBatch(array $records): array { $formatted = []; foreach ($records as $record) { $formatted[] = $this->format($record); } return $formatted; } public function getShortMessage(string $message): string { static $hasMbString; if (null === $hasMbString) { $hasMbString = function_exists('mb_strlen'); } $maxLength = 45; if ($hasMbString) { if (mb_strlen($message, 'UTF-8') > $maxLength) { $message = mb_substr($message, 0, $maxLength - 4, 'UTF-8') . ' ...'; } } else { if (strlen($message) > $maxLength) { $message = substr($message, 0, $maxLength - 4) . ' ...'; } } return $message; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; /** * Serializes a log message to Logstash Event Format * * @see https://www.elastic.co/products/logstash * @see https://github.com/elastic/logstash/blob/master/logstash-core/src/main/java/org/logstash/Event.java * * @author Tim Mower */ class LogstashFormatter extends NormalizerFormatter { /** * @var string the name of the system for the Logstash log message, used to fill the @source field */ protected $systemName; /** * @var string an application name for the Logstash log message, used to fill the @type field */ protected $applicationName; /** * @var string the key for 'extra' fields from the Monolog record */ protected $extraKey; /** * @var string the key for 'context' fields from the Monolog record */ protected $contextKey; /** * @param string $applicationName The application that sends the data, used as the "type" field of logstash * @param string|null $systemName The system/machine name, used as the "source" field of logstash, defaults to the hostname of the machine * @param string $extraKey The key for extra keys inside logstash "fields", defaults to extra * @param string $contextKey The key for context keys inside logstash "fields", defaults to context */ public function __construct(string $applicationName, ?string $systemName = null, string $extraKey = 'extra', string $contextKey = 'context') { // logstash requires a ISO 8601 format date with optional millisecond precision. parent::__construct('Y-m-d\TH:i:s.uP'); $this->systemName = $systemName === null ? (string) gethostname() : $systemName; $this->applicationName = $applicationName; $this->extraKey = $extraKey; $this->contextKey = $contextKey; } /** * {@inheritDoc} */ public function format(array $record): string { $record = parent::format($record); if (empty($record['datetime'])) { $record['datetime'] = gmdate('c'); } $message = [ '@timestamp' => $record['datetime'], '@version' => 1, 'host' => $this->systemName, ]; if (isset($record['message'])) { $message['message'] = $record['message']; } if (isset($record['channel'])) { $message['type'] = $record['channel']; $message['channel'] = $record['channel']; } if (isset($record['level_name'])) { $message['level'] = $record['level_name']; } if (isset($record['level'])) { $message['monolog_level'] = $record['level']; } if ($this->applicationName) { $message['type'] = $this->applicationName; } if (!empty($record['extra'])) { $message[$this->extraKey] = $record['extra']; } if (!empty($record['context'])) { $message[$this->contextKey] = $record['context']; } return $this->toJson($message) . "\n"; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use DateTimeInterface; /** * Format a log message into an Elasticsearch record * * @author Avtandil Kikabidze */ class ElasticsearchFormatter extends NormalizerFormatter { /** * @var string Elasticsearch index name */ protected $index; /** * @var string Elasticsearch record type */ protected $type; /** * @param string $index Elasticsearch index name * @param string $type Elasticsearch record type */ public function __construct(string $index, string $type) { // Elasticsearch requires an ISO 8601 format date with optional millisecond precision. parent::__construct(DateTimeInterface::ISO8601); $this->index = $index; $this->type = $type; } /** * {@inheritDoc} */ public function format(array $record) { $record = parent::format($record); return $this->getDocument($record); } /** * Getter index * * @return string */ public function getIndex(): string { return $this->index; } /** * Getter type * * @return string */ public function getType(): string { return $this->type; } /** * Convert a log message into an Elasticsearch record * * @param mixed[] $record Log message * @return mixed[] */ protected function getDocument(array $record): array { $record['_index'] = $this->index; $record['_type'] = $this->type; return $record; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Formatter; use Elastica\Document; /** * Format a log message into an Elastica Document * * @author Jelle Vink * * @phpstan-import-type Record from \Monolog\Logger */ class ElasticaFormatter extends NormalizerFormatter { /** * @var string Elastic search index name */ protected $index; /** * @var ?string Elastic search document type */ protected $type; /** * @param string $index Elastic Search index name * @param ?string $type Elastic Search document type, deprecated as of Elastica 7 */ public function __construct(string $index, ?string $type) { // elasticsearch requires a ISO 8601 format date with optional millisecond precision. parent::__construct('Y-m-d\TH:i:s.uP'); $this->index = $index; $this->type = $type; } /** * {@inheritDoc} */ public function format(array $record) { $record = parent::format($record); return $this->getDocument($record); } public function getIndex(): string { return $this->index; } /** * @deprecated since Elastica 7 type has no effect */ public function getType(): string { /** @phpstan-ignore-next-line */ return $this->type; } /** * Convert a log message into an Elastica Document * * @phpstan-param Record $record */ protected function getDocument(array $record): Document { $document = new Document(); $document->setData($record); if (method_exists($document, 'setType')) { /** @phpstan-ignore-next-line */ $document->setType($this->type); } $document->setIndex($this->index); return $document; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog; use InvalidArgumentException; /** * Monolog log registry * * Allows to get `Logger` instances in the global scope * via static method calls on this class. * * * $application = new Monolog\Logger('application'); * $api = new Monolog\Logger('api'); * * Monolog\Registry::addLogger($application); * Monolog\Registry::addLogger($api); * * function testLogger() * { * Monolog\Registry::api()->error('Sent to $api Logger instance'); * Monolog\Registry::application()->error('Sent to $application Logger instance'); * } * * * @author Tomas Tatarko */ class Registry { /** * List of all loggers in the registry (by named indexes) * * @var Logger[] */ private static $loggers = []; /** * Adds new logging channel to the registry * * @param Logger $logger Instance of the logging channel * @param string|null $name Name of the logging channel ($logger->getName() by default) * @param bool $overwrite Overwrite instance in the registry if the given name already exists? * @throws \InvalidArgumentException If $overwrite set to false and named Logger instance already exists * @return void */ public static function addLogger(Logger $logger, ?string $name = null, bool $overwrite = false) { $name = $name ?: $logger->getName(); if (isset(self::$loggers[$name]) && !$overwrite) { throw new InvalidArgumentException('Logger with the given name already exists'); } self::$loggers[$name] = $logger; } /** * Checks if such logging channel exists by name or instance * * @param string|Logger $logger Name or logger instance */ public static function hasLogger($logger): bool { if ($logger instanceof Logger) { $index = array_search($logger, self::$loggers, true); return false !== $index; } return isset(self::$loggers[$logger]); } /** * Removes instance from registry by name or instance * * @param string|Logger $logger Name or logger instance */ public static function removeLogger($logger): void { if ($logger instanceof Logger) { if (false !== ($idx = array_search($logger, self::$loggers, true))) { unset(self::$loggers[$idx]); } } else { unset(self::$loggers[$logger]); } } /** * Clears the registry */ public static function clear(): void { self::$loggers = []; } /** * Gets Logger instance from the registry * * @param string $name Name of the requested Logger instance * @throws \InvalidArgumentException If named Logger instance is not in the registry */ public static function getInstance($name): Logger { if (!isset(self::$loggers[$name])) { throw new InvalidArgumentException(sprintf('Requested "%s" logger instance is not in the registry', $name)); } return self::$loggers[$name]; } /** * Gets Logger instance from the registry via static method call * * @param string $name Name of the requested Logger instance * @param mixed[] $arguments Arguments passed to static method call * @throws \InvalidArgumentException If named Logger instance is not in the registry * @return Logger Requested instance of Logger */ public static function __callStatic($name, $arguments) { return self::getInstance($name); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog; use Psr\Log\LoggerInterface; use Psr\Log\LogLevel; use ReflectionExtension; /** * Monolog POSIX signal handler * * @author Robert Gust-Bardon * * @phpstan-import-type Level from \Monolog\Logger * @phpstan-import-type LevelName from \Monolog\Logger */ class SignalHandler { /** @var LoggerInterface */ private $logger; /** @var array SIG_DFL, SIG_IGN or previous callable */ private $previousSignalHandler = []; /** @var array */ private $signalLevelMap = []; /** @var array */ private $signalRestartSyscalls = []; public function __construct(LoggerInterface $logger) { $this->logger = $logger; } /** * @param int|string $level Level or level name * @param bool $callPrevious * @param bool $restartSyscalls * @param bool|null $async * @return $this * * @phpstan-param Level|LevelName|LogLevel::* $level */ public function registerSignalHandler(int $signo, $level = LogLevel::CRITICAL, bool $callPrevious = true, bool $restartSyscalls = true, ?bool $async = true): self { if (!extension_loaded('pcntl') || !function_exists('pcntl_signal')) { return $this; } $level = Logger::toMonologLevel($level); if ($callPrevious) { $handler = pcntl_signal_get_handler($signo); $this->previousSignalHandler[$signo] = $handler; } else { unset($this->previousSignalHandler[$signo]); } $this->signalLevelMap[$signo] = $level; $this->signalRestartSyscalls[$signo] = $restartSyscalls; if ($async !== null) { pcntl_async_signals($async); } pcntl_signal($signo, [$this, 'handleSignal'], $restartSyscalls); return $this; } /** * @param mixed $siginfo */ public function handleSignal(int $signo, $siginfo = null): void { static $signals = []; if (!$signals && extension_loaded('pcntl')) { $pcntl = new ReflectionExtension('pcntl'); // HHVM 3.24.2 returns an empty array. foreach ($pcntl->getConstants() ?: get_defined_constants(true)['Core'] as $name => $value) { if (substr($name, 0, 3) === 'SIG' && $name[3] !== '_' && is_int($value)) { $signals[$value] = $name; } } } $level = $this->signalLevelMap[$signo] ?? LogLevel::CRITICAL; $signal = $signals[$signo] ?? $signo; $context = $siginfo ?? []; $this->logger->log($level, sprintf('Program received signal %s', $signal), $context); if (!isset($this->previousSignalHandler[$signo])) { return; } if ($this->previousSignalHandler[$signo] === SIG_DFL) { if (extension_loaded('pcntl') && function_exists('pcntl_signal') && function_exists('pcntl_sigprocmask') && function_exists('pcntl_signal_dispatch') && extension_loaded('posix') && function_exists('posix_getpid') && function_exists('posix_kill') ) { $restartSyscalls = $this->signalRestartSyscalls[$signo] ?? true; pcntl_signal($signo, SIG_DFL, $restartSyscalls); pcntl_sigprocmask(SIG_UNBLOCK, [$signo], $oldset); posix_kill(posix_getpid(), $signo); pcntl_signal_dispatch(); pcntl_sigprocmask(SIG_SETMASK, $oldset); pcntl_signal($signo, [$this, 'handleSignal'], $restartSyscalls); } } elseif (is_callable($this->previousSignalHandler[$signo])) { $this->previousSignalHandler[$signo]($signo, $siginfo); } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog; final class Utils { const DEFAULT_JSON_FLAGS = JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_PRESERVE_ZERO_FRACTION | JSON_INVALID_UTF8_SUBSTITUTE | JSON_PARTIAL_OUTPUT_ON_ERROR; public static function getClass(object $object): string { $class = \get_class($object); if (false === ($pos = \strpos($class, "@anonymous\0"))) { return $class; } if (false === ($parent = \get_parent_class($class))) { return \substr($class, 0, $pos + 10); } return $parent . '@anonymous'; } public static function substr(string $string, int $start, ?int $length = null): string { if (extension_loaded('mbstring')) { return mb_strcut($string, $start, $length); } return substr($string, $start, (null === $length) ? strlen($string) : $length); } /** * Makes sure if a relative path is passed in it is turned into an absolute path * * @param string $streamUrl stream URL or path without protocol */ public static function canonicalizePath(string $streamUrl): string { $prefix = ''; if ('file://' === substr($streamUrl, 0, 7)) { $streamUrl = substr($streamUrl, 7); $prefix = 'file://'; } // other type of stream, not supported if (false !== strpos($streamUrl, '://')) { return $streamUrl; } // already absolute if (substr($streamUrl, 0, 1) === '/' || substr($streamUrl, 1, 1) === ':' || substr($streamUrl, 0, 2) === '\\\\') { return $prefix.$streamUrl; } $streamUrl = getcwd() . '/' . $streamUrl; return $prefix.$streamUrl; } /** * Return the JSON representation of a value * * @param mixed $data * @param int $encodeFlags flags to pass to json encode, defaults to DEFAULT_JSON_FLAGS * @param bool $ignoreErrors whether to ignore encoding errors or to throw on error, when ignored and the encoding fails, "null" is returned which is valid json for null * @throws \RuntimeException if encoding fails and errors are not ignored * @return string when errors are ignored and the encoding fails, "null" is returned which is valid json for null */ public static function jsonEncode($data, ?int $encodeFlags = null, bool $ignoreErrors = false): string { if (null === $encodeFlags) { $encodeFlags = self::DEFAULT_JSON_FLAGS; } if ($ignoreErrors) { $json = @json_encode($data, $encodeFlags); if (false === $json) { return 'null'; } return $json; } $json = json_encode($data, $encodeFlags); if (false === $json) { $json = self::handleJsonError(json_last_error(), $data); } return $json; } /** * Handle a json_encode failure. * * If the failure is due to invalid string encoding, try to clean the * input and encode again. If the second encoding attempt fails, the * initial error is not encoding related or the input can't be cleaned then * raise a descriptive exception. * * @param int $code return code of json_last_error function * @param mixed $data data that was meant to be encoded * @param int $encodeFlags flags to pass to json encode, defaults to JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_PRESERVE_ZERO_FRACTION * @throws \RuntimeException if failure can't be corrected * @return string JSON encoded data after error correction */ public static function handleJsonError(int $code, $data, ?int $encodeFlags = null): string { if ($code !== JSON_ERROR_UTF8) { self::throwEncodeError($code, $data); } if (is_string($data)) { self::detectAndCleanUtf8($data); } elseif (is_array($data)) { array_walk_recursive($data, array('Monolog\Utils', 'detectAndCleanUtf8')); } else { self::throwEncodeError($code, $data); } if (null === $encodeFlags) { $encodeFlags = self::DEFAULT_JSON_FLAGS; } $json = json_encode($data, $encodeFlags); if ($json === false) { self::throwEncodeError(json_last_error(), $data); } return $json; } /** * @internal */ public static function pcreLastErrorMessage(int $code): string { if (PHP_VERSION_ID >= 80000) { return preg_last_error_msg(); } $constants = (get_defined_constants(true))['pcre']; $constants = array_filter($constants, function ($key) { return substr($key, -6) == '_ERROR'; }, ARRAY_FILTER_USE_KEY); $constants = array_flip($constants); return $constants[$code] ?? 'UNDEFINED_ERROR'; } /** * Throws an exception according to a given code with a customized message * * @param int $code return code of json_last_error function * @param mixed $data data that was meant to be encoded * @throws \RuntimeException * * @return never */ private static function throwEncodeError(int $code, $data): void { switch ($code) { case JSON_ERROR_DEPTH: $msg = 'Maximum stack depth exceeded'; break; case JSON_ERROR_STATE_MISMATCH: $msg = 'Underflow or the modes mismatch'; break; case JSON_ERROR_CTRL_CHAR: $msg = 'Unexpected control character found'; break; case JSON_ERROR_UTF8: $msg = 'Malformed UTF-8 characters, possibly incorrectly encoded'; break; default: $msg = 'Unknown error'; } throw new \RuntimeException('JSON encoding failed: '.$msg.'. Encoding: '.var_export($data, true)); } /** * Detect invalid UTF-8 string characters and convert to valid UTF-8. * * Valid UTF-8 input will be left unmodified, but strings containing * invalid UTF-8 codepoints will be reencoded as UTF-8 with an assumed * original encoding of ISO-8859-15. This conversion may result in * incorrect output if the actual encoding was not ISO-8859-15, but it * will be clean UTF-8 output and will not rely on expensive and fragile * detection algorithms. * * Function converts the input in place in the passed variable so that it * can be used as a callback for array_walk_recursive. * * @param mixed $data Input to check and convert if needed, passed by ref */ private static function detectAndCleanUtf8(&$data): void { if (is_string($data) && !preg_match('//u', $data)) { $data = preg_replace_callback( '/[\x80-\xFF]+/', function ($m) { return function_exists('mb_convert_encoding') ? mb_convert_encoding($m[0], 'UTF-8', 'ISO-8859-1') : utf8_encode($m[0]); }, $data ); if (!is_string($data)) { $pcreErrorCode = preg_last_error(); throw new \RuntimeException('Failed to preg_replace_callback: ' . $pcreErrorCode . ' / ' . self::pcreLastErrorMessage($pcreErrorCode)); } $data = str_replace( ['¤', '¦', '¨', '´', '¸', '¼', '½', '¾'], ['€', 'Š', 'š', 'Ž', 'ž', 'Œ', 'œ', 'Ÿ'], $data ); } } /** * Converts a string with a valid 'memory_limit' format, to bytes. * * @param string|false $val * @return int|false Returns an integer representing bytes. Returns FALSE in case of error. */ public static function expandIniShorthandBytes($val) { if (!is_string($val)) { return false; } // support -1 if ((int) $val < 0) { return (int) $val; } if (!preg_match('/^\s*(?\d+)(?:\.\d+)?\s*(?[gmk]?)\s*$/i', $val, $match)) { return false; } $val = (int) $match['val']; switch (strtolower($match['unit'] ?? '')) { case 'g': $val *= 1024; case 'm': $val *= 1024; case 'k': $val *= 1024; } return $val; } /** * @param array $record */ public static function getRecordMessageForException(array $record): string { $context = ''; $extra = ''; try { if ($record['context']) { $context = "\nContext: " . json_encode($record['context']); } if ($record['extra']) { $extra = "\nExtra: " . json_encode($record['extra']); } } catch (\Throwable $e) { // noop } return "\nThe exception occurred while attempting to log: " . $record['message'] . $context . $extra; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog; use ArrayAccess; /** * Monolog log record interface for forward compatibility with Monolog 3.0 * * This is just present in Monolog 2.4+ to allow interoperable code to be written against * both versions by type-hinting arguments as `array|\Monolog\LogRecord $record` * * Do not rely on this interface for other purposes, and do not implement it. * * @author Jordi Boggiano * @template-extends \ArrayAccess<'message'|'level'|'context'|'level_name'|'channel'|'datetime'|'extra'|'formatted', mixed> * @phpstan-import-type Record from Logger */ interface LogRecord extends \ArrayAccess { /** * @phpstan-return Record */ public function toArray(): array; } DefinitionData = array(); # standardize line breaks $text = str_replace(array("\r\n", "\r"), "\n", $text); # remove surrounding line breaks $text = trim($text, "\n"); # split text into lines $lines = explode("\n", $text); # iterate through lines to identify blocks $markup = $this->lines($lines); # trim line breaks $markup = trim($markup, "\n"); return $markup; } # # Setters # function setBreaksEnabled($breaksEnabled) { $this->breaksEnabled = $breaksEnabled; return $this; } protected $breaksEnabled; function setMarkupEscaped($markupEscaped) { $this->markupEscaped = $markupEscaped; return $this; } protected $markupEscaped; function setUrlsLinked($urlsLinked) { $this->urlsLinked = $urlsLinked; return $this; } protected $urlsLinked = true; function setSafeMode($safeMode) { $this->safeMode = (bool) $safeMode; return $this; } protected $safeMode; protected $safeLinksWhitelist = array( 'http://', 'https://', 'ftp://', 'ftps://', 'mailto:', 'data:image/png;base64,', 'data:image/gif;base64,', 'data:image/jpeg;base64,', 'irc:', 'ircs:', 'git:', 'ssh:', 'news:', 'steam:', ); # # Lines # protected $BlockTypes = array( '#' => array('Header'), '*' => array('Rule', 'List'), '+' => array('List'), '-' => array('SetextHeader', 'Table', 'Rule', 'List'), '0' => array('List'), '1' => array('List'), '2' => array('List'), '3' => array('List'), '4' => array('List'), '5' => array('List'), '6' => array('List'), '7' => array('List'), '8' => array('List'), '9' => array('List'), ':' => array('Table'), '<' => array('Comment', 'Markup'), '=' => array('SetextHeader'), '>' => array('Quote'), '[' => array('Reference'), '_' => array('Rule'), '`' => array('FencedCode'), '|' => array('Table'), '~' => array('FencedCode'), ); # ~ protected $unmarkedBlockTypes = array( 'Code', ); # # Blocks # protected function lines(array $lines) { $CurrentBlock = null; foreach ($lines as $line) { if (chop($line) === '') { if (isset($CurrentBlock)) { $CurrentBlock['interrupted'] = true; } continue; } if (strpos($line, "\t") !== false) { $parts = explode("\t", $line); $line = $parts[0]; unset($parts[0]); foreach ($parts as $part) { $shortage = 4 - mb_strlen($line, 'utf-8') % 4; $line .= str_repeat(' ', $shortage); $line .= $part; } } $indent = 0; while (isset($line[$indent]) and $line[$indent] === ' ') { $indent ++; } $text = $indent > 0 ? substr($line, $indent) : $line; # ~ $Line = array('body' => $line, 'indent' => $indent, 'text' => $text); # ~ if (isset($CurrentBlock['continuable'])) { $Block = $this->{'block'.$CurrentBlock['type'].'Continue'}($Line, $CurrentBlock); if (isset($Block)) { $CurrentBlock = $Block; continue; } else { if ($this->isBlockCompletable($CurrentBlock['type'])) { $CurrentBlock = $this->{'block'.$CurrentBlock['type'].'Complete'}($CurrentBlock); } } } # ~ $marker = $text[0]; # ~ $blockTypes = $this->unmarkedBlockTypes; if (isset($this->BlockTypes[$marker])) { foreach ($this->BlockTypes[$marker] as $blockType) { $blockTypes []= $blockType; } } # # ~ foreach ($blockTypes as $blockType) { $Block = $this->{'block'.$blockType}($Line, $CurrentBlock); if (isset($Block)) { $Block['type'] = $blockType; if ( ! isset($Block['identified'])) { $Blocks []= $CurrentBlock; $Block['identified'] = true; } if ($this->isBlockContinuable($blockType)) { $Block['continuable'] = true; } $CurrentBlock = $Block; continue 2; } } # ~ if (isset($CurrentBlock) and ! isset($CurrentBlock['type']) and ! isset($CurrentBlock['interrupted'])) { $CurrentBlock['element']['text'] .= "\n".$text; } else { $Blocks []= $CurrentBlock; $CurrentBlock = $this->paragraph($Line); $CurrentBlock['identified'] = true; } } # ~ if (isset($CurrentBlock['continuable']) and $this->isBlockCompletable($CurrentBlock['type'])) { $CurrentBlock = $this->{'block'.$CurrentBlock['type'].'Complete'}($CurrentBlock); } # ~ $Blocks []= $CurrentBlock; unset($Blocks[0]); # ~ $markup = ''; foreach ($Blocks as $Block) { if (isset($Block['hidden'])) { continue; } $markup .= "\n"; $markup .= isset($Block['markup']) ? $Block['markup'] : $this->element($Block['element']); } $markup .= "\n"; # ~ return $markup; } protected function isBlockContinuable($Type) { return method_exists($this, 'block'.$Type.'Continue'); } protected function isBlockCompletable($Type) { return method_exists($this, 'block'.$Type.'Complete'); } # # Code protected function blockCode($Line, $Block = null) { if (isset($Block) and ! isset($Block['type']) and ! isset($Block['interrupted'])) { return; } if ($Line['indent'] >= 4) { $text = substr($Line['body'], 4); $Block = array( 'element' => array( 'name' => 'pre', 'handler' => 'element', 'text' => array( 'name' => 'code', 'text' => $text, ), ), ); return $Block; } } protected function blockCodeContinue($Line, $Block) { if ($Line['indent'] >= 4) { if (isset($Block['interrupted'])) { $Block['element']['text']['text'] .= "\n"; unset($Block['interrupted']); } $Block['element']['text']['text'] .= "\n"; $text = substr($Line['body'], 4); $Block['element']['text']['text'] .= $text; return $Block; } } protected function blockCodeComplete($Block) { $text = $Block['element']['text']['text']; $Block['element']['text']['text'] = $text; return $Block; } # # Comment protected function blockComment($Line) { if ($this->markupEscaped or $this->safeMode) { return; } if (isset($Line['text'][3]) and $Line['text'][3] === '-' and $Line['text'][2] === '-' and $Line['text'][1] === '!') { $Block = array( 'markup' => $Line['body'], ); if (preg_match('/-->$/', $Line['text'])) { $Block['closed'] = true; } return $Block; } } protected function blockCommentContinue($Line, array $Block) { if (isset($Block['closed'])) { return; } $Block['markup'] .= "\n" . $Line['body']; if (preg_match('/-->$/', $Line['text'])) { $Block['closed'] = true; } return $Block; } # # Fenced Code protected function blockFencedCode($Line) { if (preg_match('/^['.$Line['text'][0].']{3,}[ ]*([^`]+)?[ ]*$/', $Line['text'], $matches)) { $Element = array( 'name' => 'code', 'text' => '', ); if (isset($matches[1])) { /** * https://www.w3.org/TR/2011/WD-html5-20110525/elements.html#classes * Every HTML element may have a class attribute specified. * The attribute, if specified, must have a value that is a set * of space-separated tokens representing the various classes * that the element belongs to. * [...] * The space characters, for the purposes of this specification, * are U+0020 SPACE, U+0009 CHARACTER TABULATION (tab), * U+000A LINE FEED (LF), U+000C FORM FEED (FF), and * U+000D CARRIAGE RETURN (CR). */ $language = substr($matches[1], 0, strcspn($matches[1], " \t\n\f\r")); $class = 'language-'.$language; $Element['attributes'] = array( 'class' => $class, ); } $Block = array( 'char' => $Line['text'][0], 'element' => array( 'name' => 'pre', 'handler' => 'element', 'text' => $Element, ), ); return $Block; } } protected function blockFencedCodeContinue($Line, $Block) { if (isset($Block['complete'])) { return; } if (isset($Block['interrupted'])) { $Block['element']['text']['text'] .= "\n"; unset($Block['interrupted']); } if (preg_match('/^'.$Block['char'].'{3,}[ ]*$/', $Line['text'])) { $Block['element']['text']['text'] = substr($Block['element']['text']['text'], 1); $Block['complete'] = true; return $Block; } $Block['element']['text']['text'] .= "\n".$Line['body']; return $Block; } protected function blockFencedCodeComplete($Block) { $text = $Block['element']['text']['text']; $Block['element']['text']['text'] = $text; return $Block; } # # Header protected function blockHeader($Line) { if (isset($Line['text'][1])) { $level = 1; while (isset($Line['text'][$level]) and $Line['text'][$level] === '#') { $level ++; } if ($level > 6) { return; } $text = trim($Line['text'], '# '); $Block = array( 'element' => array( 'name' => 'h' . min(6, $level), 'text' => $text, 'handler' => 'line', ), ); return $Block; } } # # List protected function blockList($Line) { list($name, $pattern) = $Line['text'][0] <= '-' ? array('ul', '[*+-]') : array('ol', '[0-9]+[.]'); if (preg_match('/^('.$pattern.'[ ]+)(.*)/', $Line['text'], $matches)) { $Block = array( 'indent' => $Line['indent'], 'pattern' => $pattern, 'element' => array( 'name' => $name, 'handler' => 'elements', ), ); if($name === 'ol') { $listStart = stristr($matches[0], '.', true); if($listStart !== '1') { $Block['element']['attributes'] = array('start' => $listStart); } } $Block['li'] = array( 'name' => 'li', 'handler' => 'li', 'text' => array( $matches[2], ), ); $Block['element']['text'] []= & $Block['li']; return $Block; } } protected function blockListContinue($Line, array $Block) { if ($Block['indent'] === $Line['indent'] and preg_match('/^'.$Block['pattern'].'(?:[ ]+(.*)|$)/', $Line['text'], $matches)) { if (isset($Block['interrupted'])) { $Block['li']['text'] []= ''; $Block['loose'] = true; unset($Block['interrupted']); } unset($Block['li']); $text = isset($matches[1]) ? $matches[1] : ''; $Block['li'] = array( 'name' => 'li', 'handler' => 'li', 'text' => array( $text, ), ); $Block['element']['text'] []= & $Block['li']; return $Block; } if ($Line['text'][0] === '[' and $this->blockReference($Line)) { return $Block; } if ( ! isset($Block['interrupted'])) { $text = preg_replace('/^[ ]{0,4}/', '', $Line['body']); $Block['li']['text'] []= $text; return $Block; } if ($Line['indent'] > 0) { $Block['li']['text'] []= ''; $text = preg_replace('/^[ ]{0,4}/', '', $Line['body']); $Block['li']['text'] []= $text; unset($Block['interrupted']); return $Block; } } protected function blockListComplete(array $Block) { if (isset($Block['loose'])) { foreach ($Block['element']['text'] as &$li) { if (end($li['text']) !== '') { $li['text'] []= ''; } } } return $Block; } # # Quote protected function blockQuote($Line) { if (preg_match('/^>[ ]?(.*)/', $Line['text'], $matches)) { $Block = array( 'element' => array( 'name' => 'blockquote', 'handler' => 'lines', 'text' => (array) $matches[1], ), ); return $Block; } } protected function blockQuoteContinue($Line, array $Block) { if ($Line['text'][0] === '>' and preg_match('/^>[ ]?(.*)/', $Line['text'], $matches)) { if (isset($Block['interrupted'])) { $Block['element']['text'] []= ''; unset($Block['interrupted']); } $Block['element']['text'] []= $matches[1]; return $Block; } if ( ! isset($Block['interrupted'])) { $Block['element']['text'] []= $Line['text']; return $Block; } } # # Rule protected function blockRule($Line) { if (preg_match('/^(['.$Line['text'][0].'])([ ]*\1){2,}[ ]*$/', $Line['text'])) { $Block = array( 'element' => array( 'name' => 'hr' ), ); return $Block; } } # # Setext protected function blockSetextHeader($Line, array $Block = null) { if ( ! isset($Block) or isset($Block['type']) or isset($Block['interrupted'])) { return; } if (chop($Line['text'], $Line['text'][0]) === '') { $Block['element']['name'] = $Line['text'][0] === '=' ? 'h1' : 'h2'; return $Block; } } # # Markup protected function blockMarkup($Line) { if ($this->markupEscaped or $this->safeMode) { return; } if (preg_match('/^<(\w[\w-]*)(?:[ ]*'.$this->regexHtmlAttribute.')*[ ]*(\/)?>/', $Line['text'], $matches)) { $element = strtolower($matches[1]); if (in_array($element, $this->textLevelElements)) { return; } $Block = array( 'name' => $matches[1], 'depth' => 0, 'markup' => $Line['text'], ); $length = strlen($matches[0]); $remainder = substr($Line['text'], $length); if (trim($remainder) === '') { if (isset($matches[2]) or in_array($matches[1], $this->voidElements)) { $Block['closed'] = true; $Block['void'] = true; } } else { if (isset($matches[2]) or in_array($matches[1], $this->voidElements)) { return; } if (preg_match('/<\/'.$matches[1].'>[ ]*$/i', $remainder)) { $Block['closed'] = true; } } return $Block; } } protected function blockMarkupContinue($Line, array $Block) { if (isset($Block['closed'])) { return; } if (preg_match('/^<'.$Block['name'].'(?:[ ]*'.$this->regexHtmlAttribute.')*[ ]*>/i', $Line['text'])) # open { $Block['depth'] ++; } if (preg_match('/(.*?)<\/'.$Block['name'].'>[ ]*$/i', $Line['text'], $matches)) # close { if ($Block['depth'] > 0) { $Block['depth'] --; } else { $Block['closed'] = true; } } if (isset($Block['interrupted'])) { $Block['markup'] .= "\n"; unset($Block['interrupted']); } $Block['markup'] .= "\n".$Line['body']; return $Block; } # # Reference protected function blockReference($Line) { if (preg_match('/^\[(.+?)\]:[ ]*?(?:[ ]+["\'(](.+)["\')])?[ ]*$/', $Line['text'], $matches)) { $id = strtolower($matches[1]); $Data = array( 'url' => $matches[2], 'title' => null, ); if (isset($matches[3])) { $Data['title'] = $matches[3]; } $this->DefinitionData['Reference'][$id] = $Data; $Block = array( 'hidden' => true, ); return $Block; } } # # Table protected function blockTable($Line, array $Block = null) { if ( ! isset($Block) or isset($Block['type']) or isset($Block['interrupted'])) { return; } if (strpos($Block['element']['text'], '|') !== false and chop($Line['text'], ' -:|') === '') { $alignments = array(); $divider = $Line['text']; $divider = trim($divider); $divider = trim($divider, '|'); $dividerCells = explode('|', $divider); foreach ($dividerCells as $dividerCell) { $dividerCell = trim($dividerCell); if ($dividerCell === '') { continue; } $alignment = null; if ($dividerCell[0] === ':') { $alignment = 'left'; } if (substr($dividerCell, - 1) === ':') { $alignment = $alignment === 'left' ? 'center' : 'right'; } $alignments []= $alignment; } # ~ $HeaderElements = array(); $header = $Block['element']['text']; $header = trim($header); $header = trim($header, '|'); $headerCells = explode('|', $header); foreach ($headerCells as $index => $headerCell) { $headerCell = trim($headerCell); $HeaderElement = array( 'name' => 'th', 'text' => $headerCell, 'handler' => 'line', ); if (isset($alignments[$index])) { $alignment = $alignments[$index]; $HeaderElement['attributes'] = array( 'style' => 'text-align: '.$alignment.';', ); } $HeaderElements []= $HeaderElement; } # ~ $Block = array( 'alignments' => $alignments, 'identified' => true, 'element' => array( 'name' => 'table', 'handler' => 'elements', ), ); $Block['element']['text'] []= array( 'name' => 'thead', 'handler' => 'elements', ); $Block['element']['text'] []= array( 'name' => 'tbody', 'handler' => 'elements', 'text' => array(), ); $Block['element']['text'][0]['text'] []= array( 'name' => 'tr', 'handler' => 'elements', 'text' => $HeaderElements, ); return $Block; } } protected function blockTableContinue($Line, array $Block) { if (isset($Block['interrupted'])) { return; } if ($Line['text'][0] === '|' or strpos($Line['text'], '|')) { $Elements = array(); $row = $Line['text']; $row = trim($row); $row = trim($row, '|'); preg_match_all('/(?:(\\\\[|])|[^|`]|`[^`]+`|`)+/', $row, $matches); foreach ($matches[0] as $index => $cell) { $cell = trim($cell); $Element = array( 'name' => 'td', 'handler' => 'line', 'text' => $cell, ); if (isset($Block['alignments'][$index])) { $Element['attributes'] = array( 'style' => 'text-align: '.$Block['alignments'][$index].';', ); } $Elements []= $Element; } $Element = array( 'name' => 'tr', 'handler' => 'elements', 'text' => $Elements, ); $Block['element']['text'][1]['text'] []= $Element; return $Block; } } # # ~ # protected function paragraph($Line) { $Block = array( 'element' => array( 'name' => 'p', 'text' => $Line['text'], 'handler' => 'line', ), ); return $Block; } # # Inline Elements # protected $InlineTypes = array( '"' => array('SpecialCharacter'), '!' => array('Image'), '&' => array('SpecialCharacter'), '*' => array('Emphasis'), ':' => array('Url'), '<' => array('UrlTag', 'EmailTag', 'Markup', 'SpecialCharacter'), '>' => array('SpecialCharacter'), '[' => array('Link'), '_' => array('Emphasis'), '`' => array('Code'), '~' => array('Strikethrough'), '\\' => array('EscapeSequence'), ); # ~ protected $inlineMarkerList = '!"*_&[:<>`~\\'; # # ~ # public function line($text, $nonNestables=array()) { $markup = ''; # $excerpt is based on the first occurrence of a marker while ($excerpt = strpbrk($text, $this->inlineMarkerList)) { $marker = $excerpt[0]; $markerPosition = strpos($text, $marker); $Excerpt = array('text' => $excerpt, 'context' => $text); foreach ($this->InlineTypes[$marker] as $inlineType) { # check to see if the current inline type is nestable in the current context if ( ! empty($nonNestables) and in_array($inlineType, $nonNestables)) { continue; } $Inline = $this->{'inline'.$inlineType}($Excerpt); if ( ! isset($Inline)) { continue; } # makes sure that the inline belongs to "our" marker if (isset($Inline['position']) and $Inline['position'] > $markerPosition) { continue; } # sets a default inline position if ( ! isset($Inline['position'])) { $Inline['position'] = $markerPosition; } # cause the new element to 'inherit' our non nestables foreach ($nonNestables as $non_nestable) { $Inline['element']['nonNestables'][] = $non_nestable; } # the text that comes before the inline $unmarkedText = substr($text, 0, $Inline['position']); # compile the unmarked text $markup .= $this->unmarkedText($unmarkedText); # compile the inline $markup .= isset($Inline['markup']) ? $Inline['markup'] : $this->element($Inline['element']); # remove the examined text $text = substr($text, $Inline['position'] + $Inline['extent']); continue 2; } # the marker does not belong to an inline $unmarkedText = substr($text, 0, $markerPosition + 1); $markup .= $this->unmarkedText($unmarkedText); $text = substr($text, $markerPosition + 1); } $markup .= $this->unmarkedText($text); return $markup; } # # ~ # protected function inlineCode($Excerpt) { $marker = $Excerpt['text'][0]; if (preg_match('/^('.$marker.'+)[ ]*(.+?)[ ]*(? strlen($matches[0]), 'element' => array( 'name' => 'code', 'text' => $text, ), ); } } protected function inlineEmailTag($Excerpt) { if (strpos($Excerpt['text'], '>') !== false and preg_match('/^<((mailto:)?\S+?@\S+?)>/i', $Excerpt['text'], $matches)) { $url = $matches[1]; if ( ! isset($matches[2])) { $url = 'mailto:' . $url; } return array( 'extent' => strlen($matches[0]), 'element' => array( 'name' => 'a', 'text' => $matches[1], 'attributes' => array( 'href' => $url, ), ), ); } } protected function inlineEmphasis($Excerpt) { if ( ! isset($Excerpt['text'][1])) { return; } $marker = $Excerpt['text'][0]; if ($Excerpt['text'][1] === $marker and preg_match($this->StrongRegex[$marker], $Excerpt['text'], $matches)) { $emphasis = 'strong'; } elseif (preg_match($this->EmRegex[$marker], $Excerpt['text'], $matches)) { $emphasis = 'em'; } else { return; } return array( 'extent' => strlen($matches[0]), 'element' => array( 'name' => $emphasis, 'handler' => 'line', 'text' => $matches[1], ), ); } protected function inlineEscapeSequence($Excerpt) { if (isset($Excerpt['text'][1]) and in_array($Excerpt['text'][1], $this->specialCharacters)) { return array( 'markup' => $Excerpt['text'][1], 'extent' => 2, ); } } protected function inlineImage($Excerpt) { if ( ! isset($Excerpt['text'][1]) or $Excerpt['text'][1] !== '[') { return; } $Excerpt['text']= substr($Excerpt['text'], 1); $Link = $this->inlineLink($Excerpt); if ($Link === null) { return; } $Inline = array( 'extent' => $Link['extent'] + 1, 'element' => array( 'name' => 'img', 'attributes' => array( 'src' => $Link['element']['attributes']['href'], 'alt' => $Link['element']['text'], ), ), ); $Inline['element']['attributes'] += $Link['element']['attributes']; unset($Inline['element']['attributes']['href']); return $Inline; } protected function inlineLink($Excerpt) { $Element = array( 'name' => 'a', 'handler' => 'line', 'nonNestables' => array('Url', 'Link'), 'text' => null, 'attributes' => array( 'href' => null, 'title' => null, ), ); $extent = 0; $remainder = $Excerpt['text']; if (preg_match('/\[((?:[^][]++|(?R))*+)\]/', $remainder, $matches)) { $Element['text'] = $matches[1]; $extent += strlen($matches[0]); $remainder = substr($remainder, $extent); } else { return; } if (preg_match('/^[(]\s*+((?:[^ ()]++|[(][^ )]+[)])++)(?:[ ]+("[^"]*"|\'[^\']*\'))?\s*[)]/', $remainder, $matches)) { $Element['attributes']['href'] = $matches[1]; if (isset($matches[2])) { $Element['attributes']['title'] = substr($matches[2], 1, - 1); } $extent += strlen($matches[0]); } else { if (preg_match('/^\s*\[(.*?)\]/', $remainder, $matches)) { $definition = strlen($matches[1]) ? $matches[1] : $Element['text']; $definition = strtolower($definition); $extent += strlen($matches[0]); } else { $definition = strtolower($Element['text']); } if ( ! isset($this->DefinitionData['Reference'][$definition])) { return; } $Definition = $this->DefinitionData['Reference'][$definition]; $Element['attributes']['href'] = $Definition['url']; $Element['attributes']['title'] = $Definition['title']; } return array( 'extent' => $extent, 'element' => $Element, ); } protected function inlineMarkup($Excerpt) { if ($this->markupEscaped or $this->safeMode or strpos($Excerpt['text'], '>') === false) { return; } if ($Excerpt['text'][1] === '/' and preg_match('/^<\/\w[\w-]*[ ]*>/s', $Excerpt['text'], $matches)) { return array( 'markup' => $matches[0], 'extent' => strlen($matches[0]), ); } if ($Excerpt['text'][1] === '!' and preg_match('/^/s', $Excerpt['text'], $matches)) { return array( 'markup' => $matches[0], 'extent' => strlen($matches[0]), ); } if ($Excerpt['text'][1] !== ' ' and preg_match('/^<\w[\w-]*(?:[ ]*'.$this->regexHtmlAttribute.')*[ ]*\/?>/s', $Excerpt['text'], $matches)) { return array( 'markup' => $matches[0], 'extent' => strlen($matches[0]), ); } } protected function inlineSpecialCharacter($Excerpt) { if ($Excerpt['text'][0] === '&' and ! preg_match('/^&#?\w+;/', $Excerpt['text'])) { return array( 'markup' => '&', 'extent' => 1, ); } $SpecialCharacter = array('>' => 'gt', '<' => 'lt', '"' => 'quot'); if (isset($SpecialCharacter[$Excerpt['text'][0]])) { return array( 'markup' => '&'.$SpecialCharacter[$Excerpt['text'][0]].';', 'extent' => 1, ); } } protected function inlineStrikethrough($Excerpt) { if ( ! isset($Excerpt['text'][1])) { return; } if ($Excerpt['text'][1] === '~' and preg_match('/^~~(?=\S)(.+?)(?<=\S)~~/', $Excerpt['text'], $matches)) { return array( 'extent' => strlen($matches[0]), 'element' => array( 'name' => 'del', 'text' => $matches[1], 'handler' => 'line', ), ); } } protected function inlineUrl($Excerpt) { if ($this->urlsLinked !== true or ! isset($Excerpt['text'][2]) or $Excerpt['text'][2] !== '/') { return; } if (preg_match('/\bhttps?:[\/]{2}[^\s<]+\b\/*/ui', $Excerpt['context'], $matches, PREG_OFFSET_CAPTURE)) { $url = $matches[0][0]; $Inline = array( 'extent' => strlen($matches[0][0]), 'position' => $matches[0][1], 'element' => array( 'name' => 'a', 'text' => $url, 'attributes' => array( 'href' => $url, ), ), ); return $Inline; } } protected function inlineUrlTag($Excerpt) { if (strpos($Excerpt['text'], '>') !== false and preg_match('/^<(\w+:\/{2}[^ >]+)>/i', $Excerpt['text'], $matches)) { $url = $matches[1]; return array( 'extent' => strlen($matches[0]), 'element' => array( 'name' => 'a', 'text' => $url, 'attributes' => array( 'href' => $url, ), ), ); } } # ~ protected function unmarkedText($text) { if ($this->breaksEnabled) { $text = preg_replace('/[ ]*\n/', "
\n", $text); } else { $text = preg_replace('/(?:[ ][ ]+|[ ]*\\\\)\n/', "
\n", $text); $text = str_replace(" \n", "\n", $text); } return $text; } # # Handlers # protected function element(array $Element) { if ($this->safeMode) { $Element = $this->sanitiseElement($Element); } $markup = '<'.$Element['name']; if (isset($Element['attributes'])) { foreach ($Element['attributes'] as $name => $value) { if ($value === null) { continue; } $markup .= ' '.$name.'="'.self::escape($value).'"'; } } $permitRawHtml = false; if (isset($Element['text'])) { $text = $Element['text']; } // very strongly consider an alternative if you're writing an // extension elseif (isset($Element['rawHtml'])) { $text = $Element['rawHtml']; $allowRawHtmlInSafeMode = isset($Element['allowRawHtmlInSafeMode']) && $Element['allowRawHtmlInSafeMode']; $permitRawHtml = !$this->safeMode || $allowRawHtmlInSafeMode; } if (isset($text)) { $markup .= '>'; if (!isset($Element['nonNestables'])) { $Element['nonNestables'] = array(); } if (isset($Element['handler'])) { $markup .= $this->{$Element['handler']}($text, $Element['nonNestables']); } elseif (!$permitRawHtml) { $markup .= self::escape($text, true); } else { $markup .= $text; } $markup .= ''; } else { $markup .= ' />'; } return $markup; } protected function elements(array $Elements) { $markup = ''; foreach ($Elements as $Element) { $markup .= "\n" . $this->element($Element); } $markup .= "\n"; return $markup; } # ~ protected function li($lines) { $markup = $this->lines($lines); $trimmedMarkup = trim($markup); if ( ! in_array('', $lines) and substr($trimmedMarkup, 0, 3) === '

') { $markup = $trimmedMarkup; $markup = substr($markup, 3); $position = strpos($markup, "

"); $markup = substr_replace($markup, '', $position, 4); } return $markup; } # # Deprecated Methods # function parse($text) { $markup = $this->text($text); return $markup; } protected function sanitiseElement(array $Element) { static $goodAttribute = '/^[a-zA-Z0-9][a-zA-Z0-9-_]*+$/'; static $safeUrlNameToAtt = array( 'a' => 'href', 'img' => 'src', ); if (isset($safeUrlNameToAtt[$Element['name']])) { $Element = $this->filterUnsafeUrlInAttribute($Element, $safeUrlNameToAtt[$Element['name']]); } if ( ! empty($Element['attributes'])) { foreach ($Element['attributes'] as $att => $val) { # filter out badly parsed attribute if ( ! preg_match($goodAttribute, $att)) { unset($Element['attributes'][$att]); } # dump onevent attribute elseif (self::striAtStart($att, 'on')) { unset($Element['attributes'][$att]); } } } return $Element; } protected function filterUnsafeUrlInAttribute(array $Element, $attribute) { foreach ($this->safeLinksWhitelist as $scheme) { if (self::striAtStart($Element['attributes'][$attribute], $scheme)) { return $Element; } } $Element['attributes'][$attribute] = str_replace(':', '%3A', $Element['attributes'][$attribute]); return $Element; } # # Static Methods # protected static function escape($text, $allowQuotes = false) { return htmlspecialchars($text, $allowQuotes ? ENT_NOQUOTES : ENT_QUOTES, 'UTF-8'); } protected static function striAtStart($string, $needle) { $len = strlen($needle); if ($len > strlen($string)) { return false; } else { return strtolower(substr($string, 0, $len)) === strtolower($needle); } } static function instance($name = 'default') { if (isset(self::$instances[$name])) { return self::$instances[$name]; } $instance = new static(); self::$instances[$name] = $instance; return $instance; } private static $instances = array(); # # Fields # protected $DefinitionData; # # Read-Only protected $specialCharacters = array( '\\', '`', '*', '_', '{', '}', '[', ']', '(', ')', '>', '#', '+', '-', '.', '!', '|', ); protected $StrongRegex = array( '*' => '/^[*]{2}((?:\\\\\*|[^*]|[*][^*]*[*])+?)[*]{2}(?![*])/s', '_' => '/^__((?:\\\\_|[^_]|_[^_]*_)+?)__(?!_)/us', ); protected $EmRegex = array( '*' => '/^[*]((?:\\\\\*|[^*]|[*][*][^*]+?[*][*])+?)[*](?![*])/s', '_' => '/^_((?:\\\\_|[^_]|__[^_]*__)+?)_(?!_)\b/us', ); protected $regexHtmlAttribute = '[a-zA-Z_:][\w:.-]*(?:\s*=\s*(?:[^"\'=<>`\s]+|"[^"]*"|\'[^\']*\'))?'; protected $voidElements = array( 'area', 'base', 'br', 'col', 'command', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'param', 'source', ); protected $textLevelElements = array( 'a', 'br', 'bdo', 'abbr', 'blink', 'nextid', 'acronym', 'basefont', 'b', 'em', 'big', 'cite', 'small', 'spacer', 'listing', 'i', 'rp', 'del', 'code', 'strike', 'marquee', 'q', 'rt', 'ins', 'font', 'strong', 's', 'tt', 'kbd', 'mark', 'u', 'xm', 'sub', 'nobr', 'sup', 'ruby', 'var', 'span', 'wbr', 'time', ); } { "name": "erusev/parsedown", "description": "Parser for Markdown.", "keywords": ["markdown", "parser"], "homepage": "http://parsedown.org", "type": "library", "license": "MIT", "authors": [ { "name": "Emanuil Rusev", "email": "hello@erusev.com", "homepage": "http://erusev.com" } ], "require": { "php": ">=5.3.0", "ext-mbstring": "*" }, "require-dev": { "phpunit/phpunit": "^4.8.35" }, "autoload": { "psr-0": {"Parsedown": ""} }, "autoload-dev": { "psr-0": { "TestParsedown": "test/", "ParsedownTest": "test/", "CommonMarkTest": "test/", "CommonMarkTestWeak": "test/" } } } { "name": "psr/http-factory", "description": "Common interfaces for PSR-7 HTTP message factories", "keywords": [ "psr", "psr-7", "psr-17", "http", "factory", "message", "request", "response" ], "license": "MIT", "authors": [ { "name": "PHP-FIG", "homepage": "http://www.php-fig.org/" } ], "require": { "php": ">=7.0.0", "psr/http-message": "^1.0" }, "autoload": { "psr-4": { "Psr\\Http\\Message\\": "src/" } }, "extra": { "branch-alias": { "dev-master": "1.0.x-dev" } } } =5.3.0" }, "autoload": { "psr-4": { "Psr\\Http\\Message\\": "src/" } }, "extra": { "branch-alias": { "dev-master": "1.0.x-dev" } } } getHeaders() as $name => $values) { * echo $name . ": " . implode(", ", $values); * } * * // Emit headers iteratively: * foreach ($message->getHeaders() as $name => $values) { * foreach ($values as $value) { * header(sprintf('%s: %s', $name, $value), false); * } * } * * While header names are not case-sensitive, getHeaders() will preserve the * exact case in which headers were originally specified. * * @return string[][] Returns an associative array of the message's headers. Each * key MUST be a header name, and each value MUST be an array of strings * for that header. */ public function getHeaders(); /** * Checks if a header exists by the given case-insensitive name. * * @param string $name Case-insensitive header field name. * @return bool Returns true if any header names match the given header * name using a case-insensitive string comparison. Returns false if * no matching header name is found in the message. */ public function hasHeader($name); /** * Retrieves a message header value by the given case-insensitive name. * * This method returns an array of all the header values of the given * case-insensitive header name. * * If the header does not appear in the message, this method MUST return an * empty array. * * @param string $name Case-insensitive header field name. * @return string[] An array of string values as provided for the given * header. If the header does not appear in the message, this method MUST * return an empty array. */ public function getHeader($name); /** * Retrieves a comma-separated string of the values for a single header. * * This method returns all of the header values of the given * case-insensitive header name as a string concatenated together using * a comma. * * NOTE: Not all header values may be appropriately represented using * comma concatenation. For such headers, use getHeader() instead * and supply your own delimiter when concatenating. * * If the header does not appear in the message, this method MUST return * an empty string. * * @param string $name Case-insensitive header field name. * @return string A string of values as provided for the given header * concatenated together using a comma. If the header does not appear in * the message, this method MUST return an empty string. */ public function getHeaderLine($name); /** * Return an instance with the provided value replacing the specified header. * * While header names are case-insensitive, the casing of the header will * be preserved by this function, and returned from getHeaders(). * * This method MUST be implemented in such a way as to retain the * immutability of the message, and MUST return an instance that has the * new and/or updated header and value. * * @param string $name Case-insensitive header field name. * @param string|string[] $value Header value(s). * @return static * @throws \InvalidArgumentException for invalid header names or values. */ public function withHeader($name, $value); /** * Return an instance with the specified header appended with the given value. * * Existing values for the specified header will be maintained. The new * value(s) will be appended to the existing list. If the header did not * exist previously, it will be added. * * This method MUST be implemented in such a way as to retain the * immutability of the message, and MUST return an instance that has the * new header and/or value. * * @param string $name Case-insensitive header field name to add. * @param string|string[] $value Header value(s). * @return static * @throws \InvalidArgumentException for invalid header names or values. */ public function withAddedHeader($name, $value); /** * Return an instance without the specified header. * * Header resolution MUST be done without case-sensitivity. * * This method MUST be implemented in such a way as to retain the * immutability of the message, and MUST return an instance that removes * the named header. * * @param string $name Case-insensitive header field name to remove. * @return static */ public function withoutHeader($name); /** * Gets the body of the message. * * @return StreamInterface Returns the body as a stream. */ public function getBody(); /** * Return an instance with the specified message body. * * The body MUST be a StreamInterface object. * * This method MUST be implemented in such a way as to retain the * immutability of the message, and MUST return a new instance that has the * new body stream. * * @param StreamInterface $body Body. * @return static * @throws \InvalidArgumentException When the body is not valid. */ public function withBody(StreamInterface $body); } getQuery()` * or from the `QUERY_STRING` server param. * * @return array */ public function getQueryParams(); /** * Return an instance with the specified query string arguments. * * These values SHOULD remain immutable over the course of the incoming * request. They MAY be injected during instantiation, such as from PHP's * $_GET superglobal, or MAY be derived from some other value such as the * URI. In cases where the arguments are parsed from the URI, the data * MUST be compatible with what PHP's parse_str() would return for * purposes of how duplicate query parameters are handled, and how nested * sets are handled. * * Setting query string arguments MUST NOT change the URI stored by the * request, nor the values in the server params. * * This method MUST be implemented in such a way as to retain the * immutability of the message, and MUST return an instance that has the * updated query string arguments. * * @param array $query Array of query string arguments, typically from * $_GET. * @return static */ public function withQueryParams(array $query); /** * Retrieve normalized file upload data. * * This method returns upload metadata in a normalized tree, with each leaf * an instance of Psr\Http\Message\UploadedFileInterface. * * These values MAY be prepared from $_FILES or the message body during * instantiation, or MAY be injected via withUploadedFiles(). * * @return array An array tree of UploadedFileInterface instances; an empty * array MUST be returned if no data is present. */ public function getUploadedFiles(); /** * Create a new instance with the specified uploaded files. * * This method MUST be implemented in such a way as to retain the * immutability of the message, and MUST return an instance that has the * updated body parameters. * * @param array $uploadedFiles An array tree of UploadedFileInterface instances. * @return static * @throws \InvalidArgumentException if an invalid structure is provided. */ public function withUploadedFiles(array $uploadedFiles); /** * Retrieve any parameters provided in the request body. * * If the request Content-Type is either application/x-www-form-urlencoded * or multipart/form-data, and the request method is POST, this method MUST * return the contents of $_POST. * * Otherwise, this method may return any results of deserializing * the request body content; as parsing returns structured content, the * potential types MUST be arrays or objects only. A null value indicates * the absence of body content. * * @return null|array|object The deserialized body parameters, if any. * These will typically be an array or object. */ public function getParsedBody(); /** * Return an instance with the specified body parameters. * * These MAY be injected during instantiation. * * If the request Content-Type is either application/x-www-form-urlencoded * or multipart/form-data, and the request method is POST, use this method * ONLY to inject the contents of $_POST. * * The data IS NOT REQUIRED to come from $_POST, but MUST be the results of * deserializing the request body content. Deserialization/parsing returns * structured data, and, as such, this method ONLY accepts arrays or objects, * or a null value if nothing was available to parse. * * As an example, if content negotiation determines that the request data * is a JSON payload, this method could be used to create a request * instance with the deserialized parameters. * * This method MUST be implemented in such a way as to retain the * immutability of the message, and MUST return an instance that has the * updated body parameters. * * @param null|array|object $data The deserialized body data. This will * typically be in an array or object. * @return static * @throws \InvalidArgumentException if an unsupported argument type is * provided. */ public function withParsedBody($data); /** * Retrieve attributes derived from the request. * * The request "attributes" may be used to allow injection of any * parameters derived from the request: e.g., the results of path * match operations; the results of decrypting cookies; the results of * deserializing non-form-encoded message bodies; etc. Attributes * will be application and request specific, and CAN be mutable. * * @return array Attributes derived from the request. */ public function getAttributes(); /** * Retrieve a single derived request attribute. * * Retrieves a single derived request attribute as described in * getAttributes(). If the attribute has not been previously set, returns * the default value as provided. * * This method obviates the need for a hasAttribute() method, as it allows * specifying a default value to return if the attribute is not found. * * @see getAttributes() * @param string $name The attribute name. * @param mixed $default Default value to return if the attribute does not exist. * @return mixed */ public function getAttribute($name, $default = null); /** * Return an instance with the specified derived request attribute. * * This method allows setting a single derived request attribute as * described in getAttributes(). * * This method MUST be implemented in such a way as to retain the * immutability of the message, and MUST return an instance that has the * updated attribute. * * @see getAttributes() * @param string $name The attribute name. * @param mixed $value The value of the attribute. * @return static */ public function withAttribute($name, $value); /** * Return an instance that removes the specified derived request attribute. * * This method allows removing a single derived request attribute as * described in getAttributes(). * * This method MUST be implemented in such a way as to retain the * immutability of the message, and MUST return an instance that removes * the attribute. * * @see getAttributes() * @param string $name The attribute name. * @return static */ public function withoutAttribute($name); } * [user-info@]host[:port] * * * If the port component is not set or is the standard port for the current * scheme, it SHOULD NOT be included. * * @see https://tools.ietf.org/html/rfc3986#section-3.2 * @return string The URI authority, in "[user-info@]host[:port]" format. */ public function getAuthority(); /** * Retrieve the user information component of the URI. * * If no user information is present, this method MUST return an empty * string. * * If a user is present in the URI, this will return that value; * additionally, if the password is also present, it will be appended to the * user value, with a colon (":") separating the values. * * The trailing "@" character is not part of the user information and MUST * NOT be added. * * @return string The URI user information, in "username[:password]" format. */ public function getUserInfo(); /** * Retrieve the host component of the URI. * * If no host is present, this method MUST return an empty string. * * The value returned MUST be normalized to lowercase, per RFC 3986 * Section 3.2.2. * * @see http://tools.ietf.org/html/rfc3986#section-3.2.2 * @return string The URI host. */ public function getHost(); /** * Retrieve the port component of the URI. * * If a port is present, and it is non-standard for the current scheme, * this method MUST return it as an integer. If the port is the standard port * used with the current scheme, this method SHOULD return null. * * If no port is present, and no scheme is present, this method MUST return * a null value. * * If no port is present, but a scheme is present, this method MAY return * the standard port for that scheme, but SHOULD return null. * * @return null|int The URI port. */ public function getPort(); /** * Retrieve the path component of the URI. * * The path can either be empty or absolute (starting with a slash) or * rootless (not starting with a slash). Implementations MUST support all * three syntaxes. * * Normally, the empty path "" and absolute path "/" are considered equal as * defined in RFC 7230 Section 2.7.3. But this method MUST NOT automatically * do this normalization because in contexts with a trimmed base path, e.g. * the front controller, this difference becomes significant. It's the task * of the user to handle both "" and "/". * * The value returned MUST be percent-encoded, but MUST NOT double-encode * any characters. To determine what characters to encode, please refer to * RFC 3986, Sections 2 and 3.3. * * As an example, if the value should include a slash ("/") not intended as * delimiter between path segments, that value MUST be passed in encoded * form (e.g., "%2F") to the instance. * * @see https://tools.ietf.org/html/rfc3986#section-2 * @see https://tools.ietf.org/html/rfc3986#section-3.3 * @return string The URI path. */ public function getPath(); /** * Retrieve the query string of the URI. * * If no query string is present, this method MUST return an empty string. * * The leading "?" character is not part of the query and MUST NOT be * added. * * The value returned MUST be percent-encoded, but MUST NOT double-encode * any characters. To determine what characters to encode, please refer to * RFC 3986, Sections 2 and 3.4. * * As an example, if a value in a key/value pair of the query string should * include an ampersand ("&") not intended as a delimiter between values, * that value MUST be passed in encoded form (e.g., "%26") to the instance. * * @see https://tools.ietf.org/html/rfc3986#section-2 * @see https://tools.ietf.org/html/rfc3986#section-3.4 * @return string The URI query string. */ public function getQuery(); /** * Retrieve the fragment component of the URI. * * If no fragment is present, this method MUST return an empty string. * * The leading "#" character is not part of the fragment and MUST NOT be * added. * * The value returned MUST be percent-encoded, but MUST NOT double-encode * any characters. To determine what characters to encode, please refer to * RFC 3986, Sections 2 and 3.5. * * @see https://tools.ietf.org/html/rfc3986#section-2 * @see https://tools.ietf.org/html/rfc3986#section-3.5 * @return string The URI fragment. */ public function getFragment(); /** * Return an instance with the specified scheme. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified scheme. * * Implementations MUST support the schemes "http" and "https" case * insensitively, and MAY accommodate other schemes if required. * * An empty scheme is equivalent to removing the scheme. * * @param string $scheme The scheme to use with the new instance. * @return static A new instance with the specified scheme. * @throws \InvalidArgumentException for invalid or unsupported schemes. */ public function withScheme($scheme); /** * Return an instance with the specified user information. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified user information. * * Password is optional, but the user information MUST include the * user; an empty string for the user is equivalent to removing user * information. * * @param string $user The user name to use for authority. * @param null|string $password The password associated with $user. * @return static A new instance with the specified user information. */ public function withUserInfo($user, $password = null); /** * Return an instance with the specified host. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified host. * * An empty host value is equivalent to removing the host. * * @param string $host The hostname to use with the new instance. * @return static A new instance with the specified host. * @throws \InvalidArgumentException for invalid hostnames. */ public function withHost($host); /** * Return an instance with the specified port. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified port. * * Implementations MUST raise an exception for ports outside the * established TCP and UDP port ranges. * * A null value provided for the port is equivalent to removing the port * information. * * @param null|int $port The port to use with the new instance; a null value * removes the port information. * @return static A new instance with the specified port. * @throws \InvalidArgumentException for invalid ports. */ public function withPort($port); /** * Return an instance with the specified path. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified path. * * The path can either be empty or absolute (starting with a slash) or * rootless (not starting with a slash). Implementations MUST support all * three syntaxes. * * If the path is intended to be domain-relative rather than path relative then * it must begin with a slash ("/"). Paths not starting with a slash ("/") * are assumed to be relative to some base path known to the application or * consumer. * * Users can provide both encoded and decoded path characters. * Implementations ensure the correct encoding as outlined in getPath(). * * @param string $path The path to use with the new instance. * @return static A new instance with the specified path. * @throws \InvalidArgumentException for invalid paths. */ public function withPath($path); /** * Return an instance with the specified query string. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified query string. * * Users can provide both encoded and decoded query characters. * Implementations ensure the correct encoding as outlined in getQuery(). * * An empty query string value is equivalent to removing the query string. * * @param string $query The query string to use with the new instance. * @return static A new instance with the specified query string. * @throws \InvalidArgumentException for invalid query strings. */ public function withQuery($query); /** * Return an instance with the specified URI fragment. * * This method MUST retain the state of the current instance, and return * an instance that contains the specified URI fragment. * * Users can provide both encoded and decoded fragment characters. * Implementations ensure the correct encoding as outlined in getFragment(). * * An empty fragment value is equivalent to removing the fragment. * * @param string $fragment The fragment to use with the new instance. * @return static A new instance with the specified fragment. */ public function withFragment($fragment); /** * Return the string representation as a URI reference. * * Depending on which components of the URI are present, the resulting * string is either a full URI or relative reference according to RFC 3986, * Section 4.1. The method concatenates the various components of the URI, * using the appropriate delimiters: * * - If a scheme is present, it MUST be suffixed by ":". * - If an authority is present, it MUST be prefixed by "//". * - The path can be concatenated without delimiters. But there are two * cases where the path has to be adjusted to make the URI reference * valid as PHP does not allow to throw an exception in __toString(): * - If the path is rootless and an authority is present, the path MUST * be prefixed by "/". * - If the path is starting with more than one "/" and no authority is * present, the starting slashes MUST be reduced to one. * - If a query is present, it MUST be prefixed by "?". * - If a fragment is present, it MUST be prefixed by "#". * * @see http://tools.ietf.org/html/rfc3986#section-4.1 * @return string */ public function __toString(); } =8.0.0" }, "autoload": { "psr-4": { "Psr\\Log\\": "src" } }, "extra": { "branch-alias": { "dev-master": "3.x-dev" } } } logger = $logger; } } log(LogLevel::EMERGENCY, $message, $context); } /** * Action must be taken immediately. * * Example: Entire website down, database unavailable, etc. This should * trigger the SMS alerts and wake you up. * * @param string|\Stringable $message * @param array $context * * @return void */ public function alert(string|\Stringable $message, array $context = []): void { $this->log(LogLevel::ALERT, $message, $context); } /** * Critical conditions. * * Example: Application component unavailable, unexpected exception. * * @param string|\Stringable $message * @param array $context * * @return void */ public function critical(string|\Stringable $message, array $context = []): void { $this->log(LogLevel::CRITICAL, $message, $context); } /** * Runtime errors that do not require immediate action but should typically * be logged and monitored. * * @param string|\Stringable $message * @param array $context * * @return void */ public function error(string|\Stringable $message, array $context = []): void { $this->log(LogLevel::ERROR, $message, $context); } /** * Exceptional occurrences that are not errors. * * Example: Use of deprecated APIs, poor use of an API, undesirable things * that are not necessarily wrong. * * @param string|\Stringable $message * @param array $context * * @return void */ public function warning(string|\Stringable $message, array $context = []): void { $this->log(LogLevel::WARNING, $message, $context); } /** * Normal but significant events. * * @param string|\Stringable $message * @param array $context * * @return void */ public function notice(string|\Stringable $message, array $context = []): void { $this->log(LogLevel::NOTICE, $message, $context); } /** * Interesting events. * * Example: User logs in, SQL logs. * * @param string|\Stringable $message * @param array $context * * @return void */ public function info(string|\Stringable $message, array $context = []): void { $this->log(LogLevel::INFO, $message, $context); } /** * Detailed debug information. * * @param string|\Stringable $message * @param array $context * * @return void */ public function debug(string|\Stringable $message, array $context = []): void { $this->log(LogLevel::DEBUG, $message, $context); } /** * Logs with an arbitrary level. * * @param mixed $level * @param string|\Stringable $message * @param array $context * * @return void * * @throws \Psr\Log\InvalidArgumentException */ abstract public function log($level, string|\Stringable $message, array $context = []): void; } logger) { }` * blocks. */ class NullLogger extends AbstractLogger { /** * Logs with an arbitrary level. * * @param mixed $level * @param string|\Stringable $message * @param array $context * * @return void * * @throws \Psr\Log\InvalidArgumentException */ public function log($level, string|\Stringable $message, array $context = []): void { // noop } } =7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1", "ext-json": "*", "jetbrains/phpstorm-stubs": "^2019.3", "phpunit/phpunit": "^7 | ^8 | ^9", "psalm/phar": "^3.11@dev", "react/promise": "^2" }, "time": "2022-02-20T17:52:18+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "2.x-dev" } }, "installation-source": "dist", "autoload": { "files": [ "lib/functions.php", "lib/Internal/functions.php" ], "psr-4": { "Amp\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@php.net" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "A non-blocking concurrency framework for PHP applications.", "homepage": "https://amphp.org/amp", "keywords": [ "async", "asynchronous", "awaitable", "concurrency", "event", "event-loop", "future", "non-blocking", "promise" ], "support": { "irc": "irc://irc.freenode.org/amphp", "issues": "https://github.com/amphp/amp/issues", "source": "https://github.com/amphp/amp/tree/v2.6.2" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/amp" }, { "name": "amphp/byte-stream", "version": "v1.8.1", "version_normalized": "1.8.1.0", "source": { "type": "git", "url": "https://github.com/amphp/byte-stream.git", "reference": "acbd8002b3536485c997c4e019206b3f10ca15bd" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/byte-stream/zipball/acbd8002b3536485c997c4e019206b3f10ca15bd", "reference": "acbd8002b3536485c997c4e019206b3f10ca15bd", "shasum": "" }, "require": { "amphp/amp": "^2", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.4", "friendsofphp/php-cs-fixer": "^2.3", "jetbrains/phpstorm-stubs": "^2019.3", "phpunit/phpunit": "^6 || ^7 || ^8", "psalm/phar": "^3.11.4" }, "time": "2021-03-30T17:13:30+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "1.x-dev" } }, "installation-source": "dist", "autoload": { "files": [ "lib/functions.php" ], "psr-4": { "Amp\\ByteStream\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "A stream abstraction to make working with non-blocking I/O simple.", "homepage": "http://amphp.org/byte-stream", "keywords": [ "amp", "amphp", "async", "io", "non-blocking", "stream" ], "support": { "irc": "irc://irc.freenode.org/amphp", "issues": "https://github.com/amphp/byte-stream/issues", "source": "https://github.com/amphp/byte-stream/tree/v1.8.1" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/byte-stream" }, { "name": "amphp/cache", "version": "v1.5.0", "version_normalized": "1.5.0.0", "source": { "type": "git", "url": "https://github.com/amphp/cache.git", "reference": "2b6b5dbb70e54cc914df9952ba7c012bc4cbcd28" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/cache/zipball/2b6b5dbb70e54cc914df9952ba7c012bc4cbcd28", "reference": "2b6b5dbb70e54cc914df9952ba7c012bc4cbcd28", "shasum": "" }, "require": { "amphp/amp": "^2", "amphp/serialization": "^1", "amphp/sync": "^1.2", "php": ">=7.1" }, "conflict": { "amphp/file": "<0.2 || >=3" }, "require-dev": { "amphp/file": "^1 || ^2", "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1", "phpunit/phpunit": "^6 | ^7 | ^8 | ^9", "vimeo/psalm": "^4" }, "time": "2021-06-29T17:12:43+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-4": { "Amp\\Cache\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Niklas Keller", "email": "me@kelunik.com" }, { "name": "Daniel Lowrey", "email": "rdlowrey@php.net" } ], "description": "A promise-aware caching API for Amp.", "homepage": "https://github.com/amphp/cache", "support": { "irc": "irc://irc.freenode.org/amphp", "issues": "https://github.com/amphp/cache/issues", "source": "https://github.com/amphp/cache/tree/v1.5.0" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/cache" }, { "name": "amphp/dns", "version": "v1.2.3", "version_normalized": "1.2.3.0", "source": { "type": "git", "url": "https://github.com/amphp/dns.git", "reference": "852292532294d7972c729a96b49756d781f7c59d" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/dns/zipball/852292532294d7972c729a96b49756d781f7c59d", "reference": "852292532294d7972c729a96b49756d781f7c59d", "shasum": "" }, "require": { "amphp/amp": "^2", "amphp/byte-stream": "^1.1", "amphp/cache": "^1.2", "amphp/parser": "^1", "amphp/windows-registry": "^0.3", "daverandom/libdns": "^2.0.1", "ext-filter": "*", "ext-json": "*", "php": ">=7.0" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1", "phpunit/phpunit": "^6 || ^7 || ^8 || ^9" }, "time": "2020-07-21T19:04:57+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "lib/functions.php" ], "psr-4": { "Amp\\Dns\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Chris Wright", "email": "addr@daverandom.com" }, { "name": "Daniel Lowrey", "email": "rdlowrey@php.net" }, { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" } ], "description": "Async DNS resolution for Amp.", "homepage": "https://github.com/amphp/dns", "keywords": [ "amp", "amphp", "async", "client", "dns", "resolve" ], "support": { "issues": "https://github.com/amphp/dns/issues", "source": "https://github.com/amphp/dns/tree/v1.2.3" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/dns" }, { "name": "amphp/file", "version": "v2.0.4", "version_normalized": "2.0.4.0", "source": { "type": "git", "url": "https://github.com/amphp/file.git", "reference": "be639a9b1f579d3fe847ca0dcc17c7a7f5168910" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/file/zipball/be639a9b1f579d3fe847ca0dcc17c7a7f5168910", "reference": "be639a9b1f579d3fe847ca0dcc17c7a7f5168910", "shasum": "" }, "require": { "amphp/amp": "^2.5.2", "amphp/byte-stream": "^1.8.1", "amphp/parallel": "^1.4", "amphp/sync": "^1.4", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1", "ext-eio": "^2 || ^3", "ext-uv": "^0.3 || ^0.2", "phpunit/phpunit": "^9 || ^8 || ^7" }, "time": "2022-09-08T17:22:23+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "2.x-dev" } }, "installation-source": "dist", "autoload": { "files": [ "src/functions.php" ], "psr-4": { "Amp\\File\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@php.net" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "Allows non-blocking access to the filesystem for Amp.", "homepage": "https://github.com/amphp/file", "keywords": [ "amp", "amphp", "async", "disk", "file", "filesystem", "io", "non-blocking", "static" ], "support": { "issues": "https://github.com/amphp/file/issues", "source": "https://github.com/amphp/file/tree/v2.0.4" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/file" }, { "name": "amphp/hpack", "version": "v3.1.1", "version_normalized": "3.1.1.0", "source": { "type": "git", "url": "https://github.com/amphp/hpack.git", "reference": "cf4f1663e9fd58f60258c06177098655ca6377a5" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/hpack/zipball/cf4f1663e9fd58f60258c06177098655ca6377a5", "reference": "cf4f1663e9fd58f60258c06177098655ca6377a5", "shasum": "" }, "require": { "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "http2jp/hpack-test-case": "^1", "phpunit/phpunit": "^6 | ^7" }, "time": "2021-06-11T20:03:34+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "3.x-dev" } }, "installation-source": "dist", "autoload": { "psr-4": { "Amp\\Http\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@php.net" }, { "name": "Bob Weinand" }, { "name": "Niklas Keller", "email": "me@kelunik.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" } ], "description": "HTTP/2 HPack implementation.", "homepage": "https://github.com/amphp/hpack", "keywords": [ "headers", "hpack", "http-2" ], "support": { "issues": "https://github.com/amphp/hpack/issues", "source": "https://github.com/amphp/hpack/tree/v3.1.1" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/hpack" }, { "name": "amphp/http", "version": "v1.7.0", "version_normalized": "1.7.0.0", "source": { "type": "git", "url": "https://github.com/amphp/http.git", "reference": "b65454643a7e92c6f1f75e00acac0a0a676ec8be" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/http/zipball/b65454643a7e92c6f1f75e00acac0a0a676ec8be", "reference": "b65454643a7e92c6f1f75e00acac0a0a676ec8be", "shasum": "" }, "require": { "amphp/hpack": "^3", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "^2-dev", "phpunit/phpunit": "^9 || ^8 || ^7" }, "time": "2022-10-16T20:32:41+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "1.x-dev" } }, "installation-source": "dist", "autoload": { "files": [ "src/functions.php" ], "psr-4": { "Amp\\Http\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "Basic HTTP primitives which can be shared by servers and clients.", "support": { "issues": "https://github.com/amphp/http/issues", "source": "https://github.com/amphp/http/tree/v1.7.0" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/http" }, { "name": "amphp/http-client", "version": "v4.6.2", "version_normalized": "4.6.2.0", "source": { "type": "git", "url": "https://github.com/amphp/http-client.git", "reference": "453f84f623e409889168351e60246f5feddc1b3c" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/http-client/zipball/453f84f623e409889168351e60246f5feddc1b3c", "reference": "453f84f623e409889168351e60246f5feddc1b3c", "shasum": "" }, "require": { "amphp/amp": "^2.4", "amphp/byte-stream": "^1.6", "amphp/hpack": "^3", "amphp/http": "^1.6", "amphp/socket": "^1", "amphp/sync": "^1.3", "league/uri": "^6", "php": ">=7.2", "psr/http-message": "^1" }, "conflict": { "amphp/file": "<0.2 || >=3" }, "require-dev": { "amphp/file": "^0.2 || ^0.3 || ^1 || ^2", "amphp/http-server": "^2", "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1", "amphp/react-adapter": "^2.1", "clue/socks-react": "^1.0", "ext-json": "*", "kelunik/link-header-rfc5988": "^1.0", "laminas/laminas-diactoros": "^2.3", "phpunit/phpunit": "^7 || ^8 || ^9", "vimeo/psalm": "^4" }, "suggest": { "amphp/file": "Required for file request bodies and HTTP archive logging", "ext-json": "Required for logging HTTP archives", "ext-zlib": "Allows using compression for response bodies." }, "time": "2021-10-09T14:11:46+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "4.x-dev" } }, "installation-source": "dist", "autoload": { "files": [ "src/Internal/functions.php" ], "psr-4": { "Amp\\Http\\Client\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@gmail.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" } ], "description": "Asynchronous concurrent HTTP/2 and HTTP/1.1 client built on the Amp concurrency framework", "homepage": "https://github.com/amphp/http-client", "keywords": [ "async", "client", "concurrent", "http", "non-blocking", "rest" ], "support": { "issues": "https://github.com/amphp/http-client/issues", "source": "https://github.com/amphp/http-client/tree/v4.6.2" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/http-client" }, { "name": "amphp/http-client-cookies", "version": "v1.2.0", "version_normalized": "1.2.0.0", "source": { "type": "git", "url": "https://github.com/amphp/http-client-cookies.git", "reference": "ab7e498bb6c4e389e2b9880727d6470997189d87" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/http-client-cookies/zipball/ab7e498bb6c4e389e2b9880727d6470997189d87", "reference": "ab7e498bb6c4e389e2b9880727d6470997189d87", "shasum": "" }, "require": { "amphp/amp": "^2.3", "amphp/dns": "^1.2", "amphp/http": "^1.5", "amphp/http-client": "^4", "amphp/sync": "^1.3", "ext-filter": "*", "php": ">=7.2", "psr/http-message": "^1.0" }, "conflict": { "amphp/file": "<1 || >=3" }, "require-dev": { "amphp/file": "^2", "amphp/http-server": "dev-master", "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1", "amphp/socket": "^1", "friendsofphp/php-cs-fixer": "^2.3", "phpunit/phpunit": "^7 || ^8" }, "time": "2021-10-21T20:53:46+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-4": { "Amp\\Http\\Client\\Cookie\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@gmail.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "Automatic cookie handling for Amp's HTTP client.", "homepage": "https://github.com/amphp/http-client-cookies", "keywords": [ "async", "client", "cookie", "cookies", "http" ], "support": { "issues": "https://github.com/amphp/http-client-cookies/issues", "source": "https://github.com/amphp/http-client-cookies/tree/v1.2.0" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/http-client-cookies" }, { "name": "amphp/log", "version": "v1.1.0", "version_normalized": "1.1.0.0", "source": { "type": "git", "url": "https://github.com/amphp/log.git", "reference": "25dcd3b58622bd22ffa7129288edb85e0c17081a" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/log/zipball/25dcd3b58622bd22ffa7129288edb85e0c17081a", "reference": "25dcd3b58622bd22ffa7129288edb85e0c17081a", "shasum": "" }, "require": { "amphp/amp": "^2", "amphp/byte-stream": "^1.3", "monolog/monolog": "^2 || ^1.23", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1", "phpunit/phpunit": "^8 || ^7" }, "time": "2019-09-04T15:31:40+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "src/functions.php" ], "psr-4": { "Amp\\Log\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "Non-blocking logging for PHP based on Amp and Monolog.", "homepage": "https://github.com/amphp/log", "keywords": [ "amp", "amphp", "async", "log", "logger", "logging", "non-blocking" ], "support": { "issues": "https://github.com/amphp/log/issues", "source": "https://github.com/amphp/log/tree/master" }, "install-path": "../amphp/log" }, { "name": "amphp/mysql", "version": "v2.1.3", "version_normalized": "2.1.3.0", "source": { "type": "git", "url": "https://github.com/amphp/mysql.git", "reference": "dac7e7149da22ef4473c026efae5d307d8fd41b7" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/mysql/zipball/dac7e7149da22ef4473c026efae5d307d8fd41b7", "reference": "dac7e7149da22ef4473c026efae5d307d8fd41b7", "shasum": "" }, "require": { "amphp/amp": "^2", "amphp/socket": "^1", "amphp/sql": "^1", "amphp/sql-common": "^1", "php": ">=7.1" }, "require-dev": { "amphp/file": "^2 || ^1 || ^0.3.5", "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1.2", "amphp/process": "^1", "ext-openssl": "*", "phpbench/phpbench": "^0.13.0", "phpunit/phpunit": "^9 || ^8 || ^7" }, "time": "2022-09-25T20:44:16+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "src/functions.php" ], "psr-4": { "Amp\\Mysql\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" } ], "description": "Asynchronous MySQL client for PHP based on Amp.", "support": { "issues": "https://github.com/amphp/mysql/issues", "source": "https://github.com/amphp/mysql/tree/v2.1.3" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/mysql" }, { "name": "amphp/parallel", "version": "v1.4.2", "version_normalized": "1.4.2.0", "source": { "type": "git", "url": "https://github.com/amphp/parallel.git", "reference": "75853e1623efa5aa5e65e986ec9a97db573a5267" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/parallel/zipball/75853e1623efa5aa5e65e986ec9a97db573a5267", "reference": "75853e1623efa5aa5e65e986ec9a97db573a5267", "shasum": "" }, "require": { "amphp/amp": "^2", "amphp/byte-stream": "^1.6.1", "amphp/parser": "^1", "amphp/process": "^1", "amphp/serialization": "^1", "amphp/sync": "^1.0.1", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1", "phpunit/phpunit": "^8 || ^7" }, "time": "2022-12-30T00:21:42+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "lib/Context/functions.php", "lib/Sync/functions.php", "lib/Worker/functions.php" ], "psr-4": { "Amp\\Parallel\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Stephen Coakley", "email": "me@stephencoakley.com" } ], "description": "Parallel processing component for Amp.", "homepage": "https://github.com/amphp/parallel", "keywords": [ "async", "asynchronous", "concurrent", "multi-processing", "multi-threading" ], "support": { "issues": "https://github.com/amphp/parallel/issues", "source": "https://github.com/amphp/parallel/tree/v1.4.2" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/parallel" }, { "name": "amphp/parser", "version": "v1.1.0", "version_normalized": "1.1.0.0", "source": { "type": "git", "url": "https://github.com/amphp/parser.git", "reference": "ff1de4144726c5dad5fab97f66692ebe8de3e151" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/parser/zipball/ff1de4144726c5dad5fab97f66692ebe8de3e151", "reference": "ff1de4144726c5dad5fab97f66692ebe8de3e151", "shasum": "" }, "require": { "php": ">=7.4" }, "require-dev": { "amphp/php-cs-fixer-config": "^2", "phpunit/phpunit": "^9", "psalm/phar": "^5.4" }, "time": "2022-12-30T18:08:47+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-4": { "Amp\\Parser\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "A generator parser to make streaming parsers simple.", "homepage": "https://github.com/amphp/parser", "keywords": [ "async", "non-blocking", "parser", "stream" ], "support": { "issues": "https://github.com/amphp/parser/issues", "source": "https://github.com/amphp/parser/tree/v1.1.0" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/parser" }, { "name": "amphp/postgres", "version": "v1.4.4", "version_normalized": "1.4.4.0", "source": { "type": "git", "url": "https://github.com/amphp/postgres.git", "reference": "c3d249063c2b283d9d4aab206b0fbf88401e9a26" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/postgres/zipball/c3d249063c2b283d9d4aab206b0fbf88401e9a26", "reference": "c3d249063c2b283d9d4aab206b0fbf88401e9a26", "shasum": "" }, "require": { "amphp/amp": "^2", "amphp/sql": "^1", "amphp/sql-common": "^1", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1.2", "ext-pgsql": "*", "ext-pq": "*", "phpunit/phpunit": "^8 | ^7" }, "time": "2022-12-18T22:57:26+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "src/functions.php", "src/Internal/functions.php" ], "psr-4": { "Amp\\Postgres\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" } ], "description": "Asynchronous PostgreSQL client for Amp.", "homepage": "http://amphp.org", "keywords": [ "async", "asynchronous", "database", "db", "pgsql", "postgre", "postgresql" ], "support": { "issues": "https://github.com/amphp/postgres/issues", "source": "https://github.com/amphp/postgres/tree/v1.4.4" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/postgres" }, { "name": "amphp/process", "version": "v1.1.4", "version_normalized": "1.1.4.0", "source": { "type": "git", "url": "https://github.com/amphp/process.git", "reference": "76e9495fd6818b43a20167cb11d8a67f7744ee0f" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/process/zipball/76e9495fd6818b43a20167cb11d8a67f7744ee0f", "reference": "76e9495fd6818b43a20167cb11d8a67f7744ee0f", "shasum": "" }, "require": { "amphp/amp": "^2", "amphp/byte-stream": "^1.4", "php": ">=7" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1", "phpunit/phpunit": "^6" }, "time": "2022-07-06T23:50:12+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "lib/functions.php" ], "psr-4": { "Amp\\Process\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "Asynchronous process manager.", "homepage": "https://github.com/amphp/process", "support": { "issues": "https://github.com/amphp/process/issues", "source": "https://github.com/amphp/process/tree/v1.1.4" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/process" }, { "name": "amphp/redis", "version": "v1.0.7", "version_normalized": "1.0.7.0", "source": { "type": "git", "url": "https://github.com/amphp/redis.git", "reference": "90aa4f50d7889a880d15e6e4a504b398e16faa82" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/redis/zipball/90aa4f50d7889a880d15e6e4a504b398e16faa82", "reference": "90aa4f50d7889a880d15e6e4a504b398e16faa82", "shasum": "" }, "require": { "amphp/amp": "^2.2.1", "amphp/cache": "^1.2.1", "amphp/socket": "^1", "amphp/sync": "^1.1", "league/uri-parser": "^1.4", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1.2", "phpunit/phpunit": "^7 | ^8" }, "time": "2022-01-11T16:03:42+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "src/functions.php" ], "psr-4": { "Amp\\Redis\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "A non-blocking Redis client for Amp.", "homepage": "https://github.com/amphp/redis", "keywords": [ "amp", "amphp", "async", "client", "redis" ], "support": { "issues": "https://github.com/amphp/redis/issues", "source": "https://github.com/amphp/redis/tree/v1.0.7" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/redis" }, { "name": "amphp/serialization", "version": "v1.0.0", "version_normalized": "1.0.0.0", "source": { "type": "git", "url": "https://github.com/amphp/serialization.git", "reference": "693e77b2fb0b266c3c7d622317f881de44ae94a1" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/serialization/zipball/693e77b2fb0b266c3c7d622317f881de44ae94a1", "reference": "693e77b2fb0b266c3c7d622317f881de44ae94a1", "shasum": "" }, "require": { "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "phpunit/phpunit": "^9 || ^8 || ^7" }, "time": "2020-03-25T21:39:07+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "src/functions.php" ], "psr-4": { "Amp\\Serialization\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "Serialization tools for IPC and data storage in PHP.", "homepage": "https://github.com/amphp/serialization", "keywords": [ "async", "asynchronous", "serialization", "serialize" ], "support": { "issues": "https://github.com/amphp/serialization/issues", "source": "https://github.com/amphp/serialization/tree/master" }, "install-path": "../amphp/serialization" }, { "name": "amphp/socket", "version": "v1.2.0", "version_normalized": "1.2.0.0", "source": { "type": "git", "url": "https://github.com/amphp/socket.git", "reference": "a8af9f5d0a66c5fe9567da45a51509e592788fe6" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/socket/zipball/a8af9f5d0a66c5fe9567da45a51509e592788fe6", "reference": "a8af9f5d0a66c5fe9567da45a51509e592788fe6", "shasum": "" }, "require": { "amphp/amp": "^2", "amphp/byte-stream": "^1.6", "amphp/dns": "^1 || ^0.9", "ext-openssl": "*", "kelunik/certificate": "^1.1", "league/uri-parser": "^1.4", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1", "phpunit/phpunit": "^6 || ^7 || ^8", "vimeo/psalm": "^3.9@dev" }, "time": "2021-07-09T18:18:48+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "1.x-dev" } }, "installation-source": "dist", "autoload": { "files": [ "src/functions.php", "src/Internal/functions.php" ], "psr-4": { "Amp\\Socket\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@gmail.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "Async socket connection / server tools for Amp.", "homepage": "https://github.com/amphp/socket", "keywords": [ "amp", "async", "encryption", "non-blocking", "sockets", "tcp", "tls" ], "support": { "issues": "https://github.com/amphp/socket/issues", "source": "https://github.com/amphp/socket/tree/v1.2.0" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/socket" }, { "name": "amphp/sql", "version": "v1.0.2", "version_normalized": "1.0.2.0", "source": { "type": "git", "url": "https://github.com/amphp/sql.git", "reference": "5a1dcfd9a3c3518826c616b4d0b0fa0363f087fa" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/sql/zipball/5a1dcfd9a3c3518826c616b4d0b0fa0363f087fa", "reference": "5a1dcfd9a3c3518826c616b4d0b0fa0363f087fa", "shasum": "" }, "require": { "amphp/amp": "^2", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "phpunit/phpunit": "^8" }, "time": "2022-12-18T22:54:18+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-4": { "Amp\\Sql\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "description": "Asynchronous SQL client for Amp.", "homepage": "http://amphp.org", "keywords": [ "async", "asynchronous", "database", "db", "sql" ], "support": { "issues": "https://github.com/amphp/sql/issues", "source": "https://github.com/amphp/sql/tree/v1.0.2" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/sql" }, { "name": "amphp/sql-common", "version": "v1.1.4", "version_normalized": "1.1.4.0", "source": { "type": "git", "url": "https://github.com/amphp/sql-common.git", "reference": "6ed5b96d26528bd56213ebb867a2992e7a0b8278" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/sql-common/zipball/6ed5b96d26528bd56213ebb867a2992e7a0b8278", "reference": "6ed5b96d26528bd56213ebb867a2992e7a0b8278", "shasum": "" }, "require": { "amphp/amp": "^2", "amphp/sql": "^1", "php": ">=7" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.3", "phpunit/phpunit": "^6 || ^7 || ^8 || ^9" }, "time": "2023-01-06T04:22:36+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-4": { "Amp\\Sql\\Common\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "description": "Common classes for non-blocking SQL implementations.", "homepage": "http://amphp.org", "keywords": [ "async", "asynchronous", "database", "db", "sql" ], "support": { "issues": "https://github.com/amphp/sql-common/issues", "source": "https://github.com/amphp/sql-common/tree/v1.1.4" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/sql-common" }, { "name": "amphp/sync", "version": "v1.4.2", "version_normalized": "1.4.2.0", "source": { "type": "git", "url": "https://github.com/amphp/sync.git", "reference": "85ab06764f4f36d63b1356b466df6111cf4b89cf" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/sync/zipball/85ab06764f4f36d63b1356b466df6111cf4b89cf", "reference": "85ab06764f4f36d63b1356b466df6111cf4b89cf", "shasum": "" }, "require": { "amphp/amp": "^2.2", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1", "phpunit/phpunit": "^9 || ^8 || ^7" }, "time": "2021-10-25T18:29:10+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "src/functions.php", "src/ConcurrentIterator/functions.php" ], "psr-4": { "Amp\\Sync\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Stephen Coakley", "email": "me@stephencoakley.com" } ], "description": "Mutex, Semaphore, and other synchronization tools for Amp.", "homepage": "https://github.com/amphp/sync", "keywords": [ "async", "asynchronous", "mutex", "semaphore", "synchronization" ], "support": { "issues": "https://github.com/amphp/sync/issues", "source": "https://github.com/amphp/sync/tree/v1.4.2" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/sync" }, { "name": "amphp/websocket", "version": "v1.0.3", "version_normalized": "1.0.3.0", "source": { "type": "git", "url": "https://github.com/amphp/websocket.git", "reference": "248e9dc1be0477932cd1788e5002b0aabf66f179" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/websocket/zipball/248e9dc1be0477932cd1788e5002b0aabf66f179", "reference": "248e9dc1be0477932cd1788e5002b0aabf66f179", "shasum": "" }, "require": { "amphp/amp": "^2.2", "amphp/byte-stream": "^1.6.1", "amphp/socket": "^1", "cash/lrucache": "^1", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1.2", "phpunit/phpunit": "^8 || ^7", "vimeo/psalm": "^3.11@dev" }, "suggest": { "ext-zlib": "Required for compression" }, "time": "2022-04-11T23:45:31+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "src/functions.php" ], "psr-4": { "Amp\\Websocket\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" }, { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" } ], "description": "Shared code for websocket servers and clients.", "homepage": "https://github.com/amphp/websocket", "keywords": [ "amp", "amphp", "async", "http", "non-blocking", "websocket" ], "support": { "issues": "https://github.com/amphp/websocket/issues", "source": "https://github.com/amphp/websocket/tree/v1.0.3" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/websocket" }, { "name": "amphp/websocket-client", "version": "v1.0.1", "version_normalized": "1.0.1.0", "source": { "type": "git", "url": "https://github.com/amphp/websocket-client.git", "reference": "bcf5262e66abec420896a7893b7a08e9e2e655e8" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/websocket-client/zipball/bcf5262e66abec420896a7893b7a08e9e2e655e8", "reference": "bcf5262e66abec420896a7893b7a08e9e2e655e8", "shasum": "" }, "require": { "amphp/amp": "^2.2", "amphp/http": "^1.3", "amphp/http-client": "^4", "amphp/socket": "^1", "amphp/websocket": "^1", "league/uri": "^6", "php": ">=7.2", "psr/http-message": "^1" }, "require-dev": { "amphp/http-server": "^2", "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.1", "amphp/websocket-server": "dev-master as 2.0-rc4", "phpunit/phpunit": "^8 || ^7", "psr/log": "^1", "vimeo/psalm": "^3.11@dev" }, "time": "2022-03-10T09:54:59+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "src/functions.php" ], "psr-4": { "Amp\\Websocket\\Client\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "Async WebSocket client for PHP based on Amp.", "keywords": [ "amp", "amphp", "async", "client", "http", "non-blocking", "websocket" ], "support": { "issues": "https://github.com/amphp/websocket-client/issues", "source": "https://github.com/amphp/websocket-client/tree/v1.0.1" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/websocket-client" }, { "name": "amphp/windows-registry", "version": "v0.3.3", "version_normalized": "0.3.3.0", "source": { "type": "git", "url": "https://github.com/amphp/windows-registry.git", "reference": "0f56438b9197e224325e88f305346f0221df1f71" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/amphp/windows-registry/zipball/0f56438b9197e224325e88f305346f0221df1f71", "reference": "0f56438b9197e224325e88f305346f0221df1f71", "shasum": "" }, "require": { "amphp/amp": "^2", "amphp/byte-stream": "^1.4", "amphp/process": "^1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master" }, "time": "2020-07-10T16:13:29+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-4": { "Amp\\WindowsRegistry\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "Windows Registry Reader.", "support": { "issues": "https://github.com/amphp/windows-registry/issues", "source": "https://github.com/amphp/windows-registry/tree/master" }, "funding": [ { "url": "https://github.com/amphp", "type": "github" } ], "install-path": "../amphp/windows-registry" }, { "name": "cash/lrucache", "version": "1.0.0", "version_normalized": "1.0.0.0", "source": { "type": "git", "url": "https://github.com/cash/LRUCache.git", "reference": "4fa4c6834cec59690b43526c4da41d6153026289" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/cash/LRUCache/zipball/4fa4c6834cec59690b43526c4da41d6153026289", "reference": "4fa4c6834cec59690b43526c4da41d6153026289", "shasum": "" }, "require": { "php": ">=5.3.0" }, "time": "2013-09-20T18:59:12+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-0": { "cash": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Cash Costello", "email": "cash.costello@gmail.com" } ], "description": "An efficient memory-based Least Recently Used (LRU) cache", "homepage": "https://github.com/cash/LRUCache", "keywords": [ "cache", "lru" ], "support": { "issues": "https://github.com/cash/LRUCache/issues", "source": "https://github.com/cash/LRUCache/tree/1.0.0" }, "install-path": "../cash/lrucache" }, { "name": "danog/dns-over-https", "version": "0.2.6", "version_normalized": "0.2.6.0", "source": { "type": "git", "url": "https://github.com/danog/dns-over-https.git", "reference": "a288be1f4fdd4ce9838e98bfa96407fcfdd099b3" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/danog/dns-over-https/zipball/a288be1f4fdd4ce9838e98bfa96407fcfdd099b3", "reference": "a288be1f4fdd4ce9838e98bfa96407fcfdd099b3", "shasum": "" }, "require": { "amphp/amp": "^2", "amphp/cache": "^1", "amphp/dns": "^1", "amphp/http-client": "^4", "amphp/parser": "^1", "danog/libdns-json": "^0.1", "daverandom/libdns": "^2.0.1", "ext-filter": "*", "ext-json": "*", "php": ">=7.0" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1", "phpunit/phpunit": "^6" }, "time": "2019-12-27T14:35:55+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-4": { "Amp\\DoH\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" }, { "name": "Chris Wright", "email": "addr@daverandom.com" }, { "name": "Daniel Lowrey", "email": "rdlowrey@php.net" }, { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" } ], "description": "Async DNS-over-HTTPS resolution for Amp.", "homepage": "https://github.com/danog/dns-over-https", "keywords": [ "amp", "amphp", "async", "client", "dns", "dns-over-https", "doh", "https", "resolve" ], "support": { "issues": "https://github.com/danog/dns-over-https/issues", "source": "https://github.com/danog/dns-over-https/tree/0.2.6" }, "install-path": "../danog/dns-over-https" }, { "name": "danog/ipc", "version": "0.1.15", "version_normalized": "0.1.15.0", "source": { "type": "git", "url": "https://github.com/danog/ipc.git", "reference": "6bbd35f057746dba2baad58465fca1a93302bf67" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/danog/ipc/zipball/6bbd35f057746dba2baad58465fca1a93302bf67", "reference": "6bbd35f057746dba2baad58465fca1a93302bf67", "shasum": "" }, "require": { "amphp/byte-stream": "^1", "amphp/parser": "^1", "php": ">=7.1" }, "require-dev": { "amphp/amp": "^2.4", "amphp/parallel": "^1.3", "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.3", "phpunit/phpunit": "^7 | ^8 | ^9" }, "time": "2021-09-24T16:32:52+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "lib/functions.php" ], "psr-4": { "Amp\\Ipc\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Stephen Coakley", "email": "me@stephencoakley.com" } ], "description": "IPC component for Amp.", "homepage": "https://github.com/danog/ipc", "keywords": [ "async", "asynchronous", "concurrent", "multi-processing", "multi-threading" ], "support": { "issues": "https://github.com/danog/ipc/issues", "source": "https://github.com/danog/ipc/tree/0.1.15" }, "install-path": "../danog/ipc" }, { "name": "danog/libdns-json", "version": "0.1.1", "version_normalized": "0.1.1.0", "source": { "type": "git", "url": "https://github.com/danog/LibDNSJson.git", "reference": "7d5e07815d57afa64ef7cdbe1a65fbead9a3e7bd" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/danog/LibDNSJson/zipball/7d5e07815d57afa64ef7cdbe1a65fbead9a3e7bd", "reference": "7d5e07815d57afa64ef7cdbe1a65fbead9a3e7bd", "shasum": "" }, "require": { "daverandom/libdns": "^2.0.1", "ext-json": "*", "php": ">=7.0" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "phpunit/phpunit": "^6" }, "time": "2019-07-14T14:59:51+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-4": { "danog\\LibDNSJson\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Chris Wright", "email": "addr@daverandom.com" }, { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "description": "Encoder/decoder for google's JSON DNS message format based on libdns", "homepage": "https://github.com/danog/libdns-json", "keywords": [ "dns", "dns-over-https", "doh", "https", "json", "libdns", "message" ], "support": { "issues": "https://github.com/danog/LibDNSJson/issues", "source": "https://github.com/danog/LibDNSJson/tree/master" }, "install-path": "../danog/libdns-json" }, { "name": "danog/loop", "version": "0.1.1", "version_normalized": "0.1.1.0", "source": { "type": "git", "url": "https://github.com/danog/loop.git", "reference": "b1941cc6a7b2eede57d11a6ead464ee70793bc3f" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/danog/loop/zipball/b1941cc6a7b2eede57d11a6ead464ee70793bc3f", "reference": "b1941cc6a7b2eede57d11a6ead464ee70793bc3f", "shasum": "" }, "require": { "amphp/amp": "^2", "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.3", "phpunit/phpunit": "^7 | ^8 | ^9", "vimeo/psalm": "dev-master" }, "time": "2021-04-21T13:41:15+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-4": { "danog\\Loop\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "description": "Loop abstraction for AMPHP.", "homepage": "https://github.com/danog/loop", "keywords": [ "async", "asynchronous", "concurrent", "multi-processing", "multi-threading" ], "support": { "issues": "https://github.com/danog/loop/issues", "source": "https://github.com/danog/loop/tree/0.1.1" }, "funding": [ { "url": "https://github.com/danog", "type": "github" } ], "install-path": "../danog/loop" }, { "name": "danog/madelineproto", "version": "7.0.148", "version_normalized": "7.0.148.0", "dist": { "type": "path", "url": "/woodpecker/src/gitea.daniil.it/danog/MadelineProto", "reference": "2b618e0557f937060a5931088fcde3bee24dfde7" }, "require": { "amphp/amp": "^2", "amphp/byte-stream": "^1", "amphp/dns": "^1", "amphp/file": "^2", "amphp/http-client": "^4", "amphp/http-client-cookies": "^1", "amphp/log": "^1.1", "amphp/mysql": "^2", "amphp/postgres": "^1.2", "amphp/redis": "^1.0", "amphp/socket": "^1", "amphp/websocket-client": "^1.0", "danog/dns-over-https": "^0.2", "danog/ipc": "^0.1", "danog/loop": "^0.1.0", "danog/magicalserializer": "^1.0", "danog/primemodule": "^1", "danog/tg-file-decoder": "^0.1", "erusev/parsedown": "^1.7", "ext-dom": "*", "ext-fileinfo": "*", "ext-filter": "*", "ext-hash": "*", "ext-json": "*", "ext-mbstring": "*", "ext-xml": "*", "ext-zlib": "*", "league/uri": "^6", "php-64bit": ">=8.1", "phpseclib/phpseclib": "^3", "psr/http-factory": "^1.0", "psr/log": "^1|^2|^3", "symfony/polyfill-mbstring": "*", "symfony/polyfill-php80": "^1.18", "webmozart/assert": "^1.11" }, "conflict": { "ext-pthreads": "*", "krakjoe/pthreads-polyfill": "*" }, "require-dev": { "bamarni/composer-bin-plugin": "1.5.0", "danog/phpdoc": "^0.1.7", "ext-ctype": "*", "phpdocumentor/reflection-docblock": "^5.2", "phpunit/phpunit": "^9", "roave/security-advisories": "dev-latest", "symfony/yaml": "^6.0" }, "suggest": { "ext-ffi": "Install the primemodule and FFI extensions to speed up MadelineProto (https://prime.madelineproto.xyz)", "ext-gmp": "Install the gmp extension for faster crypto", "ext-openssl": "Install the openssl extension for faster crypto", "ext-pdo": "Install pdo extension to support database used as cache", "ext-primemodule": "Install the primemodule and FFI extensions to speed up MadelineProto (https://prime.madelineproto.xyz)" }, "type": "project", "extra": { "phabel": { "revision": 0 } }, "installation-source": "dist", "autoload": { "psr-4": { "danog\\MadelineProto\\": "src/danog/MadelineProto" }, "files": [ "src/BigIntegor.php", "src/polyfill.php" ] }, "autoload-dev": { "psr-4": { "danog\\MadelineProto\\Test\\": "tests/danog/MadelineProto" }, "files": [ "tools/build_docs/schemas.php", "tools/build_docs/merge.php", "tools/build_docs/layerUpgrade.php" ] }, "scripts": { "build": [ "@docs", "@phpdoc", "@docs-fix", "@cs-fix", "@psalm" ], "phpdoc": [ "@phpdocInternal", "@phpdocMain" ], "check": [ "@cs", "@test" ], "test-php7": [ "tests/test-conversion.sh 70" ], "test-php56": [ "tests/test-conversion.sh 5" ], "cs": [ "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff --dry-run" ], "cs-fix": [ "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff" ], "psalm": [ "psalm" ], "phpdocMain": [ "php tools/phpdoc.php" ], "docs": [ "php tools/build_docs.php" ], "docs-fix": [ "tools/fix_docs.sh" ], "test": [ "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text --config tests/phpunit.xml" ], "bin": [ "echo 'bin not installed'" ], "post-install-cmd": [ "@composer bin all install --ansi" ], "post-update-cmd": [ "@composer bin all update --ansi" ] }, "license": [ "AGPL-3.0-only" ], "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "description": "PHP implementation of telegram's MTProto protocol.", "homepage": "https://docs.madelineproto.xyz", "keywords": [ "GB", "PHP", "audio", "bytes", "client", "files", "messenger", "mtproto", "protocol", "stickers", "telegram", "video" ], "transport-options": { "symlink": false, "relative": false }, "install-path": "../danog/madelineproto" }, { "name": "danog/magicalserializer", "version": "1.0", "version_normalized": "1.0.0.0", "source": { "type": "git", "url": "https://github.com/danog/MagicalSerializer.git", "reference": "87b6ed05a86021e9364f31133089bb83980d5e24" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/danog/MagicalSerializer/zipball/87b6ed05a86021e9364f31133089bb83980d5e24", "reference": "87b6ed05a86021e9364f31133089bb83980d5e24", "shasum": "" }, "time": "2018-02-20T10:35:49+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-0": { "danog\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "AGPL-3.0-only" ], "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "description": "Serialize Volatile, Threaded or any other internal PHP class!", "homepage": "https://daniil.it/MagicalSerializer", "keywords": [ "pthreads", "serializable", "serialize", "threading", "volatile" ], "support": { "issues": "https://github.com/danog/MagicalSerializer/issues", "source": "https://github.com/danog/MagicalSerializer/tree/master" }, "install-path": "../danog/magicalserializer" }, { "name": "danog/primemodule", "version": "1.0.11.9999", "version_normalized": "1.0.11.9999", "source": { "type": "git", "url": "https://github.com/danog/PrimeModule.git", "reference": "2328b1ec43b4a2a318602f4b16d6bf628ca96d04" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/danog/PrimeModule/zipball/2328b1ec43b4a2a318602f4b16d6bf628ca96d04", "reference": "2328b1ec43b4a2a318602f4b16d6bf628ca96d04", "shasum": "" }, "require": { "php": "^8.0" }, "require-dev": { "phabel/phabel": "^1" }, "suggest": { "ext-primemodule": "Install the native C++ extension for extremely fast factorization (https://prime.madelineproto.xyz)" }, "time": "2022-12-03T20:53:15+00:00", "type": "library", "extra": { "phabel": { "revision": 0 } }, "installation-source": "dist", "autoload": { "psr-0": { "danog\\": "lib/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "AGPL-3.0-only" ], "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "description": "Prime module capable of doing prime factorization of huge numbers very quickly.\"", "support": { "issues": "https://github.com/danog/PrimeModule/issues", "source": "https://github.com/danog/PrimeModule/tree/1.0.11.9999" }, "install-path": "../danog/primemodule" }, { "name": "danog/tg-file-decoder", "version": "0.1.12", "version_normalized": "0.1.12.0", "source": { "type": "git", "url": "https://github.com/danog/tg-file-decoder.git", "reference": "fd9827e7af8f3b47dc6db4b1c12bfeb6654dde4f" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/danog/tg-file-decoder/zipball/fd9827e7af8f3b47dc6db4b1c12bfeb6654dde4f", "reference": "fd9827e7af8f3b47dc6db4b1c12bfeb6654dde4f", "shasum": "" }, "require": { "php": ">=8.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "phpunit/phpunit": "^9" }, "time": "2022-11-16T16:22:45+00:00", "type": "project", "installation-source": "dist", "autoload": { "files": [ "src/type.php" ], "psr-4": { "danog\\Decoder\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "AGPL-3.0-only" ], "authors": [ { "name": "Daniil Gentili", "email": "daniil@daniil.it" } ], "description": "Decode Telegram bot API file IDs", "keywords": [ "audio", "bot api", "file ID", "files", "mtproto", "stickers", "telegram", "video" ], "support": { "issues": "https://github.com/danog/tg-file-decoder/issues", "source": "https://github.com/danog/tg-file-decoder/tree/0.1.12" }, "funding": [ { "url": "https://github.com/danog", "type": "github" } ], "install-path": "../danog/tg-file-decoder" }, { "name": "daverandom/libdns", "version": "v2.0.3", "version_normalized": "2.0.3.0", "source": { "type": "git", "url": "https://github.com/DaveRandom/LibDNS.git", "reference": "42c2d700d1178c9f9e78664793463f7f1aea248c" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/DaveRandom/LibDNS/zipball/42c2d700d1178c9f9e78664793463f7f1aea248c", "reference": "42c2d700d1178c9f9e78664793463f7f1aea248c", "shasum": "" }, "require": { "ext-ctype": "*", "php": ">=7.0" }, "suggest": { "ext-intl": "Required for IDN support" }, "time": "2022-09-20T18:15:38+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "src/functions.php" ], "psr-4": { "LibDNS\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "description": "DNS protocol implementation written in pure PHP", "keywords": [ "dns" ], "support": { "issues": "https://github.com/DaveRandom/LibDNS/issues", "source": "https://github.com/DaveRandom/LibDNS/tree/v2.0.3" }, "install-path": "../daverandom/libdns" }, { "name": "erusev/parsedown", "version": "1.7.4", "version_normalized": "1.7.4.0", "source": { "type": "git", "url": "https://github.com/erusev/parsedown.git", "reference": "cb17b6477dfff935958ba01325f2e8a2bfa6dab3" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/erusev/parsedown/zipball/cb17b6477dfff935958ba01325f2e8a2bfa6dab3", "reference": "cb17b6477dfff935958ba01325f2e8a2bfa6dab3", "shasum": "" }, "require": { "ext-mbstring": "*", "php": ">=5.3.0" }, "require-dev": { "phpunit/phpunit": "^4.8.35" }, "time": "2019-12-30T22:54:17+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-0": { "Parsedown": "" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Emanuil Rusev", "email": "hello@erusev.com", "homepage": "http://erusev.com" } ], "description": "Parser for Markdown.", "homepage": "http://parsedown.org", "keywords": [ "markdown", "parser" ], "support": { "issues": "https://github.com/erusev/parsedown/issues", "source": "https://github.com/erusev/parsedown/tree/1.7.x" }, "install-path": "../erusev/parsedown" }, { "name": "kelunik/certificate", "version": "v1.1.2", "version_normalized": "1.1.2.0", "source": { "type": "git", "url": "https://github.com/kelunik/certificate.git", "reference": "56542e62d51533d04d0a9713261fea546bff80f6" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/kelunik/certificate/zipball/56542e62d51533d04d0a9713261fea546bff80f6", "reference": "56542e62d51533d04d0a9713261fea546bff80f6", "shasum": "" }, "require": { "ext-openssl": "*", "php": ">=5.4" }, "require-dev": { "fabpot/php-cs-fixer": "^1.9", "phpunit/phpunit": "^4.8" }, "time": "2019-05-29T19:02:31+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-4": { "Kelunik\\Certificate\\": "lib" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "description": "Access certificate details and transform between different formats.", "keywords": [ "DER", "certificate", "certificates", "openssl", "pem", "x509" ], "support": { "issues": "https://github.com/kelunik/certificate/issues", "source": "https://github.com/kelunik/certificate/tree/v1.1.2" }, "install-path": "../kelunik/certificate" }, { "name": "league/uri", "version": "6.8.0", "version_normalized": "6.8.0.0", "source": { "type": "git", "url": "https://github.com/thephpleague/uri.git", "reference": "a700b4656e4c54371b799ac61e300ab25a2d1d39" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/thephpleague/uri/zipball/a700b4656e4c54371b799ac61e300ab25a2d1d39", "reference": "a700b4656e4c54371b799ac61e300ab25a2d1d39", "shasum": "" }, "require": { "ext-json": "*", "league/uri-interfaces": "^2.3", "php": "^8.1", "psr/http-message": "^1.0.1" }, "conflict": { "league/uri-schemes": "^1.0" }, "require-dev": { "friendsofphp/php-cs-fixer": "^v3.9.5", "nyholm/psr7": "^1.5.1", "php-http/psr7-integration-tests": "^1.1.1", "phpbench/phpbench": "^1.2.6", "phpstan/phpstan": "^1.8.5", "phpstan/phpstan-deprecation-rules": "^1.0", "phpstan/phpstan-phpunit": "^1.1.1", "phpstan/phpstan-strict-rules": "^1.4.3", "phpunit/phpunit": "^9.5.24", "psr/http-factory": "^1.0.1" }, "suggest": { "ext-fileinfo": "Needed to create Data URI from a filepath", "ext-intl": "Needed to improve host validation", "league/uri-components": "Needed to easily manipulate URI objects", "psr/http-factory": "Needed to use the URI factory" }, "time": "2022-09-13T19:58:47+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "6.x-dev" } }, "installation-source": "dist", "autoload": { "psr-4": { "League\\Uri\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Ignace Nyamagana Butera", "email": "nyamsprod@gmail.com", "homepage": "https://nyamsprod.com" } ], "description": "URI manipulation library", "homepage": "https://uri.thephpleague.com", "keywords": [ "data-uri", "file-uri", "ftp", "hostname", "http", "https", "middleware", "parse_str", "parse_url", "psr-7", "query-string", "querystring", "rfc3986", "rfc3987", "rfc6570", "uri", "uri-template", "url", "ws" ], "support": { "docs": "https://uri.thephpleague.com", "forum": "https://thephpleague.slack.com", "issues": "https://github.com/thephpleague/uri/issues", "source": "https://github.com/thephpleague/uri/tree/6.8.0" }, "funding": [ { "url": "https://github.com/sponsors/nyamsprod", "type": "github" } ], "install-path": "../league/uri" }, { "name": "league/uri-interfaces", "version": "2.3.0", "version_normalized": "2.3.0.0", "source": { "type": "git", "url": "https://github.com/thephpleague/uri-interfaces.git", "reference": "00e7e2943f76d8cb50c7dfdc2f6dee356e15e383" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/thephpleague/uri-interfaces/zipball/00e7e2943f76d8cb50c7dfdc2f6dee356e15e383", "reference": "00e7e2943f76d8cb50c7dfdc2f6dee356e15e383", "shasum": "" }, "require": { "ext-json": "*", "php": "^7.2 || ^8.0" }, "require-dev": { "friendsofphp/php-cs-fixer": "^2.19", "phpstan/phpstan": "^0.12.90", "phpstan/phpstan-phpunit": "^0.12.19", "phpstan/phpstan-strict-rules": "^0.12.9", "phpunit/phpunit": "^8.5.15 || ^9.5" }, "suggest": { "ext-intl": "to use the IDNA feature", "symfony/intl": "to use the IDNA feature via Symfony Polyfill" }, "time": "2021-06-28T04:27:21+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "2.x-dev" } }, "installation-source": "dist", "autoload": { "psr-4": { "League\\Uri\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Ignace Nyamagana Butera", "email": "nyamsprod@gmail.com", "homepage": "https://nyamsprod.com" } ], "description": "Common interface for URI representation", "homepage": "http://github.com/thephpleague/uri-interfaces", "keywords": [ "rfc3986", "rfc3987", "uri", "url" ], "support": { "issues": "https://github.com/thephpleague/uri-interfaces/issues", "source": "https://github.com/thephpleague/uri-interfaces/tree/2.3.0" }, "funding": [ { "url": "https://github.com/sponsors/nyamsprod", "type": "github" } ], "install-path": "../league/uri-interfaces" }, { "name": "league/uri-parser", "version": "1.4.1", "version_normalized": "1.4.1.0", "source": { "type": "git", "url": "https://github.com/thephpleague/uri-parser.git", "reference": "671548427e4c932352d9b9279fdfa345bf63fa00" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/thephpleague/uri-parser/zipball/671548427e4c932352d9b9279fdfa345bf63fa00", "reference": "671548427e4c932352d9b9279fdfa345bf63fa00", "shasum": "" }, "require": { "php": ">=7.0.0" }, "require-dev": { "friendsofphp/php-cs-fixer": "^2.0", "phpstan/phpstan": "^0.9.2", "phpstan/phpstan-phpunit": "^0.9.4", "phpstan/phpstan-strict-rules": "^0.9.0", "phpunit/phpunit": "^6.0" }, "suggest": { "ext-intl": "Allow parsing RFC3987 compliant hosts", "league/uri-schemes": "Allow validating and normalizing URI parsing results" }, "time": "2018-11-22T07:55:51+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "1.x-dev" } }, "installation-source": "dist", "autoload": { "files": [ "src/functions_include.php" ], "psr-4": { "League\\Uri\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Ignace Nyamagana Butera", "email": "nyamsprod@gmail.com", "homepage": "https://nyamsprod.com" } ], "description": "userland URI parser RFC 3986 compliant", "homepage": "https://github.com/thephpleague/uri-parser", "keywords": [ "parse_url", "parser", "rfc3986", "rfc3987", "uri", "url" ], "support": { "issues": "https://github.com/thephpleague/uri-parser/issues", "source": "https://github.com/thephpleague/uri-parser/tree/master" }, "abandoned": true, "install-path": "../league/uri-parser" }, { "name": "monolog/monolog", "version": "2.8.0", "version_normalized": "2.8.0.0", "source": { "type": "git", "url": "https://github.com/Seldaek/monolog.git", "reference": "720488632c590286b88b80e62aa3d3d551ad4a50" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/Seldaek/monolog/zipball/720488632c590286b88b80e62aa3d3d551ad4a50", "reference": "720488632c590286b88b80e62aa3d3d551ad4a50", "shasum": "" }, "require": { "php": ">=7.2", "psr/log": "^1.0.1 || ^2.0 || ^3.0" }, "provide": { "psr/log-implementation": "1.0.0 || 2.0.0 || 3.0.0" }, "require-dev": { "aws/aws-sdk-php": "^2.4.9 || ^3.0", "doctrine/couchdb": "~1.0@dev", "elasticsearch/elasticsearch": "^7 || ^8", "ext-json": "*", "graylog2/gelf-php": "^1.4.2", "guzzlehttp/guzzle": "^7.4", "guzzlehttp/psr7": "^2.2", "mongodb/mongodb": "^1.8", "php-amqplib/php-amqplib": "~2.4 || ^3", "phpspec/prophecy": "^1.15", "phpstan/phpstan": "^0.12.91", "phpunit/phpunit": "^8.5.14", "predis/predis": "^1.1 || ^2.0", "rollbar/rollbar": "^1.3 || ^2 || ^3", "ruflin/elastica": "^7", "swiftmailer/swiftmailer": "^5.3|^6.0", "symfony/mailer": "^5.4 || ^6", "symfony/mime": "^5.4 || ^6" }, "suggest": { "aws/aws-sdk-php": "Allow sending log messages to AWS services like DynamoDB", "doctrine/couchdb": "Allow sending log messages to a CouchDB server", "elasticsearch/elasticsearch": "Allow sending log messages to an Elasticsearch server via official client", "ext-amqp": "Allow sending log messages to an AMQP server (1.0+ required)", "ext-curl": "Required to send log messages using the IFTTTHandler, the LogglyHandler, the SendGridHandler, the SlackWebhookHandler or the TelegramBotHandler", "ext-mbstring": "Allow to work properly with unicode symbols", "ext-mongodb": "Allow sending log messages to a MongoDB server (via driver)", "ext-openssl": "Required to send log messages using SSL", "ext-sockets": "Allow sending log messages to a Syslog server (via UDP driver)", "graylog2/gelf-php": "Allow sending log messages to a GrayLog2 server", "mongodb/mongodb": "Allow sending log messages to a MongoDB server (via library)", "php-amqplib/php-amqplib": "Allow sending log messages to an AMQP server using php-amqplib", "rollbar/rollbar": "Allow sending log messages to Rollbar", "ruflin/elastica": "Allow sending log messages to an Elastic Search server" }, "time": "2022-07-24T11:55:47+00:00", "type": "library", "extra": { "branch-alias": { "dev-main": "2.x-dev" } }, "installation-source": "dist", "autoload": { "psr-4": { "Monolog\\": "src/Monolog" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Jordi Boggiano", "email": "j.boggiano@seld.be", "homepage": "https://seld.be" } ], "description": "Sends your logs to files, sockets, inboxes, databases and various web services", "homepage": "https://github.com/Seldaek/monolog", "keywords": [ "log", "logging", "psr-3" ], "support": { "issues": "https://github.com/Seldaek/monolog/issues", "source": "https://github.com/Seldaek/monolog/tree/2.8.0" }, "funding": [ { "url": "https://github.com/Seldaek", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/monolog/monolog", "type": "tidelift" } ], "install-path": "../monolog/monolog" }, { "name": "paragonie/constant_time_encoding", "version": "v2.6.3", "version_normalized": "2.6.3.0", "source": { "type": "git", "url": "https://github.com/paragonie/constant_time_encoding.git", "reference": "58c3f47f650c94ec05a151692652a868995d2938" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/paragonie/constant_time_encoding/zipball/58c3f47f650c94ec05a151692652a868995d2938", "reference": "58c3f47f650c94ec05a151692652a868995d2938", "shasum": "" }, "require": { "php": "^7|^8" }, "require-dev": { "phpunit/phpunit": "^6|^7|^8|^9", "vimeo/psalm": "^1|^2|^3|^4" }, "time": "2022-06-14T06:56:20+00:00", "type": "library", "installation-source": "dist", "autoload": { "psr-4": { "ParagonIE\\ConstantTime\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Paragon Initiative Enterprises", "email": "security@paragonie.com", "homepage": "https://paragonie.com", "role": "Maintainer" }, { "name": "Steve 'Sc00bz' Thomas", "email": "steve@tobtu.com", "homepage": "https://www.tobtu.com", "role": "Original Developer" } ], "description": "Constant-time Implementations of RFC 4648 Encoding (Base-64, Base-32, Base-16)", "keywords": [ "base16", "base32", "base32_decode", "base32_encode", "base64", "base64_decode", "base64_encode", "bin2hex", "encoding", "hex", "hex2bin", "rfc4648" ], "support": { "email": "info@paragonie.com", "issues": "https://github.com/paragonie/constant_time_encoding/issues", "source": "https://github.com/paragonie/constant_time_encoding" }, "install-path": "../paragonie/constant_time_encoding" }, { "name": "paragonie/random_compat", "version": "v9.99.100", "version_normalized": "9.99.100.0", "source": { "type": "git", "url": "https://github.com/paragonie/random_compat.git", "reference": "996434e5492cb4c3edcb9168db6fbb1359ef965a" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/paragonie/random_compat/zipball/996434e5492cb4c3edcb9168db6fbb1359ef965a", "reference": "996434e5492cb4c3edcb9168db6fbb1359ef965a", "shasum": "" }, "require": { "php": ">= 7" }, "require-dev": { "phpunit/phpunit": "4.*|5.*", "vimeo/psalm": "^1" }, "suggest": { "ext-libsodium": "Provides a modern crypto API that can be used to generate random bytes." }, "time": "2020-10-15T08:29:30+00:00", "type": "library", "installation-source": "dist", "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Paragon Initiative Enterprises", "email": "security@paragonie.com", "homepage": "https://paragonie.com" } ], "description": "PHP 5.x polyfill for random_bytes() and random_int() from PHP 7", "keywords": [ "csprng", "polyfill", "pseudorandom", "random" ], "support": { "email": "info@paragonie.com", "issues": "https://github.com/paragonie/random_compat/issues", "source": "https://github.com/paragonie/random_compat" }, "install-path": "../paragonie/random_compat" }, { "name": "phpseclib/phpseclib", "version": "3.0.18", "version_normalized": "3.0.18.0", "source": { "type": "git", "url": "https://github.com/phpseclib/phpseclib.git", "reference": "f28693d38ba21bb0d9f0c411ee5dae2b178201da" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/phpseclib/phpseclib/zipball/f28693d38ba21bb0d9f0c411ee5dae2b178201da", "reference": "f28693d38ba21bb0d9f0c411ee5dae2b178201da", "shasum": "" }, "require": { "paragonie/constant_time_encoding": "^1|^2", "paragonie/random_compat": "^1.4|^2.0|^9.99.99", "php": ">=5.6.1" }, "require-dev": { "phpunit/phpunit": "*" }, "suggest": { "ext-dom": "Install the DOM extension to load XML formatted public keys.", "ext-gmp": "Install the GMP (GNU Multiple Precision) extension in order to speed up arbitrary precision integer arithmetic operations.", "ext-libsodium": "SSH2/SFTP can make use of some algorithms provided by the libsodium-php extension.", "ext-mcrypt": "Install the Mcrypt extension in order to speed up a few other cryptographic operations.", "ext-openssl": "Install the OpenSSL extension in order to speed up a wide variety of cryptographic operations." }, "time": "2022-12-17T18:26:50+00:00", "type": "library", "installation-source": "dist", "autoload": { "files": [ "phpseclib/bootstrap.php" ], "psr-4": { "phpseclib3\\": "phpseclib/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Jim Wigginton", "email": "terrafrost@php.net", "role": "Lead Developer" }, { "name": "Patrick Monnerat", "email": "pm@datasphere.ch", "role": "Developer" }, { "name": "Andreas Fischer", "email": "bantu@phpbb.com", "role": "Developer" }, { "name": "Hans-Jürgen Petrich", "email": "petrich@tronic-media.com", "role": "Developer" }, { "name": "Graham Campbell", "email": "graham@alt-three.com", "role": "Developer" } ], "description": "PHP Secure Communications Library - Pure-PHP implementations of RSA, AES, SSH2, SFTP, X.509 etc.", "homepage": "http://phpseclib.sourceforge.net", "keywords": [ "BigInteger", "aes", "asn.1", "asn1", "blowfish", "crypto", "cryptography", "encryption", "rsa", "security", "sftp", "signature", "signing", "ssh", "twofish", "x.509", "x509" ], "support": { "issues": "https://github.com/phpseclib/phpseclib/issues", "source": "https://github.com/phpseclib/phpseclib/tree/3.0.18" }, "funding": [ { "url": "https://github.com/terrafrost", "type": "github" }, { "url": "https://www.patreon.com/phpseclib", "type": "patreon" }, { "url": "https://tidelift.com/funding/github/packagist/phpseclib/phpseclib", "type": "tidelift" } ], "install-path": "../phpseclib/phpseclib" }, { "name": "psr/http-factory", "version": "1.0.1", "version_normalized": "1.0.1.0", "source": { "type": "git", "url": "https://github.com/php-fig/http-factory.git", "reference": "12ac7fcd07e5b077433f5f2bee95b3a771bf61be" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/php-fig/http-factory/zipball/12ac7fcd07e5b077433f5f2bee95b3a771bf61be", "reference": "12ac7fcd07e5b077433f5f2bee95b3a771bf61be", "shasum": "" }, "require": { "php": ">=7.0.0", "psr/http-message": "^1.0" }, "time": "2019-04-30T12:38:16+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "1.0.x-dev" } }, "installation-source": "dist", "autoload": { "psr-4": { "Psr\\Http\\Message\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "PHP-FIG", "homepage": "http://www.php-fig.org/" } ], "description": "Common interfaces for PSR-7 HTTP message factories", "keywords": [ "factory", "http", "message", "psr", "psr-17", "psr-7", "request", "response" ], "support": { "source": "https://github.com/php-fig/http-factory/tree/master" }, "install-path": "../psr/http-factory" }, { "name": "psr/http-message", "version": "1.0.1", "version_normalized": "1.0.1.0", "source": { "type": "git", "url": "https://github.com/php-fig/http-message.git", "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/php-fig/http-message/zipball/f6561bf28d520154e4b0ec72be95418abe6d9363", "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363", "shasum": "" }, "require": { "php": ">=5.3.0" }, "time": "2016-08-06T14:39:51+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "1.0.x-dev" } }, "installation-source": "dist", "autoload": { "psr-4": { "Psr\\Http\\Message\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "PHP-FIG", "homepage": "http://www.php-fig.org/" } ], "description": "Common interface for HTTP messages", "homepage": "https://github.com/php-fig/http-message", "keywords": [ "http", "http-message", "psr", "psr-7", "request", "response" ], "support": { "source": "https://github.com/php-fig/http-message/tree/master" }, "install-path": "../psr/http-message" }, { "name": "psr/log", "version": "3.0.0", "version_normalized": "3.0.0.0", "source": { "type": "git", "url": "https://github.com/php-fig/log.git", "reference": "fe5ea303b0887d5caefd3d431c3e61ad47037001" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/php-fig/log/zipball/fe5ea303b0887d5caefd3d431c3e61ad47037001", "reference": "fe5ea303b0887d5caefd3d431c3e61ad47037001", "shasum": "" }, "require": { "php": ">=8.0.0" }, "time": "2021-07-14T16:46:02+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "3.x-dev" } }, "installation-source": "dist", "autoload": { "psr-4": { "Psr\\Log\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "PHP-FIG", "homepage": "https://www.php-fig.org/" } ], "description": "Common interface for logging libraries", "homepage": "https://github.com/php-fig/log", "keywords": [ "log", "psr", "psr-3" ], "support": { "source": "https://github.com/php-fig/log/tree/3.0.0" }, "install-path": "../psr/log" }, { "name": "symfony/polyfill-mbstring", "version": "v1.27.0", "version_normalized": "1.27.0.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-mbstring.git", "reference": "8ad114f6b39e2c98a8b0e3bd907732c207c2b534" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/8ad114f6b39e2c98a8b0e3bd907732c207c2b534", "reference": "8ad114f6b39e2c98a8b0e3bd907732c207c2b534", "shasum": "" }, "require": { "php": ">=7.1" }, "provide": { "ext-mbstring": "*" }, "suggest": { "ext-mbstring": "For best performance" }, "time": "2022-11-03T14:55:06+00:00", "type": "library", "extra": { "branch-alias": { "dev-main": "1.27-dev" }, "thanks": { "name": "symfony/polyfill", "url": "https://github.com/symfony/polyfill" } }, "installation-source": "dist", "autoload": { "files": [ "bootstrap.php" ], "psr-4": { "Symfony\\Polyfill\\Mbstring\\": "" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Symfony polyfill for the Mbstring extension", "homepage": "https://symfony.com", "keywords": [ "compatibility", "mbstring", "polyfill", "portable", "shim" ], "support": { "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.27.0" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "install-path": "../symfony/polyfill-mbstring" }, { "name": "symfony/polyfill-php80", "version": "v1.27.0", "version_normalized": "1.27.0.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-php80.git", "reference": "7a6ff3f1959bb01aefccb463a0f2cd3d3d2fd936" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/7a6ff3f1959bb01aefccb463a0f2cd3d3d2fd936", "reference": "7a6ff3f1959bb01aefccb463a0f2cd3d3d2fd936", "shasum": "" }, "require": { "php": ">=7.1" }, "time": "2022-11-03T14:55:06+00:00", "type": "library", "extra": { "branch-alias": { "dev-main": "1.27-dev" }, "thanks": { "name": "symfony/polyfill", "url": "https://github.com/symfony/polyfill" } }, "installation-source": "dist", "autoload": { "files": [ "bootstrap.php" ], "psr-4": { "Symfony\\Polyfill\\Php80\\": "" }, "classmap": [ "Resources/stubs" ] }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Ion Bazan", "email": "ion.bazan@gmail.com" }, { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "description": "Symfony polyfill backporting some PHP 8.0+ features to lower PHP versions", "homepage": "https://symfony.com", "keywords": [ "compatibility", "polyfill", "portable", "shim" ], "support": { "source": "https://github.com/symfony/polyfill-php80/tree/v1.27.0" }, "funding": [ { "url": "https://symfony.com/sponsor", "type": "custom" }, { "url": "https://github.com/fabpot", "type": "github" }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], "install-path": "../symfony/polyfill-php80" }, { "name": "webmozart/assert", "version": "1.11.0", "version_normalized": "1.11.0.0", "source": { "type": "git", "url": "https://github.com/webmozarts/assert.git", "reference": "11cb2199493b2f8a3b53e7f19068fc6aac760991" }, "dist": { "type": "zip", "url": "https://api.github.com/repos/webmozarts/assert/zipball/11cb2199493b2f8a3b53e7f19068fc6aac760991", "reference": "11cb2199493b2f8a3b53e7f19068fc6aac760991", "shasum": "" }, "require": { "ext-ctype": "*", "php": "^7.2 || ^8.0" }, "conflict": { "phpstan/phpstan": "<0.12.20", "vimeo/psalm": "<4.6.1 || 4.6.2" }, "require-dev": { "phpunit/phpunit": "^8.5.13" }, "time": "2022-06-03T18:03:27+00:00", "type": "library", "extra": { "branch-alias": { "dev-master": "1.10-dev" } }, "installation-source": "dist", "autoload": { "psr-4": { "Webmozart\\Assert\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", "license": [ "MIT" ], "authors": [ { "name": "Bernhard Schussek", "email": "bschussek@gmail.com" } ], "description": "Assertions to validate method input/output with nice error messages.", "keywords": [ "assert", "check", "validate" ], "support": { "issues": "https://github.com/webmozarts/assert/issues", "source": "https://github.com/webmozarts/assert/tree/1.11.0" }, "install-path": "../webmozart/assert" } ], "dev": true, "dev-package-names": [] } $vendorDir . '/amphp/byte-stream/lib/Base64/Base64DecodingInputStream.php', 'Amp\\ByteStream\\Base64\\Base64DecodingOutputStream' => $vendorDir . '/amphp/byte-stream/lib/Base64/Base64DecodingOutputStream.php', 'Amp\\ByteStream\\Base64\\Base64EncodingInputStream' => $vendorDir . '/amphp/byte-stream/lib/Base64/Base64EncodingInputStream.php', 'Amp\\ByteStream\\Base64\\Base64EncodingOutputStream' => $vendorDir . '/amphp/byte-stream/lib/Base64/Base64EncodingOutputStream.php', 'Amp\\ByteStream\\ClosedException' => $vendorDir . '/amphp/byte-stream/lib/ClosedException.php', 'Amp\\ByteStream\\InMemoryStream' => $vendorDir . '/amphp/byte-stream/lib/InMemoryStream.php', 'Amp\\ByteStream\\InputStream' => $vendorDir . '/amphp/byte-stream/lib/InputStream.php', 'Amp\\ByteStream\\InputStreamChain' => $vendorDir . '/amphp/byte-stream/lib/InputStreamChain.php', 'Amp\\ByteStream\\IteratorStream' => $vendorDir . '/amphp/byte-stream/lib/IteratorStream.php', 'Amp\\ByteStream\\LineReader' => $vendorDir . '/amphp/byte-stream/lib/LineReader.php', 'Amp\\ByteStream\\Message' => $vendorDir . '/amphp/byte-stream/lib/Message.php', 'Amp\\ByteStream\\OutputBuffer' => $vendorDir . '/amphp/byte-stream/lib/OutputBuffer.php', 'Amp\\ByteStream\\OutputStream' => $vendorDir . '/amphp/byte-stream/lib/OutputStream.php', 'Amp\\ByteStream\\Payload' => $vendorDir . '/amphp/byte-stream/lib/Payload.php', 'Amp\\ByteStream\\PendingReadError' => $vendorDir . '/amphp/byte-stream/lib/PendingReadError.php', 'Amp\\ByteStream\\ResourceInputStream' => $vendorDir . '/amphp/byte-stream/lib/ResourceInputStream.php', 'Amp\\ByteStream\\ResourceOutputStream' => $vendorDir . '/amphp/byte-stream/lib/ResourceOutputStream.php', 'Amp\\ByteStream\\StreamException' => $vendorDir . '/amphp/byte-stream/lib/StreamException.php', 'Amp\\ByteStream\\ZlibInputStream' => $vendorDir . '/amphp/byte-stream/lib/ZlibInputStream.php', 'Amp\\ByteStream\\ZlibOutputStream' => $vendorDir . '/amphp/byte-stream/lib/ZlibOutputStream.php', 'Amp\\Cache\\ArrayCache' => $vendorDir . '/amphp/cache/lib/ArrayCache.php', 'Amp\\Cache\\AtomicCache' => $vendorDir . '/amphp/cache/lib/AtomicCache.php', 'Amp\\Cache\\Cache' => $vendorDir . '/amphp/cache/lib/Cache.php', 'Amp\\Cache\\CacheException' => $vendorDir . '/amphp/cache/lib/CacheException.php', 'Amp\\Cache\\FileCache' => $vendorDir . '/amphp/cache/lib/FileCache.php', 'Amp\\Cache\\NullCache' => $vendorDir . '/amphp/cache/lib/NullCache.php', 'Amp\\Cache\\PrefixCache' => $vendorDir . '/amphp/cache/lib/PrefixCache.php', 'Amp\\Cache\\SerializedCache' => $vendorDir . '/amphp/cache/lib/SerializedCache.php', 'Amp\\CallableMaker' => $vendorDir . '/amphp/amp/lib/CallableMaker.php', 'Amp\\CancellationToken' => $vendorDir . '/amphp/amp/lib/CancellationToken.php', 'Amp\\CancellationTokenSource' => $vendorDir . '/amphp/amp/lib/CancellationTokenSource.php', 'Amp\\CancelledException' => $vendorDir . '/amphp/amp/lib/CancelledException.php', 'Amp\\CombinedCancellationToken' => $vendorDir . '/amphp/amp/lib/CombinedCancellationToken.php', 'Amp\\Coroutine' => $vendorDir . '/amphp/amp/lib/Coroutine.php', 'Amp\\Deferred' => $vendorDir . '/amphp/amp/lib/Deferred.php', 'Amp\\Delayed' => $vendorDir . '/amphp/amp/lib/Delayed.php', 'Amp\\Dns\\BlockingFallbackResolver' => $vendorDir . '/amphp/dns/lib/BlockingFallbackResolver.php', 'Amp\\Dns\\Config' => $vendorDir . '/amphp/dns/lib/Config.php', 'Amp\\Dns\\ConfigException' => $vendorDir . '/amphp/dns/lib/ConfigException.php', 'Amp\\Dns\\ConfigLoader' => $vendorDir . '/amphp/dns/lib/ConfigLoader.php', 'Amp\\Dns\\DnsException' => $vendorDir . '/amphp/dns/lib/DnsException.php', 'Amp\\Dns\\HostLoader' => $vendorDir . '/amphp/dns/lib/HostLoader.php', 'Amp\\Dns\\Internal\\Socket' => $vendorDir . '/amphp/dns/lib/Internal/Socket.php', 'Amp\\Dns\\Internal\\TcpSocket' => $vendorDir . '/amphp/dns/lib/Internal/TcpSocket.php', 'Amp\\Dns\\Internal\\UdpSocket' => $vendorDir . '/amphp/dns/lib/Internal/UdpSocket.php', 'Amp\\Dns\\InvalidNameException' => $vendorDir . '/amphp/dns/lib/InvalidNameException.php', 'Amp\\Dns\\NoRecordException' => $vendorDir . '/amphp/dns/lib/NoRecordException.php', 'Amp\\Dns\\Record' => $vendorDir . '/amphp/dns/lib/Record.php', 'Amp\\Dns\\Resolver' => $vendorDir . '/amphp/dns/lib/Resolver.php', 'Amp\\Dns\\Rfc1035StubResolver' => $vendorDir . '/amphp/dns/lib/Rfc1035StubResolver.php', 'Amp\\Dns\\TimeoutException' => $vendorDir . '/amphp/dns/lib/TimeoutException.php', 'Amp\\Dns\\UnixConfigLoader' => $vendorDir . '/amphp/dns/lib/UnixConfigLoader.php', 'Amp\\Dns\\WindowsConfigLoader' => $vendorDir . '/amphp/dns/lib/WindowsConfigLoader.php', 'Amp\\DoH\\DoHConfig' => $vendorDir . '/danog/dns-over-https/lib/DoHConfig.php', 'Amp\\DoH\\DoHException' => $vendorDir . '/danog/dns-over-https/lib/DoHException.php', 'Amp\\DoH\\Internal\\HttpsSocket' => $vendorDir . '/danog/dns-over-https/lib/Internal/HttpsSocket.php', 'Amp\\DoH\\Internal\\Socket' => $vendorDir . '/danog/dns-over-https/lib/Internal/Socket.php', 'Amp\\DoH\\Nameserver' => $vendorDir . '/danog/dns-over-https/lib/Nameserver.php', 'Amp\\DoH\\Rfc8484StubResolver' => $vendorDir . '/danog/dns-over-https/lib/Rfc8484StubResolver.php', 'Amp\\Emitter' => $vendorDir . '/amphp/amp/lib/Emitter.php', 'Amp\\Failure' => $vendorDir . '/amphp/amp/lib/Failure.php', 'Amp\\File\\Driver' => $vendorDir . '/amphp/file/src/Driver.php', 'Amp\\File\\Driver\\BlockingDriver' => $vendorDir . '/amphp/file/src/Driver/BlockingDriver.php', 'Amp\\File\\Driver\\BlockingFile' => $vendorDir . '/amphp/file/src/Driver/BlockingFile.php', 'Amp\\File\\Driver\\EioDriver' => $vendorDir . '/amphp/file/src/Driver/EioDriver.php', 'Amp\\File\\Driver\\EioFile' => $vendorDir . '/amphp/file/src/Driver/EioFile.php', 'Amp\\File\\Driver\\ParallelDriver' => $vendorDir . '/amphp/file/src/Driver/ParallelDriver.php', 'Amp\\File\\Driver\\ParallelFile' => $vendorDir . '/amphp/file/src/Driver/ParallelFile.php', 'Amp\\File\\Driver\\StatusCachingDriver' => $vendorDir . '/amphp/file/src/Driver/StatusCachingDriver.php', 'Amp\\File\\Driver\\StatusCachingFile' => $vendorDir . '/amphp/file/src/Driver/StatusCachingFile.php', 'Amp\\File\\Driver\\UvDriver' => $vendorDir . '/amphp/file/src/Driver/UvDriver.php', 'Amp\\File\\Driver\\UvFile' => $vendorDir . '/amphp/file/src/Driver/UvFile.php', 'Amp\\File\\File' => $vendorDir . '/amphp/file/src/File.php', 'Amp\\File\\Filesystem' => $vendorDir . '/amphp/file/src/Filesystem.php', 'Amp\\File\\FilesystemException' => $vendorDir . '/amphp/file/src/FilesystemException.php', 'Amp\\File\\Internal\\Cache' => $vendorDir . '/amphp/file/src/Internal/Cache.php', 'Amp\\File\\Internal\\EioPoll' => $vendorDir . '/amphp/file/src/Internal/EioPoll.php', 'Amp\\File\\Internal\\FileTask' => $vendorDir . '/amphp/file/src/Internal/FileTask.php', 'Amp\\File\\Internal\\UvPoll' => $vendorDir . '/amphp/file/src/Internal/UvPoll.php', 'Amp\\File\\PendingOperationError' => $vendorDir . '/amphp/file/src/PendingOperationError.php', 'Amp\\File\\Sync\\AsyncFileMutex' => $vendorDir . '/amphp/file/src/Sync/AsyncFileMutex.php', 'Amp\\Http\\Client\\ApplicationInterceptor' => $vendorDir . '/amphp/http-client/src/ApplicationInterceptor.php', 'Amp\\Http\\Client\\Body\\FileBody' => $vendorDir . '/amphp/http-client/src/Body/FileBody.php', 'Amp\\Http\\Client\\Body\\FormBody' => $vendorDir . '/amphp/http-client/src/Body/FormBody.php', 'Amp\\Http\\Client\\Body\\JsonBody' => $vendorDir . '/amphp/http-client/src/Body/JsonBody.php', 'Amp\\Http\\Client\\Body\\StringBody' => $vendorDir . '/amphp/http-client/src/Body/StringBody.php', 'Amp\\Http\\Client\\Connection\\Connection' => $vendorDir . '/amphp/http-client/src/Connection/Connection.php', 'Amp\\Http\\Client\\Connection\\ConnectionFactory' => $vendorDir . '/amphp/http-client/src/Connection/ConnectionFactory.php', 'Amp\\Http\\Client\\Connection\\ConnectionLimitingPool' => $vendorDir . '/amphp/http-client/src/Connection/ConnectionLimitingPool.php', 'Amp\\Http\\Client\\Connection\\ConnectionPool' => $vendorDir . '/amphp/http-client/src/Connection/ConnectionPool.php', 'Amp\\Http\\Client\\Connection\\DefaultConnectionFactory' => $vendorDir . '/amphp/http-client/src/Connection/DefaultConnectionFactory.php', 'Amp\\Http\\Client\\Connection\\Http1Connection' => $vendorDir . '/amphp/http-client/src/Connection/Http1Connection.php', 'Amp\\Http\\Client\\Connection\\Http2Connection' => $vendorDir . '/amphp/http-client/src/Connection/Http2Connection.php', 'Amp\\Http\\Client\\Connection\\Http2ConnectionException' => $vendorDir . '/amphp/http-client/src/Connection/Http2ConnectionException.php', 'Amp\\Http\\Client\\Connection\\Http2StreamException' => $vendorDir . '/amphp/http-client/src/Connection/Http2StreamException.php', 'Amp\\Http\\Client\\Connection\\HttpStream' => $vendorDir . '/amphp/http-client/src/Connection/HttpStream.php', 'Amp\\Http\\Client\\Connection\\InterceptedStream' => $vendorDir . '/amphp/http-client/src/Connection/InterceptedStream.php', 'Amp\\Http\\Client\\Connection\\Internal\\Http1Parser' => $vendorDir . '/amphp/http-client/src/Connection/Internal/Http1Parser.php', 'Amp\\Http\\Client\\Connection\\Internal\\Http2ConnectionProcessor' => $vendorDir . '/amphp/http-client/src/Connection/Internal/Http2ConnectionProcessor.php', 'Amp\\Http\\Client\\Connection\\Internal\\Http2Stream' => $vendorDir . '/amphp/http-client/src/Connection/Internal/Http2Stream.php', 'Amp\\Http\\Client\\Connection\\Internal\\RequestNormalizer' => $vendorDir . '/amphp/http-client/src/Connection/Internal/RequestNormalizer.php', 'Amp\\Http\\Client\\Connection\\Stream' => $vendorDir . '/amphp/http-client/src/Connection/Stream.php', 'Amp\\Http\\Client\\Connection\\StreamLimitingPool' => $vendorDir . '/amphp/http-client/src/Connection/StreamLimitingPool.php', 'Amp\\Http\\Client\\Connection\\UnlimitedConnectionPool' => $vendorDir . '/amphp/http-client/src/Connection/UnlimitedConnectionPool.php', 'Amp\\Http\\Client\\Connection\\UnprocessedRequestException' => $vendorDir . '/amphp/http-client/src/Connection/UnprocessedRequestException.php', 'Amp\\Http\\Client\\Connection\\UpgradedSocket' => $vendorDir . '/amphp/http-client/src/Connection/UpgradedSocket.php', 'Amp\\Http\\Client\\Cookie\\CookieInterceptor' => $vendorDir . '/amphp/http-client-cookies/src/CookieInterceptor.php', 'Amp\\Http\\Client\\Cookie\\CookieJar' => $vendorDir . '/amphp/http-client-cookies/src/CookieJar.php', 'Amp\\Http\\Client\\Cookie\\FileCookieJar' => $vendorDir . '/amphp/http-client-cookies/src/FileCookieJar.php', 'Amp\\Http\\Client\\Cookie\\InMemoryCookieJar' => $vendorDir . '/amphp/http-client-cookies/src/InMemoryCookieJar.php', 'Amp\\Http\\Client\\Cookie\\Internal\\PublicSuffixList' => $vendorDir . '/amphp/http-client-cookies/src/Internal/PublicSuffixList.php', 'Amp\\Http\\Client\\Cookie\\NullCookieJar' => $vendorDir . '/amphp/http-client-cookies/src/NullCookieJar.php', 'Amp\\Http\\Client\\DelegateHttpClient' => $vendorDir . '/amphp/http-client/src/DelegateHttpClient.php', 'Amp\\Http\\Client\\EventListener' => $vendorDir . '/amphp/http-client/src/EventListener.php', 'Amp\\Http\\Client\\EventListener\\RecordHarAttributes' => $vendorDir . '/amphp/http-client/src/EventListener/RecordHarAttributes.php', 'Amp\\Http\\Client\\HttpClient' => $vendorDir . '/amphp/http-client/src/HttpClient.php', 'Amp\\Http\\Client\\HttpClientBuilder' => $vendorDir . '/amphp/http-client/src/HttpClientBuilder.php', 'Amp\\Http\\Client\\HttpException' => $vendorDir . '/amphp/http-client/src/HttpException.php', 'Amp\\Http\\Client\\InterceptedHttpClient' => $vendorDir . '/amphp/http-client/src/InterceptedHttpClient.php', 'Amp\\Http\\Client\\Interceptor\\AddRequestHeader' => $vendorDir . '/amphp/http-client/src/Interceptor/AddRequestHeader.php', 'Amp\\Http\\Client\\Interceptor\\AddResponseHeader' => $vendorDir . '/amphp/http-client/src/Interceptor/AddResponseHeader.php', 'Amp\\Http\\Client\\Interceptor\\DecompressResponse' => $vendorDir . '/amphp/http-client/src/Interceptor/DecompressResponse.php', 'Amp\\Http\\Client\\Interceptor\\FollowRedirects' => $vendorDir . '/amphp/http-client/src/Interceptor/FollowRedirects.php', 'Amp\\Http\\Client\\Interceptor\\ForbidUriUserInfo' => $vendorDir . '/amphp/http-client/src/Interceptor/ForbidUriUserInfo.php', 'Amp\\Http\\Client\\Interceptor\\LogHttpArchive' => $vendorDir . '/amphp/http-client/src/Interceptor/LogHttpArchive.php', 'Amp\\Http\\Client\\Interceptor\\MatchOrigin' => $vendorDir . '/amphp/http-client/src/Interceptor/MatchOrigin.php', 'Amp\\Http\\Client\\Interceptor\\ModifyRequest' => $vendorDir . '/amphp/http-client/src/Interceptor/ModifyRequest.php', 'Amp\\Http\\Client\\Interceptor\\ModifyResponse' => $vendorDir . '/amphp/http-client/src/Interceptor/ModifyResponse.php', 'Amp\\Http\\Client\\Interceptor\\RemoveRequestHeader' => $vendorDir . '/amphp/http-client/src/Interceptor/RemoveRequestHeader.php', 'Amp\\Http\\Client\\Interceptor\\RemoveResponseHeader' => $vendorDir . '/amphp/http-client/src/Interceptor/RemoveResponseHeader.php', 'Amp\\Http\\Client\\Interceptor\\RetryRequests' => $vendorDir . '/amphp/http-client/src/Interceptor/RetryRequests.php', 'Amp\\Http\\Client\\Interceptor\\SetRequestHeader' => $vendorDir . '/amphp/http-client/src/Interceptor/SetRequestHeader.php', 'Amp\\Http\\Client\\Interceptor\\SetRequestHeaderIfUnset' => $vendorDir . '/amphp/http-client/src/Interceptor/SetRequestHeaderIfUnset.php', 'Amp\\Http\\Client\\Interceptor\\SetRequestTimeout' => $vendorDir . '/amphp/http-client/src/Interceptor/SetRequestTimeout.php', 'Amp\\Http\\Client\\Interceptor\\SetResponseHeader' => $vendorDir . '/amphp/http-client/src/Interceptor/SetResponseHeader.php', 'Amp\\Http\\Client\\Interceptor\\SetResponseHeaderIfUnset' => $vendorDir . '/amphp/http-client/src/Interceptor/SetResponseHeaderIfUnset.php', 'Amp\\Http\\Client\\Interceptor\\TooManyRedirectsException' => $vendorDir . '/amphp/http-client/src/Interceptor/TooManyRedirectsException.php', 'Amp\\Http\\Client\\Internal\\ForbidCloning' => $vendorDir . '/amphp/http-client/src/Internal/ForbidCloning.php', 'Amp\\Http\\Client\\Internal\\ForbidSerialization' => $vendorDir . '/amphp/http-client/src/Internal/ForbidSerialization.php', 'Amp\\Http\\Client\\Internal\\HarAttributes' => $vendorDir . '/amphp/http-client/src/Internal/HarAttributes.php', 'Amp\\Http\\Client\\Internal\\ResponseBodyStream' => $vendorDir . '/amphp/http-client/src/Internal/ResponseBodyStream.php', 'Amp\\Http\\Client\\Internal\\SizeLimitingInputStream' => $vendorDir . '/amphp/http-client/src/Internal/SizeLimitingInputStream.php', 'Amp\\Http\\Client\\InvalidRequestException' => $vendorDir . '/amphp/http-client/src/InvalidRequestException.php', 'Amp\\Http\\Client\\MissingAttributeError' => $vendorDir . '/amphp/http-client/src/MissingAttributeError.php', 'Amp\\Http\\Client\\NetworkInterceptor' => $vendorDir . '/amphp/http-client/src/NetworkInterceptor.php', 'Amp\\Http\\Client\\ParseException' => $vendorDir . '/amphp/http-client/src/ParseException.php', 'Amp\\Http\\Client\\PooledHttpClient' => $vendorDir . '/amphp/http-client/src/PooledHttpClient.php', 'Amp\\Http\\Client\\Request' => $vendorDir . '/amphp/http-client/src/Request.php', 'Amp\\Http\\Client\\RequestBody' => $vendorDir . '/amphp/http-client/src/RequestBody.php', 'Amp\\Http\\Client\\Response' => $vendorDir . '/amphp/http-client/src/Response.php', 'Amp\\Http\\Client\\SocketException' => $vendorDir . '/amphp/http-client/src/SocketException.php', 'Amp\\Http\\Client\\TimeoutException' => $vendorDir . '/amphp/http-client/src/TimeoutException.php', 'Amp\\Http\\Client\\Trailers' => $vendorDir . '/amphp/http-client/src/Trailers.php', 'Amp\\Http\\Cookie\\CookieAttributes' => $vendorDir . '/amphp/http/src/Cookie/CookieAttributes.php', 'Amp\\Http\\Cookie\\InvalidCookieException' => $vendorDir . '/amphp/http/src/Cookie/InvalidCookieException.php', 'Amp\\Http\\Cookie\\RequestCookie' => $vendorDir . '/amphp/http/src/Cookie/RequestCookie.php', 'Amp\\Http\\Cookie\\ResponseCookie' => $vendorDir . '/amphp/http/src/Cookie/ResponseCookie.php', 'Amp\\Http\\HPack' => $vendorDir . '/amphp/hpack/src/HPack.php', 'Amp\\Http\\HPackException' => $vendorDir . '/amphp/hpack/src/HPackException.php', 'Amp\\Http\\Http2\\Http2ConnectionException' => $vendorDir . '/amphp/http/src/Http2/Http2ConnectionException.php', 'Amp\\Http\\Http2\\Http2Parser' => $vendorDir . '/amphp/http/src/Http2/Http2Parser.php', 'Amp\\Http\\Http2\\Http2Processor' => $vendorDir . '/amphp/http/src/Http2/Http2Processor.php', 'Amp\\Http\\Http2\\Http2StreamException' => $vendorDir . '/amphp/http/src/Http2/Http2StreamException.php', 'Amp\\Http\\Internal\\HPackNative' => $vendorDir . '/amphp/hpack/src/Internal/HPackNative.php', 'Amp\\Http\\Internal\\HPackNghttp2' => $vendorDir . '/amphp/hpack/src/Internal/HPackNghttp2.php', 'Amp\\Http\\InvalidHeaderException' => $vendorDir . '/amphp/http/src/InvalidHeaderException.php', 'Amp\\Http\\Message' => $vendorDir . '/amphp/http/src/Message.php', 'Amp\\Http\\Rfc7230' => $vendorDir . '/amphp/http/src/Rfc7230.php', 'Amp\\Http\\Status' => $vendorDir . '/amphp/http/src/Status.php', 'Amp\\Internal\\Placeholder' => $vendorDir . '/amphp/amp/lib/Internal/Placeholder.php', 'Amp\\Internal\\PrivateIterator' => $vendorDir . '/amphp/amp/lib/Internal/PrivateIterator.php', 'Amp\\Internal\\PrivatePromise' => $vendorDir . '/amphp/amp/lib/Internal/PrivatePromise.php', 'Amp\\Internal\\Producer' => $vendorDir . '/amphp/amp/lib/Internal/Producer.php', 'Amp\\Internal\\ResolutionQueue' => $vendorDir . '/amphp/amp/lib/Internal/ResolutionQueue.php', 'Amp\\InvalidYieldError' => $vendorDir . '/amphp/amp/lib/InvalidYieldError.php', 'Amp\\Ipc\\IpcServer' => $vendorDir . '/danog/ipc/lib/IpcServer.php', 'Amp\\Ipc\\IpcServerException' => $vendorDir . '/danog/ipc/lib/IpcServerException.php', 'Amp\\Ipc\\PendingAcceptError' => $vendorDir . '/danog/ipc/lib/PendingAcceptError.php', 'Amp\\Ipc\\Sync\\Channel' => $vendorDir . '/danog/ipc/lib/Sync/Channel.php', 'Amp\\Ipc\\Sync\\ChannelCloseAck' => $vendorDir . '/danog/ipc/lib/Sync/ChannelCloseAck.php', 'Amp\\Ipc\\Sync\\ChannelCloseMsg' => $vendorDir . '/danog/ipc/lib/Sync/ChannelCloseMsg.php', 'Amp\\Ipc\\Sync\\ChannelCloseReq' => $vendorDir . '/danog/ipc/lib/Sync/ChannelCloseReq.php', 'Amp\\Ipc\\Sync\\ChannelException' => $vendorDir . '/danog/ipc/lib/Sync/ChannelException.php', 'Amp\\Ipc\\Sync\\ChannelParser' => $vendorDir . '/danog/ipc/lib/Sync/ChannelParser.php', 'Amp\\Ipc\\Sync\\ChannelledSocket' => $vendorDir . '/danog/ipc/lib/Sync/ChannelledSocket.php', 'Amp\\Ipc\\Sync\\ChannelledStream' => $vendorDir . '/danog/ipc/lib/Sync/ChannelledStream.php', 'Amp\\Ipc\\Sync\\PanicError' => $vendorDir . '/danog/ipc/lib/Sync/PanicError.php', 'Amp\\Ipc\\Sync\\Parcel' => $vendorDir . '/danog/ipc/lib/Sync/Parcel.php', 'Amp\\Ipc\\Sync\\SerializationException' => $vendorDir . '/danog/ipc/lib/Sync/SerializationException.php', 'Amp\\Ipc\\Sync\\SynchronizationError' => $vendorDir . '/danog/ipc/lib/Sync/SynchronizationError.php', 'Amp\\Iterator' => $vendorDir . '/amphp/amp/lib/Iterator.php', 'Amp\\LazyPromise' => $vendorDir . '/amphp/amp/lib/LazyPromise.php', 'Amp\\Log\\ConsoleFormatter' => $vendorDir . '/amphp/log/src/ConsoleFormatter.php', 'Amp\\Log\\StreamHandler' => $vendorDir . '/amphp/log/src/StreamHandler.php', 'Amp\\Loop' => $vendorDir . '/amphp/amp/lib/Loop.php', 'Amp\\Loop\\Driver' => $vendorDir . '/amphp/amp/lib/Loop/Driver.php', 'Amp\\Loop\\DriverFactory' => $vendorDir . '/amphp/amp/lib/Loop/DriverFactory.php', 'Amp\\Loop\\EvDriver' => $vendorDir . '/amphp/amp/lib/Loop/EvDriver.php', 'Amp\\Loop\\EventDriver' => $vendorDir . '/amphp/amp/lib/Loop/EventDriver.php', 'Amp\\Loop\\Internal\\TimerQueue' => $vendorDir . '/amphp/amp/lib/Loop/Internal/TimerQueue.php', 'Amp\\Loop\\InvalidWatcherError' => $vendorDir . '/amphp/amp/lib/Loop/InvalidWatcherError.php', 'Amp\\Loop\\NativeDriver' => $vendorDir . '/amphp/amp/lib/Loop/NativeDriver.php', 'Amp\\Loop\\TracingDriver' => $vendorDir . '/amphp/amp/lib/Loop/TracingDriver.php', 'Amp\\Loop\\UnsupportedFeatureException' => $vendorDir . '/amphp/amp/lib/Loop/UnsupportedFeatureException.php', 'Amp\\Loop\\UvDriver' => $vendorDir . '/amphp/amp/lib/Loop/UvDriver.php', 'Amp\\Loop\\Watcher' => $vendorDir . '/amphp/amp/lib/Loop/Watcher.php', 'Amp\\MultiReasonException' => $vendorDir . '/amphp/amp/lib/MultiReasonException.php', 'Amp\\Mysql\\CancellableConnector' => $vendorDir . '/amphp/mysql/src/CancellableConnector.php', 'Amp\\Mysql\\CommandResult' => $vendorDir . '/amphp/mysql/src/CommandResult.php', 'Amp\\Mysql\\Connection' => $vendorDir . '/amphp/mysql/src/Connection.php', 'Amp\\Mysql\\ConnectionConfig' => $vendorDir . '/amphp/mysql/src/ConnectionConfig.php', 'Amp\\Mysql\\ConnectionResultSet' => $vendorDir . '/amphp/mysql/src/ConnectionResultSet.php', 'Amp\\Mysql\\ConnectionStatement' => $vendorDir . '/amphp/mysql/src/ConnectionStatement.php', 'Amp\\Mysql\\ConnectionTransaction' => $vendorDir . '/amphp/mysql/src/ConnectionTransaction.php', 'Amp\\Mysql\\DataTypes' => $vendorDir . '/amphp/mysql/src/DataTypes.php', 'Amp\\Mysql\\InitializationException' => $vendorDir . '/amphp/mysql/src/InitializationException.php', 'Amp\\Mysql\\Internal\\ConnectionState' => $vendorDir . '/amphp/mysql/src/Internal/ConnectionState.php', 'Amp\\Mysql\\Internal\\Processor' => $vendorDir . '/amphp/mysql/src/Internal/Processor.php', 'Amp\\Mysql\\Internal\\ResultProxy' => $vendorDir . '/amphp/mysql/src/Internal/ResultProxy.php', 'Amp\\Mysql\\Pool' => $vendorDir . '/amphp/mysql/src/Pool.php', 'Amp\\Mysql\\PooledResultSet' => $vendorDir . '/amphp/mysql/src/PooledResultSet.php', 'Amp\\Mysql\\PooledStatement' => $vendorDir . '/amphp/mysql/src/PooledStatement.php', 'Amp\\Mysql\\PooledTransaction' => $vendorDir . '/amphp/mysql/src/PooledTransaction.php', 'Amp\\Mysql\\RefreshTypes' => $vendorDir . '/amphp/mysql/src/RefreshTypes.php', 'Amp\\Mysql\\ResultSet' => $vendorDir . '/amphp/mysql/src/ResultSet.php', 'Amp\\Mysql\\Statement' => $vendorDir . '/amphp/mysql/src/Statement.php', 'Amp\\Mysql\\StatementPool' => $vendorDir . '/amphp/mysql/src/StatementPool.php', 'Amp\\Mysql\\TransactionError' => $vendorDir . '/amphp/mysql/src/TransactionError.php', 'Amp\\NullCancellationToken' => $vendorDir . '/amphp/amp/lib/NullCancellationToken.php', 'Amp\\Parallel\\Context\\Context' => $vendorDir . '/amphp/parallel/lib/Context/Context.php', 'Amp\\Parallel\\Context\\ContextException' => $vendorDir . '/amphp/parallel/lib/Context/ContextException.php', 'Amp\\Parallel\\Context\\ContextFactory' => $vendorDir . '/amphp/parallel/lib/Context/ContextFactory.php', 'Amp\\Parallel\\Context\\DefaultContextFactory' => $vendorDir . '/amphp/parallel/lib/Context/DefaultContextFactory.php', 'Amp\\Parallel\\Context\\Internal\\ParallelHub' => $vendorDir . '/amphp/parallel/lib/Context/Internal/ParallelHub.php', 'Amp\\Parallel\\Context\\Internal\\ProcessHub' => $vendorDir . '/amphp/parallel/lib/Context/Internal/ProcessHub.php', 'Amp\\Parallel\\Context\\Internal\\Thread' => $vendorDir . '/amphp/parallel/lib/Context/Internal/Thread.php', 'Amp\\Parallel\\Context\\Parallel' => $vendorDir . '/amphp/parallel/lib/Context/Parallel.php', 'Amp\\Parallel\\Context\\Process' => $vendorDir . '/amphp/parallel/lib/Context/Process.php', 'Amp\\Parallel\\Context\\StatusError' => $vendorDir . '/amphp/parallel/lib/Context/StatusError.php', 'Amp\\Parallel\\Context\\Thread' => $vendorDir . '/amphp/parallel/lib/Context/Thread.php', 'Amp\\Parallel\\Sync\\Channel' => $vendorDir . '/amphp/parallel/lib/Sync/Channel.php', 'Amp\\Parallel\\Sync\\ChannelException' => $vendorDir . '/amphp/parallel/lib/Sync/ChannelException.php', 'Amp\\Parallel\\Sync\\ChannelParser' => $vendorDir . '/amphp/parallel/lib/Sync/ChannelParser.php', 'Amp\\Parallel\\Sync\\ChannelledSocket' => $vendorDir . '/amphp/parallel/lib/Sync/ChannelledSocket.php', 'Amp\\Parallel\\Sync\\ChannelledStream' => $vendorDir . '/amphp/parallel/lib/Sync/ChannelledStream.php', 'Amp\\Parallel\\Sync\\ContextPanicError' => $vendorDir . '/amphp/parallel/lib/Sync/ContextPanicError.php', 'Amp\\Parallel\\Sync\\ExitFailure' => $vendorDir . '/amphp/parallel/lib/Sync/ExitFailure.php', 'Amp\\Parallel\\Sync\\ExitResult' => $vendorDir . '/amphp/parallel/lib/Sync/ExitResult.php', 'Amp\\Parallel\\Sync\\ExitSuccess' => $vendorDir . '/amphp/parallel/lib/Sync/ExitSuccess.php', 'Amp\\Parallel\\Sync\\Internal\\ParcelStorage' => $vendorDir . '/amphp/parallel/lib/Sync/Internal/ParcelStorage.php', 'Amp\\Parallel\\Sync\\PanicError' => $vendorDir . '/amphp/parallel/lib/Sync/PanicError.php', 'Amp\\Parallel\\Sync\\Parcel' => $vendorDir . '/amphp/parallel/lib/Sync/Parcel.php', 'Amp\\Parallel\\Sync\\ParcelException' => $vendorDir . '/amphp/parallel/lib/Sync/ParcelException.php', 'Amp\\Parallel\\Sync\\SharedMemoryException' => $vendorDir . '/amphp/parallel/lib/Sync/SharedMemoryException.php', 'Amp\\Parallel\\Sync\\SharedMemoryParcel' => $vendorDir . '/amphp/parallel/lib/Sync/SharedMemoryParcel.php', 'Amp\\Parallel\\Sync\\SynchronizationError' => $vendorDir . '/amphp/parallel/lib/Sync/SynchronizationError.php', 'Amp\\Parallel\\Sync\\ThreadedParcel' => $vendorDir . '/amphp/parallel/lib/Sync/ThreadedParcel.php', 'Amp\\Parallel\\Worker\\BasicEnvironment' => $vendorDir . '/amphp/parallel/lib/Worker/BasicEnvironment.php', 'Amp\\Parallel\\Worker\\BootstrapWorkerFactory' => $vendorDir . '/amphp/parallel/lib/Worker/BootstrapWorkerFactory.php', 'Amp\\Parallel\\Worker\\CallableTask' => $vendorDir . '/amphp/parallel/lib/Worker/CallableTask.php', 'Amp\\Parallel\\Worker\\DefaultPool' => $vendorDir . '/amphp/parallel/lib/Worker/DefaultPool.php', 'Amp\\Parallel\\Worker\\DefaultWorkerFactory' => $vendorDir . '/amphp/parallel/lib/Worker/DefaultWorkerFactory.php', 'Amp\\Parallel\\Worker\\Environment' => $vendorDir . '/amphp/parallel/lib/Worker/Environment.php', 'Amp\\Parallel\\Worker\\Internal\\Job' => $vendorDir . '/amphp/parallel/lib/Worker/Internal/Job.php', 'Amp\\Parallel\\Worker\\Internal\\PooledWorker' => $vendorDir . '/amphp/parallel/lib/Worker/Internal/PooledWorker.php', 'Amp\\Parallel\\Worker\\Internal\\TaskFailure' => $vendorDir . '/amphp/parallel/lib/Worker/Internal/TaskFailure.php', 'Amp\\Parallel\\Worker\\Internal\\TaskResult' => $vendorDir . '/amphp/parallel/lib/Worker/Internal/TaskResult.php', 'Amp\\Parallel\\Worker\\Internal\\TaskSuccess' => $vendorDir . '/amphp/parallel/lib/Worker/Internal/TaskSuccess.php', 'Amp\\Parallel\\Worker\\Internal\\WorkerProcess' => $vendorDir . '/amphp/parallel/lib/Worker/Internal/WorkerProcess.php', 'Amp\\Parallel\\Worker\\Pool' => $vendorDir . '/amphp/parallel/lib/Worker/Pool.php', 'Amp\\Parallel\\Worker\\Task' => $vendorDir . '/amphp/parallel/lib/Worker/Task.php', 'Amp\\Parallel\\Worker\\TaskError' => $vendorDir . '/amphp/parallel/lib/Worker/TaskError.php', 'Amp\\Parallel\\Worker\\TaskException' => $vendorDir . '/amphp/parallel/lib/Worker/TaskException.php', 'Amp\\Parallel\\Worker\\TaskFailureError' => $vendorDir . '/amphp/parallel/lib/Worker/TaskFailureError.php', 'Amp\\Parallel\\Worker\\TaskFailureException' => $vendorDir . '/amphp/parallel/lib/Worker/TaskFailureException.php', 'Amp\\Parallel\\Worker\\TaskFailureThrowable' => $vendorDir . '/amphp/parallel/lib/Worker/TaskFailureThrowable.php', 'Amp\\Parallel\\Worker\\TaskRunner' => $vendorDir . '/amphp/parallel/lib/Worker/TaskRunner.php', 'Amp\\Parallel\\Worker\\TaskWorker' => $vendorDir . '/amphp/parallel/lib/Worker/TaskWorker.php', 'Amp\\Parallel\\Worker\\Worker' => $vendorDir . '/amphp/parallel/lib/Worker/Worker.php', 'Amp\\Parallel\\Worker\\WorkerException' => $vendorDir . '/amphp/parallel/lib/Worker/WorkerException.php', 'Amp\\Parallel\\Worker\\WorkerFactory' => $vendorDir . '/amphp/parallel/lib/Worker/WorkerFactory.php', 'Amp\\Parallel\\Worker\\WorkerParallel' => $vendorDir . '/amphp/parallel/lib/Worker/WorkerParallel.php', 'Amp\\Parallel\\Worker\\WorkerProcess' => $vendorDir . '/amphp/parallel/lib/Worker/WorkerProcess.php', 'Amp\\Parallel\\Worker\\WorkerThread' => $vendorDir . '/amphp/parallel/lib/Worker/WorkerThread.php', 'Amp\\Parser\\InvalidDelimiterError' => $vendorDir . '/amphp/parser/src/InvalidDelimiterError.php', 'Amp\\Parser\\Parser' => $vendorDir . '/amphp/parser/src/Parser.php', 'Amp\\Postgres\\Connection' => $vendorDir . '/amphp/postgres/src/Connection.php', 'Amp\\Postgres\\ConnectionConfig' => $vendorDir . '/amphp/postgres/src/ConnectionConfig.php', 'Amp\\Postgres\\ConnectionListener' => $vendorDir . '/amphp/postgres/src/ConnectionListener.php', 'Amp\\Postgres\\ConnectionTransaction' => $vendorDir . '/amphp/postgres/src/ConnectionTransaction.php', 'Amp\\Postgres\\Executor' => $vendorDir . '/amphp/postgres/src/Executor.php', 'Amp\\Postgres\\Handle' => $vendorDir . '/amphp/postgres/src/Handle.php', 'Amp\\Postgres\\Internal\\ArrayParser' => $vendorDir . '/amphp/postgres/src/Internal/ArrayParser.php', 'Amp\\Postgres\\Link' => $vendorDir . '/amphp/postgres/src/Link.php', 'Amp\\Postgres\\Listener' => $vendorDir . '/amphp/postgres/src/Listener.php', 'Amp\\Postgres\\Notification' => $vendorDir . '/amphp/postgres/src/Notification.php', 'Amp\\Postgres\\ParseException' => $vendorDir . '/amphp/postgres/src/ParseException.php', 'Amp\\Postgres\\PgSqlCommandResult' => $vendorDir . '/amphp/postgres/src/PgSqlCommandResult.php', 'Amp\\Postgres\\PgSqlConnection' => $vendorDir . '/amphp/postgres/src/PgSqlConnection.php', 'Amp\\Postgres\\PgSqlHandle' => $vendorDir . '/amphp/postgres/src/PgSqlHandle.php', 'Amp\\Postgres\\PgSqlResultSet' => $vendorDir . '/amphp/postgres/src/PgSqlResultSet.php', 'Amp\\Postgres\\PgSqlStatement' => $vendorDir . '/amphp/postgres/src/PgSqlStatement.php', 'Amp\\Postgres\\Pool' => $vendorDir . '/amphp/postgres/src/Pool.php', 'Amp\\Postgres\\PooledListener' => $vendorDir . '/amphp/postgres/src/PooledListener.php', 'Amp\\Postgres\\PooledResultSet' => $vendorDir . '/amphp/postgres/src/PooledResultSet.php', 'Amp\\Postgres\\PooledStatement' => $vendorDir . '/amphp/postgres/src/PooledStatement.php', 'Amp\\Postgres\\PooledTransaction' => $vendorDir . '/amphp/postgres/src/PooledTransaction.php', 'Amp\\Postgres\\PqBufferedResultSet' => $vendorDir . '/amphp/postgres/src/PqBufferedResultSet.php', 'Amp\\Postgres\\PqCommandResult' => $vendorDir . '/amphp/postgres/src/PqCommandResult.php', 'Amp\\Postgres\\PqConnection' => $vendorDir . '/amphp/postgres/src/PqConnection.php', 'Amp\\Postgres\\PqHandle' => $vendorDir . '/amphp/postgres/src/PqHandle.php', 'Amp\\Postgres\\PqStatement' => $vendorDir . '/amphp/postgres/src/PqStatement.php', 'Amp\\Postgres\\PqUnbufferedResultSet' => $vendorDir . '/amphp/postgres/src/PqUnbufferedResultSet.php', 'Amp\\Postgres\\QueryExecutionError' => $vendorDir . '/amphp/postgres/src/QueryExecutionError.php', 'Amp\\Postgres\\Quoter' => $vendorDir . '/amphp/postgres/src/Quoter.php', 'Amp\\Postgres\\Receiver' => $vendorDir . '/amphp/postgres/src/Receiver.php', 'Amp\\Postgres\\ResultSet' => $vendorDir . '/amphp/postgres/src/ResultSet.php', 'Amp\\Postgres\\StatementPool' => $vendorDir . '/amphp/postgres/src/StatementPool.php', 'Amp\\Postgres\\TimeoutConnector' => $vendorDir . '/amphp/postgres/src/TimeoutConnector.php', 'Amp\\Postgres\\Transaction' => $vendorDir . '/amphp/postgres/src/Transaction.php', 'Amp\\Process\\Internal\\Posix\\Handle' => $vendorDir . '/amphp/process/lib/Internal/Posix/Handle.php', 'Amp\\Process\\Internal\\Posix\\Runner' => $vendorDir . '/amphp/process/lib/Internal/Posix/Runner.php', 'Amp\\Process\\Internal\\ProcessHandle' => $vendorDir . '/amphp/process/lib/Internal/ProcessHandle.php', 'Amp\\Process\\Internal\\ProcessRunner' => $vendorDir . '/amphp/process/lib/Internal/ProcessRunner.php', 'Amp\\Process\\Internal\\ProcessStatus' => $vendorDir . '/amphp/process/lib/Internal/ProcessStatus.php', 'Amp\\Process\\Internal\\Windows\\Handle' => $vendorDir . '/amphp/process/lib/Internal/Windows/Handle.php', 'Amp\\Process\\Internal\\Windows\\HandshakeStatus' => $vendorDir . '/amphp/process/lib/Internal/Windows/HandshakeStatus.php', 'Amp\\Process\\Internal\\Windows\\PendingSocketClient' => $vendorDir . '/amphp/process/lib/Internal/Windows/PendingSocketClient.php', 'Amp\\Process\\Internal\\Windows\\Runner' => $vendorDir . '/amphp/process/lib/Internal/Windows/Runner.php', 'Amp\\Process\\Internal\\Windows\\SignalCode' => $vendorDir . '/amphp/process/lib/Internal/Windows/SignalCode.php', 'Amp\\Process\\Internal\\Windows\\SocketConnector' => $vendorDir . '/amphp/process/lib/Internal/Windows/SocketConnector.php', 'Amp\\Process\\Process' => $vendorDir . '/amphp/process/lib/Process.php', 'Amp\\Process\\ProcessException' => $vendorDir . '/amphp/process/lib/ProcessException.php', 'Amp\\Process\\ProcessInputStream' => $vendorDir . '/amphp/process/lib/ProcessInputStream.php', 'Amp\\Process\\ProcessOutputStream' => $vendorDir . '/amphp/process/lib/ProcessOutputStream.php', 'Amp\\Process\\StatusError' => $vendorDir . '/amphp/process/lib/StatusError.php', 'Amp\\Producer' => $vendorDir . '/amphp/amp/lib/Producer.php', 'Amp\\Promise' => $vendorDir . '/amphp/amp/lib/Promise.php', 'Amp\\Redis\\Cache' => $vendorDir . '/amphp/redis/src/Cache.php', 'Amp\\Redis\\Config' => $vendorDir . '/amphp/redis/src/Config.php', 'Amp\\Redis\\Mutex\\ConnectionLimitException' => $vendorDir . '/amphp/redis/src/Mutex/ConnectionLimitException.php', 'Amp\\Redis\\Mutex\\LockException' => $vendorDir . '/amphp/redis/src/Mutex/LockException.php', 'Amp\\Redis\\Mutex\\Mutex' => $vendorDir . '/amphp/redis/src/Mutex/Mutex.php', 'Amp\\Redis\\Mutex\\MutexException' => $vendorDir . '/amphp/redis/src/Mutex/MutexException.php', 'Amp\\Redis\\Mutex\\MutexOptions' => $vendorDir . '/amphp/redis/src/Mutex/MutexOptions.php', 'Amp\\Redis\\ParserException' => $vendorDir . '/amphp/redis/src/ParserException.php', 'Amp\\Redis\\QueryException' => $vendorDir . '/amphp/redis/src/QueryException.php', 'Amp\\Redis\\QueryExecutor' => $vendorDir . '/amphp/redis/src/QueryExecutor.php', 'Amp\\Redis\\QueryExecutorFactory' => $vendorDir . '/amphp/redis/src/QueryExecutorFactory.php', 'Amp\\Redis\\Redis' => $vendorDir . '/amphp/redis/src/Redis.php', 'Amp\\Redis\\RedisException' => $vendorDir . '/amphp/redis/src/RedisException.php', 'Amp\\Redis\\RedisHyperLogLog' => $vendorDir . '/amphp/redis/src/RedisHyperLogLog.php', 'Amp\\Redis\\RedisList' => $vendorDir . '/amphp/redis/src/RedisList.php', 'Amp\\Redis\\RedisMap' => $vendorDir . '/amphp/redis/src/RedisMap.php', 'Amp\\Redis\\RedisSet' => $vendorDir . '/amphp/redis/src/RedisSet.php', 'Amp\\Redis\\RedisSortedSet' => $vendorDir . '/amphp/redis/src/RedisSortedSet.php', 'Amp\\Redis\\RemoteExecutor' => $vendorDir . '/amphp/redis/src/RemoteExecutor.php', 'Amp\\Redis\\RemoteExecutorFactory' => $vendorDir . '/amphp/redis/src/RemoteExecutorFactory.php', 'Amp\\Redis\\RespParser' => $vendorDir . '/amphp/redis/src/RespParser.php', 'Amp\\Redis\\RespSocket' => $vendorDir . '/amphp/redis/src/RespSocket.php', 'Amp\\Redis\\SetOptions' => $vendorDir . '/amphp/redis/src/SetOptions.php', 'Amp\\Redis\\SocketException' => $vendorDir . '/amphp/redis/src/SocketException.php', 'Amp\\Redis\\SortOptions' => $vendorDir . '/amphp/redis/src/SortOptions.php', 'Amp\\Redis\\Subscriber' => $vendorDir . '/amphp/redis/src/Subscriber.php', 'Amp\\Redis\\Subscription' => $vendorDir . '/amphp/redis/src/Subscription.php', 'Amp\\Serialization\\CompressingSerializer' => $vendorDir . '/amphp/serialization/src/CompressingSerializer.php', 'Amp\\Serialization\\JsonSerializer' => $vendorDir . '/amphp/serialization/src/JsonSerializer.php', 'Amp\\Serialization\\NativeSerializer' => $vendorDir . '/amphp/serialization/src/NativeSerializer.php', 'Amp\\Serialization\\PassthroughSerializer' => $vendorDir . '/amphp/serialization/src/PassthroughSerializer.php', 'Amp\\Serialization\\SerializationException' => $vendorDir . '/amphp/serialization/src/SerializationException.php', 'Amp\\Serialization\\Serializer' => $vendorDir . '/amphp/serialization/src/Serializer.php', 'Amp\\Socket\\BindContext' => $vendorDir . '/amphp/socket/src/BindContext.php', 'Amp\\Socket\\Certificate' => $vendorDir . '/amphp/socket/src/Certificate.php', 'Amp\\Socket\\ClientTlsContext' => $vendorDir . '/amphp/socket/src/ClientTlsContext.php', 'Amp\\Socket\\ConnectContext' => $vendorDir . '/amphp/socket/src/ConnectContext.php', 'Amp\\Socket\\ConnectException' => $vendorDir . '/amphp/socket/src/ConnectException.php', 'Amp\\Socket\\Connector' => $vendorDir . '/amphp/socket/src/Connector.php', 'Amp\\Socket\\DatagramSocket' => $vendorDir . '/amphp/socket/src/DatagramSocket.php', 'Amp\\Socket\\DnsConnector' => $vendorDir . '/amphp/socket/src/DnsConnector.php', 'Amp\\Socket\\EncryptableSocket' => $vendorDir . '/amphp/socket/src/EncryptableSocket.php', 'Amp\\Socket\\PendingAcceptError' => $vendorDir . '/amphp/socket/src/PendingAcceptError.php', 'Amp\\Socket\\PendingReceiveError' => $vendorDir . '/amphp/socket/src/PendingReceiveError.php', 'Amp\\Socket\\ResourceSocket' => $vendorDir . '/amphp/socket/src/ResourceSocket.php', 'Amp\\Socket\\Server' => $vendorDir . '/amphp/socket/src/Server.php', 'Amp\\Socket\\ServerTlsContext' => $vendorDir . '/amphp/socket/src/ServerTlsContext.php', 'Amp\\Socket\\Socket' => $vendorDir . '/amphp/socket/src/Socket.php', 'Amp\\Socket\\SocketAddress' => $vendorDir . '/amphp/socket/src/SocketAddress.php', 'Amp\\Socket\\SocketException' => $vendorDir . '/amphp/socket/src/SocketException.php', 'Amp\\Socket\\SocketPool' => $vendorDir . '/amphp/socket/src/SocketPool.php', 'Amp\\Socket\\StaticConnector' => $vendorDir . '/amphp/socket/src/StaticConnector.php', 'Amp\\Socket\\TlsException' => $vendorDir . '/amphp/socket/src/TlsException.php', 'Amp\\Socket\\TlsInfo' => $vendorDir . '/amphp/socket/src/TlsInfo.php', 'Amp\\Socket\\UnlimitedSocketPool' => $vendorDir . '/amphp/socket/src/UnlimitedSocketPool.php', 'Amp\\Sql\\CommandResult' => $vendorDir . '/amphp/sql/src/CommandResult.php', 'Amp\\Sql\\Common\\ConnectionPool' => $vendorDir . '/amphp/sql-common/src/ConnectionPool.php', 'Amp\\Sql\\Common\\PooledResultSet' => $vendorDir . '/amphp/sql-common/src/PooledResultSet.php', 'Amp\\Sql\\Common\\PooledStatement' => $vendorDir . '/amphp/sql-common/src/PooledStatement.php', 'Amp\\Sql\\Common\\PooledTransaction' => $vendorDir . '/amphp/sql-common/src/PooledTransaction.php', 'Amp\\Sql\\Common\\RetryConnector' => $vendorDir . '/amphp/sql-common/src/RetryConnector.php', 'Amp\\Sql\\Common\\StatementPool' => $vendorDir . '/amphp/sql-common/src/StatementPool.php', 'Amp\\Sql\\ConnectionConfig' => $vendorDir . '/amphp/sql/src/ConnectionConfig.php', 'Amp\\Sql\\ConnectionException' => $vendorDir . '/amphp/sql/src/ConnectionException.php', 'Amp\\Sql\\Connector' => $vendorDir . '/amphp/sql/src/Connector.php', 'Amp\\Sql\\Executor' => $vendorDir . '/amphp/sql/src/Executor.php', 'Amp\\Sql\\FailureException' => $vendorDir . '/amphp/sql/src/FailureException.php', 'Amp\\Sql\\Link' => $vendorDir . '/amphp/sql/src/Link.php', 'Amp\\Sql\\Pool' => $vendorDir . '/amphp/sql/src/Pool.php', 'Amp\\Sql\\PoolError' => $vendorDir . '/amphp/sql/src/PoolError.php', 'Amp\\Sql\\QueryError' => $vendorDir . '/amphp/sql/src/QueryError.php', 'Amp\\Sql\\ResultSet' => $vendorDir . '/amphp/sql/src/ResultSet.php', 'Amp\\Sql\\Statement' => $vendorDir . '/amphp/sql/src/Statement.php', 'Amp\\Sql\\Transaction' => $vendorDir . '/amphp/sql/src/Transaction.php', 'Amp\\Sql\\TransactionError' => $vendorDir . '/amphp/sql/src/TransactionError.php', 'Amp\\Sql\\TransientResource' => $vendorDir . '/amphp/sql/src/TransientResource.php', 'Amp\\Struct' => $vendorDir . '/amphp/amp/lib/Struct.php', 'Amp\\Success' => $vendorDir . '/amphp/amp/lib/Success.php', 'Amp\\Sync\\Barrier' => $vendorDir . '/amphp/sync/src/Barrier.php', 'Amp\\Sync\\FileMutex' => $vendorDir . '/amphp/sync/src/FileMutex.php', 'Amp\\Sync\\Internal\\MutexStorage' => $vendorDir . '/amphp/sync/src/Internal/MutexStorage.php', 'Amp\\Sync\\Internal\\SemaphoreStorage' => $vendorDir . '/amphp/sync/src/Internal/SemaphoreStorage.php', 'Amp\\Sync\\KeyedMutex' => $vendorDir . '/amphp/sync/src/KeyedMutex.php', 'Amp\\Sync\\KeyedSemaphore' => $vendorDir . '/amphp/sync/src/KeyedSemaphore.php', 'Amp\\Sync\\LocalKeyedMutex' => $vendorDir . '/amphp/sync/src/LocalKeyedMutex.php', 'Amp\\Sync\\LocalKeyedSemaphore' => $vendorDir . '/amphp/sync/src/LocalKeyedSemaphore.php', 'Amp\\Sync\\LocalMutex' => $vendorDir . '/amphp/sync/src/LocalMutex.php', 'Amp\\Sync\\LocalSemaphore' => $vendorDir . '/amphp/sync/src/LocalSemaphore.php', 'Amp\\Sync\\Lock' => $vendorDir . '/amphp/sync/src/Lock.php', 'Amp\\Sync\\Mutex' => $vendorDir . '/amphp/sync/src/Mutex.php', 'Amp\\Sync\\PosixSemaphore' => $vendorDir . '/amphp/sync/src/PosixSemaphore.php', 'Amp\\Sync\\PrefixedKeyedMutex' => $vendorDir . '/amphp/sync/src/PrefixedKeyedMutex.php', 'Amp\\Sync\\PrefixedKeyedSemaphore' => $vendorDir . '/amphp/sync/src/PrefixedKeyedSemaphore.php', 'Amp\\Sync\\Semaphore' => $vendorDir . '/amphp/sync/src/Semaphore.php', 'Amp\\Sync\\SemaphoreMutex' => $vendorDir . '/amphp/sync/src/SemaphoreMutex.php', 'Amp\\Sync\\StaticKeyMutex' => $vendorDir . '/amphp/sync/src/StaticKeyMutex.php', 'Amp\\Sync\\SyncException' => $vendorDir . '/amphp/sync/src/SyncException.php', 'Amp\\Sync\\ThreadedMutex' => $vendorDir . '/amphp/sync/src/ThreadedMutex.php', 'Amp\\Sync\\ThreadedSemaphore' => $vendorDir . '/amphp/sync/src/ThreadedSemaphore.php', 'Amp\\TimeoutCancellationToken' => $vendorDir . '/amphp/amp/lib/TimeoutCancellationToken.php', 'Amp\\TimeoutException' => $vendorDir . '/amphp/amp/lib/TimeoutException.php', 'Amp\\Websocket\\Client' => $vendorDir . '/amphp/websocket/src/Client.php', 'Amp\\Websocket\\ClientMetadata' => $vendorDir . '/amphp/websocket/src/ClientMetadata.php', 'Amp\\Websocket\\Client\\Connection' => $vendorDir . '/amphp/websocket-client/src/Connection.php', 'Amp\\Websocket\\Client\\ConnectionException' => $vendorDir . '/amphp/websocket-client/src/ConnectionException.php', 'Amp\\Websocket\\Client\\ConnectionFactory' => $vendorDir . '/amphp/websocket-client/src/ConnectionFactory.php', 'Amp\\Websocket\\Client\\Connector' => $vendorDir . '/amphp/websocket-client/src/Connector.php', 'Amp\\Websocket\\Client\\Handshake' => $vendorDir . '/amphp/websocket-client/src/Handshake.php', 'Amp\\Websocket\\Client\\Rfc6455Connection' => $vendorDir . '/amphp/websocket-client/src/Rfc6455Connection.php', 'Amp\\Websocket\\Client\\Rfc6455ConnectionFactory' => $vendorDir . '/amphp/websocket-client/src/Rfc6455ConnectionFactory.php', 'Amp\\Websocket\\Client\\Rfc6455Connector' => $vendorDir . '/amphp/websocket-client/src/Rfc6455Connector.php', 'Amp\\Websocket\\ClosedException' => $vendorDir . '/amphp/websocket/src/ClosedException.php', 'Amp\\Websocket\\Code' => $vendorDir . '/amphp/websocket/src/Code.php', 'Amp\\Websocket\\CompressionContext' => $vendorDir . '/amphp/websocket/src/CompressionContext.php', 'Amp\\Websocket\\CompressionContextFactory' => $vendorDir . '/amphp/websocket/src/CompressionContextFactory.php', 'Amp\\Websocket\\Message' => $vendorDir . '/amphp/websocket/src/Message.php', 'Amp\\Websocket\\Opcode' => $vendorDir . '/amphp/websocket/src/Opcode.php', 'Amp\\Websocket\\Options' => $vendorDir . '/amphp/websocket/src/Options.php', 'Amp\\Websocket\\Rfc6455Client' => $vendorDir . '/amphp/websocket/src/Rfc6455Client.php', 'Amp\\Websocket\\Rfc7692Compression' => $vendorDir . '/amphp/websocket/src/Rfc7692Compression.php', 'Amp\\Websocket\\Rfc7692CompressionFactory' => $vendorDir . '/amphp/websocket/src/Rfc7692CompressionFactory.php', 'Amp\\WindowsRegistry\\KeyNotFoundException' => $vendorDir . '/amphp/windows-registry/lib/KeyNotFoundException.php', 'Amp\\WindowsRegistry\\WindowsRegistry' => $vendorDir . '/amphp/windows-registry/lib/WindowsRegistry.php', 'Attribute' => $vendorDir . '/symfony/polyfill-php80/Resources/stubs/Attribute.php', 'Composer\\InstalledVersions' => $vendorDir . '/composer/InstalledVersions.php', 'Kelunik\\Certificate\\Certificate' => $vendorDir . '/kelunik/certificate/lib/Certificate.php', 'Kelunik\\Certificate\\FieldNotSupportedException' => $vendorDir . '/kelunik/certificate/lib/FieldNotSupportedException.php', 'Kelunik\\Certificate\\InvalidCertificateException' => $vendorDir . '/kelunik/certificate/lib/InvalidCertificateException.php', 'Kelunik\\Certificate\\Profile' => $vendorDir . '/kelunik/certificate/lib/Profile.php', 'League\\Uri\\Contracts\\AuthorityInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/AuthorityInterface.php', 'League\\Uri\\Contracts\\DataPathInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/DataPathInterface.php', 'League\\Uri\\Contracts\\DomainHostInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/DomainHostInterface.php', 'League\\Uri\\Contracts\\FragmentInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/FragmentInterface.php', 'League\\Uri\\Contracts\\HostInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/HostInterface.php', 'League\\Uri\\Contracts\\IpHostInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/IpHostInterface.php', 'League\\Uri\\Contracts\\PathInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/PathInterface.php', 'League\\Uri\\Contracts\\PortInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/PortInterface.php', 'League\\Uri\\Contracts\\QueryInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/QueryInterface.php', 'League\\Uri\\Contracts\\SegmentedPathInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/SegmentedPathInterface.php', 'League\\Uri\\Contracts\\UriComponentInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/UriComponentInterface.php', 'League\\Uri\\Contracts\\UriException' => $vendorDir . '/league/uri-interfaces/src/Contracts/UriException.php', 'League\\Uri\\Contracts\\UriInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/UriInterface.php', 'League\\Uri\\Contracts\\UserInfoInterface' => $vendorDir . '/league/uri-interfaces/src/Contracts/UserInfoInterface.php', 'League\\Uri\\Exception' => $vendorDir . '/league/uri-parser/src/Exception.php', 'League\\Uri\\Exceptions\\FileinfoSupportMissing' => $vendorDir . '/league/uri-interfaces/src/Exceptions/FileinfoSupportMissing.php', 'League\\Uri\\Exceptions\\IdnSupportMissing' => $vendorDir . '/league/uri-interfaces/src/Exceptions/IdnSupportMissing.php', 'League\\Uri\\Exceptions\\IdnaConversionFailed' => $vendorDir . '/league/uri-interfaces/src/Exceptions/IdnaConversionFailed.php', 'League\\Uri\\Exceptions\\SyntaxError' => $vendorDir . '/league/uri-interfaces/src/Exceptions/SyntaxError.php', 'League\\Uri\\Exceptions\\TemplateCanNotBeExpanded' => $vendorDir . '/league/uri/src/Exceptions/TemplateCanNotBeExpanded.php', 'League\\Uri\\Http' => $vendorDir . '/league/uri/src/Http.php', 'League\\Uri\\HttpFactory' => $vendorDir . '/league/uri/src/HttpFactory.php', 'League\\Uri\\Idna\\Idna' => $vendorDir . '/league/uri-interfaces/src/Idna/Idna.php', 'League\\Uri\\Idna\\IdnaInfo' => $vendorDir . '/league/uri-interfaces/src/Idna/IdnaInfo.php', 'League\\Uri\\MissingIdnSupport' => $vendorDir . '/league/uri-parser/src/MissingIdnSupport.php', 'League\\Uri\\Parser' => $vendorDir . '/league/uri-parser/src/Parser.php', 'League\\Uri\\Uri' => $vendorDir . '/league/uri/src/Uri.php', 'League\\Uri\\UriInfo' => $vendorDir . '/league/uri/src/UriInfo.php', 'League\\Uri\\UriResolver' => $vendorDir . '/league/uri/src/UriResolver.php', 'League\\Uri\\UriString' => $vendorDir . '/league/uri/src/UriString.php', 'League\\Uri\\UriTemplate' => $vendorDir . '/league/uri/src/UriTemplate.php', 'League\\Uri\\UriTemplate\\Expression' => $vendorDir . '/league/uri/src/UriTemplate/Expression.php', 'League\\Uri\\UriTemplate\\Template' => $vendorDir . '/league/uri/src/UriTemplate/Template.php', 'League\\Uri\\UriTemplate\\VarSpecifier' => $vendorDir . '/league/uri/src/UriTemplate/VarSpecifier.php', 'League\\Uri\\UriTemplate\\VariableBag' => $vendorDir . '/league/uri/src/UriTemplate/VariableBag.php', 'LibDNS\\Decoder\\Decoder' => $vendorDir . '/daverandom/libdns/src/Decoder/Decoder.php', 'LibDNS\\Decoder\\DecoderFactory' => $vendorDir . '/daverandom/libdns/src/Decoder/DecoderFactory.php', 'LibDNS\\Decoder\\DecodingContext' => $vendorDir . '/daverandom/libdns/src/Decoder/DecodingContext.php', 'LibDNS\\Decoder\\DecodingContextFactory' => $vendorDir . '/daverandom/libdns/src/Decoder/DecodingContextFactory.php', 'LibDNS\\Encoder\\Encoder' => $vendorDir . '/daverandom/libdns/src/Encoder/Encoder.php', 'LibDNS\\Encoder\\EncoderFactory' => $vendorDir . '/daverandom/libdns/src/Encoder/EncoderFactory.php', 'LibDNS\\Encoder\\EncodingContext' => $vendorDir . '/daverandom/libdns/src/Encoder/EncodingContext.php', 'LibDNS\\Encoder\\EncodingContextFactory' => $vendorDir . '/daverandom/libdns/src/Encoder/EncodingContextFactory.php', 'LibDNS\\Enumeration' => $vendorDir . '/daverandom/libdns/src/Enumeration.php', 'LibDNS\\Messages\\Message' => $vendorDir . '/daverandom/libdns/src/Messages/Message.php', 'LibDNS\\Messages\\MessageFactory' => $vendorDir . '/daverandom/libdns/src/Messages/MessageFactory.php', 'LibDNS\\Messages\\MessageOpCodes' => $vendorDir . '/daverandom/libdns/src/Messages/MessageOpCodes.php', 'LibDNS\\Messages\\MessageResponseCodes' => $vendorDir . '/daverandom/libdns/src/Messages/MessageResponseCodes.php', 'LibDNS\\Messages\\MessageTypes' => $vendorDir . '/daverandom/libdns/src/Messages/MessageTypes.php', 'LibDNS\\Packets\\LabelRegistry' => $vendorDir . '/daverandom/libdns/src/Packets/LabelRegistry.php', 'LibDNS\\Packets\\Packet' => $vendorDir . '/daverandom/libdns/src/Packets/Packet.php', 'LibDNS\\Packets\\PacketFactory' => $vendorDir . '/daverandom/libdns/src/Packets/PacketFactory.php', 'LibDNS\\Records\\Question' => $vendorDir . '/daverandom/libdns/src/Records/Question.php', 'LibDNS\\Records\\QuestionFactory' => $vendorDir . '/daverandom/libdns/src/Records/QuestionFactory.php', 'LibDNS\\Records\\RData' => $vendorDir . '/daverandom/libdns/src/Records/RData.php', 'LibDNS\\Records\\RDataBuilder' => $vendorDir . '/daverandom/libdns/src/Records/RDataBuilder.php', 'LibDNS\\Records\\RDataFactory' => $vendorDir . '/daverandom/libdns/src/Records/RDataFactory.php', 'LibDNS\\Records\\Record' => $vendorDir . '/daverandom/libdns/src/Records/Record.php', 'LibDNS\\Records\\RecordCollection' => $vendorDir . '/daverandom/libdns/src/Records/RecordCollection.php', 'LibDNS\\Records\\RecordCollectionFactory' => $vendorDir . '/daverandom/libdns/src/Records/RecordCollectionFactory.php', 'LibDNS\\Records\\RecordTypes' => $vendorDir . '/daverandom/libdns/src/Records/RecordTypes.php', 'LibDNS\\Records\\Resource' => $vendorDir . '/daverandom/libdns/src/Records/Resource.php', 'LibDNS\\Records\\ResourceBuilder' => $vendorDir . '/daverandom/libdns/src/Records/ResourceBuilder.php', 'LibDNS\\Records\\ResourceBuilderFactory' => $vendorDir . '/daverandom/libdns/src/Records/ResourceBuilderFactory.php', 'LibDNS\\Records\\ResourceClasses' => $vendorDir . '/daverandom/libdns/src/Records/ResourceClasses.php', 'LibDNS\\Records\\ResourceFactory' => $vendorDir . '/daverandom/libdns/src/Records/ResourceFactory.php', 'LibDNS\\Records\\ResourceQClasses' => $vendorDir . '/daverandom/libdns/src/Records/ResourceQClasses.php', 'LibDNS\\Records\\ResourceQTypes' => $vendorDir . '/daverandom/libdns/src/Records/ResourceQTypes.php', 'LibDNS\\Records\\ResourceTypes' => $vendorDir . '/daverandom/libdns/src/Records/ResourceTypes.php', 'LibDNS\\Records\\TypeDefinitions\\FieldDefinition' => $vendorDir . '/daverandom/libdns/src/Records/TypeDefinitions/FieldDefinition.php', 'LibDNS\\Records\\TypeDefinitions\\FieldDefinitionFactory' => $vendorDir . '/daverandom/libdns/src/Records/TypeDefinitions/FieldDefinitionFactory.php', 'LibDNS\\Records\\TypeDefinitions\\TypeDefinition' => $vendorDir . '/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinition.php', 'LibDNS\\Records\\TypeDefinitions\\TypeDefinitionFactory' => $vendorDir . '/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinitionFactory.php', 'LibDNS\\Records\\TypeDefinitions\\TypeDefinitionManager' => $vendorDir . '/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinitionManager.php', 'LibDNS\\Records\\TypeDefinitions\\TypeDefinitionManagerFactory' => $vendorDir . '/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinitionManagerFactory.php', 'LibDNS\\Records\\Types\\Anything' => $vendorDir . '/daverandom/libdns/src/Records/Types/Anything.php', 'LibDNS\\Records\\Types\\BitMap' => $vendorDir . '/daverandom/libdns/src/Records/Types/BitMap.php', 'LibDNS\\Records\\Types\\Char' => $vendorDir . '/daverandom/libdns/src/Records/Types/Char.php', 'LibDNS\\Records\\Types\\CharacterString' => $vendorDir . '/daverandom/libdns/src/Records/Types/CharacterString.php', 'LibDNS\\Records\\Types\\DomainName' => $vendorDir . '/daverandom/libdns/src/Records/Types/DomainName.php', 'LibDNS\\Records\\Types\\IPv4Address' => $vendorDir . '/daverandom/libdns/src/Records/Types/IPv4Address.php', 'LibDNS\\Records\\Types\\IPv6Address' => $vendorDir . '/daverandom/libdns/src/Records/Types/IPv6Address.php', 'LibDNS\\Records\\Types\\Long' => $vendorDir . '/daverandom/libdns/src/Records/Types/Long.php', 'LibDNS\\Records\\Types\\Short' => $vendorDir . '/daverandom/libdns/src/Records/Types/Short.php', 'LibDNS\\Records\\Types\\Type' => $vendorDir . '/daverandom/libdns/src/Records/Types/Type.php', 'LibDNS\\Records\\Types\\TypeBuilder' => $vendorDir . '/daverandom/libdns/src/Records/Types/TypeBuilder.php', 'LibDNS\\Records\\Types\\TypeFactory' => $vendorDir . '/daverandom/libdns/src/Records/Types/TypeFactory.php', 'LibDNS\\Records\\Types\\Types' => $vendorDir . '/daverandom/libdns/src/Records/Types/Types.php', 'Monolog\\Attribute\\AsMonologProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Attribute/AsMonologProcessor.php', 'Monolog\\DateTimeImmutable' => $vendorDir . '/monolog/monolog/src/Monolog/DateTimeImmutable.php', 'Monolog\\ErrorHandler' => $vendorDir . '/monolog/monolog/src/Monolog/ErrorHandler.php', 'Monolog\\Formatter\\ChromePHPFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/ChromePHPFormatter.php', 'Monolog\\Formatter\\ElasticaFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/ElasticaFormatter.php', 'Monolog\\Formatter\\ElasticsearchFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/ElasticsearchFormatter.php', 'Monolog\\Formatter\\FlowdockFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/FlowdockFormatter.php', 'Monolog\\Formatter\\FluentdFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/FluentdFormatter.php', 'Monolog\\Formatter\\FormatterInterface' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/FormatterInterface.php', 'Monolog\\Formatter\\GelfMessageFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/GelfMessageFormatter.php', 'Monolog\\Formatter\\GoogleCloudLoggingFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/GoogleCloudLoggingFormatter.php', 'Monolog\\Formatter\\HtmlFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/HtmlFormatter.php', 'Monolog\\Formatter\\JsonFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/JsonFormatter.php', 'Monolog\\Formatter\\LineFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/LineFormatter.php', 'Monolog\\Formatter\\LogglyFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/LogglyFormatter.php', 'Monolog\\Formatter\\LogmaticFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/LogmaticFormatter.php', 'Monolog\\Formatter\\LogstashFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/LogstashFormatter.php', 'Monolog\\Formatter\\MongoDBFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/MongoDBFormatter.php', 'Monolog\\Formatter\\NormalizerFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/NormalizerFormatter.php', 'Monolog\\Formatter\\ScalarFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/ScalarFormatter.php', 'Monolog\\Formatter\\WildfireFormatter' => $vendorDir . '/monolog/monolog/src/Monolog/Formatter/WildfireFormatter.php', 'Monolog\\Handler\\AbstractHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/AbstractHandler.php', 'Monolog\\Handler\\AbstractProcessingHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/AbstractProcessingHandler.php', 'Monolog\\Handler\\AbstractSyslogHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/AbstractSyslogHandler.php', 'Monolog\\Handler\\AmqpHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/AmqpHandler.php', 'Monolog\\Handler\\BrowserConsoleHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/BrowserConsoleHandler.php', 'Monolog\\Handler\\BufferHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/BufferHandler.php', 'Monolog\\Handler\\ChromePHPHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/ChromePHPHandler.php', 'Monolog\\Handler\\CouchDBHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/CouchDBHandler.php', 'Monolog\\Handler\\CubeHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/CubeHandler.php', 'Monolog\\Handler\\Curl\\Util' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/Curl/Util.php', 'Monolog\\Handler\\DeduplicationHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/DeduplicationHandler.php', 'Monolog\\Handler\\DoctrineCouchDBHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/DoctrineCouchDBHandler.php', 'Monolog\\Handler\\DynamoDbHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/DynamoDbHandler.php', 'Monolog\\Handler\\ElasticaHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/ElasticaHandler.php', 'Monolog\\Handler\\ElasticsearchHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/ElasticsearchHandler.php', 'Monolog\\Handler\\ErrorLogHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/ErrorLogHandler.php', 'Monolog\\Handler\\FallbackGroupHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/FallbackGroupHandler.php', 'Monolog\\Handler\\FilterHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/FilterHandler.php', 'Monolog\\Handler\\FingersCrossedHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/FingersCrossedHandler.php', 'Monolog\\Handler\\FingersCrossed\\ActivationStrategyInterface' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/FingersCrossed/ActivationStrategyInterface.php', 'Monolog\\Handler\\FingersCrossed\\ChannelLevelActivationStrategy' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/FingersCrossed/ChannelLevelActivationStrategy.php', 'Monolog\\Handler\\FingersCrossed\\ErrorLevelActivationStrategy' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/FingersCrossed/ErrorLevelActivationStrategy.php', 'Monolog\\Handler\\FirePHPHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/FirePHPHandler.php', 'Monolog\\Handler\\FleepHookHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/FleepHookHandler.php', 'Monolog\\Handler\\FlowdockHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/FlowdockHandler.php', 'Monolog\\Handler\\FormattableHandlerInterface' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/FormattableHandlerInterface.php', 'Monolog\\Handler\\FormattableHandlerTrait' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/FormattableHandlerTrait.php', 'Monolog\\Handler\\GelfHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/GelfHandler.php', 'Monolog\\Handler\\GroupHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/GroupHandler.php', 'Monolog\\Handler\\Handler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/Handler.php', 'Monolog\\Handler\\HandlerInterface' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/HandlerInterface.php', 'Monolog\\Handler\\HandlerWrapper' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/HandlerWrapper.php', 'Monolog\\Handler\\IFTTTHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/IFTTTHandler.php', 'Monolog\\Handler\\InsightOpsHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/InsightOpsHandler.php', 'Monolog\\Handler\\LogEntriesHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/LogEntriesHandler.php', 'Monolog\\Handler\\LogglyHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/LogglyHandler.php', 'Monolog\\Handler\\LogmaticHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/LogmaticHandler.php', 'Monolog\\Handler\\MailHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/MailHandler.php', 'Monolog\\Handler\\MandrillHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/MandrillHandler.php', 'Monolog\\Handler\\MissingExtensionException' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/MissingExtensionException.php', 'Monolog\\Handler\\MongoDBHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/MongoDBHandler.php', 'Monolog\\Handler\\NativeMailerHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/NativeMailerHandler.php', 'Monolog\\Handler\\NewRelicHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/NewRelicHandler.php', 'Monolog\\Handler\\NoopHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/NoopHandler.php', 'Monolog\\Handler\\NullHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/NullHandler.php', 'Monolog\\Handler\\OverflowHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/OverflowHandler.php', 'Monolog\\Handler\\PHPConsoleHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/PHPConsoleHandler.php', 'Monolog\\Handler\\ProcessHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/ProcessHandler.php', 'Monolog\\Handler\\ProcessableHandlerInterface' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/ProcessableHandlerInterface.php', 'Monolog\\Handler\\ProcessableHandlerTrait' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/ProcessableHandlerTrait.php', 'Monolog\\Handler\\PsrHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/PsrHandler.php', 'Monolog\\Handler\\PushoverHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/PushoverHandler.php', 'Monolog\\Handler\\RedisHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/RedisHandler.php', 'Monolog\\Handler\\RedisPubSubHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/RedisPubSubHandler.php', 'Monolog\\Handler\\RollbarHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/RollbarHandler.php', 'Monolog\\Handler\\RotatingFileHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/RotatingFileHandler.php', 'Monolog\\Handler\\SamplingHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/SamplingHandler.php', 'Monolog\\Handler\\SendGridHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/SendGridHandler.php', 'Monolog\\Handler\\SlackHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/SlackHandler.php', 'Monolog\\Handler\\SlackWebhookHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/SlackWebhookHandler.php', 'Monolog\\Handler\\Slack\\SlackRecord' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/Slack/SlackRecord.php', 'Monolog\\Handler\\SocketHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/SocketHandler.php', 'Monolog\\Handler\\SqsHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/SqsHandler.php', 'Monolog\\Handler\\StreamHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/StreamHandler.php', 'Monolog\\Handler\\SwiftMailerHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/SwiftMailerHandler.php', 'Monolog\\Handler\\SymfonyMailerHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/SymfonyMailerHandler.php', 'Monolog\\Handler\\SyslogHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/SyslogHandler.php', 'Monolog\\Handler\\SyslogUdpHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/SyslogUdpHandler.php', 'Monolog\\Handler\\SyslogUdp\\UdpSocket' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/SyslogUdp/UdpSocket.php', 'Monolog\\Handler\\TelegramBotHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/TelegramBotHandler.php', 'Monolog\\Handler\\TestHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/TestHandler.php', 'Monolog\\Handler\\WebRequestRecognizerTrait' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/WebRequestRecognizerTrait.php', 'Monolog\\Handler\\WhatFailureGroupHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/WhatFailureGroupHandler.php', 'Monolog\\Handler\\ZendMonitorHandler' => $vendorDir . '/monolog/monolog/src/Monolog/Handler/ZendMonitorHandler.php', 'Monolog\\LogRecord' => $vendorDir . '/monolog/monolog/src/Monolog/LogRecord.php', 'Monolog\\Logger' => $vendorDir . '/monolog/monolog/src/Monolog/Logger.php', 'Monolog\\Processor\\GitProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/GitProcessor.php', 'Monolog\\Processor\\HostnameProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/HostnameProcessor.php', 'Monolog\\Processor\\IntrospectionProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/IntrospectionProcessor.php', 'Monolog\\Processor\\MemoryPeakUsageProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/MemoryPeakUsageProcessor.php', 'Monolog\\Processor\\MemoryProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/MemoryProcessor.php', 'Monolog\\Processor\\MemoryUsageProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/MemoryUsageProcessor.php', 'Monolog\\Processor\\MercurialProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/MercurialProcessor.php', 'Monolog\\Processor\\ProcessIdProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/ProcessIdProcessor.php', 'Monolog\\Processor\\ProcessorInterface' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/ProcessorInterface.php', 'Monolog\\Processor\\PsrLogMessageProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/PsrLogMessageProcessor.php', 'Monolog\\Processor\\TagProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/TagProcessor.php', 'Monolog\\Processor\\UidProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/UidProcessor.php', 'Monolog\\Processor\\WebProcessor' => $vendorDir . '/monolog/monolog/src/Monolog/Processor/WebProcessor.php', 'Monolog\\Registry' => $vendorDir . '/monolog/monolog/src/Monolog/Registry.php', 'Monolog\\ResettableInterface' => $vendorDir . '/monolog/monolog/src/Monolog/ResettableInterface.php', 'Monolog\\SignalHandler' => $vendorDir . '/monolog/monolog/src/Monolog/SignalHandler.php', 'Monolog\\Test\\TestCase' => $vendorDir . '/monolog/monolog/src/Monolog/Test/TestCase.php', 'Monolog\\Utils' => $vendorDir . '/monolog/monolog/src/Monolog/Utils.php', 'ParagonIE\\ConstantTime\\Base32' => $vendorDir . '/paragonie/constant_time_encoding/src/Base32.php', 'ParagonIE\\ConstantTime\\Base32Hex' => $vendorDir . '/paragonie/constant_time_encoding/src/Base32Hex.php', 'ParagonIE\\ConstantTime\\Base64' => $vendorDir . '/paragonie/constant_time_encoding/src/Base64.php', 'ParagonIE\\ConstantTime\\Base64DotSlash' => $vendorDir . '/paragonie/constant_time_encoding/src/Base64DotSlash.php', 'ParagonIE\\ConstantTime\\Base64DotSlashOrdered' => $vendorDir . '/paragonie/constant_time_encoding/src/Base64DotSlashOrdered.php', 'ParagonIE\\ConstantTime\\Base64UrlSafe' => $vendorDir . '/paragonie/constant_time_encoding/src/Base64UrlSafe.php', 'ParagonIE\\ConstantTime\\Binary' => $vendorDir . '/paragonie/constant_time_encoding/src/Binary.php', 'ParagonIE\\ConstantTime\\EncoderInterface' => $vendorDir . '/paragonie/constant_time_encoding/src/EncoderInterface.php', 'ParagonIE\\ConstantTime\\Encoding' => $vendorDir . '/paragonie/constant_time_encoding/src/Encoding.php', 'ParagonIE\\ConstantTime\\Hex' => $vendorDir . '/paragonie/constant_time_encoding/src/Hex.php', 'ParagonIE\\ConstantTime\\RFC4648' => $vendorDir . '/paragonie/constant_time_encoding/src/RFC4648.php', 'Parsedown' => $vendorDir . '/erusev/parsedown/Parsedown.php', 'PhpToken' => $vendorDir . '/symfony/polyfill-php80/Resources/stubs/PhpToken.php', 'Psr\\Http\\Message\\MessageInterface' => $vendorDir . '/psr/http-message/src/MessageInterface.php', 'Psr\\Http\\Message\\RequestFactoryInterface' => $vendorDir . '/psr/http-factory/src/RequestFactoryInterface.php', 'Psr\\Http\\Message\\RequestInterface' => $vendorDir . '/psr/http-message/src/RequestInterface.php', 'Psr\\Http\\Message\\ResponseFactoryInterface' => $vendorDir . '/psr/http-factory/src/ResponseFactoryInterface.php', 'Psr\\Http\\Message\\ResponseInterface' => $vendorDir . '/psr/http-message/src/ResponseInterface.php', 'Psr\\Http\\Message\\ServerRequestFactoryInterface' => $vendorDir . '/psr/http-factory/src/ServerRequestFactoryInterface.php', 'Psr\\Http\\Message\\ServerRequestInterface' => $vendorDir . '/psr/http-message/src/ServerRequestInterface.php', 'Psr\\Http\\Message\\StreamFactoryInterface' => $vendorDir . '/psr/http-factory/src/StreamFactoryInterface.php', 'Psr\\Http\\Message\\StreamInterface' => $vendorDir . '/psr/http-message/src/StreamInterface.php', 'Psr\\Http\\Message\\UploadedFileFactoryInterface' => $vendorDir . '/psr/http-factory/src/UploadedFileFactoryInterface.php', 'Psr\\Http\\Message\\UploadedFileInterface' => $vendorDir . '/psr/http-message/src/UploadedFileInterface.php', 'Psr\\Http\\Message\\UriFactoryInterface' => $vendorDir . '/psr/http-factory/src/UriFactoryInterface.php', 'Psr\\Http\\Message\\UriInterface' => $vendorDir . '/psr/http-message/src/UriInterface.php', 'Psr\\Log\\AbstractLogger' => $vendorDir . '/psr/log/src/AbstractLogger.php', 'Psr\\Log\\InvalidArgumentException' => $vendorDir . '/psr/log/src/InvalidArgumentException.php', 'Psr\\Log\\LogLevel' => $vendorDir . '/psr/log/src/LogLevel.php', 'Psr\\Log\\LoggerAwareInterface' => $vendorDir . '/psr/log/src/LoggerAwareInterface.php', 'Psr\\Log\\LoggerAwareTrait' => $vendorDir . '/psr/log/src/LoggerAwareTrait.php', 'Psr\\Log\\LoggerInterface' => $vendorDir . '/psr/log/src/LoggerInterface.php', 'Psr\\Log\\LoggerTrait' => $vendorDir . '/psr/log/src/LoggerTrait.php', 'Psr\\Log\\NullLogger' => $vendorDir . '/psr/log/src/NullLogger.php', 'Stringable' => $vendorDir . '/symfony/polyfill-php80/Resources/stubs/Stringable.php', 'Symfony\\Polyfill\\Mbstring\\Mbstring' => $vendorDir . '/symfony/polyfill-mbstring/Mbstring.php', 'Symfony\\Polyfill\\Php80\\Php80' => $vendorDir . '/symfony/polyfill-php80/Php80.php', 'Symfony\\Polyfill\\Php80\\PhpToken' => $vendorDir . '/symfony/polyfill-php80/PhpToken.php', 'UnhandledMatchError' => $vendorDir . '/symfony/polyfill-php80/Resources/stubs/UnhandledMatchError.php', 'ValueError' => $vendorDir . '/symfony/polyfill-php80/Resources/stubs/ValueError.php', 'Webmozart\\Assert\\Assert' => $vendorDir . '/webmozart/assert/src/Assert.php', 'Webmozart\\Assert\\InvalidArgumentException' => $vendorDir . '/webmozart/assert/src/InvalidArgumentException.php', 'Webmozart\\Assert\\Mixin' => $vendorDir . '/webmozart/assert/src/Mixin.php', 'cash\\LRUCache' => $vendorDir . '/cash/lrucache/src/cash/LRUCache.php', 'danog\\Decoder\\FileId' => $vendorDir . '/danog/tg-file-decoder/src/FileId.php', 'danog\\Decoder\\PhotoSizeSource' => $vendorDir . '/danog/tg-file-decoder/src/PhotoSizeSource.php', 'danog\\Decoder\\PhotoSizeSource\\PhotoSizeSourceDialogPhoto' => $vendorDir . '/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceDialogPhoto.php', 'danog\\Decoder\\PhotoSizeSource\\PhotoSizeSourceLegacy' => $vendorDir . '/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceLegacy.php', 'danog\\Decoder\\PhotoSizeSource\\PhotoSizeSourceStickersetThumbnail' => $vendorDir . '/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceStickersetThumbnail.php', 'danog\\Decoder\\PhotoSizeSource\\PhotoSizeSourceStickersetThumbnailVersion' => $vendorDir . '/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceStickersetThumbnailVersion.php', 'danog\\Decoder\\PhotoSizeSource\\PhotoSizeSourceThumbnail' => $vendorDir . '/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceThumbnail.php', 'danog\\Decoder\\UniqueFileId' => $vendorDir . '/danog/tg-file-decoder/src/UniqueFileId.php', 'danog\\LibDNSJson\\JsonDecoder' => $vendorDir . '/danog/libdns-json/lib/JsonDecoder.php', 'danog\\LibDNSJson\\JsonDecoderFactory' => $vendorDir . '/danog/libdns-json/lib/JsonDecoderFactory.php', 'danog\\LibDNSJson\\QueryEncoder' => $vendorDir . '/danog/libdns-json/lib/QueryEncoder.php', 'danog\\LibDNSJson\\QueryEncoderFactory' => $vendorDir . '/danog/libdns-json/lib/QueryEncoderFactory.php', 'danog\\Loop\\Generic\\GenericLoop' => $vendorDir . '/danog/loop/lib/Generic/GenericLoop.php', 'danog\\Loop\\Generic\\PeriodicLoop' => $vendorDir . '/danog/loop/lib/Generic/PeriodicLoop.php', 'danog\\Loop\\Interfaces\\LoopInterface' => $vendorDir . '/danog/loop/lib/Interfaces/LoopInterface.php', 'danog\\Loop\\Interfaces\\ResumableLoopInterface' => $vendorDir . '/danog/loop/lib/Interfaces/ResumableLoopInterface.php', 'danog\\Loop\\Interfaces\\SignalLoopInterface' => $vendorDir . '/danog/loop/lib/Interfaces/SignalLoopInterface.php', 'danog\\Loop\\Loop' => $vendorDir . '/danog/loop/lib/Loop.php', 'danog\\Loop\\ResumableLoop' => $vendorDir . '/danog/loop/lib/ResumableLoop.php', 'danog\\Loop\\ResumableSignalLoop' => $vendorDir . '/danog/loop/lib/ResumableSignalLoop.php', 'danog\\Loop\\SignalLoop' => $vendorDir . '/danog/loop/lib/SignalLoop.php', 'danog\\Loop\\Traits\\Loop' => $vendorDir . '/danog/loop/lib/Traits/Loop.php', 'danog\\Loop\\Traits\\ResumableLoop' => $vendorDir . '/danog/loop/lib/Traits/ResumableLoop.php', 'danog\\Loop\\Traits\\SignalLoop' => $vendorDir . '/danog/loop/lib/Traits/SignalLoop.php', 'danog\\MadelineProto\\API' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/API.php', 'danog\\MadelineProto\\APIFactory' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/APIFactory.php', 'danog\\MadelineProto\\APIWrapper' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/APIWrapper.php', 'danog\\MadelineProto\\AbstractAPIFactory' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/AbstractAPIFactory.php', 'danog\\MadelineProto\\AnnotationsBuilder' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/AnnotationsBuilder.php', 'danog\\MadelineProto\\ApiWrappers\\Start' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/ApiWrappers/Start.php', 'danog\\MadelineProto\\ApiWrappers\\Templates' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/ApiWrappers/Templates.php', 'danog\\MadelineProto\\Async\\AsyncConstruct' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Async/AsyncConstruct.php', 'danog\\MadelineProto\\Bug74586Exception' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Bug74586Exception.php', 'danog\\MadelineProto\\Connection' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Connection.php', 'danog\\MadelineProto\\ContextConnector' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/ContextConnector.php', 'danog\\MadelineProto\\Conversion' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Conversion.php', 'danog\\MadelineProto\\Coroutine' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Coroutine.php', 'danog\\MadelineProto\\DataCenter' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/DataCenter.php', 'danog\\MadelineProto\\DataCenterConnection' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/DataCenterConnection.php', 'danog\\MadelineProto\\Db\\ArrayCacheTrait' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/ArrayCacheTrait.php', 'danog\\MadelineProto\\Db\\DbArray' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/DbArray.php', 'danog\\MadelineProto\\Db\\DbPropertiesFactory' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/DbPropertiesFactory.php', 'danog\\MadelineProto\\Db\\DbPropertiesTrait' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/DbPropertiesTrait.php', 'danog\\MadelineProto\\Db\\DbType' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/DbType.php', 'danog\\MadelineProto\\Db\\DriverArray' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/DriverArray.php', 'danog\\MadelineProto\\Db\\Driver\\Mysql' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/Driver/Mysql.php', 'danog\\MadelineProto\\Db\\Driver\\Postgres' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/Driver/Postgres.php', 'danog\\MadelineProto\\Db\\Driver\\Redis' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/Driver/Redis.php', 'danog\\MadelineProto\\Db\\MemoryArray' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/MemoryArray.php', 'danog\\MadelineProto\\Db\\MysqlArray' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/MysqlArray.php', 'danog\\MadelineProto\\Db\\NullCache\\MysqlArray' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/MysqlArray.php', 'danog\\MadelineProto\\Db\\NullCache\\NullCacheTrait' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/NullCacheTrait.php', 'danog\\MadelineProto\\Db\\NullCache\\PostgresArray' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/PostgresArray.php', 'danog\\MadelineProto\\Db\\NullCache\\RedisArray' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/RedisArray.php', 'danog\\MadelineProto\\Db\\PostgresArray' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/PostgresArray.php', 'danog\\MadelineProto\\Db\\RedisArray' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/RedisArray.php', 'danog\\MadelineProto\\Db\\SqlArray' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Db/SqlArray.php', 'danog\\MadelineProto\\DoHConnector' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/DoHConnector.php', 'danog\\MadelineProto\\DocsBuilder' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/DocsBuilder.php', 'danog\\MadelineProto\\DocsBuilder\\Constructors' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/DocsBuilder/Constructors.php', 'danog\\MadelineProto\\DocsBuilder\\Methods' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/DocsBuilder/Methods.php', 'danog\\MadelineProto\\EventHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/EventHandler.php', 'danog\\MadelineProto\\Exception' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Exception.php', 'danog\\MadelineProto\\FileCallback' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/FileCallback.php', 'danog\\MadelineProto\\FileCallbackInterface' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/FileCallbackInterface.php', 'danog\\MadelineProto\\Files\\Server' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Files/Server.php', 'danog\\MadelineProto\\GarbageCollector' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/GarbageCollector.php', 'danog\\MadelineProto\\InternalDoc' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/InternalDoc.php', 'danog\\MadelineProto\\Ipc\\Client' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Client.php', 'danog\\MadelineProto\\Ipc\\ClientAbstract' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/ClientAbstract.php', 'danog\\MadelineProto\\Ipc\\ExitFailure' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/ExitFailure.php', 'danog\\MadelineProto\\Ipc\\IpcState' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/IpcState.php', 'danog\\MadelineProto\\Ipc\\Runner\\ProcessRunner' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Runner/ProcessRunner.php', 'danog\\MadelineProto\\Ipc\\Runner\\RunnerAbstract' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Runner/RunnerAbstract.php', 'danog\\MadelineProto\\Ipc\\Runner\\WebRunner' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Runner/WebRunner.php', 'danog\\MadelineProto\\Ipc\\Server' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Server.php', 'danog\\MadelineProto\\Ipc\\ServerCallback' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/ServerCallback.php', 'danog\\MadelineProto\\Ipc\\Wrapper' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\FileCallback' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/FileCallback.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\InputStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/InputStream.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\Obj' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/Obj.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\OutputStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/OutputStream.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\SeekableInputStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/SeekableInputStream.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\SeekableOutputStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/SeekableOutputStream.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\SeekableTrait' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/SeekableTrait.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\WrapMethodTrait' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/WrapMethodTrait.php', 'danog\\MadelineProto\\Lang' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Lang.php', 'danog\\MadelineProto\\LightState' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/LightState.php', 'danog\\MadelineProto\\Logger' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Logger.php', 'danog\\MadelineProto\\Loop\\APILoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/APILoop.php', 'danog\\MadelineProto\\Loop\\Connection\\CheckLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/CheckLoop.php', 'danog\\MadelineProto\\Loop\\Connection\\CleanupLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/CleanupLoop.php', 'danog\\MadelineProto\\Loop\\Connection\\Common' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/Common.php', 'danog\\MadelineProto\\Loop\\Connection\\HttpWaitLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/HttpWaitLoop.php', 'danog\\MadelineProto\\Loop\\Connection\\PingLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/PingLoop.php', 'danog\\MadelineProto\\Loop\\Connection\\ReadLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/ReadLoop.php', 'danog\\MadelineProto\\Loop\\Connection\\WriteLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/WriteLoop.php', 'danog\\MadelineProto\\Loop\\Generic\\GenericLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Generic/GenericLoop.php', 'danog\\MadelineProto\\Loop\\Generic\\PeriodicLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Generic/PeriodicLoop.php', 'danog\\MadelineProto\\Loop\\Generic\\PeriodicLoopInternal' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Generic/PeriodicLoopInternal.php', 'danog\\MadelineProto\\Loop\\InternalLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/InternalLoop.php', 'danog\\MadelineProto\\Loop\\LoggerLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/LoggerLoop.php', 'danog\\MadelineProto\\Loop\\Update\\FeedLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Update/FeedLoop.php', 'danog\\MadelineProto\\Loop\\Update\\SecretFeedLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Update/SecretFeedLoop.php', 'danog\\MadelineProto\\Loop\\Update\\SeqLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Update/SeqLoop.php', 'danog\\MadelineProto\\Loop\\Update\\UpdateLoop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Loop/Update/UpdateLoop.php', 'danog\\MadelineProto\\Lua' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Lua.php', 'danog\\MadelineProto\\MTProto' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProto.php', 'danog\\MadelineProto\\MTProtoSession\\AckHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/AckHandler.php', 'danog\\MadelineProto\\MTProtoSession\\AuthKeyHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/AuthKeyHandler.php', 'danog\\MadelineProto\\MTProtoSession\\CallHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/CallHandler.php', 'danog\\MadelineProto\\MTProtoSession\\MsgIdHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/MsgIdHandler.php', 'danog\\MadelineProto\\MTProtoSession\\MsgIdHandler\\MsgIdHandler64' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/MsgIdHandler/MsgIdHandler64.php', 'danog\\MadelineProto\\MTProtoSession\\Reliable' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/Reliable.php', 'danog\\MadelineProto\\MTProtoSession\\ResponseHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/ResponseHandler.php', 'danog\\MadelineProto\\MTProtoSession\\SeqNoHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/SeqNoHandler.php', 'danog\\MadelineProto\\MTProtoSession\\Session' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/Session.php', 'danog\\MadelineProto\\MTProtoTools\\AuthKeyHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/AuthKeyHandler.php', 'danog\\MadelineProto\\MTProtoTools\\CallHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/CallHandler.php', 'danog\\MadelineProto\\MTProtoTools\\CombinedUpdatesState' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/CombinedUpdatesState.php', 'danog\\MadelineProto\\MTProtoTools\\Crypt' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt.php', 'danog\\MadelineProto\\MTProtoTools\\Crypt\\IGE' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt/IGE.php', 'danog\\MadelineProto\\MTProtoTools\\Crypt\\IGEOpenssl' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt/IGEOpenssl.php', 'danog\\MadelineProto\\MTProtoTools\\Crypt\\IGEPhpseclib' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt/IGEPhpseclib.php', 'danog\\MadelineProto\\MTProtoTools\\Files' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Files.php', 'danog\\MadelineProto\\MTProtoTools\\FilesLogic' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/FilesLogic.php', 'danog\\MadelineProto\\MTProtoTools\\MinDatabase' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/MinDatabase.php', 'danog\\MadelineProto\\MTProtoTools\\PasswordCalculator' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/PasswordCalculator.php', 'danog\\MadelineProto\\MTProtoTools\\PeerHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/PeerHandler.php', 'danog\\MadelineProto\\MTProtoTools\\ReferenceDatabase' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/ReferenceDatabase.php', 'danog\\MadelineProto\\MTProtoTools\\ResponseInfo' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/ResponseInfo.php', 'danog\\MadelineProto\\MTProtoTools\\UpdateHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/UpdateHandler.php', 'danog\\MadelineProto\\MTProtoTools\\UpdatesState' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/UpdatesState.php', 'danog\\MadelineProto\\MTProto\\AuthKey' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProto/AuthKey.php', 'danog\\MadelineProto\\MTProto\\Container' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProto/Container.php', 'danog\\MadelineProto\\MTProto\\IncomingMessage' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProto/IncomingMessage.php', 'danog\\MadelineProto\\MTProto\\Message' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProto/Message.php', 'danog\\MadelineProto\\MTProto\\OutgoingMessage' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProto/OutgoingMessage.php', 'danog\\MadelineProto\\MTProto\\PermAuthKey' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProto/PermAuthKey.php', 'danog\\MadelineProto\\MTProto\\TempAuthKey' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MTProto/TempAuthKey.php', 'danog\\MadelineProto\\Magic' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Magic.php', 'danog\\MadelineProto\\MyTelegramOrgWrapper' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/MyTelegramOrgWrapper.php', 'danog\\MadelineProto\\NothingInTheSocketException' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/NothingInTheSocketException.php', 'danog\\MadelineProto\\PTSException' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/PTSException.php', 'danog\\MadelineProto\\PsrLogger' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/PsrLogger.php', 'danog\\MadelineProto\\RPCErrorException' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/RPCErrorException.php', 'danog\\MadelineProto\\RSA' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/RSA.php', 'danog\\MadelineProto\\ResponseException' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/ResponseException.php', 'danog\\MadelineProto\\SecretChats\\AuthKeyHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/SecretChats/AuthKeyHandler.php', 'danog\\MadelineProto\\SecretChats\\MessageHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/SecretChats/MessageHandler.php', 'danog\\MadelineProto\\SecretChats\\ResponseHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/SecretChats/ResponseHandler.php', 'danog\\MadelineProto\\SecretChats\\SeqNoHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/SecretChats/SeqNoHandler.php', 'danog\\MadelineProto\\SecurityException' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/SecurityException.php', 'danog\\MadelineProto\\Serialization' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Serialization.php', 'danog\\MadelineProto\\SessionPaths' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/SessionPaths.php', 'danog\\MadelineProto\\Settings' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings.php', 'danog\\MadelineProto\\SettingsAbstract' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/SettingsAbstract.php', 'danog\\MadelineProto\\SettingsEmpty' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/SettingsEmpty.php', 'danog\\MadelineProto\\Settings\\AppInfo' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/AppInfo.php', 'danog\\MadelineProto\\Settings\\Auth' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Auth.php', 'danog\\MadelineProto\\Settings\\Connection' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Connection.php', 'danog\\MadelineProto\\Settings\\DatabaseAbstract' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/DatabaseAbstract.php', 'danog\\MadelineProto\\Settings\\Database\\DatabaseAbstract' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/DatabaseAbstract.php', 'danog\\MadelineProto\\Settings\\Database\\Memory' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Memory.php', 'danog\\MadelineProto\\Settings\\Database\\Mysql' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Mysql.php', 'danog\\MadelineProto\\Settings\\Database\\Postgres' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Postgres.php', 'danog\\MadelineProto\\Settings\\Database\\Redis' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Redis.php', 'danog\\MadelineProto\\Settings\\Database\\SqlAbstract' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/SqlAbstract.php', 'danog\\MadelineProto\\Settings\\Files' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Files.php', 'danog\\MadelineProto\\Settings\\Ipc' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Ipc.php', 'danog\\MadelineProto\\Settings\\Logger' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Logger.php', 'danog\\MadelineProto\\Settings\\Peer' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Peer.php', 'danog\\MadelineProto\\Settings\\Pwr' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Pwr.php', 'danog\\MadelineProto\\Settings\\RPC' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/RPC.php', 'danog\\MadelineProto\\Settings\\SecretChats' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/SecretChats.php', 'danog\\MadelineProto\\Settings\\Serialization' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Serialization.php', 'danog\\MadelineProto\\Settings\\TLSchema' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/TLSchema.php', 'danog\\MadelineProto\\Settings\\Templates' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/Templates.php', 'danog\\MadelineProto\\Settings\\VoIP' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Settings/VoIP.php', 'danog\\MadelineProto\\Shutdown' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Shutdown.php', 'danog\\MadelineProto\\Snitch' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Snitch.php', 'danog\\MadelineProto\\StrTools' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/StrTools.php', 'danog\\MadelineProto\\Stream\\ADNLTransport\\ADNLStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/ADNLTransport/ADNLStream.php', 'danog\\MadelineProto\\Stream\\Async\\Buffer' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Async/Buffer.php', 'danog\\MadelineProto\\Stream\\Async\\BufferedStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Async/BufferedStream.php', 'danog\\MadelineProto\\Stream\\Async\\RawStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Async/RawStream.php', 'danog\\MadelineProto\\Stream\\BufferInterface' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/BufferInterface.php', 'danog\\MadelineProto\\Stream\\BufferedProxyStreamInterface' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/BufferedProxyStreamInterface.php', 'danog\\MadelineProto\\Stream\\BufferedStreamInterface' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/BufferedStreamInterface.php', 'danog\\MadelineProto\\Stream\\Common\\BufferedRawStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/BufferedRawStream.php', 'danog\\MadelineProto\\Stream\\Common\\CtrStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/CtrStream.php', 'danog\\MadelineProto\\Stream\\Common\\FileBufferedStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/FileBufferedStream.php', 'danog\\MadelineProto\\Stream\\Common\\HashedBufferedStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/HashedBufferedStream.php', 'danog\\MadelineProto\\Stream\\Common\\SimpleBufferedRawStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/SimpleBufferedRawStream.php', 'danog\\MadelineProto\\Stream\\Common\\UdpBufferedStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/UdpBufferedStream.php', 'danog\\MadelineProto\\Stream\\ConnectionContext' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/ConnectionContext.php', 'danog\\MadelineProto\\Stream\\MTProtoBufferInterface' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoBufferInterface.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\AbridgedStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/AbridgedStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\FullStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/FullStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\HttpStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/HttpStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\HttpsStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/HttpsStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\IntermediatePaddedStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/IntermediatePaddedStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\IntermediateStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/IntermediateStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\ObfuscatedStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/ObfuscatedStream.php', 'danog\\MadelineProto\\Stream\\Ogg\\Ogg' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Ogg/Ogg.php', 'danog\\MadelineProto\\Stream\\ProxyStreamInterface' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/ProxyStreamInterface.php', 'danog\\MadelineProto\\Stream\\Proxy\\HttpProxy' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Proxy/HttpProxy.php', 'danog\\MadelineProto\\Stream\\Proxy\\SocksProxy' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Proxy/SocksProxy.php', 'danog\\MadelineProto\\Stream\\RawProxyStreamInterface' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/RawProxyStreamInterface.php', 'danog\\MadelineProto\\Stream\\RawStreamInterface' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/RawStreamInterface.php', 'danog\\MadelineProto\\Stream\\ReadBufferInterface' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/ReadBufferInterface.php', 'danog\\MadelineProto\\Stream\\StreamInterface' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/StreamInterface.php', 'danog\\MadelineProto\\Stream\\Transport\\DefaultStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/DefaultStream.php', 'danog\\MadelineProto\\Stream\\Transport\\PremadeStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/PremadeStream.php', 'danog\\MadelineProto\\Stream\\Transport\\WsStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/WsStream.php', 'danog\\MadelineProto\\Stream\\Transport\\WssStream' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/WssStream.php', 'danog\\MadelineProto\\Stream\\WriteBufferInterface' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Stream/WriteBufferInterface.php', 'danog\\MadelineProto\\TL\\Conversion\\BotAPI' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/BotAPI.php', 'danog\\MadelineProto\\TL\\Conversion\\BotAPIFiles' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/BotAPIFiles.php', 'danog\\MadelineProto\\TL\\Conversion\\DOMEntities' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/DOMEntities.php', 'danog\\MadelineProto\\TL\\Conversion\\Entities' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/Entities.php', 'danog\\MadelineProto\\TL\\Conversion\\Exception' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/Exception.php', 'danog\\MadelineProto\\TL\\Conversion\\Extension' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/Extension.php', 'danog\\MadelineProto\\TL\\Conversion\\TD' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/TD.php', 'danog\\MadelineProto\\TL\\Exception' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/Exception.php', 'danog\\MadelineProto\\TL\\PrettyException' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/PrettyException.php', 'danog\\MadelineProto\\TL\\TL' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/TL.php', 'danog\\MadelineProto\\TL\\TLCallback' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/TLCallback.php', 'danog\\MadelineProto\\TL\\TLConstructors' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/TLConstructors.php', 'danog\\MadelineProto\\TL\\TLMethods' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/TLMethods.php', 'danog\\MadelineProto\\TL\\TLParams' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/TLParams.php', 'danog\\MadelineProto\\TL\\Types\\Button' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/Types/Button.php', 'danog\\MadelineProto\\TL\\Types\\Bytes' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TL/Types/Bytes.php', 'danog\\MadelineProto\\TON\\ADNLConnection' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TON/ADNLConnection.php', 'danog\\MadelineProto\\TON\\API' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TON/API.php', 'danog\\MadelineProto\\TON\\APIFactory' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TON/APIFactory.php', 'danog\\MadelineProto\\TON\\InternalDoc' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TON/InternalDoc.php', 'danog\\MadelineProto\\TON\\Lite' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/TON/Lite.php', 'danog\\MadelineProto\\Tools' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Tools.php', 'danog\\MadelineProto\\VoIP' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/VoIP.php', 'danog\\MadelineProto\\VoIPServerConfig' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/VoIPServerConfig.php', 'danog\\MadelineProto\\VoIP\\AckHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/VoIP/AckHandler.php', 'danog\\MadelineProto\\VoIP\\AuthKeyHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/VoIP/AuthKeyHandler.php', 'danog\\MadelineProto\\VoIP\\Endpoint' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/VoIP/Endpoint.php', 'danog\\MadelineProto\\VoIP\\MessageHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/VoIP/MessageHandler.php', 'danog\\MadelineProto\\Wrappers\\Ads' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Ads.php', 'danog\\MadelineProto\\Wrappers\\Button' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Button.php', 'danog\\MadelineProto\\Wrappers\\Callback' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Callback.php', 'danog\\MadelineProto\\Wrappers\\DialogHandler' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/DialogHandler.php', 'danog\\MadelineProto\\Wrappers\\Events' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Events.php', 'danog\\MadelineProto\\Wrappers\\Login' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Login.php', 'danog\\MadelineProto\\Wrappers\\Loop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Loop.php', 'danog\\MadelineProto\\Wrappers\\Noop' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Noop.php', 'danog\\MadelineProto\\Wrappers\\Start' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Start.php', 'danog\\MadelineProto\\Wrappers\\TOS' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/TOS.php', 'danog\\MadelineProto\\Wrappers\\Templates' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Templates.php', 'danog\\MadelineProto\\Wrappers\\Webhook' => $vendorDir . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Webhook.php', 'danog\\PlaceHolder' => $vendorDir . '/danog/magicalserializer/src/danog/PlaceHolder.php', 'danog\\PrimeModule' => $vendorDir . '/danog/primemodule/lib/danog/PrimeModule.php', 'danog\\Serializable' => $vendorDir . '/danog/magicalserializer/src/danog/Serializable.php', 'danog\\Serialization' => $vendorDir . '/danog/magicalserializer/src/danog/Serialization.php', 'phpseclib3\\Common\\Functions\\Strings' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Common/Functions/Strings.php', 'phpseclib3\\Crypt\\AES' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/AES.php', 'phpseclib3\\Crypt\\Blowfish' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Blowfish.php', 'phpseclib3\\Crypt\\ChaCha20' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/ChaCha20.php', 'phpseclib3\\Crypt\\Common\\AsymmetricKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/AsymmetricKey.php', 'phpseclib3\\Crypt\\Common\\BlockCipher' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/BlockCipher.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\JWK' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/JWK.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\OpenSSH' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/OpenSSH.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\PKCS' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PKCS.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\PKCS1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PKCS1.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\PKCS8' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PKCS8.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\PuTTY' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PuTTY.php', 'phpseclib3\\Crypt\\Common\\Formats\\Signature\\Raw' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Signature/Raw.php', 'phpseclib3\\Crypt\\Common\\PrivateKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/PrivateKey.php', 'phpseclib3\\Crypt\\Common\\PublicKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/PublicKey.php', 'phpseclib3\\Crypt\\Common\\StreamCipher' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/StreamCipher.php', 'phpseclib3\\Crypt\\Common\\SymmetricKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/SymmetricKey.php', 'phpseclib3\\Crypt\\Common\\Traits\\Fingerprint' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Traits/Fingerprint.php', 'phpseclib3\\Crypt\\Common\\Traits\\PasswordProtected' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Traits/PasswordProtected.php', 'phpseclib3\\Crypt\\DES' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DES.php', 'phpseclib3\\Crypt\\DH' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DH.php', 'phpseclib3\\Crypt\\DH\\Formats\\Keys\\PKCS1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DH/Formats/Keys/PKCS1.php', 'phpseclib3\\Crypt\\DH\\Formats\\Keys\\PKCS8' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DH/Formats/Keys/PKCS8.php', 'phpseclib3\\Crypt\\DH\\Parameters' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DH/Parameters.php', 'phpseclib3\\Crypt\\DH\\PrivateKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DH/PrivateKey.php', 'phpseclib3\\Crypt\\DH\\PublicKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DH/PublicKey.php', 'phpseclib3\\Crypt\\DSA' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\OpenSSH' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/OpenSSH.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\PKCS1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/PKCS1.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\PKCS8' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/PKCS8.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\PuTTY' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/PuTTY.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\Raw' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/Raw.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\XML' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/XML.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Signature\\ASN1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Signature/ASN1.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Signature\\Raw' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Signature/Raw.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Signature\\SSH2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Signature/SSH2.php', 'phpseclib3\\Crypt\\DSA\\Parameters' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Parameters.php', 'phpseclib3\\Crypt\\DSA\\PrivateKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/PrivateKey.php', 'phpseclib3\\Crypt\\DSA\\PublicKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/PublicKey.php', 'phpseclib3\\Crypt\\EC' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\Base' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/Base.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\Binary' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/Binary.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\KoblitzPrime' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/KoblitzPrime.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\Montgomery' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/Montgomery.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\Prime' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/Prime.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\TwistedEdwards' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/TwistedEdwards.php', 'phpseclib3\\Crypt\\EC\\Curves\\Curve25519' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/Curve25519.php', 'phpseclib3\\Crypt\\EC\\Curves\\Curve448' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/Curve448.php', 'phpseclib3\\Crypt\\EC\\Curves\\Ed25519' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/Ed25519.php', 'phpseclib3\\Crypt\\EC\\Curves\\Ed448' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/Ed448.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP160r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP160r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP160t1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP160t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP192r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP192r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP192t1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP192t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP224r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP224r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP224t1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP224t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP256r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP256r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP256t1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP256t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP320r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP320r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP320t1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP320t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP384r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP384r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP384t1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP384t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP512r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP512r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP512t1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP512t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistb233' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistb233.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistb409' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistb409.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistk163' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistk163.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistk233' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistk233.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistk283' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistk283.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistk409' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistk409.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistp192' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp192.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistp224' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp224.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistp256' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp256.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistp384' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp384.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistp521' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp521.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistt571' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistt571.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime192v1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime192v1.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime192v2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime192v2.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime192v3' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime192v3.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime239v1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime239v1.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime239v2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime239v2.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime239v3' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime239v3.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime256v1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime256v1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp112r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp112r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp112r2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp112r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp128r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp128r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp128r2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp128r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp160k1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp160k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp160r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp160r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp160r2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp160r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp192k1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp192k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp192r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp192r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp224k1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp224k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp224r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp224r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp256k1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp256k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp256r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp256r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp384r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp384r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp521r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp521r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect113r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect113r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect113r2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect113r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect131r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect131r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect131r2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect131r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect163k1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect163k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect163r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect163r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect163r2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect163r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect193r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect193r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect193r2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect193r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect233k1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect233k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect233r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect233r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect239k1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect239k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect283k1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect283k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect283r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect283r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect409k1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect409k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect409r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect409r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect571k1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect571k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect571r1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect571r1.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\Common' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/Common.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\JWK' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/JWK.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\MontgomeryPrivate' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/MontgomeryPrivate.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\MontgomeryPublic' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/MontgomeryPublic.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\OpenSSH' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/OpenSSH.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\PKCS1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/PKCS1.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\PKCS8' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/PKCS8.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\PuTTY' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/PuTTY.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\XML' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/XML.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\libsodium' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/libsodium.php', 'phpseclib3\\Crypt\\EC\\Formats\\Signature\\ASN1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Signature/ASN1.php', 'phpseclib3\\Crypt\\EC\\Formats\\Signature\\Raw' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Signature/Raw.php', 'phpseclib3\\Crypt\\EC\\Formats\\Signature\\SSH2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Signature/SSH2.php', 'phpseclib3\\Crypt\\EC\\Parameters' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Parameters.php', 'phpseclib3\\Crypt\\EC\\PrivateKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/PrivateKey.php', 'phpseclib3\\Crypt\\EC\\PublicKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/EC/PublicKey.php', 'phpseclib3\\Crypt\\Hash' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Hash.php', 'phpseclib3\\Crypt\\PublicKeyLoader' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/PublicKeyLoader.php', 'phpseclib3\\Crypt\\RC2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RC2.php', 'phpseclib3\\Crypt\\RC4' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RC4.php', 'phpseclib3\\Crypt\\RSA' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\JWK' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/JWK.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\MSBLOB' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/MSBLOB.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\OpenSSH' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/OpenSSH.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\PKCS1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PKCS1.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\PKCS8' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PKCS8.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\PSS' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PSS.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\PuTTY' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PuTTY.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\Raw' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/Raw.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\XML' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/XML.php', 'phpseclib3\\Crypt\\RSA\\PrivateKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/PrivateKey.php', 'phpseclib3\\Crypt\\RSA\\PublicKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/PublicKey.php', 'phpseclib3\\Crypt\\Random' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Random.php', 'phpseclib3\\Crypt\\Rijndael' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Rijndael.php', 'phpseclib3\\Crypt\\Salsa20' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Salsa20.php', 'phpseclib3\\Crypt\\TripleDES' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/TripleDES.php', 'phpseclib3\\Crypt\\Twofish' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Crypt/Twofish.php', 'phpseclib3\\Exception\\BadConfigurationException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/BadConfigurationException.php', 'phpseclib3\\Exception\\BadDecryptionException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/BadDecryptionException.php', 'phpseclib3\\Exception\\BadModeException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/BadModeException.php', 'phpseclib3\\Exception\\ConnectionClosedException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/ConnectionClosedException.php', 'phpseclib3\\Exception\\FileNotFoundException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/FileNotFoundException.php', 'phpseclib3\\Exception\\InconsistentSetupException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/InconsistentSetupException.php', 'phpseclib3\\Exception\\InsufficientSetupException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/InsufficientSetupException.php', 'phpseclib3\\Exception\\NoKeyLoadedException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/NoKeyLoadedException.php', 'phpseclib3\\Exception\\NoSupportedAlgorithmsException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/NoSupportedAlgorithmsException.php', 'phpseclib3\\Exception\\UnableToConnectException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/UnableToConnectException.php', 'phpseclib3\\Exception\\UnsupportedAlgorithmException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/UnsupportedAlgorithmException.php', 'phpseclib3\\Exception\\UnsupportedCurveException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/UnsupportedCurveException.php', 'phpseclib3\\Exception\\UnsupportedFormatException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/UnsupportedFormatException.php', 'phpseclib3\\Exception\\UnsupportedOperationException' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Exception/UnsupportedOperationException.php', 'phpseclib3\\File\\ANSI' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ANSI.php', 'phpseclib3\\File\\ASN1' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1.php', 'phpseclib3\\File\\ASN1\\Element' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Element.php', 'phpseclib3\\File\\ASN1\\Maps\\AccessDescription' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AccessDescription.php', 'phpseclib3\\File\\ASN1\\Maps\\AdministrationDomainName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AdministrationDomainName.php', 'phpseclib3\\File\\ASN1\\Maps\\AlgorithmIdentifier' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AlgorithmIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\AnotherName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AnotherName.php', 'phpseclib3\\File\\ASN1\\Maps\\Attribute' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Attribute.php', 'phpseclib3\\File\\ASN1\\Maps\\AttributeType' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AttributeType.php', 'phpseclib3\\File\\ASN1\\Maps\\AttributeTypeAndValue' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AttributeTypeAndValue.php', 'phpseclib3\\File\\ASN1\\Maps\\AttributeValue' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AttributeValue.php', 'phpseclib3\\File\\ASN1\\Maps\\Attributes' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Attributes.php', 'phpseclib3\\File\\ASN1\\Maps\\AuthorityInfoAccessSyntax' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AuthorityInfoAccessSyntax.php', 'phpseclib3\\File\\ASN1\\Maps\\AuthorityKeyIdentifier' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AuthorityKeyIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\BaseDistance' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BaseDistance.php', 'phpseclib3\\File\\ASN1\\Maps\\BasicConstraints' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BasicConstraints.php', 'phpseclib3\\File\\ASN1\\Maps\\BuiltInDomainDefinedAttribute' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BuiltInDomainDefinedAttribute.php', 'phpseclib3\\File\\ASN1\\Maps\\BuiltInDomainDefinedAttributes' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BuiltInDomainDefinedAttributes.php', 'phpseclib3\\File\\ASN1\\Maps\\BuiltInStandardAttributes' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BuiltInStandardAttributes.php', 'phpseclib3\\File\\ASN1\\Maps\\CPSuri' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CPSuri.php', 'phpseclib3\\File\\ASN1\\Maps\\CRLDistributionPoints' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CRLDistributionPoints.php', 'phpseclib3\\File\\ASN1\\Maps\\CRLNumber' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CRLNumber.php', 'phpseclib3\\File\\ASN1\\Maps\\CRLReason' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CRLReason.php', 'phpseclib3\\File\\ASN1\\Maps\\CertPolicyId' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertPolicyId.php', 'phpseclib3\\File\\ASN1\\Maps\\Certificate' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Certificate.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificateIssuer' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificateIssuer.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificateList' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificateList.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificatePolicies' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificatePolicies.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificateSerialNumber' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificateSerialNumber.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificationRequest' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificationRequest.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificationRequestInfo' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificationRequestInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\Characteristic_two' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Characteristic_two.php', 'phpseclib3\\File\\ASN1\\Maps\\CountryName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CountryName.php', 'phpseclib3\\File\\ASN1\\Maps\\Curve' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Curve.php', 'phpseclib3\\File\\ASN1\\Maps\\DHParameter' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DHParameter.php', 'phpseclib3\\File\\ASN1\\Maps\\DSAParams' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DSAParams.php', 'phpseclib3\\File\\ASN1\\Maps\\DSAPrivateKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DSAPrivateKey.php', 'phpseclib3\\File\\ASN1\\Maps\\DSAPublicKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DSAPublicKey.php', 'phpseclib3\\File\\ASN1\\Maps\\DigestInfo' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DigestInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\DirectoryString' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DirectoryString.php', 'phpseclib3\\File\\ASN1\\Maps\\DisplayText' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DisplayText.php', 'phpseclib3\\File\\ASN1\\Maps\\DistributionPoint' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DistributionPoint.php', 'phpseclib3\\File\\ASN1\\Maps\\DistributionPointName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DistributionPointName.php', 'phpseclib3\\File\\ASN1\\Maps\\DssSigValue' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DssSigValue.php', 'phpseclib3\\File\\ASN1\\Maps\\ECParameters' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ECParameters.php', 'phpseclib3\\File\\ASN1\\Maps\\ECPoint' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ECPoint.php', 'phpseclib3\\File\\ASN1\\Maps\\ECPrivateKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ECPrivateKey.php', 'phpseclib3\\File\\ASN1\\Maps\\EDIPartyName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EDIPartyName.php', 'phpseclib3\\File\\ASN1\\Maps\\EcdsaSigValue' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EcdsaSigValue.php', 'phpseclib3\\File\\ASN1\\Maps\\EncryptedData' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EncryptedData.php', 'phpseclib3\\File\\ASN1\\Maps\\EncryptedPrivateKeyInfo' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EncryptedPrivateKeyInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\ExtKeyUsageSyntax' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ExtKeyUsageSyntax.php', 'phpseclib3\\File\\ASN1\\Maps\\Extension' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Extension.php', 'phpseclib3\\File\\ASN1\\Maps\\ExtensionAttribute' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ExtensionAttribute.php', 'phpseclib3\\File\\ASN1\\Maps\\ExtensionAttributes' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ExtensionAttributes.php', 'phpseclib3\\File\\ASN1\\Maps\\Extensions' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Extensions.php', 'phpseclib3\\File\\ASN1\\Maps\\FieldElement' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/FieldElement.php', 'phpseclib3\\File\\ASN1\\Maps\\FieldID' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/FieldID.php', 'phpseclib3\\File\\ASN1\\Maps\\GeneralName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralName.php', 'phpseclib3\\File\\ASN1\\Maps\\GeneralNames' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralNames.php', 'phpseclib3\\File\\ASN1\\Maps\\GeneralSubtree' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralSubtree.php', 'phpseclib3\\File\\ASN1\\Maps\\GeneralSubtrees' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralSubtrees.php', 'phpseclib3\\File\\ASN1\\Maps\\HashAlgorithm' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/HashAlgorithm.php', 'phpseclib3\\File\\ASN1\\Maps\\HoldInstructionCode' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/HoldInstructionCode.php', 'phpseclib3\\File\\ASN1\\Maps\\InvalidityDate' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/InvalidityDate.php', 'phpseclib3\\File\\ASN1\\Maps\\IssuerAltName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/IssuerAltName.php', 'phpseclib3\\File\\ASN1\\Maps\\IssuingDistributionPoint' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/IssuingDistributionPoint.php', 'phpseclib3\\File\\ASN1\\Maps\\KeyIdentifier' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/KeyIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\KeyPurposeId' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/KeyPurposeId.php', 'phpseclib3\\File\\ASN1\\Maps\\KeyUsage' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/KeyUsage.php', 'phpseclib3\\File\\ASN1\\Maps\\MaskGenAlgorithm' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/MaskGenAlgorithm.php', 'phpseclib3\\File\\ASN1\\Maps\\Name' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Name.php', 'phpseclib3\\File\\ASN1\\Maps\\NameConstraints' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NameConstraints.php', 'phpseclib3\\File\\ASN1\\Maps\\NetworkAddress' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NetworkAddress.php', 'phpseclib3\\File\\ASN1\\Maps\\NoticeReference' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NoticeReference.php', 'phpseclib3\\File\\ASN1\\Maps\\NumericUserIdentifier' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NumericUserIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\ORAddress' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ORAddress.php', 'phpseclib3\\File\\ASN1\\Maps\\OneAsymmetricKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OneAsymmetricKey.php', 'phpseclib3\\File\\ASN1\\Maps\\OrganizationName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OrganizationName.php', 'phpseclib3\\File\\ASN1\\Maps\\OrganizationalUnitNames' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OrganizationalUnitNames.php', 'phpseclib3\\File\\ASN1\\Maps\\OtherPrimeInfo' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OtherPrimeInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\OtherPrimeInfos' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OtherPrimeInfos.php', 'phpseclib3\\File\\ASN1\\Maps\\PBEParameter' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBEParameter.php', 'phpseclib3\\File\\ASN1\\Maps\\PBES2params' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBES2params.php', 'phpseclib3\\File\\ASN1\\Maps\\PBKDF2params' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBKDF2params.php', 'phpseclib3\\File\\ASN1\\Maps\\PBMAC1params' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBMAC1params.php', 'phpseclib3\\File\\ASN1\\Maps\\PKCS9String' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PKCS9String.php', 'phpseclib3\\File\\ASN1\\Maps\\Pentanomial' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Pentanomial.php', 'phpseclib3\\File\\ASN1\\Maps\\PersonalName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PersonalName.php', 'phpseclib3\\File\\ASN1\\Maps\\PolicyInformation' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyInformation.php', 'phpseclib3\\File\\ASN1\\Maps\\PolicyMappings' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyMappings.php', 'phpseclib3\\File\\ASN1\\Maps\\PolicyQualifierId' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyQualifierId.php', 'phpseclib3\\File\\ASN1\\Maps\\PolicyQualifierInfo' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyQualifierInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\PostalAddress' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PostalAddress.php', 'phpseclib3\\File\\ASN1\\Maps\\Prime_p' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Prime_p.php', 'phpseclib3\\File\\ASN1\\Maps\\PrivateDomainName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateDomainName.php', 'phpseclib3\\File\\ASN1\\Maps\\PrivateKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateKey.php', 'phpseclib3\\File\\ASN1\\Maps\\PrivateKeyInfo' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateKeyInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\PrivateKeyUsagePeriod' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateKeyUsagePeriod.php', 'phpseclib3\\File\\ASN1\\Maps\\PublicKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PublicKey.php', 'phpseclib3\\File\\ASN1\\Maps\\PublicKeyAndChallenge' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PublicKeyAndChallenge.php', 'phpseclib3\\File\\ASN1\\Maps\\PublicKeyInfo' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PublicKeyInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\RC2CBCParameter' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RC2CBCParameter.php', 'phpseclib3\\File\\ASN1\\Maps\\RDNSequence' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RDNSequence.php', 'phpseclib3\\File\\ASN1\\Maps\\RSAPrivateKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RSAPrivateKey.php', 'phpseclib3\\File\\ASN1\\Maps\\RSAPublicKey' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RSAPublicKey.php', 'phpseclib3\\File\\ASN1\\Maps\\RSASSA_PSS_params' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RSASSA_PSS_params.php', 'phpseclib3\\File\\ASN1\\Maps\\ReasonFlags' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ReasonFlags.php', 'phpseclib3\\File\\ASN1\\Maps\\RelativeDistinguishedName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RelativeDistinguishedName.php', 'phpseclib3\\File\\ASN1\\Maps\\RevokedCertificate' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RevokedCertificate.php', 'phpseclib3\\File\\ASN1\\Maps\\SignedPublicKeyAndChallenge' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SignedPublicKeyAndChallenge.php', 'phpseclib3\\File\\ASN1\\Maps\\SpecifiedECDomain' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SpecifiedECDomain.php', 'phpseclib3\\File\\ASN1\\Maps\\SubjectAltName' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectAltName.php', 'phpseclib3\\File\\ASN1\\Maps\\SubjectDirectoryAttributes' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectDirectoryAttributes.php', 'phpseclib3\\File\\ASN1\\Maps\\SubjectInfoAccessSyntax' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectInfoAccessSyntax.php', 'phpseclib3\\File\\ASN1\\Maps\\SubjectPublicKeyInfo' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectPublicKeyInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\TBSCertList' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/TBSCertList.php', 'phpseclib3\\File\\ASN1\\Maps\\TBSCertificate' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/TBSCertificate.php', 'phpseclib3\\File\\ASN1\\Maps\\TerminalIdentifier' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/TerminalIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\Time' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Time.php', 'phpseclib3\\File\\ASN1\\Maps\\Trinomial' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Trinomial.php', 'phpseclib3\\File\\ASN1\\Maps\\UniqueIdentifier' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/UniqueIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\UserNotice' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/UserNotice.php', 'phpseclib3\\File\\ASN1\\Maps\\Validity' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Validity.php', 'phpseclib3\\File\\ASN1\\Maps\\netscape_ca_policy_url' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/netscape_ca_policy_url.php', 'phpseclib3\\File\\ASN1\\Maps\\netscape_cert_type' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/netscape_cert_type.php', 'phpseclib3\\File\\ASN1\\Maps\\netscape_comment' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/netscape_comment.php', 'phpseclib3\\File\\X509' => $vendorDir . '/phpseclib/phpseclib/phpseclib/File/X509.php', 'phpseclib3\\Math\\BigInteger' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\Base' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/Base.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\BuiltIn' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/BuiltIn.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\DefaultEngine' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/DefaultEngine.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\OpenSSL' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/OpenSSL.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\Reductions\\Barrett' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/Reductions/Barrett.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\Reductions\\EvalBarrett' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/Reductions/EvalBarrett.php', 'phpseclib3\\Math\\BigInteger\\Engines\\Engine' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/Engine.php', 'phpseclib3\\Math\\BigInteger\\Engines\\GMP' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/GMP.php', 'phpseclib3\\Math\\BigInteger\\Engines\\GMP\\DefaultEngine' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/GMP/DefaultEngine.php', 'phpseclib3\\Math\\BigInteger\\Engines\\OpenSSL' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/OpenSSL.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP32' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP32.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP64' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP64.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Base' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Base.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\DefaultEngine' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/DefaultEngine.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Montgomery' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Montgomery.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\OpenSSL' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/OpenSSL.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\Barrett' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/Barrett.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\Classic' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/Classic.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\EvalBarrett' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/EvalBarrett.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\Montgomery' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/Montgomery.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\MontgomeryMult' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/MontgomeryMult.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\PowerOfTwo' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/PowerOfTwo.php', 'phpseclib3\\Math\\BinaryField' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BinaryField.php', 'phpseclib3\\Math\\BinaryField\\Integer' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/BinaryField/Integer.php', 'phpseclib3\\Math\\Common\\FiniteField' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/Common/FiniteField.php', 'phpseclib3\\Math\\Common\\FiniteField\\Integer' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/Common/FiniteField/Integer.php', 'phpseclib3\\Math\\PrimeField' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/PrimeField.php', 'phpseclib3\\Math\\PrimeField\\Integer' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Math/PrimeField/Integer.php', 'phpseclib3\\Net\\SFTP' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Net/SFTP.php', 'phpseclib3\\Net\\SFTP\\Stream' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Net/SFTP/Stream.php', 'phpseclib3\\Net\\SSH2' => $vendorDir . '/phpseclib/phpseclib/phpseclib/Net/SSH2.php', 'phpseclib3\\System\\SSH\\Agent' => $vendorDir . '/phpseclib/phpseclib/phpseclib/System/SSH/Agent.php', 'phpseclib3\\System\\SSH\\Agent\\Identity' => $vendorDir . '/phpseclib/phpseclib/phpseclib/System/SSH/Agent/Identity.php', 'phpseclib3\\System\\SSH\\Common\\Traits\\ReadBytes' => $vendorDir . '/phpseclib/phpseclib/phpseclib/System/SSH/Common/Traits/ReadBytes.php', ); = 80100)) { $issues[] = 'Your Composer dependencies require a PHP version ">= 8.1.0". You are running ' . PHP_VERSION . '.'; } if ($issues) { if (!headers_sent()) { header('HTTP/1.1 500 Internal Server Error'); } if (!ini_get('display_errors')) { if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') { fwrite(STDERR, 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . implode(PHP_EOL, $issues) . PHP_EOL.PHP_EOL); } elseif (!headers_sent()) { echo 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . str_replace('You are running '.PHP_VERSION.'.', '', implode(PHP_EOL, $issues)) . PHP_EOL.PHP_EOL; } } trigger_error( 'Composer detected issues in your platform: ' . implode(' ', $issues), E_USER_ERROR ); } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Autoload; /** * ClassLoader implements a PSR-0, PSR-4 and classmap class loader. * * $loader = new \Composer\Autoload\ClassLoader(); * * // register classes with namespaces * $loader->add('Symfony\Component', __DIR__.'/component'); * $loader->add('Symfony', __DIR__.'/framework'); * * // activate the autoloader * $loader->register(); * * // to enable searching the include path (eg. for PEAR packages) * $loader->setUseIncludePath(true); * * In this example, if you try to use a class in the Symfony\Component * namespace or one of its children (Symfony\Component\Console for instance), * the autoloader will first look for the class under the component/ * directory, and it will then fallback to the framework/ directory if not * found before giving up. * * This class is loosely based on the Symfony UniversalClassLoader. * * @author Fabien Potencier * @author Jordi Boggiano * @see https://www.php-fig.org/psr/psr-0/ * @see https://www.php-fig.org/psr/psr-4/ */ class ClassLoader { /** @var \Closure(string):void */ private static $includeFile; /** @var ?string */ private $vendorDir; // PSR-4 /** * @var array[] * @psalm-var array> */ private $prefixLengthsPsr4 = array(); /** * @var array[] * @psalm-var array> */ private $prefixDirsPsr4 = array(); /** * @var array[] * @psalm-var array */ private $fallbackDirsPsr4 = array(); // PSR-0 /** * @var array[] * @psalm-var array> */ private $prefixesPsr0 = array(); /** * @var array[] * @psalm-var array */ private $fallbackDirsPsr0 = array(); /** @var bool */ private $useIncludePath = false; /** * @var string[] * @psalm-var array */ private $classMap = array(); /** @var bool */ private $classMapAuthoritative = false; /** * @var bool[] * @psalm-var array */ private $missingClasses = array(); /** @var ?string */ private $apcuPrefix; /** * @var self[] */ private static $registeredLoaders = array(); /** * @param ?string $vendorDir */ public function __construct($vendorDir = null) { $this->vendorDir = $vendorDir; self::initializeIncludeClosure(); } /** * @return string[] */ public function getPrefixes() { if (!empty($this->prefixesPsr0)) { return call_user_func_array('array_merge', array_values($this->prefixesPsr0)); } return array(); } /** * @return array[] * @psalm-return array> */ public function getPrefixesPsr4() { return $this->prefixDirsPsr4; } /** * @return array[] * @psalm-return array */ public function getFallbackDirs() { return $this->fallbackDirsPsr0; } /** * @return array[] * @psalm-return array */ public function getFallbackDirsPsr4() { return $this->fallbackDirsPsr4; } /** * @return string[] Array of classname => path * @psalm-return array */ public function getClassMap() { return $this->classMap; } /** * @param string[] $classMap Class to filename map * @psalm-param array $classMap * * @return void */ public function addClassMap(array $classMap) { if ($this->classMap) { $this->classMap = array_merge($this->classMap, $classMap); } else { $this->classMap = $classMap; } } /** * Registers a set of PSR-0 directories for a given prefix, either * appending or prepending to the ones previously set for this prefix. * * @param string $prefix The prefix * @param string[]|string $paths The PSR-0 root directories * @param bool $prepend Whether to prepend the directories * * @return void */ public function add($prefix, $paths, $prepend = false) { if (!$prefix) { if ($prepend) { $this->fallbackDirsPsr0 = array_merge( (array) $paths, $this->fallbackDirsPsr0 ); } else { $this->fallbackDirsPsr0 = array_merge( $this->fallbackDirsPsr0, (array) $paths ); } return; } $first = $prefix[0]; if (!isset($this->prefixesPsr0[$first][$prefix])) { $this->prefixesPsr0[$first][$prefix] = (array) $paths; return; } if ($prepend) { $this->prefixesPsr0[$first][$prefix] = array_merge( (array) $paths, $this->prefixesPsr0[$first][$prefix] ); } else { $this->prefixesPsr0[$first][$prefix] = array_merge( $this->prefixesPsr0[$first][$prefix], (array) $paths ); } } /** * Registers a set of PSR-4 directories for a given namespace, either * appending or prepending to the ones previously set for this namespace. * * @param string $prefix The prefix/namespace, with trailing '\\' * @param string[]|string $paths The PSR-4 base directories * @param bool $prepend Whether to prepend the directories * * @throws \InvalidArgumentException * * @return void */ public function addPsr4($prefix, $paths, $prepend = false) { if (!$prefix) { // Register directories for the root namespace. if ($prepend) { $this->fallbackDirsPsr4 = array_merge( (array) $paths, $this->fallbackDirsPsr4 ); } else { $this->fallbackDirsPsr4 = array_merge( $this->fallbackDirsPsr4, (array) $paths ); } } elseif (!isset($this->prefixDirsPsr4[$prefix])) { // Register directories for a new namespace. $length = strlen($prefix); if ('\\' !== $prefix[$length - 1]) { throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); } $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; $this->prefixDirsPsr4[$prefix] = (array) $paths; } elseif ($prepend) { // Prepend directories for an already registered namespace. $this->prefixDirsPsr4[$prefix] = array_merge( (array) $paths, $this->prefixDirsPsr4[$prefix] ); } else { // Append directories for an already registered namespace. $this->prefixDirsPsr4[$prefix] = array_merge( $this->prefixDirsPsr4[$prefix], (array) $paths ); } } /** * Registers a set of PSR-0 directories for a given prefix, * replacing any others previously set for this prefix. * * @param string $prefix The prefix * @param string[]|string $paths The PSR-0 base directories * * @return void */ public function set($prefix, $paths) { if (!$prefix) { $this->fallbackDirsPsr0 = (array) $paths; } else { $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths; } } /** * Registers a set of PSR-4 directories for a given namespace, * replacing any others previously set for this namespace. * * @param string $prefix The prefix/namespace, with trailing '\\' * @param string[]|string $paths The PSR-4 base directories * * @throws \InvalidArgumentException * * @return void */ public function setPsr4($prefix, $paths) { if (!$prefix) { $this->fallbackDirsPsr4 = (array) $paths; } else { $length = strlen($prefix); if ('\\' !== $prefix[$length - 1]) { throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); } $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; $this->prefixDirsPsr4[$prefix] = (array) $paths; } } /** * Turns on searching the include path for class files. * * @param bool $useIncludePath * * @return void */ public function setUseIncludePath($useIncludePath) { $this->useIncludePath = $useIncludePath; } /** * Can be used to check if the autoloader uses the include path to check * for classes. * * @return bool */ public function getUseIncludePath() { return $this->useIncludePath; } /** * Turns off searching the prefix and fallback directories for classes * that have not been registered with the class map. * * @param bool $classMapAuthoritative * * @return void */ public function setClassMapAuthoritative($classMapAuthoritative) { $this->classMapAuthoritative = $classMapAuthoritative; } /** * Should class lookup fail if not found in the current class map? * * @return bool */ public function isClassMapAuthoritative() { return $this->classMapAuthoritative; } /** * APCu prefix to use to cache found/not-found classes, if the extension is enabled. * * @param string|null $apcuPrefix * * @return void */ public function setApcuPrefix($apcuPrefix) { $this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null; } /** * The APCu prefix in use, or null if APCu caching is not enabled. * * @return string|null */ public function getApcuPrefix() { return $this->apcuPrefix; } /** * Registers this instance as an autoloader. * * @param bool $prepend Whether to prepend the autoloader or not * * @return void */ public function register($prepend = false) { spl_autoload_register(array($this, 'loadClass'), true, $prepend); if (null === $this->vendorDir) { return; } if ($prepend) { self::$registeredLoaders = array($this->vendorDir => $this) + self::$registeredLoaders; } else { unset(self::$registeredLoaders[$this->vendorDir]); self::$registeredLoaders[$this->vendorDir] = $this; } } /** * Unregisters this instance as an autoloader. * * @return void */ public function unregister() { spl_autoload_unregister(array($this, 'loadClass')); if (null !== $this->vendorDir) { unset(self::$registeredLoaders[$this->vendorDir]); } } /** * Loads the given class or interface. * * @param string $class The name of the class * @return true|null True if loaded, null otherwise */ public function loadClass($class) { if ($file = $this->findFile($class)) { (self::$includeFile)($file); return true; } return null; } /** * Finds the path to the file where the class is defined. * * @param string $class The name of the class * * @return string|false The path if found, false otherwise */ public function findFile($class) { // class map lookup if (isset($this->classMap[$class])) { return $this->classMap[$class]; } if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) { return false; } if (null !== $this->apcuPrefix) { $file = apcu_fetch($this->apcuPrefix.$class, $hit); if ($hit) { return $file; } } $file = $this->findFileWithExtension($class, '.php'); // Search for Hack files if we are running on HHVM if (false === $file && defined('HHVM_VERSION')) { $file = $this->findFileWithExtension($class, '.hh'); } if (null !== $this->apcuPrefix) { apcu_add($this->apcuPrefix.$class, $file); } if (false === $file) { // Remember that this class does not exist. $this->missingClasses[$class] = true; } return $file; } /** * Returns the currently registered loaders indexed by their corresponding vendor directories. * * @return self[] */ public static function getRegisteredLoaders() { return self::$registeredLoaders; } /** * @param string $class * @param string $ext * @return string|false */ private function findFileWithExtension($class, $ext) { // PSR-4 lookup $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext; $first = $class[0]; if (isset($this->prefixLengthsPsr4[$first])) { $subPath = $class; while (false !== $lastPos = strrpos($subPath, '\\')) { $subPath = substr($subPath, 0, $lastPos); $search = $subPath . '\\'; if (isset($this->prefixDirsPsr4[$search])) { $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1); foreach ($this->prefixDirsPsr4[$search] as $dir) { if (file_exists($file = $dir . $pathEnd)) { return $file; } } } } } // PSR-4 fallback dirs foreach ($this->fallbackDirsPsr4 as $dir) { if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) { return $file; } } // PSR-0 lookup if (false !== $pos = strrpos($class, '\\')) { // namespaced class name $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1) . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR); } else { // PEAR-like class name $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext; } if (isset($this->prefixesPsr0[$first])) { foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) { if (0 === strpos($class, $prefix)) { foreach ($dirs as $dir) { if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { return $file; } } } } } // PSR-0 fallback dirs foreach ($this->fallbackDirsPsr0 as $dir) { if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { return $file; } } // PSR-0 include paths. if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) { return $file; } return false; } private static function initializeIncludeClosure(): void { if (self::$includeFile !== null) { return; } /** * Scope isolated include. * * Prevents access to $this/self from included files. * * @param string $file * @return void */ self::$includeFile = static function($file) { include $file; }; } } array($vendorDir . '/danog/magicalserializer/src', $vendorDir . '/danog/primemodule/lib'), 'cash' => array($vendorDir . '/cash/lrucache/src'), 'Parsedown' => array($vendorDir . '/erusev/parsedown'), ); array($vendorDir . '/phpseclib/phpseclib/phpseclib'), 'danog\\MadelineProto\\' => array($vendorDir . '/danog/madelineproto/src/danog/MadelineProto'), 'danog\\Loop\\' => array($vendorDir . '/danog/loop/lib'), 'danog\\LibDNSJson\\' => array($vendorDir . '/danog/libdns-json/lib'), 'danog\\Decoder\\' => array($vendorDir . '/danog/tg-file-decoder/src'), 'Webmozart\\Assert\\' => array($vendorDir . '/webmozart/assert/src'), 'Symfony\\Polyfill\\Php80\\' => array($vendorDir . '/symfony/polyfill-php80'), 'Symfony\\Polyfill\\Mbstring\\' => array($vendorDir . '/symfony/polyfill-mbstring'), 'Psr\\Log\\' => array($vendorDir . '/psr/log/src'), 'Psr\\Http\\Message\\' => array($vendorDir . '/psr/http-factory/src', $vendorDir . '/psr/http-message/src'), 'ParagonIE\\ConstantTime\\' => array($vendorDir . '/paragonie/constant_time_encoding/src'), 'Monolog\\' => array($vendorDir . '/monolog/monolog/src/Monolog'), 'LibDNS\\' => array($vendorDir . '/daverandom/libdns/src'), 'League\\Uri\\' => array($vendorDir . '/league/uri/src', $vendorDir . '/league/uri-interfaces/src', $vendorDir . '/league/uri-parser/src'), 'Kelunik\\Certificate\\' => array($vendorDir . '/kelunik/certificate/lib'), 'Amp\\WindowsRegistry\\' => array($vendorDir . '/amphp/windows-registry/lib'), 'Amp\\Websocket\\Client\\' => array($vendorDir . '/amphp/websocket-client/src'), 'Amp\\Websocket\\' => array($vendorDir . '/amphp/websocket/src'), 'Amp\\Sync\\' => array($vendorDir . '/amphp/sync/src'), 'Amp\\Sql\\Common\\' => array($vendorDir . '/amphp/sql-common/src'), 'Amp\\Sql\\' => array($vendorDir . '/amphp/sql/src'), 'Amp\\Socket\\' => array($vendorDir . '/amphp/socket/src'), 'Amp\\Serialization\\' => array($vendorDir . '/amphp/serialization/src'), 'Amp\\Redis\\' => array($vendorDir . '/amphp/redis/src'), 'Amp\\Process\\' => array($vendorDir . '/amphp/process/lib'), 'Amp\\Postgres\\' => array($vendorDir . '/amphp/postgres/src'), 'Amp\\Parser\\' => array($vendorDir . '/amphp/parser/src'), 'Amp\\Parallel\\' => array($vendorDir . '/amphp/parallel/lib'), 'Amp\\Mysql\\' => array($vendorDir . '/amphp/mysql/src'), 'Amp\\Log\\' => array($vendorDir . '/amphp/log/src'), 'Amp\\Ipc\\' => array($vendorDir . '/danog/ipc/lib'), 'Amp\\Http\\Client\\Cookie\\' => array($vendorDir . '/amphp/http-client-cookies/src'), 'Amp\\Http\\Client\\' => array($vendorDir . '/amphp/http-client/src'), 'Amp\\Http\\' => array($vendorDir . '/amphp/hpack/src', $vendorDir . '/amphp/http/src'), 'Amp\\File\\' => array($vendorDir . '/amphp/file/src'), 'Amp\\DoH\\' => array($vendorDir . '/danog/dns-over-https/lib'), 'Amp\\Dns\\' => array($vendorDir . '/amphp/dns/lib'), 'Amp\\Cache\\' => array($vendorDir . '/amphp/cache/lib'), 'Amp\\ByteStream\\' => array($vendorDir . '/amphp/byte-stream/lib'), 'Amp\\' => array($vendorDir . '/amphp/amp/lib'), ); * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer; use Composer\Autoload\ClassLoader; use Composer\Semver\VersionParser; /** * This class is copied in every Composer installed project and available to all * * See also https://getcomposer.org/doc/07-runtime.md#installed-versions * * To require its presence, you can require `composer-runtime-api ^2.0` * * @final */ class InstalledVersions { /** * @var mixed[]|null * @psalm-var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array}|array{}|null */ private static $installed; /** * @var bool|null */ private static $canGetVendors; /** * @var array[] * @psalm-var array}> */ private static $installedByVendor = array(); /** * Returns a list of all package names which are present, either by being installed, replaced or provided * * @return string[] * @psalm-return list */ public static function getInstalledPackages() { $packages = array(); foreach (self::getInstalled() as $installed) { $packages[] = array_keys($installed['versions']); } if (1 === \count($packages)) { return $packages[0]; } return array_keys(array_flip(\call_user_func_array('array_merge', $packages))); } /** * Returns a list of all package names with a specific type e.g. 'library' * * @param string $type * @return string[] * @psalm-return list */ public static function getInstalledPackagesByType($type) { $packagesByType = array(); foreach (self::getInstalled() as $installed) { foreach ($installed['versions'] as $name => $package) { if (isset($package['type']) && $package['type'] === $type) { $packagesByType[] = $name; } } } return $packagesByType; } /** * Checks whether the given package is installed * * This also returns true if the package name is provided or replaced by another package * * @param string $packageName * @param bool $includeDevRequirements * @return bool */ public static function isInstalled($packageName, $includeDevRequirements = true) { foreach (self::getInstalled() as $installed) { if (isset($installed['versions'][$packageName])) { return $includeDevRequirements || empty($installed['versions'][$packageName]['dev_requirement']); } } return false; } /** * Checks whether the given package satisfies a version constraint * * e.g. If you want to know whether version 2.3+ of package foo/bar is installed, you would call: * * Composer\InstalledVersions::satisfies(new VersionParser, 'foo/bar', '^2.3') * * @param VersionParser $parser Install composer/semver to have access to this class and functionality * @param string $packageName * @param string|null $constraint A version constraint to check for, if you pass one you have to make sure composer/semver is required by your package * @return bool */ public static function satisfies(VersionParser $parser, $packageName, $constraint) { $constraint = $parser->parseConstraints($constraint); $provided = $parser->parseConstraints(self::getVersionRanges($packageName)); return $provided->matches($constraint); } /** * Returns a version constraint representing all the range(s) which are installed for a given package * * It is easier to use this via isInstalled() with the $constraint argument if you need to check * whether a given version of a package is installed, and not just whether it exists * * @param string $packageName * @return string Version constraint usable with composer/semver */ public static function getVersionRanges($packageName) { foreach (self::getInstalled() as $installed) { if (!isset($installed['versions'][$packageName])) { continue; } $ranges = array(); if (isset($installed['versions'][$packageName]['pretty_version'])) { $ranges[] = $installed['versions'][$packageName]['pretty_version']; } if (array_key_exists('aliases', $installed['versions'][$packageName])) { $ranges = array_merge($ranges, $installed['versions'][$packageName]['aliases']); } if (array_key_exists('replaced', $installed['versions'][$packageName])) { $ranges = array_merge($ranges, $installed['versions'][$packageName]['replaced']); } if (array_key_exists('provided', $installed['versions'][$packageName])) { $ranges = array_merge($ranges, $installed['versions'][$packageName]['provided']); } return implode(' || ', $ranges); } throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed'); } /** * @param string $packageName * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present */ public static function getVersion($packageName) { foreach (self::getInstalled() as $installed) { if (!isset($installed['versions'][$packageName])) { continue; } if (!isset($installed['versions'][$packageName]['version'])) { return null; } return $installed['versions'][$packageName]['version']; } throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed'); } /** * @param string $packageName * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present */ public static function getPrettyVersion($packageName) { foreach (self::getInstalled() as $installed) { if (!isset($installed['versions'][$packageName])) { continue; } if (!isset($installed['versions'][$packageName]['pretty_version'])) { return null; } return $installed['versions'][$packageName]['pretty_version']; } throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed'); } /** * @param string $packageName * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as reference */ public static function getReference($packageName) { foreach (self::getInstalled() as $installed) { if (!isset($installed['versions'][$packageName])) { continue; } if (!isset($installed['versions'][$packageName]['reference'])) { return null; } return $installed['versions'][$packageName]['reference']; } throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed'); } /** * @param string $packageName * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as install path. Packages of type metapackages also have a null install path. */ public static function getInstallPath($packageName) { foreach (self::getInstalled() as $installed) { if (!isset($installed['versions'][$packageName])) { continue; } return isset($installed['versions'][$packageName]['install_path']) ? $installed['versions'][$packageName]['install_path'] : null; } throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed'); } /** * @return array * @psalm-return array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool} */ public static function getRootPackage() { $installed = self::getInstalled(); return $installed[0]['root']; } /** * Returns the raw installed.php data for custom implementations * * @deprecated Use getAllRawData() instead which returns all datasets for all autoloaders present in the process. getRawData only returns the first dataset loaded, which may not be what you expect. * @return array[] * @psalm-return array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array} */ public static function getRawData() { @trigger_error('getRawData only returns the first dataset loaded, which may not be what you expect. Use getAllRawData() instead which returns all datasets for all autoloaders present in the process.', E_USER_DEPRECATED); if (null === self::$installed) { // only require the installed.php file if this file is loaded from its dumped location, // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937 if (substr(__DIR__, -8, 1) !== 'C') { self::$installed = include __DIR__ . '/installed.php'; } else { self::$installed = array(); } } return self::$installed; } /** * Returns the raw data of all installed.php which are currently loaded for custom implementations * * @return array[] * @psalm-return list}> */ public static function getAllRawData() { return self::getInstalled(); } /** * Lets you reload the static array from another file * * This is only useful for complex integrations in which a project needs to use * this class but then also needs to execute another project's autoloader in process, * and wants to ensure both projects have access to their version of installed.php. * * A typical case would be PHPUnit, where it would need to make sure it reads all * the data it needs from this class, then call reload() with * `require $CWD/vendor/composer/installed.php` (or similar) as input to make sure * the project in which it runs can then also use this class safely, without * interference between PHPUnit's dependencies and the project's dependencies. * * @param array[] $data A vendor/composer/installed.php data set * @return void * * @psalm-param array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array} $data */ public static function reload($data) { self::$installed = $data; self::$installedByVendor = array(); } /** * @return array[] * @psalm-return list}> */ private static function getInstalled() { if (null === self::$canGetVendors) { self::$canGetVendors = method_exists('Composer\Autoload\ClassLoader', 'getRegisteredLoaders'); } $installed = array(); if (self::$canGetVendors) { foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) { if (isset(self::$installedByVendor[$vendorDir])) { $installed[] = self::$installedByVendor[$vendorDir]; } elseif (is_file($vendorDir.'/composer/installed.php')) { $installed[] = self::$installedByVendor[$vendorDir] = require $vendorDir.'/composer/installed.php'; if (null === self::$installed && strtr($vendorDir.'/composer', '\\', '/') === strtr(__DIR__, '\\', '/')) { self::$installed = $installed[count($installed) - 1]; } } } } if (null === self::$installed) { // only require the installed.php file if this file is loaded from its dumped location, // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937 if (substr(__DIR__, -8, 1) !== 'C') { self::$installed = require __DIR__ . '/installed.php'; } else { self::$installed = array(); } } $installed[] = self::$installed; return $installed; } } register(true); $filesToLoad = \Composer\Autoload\ComposerStaticInit16d0af0e1ea4d15d9ba7041440af7b83::$files; $requireFile = static function ($fileIdentifier, $file) { if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) { $GLOBALS['__composer_autoload_files'][$fileIdentifier] = true; require $file; } }; foreach ($filesToLoad as $fileIdentifier => $file) { ($requireFile)($fileIdentifier, $file); } return $loader; } } array( 'name' => 'danog/madelineprotophar', 'pretty_version' => '1.0.0+no-version-set', 'version' => '1.0.0.0', 'reference' => NULL, 'type' => 'library', 'install_path' => __DIR__ . '/../../', 'aliases' => array(), 'dev' => true, ), 'versions' => array( 'amphp/amp' => array( 'pretty_version' => 'v2.6.2', 'version' => '2.6.2.0', 'reference' => '9d5100cebffa729aaffecd3ad25dc5aeea4f13bb', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/amp', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/byte-stream' => array( 'pretty_version' => 'v1.8.1', 'version' => '1.8.1.0', 'reference' => 'acbd8002b3536485c997c4e019206b3f10ca15bd', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/byte-stream', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/cache' => array( 'pretty_version' => 'v1.5.0', 'version' => '1.5.0.0', 'reference' => '2b6b5dbb70e54cc914df9952ba7c012bc4cbcd28', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/cache', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/dns' => array( 'pretty_version' => 'v1.2.3', 'version' => '1.2.3.0', 'reference' => '852292532294d7972c729a96b49756d781f7c59d', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/dns', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/file' => array( 'pretty_version' => 'v2.0.4', 'version' => '2.0.4.0', 'reference' => 'be639a9b1f579d3fe847ca0dcc17c7a7f5168910', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/file', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/hpack' => array( 'pretty_version' => 'v3.1.1', 'version' => '3.1.1.0', 'reference' => 'cf4f1663e9fd58f60258c06177098655ca6377a5', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/hpack', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/http' => array( 'pretty_version' => 'v1.7.0', 'version' => '1.7.0.0', 'reference' => 'b65454643a7e92c6f1f75e00acac0a0a676ec8be', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/http', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/http-client' => array( 'pretty_version' => 'v4.6.2', 'version' => '4.6.2.0', 'reference' => '453f84f623e409889168351e60246f5feddc1b3c', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/http-client', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/http-client-cookies' => array( 'pretty_version' => 'v1.2.0', 'version' => '1.2.0.0', 'reference' => 'ab7e498bb6c4e389e2b9880727d6470997189d87', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/http-client-cookies', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/log' => array( 'pretty_version' => 'v1.1.0', 'version' => '1.1.0.0', 'reference' => '25dcd3b58622bd22ffa7129288edb85e0c17081a', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/log', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/mysql' => array( 'pretty_version' => 'v2.1.3', 'version' => '2.1.3.0', 'reference' => 'dac7e7149da22ef4473c026efae5d307d8fd41b7', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/mysql', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/parallel' => array( 'pretty_version' => 'v1.4.2', 'version' => '1.4.2.0', 'reference' => '75853e1623efa5aa5e65e986ec9a97db573a5267', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/parallel', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/parser' => array( 'pretty_version' => 'v1.1.0', 'version' => '1.1.0.0', 'reference' => 'ff1de4144726c5dad5fab97f66692ebe8de3e151', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/parser', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/postgres' => array( 'pretty_version' => 'v1.4.4', 'version' => '1.4.4.0', 'reference' => 'c3d249063c2b283d9d4aab206b0fbf88401e9a26', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/postgres', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/process' => array( 'pretty_version' => 'v1.1.4', 'version' => '1.1.4.0', 'reference' => '76e9495fd6818b43a20167cb11d8a67f7744ee0f', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/process', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/redis' => array( 'pretty_version' => 'v1.0.7', 'version' => '1.0.7.0', 'reference' => '90aa4f50d7889a880d15e6e4a504b398e16faa82', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/redis', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/serialization' => array( 'pretty_version' => 'v1.0.0', 'version' => '1.0.0.0', 'reference' => '693e77b2fb0b266c3c7d622317f881de44ae94a1', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/serialization', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/socket' => array( 'pretty_version' => 'v1.2.0', 'version' => '1.2.0.0', 'reference' => 'a8af9f5d0a66c5fe9567da45a51509e592788fe6', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/socket', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/sql' => array( 'pretty_version' => 'v1.0.2', 'version' => '1.0.2.0', 'reference' => '5a1dcfd9a3c3518826c616b4d0b0fa0363f087fa', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/sql', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/sql-common' => array( 'pretty_version' => 'v1.1.4', 'version' => '1.1.4.0', 'reference' => '6ed5b96d26528bd56213ebb867a2992e7a0b8278', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/sql-common', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/sync' => array( 'pretty_version' => 'v1.4.2', 'version' => '1.4.2.0', 'reference' => '85ab06764f4f36d63b1356b466df6111cf4b89cf', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/sync', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/websocket' => array( 'pretty_version' => 'v1.0.3', 'version' => '1.0.3.0', 'reference' => '248e9dc1be0477932cd1788e5002b0aabf66f179', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/websocket', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/websocket-client' => array( 'pretty_version' => 'v1.0.1', 'version' => '1.0.1.0', 'reference' => 'bcf5262e66abec420896a7893b7a08e9e2e655e8', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/websocket-client', 'aliases' => array(), 'dev_requirement' => false, ), 'amphp/windows-registry' => array( 'pretty_version' => 'v0.3.3', 'version' => '0.3.3.0', 'reference' => '0f56438b9197e224325e88f305346f0221df1f71', 'type' => 'library', 'install_path' => __DIR__ . '/../amphp/windows-registry', 'aliases' => array(), 'dev_requirement' => false, ), 'cash/lrucache' => array( 'pretty_version' => '1.0.0', 'version' => '1.0.0.0', 'reference' => '4fa4c6834cec59690b43526c4da41d6153026289', 'type' => 'library', 'install_path' => __DIR__ . '/../cash/lrucache', 'aliases' => array(), 'dev_requirement' => false, ), 'danog/dns-over-https' => array( 'pretty_version' => '0.2.6', 'version' => '0.2.6.0', 'reference' => 'a288be1f4fdd4ce9838e98bfa96407fcfdd099b3', 'type' => 'library', 'install_path' => __DIR__ . '/../danog/dns-over-https', 'aliases' => array(), 'dev_requirement' => false, ), 'danog/ipc' => array( 'pretty_version' => '0.1.15', 'version' => '0.1.15.0', 'reference' => '6bbd35f057746dba2baad58465fca1a93302bf67', 'type' => 'library', 'install_path' => __DIR__ . '/../danog/ipc', 'aliases' => array(), 'dev_requirement' => false, ), 'danog/libdns-json' => array( 'pretty_version' => '0.1.1', 'version' => '0.1.1.0', 'reference' => '7d5e07815d57afa64ef7cdbe1a65fbead9a3e7bd', 'type' => 'library', 'install_path' => __DIR__ . '/../danog/libdns-json', 'aliases' => array(), 'dev_requirement' => false, ), 'danog/loop' => array( 'pretty_version' => '0.1.1', 'version' => '0.1.1.0', 'reference' => 'b1941cc6a7b2eede57d11a6ead464ee70793bc3f', 'type' => 'library', 'install_path' => __DIR__ . '/../danog/loop', 'aliases' => array(), 'dev_requirement' => false, ), 'danog/madelineproto' => array( 'pretty_version' => '7.0.148', 'version' => '7.0.148.0', 'reference' => '2b618e0557f937060a5931088fcde3bee24dfde7', 'type' => 'project', 'install_path' => __DIR__ . '/../danog/madelineproto', 'aliases' => array(), 'dev_requirement' => false, ), 'danog/madelineprotophar' => array( 'pretty_version' => '1.0.0+no-version-set', 'version' => '1.0.0.0', 'reference' => NULL, 'type' => 'library', 'install_path' => __DIR__ . '/../../', 'aliases' => array(), 'dev_requirement' => false, ), 'danog/magicalserializer' => array( 'pretty_version' => '1.0', 'version' => '1.0.0.0', 'reference' => '87b6ed05a86021e9364f31133089bb83980d5e24', 'type' => 'library', 'install_path' => __DIR__ . '/../danog/magicalserializer', 'aliases' => array(), 'dev_requirement' => false, ), 'danog/primemodule' => array( 'pretty_version' => '1.0.11.9999', 'version' => '1.0.11.9999', 'reference' => '2328b1ec43b4a2a318602f4b16d6bf628ca96d04', 'type' => 'library', 'install_path' => __DIR__ . '/../danog/primemodule', 'aliases' => array(), 'dev_requirement' => false, ), 'danog/tg-file-decoder' => array( 'pretty_version' => '0.1.12', 'version' => '0.1.12.0', 'reference' => 'fd9827e7af8f3b47dc6db4b1c12bfeb6654dde4f', 'type' => 'project', 'install_path' => __DIR__ . '/../danog/tg-file-decoder', 'aliases' => array(), 'dev_requirement' => false, ), 'daverandom/libdns' => array( 'pretty_version' => 'v2.0.3', 'version' => '2.0.3.0', 'reference' => '42c2d700d1178c9f9e78664793463f7f1aea248c', 'type' => 'library', 'install_path' => __DIR__ . '/../daverandom/libdns', 'aliases' => array(), 'dev_requirement' => false, ), 'erusev/parsedown' => array( 'pretty_version' => '1.7.4', 'version' => '1.7.4.0', 'reference' => 'cb17b6477dfff935958ba01325f2e8a2bfa6dab3', 'type' => 'library', 'install_path' => __DIR__ . '/../erusev/parsedown', 'aliases' => array(), 'dev_requirement' => false, ), 'kelunik/certificate' => array( 'pretty_version' => 'v1.1.2', 'version' => '1.1.2.0', 'reference' => '56542e62d51533d04d0a9713261fea546bff80f6', 'type' => 'library', 'install_path' => __DIR__ . '/../kelunik/certificate', 'aliases' => array(), 'dev_requirement' => false, ), 'league/uri' => array( 'pretty_version' => '6.8.0', 'version' => '6.8.0.0', 'reference' => 'a700b4656e4c54371b799ac61e300ab25a2d1d39', 'type' => 'library', 'install_path' => __DIR__ . '/../league/uri', 'aliases' => array(), 'dev_requirement' => false, ), 'league/uri-interfaces' => array( 'pretty_version' => '2.3.0', 'version' => '2.3.0.0', 'reference' => '00e7e2943f76d8cb50c7dfdc2f6dee356e15e383', 'type' => 'library', 'install_path' => __DIR__ . '/../league/uri-interfaces', 'aliases' => array(), 'dev_requirement' => false, ), 'league/uri-parser' => array( 'pretty_version' => '1.4.1', 'version' => '1.4.1.0', 'reference' => '671548427e4c932352d9b9279fdfa345bf63fa00', 'type' => 'library', 'install_path' => __DIR__ . '/../league/uri-parser', 'aliases' => array(), 'dev_requirement' => false, ), 'monolog/monolog' => array( 'pretty_version' => '2.8.0', 'version' => '2.8.0.0', 'reference' => '720488632c590286b88b80e62aa3d3d551ad4a50', 'type' => 'library', 'install_path' => __DIR__ . '/../monolog/monolog', 'aliases' => array(), 'dev_requirement' => false, ), 'paragonie/constant_time_encoding' => array( 'pretty_version' => 'v2.6.3', 'version' => '2.6.3.0', 'reference' => '58c3f47f650c94ec05a151692652a868995d2938', 'type' => 'library', 'install_path' => __DIR__ . '/../paragonie/constant_time_encoding', 'aliases' => array(), 'dev_requirement' => false, ), 'paragonie/random_compat' => array( 'pretty_version' => 'v9.99.100', 'version' => '9.99.100.0', 'reference' => '996434e5492cb4c3edcb9168db6fbb1359ef965a', 'type' => 'library', 'install_path' => __DIR__ . '/../paragonie/random_compat', 'aliases' => array(), 'dev_requirement' => false, ), 'phpseclib/phpseclib' => array( 'pretty_version' => '3.0.18', 'version' => '3.0.18.0', 'reference' => 'f28693d38ba21bb0d9f0c411ee5dae2b178201da', 'type' => 'library', 'install_path' => __DIR__ . '/../phpseclib/phpseclib', 'aliases' => array(), 'dev_requirement' => false, ), 'psr/http-factory' => array( 'pretty_version' => '1.0.1', 'version' => '1.0.1.0', 'reference' => '12ac7fcd07e5b077433f5f2bee95b3a771bf61be', 'type' => 'library', 'install_path' => __DIR__ . '/../psr/http-factory', 'aliases' => array(), 'dev_requirement' => false, ), 'psr/http-message' => array( 'pretty_version' => '1.0.1', 'version' => '1.0.1.0', 'reference' => 'f6561bf28d520154e4b0ec72be95418abe6d9363', 'type' => 'library', 'install_path' => __DIR__ . '/../psr/http-message', 'aliases' => array(), 'dev_requirement' => false, ), 'psr/log' => array( 'pretty_version' => '3.0.0', 'version' => '3.0.0.0', 'reference' => 'fe5ea303b0887d5caefd3d431c3e61ad47037001', 'type' => 'library', 'install_path' => __DIR__ . '/../psr/log', 'aliases' => array(), 'dev_requirement' => false, ), 'psr/log-implementation' => array( 'dev_requirement' => false, 'provided' => array( 0 => '1.0.0 || 2.0.0 || 3.0.0', ), ), 'symfony/polyfill-mbstring' => array( 'pretty_version' => 'v1.27.0', 'version' => '1.27.0.0', 'reference' => '8ad114f6b39e2c98a8b0e3bd907732c207c2b534', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/polyfill-mbstring', 'aliases' => array(), 'dev_requirement' => false, ), 'symfony/polyfill-php80' => array( 'pretty_version' => 'v1.27.0', 'version' => '1.27.0.0', 'reference' => '7a6ff3f1959bb01aefccb463a0f2cd3d3d2fd936', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/polyfill-php80', 'aliases' => array(), 'dev_requirement' => false, ), 'webmozart/assert' => array( 'pretty_version' => '1.11.0', 'version' => '1.11.0.0', 'reference' => '11cb2199493b2f8a3b53e7f19068fc6aac760991', 'type' => 'library', 'install_path' => __DIR__ . '/../webmozart/assert', 'aliases' => array(), 'dev_requirement' => false, ), ), ); $vendorDir . '/amphp/amp/lib/functions.php', '76cd0796156622033397994f25b0d8fc' => $vendorDir . '/amphp/amp/lib/Internal/functions.php', '6cd5651c4fef5ed6b63e8d8b8ffbf3cc' => $vendorDir . '/amphp/byte-stream/lib/functions.php', 'bcb7d4fc55f4b1a7e10f5806723e9892' => $vendorDir . '/amphp/sync/src/functions.php', 'e187e371b30897d6dc51cac6a8c94ff6' => $vendorDir . '/amphp/sync/src/ConcurrentIterator/functions.php', '3da389f428d8ee50333e4391c3f45046' => $vendorDir . '/amphp/serialization/src/functions.php', '445532134d762b3cbc25500cac266092' => $vendorDir . '/daverandom/libdns/src/functions.php', '8dc56fe697ca93c4b40d876df1c94584' => $vendorDir . '/amphp/process/lib/functions.php', '7ebf029ad4b246f1e3f66192b40a932f' => $vendorDir . '/amphp/dns/lib/functions.php', 'e1e8b49c332434256b5df11b0f0c2a62' => $vendorDir . '/league/uri-parser/src/functions_include.php', 'd4e415514e4352172d58f02433fa50e4' => $vendorDir . '/amphp/socket/src/functions.php', '1c2dcb9d6851a7abaae89f9586ddd460' => $vendorDir . '/amphp/socket/src/Internal/functions.php', '3d8ee50db78074a9235f0c2008c26b42' => $vendorDir . '/amphp/http/src/functions.php', '77e5a577434e31d19d8dd6aeceac1ff4' => $vendorDir . '/amphp/http-client/src/Internal/functions.php', '430de19db8b7ee88fdbe5c545d82d33d' => $vendorDir . '/amphp/parallel/lib/Context/functions.php', '888e1afeed2e8d13ef5a662692091e6e' => $vendorDir . '/amphp/parallel/lib/Sync/functions.php', '384cf4f2eb4d2f896db72315a76066ad' => $vendorDir . '/amphp/parallel/lib/Worker/functions.php', '3d05d4f147c95ba663000bd908d45656' => $vendorDir . '/amphp/websocket/src/functions.php', 'd10f490189cfd2d00bda2b165dfbacae' => $vendorDir . '/amphp/file/src/functions.php', '5ac5dbc97af12bd847e1db9fe93e192f' => $vendorDir . '/amphp/log/src/functions.php', '73cfe662a9f753fb79cdfcb7b4206d43' => $vendorDir . '/amphp/mysql/src/functions.php', '4da7a33b8388a4c58699a4f48894fced' => $vendorDir . '/amphp/postgres/src/functions.php', '33e77b43ad8185a87488d9c8e2900fb0' => $vendorDir . '/amphp/postgres/src/Internal/functions.php', '792db3860ad68f8c7b522ed67947a5eb' => $vendorDir . '/amphp/redis/src/functions.php', '4be4fbd9f5a89207b1fd1c85ae339dd7' => $vendorDir . '/amphp/websocket-client/src/functions.php', '2b4b72fd9056e8b7ab3f418bbf68fc53' => $vendorDir . '/danog/ipc/lib/functions.php', '7863bea9b51b9d5d18cf67e24652d340' => $vendorDir . '/danog/tg-file-decoder/src/type.php', 'decc78cc4436b1292c6c0d151b19445c' => $vendorDir . '/phpseclib/phpseclib/phpseclib/bootstrap.php', '0e6d7bf4a5811bfa5cf40c5ccd6fae6a' => $vendorDir . '/symfony/polyfill-mbstring/bootstrap.php', 'a4a119a56e50fbb293281d9a48007e0e' => $vendorDir . '/symfony/polyfill-php80/bootstrap.php', 'efa3b80c61fb35e374f529ec349af098' => $vendorDir . '/danog/madelineproto/src/BigIntegor.php', 'cad60ee4f0892badc28f3feef7cce08d' => $vendorDir . '/danog/madelineproto/src/polyfill.php', ); __DIR__ . '/..' . '/amphp/amp/lib/functions.php', '76cd0796156622033397994f25b0d8fc' => __DIR__ . '/..' . '/amphp/amp/lib/Internal/functions.php', '6cd5651c4fef5ed6b63e8d8b8ffbf3cc' => __DIR__ . '/..' . '/amphp/byte-stream/lib/functions.php', 'bcb7d4fc55f4b1a7e10f5806723e9892' => __DIR__ . '/..' . '/amphp/sync/src/functions.php', 'e187e371b30897d6dc51cac6a8c94ff6' => __DIR__ . '/..' . '/amphp/sync/src/ConcurrentIterator/functions.php', '3da389f428d8ee50333e4391c3f45046' => __DIR__ . '/..' . '/amphp/serialization/src/functions.php', '445532134d762b3cbc25500cac266092' => __DIR__ . '/..' . '/daverandom/libdns/src/functions.php', '8dc56fe697ca93c4b40d876df1c94584' => __DIR__ . '/..' . '/amphp/process/lib/functions.php', '7ebf029ad4b246f1e3f66192b40a932f' => __DIR__ . '/..' . '/amphp/dns/lib/functions.php', 'e1e8b49c332434256b5df11b0f0c2a62' => __DIR__ . '/..' . '/league/uri-parser/src/functions_include.php', 'd4e415514e4352172d58f02433fa50e4' => __DIR__ . '/..' . '/amphp/socket/src/functions.php', '1c2dcb9d6851a7abaae89f9586ddd460' => __DIR__ . '/..' . '/amphp/socket/src/Internal/functions.php', '3d8ee50db78074a9235f0c2008c26b42' => __DIR__ . '/..' . '/amphp/http/src/functions.php', '77e5a577434e31d19d8dd6aeceac1ff4' => __DIR__ . '/..' . '/amphp/http-client/src/Internal/functions.php', '430de19db8b7ee88fdbe5c545d82d33d' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/functions.php', '888e1afeed2e8d13ef5a662692091e6e' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/functions.php', '384cf4f2eb4d2f896db72315a76066ad' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/functions.php', '3d05d4f147c95ba663000bd908d45656' => __DIR__ . '/..' . '/amphp/websocket/src/functions.php', 'd10f490189cfd2d00bda2b165dfbacae' => __DIR__ . '/..' . '/amphp/file/src/functions.php', '5ac5dbc97af12bd847e1db9fe93e192f' => __DIR__ . '/..' . '/amphp/log/src/functions.php', '73cfe662a9f753fb79cdfcb7b4206d43' => __DIR__ . '/..' . '/amphp/mysql/src/functions.php', '4da7a33b8388a4c58699a4f48894fced' => __DIR__ . '/..' . '/amphp/postgres/src/functions.php', '33e77b43ad8185a87488d9c8e2900fb0' => __DIR__ . '/..' . '/amphp/postgres/src/Internal/functions.php', '792db3860ad68f8c7b522ed67947a5eb' => __DIR__ . '/..' . '/amphp/redis/src/functions.php', '4be4fbd9f5a89207b1fd1c85ae339dd7' => __DIR__ . '/..' . '/amphp/websocket-client/src/functions.php', '2b4b72fd9056e8b7ab3f418bbf68fc53' => __DIR__ . '/..' . '/danog/ipc/lib/functions.php', '7863bea9b51b9d5d18cf67e24652d340' => __DIR__ . '/..' . '/danog/tg-file-decoder/src/type.php', 'decc78cc4436b1292c6c0d151b19445c' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/bootstrap.php', '0e6d7bf4a5811bfa5cf40c5ccd6fae6a' => __DIR__ . '/..' . '/symfony/polyfill-mbstring/bootstrap.php', 'a4a119a56e50fbb293281d9a48007e0e' => __DIR__ . '/..' . '/symfony/polyfill-php80/bootstrap.php', 'efa3b80c61fb35e374f529ec349af098' => __DIR__ . '/..' . '/danog/madelineproto/src/BigIntegor.php', 'cad60ee4f0892badc28f3feef7cce08d' => __DIR__ . '/..' . '/danog/madelineproto/src/polyfill.php', ); public static $prefixLengthsPsr4 = array ( 'p' => array ( 'phpseclib3\\' => 11, ), 'd' => array ( 'danog\\MadelineProto\\' => 20, 'danog\\Loop\\' => 11, 'danog\\LibDNSJson\\' => 17, 'danog\\Decoder\\' => 14, ), 'W' => array ( 'Webmozart\\Assert\\' => 17, ), 'S' => array ( 'Symfony\\Polyfill\\Php80\\' => 23, 'Symfony\\Polyfill\\Mbstring\\' => 26, ), 'P' => array ( 'Psr\\Log\\' => 8, 'Psr\\Http\\Message\\' => 17, 'ParagonIE\\ConstantTime\\' => 23, ), 'M' => array ( 'Monolog\\' => 8, ), 'L' => array ( 'LibDNS\\' => 7, 'League\\Uri\\' => 11, ), 'K' => array ( 'Kelunik\\Certificate\\' => 20, ), 'A' => array ( 'Amp\\WindowsRegistry\\' => 20, 'Amp\\Websocket\\Client\\' => 21, 'Amp\\Websocket\\' => 14, 'Amp\\Sync\\' => 9, 'Amp\\Sql\\Common\\' => 15, 'Amp\\Sql\\' => 8, 'Amp\\Socket\\' => 11, 'Amp\\Serialization\\' => 18, 'Amp\\Redis\\' => 10, 'Amp\\Process\\' => 12, 'Amp\\Postgres\\' => 13, 'Amp\\Parser\\' => 11, 'Amp\\Parallel\\' => 13, 'Amp\\Mysql\\' => 10, 'Amp\\Log\\' => 8, 'Amp\\Ipc\\' => 8, 'Amp\\Http\\Client\\Cookie\\' => 23, 'Amp\\Http\\Client\\' => 16, 'Amp\\Http\\' => 9, 'Amp\\File\\' => 9, 'Amp\\DoH\\' => 8, 'Amp\\Dns\\' => 8, 'Amp\\Cache\\' => 10, 'Amp\\ByteStream\\' => 15, 'Amp\\' => 4, ), ); public static $prefixDirsPsr4 = array ( 'phpseclib3\\' => array ( 0 => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib', ), 'danog\\MadelineProto\\' => array ( 0 => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto', ), 'danog\\Loop\\' => array ( 0 => __DIR__ . '/..' . '/danog/loop/lib', ), 'danog\\LibDNSJson\\' => array ( 0 => __DIR__ . '/..' . '/danog/libdns-json/lib', ), 'danog\\Decoder\\' => array ( 0 => __DIR__ . '/..' . '/danog/tg-file-decoder/src', ), 'Webmozart\\Assert\\' => array ( 0 => __DIR__ . '/..' . '/webmozart/assert/src', ), 'Symfony\\Polyfill\\Php80\\' => array ( 0 => __DIR__ . '/..' . '/symfony/polyfill-php80', ), 'Symfony\\Polyfill\\Mbstring\\' => array ( 0 => __DIR__ . '/..' . '/symfony/polyfill-mbstring', ), 'Psr\\Log\\' => array ( 0 => __DIR__ . '/..' . '/psr/log/src', ), 'Psr\\Http\\Message\\' => array ( 0 => __DIR__ . '/..' . '/psr/http-factory/src', 1 => __DIR__ . '/..' . '/psr/http-message/src', ), 'ParagonIE\\ConstantTime\\' => array ( 0 => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src', ), 'Monolog\\' => array ( 0 => __DIR__ . '/..' . '/monolog/monolog/src/Monolog', ), 'LibDNS\\' => array ( 0 => __DIR__ . '/..' . '/daverandom/libdns/src', ), 'League\\Uri\\' => array ( 0 => __DIR__ . '/..' . '/league/uri/src', 1 => __DIR__ . '/..' . '/league/uri-interfaces/src', 2 => __DIR__ . '/..' . '/league/uri-parser/src', ), 'Kelunik\\Certificate\\' => array ( 0 => __DIR__ . '/..' . '/kelunik/certificate/lib', ), 'Amp\\WindowsRegistry\\' => array ( 0 => __DIR__ . '/..' . '/amphp/windows-registry/lib', ), 'Amp\\Websocket\\Client\\' => array ( 0 => __DIR__ . '/..' . '/amphp/websocket-client/src', ), 'Amp\\Websocket\\' => array ( 0 => __DIR__ . '/..' . '/amphp/websocket/src', ), 'Amp\\Sync\\' => array ( 0 => __DIR__ . '/..' . '/amphp/sync/src', ), 'Amp\\Sql\\Common\\' => array ( 0 => __DIR__ . '/..' . '/amphp/sql-common/src', ), 'Amp\\Sql\\' => array ( 0 => __DIR__ . '/..' . '/amphp/sql/src', ), 'Amp\\Socket\\' => array ( 0 => __DIR__ . '/..' . '/amphp/socket/src', ), 'Amp\\Serialization\\' => array ( 0 => __DIR__ . '/..' . '/amphp/serialization/src', ), 'Amp\\Redis\\' => array ( 0 => __DIR__ . '/..' . '/amphp/redis/src', ), 'Amp\\Process\\' => array ( 0 => __DIR__ . '/..' . '/amphp/process/lib', ), 'Amp\\Postgres\\' => array ( 0 => __DIR__ . '/..' . '/amphp/postgres/src', ), 'Amp\\Parser\\' => array ( 0 => __DIR__ . '/..' . '/amphp/parser/src', ), 'Amp\\Parallel\\' => array ( 0 => __DIR__ . '/..' . '/amphp/parallel/lib', ), 'Amp\\Mysql\\' => array ( 0 => __DIR__ . '/..' . '/amphp/mysql/src', ), 'Amp\\Log\\' => array ( 0 => __DIR__ . '/..' . '/amphp/log/src', ), 'Amp\\Ipc\\' => array ( 0 => __DIR__ . '/..' . '/danog/ipc/lib', ), 'Amp\\Http\\Client\\Cookie\\' => array ( 0 => __DIR__ . '/..' . '/amphp/http-client-cookies/src', ), 'Amp\\Http\\Client\\' => array ( 0 => __DIR__ . '/..' . '/amphp/http-client/src', ), 'Amp\\Http\\' => array ( 0 => __DIR__ . '/..' . '/amphp/hpack/src', 1 => __DIR__ . '/..' . '/amphp/http/src', ), 'Amp\\File\\' => array ( 0 => __DIR__ . '/..' . '/amphp/file/src', ), 'Amp\\DoH\\' => array ( 0 => __DIR__ . '/..' . '/danog/dns-over-https/lib', ), 'Amp\\Dns\\' => array ( 0 => __DIR__ . '/..' . '/amphp/dns/lib', ), 'Amp\\Cache\\' => array ( 0 => __DIR__ . '/..' . '/amphp/cache/lib', ), 'Amp\\ByteStream\\' => array ( 0 => __DIR__ . '/..' . '/amphp/byte-stream/lib', ), 'Amp\\' => array ( 0 => __DIR__ . '/..' . '/amphp/amp/lib', ), ); public static $prefixesPsr0 = array ( 'd' => array ( 'danog\\' => array ( 0 => __DIR__ . '/..' . '/danog/magicalserializer/src', 1 => __DIR__ . '/..' . '/danog/primemodule/lib', ), ), 'c' => array ( 'cash' => array ( 0 => __DIR__ . '/..' . '/cash/lrucache/src', ), ), 'P' => array ( 'Parsedown' => array ( 0 => __DIR__ . '/..' . '/erusev/parsedown', ), ), ); public static $classMap = array ( 'Amp\\ByteStream\\Base64\\Base64DecodingInputStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/Base64/Base64DecodingInputStream.php', 'Amp\\ByteStream\\Base64\\Base64DecodingOutputStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/Base64/Base64DecodingOutputStream.php', 'Amp\\ByteStream\\Base64\\Base64EncodingInputStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/Base64/Base64EncodingInputStream.php', 'Amp\\ByteStream\\Base64\\Base64EncodingOutputStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/Base64/Base64EncodingOutputStream.php', 'Amp\\ByteStream\\ClosedException' => __DIR__ . '/..' . '/amphp/byte-stream/lib/ClosedException.php', 'Amp\\ByteStream\\InMemoryStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/InMemoryStream.php', 'Amp\\ByteStream\\InputStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/InputStream.php', 'Amp\\ByteStream\\InputStreamChain' => __DIR__ . '/..' . '/amphp/byte-stream/lib/InputStreamChain.php', 'Amp\\ByteStream\\IteratorStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/IteratorStream.php', 'Amp\\ByteStream\\LineReader' => __DIR__ . '/..' . '/amphp/byte-stream/lib/LineReader.php', 'Amp\\ByteStream\\Message' => __DIR__ . '/..' . '/amphp/byte-stream/lib/Message.php', 'Amp\\ByteStream\\OutputBuffer' => __DIR__ . '/..' . '/amphp/byte-stream/lib/OutputBuffer.php', 'Amp\\ByteStream\\OutputStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/OutputStream.php', 'Amp\\ByteStream\\Payload' => __DIR__ . '/..' . '/amphp/byte-stream/lib/Payload.php', 'Amp\\ByteStream\\PendingReadError' => __DIR__ . '/..' . '/amphp/byte-stream/lib/PendingReadError.php', 'Amp\\ByteStream\\ResourceInputStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/ResourceInputStream.php', 'Amp\\ByteStream\\ResourceOutputStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/ResourceOutputStream.php', 'Amp\\ByteStream\\StreamException' => __DIR__ . '/..' . '/amphp/byte-stream/lib/StreamException.php', 'Amp\\ByteStream\\ZlibInputStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/ZlibInputStream.php', 'Amp\\ByteStream\\ZlibOutputStream' => __DIR__ . '/..' . '/amphp/byte-stream/lib/ZlibOutputStream.php', 'Amp\\Cache\\ArrayCache' => __DIR__ . '/..' . '/amphp/cache/lib/ArrayCache.php', 'Amp\\Cache\\AtomicCache' => __DIR__ . '/..' . '/amphp/cache/lib/AtomicCache.php', 'Amp\\Cache\\Cache' => __DIR__ . '/..' . '/amphp/cache/lib/Cache.php', 'Amp\\Cache\\CacheException' => __DIR__ . '/..' . '/amphp/cache/lib/CacheException.php', 'Amp\\Cache\\FileCache' => __DIR__ . '/..' . '/amphp/cache/lib/FileCache.php', 'Amp\\Cache\\NullCache' => __DIR__ . '/..' . '/amphp/cache/lib/NullCache.php', 'Amp\\Cache\\PrefixCache' => __DIR__ . '/..' . '/amphp/cache/lib/PrefixCache.php', 'Amp\\Cache\\SerializedCache' => __DIR__ . '/..' . '/amphp/cache/lib/SerializedCache.php', 'Amp\\CallableMaker' => __DIR__ . '/..' . '/amphp/amp/lib/CallableMaker.php', 'Amp\\CancellationToken' => __DIR__ . '/..' . '/amphp/amp/lib/CancellationToken.php', 'Amp\\CancellationTokenSource' => __DIR__ . '/..' . '/amphp/amp/lib/CancellationTokenSource.php', 'Amp\\CancelledException' => __DIR__ . '/..' . '/amphp/amp/lib/CancelledException.php', 'Amp\\CombinedCancellationToken' => __DIR__ . '/..' . '/amphp/amp/lib/CombinedCancellationToken.php', 'Amp\\Coroutine' => __DIR__ . '/..' . '/amphp/amp/lib/Coroutine.php', 'Amp\\Deferred' => __DIR__ . '/..' . '/amphp/amp/lib/Deferred.php', 'Amp\\Delayed' => __DIR__ . '/..' . '/amphp/amp/lib/Delayed.php', 'Amp\\Dns\\BlockingFallbackResolver' => __DIR__ . '/..' . '/amphp/dns/lib/BlockingFallbackResolver.php', 'Amp\\Dns\\Config' => __DIR__ . '/..' . '/amphp/dns/lib/Config.php', 'Amp\\Dns\\ConfigException' => __DIR__ . '/..' . '/amphp/dns/lib/ConfigException.php', 'Amp\\Dns\\ConfigLoader' => __DIR__ . '/..' . '/amphp/dns/lib/ConfigLoader.php', 'Amp\\Dns\\DnsException' => __DIR__ . '/..' . '/amphp/dns/lib/DnsException.php', 'Amp\\Dns\\HostLoader' => __DIR__ . '/..' . '/amphp/dns/lib/HostLoader.php', 'Amp\\Dns\\Internal\\Socket' => __DIR__ . '/..' . '/amphp/dns/lib/Internal/Socket.php', 'Amp\\Dns\\Internal\\TcpSocket' => __DIR__ . '/..' . '/amphp/dns/lib/Internal/TcpSocket.php', 'Amp\\Dns\\Internal\\UdpSocket' => __DIR__ . '/..' . '/amphp/dns/lib/Internal/UdpSocket.php', 'Amp\\Dns\\InvalidNameException' => __DIR__ . '/..' . '/amphp/dns/lib/InvalidNameException.php', 'Amp\\Dns\\NoRecordException' => __DIR__ . '/..' . '/amphp/dns/lib/NoRecordException.php', 'Amp\\Dns\\Record' => __DIR__ . '/..' . '/amphp/dns/lib/Record.php', 'Amp\\Dns\\Resolver' => __DIR__ . '/..' . '/amphp/dns/lib/Resolver.php', 'Amp\\Dns\\Rfc1035StubResolver' => __DIR__ . '/..' . '/amphp/dns/lib/Rfc1035StubResolver.php', 'Amp\\Dns\\TimeoutException' => __DIR__ . '/..' . '/amphp/dns/lib/TimeoutException.php', 'Amp\\Dns\\UnixConfigLoader' => __DIR__ . '/..' . '/amphp/dns/lib/UnixConfigLoader.php', 'Amp\\Dns\\WindowsConfigLoader' => __DIR__ . '/..' . '/amphp/dns/lib/WindowsConfigLoader.php', 'Amp\\DoH\\DoHConfig' => __DIR__ . '/..' . '/danog/dns-over-https/lib/DoHConfig.php', 'Amp\\DoH\\DoHException' => __DIR__ . '/..' . '/danog/dns-over-https/lib/DoHException.php', 'Amp\\DoH\\Internal\\HttpsSocket' => __DIR__ . '/..' . '/danog/dns-over-https/lib/Internal/HttpsSocket.php', 'Amp\\DoH\\Internal\\Socket' => __DIR__ . '/..' . '/danog/dns-over-https/lib/Internal/Socket.php', 'Amp\\DoH\\Nameserver' => __DIR__ . '/..' . '/danog/dns-over-https/lib/Nameserver.php', 'Amp\\DoH\\Rfc8484StubResolver' => __DIR__ . '/..' . '/danog/dns-over-https/lib/Rfc8484StubResolver.php', 'Amp\\Emitter' => __DIR__ . '/..' . '/amphp/amp/lib/Emitter.php', 'Amp\\Failure' => __DIR__ . '/..' . '/amphp/amp/lib/Failure.php', 'Amp\\File\\Driver' => __DIR__ . '/..' . '/amphp/file/src/Driver.php', 'Amp\\File\\Driver\\BlockingDriver' => __DIR__ . '/..' . '/amphp/file/src/Driver/BlockingDriver.php', 'Amp\\File\\Driver\\BlockingFile' => __DIR__ . '/..' . '/amphp/file/src/Driver/BlockingFile.php', 'Amp\\File\\Driver\\EioDriver' => __DIR__ . '/..' . '/amphp/file/src/Driver/EioDriver.php', 'Amp\\File\\Driver\\EioFile' => __DIR__ . '/..' . '/amphp/file/src/Driver/EioFile.php', 'Amp\\File\\Driver\\ParallelDriver' => __DIR__ . '/..' . '/amphp/file/src/Driver/ParallelDriver.php', 'Amp\\File\\Driver\\ParallelFile' => __DIR__ . '/..' . '/amphp/file/src/Driver/ParallelFile.php', 'Amp\\File\\Driver\\StatusCachingDriver' => __DIR__ . '/..' . '/amphp/file/src/Driver/StatusCachingDriver.php', 'Amp\\File\\Driver\\StatusCachingFile' => __DIR__ . '/..' . '/amphp/file/src/Driver/StatusCachingFile.php', 'Amp\\File\\Driver\\UvDriver' => __DIR__ . '/..' . '/amphp/file/src/Driver/UvDriver.php', 'Amp\\File\\Driver\\UvFile' => __DIR__ . '/..' . '/amphp/file/src/Driver/UvFile.php', 'Amp\\File\\File' => __DIR__ . '/..' . '/amphp/file/src/File.php', 'Amp\\File\\Filesystem' => __DIR__ . '/..' . '/amphp/file/src/Filesystem.php', 'Amp\\File\\FilesystemException' => __DIR__ . '/..' . '/amphp/file/src/FilesystemException.php', 'Amp\\File\\Internal\\Cache' => __DIR__ . '/..' . '/amphp/file/src/Internal/Cache.php', 'Amp\\File\\Internal\\EioPoll' => __DIR__ . '/..' . '/amphp/file/src/Internal/EioPoll.php', 'Amp\\File\\Internal\\FileTask' => __DIR__ . '/..' . '/amphp/file/src/Internal/FileTask.php', 'Amp\\File\\Internal\\UvPoll' => __DIR__ . '/..' . '/amphp/file/src/Internal/UvPoll.php', 'Amp\\File\\PendingOperationError' => __DIR__ . '/..' . '/amphp/file/src/PendingOperationError.php', 'Amp\\File\\Sync\\AsyncFileMutex' => __DIR__ . '/..' . '/amphp/file/src/Sync/AsyncFileMutex.php', 'Amp\\Http\\Client\\ApplicationInterceptor' => __DIR__ . '/..' . '/amphp/http-client/src/ApplicationInterceptor.php', 'Amp\\Http\\Client\\Body\\FileBody' => __DIR__ . '/..' . '/amphp/http-client/src/Body/FileBody.php', 'Amp\\Http\\Client\\Body\\FormBody' => __DIR__ . '/..' . '/amphp/http-client/src/Body/FormBody.php', 'Amp\\Http\\Client\\Body\\JsonBody' => __DIR__ . '/..' . '/amphp/http-client/src/Body/JsonBody.php', 'Amp\\Http\\Client\\Body\\StringBody' => __DIR__ . '/..' . '/amphp/http-client/src/Body/StringBody.php', 'Amp\\Http\\Client\\Connection\\Connection' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/Connection.php', 'Amp\\Http\\Client\\Connection\\ConnectionFactory' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/ConnectionFactory.php', 'Amp\\Http\\Client\\Connection\\ConnectionLimitingPool' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/ConnectionLimitingPool.php', 'Amp\\Http\\Client\\Connection\\ConnectionPool' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/ConnectionPool.php', 'Amp\\Http\\Client\\Connection\\DefaultConnectionFactory' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/DefaultConnectionFactory.php', 'Amp\\Http\\Client\\Connection\\Http1Connection' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/Http1Connection.php', 'Amp\\Http\\Client\\Connection\\Http2Connection' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/Http2Connection.php', 'Amp\\Http\\Client\\Connection\\Http2ConnectionException' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/Http2ConnectionException.php', 'Amp\\Http\\Client\\Connection\\Http2StreamException' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/Http2StreamException.php', 'Amp\\Http\\Client\\Connection\\HttpStream' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/HttpStream.php', 'Amp\\Http\\Client\\Connection\\InterceptedStream' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/InterceptedStream.php', 'Amp\\Http\\Client\\Connection\\Internal\\Http1Parser' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/Internal/Http1Parser.php', 'Amp\\Http\\Client\\Connection\\Internal\\Http2ConnectionProcessor' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/Internal/Http2ConnectionProcessor.php', 'Amp\\Http\\Client\\Connection\\Internal\\Http2Stream' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/Internal/Http2Stream.php', 'Amp\\Http\\Client\\Connection\\Internal\\RequestNormalizer' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/Internal/RequestNormalizer.php', 'Amp\\Http\\Client\\Connection\\Stream' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/Stream.php', 'Amp\\Http\\Client\\Connection\\StreamLimitingPool' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/StreamLimitingPool.php', 'Amp\\Http\\Client\\Connection\\UnlimitedConnectionPool' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/UnlimitedConnectionPool.php', 'Amp\\Http\\Client\\Connection\\UnprocessedRequestException' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/UnprocessedRequestException.php', 'Amp\\Http\\Client\\Connection\\UpgradedSocket' => __DIR__ . '/..' . '/amphp/http-client/src/Connection/UpgradedSocket.php', 'Amp\\Http\\Client\\Cookie\\CookieInterceptor' => __DIR__ . '/..' . '/amphp/http-client-cookies/src/CookieInterceptor.php', 'Amp\\Http\\Client\\Cookie\\CookieJar' => __DIR__ . '/..' . '/amphp/http-client-cookies/src/CookieJar.php', 'Amp\\Http\\Client\\Cookie\\FileCookieJar' => __DIR__ . '/..' . '/amphp/http-client-cookies/src/FileCookieJar.php', 'Amp\\Http\\Client\\Cookie\\InMemoryCookieJar' => __DIR__ . '/..' . '/amphp/http-client-cookies/src/InMemoryCookieJar.php', 'Amp\\Http\\Client\\Cookie\\Internal\\PublicSuffixList' => __DIR__ . '/..' . '/amphp/http-client-cookies/src/Internal/PublicSuffixList.php', 'Amp\\Http\\Client\\Cookie\\NullCookieJar' => __DIR__ . '/..' . '/amphp/http-client-cookies/src/NullCookieJar.php', 'Amp\\Http\\Client\\DelegateHttpClient' => __DIR__ . '/..' . '/amphp/http-client/src/DelegateHttpClient.php', 'Amp\\Http\\Client\\EventListener' => __DIR__ . '/..' . '/amphp/http-client/src/EventListener.php', 'Amp\\Http\\Client\\EventListener\\RecordHarAttributes' => __DIR__ . '/..' . '/amphp/http-client/src/EventListener/RecordHarAttributes.php', 'Amp\\Http\\Client\\HttpClient' => __DIR__ . '/..' . '/amphp/http-client/src/HttpClient.php', 'Amp\\Http\\Client\\HttpClientBuilder' => __DIR__ . '/..' . '/amphp/http-client/src/HttpClientBuilder.php', 'Amp\\Http\\Client\\HttpException' => __DIR__ . '/..' . '/amphp/http-client/src/HttpException.php', 'Amp\\Http\\Client\\InterceptedHttpClient' => __DIR__ . '/..' . '/amphp/http-client/src/InterceptedHttpClient.php', 'Amp\\Http\\Client\\Interceptor\\AddRequestHeader' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/AddRequestHeader.php', 'Amp\\Http\\Client\\Interceptor\\AddResponseHeader' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/AddResponseHeader.php', 'Amp\\Http\\Client\\Interceptor\\DecompressResponse' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/DecompressResponse.php', 'Amp\\Http\\Client\\Interceptor\\FollowRedirects' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/FollowRedirects.php', 'Amp\\Http\\Client\\Interceptor\\ForbidUriUserInfo' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/ForbidUriUserInfo.php', 'Amp\\Http\\Client\\Interceptor\\LogHttpArchive' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/LogHttpArchive.php', 'Amp\\Http\\Client\\Interceptor\\MatchOrigin' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/MatchOrigin.php', 'Amp\\Http\\Client\\Interceptor\\ModifyRequest' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/ModifyRequest.php', 'Amp\\Http\\Client\\Interceptor\\ModifyResponse' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/ModifyResponse.php', 'Amp\\Http\\Client\\Interceptor\\RemoveRequestHeader' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/RemoveRequestHeader.php', 'Amp\\Http\\Client\\Interceptor\\RemoveResponseHeader' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/RemoveResponseHeader.php', 'Amp\\Http\\Client\\Interceptor\\RetryRequests' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/RetryRequests.php', 'Amp\\Http\\Client\\Interceptor\\SetRequestHeader' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/SetRequestHeader.php', 'Amp\\Http\\Client\\Interceptor\\SetRequestHeaderIfUnset' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/SetRequestHeaderIfUnset.php', 'Amp\\Http\\Client\\Interceptor\\SetRequestTimeout' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/SetRequestTimeout.php', 'Amp\\Http\\Client\\Interceptor\\SetResponseHeader' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/SetResponseHeader.php', 'Amp\\Http\\Client\\Interceptor\\SetResponseHeaderIfUnset' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/SetResponseHeaderIfUnset.php', 'Amp\\Http\\Client\\Interceptor\\TooManyRedirectsException' => __DIR__ . '/..' . '/amphp/http-client/src/Interceptor/TooManyRedirectsException.php', 'Amp\\Http\\Client\\Internal\\ForbidCloning' => __DIR__ . '/..' . '/amphp/http-client/src/Internal/ForbidCloning.php', 'Amp\\Http\\Client\\Internal\\ForbidSerialization' => __DIR__ . '/..' . '/amphp/http-client/src/Internal/ForbidSerialization.php', 'Amp\\Http\\Client\\Internal\\HarAttributes' => __DIR__ . '/..' . '/amphp/http-client/src/Internal/HarAttributes.php', 'Amp\\Http\\Client\\Internal\\ResponseBodyStream' => __DIR__ . '/..' . '/amphp/http-client/src/Internal/ResponseBodyStream.php', 'Amp\\Http\\Client\\Internal\\SizeLimitingInputStream' => __DIR__ . '/..' . '/amphp/http-client/src/Internal/SizeLimitingInputStream.php', 'Amp\\Http\\Client\\InvalidRequestException' => __DIR__ . '/..' . '/amphp/http-client/src/InvalidRequestException.php', 'Amp\\Http\\Client\\MissingAttributeError' => __DIR__ . '/..' . '/amphp/http-client/src/MissingAttributeError.php', 'Amp\\Http\\Client\\NetworkInterceptor' => __DIR__ . '/..' . '/amphp/http-client/src/NetworkInterceptor.php', 'Amp\\Http\\Client\\ParseException' => __DIR__ . '/..' . '/amphp/http-client/src/ParseException.php', 'Amp\\Http\\Client\\PooledHttpClient' => __DIR__ . '/..' . '/amphp/http-client/src/PooledHttpClient.php', 'Amp\\Http\\Client\\Request' => __DIR__ . '/..' . '/amphp/http-client/src/Request.php', 'Amp\\Http\\Client\\RequestBody' => __DIR__ . '/..' . '/amphp/http-client/src/RequestBody.php', 'Amp\\Http\\Client\\Response' => __DIR__ . '/..' . '/amphp/http-client/src/Response.php', 'Amp\\Http\\Client\\SocketException' => __DIR__ . '/..' . '/amphp/http-client/src/SocketException.php', 'Amp\\Http\\Client\\TimeoutException' => __DIR__ . '/..' . '/amphp/http-client/src/TimeoutException.php', 'Amp\\Http\\Client\\Trailers' => __DIR__ . '/..' . '/amphp/http-client/src/Trailers.php', 'Amp\\Http\\Cookie\\CookieAttributes' => __DIR__ . '/..' . '/amphp/http/src/Cookie/CookieAttributes.php', 'Amp\\Http\\Cookie\\InvalidCookieException' => __DIR__ . '/..' . '/amphp/http/src/Cookie/InvalidCookieException.php', 'Amp\\Http\\Cookie\\RequestCookie' => __DIR__ . '/..' . '/amphp/http/src/Cookie/RequestCookie.php', 'Amp\\Http\\Cookie\\ResponseCookie' => __DIR__ . '/..' . '/amphp/http/src/Cookie/ResponseCookie.php', 'Amp\\Http\\HPack' => __DIR__ . '/..' . '/amphp/hpack/src/HPack.php', 'Amp\\Http\\HPackException' => __DIR__ . '/..' . '/amphp/hpack/src/HPackException.php', 'Amp\\Http\\Http2\\Http2ConnectionException' => __DIR__ . '/..' . '/amphp/http/src/Http2/Http2ConnectionException.php', 'Amp\\Http\\Http2\\Http2Parser' => __DIR__ . '/..' . '/amphp/http/src/Http2/Http2Parser.php', 'Amp\\Http\\Http2\\Http2Processor' => __DIR__ . '/..' . '/amphp/http/src/Http2/Http2Processor.php', 'Amp\\Http\\Http2\\Http2StreamException' => __DIR__ . '/..' . '/amphp/http/src/Http2/Http2StreamException.php', 'Amp\\Http\\Internal\\HPackNative' => __DIR__ . '/..' . '/amphp/hpack/src/Internal/HPackNative.php', 'Amp\\Http\\Internal\\HPackNghttp2' => __DIR__ . '/..' . '/amphp/hpack/src/Internal/HPackNghttp2.php', 'Amp\\Http\\InvalidHeaderException' => __DIR__ . '/..' . '/amphp/http/src/InvalidHeaderException.php', 'Amp\\Http\\Message' => __DIR__ . '/..' . '/amphp/http/src/Message.php', 'Amp\\Http\\Rfc7230' => __DIR__ . '/..' . '/amphp/http/src/Rfc7230.php', 'Amp\\Http\\Status' => __DIR__ . '/..' . '/amphp/http/src/Status.php', 'Amp\\Internal\\Placeholder' => __DIR__ . '/..' . '/amphp/amp/lib/Internal/Placeholder.php', 'Amp\\Internal\\PrivateIterator' => __DIR__ . '/..' . '/amphp/amp/lib/Internal/PrivateIterator.php', 'Amp\\Internal\\PrivatePromise' => __DIR__ . '/..' . '/amphp/amp/lib/Internal/PrivatePromise.php', 'Amp\\Internal\\Producer' => __DIR__ . '/..' . '/amphp/amp/lib/Internal/Producer.php', 'Amp\\Internal\\ResolutionQueue' => __DIR__ . '/..' . '/amphp/amp/lib/Internal/ResolutionQueue.php', 'Amp\\InvalidYieldError' => __DIR__ . '/..' . '/amphp/amp/lib/InvalidYieldError.php', 'Amp\\Ipc\\IpcServer' => __DIR__ . '/..' . '/danog/ipc/lib/IpcServer.php', 'Amp\\Ipc\\IpcServerException' => __DIR__ . '/..' . '/danog/ipc/lib/IpcServerException.php', 'Amp\\Ipc\\PendingAcceptError' => __DIR__ . '/..' . '/danog/ipc/lib/PendingAcceptError.php', 'Amp\\Ipc\\Sync\\Channel' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/Channel.php', 'Amp\\Ipc\\Sync\\ChannelCloseAck' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/ChannelCloseAck.php', 'Amp\\Ipc\\Sync\\ChannelCloseMsg' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/ChannelCloseMsg.php', 'Amp\\Ipc\\Sync\\ChannelCloseReq' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/ChannelCloseReq.php', 'Amp\\Ipc\\Sync\\ChannelException' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/ChannelException.php', 'Amp\\Ipc\\Sync\\ChannelParser' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/ChannelParser.php', 'Amp\\Ipc\\Sync\\ChannelledSocket' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/ChannelledSocket.php', 'Amp\\Ipc\\Sync\\ChannelledStream' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/ChannelledStream.php', 'Amp\\Ipc\\Sync\\PanicError' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/PanicError.php', 'Amp\\Ipc\\Sync\\Parcel' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/Parcel.php', 'Amp\\Ipc\\Sync\\SerializationException' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/SerializationException.php', 'Amp\\Ipc\\Sync\\SynchronizationError' => __DIR__ . '/..' . '/danog/ipc/lib/Sync/SynchronizationError.php', 'Amp\\Iterator' => __DIR__ . '/..' . '/amphp/amp/lib/Iterator.php', 'Amp\\LazyPromise' => __DIR__ . '/..' . '/amphp/amp/lib/LazyPromise.php', 'Amp\\Log\\ConsoleFormatter' => __DIR__ . '/..' . '/amphp/log/src/ConsoleFormatter.php', 'Amp\\Log\\StreamHandler' => __DIR__ . '/..' . '/amphp/log/src/StreamHandler.php', 'Amp\\Loop' => __DIR__ . '/..' . '/amphp/amp/lib/Loop.php', 'Amp\\Loop\\Driver' => __DIR__ . '/..' . '/amphp/amp/lib/Loop/Driver.php', 'Amp\\Loop\\DriverFactory' => __DIR__ . '/..' . '/amphp/amp/lib/Loop/DriverFactory.php', 'Amp\\Loop\\EvDriver' => __DIR__ . '/..' . '/amphp/amp/lib/Loop/EvDriver.php', 'Amp\\Loop\\EventDriver' => __DIR__ . '/..' . '/amphp/amp/lib/Loop/EventDriver.php', 'Amp\\Loop\\Internal\\TimerQueue' => __DIR__ . '/..' . '/amphp/amp/lib/Loop/Internal/TimerQueue.php', 'Amp\\Loop\\InvalidWatcherError' => __DIR__ . '/..' . '/amphp/amp/lib/Loop/InvalidWatcherError.php', 'Amp\\Loop\\NativeDriver' => __DIR__ . '/..' . '/amphp/amp/lib/Loop/NativeDriver.php', 'Amp\\Loop\\TracingDriver' => __DIR__ . '/..' . '/amphp/amp/lib/Loop/TracingDriver.php', 'Amp\\Loop\\UnsupportedFeatureException' => __DIR__ . '/..' . '/amphp/amp/lib/Loop/UnsupportedFeatureException.php', 'Amp\\Loop\\UvDriver' => __DIR__ . '/..' . '/amphp/amp/lib/Loop/UvDriver.php', 'Amp\\Loop\\Watcher' => __DIR__ . '/..' . '/amphp/amp/lib/Loop/Watcher.php', 'Amp\\MultiReasonException' => __DIR__ . '/..' . '/amphp/amp/lib/MultiReasonException.php', 'Amp\\Mysql\\CancellableConnector' => __DIR__ . '/..' . '/amphp/mysql/src/CancellableConnector.php', 'Amp\\Mysql\\CommandResult' => __DIR__ . '/..' . '/amphp/mysql/src/CommandResult.php', 'Amp\\Mysql\\Connection' => __DIR__ . '/..' . '/amphp/mysql/src/Connection.php', 'Amp\\Mysql\\ConnectionConfig' => __DIR__ . '/..' . '/amphp/mysql/src/ConnectionConfig.php', 'Amp\\Mysql\\ConnectionResultSet' => __DIR__ . '/..' . '/amphp/mysql/src/ConnectionResultSet.php', 'Amp\\Mysql\\ConnectionStatement' => __DIR__ . '/..' . '/amphp/mysql/src/ConnectionStatement.php', 'Amp\\Mysql\\ConnectionTransaction' => __DIR__ . '/..' . '/amphp/mysql/src/ConnectionTransaction.php', 'Amp\\Mysql\\DataTypes' => __DIR__ . '/..' . '/amphp/mysql/src/DataTypes.php', 'Amp\\Mysql\\InitializationException' => __DIR__ . '/..' . '/amphp/mysql/src/InitializationException.php', 'Amp\\Mysql\\Internal\\ConnectionState' => __DIR__ . '/..' . '/amphp/mysql/src/Internal/ConnectionState.php', 'Amp\\Mysql\\Internal\\Processor' => __DIR__ . '/..' . '/amphp/mysql/src/Internal/Processor.php', 'Amp\\Mysql\\Internal\\ResultProxy' => __DIR__ . '/..' . '/amphp/mysql/src/Internal/ResultProxy.php', 'Amp\\Mysql\\Pool' => __DIR__ . '/..' . '/amphp/mysql/src/Pool.php', 'Amp\\Mysql\\PooledResultSet' => __DIR__ . '/..' . '/amphp/mysql/src/PooledResultSet.php', 'Amp\\Mysql\\PooledStatement' => __DIR__ . '/..' . '/amphp/mysql/src/PooledStatement.php', 'Amp\\Mysql\\PooledTransaction' => __DIR__ . '/..' . '/amphp/mysql/src/PooledTransaction.php', 'Amp\\Mysql\\RefreshTypes' => __DIR__ . '/..' . '/amphp/mysql/src/RefreshTypes.php', 'Amp\\Mysql\\ResultSet' => __DIR__ . '/..' . '/amphp/mysql/src/ResultSet.php', 'Amp\\Mysql\\Statement' => __DIR__ . '/..' . '/amphp/mysql/src/Statement.php', 'Amp\\Mysql\\StatementPool' => __DIR__ . '/..' . '/amphp/mysql/src/StatementPool.php', 'Amp\\Mysql\\TransactionError' => __DIR__ . '/..' . '/amphp/mysql/src/TransactionError.php', 'Amp\\NullCancellationToken' => __DIR__ . '/..' . '/amphp/amp/lib/NullCancellationToken.php', 'Amp\\Parallel\\Context\\Context' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/Context.php', 'Amp\\Parallel\\Context\\ContextException' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/ContextException.php', 'Amp\\Parallel\\Context\\ContextFactory' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/ContextFactory.php', 'Amp\\Parallel\\Context\\DefaultContextFactory' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/DefaultContextFactory.php', 'Amp\\Parallel\\Context\\Internal\\ParallelHub' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/Internal/ParallelHub.php', 'Amp\\Parallel\\Context\\Internal\\ProcessHub' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/Internal/ProcessHub.php', 'Amp\\Parallel\\Context\\Internal\\Thread' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/Internal/Thread.php', 'Amp\\Parallel\\Context\\Parallel' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/Parallel.php', 'Amp\\Parallel\\Context\\Process' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/Process.php', 'Amp\\Parallel\\Context\\StatusError' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/StatusError.php', 'Amp\\Parallel\\Context\\Thread' => __DIR__ . '/..' . '/amphp/parallel/lib/Context/Thread.php', 'Amp\\Parallel\\Sync\\Channel' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/Channel.php', 'Amp\\Parallel\\Sync\\ChannelException' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/ChannelException.php', 'Amp\\Parallel\\Sync\\ChannelParser' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/ChannelParser.php', 'Amp\\Parallel\\Sync\\ChannelledSocket' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/ChannelledSocket.php', 'Amp\\Parallel\\Sync\\ChannelledStream' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/ChannelledStream.php', 'Amp\\Parallel\\Sync\\ContextPanicError' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/ContextPanicError.php', 'Amp\\Parallel\\Sync\\ExitFailure' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/ExitFailure.php', 'Amp\\Parallel\\Sync\\ExitResult' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/ExitResult.php', 'Amp\\Parallel\\Sync\\ExitSuccess' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/ExitSuccess.php', 'Amp\\Parallel\\Sync\\Internal\\ParcelStorage' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/Internal/ParcelStorage.php', 'Amp\\Parallel\\Sync\\PanicError' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/PanicError.php', 'Amp\\Parallel\\Sync\\Parcel' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/Parcel.php', 'Amp\\Parallel\\Sync\\ParcelException' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/ParcelException.php', 'Amp\\Parallel\\Sync\\SharedMemoryException' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/SharedMemoryException.php', 'Amp\\Parallel\\Sync\\SharedMemoryParcel' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/SharedMemoryParcel.php', 'Amp\\Parallel\\Sync\\SynchronizationError' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/SynchronizationError.php', 'Amp\\Parallel\\Sync\\ThreadedParcel' => __DIR__ . '/..' . '/amphp/parallel/lib/Sync/ThreadedParcel.php', 'Amp\\Parallel\\Worker\\BasicEnvironment' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/BasicEnvironment.php', 'Amp\\Parallel\\Worker\\BootstrapWorkerFactory' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/BootstrapWorkerFactory.php', 'Amp\\Parallel\\Worker\\CallableTask' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/CallableTask.php', 'Amp\\Parallel\\Worker\\DefaultPool' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/DefaultPool.php', 'Amp\\Parallel\\Worker\\DefaultWorkerFactory' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/DefaultWorkerFactory.php', 'Amp\\Parallel\\Worker\\Environment' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/Environment.php', 'Amp\\Parallel\\Worker\\Internal\\Job' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/Internal/Job.php', 'Amp\\Parallel\\Worker\\Internal\\PooledWorker' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/Internal/PooledWorker.php', 'Amp\\Parallel\\Worker\\Internal\\TaskFailure' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/Internal/TaskFailure.php', 'Amp\\Parallel\\Worker\\Internal\\TaskResult' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/Internal/TaskResult.php', 'Amp\\Parallel\\Worker\\Internal\\TaskSuccess' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/Internal/TaskSuccess.php', 'Amp\\Parallel\\Worker\\Internal\\WorkerProcess' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/Internal/WorkerProcess.php', 'Amp\\Parallel\\Worker\\Pool' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/Pool.php', 'Amp\\Parallel\\Worker\\Task' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/Task.php', 'Amp\\Parallel\\Worker\\TaskError' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/TaskError.php', 'Amp\\Parallel\\Worker\\TaskException' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/TaskException.php', 'Amp\\Parallel\\Worker\\TaskFailureError' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/TaskFailureError.php', 'Amp\\Parallel\\Worker\\TaskFailureException' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/TaskFailureException.php', 'Amp\\Parallel\\Worker\\TaskFailureThrowable' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/TaskFailureThrowable.php', 'Amp\\Parallel\\Worker\\TaskRunner' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/TaskRunner.php', 'Amp\\Parallel\\Worker\\TaskWorker' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/TaskWorker.php', 'Amp\\Parallel\\Worker\\Worker' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/Worker.php', 'Amp\\Parallel\\Worker\\WorkerException' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/WorkerException.php', 'Amp\\Parallel\\Worker\\WorkerFactory' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/WorkerFactory.php', 'Amp\\Parallel\\Worker\\WorkerParallel' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/WorkerParallel.php', 'Amp\\Parallel\\Worker\\WorkerProcess' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/WorkerProcess.php', 'Amp\\Parallel\\Worker\\WorkerThread' => __DIR__ . '/..' . '/amphp/parallel/lib/Worker/WorkerThread.php', 'Amp\\Parser\\InvalidDelimiterError' => __DIR__ . '/..' . '/amphp/parser/src/InvalidDelimiterError.php', 'Amp\\Parser\\Parser' => __DIR__ . '/..' . '/amphp/parser/src/Parser.php', 'Amp\\Postgres\\Connection' => __DIR__ . '/..' . '/amphp/postgres/src/Connection.php', 'Amp\\Postgres\\ConnectionConfig' => __DIR__ . '/..' . '/amphp/postgres/src/ConnectionConfig.php', 'Amp\\Postgres\\ConnectionListener' => __DIR__ . '/..' . '/amphp/postgres/src/ConnectionListener.php', 'Amp\\Postgres\\ConnectionTransaction' => __DIR__ . '/..' . '/amphp/postgres/src/ConnectionTransaction.php', 'Amp\\Postgres\\Executor' => __DIR__ . '/..' . '/amphp/postgres/src/Executor.php', 'Amp\\Postgres\\Handle' => __DIR__ . '/..' . '/amphp/postgres/src/Handle.php', 'Amp\\Postgres\\Internal\\ArrayParser' => __DIR__ . '/..' . '/amphp/postgres/src/Internal/ArrayParser.php', 'Amp\\Postgres\\Link' => __DIR__ . '/..' . '/amphp/postgres/src/Link.php', 'Amp\\Postgres\\Listener' => __DIR__ . '/..' . '/amphp/postgres/src/Listener.php', 'Amp\\Postgres\\Notification' => __DIR__ . '/..' . '/amphp/postgres/src/Notification.php', 'Amp\\Postgres\\ParseException' => __DIR__ . '/..' . '/amphp/postgres/src/ParseException.php', 'Amp\\Postgres\\PgSqlCommandResult' => __DIR__ . '/..' . '/amphp/postgres/src/PgSqlCommandResult.php', 'Amp\\Postgres\\PgSqlConnection' => __DIR__ . '/..' . '/amphp/postgres/src/PgSqlConnection.php', 'Amp\\Postgres\\PgSqlHandle' => __DIR__ . '/..' . '/amphp/postgres/src/PgSqlHandle.php', 'Amp\\Postgres\\PgSqlResultSet' => __DIR__ . '/..' . '/amphp/postgres/src/PgSqlResultSet.php', 'Amp\\Postgres\\PgSqlStatement' => __DIR__ . '/..' . '/amphp/postgres/src/PgSqlStatement.php', 'Amp\\Postgres\\Pool' => __DIR__ . '/..' . '/amphp/postgres/src/Pool.php', 'Amp\\Postgres\\PooledListener' => __DIR__ . '/..' . '/amphp/postgres/src/PooledListener.php', 'Amp\\Postgres\\PooledResultSet' => __DIR__ . '/..' . '/amphp/postgres/src/PooledResultSet.php', 'Amp\\Postgres\\PooledStatement' => __DIR__ . '/..' . '/amphp/postgres/src/PooledStatement.php', 'Amp\\Postgres\\PooledTransaction' => __DIR__ . '/..' . '/amphp/postgres/src/PooledTransaction.php', 'Amp\\Postgres\\PqBufferedResultSet' => __DIR__ . '/..' . '/amphp/postgres/src/PqBufferedResultSet.php', 'Amp\\Postgres\\PqCommandResult' => __DIR__ . '/..' . '/amphp/postgres/src/PqCommandResult.php', 'Amp\\Postgres\\PqConnection' => __DIR__ . '/..' . '/amphp/postgres/src/PqConnection.php', 'Amp\\Postgres\\PqHandle' => __DIR__ . '/..' . '/amphp/postgres/src/PqHandle.php', 'Amp\\Postgres\\PqStatement' => __DIR__ . '/..' . '/amphp/postgres/src/PqStatement.php', 'Amp\\Postgres\\PqUnbufferedResultSet' => __DIR__ . '/..' . '/amphp/postgres/src/PqUnbufferedResultSet.php', 'Amp\\Postgres\\QueryExecutionError' => __DIR__ . '/..' . '/amphp/postgres/src/QueryExecutionError.php', 'Amp\\Postgres\\Quoter' => __DIR__ . '/..' . '/amphp/postgres/src/Quoter.php', 'Amp\\Postgres\\Receiver' => __DIR__ . '/..' . '/amphp/postgres/src/Receiver.php', 'Amp\\Postgres\\ResultSet' => __DIR__ . '/..' . '/amphp/postgres/src/ResultSet.php', 'Amp\\Postgres\\StatementPool' => __DIR__ . '/..' . '/amphp/postgres/src/StatementPool.php', 'Amp\\Postgres\\TimeoutConnector' => __DIR__ . '/..' . '/amphp/postgres/src/TimeoutConnector.php', 'Amp\\Postgres\\Transaction' => __DIR__ . '/..' . '/amphp/postgres/src/Transaction.php', 'Amp\\Process\\Internal\\Posix\\Handle' => __DIR__ . '/..' . '/amphp/process/lib/Internal/Posix/Handle.php', 'Amp\\Process\\Internal\\Posix\\Runner' => __DIR__ . '/..' . '/amphp/process/lib/Internal/Posix/Runner.php', 'Amp\\Process\\Internal\\ProcessHandle' => __DIR__ . '/..' . '/amphp/process/lib/Internal/ProcessHandle.php', 'Amp\\Process\\Internal\\ProcessRunner' => __DIR__ . '/..' . '/amphp/process/lib/Internal/ProcessRunner.php', 'Amp\\Process\\Internal\\ProcessStatus' => __DIR__ . '/..' . '/amphp/process/lib/Internal/ProcessStatus.php', 'Amp\\Process\\Internal\\Windows\\Handle' => __DIR__ . '/..' . '/amphp/process/lib/Internal/Windows/Handle.php', 'Amp\\Process\\Internal\\Windows\\HandshakeStatus' => __DIR__ . '/..' . '/amphp/process/lib/Internal/Windows/HandshakeStatus.php', 'Amp\\Process\\Internal\\Windows\\PendingSocketClient' => __DIR__ . '/..' . '/amphp/process/lib/Internal/Windows/PendingSocketClient.php', 'Amp\\Process\\Internal\\Windows\\Runner' => __DIR__ . '/..' . '/amphp/process/lib/Internal/Windows/Runner.php', 'Amp\\Process\\Internal\\Windows\\SignalCode' => __DIR__ . '/..' . '/amphp/process/lib/Internal/Windows/SignalCode.php', 'Amp\\Process\\Internal\\Windows\\SocketConnector' => __DIR__ . '/..' . '/amphp/process/lib/Internal/Windows/SocketConnector.php', 'Amp\\Process\\Process' => __DIR__ . '/..' . '/amphp/process/lib/Process.php', 'Amp\\Process\\ProcessException' => __DIR__ . '/..' . '/amphp/process/lib/ProcessException.php', 'Amp\\Process\\ProcessInputStream' => __DIR__ . '/..' . '/amphp/process/lib/ProcessInputStream.php', 'Amp\\Process\\ProcessOutputStream' => __DIR__ . '/..' . '/amphp/process/lib/ProcessOutputStream.php', 'Amp\\Process\\StatusError' => __DIR__ . '/..' . '/amphp/process/lib/StatusError.php', 'Amp\\Producer' => __DIR__ . '/..' . '/amphp/amp/lib/Producer.php', 'Amp\\Promise' => __DIR__ . '/..' . '/amphp/amp/lib/Promise.php', 'Amp\\Redis\\Cache' => __DIR__ . '/..' . '/amphp/redis/src/Cache.php', 'Amp\\Redis\\Config' => __DIR__ . '/..' . '/amphp/redis/src/Config.php', 'Amp\\Redis\\Mutex\\ConnectionLimitException' => __DIR__ . '/..' . '/amphp/redis/src/Mutex/ConnectionLimitException.php', 'Amp\\Redis\\Mutex\\LockException' => __DIR__ . '/..' . '/amphp/redis/src/Mutex/LockException.php', 'Amp\\Redis\\Mutex\\Mutex' => __DIR__ . '/..' . '/amphp/redis/src/Mutex/Mutex.php', 'Amp\\Redis\\Mutex\\MutexException' => __DIR__ . '/..' . '/amphp/redis/src/Mutex/MutexException.php', 'Amp\\Redis\\Mutex\\MutexOptions' => __DIR__ . '/..' . '/amphp/redis/src/Mutex/MutexOptions.php', 'Amp\\Redis\\ParserException' => __DIR__ . '/..' . '/amphp/redis/src/ParserException.php', 'Amp\\Redis\\QueryException' => __DIR__ . '/..' . '/amphp/redis/src/QueryException.php', 'Amp\\Redis\\QueryExecutor' => __DIR__ . '/..' . '/amphp/redis/src/QueryExecutor.php', 'Amp\\Redis\\QueryExecutorFactory' => __DIR__ . '/..' . '/amphp/redis/src/QueryExecutorFactory.php', 'Amp\\Redis\\Redis' => __DIR__ . '/..' . '/amphp/redis/src/Redis.php', 'Amp\\Redis\\RedisException' => __DIR__ . '/..' . '/amphp/redis/src/RedisException.php', 'Amp\\Redis\\RedisHyperLogLog' => __DIR__ . '/..' . '/amphp/redis/src/RedisHyperLogLog.php', 'Amp\\Redis\\RedisList' => __DIR__ . '/..' . '/amphp/redis/src/RedisList.php', 'Amp\\Redis\\RedisMap' => __DIR__ . '/..' . '/amphp/redis/src/RedisMap.php', 'Amp\\Redis\\RedisSet' => __DIR__ . '/..' . '/amphp/redis/src/RedisSet.php', 'Amp\\Redis\\RedisSortedSet' => __DIR__ . '/..' . '/amphp/redis/src/RedisSortedSet.php', 'Amp\\Redis\\RemoteExecutor' => __DIR__ . '/..' . '/amphp/redis/src/RemoteExecutor.php', 'Amp\\Redis\\RemoteExecutorFactory' => __DIR__ . '/..' . '/amphp/redis/src/RemoteExecutorFactory.php', 'Amp\\Redis\\RespParser' => __DIR__ . '/..' . '/amphp/redis/src/RespParser.php', 'Amp\\Redis\\RespSocket' => __DIR__ . '/..' . '/amphp/redis/src/RespSocket.php', 'Amp\\Redis\\SetOptions' => __DIR__ . '/..' . '/amphp/redis/src/SetOptions.php', 'Amp\\Redis\\SocketException' => __DIR__ . '/..' . '/amphp/redis/src/SocketException.php', 'Amp\\Redis\\SortOptions' => __DIR__ . '/..' . '/amphp/redis/src/SortOptions.php', 'Amp\\Redis\\Subscriber' => __DIR__ . '/..' . '/amphp/redis/src/Subscriber.php', 'Amp\\Redis\\Subscription' => __DIR__ . '/..' . '/amphp/redis/src/Subscription.php', 'Amp\\Serialization\\CompressingSerializer' => __DIR__ . '/..' . '/amphp/serialization/src/CompressingSerializer.php', 'Amp\\Serialization\\JsonSerializer' => __DIR__ . '/..' . '/amphp/serialization/src/JsonSerializer.php', 'Amp\\Serialization\\NativeSerializer' => __DIR__ . '/..' . '/amphp/serialization/src/NativeSerializer.php', 'Amp\\Serialization\\PassthroughSerializer' => __DIR__ . '/..' . '/amphp/serialization/src/PassthroughSerializer.php', 'Amp\\Serialization\\SerializationException' => __DIR__ . '/..' . '/amphp/serialization/src/SerializationException.php', 'Amp\\Serialization\\Serializer' => __DIR__ . '/..' . '/amphp/serialization/src/Serializer.php', 'Amp\\Socket\\BindContext' => __DIR__ . '/..' . '/amphp/socket/src/BindContext.php', 'Amp\\Socket\\Certificate' => __DIR__ . '/..' . '/amphp/socket/src/Certificate.php', 'Amp\\Socket\\ClientTlsContext' => __DIR__ . '/..' . '/amphp/socket/src/ClientTlsContext.php', 'Amp\\Socket\\ConnectContext' => __DIR__ . '/..' . '/amphp/socket/src/ConnectContext.php', 'Amp\\Socket\\ConnectException' => __DIR__ . '/..' . '/amphp/socket/src/ConnectException.php', 'Amp\\Socket\\Connector' => __DIR__ . '/..' . '/amphp/socket/src/Connector.php', 'Amp\\Socket\\DatagramSocket' => __DIR__ . '/..' . '/amphp/socket/src/DatagramSocket.php', 'Amp\\Socket\\DnsConnector' => __DIR__ . '/..' . '/amphp/socket/src/DnsConnector.php', 'Amp\\Socket\\EncryptableSocket' => __DIR__ . '/..' . '/amphp/socket/src/EncryptableSocket.php', 'Amp\\Socket\\PendingAcceptError' => __DIR__ . '/..' . '/amphp/socket/src/PendingAcceptError.php', 'Amp\\Socket\\PendingReceiveError' => __DIR__ . '/..' . '/amphp/socket/src/PendingReceiveError.php', 'Amp\\Socket\\ResourceSocket' => __DIR__ . '/..' . '/amphp/socket/src/ResourceSocket.php', 'Amp\\Socket\\Server' => __DIR__ . '/..' . '/amphp/socket/src/Server.php', 'Amp\\Socket\\ServerTlsContext' => __DIR__ . '/..' . '/amphp/socket/src/ServerTlsContext.php', 'Amp\\Socket\\Socket' => __DIR__ . '/..' . '/amphp/socket/src/Socket.php', 'Amp\\Socket\\SocketAddress' => __DIR__ . '/..' . '/amphp/socket/src/SocketAddress.php', 'Amp\\Socket\\SocketException' => __DIR__ . '/..' . '/amphp/socket/src/SocketException.php', 'Amp\\Socket\\SocketPool' => __DIR__ . '/..' . '/amphp/socket/src/SocketPool.php', 'Amp\\Socket\\StaticConnector' => __DIR__ . '/..' . '/amphp/socket/src/StaticConnector.php', 'Amp\\Socket\\TlsException' => __DIR__ . '/..' . '/amphp/socket/src/TlsException.php', 'Amp\\Socket\\TlsInfo' => __DIR__ . '/..' . '/amphp/socket/src/TlsInfo.php', 'Amp\\Socket\\UnlimitedSocketPool' => __DIR__ . '/..' . '/amphp/socket/src/UnlimitedSocketPool.php', 'Amp\\Sql\\CommandResult' => __DIR__ . '/..' . '/amphp/sql/src/CommandResult.php', 'Amp\\Sql\\Common\\ConnectionPool' => __DIR__ . '/..' . '/amphp/sql-common/src/ConnectionPool.php', 'Amp\\Sql\\Common\\PooledResultSet' => __DIR__ . '/..' . '/amphp/sql-common/src/PooledResultSet.php', 'Amp\\Sql\\Common\\PooledStatement' => __DIR__ . '/..' . '/amphp/sql-common/src/PooledStatement.php', 'Amp\\Sql\\Common\\PooledTransaction' => __DIR__ . '/..' . '/amphp/sql-common/src/PooledTransaction.php', 'Amp\\Sql\\Common\\RetryConnector' => __DIR__ . '/..' . '/amphp/sql-common/src/RetryConnector.php', 'Amp\\Sql\\Common\\StatementPool' => __DIR__ . '/..' . '/amphp/sql-common/src/StatementPool.php', 'Amp\\Sql\\ConnectionConfig' => __DIR__ . '/..' . '/amphp/sql/src/ConnectionConfig.php', 'Amp\\Sql\\ConnectionException' => __DIR__ . '/..' . '/amphp/sql/src/ConnectionException.php', 'Amp\\Sql\\Connector' => __DIR__ . '/..' . '/amphp/sql/src/Connector.php', 'Amp\\Sql\\Executor' => __DIR__ . '/..' . '/amphp/sql/src/Executor.php', 'Amp\\Sql\\FailureException' => __DIR__ . '/..' . '/amphp/sql/src/FailureException.php', 'Amp\\Sql\\Link' => __DIR__ . '/..' . '/amphp/sql/src/Link.php', 'Amp\\Sql\\Pool' => __DIR__ . '/..' . '/amphp/sql/src/Pool.php', 'Amp\\Sql\\PoolError' => __DIR__ . '/..' . '/amphp/sql/src/PoolError.php', 'Amp\\Sql\\QueryError' => __DIR__ . '/..' . '/amphp/sql/src/QueryError.php', 'Amp\\Sql\\ResultSet' => __DIR__ . '/..' . '/amphp/sql/src/ResultSet.php', 'Amp\\Sql\\Statement' => __DIR__ . '/..' . '/amphp/sql/src/Statement.php', 'Amp\\Sql\\Transaction' => __DIR__ . '/..' . '/amphp/sql/src/Transaction.php', 'Amp\\Sql\\TransactionError' => __DIR__ . '/..' . '/amphp/sql/src/TransactionError.php', 'Amp\\Sql\\TransientResource' => __DIR__ . '/..' . '/amphp/sql/src/TransientResource.php', 'Amp\\Struct' => __DIR__ . '/..' . '/amphp/amp/lib/Struct.php', 'Amp\\Success' => __DIR__ . '/..' . '/amphp/amp/lib/Success.php', 'Amp\\Sync\\Barrier' => __DIR__ . '/..' . '/amphp/sync/src/Barrier.php', 'Amp\\Sync\\FileMutex' => __DIR__ . '/..' . '/amphp/sync/src/FileMutex.php', 'Amp\\Sync\\Internal\\MutexStorage' => __DIR__ . '/..' . '/amphp/sync/src/Internal/MutexStorage.php', 'Amp\\Sync\\Internal\\SemaphoreStorage' => __DIR__ . '/..' . '/amphp/sync/src/Internal/SemaphoreStorage.php', 'Amp\\Sync\\KeyedMutex' => __DIR__ . '/..' . '/amphp/sync/src/KeyedMutex.php', 'Amp\\Sync\\KeyedSemaphore' => __DIR__ . '/..' . '/amphp/sync/src/KeyedSemaphore.php', 'Amp\\Sync\\LocalKeyedMutex' => __DIR__ . '/..' . '/amphp/sync/src/LocalKeyedMutex.php', 'Amp\\Sync\\LocalKeyedSemaphore' => __DIR__ . '/..' . '/amphp/sync/src/LocalKeyedSemaphore.php', 'Amp\\Sync\\LocalMutex' => __DIR__ . '/..' . '/amphp/sync/src/LocalMutex.php', 'Amp\\Sync\\LocalSemaphore' => __DIR__ . '/..' . '/amphp/sync/src/LocalSemaphore.php', 'Amp\\Sync\\Lock' => __DIR__ . '/..' . '/amphp/sync/src/Lock.php', 'Amp\\Sync\\Mutex' => __DIR__ . '/..' . '/amphp/sync/src/Mutex.php', 'Amp\\Sync\\PosixSemaphore' => __DIR__ . '/..' . '/amphp/sync/src/PosixSemaphore.php', 'Amp\\Sync\\PrefixedKeyedMutex' => __DIR__ . '/..' . '/amphp/sync/src/PrefixedKeyedMutex.php', 'Amp\\Sync\\PrefixedKeyedSemaphore' => __DIR__ . '/..' . '/amphp/sync/src/PrefixedKeyedSemaphore.php', 'Amp\\Sync\\Semaphore' => __DIR__ . '/..' . '/amphp/sync/src/Semaphore.php', 'Amp\\Sync\\SemaphoreMutex' => __DIR__ . '/..' . '/amphp/sync/src/SemaphoreMutex.php', 'Amp\\Sync\\StaticKeyMutex' => __DIR__ . '/..' . '/amphp/sync/src/StaticKeyMutex.php', 'Amp\\Sync\\SyncException' => __DIR__ . '/..' . '/amphp/sync/src/SyncException.php', 'Amp\\Sync\\ThreadedMutex' => __DIR__ . '/..' . '/amphp/sync/src/ThreadedMutex.php', 'Amp\\Sync\\ThreadedSemaphore' => __DIR__ . '/..' . '/amphp/sync/src/ThreadedSemaphore.php', 'Amp\\TimeoutCancellationToken' => __DIR__ . '/..' . '/amphp/amp/lib/TimeoutCancellationToken.php', 'Amp\\TimeoutException' => __DIR__ . '/..' . '/amphp/amp/lib/TimeoutException.php', 'Amp\\Websocket\\Client' => __DIR__ . '/..' . '/amphp/websocket/src/Client.php', 'Amp\\Websocket\\ClientMetadata' => __DIR__ . '/..' . '/amphp/websocket/src/ClientMetadata.php', 'Amp\\Websocket\\Client\\Connection' => __DIR__ . '/..' . '/amphp/websocket-client/src/Connection.php', 'Amp\\Websocket\\Client\\ConnectionException' => __DIR__ . '/..' . '/amphp/websocket-client/src/ConnectionException.php', 'Amp\\Websocket\\Client\\ConnectionFactory' => __DIR__ . '/..' . '/amphp/websocket-client/src/ConnectionFactory.php', 'Amp\\Websocket\\Client\\Connector' => __DIR__ . '/..' . '/amphp/websocket-client/src/Connector.php', 'Amp\\Websocket\\Client\\Handshake' => __DIR__ . '/..' . '/amphp/websocket-client/src/Handshake.php', 'Amp\\Websocket\\Client\\Rfc6455Connection' => __DIR__ . '/..' . '/amphp/websocket-client/src/Rfc6455Connection.php', 'Amp\\Websocket\\Client\\Rfc6455ConnectionFactory' => __DIR__ . '/..' . '/amphp/websocket-client/src/Rfc6455ConnectionFactory.php', 'Amp\\Websocket\\Client\\Rfc6455Connector' => __DIR__ . '/..' . '/amphp/websocket-client/src/Rfc6455Connector.php', 'Amp\\Websocket\\ClosedException' => __DIR__ . '/..' . '/amphp/websocket/src/ClosedException.php', 'Amp\\Websocket\\Code' => __DIR__ . '/..' . '/amphp/websocket/src/Code.php', 'Amp\\Websocket\\CompressionContext' => __DIR__ . '/..' . '/amphp/websocket/src/CompressionContext.php', 'Amp\\Websocket\\CompressionContextFactory' => __DIR__ . '/..' . '/amphp/websocket/src/CompressionContextFactory.php', 'Amp\\Websocket\\Message' => __DIR__ . '/..' . '/amphp/websocket/src/Message.php', 'Amp\\Websocket\\Opcode' => __DIR__ . '/..' . '/amphp/websocket/src/Opcode.php', 'Amp\\Websocket\\Options' => __DIR__ . '/..' . '/amphp/websocket/src/Options.php', 'Amp\\Websocket\\Rfc6455Client' => __DIR__ . '/..' . '/amphp/websocket/src/Rfc6455Client.php', 'Amp\\Websocket\\Rfc7692Compression' => __DIR__ . '/..' . '/amphp/websocket/src/Rfc7692Compression.php', 'Amp\\Websocket\\Rfc7692CompressionFactory' => __DIR__ . '/..' . '/amphp/websocket/src/Rfc7692CompressionFactory.php', 'Amp\\WindowsRegistry\\KeyNotFoundException' => __DIR__ . '/..' . '/amphp/windows-registry/lib/KeyNotFoundException.php', 'Amp\\WindowsRegistry\\WindowsRegistry' => __DIR__ . '/..' . '/amphp/windows-registry/lib/WindowsRegistry.php', 'Attribute' => __DIR__ . '/..' . '/symfony/polyfill-php80/Resources/stubs/Attribute.php', 'Composer\\InstalledVersions' => __DIR__ . '/..' . '/composer/InstalledVersions.php', 'Kelunik\\Certificate\\Certificate' => __DIR__ . '/..' . '/kelunik/certificate/lib/Certificate.php', 'Kelunik\\Certificate\\FieldNotSupportedException' => __DIR__ . '/..' . '/kelunik/certificate/lib/FieldNotSupportedException.php', 'Kelunik\\Certificate\\InvalidCertificateException' => __DIR__ . '/..' . '/kelunik/certificate/lib/InvalidCertificateException.php', 'Kelunik\\Certificate\\Profile' => __DIR__ . '/..' . '/kelunik/certificate/lib/Profile.php', 'League\\Uri\\Contracts\\AuthorityInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/AuthorityInterface.php', 'League\\Uri\\Contracts\\DataPathInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/DataPathInterface.php', 'League\\Uri\\Contracts\\DomainHostInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/DomainHostInterface.php', 'League\\Uri\\Contracts\\FragmentInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/FragmentInterface.php', 'League\\Uri\\Contracts\\HostInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/HostInterface.php', 'League\\Uri\\Contracts\\IpHostInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/IpHostInterface.php', 'League\\Uri\\Contracts\\PathInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/PathInterface.php', 'League\\Uri\\Contracts\\PortInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/PortInterface.php', 'League\\Uri\\Contracts\\QueryInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/QueryInterface.php', 'League\\Uri\\Contracts\\SegmentedPathInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/SegmentedPathInterface.php', 'League\\Uri\\Contracts\\UriComponentInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/UriComponentInterface.php', 'League\\Uri\\Contracts\\UriException' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/UriException.php', 'League\\Uri\\Contracts\\UriInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/UriInterface.php', 'League\\Uri\\Contracts\\UserInfoInterface' => __DIR__ . '/..' . '/league/uri-interfaces/src/Contracts/UserInfoInterface.php', 'League\\Uri\\Exception' => __DIR__ . '/..' . '/league/uri-parser/src/Exception.php', 'League\\Uri\\Exceptions\\FileinfoSupportMissing' => __DIR__ . '/..' . '/league/uri-interfaces/src/Exceptions/FileinfoSupportMissing.php', 'League\\Uri\\Exceptions\\IdnSupportMissing' => __DIR__ . '/..' . '/league/uri-interfaces/src/Exceptions/IdnSupportMissing.php', 'League\\Uri\\Exceptions\\IdnaConversionFailed' => __DIR__ . '/..' . '/league/uri-interfaces/src/Exceptions/IdnaConversionFailed.php', 'League\\Uri\\Exceptions\\SyntaxError' => __DIR__ . '/..' . '/league/uri-interfaces/src/Exceptions/SyntaxError.php', 'League\\Uri\\Exceptions\\TemplateCanNotBeExpanded' => __DIR__ . '/..' . '/league/uri/src/Exceptions/TemplateCanNotBeExpanded.php', 'League\\Uri\\Http' => __DIR__ . '/..' . '/league/uri/src/Http.php', 'League\\Uri\\HttpFactory' => __DIR__ . '/..' . '/league/uri/src/HttpFactory.php', 'League\\Uri\\Idna\\Idna' => __DIR__ . '/..' . '/league/uri-interfaces/src/Idna/Idna.php', 'League\\Uri\\Idna\\IdnaInfo' => __DIR__ . '/..' . '/league/uri-interfaces/src/Idna/IdnaInfo.php', 'League\\Uri\\MissingIdnSupport' => __DIR__ . '/..' . '/league/uri-parser/src/MissingIdnSupport.php', 'League\\Uri\\Parser' => __DIR__ . '/..' . '/league/uri-parser/src/Parser.php', 'League\\Uri\\Uri' => __DIR__ . '/..' . '/league/uri/src/Uri.php', 'League\\Uri\\UriInfo' => __DIR__ . '/..' . '/league/uri/src/UriInfo.php', 'League\\Uri\\UriResolver' => __DIR__ . '/..' . '/league/uri/src/UriResolver.php', 'League\\Uri\\UriString' => __DIR__ . '/..' . '/league/uri/src/UriString.php', 'League\\Uri\\UriTemplate' => __DIR__ . '/..' . '/league/uri/src/UriTemplate.php', 'League\\Uri\\UriTemplate\\Expression' => __DIR__ . '/..' . '/league/uri/src/UriTemplate/Expression.php', 'League\\Uri\\UriTemplate\\Template' => __DIR__ . '/..' . '/league/uri/src/UriTemplate/Template.php', 'League\\Uri\\UriTemplate\\VarSpecifier' => __DIR__ . '/..' . '/league/uri/src/UriTemplate/VarSpecifier.php', 'League\\Uri\\UriTemplate\\VariableBag' => __DIR__ . '/..' . '/league/uri/src/UriTemplate/VariableBag.php', 'LibDNS\\Decoder\\Decoder' => __DIR__ . '/..' . '/daverandom/libdns/src/Decoder/Decoder.php', 'LibDNS\\Decoder\\DecoderFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Decoder/DecoderFactory.php', 'LibDNS\\Decoder\\DecodingContext' => __DIR__ . '/..' . '/daverandom/libdns/src/Decoder/DecodingContext.php', 'LibDNS\\Decoder\\DecodingContextFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Decoder/DecodingContextFactory.php', 'LibDNS\\Encoder\\Encoder' => __DIR__ . '/..' . '/daverandom/libdns/src/Encoder/Encoder.php', 'LibDNS\\Encoder\\EncoderFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Encoder/EncoderFactory.php', 'LibDNS\\Encoder\\EncodingContext' => __DIR__ . '/..' . '/daverandom/libdns/src/Encoder/EncodingContext.php', 'LibDNS\\Encoder\\EncodingContextFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Encoder/EncodingContextFactory.php', 'LibDNS\\Enumeration' => __DIR__ . '/..' . '/daverandom/libdns/src/Enumeration.php', 'LibDNS\\Messages\\Message' => __DIR__ . '/..' . '/daverandom/libdns/src/Messages/Message.php', 'LibDNS\\Messages\\MessageFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Messages/MessageFactory.php', 'LibDNS\\Messages\\MessageOpCodes' => __DIR__ . '/..' . '/daverandom/libdns/src/Messages/MessageOpCodes.php', 'LibDNS\\Messages\\MessageResponseCodes' => __DIR__ . '/..' . '/daverandom/libdns/src/Messages/MessageResponseCodes.php', 'LibDNS\\Messages\\MessageTypes' => __DIR__ . '/..' . '/daverandom/libdns/src/Messages/MessageTypes.php', 'LibDNS\\Packets\\LabelRegistry' => __DIR__ . '/..' . '/daverandom/libdns/src/Packets/LabelRegistry.php', 'LibDNS\\Packets\\Packet' => __DIR__ . '/..' . '/daverandom/libdns/src/Packets/Packet.php', 'LibDNS\\Packets\\PacketFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Packets/PacketFactory.php', 'LibDNS\\Records\\Question' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Question.php', 'LibDNS\\Records\\QuestionFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/QuestionFactory.php', 'LibDNS\\Records\\RData' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/RData.php', 'LibDNS\\Records\\RDataBuilder' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/RDataBuilder.php', 'LibDNS\\Records\\RDataFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/RDataFactory.php', 'LibDNS\\Records\\Record' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Record.php', 'LibDNS\\Records\\RecordCollection' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/RecordCollection.php', 'LibDNS\\Records\\RecordCollectionFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/RecordCollectionFactory.php', 'LibDNS\\Records\\RecordTypes' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/RecordTypes.php', 'LibDNS\\Records\\Resource' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Resource.php', 'LibDNS\\Records\\ResourceBuilder' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/ResourceBuilder.php', 'LibDNS\\Records\\ResourceBuilderFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/ResourceBuilderFactory.php', 'LibDNS\\Records\\ResourceClasses' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/ResourceClasses.php', 'LibDNS\\Records\\ResourceFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/ResourceFactory.php', 'LibDNS\\Records\\ResourceQClasses' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/ResourceQClasses.php', 'LibDNS\\Records\\ResourceQTypes' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/ResourceQTypes.php', 'LibDNS\\Records\\ResourceTypes' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/ResourceTypes.php', 'LibDNS\\Records\\TypeDefinitions\\FieldDefinition' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/TypeDefinitions/FieldDefinition.php', 'LibDNS\\Records\\TypeDefinitions\\FieldDefinitionFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/TypeDefinitions/FieldDefinitionFactory.php', 'LibDNS\\Records\\TypeDefinitions\\TypeDefinition' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinition.php', 'LibDNS\\Records\\TypeDefinitions\\TypeDefinitionFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinitionFactory.php', 'LibDNS\\Records\\TypeDefinitions\\TypeDefinitionManager' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinitionManager.php', 'LibDNS\\Records\\TypeDefinitions\\TypeDefinitionManagerFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/TypeDefinitions/TypeDefinitionManagerFactory.php', 'LibDNS\\Records\\Types\\Anything' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/Anything.php', 'LibDNS\\Records\\Types\\BitMap' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/BitMap.php', 'LibDNS\\Records\\Types\\Char' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/Char.php', 'LibDNS\\Records\\Types\\CharacterString' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/CharacterString.php', 'LibDNS\\Records\\Types\\DomainName' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/DomainName.php', 'LibDNS\\Records\\Types\\IPv4Address' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/IPv4Address.php', 'LibDNS\\Records\\Types\\IPv6Address' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/IPv6Address.php', 'LibDNS\\Records\\Types\\Long' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/Long.php', 'LibDNS\\Records\\Types\\Short' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/Short.php', 'LibDNS\\Records\\Types\\Type' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/Type.php', 'LibDNS\\Records\\Types\\TypeBuilder' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/TypeBuilder.php', 'LibDNS\\Records\\Types\\TypeFactory' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/TypeFactory.php', 'LibDNS\\Records\\Types\\Types' => __DIR__ . '/..' . '/daverandom/libdns/src/Records/Types/Types.php', 'Monolog\\Attribute\\AsMonologProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Attribute/AsMonologProcessor.php', 'Monolog\\DateTimeImmutable' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/DateTimeImmutable.php', 'Monolog\\ErrorHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/ErrorHandler.php', 'Monolog\\Formatter\\ChromePHPFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/ChromePHPFormatter.php', 'Monolog\\Formatter\\ElasticaFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/ElasticaFormatter.php', 'Monolog\\Formatter\\ElasticsearchFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/ElasticsearchFormatter.php', 'Monolog\\Formatter\\FlowdockFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/FlowdockFormatter.php', 'Monolog\\Formatter\\FluentdFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/FluentdFormatter.php', 'Monolog\\Formatter\\FormatterInterface' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/FormatterInterface.php', 'Monolog\\Formatter\\GelfMessageFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/GelfMessageFormatter.php', 'Monolog\\Formatter\\GoogleCloudLoggingFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/GoogleCloudLoggingFormatter.php', 'Monolog\\Formatter\\HtmlFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/HtmlFormatter.php', 'Monolog\\Formatter\\JsonFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/JsonFormatter.php', 'Monolog\\Formatter\\LineFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/LineFormatter.php', 'Monolog\\Formatter\\LogglyFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/LogglyFormatter.php', 'Monolog\\Formatter\\LogmaticFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/LogmaticFormatter.php', 'Monolog\\Formatter\\LogstashFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/LogstashFormatter.php', 'Monolog\\Formatter\\MongoDBFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/MongoDBFormatter.php', 'Monolog\\Formatter\\NormalizerFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/NormalizerFormatter.php', 'Monolog\\Formatter\\ScalarFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/ScalarFormatter.php', 'Monolog\\Formatter\\WildfireFormatter' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Formatter/WildfireFormatter.php', 'Monolog\\Handler\\AbstractHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/AbstractHandler.php', 'Monolog\\Handler\\AbstractProcessingHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/AbstractProcessingHandler.php', 'Monolog\\Handler\\AbstractSyslogHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/AbstractSyslogHandler.php', 'Monolog\\Handler\\AmqpHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/AmqpHandler.php', 'Monolog\\Handler\\BrowserConsoleHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/BrowserConsoleHandler.php', 'Monolog\\Handler\\BufferHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/BufferHandler.php', 'Monolog\\Handler\\ChromePHPHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/ChromePHPHandler.php', 'Monolog\\Handler\\CouchDBHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/CouchDBHandler.php', 'Monolog\\Handler\\CubeHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/CubeHandler.php', 'Monolog\\Handler\\Curl\\Util' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/Curl/Util.php', 'Monolog\\Handler\\DeduplicationHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/DeduplicationHandler.php', 'Monolog\\Handler\\DoctrineCouchDBHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/DoctrineCouchDBHandler.php', 'Monolog\\Handler\\DynamoDbHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/DynamoDbHandler.php', 'Monolog\\Handler\\ElasticaHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/ElasticaHandler.php', 'Monolog\\Handler\\ElasticsearchHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/ElasticsearchHandler.php', 'Monolog\\Handler\\ErrorLogHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/ErrorLogHandler.php', 'Monolog\\Handler\\FallbackGroupHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/FallbackGroupHandler.php', 'Monolog\\Handler\\FilterHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/FilterHandler.php', 'Monolog\\Handler\\FingersCrossedHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/FingersCrossedHandler.php', 'Monolog\\Handler\\FingersCrossed\\ActivationStrategyInterface' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/FingersCrossed/ActivationStrategyInterface.php', 'Monolog\\Handler\\FingersCrossed\\ChannelLevelActivationStrategy' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/FingersCrossed/ChannelLevelActivationStrategy.php', 'Monolog\\Handler\\FingersCrossed\\ErrorLevelActivationStrategy' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/FingersCrossed/ErrorLevelActivationStrategy.php', 'Monolog\\Handler\\FirePHPHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/FirePHPHandler.php', 'Monolog\\Handler\\FleepHookHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/FleepHookHandler.php', 'Monolog\\Handler\\FlowdockHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/FlowdockHandler.php', 'Monolog\\Handler\\FormattableHandlerInterface' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/FormattableHandlerInterface.php', 'Monolog\\Handler\\FormattableHandlerTrait' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/FormattableHandlerTrait.php', 'Monolog\\Handler\\GelfHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/GelfHandler.php', 'Monolog\\Handler\\GroupHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/GroupHandler.php', 'Monolog\\Handler\\Handler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/Handler.php', 'Monolog\\Handler\\HandlerInterface' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/HandlerInterface.php', 'Monolog\\Handler\\HandlerWrapper' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/HandlerWrapper.php', 'Monolog\\Handler\\IFTTTHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/IFTTTHandler.php', 'Monolog\\Handler\\InsightOpsHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/InsightOpsHandler.php', 'Monolog\\Handler\\LogEntriesHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/LogEntriesHandler.php', 'Monolog\\Handler\\LogglyHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/LogglyHandler.php', 'Monolog\\Handler\\LogmaticHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/LogmaticHandler.php', 'Monolog\\Handler\\MailHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/MailHandler.php', 'Monolog\\Handler\\MandrillHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/MandrillHandler.php', 'Monolog\\Handler\\MissingExtensionException' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/MissingExtensionException.php', 'Monolog\\Handler\\MongoDBHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/MongoDBHandler.php', 'Monolog\\Handler\\NativeMailerHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/NativeMailerHandler.php', 'Monolog\\Handler\\NewRelicHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/NewRelicHandler.php', 'Monolog\\Handler\\NoopHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/NoopHandler.php', 'Monolog\\Handler\\NullHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/NullHandler.php', 'Monolog\\Handler\\OverflowHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/OverflowHandler.php', 'Monolog\\Handler\\PHPConsoleHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/PHPConsoleHandler.php', 'Monolog\\Handler\\ProcessHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/ProcessHandler.php', 'Monolog\\Handler\\ProcessableHandlerInterface' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/ProcessableHandlerInterface.php', 'Monolog\\Handler\\ProcessableHandlerTrait' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/ProcessableHandlerTrait.php', 'Monolog\\Handler\\PsrHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/PsrHandler.php', 'Monolog\\Handler\\PushoverHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/PushoverHandler.php', 'Monolog\\Handler\\RedisHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/RedisHandler.php', 'Monolog\\Handler\\RedisPubSubHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/RedisPubSubHandler.php', 'Monolog\\Handler\\RollbarHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/RollbarHandler.php', 'Monolog\\Handler\\RotatingFileHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/RotatingFileHandler.php', 'Monolog\\Handler\\SamplingHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/SamplingHandler.php', 'Monolog\\Handler\\SendGridHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/SendGridHandler.php', 'Monolog\\Handler\\SlackHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/SlackHandler.php', 'Monolog\\Handler\\SlackWebhookHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/SlackWebhookHandler.php', 'Monolog\\Handler\\Slack\\SlackRecord' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/Slack/SlackRecord.php', 'Monolog\\Handler\\SocketHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/SocketHandler.php', 'Monolog\\Handler\\SqsHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/SqsHandler.php', 'Monolog\\Handler\\StreamHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/StreamHandler.php', 'Monolog\\Handler\\SwiftMailerHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/SwiftMailerHandler.php', 'Monolog\\Handler\\SymfonyMailerHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/SymfonyMailerHandler.php', 'Monolog\\Handler\\SyslogHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/SyslogHandler.php', 'Monolog\\Handler\\SyslogUdpHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/SyslogUdpHandler.php', 'Monolog\\Handler\\SyslogUdp\\UdpSocket' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/SyslogUdp/UdpSocket.php', 'Monolog\\Handler\\TelegramBotHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/TelegramBotHandler.php', 'Monolog\\Handler\\TestHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/TestHandler.php', 'Monolog\\Handler\\WebRequestRecognizerTrait' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/WebRequestRecognizerTrait.php', 'Monolog\\Handler\\WhatFailureGroupHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/WhatFailureGroupHandler.php', 'Monolog\\Handler\\ZendMonitorHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Handler/ZendMonitorHandler.php', 'Monolog\\LogRecord' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/LogRecord.php', 'Monolog\\Logger' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Logger.php', 'Monolog\\Processor\\GitProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/GitProcessor.php', 'Monolog\\Processor\\HostnameProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/HostnameProcessor.php', 'Monolog\\Processor\\IntrospectionProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/IntrospectionProcessor.php', 'Monolog\\Processor\\MemoryPeakUsageProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/MemoryPeakUsageProcessor.php', 'Monolog\\Processor\\MemoryProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/MemoryProcessor.php', 'Monolog\\Processor\\MemoryUsageProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/MemoryUsageProcessor.php', 'Monolog\\Processor\\MercurialProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/MercurialProcessor.php', 'Monolog\\Processor\\ProcessIdProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/ProcessIdProcessor.php', 'Monolog\\Processor\\ProcessorInterface' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/ProcessorInterface.php', 'Monolog\\Processor\\PsrLogMessageProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/PsrLogMessageProcessor.php', 'Monolog\\Processor\\TagProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/TagProcessor.php', 'Monolog\\Processor\\UidProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/UidProcessor.php', 'Monolog\\Processor\\WebProcessor' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Processor/WebProcessor.php', 'Monolog\\Registry' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Registry.php', 'Monolog\\ResettableInterface' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/ResettableInterface.php', 'Monolog\\SignalHandler' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/SignalHandler.php', 'Monolog\\Test\\TestCase' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Test/TestCase.php', 'Monolog\\Utils' => __DIR__ . '/..' . '/monolog/monolog/src/Monolog/Utils.php', 'ParagonIE\\ConstantTime\\Base32' => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src/Base32.php', 'ParagonIE\\ConstantTime\\Base32Hex' => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src/Base32Hex.php', 'ParagonIE\\ConstantTime\\Base64' => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src/Base64.php', 'ParagonIE\\ConstantTime\\Base64DotSlash' => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src/Base64DotSlash.php', 'ParagonIE\\ConstantTime\\Base64DotSlashOrdered' => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src/Base64DotSlashOrdered.php', 'ParagonIE\\ConstantTime\\Base64UrlSafe' => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src/Base64UrlSafe.php', 'ParagonIE\\ConstantTime\\Binary' => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src/Binary.php', 'ParagonIE\\ConstantTime\\EncoderInterface' => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src/EncoderInterface.php', 'ParagonIE\\ConstantTime\\Encoding' => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src/Encoding.php', 'ParagonIE\\ConstantTime\\Hex' => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src/Hex.php', 'ParagonIE\\ConstantTime\\RFC4648' => __DIR__ . '/..' . '/paragonie/constant_time_encoding/src/RFC4648.php', 'Parsedown' => __DIR__ . '/..' . '/erusev/parsedown/Parsedown.php', 'PhpToken' => __DIR__ . '/..' . '/symfony/polyfill-php80/Resources/stubs/PhpToken.php', 'Psr\\Http\\Message\\MessageInterface' => __DIR__ . '/..' . '/psr/http-message/src/MessageInterface.php', 'Psr\\Http\\Message\\RequestFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/RequestFactoryInterface.php', 'Psr\\Http\\Message\\RequestInterface' => __DIR__ . '/..' . '/psr/http-message/src/RequestInterface.php', 'Psr\\Http\\Message\\ResponseFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/ResponseFactoryInterface.php', 'Psr\\Http\\Message\\ResponseInterface' => __DIR__ . '/..' . '/psr/http-message/src/ResponseInterface.php', 'Psr\\Http\\Message\\ServerRequestFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/ServerRequestFactoryInterface.php', 'Psr\\Http\\Message\\ServerRequestInterface' => __DIR__ . '/..' . '/psr/http-message/src/ServerRequestInterface.php', 'Psr\\Http\\Message\\StreamFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/StreamFactoryInterface.php', 'Psr\\Http\\Message\\StreamInterface' => __DIR__ . '/..' . '/psr/http-message/src/StreamInterface.php', 'Psr\\Http\\Message\\UploadedFileFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/UploadedFileFactoryInterface.php', 'Psr\\Http\\Message\\UploadedFileInterface' => __DIR__ . '/..' . '/psr/http-message/src/UploadedFileInterface.php', 'Psr\\Http\\Message\\UriFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/UriFactoryInterface.php', 'Psr\\Http\\Message\\UriInterface' => __DIR__ . '/..' . '/psr/http-message/src/UriInterface.php', 'Psr\\Log\\AbstractLogger' => __DIR__ . '/..' . '/psr/log/src/AbstractLogger.php', 'Psr\\Log\\InvalidArgumentException' => __DIR__ . '/..' . '/psr/log/src/InvalidArgumentException.php', 'Psr\\Log\\LogLevel' => __DIR__ . '/..' . '/psr/log/src/LogLevel.php', 'Psr\\Log\\LoggerAwareInterface' => __DIR__ . '/..' . '/psr/log/src/LoggerAwareInterface.php', 'Psr\\Log\\LoggerAwareTrait' => __DIR__ . '/..' . '/psr/log/src/LoggerAwareTrait.php', 'Psr\\Log\\LoggerInterface' => __DIR__ . '/..' . '/psr/log/src/LoggerInterface.php', 'Psr\\Log\\LoggerTrait' => __DIR__ . '/..' . '/psr/log/src/LoggerTrait.php', 'Psr\\Log\\NullLogger' => __DIR__ . '/..' . '/psr/log/src/NullLogger.php', 'Stringable' => __DIR__ . '/..' . '/symfony/polyfill-php80/Resources/stubs/Stringable.php', 'Symfony\\Polyfill\\Mbstring\\Mbstring' => __DIR__ . '/..' . '/symfony/polyfill-mbstring/Mbstring.php', 'Symfony\\Polyfill\\Php80\\Php80' => __DIR__ . '/..' . '/symfony/polyfill-php80/Php80.php', 'Symfony\\Polyfill\\Php80\\PhpToken' => __DIR__ . '/..' . '/symfony/polyfill-php80/PhpToken.php', 'UnhandledMatchError' => __DIR__ . '/..' . '/symfony/polyfill-php80/Resources/stubs/UnhandledMatchError.php', 'ValueError' => __DIR__ . '/..' . '/symfony/polyfill-php80/Resources/stubs/ValueError.php', 'Webmozart\\Assert\\Assert' => __DIR__ . '/..' . '/webmozart/assert/src/Assert.php', 'Webmozart\\Assert\\InvalidArgumentException' => __DIR__ . '/..' . '/webmozart/assert/src/InvalidArgumentException.php', 'Webmozart\\Assert\\Mixin' => __DIR__ . '/..' . '/webmozart/assert/src/Mixin.php', 'cash\\LRUCache' => __DIR__ . '/..' . '/cash/lrucache/src/cash/LRUCache.php', 'danog\\Decoder\\FileId' => __DIR__ . '/..' . '/danog/tg-file-decoder/src/FileId.php', 'danog\\Decoder\\PhotoSizeSource' => __DIR__ . '/..' . '/danog/tg-file-decoder/src/PhotoSizeSource.php', 'danog\\Decoder\\PhotoSizeSource\\PhotoSizeSourceDialogPhoto' => __DIR__ . '/..' . '/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceDialogPhoto.php', 'danog\\Decoder\\PhotoSizeSource\\PhotoSizeSourceLegacy' => __DIR__ . '/..' . '/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceLegacy.php', 'danog\\Decoder\\PhotoSizeSource\\PhotoSizeSourceStickersetThumbnail' => __DIR__ . '/..' . '/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceStickersetThumbnail.php', 'danog\\Decoder\\PhotoSizeSource\\PhotoSizeSourceStickersetThumbnailVersion' => __DIR__ . '/..' . '/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceStickersetThumbnailVersion.php', 'danog\\Decoder\\PhotoSizeSource\\PhotoSizeSourceThumbnail' => __DIR__ . '/..' . '/danog/tg-file-decoder/src/PhotoSizeSource/PhotoSizeSourceThumbnail.php', 'danog\\Decoder\\UniqueFileId' => __DIR__ . '/..' . '/danog/tg-file-decoder/src/UniqueFileId.php', 'danog\\LibDNSJson\\JsonDecoder' => __DIR__ . '/..' . '/danog/libdns-json/lib/JsonDecoder.php', 'danog\\LibDNSJson\\JsonDecoderFactory' => __DIR__ . '/..' . '/danog/libdns-json/lib/JsonDecoderFactory.php', 'danog\\LibDNSJson\\QueryEncoder' => __DIR__ . '/..' . '/danog/libdns-json/lib/QueryEncoder.php', 'danog\\LibDNSJson\\QueryEncoderFactory' => __DIR__ . '/..' . '/danog/libdns-json/lib/QueryEncoderFactory.php', 'danog\\Loop\\Generic\\GenericLoop' => __DIR__ . '/..' . '/danog/loop/lib/Generic/GenericLoop.php', 'danog\\Loop\\Generic\\PeriodicLoop' => __DIR__ . '/..' . '/danog/loop/lib/Generic/PeriodicLoop.php', 'danog\\Loop\\Interfaces\\LoopInterface' => __DIR__ . '/..' . '/danog/loop/lib/Interfaces/LoopInterface.php', 'danog\\Loop\\Interfaces\\ResumableLoopInterface' => __DIR__ . '/..' . '/danog/loop/lib/Interfaces/ResumableLoopInterface.php', 'danog\\Loop\\Interfaces\\SignalLoopInterface' => __DIR__ . '/..' . '/danog/loop/lib/Interfaces/SignalLoopInterface.php', 'danog\\Loop\\Loop' => __DIR__ . '/..' . '/danog/loop/lib/Loop.php', 'danog\\Loop\\ResumableLoop' => __DIR__ . '/..' . '/danog/loop/lib/ResumableLoop.php', 'danog\\Loop\\ResumableSignalLoop' => __DIR__ . '/..' . '/danog/loop/lib/ResumableSignalLoop.php', 'danog\\Loop\\SignalLoop' => __DIR__ . '/..' . '/danog/loop/lib/SignalLoop.php', 'danog\\Loop\\Traits\\Loop' => __DIR__ . '/..' . '/danog/loop/lib/Traits/Loop.php', 'danog\\Loop\\Traits\\ResumableLoop' => __DIR__ . '/..' . '/danog/loop/lib/Traits/ResumableLoop.php', 'danog\\Loop\\Traits\\SignalLoop' => __DIR__ . '/..' . '/danog/loop/lib/Traits/SignalLoop.php', 'danog\\MadelineProto\\API' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/API.php', 'danog\\MadelineProto\\APIFactory' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/APIFactory.php', 'danog\\MadelineProto\\APIWrapper' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/APIWrapper.php', 'danog\\MadelineProto\\AbstractAPIFactory' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/AbstractAPIFactory.php', 'danog\\MadelineProto\\AnnotationsBuilder' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/AnnotationsBuilder.php', 'danog\\MadelineProto\\ApiWrappers\\Start' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/ApiWrappers/Start.php', 'danog\\MadelineProto\\ApiWrappers\\Templates' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/ApiWrappers/Templates.php', 'danog\\MadelineProto\\Async\\AsyncConstruct' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Async/AsyncConstruct.php', 'danog\\MadelineProto\\Bug74586Exception' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Bug74586Exception.php', 'danog\\MadelineProto\\Connection' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Connection.php', 'danog\\MadelineProto\\ContextConnector' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/ContextConnector.php', 'danog\\MadelineProto\\Conversion' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Conversion.php', 'danog\\MadelineProto\\Coroutine' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Coroutine.php', 'danog\\MadelineProto\\DataCenter' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/DataCenter.php', 'danog\\MadelineProto\\DataCenterConnection' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/DataCenterConnection.php', 'danog\\MadelineProto\\Db\\ArrayCacheTrait' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/ArrayCacheTrait.php', 'danog\\MadelineProto\\Db\\DbArray' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/DbArray.php', 'danog\\MadelineProto\\Db\\DbPropertiesFactory' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/DbPropertiesFactory.php', 'danog\\MadelineProto\\Db\\DbPropertiesTrait' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/DbPropertiesTrait.php', 'danog\\MadelineProto\\Db\\DbType' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/DbType.php', 'danog\\MadelineProto\\Db\\DriverArray' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/DriverArray.php', 'danog\\MadelineProto\\Db\\Driver\\Mysql' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/Driver/Mysql.php', 'danog\\MadelineProto\\Db\\Driver\\Postgres' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/Driver/Postgres.php', 'danog\\MadelineProto\\Db\\Driver\\Redis' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/Driver/Redis.php', 'danog\\MadelineProto\\Db\\MemoryArray' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/MemoryArray.php', 'danog\\MadelineProto\\Db\\MysqlArray' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/MysqlArray.php', 'danog\\MadelineProto\\Db\\NullCache\\MysqlArray' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/MysqlArray.php', 'danog\\MadelineProto\\Db\\NullCache\\NullCacheTrait' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/NullCacheTrait.php', 'danog\\MadelineProto\\Db\\NullCache\\PostgresArray' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/PostgresArray.php', 'danog\\MadelineProto\\Db\\NullCache\\RedisArray' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/NullCache/RedisArray.php', 'danog\\MadelineProto\\Db\\PostgresArray' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/PostgresArray.php', 'danog\\MadelineProto\\Db\\RedisArray' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/RedisArray.php', 'danog\\MadelineProto\\Db\\SqlArray' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Db/SqlArray.php', 'danog\\MadelineProto\\DoHConnector' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/DoHConnector.php', 'danog\\MadelineProto\\DocsBuilder' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/DocsBuilder.php', 'danog\\MadelineProto\\DocsBuilder\\Constructors' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/DocsBuilder/Constructors.php', 'danog\\MadelineProto\\DocsBuilder\\Methods' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/DocsBuilder/Methods.php', 'danog\\MadelineProto\\EventHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/EventHandler.php', 'danog\\MadelineProto\\Exception' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Exception.php', 'danog\\MadelineProto\\FileCallback' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/FileCallback.php', 'danog\\MadelineProto\\FileCallbackInterface' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/FileCallbackInterface.php', 'danog\\MadelineProto\\Files\\Server' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Files/Server.php', 'danog\\MadelineProto\\GarbageCollector' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/GarbageCollector.php', 'danog\\MadelineProto\\InternalDoc' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/InternalDoc.php', 'danog\\MadelineProto\\Ipc\\Client' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Client.php', 'danog\\MadelineProto\\Ipc\\ClientAbstract' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/ClientAbstract.php', 'danog\\MadelineProto\\Ipc\\ExitFailure' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/ExitFailure.php', 'danog\\MadelineProto\\Ipc\\IpcState' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/IpcState.php', 'danog\\MadelineProto\\Ipc\\Runner\\ProcessRunner' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Runner/ProcessRunner.php', 'danog\\MadelineProto\\Ipc\\Runner\\RunnerAbstract' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Runner/RunnerAbstract.php', 'danog\\MadelineProto\\Ipc\\Runner\\WebRunner' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Runner/WebRunner.php', 'danog\\MadelineProto\\Ipc\\Server' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Server.php', 'danog\\MadelineProto\\Ipc\\ServerCallback' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/ServerCallback.php', 'danog\\MadelineProto\\Ipc\\Wrapper' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\FileCallback' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/FileCallback.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\InputStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/InputStream.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\Obj' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/Obj.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\OutputStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/OutputStream.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\SeekableInputStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/SeekableInputStream.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\SeekableOutputStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/SeekableOutputStream.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\SeekableTrait' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/SeekableTrait.php', 'danog\\MadelineProto\\Ipc\\Wrapper\\WrapMethodTrait' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Ipc/Wrapper/WrapMethodTrait.php', 'danog\\MadelineProto\\Lang' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Lang.php', 'danog\\MadelineProto\\LightState' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/LightState.php', 'danog\\MadelineProto\\Logger' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Logger.php', 'danog\\MadelineProto\\Loop\\APILoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/APILoop.php', 'danog\\MadelineProto\\Loop\\Connection\\CheckLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/CheckLoop.php', 'danog\\MadelineProto\\Loop\\Connection\\CleanupLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/CleanupLoop.php', 'danog\\MadelineProto\\Loop\\Connection\\Common' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/Common.php', 'danog\\MadelineProto\\Loop\\Connection\\HttpWaitLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/HttpWaitLoop.php', 'danog\\MadelineProto\\Loop\\Connection\\PingLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/PingLoop.php', 'danog\\MadelineProto\\Loop\\Connection\\ReadLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/ReadLoop.php', 'danog\\MadelineProto\\Loop\\Connection\\WriteLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Connection/WriteLoop.php', 'danog\\MadelineProto\\Loop\\Generic\\GenericLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Generic/GenericLoop.php', 'danog\\MadelineProto\\Loop\\Generic\\PeriodicLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Generic/PeriodicLoop.php', 'danog\\MadelineProto\\Loop\\Generic\\PeriodicLoopInternal' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Generic/PeriodicLoopInternal.php', 'danog\\MadelineProto\\Loop\\InternalLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/InternalLoop.php', 'danog\\MadelineProto\\Loop\\LoggerLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/LoggerLoop.php', 'danog\\MadelineProto\\Loop\\Update\\FeedLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Update/FeedLoop.php', 'danog\\MadelineProto\\Loop\\Update\\SecretFeedLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Update/SecretFeedLoop.php', 'danog\\MadelineProto\\Loop\\Update\\SeqLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Update/SeqLoop.php', 'danog\\MadelineProto\\Loop\\Update\\UpdateLoop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Loop/Update/UpdateLoop.php', 'danog\\MadelineProto\\Lua' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Lua.php', 'danog\\MadelineProto\\MTProto' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProto.php', 'danog\\MadelineProto\\MTProtoSession\\AckHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/AckHandler.php', 'danog\\MadelineProto\\MTProtoSession\\AuthKeyHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/AuthKeyHandler.php', 'danog\\MadelineProto\\MTProtoSession\\CallHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/CallHandler.php', 'danog\\MadelineProto\\MTProtoSession\\MsgIdHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/MsgIdHandler.php', 'danog\\MadelineProto\\MTProtoSession\\MsgIdHandler\\MsgIdHandler64' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/MsgIdHandler/MsgIdHandler64.php', 'danog\\MadelineProto\\MTProtoSession\\Reliable' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/Reliable.php', 'danog\\MadelineProto\\MTProtoSession\\ResponseHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/ResponseHandler.php', 'danog\\MadelineProto\\MTProtoSession\\SeqNoHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/SeqNoHandler.php', 'danog\\MadelineProto\\MTProtoSession\\Session' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoSession/Session.php', 'danog\\MadelineProto\\MTProtoTools\\AuthKeyHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/AuthKeyHandler.php', 'danog\\MadelineProto\\MTProtoTools\\CallHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/CallHandler.php', 'danog\\MadelineProto\\MTProtoTools\\CombinedUpdatesState' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/CombinedUpdatesState.php', 'danog\\MadelineProto\\MTProtoTools\\Crypt' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt.php', 'danog\\MadelineProto\\MTProtoTools\\Crypt\\IGE' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt/IGE.php', 'danog\\MadelineProto\\MTProtoTools\\Crypt\\IGEOpenssl' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt/IGEOpenssl.php', 'danog\\MadelineProto\\MTProtoTools\\Crypt\\IGEPhpseclib' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Crypt/IGEPhpseclib.php', 'danog\\MadelineProto\\MTProtoTools\\Files' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/Files.php', 'danog\\MadelineProto\\MTProtoTools\\FilesLogic' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/FilesLogic.php', 'danog\\MadelineProto\\MTProtoTools\\MinDatabase' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/MinDatabase.php', 'danog\\MadelineProto\\MTProtoTools\\PasswordCalculator' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/PasswordCalculator.php', 'danog\\MadelineProto\\MTProtoTools\\PeerHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/PeerHandler.php', 'danog\\MadelineProto\\MTProtoTools\\ReferenceDatabase' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/ReferenceDatabase.php', 'danog\\MadelineProto\\MTProtoTools\\ResponseInfo' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/ResponseInfo.php', 'danog\\MadelineProto\\MTProtoTools\\UpdateHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/UpdateHandler.php', 'danog\\MadelineProto\\MTProtoTools\\UpdatesState' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProtoTools/UpdatesState.php', 'danog\\MadelineProto\\MTProto\\AuthKey' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProto/AuthKey.php', 'danog\\MadelineProto\\MTProto\\Container' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProto/Container.php', 'danog\\MadelineProto\\MTProto\\IncomingMessage' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProto/IncomingMessage.php', 'danog\\MadelineProto\\MTProto\\Message' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProto/Message.php', 'danog\\MadelineProto\\MTProto\\OutgoingMessage' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProto/OutgoingMessage.php', 'danog\\MadelineProto\\MTProto\\PermAuthKey' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProto/PermAuthKey.php', 'danog\\MadelineProto\\MTProto\\TempAuthKey' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MTProto/TempAuthKey.php', 'danog\\MadelineProto\\Magic' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Magic.php', 'danog\\MadelineProto\\MyTelegramOrgWrapper' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/MyTelegramOrgWrapper.php', 'danog\\MadelineProto\\NothingInTheSocketException' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/NothingInTheSocketException.php', 'danog\\MadelineProto\\PTSException' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/PTSException.php', 'danog\\MadelineProto\\PsrLogger' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/PsrLogger.php', 'danog\\MadelineProto\\RPCErrorException' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/RPCErrorException.php', 'danog\\MadelineProto\\RSA' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/RSA.php', 'danog\\MadelineProto\\ResponseException' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/ResponseException.php', 'danog\\MadelineProto\\SecretChats\\AuthKeyHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/SecretChats/AuthKeyHandler.php', 'danog\\MadelineProto\\SecretChats\\MessageHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/SecretChats/MessageHandler.php', 'danog\\MadelineProto\\SecretChats\\ResponseHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/SecretChats/ResponseHandler.php', 'danog\\MadelineProto\\SecretChats\\SeqNoHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/SecretChats/SeqNoHandler.php', 'danog\\MadelineProto\\SecurityException' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/SecurityException.php', 'danog\\MadelineProto\\Serialization' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Serialization.php', 'danog\\MadelineProto\\SessionPaths' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/SessionPaths.php', 'danog\\MadelineProto\\Settings' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings.php', 'danog\\MadelineProto\\SettingsAbstract' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/SettingsAbstract.php', 'danog\\MadelineProto\\SettingsEmpty' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/SettingsEmpty.php', 'danog\\MadelineProto\\Settings\\AppInfo' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/AppInfo.php', 'danog\\MadelineProto\\Settings\\Auth' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Auth.php', 'danog\\MadelineProto\\Settings\\Connection' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Connection.php', 'danog\\MadelineProto\\Settings\\DatabaseAbstract' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/DatabaseAbstract.php', 'danog\\MadelineProto\\Settings\\Database\\DatabaseAbstract' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/DatabaseAbstract.php', 'danog\\MadelineProto\\Settings\\Database\\Memory' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Memory.php', 'danog\\MadelineProto\\Settings\\Database\\Mysql' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Mysql.php', 'danog\\MadelineProto\\Settings\\Database\\Postgres' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Postgres.php', 'danog\\MadelineProto\\Settings\\Database\\Redis' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/Redis.php', 'danog\\MadelineProto\\Settings\\Database\\SqlAbstract' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Database/SqlAbstract.php', 'danog\\MadelineProto\\Settings\\Files' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Files.php', 'danog\\MadelineProto\\Settings\\Ipc' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Ipc.php', 'danog\\MadelineProto\\Settings\\Logger' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Logger.php', 'danog\\MadelineProto\\Settings\\Peer' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Peer.php', 'danog\\MadelineProto\\Settings\\Pwr' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Pwr.php', 'danog\\MadelineProto\\Settings\\RPC' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/RPC.php', 'danog\\MadelineProto\\Settings\\SecretChats' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/SecretChats.php', 'danog\\MadelineProto\\Settings\\Serialization' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Serialization.php', 'danog\\MadelineProto\\Settings\\TLSchema' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/TLSchema.php', 'danog\\MadelineProto\\Settings\\Templates' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/Templates.php', 'danog\\MadelineProto\\Settings\\VoIP' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Settings/VoIP.php', 'danog\\MadelineProto\\Shutdown' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Shutdown.php', 'danog\\MadelineProto\\Snitch' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Snitch.php', 'danog\\MadelineProto\\StrTools' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/StrTools.php', 'danog\\MadelineProto\\Stream\\ADNLTransport\\ADNLStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/ADNLTransport/ADNLStream.php', 'danog\\MadelineProto\\Stream\\Async\\Buffer' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Async/Buffer.php', 'danog\\MadelineProto\\Stream\\Async\\BufferedStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Async/BufferedStream.php', 'danog\\MadelineProto\\Stream\\Async\\RawStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Async/RawStream.php', 'danog\\MadelineProto\\Stream\\BufferInterface' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/BufferInterface.php', 'danog\\MadelineProto\\Stream\\BufferedProxyStreamInterface' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/BufferedProxyStreamInterface.php', 'danog\\MadelineProto\\Stream\\BufferedStreamInterface' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/BufferedStreamInterface.php', 'danog\\MadelineProto\\Stream\\Common\\BufferedRawStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/BufferedRawStream.php', 'danog\\MadelineProto\\Stream\\Common\\CtrStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/CtrStream.php', 'danog\\MadelineProto\\Stream\\Common\\FileBufferedStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/FileBufferedStream.php', 'danog\\MadelineProto\\Stream\\Common\\HashedBufferedStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/HashedBufferedStream.php', 'danog\\MadelineProto\\Stream\\Common\\SimpleBufferedRawStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/SimpleBufferedRawStream.php', 'danog\\MadelineProto\\Stream\\Common\\UdpBufferedStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Common/UdpBufferedStream.php', 'danog\\MadelineProto\\Stream\\ConnectionContext' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/ConnectionContext.php', 'danog\\MadelineProto\\Stream\\MTProtoBufferInterface' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoBufferInterface.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\AbridgedStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/AbridgedStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\FullStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/FullStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\HttpStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/HttpStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\HttpsStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/HttpsStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\IntermediatePaddedStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/IntermediatePaddedStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\IntermediateStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/IntermediateStream.php', 'danog\\MadelineProto\\Stream\\MTProtoTransport\\ObfuscatedStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/MTProtoTransport/ObfuscatedStream.php', 'danog\\MadelineProto\\Stream\\Ogg\\Ogg' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Ogg/Ogg.php', 'danog\\MadelineProto\\Stream\\ProxyStreamInterface' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/ProxyStreamInterface.php', 'danog\\MadelineProto\\Stream\\Proxy\\HttpProxy' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Proxy/HttpProxy.php', 'danog\\MadelineProto\\Stream\\Proxy\\SocksProxy' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Proxy/SocksProxy.php', 'danog\\MadelineProto\\Stream\\RawProxyStreamInterface' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/RawProxyStreamInterface.php', 'danog\\MadelineProto\\Stream\\RawStreamInterface' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/RawStreamInterface.php', 'danog\\MadelineProto\\Stream\\ReadBufferInterface' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/ReadBufferInterface.php', 'danog\\MadelineProto\\Stream\\StreamInterface' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/StreamInterface.php', 'danog\\MadelineProto\\Stream\\Transport\\DefaultStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/DefaultStream.php', 'danog\\MadelineProto\\Stream\\Transport\\PremadeStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/PremadeStream.php', 'danog\\MadelineProto\\Stream\\Transport\\WsStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/WsStream.php', 'danog\\MadelineProto\\Stream\\Transport\\WssStream' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/Transport/WssStream.php', 'danog\\MadelineProto\\Stream\\WriteBufferInterface' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Stream/WriteBufferInterface.php', 'danog\\MadelineProto\\TL\\Conversion\\BotAPI' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/BotAPI.php', 'danog\\MadelineProto\\TL\\Conversion\\BotAPIFiles' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/BotAPIFiles.php', 'danog\\MadelineProto\\TL\\Conversion\\DOMEntities' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/DOMEntities.php', 'danog\\MadelineProto\\TL\\Conversion\\Entities' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/Entities.php', 'danog\\MadelineProto\\TL\\Conversion\\Exception' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/Exception.php', 'danog\\MadelineProto\\TL\\Conversion\\Extension' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/Extension.php', 'danog\\MadelineProto\\TL\\Conversion\\TD' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/Conversion/TD.php', 'danog\\MadelineProto\\TL\\Exception' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/Exception.php', 'danog\\MadelineProto\\TL\\PrettyException' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/PrettyException.php', 'danog\\MadelineProto\\TL\\TL' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/TL.php', 'danog\\MadelineProto\\TL\\TLCallback' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/TLCallback.php', 'danog\\MadelineProto\\TL\\TLConstructors' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/TLConstructors.php', 'danog\\MadelineProto\\TL\\TLMethods' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/TLMethods.php', 'danog\\MadelineProto\\TL\\TLParams' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/TLParams.php', 'danog\\MadelineProto\\TL\\Types\\Button' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/Types/Button.php', 'danog\\MadelineProto\\TL\\Types\\Bytes' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TL/Types/Bytes.php', 'danog\\MadelineProto\\TON\\ADNLConnection' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TON/ADNLConnection.php', 'danog\\MadelineProto\\TON\\API' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TON/API.php', 'danog\\MadelineProto\\TON\\APIFactory' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TON/APIFactory.php', 'danog\\MadelineProto\\TON\\InternalDoc' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TON/InternalDoc.php', 'danog\\MadelineProto\\TON\\Lite' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/TON/Lite.php', 'danog\\MadelineProto\\Tools' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Tools.php', 'danog\\MadelineProto\\VoIP' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/VoIP.php', 'danog\\MadelineProto\\VoIPServerConfig' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/VoIPServerConfig.php', 'danog\\MadelineProto\\VoIP\\AckHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/VoIP/AckHandler.php', 'danog\\MadelineProto\\VoIP\\AuthKeyHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/VoIP/AuthKeyHandler.php', 'danog\\MadelineProto\\VoIP\\Endpoint' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/VoIP/Endpoint.php', 'danog\\MadelineProto\\VoIP\\MessageHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/VoIP/MessageHandler.php', 'danog\\MadelineProto\\Wrappers\\Ads' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Ads.php', 'danog\\MadelineProto\\Wrappers\\Button' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Button.php', 'danog\\MadelineProto\\Wrappers\\Callback' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Callback.php', 'danog\\MadelineProto\\Wrappers\\DialogHandler' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/DialogHandler.php', 'danog\\MadelineProto\\Wrappers\\Events' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Events.php', 'danog\\MadelineProto\\Wrappers\\Login' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Login.php', 'danog\\MadelineProto\\Wrappers\\Loop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Loop.php', 'danog\\MadelineProto\\Wrappers\\Noop' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Noop.php', 'danog\\MadelineProto\\Wrappers\\Start' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Start.php', 'danog\\MadelineProto\\Wrappers\\TOS' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/TOS.php', 'danog\\MadelineProto\\Wrappers\\Templates' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Templates.php', 'danog\\MadelineProto\\Wrappers\\Webhook' => __DIR__ . '/..' . '/danog/madelineproto/src/danog/MadelineProto/Wrappers/Webhook.php', 'danog\\PlaceHolder' => __DIR__ . '/..' . '/danog/magicalserializer/src/danog/PlaceHolder.php', 'danog\\PrimeModule' => __DIR__ . '/..' . '/danog/primemodule/lib/danog/PrimeModule.php', 'danog\\Serializable' => __DIR__ . '/..' . '/danog/magicalserializer/src/danog/Serializable.php', 'danog\\Serialization' => __DIR__ . '/..' . '/danog/magicalserializer/src/danog/Serialization.php', 'phpseclib3\\Common\\Functions\\Strings' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Common/Functions/Strings.php', 'phpseclib3\\Crypt\\AES' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/AES.php', 'phpseclib3\\Crypt\\Blowfish' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Blowfish.php', 'phpseclib3\\Crypt\\ChaCha20' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/ChaCha20.php', 'phpseclib3\\Crypt\\Common\\AsymmetricKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/AsymmetricKey.php', 'phpseclib3\\Crypt\\Common\\BlockCipher' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/BlockCipher.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\JWK' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/JWK.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\OpenSSH' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/OpenSSH.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\PKCS' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PKCS.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\PKCS1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PKCS1.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\PKCS8' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PKCS8.php', 'phpseclib3\\Crypt\\Common\\Formats\\Keys\\PuTTY' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Keys/PuTTY.php', 'phpseclib3\\Crypt\\Common\\Formats\\Signature\\Raw' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Formats/Signature/Raw.php', 'phpseclib3\\Crypt\\Common\\PrivateKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/PrivateKey.php', 'phpseclib3\\Crypt\\Common\\PublicKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/PublicKey.php', 'phpseclib3\\Crypt\\Common\\StreamCipher' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/StreamCipher.php', 'phpseclib3\\Crypt\\Common\\SymmetricKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/SymmetricKey.php', 'phpseclib3\\Crypt\\Common\\Traits\\Fingerprint' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Traits/Fingerprint.php', 'phpseclib3\\Crypt\\Common\\Traits\\PasswordProtected' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Common/Traits/PasswordProtected.php', 'phpseclib3\\Crypt\\DES' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DES.php', 'phpseclib3\\Crypt\\DH' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DH.php', 'phpseclib3\\Crypt\\DH\\Formats\\Keys\\PKCS1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DH/Formats/Keys/PKCS1.php', 'phpseclib3\\Crypt\\DH\\Formats\\Keys\\PKCS8' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DH/Formats/Keys/PKCS8.php', 'phpseclib3\\Crypt\\DH\\Parameters' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DH/Parameters.php', 'phpseclib3\\Crypt\\DH\\PrivateKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DH/PrivateKey.php', 'phpseclib3\\Crypt\\DH\\PublicKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DH/PublicKey.php', 'phpseclib3\\Crypt\\DSA' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\OpenSSH' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/OpenSSH.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\PKCS1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/PKCS1.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\PKCS8' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/PKCS8.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\PuTTY' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/PuTTY.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\Raw' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/Raw.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Keys\\XML' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Keys/XML.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Signature\\ASN1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Signature/ASN1.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Signature\\Raw' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Signature/Raw.php', 'phpseclib3\\Crypt\\DSA\\Formats\\Signature\\SSH2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Formats/Signature/SSH2.php', 'phpseclib3\\Crypt\\DSA\\Parameters' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/Parameters.php', 'phpseclib3\\Crypt\\DSA\\PrivateKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/PrivateKey.php', 'phpseclib3\\Crypt\\DSA\\PublicKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/DSA/PublicKey.php', 'phpseclib3\\Crypt\\EC' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\Base' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/Base.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\Binary' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/Binary.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\KoblitzPrime' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/KoblitzPrime.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\Montgomery' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/Montgomery.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\Prime' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/Prime.php', 'phpseclib3\\Crypt\\EC\\BaseCurves\\TwistedEdwards' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/BaseCurves/TwistedEdwards.php', 'phpseclib3\\Crypt\\EC\\Curves\\Curve25519' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/Curve25519.php', 'phpseclib3\\Crypt\\EC\\Curves\\Curve448' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/Curve448.php', 'phpseclib3\\Crypt\\EC\\Curves\\Ed25519' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/Ed25519.php', 'phpseclib3\\Crypt\\EC\\Curves\\Ed448' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/Ed448.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP160r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP160r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP160t1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP160t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP192r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP192r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP192t1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP192t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP224r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP224r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP224t1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP224t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP256r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP256r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP256t1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP256t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP320r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP320r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP320t1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP320t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP384r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP384r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP384t1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP384t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP512r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP512r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\brainpoolP512t1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/brainpoolP512t1.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistb233' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistb233.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistb409' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistb409.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistk163' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistk163.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistk233' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistk233.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistk283' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistk283.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistk409' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistk409.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistp192' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp192.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistp224' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp224.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistp256' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp256.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistp384' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp384.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistp521' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistp521.php', 'phpseclib3\\Crypt\\EC\\Curves\\nistt571' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/nistt571.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime192v1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime192v1.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime192v2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime192v2.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime192v3' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime192v3.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime239v1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime239v1.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime239v2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime239v2.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime239v3' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime239v3.php', 'phpseclib3\\Crypt\\EC\\Curves\\prime256v1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/prime256v1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp112r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp112r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp112r2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp112r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp128r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp128r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp128r2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp128r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp160k1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp160k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp160r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp160r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp160r2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp160r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp192k1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp192k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp192r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp192r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp224k1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp224k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp224r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp224r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp256k1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp256k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp256r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp256r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp384r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp384r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\secp521r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/secp521r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect113r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect113r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect113r2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect113r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect131r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect131r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect131r2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect131r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect163k1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect163k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect163r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect163r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect163r2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect163r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect193r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect193r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect193r2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect193r2.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect233k1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect233k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect233r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect233r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect239k1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect239k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect283k1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect283k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect283r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect283r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect409k1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect409k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect409r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect409r1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect571k1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect571k1.php', 'phpseclib3\\Crypt\\EC\\Curves\\sect571r1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Curves/sect571r1.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\Common' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/Common.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\JWK' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/JWK.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\MontgomeryPrivate' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/MontgomeryPrivate.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\MontgomeryPublic' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/MontgomeryPublic.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\OpenSSH' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/OpenSSH.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\PKCS1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/PKCS1.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\PKCS8' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/PKCS8.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\PuTTY' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/PuTTY.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\XML' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/XML.php', 'phpseclib3\\Crypt\\EC\\Formats\\Keys\\libsodium' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Keys/libsodium.php', 'phpseclib3\\Crypt\\EC\\Formats\\Signature\\ASN1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Signature/ASN1.php', 'phpseclib3\\Crypt\\EC\\Formats\\Signature\\Raw' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Signature/Raw.php', 'phpseclib3\\Crypt\\EC\\Formats\\Signature\\SSH2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Formats/Signature/SSH2.php', 'phpseclib3\\Crypt\\EC\\Parameters' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/Parameters.php', 'phpseclib3\\Crypt\\EC\\PrivateKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/PrivateKey.php', 'phpseclib3\\Crypt\\EC\\PublicKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/EC/PublicKey.php', 'phpseclib3\\Crypt\\Hash' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Hash.php', 'phpseclib3\\Crypt\\PublicKeyLoader' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/PublicKeyLoader.php', 'phpseclib3\\Crypt\\RC2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RC2.php', 'phpseclib3\\Crypt\\RC4' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RC4.php', 'phpseclib3\\Crypt\\RSA' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\JWK' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/JWK.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\MSBLOB' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/MSBLOB.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\OpenSSH' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/OpenSSH.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\PKCS1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PKCS1.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\PKCS8' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PKCS8.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\PSS' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PSS.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\PuTTY' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/PuTTY.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\Raw' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/Raw.php', 'phpseclib3\\Crypt\\RSA\\Formats\\Keys\\XML' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/Formats/Keys/XML.php', 'phpseclib3\\Crypt\\RSA\\PrivateKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/PrivateKey.php', 'phpseclib3\\Crypt\\RSA\\PublicKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/RSA/PublicKey.php', 'phpseclib3\\Crypt\\Random' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Random.php', 'phpseclib3\\Crypt\\Rijndael' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Rijndael.php', 'phpseclib3\\Crypt\\Salsa20' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Salsa20.php', 'phpseclib3\\Crypt\\TripleDES' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/TripleDES.php', 'phpseclib3\\Crypt\\Twofish' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Crypt/Twofish.php', 'phpseclib3\\Exception\\BadConfigurationException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/BadConfigurationException.php', 'phpseclib3\\Exception\\BadDecryptionException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/BadDecryptionException.php', 'phpseclib3\\Exception\\BadModeException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/BadModeException.php', 'phpseclib3\\Exception\\ConnectionClosedException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/ConnectionClosedException.php', 'phpseclib3\\Exception\\FileNotFoundException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/FileNotFoundException.php', 'phpseclib3\\Exception\\InconsistentSetupException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/InconsistentSetupException.php', 'phpseclib3\\Exception\\InsufficientSetupException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/InsufficientSetupException.php', 'phpseclib3\\Exception\\NoKeyLoadedException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/NoKeyLoadedException.php', 'phpseclib3\\Exception\\NoSupportedAlgorithmsException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/NoSupportedAlgorithmsException.php', 'phpseclib3\\Exception\\UnableToConnectException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/UnableToConnectException.php', 'phpseclib3\\Exception\\UnsupportedAlgorithmException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/UnsupportedAlgorithmException.php', 'phpseclib3\\Exception\\UnsupportedCurveException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/UnsupportedCurveException.php', 'phpseclib3\\Exception\\UnsupportedFormatException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/UnsupportedFormatException.php', 'phpseclib3\\Exception\\UnsupportedOperationException' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Exception/UnsupportedOperationException.php', 'phpseclib3\\File\\ANSI' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ANSI.php', 'phpseclib3\\File\\ASN1' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1.php', 'phpseclib3\\File\\ASN1\\Element' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Element.php', 'phpseclib3\\File\\ASN1\\Maps\\AccessDescription' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AccessDescription.php', 'phpseclib3\\File\\ASN1\\Maps\\AdministrationDomainName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AdministrationDomainName.php', 'phpseclib3\\File\\ASN1\\Maps\\AlgorithmIdentifier' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AlgorithmIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\AnotherName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AnotherName.php', 'phpseclib3\\File\\ASN1\\Maps\\Attribute' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Attribute.php', 'phpseclib3\\File\\ASN1\\Maps\\AttributeType' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AttributeType.php', 'phpseclib3\\File\\ASN1\\Maps\\AttributeTypeAndValue' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AttributeTypeAndValue.php', 'phpseclib3\\File\\ASN1\\Maps\\AttributeValue' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AttributeValue.php', 'phpseclib3\\File\\ASN1\\Maps\\Attributes' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Attributes.php', 'phpseclib3\\File\\ASN1\\Maps\\AuthorityInfoAccessSyntax' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AuthorityInfoAccessSyntax.php', 'phpseclib3\\File\\ASN1\\Maps\\AuthorityKeyIdentifier' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/AuthorityKeyIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\BaseDistance' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BaseDistance.php', 'phpseclib3\\File\\ASN1\\Maps\\BasicConstraints' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BasicConstraints.php', 'phpseclib3\\File\\ASN1\\Maps\\BuiltInDomainDefinedAttribute' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BuiltInDomainDefinedAttribute.php', 'phpseclib3\\File\\ASN1\\Maps\\BuiltInDomainDefinedAttributes' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BuiltInDomainDefinedAttributes.php', 'phpseclib3\\File\\ASN1\\Maps\\BuiltInStandardAttributes' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/BuiltInStandardAttributes.php', 'phpseclib3\\File\\ASN1\\Maps\\CPSuri' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CPSuri.php', 'phpseclib3\\File\\ASN1\\Maps\\CRLDistributionPoints' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CRLDistributionPoints.php', 'phpseclib3\\File\\ASN1\\Maps\\CRLNumber' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CRLNumber.php', 'phpseclib3\\File\\ASN1\\Maps\\CRLReason' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CRLReason.php', 'phpseclib3\\File\\ASN1\\Maps\\CertPolicyId' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertPolicyId.php', 'phpseclib3\\File\\ASN1\\Maps\\Certificate' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Certificate.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificateIssuer' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificateIssuer.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificateList' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificateList.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificatePolicies' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificatePolicies.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificateSerialNumber' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificateSerialNumber.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificationRequest' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificationRequest.php', 'phpseclib3\\File\\ASN1\\Maps\\CertificationRequestInfo' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CertificationRequestInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\Characteristic_two' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Characteristic_two.php', 'phpseclib3\\File\\ASN1\\Maps\\CountryName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/CountryName.php', 'phpseclib3\\File\\ASN1\\Maps\\Curve' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Curve.php', 'phpseclib3\\File\\ASN1\\Maps\\DHParameter' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DHParameter.php', 'phpseclib3\\File\\ASN1\\Maps\\DSAParams' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DSAParams.php', 'phpseclib3\\File\\ASN1\\Maps\\DSAPrivateKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DSAPrivateKey.php', 'phpseclib3\\File\\ASN1\\Maps\\DSAPublicKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DSAPublicKey.php', 'phpseclib3\\File\\ASN1\\Maps\\DigestInfo' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DigestInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\DirectoryString' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DirectoryString.php', 'phpseclib3\\File\\ASN1\\Maps\\DisplayText' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DisplayText.php', 'phpseclib3\\File\\ASN1\\Maps\\DistributionPoint' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DistributionPoint.php', 'phpseclib3\\File\\ASN1\\Maps\\DistributionPointName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DistributionPointName.php', 'phpseclib3\\File\\ASN1\\Maps\\DssSigValue' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/DssSigValue.php', 'phpseclib3\\File\\ASN1\\Maps\\ECParameters' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ECParameters.php', 'phpseclib3\\File\\ASN1\\Maps\\ECPoint' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ECPoint.php', 'phpseclib3\\File\\ASN1\\Maps\\ECPrivateKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ECPrivateKey.php', 'phpseclib3\\File\\ASN1\\Maps\\EDIPartyName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EDIPartyName.php', 'phpseclib3\\File\\ASN1\\Maps\\EcdsaSigValue' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EcdsaSigValue.php', 'phpseclib3\\File\\ASN1\\Maps\\EncryptedData' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EncryptedData.php', 'phpseclib3\\File\\ASN1\\Maps\\EncryptedPrivateKeyInfo' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/EncryptedPrivateKeyInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\ExtKeyUsageSyntax' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ExtKeyUsageSyntax.php', 'phpseclib3\\File\\ASN1\\Maps\\Extension' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Extension.php', 'phpseclib3\\File\\ASN1\\Maps\\ExtensionAttribute' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ExtensionAttribute.php', 'phpseclib3\\File\\ASN1\\Maps\\ExtensionAttributes' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ExtensionAttributes.php', 'phpseclib3\\File\\ASN1\\Maps\\Extensions' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Extensions.php', 'phpseclib3\\File\\ASN1\\Maps\\FieldElement' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/FieldElement.php', 'phpseclib3\\File\\ASN1\\Maps\\FieldID' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/FieldID.php', 'phpseclib3\\File\\ASN1\\Maps\\GeneralName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralName.php', 'phpseclib3\\File\\ASN1\\Maps\\GeneralNames' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralNames.php', 'phpseclib3\\File\\ASN1\\Maps\\GeneralSubtree' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralSubtree.php', 'phpseclib3\\File\\ASN1\\Maps\\GeneralSubtrees' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/GeneralSubtrees.php', 'phpseclib3\\File\\ASN1\\Maps\\HashAlgorithm' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/HashAlgorithm.php', 'phpseclib3\\File\\ASN1\\Maps\\HoldInstructionCode' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/HoldInstructionCode.php', 'phpseclib3\\File\\ASN1\\Maps\\InvalidityDate' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/InvalidityDate.php', 'phpseclib3\\File\\ASN1\\Maps\\IssuerAltName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/IssuerAltName.php', 'phpseclib3\\File\\ASN1\\Maps\\IssuingDistributionPoint' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/IssuingDistributionPoint.php', 'phpseclib3\\File\\ASN1\\Maps\\KeyIdentifier' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/KeyIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\KeyPurposeId' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/KeyPurposeId.php', 'phpseclib3\\File\\ASN1\\Maps\\KeyUsage' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/KeyUsage.php', 'phpseclib3\\File\\ASN1\\Maps\\MaskGenAlgorithm' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/MaskGenAlgorithm.php', 'phpseclib3\\File\\ASN1\\Maps\\Name' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Name.php', 'phpseclib3\\File\\ASN1\\Maps\\NameConstraints' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NameConstraints.php', 'phpseclib3\\File\\ASN1\\Maps\\NetworkAddress' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NetworkAddress.php', 'phpseclib3\\File\\ASN1\\Maps\\NoticeReference' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NoticeReference.php', 'phpseclib3\\File\\ASN1\\Maps\\NumericUserIdentifier' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/NumericUserIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\ORAddress' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ORAddress.php', 'phpseclib3\\File\\ASN1\\Maps\\OneAsymmetricKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OneAsymmetricKey.php', 'phpseclib3\\File\\ASN1\\Maps\\OrganizationName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OrganizationName.php', 'phpseclib3\\File\\ASN1\\Maps\\OrganizationalUnitNames' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OrganizationalUnitNames.php', 'phpseclib3\\File\\ASN1\\Maps\\OtherPrimeInfo' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OtherPrimeInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\OtherPrimeInfos' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/OtherPrimeInfos.php', 'phpseclib3\\File\\ASN1\\Maps\\PBEParameter' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBEParameter.php', 'phpseclib3\\File\\ASN1\\Maps\\PBES2params' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBES2params.php', 'phpseclib3\\File\\ASN1\\Maps\\PBKDF2params' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBKDF2params.php', 'phpseclib3\\File\\ASN1\\Maps\\PBMAC1params' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PBMAC1params.php', 'phpseclib3\\File\\ASN1\\Maps\\PKCS9String' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PKCS9String.php', 'phpseclib3\\File\\ASN1\\Maps\\Pentanomial' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Pentanomial.php', 'phpseclib3\\File\\ASN1\\Maps\\PersonalName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PersonalName.php', 'phpseclib3\\File\\ASN1\\Maps\\PolicyInformation' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyInformation.php', 'phpseclib3\\File\\ASN1\\Maps\\PolicyMappings' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyMappings.php', 'phpseclib3\\File\\ASN1\\Maps\\PolicyQualifierId' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyQualifierId.php', 'phpseclib3\\File\\ASN1\\Maps\\PolicyQualifierInfo' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PolicyQualifierInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\PostalAddress' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PostalAddress.php', 'phpseclib3\\File\\ASN1\\Maps\\Prime_p' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Prime_p.php', 'phpseclib3\\File\\ASN1\\Maps\\PrivateDomainName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateDomainName.php', 'phpseclib3\\File\\ASN1\\Maps\\PrivateKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateKey.php', 'phpseclib3\\File\\ASN1\\Maps\\PrivateKeyInfo' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateKeyInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\PrivateKeyUsagePeriod' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PrivateKeyUsagePeriod.php', 'phpseclib3\\File\\ASN1\\Maps\\PublicKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PublicKey.php', 'phpseclib3\\File\\ASN1\\Maps\\PublicKeyAndChallenge' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PublicKeyAndChallenge.php', 'phpseclib3\\File\\ASN1\\Maps\\PublicKeyInfo' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/PublicKeyInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\RC2CBCParameter' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RC2CBCParameter.php', 'phpseclib3\\File\\ASN1\\Maps\\RDNSequence' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RDNSequence.php', 'phpseclib3\\File\\ASN1\\Maps\\RSAPrivateKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RSAPrivateKey.php', 'phpseclib3\\File\\ASN1\\Maps\\RSAPublicKey' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RSAPublicKey.php', 'phpseclib3\\File\\ASN1\\Maps\\RSASSA_PSS_params' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RSASSA_PSS_params.php', 'phpseclib3\\File\\ASN1\\Maps\\ReasonFlags' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/ReasonFlags.php', 'phpseclib3\\File\\ASN1\\Maps\\RelativeDistinguishedName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RelativeDistinguishedName.php', 'phpseclib3\\File\\ASN1\\Maps\\RevokedCertificate' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/RevokedCertificate.php', 'phpseclib3\\File\\ASN1\\Maps\\SignedPublicKeyAndChallenge' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SignedPublicKeyAndChallenge.php', 'phpseclib3\\File\\ASN1\\Maps\\SpecifiedECDomain' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SpecifiedECDomain.php', 'phpseclib3\\File\\ASN1\\Maps\\SubjectAltName' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectAltName.php', 'phpseclib3\\File\\ASN1\\Maps\\SubjectDirectoryAttributes' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectDirectoryAttributes.php', 'phpseclib3\\File\\ASN1\\Maps\\SubjectInfoAccessSyntax' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectInfoAccessSyntax.php', 'phpseclib3\\File\\ASN1\\Maps\\SubjectPublicKeyInfo' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/SubjectPublicKeyInfo.php', 'phpseclib3\\File\\ASN1\\Maps\\TBSCertList' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/TBSCertList.php', 'phpseclib3\\File\\ASN1\\Maps\\TBSCertificate' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/TBSCertificate.php', 'phpseclib3\\File\\ASN1\\Maps\\TerminalIdentifier' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/TerminalIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\Time' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Time.php', 'phpseclib3\\File\\ASN1\\Maps\\Trinomial' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Trinomial.php', 'phpseclib3\\File\\ASN1\\Maps\\UniqueIdentifier' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/UniqueIdentifier.php', 'phpseclib3\\File\\ASN1\\Maps\\UserNotice' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/UserNotice.php', 'phpseclib3\\File\\ASN1\\Maps\\Validity' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/Validity.php', 'phpseclib3\\File\\ASN1\\Maps\\netscape_ca_policy_url' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/netscape_ca_policy_url.php', 'phpseclib3\\File\\ASN1\\Maps\\netscape_cert_type' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/netscape_cert_type.php', 'phpseclib3\\File\\ASN1\\Maps\\netscape_comment' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/ASN1/Maps/netscape_comment.php', 'phpseclib3\\File\\X509' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/File/X509.php', 'phpseclib3\\Math\\BigInteger' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\Base' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/Base.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\BuiltIn' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/BuiltIn.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\DefaultEngine' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/DefaultEngine.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\OpenSSL' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/OpenSSL.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\Reductions\\Barrett' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/Reductions/Barrett.php', 'phpseclib3\\Math\\BigInteger\\Engines\\BCMath\\Reductions\\EvalBarrett' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/BCMath/Reductions/EvalBarrett.php', 'phpseclib3\\Math\\BigInteger\\Engines\\Engine' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/Engine.php', 'phpseclib3\\Math\\BigInteger\\Engines\\GMP' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/GMP.php', 'phpseclib3\\Math\\BigInteger\\Engines\\GMP\\DefaultEngine' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/GMP/DefaultEngine.php', 'phpseclib3\\Math\\BigInteger\\Engines\\OpenSSL' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/OpenSSL.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP32' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP32.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP64' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP64.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Base' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Base.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\DefaultEngine' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/DefaultEngine.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Montgomery' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Montgomery.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\OpenSSL' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/OpenSSL.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\Barrett' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/Barrett.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\Classic' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/Classic.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\EvalBarrett' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/EvalBarrett.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\Montgomery' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/Montgomery.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\MontgomeryMult' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/MontgomeryMult.php', 'phpseclib3\\Math\\BigInteger\\Engines\\PHP\\Reductions\\PowerOfTwo' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BigInteger/Engines/PHP/Reductions/PowerOfTwo.php', 'phpseclib3\\Math\\BinaryField' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BinaryField.php', 'phpseclib3\\Math\\BinaryField\\Integer' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/BinaryField/Integer.php', 'phpseclib3\\Math\\Common\\FiniteField' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/Common/FiniteField.php', 'phpseclib3\\Math\\Common\\FiniteField\\Integer' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/Common/FiniteField/Integer.php', 'phpseclib3\\Math\\PrimeField' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/PrimeField.php', 'phpseclib3\\Math\\PrimeField\\Integer' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Math/PrimeField/Integer.php', 'phpseclib3\\Net\\SFTP' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Net/SFTP.php', 'phpseclib3\\Net\\SFTP\\Stream' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Net/SFTP/Stream.php', 'phpseclib3\\Net\\SSH2' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/Net/SSH2.php', 'phpseclib3\\System\\SSH\\Agent' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/System/SSH/Agent.php', 'phpseclib3\\System\\SSH\\Agent\\Identity' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/System/SSH/Agent/Identity.php', 'phpseclib3\\System\\SSH\\Common\\Traits\\ReadBytes' => __DIR__ . '/..' . '/phpseclib/phpseclib/phpseclib/System/SSH/Common/Traits/ReadBytes.php', ); public static function getInitializer(ClassLoader $loader) { return \Closure::bind(function () use ($loader) { $loader->prefixLengthsPsr4 = ComposerStaticInit16d0af0e1ea4d15d9ba7041440af7b83::$prefixLengthsPsr4; $loader->prefixDirsPsr4 = ComposerStaticInit16d0af0e1ea4d15d9ba7041440af7b83::$prefixDirsPsr4; $loader->prefixesPsr0 = ComposerStaticInit16d0af0e1ea4d15d9ba7041440af7b83::$prefixesPsr0; $loader->classMap = ComposerStaticInit16d0af0e1ea4d15d9ba7041440af7b83::$classMap; }, null, ClassLoader::class); } } = 7" }, "require-dev": { "vimeo/psalm": "^1", "phpunit/phpunit": "4.*|5.*" }, "suggest": { "ext-libsodium": "Provides a modern crypto API that can be used to generate random bytes." } } buildFromDirectory(dirname(__DIR__).'/lib'); rename( dirname(__DIR__).'/lib/index.php', dirname(__DIR__).'/lib/random.php' ); /** * If we pass an (optional) path to a private key as a second argument, we will * sign the Phar with OpenSSL. * * If you leave this out, it will produce an unsigned .phar! */ if ($argc > 1) { if (!@is_readable($argv[1])) { echo 'Could not read the private key file:', $argv[1], "\n"; exit(255); } $pkeyFile = file_get_contents($argv[1]); $private = openssl_get_privatekey($pkeyFile); if ($private !== false) { $pkey = ''; openssl_pkey_export($private, $pkey); $phar->setSignatureAlgorithm(Phar::OPENSSL, $pkey); /** * Save the corresponding public key to the file */ if (!@is_readable($dist.'/random_compat.phar.pubkey')) { $details = openssl_pkey_get_details($private); file_put_contents( $dist.'/random_compat.phar.pubkey', $details['key'] ); } } else { echo 'An error occurred reading the private key from OpenSSL.', "\n"; exit(255); } } { "name": "paragonie/constant_time_encoding", "description": "Constant-time Implementations of RFC 4648 Encoding (Base-64, Base-32, Base-16)", "keywords": [ "base64", "encoding", "rfc4648", "base32", "base16", "hex", "bin2hex", "hex2bin", "base64_encode", "base64_decode", "base32_encode", "base32_decode" ], "license": "MIT", "type": "library", "authors": [ { "name": "Paragon Initiative Enterprises", "email": "security@paragonie.com", "homepage": "https://paragonie.com", "role": "Maintainer" }, { "name": "Steve 'Sc00bz' Thomas", "email": "steve@tobtu.com", "homepage": "https://www.tobtu.com", "role": "Original Developer" } ], "support": { "issues": "https://github.com/paragonie/constant_time_encoding/issues", "email": "info@paragonie.com", "source": "https://github.com/paragonie/constant_time_encoding" }, "require": { "php": "^7|^8" }, "require-dev": { "phpunit/phpunit": "^6|^7|^8|^9", "vimeo/psalm": "^1|^2|^3|^4" }, "autoload": { "psr-4": { "ParagonIE\\ConstantTime\\": "src/" } }, "autoload-dev": { "psr-4": { "ParagonIE\\ConstantTime\\Tests\\": "tests/" } } } $chunk */ $chunk = \unpack('C*', Binary::safeSubstr($src, $i, 3)); $b0 = $chunk[1]; $b1 = $chunk[2]; $b2 = $chunk[3]; $dest .= static::encode6Bits( $b0 >> 2 ) . static::encode6Bits((($b0 << 4) | ($b1 >> 4)) & 63) . static::encode6Bits((($b1 << 2) | ($b2 >> 6)) & 63) . static::encode6Bits( $b2 & 63); } // The last chunk, which may have padding: if ($i < $srcLen) { /** @var array $chunk */ $chunk = \unpack('C*', Binary::safeSubstr($src, $i, $srcLen - $i)); $b0 = $chunk[1]; if ($i + 1 < $srcLen) { $b1 = $chunk[2]; $dest .= static::encode6Bits($b0 >> 2) . static::encode6Bits((($b0 << 4) | ($b1 >> 4)) & 63) . static::encode6Bits(($b1 << 2) & 63); if ($pad) { $dest .= '='; } } else { $dest .= static::encode6Bits( $b0 >> 2) . static::encode6Bits(($b0 << 4) & 63); if ($pad) { $dest .= '=='; } } } return $dest; } /** * decode from base64 into binary * * Base64 character set "./[A-Z][a-z][0-9]" * * @param string $encodedString * @param bool $strictPadding * @return string * * @throws RangeException * @throws TypeError * @psalm-suppress RedundantCondition */ public static function decode(string $encodedString, bool $strictPadding = false): string { // Remove padding $srcLen = Binary::safeStrlen($encodedString); if ($srcLen === 0) { return ''; } if ($strictPadding) { if (($srcLen & 3) === 0) { if ($encodedString[$srcLen - 1] === '=') { $srcLen--; if ($encodedString[$srcLen - 1] === '=') { $srcLen--; } } } if (($srcLen & 3) === 1) { throw new RangeException( 'Incorrect padding' ); } if ($encodedString[$srcLen - 1] === '=') { throw new RangeException( 'Incorrect padding' ); } } else { $encodedString = \rtrim($encodedString, '='); $srcLen = Binary::safeStrlen($encodedString); } $err = 0; $dest = ''; // Main loop (no padding): for ($i = 0; $i + 4 <= $srcLen; $i += 4) { /** @var array $chunk */ $chunk = \unpack('C*', Binary::safeSubstr($encodedString, $i, 4)); $c0 = static::decode6Bits($chunk[1]); $c1 = static::decode6Bits($chunk[2]); $c2 = static::decode6Bits($chunk[3]); $c3 = static::decode6Bits($chunk[4]); $dest .= \pack( 'CCC', ((($c0 << 2) | ($c1 >> 4)) & 0xff), ((($c1 << 4) | ($c2 >> 2)) & 0xff), ((($c2 << 6) | $c3 ) & 0xff) ); $err |= ($c0 | $c1 | $c2 | $c3) >> 8; } // The last chunk, which may have padding: if ($i < $srcLen) { /** @var array $chunk */ $chunk = \unpack('C*', Binary::safeSubstr($encodedString, $i, $srcLen - $i)); $c0 = static::decode6Bits($chunk[1]); if ($i + 2 < $srcLen) { $c1 = static::decode6Bits($chunk[2]); $c2 = static::decode6Bits($chunk[3]); $dest .= \pack( 'CC', ((($c0 << 2) | ($c1 >> 4)) & 0xff), ((($c1 << 4) | ($c2 >> 2)) & 0xff) ); $err |= ($c0 | $c1 | $c2) >> 8; if ($strictPadding) { $err |= ($c2 << 6) & 0xff; } } elseif ($i + 1 < $srcLen) { $c1 = static::decode6Bits($chunk[2]); $dest .= \pack( 'C', ((($c0 << 2) | ($c1 >> 4)) & 0xff) ); $err |= ($c0 | $c1) >> 8; if ($strictPadding) { $err |= ($c1 << 4) & 0xff; } } elseif ($strictPadding) { $err |= 1; } } $check = ($err === 0); if (!$check) { throw new RangeException( 'Base64::decode() only expects characters in the correct base64 alphabet' ); } return $dest; } /** * @param string $encodedString * @return string */ public static function decodeNoPadding(string $encodedString): string { $srcLen = Binary::safeStrlen($encodedString); if ($srcLen === 0) { return ''; } if (($srcLen & 3) === 0) { if ($encodedString[$srcLen - 1] === '=') { throw new InvalidArgumentException( "decodeNoPadding() doesn't tolerate padding" ); } if (($srcLen & 3) > 1) { if ($encodedString[$srcLen - 2] === '=') { throw new InvalidArgumentException( "decodeNoPadding() doesn't tolerate padding" ); } } } return static::decode( $encodedString, true ); } /** * Uses bitwise operators instead of table-lookups to turn 6-bit integers * into 8-bit integers. * * Base64 character set: * [A-Z] [a-z] [0-9] + / * 0x41-0x5a, 0x61-0x7a, 0x30-0x39, 0x2b, 0x2f * * @param int $src * @return int */ protected static function decode6Bits(int $src): int { $ret = -1; // if ($src > 0x40 && $src < 0x5b) $ret += $src - 0x41 + 1; // -64 $ret += (((0x40 - $src) & ($src - 0x5b)) >> 8) & ($src - 64); // if ($src > 0x60 && $src < 0x7b) $ret += $src - 0x61 + 26 + 1; // -70 $ret += (((0x60 - $src) & ($src - 0x7b)) >> 8) & ($src - 70); // if ($src > 0x2f && $src < 0x3a) $ret += $src - 0x30 + 52 + 1; // 5 $ret += (((0x2f - $src) & ($src - 0x3a)) >> 8) & ($src + 5); // if ($src == 0x2b) $ret += 62 + 1; $ret += (((0x2a - $src) & ($src - 0x2c)) >> 8) & 63; // if ($src == 0x2f) ret += 63 + 1; $ret += (((0x2e - $src) & ($src - 0x30)) >> 8) & 64; return $ret; } /** * Uses bitwise operators instead of table-lookups to turn 8-bit integers * into 6-bit integers. * * @param int $src * @return string */ protected static function encode6Bits(int $src): string { $diff = 0x41; // if ($src > 25) $diff += 0x61 - 0x41 - 26; // 6 $diff += ((25 - $src) >> 8) & 6; // if ($src > 51) $diff += 0x30 - 0x61 - 26; // -75 $diff -= ((51 - $src) >> 8) & 75; // if ($src > 61) $diff += 0x2b - 0x30 - 10; // -15 $diff -= ((61 - $src) >> 8) & 15; // if ($src > 62) $diff += 0x2f - 0x2b - 1; // 3 $diff += ((62 - $src) >> 8) & 3; return \pack('C', $src + $diff); } } 96 && $src < 123) $ret += $src - 97 + 1; // -64 $ret += (((0x60 - $src) & ($src - 0x7b)) >> 8) & ($src - 96); // if ($src > 0x31 && $src < 0x38) $ret += $src - 24 + 1; // -23 $ret += (((0x31 - $src) & ($src - 0x38)) >> 8) & ($src - 23); return $ret; } /** * Uses bitwise operators instead of table-lookups to turn 5-bit integers * into 8-bit integers. * * Uppercase variant. * * @param int $src * @return int */ protected static function decode5BitsUpper(int $src): int { $ret = -1; // if ($src > 64 && $src < 91) $ret += $src - 65 + 1; // -64 $ret += (((0x40 - $src) & ($src - 0x5b)) >> 8) & ($src - 64); // if ($src > 0x31 && $src < 0x38) $ret += $src - 24 + 1; // -23 $ret += (((0x31 - $src) & ($src - 0x38)) >> 8) & ($src - 23); return $ret; } /** * Uses bitwise operators instead of table-lookups to turn 8-bit integers * into 5-bit integers. * * @param int $src * @return string */ protected static function encode5Bits(int $src): string { $diff = 0x61; // if ($src > 25) $ret -= 72; $diff -= ((25 - $src) >> 8) & 73; return \pack('C', $src + $diff); } /** * Uses bitwise operators instead of table-lookups to turn 8-bit integers * into 5-bit integers. * * Uppercase variant. * * @param int $src * @return string */ protected static function encode5BitsUpper(int $src): string { $diff = 0x41; // if ($src > 25) $ret -= 40; $diff -= ((25 - $src) >> 8) & 41; return \pack('C', $src + $diff); } /** * @param string $encodedString * @param bool $upper * @return string */ public static function decodeNoPadding(string $encodedString, bool $upper = false): string { $srcLen = Binary::safeStrlen($encodedString); if ($srcLen === 0) { return ''; } if (($srcLen & 7) === 0) { for ($j = 0; $j < 7 && $j < $srcLen; ++$j) { if ($encodedString[$srcLen - $j - 1] === '=') { throw new InvalidArgumentException( "decodeNoPadding() doesn't tolerate padding" ); } } } return static::doDecode( $encodedString, $upper, true ); } /** * Base32 decoding * * @param string $src * @param bool $upper * @param bool $strictPadding * @return string * * @throws TypeError * @psalm-suppress RedundantCondition */ protected static function doDecode( string $src, bool $upper = false, bool $strictPadding = false ): string { // We do this to reduce code duplication: $method = $upper ? 'decode5BitsUpper' : 'decode5Bits'; // Remove padding $srcLen = Binary::safeStrlen($src); if ($srcLen === 0) { return ''; } if ($strictPadding) { if (($srcLen & 7) === 0) { for ($j = 0; $j < 7; ++$j) { if ($src[$srcLen - 1] === '=') { $srcLen--; } else { break; } } } if (($srcLen & 7) === 1) { throw new RangeException( 'Incorrect padding' ); } } else { $src = \rtrim($src, '='); $srcLen = Binary::safeStrlen($src); } $err = 0; $dest = ''; // Main loop (no padding): for ($i = 0; $i + 8 <= $srcLen; $i += 8) { /** @var array $chunk */ $chunk = \unpack('C*', Binary::safeSubstr($src, $i, 8)); /** @var int $c0 */ $c0 = static::$method($chunk[1]); /** @var int $c1 */ $c1 = static::$method($chunk[2]); /** @var int $c2 */ $c2 = static::$method($chunk[3]); /** @var int $c3 */ $c3 = static::$method($chunk[4]); /** @var int $c4 */ $c4 = static::$method($chunk[5]); /** @var int $c5 */ $c5 = static::$method($chunk[6]); /** @var int $c6 */ $c6 = static::$method($chunk[7]); /** @var int $c7 */ $c7 = static::$method($chunk[8]); $dest .= \pack( 'CCCCC', (($c0 << 3) | ($c1 >> 2) ) & 0xff, (($c1 << 6) | ($c2 << 1) | ($c3 >> 4)) & 0xff, (($c3 << 4) | ($c4 >> 1) ) & 0xff, (($c4 << 7) | ($c5 << 2) | ($c6 >> 3)) & 0xff, (($c6 << 5) | ($c7 ) ) & 0xff ); $err |= ($c0 | $c1 | $c2 | $c3 | $c4 | $c5 | $c6 | $c7) >> 8; } // The last chunk, which may have padding: if ($i < $srcLen) { /** @var array $chunk */ $chunk = \unpack('C*', Binary::safeSubstr($src, $i, $srcLen - $i)); /** @var int $c0 */ $c0 = static::$method($chunk[1]); if ($i + 6 < $srcLen) { /** @var int $c1 */ $c1 = static::$method($chunk[2]); /** @var int $c2 */ $c2 = static::$method($chunk[3]); /** @var int $c3 */ $c3 = static::$method($chunk[4]); /** @var int $c4 */ $c4 = static::$method($chunk[5]); /** @var int $c5 */ $c5 = static::$method($chunk[6]); /** @var int $c6 */ $c6 = static::$method($chunk[7]); $dest .= \pack( 'CCCC', (($c0 << 3) | ($c1 >> 2) ) & 0xff, (($c1 << 6) | ($c2 << 1) | ($c3 >> 4)) & 0xff, (($c3 << 4) | ($c4 >> 1) ) & 0xff, (($c4 << 7) | ($c5 << 2) | ($c6 >> 3)) & 0xff ); $err |= ($c0 | $c1 | $c2 | $c3 | $c4 | $c5 | $c6) >> 8; if ($strictPadding) { $err |= ($c6 << 5) & 0xff; } } elseif ($i + 5 < $srcLen) { /** @var int $c1 */ $c1 = static::$method($chunk[2]); /** @var int $c2 */ $c2 = static::$method($chunk[3]); /** @var int $c3 */ $c3 = static::$method($chunk[4]); /** @var int $c4 */ $c4 = static::$method($chunk[5]); /** @var int $c5 */ $c5 = static::$method($chunk[6]); $dest .= \pack( 'CCCC', (($c0 << 3) | ($c1 >> 2) ) & 0xff, (($c1 << 6) | ($c2 << 1) | ($c3 >> 4)) & 0xff, (($c3 << 4) | ($c4 >> 1) ) & 0xff, (($c4 << 7) | ($c5 << 2) ) & 0xff ); $err |= ($c0 | $c1 | $c2 | $c3 | $c4 | $c5) >> 8; } elseif ($i + 4 < $srcLen) { /** @var int $c1 */ $c1 = static::$method($chunk[2]); /** @var int $c2 */ $c2 = static::$method($chunk[3]); /** @var int $c3 */ $c3 = static::$method($chunk[4]); /** @var int $c4 */ $c4 = static::$method($chunk[5]); $dest .= \pack( 'CCC', (($c0 << 3) | ($c1 >> 2) ) & 0xff, (($c1 << 6) | ($c2 << 1) | ($c3 >> 4)) & 0xff, (($c3 << 4) | ($c4 >> 1) ) & 0xff ); $err |= ($c0 | $c1 | $c2 | $c3 | $c4) >> 8; if ($strictPadding) { $err |= ($c4 << 7) & 0xff; } } elseif ($i + 3 < $srcLen) { /** @var int $c1 */ $c1 = static::$method($chunk[2]); /** @var int $c2 */ $c2 = static::$method($chunk[3]); /** @var int $c3 */ $c3 = static::$method($chunk[4]); $dest .= \pack( 'CC', (($c0 << 3) | ($c1 >> 2) ) & 0xff, (($c1 << 6) | ($c2 << 1) | ($c3 >> 4)) & 0xff ); $err |= ($c0 | $c1 | $c2 | $c3) >> 8; if ($strictPadding) { $err |= ($c3 << 4) & 0xff; } } elseif ($i + 2 < $srcLen) { /** @var int $c1 */ $c1 = static::$method($chunk[2]); /** @var int $c2 */ $c2 = static::$method($chunk[3]); $dest .= \pack( 'CC', (($c0 << 3) | ($c1 >> 2) ) & 0xff, (($c1 << 6) | ($c2 << 1) ) & 0xff ); $err |= ($c0 | $c1 | $c2) >> 8; if ($strictPadding) { $err |= ($c2 << 6) & 0xff; } } elseif ($i + 1 < $srcLen) { /** @var int $c1 */ $c1 = static::$method($chunk[2]); $dest .= \pack( 'C', (($c0 << 3) | ($c1 >> 2) ) & 0xff ); $err |= ($c0 | $c1) >> 8; if ($strictPadding) { $err |= ($c1 << 6) & 0xff; } } else { $dest .= \pack( 'C', (($c0 << 3) ) & 0xff ); $err |= ($c0) >> 8; } } $check = ($err === 0); if (!$check) { throw new RangeException( 'Base32::doDecode() only expects characters in the correct base32 alphabet' ); } return $dest; } /** * Base32 Encoding * * @param string $src * @param bool $upper * @param bool $pad * @return string * @throws TypeError */ protected static function doEncode(string $src, bool $upper = false, $pad = true): string { // We do this to reduce code duplication: $method = $upper ? 'encode5BitsUpper' : 'encode5Bits'; $dest = ''; $srcLen = Binary::safeStrlen($src); // Main loop (no padding): for ($i = 0; $i + 5 <= $srcLen; $i += 5) { /** @var array $chunk */ $chunk = \unpack('C*', Binary::safeSubstr($src, $i, 5)); $b0 = $chunk[1]; $b1 = $chunk[2]; $b2 = $chunk[3]; $b3 = $chunk[4]; $b4 = $chunk[5]; $dest .= static::$method( ($b0 >> 3) & 31) . static::$method((($b0 << 2) | ($b1 >> 6)) & 31) . static::$method((($b1 >> 1) ) & 31) . static::$method((($b1 << 4) | ($b2 >> 4)) & 31) . static::$method((($b2 << 1) | ($b3 >> 7)) & 31) . static::$method((($b3 >> 2) ) & 31) . static::$method((($b3 << 3) | ($b4 >> 5)) & 31) . static::$method( $b4 & 31); } // The last chunk, which may have padding: if ($i < $srcLen) { /** @var array $chunk */ $chunk = \unpack('C*', Binary::safeSubstr($src, $i, $srcLen - $i)); $b0 = $chunk[1]; if ($i + 3 < $srcLen) { $b1 = $chunk[2]; $b2 = $chunk[3]; $b3 = $chunk[4]; $dest .= static::$method( ($b0 >> 3) & 31) . static::$method((($b0 << 2) | ($b1 >> 6)) & 31) . static::$method((($b1 >> 1) ) & 31) . static::$method((($b1 << 4) | ($b2 >> 4)) & 31) . static::$method((($b2 << 1) | ($b3 >> 7)) & 31) . static::$method((($b3 >> 2) ) & 31) . static::$method((($b3 << 3) ) & 31); if ($pad) { $dest .= '='; } } elseif ($i + 2 < $srcLen) { $b1 = $chunk[2]; $b2 = $chunk[3]; $dest .= static::$method( ($b0 >> 3) & 31) . static::$method((($b0 << 2) | ($b1 >> 6)) & 31) . static::$method((($b1 >> 1) ) & 31) . static::$method((($b1 << 4) | ($b2 >> 4)) & 31) . static::$method((($b2 << 1) ) & 31); if ($pad) { $dest .= '==='; } } elseif ($i + 1 < $srcLen) { $b1 = $chunk[2]; $dest .= static::$method( ($b0 >> 3) & 31) . static::$method((($b0 << 2) | ($b1 >> 6)) & 31) . static::$method((($b1 >> 1) ) & 31) . static::$method((($b1 << 4) ) & 31); if ($pad) { $dest .= '===='; } } else { $dest .= static::$method( ($b0 >> 3) & 31) . static::$method( ($b0 << 2) & 31); if ($pad) { $dest .= '======'; } } } return $dest; } } $chunk */ $chunk = \unpack('C', $binString[$i]); $c = $chunk[1] & 0xf; $b = $chunk[1] >> 4; $hex .= \pack( 'CC', (87 + $b + ((($b - 10) >> 8) & ~38)), (87 + $c + ((($c - 10) >> 8) & ~38)) ); } return $hex; } /** * Convert a binary string into a hexadecimal string without cache-timing * leaks, returning uppercase letters (as per RFC 4648) * * @param string $binString (raw binary) * @return string * @throws TypeError */ public static function encodeUpper(string $binString): string { $hex = ''; $len = Binary::safeStrlen($binString); for ($i = 0; $i < $len; ++$i) { /** @var array $chunk */ $chunk = \unpack('C', $binString[$i]); $c = $chunk[1] & 0xf; $b = $chunk[1] >> 4; $hex .= \pack( 'CC', (55 + $b + ((($b - 10) >> 8) & ~6)), (55 + $c + ((($c - 10) >> 8) & ~6)) ); } return $hex; } /** * Convert a hexadecimal string into a binary string without cache-timing * leaks * * @param string $encodedString * @param bool $strictPadding * @return string (raw binary) * @throws RangeException */ public static function decode( string $encodedString, bool $strictPadding = false ): string { $hex_pos = 0; $bin = ''; $c_acc = 0; $hex_len = Binary::safeStrlen($encodedString); $state = 0; if (($hex_len & 1) !== 0) { if ($strictPadding) { throw new RangeException( 'Expected an even number of hexadecimal characters' ); } else { $encodedString = '0' . $encodedString; ++$hex_len; } } /** @var array $chunk */ $chunk = \unpack('C*', $encodedString); while ($hex_pos < $hex_len) { ++$hex_pos; $c = $chunk[$hex_pos]; $c_num = $c ^ 48; $c_num0 = ($c_num - 10) >> 8; $c_alpha = ($c & ~32) - 55; $c_alpha0 = (($c_alpha - 10) ^ ($c_alpha - 16)) >> 8; if (($c_num0 | $c_alpha0) === 0) { throw new RangeException( 'Expected hexadecimal character' ); } $c_val = ($c_num0 & $c_num) | ($c_alpha & $c_alpha0); if ($state === 0) { $c_acc = $c_val * 16; } else { $bin .= \pack('C', $c_acc | $c_val); } $state ^= 1; } return $bin; } } 0x30 && $src < 0x3a) ret += $src - 0x2e + 1; // -47 $ret += (((0x2f - $src) & ($src - 0x3a)) >> 8) & ($src - 47); // if ($src > 0x60 && $src < 0x77) ret += $src - 0x61 + 10 + 1; // -86 $ret += (((0x60 - $src) & ($src - 0x77)) >> 8) & ($src - 86); return $ret; } /** * Uses bitwise operators instead of table-lookups to turn 5-bit integers * into 8-bit integers. * * @param int $src * @return int */ protected static function decode5BitsUpper(int $src): int { $ret = -1; // if ($src > 0x30 && $src < 0x3a) ret += $src - 0x2e + 1; // -47 $ret += (((0x2f - $src) & ($src - 0x3a)) >> 8) & ($src - 47); // if ($src > 0x40 && $src < 0x57) ret += $src - 0x41 + 10 + 1; // -54 $ret += (((0x40 - $src) & ($src - 0x57)) >> 8) & ($src - 54); return $ret; } /** * Uses bitwise operators instead of table-lookups to turn 8-bit integers * into 5-bit integers. * * @param int $src * @return string */ protected static function encode5Bits(int $src): string { $src += 0x30; // if ($src > 0x39) $src += 0x61 - 0x3a; // 39 $src += ((0x39 - $src) >> 8) & 39; return \pack('C', $src); } /** * Uses bitwise operators instead of table-lookups to turn 8-bit integers * into 5-bit integers. * * Uppercase variant. * * @param int $src * @return string */ protected static function encode5BitsUpper(int $src): string { $src += 0x30; // if ($src > 0x39) $src += 0x41 - 0x3a; // 7 $src += ((0x39 - $src) >> 8) & 7; return \pack('C', $src); } } 0x2d && $src < 0x3a) ret += $src - 0x2e + 1; // -45 $ret += (((0x2d - $src) & ($src - 0x3a)) >> 8) & ($src - 45); // if ($src > 0x40 && $src < 0x5b) ret += $src - 0x41 + 12 + 1; // -52 $ret += (((0x40 - $src) & ($src - 0x5b)) >> 8) & ($src - 52); // if ($src > 0x60 && $src < 0x7b) ret += $src - 0x61 + 38 + 1; // -58 $ret += (((0x60 - $src) & ($src - 0x7b)) >> 8) & ($src - 58); return $ret; } /** * Uses bitwise operators instead of table-lookups to turn 8-bit integers * into 6-bit integers. * * @param int $src * @return string */ protected static function encode6Bits(int $src): string { $src += 0x2e; // if ($src > 0x39) $src += 0x41 - 0x3a; // 7 $src += ((0x39 - $src) >> 8) & 7; // if ($src > 0x5a) $src += 0x61 - 0x5b; // 6 $src += ((0x5a - $src) >> 8) & 6; return \pack('C', $src); } } "Zm9v" * * @param string $str * @return string * * @throws TypeError */ public static function base64Encode(string $str): string { return Base64::encode($str); } /** * RFC 4648 Base64 decoding * * "Zm9v" -> "foo" * * @param string $str * @return string * * @throws TypeError */ public static function base64Decode(string $str): string { return Base64::decode($str, true); } /** * RFC 4648 Base64 (URL Safe) encoding * * "foo" -> "Zm9v" * * @param string $str * @return string * * @throws TypeError */ public static function base64UrlSafeEncode(string $str): string { return Base64UrlSafe::encode($str); } /** * RFC 4648 Base64 (URL Safe) decoding * * "Zm9v" -> "foo" * * @param string $str * @return string * * @throws TypeError */ public static function base64UrlSafeDecode(string $str): string { return Base64UrlSafe::decode($str, true); } /** * RFC 4648 Base32 encoding * * "foo" -> "MZXW6===" * * @param string $str * @return string * * @throws TypeError */ public static function base32Encode(string $str): string { return Base32::encodeUpper($str); } /** * RFC 4648 Base32 encoding * * "MZXW6===" -> "foo" * * @param string $str * @return string * * @throws TypeError */ public static function base32Decode(string $str): string { return Base32::decodeUpper($str, true); } /** * RFC 4648 Base32-Hex encoding * * "foo" -> "CPNMU===" * * @param string $str * @return string * * @throws TypeError */ public static function base32HexEncode(string $str): string { return Base32::encodeUpper($str); } /** * RFC 4648 Base32-Hex decoding * * "CPNMU===" -> "foo" * * @param string $str * @return string * * @throws TypeError */ public static function base32HexDecode(string $str): string { return Base32::decodeUpper($str, true); } /** * RFC 4648 Base16 decoding * * "foo" -> "666F6F" * * @param string $str * @return string * * @throws TypeError */ public static function base16Encode(string $str): string { return Hex::encodeUpper($str); } /** * RFC 4648 Base16 decoding * * "666F6F" -> "foo" * * @param string $str * @return string */ public static function base16Decode(string $str): string { return Hex::decode($str, true); } } 0x40 && $src < 0x5b) $ret += $src - 0x41 + 1; // -64 $ret += (((0x40 - $src) & ($src - 0x5b)) >> 8) & ($src - 64); // if ($src > 0x60 && $src < 0x7b) $ret += $src - 0x61 + 26 + 1; // -70 $ret += (((0x60 - $src) & ($src - 0x7b)) >> 8) & ($src - 70); // if ($src > 0x2f && $src < 0x3a) $ret += $src - 0x30 + 52 + 1; // 5 $ret += (((0x2f - $src) & ($src - 0x3a)) >> 8) & ($src + 5); // if ($src == 0x2c) $ret += 62 + 1; $ret += (((0x2c - $src) & ($src - 0x2e)) >> 8) & 63; // if ($src == 0x5f) ret += 63 + 1; $ret += (((0x5e - $src) & ($src - 0x60)) >> 8) & 64; return $ret; } /** * Uses bitwise operators instead of table-lookups to turn 8-bit integers * into 6-bit integers. * * @param int $src * @return string */ protected static function encode6Bits(int $src): string { $diff = 0x41; // if ($src > 25) $diff += 0x61 - 0x41 - 26; // 6 $diff += ((25 - $src) >> 8) & 6; // if ($src > 51) $diff += 0x30 - 0x61 - 26; // -75 $diff -= ((51 - $src) >> 8) & 75; // if ($src > 61) $diff += 0x2d - 0x30 - 10; // -13 $diff -= ((61 - $src) >> 8) & 13; // if ($src > 62) $diff += 0x5f - 0x2b - 1; // 3 $diff += ((62 - $src) >> 8) & 49; return \pack('C', $src + $diff); } } 0x2d && $src < 0x30) ret += $src - 0x2e + 1; // -45 $ret += (((0x2d - $src) & ($src - 0x30)) >> 8) & ($src - 45); // if ($src > 0x40 && $src < 0x5b) ret += $src - 0x41 + 2 + 1; // -62 $ret += (((0x40 - $src) & ($src - 0x5b)) >> 8) & ($src - 62); // if ($src > 0x60 && $src < 0x7b) ret += $src - 0x61 + 28 + 1; // -68 $ret += (((0x60 - $src) & ($src - 0x7b)) >> 8) & ($src - 68); // if ($src > 0x2f && $src < 0x3a) ret += $src - 0x30 + 54 + 1; // 7 $ret += (((0x2f - $src) & ($src - 0x3a)) >> 8) & ($src + 7); return $ret; } /** * Uses bitwise operators instead of table-lookups to turn 8-bit integers * into 6-bit integers. * * @param int $src * @return string */ protected static function encode6Bits(int $src): string { $src += 0x2e; // if ($src > 0x2f) $src += 0x41 - 0x30; // 17 $src += ((0x2f - $src) >> 8) & 17; // if ($src > 0x5a) $src += 0x61 - 0x5b; // 6 $src += ((0x5a - $src) >> 8) & 6; // if ($src > 0x7a) $src += 0x30 - 0x7b; // -75 $src -= ((0x7a - $src) >> 8) & 75; return \pack('C', $src); } } pem) === false) { throw new InvalidCertificateException("Could not convert 'OpenSSL X.509' resource to PEM!"); } if (!$this->info = openssl_x509_parse($cert)) { throw new InvalidCertificateException("Invalid PEM encoded certificate!"); } } public function getNames() { $san = isset($this->info["extensions"]["subjectAltName"]) ? $this->info["extensions"]["subjectAltName"] : ""; $names = []; $parts = array_map("trim", explode(",", $san)); foreach ($parts as $part) { if (stripos($part, "dns:") === 0) { $names[] = substr($part, 4); } } $names = array_map("strtolower", $names); $names = array_unique($names); sort($names); return $names; } public function getSubject() { if ($this->subject === null) { $this->subject = new Profile( isset($this->info["subject"]["CN"]) ? $this->info["subject"]["CN"] : null, isset($this->info["subject"]["O"]) ? $this->info["subject"]["O"] : null, isset($this->info["subject"]["C"]) ? $this->info["subject"]["C"] : null ); } return $this->subject; } public function getIssuer() { if ($this->issuer === null) { $this->issuer = new Profile( isset($this->info["issuer"]["CN"]) ? $this->info["issuer"]["CN"] : null, isset($this->info["issuer"]["O"]) ? $this->info["issuer"]["O"] : null, isset($this->info["issuer"]["C"]) ? $this->info["issuer"]["C"] : null ); } return $this->issuer; } public function getSerialNumber() { return $this->info["serialNumber"]; } public function getValidFrom() { return $this->info["validFrom_time_t"]; } public function getValidTo() { return $this->info["validTo_time_t"]; } public function getSignatureType() { // https://3v4l.org/Iu3T2 if (!isset($this->info["signatureTypeSN"])) { throw new FieldNotSupportedException("Signature type is not supported in this version of PHP. Please update your version to a higher bugfix version. See: https://3v4l.org/Iu3T2"); } return $this->info["signatureTypeSN"]; } public function isSelfSigned() { return $this->info["subject"] === $this->info["issuer"]; } public function toPem() { return $this->pem; } public function toDer() { return self::pemToDer($this->pem); } public function __toString() { return $this->pem; } public function __debugInfo() { return [ "commonName" => $this->getSubject()->getCommonName(), "names" => $this->getNames(), "issuedBy" => $this->getIssuer()->getCommonName(), "validFrom" => date("d.m.Y", $this->getValidFrom()), "validTo" => date("d.m.Y", $this->getValidTo()), ]; } public static function derToPem($der) { if (!is_string($der)) { throw new \InvalidArgumentException("\$der must be a string, " . gettype($der) . " given."); } return sprintf( "-----BEGIN CERTIFICATE-----\n%s-----END CERTIFICATE-----\n", chunk_split(base64_encode($der), 64, "\n") ); } public static function pemToDer($pem) { if (!is_string($pem)) { throw new \InvalidArgumentException("\$pem must be a string, " . gettype($pem) . " given."); } $pattern = "@-----BEGIN CERTIFICATE-----\n([a-zA-Z0-9+/=\n]+)-----END CERTIFICATE-----@"; if (!preg_match($pattern, $pem, $match)) { throw new InvalidCertificateException("Invalid PEM could not be converted to DER format."); } return base64_decode(str_replace(["\n", "\r"], "", trim($match[1]))); } } commonName = $commonName; $this->organizationName = $organizationName; $this->country = $country; } public function getCommonName() { return $this->commonName; } public function getOrganizationName() { return $this->organizationName; } public function getCountry() { return $this->country; } } =5.4", "ext-openssl": "*" }, "require-dev": { "phpunit/phpunit": "^4.8", "fabpot/php-cs-fixer": "^1.9" }, "autoload": { "psr-4": { "Kelunik\\Certificate\\": "lib" } } } { "name": "amphp/redis", "description": "A non-blocking Redis client for Amp.", "keywords": [ "amp", "amphp", "async", "client", "redis" ], "license": "MIT", "homepage": "https://github.com/amphp/redis", "authors": [ { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "support": { "issues": "https://github.com/amphp/redis/issues" }, "require": { "php": ">=7.1", "amphp/amp": "^2.2.1", "amphp/cache": "^1.2.1", "amphp/socket": "^1", "league/uri-parser": "^1.4", "amphp/sync": "^1.1" }, "require-dev": { "amphp/phpunit-util": "^1.1.2", "phpunit/phpunit": "^7 | ^8", "amphp/php-cs-fixer-config": "dev-master" }, "autoload": { "psr-4": { "Amp\\Redis\\": "src" }, "files": [ "src/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Redis\\": "test", "Amp\\Cache\\Test\\": "vendor/amphp/cache/test" } } } queryExecutor = $queryExecutor; $this->key = $key; } /** * @param string $element * @param string ...$elements * * @return Promise * * @link https://redis.io/commands/pfadd */ public function add(string $element, string ...$elements): Promise { return $this->queryExecutor->execute(\array_merge(['pfadd', $this->key, $element], $elements), toBool); } /** * @return Promise * * @link https://redis.io/commands/pfcount */ public function count(): Promise { return $this->queryExecutor->execute(['pfcount', $this->key]); } /** * @param string $sourceKey * @param string ...$sourceKeys * * @return Promise * * @link https://redis.io/commands/pfmerge */ public function storeUnion(string $sourceKey, string ...$sourceKeys): Promise { return $this->queryExecutor->execute(\array_merge(['pfmerge', $this->key, $sourceKey], $sourceKeys), toNull); } } queryExecutor = $queryExecutor; } public function getHyperLogLog(string $key): RedisHyperLogLog { return new RedisHyperLogLog($this->queryExecutor, $key); } public function getList(string $key): RedisList { return new RedisList($this->queryExecutor, $key); } public function getMap(string $key): RedisMap { return new RedisMap($this->queryExecutor, $key); } public function getSet(string $key): RedisSet { return new RedisSet($this->queryExecutor, $key); } public function getSortedSet(string $key): RedisSortedSet { return new RedisSortedSet($this->queryExecutor, $key); } /** * @param string $arg * @param string ...$args * * @return Promise */ public function query(string $arg, string ...$args): Promise { return $this->queryExecutor->execute(\array_merge([$arg], $args)); } /** * @param string $key * @param string ...$keys * * @return Promise * * @link https://redis.io/commands/del */ public function delete(string $key, string ...$keys): Promise { return $this->queryExecutor->execute(\array_merge(['del', $key], $keys)); } /** * @param string $key * * @return Promise * * @link https://redis.io/commands/dump */ public function dump(string $key): Promise { return $this->queryExecutor->execute(['dump', $key]); } /** * @param string $key * * @return Promise * * @link https://redis.io/commands/exists */ public function has(string $key): Promise { return $this->queryExecutor->execute(['exists', $key], toBool); } /** * @param string $key * @param int $seconds * * @return Promise * * @link https://redis.io/commands/expire */ public function expireIn(string $key, int $seconds): Promise { return $this->queryExecutor->execute(['expire', $key, $seconds], toBool); } /** * @param string $key * @param int $millis * * @return Promise * * @link https://redis.io/commands/pexpire */ public function expireInMillis(string $key, int $millis): Promise { return $this->queryExecutor->execute(['pexpire', $key, $millis], toBool); } /** * @param string $key * @param int $timestamp * * @return Promise * * @link https://redis.io/commands/expireat */ public function expireAt(string $key, int $timestamp): Promise { return $this->queryExecutor->execute(['expireat', $key, $timestamp], toBool); } /** * @param string $key * @param int $timestamp * * @return Promise * * @link https://redis.io/commands/pexpireat */ public function expireAtMillis(string $key, int $timestamp): Promise { return $this->queryExecutor->execute(['pexpireat', $key, $timestamp], toBool); } /** * @param string $pattern * * @return Promise * * @link https://redis.io/commands/keys * * @see Redis::scan() */ public function getKeys(string $pattern = '*'): Promise { return $this->queryExecutor->execute(['keys', $pattern]); } /** * @param string $key * @param int $db * * @return Promise * * @link https://redis.io/commands/move */ public function move(string $key, int $db): Promise { return $this->queryExecutor->execute(['move', $key, $db], toBool); } /** * @param string $key * * @return Promise * * @link https://redis.io/commands/object */ public function getObjectRefcount(string $key): Promise { return $this->queryExecutor->execute(['object', 'refcount', $key]); } /** * @param string $key * * @return Promise * * @link https://redis.io/commands/object */ public function getObjectEncoding(string $key): Promise { return $this->queryExecutor->execute(['object', 'encoding', $key]); } /** * @param string $key * * @return Promise * * @link https://redis.io/commands/object */ public function getObjectIdletime(string $key): Promise { return $this->queryExecutor->execute(['object', 'idletime', $key]); } /** * @param string $key * * @return Promise * * @link https://redis.io/commands/persist */ public function persist(string $key): Promise { return $this->queryExecutor->execute(['persist', $key], toBool); } /** * @return Promise * * @link https://redis.io/commands/randomkey */ public function getRandomKey(): Promise { return $this->queryExecutor->execute(['randomkey']); } /** * @param string $key * @param string $newKey * * @return Promise * * @link https://redis.io/commands/rename */ public function rename(string $key, string $newKey): Promise { return $this->queryExecutor->execute(['rename', $key, $newKey], toNull); } /** * @param string $key * @param string $newKey * * @return Promise * * @link https://redis.io/commands/renamenx */ public function renameWithoutOverwrite(string $key, string $newKey): Promise { return $this->queryExecutor->execute(['renamenx', $key, $newKey], toNull); } /** * @param string $key * @param string $serializedValue * @param int $ttl * * @return Promise * * @link https://redis.io/commands/restore */ public function restore(string $key, string $serializedValue, int $ttl = 0): Promise { return $this->queryExecutor->execute(['restore', $key, $ttl, $serializedValue], toNull); } /** * @param string $pattern * @param int $count * * @return Iterator * * @link https://redis.io/commands/scan */ public function scan(?string $pattern = null, ?int $count = null): Iterator { return new Producer(function (callable $emit) use ($pattern, $count) { $cursor = 0; do { $query = ['SCAN', $cursor]; if ($pattern !== null) { $query[] = 'MATCH'; $query[] = $pattern; } if ($count !== null) { $query[] = 'COUNT'; $query[] = $count; } [$cursor, $keys] = yield $this->queryExecutor->execute($query); foreach ($keys as $key) { yield $emit($key); } } while ($cursor !== '0'); }); } /** * @param string $key * * @return Promise * * @link https://redis.io/commands/ttl */ public function getTtl(string $key): Promise { return $this->queryExecutor->execute(['ttl', $key]); } /** * @param string $key * * @return Promise * * @link https://redis.io/commands/pttl */ public function getTtlInMillis(string $key): Promise { return $this->queryExecutor->execute(['pttl', $key]); } /** * @param string $key * * @return Promise * * @link https://redis.io/commands/type */ public function getType(string $key): Promise { return $this->queryExecutor->execute(['type', $key]); } /** * @param string $key * @param string $value * * @return Promise * * @link https://redis.io/commands/append */ public function append(string $key, string $value): Promise { return $this->queryExecutor->execute(['append', $key, $value]); } /** * @param string $key * @param int|null $start * @param int|null $end * * @return Promise * * @link https://redis.io/commands/bitcount */ public function countBits(string $key, ?int $start = null, ?int $end = null): Promise { $cmd = ['bitcount', $key]; if (isset($start, $end)) { $cmd[] = $start; $cmd[] = $end; } elseif (isset($start) || isset($end)) { throw \Error('Start and end must both be set or unset in countBits(), got start = ' . $start . ' and end = ' . $end); } return $this->queryExecutor->execute($cmd); } /** * @param string $destination * @param string $key * @param string ...$keys * * @return Promise * * @link https://redis.io/commands/bitop */ public function storeBitwiseAnd(string $destination, string $key, string ...$keys): Promise { return $this->queryExecutor->execute(\array_merge(['bitop', 'and', $destination, $key], $keys)); } /** * @param string $destination * @param string $key * @param string ...$keys * * @return Promise * * @link https://redis.io/commands/bitop */ public function storeBitwiseOr(string $destination, string $key, string ...$keys): Promise { return $this->queryExecutor->execute(\array_merge(['bitop', 'or', $destination, $key], $keys)); } /** * @param string $destination * @param string $key * @param string ...$keys * * @return Promise * * @link https://redis.io/commands/bitop */ public function storeBitwiseXor(string $destination, string $key, string ...$keys): Promise { return $this->queryExecutor->execute(\array_merge(['bitop', 'xor', $destination, $key], $keys)); } /** * @param string $destination * @param string $key * * @return Promise * * @link https://redis.io/commands/bitop */ public function storeBitwiseNot(string $destination, string $key): Promise { return $this->queryExecutor->execute(['bitop', 'not', $destination, $key]); } /** * @param string $key * @param bool $bit * @param int $start * @param int $end * * @return Promise * * @link https://redis.io/commands/bitpos */ public function getBitPosition(string $key, bool $bit, ?int $start = null, ?int $end = null): Promise { $payload = ['bitpos', $key, $bit ? 1 : 0]; if ($start !== null) { $payload[] = $start; if ($end !== null) { $payload[] = $end; } } return $this->queryExecutor->execute($payload); } /** * @param string $key * @param int $decrement * * @return Promise * * @link https://redis.io/commands/decrby */ public function decrement(string $key, int $decrement = 1): Promise { if ($decrement === 1) { return $this->queryExecutor->execute(['decr', $key]); } return $this->queryExecutor->execute(['decrby', $key, $decrement]); } /** * @param string $key * * @return Promise * * @link https://redis.io/commands/get */ public function get(string $key): Promise { return $this->queryExecutor->execute(['get', $key]); } /** * @param string $key * @param int $offset * * @return Promise * * @link https://redis.io/commands/getbit */ public function getBit(string $key, int $offset): Promise { return $this->queryExecutor->execute(['getbit', $key, $offset], toBool); } /** * @param string $key * @param int $start * @param int $end * * @return Promise * * @link https://redis.io/commands/getrange */ public function getRange(string $key, int $start = 0, int $end = -1): Promise { return $this->queryExecutor->execute(['getrange', $key, $start, $end]); } /** * @param string $key * @param string $value * * @return Promise * * @link https://redis.io/commands/getset */ public function getAndSet(string $key, string $value): Promise { return $this->queryExecutor->execute(['getset', $key, $value]); } /** * @param string $key * @param int $increment * * @return Promise * * @link https://redis.io/commands/incrby */ public function increment(string $key, int $increment = 1): Promise { if ($increment === 1) { return $this->queryExecutor->execute(['incr', $key]); } return $this->queryExecutor->execute(['incrby', $key, $increment]); } /** * @param string $key * @param float $increment * * @return Promise * * @link https://redis.io/commands/incrbyfloat */ public function incrementByFloat(string $key, float $increment): Promise { return $this->queryExecutor->execute(['incrbyfloat', $key, $increment], toFloat); } /** * @param string $key * @param string ...$keys * * @return Promise> * * @link https://redis.io/commands/mget */ public function getMultiple(string $key, string ...$keys): Promise { \array_unshift($keys , $key); $query = \array_merge(['mget'], $keys); return $this->queryExecutor->execute($query, static function ($response) use ($keys) { return \array_combine($keys, $response); }); } /** * @param array $data * * @return Promise * * @link https://redis.io/commands/mset */ public function setMultiple(array $data): Promise { $payload = ['mset']; foreach ($data as $key => $value) { $payload[] = $key; $payload[] = $value; } return $this->queryExecutor->execute($payload, toNull); } /** * @param array $data * * @return Promise * * @link https://redis.io/commands/msetnx */ public function setMultipleWithoutOverwrite(array $data): Promise { $payload = ['msetnx']; foreach ($data as $key => $value) { $payload[] = $key; $payload[] = $value; } return $this->queryExecutor->execute($payload, toNull); } /** * @param string $key * @param string $value * * @return Promise * * @link https://redis.io/commands/setnx */ public function setWithoutOverwrite(string $key, string $value): Promise { return $this->queryExecutor->execute(['setnx', $key, $value], toBool); } /** * @param string $key * @param string $value * * @return Promise */ public function set(string $key, string $value, SetOptions $options = null): Promise { $query = ['set', $key, $value]; if ($options !== null) { $query = \array_merge($query, $options->toQuery()); } return $this->queryExecutor->execute($query, toBool); } /** * @param string $key * @param int $offset * @param bool $value * * @return Promise * * @link https://redis.io/commands/setbit */ public function setBit(string $key, int $offset, bool $value): Promise { return $this->queryExecutor->execute(['setbit', $key, $offset, (int) $value]); } /** * @param string $key * @param int $offset * @param mixed $value * * @return Promise * * @link https://redis.io/commands/setrange */ public function setRange(string $key, int $offset, string $value): Promise { return $this->queryExecutor->execute(['setrange', $key, $offset, $value]); } /** * @param string $key * * @return Promise * * @link https://redis.io/commands/strlen */ public function getLength(string $key): Promise { return $this->queryExecutor->execute(['strlen', $key]); } /** * @param string $channel * @param string $message * * @return Promise * * @link https://redis.io/commands/publish */ public function publish(string $channel, string $message): Promise { return $this->queryExecutor->execute(['publish', $channel, $message]); } /** * @param string $pattern * * @return Promise * * @link https://redis.io/commands/pubsub */ public function getActiveChannels(?string $pattern = null): Promise { $payload = ['pubsub', 'channels']; if ($pattern !== null) { $payload[] = $pattern; } return $this->queryExecutor->execute($payload); } /** * @param string ...$channels * * @return Promise * * @link https://redis.io/commands/pubsub */ public function getNumberOfSubscriptions(string ...$channels): Promise { $query = \array_merge(['pubsub', 'numsub'], $channels); return $this->queryExecutor->execute($query, static function ($response) { $result = []; for ($i = 0, $count = \count($response); $i < $count; $i += 2) { $result[$response[$i]] = $response[$i + 1]; } return $result; }); } /** * @return Promise * * @link https://redis.io/commands/pubsub */ public function getNumberOfPatternSubscriptions(): Promise { return $this->queryExecutor->execute(['pubsub', 'numpat']); } /** * @return Promise * * @link https://redis.io/commands/ping */ public function ping(): Promise { return $this->queryExecutor->execute(['ping'], toNull); } /** * @return Promise * * @link https://redis.io/commands/quit */ public function quit(): Promise { return $this->queryExecutor->execute(['quit'], toNull); } /** * @return Promise * * @link https://redis.io/commands/bgrewriteaof */ public function rewriteAofAsync(): Promise { return $this->queryExecutor->execute(['bgrewriteaof'], toNull); } /** * @return Promise * * @link https://redis.io/commands/bgsave */ public function saveAsync(): Promise { return $this->queryExecutor->execute(['bgsave'], toNull); } /** * @return Promise * * @link https://redis.io/commands/client-getname */ public function getName(): Promise { return $this->queryExecutor->execute(['client', 'getname']); } /** * @param int $timeInMillis * * @return Promise * * @link https://redis.io/commands/client-pause */ public function pauseMillis(int $timeInMillis): Promise { return $this->queryExecutor->execute(['client', 'pause', $timeInMillis], toNull); } /** * @param string $name * * @return Promise * * @link https://redis.io/commands/client-setname */ public function setName(string $name): Promise { return $this->queryExecutor->execute(['client', 'setname', $name], toNull); } /** * @param string $parameter * * @return Promise * * @link https://redis.io/commands/config-get */ public function getConfig(string $parameter): Promise { return $this->queryExecutor->execute(['config', 'get', $parameter]); } /** * @return Promise * * @link https://redis.io/commands/config-resetstat */ public function resetStatistics(): Promise { return $this->queryExecutor->execute(['config', 'resetstat'], toNull); } /** * @return Promise * * @link https://redis.io/commands/config-rewrite */ public function rewriteConfig(): Promise { return $this->queryExecutor->execute(['config', 'rewrite'], toNull); } /** * @param string $parameter * @param string $value * * @return Promise * * @link https://redis.io/commands/config-set */ public function setConfig(string $parameter, string $value): Promise { return $this->queryExecutor->execute(['config', 'set', $parameter, $value], toNull); } /** * @return Promise * * @link https://redis.io/commands/dbsize */ public function getDatabaseSize(): Promise { return $this->queryExecutor->execute(['dbsize']); } /** * @return Promise * * @link https://redis.io/commands/flushall */ public function flushAll(): Promise { return $this->queryExecutor->execute(['flushall'], toNull); } /** * @return Promise * * @link https://redis.io/commands/flushdb */ public function flushDatabase(): Promise { return $this->queryExecutor->execute(['flushdb'], toNull); } /** * @return Promise * * @link https://redis.io/commands/lastsave */ public function getLastSave(): Promise { return $this->queryExecutor->execute(['lastsave']); } /** * @return Promise * * @link https://redis.io/commands/role */ public function getRole(): Promise { return $this->queryExecutor->execute(['role']); } /** * @return Promise * * @link https://redis.io/commands/save */ public function save(): Promise { return $this->queryExecutor->execute(['save'], toNull); } /** * @return Promise * * @link https://redis.io/commands/shutdown */ public function shutdownWithSave(): Promise { return $this->queryExecutor->execute(['shutdown', 'save']); } /** * @return Promise * * @link https://redis.io/commands/shutdown */ public function shutdownWithoutSave(): Promise { return $this->queryExecutor->execute(['shutdown', 'nosave']); } /** * @return Promise * * @link https://redis.io/commands/shutdown */ public function shutdown(): Promise { return $this->queryExecutor->execute(['shutdown']); } /** * @param string $host * @param int $port * * @return Promise * * @link https://redis.io/commands/slaveof */ public function enableReplication(string $host, int $port): Promise { return $this->queryExecutor->execute(['slaveof', $host, $port], toNull); } /** * @return Promise * * @link https://redis.io/commands/slaveof */ public function disableReplication(): Promise { return $this->queryExecutor->execute(['slaveof', 'no', 'one'], toNull); } /** * @param int $count * * @return Promise * * @link https://redis.io/commands/slowlog */ public function getSlowlog(?int $count = null): Promise { $payload = ['slowlog', 'get']; if ($count !== null) { $payload[] = $count; } return $this->queryExecutor->execute($payload); } /** * @return Promise * * @link https://redis.io/commands/slowlog */ public function getSlowlogLength(): Promise { return $this->queryExecutor->execute(['slowlog', 'len']); } /** * @return Promise * * @link https://redis.io/commands/slowlog */ public function resetSlowlog(): Promise { return $this->queryExecutor->execute(['slowlog', 'reset'], toNull); } /** * @return Promise * * @link https://redis.io/commands/time */ public function getTime(): Promise { return $this->queryExecutor->execute(['time']); } /** * @return Promise * * @link https://redis.io/commands/script-exists */ public function hasScript(string $sha1): Promise { return $this->queryExecutor->execute(['script', 'exists', $sha1], static function (array $array) { return (bool) $array[0]; }); } /** * @return Promise * * @link https://redis.io/commands/script-flush */ public function flushScripts(): Promise { $this->evalCache = []; // same as internal redis behavior return $this->queryExecutor->execute(['script', 'flush'], toNull); } /** * @return Promise * * @link https://redis.io/commands/script-kill */ public function killScript(): Promise { return $this->queryExecutor->execute(['script', 'kill'], toNull); } /** * @param string $script * * @return Promise * * @link https://redis.io/commands/script-load */ public function loadScript(string $script): Promise { return $this->queryExecutor->execute(['script', 'load', $script]); } /** * @param string $text * * @return Promise * * @link https://redis.io/commands/echo */ public function echo(string $text): Promise { return $this->queryExecutor->execute(['echo', $text]); } /** * @param string $script * @param string[] $keys * @param string[] $args * * @return Promise * * @link https://redis.io/commands/eval */ public function eval(string $script, array $keys = [], array $args = []): Promise { return call(function () use ($script, $keys, $args) { try { $sha1 = $this->evalCache[$script] ?? ($this->evalCache[$script] = \sha1($script)); $query = \array_merge(['evalsha', $sha1, \count($keys)], $keys, $args); return yield $this->queryExecutor->execute($query); } catch (QueryException $e) { if (\strtok($e->getMessage(), ' ') === 'NOSCRIPT') { $query = \array_merge(['eval', $script, \count($keys)], $keys, $args); return $this->queryExecutor->execute($query); } throw $e; } }); } public function select(int $database): Promise { return $this->queryExecutor->execute(['select', $database], toNull); } } queryExecutor = $queryExecutor; $this->key = $key; } /** * @param array $data * * @return Promise */ public function add(array $data): Promise { $payload = ['zadd', $this->key]; foreach ($data as $member => $score) { $payload[] = $score; $payload[] = $member; } return $this->queryExecutor->execute($payload); } /** * @return Promise */ public function getSize(): Promise { return $this->queryExecutor->execute(['zcard', $this->key]); } /** * @param int $min * @param int $max * * @return Promise */ public function count(int $min, int $max): Promise { return $this->queryExecutor->execute(['zcount', $this->key, $min, $max]); } /** * @param string $member * @param float $increment * * @return Promise */ public function increment(string $member, float $increment = 1): Promise { return $this->queryExecutor->execute(['zincrby', $this->key, $increment, $member], toFloat); } /** * @param string[] $keys * @param string $aggregate * * @return Promise */ public function storeIntersection(array $keys, string $aggregate = 'sum'): Promise { $payload = ['zinterstore', $this->key, \count($keys)]; $weights = []; if (\count(\array_filter(\array_keys($keys), 'is_string'))) { foreach ($keys as $key => $weight) { $payload[] = $key; $weights[] = $weight; } } else { foreach ($keys as $key) { $payload[] = $key; } } if (\count($weights) > 0) { $payload[] = 'WEIGHTS'; foreach ($weights as $weight) { $payload[] = $weight; } } if (\strtolower($aggregate) !== 'sum') { $payload[] = 'AGGREGATE'; $payload[] = $aggregate; } return $this->queryExecutor->execute($payload); } /** * @param string $min * @param string $max * * @return Promise */ public function countLexicographically(string $min, string $max): Promise { return $this->queryExecutor->execute(['zlexcount', $this->key, $min, $max]); } /** * @param string $member * * @return Promise */ public function getRank(string $member): Promise { return $this->queryExecutor->execute(['zrank', $this->key, $member]); } /** * @param string $member * @param string ...$members * * @return Promise */ public function remove(string $member, string ...$members): Promise { return $this->queryExecutor->execute(\array_merge(['zrem', $this->key, $member], $members)); } /** * @param string $min * @param string $max * * @return Promise */ public function removeLexicographicRange(string $min, string $max): Promise { return $this->queryExecutor->execute(['zremrangebylex', $this->key, $min, $max]); } /** * @param int $start * @param int $stop * * @return Promise */ public function removeRankRange(int $start, int $stop): Promise { return $this->queryExecutor->execute(['zremrangebyrank', $this->key, $start, $stop]); } /** * @param float $min * @param float $max * * @return Promise */ public function removeScoreRange(float $min, float $max): Promise { return $this->queryExecutor->execute(['zremrangebyscore', $this->key, $min, $max]); } /** * @param string $member * * @return Promise */ public function getReversedRank(string $member): Promise { return $this->queryExecutor->execute(['zrevrank', $this->key, $member]); } /** * @param string|null $pattern * @param int|null $count * * @return Iterator */ public function scan(?string $pattern = null, ?int $count = null): Iterator { return new Producer(function (callable $emit) use ($pattern, $count) { $cursor = 0; do { $query = ['ZSCAN', $this->key, $cursor]; if ($pattern !== null) { $query[] = 'MATCH'; $query[] = $pattern; } if ($count !== null) { $query[] = 'COUNT'; $query[] = $count; } [$cursor, $keys] = yield $this->queryExecutor->execute($query); $count = \count($keys); \assert($count % 2 === 0); for ($i = 0; $i < $count; $i += 2) { yield $emit([$keys[$i], (float) $keys[$i + 1]]); } } while ($cursor !== '0'); }); } /** * @param string $member * * @return Promise */ public function getScore(string $member): Promise { return $this->queryExecutor->execute(['zscore', $this->key, $member], toFloat); } /** * @param string[] $keys * @param string $aggregate * * @return Promise */ public function storeUnion(array $keys, string $aggregate = 'sum'): Promise { $payload = ['zunionstore', $this->key, \count($keys)]; $weights = []; if (\count(\array_filter(\array_keys($keys), 'is_string'))) { foreach ($keys as $key => $weight) { $payload[] = $key; $weights[] = $weight; } } else { foreach ($keys as $key) { $payload[] = $key; } } if (\count($weights) > 0) { $payload[] = 'WEIGHTS'; foreach ($weights as $weight) { $payload[] = $weight; } } if (\strtolower($aggregate) !== 'sum') { $payload[] = 'AGGREGATE'; $payload[] = $aggregate; } return $this->queryExecutor->execute($payload); } /** * @param SortOptions $sort * * @return Promise * * @link https://redis.io/commands/sort */ public function sort(?SortOptions $sort = null): Promise { return $this->queryExecutor->execute(\array_merge(['SORT', $this->key], ($sort ?? new SortOptions)->toQuery())); } } iterator = $iterator; $this->unsubscribeCallback = $unsubscribeCallback; } /** @inheritdoc */ public function advance(): Promise { return $this->iterator->advance(); } /** @inheritdoc */ public function getCurrent() { return $this->iterator->getCurrent(); } public function cancel(): void { ($this->unsubscribeCallback)(); } } applyUri($uri); } public function getConnectUri(): string { return $this->uri; } public function getTimeout(): int { return $this->timeout; } public function getPassword(): string { return $this->password; } public function hasPassword(): bool { return $this->password !== ''; } public function getDatabase(): int { return $this->database; } public function withTimeout(int $timeout): self { $clone = clone $this; $clone->timeout = $timeout; return $clone; } public function withPassword(string $password): self { $clone = clone $this; $clone->password = $password; return $clone; } public function withDatabase(int $database): self { $clone = clone $this; $clone->database = $database; return $clone; } /** * When using the "redis" schemes the URI is parsed according to the rules defined by the provisional registration * documents approved by IANA. If the URI has a password in its "user-information" part or a database number in the * "path" part these values override the values of "password" / "database" if they are present in the "query" part. * * @link http://www.iana.org/assignments/uri-schemes/prov/redis * * @param string $uri URI string. * * @throws RedisException */ private function applyUri(string $uri): void { if ($uri === 'redis://') { $uri = 'redis://' . self::DEFAULT_HOST . ':' . self::DEFAULT_PORT; } try { $parsedUri = parse($uri); } catch (\Exception $exception) { throw new RedisException('Invalid redis configuration URI: ' . $uri); } \parse_str($parsedUri['query'] ?? '', $query); switch (\strtolower($parsedUri['scheme'])) { case 'tcp': $this->uri = 'tcp://' . \strtolower($parsedUri['host']) . ':' . (int) $parsedUri['port']; $this->database = (int) ($query['database'] ?? $query['db'] ?? 0); $this->password = $query['password'] ?? $query['pass'] ?? ''; break; case 'unix': $this->uri = 'unix://' . $parsedUri['path']; $this->database = (int) ($query['database'] ?? $query['db'] ?? 0); $this->password = $query['password'] ?? $query['pass'] ?? ''; break; case 'redis': $host = \strtolower($parsedUri['host'] ?? self::DEFAULT_HOST); $port = (int) ($parsedUri['port'] ?? self::DEFAULT_PORT); if ($host === '') { $host = self::DEFAULT_HOST; } if ($port === 0) { $port = self::DEFAULT_PORT; } $this->uri = 'tcp://' . $host . ':' . $port; if (\ltrim($parsedUri['path'], '/') !== '') { $this->database = (int) \ltrim($parsedUri['path'], '/'); } else { $this->database = (int) ($query['db'] ?? 0); } if (isset($parsedUri['pass']) && $parsedUri['pass'] !== '') { $this->password = $parsedUri['pass']; } else { $this->password = $query['password'] ?? ''; } break; } $this->timeout = (int) ($query['timeout'] ?? $this->timeout); } } queryExecutor = $queryExecutor; $this->key = $key; } /** * @param string $field * @param string ...$fields * * @return Promise * * @link https://redis.io/commands/hdel */ public function remove(string $field, string ...$fields): Promise { return $this->queryExecutor->execute(\array_merge(['hdel', $this->key, $field], $fields)); } /** * @param string $field * * @return Promise * * @link https://redis.io/commands/hexists */ public function hasKey(string $field): Promise { return $this->queryExecutor->execute(['hexists', $this->key, $field], toBool); } /** * @param string $field * @param int $increment * * @return Promise * * @link https://redis.io/commands/hincrby */ public function increment(string $field, int $increment = 1): Promise { return $this->queryExecutor->execute(['hincrby', $this->key, $field, $increment]); } /** * @param string $field * @param float $increment * * @return Promise * * @link https://redis.io/commands/hincrbyfloat */ public function incrementByFloat(string $field, float $increment): Promise { return $this->queryExecutor->execute(['hincrbyfloat', $this->key, $field, $increment], toFloat); } /** * @return Promise * * @link https://redis.io/commands/hkeys */ public function getKeys(): Promise { return $this->queryExecutor->execute(['hkeys', $this->key]); } /** * @return Promise * * @link https://redis.io/commands/hlen */ public function getSize(): Promise { return $this->queryExecutor->execute(['hlen', $this->key]); } /** * @return Promise * * @link https://redis.io/commands/hvals * @link https://redis.io/commands/hgetall */ public function getAll(): Promise { return $this->queryExecutor->execute(['hgetall', $this->key], toMap); } /** * @param array $data * * @return Promise * * @link https://redis.io/commands/hmset */ public function setValues(array $data): Promise { $array = ['hmset', $this->key]; foreach ($data as $dataKey => $value) { $array[] = $dataKey; $array[] = $value; } return $this->queryExecutor->execute($array, toNull); } /** * @param string $field * * @return Promise * * @link https://redis.io/commands/hget */ public function getValue(string $field): Promise { return $this->queryExecutor->execute(['hget', $this->key, $field]); } /** * @param string $field * @param string ...$fields * * @return Promise * * @link https://redis.io/commands/hmget */ public function getValues(string $field, string ...$fields): Promise { return $this->queryExecutor->execute(\array_merge(['hmget', $this->key, $field], $fields)); } /** * @param string $field * @param string $value * * @return Promise * * @link https://redis.io/commands/hset */ public function setValue(string $field, string $value): Promise { return $this->queryExecutor->execute(['hset', $this->key, $field, $value], toBool); } /** * @param string $field * @param string $value * * @return Promise * * @link https://redis.io/commands/hsetnx */ public function setValueWithoutOverwrite(string $field, string $value): Promise { return $this->queryExecutor->execute(['hsetnx', $this->key, $field, $value], toBool); } /** * @param string $field * * @return Promise * * @link https://redis.io/commands/hstrlen */ public function getLength(string $field): Promise { return $this->queryExecutor->execute(['hstrlen', $this->key, $field]); } /** * @param string|null $pattern * @param int|null $count * * @return Iterator * * @link https://redis.io/commands/hscan */ public function scan(?string $pattern = null, ?int $count = null): Iterator { return new Producer(function (callable $emit) use ($pattern, $count) { $cursor = 0; do { $query = ['HSCAN', $this->key, $cursor]; if ($pattern !== null) { $query[] = 'MATCH'; $query[] = $pattern; } if ($count !== null) { $query[] = 'COUNT'; $query[] = $count; } [$cursor, $keys] = yield $this->queryExecutor->execute($query); $count = \count($keys); \assert($count % 2 === 0); for ($i = 0; $i < $count; $i += 2) { yield $emit([$keys[$i], $keys[$i + 1]]); } } while ($cursor !== '0'); }); } } * * @throws RedisException */ function connect(Config $config, ?Socket\Connector $connector = null): Promise { return call(static function () use ($config, $connector) { try { $connectContext = (new ConnectContext)->withConnectTimeout($config->getTimeout()); $resp = new RespSocket( yield ($connector ?? Socket\connector())->connect($config->getConnectUri(), $connectContext) ); } catch (Socket\SocketException $e) { throw new SocketException( 'Failed to connect to redis instance (' . $config->getConnectUri() . ')', 0, $e ); } $promises = []; if ($config->hasPassword()) { // pipeline, don't await $promises[] = $resp->write('AUTH', $config->getPassword()); } if ($config->getDatabase() !== 0) { // pipeline, don't await $promises[] = $resp->write('SELECT', $config->getDatabase()); } foreach ($promises as $promise) { yield $promise; if ([$response] = yield $resp->read()) { if ($response instanceof \Throwable) { throw $response; } } else { throw new RedisException('Failed to connect to redis instance (' . $config->getConnectUri() . ')'); } } return $resp; }); } config = $config; $this->database = $config->getDatabase(); $this->connector = $connector ?? Socket\connector(); } /** * @param string[] $args * @param callable $transform * * @return Promise */ public function execute(array $args, callable $transform = null): Promise { return call(function () use ($args, $transform) { $command = \strtolower($args[0] ?? ''); $connectPromise = $this->connect(); if ($command === 'quit') { $this->connect = null; } /** @var RespSocket $resp */ $resp = yield $connectPromise; $response = yield $this->enqueue($resp, ...$args); if ($command === 'select') { $this->database = (int) $args[1]; } return $transform ? $transform($response) : $response; }); } private function enqueue(RespSocket $resp, string... $args): Promise { return call(function () use ($resp, $args) { $deferred = new Deferred; $this->queue[] = $deferred; $resp->reference(); try { yield $resp->write(...$args); } catch (Socket\SocketException | StreamException $exception) { throw new SocketException($exception); } return $deferred->promise(); }); } private function connect(): Promise { if ($this->connect) { return $this->connect; } return $this->connect = call(function () { try { /** @var RespSocket $resp */ $resp = yield connect($this->config->withDatabase($this->database), $this->connector); } catch (\Throwable $connectException) { yield delay(0); // ensure $this->connect is already assigned above in case of immediate failure $this->connect = null; throw $connectException; } asyncCall(function () use ($resp) { try { while ([$response] = yield $resp->read()) { $deferred = \array_shift($this->queue); if (!$this->queue) { $resp->unreference(); } if ($response instanceof \Throwable) { $deferred->fail($response); } else { $deferred->resolve($response); } } throw new SocketException('Socket to redis instance (' . $this->config->getConnectUri() . ') closed unexpectedly'); } catch (\Throwable $error) { $queue = $this->queue; $this->queue = []; $this->connect = null; while ($queue) { $deferred = \array_shift($queue); $deferred->fail($error); } } }); return $resp; }); } } keyPrefix; } public function getLockExpiration(): int { return $this->lockExpiration; } public function getLockRenewInterval(): int { return $this->lockRenewInterval; } public function getLockTimeout(): int { return $this->lockTimeout; } public function withKeyPrefix(string $keyPrefix): self { $clone = clone $this; $clone->keyPrefix = $keyPrefix; return $clone; } public function withLockExpiration(int $lockExpiration): self { $clone = clone $this; $clone->lockExpiration = $lockExpiration; return $clone; } public function withLockRenewInterval(int $lockRenewInterval): self { $clone = clone $this; $clone->lockRenewInterval = $lockRenewInterval; return $clone; } public function withLockTimeout(int $lockTimeout): self { $clone = clone $this; $clone->lockTimeout = $lockTimeout; return $clone; } } */ final class Mutex implements KeyedMutex { private const LOCK = <<options = $options ?? new MutexOptions; $this->sharedConnection = new Redis($queryExecutorFactory->createQueryExecutor()); $this->logger = $logger ?? new NullLogger; } public function __destruct() { if (isset($this->watcher)) { Loop::cancel($this->watcher); } } /** * Acquires a lock. * * If directly acquiring a lock fails, the client is placed in a queue and reattempts to lock the key. If a client * crashes or doesn't free the lock while not renewing it, the lock will expire and the next client in the queue * will be able to acquire it. * * @param string $key Lock key. * * @return Promise Resolves to an instance of `Lock`. */ public function acquire(string $key): Promise { return call(function () use ($key) { $this->numberOfLocks++; $token = \base64_encode(\random_bytes(16)); $prefix = $this->options->getKeyPrefix(); $timeLimit = \microtime(true) * 1000 + $this->options->getLockTimeout(); $attempts = 0; do { $attempts++; $this->numberOfAttempts++; $result = yield $this->sharedConnection->eval( self::LOCK, ["{$prefix}lock:{$key}", "{$prefix}lock-queue:{$key}"], [$token, $this->options->getLockExpiration(), $this->options->getLockExpiration() + $this->options->getLockTimeout()] ); if ($result < 1) { if ($attempts > 2 && \microtime(true) * 1000 > $timeLimit) { // In very rare cases we might not get the lock, but are at the head of the queue and another // client moves us into the lock position. Deleting the token from the queue and afterwards // unlocking solves this. No yield required, because we use the same connection. $this->sharedConnection->getList("{$prefix}lock-queue:{$key}")->remove($token); Promise\rethrow($this->unlock($key, $token)); throw new LockException('Failed to acquire lock for ' . $key . ' within ' . $this->options->getLockTimeout() . ' ms'); } // A negative integer as reply means we're still in the queue and indicates the queue position. // Making the timing dependent on the queue position greatly reduces CPU usage and locking attempts. yield delay(5 + \min((-$result - 1) * 10, 300)); } } while ($result < 1); if (empty($this->locks)) { $this->createRenewWatcher(); } $this->locks[$key . ' @ ' . $token] = [$key, $token]; return new Lock(0, function () use ($key, $token) { Promise\rethrow($this->unlock($key, $token)); }); }); } public function getNumberOfAttempts(): int { return $this->numberOfAttempts; } public function getNumberOfLocks(): int { return $this->numberOfLocks; } public function resetStatistics(): void { $this->numberOfAttempts = 0; $this->numberOfLocks = 0; } /** * Unlocks a previously acquired lock. * * @param string $key Lock key. * @param string $token Unique token generated during {@link lock()}. * * @return Promise Fails if lock couldn't be unlocked, otherwise resolves normally. */ private function unlock(string $key, string $token): Promise { return call(function () use ($key, $token) { // Unset before unlocking, as we don't want to renew the lock anymore // If something goes wrong, the lock will simply expire unset($this->locks[$key . ' @ ' . $token]); if (empty($this->locks) && $this->watcher !== null) { Loop::cancel($this->watcher); $this->watcher = null; } $prefix = $this->options->getKeyPrefix(); for ($attempt = 0; $attempt < 2; $attempt++) { try { $result = yield $this->sharedConnection->eval( self::UNLOCK, ["{$prefix}lock:{$key}"], [$token] ); if ($result === 2) { $this->logger->warning('Lock was already expired when unlocked', [ 'key' => $key, ]); } break; } catch (RedisException $e) { $this->logger->error('Unlock operation failed on attempt ' . ($attempt + 1), [ 'exception' => $e, ]); } } }); } private function createRenewWatcher(): void { $this->watcher = Loop::repeat($this->options->getLockRenewInterval(), function () { \assert(!empty($this->locks)); $keys = []; $arguments = [$this->options->getLockExpiration()]; $prefix = $this->options->getKeyPrefix(); foreach ($this->locks as [$key, $token]) { $keys[] = "{$prefix}lock:{$key}"; $arguments[] = $token; } try { yield $this->sharedConnection->eval(self::RENEW, $keys, $arguments); } catch (RedisException $e) { $this->logger->error('Renew operation failed, locks might expire', [ 'exception' => $e, ]); } }); } } redis = $redis; } /** @inheritdoc */ public function get(string $key): Promise { return call(function () use ($key) { try { return yield $this->redis->get($key); } catch (RedisException $e) { throw new CacheException("Fetching '${key}' from cache failed", 0, $e); } }); } /** @inheritdoc */ public function set(string $key, string $value, int $ttl = null): Promise { if ($ttl !== null && $ttl < 0) { throw new \Error('Invalid TTL: ' . $ttl); } if ($ttl === 0) { return new Success; // expires immediately } return call(function () use ($key, $value, $ttl) { try { $options = new SetOptions; if ($ttl !== null) { $options = $options->withTtl($ttl); } return yield $this->redis->set($key, $value, $options); } catch (RedisException $e) { throw new CacheException("Storing '{$key}' to cache failed", 0, $e); } }); } /** @inheritdoc */ public function delete(string $key): Promise { return call(function () use ($key) { try { return yield $this->redis->delete($key); } catch (RedisException $e) { throw new CacheException("Deleting '{$key}' from cache failed", 0, $e); } }); } } queryExecutor = $queryExecutor; $this->key = $key; } /** * @param string $index * * @return Promise * * @link https://redis.io/commands/lindex */ public function get(string $index): Promise { return $this->queryExecutor->execute(['lindex', $this->key, $index]); } /** * @param string $pivot * @param string $value * * @return Promise * * @link https://redis.io/commands/linsert */ public function insertBefore(string $pivot, string $value): Promise { return $this->queryExecutor->execute(['linsert', $this->key, 'BEFORE', $pivot, $value]); } /** * @param string $pivot * @param string $value * * @return Promise * * @link https://redis.io/commands/linsert */ public function insertAfter(string $pivot, string $value): Promise { return $this->queryExecutor->execute(['linsert', $this->key, 'AFTER', $pivot, $value]); } /** * @return Promise * * @link https://redis.io/commands/llen */ public function getSize(): Promise { return $this->queryExecutor->execute(['llen', $this->key]); } /** * @param string $value * @param string ...$values * * @return Promise * * @link https://redis.io/commands/lpush */ public function pushHead(string $value, string ...$values): Promise { return $this->queryExecutor->execute(\array_merge(['lpush', $this->key, $value], $values)); } /** * @param string $value * @param string ...$values * * @return Promise * * @link https://redis.io/commands/lpushx */ public function pushHeadIfExists(string $value, string ...$values): Promise { return $this->queryExecutor->execute(\array_merge(['lpushx', $this->key, $value], $values)); } /** * @param string $value * @param string ...$values * * @return Promise * * @link https://redis.io/commands/rpush */ public function pushTail(string $value, string ...$values): Promise { return $this->queryExecutor->execute(\array_merge(['rpush', $this->key, $value], $values)); } /** * @param string $value * @param string ...$values * * @return Promise * * @link https://redis.io/commands/rpushx */ public function pushTailIfExists(string $value, string ...$values): Promise { return $this->queryExecutor->execute(\array_merge(['rpushx', $this->key, $value], $values)); } /** * @return Promise * * @link https://redis.io/commands/lpop */ public function popHead(): Promise { return $this->queryExecutor->execute(['lpop', $this->key]); } /** * @param int $timeout * * @return Promise * * @link https://redis.io/commands/blpop */ public function popHeadBlocking(int $timeout = 0): Promise { return $this->queryExecutor->execute(['blpop', $this->key, $timeout], static function ($response) { return $response[1] ?? null; }); } /** * @return Promise * * @link https://redis.io/commands/rpop */ public function popTail(): Promise { return $this->queryExecutor->execute(['rpop', $this->key]); } /** * @param int $timeout * * @return Promise * * @link https://redis.io/commands/brpop */ public function popTailBlocking(int $timeout = 0): Promise { return $this->queryExecutor->execute(['brpop', $this->key, $timeout], static function ($response) { return $response[1] ?? null; }); } /** * @param string $destination * * @return Promise * * @link https://redis.io/commands/rpoplpush */ public function popTailPushHead(string $destination): Promise { return $this->queryExecutor->execute(['rpoplpush', $this->key, $destination]); } /** * @param string $destination * @param int $timeout * * @return Promise * * @link https://redis.io/commands/brpoplpush */ public function popTailPushHeadBlocking(string $destination, int $timeout = 0): Promise { return $this->queryExecutor->execute(['brpoplpush', $this->key, $destination, $timeout]); } /** * @param int $start * @param int $end * * @return Promise * * @link https://redis.io/commands/lrange */ public function getRange(int $start = 0, int $end = -1): Promise { return $this->queryExecutor->execute(['lrange', $this->key, $start, $end]); } /** * @param string $value * @param int $count * * @return Promise * * @link https://redis.io/commands/lrem */ public function remove(string $value, int $count = 0): Promise { return $this->queryExecutor->execute(['lrem', $this->key, $count, $value]); } /** * @param int $index * @param string $value * * @return Promise * * @link https://redis.io/commands/lset */ public function set(int $index, string $value): Promise { return $this->queryExecutor->execute(['lset', $this->key, $index, $value], toNull); } /** * @param int $start * @param int $stop * * @return Promise * * @link https://redis.io/commands/ltrim */ public function trim(int $start = 0, int $stop = -1): Promise { return $this->queryExecutor->execute(['ltrim', $this->key, $start, $stop], toNull); } /** * @param SortOptions $sort * * @return Promise * * @link https://redis.io/commands/sort */ public function sort(?SortOptions $sort = null): Promise { return $this->queryExecutor->execute(\array_merge(['SORT', $this->key], ($sort ?? new SortOptions)->toQuery())); } } backpressure; $backpressure = new Success; $this->socket = $socket; $this->iterator = $emitter->iterate(); $this->parser = new RespParser(static function ($message) use ($emitter, &$backpressure) { $backpressure = $emitter->emit($message); }); asyncCall(function () use ($socket, $emitter) { try { while (null !== $chunk = yield $socket->read()) { $this->parser->append($chunk); yield $this->backpressure; } $emitter->fail(new ClosedException('Socket closed')); } catch (\Throwable $e) { if ($this->error === null) { $this->error = $e; } $emitter->fail($e); } $this->close(); }); } public function read(): Promise { return call(function () { if (yield $this->iterator->advance()) { return [$this->iterator->getCurrent()]; } return null; }); } public function write(string ...$args): Promise { return call(function () use ($args) { if ($this->error) { throw $this->error; } if ($this->socket === null) { throw new ClosedException('Redis connection already closed'); } $payload = ''; foreach ($args as $arg) { $payload .= '$' . \strlen($arg) . "\r\n{$arg}\r\n"; } $payload = '*' . \count($args) . "\r\n{$payload}"; yield $this->socket->write($payload); }); } public function reference(): void { if ($this->socket) { $this->socket->reference(); } } public function unreference(): void { if ($this->socket) { $this->socket->unreference(); } } public function close(): void { if ($this->parser) { $this->parser->reset(); } if ($this->socket) { $this->socket->close(); $this->socket = null; } } public function isClosed(): bool { return $this->socket === null; } public function __destruct() { $this->close(); } } config = $config; $this->connector = $connector ?? Socket\connector(); } public function createQueryExecutor(): QueryExecutor { return new RemoteExecutor($this->config, $this->connector); } } ttl = $seconds; $clone->ttlUnit = 'EX'; return $clone; } public function withTtlInMillis(int $millis): self { $clone = clone $this; $clone->ttl = $millis; $clone->ttlUnit = 'PX'; return $clone; } public function withoutOverwrite(): self { $clone = clone $this; $clone->existenceFlag = 'NX'; return $clone; } public function withoutCreation(): self { $clone = clone $this; $clone->existenceFlag = 'XX'; return $clone; } public function toQuery(): array { $query = []; if ($this->ttl !== null) { $query[] = $this->ttlUnit; $query[] = $this->ttl; } if ($this->existenceFlag !== null) { $query[] = $this->existenceFlag; } return $query; } } pattern !== null; } public function getPattern(): ?string { return $this->pattern; } public function withPattern(string $pattern): self { $clone = clone $this; $clone->pattern = $pattern; return $clone; } public function withoutPattern(): self { $clone = clone $this; $clone->pattern = null; return $clone; } public function getOffset(): ?int { return $this->offset; } public function getCount(): ?int { return $this->count; } public function hasLimit(): bool { return $this->offset !== null; } public function withLimit(int $offset, int $count): self { $clone = clone $this; $clone->offset = $offset; $clone->count = $count; return $clone; } public function withoutLimit(): self { $clone = clone $this; $clone->offset = null; $clone->count = null; return $clone; } public function isAscending(): bool { return $this->ascending; } public function isDescending(): bool { return !$this->ascending; } public function withAscendingOrder(): self { $clone = clone $this; $clone->ascending = true; return $clone; } public function withDescendingOrder(): self { $clone = clone $this; $clone->ascending = false; return $clone; } public function isLexicographicSorting(): bool { return $this->lexicographically; } public function withLexicographicSorting(): self { $clone = clone $this; $clone->lexicographically = true; return $clone; } public function withNumericSorting(): self { $clone = clone $this; $clone->lexicographically = false; return $clone; } public function toQuery(): array { $payload = []; if ($this->hasPattern()) { $payload[] = 'BY'; $payload[] = $this->getPattern(); } if ($this->hasLimit()) { $payload[] = 'LIMIT'; $payload[] = $this->getOffset(); $payload[] = $this->getCount(); } if ($this->isDescending()) { $payload[] = 'DESC'; } if ($this->isLexicographicSorting()) { $payload[] = 'ALPHA'; } return $payload; } } config = $config; } /** * @param string $channel * * @return Promise */ public function subscribe(string $channel): Promise { return call(function () use ($channel) { $emitter = new Emitter; $this->emitters[$channel][\spl_object_hash($emitter)] = $emitter; try { /** @var RespSocket $resp */ $resp = yield $this->connect(); $resp->reference(); yield $resp->write('subscribe', $channel); } catch (\Throwable $e) { $this->unloadEmitter($emitter, $channel); throw $e; } return new Subscription($emitter->iterate(), function () use ($emitter, $channel) { $this->unloadEmitter($emitter, $channel); }); }); } /** * @param string $pattern * * @return Promise */ public function subscribeToPattern(string $pattern): Promise { return call(function () use ($pattern) { $emitter = new Emitter; $this->patternEmitters[$pattern][\spl_object_hash($emitter)] = $emitter; try { /** @var RespSocket $resp */ $resp = yield $this->connect(); $resp->reference(); yield $resp->write('psubscribe', $pattern); } catch (\Throwable $e) { $this->unloadPatternEmitter($emitter, $pattern); throw $e; } return new Subscription($emitter->iterate(), function () use ($emitter, $pattern) { $this->unloadPatternEmitter($emitter, $pattern); }); }); } private function connect(): Promise { if ($this->connect) { return $this->connect; } return $this->connect = call(function () { try { /** @var RespSocket $resp */ $resp = yield connect($this->config); } catch (\Throwable $connectException) { yield delay(0); // ensure $this->connect is already assigned above in case of immediate failure $this->connect = null; throw $connectException; } asyncCall(function () use ($resp) { try { while ([$response] = yield $resp->read()) { switch ($response[0]) { case 'message': $backpressure = []; foreach ($this->emitters[$response[1]] as $emitter) { $backpressure[] = $emitter->emit($response[2]); } yield Promise\any($backpressure); break; case 'pmessage': $backpressure = []; foreach ($this->patternEmitters[$response[1]] as $emitter) { $backpressure[] = $emitter->emit([$response[3], $response[2]]); } yield Promise\any($backpressure); break; } } throw new SocketException('Socket to redis instance (' . $this->config->getConnectUri() . ') closed unexpectedly'); } catch (\Throwable $error) { $emitters = \array_merge($this->emitters, $this->patternEmitters); $this->connect = null; $this->emitters = []; $this->patternEmitters = []; foreach ($emitters as $emitterGroup) { foreach ($emitterGroup as $emitter) { $emitter->fail($error); } } } }); return $resp; }); } private function isIdle(): bool { return !$this->emitters && !$this->patternEmitters; } private function unloadEmitter(Emitter $emitter, string $channel): void { $hash = \spl_object_hash($emitter); if (isset($this->emitters[$channel][$hash])) { unset($this->emitters[$channel][$hash]); $emitter->complete(); if (empty($this->emitters[$channel])) { unset($this->emitters[$channel]); asyncCall(function () use ($channel) { try { /** @var RespSocket $resp */ $resp = yield $this->connect(); if (empty($this->emitters[$channel])) { $resp->reference(); yield $resp->write('unsubscribe', $channel); } if ($this->isIdle()) { $resp->unreference(); } } catch (RedisException $exception) { // if there's an exception, the unsubscribe is implicitly successful, because the connection broke } }); } } } private function unloadPatternEmitter(Emitter $emitter, string $pattern): void { $hash = \spl_object_hash($emitter); if (isset($this->patternEmitters[$pattern][$hash])) { unset($this->patternEmitters[$pattern][$hash]); $emitter->complete(); if (empty($this->patternEmitters[$pattern])) { unset($this->patternEmitters[$pattern]); asyncCall(function () use ($pattern) { try { /** @var RespSocket $resp */ $resp = yield $this->connect(); if (empty($this->patternEmitters[$pattern])) { $resp->reference(); yield $resp->write('punsubscribe', $pattern); } if ($this->isIdle()) { $resp->unreference(); } } catch (RedisException $exception) { // if there's an exception, the unsubscribe is implicitly successful, because the connection broke } }); } } } } responseCallback = $responseCallback; } public function reset(): void { $this->buffer = ''; $this->currentResponse = null; $this->arrayStack = null; $this->currentSize = null; $this->arraySizes = null; } public function append(string $str): void { $this->buffer .= $str; do { $type = $this->buffer[0]; $pos = \strpos($this->buffer, self::CRLF); if ($pos === false) { return; } switch ($type) { case self::TYPE_SIMPLE_STRING: case self::TYPE_INTEGER: case self::TYPE_ARRAY: case self::TYPE_ERROR: $payload = \substr($this->buffer, 1, $pos - 1); $remove = $pos + 2; break; case self::TYPE_BULK_STRING: $length = (int) \substr($this->buffer, 1, $pos); if ($length === -1) { $payload = null; $remove = $pos + 2; } else { if (\strlen($this->buffer) < $pos + $length + 4) { return; } $payload = \substr($this->buffer, $pos + 2, $length); $remove = $pos + $length + 4; } break; default: throw new ParserException( \sprintf('unknown resp data type: %s', $type) ); } $this->buffer = \substr($this->buffer, $remove); switch ($type) { case self::TYPE_INTEGER: case self::TYPE_ARRAY: $payload = (int) $payload; break; case self::TYPE_ERROR: $payload = new QueryException($payload); break; default: break; } if ($this->currentResponse !== null) { // extend array response if ($type === self::TYPE_ARRAY) { if ($payload >= 0) { $this->arraySizes[] = $this->currentSize; $this->arrayStack[] = &$this->currentResponse; $this->currentSize = $payload + 1; $this->currentResponse[] = []; $this->currentResponse = &$this->currentResponse[\sizeof($this->currentResponse) - 1]; } else { $this->currentResponse[] = null; } } else { $this->currentResponse[] = $payload; } while (--$this->currentSize === 0) { if (\count($this->arrayStack) === 0) { $cb = $this->responseCallback; $cb($this->currentResponse); $this->currentResponse = null; break; } // index doesn't start at 0 :( \end($this->arrayStack); $key = \key($this->arrayStack); $this->currentResponse = &$this->arrayStack[$key]; $this->currentSize = \array_pop($this->arraySizes); unset($this->arrayStack[$key]); } } elseif ($type === self::TYPE_ARRAY) { // start new array response if ($payload > 0) { $this->currentSize = $payload; $this->arrayStack = $this->arraySizes = $this->currentResponse = []; } elseif ($payload === 0) { $cb = $this->responseCallback; $cb([]); } else { $cb = $this->responseCallback; $cb(null); } } else { // single data type response $cb = $this->responseCallback; $cb($payload); } } while (isset($this->buffer[0])); } } queryExecutor = $queryExecutor; $this->key = $key; } /** * @param string $member * @param string ...$members * * @return Promise */ public function add(string $member, string ...$members): Promise { return $this->queryExecutor->execute(\array_merge(['sadd', $this->key, $member], $members)); } /** * @return Promise */ public function getSize(): Promise { return $this->queryExecutor->execute(['scard', $this->key]); } /** * @param string ...$keys * * @return Promise */ public function diff(string ...$keys): Promise { return $this->queryExecutor->execute(\array_merge(['sdiff', $this->key], $keys)); } /** * @param string $key * @param string ...$keys * * @return Promise */ public function storeDiff(string $key, string ...$keys): Promise { return $this->queryExecutor->execute(\array_merge(['sdiffstore', $this->key, $key], $keys)); } /** * @param string ...$keys * * @return Promise */ public function intersect(string ...$keys): Promise { return $this->queryExecutor->execute(\array_merge(['sinter', $this->key], $keys)); } /** * @param string $key * @param string ...$keys * * @return Promise */ public function storeIntersection(string $key, string ...$keys): Promise { return $this->queryExecutor->execute(\array_merge(['sinterstore', $this->key, $key], $keys)); } /** * @param string $member * * @return Promise */ public function contains(string $member): Promise { return $this->queryExecutor->execute(['sismember', $this->key, $member], toBool); } /** * @return Promise */ public function getAll(): Promise { return $this->queryExecutor->execute(['smembers', $this->key]); } /** * @param string $member * @param string $destination * * @return Promise */ public function move(string $member, string $destination): Promise { return $this->queryExecutor->execute(['smove', $this->key, $destination, $member], toBool); } /** * @return Promise */ public function popRandomMember(): Promise { return $this->queryExecutor->execute(['spop', $this->key]); } /** * @return Promise */ public function getRandomMember(): Promise { return $this->queryExecutor->execute(['srandmember', $this->key]); } /** * @param int $count * * @return Promise */ public function getRandomMembers(int $count): Promise { return $this->queryExecutor->execute(['srandmember', $this->key, $count]); } /** * @param string $member * @param string ...$members * * @return Promise */ public function remove(string $member, string ...$members): Promise { return $this->queryExecutor->execute(\array_merge(['srem', $this->key, $member], $members)); } /** * @param string ...$keys * * @return Promise */ public function union(string ...$keys): Promise { return $this->queryExecutor->execute(\array_merge(['sunion', $this->key], $keys)); } /** * @param string $key * @param string ...$keys * * @return Promise */ public function storeUnion(string $key, string ...$keys): Promise { return $this->queryExecutor->execute(\array_merge(['sunionstore', $this->key, $key], $keys)); } /** * @param string $pattern * @param int $count * * @return Iterator */ public function scan(?string $pattern = null, ?int $count = null): Iterator { return new Producer(function (callable $emit) use ($pattern, $count) { $cursor = 0; do { $query = ['SSCAN', $this->key, $cursor]; if ($pattern !== null) { $query[] = 'MATCH'; $query[] = $pattern; } if ($count !== null) { $query[] = 'COUNT'; $query[] = $count; } [$cursor, $keys] = yield $this->queryExecutor->execute($query); foreach ($keys as $key) { yield $emit($key); } } while ($cursor !== '0'); }); } /** * @param SortOptions $sort * * @return Promise * * @link https://redis.io/commands/sort */ public function sort(?SortOptions $sort = null): Promise { return $this->queryExecutor->execute(\array_merge(['SORT', $this->key], ($sort ?? new SortOptions)->toQuery())); } } expectException(\Error::class); $this->expectExceptionMessage('Pool must contain at least one connection'); $this->getMockBuilder(ConnectionPool::class) ->setConstructorArgs([$this->createMock(ConnectionConfig::class), 0]) ->getMock(); } private function createConnector(): Connector { $now = \time(); $connector = $this->createMock(Connector::class); $connector->method('connect') ->willReturnCallback(function () use ($now): Promise { $link = $this->createMock(Link::class); $link->method('getLastUsedAt') ->willReturn($now); $link->method('isAlive') ->willReturn(true); $link->method('query') ->willReturnCallback(function () { return new Delayed(100, $this->createMock(CommandResult::class)); }); return new Success($link); }); return $connector; } private function createPool(Connector $connector, int $maxConnections = 100, int $idleTimeout = 10): ConnectionPool { return $this->getMockBuilder(ConnectionPool::class) ->setConstructorArgs([ $this->createMock(ConnectionConfig::class), $maxConnections, $idleTimeout, $connector ]) ->getMockForAbstractClass(); } public function testIdleConnectionsRemovedAfterTimeout(): \Generator { $connector = $this->createConnector(); $pool = $this->createPool($connector, 10, 2); $count = 3; $promises = []; for ($i = 0; $i < $count; ++$i) { $promises[] = $pool->query("SELECT $i"); } $this->assertCount($count, yield $promises); $this->assertSame($count, $pool->getConnectionCount()); yield new Delayed(1000); $this->assertSame($count, $pool->getConnectionCount()); yield new Delayed(1000); $this->assertSame(0, $pool->getConnectionCount()); } public function testMaxConnectionCount(): \Generator { $connector = $this->createConnector(); $pool = $this->createPool($connector, $maxConnections = 3); $count = 10; $promises = []; for ($i = 0; $i < $count; ++$i) { $promises[] = $pool->query("SELECT $i"); } $this->assertSame($maxConnections, $pool->getConnectionCount()); $expectedRuntime = 100 * \ceil($count / $maxConnections); $this->setMinimumRuntime($expectedRuntime); $this->setTimeout($expectedRuntime + 100); $this->assertCount($count, yield $promises); } } createMock(ResultSet::class); $result->method('advance') ->willReturnOnConsecutiveCalls(new Success(true), new Success(false)); $result = new PooledResultSet($result, $release); $this->assertTrue(yield $result->advance()); $this->assertFalse($invoked); $this->assertFalse(yield $result->advance()); $this->assertTrue($invoked); } } createMock(Pool::class); $pool->method('isAlive') ->willReturn(true); $pool->method('getIdleTimeout') ->willReturn(60); $statement = $this->createMock(Statement::class); $statement->method('isAlive') ->willReturn(true); $statement->method('getQuery') ->willReturn('SELECT 1'); $statement->method('getLastUsedAt') ->willReturn(\time()); $statement->expects($this->once()) ->method('execute'); /** @var StatementPool $statementPool */ $statementPool = $this->getMockBuilder(StatementPool::class) ->setConstructorArgs([$pool, $statement, $this->createCallback(0)]) ->getMockForAbstractClass(); $statementPool->method('prepare') ->willReturnCallback(function (Statement $statement) { return new Success($statement); }); $this->assertTrue($statementPool->isAlive()); $this->assertSame(\time(), $statementPool->getLastUsedAt()); yield new Delayed(1500); // Give timeout watcher enough time to execute. $statementPool->execute(); $this->assertTrue($statementPool->isAlive()); $this->assertSame(\time(), $statementPool->getLastUsedAt()); } public function testIdleStatementsRemovedAfterTimeout(): \Generator { $pool = $this->createMock(Pool::class); $pool->method('isAlive') ->willReturn(true); $pool->method('getIdleTimeout') ->willReturn(1); $statement = $this->createMock(Statement::class); $statement->method('isAlive') ->willReturn(true); $statement->method('getQuery') ->willReturn('SELECT 1'); $statement->method('getLastUsedAt') ->willReturn(\time()); $statement->expects($this->once()) ->method('execute'); /** @var StatementPool $statementPool */ $statementPool = $this->getMockBuilder(StatementPool::class) ->setConstructorArgs([$pool, $statement, $this->createCallback(1)]) ->getMockForAbstractClass(); $statementPool->method('prepare') ->willReturnCallback(function (Statement $statement) { return new Success($statement); }); $this->assertTrue($statementPool->isAlive()); $this->assertSame(\time(), $statementPool->getLastUsedAt()); $statementPool->execute(); yield new Delayed(1500); // Give timeout watcher enough time to execute. $statementPool->execute(); $this->assertTrue($statementPool->isAlive()); $this->assertSame(\time(), $statementPool->getLastUsedAt()); } } createMock(Connector::class); $connector->expects($this->once()) ->method('connect') ->willReturn(new Success($this->createMock(Link::class))); $retry = new RetryConnector($connector); $config = $this->getMockBuilder(ConnectionConfig::class) ->setConstructorArgs(['localhost', 5432]) ->getMockForAbstractClass(); $connection = yield $retry->connect($config); $this->assertInstanceOf(Link::class, $connection); } public function testFirstTryFailConnect(): \Generator { $connector = $this->createMock(Connector::class); $connector->expects($this->exactly(2)) ->method('connect') ->willReturnOnConsecutiveCalls( new Failure(new ConnectionException), new Success($this->createMock(Link::class)) ); $retry = new RetryConnector($connector); $config = $this->getMockBuilder(ConnectionConfig::class) ->setConstructorArgs(['localhost', 5432]) ->getMockForAbstractClass(); $connection = yield $retry->connect($config); $this->assertInstanceOf(Link::class, $connection); } public function testFailingConnect(): \Generator { $tries = 3; $connector = $this->createMock(Connector::class); $connector->expects($this->exactly($tries)) ->method('connect') ->willReturn(new Failure(new ConnectionException)); $retry = new RetryConnector($connector, $tries); $config = $this->getMockBuilder(ConnectionConfig::class) ->setConstructorArgs(['localhost', 5432]) ->getMockForAbstractClass(); $this->expectException(ConnectionException::class); $this->expectExceptionMessage('Could not connect to database server'); $connection = yield $retry->connect($config); } } { "name": "amphp/sql-common", "description": "Common classes for non-blocking SQL implementations.", "keywords": [ "database", "db", "sql", "asynchronous", "async" ], "homepage": "http://amphp.org", "license": "MIT", "require": { "php": ">=7", "amphp/amp": "^2", "amphp/sql": "^1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "amphp/phpunit-util": "^1.3", "phpunit/phpunit": "^6 || ^7 || ^8 || ^9" }, "autoload": { "psr-4": { "Amp\\Sql\\Common\\": "src" } }, "autoload-dev": { "psr-4": { "Amp\\Sql\\Common\\Test\\": "test" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "php-cs-fixer fix -v --diff --dry-run", "cs-fix": "php-cs-fixer fix -v --diff", "test": "phpunit --coverage-text" } } statement = $statement; if (!$this->statement->isAlive()) { $release(); } else { $refCount = &$this->refCount; $this->release = static function () use (&$refCount, $release) { if (--$refCount === 0) { $release(); } }; } } public function __destruct() { if ($this->release) { ($this->release)(); } } public function execute(array $params = []): Promise { return call(function () use ($params) { $result = yield $this->statement->execute($params); if ($result instanceof ResultSet) { ++$this->refCount; return $this->createResultSet($result, $this->release); } return $result; }); } public function isAlive(): bool { return $this->statement->isAlive(); } public function getQuery(): string { return $this->statement->getQuery(); } public function getLastUsedAt(): int { return $this->statement->getLastUsedAt(); } } connector = $connector; $this->maxTries = $maxTries; } public function connect(ConnectionConfig $config): Promise { return call(function () use ($config) { $tries = 0; $exceptions = []; do { try { return yield $this->connector->connect($config); } catch (\Exception $exception) { $exceptions[] = $exception; } } while (++$tries < $this->maxTries); $name = $config->getHost() . ':' . $config->getPort(); throw new ConnectionException( "Could not connect to database server at {$name} after {$tries} tries", 0, new MultiReasonException($exceptions) ); }); } } connector = $connector ?? $this->createDefaultConnector(); $this->connectionConfig = $config; $this->idleTimeout = $idleTimeout; if ($this->idleTimeout < 1) { throw new \Error("The idle timeout must be 1 or greater"); } $this->maxConnections = $maxConnections; if ($this->maxConnections < 1) { throw new \Error("Pool must contain at least one connection"); } $this->connections = $connections = new \SplObjectStorage; $this->idle = $idle = new \SplQueue; $idleTimeout = &$this->idleTimeout; $this->timeoutWatcher = Loop::repeat(1000, static function () use (&$idleTimeout, $connections, $idle) { $now = \time(); while (!$idle->isEmpty()) { $connection = $idle->bottom(); \assert($connection instanceof Link); if ($connection->getLastUsedAt() + $idleTimeout > $now) { return; } // Close connection and remove it from the pool. $idle->shift(); $connections->detach($connection); $connection->close(); } }); Loop::unreference($this->timeoutWatcher); } public function __destruct() { Loop::cancel($this->timeoutWatcher); } public function getIdleTimeout(): int { return $this->idleTimeout; } public function getLastUsedAt(): int { // Simple implementation... can be improved if needed. $time = 0; foreach ($this->connections as $connection) { \assert($connection instanceof Link); if (($lastUsedAt = $connection->getLastUsedAt()) > $time) { $time = $lastUsedAt; } } return $time; } /** * @return bool */ public function isAlive(): bool { return !$this->closed; } /** * Close all connections in the pool. No further queries may be made after a pool is closed. */ public function close() { $this->closed = true; foreach ($this->connections as $connection) { $connection->close(); } $this->idle = new \SplQueue; if ($this->deferred instanceof Deferred) { $deferred = $this->deferred; $this->deferred = null; $deferred->fail(new FailureException("Connection pool closed")); } } /** * {@inheritdoc} */ public function extractConnection(): Promise { return call(function () { $connection = yield from $this->pop(); $this->connections->detach($connection); return $connection; }); } /** * {@inheritdoc} */ public function getConnectionCount(): int { return $this->connections->count(); } /** * {@inheritdoc} */ public function getIdleConnectionCount(): int { return $this->idle->count(); } /** * {@inheritdoc} */ public function getConnectionLimit(): int { return $this->maxConnections; } /** * @return \Generator * * @resolve Link * * @throws FailureException If creating a new connection fails. * @throws \Error If the pool has been closed. */ protected function pop(): \Generator { if ($this->closed) { throw new \Error("The pool has been closed"); } while ($this->promise !== null) { yield $this->promise; // Prevent simultaneous connection creation or waiting. } do { // While loop to ensure an idle connection is available after promises below are resolved. while ($this->idle->isEmpty()) { if ($this->connections->count() < $this->getConnectionLimit()) { // Max connection count has not been reached, so open another connection. try { $connection = yield $this->promise = $this->connector->connect($this->connectionConfig); if (!$connection instanceof Link) { throw new \Error(\sprintf( "%s::connect() must resolve to an instance of %s", \get_class($this->connector), Link::class )); } } finally { $this->promise = null; } $this->connections->attach($connection); return $connection; } // All possible connections busy, so wait until one becomes available. try { $this->deferred = new Deferred; // Connection will be pulled from $this->idle when promise is resolved. yield $this->promise = $this->deferred->promise(); } finally { $this->deferred = null; $this->promise = null; } } $connection = $this->idle->shift(); \assert($connection instanceof Link); if ($connection->isAlive()) { return $connection; } $this->connections->detach($connection); } while (!$this->closed); throw new FailureException("Pool closed before an active connection could be obtained"); } /** * @param Link $connection * * @throws \Error If the connection is not part of this pool. */ protected function push(Link $connection) { \assert(isset($this->connections[$connection]), 'Connection is not part of this pool'); if ($connection->isAlive()) { $this->idle->unshift($connection); } else { $this->connections->detach($connection); } if ($this->deferred instanceof Deferred) { $deferred = $this->deferred; $this->deferred = null; $deferred->resolve($connection); } } /** * {@inheritdoc} */ public function query(string $sql): Promise { return call(function () use ($sql) { $connection = yield from $this->pop(); \assert($connection instanceof Link); try { $result = yield $connection->query($sql); } catch (\Throwable $exception) { $this->push($connection); throw $exception; } if ($result instanceof ResultSet) { $result = $this->createResultSet($result, function () use ($connection) { $this->push($connection); }); } else { $this->push($connection); } return $result; }); } /** * {@inheritdoc} */ public function execute(string $sql, array $params = []): Promise { return call(function () use ($sql, $params) { $connection = yield from $this->pop(); \assert($connection instanceof Link); try { $result = yield $connection->execute($sql, $params); } catch (\Throwable $exception) { $this->push($connection); throw $exception; } if ($result instanceof ResultSet) { $result = $this->createResultSet($result, function () use ($connection) { $this->push($connection); }); } else { $this->push($connection); } return $result; }); } /** * {@inheritdoc} * * Prepared statements returned by this method will stay alive as long as the pool remains open. */ public function prepare(string $sql): Promise { return call(function () use ($sql) { $statement = yield from $this->prepareStatement($sql); return $this->createStatementPool( $this, $statement, coroutine($this->callableFromInstanceMethod("prepareStatement")) ); }); } /** * Prepares a new statement on an available connection. * * @param string $sql * * @return \Generator * * @throws FailureException */ private function prepareStatement(string $sql): \Generator { $connection = yield from $this->pop(); \assert($connection instanceof Link); try { $statement = yield $connection->prepare($sql); \assert($statement instanceof Statement); } catch (\Throwable $exception) { $this->push($connection); throw $exception; } return $this->createStatement($statement, function () use ($connection) { $this->push($connection); }); } /** * {@inheritdoc} */ public function beginTransaction(int $isolation = Transaction::ISOLATION_COMMITTED): Promise { return call(function () use ($isolation) { $connection = yield from $this->pop(); \assert($connection instanceof Link); try { $transaction = yield $connection->beginTransaction($isolation); \assert($transaction instanceof Transaction); } catch (\Throwable $exception) { $this->push($connection); throw $exception; } return $this->createTransaction($transaction, function () use ($connection) { $this->push($connection); }); }); } } transaction = $transaction; $this->release = $release; if (!$this->transaction->isActive()) { $release(); $this->transaction = null; } else { $refCount = &$this->refCount; $this->release = static function () use (&$refCount, $release) { if (--$refCount === 0) { $release(); } }; } } public function __destruct() { ($this->release)(); } public function query(string $sql): Promise { if (!$this->transaction) { throw new TransactionError("The transaction has been committed or rolled back"); } return call(function () use ($sql) { $result = yield $this->transaction->query($sql); if ($result instanceof ResultSet) { ++$this->refCount; return $this->createResultSet($result, $this->release); } return $result; }); } public function prepare(string $sql): Promise { if (!$this->transaction) { throw new TransactionError("The transaction has been committed or rolled back"); } return call(function () use ($sql) { $statement = yield $this->transaction->prepare($sql); ++$this->refCount; return $this->createStatement($statement, $this->release); }); } public function execute(string $sql, array $params = []): Promise { if (!$this->transaction) { throw new TransactionError("The transaction has been committed or rolled back"); } return call(function () use ($sql, $params) { $result = yield $this->transaction->execute($sql, $params); if ($result instanceof ResultSet) { ++$this->refCount; return $this->createResultSet($result, $this->release); } return $result; }); } public function isAlive(): bool { return $this->transaction && $this->transaction->isAlive(); } public function getLastUsedAt(): int { if (!$this->transaction) { throw new TransactionError("The transaction has been committed or rolled back"); } return $this->transaction->getLastUsedAt(); } public function close() { if (!$this->transaction) { return; } $promise = $this->transaction->commit(); $promise->onResolve($this->release); $this->transaction = null; } public function getIsolationLevel(): int { if (!$this->transaction) { throw new TransactionError("The transaction has been committed or rolled back"); } return $this->transaction->getIsolationLevel(); } public function isActive(): bool { return $this->transaction && $this->transaction->isActive(); } public function commit(): Promise { if (!$this->transaction) { throw new TransactionError("The transaction has been committed or rolled back"); } $promise = $this->transaction->commit(); $promise->onResolve($this->release); $this->transaction = null; return $promise; } public function rollback(): Promise { if (!$this->transaction) { throw new TransactionError("The transaction has been committed or rolled back"); } $promise = $this->transaction->rollback(); $promise->onResolve($this->release); $this->transaction = null; return $promise; } public function createSavepoint(string $identifier): Promise { if (!$this->transaction) { throw new TransactionError("The transaction has been committed or rolled back"); } return $this->transaction->createSavepoint($identifier); } public function rollbackTo(string $identifier): Promise { if (!$this->transaction) { throw new TransactionError("The transaction has been committed or rolled back"); } return $this->transaction->rollbackTo($identifier); } public function releaseSavepoint(string $identifier): Promise { if (!$this->transaction) { throw new TransactionError("The transaction has been committed or rolled back"); } return $this->transaction->releaseSavepoint($identifier); } } result = $result; $this->release = $release; } public function __destruct() { if ($this->release !== null) { ($this->release)(); } } public function advance(): Promise { $promise = $this->result->advance(); $promise->onResolve(function (\Throwable $exception = null, bool $moreResults = null) { if ($this->release === null) { return; } if ($exception || !$moreResults) { $release = $this->release; $this->release = null; $release(); } }); return $promise; } public function getCurrent(): array { return $this->result->getCurrent(); } } */ abstract protected function prepare(Statement $statement): Promise; /** * @param ResultSet $resultSet * @param callable $release * * @return ResultSet */ abstract protected function createResultSet(ResultSet $resultSet, callable $release): ResultSet; /** * @param Pool $pool Pool used to re-create the statement if the original closes. * @param Statement $statement Original prepared statement returned from the Link. * @param callable $prepare Callable that returns a new prepared statement. */ public function __construct(Pool $pool, Statement $statement, callable $prepare) { $this->lastUsedAt = \time(); $this->statements = $statements = new \SplQueue; $this->pool = $pool; $this->prepare = $prepare; $this->sql = $statement->getQuery(); $this->statements->push($statement); $this->timeoutWatcher = Loop::repeat(1000, static function () use ($pool, $statements) { $now = \time(); $idleTimeout = ((int) ($pool->getIdleTimeout() / 10)) ?: 1; while (!$statements->isEmpty()) { $statement = $statements->bottom(); \assert($statement instanceof Statement); if ($statement->getLastUsedAt() + $idleTimeout > $now) { return; } $statements->shift(); } }); Loop::unreference($this->timeoutWatcher); } public function __destruct() { Loop::cancel($this->timeoutWatcher); } /** * {@inheritdoc} * * Unlike regular statements, as long as the pool is open this statement will not die. */ public function execute(array $params = []): Promise { $this->lastUsedAt = \time(); return call(function () use ($params) { $statement = yield from $this->pop(); \assert($statement instanceof Statement); try { $statement = yield $this->prepare($statement); \assert($statement instanceof Statement); $result = yield $statement->execute($params); } catch (\Throwable $exception) { $this->push($statement); throw $exception; } if ($result instanceof ResultSet) { $result = $this->createResultSet($result, function () use ($statement) { $this->push($statement); }); } else { $this->push($statement); } return $result; }); } /** * Only retains statements if less than 10% of the pool is consumed by this statement and the pool has * available connections. * * @param Statement $statement */ protected function push(Statement $statement) { $maxConnections = $this->pool->getConnectionLimit(); if ($this->statements->count() > ($maxConnections / 10)) { return; } if ($maxConnections === $this->pool->getConnectionCount() && $this->pool->getIdleConnectionCount() === 0) { return; } $this->statements->unshift($statement); } /** * Coroutine returning a Statement object from the pool or creating a new Statement. * * @return \Generator */ protected function pop(): \Generator { while (!$this->statements->isEmpty()) { $statement = $this->statements->shift(); \assert($statement instanceof Statement); if ($statement->isAlive()) { return $statement; } } $statement = yield ($this->prepare)($this->sql); \assert($statement instanceof Statement); return $statement; } /** {@inheritdoc} */ public function isAlive(): bool { return $this->pool->isAlive(); } /** {@inheritdoc} */ public function getQuery(): string { return $this->sql; } /** {@inheritdoc} */ public function getLastUsedAt(): int { return $this->lastUsedAt; } } { "name": "amphp/http-client", "homepage": "https://github.com/amphp/http-client", "description": "Asynchronous concurrent HTTP/2 and HTTP/1.1 client built on the Amp concurrency framework", "keywords": [ "http", "rest", "client", "concurrent", "async", "non-blocking" ], "license": "MIT", "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@gmail.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" } ], "require": { "php": ">=7.2", "amphp/amp": "^2.4", "amphp/byte-stream": "^1.6", "amphp/hpack": "^3", "amphp/http": "^1.6", "amphp/socket": "^1", "amphp/sync": "^1.3", "league/uri": "^6", "psr/http-message": "^1" }, "require-dev": { "ext-json": "*", "amphp/file": "^0.2 || ^0.3 || ^1 || ^2", "amphp/phpunit-util": "^1.1", "amphp/php-cs-fixer-config": "dev-master", "phpunit/phpunit": "^7 || ^8 || ^9", "amphp/http-server": "^2", "kelunik/link-header-rfc5988": "^1.0", "clue/socks-react": "^1.0", "amphp/react-adapter": "^2.1", "vimeo/psalm": "^4", "laminas/laminas-diactoros": "^2.3" }, "suggest": { "ext-zlib": "Allows using compression for response bodies.", "ext-json": "Required for logging HTTP archives", "amphp/file": "Required for file request bodies and HTTP archive logging" }, "autoload": { "psr-4": { "Amp\\Http\\Client\\": "src" }, "files": [ "src/Internal/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Http\\Client\\": "test" } }, "conflict": { "amphp/file": "<0.2 || >=3" }, "scripts": { "check": [ "@cs", "@test" ], "cs": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff --dry-run", "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" }, "extra": { "branch-alias": { "dev-master": "4.x-dev" } } } true]); } /** @var string[] */ private $protocolVersions = ['1.1', '2']; /** @var string */ private $method; /** @var UriInterface */ private $uri; /** @var RequestBody */ private $body; /** @var int */ private $tcpConnectTimeout = 10000; /** @var int */ private $tlsHandshakeTimeout = 10000; /** @var int */ private $transferTimeout = 10000; /** @var int */ private $inactivityTimeout = 10000; /** @var int */ private $bodySizeLimit = self::DEFAULT_BODY_SIZE_LIMIT; /** @var int */ private $headerSizeLimit = self::DEFAULT_HEADER_SIZE_LIMIT; /** @var callable|null */ private $onPush; /** @var callable|null */ private $onUpgrade; /** @var callable|null */ private $onInformationalResponse; /** @var mixed[] */ private $attributes = []; /** @var EventListener[] */ private $eventListeners = []; /** * Request constructor. * * @param string|UriInterface $uri * @param string $method * @param string $body */ public function __construct($uri, string $method = "GET", ?string $body = null) { $this->setUri($uri); $this->setMethod($method); $this->setBody($body); } public function addEventListener(EventListener $eventListener): void { $this->eventListeners[] = $eventListener; } /** * @return EventListener[] */ public function getEventListeners(): array { return $this->eventListeners; } /** * Retrieve the requests's acceptable HTTP protocol versions. * * @return string[] */ public function getProtocolVersions(): array { return $this->protocolVersions; } /** * Assign the requests's acceptable HTTP protocol versions. * * The HTTP client might choose any of these. * * @param string[] $versions */ public function setProtocolVersions(array $versions): void { $versions = \array_unique($versions); if (empty($versions)) { /** @noinspection PhpUndefinedClassInspection */ throw new \Error("Empty array of protocol versions provided, must not be empty."); } foreach ($versions as $version) { if (!\in_array($version, ["1.0", "1.1", "2"], true)) { /** @noinspection PhpUndefinedClassInspection */ throw new \Error( "Invalid HTTP protocol version: " . $version ); } } $this->protocolVersions = $versions; } /** * Retrieve the request's HTTP method verb. * * @return string */ public function getMethod(): string { return $this->method; } /** * Specify the request's HTTP method verb. * * @param string $method */ public function setMethod(string $method): void { $this->method = $method; } /** * Retrieve the request's URI. * * @return UriInterface */ public function getUri(): UriInterface { return $this->uri; } /** * Specify the request's HTTP URI. * * @param string|UriInterface $uri */ public function setUri($uri): void { $this->uri = $uri instanceof UriInterface ? $uri : $this->createUriFromString($uri); } /** * Assign a value for the specified header field by replacing any existing values for that field. * * @param string $name Header name. * @param string|string[] $value Header value. */ public function setHeader(string $name, $value): void { if (($name[0] ?? ":") === ":") { throw new \Error("Header name cannot be empty or start with a colon (:)"); } parent::setHeader($name, $value); } /** * Assign a value for the specified header field by adding an additional header line. * * @param string $name Header name. * @param string|string[] $value Header value. */ public function addHeader(string $name, $value): void { if (($name[0] ?? ":") === ":") { throw new \Error("Header name cannot be empty or start with a colon (:)"); } parent::addHeader($name, $value); } public function setHeaders(array $headers): void { /** @noinspection PhpUnhandledExceptionInspection */ parent::setHeaders($headers); } /** * Remove the specified header field from the message. * * @param string $name Header name. */ public function removeHeader(string $name): void { parent::removeHeader($name); } /** * Retrieve the message entity body. */ public function getBody(): RequestBody { return $this->body; } /** * Assign the message entity body. * * @param mixed $body */ public function setBody($body): void { if ($body === null) { $this->body = new StringBody(""); } elseif (\is_string($body)) { $this->body = new StringBody($body); } elseif (\is_scalar($body)) { $this->body = new StringBody(\var_export($body, true)); } elseif ($body instanceof RequestBody) { $this->body = $body; } else { /** @noinspection PhpUndefinedClassInspection */ throw new \TypeError("Invalid body type: " . \gettype($body)); } } /** * Registers a callback to the request that is invoked when the server pushes an additional resource. * The callback is given two parameters: the Request generated from the pushed resource, and a promise for the * Response containing the pushed resource. An HttpException, StreamException, or CancelledException can be thrown * to refuse the push. If no callback is registered, pushes are automatically rejected. * * Interceptors can mostly use {@code interceptPush} instead. * * Example: * function (Request $request, Promise $response): \Generator { * $uri = $request->getUri(); // URI of pushed resource. * $response = yield $promise; // Wait for resource to arrive. * // Use Response object from resolved promise. * } * * @param callable|null $onPush */ public function setPushHandler(?callable $onPush): void { $this->onPush = $onPush; } /** * Allows interceptors to modify also pushed responses. * * If no push callable has been set by the application, the interceptor won't be invoked. If you want to enable * push in an interceptor without the application setting a push handler, you need to use {@code setPushHandler}. * * @param callable $interceptor Receives the response and might modify it or return a new instance. */ public function interceptPush(callable $interceptor): void { if ($this->onPush === null) { return; } $onPush = $this->onPush; /** @psalm-suppress MissingClosureReturnType */ $this->onPush = static function (Request $request, Promise $response) use ($onPush, $interceptor) { $response = call(static function () use ($response, $interceptor): \Generator { return (yield call($interceptor, yield $response)) ?? $response; }); return $onPush($request, $response); }; } /** * @return callable|null */ public function getPushHandler(): ?callable { return $this->onPush; } /** * Registers a callback invoked if a 101 response is returned to the request. * * @param callable|null $onUpgrade */ public function setUpgradeHandler(?callable $onUpgrade): void { $this->onUpgrade = $onUpgrade; } /** * @return callable|null */ public function getUpgradeHandler(): ?callable { return $this->onUpgrade; } /** * Registers a callback invoked when a 1xx response is returned to the request (other than a 101). * * @param callable|null $onInformationalResponse */ public function setInformationalResponseHandler(?callable $onInformationalResponse): void { $this->onInformationalResponse = $onInformationalResponse; } /** * @return callable|null */ public function getInformationalResponseHandler(): ?callable { return $this->onInformationalResponse; } /** * @return int Timeout in milliseconds for the TCP connection. */ public function getTcpConnectTimeout(): int { return $this->tcpConnectTimeout; } public function setTcpConnectTimeout(int $tcpConnectTimeout): void { $this->tcpConnectTimeout = $tcpConnectTimeout; } /** * @return int Timeout in milliseconds for the TLS handshake. */ public function getTlsHandshakeTimeout(): int { return $this->tlsHandshakeTimeout; } public function setTlsHandshakeTimeout(int $tlsHandshakeTimeout): void { $this->tlsHandshakeTimeout = $tlsHandshakeTimeout; } /** * @return int Timeout in milliseconds for the HTTP transfer (not counting TCP connect and TLS handshake) */ public function getTransferTimeout(): int { return $this->transferTimeout; } public function setTransferTimeout(int $transferTimeout): void { $this->transferTimeout = $transferTimeout; } /** * @return int Timeout in milliseconds since the last data was received before the request fails due to inactivity. */ public function getInactivityTimeout(): int { return $this->inactivityTimeout; } public function setInactivityTimeout(int $inactivityTimeout): void { $this->inactivityTimeout = $inactivityTimeout; } public function getHeaderSizeLimit(): int { return $this->headerSizeLimit; } public function setHeaderSizeLimit(int $headerSizeLimit): void { $this->headerSizeLimit = $headerSizeLimit; } public function getBodySizeLimit(): int { return $this->bodySizeLimit; } public function setBodySizeLimit(int $bodySizeLimit): void { $this->bodySizeLimit = $bodySizeLimit; } /** * Note: This method returns a deep clone of the request's attributes, so you can't modify the request attributes * by modifying the returned value in any way. * * @return mixed[] An array of all request attributes in the request's local storage, indexed by name. */ public function getAttributes(): array { return self::clone($this->attributes); } /** * Check whether a variable with the given name exists in the request's local storage. * * Each request has its own local storage to which applications and interceptors may read and write data. * Other interceptors which are aware of this data can then access it without the server being tightly coupled to * specific implementations. * * @param string $name Name of the attribute, should be namespaced with a vendor and package namespace like classes. * * @return bool */ public function hasAttribute(string $name): bool { return \array_key_exists($name, $this->attributes); } /** * Retrieve a variable from the request's local storage. * * Each request has its own local storage to which applications and interceptors may read and write data. * Other interceptors which are aware of this data can then access it without the server being tightly coupled to * specific implementations. * * Note: This method returns a deep clone of the request's attribute, so you can't modify the request attribute * by modifying the returned value in any way. * * @param string $name Name of the attribute, should be namespaced with a vendor and package namespace like classes. * * @return mixed * * @throws MissingAttributeError If an attribute with the given name does not exist. */ public function getAttribute(string $name) { if (!$this->hasAttribute($name)) { throw new MissingAttributeError("The requested attribute '{$name}' does not exist"); } return self::clone($this->attributes[$name]); } /** * Assign a variable to the request's local storage. * * Each request has its own local storage to which applications and interceptors may read and write data. * Other interceptors which are aware of this data can then access it without the server being tightly coupled to * specific implementations. * * Note: This method performs a deep clone of the value via serialization, so you can't modify the given value * after setting it. * * **Example** * * ```php * $request->setAttribute(Timing::class, $stopWatch); * ``` * * @param string $name Name of the attribute, should be namespaced with a vendor and package namespace like classes. * @param mixed $value Value of the attribute, might be any serializable value. */ public function setAttribute(string $name, $value): void { $this->attributes[$name] = self::clone($value); } /** * Remove an attribute from the request's local storage. * * @param string $name Name of the attribute, should be namespaced with a vendor and package namespace like classes. * * @throws MissingAttributeError If an attribute with the given name does not exist. */ public function removeAttribute(string $name): void { if (!$this->hasAttribute($name)) { throw new MissingAttributeError("The requested attribute '{$name}' does not exist"); } unset($this->attributes[$name]); } /** * Remove all attributes from the request's local storage. */ public function removeAttributes(): void { $this->attributes = []; } public function isIdempotent(): bool { // https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html return \in_array($this->method, ['GET', 'HEAD', 'PUT', 'DELETE'], true); } private function createUriFromString(string $uri): UriInterface { return Uri\Http::createFromString($uri); } } hasAttribute(HarAttributes::STARTED_DATE_TIME)) { $request->setAttribute(HarAttributes::STARTED_DATE_TIME, new \DateTimeImmutable); } return $this->addTiming(HarAttributes::TIME_START, $request); } public function startDnsResolution(Request $request): Promise { return new Success; // not implemented } public function startConnectionCreation(Request $request): Promise { return $this->addTiming(HarAttributes::TIME_CONNECT, $request); } public function startTlsNegotiation(Request $request): Promise { return $this->addTiming(HarAttributes::TIME_SSL, $request); } public function startSendingRequest(Request $request, Stream $stream): Promise { $host = $stream->getRemoteAddress()->getHost(); if (\strrpos($host, ':')) { $host = '[' . $host . ']'; } $request->setAttribute(HarAttributes::SERVER_IP_ADDRESS, $host); return $this->addTiming(HarAttributes::TIME_SEND, $request); } public function completeSendingRequest(Request $request, Stream $stream): Promise { return $this->addTiming(HarAttributes::TIME_WAIT, $request); } public function startReceivingResponse(Request $request, Stream $stream): Promise { return $this->addTiming(HarAttributes::TIME_RECEIVE, $request); } public function completeReceivingResponse(Request $request, Stream $stream): Promise { return $this->addTiming(HarAttributes::TIME_COMPLETE, $request); } public function completeDnsResolution(Request $request): Promise { return new Success; // not implemented } public function completeConnectionCreation(Request $request): Promise { return new Success; // not implemented } public function completeTlsNegotiation(Request $request): Promise { return new Success; // not implemented } private function addTiming(string $key, Request $request): Promise { if (!$request->hasAttribute($key)) { $request->setAttribute($key, getCurrentTime()); } return new Success; } public function abort(Request $request, \Throwable $cause): Promise { return new Success; } } true, "content-encoding" => true, "content-length" => true, "content-range" => true, "content-type" => true, "cookie" => true, "expect" => true, "host" => true, "pragma" => true, "proxy-authenticate" => true, "proxy-authorization" => true, "range" => true, "te" => true, "trailer" => true, "transfer-encoding" => true, "www-authenticate" => true, ]; /** * @param string[]|string[][] $headers * * @throws InvalidHeaderException Thrown if a disallowed field is in the header values. */ public function __construct(array $headers) { if (!empty($headers)) { $this->setHeaders($headers); } if (\array_intersect_key($this->getHeaders(), self::DISALLOWED_TRAILERS)) { throw new InvalidHeaderException('Disallowed field in trailers'); } } } retryLimit = $retryLimit; } public function request( Request $request, CancellationToken $cancellation, DelegateHttpClient $httpClient ): Promise { return call(function () use ($request, $cancellation, $httpClient) { $attempt = 1; do { try { return yield $httpClient->request(clone $request, $cancellation); } catch (UnprocessedRequestException $exception) { // Request was deemed retryable by connection, so carry on. } catch (SocketException | Http2ConnectionException $exception) { if (!$request->isIdempotent()) { throw $exception; } // Request can safely be retried. } } while ($attempt++ <= $this->retryLimit); throw $exception; }); } } addHeader($headerName, $headerValues); return $request; }); } } response = $response; } public function getResponse(): Response { return $this->response; } } setHeader($headerName, $headerValues); return $request; }); } } |Request|null>|Promise|Request|null) */ private $mapper; /** * @psalm-param callable(Request):(\Generator|Request|null>|Promise|Request|null) $mapper */ public function __construct(callable $mapper) { $this->mapper = $mapper; } /** * @param Request $request * @param CancellationToken $cancellation * @param Stream $stream * * @return Promise */ final public function requestViaNetwork( Request $request, CancellationToken $cancellation, Stream $stream ): Promise { return call(function () use ($request, $cancellation, $stream) { $mappedRequest = yield call($this->mapper, $request); \assert($mappedRequest instanceof Request || $mappedRequest === null); return yield $stream->request($mappedRequest ?? $request, $cancellation); }); } public function request( Request $request, CancellationToken $cancellation, DelegateHttpClient $httpClient ): Promise { return call(function () use ($request, $cancellation, $httpClient) { $mappedRequest = yield call($this->mapper, $request); \assert($mappedRequest instanceof Request || $mappedRequest === null); return $httpClient->request($mappedRequest ?? $request, $cancellation); }); } } hasHeader($headerName)) { $response->setHeader($headerName, $headerValues); } return $response; }); } } removeHeader($headerName); return $response; }); } } hasZlib = \extension_loaded('zlib'); } public function requestViaNetwork( Request $request, CancellationToken $cancellation, Stream $stream ): Promise { // If a header is manually set, we won't interfere if ($request->hasHeader('accept-encoding')) { return $stream->request($request, $cancellation); } return call(function () use ($request, $cancellation, $stream) { $this->addAcceptEncodingHeader($request); $request->interceptPush(function (Response $response) { return $this->decompressResponse($response); }); return $this->decompressResponse(yield $stream->request($request, $cancellation)); }); } private function addAcceptEncodingHeader(Request $request): void { if ($this->hasZlib) { $request->setHeader('Accept-Encoding', 'gzip, deflate, identity'); } } private function decompressResponse(Response $response): Response { if (($encoding = $this->determineCompressionEncoding($response))) { $sizeLimit = $response->getRequest()->getBodySizeLimit(); /** @noinspection PhpUnhandledExceptionInspection */ $decompressedBody = new ZlibInputStream($response->getBody(), $encoding); $response->setBody(new SizeLimitingInputStream($decompressedBody, $sizeLimit)); $response->removeHeader('content-encoding'); } return $response; } private function determineCompressionEncoding(Response $response): int { if (!$this->hasZlib) { return 0; } if (!$response->hasHeader("content-encoding")) { return 0; } $contentEncoding = $response->getHeader("content-encoding"); \assert($contentEncoding !== null); $contentEncodingHeader = \trim($contentEncoding); if (\strcasecmp($contentEncodingHeader, 'gzip') === 0) { return \ZLIB_ENCODING_GZIP; } if (\strcasecmp($contentEncodingHeader, 'deflate') === 0) { return \ZLIB_ENCODING_DEFLATE; } return 0; } } hasHeader($headerName)) { $request->setHeader($headerName, $headerValues); } return $request; }); } } setHeader($headerName, $headerValues); return $response; }); } } hasAttribute($start)) { return -1; } foreach ($ends as $end) { if ($request->hasAttribute($end)) { return $request->getAttribute($end) - $request->getAttribute($start); } } return -1; } private static function formatHeaders(Message $message): array { $headers = []; foreach ($message->getHeaders() as $field => $values) { foreach ($values as $value) { $headers[] = [ 'name' => $field, 'value' => $value, ]; } } return $headers; } private static function formatEntry(Response $response): array { $request = $response->getRequest(); $data = [ 'startedDateTime' => $request->getAttribute(HarAttributes::STARTED_DATE_TIME)->format(\DateTimeInterface::RFC3339_EXTENDED), 'time' => self::getTime($request, HarAttributes::TIME_START, HarAttributes::TIME_COMPLETE), 'request' => [ 'method' => $request->getMethod(), 'url' => (string) $request->getUri()->withUserInfo(''), 'httpVersion' => 'http/' . $request->getProtocolVersions()[0], 'headers' => self::formatHeaders($request), 'queryString' => [], 'cookies' => [], 'headersSize' => -1, 'bodySize' => -1, ], 'response' => [ 'status' => $response->getStatus(), 'statusText' => $response->getReason(), 'httpVersion' => 'http/' . $response->getProtocolVersion(), 'headers' => self::formatHeaders($response), 'cookies' => [], 'redirectURL' => $response->getHeader('location') ?? '', 'headersSize' => -1, 'bodySize' => -1, 'content' => [ 'size' => (int) ($response->getHeader('content-length') ?? '-1'), 'mimeType' => $response->getHeader('content-type') ?? '', ], ], 'cache' => [], 'timings' => [ 'blocked' => self::getTime( $request, HarAttributes::TIME_START, HarAttributes::TIME_CONNECT, HarAttributes::TIME_SEND ), 'dns' => -1, 'connect' => self::getTime( $request, HarAttributes::TIME_CONNECT, HarAttributes::TIME_SEND ), 'ssl' => self::getTime( $request, HarAttributes::TIME_SSL, HarAttributes::TIME_SEND ), 'send' => self::getTime( $request, HarAttributes::TIME_SEND, HarAttributes::TIME_WAIT ), 'wait' => self::getTime( $request, HarAttributes::TIME_WAIT, HarAttributes::TIME_RECEIVE ), 'receive' => self::getTime( $request, HarAttributes::TIME_RECEIVE, HarAttributes::TIME_COMPLETE ), ], ]; if ($request->hasAttribute(HarAttributes::SERVER_IP_ADDRESS)) { $data['serverIPAddress'] = $request->getAttribute(HarAttributes::SERVER_IP_ADDRESS); } return $data; } /** @var LocalMutex */ private $fileMutex; /** @var File\File|null */ private $fileHandle; /** @var string */ private $filePath; /** @var \Throwable|null */ private $error; /** @var EventListener */ private $eventListener; public function __construct(string $filePath) { $this->filePath = $filePath; $this->fileMutex = new LocalMutex; $this->eventListener = new RecordHarAttributes; if (!\interface_exists(Driver::class)) { throw new \Error(__CLASS__ . ' requires amphp/file to be installed'); } } public function request( Request $request, CancellationToken $cancellation, DelegateHttpClient $httpClient ): Promise { return call(function () use ($request, $cancellation, $httpClient) { if ($this->error) { throw $this->error; } $this->ensureEventListenerIsRegistered($request); /** @var Response $response */ $response = yield $httpClient->request($request, $cancellation); rethrow($this->writeLog($response)); return $response; }); } public function reset(): Promise { return $this->rotate($this->filePath); } public function rotate(string $filePath): Promise { return call(function () use ($filePath) { /** @var Lock $lock */ $lock = yield $this->fileMutex->acquire(); // Will automatically reopen and reset the file $this->fileHandle = null; $this->filePath = $filePath; $this->error = null; $lock->release(); }); } private function writeLog(Response $response): Promise { return call(function () use ($response) { try { yield $response->getTrailers(); } catch (\Throwable $e) { // ignore, still log the remaining response times } try { /** @var Lock $lock */ $lock = yield $this->fileMutex->acquire(); $firstEntry = $this->fileHandle === null; if ($firstEntry) { $this->fileHandle = yield \function_exists('Amp\File\openFile') ? File\openFile($this->filePath, 'w') : File\open($this->filePath, 'w'); $header = '{"log":{"version":"1.2","creator":{"name":"amphp/http-client","version":"4.x"},"pages":[],"entries":['; yield $this->fileHandle->write($header); } else { \assert($this->fileHandle !== null); yield $this->fileHandle->seek(-3, \SEEK_CUR); } /** @noinspection PhpComposerExtensionStubsInspection */ $json = \json_encode(self::formatEntry($response)); yield $this->fileHandle->write(($firstEntry ? '' : ',') . $json . ']}}'); $lock->release(); } catch (HttpException $e) { $this->error = $e; } catch (\Throwable $e) { $this->error = new HttpException('Writing HTTP archive log failed', 0, $e); } }); } private function ensureEventListenerIsRegistered(Request $request): void { foreach ($request->getEventListeners() as $eventListener) { if ($eventListener instanceof RecordHarAttributes) { return; // user added it manually } } $request->addEventListener($this->eventListener); } } |Promise|Response|null) */ private $mapper; /** * @psalm-param callable(Response):(\Generator|Promise|Response|null) $mapper */ public function __construct(callable $mapper) { $this->mapper = $mapper; } final public function requestViaNetwork( Request $request, CancellationToken $cancellation, Stream $stream ): Promise { return call(function () use ($request, $cancellation, $stream) { $response = yield $stream->request($request, $cancellation); $mappedResponse = yield call($this->mapper, $response); \assert($mappedResponse instanceof Response || $mappedResponse === null); return $mappedResponse ?? $response; }); } public function request( Request $request, CancellationToken $cancellation, DelegateHttpClient $httpClient ): Promise { return call(function () use ($request, $cancellation, $httpClient) { $request->interceptPush($this->mapper); $response = yield $httpClient->request($request, $cancellation); $mappedResponse = yield call($this->mapper, $response); \assert($mappedResponse instanceof Response || $mappedResponse === null); return $mappedResponse ?? $response; }); } } setTcpConnectTimeout($tcpConnectTimeout); $request->setTlsHandshakeTimeout($tlsHandshakeTimeout); $request->setTransferTimeout($transferTimeout); return $request; }); } } addHeader($headerName, $headerValues); return $response; }); } } removeHeader($headerName); return $request; }); } } $interceptor) { if (!$interceptor instanceof ApplicationInterceptor) { $type = \is_object($interceptor) ? \get_class($interceptor) : \gettype($interceptor); throw new HttpException('Origin map must be a map from origin to ApplicationInterceptor, got ' . $type); } $this->originMap[$this->checkOrigin($origin)] = $interceptor; } $this->default = $default; } public function request( Request $request, CancellationToken $cancellation, DelegateHttpClient $httpClient ): Promise { $interceptor = $this->originMap[$this->normalizeOrigin($request->getUri())] ?? $this->default; if (!$interceptor) { return $httpClient->request($request, $cancellation); } return $interceptor->request($request, $cancellation, $httpClient); } private function checkOrigin(string $origin): string { try { $originUri = Http::createFromString($origin); } catch (\Exception $e) { throw new HttpException("Invalid origin provided: parsing failed: " . $origin); } if (!\in_array($originUri->getScheme(), ['http', 'https'], true)) { throw new HttpException('Invalid origin with unsupported scheme: ' . $origin); } if ($originUri->getHost() === '') { throw new HttpException('Invalid origin without host: ' . $origin); } if ($originUri->getUserInfo() !== '') { throw new HttpException('Invalid origin with user info, which must not be present: ' . $origin); } if (!\in_array($originUri->getPath(), ['', '/'], true)) { throw new HttpException('Invalid origin with path, which must not be present: ' . $origin); } if ($originUri->getQuery() !== '') { throw new HttpException('Invalid origin with query, which must not be present: ' . $origin); } if ($originUri->getFragment() !== '') { throw new HttpException('Invalid origin with fragment, which must not be present: ' . $origin); } return $this->normalizeOrigin($originUri); } private function normalizeOrigin(UriInterface $uri): string { $defaultPort = $uri->getScheme() === 'https' ? 443 : 80; return $uri->getScheme() . '://' . $uri->getHost() . ':' . ($uri->getPort() ?? $defaultPort); } } getUri()->getUserInfo() !== '') { throw new InvalidRequestException( $request, 'The user information (username:password) component of URIs has been deprecated ' . '(see https://tools.ietf.org/html/rfc3986#section-3.2.1 and https://tools.ietf.org/html/rfc7230#section-2.7.1); ' . 'Instead, set an "Authorization" header containing "Basic " . \\base64_encode("username:password"). ' . 'If you used HttpClientBuilder, you can use HttpClientBuilder::allowDeprecatedUriUserInfo() to disable this protection. ' . 'Doing so is strongly discouraged and you need to be aware of any interceptor using UriInterface::__toString(), which might expose the password in headers or logs.' ); } }); } } getScheme() !== '' || $locationUri->getHost() !== '') { $resultUri = $locationUri->withPath(self::removeDotSegments($locationUri->getPath())); if ($locationUri->getScheme() === '') { $resultUri = $resultUri->withScheme($baseUri->getScheme()); } return $resultUri; } $baseUri = $baseUri->withQuery($locationUri->getQuery()); $baseUri = $baseUri->withFragment($locationUri->getFragment()); if ($locationUri->getPath() !== '' && \substr($locationUri->getPath(), 0, 1) === "/") { $baseUri = $baseUri->withPath(self::removeDotSegments($locationUri->getPath())); } else { $baseUri = $baseUri->withPath(self::mergePaths($baseUri->getPath(), $locationUri->getPath())); } return $baseUri; } /** * @param string $input * * @return string * * @link http://www.apps.ietf.org/rfc/rfc3986.html#sec-5.2.4 */ private static function removeDotSegments(string $input): string { $output = ''; $patternA = ',^(\.\.?/),'; $patternB1 = ',^(/\./),'; $patternB2 = ',^(/\.)$,'; $patternC = ',^(/\.\./|/\.\.),'; // $patternD = ',^(\.\.?)$,'; $patternE = ',(/*[^/]*),'; while ($input !== '') { if (\preg_match($patternA, $input)) { $input = \preg_replace($patternA, '', $input); } elseif (\preg_match($patternB1, $input, $match) || \preg_match($patternB2, $input, $match)) { $input = \preg_replace(",^" . $match[1] . ",", '/', $input); } elseif (\preg_match($patternC, $input, $match)) { $input = \preg_replace(',^' . \preg_quote($match[1], ',') . ',', '/', $input); $output = \preg_replace(',/([^/]+)$,', '', $output); } elseif ($input === '.' || $input === '..') { // pattern D $input = ''; } elseif (\preg_match($patternE, $input, $match)) { $initialSegment = $match[1]; $input = \preg_replace(',^' . \preg_quote($initialSegment, ',') . ',', '', $input, 1); $output .= $initialSegment; } } return $output; } /** * @param string $basePath * @param string $pathToMerge * * @return string * * @link http://tools.ietf.org/html/rfc3986#section-5.2.3 */ private static function mergePaths(string $basePath, string $pathToMerge): string { if ($pathToMerge === '') { return self::removeDotSegments($basePath); } if ($basePath === '') { return self::removeDotSegments('/' . $pathToMerge); } $parts = \explode('/', $basePath); \array_pop($parts); $parts[] = $pathToMerge; return self::removeDotSegments(\implode('/', $parts)); } /** @var int */ private $maxRedirects; /** @var bool */ private $autoReferrer; public function __construct(int $limit, bool $autoReferrer = true) { if ($limit < 1) { /** @noinspection PhpUndefinedClassInspection */ throw new \Error("Invalid redirection limit: " . $limit); } $this->maxRedirects = $limit; $this->autoReferrer = $autoReferrer; } public function request( Request $request, CancellationToken $cancellation, DelegateHttpClient $httpClient ): Promise { // Don't follow redirects on pushes, just store the redirect in cache (if an interceptor is configured) return call(function () use ($request, $cancellation, $httpClient) { /** @var Response $response */ $response = yield $httpClient->request(clone $request, $cancellation); $response = yield from $this->followRedirects($request, $response, $httpClient, $cancellation); return $response; }); } private function followRedirects( Request $request, Response $response, DelegateHttpClient $client, CancellationToken $cancellationToken ): \Generator { $previousResponse = null; $maxRedirects = $this->maxRedirects; $requestNr = 2; do { $request = yield from $this->createRedirectRequest($request, $response); if ($request === null) { return $response; } /** @var Response $redirectResponse */ $redirectResponse = yield $client->request(clone $request, $cancellationToken); $redirectResponse->setPreviousResponse($response); $response = $redirectResponse; } while (++$requestNr <= $maxRedirects + 1); if ($this->getRedirectUri($response) !== null) { throw new TooManyRedirectsException($response); } return $response; } private function createRedirectRequest(Request $originalRequest, Response $response): \Generator { $redirectUri = $this->getRedirectUri($response); if ($redirectUri === null) { return null; } $originalUri = $response->getRequest()->getUri(); $isSameHost = $redirectUri->getAuthority() === $originalUri->getAuthority(); $request = clone $originalRequest; $request->setMethod('GET'); $request->setUri($redirectUri); $request->removeHeader('transfer-encoding'); $request->removeHeader('content-length'); $request->removeHeader('content-type'); $request->removeAttributes(); $request->setBody(null); if (!$isSameHost) { // Remove for security reasons, any interceptor headers will be added again, // but application headers will be discarded. foreach ($request->getRawHeaders() as [$field]) { $request->removeHeader($field); } } if ($this->autoReferrer) { $this->assignRedirectRefererHeader($request, $originalUri, $redirectUri); } yield from $this->discardResponseBody($response); return $request; } /** * Clients must not add a Referer header when leaving an unencrypted resource and redirecting to an encrypted * resource. * * @param Request $request * @param PsrUri $referrerUri * @param PsrUri $followUri * * @link http://www.w3.org/Protocols/rfc2616/rfc2616-sec15.html#sec15.1.3 */ private function assignRedirectRefererHeader( Request $request, PsrUri $referrerUri, PsrUri $followUri ): void { $referrerIsEncrypted = $referrerUri->getScheme() === 'https'; $destinationIsEncrypted = $followUri->getScheme() === 'https'; if (!$referrerIsEncrypted || $destinationIsEncrypted) { $request->setHeader('Referer', (string) $referrerUri->withUserInfo('')->withFragment('')); } else { $request->removeHeader('Referer'); } } private function getRedirectUri(Response $response): ?PsrUri { if (\count($response->getHeaderArray('location')) !== 1) { return null; } $status = $response->getStatus(); $request = $response->getRequest(); $method = $request->getMethod(); if ($method !== 'GET' && \in_array($status, [307, 308], true)) { return null; } // We don't automatically follow: // - 300 (Multiple Choices) // - 304 (Not Modified) // - 305 (Use Proxy) if (!\in_array($status, [301, 302, 303, 307, 308], true)) { return null; } try { $locationUri = Uri\Http::createFromString($response->getHeader('location')); } catch (\Exception $e) { return null; } return self::resolve($request->getUri(), $locationUri); } private function discardResponseBody(Response $response): \Generator { // Discard response body of redirect responses $body = $response->getBody(); try { /** @noinspection PhpStatementHasEmptyBodyInspection */ /** @noinspection LoopWhichDoesNotLoopInspection */ /** @noinspection MissingOrEmptyGroupStatementInspection */ while (null !== yield $body->read()) { // discard } } catch (HttpException | StreamException $e) { // ignore streaming errors on previous responses } finally { unset($body); } } } */ private $trailers; /** @var Response|null */ private $previousResponse; public function __construct( string $protocolVersion, int $status, ?string $reason, array $headers, InputStream $body, Request $request, ?Promise $trailerPromise = null, ?Response $previousResponse = null ) { $this->setProtocolVersion($protocolVersion); $this->setStatus($status, $reason); $this->setHeaders($headers); $this->setBody($body); $this->request = $request; /** @noinspection PhpUnhandledExceptionInspection */ $this->trailers = $trailerPromise ?? new Success(new Trailers([])); $this->previousResponse = $previousResponse; } /** * Retrieve the requests's HTTP protocol version. * * @return string */ public function getProtocolVersion(): string { return $this->protocolVersion; } public function setProtocolVersion(string $protocolVersion): void { if (!\in_array($protocolVersion, ["1.0", "1.1", "2"], true)) { /** @noinspection PhpUndefinedClassInspection */ throw new \Error( "Invalid HTTP protocol version: " . $protocolVersion ); } $this->protocolVersion = $protocolVersion; } /** * Retrieve the response's three-digit HTTP status code. * * @return int */ public function getStatus(): int { return $this->status; } public function setStatus(int $status, ?string $reason = null): void { $this->status = $status; $this->reason = $reason ?? Status::getReason($status); } /** * Retrieve the response's (possibly empty) reason phrase. * * @return string */ public function getReason(): string { return $this->reason; } /** * Retrieve the Request instance that resulted in this Response instance. * * @return Request */ public function getRequest(): Request { return $this->request; } public function setRequest(Request $request): void { $this->request = $request; } /** * Retrieve the original Request instance associated with this Response instance. * * A given Response may be the result of one or more redirects. This method is a shortcut to * access information from the original Request that led to this response. * * @return Request */ public function getOriginalRequest(): Request { if (empty($this->previousResponse)) { return $this->request; } return $this->previousResponse->getOriginalRequest(); } /** * Retrieve the original Response instance associated with this Response instance. * * A given Response may be the result of one or more redirects. This method is a shortcut to * access information from the original Response that led to this response. * * @return Response */ public function getOriginalResponse(): Response { if (empty($this->previousResponse)) { return $this; } return $this->previousResponse->getOriginalResponse(); } /** * If this Response is the result of a redirect traverse up the redirect history. * * @return Response|null */ public function getPreviousResponse(): ?Response { return $this->previousResponse; } public function setPreviousResponse(?Response $previousResponse): void { $this->previousResponse = $previousResponse; } /** * Assign a value for the specified header field by replacing any existing values for that field. * * @param string $name Header name. * @param string|string[] $value Header value. */ public function setHeader(string $name, $value): void { if (($name[0] ?? ":") === ":") { throw new \Error("Header name cannot be empty or start with a colon (:)"); } parent::setHeader($name, $value); } /** * Assign a value for the specified header field by adding an additional header line. * * @param string $name Header name. * @param string|string[] $value Header value. */ public function addHeader(string $name, $value): void { if (($name[0] ?? ":") === ":") { throw new \Error("Header name cannot be empty or start with a colon (:)"); } parent::addHeader($name, $value); } public function setHeaders(array $headers): void { /** @noinspection PhpUnhandledExceptionInspection */ parent::setHeaders($headers); } /** * Remove the specified header field from the message. * * @param string $name Header name. */ public function removeHeader(string $name): void { parent::removeHeader($name); } /** * Retrieve the response body. * * Note: If you stream a Message, you can't consume the payload twice. * * @return Payload */ public function getBody(): Payload { return $this->body; } /** * @param Payload|InputStream|string|int|float|bool $body */ public function setBody($body): void { if ($body instanceof Payload) { $this->body = $body; } elseif ($body === null) { $this->body = new Payload(new InMemoryStream); } elseif (\is_string($body)) { $this->body = new Payload(new InMemoryStream($body)); } elseif (\is_scalar($body)) { $this->body = new Payload(new InMemoryStream(\var_export($body, true))); } elseif ($body instanceof InputStream) { $this->body = new Payload($body); } else { /** @noinspection PhpUndefinedClassInspection */ throw new \TypeError("Invalid body type: " . \gettype($body)); } } /** * @return Promise */ public function getTrailers(): Promise { return $this->trailers; } /** * @param Promise $promise */ public function setTrailers(Promise $promise): void { $this->trailers = $promise; } } request(...)` resolved. * * A NetworkInterceptor SHOULD NOT short-circuit and SHOULD delegate to the `$stream` passed as third argument * exactly once. The only exception to this is throwing an exception, e.g. because the TLS settings used are * unacceptable. If you need short circuits, use an {@see ApplicationInterceptor} instead. * * @param Request $request * @param CancellationToken $cancellation * @param Stream $stream * * @return Promise */ public function requestViaNetwork(Request $request, CancellationToken $cancellation, Stream $stream): Promise; } request = $request; } public function getRequest(): Request { return $this->request; } } body = $body; $this->bodyCancellation = $bodyCancellation; } public function read(): Promise { $promise = $this->body->read(); $promise->onResolve(function ($error, $value) { if ($value === null && $error === null) { $this->successfulEnd = true; } }); return $promise; } public function __destruct() { if (!$this->successfulEnd) { $this->bodyCancellation->cancel(); } } } source = $source; $this->sizeLimit = $sizeLimit; } public function read(): Promise { if ($this->exception) { return new Failure($this->exception); } \assert($this->source !== null); $promise = $this->source->read(); $promise->onResolve(function ($error, $value) { if ($value !== null) { $this->bytesRead += \strlen($value); if ($this->bytesRead > $this->sizeLimit) { $this->exception = new ParseException( "Configured body size exceeded: {$this->bytesRead} bytes received, while the configured limit is {$this->sizeLimit} bytes", Status::PAYLOAD_TOO_LARGE ); $this->source = null; } } }); return $promise; } } getUri()->getPath(); $query = $request->getUri()->getQuery(); if ($path === '') { return '/' . ($query !== '' ? '?' . $query : ''); } if ($path[0] !== '/') { throw new InvalidRequestException( $request, 'Relative path (' . $path . ') is not allowed in the request URI' ); } return $path . ($query !== '' ? '?' . $query : ''); } json = \json_encode($data, $options, $depth); if (\json_last_error() !== \JSON_ERROR_NONE) { throw new HttpException('Failed to encode data to JSON'); } } public function getHeaders(): Promise { return new Success(['content-type' => 'application/json; charset=utf-8']); } public function createBodyStream(): InputStream { return new InMemoryStream($this->json); } public function getBodyLength(): Promise { return new Success(\strlen($this->json)); } } body = $body; } public function createBodyStream(): InputStream { return new InMemoryStream($this->body !== '' ? $this->body : null); } public function getHeaders(): Promise { return new Success([]); } public function getBodyLength(): Promise { return new Success(\strlen($this->body)); } } |null */ private $cachedLength; /** @var list|null */ private $cachedFields; /** * @param string $boundary An optional multipart boundary string */ public function __construct(string $boundary = null) { /** @noinspection PhpUnhandledExceptionInspection */ $this->boundary = $boundary ?? \bin2hex(\random_bytes(16)); } /** * Add a data field to the form entity body. * * @param string $name * @param string $value * @param string $contentType */ public function addField(string $name, string $value, string $contentType = 'text/plain'): void { $this->fields[] = [$name, $value, $contentType, null]; $this->resetCache(); } /** * Add each element of a associative array as a data field to the form entity body. * * @param array $data * @param string $contentType */ public function addFields(array $data, string $contentType = 'text/plain'): void { foreach ($data as $key => $value) { $this->addField($key, $value, $contentType); } } /** * Add a file field to the form entity body. * * @param string $name * @param string $filePath * @param string $contentType */ public function addFile(string $name, string $filePath, string $contentType = 'application/octet-stream'): void { $fileName = \basename($filePath); $this->fields[] = [$name, new FileBody($filePath), $contentType, $fileName]; $this->isMultipart = true; $this->resetCache(); } /** * Add each element of a associative array as a file field to the form entity body. * * @param array $data * @param string $contentType */ public function addFiles(array $data, string $contentType = 'application/octet-stream'): void { foreach ($data as $key => $value) { $this->addFile($key, $value, $contentType); } } /** * Add a file field to the form from a string. * * @param string $name * @param string $fileContent * @param string $fileName * @param string $contentType */ public function addFileFromString(string $name, string $fileContent, string $fileName, string $contentType = 'application/octet-stream'): void { $this->fields[] = [$name, $fileContent, $contentType, $fileName]; $this->isMultipart = true; $this->resetCache(); } /** * Returns an array of fields, each being an array of [name, value, content-type, file-name|null]. * Both fields and files are returned in the array. Files use a FileBody object as the value. The file-name is * always null for fields. * * @return array */ public function getFields(): array { return $this->fields; } private function resetCache(): void { $this->cachedBody = null; $this->cachedLength = null; $this->cachedFields = null; } public function createBodyStream(): InputStream { if ($this->isMultipart) { return $this->generateMultipartStreamFromFields($this->getMultipartFieldArray()); } return new InMemoryStream($this->getFormEncodedBodyString()); } private function getMultipartFieldArray(): array { if (isset($this->cachedFields)) { return $this->cachedFields; } $fields = []; foreach ($this->fields as $fieldArr) { [$name, $field, $contentType, $fileName] = $fieldArr; $fields[] = "--{$this->boundary}\r\n"; /** @psalm-suppress PossiblyNullArgument */ $fields[] = $fileName !== null ? $this->generateMultipartFileHeader($name, $fileName, $contentType) : $this->generateMultipartFieldHeader($name, $contentType); $fields[] = $field; $fields[] = "\r\n"; } $fields[] = "--{$this->boundary}--\r\n"; return $this->cachedFields = $fields; } private function generateMultipartFileHeader(string $name, string $fileName, string $contentType): string { $header = "Content-Disposition: form-data; name=\"{$name}\"; filename=\"{$fileName}\"\r\n"; $header .= "Content-Type: {$contentType}\r\n"; $header .= "Content-Transfer-Encoding: binary\r\n\r\n"; return $header; } private function generateMultipartFieldHeader(string $name, string $contentType): string { $header = "Content-Disposition: form-data; name=\"{$name}\"\r\n"; if ($contentType !== "") { $header .= "Content-Type: {$contentType}\r\n\r\n"; } else { $header .= "\r\n"; } return $header; } private function generateMultipartStreamFromFields(array $fields): InputStream { foreach ($fields as $key => $field) { $fields[$key] = $field instanceof FileBody ? $field->createBodyStream() : new InMemoryStream($field); } return new IteratorStream(new Producer(static function (callable $emit) use ($fields) { foreach ($fields as $key => $stream) { while (($chunk = yield $stream->read()) !== null) { yield $emit($chunk); } } })); } private function getFormEncodedBodyString(): string { if ($this->cachedBody) { return $this->cachedBody; } $fields = []; foreach ($this->fields as $fieldArr) { [$name, $value] = $fieldArr; $fields[$name][] = $value; } foreach ($fields as $key => $value) { $fields[$key] = isset($value[1]) ? $value : $value[0]; } return $this->cachedBody = \http_build_query($fields); } public function getHeaders(): Promise { return new Success([ 'Content-Type' => $this->determineContentType(), ]); } private function determineContentType(): string { return $this->isMultipart ? "multipart/form-data; boundary={$this->boundary}" : 'application/x-www-form-urlencoded'; } public function getBodyLength(): Promise { if ($this->cachedLength) { return $this->cachedLength; } if (!$this->isMultipart) { return $this->cachedLength = new Success(\strlen($this->getFormEncodedBodyString())); } /** @var Promise $lengthPromise */ $lengthPromise = call(function (): \Generator { $fields = $this->getMultipartFieldArray(); $length = 0; foreach ($fields as $field) { if (\is_string($field)) { $length += \strlen($field); } else { $length += yield $field->getBodyLength(); } } return $length; }); return $this->cachedLength = $lengthPromise; } } path = $path; } public function createBodyStream(): InputStream { $handlePromise = \function_exists('Amp\File\openFile') ? openFile($this->path, "r") : open($this->path, "r"); return new class($handlePromise) implements InputStream { /** @var Promise */ private $promise; /** @var InputStream|null */ private $stream; public function __construct(Promise $promise) { $this->promise = $promise; $this->promise->onResolve(function ($error, $stream) { if ($error) { return; } $this->stream = $stream; }); } public function read(): Promise { if (!$this->stream) { return call(function () { /** @var InputStream $stream */ $stream = yield $this->promise; return $stream->read(); }); } return $this->stream->read(); } }; } public function getHeaders(): Promise { return new Success([]); } public function getBodyLength(): Promise { return \function_exists('Amp\File\getSize') ? getSize($this->path) : size($this->path); } } build(); } /** @var ForbidUriUserInfo|null */ private $forbidUriUserInfo; /** @var RetryRequests|null */ private $retryInterceptor; /** @var FollowRedirects|null */ private $followRedirectsInterceptor; /** @var SetRequestHeaderIfUnset|null */ private $defaultUserAgentInterceptor; /** @var SetRequestHeaderIfUnset|null */ private $defaultAcceptInterceptor; /** @var NetworkInterceptor|null */ private $defaultCompressionHandler; /** @var ApplicationInterceptor[] */ private $applicationInterceptors = []; /** @var NetworkInterceptor[] */ private $networkInterceptors = []; /** @var ConnectionPool */ private $pool; public function __construct() { $this->pool = new UnlimitedConnectionPool; $this->forbidUriUserInfo = new ForbidUriUserInfo; $this->followRedirectsInterceptor = new FollowRedirects(10); $this->retryInterceptor = new RetryRequests(2); $this->defaultAcceptInterceptor = new SetRequestHeaderIfUnset('accept', '*/*'); $this->defaultUserAgentInterceptor = new SetRequestHeaderIfUnset('user-agent', 'amphp/http-client @ v4.x'); $this->defaultCompressionHandler = new DecompressResponse; } public function build(): HttpClient { /** @var PooledHttpClient $client */ $client = new PooledHttpClient($this->pool); foreach ($this->networkInterceptors as $interceptor) { $client = $client->intercept($interceptor); } if ($this->defaultAcceptInterceptor) { $client = $client->intercept($this->defaultAcceptInterceptor); } if ($this->defaultUserAgentInterceptor) { $client = $client->intercept($this->defaultUserAgentInterceptor); } if ($this->defaultCompressionHandler) { $client = $client->intercept($this->defaultCompressionHandler); } $applicationInterceptors = $this->applicationInterceptors; if ($this->followRedirectsInterceptor) { \array_unshift($applicationInterceptors, $this->followRedirectsInterceptor); } if ($this->forbidUriUserInfo) { \array_unshift($applicationInterceptors, $this->forbidUriUserInfo); } if ($this->retryInterceptor) { $applicationInterceptors[] = $this->retryInterceptor; } foreach (\array_reverse($applicationInterceptors) as $applicationInterceptor) { $client = new InterceptedHttpClient($client, $applicationInterceptor); } return new HttpClient($client); } /** * @param ConnectionPool $pool Connection pool to use. * * @return self */ public function usingPool(ConnectionPool $pool): self { $builder = clone $this; $builder->pool = $pool; return $builder; } /** * @param ApplicationInterceptor $interceptor This interceptor gets added to the interceptor queue, so interceptors * are executed in the order given to this method. * * @return self */ public function intercept(ApplicationInterceptor $interceptor): self { if ($this->followRedirectsInterceptor !== null && $interceptor instanceof FollowRedirects) { throw new \Error('Disable automatic redirect following or use HttpClientBuilder::followRedirects() to customize redirects'); } if ($this->retryInterceptor !== null && $interceptor instanceof RetryRequests) { throw new \Error('Disable automatic retries or use HttpClientBuilder::retry() to customize retries'); } $builder = clone $this; $builder->applicationInterceptors[] = $interceptor; return $builder; } /** * @param NetworkInterceptor $interceptor This interceptor gets added to the interceptor queue, so interceptors * are executed in the order given to this method. * * @return self */ public function interceptNetwork(NetworkInterceptor $interceptor): self { $builder = clone $this; $builder->networkInterceptors[] = $interceptor; return $builder; } /** * @param int $retryLimit Maximum number of times a request may be retried. Only certain requests will be retried * automatically (GET, HEAD, PUT, and DELETE requests are automatically retried, or any * request that was indicated as unprocessed by the connection). * * @return self */ public function retry(int $retryLimit): self { $builder = clone $this; if ($retryLimit <= 0) { $builder->retryInterceptor = null; } else { $builder->retryInterceptor = new RetryRequests($retryLimit); } return $builder; } /** * @param int $limit Maximum number of redirects to follow. The client will automatically request the URI supplied * by a redirect response (3xx status codes) and returns that response instead. * * @return self */ public function followRedirects(int $limit = 10): self { $builder = clone $this; if ($limit <= 0) { $builder->followRedirectsInterceptor = null; } else { $builder->followRedirectsInterceptor = new FollowRedirects($limit); } return $builder; } /** * Removes the default restriction of user:password in request URIs. * * @return self */ public function allowDeprecatedUriUserInfo(): self { $builder = clone $this; $builder->forbidUriUserInfo = null; return $builder; } /** * Doesn't automatically set an 'accept' header. * * @return self */ public function skipDefaultAcceptHeader(): self { $builder = clone $this; $builder->defaultAcceptInterceptor = null; return $builder; } /** * Doesn't automatically set a 'user-agent' header. * * @return self */ public function skipDefaultUserAgent(): self { $builder = clone $this; $builder->defaultUserAgentInterceptor = null; return $builder; } /** * Doesn't automatically set an 'accept-encoding' header and decompress the response. * * @return self */ public function skipAutomaticCompression(): self { $builder = clone $this; $builder->defaultCompressionHandler = null; return $builder; } } httpClient = $httpClient; $this->interceptor = $interceptor; } public function request(Request $request, CancellationToken $cancellation): Promise { return call(function () use ($request, $cancellation) { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->startRequest($request); } return $this->interceptor->request($request, $cancellation, $this->httpClient); }); } } */ public function request(Request $request, CancellationToken $cancellation): Promise; } stream = $stream; $this->interceptor = $interceptor; } public function request(Request $request, CancellationToken $cancellation): Promise { if (!$this->interceptor) { throw new \Error(__METHOD__ . ' may only be invoked once per instance. ' . 'If you need to implement retries or otherwise issue multiple requests, register an ApplicationInterceptor to do so.'); } $interceptor = $this->interceptor; $this->interceptor = null; return call(function () use ($interceptor, $request, $cancellation) { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->startRequest($request); } return $interceptor->requestViaNetwork($request, $cancellation, $this->stream); }); } public function getLocalAddress(): SocketAddress { return $this->stream->getLocalAddress(); } public function getRemoteAddress(): SocketAddress { return $this->stream->getRemoteAddress(); } public function getTlsInfo(): ?TlsInfo { return $this->stream->getTlsInfo(); } } socket = $socket; $this->buffer = $buffer !== '' ? $buffer : null; } public function read(): Promise { if ($this->buffer !== null) { $buffer = $this->buffer; $this->buffer = null; return new Success($buffer); } return $this->socket->read(); } public function close(): void { $this->socket->close(); } public function __destruct() { $this->close(); } public function write(string $data): Promise { return $this->socket->write($data); } public function end(string $finalData = ""): Promise { return $this->socket->end($finalData); } public function reference(): void { $this->socket->reference(); } public function unreference(): void { $this->socket->unreference(); } public function isClosed(): bool { return $this->socket->isClosed(); } public function getLocalAddress(): SocketAddress { return $this->socket->getLocalAddress(); } public function getRemoteAddress(): SocketAddress { return $this->socket->getRemoteAddress(); } public function setupTls(?CancellationToken $cancellationToken = null): Promise { return $this->socket->setupTls($cancellationToken); } public function shutdownTls(?CancellationToken $cancellationToken = null): Promise { return $this->socket->shutdownTls(); } public function getTlsState(): int { return $this->socket->getTlsState(); } public function getTlsInfo(): ?TlsInfo { return $this->socket->getTlsInfo(); } } getUri()->getHost(); }); } public static function byStaticKey( ConnectionPool $delegate, KeyedSemaphore $semaphore, string $key = '' ): self { return new self($delegate, $semaphore, static function () use ($key) { return $key; }); } public static function byCustomKey( ConnectionPool $delegate, KeyedSemaphore $semaphore, callable $requestToKeyMapper ): self { return new self($delegate, $semaphore, $requestToKeyMapper); } /** @var ConnectionPool */ private $delegate; /** @var KeyedSemaphore */ private $semaphore; /** @var callable */ private $requestToKeyMapper; private function __construct(ConnectionPool $delegate, KeyedSemaphore $semaphore, callable $requestToKeyMapper) { $this->delegate = $delegate; $this->semaphore = $semaphore; $this->requestToKeyMapper = $requestToKeyMapper; } public function getStream(Request $request, CancellationToken $cancellation): Promise { return call(function () use ($request, $cancellation) { /** @var Lock $lock */ $lock = yield $this->semaphore->acquire(($this->requestToKeyMapper)($request)); /** @var Stream $stream */ $stream = yield $this->delegate->getStream($request, $cancellation); return HttpStream::fromStream( $stream, coroutine(static function (Request $request, CancellationToken $cancellationToken) use ( $stream, $lock ) { try { /** @var Response $response */ $response = yield $stream->request($request, $cancellationToken); // await response being completely received $response->getTrailers()->onResolve(static function () use ($lock) { $lock->release(); }); } catch (\Throwable $e) { $lock->release(); throw $e; } return $response; }), static function () use ($lock) { $lock->release(); } ); }); } } getUri(); $scheme = $uri->getScheme(); $isHttps = $scheme === 'https'; $defaultPort = $isHttps ? 443 : 80; $host = $uri->getHost(); $port = $uri->getPort() ?? $defaultPort; $authority = $host . ':' . $port; return $scheme . '://' . $authority; } /** @var int */ private $connectionLimit; /** @var ConnectionFactory */ private $connectionFactory; /** @var array>> */ private $connections = []; /** @var Connection[] */ private $idleConnections = []; /** @var int[] */ private $activeRequestCounts = []; /** @var Deferred[][] */ private $waiting = []; /** @var bool[] */ private $waitForPriorConnection = []; /** @var int */ private $totalConnectionAttempts = 0; /** @var int */ private $totalStreamRequests = 0; /** @var int */ private $openConnectionCount = 0; private function __construct(int $connectionLimit, ?ConnectionFactory $connectionFactory = null) { if ($connectionLimit < 1) { throw new \Error('The connection limit must be greater than 0'); } $this->connectionLimit = $connectionLimit; $this->connectionFactory = $connectionFactory ?? new DefaultConnectionFactory; } public function __clone() { $this->connections = []; $this->totalConnectionAttempts = 0; $this->totalStreamRequests = 0; $this->openConnectionCount = 0; } public function getTotalConnectionAttempts(): int { return $this->totalConnectionAttempts; } public function getTotalStreamRequests(): int { return $this->totalStreamRequests; } public function getOpenConnectionCount(): int { return $this->openConnectionCount; } public function getStream(Request $request, CancellationToken $cancellation): Promise { return call(function () use ($request, $cancellation) { $this->totalStreamRequests++; $uri = self::formatUri($request); // Using new Coroutine avoids a bug on PHP < 7.4, see #265 /** * @var Stream $stream * @psalm-suppress all */ [$connection, $stream] = yield new Coroutine($this->getStreamFor($uri, $request, $cancellation)); $connectionId = \spl_object_id($connection); $this->activeRequestCounts[$connectionId] = ($this->activeRequestCounts[$connectionId] ?? 0) + 1; unset($this->idleConnections[$connectionId]); return HttpStream::fromStream( $stream, coroutine(function (Request $request, CancellationToken $cancellationToken) use ( $connection, $stream, $uri ) { try { /** @var Response $response */ $response = yield $stream->request($request, $cancellationToken); } catch (\Throwable $e) { $this->onReadyConnection($connection, $uri); throw $e; } // await response being completely received $response->getTrailers()->onResolve(function () use ($connection, $uri): void { $this->onReadyConnection($connection, $uri); }); return $response; }), function () use ($connection, $uri): void { $this->onReadyConnection($connection, $uri); } ); }); } private function getStreamFor(string $uri, Request $request, CancellationToken $cancellation): \Generator { $isHttps = $request->getUri()->getScheme() === 'https'; $connections = $this->connections[$uri] ?? new \ArrayObject; do { foreach ($connections as $connectionPromise) { \assert($connectionPromise instanceof Promise); try { if ($isHttps && ($this->waitForPriorConnection[$uri] ?? true)) { // Wait for first successful connection if using a secure connection (maybe we can use HTTP/2). $connection = yield $connectionPromise; } else { $connection = yield Promise\first([$connectionPromise, new Success]); if ($connection === null) { continue; } } } catch (\Exception $exception) { continue; // Ignore cancellations and errors of other requests. } \assert($connection instanceof Connection); $stream = yield $this->getStreamFromConnection($connection, $request); if ($stream === null) { if (!$this->isAdditionalConnectionAllowed($uri) && $this->isConnectionIdle($connection)) { $connection->close(); break; } continue; // No stream available for the given request. } return [$connection, $stream]; } $deferred = new Deferred; $deferredId = \spl_object_id($deferred); $this->waiting[$uri][$deferredId] = $deferred; $deferredPromise = $deferred->promise(); $deferredPromise->onResolve(function () use ($uri, $deferredId): void { $this->removeWaiting($uri, $deferredId); }); if ($this->isAdditionalConnectionAllowed($uri)) { break; } $connection = yield $deferredPromise; \assert($connection instanceof Connection); $stream = yield $this->getStreamFromConnection($connection, $request); if ($stream === null) { continue; // Wait for a different connection to become available. } return [$connection, $stream]; } while (true); $this->totalConnectionAttempts++; $connectionPromise = $this->connectionFactory->create($request, $cancellation); $promiseId = \spl_object_id($connectionPromise); $this->connections[$uri] = $this->connections[$uri] ?? new \ArrayObject; $this->connections[$uri][$promiseId] = $connectionPromise; $connectionPromise->onResolve(function (?\Throwable $exception, ?Connection $connection) use ( &$deferred, $uri, $promiseId, $isHttps ): void { if ($exception) { $this->dropConnection($uri, null, $promiseId); if ($deferred !== null) { $deferred->fail($exception); // Fail Deferred so Promise\first() below fails. } return; } \assert($connection !== null); $connectionId = \spl_object_id($connection); $this->openConnectionCount++; if ($isHttps) { $this->waitForPriorConnection[$uri] = \in_array('2', $connection->getProtocolVersions(), true); } $connection->onClose(function () use ($uri, $connectionId, $promiseId): void { $this->openConnectionCount--; $this->dropConnection($uri, $connectionId, $promiseId); }); }); try { $connection = yield Promise\first([$connectionPromise, $deferredPromise]); } catch (MultiReasonException $exception) { [$exception] = $exception->getReasons(); // The first reason is why the connection failed. throw $exception; } $deferred = null; // Null reference so connection promise handler does not double-resolve the Deferred. $this->removeWaiting($uri, $deferredId); // Deferred no longer needed for this request. \assert($connection instanceof Connection); $stream = yield $this->getStreamFromConnection($connection, $request); if ($stream === null) { // Reused connection did not have an available stream for the given request. $connection = yield $connectionPromise; // Wait for new connection request instead. $stream = yield $this->getStreamFromConnection($connection, $request); if ($stream === null) { // Other requests used the new connection first, so we need to go around again. // Using new Coroutine avoids a bug on PHP < 7.4, see #265 return yield new Coroutine($this->getStreamFor($uri, $request, $cancellation)); } } return [$connection, $stream]; } private function getStreamFromConnection(Connection $connection, Request $request): Promise { if (!\array_intersect($request->getProtocolVersions(), $connection->getProtocolVersions())) { return new Success; // Connection does not support any of the requested protocol versions. } return $connection->getStream($request); } private function isAdditionalConnectionAllowed(string $uri): bool { return \count($this->connections[$uri] ?? []) < $this->connectionLimit; } private function onReadyConnection(Connection $connection, string $uri): void { $connectionId = \spl_object_id($connection); if (isset($this->activeRequestCounts[$connectionId])) { $this->activeRequestCounts[$connectionId]--; if ($this->activeRequestCounts[$connectionId] === 0) { while (\count($this->idleConnections) > 64) { // not customizable for now $idleConnection = \reset($this->idleConnections); $key = \key($this->idleConnections); unset($this->idleConnections[$key]); $idleConnection->close(); } $this->idleConnections[$connectionId] = $connection; } } if (empty($this->waiting[$uri])) { return; } $deferred = \reset($this->waiting[$uri]); // Deferred is removed from waiting list in onResolve callback attached above. $deferred->resolve($connection); } private function isConnectionIdle(Connection $connection): bool { $connectionId = \spl_object_id($connection); \assert( !isset($this->activeRequestCounts[$connectionId]) || $this->activeRequestCounts[$connectionId] >= 0 ); return ($this->activeRequestCounts[$connectionId] ?? 0) === 0; } private function removeWaiting(string $uri, int $deferredId): void { unset($this->waiting[$uri][$deferredId]); if (empty($this->waiting[$uri])) { unset($this->waiting[$uri]); } } private function dropConnection(string $uri, ?int $connectionId, int $promiseId): void { unset($this->connections[$uri][$promiseId]); if ($connectionId !== null) { unset($this->activeRequestCounts[$connectionId], $this->idleConnections[$connectionId]); } if ($this->connections[$uri]->count() === 0) { unset($this->connections[$uri], $this->waitForPriorConnection[$uri]); } } } connector = $connector; $this->connectContext = $connectContext; } public function create( Request $request, CancellationToken $cancellationToken ): Promise { return call(function () use ($request, $cancellationToken) { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->startConnectionCreation($request); } $connector = $this->connector ?? connector(); $connectContext = $this->connectContext ?? new ConnectContext; $uri = $request->getUri(); $scheme = $uri->getScheme(); if (!\in_array($scheme, ['http', 'https'], true)) { throw new InvalidRequestException($request, 'Invalid scheme provided in the request URI: ' . $uri); } $isHttps = $scheme === 'https'; $defaultPort = $isHttps ? 443 : 80; $host = $uri->getHost(); $port = $uri->getPort() ?? $defaultPort; if ($host === '') { throw new InvalidRequestException($request, 'A host must be provided in the request URI: ' . $uri); } $authority = $host . ':' . $port; $protocolVersions = $request->getProtocolVersions(); $isConnect = $request->getMethod() === 'CONNECT'; if ($isHttps) { $protocols = []; if (!$isConnect && \in_array('2', $protocolVersions, true)) { $protocols[] = 'h2'; } if (\in_array('1.1', $protocolVersions, true) || \in_array('1.0', $protocolVersions, true)) { $protocols[] = 'http/1.1'; } if (!$protocols) { throw new InvalidRequestException( $request, \sprintf( "None of the requested protocol versions (%s) are supported by %s (HTTP/2 is only supported on HTTPS)", \implode(', ', $protocolVersions), self::class ) ); } $tlsContext = ($connectContext->getTlsContext() ?? new ClientTlsContext('')) ->withPeerCapturing(); // If we only have HTTP/1.1 available, don't set application layer protocols. // There are misbehaving sites like n11.com, see https://github.com/amphp/http-client/issues/255 if ($protocols !== ['http/1.1'] && Socket\hasTlsAlpnSupport()) { $tlsContext = $tlsContext->withApplicationLayerProtocols($protocols); } if ($tlsContext->getPeerName() === '') { $tlsContext = $tlsContext->withPeerName($host); } $connectContext = $connectContext->withTlsContext($tlsContext); } try { /** @var EncryptableSocket $socket */ $socket = yield $connector->connect( 'tcp://' . $authority, $connectContext->withConnectTimeout($request->getTcpConnectTimeout()), $cancellationToken ); } catch (Socket\ConnectException $e) { throw new UnprocessedRequestException( new SocketException(\sprintf("Connection to '%s' failed", $authority), 0, $e) ); } catch (CancelledException $e) { // In case of a user cancellation request, throw the expected exception $cancellationToken->throwIfRequested(); // Otherwise we ran into a timeout of our TimeoutCancellationToken throw new UnprocessedRequestException(new TimeoutException(\sprintf( "Connection to '%s' timed out, took longer than " . $request->getTcpConnectTimeout() . ' ms', $authority ))); // don't pass $e } if ($isHttps) { try { $tlsState = $socket->getTlsState(); // Error if anything enabled TLS on a new connection before we can do it if ($tlsState !== EncryptableSocket::TLS_STATE_DISABLED) { $socket->close(); throw new UnprocessedRequestException( new SocketException('Failed to setup TLS connection, connection was in an unexpected TLS state (' . $tlsState . ')') ); } foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->startTlsNegotiation($request); } $tlsCancellationToken = new CombinedCancellationToken( $cancellationToken, new TimeoutCancellationToken($request->getTlsHandshakeTimeout()) ); yield $socket->setupTls($tlsCancellationToken); foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeTlsNegotiation($request); } } catch (StreamException $exception) { $socket->close(); throw new UnprocessedRequestException(new SocketException(\sprintf( "Connection to '%s' @ '%s' closed during TLS handshake", $authority, $socket->getRemoteAddress()->toString() ), 0, $exception)); } catch (CancelledException $e) { $socket->close(); // In case of a user cancellation request, throw the expected exception $cancellationToken->throwIfRequested(); // Otherwise we ran into a timeout of our TimeoutCancellationToken throw new UnprocessedRequestException(new TimeoutException(\sprintf( "TLS handshake with '%s' @ '%s' timed out, took longer than " . $request->getTlsHandshakeTimeout() . ' ms', $authority, $socket->getRemoteAddress()->toString() ))); // don't pass $e } $tlsInfo = $socket->getTlsInfo(); if ($tlsInfo === null) { throw new UnprocessedRequestException( new SocketException(\sprintf( "Socket closed after TLS handshake with '%s' @ '%s'", $authority, $socket->getRemoteAddress()->toString() )) ); } if ($tlsInfo->getApplicationLayerProtocol() === 'h2') { $http2Connection = new Http2Connection($socket); yield $http2Connection->initialize(); foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeConnectionCreation($request); } return $http2Connection; } } // Treat the presence of only HTTP/2 as prior knowledge, see https://http2.github.io/http2-spec/#known-http if ($request->getProtocolVersions() === ['2']) { $http2Connection = new Http2Connection($socket); yield $http2Connection->initialize(); foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeConnectionCreation($request); } return $http2Connection; } if (!\array_intersect($request->getProtocolVersions(), ['1.0', '1.1'])) { $socket->close(); throw new InvalidRequestException( $request, \sprintf( "None of the requested protocol versions (%s) are supported by '%s' @ '%s'", \implode(', ', $protocolVersions), $authority, $socket->getRemoteAddress()->toString() ) ); } foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeConnectionCreation($request); } return new Http1Connection($socket); }); } } */ public function getStream(Request $request, CancellationToken $cancellation): Promise; } \d+\.\d+)[\x20\x09]+ (?P[1-9]\d\d)[\x20\x09]* (?P[^\x01-\x08\x10-\x19]*) $#ix"; public const AWAITING_HEADERS = 0; public const BODY_IDENTITY = 1; public const BODY_IDENTITY_EOF = 2; public const BODY_CHUNKS = 3; public const TRAILERS_START = 4; public const TRAILERS = 5; /** @var int */ private $state = self::AWAITING_HEADERS; /** @var string */ private $buffer = ''; /** @var string|null */ private $protocol; /** @var int|null */ private $statusCode; /** @var string|null */ private $statusReason; /** @var string[][] */ private $headers = []; /** @var int|null */ private $remainingBodyBytes; /** @var int */ private $bodyBytesConsumed = 0; /** @var bool */ private $chunkedEncoding = false; /** @var int|null */ private $chunkLengthRemaining; /** @var bool */ private $complete = false; /** @var Request */ private $request; /** @var int */ private $maxHeaderBytes; /** @var int */ private $maxBodyBytes; /** @var callable */ private $bodyDataCallback; /** @var callable */ private $trailersCallback; public function __construct(Request $request, callable $bodyDataCallback, callable $trailersCallback) { $this->request = $request; $this->bodyDataCallback = $bodyDataCallback; $this->trailersCallback = $trailersCallback; $this->maxHeaderBytes = $request->getHeaderSizeLimit(); $this->maxBodyBytes = $request->getBodySizeLimit(); } public function getBuffer(): string { return $this->buffer; } public function getState(): int { return $this->state; } public function buffer(string $data): void { $this->buffer .= $data; } /** * @param string|null $data * * @return Response|null * * @throws ParseException */ public function parse(string $data = null): ?Response { if ($data !== null) { $this->buffer .= $data; } if ($this->buffer === '') { return null; } if ($this->complete) { throw new ParseException('Can\'t continue parsing, response is already complete', Status::BAD_REQUEST); } switch ($this->state) { case self::AWAITING_HEADERS: goto headers; case self::BODY_IDENTITY: goto body_identity; case self::BODY_IDENTITY_EOF: goto body_identity_eof; case self::BODY_CHUNKS: goto body_chunks; case self::TRAILERS_START: goto trailers_start; case self::TRAILERS: goto trailers; } headers: { $startLineAndHeaders = $this->shiftHeadersFromBuffer(); if ($startLineAndHeaders === null) { return null; } $startLineEndPos = \strpos($startLineAndHeaders, "\r\n"); \assert($startLineEndPos !== false); $startLine = \substr($startLineAndHeaders, 0, $startLineEndPos); $rawHeaders = \substr($startLineAndHeaders, $startLineEndPos + 2); if (\preg_match(self::STATUS_LINE_PATTERN, $startLine, $match)) { $this->protocol = $match['protocol']; $this->statusCode = (int) $match['status']; $this->statusReason = \trim($match['reason']); } else { throw new ParseException('Invalid status line: ' . $startLine, Status::BAD_REQUEST); } if ($rawHeaders !== '') { $this->headers = $this->parseRawHeaders($rawHeaders); } else { $this->headers = []; } $requestMethod = $this->request->getMethod(); $skipBody = $this->statusCode < Status::OK || $this->statusCode === Status::NOT_MODIFIED || $this->statusCode === Status::NO_CONTENT || $requestMethod === 'HEAD' || $requestMethod === 'CONNECT'; if ($skipBody) { $this->complete = true; } elseif ($this->chunkedEncoding) { $this->state = self::BODY_CHUNKS; } elseif ($this->remainingBodyBytes === null) { $this->state = self::BODY_IDENTITY_EOF; } elseif ($this->remainingBodyBytes > 0) { $this->state = self::BODY_IDENTITY; } else { $this->complete = true; } $response = new Response($this->protocol, $this->statusCode, $this->statusReason, [], new InMemoryStream, $this->request); foreach ($this->headers as [$key, $value]) { $response->addHeader($key, $value); } return $response; } body_identity: { $bufferDataSize = \strlen($this->buffer); if ($bufferDataSize <= $this->remainingBodyBytes) { $chunk = $this->buffer; $this->buffer = ''; $this->remainingBodyBytes -= $bufferDataSize; $this->addToBody($chunk); if ($this->remainingBodyBytes === 0) { $this->complete = true; } return null; } $bodyData = \substr($this->buffer, 0, $this->remainingBodyBytes); $this->addToBody($bodyData); $this->buffer = \substr($this->buffer, $this->remainingBodyBytes); $this->remainingBodyBytes = 0; goto complete; } body_identity_eof: { $this->addToBody($this->buffer); $this->buffer = ''; return null; } body_chunks: { if ($this->parseChunkedBody()) { $this->state = self::TRAILERS_START; goto trailers_start; } return null; } trailers_start: { $firstTwoBytes = \substr($this->buffer, 0, 2); if ($firstTwoBytes === "" || $firstTwoBytes === "\r") { return null; } if ($firstTwoBytes === "\r\n") { $this->buffer = \substr($this->buffer, 2); goto complete; } $this->state = self::TRAILERS; goto trailers; } trailers: { $trailers = $this->shiftHeadersFromBuffer(); if ($trailers === null) { return null; } $this->parseTrailers($trailers); goto complete; } complete: { $this->complete = true; return null; } } public function isComplete(): bool { return $this->complete; } /** * @return string|null * * @throws ParseException */ private function shiftHeadersFromBuffer(): ?string { $this->buffer = \ltrim($this->buffer, "\r\n"); if ($headersSize = \strpos($this->buffer, "\r\n\r\n")) { $headers = \substr($this->buffer, 0, $headersSize + 2); $this->buffer = \substr($this->buffer, $headersSize + 4); } else { $headersSize = \strlen($this->buffer); $headers = null; } if ($this->maxHeaderBytes > 0 && $headersSize > $this->maxHeaderBytes) { throw new ParseException("Configured header size exceeded: {$headersSize} bytes received, while the configured limit is {$this->maxHeaderBytes} bytes", Status::REQUEST_HEADER_FIELDS_TOO_LARGE); } return $headers; } /** * @param string $rawHeaders * * @return array * * @throws ParseException */ private function parseRawHeaders(string $rawHeaders): array { // Legacy support for folded headers if (\strpos($rawHeaders, "\r\n\x20") || \strpos($rawHeaders, "\r\n\t")) { $rawHeaders = \preg_replace("/\r\n[\x20\t]++/", ' ', $rawHeaders); } try { $headers = Rfc7230::parseRawHeaders($rawHeaders); $headerMap = []; foreach ($headers as [$key, $value]) { $headerMap[\strtolower($key)][] = $value; } } catch (InvalidHeaderException $e) { throw new ParseException('Invalid headers', Status::BAD_REQUEST, $e); } if (isset($headerMap['transfer-encoding'])) { $transferEncodings = \explode(',', \strtolower(\implode(',', $headerMap['transfer-encoding']))); $transferEncodings = \array_map('trim', $transferEncodings); $this->chunkedEncoding = \in_array('chunked', $transferEncodings, true); } elseif (isset($headerMap['content-length'])) { if (\count($headerMap['content-length']) > 1) { throw new ParseException('Can\'t determine body length, because multiple content-length headers present in the response', Status::BAD_REQUEST); } $contentLength = $headerMap['content-length'][0]; if (!\preg_match('/^(0|[1-9][0-9]*)$/', $contentLength)) { throw new ParseException('Can\'t determine body length, because the content-length header value is invalid', Status::BAD_REQUEST); } $this->remainingBodyBytes = (int) $contentLength; } return $headers; } /** * Decodes a chunked response body. * * @return bool {@code true} if the body is complete, otherwise {@code false}. * * @throws ParseException */ private function parseChunkedBody(): bool { if ($this->chunkLengthRemaining !== null) { goto decode_chunk; } determine_chunk_size: { if (false === ($lineEndPos = \strpos($this->buffer, "\r\n"))) { return false; } if ($lineEndPos === 0) { throw new ParseException('Invalid line; hexadecimal chunk size expected', Status::BAD_REQUEST); } $line = \substr($this->buffer, 0, $lineEndPos); $hex = \strtolower(\trim(\ltrim($line, '0'))) ?: '0'; $dec = \hexdec($hex); if ($hex !== \dechex($dec)) { throw new ParseException('Invalid hexadecimal chunk size', Status::BAD_REQUEST); } $this->chunkLengthRemaining = $dec; $this->buffer = \substr($this->buffer, $lineEndPos + 2); if ($this->chunkLengthRemaining === 0) { return true; } } decode_chunk: { $bufferLength = \strlen($this->buffer); // These first two (extreme) edge cases prevent errors where the packet boundary ends after // the \r and before the \n at the end of a chunk. if ($bufferLength === $this->chunkLengthRemaining || $bufferLength === $this->chunkLengthRemaining + 1) { return false; } if ($bufferLength >= $this->chunkLengthRemaining + 2) { $chunk = \substr($this->buffer, 0, $this->chunkLengthRemaining); $this->buffer = \substr($this->buffer, $this->chunkLengthRemaining + 2); $this->chunkLengthRemaining = null; $this->addToBody($chunk); goto determine_chunk_size; } /** @noinspection SuspiciousAssignmentsInspection */ $chunk = $this->buffer; $this->buffer = ''; $this->chunkLengthRemaining -= $bufferLength; $this->addToBody($chunk); return false; } } /** * @param string $trailers * * @throws ParseException */ private function parseTrailers(string $trailers): void { try { $trailers = Rfc7230::parseHeaders($trailers); } catch (InvalidHeaderException $e) { throw new ParseException('Invalid trailers', Status::BAD_REQUEST, $e); } ($this->trailersCallback)($trailers); } /** * @param string $data * * @throws ParseException */ private function addToBody(string $data): void { $length = \strlen($data); if (!$length) { return; } $this->bodyBytesConsumed += $length; if ($this->maxBodyBytes > 0 && $this->bodyBytesConsumed > $this->maxBodyBytes) { throw new ParseException("Configured body size exceeded: {$this->bodyBytesConsumed} bytes received, while the configured limit is {$this->maxBodyBytes} bytes", Status::PAYLOAD_TOO_LARGE); } if ($this->bodyDataCallback) { ($this->bodyDataCallback)($data); } } } id = $id; $this->request = $request; $this->stream = $stream; $this->cancellationToken = $cancellationToken; $this->originalCancellation = $originalCancellation; $this->watcher = $watcher; $this->serverWindow = $serverSize; $this->clientWindow = $clientSize; $this->pendingResponse = new Deferred; $this->requestBodyCompletion = new Deferred; $this->bufferSize = 0; } public function __destruct() { if ($this->watcher !== null) { Loop::cancel($this->watcher); } } public function disableInactivityWatcher(): void { if ($this->watcher === null) { return; } Loop::disable($this->watcher); } public function enableInactivityWatcher(): void { if ($this->watcher === null) { return; } Loop::disable($this->watcher); Loop::enable($this->watcher); } } socket = $socket; $this->hpack = new HPack; $this->frameQueueEmitter = new Emitter; $this->frameQueue = $this->frameQueueEmitter->iterate(); } public function isInitialized(): bool { return $this->initialized; } /** * Returns a promise that is resolved once the connection has been initialized. A stream cannot be obtained from the * connection until the promise returned by this method resolves. * * @return Promise */ public function initialize(): Promise { if ($this->initializeStarted) { throw new \Error('Connection may only be initialized once'); } $this->initializeStarted = true; if ($this->socket->isClosed()) { return new Failure(new UnprocessedRequestException( new SocketException('The socket closed before the connection could be initialized') )); } $this->settings = new Deferred; $promise = $this->settings->promise(); Promise\rethrow(new Coroutine($this->run())); return $promise; } public function onClose(callable $onClose): void { if ($this->onClose === null) { asyncCall($onClose, $this); return; } $this->onClose[] = $onClose; } public function close(): Promise { $this->shutdown(new SocketException('Socket from \'' . $this->socket->getLocalAddress() . '\' to \'' . $this->socket->getRemoteAddress() . '\' closed')); $this->socket->close(); if ($this->onClose !== null) { $onClose = $this->onClose; $this->onClose = null; foreach ($onClose as $callback) { asyncCall($callback, $this); } } return new Success; } public function handlePong(string $data): void { if ($this->pongDeferred === null) { return; } if ($this->pongWatcher !== null) { Loop::cancel($this->pongWatcher); $this->pongWatcher = null; } $this->hasTimeout = false; $deferred = $this->pongDeferred; $this->pongDeferred = null; $deferred->resolve(true); } public function handlePing(string $data): void { $this->writeFrame(Http2Parser::PING, Http2Parser::ACK, 0, $data); } public function handleShutdown(int $lastId, int $error): void { $message = \sprintf( "Received GOAWAY frame on '%s' from '%s' with error code %d", (string) $this->socket->getLocalAddress(), (string) $this->socket->getRemoteAddress(), $error ); /** * @psalm-suppress DeprecatedClass * @noinspection PhpDeprecationInspection */ $this->shutdown(new ClientHttp2ConnectionException($message, $error), $lastId); } public function handleStreamWindowIncrement(int $streamId, int $windowSize): void { if (!isset($this->streams[$streamId])) { return; } $stream = $this->streams[$streamId]; if ($stream->clientWindow + $windowSize > 2147483647) { $this->handleStreamException(new Http2StreamException( "Current window size plus new window exceeds maximum size", $streamId, Http2Parser::FLOW_CONTROL_ERROR )); return; } $stream->clientWindow += $windowSize; $this->writeBufferedData($stream); } public function handleConnectionWindowIncrement(int $windowSize): void { if ($this->clientWindow + $windowSize > 2147483647) { $this->handleConnectionException(new Http2ConnectionException( "Current window size plus new window exceeds maximum size", Http2Parser::FLOW_CONTROL_ERROR )); return; } $this->clientWindow += $windowSize; foreach ($this->streams as $stream) { if ($this->clientWindow <= 0) { return; } if ($stream->requestBodyBuffer === '' || $stream->clientWindow <= 0) { continue; } $this->writeBufferedData($stream); } } public function handleHeaders(int $streamId, array $pseudo, array $headers, bool $streamEnded): void { foreach ($pseudo as $name => $value) { if (!isset(Http2Parser::KNOWN_RESPONSE_PSEUDO_HEADERS[$name])) { throw new Http2StreamException( "Invalid pseudo header", $streamId, Http2Parser::PROTOCOL_ERROR ); } } if (!isset($this->streams[$streamId])) { return; } $stream = $this->streams[$streamId]; $stream->enableInactivityWatcher(); $this->hasTimeout = false; if ($stream->trailers) { if ($stream->expectedLength && $stream->received !== $stream->expectedLength) { $diff = $stream->expectedLength - $stream->received; $this->handleStreamException(new Http2StreamException( "Content length mismatch: " . \abs($diff) . ' bytes ' . ($diff > 0 ? ' missing' : 'too much'), $streamId, Http2Parser::PROTOCOL_ERROR )); return; } if (!empty($pseudo)) { $this->handleStreamException(new Http2StreamException( "Trailers must not contain pseudo headers", $streamId, Http2Parser::PROTOCOL_ERROR )); return; } try { // Constructor checks for any disallowed fields $parsedTrailers = new Trailers($headers); } catch (InvalidHeaderException $exception) { $this->handleStreamException(new Http2StreamException( "Disallowed field names in trailer", $streamId, Http2Parser::PROTOCOL_ERROR, $exception )); return; } $trailers = $stream->trailers; $stream->trailers = null; $trailers->resolve(call(function () use ($stream, $streamId, $parsedTrailers) { try { foreach ($stream->request->getEventListeners() as $eventListener) { yield $eventListener->completeReceivingResponse($stream->request, $stream->stream); } return $parsedTrailers; } catch (\Throwable $e) { $this->handleStreamException(new Http2StreamException( "Event listener error", $streamId, Http2Parser::CANCEL )); throw $e; } })); $this->setupPingIfIdle(); return; } if (!isset($pseudo[":status"])) { $this->handleConnectionException(new Http2ConnectionException( "No status pseudo header in response", Http2Parser::PROTOCOL_ERROR )); return; } if (!\preg_match("/^[1-5]\d\d$/", $pseudo[":status"])) { $this->handleStreamException(new Http2StreamException( "Invalid response status code: " . $pseudo[':status'], $streamId, Http2Parser::PROTOCOL_ERROR )); return; } if ($stream->response !== null) { $this->handleStreamException(new Http2StreamException( "Stream headers already received", $streamId, Http2Parser::PROTOCOL_ERROR )); return; } $status = (int) $pseudo[":status"]; if ($status === Status::SWITCHING_PROTOCOLS) { $this->handleConnectionException(new Http2ConnectionException( "Switching Protocols (101) is not part of HTTP/2", Http2Parser::PROTOCOL_ERROR )); return; } $response = new Response( '2', $status, Status::getReason($status), $headers, new InMemoryStream, $stream->request ); if ($status < 200) { $onInformationalResponse = $stream->request->getInformationalResponseHandler(); if ($onInformationalResponse !== null) { $stream->preResponseResolution = call(function () use ( $onInformationalResponse, $response, $stream, $streamId ) { yield $stream->preResponseResolution; try { yield call($onInformationalResponse, $response); } catch (\Throwable $e) { $this->handleStreamException(new Http2StreamException( 'Informational response handler threw an exception', $streamId, Http2Parser::CANCEL )); } }); } return; } \assert($stream->preResponseResolution === null); $stream->preResponseResolution = call(function () use ($stream, $streamId) { try { foreach ($stream->request->getEventListeners() as $eventListener) { yield $eventListener->startReceivingResponse($stream->request, $stream->stream); } } catch (\Throwable $e) { $this->handleStreamException(new Http2StreamException( "Event listener error", $streamId, Http2Parser::CANCEL )); } }); $stream->body = new Emitter; $stream->trailers = new Deferred; $bodyCancellation = new CancellationTokenSource; $cancellationToken = new CombinedCancellationToken( $stream->cancellationToken, $bodyCancellation->getToken() ); $response->setBody( new ResponseBodyStream( new IteratorStream($stream->body->iterate()), $bodyCancellation ) ); $response->setTrailers($stream->trailers->promise()); \assert($stream->pendingResponse !== null); $stream->responsePending = false; $stream->pendingResponse->resolve(call(static function () use ($response, $stream) { yield $stream->requestBodyCompletion->promise(); yield $stream->preResponseResolution; $stream->preResponseResolution = null; $stream->pendingResponse = null; return $response; })); $this->increaseConnectionWindow(); $this->increaseStreamWindow($stream); if (isset($headers["content-length"])) { if (\count($headers['content-length']) !== 1) { $this->handleStreamException(new Http2StreamException( "Multiple content-length header values", $streamId, Http2Parser::PROTOCOL_ERROR )); return; } $contentLength = $headers["content-length"][0]; if (!\preg_match('/^(0|[1-9][0-9]*)$/', $contentLength)) { $this->handleStreamException(new Http2StreamException( "Invalid content-length header value", $streamId, Http2Parser::PROTOCOL_ERROR )); return; } $stream->expectedLength = (int) $contentLength; } $cancellationToken->subscribe(function (CancelledException $exception) use ($streamId): void { if (!isset($this->streams[$streamId])) { return; } $this->writeFrame( Http2Parser::RST_STREAM, Http2Parser::NO_FLAG, $streamId, \pack("N", Http2Parser::CANCEL) ); if (!$this->streams[$streamId]->originalCancellation->isRequested()) { $this->hasTimeout = true; $this->ping(); // async ping, if other requests occur, they wait for it $transferTimeout = $this->streams[$streamId]->request->getTransferTimeout(); $exception = new TimeoutException( 'Allowed transfer timeout exceeded, took longer than ' . $transferTimeout . ' ms', 0, $exception ); } $this->releaseStream($streamId, $exception); }); } public function handlePushPromise(int $streamId, int $pushId, array $pseudo, array $headers): void { if ($pushId % 2 === 1) { $this->handleConnectionException(new Http2ConnectionException( "Invalid server initiated stream", Http2Parser::PROTOCOL_ERROR )); return; } foreach ($pseudo as $name => $value) { if (!isset(Http2Parser::KNOWN_REQUEST_PSEUDO_HEADERS[$name])) { throw new Http2StreamException( "Invalid pseudo header", $pushId, Http2Parser::PROTOCOL_ERROR ); } } if (!isset($pseudo[":method"], $pseudo[":path"], $pseudo[":scheme"], $pseudo[":authority"]) || isset($headers["connection"]) || $pseudo[":path"] === '' || (isset($headers["te"]) && \implode($headers["te"]) !== "trailers") ) { $this->handleStreamException(new Http2StreamException( "Invalid header values", $pushId, Http2Parser::PROTOCOL_ERROR )); return; } $method = $pseudo[":method"]; $target = $pseudo[":path"]; $scheme = $pseudo[":scheme"]; $host = $pseudo[":authority"]; $query = null; if ($method !== 'GET' && $method !== 'HEAD') { $this->handleStreamException(new Http2StreamException( "Pushed request method must be a safe method", $pushId, Http2Parser::PROTOCOL_ERROR )); return; } if (!\preg_match("#^([A-Z\d.\-]+|\[[\d:]+])(?::([1-9]\d*))?$#i", $host, $matches)) { $this->handleStreamException(new Http2StreamException( "Invalid pushed authority (host) name", $pushId, Http2Parser::PROTOCOL_ERROR )); return; } $host = $matches[1]; $port = isset($matches[2]) ? (int) $matches[2] : $this->socket->getRemoteAddress()->getPort(); if (!isset($this->streams[$streamId])) { $this->handleStreamException(new Http2StreamException( "Parent stream {$streamId} is no longer open", $pushId, Http2Parser::PROTOCOL_ERROR )); return; } $parentStream = $this->streams[$streamId]; $parentStream->enableInactivityWatcher(); if (\strcasecmp($host, $parentStream->request->getUri()->getHost()) !== 0) { $this->handleStreamException(new Http2StreamException( "Authority does not match original request authority", $pushId, Http2Parser::PROTOCOL_ERROR )); return; } if ($position = \strpos($target, "#")) { $target = \substr($target, 0, $position); } if ($position = \strpos($target, "?")) { $query = \substr($target, $position + 1); $target = \substr($target, 0, $position); } try { $uri = Uri\Http::createFromComponents([ "scheme" => $scheme, "host" => $host, "port" => $port, "path" => $target, "query" => $query, ]); } catch (\Exception $exception) { $this->handleConnectionException(new Http2ConnectionException( "Invalid push URI", Http2Parser::PROTOCOL_ERROR )); return; } $request = new Request($uri, $method); $request->setHeaders($headers); $request->setProtocolVersions(['2']); $request->setPushHandler($parentStream->request->getPushHandler()); $request->setHeaderSizeLimit($parentStream->request->getHeaderSizeLimit()); $request->setBodySizeLimit($parentStream->request->getBodySizeLimit()); $request->setInactivityTimeout($parentStream->request->getInactivityTimeout()); $request->setTransferTimeout($parentStream->request->getTransferTimeout()); $stream = new Http2Stream( $pushId, $request, HttpStream::fromStream( $parentStream->stream, static function () { throw new \Error('Calling Stream::request() on a pushed request is forbidden'); }, static function () { // nothing to do } ), $parentStream->cancellationToken, $parentStream->originalCancellation, $this->createStreamInactivityWatcher($pushId, $request->getInactivityTimeout()), self::DEFAULT_WINDOW_SIZE, 0 ); $stream->dependency = $streamId; $this->streams[$pushId] = $stream; $stream->requestBodyComplete = true; $stream->requestBodyCompletion->resolve(); if ($parentStream->request->getPushHandler() === null) { $this->handleStreamException(new Http2StreamException( "Push promise refused", $pushId, Http2Parser::CANCEL )); return; } asyncCall(function () use ($pushId, $stream): \Generator { $tokenSource = new CancellationTokenSource; $cancellationToken = new CombinedCancellationToken( $stream->cancellationToken, $tokenSource->getToken() ); $cancellationId = $cancellationToken->subscribe(function ( CancelledException $exception ) use ($pushId): void { if (!isset($this->streams[$pushId])) { return; } $this->writeFrame( Http2Parser::RST_STREAM, Http2Parser::NO_FLAG, $pushId, \pack("N", Http2Parser::CANCEL) ); $this->releaseStream($pushId, $exception); }); $onPush = $stream->request->getPushHandler(); try { \assert($onPush !== null); \assert($stream->pendingResponse !== null); yield call($onPush, $stream->request, $stream->pendingResponse->promise()); } catch (HttpException | StreamException | CancelledException $exception) { $tokenSource->cancel($exception); } catch (\Throwable $exception) { $tokenSource->cancel($exception); throw $exception; } finally { $cancellationToken->unsubscribe($cancellationId); } }); } public function handlePriority(int $streamId, int $parentId, int $weight): void { if (!isset($this->streams[$streamId])) { return; } $stream = $this->streams[$streamId]; $stream->dependency = $parentId; $stream->weight = $weight; } public function handleStreamReset(int $streamId, int $errorCode): void { if (!isset($this->streams[$streamId])) { return; } $this->handleStreamException(new Http2StreamException("Stream closed by server", $streamId, $errorCode)); } public function handleStreamException(Http2StreamException $exception): void { $id = $exception->getStreamId(); $code = $exception->getCode(); /** * @psalm-suppress DeprecatedClass * @psalm-suppress InvalidScalarArgument * @noinspection PhpDeprecationInspection */ $exception = new ClientHttp2StreamException($exception->getMessage(), $id, $code, $exception); if ($code === Http2Parser::REFUSED_STREAM) { $exception = new UnprocessedRequestException($exception); } $this->writeFrame(Http2Parser::RST_STREAM, Http2Parser::NO_FLAG, $id, \pack("N", $code)); if (isset($this->streams[$id])) { $this->releaseStream($id, $exception); } } public function handleConnectionException(Http2ConnectionException $exception): void { /** * @psalm-suppress DeprecatedClass * @psalm-suppress InvalidScalarArgument * @noinspection PhpDeprecationInspection */ $this->shutdown( new ClientHttp2ConnectionException($exception->getMessage(), $exception->getCode(), $exception) ); $this->close(); } public function handleData(int $streamId, string $data): void { $length = \strlen($data); $this->serverWindow -= $length; $this->increaseConnectionWindow(); if (!isset($this->streams[$streamId])) { return; } $stream = $this->streams[$streamId]; $stream->disableInactivityWatcher(); if (!$stream->body) { $this->handleStreamException(new Http2StreamException( "Stream headers not complete or body already complete", $streamId, Http2Parser::PROTOCOL_ERROR )); return; } $stream->serverWindow -= $length; $stream->received += $length; $stream->bufferSize += $length; if ($stream->request->getBodySizeLimit() > 0 && $stream->received >= $stream->request->getBodySizeLimit()) { $this->handleStreamException(new Http2StreamException( "Body size limit exceeded", $streamId, Http2Parser::CANCEL )); return; } if ($stream->expectedLength !== null && $stream->received > $stream->expectedLength) { $this->handleStreamException(new Http2StreamException( "Body size exceeded content-length in header", $streamId, Http2Parser::CANCEL )); return; } $promise = $stream->body->emit($data); $promise->onResolve(function (?\Throwable $exception) use ($streamId, $length): void { if ($exception || !isset($this->streams[$streamId])) { return; } // Defer prevents sending increments for already closed streams Loop::defer(function () use ($streamId, $length) { if (!isset($this->streams[$streamId])) { return; } $this->streams[$streamId]->bufferSize -= $length; if ($this->streams[$streamId]->bufferSize === 0) { $this->streams[$streamId]->enableInactivityWatcher(); } $this->increaseStreamWindow($this->streams[$streamId]); }); }); } public function handleSettings(array $settings): void { foreach ($settings as $setting => $value) { $this->applySetting($setting, $value); } $this->writeFrame(Http2Parser::SETTINGS, Http2Parser::ACK); if ($this->settings) { $deferred = $this->settings; $this->settings = null; $this->initialized = true; $deferred->resolve($this->remainingStreams); } } public function handleStreamEnd(int $streamId): void { if (!isset($this->streams[$streamId])) { return; } $stream = $this->streams[$streamId]; if ($stream->expectedLength !== null && $stream->received !== $stream->expectedLength) { $this->handleStreamException(new Http2StreamException( "Body length does not match content-length header", $streamId, Http2Parser::PROTOCOL_ERROR )); return; } $body = $stream->body; $stream->body = null; \assert($body !== null); $trailers = $stream->trailers; $stream->trailers = null; \assert($trailers !== null); $body->complete(); $trailers->resolve(call(function () use ($stream, $streamId) { try { foreach ($stream->request->getEventListeners() as $eventListener) { yield $eventListener->completeReceivingResponse($stream->request, $stream->stream); } return new Trailers([]); } catch (\Throwable $e) { $this->handleStreamException(new Http2StreamException( "Event listener error", $streamId, Http2Parser::CANCEL )); throw $e; } })); $this->setupPingIfIdle(); // Stream might be cancelled right after body completion if (isset($this->streams[$streamId])) { $this->releaseStream($streamId); } } public function reserveStream(): void { if ($this->shutdown !== null || $this->hasWriteError || $this->hasTimeout) { throw new \Error("Can't reserve stream after shutdown started"); } --$this->remainingStreams; } public function unreserveStream(): void { ++$this->remainingStreams; \assert($this->remainingStreams <= $this->concurrentStreamLimit); } public function getRemainingStreams(): int { if ($this->shutdown !== null || $this->hasWriteError || $this->hasTimeout) { return 0; } return $this->remainingStreams; } public function request(Request $request, CancellationToken $cancellationToken, Stream $stream): Promise { return call(function () use ($request, $cancellationToken, $stream): \Generator { if ($this->shutdown !== null) { $exception = new UnprocessedRequestException(new SocketException(\sprintf( "Connection from '%s' to '%s' has already been shut down", (string) $this->socket->getLocalAddress(), (string) $this->socket->getRemoteAddress() ))); foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->abort($request, $exception); } throw $exception; } if ($this->hasTimeout && !yield $this->ping()) { $exception = new UnprocessedRequestException( new SocketException(\sprintf( "Socket to '%s' missed responding to PINGs", (string) $this->socket->getRemoteAddress() )) ); foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->abort($request, $exception); } throw $exception; } $this->idlePings = 0; $this->cancelIdleWatcher(); yield RequestNormalizer::normalizeRequest($request); // Remove defunct HTTP/1.x headers. $request->removeHeader('host'); $request->removeHeader('connection'); $request->removeHeader('keep-alive'); $request->removeHeader('transfer-encoding'); $request->removeHeader('upgrade'); $request->setProtocolVersions(['2']); if ($request->getMethod() === 'CONNECT') { $exception = new HttpException("CONNECT requests are currently not supported on HTTP/2"); foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->abort($request, $exception); } throw $exception; } if ($this->socket->isClosed()) { $exception = new UnprocessedRequestException( new SocketException(\sprintf( "Socket to '%s' closed before the request could be sent", (string) $this->socket->getRemoteAddress() )) ); foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->abort($request, $exception); } throw $exception; } $originalCancellation = $cancellationToken; if ($request->getTransferTimeout() > 0) { $cancellationToken = new CombinedCancellationToken( $cancellationToken, new TimeoutCancellationToken($request->getTransferTimeout()) ); } try { $headers = $this->generateHeaders($request); $body = $request->getBody()->createBodyStream(); foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->startSendingRequest($request, $stream); } $chunk = yield $body->read(); $streamId = $this->streamId += 2; // Client streams should be odd-numbered, starting at 1. $this->streams[$streamId] = $http2stream = new Http2Stream( $streamId, $request, $stream, $cancellationToken, $originalCancellation, $this->createStreamInactivityWatcher($streamId, $request->getInactivityTimeout()), self::DEFAULT_WINDOW_SIZE, $this->initialWindowSize ); $this->socket->reference(); $transferTimeout = $request->getTransferTimeout(); $cancellationId = $cancellationToken->subscribe(function (CancelledException $exception) use ( $streamId, $originalCancellation, $transferTimeout ): void { if (!isset($this->streams[$streamId])) { return; } $this->writeFrame( Http2Parser::RST_STREAM, Http2Parser::NO_FLAG, $streamId, \pack("N", Http2Parser::CANCEL) ); if (!$originalCancellation->isRequested()) { $this->hasTimeout = true; $this->ping(); // async ping, if other requests occur, they wait for it $exception = new TimeoutException( 'Allowed transfer timeout exceeded, took longer than ' . $transferTimeout . ' ms', 0, $exception ); } $this->releaseStream($streamId, $exception); }); if (!isset($this->streams[$streamId])) { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeSendingRequest($request, $stream); } \assert($http2stream->pendingResponse !== null); return yield $http2stream->pendingResponse->promise(); } $flag = Http2Parser::END_HEADERS | ($chunk === null ? Http2Parser::END_STREAM : Http2Parser::NO_FLAG); $headers = $this->hpack->encode($headers); if (\strlen($headers) > $this->frameSizeLimit) { /** @var string[] $split */ $split = \str_split($headers, $this->frameSizeLimit); $firstChunk = \array_shift($split); $lastChunk = \array_pop($split); // no yield, because there must not be other frames in between $this->writeFrame(Http2Parser::HEADERS, Http2Parser::NO_FLAG, $streamId, $firstChunk); foreach ($split as $headerChunk) { // no yield, because there must not be other frames in between $this->writeFrame(Http2Parser::CONTINUATION, Http2Parser::NO_FLAG, $streamId, $headerChunk); } yield $this->writeFrame(Http2Parser::CONTINUATION, $flag, $streamId, $lastChunk); } else { yield $this->writeFrame(Http2Parser::HEADERS, $flag, $streamId, $headers); } if ($chunk === null) { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeSendingRequest($request, $stream); } $http2stream->requestBodyComplete = true; $http2stream->requestBodyCompletion->resolve(); \assert($http2stream->pendingResponse !== null); return yield $http2stream->pendingResponse->promise(); } $buffer = $chunk; while (null !== $chunk = yield $body->read()) { if (!isset($this->streams[$streamId])) { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeSendingRequest($request, $stream); } \assert($http2stream->pendingResponse !== null); return yield $http2stream->pendingResponse->promise(); } yield $this->writeData($http2stream, $buffer); $buffer = $chunk; } if (!isset($this->streams[$streamId])) { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeSendingRequest($request, $stream); } \assert($http2stream->pendingResponse !== null); return yield $http2stream->pendingResponse->promise(); } \assert($http2stream->pendingResponse !== null); $responsePromise = $http2stream->pendingResponse->promise(); $http2stream->requestBodyComplete = true; $http2stream->requestBodyCompletion->resolve(); yield $this->writeData($http2stream, $buffer); foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeSendingRequest($request, $stream); } return yield $responsePromise; } catch (\Throwable $exception) { if (isset($streamId) && isset($this->streams[$streamId])) { \assert(isset($http2stream)); if (!$http2stream->requestBodyComplete) { $http2stream->requestBodyCompletion->fail($exception); } $this->releaseStream($streamId, $exception); } if ($exception instanceof StreamException) { $message = 'Failed to write request (stream ' . ($streamId ?? 'not assigned') . ') to socket: ' . $exception->getMessage(); $exception = new SocketException($message, 0, $exception); } throw $exception; } finally { if (isset($cancellationId)) { $cancellationToken->unsubscribe($cancellationId); } } }); } public function isClosed(): bool { return $this->onClose === null; } private function run(): \Generator { try { yield $this->socket->write(Http2Parser::PREFACE); Promise\rethrow(new Coroutine($this->runWriteThread())); yield $this->writeFrame( Http2Parser::SETTINGS, 0, 0, \pack( "nNnNnNnN", Http2Parser::ENABLE_PUSH, 1, Http2Parser::MAX_CONCURRENT_STREAMS, 256, Http2Parser::INITIAL_WINDOW_SIZE, self::DEFAULT_WINDOW_SIZE, Http2Parser::MAX_FRAME_SIZE, self::DEFAULT_MAX_FRAME_SIZE ) ); } catch (\Throwable $e) { /** * @psalm-suppress DeprecatedClass * @noinspection PhpDeprecationInspection */ $this->shutdown(new ClientHttp2ConnectionException( 'The HTTP/2 connection closed' . ($this->shutdown !== null ? ' unexpectedly' : ''), $this->shutdown ?? Http2Parser::INTERNAL_ERROR )); $this->close(); return; } try { $parser = (new Http2Parser($this))->parse(); while (null !== $chunk = yield $this->socket->read()) { $return = $parser->send($chunk); \assert($return === null); } /** * @psalm-suppress DeprecatedClass * @noinspection PhpDeprecationInspection */ $this->shutdown(new ClientHttp2ConnectionException( "The HTTP/2 connection from '" . $this->socket->getLocalAddress() . "' to '" . $this->socket->getRemoteAddress() . "' closed" . ($this->shutdown === null ? ' unexpectedly' : ''), $this->shutdown ?? Http2Parser::INTERNAL_ERROR )); $this->close(); } catch (\Throwable $exception) { /** * @psalm-suppress DeprecatedClass * @noinspection PhpDeprecationInspection */ $this->shutdown(new ClientHttp2ConnectionException( "The HTTP/2 connection from '" . $this->socket->getLocalAddress() . "' to '" . $this->socket->getRemoteAddress() . "' closed unexpectedly: " . $exception->getMessage(), Http2Parser::INTERNAL_ERROR, $exception )); $this->close(); } } private function writeFrame( int $type, int $flags = Http2Parser::NO_FLAG, int $stream = 0, string $data = '' ): Promise { \assert(Http2Parser::logDebugFrame('send', $type, $flags, $stream, \strlen($data))); return $this->frameQueueEmitter->emit(\substr(\pack("NccN", \strlen($data), $type, $flags, $stream), 1) . $data); } private function applySetting(int $setting, int $value): void { switch ($setting) { case Http2Parser::INITIAL_WINDOW_SIZE: if ($value < 0 || $value > 2147483647) { // (1 << 31) - 1 $this->handleConnectionException(new Http2ConnectionException( "Invalid window size: {$value}", Http2Parser::FLOW_CONTROL_ERROR )); return; } $priorWindowSize = $this->initialWindowSize; $this->initialWindowSize = $value; $difference = $this->initialWindowSize - $priorWindowSize; foreach ($this->streams as $stream) { $stream->clientWindow += $difference; } // Settings ACK should be sent before HEADER or DATA frames. if ($difference > 0) { Loop::defer(function () { foreach ($this->streams as $stream) { if ($this->clientWindow <= 0) { return; } if ($stream->requestBodyBuffer === '' || $stream->clientWindow <= 0) { continue; } $this->writeBufferedData($stream); } }); } return; case Http2Parser::MAX_FRAME_SIZE: if ($value < 1 << 14 || $value >= 1 << 24) { $this->handleConnectionException(new Http2ConnectionException( "Invalid maximum frame size: {$value}", Http2Parser::PROTOCOL_ERROR )); return; } $this->frameSizeLimit = $value; return; case Http2Parser::MAX_CONCURRENT_STREAMS: if ($value < 0 || $value > 2147483647) { // (1 << 31) - 1 $this->handleConnectionException(new Http2ConnectionException( "Invalid concurrent streams value: {$value}", Http2Parser::PROTOCOL_ERROR )); return; } $priorUsedStreams = $this->concurrentStreamLimit - $this->remainingStreams; $this->concurrentStreamLimit = $value; $this->remainingStreams = $this->concurrentStreamLimit - $priorUsedStreams; \assert($this->remainingStreams <= $this->concurrentStreamLimit); return; case Http2Parser::HEADER_TABLE_SIZE: // TODO Respect this setting from the server case Http2Parser::MAX_HEADER_LIST_SIZE: // TODO Respect this setting from the server case Http2Parser::ENABLE_PUSH: // No action needed. default: // Unknown setting, ignore (6.5.2). return; } } private function writeBufferedData(Http2Stream $stream): Promise { if ($stream->requestBodyComplete && $stream->requestBodyBuffer === '') { return new Success; } $windowSize = \min($this->clientWindow, $stream->clientWindow); $length = \strlen($stream->requestBodyBuffer); if ($length <= $windowSize) { if ($stream->windowSizeIncrease) { $deferred = $stream->windowSizeIncrease; $stream->windowSizeIncrease = null; $deferred->resolve(); } $this->clientWindow -= $length; $stream->clientWindow -= $length; if ($length > $this->frameSizeLimit) { /** @var string[] $chunks */ $chunks = \str_split($stream->requestBodyBuffer, $this->frameSizeLimit); $stream->requestBodyBuffer = \array_pop($chunks); foreach ($chunks as $chunk) { $this->writeFrame(Http2Parser::DATA, Http2Parser::NO_FLAG, $stream->id, $chunk); } } if ($stream->requestBodyComplete) { $promise = $this->writeFrame( Http2Parser::DATA, Http2Parser::END_STREAM, $stream->id, $stream->requestBodyBuffer ); } else { $promise = $this->writeFrame( Http2Parser::DATA, Http2Parser::NO_FLAG, $stream->id, $stream->requestBodyBuffer ); } $stream->requestBodyBuffer = ""; $stream->enableInactivityWatcher(); return $promise; } if ($windowSize > 0) { // Read next body chunk if less than 8192 bytes will remain in the buffer if ($length - 8192 < $windowSize && $stream->windowSizeIncrease) { $deferred = $stream->windowSizeIncrease; $stream->windowSizeIncrease = null; $deferred->resolve(); } $data = $stream->requestBodyBuffer; $end = $windowSize - $this->frameSizeLimit; $stream->clientWindow -= $windowSize; $this->clientWindow -= $windowSize; for ($off = 0; $off < $end; $off += $this->frameSizeLimit) { $this->writeFrame( Http2Parser::DATA, Http2Parser::NO_FLAG, $stream->id, \substr($data, $off, $this->frameSizeLimit) ); } $promise = $this->writeFrame( Http2Parser::DATA, Http2Parser::NO_FLAG, $stream->id, \substr($data, $off, $windowSize - $off) ); $stream->requestBodyBuffer = \substr($data, $windowSize); $stream->enableInactivityWatcher(); return $promise; } if ($stream->windowSizeIncrease === null) { $stream->windowSizeIncrease = new Deferred; } return $stream->windowSizeIncrease->promise(); } private function releaseStream(int $streamId, ?\Throwable $exception = null): void { \assert(isset($this->streams[$streamId])); $stream = $this->streams[$streamId]; unset($this->streams[$streamId]); if ($streamId & 1) { // Client-initiated stream. $this->remainingStreams++; \assert($this->remainingStreams <= $this->concurrentStreamLimit); } if ($stream->responsePending || $stream->body || $stream->trailers) { /** * @psalm-suppress DeprecatedClass * @noinspection PhpDeprecationInspection */ $exception = $exception ?? new ClientHttp2StreamException( \sprintf("Stream %d closed unexpectedly", $streamId), $streamId, Http2Parser::INTERNAL_ERROR ); if (!$exception instanceof HttpException && !$exception instanceof CancelledException) { $exception = new HttpException($exception->getMessage(), 0, $exception); } /** @var (Deferred|Emitter)[] $deferredAndEmitter */ $deferredAndEmitter = []; if ($stream->responsePending) { $stream->responsePending = false; $deferredAndEmitter[] = $stream->pendingResponse; $stream->pendingResponse = null; } if ($stream->body) { $deferredAndEmitter[] = $stream->body; $stream->body = null; } if ($stream->trailers) { $deferredAndEmitter[] = $stream->trailers; $stream->trailers = null; } $request = $stream->request; asyncCall(static function () use ($request, $deferredAndEmitter, $exception) { try { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->abort($request, $exception); } } finally { foreach ($deferredAndEmitter as $deferredOrEmitter) { \assert($deferredOrEmitter !== null); // TODO Find out why psalm reports this as nullable $deferredOrEmitter->fail($exception); } } }); } if (!$this->streams && !$this->socket->isClosed()) { $this->socket->unreference(); } if (!$this->streams && $this->shutdown !== null) { $this->close(); } } private function setupPingIfIdle(): void { if ($this->idleWatcher !== null) { return; } $this->idleWatcher = Loop::defer(function ($watcher) { \assert($this->idleWatcher === null || $this->idleWatcher === $watcher); $this->idleWatcher = null; if (!empty($this->streams)) { return; } $this->idleWatcher = Loop::delay(300000, function ($watcher) { \assert($this->idleWatcher === null || $this->idleWatcher === $watcher); \assert(empty($this->streams)); $this->idleWatcher = null; // Connection idle for 10 minutes if ($this->idlePings >= 1) { $this->shutdown(new HttpException('Too many pending pings')); $this->close(); return; } if (yield $this->ping()) { $this->setupPingIfIdle(); } }); Loop::unreference($this->idleWatcher); }); Loop::unreference($this->idleWatcher); } private function cancelIdleWatcher(): void { if ($this->idleWatcher !== null) { Loop::cancel($this->idleWatcher); $this->idleWatcher = null; } } /** * @return Promise Fulfilled with true if a pong is received within the timeout, false if none is received. */ private function ping(): Promise { if ($this->onClose === null) { return new Success(false); } if ($this->pongDeferred !== null) { return $this->pongDeferred->promise(); } $this->pongDeferred = new Deferred; $this->idlePings++; $promise = $this->pongDeferred->promise(); $this->pongWatcher = Loop::delay(self::PONG_TIMEOUT, function () { $this->hasTimeout = false; $deferred = $this->pongDeferred; $this->pongDeferred = null; \assert($deferred !== null); $deferred->resolve(false); // Shutdown connection to stop new requests, but keep it open, as other responses might still arrive $this->shutdown(new HttpException('PONG timeout of ' . self::PONG_TIMEOUT . 'ms reached'), \max(0, $this->streamId)); }); $this->writeFrame(Http2Parser::PING, 0, 0, $this->counter++); return $promise; } /** * @param HttpException $reason Shutdown reason. * @param int|null $lastId ID of last processed frame. Null to use the last opened frame ID or 0 if no * streams have been opened. * * @return Promise */ private function shutdown(HttpException $reason, ?int $lastId = null): Promise { return call(function () use ($lastId, $reason) { $code = (int) $reason->getCode(); $this->shutdown = $code; if ($this->settings !== null) { $settings = $this->settings; $this->settings = null; $message = "Connection closed before HTTP/2 settings could be received"; $settings->fail(new UnprocessedRequestException(new SocketException($message, 0, $reason))); } if ($this->streams) { $reason = $lastId !== null ? new UnprocessedRequestException($reason) : $reason; foreach ($this->streams as $id => $stream) { if ($lastId !== null && $id <= $lastId) { continue; } $this->releaseStream($id, $reason); } } }); } /** * @param Request $request * * @return array * @throws InvalidRequestException */ private function generateHeaders(Request $request): array { $uri = $request->getUri(); $path = normalizeRequestPathWithQuery($request); $authority = $uri->getHost(); if ($port = $uri->getPort()) { $authority .= ':' . $port; } $headers = [ [":authority", $authority], [":path", $path], [":scheme", $uri->getScheme()], [":method", $request->getMethod()], ]; foreach ($request->getHeaders() as $field => $values) { foreach ($values as $value) { if ($field === 'te' && $value !== 'trailers') { continue; } $headers[] = [$field, $value]; } } return $headers; } private function writeData(Http2Stream $stream, string $data): Promise { $stream->requestBodyBuffer .= $data; return $this->writeBufferedData($stream); } private function increaseConnectionWindow(): void { $increase = 0; while ($this->serverWindow <= self::MINIMUM_WINDOW) { $this->serverWindow += self::WINDOW_INCREMENT; $increase += self::WINDOW_INCREMENT; } if ($increase > 0) { $this->writeFrame(Http2Parser::WINDOW_UPDATE, 0, 0, \pack("N", self::WINDOW_INCREMENT)); } } private function increaseStreamWindow(Http2Stream $stream): void { $minWindow = \min($stream->request->getBodySizeLimit(), self::MINIMUM_WINDOW); $increase = 0; while (($stream->serverWindow + $stream->bufferSize) <= $minWindow) { $stream->serverWindow += self::WINDOW_INCREMENT; $increase += self::WINDOW_INCREMENT; } if ($increase > 0) { $this->writeFrame( Http2Parser::WINDOW_UPDATE, Http2Parser::NO_FLAG, $stream->id, \pack("N", self::WINDOW_INCREMENT) ); } } private function createStreamInactivityWatcher(int $streamId, int $timeout): ?string { if ($timeout <= 0) { return null; } $watcher = Loop::delay($timeout, function () use ($streamId, $timeout): void { if (!isset($this->streams[$streamId])) { return; } $this->writeFrame( Http2Parser::RST_STREAM, Http2Parser::NO_FLAG, $streamId, \pack("N", Http2Parser::CANCEL) ); $this->releaseStream( $streamId, new TimeoutException("Inactivity timeout exceeded, more than {$timeout} ms elapsed from last data received") ); }); Loop::unreference($watcher); return $watcher; } private function runWriteThread(): \Generator { try { while (yield $this->frameQueue->advance()) { yield $this->socket->write($this->frameQueue->getCurrent()); } } catch (\Throwable $exception) { $this->hasWriteError = true; /** * @psalm-suppress DeprecatedClass * @noinspection PhpDeprecationInspection */ $this->shutdown(new ClientHttp2ConnectionException( "The HTTP/2 connection closed unexpectedly: " . $exception->getMessage(), Http2Parser::INTERNAL_ERROR, $exception ), \max(0, $this->streamId)); } } } getBody()->getHeaders(); foreach ($headers as $name => $header) { if (!$request->hasHeader($name)) { $request->setHeaders([$name => $header]); } } yield from self::normalizeRequestBodyHeaders($request); // Always normalize this as last item, because we need to strip sensitive headers self::normalizeTraceRequest($request); return $request; }); } private static function normalizeRequestBodyHeaders(Request $request): \Generator { if (!$request->hasHeader('host')) { // Though servers are supposed to be able to handle standard port names on the end of the // Host header some fail to do this correctly. Thankfully PSR-7 recommends to strip the port // if it is the standard port for the given scheme. $request->setHeader('host', $request->getUri()->withUserInfo('')->getAuthority()); } if ($request->hasHeader("transfer-encoding")) { $request->removeHeader("content-length"); return; } if ($request->hasHeader("content-length")) { return; } /** @var RequestBody $body */ $body = $request->getBody(); $bodyLength = yield $body->getBodyLength(); if ($bodyLength === 0) { if (\in_array($request->getMethod(), ['HEAD', 'GET', 'CONNECT'], true)) { $request->removeHeader('content-length'); } else { $request->setHeader('content-length', '0'); } $request->removeHeader('transfer-encoding'); } elseif ($bodyLength > 0) { $request->setHeader("content-length", $bodyLength); $request->removeHeader("transfer-encoding"); } else { $request->setHeader("transfer-encoding", "chunked"); } } private static function normalizeTraceRequest(Request $request): void { $method = $request->getMethod(); if ($method !== 'TRACE') { return; } // https://tools.ietf.org/html/rfc7231#section-4.3.8 $request->setBody(null); // Remove all body and sensitive headers $request->setHeaders([ "transfer-encoding" => [], "content-length" => [], "authorization" => [], "proxy-authorization" => [], "cookie" => [], ]); } } getLocalAddress(), $connection->getRemoteAddress(), $connection->getTlsInfo(), $requestCallback, $releaseCallback ); } public static function fromStream(Stream $stream, callable $requestCallback, callable $releaseCallback): self { return new self( $stream->getLocalAddress(), $stream->getRemoteAddress(), $stream->getTlsInfo(), $requestCallback, $releaseCallback ); } /** @var SocketAddress */ private $localAddress; /** @var SocketAddress */ private $remoteAddress; /** @var TlsInfo|null */ private $tlsInfo; /** @var callable */ private $requestCallback; /** @var callable|null */ private $releaseCallback; private function __construct( SocketAddress $localAddress, SocketAddress $remoteAddress, ?TlsInfo $tlsInfo, callable $requestCallback, callable $releaseCallback ) { $this->localAddress = $localAddress; $this->remoteAddress = $remoteAddress; $this->tlsInfo = $tlsInfo; $this->requestCallback = $requestCallback; $this->releaseCallback = $releaseCallback; } public function __destruct() { if ($this->releaseCallback !== null) { ($this->releaseCallback)(); } } public function request(Request $request, CancellationToken $cancellation): Promise { if ($this->releaseCallback === null) { throw new \Error('A stream may only be used for a single request'); } $this->releaseCallback = null; return call(function () use ($request, $cancellation) { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->startRequest($request); } return call($this->requestCallback, $request, $cancellation, $this); }); } public function getLocalAddress(): SocketAddress { return $this->localAddress; } public function getRemoteAddress(): SocketAddress { return $this->remoteAddress; } public function getTlsInfo(): ?TlsInfo { return $this->tlsInfo; } } socket = $socket; $this->localAddress = $socket->getLocalAddress(); $this->remoteAddress = $socket->getRemoteAddress(); $this->tlsInfo = $socket->getTlsInfo(); $this->timeoutGracePeriod = $timeoutGracePeriod; $this->lastUsedAt = getCurrentTime(); $this->watchIdleConnection(); } public function __destruct() { $this->close(); } public function onClose(callable $onClose): void { if (!$this->socket || $this->socket->isClosed()) { Promise\rethrow(call($onClose, $this)); return; } $this->onClose[] = $onClose; } public function close(): Promise { if ($this->socket) { $this->socket->close(); } return $this->free(); } public function getLocalAddress(): SocketAddress { return $this->localAddress; } public function getRemoteAddress(): SocketAddress { return $this->remoteAddress; } public function getTlsInfo(): ?TlsInfo { return $this->tlsInfo; } public function getProtocolVersions(): array { return self::PROTOCOL_VERSIONS; } public function getStream(Request $request): Promise { if ($this->busy || ($this->requestCounter && !$this->hasStreamFor($request))) { return new Success; } $this->busy = true; return new Success(HttpStream::fromConnection( $this, \Closure::fromCallable([$this, 'request']), \Closure::fromCallable([$this, 'release']) )); } private function free(): Promise { $this->socket = null; $this->idleRead = null; $this->lastUsedAt = 0; if ($this->timeoutWatcher !== null) { Loop::cancel($this->timeoutWatcher); } if ($this->onClose !== null) { $onClose = $this->onClose; $this->onClose = null; foreach ($onClose as $callback) { asyncCall($callback, $this); } } return new Success; } private function hasStreamFor(Request $request): bool { return !$this->busy && $this->socket && !$this->socket->isClosed() && ($this->getRemainingTime() > 0 || $request->isIdempotent()); } /** @inheritdoc */ private function request(Request $request, CancellationToken $cancellation, Stream $stream): Promise { return call(function () use ($request, $cancellation, $stream) { ++$this->requestCounter; if ($this->socket !== null && !$this->socket->isClosed()) { $this->socket->reference(); } if ($this->timeoutWatcher !== null) { Loop::cancel($this->timeoutWatcher); $this->timeoutWatcher = null; } yield RequestNormalizer::normalizeRequest($request); $protocolVersion = $this->determineProtocolVersion($request); $request->setProtocolVersions([$protocolVersion]); if ($request->getTransferTimeout() > 0) { $timeoutToken = new TimeoutCancellationToken($request->getTransferTimeout()); $combinedCancellation = new CombinedCancellationToken($cancellation, $timeoutToken); } else { $combinedCancellation = $cancellation; } $id = $combinedCancellation->subscribe([$this, 'close']); try { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->startSendingRequest($request, $stream); } yield from $this->writeRequest($request, $protocolVersion, $combinedCancellation); foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeSendingRequest($request, $stream); } return yield from $this->readResponse($request, $cancellation, $combinedCancellation, $stream); } catch (\Throwable $e) { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->abort($request, $e); } if ($this->socket !== null) { $this->socket->close(); } throw $e; } finally { $combinedCancellation->unsubscribe($id); $cancellation->throwIfRequested(); } }); } private function release(): void { $this->busy = false; } /** * @param Request $request * @param CancellationToken $originalCancellation * @param CancellationToken $readingCancellation * * @param Stream $stream * * @return \Generator * @throws CancelledException * @throws HttpException * @throws ParseException * @throws SocketException */ private function readResponse( Request $request, CancellationToken $originalCancellation, CancellationToken $readingCancellation, Stream $stream ): \Generator { $bodyEmitter = new Emitter; $backpressure = new Success; $bodyCallback = static function ($data) use ($bodyEmitter, &$backpressure): void { $backpressure = $bodyEmitter->emit($data); }; $trailersDeferred = new Deferred; $trailers = []; $trailersCallback = static function (array $headers) use (&$trailers): void { $trailers = $headers; }; $parser = new Http1Parser($request, $bodyCallback, $trailersCallback); $start = getCurrentTime(); $timeout = $request->getInactivityTimeout(); try { if ($this->socket === null) { throw new SocketException('Socket closed prior to response completion'); } while (null !== $chunk = yield $timeout > 0 ? Promise\timeout($this->idleRead ?: $this->socket->read(), $timeout) : ($this->idleRead ?: $this->socket->read()) ) { $this->idleRead = null; parseChunk: $response = $parser->parse($chunk); if ($response === null) { if ($this->socket === null) { throw new SocketException('Socket closed prior to response completion'); } continue; } $this->lastUsedAt = getCurrentTime(); $status = $response->getStatus(); if ($status === Http\Status::SWITCHING_PROTOCOLS) { $connection = Http\createFieldValueComponentMap(Http\parseFieldValueComponents( $response, 'connection' )); if (!isset($connection['upgrade'])) { throw new HttpException('Switching protocols response missing "Connection: upgrade" header'); } if (!$response->hasHeader('upgrade')) { throw new HttpException('Switching protocols response missing "Upgrade" header'); } foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeReceivingResponse($request, $stream); } $trailersDeferred->resolve($trailers); return $this->handleUpgradeResponse($request, $response, $parser->getBuffer()); } if ($status < 200) { // 1XX responses (excluding 101, handled above) $onInformationalResponse = $request->getInformationalResponseHandler(); if ($onInformationalResponse !== null) { yield call($onInformationalResponse, $response); } $chunk = $parser->getBuffer(); $parser = new Http1Parser($request, $bodyCallback, $trailersCallback); goto parseChunk; } foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->startReceivingResponse($request, $stream); } if ($status >= 200 && $status < 300 && $request->getMethod() === 'CONNECT') { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeReceivingResponse($request, $stream); } $trailersDeferred->resolve($trailers); return $this->handleUpgradeResponse($request, $response, $parser->getBuffer()); } $bodyCancellationSource = new CancellationTokenSource; $bodyCancellationToken = new CombinedCancellationToken( $readingCancellation, $bodyCancellationSource->getToken() ); $response->setTrailers($trailersDeferred->promise()); $response->setBody(new ResponseBodyStream( new IteratorStream($bodyEmitter->iterate()), $bodyCancellationSource )); // Read body async asyncCall(function () use ( $parser, $request, $response, $bodyEmitter, $trailersDeferred, $originalCancellation, $readingCancellation, $bodyCancellationToken, $stream, $timeout, &$backpressure, &$trailers ) { $id = $bodyCancellationToken->subscribe([$this, 'close']); try { // Required, otherwise responses without body hang if (!$parser->isComplete()) { // Directly parse again in case we already have the full body but aborted parsing // to resolve promise with headers. $chunk = null; try { /** @psalm-suppress PossiblyNullReference */ do { /** @noinspection CallableParameterUseCaseInTypeContextInspection */ $parser->parse($chunk); /** * @noinspection NotOptimalIfConditionsInspection * @psalm-suppress TypeDoesNotContainType */ if ($parser->isComplete()) { break; } if (!$backpressure instanceof Success) { yield $this->withCancellation($backpressure, $bodyCancellationToken); } /** @psalm-suppress TypeDoesNotContainNull */ if ($this->socket === null) { throw new SocketException('Socket closed prior to response completion'); } } while (null !== $chunk = yield $timeout > 0 ? Promise\timeout($this->socket->read(), $timeout) : $this->socket->read() ); } catch (PromiseTimeoutException $e) { $this->close(); throw new TimeoutException( 'Inactivity timeout exceeded, more than ' . $timeout . ' ms elapsed from last data received', 0, $e ); } $originalCancellation->throwIfRequested(); if ($readingCancellation->isRequested()) { throw new TimeoutException('Allowed transfer timeout exceeded, took longer than ' . $request->getTransferTimeout() . ' ms'); } $bodyCancellationToken->throwIfRequested(); // Ignore check if neither content-length nor chunked encoding are given. if (!$parser->isComplete() && $parser->getState() !== Http1Parser::BODY_IDENTITY_EOF) { throw new SocketException('Socket disconnected prior to response completion'); } } $timeout = $this->determineKeepAliveTimeout($response); if ($timeout > 0 && $parser->getState() !== Http1Parser::BODY_IDENTITY_EOF) { $this->timeoutWatcher = Loop::delay($timeout * 1000, [$this, 'close']); Loop::unreference($this->timeoutWatcher); $this->watchIdleConnection(); } else { $this->close(); } $this->busy = false; foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->completeReceivingResponse($request, $stream); } $bodyEmitter->complete(); $trailersDeferred->resolve($trailers); } catch (\Throwable $e) { $this->close(); try { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->abort($request, $e); } } finally { $bodyEmitter->fail($e); $trailersDeferred->fail($e); } } finally { $bodyCancellationToken->unsubscribe($id); } }); return $response; } $originalCancellation->throwIfRequested(); throw new SocketException(\sprintf( "Receiving the response headers for '%s' failed, because the socket to '%s' @ '%s' closed early with %d bytes received within %d milliseconds", (string) $request->getUri()->withUserInfo(''), $request->getUri()->withUserInfo('')->getAuthority(), $this->socket === null ? '???' : (string) $this->socket->getRemoteAddress(), \strlen($parser->getBuffer()), getCurrentTime() - $start )); } catch (HttpException $e) { $this->close(); throw $e; } catch (PromiseTimeoutException $e) { $this->close(); throw new TimeoutException( 'Inactivity timeout exceeded, more than ' . $timeout . ' ms elapsed from last data received', 0, $e ); } catch (\Throwable $e) { $this->close(); throw new SocketException('Receiving the response headers failed: ' . $e->getMessage(), 0, $e); } } private function handleUpgradeResponse(Request $request, Response $response, string $buffer): Response { if ($this->socket === null) { throw new SocketException('Socket closed while upgrading'); } $socket = new UpgradedSocket($this->socket, $buffer); $this->free(); // Mark this connection as unusable without closing socket. if (($onUpgrade = $request->getUpgradeHandler()) === null) { $socket->close(); throw new HttpException('CONNECT or upgrade request made without upgrade handler callback'); } asyncCall(static function () use ($onUpgrade, $socket, $request, $response): \Generator { try { yield call($onUpgrade, $socket, $request, $response); } catch (\Throwable $exception) { $socket->close(); throw new HttpException('Upgrade handler threw an exception', 0, $exception); } }); return $response; } /** * @return int Approximate number of milliseconds remaining until the connection is closed. */ private function getRemainingTime(): int { $timestamp = $this->lastUsedAt + ($this->explicitTimeout ? $this->priorTimeout * 1000 : $this->timeoutGracePeriod); return \max(0, $timestamp - getCurrentTime()); } private function withCancellation(Promise $promise, CancellationToken $cancellationToken): Promise { $deferred = new Deferred; $newPromise = $deferred->promise(); $promise->onResolve(static function ($error, $value) use (&$deferred): void { if ($deferred) { $temp = $deferred; $deferred = null; if ($error) { $temp->fail($error); } else { $temp->resolve($value); } } }); $cancellationSubscription = $cancellationToken->subscribe(static function ($e) use (&$deferred): void { if ($deferred) { $temp = $deferred; $deferred = null; $temp->fail($e); } }); $newPromise->onResolve(static function () use ($cancellationToken, $cancellationSubscription): void { $cancellationToken->unsubscribe($cancellationSubscription); }); return $newPromise; } private function determineKeepAliveTimeout(Response $response): int { $request = $response->getRequest(); $requestConnHeader = $request->getHeader('connection') ?? ''; $responseConnHeader = $response->getHeader('connection') ?? ''; if (!\strcasecmp($requestConnHeader, 'close')) { return 0; } if ($response->getProtocolVersion() === '1.0') { return 0; } if (!\strcasecmp($responseConnHeader, 'close')) { return 0; } $params = Http\createFieldValueComponentMap(Http\parseFieldValueComponents($response, 'keep-alive')); $timeout = (int) ($params['timeout'] ?? $this->priorTimeout); if (isset($params['timeout'])) { $this->explicitTimeout = true; } return $this->priorTimeout = \min(\max(0, $timeout), self::MAX_KEEP_ALIVE_TIMEOUT); } private function determineProtocolVersion(Request $request): string { $protocolVersions = $request->getProtocolVersions(); if (\in_array("1.1", $protocolVersions, true)) { return "1.1"; } if (\in_array("1.0", $protocolVersions, true)) { return "1.0"; } throw new InvalidRequestException( $request, "None of the requested protocol versions is supported: " . \implode(", ", $protocolVersions) ); } private function writeRequest( Request $request, string $protocolVersion, CancellationToken $cancellation ): \Generator { try { $rawHeaders = $this->generateRawHeader($request, $protocolVersion); if ($this->socket === null) { throw new UnprocessedRequestException(new SocketException('Socket closed before request started')); } yield $this->socket->write($rawHeaders); if ($request->getMethod() === 'CONNECT') { return; } $body = $request->getBody()->createBodyStream(); $chunking = $request->getHeader("transfer-encoding") === "chunked"; $remainingBytes = $request->getHeader("content-length"); if ($remainingBytes !== null) { $remainingBytes = (int) $remainingBytes; } if ($chunking && $protocolVersion === "1.0") { throw new InvalidRequestException($request, "Can't send chunked bodies over HTTP/1.0"); } // We always buffer the last chunk to make sure we don't write $contentLength bytes if the body is too long. $buffer = ""; while (null !== $chunk = yield $body->read()) { $cancellation->throwIfRequested(); if ($chunk === "") { continue; } if ($chunking) { $chunk = \dechex(\strlen($chunk)) . "\r\n" . $chunk . "\r\n"; } elseif ($remainingBytes !== null) { $remainingBytes -= \strlen($chunk); if ($remainingBytes < 0) { throw new InvalidRequestException( $request, "Body contained more bytes than specified in Content-Length, aborting request" ); } } yield $this->socket->write($buffer); $buffer = $chunk; } $cancellation->throwIfRequested(); // Flush last buffered chunk. yield $this->socket->write($buffer); if ($chunking) { yield $this->socket->write("0\r\n\r\n"); } elseif ($remainingBytes !== null && $remainingBytes > 0) { throw new InvalidRequestException( $request, "Body contained fewer bytes than specified in Content-Length, aborting request" ); } } catch (StreamException $exception) { throw new SocketException('Socket disconnected prior to response completion'); } } /** * @param Request $request * @param string $protocolVersion * * @return string * * @throws HttpException */ private function generateRawHeader(Request $request, string $protocolVersion): string { $uri = $request->getUri(); $requestUri = normalizeRequestPathWithQuery($request); $method = $request->getMethod(); if ($method === 'CONNECT') { $defaultPort = $uri->getScheme() === 'https' ? 443 : 80; $requestUri = $uri->getHost() . ':' . ($uri->getPort() ?? $defaultPort); } $header = $method . ' ' . $requestUri . ' HTTP/' . $protocolVersion . "\r\n"; try { $header .= Rfc7230::formatRawHeaders($request->getRawHeaders()); } catch (InvalidHeaderException $e) { throw new HttpException($e->getMessage()); } return $header . "\r\n"; } private function watchIdleConnection(): void { if ($this->socket === null || $this->socket->isClosed()) { return; } $this->socket->unreference(); $this->idleRead = $this->socket->read(); $this->idleRead->onResolve(function ($error, $chunk) { if ($error || $chunk === null) { $this->close(); } }); } } * * @throws \Error Thrown if this method is called more than once. */ public function request(Request $request, CancellationToken $cancellation): Promise; public function getLocalAddress(): SocketAddress; public function getRemoteAddress(): SocketAddress; public function getTlsInfo(): ?TlsInfo; } Returns a stream for the given request, or null if no stream is available or if * the connection is not suited for the given request. The first request for a stream * on a new connection MUST resolve the promise with a Stream instance. */ public function getStream(Request $request): Promise; /** * @return string[] Array of supported protocol versions. */ public function getProtocolVersions(): array; public function close(): Promise; public function onClose(callable $onClose): void; public function getLocalAddress(): SocketAddress; public function getRemoteAddress(): SocketAddress; public function getTlsInfo(): ?TlsInfo; } pool = ConnectionLimitingPool::byAuthority(\PHP_INT_MAX, $connectionFactory); } public function __clone() { $this->pool = clone $this->pool; } public function getTotalConnectionAttempts(): int { return $this->pool->getTotalConnectionAttempts(); } public function getTotalStreamRequests(): int { return $this->pool->getTotalStreamRequests(); } public function getOpenConnectionCount(): int { return $this->pool->getOpenConnectionCount(); } public function getStream(Request $request, CancellationToken $cancellation): Promise { return $this->pool->getStream($request, $cancellation); } } socket = $socket; $this->processor = new Http2ConnectionProcessor($socket); } public function getProtocolVersions(): array { return self::PROTOCOL_VERSIONS; } public function initialize(): Promise { return $this->processor->initialize(); } public function getStream(Request $request): Promise { if (!$this->processor->isInitialized()) { throw new \Error('The promise returned from ' . __CLASS__ . '::initialize() must resolve before using the connection'); } return call(function () { if ($this->processor->isClosed() || $this->processor->getRemainingStreams() <= 0) { return null; } $this->processor->reserveStream(); return HttpStream::fromConnection( $this, \Closure::fromCallable([$this, 'request']), \Closure::fromCallable([$this->processor, 'unreserveStream']) ); }); } public function onClose(callable $onClose): void { $this->processor->onClose($onClose); } public function close(): Promise { return $this->processor->close(); } public function getLocalAddress(): SocketAddress { return $this->socket->getLocalAddress(); } public function getRemoteAddress(): SocketAddress { return $this->socket->getRemoteAddress(); } public function getTlsInfo(): ?TlsInfo { return $this->socket->getTlsInfo(); } private function request(Request $request, CancellationToken $token, Stream $applicationStream): Promise { $this->requestCount++; return $this->processor->request($request, $token, $applicationStream); } } streamId = $streamId; } public function getStreamId(): int { return $this->streamId; } } connectionPool = $connectionPool ?? new UnlimitedConnectionPool; } public function request(Request $request, CancellationToken $cancellation): Promise { return call(function () use ($request, $cancellation) { foreach ($request->getEventListeners() as $eventListener) { yield $eventListener->startRequest($request); } $stream = yield $this->connectionPool->getStream($request, $cancellation); \assert($stream instanceof Stream); foreach (\array_reverse($this->networkInterceptors) as $interceptor) { $stream = new InterceptedStream($stream, $interceptor); } return yield $stream->request($request, $cancellation); }); } /** * Adds a network interceptor. * * Network interceptors are only invoked if the request requires network access, i.e. there's no short-circuit by * an application interceptor, e.g. a cache. * * Whether the given network interceptor will be respected for currently running requests is undefined. * * Any new requests have to take the new interceptor into account. * * @param NetworkInterceptor $networkInterceptor * * @return self */ public function intercept(NetworkInterceptor $networkInterceptor): self { $clone = clone $this; $clone->networkInterceptors[] = $networkInterceptor; return $clone; } } httpClient = $httpClient; } /** * Request a specific resource from an HTTP server. * * @param Request $request * @param CancellationToken $cancellation * * @return Promise */ public function request(Request $request, ?CancellationToken $cancellation = null): Promise { return $this->httpClient->request(clone $request, $cancellation ?? new NullCancellationToken); } } request(...)` resolves. * * An interceptor might also short-circuit and not delegate to the `$httpClient` at all. * * Any retry or cloned follow-up request must be manually cloned from `$request` to ensure a properly working * interceptor chain, e.g. the {@see DecompressResponse} interceptor only decodes a response if the * `accept-encoding` header isn't set manually. If the request isn't cloned, the first attempt will set the header * and the second attempt will see the header and won't decode the response, because it thinks another interceptor * or the application itself will care about the decoding. * * @param Request $request * @param CancellationToken $cancellation * @param DelegateHttpClient $httpClient * * @return Promise */ public function request( Request $request, CancellationToken $cancellation, DelegateHttpClient $httpClient ): Promise; } =7.1", "amphp/amp": "^2", "amphp/sql": "^1", "amphp/sql-common": "^1" }, "require-dev": { "ext-pgsql": "*", "ext-pq": "*", "amphp/phpunit-util": "^1.1.2", "phpunit/phpunit": "^8 | ^7", "amphp/php-cs-fixer-config": "dev-master" }, "autoload": { "psr-4": { "Amp\\Postgres\\": "src" }, "files": [ "src/functions.php", "src/Internal/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Postgres\\Test\\": "test" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "php-cs-fixer fix -v --diff --dry-run", "cs-fix": "php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" } } #!/usr/bin/env php listen($channel); \printf("Listening on channel '%s'\n", $listener->getChannel()); Loop::delay(3000, function () use ($listener) { // Unlisten in 3 seconds. \printf("Unlistening from channel '%s'\n", $listener->getChannel()); return $listener->unlisten(); }); Loop::delay(1000, function () use ($pool, $channel) { return $pool->notify($channel, "Data 1"); // Send first notification. }); Loop::delay(2000, function () use ($pool, $channel) { return $pool->notify($channel, "Data 2"); // Send second notification. }); while (yield $listener->advance()) { $notification = $listener->getCurrent(); \printf( "Received notification from PID %d on channel '%s' with payload: %s\n", $notification->pid, $notification->channel, $notification->payload ); } }); #!/usr/bin/env php listen($channel1); \printf("Listening on channel '%s'\n", $listener1->getChannel()); /** @var \Amp\Postgres\Listener $listener2 */ $listener2 = yield $pool->listen($channel2); \printf("Listening on channel '%s'\n", $listener2->getChannel()); Loop::delay(6000, function () use ($listener1) { // Unlisten in 6 seconds. \printf("Unlistening from channel '%s'\n", $listener1->getChannel()); return $listener1->unlisten(); }); Loop::delay(4000, function () use ($listener2) { // Unlisten in 4 seconds. \printf("Unlistening from channel '%s'\n", $listener2->getChannel()); return $listener2->unlisten(); }); Loop::delay(1000, function () use ($pool, $channel1) { return $pool->notify($channel1, "Data 1.1"); }); Loop::delay(2000, function () use ($pool, $channel2) { return $pool->notify($channel2, "Data 2.1"); }); Loop::delay(3000, function () use ($pool, $channel2) { return $pool->notify($channel2, "Data 2.2"); }); Loop::delay(5000, function () use ($pool, $channel1) { return $pool->notify($channel1, "Data 1.2"); }); $iterator = Iterator\merge([$listener1, $listener2]); // Merge both listeners into single iterator. while (yield $iterator->advance()) { $notification = $iterator->getCurrent(); \printf( "Received notification from PID %d on channel '%s' with payload: %s\n", $notification->pid, $notification->channel, $notification->payload ); } }); #!/usr/bin/env php query('DROP TABLE IF EXISTS test'); /** @var \Amp\Postgres\Transaction $transaction */ $transaction = yield $pool->beginTransaction(); yield $transaction->query('CREATE TABLE test (domain VARCHAR(63), tld VARCHAR(63), PRIMARY KEY (domain, tld))'); /** @var \Amp\Sql\Statement $statement */ $statement = yield $transaction->prepare('INSERT INTO test VALUES (?, ?)'); yield $statement->execute(['amphp', 'org']); yield $statement->execute(['google', 'com']); yield $statement->execute(['github', 'com']); /** @var \Amp\Postgres\ResultSet $result */ $result = yield $transaction->execute('SELECT * FROM test WHERE tld = :tld', ['tld' => 'com']); $format = "%-20s | %-10s\n"; \printf($format, 'TLD', 'Domain'); while (yield $result->advance()) { $row = $result->getCurrent(); \printf($format, $row['domain'], $row['tld']); } yield $transaction->rollback(); }); #!/usr/bin/env php query('SHOW ALL'); while (yield $result->advance()) { $row = $result->getCurrent(); \printf("%-35s = %s (%s)\n", $row['name'], $row['setting'], $row['description']); } }); "severity", \PGSQL_DIAG_SQLSTATE => "sqlstate", \PGSQL_DIAG_MESSAGE_PRIMARY => "message_primary", \PGSQL_DIAG_MESSAGE_DETAIL => "message_detail", \PGSQL_DIAG_MESSAGE_HINT => "message_hint", \PGSQL_DIAG_STATEMENT_POSITION => "statement_position", \PGSQL_DIAG_INTERNAL_POSITION => "internal_position", \PGSQL_DIAG_INTERNAL_QUERY => "internal_query", \PGSQL_DIAG_CONTEXT => "context", \PGSQL_DIAG_SOURCE_FILE => "source_file", \PGSQL_DIAG_SOURCE_LINE => "source_line", \PGSQL_DIAG_SOURCE_FUNCTION => "source_function", ]; /** @var array>> */ private static $typeCache; /** @var resource|\PgSql\Connection|null PostgreSQL connection handle. */ private $handle; /** @var Promise> */ private $types; /** @var Deferred|null */ private $deferred; /** @var string */ private $poll; /** @var string */ private $await; /** @var Emitter[] */ private $listeners = []; /** @var array, sql: string}> */ private $statements = []; /** @var int */ private $lastUsedAt; /** * @param resource $handle PostgreSQL connection handle. * @param resource $socket PostgreSQL connection stream socket. * @param string $id Connection identifier for determining which cached type table to use. */ public function __construct($handle, $socket, string $id = '') { $this->handle = $handle; $this->lastUsedAt = \time(); $handle = &$this->handle; $lastUsedAt = &$this->lastUsedAt; $deferred = &$this->deferred; $listeners = &$this->listeners; $this->poll = Loop::onReadable($socket, static function ($watcher) use (&$deferred, &$lastUsedAt, &$listeners, &$handle): void { $lastUsedAt = \time(); if (\pg_connection_status($handle) === \PGSQL_CONNECTION_BAD) { $handle = null; if ($deferred) { $deferred->fail(new ConnectionException("The connection closed during the operation")); } } if (!\pg_consume_input($handle)) { $handle = null; // Marks connection as dead. Loop::disable($watcher); $exception = new ConnectionException(\pg_last_error($handle)); foreach ($listeners as $listener) { $listener->fail($exception); } if ($deferred !== null) { $deferred->fail($exception); } return; } while ($result = \pg_get_notify($handle, \PGSQL_ASSOC)) { $channel = $result["message"]; if (!isset($listeners[$channel])) { continue; } $notification = new Notification; $notification->channel = $channel; $notification->pid = $result["pid"]; $notification->payload = $result["payload"]; $listeners[$channel]->emit($notification); } if ($deferred === null) { return; // No active query, only notification listeners. } if (\pg_connection_busy($handle)) { return; } $deferred->resolve(\pg_get_result($handle)); if (!$deferred && empty($listeners)) { Loop::unreference($watcher); } }); $this->await = Loop::onWritable($socket, static function ($watcher) use (&$deferred, &$listeners, &$handle): void { $flush = \pg_flush($handle); if ($flush === 0) { return; // Not finished sending data, listen again. } Loop::disable($watcher); if ($flush === false) { $exception = new ConnectionException(\pg_last_error($handle)); $handle = null; // Marks connection as dead. foreach ($listeners as $listener) { $listener->fail($exception); } if ($deferred !== null) { $deferred->fail($exception); } } }); Loop::unreference($this->poll); Loop::disable($this->await); $this->types = $this->fetchTypes($id); } /** * Frees Io watchers from loop. */ public function __destruct() { $this->free(); } private function fetchTypes(string $id): Promise { if (isset(self::$typeCache[$id])) { return self::$typeCache[$id]; } return self::$typeCache[$id] = call(function (): \Generator { $result = yield from $this->send( "pg_send_query", "SELECT t.oid, t.typcategory, t.typdelim, t.typelem FROM pg_catalog.pg_type t JOIN pg_catalog.pg_namespace n ON t.typnamespace=n.oid WHERE t.typisdefined AND n.nspname IN ('pg_catalog', 'public')" ); $types = []; while ($row = \pg_fetch_array($result, null, \PGSQL_NUM)) { [$oid, $type, $delimiter, $element] = $row; $types[(int) $oid] = [$type, $delimiter, (int) $element]; } return $types; }); } /** * {@inheritdoc} */ public function close(): void { if ($this->handle instanceof \PgSql\Connection || \is_resource($this->handle)) { \pg_close($this->handle); $this->handle = null; } $this->free(); } private function free(): void { if ($this->deferred) { $deferred = $this->deferred; $this->deferred = null; $deferred->fail(new ConnectionException("The connection was closed")); } Loop::cancel($this->poll); Loop::cancel($this->await); } /** * {@inheritdoc} */ public function isAlive(): bool { return $this->handle instanceof \PgSql\Connection || \is_resource($this->handle); } /** * {@inheritdoc} */ public function getLastUsedAt(): int { return $this->lastUsedAt; } /** * @param callable $function Function name to execute. * @param mixed ...$args Arguments to pass to function. * * @return \Generator * * @resolve resource * * @throws FailureException */ private function send(callable $function, ...$args): \Generator { while ($this->deferred) { try { yield $this->deferred->promise(); } catch (\Throwable $exception) { // Ignore failure from another operation. } } if (!$this->isAlive()) { throw new ConnectionException("The connection to the database has been closed"); } while ($result = \pg_get_result($this->handle)) { \pg_free_result($result); } $result = $function($this->handle, ...$args); if ($result === false) { throw new FailureException(\pg_last_error($this->handle)); } $this->deferred = new Deferred; Loop::reference($this->poll); if (0 === $result) { Loop::enable($this->await); } try { $result = yield $this->deferred->promise(); } finally { $this->deferred = null; } return $result; } /** * @param resource $result PostgreSQL result resource. * @param string $sql Query SQL. * * @return \Amp\Sql\CommandResult|ResultSet * * @throws FailureException * @throws QueryError */ private function createResult($result, string $sql, array $types) { switch (\pg_result_status($result, \PGSQL_STATUS_LONG)) { case \PGSQL_EMPTY_QUERY: throw new QueryError("Empty query string"); case \PGSQL_COMMAND_OK: return new PgSqlCommandResult($result); case \PGSQL_TUPLES_OK: return new PgSqlResultSet($result, $types); case \PGSQL_NONFATAL_ERROR: case \PGSQL_FATAL_ERROR: $diagnostics = []; foreach (self::DIAGNOSTIC_CODES as $fieldCode => $desciption) { $diagnostics[$desciption] = \pg_result_error_field($result, $fieldCode); } $message = \pg_result_error($result); while (\pg_connection_busy($this->handle) && \pg_get_result($this->handle)); throw new QueryExecutionError($message, $diagnostics, null, $sql); case \PGSQL_BAD_RESPONSE: $this->close(); throw new FailureException(\pg_result_error($result)); default: // @codeCoverageIgnoreStart $this->close(); throw new FailureException("Unknown result status"); // @codeCoverageIgnoreEnd } } /** * @param string $name * @param array $params * * @return Promise */ public function statementExecute(string $name, array $params): Promise { return call(function () use ($name, $params) { \assert(isset($this->statements[$name]), "Named statement not found when executing"); return $this->createResult( yield from $this->send("pg_send_execute", $name, $params), $this->statements[$name]->sql, yield $this->types ); }); } /** * @param string $name * * @return Promise * * @throws \Error */ public function statementDeallocate(string $name): Promise { if (!$this->isAlive()) { return new Success; // Connection closed, no need to deallocate. } \assert(isset($this->statements[$name]), "Named statement not found when deallocating"); $storage = $this->statements[$name]; if (--$storage->refCount) { return new Success; } return $storage->promise = call(function () use ($storage, $name) { yield $this->query(\sprintf("DEALLOCATE %s", $name)); unset($this->statements[$name]); }); } /** * {@inheritdoc} */ public function query(string $sql): Promise { if (!$this->isAlive()) { throw new \Error("The connection to the database has been closed"); } return call(function () use ($sql) { return $this->createResult(yield from $this->send("pg_send_query", $sql), $sql, yield $this->types); }); } /** * {@inheritdoc} */ public function execute(string $sql, array $params = []): Promise { if (!$this->isAlive()) { throw new \Error("The connection to the database has been closed"); } $sql = Internal\parseNamedParams($sql, $names); $params = Internal\replaceNamedParams($params, $names); return call(function () use ($sql, $params) { return $this->createResult( yield from $this->send("pg_send_query_params", $sql, $params), $sql, yield $this->types ); }); } /** * {@inheritdoc} */ public function prepare(string $sql): Promise { if (!$this->isAlive()) { throw new \Error("The connection to the database has been closed"); } return call(function () use ($sql) { $modifiedSql = Internal\parseNamedParams($sql, $names); $name = Handle::STATEMENT_NAME_PREFIX . \sha1($modifiedSql); while (isset($this->statements[$name])) { $storage = $this->statements[$name]; ++$storage->refCount; // Statement may be being allocated or deallocated. Wait to finish, then check for existence again. if ($storage->promise instanceof Promise) { // Do not return promised prepared statement object, as the $names array may differ. yield $storage->promise; --$storage->refCount; continue; } return new PgSqlStatement($this, $name, $sql, $names); } $storage = new class { use Struct; public $refCount = 1; /** @var Promise */ public $promise; /** @var string */ public $sql; }; $storage->sql = $sql; $this->statements[$name] = $storage; try { yield ($storage->promise = call(function () use ($name, $modifiedSql, $sql) { $result = yield from $this->send("pg_send_prepare", $name, $modifiedSql); switch (\pg_result_status($result, \PGSQL_STATUS_LONG)) { case \PGSQL_COMMAND_OK: return $name; // Statement created successfully. case \PGSQL_NONFATAL_ERROR: case \PGSQL_FATAL_ERROR: $diagnostics = []; foreach (self::DIAGNOSTIC_CODES as $fieldCode => $description) { $diagnostics[$description] = \pg_result_error_field($result, $fieldCode); } throw new QueryExecutionError(\pg_result_error($result), $diagnostics, null, $sql); case \PGSQL_BAD_RESPONSE: throw new FailureException(\pg_result_error($result)); default: // @codeCoverageIgnoreStart throw new FailureException("Unknown result status"); // @codeCoverageIgnoreEnd } })); } catch (\Throwable $exception) { unset($this->statements[$name]); throw $exception; } finally { $storage->promise = null; } return new PgSqlStatement($this, $name, $sql, $names); }); } /** * {@inheritdoc} */ public function notify(string $channel, string $payload = ""): Promise { if ($payload === "") { return $this->query(\sprintf("NOTIFY %s", $this->quoteName($channel))); } return $this->query(\sprintf("NOTIFY %s, %s", $this->quoteName($channel), $this->quoteString($payload))); } /** * {@inheritdoc} */ public function listen(string $channel): Promise { return call(function () use ($channel) { if (isset($this->listeners[$channel])) { throw new QueryError(\sprintf("Already listening on channel '%s'", $channel)); } $this->listeners[$channel] = $emitter = new Emitter; try { yield $this->query(\sprintf("LISTEN %s", $this->quoteName($channel))); } catch (\Throwable $exception) { unset($this->listeners[$channel]); throw $exception; } return new ConnectionListener($emitter->iterate(), $channel, \Closure::fromCallable([$this, 'unlisten'])); }); } /** * @param string $channel * * @return Promise * * @throws \Error */ private function unlisten(string $channel): Promise { \assert(isset($this->listeners[$channel]), "Not listening on that channel"); $emitter = $this->listeners[$channel]; unset($this->listeners[$channel]); if (!$this->isAlive()) { $promise = new Success; // Connection already closed. } else { $promise = $this->query(\sprintf("UNLISTEN %s", $this->quoteName($channel))); } $promise->onResolve([$emitter, "complete"]); return $promise; } /** * {@inheritdoc} */ public function quoteString(string $data): string { if (!$this->isAlive()) { throw new \Error("The connection to the database has been closed"); } return \pg_escape_literal($this->handle, $data); } /** * {@inheritdoc} */ public function quoteName(string $name): string { if (!$this->isAlive()) { throw new \Error("The connection to the database has been closed"); } return \pg_escape_identifier($this->handle, $name); } } */ private $types; /** @var int */ private $position = 0; /** @var mixed Last row emitted. */ private $currentRow; /** @var int[] */ private $fieldTypes = []; /** @var string[] */ private $fieldNames = []; /** @var Internal\ArrayParser */ private $parser; /** * @param resource $handle PostgreSQL result resource. * @param array $types */ public function __construct($handle, array $types = []) { $this->handle = $handle; $this->types = $types; $numFields = \pg_num_fields($this->handle); for ($i = 0; $i < $numFields; ++$i) { $this->fieldNames[] = \pg_field_name($this->handle, $i); $this->fieldTypes[] = \pg_field_type_oid($this->handle, $i); } $this->parser = new Internal\ArrayParser; } /** * Frees the result resource. */ public function __destruct() { \pg_free_result($this->handle); } /** * {@inheritdoc} */ public function advance(): Promise { $this->currentRow = null; if (++$this->position > \pg_num_rows($this->handle)) { return new Success(false); } return new Success(true); } /** * {@inheritdoc} */ public function getCurrent(): array { if ($this->currentRow !== null) { return $this->currentRow; } if ($this->position > \pg_num_rows($this->handle)) { throw new \Error("No more rows remain in the result set"); } $result = \pg_fetch_array($this->handle, null, \PGSQL_NUM); if ($result === false) { $message = \pg_result_error($this->handle); \pg_free_result($this->handle); throw new FailureException($message); } $columnCount = \count($result); for ($column = 0; $column < $columnCount; ++$column) { if ($result[$column] === null) { continue; } $result[$column] = $this->cast($this->fieldTypes[$column], $result[$column]); } return $this->currentRow = \array_combine($this->fieldNames, $result); } /** * @see https://github.com/postgres/postgres/blob/REL_14_STABLE/src/include/catalog/pg_type.dat for OID types. * @see https://www.postgresql.org/docs/14/catalog-pg-type.html for pg_type catalog docs. * * @param int $oid * @param string $value * * @return array|bool|float|int Cast value. * * @throws ParseException */ private function cast(int $oid, string $value) { [$type, $delimiter, $element] = $this->types[$oid] ?? ['S', ',', 0]; switch ($type) { case 'A': // Arrays return $this->parser->parse($value, function (string $data) use ($element) { return $this->cast($element, $data); }, $delimiter); case 'B': // Binary return $value === 't'; case 'N': // Numeric switch ($oid) { case 700: // float4 case 701: // float8 case 1700: // numeric return (float) $value; case 790: return $value; // money includes currency symbol as string. default: // Cast all other numeric types to an integer. return (int) $value; } default: // Return all other types as strings. return $value; } } /** * @return int Number of rows in the result set. */ public function numRows(): int { return \pg_num_rows($this->handle); } /** * @return int Number of fields in each row. */ public function getFieldCount(): int { return \pg_num_fields($this->handle); } /** * @param int $fieldNum * * @return string Column name at index $fieldNum * * @throws \Error If the field number does not exist in the result. */ public function getFieldName(int $fieldNum): string { if (0 > $fieldNum || $this->getFieldCount() <= $fieldNum) { throw new \Error(\sprintf('No field with index %d in result', $fieldNum)); } return \pg_field_name($this->handle, $fieldNum); } /** * @param string $fieldName * * @return int Index of field with given name. * * @throws \Error If the field name does not exist in the result. */ public function getFieldIndex(string $fieldName): int { $result = \pg_field_num($this->handle, $fieldName); if (-1 === $result) { throw new \Error(\sprintf('No field with name "%s" in result', $fieldName)); } return $result; } } */ public static function connect(ConnectionConfig $connectionConfig, ?CancellationToken $token = null): Promise { try { $connection = new pq\Connection($connectionConfig->getConnectionString(), pq\Connection::ASYNC); } catch (pq\Exception $exception) { return new Failure(new ConnectionException("Could not connect to PostgreSQL server", 0, $exception)); } $connection->nonblocking = true; $connection->unbuffered = true; $deferred = new Deferred; $callback = function () use ($connection, $deferred): void { switch ($connection->poll()) { case pq\Connection::POLLING_READING: // Connection not ready, poll again. case pq\Connection::POLLING_WRITING: // Still writing... return; case pq\Connection::POLLING_FAILED: $deferred->fail(new ConnectionException($connection->errorMessage)); return; case pq\Connection::POLLING_OK: $deferred->resolve(new self($connection)); return; } }; $poll = Loop::onReadable($connection->socket, $callback); $await = Loop::onWritable($connection->socket, $callback); $promise = $deferred->promise(); $token = $token ?? new NullCancellationToken; $id = $token->subscribe([$deferred, "fail"]); $promise->onResolve(function () use ($poll, $await, $id, $token): void { $token->unsubscribe($id); Loop::cancel($poll); Loop::cancel($await); }); return $promise; } /** * @param \pq\Connection $handle */ public function __construct(pq\Connection $handle) { $this->handle = new PqHandle($handle); parent::__construct($this->handle); } /** * @return bool True if result sets are buffered in memory, false if unbuffered. */ public function isBufferingResults(): bool { return $this->handle->isBufferingResults(); } /** * Sets result sets to be fully buffered in local memory. */ public function shouldBufferResults(): void { $this->handle->shouldBufferResults(); } /** * Sets result sets to be streamed from the database server. */ public function shouldNotBufferResults(): void { $this->handle->shouldNotBufferResults(); } } result = $result; } /** * @return int Number of rows affected by the INSERT, UPDATE, or DELETE query. */ public function getAffectedRowCount(): int { return $this->result->affectedRows; } } * * @throws \Error If pecl-ev is used as a loop extension. */ public static function connect(ConnectionConfig $connectionConfig, ?CancellationToken $token = null): Promise { // @codeCoverageIgnoreStart if (Loop::get()->getHandle() instanceof \EvLoop) { throw new \Error('ext-pgsql is not compatible with pecl-ev; use pecl-pq or a different loop extension'); } // @codeCoverageIgnoreEnd if (!$connection = @\pg_connect($connectionConfig->getConnectionString(), \PGSQL_CONNECT_ASYNC | \PGSQL_CONNECT_FORCE_NEW)) { return new Failure(new ConnectionException("Failed to create connection resource")); } if (\pg_connection_status($connection) === \PGSQL_CONNECTION_BAD) { return new Failure(new ConnectionException(\pg_last_error($connection))); } if (!$socket = \pg_socket($connection)) { return new Failure(new ConnectionException("Failed to access connection socket")); } $deferred = new Deferred; $id = \sha1($connectionConfig->getHost() . $connectionConfig->getPort() . $connectionConfig->getUser()); $callback = function ($watcher, $resource) use ($connection, $deferred, $id): void { switch (\pg_connect_poll($connection)) { case \PGSQL_POLLING_READING: // Connection not ready, poll again. case \PGSQL_POLLING_WRITING: // Still writing... return; case \PGSQL_POLLING_FAILED: $deferred->fail(new ConnectionException(\pg_last_error($connection))); return; case \PGSQL_POLLING_OK: $deferred->resolve(new self($connection, $resource, $id)); return; } }; $poll = Loop::onReadable($socket, $callback); $await = Loop::onWritable($socket, $callback); $promise = $deferred->promise(); $token = $token ?? new NullCancellationToken; $id = $token->subscribe([$deferred, "fail"]); $promise->onResolve(function ($exception) use ($connection, $poll, $await, $id, $token): void { if ($exception) { \pg_close($connection); } $token->unsubscribe($id); Loop::cancel($poll); Loop::cancel($await); }); return $promise; } /** * @param resource $handle PostgreSQL connection handle. * @param resource $socket PostgreSQL connection stream socket. * @param string $id Connection identifier for determining which cached type table to use. */ public function __construct($handle, $socket, string $id = '') { parent::__construct(new PgSqlHandle($handle, $socket, $id)); } } listener = $listener; $this->release = $release; if (!$this->listener->isListening()) { ($this->release)(); $this->release = null; } } public function __destruct() { if ($this->listener->isListening()) { $this->unlisten(); // Invokes $this->release callback. } } public function advance(): Promise { return $this->listener->advance(); } public function getCurrent(): Notification { return $this->listener->getCurrent(); } public function getChannel(): string { return $this->listener->getChannel(); } public function isListening(): bool { return $this->listener->isListening(); } public function unlisten(): Promise { if (!$this->release) { throw new \Error("Already unlistened on this channel"); } $promise = $this->listener->unlisten(); $promise->onResolve($this->release); $this->release = null; return $promise; } } iterator = $iterator; $this->channel = $channel; $this->unlisten = $unlisten; } public function __destruct() { if ($this->unlisten) { $this->unlisten(); // Invokes $this->queue->complete(). } } /** * {@inheritdoc} */ public function advance(): Promise { return $this->iterator->advance(); } /** * {@inheritdoc} * * @return Notification */ public function getCurrent(): Notification { return $this->iterator->getCurrent(); } /** * @return string Channel name. */ public function getChannel(): string { return $this->channel; } /** * @return bool */ public function isListening(): bool { return $this->unlisten !== null; } /** * Unlistens from the channel. No more values will be emitted from this listener. * * @return Promise<\Amp\Sql\CommandResult> * * @throws \Error If this method was previously invoked. */ public function unlisten(): Promise { if (!$this->unlisten) { throw new \Error("Already unlistened on this channel"); } /** @var Promise $promise */ $promise = ($this->unlisten)($this->channel); $this->unlisten = null; return $promise; } } handle = $handle; $this->name = $name; $this->params = $params; $this->sql = $sql; $this->lastUsedAt = \time(); } public function __destruct() { $this->handle->statementDeallocate($this->name); } /** {@inheritdoc} */ public function isAlive(): bool { return $this->handle->isAlive(); } /** {@inheritdoc} */ public function getQuery(): string { return $this->sql; } /** {@inheritdoc} */ public function getLastUsedAt(): int { return $this->lastUsedAt; } /** {@inheritdoc} */ public function execute(array $params = []): Promise { $this->lastUsedAt = \time(); return $this->handle->statementExecute($this->name, Internal\replaceNamedParams($params, $this->params)); } } result = $result; $this->result->autoConvert = pq\Result::CONV_SCALAR | pq\Result::CONV_ARRAY; } /** * {@inheritdoc} */ public function advance(): Promise { $this->currentRow = null; if (++$this->position > $this->result->numRows) { return new Success(false); } return new Success(true); } /** * {@inheritdoc} */ public function getCurrent(): array { if ($this->currentRow !== null) { return $this->currentRow; } if ($this->position > $this->result->numRows) { throw new \Error("No more rows remain in the result set"); } return $this->currentRow = $this->result->fetchRow(pq\Result::FETCH_ASSOC); } public function getNumRows(): int { return $this->result->numRows; } public function getFieldCount(): int { return $this->result->numCols; } } , statement: pq\Statement, sql: string}> */ private $statements = []; /** @var int */ private $lastUsedAt; /** * Connection constructor. * * @param pq\Connection $handle */ public function __construct(pq\Connection $handle) { $this->handle = $handle; $this->lastUsedAt = \time(); $handle = &$this->handle; $lastUsedAt = &$this->lastUsedAt; $deferred = &$this->deferred; $listeners = &$this->listeners; $this->poll = Loop::onReadable($this->handle->socket, static function ($watcher) use (&$deferred, &$lastUsedAt, &$listeners, &$handle): void { $lastUsedAt = \time(); if ($handle->poll() === pq\Connection::POLLING_FAILED) { $exception = new ConnectionException($handle->errorMessage); $handle = null; // Marks connection as dead. Loop::disable($watcher); foreach ($listeners as $listener) { $listener->fail($exception); } if ($deferred !== null) { $deferred->fail($exception); } return; } if ($deferred === null) { return; // No active query, only notification listeners. } if ($handle->busy) { return; // Not finished receiving data, poll again. } $deferred->resolve($handle->getResult()); if (!$deferred && empty($listeners)) { Loop::unreference($watcher); } }); $this->await = Loop::onWritable($this->handle->socket, static function ($watcher) use (&$deferred, &$listeners, &$handle): void { try { if (!$handle->flush()) { return; // Not finished sending data, continue polling for writability. } } catch (pq\Exception $exception) { $exception = new ConnectionException("Flushing the connection failed", 0, $exception); $handle = null; // Marks connection as dead. foreach ($listeners as $listener) { $listener->fail($exception); } if ($deferred !== null) { $deferred->fail($exception); } } Loop::disable($watcher); }); Loop::unreference($this->poll); Loop::disable($this->await); } /** * Frees Io watchers from loop. */ public function __destruct() { $this->close(); } /** * {@inheritdoc} */ public function isAlive(): bool { return $this->handle !== null; } /** * {@inheritdoc} */ public function getLastUsedAt(): int { return $this->lastUsedAt; } /** * {@inheritdoc} */ public function close(): void { if ($this->deferred) { $deferred = $this->deferred; $this->deferred = null; $deferred->fail(new ConnectionException("The connection was closed")); } $this->handle = null; $this->free(); } private function free(): void { Loop::cancel($this->poll); Loop::cancel($this->await); } /** * @param string|null Query SQL or null if not related. * @param callable $method Method to execute. * @param mixed ...$args Arguments to pass to function. * * @return \Generator * * @resolve \Amp\Sql\CommandResult|\pq\Statement * * @throws FailureException */ private function send(?string $sql, callable $method, ...$args): \Generator { while ($this->busy) { try { yield $this->busy->promise(); } catch (\Throwable $exception) { // Ignore failure from another operation. } } if (!$this->handle) { throw new ConnectionException("The connection to the database has been closed"); } try { $this->deferred = $this->busy = new Deferred; $handle = $method(...$args); Loop::reference($this->poll); if (!$this->handle->flush()) { Loop::enable($this->await); } $result = yield $this->deferred->promise(); } catch (pq\Exception $exception) { throw new FailureException($this->handle->errorMessage, 0, $exception); } finally { $this->deferred = $this->busy = null; } if (!$result instanceof pq\Result) { throw new FailureException("Unknown query result"); } switch ($result->status) { case pq\Result::EMPTY_QUERY: throw new QueryError("Empty query string"); case pq\Result::COMMAND_OK: if ($handle instanceof pq\Statement) { return $handle; // Will be wrapped into a PqStatement object. } return new PqCommandResult($result); case pq\Result::TUPLES_OK: return new PqBufferedResultSet($result); case pq\Result::SINGLE_TUPLE: $this->busy = new Deferred; return new PqUnbufferedResultSet( coroutine(\Closure::fromCallable([$this, 'fetch'])), $result, \Closure::fromCallable([$this, 'release']) ); case pq\Result::NONFATAL_ERROR: case pq\Result::FATAL_ERROR: while ($this->handle->busy && $this->handle->getResult()); throw new QueryExecutionError($result->errorMessage, $result->diag, null, $sql ?? ''); case pq\Result::BAD_RESPONSE: $this->close(); throw new FailureException($result->errorMessage); default: $this->close(); throw new FailureException("Unknown result status"); } } private function fetch(): \Generator { if (!$this->handle->busy) { // Results buffered. $result = $this->handle->getResult(); } else { $this->deferred = new Deferred; Loop::reference($this->poll); if (!$this->handle->flush()) { Loop::enable($this->await); } try { $result = yield $this->deferred->promise(); } finally { $this->deferred = null; } } if (!$result) { throw new ConnectionException("Connection closed"); } switch ($result->status) { case pq\Result::TUPLES_OK: // End of result set. return null; case pq\Result::SINGLE_TUPLE: return $result; default: $this->close(); throw new FailureException($result->errorMessage); } } private function release(): void { \assert( $this->busy instanceof Deferred && $this->busy !== $this->deferred, "Connection in invalid state when releasing" ); while ($this->handle->busy && $this->handle->getResult()); $deferred = $this->busy; $this->busy = null; $deferred->resolve(); } /** * Executes the named statement using the given parameters. * * @param string $name * @param array $params * * @return Promise * @throws FailureException */ public function statementExecute(string $name, array $params): Promise { \assert(isset($this->statements[$name]), "Named statement not found when executing"); $storage = $this->statements[$name]; \assert($storage->statement instanceof pq\Statement, "Statement storage in invalid state"); return new Coroutine($this->send($storage->sql, [$storage->statement, "execAsync"], $params)); } /** * @param string $name * * @return Promise * * @throws FailureException */ public function statementDeallocate(string $name): Promise { if (!$this->handle) { return new Success; // Connection dead. } \assert(isset($this->statements[$name]), "Named statement not found when deallocating"); $storage = $this->statements[$name]; if (--$storage->refCount) { return new Success; } \assert($storage->statement instanceof pq\Statement, "Statement storage in invalid state"); return $storage->promise = call(function () use ($storage, $name) { yield from $this->send(null, [$storage->statement, "deallocateAsync"]); unset($this->statements[$name]); }); } /** * {@inheritdoc} */ public function query(string $sql): Promise { if (!$this->handle) { throw new \Error("The connection to the database has been closed"); } return new Coroutine($this->send($sql, [$this->handle, "execAsync"], $sql)); } /** * {@inheritdoc} */ public function execute(string $sql, array $params = []): Promise { if (!$this->handle) { throw new \Error("The connection to the database has been closed"); } $sql = Internal\parseNamedParams($sql, $names); $params = Internal\replaceNamedParams($params, $names); return new Coroutine($this->send($sql, [$this->handle, "execParamsAsync"], $sql, $params)); } /** * {@inheritdoc} */ public function prepare(string $sql): Promise { if (!$this->handle) { throw new \Error("The connection to the database has been closed"); } return call(function () use ($sql) { $modifiedSql = Internal\parseNamedParams($sql, $names); $name = Handle::STATEMENT_NAME_PREFIX . \sha1($modifiedSql); while (isset($this->statements[$name])) { $storage = $this->statements[$name]; ++$storage->refCount; // Statement may be being allocated or deallocated. Wait to finish, then check for existence again. if ($storage->promise instanceof Promise) { // Do not return promised prepared statement object, as the $names array may differ. yield $storage->promise; --$storage->refCount; continue; } return new PqStatement($this, $name, $sql, $names); } $storage = new class { use Struct; public $refCount = 1; /** @var Promise */ public $promise; /** @var pq\Statement */ public $statement; /** @var string */ public $sql; }; $storage->sql = $sql; $this->statements[$name] = $storage; try { $storage->statement = yield ( $storage->promise = new Coroutine($this->send($sql, [$this->handle, "prepareAsync"], $name, $modifiedSql)) ); } catch (\Throwable $exception) { unset($this->statements[$name]); throw $exception; } finally { $storage->promise = null; } return new PqStatement($this, $name, $sql, $names); }); } /** * {@inheritdoc} */ public function notify(string $channel, string $payload = ""): Promise { return new Coroutine($this->send(null, [$this->handle, "notifyAsync"], $channel, $payload)); } /** * {@inheritdoc} */ public function listen(string $channel): Promise { return call(function () use ($channel) { if (isset($this->listeners[$channel])) { throw new QueryError(\sprintf("Already listening on channel '%s'", $channel)); } $this->listeners[$channel] = $emitter = new Emitter; try { yield from $this->send( null, [$this->handle, "listenAsync"], $channel, static function (string $channel, string $message, int $pid) use ($emitter) { $notification = new Notification; $notification->channel = $channel; $notification->pid = $pid; $notification->payload = $message; $emitter->emit($notification); } ); } catch (\Throwable $exception) { unset($this->listeners[$channel]); throw $exception; } Loop::reference($this->poll); return new ConnectionListener($emitter->iterate(), $channel, \Closure::fromCallable([$this, 'unlisten'])); }); } /** * @param string $channel * * @return Promise * * @throws \Error */ private function unlisten(string $channel): Promise { \assert(isset($this->listeners[$channel]), "Not listening on that channel"); $emitter = $this->listeners[$channel]; unset($this->listeners[$channel]); if (!$this->handle) { $promise = new Success; // Connection already closed. } else { $promise = new Coroutine($this->send(null, [$this->handle, "unlistenAsync"], $channel)); } $promise->onResolve([$emitter, "complete"]); return $promise; } /** * {@inheritdoc} */ public function quoteString(string $data): string { if (!$this->handle) { throw new \Error("The connection to the database has been closed"); } return $this->handle->quote($data); } /** * {@inheritdoc} */ public function quoteName(string $name): string { if (!$this->handle) { throw new \Error("The connection to the database has been closed"); } return $this->handle->quoteName($name); } /** * @return bool True if result sets are buffered in memory, false if unbuffered. */ public function isBufferingResults(): bool { if (!$this->handle) { throw new \Error("The connection to the database has been closed"); } return !$this->handle->unbuffered; } /** * Sets result sets to be fully buffered in local memory. */ public function shouldBufferResults() { if (!$this->handle) { throw new \Error("The connection to the database has been closed"); } $this->handle->unbuffered = false; } /** * Sets result sets to be streamed from the database server. */ public function shouldNotBufferResults() { if (!$this->handle) { throw new \Error("The connection to the database has been closed"); } $this->handle->unbuffered = true; } } timeout = $timeout; } /** * {@inheritdoc} * * @throws FailureException If connecting fails. * * @throws \Error If neither ext-pgsql or pecl-pq is loaded. */ public function connect(SqlConnectionConfig $connectionConfig): Promise { if (!$connectionConfig instanceof ConnectionConfig) { throw new \TypeError(\sprintf("Must provide an instance of %s to Postgres connectors", ConnectionConfig::class)); } $token = new TimeoutCancellationToken($this->timeout); if (\extension_loaded("pq")) { return PqConnection::connect($connectionConfig, $token); } if (\extension_loaded("pgsql")) { return PgSqlConnection::connect($connectionConfig, $token); } throw new \Error("amphp/postgres requires either pecl-pq or ext-pgsql"); } } diagnostics = $diagnostics; } public function getDiagnostics(): array { return $this->diagnostics; } } * * @throws \Amp\Sql\FailureException If the operation fails due to unexpected condition. * @throws \Amp\Sql\ConnectionException If the connection to the database is lost. * @throws \Amp\Sql\QueryError If the operation fails due to an error in the query (such as a syntax error). */ public function listen(string $channel): Promise; } withSslMode($parts["sslmode"]); } return $config; } public function __construct( string $host, int $port = self::DEFAULT_PORT, string $user = null, string $password = null, string $database = null ) { parent::__construct($host, $port, $user, $password, $database); } public function __clone() { $this->string = null; } public function getSslMode(): ?string { return $this->sslMode; } public function withSslMode(string $mode): self { if (!\in_array($mode, self::SSL_MODES, true)) { throw new \Error('Invalid SSL mode, must be one of: ' . \implode(', ', self::SSL_MODES)); } $new = clone $this; $new->sslMode = $mode; return $new; } public function withoutSslMode(): self { $new = clone $this; $new->sslMode = null; return $new; } /** * @return string Connection string used with ext-pgsql and pecl-pq. */ public function getConnectionString(): string { if ($this->string !== null) { return $this->string; } $chunks = [ "host=" . $this->getHost(), "port=" . $this->getPort(), ]; $user = $this->getUser(); if ($user !== null) { $chunks[] = "user=" . $user; } $password = $this->getPassword(); if ($password !== null) { $chunks[] = "password=" . $password; } $database = $this->getDatabase(); if ($database !== null) { $chunks[] = "dbname=" . $database; } if ($this->sslMode !== null) { $chunks[] = "sslmode=" . $this->sslMode; } return $this->string = \implode(" ", $chunks); } } parser($data, $cast, $delimiter); $data = \iterator_to_array($parser); if ($parser->getReturn() !== '') { throw new ParseException("Data left in buffer after parsing"); } return $data; } /** * Recursive generator parser yielding array values. * * @param string $data Remaining buffer data. * @param callable $cast Callback to cast parsed values. * @param string $delimiter Delimiter used to separate values. * * @return \Generator * * @throws ParseException */ private function parser(string $data, callable $cast, string $delimiter = ','): \Generator { if ($data === '') { throw new ParseException("Unexpected end of data"); } if ($data[0] !== '{') { throw new ParseException("Missing opening bracket"); } $data = \ltrim(\substr($data, 1)); do { if ($data === '') { throw new ParseException("Unexpected end of data"); } if ($data[0] === '}') { // Empty array return \ltrim(\substr($data, 1)); } if ($data[0] === '{') { // Array $parser = $this->parser($data, $cast, $delimiter); yield \iterator_to_array($parser); $data = $parser->getReturn(); $end = $this->trim($data, 0, $delimiter); continue; } if ($data[0] === '"') { // Quoted value for ($position = 1; isset($data[$position]); ++$position) { if ($data[$position] === '\\') { ++$position; // Skip next character continue; } if ($data[$position] === '"') { break; } } if (!isset($data[$position])) { throw new ParseException("Could not find matching quote in quoted value"); } $yield = \stripslashes(\substr($data, 1, $position - 1)); $end = $this->trim($data, $position + 1, $delimiter); } else { // Unquoted value $position = 0; while (isset($data[$position]) && $data[$position] !== $delimiter && $data[$position] !== '}') { ++$position; } $yield = \trim(\substr($data, 0, $position)); $end = $this->trim($data, $position, $delimiter); if (\strcasecmp($yield, "NULL") === 0) { // Literal NULL is always unquoted. yield null; continue; } } yield $cast($yield); } while ($end !== '}'); return $data; } /** * @param string $data Data trimmed past next delimiter and any whitespace to the right of the delimiter. * @param int $position Position to start search for delimiter. * @param string $delimiter Delimiter used to separate values. * * @return string First non-whitespace character after given position. * * @throws ParseException */ private function trim(string &$data, int $position, string $delimiter): string { $data = \ltrim(\substr($data, $position)); if ($data === '') { throw new ParseException("Unexpected end of data"); } $end = $data[0]; if ($end !== $delimiter && $end !== '}') { throw new ParseException("Invalid delimiter"); } $data = \ltrim(\substr($data, 1)); return $end; } } \$(?\d+) | # Match all question marks except those surrounded by "operator"-class characters on either side. (?[-+\\*/<>~!@#%^&|`?])) \? (?!\g|=) | :\? ) | # Named parameters. (?[a-zA-Z_][a-zA-Z0-9_]*) ]msxS REGEX; /** * @param string $sql SQL statement with named and unnamed placeholders. * @param array|null $names [Output] Array of parameter positions mapped to names and/or indexed locations. * * @return string SQL statement with Postgres-style placeholders */ function parseNamedParams(string $sql, ?array &$names): string { $names = []; return \preg_replace_callback(STATEMENT_PARAM_REGEX, function (array $matches) use (&$names): string { static $index = 0, $unnamed = 0, $numbered = 1; if (isset($matches['named'])) { $names[$index] = $matches['named']; } elseif (!isset($matches['numbered'])) { $names[$index] = $unnamed++; } else { if ($unnamed > 0) { throw new \Error("Cannot mix unnamed (? placeholders) with numbered parameters"); } $position = (int) $matches['numbered']; if ($position <= 0 || $position > $numbered + 1) { throw new \Error("Numbered placeholders must be sequential starting at 1"); } $numbered = \max($position, $numbered); $names[$index] = $position - 1; } return '$' . ++$index; }, $sql); } /** * @param mixed[] $params User-provided array of statement parameters. * @param mixed[] $names Array generated by parseNamedParams. * * @return mixed[] * * @throws \Error If the $param array does not contain a key corresponding to a named parameter. */ function replaceNamedParams(array $params, array $names): array { $values = []; foreach ($names as $index => $name) { if (!\array_key_exists($name, $params)) { if (\is_int($name)) { $message = \sprintf("Value for unnamed parameter at position %s missing", $name); } else { $message = \sprintf("Value for named parameter '%s' missing", $name); } throw new \Error($message); } $values[$index] = cast($params[$name]); } return $values; } * * @throws \Amp\Sql\FailureException If the operation fails due to unexpected condition. * @throws \Amp\Sql\ConnectionException If the connection to the database is lost. */ public function notify(string $channel, string $payload = ""): Promise; } numCols = $result->numCols; $destroyed = &$this->destroyed; $this->producer = new Producer(static function (callable $emit) use (&$destroyed, $release, $result, $fetch) { try { do { $result->autoConvert = pq\Result::CONV_SCALAR | pq\Result::CONV_ARRAY; $next = $fetch(); yield $emit($result); $result = yield $next; } while ($result instanceof pq\Result); } finally { $destroyed = true; $release(); } }); } public function __destruct() { if ($this->destroyed) { return; } $producer = $this->producer; asyncCall(static function () use ($producer) { try { while (yield $producer->advance()); } catch (\Throwable $exception) { // Ignore iterator failure when destroying. } }); } /** * {@inheritdoc} */ public function advance(): Promise { $this->currentRow = null; return $this->producer->advance(); } /** * {@inheritdoc} */ public function getCurrent(): array { if ($this->currentRow !== null) { return $this->currentRow; } $result = $this->producer->getCurrent(); \assert($result instanceof pq\Result); return $this->currentRow = $result->fetchRow(pq\Result::FETCH_ASSOC); } /** * @return int Number of fields (columns) in each result set. */ public function getFieldCount(): int { return $this->numCols; } } * * @throws \Amp\Sql\FailureException If connecting fails. * * @throws \Error If neither ext-pgsql or pecl-pq is loaded. * * @codeCoverageIgnore */ function connect(SqlConnectionConfig $config): Promise { return connector()->connect($config); } /** * Create a pool using the global Connector instance. * * @param SqlConnectionConfig $config * @param int $maxConnections * @param int $idleTimeout * @param bool $resetConnections * * @return Pool */ function pool( SqlConnectionConfig $config, int $maxConnections = ConnectionPool::DEFAULT_MAX_CONNECTIONS, int $idleTimeout = ConnectionPool::DEFAULT_IDLE_TIMEOUT, bool $resetConnections = true ): Pool { return new Pool($config, $maxConnections, $idleTimeout, $resetConnections, connector()); } /** * Casts a PHP value to a representation that is understood by Postgres, including encoding arrays. * * @param mixed $value * * @return string|int|float|null * * @throws \Error If $value is an object without a __toString() method, a resource, or an unknown type. */ function cast($value) { switch ($type = \gettype($value)) { case "NULL": case "integer": case "double": case "string": return $value; // No casting necessary for numerics, strings, and null. case "boolean": return $value ? 't' : 'f'; case "array": return encode($value); case "object": if (!\method_exists($value, "__toString")) { throw new \Error("Object without a __toString() method included in parameter values"); } return (string) $value; default: throw new \Error("Invalid value type '$type' in parameter values"); } } /** * Encodes an array into a PostgreSQL representation of the array. * * @param array $array * * @return string The serialized representation of the array. * * @throws \Error If $array contains an object without a __toString() method, a resource, or an unknown type. */ function encode(array $array): string { $array = \array_map(function ($value) { switch (\gettype($value)) { case "NULL": return "NULL"; case "object": if (!\method_exists($value, "__toString")) { throw new \Error("Object without a __toString() method in array"); } $value = (string) $value; // no break case "string": return '"' . \str_replace(['\\', '"'], ['\\\\', '\\"'], $value) . '"'; default: return cast($value); // Recursively encodes arrays and errors on invalid values. } }, $array); return '{' . \implode(',', $array) . '}'; } transaction = $transaction; } public function notify(string $channel, string $payload = ""): Promise { return $this->transaction->notify($channel, $payload); } public function quoteString(string $data): string { return $this->transaction->quoteString($data); } public function quoteName(string $name): string { return $this->transaction->quoteName($name); } } handle = $handle; } /** * Frees the result resource. */ public function __destruct() { \pg_free_result($this->handle); } /** * @return int Number of rows affected by the INSERT, UPDATE, or DELETE query. */ public function getAffectedRowCount(): int { return \pg_affected_rows($this->handle); } /** * @deprecated This is not meant to be used to get the last insertion ID. Use `INSERT ... RETURNING column_name` * to get the last auto-increment ID. * * $sql = "INSERT INTO person (lastname, firstname) VALUES (?, ?) RETURNING id;" * $statement = yield $pool->prepare($sql); * $result = yield $statement->execute(['Doe', 'John']); * if (!yield $result->advance()) { * throw new \RuntimeException("Insertion failed"); * } * $id = $result->getCurrent()['id']; * * @return string */ public function getLastOid(): string { return (string) \pg_last_oid($this->handle); } } * * @throws \Error If this method was previously invoked. */ public function unlisten(): Promise; } handle = $handle; $this->name = $name; $this->sql = $sql; $this->params = $params; $this->lastUsedAt = \time(); } public function __destruct() { $this->handle->statementDeallocate($this->name); } /** {@inheritdoc} */ public function isAlive(): bool { return $this->handle->isAlive(); } /** {@inheritdoc} */ public function getQuery(): string { return $this->sql; } /** {@inheritdoc} */ public function getLastUsedAt(): int { return $this->lastUsedAt; } /** {@inheritdoc} */ public function execute(array $params = []): Promise { return $this->handle->statementExecute($this->name, Internal\replaceNamedParams($params, $this->params)); } } */ abstract public static function connect(ConnectionConfig $connectionConfig, ?CancellationToken $token = null): Promise; /** * @param Handle $handle */ public function __construct(Handle $handle) { $this->handle = $handle; } /** * {@inheritdoc} */ final public function isAlive(): bool { return $this->handle->isAlive(); } /** * {@inheritdoc} */ final public function getLastUsedAt(): int { return $this->handle->getLastUsedAt(); } /** * {@inheritdoc} */ final public function close(): void { $this->handle->close(); } /** * @param string $methodName Method to execute. * @param mixed ...$args Arguments to pass to function. * * @return Promise */ private function send(string $methodName, ...$args): Promise { if ($this->busy) { return call(function () use ($methodName, $args) { while ($this->busy) { yield $this->busy->promise(); } return yield $this->handle->{$methodName}(...$args); }); } return $this->handle->{$methodName}(...$args); } /** * Reserves the connection for a transaction. */ private function reserve(): void { \assert($this->busy === null); $this->busy = new Deferred; } /** * Releases the transaction lock. */ private function release(): void { \assert($this->busy !== null); $deferred = $this->busy; $this->busy = null; $deferred->resolve(); } /** * {@inheritdoc} */ final public function query(string $sql): Promise { return $this->send("query", $sql); } /** * {@inheritdoc} */ final public function execute(string $sql, array $params = []): Promise { return $this->send("execute", $sql, $params); } /** * {@inheritdoc} */ final public function prepare(string $sql): Promise { return $this->send("prepare", $sql); } /** * {@inheritdoc} */ final public function notify(string $channel, string $payload = ""): Promise { return $this->send("notify", $channel, $payload); } /** * {@inheritdoc} */ final public function listen(string $channel): Promise { return $this->send("listen", $channel); } /** * {@inheritdoc} */ final public function beginTransaction(int $isolation = Transaction::ISOLATION_COMMITTED): Promise { return call(function () use ($isolation) { $this->reserve(); try { switch ($isolation) { case Transaction::ISOLATION_UNCOMMITTED: yield $this->handle->query("BEGIN TRANSACTION ISOLATION LEVEL READ UNCOMMITTED"); break; case Transaction::ISOLATION_COMMITTED: yield $this->handle->query("BEGIN TRANSACTION ISOLATION LEVEL READ COMMITTED"); break; case Transaction::ISOLATION_REPEATABLE: yield $this->handle->query("BEGIN TRANSACTION ISOLATION LEVEL REPEATABLE READ"); break; case Transaction::ISOLATION_SERIALIZABLE: yield $this->handle->query("BEGIN TRANSACTION ISOLATION LEVEL SERIALIZABLE"); break; default: throw new \Error("Invalid transaction type"); } } catch (\Throwable $exception) { $this->release(); throw $exception; } return new ConnectionTransaction($this->handle, \Closure::fromCallable([$this, 'release']), $isolation); }); } /** * {@inheritdoc} */ final public function quoteString(string $data): string { return $this->handle->quoteString($data); } /** * {@inheritdoc} */ final public function quoteName(string $name): string { return $this->handle->quoteName($name); } } isolation = $isolation; break; default: throw new \Error("Isolation must be a valid transaction isolation level"); } $this->handle = $handle; $refCount =& $this->refCount; $this->release = static function () use (&$refCount, $release) { if (--$refCount === 0) { $release(); } }; } public function __destruct() { if ($this->handle && $this->handle->isAlive()) { $this->rollback(); // Invokes $this->release callback. } } /** * {@inheritdoc} */ public function getLastUsedAt(): int { return $this->handle->getLastUsedAt(); } /** * {@inheritdoc} * * Closes and commits all changes in the transaction. */ public function close(): void { if ($this->handle) { $this->commit(); // Invokes $this->release callback. } } /** * {@inheritdoc} */ public function isAlive(): bool { return $this->handle && $this->handle->isAlive(); } /** * @return bool True if the transaction is active, false if it has been committed or rolled back. */ public function isActive(): bool { return $this->handle !== null; } /** * @return int */ public function getIsolationLevel(): int { return $this->isolation; } /** * {@inheritdoc} * * @throws TransactionError If the transaction has been committed or rolled back. */ public function query(string $sql): Promise { if ($this->handle === null) { throw new TransactionError("The transaction has been committed or rolled back"); } return call(function () use ($sql) { ++$this->refCount; try { $result = yield $this->handle->query($sql); } finally { ($this->release)(); } if ($result instanceof ResultSet) { ++$this->refCount; return new PooledResultSet($result, $this->release); } return $result; }); } /** * {@inheritdoc} * * @throws TransactionError If the transaction has been committed or rolled back. */ public function prepare(string $sql): Promise { if ($this->handle === null) { throw new TransactionError("The transaction has been committed or rolled back"); } return call(function () use ($sql) { ++$this->refCount; try { $statement = yield $this->handle->prepare($sql); } catch (\Throwable $exception) { ($this->release)(); throw $exception; } return new PooledStatement($statement, $this->release); }); } /** * {@inheritdoc} * * @throws TransactionError If the transaction has been committed or rolled back. */ public function execute(string $sql, array $params = []): Promise { if ($this->handle === null) { throw new TransactionError("The transaction has been committed or rolled back"); } return call(function () use ($sql, $params) { ++$this->refCount; try { $result = yield $this->handle->execute($sql, $params); } finally { ($this->release)(); } if ($result instanceof ResultSet) { ++$this->refCount; return new PooledResultSet($result, $this->release); } return $result; }); } /** * {@inheritdoc} * * @throws TransactionError If the transaction has been committed or rolled back. */ public function notify(string $channel, string $payload = ""): Promise { if ($this->handle === null) { throw new TransactionError("The transaction has been committed or rolled back"); } return $this->handle->notify($channel, $payload); } /** * Commits the transaction and makes it inactive. * * @return Promise<\Amp\Sql\CommandResult> * * @throws TransactionError If the transaction has been committed or rolled back. */ public function commit(): Promise { if ($this->handle === null) { throw new TransactionError("The transaction has been committed or rolled back"); } $promise = $this->handle->query("COMMIT"); $this->handle = null; $promise->onResolve($this->release); return $promise; } /** * Rolls back the transaction and makes it inactive. * * @return Promise<\Amp\Sql\CommandResult> * * @throws TransactionError If the transaction has been committed or rolled back. */ public function rollback(): Promise { if ($this->handle === null) { throw new TransactionError("The transaction has been committed or rolled back"); } $promise = $this->handle->query("ROLLBACK"); $this->handle = null; $promise->onResolve($this->release); return $promise; } /** * Creates a savepoint with the given identifier. * * @param string $identifier Savepoint identifier. * * @return Promise<\Amp\Sql\CommandResult> * * @throws TransactionError If the transaction has been committed or rolled back. */ public function createSavepoint(string $identifier): Promise { return $this->query("SAVEPOINT " . $this->quoteName($identifier)); } /** * Rolls back to the savepoint with the given identifier. * * @param string $identifier Savepoint identifier. * * @return Promise<\Amp\Sql\CommandResult> * * @throws TransactionError If the transaction has been committed or rolled back. */ public function rollbackTo(string $identifier): Promise { return $this->query("ROLLBACK TO " . $this->quoteName($identifier)); } /** * Releases the savepoint with the given identifier. * * @param string $identifier Savepoint identifier. * * @return Promise<\Amp\Sql\CommandResult> * * @throws TransactionError If the transaction has been committed or rolled back. */ public function releaseSavepoint(string $identifier): Promise { return $this->query("RELEASE SAVEPOINT " . $this->quoteName($identifier)); } /** * {@inheritdoc} * * @throws TransactionError If the transaction has been committed or rolled back. */ public function quoteString(string $data): string { if ($this->handle === null) { throw new TransactionError("The transaction has been committed or rolled back"); } return $this->handle->quoteString($data); } /** * {@inheritdoc} * * @throws TransactionError If the transaction has been committed or rolled back. */ public function quoteName(string $name): string { if ($this->handle === null) { throw new TransactionError("The transaction has been committed or rolled back"); } return $this->handle->quoteName($name); } } result = $result; } public function getFieldCount(): int { return $this->result->getFieldCount(); } } resetConnections = $resetConnections; } /** * @return Connector The Connector instance defined by the connector() function. */ protected function createDefaultConnector(): Connector { return connector(); } protected function createStatement(SqlStatement $statement, callable $release): SqlStatement { return new PooledStatement($statement, $release); } protected function createStatementPool(SqlPool $pool, SqlStatement $statement, callable $prepare): SqlStatementPool { return new StatementPool($pool, $statement, $prepare); } protected function createTransaction(SqlTransaction $transaction, callable $release): SqlTransaction { \assert($transaction instanceof Transaction); return new PooledTransaction($transaction, $release); } protected function createResultSet(SqlResultSet $resultSet, callable $release): SqlResultSet { \assert($resultSet instanceof ResultSet); return new PooledResultSet($resultSet, $release); } protected function pop(): \Generator { $connection = yield from parent::pop(); \assert($connection instanceof Connection); if ($this->resetConnections) { yield $connection->query("DISCARD ALL"); } return $connection; } /** * {@inheritdoc} */ public function notify(string $channel, string $payload = ""): Promise { return call(function () use ($channel, $payload) { $connection = yield from $this->pop(); \assert($connection instanceof Connection); try { $result = yield $connection->notify($channel, $payload); } finally { $this->push($connection); } return $result; }); } /** * {@inheritdoc} */ public function listen(string $channel): Promise { return call(function () use ($channel) { ++$this->listenerCount; if ($this->listeningConnection === null) { $this->listeningConnection = new Coroutine($this->pop()); } if ($this->listeningConnection instanceof Promise) { $this->listeningConnection = yield $this->listeningConnection; } try { $listener = yield $this->listeningConnection->listen($channel); \assert($listener instanceof Listener); } catch (\Throwable $exception) { if (--$this->listenerCount === 0) { $connection = $this->listeningConnection; $this->listeningConnection = null; $this->push($connection); } throw $exception; } return new PooledListener($listener, function () { if (--$this->listenerCount === 0) { $connection = $this->listeningConnection; $this->listeningConnection = null; $this->push($connection); } }); }); } } driver->openFile($path, "c+"); $this->assertSame(0, $handle->tell()); $handle->write("foo"); $this->assertSame(3, yield $handle->write("bar")); yield $handle->seek(0); $contents = yield $handle->read(); $this->assertSame(6, $handle->tell()); $this->assertTrue($handle->eof()); $this->assertSame("foobar", $contents); yield $handle->close(); } public function testEmptyWrite(): \Generator { $path = Fixture::path() . "/write"; $handle = yield $this->driver->openFile($path, "c+"); $this->assertSame(0, $handle->tell()); $this->assertSame(0, yield $handle->write("")); $this->assertSame(0, $handle->tell()); yield $handle->close(); } public function testWriteAfterClose(): \Generator { $path = Fixture::path() . "/write"; /** @var File\File $handle */ $handle = yield $this->driver->openFile($path, "c+"); yield $handle->close(); $this->expectException(ClosedException::class); $this->assertSame(3, yield $handle->write("bar")); } public function testDoubleClose(): \Generator { $path = Fixture::path() . "/write"; /** @var File\File $handle */ $handle = yield $this->driver->openFile($path, "c+"); yield $handle->close(); $this->assertNull(yield $handle->close()); } public function testWriteAfterEnd(): \Generator { $path = Fixture::path() . "/write"; /** @var File\File $handle */ $handle = yield $this->driver->openFile($path, "c+"); $this->assertSame(0, $handle->tell()); yield $handle->end("foo"); $this->expectException(ClosedException::class); $this->assertSame(3, yield $handle->write("bar")); } public function testWriteInAppendMode(): \Generator { $path = Fixture::path() . "/write"; /** @var File\File $handle */ $handle = yield $this->driver->openFile($path, "a+"); $this->assertSame(0, $handle->tell()); $this->assertSame(3, yield $handle->write("bar")); $this->assertSame(3, yield $handle->write("foo")); $this->assertSame(3, yield $handle->write("baz")); $this->assertSame(9, $handle->tell()); yield $handle->seek(0); $this->assertSame(0, $handle->tell()); $this->assertSame("barfoobaz", yield $handle->read()); } public function testReadingToEof(): \Generator { /** @var File\File $handle */ $handle = yield $this->driver->openFile(__FILE__, "r"); $contents = ""; $position = 0; $stat = yield $this->driver->getStatus(__FILE__); $chunkSize = (int) \floor(($stat["size"] / 5)); while (!$handle->eof()) { $chunk = yield $handle->read($chunkSize); if ($chunk !== null) { $contents .= $chunk; $position += \strlen($chunk); } $this->assertSame($position, $handle->tell()); } $this->assertNull(yield $handle->read()); $this->assertSame(yield $this->driver->read(__FILE__), $contents); yield $handle->close(); } public function testSequentialReads(): \Generator { /** @var File\File $handle */ $handle = yield $this->driver->openFile(__FILE__, "r"); $contents = ""; $contents .= yield $handle->read(10); $contents .= yield $handle->read(10); $expected = \substr(yield $this->driver->read(__FILE__), 0, 20); $this->assertSame($expected, $contents); yield $handle->close(); } public function testReadingFromOffset(): \Generator { /** @var File\File $handle */ $handle = yield $this->driver->openFile(__FILE__, "r"); $this->assertSame(0, $handle->tell()); yield $handle->seek(10); $this->assertSame(10, $handle->tell()); $chunk = yield $handle->read(90); $this->assertSame(100, $handle->tell()); $expected = \substr(yield $this->driver->read(__FILE__), 10, 90); $this->assertSame($expected, $chunk); yield $handle->close(); } public function testSeekThrowsOnInvalidWhence(): \Generator { $this->expectException(\Error::class); try { /** @var File\File $handle */ $handle = yield $this->driver->openFile(__FILE__, "r"); yield $handle->seek(0, 99999); } finally { yield $handle->close(); } } public function testSeekSetCur(): \Generator { /** @var File\File $handle */ $handle = yield $this->driver->openFile(__FILE__, "r"); $this->assertSame(0, $handle->tell()); yield $handle->seek(10); $this->assertSame(10, $handle->tell()); yield $handle->seek(-10, \SEEK_CUR); $this->assertSame(0, $handle->tell()); yield $handle->close(); } public function testSeekSetEnd(): \Generator { $size = \filesize(__FILE__); /** @var File\File $handle */ $handle = yield $this->driver->openFile(__FILE__, "r"); $this->assertSame(0, $handle->tell()); yield $handle->seek(-10, \SEEK_END); $this->assertSame($size - 10, $handle->tell()); yield $handle->close(); } public function testPath(): \Generator { /** @var File\File $handle */ $handle = yield $this->driver->openFile(__FILE__, "r"); $this->assertSame(__FILE__, $handle->getPath()); yield $handle->close(); } public function testMode(): \Generator { /** @var File\File $handle */ $handle = yield $this->driver->openFile(__FILE__, "r"); $this->assertSame("r", $handle->getMode()); yield $handle->close(); } public function testClose(): \Generator { /** @var File\File $handle */ $handle = yield $this->driver->openFile(__FILE__, "r"); yield $handle->close(); $this->expectException(ClosedException::class); yield $handle->read(); } /** * @depends testWrite */ public function testTruncateToSmallerSize(): \Generator { $path = Fixture::path() . "/write"; /** @var File\File $handle */ $handle = yield $this->driver->openFile($path, "c+"); $handle->write("foo"); $this->assertSame(3, yield $handle->write("bar")); yield $handle->truncate(4); yield $handle->seek(0); $contents = yield $handle->read(); $this->assertTrue($handle->eof()); $this->assertSame("foob", $contents); $this->assertSame(3, yield $handle->write("bar")); $this->assertSame(7, $handle->tell()); yield $handle->seek(0); $contents = yield $handle->read(); $this->assertSame("foobbar", $contents); yield $handle->close(); } /** * @depends testWrite */ public function testTruncateToLargerSize(): \Generator { $path = Fixture::path() . "/write"; /** @var File\File $handle */ $handle = yield $this->driver->openFile($path, "c+"); $this->assertSame(3, yield $handle->write("foo")); yield $handle->truncate(6); $this->assertSame(3, $handle->tell()); yield $handle->seek(0); $contents = yield $handle->read(); $this->assertTrue($handle->eof()); $this->assertSame("foo\0\0\0", $contents); $this->assertSame(3, yield $handle->write("bar")); $this->assertSame(9, $handle->tell()); yield $handle->seek(0); $contents = yield $handle->read(); $this->assertSame("foo\0\0\0bar", $contents); yield $handle->close(); } abstract protected function createDriver(): File\Driver; protected function setUp(): void { parent::setUp(); $this->driver = $this->createDriver(); } } expectException(PendingOperationError::class); /** @var File\File $handle */ $handle = yield File\openFile(__FILE__, "r"); $promise1 = $handle->read(); $promise2 = $handle->read(); $expected = \substr(yield File\read(__FILE__), 0, 20); $this->assertSame($expected, yield $promise1); yield $promise2; } public function testSeekWhileReading(): \Generator { $this->expectException(PendingOperationError::class); /** @var File\File $handle */ $handle = yield File\openFile(__FILE__, "r"); $promise1 = $handle->read(10); $promise2 = $handle->seek(0); $expected = \substr(yield File\read(__FILE__), 0, 10); $this->assertSame($expected, yield $promise1); yield $promise2; } public function testReadWhileWriting(): \Generator { $this->expectException(PendingOperationError::class); $path = Fixture::path() . "/temp"; /** @var File\File $handle */ $handle = yield File\openFile($path, "c+"); $data = "test"; $promise1 = $handle->write($data); $promise2 = $handle->read(10); $this->assertSame(\strlen($data), yield $promise1); yield $promise2; // Should throw. } public function testWriteWhileReading(): \Generator { $this->expectException(PendingOperationError::class); $path = Fixture::path() . "/temp"; /** @var File\File $handle */ $handle = yield File\openFile($path, "c+"); $promise1 = $handle->read(10); $promise2 = $handle->write("test"); $expected = \substr(yield File\read(__FILE__), 0, 10); $this->assertSame($expected, yield $promise1); yield $promise2; // Should throw. } } markTestSkipped('UvDriver Test Skipped: Causes Crash'); } yield from parent::testResolveSymlinkError($linkResolver); } protected function createDriver(): File\Driver { if (!\extension_loaded("uv")) { $this->markTestSkipped("php-uv extension not loaded"); } $loop = new Loop\UvDriver; Loop::set($loop); return new UvDriver($loop); } } markTestSkipped("eio extension not loaded"); } return new EioDriver(Loop::get()); } } pool = new DefaultPool; return new ParallelDriver($this->pool); } protected function tearDownAsync(): void { $this->pool->shutdown(); } } pool = new DefaultPool; return new ParallelDriver($this->pool); } protected function tearDownAsync(): void { $this->pool->shutdown(); } } markTestSkipped("php-uv extension not loaded"); } $loop = new Loop\UvDriver; Loop::set($loop); return new UvDriver($loop); } } markTestSkipped("eio extension not loaded"); } return new EioDriver(Loop::get()); } } driver->listFiles($fixtureDir); $expected = ["dir", "dirlink", "fifo", "fifolink", "file", "filelink", "linkloop"]; $this->assertSame($expected, $actual); } public function testListFilesThrowsIfPathNotADirectory(): \Generator { $this->expectException(FilesystemException::class); yield $this->driver->listFiles(__FILE__); } public function testListFilesThrowsIfPathDoesntExist(): \Generator { $this->expectException(FilesystemException::class); $path = Fixture::path() . "/nonexistent"; yield $this->driver->listFiles($path); } public function testCreateSymlink(): \Generator { $fixtureDir = Fixture::path(); $original = "{$fixtureDir}/file"; $link = "{$fixtureDir}/symlink.txt"; $this->assertNull(yield $this->driver->createSymlink($original, $link)); $this->assertTrue(\is_link($link)); yield $this->driver->deleteFile($link); } public function testCreateSymlinkFailWhenLinkExists(): \Generator { $this->expectException(FilesystemException::class); $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/file"; yield $this->driver->createSymlink($path, $path); } public function testCreateHardlink(): \Generator { $fixtureDir = Fixture::path(); $original = "{$fixtureDir}/file"; $link = "{$fixtureDir}/hardlink.txt"; $this->assertNull(yield $this->driver->createHardlink($original, $link)); $this->assertFileExists($link); $this->assertFalse(\is_link($link)); yield $this->driver->deleteFile($link); } public function testCreateHardlinkFailWhenLinkExists(): \Generator { $this->expectException(FilesystemException::class); $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/file"; yield $this->driver->createHardlink($path, $path); } public function testResolveSymlink(): \Generator { $fixtureDir = Fixture::path(); $original = "{$fixtureDir}/file"; $link = "{$fixtureDir}/symlink.txt"; \symlink($original, $link); $this->assertSame($original, yield $this->driver->resolveSymlink($link)); } public function symlinkPathProvider(): array { return [ 'nonExistingPath' => [ static function () { return Fixture::path() . '/' . \uniqid('amphp-test-', true); }, ], 'notLink' => [ static function () { return Fixture::path(); }, ], ]; } /** * @dataProvider symlinkPathProvider * * @param \Closure $linkResolver * * @return \Generator */ public function testResolveSymlinkError(\Closure $linkResolver): \Generator { $this->expectException(FilesystemException::class); $link = $linkResolver(); yield $this->driver->resolveSymlink($link); } public function testLinkStatus(): \Generator { $fixtureDir = Fixture::path(); $target = "{$fixtureDir}/file"; $link = "{$fixtureDir}/symlink.txt"; yield $this->driver->createSymlink($target, $link); $this->assertIsArray(yield $this->driver->getLinkStatus($link)); yield $this->driver->deleteFile($link); } public function testStatus(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/file"; $stat = yield $this->driver->getStatus($path); $this->assertIsArray($stat); $this->assertSameStatus(\stat($path), $stat); } public function testDirectoryStatus(): \Generator { $fixtureDir = Fixture::path(); $stat = yield $this->driver->getStatus("{$fixtureDir}/dir"); $this->assertIsArray($stat); $this->assertSameStatus(\stat("{$fixtureDir}/dir"), $stat); } public function testNonexistentPathStatusResolvesToNull(): \Generator { $fixtureDir = Fixture::path(); $stat = yield $this->driver->getStatus("{$fixtureDir}/nonexistent"); $this->assertNull($stat); } public function testExists(): \Generator { $fixtureDir = Fixture::path(); $this->assertFalse(yield $this->driver->exists("{$fixtureDir}/nonexistent")); $this->assertTrue(yield $this->driver->exists("{$fixtureDir}/file")); } public function testRead(): \Generator { $fixtureDir = Fixture::path(); $this->assertSame("small", yield $this->driver->read("{$fixtureDir}/file")); } public function testSize(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/file"; $stat = (yield $this->driver->getStatus($path)); $size = $stat["size"]; $this->assertSame($size, yield $this->driver->getSize($path)); } public function testSizeFailsOnNonexistentPath(): \Generator { $this->expectException(FilesystemException::class); $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/nonexistent"; yield $this->driver->getSize($path); } public function testSizeFailsOnDirectoryPath(): \Generator { $this->expectException(FilesystemException::class); $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/dir"; $this->assertTrue(yield $this->driver->isDirectory($path)); yield $this->driver->getSize($path); } /** * @dataProvider dataForDirectoryCheck */ public function testIsDirectory(bool $expectedResult, string $name): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/{$name}"; $this->assertSame($expectedResult, yield $this->driver->isDirectory($path)); } public function dataForDirectoryCheck(): \Generator { yield 'file' => [false, 'file']; yield 'filelink' => [false, 'filelink']; yield 'dir' => [true, 'dir']; yield 'dirlink' => [true, 'dirlink']; if (\extension_loaded('posix')) { yield 'fifo' => [false, 'fifo']; yield 'fifolink' => [false, 'fifolink']; } yield 'linkloop' => [false, 'linkloop']; yield 'nonexistent' => [false, 'nonexistent']; } /** * @dataProvider dataForFileCheck */ public function testIsFile(bool $expectedResult, string $name): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/{$name}"; $this->assertSame($expectedResult, yield $this->driver->isFile($path)); } public function dataForFileCheck(): \Generator { yield 'file' => [true, 'file']; yield 'filelink' => [true, 'filelink']; yield 'dir' => [false, 'dir']; yield 'dirlink' => [false, 'dirlink']; if (\extension_loaded('posix')) { yield 'fifo' => [false, 'fifo']; yield 'fifolink' => [false, 'fifolink']; } yield 'linkloop' => [false, 'linkloop']; yield 'nonexistent' => [false, 'nonexistent']; } /** * @dataProvider dataForSymlinkCheck */ public function testIsSymlink(bool $expectedResult, string $name): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/{$name}"; $this->assertSame($expectedResult, yield $this->driver->isSymlink($path)); } public function dataForSymlinkCheck(): \Generator { yield 'file' => [false, 'file']; yield 'filelink' => [true, 'filelink']; yield 'dir' => [false, 'dir']; yield 'dirlink' => [true, 'dirlink']; if (\extension_loaded('posix')) { yield 'fifo' => [false, 'fifo']; yield 'fifolink' => [true, 'fifolink']; } yield 'linkloop' => [true, 'linkloop']; yield 'nonexistent' => [false, 'nonexistent']; } public function testMove(): \Generator { $fixtureDir = Fixture::path(); $contents1 = "rename test"; $old = "{$fixtureDir}/rename1.txt"; $new = "{$fixtureDir}/rename2.txt"; yield $this->driver->write($old, $contents1); $this->assertNull(yield $this->driver->move($old, $new)); $contents2 = yield $this->driver->read($new); yield $this->driver->deleteFile($new); $this->assertSame($contents1, $contents2); } public function testMoveFailsOnNonexistentPath(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/nonexistent"; $this->expectException(FilesystemException::class); yield $this->driver->move($path, $path); } public function testDeleteFile(): \Generator { $fixtureDir = Fixture::path(); $toUnlink = "{$fixtureDir}/unlink"; yield $this->driver->getStatus($toUnlink); yield $this->driver->write($toUnlink, "unlink me"); $this->assertNull(yield $this->driver->deleteFile($toUnlink)); $this->assertNull(yield $this->driver->getStatus($toUnlink)); } public function testDeleteFileFailsOnNonexistentPath(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/nonexistent"; $this->expectException(FilesystemException::class); yield $this->driver->deleteFile($path); } public function testDeleteFileFailsOnDirectory(): \Generator { $fixtureDir = Fixture::path(); $dir = "{$fixtureDir}/newdir"; yield $this->driver->createDirectory($dir); $this->expectException(FilesystemException::class); yield $this->driver->deleteFile($dir); } public function testCreateAndDeleteDirectory(): \Generator { $fixtureDir = Fixture::path(); $dir = "{$fixtureDir}/newdir"; \umask(0022); $this->assertNull(yield $this->driver->createDirectory($dir)); $stat = yield $this->driver->getStatus($dir); $this->assertSame('0755', $this->getPermissionsFromStatus($stat)); $this->assertNull(yield $this->driver->deleteDirectory($dir)); $this->assertNull(yield $this->driver->getStatus($dir)); // test for 0, because previous array_filter made that not work $dir = "{$fixtureDir}/newdir/with/recursive/creation/0/1/2"; $this->assertNull(yield $this->driver->createDirectoryRecursively($dir, 0764)); $stat = yield $this->driver->getStatus($dir); $this->assertSame('0744', $this->getPermissionsFromStatus($stat)); } public function testCreateDirectorySlashEnd(): \Generator { $fixtureDir = Fixture::path(); $dir = "{$fixtureDir}/newdir-with-trailing-slash/"; $this->assertNull(yield $this->driver->createDirectory($dir, 0764)); $this->assertTrue(yield $this->driver->exists($dir)); } public function testCreateDirectoryRecursivelySlashEnd(): \Generator { $fixtureDir = Fixture::path(); $dir = "{$fixtureDir}/newdir/with/recursive/creation/321/"; $this->assertNull(yield $this->driver->createDirectoryRecursively($dir, 0764)); $this->assertTrue(yield $this->driver->exists($dir)); } public function testCreateDirectoryFailsOnNonexistentPath(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/nonexistent/nonexistent"; $this->expectException(FilesystemException::class); yield $this->driver->createDirectory($path); } public function testDeleteDirectoryFailsOnNonexistentPath(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/nonexistent"; $this->expectException(FilesystemException::class); yield $this->driver->deleteDirectory($path); } public function testDeleteDirectoryFailsOnFile(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/file"; $this->expectException(FilesystemException::class); yield $this->driver->deleteDirectory($path); } public function testMtime(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/file"; $stat = yield $this->driver->getStatus($path); $statMtime = $stat["mtime"]; $this->assertSame($statMtime, yield $this->driver->getModificationTime($path)); } public function testMtimeFailsOnNonexistentPath(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/nonexistent"; $this->expectException(FilesystemException::class); yield $this->driver->getModificationTime($path); } public function testAtime(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/file"; $stat = yield $this->driver->getStatus($path); $statAtime = $stat["atime"]; $this->assertSame($statAtime, yield $this->driver->getAccessTime($path)); } public function testAtimeFailsOnNonexistentPath(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/nonexistent"; $this->expectException(FilesystemException::class); yield $this->driver->getAccessTime($path); } public function testCtime(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/file"; $stat = yield $this->driver->getStatus($path); $statCtime = $stat["ctime"]; $this->assertSame($statCtime, yield $this->driver->getCreationTime($path)); } public function testCtimeFailsOnNonexistentPath(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/nonexistent"; $this->expectException(FilesystemException::class); yield $this->driver->getCreationTime($path); } /** * @group slow */ public function testTouch(): \Generator { $fixtureDir = Fixture::path(); $touch = "{$fixtureDir}/touch"; yield $this->driver->write($touch, "touch me"); $oldStat = yield $this->driver->getStatus($touch); $this->assertNull(yield $this->driver->touch($touch, \time() + 10, \time() + 20)); $newStat = yield $this->driver->getStatus($touch); yield $this->driver->deleteFile($touch); $this->assertTrue($newStat["atime"] > $oldStat["atime"]); $this->assertTrue($newStat["mtime"] > $oldStat["mtime"]); } public function testTouchFailsOnNonexistentPath(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/nonexistent/nonexistent"; $this->expectException(FilesystemException::class); yield $this->driver->touch($path); } public function testChangePermissions(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/file"; $stat = yield $this->driver->getStatus($path); $this->assertNotSame('0777', \substr(\decoct($stat['mode']), -4)); $this->assertNull(yield $this->driver->changePermissions($path, 0777)); $stat = yield $this->driver->getStatus($path); $this->assertSame('0777', \substr(\decoct($stat['mode']), -4)); } public function testChangePermissionsFailsOnNonexistentPath(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/nonexistent"; $this->expectException(FilesystemException::class); yield $this->driver->changePermissions($path, 0777); } public function testChangeOwner(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/file"; yield $this->driver->getStatus($path); $user = \fileowner($path); $this->assertNull(yield $this->driver->changeOwner($path, $user, null)); } public function testChangeOwnerFailsOnNonexistentPath(): \Generator { $fixtureDir = Fixture::path(); $path = "{$fixtureDir}/nonexistent"; $this->expectException(FilesystemException::class); yield $this->driver->changeOwner($path, 0, null); } protected function setUp(): void { parent::setUp(); $this->driver = new File\Filesystem($this->createDriver()); } abstract protected function createDriver(): File\Driver; private function assertSameStatus(array $expected, array $actual): void { $filter = function (array $stat) { $filtered = \array_filter( $stat, function (string $key): bool { return !\is_numeric($key); }, ARRAY_FILTER_USE_KEY ); \ksort($filtered); return $filtered; }; $this->assertSame($filter($expected), $filter($actual)); } /** * @param array $stat * * @return string */ private function getPermissionsFromStatus(array $stat): string { return \substr(\decoct($stat["mode"]), 1); } } { "name": "amphp/file", "homepage": "https://github.com/amphp/file", "description": "Allows non-blocking access to the filesystem for Amp.", "support": { "issues": "https://github.com/amphp/file/issues" }, "keywords": [ "file", "disk", "static", "async", "non-blocking", "amp", "amphp", "io", "filesystem" ], "license": "MIT", "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@php.net" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "require": { "php": ">=7.1", "amphp/amp": "^2.5.2", "amphp/byte-stream": "^1.8.1", "amphp/parallel": "^1.4", "amphp/sync": "^1.4" }, "require-dev": { "ext-eio": "^2 || ^3", "ext-uv": "^0.3 || ^0.2", "amphp/phpunit-util": "^1.1", "phpunit/phpunit": "^9 || ^8 || ^7", "amphp/php-cs-fixer-config": "dev-master" }, "autoload": { "psr-4": { "Amp\\File\\": "src" }, "files": ["src/functions.php"] }, "autoload-dev": { "psr-4": { "Amp\\File\\Test\\": "test", "Amp\\Sync\\Test\\": "vendor/amphp/sync/test" } }, "config": { "preferred-install": { "amphp/sync": "source" } }, "extra": { "branch-alias": { "dev-master": "2.x-dev" } }, "scripts": { "check": [ "@code-style", "@test" ], "code-style": "php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" } } driver = $driver; } /** * Open a handle for the specified path. * * @param string $path * @param string $mode * * @return Promise */ public function openFile(string $path, string $mode): Promise { return $this->driver->openFile($path, $mode); } /** * Execute a file stat operation. * * If the requested path does not exist the resulting Promise will resolve to NULL. * * @param string $path File system path. * * @return Promise */ public function getStatus(string $path): Promise { return $this->driver->getStatus($path); } /** * Same as {@see Filesystem::getStatus()} except if the path is a link then the link's data is returned. * * If the requested path does not exist the resulting Promise will resolve to NULL. * * @param string $path File system path. * * @return Promise */ public function getLinkStatus(string $path): Promise { return $this->driver->getLinkStatus($path); } /** * Does the specified path exist? * * This function should never resolve as a failure -- only a successful bool value * indicating the existence of the specified path. * * @param string $path File system path. * * @return Promise */ public function exists(string $path): Promise { return call(function () use ($path) { $result = yield $this->getStatus($path); return $result !== null; }); } /** * Retrieve the size in bytes of the file at the specified path. * * If the path does not exist or is not a regular file this * function's returned Promise WILL resolve as a failure. * * @param string $path File system path. * @fails \Amp\Files\FilesystemException If the path does not exist or is not a file. * * @return Promise */ public function getSize(string $path): Promise { return call(function () use ($path) { $result = yield $this->getStatus($path); if ($result === null) { throw new FilesystemException("Failed to read file size for '{$path}'"); } if ($result['mode'] & 0100000) { return $result["size"]; } throw new FilesystemException("Failed to read file size for '{$path}'; specified path is not a regular file"); }); } /** * Does the specified path exist and is it a directory? * * @param string $path File system path. * * @return Promise */ public function isDirectory(string $path): Promise { return call(function () use ($path) { $result = yield $this->getStatus($path); if ($result === null) { return false; } return (bool) ($result['mode'] & 0040000); }); } /** * Does the specified path exist and is it a file? * * @param string $path File system path. * * @return Promise */ public function isFile(string $path): Promise { return call(function () use ($path) { $result = yield $this->getStatus($path); if ($result === null) { return false; } return (bool) ($result['mode'] & 0100000); }); } /** * Does the specified path exist and is it a symlink? * * If the path does not exist the returned Promise will resolve * to FALSE and will not reject with an error. * * @param string $path File system path. * * @return Promise */ public function isSymlink(string $path): Promise { return call(function () use ($path) { $result = yield $this->getLinkStatus($path); if ($result === null) { return false; } return ($result['mode'] & 0120000) === 0120000; }); } /** * Retrieve the path's last modification time as a unix timestamp. * * @param string $path File system path. * @fails \Amp\Files\FilesystemException If the path does not exist. * * @return Promise */ public function getModificationTime(string $path): Promise { return call(function () use ($path) { $result = yield $this->getStatus($path); if ($result === null) { throw new FilesystemException("Failed to read file modification time for '{$path}'"); } return $result["mtime"]; }); } /** * Retrieve the path's last access time as a unix timestamp. * * @param string $path File system path. * @fails \Amp\Files\FilesystemException If the path does not exist. * * @return Promise */ public function getAccessTime(string $path): Promise { return call(function () use ($path) { $result = yield $this->getStatus($path); if ($result === null) { throw new FilesystemException("Failed to read file access time for '{$path}'"); } return $result["atime"]; }); } /** * Retrieve the path's creation time as a unix timestamp. * * @param string $path File system path. * @fails \Amp\Files\FilesystemException If the path does not exist. * * @return Promise */ public function getCreationTime(string $path): Promise { return call(function () use ($path) { $result = yield $this->getStatus($path); if ($result === null) { throw new FilesystemException("Failed to read file creation time for '{$path}'"); } return $result["ctime"]; }); } /** * Create a symlink $link pointing to the file/directory located at $original. * * @param string $original * @param string $link * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ public function createSymlink(string $original, string $link): Promise { return $this->driver->createSymlink($original, $link); } /** * Create a hard link $link pointing to the file/directory located at $target. * * @param string $target * @param string $link * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ public function createHardlink(string $target, string $link): Promise { return $this->driver->createHardlink($target, $link); } /** * Resolve the symlink at $path. * * @param string $path * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ public function resolveSymlink(string $path): Promise { return $this->driver->resolveSymlink($path); } /** * Move / rename a file or directory. * * @param string $from * @param string $to * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ public function move(string $from, string $to): Promise { return $this->driver->move($from, $to); } /** * Delete a file. * * @param string $path * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ public function deleteFile(string $path): Promise { return $this->driver->deleteFile($path); } /** * Create a directory. * * @param string $path * @param int $mode * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ public function createDirectory(string $path, int $mode = 0777): Promise { return $this->driver->createDirectory($path, $mode); } /** * Create a directory recursively. * * @param string $path * @param int $mode * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ public function createDirectoryRecursively(string $path, int $mode = 0777): Promise { return $this->driver->createDirectoryRecursively($path, $mode); } /** * Delete a directory. * * @param string $path * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ public function deleteDirectory(string $path): Promise { return $this->driver->deleteDirectory($path); } /** * Retrieve an array of files and directories inside the specified path. * * Dot entries are not included in the resulting array (i.e. "." and ".."). * * @param string $path * * @return Promise> */ public function listFiles(string $path): Promise { return $this->driver->listFiles($path); } /** * Change permissions of a file or directory. * * @param string $path * @param int $mode * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ public function changePermissions(string $path, int $mode): Promise { return $this->driver->changePermissions($path, $mode); } /** * Change ownership of a file or directory. * * @param string $path * @param int|null $uid null to ignore * @param int|null $gid null to ignore * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ public function changeOwner(string $path, ?int $uid, ?int $gid = null): Promise { return $this->driver->changeOwner($path, $uid, $gid); } /** * Update the access and modification time of the specified path. * * If the file does not exist it will be created automatically. * * @param string $path * @param int|null $modificationTime The touch time. If $time is not supplied, the current system time is used. * @param int|null $accessTime The access time. If not supplied, the modification time is used. * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ public function touch(string $path, ?int $modificationTime = null, ?int $accessTime = null): Promise { return $this->driver->touch($path, $modificationTime, $accessTime); } /** * Buffer the specified file's contents. * * @param string $path The file path from which to buffer contents. * * @return Promise */ public function read(string $path): Promise { return $this->driver->read($path); } /** * Write the contents string to the specified path. * * @param string $path The file path to which to $contents should be written. * @param string $contents The data to write to the specified $path. * * @return Promise */ public function write(string $path, string $contents): Promise { return $this->driver->write($path, $contents); } } worker = $worker; $this->id = $id; $this->path = $path; $this->size = $size; $this->mode = $mode; $this->position = $this->mode[0] === 'a' ? $this->size : 0; } public function __destruct() { if ($this->id !== null) { $this->close(); } } public function close(): Promise { if ($this->closing) { return $this->closing; } $this->writable = false; if ($this->worker->isRunning()) { $this->closing = $this->worker->enqueue(new Internal\FileTask('fclose', [], $this->id)); $this->id = null; } else { $this->closing = new Success; } return $this->closing; } public function truncate(int $size): Promise { if ($this->id === null) { return new Failure(new ClosedException("The file has been closed")); } if ($this->busy) { throw new PendingOperationError; } if (!$this->writable) { return new Failure(new ClosedException("The file is no longer writable")); } return call(function () use ($size) { ++$this->pendingWrites; $this->busy = true; try { yield $this->worker->enqueue(new Internal\FileTask('ftruncate', [$size], $this->id)); } catch (TaskException $exception) { throw new StreamException("Reading from the file failed", 0, $exception); } catch (WorkerException $exception) { throw new StreamException("Sending the task to the worker failed", 0, $exception); } finally { if (--$this->pendingWrites === 0) { $this->busy = false; } } }); } public function eof(): bool { return $this->pendingWrites === 0 && $this->size <= $this->position; } public function read(int $length = self::DEFAULT_READ_LENGTH): Promise { if ($this->id === null) { return new Failure(new ClosedException("The file has been closed")); } if ($this->busy) { throw new PendingOperationError; } return call(function () use ($length) { $this->busy = true; try { $data = yield $this->worker->enqueue(new Internal\FileTask('fread', [$length], $this->id)); if ($data !== null) { $this->position += \strlen($data); } } catch (TaskException $exception) { throw new StreamException("Reading from the file failed", 0, $exception); } catch (WorkerException $exception) { throw new StreamException("Sending the task to the worker failed", 0, $exception); } finally { $this->busy = false; } return $data; }); } public function write(string $data): Promise { if ($this->id === null) { return new Failure(new ClosedException("The file has been closed")); } if ($this->busy && $this->pendingWrites === 0) { throw new PendingOperationError; } if (!$this->writable) { return new Failure(new ClosedException("The file is no longer writable")); } return call(function () use ($data) { ++$this->pendingWrites; $this->busy = true; try { $wrote = yield $this->worker->enqueue(new Internal\FileTask('fwrite', [$data], $this->id)); $this->position += $wrote; } catch (TaskException $exception) { throw new StreamException("Writing to the file failed", 0, $exception); } catch (WorkerException $exception) { throw new StreamException("Sending the task to the worker failed", 0, $exception); } finally { if (--$this->pendingWrites === 0) { $this->busy = false; } } return $wrote; }); } public function end(string $data = ""): Promise { return call(function () use ($data) { $promise = $this->write($data); $this->writable = false; // ignore any errors yield Promise\any([$this->close()]); return $promise; }); } public function seek(int $offset, int $whence = SEEK_SET): Promise { if ($this->id === null) { return new Failure(new ClosedException("The file has been closed")); } if ($this->busy) { throw new PendingOperationError; } return call(function () use ($offset, $whence) { switch ($whence) { case self::SEEK_SET: case self::SEEK_CUR: case self::SEEK_END: try { $this->position = yield $this->worker->enqueue( new Internal\FileTask('fseek', [$offset, $whence], $this->id) ); if ($this->position > $this->size) { $this->size = $this->position; } return $this->position; } catch (TaskException $exception) { throw new StreamException('Seeking in the file failed.', 0, $exception); } catch (WorkerException $exception) { throw new StreamException("Sending the task to the worker failed", 0, $exception); } default: throw new \Error('Invalid whence value. Use SEEK_SET, SEEK_CUR, or SEEK_END.'); } }); } public function tell(): int { return $this->position; } public function getPath(): string { return $this->path; } public function getMode(): string { return $this->mode; } } file = $file; $this->invalidateCallback = $invalidateCallback; } public function read(int $length = self::DEFAULT_READ_LENGTH): Promise { return $this->file->read($length); } public function write(string $data): Promise { return $this->invalidate($this->file->write($data)); } public function end(string $data = ""): Promise { return $this->invalidate($this->file->end($data)); } public function close(): Promise { return $this->file->close(); } public function seek(int $position, int $whence = self::SEEK_SET): Promise { return $this->file->seek($position, $whence); } public function tell(): int { return $this->file->tell(); } public function eof(): bool { return $this->file->eof(); } public function getPath(): string { return $this->file->getPath(); } public function getMode(): string { return $this->file->getMode(); } public function truncate(int $size): Promise { return $this->invalidate($this->file->truncate($size)); } private function invalidate(Promise $promise): Promise { $promise->onResolve(function () { ($this->invalidateCallback)(); }); return $promise; } } driver = $driver; $this->loop = $driver->getHandle(); $this->poll = new Internal\UvPoll($driver); $this->priorVersion = \version_compare(\phpversion('uv'), '0.3.0', '<'); } public function openFile(string $path, string $mode): Promise { $flags = $this->parseMode($mode); $chmod = ($flags & \UV::O_CREAT) ? 0644 : 0; $deferred = new Deferred; $this->poll->listen($deferred->promise()); $openArr = [$mode, $path, $deferred]; \uv_fs_open($this->loop, $path, $flags, $chmod, function ($fh) use ($openArr): void { if (\is_resource($fh)) { $this->onOpenHandle($fh, $openArr); } else { [, $path, $deferred] = $openArr; $deferred->fail(new FilesystemException("Failed opening file '{$path}'")); } }); return $deferred->promise(); } public function getStatus(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $callback = static function ($stat) use ($deferred, $path): void { if (\is_int($stat)) { $deferred->resolve(null); return; } // link is not a valid stat type but returned by the uv extension // change link to nlink if (isset($stat['link'])) { $stat['nlink'] = $stat['link']; unset($stat['link']); } $deferred->resolve($stat); }; if ($this->priorVersion) { $callback = static function ($fh, $stat) use ($callback): void { if (empty($fh)) { $stat = 0; } $callback($stat); }; } \uv_fs_stat($this->loop, $path, $callback); return $deferred->promise(); } public function getLinkStatus(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); if ($this->priorVersion) { $callback = static function ($fh, $stat) use ($deferred): void { $deferred->resolve(empty($fh) ? null : $stat); }; } else { $callback = static function ($stat) use ($deferred): void { $deferred->resolve(\is_int($stat) ? null : $stat); }; } \uv_fs_lstat($this->loop, $path, $callback); return $deferred->promise(); } public function createSymlink(string $target, string $link): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $callback = $this->createGenericCallback($deferred, "Could not create symbolic link"); \uv_fs_symlink($this->loop, $target, $link, \UV::S_IRWXU | \UV::S_IRUSR, $callback); return $deferred->promise(); } public function createHardlink(string $target, string $link): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); \uv_fs_link($this->loop, $target, $link, $this->createGenericCallback($deferred, "Could not create hard link")); return $deferred->promise(); } public function resolveSymlink(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); if ($this->priorVersion) { $callback = static function ($fh, $target) use ($deferred): void { if (!(bool) $fh) { $deferred->fail(new FilesystemException("Could not read symbolic link")); return; } $deferred->resolve($target); }; } else { $callback = static function ($target) use ($deferred): void { if (\is_int($target)) { $deferred->fail(new FilesystemException("Could not read symbolic link")); return; } $deferred->resolve($target); }; } \uv_fs_readlink($this->loop, $path, $callback); return $deferred->promise(); } public function move(string $from, string $to): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); \uv_fs_rename($this->loop, $from, $to, $this->createGenericCallback($deferred, "Could not rename file")); return $deferred->promise(); } public function deleteFile(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); \uv_fs_unlink($this->loop, $path, $this->createGenericCallback($deferred, "Could not unlink file")); return $deferred->promise(); } public function createDirectory(string $path, int $mode = 0777): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); \uv_fs_mkdir($this->loop, $path, $mode, $this->createGenericCallback($deferred, "Could not create directory")); return $deferred->promise(); } public function createDirectoryRecursively(string $path, int $mode = 0777): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $path = \str_replace("/", DIRECTORY_SEPARATOR, $path); $path = \rtrim($path, DIRECTORY_SEPARATOR); $arrayPath = \explode(DIRECTORY_SEPARATOR, $path); $tmpPath = ""; $callback = function () use ( &$callback, &$arrayPath, &$tmpPath, $mode, $deferred ) { $tmpPath .= DIRECTORY_SEPARATOR . \array_shift($arrayPath); if (empty($arrayPath)) { \uv_fs_mkdir( $this->loop, $tmpPath, $mode, $this->createGenericCallback($deferred, "Could not create directory") ); } else { $this->isDir($tmpPath)->onResolve(function ($error, $result) use ( $callback, $tmpPath, $mode ): void { if ($result) { $callback(); } else { \uv_fs_mkdir($this->loop, $tmpPath, $mode, $callback); } }); } }; $callback(); return $deferred->promise(); } public function deleteDirectory(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); \uv_fs_rmdir($this->loop, $path, $this->createGenericCallback($deferred, "Could not remove directory")); return $deferred->promise(); } public function listFiles(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); if ($this->priorVersion) { \uv_fs_readdir($this->loop, $path, 0, static function ($fh, $data) use ($deferred, $path): void { if (empty($fh) && $data !== 0) { $deferred->fail(new FilesystemException("Failed reading contents from {$path}")); } elseif ($data === 0) { $deferred->resolve([]); } else { $deferred->resolve($data); } }); } else { /** @noinspection PhpUndefinedFunctionInspection */ \uv_fs_scandir($this->loop, $path, static function ($data) use ($deferred, $path): void { if (\is_int($data) && $data !== 0) { $deferred->fail(new FilesystemException("Failed reading contents from {$path}")); } elseif ($data === 0) { $deferred->resolve([]); } else { $deferred->resolve($data); } }); } return $deferred->promise(); } public function changePermissions(string $path, int $mode): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $callback = $this->createGenericCallback($deferred, "Could not change file permissions"); \uv_fs_chmod($this->loop, $path, $mode, $callback); return $deferred->promise(); } public function changeOwner(string $path, ?int $uid, ?int $gid): Promise { // @TODO Return a failure in windows environments $deferred = new Deferred; $this->poll->listen($deferred->promise()); $callback = $this->createGenericCallback($deferred, "Could not change file owner"); \uv_fs_chown($this->loop, $path, $uid ?? -1, $gid ?? -1, $callback); return $deferred->promise(); } public function touch(string $path, ?int $modificationTime, ?int $accessTime): Promise { $modificationTime = $modificationTime ?? \time(); $accessTime = $accessTime ?? $modificationTime; $deferred = new Deferred; $this->poll->listen($deferred->promise()); $callback = $this->createGenericCallback($deferred, "Could not touch file"); \uv_fs_utime($this->loop, $path, $modificationTime, $accessTime, $callback); return $deferred->promise(); } public function read(string $path): Promise { $promise = new Coroutine($this->doRead($path)); $this->poll->listen($promise); return $promise; } public function write(string $path, string $contents): Promise { $promise = new Coroutine($this->doWrite($path, $contents)); $this->poll->listen($promise); return $promise; } private function parseMode(string $mode): int { $mode = \str_replace(['b', 't', 'e'], '', $mode); switch ($mode) { case "r": return \UV::O_RDONLY; case "r+": return \UV::O_RDWR; case "c": case "w": return \UV::O_WRONLY | \UV::O_CREAT; case "c+": case "w+": return \UV::O_RDWR | \UV::O_CREAT; case "a": return \UV::O_WRONLY | \UV::O_CREAT | \UV::O_APPEND; case "a+": return \UV::O_RDWR | \UV::O_CREAT | \UV::O_APPEND; case "x": return \UV::O_WRONLY | \UV::O_CREAT | \UV::O_EXCL; case "x+": return \UV::O_RDWR | \UV::O_CREAT | \UV::O_EXCL; default: throw new \Error('Invalid file mode'); } } private function onOpenHandle($fh, array $openArr): void { [$mode] = $openArr; if ($mode[0] === "w") { \uv_fs_ftruncate($this->loop, $fh, $length = 0, function ($fh) use ($openArr): void { if (\is_resource($fh)) { $this->finalizeHandle($fh, $size = 0, $openArr); } else { [, $path, $deferred] = $openArr; $deferred->fail(new FilesystemException( "Failed truncating file $path" )); } }); } else { \uv_fs_fstat($this->loop, $fh, function ($fh, $stat) use ($openArr): void { if (\is_resource($fh)) { $this->finalizeHandle($fh, $stat["size"], $openArr); } else { [, $path, $deferred] = $openArr; $deferred->fail(new FilesystemException( "Failed reading file size from open handle pointing to $path" )); } }); } } private function finalizeHandle($fh, $size, array $openArr): void { [$mode, $path, $deferred] = $openArr; $handle = new UvFile($this->driver, $this->poll, $fh, $path, $mode, $size); $deferred->resolve($handle); } private function isDir(string $path): Promise { $deferred = new Deferred; $this->getStatus($path)->onResolve(static function ($error, $result) use ($deferred): void { if ($result) { $deferred->resolve(($result["mode"] & \UV::S_IFDIR) === \UV::S_IFDIR); } else { $deferred->resolve(false); } }); return $deferred->promise(); } private function doRead($path): \Generator { $promise = $this->doFsOpen($path, $flags = \UV::O_RDONLY, $mode = 0); if (!$fh = yield $promise) { throw new FilesystemException("Failed opening file handle: {$path}"); } $deferred = new Deferred; $stat = yield $this->doFsStat($fh); if (empty($stat)) { $deferred->fail(new FilesystemException("stat operation failed on open file handle")); } elseif (!$stat["isfile"]) { \uv_fs_close($this->loop, $fh, static function () use ($deferred): void { $deferred->fail(new FilesystemException("cannot buffer contents: path is not a file")); }); } else { $buffer = yield $this->doFsRead($fh, $offset = 0, $stat["size"]); if ($buffer === false) { \uv_fs_close($this->loop, $fh, static function () use ($deferred): void { $deferred->fail(new FilesystemException("read operation failed on open file handle")); }); } else { \uv_fs_close($this->loop, $fh, static function () use ($deferred, $buffer): void { $deferred->resolve($buffer); }); } } return yield $deferred->promise(); } private function doFsOpen(string $path, int $flags, int $mode): Promise { $deferred = new Deferred; \uv_fs_open($this->loop, $path, $flags, $mode, static function ($fh) use ($deferred) { $deferred->resolve($fh); }); return $deferred->promise(); } private function doFsStat($fh): Promise { $deferred = new Deferred; \uv_fs_fstat($this->loop, $fh, static function ($fh, $stat) use ($deferred): void { if (\is_resource($fh)) { $stat["isdir"] = (bool) ($stat["mode"] & \UV::S_IFDIR); $stat["isfile"] = !$stat["isdir"]; $deferred->resolve($stat); } else { $deferred->resolve(); } }); return $deferred->promise(); } private function doFsRead($fh, int $offset, int $len): Promise { $deferred = new Deferred; if ($this->priorVersion) { $callback = static function ($fh, $readBytes, $buffer) use ($deferred): void { $deferred->resolve($readBytes < 0 ? false : $buffer); }; } else { $callback = static function ($readBytes, $buffer) use ($deferred): void { $deferred->resolve($readBytes < 0 ? false : $buffer); }; } \uv_fs_read($this->loop, $fh, $offset, $len, $callback); return $deferred->promise(); } private function doWrite(string $path, string $contents): \Generator { $flags = \UV::O_WRONLY | \UV::O_CREAT; $mode = \UV::S_IRWXU | \UV::S_IRUSR; $promise = $this->doFsOpen($path, $flags, $mode); if (!$fh = yield $promise) { throw new FilesystemException("Failed opening write file handle"); } $deferred = new Deferred; \uv_fs_write($this->loop, $fh, $contents, $offset = 0, function ($fh, $result) use ($deferred): void { \uv_fs_close($this->loop, $fh, static function () use ($deferred, $result): void { if ($result < 0) { $deferred->fail(new FilesystemException(\uv_strerror($result))); } else { $deferred->resolve(); } }); }); return yield $deferred->promise(); } private function createGenericCallback(Deferred $deferred, string $error): Closure { $callback = static function (int $result) use ($deferred, $error): void { if ($result !== 0) { $deferred->fail(new FilesystemException($error)); return; } $deferred->resolve(); }; if ($this->priorVersion) { $callback = static function (bool $result) use ($callback): void { $callback($result ? 0 : -1); }; } return $callback; } } poll = $poll; $this->fh = $fh; $this->path = $path; $this->mode = $mode; $this->size = $size; $this->loop = $driver->getHandle(); $this->position = ($mode[0] === "a") ? $size : 0; $this->queue = new \SplQueue; $this->priorVersion = \version_compare(\phpversion('uv'), '0.3.0', '<'); } public function read(int $length = self::DEFAULT_READ_LENGTH): Promise { if ($this->isActive) { throw new PendingOperationError; } $deferred = new Deferred; $this->poll->listen($deferred->promise()); $this->isActive = true; $onRead = function ($result, $buffer) use ($deferred): void { $this->isActive = false; if (\is_int($buffer)) { $error = \uv_strerror($buffer); if ($error === "bad file descriptor") { $deferred->fail(new ClosedException("Reading from the file failed due to a closed handle")); } else { $deferred->fail(new StreamException("Reading from the file failed: " . $error)); } return; } $length = \strlen($buffer); $this->position += $length; $deferred->resolve($length ? $buffer : null); }; if ($this->priorVersion) { $onRead = static function ($fh, $result, $buffer) use ($onRead): void { if ($result < 0) { $buffer = $result; // php-uv v0.3.0 changed the callback to put an int in $buffer on error. } $onRead($result, $buffer); }; } \uv_fs_read($this->loop, $this->fh, $this->position, $length, $onRead); return $deferred->promise(); } public function write(string $data): Promise { if ($this->isActive && $this->queue->isEmpty()) { throw new PendingOperationError; } if (!$this->writable) { return new Failure(new ClosedException("The file is no longer writable")); } $this->isActive = true; if ($this->queue->isEmpty()) { $promise = $this->push($data); } else { $promise = $this->queue->top(); $promise = call(function () use ($promise, $data) { yield $promise; return yield $this->push($data); }); } $this->queue->push($promise); return $promise; } public function end(string $data = ""): Promise { return call(function () use ($data) { $promise = $this->write($data); $this->writable = false; // ignore any errors yield Promise\any([$this->close()]); return $promise; }); } public function truncate(int $size): Promise { if ($this->isActive && $this->queue->isEmpty()) { throw new PendingOperationError; } if (!$this->writable) { return new Failure(new ClosedException("The file is no longer writable")); } $this->isActive = true; if ($this->queue->isEmpty()) { $promise = $this->trim($size); } else { $promise = $this->queue->top(); $promise = call(function () use ($promise, $size) { yield $promise; return yield $this->trim($size); }); } $this->queue->push($promise); return $promise; } public function seek(int $offset, int $whence = \SEEK_SET): Promise { if ($this->isActive) { throw new PendingOperationError; } $offset = (int) $offset; switch ($whence) { case self::SEEK_SET: $this->position = $offset; break; case self::SEEK_CUR: $this->position += $offset; break; case self::SEEK_END: $this->position = $this->size + $offset; break; default: throw new \Error("Invalid whence parameter; SEEK_SET, SEEK_CUR or SEEK_END expected"); } return new Success($this->position); } public function tell(): int { return $this->position; } public function eof(): bool { return !$this->queue->isEmpty() ? false : ($this->size <= $this->position); } public function getPath(): string { return $this->path; } public function getMode(): string { return $this->mode; } public function close(): Promise { if ($this->closing) { return $this->closing; } $deferred = new Deferred; $this->poll->listen($this->closing = $deferred->promise()); \uv_fs_close($this->loop, $this->fh, static function () use ($deferred): void { // Ignore errors when closing file, as the handle will become invalid anyway. $deferred->resolve(); }); return $deferred->promise(); } private function push(string $data): Promise { $length = \strlen($data); if ($length === 0) { return new Success(0); } $deferred = new Deferred; $this->poll->listen($deferred->promise()); $onWrite = function ($fh, $result) use ($deferred, $length): void { if ($this->queue->isEmpty()) { $deferred->fail(new ClosedException('No pending write, the file may have been closed')); } $this->queue->shift(); if ($this->queue->isEmpty()) { $this->isActive = false; } if ($result < 0) { $error = \uv_strerror($result); if ($error === "bad file descriptor") { $deferred->fail(new ClosedException("Writing to the file failed due to a closed handle")); } else { $deferred->fail(new StreamException("Writing to the file failed: " . $error)); } } else { $this->position += $length; if ($this->position > $this->size) { $this->size = $this->position; } $deferred->resolve($length); } }; \uv_fs_write($this->loop, $this->fh, $data, $this->position, $onWrite); return $deferred->promise(); } private function trim(int $size): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $onTruncate = function ($fh) use ($deferred, $size): void { if ($this->queue->isEmpty()) { $deferred->fail(new ClosedException('No pending write, the file may have been closed')); } $this->queue->shift(); if ($this->queue->isEmpty()) { $this->isActive = false; } $this->size = $size; $deferred->resolve(); }; \uv_fs_ftruncate( $this->loop, $this->fh, $size, $onTruncate ); return $deferred->promise(); } } poll = $poll; $this->fh = $fh; $this->path = $path; $this->mode = $mode; $this->size = $size; $this->position = ($mode[0] === "a") ? $size : 0; $this->queue = new \SplQueue; } public function read(int $length = self::DEFAULT_READ_LENGTH): Promise { if ($this->isActive) { throw new PendingOperationError; } $this->isActive = true; $remaining = $this->size - $this->position; $length = $length > $remaining ? $remaining : $length; $deferred = new Deferred; $this->poll->listen($deferred->promise()); $onRead = function (Deferred $deferred, $result, $req): void { $this->isActive = false; if ($result === -1) { $error = \eio_get_last_error($req); if ($error === "Bad file descriptor") { $deferred->fail(new ClosedException("Reading from the file failed due to a closed handle")); } else { $deferred->fail(new StreamException("Reading from the file failed:" . $error)); } } else { $this->position += \strlen($result); $deferred->resolve(\strlen($result) ? $result : null); } }; \eio_read( $this->fh, $length, $this->position, \EIO_PRI_DEFAULT, $onRead, $deferred ); return $deferred->promise(); } public function write(string $data): Promise { if ($this->isActive && $this->queue->isEmpty()) { throw new PendingOperationError; } if (!$this->writable) { throw new ClosedException("The file is no longer writable"); } $this->isActive = true; if ($this->queue->isEmpty()) { $promise = $this->push($data); } else { $promise = $this->queue->top(); $promise = call(function () use ($promise, $data) { yield $promise; return yield $this->push($data); }); } $this->queue->push($promise); return $promise; } public function end(string $data = ""): Promise { return call(function () use ($data) { $promise = $this->write($data); $this->writable = false; // ignore any errors yield Promise\any([$this->close()]); return $promise; }); } public function close(): Promise { if ($this->closing) { return $this->closing; } $deferred = new Deferred; $this->poll->listen($this->closing = $deferred->promise()); \eio_close($this->fh, \EIO_PRI_DEFAULT, static function (Deferred $deferred): void { // Ignore errors when closing file, as the handle will become invalid anyway. $deferred->resolve(); }, $deferred); return $deferred->promise(); } public function truncate(int $size): Promise { if ($this->isActive && $this->queue->isEmpty()) { throw new PendingOperationError; } if (!$this->writable) { return new Failure(new ClosedException("The file is no longer writable")); } $this->isActive = true; if ($this->queue->isEmpty()) { $promise = $this->trim($size); } else { $promise = $this->queue->top(); $promise = call(function () use ($promise, $size) { yield $promise; return yield $this->trim($size); }); } $this->queue->push($promise); return $promise; } public function seek(int $offset, int $whence = \SEEK_SET): Promise { if ($this->isActive) { throw new PendingOperationError; } switch ($whence) { case self::SEEK_SET: $this->position = $offset; break; case self::SEEK_CUR: $this->position += $offset; break; case self::SEEK_END: $this->position = $this->size + $offset; break; default: throw new \Error("Invalid whence parameter; SEEK_SET, SEEK_CUR or SEEK_END expected"); } return new Success($this->position); } public function tell(): int { return $this->position; } public function eof(): bool { return !$this->queue->isEmpty() ? false : ($this->size <= $this->position); } public function getPath(): string { return $this->path; } public function getMode(): string { return $this->mode; } private function push(string $data): Promise { $length = \strlen($data); if ($length === 0) { return new Success(0); } $deferred = new Deferred; $this->poll->listen($deferred->promise()); $onWrite = function (Deferred $deferred, $result, $req): void { if ($this->queue->isEmpty()) { $deferred->fail(new ClosedException('No pending write, the file may have been closed')); } $this->queue->shift(); if ($this->queue->isEmpty()) { $this->isActive = false; } if ($result === -1) { $error = \eio_get_last_error($req); if ($error === "Bad file descriptor") { $deferred->fail(new ClosedException("Writing to the file failed due to a closed handle")); } else { $deferred->fail(new StreamException("Writing to the file failed: " . $error)); } } else { $this->position += $result; if ($this->position > $this->size) { $this->size = $this->position; } $deferred->resolve($result); } }; \eio_write( $this->fh, $data, $length, $this->position, \EIO_PRI_DEFAULT, $onWrite, $deferred ); return $deferred->promise(); } private function trim(int $size): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $onTruncate = function (Deferred $deferred, $result, $req) use ($size): void { if ($this->queue->isEmpty()) { $deferred->fail(new ClosedException('No pending write, the file may have been closed')); } $this->queue->shift(); if ($this->queue->isEmpty()) { $this->isActive = false; } if ($result === -1) { $error = \eio_get_last_error($req); if ($error === "Bad file descriptor") { $deferred->fail(new ClosedException("Truncating the file failed due to a closed handle")); } else { $deferred->fail(new StreamException("Truncating the file failed: " . $error)); } } else { $this->size = $size; $deferred->resolve(); } }; \eio_ftruncate( $this->fh, $size, \EIO_PRI_DEFAULT, $onTruncate, $deferred ); return $deferred->promise(); } } poll = new Internal\EioPoll($driver); } public function openFile(string $path, string $mode): Promise { $flags = \EIO_O_NONBLOCK | $this->parseMode($mode); if (\defined('\EIO_O_FSYNC')) { $flags |= \EIO_O_FSYNC; } $chmod = ($flags & \EIO_O_CREAT) ? 0644 : 0; $deferred = new Deferred; $this->poll->listen($deferred->promise()); $openArr = [$mode, $path, $deferred]; \eio_open($path, $flags, $chmod, \EIO_PRI_DEFAULT, [$this, "onOpenHandle"], $openArr); return $deferred->promise(); } public function getStatus(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; $data = [$deferred, $path]; \eio_stat($path, $priority, [$this, "onStat"], $data); return $deferred->promise(); } public function getLinkStatus(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; \eio_lstat($path, $priority, [$this, "onLstat"], $deferred); return $deferred->promise(); } public function createSymlink(string $target, string $link): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; \eio_symlink($target, $link, $priority, [$this, "onGenericResult"], $deferred); return $deferred->promise(); } public function createHardlink(string $target, string $link): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; \eio_link($target, $link, $priority, [$this, "onGenericResult"], $deferred); return $deferred->promise(); } public function resolveSymlink(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; \eio_readlink($path, $priority, [$this, "onReadlink"], $deferred); return $deferred->promise(); } public function move(string $from, string $to): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; \eio_rename($from, $to, $priority, [$this, "onGenericResult"], $deferred); return $deferred->promise(); } public function deleteFile(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; $data = [$deferred, $path]; $result = \eio_unlink($path, $priority, [$this, "onUnlink"], $data); // For a non-existent file eio_unlink immediately returns true and the callback is never called. if ($result === true) { $deferred->fail(new FilesystemException('File does not exist.')); } return $deferred->promise(); } public function createDirectory(string $path, int $mode = 0777): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); \eio_mkdir($path, $mode, \EIO_PRI_DEFAULT, [$this, "onGenericResult"], $deferred); return $deferred->promise(); } public function createDirectoryRecursively(string $path, int $mode = 0777): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; $path = \str_replace("/", DIRECTORY_SEPARATOR, $path); $path = \rtrim($path, DIRECTORY_SEPARATOR); $arrayPath = \explode(DIRECTORY_SEPARATOR, $path); $tmpPath = ""; $callback = function () use ( &$callback, &$arrayPath, &$tmpPath, $mode, $priority, $deferred ): void { $tmpPath .= DIRECTORY_SEPARATOR . \array_shift($arrayPath); if (empty($arrayPath)) { \eio_mkdir($tmpPath, $mode, $priority, [$this, "onGenericResult"], $deferred); } else { $this->isdir($tmpPath)->onResolve(function ($error, $result) use ( $callback, $tmpPath, $mode, $priority ) { if ($result) { $callback(); } else { \eio_mkdir($tmpPath, $mode, $priority, $callback); } }); } }; $callback(); return $deferred->promise(); } public function deleteDirectory(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; $data = [$deferred, $path]; \eio_rmdir($path, $priority, [$this, "onRmdir"], $data); return $deferred->promise(); } public function listFiles(string $path): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $flags = \EIO_READDIR_STAT_ORDER | \EIO_READDIR_DIRS_FIRST; $priority = \EIO_PRI_DEFAULT; \eio_readdir($path, $flags, $priority, [$this, "onScandir"], $deferred); return $deferred->promise(); } public function changePermissions(string $path, int $mode): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; \eio_chmod($path, $mode, $priority, [$this, "onGenericResult"], $deferred); return $deferred->promise(); } public function changeOwner(string $path, ?int $uid, ?int $gid): Promise { $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; \eio_chown($path, $uid ?? -1, $gid ?? -1, $priority, [$this, "onGenericResult"], $deferred); return $deferred->promise(); } public function touch(string $path, ?int $modificationTime, ?int $accessTime): Promise { $modificationTime = $modificationTime ?? \time(); $accessTime = $accessTime ?? $modificationTime; $deferred = new Deferred; $this->poll->listen($deferred->promise()); $priority = \EIO_PRI_DEFAULT; \eio_utime($path, $accessTime, $modificationTime, $priority, [$this, "onGenericResult"], $deferred); return $deferred->promise(); } public function read(string $path): Promise { $flags = \EIO_O_RDONLY; $mode = 0; $priority = \EIO_PRI_DEFAULT; $deferred = new Deferred; $this->poll->listen($deferred->promise()); \eio_open($path, $flags, $mode, $priority, [$this, "onGetOpen"], $deferred); return $deferred->promise(); } public function write(string $path, string $contents): Promise { $flags = \EIO_O_RDWR | \EIO_O_CREAT; $mode = \EIO_S_IRUSR | \EIO_S_IWUSR | \EIO_S_IXUSR; $priority = \EIO_PRI_DEFAULT; $deferred = new Deferred; $this->poll->listen($deferred->promise()); $data = [$contents, $deferred]; \eio_open($path, $flags, $mode, $priority, [$this, "onPutOpen"], $data); return $deferred->promise(); } private function parseMode(string $mode): int { $mode = \str_replace(['b', 't', 'e'], '', $mode); switch ($mode) { case 'r': return \EIO_O_RDONLY; case 'r+': return \EIO_O_RDWR; case 'w': return \EIO_O_WRONLY | \EIO_O_TRUNC | \EIO_O_CREAT; case 'w+': return \EIO_O_RDWR | \EIO_O_TRUNC | \EIO_O_CREAT; case 'a': return \EIO_O_WRONLY | \EIO_O_APPEND | \EIO_O_CREAT; case 'a+': return \EIO_O_RDWR | \EIO_O_APPEND | \EIO_O_CREAT; case 'x': return \EIO_O_WRONLY | \EIO_O_CREAT | \EIO_O_EXCL; case 'x+': return \EIO_O_RDWR | \EIO_O_CREAT | \EIO_O_EXCL; case 'c': return \EIO_O_WRONLY | \EIO_O_CREAT; case 'c+': return \EIO_O_RDWR | \EIO_O_CREAT; default: throw new \Error('Invalid file mode: ' . $mode); } } private function onOpenHandle(array $openArr, $result, $req): void { [$mode, $path, $deferred] = $openArr; if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } elseif ($mode[0] === "a") { \array_unshift($openArr, $result); \eio_ftruncate($result, $offset = 0, \EIO_PRI_DEFAULT, [$this, "onOpenFtruncate"], $openArr); } else { \array_unshift($openArr, $result); \eio_fstat($result, \EIO_PRI_DEFAULT, [$this, "onOpenFstat"], $openArr); } } private function onOpenFtruncate(array $openArr, $result, $req): void { [$fh, $mode, $path, $deferred] = $openArr; if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } else { $handle = new EioFile($this->poll, $fh, $path, $mode, $size = 0); $deferred->resolve($handle); } } private function onOpenFstat(array $openArr, $result, $req): void { [$fh, $mode, $path, $deferred] = $openArr; if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } else { $handle = new EioFile($this->poll, $fh, $path, $mode, $result["size"]); $deferred->resolve($handle); } } private function onStat(array $data, $result, $req): void { [$deferred, $path] = $data; if ($result === -1) { $deferred->resolve(null); } else { $deferred->resolve($result); } } private function onLstat(Deferred $deferred, $result, $req): void { if ($result === -1) { $deferred->resolve(null); } else { $deferred->resolve($result); } } private function onReadlink(Deferred $deferred, $result, $req): void { if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } else { $deferred->resolve($result); } } private function onGenericResult(Deferred $deferred, $result, $req): void { if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } else { $deferred->resolve(); } } private function onUnlink(array $data, $result, $req): void { [$deferred, $path] = $data; if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } else { $deferred->resolve(); } } private function isDir(string $path): Promise { $deferred = new Deferred; $this->getStatus($path)->onResolve(static function ($error, $result) use ($deferred): void { if ($result) { $deferred->resolve(($result["mode"] & 0040000) === 0040000); } else { $deferred->resolve(false); } }); return $deferred->promise(); } private function onRmdir(array $data, $result, $req): void { [$deferred, $path] = $data; if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } else { $deferred->resolve(); } } private function onScandir(Deferred $deferred, $result, $req): void { if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } else { $result = $result["names"]; \sort($result); $deferred->resolve($result); } } private function onGetOpen(Deferred $deferred, $result, $req): void { if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } else { $priority = \EIO_PRI_DEFAULT; \eio_fstat($result, $priority, [$this, "onGetFstat"], [$result, $deferred]); } } private function onGetFstat(array $fhAndPromisor, $result, $req): void { [$fh, $deferred] = $fhAndPromisor; if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); return; } $offset = 0; $length = $result["size"]; $priority = \EIO_PRI_DEFAULT; \eio_read($fh, $length, $offset, $priority, [$this, "onGetRead"], $fhAndPromisor); } private function onGetRead(array $fhAndPromisor, $result, $req): void { [$fh, $deferred] = $fhAndPromisor; \eio_close($fh); if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } else { $deferred->resolve($result); } } private function onPutOpen(array $data, $result, $req): void { [$contents, $deferred] = $data; if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } else { $length = \strlen($contents); $offset = 0; $priority = \EIO_PRI_DEFAULT; $callback = [$this, "onPutWrite"]; $fhAndPromisor = [$result, $deferred]; \eio_write($result, $contents, $length, $offset, $priority, $callback, $fhAndPromisor); } } private function onPutWrite(array $fhAndPromisor, $result, $req): void { [$fh, $deferred] = $fhAndPromisor; \eio_close($fh); if ($result === -1) { $deferred->fail(new FilesystemException(\eio_get_last_error($req))); } else { $deferred->resolve(); } } } handle = $handle; $this->path = $path; $this->mode = $mode; } public function __destruct() { if ($this->handle !== null) { @\fclose($this->handle); } } public function read(int $length = self::DEFAULT_READ_LENGTH): Promise { if ($this->handle === null) { return new Failure(new ClosedException("The file '{$this->path}' has been closed")); } try { \set_error_handler(function ($type, $message) { throw new StreamException("Failed reading from file '{$this->path}': {$message}"); }); $data = \fread($this->handle, $length); if ($data === false) { throw new StreamException("Failed reading from file '{$this->path}'"); } return new Success($data !== '' ? $data : null); } catch (StreamException $e) { return new Failure($e); } finally { \restore_error_handler(); } } public function write(string $data): Promise { if ($this->handle === null) { return new Failure(new ClosedException("The file '{$this->path}' has been closed")); } try { \set_error_handler(function ($type, $message) { throw new StreamException("Failed writing to file '{$this->path}': {$message}"); }); $length = \fwrite($this->handle, $data); if ($length === false) { throw new StreamException("Failed writing to file '{$this->path}'"); } return new Success($length); } catch (StreamException $e) { return new Failure($e); } finally { \restore_error_handler(); } } public function end(string $data = ""): Promise { return call(function () use ($data) { $promise = $this->write($data); // ignore any errors yield Promise\any([$this->close()]); return $promise; }); } public function close(): Promise { if ($this->handle === null) { return new Success; } $handle = $this->handle; $this->handle = null; try { \set_error_handler(function ($type, $message) { throw new StreamException("Failed closing file '{$this->path}': {$message}"); }); if (\fclose($handle)) { return new Success; } throw new StreamException("Failed closing file '{$this->path}'"); } catch (StreamException $e) { return new Failure($e); } finally { \restore_error_handler(); } } public function truncate(int $size): Promise { if ($this->handle === null) { return new Failure(new ClosedException("The file '{$this->path}' has been closed")); } try { \set_error_handler(function ($type, $message) { throw new StreamException("Could not truncate file '{$this->path}': {$message}"); }); if (!\ftruncate($this->handle, $size)) { throw new StreamException("Could not truncate file '{$this->path}'"); } return new Success; } catch (StreamException $e) { return new Failure($e); } finally { \restore_error_handler(); } } public function seek(int $position, int $whence = self::SEEK_SET): Promise { if ($this->handle === null) { return new Failure(new ClosedException("The file '{$this->path}' has been closed")); } switch ($whence) { case self::SEEK_SET: case self::SEEK_CUR: case self::SEEK_END: try { \set_error_handler(function ($type, $message) { throw new StreamException("Could not seek in file '{$this->path}': {$message}"); }); if (\fseek($this->handle, $position, $whence) === -1) { throw new StreamException("Could not seek in file '{$this->path}'"); } return new Success($this->tell()); } catch (StreamException $e) { return new Failure($e); } finally { \restore_error_handler(); } default: throw new \Error("Invalid whence parameter; SEEK_SET, SEEK_CUR or SEEK_END expected"); } } public function tell(): int { if ($this->handle === null) { throw new ClosedException("The file '{$this->path}' has been closed"); } return \ftell($this->handle); } public function eof(): bool { if ($this->handle === null) { throw new ClosedException("The file '{$this->path}' has been closed"); } return \feof($this->handle); } public function getPath(): string { return $this->path; } public function getMode(): string { return $this->mode; } } driver = $driver; $this->statusCache = new Cache(1000, 1024); } public function openFile(string $path, string $mode): Promise { return call(function () use ($path, $mode) { $file = yield $this->driver->openFile($path, $mode); return new StatusCachingFile($file, function () use ($path) { $this->invalidate([$path], new Success); }); }); } public function getStatus(string $path): Promise { if ($cachedStat = $this->statusCache->get($path)) { return new Success($cachedStat); } return call(function () use ($path) { $stat = yield $this->driver->getStatus($path); if ($stat) { $this->statusCache->set($path, $stat, 1000); } return $stat; }); } public function getLinkStatus(string $path): Promise { return $this->driver->getLinkStatus($path); } public function createSymlink(string $target, string $link): Promise { return $this->invalidate([$target, $link], $this->driver->createSymlink($target, $link)); } public function createHardlink(string $target, string $link): Promise { return $this->invalidate([$target, $link], $this->driver->createHardlink($target, $link)); } public function resolveSymlink(string $target): Promise { return $this->driver->resolveSymlink($target); } public function move(string $from, string $to): Promise { return $this->invalidate([$from, $to], $this->driver->move($from, $to)); } public function deleteFile(string $path): Promise { return $this->invalidate([$path], $this->driver->deleteFile($path)); } public function createDirectory(string $path, int $mode = 0777): Promise { return $this->invalidate([$path], $this->driver->createDirectory($path, $mode)); } public function createDirectoryRecursively(string $path, int $mode = 0777): Promise { return $this->invalidate([$path], $this->driver->createDirectoryRecursively($path, $mode)); } public function deleteDirectory(string $path): Promise { return $this->invalidate([$path], $this->driver->deleteDirectory($path)); } public function listFiles(string $path): Promise { return $this->driver->listFiles($path); } public function changePermissions(string $path, int $mode): Promise { return $this->invalidate([$path], $this->driver->changePermissions($path, $mode)); } public function changeOwner(string $path, ?int $uid, ?int $gid): Promise { return $this->invalidate([$path], $this->driver->changeOwner($path, $uid, $gid)); } public function touch(string $path, ?int $modificationTime, ?int $accessTime): Promise { return $this->invalidate([$path], $this->driver->touch($path, $modificationTime, $accessTime)); } public function read(string $path): Promise { return $this->driver->read($path); } public function write(string $path, string $contents): Promise { return $this->invalidate([$path], $this->driver->write($path, $contents)); } private function invalidate(array $paths, Promise $promise): Promise { foreach ($paths as $path) { $this->statusCache->delete($path); } if (!$promise instanceof Success) { $promise->onResolve(function () use ($paths) { foreach ($paths as $path) { $this->statusCache->delete($path); } }); } return $promise; } } pool = $pool ?: Worker\pool(); } public function openFile(string $path, string $mode): Promise { return call(function () use ($path, $mode) { $worker = $this->pool->getWorker(); try { [$id, $size, $mode] = yield $worker->enqueue(new Internal\FileTask("fopen", [$path, $mode])); } catch (TaskException $exception) { throw new FilesystemException("Could not open file", $exception); } catch (WorkerException $exception) { throw new FilesystemException("Could not send open request to worker", $exception); } return new ParallelFile($worker, $id, $path, $size, $mode); }); } public function deleteFile(string $path): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("deleteFile", [$path]))); } public function getStatus(string $path): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("getStatus", [$path]))); } public function move(string $from, string $to): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("move", [$from, $to]))); } public function createHardlink(string $target, string $link): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("createHardlink", [$target, $link]))); } public function createSymlink(string $target, string $link): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("createSymlink", [$target, $link]))); } public function resolveSymlink(string $path): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("resolveSymlink", [$path]))); } public function createDirectory(string $path, int $mode = 0777): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("createDirectory", [$path, $mode]))); } public function createDirectoryRecursively(string $path, int $mode = 0777): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("createDirectoryRecursively", [$path, $mode]))); } public function listFiles(string $path): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("listFiles", [$path]))); } public function deleteDirectory(string $path): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("deleteDirectory", [$path]))); } public function changePermissions(string $path, int $mode): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("changePermissions", [$path, $mode]))); } public function changeOwner(string $path, ?int $uid, ?int $gid): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("changeOwner", [$path, $uid, $gid]))); } public function getLinkStatus(string $path): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("getLinkStatus", [$path]))); } public function touch(string $path, ?int $modificationTime, ?int $accessTime): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask( "touch", [$path, $modificationTime, $accessTime] ))); } public function read(string $path): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("read", [$path]))); } public function write(string $path, string $contents): Promise { return new Coroutine($this->runFileTask(new Internal\FileTask("write", [$path, $contents]))); } private function runFileTask(Internal\FileTask $task): \Generator { try { return yield $this->pool->enqueue($task); } catch (TaskException $exception) { throw new FilesystemException("The file operation failed", $exception); } catch (WorkerException $exception) { throw new FilesystemException("Could not send the file task to worker", $exception); } } } driver = $driver; if (!self::$stream) { if (\function_exists('eio_init')) { \eio_init(); } self::$stream = \eio_get_event_stream(); } $this->watcher = $this->driver->onReadable(self::$stream, static function (): void { while (\eio_npending()) { \eio_poll(); } }); $this->driver->disable($this->watcher); $this->driver->setState(self::class, new class($this->watcher, $driver) { private $watcher; private $driver; public function __construct(string $watcher, Loop\Driver $driver) { $this->watcher = $watcher; $this->driver = $driver; } public function __destruct() { $this->driver->cancel($this->watcher); // Ensure there are no active operations anymore. This is a safe-guard as some operations might not be // finished on loop exit due to not being yielded. This also ensures a clean shutdown for these if PHP // exists. \eio_event_loop(); } }); } public function listen(Promise $promise): void { if ($this->requests++ === 0) { $this->driver->enable($this->watcher); } $promise->onResolve(\Closure::fromCallable([$this, 'done'])); } private function done(): void { if (--$this->requests === 0) { $this->driver->disable($this->watcher); } \assert($this->requests >= 0); } } sharedState = $sharedState = new class { use Struct; /** @var string[] */ public $cache = []; /** @var int[] */ public $cacheTimeouts = []; /** @var bool */ public $isSortNeeded = false; public function collectGarbage(): void { $now = \time(); if ($this->isSortNeeded) { \asort($this->cacheTimeouts); $this->isSortNeeded = false; } foreach ($this->cacheTimeouts as $key => $expiry) { if ($now <= $expiry) { break; } unset( $this->cache[$key], $this->cacheTimeouts[$key] ); } } }; $this->ttlWatcherId = Loop::repeat($gcInterval, [$sharedState, "collectGarbage"]); $this->maxSize = $maxSize; Loop::unreference($this->ttlWatcherId); } public function __destruct() { $this->sharedState->cache = []; $this->sharedState->cacheTimeouts = []; Loop::cancel($this->ttlWatcherId); } public function get(string $key) { if (!isset($this->sharedState->cache[$key])) { return null; } if (isset($this->sharedState->cacheTimeouts[$key]) && \time() > $this->sharedState->cacheTimeouts[$key]) { unset( $this->sharedState->cache[$key], $this->sharedState->cacheTimeouts[$key] ); return null; } return $this->sharedState->cache[$key]; } public function set(string $key, $value, int $ttl = null): void { if ($ttl === null) { unset($this->sharedState->cacheTimeouts[$key]); } elseif ($ttl >= 0) { $expiry = \time() + $ttl; $this->sharedState->cacheTimeouts[$key] = $expiry; $this->sharedState->isSortNeeded = true; } else { throw new \Error("Invalid cache TTL ({$ttl}; integer >= 0 or null required"); } unset($this->sharedState->cache[$key]); if (\count($this->sharedState->cache) === $this->maxSize) { \array_shift($this->sharedState->cache); } $this->sharedState->cache[$key] = $value; } public function delete(string $key): bool { $exists = isset($this->sharedState->cache[$key]); unset( $this->sharedState->cache[$key], $this->sharedState->cacheTimeouts[$key] ); return $exists; } } operation = $operation; $this->args = $args; $this->id = $id; } public function run(Environment $environment) { if ('f' === $this->operation[0]) { if ("fopen" === $this->operation) { $path = $this->args[0]; $mode = \str_replace(['b', 't', 'e'], '', $this->args[1]); switch ($mode) { case "r": case "r+": case "w": case "w+": case "a": case "a+": case "x": case "x+": case "c": case "c+": break; default: throw new \Error("Invalid file mode"); } $handle = @\fopen($path, $mode . 'be'); if (!$handle) { $message = 'Could not open the file.'; if ($error = \error_get_last()) { $message .= \sprintf(" Errno: %d; %s", $error["type"], $error["message"]); } throw new FilesystemException($message); } $file = new BlockingFile($handle, $path, $mode); $id = (int) $handle; $size = \fstat($handle)["size"]; $environment->set(self::makeId($id), $file); return [$id, $size, $mode]; } if ($this->id === null) { throw new FilesystemException("No file ID provided"); } $id = self::makeId($this->id); if (!$environment->exists($id)) { throw new FilesystemException(\sprintf( "No file handle with the ID %d has been opened on the worker", $this->id )); } /** @var BlockingFile $file */ if (!($file = $environment->get($id)) instanceof BlockingFile) { throw new FilesystemException("File storage found in inconsistent state"); } switch ($this->operation) { case "fread": case "fwrite": case "fseek": case "ftruncate": return ([$file, \substr($this->operation, 1)])(...$this->args); case "fclose": $environment->delete($id); $file->close(); return null; default: throw new \Error('Invalid operation'); } } switch ($this->operation) { case "getStatus": case "deleteFile": case "move": case "createHardlink": case "createSymlink": case "resolveSymlink": case "getLinkStatus": case "exists": case "createDirectory": case "createDirectoryRecursively": case "listFiles": case "deleteDirectory": case "changePermissions": case "changeOwner": case "touch": case "read": case "write": return ([new BlockingDriver, $this->operation])(...$this->args); default: throw new \Error("Invalid operation"); } } } driver = $driver; $this->watcher = $this->driver->repeat(\PHP_INT_MAX / 2, static function (): void { // do nothing, it's a dummy watcher }); $this->driver->disable($this->watcher); $this->driver->setState(self::class, new class($this->watcher, $driver) { private $watcher; private $driver; public function __construct(string $watcher, UvDriver $driver) { $this->watcher = $watcher; $this->driver = $driver; } public function __destruct() { $this->driver->cancel($this->watcher); } }); } public function listen(Promise $promise): void { if ($this->requests++ === 0) { $this->driver->enable($this->watcher); } $promise->onResolve(\Closure::fromCallable([$this, 'done'])); } private function done(): void { if (--$this->requests === 0) { $this->driver->disable($this->watcher); } \assert($this->requests >= 0); } } */ function openFile(string $path, string $mode): Promise { return filesystem()->openFile($path, $mode); } /** * Execute a file stat operation. * * If the requested path does not exist the resulting Promise will resolve to NULL. * * @param string $path File system path. * * @return Promise */ function getStatus(string $path): Promise { return filesystem()->getStatus($path); } /** * Same as {@see Filesystem::getStatus()} except if the path is a link then the link's data is returned. * * If the requested path does not exist the resulting Promise will resolve to NULL. * * @param string $path File system path. * * @return Promise */ function getLinkStatus(string $path): Promise { return filesystem()->getLinkStatus($path); } /** * Does the specified path exist? * * This function should never resolve as a failure -- only a successful bool value * indicating the existence of the specified path. * * @param string $path File system path. * * @return Promise */ function exists(string $path): Promise { return filesystem()->exists($path); } /** * Retrieve the size in bytes of the file at the specified path. * * If the path does not exist or is not a regular file this * function's returned Promise WILL resolve as a failure. * * @param string $path File system path. * @fails \Amp\Files\FilesystemException If the path does not exist or is not a file. * * @return Promise */ function getSize(string $path): Promise { return filesystem()->getSize($path); } /** * Does the specified path exist and is it a directory? * * @param string $path File system path. * * @return Promise */ function isDirectory(string $path): Promise { return filesystem()->isDirectory($path); } /** * Does the specified path exist and is it a file? * * @param string $path File system path. * * @return Promise */ function isFile(string $path): Promise { return filesystem()->isFile($path); } /** * Does the specified path exist and is it a symlink? * * If the path does not exist the returned Promise will resolve * to FALSE and will not reject with an error. * * @param string $path File system path. * * @return Promise */ function isSymlink(string $path): Promise { return filesystem()->isSymlink($path); } /** * Retrieve the path's last modification time as a unix timestamp. * * @param string $path File system path. * @fails \Amp\Files\FilesystemException If the path does not exist. * * @return Promise */ function getModificationTime(string $path): Promise { return filesystem()->getModificationTime($path); } /** * Retrieve the path's last access time as a unix timestamp. * * @param string $path File system path. * @fails \Amp\Files\FilesystemException If the path does not exist. * * @return Promise */ function getAccessTime(string $path): Promise { return filesystem()->getAccessTime($path); } /** * Retrieve the path's creation time as a unix timestamp. * * @param string $path File system path. * @fails \Amp\Files\FilesystemException If the path does not exist. * * @return Promise */ function getCreationTime(string $path): Promise { return filesystem()->getCreationTime($path); } /** * Create a symlink $link pointing to the file/directory located at $original. * * @param string $original * @param string $link * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ function createSymlink(string $original, string $link): Promise { return filesystem()->createSymlink($original, $link); } /** * Create a hard link $link pointing to the file/directory located at $target. * * @param string $target * @param string $link * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ function createHardlink(string $target, string $link): Promise { return filesystem()->createHardlink($target, $link); } /** * Resolve the symlink at $path. * * @param string $path * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ function resolveSymlink(string $path): Promise { return filesystem()->resolveSymlink($path); } /** * Move / rename a file or directory. * * @param string $from * @param string $to * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ function move(string $from, string $to): Promise { return filesystem()->move($from, $to); } /** * Delete a file. * * @param string $path * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ function deleteFile(string $path): Promise { return filesystem()->deleteFile($path); } /** * Create a directory. * * @param string $path * @param int $mode * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ function createDirectory(string $path, int $mode = 0777): Promise { return filesystem()->createDirectory($path, $mode); } /** * Create a directory recursively. * * @param string $path * @param int $mode * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ function createDirectoryRecursively(string $path, int $mode = 0777): Promise { return filesystem()->createDirectoryRecursively($path, $mode); } /** * Delete a directory. * * @param string $path * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ function deleteDirectory(string $path): Promise { return filesystem()->deleteDirectory($path); } /** * Retrieve an array of files and directories inside the specified path. * * Dot entries are not included in the resulting array (i.e. "." and ".."). * * @param string $path * * @return Promise> */ function listFiles(string $path): Promise { return filesystem()->listFiles($path); } /** * Change permissions of a file or directory. * * @param string $path * @param int $mode * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ function changePermissions(string $path, int $mode): Promise { return filesystem()->changePermissions($path, $mode); } /** * Change ownership of a file or directory. * * @param string $path * @param int|null $uid null to ignore * @param int|null $gid null to ignore * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ function changeOwner(string $path, ?int $uid, ?int $gid = null): Promise { return filesystem()->changeOwner($path, $uid, $gid); } /** * Update the access and modification time of the specified path. * * If the file does not exist it will be created automatically. * * @param string $path * @param int|null $modificationTime The touch time. If $time is not supplied, the current system time is used. * @param int|null $accessTime The access time. If not supplied, the modification time is used. * @fails \Amp\Files\FilesystemException If the operation fails. * * @return Promise */ function touch(string $path, ?int $modificationTime = null, ?int $accessTime = null): Promise { return filesystem()->touch($path, $modificationTime, $accessTime); } /** * Buffer the specified file's contents. * * @param string $path The file path from which to buffer contents. * * @return Promise */ function read(string $path): Promise { return filesystem()->read($path); } /** * Write the contents string to the specified path. * * @param string $path The file path to which to $contents should be written. * @param string $contents The data to write to the specified $path. * * @return Promise */ function write(string $path, string $contents): Promise { return filesystem()->write($path, $contents); } fileName = $fileName; } /** * {@inheritdoc} */ public function acquire(): Promise { return new Coroutine($this->doAcquire()); } /** * @coroutine * * @return \Generator */ private function doAcquire(): \Generator { // Try to create the lock file. If the file already exists, someone else // has the lock, so set an asynchronous timer and try again. while (true) { try { $file = yield openFile($this->fileName, 'x'); break; } catch (FilesystemException $exception) { yield new Delayed(self::LATENCY_TIMEOUT); } } // Return a lock object that can be used to release the lock on the mutex. $lock = new Lock(0, function (): void { $this->release(); }); yield $file->close(); return $lock; } /** * Releases the lock on the mutex. */ private function release(): void { deleteFile($this->fileName)->onResolve( function (?\Throwable $exception): void { if ($exception !== null) { throw new SyncException( 'Failed to unlock the mutex file: ' . $this->fileName, 0, $exception ); } } ); } } */ public function openFile(string $path, string $mode): Promise; /** * Get file status; also known as stat operation. * * If the requested path does not exist the resulting Promise will resolve to NULL. * * @param string $path The file system path to stat. * * @return Promise */ public function getStatus(string $path): Promise; /** * Same as {@see Driver::getStatus()} except if the path is a link then the link's data is returned. * * If the requested path does not exist the resulting Promise will resolve to NULL. * * @param string $path The file system path to stat. * * @return Promise A promise resolving to an associative array upon successful resolution. */ public function getLinkStatus(string $path): Promise; /** * Create a symlink $link pointing to the file/directory located at $target. * * @param string $target * @param string $link * * @return Promise */ public function createSymlink(string $target, string $link): Promise; /** * Create a hard link $link pointing to the file/directory located at $target. * * @param string $target * @param string $link * * @return Promise */ public function createHardlink(string $target, string $link): Promise; /** * Resolve the symlink at $path. * * @param string $target * * @return Promise */ public function resolveSymlink(string $target): Promise; /** * Move / rename a file or directory. * * @param string $from * @param string $to * * @return Promise */ public function move(string $from, string $to): Promise; /** * Delete a file. * * @param string $path * * @return Promise */ public function deleteFile(string $path): Promise; /** * Create a directory. * * @param string $path * @param int $mode * * @return Promise */ public function createDirectory(string $path, int $mode = 0777): Promise; /** * Create a directory recursively. * * @param string $path * @param int $mode * * @return Promise */ public function createDirectoryRecursively(string $path, int $mode = 0777): Promise; /** * Delete a directory. * * @param string $path * * @return Promise */ public function deleteDirectory(string $path): Promise; /** * Retrieve an array of files and directories inside the specified path. * * Dot entries are not included in the resulting array (i.e. "." and ".."). * * @param string $path * * @return Promise> */ public function listFiles(string $path): Promise; /** * chmod a file or directory. * * @param string $path * @param int $mode * * @return Promise */ public function changePermissions(string $path, int $mode): Promise; /** * chown a file or directory. * * @param string $path * @param int|null $uid * @param int|null $gid * * @return Promise */ public function changeOwner(string $path, ?int $uid, ?int $gid): Promise; /** * Update the access and modification time of the specified path. * * If the file does not exist it will be created automatically. * * @param string $path * @param int|null $modificationTime The touch time. If $time is not supplied, the current system time is used. * @param int|null $accessTime The access time. If $atime is not supplied, value passed to the $time parameter is * used. * * @return Promise */ public function touch(string $path, ?int $modificationTime, ?int $accessTime): Promise; /** * Buffer the specified file's contents. * * @param string $path The file path from which to buffer contents. * * @return Promise A promise resolving to a string upon successful resolution. */ public function read(string $path): Promise; /** * Write the contents string to the specified path. * * @param string $path The file path to which to $contents should be written. * @param string $contents The data to write to the specified $path. * * @return Promise */ public function write(string $path, string $contents): Promise; } */ public function read(int $length = self::DEFAULT_READ_LENGTH): Promise; /** * Write $data to the open file handle. * * @param string $data * * @return Promise */ public function write(string $data): Promise; /** * Write $data to the open file handle and close the handle once the write completes. * * @param string $data * * @return Promise */ public function end(string $data = ""): Promise; /** * Close the file handle. * * Applications are not required to manually close handles -- they will * be unloaded automatically when the object is garbage collected. * * @return Promise */ public function close(): Promise; /** * Set the handle's internal pointer position. * * $whence values: * * SEEK_SET - Set position equal to offset bytes. * SEEK_CUR - Set position to current location plus offset. * SEEK_END - Set position to end-of-file plus offset. * * @param int $position * @param int $whence * * @return Promise New offset position. */ public function seek(int $position, int $whence = self::SEEK_SET): Promise; /** * Return the current internal offset position of the file handle. * * @return int */ public function tell(): int; /** * Test for "end-of-file" on the file handle. * * @return bool */ public function eof(): bool; /** * Retrieve the path used when opening the file handle. * * @return string */ public function getPath(): string; /** * Retrieve the mode used when opening the file handle. * * @return string */ public function getMode(): string; /** * Truncates the file to the given length. If $size is larger than the current file size, the file is extended * with null bytes. * * @param int $size New file size. * * @return Promise */ public function truncate(int $size): Promise; } =7.1", "amphp/amp": "^2.2" }, "require-dev": { "phpunit/phpunit": "^9 || ^8 || ^7", "amphp/phpunit-util": "^1.1", "amphp/php-cs-fixer-config": "dev-master" }, "autoload": { "psr-4": { "Amp\\Sync\\": "src" }, "files": [ "src/functions.php", "src/ConcurrentIterator/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Sync\\Test\\": "test" } } } Resolves with an integer keyed lock object. Identifiers returned by the * locks should be 0-indexed. Releasing an identifier MUST make that same identifier available. May fail with * a SyncException if an error occurs when attempting to obtain the lock (e.g. a shared memory segment closed). */ public function acquire(): Promise; } Resolves with a lock object with an ID of 0. May fail with a SyncException * if an error occurs when attempting to obtain the lock (e.g. a shared memory segment closed). */ public function acquire(string $key): Promise; } id = $id; $this->releaser = $releaser; } /** * Checks if the lock has already been released. * * @return bool True if the lock has already been released, otherwise false. */ public function isReleased(): bool { return !$this->releaser; } /** * @return int Lock identifier. */ public function getId(): int { return $this->id; } /** * Releases the lock. No-op if the lock has already been released. */ public function release() { if (!$this->releaser) { return; } // Invoke the releaser function given to us by the synchronization source // to release the lock. $releaser = $this->releaser; $this->releaser = null; $releaser($this); } /** * Releases the lock when there are no more references to it. */ public function __destruct() { if (!$this->isReleased()) { $this->release(); } } } semaphore = $semaphore; $this->prefix = $prefix; } public function acquire(string $key): Promise { return $this->semaphore->acquire($this->prefix . $key); } } Resolves with an integer keyed lock object. Identifiers returned by the * locks should be 0-indexed. Releasing an identifier MUST make that same identifier available. May fail with * a SyncException if an error occurs when attempting to obtain the lock (e.g. a shared memory segment closed). */ public function acquire(string $key): Promise; } semaphore = new Internal\SemaphoreStorage($locks); } /** * {@inheritdoc} */ public function acquire(): Promise { return $this->semaphore->acquire(); } } locked) { $this->locked = true; return new Success(new Lock(0, \Closure::fromCallable([$this, 'release']))); } $this->queue[] = $deferred = new Deferred; return $deferred->promise(); } private function release(): void { if (!empty($this->queue)) { $deferred = \array_shift($this->queue); $deferred->resolve(new Lock(0, \Closure::fromCallable([$this, 'release']))); return; } $this->locked = false; } } count()) { return null; } return $this->shift(); }; while (!$this->count() || ($id = $this->synchronized($tsl)) === null) { yield new Delayed(self::LATENCY_TIMEOUT); } return new Lock($id, function (Lock $lock): void { $id = $lock->getId(); $this->synchronized(function () use ($id) { $this[] = $id; }); }); }); } } locked) { return true; } $this->locked = true; return false; }; while ($this->locked || $this->synchronized($tsl)) { yield new Delayed(self::LATENCY_TIMEOUT); } return new Lock(0, function (): void { $this->locked = false; }); }); } } arrive(); * $barrier->arrive(); // promise returned from Barrier::await() is now resolved * * yield $barrier->await(); * ``` */ final class Barrier { /** @var int */ private $count; /** @var Deferred */ private $deferred; public function __construct(int $count) { if ($count < 1) { throw new \Error('Count must be positive, got ' . $count); } $this->count = $count; $this->deferred = new Deferred(); } public function getCount(): int { return $this->count; } public function arrive(int $count = 1): void { if ($count < 1) { throw new \Error('Count must be at least 1, got ' . $count); } if ($count > $this->count) { throw new \Error('Count cannot be greater than remaining count: ' . $count . ' > ' . $this->count); } $this->count -= $count; if ($this->count === 0) { $this->deferred->resolve(); } } public function register(int $count = 1): void { if ($count < 1) { throw new \Error('Count must be at least 1, got ' . $count); } if ($this->count === 0) { throw new \Error('Can\'t increase count, because the barrier already broke'); } $this->count += $count; } public function await(): Promise { return $this->deferred->promise(); } } acquire(); try { return yield call($callback, ...$args); } finally { $lock->release(); } }); } maxLocks = $maxLocks; } public function acquire(string $key): Promise { if (!isset($this->semaphore[$key])) { $this->semaphore[$key] = new LocalSemaphore($this->maxLocks); $this->locks[$key] = 0; } return call(function () use ($key) { $this->locks[$key]++; /** @var Lock $lock */ $lock = yield $this->semaphore[$key]->acquire(); return new Lock(0, function () use ($lock, $key) { if (--$this->locks[$key] === 0) { unset($this->semaphore[$key], $this->locks[$key]); } $lock->release(); }); }); } } mutex[$key])) { $this->mutex[$key] = new LocalMutex; $this->locks[$key] = 0; } return call(function () use ($key) { $this->locks[$key]++; /** @var Lock $lock */ $lock = yield $this->mutex[$key]->acquire(); return new Lock(0, function () use ($lock, $key) { if (--$this->locks[$key] === 0) { unset($this->mutex[$key], $this->locks[$key]); } $lock->release(); }); }); } } mutex = new Internal\MutexStorage; } /** * {@inheritdoc} */ public function acquire(): Promise { return $this->mutex->acquire(); } } init($maxLocks, $permissions); return $semaphore; } /** * @param string $id The unique name of the semaphore to use. * * @return \Amp\Sync\PosixSemaphore */ public static function use(string $id): self { $semaphore = new self($id); $semaphore->open(); return $semaphore; } /** * @param string $id * * @throws \Error If the sysvmsg extension is not loaded. */ private function __construct(string $id) { if (!\extension_loaded("sysvmsg")) { throw new \Error(__CLASS__ . " requires the sysvmsg extension."); } $this->id = $id; $this->key = self::makeKey($this->id); } /** * Private method to prevent cloning. */ private function __clone() { } /** * Prevent serialization. */ public function __sleep() { throw new \Error('A semaphore cannot be serialized!'); } public function getId(): string { return $this->id; } private function open(): void { if (!\msg_queue_exists($this->key)) { throw new SyncException('No semaphore with that ID found'); } $this->queue = \msg_get_queue($this->key); if (!$this->queue) { throw new SyncException('Failed to open the semaphore.'); } } /** * @param int $maxLocks The maximum number of locks that can be acquired from the semaphore. * @param int $permissions Permissions to access the semaphore. * * @throws SyncException If the semaphore could not be created due to an internal error. */ private function init(int $maxLocks, int $permissions): void { if (\msg_queue_exists($this->key)) { throw new SyncException('A semaphore with that ID already exists'); } $this->queue = \msg_get_queue($this->key, $permissions); if (!$this->queue) { throw new SyncException('Failed to create the semaphore.'); } $this->initializer = \getmypid(); // Fill the semaphore with locks. while (--$maxLocks >= 0) { $this->release($maxLocks); } } /** * Gets the access permissions of the semaphore. * * @return int A permissions mode. */ public function getPermissions(): int { $stat = \msg_stat_queue($this->queue); return $stat['msg_perm.mode']; } /** * Sets the access permissions of the semaphore. * * The current user must have access to the semaphore in order to change the permissions. * * @param int $mode A permissions mode to set. * * @throws SyncException If the operation failed. */ public function setPermissions(int $mode) { if (!\msg_set_queue($this->queue, ['msg_perm.mode' => $mode])) { throw new SyncException('Failed to change the semaphore permissions.'); } } public function acquire(): Promise { return new Coroutine($this->doAcquire()); } /** * {@inheritdoc} */ private function doAcquire(): \Generator { do { // Attempt to acquire a lock from the semaphore. if (@\msg_receive($this->queue, 0, $type, 1, $id, false, \MSG_IPC_NOWAIT, $errno)) { // A free lock was found, so resolve with a lock object that can // be used to release the lock. return new Lock(\unpack("C", $id)[1], function (Lock $lock) { $this->release($lock->getId()); }); } // Check for unusual errors. if ($errno !== \MSG_ENOMSG) { throw new SyncException(\sprintf('Failed to acquire a lock; errno: %d', $errno)); } } while (yield new Delayed(self::LATENCY_TIMEOUT, true)); } /** * Removes the semaphore if it still exists. * * @throws SyncException If the operation failed. */ public function __destruct() { if ($this->initializer === 0 || $this->initializer !== \getmypid()) { return; } if (\PHP_VERSION_ID < 80000 && (!\is_resource($this->queue) || !\msg_queue_exists($this->key))) { return; } if (\PHP_VERSION_ID >= 80000 && (!$this->queue instanceof \SysvMessageQueue || !\msg_queue_exists($this->key))) { return; } \msg_remove_queue($this->queue); } /** * Releases a lock from the semaphore. * * @param int $id Lock identifier. * * @throws SyncException If the operation failed. */ protected function release(int $id) { if (!$this->queue) { return; // Queue already destroyed. } // Call send in non-blocking mode. If the call fails because the queue // is full, then the number of locks configured is too large. if (!@\msg_send($this->queue, 1, \pack("C", $id), false, false, $errno)) { if ($errno === \MSG_EAGAIN) { throw new SyncException('The semaphore size is larger than the system allows.'); } throw new SyncException('Failed to release the lock.'); } } private static function makeKey(string $id): int { return \abs(\unpack("l", \md5($id, true))[1]); } } mutex = $mutex; $this->key = $key; } public function acquire(): Promise { return $this->mutex->acquire($this->key); } } locks = \range(0, $maxLocks - 1); } /** {@inheritdoc} */ public function acquire(): Promise { if (!empty($this->locks)) { return new Success(new Lock(\array_shift($this->locks), \Closure::fromCallable([$this, 'release']))); } $this->queue[] = $deferred = new Deferred; return $deferred->promise(); } private function release(Lock $lock): void { $id = $lock->getId(); if (!empty($this->queue)) { $deferred = \array_shift($this->queue); $deferred->resolve(new Lock($id, \Closure::fromCallable([$this, 'release']))); return; } $this->locks[] = $id; } } semaphore = $semaphore; } /** {@inheritdoc} */ public function acquire(): Promise { return call(function (): \Generator { /** @var \Amp\Sync\Lock $lock */ $lock = yield $this->semaphore->acquire(); if ($lock->getId() !== 0) { $lock->release(); throw new \Error("Cannot use a semaphore with more than a single lock"); } return $lock; }); } } getId()]); $lock->release(); $barrier->arrive(); } }; while (yield $iterator->advance()) { if ($error) { break; } /** @var Lock $lock */ $lock = yield $semaphore->acquire(); if ($gc || isset($locks[$lock->getId()])) { // Throwing here causes a segfault on PHP 7.3 return; // throw new CancelledException; // producer and locks have been GCed } $locks[$lock->getId()] = true; $barrier->register(); asyncCall($processor, $lock, $iterator->getCurrent()); } $barrier->arrive(); // remove dummy item yield $barrier->await(); if ($error) { throw $error; } }); } /** * Concurrently map all iterator values using {@code $processor}. * * The order of the items in the resulting iterator is not guaranteed in any way. * * @param Iterator $iterator Values to map. * @param Semaphore $semaphore Semaphore limiting the concurrency, e.g. {@code LocalSemaphore} * @param callable $processor Processing callable, which is run as coroutine. It should not throw any errors, * otherwise the entire operation is aborted. * * @return Iterator Mapped values. */ function map(Iterator $iterator, Semaphore $semaphore, callable $processor): Iterator { $processor = coroutine($processor); return transform($iterator, $semaphore, static function ($value, callable $emit) use ($processor) { $value = yield $processor($value); yield $emit($value); }); } /** * Concurrently filter all iterator values using {@code $filter}. * * The order of the items in the resulting iterator is not guaranteed in any way. * * @param Iterator $iterator Values to map. * @param Semaphore $semaphore Semaphore limiting the concurrency, e.g. {@code LocalSemaphore} * @param callable $filter Processing callable, which is run as coroutine. It should not throw any errors, * otherwise the entire operation is aborted. Must resolve to a boolean, true to keep values in the resulting * iterator. * * @return Iterator Values, where {@code $filter} resolved to {@code true}. */ function filter(Iterator $iterator, Semaphore $semaphore, callable $filter): Iterator { $filter = coroutine($filter); return transform($iterator, $semaphore, static function ($value, callable $emit) use ($filter) { $keep = yield $filter($value); if (!\is_bool($keep)) { throw new \TypeError(__NAMESPACE__ . '\filter\'s callable must resolve to a boolean value, got ' . \gettype($keep)); } if ($keep) { yield $emit($value); } }); } /** * Concurrently invoke a callback on all iterator values using {@code $processor}. * * @param Iterator $iterator Values to act on. * @param Semaphore $semaphore Semaphore limiting the concurrency, e.g. {@code LocalSemaphore} * @param callable $processor Processing callable, which is run as coroutine. It should not throw any errors, * otherwise the entire operation is aborted. * * @return Promise */ function each(Iterator $iterator, Semaphore $semaphore, callable $processor): Promise { $processor = coroutine($processor); $iterator = transform( $iterator, $semaphore, static function ($value, callable $emit) use ($processor) { yield $processor($value); yield $emit(null); } ); // Use Amp\Iterator\discard in the future return call(static function () use ($iterator) { $count = 0; while (yield $iterator->advance()) { $count++; } return $count; }); } Resolves with a lock object with an ID of 0. May fail with a SyncException * if an error occurs when attempting to obtain the lock (e.g. a shared memory segment closed). */ public function acquire(): Promise; } mutex = $mutex; $this->prefix = $prefix; } public function acquire(string $key): Promise { return $this->mutex->acquire($this->prefix . $key); } } fileName = $fileName; } /** * {@inheritdoc} */ public function acquire(): Promise { return new Coroutine($this->doAcquire()); } /** * @coroutine * * @return \Generator */ private function doAcquire(): \Generator { // Try to create the lock file. If the file already exists, someone else // has the lock, so set an asynchronous timer and try again. while (($handle = @\fopen($this->fileName, 'x')) === false) { yield new Delayed(self::LATENCY_TIMEOUT); } // Return a lock object that can be used to release the lock on the mutex. $lock = new Lock(0, function (): void { $this->release(); }); \fclose($handle); return $lock; } /** * Releases the lock on the mutex. * * @throws SyncException If the unlock operation failed. */ protected function release() { $success = @\unlink($this->fileName); if (!$success) { throw new SyncException('Failed to unlock the mutex file.'); } } } getFinder() ->in(__DIR__ . '/examples') ->in(__DIR__ . '/src') ->in(__DIR__ . '/test'); $config->setCacheFile(__DIR__ . '/.php_cs.cache'); return $config; { "name": "amphp/parser", "homepage": "https://github.com/amphp/parser", "description": "A generator parser to make streaming parsers simple.", "support": { "issues": "https://github.com/amphp/parser/issues" }, "keywords": [ "stream", "async", "non-blocking", "parser" ], "license": "MIT", "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "require": { "php": ">=7.4" }, "require-dev": { "phpunit/phpunit": "^9", "amphp/php-cs-fixer-config": "^2", "psalm/phar": "^5.4" }, "autoload": { "psr-4": { "Amp\\Parser\\": "src" } }, "autoload-dev": { "psr-4": { "Amp\\Parser\\Test\\": "test" } } } current(); $prefix .= \sprintf( "; %s yielded at key %s", \is_object($yielded) ? \get_class($yielded) : \gettype($yielded), \var_export($generator->key(), true) ); if (!$generator->valid()) { parent::__construct($prefix, 0, $previous); return; } $reflGen = new \ReflectionGenerator($generator); $exeGen = $reflGen->getExecutingGenerator(); if ($isSubgenerator = ($exeGen !== $generator)) { $reflGen = new \ReflectionGenerator($exeGen); } parent::__construct(\sprintf( "%s on line %s in %s", $prefix, $reflGen->getExecutingLine(), $reflGen->getExecutingFile() ), 0, $previous); } } |null */ private ?\Generator $generator; /** @var list */ private array $buffers = []; private int $bufferLength = 0; /** @var int|string|null */ private $delimiter; /** * @param \Generator $generator * * @throws InvalidDelimiterError If the generator yields an invalid delimiter. * @throws \Throwable If the generator throws. */ public function __construct(\Generator $generator) { $this->generator = $generator; $this->delimiter = $this->filterDelimiter($this->generator->current()); if (!$this->generator->valid()) { $this->generator = null; } } /** * Cancels the generator parser and returns any remaining data in the internal buffer. Writing data after calling * this method will result in an error. */ final public function cancel(): string { $buffer = \implode($this->buffers); $this->buffers = []; $this->generator = null; return $buffer; } /** * @return bool True if the parser can still receive more data to parse, false if it has ended and calling push * will throw an exception. */ final public function isValid(): bool { return $this->generator !== null; } /** * Adds data to the internal buffer and tries to continue parsing. * * @param string $data Data to append to the internal buffer. * * @throws InvalidDelimiterError If the generator yields an invalid delimiter. * @throws \Error If parsing has already been cancelled. * @throws \Throwable If the generator throws. */ final public function push(string $data): void { if ($this->generator === null) { throw new \Error("The parser is no longer writable"); } $length = \strlen($data); if ($length === 0) { return; } $this->bufferLength += $length; try { do { if (\is_int($this->delimiter) && $this->bufferLength < $this->delimiter) { return; } if (!empty($this->buffers)) { $this->buffers[] = $data; $data = \implode($this->buffers); $this->buffers = []; } if (\is_int($this->delimiter)) { $cutAt = $retainFrom = $this->delimiter; } elseif (\is_string($this->delimiter)) { if (($cutAt = \strpos($data, $this->delimiter)) === false) { return; } $retainFrom = $cutAt + \strlen($this->delimiter); } else { $cutAt = $retainFrom = $this->bufferLength; } if ($this->bufferLength > $cutAt) { $send = \substr($data, 0, $cutAt); $data = \substr($data, $retainFrom); } else { $send = $data; $data = ''; } $this->bufferLength -= $retainFrom; $this->delimiter = $this->filterDelimiter($this->generator->send($send)); if (!$this->generator->valid()) { $this->generator = null; return; } } while ($this->bufferLength); } catch (\Throwable $exception) { $this->generator = null; throw $exception; } finally { if (\strlen($data)) { $this->buffers[] = $data; } } } /** * @param mixed $delimiter Value yielded from Generator. * @return int|string|null */ private function filterDelimiter($delimiter) { \assert($this->generator instanceof \Generator, "Invalid parser state"); if ($delimiter !== null && (!\is_int($delimiter) || $delimiter <= 0) && (!\is_string($delimiter) || !\strlen($delimiter)) ) { throw new InvalidDelimiterError( $this->generator, \sprintf( "Invalid value yielded: Expected NULL, an int greater than 0, or a non-empty string; %s given", \is_object($delimiter) ? \sprintf("instance of %s", \get_class($delimiter)) : \gettype($delimiter), ) ); } return $delimiter; } } { "name": "amphp/serialization", "description": "Serialization tools for IPC and data storage in PHP.", "keywords": [ "asynchronous", "async", "serialization", "serialize" ], "homepage": "https://github.com/amphp/serialization", "license": "MIT", "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "require": { "php": ">=7.1" }, "require-dev": { "phpunit/phpunit": "^9 || ^8 || ^7", "amphp/php-cs-fixer-config": "dev-master" }, "autoload": { "psr-4": { "Amp\\Serialization\\": "src" }, "files": [ "src/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Serialization\\Test\\": "test" } } } allowedClasses = $allowedClasses; } public function serialize($data): string { try { return \serialize($data); } catch (\Throwable $exception) { throw new SerializationException( \sprintf('The given data could not be serialized: %s', $exception->getMessage()), 0, $exception ); } } public function unserialize(string $data) { try { $result = \unserialize($data, ['allowed_classes' => $this->allowedClasses ?? true]); if ($result === false && $data !== \serialize(false)) { throw new SerializationException( 'Invalid data provided to unserialize: ' . encodeUnprintableChars($data) ); } } catch (\Throwable $exception) { throw new SerializationException('Exception thrown when unserializing data', 0, $exception); } return $result; } } serializer = $serializer; } public function serialize($data): string { $serializedData = $this->serializer->serialize($data); $flags = 0; if (\strlen($serializedData) > self::COMPRESSION_THRESHOLD) { $serializedData = @\gzdeflate($serializedData, 1); if ($serializedData === false) { $error = \error_get_last(); throw new SerializationException('Could not compress data: ' . ($error['message'] ?? 'unknown error')); } $flags |= self::FLAG_COMPRESSED; } return \chr($flags & 0xff) . $serializedData; } public function unserialize(string $data) { $firstByte = \ord($data[0]); $data = \substr($data, 1); if ($firstByte & self::FLAG_COMPRESSED) { $data = @\gzinflate($data); if ($data === false) { $error = \error_get_last(); throw new SerializationException('Could not decompress data: ' . ($error['message'] ?? 'unknown error')); } } return $this->serializer->unserialize($data); } } associative = $associative; $this->depth = $depth; // We don't want to throw on errors, we manually check for errors using json_last_error(). $this->encodeOptions = $encodeOptions & ~self::THROW_ON_ERROR; $this->decodeOptions = $decodeOptions & ~self::THROW_ON_ERROR; } public function serialize($data): string { $result = \json_encode($data, $this->encodeOptions, $this->depth); switch ($code = \json_last_error()) { case \JSON_ERROR_NONE: return $result; default: throw new SerializationException(\json_last_error_msg(), $code); } } public function unserialize(string $data) { $result = \json_decode($data, $this->associative, $this->depth, $this->decodeOptions); switch ($code = \json_last_error()) { case \JSON_ERROR_NONE: return $result; default: throw new SerializationException(\json_last_error_msg(), $code); } } } = 0 && (!isset($all[$i]) || (\is_array($all[$i]) && ($all[$i][0] === T_COMMENT || $all[$i][0] === T_DOC_COMMENT || $all[$i][0] === T_WHITESPACE))); --$i); return $i; }; $first = true; foreach ($all as $i => $token) { if (\is_array($token) && ($token[0] === T_COMMENT || $token[0] === T_DOC_COMMENT)) { // remove all comments except first if ($first === true) { $first = false; continue; } unset($all[$i]); } elseif (\is_array($token) && $token[0] === T_PUBLIC) { // get next non-whitespace token after `public` visibility $token = $all[$next($i)]; if (\is_array($token) && $token[0] === T_VARIABLE) { // use shorter variable notation `public $a` => `var $a` $all[$i] = [T_VAR, 'var']; } else { // remove unneeded public identifier `public static function a()` => `static function a()` unset($all[$i]); } } elseif (\is_array($token) && $token[0] === T_LNUMBER) { // Use shorter integer notation `0x0F` => `15` and `011` => `9`. // Technically, hex codes may be shorter for very large ints, but adding // another 2 leading chars is rarely worth it. // Optimizing floats is not really worth it, as they have many special // cases, such as e-notation and we would lose types for `0.0` => `0`. $all[$i][1] = (string) \intval($token[1], 0); } elseif (\is_array($token) && $token[0] === T_NEW) { // remove unneeded parenthesis for constructors without args `new a();` => `new a;` // jump over next token (class name), then next must be open parenthesis, followed by closing $open = $next($next($i)); $close = $next($open); if ($all[$open] === '(' && $all[$close] === ')') { unset($all[$open], $all[$close]); } } elseif (\is_array($token) && $token[0] === T_STRING) { // replace certain functions with their shorter alias function name // http://php.net/manual/en/aliases.php static $replace = [ 'implode' => 'join', 'fwrite' => 'fputs', 'array_key_exists' => 'key_exists', 'current' => 'pos', ]; // check this has a replacement and "looks like" a function call // this works on a number of assumptions, such as not being aliased/namespaced if (isset($replace[$token[1]])) { $p = $all[$prev($i)]; if ($all[$next($i)] === '(' && (!\is_array($p) || !\in_array($p[0], [T_FUNCTION, T_OBJECT_OPERATOR, T_DOUBLE_COLON, T_NEW]))) { $all[$i][1] = $replace[$all[$i][1]]; } } } elseif (\is_array($token) && $token[0] === T_EXIT) { // replace `exit` with shorter alias `die` // it's a language construct, not a function (see above) $all[$i][1] = 'die'; } elseif (\is_array($token) && $token[0] === T_RETURN) { // replace `return null;` with `return;` $t = $next($i); if (\is_array($all[$t]) && $all[$t][0] === T_STRING && $all[$t][1] === 'null' && $all[$next($t)] === ';') { unset($all[$t]); } } } $all = \array_values($all); foreach ($all as $i => $token) { if (\is_array($token) && $token[0] === T_WHITESPACE) { if (\strpos($token[1], "\n") !== false) { $token = \strpos("()[]<>=+-*/%|,.:?!'\"\n", \substr($small, -1)) === false ? "\n" : ''; } else { $last = \substr($small, -1); $next = isset($all[$i + 1]) ? \substr(\is_array($all[$i + 1]) ? $all[$i + 1][1] : $all[$i + 1], 0, 1) : ' '; $token = (\strpos('()[]{}<>;=+-*/%&|,.:?!@\'"' . "\r\n", $last) !== false || \strpos('()[]{}<>;=+-*/%&|,.:?!@\'"' . '\\$', $next) !== false) ? '' : ' '; } } $small .= isset($token[1]) ? $token[1] : $token; } \file_put_contents($argv[1], $small); setTarget(function (string $input) { (new HPack)->decode($input, 8192); }); $fuzzer->setMaxLen(1024); decode(\file_get_contents($argv[1]), 8192); { "name": "amphp/hpack", "homepage": "https://github.com/amphp/hpack", "description": "HTTP/2 HPack implementation.", "keywords": [ "http-2", "hpack", "headers" ], "license": "MIT", "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@php.net" }, { "name": "Bob Weinand" }, { "name": "Niklas Keller", "email": "me@kelunik.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" } ], "require": { "php": ">=7.1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "http2jp/hpack-test-case": "^1", "phpunit/phpunit": "^6 | ^7" }, "autoload": { "psr-4": { "Amp\\Http\\": "src" } }, "autoload-dev": { "psr-4": { "Amp\\Http\\": "test" } }, "extra": { "branch-alias": { "dev-master": "3.x-dev" } }, "repositories": [ { "type": "package", "package": { "name": "http2jp/hpack-test-case", "version": "1.0", "source": { "url": "https://github.com/http2jp/hpack-test-case", "type": "git", "reference": "origin/master" } } } ] } cases as $case) { foreach ($case->headers as &$header) { $header = (array) $header; $header = [\key($header), \current($header)]; } $cases[$case->seqno] = [\hex2bin($case->wire), $case->headers]; } $tests[] = $cases; } $minDuration = \PHP_INT_MAX; $minOps = \PHP_INT_MAX; for ($i = 0; $i < 10; $i++) { $start = \microtime(true); $ops = 0; foreach ($tests as $test) { $hpack = new Amp\Http\Internal\HPackNative; foreach ($cases as [$input, $output]) { $headers = $hpack->decode($input, 4096); $hpack->encode($headers); if ($headers !== $output) { print 'Invalid headers' . \PHP_EOL; exit(1); } $ops++; } } $duration = \microtime(true) - $start; $minDuration = \min($minDuration, $duration); $minOps = \min($ops, $minOps); } print "$minOps in $minDuration seconds" . \PHP_EOL; [93,"0"],"\x01"=>[138,"0"],"\x02"=>[75,"0"],"\x03"=>[91,"0"],"\x04"=>[108,"0"],"\x05"=>[103,"0"],"\x06"=>[114,"0"],"\x07"=>[14,"0"],"\x08"=>[93,"1"],"\x09"=>[138,"1"],"\x0A"=>[75,"1"],"\x0B"=>[91,"1"],"\x0C"=>[108,"1"],"\x0D"=>[103,"1"],"\x0E"=>[114,"1"],"\x0F"=>[14,"1"],"\x10"=>[93,"2"],"\x11"=>[138,"2"],"\x12"=>[75,"2"],"\x13"=>[91,"2"],"\x14"=>[108,"2"],"\x15"=>[103,"2"],"\x16"=>[114,"2"],"\x17"=>[14,"2"],"\x18"=>[93,"a"],"\x19"=>[138,"a"],"\x1A"=>[75,"a"],"\x1B"=>[91,"a"],"\x1C"=>[108,"a"],"\x1D"=>[103,"a"],"\x1E"=>[114,"a"],"\x1F"=>[14,"a"],"\x20"=>[93,"c"],"\x21"=>[138,"c"],"\x22"=>[75,"c"],"\x23"=>[91,"c"],"\x24"=>[108,"c"],"\x25"=>[103,"c"],"\x26"=>[114,"c"],"\x27"=>[14,"c"],"\x28"=>[93,"e"],"\x29"=>[138,"e"],"\x2A"=>[75,"e"],"\x2B"=>[91,"e"],"\x2C"=>[108,"e"],"-"=>[103,"e"],"."=>[114,"e"],"\x2F"=>[14,"e"],[93,"i"],[138,"i"],[75,"i"],[91,"i"],[108,"i"],[103,"i"],[114,"i"],[14,"i"],[93,"o"],[138,"o"],"\x3A"=>[75,"o"],"\x3B"=>[91,"o"],"\x3C"=>[108,"o"],"\x3D"=>[103,"o"],"\x3E"=>[114,"o"],"\x3F"=>[14,"o"],"\x40"=>[93,"s"],"A"=>[138,"s"],"B"=>[75,"s"],"C"=>[91,"s"],"D"=>[108,"s"],"E"=>[103,"s"],"F"=>[114,"s"],"G"=>[14,"s"],"H"=>[93,"t"],"I"=>[138,"t"],"J"=>[75,"t"],"K"=>[91,"t"],"L"=>[108,"t"],"M"=>[103,"t"],"N"=>[114,"t"],"O"=>[14,"t"],"P"=>[94,"\x20"],"Q"=>[76,"\x20"],"R"=>[104,"\x20"],"S"=>[16,"\x20"],"T"=>[94,"\x25"],"U"=>[76,"\x25"],"V"=>[104,"\x25"],"W"=>[16,"\x25"],"X"=>[94,"-"],"Y"=>[76,"-"],"Z"=>[104,"-"],"\x5B"=>[16,"-"],"\x5C"=>[94,"."],"\x5D"=>[76,"."],"\x5E"=>[104,"."],"_"=>[16,"."],"\x60"=>[94,"\x2F"],"a"=>[76,"\x2F"],"b"=>[104,"\x2F"],"c"=>[16,"\x2F"],"d"=>[94,"3"],"e"=>[76,"3"],"f"=>[104,"3"],"g"=>[16,"3"],"h"=>[94,"4"],"i"=>[76,"4"],"j"=>[104,"4"],"k"=>[16,"4"],"l"=>[94,"5"],"m"=>[76,"5"],"n"=>[104,"5"],"o"=>[16,"5"],"p"=>[94,"6"],"q"=>[76,"6"],"r"=>[104,"6"],"s"=>[16,"6"],"t"=>[94,"7"],"u"=>[76,"7"],"v"=>[104,"7"],"w"=>[16,"7"],"x"=>[94,"8"],"y"=>[76,"8"],"z"=>[104,"8"],"\x7B"=>[16,"8"],"\x7C"=>[94,"9"],"\x7D"=>[76,"9"],"~"=>[104,"9"],"\x7F"=>[16,"9"],"\x80"=>[94,"\x3D"],"\x81"=>[76,"\x3D"],"\x82"=>[104,"\x3D"],"\x83"=>[16,"\x3D"],"\x84"=>[94,"A"],"\x85"=>[76,"A"],"\x86"=>[104,"A"],"\x87"=>[16,"A"],"\x88"=>[94,"_"],"\x89"=>[76,"_"],"\x8A"=>[104,"_"],"\x8B"=>[16,"_"],"\x8C"=>[94,"b"],"\x8D"=>[76,"b"],"\x8E"=>[104,"b"],"\x8F"=>[16,"b"],"\x90"=>[94,"d"],"\x91"=>[76,"d"],"\x92"=>[104,"d"],"\x93"=>[16,"d"],"\x94"=>[94,"f"],"\x95"=>[76,"f"],"\x96"=>[104,"f"],"\x97"=>[16,"f"],"\x98"=>[94,"g"],"\x99"=>[76,"g"],"\x9A"=>[104,"g"],"\x9B"=>[16,"g"],"\x9C"=>[94,"h"],"\x9D"=>[76,"h"],"\x9E"=>[104,"h"],"\x9F"=>[16,"h"],"\xA0"=>[94,"l"],"\xA1"=>[76,"l"],"\xA2"=>[104,"l"],"\xA3"=>[16,"l"],"\xA4"=>[94,"m"],"\xA5"=>[76,"m"],"\xA6"=>[104,"m"],"\xA7"=>[16,"m"],"\xA8"=>[94,"n"],"\xA9"=>[76,"n"],"\xAA"=>[104,"n"],"\xAB"=>[16,"n"],"\xAC"=>[94,"p"],"\xAD"=>[76,"p"],"\xAE"=>[104,"p"],"\xAF"=>[16,"p"],"\xB0"=>[94,"r"],"\xB1"=>[76,"r"],"\xB2"=>[104,"r"],"\xB3"=>[16,"r"],"\xB4"=>[94,"u"],"\xB5"=>[76,"u"],"\xB6"=>[104,"u"],"\xB7"=>[16,"u"],"\xB8"=>[77,"\x3A"],"\xB9"=>[18,"\x3A"],"\xBA"=>[77,"B"],"\xBB"=>[18,"B"],"\xBC"=>[77,"C"],"\xBD"=>[18,"C"],"\xBE"=>[77,"D"],"\xBF"=>[18,"D"],"\xC0"=>[77,"E"],"\xC1"=>[18,"E"],"\xC2"=>[77,"F"],"\xC3"=>[18,"F"],"\xC4"=>[77,"G"],"\xC5"=>[18,"G"],"\xC6"=>[77,"H"],"\xC7"=>[18,"H"],"\xC8"=>[77,"I"],"\xC9"=>[18,"I"],"\xCA"=>[77,"J"],"\xCB"=>[18,"J"],"\xCC"=>[77,"K"],"\xCD"=>[18,"K"],"\xCE"=>[77,"L"],"\xCF"=>[18,"L"],"\xD0"=>[77,"M"],"\xD1"=>[18,"M"],"\xD2"=>[77,"N"],"\xD3"=>[18,"N"],"\xD4"=>[77,"O"],"\xD5"=>[18,"O"],"\xD6"=>[77,"P"],"\xD7"=>[18,"P"],"\xD8"=>[77,"Q"],"\xD9"=>[18,"Q"],"\xDA"=>[77,"R"],"\xDB"=>[18,"R"],"\xDC"=>[77,"S"],"\xDD"=>[18,"S"],"\xDE"=>[77,"T"],"\xDF"=>[18,"T"],"\xE0"=>[77,"U"],"\xE1"=>[18,"U"],"\xE2"=>[77,"V"],"\xE3"=>[18,"V"],"\xE4"=>[77,"W"],"\xE5"=>[18,"W"],"\xE6"=>[77,"Y"],"\xE7"=>[18,"Y"],"\xE8"=>[77,"j"],"\xE9"=>[18,"j"],"\xEA"=>[77,"k"],"\xEB"=>[18,"k"],"\xEC"=>[77,"q"],"\xED"=>[18,"q"],"\xEE"=>[77,"v"],"\xEF"=>[18,"v"],"\xF0"=>[77,"w"],"\xF1"=>[18,"w"],"\xF2"=>[77,"x"],"\xF3"=>[18,"x"],"\xF4"=>[77,"y"],"\xF5"=>[18,"y"],"\xF6"=>[77,"z"],"\xF7"=>[18,"z"],"\xF8"=>[0,"\x26"],"\xF9"=>[0,"\x2A"],"\xFA"=>[0,"\x2C"],"\xFB"=>[0,"\x3B"],"\xFC"=>[0,"X"],"\xFD"=>[0,"Z"],"\xFE"=>[78,null],"\xFF"=>[8,null],],8=>["\x00"=>[77,"\x3F0"],"\x01"=>[18,"\x3F0"],"\x02"=>[77,"\x3F1"],"\x03"=>[18,"\x3F1"],"\x04"=>[77,"\x3F2"],"\x05"=>[18,"\x3F2"],"\x06"=>[77,"\x3Fa"],"\x07"=>[18,"\x3Fa"],"\x08"=>[77,"\x3Fc"],"\x09"=>[18,"\x3Fc"],"\x0A"=>[77,"\x3Fe"],"\x0B"=>[18,"\x3Fe"],"\x0C"=>[77,"\x3Fi"],"\x0D"=>[18,"\x3Fi"],"\x0E"=>[77,"\x3Fo"],"\x0F"=>[18,"\x3Fo"],"\x10"=>[77,"\x3Fs"],"\x11"=>[18,"\x3Fs"],"\x12"=>[77,"\x3Ft"],"\x13"=>[18,"\x3Ft"],"\x14"=>[0,"\x3F\x20"],"\x15"=>[0,"\x3F\x25"],"\x16"=>[0,"\x3F-"],"\x17"=>[0,"\x3F."],"\x18"=>[0,"\x3F\x2F"],"\x19"=>[0,"\x3F3"],"\x1A"=>[0,"\x3F4"],"\x1B"=>[0,"\x3F5"],"\x1C"=>[0,"\x3F6"],"\x1D"=>[0,"\x3F7"],"\x1E"=>[0,"\x3F8"],"\x1F"=>[0,"\x3F9"],"\x20"=>[0,"\x3F\x3D"],"\x21"=>[0,"\x3FA"],"\x22"=>[0,"\x3F_"],"\x23"=>[0,"\x3Fb"],"\x24"=>[0,"\x3Fd"],"\x25"=>[0,"\x3Ff"],"\x26"=>[0,"\x3Fg"],"\x27"=>[0,"\x3Fh"],"\x28"=>[0,"\x3Fl"],"\x29"=>[0,"\x3Fm"],"\x2A"=>[0,"\x3Fn"],"\x2B"=>[0,"\x3Fp"],"\x2C"=>[0,"\x3Fr"],"-"=>[0,"\x3Fu"],"."=>[100,"\x3F"],"\x2F"=>[110,"\x3F"],[111,"\x3F"],[115,"\x3F"],[116,"\x3F"],[118,"\x3F"],[119,"\x3F"],[122,"\x3F"],[123,"\x3F"],[125,"\x3F"],[126,"\x3F"],[129,"\x3F"],"\x3A"=>[143,"\x3F"],"\x3B"=>[148,"\x3F"],"\x3C"=>[151,"\x3F"],"\x3D"=>[153,"\x3F"],"\x3E"=>[83,"\x3F"],"\x3F"=>[10,"\x3F"],"\x40"=>[0,"\x270"],"A"=>[0,"\x271"],"B"=>[0,"\x272"],"C"=>[0,"\x27a"],"D"=>[0,"\x27c"],"E"=>[0,"\x27e"],"F"=>[0,"\x27i"],"G"=>[0,"\x27o"],"H"=>[0,"\x27s"],"I"=>[0,"\x27t"],"J"=>[73,"\x27"],"K"=>[88,"\x27"],"L"=>[89,"\x27"],"M"=>[96,"\x27"],"N"=>[97,"\x27"],"O"=>[99,"\x27"],"P"=>[106,"\x27"],"Q"=>[136,"\x27"],"R"=>[139,"\x27"],"S"=>[141,"\x27"],"T"=>[145,"\x27"],"U"=>[147,"\x27"],"V"=>[149,"\x27"],"W"=>[101,"\x27"],"X"=>[112,"\x27"],"Y"=>[117,"\x27"],"Z"=>[120,"\x27"],"\x5B"=>[124,"\x27"],"\x5C"=>[127,"\x27"],"\x5D"=>[144,"\x27"],"\x5E"=>[152,"\x27"],"_"=>[11,"\x27"],"\x60"=>[0,"\x2B0"],"a"=>[0,"\x2B1"],"b"=>[0,"\x2B2"],"c"=>[0,"\x2Ba"],"d"=>[0,"\x2Bc"],"e"=>[0,"\x2Be"],"f"=>[0,"\x2Bi"],"g"=>[0,"\x2Bo"],"h"=>[0,"\x2Bs"],"i"=>[0,"\x2Bt"],"j"=>[73,"\x2B"],"k"=>[88,"\x2B"],"l"=>[89,"\x2B"],"m"=>[96,"\x2B"],"n"=>[97,"\x2B"],"o"=>[99,"\x2B"],"p"=>[106,"\x2B"],"q"=>[136,"\x2B"],"r"=>[139,"\x2B"],"s"=>[141,"\x2B"],"t"=>[145,"\x2B"],"u"=>[147,"\x2B"],"v"=>[149,"\x2B"],"w"=>[101,"\x2B"],"x"=>[112,"\x2B"],"y"=>[117,"\x2B"],"z"=>[120,"\x2B"],"\x7B"=>[124,"\x2B"],"\x7C"=>[127,"\x2B"],"\x7D"=>[144,"\x2B"],"~"=>[152,"\x2B"],"\x7F"=>[11,"\x2B"],"\x80"=>[0,"\x7C0"],"\x81"=>[0,"\x7C1"],"\x82"=>[0,"\x7C2"],"\x83"=>[0,"\x7Ca"],"\x84"=>[0,"\x7Cc"],"\x85"=>[0,"\x7Ce"],"\x86"=>[0,"\x7Ci"],"\x87"=>[0,"\x7Co"],"\x88"=>[0,"\x7Cs"],"\x89"=>[0,"\x7Ct"],"\x8A"=>[73,"\x7C"],"\x8B"=>[88,"\x7C"],"\x8C"=>[89,"\x7C"],"\x8D"=>[96,"\x7C"],"\x8E"=>[97,"\x7C"],"\x8F"=>[99,"\x7C"],"\x90"=>[106,"\x7C"],"\x91"=>[136,"\x7C"],"\x92"=>[139,"\x7C"],"\x93"=>[141,"\x7C"],"\x94"=>[145,"\x7C"],"\x95"=>[147,"\x7C"],"\x96"=>[149,"\x7C"],"\x97"=>[101,"\x7C"],"\x98"=>[112,"\x7C"],"\x99"=>[117,"\x7C"],"\x9A"=>[120,"\x7C"],"\x9B"=>[124,"\x7C"],"\x9C"=>[127,"\x7C"],"\x9D"=>[144,"\x7C"],"\x9E"=>[152,"\x7C"],"\x9F"=>[11,"\x7C"],"\xA0"=>[92,"\x23"],"\xA1"=>[95,"\x23"],"\xA2"=>[137,"\x23"],"\xA3"=>[142,"\x23"],"\xA4"=>[150,"\x23"],"\xA5"=>[74,"\x23"],"\xA6"=>[90,"\x23"],"\xA7"=>[98,"\x23"],"\xA8"=>[107,"\x23"],"\xA9"=>[140,"\x23"],"\xAA"=>[146,"\x23"],"\xAB"=>[102,"\x23"],"\xAC"=>[113,"\x23"],"\xAD"=>[121,"\x23"],"\xAE"=>[128,"\x23"],"\xAF"=>[12,"\x23"],"\xB0"=>[92,"\x3E"],"\xB1"=>[95,"\x3E"],"\xB2"=>[137,"\x3E"],"\xB3"=>[142,"\x3E"],"\xB4"=>[150,"\x3E"],"\xB5"=>[74,"\x3E"],"\xB6"=>[90,"\x3E"],"\xB7"=>[98,"\x3E"],"\xB8"=>[107,"\x3E"],"\xB9"=>[140,"\x3E"],"\xBA"=>[146,"\x3E"],"\xBB"=>[102,"\x3E"],"\xBC"=>[113,"\x3E"],"\xBD"=>[121,"\x3E"],"\xBE"=>[128,"\x3E"],"\xBF"=>[12,"\x3E"],"\xC0"=>[93,"\x00"],"\xC1"=>[138,"\x00"],"\xC2"=>[75,"\x00"],"\xC3"=>[91,"\x00"],"\xC4"=>[108,"\x00"],"\xC5"=>[103,"\x00"],"\xC6"=>[114,"\x00"],"\xC7"=>[14,"\x00"],"\xC8"=>[93,"\x24"],"\xC9"=>[138,"\x24"],"\xCA"=>[75,"\x24"],"\xCB"=>[91,"\x24"],"\xCC"=>[108,"\x24"],"\xCD"=>[103,"\x24"],"\xCE"=>[114,"\x24"],"\xCF"=>[14,"\x24"],"\xD0"=>[93,"\x40"],"\xD1"=>[138,"\x40"],"\xD2"=>[75,"\x40"],"\xD3"=>[91,"\x40"],"\xD4"=>[108,"\x40"],"\xD5"=>[103,"\x40"],"\xD6"=>[114,"\x40"],"\xD7"=>[14,"\x40"],"\xD8"=>[93,"\x5B"],"\xD9"=>[138,"\x5B"],"\xDA"=>[75,"\x5B"],"\xDB"=>[91,"\x5B"],"\xDC"=>[108,"\x5B"],"\xDD"=>[103,"\x5B"],"\xDE"=>[114,"\x5B"],"\xDF"=>[14,"\x5B"],"\xE0"=>[93,"\x5D"],"\xE1"=>[138,"\x5D"],"\xE2"=>[75,"\x5D"],"\xE3"=>[91,"\x5D"],"\xE4"=>[108,"\x5D"],"\xE5"=>[103,"\x5D"],"\xE6"=>[114,"\x5D"],"\xE7"=>[14,"\x5D"],"\xE8"=>[93,"~"],"\xE9"=>[138,"~"],"\xEA"=>[75,"~"],"\xEB"=>[91,"~"],"\xEC"=>[108,"~"],"\xED"=>[103,"~"],"\xEE"=>[114,"~"],"\xEF"=>[14,"~"],"\xF0"=>[94,"\x5E"],"\xF1"=>[76,"\x5E"],"\xF2"=>[104,"\x5E"],"\xF3"=>[16,"\x5E"],"\xF4"=>[94,"\x7D"],"\xF5"=>[76,"\x7D"],"\xF6"=>[104,"\x7D"],"\xF7"=>[16,"\x7D"],"\xF8"=>[77,"\x3C"],"\xF9"=>[18,"\x3C"],"\xFA"=>[77,"\x60"],"\xFB"=>[18,"\x60"],"\xFC"=>[77,"\x7B"],"\xFD"=>[18,"\x7B"],"\xFE"=>[131,null],"\xFF"=>[20,null],],["\x00"=>[0,"\x210"],"\x01"=>[0,"\x211"],"\x02"=>[0,"\x212"],"\x03"=>[0,"\x21a"],"\x04"=>[0,"\x21c"],"\x05"=>[0,"\x21e"],"\x06"=>[0,"\x21i"],"\x07"=>[0,"\x21o"],"\x08"=>[0,"\x21s"],"\x09"=>[0,"\x21t"],"\x0A"=>[73,"\x21"],"\x0B"=>[88,"\x21"],"\x0C"=>[89,"\x21"],"\x0D"=>[96,"\x21"],"\x0E"=>[97,"\x21"],"\x0F"=>[99,"\x21"],"\x10"=>[106,"\x21"],"\x11"=>[136,"\x21"],"\x12"=>[139,"\x21"],"\x13"=>[141,"\x21"],"\x14"=>[145,"\x21"],"\x15"=>[147,"\x21"],"\x16"=>[149,"\x21"],"\x17"=>[101,"\x21"],"\x18"=>[112,"\x21"],"\x19"=>[117,"\x21"],"\x1A"=>[120,"\x21"],"\x1B"=>[124,"\x21"],"\x1C"=>[127,"\x21"],"\x1D"=>[144,"\x21"],"\x1E"=>[152,"\x21"],"\x1F"=>[11,"\x21"],"\x20"=>[0,"\x220"],"\x21"=>[0,"\x221"],"\x22"=>[0,"\x222"],"\x23"=>[0,"\x22a"],"\x24"=>[0,"\x22c"],"\x25"=>[0,"\x22e"],"\x26"=>[0,"\x22i"],"\x27"=>[0,"\x22o"],"\x28"=>[0,"\x22s"],"\x29"=>[0,"\x22t"],"\x2A"=>[73,"\x22"],"\x2B"=>[88,"\x22"],"\x2C"=>[89,"\x22"],"-"=>[96,"\x22"],"."=>[97,"\x22"],"\x2F"=>[99,"\x22"],[106,"\x22"],[136,"\x22"],[139,"\x22"],[141,"\x22"],[145,"\x22"],[147,"\x22"],[149,"\x22"],[101,"\x22"],[112,"\x22"],[117,"\x22"],"\x3A"=>[120,"\x22"],"\x3B"=>[124,"\x22"],"\x3C"=>[127,"\x22"],"\x3D"=>[144,"\x22"],"\x3E"=>[152,"\x22"],"\x3F"=>[11,"\x22"],"\x40"=>[0,"\x280"],"A"=>[0,"\x281"],"B"=>[0,"\x282"],"C"=>[0,"\x28a"],"D"=>[0,"\x28c"],"E"=>[0,"\x28e"],"F"=>[0,"\x28i"],"G"=>[0,"\x28o"],"H"=>[0,"\x28s"],"I"=>[0,"\x28t"],"J"=>[73,"\x28"],"K"=>[88,"\x28"],"L"=>[89,"\x28"],"M"=>[96,"\x28"],"N"=>[97,"\x28"],"O"=>[99,"\x28"],"P"=>[106,"\x28"],"Q"=>[136,"\x28"],"R"=>[139,"\x28"],"S"=>[141,"\x28"],"T"=>[145,"\x28"],"U"=>[147,"\x28"],"V"=>[149,"\x28"],"W"=>[101,"\x28"],"X"=>[112,"\x28"],"Y"=>[117,"\x28"],"Z"=>[120,"\x28"],"\x5B"=>[124,"\x28"],"\x5C"=>[127,"\x28"],"\x5D"=>[144,"\x28"],"\x5E"=>[152,"\x28"],"_"=>[11,"\x28"],"\x60"=>[0,"\x290"],"a"=>[0,"\x291"],"b"=>[0,"\x292"],"c"=>[0,"\x29a"],"d"=>[0,"\x29c"],"e"=>[0,"\x29e"],"f"=>[0,"\x29i"],"g"=>[0,"\x29o"],"h"=>[0,"\x29s"],"i"=>[0,"\x29t"],"j"=>[73,"\x29"],"k"=>[88,"\x29"],"l"=>[89,"\x29"],"m"=>[96,"\x29"],"n"=>[97,"\x29"],"o"=>[99,"\x29"],"p"=>[106,"\x29"],"q"=>[136,"\x29"],"r"=>[139,"\x29"],"s"=>[141,"\x29"],"t"=>[145,"\x29"],"u"=>[147,"\x29"],"v"=>[149,"\x29"],"w"=>[101,"\x29"],"x"=>[112,"\x29"],"y"=>[117,"\x29"],"z"=>[120,"\x29"],"\x7B"=>[124,"\x29"],"\x7C"=>[127,"\x29"],"\x7D"=>[144,"\x29"],"~"=>[152,"\x29"],"\x7F"=>[11,"\x29"],"\x80"=>[0,"\x3F0"],"\x81"=>[0,"\x3F1"],"\x82"=>[0,"\x3F2"],"\x83"=>[0,"\x3Fa"],"\x84"=>[0,"\x3Fc"],"\x85"=>[0,"\x3Fe"],"\x86"=>[0,"\x3Fi"],"\x87"=>[0,"\x3Fo"],"\x88"=>[0,"\x3Fs"],"\x89"=>[0,"\x3Ft"],"\x8A"=>[73,"\x3F"],"\x8B"=>[88,"\x3F"],"\x8C"=>[89,"\x3F"],"\x8D"=>[96,"\x3F"],"\x8E"=>[97,"\x3F"],"\x8F"=>[99,"\x3F"],"\x90"=>[106,"\x3F"],"\x91"=>[136,"\x3F"],"\x92"=>[139,"\x3F"],"\x93"=>[141,"\x3F"],"\x94"=>[145,"\x3F"],"\x95"=>[147,"\x3F"],"\x96"=>[149,"\x3F"],"\x97"=>[101,"\x3F"],"\x98"=>[112,"\x3F"],"\x99"=>[117,"\x3F"],"\x9A"=>[120,"\x3F"],"\x9B"=>[124,"\x3F"],"\x9C"=>[127,"\x3F"],"\x9D"=>[144,"\x3F"],"\x9E"=>[152,"\x3F"],"\x9F"=>[11,"\x3F"],"\xA0"=>[92,"\x27"],"\xA1"=>[95,"\x27"],"\xA2"=>[137,"\x27"],"\xA3"=>[142,"\x27"],"\xA4"=>[150,"\x27"],"\xA5"=>[74,"\x27"],"\xA6"=>[90,"\x27"],"\xA7"=>[98,"\x27"],"\xA8"=>[107,"\x27"],"\xA9"=>[140,"\x27"],"\xAA"=>[146,"\x27"],"\xAB"=>[102,"\x27"],"\xAC"=>[113,"\x27"],"\xAD"=>[121,"\x27"],"\xAE"=>[128,"\x27"],"\xAF"=>[12,"\x27"],"\xB0"=>[92,"\x2B"],"\xB1"=>[95,"\x2B"],"\xB2"=>[137,"\x2B"],"\xB3"=>[142,"\x2B"],"\xB4"=>[150,"\x2B"],"\xB5"=>[74,"\x2B"],"\xB6"=>[90,"\x2B"],"\xB7"=>[98,"\x2B"],"\xB8"=>[107,"\x2B"],"\xB9"=>[140,"\x2B"],"\xBA"=>[146,"\x2B"],"\xBB"=>[102,"\x2B"],"\xBC"=>[113,"\x2B"],"\xBD"=>[121,"\x2B"],"\xBE"=>[128,"\x2B"],"\xBF"=>[12,"\x2B"],"\xC0"=>[92,"\x7C"],"\xC1"=>[95,"\x7C"],"\xC2"=>[137,"\x7C"],"\xC3"=>[142,"\x7C"],"\xC4"=>[150,"\x7C"],"\xC5"=>[74,"\x7C"],"\xC6"=>[90,"\x7C"],"\xC7"=>[98,"\x7C"],"\xC8"=>[107,"\x7C"],"\xC9"=>[140,"\x7C"],"\xCA"=>[146,"\x7C"],"\xCB"=>[102,"\x7C"],"\xCC"=>[113,"\x7C"],"\xCD"=>[121,"\x7C"],"\xCE"=>[128,"\x7C"],"\xCF"=>[12,"\x7C"],"\xD0"=>[93,"\x23"],"\xD1"=>[138,"\x23"],"\xD2"=>[75,"\x23"],"\xD3"=>[91,"\x23"],"\xD4"=>[108,"\x23"],"\xD5"=>[103,"\x23"],"\xD6"=>[114,"\x23"],"\xD7"=>[14,"\x23"],"\xD8"=>[93,"\x3E"],"\xD9"=>[138,"\x3E"],"\xDA"=>[75,"\x3E"],"\xDB"=>[91,"\x3E"],"\xDC"=>[108,"\x3E"],"\xDD"=>[103,"\x3E"],"\xDE"=>[114,"\x3E"],"\xDF"=>[14,"\x3E"],"\xE0"=>[94,"\x00"],"\xE1"=>[76,"\x00"],"\xE2"=>[104,"\x00"],"\xE3"=>[16,"\x00"],"\xE4"=>[94,"\x24"],"\xE5"=>[76,"\x24"],"\xE6"=>[104,"\x24"],"\xE7"=>[16,"\x24"],"\xE8"=>[94,"\x40"],"\xE9"=>[76,"\x40"],"\xEA"=>[104,"\x40"],"\xEB"=>[16,"\x40"],"\xEC"=>[94,"\x5B"],"\xED"=>[76,"\x5B"],"\xEE"=>[104,"\x5B"],"\xEF"=>[16,"\x5B"],"\xF0"=>[94,"\x5D"],"\xF1"=>[76,"\x5D"],"\xF2"=>[104,"\x5D"],"\xF3"=>[16,"\x5D"],"\xF4"=>[94,"~"],"\xF5"=>[76,"~"],"\xF6"=>[104,"~"],"\xF7"=>[16,"~"],"\xF8"=>[77,"\x5E"],"\xF9"=>[18,"\x5E"],"\xFA"=>[77,"\x7D"],"\xFB"=>[18,"\x7D"],"\xFC"=>[0,"\x3C"],"\xFD"=>[0,"\x60"],"\xFE"=>[0,"\x7B"],"\xFF"=>[21,null],],["\x00"=>[77,"X0"],"\x01"=>[18,"X0"],"\x02"=>[77,"X1"],"\x03"=>[18,"X1"],"\x04"=>[77,"X2"],"\x05"=>[18,"X2"],"\x06"=>[77,"Xa"],"\x07"=>[18,"Xa"],"\x08"=>[77,"Xc"],"\x09"=>[18,"Xc"],"\x0A"=>[77,"Xe"],"\x0B"=>[18,"Xe"],"\x0C"=>[77,"Xi"],"\x0D"=>[18,"Xi"],"\x0E"=>[77,"Xo"],"\x0F"=>[18,"Xo"],"\x10"=>[77,"Xs"],"\x11"=>[18,"Xs"],"\x12"=>[77,"Xt"],"\x13"=>[18,"Xt"],"\x14"=>[0,"X\x20"],"\x15"=>[0,"X\x25"],"\x16"=>[0,"X-"],"\x17"=>[0,"X."],"\x18"=>[0,"X\x2F"],"\x19"=>[0,"X3"],"\x1A"=>[0,"X4"],"\x1B"=>[0,"X5"],"\x1C"=>[0,"X6"],"\x1D"=>[0,"X7"],"\x1E"=>[0,"X8"],"\x1F"=>[0,"X9"],"\x20"=>[0,"X\x3D"],"\x21"=>[0,"XA"],"\x22"=>[0,"X_"],"\x23"=>[0,"Xb"],"\x24"=>[0,"Xd"],"\x25"=>[0,"Xf"],"\x26"=>[0,"Xg"],"\x27"=>[0,"Xh"],"\x28"=>[0,"Xl"],"\x29"=>[0,"Xm"],"\x2A"=>[0,"Xn"],"\x2B"=>[0,"Xp"],"\x2C"=>[0,"Xr"],"-"=>[0,"Xu"],"."=>[100,"X"],"\x2F"=>[110,"X"],[111,"X"],[115,"X"],[116,"X"],[118,"X"],[119,"X"],[122,"X"],[123,"X"],[125,"X"],[126,"X"],[129,"X"],"\x3A"=>[143,"X"],"\x3B"=>[148,"X"],"\x3C"=>[151,"X"],"\x3D"=>[153,"X"],"\x3E"=>[83,"X"],"\x3F"=>[10,"X"],"\x40"=>[77,"Z0"],"A"=>[18,"Z0"],"B"=>[77,"Z1"],"C"=>[18,"Z1"],"D"=>[77,"Z2"],"E"=>[18,"Z2"],"F"=>[77,"Za"],"G"=>[18,"Za"],"H"=>[77,"Zc"],"I"=>[18,"Zc"],"J"=>[77,"Ze"],"K"=>[18,"Ze"],"L"=>[77,"Zi"],"M"=>[18,"Zi"],"N"=>[77,"Zo"],"O"=>[18,"Zo"],"P"=>[77,"Zs"],"Q"=>[18,"Zs"],"R"=>[77,"Zt"],"S"=>[18,"Zt"],"T"=>[0,"Z\x20"],"U"=>[0,"Z\x25"],"V"=>[0,"Z-"],"W"=>[0,"Z."],"X"=>[0,"Z\x2F"],"Y"=>[0,"Z3"],"Z"=>[0,"Z4"],"\x5B"=>[0,"Z5"],"\x5C"=>[0,"Z6"],"\x5D"=>[0,"Z7"],"\x5E"=>[0,"Z8"],"_"=>[0,"Z9"],"\x60"=>[0,"Z\x3D"],"a"=>[0,"ZA"],"b"=>[0,"Z_"],"c"=>[0,"Zb"],"d"=>[0,"Zd"],"e"=>[0,"Zf"],"f"=>[0,"Zg"],"g"=>[0,"Zh"],"h"=>[0,"Zl"],"i"=>[0,"Zm"],"j"=>[0,"Zn"],"k"=>[0,"Zp"],"l"=>[0,"Zr"],"m"=>[0,"Zu"],"n"=>[100,"Z"],"o"=>[110,"Z"],"p"=>[111,"Z"],"q"=>[115,"Z"],"r"=>[116,"Z"],"s"=>[118,"Z"],"t"=>[119,"Z"],"u"=>[122,"Z"],"v"=>[123,"Z"],"w"=>[125,"Z"],"x"=>[126,"Z"],"y"=>[129,"Z"],"z"=>[143,"Z"],"\x7B"=>[148,"Z"],"\x7C"=>[151,"Z"],"\x7D"=>[153,"Z"],"~"=>[83,"Z"],"\x7F"=>[10,"Z"],"\x80"=>[92,"\x21"],"\x81"=>[95,"\x21"],"\x82"=>[137,"\x21"],"\x83"=>[142,"\x21"],"\x84"=>[150,"\x21"],"\x85"=>[74,"\x21"],"\x86"=>[90,"\x21"],"\x87"=>[98,"\x21"],"\x88"=>[107,"\x21"],"\x89"=>[140,"\x21"],"\x8A"=>[146,"\x21"],"\x8B"=>[102,"\x21"],"\x8C"=>[113,"\x21"],"\x8D"=>[121,"\x21"],"\x8E"=>[128,"\x21"],"\x8F"=>[12,"\x21"],"\x90"=>[92,"\x22"],"\x91"=>[95,"\x22"],"\x92"=>[137,"\x22"],"\x93"=>[142,"\x22"],"\x94"=>[150,"\x22"],"\x95"=>[74,"\x22"],"\x96"=>[90,"\x22"],"\x97"=>[98,"\x22"],"\x98"=>[107,"\x22"],"\x99"=>[140,"\x22"],"\x9A"=>[146,"\x22"],"\x9B"=>[102,"\x22"],"\x9C"=>[113,"\x22"],"\x9D"=>[121,"\x22"],"\x9E"=>[128,"\x22"],"\x9F"=>[12,"\x22"],"\xA0"=>[92,"\x28"],"\xA1"=>[95,"\x28"],"\xA2"=>[137,"\x28"],"\xA3"=>[142,"\x28"],"\xA4"=>[150,"\x28"],"\xA5"=>[74,"\x28"],"\xA6"=>[90,"\x28"],"\xA7"=>[98,"\x28"],"\xA8"=>[107,"\x28"],"\xA9"=>[140,"\x28"],"\xAA"=>[146,"\x28"],"\xAB"=>[102,"\x28"],"\xAC"=>[113,"\x28"],"\xAD"=>[121,"\x28"],"\xAE"=>[128,"\x28"],"\xAF"=>[12,"\x28"],"\xB0"=>[92,"\x29"],"\xB1"=>[95,"\x29"],"\xB2"=>[137,"\x29"],"\xB3"=>[142,"\x29"],"\xB4"=>[150,"\x29"],"\xB5"=>[74,"\x29"],"\xB6"=>[90,"\x29"],"\xB7"=>[98,"\x29"],"\xB8"=>[107,"\x29"],"\xB9"=>[140,"\x29"],"\xBA"=>[146,"\x29"],"\xBB"=>[102,"\x29"],"\xBC"=>[113,"\x29"],"\xBD"=>[121,"\x29"],"\xBE"=>[128,"\x29"],"\xBF"=>[12,"\x29"],"\xC0"=>[92,"\x3F"],"\xC1"=>[95,"\x3F"],"\xC2"=>[137,"\x3F"],"\xC3"=>[142,"\x3F"],"\xC4"=>[150,"\x3F"],"\xC5"=>[74,"\x3F"],"\xC6"=>[90,"\x3F"],"\xC7"=>[98,"\x3F"],"\xC8"=>[107,"\x3F"],"\xC9"=>[140,"\x3F"],"\xCA"=>[146,"\x3F"],"\xCB"=>[102,"\x3F"],"\xCC"=>[113,"\x3F"],"\xCD"=>[121,"\x3F"],"\xCE"=>[128,"\x3F"],"\xCF"=>[12,"\x3F"],"\xD0"=>[93,"\x27"],"\xD1"=>[138,"\x27"],"\xD2"=>[75,"\x27"],"\xD3"=>[91,"\x27"],"\xD4"=>[108,"\x27"],"\xD5"=>[103,"\x27"],"\xD6"=>[114,"\x27"],"\xD7"=>[14,"\x27"],"\xD8"=>[93,"\x2B"],"\xD9"=>[138,"\x2B"],"\xDA"=>[75,"\x2B"],"\xDB"=>[91,"\x2B"],"\xDC"=>[108,"\x2B"],"\xDD"=>[103,"\x2B"],"\xDE"=>[114,"\x2B"],"\xDF"=>[14,"\x2B"],"\xE0"=>[93,"\x7C"],"\xE1"=>[138,"\x7C"],"\xE2"=>[75,"\x7C"],"\xE3"=>[91,"\x7C"],"\xE4"=>[108,"\x7C"],"\xE5"=>[103,"\x7C"],"\xE6"=>[114,"\x7C"],"\xE7"=>[14,"\x7C"],"\xE8"=>[94,"\x23"],"\xE9"=>[76,"\x23"],"\xEA"=>[104,"\x23"],"\xEB"=>[16,"\x23"],"\xEC"=>[94,"\x3E"],"\xED"=>[76,"\x3E"],"\xEE"=>[104,"\x3E"],"\xEF"=>[16,"\x3E"],"\xF0"=>[77,"\x00"],"\xF1"=>[18,"\x00"],"\xF2"=>[77,"\x24"],"\xF3"=>[18,"\x24"],"\xF4"=>[77,"\x40"],"\xF5"=>[18,"\x40"],"\xF6"=>[77,"\x5B"],"\xF7"=>[18,"\x5B"],"\xF8"=>[77,"\x5D"],"\xF9"=>[18,"\x5D"],"\xFA"=>[77,"~"],"\xFB"=>[18,"~"],"\xFC"=>[0,"\x5E"],"\xFD"=>[0,"\x7D"],"\xFE"=>[105,null],"\xFF"=>[22,null],],["\x00"=>[0,"\x260"],"\x01"=>[0,"\x261"],"\x02"=>[0,"\x262"],"\x03"=>[0,"\x26a"],"\x04"=>[0,"\x26c"],"\x05"=>[0,"\x26e"],"\x06"=>[0,"\x26i"],"\x07"=>[0,"\x26o"],"\x08"=>[0,"\x26s"],"\x09"=>[0,"\x26t"],"\x0A"=>[73,"\x26"],"\x0B"=>[88,"\x26"],"\x0C"=>[89,"\x26"],"\x0D"=>[96,"\x26"],"\x0E"=>[97,"\x26"],"\x0F"=>[99,"\x26"],"\x10"=>[106,"\x26"],"\x11"=>[136,"\x26"],"\x12"=>[139,"\x26"],"\x13"=>[141,"\x26"],"\x14"=>[145,"\x26"],"\x15"=>[147,"\x26"],"\x16"=>[149,"\x26"],"\x17"=>[101,"\x26"],"\x18"=>[112,"\x26"],"\x19"=>[117,"\x26"],"\x1A"=>[120,"\x26"],"\x1B"=>[124,"\x26"],"\x1C"=>[127,"\x26"],"\x1D"=>[144,"\x26"],"\x1E"=>[152,"\x26"],"\x1F"=>[11,"\x26"],"\x20"=>[0,"\x2A0"],"\x21"=>[0,"\x2A1"],"\x22"=>[0,"\x2A2"],"\x23"=>[0,"\x2Aa"],"\x24"=>[0,"\x2Ac"],"\x25"=>[0,"\x2Ae"],"\x26"=>[0,"\x2Ai"],"\x27"=>[0,"\x2Ao"],"\x28"=>[0,"\x2As"],"\x29"=>[0,"\x2At"],"\x2A"=>[73,"\x2A"],"\x2B"=>[88,"\x2A"],"\x2C"=>[89,"\x2A"],"-"=>[96,"\x2A"],"."=>[97,"\x2A"],"\x2F"=>[99,"\x2A"],[106,"\x2A"],[136,"\x2A"],[139,"\x2A"],[141,"\x2A"],[145,"\x2A"],[147,"\x2A"],[149,"\x2A"],[101,"\x2A"],[112,"\x2A"],[117,"\x2A"],"\x3A"=>[120,"\x2A"],"\x3B"=>[124,"\x2A"],"\x3C"=>[127,"\x2A"],"\x3D"=>[144,"\x2A"],"\x3E"=>[152,"\x2A"],"\x3F"=>[11,"\x2A"],"\x40"=>[0,"\x2C0"],"A"=>[0,"\x2C1"],"B"=>[0,"\x2C2"],"C"=>[0,"\x2Ca"],"D"=>[0,"\x2Cc"],"E"=>[0,"\x2Ce"],"F"=>[0,"\x2Ci"],"G"=>[0,"\x2Co"],"H"=>[0,"\x2Cs"],"I"=>[0,"\x2Ct"],"J"=>[73,"\x2C"],"K"=>[88,"\x2C"],"L"=>[89,"\x2C"],"M"=>[96,"\x2C"],"N"=>[97,"\x2C"],"O"=>[99,"\x2C"],"P"=>[106,"\x2C"],"Q"=>[136,"\x2C"],"R"=>[139,"\x2C"],"S"=>[141,"\x2C"],"T"=>[145,"\x2C"],"U"=>[147,"\x2C"],"V"=>[149,"\x2C"],"W"=>[101,"\x2C"],"X"=>[112,"\x2C"],"Y"=>[117,"\x2C"],"Z"=>[120,"\x2C"],"\x5B"=>[124,"\x2C"],"\x5C"=>[127,"\x2C"],"\x5D"=>[144,"\x2C"],"\x5E"=>[152,"\x2C"],"_"=>[11,"\x2C"],"\x60"=>[0,"\x3B0"],"a"=>[0,"\x3B1"],"b"=>[0,"\x3B2"],"c"=>[0,"\x3Ba"],"d"=>[0,"\x3Bc"],"e"=>[0,"\x3Be"],"f"=>[0,"\x3Bi"],"g"=>[0,"\x3Bo"],"h"=>[0,"\x3Bs"],"i"=>[0,"\x3Bt"],"j"=>[73,"\x3B"],"k"=>[88,"\x3B"],"l"=>[89,"\x3B"],"m"=>[96,"\x3B"],"n"=>[97,"\x3B"],"o"=>[99,"\x3B"],"p"=>[106,"\x3B"],"q"=>[136,"\x3B"],"r"=>[139,"\x3B"],"s"=>[141,"\x3B"],"t"=>[145,"\x3B"],"u"=>[147,"\x3B"],"v"=>[149,"\x3B"],"w"=>[101,"\x3B"],"x"=>[112,"\x3B"],"y"=>[117,"\x3B"],"z"=>[120,"\x3B"],"\x7B"=>[124,"\x3B"],"\x7C"=>[127,"\x3B"],"\x7D"=>[144,"\x3B"],"~"=>[152,"\x3B"],"\x7F"=>[11,"\x3B"],"\x80"=>[0,"X0"],"\x81"=>[0,"X1"],"\x82"=>[0,"X2"],"\x83"=>[0,"Xa"],"\x84"=>[0,"Xc"],"\x85"=>[0,"Xe"],"\x86"=>[0,"Xi"],"\x87"=>[0,"Xo"],"\x88"=>[0,"Xs"],"\x89"=>[0,"Xt"],"\x8A"=>[73,"X"],"\x8B"=>[88,"X"],"\x8C"=>[89,"X"],"\x8D"=>[96,"X"],"\x8E"=>[97,"X"],"\x8F"=>[99,"X"],"\x90"=>[106,"X"],"\x91"=>[136,"X"],"\x92"=>[139,"X"],"\x93"=>[141,"X"],"\x94"=>[145,"X"],"\x95"=>[147,"X"],"\x96"=>[149,"X"],"\x97"=>[101,"X"],"\x98"=>[112,"X"],"\x99"=>[117,"X"],"\x9A"=>[120,"X"],"\x9B"=>[124,"X"],"\x9C"=>[127,"X"],"\x9D"=>[144,"X"],"\x9E"=>[152,"X"],"\x9F"=>[11,"X"],"\xA0"=>[0,"Z0"],"\xA1"=>[0,"Z1"],"\xA2"=>[0,"Z2"],"\xA3"=>[0,"Za"],"\xA4"=>[0,"Zc"],"\xA5"=>[0,"Ze"],"\xA6"=>[0,"Zi"],"\xA7"=>[0,"Zo"],"\xA8"=>[0,"Zs"],"\xA9"=>[0,"Zt"],"\xAA"=>[73,"Z"],"\xAB"=>[88,"Z"],"\xAC"=>[89,"Z"],"\xAD"=>[96,"Z"],"\xAE"=>[97,"Z"],"\xAF"=>[99,"Z"],"\xB0"=>[106,"Z"],"\xB1"=>[136,"Z"],"\xB2"=>[139,"Z"],"\xB3"=>[141,"Z"],"\xB4"=>[145,"Z"],"\xB5"=>[147,"Z"],"\xB6"=>[149,"Z"],"\xB7"=>[101,"Z"],"\xB8"=>[112,"Z"],"\xB9"=>[117,"Z"],"\xBA"=>[120,"Z"],"\xBB"=>[124,"Z"],"\xBC"=>[127,"Z"],"\xBD"=>[144,"Z"],"\xBE"=>[152,"Z"],"\xBF"=>[11,"Z"],"\xC0"=>[93,"\x21"],"\xC1"=>[138,"\x21"],"\xC2"=>[75,"\x21"],"\xC3"=>[91,"\x21"],"\xC4"=>[108,"\x21"],"\xC5"=>[103,"\x21"],"\xC6"=>[114,"\x21"],"\xC7"=>[14,"\x21"],"\xC8"=>[93,"\x22"],"\xC9"=>[138,"\x22"],"\xCA"=>[75,"\x22"],"\xCB"=>[91,"\x22"],"\xCC"=>[108,"\x22"],"\xCD"=>[103,"\x22"],"\xCE"=>[114,"\x22"],"\xCF"=>[14,"\x22"],"\xD0"=>[93,"\x28"],"\xD1"=>[138,"\x28"],"\xD2"=>[75,"\x28"],"\xD3"=>[91,"\x28"],"\xD4"=>[108,"\x28"],"\xD5"=>[103,"\x28"],"\xD6"=>[114,"\x28"],"\xD7"=>[14,"\x28"],"\xD8"=>[93,"\x29"],"\xD9"=>[138,"\x29"],"\xDA"=>[75,"\x29"],"\xDB"=>[91,"\x29"],"\xDC"=>[108,"\x29"],"\xDD"=>[103,"\x29"],"\xDE"=>[114,"\x29"],"\xDF"=>[14,"\x29"],"\xE0"=>[93,"\x3F"],"\xE1"=>[138,"\x3F"],"\xE2"=>[75,"\x3F"],"\xE3"=>[91,"\x3F"],"\xE4"=>[108,"\x3F"],"\xE5"=>[103,"\x3F"],"\xE6"=>[114,"\x3F"],"\xE7"=>[14,"\x3F"],"\xE8"=>[94,"\x27"],"\xE9"=>[76,"\x27"],"\xEA"=>[104,"\x27"],"\xEB"=>[16,"\x27"],"\xEC"=>[94,"\x2B"],"\xED"=>[76,"\x2B"],"\xEE"=>[104,"\x2B"],"\xEF"=>[16,"\x2B"],"\xF0"=>[94,"\x7C"],"\xF1"=>[76,"\x7C"],"\xF2"=>[104,"\x7C"],"\xF3"=>[16,"\x7C"],"\xF4"=>[77,"\x23"],"\xF5"=>[18,"\x23"],"\xF6"=>[77,"\x3E"],"\xF7"=>[18,"\x3E"],"\xF8"=>[0,"\x00"],"\xF9"=>[0,"\x24"],"\xFA"=>[0,"\x40"],"\xFB"=>[0,"\x5B"],"\xFC"=>[0,"\x5D"],"\xFD"=>[0,"~"],"\xFE"=>[135,null],"\xFF"=>[24,null],],["\x00"=>[0,"w0"],"\x01"=>[0,"w1"],"\x02"=>[0,"w2"],"\x03"=>[0,"wa"],"\x04"=>[0,"wc"],"\x05"=>[0,"we"],"\x06"=>[0,"wi"],"\x07"=>[0,"wo"],"\x08"=>[0,"ws"],"\x09"=>[0,"wt"],"\x0A"=>[73,"w"],"\x0B"=>[88,"w"],"\x0C"=>[89,"w"],"\x0D"=>[96,"w"],"\x0E"=>[97,"w"],"\x0F"=>[99,"w"],"\x10"=>[106,"w"],"\x11"=>[136,"w"],"\x12"=>[139,"w"],"\x13"=>[141,"w"],"\x14"=>[145,"w"],"\x15"=>[147,"w"],"\x16"=>[149,"w"],"\x17"=>[101,"w"],"\x18"=>[112,"w"],"\x19"=>[117,"w"],"\x1A"=>[120,"w"],"\x1B"=>[124,"w"],"\x1C"=>[127,"w"],"\x1D"=>[144,"w"],"\x1E"=>[152,"w"],"\x1F"=>[11,"w"],"\x20"=>[0,"x0"],"\x21"=>[0,"x1"],"\x22"=>[0,"x2"],"\x23"=>[0,"xa"],"\x24"=>[0,"xc"],"\x25"=>[0,"xe"],"\x26"=>[0,"xi"],"\x27"=>[0,"xo"],"\x28"=>[0,"xs"],"\x29"=>[0,"xt"],"\x2A"=>[73,"x"],"\x2B"=>[88,"x"],"\x2C"=>[89,"x"],"-"=>[96,"x"],"."=>[97,"x"],"\x2F"=>[99,"x"],[106,"x"],[136,"x"],[139,"x"],[141,"x"],[145,"x"],[147,"x"],[149,"x"],[101,"x"],[112,"x"],[117,"x"],"\x3A"=>[120,"x"],"\x3B"=>[124,"x"],"\x3C"=>[127,"x"],"\x3D"=>[144,"x"],"\x3E"=>[152,"x"],"\x3F"=>[11,"x"],"\x40"=>[0,"y0"],"A"=>[0,"y1"],"B"=>[0,"y2"],"C"=>[0,"ya"],"D"=>[0,"yc"],"E"=>[0,"ye"],"F"=>[0,"yi"],"G"=>[0,"yo"],"H"=>[0,"ys"],"I"=>[0,"yt"],"J"=>[73,"y"],"K"=>[88,"y"],"L"=>[89,"y"],"M"=>[96,"y"],"N"=>[97,"y"],"O"=>[99,"y"],"P"=>[106,"y"],"Q"=>[136,"y"],"R"=>[139,"y"],"S"=>[141,"y"],"T"=>[145,"y"],"U"=>[147,"y"],"V"=>[149,"y"],"W"=>[101,"y"],"X"=>[112,"y"],"Y"=>[117,"y"],"Z"=>[120,"y"],"\x5B"=>[124,"y"],"\x5C"=>[127,"y"],"\x5D"=>[144,"y"],"\x5E"=>[152,"y"],"_"=>[11,"y"],"\x60"=>[0,"z0"],"a"=>[0,"z1"],"b"=>[0,"z2"],"c"=>[0,"za"],"d"=>[0,"zc"],"e"=>[0,"ze"],"f"=>[0,"zi"],"g"=>[0,"zo"],"h"=>[0,"zs"],"i"=>[0,"zt"],"j"=>[73,"z"],"k"=>[88,"z"],"l"=>[89,"z"],"m"=>[96,"z"],"n"=>[97,"z"],"o"=>[99,"z"],"p"=>[106,"z"],"q"=>[136,"z"],"r"=>[139,"z"],"s"=>[141,"z"],"t"=>[145,"z"],"u"=>[147,"z"],"v"=>[149,"z"],"w"=>[101,"z"],"x"=>[112,"z"],"y"=>[117,"z"],"z"=>[120,"z"],"\x7B"=>[124,"z"],"\x7C"=>[127,"z"],"\x7D"=>[144,"z"],"~"=>[152,"z"],"\x7F"=>[11,"z"],"\x80"=>[92,"\x26"],"\x81"=>[95,"\x26"],"\x82"=>[137,"\x26"],"\x83"=>[142,"\x26"],"\x84"=>[150,"\x26"],"\x85"=>[74,"\x26"],"\x86"=>[90,"\x26"],"\x87"=>[98,"\x26"],"\x88"=>[107,"\x26"],"\x89"=>[140,"\x26"],"\x8A"=>[146,"\x26"],"\x8B"=>[102,"\x26"],"\x8C"=>[113,"\x26"],"\x8D"=>[121,"\x26"],"\x8E"=>[128,"\x26"],"\x8F"=>[12,"\x26"],"\x90"=>[92,"\x2A"],"\x91"=>[95,"\x2A"],"\x92"=>[137,"\x2A"],"\x93"=>[142,"\x2A"],"\x94"=>[150,"\x2A"],"\x95"=>[74,"\x2A"],"\x96"=>[90,"\x2A"],"\x97"=>[98,"\x2A"],"\x98"=>[107,"\x2A"],"\x99"=>[140,"\x2A"],"\x9A"=>[146,"\x2A"],"\x9B"=>[102,"\x2A"],"\x9C"=>[113,"\x2A"],"\x9D"=>[121,"\x2A"],"\x9E"=>[128,"\x2A"],"\x9F"=>[12,"\x2A"],"\xA0"=>[92,"\x2C"],"\xA1"=>[95,"\x2C"],"\xA2"=>[137,"\x2C"],"\xA3"=>[142,"\x2C"],"\xA4"=>[150,"\x2C"],"\xA5"=>[74,"\x2C"],"\xA6"=>[90,"\x2C"],"\xA7"=>[98,"\x2C"],"\xA8"=>[107,"\x2C"],"\xA9"=>[140,"\x2C"],"\xAA"=>[146,"\x2C"],"\xAB"=>[102,"\x2C"],"\xAC"=>[113,"\x2C"],"\xAD"=>[121,"\x2C"],"\xAE"=>[128,"\x2C"],"\xAF"=>[12,"\x2C"],"\xB0"=>[92,"\x3B"],"\xB1"=>[95,"\x3B"],"\xB2"=>[137,"\x3B"],"\xB3"=>[142,"\x3B"],"\xB4"=>[150,"\x3B"],"\xB5"=>[74,"\x3B"],"\xB6"=>[90,"\x3B"],"\xB7"=>[98,"\x3B"],"\xB8"=>[107,"\x3B"],"\xB9"=>[140,"\x3B"],"\xBA"=>[146,"\x3B"],"\xBB"=>[102,"\x3B"],"\xBC"=>[113,"\x3B"],"\xBD"=>[121,"\x3B"],"\xBE"=>[128,"\x3B"],"\xBF"=>[12,"\x3B"],"\xC0"=>[92,"X"],"\xC1"=>[95,"X"],"\xC2"=>[137,"X"],"\xC3"=>[142,"X"],"\xC4"=>[150,"X"],"\xC5"=>[74,"X"],"\xC6"=>[90,"X"],"\xC7"=>[98,"X"],"\xC8"=>[107,"X"],"\xC9"=>[140,"X"],"\xCA"=>[146,"X"],"\xCB"=>[102,"X"],"\xCC"=>[113,"X"],"\xCD"=>[121,"X"],"\xCE"=>[128,"X"],"\xCF"=>[12,"X"],"\xD0"=>[92,"Z"],"\xD1"=>[95,"Z"],"\xD2"=>[137,"Z"],"\xD3"=>[142,"Z"],"\xD4"=>[150,"Z"],"\xD5"=>[74,"Z"],"\xD6"=>[90,"Z"],"\xD7"=>[98,"Z"],"\xD8"=>[107,"Z"],"\xD9"=>[140,"Z"],"\xDA"=>[146,"Z"],"\xDB"=>[102,"Z"],"\xDC"=>[113,"Z"],"\xDD"=>[121,"Z"],"\xDE"=>[128,"Z"],"\xDF"=>[12,"Z"],"\xE0"=>[94,"\x21"],"\xE1"=>[76,"\x21"],"\xE2"=>[104,"\x21"],"\xE3"=>[16,"\x21"],"\xE4"=>[94,"\x22"],"\xE5"=>[76,"\x22"],"\xE6"=>[104,"\x22"],"\xE7"=>[16,"\x22"],"\xE8"=>[94,"\x28"],"\xE9"=>[76,"\x28"],"\xEA"=>[104,"\x28"],"\xEB"=>[16,"\x28"],"\xEC"=>[94,"\x29"],"\xED"=>[76,"\x29"],"\xEE"=>[104,"\x29"],"\xEF"=>[16,"\x29"],"\xF0"=>[94,"\x3F"],"\xF1"=>[76,"\x3F"],"\xF2"=>[104,"\x3F"],"\xF3"=>[16,"\x3F"],"\xF4"=>[77,"\x27"],"\xF5"=>[18,"\x27"],"\xF6"=>[77,"\x2B"],"\xF7"=>[18,"\x2B"],"\xF8"=>[77,"\x7C"],"\xF9"=>[18,"\x7C"],"\xFA"=>[0,"\x23"],"\xFB"=>[0,"\x3E"],"\xFC"=>[13,null],"\xFD"=>[109,null],"\xFE"=>[134,null],"\xFF"=>[26,null],],["\x00"=>[94,"\x000"],"\x01"=>[76,"\x000"],"\x02"=>[104,"\x000"],"\x03"=>[16,"\x000"],"\x04"=>[94,"\x001"],"\x05"=>[76,"\x001"],"\x06"=>[104,"\x001"],"\x07"=>[16,"\x001"],"\x08"=>[94,"\x002"],"\x09"=>[76,"\x002"],"\x0A"=>[104,"\x002"],"\x0B"=>[16,"\x002"],"\x0C"=>[94,"\x00a"],"\x0D"=>[76,"\x00a"],"\x0E"=>[104,"\x00a"],"\x0F"=>[16,"\x00a"],"\x10"=>[94,"\x00c"],"\x11"=>[76,"\x00c"],"\x12"=>[104,"\x00c"],"\x13"=>[16,"\x00c"],"\x14"=>[94,"\x00e"],"\x15"=>[76,"\x00e"],"\x16"=>[104,"\x00e"],"\x17"=>[16,"\x00e"],"\x18"=>[94,"\x00i"],"\x19"=>[76,"\x00i"],"\x1A"=>[104,"\x00i"],"\x1B"=>[16,"\x00i"],"\x1C"=>[94,"\x00o"],"\x1D"=>[76,"\x00o"],"\x1E"=>[104,"\x00o"],"\x1F"=>[16,"\x00o"],"\x20"=>[94,"\x00s"],"\x21"=>[76,"\x00s"],"\x22"=>[104,"\x00s"],"\x23"=>[16,"\x00s"],"\x24"=>[94,"\x00t"],"\x25"=>[76,"\x00t"],"\x26"=>[104,"\x00t"],"\x27"=>[16,"\x00t"],"\x28"=>[77,"\x00\x20"],"\x29"=>[18,"\x00\x20"],"\x2A"=>[77,"\x00\x25"],"\x2B"=>[18,"\x00\x25"],"\x2C"=>[77,"\x00-"],"-"=>[18,"\x00-"],"."=>[77,"\x00."],"\x2F"=>[18,"\x00."],[77,"\x00\x2F"],[18,"\x00\x2F"],[77,"\x003"],[18,"\x003"],[77,"\x004"],[18,"\x004"],[77,"\x005"],[18,"\x005"],[77,"\x006"],[18,"\x006"],"\x3A"=>[77,"\x007"],"\x3B"=>[18,"\x007"],"\x3C"=>[77,"\x008"],"\x3D"=>[18,"\x008"],"\x3E"=>[77,"\x009"],"\x3F"=>[18,"\x009"],"\x40"=>[77,"\x00\x3D"],"A"=>[18,"\x00\x3D"],"B"=>[77,"\x00A"],"C"=>[18,"\x00A"],"D"=>[77,"\x00_"],"E"=>[18,"\x00_"],"F"=>[77,"\x00b"],"G"=>[18,"\x00b"],"H"=>[77,"\x00d"],"I"=>[18,"\x00d"],"J"=>[77,"\x00f"],"K"=>[18,"\x00f"],"L"=>[77,"\x00g"],"M"=>[18,"\x00g"],"N"=>[77,"\x00h"],"O"=>[18,"\x00h"],"P"=>[77,"\x00l"],"Q"=>[18,"\x00l"],"R"=>[77,"\x00m"],"S"=>[18,"\x00m"],"T"=>[77,"\x00n"],"U"=>[18,"\x00n"],"V"=>[77,"\x00p"],"W"=>[18,"\x00p"],"X"=>[77,"\x00r"],"Y"=>[18,"\x00r"],"Z"=>[77,"\x00u"],"\x5B"=>[18,"\x00u"],"\x5C"=>[0,"\x00\x3A"],"\x5D"=>[0,"\x00B"],"\x5E"=>[0,"\x00C"],"_"=>[0,"\x00D"],"\x60"=>[0,"\x00E"],"a"=>[0,"\x00F"],"b"=>[0,"\x00G"],"c"=>[0,"\x00H"],"d"=>[0,"\x00I"],"e"=>[0,"\x00J"],"f"=>[0,"\x00K"],"g"=>[0,"\x00L"],"h"=>[0,"\x00M"],"i"=>[0,"\x00N"],"j"=>[0,"\x00O"],"k"=>[0,"\x00P"],"l"=>[0,"\x00Q"],"m"=>[0,"\x00R"],"n"=>[0,"\x00S"],"o"=>[0,"\x00T"],"p"=>[0,"\x00U"],"q"=>[0,"\x00V"],"r"=>[0,"\x00W"],"s"=>[0,"\x00Y"],"t"=>[0,"\x00j"],"u"=>[0,"\x00k"],"v"=>[0,"\x00q"],"w"=>[0,"\x00v"],"x"=>[0,"\x00w"],"y"=>[0,"\x00x"],"z"=>[0,"\x00y"],"\x7B"=>[0,"\x00z"],"\x7C"=>[82,"\x00"],"\x7D"=>[87,"\x00"],"~"=>[130,"\x00"],"\x7F"=>[9,"\x00"],"\x80"=>[94,"\x240"],"\x81"=>[76,"\x240"],"\x82"=>[104,"\x240"],"\x83"=>[16,"\x240"],"\x84"=>[94,"\x241"],"\x85"=>[76,"\x241"],"\x86"=>[104,"\x241"],"\x87"=>[16,"\x241"],"\x88"=>[94,"\x242"],"\x89"=>[76,"\x242"],"\x8A"=>[104,"\x242"],"\x8B"=>[16,"\x242"],"\x8C"=>[94,"\x24a"],"\x8D"=>[76,"\x24a"],"\x8E"=>[104,"\x24a"],"\x8F"=>[16,"\x24a"],"\x90"=>[94,"\x24c"],"\x91"=>[76,"\x24c"],"\x92"=>[104,"\x24c"],"\x93"=>[16,"\x24c"],"\x94"=>[94,"\x24e"],"\x95"=>[76,"\x24e"],"\x96"=>[104,"\x24e"],"\x97"=>[16,"\x24e"],"\x98"=>[94,"\x24i"],"\x99"=>[76,"\x24i"],"\x9A"=>[104,"\x24i"],"\x9B"=>[16,"\x24i"],"\x9C"=>[94,"\x24o"],"\x9D"=>[76,"\x24o"],"\x9E"=>[104,"\x24o"],"\x9F"=>[16,"\x24o"],"\xA0"=>[94,"\x24s"],"\xA1"=>[76,"\x24s"],"\xA2"=>[104,"\x24s"],"\xA3"=>[16,"\x24s"],"\xA4"=>[94,"\x24t"],"\xA5"=>[76,"\x24t"],"\xA6"=>[104,"\x24t"],"\xA7"=>[16,"\x24t"],"\xA8"=>[77,"\x24\x20"],"\xA9"=>[18,"\x24\x20"],"\xAA"=>[77,"\x24\x25"],"\xAB"=>[18,"\x24\x25"],"\xAC"=>[77,"\x24-"],"\xAD"=>[18,"\x24-"],"\xAE"=>[77,"\x24."],"\xAF"=>[18,"\x24."],"\xB0"=>[77,"\x24\x2F"],"\xB1"=>[18,"\x24\x2F"],"\xB2"=>[77,"\x243"],"\xB3"=>[18,"\x243"],"\xB4"=>[77,"\x244"],"\xB5"=>[18,"\x244"],"\xB6"=>[77,"\x245"],"\xB7"=>[18,"\x245"],"\xB8"=>[77,"\x246"],"\xB9"=>[18,"\x246"],"\xBA"=>[77,"\x247"],"\xBB"=>[18,"\x247"],"\xBC"=>[77,"\x248"],"\xBD"=>[18,"\x248"],"\xBE"=>[77,"\x249"],"\xBF"=>[18,"\x249"],"\xC0"=>[77,"\x24\x3D"],"\xC1"=>[18,"\x24\x3D"],"\xC2"=>[77,"\x24A"],"\xC3"=>[18,"\x24A"],"\xC4"=>[77,"\x24_"],"\xC5"=>[18,"\x24_"],"\xC6"=>[77,"\x24b"],"\xC7"=>[18,"\x24b"],"\xC8"=>[77,"\x24d"],"\xC9"=>[18,"\x24d"],"\xCA"=>[77,"\x24f"],"\xCB"=>[18,"\x24f"],"\xCC"=>[77,"\x24g"],"\xCD"=>[18,"\x24g"],"\xCE"=>[77,"\x24h"],"\xCF"=>[18,"\x24h"],"\xD0"=>[77,"\x24l"],"\xD1"=>[18,"\x24l"],"\xD2"=>[77,"\x24m"],"\xD3"=>[18,"\x24m"],"\xD4"=>[77,"\x24n"],"\xD5"=>[18,"\x24n"],"\xD6"=>[77,"\x24p"],"\xD7"=>[18,"\x24p"],"\xD8"=>[77,"\x24r"],"\xD9"=>[18,"\x24r"],"\xDA"=>[77,"\x24u"],"\xDB"=>[18,"\x24u"],"\xDC"=>[0,"\x24\x3A"],"\xDD"=>[0,"\x24B"],"\xDE"=>[0,"\x24C"],"\xDF"=>[0,"\x24D"],"\xE0"=>[0,"\x24E"],"\xE1"=>[0,"\x24F"],"\xE2"=>[0,"\x24G"],"\xE3"=>[0,"\x24H"],"\xE4"=>[0,"\x24I"],"\xE5"=>[0,"\x24J"],"\xE6"=>[0,"\x24K"],"\xE7"=>[0,"\x24L"],"\xE8"=>[0,"\x24M"],"\xE9"=>[0,"\x24N"],"\xEA"=>[0,"\x24O"],"\xEB"=>[0,"\x24P"],"\xEC"=>[0,"\x24Q"],"\xED"=>[0,"\x24R"],"\xEE"=>[0,"\x24S"],"\xEF"=>[0,"\x24T"],"\xF0"=>[0,"\x24U"],"\xF1"=>[0,"\x24V"],"\xF2"=>[0,"\x24W"],"\xF3"=>[0,"\x24Y"],"\xF4"=>[0,"\x24j"],"\xF5"=>[0,"\x24k"],"\xF6"=>[0,"\x24q"],"\xF7"=>[0,"\x24v"],"\xF8"=>[0,"\x24w"],"\xF9"=>[0,"\x24x"],"\xFA"=>[0,"\x24y"],"\xFB"=>[0,"\x24z"],"\xFC"=>[82,"\x24"],"\xFD"=>[87,"\x24"],"\xFE"=>[130,"\x24"],"\xFF"=>[9,"\x24"],],["\x00"=>[92,"U"],"\x01"=>[95,"U"],"\x02"=>[137,"U"],"\x03"=>[142,"U"],"\x04"=>[150,"U"],"\x05"=>[74,"U"],"\x06"=>[90,"U"],"\x07"=>[98,"U"],"\x08"=>[107,"U"],"\x09"=>[140,"U"],"\x0A"=>[146,"U"],"\x0B"=>[102,"U"],"\x0C"=>[113,"U"],"\x0D"=>[121,"U"],"\x0E"=>[128,"U"],"\x0F"=>[12,"U"],"\x10"=>[92,"V"],"\x11"=>[95,"V"],"\x12"=>[137,"V"],"\x13"=>[142,"V"],"\x14"=>[150,"V"],"\x15"=>[74,"V"],"\x16"=>[90,"V"],"\x17"=>[98,"V"],"\x18"=>[107,"V"],"\x19"=>[140,"V"],"\x1A"=>[146,"V"],"\x1B"=>[102,"V"],"\x1C"=>[113,"V"],"\x1D"=>[121,"V"],"\x1E"=>[128,"V"],"\x1F"=>[12,"V"],"\x20"=>[92,"W"],"\x21"=>[95,"W"],"\x22"=>[137,"W"],"\x23"=>[142,"W"],"\x24"=>[150,"W"],"\x25"=>[74,"W"],"\x26"=>[90,"W"],"\x27"=>[98,"W"],"\x28"=>[107,"W"],"\x29"=>[140,"W"],"\x2A"=>[146,"W"],"\x2B"=>[102,"W"],"\x2C"=>[113,"W"],"-"=>[121,"W"],"."=>[128,"W"],"\x2F"=>[12,"W"],[92,"Y"],[95,"Y"],[137,"Y"],[142,"Y"],[150,"Y"],[74,"Y"],[90,"Y"],[98,"Y"],[107,"Y"],[140,"Y"],"\x3A"=>[146,"Y"],"\x3B"=>[102,"Y"],"\x3C"=>[113,"Y"],"\x3D"=>[121,"Y"],"\x3E"=>[128,"Y"],"\x3F"=>[12,"Y"],"\x40"=>[92,"j"],"A"=>[95,"j"],"B"=>[137,"j"],"C"=>[142,"j"],"D"=>[150,"j"],"E"=>[74,"j"],"F"=>[90,"j"],"G"=>[98,"j"],"H"=>[107,"j"],"I"=>[140,"j"],"J"=>[146,"j"],"K"=>[102,"j"],"L"=>[113,"j"],"M"=>[121,"j"],"N"=>[128,"j"],"O"=>[12,"j"],"P"=>[92,"k"],"Q"=>[95,"k"],"R"=>[137,"k"],"S"=>[142,"k"],"T"=>[150,"k"],"U"=>[74,"k"],"V"=>[90,"k"],"W"=>[98,"k"],"X"=>[107,"k"],"Y"=>[140,"k"],"Z"=>[146,"k"],"\x5B"=>[102,"k"],"\x5C"=>[113,"k"],"\x5D"=>[121,"k"],"\x5E"=>[128,"k"],"_"=>[12,"k"],"\x60"=>[92,"q"],"a"=>[95,"q"],"b"=>[137,"q"],"c"=>[142,"q"],"d"=>[150,"q"],"e"=>[74,"q"],"f"=>[90,"q"],"g"=>[98,"q"],"h"=>[107,"q"],"i"=>[140,"q"],"j"=>[146,"q"],"k"=>[102,"q"],"l"=>[113,"q"],"m"=>[121,"q"],"n"=>[128,"q"],"o"=>[12,"q"],"p"=>[92,"v"],"q"=>[95,"v"],"r"=>[137,"v"],"s"=>[142,"v"],"t"=>[150,"v"],"u"=>[74,"v"],"v"=>[90,"v"],"w"=>[98,"v"],"x"=>[107,"v"],"y"=>[140,"v"],"z"=>[146,"v"],"\x7B"=>[102,"v"],"\x7C"=>[113,"v"],"\x7D"=>[121,"v"],"~"=>[128,"v"],"\x7F"=>[12,"v"],"\x80"=>[92,"w"],"\x81"=>[95,"w"],"\x82"=>[137,"w"],"\x83"=>[142,"w"],"\x84"=>[150,"w"],"\x85"=>[74,"w"],"\x86"=>[90,"w"],"\x87"=>[98,"w"],"\x88"=>[107,"w"],"\x89"=>[140,"w"],"\x8A"=>[146,"w"],"\x8B"=>[102,"w"],"\x8C"=>[113,"w"],"\x8D"=>[121,"w"],"\x8E"=>[128,"w"],"\x8F"=>[12,"w"],"\x90"=>[92,"x"],"\x91"=>[95,"x"],"\x92"=>[137,"x"],"\x93"=>[142,"x"],"\x94"=>[150,"x"],"\x95"=>[74,"x"],"\x96"=>[90,"x"],"\x97"=>[98,"x"],"\x98"=>[107,"x"],"\x99"=>[140,"x"],"\x9A"=>[146,"x"],"\x9B"=>[102,"x"],"\x9C"=>[113,"x"],"\x9D"=>[121,"x"],"\x9E"=>[128,"x"],"\x9F"=>[12,"x"],"\xA0"=>[92,"y"],"\xA1"=>[95,"y"],"\xA2"=>[137,"y"],"\xA3"=>[142,"y"],"\xA4"=>[150,"y"],"\xA5"=>[74,"y"],"\xA6"=>[90,"y"],"\xA7"=>[98,"y"],"\xA8"=>[107,"y"],"\xA9"=>[140,"y"],"\xAA"=>[146,"y"],"\xAB"=>[102,"y"],"\xAC"=>[113,"y"],"\xAD"=>[121,"y"],"\xAE"=>[128,"y"],"\xAF"=>[12,"y"],"\xB0"=>[92,"z"],"\xB1"=>[95,"z"],"\xB2"=>[137,"z"],"\xB3"=>[142,"z"],"\xB4"=>[150,"z"],"\xB5"=>[74,"z"],"\xB6"=>[90,"z"],"\xB7"=>[98,"z"],"\xB8"=>[107,"z"],"\xB9"=>[140,"z"],"\xBA"=>[146,"z"],"\xBB"=>[102,"z"],"\xBC"=>[113,"z"],"\xBD"=>[121,"z"],"\xBE"=>[128,"z"],"\xBF"=>[12,"z"],"\xC0"=>[93,"\x26"],"\xC1"=>[138,"\x26"],"\xC2"=>[75,"\x26"],"\xC3"=>[91,"\x26"],"\xC4"=>[108,"\x26"],"\xC5"=>[103,"\x26"],"\xC6"=>[114,"\x26"],"\xC7"=>[14,"\x26"],"\xC8"=>[93,"\x2A"],"\xC9"=>[138,"\x2A"],"\xCA"=>[75,"\x2A"],"\xCB"=>[91,"\x2A"],"\xCC"=>[108,"\x2A"],"\xCD"=>[103,"\x2A"],"\xCE"=>[114,"\x2A"],"\xCF"=>[14,"\x2A"],"\xD0"=>[93,"\x2C"],"\xD1"=>[138,"\x2C"],"\xD2"=>[75,"\x2C"],"\xD3"=>[91,"\x2C"],"\xD4"=>[108,"\x2C"],"\xD5"=>[103,"\x2C"],"\xD6"=>[114,"\x2C"],"\xD7"=>[14,"\x2C"],"\xD8"=>[93,"\x3B"],"\xD9"=>[138,"\x3B"],"\xDA"=>[75,"\x3B"],"\xDB"=>[91,"\x3B"],"\xDC"=>[108,"\x3B"],"\xDD"=>[103,"\x3B"],"\xDE"=>[114,"\x3B"],"\xDF"=>[14,"\x3B"],"\xE0"=>[93,"X"],"\xE1"=>[138,"X"],"\xE2"=>[75,"X"],"\xE3"=>[91,"X"],"\xE4"=>[108,"X"],"\xE5"=>[103,"X"],"\xE6"=>[114,"X"],"\xE7"=>[14,"X"],"\xE8"=>[93,"Z"],"\xE9"=>[138,"Z"],"\xEA"=>[75,"Z"],"\xEB"=>[91,"Z"],"\xEC"=>[108,"Z"],"\xED"=>[103,"Z"],"\xEE"=>[114,"Z"],"\xEF"=>[14,"Z"],"\xF0"=>[77,"\x21"],"\xF1"=>[18,"\x21"],"\xF2"=>[77,"\x22"],"\xF3"=>[18,"\x22"],"\xF4"=>[77,"\x28"],"\xF5"=>[18,"\x28"],"\xF6"=>[77,"\x29"],"\xF7"=>[18,"\x29"],"\xF8"=>[77,"\x3F"],"\xF9"=>[18,"\x3F"],"\xFA"=>[0,"\x27"],"\xFB"=>[0,"\x2B"],"\xFC"=>[0,"\x7C"],"\xFD"=>[80,null],"\xFE"=>[15,null],"\xFF"=>[28,null],],["\x00"=>[77,"\x000"],"\x01"=>[18,"\x000"],"\x02"=>[77,"\x001"],"\x03"=>[18,"\x001"],"\x04"=>[77,"\x002"],"\x05"=>[18,"\x002"],"\x06"=>[77,"\x00a"],"\x07"=>[18,"\x00a"],"\x08"=>[77,"\x00c"],"\x09"=>[18,"\x00c"],"\x0A"=>[77,"\x00e"],"\x0B"=>[18,"\x00e"],"\x0C"=>[77,"\x00i"],"\x0D"=>[18,"\x00i"],"\x0E"=>[77,"\x00o"],"\x0F"=>[18,"\x00o"],"\x10"=>[77,"\x00s"],"\x11"=>[18,"\x00s"],"\x12"=>[77,"\x00t"],"\x13"=>[18,"\x00t"],"\x14"=>[0,"\x00\x20"],"\x15"=>[0,"\x00\x25"],"\x16"=>[0,"\x00-"],"\x17"=>[0,"\x00."],"\x18"=>[0,"\x00\x2F"],"\x19"=>[0,"\x003"],"\x1A"=>[0,"\x004"],"\x1B"=>[0,"\x005"],"\x1C"=>[0,"\x006"],"\x1D"=>[0,"\x007"],"\x1E"=>[0,"\x008"],"\x1F"=>[0,"\x009"],"\x20"=>[0,"\x00\x3D"],"\x21"=>[0,"\x00A"],"\x22"=>[0,"\x00_"],"\x23"=>[0,"\x00b"],"\x24"=>[0,"\x00d"],"\x25"=>[0,"\x00f"],"\x26"=>[0,"\x00g"],"\x27"=>[0,"\x00h"],"\x28"=>[0,"\x00l"],"\x29"=>[0,"\x00m"],"\x2A"=>[0,"\x00n"],"\x2B"=>[0,"\x00p"],"\x2C"=>[0,"\x00r"],"-"=>[0,"\x00u"],"."=>[100,"\x00"],"\x2F"=>[110,"\x00"],[111,"\x00"],[115,"\x00"],[116,"\x00"],[118,"\x00"],[119,"\x00"],[122,"\x00"],[123,"\x00"],[125,"\x00"],[126,"\x00"],[129,"\x00"],"\x3A"=>[143,"\x00"],"\x3B"=>[148,"\x00"],"\x3C"=>[151,"\x00"],"\x3D"=>[153,"\x00"],"\x3E"=>[83,"\x00"],"\x3F"=>[10,"\x00"],"\x40"=>[77,"\x240"],"A"=>[18,"\x240"],"B"=>[77,"\x241"],"C"=>[18,"\x241"],"D"=>[77,"\x242"],"E"=>[18,"\x242"],"F"=>[77,"\x24a"],"G"=>[18,"\x24a"],"H"=>[77,"\x24c"],"I"=>[18,"\x24c"],"J"=>[77,"\x24e"],"K"=>[18,"\x24e"],"L"=>[77,"\x24i"],"M"=>[18,"\x24i"],"N"=>[77,"\x24o"],"O"=>[18,"\x24o"],"P"=>[77,"\x24s"],"Q"=>[18,"\x24s"],"R"=>[77,"\x24t"],"S"=>[18,"\x24t"],"T"=>[0,"\x24\x20"],"U"=>[0,"\x24\x25"],"V"=>[0,"\x24-"],"W"=>[0,"\x24."],"X"=>[0,"\x24\x2F"],"Y"=>[0,"\x243"],"Z"=>[0,"\x244"],"\x5B"=>[0,"\x245"],"\x5C"=>[0,"\x246"],"\x5D"=>[0,"\x247"],"\x5E"=>[0,"\x248"],"_"=>[0,"\x249"],"\x60"=>[0,"\x24\x3D"],"a"=>[0,"\x24A"],"b"=>[0,"\x24_"],"c"=>[0,"\x24b"],"d"=>[0,"\x24d"],"e"=>[0,"\x24f"],"f"=>[0,"\x24g"],"g"=>[0,"\x24h"],"h"=>[0,"\x24l"],"i"=>[0,"\x24m"],"j"=>[0,"\x24n"],"k"=>[0,"\x24p"],"l"=>[0,"\x24r"],"m"=>[0,"\x24u"],"n"=>[100,"\x24"],"o"=>[110,"\x24"],"p"=>[111,"\x24"],"q"=>[115,"\x24"],"r"=>[116,"\x24"],"s"=>[118,"\x24"],"t"=>[119,"\x24"],"u"=>[122,"\x24"],"v"=>[123,"\x24"],"w"=>[125,"\x24"],"x"=>[126,"\x24"],"y"=>[129,"\x24"],"z"=>[143,"\x24"],"\x7B"=>[148,"\x24"],"\x7C"=>[151,"\x24"],"\x7D"=>[153,"\x24"],"~"=>[83,"\x24"],"\x7F"=>[10,"\x24"],"\x80"=>[77,"\x400"],"\x81"=>[18,"\x400"],"\x82"=>[77,"\x401"],"\x83"=>[18,"\x401"],"\x84"=>[77,"\x402"],"\x85"=>[18,"\x402"],"\x86"=>[77,"\x40a"],"\x87"=>[18,"\x40a"],"\x88"=>[77,"\x40c"],"\x89"=>[18,"\x40c"],"\x8A"=>[77,"\x40e"],"\x8B"=>[18,"\x40e"],"\x8C"=>[77,"\x40i"],"\x8D"=>[18,"\x40i"],"\x8E"=>[77,"\x40o"],"\x8F"=>[18,"\x40o"],"\x90"=>[77,"\x40s"],"\x91"=>[18,"\x40s"],"\x92"=>[77,"\x40t"],"\x93"=>[18,"\x40t"],"\x94"=>[0,"\x40\x20"],"\x95"=>[0,"\x40\x25"],"\x96"=>[0,"\x40-"],"\x97"=>[0,"\x40."],"\x98"=>[0,"\x40\x2F"],"\x99"=>[0,"\x403"],"\x9A"=>[0,"\x404"],"\x9B"=>[0,"\x405"],"\x9C"=>[0,"\x406"],"\x9D"=>[0,"\x407"],"\x9E"=>[0,"\x408"],"\x9F"=>[0,"\x409"],"\xA0"=>[0,"\x40\x3D"],"\xA1"=>[0,"\x40A"],"\xA2"=>[0,"\x40_"],"\xA3"=>[0,"\x40b"],"\xA4"=>[0,"\x40d"],"\xA5"=>[0,"\x40f"],"\xA6"=>[0,"\x40g"],"\xA7"=>[0,"\x40h"],"\xA8"=>[0,"\x40l"],"\xA9"=>[0,"\x40m"],"\xAA"=>[0,"\x40n"],"\xAB"=>[0,"\x40p"],"\xAC"=>[0,"\x40r"],"\xAD"=>[0,"\x40u"],"\xAE"=>[100,"\x40"],"\xAF"=>[110,"\x40"],"\xB0"=>[111,"\x40"],"\xB1"=>[115,"\x40"],"\xB2"=>[116,"\x40"],"\xB3"=>[118,"\x40"],"\xB4"=>[119,"\x40"],"\xB5"=>[122,"\x40"],"\xB6"=>[123,"\x40"],"\xB7"=>[125,"\x40"],"\xB8"=>[126,"\x40"],"\xB9"=>[129,"\x40"],"\xBA"=>[143,"\x40"],"\xBB"=>[148,"\x40"],"\xBC"=>[151,"\x40"],"\xBD"=>[153,"\x40"],"\xBE"=>[83,"\x40"],"\xBF"=>[10,"\x40"],"\xC0"=>[77,"\x5B0"],"\xC1"=>[18,"\x5B0"],"\xC2"=>[77,"\x5B1"],"\xC3"=>[18,"\x5B1"],"\xC4"=>[77,"\x5B2"],"\xC5"=>[18,"\x5B2"],"\xC6"=>[77,"\x5Ba"],"\xC7"=>[18,"\x5Ba"],"\xC8"=>[77,"\x5Bc"],"\xC9"=>[18,"\x5Bc"],"\xCA"=>[77,"\x5Be"],"\xCB"=>[18,"\x5Be"],"\xCC"=>[77,"\x5Bi"],"\xCD"=>[18,"\x5Bi"],"\xCE"=>[77,"\x5Bo"],"\xCF"=>[18,"\x5Bo"],"\xD0"=>[77,"\x5Bs"],"\xD1"=>[18,"\x5Bs"],"\xD2"=>[77,"\x5Bt"],"\xD3"=>[18,"\x5Bt"],"\xD4"=>[0,"\x5B\x20"],"\xD5"=>[0,"\x5B\x25"],"\xD6"=>[0,"\x5B-"],"\xD7"=>[0,"\x5B."],"\xD8"=>[0,"\x5B\x2F"],"\xD9"=>[0,"\x5B3"],"\xDA"=>[0,"\x5B4"],"\xDB"=>[0,"\x5B5"],"\xDC"=>[0,"\x5B6"],"\xDD"=>[0,"\x5B7"],"\xDE"=>[0,"\x5B8"],"\xDF"=>[0,"\x5B9"],"\xE0"=>[0,"\x5B\x3D"],"\xE1"=>[0,"\x5BA"],"\xE2"=>[0,"\x5B_"],"\xE3"=>[0,"\x5Bb"],"\xE4"=>[0,"\x5Bd"],"\xE5"=>[0,"\x5Bf"],"\xE6"=>[0,"\x5Bg"],"\xE7"=>[0,"\x5Bh"],"\xE8"=>[0,"\x5Bl"],"\xE9"=>[0,"\x5Bm"],"\xEA"=>[0,"\x5Bn"],"\xEB"=>[0,"\x5Bp"],"\xEC"=>[0,"\x5Br"],"\xED"=>[0,"\x5Bu"],"\xEE"=>[100,"\x5B"],"\xEF"=>[110,"\x5B"],"\xF0"=>[111,"\x5B"],"\xF1"=>[115,"\x5B"],"\xF2"=>[116,"\x5B"],"\xF3"=>[118,"\x5B"],"\xF4"=>[119,"\x5B"],"\xF5"=>[122,"\x5B"],"\xF6"=>[123,"\x5B"],"\xF7"=>[125,"\x5B"],"\xF8"=>[126,"\x5B"],"\xF9"=>[129,"\x5B"],"\xFA"=>[143,"\x5B"],"\xFB"=>[148,"\x5B"],"\xFC"=>[151,"\x5B"],"\xFD"=>[153,"\x5B"],"\xFE"=>[83,"\x5B"],"\xFF"=>[10,"\x5B"],],["\x00"=>[93,"E"],"\x01"=>[138,"E"],"\x02"=>[75,"E"],"\x03"=>[91,"E"],"\x04"=>[108,"E"],"\x05"=>[103,"E"],"\x06"=>[114,"E"],"\x07"=>[14,"E"],"\x08"=>[93,"F"],"\x09"=>[138,"F"],"\x0A"=>[75,"F"],"\x0B"=>[91,"F"],"\x0C"=>[108,"F"],"\x0D"=>[103,"F"],"\x0E"=>[114,"F"],"\x0F"=>[14,"F"],"\x10"=>[93,"G"],"\x11"=>[138,"G"],"\x12"=>[75,"G"],"\x13"=>[91,"G"],"\x14"=>[108,"G"],"\x15"=>[103,"G"],"\x16"=>[114,"G"],"\x17"=>[14,"G"],"\x18"=>[93,"H"],"\x19"=>[138,"H"],"\x1A"=>[75,"H"],"\x1B"=>[91,"H"],"\x1C"=>[108,"H"],"\x1D"=>[103,"H"],"\x1E"=>[114,"H"],"\x1F"=>[14,"H"],"\x20"=>[93,"I"],"\x21"=>[138,"I"],"\x22"=>[75,"I"],"\x23"=>[91,"I"],"\x24"=>[108,"I"],"\x25"=>[103,"I"],"\x26"=>[114,"I"],"\x27"=>[14,"I"],"\x28"=>[93,"J"],"\x29"=>[138,"J"],"\x2A"=>[75,"J"],"\x2B"=>[91,"J"],"\x2C"=>[108,"J"],"-"=>[103,"J"],"."=>[114,"J"],"\x2F"=>[14,"J"],[93,"K"],[138,"K"],[75,"K"],[91,"K"],[108,"K"],[103,"K"],[114,"K"],[14,"K"],[93,"L"],[138,"L"],"\x3A"=>[75,"L"],"\x3B"=>[91,"L"],"\x3C"=>[108,"L"],"\x3D"=>[103,"L"],"\x3E"=>[114,"L"],"\x3F"=>[14,"L"],"\x40"=>[93,"M"],"A"=>[138,"M"],"B"=>[75,"M"],"C"=>[91,"M"],"D"=>[108,"M"],"E"=>[103,"M"],"F"=>[114,"M"],"G"=>[14,"M"],"H"=>[93,"N"],"I"=>[138,"N"],"J"=>[75,"N"],"K"=>[91,"N"],"L"=>[108,"N"],"M"=>[103,"N"],"N"=>[114,"N"],"O"=>[14,"N"],"P"=>[93,"O"],"Q"=>[138,"O"],"R"=>[75,"O"],"S"=>[91,"O"],"T"=>[108,"O"],"U"=>[103,"O"],"V"=>[114,"O"],"W"=>[14,"O"],"X"=>[93,"P"],"Y"=>[138,"P"],"Z"=>[75,"P"],"\x5B"=>[91,"P"],"\x5C"=>[108,"P"],"\x5D"=>[103,"P"],"\x5E"=>[114,"P"],"_"=>[14,"P"],"\x60"=>[93,"Q"],"a"=>[138,"Q"],"b"=>[75,"Q"],"c"=>[91,"Q"],"d"=>[108,"Q"],"e"=>[103,"Q"],"f"=>[114,"Q"],"g"=>[14,"Q"],"h"=>[93,"R"],"i"=>[138,"R"],"j"=>[75,"R"],"k"=>[91,"R"],"l"=>[108,"R"],"m"=>[103,"R"],"n"=>[114,"R"],"o"=>[14,"R"],"p"=>[93,"S"],"q"=>[138,"S"],"r"=>[75,"S"],"s"=>[91,"S"],"t"=>[108,"S"],"u"=>[103,"S"],"v"=>[114,"S"],"w"=>[14,"S"],"x"=>[93,"T"],"y"=>[138,"T"],"z"=>[75,"T"],"\x7B"=>[91,"T"],"\x7C"=>[108,"T"],"\x7D"=>[103,"T"],"~"=>[114,"T"],"\x7F"=>[14,"T"],"\x80"=>[93,"U"],"\x81"=>[138,"U"],"\x82"=>[75,"U"],"\x83"=>[91,"U"],"\x84"=>[108,"U"],"\x85"=>[103,"U"],"\x86"=>[114,"U"],"\x87"=>[14,"U"],"\x88"=>[93,"V"],"\x89"=>[138,"V"],"\x8A"=>[75,"V"],"\x8B"=>[91,"V"],"\x8C"=>[108,"V"],"\x8D"=>[103,"V"],"\x8E"=>[114,"V"],"\x8F"=>[14,"V"],"\x90"=>[93,"W"],"\x91"=>[138,"W"],"\x92"=>[75,"W"],"\x93"=>[91,"W"],"\x94"=>[108,"W"],"\x95"=>[103,"W"],"\x96"=>[114,"W"],"\x97"=>[14,"W"],"\x98"=>[93,"Y"],"\x99"=>[138,"Y"],"\x9A"=>[75,"Y"],"\x9B"=>[91,"Y"],"\x9C"=>[108,"Y"],"\x9D"=>[103,"Y"],"\x9E"=>[114,"Y"],"\x9F"=>[14,"Y"],"\xA0"=>[93,"j"],"\xA1"=>[138,"j"],"\xA2"=>[75,"j"],"\xA3"=>[91,"j"],"\xA4"=>[108,"j"],"\xA5"=>[103,"j"],"\xA6"=>[114,"j"],"\xA7"=>[14,"j"],"\xA8"=>[93,"k"],"\xA9"=>[138,"k"],"\xAA"=>[75,"k"],"\xAB"=>[91,"k"],"\xAC"=>[108,"k"],"\xAD"=>[103,"k"],"\xAE"=>[114,"k"],"\xAF"=>[14,"k"],"\xB0"=>[93,"q"],"\xB1"=>[138,"q"],"\xB2"=>[75,"q"],"\xB3"=>[91,"q"],"\xB4"=>[108,"q"],"\xB5"=>[103,"q"],"\xB6"=>[114,"q"],"\xB7"=>[14,"q"],"\xB8"=>[93,"v"],"\xB9"=>[138,"v"],"\xBA"=>[75,"v"],"\xBB"=>[91,"v"],"\xBC"=>[108,"v"],"\xBD"=>[103,"v"],"\xBE"=>[114,"v"],"\xBF"=>[14,"v"],"\xC0"=>[93,"w"],"\xC1"=>[138,"w"],"\xC2"=>[75,"w"],"\xC3"=>[91,"w"],"\xC4"=>[108,"w"],"\xC5"=>[103,"w"],"\xC6"=>[114,"w"],"\xC7"=>[14,"w"],"\xC8"=>[93,"x"],"\xC9"=>[138,"x"],"\xCA"=>[75,"x"],"\xCB"=>[91,"x"],"\xCC"=>[108,"x"],"\xCD"=>[103,"x"],"\xCE"=>[114,"x"],"\xCF"=>[14,"x"],"\xD0"=>[93,"y"],"\xD1"=>[138,"y"],"\xD2"=>[75,"y"],"\xD3"=>[91,"y"],"\xD4"=>[108,"y"],"\xD5"=>[103,"y"],"\xD6"=>[114,"y"],"\xD7"=>[14,"y"],"\xD8"=>[93,"z"],"\xD9"=>[138,"z"],"\xDA"=>[75,"z"],"\xDB"=>[91,"z"],"\xDC"=>[108,"z"],"\xDD"=>[103,"z"],"\xDE"=>[114,"z"],"\xDF"=>[14,"z"],"\xE0"=>[94,"\x26"],"\xE1"=>[76,"\x26"],"\xE2"=>[104,"\x26"],"\xE3"=>[16,"\x26"],"\xE4"=>[94,"\x2A"],"\xE5"=>[76,"\x2A"],"\xE6"=>[104,"\x2A"],"\xE7"=>[16,"\x2A"],"\xE8"=>[94,"\x2C"],"\xE9"=>[76,"\x2C"],"\xEA"=>[104,"\x2C"],"\xEB"=>[16,"\x2C"],"\xEC"=>[94,"\x3B"],"\xED"=>[76,"\x3B"],"\xEE"=>[104,"\x3B"],"\xEF"=>[16,"\x3B"],"\xF0"=>[94,"X"],"\xF1"=>[76,"X"],"\xF2"=>[104,"X"],"\xF3"=>[16,"X"],"\xF4"=>[94,"Z"],"\xF5"=>[76,"Z"],"\xF6"=>[104,"Z"],"\xF7"=>[16,"Z"],"\xF8"=>[0,"\x21"],"\xF9"=>[0,"\x22"],"\xFA"=>[0,"\x28"],"\xFB"=>[0,"\x29"],"\xFC"=>[0,"\x3F"],"\xFD"=>[84,null],"\xFE"=>[81,null],"\xFF"=>[17,null],],["\x00"=>[0,"\x000"],"\x01"=>[0,"\x001"],"\x02"=>[0,"\x002"],"\x03"=>[0,"\x00a"],"\x04"=>[0,"\x00c"],"\x05"=>[0,"\x00e"],"\x06"=>[0,"\x00i"],"\x07"=>[0,"\x00o"],"\x08"=>[0,"\x00s"],"\x09"=>[0,"\x00t"],"\x0A"=>[73,"\x00"],"\x0B"=>[88,"\x00"],"\x0C"=>[89,"\x00"],"\x0D"=>[96,"\x00"],"\x0E"=>[97,"\x00"],"\x0F"=>[99,"\x00"],"\x10"=>[106,"\x00"],"\x11"=>[136,"\x00"],"\x12"=>[139,"\x00"],"\x13"=>[141,"\x00"],"\x14"=>[145,"\x00"],"\x15"=>[147,"\x00"],"\x16"=>[149,"\x00"],"\x17"=>[101,"\x00"],"\x18"=>[112,"\x00"],"\x19"=>[117,"\x00"],"\x1A"=>[120,"\x00"],"\x1B"=>[124,"\x00"],"\x1C"=>[127,"\x00"],"\x1D"=>[144,"\x00"],"\x1E"=>[152,"\x00"],"\x1F"=>[11,"\x00"],"\x20"=>[0,"\x240"],"\x21"=>[0,"\x241"],"\x22"=>[0,"\x242"],"\x23"=>[0,"\x24a"],"\x24"=>[0,"\x24c"],"\x25"=>[0,"\x24e"],"\x26"=>[0,"\x24i"],"\x27"=>[0,"\x24o"],"\x28"=>[0,"\x24s"],"\x29"=>[0,"\x24t"],"\x2A"=>[73,"\x24"],"\x2B"=>[88,"\x24"],"\x2C"=>[89,"\x24"],"-"=>[96,"\x24"],"."=>[97,"\x24"],"\x2F"=>[99,"\x24"],[106,"\x24"],[136,"\x24"],[139,"\x24"],[141,"\x24"],[145,"\x24"],[147,"\x24"],[149,"\x24"],[101,"\x24"],[112,"\x24"],[117,"\x24"],"\x3A"=>[120,"\x24"],"\x3B"=>[124,"\x24"],"\x3C"=>[127,"\x24"],"\x3D"=>[144,"\x24"],"\x3E"=>[152,"\x24"],"\x3F"=>[11,"\x24"],"\x40"=>[0,"\x400"],"A"=>[0,"\x401"],"B"=>[0,"\x402"],"C"=>[0,"\x40a"],"D"=>[0,"\x40c"],"E"=>[0,"\x40e"],"F"=>[0,"\x40i"],"G"=>[0,"\x40o"],"H"=>[0,"\x40s"],"I"=>[0,"\x40t"],"J"=>[73,"\x40"],"K"=>[88,"\x40"],"L"=>[89,"\x40"],"M"=>[96,"\x40"],"N"=>[97,"\x40"],"O"=>[99,"\x40"],"P"=>[106,"\x40"],"Q"=>[136,"\x40"],"R"=>[139,"\x40"],"S"=>[141,"\x40"],"T"=>[145,"\x40"],"U"=>[147,"\x40"],"V"=>[149,"\x40"],"W"=>[101,"\x40"],"X"=>[112,"\x40"],"Y"=>[117,"\x40"],"Z"=>[120,"\x40"],"\x5B"=>[124,"\x40"],"\x5C"=>[127,"\x40"],"\x5D"=>[144,"\x40"],"\x5E"=>[152,"\x40"],"_"=>[11,"\x40"],"\x60"=>[0,"\x5B0"],"a"=>[0,"\x5B1"],"b"=>[0,"\x5B2"],"c"=>[0,"\x5Ba"],"d"=>[0,"\x5Bc"],"e"=>[0,"\x5Be"],"f"=>[0,"\x5Bi"],"g"=>[0,"\x5Bo"],"h"=>[0,"\x5Bs"],"i"=>[0,"\x5Bt"],"j"=>[73,"\x5B"],"k"=>[88,"\x5B"],"l"=>[89,"\x5B"],"m"=>[96,"\x5B"],"n"=>[97,"\x5B"],"o"=>[99,"\x5B"],"p"=>[106,"\x5B"],"q"=>[136,"\x5B"],"r"=>[139,"\x5B"],"s"=>[141,"\x5B"],"t"=>[145,"\x5B"],"u"=>[147,"\x5B"],"v"=>[149,"\x5B"],"w"=>[101,"\x5B"],"x"=>[112,"\x5B"],"y"=>[117,"\x5B"],"z"=>[120,"\x5B"],"\x7B"=>[124,"\x5B"],"\x7C"=>[127,"\x5B"],"\x7D"=>[144,"\x5B"],"~"=>[152,"\x5B"],"\x7F"=>[11,"\x5B"],"\x80"=>[0,"\x5D0"],"\x81"=>[0,"\x5D1"],"\x82"=>[0,"\x5D2"],"\x83"=>[0,"\x5Da"],"\x84"=>[0,"\x5Dc"],"\x85"=>[0,"\x5De"],"\x86"=>[0,"\x5Di"],"\x87"=>[0,"\x5Do"],"\x88"=>[0,"\x5Ds"],"\x89"=>[0,"\x5Dt"],"\x8A"=>[73,"\x5D"],"\x8B"=>[88,"\x5D"],"\x8C"=>[89,"\x5D"],"\x8D"=>[96,"\x5D"],"\x8E"=>[97,"\x5D"],"\x8F"=>[99,"\x5D"],"\x90"=>[106,"\x5D"],"\x91"=>[136,"\x5D"],"\x92"=>[139,"\x5D"],"\x93"=>[141,"\x5D"],"\x94"=>[145,"\x5D"],"\x95"=>[147,"\x5D"],"\x96"=>[149,"\x5D"],"\x97"=>[101,"\x5D"],"\x98"=>[112,"\x5D"],"\x99"=>[117,"\x5D"],"\x9A"=>[120,"\x5D"],"\x9B"=>[124,"\x5D"],"\x9C"=>[127,"\x5D"],"\x9D"=>[144,"\x5D"],"\x9E"=>[152,"\x5D"],"\x9F"=>[11,"\x5D"],"\xA0"=>[0,"~0"],"\xA1"=>[0,"~1"],"\xA2"=>[0,"~2"],"\xA3"=>[0,"~a"],"\xA4"=>[0,"~c"],"\xA5"=>[0,"~e"],"\xA6"=>[0,"~i"],"\xA7"=>[0,"~o"],"\xA8"=>[0,"~s"],"\xA9"=>[0,"~t"],"\xAA"=>[73,"~"],"\xAB"=>[88,"~"],"\xAC"=>[89,"~"],"\xAD"=>[96,"~"],"\xAE"=>[97,"~"],"\xAF"=>[99,"~"],"\xB0"=>[106,"~"],"\xB1"=>[136,"~"],"\xB2"=>[139,"~"],"\xB3"=>[141,"~"],"\xB4"=>[145,"~"],"\xB5"=>[147,"~"],"\xB6"=>[149,"~"],"\xB7"=>[101,"~"],"\xB8"=>[112,"~"],"\xB9"=>[117,"~"],"\xBA"=>[120,"~"],"\xBB"=>[124,"~"],"\xBC"=>[127,"~"],"\xBD"=>[144,"~"],"\xBE"=>[152,"~"],"\xBF"=>[11,"~"],"\xC0"=>[92,"\x5E"],"\xC1"=>[95,"\x5E"],"\xC2"=>[137,"\x5E"],"\xC3"=>[142,"\x5E"],"\xC4"=>[150,"\x5E"],"\xC5"=>[74,"\x5E"],"\xC6"=>[90,"\x5E"],"\xC7"=>[98,"\x5E"],"\xC8"=>[107,"\x5E"],"\xC9"=>[140,"\x5E"],"\xCA"=>[146,"\x5E"],"\xCB"=>[102,"\x5E"],"\xCC"=>[113,"\x5E"],"\xCD"=>[121,"\x5E"],"\xCE"=>[128,"\x5E"],"\xCF"=>[12,"\x5E"],"\xD0"=>[92,"\x7D"],"\xD1"=>[95,"\x7D"],"\xD2"=>[137,"\x7D"],"\xD3"=>[142,"\x7D"],"\xD4"=>[150,"\x7D"],"\xD5"=>[74,"\x7D"],"\xD6"=>[90,"\x7D"],"\xD7"=>[98,"\x7D"],"\xD8"=>[107,"\x7D"],"\xD9"=>[140,"\x7D"],"\xDA"=>[146,"\x7D"],"\xDB"=>[102,"\x7D"],"\xDC"=>[113,"\x7D"],"\xDD"=>[121,"\x7D"],"\xDE"=>[128,"\x7D"],"\xDF"=>[12,"\x7D"],"\xE0"=>[93,"\x3C"],"\xE1"=>[138,"\x3C"],"\xE2"=>[75,"\x3C"],"\xE3"=>[91,"\x3C"],"\xE4"=>[108,"\x3C"],"\xE5"=>[103,"\x3C"],"\xE6"=>[114,"\x3C"],"\xE7"=>[14,"\x3C"],"\xE8"=>[93,"\x60"],"\xE9"=>[138,"\x60"],"\xEA"=>[75,"\x60"],"\xEB"=>[91,"\x60"],"\xEC"=>[108,"\x60"],"\xED"=>[103,"\x60"],"\xEE"=>[114,"\x60"],"\xEF"=>[14,"\x60"],"\xF0"=>[93,"\x7B"],"\xF1"=>[138,"\x7B"],"\xF2"=>[75,"\x7B"],"\xF3"=>[91,"\x7B"],"\xF4"=>[108,"\x7B"],"\xF5"=>[103,"\x7B"],"\xF6"=>[114,"\x7B"],"\xF7"=>[14,"\x7B"],"\xF8"=>[132,null],"\xF9"=>[156,null],"\xFA"=>[163,null],"\xFB"=>[184,null],"\xFC"=>[205,null],"\xFD"=>[160,null],"\xFE"=>[30,null],"\xFF"=>[39,null],],["\x00"=>[93,"\x3D"],"\x01"=>[138,"\x3D"],"\x02"=>[75,"\x3D"],"\x03"=>[91,"\x3D"],"\x04"=>[108,"\x3D"],"\x05"=>[103,"\x3D"],"\x06"=>[114,"\x3D"],"\x07"=>[14,"\x3D"],"\x08"=>[93,"A"],"\x09"=>[138,"A"],"\x0A"=>[75,"A"],"\x0B"=>[91,"A"],"\x0C"=>[108,"A"],"\x0D"=>[103,"A"],"\x0E"=>[114,"A"],"\x0F"=>[14,"A"],"\x10"=>[93,"_"],"\x11"=>[138,"_"],"\x12"=>[75,"_"],"\x13"=>[91,"_"],"\x14"=>[108,"_"],"\x15"=>[103,"_"],"\x16"=>[114,"_"],"\x17"=>[14,"_"],"\x18"=>[93,"b"],"\x19"=>[138,"b"],"\x1A"=>[75,"b"],"\x1B"=>[91,"b"],"\x1C"=>[108,"b"],"\x1D"=>[103,"b"],"\x1E"=>[114,"b"],"\x1F"=>[14,"b"],"\x20"=>[93,"d"],"\x21"=>[138,"d"],"\x22"=>[75,"d"],"\x23"=>[91,"d"],"\x24"=>[108,"d"],"\x25"=>[103,"d"],"\x26"=>[114,"d"],"\x27"=>[14,"d"],"\x28"=>[93,"f"],"\x29"=>[138,"f"],"\x2A"=>[75,"f"],"\x2B"=>[91,"f"],"\x2C"=>[108,"f"],"-"=>[103,"f"],"."=>[114,"f"],"\x2F"=>[14,"f"],[93,"g"],[138,"g"],[75,"g"],[91,"g"],[108,"g"],[103,"g"],[114,"g"],[14,"g"],[93,"h"],[138,"h"],"\x3A"=>[75,"h"],"\x3B"=>[91,"h"],"\x3C"=>[108,"h"],"\x3D"=>[103,"h"],"\x3E"=>[114,"h"],"\x3F"=>[14,"h"],"\x40"=>[93,"l"],"A"=>[138,"l"],"B"=>[75,"l"],"C"=>[91,"l"],"D"=>[108,"l"],"E"=>[103,"l"],"F"=>[114,"l"],"G"=>[14,"l"],"H"=>[93,"m"],"I"=>[138,"m"],"J"=>[75,"m"],"K"=>[91,"m"],"L"=>[108,"m"],"M"=>[103,"m"],"N"=>[114,"m"],"O"=>[14,"m"],"P"=>[93,"n"],"Q"=>[138,"n"],"R"=>[75,"n"],"S"=>[91,"n"],"T"=>[108,"n"],"U"=>[103,"n"],"V"=>[114,"n"],"W"=>[14,"n"],"X"=>[93,"p"],"Y"=>[138,"p"],"Z"=>[75,"p"],"\x5B"=>[91,"p"],"\x5C"=>[108,"p"],"\x5D"=>[103,"p"],"\x5E"=>[114,"p"],"_"=>[14,"p"],"\x60"=>[93,"r"],"a"=>[138,"r"],"b"=>[75,"r"],"c"=>[91,"r"],"d"=>[108,"r"],"e"=>[103,"r"],"f"=>[114,"r"],"g"=>[14,"r"],"h"=>[93,"u"],"i"=>[138,"u"],"j"=>[75,"u"],"k"=>[91,"u"],"l"=>[108,"u"],"m"=>[103,"u"],"n"=>[114,"u"],"o"=>[14,"u"],"p"=>[94,"\x3A"],"q"=>[76,"\x3A"],"r"=>[104,"\x3A"],"s"=>[16,"\x3A"],"t"=>[94,"B"],"u"=>[76,"B"],"v"=>[104,"B"],"w"=>[16,"B"],"x"=>[94,"C"],"y"=>[76,"C"],"z"=>[104,"C"],"\x7B"=>[16,"C"],"\x7C"=>[94,"D"],"\x7D"=>[76,"D"],"~"=>[104,"D"],"\x7F"=>[16,"D"],"\x80"=>[94,"E"],"\x81"=>[76,"E"],"\x82"=>[104,"E"],"\x83"=>[16,"E"],"\x84"=>[94,"F"],"\x85"=>[76,"F"],"\x86"=>[104,"F"],"\x87"=>[16,"F"],"\x88"=>[94,"G"],"\x89"=>[76,"G"],"\x8A"=>[104,"G"],"\x8B"=>[16,"G"],"\x8C"=>[94,"H"],"\x8D"=>[76,"H"],"\x8E"=>[104,"H"],"\x8F"=>[16,"H"],"\x90"=>[94,"I"],"\x91"=>[76,"I"],"\x92"=>[104,"I"],"\x93"=>[16,"I"],"\x94"=>[94,"J"],"\x95"=>[76,"J"],"\x96"=>[104,"J"],"\x97"=>[16,"J"],"\x98"=>[94,"K"],"\x99"=>[76,"K"],"\x9A"=>[104,"K"],"\x9B"=>[16,"K"],"\x9C"=>[94,"L"],"\x9D"=>[76,"L"],"\x9E"=>[104,"L"],"\x9F"=>[16,"L"],"\xA0"=>[94,"M"],"\xA1"=>[76,"M"],"\xA2"=>[104,"M"],"\xA3"=>[16,"M"],"\xA4"=>[94,"N"],"\xA5"=>[76,"N"],"\xA6"=>[104,"N"],"\xA7"=>[16,"N"],"\xA8"=>[94,"O"],"\xA9"=>[76,"O"],"\xAA"=>[104,"O"],"\xAB"=>[16,"O"],"\xAC"=>[94,"P"],"\xAD"=>[76,"P"],"\xAE"=>[104,"P"],"\xAF"=>[16,"P"],"\xB0"=>[94,"Q"],"\xB1"=>[76,"Q"],"\xB2"=>[104,"Q"],"\xB3"=>[16,"Q"],"\xB4"=>[94,"R"],"\xB5"=>[76,"R"],"\xB6"=>[104,"R"],"\xB7"=>[16,"R"],"\xB8"=>[94,"S"],"\xB9"=>[76,"S"],"\xBA"=>[104,"S"],"\xBB"=>[16,"S"],"\xBC"=>[94,"T"],"\xBD"=>[76,"T"],"\xBE"=>[104,"T"],"\xBF"=>[16,"T"],"\xC0"=>[94,"U"],"\xC1"=>[76,"U"],"\xC2"=>[104,"U"],"\xC3"=>[16,"U"],"\xC4"=>[94,"V"],"\xC5"=>[76,"V"],"\xC6"=>[104,"V"],"\xC7"=>[16,"V"],"\xC8"=>[94,"W"],"\xC9"=>[76,"W"],"\xCA"=>[104,"W"],"\xCB"=>[16,"W"],"\xCC"=>[94,"Y"],"\xCD"=>[76,"Y"],"\xCE"=>[104,"Y"],"\xCF"=>[16,"Y"],"\xD0"=>[94,"j"],"\xD1"=>[76,"j"],"\xD2"=>[104,"j"],"\xD3"=>[16,"j"],"\xD4"=>[94,"k"],"\xD5"=>[76,"k"],"\xD6"=>[104,"k"],"\xD7"=>[16,"k"],"\xD8"=>[94,"q"],"\xD9"=>[76,"q"],"\xDA"=>[104,"q"],"\xDB"=>[16,"q"],"\xDC"=>[94,"v"],"\xDD"=>[76,"v"],"\xDE"=>[104,"v"],"\xDF"=>[16,"v"],"\xE0"=>[94,"w"],"\xE1"=>[76,"w"],"\xE2"=>[104,"w"],"\xE3"=>[16,"w"],"\xE4"=>[94,"x"],"\xE5"=>[76,"x"],"\xE6"=>[104,"x"],"\xE7"=>[16,"x"],"\xE8"=>[94,"y"],"\xE9"=>[76,"y"],"\xEA"=>[104,"y"],"\xEB"=>[16,"y"],"\xEC"=>[94,"z"],"\xED"=>[76,"z"],"\xEE"=>[104,"z"],"\xEF"=>[16,"z"],"\xF0"=>[77,"\x26"],"\xF1"=>[18,"\x26"],"\xF2"=>[77,"\x2A"],"\xF3"=>[18,"\x2A"],"\xF4"=>[77,"\x2C"],"\xF5"=>[18,"\x2C"],"\xF6"=>[77,"\x3B"],"\xF7"=>[18,"\x3B"],"\xF8"=>[77,"X"],"\xF9"=>[18,"X"],"\xFA"=>[77,"Z"],"\xFB"=>[18,"Z"],"\xFC"=>[79,null],"\xFD"=>[86,null],"\xFE"=>[85,null],"\xFF"=>[19,null],],["\x00"=>[77,"\x7C0"],"\x01"=>[18,"\x7C0"],"\x02"=>[77,"\x7C1"],"\x03"=>[18,"\x7C1"],"\x04"=>[77,"\x7C2"],"\x05"=>[18,"\x7C2"],"\x06"=>[77,"\x7Ca"],"\x07"=>[18,"\x7Ca"],"\x08"=>[77,"\x7Cc"],"\x09"=>[18,"\x7Cc"],"\x0A"=>[77,"\x7Ce"],"\x0B"=>[18,"\x7Ce"],"\x0C"=>[77,"\x7Ci"],"\x0D"=>[18,"\x7Ci"],"\x0E"=>[77,"\x7Co"],"\x0F"=>[18,"\x7Co"],"\x10"=>[77,"\x7Cs"],"\x11"=>[18,"\x7Cs"],"\x12"=>[77,"\x7Ct"],"\x13"=>[18,"\x7Ct"],"\x14"=>[0,"\x7C\x20"],"\x15"=>[0,"\x7C\x25"],"\x16"=>[0,"\x7C-"],"\x17"=>[0,"\x7C."],"\x18"=>[0,"\x7C\x2F"],"\x19"=>[0,"\x7C3"],"\x1A"=>[0,"\x7C4"],"\x1B"=>[0,"\x7C5"],"\x1C"=>[0,"\x7C6"],"\x1D"=>[0,"\x7C7"],"\x1E"=>[0,"\x7C8"],"\x1F"=>[0,"\x7C9"],"\x20"=>[0,"\x7C\x3D"],"\x21"=>[0,"\x7CA"],"\x22"=>[0,"\x7C_"],"\x23"=>[0,"\x7Cb"],"\x24"=>[0,"\x7Cd"],"\x25"=>[0,"\x7Cf"],"\x26"=>[0,"\x7Cg"],"\x27"=>[0,"\x7Ch"],"\x28"=>[0,"\x7Cl"],"\x29"=>[0,"\x7Cm"],"\x2A"=>[0,"\x7Cn"],"\x2B"=>[0,"\x7Cp"],"\x2C"=>[0,"\x7Cr"],"-"=>[0,"\x7Cu"],"."=>[100,"\x7C"],"\x2F"=>[110,"\x7C"],[111,"\x7C"],[115,"\x7C"],[116,"\x7C"],[118,"\x7C"],[119,"\x7C"],[122,"\x7C"],[123,"\x7C"],[125,"\x7C"],[126,"\x7C"],[129,"\x7C"],"\x3A"=>[143,"\x7C"],"\x3B"=>[148,"\x7C"],"\x3C"=>[151,"\x7C"],"\x3D"=>[153,"\x7C"],"\x3E"=>[83,"\x7C"],"\x3F"=>[10,"\x7C"],"\x40"=>[0,"\x230"],"A"=>[0,"\x231"],"B"=>[0,"\x232"],"C"=>[0,"\x23a"],"D"=>[0,"\x23c"],"E"=>[0,"\x23e"],"F"=>[0,"\x23i"],"G"=>[0,"\x23o"],"H"=>[0,"\x23s"],"I"=>[0,"\x23t"],"J"=>[73,"\x23"],"K"=>[88,"\x23"],"L"=>[89,"\x23"],"M"=>[96,"\x23"],"N"=>[97,"\x23"],"O"=>[99,"\x23"],"P"=>[106,"\x23"],"Q"=>[136,"\x23"],"R"=>[139,"\x23"],"S"=>[141,"\x23"],"T"=>[145,"\x23"],"U"=>[147,"\x23"],"V"=>[149,"\x23"],"W"=>[101,"\x23"],"X"=>[112,"\x23"],"Y"=>[117,"\x23"],"Z"=>[120,"\x23"],"\x5B"=>[124,"\x23"],"\x5C"=>[127,"\x23"],"\x5D"=>[144,"\x23"],"\x5E"=>[152,"\x23"],"_"=>[11,"\x23"],"\x60"=>[0,"\x3E0"],"a"=>[0,"\x3E1"],"b"=>[0,"\x3E2"],"c"=>[0,"\x3Ea"],"d"=>[0,"\x3Ec"],"e"=>[0,"\x3Ee"],"f"=>[0,"\x3Ei"],"g"=>[0,"\x3Eo"],"h"=>[0,"\x3Es"],"i"=>[0,"\x3Et"],"j"=>[73,"\x3E"],"k"=>[88,"\x3E"],"l"=>[89,"\x3E"],"m"=>[96,"\x3E"],"n"=>[97,"\x3E"],"o"=>[99,"\x3E"],"p"=>[106,"\x3E"],"q"=>[136,"\x3E"],"r"=>[139,"\x3E"],"s"=>[141,"\x3E"],"t"=>[145,"\x3E"],"u"=>[147,"\x3E"],"v"=>[149,"\x3E"],"w"=>[101,"\x3E"],"x"=>[112,"\x3E"],"y"=>[117,"\x3E"],"z"=>[120,"\x3E"],"\x7B"=>[124,"\x3E"],"\x7C"=>[127,"\x3E"],"\x7D"=>[144,"\x3E"],"~"=>[152,"\x3E"],"\x7F"=>[11,"\x3E"],"\x80"=>[92,"\x00"],"\x81"=>[95,"\x00"],"\x82"=>[137,"\x00"],"\x83"=>[142,"\x00"],"\x84"=>[150,"\x00"],"\x85"=>[74,"\x00"],"\x86"=>[90,"\x00"],"\x87"=>[98,"\x00"],"\x88"=>[107,"\x00"],"\x89"=>[140,"\x00"],"\x8A"=>[146,"\x00"],"\x8B"=>[102,"\x00"],"\x8C"=>[113,"\x00"],"\x8D"=>[121,"\x00"],"\x8E"=>[128,"\x00"],"\x8F"=>[12,"\x00"],"\x90"=>[92,"\x24"],"\x91"=>[95,"\x24"],"\x92"=>[137,"\x24"],"\x93"=>[142,"\x24"],"\x94"=>[150,"\x24"],"\x95"=>[74,"\x24"],"\x96"=>[90,"\x24"],"\x97"=>[98,"\x24"],"\x98"=>[107,"\x24"],"\x99"=>[140,"\x24"],"\x9A"=>[146,"\x24"],"\x9B"=>[102,"\x24"],"\x9C"=>[113,"\x24"],"\x9D"=>[121,"\x24"],"\x9E"=>[128,"\x24"],"\x9F"=>[12,"\x24"],"\xA0"=>[92,"\x40"],"\xA1"=>[95,"\x40"],"\xA2"=>[137,"\x40"],"\xA3"=>[142,"\x40"],"\xA4"=>[150,"\x40"],"\xA5"=>[74,"\x40"],"\xA6"=>[90,"\x40"],"\xA7"=>[98,"\x40"],"\xA8"=>[107,"\x40"],"\xA9"=>[140,"\x40"],"\xAA"=>[146,"\x40"],"\xAB"=>[102,"\x40"],"\xAC"=>[113,"\x40"],"\xAD"=>[121,"\x40"],"\xAE"=>[128,"\x40"],"\xAF"=>[12,"\x40"],"\xB0"=>[92,"\x5B"],"\xB1"=>[95,"\x5B"],"\xB2"=>[137,"\x5B"],"\xB3"=>[142,"\x5B"],"\xB4"=>[150,"\x5B"],"\xB5"=>[74,"\x5B"],"\xB6"=>[90,"\x5B"],"\xB7"=>[98,"\x5B"],"\xB8"=>[107,"\x5B"],"\xB9"=>[140,"\x5B"],"\xBA"=>[146,"\x5B"],"\xBB"=>[102,"\x5B"],"\xBC"=>[113,"\x5B"],"\xBD"=>[121,"\x5B"],"\xBE"=>[128,"\x5B"],"\xBF"=>[12,"\x5B"],"\xC0"=>[92,"\x5D"],"\xC1"=>[95,"\x5D"],"\xC2"=>[137,"\x5D"],"\xC3"=>[142,"\x5D"],"\xC4"=>[150,"\x5D"],"\xC5"=>[74,"\x5D"],"\xC6"=>[90,"\x5D"],"\xC7"=>[98,"\x5D"],"\xC8"=>[107,"\x5D"],"\xC9"=>[140,"\x5D"],"\xCA"=>[146,"\x5D"],"\xCB"=>[102,"\x5D"],"\xCC"=>[113,"\x5D"],"\xCD"=>[121,"\x5D"],"\xCE"=>[128,"\x5D"],"\xCF"=>[12,"\x5D"],"\xD0"=>[92,"~"],"\xD1"=>[95,"~"],"\xD2"=>[137,"~"],"\xD3"=>[142,"~"],"\xD4"=>[150,"~"],"\xD5"=>[74,"~"],"\xD6"=>[90,"~"],"\xD7"=>[98,"~"],"\xD8"=>[107,"~"],"\xD9"=>[140,"~"],"\xDA"=>[146,"~"],"\xDB"=>[102,"~"],"\xDC"=>[113,"~"],"\xDD"=>[121,"~"],"\xDE"=>[128,"~"],"\xDF"=>[12,"~"],"\xE0"=>[93,"\x5E"],"\xE1"=>[138,"\x5E"],"\xE2"=>[75,"\x5E"],"\xE3"=>[91,"\x5E"],"\xE4"=>[108,"\x5E"],"\xE5"=>[103,"\x5E"],"\xE6"=>[114,"\x5E"],"\xE7"=>[14,"\x5E"],"\xE8"=>[93,"\x7D"],"\xE9"=>[138,"\x7D"],"\xEA"=>[75,"\x7D"],"\xEB"=>[91,"\x7D"],"\xEC"=>[108,"\x7D"],"\xED"=>[103,"\x7D"],"\xEE"=>[114,"\x7D"],"\xEF"=>[14,"\x7D"],"\xF0"=>[94,"\x3C"],"\xF1"=>[76,"\x3C"],"\xF2"=>[104,"\x3C"],"\xF3"=>[16,"\x3C"],"\xF4"=>[94,"\x60"],"\xF5"=>[76,"\x60"],"\xF6"=>[104,"\x60"],"\xF7"=>[16,"\x60"],"\xF8"=>[94,"\x7B"],"\xF9"=>[76,"\x7B"],"\xFA"=>[104,"\x7B"],"\xFB"=>[16,"\x7B"],"\xFC"=>[133,null],"\xFD"=>[164,null],"\xFE"=>[161,null],"\xFF"=>[31,null],],["\x00"=>[93,"\xB0"],"\x01"=>[138,"\xB0"],"\x02"=>[75,"\xB0"],"\x03"=>[91,"\xB0"],"\x04"=>[108,"\xB0"],"\x05"=>[103,"\xB0"],"\x06"=>[114,"\xB0"],"\x07"=>[14,"\xB0"],"\x08"=>[93,"\xB1"],"\x09"=>[138,"\xB1"],"\x0A"=>[75,"\xB1"],"\x0B"=>[91,"\xB1"],"\x0C"=>[108,"\xB1"],"\x0D"=>[103,"\xB1"],"\x0E"=>[114,"\xB1"],"\x0F"=>[14,"\xB1"],"\x10"=>[93,"\xB3"],"\x11"=>[138,"\xB3"],"\x12"=>[75,"\xB3"],"\x13"=>[91,"\xB3"],"\x14"=>[108,"\xB3"],"\x15"=>[103,"\xB3"],"\x16"=>[114,"\xB3"],"\x17"=>[14,"\xB3"],"\x18"=>[93,"\xD1"],"\x19"=>[138,"\xD1"],"\x1A"=>[75,"\xD1"],"\x1B"=>[91,"\xD1"],"\x1C"=>[108,"\xD1"],"\x1D"=>[103,"\xD1"],"\x1E"=>[114,"\xD1"],"\x1F"=>[14,"\xD1"],"\x20"=>[93,"\xD8"],"\x21"=>[138,"\xD8"],"\x22"=>[75,"\xD8"],"\x23"=>[91,"\xD8"],"\x24"=>[108,"\xD8"],"\x25"=>[103,"\xD8"],"\x26"=>[114,"\xD8"],"\x27"=>[14,"\xD8"],"\x28"=>[93,"\xD9"],"\x29"=>[138,"\xD9"],"\x2A"=>[75,"\xD9"],"\x2B"=>[91,"\xD9"],"\x2C"=>[108,"\xD9"],"-"=>[103,"\xD9"],"."=>[114,"\xD9"],"\x2F"=>[14,"\xD9"],[93,"\xE3"],[138,"\xE3"],[75,"\xE3"],[91,"\xE3"],[108,"\xE3"],[103,"\xE3"],[114,"\xE3"],[14,"\xE3"],[93,"\xE5"],[138,"\xE5"],"\x3A"=>[75,"\xE5"],"\x3B"=>[91,"\xE5"],"\x3C"=>[108,"\xE5"],"\x3D"=>[103,"\xE5"],"\x3E"=>[114,"\xE5"],"\x3F"=>[14,"\xE5"],"\x40"=>[93,"\xE6"],"A"=>[138,"\xE6"],"B"=>[75,"\xE6"],"C"=>[91,"\xE6"],"D"=>[108,"\xE6"],"E"=>[103,"\xE6"],"F"=>[114,"\xE6"],"G"=>[14,"\xE6"],"H"=>[94,"\x81"],"I"=>[76,"\x81"],"J"=>[104,"\x81"],"K"=>[16,"\x81"],"L"=>[94,"\x84"],"M"=>[76,"\x84"],"N"=>[104,"\x84"],"O"=>[16,"\x84"],"P"=>[94,"\x85"],"Q"=>[76,"\x85"],"R"=>[104,"\x85"],"S"=>[16,"\x85"],"T"=>[94,"\x86"],"U"=>[76,"\x86"],"V"=>[104,"\x86"],"W"=>[16,"\x86"],"X"=>[94,"\x88"],"Y"=>[76,"\x88"],"Z"=>[104,"\x88"],"\x5B"=>[16,"\x88"],"\x5C"=>[94,"\x92"],"\x5D"=>[76,"\x92"],"\x5E"=>[104,"\x92"],"_"=>[16,"\x92"],"\x60"=>[94,"\x9A"],"a"=>[76,"\x9A"],"b"=>[104,"\x9A"],"c"=>[16,"\x9A"],"d"=>[94,"\x9C"],"e"=>[76,"\x9C"],"f"=>[104,"\x9C"],"g"=>[16,"\x9C"],"h"=>[94,"\xA0"],"i"=>[76,"\xA0"],"j"=>[104,"\xA0"],"k"=>[16,"\xA0"],"l"=>[94,"\xA3"],"m"=>[76,"\xA3"],"n"=>[104,"\xA3"],"o"=>[16,"\xA3"],"p"=>[94,"\xA4"],"q"=>[76,"\xA4"],"r"=>[104,"\xA4"],"s"=>[16,"\xA4"],"t"=>[94,"\xA9"],"u"=>[76,"\xA9"],"v"=>[104,"\xA9"],"w"=>[16,"\xA9"],"x"=>[94,"\xAA"],"y"=>[76,"\xAA"],"z"=>[104,"\xAA"],"\x7B"=>[16,"\xAA"],"\x7C"=>[94,"\xAD"],"\x7D"=>[76,"\xAD"],"~"=>[104,"\xAD"],"\x7F"=>[16,"\xAD"],"\x80"=>[94,"\xB2"],"\x81"=>[76,"\xB2"],"\x82"=>[104,"\xB2"],"\x83"=>[16,"\xB2"],"\x84"=>[94,"\xB5"],"\x85"=>[76,"\xB5"],"\x86"=>[104,"\xB5"],"\x87"=>[16,"\xB5"],"\x88"=>[94,"\xB9"],"\x89"=>[76,"\xB9"],"\x8A"=>[104,"\xB9"],"\x8B"=>[16,"\xB9"],"\x8C"=>[94,"\xBA"],"\x8D"=>[76,"\xBA"],"\x8E"=>[104,"\xBA"],"\x8F"=>[16,"\xBA"],"\x90"=>[94,"\xBB"],"\x91"=>[76,"\xBB"],"\x92"=>[104,"\xBB"],"\x93"=>[16,"\xBB"],"\x94"=>[94,"\xBD"],"\x95"=>[76,"\xBD"],"\x96"=>[104,"\xBD"],"\x97"=>[16,"\xBD"],"\x98"=>[94,"\xBE"],"\x99"=>[76,"\xBE"],"\x9A"=>[104,"\xBE"],"\x9B"=>[16,"\xBE"],"\x9C"=>[94,"\xC4"],"\x9D"=>[76,"\xC4"],"\x9E"=>[104,"\xC4"],"\x9F"=>[16,"\xC4"],"\xA0"=>[94,"\xC6"],"\xA1"=>[76,"\xC6"],"\xA2"=>[104,"\xC6"],"\xA3"=>[16,"\xC6"],"\xA4"=>[94,"\xE4"],"\xA5"=>[76,"\xE4"],"\xA6"=>[104,"\xE4"],"\xA7"=>[16,"\xE4"],"\xA8"=>[94,"\xE8"],"\xA9"=>[76,"\xE8"],"\xAA"=>[104,"\xE8"],"\xAB"=>[16,"\xE8"],"\xAC"=>[94,"\xE9"],"\xAD"=>[76,"\xE9"],"\xAE"=>[104,"\xE9"],"\xAF"=>[16,"\xE9"],"\xB0"=>[77,"\x01"],"\xB1"=>[18,"\x01"],"\xB2"=>[77,"\x87"],"\xB3"=>[18,"\x87"],"\xB4"=>[77,"\x89"],"\xB5"=>[18,"\x89"],"\xB6"=>[77,"\x8A"],"\xB7"=>[18,"\x8A"],"\xB8"=>[77,"\x8B"],"\xB9"=>[18,"\x8B"],"\xBA"=>[77,"\x8C"],"\xBB"=>[18,"\x8C"],"\xBC"=>[77,"\x8D"],"\xBD"=>[18,"\x8D"],"\xBE"=>[77,"\x8F"],"\xBF"=>[18,"\x8F"],"\xC0"=>[77,"\x93"],"\xC1"=>[18,"\x93"],"\xC2"=>[77,"\x95"],"\xC3"=>[18,"\x95"],"\xC4"=>[77,"\x96"],"\xC5"=>[18,"\x96"],"\xC6"=>[77,"\x97"],"\xC7"=>[18,"\x97"],"\xC8"=>[77,"\x98"],"\xC9"=>[18,"\x98"],"\xCA"=>[77,"\x9B"],"\xCB"=>[18,"\x9B"],"\xCC"=>[77,"\x9D"],"\xCD"=>[18,"\x9D"],"\xCE"=>[77,"\x9E"],"\xCF"=>[18,"\x9E"],"\xD0"=>[77,"\xA5"],"\xD1"=>[18,"\xA5"],"\xD2"=>[77,"\xA6"],"\xD3"=>[18,"\xA6"],"\xD4"=>[77,"\xA8"],"\xD5"=>[18,"\xA8"],"\xD6"=>[77,"\xAE"],"\xD7"=>[18,"\xAE"],"\xD8"=>[77,"\xAF"],"\xD9"=>[18,"\xAF"],"\xDA"=>[77,"\xB4"],"\xDB"=>[18,"\xB4"],"\xDC"=>[77,"\xB6"],"\xDD"=>[18,"\xB6"],"\xDE"=>[77,"\xB7"],"\xDF"=>[18,"\xB7"],"\xE0"=>[77,"\xBC"],"\xE1"=>[18,"\xBC"],"\xE2"=>[77,"\xBF"],"\xE3"=>[18,"\xBF"],"\xE4"=>[77,"\xC5"],"\xE5"=>[18,"\xC5"],"\xE6"=>[77,"\xE7"],"\xE7"=>[18,"\xE7"],"\xE8"=>[77,"\xEF"],"\xE9"=>[18,"\xEF"],"\xEA"=>[0,"\x09"],"\xEB"=>[0,"\x8E"],"\xEC"=>[0,"\x90"],"\xED"=>[0,"\x91"],"\xEE"=>[0,"\x94"],"\xEF"=>[0,"\x9F"],"\xF0"=>[0,"\xAB"],"\xF1"=>[0,"\xCE"],"\xF2"=>[0,"\xD7"],"\xF3"=>[0,"\xE1"],"\xF4"=>[0,"\xEC"],"\xF5"=>[0,"\xED"],"\xF6"=>[225,null],"\xF7"=>[251,null],"\xF8"=>[218,null],"\xF9"=>[229,null],"\xFA"=>[244,null],"\xFB"=>[231,null],"\xFC"=>[236,null],"\xFD"=>[256,null],"\xFE"=>[32,null],"\xFF"=>[52,null],],["\x00"=>[92,"\x5C"],"\x01"=>[95,"\x5C"],"\x02"=>[137,"\x5C"],"\x03"=>[142,"\x5C"],"\x04"=>[150,"\x5C"],"\x05"=>[74,"\x5C"],"\x06"=>[90,"\x5C"],"\x07"=>[98,"\x5C"],"\x08"=>[107,"\x5C"],"\x09"=>[140,"\x5C"],"\x0A"=>[146,"\x5C"],"\x0B"=>[102,"\x5C"],"\x0C"=>[113,"\x5C"],"\x0D"=>[121,"\x5C"],"\x0E"=>[128,"\x5C"],"\x0F"=>[12,"\x5C"],"\x10"=>[92,"\xC3"],"\x11"=>[95,"\xC3"],"\x12"=>[137,"\xC3"],"\x13"=>[142,"\xC3"],"\x14"=>[150,"\xC3"],"\x15"=>[74,"\xC3"],"\x16"=>[90,"\xC3"],"\x17"=>[98,"\xC3"],"\x18"=>[107,"\xC3"],"\x19"=>[140,"\xC3"],"\x1A"=>[146,"\xC3"],"\x1B"=>[102,"\xC3"],"\x1C"=>[113,"\xC3"],"\x1D"=>[121,"\xC3"],"\x1E"=>[128,"\xC3"],"\x1F"=>[12,"\xC3"],"\x20"=>[92,"\xD0"],"\x21"=>[95,"\xD0"],"\x22"=>[137,"\xD0"],"\x23"=>[142,"\xD0"],"\x24"=>[150,"\xD0"],"\x25"=>[74,"\xD0"],"\x26"=>[90,"\xD0"],"\x27"=>[98,"\xD0"],"\x28"=>[107,"\xD0"],"\x29"=>[140,"\xD0"],"\x2A"=>[146,"\xD0"],"\x2B"=>[102,"\xD0"],"\x2C"=>[113,"\xD0"],"-"=>[121,"\xD0"],"."=>[128,"\xD0"],"\x2F"=>[12,"\xD0"],[93,"\x80"],[138,"\x80"],[75,"\x80"],[91,"\x80"],[108,"\x80"],[103,"\x80"],[114,"\x80"],[14,"\x80"],[93,"\x82"],[138,"\x82"],"\x3A"=>[75,"\x82"],"\x3B"=>[91,"\x82"],"\x3C"=>[108,"\x82"],"\x3D"=>[103,"\x82"],"\x3E"=>[114,"\x82"],"\x3F"=>[14,"\x82"],"\x40"=>[93,"\x83"],"A"=>[138,"\x83"],"B"=>[75,"\x83"],"C"=>[91,"\x83"],"D"=>[108,"\x83"],"E"=>[103,"\x83"],"F"=>[114,"\x83"],"G"=>[14,"\x83"],"H"=>[93,"\xA2"],"I"=>[138,"\xA2"],"J"=>[75,"\xA2"],"K"=>[91,"\xA2"],"L"=>[108,"\xA2"],"M"=>[103,"\xA2"],"N"=>[114,"\xA2"],"O"=>[14,"\xA2"],"P"=>[93,"\xB8"],"Q"=>[138,"\xB8"],"R"=>[75,"\xB8"],"S"=>[91,"\xB8"],"T"=>[108,"\xB8"],"U"=>[103,"\xB8"],"V"=>[114,"\xB8"],"W"=>[14,"\xB8"],"X"=>[93,"\xC2"],"Y"=>[138,"\xC2"],"Z"=>[75,"\xC2"],"\x5B"=>[91,"\xC2"],"\x5C"=>[108,"\xC2"],"\x5D"=>[103,"\xC2"],"\x5E"=>[114,"\xC2"],"_"=>[14,"\xC2"],"\x60"=>[93,"\xE0"],"a"=>[138,"\xE0"],"b"=>[75,"\xE0"],"c"=>[91,"\xE0"],"d"=>[108,"\xE0"],"e"=>[103,"\xE0"],"f"=>[114,"\xE0"],"g"=>[14,"\xE0"],"h"=>[93,"\xE2"],"i"=>[138,"\xE2"],"j"=>[75,"\xE2"],"k"=>[91,"\xE2"],"l"=>[108,"\xE2"],"m"=>[103,"\xE2"],"n"=>[114,"\xE2"],"o"=>[14,"\xE2"],"p"=>[94,"\x99"],"q"=>[76,"\x99"],"r"=>[104,"\x99"],"s"=>[16,"\x99"],"t"=>[94,"\xA1"],"u"=>[76,"\xA1"],"v"=>[104,"\xA1"],"w"=>[16,"\xA1"],"x"=>[94,"\xA7"],"y"=>[76,"\xA7"],"z"=>[104,"\xA7"],"\x7B"=>[16,"\xA7"],"\x7C"=>[94,"\xAC"],"\x7D"=>[76,"\xAC"],"~"=>[104,"\xAC"],"\x7F"=>[16,"\xAC"],"\x80"=>[94,"\xB0"],"\x81"=>[76,"\xB0"],"\x82"=>[104,"\xB0"],"\x83"=>[16,"\xB0"],"\x84"=>[94,"\xB1"],"\x85"=>[76,"\xB1"],"\x86"=>[104,"\xB1"],"\x87"=>[16,"\xB1"],"\x88"=>[94,"\xB3"],"\x89"=>[76,"\xB3"],"\x8A"=>[104,"\xB3"],"\x8B"=>[16,"\xB3"],"\x8C"=>[94,"\xD1"],"\x8D"=>[76,"\xD1"],"\x8E"=>[104,"\xD1"],"\x8F"=>[16,"\xD1"],"\x90"=>[94,"\xD8"],"\x91"=>[76,"\xD8"],"\x92"=>[104,"\xD8"],"\x93"=>[16,"\xD8"],"\x94"=>[94,"\xD9"],"\x95"=>[76,"\xD9"],"\x96"=>[104,"\xD9"],"\x97"=>[16,"\xD9"],"\x98"=>[94,"\xE3"],"\x99"=>[76,"\xE3"],"\x9A"=>[104,"\xE3"],"\x9B"=>[16,"\xE3"],"\x9C"=>[94,"\xE5"],"\x9D"=>[76,"\xE5"],"\x9E"=>[104,"\xE5"],"\x9F"=>[16,"\xE5"],"\xA0"=>[94,"\xE6"],"\xA1"=>[76,"\xE6"],"\xA2"=>[104,"\xE6"],"\xA3"=>[16,"\xE6"],"\xA4"=>[77,"\x81"],"\xA5"=>[18,"\x81"],"\xA6"=>[77,"\x84"],"\xA7"=>[18,"\x84"],"\xA8"=>[77,"\x85"],"\xA9"=>[18,"\x85"],"\xAA"=>[77,"\x86"],"\xAB"=>[18,"\x86"],"\xAC"=>[77,"\x88"],"\xAD"=>[18,"\x88"],"\xAE"=>[77,"\x92"],"\xAF"=>[18,"\x92"],"\xB0"=>[77,"\x9A"],"\xB1"=>[18,"\x9A"],"\xB2"=>[77,"\x9C"],"\xB3"=>[18,"\x9C"],"\xB4"=>[77,"\xA0"],"\xB5"=>[18,"\xA0"],"\xB6"=>[77,"\xA3"],"\xB7"=>[18,"\xA3"],"\xB8"=>[77,"\xA4"],"\xB9"=>[18,"\xA4"],"\xBA"=>[77,"\xA9"],"\xBB"=>[18,"\xA9"],"\xBC"=>[77,"\xAA"],"\xBD"=>[18,"\xAA"],"\xBE"=>[77,"\xAD"],"\xBF"=>[18,"\xAD"],"\xC0"=>[77,"\xB2"],"\xC1"=>[18,"\xB2"],"\xC2"=>[77,"\xB5"],"\xC3"=>[18,"\xB5"],"\xC4"=>[77,"\xB9"],"\xC5"=>[18,"\xB9"],"\xC6"=>[77,"\xBA"],"\xC7"=>[18,"\xBA"],"\xC8"=>[77,"\xBB"],"\xC9"=>[18,"\xBB"],"\xCA"=>[77,"\xBD"],"\xCB"=>[18,"\xBD"],"\xCC"=>[77,"\xBE"],"\xCD"=>[18,"\xBE"],"\xCE"=>[77,"\xC4"],"\xCF"=>[18,"\xC4"],"\xD0"=>[77,"\xC6"],"\xD1"=>[18,"\xC6"],"\xD2"=>[77,"\xE4"],"\xD3"=>[18,"\xE4"],"\xD4"=>[77,"\xE8"],"\xD5"=>[18,"\xE8"],"\xD6"=>[77,"\xE9"],"\xD7"=>[18,"\xE9"],"\xD8"=>[0,"\x01"],"\xD9"=>[0,"\x87"],"\xDA"=>[0,"\x89"],"\xDB"=>[0,"\x8A"],"\xDC"=>[0,"\x8B"],"\xDD"=>[0,"\x8C"],"\xDE"=>[0,"\x8D"],"\xDF"=>[0,"\x8F"],"\xE0"=>[0,"\x93"],"\xE1"=>[0,"\x95"],"\xE2"=>[0,"\x96"],"\xE3"=>[0,"\x97"],"\xE4"=>[0,"\x98"],"\xE5"=>[0,"\x9B"],"\xE6"=>[0,"\x9D"],"\xE7"=>[0,"\x9E"],"\xE8"=>[0,"\xA5"],"\xE9"=>[0,"\xA6"],"\xEA"=>[0,"\xA8"],"\xEB"=>[0,"\xAE"],"\xEC"=>[0,"\xAF"],"\xED"=>[0,"\xB4"],"\xEE"=>[0,"\xB6"],"\xEF"=>[0,"\xB7"],"\xF0"=>[0,"\xBC"],"\xF1"=>[0,"\xBF"],"\xF2"=>[0,"\xC5"],"\xF3"=>[0,"\xE7"],"\xF4"=>[0,"\xEF"],"\xF5"=>[48,null],"\xF6"=>[172,null],"\xF7"=>[178,null],"\xF8"=>[198,null],"\xF9"=>[241,null],"\xFA"=>[252,null],"\xFB"=>[226,null],"\xFC"=>[219,null],"\xFD"=>[232,null],"\xFE"=>[237,null],"\xFF"=>[33,null],],["\x00"=>[94,"\x7B0"],"\x01"=>[76,"\x7B0"],"\x02"=>[104,"\x7B0"],"\x03"=>[16,"\x7B0"],"\x04"=>[94,"\x7B1"],"\x05"=>[76,"\x7B1"],"\x06"=>[104,"\x7B1"],"\x07"=>[16,"\x7B1"],"\x08"=>[94,"\x7B2"],"\x09"=>[76,"\x7B2"],"\x0A"=>[104,"\x7B2"],"\x0B"=>[16,"\x7B2"],"\x0C"=>[94,"\x7Ba"],"\x0D"=>[76,"\x7Ba"],"\x0E"=>[104,"\x7Ba"],"\x0F"=>[16,"\x7Ba"],"\x10"=>[94,"\x7Bc"],"\x11"=>[76,"\x7Bc"],"\x12"=>[104,"\x7Bc"],"\x13"=>[16,"\x7Bc"],"\x14"=>[94,"\x7Be"],"\x15"=>[76,"\x7Be"],"\x16"=>[104,"\x7Be"],"\x17"=>[16,"\x7Be"],"\x18"=>[94,"\x7Bi"],"\x19"=>[76,"\x7Bi"],"\x1A"=>[104,"\x7Bi"],"\x1B"=>[16,"\x7Bi"],"\x1C"=>[94,"\x7Bo"],"\x1D"=>[76,"\x7Bo"],"\x1E"=>[104,"\x7Bo"],"\x1F"=>[16,"\x7Bo"],"\x20"=>[94,"\x7Bs"],"\x21"=>[76,"\x7Bs"],"\x22"=>[104,"\x7Bs"],"\x23"=>[16,"\x7Bs"],"\x24"=>[94,"\x7Bt"],"\x25"=>[76,"\x7Bt"],"\x26"=>[104,"\x7Bt"],"\x27"=>[16,"\x7Bt"],"\x28"=>[77,"\x7B\x20"],"\x29"=>[18,"\x7B\x20"],"\x2A"=>[77,"\x7B\x25"],"\x2B"=>[18,"\x7B\x25"],"\x2C"=>[77,"\x7B-"],"-"=>[18,"\x7B-"],"."=>[77,"\x7B."],"\x2F"=>[18,"\x7B."],[77,"\x7B\x2F"],[18,"\x7B\x2F"],[77,"\x7B3"],[18,"\x7B3"],[77,"\x7B4"],[18,"\x7B4"],[77,"\x7B5"],[18,"\x7B5"],[77,"\x7B6"],[18,"\x7B6"],"\x3A"=>[77,"\x7B7"],"\x3B"=>[18,"\x7B7"],"\x3C"=>[77,"\x7B8"],"\x3D"=>[18,"\x7B8"],"\x3E"=>[77,"\x7B9"],"\x3F"=>[18,"\x7B9"],"\x40"=>[77,"\x7B\x3D"],"A"=>[18,"\x7B\x3D"],"B"=>[77,"\x7BA"],"C"=>[18,"\x7BA"],"D"=>[77,"\x7B_"],"E"=>[18,"\x7B_"],"F"=>[77,"\x7Bb"],"G"=>[18,"\x7Bb"],"H"=>[77,"\x7Bd"],"I"=>[18,"\x7Bd"],"J"=>[77,"\x7Bf"],"K"=>[18,"\x7Bf"],"L"=>[77,"\x7Bg"],"M"=>[18,"\x7Bg"],"N"=>[77,"\x7Bh"],"O"=>[18,"\x7Bh"],"P"=>[77,"\x7Bl"],"Q"=>[18,"\x7Bl"],"R"=>[77,"\x7Bm"],"S"=>[18,"\x7Bm"],"T"=>[77,"\x7Bn"],"U"=>[18,"\x7Bn"],"V"=>[77,"\x7Bp"],"W"=>[18,"\x7Bp"],"X"=>[77,"\x7Br"],"Y"=>[18,"\x7Br"],"Z"=>[77,"\x7Bu"],"\x5B"=>[18,"\x7Bu"],"\x5C"=>[0,"\x7B\x3A"],"\x5D"=>[0,"\x7BB"],"\x5E"=>[0,"\x7BC"],"_"=>[0,"\x7BD"],"\x60"=>[0,"\x7BE"],"a"=>[0,"\x7BF"],"b"=>[0,"\x7BG"],"c"=>[0,"\x7BH"],"d"=>[0,"\x7BI"],"e"=>[0,"\x7BJ"],"f"=>[0,"\x7BK"],"g"=>[0,"\x7BL"],"h"=>[0,"\x7BM"],"i"=>[0,"\x7BN"],"j"=>[0,"\x7BO"],"k"=>[0,"\x7BP"],"l"=>[0,"\x7BQ"],"m"=>[0,"\x7BR"],"n"=>[0,"\x7BS"],"o"=>[0,"\x7BT"],"p"=>[0,"\x7BU"],"q"=>[0,"\x7BV"],"r"=>[0,"\x7BW"],"s"=>[0,"\x7BY"],"t"=>[0,"\x7Bj"],"u"=>[0,"\x7Bk"],"v"=>[0,"\x7Bq"],"w"=>[0,"\x7Bv"],"x"=>[0,"\x7Bw"],"y"=>[0,"\x7Bx"],"z"=>[0,"\x7By"],"\x7B"=>[0,"\x7Bz"],"\x7C"=>[82,"\x7B"],"\x7D"=>[87,"\x7B"],"~"=>[130,"\x7B"],"\x7F"=>[9,"\x7B"],"\x80"=>[93,"\x5C"],"\x81"=>[138,"\x5C"],"\x82"=>[75,"\x5C"],"\x83"=>[91,"\x5C"],"\x84"=>[108,"\x5C"],"\x85"=>[103,"\x5C"],"\x86"=>[114,"\x5C"],"\x87"=>[14,"\x5C"],"\x88"=>[93,"\xC3"],"\x89"=>[138,"\xC3"],"\x8A"=>[75,"\xC3"],"\x8B"=>[91,"\xC3"],"\x8C"=>[108,"\xC3"],"\x8D"=>[103,"\xC3"],"\x8E"=>[114,"\xC3"],"\x8F"=>[14,"\xC3"],"\x90"=>[93,"\xD0"],"\x91"=>[138,"\xD0"],"\x92"=>[75,"\xD0"],"\x93"=>[91,"\xD0"],"\x94"=>[108,"\xD0"],"\x95"=>[103,"\xD0"],"\x96"=>[114,"\xD0"],"\x97"=>[14,"\xD0"],"\x98"=>[94,"\x80"],"\x99"=>[76,"\x80"],"\x9A"=>[104,"\x80"],"\x9B"=>[16,"\x80"],"\x9C"=>[94,"\x82"],"\x9D"=>[76,"\x82"],"\x9E"=>[104,"\x82"],"\x9F"=>[16,"\x82"],"\xA0"=>[94,"\x83"],"\xA1"=>[76,"\x83"],"\xA2"=>[104,"\x83"],"\xA3"=>[16,"\x83"],"\xA4"=>[94,"\xA2"],"\xA5"=>[76,"\xA2"],"\xA6"=>[104,"\xA2"],"\xA7"=>[16,"\xA2"],"\xA8"=>[94,"\xB8"],"\xA9"=>[76,"\xB8"],"\xAA"=>[104,"\xB8"],"\xAB"=>[16,"\xB8"],"\xAC"=>[94,"\xC2"],"\xAD"=>[76,"\xC2"],"\xAE"=>[104,"\xC2"],"\xAF"=>[16,"\xC2"],"\xB0"=>[94,"\xE0"],"\xB1"=>[76,"\xE0"],"\xB2"=>[104,"\xE0"],"\xB3"=>[16,"\xE0"],"\xB4"=>[94,"\xE2"],"\xB5"=>[76,"\xE2"],"\xB6"=>[104,"\xE2"],"\xB7"=>[16,"\xE2"],"\xB8"=>[77,"\x99"],"\xB9"=>[18,"\x99"],"\xBA"=>[77,"\xA1"],"\xBB"=>[18,"\xA1"],"\xBC"=>[77,"\xA7"],"\xBD"=>[18,"\xA7"],"\xBE"=>[77,"\xAC"],"\xBF"=>[18,"\xAC"],"\xC0"=>[77,"\xB0"],"\xC1"=>[18,"\xB0"],"\xC2"=>[77,"\xB1"],"\xC3"=>[18,"\xB1"],"\xC4"=>[77,"\xB3"],"\xC5"=>[18,"\xB3"],"\xC6"=>[77,"\xD1"],"\xC7"=>[18,"\xD1"],"\xC8"=>[77,"\xD8"],"\xC9"=>[18,"\xD8"],"\xCA"=>[77,"\xD9"],"\xCB"=>[18,"\xD9"],"\xCC"=>[77,"\xE3"],"\xCD"=>[18,"\xE3"],"\xCE"=>[77,"\xE5"],"\xCF"=>[18,"\xE5"],"\xD0"=>[77,"\xE6"],"\xD1"=>[18,"\xE6"],"\xD2"=>[0,"\x81"],"\xD3"=>[0,"\x84"],"\xD4"=>[0,"\x85"],"\xD5"=>[0,"\x86"],"\xD6"=>[0,"\x88"],"\xD7"=>[0,"\x92"],"\xD8"=>[0,"\x9A"],"\xD9"=>[0,"\x9C"],"\xDA"=>[0,"\xA0"],"\xDB"=>[0,"\xA3"],"\xDC"=>[0,"\xA4"],"\xDD"=>[0,"\xA9"],"\xDE"=>[0,"\xAA"],"\xDF"=>[0,"\xAD"],"\xE0"=>[0,"\xB2"],"\xE1"=>[0,"\xB5"],"\xE2"=>[0,"\xB9"],"\xE3"=>[0,"\xBA"],"\xE4"=>[0,"\xBB"],"\xE5"=>[0,"\xBD"],"\xE6"=>[0,"\xBE"],"\xE7"=>[0,"\xC4"],"\xE8"=>[0,"\xC6"],"\xE9"=>[0,"\xE4"],"\xEA"=>[0,"\xE8"],"\xEB"=>[0,"\xE9"],"\xEC"=>[23,null],"\xED"=>[168,null],"\xEE"=>[169,null],"\xEF"=>[171,null],"\xF0"=>[174,null],"\xF1"=>[179,null],"\xF2"=>[180,null],"\xF3"=>[188,null],"\xF4"=>[192,null],"\xF5"=>[196,null],"\xF6"=>[201,null],"\xF7"=>[210,null],"\xF8"=>[215,null],"\xF9"=>[222,null],"\xFA"=>[49,null],"\xFB"=>[173,null],"\xFC"=>[199,null],"\xFD"=>[227,null],"\xFE"=>[220,null],"\xFF"=>[34,null],],["\x00"=>[94,"\x010"],"\x01"=>[76,"\x010"],"\x02"=>[104,"\x010"],"\x03"=>[16,"\x010"],"\x04"=>[94,"\x011"],"\x05"=>[76,"\x011"],"\x06"=>[104,"\x011"],"\x07"=>[16,"\x011"],"\x08"=>[94,"\x012"],"\x09"=>[76,"\x012"],"\x0A"=>[104,"\x012"],"\x0B"=>[16,"\x012"],"\x0C"=>[94,"\x01a"],"\x0D"=>[76,"\x01a"],"\x0E"=>[104,"\x01a"],"\x0F"=>[16,"\x01a"],"\x10"=>[94,"\x01c"],"\x11"=>[76,"\x01c"],"\x12"=>[104,"\x01c"],"\x13"=>[16,"\x01c"],"\x14"=>[94,"\x01e"],"\x15"=>[76,"\x01e"],"\x16"=>[104,"\x01e"],"\x17"=>[16,"\x01e"],"\x18"=>[94,"\x01i"],"\x19"=>[76,"\x01i"],"\x1A"=>[104,"\x01i"],"\x1B"=>[16,"\x01i"],"\x1C"=>[94,"\x01o"],"\x1D"=>[76,"\x01o"],"\x1E"=>[104,"\x01o"],"\x1F"=>[16,"\x01o"],"\x20"=>[94,"\x01s"],"\x21"=>[76,"\x01s"],"\x22"=>[104,"\x01s"],"\x23"=>[16,"\x01s"],"\x24"=>[94,"\x01t"],"\x25"=>[76,"\x01t"],"\x26"=>[104,"\x01t"],"\x27"=>[16,"\x01t"],"\x28"=>[77,"\x01\x20"],"\x29"=>[18,"\x01\x20"],"\x2A"=>[77,"\x01\x25"],"\x2B"=>[18,"\x01\x25"],"\x2C"=>[77,"\x01-"],"-"=>[18,"\x01-"],"."=>[77,"\x01."],"\x2F"=>[18,"\x01."],[77,"\x01\x2F"],[18,"\x01\x2F"],[77,"\x013"],[18,"\x013"],[77,"\x014"],[18,"\x014"],[77,"\x015"],[18,"\x015"],[77,"\x016"],[18,"\x016"],"\x3A"=>[77,"\x017"],"\x3B"=>[18,"\x017"],"\x3C"=>[77,"\x018"],"\x3D"=>[18,"\x018"],"\x3E"=>[77,"\x019"],"\x3F"=>[18,"\x019"],"\x40"=>[77,"\x01\x3D"],"A"=>[18,"\x01\x3D"],"B"=>[77,"\x01A"],"C"=>[18,"\x01A"],"D"=>[77,"\x01_"],"E"=>[18,"\x01_"],"F"=>[77,"\x01b"],"G"=>[18,"\x01b"],"H"=>[77,"\x01d"],"I"=>[18,"\x01d"],"J"=>[77,"\x01f"],"K"=>[18,"\x01f"],"L"=>[77,"\x01g"],"M"=>[18,"\x01g"],"N"=>[77,"\x01h"],"O"=>[18,"\x01h"],"P"=>[77,"\x01l"],"Q"=>[18,"\x01l"],"R"=>[77,"\x01m"],"S"=>[18,"\x01m"],"T"=>[77,"\x01n"],"U"=>[18,"\x01n"],"V"=>[77,"\x01p"],"W"=>[18,"\x01p"],"X"=>[77,"\x01r"],"Y"=>[18,"\x01r"],"Z"=>[77,"\x01u"],"\x5B"=>[18,"\x01u"],"\x5C"=>[0,"\x01\x3A"],"\x5D"=>[0,"\x01B"],"\x5E"=>[0,"\x01C"],"_"=>[0,"\x01D"],"\x60"=>[0,"\x01E"],"a"=>[0,"\x01F"],"b"=>[0,"\x01G"],"c"=>[0,"\x01H"],"d"=>[0,"\x01I"],"e"=>[0,"\x01J"],"f"=>[0,"\x01K"],"g"=>[0,"\x01L"],"h"=>[0,"\x01M"],"i"=>[0,"\x01N"],"j"=>[0,"\x01O"],"k"=>[0,"\x01P"],"l"=>[0,"\x01Q"],"m"=>[0,"\x01R"],"n"=>[0,"\x01S"],"o"=>[0,"\x01T"],"p"=>[0,"\x01U"],"q"=>[0,"\x01V"],"r"=>[0,"\x01W"],"s"=>[0,"\x01Y"],"t"=>[0,"\x01j"],"u"=>[0,"\x01k"],"v"=>[0,"\x01q"],"w"=>[0,"\x01v"],"x"=>[0,"\x01w"],"y"=>[0,"\x01x"],"z"=>[0,"\x01y"],"\x7B"=>[0,"\x01z"],"\x7C"=>[82,"\x01"],"\x7D"=>[87,"\x01"],"~"=>[130,"\x01"],"\x7F"=>[9,"\x01"],"\x80"=>[94,"\x870"],"\x81"=>[76,"\x870"],"\x82"=>[104,"\x870"],"\x83"=>[16,"\x870"],"\x84"=>[94,"\x871"],"\x85"=>[76,"\x871"],"\x86"=>[104,"\x871"],"\x87"=>[16,"\x871"],"\x88"=>[94,"\x872"],"\x89"=>[76,"\x872"],"\x8A"=>[104,"\x872"],"\x8B"=>[16,"\x872"],"\x8C"=>[94,"\x87a"],"\x8D"=>[76,"\x87a"],"\x8E"=>[104,"\x87a"],"\x8F"=>[16,"\x87a"],"\x90"=>[94,"\x87c"],"\x91"=>[76,"\x87c"],"\x92"=>[104,"\x87c"],"\x93"=>[16,"\x87c"],"\x94"=>[94,"\x87e"],"\x95"=>[76,"\x87e"],"\x96"=>[104,"\x87e"],"\x97"=>[16,"\x87e"],"\x98"=>[94,"\x87i"],"\x99"=>[76,"\x87i"],"\x9A"=>[104,"\x87i"],"\x9B"=>[16,"\x87i"],"\x9C"=>[94,"\x87o"],"\x9D"=>[76,"\x87o"],"\x9E"=>[104,"\x87o"],"\x9F"=>[16,"\x87o"],"\xA0"=>[94,"\x87s"],"\xA1"=>[76,"\x87s"],"\xA2"=>[104,"\x87s"],"\xA3"=>[16,"\x87s"],"\xA4"=>[94,"\x87t"],"\xA5"=>[76,"\x87t"],"\xA6"=>[104,"\x87t"],"\xA7"=>[16,"\x87t"],"\xA8"=>[77,"\x87\x20"],"\xA9"=>[18,"\x87\x20"],"\xAA"=>[77,"\x87\x25"],"\xAB"=>[18,"\x87\x25"],"\xAC"=>[77,"\x87-"],"\xAD"=>[18,"\x87-"],"\xAE"=>[77,"\x87."],"\xAF"=>[18,"\x87."],"\xB0"=>[77,"\x87\x2F"],"\xB1"=>[18,"\x87\x2F"],"\xB2"=>[77,"\x873"],"\xB3"=>[18,"\x873"],"\xB4"=>[77,"\x874"],"\xB5"=>[18,"\x874"],"\xB6"=>[77,"\x875"],"\xB7"=>[18,"\x875"],"\xB8"=>[77,"\x876"],"\xB9"=>[18,"\x876"],"\xBA"=>[77,"\x877"],"\xBB"=>[18,"\x877"],"\xBC"=>[77,"\x878"],"\xBD"=>[18,"\x878"],"\xBE"=>[77,"\x879"],"\xBF"=>[18,"\x879"],"\xC0"=>[77,"\x87\x3D"],"\xC1"=>[18,"\x87\x3D"],"\xC2"=>[77,"\x87A"],"\xC3"=>[18,"\x87A"],"\xC4"=>[77,"\x87_"],"\xC5"=>[18,"\x87_"],"\xC6"=>[77,"\x87b"],"\xC7"=>[18,"\x87b"],"\xC8"=>[77,"\x87d"],"\xC9"=>[18,"\x87d"],"\xCA"=>[77,"\x87f"],"\xCB"=>[18,"\x87f"],"\xCC"=>[77,"\x87g"],"\xCD"=>[18,"\x87g"],"\xCE"=>[77,"\x87h"],"\xCF"=>[18,"\x87h"],"\xD0"=>[77,"\x87l"],"\xD1"=>[18,"\x87l"],"\xD2"=>[77,"\x87m"],"\xD3"=>[18,"\x87m"],"\xD4"=>[77,"\x87n"],"\xD5"=>[18,"\x87n"],"\xD6"=>[77,"\x87p"],"\xD7"=>[18,"\x87p"],"\xD8"=>[77,"\x87r"],"\xD9"=>[18,"\x87r"],"\xDA"=>[77,"\x87u"],"\xDB"=>[18,"\x87u"],"\xDC"=>[0,"\x87\x3A"],"\xDD"=>[0,"\x87B"],"\xDE"=>[0,"\x87C"],"\xDF"=>[0,"\x87D"],"\xE0"=>[0,"\x87E"],"\xE1"=>[0,"\x87F"],"\xE2"=>[0,"\x87G"],"\xE3"=>[0,"\x87H"],"\xE4"=>[0,"\x87I"],"\xE5"=>[0,"\x87J"],"\xE6"=>[0,"\x87K"],"\xE7"=>[0,"\x87L"],"\xE8"=>[0,"\x87M"],"\xE9"=>[0,"\x87N"],"\xEA"=>[0,"\x87O"],"\xEB"=>[0,"\x87P"],"\xEC"=>[0,"\x87Q"],"\xED"=>[0,"\x87R"],"\xEE"=>[0,"\x87S"],"\xEF"=>[0,"\x87T"],"\xF0"=>[0,"\x87U"],"\xF1"=>[0,"\x87V"],"\xF2"=>[0,"\x87W"],"\xF3"=>[0,"\x87Y"],"\xF4"=>[0,"\x87j"],"\xF5"=>[0,"\x87k"],"\xF6"=>[0,"\x87q"],"\xF7"=>[0,"\x87v"],"\xF8"=>[0,"\x87w"],"\xF9"=>[0,"\x87x"],"\xFA"=>[0,"\x87y"],"\xFB"=>[0,"\x87z"],"\xFC"=>[82,"\x87"],"\xFD"=>[87,"\x87"],"\xFE"=>[130,"\x87"],"\xFF"=>[9,"\x87"],],["\x00"=>[77,"\x3C0"],"\x01"=>[18,"\x3C0"],"\x02"=>[77,"\x3C1"],"\x03"=>[18,"\x3C1"],"\x04"=>[77,"\x3C2"],"\x05"=>[18,"\x3C2"],"\x06"=>[77,"\x3Ca"],"\x07"=>[18,"\x3Ca"],"\x08"=>[77,"\x3Cc"],"\x09"=>[18,"\x3Cc"],"\x0A"=>[77,"\x3Ce"],"\x0B"=>[18,"\x3Ce"],"\x0C"=>[77,"\x3Ci"],"\x0D"=>[18,"\x3Ci"],"\x0E"=>[77,"\x3Co"],"\x0F"=>[18,"\x3Co"],"\x10"=>[77,"\x3Cs"],"\x11"=>[18,"\x3Cs"],"\x12"=>[77,"\x3Ct"],"\x13"=>[18,"\x3Ct"],"\x14"=>[0,"\x3C\x20"],"\x15"=>[0,"\x3C\x25"],"\x16"=>[0,"\x3C-"],"\x17"=>[0,"\x3C."],"\x18"=>[0,"\x3C\x2F"],"\x19"=>[0,"\x3C3"],"\x1A"=>[0,"\x3C4"],"\x1B"=>[0,"\x3C5"],"\x1C"=>[0,"\x3C6"],"\x1D"=>[0,"\x3C7"],"\x1E"=>[0,"\x3C8"],"\x1F"=>[0,"\x3C9"],"\x20"=>[0,"\x3C\x3D"],"\x21"=>[0,"\x3CA"],"\x22"=>[0,"\x3C_"],"\x23"=>[0,"\x3Cb"],"\x24"=>[0,"\x3Cd"],"\x25"=>[0,"\x3Cf"],"\x26"=>[0,"\x3Cg"],"\x27"=>[0,"\x3Ch"],"\x28"=>[0,"\x3Cl"],"\x29"=>[0,"\x3Cm"],"\x2A"=>[0,"\x3Cn"],"\x2B"=>[0,"\x3Cp"],"\x2C"=>[0,"\x3Cr"],"-"=>[0,"\x3Cu"],"."=>[100,"\x3C"],"\x2F"=>[110,"\x3C"],[111,"\x3C"],[115,"\x3C"],[116,"\x3C"],[118,"\x3C"],[119,"\x3C"],[122,"\x3C"],[123,"\x3C"],[125,"\x3C"],[126,"\x3C"],[129,"\x3C"],"\x3A"=>[143,"\x3C"],"\x3B"=>[148,"\x3C"],"\x3C"=>[151,"\x3C"],"\x3D"=>[153,"\x3C"],"\x3E"=>[83,"\x3C"],"\x3F"=>[10,"\x3C"],"\x40"=>[77,"\x600"],"A"=>[18,"\x600"],"B"=>[77,"\x601"],"C"=>[18,"\x601"],"D"=>[77,"\x602"],"E"=>[18,"\x602"],"F"=>[77,"\x60a"],"G"=>[18,"\x60a"],"H"=>[77,"\x60c"],"I"=>[18,"\x60c"],"J"=>[77,"\x60e"],"K"=>[18,"\x60e"],"L"=>[77,"\x60i"],"M"=>[18,"\x60i"],"N"=>[77,"\x60o"],"O"=>[18,"\x60o"],"P"=>[77,"\x60s"],"Q"=>[18,"\x60s"],"R"=>[77,"\x60t"],"S"=>[18,"\x60t"],"T"=>[0,"\x60\x20"],"U"=>[0,"\x60\x25"],"V"=>[0,"\x60-"],"W"=>[0,"\x60."],"X"=>[0,"\x60\x2F"],"Y"=>[0,"\x603"],"Z"=>[0,"\x604"],"\x5B"=>[0,"\x605"],"\x5C"=>[0,"\x606"],"\x5D"=>[0,"\x607"],"\x5E"=>[0,"\x608"],"_"=>[0,"\x609"],"\x60"=>[0,"\x60\x3D"],"a"=>[0,"\x60A"],"b"=>[0,"\x60_"],"c"=>[0,"\x60b"],"d"=>[0,"\x60d"],"e"=>[0,"\x60f"],"f"=>[0,"\x60g"],"g"=>[0,"\x60h"],"h"=>[0,"\x60l"],"i"=>[0,"\x60m"],"j"=>[0,"\x60n"],"k"=>[0,"\x60p"],"l"=>[0,"\x60r"],"m"=>[0,"\x60u"],"n"=>[100,"\x60"],"o"=>[110,"\x60"],"p"=>[111,"\x60"],"q"=>[115,"\x60"],"r"=>[116,"\x60"],"s"=>[118,"\x60"],"t"=>[119,"\x60"],"u"=>[122,"\x60"],"v"=>[123,"\x60"],"w"=>[125,"\x60"],"x"=>[126,"\x60"],"y"=>[129,"\x60"],"z"=>[143,"\x60"],"\x7B"=>[148,"\x60"],"\x7C"=>[151,"\x60"],"\x7D"=>[153,"\x60"],"~"=>[83,"\x60"],"\x7F"=>[10,"\x60"],"\x80"=>[77,"\x7B0"],"\x81"=>[18,"\x7B0"],"\x82"=>[77,"\x7B1"],"\x83"=>[18,"\x7B1"],"\x84"=>[77,"\x7B2"],"\x85"=>[18,"\x7B2"],"\x86"=>[77,"\x7Ba"],"\x87"=>[18,"\x7Ba"],"\x88"=>[77,"\x7Bc"],"\x89"=>[18,"\x7Bc"],"\x8A"=>[77,"\x7Be"],"\x8B"=>[18,"\x7Be"],"\x8C"=>[77,"\x7Bi"],"\x8D"=>[18,"\x7Bi"],"\x8E"=>[77,"\x7Bo"],"\x8F"=>[18,"\x7Bo"],"\x90"=>[77,"\x7Bs"],"\x91"=>[18,"\x7Bs"],"\x92"=>[77,"\x7Bt"],"\x93"=>[18,"\x7Bt"],"\x94"=>[0,"\x7B\x20"],"\x95"=>[0,"\x7B\x25"],"\x96"=>[0,"\x7B-"],"\x97"=>[0,"\x7B."],"\x98"=>[0,"\x7B\x2F"],"\x99"=>[0,"\x7B3"],"\x9A"=>[0,"\x7B4"],"\x9B"=>[0,"\x7B5"],"\x9C"=>[0,"\x7B6"],"\x9D"=>[0,"\x7B7"],"\x9E"=>[0,"\x7B8"],"\x9F"=>[0,"\x7B9"],"\xA0"=>[0,"\x7B\x3D"],"\xA1"=>[0,"\x7BA"],"\xA2"=>[0,"\x7B_"],"\xA3"=>[0,"\x7Bb"],"\xA4"=>[0,"\x7Bd"],"\xA5"=>[0,"\x7Bf"],"\xA6"=>[0,"\x7Bg"],"\xA7"=>[0,"\x7Bh"],"\xA8"=>[0,"\x7Bl"],"\xA9"=>[0,"\x7Bm"],"\xAA"=>[0,"\x7Bn"],"\xAB"=>[0,"\x7Bp"],"\xAC"=>[0,"\x7Br"],"\xAD"=>[0,"\x7Bu"],"\xAE"=>[100,"\x7B"],"\xAF"=>[110,"\x7B"],"\xB0"=>[111,"\x7B"],"\xB1"=>[115,"\x7B"],"\xB2"=>[116,"\x7B"],"\xB3"=>[118,"\x7B"],"\xB4"=>[119,"\x7B"],"\xB5"=>[122,"\x7B"],"\xB6"=>[123,"\x7B"],"\xB7"=>[125,"\x7B"],"\xB8"=>[126,"\x7B"],"\xB9"=>[129,"\x7B"],"\xBA"=>[143,"\x7B"],"\xBB"=>[148,"\x7B"],"\xBC"=>[151,"\x7B"],"\xBD"=>[153,"\x7B"],"\xBE"=>[83,"\x7B"],"\xBF"=>[10,"\x7B"],"\xC0"=>[94,"\x5C"],"\xC1"=>[76,"\x5C"],"\xC2"=>[104,"\x5C"],"\xC3"=>[16,"\x5C"],"\xC4"=>[94,"\xC3"],"\xC5"=>[76,"\xC3"],"\xC6"=>[104,"\xC3"],"\xC7"=>[16,"\xC3"],"\xC8"=>[94,"\xD0"],"\xC9"=>[76,"\xD0"],"\xCA"=>[104,"\xD0"],"\xCB"=>[16,"\xD0"],"\xCC"=>[77,"\x80"],"\xCD"=>[18,"\x80"],"\xCE"=>[77,"\x82"],"\xCF"=>[18,"\x82"],"\xD0"=>[77,"\x83"],"\xD1"=>[18,"\x83"],"\xD2"=>[77,"\xA2"],"\xD3"=>[18,"\xA2"],"\xD4"=>[77,"\xB8"],"\xD5"=>[18,"\xB8"],"\xD6"=>[77,"\xC2"],"\xD7"=>[18,"\xC2"],"\xD8"=>[77,"\xE0"],"\xD9"=>[18,"\xE0"],"\xDA"=>[77,"\xE2"],"\xDB"=>[18,"\xE2"],"\xDC"=>[0,"\x99"],"\xDD"=>[0,"\xA1"],"\xDE"=>[0,"\xA7"],"\xDF"=>[0,"\xAC"],"\xE0"=>[0,"\xB0"],"\xE1"=>[0,"\xB1"],"\xE2"=>[0,"\xB3"],"\xE3"=>[0,"\xD1"],"\xE4"=>[0,"\xD8"],"\xE5"=>[0,"\xD9"],"\xE6"=>[0,"\xE3"],"\xE7"=>[0,"\xE5"],"\xE8"=>[0,"\xE6"],"\xE9"=>[157,null],"\xEA"=>[165,null],"\xEB"=>[167,null],"\xEC"=>[185,null],"\xED"=>[189,null],"\xEE"=>[190,null],"\xEF"=>[197,null],"\xF0"=>[206,null],"\xF1"=>[212,null],"\xF2"=>[213,null],"\xF3"=>[217,null],"\xF4"=>[223,null],"\xF5"=>[250,null],"\xF6"=>[25,null],"\xF7"=>[170,null],"\xF8"=>[175,null],"\xF9"=>[181,null],"\xFA"=>[193,null],"\xFB"=>[202,null],"\xFC"=>[216,null],"\xFD"=>[50,null],"\xFE"=>[200,null],"\xFF"=>[35,null],],["\x00"=>[77,"\x010"],"\x01"=>[18,"\x010"],"\x02"=>[77,"\x011"],"\x03"=>[18,"\x011"],"\x04"=>[77,"\x012"],"\x05"=>[18,"\x012"],"\x06"=>[77,"\x01a"],"\x07"=>[18,"\x01a"],"\x08"=>[77,"\x01c"],"\x09"=>[18,"\x01c"],"\x0A"=>[77,"\x01e"],"\x0B"=>[18,"\x01e"],"\x0C"=>[77,"\x01i"],"\x0D"=>[18,"\x01i"],"\x0E"=>[77,"\x01o"],"\x0F"=>[18,"\x01o"],"\x10"=>[77,"\x01s"],"\x11"=>[18,"\x01s"],"\x12"=>[77,"\x01t"],"\x13"=>[18,"\x01t"],"\x14"=>[0,"\x01\x20"],"\x15"=>[0,"\x01\x25"],"\x16"=>[0,"\x01-"],"\x17"=>[0,"\x01."],"\x18"=>[0,"\x01\x2F"],"\x19"=>[0,"\x013"],"\x1A"=>[0,"\x014"],"\x1B"=>[0,"\x015"],"\x1C"=>[0,"\x016"],"\x1D"=>[0,"\x017"],"\x1E"=>[0,"\x018"],"\x1F"=>[0,"\x019"],"\x20"=>[0,"\x01\x3D"],"\x21"=>[0,"\x01A"],"\x22"=>[0,"\x01_"],"\x23"=>[0,"\x01b"],"\x24"=>[0,"\x01d"],"\x25"=>[0,"\x01f"],"\x26"=>[0,"\x01g"],"\x27"=>[0,"\x01h"],"\x28"=>[0,"\x01l"],"\x29"=>[0,"\x01m"],"\x2A"=>[0,"\x01n"],"\x2B"=>[0,"\x01p"],"\x2C"=>[0,"\x01r"],"-"=>[0,"\x01u"],"."=>[100,"\x01"],"\x2F"=>[110,"\x01"],[111,"\x01"],[115,"\x01"],[116,"\x01"],[118,"\x01"],[119,"\x01"],[122,"\x01"],[123,"\x01"],[125,"\x01"],[126,"\x01"],[129,"\x01"],"\x3A"=>[143,"\x01"],"\x3B"=>[148,"\x01"],"\x3C"=>[151,"\x01"],"\x3D"=>[153,"\x01"],"\x3E"=>[83,"\x01"],"\x3F"=>[10,"\x01"],"\x40"=>[77,"\x870"],"A"=>[18,"\x870"],"B"=>[77,"\x871"],"C"=>[18,"\x871"],"D"=>[77,"\x872"],"E"=>[18,"\x872"],"F"=>[77,"\x87a"],"G"=>[18,"\x87a"],"H"=>[77,"\x87c"],"I"=>[18,"\x87c"],"J"=>[77,"\x87e"],"K"=>[18,"\x87e"],"L"=>[77,"\x87i"],"M"=>[18,"\x87i"],"N"=>[77,"\x87o"],"O"=>[18,"\x87o"],"P"=>[77,"\x87s"],"Q"=>[18,"\x87s"],"R"=>[77,"\x87t"],"S"=>[18,"\x87t"],"T"=>[0,"\x87\x20"],"U"=>[0,"\x87\x25"],"V"=>[0,"\x87-"],"W"=>[0,"\x87."],"X"=>[0,"\x87\x2F"],"Y"=>[0,"\x873"],"Z"=>[0,"\x874"],"\x5B"=>[0,"\x875"],"\x5C"=>[0,"\x876"],"\x5D"=>[0,"\x877"],"\x5E"=>[0,"\x878"],"_"=>[0,"\x879"],"\x60"=>[0,"\x87\x3D"],"a"=>[0,"\x87A"],"b"=>[0,"\x87_"],"c"=>[0,"\x87b"],"d"=>[0,"\x87d"],"e"=>[0,"\x87f"],"f"=>[0,"\x87g"],"g"=>[0,"\x87h"],"h"=>[0,"\x87l"],"i"=>[0,"\x87m"],"j"=>[0,"\x87n"],"k"=>[0,"\x87p"],"l"=>[0,"\x87r"],"m"=>[0,"\x87u"],"n"=>[100,"\x87"],"o"=>[110,"\x87"],"p"=>[111,"\x87"],"q"=>[115,"\x87"],"r"=>[116,"\x87"],"s"=>[118,"\x87"],"t"=>[119,"\x87"],"u"=>[122,"\x87"],"v"=>[123,"\x87"],"w"=>[125,"\x87"],"x"=>[126,"\x87"],"y"=>[129,"\x87"],"z"=>[143,"\x87"],"\x7B"=>[148,"\x87"],"\x7C"=>[151,"\x87"],"\x7D"=>[153,"\x87"],"~"=>[83,"\x87"],"\x7F"=>[10,"\x87"],"\x80"=>[77,"\x890"],"\x81"=>[18,"\x890"],"\x82"=>[77,"\x891"],"\x83"=>[18,"\x891"],"\x84"=>[77,"\x892"],"\x85"=>[18,"\x892"],"\x86"=>[77,"\x89a"],"\x87"=>[18,"\x89a"],"\x88"=>[77,"\x89c"],"\x89"=>[18,"\x89c"],"\x8A"=>[77,"\x89e"],"\x8B"=>[18,"\x89e"],"\x8C"=>[77,"\x89i"],"\x8D"=>[18,"\x89i"],"\x8E"=>[77,"\x89o"],"\x8F"=>[18,"\x89o"],"\x90"=>[77,"\x89s"],"\x91"=>[18,"\x89s"],"\x92"=>[77,"\x89t"],"\x93"=>[18,"\x89t"],"\x94"=>[0,"\x89\x20"],"\x95"=>[0,"\x89\x25"],"\x96"=>[0,"\x89-"],"\x97"=>[0,"\x89."],"\x98"=>[0,"\x89\x2F"],"\x99"=>[0,"\x893"],"\x9A"=>[0,"\x894"],"\x9B"=>[0,"\x895"],"\x9C"=>[0,"\x896"],"\x9D"=>[0,"\x897"],"\x9E"=>[0,"\x898"],"\x9F"=>[0,"\x899"],"\xA0"=>[0,"\x89\x3D"],"\xA1"=>[0,"\x89A"],"\xA2"=>[0,"\x89_"],"\xA3"=>[0,"\x89b"],"\xA4"=>[0,"\x89d"],"\xA5"=>[0,"\x89f"],"\xA6"=>[0,"\x89g"],"\xA7"=>[0,"\x89h"],"\xA8"=>[0,"\x89l"],"\xA9"=>[0,"\x89m"],"\xAA"=>[0,"\x89n"],"\xAB"=>[0,"\x89p"],"\xAC"=>[0,"\x89r"],"\xAD"=>[0,"\x89u"],"\xAE"=>[100,"\x89"],"\xAF"=>[110,"\x89"],"\xB0"=>[111,"\x89"],"\xB1"=>[115,"\x89"],"\xB2"=>[116,"\x89"],"\xB3"=>[118,"\x89"],"\xB4"=>[119,"\x89"],"\xB5"=>[122,"\x89"],"\xB6"=>[123,"\x89"],"\xB7"=>[125,"\x89"],"\xB8"=>[126,"\x89"],"\xB9"=>[129,"\x89"],"\xBA"=>[143,"\x89"],"\xBB"=>[148,"\x89"],"\xBC"=>[151,"\x89"],"\xBD"=>[153,"\x89"],"\xBE"=>[83,"\x89"],"\xBF"=>[10,"\x89"],"\xC0"=>[77,"\x8A0"],"\xC1"=>[18,"\x8A0"],"\xC2"=>[77,"\x8A1"],"\xC3"=>[18,"\x8A1"],"\xC4"=>[77,"\x8A2"],"\xC5"=>[18,"\x8A2"],"\xC6"=>[77,"\x8Aa"],"\xC7"=>[18,"\x8Aa"],"\xC8"=>[77,"\x8Ac"],"\xC9"=>[18,"\x8Ac"],"\xCA"=>[77,"\x8Ae"],"\xCB"=>[18,"\x8Ae"],"\xCC"=>[77,"\x8Ai"],"\xCD"=>[18,"\x8Ai"],"\xCE"=>[77,"\x8Ao"],"\xCF"=>[18,"\x8Ao"],"\xD0"=>[77,"\x8As"],"\xD1"=>[18,"\x8As"],"\xD2"=>[77,"\x8At"],"\xD3"=>[18,"\x8At"],"\xD4"=>[0,"\x8A\x20"],"\xD5"=>[0,"\x8A\x25"],"\xD6"=>[0,"\x8A-"],"\xD7"=>[0,"\x8A."],"\xD8"=>[0,"\x8A\x2F"],"\xD9"=>[0,"\x8A3"],"\xDA"=>[0,"\x8A4"],"\xDB"=>[0,"\x8A5"],"\xDC"=>[0,"\x8A6"],"\xDD"=>[0,"\x8A7"],"\xDE"=>[0,"\x8A8"],"\xDF"=>[0,"\x8A9"],"\xE0"=>[0,"\x8A\x3D"],"\xE1"=>[0,"\x8AA"],"\xE2"=>[0,"\x8A_"],"\xE3"=>[0,"\x8Ab"],"\xE4"=>[0,"\x8Ad"],"\xE5"=>[0,"\x8Af"],"\xE6"=>[0,"\x8Ag"],"\xE7"=>[0,"\x8Ah"],"\xE8"=>[0,"\x8Al"],"\xE9"=>[0,"\x8Am"],"\xEA"=>[0,"\x8An"],"\xEB"=>[0,"\x8Ap"],"\xEC"=>[0,"\x8Ar"],"\xED"=>[0,"\x8Au"],"\xEE"=>[100,"\x8A"],"\xEF"=>[110,"\x8A"],"\xF0"=>[111,"\x8A"],"\xF1"=>[115,"\x8A"],"\xF2"=>[116,"\x8A"],"\xF3"=>[118,"\x8A"],"\xF4"=>[119,"\x8A"],"\xF5"=>[122,"\x8A"],"\xF6"=>[123,"\x8A"],"\xF7"=>[125,"\x8A"],"\xF8"=>[126,"\x8A"],"\xF9"=>[129,"\x8A"],"\xFA"=>[143,"\x8A"],"\xFB"=>[148,"\x8A"],"\xFC"=>[151,"\x8A"],"\xFD"=>[153,"\x8A"],"\xFE"=>[83,"\x8A"],"\xFF"=>[10,"\x8A"],],["\x00"=>[77,"\x5E0"],"\x01"=>[18,"\x5E0"],"\x02"=>[77,"\x5E1"],"\x03"=>[18,"\x5E1"],"\x04"=>[77,"\x5E2"],"\x05"=>[18,"\x5E2"],"\x06"=>[77,"\x5Ea"],"\x07"=>[18,"\x5Ea"],"\x08"=>[77,"\x5Ec"],"\x09"=>[18,"\x5Ec"],"\x0A"=>[77,"\x5Ee"],"\x0B"=>[18,"\x5Ee"],"\x0C"=>[77,"\x5Ei"],"\x0D"=>[18,"\x5Ei"],"\x0E"=>[77,"\x5Eo"],"\x0F"=>[18,"\x5Eo"],"\x10"=>[77,"\x5Es"],"\x11"=>[18,"\x5Es"],"\x12"=>[77,"\x5Et"],"\x13"=>[18,"\x5Et"],"\x14"=>[0,"\x5E\x20"],"\x15"=>[0,"\x5E\x25"],"\x16"=>[0,"\x5E-"],"\x17"=>[0,"\x5E."],"\x18"=>[0,"\x5E\x2F"],"\x19"=>[0,"\x5E3"],"\x1A"=>[0,"\x5E4"],"\x1B"=>[0,"\x5E5"],"\x1C"=>[0,"\x5E6"],"\x1D"=>[0,"\x5E7"],"\x1E"=>[0,"\x5E8"],"\x1F"=>[0,"\x5E9"],"\x20"=>[0,"\x5E\x3D"],"\x21"=>[0,"\x5EA"],"\x22"=>[0,"\x5E_"],"\x23"=>[0,"\x5Eb"],"\x24"=>[0,"\x5Ed"],"\x25"=>[0,"\x5Ef"],"\x26"=>[0,"\x5Eg"],"\x27"=>[0,"\x5Eh"],"\x28"=>[0,"\x5El"],"\x29"=>[0,"\x5Em"],"\x2A"=>[0,"\x5En"],"\x2B"=>[0,"\x5Ep"],"\x2C"=>[0,"\x5Er"],"-"=>[0,"\x5Eu"],"."=>[100,"\x5E"],"\x2F"=>[110,"\x5E"],[111,"\x5E"],[115,"\x5E"],[116,"\x5E"],[118,"\x5E"],[119,"\x5E"],[122,"\x5E"],[123,"\x5E"],[125,"\x5E"],[126,"\x5E"],[129,"\x5E"],"\x3A"=>[143,"\x5E"],"\x3B"=>[148,"\x5E"],"\x3C"=>[151,"\x5E"],"\x3D"=>[153,"\x5E"],"\x3E"=>[83,"\x5E"],"\x3F"=>[10,"\x5E"],"\x40"=>[77,"\x7D0"],"A"=>[18,"\x7D0"],"B"=>[77,"\x7D1"],"C"=>[18,"\x7D1"],"D"=>[77,"\x7D2"],"E"=>[18,"\x7D2"],"F"=>[77,"\x7Da"],"G"=>[18,"\x7Da"],"H"=>[77,"\x7Dc"],"I"=>[18,"\x7Dc"],"J"=>[77,"\x7De"],"K"=>[18,"\x7De"],"L"=>[77,"\x7Di"],"M"=>[18,"\x7Di"],"N"=>[77,"\x7Do"],"O"=>[18,"\x7Do"],"P"=>[77,"\x7Ds"],"Q"=>[18,"\x7Ds"],"R"=>[77,"\x7Dt"],"S"=>[18,"\x7Dt"],"T"=>[0,"\x7D\x20"],"U"=>[0,"\x7D\x25"],"V"=>[0,"\x7D-"],"W"=>[0,"\x7D."],"X"=>[0,"\x7D\x2F"],"Y"=>[0,"\x7D3"],"Z"=>[0,"\x7D4"],"\x5B"=>[0,"\x7D5"],"\x5C"=>[0,"\x7D6"],"\x5D"=>[0,"\x7D7"],"\x5E"=>[0,"\x7D8"],"_"=>[0,"\x7D9"],"\x60"=>[0,"\x7D\x3D"],"a"=>[0,"\x7DA"],"b"=>[0,"\x7D_"],"c"=>[0,"\x7Db"],"d"=>[0,"\x7Dd"],"e"=>[0,"\x7Df"],"f"=>[0,"\x7Dg"],"g"=>[0,"\x7Dh"],"h"=>[0,"\x7Dl"],"i"=>[0,"\x7Dm"],"j"=>[0,"\x7Dn"],"k"=>[0,"\x7Dp"],"l"=>[0,"\x7Dr"],"m"=>[0,"\x7Du"],"n"=>[100,"\x7D"],"o"=>[110,"\x7D"],"p"=>[111,"\x7D"],"q"=>[115,"\x7D"],"r"=>[116,"\x7D"],"s"=>[118,"\x7D"],"t"=>[119,"\x7D"],"u"=>[122,"\x7D"],"v"=>[123,"\x7D"],"w"=>[125,"\x7D"],"x"=>[126,"\x7D"],"y"=>[129,"\x7D"],"z"=>[143,"\x7D"],"\x7B"=>[148,"\x7D"],"\x7C"=>[151,"\x7D"],"\x7D"=>[153,"\x7D"],"~"=>[83,"\x7D"],"\x7F"=>[10,"\x7D"],"\x80"=>[0,"\x3C0"],"\x81"=>[0,"\x3C1"],"\x82"=>[0,"\x3C2"],"\x83"=>[0,"\x3Ca"],"\x84"=>[0,"\x3Cc"],"\x85"=>[0,"\x3Ce"],"\x86"=>[0,"\x3Ci"],"\x87"=>[0,"\x3Co"],"\x88"=>[0,"\x3Cs"],"\x89"=>[0,"\x3Ct"],"\x8A"=>[73,"\x3C"],"\x8B"=>[88,"\x3C"],"\x8C"=>[89,"\x3C"],"\x8D"=>[96,"\x3C"],"\x8E"=>[97,"\x3C"],"\x8F"=>[99,"\x3C"],"\x90"=>[106,"\x3C"],"\x91"=>[136,"\x3C"],"\x92"=>[139,"\x3C"],"\x93"=>[141,"\x3C"],"\x94"=>[145,"\x3C"],"\x95"=>[147,"\x3C"],"\x96"=>[149,"\x3C"],"\x97"=>[101,"\x3C"],"\x98"=>[112,"\x3C"],"\x99"=>[117,"\x3C"],"\x9A"=>[120,"\x3C"],"\x9B"=>[124,"\x3C"],"\x9C"=>[127,"\x3C"],"\x9D"=>[144,"\x3C"],"\x9E"=>[152,"\x3C"],"\x9F"=>[11,"\x3C"],"\xA0"=>[0,"\x600"],"\xA1"=>[0,"\x601"],"\xA2"=>[0,"\x602"],"\xA3"=>[0,"\x60a"],"\xA4"=>[0,"\x60c"],"\xA5"=>[0,"\x60e"],"\xA6"=>[0,"\x60i"],"\xA7"=>[0,"\x60o"],"\xA8"=>[0,"\x60s"],"\xA9"=>[0,"\x60t"],"\xAA"=>[73,"\x60"],"\xAB"=>[88,"\x60"],"\xAC"=>[89,"\x60"],"\xAD"=>[96,"\x60"],"\xAE"=>[97,"\x60"],"\xAF"=>[99,"\x60"],"\xB0"=>[106,"\x60"],"\xB1"=>[136,"\x60"],"\xB2"=>[139,"\x60"],"\xB3"=>[141,"\x60"],"\xB4"=>[145,"\x60"],"\xB5"=>[147,"\x60"],"\xB6"=>[149,"\x60"],"\xB7"=>[101,"\x60"],"\xB8"=>[112,"\x60"],"\xB9"=>[117,"\x60"],"\xBA"=>[120,"\x60"],"\xBB"=>[124,"\x60"],"\xBC"=>[127,"\x60"],"\xBD"=>[144,"\x60"],"\xBE"=>[152,"\x60"],"\xBF"=>[11,"\x60"],"\xC0"=>[0,"\x7B0"],"\xC1"=>[0,"\x7B1"],"\xC2"=>[0,"\x7B2"],"\xC3"=>[0,"\x7Ba"],"\xC4"=>[0,"\x7Bc"],"\xC5"=>[0,"\x7Be"],"\xC6"=>[0,"\x7Bi"],"\xC7"=>[0,"\x7Bo"],"\xC8"=>[0,"\x7Bs"],"\xC9"=>[0,"\x7Bt"],"\xCA"=>[73,"\x7B"],"\xCB"=>[88,"\x7B"],"\xCC"=>[89,"\x7B"],"\xCD"=>[96,"\x7B"],"\xCE"=>[97,"\x7B"],"\xCF"=>[99,"\x7B"],"\xD0"=>[106,"\x7B"],"\xD1"=>[136,"\x7B"],"\xD2"=>[139,"\x7B"],"\xD3"=>[141,"\x7B"],"\xD4"=>[145,"\x7B"],"\xD5"=>[147,"\x7B"],"\xD6"=>[149,"\x7B"],"\xD7"=>[101,"\x7B"],"\xD8"=>[112,"\x7B"],"\xD9"=>[117,"\x7B"],"\xDA"=>[120,"\x7B"],"\xDB"=>[124,"\x7B"],"\xDC"=>[127,"\x7B"],"\xDD"=>[144,"\x7B"],"\xDE"=>[152,"\x7B"],"\xDF"=>[11,"\x7B"],"\xE0"=>[77,"\x5C"],"\xE1"=>[18,"\x5C"],"\xE2"=>[77,"\xC3"],"\xE3"=>[18,"\xC3"],"\xE4"=>[77,"\xD0"],"\xE5"=>[18,"\xD0"],"\xE6"=>[0,"\x80"],"\xE7"=>[0,"\x82"],"\xE8"=>[0,"\x83"],"\xE9"=>[0,"\xA2"],"\xEA"=>[0,"\xB8"],"\xEB"=>[0,"\xC2"],"\xEC"=>[0,"\xE0"],"\xED"=>[0,"\xE2"],"\xEE"=>[182,null],"\xEF"=>[195,null],"\xF0"=>[203,null],"\xF1"=>[209,null],"\xF2"=>[242,null],"\xF3"=>[249,null],"\xF4"=>[158,null],"\xF5"=>[166,null],"\xF6"=>[186,null],"\xF7"=>[191,null],"\xF8"=>[207,null],"\xF9"=>[214,null],"\xFA"=>[224,null],"\xFB"=>[27,null],"\xFC"=>[176,null],"\xFD"=>[194,null],"\xFE"=>[51,null],"\xFF"=>[36,null],],["\x00"=>[0,"\x010"],"\x01"=>[0,"\x011"],"\x02"=>[0,"\x012"],"\x03"=>[0,"\x01a"],"\x04"=>[0,"\x01c"],"\x05"=>[0,"\x01e"],"\x06"=>[0,"\x01i"],"\x07"=>[0,"\x01o"],"\x08"=>[0,"\x01s"],"\x09"=>[0,"\x01t"],"\x0A"=>[73,"\x01"],"\x0B"=>[88,"\x01"],"\x0C"=>[89,"\x01"],"\x0D"=>[96,"\x01"],"\x0E"=>[97,"\x01"],"\x0F"=>[99,"\x01"],"\x10"=>[106,"\x01"],"\x11"=>[136,"\x01"],"\x12"=>[139,"\x01"],"\x13"=>[141,"\x01"],"\x14"=>[145,"\x01"],"\x15"=>[147,"\x01"],"\x16"=>[149,"\x01"],"\x17"=>[101,"\x01"],"\x18"=>[112,"\x01"],"\x19"=>[117,"\x01"],"\x1A"=>[120,"\x01"],"\x1B"=>[124,"\x01"],"\x1C"=>[127,"\x01"],"\x1D"=>[144,"\x01"],"\x1E"=>[152,"\x01"],"\x1F"=>[11,"\x01"],"\x20"=>[0,"\x870"],"\x21"=>[0,"\x871"],"\x22"=>[0,"\x872"],"\x23"=>[0,"\x87a"],"\x24"=>[0,"\x87c"],"\x25"=>[0,"\x87e"],"\x26"=>[0,"\x87i"],"\x27"=>[0,"\x87o"],"\x28"=>[0,"\x87s"],"\x29"=>[0,"\x87t"],"\x2A"=>[73,"\x87"],"\x2B"=>[88,"\x87"],"\x2C"=>[89,"\x87"],"-"=>[96,"\x87"],"."=>[97,"\x87"],"\x2F"=>[99,"\x87"],[106,"\x87"],[136,"\x87"],[139,"\x87"],[141,"\x87"],[145,"\x87"],[147,"\x87"],[149,"\x87"],[101,"\x87"],[112,"\x87"],[117,"\x87"],"\x3A"=>[120,"\x87"],"\x3B"=>[124,"\x87"],"\x3C"=>[127,"\x87"],"\x3D"=>[144,"\x87"],"\x3E"=>[152,"\x87"],"\x3F"=>[11,"\x87"],"\x40"=>[0,"\x890"],"A"=>[0,"\x891"],"B"=>[0,"\x892"],"C"=>[0,"\x89a"],"D"=>[0,"\x89c"],"E"=>[0,"\x89e"],"F"=>[0,"\x89i"],"G"=>[0,"\x89o"],"H"=>[0,"\x89s"],"I"=>[0,"\x89t"],"J"=>[73,"\x89"],"K"=>[88,"\x89"],"L"=>[89,"\x89"],"M"=>[96,"\x89"],"N"=>[97,"\x89"],"O"=>[99,"\x89"],"P"=>[106,"\x89"],"Q"=>[136,"\x89"],"R"=>[139,"\x89"],"S"=>[141,"\x89"],"T"=>[145,"\x89"],"U"=>[147,"\x89"],"V"=>[149,"\x89"],"W"=>[101,"\x89"],"X"=>[112,"\x89"],"Y"=>[117,"\x89"],"Z"=>[120,"\x89"],"\x5B"=>[124,"\x89"],"\x5C"=>[127,"\x89"],"\x5D"=>[144,"\x89"],"\x5E"=>[152,"\x89"],"_"=>[11,"\x89"],"\x60"=>[0,"\x8A0"],"a"=>[0,"\x8A1"],"b"=>[0,"\x8A2"],"c"=>[0,"\x8Aa"],"d"=>[0,"\x8Ac"],"e"=>[0,"\x8Ae"],"f"=>[0,"\x8Ai"],"g"=>[0,"\x8Ao"],"h"=>[0,"\x8As"],"i"=>[0,"\x8At"],"j"=>[73,"\x8A"],"k"=>[88,"\x8A"],"l"=>[89,"\x8A"],"m"=>[96,"\x8A"],"n"=>[97,"\x8A"],"o"=>[99,"\x8A"],"p"=>[106,"\x8A"],"q"=>[136,"\x8A"],"r"=>[139,"\x8A"],"s"=>[141,"\x8A"],"t"=>[145,"\x8A"],"u"=>[147,"\x8A"],"v"=>[149,"\x8A"],"w"=>[101,"\x8A"],"x"=>[112,"\x8A"],"y"=>[117,"\x8A"],"z"=>[120,"\x8A"],"\x7B"=>[124,"\x8A"],"\x7C"=>[127,"\x8A"],"\x7D"=>[144,"\x8A"],"~"=>[152,"\x8A"],"\x7F"=>[11,"\x8A"],"\x80"=>[0,"\x8B0"],"\x81"=>[0,"\x8B1"],"\x82"=>[0,"\x8B2"],"\x83"=>[0,"\x8Ba"],"\x84"=>[0,"\x8Bc"],"\x85"=>[0,"\x8Be"],"\x86"=>[0,"\x8Bi"],"\x87"=>[0,"\x8Bo"],"\x88"=>[0,"\x8Bs"],"\x89"=>[0,"\x8Bt"],"\x8A"=>[73,"\x8B"],"\x8B"=>[88,"\x8B"],"\x8C"=>[89,"\x8B"],"\x8D"=>[96,"\x8B"],"\x8E"=>[97,"\x8B"],"\x8F"=>[99,"\x8B"],"\x90"=>[106,"\x8B"],"\x91"=>[136,"\x8B"],"\x92"=>[139,"\x8B"],"\x93"=>[141,"\x8B"],"\x94"=>[145,"\x8B"],"\x95"=>[147,"\x8B"],"\x96"=>[149,"\x8B"],"\x97"=>[101,"\x8B"],"\x98"=>[112,"\x8B"],"\x99"=>[117,"\x8B"],"\x9A"=>[120,"\x8B"],"\x9B"=>[124,"\x8B"],"\x9C"=>[127,"\x8B"],"\x9D"=>[144,"\x8B"],"\x9E"=>[152,"\x8B"],"\x9F"=>[11,"\x8B"],"\xA0"=>[0,"\x8C0"],"\xA1"=>[0,"\x8C1"],"\xA2"=>[0,"\x8C2"],"\xA3"=>[0,"\x8Ca"],"\xA4"=>[0,"\x8Cc"],"\xA5"=>[0,"\x8Ce"],"\xA6"=>[0,"\x8Ci"],"\xA7"=>[0,"\x8Co"],"\xA8"=>[0,"\x8Cs"],"\xA9"=>[0,"\x8Ct"],"\xAA"=>[73,"\x8C"],"\xAB"=>[88,"\x8C"],"\xAC"=>[89,"\x8C"],"\xAD"=>[96,"\x8C"],"\xAE"=>[97,"\x8C"],"\xAF"=>[99,"\x8C"],"\xB0"=>[106,"\x8C"],"\xB1"=>[136,"\x8C"],"\xB2"=>[139,"\x8C"],"\xB3"=>[141,"\x8C"],"\xB4"=>[145,"\x8C"],"\xB5"=>[147,"\x8C"],"\xB6"=>[149,"\x8C"],"\xB7"=>[101,"\x8C"],"\xB8"=>[112,"\x8C"],"\xB9"=>[117,"\x8C"],"\xBA"=>[120,"\x8C"],"\xBB"=>[124,"\x8C"],"\xBC"=>[127,"\x8C"],"\xBD"=>[144,"\x8C"],"\xBE"=>[152,"\x8C"],"\xBF"=>[11,"\x8C"],"\xC0"=>[0,"\x8D0"],"\xC1"=>[0,"\x8D1"],"\xC2"=>[0,"\x8D2"],"\xC3"=>[0,"\x8Da"],"\xC4"=>[0,"\x8Dc"],"\xC5"=>[0,"\x8De"],"\xC6"=>[0,"\x8Di"],"\xC7"=>[0,"\x8Do"],"\xC8"=>[0,"\x8Ds"],"\xC9"=>[0,"\x8Dt"],"\xCA"=>[73,"\x8D"],"\xCB"=>[88,"\x8D"],"\xCC"=>[89,"\x8D"],"\xCD"=>[96,"\x8D"],"\xCE"=>[97,"\x8D"],"\xCF"=>[99,"\x8D"],"\xD0"=>[106,"\x8D"],"\xD1"=>[136,"\x8D"],"\xD2"=>[139,"\x8D"],"\xD3"=>[141,"\x8D"],"\xD4"=>[145,"\x8D"],"\xD5"=>[147,"\x8D"],"\xD6"=>[149,"\x8D"],"\xD7"=>[101,"\x8D"],"\xD8"=>[112,"\x8D"],"\xD9"=>[117,"\x8D"],"\xDA"=>[120,"\x8D"],"\xDB"=>[124,"\x8D"],"\xDC"=>[127,"\x8D"],"\xDD"=>[144,"\x8D"],"\xDE"=>[152,"\x8D"],"\xDF"=>[11,"\x8D"],"\xE0"=>[0,"\x8F0"],"\xE1"=>[0,"\x8F1"],"\xE2"=>[0,"\x8F2"],"\xE3"=>[0,"\x8Fa"],"\xE4"=>[0,"\x8Fc"],"\xE5"=>[0,"\x8Fe"],"\xE6"=>[0,"\x8Fi"],"\xE7"=>[0,"\x8Fo"],"\xE8"=>[0,"\x8Fs"],"\xE9"=>[0,"\x8Ft"],"\xEA"=>[73,"\x8F"],"\xEB"=>[88,"\x8F"],"\xEC"=>[89,"\x8F"],"\xED"=>[96,"\x8F"],"\xEE"=>[97,"\x8F"],"\xEF"=>[99,"\x8F"],"\xF0"=>[106,"\x8F"],"\xF1"=>[136,"\x8F"],"\xF2"=>[139,"\x8F"],"\xF3"=>[141,"\x8F"],"\xF4"=>[145,"\x8F"],"\xF5"=>[147,"\x8F"],"\xF6"=>[149,"\x8F"],"\xF7"=>[101,"\x8F"],"\xF8"=>[112,"\x8F"],"\xF9"=>[117,"\x8F"],"\xFA"=>[120,"\x8F"],"\xFB"=>[124,"\x8F"],"\xFC"=>[127,"\x8F"],"\xFD"=>[144,"\x8F"],"\xFE"=>[152,"\x8F"],"\xFF"=>[11,"\x8F"],],["\x00"=>[77,"\x5D0"],"\x01"=>[18,"\x5D0"],"\x02"=>[77,"\x5D1"],"\x03"=>[18,"\x5D1"],"\x04"=>[77,"\x5D2"],"\x05"=>[18,"\x5D2"],"\x06"=>[77,"\x5Da"],"\x07"=>[18,"\x5Da"],"\x08"=>[77,"\x5Dc"],"\x09"=>[18,"\x5Dc"],"\x0A"=>[77,"\x5De"],"\x0B"=>[18,"\x5De"],"\x0C"=>[77,"\x5Di"],"\x0D"=>[18,"\x5Di"],"\x0E"=>[77,"\x5Do"],"\x0F"=>[18,"\x5Do"],"\x10"=>[77,"\x5Ds"],"\x11"=>[18,"\x5Ds"],"\x12"=>[77,"\x5Dt"],"\x13"=>[18,"\x5Dt"],"\x14"=>[0,"\x5D\x20"],"\x15"=>[0,"\x5D\x25"],"\x16"=>[0,"\x5D-"],"\x17"=>[0,"\x5D."],"\x18"=>[0,"\x5D\x2F"],"\x19"=>[0,"\x5D3"],"\x1A"=>[0,"\x5D4"],"\x1B"=>[0,"\x5D5"],"\x1C"=>[0,"\x5D6"],"\x1D"=>[0,"\x5D7"],"\x1E"=>[0,"\x5D8"],"\x1F"=>[0,"\x5D9"],"\x20"=>[0,"\x5D\x3D"],"\x21"=>[0,"\x5DA"],"\x22"=>[0,"\x5D_"],"\x23"=>[0,"\x5Db"],"\x24"=>[0,"\x5Dd"],"\x25"=>[0,"\x5Df"],"\x26"=>[0,"\x5Dg"],"\x27"=>[0,"\x5Dh"],"\x28"=>[0,"\x5Dl"],"\x29"=>[0,"\x5Dm"],"\x2A"=>[0,"\x5Dn"],"\x2B"=>[0,"\x5Dp"],"\x2C"=>[0,"\x5Dr"],"-"=>[0,"\x5Du"],"."=>[100,"\x5D"],"\x2F"=>[110,"\x5D"],[111,"\x5D"],[115,"\x5D"],[116,"\x5D"],[118,"\x5D"],[119,"\x5D"],[122,"\x5D"],[123,"\x5D"],[125,"\x5D"],[126,"\x5D"],[129,"\x5D"],"\x3A"=>[143,"\x5D"],"\x3B"=>[148,"\x5D"],"\x3C"=>[151,"\x5D"],"\x3D"=>[153,"\x5D"],"\x3E"=>[83,"\x5D"],"\x3F"=>[10,"\x5D"],"\x40"=>[77,"~0"],"A"=>[18,"~0"],"B"=>[77,"~1"],"C"=>[18,"~1"],"D"=>[77,"~2"],"E"=>[18,"~2"],"F"=>[77,"~a"],"G"=>[18,"~a"],"H"=>[77,"~c"],"I"=>[18,"~c"],"J"=>[77,"~e"],"K"=>[18,"~e"],"L"=>[77,"~i"],"M"=>[18,"~i"],"N"=>[77,"~o"],"O"=>[18,"~o"],"P"=>[77,"~s"],"Q"=>[18,"~s"],"R"=>[77,"~t"],"S"=>[18,"~t"],"T"=>[0,"~\x20"],"U"=>[0,"~\x25"],"V"=>[0,"~-"],"W"=>[0,"~."],"X"=>[0,"~\x2F"],"Y"=>[0,"~3"],"Z"=>[0,"~4"],"\x5B"=>[0,"~5"],"\x5C"=>[0,"~6"],"\x5D"=>[0,"~7"],"\x5E"=>[0,"~8"],"_"=>[0,"~9"],"\x60"=>[0,"~\x3D"],"a"=>[0,"~A"],"b"=>[0,"~_"],"c"=>[0,"~b"],"d"=>[0,"~d"],"e"=>[0,"~f"],"f"=>[0,"~g"],"g"=>[0,"~h"],"h"=>[0,"~l"],"i"=>[0,"~m"],"j"=>[0,"~n"],"k"=>[0,"~p"],"l"=>[0,"~r"],"m"=>[0,"~u"],"n"=>[100,"~"],"o"=>[110,"~"],"p"=>[111,"~"],"q"=>[115,"~"],"r"=>[116,"~"],"s"=>[118,"~"],"t"=>[119,"~"],"u"=>[122,"~"],"v"=>[123,"~"],"w"=>[125,"~"],"x"=>[126,"~"],"y"=>[129,"~"],"z"=>[143,"~"],"\x7B"=>[148,"~"],"\x7C"=>[151,"~"],"\x7D"=>[153,"~"],"~"=>[83,"~"],"\x7F"=>[10,"~"],"\x80"=>[0,"\x5E0"],"\x81"=>[0,"\x5E1"],"\x82"=>[0,"\x5E2"],"\x83"=>[0,"\x5Ea"],"\x84"=>[0,"\x5Ec"],"\x85"=>[0,"\x5Ee"],"\x86"=>[0,"\x5Ei"],"\x87"=>[0,"\x5Eo"],"\x88"=>[0,"\x5Es"],"\x89"=>[0,"\x5Et"],"\x8A"=>[73,"\x5E"],"\x8B"=>[88,"\x5E"],"\x8C"=>[89,"\x5E"],"\x8D"=>[96,"\x5E"],"\x8E"=>[97,"\x5E"],"\x8F"=>[99,"\x5E"],"\x90"=>[106,"\x5E"],"\x91"=>[136,"\x5E"],"\x92"=>[139,"\x5E"],"\x93"=>[141,"\x5E"],"\x94"=>[145,"\x5E"],"\x95"=>[147,"\x5E"],"\x96"=>[149,"\x5E"],"\x97"=>[101,"\x5E"],"\x98"=>[112,"\x5E"],"\x99"=>[117,"\x5E"],"\x9A"=>[120,"\x5E"],"\x9B"=>[124,"\x5E"],"\x9C"=>[127,"\x5E"],"\x9D"=>[144,"\x5E"],"\x9E"=>[152,"\x5E"],"\x9F"=>[11,"\x5E"],"\xA0"=>[0,"\x7D0"],"\xA1"=>[0,"\x7D1"],"\xA2"=>[0,"\x7D2"],"\xA3"=>[0,"\x7Da"],"\xA4"=>[0,"\x7Dc"],"\xA5"=>[0,"\x7De"],"\xA6"=>[0,"\x7Di"],"\xA7"=>[0,"\x7Do"],"\xA8"=>[0,"\x7Ds"],"\xA9"=>[0,"\x7Dt"],"\xAA"=>[73,"\x7D"],"\xAB"=>[88,"\x7D"],"\xAC"=>[89,"\x7D"],"\xAD"=>[96,"\x7D"],"\xAE"=>[97,"\x7D"],"\xAF"=>[99,"\x7D"],"\xB0"=>[106,"\x7D"],"\xB1"=>[136,"\x7D"],"\xB2"=>[139,"\x7D"],"\xB3"=>[141,"\x7D"],"\xB4"=>[145,"\x7D"],"\xB5"=>[147,"\x7D"],"\xB6"=>[149,"\x7D"],"\xB7"=>[101,"\x7D"],"\xB8"=>[112,"\x7D"],"\xB9"=>[117,"\x7D"],"\xBA"=>[120,"\x7D"],"\xBB"=>[124,"\x7D"],"\xBC"=>[127,"\x7D"],"\xBD"=>[144,"\x7D"],"\xBE"=>[152,"\x7D"],"\xBF"=>[11,"\x7D"],"\xC0"=>[92,"\x3C"],"\xC1"=>[95,"\x3C"],"\xC2"=>[137,"\x3C"],"\xC3"=>[142,"\x3C"],"\xC4"=>[150,"\x3C"],"\xC5"=>[74,"\x3C"],"\xC6"=>[90,"\x3C"],"\xC7"=>[98,"\x3C"],"\xC8"=>[107,"\x3C"],"\xC9"=>[140,"\x3C"],"\xCA"=>[146,"\x3C"],"\xCB"=>[102,"\x3C"],"\xCC"=>[113,"\x3C"],"\xCD"=>[121,"\x3C"],"\xCE"=>[128,"\x3C"],"\xCF"=>[12,"\x3C"],"\xD0"=>[92,"\x60"],"\xD1"=>[95,"\x60"],"\xD2"=>[137,"\x60"],"\xD3"=>[142,"\x60"],"\xD4"=>[150,"\x60"],"\xD5"=>[74,"\x60"],"\xD6"=>[90,"\x60"],"\xD7"=>[98,"\x60"],"\xD8"=>[107,"\x60"],"\xD9"=>[140,"\x60"],"\xDA"=>[146,"\x60"],"\xDB"=>[102,"\x60"],"\xDC"=>[113,"\x60"],"\xDD"=>[121,"\x60"],"\xDE"=>[128,"\x60"],"\xDF"=>[12,"\x60"],"\xE0"=>[92,"\x7B"],"\xE1"=>[95,"\x7B"],"\xE2"=>[137,"\x7B"],"\xE3"=>[142,"\x7B"],"\xE4"=>[150,"\x7B"],"\xE5"=>[74,"\x7B"],"\xE6"=>[90,"\x7B"],"\xE7"=>[98,"\x7B"],"\xE8"=>[107,"\x7B"],"\xE9"=>[140,"\x7B"],"\xEA"=>[146,"\x7B"],"\xEB"=>[102,"\x7B"],"\xEC"=>[113,"\x7B"],"\xED"=>[121,"\x7B"],"\xEE"=>[128,"\x7B"],"\xEF"=>[12,"\x7B"],"\xF0"=>[0,"\x5C"],"\xF1"=>[0,"\xC3"],"\xF2"=>[0,"\xD0"],"\xF3"=>[155,null],"\xF4"=>[162,null],"\xF5"=>[211,null],"\xF6"=>[248,null],"\xF7"=>[183,null],"\xF8"=>[204,null],"\xF9"=>[243,null],"\xFA"=>[159,null],"\xFB"=>[187,null],"\xFC"=>[208,null],"\xFD"=>[29,null],"\xFE"=>[177,null],"\xFF"=>[37,null],],["\x00"=>[0,"\xC60"],"\x01"=>[0,"\xC61"],"\x02"=>[0,"\xC62"],"\x03"=>[0,"\xC6a"],"\x04"=>[0,"\xC6c"],"\x05"=>[0,"\xC6e"],"\x06"=>[0,"\xC6i"],"\x07"=>[0,"\xC6o"],"\x08"=>[0,"\xC6s"],"\x09"=>[0,"\xC6t"],"\x0A"=>[73,"\xC6"],"\x0B"=>[88,"\xC6"],"\x0C"=>[89,"\xC6"],"\x0D"=>[96,"\xC6"],"\x0E"=>[97,"\xC6"],"\x0F"=>[99,"\xC6"],"\x10"=>[106,"\xC6"],"\x11"=>[136,"\xC6"],"\x12"=>[139,"\xC6"],"\x13"=>[141,"\xC6"],"\x14"=>[145,"\xC6"],"\x15"=>[147,"\xC6"],"\x16"=>[149,"\xC6"],"\x17"=>[101,"\xC6"],"\x18"=>[112,"\xC6"],"\x19"=>[117,"\xC6"],"\x1A"=>[120,"\xC6"],"\x1B"=>[124,"\xC6"],"\x1C"=>[127,"\xC6"],"\x1D"=>[144,"\xC6"],"\x1E"=>[152,"\xC6"],"\x1F"=>[11,"\xC6"],"\x20"=>[0,"\xE40"],"\x21"=>[0,"\xE41"],"\x22"=>[0,"\xE42"],"\x23"=>[0,"\xE4a"],"\x24"=>[0,"\xE4c"],"\x25"=>[0,"\xE4e"],"\x26"=>[0,"\xE4i"],"\x27"=>[0,"\xE4o"],"\x28"=>[0,"\xE4s"],"\x29"=>[0,"\xE4t"],"\x2A"=>[73,"\xE4"],"\x2B"=>[88,"\xE4"],"\x2C"=>[89,"\xE4"],"-"=>[96,"\xE4"],"."=>[97,"\xE4"],"\x2F"=>[99,"\xE4"],[106,"\xE4"],[136,"\xE4"],[139,"\xE4"],[141,"\xE4"],[145,"\xE4"],[147,"\xE4"],[149,"\xE4"],[101,"\xE4"],[112,"\xE4"],[117,"\xE4"],"\x3A"=>[120,"\xE4"],"\x3B"=>[124,"\xE4"],"\x3C"=>[127,"\xE4"],"\x3D"=>[144,"\xE4"],"\x3E"=>[152,"\xE4"],"\x3F"=>[11,"\xE4"],"\x40"=>[0,"\xE80"],"A"=>[0,"\xE81"],"B"=>[0,"\xE82"],"C"=>[0,"\xE8a"],"D"=>[0,"\xE8c"],"E"=>[0,"\xE8e"],"F"=>[0,"\xE8i"],"G"=>[0,"\xE8o"],"H"=>[0,"\xE8s"],"I"=>[0,"\xE8t"],"J"=>[73,"\xE8"],"K"=>[88,"\xE8"],"L"=>[89,"\xE8"],"M"=>[96,"\xE8"],"N"=>[97,"\xE8"],"O"=>[99,"\xE8"],"P"=>[106,"\xE8"],"Q"=>[136,"\xE8"],"R"=>[139,"\xE8"],"S"=>[141,"\xE8"],"T"=>[145,"\xE8"],"U"=>[147,"\xE8"],"V"=>[149,"\xE8"],"W"=>[101,"\xE8"],"X"=>[112,"\xE8"],"Y"=>[117,"\xE8"],"Z"=>[120,"\xE8"],"\x5B"=>[124,"\xE8"],"\x5C"=>[127,"\xE8"],"\x5D"=>[144,"\xE8"],"\x5E"=>[152,"\xE8"],"_"=>[11,"\xE8"],"\x60"=>[0,"\xE90"],"a"=>[0,"\xE91"],"b"=>[0,"\xE92"],"c"=>[0,"\xE9a"],"d"=>[0,"\xE9c"],"e"=>[0,"\xE9e"],"f"=>[0,"\xE9i"],"g"=>[0,"\xE9o"],"h"=>[0,"\xE9s"],"i"=>[0,"\xE9t"],"j"=>[73,"\xE9"],"k"=>[88,"\xE9"],"l"=>[89,"\xE9"],"m"=>[96,"\xE9"],"n"=>[97,"\xE9"],"o"=>[99,"\xE9"],"p"=>[106,"\xE9"],"q"=>[136,"\xE9"],"r"=>[139,"\xE9"],"s"=>[141,"\xE9"],"t"=>[145,"\xE9"],"u"=>[147,"\xE9"],"v"=>[149,"\xE9"],"w"=>[101,"\xE9"],"x"=>[112,"\xE9"],"y"=>[117,"\xE9"],"z"=>[120,"\xE9"],"\x7B"=>[124,"\xE9"],"\x7C"=>[127,"\xE9"],"\x7D"=>[144,"\xE9"],"~"=>[152,"\xE9"],"\x7F"=>[11,"\xE9"],"\x80"=>[92,"\x01"],"\x81"=>[95,"\x01"],"\x82"=>[137,"\x01"],"\x83"=>[142,"\x01"],"\x84"=>[150,"\x01"],"\x85"=>[74,"\x01"],"\x86"=>[90,"\x01"],"\x87"=>[98,"\x01"],"\x88"=>[107,"\x01"],"\x89"=>[140,"\x01"],"\x8A"=>[146,"\x01"],"\x8B"=>[102,"\x01"],"\x8C"=>[113,"\x01"],"\x8D"=>[121,"\x01"],"\x8E"=>[128,"\x01"],"\x8F"=>[12,"\x01"],"\x90"=>[92,"\x87"],"\x91"=>[95,"\x87"],"\x92"=>[137,"\x87"],"\x93"=>[142,"\x87"],"\x94"=>[150,"\x87"],"\x95"=>[74,"\x87"],"\x96"=>[90,"\x87"],"\x97"=>[98,"\x87"],"\x98"=>[107,"\x87"],"\x99"=>[140,"\x87"],"\x9A"=>[146,"\x87"],"\x9B"=>[102,"\x87"],"\x9C"=>[113,"\x87"],"\x9D"=>[121,"\x87"],"\x9E"=>[128,"\x87"],"\x9F"=>[12,"\x87"],"\xA0"=>[92,"\x89"],"\xA1"=>[95,"\x89"],"\xA2"=>[137,"\x89"],"\xA3"=>[142,"\x89"],"\xA4"=>[150,"\x89"],"\xA5"=>[74,"\x89"],"\xA6"=>[90,"\x89"],"\xA7"=>[98,"\x89"],"\xA8"=>[107,"\x89"],"\xA9"=>[140,"\x89"],"\xAA"=>[146,"\x89"],"\xAB"=>[102,"\x89"],"\xAC"=>[113,"\x89"],"\xAD"=>[121,"\x89"],"\xAE"=>[128,"\x89"],"\xAF"=>[12,"\x89"],"\xB0"=>[92,"\x8A"],"\xB1"=>[95,"\x8A"],"\xB2"=>[137,"\x8A"],"\xB3"=>[142,"\x8A"],"\xB4"=>[150,"\x8A"],"\xB5"=>[74,"\x8A"],"\xB6"=>[90,"\x8A"],"\xB7"=>[98,"\x8A"],"\xB8"=>[107,"\x8A"],"\xB9"=>[140,"\x8A"],"\xBA"=>[146,"\x8A"],"\xBB"=>[102,"\x8A"],"\xBC"=>[113,"\x8A"],"\xBD"=>[121,"\x8A"],"\xBE"=>[128,"\x8A"],"\xBF"=>[12,"\x8A"],"\xC0"=>[92,"\x8B"],"\xC1"=>[95,"\x8B"],"\xC2"=>[137,"\x8B"],"\xC3"=>[142,"\x8B"],"\xC4"=>[150,"\x8B"],"\xC5"=>[74,"\x8B"],"\xC6"=>[90,"\x8B"],"\xC7"=>[98,"\x8B"],"\xC8"=>[107,"\x8B"],"\xC9"=>[140,"\x8B"],"\xCA"=>[146,"\x8B"],"\xCB"=>[102,"\x8B"],"\xCC"=>[113,"\x8B"],"\xCD"=>[121,"\x8B"],"\xCE"=>[128,"\x8B"],"\xCF"=>[12,"\x8B"],"\xD0"=>[92,"\x8C"],"\xD1"=>[95,"\x8C"],"\xD2"=>[137,"\x8C"],"\xD3"=>[142,"\x8C"],"\xD4"=>[150,"\x8C"],"\xD5"=>[74,"\x8C"],"\xD6"=>[90,"\x8C"],"\xD7"=>[98,"\x8C"],"\xD8"=>[107,"\x8C"],"\xD9"=>[140,"\x8C"],"\xDA"=>[146,"\x8C"],"\xDB"=>[102,"\x8C"],"\xDC"=>[113,"\x8C"],"\xDD"=>[121,"\x8C"],"\xDE"=>[128,"\x8C"],"\xDF"=>[12,"\x8C"],"\xE0"=>[92,"\x8D"],"\xE1"=>[95,"\x8D"],"\xE2"=>[137,"\x8D"],"\xE3"=>[142,"\x8D"],"\xE4"=>[150,"\x8D"],"\xE5"=>[74,"\x8D"],"\xE6"=>[90,"\x8D"],"\xE7"=>[98,"\x8D"],"\xE8"=>[107,"\x8D"],"\xE9"=>[140,"\x8D"],"\xEA"=>[146,"\x8D"],"\xEB"=>[102,"\x8D"],"\xEC"=>[113,"\x8D"],"\xED"=>[121,"\x8D"],"\xEE"=>[128,"\x8D"],"\xEF"=>[12,"\x8D"],"\xF0"=>[92,"\x8F"],"\xF1"=>[95,"\x8F"],"\xF2"=>[137,"\x8F"],"\xF3"=>[142,"\x8F"],"\xF4"=>[150,"\x8F"],"\xF5"=>[74,"\x8F"],"\xF6"=>[90,"\x8F"],"\xF7"=>[98,"\x8F"],"\xF8"=>[107,"\x8F"],"\xF9"=>[140,"\x8F"],"\xFA"=>[146,"\x8F"],"\xFB"=>[102,"\x8F"],"\xFC"=>[113,"\x8F"],"\xFD"=>[121,"\x8F"],"\xFE"=>[128,"\x8F"],"\xFF"=>[12,"\x8F"],],["\x00"=>[92,"\xB2"],"\x01"=>[95,"\xB2"],"\x02"=>[137,"\xB2"],"\x03"=>[142,"\xB2"],"\x04"=>[150,"\xB2"],"\x05"=>[74,"\xB2"],"\x06"=>[90,"\xB2"],"\x07"=>[98,"\xB2"],"\x08"=>[107,"\xB2"],"\x09"=>[140,"\xB2"],"\x0A"=>[146,"\xB2"],"\x0B"=>[102,"\xB2"],"\x0C"=>[113,"\xB2"],"\x0D"=>[121,"\xB2"],"\x0E"=>[128,"\xB2"],"\x0F"=>[12,"\xB2"],"\x10"=>[92,"\xB5"],"\x11"=>[95,"\xB5"],"\x12"=>[137,"\xB5"],"\x13"=>[142,"\xB5"],"\x14"=>[150,"\xB5"],"\x15"=>[74,"\xB5"],"\x16"=>[90,"\xB5"],"\x17"=>[98,"\xB5"],"\x18"=>[107,"\xB5"],"\x19"=>[140,"\xB5"],"\x1A"=>[146,"\xB5"],"\x1B"=>[102,"\xB5"],"\x1C"=>[113,"\xB5"],"\x1D"=>[121,"\xB5"],"\x1E"=>[128,"\xB5"],"\x1F"=>[12,"\xB5"],"\x20"=>[92,"\xB9"],"\x21"=>[95,"\xB9"],"\x22"=>[137,"\xB9"],"\x23"=>[142,"\xB9"],"\x24"=>[150,"\xB9"],"\x25"=>[74,"\xB9"],"\x26"=>[90,"\xB9"],"\x27"=>[98,"\xB9"],"\x28"=>[107,"\xB9"],"\x29"=>[140,"\xB9"],"\x2A"=>[146,"\xB9"],"\x2B"=>[102,"\xB9"],"\x2C"=>[113,"\xB9"],"-"=>[121,"\xB9"],"."=>[128,"\xB9"],"\x2F"=>[12,"\xB9"],[92,"\xBA"],[95,"\xBA"],[137,"\xBA"],[142,"\xBA"],[150,"\xBA"],[74,"\xBA"],[90,"\xBA"],[98,"\xBA"],[107,"\xBA"],[140,"\xBA"],"\x3A"=>[146,"\xBA"],"\x3B"=>[102,"\xBA"],"\x3C"=>[113,"\xBA"],"\x3D"=>[121,"\xBA"],"\x3E"=>[128,"\xBA"],"\x3F"=>[12,"\xBA"],"\x40"=>[92,"\xBB"],"A"=>[95,"\xBB"],"B"=>[137,"\xBB"],"C"=>[142,"\xBB"],"D"=>[150,"\xBB"],"E"=>[74,"\xBB"],"F"=>[90,"\xBB"],"G"=>[98,"\xBB"],"H"=>[107,"\xBB"],"I"=>[140,"\xBB"],"J"=>[146,"\xBB"],"K"=>[102,"\xBB"],"L"=>[113,"\xBB"],"M"=>[121,"\xBB"],"N"=>[128,"\xBB"],"O"=>[12,"\xBB"],"P"=>[92,"\xBD"],"Q"=>[95,"\xBD"],"R"=>[137,"\xBD"],"S"=>[142,"\xBD"],"T"=>[150,"\xBD"],"U"=>[74,"\xBD"],"V"=>[90,"\xBD"],"W"=>[98,"\xBD"],"X"=>[107,"\xBD"],"Y"=>[140,"\xBD"],"Z"=>[146,"\xBD"],"\x5B"=>[102,"\xBD"],"\x5C"=>[113,"\xBD"],"\x5D"=>[121,"\xBD"],"\x5E"=>[128,"\xBD"],"_"=>[12,"\xBD"],"\x60"=>[92,"\xBE"],"a"=>[95,"\xBE"],"b"=>[137,"\xBE"],"c"=>[142,"\xBE"],"d"=>[150,"\xBE"],"e"=>[74,"\xBE"],"f"=>[90,"\xBE"],"g"=>[98,"\xBE"],"h"=>[107,"\xBE"],"i"=>[140,"\xBE"],"j"=>[146,"\xBE"],"k"=>[102,"\xBE"],"l"=>[113,"\xBE"],"m"=>[121,"\xBE"],"n"=>[128,"\xBE"],"o"=>[12,"\xBE"],"p"=>[92,"\xC4"],"q"=>[95,"\xC4"],"r"=>[137,"\xC4"],"s"=>[142,"\xC4"],"t"=>[150,"\xC4"],"u"=>[74,"\xC4"],"v"=>[90,"\xC4"],"w"=>[98,"\xC4"],"x"=>[107,"\xC4"],"y"=>[140,"\xC4"],"z"=>[146,"\xC4"],"\x7B"=>[102,"\xC4"],"\x7C"=>[113,"\xC4"],"\x7D"=>[121,"\xC4"],"~"=>[128,"\xC4"],"\x7F"=>[12,"\xC4"],"\x80"=>[92,"\xC6"],"\x81"=>[95,"\xC6"],"\x82"=>[137,"\xC6"],"\x83"=>[142,"\xC6"],"\x84"=>[150,"\xC6"],"\x85"=>[74,"\xC6"],"\x86"=>[90,"\xC6"],"\x87"=>[98,"\xC6"],"\x88"=>[107,"\xC6"],"\x89"=>[140,"\xC6"],"\x8A"=>[146,"\xC6"],"\x8B"=>[102,"\xC6"],"\x8C"=>[113,"\xC6"],"\x8D"=>[121,"\xC6"],"\x8E"=>[128,"\xC6"],"\x8F"=>[12,"\xC6"],"\x90"=>[92,"\xE4"],"\x91"=>[95,"\xE4"],"\x92"=>[137,"\xE4"],"\x93"=>[142,"\xE4"],"\x94"=>[150,"\xE4"],"\x95"=>[74,"\xE4"],"\x96"=>[90,"\xE4"],"\x97"=>[98,"\xE4"],"\x98"=>[107,"\xE4"],"\x99"=>[140,"\xE4"],"\x9A"=>[146,"\xE4"],"\x9B"=>[102,"\xE4"],"\x9C"=>[113,"\xE4"],"\x9D"=>[121,"\xE4"],"\x9E"=>[128,"\xE4"],"\x9F"=>[12,"\xE4"],"\xA0"=>[92,"\xE8"],"\xA1"=>[95,"\xE8"],"\xA2"=>[137,"\xE8"],"\xA3"=>[142,"\xE8"],"\xA4"=>[150,"\xE8"],"\xA5"=>[74,"\xE8"],"\xA6"=>[90,"\xE8"],"\xA7"=>[98,"\xE8"],"\xA8"=>[107,"\xE8"],"\xA9"=>[140,"\xE8"],"\xAA"=>[146,"\xE8"],"\xAB"=>[102,"\xE8"],"\xAC"=>[113,"\xE8"],"\xAD"=>[121,"\xE8"],"\xAE"=>[128,"\xE8"],"\xAF"=>[12,"\xE8"],"\xB0"=>[92,"\xE9"],"\xB1"=>[95,"\xE9"],"\xB2"=>[137,"\xE9"],"\xB3"=>[142,"\xE9"],"\xB4"=>[150,"\xE9"],"\xB5"=>[74,"\xE9"],"\xB6"=>[90,"\xE9"],"\xB7"=>[98,"\xE9"],"\xB8"=>[107,"\xE9"],"\xB9"=>[140,"\xE9"],"\xBA"=>[146,"\xE9"],"\xBB"=>[102,"\xE9"],"\xBC"=>[113,"\xE9"],"\xBD"=>[121,"\xE9"],"\xBE"=>[128,"\xE9"],"\xBF"=>[12,"\xE9"],"\xC0"=>[93,"\x01"],"\xC1"=>[138,"\x01"],"\xC2"=>[75,"\x01"],"\xC3"=>[91,"\x01"],"\xC4"=>[108,"\x01"],"\xC5"=>[103,"\x01"],"\xC6"=>[114,"\x01"],"\xC7"=>[14,"\x01"],"\xC8"=>[93,"\x87"],"\xC9"=>[138,"\x87"],"\xCA"=>[75,"\x87"],"\xCB"=>[91,"\x87"],"\xCC"=>[108,"\x87"],"\xCD"=>[103,"\x87"],"\xCE"=>[114,"\x87"],"\xCF"=>[14,"\x87"],"\xD0"=>[93,"\x89"],"\xD1"=>[138,"\x89"],"\xD2"=>[75,"\x89"],"\xD3"=>[91,"\x89"],"\xD4"=>[108,"\x89"],"\xD5"=>[103,"\x89"],"\xD6"=>[114,"\x89"],"\xD7"=>[14,"\x89"],"\xD8"=>[93,"\x8A"],"\xD9"=>[138,"\x8A"],"\xDA"=>[75,"\x8A"],"\xDB"=>[91,"\x8A"],"\xDC"=>[108,"\x8A"],"\xDD"=>[103,"\x8A"],"\xDE"=>[114,"\x8A"],"\xDF"=>[14,"\x8A"],"\xE0"=>[93,"\x8B"],"\xE1"=>[138,"\x8B"],"\xE2"=>[75,"\x8B"],"\xE3"=>[91,"\x8B"],"\xE4"=>[108,"\x8B"],"\xE5"=>[103,"\x8B"],"\xE6"=>[114,"\x8B"],"\xE7"=>[14,"\x8B"],"\xE8"=>[93,"\x8C"],"\xE9"=>[138,"\x8C"],"\xEA"=>[75,"\x8C"],"\xEB"=>[91,"\x8C"],"\xEC"=>[108,"\x8C"],"\xED"=>[103,"\x8C"],"\xEE"=>[114,"\x8C"],"\xEF"=>[14,"\x8C"],"\xF0"=>[93,"\x8D"],"\xF1"=>[138,"\x8D"],"\xF2"=>[75,"\x8D"],"\xF3"=>[91,"\x8D"],"\xF4"=>[108,"\x8D"],"\xF5"=>[103,"\x8D"],"\xF6"=>[114,"\x8D"],"\xF7"=>[14,"\x8D"],"\xF8"=>[93,"\x8F"],"\xF9"=>[138,"\x8F"],"\xFA"=>[75,"\x8F"],"\xFB"=>[91,"\x8F"],"\xFC"=>[108,"\x8F"],"\xFD"=>[103,"\x8F"],"\xFE"=>[114,"\x8F"],"\xFF"=>[14,"\x8F"],],["\x00"=>[93,"\xB2"],"\x01"=>[138,"\xB2"],"\x02"=>[75,"\xB2"],"\x03"=>[91,"\xB2"],"\x04"=>[108,"\xB2"],"\x05"=>[103,"\xB2"],"\x06"=>[114,"\xB2"],"\x07"=>[14,"\xB2"],"\x08"=>[93,"\xB5"],"\x09"=>[138,"\xB5"],"\x0A"=>[75,"\xB5"],"\x0B"=>[91,"\xB5"],"\x0C"=>[108,"\xB5"],"\x0D"=>[103,"\xB5"],"\x0E"=>[114,"\xB5"],"\x0F"=>[14,"\xB5"],"\x10"=>[93,"\xB9"],"\x11"=>[138,"\xB9"],"\x12"=>[75,"\xB9"],"\x13"=>[91,"\xB9"],"\x14"=>[108,"\xB9"],"\x15"=>[103,"\xB9"],"\x16"=>[114,"\xB9"],"\x17"=>[14,"\xB9"],"\x18"=>[93,"\xBA"],"\x19"=>[138,"\xBA"],"\x1A"=>[75,"\xBA"],"\x1B"=>[91,"\xBA"],"\x1C"=>[108,"\xBA"],"\x1D"=>[103,"\xBA"],"\x1E"=>[114,"\xBA"],"\x1F"=>[14,"\xBA"],"\x20"=>[93,"\xBB"],"\x21"=>[138,"\xBB"],"\x22"=>[75,"\xBB"],"\x23"=>[91,"\xBB"],"\x24"=>[108,"\xBB"],"\x25"=>[103,"\xBB"],"\x26"=>[114,"\xBB"],"\x27"=>[14,"\xBB"],"\x28"=>[93,"\xBD"],"\x29"=>[138,"\xBD"],"\x2A"=>[75,"\xBD"],"\x2B"=>[91,"\xBD"],"\x2C"=>[108,"\xBD"],"-"=>[103,"\xBD"],"."=>[114,"\xBD"],"\x2F"=>[14,"\xBD"],[93,"\xBE"],[138,"\xBE"],[75,"\xBE"],[91,"\xBE"],[108,"\xBE"],[103,"\xBE"],[114,"\xBE"],[14,"\xBE"],[93,"\xC4"],[138,"\xC4"],"\x3A"=>[75,"\xC4"],"\x3B"=>[91,"\xC4"],"\x3C"=>[108,"\xC4"],"\x3D"=>[103,"\xC4"],"\x3E"=>[114,"\xC4"],"\x3F"=>[14,"\xC4"],"\x40"=>[93,"\xC6"],"A"=>[138,"\xC6"],"B"=>[75,"\xC6"],"C"=>[91,"\xC6"],"D"=>[108,"\xC6"],"E"=>[103,"\xC6"],"F"=>[114,"\xC6"],"G"=>[14,"\xC6"],"H"=>[93,"\xE4"],"I"=>[138,"\xE4"],"J"=>[75,"\xE4"],"K"=>[91,"\xE4"],"L"=>[108,"\xE4"],"M"=>[103,"\xE4"],"N"=>[114,"\xE4"],"O"=>[14,"\xE4"],"P"=>[93,"\xE8"],"Q"=>[138,"\xE8"],"R"=>[75,"\xE8"],"S"=>[91,"\xE8"],"T"=>[108,"\xE8"],"U"=>[103,"\xE8"],"V"=>[114,"\xE8"],"W"=>[14,"\xE8"],"X"=>[93,"\xE9"],"Y"=>[138,"\xE9"],"Z"=>[75,"\xE9"],"\x5B"=>[91,"\xE9"],"\x5C"=>[108,"\xE9"],"\x5D"=>[103,"\xE9"],"\x5E"=>[114,"\xE9"],"_"=>[14,"\xE9"],"\x60"=>[94,"\x01"],"a"=>[76,"\x01"],"b"=>[104,"\x01"],"c"=>[16,"\x01"],"d"=>[94,"\x87"],"e"=>[76,"\x87"],"f"=>[104,"\x87"],"g"=>[16,"\x87"],"h"=>[94,"\x89"],"i"=>[76,"\x89"],"j"=>[104,"\x89"],"k"=>[16,"\x89"],"l"=>[94,"\x8A"],"m"=>[76,"\x8A"],"n"=>[104,"\x8A"],"o"=>[16,"\x8A"],"p"=>[94,"\x8B"],"q"=>[76,"\x8B"],"r"=>[104,"\x8B"],"s"=>[16,"\x8B"],"t"=>[94,"\x8C"],"u"=>[76,"\x8C"],"v"=>[104,"\x8C"],"w"=>[16,"\x8C"],"x"=>[94,"\x8D"],"y"=>[76,"\x8D"],"z"=>[104,"\x8D"],"\x7B"=>[16,"\x8D"],"\x7C"=>[94,"\x8F"],"\x7D"=>[76,"\x8F"],"~"=>[104,"\x8F"],"\x7F"=>[16,"\x8F"],"\x80"=>[94,"\x93"],"\x81"=>[76,"\x93"],"\x82"=>[104,"\x93"],"\x83"=>[16,"\x93"],"\x84"=>[94,"\x95"],"\x85"=>[76,"\x95"],"\x86"=>[104,"\x95"],"\x87"=>[16,"\x95"],"\x88"=>[94,"\x96"],"\x89"=>[76,"\x96"],"\x8A"=>[104,"\x96"],"\x8B"=>[16,"\x96"],"\x8C"=>[94,"\x97"],"\x8D"=>[76,"\x97"],"\x8E"=>[104,"\x97"],"\x8F"=>[16,"\x97"],"\x90"=>[94,"\x98"],"\x91"=>[76,"\x98"],"\x92"=>[104,"\x98"],"\x93"=>[16,"\x98"],"\x94"=>[94,"\x9B"],"\x95"=>[76,"\x9B"],"\x96"=>[104,"\x9B"],"\x97"=>[16,"\x9B"],"\x98"=>[94,"\x9D"],"\x99"=>[76,"\x9D"],"\x9A"=>[104,"\x9D"],"\x9B"=>[16,"\x9D"],"\x9C"=>[94,"\x9E"],"\x9D"=>[76,"\x9E"],"\x9E"=>[104,"\x9E"],"\x9F"=>[16,"\x9E"],"\xA0"=>[94,"\xA5"],"\xA1"=>[76,"\xA5"],"\xA2"=>[104,"\xA5"],"\xA3"=>[16,"\xA5"],"\xA4"=>[94,"\xA6"],"\xA5"=>[76,"\xA6"],"\xA6"=>[104,"\xA6"],"\xA7"=>[16,"\xA6"],"\xA8"=>[94,"\xA8"],"\xA9"=>[76,"\xA8"],"\xAA"=>[104,"\xA8"],"\xAB"=>[16,"\xA8"],"\xAC"=>[94,"\xAE"],"\xAD"=>[76,"\xAE"],"\xAE"=>[104,"\xAE"],"\xAF"=>[16,"\xAE"],"\xB0"=>[94,"\xAF"],"\xB1"=>[76,"\xAF"],"\xB2"=>[104,"\xAF"],"\xB3"=>[16,"\xAF"],"\xB4"=>[94,"\xB4"],"\xB5"=>[76,"\xB4"],"\xB6"=>[104,"\xB4"],"\xB7"=>[16,"\xB4"],"\xB8"=>[94,"\xB6"],"\xB9"=>[76,"\xB6"],"\xBA"=>[104,"\xB6"],"\xBB"=>[16,"\xB6"],"\xBC"=>[94,"\xB7"],"\xBD"=>[76,"\xB7"],"\xBE"=>[104,"\xB7"],"\xBF"=>[16,"\xB7"],"\xC0"=>[94,"\xBC"],"\xC1"=>[76,"\xBC"],"\xC2"=>[104,"\xBC"],"\xC3"=>[16,"\xBC"],"\xC4"=>[94,"\xBF"],"\xC5"=>[76,"\xBF"],"\xC6"=>[104,"\xBF"],"\xC7"=>[16,"\xBF"],"\xC8"=>[94,"\xC5"],"\xC9"=>[76,"\xC5"],"\xCA"=>[104,"\xC5"],"\xCB"=>[16,"\xC5"],"\xCC"=>[94,"\xE7"],"\xCD"=>[76,"\xE7"],"\xCE"=>[104,"\xE7"],"\xCF"=>[16,"\xE7"],"\xD0"=>[94,"\xEF"],"\xD1"=>[76,"\xEF"],"\xD2"=>[104,"\xEF"],"\xD3"=>[16,"\xEF"],"\xD4"=>[77,"\x09"],"\xD5"=>[18,"\x09"],"\xD6"=>[77,"\x8E"],"\xD7"=>[18,"\x8E"],"\xD8"=>[77,"\x90"],"\xD9"=>[18,"\x90"],"\xDA"=>[77,"\x91"],"\xDB"=>[18,"\x91"],"\xDC"=>[77,"\x94"],"\xDD"=>[18,"\x94"],"\xDE"=>[77,"\x9F"],"\xDF"=>[18,"\x9F"],"\xE0"=>[77,"\xAB"],"\xE1"=>[18,"\xAB"],"\xE2"=>[77,"\xCE"],"\xE3"=>[18,"\xCE"],"\xE4"=>[77,"\xD7"],"\xE5"=>[18,"\xD7"],"\xE6"=>[77,"\xE1"],"\xE7"=>[18,"\xE1"],"\xE8"=>[77,"\xEC"],"\xE9"=>[18,"\xEC"],"\xEA"=>[77,"\xED"],"\xEB"=>[18,"\xED"],"\xEC"=>[0,"\xC7"],"\xED"=>[0,"\xCF"],"\xEE"=>[0,"\xEA"],"\xEF"=>[0,"\xEB"],"\xF0"=>[221,null],"\xF1"=>[228,null],"\xF2"=>[230,null],"\xF3"=>[235,null],"\xF4"=>[245,null],"\xF5"=>[253,null],"\xF6"=>[255,null],"\xF7"=>[234,null],"\xF8"=>[239,null],"\xF9"=>[247,null],"\xFA"=>[258,null],"\xFB"=>[261,null],"\xFC"=>[41,null],"\xFD"=>[47,null],"\xFE"=>[64,null],"\xFF"=>[57,null],],["\x00"=>[0,"\xFE0"],"\x01"=>[0,"\xFE1"],"\x02"=>[0,"\xFE2"],"\x03"=>[0,"\xFEa"],"\x04"=>[0,"\xFEc"],"\x05"=>[0,"\xFEe"],"\x06"=>[0,"\xFEi"],"\x07"=>[0,"\xFEo"],"\x08"=>[0,"\xFEs"],"\x09"=>[0,"\xFEt"],"\x0A"=>[73,"\xFE"],"\x0B"=>[88,"\xFE"],"\x0C"=>[89,"\xFE"],"\x0D"=>[96,"\xFE"],"\x0E"=>[97,"\xFE"],"\x0F"=>[99,"\xFE"],"\x10"=>[106,"\xFE"],"\x11"=>[136,"\xFE"],"\x12"=>[139,"\xFE"],"\x13"=>[141,"\xFE"],"\x14"=>[145,"\xFE"],"\x15"=>[147,"\xFE"],"\x16"=>[149,"\xFE"],"\x17"=>[101,"\xFE"],"\x18"=>[112,"\xFE"],"\x19"=>[117,"\xFE"],"\x1A"=>[120,"\xFE"],"\x1B"=>[124,"\xFE"],"\x1C"=>[127,"\xFE"],"\x1D"=>[144,"\xFE"],"\x1E"=>[152,"\xFE"],"\x1F"=>[11,"\xFE"],"\x20"=>[92,"\x02"],"\x21"=>[95,"\x02"],"\x22"=>[137,"\x02"],"\x23"=>[142,"\x02"],"\x24"=>[150,"\x02"],"\x25"=>[74,"\x02"],"\x26"=>[90,"\x02"],"\x27"=>[98,"\x02"],"\x28"=>[107,"\x02"],"\x29"=>[140,"\x02"],"\x2A"=>[146,"\x02"],"\x2B"=>[102,"\x02"],"\x2C"=>[113,"\x02"],"-"=>[121,"\x02"],"."=>[128,"\x02"],"\x2F"=>[12,"\x02"],[92,"\x03"],[95,"\x03"],[137,"\x03"],[142,"\x03"],[150,"\x03"],[74,"\x03"],[90,"\x03"],[98,"\x03"],[107,"\x03"],[140,"\x03"],"\x3A"=>[146,"\x03"],"\x3B"=>[102,"\x03"],"\x3C"=>[113,"\x03"],"\x3D"=>[121,"\x03"],"\x3E"=>[128,"\x03"],"\x3F"=>[12,"\x03"],"\x40"=>[92,"\x04"],"A"=>[95,"\x04"],"B"=>[137,"\x04"],"C"=>[142,"\x04"],"D"=>[150,"\x04"],"E"=>[74,"\x04"],"F"=>[90,"\x04"],"G"=>[98,"\x04"],"H"=>[107,"\x04"],"I"=>[140,"\x04"],"J"=>[146,"\x04"],"K"=>[102,"\x04"],"L"=>[113,"\x04"],"M"=>[121,"\x04"],"N"=>[128,"\x04"],"O"=>[12,"\x04"],"P"=>[92,"\x05"],"Q"=>[95,"\x05"],"R"=>[137,"\x05"],"S"=>[142,"\x05"],"T"=>[150,"\x05"],"U"=>[74,"\x05"],"V"=>[90,"\x05"],"W"=>[98,"\x05"],"X"=>[107,"\x05"],"Y"=>[140,"\x05"],"Z"=>[146,"\x05"],"\x5B"=>[102,"\x05"],"\x5C"=>[113,"\x05"],"\x5D"=>[121,"\x05"],"\x5E"=>[128,"\x05"],"_"=>[12,"\x05"],"\x60"=>[92,"\x06"],"a"=>[95,"\x06"],"b"=>[137,"\x06"],"c"=>[142,"\x06"],"d"=>[150,"\x06"],"e"=>[74,"\x06"],"f"=>[90,"\x06"],"g"=>[98,"\x06"],"h"=>[107,"\x06"],"i"=>[140,"\x06"],"j"=>[146,"\x06"],"k"=>[102,"\x06"],"l"=>[113,"\x06"],"m"=>[121,"\x06"],"n"=>[128,"\x06"],"o"=>[12,"\x06"],"p"=>[92,"\x07"],"q"=>[95,"\x07"],"r"=>[137,"\x07"],"s"=>[142,"\x07"],"t"=>[150,"\x07"],"u"=>[74,"\x07"],"v"=>[90,"\x07"],"w"=>[98,"\x07"],"x"=>[107,"\x07"],"y"=>[140,"\x07"],"z"=>[146,"\x07"],"\x7B"=>[102,"\x07"],"\x7C"=>[113,"\x07"],"\x7D"=>[121,"\x07"],"~"=>[128,"\x07"],"\x7F"=>[12,"\x07"],"\x80"=>[92,"\x08"],"\x81"=>[95,"\x08"],"\x82"=>[137,"\x08"],"\x83"=>[142,"\x08"],"\x84"=>[150,"\x08"],"\x85"=>[74,"\x08"],"\x86"=>[90,"\x08"],"\x87"=>[98,"\x08"],"\x88"=>[107,"\x08"],"\x89"=>[140,"\x08"],"\x8A"=>[146,"\x08"],"\x8B"=>[102,"\x08"],"\x8C"=>[113,"\x08"],"\x8D"=>[121,"\x08"],"\x8E"=>[128,"\x08"],"\x8F"=>[12,"\x08"],"\x90"=>[92,"\x0B"],"\x91"=>[95,"\x0B"],"\x92"=>[137,"\x0B"],"\x93"=>[142,"\x0B"],"\x94"=>[150,"\x0B"],"\x95"=>[74,"\x0B"],"\x96"=>[90,"\x0B"],"\x97"=>[98,"\x0B"],"\x98"=>[107,"\x0B"],"\x99"=>[140,"\x0B"],"\x9A"=>[146,"\x0B"],"\x9B"=>[102,"\x0B"],"\x9C"=>[113,"\x0B"],"\x9D"=>[121,"\x0B"],"\x9E"=>[128,"\x0B"],"\x9F"=>[12,"\x0B"],"\xA0"=>[92,"\x0C"],"\xA1"=>[95,"\x0C"],"\xA2"=>[137,"\x0C"],"\xA3"=>[142,"\x0C"],"\xA4"=>[150,"\x0C"],"\xA5"=>[74,"\x0C"],"\xA6"=>[90,"\x0C"],"\xA7"=>[98,"\x0C"],"\xA8"=>[107,"\x0C"],"\xA9"=>[140,"\x0C"],"\xAA"=>[146,"\x0C"],"\xAB"=>[102,"\x0C"],"\xAC"=>[113,"\x0C"],"\xAD"=>[121,"\x0C"],"\xAE"=>[128,"\x0C"],"\xAF"=>[12,"\x0C"],"\xB0"=>[92,"\x0E"],"\xB1"=>[95,"\x0E"],"\xB2"=>[137,"\x0E"],"\xB3"=>[142,"\x0E"],"\xB4"=>[150,"\x0E"],"\xB5"=>[74,"\x0E"],"\xB6"=>[90,"\x0E"],"\xB7"=>[98,"\x0E"],"\xB8"=>[107,"\x0E"],"\xB9"=>[140,"\x0E"],"\xBA"=>[146,"\x0E"],"\xBB"=>[102,"\x0E"],"\xBC"=>[113,"\x0E"],"\xBD"=>[121,"\x0E"],"\xBE"=>[128,"\x0E"],"\xBF"=>[12,"\x0E"],"\xC0"=>[92,"\x0F"],"\xC1"=>[95,"\x0F"],"\xC2"=>[137,"\x0F"],"\xC3"=>[142,"\x0F"],"\xC4"=>[150,"\x0F"],"\xC5"=>[74,"\x0F"],"\xC6"=>[90,"\x0F"],"\xC7"=>[98,"\x0F"],"\xC8"=>[107,"\x0F"],"\xC9"=>[140,"\x0F"],"\xCA"=>[146,"\x0F"],"\xCB"=>[102,"\x0F"],"\xCC"=>[113,"\x0F"],"\xCD"=>[121,"\x0F"],"\xCE"=>[128,"\x0F"],"\xCF"=>[12,"\x0F"],"\xD0"=>[92,"\x10"],"\xD1"=>[95,"\x10"],"\xD2"=>[137,"\x10"],"\xD3"=>[142,"\x10"],"\xD4"=>[150,"\x10"],"\xD5"=>[74,"\x10"],"\xD6"=>[90,"\x10"],"\xD7"=>[98,"\x10"],"\xD8"=>[107,"\x10"],"\xD9"=>[140,"\x10"],"\xDA"=>[146,"\x10"],"\xDB"=>[102,"\x10"],"\xDC"=>[113,"\x10"],"\xDD"=>[121,"\x10"],"\xDE"=>[128,"\x10"],"\xDF"=>[12,"\x10"],"\xE0"=>[92,"\x11"],"\xE1"=>[95,"\x11"],"\xE2"=>[137,"\x11"],"\xE3"=>[142,"\x11"],"\xE4"=>[150,"\x11"],"\xE5"=>[74,"\x11"],"\xE6"=>[90,"\x11"],"\xE7"=>[98,"\x11"],"\xE8"=>[107,"\x11"],"\xE9"=>[140,"\x11"],"\xEA"=>[146,"\x11"],"\xEB"=>[102,"\x11"],"\xEC"=>[113,"\x11"],"\xED"=>[121,"\x11"],"\xEE"=>[128,"\x11"],"\xEF"=>[12,"\x11"],"\xF0"=>[92,"\x12"],"\xF1"=>[95,"\x12"],"\xF2"=>[137,"\x12"],"\xF3"=>[142,"\x12"],"\xF4"=>[150,"\x12"],"\xF5"=>[74,"\x12"],"\xF6"=>[90,"\x12"],"\xF7"=>[98,"\x12"],"\xF8"=>[107,"\x12"],"\xF9"=>[140,"\x12"],"\xFA"=>[146,"\x12"],"\xFB"=>[102,"\x12"],"\xFC"=>[113,"\x12"],"\xFD"=>[121,"\x12"],"\xFE"=>[128,"\x12"],"\xFF"=>[12,"\x12"],],["\x00"=>[92,"\xFE"],"\x01"=>[95,"\xFE"],"\x02"=>[137,"\xFE"],"\x03"=>[142,"\xFE"],"\x04"=>[150,"\xFE"],"\x05"=>[74,"\xFE"],"\x06"=>[90,"\xFE"],"\x07"=>[98,"\xFE"],"\x08"=>[107,"\xFE"],"\x09"=>[140,"\xFE"],"\x0A"=>[146,"\xFE"],"\x0B"=>[102,"\xFE"],"\x0C"=>[113,"\xFE"],"\x0D"=>[121,"\xFE"],"\x0E"=>[128,"\xFE"],"\x0F"=>[12,"\xFE"],"\x10"=>[93,"\x02"],"\x11"=>[138,"\x02"],"\x12"=>[75,"\x02"],"\x13"=>[91,"\x02"],"\x14"=>[108,"\x02"],"\x15"=>[103,"\x02"],"\x16"=>[114,"\x02"],"\x17"=>[14,"\x02"],"\x18"=>[93,"\x03"],"\x19"=>[138,"\x03"],"\x1A"=>[75,"\x03"],"\x1B"=>[91,"\x03"],"\x1C"=>[108,"\x03"],"\x1D"=>[103,"\x03"],"\x1E"=>[114,"\x03"],"\x1F"=>[14,"\x03"],"\x20"=>[93,"\x04"],"\x21"=>[138,"\x04"],"\x22"=>[75,"\x04"],"\x23"=>[91,"\x04"],"\x24"=>[108,"\x04"],"\x25"=>[103,"\x04"],"\x26"=>[114,"\x04"],"\x27"=>[14,"\x04"],"\x28"=>[93,"\x05"],"\x29"=>[138,"\x05"],"\x2A"=>[75,"\x05"],"\x2B"=>[91,"\x05"],"\x2C"=>[108,"\x05"],"-"=>[103,"\x05"],"."=>[114,"\x05"],"\x2F"=>[14,"\x05"],[93,"\x06"],[138,"\x06"],[75,"\x06"],[91,"\x06"],[108,"\x06"],[103,"\x06"],[114,"\x06"],[14,"\x06"],[93,"\x07"],[138,"\x07"],"\x3A"=>[75,"\x07"],"\x3B"=>[91,"\x07"],"\x3C"=>[108,"\x07"],"\x3D"=>[103,"\x07"],"\x3E"=>[114,"\x07"],"\x3F"=>[14,"\x07"],"\x40"=>[93,"\x08"],"A"=>[138,"\x08"],"B"=>[75,"\x08"],"C"=>[91,"\x08"],"D"=>[108,"\x08"],"E"=>[103,"\x08"],"F"=>[114,"\x08"],"G"=>[14,"\x08"],"H"=>[93,"\x0B"],"I"=>[138,"\x0B"],"J"=>[75,"\x0B"],"K"=>[91,"\x0B"],"L"=>[108,"\x0B"],"M"=>[103,"\x0B"],"N"=>[114,"\x0B"],"O"=>[14,"\x0B"],"P"=>[93,"\x0C"],"Q"=>[138,"\x0C"],"R"=>[75,"\x0C"],"S"=>[91,"\x0C"],"T"=>[108,"\x0C"],"U"=>[103,"\x0C"],"V"=>[114,"\x0C"],"W"=>[14,"\x0C"],"X"=>[93,"\x0E"],"Y"=>[138,"\x0E"],"Z"=>[75,"\x0E"],"\x5B"=>[91,"\x0E"],"\x5C"=>[108,"\x0E"],"\x5D"=>[103,"\x0E"],"\x5E"=>[114,"\x0E"],"_"=>[14,"\x0E"],"\x60"=>[93,"\x0F"],"a"=>[138,"\x0F"],"b"=>[75,"\x0F"],"c"=>[91,"\x0F"],"d"=>[108,"\x0F"],"e"=>[103,"\x0F"],"f"=>[114,"\x0F"],"g"=>[14,"\x0F"],"h"=>[93,"\x10"],"i"=>[138,"\x10"],"j"=>[75,"\x10"],"k"=>[91,"\x10"],"l"=>[108,"\x10"],"m"=>[103,"\x10"],"n"=>[114,"\x10"],"o"=>[14,"\x10"],"p"=>[93,"\x11"],"q"=>[138,"\x11"],"r"=>[75,"\x11"],"s"=>[91,"\x11"],"t"=>[108,"\x11"],"u"=>[103,"\x11"],"v"=>[114,"\x11"],"w"=>[14,"\x11"],"x"=>[93,"\x12"],"y"=>[138,"\x12"],"z"=>[75,"\x12"],"\x7B"=>[91,"\x12"],"\x7C"=>[108,"\x12"],"\x7D"=>[103,"\x12"],"~"=>[114,"\x12"],"\x7F"=>[14,"\x12"],"\x80"=>[93,"\x13"],"\x81"=>[138,"\x13"],"\x82"=>[75,"\x13"],"\x83"=>[91,"\x13"],"\x84"=>[108,"\x13"],"\x85"=>[103,"\x13"],"\x86"=>[114,"\x13"],"\x87"=>[14,"\x13"],"\x88"=>[93,"\x14"],"\x89"=>[138,"\x14"],"\x8A"=>[75,"\x14"],"\x8B"=>[91,"\x14"],"\x8C"=>[108,"\x14"],"\x8D"=>[103,"\x14"],"\x8E"=>[114,"\x14"],"\x8F"=>[14,"\x14"],"\x90"=>[93,"\x15"],"\x91"=>[138,"\x15"],"\x92"=>[75,"\x15"],"\x93"=>[91,"\x15"],"\x94"=>[108,"\x15"],"\x95"=>[103,"\x15"],"\x96"=>[114,"\x15"],"\x97"=>[14,"\x15"],"\x98"=>[93,"\x17"],"\x99"=>[138,"\x17"],"\x9A"=>[75,"\x17"],"\x9B"=>[91,"\x17"],"\x9C"=>[108,"\x17"],"\x9D"=>[103,"\x17"],"\x9E"=>[114,"\x17"],"\x9F"=>[14,"\x17"],"\xA0"=>[93,"\x18"],"\xA1"=>[138,"\x18"],"\xA2"=>[75,"\x18"],"\xA3"=>[91,"\x18"],"\xA4"=>[108,"\x18"],"\xA5"=>[103,"\x18"],"\xA6"=>[114,"\x18"],"\xA7"=>[14,"\x18"],"\xA8"=>[93,"\x19"],"\xA9"=>[138,"\x19"],"\xAA"=>[75,"\x19"],"\xAB"=>[91,"\x19"],"\xAC"=>[108,"\x19"],"\xAD"=>[103,"\x19"],"\xAE"=>[114,"\x19"],"\xAF"=>[14,"\x19"],"\xB0"=>[93,"\x1A"],"\xB1"=>[138,"\x1A"],"\xB2"=>[75,"\x1A"],"\xB3"=>[91,"\x1A"],"\xB4"=>[108,"\x1A"],"\xB5"=>[103,"\x1A"],"\xB6"=>[114,"\x1A"],"\xB7"=>[14,"\x1A"],"\xB8"=>[93,"\x1B"],"\xB9"=>[138,"\x1B"],"\xBA"=>[75,"\x1B"],"\xBB"=>[91,"\x1B"],"\xBC"=>[108,"\x1B"],"\xBD"=>[103,"\x1B"],"\xBE"=>[114,"\x1B"],"\xBF"=>[14,"\x1B"],"\xC0"=>[93,"\x1C"],"\xC1"=>[138,"\x1C"],"\xC2"=>[75,"\x1C"],"\xC3"=>[91,"\x1C"],"\xC4"=>[108,"\x1C"],"\xC5"=>[103,"\x1C"],"\xC6"=>[114,"\x1C"],"\xC7"=>[14,"\x1C"],"\xC8"=>[93,"\x1D"],"\xC9"=>[138,"\x1D"],"\xCA"=>[75,"\x1D"],"\xCB"=>[91,"\x1D"],"\xCC"=>[108,"\x1D"],"\xCD"=>[103,"\x1D"],"\xCE"=>[114,"\x1D"],"\xCF"=>[14,"\x1D"],"\xD0"=>[93,"\x1E"],"\xD1"=>[138,"\x1E"],"\xD2"=>[75,"\x1E"],"\xD3"=>[91,"\x1E"],"\xD4"=>[108,"\x1E"],"\xD5"=>[103,"\x1E"],"\xD6"=>[114,"\x1E"],"\xD7"=>[14,"\x1E"],"\xD8"=>[93,"\x1F"],"\xD9"=>[138,"\x1F"],"\xDA"=>[75,"\x1F"],"\xDB"=>[91,"\x1F"],"\xDC"=>[108,"\x1F"],"\xDD"=>[103,"\x1F"],"\xDE"=>[114,"\x1F"],"\xDF"=>[14,"\x1F"],"\xE0"=>[93,"\x7F"],"\xE1"=>[138,"\x7F"],"\xE2"=>[75,"\x7F"],"\xE3"=>[91,"\x7F"],"\xE4"=>[108,"\x7F"],"\xE5"=>[103,"\x7F"],"\xE6"=>[114,"\x7F"],"\xE7"=>[14,"\x7F"],"\xE8"=>[93,"\xDC"],"\xE9"=>[138,"\xDC"],"\xEA"=>[75,"\xDC"],"\xEB"=>[91,"\xDC"],"\xEC"=>[108,"\xDC"],"\xED"=>[103,"\xDC"],"\xEE"=>[114,"\xDC"],"\xEF"=>[14,"\xDC"],"\xF0"=>[93,"\xF9"],"\xF1"=>[138,"\xF9"],"\xF2"=>[75,"\xF9"],"\xF3"=>[91,"\xF9"],"\xF4"=>[108,"\xF9"],"\xF5"=>[103,"\xF9"],"\xF6"=>[114,"\xF9"],"\xF7"=>[14,"\xF9"],"\xF8"=>[77,"\x0A"],"\xF9"=>[18,"\x0A"],"\xFA"=>[77,"\x0D"],"\xFB"=>[18,"\x0D"],"\xFC"=>[77,"\x16"],"\xFD"=>[18,"\x16"],"\xFE"=>[77,""],"\xFF"=>[18,""],],["\x00"=>[93,"\xD3"],"\x01"=>[138,"\xD3"],"\x02"=>[75,"\xD3"],"\x03"=>[91,"\xD3"],"\x04"=>[108,"\xD3"],"\x05"=>[103,"\xD3"],"\x06"=>[114,"\xD3"],"\x07"=>[14,"\xD3"],"\x08"=>[93,"\xD4"],"\x09"=>[138,"\xD4"],"\x0A"=>[75,"\xD4"],"\x0B"=>[91,"\xD4"],"\x0C"=>[108,"\xD4"],"\x0D"=>[103,"\xD4"],"\x0E"=>[114,"\xD4"],"\x0F"=>[14,"\xD4"],"\x10"=>[93,"\xD6"],"\x11"=>[138,"\xD6"],"\x12"=>[75,"\xD6"],"\x13"=>[91,"\xD6"],"\x14"=>[108,"\xD6"],"\x15"=>[103,"\xD6"],"\x16"=>[114,"\xD6"],"\x17"=>[14,"\xD6"],"\x18"=>[93,"\xDD"],"\x19"=>[138,"\xDD"],"\x1A"=>[75,"\xDD"],"\x1B"=>[91,"\xDD"],"\x1C"=>[108,"\xDD"],"\x1D"=>[103,"\xDD"],"\x1E"=>[114,"\xDD"],"\x1F"=>[14,"\xDD"],"\x20"=>[93,"\xDE"],"\x21"=>[138,"\xDE"],"\x22"=>[75,"\xDE"],"\x23"=>[91,"\xDE"],"\x24"=>[108,"\xDE"],"\x25"=>[103,"\xDE"],"\x26"=>[114,"\xDE"],"\x27"=>[14,"\xDE"],"\x28"=>[93,"\xDF"],"\x29"=>[138,"\xDF"],"\x2A"=>[75,"\xDF"],"\x2B"=>[91,"\xDF"],"\x2C"=>[108,"\xDF"],"-"=>[103,"\xDF"],"."=>[114,"\xDF"],"\x2F"=>[14,"\xDF"],[93,"\xF1"],[138,"\xF1"],[75,"\xF1"],[91,"\xF1"],[108,"\xF1"],[103,"\xF1"],[114,"\xF1"],[14,"\xF1"],[93,"\xF4"],[138,"\xF4"],"\x3A"=>[75,"\xF4"],"\x3B"=>[91,"\xF4"],"\x3C"=>[108,"\xF4"],"\x3D"=>[103,"\xF4"],"\x3E"=>[114,"\xF4"],"\x3F"=>[14,"\xF4"],"\x40"=>[93,"\xF5"],"A"=>[138,"\xF5"],"B"=>[75,"\xF5"],"C"=>[91,"\xF5"],"D"=>[108,"\xF5"],"E"=>[103,"\xF5"],"F"=>[114,"\xF5"],"G"=>[14,"\xF5"],"H"=>[93,"\xF6"],"I"=>[138,"\xF6"],"J"=>[75,"\xF6"],"K"=>[91,"\xF6"],"L"=>[108,"\xF6"],"M"=>[103,"\xF6"],"N"=>[114,"\xF6"],"O"=>[14,"\xF6"],"P"=>[93,"\xF7"],"Q"=>[138,"\xF7"],"R"=>[75,"\xF7"],"S"=>[91,"\xF7"],"T"=>[108,"\xF7"],"U"=>[103,"\xF7"],"V"=>[114,"\xF7"],"W"=>[14,"\xF7"],"X"=>[93,"\xF8"],"Y"=>[138,"\xF8"],"Z"=>[75,"\xF8"],"\x5B"=>[91,"\xF8"],"\x5C"=>[108,"\xF8"],"\x5D"=>[103,"\xF8"],"\x5E"=>[114,"\xF8"],"_"=>[14,"\xF8"],"\x60"=>[93,"\xFA"],"a"=>[138,"\xFA"],"b"=>[75,"\xFA"],"c"=>[91,"\xFA"],"d"=>[108,"\xFA"],"e"=>[103,"\xFA"],"f"=>[114,"\xFA"],"g"=>[14,"\xFA"],"h"=>[93,"\xFB"],"i"=>[138,"\xFB"],"j"=>[75,"\xFB"],"k"=>[91,"\xFB"],"l"=>[108,"\xFB"],"m"=>[103,"\xFB"],"n"=>[114,"\xFB"],"o"=>[14,"\xFB"],"p"=>[93,"\xFC"],"q"=>[138,"\xFC"],"r"=>[75,"\xFC"],"s"=>[91,"\xFC"],"t"=>[108,"\xFC"],"u"=>[103,"\xFC"],"v"=>[114,"\xFC"],"w"=>[14,"\xFC"],"x"=>[93,"\xFD"],"y"=>[138,"\xFD"],"z"=>[75,"\xFD"],"\x7B"=>[91,"\xFD"],"\x7C"=>[108,"\xFD"],"\x7D"=>[103,"\xFD"],"~"=>[114,"\xFD"],"\x7F"=>[14,"\xFD"],"\x80"=>[93,"\xFE"],"\x81"=>[138,"\xFE"],"\x82"=>[75,"\xFE"],"\x83"=>[91,"\xFE"],"\x84"=>[108,"\xFE"],"\x85"=>[103,"\xFE"],"\x86"=>[114,"\xFE"],"\x87"=>[14,"\xFE"],"\x88"=>[94,"\x02"],"\x89"=>[76,"\x02"],"\x8A"=>[104,"\x02"],"\x8B"=>[16,"\x02"],"\x8C"=>[94,"\x03"],"\x8D"=>[76,"\x03"],"\x8E"=>[104,"\x03"],"\x8F"=>[16,"\x03"],"\x90"=>[94,"\x04"],"\x91"=>[76,"\x04"],"\x92"=>[104,"\x04"],"\x93"=>[16,"\x04"],"\x94"=>[94,"\x05"],"\x95"=>[76,"\x05"],"\x96"=>[104,"\x05"],"\x97"=>[16,"\x05"],"\x98"=>[94,"\x06"],"\x99"=>[76,"\x06"],"\x9A"=>[104,"\x06"],"\x9B"=>[16,"\x06"],"\x9C"=>[94,"\x07"],"\x9D"=>[76,"\x07"],"\x9E"=>[104,"\x07"],"\x9F"=>[16,"\x07"],"\xA0"=>[94,"\x08"],"\xA1"=>[76,"\x08"],"\xA2"=>[104,"\x08"],"\xA3"=>[16,"\x08"],"\xA4"=>[94,"\x0B"],"\xA5"=>[76,"\x0B"],"\xA6"=>[104,"\x0B"],"\xA7"=>[16,"\x0B"],"\xA8"=>[94,"\x0C"],"\xA9"=>[76,"\x0C"],"\xAA"=>[104,"\x0C"],"\xAB"=>[16,"\x0C"],"\xAC"=>[94,"\x0E"],"\xAD"=>[76,"\x0E"],"\xAE"=>[104,"\x0E"],"\xAF"=>[16,"\x0E"],"\xB0"=>[94,"\x0F"],"\xB1"=>[76,"\x0F"],"\xB2"=>[104,"\x0F"],"\xB3"=>[16,"\x0F"],"\xB4"=>[94,"\x10"],"\xB5"=>[76,"\x10"],"\xB6"=>[104,"\x10"],"\xB7"=>[16,"\x10"],"\xB8"=>[94,"\x11"],"\xB9"=>[76,"\x11"],"\xBA"=>[104,"\x11"],"\xBB"=>[16,"\x11"],"\xBC"=>[94,"\x12"],"\xBD"=>[76,"\x12"],"\xBE"=>[104,"\x12"],"\xBF"=>[16,"\x12"],"\xC0"=>[94,"\x13"],"\xC1"=>[76,"\x13"],"\xC2"=>[104,"\x13"],"\xC3"=>[16,"\x13"],"\xC4"=>[94,"\x14"],"\xC5"=>[76,"\x14"],"\xC6"=>[104,"\x14"],"\xC7"=>[16,"\x14"],"\xC8"=>[94,"\x15"],"\xC9"=>[76,"\x15"],"\xCA"=>[104,"\x15"],"\xCB"=>[16,"\x15"],"\xCC"=>[94,"\x17"],"\xCD"=>[76,"\x17"],"\xCE"=>[104,"\x17"],"\xCF"=>[16,"\x17"],"\xD0"=>[94,"\x18"],"\xD1"=>[76,"\x18"],"\xD2"=>[104,"\x18"],"\xD3"=>[16,"\x18"],"\xD4"=>[94,"\x19"],"\xD5"=>[76,"\x19"],"\xD6"=>[104,"\x19"],"\xD7"=>[16,"\x19"],"\xD8"=>[94,"\x1A"],"\xD9"=>[76,"\x1A"],"\xDA"=>[104,"\x1A"],"\xDB"=>[16,"\x1A"],"\xDC"=>[94,"\x1B"],"\xDD"=>[76,"\x1B"],"\xDE"=>[104,"\x1B"],"\xDF"=>[16,"\x1B"],"\xE0"=>[94,"\x1C"],"\xE1"=>[76,"\x1C"],"\xE2"=>[104,"\x1C"],"\xE3"=>[16,"\x1C"],"\xE4"=>[94,"\x1D"],"\xE5"=>[76,"\x1D"],"\xE6"=>[104,"\x1D"],"\xE7"=>[16,"\x1D"],"\xE8"=>[94,"\x1E"],"\xE9"=>[76,"\x1E"],"\xEA"=>[104,"\x1E"],"\xEB"=>[16,"\x1E"],"\xEC"=>[94,"\x1F"],"\xED"=>[76,"\x1F"],"\xEE"=>[104,"\x1F"],"\xEF"=>[16,"\x1F"],"\xF0"=>[94,"\x7F"],"\xF1"=>[76,"\x7F"],"\xF2"=>[104,"\x7F"],"\xF3"=>[16,"\x7F"],"\xF4"=>[94,"\xDC"],"\xF5"=>[76,"\xDC"],"\xF6"=>[104,"\xDC"],"\xF7"=>[16,"\xDC"],"\xF8"=>[94,"\xF9"],"\xF9"=>[76,"\xF9"],"\xFA"=>[104,"\xF9"],"\xFB"=>[16,"\xF9"],"\xFC"=>[0,"\x0A"],"\xFD"=>[0,"\x0D"],"\xFE"=>[0,"\x16"],"\xFF"=>[0,""],],["\x00"=>[93,"\xC0"],"\x01"=>[138,"\xC0"],"\x02"=>[75,"\xC0"],"\x03"=>[91,"\xC0"],"\x04"=>[108,"\xC0"],"\x05"=>[103,"\xC0"],"\x06"=>[114,"\xC0"],"\x07"=>[14,"\xC0"],"\x08"=>[93,"\xC1"],"\x09"=>[138,"\xC1"],"\x0A"=>[75,"\xC1"],"\x0B"=>[91,"\xC1"],"\x0C"=>[108,"\xC1"],"\x0D"=>[103,"\xC1"],"\x0E"=>[114,"\xC1"],"\x0F"=>[14,"\xC1"],"\x10"=>[93,"\xC8"],"\x11"=>[138,"\xC8"],"\x12"=>[75,"\xC8"],"\x13"=>[91,"\xC8"],"\x14"=>[108,"\xC8"],"\x15"=>[103,"\xC8"],"\x16"=>[114,"\xC8"],"\x17"=>[14,"\xC8"],"\x18"=>[93,"\xC9"],"\x19"=>[138,"\xC9"],"\x1A"=>[75,"\xC9"],"\x1B"=>[91,"\xC9"],"\x1C"=>[108,"\xC9"],"\x1D"=>[103,"\xC9"],"\x1E"=>[114,"\xC9"],"\x1F"=>[14,"\xC9"],"\x20"=>[93,"\xCA"],"\x21"=>[138,"\xCA"],"\x22"=>[75,"\xCA"],"\x23"=>[91,"\xCA"],"\x24"=>[108,"\xCA"],"\x25"=>[103,"\xCA"],"\x26"=>[114,"\xCA"],"\x27"=>[14,"\xCA"],"\x28"=>[93,"\xCD"],"\x29"=>[138,"\xCD"],"\x2A"=>[75,"\xCD"],"\x2B"=>[91,"\xCD"],"\x2C"=>[108,"\xCD"],"-"=>[103,"\xCD"],"."=>[114,"\xCD"],"\x2F"=>[14,"\xCD"],[93,"\xD2"],[138,"\xD2"],[75,"\xD2"],[91,"\xD2"],[108,"\xD2"],[103,"\xD2"],[114,"\xD2"],[14,"\xD2"],[93,"\xD5"],[138,"\xD5"],"\x3A"=>[75,"\xD5"],"\x3B"=>[91,"\xD5"],"\x3C"=>[108,"\xD5"],"\x3D"=>[103,"\xD5"],"\x3E"=>[114,"\xD5"],"\x3F"=>[14,"\xD5"],"\x40"=>[93,"\xDA"],"A"=>[138,"\xDA"],"B"=>[75,"\xDA"],"C"=>[91,"\xDA"],"D"=>[108,"\xDA"],"E"=>[103,"\xDA"],"F"=>[114,"\xDA"],"G"=>[14,"\xDA"],"H"=>[93,"\xDB"],"I"=>[138,"\xDB"],"J"=>[75,"\xDB"],"K"=>[91,"\xDB"],"L"=>[108,"\xDB"],"M"=>[103,"\xDB"],"N"=>[114,"\xDB"],"O"=>[14,"\xDB"],"P"=>[93,"\xEE"],"Q"=>[138,"\xEE"],"R"=>[75,"\xEE"],"S"=>[91,"\xEE"],"T"=>[108,"\xEE"],"U"=>[103,"\xEE"],"V"=>[114,"\xEE"],"W"=>[14,"\xEE"],"X"=>[93,"\xF0"],"Y"=>[138,"\xF0"],"Z"=>[75,"\xF0"],"\x5B"=>[91,"\xF0"],"\x5C"=>[108,"\xF0"],"\x5D"=>[103,"\xF0"],"\x5E"=>[114,"\xF0"],"_"=>[14,"\xF0"],"\x60"=>[93,"\xF2"],"a"=>[138,"\xF2"],"b"=>[75,"\xF2"],"c"=>[91,"\xF2"],"d"=>[108,"\xF2"],"e"=>[103,"\xF2"],"f"=>[114,"\xF2"],"g"=>[14,"\xF2"],"h"=>[93,"\xF3"],"i"=>[138,"\xF3"],"j"=>[75,"\xF3"],"k"=>[91,"\xF3"],"l"=>[108,"\xF3"],"m"=>[103,"\xF3"],"n"=>[114,"\xF3"],"o"=>[14,"\xF3"],"p"=>[93,"\xFF"],"q"=>[138,"\xFF"],"r"=>[75,"\xFF"],"s"=>[91,"\xFF"],"t"=>[108,"\xFF"],"u"=>[103,"\xFF"],"v"=>[114,"\xFF"],"w"=>[14,"\xFF"],"x"=>[94,"\xCB"],"y"=>[76,"\xCB"],"z"=>[104,"\xCB"],"\x7B"=>[16,"\xCB"],"\x7C"=>[94,"\xCC"],"\x7D"=>[76,"\xCC"],"~"=>[104,"\xCC"],"\x7F"=>[16,"\xCC"],"\x80"=>[94,"\xD3"],"\x81"=>[76,"\xD3"],"\x82"=>[104,"\xD3"],"\x83"=>[16,"\xD3"],"\x84"=>[94,"\xD4"],"\x85"=>[76,"\xD4"],"\x86"=>[104,"\xD4"],"\x87"=>[16,"\xD4"],"\x88"=>[94,"\xD6"],"\x89"=>[76,"\xD6"],"\x8A"=>[104,"\xD6"],"\x8B"=>[16,"\xD6"],"\x8C"=>[94,"\xDD"],"\x8D"=>[76,"\xDD"],"\x8E"=>[104,"\xDD"],"\x8F"=>[16,"\xDD"],"\x90"=>[94,"\xDE"],"\x91"=>[76,"\xDE"],"\x92"=>[104,"\xDE"],"\x93"=>[16,"\xDE"],"\x94"=>[94,"\xDF"],"\x95"=>[76,"\xDF"],"\x96"=>[104,"\xDF"],"\x97"=>[16,"\xDF"],"\x98"=>[94,"\xF1"],"\x99"=>[76,"\xF1"],"\x9A"=>[104,"\xF1"],"\x9B"=>[16,"\xF1"],"\x9C"=>[94,"\xF4"],"\x9D"=>[76,"\xF4"],"\x9E"=>[104,"\xF4"],"\x9F"=>[16,"\xF4"],"\xA0"=>[94,"\xF5"],"\xA1"=>[76,"\xF5"],"\xA2"=>[104,"\xF5"],"\xA3"=>[16,"\xF5"],"\xA4"=>[94,"\xF6"],"\xA5"=>[76,"\xF6"],"\xA6"=>[104,"\xF6"],"\xA7"=>[16,"\xF6"],"\xA8"=>[94,"\xF7"],"\xA9"=>[76,"\xF7"],"\xAA"=>[104,"\xF7"],"\xAB"=>[16,"\xF7"],"\xAC"=>[94,"\xF8"],"\xAD"=>[76,"\xF8"],"\xAE"=>[104,"\xF8"],"\xAF"=>[16,"\xF8"],"\xB0"=>[94,"\xFA"],"\xB1"=>[76,"\xFA"],"\xB2"=>[104,"\xFA"],"\xB3"=>[16,"\xFA"],"\xB4"=>[94,"\xFB"],"\xB5"=>[76,"\xFB"],"\xB6"=>[104,"\xFB"],"\xB7"=>[16,"\xFB"],"\xB8"=>[94,"\xFC"],"\xB9"=>[76,"\xFC"],"\xBA"=>[104,"\xFC"],"\xBB"=>[16,"\xFC"],"\xBC"=>[94,"\xFD"],"\xBD"=>[76,"\xFD"],"\xBE"=>[104,"\xFD"],"\xBF"=>[16,"\xFD"],"\xC0"=>[94,"\xFE"],"\xC1"=>[76,"\xFE"],"\xC2"=>[104,"\xFE"],"\xC3"=>[16,"\xFE"],"\xC4"=>[77,"\x02"],"\xC5"=>[18,"\x02"],"\xC6"=>[77,"\x03"],"\xC7"=>[18,"\x03"],"\xC8"=>[77,"\x04"],"\xC9"=>[18,"\x04"],"\xCA"=>[77,"\x05"],"\xCB"=>[18,"\x05"],"\xCC"=>[77,"\x06"],"\xCD"=>[18,"\x06"],"\xCE"=>[77,"\x07"],"\xCF"=>[18,"\x07"],"\xD0"=>[77,"\x08"],"\xD1"=>[18,"\x08"],"\xD2"=>[77,"\x0B"],"\xD3"=>[18,"\x0B"],"\xD4"=>[77,"\x0C"],"\xD5"=>[18,"\x0C"],"\xD6"=>[77,"\x0E"],"\xD7"=>[18,"\x0E"],"\xD8"=>[77,"\x0F"],"\xD9"=>[18,"\x0F"],"\xDA"=>[77,"\x10"],"\xDB"=>[18,"\x10"],"\xDC"=>[77,"\x11"],"\xDD"=>[18,"\x11"],"\xDE"=>[77,"\x12"],"\xDF"=>[18,"\x12"],"\xE0"=>[77,"\x13"],"\xE1"=>[18,"\x13"],"\xE2"=>[77,"\x14"],"\xE3"=>[18,"\x14"],"\xE4"=>[77,"\x15"],"\xE5"=>[18,"\x15"],"\xE6"=>[77,"\x17"],"\xE7"=>[18,"\x17"],"\xE8"=>[77,"\x18"],"\xE9"=>[18,"\x18"],"\xEA"=>[77,"\x19"],"\xEB"=>[18,"\x19"],"\xEC"=>[77,"\x1A"],"\xED"=>[18,"\x1A"],"\xEE"=>[77,"\x1B"],"\xEF"=>[18,"\x1B"],"\xF0"=>[77,"\x1C"],"\xF1"=>[18,"\x1C"],"\xF2"=>[77,"\x1D"],"\xF3"=>[18,"\x1D"],"\xF4"=>[77,"\x1E"],"\xF5"=>[18,"\x1E"],"\xF6"=>[77,"\x1F"],"\xF7"=>[18,"\x1F"],"\xF8"=>[77,"\x7F"],"\xF9"=>[18,"\x7F"],"\xFA"=>[77,"\xDC"],"\xFB"=>[18,"\xDC"],"\xFC"=>[77,"\xF9"],"\xFD"=>[18,"\xF9"],"\xFE"=>[53,null],"\xFF"=>[66,null],],["\x00"=>[92,"\xAB"],"\x01"=>[95,"\xAB"],"\x02"=>[137,"\xAB"],"\x03"=>[142,"\xAB"],"\x04"=>[150,"\xAB"],"\x05"=>[74,"\xAB"],"\x06"=>[90,"\xAB"],"\x07"=>[98,"\xAB"],"\x08"=>[107,"\xAB"],"\x09"=>[140,"\xAB"],"\x0A"=>[146,"\xAB"],"\x0B"=>[102,"\xAB"],"\x0C"=>[113,"\xAB"],"\x0D"=>[121,"\xAB"],"\x0E"=>[128,"\xAB"],"\x0F"=>[12,"\xAB"],"\x10"=>[92,"\xCE"],"\x11"=>[95,"\xCE"],"\x12"=>[137,"\xCE"],"\x13"=>[142,"\xCE"],"\x14"=>[150,"\xCE"],"\x15"=>[74,"\xCE"],"\x16"=>[90,"\xCE"],"\x17"=>[98,"\xCE"],"\x18"=>[107,"\xCE"],"\x19"=>[140,"\xCE"],"\x1A"=>[146,"\xCE"],"\x1B"=>[102,"\xCE"],"\x1C"=>[113,"\xCE"],"\x1D"=>[121,"\xCE"],"\x1E"=>[128,"\xCE"],"\x1F"=>[12,"\xCE"],"\x20"=>[92,"\xD7"],"\x21"=>[95,"\xD7"],"\x22"=>[137,"\xD7"],"\x23"=>[142,"\xD7"],"\x24"=>[150,"\xD7"],"\x25"=>[74,"\xD7"],"\x26"=>[90,"\xD7"],"\x27"=>[98,"\xD7"],"\x28"=>[107,"\xD7"],"\x29"=>[140,"\xD7"],"\x2A"=>[146,"\xD7"],"\x2B"=>[102,"\xD7"],"\x2C"=>[113,"\xD7"],"-"=>[121,"\xD7"],"."=>[128,"\xD7"],"\x2F"=>[12,"\xD7"],[92,"\xE1"],[95,"\xE1"],[137,"\xE1"],[142,"\xE1"],[150,"\xE1"],[74,"\xE1"],[90,"\xE1"],[98,"\xE1"],[107,"\xE1"],[140,"\xE1"],"\x3A"=>[146,"\xE1"],"\x3B"=>[102,"\xE1"],"\x3C"=>[113,"\xE1"],"\x3D"=>[121,"\xE1"],"\x3E"=>[128,"\xE1"],"\x3F"=>[12,"\xE1"],"\x40"=>[92,"\xEC"],"A"=>[95,"\xEC"],"B"=>[137,"\xEC"],"C"=>[142,"\xEC"],"D"=>[150,"\xEC"],"E"=>[74,"\xEC"],"F"=>[90,"\xEC"],"G"=>[98,"\xEC"],"H"=>[107,"\xEC"],"I"=>[140,"\xEC"],"J"=>[146,"\xEC"],"K"=>[102,"\xEC"],"L"=>[113,"\xEC"],"M"=>[121,"\xEC"],"N"=>[128,"\xEC"],"O"=>[12,"\xEC"],"P"=>[92,"\xED"],"Q"=>[95,"\xED"],"R"=>[137,"\xED"],"S"=>[142,"\xED"],"T"=>[150,"\xED"],"U"=>[74,"\xED"],"V"=>[90,"\xED"],"W"=>[98,"\xED"],"X"=>[107,"\xED"],"Y"=>[140,"\xED"],"Z"=>[146,"\xED"],"\x5B"=>[102,"\xED"],"\x5C"=>[113,"\xED"],"\x5D"=>[121,"\xED"],"\x5E"=>[128,"\xED"],"_"=>[12,"\xED"],"\x60"=>[93,"\xC7"],"a"=>[138,"\xC7"],"b"=>[75,"\xC7"],"c"=>[91,"\xC7"],"d"=>[108,"\xC7"],"e"=>[103,"\xC7"],"f"=>[114,"\xC7"],"g"=>[14,"\xC7"],"h"=>[93,"\xCF"],"i"=>[138,"\xCF"],"j"=>[75,"\xCF"],"k"=>[91,"\xCF"],"l"=>[108,"\xCF"],"m"=>[103,"\xCF"],"n"=>[114,"\xCF"],"o"=>[14,"\xCF"],"p"=>[93,"\xEA"],"q"=>[138,"\xEA"],"r"=>[75,"\xEA"],"s"=>[91,"\xEA"],"t"=>[108,"\xEA"],"u"=>[103,"\xEA"],"v"=>[114,"\xEA"],"w"=>[14,"\xEA"],"x"=>[93,"\xEB"],"y"=>[138,"\xEB"],"z"=>[75,"\xEB"],"\x7B"=>[91,"\xEB"],"\x7C"=>[108,"\xEB"],"\x7D"=>[103,"\xEB"],"~"=>[114,"\xEB"],"\x7F"=>[14,"\xEB"],"\x80"=>[94,"\xC0"],"\x81"=>[76,"\xC0"],"\x82"=>[104,"\xC0"],"\x83"=>[16,"\xC0"],"\x84"=>[94,"\xC1"],"\x85"=>[76,"\xC1"],"\x86"=>[104,"\xC1"],"\x87"=>[16,"\xC1"],"\x88"=>[94,"\xC8"],"\x89"=>[76,"\xC8"],"\x8A"=>[104,"\xC8"],"\x8B"=>[16,"\xC8"],"\x8C"=>[94,"\xC9"],"\x8D"=>[76,"\xC9"],"\x8E"=>[104,"\xC9"],"\x8F"=>[16,"\xC9"],"\x90"=>[94,"\xCA"],"\x91"=>[76,"\xCA"],"\x92"=>[104,"\xCA"],"\x93"=>[16,"\xCA"],"\x94"=>[94,"\xCD"],"\x95"=>[76,"\xCD"],"\x96"=>[104,"\xCD"],"\x97"=>[16,"\xCD"],"\x98"=>[94,"\xD2"],"\x99"=>[76,"\xD2"],"\x9A"=>[104,"\xD2"],"\x9B"=>[16,"\xD2"],"\x9C"=>[94,"\xD5"],"\x9D"=>[76,"\xD5"],"\x9E"=>[104,"\xD5"],"\x9F"=>[16,"\xD5"],"\xA0"=>[94,"\xDA"],"\xA1"=>[76,"\xDA"],"\xA2"=>[104,"\xDA"],"\xA3"=>[16,"\xDA"],"\xA4"=>[94,"\xDB"],"\xA5"=>[76,"\xDB"],"\xA6"=>[104,"\xDB"],"\xA7"=>[16,"\xDB"],"\xA8"=>[94,"\xEE"],"\xA9"=>[76,"\xEE"],"\xAA"=>[104,"\xEE"],"\xAB"=>[16,"\xEE"],"\xAC"=>[94,"\xF0"],"\xAD"=>[76,"\xF0"],"\xAE"=>[104,"\xF0"],"\xAF"=>[16,"\xF0"],"\xB0"=>[94,"\xF2"],"\xB1"=>[76,"\xF2"],"\xB2"=>[104,"\xF2"],"\xB3"=>[16,"\xF2"],"\xB4"=>[94,"\xF3"],"\xB5"=>[76,"\xF3"],"\xB6"=>[104,"\xF3"],"\xB7"=>[16,"\xF3"],"\xB8"=>[94,"\xFF"],"\xB9"=>[76,"\xFF"],"\xBA"=>[104,"\xFF"],"\xBB"=>[16,"\xFF"],"\xBC"=>[77,"\xCB"],"\xBD"=>[18,"\xCB"],"\xBE"=>[77,"\xCC"],"\xBF"=>[18,"\xCC"],"\xC0"=>[77,"\xD3"],"\xC1"=>[18,"\xD3"],"\xC2"=>[77,"\xD4"],"\xC3"=>[18,"\xD4"],"\xC4"=>[77,"\xD6"],"\xC5"=>[18,"\xD6"],"\xC6"=>[77,"\xDD"],"\xC7"=>[18,"\xDD"],"\xC8"=>[77,"\xDE"],"\xC9"=>[18,"\xDE"],"\xCA"=>[77,"\xDF"],"\xCB"=>[18,"\xDF"],"\xCC"=>[77,"\xF1"],"\xCD"=>[18,"\xF1"],"\xCE"=>[77,"\xF4"],"\xCF"=>[18,"\xF4"],"\xD0"=>[77,"\xF5"],"\xD1"=>[18,"\xF5"],"\xD2"=>[77,"\xF6"],"\xD3"=>[18,"\xF6"],"\xD4"=>[77,"\xF7"],"\xD5"=>[18,"\xF7"],"\xD6"=>[77,"\xF8"],"\xD7"=>[18,"\xF8"],"\xD8"=>[77,"\xFA"],"\xD9"=>[18,"\xFA"],"\xDA"=>[77,"\xFB"],"\xDB"=>[18,"\xFB"],"\xDC"=>[77,"\xFC"],"\xDD"=>[18,"\xFC"],"\xDE"=>[77,"\xFD"],"\xDF"=>[18,"\xFD"],"\xE0"=>[77,"\xFE"],"\xE1"=>[18,"\xFE"],"\xE2"=>[0,"\x02"],"\xE3"=>[0,"\x03"],"\xE4"=>[0,"\x04"],"\xE5"=>[0,"\x05"],"\xE6"=>[0,"\x06"],"\xE7"=>[0,"\x07"],"\xE8"=>[0,"\x08"],"\xE9"=>[0,"\x0B"],"\xEA"=>[0,"\x0C"],"\xEB"=>[0,"\x0E"],"\xEC"=>[0,"\x0F"],"\xED"=>[0,"\x10"],"\xEE"=>[0,"\x11"],"\xEF"=>[0,"\x12"],"\xF0"=>[0,"\x13"],"\xF1"=>[0,"\x14"],"\xF2"=>[0,"\x15"],"\xF3"=>[0,"\x17"],"\xF4"=>[0,"\x18"],"\xF5"=>[0,"\x19"],"\xF6"=>[0,"\x1A"],"\xF7"=>[0,"\x1B"],"\xF8"=>[0,"\x1C"],"\xF9"=>[0,"\x1D"],"\xFA"=>[0,"\x1E"],"\xFB"=>[0,"\x1F"],"\xFC"=>[0,"\x7F"],"\xFD"=>[0,"\xDC"],"\xFE"=>[0,"\xF9"],"\xFF"=>[54,null],],["\x00"=>[92,"\xBC"],"\x01"=>[95,"\xBC"],"\x02"=>[137,"\xBC"],"\x03"=>[142,"\xBC"],"\x04"=>[150,"\xBC"],"\x05"=>[74,"\xBC"],"\x06"=>[90,"\xBC"],"\x07"=>[98,"\xBC"],"\x08"=>[107,"\xBC"],"\x09"=>[140,"\xBC"],"\x0A"=>[146,"\xBC"],"\x0B"=>[102,"\xBC"],"\x0C"=>[113,"\xBC"],"\x0D"=>[121,"\xBC"],"\x0E"=>[128,"\xBC"],"\x0F"=>[12,"\xBC"],"\x10"=>[92,"\xBF"],"\x11"=>[95,"\xBF"],"\x12"=>[137,"\xBF"],"\x13"=>[142,"\xBF"],"\x14"=>[150,"\xBF"],"\x15"=>[74,"\xBF"],"\x16"=>[90,"\xBF"],"\x17"=>[98,"\xBF"],"\x18"=>[107,"\xBF"],"\x19"=>[140,"\xBF"],"\x1A"=>[146,"\xBF"],"\x1B"=>[102,"\xBF"],"\x1C"=>[113,"\xBF"],"\x1D"=>[121,"\xBF"],"\x1E"=>[128,"\xBF"],"\x1F"=>[12,"\xBF"],"\x20"=>[92,"\xC5"],"\x21"=>[95,"\xC5"],"\x22"=>[137,"\xC5"],"\x23"=>[142,"\xC5"],"\x24"=>[150,"\xC5"],"\x25"=>[74,"\xC5"],"\x26"=>[90,"\xC5"],"\x27"=>[98,"\xC5"],"\x28"=>[107,"\xC5"],"\x29"=>[140,"\xC5"],"\x2A"=>[146,"\xC5"],"\x2B"=>[102,"\xC5"],"\x2C"=>[113,"\xC5"],"-"=>[121,"\xC5"],"."=>[128,"\xC5"],"\x2F"=>[12,"\xC5"],[92,"\xE7"],[95,"\xE7"],[137,"\xE7"],[142,"\xE7"],[150,"\xE7"],[74,"\xE7"],[90,"\xE7"],[98,"\xE7"],[107,"\xE7"],[140,"\xE7"],"\x3A"=>[146,"\xE7"],"\x3B"=>[102,"\xE7"],"\x3C"=>[113,"\xE7"],"\x3D"=>[121,"\xE7"],"\x3E"=>[128,"\xE7"],"\x3F"=>[12,"\xE7"],"\x40"=>[92,"\xEF"],"A"=>[95,"\xEF"],"B"=>[137,"\xEF"],"C"=>[142,"\xEF"],"D"=>[150,"\xEF"],"E"=>[74,"\xEF"],"F"=>[90,"\xEF"],"G"=>[98,"\xEF"],"H"=>[107,"\xEF"],"I"=>[140,"\xEF"],"J"=>[146,"\xEF"],"K"=>[102,"\xEF"],"L"=>[113,"\xEF"],"M"=>[121,"\xEF"],"N"=>[128,"\xEF"],"O"=>[12,"\xEF"],"P"=>[93,"\x09"],"Q"=>[138,"\x09"],"R"=>[75,"\x09"],"S"=>[91,"\x09"],"T"=>[108,"\x09"],"U"=>[103,"\x09"],"V"=>[114,"\x09"],"W"=>[14,"\x09"],"X"=>[93,"\x8E"],"Y"=>[138,"\x8E"],"Z"=>[75,"\x8E"],"\x5B"=>[91,"\x8E"],"\x5C"=>[108,"\x8E"],"\x5D"=>[103,"\x8E"],"\x5E"=>[114,"\x8E"],"_"=>[14,"\x8E"],"\x60"=>[93,"\x90"],"a"=>[138,"\x90"],"b"=>[75,"\x90"],"c"=>[91,"\x90"],"d"=>[108,"\x90"],"e"=>[103,"\x90"],"f"=>[114,"\x90"],"g"=>[14,"\x90"],"h"=>[93,"\x91"],"i"=>[138,"\x91"],"j"=>[75,"\x91"],"k"=>[91,"\x91"],"l"=>[108,"\x91"],"m"=>[103,"\x91"],"n"=>[114,"\x91"],"o"=>[14,"\x91"],"p"=>[93,"\x94"],"q"=>[138,"\x94"],"r"=>[75,"\x94"],"s"=>[91,"\x94"],"t"=>[108,"\x94"],"u"=>[103,"\x94"],"v"=>[114,"\x94"],"w"=>[14,"\x94"],"x"=>[93,"\x9F"],"y"=>[138,"\x9F"],"z"=>[75,"\x9F"],"\x7B"=>[91,"\x9F"],"\x7C"=>[108,"\x9F"],"\x7D"=>[103,"\x9F"],"~"=>[114,"\x9F"],"\x7F"=>[14,"\x9F"],"\x80"=>[93,"\xAB"],"\x81"=>[138,"\xAB"],"\x82"=>[75,"\xAB"],"\x83"=>[91,"\xAB"],"\x84"=>[108,"\xAB"],"\x85"=>[103,"\xAB"],"\x86"=>[114,"\xAB"],"\x87"=>[14,"\xAB"],"\x88"=>[93,"\xCE"],"\x89"=>[138,"\xCE"],"\x8A"=>[75,"\xCE"],"\x8B"=>[91,"\xCE"],"\x8C"=>[108,"\xCE"],"\x8D"=>[103,"\xCE"],"\x8E"=>[114,"\xCE"],"\x8F"=>[14,"\xCE"],"\x90"=>[93,"\xD7"],"\x91"=>[138,"\xD7"],"\x92"=>[75,"\xD7"],"\x93"=>[91,"\xD7"],"\x94"=>[108,"\xD7"],"\x95"=>[103,"\xD7"],"\x96"=>[114,"\xD7"],"\x97"=>[14,"\xD7"],"\x98"=>[93,"\xE1"],"\x99"=>[138,"\xE1"],"\x9A"=>[75,"\xE1"],"\x9B"=>[91,"\xE1"],"\x9C"=>[108,"\xE1"],"\x9D"=>[103,"\xE1"],"\x9E"=>[114,"\xE1"],"\x9F"=>[14,"\xE1"],"\xA0"=>[93,"\xEC"],"\xA1"=>[138,"\xEC"],"\xA2"=>[75,"\xEC"],"\xA3"=>[91,"\xEC"],"\xA4"=>[108,"\xEC"],"\xA5"=>[103,"\xEC"],"\xA6"=>[114,"\xEC"],"\xA7"=>[14,"\xEC"],"\xA8"=>[93,"\xED"],"\xA9"=>[138,"\xED"],"\xAA"=>[75,"\xED"],"\xAB"=>[91,"\xED"],"\xAC"=>[108,"\xED"],"\xAD"=>[103,"\xED"],"\xAE"=>[114,"\xED"],"\xAF"=>[14,"\xED"],"\xB0"=>[94,"\xC7"],"\xB1"=>[76,"\xC7"],"\xB2"=>[104,"\xC7"],"\xB3"=>[16,"\xC7"],"\xB4"=>[94,"\xCF"],"\xB5"=>[76,"\xCF"],"\xB6"=>[104,"\xCF"],"\xB7"=>[16,"\xCF"],"\xB8"=>[94,"\xEA"],"\xB9"=>[76,"\xEA"],"\xBA"=>[104,"\xEA"],"\xBB"=>[16,"\xEA"],"\xBC"=>[94,"\xEB"],"\xBD"=>[76,"\xEB"],"\xBE"=>[104,"\xEB"],"\xBF"=>[16,"\xEB"],"\xC0"=>[77,"\xC0"],"\xC1"=>[18,"\xC0"],"\xC2"=>[77,"\xC1"],"\xC3"=>[18,"\xC1"],"\xC4"=>[77,"\xC8"],"\xC5"=>[18,"\xC8"],"\xC6"=>[77,"\xC9"],"\xC7"=>[18,"\xC9"],"\xC8"=>[77,"\xCA"],"\xC9"=>[18,"\xCA"],"\xCA"=>[77,"\xCD"],"\xCB"=>[18,"\xCD"],"\xCC"=>[77,"\xD2"],"\xCD"=>[18,"\xD2"],"\xCE"=>[77,"\xD5"],"\xCF"=>[18,"\xD5"],"\xD0"=>[77,"\xDA"],"\xD1"=>[18,"\xDA"],"\xD2"=>[77,"\xDB"],"\xD3"=>[18,"\xDB"],"\xD4"=>[77,"\xEE"],"\xD5"=>[18,"\xEE"],"\xD6"=>[77,"\xF0"],"\xD7"=>[18,"\xF0"],"\xD8"=>[77,"\xF2"],"\xD9"=>[18,"\xF2"],"\xDA"=>[77,"\xF3"],"\xDB"=>[18,"\xF3"],"\xDC"=>[77,"\xFF"],"\xDD"=>[18,"\xFF"],"\xDE"=>[0,"\xCB"],"\xDF"=>[0,"\xCC"],"\xE0"=>[0,"\xD3"],"\xE1"=>[0,"\xD4"],"\xE2"=>[0,"\xD6"],"\xE3"=>[0,"\xDD"],"\xE4"=>[0,"\xDE"],"\xE5"=>[0,"\xDF"],"\xE6"=>[0,"\xF1"],"\xE7"=>[0,"\xF4"],"\xE8"=>[0,"\xF5"],"\xE9"=>[0,"\xF6"],"\xEA"=>[0,"\xF7"],"\xEB"=>[0,"\xF8"],"\xEC"=>[0,"\xFA"],"\xED"=>[0,"\xFB"],"\xEE"=>[0,"\xFC"],"\xEF"=>[0,"\xFD"],"\xF0"=>[0,"\xFE"],"\xF1"=>[38,null],"\xF2"=>[42,null],"\xF3"=>[44,null],"\xF4"=>[45,null],"\xF5"=>[58,null],"\xF6"=>[59,null],"\xF7"=>[61,null],"\xF8"=>[62,null],"\xF9"=>[65,null],"\xFA"=>[67,null],"\xFB"=>[69,null],"\xFC"=>[70,null],"\xFD"=>[72,null],"\xFE"=>[154,null],"\xFF"=>[55,null],],["\x00"=>[94,"\x020"],"\x01"=>[76,"\x020"],"\x02"=>[104,"\x020"],"\x03"=>[16,"\x020"],"\x04"=>[94,"\x021"],"\x05"=>[76,"\x021"],"\x06"=>[104,"\x021"],"\x07"=>[16,"\x021"],"\x08"=>[94,"\x022"],"\x09"=>[76,"\x022"],"\x0A"=>[104,"\x022"],"\x0B"=>[16,"\x022"],"\x0C"=>[94,"\x02a"],"\x0D"=>[76,"\x02a"],"\x0E"=>[104,"\x02a"],"\x0F"=>[16,"\x02a"],"\x10"=>[94,"\x02c"],"\x11"=>[76,"\x02c"],"\x12"=>[104,"\x02c"],"\x13"=>[16,"\x02c"],"\x14"=>[94,"\x02e"],"\x15"=>[76,"\x02e"],"\x16"=>[104,"\x02e"],"\x17"=>[16,"\x02e"],"\x18"=>[94,"\x02i"],"\x19"=>[76,"\x02i"],"\x1A"=>[104,"\x02i"],"\x1B"=>[16,"\x02i"],"\x1C"=>[94,"\x02o"],"\x1D"=>[76,"\x02o"],"\x1E"=>[104,"\x02o"],"\x1F"=>[16,"\x02o"],"\x20"=>[94,"\x02s"],"\x21"=>[76,"\x02s"],"\x22"=>[104,"\x02s"],"\x23"=>[16,"\x02s"],"\x24"=>[94,"\x02t"],"\x25"=>[76,"\x02t"],"\x26"=>[104,"\x02t"],"\x27"=>[16,"\x02t"],"\x28"=>[77,"\x02\x20"],"\x29"=>[18,"\x02\x20"],"\x2A"=>[77,"\x02\x25"],"\x2B"=>[18,"\x02\x25"],"\x2C"=>[77,"\x02-"],"-"=>[18,"\x02-"],"."=>[77,"\x02."],"\x2F"=>[18,"\x02."],[77,"\x02\x2F"],[18,"\x02\x2F"],[77,"\x023"],[18,"\x023"],[77,"\x024"],[18,"\x024"],[77,"\x025"],[18,"\x025"],[77,"\x026"],[18,"\x026"],"\x3A"=>[77,"\x027"],"\x3B"=>[18,"\x027"],"\x3C"=>[77,"\x028"],"\x3D"=>[18,"\x028"],"\x3E"=>[77,"\x029"],"\x3F"=>[18,"\x029"],"\x40"=>[77,"\x02\x3D"],"A"=>[18,"\x02\x3D"],"B"=>[77,"\x02A"],"C"=>[18,"\x02A"],"D"=>[77,"\x02_"],"E"=>[18,"\x02_"],"F"=>[77,"\x02b"],"G"=>[18,"\x02b"],"H"=>[77,"\x02d"],"I"=>[18,"\x02d"],"J"=>[77,"\x02f"],"K"=>[18,"\x02f"],"L"=>[77,"\x02g"],"M"=>[18,"\x02g"],"N"=>[77,"\x02h"],"O"=>[18,"\x02h"],"P"=>[77,"\x02l"],"Q"=>[18,"\x02l"],"R"=>[77,"\x02m"],"S"=>[18,"\x02m"],"T"=>[77,"\x02n"],"U"=>[18,"\x02n"],"V"=>[77,"\x02p"],"W"=>[18,"\x02p"],"X"=>[77,"\x02r"],"Y"=>[18,"\x02r"],"Z"=>[77,"\x02u"],"\x5B"=>[18,"\x02u"],"\x5C"=>[0,"\x02\x3A"],"\x5D"=>[0,"\x02B"],"\x5E"=>[0,"\x02C"],"_"=>[0,"\x02D"],"\x60"=>[0,"\x02E"],"a"=>[0,"\x02F"],"b"=>[0,"\x02G"],"c"=>[0,"\x02H"],"d"=>[0,"\x02I"],"e"=>[0,"\x02J"],"f"=>[0,"\x02K"],"g"=>[0,"\x02L"],"h"=>[0,"\x02M"],"i"=>[0,"\x02N"],"j"=>[0,"\x02O"],"k"=>[0,"\x02P"],"l"=>[0,"\x02Q"],"m"=>[0,"\x02R"],"n"=>[0,"\x02S"],"o"=>[0,"\x02T"],"p"=>[0,"\x02U"],"q"=>[0,"\x02V"],"r"=>[0,"\x02W"],"s"=>[0,"\x02Y"],"t"=>[0,"\x02j"],"u"=>[0,"\x02k"],"v"=>[0,"\x02q"],"w"=>[0,"\x02v"],"x"=>[0,"\x02w"],"y"=>[0,"\x02x"],"z"=>[0,"\x02y"],"\x7B"=>[0,"\x02z"],"\x7C"=>[82,"\x02"],"\x7D"=>[87,"\x02"],"~"=>[130,"\x02"],"\x7F"=>[9,"\x02"],"\x80"=>[94,"\x030"],"\x81"=>[76,"\x030"],"\x82"=>[104,"\x030"],"\x83"=>[16,"\x030"],"\x84"=>[94,"\x031"],"\x85"=>[76,"\x031"],"\x86"=>[104,"\x031"],"\x87"=>[16,"\x031"],"\x88"=>[94,"\x032"],"\x89"=>[76,"\x032"],"\x8A"=>[104,"\x032"],"\x8B"=>[16,"\x032"],"\x8C"=>[94,"\x03a"],"\x8D"=>[76,"\x03a"],"\x8E"=>[104,"\x03a"],"\x8F"=>[16,"\x03a"],"\x90"=>[94,"\x03c"],"\x91"=>[76,"\x03c"],"\x92"=>[104,"\x03c"],"\x93"=>[16,"\x03c"],"\x94"=>[94,"\x03e"],"\x95"=>[76,"\x03e"],"\x96"=>[104,"\x03e"],"\x97"=>[16,"\x03e"],"\x98"=>[94,"\x03i"],"\x99"=>[76,"\x03i"],"\x9A"=>[104,"\x03i"],"\x9B"=>[16,"\x03i"],"\x9C"=>[94,"\x03o"],"\x9D"=>[76,"\x03o"],"\x9E"=>[104,"\x03o"],"\x9F"=>[16,"\x03o"],"\xA0"=>[94,"\x03s"],"\xA1"=>[76,"\x03s"],"\xA2"=>[104,"\x03s"],"\xA3"=>[16,"\x03s"],"\xA4"=>[94,"\x03t"],"\xA5"=>[76,"\x03t"],"\xA6"=>[104,"\x03t"],"\xA7"=>[16,"\x03t"],"\xA8"=>[77,"\x03\x20"],"\xA9"=>[18,"\x03\x20"],"\xAA"=>[77,"\x03\x25"],"\xAB"=>[18,"\x03\x25"],"\xAC"=>[77,"\x03-"],"\xAD"=>[18,"\x03-"],"\xAE"=>[77,"\x03."],"\xAF"=>[18,"\x03."],"\xB0"=>[77,"\x03\x2F"],"\xB1"=>[18,"\x03\x2F"],"\xB2"=>[77,"\x033"],"\xB3"=>[18,"\x033"],"\xB4"=>[77,"\x034"],"\xB5"=>[18,"\x034"],"\xB6"=>[77,"\x035"],"\xB7"=>[18,"\x035"],"\xB8"=>[77,"\x036"],"\xB9"=>[18,"\x036"],"\xBA"=>[77,"\x037"],"\xBB"=>[18,"\x037"],"\xBC"=>[77,"\x038"],"\xBD"=>[18,"\x038"],"\xBE"=>[77,"\x039"],"\xBF"=>[18,"\x039"],"\xC0"=>[77,"\x03\x3D"],"\xC1"=>[18,"\x03\x3D"],"\xC2"=>[77,"\x03A"],"\xC3"=>[18,"\x03A"],"\xC4"=>[77,"\x03_"],"\xC5"=>[18,"\x03_"],"\xC6"=>[77,"\x03b"],"\xC7"=>[18,"\x03b"],"\xC8"=>[77,"\x03d"],"\xC9"=>[18,"\x03d"],"\xCA"=>[77,"\x03f"],"\xCB"=>[18,"\x03f"],"\xCC"=>[77,"\x03g"],"\xCD"=>[18,"\x03g"],"\xCE"=>[77,"\x03h"],"\xCF"=>[18,"\x03h"],"\xD0"=>[77,"\x03l"],"\xD1"=>[18,"\x03l"],"\xD2"=>[77,"\x03m"],"\xD3"=>[18,"\x03m"],"\xD4"=>[77,"\x03n"],"\xD5"=>[18,"\x03n"],"\xD6"=>[77,"\x03p"],"\xD7"=>[18,"\x03p"],"\xD8"=>[77,"\x03r"],"\xD9"=>[18,"\x03r"],"\xDA"=>[77,"\x03u"],"\xDB"=>[18,"\x03u"],"\xDC"=>[0,"\x03\x3A"],"\xDD"=>[0,"\x03B"],"\xDE"=>[0,"\x03C"],"\xDF"=>[0,"\x03D"],"\xE0"=>[0,"\x03E"],"\xE1"=>[0,"\x03F"],"\xE2"=>[0,"\x03G"],"\xE3"=>[0,"\x03H"],"\xE4"=>[0,"\x03I"],"\xE5"=>[0,"\x03J"],"\xE6"=>[0,"\x03K"],"\xE7"=>[0,"\x03L"],"\xE8"=>[0,"\x03M"],"\xE9"=>[0,"\x03N"],"\xEA"=>[0,"\x03O"],"\xEB"=>[0,"\x03P"],"\xEC"=>[0,"\x03Q"],"\xED"=>[0,"\x03R"],"\xEE"=>[0,"\x03S"],"\xEF"=>[0,"\x03T"],"\xF0"=>[0,"\x03U"],"\xF1"=>[0,"\x03V"],"\xF2"=>[0,"\x03W"],"\xF3"=>[0,"\x03Y"],"\xF4"=>[0,"\x03j"],"\xF5"=>[0,"\x03k"],"\xF6"=>[0,"\x03q"],"\xF7"=>[0,"\x03v"],"\xF8"=>[0,"\x03w"],"\xF9"=>[0,"\x03x"],"\xFA"=>[0,"\x03y"],"\xFB"=>[0,"\x03z"],"\xFC"=>[82,"\x03"],"\xFD"=>[87,"\x03"],"\xFE"=>[130,"\x03"],"\xFF"=>[9,"\x03"],],["\x00"=>[93,"\x93"],"\x01"=>[138,"\x93"],"\x02"=>[75,"\x93"],"\x03"=>[91,"\x93"],"\x04"=>[108,"\x93"],"\x05"=>[103,"\x93"],"\x06"=>[114,"\x93"],"\x07"=>[14,"\x93"],"\x08"=>[93,"\x95"],"\x09"=>[138,"\x95"],"\x0A"=>[75,"\x95"],"\x0B"=>[91,"\x95"],"\x0C"=>[108,"\x95"],"\x0D"=>[103,"\x95"],"\x0E"=>[114,"\x95"],"\x0F"=>[14,"\x95"],"\x10"=>[93,"\x96"],"\x11"=>[138,"\x96"],"\x12"=>[75,"\x96"],"\x13"=>[91,"\x96"],"\x14"=>[108,"\x96"],"\x15"=>[103,"\x96"],"\x16"=>[114,"\x96"],"\x17"=>[14,"\x96"],"\x18"=>[93,"\x97"],"\x19"=>[138,"\x97"],"\x1A"=>[75,"\x97"],"\x1B"=>[91,"\x97"],"\x1C"=>[108,"\x97"],"\x1D"=>[103,"\x97"],"\x1E"=>[114,"\x97"],"\x1F"=>[14,"\x97"],"\x20"=>[93,"\x98"],"\x21"=>[138,"\x98"],"\x22"=>[75,"\x98"],"\x23"=>[91,"\x98"],"\x24"=>[108,"\x98"],"\x25"=>[103,"\x98"],"\x26"=>[114,"\x98"],"\x27"=>[14,"\x98"],"\x28"=>[93,"\x9B"],"\x29"=>[138,"\x9B"],"\x2A"=>[75,"\x9B"],"\x2B"=>[91,"\x9B"],"\x2C"=>[108,"\x9B"],"-"=>[103,"\x9B"],"."=>[114,"\x9B"],"\x2F"=>[14,"\x9B"],[93,"\x9D"],[138,"\x9D"],[75,"\x9D"],[91,"\x9D"],[108,"\x9D"],[103,"\x9D"],[114,"\x9D"],[14,"\x9D"],[93,"\x9E"],[138,"\x9E"],"\x3A"=>[75,"\x9E"],"\x3B"=>[91,"\x9E"],"\x3C"=>[108,"\x9E"],"\x3D"=>[103,"\x9E"],"\x3E"=>[114,"\x9E"],"\x3F"=>[14,"\x9E"],"\x40"=>[93,"\xA5"],"A"=>[138,"\xA5"],"B"=>[75,"\xA5"],"C"=>[91,"\xA5"],"D"=>[108,"\xA5"],"E"=>[103,"\xA5"],"F"=>[114,"\xA5"],"G"=>[14,"\xA5"],"H"=>[93,"\xA6"],"I"=>[138,"\xA6"],"J"=>[75,"\xA6"],"K"=>[91,"\xA6"],"L"=>[108,"\xA6"],"M"=>[103,"\xA6"],"N"=>[114,"\xA6"],"O"=>[14,"\xA6"],"P"=>[93,"\xA8"],"Q"=>[138,"\xA8"],"R"=>[75,"\xA8"],"S"=>[91,"\xA8"],"T"=>[108,"\xA8"],"U"=>[103,"\xA8"],"V"=>[114,"\xA8"],"W"=>[14,"\xA8"],"X"=>[93,"\xAE"],"Y"=>[138,"\xAE"],"Z"=>[75,"\xAE"],"\x5B"=>[91,"\xAE"],"\x5C"=>[108,"\xAE"],"\x5D"=>[103,"\xAE"],"\x5E"=>[114,"\xAE"],"_"=>[14,"\xAE"],"\x60"=>[93,"\xAF"],"a"=>[138,"\xAF"],"b"=>[75,"\xAF"],"c"=>[91,"\xAF"],"d"=>[108,"\xAF"],"e"=>[103,"\xAF"],"f"=>[114,"\xAF"],"g"=>[14,"\xAF"],"h"=>[93,"\xB4"],"i"=>[138,"\xB4"],"j"=>[75,"\xB4"],"k"=>[91,"\xB4"],"l"=>[108,"\xB4"],"m"=>[103,"\xB4"],"n"=>[114,"\xB4"],"o"=>[14,"\xB4"],"p"=>[93,"\xB6"],"q"=>[138,"\xB6"],"r"=>[75,"\xB6"],"s"=>[91,"\xB6"],"t"=>[108,"\xB6"],"u"=>[103,"\xB6"],"v"=>[114,"\xB6"],"w"=>[14,"\xB6"],"x"=>[93,"\xB7"],"y"=>[138,"\xB7"],"z"=>[75,"\xB7"],"\x7B"=>[91,"\xB7"],"\x7C"=>[108,"\xB7"],"\x7D"=>[103,"\xB7"],"~"=>[114,"\xB7"],"\x7F"=>[14,"\xB7"],"\x80"=>[93,"\xBC"],"\x81"=>[138,"\xBC"],"\x82"=>[75,"\xBC"],"\x83"=>[91,"\xBC"],"\x84"=>[108,"\xBC"],"\x85"=>[103,"\xBC"],"\x86"=>[114,"\xBC"],"\x87"=>[14,"\xBC"],"\x88"=>[93,"\xBF"],"\x89"=>[138,"\xBF"],"\x8A"=>[75,"\xBF"],"\x8B"=>[91,"\xBF"],"\x8C"=>[108,"\xBF"],"\x8D"=>[103,"\xBF"],"\x8E"=>[114,"\xBF"],"\x8F"=>[14,"\xBF"],"\x90"=>[93,"\xC5"],"\x91"=>[138,"\xC5"],"\x92"=>[75,"\xC5"],"\x93"=>[91,"\xC5"],"\x94"=>[108,"\xC5"],"\x95"=>[103,"\xC5"],"\x96"=>[114,"\xC5"],"\x97"=>[14,"\xC5"],"\x98"=>[93,"\xE7"],"\x99"=>[138,"\xE7"],"\x9A"=>[75,"\xE7"],"\x9B"=>[91,"\xE7"],"\x9C"=>[108,"\xE7"],"\x9D"=>[103,"\xE7"],"\x9E"=>[114,"\xE7"],"\x9F"=>[14,"\xE7"],"\xA0"=>[93,"\xEF"],"\xA1"=>[138,"\xEF"],"\xA2"=>[75,"\xEF"],"\xA3"=>[91,"\xEF"],"\xA4"=>[108,"\xEF"],"\xA5"=>[103,"\xEF"],"\xA6"=>[114,"\xEF"],"\xA7"=>[14,"\xEF"],"\xA8"=>[94,"\x09"],"\xA9"=>[76,"\x09"],"\xAA"=>[104,"\x09"],"\xAB"=>[16,"\x09"],"\xAC"=>[94,"\x8E"],"\xAD"=>[76,"\x8E"],"\xAE"=>[104,"\x8E"],"\xAF"=>[16,"\x8E"],"\xB0"=>[94,"\x90"],"\xB1"=>[76,"\x90"],"\xB2"=>[104,"\x90"],"\xB3"=>[16,"\x90"],"\xB4"=>[94,"\x91"],"\xB5"=>[76,"\x91"],"\xB6"=>[104,"\x91"],"\xB7"=>[16,"\x91"],"\xB8"=>[94,"\x94"],"\xB9"=>[76,"\x94"],"\xBA"=>[104,"\x94"],"\xBB"=>[16,"\x94"],"\xBC"=>[94,"\x9F"],"\xBD"=>[76,"\x9F"],"\xBE"=>[104,"\x9F"],"\xBF"=>[16,"\x9F"],"\xC0"=>[94,"\xAB"],"\xC1"=>[76,"\xAB"],"\xC2"=>[104,"\xAB"],"\xC3"=>[16,"\xAB"],"\xC4"=>[94,"\xCE"],"\xC5"=>[76,"\xCE"],"\xC6"=>[104,"\xCE"],"\xC7"=>[16,"\xCE"],"\xC8"=>[94,"\xD7"],"\xC9"=>[76,"\xD7"],"\xCA"=>[104,"\xD7"],"\xCB"=>[16,"\xD7"],"\xCC"=>[94,"\xE1"],"\xCD"=>[76,"\xE1"],"\xCE"=>[104,"\xE1"],"\xCF"=>[16,"\xE1"],"\xD0"=>[94,"\xEC"],"\xD1"=>[76,"\xEC"],"\xD2"=>[104,"\xEC"],"\xD3"=>[16,"\xEC"],"\xD4"=>[94,"\xED"],"\xD5"=>[76,"\xED"],"\xD6"=>[104,"\xED"],"\xD7"=>[16,"\xED"],"\xD8"=>[77,"\xC7"],"\xD9"=>[18,"\xC7"],"\xDA"=>[77,"\xCF"],"\xDB"=>[18,"\xCF"],"\xDC"=>[77,"\xEA"],"\xDD"=>[18,"\xEA"],"\xDE"=>[77,"\xEB"],"\xDF"=>[18,"\xEB"],"\xE0"=>[0,"\xC0"],"\xE1"=>[0,"\xC1"],"\xE2"=>[0,"\xC8"],"\xE3"=>[0,"\xC9"],"\xE4"=>[0,"\xCA"],"\xE5"=>[0,"\xCD"],"\xE6"=>[0,"\xD2"],"\xE7"=>[0,"\xD5"],"\xE8"=>[0,"\xDA"],"\xE9"=>[0,"\xDB"],"\xEA"=>[0,"\xEE"],"\xEB"=>[0,"\xF0"],"\xEC"=>[0,"\xF2"],"\xED"=>[0,"\xF3"],"\xEE"=>[0,"\xFF"],"\xEF"=>[233,null],"\xF0"=>[238,null],"\xF1"=>[240,null],"\xF2"=>[246,null],"\xF3"=>[254,null],"\xF4"=>[257,null],"\xF5"=>[259,null],"\xF6"=>[260,null],"\xF7"=>[262,null],"\xF8"=>[40,null],"\xF9"=>[43,null],"\xFA"=>[46,null],"\xFB"=>[60,null],"\xFC"=>[63,null],"\xFD"=>[68,null],"\xFE"=>[71,null],"\xFF"=>[56,null],],["\x00"=>[94,"\xFE0"],"\x01"=>[76,"\xFE0"],"\x02"=>[104,"\xFE0"],"\x03"=>[16,"\xFE0"],"\x04"=>[94,"\xFE1"],"\x05"=>[76,"\xFE1"],"\x06"=>[104,"\xFE1"],"\x07"=>[16,"\xFE1"],"\x08"=>[94,"\xFE2"],"\x09"=>[76,"\xFE2"],"\x0A"=>[104,"\xFE2"],"\x0B"=>[16,"\xFE2"],"\x0C"=>[94,"\xFEa"],"\x0D"=>[76,"\xFEa"],"\x0E"=>[104,"\xFEa"],"\x0F"=>[16,"\xFEa"],"\x10"=>[94,"\xFEc"],"\x11"=>[76,"\xFEc"],"\x12"=>[104,"\xFEc"],"\x13"=>[16,"\xFEc"],"\x14"=>[94,"\xFEe"],"\x15"=>[76,"\xFEe"],"\x16"=>[104,"\xFEe"],"\x17"=>[16,"\xFEe"],"\x18"=>[94,"\xFEi"],"\x19"=>[76,"\xFEi"],"\x1A"=>[104,"\xFEi"],"\x1B"=>[16,"\xFEi"],"\x1C"=>[94,"\xFEo"],"\x1D"=>[76,"\xFEo"],"\x1E"=>[104,"\xFEo"],"\x1F"=>[16,"\xFEo"],"\x20"=>[94,"\xFEs"],"\x21"=>[76,"\xFEs"],"\x22"=>[104,"\xFEs"],"\x23"=>[16,"\xFEs"],"\x24"=>[94,"\xFEt"],"\x25"=>[76,"\xFEt"],"\x26"=>[104,"\xFEt"],"\x27"=>[16,"\xFEt"],"\x28"=>[77,"\xFE\x20"],"\x29"=>[18,"\xFE\x20"],"\x2A"=>[77,"\xFE\x25"],"\x2B"=>[18,"\xFE\x25"],"\x2C"=>[77,"\xFE-"],"-"=>[18,"\xFE-"],"."=>[77,"\xFE."],"\x2F"=>[18,"\xFE."],[77,"\xFE\x2F"],[18,"\xFE\x2F"],[77,"\xFE3"],[18,"\xFE3"],[77,"\xFE4"],[18,"\xFE4"],[77,"\xFE5"],[18,"\xFE5"],[77,"\xFE6"],[18,"\xFE6"],"\x3A"=>[77,"\xFE7"],"\x3B"=>[18,"\xFE7"],"\x3C"=>[77,"\xFE8"],"\x3D"=>[18,"\xFE8"],"\x3E"=>[77,"\xFE9"],"\x3F"=>[18,"\xFE9"],"\x40"=>[77,"\xFE\x3D"],"A"=>[18,"\xFE\x3D"],"B"=>[77,"\xFEA"],"C"=>[18,"\xFEA"],"D"=>[77,"\xFE_"],"E"=>[18,"\xFE_"],"F"=>[77,"\xFEb"],"G"=>[18,"\xFEb"],"H"=>[77,"\xFEd"],"I"=>[18,"\xFEd"],"J"=>[77,"\xFEf"],"K"=>[18,"\xFEf"],"L"=>[77,"\xFEg"],"M"=>[18,"\xFEg"],"N"=>[77,"\xFEh"],"O"=>[18,"\xFEh"],"P"=>[77,"\xFEl"],"Q"=>[18,"\xFEl"],"R"=>[77,"\xFEm"],"S"=>[18,"\xFEm"],"T"=>[77,"\xFEn"],"U"=>[18,"\xFEn"],"V"=>[77,"\xFEp"],"W"=>[18,"\xFEp"],"X"=>[77,"\xFEr"],"Y"=>[18,"\xFEr"],"Z"=>[77,"\xFEu"],"\x5B"=>[18,"\xFEu"],"\x5C"=>[0,"\xFE\x3A"],"\x5D"=>[0,"\xFEB"],"\x5E"=>[0,"\xFEC"],"_"=>[0,"\xFED"],"\x60"=>[0,"\xFEE"],"a"=>[0,"\xFEF"],"b"=>[0,"\xFEG"],"c"=>[0,"\xFEH"],"d"=>[0,"\xFEI"],"e"=>[0,"\xFEJ"],"f"=>[0,"\xFEK"],"g"=>[0,"\xFEL"],"h"=>[0,"\xFEM"],"i"=>[0,"\xFEN"],"j"=>[0,"\xFEO"],"k"=>[0,"\xFEP"],"l"=>[0,"\xFEQ"],"m"=>[0,"\xFER"],"n"=>[0,"\xFES"],"o"=>[0,"\xFET"],"p"=>[0,"\xFEU"],"q"=>[0,"\xFEV"],"r"=>[0,"\xFEW"],"s"=>[0,"\xFEY"],"t"=>[0,"\xFEj"],"u"=>[0,"\xFEk"],"v"=>[0,"\xFEq"],"w"=>[0,"\xFEv"],"x"=>[0,"\xFEw"],"y"=>[0,"\xFEx"],"z"=>[0,"\xFEy"],"\x7B"=>[0,"\xFEz"],"\x7C"=>[82,"\xFE"],"\x7D"=>[87,"\xFE"],"~"=>[130,"\xFE"],"\x7F"=>[9,"\xFE"],"\x80"=>[77,"\x020"],"\x81"=>[18,"\x020"],"\x82"=>[77,"\x021"],"\x83"=>[18,"\x021"],"\x84"=>[77,"\x022"],"\x85"=>[18,"\x022"],"\x86"=>[77,"\x02a"],"\x87"=>[18,"\x02a"],"\x88"=>[77,"\x02c"],"\x89"=>[18,"\x02c"],"\x8A"=>[77,"\x02e"],"\x8B"=>[18,"\x02e"],"\x8C"=>[77,"\x02i"],"\x8D"=>[18,"\x02i"],"\x8E"=>[77,"\x02o"],"\x8F"=>[18,"\x02o"],"\x90"=>[77,"\x02s"],"\x91"=>[18,"\x02s"],"\x92"=>[77,"\x02t"],"\x93"=>[18,"\x02t"],"\x94"=>[0,"\x02\x20"],"\x95"=>[0,"\x02\x25"],"\x96"=>[0,"\x02-"],"\x97"=>[0,"\x02."],"\x98"=>[0,"\x02\x2F"],"\x99"=>[0,"\x023"],"\x9A"=>[0,"\x024"],"\x9B"=>[0,"\x025"],"\x9C"=>[0,"\x026"],"\x9D"=>[0,"\x027"],"\x9E"=>[0,"\x028"],"\x9F"=>[0,"\x029"],"\xA0"=>[0,"\x02\x3D"],"\xA1"=>[0,"\x02A"],"\xA2"=>[0,"\x02_"],"\xA3"=>[0,"\x02b"],"\xA4"=>[0,"\x02d"],"\xA5"=>[0,"\x02f"],"\xA6"=>[0,"\x02g"],"\xA7"=>[0,"\x02h"],"\xA8"=>[0,"\x02l"],"\xA9"=>[0,"\x02m"],"\xAA"=>[0,"\x02n"],"\xAB"=>[0,"\x02p"],"\xAC"=>[0,"\x02r"],"\xAD"=>[0,"\x02u"],"\xAE"=>[100,"\x02"],"\xAF"=>[110,"\x02"],"\xB0"=>[111,"\x02"],"\xB1"=>[115,"\x02"],"\xB2"=>[116,"\x02"],"\xB3"=>[118,"\x02"],"\xB4"=>[119,"\x02"],"\xB5"=>[122,"\x02"],"\xB6"=>[123,"\x02"],"\xB7"=>[125,"\x02"],"\xB8"=>[126,"\x02"],"\xB9"=>[129,"\x02"],"\xBA"=>[143,"\x02"],"\xBB"=>[148,"\x02"],"\xBC"=>[151,"\x02"],"\xBD"=>[153,"\x02"],"\xBE"=>[83,"\x02"],"\xBF"=>[10,"\x02"],"\xC0"=>[77,"\x030"],"\xC1"=>[18,"\x030"],"\xC2"=>[77,"\x031"],"\xC3"=>[18,"\x031"],"\xC4"=>[77,"\x032"],"\xC5"=>[18,"\x032"],"\xC6"=>[77,"\x03a"],"\xC7"=>[18,"\x03a"],"\xC8"=>[77,"\x03c"],"\xC9"=>[18,"\x03c"],"\xCA"=>[77,"\x03e"],"\xCB"=>[18,"\x03e"],"\xCC"=>[77,"\x03i"],"\xCD"=>[18,"\x03i"],"\xCE"=>[77,"\x03o"],"\xCF"=>[18,"\x03o"],"\xD0"=>[77,"\x03s"],"\xD1"=>[18,"\x03s"],"\xD2"=>[77,"\x03t"],"\xD3"=>[18,"\x03t"],"\xD4"=>[0,"\x03\x20"],"\xD5"=>[0,"\x03\x25"],"\xD6"=>[0,"\x03-"],"\xD7"=>[0,"\x03."],"\xD8"=>[0,"\x03\x2F"],"\xD9"=>[0,"\x033"],"\xDA"=>[0,"\x034"],"\xDB"=>[0,"\x035"],"\xDC"=>[0,"\x036"],"\xDD"=>[0,"\x037"],"\xDE"=>[0,"\x038"],"\xDF"=>[0,"\x039"],"\xE0"=>[0,"\x03\x3D"],"\xE1"=>[0,"\x03A"],"\xE2"=>[0,"\x03_"],"\xE3"=>[0,"\x03b"],"\xE4"=>[0,"\x03d"],"\xE5"=>[0,"\x03f"],"\xE6"=>[0,"\x03g"],"\xE7"=>[0,"\x03h"],"\xE8"=>[0,"\x03l"],"\xE9"=>[0,"\x03m"],"\xEA"=>[0,"\x03n"],"\xEB"=>[0,"\x03p"],"\xEC"=>[0,"\x03r"],"\xED"=>[0,"\x03u"],"\xEE"=>[100,"\x03"],"\xEF"=>[110,"\x03"],"\xF0"=>[111,"\x03"],"\xF1"=>[115,"\x03"],"\xF2"=>[116,"\x03"],"\xF3"=>[118,"\x03"],"\xF4"=>[119,"\x03"],"\xF5"=>[122,"\x03"],"\xF6"=>[123,"\x03"],"\xF7"=>[125,"\x03"],"\xF8"=>[126,"\x03"],"\xF9"=>[129,"\x03"],"\xFA"=>[143,"\x03"],"\xFB"=>[148,"\x03"],"\xFC"=>[151,"\x03"],"\xFD"=>[153,"\x03"],"\xFE"=>[83,"\x03"],"\xFF"=>[10,"\x03"],],["\x00"=>[77,"\xFE0"],"\x01"=>[18,"\xFE0"],"\x02"=>[77,"\xFE1"],"\x03"=>[18,"\xFE1"],"\x04"=>[77,"\xFE2"],"\x05"=>[18,"\xFE2"],"\x06"=>[77,"\xFEa"],"\x07"=>[18,"\xFEa"],"\x08"=>[77,"\xFEc"],"\x09"=>[18,"\xFEc"],"\x0A"=>[77,"\xFEe"],"\x0B"=>[18,"\xFEe"],"\x0C"=>[77,"\xFEi"],"\x0D"=>[18,"\xFEi"],"\x0E"=>[77,"\xFEo"],"\x0F"=>[18,"\xFEo"],"\x10"=>[77,"\xFEs"],"\x11"=>[18,"\xFEs"],"\x12"=>[77,"\xFEt"],"\x13"=>[18,"\xFEt"],"\x14"=>[0,"\xFE\x20"],"\x15"=>[0,"\xFE\x25"],"\x16"=>[0,"\xFE-"],"\x17"=>[0,"\xFE."],"\x18"=>[0,"\xFE\x2F"],"\x19"=>[0,"\xFE3"],"\x1A"=>[0,"\xFE4"],"\x1B"=>[0,"\xFE5"],"\x1C"=>[0,"\xFE6"],"\x1D"=>[0,"\xFE7"],"\x1E"=>[0,"\xFE8"],"\x1F"=>[0,"\xFE9"],"\x20"=>[0,"\xFE\x3D"],"\x21"=>[0,"\xFEA"],"\x22"=>[0,"\xFE_"],"\x23"=>[0,"\xFEb"],"\x24"=>[0,"\xFEd"],"\x25"=>[0,"\xFEf"],"\x26"=>[0,"\xFEg"],"\x27"=>[0,"\xFEh"],"\x28"=>[0,"\xFEl"],"\x29"=>[0,"\xFEm"],"\x2A"=>[0,"\xFEn"],"\x2B"=>[0,"\xFEp"],"\x2C"=>[0,"\xFEr"],"-"=>[0,"\xFEu"],"."=>[100,"\xFE"],"\x2F"=>[110,"\xFE"],[111,"\xFE"],[115,"\xFE"],[116,"\xFE"],[118,"\xFE"],[119,"\xFE"],[122,"\xFE"],[123,"\xFE"],[125,"\xFE"],[126,"\xFE"],[129,"\xFE"],"\x3A"=>[143,"\xFE"],"\x3B"=>[148,"\xFE"],"\x3C"=>[151,"\xFE"],"\x3D"=>[153,"\xFE"],"\x3E"=>[83,"\xFE"],"\x3F"=>[10,"\xFE"],"\x40"=>[0,"\x020"],"A"=>[0,"\x021"],"B"=>[0,"\x022"],"C"=>[0,"\x02a"],"D"=>[0,"\x02c"],"E"=>[0,"\x02e"],"F"=>[0,"\x02i"],"G"=>[0,"\x02o"],"H"=>[0,"\x02s"],"I"=>[0,"\x02t"],"J"=>[73,"\x02"],"K"=>[88,"\x02"],"L"=>[89,"\x02"],"M"=>[96,"\x02"],"N"=>[97,"\x02"],"O"=>[99,"\x02"],"P"=>[106,"\x02"],"Q"=>[136,"\x02"],"R"=>[139,"\x02"],"S"=>[141,"\x02"],"T"=>[145,"\x02"],"U"=>[147,"\x02"],"V"=>[149,"\x02"],"W"=>[101,"\x02"],"X"=>[112,"\x02"],"Y"=>[117,"\x02"],"Z"=>[120,"\x02"],"\x5B"=>[124,"\x02"],"\x5C"=>[127,"\x02"],"\x5D"=>[144,"\x02"],"\x5E"=>[152,"\x02"],"_"=>[11,"\x02"],"\x60"=>[0,"\x030"],"a"=>[0,"\x031"],"b"=>[0,"\x032"],"c"=>[0,"\x03a"],"d"=>[0,"\x03c"],"e"=>[0,"\x03e"],"f"=>[0,"\x03i"],"g"=>[0,"\x03o"],"h"=>[0,"\x03s"],"i"=>[0,"\x03t"],"j"=>[73,"\x03"],"k"=>[88,"\x03"],"l"=>[89,"\x03"],"m"=>[96,"\x03"],"n"=>[97,"\x03"],"o"=>[99,"\x03"],"p"=>[106,"\x03"],"q"=>[136,"\x03"],"r"=>[139,"\x03"],"s"=>[141,"\x03"],"t"=>[145,"\x03"],"u"=>[147,"\x03"],"v"=>[149,"\x03"],"w"=>[101,"\x03"],"x"=>[112,"\x03"],"y"=>[117,"\x03"],"z"=>[120,"\x03"],"\x7B"=>[124,"\x03"],"\x7C"=>[127,"\x03"],"\x7D"=>[144,"\x03"],"~"=>[152,"\x03"],"\x7F"=>[11,"\x03"],"\x80"=>[0,"\x040"],"\x81"=>[0,"\x041"],"\x82"=>[0,"\x042"],"\x83"=>[0,"\x04a"],"\x84"=>[0,"\x04c"],"\x85"=>[0,"\x04e"],"\x86"=>[0,"\x04i"],"\x87"=>[0,"\x04o"],"\x88"=>[0,"\x04s"],"\x89"=>[0,"\x04t"],"\x8A"=>[73,"\x04"],"\x8B"=>[88,"\x04"],"\x8C"=>[89,"\x04"],"\x8D"=>[96,"\x04"],"\x8E"=>[97,"\x04"],"\x8F"=>[99,"\x04"],"\x90"=>[106,"\x04"],"\x91"=>[136,"\x04"],"\x92"=>[139,"\x04"],"\x93"=>[141,"\x04"],"\x94"=>[145,"\x04"],"\x95"=>[147,"\x04"],"\x96"=>[149,"\x04"],"\x97"=>[101,"\x04"],"\x98"=>[112,"\x04"],"\x99"=>[117,"\x04"],"\x9A"=>[120,"\x04"],"\x9B"=>[124,"\x04"],"\x9C"=>[127,"\x04"],"\x9D"=>[144,"\x04"],"\x9E"=>[152,"\x04"],"\x9F"=>[11,"\x04"],"\xA0"=>[0,"\x050"],"\xA1"=>[0,"\x051"],"\xA2"=>[0,"\x052"],"\xA3"=>[0,"\x05a"],"\xA4"=>[0,"\x05c"],"\xA5"=>[0,"\x05e"],"\xA6"=>[0,"\x05i"],"\xA7"=>[0,"\x05o"],"\xA8"=>[0,"\x05s"],"\xA9"=>[0,"\x05t"],"\xAA"=>[73,"\x05"],"\xAB"=>[88,"\x05"],"\xAC"=>[89,"\x05"],"\xAD"=>[96,"\x05"],"\xAE"=>[97,"\x05"],"\xAF"=>[99,"\x05"],"\xB0"=>[106,"\x05"],"\xB1"=>[136,"\x05"],"\xB2"=>[139,"\x05"],"\xB3"=>[141,"\x05"],"\xB4"=>[145,"\x05"],"\xB5"=>[147,"\x05"],"\xB6"=>[149,"\x05"],"\xB7"=>[101,"\x05"],"\xB8"=>[112,"\x05"],"\xB9"=>[117,"\x05"],"\xBA"=>[120,"\x05"],"\xBB"=>[124,"\x05"],"\xBC"=>[127,"\x05"],"\xBD"=>[144,"\x05"],"\xBE"=>[152,"\x05"],"\xBF"=>[11,"\x05"],"\xC0"=>[0,"\x060"],"\xC1"=>[0,"\x061"],"\xC2"=>[0,"\x062"],"\xC3"=>[0,"\x06a"],"\xC4"=>[0,"\x06c"],"\xC5"=>[0,"\x06e"],"\xC6"=>[0,"\x06i"],"\xC7"=>[0,"\x06o"],"\xC8"=>[0,"\x06s"],"\xC9"=>[0,"\x06t"],"\xCA"=>[73,"\x06"],"\xCB"=>[88,"\x06"],"\xCC"=>[89,"\x06"],"\xCD"=>[96,"\x06"],"\xCE"=>[97,"\x06"],"\xCF"=>[99,"\x06"],"\xD0"=>[106,"\x06"],"\xD1"=>[136,"\x06"],"\xD2"=>[139,"\x06"],"\xD3"=>[141,"\x06"],"\xD4"=>[145,"\x06"],"\xD5"=>[147,"\x06"],"\xD6"=>[149,"\x06"],"\xD7"=>[101,"\x06"],"\xD8"=>[112,"\x06"],"\xD9"=>[117,"\x06"],"\xDA"=>[120,"\x06"],"\xDB"=>[124,"\x06"],"\xDC"=>[127,"\x06"],"\xDD"=>[144,"\x06"],"\xDE"=>[152,"\x06"],"\xDF"=>[11,"\x06"],"\xE0"=>[0,"\x070"],"\xE1"=>[0,"\x071"],"\xE2"=>[0,"\x072"],"\xE3"=>[0,"\x07a"],"\xE4"=>[0,"\x07c"],"\xE5"=>[0,"\x07e"],"\xE6"=>[0,"\x07i"],"\xE7"=>[0,"\x07o"],"\xE8"=>[0,"\x07s"],"\xE9"=>[0,"\x07t"],"\xEA"=>[73,"\x07"],"\xEB"=>[88,"\x07"],"\xEC"=>[89,"\x07"],"\xED"=>[96,"\x07"],"\xEE"=>[97,"\x07"],"\xEF"=>[99,"\x07"],"\xF0"=>[106,"\x07"],"\xF1"=>[136,"\x07"],"\xF2"=>[139,"\x07"],"\xF3"=>[141,"\x07"],"\xF4"=>[145,"\x07"],"\xF5"=>[147,"\x07"],"\xF6"=>[149,"\x07"],"\xF7"=>[101,"\x07"],"\xF8"=>[112,"\x07"],"\xF9"=>[117,"\x07"],"\xFA"=>[120,"\x07"],"\xFB"=>[124,"\x07"],"\xFC"=>[127,"\x07"],"\xFD"=>[144,"\x07"],"\xFE"=>[152,"\x07"],"\xFF"=>[11,"\x07"],],["\x00"=>[94,"\x040"],"\x01"=>[76,"\x040"],"\x02"=>[104,"\x040"],"\x03"=>[16,"\x040"],"\x04"=>[94,"\x041"],"\x05"=>[76,"\x041"],"\x06"=>[104,"\x041"],"\x07"=>[16,"\x041"],"\x08"=>[94,"\x042"],"\x09"=>[76,"\x042"],"\x0A"=>[104,"\x042"],"\x0B"=>[16,"\x042"],"\x0C"=>[94,"\x04a"],"\x0D"=>[76,"\x04a"],"\x0E"=>[104,"\x04a"],"\x0F"=>[16,"\x04a"],"\x10"=>[94,"\x04c"],"\x11"=>[76,"\x04c"],"\x12"=>[104,"\x04c"],"\x13"=>[16,"\x04c"],"\x14"=>[94,"\x04e"],"\x15"=>[76,"\x04e"],"\x16"=>[104,"\x04e"],"\x17"=>[16,"\x04e"],"\x18"=>[94,"\x04i"],"\x19"=>[76,"\x04i"],"\x1A"=>[104,"\x04i"],"\x1B"=>[16,"\x04i"],"\x1C"=>[94,"\x04o"],"\x1D"=>[76,"\x04o"],"\x1E"=>[104,"\x04o"],"\x1F"=>[16,"\x04o"],"\x20"=>[94,"\x04s"],"\x21"=>[76,"\x04s"],"\x22"=>[104,"\x04s"],"\x23"=>[16,"\x04s"],"\x24"=>[94,"\x04t"],"\x25"=>[76,"\x04t"],"\x26"=>[104,"\x04t"],"\x27"=>[16,"\x04t"],"\x28"=>[77,"\x04\x20"],"\x29"=>[18,"\x04\x20"],"\x2A"=>[77,"\x04\x25"],"\x2B"=>[18,"\x04\x25"],"\x2C"=>[77,"\x04-"],"-"=>[18,"\x04-"],"."=>[77,"\x04."],"\x2F"=>[18,"\x04."],[77,"\x04\x2F"],[18,"\x04\x2F"],[77,"\x043"],[18,"\x043"],[77,"\x044"],[18,"\x044"],[77,"\x045"],[18,"\x045"],[77,"\x046"],[18,"\x046"],"\x3A"=>[77,"\x047"],"\x3B"=>[18,"\x047"],"\x3C"=>[77,"\x048"],"\x3D"=>[18,"\x048"],"\x3E"=>[77,"\x049"],"\x3F"=>[18,"\x049"],"\x40"=>[77,"\x04\x3D"],"A"=>[18,"\x04\x3D"],"B"=>[77,"\x04A"],"C"=>[18,"\x04A"],"D"=>[77,"\x04_"],"E"=>[18,"\x04_"],"F"=>[77,"\x04b"],"G"=>[18,"\x04b"],"H"=>[77,"\x04d"],"I"=>[18,"\x04d"],"J"=>[77,"\x04f"],"K"=>[18,"\x04f"],"L"=>[77,"\x04g"],"M"=>[18,"\x04g"],"N"=>[77,"\x04h"],"O"=>[18,"\x04h"],"P"=>[77,"\x04l"],"Q"=>[18,"\x04l"],"R"=>[77,"\x04m"],"S"=>[18,"\x04m"],"T"=>[77,"\x04n"],"U"=>[18,"\x04n"],"V"=>[77,"\x04p"],"W"=>[18,"\x04p"],"X"=>[77,"\x04r"],"Y"=>[18,"\x04r"],"Z"=>[77,"\x04u"],"\x5B"=>[18,"\x04u"],"\x5C"=>[0,"\x04\x3A"],"\x5D"=>[0,"\x04B"],"\x5E"=>[0,"\x04C"],"_"=>[0,"\x04D"],"\x60"=>[0,"\x04E"],"a"=>[0,"\x04F"],"b"=>[0,"\x04G"],"c"=>[0,"\x04H"],"d"=>[0,"\x04I"],"e"=>[0,"\x04J"],"f"=>[0,"\x04K"],"g"=>[0,"\x04L"],"h"=>[0,"\x04M"],"i"=>[0,"\x04N"],"j"=>[0,"\x04O"],"k"=>[0,"\x04P"],"l"=>[0,"\x04Q"],"m"=>[0,"\x04R"],"n"=>[0,"\x04S"],"o"=>[0,"\x04T"],"p"=>[0,"\x04U"],"q"=>[0,"\x04V"],"r"=>[0,"\x04W"],"s"=>[0,"\x04Y"],"t"=>[0,"\x04j"],"u"=>[0,"\x04k"],"v"=>[0,"\x04q"],"w"=>[0,"\x04v"],"x"=>[0,"\x04w"],"y"=>[0,"\x04x"],"z"=>[0,"\x04y"],"\x7B"=>[0,"\x04z"],"\x7C"=>[82,"\x04"],"\x7D"=>[87,"\x04"],"~"=>[130,"\x04"],"\x7F"=>[9,"\x04"],"\x80"=>[94,"\x050"],"\x81"=>[76,"\x050"],"\x82"=>[104,"\x050"],"\x83"=>[16,"\x050"],"\x84"=>[94,"\x051"],"\x85"=>[76,"\x051"],"\x86"=>[104,"\x051"],"\x87"=>[16,"\x051"],"\x88"=>[94,"\x052"],"\x89"=>[76,"\x052"],"\x8A"=>[104,"\x052"],"\x8B"=>[16,"\x052"],"\x8C"=>[94,"\x05a"],"\x8D"=>[76,"\x05a"],"\x8E"=>[104,"\x05a"],"\x8F"=>[16,"\x05a"],"\x90"=>[94,"\x05c"],"\x91"=>[76,"\x05c"],"\x92"=>[104,"\x05c"],"\x93"=>[16,"\x05c"],"\x94"=>[94,"\x05e"],"\x95"=>[76,"\x05e"],"\x96"=>[104,"\x05e"],"\x97"=>[16,"\x05e"],"\x98"=>[94,"\x05i"],"\x99"=>[76,"\x05i"],"\x9A"=>[104,"\x05i"],"\x9B"=>[16,"\x05i"],"\x9C"=>[94,"\x05o"],"\x9D"=>[76,"\x05o"],"\x9E"=>[104,"\x05o"],"\x9F"=>[16,"\x05o"],"\xA0"=>[94,"\x05s"],"\xA1"=>[76,"\x05s"],"\xA2"=>[104,"\x05s"],"\xA3"=>[16,"\x05s"],"\xA4"=>[94,"\x05t"],"\xA5"=>[76,"\x05t"],"\xA6"=>[104,"\x05t"],"\xA7"=>[16,"\x05t"],"\xA8"=>[77,"\x05\x20"],"\xA9"=>[18,"\x05\x20"],"\xAA"=>[77,"\x05\x25"],"\xAB"=>[18,"\x05\x25"],"\xAC"=>[77,"\x05-"],"\xAD"=>[18,"\x05-"],"\xAE"=>[77,"\x05."],"\xAF"=>[18,"\x05."],"\xB0"=>[77,"\x05\x2F"],"\xB1"=>[18,"\x05\x2F"],"\xB2"=>[77,"\x053"],"\xB3"=>[18,"\x053"],"\xB4"=>[77,"\x054"],"\xB5"=>[18,"\x054"],"\xB6"=>[77,"\x055"],"\xB7"=>[18,"\x055"],"\xB8"=>[77,"\x056"],"\xB9"=>[18,"\x056"],"\xBA"=>[77,"\x057"],"\xBB"=>[18,"\x057"],"\xBC"=>[77,"\x058"],"\xBD"=>[18,"\x058"],"\xBE"=>[77,"\x059"],"\xBF"=>[18,"\x059"],"\xC0"=>[77,"\x05\x3D"],"\xC1"=>[18,"\x05\x3D"],"\xC2"=>[77,"\x05A"],"\xC3"=>[18,"\x05A"],"\xC4"=>[77,"\x05_"],"\xC5"=>[18,"\x05_"],"\xC6"=>[77,"\x05b"],"\xC7"=>[18,"\x05b"],"\xC8"=>[77,"\x05d"],"\xC9"=>[18,"\x05d"],"\xCA"=>[77,"\x05f"],"\xCB"=>[18,"\x05f"],"\xCC"=>[77,"\x05g"],"\xCD"=>[18,"\x05g"],"\xCE"=>[77,"\x05h"],"\xCF"=>[18,"\x05h"],"\xD0"=>[77,"\x05l"],"\xD1"=>[18,"\x05l"],"\xD2"=>[77,"\x05m"],"\xD3"=>[18,"\x05m"],"\xD4"=>[77,"\x05n"],"\xD5"=>[18,"\x05n"],"\xD6"=>[77,"\x05p"],"\xD7"=>[18,"\x05p"],"\xD8"=>[77,"\x05r"],"\xD9"=>[18,"\x05r"],"\xDA"=>[77,"\x05u"],"\xDB"=>[18,"\x05u"],"\xDC"=>[0,"\x05\x3A"],"\xDD"=>[0,"\x05B"],"\xDE"=>[0,"\x05C"],"\xDF"=>[0,"\x05D"],"\xE0"=>[0,"\x05E"],"\xE1"=>[0,"\x05F"],"\xE2"=>[0,"\x05G"],"\xE3"=>[0,"\x05H"],"\xE4"=>[0,"\x05I"],"\xE5"=>[0,"\x05J"],"\xE6"=>[0,"\x05K"],"\xE7"=>[0,"\x05L"],"\xE8"=>[0,"\x05M"],"\xE9"=>[0,"\x05N"],"\xEA"=>[0,"\x05O"],"\xEB"=>[0,"\x05P"],"\xEC"=>[0,"\x05Q"],"\xED"=>[0,"\x05R"],"\xEE"=>[0,"\x05S"],"\xEF"=>[0,"\x05T"],"\xF0"=>[0,"\x05U"],"\xF1"=>[0,"\x05V"],"\xF2"=>[0,"\x05W"],"\xF3"=>[0,"\x05Y"],"\xF4"=>[0,"\x05j"],"\xF5"=>[0,"\x05k"],"\xF6"=>[0,"\x05q"],"\xF7"=>[0,"\x05v"],"\xF8"=>[0,"\x05w"],"\xF9"=>[0,"\x05x"],"\xFA"=>[0,"\x05y"],"\xFB"=>[0,"\x05z"],"\xFC"=>[82,"\x05"],"\xFD"=>[87,"\x05"],"\xFE"=>[130,"\x05"],"\xFF"=>[9,"\x05"],],["\x00"=>[77,"\x040"],"\x01"=>[18,"\x040"],"\x02"=>[77,"\x041"],"\x03"=>[18,"\x041"],"\x04"=>[77,"\x042"],"\x05"=>[18,"\x042"],"\x06"=>[77,"\x04a"],"\x07"=>[18,"\x04a"],"\x08"=>[77,"\x04c"],"\x09"=>[18,"\x04c"],"\x0A"=>[77,"\x04e"],"\x0B"=>[18,"\x04e"],"\x0C"=>[77,"\x04i"],"\x0D"=>[18,"\x04i"],"\x0E"=>[77,"\x04o"],"\x0F"=>[18,"\x04o"],"\x10"=>[77,"\x04s"],"\x11"=>[18,"\x04s"],"\x12"=>[77,"\x04t"],"\x13"=>[18,"\x04t"],"\x14"=>[0,"\x04\x20"],"\x15"=>[0,"\x04\x25"],"\x16"=>[0,"\x04-"],"\x17"=>[0,"\x04."],"\x18"=>[0,"\x04\x2F"],"\x19"=>[0,"\x043"],"\x1A"=>[0,"\x044"],"\x1B"=>[0,"\x045"],"\x1C"=>[0,"\x046"],"\x1D"=>[0,"\x047"],"\x1E"=>[0,"\x048"],"\x1F"=>[0,"\x049"],"\x20"=>[0,"\x04\x3D"],"\x21"=>[0,"\x04A"],"\x22"=>[0,"\x04_"],"\x23"=>[0,"\x04b"],"\x24"=>[0,"\x04d"],"\x25"=>[0,"\x04f"],"\x26"=>[0,"\x04g"],"\x27"=>[0,"\x04h"],"\x28"=>[0,"\x04l"],"\x29"=>[0,"\x04m"],"\x2A"=>[0,"\x04n"],"\x2B"=>[0,"\x04p"],"\x2C"=>[0,"\x04r"],"-"=>[0,"\x04u"],"."=>[100,"\x04"],"\x2F"=>[110,"\x04"],[111,"\x04"],[115,"\x04"],[116,"\x04"],[118,"\x04"],[119,"\x04"],[122,"\x04"],[123,"\x04"],[125,"\x04"],[126,"\x04"],[129,"\x04"],"\x3A"=>[143,"\x04"],"\x3B"=>[148,"\x04"],"\x3C"=>[151,"\x04"],"\x3D"=>[153,"\x04"],"\x3E"=>[83,"\x04"],"\x3F"=>[10,"\x04"],"\x40"=>[77,"\x050"],"A"=>[18,"\x050"],"B"=>[77,"\x051"],"C"=>[18,"\x051"],"D"=>[77,"\x052"],"E"=>[18,"\x052"],"F"=>[77,"\x05a"],"G"=>[18,"\x05a"],"H"=>[77,"\x05c"],"I"=>[18,"\x05c"],"J"=>[77,"\x05e"],"K"=>[18,"\x05e"],"L"=>[77,"\x05i"],"M"=>[18,"\x05i"],"N"=>[77,"\x05o"],"O"=>[18,"\x05o"],"P"=>[77,"\x05s"],"Q"=>[18,"\x05s"],"R"=>[77,"\x05t"],"S"=>[18,"\x05t"],"T"=>[0,"\x05\x20"],"U"=>[0,"\x05\x25"],"V"=>[0,"\x05-"],"W"=>[0,"\x05."],"X"=>[0,"\x05\x2F"],"Y"=>[0,"\x053"],"Z"=>[0,"\x054"],"\x5B"=>[0,"\x055"],"\x5C"=>[0,"\x056"],"\x5D"=>[0,"\x057"],"\x5E"=>[0,"\x058"],"_"=>[0,"\x059"],"\x60"=>[0,"\x05\x3D"],"a"=>[0,"\x05A"],"b"=>[0,"\x05_"],"c"=>[0,"\x05b"],"d"=>[0,"\x05d"],"e"=>[0,"\x05f"],"f"=>[0,"\x05g"],"g"=>[0,"\x05h"],"h"=>[0,"\x05l"],"i"=>[0,"\x05m"],"j"=>[0,"\x05n"],"k"=>[0,"\x05p"],"l"=>[0,"\x05r"],"m"=>[0,"\x05u"],"n"=>[100,"\x05"],"o"=>[110,"\x05"],"p"=>[111,"\x05"],"q"=>[115,"\x05"],"r"=>[116,"\x05"],"s"=>[118,"\x05"],"t"=>[119,"\x05"],"u"=>[122,"\x05"],"v"=>[123,"\x05"],"w"=>[125,"\x05"],"x"=>[126,"\x05"],"y"=>[129,"\x05"],"z"=>[143,"\x05"],"\x7B"=>[148,"\x05"],"\x7C"=>[151,"\x05"],"\x7D"=>[153,"\x05"],"~"=>[83,"\x05"],"\x7F"=>[10,"\x05"],"\x80"=>[77,"\x060"],"\x81"=>[18,"\x060"],"\x82"=>[77,"\x061"],"\x83"=>[18,"\x061"],"\x84"=>[77,"\x062"],"\x85"=>[18,"\x062"],"\x86"=>[77,"\x06a"],"\x87"=>[18,"\x06a"],"\x88"=>[77,"\x06c"],"\x89"=>[18,"\x06c"],"\x8A"=>[77,"\x06e"],"\x8B"=>[18,"\x06e"],"\x8C"=>[77,"\x06i"],"\x8D"=>[18,"\x06i"],"\x8E"=>[77,"\x06o"],"\x8F"=>[18,"\x06o"],"\x90"=>[77,"\x06s"],"\x91"=>[18,"\x06s"],"\x92"=>[77,"\x06t"],"\x93"=>[18,"\x06t"],"\x94"=>[0,"\x06\x20"],"\x95"=>[0,"\x06\x25"],"\x96"=>[0,"\x06-"],"\x97"=>[0,"\x06."],"\x98"=>[0,"\x06\x2F"],"\x99"=>[0,"\x063"],"\x9A"=>[0,"\x064"],"\x9B"=>[0,"\x065"],"\x9C"=>[0,"\x066"],"\x9D"=>[0,"\x067"],"\x9E"=>[0,"\x068"],"\x9F"=>[0,"\x069"],"\xA0"=>[0,"\x06\x3D"],"\xA1"=>[0,"\x06A"],"\xA2"=>[0,"\x06_"],"\xA3"=>[0,"\x06b"],"\xA4"=>[0,"\x06d"],"\xA5"=>[0,"\x06f"],"\xA6"=>[0,"\x06g"],"\xA7"=>[0,"\x06h"],"\xA8"=>[0,"\x06l"],"\xA9"=>[0,"\x06m"],"\xAA"=>[0,"\x06n"],"\xAB"=>[0,"\x06p"],"\xAC"=>[0,"\x06r"],"\xAD"=>[0,"\x06u"],"\xAE"=>[100,"\x06"],"\xAF"=>[110,"\x06"],"\xB0"=>[111,"\x06"],"\xB1"=>[115,"\x06"],"\xB2"=>[116,"\x06"],"\xB3"=>[118,"\x06"],"\xB4"=>[119,"\x06"],"\xB5"=>[122,"\x06"],"\xB6"=>[123,"\x06"],"\xB7"=>[125,"\x06"],"\xB8"=>[126,"\x06"],"\xB9"=>[129,"\x06"],"\xBA"=>[143,"\x06"],"\xBB"=>[148,"\x06"],"\xBC"=>[151,"\x06"],"\xBD"=>[153,"\x06"],"\xBE"=>[83,"\x06"],"\xBF"=>[10,"\x06"],"\xC0"=>[77,"\x070"],"\xC1"=>[18,"\x070"],"\xC2"=>[77,"\x071"],"\xC3"=>[18,"\x071"],"\xC4"=>[77,"\x072"],"\xC5"=>[18,"\x072"],"\xC6"=>[77,"\x07a"],"\xC7"=>[18,"\x07a"],"\xC8"=>[77,"\x07c"],"\xC9"=>[18,"\x07c"],"\xCA"=>[77,"\x07e"],"\xCB"=>[18,"\x07e"],"\xCC"=>[77,"\x07i"],"\xCD"=>[18,"\x07i"],"\xCE"=>[77,"\x07o"],"\xCF"=>[18,"\x07o"],"\xD0"=>[77,"\x07s"],"\xD1"=>[18,"\x07s"],"\xD2"=>[77,"\x07t"],"\xD3"=>[18,"\x07t"],"\xD4"=>[0,"\x07\x20"],"\xD5"=>[0,"\x07\x25"],"\xD6"=>[0,"\x07-"],"\xD7"=>[0,"\x07."],"\xD8"=>[0,"\x07\x2F"],"\xD9"=>[0,"\x073"],"\xDA"=>[0,"\x074"],"\xDB"=>[0,"\x075"],"\xDC"=>[0,"\x076"],"\xDD"=>[0,"\x077"],"\xDE"=>[0,"\x078"],"\xDF"=>[0,"\x079"],"\xE0"=>[0,"\x07\x3D"],"\xE1"=>[0,"\x07A"],"\xE2"=>[0,"\x07_"],"\xE3"=>[0,"\x07b"],"\xE4"=>[0,"\x07d"],"\xE5"=>[0,"\x07f"],"\xE6"=>[0,"\x07g"],"\xE7"=>[0,"\x07h"],"\xE8"=>[0,"\x07l"],"\xE9"=>[0,"\x07m"],"\xEA"=>[0,"\x07n"],"\xEB"=>[0,"\x07p"],"\xEC"=>[0,"\x07r"],"\xED"=>[0,"\x07u"],"\xEE"=>[100,"\x07"],"\xEF"=>[110,"\x07"],"\xF0"=>[111,"\x07"],"\xF1"=>[115,"\x07"],"\xF2"=>[116,"\x07"],"\xF3"=>[118,"\x07"],"\xF4"=>[119,"\x07"],"\xF5"=>[122,"\x07"],"\xF6"=>[123,"\x07"],"\xF7"=>[125,"\x07"],"\xF8"=>[126,"\x07"],"\xF9"=>[129,"\x07"],"\xFA"=>[143,"\x07"],"\xFB"=>[148,"\x07"],"\xFC"=>[151,"\x07"],"\xFD"=>[153,"\x07"],"\xFE"=>[83,"\x07"],"\xFF"=>[10,"\x07"],],["\x00"=>[94,"\x060"],"\x01"=>[76,"\x060"],"\x02"=>[104,"\x060"],"\x03"=>[16,"\x060"],"\x04"=>[94,"\x061"],"\x05"=>[76,"\x061"],"\x06"=>[104,"\x061"],"\x07"=>[16,"\x061"],"\x08"=>[94,"\x062"],"\x09"=>[76,"\x062"],"\x0A"=>[104,"\x062"],"\x0B"=>[16,"\x062"],"\x0C"=>[94,"\x06a"],"\x0D"=>[76,"\x06a"],"\x0E"=>[104,"\x06a"],"\x0F"=>[16,"\x06a"],"\x10"=>[94,"\x06c"],"\x11"=>[76,"\x06c"],"\x12"=>[104,"\x06c"],"\x13"=>[16,"\x06c"],"\x14"=>[94,"\x06e"],"\x15"=>[76,"\x06e"],"\x16"=>[104,"\x06e"],"\x17"=>[16,"\x06e"],"\x18"=>[94,"\x06i"],"\x19"=>[76,"\x06i"],"\x1A"=>[104,"\x06i"],"\x1B"=>[16,"\x06i"],"\x1C"=>[94,"\x06o"],"\x1D"=>[76,"\x06o"],"\x1E"=>[104,"\x06o"],"\x1F"=>[16,"\x06o"],"\x20"=>[94,"\x06s"],"\x21"=>[76,"\x06s"],"\x22"=>[104,"\x06s"],"\x23"=>[16,"\x06s"],"\x24"=>[94,"\x06t"],"\x25"=>[76,"\x06t"],"\x26"=>[104,"\x06t"],"\x27"=>[16,"\x06t"],"\x28"=>[77,"\x06\x20"],"\x29"=>[18,"\x06\x20"],"\x2A"=>[77,"\x06\x25"],"\x2B"=>[18,"\x06\x25"],"\x2C"=>[77,"\x06-"],"-"=>[18,"\x06-"],"."=>[77,"\x06."],"\x2F"=>[18,"\x06."],[77,"\x06\x2F"],[18,"\x06\x2F"],[77,"\x063"],[18,"\x063"],[77,"\x064"],[18,"\x064"],[77,"\x065"],[18,"\x065"],[77,"\x066"],[18,"\x066"],"\x3A"=>[77,"\x067"],"\x3B"=>[18,"\x067"],"\x3C"=>[77,"\x068"],"\x3D"=>[18,"\x068"],"\x3E"=>[77,"\x069"],"\x3F"=>[18,"\x069"],"\x40"=>[77,"\x06\x3D"],"A"=>[18,"\x06\x3D"],"B"=>[77,"\x06A"],"C"=>[18,"\x06A"],"D"=>[77,"\x06_"],"E"=>[18,"\x06_"],"F"=>[77,"\x06b"],"G"=>[18,"\x06b"],"H"=>[77,"\x06d"],"I"=>[18,"\x06d"],"J"=>[77,"\x06f"],"K"=>[18,"\x06f"],"L"=>[77,"\x06g"],"M"=>[18,"\x06g"],"N"=>[77,"\x06h"],"O"=>[18,"\x06h"],"P"=>[77,"\x06l"],"Q"=>[18,"\x06l"],"R"=>[77,"\x06m"],"S"=>[18,"\x06m"],"T"=>[77,"\x06n"],"U"=>[18,"\x06n"],"V"=>[77,"\x06p"],"W"=>[18,"\x06p"],"X"=>[77,"\x06r"],"Y"=>[18,"\x06r"],"Z"=>[77,"\x06u"],"\x5B"=>[18,"\x06u"],"\x5C"=>[0,"\x06\x3A"],"\x5D"=>[0,"\x06B"],"\x5E"=>[0,"\x06C"],"_"=>[0,"\x06D"],"\x60"=>[0,"\x06E"],"a"=>[0,"\x06F"],"b"=>[0,"\x06G"],"c"=>[0,"\x06H"],"d"=>[0,"\x06I"],"e"=>[0,"\x06J"],"f"=>[0,"\x06K"],"g"=>[0,"\x06L"],"h"=>[0,"\x06M"],"i"=>[0,"\x06N"],"j"=>[0,"\x06O"],"k"=>[0,"\x06P"],"l"=>[0,"\x06Q"],"m"=>[0,"\x06R"],"n"=>[0,"\x06S"],"o"=>[0,"\x06T"],"p"=>[0,"\x06U"],"q"=>[0,"\x06V"],"r"=>[0,"\x06W"],"s"=>[0,"\x06Y"],"t"=>[0,"\x06j"],"u"=>[0,"\x06k"],"v"=>[0,"\x06q"],"w"=>[0,"\x06v"],"x"=>[0,"\x06w"],"y"=>[0,"\x06x"],"z"=>[0,"\x06y"],"\x7B"=>[0,"\x06z"],"\x7C"=>[82,"\x06"],"\x7D"=>[87,"\x06"],"~"=>[130,"\x06"],"\x7F"=>[9,"\x06"],"\x80"=>[94,"\x070"],"\x81"=>[76,"\x070"],"\x82"=>[104,"\x070"],"\x83"=>[16,"\x070"],"\x84"=>[94,"\x071"],"\x85"=>[76,"\x071"],"\x86"=>[104,"\x071"],"\x87"=>[16,"\x071"],"\x88"=>[94,"\x072"],"\x89"=>[76,"\x072"],"\x8A"=>[104,"\x072"],"\x8B"=>[16,"\x072"],"\x8C"=>[94,"\x07a"],"\x8D"=>[76,"\x07a"],"\x8E"=>[104,"\x07a"],"\x8F"=>[16,"\x07a"],"\x90"=>[94,"\x07c"],"\x91"=>[76,"\x07c"],"\x92"=>[104,"\x07c"],"\x93"=>[16,"\x07c"],"\x94"=>[94,"\x07e"],"\x95"=>[76,"\x07e"],"\x96"=>[104,"\x07e"],"\x97"=>[16,"\x07e"],"\x98"=>[94,"\x07i"],"\x99"=>[76,"\x07i"],"\x9A"=>[104,"\x07i"],"\x9B"=>[16,"\x07i"],"\x9C"=>[94,"\x07o"],"\x9D"=>[76,"\x07o"],"\x9E"=>[104,"\x07o"],"\x9F"=>[16,"\x07o"],"\xA0"=>[94,"\x07s"],"\xA1"=>[76,"\x07s"],"\xA2"=>[104,"\x07s"],"\xA3"=>[16,"\x07s"],"\xA4"=>[94,"\x07t"],"\xA5"=>[76,"\x07t"],"\xA6"=>[104,"\x07t"],"\xA7"=>[16,"\x07t"],"\xA8"=>[77,"\x07\x20"],"\xA9"=>[18,"\x07\x20"],"\xAA"=>[77,"\x07\x25"],"\xAB"=>[18,"\x07\x25"],"\xAC"=>[77,"\x07-"],"\xAD"=>[18,"\x07-"],"\xAE"=>[77,"\x07."],"\xAF"=>[18,"\x07."],"\xB0"=>[77,"\x07\x2F"],"\xB1"=>[18,"\x07\x2F"],"\xB2"=>[77,"\x073"],"\xB3"=>[18,"\x073"],"\xB4"=>[77,"\x074"],"\xB5"=>[18,"\x074"],"\xB6"=>[77,"\x075"],"\xB7"=>[18,"\x075"],"\xB8"=>[77,"\x076"],"\xB9"=>[18,"\x076"],"\xBA"=>[77,"\x077"],"\xBB"=>[18,"\x077"],"\xBC"=>[77,"\x078"],"\xBD"=>[18,"\x078"],"\xBE"=>[77,"\x079"],"\xBF"=>[18,"\x079"],"\xC0"=>[77,"\x07\x3D"],"\xC1"=>[18,"\x07\x3D"],"\xC2"=>[77,"\x07A"],"\xC3"=>[18,"\x07A"],"\xC4"=>[77,"\x07_"],"\xC5"=>[18,"\x07_"],"\xC6"=>[77,"\x07b"],"\xC7"=>[18,"\x07b"],"\xC8"=>[77,"\x07d"],"\xC9"=>[18,"\x07d"],"\xCA"=>[77,"\x07f"],"\xCB"=>[18,"\x07f"],"\xCC"=>[77,"\x07g"],"\xCD"=>[18,"\x07g"],"\xCE"=>[77,"\x07h"],"\xCF"=>[18,"\x07h"],"\xD0"=>[77,"\x07l"],"\xD1"=>[18,"\x07l"],"\xD2"=>[77,"\x07m"],"\xD3"=>[18,"\x07m"],"\xD4"=>[77,"\x07n"],"\xD5"=>[18,"\x07n"],"\xD6"=>[77,"\x07p"],"\xD7"=>[18,"\x07p"],"\xD8"=>[77,"\x07r"],"\xD9"=>[18,"\x07r"],"\xDA"=>[77,"\x07u"],"\xDB"=>[18,"\x07u"],"\xDC"=>[0,"\x07\x3A"],"\xDD"=>[0,"\x07B"],"\xDE"=>[0,"\x07C"],"\xDF"=>[0,"\x07D"],"\xE0"=>[0,"\x07E"],"\xE1"=>[0,"\x07F"],"\xE2"=>[0,"\x07G"],"\xE3"=>[0,"\x07H"],"\xE4"=>[0,"\x07I"],"\xE5"=>[0,"\x07J"],"\xE6"=>[0,"\x07K"],"\xE7"=>[0,"\x07L"],"\xE8"=>[0,"\x07M"],"\xE9"=>[0,"\x07N"],"\xEA"=>[0,"\x07O"],"\xEB"=>[0,"\x07P"],"\xEC"=>[0,"\x07Q"],"\xED"=>[0,"\x07R"],"\xEE"=>[0,"\x07S"],"\xEF"=>[0,"\x07T"],"\xF0"=>[0,"\x07U"],"\xF1"=>[0,"\x07V"],"\xF2"=>[0,"\x07W"],"\xF3"=>[0,"\x07Y"],"\xF4"=>[0,"\x07j"],"\xF5"=>[0,"\x07k"],"\xF6"=>[0,"\x07q"],"\xF7"=>[0,"\x07v"],"\xF8"=>[0,"\x07w"],"\xF9"=>[0,"\x07x"],"\xFA"=>[0,"\x07y"],"\xFB"=>[0,"\x07z"],"\xFC"=>[82,"\x07"],"\xFD"=>[87,"\x07"],"\xFE"=>[130,"\x07"],"\xFF"=>[9,"\x07"],],["\x00"=>[94,"\x080"],"\x01"=>[76,"\x080"],"\x02"=>[104,"\x080"],"\x03"=>[16,"\x080"],"\x04"=>[94,"\x081"],"\x05"=>[76,"\x081"],"\x06"=>[104,"\x081"],"\x07"=>[16,"\x081"],"\x08"=>[94,"\x082"],"\x09"=>[76,"\x082"],"\x0A"=>[104,"\x082"],"\x0B"=>[16,"\x082"],"\x0C"=>[94,"\x08a"],"\x0D"=>[76,"\x08a"],"\x0E"=>[104,"\x08a"],"\x0F"=>[16,"\x08a"],"\x10"=>[94,"\x08c"],"\x11"=>[76,"\x08c"],"\x12"=>[104,"\x08c"],"\x13"=>[16,"\x08c"],"\x14"=>[94,"\x08e"],"\x15"=>[76,"\x08e"],"\x16"=>[104,"\x08e"],"\x17"=>[16,"\x08e"],"\x18"=>[94,"\x08i"],"\x19"=>[76,"\x08i"],"\x1A"=>[104,"\x08i"],"\x1B"=>[16,"\x08i"],"\x1C"=>[94,"\x08o"],"\x1D"=>[76,"\x08o"],"\x1E"=>[104,"\x08o"],"\x1F"=>[16,"\x08o"],"\x20"=>[94,"\x08s"],"\x21"=>[76,"\x08s"],"\x22"=>[104,"\x08s"],"\x23"=>[16,"\x08s"],"\x24"=>[94,"\x08t"],"\x25"=>[76,"\x08t"],"\x26"=>[104,"\x08t"],"\x27"=>[16,"\x08t"],"\x28"=>[77,"\x08\x20"],"\x29"=>[18,"\x08\x20"],"\x2A"=>[77,"\x08\x25"],"\x2B"=>[18,"\x08\x25"],"\x2C"=>[77,"\x08-"],"-"=>[18,"\x08-"],"."=>[77,"\x08."],"\x2F"=>[18,"\x08."],[77,"\x08\x2F"],[18,"\x08\x2F"],[77,"\x083"],[18,"\x083"],[77,"\x084"],[18,"\x084"],[77,"\x085"],[18,"\x085"],[77,"\x086"],[18,"\x086"],"\x3A"=>[77,"\x087"],"\x3B"=>[18,"\x087"],"\x3C"=>[77,"\x088"],"\x3D"=>[18,"\x088"],"\x3E"=>[77,"\x089"],"\x3F"=>[18,"\x089"],"\x40"=>[77,"\x08\x3D"],"A"=>[18,"\x08\x3D"],"B"=>[77,"\x08A"],"C"=>[18,"\x08A"],"D"=>[77,"\x08_"],"E"=>[18,"\x08_"],"F"=>[77,"\x08b"],"G"=>[18,"\x08b"],"H"=>[77,"\x08d"],"I"=>[18,"\x08d"],"J"=>[77,"\x08f"],"K"=>[18,"\x08f"],"L"=>[77,"\x08g"],"M"=>[18,"\x08g"],"N"=>[77,"\x08h"],"O"=>[18,"\x08h"],"P"=>[77,"\x08l"],"Q"=>[18,"\x08l"],"R"=>[77,"\x08m"],"S"=>[18,"\x08m"],"T"=>[77,"\x08n"],"U"=>[18,"\x08n"],"V"=>[77,"\x08p"],"W"=>[18,"\x08p"],"X"=>[77,"\x08r"],"Y"=>[18,"\x08r"],"Z"=>[77,"\x08u"],"\x5B"=>[18,"\x08u"],"\x5C"=>[0,"\x08\x3A"],"\x5D"=>[0,"\x08B"],"\x5E"=>[0,"\x08C"],"_"=>[0,"\x08D"],"\x60"=>[0,"\x08E"],"a"=>[0,"\x08F"],"b"=>[0,"\x08G"],"c"=>[0,"\x08H"],"d"=>[0,"\x08I"],"e"=>[0,"\x08J"],"f"=>[0,"\x08K"],"g"=>[0,"\x08L"],"h"=>[0,"\x08M"],"i"=>[0,"\x08N"],"j"=>[0,"\x08O"],"k"=>[0,"\x08P"],"l"=>[0,"\x08Q"],"m"=>[0,"\x08R"],"n"=>[0,"\x08S"],"o"=>[0,"\x08T"],"p"=>[0,"\x08U"],"q"=>[0,"\x08V"],"r"=>[0,"\x08W"],"s"=>[0,"\x08Y"],"t"=>[0,"\x08j"],"u"=>[0,"\x08k"],"v"=>[0,"\x08q"],"w"=>[0,"\x08v"],"x"=>[0,"\x08w"],"y"=>[0,"\x08x"],"z"=>[0,"\x08y"],"\x7B"=>[0,"\x08z"],"\x7C"=>[82,"\x08"],"\x7D"=>[87,"\x08"],"~"=>[130,"\x08"],"\x7F"=>[9,"\x08"],"\x80"=>[94,"\x0B0"],"\x81"=>[76,"\x0B0"],"\x82"=>[104,"\x0B0"],"\x83"=>[16,"\x0B0"],"\x84"=>[94,"\x0B1"],"\x85"=>[76,"\x0B1"],"\x86"=>[104,"\x0B1"],"\x87"=>[16,"\x0B1"],"\x88"=>[94,"\x0B2"],"\x89"=>[76,"\x0B2"],"\x8A"=>[104,"\x0B2"],"\x8B"=>[16,"\x0B2"],"\x8C"=>[94,"\x0Ba"],"\x8D"=>[76,"\x0Ba"],"\x8E"=>[104,"\x0Ba"],"\x8F"=>[16,"\x0Ba"],"\x90"=>[94,"\x0Bc"],"\x91"=>[76,"\x0Bc"],"\x92"=>[104,"\x0Bc"],"\x93"=>[16,"\x0Bc"],"\x94"=>[94,"\x0Be"],"\x95"=>[76,"\x0Be"],"\x96"=>[104,"\x0Be"],"\x97"=>[16,"\x0Be"],"\x98"=>[94,"\x0Bi"],"\x99"=>[76,"\x0Bi"],"\x9A"=>[104,"\x0Bi"],"\x9B"=>[16,"\x0Bi"],"\x9C"=>[94,"\x0Bo"],"\x9D"=>[76,"\x0Bo"],"\x9E"=>[104,"\x0Bo"],"\x9F"=>[16,"\x0Bo"],"\xA0"=>[94,"\x0Bs"],"\xA1"=>[76,"\x0Bs"],"\xA2"=>[104,"\x0Bs"],"\xA3"=>[16,"\x0Bs"],"\xA4"=>[94,"\x0Bt"],"\xA5"=>[76,"\x0Bt"],"\xA6"=>[104,"\x0Bt"],"\xA7"=>[16,"\x0Bt"],"\xA8"=>[77,"\x0B\x20"],"\xA9"=>[18,"\x0B\x20"],"\xAA"=>[77,"\x0B\x25"],"\xAB"=>[18,"\x0B\x25"],"\xAC"=>[77,"\x0B-"],"\xAD"=>[18,"\x0B-"],"\xAE"=>[77,"\x0B."],"\xAF"=>[18,"\x0B."],"\xB0"=>[77,"\x0B\x2F"],"\xB1"=>[18,"\x0B\x2F"],"\xB2"=>[77,"\x0B3"],"\xB3"=>[18,"\x0B3"],"\xB4"=>[77,"\x0B4"],"\xB5"=>[18,"\x0B4"],"\xB6"=>[77,"\x0B5"],"\xB7"=>[18,"\x0B5"],"\xB8"=>[77,"\x0B6"],"\xB9"=>[18,"\x0B6"],"\xBA"=>[77,"\x0B7"],"\xBB"=>[18,"\x0B7"],"\xBC"=>[77,"\x0B8"],"\xBD"=>[18,"\x0B8"],"\xBE"=>[77,"\x0B9"],"\xBF"=>[18,"\x0B9"],"\xC0"=>[77,"\x0B\x3D"],"\xC1"=>[18,"\x0B\x3D"],"\xC2"=>[77,"\x0BA"],"\xC3"=>[18,"\x0BA"],"\xC4"=>[77,"\x0B_"],"\xC5"=>[18,"\x0B_"],"\xC6"=>[77,"\x0Bb"],"\xC7"=>[18,"\x0Bb"],"\xC8"=>[77,"\x0Bd"],"\xC9"=>[18,"\x0Bd"],"\xCA"=>[77,"\x0Bf"],"\xCB"=>[18,"\x0Bf"],"\xCC"=>[77,"\x0Bg"],"\xCD"=>[18,"\x0Bg"],"\xCE"=>[77,"\x0Bh"],"\xCF"=>[18,"\x0Bh"],"\xD0"=>[77,"\x0Bl"],"\xD1"=>[18,"\x0Bl"],"\xD2"=>[77,"\x0Bm"],"\xD3"=>[18,"\x0Bm"],"\xD4"=>[77,"\x0Bn"],"\xD5"=>[18,"\x0Bn"],"\xD6"=>[77,"\x0Bp"],"\xD7"=>[18,"\x0Bp"],"\xD8"=>[77,"\x0Br"],"\xD9"=>[18,"\x0Br"],"\xDA"=>[77,"\x0Bu"],"\xDB"=>[18,"\x0Bu"],"\xDC"=>[0,"\x0B\x3A"],"\xDD"=>[0,"\x0BB"],"\xDE"=>[0,"\x0BC"],"\xDF"=>[0,"\x0BD"],"\xE0"=>[0,"\x0BE"],"\xE1"=>[0,"\x0BF"],"\xE2"=>[0,"\x0BG"],"\xE3"=>[0,"\x0BH"],"\xE4"=>[0,"\x0BI"],"\xE5"=>[0,"\x0BJ"],"\xE6"=>[0,"\x0BK"],"\xE7"=>[0,"\x0BL"],"\xE8"=>[0,"\x0BM"],"\xE9"=>[0,"\x0BN"],"\xEA"=>[0,"\x0BO"],"\xEB"=>[0,"\x0BP"],"\xEC"=>[0,"\x0BQ"],"\xED"=>[0,"\x0BR"],"\xEE"=>[0,"\x0BS"],"\xEF"=>[0,"\x0BT"],"\xF0"=>[0,"\x0BU"],"\xF1"=>[0,"\x0BV"],"\xF2"=>[0,"\x0BW"],"\xF3"=>[0,"\x0BY"],"\xF4"=>[0,"\x0Bj"],"\xF5"=>[0,"\x0Bk"],"\xF6"=>[0,"\x0Bq"],"\xF7"=>[0,"\x0Bv"],"\xF8"=>[0,"\x0Bw"],"\xF9"=>[0,"\x0Bx"],"\xFA"=>[0,"\x0By"],"\xFB"=>[0,"\x0Bz"],"\xFC"=>[82,"\x0B"],"\xFD"=>[87,"\x0B"],"\xFE"=>[130,"\x0B"],"\xFF"=>[9,"\x0B"],],["\x00"=>[77,"\x080"],"\x01"=>[18,"\x080"],"\x02"=>[77,"\x081"],"\x03"=>[18,"\x081"],"\x04"=>[77,"\x082"],"\x05"=>[18,"\x082"],"\x06"=>[77,"\x08a"],"\x07"=>[18,"\x08a"],"\x08"=>[77,"\x08c"],"\x09"=>[18,"\x08c"],"\x0A"=>[77,"\x08e"],"\x0B"=>[18,"\x08e"],"\x0C"=>[77,"\x08i"],"\x0D"=>[18,"\x08i"],"\x0E"=>[77,"\x08o"],"\x0F"=>[18,"\x08o"],"\x10"=>[77,"\x08s"],"\x11"=>[18,"\x08s"],"\x12"=>[77,"\x08t"],"\x13"=>[18,"\x08t"],"\x14"=>[0,"\x08\x20"],"\x15"=>[0,"\x08\x25"],"\x16"=>[0,"\x08-"],"\x17"=>[0,"\x08."],"\x18"=>[0,"\x08\x2F"],"\x19"=>[0,"\x083"],"\x1A"=>[0,"\x084"],"\x1B"=>[0,"\x085"],"\x1C"=>[0,"\x086"],"\x1D"=>[0,"\x087"],"\x1E"=>[0,"\x088"],"\x1F"=>[0,"\x089"],"\x20"=>[0,"\x08\x3D"],"\x21"=>[0,"\x08A"],"\x22"=>[0,"\x08_"],"\x23"=>[0,"\x08b"],"\x24"=>[0,"\x08d"],"\x25"=>[0,"\x08f"],"\x26"=>[0,"\x08g"],"\x27"=>[0,"\x08h"],"\x28"=>[0,"\x08l"],"\x29"=>[0,"\x08m"],"\x2A"=>[0,"\x08n"],"\x2B"=>[0,"\x08p"],"\x2C"=>[0,"\x08r"],"-"=>[0,"\x08u"],"."=>[100,"\x08"],"\x2F"=>[110,"\x08"],[111,"\x08"],[115,"\x08"],[116,"\x08"],[118,"\x08"],[119,"\x08"],[122,"\x08"],[123,"\x08"],[125,"\x08"],[126,"\x08"],[129,"\x08"],"\x3A"=>[143,"\x08"],"\x3B"=>[148,"\x08"],"\x3C"=>[151,"\x08"],"\x3D"=>[153,"\x08"],"\x3E"=>[83,"\x08"],"\x3F"=>[10,"\x08"],"\x40"=>[77,"\x0B0"],"A"=>[18,"\x0B0"],"B"=>[77,"\x0B1"],"C"=>[18,"\x0B1"],"D"=>[77,"\x0B2"],"E"=>[18,"\x0B2"],"F"=>[77,"\x0Ba"],"G"=>[18,"\x0Ba"],"H"=>[77,"\x0Bc"],"I"=>[18,"\x0Bc"],"J"=>[77,"\x0Be"],"K"=>[18,"\x0Be"],"L"=>[77,"\x0Bi"],"M"=>[18,"\x0Bi"],"N"=>[77,"\x0Bo"],"O"=>[18,"\x0Bo"],"P"=>[77,"\x0Bs"],"Q"=>[18,"\x0Bs"],"R"=>[77,"\x0Bt"],"S"=>[18,"\x0Bt"],"T"=>[0,"\x0B\x20"],"U"=>[0,"\x0B\x25"],"V"=>[0,"\x0B-"],"W"=>[0,"\x0B."],"X"=>[0,"\x0B\x2F"],"Y"=>[0,"\x0B3"],"Z"=>[0,"\x0B4"],"\x5B"=>[0,"\x0B5"],"\x5C"=>[0,"\x0B6"],"\x5D"=>[0,"\x0B7"],"\x5E"=>[0,"\x0B8"],"_"=>[0,"\x0B9"],"\x60"=>[0,"\x0B\x3D"],"a"=>[0,"\x0BA"],"b"=>[0,"\x0B_"],"c"=>[0,"\x0Bb"],"d"=>[0,"\x0Bd"],"e"=>[0,"\x0Bf"],"f"=>[0,"\x0Bg"],"g"=>[0,"\x0Bh"],"h"=>[0,"\x0Bl"],"i"=>[0,"\x0Bm"],"j"=>[0,"\x0Bn"],"k"=>[0,"\x0Bp"],"l"=>[0,"\x0Br"],"m"=>[0,"\x0Bu"],"n"=>[100,"\x0B"],"o"=>[110,"\x0B"],"p"=>[111,"\x0B"],"q"=>[115,"\x0B"],"r"=>[116,"\x0B"],"s"=>[118,"\x0B"],"t"=>[119,"\x0B"],"u"=>[122,"\x0B"],"v"=>[123,"\x0B"],"w"=>[125,"\x0B"],"x"=>[126,"\x0B"],"y"=>[129,"\x0B"],"z"=>[143,"\x0B"],"\x7B"=>[148,"\x0B"],"\x7C"=>[151,"\x0B"],"\x7D"=>[153,"\x0B"],"~"=>[83,"\x0B"],"\x7F"=>[10,"\x0B"],"\x80"=>[77,"\x0C0"],"\x81"=>[18,"\x0C0"],"\x82"=>[77,"\x0C1"],"\x83"=>[18,"\x0C1"],"\x84"=>[77,"\x0C2"],"\x85"=>[18,"\x0C2"],"\x86"=>[77,"\x0Ca"],"\x87"=>[18,"\x0Ca"],"\x88"=>[77,"\x0Cc"],"\x89"=>[18,"\x0Cc"],"\x8A"=>[77,"\x0Ce"],"\x8B"=>[18,"\x0Ce"],"\x8C"=>[77,"\x0Ci"],"\x8D"=>[18,"\x0Ci"],"\x8E"=>[77,"\x0Co"],"\x8F"=>[18,"\x0Co"],"\x90"=>[77,"\x0Cs"],"\x91"=>[18,"\x0Cs"],"\x92"=>[77,"\x0Ct"],"\x93"=>[18,"\x0Ct"],"\x94"=>[0,"\x0C\x20"],"\x95"=>[0,"\x0C\x25"],"\x96"=>[0,"\x0C-"],"\x97"=>[0,"\x0C."],"\x98"=>[0,"\x0C\x2F"],"\x99"=>[0,"\x0C3"],"\x9A"=>[0,"\x0C4"],"\x9B"=>[0,"\x0C5"],"\x9C"=>[0,"\x0C6"],"\x9D"=>[0,"\x0C7"],"\x9E"=>[0,"\x0C8"],"\x9F"=>[0,"\x0C9"],"\xA0"=>[0,"\x0C\x3D"],"\xA1"=>[0,"\x0CA"],"\xA2"=>[0,"\x0C_"],"\xA3"=>[0,"\x0Cb"],"\xA4"=>[0,"\x0Cd"],"\xA5"=>[0,"\x0Cf"],"\xA6"=>[0,"\x0Cg"],"\xA7"=>[0,"\x0Ch"],"\xA8"=>[0,"\x0Cl"],"\xA9"=>[0,"\x0Cm"],"\xAA"=>[0,"\x0Cn"],"\xAB"=>[0,"\x0Cp"],"\xAC"=>[0,"\x0Cr"],"\xAD"=>[0,"\x0Cu"],"\xAE"=>[100,"\x0C"],"\xAF"=>[110,"\x0C"],"\xB0"=>[111,"\x0C"],"\xB1"=>[115,"\x0C"],"\xB2"=>[116,"\x0C"],"\xB3"=>[118,"\x0C"],"\xB4"=>[119,"\x0C"],"\xB5"=>[122,"\x0C"],"\xB6"=>[123,"\x0C"],"\xB7"=>[125,"\x0C"],"\xB8"=>[126,"\x0C"],"\xB9"=>[129,"\x0C"],"\xBA"=>[143,"\x0C"],"\xBB"=>[148,"\x0C"],"\xBC"=>[151,"\x0C"],"\xBD"=>[153,"\x0C"],"\xBE"=>[83,"\x0C"],"\xBF"=>[10,"\x0C"],"\xC0"=>[77,"\x0E0"],"\xC1"=>[18,"\x0E0"],"\xC2"=>[77,"\x0E1"],"\xC3"=>[18,"\x0E1"],"\xC4"=>[77,"\x0E2"],"\xC5"=>[18,"\x0E2"],"\xC6"=>[77,"\x0Ea"],"\xC7"=>[18,"\x0Ea"],"\xC8"=>[77,"\x0Ec"],"\xC9"=>[18,"\x0Ec"],"\xCA"=>[77,"\x0Ee"],"\xCB"=>[18,"\x0Ee"],"\xCC"=>[77,"\x0Ei"],"\xCD"=>[18,"\x0Ei"],"\xCE"=>[77,"\x0Eo"],"\xCF"=>[18,"\x0Eo"],"\xD0"=>[77,"\x0Es"],"\xD1"=>[18,"\x0Es"],"\xD2"=>[77,"\x0Et"],"\xD3"=>[18,"\x0Et"],"\xD4"=>[0,"\x0E\x20"],"\xD5"=>[0,"\x0E\x25"],"\xD6"=>[0,"\x0E-"],"\xD7"=>[0,"\x0E."],"\xD8"=>[0,"\x0E\x2F"],"\xD9"=>[0,"\x0E3"],"\xDA"=>[0,"\x0E4"],"\xDB"=>[0,"\x0E5"],"\xDC"=>[0,"\x0E6"],"\xDD"=>[0,"\x0E7"],"\xDE"=>[0,"\x0E8"],"\xDF"=>[0,"\x0E9"],"\xE0"=>[0,"\x0E\x3D"],"\xE1"=>[0,"\x0EA"],"\xE2"=>[0,"\x0E_"],"\xE3"=>[0,"\x0Eb"],"\xE4"=>[0,"\x0Ed"],"\xE5"=>[0,"\x0Ef"],"\xE6"=>[0,"\x0Eg"],"\xE7"=>[0,"\x0Eh"],"\xE8"=>[0,"\x0El"],"\xE9"=>[0,"\x0Em"],"\xEA"=>[0,"\x0En"],"\xEB"=>[0,"\x0Ep"],"\xEC"=>[0,"\x0Er"],"\xED"=>[0,"\x0Eu"],"\xEE"=>[100,"\x0E"],"\xEF"=>[110,"\x0E"],"\xF0"=>[111,"\x0E"],"\xF1"=>[115,"\x0E"],"\xF2"=>[116,"\x0E"],"\xF3"=>[118,"\x0E"],"\xF4"=>[119,"\x0E"],"\xF5"=>[122,"\x0E"],"\xF6"=>[123,"\x0E"],"\xF7"=>[125,"\x0E"],"\xF8"=>[126,"\x0E"],"\xF9"=>[129,"\x0E"],"\xFA"=>[143,"\x0E"],"\xFB"=>[148,"\x0E"],"\xFC"=>[151,"\x0E"],"\xFD"=>[153,"\x0E"],"\xFE"=>[83,"\x0E"],"\xFF"=>[10,"\x0E"],],["\x00"=>[0,"\x080"],"\x01"=>[0,"\x081"],"\x02"=>[0,"\x082"],"\x03"=>[0,"\x08a"],"\x04"=>[0,"\x08c"],"\x05"=>[0,"\x08e"],"\x06"=>[0,"\x08i"],"\x07"=>[0,"\x08o"],"\x08"=>[0,"\x08s"],"\x09"=>[0,"\x08t"],"\x0A"=>[73,"\x08"],"\x0B"=>[88,"\x08"],"\x0C"=>[89,"\x08"],"\x0D"=>[96,"\x08"],"\x0E"=>[97,"\x08"],"\x0F"=>[99,"\x08"],"\x10"=>[106,"\x08"],"\x11"=>[136,"\x08"],"\x12"=>[139,"\x08"],"\x13"=>[141,"\x08"],"\x14"=>[145,"\x08"],"\x15"=>[147,"\x08"],"\x16"=>[149,"\x08"],"\x17"=>[101,"\x08"],"\x18"=>[112,"\x08"],"\x19"=>[117,"\x08"],"\x1A"=>[120,"\x08"],"\x1B"=>[124,"\x08"],"\x1C"=>[127,"\x08"],"\x1D"=>[144,"\x08"],"\x1E"=>[152,"\x08"],"\x1F"=>[11,"\x08"],"\x20"=>[0,"\x0B0"],"\x21"=>[0,"\x0B1"],"\x22"=>[0,"\x0B2"],"\x23"=>[0,"\x0Ba"],"\x24"=>[0,"\x0Bc"],"\x25"=>[0,"\x0Be"],"\x26"=>[0,"\x0Bi"],"\x27"=>[0,"\x0Bo"],"\x28"=>[0,"\x0Bs"],"\x29"=>[0,"\x0Bt"],"\x2A"=>[73,"\x0B"],"\x2B"=>[88,"\x0B"],"\x2C"=>[89,"\x0B"],"-"=>[96,"\x0B"],"."=>[97,"\x0B"],"\x2F"=>[99,"\x0B"],[106,"\x0B"],[136,"\x0B"],[139,"\x0B"],[141,"\x0B"],[145,"\x0B"],[147,"\x0B"],[149,"\x0B"],[101,"\x0B"],[112,"\x0B"],[117,"\x0B"],"\x3A"=>[120,"\x0B"],"\x3B"=>[124,"\x0B"],"\x3C"=>[127,"\x0B"],"\x3D"=>[144,"\x0B"],"\x3E"=>[152,"\x0B"],"\x3F"=>[11,"\x0B"],"\x40"=>[0,"\x0C0"],"A"=>[0,"\x0C1"],"B"=>[0,"\x0C2"],"C"=>[0,"\x0Ca"],"D"=>[0,"\x0Cc"],"E"=>[0,"\x0Ce"],"F"=>[0,"\x0Ci"],"G"=>[0,"\x0Co"],"H"=>[0,"\x0Cs"],"I"=>[0,"\x0Ct"],"J"=>[73,"\x0C"],"K"=>[88,"\x0C"],"L"=>[89,"\x0C"],"M"=>[96,"\x0C"],"N"=>[97,"\x0C"],"O"=>[99,"\x0C"],"P"=>[106,"\x0C"],"Q"=>[136,"\x0C"],"R"=>[139,"\x0C"],"S"=>[141,"\x0C"],"T"=>[145,"\x0C"],"U"=>[147,"\x0C"],"V"=>[149,"\x0C"],"W"=>[101,"\x0C"],"X"=>[112,"\x0C"],"Y"=>[117,"\x0C"],"Z"=>[120,"\x0C"],"\x5B"=>[124,"\x0C"],"\x5C"=>[127,"\x0C"],"\x5D"=>[144,"\x0C"],"\x5E"=>[152,"\x0C"],"_"=>[11,"\x0C"],"\x60"=>[0,"\x0E0"],"a"=>[0,"\x0E1"],"b"=>[0,"\x0E2"],"c"=>[0,"\x0Ea"],"d"=>[0,"\x0Ec"],"e"=>[0,"\x0Ee"],"f"=>[0,"\x0Ei"],"g"=>[0,"\x0Eo"],"h"=>[0,"\x0Es"],"i"=>[0,"\x0Et"],"j"=>[73,"\x0E"],"k"=>[88,"\x0E"],"l"=>[89,"\x0E"],"m"=>[96,"\x0E"],"n"=>[97,"\x0E"],"o"=>[99,"\x0E"],"p"=>[106,"\x0E"],"q"=>[136,"\x0E"],"r"=>[139,"\x0E"],"s"=>[141,"\x0E"],"t"=>[145,"\x0E"],"u"=>[147,"\x0E"],"v"=>[149,"\x0E"],"w"=>[101,"\x0E"],"x"=>[112,"\x0E"],"y"=>[117,"\x0E"],"z"=>[120,"\x0E"],"\x7B"=>[124,"\x0E"],"\x7C"=>[127,"\x0E"],"\x7D"=>[144,"\x0E"],"~"=>[152,"\x0E"],"\x7F"=>[11,"\x0E"],"\x80"=>[0,"\x0F0"],"\x81"=>[0,"\x0F1"],"\x82"=>[0,"\x0F2"],"\x83"=>[0,"\x0Fa"],"\x84"=>[0,"\x0Fc"],"\x85"=>[0,"\x0Fe"],"\x86"=>[0,"\x0Fi"],"\x87"=>[0,"\x0Fo"],"\x88"=>[0,"\x0Fs"],"\x89"=>[0,"\x0Ft"],"\x8A"=>[73,"\x0F"],"\x8B"=>[88,"\x0F"],"\x8C"=>[89,"\x0F"],"\x8D"=>[96,"\x0F"],"\x8E"=>[97,"\x0F"],"\x8F"=>[99,"\x0F"],"\x90"=>[106,"\x0F"],"\x91"=>[136,"\x0F"],"\x92"=>[139,"\x0F"],"\x93"=>[141,"\x0F"],"\x94"=>[145,"\x0F"],"\x95"=>[147,"\x0F"],"\x96"=>[149,"\x0F"],"\x97"=>[101,"\x0F"],"\x98"=>[112,"\x0F"],"\x99"=>[117,"\x0F"],"\x9A"=>[120,"\x0F"],"\x9B"=>[124,"\x0F"],"\x9C"=>[127,"\x0F"],"\x9D"=>[144,"\x0F"],"\x9E"=>[152,"\x0F"],"\x9F"=>[11,"\x0F"],"\xA0"=>[0,"\x100"],"\xA1"=>[0,"\x101"],"\xA2"=>[0,"\x102"],"\xA3"=>[0,"\x10a"],"\xA4"=>[0,"\x10c"],"\xA5"=>[0,"\x10e"],"\xA6"=>[0,"\x10i"],"\xA7"=>[0,"\x10o"],"\xA8"=>[0,"\x10s"],"\xA9"=>[0,"\x10t"],"\xAA"=>[73,"\x10"],"\xAB"=>[88,"\x10"],"\xAC"=>[89,"\x10"],"\xAD"=>[96,"\x10"],"\xAE"=>[97,"\x10"],"\xAF"=>[99,"\x10"],"\xB0"=>[106,"\x10"],"\xB1"=>[136,"\x10"],"\xB2"=>[139,"\x10"],"\xB3"=>[141,"\x10"],"\xB4"=>[145,"\x10"],"\xB5"=>[147,"\x10"],"\xB6"=>[149,"\x10"],"\xB7"=>[101,"\x10"],"\xB8"=>[112,"\x10"],"\xB9"=>[117,"\x10"],"\xBA"=>[120,"\x10"],"\xBB"=>[124,"\x10"],"\xBC"=>[127,"\x10"],"\xBD"=>[144,"\x10"],"\xBE"=>[152,"\x10"],"\xBF"=>[11,"\x10"],"\xC0"=>[0,"\x110"],"\xC1"=>[0,"\x111"],"\xC2"=>[0,"\x112"],"\xC3"=>[0,"\x11a"],"\xC4"=>[0,"\x11c"],"\xC5"=>[0,"\x11e"],"\xC6"=>[0,"\x11i"],"\xC7"=>[0,"\x11o"],"\xC8"=>[0,"\x11s"],"\xC9"=>[0,"\x11t"],"\xCA"=>[73,"\x11"],"\xCB"=>[88,"\x11"],"\xCC"=>[89,"\x11"],"\xCD"=>[96,"\x11"],"\xCE"=>[97,"\x11"],"\xCF"=>[99,"\x11"],"\xD0"=>[106,"\x11"],"\xD1"=>[136,"\x11"],"\xD2"=>[139,"\x11"],"\xD3"=>[141,"\x11"],"\xD4"=>[145,"\x11"],"\xD5"=>[147,"\x11"],"\xD6"=>[149,"\x11"],"\xD7"=>[101,"\x11"],"\xD8"=>[112,"\x11"],"\xD9"=>[117,"\x11"],"\xDA"=>[120,"\x11"],"\xDB"=>[124,"\x11"],"\xDC"=>[127,"\x11"],"\xDD"=>[144,"\x11"],"\xDE"=>[152,"\x11"],"\xDF"=>[11,"\x11"],"\xE0"=>[0,"\x120"],"\xE1"=>[0,"\x121"],"\xE2"=>[0,"\x122"],"\xE3"=>[0,"\x12a"],"\xE4"=>[0,"\x12c"],"\xE5"=>[0,"\x12e"],"\xE6"=>[0,"\x12i"],"\xE7"=>[0,"\x12o"],"\xE8"=>[0,"\x12s"],"\xE9"=>[0,"\x12t"],"\xEA"=>[73,"\x12"],"\xEB"=>[88,"\x12"],"\xEC"=>[89,"\x12"],"\xED"=>[96,"\x12"],"\xEE"=>[97,"\x12"],"\xEF"=>[99,"\x12"],"\xF0"=>[106,"\x12"],"\xF1"=>[136,"\x12"],"\xF2"=>[139,"\x12"],"\xF3"=>[141,"\x12"],"\xF4"=>[145,"\x12"],"\xF5"=>[147,"\x12"],"\xF6"=>[149,"\x12"],"\xF7"=>[101,"\x12"],"\xF8"=>[112,"\x12"],"\xF9"=>[117,"\x12"],"\xFA"=>[120,"\x12"],"\xFB"=>[124,"\x12"],"\xFC"=>[127,"\x12"],"\xFD"=>[144,"\x12"],"\xFE"=>[152,"\x12"],"\xFF"=>[11,"\x12"],],["\x00"=>[94,"\x090"],"\x01"=>[76,"\x090"],"\x02"=>[104,"\x090"],"\x03"=>[16,"\x090"],"\x04"=>[94,"\x091"],"\x05"=>[76,"\x091"],"\x06"=>[104,"\x091"],"\x07"=>[16,"\x091"],"\x08"=>[94,"\x092"],"\x09"=>[76,"\x092"],"\x0A"=>[104,"\x092"],"\x0B"=>[16,"\x092"],"\x0C"=>[94,"\x09a"],"\x0D"=>[76,"\x09a"],"\x0E"=>[104,"\x09a"],"\x0F"=>[16,"\x09a"],"\x10"=>[94,"\x09c"],"\x11"=>[76,"\x09c"],"\x12"=>[104,"\x09c"],"\x13"=>[16,"\x09c"],"\x14"=>[94,"\x09e"],"\x15"=>[76,"\x09e"],"\x16"=>[104,"\x09e"],"\x17"=>[16,"\x09e"],"\x18"=>[94,"\x09i"],"\x19"=>[76,"\x09i"],"\x1A"=>[104,"\x09i"],"\x1B"=>[16,"\x09i"],"\x1C"=>[94,"\x09o"],"\x1D"=>[76,"\x09o"],"\x1E"=>[104,"\x09o"],"\x1F"=>[16,"\x09o"],"\x20"=>[94,"\x09s"],"\x21"=>[76,"\x09s"],"\x22"=>[104,"\x09s"],"\x23"=>[16,"\x09s"],"\x24"=>[94,"\x09t"],"\x25"=>[76,"\x09t"],"\x26"=>[104,"\x09t"],"\x27"=>[16,"\x09t"],"\x28"=>[77,"\x09\x20"],"\x29"=>[18,"\x09\x20"],"\x2A"=>[77,"\x09\x25"],"\x2B"=>[18,"\x09\x25"],"\x2C"=>[77,"\x09-"],"-"=>[18,"\x09-"],"."=>[77,"\x09."],"\x2F"=>[18,"\x09."],[77,"\x09\x2F"],[18,"\x09\x2F"],[77,"\x093"],[18,"\x093"],[77,"\x094"],[18,"\x094"],[77,"\x095"],[18,"\x095"],[77,"\x096"],[18,"\x096"],"\x3A"=>[77,"\x097"],"\x3B"=>[18,"\x097"],"\x3C"=>[77,"\x098"],"\x3D"=>[18,"\x098"],"\x3E"=>[77,"\x099"],"\x3F"=>[18,"\x099"],"\x40"=>[77,"\x09\x3D"],"A"=>[18,"\x09\x3D"],"B"=>[77,"\x09A"],"C"=>[18,"\x09A"],"D"=>[77,"\x09_"],"E"=>[18,"\x09_"],"F"=>[77,"\x09b"],"G"=>[18,"\x09b"],"H"=>[77,"\x09d"],"I"=>[18,"\x09d"],"J"=>[77,"\x09f"],"K"=>[18,"\x09f"],"L"=>[77,"\x09g"],"M"=>[18,"\x09g"],"N"=>[77,"\x09h"],"O"=>[18,"\x09h"],"P"=>[77,"\x09l"],"Q"=>[18,"\x09l"],"R"=>[77,"\x09m"],"S"=>[18,"\x09m"],"T"=>[77,"\x09n"],"U"=>[18,"\x09n"],"V"=>[77,"\x09p"],"W"=>[18,"\x09p"],"X"=>[77,"\x09r"],"Y"=>[18,"\x09r"],"Z"=>[77,"\x09u"],"\x5B"=>[18,"\x09u"],"\x5C"=>[0,"\x09\x3A"],"\x5D"=>[0,"\x09B"],"\x5E"=>[0,"\x09C"],"_"=>[0,"\x09D"],"\x60"=>[0,"\x09E"],"a"=>[0,"\x09F"],"b"=>[0,"\x09G"],"c"=>[0,"\x09H"],"d"=>[0,"\x09I"],"e"=>[0,"\x09J"],"f"=>[0,"\x09K"],"g"=>[0,"\x09L"],"h"=>[0,"\x09M"],"i"=>[0,"\x09N"],"j"=>[0,"\x09O"],"k"=>[0,"\x09P"],"l"=>[0,"\x09Q"],"m"=>[0,"\x09R"],"n"=>[0,"\x09S"],"o"=>[0,"\x09T"],"p"=>[0,"\x09U"],"q"=>[0,"\x09V"],"r"=>[0,"\x09W"],"s"=>[0,"\x09Y"],"t"=>[0,"\x09j"],"u"=>[0,"\x09k"],"v"=>[0,"\x09q"],"w"=>[0,"\x09v"],"x"=>[0,"\x09w"],"y"=>[0,"\x09x"],"z"=>[0,"\x09y"],"\x7B"=>[0,"\x09z"],"\x7C"=>[82,"\x09"],"\x7D"=>[87,"\x09"],"~"=>[130,"\x09"],"\x7F"=>[9,"\x09"],"\x80"=>[94,"\x8E0"],"\x81"=>[76,"\x8E0"],"\x82"=>[104,"\x8E0"],"\x83"=>[16,"\x8E0"],"\x84"=>[94,"\x8E1"],"\x85"=>[76,"\x8E1"],"\x86"=>[104,"\x8E1"],"\x87"=>[16,"\x8E1"],"\x88"=>[94,"\x8E2"],"\x89"=>[76,"\x8E2"],"\x8A"=>[104,"\x8E2"],"\x8B"=>[16,"\x8E2"],"\x8C"=>[94,"\x8Ea"],"\x8D"=>[76,"\x8Ea"],"\x8E"=>[104,"\x8Ea"],"\x8F"=>[16,"\x8Ea"],"\x90"=>[94,"\x8Ec"],"\x91"=>[76,"\x8Ec"],"\x92"=>[104,"\x8Ec"],"\x93"=>[16,"\x8Ec"],"\x94"=>[94,"\x8Ee"],"\x95"=>[76,"\x8Ee"],"\x96"=>[104,"\x8Ee"],"\x97"=>[16,"\x8Ee"],"\x98"=>[94,"\x8Ei"],"\x99"=>[76,"\x8Ei"],"\x9A"=>[104,"\x8Ei"],"\x9B"=>[16,"\x8Ei"],"\x9C"=>[94,"\x8Eo"],"\x9D"=>[76,"\x8Eo"],"\x9E"=>[104,"\x8Eo"],"\x9F"=>[16,"\x8Eo"],"\xA0"=>[94,"\x8Es"],"\xA1"=>[76,"\x8Es"],"\xA2"=>[104,"\x8Es"],"\xA3"=>[16,"\x8Es"],"\xA4"=>[94,"\x8Et"],"\xA5"=>[76,"\x8Et"],"\xA6"=>[104,"\x8Et"],"\xA7"=>[16,"\x8Et"],"\xA8"=>[77,"\x8E\x20"],"\xA9"=>[18,"\x8E\x20"],"\xAA"=>[77,"\x8E\x25"],"\xAB"=>[18,"\x8E\x25"],"\xAC"=>[77,"\x8E-"],"\xAD"=>[18,"\x8E-"],"\xAE"=>[77,"\x8E."],"\xAF"=>[18,"\x8E."],"\xB0"=>[77,"\x8E\x2F"],"\xB1"=>[18,"\x8E\x2F"],"\xB2"=>[77,"\x8E3"],"\xB3"=>[18,"\x8E3"],"\xB4"=>[77,"\x8E4"],"\xB5"=>[18,"\x8E4"],"\xB6"=>[77,"\x8E5"],"\xB7"=>[18,"\x8E5"],"\xB8"=>[77,"\x8E6"],"\xB9"=>[18,"\x8E6"],"\xBA"=>[77,"\x8E7"],"\xBB"=>[18,"\x8E7"],"\xBC"=>[77,"\x8E8"],"\xBD"=>[18,"\x8E8"],"\xBE"=>[77,"\x8E9"],"\xBF"=>[18,"\x8E9"],"\xC0"=>[77,"\x8E\x3D"],"\xC1"=>[18,"\x8E\x3D"],"\xC2"=>[77,"\x8EA"],"\xC3"=>[18,"\x8EA"],"\xC4"=>[77,"\x8E_"],"\xC5"=>[18,"\x8E_"],"\xC6"=>[77,"\x8Eb"],"\xC7"=>[18,"\x8Eb"],"\xC8"=>[77,"\x8Ed"],"\xC9"=>[18,"\x8Ed"],"\xCA"=>[77,"\x8Ef"],"\xCB"=>[18,"\x8Ef"],"\xCC"=>[77,"\x8Eg"],"\xCD"=>[18,"\x8Eg"],"\xCE"=>[77,"\x8Eh"],"\xCF"=>[18,"\x8Eh"],"\xD0"=>[77,"\x8El"],"\xD1"=>[18,"\x8El"],"\xD2"=>[77,"\x8Em"],"\xD3"=>[18,"\x8Em"],"\xD4"=>[77,"\x8En"],"\xD5"=>[18,"\x8En"],"\xD6"=>[77,"\x8Ep"],"\xD7"=>[18,"\x8Ep"],"\xD8"=>[77,"\x8Er"],"\xD9"=>[18,"\x8Er"],"\xDA"=>[77,"\x8Eu"],"\xDB"=>[18,"\x8Eu"],"\xDC"=>[0,"\x8E\x3A"],"\xDD"=>[0,"\x8EB"],"\xDE"=>[0,"\x8EC"],"\xDF"=>[0,"\x8ED"],"\xE0"=>[0,"\x8EE"],"\xE1"=>[0,"\x8EF"],"\xE2"=>[0,"\x8EG"],"\xE3"=>[0,"\x8EH"],"\xE4"=>[0,"\x8EI"],"\xE5"=>[0,"\x8EJ"],"\xE6"=>[0,"\x8EK"],"\xE7"=>[0,"\x8EL"],"\xE8"=>[0,"\x8EM"],"\xE9"=>[0,"\x8EN"],"\xEA"=>[0,"\x8EO"],"\xEB"=>[0,"\x8EP"],"\xEC"=>[0,"\x8EQ"],"\xED"=>[0,"\x8ER"],"\xEE"=>[0,"\x8ES"],"\xEF"=>[0,"\x8ET"],"\xF0"=>[0,"\x8EU"],"\xF1"=>[0,"\x8EV"],"\xF2"=>[0,"\x8EW"],"\xF3"=>[0,"\x8EY"],"\xF4"=>[0,"\x8Ej"],"\xF5"=>[0,"\x8Ek"],"\xF6"=>[0,"\x8Eq"],"\xF7"=>[0,"\x8Ev"],"\xF8"=>[0,"\x8Ew"],"\xF9"=>[0,"\x8Ex"],"\xFA"=>[0,"\x8Ey"],"\xFB"=>[0,"\x8Ez"],"\xFC"=>[82,"\x8E"],"\xFD"=>[87,"\x8E"],"\xFE"=>[130,"\x8E"],"\xFF"=>[9,"\x8E"],],["\x00"=>[94,"\xEF0"],"\x01"=>[76,"\xEF0"],"\x02"=>[104,"\xEF0"],"\x03"=>[16,"\xEF0"],"\x04"=>[94,"\xEF1"],"\x05"=>[76,"\xEF1"],"\x06"=>[104,"\xEF1"],"\x07"=>[16,"\xEF1"],"\x08"=>[94,"\xEF2"],"\x09"=>[76,"\xEF2"],"\x0A"=>[104,"\xEF2"],"\x0B"=>[16,"\xEF2"],"\x0C"=>[94,"\xEFa"],"\x0D"=>[76,"\xEFa"],"\x0E"=>[104,"\xEFa"],"\x0F"=>[16,"\xEFa"],"\x10"=>[94,"\xEFc"],"\x11"=>[76,"\xEFc"],"\x12"=>[104,"\xEFc"],"\x13"=>[16,"\xEFc"],"\x14"=>[94,"\xEFe"],"\x15"=>[76,"\xEFe"],"\x16"=>[104,"\xEFe"],"\x17"=>[16,"\xEFe"],"\x18"=>[94,"\xEFi"],"\x19"=>[76,"\xEFi"],"\x1A"=>[104,"\xEFi"],"\x1B"=>[16,"\xEFi"],"\x1C"=>[94,"\xEFo"],"\x1D"=>[76,"\xEFo"],"\x1E"=>[104,"\xEFo"],"\x1F"=>[16,"\xEFo"],"\x20"=>[94,"\xEFs"],"\x21"=>[76,"\xEFs"],"\x22"=>[104,"\xEFs"],"\x23"=>[16,"\xEFs"],"\x24"=>[94,"\xEFt"],"\x25"=>[76,"\xEFt"],"\x26"=>[104,"\xEFt"],"\x27"=>[16,"\xEFt"],"\x28"=>[77,"\xEF\x20"],"\x29"=>[18,"\xEF\x20"],"\x2A"=>[77,"\xEF\x25"],"\x2B"=>[18,"\xEF\x25"],"\x2C"=>[77,"\xEF-"],"-"=>[18,"\xEF-"],"."=>[77,"\xEF."],"\x2F"=>[18,"\xEF."],[77,"\xEF\x2F"],[18,"\xEF\x2F"],[77,"\xEF3"],[18,"\xEF3"],[77,"\xEF4"],[18,"\xEF4"],[77,"\xEF5"],[18,"\xEF5"],[77,"\xEF6"],[18,"\xEF6"],"\x3A"=>[77,"\xEF7"],"\x3B"=>[18,"\xEF7"],"\x3C"=>[77,"\xEF8"],"\x3D"=>[18,"\xEF8"],"\x3E"=>[77,"\xEF9"],"\x3F"=>[18,"\xEF9"],"\x40"=>[77,"\xEF\x3D"],"A"=>[18,"\xEF\x3D"],"B"=>[77,"\xEFA"],"C"=>[18,"\xEFA"],"D"=>[77,"\xEF_"],"E"=>[18,"\xEF_"],"F"=>[77,"\xEFb"],"G"=>[18,"\xEFb"],"H"=>[77,"\xEFd"],"I"=>[18,"\xEFd"],"J"=>[77,"\xEFf"],"K"=>[18,"\xEFf"],"L"=>[77,"\xEFg"],"M"=>[18,"\xEFg"],"N"=>[77,"\xEFh"],"O"=>[18,"\xEFh"],"P"=>[77,"\xEFl"],"Q"=>[18,"\xEFl"],"R"=>[77,"\xEFm"],"S"=>[18,"\xEFm"],"T"=>[77,"\xEFn"],"U"=>[18,"\xEFn"],"V"=>[77,"\xEFp"],"W"=>[18,"\xEFp"],"X"=>[77,"\xEFr"],"Y"=>[18,"\xEFr"],"Z"=>[77,"\xEFu"],"\x5B"=>[18,"\xEFu"],"\x5C"=>[0,"\xEF\x3A"],"\x5D"=>[0,"\xEFB"],"\x5E"=>[0,"\xEFC"],"_"=>[0,"\xEFD"],"\x60"=>[0,"\xEFE"],"a"=>[0,"\xEFF"],"b"=>[0,"\xEFG"],"c"=>[0,"\xEFH"],"d"=>[0,"\xEFI"],"e"=>[0,"\xEFJ"],"f"=>[0,"\xEFK"],"g"=>[0,"\xEFL"],"h"=>[0,"\xEFM"],"i"=>[0,"\xEFN"],"j"=>[0,"\xEFO"],"k"=>[0,"\xEFP"],"l"=>[0,"\xEFQ"],"m"=>[0,"\xEFR"],"n"=>[0,"\xEFS"],"o"=>[0,"\xEFT"],"p"=>[0,"\xEFU"],"q"=>[0,"\xEFV"],"r"=>[0,"\xEFW"],"s"=>[0,"\xEFY"],"t"=>[0,"\xEFj"],"u"=>[0,"\xEFk"],"v"=>[0,"\xEFq"],"w"=>[0,"\xEFv"],"x"=>[0,"\xEFw"],"y"=>[0,"\xEFx"],"z"=>[0,"\xEFy"],"\x7B"=>[0,"\xEFz"],"\x7C"=>[82,"\xEF"],"\x7D"=>[87,"\xEF"],"~"=>[130,"\xEF"],"\x7F"=>[9,"\xEF"],"\x80"=>[77,"\x090"],"\x81"=>[18,"\x090"],"\x82"=>[77,"\x091"],"\x83"=>[18,"\x091"],"\x84"=>[77,"\x092"],"\x85"=>[18,"\x092"],"\x86"=>[77,"\x09a"],"\x87"=>[18,"\x09a"],"\x88"=>[77,"\x09c"],"\x89"=>[18,"\x09c"],"\x8A"=>[77,"\x09e"],"\x8B"=>[18,"\x09e"],"\x8C"=>[77,"\x09i"],"\x8D"=>[18,"\x09i"],"\x8E"=>[77,"\x09o"],"\x8F"=>[18,"\x09o"],"\x90"=>[77,"\x09s"],"\x91"=>[18,"\x09s"],"\x92"=>[77,"\x09t"],"\x93"=>[18,"\x09t"],"\x94"=>[0,"\x09\x20"],"\x95"=>[0,"\x09\x25"],"\x96"=>[0,"\x09-"],"\x97"=>[0,"\x09."],"\x98"=>[0,"\x09\x2F"],"\x99"=>[0,"\x093"],"\x9A"=>[0,"\x094"],"\x9B"=>[0,"\x095"],"\x9C"=>[0,"\x096"],"\x9D"=>[0,"\x097"],"\x9E"=>[0,"\x098"],"\x9F"=>[0,"\x099"],"\xA0"=>[0,"\x09\x3D"],"\xA1"=>[0,"\x09A"],"\xA2"=>[0,"\x09_"],"\xA3"=>[0,"\x09b"],"\xA4"=>[0,"\x09d"],"\xA5"=>[0,"\x09f"],"\xA6"=>[0,"\x09g"],"\xA7"=>[0,"\x09h"],"\xA8"=>[0,"\x09l"],"\xA9"=>[0,"\x09m"],"\xAA"=>[0,"\x09n"],"\xAB"=>[0,"\x09p"],"\xAC"=>[0,"\x09r"],"\xAD"=>[0,"\x09u"],"\xAE"=>[100,"\x09"],"\xAF"=>[110,"\x09"],"\xB0"=>[111,"\x09"],"\xB1"=>[115,"\x09"],"\xB2"=>[116,"\x09"],"\xB3"=>[118,"\x09"],"\xB4"=>[119,"\x09"],"\xB5"=>[122,"\x09"],"\xB6"=>[123,"\x09"],"\xB7"=>[125,"\x09"],"\xB8"=>[126,"\x09"],"\xB9"=>[129,"\x09"],"\xBA"=>[143,"\x09"],"\xBB"=>[148,"\x09"],"\xBC"=>[151,"\x09"],"\xBD"=>[153,"\x09"],"\xBE"=>[83,"\x09"],"\xBF"=>[10,"\x09"],"\xC0"=>[77,"\x8E0"],"\xC1"=>[18,"\x8E0"],"\xC2"=>[77,"\x8E1"],"\xC3"=>[18,"\x8E1"],"\xC4"=>[77,"\x8E2"],"\xC5"=>[18,"\x8E2"],"\xC6"=>[77,"\x8Ea"],"\xC7"=>[18,"\x8Ea"],"\xC8"=>[77,"\x8Ec"],"\xC9"=>[18,"\x8Ec"],"\xCA"=>[77,"\x8Ee"],"\xCB"=>[18,"\x8Ee"],"\xCC"=>[77,"\x8Ei"],"\xCD"=>[18,"\x8Ei"],"\xCE"=>[77,"\x8Eo"],"\xCF"=>[18,"\x8Eo"],"\xD0"=>[77,"\x8Es"],"\xD1"=>[18,"\x8Es"],"\xD2"=>[77,"\x8Et"],"\xD3"=>[18,"\x8Et"],"\xD4"=>[0,"\x8E\x20"],"\xD5"=>[0,"\x8E\x25"],"\xD6"=>[0,"\x8E-"],"\xD7"=>[0,"\x8E."],"\xD8"=>[0,"\x8E\x2F"],"\xD9"=>[0,"\x8E3"],"\xDA"=>[0,"\x8E4"],"\xDB"=>[0,"\x8E5"],"\xDC"=>[0,"\x8E6"],"\xDD"=>[0,"\x8E7"],"\xDE"=>[0,"\x8E8"],"\xDF"=>[0,"\x8E9"],"\xE0"=>[0,"\x8E\x3D"],"\xE1"=>[0,"\x8EA"],"\xE2"=>[0,"\x8E_"],"\xE3"=>[0,"\x8Eb"],"\xE4"=>[0,"\x8Ed"],"\xE5"=>[0,"\x8Ef"],"\xE6"=>[0,"\x8Eg"],"\xE7"=>[0,"\x8Eh"],"\xE8"=>[0,"\x8El"],"\xE9"=>[0,"\x8Em"],"\xEA"=>[0,"\x8En"],"\xEB"=>[0,"\x8Ep"],"\xEC"=>[0,"\x8Er"],"\xED"=>[0,"\x8Eu"],"\xEE"=>[100,"\x8E"],"\xEF"=>[110,"\x8E"],"\xF0"=>[111,"\x8E"],"\xF1"=>[115,"\x8E"],"\xF2"=>[116,"\x8E"],"\xF3"=>[118,"\x8E"],"\xF4"=>[119,"\x8E"],"\xF5"=>[122,"\x8E"],"\xF6"=>[123,"\x8E"],"\xF7"=>[125,"\x8E"],"\xF8"=>[126,"\x8E"],"\xF9"=>[129,"\x8E"],"\xFA"=>[143,"\x8E"],"\xFB"=>[148,"\x8E"],"\xFC"=>[151,"\x8E"],"\xFD"=>[153,"\x8E"],"\xFE"=>[83,"\x8E"],"\xFF"=>[10,"\x8E"],],["\x00"=>[77,"\xEF0"],"\x01"=>[18,"\xEF0"],"\x02"=>[77,"\xEF1"],"\x03"=>[18,"\xEF1"],"\x04"=>[77,"\xEF2"],"\x05"=>[18,"\xEF2"],"\x06"=>[77,"\xEFa"],"\x07"=>[18,"\xEFa"],"\x08"=>[77,"\xEFc"],"\x09"=>[18,"\xEFc"],"\x0A"=>[77,"\xEFe"],"\x0B"=>[18,"\xEFe"],"\x0C"=>[77,"\xEFi"],"\x0D"=>[18,"\xEFi"],"\x0E"=>[77,"\xEFo"],"\x0F"=>[18,"\xEFo"],"\x10"=>[77,"\xEFs"],"\x11"=>[18,"\xEFs"],"\x12"=>[77,"\xEFt"],"\x13"=>[18,"\xEFt"],"\x14"=>[0,"\xEF\x20"],"\x15"=>[0,"\xEF\x25"],"\x16"=>[0,"\xEF-"],"\x17"=>[0,"\xEF."],"\x18"=>[0,"\xEF\x2F"],"\x19"=>[0,"\xEF3"],"\x1A"=>[0,"\xEF4"],"\x1B"=>[0,"\xEF5"],"\x1C"=>[0,"\xEF6"],"\x1D"=>[0,"\xEF7"],"\x1E"=>[0,"\xEF8"],"\x1F"=>[0,"\xEF9"],"\x20"=>[0,"\xEF\x3D"],"\x21"=>[0,"\xEFA"],"\x22"=>[0,"\xEF_"],"\x23"=>[0,"\xEFb"],"\x24"=>[0,"\xEFd"],"\x25"=>[0,"\xEFf"],"\x26"=>[0,"\xEFg"],"\x27"=>[0,"\xEFh"],"\x28"=>[0,"\xEFl"],"\x29"=>[0,"\xEFm"],"\x2A"=>[0,"\xEFn"],"\x2B"=>[0,"\xEFp"],"\x2C"=>[0,"\xEFr"],"-"=>[0,"\xEFu"],"."=>[100,"\xEF"],"\x2F"=>[110,"\xEF"],[111,"\xEF"],[115,"\xEF"],[116,"\xEF"],[118,"\xEF"],[119,"\xEF"],[122,"\xEF"],[123,"\xEF"],[125,"\xEF"],[126,"\xEF"],[129,"\xEF"],"\x3A"=>[143,"\xEF"],"\x3B"=>[148,"\xEF"],"\x3C"=>[151,"\xEF"],"\x3D"=>[153,"\xEF"],"\x3E"=>[83,"\xEF"],"\x3F"=>[10,"\xEF"],"\x40"=>[0,"\x090"],"A"=>[0,"\x091"],"B"=>[0,"\x092"],"C"=>[0,"\x09a"],"D"=>[0,"\x09c"],"E"=>[0,"\x09e"],"F"=>[0,"\x09i"],"G"=>[0,"\x09o"],"H"=>[0,"\x09s"],"I"=>[0,"\x09t"],"J"=>[73,"\x09"],"K"=>[88,"\x09"],"L"=>[89,"\x09"],"M"=>[96,"\x09"],"N"=>[97,"\x09"],"O"=>[99,"\x09"],"P"=>[106,"\x09"],"Q"=>[136,"\x09"],"R"=>[139,"\x09"],"S"=>[141,"\x09"],"T"=>[145,"\x09"],"U"=>[147,"\x09"],"V"=>[149,"\x09"],"W"=>[101,"\x09"],"X"=>[112,"\x09"],"Y"=>[117,"\x09"],"Z"=>[120,"\x09"],"\x5B"=>[124,"\x09"],"\x5C"=>[127,"\x09"],"\x5D"=>[144,"\x09"],"\x5E"=>[152,"\x09"],"_"=>[11,"\x09"],"\x60"=>[0,"\x8E0"],"a"=>[0,"\x8E1"],"b"=>[0,"\x8E2"],"c"=>[0,"\x8Ea"],"d"=>[0,"\x8Ec"],"e"=>[0,"\x8Ee"],"f"=>[0,"\x8Ei"],"g"=>[0,"\x8Eo"],"h"=>[0,"\x8Es"],"i"=>[0,"\x8Et"],"j"=>[73,"\x8E"],"k"=>[88,"\x8E"],"l"=>[89,"\x8E"],"m"=>[96,"\x8E"],"n"=>[97,"\x8E"],"o"=>[99,"\x8E"],"p"=>[106,"\x8E"],"q"=>[136,"\x8E"],"r"=>[139,"\x8E"],"s"=>[141,"\x8E"],"t"=>[145,"\x8E"],"u"=>[147,"\x8E"],"v"=>[149,"\x8E"],"w"=>[101,"\x8E"],"x"=>[112,"\x8E"],"y"=>[117,"\x8E"],"z"=>[120,"\x8E"],"\x7B"=>[124,"\x8E"],"\x7C"=>[127,"\x8E"],"\x7D"=>[144,"\x8E"],"~"=>[152,"\x8E"],"\x7F"=>[11,"\x8E"],"\x80"=>[0,"\x900"],"\x81"=>[0,"\x901"],"\x82"=>[0,"\x902"],"\x83"=>[0,"\x90a"],"\x84"=>[0,"\x90c"],"\x85"=>[0,"\x90e"],"\x86"=>[0,"\x90i"],"\x87"=>[0,"\x90o"],"\x88"=>[0,"\x90s"],"\x89"=>[0,"\x90t"],"\x8A"=>[73,"\x90"],"\x8B"=>[88,"\x90"],"\x8C"=>[89,"\x90"],"\x8D"=>[96,"\x90"],"\x8E"=>[97,"\x90"],"\x8F"=>[99,"\x90"],"\x90"=>[106,"\x90"],"\x91"=>[136,"\x90"],"\x92"=>[139,"\x90"],"\x93"=>[141,"\x90"],"\x94"=>[145,"\x90"],"\x95"=>[147,"\x90"],"\x96"=>[149,"\x90"],"\x97"=>[101,"\x90"],"\x98"=>[112,"\x90"],"\x99"=>[117,"\x90"],"\x9A"=>[120,"\x90"],"\x9B"=>[124,"\x90"],"\x9C"=>[127,"\x90"],"\x9D"=>[144,"\x90"],"\x9E"=>[152,"\x90"],"\x9F"=>[11,"\x90"],"\xA0"=>[0,"\x910"],"\xA1"=>[0,"\x911"],"\xA2"=>[0,"\x912"],"\xA3"=>[0,"\x91a"],"\xA4"=>[0,"\x91c"],"\xA5"=>[0,"\x91e"],"\xA6"=>[0,"\x91i"],"\xA7"=>[0,"\x91o"],"\xA8"=>[0,"\x91s"],"\xA9"=>[0,"\x91t"],"\xAA"=>[73,"\x91"],"\xAB"=>[88,"\x91"],"\xAC"=>[89,"\x91"],"\xAD"=>[96,"\x91"],"\xAE"=>[97,"\x91"],"\xAF"=>[99,"\x91"],"\xB0"=>[106,"\x91"],"\xB1"=>[136,"\x91"],"\xB2"=>[139,"\x91"],"\xB3"=>[141,"\x91"],"\xB4"=>[145,"\x91"],"\xB5"=>[147,"\x91"],"\xB6"=>[149,"\x91"],"\xB7"=>[101,"\x91"],"\xB8"=>[112,"\x91"],"\xB9"=>[117,"\x91"],"\xBA"=>[120,"\x91"],"\xBB"=>[124,"\x91"],"\xBC"=>[127,"\x91"],"\xBD"=>[144,"\x91"],"\xBE"=>[152,"\x91"],"\xBF"=>[11,"\x91"],"\xC0"=>[0,"\x940"],"\xC1"=>[0,"\x941"],"\xC2"=>[0,"\x942"],"\xC3"=>[0,"\x94a"],"\xC4"=>[0,"\x94c"],"\xC5"=>[0,"\x94e"],"\xC6"=>[0,"\x94i"],"\xC7"=>[0,"\x94o"],"\xC8"=>[0,"\x94s"],"\xC9"=>[0,"\x94t"],"\xCA"=>[73,"\x94"],"\xCB"=>[88,"\x94"],"\xCC"=>[89,"\x94"],"\xCD"=>[96,"\x94"],"\xCE"=>[97,"\x94"],"\xCF"=>[99,"\x94"],"\xD0"=>[106,"\x94"],"\xD1"=>[136,"\x94"],"\xD2"=>[139,"\x94"],"\xD3"=>[141,"\x94"],"\xD4"=>[145,"\x94"],"\xD5"=>[147,"\x94"],"\xD6"=>[149,"\x94"],"\xD7"=>[101,"\x94"],"\xD8"=>[112,"\x94"],"\xD9"=>[117,"\x94"],"\xDA"=>[120,"\x94"],"\xDB"=>[124,"\x94"],"\xDC"=>[127,"\x94"],"\xDD"=>[144,"\x94"],"\xDE"=>[152,"\x94"],"\xDF"=>[11,"\x94"],"\xE0"=>[0,"\x9F0"],"\xE1"=>[0,"\x9F1"],"\xE2"=>[0,"\x9F2"],"\xE3"=>[0,"\x9Fa"],"\xE4"=>[0,"\x9Fc"],"\xE5"=>[0,"\x9Fe"],"\xE6"=>[0,"\x9Fi"],"\xE7"=>[0,"\x9Fo"],"\xE8"=>[0,"\x9Fs"],"\xE9"=>[0,"\x9Ft"],"\xEA"=>[73,"\x9F"],"\xEB"=>[88,"\x9F"],"\xEC"=>[89,"\x9F"],"\xED"=>[96,"\x9F"],"\xEE"=>[97,"\x9F"],"\xEF"=>[99,"\x9F"],"\xF0"=>[106,"\x9F"],"\xF1"=>[136,"\x9F"],"\xF2"=>[139,"\x9F"],"\xF3"=>[141,"\x9F"],"\xF4"=>[145,"\x9F"],"\xF5"=>[147,"\x9F"],"\xF6"=>[149,"\x9F"],"\xF7"=>[101,"\x9F"],"\xF8"=>[112,"\x9F"],"\xF9"=>[117,"\x9F"],"\xFA"=>[120,"\x9F"],"\xFB"=>[124,"\x9F"],"\xFC"=>[127,"\x9F"],"\xFD"=>[144,"\x9F"],"\xFE"=>[152,"\x9F"],"\xFF"=>[11,"\x9F"],],["\x00"=>[0,"\xBC0"],"\x01"=>[0,"\xBC1"],"\x02"=>[0,"\xBC2"],"\x03"=>[0,"\xBCa"],"\x04"=>[0,"\xBCc"],"\x05"=>[0,"\xBCe"],"\x06"=>[0,"\xBCi"],"\x07"=>[0,"\xBCo"],"\x08"=>[0,"\xBCs"],"\x09"=>[0,"\xBCt"],"\x0A"=>[73,"\xBC"],"\x0B"=>[88,"\xBC"],"\x0C"=>[89,"\xBC"],"\x0D"=>[96,"\xBC"],"\x0E"=>[97,"\xBC"],"\x0F"=>[99,"\xBC"],"\x10"=>[106,"\xBC"],"\x11"=>[136,"\xBC"],"\x12"=>[139,"\xBC"],"\x13"=>[141,"\xBC"],"\x14"=>[145,"\xBC"],"\x15"=>[147,"\xBC"],"\x16"=>[149,"\xBC"],"\x17"=>[101,"\xBC"],"\x18"=>[112,"\xBC"],"\x19"=>[117,"\xBC"],"\x1A"=>[120,"\xBC"],"\x1B"=>[124,"\xBC"],"\x1C"=>[127,"\xBC"],"\x1D"=>[144,"\xBC"],"\x1E"=>[152,"\xBC"],"\x1F"=>[11,"\xBC"],"\x20"=>[0,"\xBF0"],"\x21"=>[0,"\xBF1"],"\x22"=>[0,"\xBF2"],"\x23"=>[0,"\xBFa"],"\x24"=>[0,"\xBFc"],"\x25"=>[0,"\xBFe"],"\x26"=>[0,"\xBFi"],"\x27"=>[0,"\xBFo"],"\x28"=>[0,"\xBFs"],"\x29"=>[0,"\xBFt"],"\x2A"=>[73,"\xBF"],"\x2B"=>[88,"\xBF"],"\x2C"=>[89,"\xBF"],"-"=>[96,"\xBF"],"."=>[97,"\xBF"],"\x2F"=>[99,"\xBF"],[106,"\xBF"],[136,"\xBF"],[139,"\xBF"],[141,"\xBF"],[145,"\xBF"],[147,"\xBF"],[149,"\xBF"],[101,"\xBF"],[112,"\xBF"],[117,"\xBF"],"\x3A"=>[120,"\xBF"],"\x3B"=>[124,"\xBF"],"\x3C"=>[127,"\xBF"],"\x3D"=>[144,"\xBF"],"\x3E"=>[152,"\xBF"],"\x3F"=>[11,"\xBF"],"\x40"=>[0,"\xC50"],"A"=>[0,"\xC51"],"B"=>[0,"\xC52"],"C"=>[0,"\xC5a"],"D"=>[0,"\xC5c"],"E"=>[0,"\xC5e"],"F"=>[0,"\xC5i"],"G"=>[0,"\xC5o"],"H"=>[0,"\xC5s"],"I"=>[0,"\xC5t"],"J"=>[73,"\xC5"],"K"=>[88,"\xC5"],"L"=>[89,"\xC5"],"M"=>[96,"\xC5"],"N"=>[97,"\xC5"],"O"=>[99,"\xC5"],"P"=>[106,"\xC5"],"Q"=>[136,"\xC5"],"R"=>[139,"\xC5"],"S"=>[141,"\xC5"],"T"=>[145,"\xC5"],"U"=>[147,"\xC5"],"V"=>[149,"\xC5"],"W"=>[101,"\xC5"],"X"=>[112,"\xC5"],"Y"=>[117,"\xC5"],"Z"=>[120,"\xC5"],"\x5B"=>[124,"\xC5"],"\x5C"=>[127,"\xC5"],"\x5D"=>[144,"\xC5"],"\x5E"=>[152,"\xC5"],"_"=>[11,"\xC5"],"\x60"=>[0,"\xE70"],"a"=>[0,"\xE71"],"b"=>[0,"\xE72"],"c"=>[0,"\xE7a"],"d"=>[0,"\xE7c"],"e"=>[0,"\xE7e"],"f"=>[0,"\xE7i"],"g"=>[0,"\xE7o"],"h"=>[0,"\xE7s"],"i"=>[0,"\xE7t"],"j"=>[73,"\xE7"],"k"=>[88,"\xE7"],"l"=>[89,"\xE7"],"m"=>[96,"\xE7"],"n"=>[97,"\xE7"],"o"=>[99,"\xE7"],"p"=>[106,"\xE7"],"q"=>[136,"\xE7"],"r"=>[139,"\xE7"],"s"=>[141,"\xE7"],"t"=>[145,"\xE7"],"u"=>[147,"\xE7"],"v"=>[149,"\xE7"],"w"=>[101,"\xE7"],"x"=>[112,"\xE7"],"y"=>[117,"\xE7"],"z"=>[120,"\xE7"],"\x7B"=>[124,"\xE7"],"\x7C"=>[127,"\xE7"],"\x7D"=>[144,"\xE7"],"~"=>[152,"\xE7"],"\x7F"=>[11,"\xE7"],"\x80"=>[0,"\xEF0"],"\x81"=>[0,"\xEF1"],"\x82"=>[0,"\xEF2"],"\x83"=>[0,"\xEFa"],"\x84"=>[0,"\xEFc"],"\x85"=>[0,"\xEFe"],"\x86"=>[0,"\xEFi"],"\x87"=>[0,"\xEFo"],"\x88"=>[0,"\xEFs"],"\x89"=>[0,"\xEFt"],"\x8A"=>[73,"\xEF"],"\x8B"=>[88,"\xEF"],"\x8C"=>[89,"\xEF"],"\x8D"=>[96,"\xEF"],"\x8E"=>[97,"\xEF"],"\x8F"=>[99,"\xEF"],"\x90"=>[106,"\xEF"],"\x91"=>[136,"\xEF"],"\x92"=>[139,"\xEF"],"\x93"=>[141,"\xEF"],"\x94"=>[145,"\xEF"],"\x95"=>[147,"\xEF"],"\x96"=>[149,"\xEF"],"\x97"=>[101,"\xEF"],"\x98"=>[112,"\xEF"],"\x99"=>[117,"\xEF"],"\x9A"=>[120,"\xEF"],"\x9B"=>[124,"\xEF"],"\x9C"=>[127,"\xEF"],"\x9D"=>[144,"\xEF"],"\x9E"=>[152,"\xEF"],"\x9F"=>[11,"\xEF"],"\xA0"=>[92,"\x09"],"\xA1"=>[95,"\x09"],"\xA2"=>[137,"\x09"],"\xA3"=>[142,"\x09"],"\xA4"=>[150,"\x09"],"\xA5"=>[74,"\x09"],"\xA6"=>[90,"\x09"],"\xA7"=>[98,"\x09"],"\xA8"=>[107,"\x09"],"\xA9"=>[140,"\x09"],"\xAA"=>[146,"\x09"],"\xAB"=>[102,"\x09"],"\xAC"=>[113,"\x09"],"\xAD"=>[121,"\x09"],"\xAE"=>[128,"\x09"],"\xAF"=>[12,"\x09"],"\xB0"=>[92,"\x8E"],"\xB1"=>[95,"\x8E"],"\xB2"=>[137,"\x8E"],"\xB3"=>[142,"\x8E"],"\xB4"=>[150,"\x8E"],"\xB5"=>[74,"\x8E"],"\xB6"=>[90,"\x8E"],"\xB7"=>[98,"\x8E"],"\xB8"=>[107,"\x8E"],"\xB9"=>[140,"\x8E"],"\xBA"=>[146,"\x8E"],"\xBB"=>[102,"\x8E"],"\xBC"=>[113,"\x8E"],"\xBD"=>[121,"\x8E"],"\xBE"=>[128,"\x8E"],"\xBF"=>[12,"\x8E"],"\xC0"=>[92,"\x90"],"\xC1"=>[95,"\x90"],"\xC2"=>[137,"\x90"],"\xC3"=>[142,"\x90"],"\xC4"=>[150,"\x90"],"\xC5"=>[74,"\x90"],"\xC6"=>[90,"\x90"],"\xC7"=>[98,"\x90"],"\xC8"=>[107,"\x90"],"\xC9"=>[140,"\x90"],"\xCA"=>[146,"\x90"],"\xCB"=>[102,"\x90"],"\xCC"=>[113,"\x90"],"\xCD"=>[121,"\x90"],"\xCE"=>[128,"\x90"],"\xCF"=>[12,"\x90"],"\xD0"=>[92,"\x91"],"\xD1"=>[95,"\x91"],"\xD2"=>[137,"\x91"],"\xD3"=>[142,"\x91"],"\xD4"=>[150,"\x91"],"\xD5"=>[74,"\x91"],"\xD6"=>[90,"\x91"],"\xD7"=>[98,"\x91"],"\xD8"=>[107,"\x91"],"\xD9"=>[140,"\x91"],"\xDA"=>[146,"\x91"],"\xDB"=>[102,"\x91"],"\xDC"=>[113,"\x91"],"\xDD"=>[121,"\x91"],"\xDE"=>[128,"\x91"],"\xDF"=>[12,"\x91"],"\xE0"=>[92,"\x94"],"\xE1"=>[95,"\x94"],"\xE2"=>[137,"\x94"],"\xE3"=>[142,"\x94"],"\xE4"=>[150,"\x94"],"\xE5"=>[74,"\x94"],"\xE6"=>[90,"\x94"],"\xE7"=>[98,"\x94"],"\xE8"=>[107,"\x94"],"\xE9"=>[140,"\x94"],"\xEA"=>[146,"\x94"],"\xEB"=>[102,"\x94"],"\xEC"=>[113,"\x94"],"\xED"=>[121,"\x94"],"\xEE"=>[128,"\x94"],"\xEF"=>[12,"\x94"],"\xF0"=>[92,"\x9F"],"\xF1"=>[95,"\x9F"],"\xF2"=>[137,"\x9F"],"\xF3"=>[142,"\x9F"],"\xF4"=>[150,"\x9F"],"\xF5"=>[74,"\x9F"],"\xF6"=>[90,"\x9F"],"\xF7"=>[98,"\x9F"],"\xF8"=>[107,"\x9F"],"\xF9"=>[140,"\x9F"],"\xFA"=>[146,"\x9F"],"\xFB"=>[102,"\x9F"],"\xFC"=>[113,"\x9F"],"\xFD"=>[121,"\x9F"],"\xFE"=>[128,"\x9F"],"\xFF"=>[12,"\x9F"],],["\x00"=>[92,"\x13"],"\x01"=>[95,"\x13"],"\x02"=>[137,"\x13"],"\x03"=>[142,"\x13"],"\x04"=>[150,"\x13"],"\x05"=>[74,"\x13"],"\x06"=>[90,"\x13"],"\x07"=>[98,"\x13"],"\x08"=>[107,"\x13"],"\x09"=>[140,"\x13"],"\x0A"=>[146,"\x13"],"\x0B"=>[102,"\x13"],"\x0C"=>[113,"\x13"],"\x0D"=>[121,"\x13"],"\x0E"=>[128,"\x13"],"\x0F"=>[12,"\x13"],"\x10"=>[92,"\x14"],"\x11"=>[95,"\x14"],"\x12"=>[137,"\x14"],"\x13"=>[142,"\x14"],"\x14"=>[150,"\x14"],"\x15"=>[74,"\x14"],"\x16"=>[90,"\x14"],"\x17"=>[98,"\x14"],"\x18"=>[107,"\x14"],"\x19"=>[140,"\x14"],"\x1A"=>[146,"\x14"],"\x1B"=>[102,"\x14"],"\x1C"=>[113,"\x14"],"\x1D"=>[121,"\x14"],"\x1E"=>[128,"\x14"],"\x1F"=>[12,"\x14"],"\x20"=>[92,"\x15"],"\x21"=>[95,"\x15"],"\x22"=>[137,"\x15"],"\x23"=>[142,"\x15"],"\x24"=>[150,"\x15"],"\x25"=>[74,"\x15"],"\x26"=>[90,"\x15"],"\x27"=>[98,"\x15"],"\x28"=>[107,"\x15"],"\x29"=>[140,"\x15"],"\x2A"=>[146,"\x15"],"\x2B"=>[102,"\x15"],"\x2C"=>[113,"\x15"],"-"=>[121,"\x15"],"."=>[128,"\x15"],"\x2F"=>[12,"\x15"],[92,"\x17"],[95,"\x17"],[137,"\x17"],[142,"\x17"],[150,"\x17"],[74,"\x17"],[90,"\x17"],[98,"\x17"],[107,"\x17"],[140,"\x17"],"\x3A"=>[146,"\x17"],"\x3B"=>[102,"\x17"],"\x3C"=>[113,"\x17"],"\x3D"=>[121,"\x17"],"\x3E"=>[128,"\x17"],"\x3F"=>[12,"\x17"],"\x40"=>[92,"\x18"],"A"=>[95,"\x18"],"B"=>[137,"\x18"],"C"=>[142,"\x18"],"D"=>[150,"\x18"],"E"=>[74,"\x18"],"F"=>[90,"\x18"],"G"=>[98,"\x18"],"H"=>[107,"\x18"],"I"=>[140,"\x18"],"J"=>[146,"\x18"],"K"=>[102,"\x18"],"L"=>[113,"\x18"],"M"=>[121,"\x18"],"N"=>[128,"\x18"],"O"=>[12,"\x18"],"P"=>[92,"\x19"],"Q"=>[95,"\x19"],"R"=>[137,"\x19"],"S"=>[142,"\x19"],"T"=>[150,"\x19"],"U"=>[74,"\x19"],"V"=>[90,"\x19"],"W"=>[98,"\x19"],"X"=>[107,"\x19"],"Y"=>[140,"\x19"],"Z"=>[146,"\x19"],"\x5B"=>[102,"\x19"],"\x5C"=>[113,"\x19"],"\x5D"=>[121,"\x19"],"\x5E"=>[128,"\x19"],"_"=>[12,"\x19"],"\x60"=>[92,"\x1A"],"a"=>[95,"\x1A"],"b"=>[137,"\x1A"],"c"=>[142,"\x1A"],"d"=>[150,"\x1A"],"e"=>[74,"\x1A"],"f"=>[90,"\x1A"],"g"=>[98,"\x1A"],"h"=>[107,"\x1A"],"i"=>[140,"\x1A"],"j"=>[146,"\x1A"],"k"=>[102,"\x1A"],"l"=>[113,"\x1A"],"m"=>[121,"\x1A"],"n"=>[128,"\x1A"],"o"=>[12,"\x1A"],"p"=>[92,"\x1B"],"q"=>[95,"\x1B"],"r"=>[137,"\x1B"],"s"=>[142,"\x1B"],"t"=>[150,"\x1B"],"u"=>[74,"\x1B"],"v"=>[90,"\x1B"],"w"=>[98,"\x1B"],"x"=>[107,"\x1B"],"y"=>[140,"\x1B"],"z"=>[146,"\x1B"],"\x7B"=>[102,"\x1B"],"\x7C"=>[113,"\x1B"],"\x7D"=>[121,"\x1B"],"~"=>[128,"\x1B"],"\x7F"=>[12,"\x1B"],"\x80"=>[92,"\x1C"],"\x81"=>[95,"\x1C"],"\x82"=>[137,"\x1C"],"\x83"=>[142,"\x1C"],"\x84"=>[150,"\x1C"],"\x85"=>[74,"\x1C"],"\x86"=>[90,"\x1C"],"\x87"=>[98,"\x1C"],"\x88"=>[107,"\x1C"],"\x89"=>[140,"\x1C"],"\x8A"=>[146,"\x1C"],"\x8B"=>[102,"\x1C"],"\x8C"=>[113,"\x1C"],"\x8D"=>[121,"\x1C"],"\x8E"=>[128,"\x1C"],"\x8F"=>[12,"\x1C"],"\x90"=>[92,"\x1D"],"\x91"=>[95,"\x1D"],"\x92"=>[137,"\x1D"],"\x93"=>[142,"\x1D"],"\x94"=>[150,"\x1D"],"\x95"=>[74,"\x1D"],"\x96"=>[90,"\x1D"],"\x97"=>[98,"\x1D"],"\x98"=>[107,"\x1D"],"\x99"=>[140,"\x1D"],"\x9A"=>[146,"\x1D"],"\x9B"=>[102,"\x1D"],"\x9C"=>[113,"\x1D"],"\x9D"=>[121,"\x1D"],"\x9E"=>[128,"\x1D"],"\x9F"=>[12,"\x1D"],"\xA0"=>[92,"\x1E"],"\xA1"=>[95,"\x1E"],"\xA2"=>[137,"\x1E"],"\xA3"=>[142,"\x1E"],"\xA4"=>[150,"\x1E"],"\xA5"=>[74,"\x1E"],"\xA6"=>[90,"\x1E"],"\xA7"=>[98,"\x1E"],"\xA8"=>[107,"\x1E"],"\xA9"=>[140,"\x1E"],"\xAA"=>[146,"\x1E"],"\xAB"=>[102,"\x1E"],"\xAC"=>[113,"\x1E"],"\xAD"=>[121,"\x1E"],"\xAE"=>[128,"\x1E"],"\xAF"=>[12,"\x1E"],"\xB0"=>[92,"\x1F"],"\xB1"=>[95,"\x1F"],"\xB2"=>[137,"\x1F"],"\xB3"=>[142,"\x1F"],"\xB4"=>[150,"\x1F"],"\xB5"=>[74,"\x1F"],"\xB6"=>[90,"\x1F"],"\xB7"=>[98,"\x1F"],"\xB8"=>[107,"\x1F"],"\xB9"=>[140,"\x1F"],"\xBA"=>[146,"\x1F"],"\xBB"=>[102,"\x1F"],"\xBC"=>[113,"\x1F"],"\xBD"=>[121,"\x1F"],"\xBE"=>[128,"\x1F"],"\xBF"=>[12,"\x1F"],"\xC0"=>[92,"\x7F"],"\xC1"=>[95,"\x7F"],"\xC2"=>[137,"\x7F"],"\xC3"=>[142,"\x7F"],"\xC4"=>[150,"\x7F"],"\xC5"=>[74,"\x7F"],"\xC6"=>[90,"\x7F"],"\xC7"=>[98,"\x7F"],"\xC8"=>[107,"\x7F"],"\xC9"=>[140,"\x7F"],"\xCA"=>[146,"\x7F"],"\xCB"=>[102,"\x7F"],"\xCC"=>[113,"\x7F"],"\xCD"=>[121,"\x7F"],"\xCE"=>[128,"\x7F"],"\xCF"=>[12,"\x7F"],"\xD0"=>[92,"\xDC"],"\xD1"=>[95,"\xDC"],"\xD2"=>[137,"\xDC"],"\xD3"=>[142,"\xDC"],"\xD4"=>[150,"\xDC"],"\xD5"=>[74,"\xDC"],"\xD6"=>[90,"\xDC"],"\xD7"=>[98,"\xDC"],"\xD8"=>[107,"\xDC"],"\xD9"=>[140,"\xDC"],"\xDA"=>[146,"\xDC"],"\xDB"=>[102,"\xDC"],"\xDC"=>[113,"\xDC"],"\xDD"=>[121,"\xDC"],"\xDE"=>[128,"\xDC"],"\xDF"=>[12,"\xDC"],"\xE0"=>[92,"\xF9"],"\xE1"=>[95,"\xF9"],"\xE2"=>[137,"\xF9"],"\xE3"=>[142,"\xF9"],"\xE4"=>[150,"\xF9"],"\xE5"=>[74,"\xF9"],"\xE6"=>[90,"\xF9"],"\xE7"=>[98,"\xF9"],"\xE8"=>[107,"\xF9"],"\xE9"=>[140,"\xF9"],"\xEA"=>[146,"\xF9"],"\xEB"=>[102,"\xF9"],"\xEC"=>[113,"\xF9"],"\xED"=>[121,"\xF9"],"\xEE"=>[128,"\xF9"],"\xEF"=>[12,"\xF9"],"\xF0"=>[94,"\x0A"],"\xF1"=>[76,"\x0A"],"\xF2"=>[104,"\x0A"],"\xF3"=>[16,"\x0A"],"\xF4"=>[94,"\x0D"],"\xF5"=>[76,"\x0D"],"\xF6"=>[104,"\x0D"],"\xF7"=>[16,"\x0D"],"\xF8"=>[94,"\x16"],"\xF9"=>[76,"\x16"],"\xFA"=>[104,"\x16"],"\xFB"=>[16,"\x16"],"\xFC"=>[94,""],"\xFD"=>[76,""],"\xFE"=>[104,""],"\xFF"=>[16,""],],["\x00"=>[94,"\x0A0"],"\x01"=>[76,"\x0A0"],"\x02"=>[104,"\x0A0"],"\x03"=>[16,"\x0A0"],"\x04"=>[94,"\x0A1"],"\x05"=>[76,"\x0A1"],"\x06"=>[104,"\x0A1"],"\x07"=>[16,"\x0A1"],"\x08"=>[94,"\x0A2"],"\x09"=>[76,"\x0A2"],"\x0A"=>[104,"\x0A2"],"\x0B"=>[16,"\x0A2"],"\x0C"=>[94,"\x0Aa"],"\x0D"=>[76,"\x0Aa"],"\x0E"=>[104,"\x0Aa"],"\x0F"=>[16,"\x0Aa"],"\x10"=>[94,"\x0Ac"],"\x11"=>[76,"\x0Ac"],"\x12"=>[104,"\x0Ac"],"\x13"=>[16,"\x0Ac"],"\x14"=>[94,"\x0Ae"],"\x15"=>[76,"\x0Ae"],"\x16"=>[104,"\x0Ae"],"\x17"=>[16,"\x0Ae"],"\x18"=>[94,"\x0Ai"],"\x19"=>[76,"\x0Ai"],"\x1A"=>[104,"\x0Ai"],"\x1B"=>[16,"\x0Ai"],"\x1C"=>[94,"\x0Ao"],"\x1D"=>[76,"\x0Ao"],"\x1E"=>[104,"\x0Ao"],"\x1F"=>[16,"\x0Ao"],"\x20"=>[94,"\x0As"],"\x21"=>[76,"\x0As"],"\x22"=>[104,"\x0As"],"\x23"=>[16,"\x0As"],"\x24"=>[94,"\x0At"],"\x25"=>[76,"\x0At"],"\x26"=>[104,"\x0At"],"\x27"=>[16,"\x0At"],"\x28"=>[77,"\x0A\x20"],"\x29"=>[18,"\x0A\x20"],"\x2A"=>[77,"\x0A\x25"],"\x2B"=>[18,"\x0A\x25"],"\x2C"=>[77,"\x0A-"],"-"=>[18,"\x0A-"],"."=>[77,"\x0A."],"\x2F"=>[18,"\x0A."],[77,"\x0A\x2F"],[18,"\x0A\x2F"],[77,"\x0A3"],[18,"\x0A3"],[77,"\x0A4"],[18,"\x0A4"],[77,"\x0A5"],[18,"\x0A5"],[77,"\x0A6"],[18,"\x0A6"],"\x3A"=>[77,"\x0A7"],"\x3B"=>[18,"\x0A7"],"\x3C"=>[77,"\x0A8"],"\x3D"=>[18,"\x0A8"],"\x3E"=>[77,"\x0A9"],"\x3F"=>[18,"\x0A9"],"\x40"=>[77,"\x0A\x3D"],"A"=>[18,"\x0A\x3D"],"B"=>[77,"\x0AA"],"C"=>[18,"\x0AA"],"D"=>[77,"\x0A_"],"E"=>[18,"\x0A_"],"F"=>[77,"\x0Ab"],"G"=>[18,"\x0Ab"],"H"=>[77,"\x0Ad"],"I"=>[18,"\x0Ad"],"J"=>[77,"\x0Af"],"K"=>[18,"\x0Af"],"L"=>[77,"\x0Ag"],"M"=>[18,"\x0Ag"],"N"=>[77,"\x0Ah"],"O"=>[18,"\x0Ah"],"P"=>[77,"\x0Al"],"Q"=>[18,"\x0Al"],"R"=>[77,"\x0Am"],"S"=>[18,"\x0Am"],"T"=>[77,"\x0An"],"U"=>[18,"\x0An"],"V"=>[77,"\x0Ap"],"W"=>[18,"\x0Ap"],"X"=>[77,"\x0Ar"],"Y"=>[18,"\x0Ar"],"Z"=>[77,"\x0Au"],"\x5B"=>[18,"\x0Au"],"\x5C"=>[0,"\x0A\x3A"],"\x5D"=>[0,"\x0AB"],"\x5E"=>[0,"\x0AC"],"_"=>[0,"\x0AD"],"\x60"=>[0,"\x0AE"],"a"=>[0,"\x0AF"],"b"=>[0,"\x0AG"],"c"=>[0,"\x0AH"],"d"=>[0,"\x0AI"],"e"=>[0,"\x0AJ"],"f"=>[0,"\x0AK"],"g"=>[0,"\x0AL"],"h"=>[0,"\x0AM"],"i"=>[0,"\x0AN"],"j"=>[0,"\x0AO"],"k"=>[0,"\x0AP"],"l"=>[0,"\x0AQ"],"m"=>[0,"\x0AR"],"n"=>[0,"\x0AS"],"o"=>[0,"\x0AT"],"p"=>[0,"\x0AU"],"q"=>[0,"\x0AV"],"r"=>[0,"\x0AW"],"s"=>[0,"\x0AY"],"t"=>[0,"\x0Aj"],"u"=>[0,"\x0Ak"],"v"=>[0,"\x0Aq"],"w"=>[0,"\x0Av"],"x"=>[0,"\x0Aw"],"y"=>[0,"\x0Ax"],"z"=>[0,"\x0Ay"],"\x7B"=>[0,"\x0Az"],"\x7C"=>[82,"\x0A"],"\x7D"=>[87,"\x0A"],"~"=>[130,"\x0A"],"\x7F"=>[9,"\x0A"],"\x80"=>[94,"\x0D0"],"\x81"=>[76,"\x0D0"],"\x82"=>[104,"\x0D0"],"\x83"=>[16,"\x0D0"],"\x84"=>[94,"\x0D1"],"\x85"=>[76,"\x0D1"],"\x86"=>[104,"\x0D1"],"\x87"=>[16,"\x0D1"],"\x88"=>[94,"\x0D2"],"\x89"=>[76,"\x0D2"],"\x8A"=>[104,"\x0D2"],"\x8B"=>[16,"\x0D2"],"\x8C"=>[94,"\x0Da"],"\x8D"=>[76,"\x0Da"],"\x8E"=>[104,"\x0Da"],"\x8F"=>[16,"\x0Da"],"\x90"=>[94,"\x0Dc"],"\x91"=>[76,"\x0Dc"],"\x92"=>[104,"\x0Dc"],"\x93"=>[16,"\x0Dc"],"\x94"=>[94,"\x0De"],"\x95"=>[76,"\x0De"],"\x96"=>[104,"\x0De"],"\x97"=>[16,"\x0De"],"\x98"=>[94,"\x0Di"],"\x99"=>[76,"\x0Di"],"\x9A"=>[104,"\x0Di"],"\x9B"=>[16,"\x0Di"],"\x9C"=>[94,"\x0Do"],"\x9D"=>[76,"\x0Do"],"\x9E"=>[104,"\x0Do"],"\x9F"=>[16,"\x0Do"],"\xA0"=>[94,"\x0Ds"],"\xA1"=>[76,"\x0Ds"],"\xA2"=>[104,"\x0Ds"],"\xA3"=>[16,"\x0Ds"],"\xA4"=>[94,"\x0Dt"],"\xA5"=>[76,"\x0Dt"],"\xA6"=>[104,"\x0Dt"],"\xA7"=>[16,"\x0Dt"],"\xA8"=>[77,"\x0D\x20"],"\xA9"=>[18,"\x0D\x20"],"\xAA"=>[77,"\x0D\x25"],"\xAB"=>[18,"\x0D\x25"],"\xAC"=>[77,"\x0D-"],"\xAD"=>[18,"\x0D-"],"\xAE"=>[77,"\x0D."],"\xAF"=>[18,"\x0D."],"\xB0"=>[77,"\x0D\x2F"],"\xB1"=>[18,"\x0D\x2F"],"\xB2"=>[77,"\x0D3"],"\xB3"=>[18,"\x0D3"],"\xB4"=>[77,"\x0D4"],"\xB5"=>[18,"\x0D4"],"\xB6"=>[77,"\x0D5"],"\xB7"=>[18,"\x0D5"],"\xB8"=>[77,"\x0D6"],"\xB9"=>[18,"\x0D6"],"\xBA"=>[77,"\x0D7"],"\xBB"=>[18,"\x0D7"],"\xBC"=>[77,"\x0D8"],"\xBD"=>[18,"\x0D8"],"\xBE"=>[77,"\x0D9"],"\xBF"=>[18,"\x0D9"],"\xC0"=>[77,"\x0D\x3D"],"\xC1"=>[18,"\x0D\x3D"],"\xC2"=>[77,"\x0DA"],"\xC3"=>[18,"\x0DA"],"\xC4"=>[77,"\x0D_"],"\xC5"=>[18,"\x0D_"],"\xC6"=>[77,"\x0Db"],"\xC7"=>[18,"\x0Db"],"\xC8"=>[77,"\x0Dd"],"\xC9"=>[18,"\x0Dd"],"\xCA"=>[77,"\x0Df"],"\xCB"=>[18,"\x0Df"],"\xCC"=>[77,"\x0Dg"],"\xCD"=>[18,"\x0Dg"],"\xCE"=>[77,"\x0Dh"],"\xCF"=>[18,"\x0Dh"],"\xD0"=>[77,"\x0Dl"],"\xD1"=>[18,"\x0Dl"],"\xD2"=>[77,"\x0Dm"],"\xD3"=>[18,"\x0Dm"],"\xD4"=>[77,"\x0Dn"],"\xD5"=>[18,"\x0Dn"],"\xD6"=>[77,"\x0Dp"],"\xD7"=>[18,"\x0Dp"],"\xD8"=>[77,"\x0Dr"],"\xD9"=>[18,"\x0Dr"],"\xDA"=>[77,"\x0Du"],"\xDB"=>[18,"\x0Du"],"\xDC"=>[0,"\x0D\x3A"],"\xDD"=>[0,"\x0DB"],"\xDE"=>[0,"\x0DC"],"\xDF"=>[0,"\x0DD"],"\xE0"=>[0,"\x0DE"],"\xE1"=>[0,"\x0DF"],"\xE2"=>[0,"\x0DG"],"\xE3"=>[0,"\x0DH"],"\xE4"=>[0,"\x0DI"],"\xE5"=>[0,"\x0DJ"],"\xE6"=>[0,"\x0DK"],"\xE7"=>[0,"\x0DL"],"\xE8"=>[0,"\x0DM"],"\xE9"=>[0,"\x0DN"],"\xEA"=>[0,"\x0DO"],"\xEB"=>[0,"\x0DP"],"\xEC"=>[0,"\x0DQ"],"\xED"=>[0,"\x0DR"],"\xEE"=>[0,"\x0DS"],"\xEF"=>[0,"\x0DT"],"\xF0"=>[0,"\x0DU"],"\xF1"=>[0,"\x0DV"],"\xF2"=>[0,"\x0DW"],"\xF3"=>[0,"\x0DY"],"\xF4"=>[0,"\x0Dj"],"\xF5"=>[0,"\x0Dk"],"\xF6"=>[0,"\x0Dq"],"\xF7"=>[0,"\x0Dv"],"\xF8"=>[0,"\x0Dw"],"\xF9"=>[0,"\x0Dx"],"\xFA"=>[0,"\x0Dy"],"\xFB"=>[0,"\x0Dz"],"\xFC"=>[82,"\x0D"],"\xFD"=>[87,"\x0D"],"\xFE"=>[130,"\x0D"],"\xFF"=>[9,"\x0D"],],["\x00"=>[77,"\x0A0"],"\x01"=>[18,"\x0A0"],"\x02"=>[77,"\x0A1"],"\x03"=>[18,"\x0A1"],"\x04"=>[77,"\x0A2"],"\x05"=>[18,"\x0A2"],"\x06"=>[77,"\x0Aa"],"\x07"=>[18,"\x0Aa"],"\x08"=>[77,"\x0Ac"],"\x09"=>[18,"\x0Ac"],"\x0A"=>[77,"\x0Ae"],"\x0B"=>[18,"\x0Ae"],"\x0C"=>[77,"\x0Ai"],"\x0D"=>[18,"\x0Ai"],"\x0E"=>[77,"\x0Ao"],"\x0F"=>[18,"\x0Ao"],"\x10"=>[77,"\x0As"],"\x11"=>[18,"\x0As"],"\x12"=>[77,"\x0At"],"\x13"=>[18,"\x0At"],"\x14"=>[0,"\x0A\x20"],"\x15"=>[0,"\x0A\x25"],"\x16"=>[0,"\x0A-"],"\x17"=>[0,"\x0A."],"\x18"=>[0,"\x0A\x2F"],"\x19"=>[0,"\x0A3"],"\x1A"=>[0,"\x0A4"],"\x1B"=>[0,"\x0A5"],"\x1C"=>[0,"\x0A6"],"\x1D"=>[0,"\x0A7"],"\x1E"=>[0,"\x0A8"],"\x1F"=>[0,"\x0A9"],"\x20"=>[0,"\x0A\x3D"],"\x21"=>[0,"\x0AA"],"\x22"=>[0,"\x0A_"],"\x23"=>[0,"\x0Ab"],"\x24"=>[0,"\x0Ad"],"\x25"=>[0,"\x0Af"],"\x26"=>[0,"\x0Ag"],"\x27"=>[0,"\x0Ah"],"\x28"=>[0,"\x0Al"],"\x29"=>[0,"\x0Am"],"\x2A"=>[0,"\x0An"],"\x2B"=>[0,"\x0Ap"],"\x2C"=>[0,"\x0Ar"],"-"=>[0,"\x0Au"],"."=>[100,"\x0A"],"\x2F"=>[110,"\x0A"],[111,"\x0A"],[115,"\x0A"],[116,"\x0A"],[118,"\x0A"],[119,"\x0A"],[122,"\x0A"],[123,"\x0A"],[125,"\x0A"],[126,"\x0A"],[129,"\x0A"],"\x3A"=>[143,"\x0A"],"\x3B"=>[148,"\x0A"],"\x3C"=>[151,"\x0A"],"\x3D"=>[153,"\x0A"],"\x3E"=>[83,"\x0A"],"\x3F"=>[10,"\x0A"],"\x40"=>[77,"\x0D0"],"A"=>[18,"\x0D0"],"B"=>[77,"\x0D1"],"C"=>[18,"\x0D1"],"D"=>[77,"\x0D2"],"E"=>[18,"\x0D2"],"F"=>[77,"\x0Da"],"G"=>[18,"\x0Da"],"H"=>[77,"\x0Dc"],"I"=>[18,"\x0Dc"],"J"=>[77,"\x0De"],"K"=>[18,"\x0De"],"L"=>[77,"\x0Di"],"M"=>[18,"\x0Di"],"N"=>[77,"\x0Do"],"O"=>[18,"\x0Do"],"P"=>[77,"\x0Ds"],"Q"=>[18,"\x0Ds"],"R"=>[77,"\x0Dt"],"S"=>[18,"\x0Dt"],"T"=>[0,"\x0D\x20"],"U"=>[0,"\x0D\x25"],"V"=>[0,"\x0D-"],"W"=>[0,"\x0D."],"X"=>[0,"\x0D\x2F"],"Y"=>[0,"\x0D3"],"Z"=>[0,"\x0D4"],"\x5B"=>[0,"\x0D5"],"\x5C"=>[0,"\x0D6"],"\x5D"=>[0,"\x0D7"],"\x5E"=>[0,"\x0D8"],"_"=>[0,"\x0D9"],"\x60"=>[0,"\x0D\x3D"],"a"=>[0,"\x0DA"],"b"=>[0,"\x0D_"],"c"=>[0,"\x0Db"],"d"=>[0,"\x0Dd"],"e"=>[0,"\x0Df"],"f"=>[0,"\x0Dg"],"g"=>[0,"\x0Dh"],"h"=>[0,"\x0Dl"],"i"=>[0,"\x0Dm"],"j"=>[0,"\x0Dn"],"k"=>[0,"\x0Dp"],"l"=>[0,"\x0Dr"],"m"=>[0,"\x0Du"],"n"=>[100,"\x0D"],"o"=>[110,"\x0D"],"p"=>[111,"\x0D"],"q"=>[115,"\x0D"],"r"=>[116,"\x0D"],"s"=>[118,"\x0D"],"t"=>[119,"\x0D"],"u"=>[122,"\x0D"],"v"=>[123,"\x0D"],"w"=>[125,"\x0D"],"x"=>[126,"\x0D"],"y"=>[129,"\x0D"],"z"=>[143,"\x0D"],"\x7B"=>[148,"\x0D"],"\x7C"=>[151,"\x0D"],"\x7D"=>[153,"\x0D"],"~"=>[83,"\x0D"],"\x7F"=>[10,"\x0D"],"\x80"=>[77,"\x160"],"\x81"=>[18,"\x160"],"\x82"=>[77,"\x161"],"\x83"=>[18,"\x161"],"\x84"=>[77,"\x162"],"\x85"=>[18,"\x162"],"\x86"=>[77,"\x16a"],"\x87"=>[18,"\x16a"],"\x88"=>[77,"\x16c"],"\x89"=>[18,"\x16c"],"\x8A"=>[77,"\x16e"],"\x8B"=>[18,"\x16e"],"\x8C"=>[77,"\x16i"],"\x8D"=>[18,"\x16i"],"\x8E"=>[77,"\x16o"],"\x8F"=>[18,"\x16o"],"\x90"=>[77,"\x16s"],"\x91"=>[18,"\x16s"],"\x92"=>[77,"\x16t"],"\x93"=>[18,"\x16t"],"\x94"=>[0,"\x16\x20"],"\x95"=>[0,"\x16\x25"],"\x96"=>[0,"\x16-"],"\x97"=>[0,"\x16."],"\x98"=>[0,"\x16\x2F"],"\x99"=>[0,"\x163"],"\x9A"=>[0,"\x164"],"\x9B"=>[0,"\x165"],"\x9C"=>[0,"\x166"],"\x9D"=>[0,"\x167"],"\x9E"=>[0,"\x168"],"\x9F"=>[0,"\x169"],"\xA0"=>[0,"\x16\x3D"],"\xA1"=>[0,"\x16A"],"\xA2"=>[0,"\x16_"],"\xA3"=>[0,"\x16b"],"\xA4"=>[0,"\x16d"],"\xA5"=>[0,"\x16f"],"\xA6"=>[0,"\x16g"],"\xA7"=>[0,"\x16h"],"\xA8"=>[0,"\x16l"],"\xA9"=>[0,"\x16m"],"\xAA"=>[0,"\x16n"],"\xAB"=>[0,"\x16p"],"\xAC"=>[0,"\x16r"],"\xAD"=>[0,"\x16u"],"\xAE"=>[100,"\x16"],"\xAF"=>[110,"\x16"],"\xB0"=>[111,"\x16"],"\xB1"=>[115,"\x16"],"\xB2"=>[116,"\x16"],"\xB3"=>[118,"\x16"],"\xB4"=>[119,"\x16"],"\xB5"=>[122,"\x16"],"\xB6"=>[123,"\x16"],"\xB7"=>[125,"\x16"],"\xB8"=>[126,"\x16"],"\xB9"=>[129,"\x16"],"\xBA"=>[143,"\x16"],"\xBB"=>[148,"\x16"],"\xBC"=>[151,"\x16"],"\xBD"=>[153,"\x16"],"\xBE"=>[83,"\x16"],"\xBF"=>[10,"\x16"],"\xC0"=>[77,""],"\xC1"=>[18,""],"\xC2"=>[77,""],"\xC3"=>[18,""],"\xC4"=>[77,""],"\xC5"=>[18,""],"\xC6"=>[77,""],"\xC7"=>[18,""],"\xC8"=>[77,""],"\xC9"=>[18,""],"\xCA"=>[77,""],"\xCB"=>[18,""],"\xCC"=>[77,""],"\xCD"=>[18,""],"\xCE"=>[77,""],"\xCF"=>[18,""],"\xD0"=>[77,""],"\xD1"=>[18,""],"\xD2"=>[77,""],"\xD3"=>[18,""],"\xD4"=>[0,""],"\xD5"=>[0,""],"\xD6"=>[0,""],"\xD7"=>[0,""],"\xD8"=>[0,""],"\xD9"=>[0,""],"\xDA"=>[0,""],"\xDB"=>[0,""],"\xDC"=>[0,""],"\xDD"=>[0,""],"\xDE"=>[0,""],"\xDF"=>[0,""],"\xE0"=>[0,""],"\xE1"=>[0,""],"\xE2"=>[0,""],"\xE3"=>[0,""],"\xE4"=>[0,""],"\xE5"=>[0,""],"\xE6"=>[0,""],"\xE7"=>[0,""],"\xE8"=>[0,""],"\xE9"=>[0,""],"\xEA"=>[0,""],"\xEB"=>[0,""],"\xEC"=>[0,""],"\xED"=>[0,""],"\xEE"=>[100,""],"\xEF"=>[110,""],"\xF0"=>[111,""],"\xF1"=>[115,""],"\xF2"=>[116,""],"\xF3"=>[118,""],"\xF4"=>[119,""],"\xF5"=>[122,""],"\xF6"=>[123,""],"\xF7"=>[125,""],"\xF8"=>[126,""],"\xF9"=>[129,""],"\xFA"=>[143,""],"\xFB"=>[148,""],"\xFC"=>[151,""],"\xFD"=>[153,""],"\xFE"=>[83,""],"\xFF"=>[10,""],],["\x00"=>[94,"\xF90"],"\x01"=>[76,"\xF90"],"\x02"=>[104,"\xF90"],"\x03"=>[16,"\xF90"],"\x04"=>[94,"\xF91"],"\x05"=>[76,"\xF91"],"\x06"=>[104,"\xF91"],"\x07"=>[16,"\xF91"],"\x08"=>[94,"\xF92"],"\x09"=>[76,"\xF92"],"\x0A"=>[104,"\xF92"],"\x0B"=>[16,"\xF92"],"\x0C"=>[94,"\xF9a"],"\x0D"=>[76,"\xF9a"],"\x0E"=>[104,"\xF9a"],"\x0F"=>[16,"\xF9a"],"\x10"=>[94,"\xF9c"],"\x11"=>[76,"\xF9c"],"\x12"=>[104,"\xF9c"],"\x13"=>[16,"\xF9c"],"\x14"=>[94,"\xF9e"],"\x15"=>[76,"\xF9e"],"\x16"=>[104,"\xF9e"],"\x17"=>[16,"\xF9e"],"\x18"=>[94,"\xF9i"],"\x19"=>[76,"\xF9i"],"\x1A"=>[104,"\xF9i"],"\x1B"=>[16,"\xF9i"],"\x1C"=>[94,"\xF9o"],"\x1D"=>[76,"\xF9o"],"\x1E"=>[104,"\xF9o"],"\x1F"=>[16,"\xF9o"],"\x20"=>[94,"\xF9s"],"\x21"=>[76,"\xF9s"],"\x22"=>[104,"\xF9s"],"\x23"=>[16,"\xF9s"],"\x24"=>[94,"\xF9t"],"\x25"=>[76,"\xF9t"],"\x26"=>[104,"\xF9t"],"\x27"=>[16,"\xF9t"],"\x28"=>[77,"\xF9\x20"],"\x29"=>[18,"\xF9\x20"],"\x2A"=>[77,"\xF9\x25"],"\x2B"=>[18,"\xF9\x25"],"\x2C"=>[77,"\xF9-"],"-"=>[18,"\xF9-"],"."=>[77,"\xF9."],"\x2F"=>[18,"\xF9."],[77,"\xF9\x2F"],[18,"\xF9\x2F"],[77,"\xF93"],[18,"\xF93"],[77,"\xF94"],[18,"\xF94"],[77,"\xF95"],[18,"\xF95"],[77,"\xF96"],[18,"\xF96"],"\x3A"=>[77,"\xF97"],"\x3B"=>[18,"\xF97"],"\x3C"=>[77,"\xF98"],"\x3D"=>[18,"\xF98"],"\x3E"=>[77,"\xF99"],"\x3F"=>[18,"\xF99"],"\x40"=>[77,"\xF9\x3D"],"A"=>[18,"\xF9\x3D"],"B"=>[77,"\xF9A"],"C"=>[18,"\xF9A"],"D"=>[77,"\xF9_"],"E"=>[18,"\xF9_"],"F"=>[77,"\xF9b"],"G"=>[18,"\xF9b"],"H"=>[77,"\xF9d"],"I"=>[18,"\xF9d"],"J"=>[77,"\xF9f"],"K"=>[18,"\xF9f"],"L"=>[77,"\xF9g"],"M"=>[18,"\xF9g"],"N"=>[77,"\xF9h"],"O"=>[18,"\xF9h"],"P"=>[77,"\xF9l"],"Q"=>[18,"\xF9l"],"R"=>[77,"\xF9m"],"S"=>[18,"\xF9m"],"T"=>[77,"\xF9n"],"U"=>[18,"\xF9n"],"V"=>[77,"\xF9p"],"W"=>[18,"\xF9p"],"X"=>[77,"\xF9r"],"Y"=>[18,"\xF9r"],"Z"=>[77,"\xF9u"],"\x5B"=>[18,"\xF9u"],"\x5C"=>[0,"\xF9\x3A"],"\x5D"=>[0,"\xF9B"],"\x5E"=>[0,"\xF9C"],"_"=>[0,"\xF9D"],"\x60"=>[0,"\xF9E"],"a"=>[0,"\xF9F"],"b"=>[0,"\xF9G"],"c"=>[0,"\xF9H"],"d"=>[0,"\xF9I"],"e"=>[0,"\xF9J"],"f"=>[0,"\xF9K"],"g"=>[0,"\xF9L"],"h"=>[0,"\xF9M"],"i"=>[0,"\xF9N"],"j"=>[0,"\xF9O"],"k"=>[0,"\xF9P"],"l"=>[0,"\xF9Q"],"m"=>[0,"\xF9R"],"n"=>[0,"\xF9S"],"o"=>[0,"\xF9T"],"p"=>[0,"\xF9U"],"q"=>[0,"\xF9V"],"r"=>[0,"\xF9W"],"s"=>[0,"\xF9Y"],"t"=>[0,"\xF9j"],"u"=>[0,"\xF9k"],"v"=>[0,"\xF9q"],"w"=>[0,"\xF9v"],"x"=>[0,"\xF9w"],"y"=>[0,"\xF9x"],"z"=>[0,"\xF9y"],"\x7B"=>[0,"\xF9z"],"\x7C"=>[82,"\xF9"],"\x7D"=>[87,"\xF9"],"~"=>[130,"\xF9"],"\x7F"=>[9,"\xF9"],"\x80"=>[0,"\x0A0"],"\x81"=>[0,"\x0A1"],"\x82"=>[0,"\x0A2"],"\x83"=>[0,"\x0Aa"],"\x84"=>[0,"\x0Ac"],"\x85"=>[0,"\x0Ae"],"\x86"=>[0,"\x0Ai"],"\x87"=>[0,"\x0Ao"],"\x88"=>[0,"\x0As"],"\x89"=>[0,"\x0At"],"\x8A"=>[73,"\x0A"],"\x8B"=>[88,"\x0A"],"\x8C"=>[89,"\x0A"],"\x8D"=>[96,"\x0A"],"\x8E"=>[97,"\x0A"],"\x8F"=>[99,"\x0A"],"\x90"=>[106,"\x0A"],"\x91"=>[136,"\x0A"],"\x92"=>[139,"\x0A"],"\x93"=>[141,"\x0A"],"\x94"=>[145,"\x0A"],"\x95"=>[147,"\x0A"],"\x96"=>[149,"\x0A"],"\x97"=>[101,"\x0A"],"\x98"=>[112,"\x0A"],"\x99"=>[117,"\x0A"],"\x9A"=>[120,"\x0A"],"\x9B"=>[124,"\x0A"],"\x9C"=>[127,"\x0A"],"\x9D"=>[144,"\x0A"],"\x9E"=>[152,"\x0A"],"\x9F"=>[11,"\x0A"],"\xA0"=>[0,"\x0D0"],"\xA1"=>[0,"\x0D1"],"\xA2"=>[0,"\x0D2"],"\xA3"=>[0,"\x0Da"],"\xA4"=>[0,"\x0Dc"],"\xA5"=>[0,"\x0De"],"\xA6"=>[0,"\x0Di"],"\xA7"=>[0,"\x0Do"],"\xA8"=>[0,"\x0Ds"],"\xA9"=>[0,"\x0Dt"],"\xAA"=>[73,"\x0D"],"\xAB"=>[88,"\x0D"],"\xAC"=>[89,"\x0D"],"\xAD"=>[96,"\x0D"],"\xAE"=>[97,"\x0D"],"\xAF"=>[99,"\x0D"],"\xB0"=>[106,"\x0D"],"\xB1"=>[136,"\x0D"],"\xB2"=>[139,"\x0D"],"\xB3"=>[141,"\x0D"],"\xB4"=>[145,"\x0D"],"\xB5"=>[147,"\x0D"],"\xB6"=>[149,"\x0D"],"\xB7"=>[101,"\x0D"],"\xB8"=>[112,"\x0D"],"\xB9"=>[117,"\x0D"],"\xBA"=>[120,"\x0D"],"\xBB"=>[124,"\x0D"],"\xBC"=>[127,"\x0D"],"\xBD"=>[144,"\x0D"],"\xBE"=>[152,"\x0D"],"\xBF"=>[11,"\x0D"],"\xC0"=>[0,"\x160"],"\xC1"=>[0,"\x161"],"\xC2"=>[0,"\x162"],"\xC3"=>[0,"\x16a"],"\xC4"=>[0,"\x16c"],"\xC5"=>[0,"\x16e"],"\xC6"=>[0,"\x16i"],"\xC7"=>[0,"\x16o"],"\xC8"=>[0,"\x16s"],"\xC9"=>[0,"\x16t"],"\xCA"=>[73,"\x16"],"\xCB"=>[88,"\x16"],"\xCC"=>[89,"\x16"],"\xCD"=>[96,"\x16"],"\xCE"=>[97,"\x16"],"\xCF"=>[99,"\x16"],"\xD0"=>[106,"\x16"],"\xD1"=>[136,"\x16"],"\xD2"=>[139,"\x16"],"\xD3"=>[141,"\x16"],"\xD4"=>[145,"\x16"],"\xD5"=>[147,"\x16"],"\xD6"=>[149,"\x16"],"\xD7"=>[101,"\x16"],"\xD8"=>[112,"\x16"],"\xD9"=>[117,"\x16"],"\xDA"=>[120,"\x16"],"\xDB"=>[124,"\x16"],"\xDC"=>[127,"\x16"],"\xDD"=>[144,"\x16"],"\xDE"=>[152,"\x16"],"\xDF"=>[11,"\x16"],"\xE0"=>[0,""],"\xE1"=>[0,""],"\xE2"=>[0,""],"\xE3"=>[0,""],"\xE4"=>[0,""],"\xE5"=>[0,""],"\xE6"=>[0,""],"\xE7"=>[0,""],"\xE8"=>[0,""],"\xE9"=>[0,""],"\xEA"=>[73,""],"\xEB"=>[88,""],"\xEC"=>[89,""],"\xED"=>[96,""],"\xEE"=>[97,""],"\xEF"=>[99,""],"\xF0"=>[106,""],"\xF1"=>[136,""],"\xF2"=>[139,""],"\xF3"=>[141,""],"\xF4"=>[145,""],"\xF5"=>[147,""],"\xF6"=>[149,""],"\xF7"=>[101,""],"\xF8"=>[112,""],"\xF9"=>[117,""],"\xFA"=>[120,""],"\xFB"=>[124,""],"\xFC"=>[127,""],"\xFD"=>[144,""],"\xFE"=>[152,""],"\xFF"=>[11,""],],["\x00"=>[77,"\x7F0"],"\x01"=>[18,"\x7F0"],"\x02"=>[77,"\x7F1"],"\x03"=>[18,"\x7F1"],"\x04"=>[77,"\x7F2"],"\x05"=>[18,"\x7F2"],"\x06"=>[77,"\x7Fa"],"\x07"=>[18,"\x7Fa"],"\x08"=>[77,"\x7Fc"],"\x09"=>[18,"\x7Fc"],"\x0A"=>[77,"\x7Fe"],"\x0B"=>[18,"\x7Fe"],"\x0C"=>[77,"\x7Fi"],"\x0D"=>[18,"\x7Fi"],"\x0E"=>[77,"\x7Fo"],"\x0F"=>[18,"\x7Fo"],"\x10"=>[77,"\x7Fs"],"\x11"=>[18,"\x7Fs"],"\x12"=>[77,"\x7Ft"],"\x13"=>[18,"\x7Ft"],"\x14"=>[0,"\x7F\x20"],"\x15"=>[0,"\x7F\x25"],"\x16"=>[0,"\x7F-"],"\x17"=>[0,"\x7F."],"\x18"=>[0,"\x7F\x2F"],"\x19"=>[0,"\x7F3"],"\x1A"=>[0,"\x7F4"],"\x1B"=>[0,"\x7F5"],"\x1C"=>[0,"\x7F6"],"\x1D"=>[0,"\x7F7"],"\x1E"=>[0,"\x7F8"],"\x1F"=>[0,"\x7F9"],"\x20"=>[0,"\x7F\x3D"],"\x21"=>[0,"\x7FA"],"\x22"=>[0,"\x7F_"],"\x23"=>[0,"\x7Fb"],"\x24"=>[0,"\x7Fd"],"\x25"=>[0,"\x7Ff"],"\x26"=>[0,"\x7Fg"],"\x27"=>[0,"\x7Fh"],"\x28"=>[0,"\x7Fl"],"\x29"=>[0,"\x7Fm"],"\x2A"=>[0,"\x7Fn"],"\x2B"=>[0,"\x7Fp"],"\x2C"=>[0,"\x7Fr"],"-"=>[0,"\x7Fu"],"."=>[100,"\x7F"],"\x2F"=>[110,"\x7F"],[111,"\x7F"],[115,"\x7F"],[116,"\x7F"],[118,"\x7F"],[119,"\x7F"],[122,"\x7F"],[123,"\x7F"],[125,"\x7F"],[126,"\x7F"],[129,"\x7F"],"\x3A"=>[143,"\x7F"],"\x3B"=>[148,"\x7F"],"\x3C"=>[151,"\x7F"],"\x3D"=>[153,"\x7F"],"\x3E"=>[83,"\x7F"],"\x3F"=>[10,"\x7F"],"\x40"=>[77,"\xDC0"],"A"=>[18,"\xDC0"],"B"=>[77,"\xDC1"],"C"=>[18,"\xDC1"],"D"=>[77,"\xDC2"],"E"=>[18,"\xDC2"],"F"=>[77,"\xDCa"],"G"=>[18,"\xDCa"],"H"=>[77,"\xDCc"],"I"=>[18,"\xDCc"],"J"=>[77,"\xDCe"],"K"=>[18,"\xDCe"],"L"=>[77,"\xDCi"],"M"=>[18,"\xDCi"],"N"=>[77,"\xDCo"],"O"=>[18,"\xDCo"],"P"=>[77,"\xDCs"],"Q"=>[18,"\xDCs"],"R"=>[77,"\xDCt"],"S"=>[18,"\xDCt"],"T"=>[0,"\xDC\x20"],"U"=>[0,"\xDC\x25"],"V"=>[0,"\xDC-"],"W"=>[0,"\xDC."],"X"=>[0,"\xDC\x2F"],"Y"=>[0,"\xDC3"],"Z"=>[0,"\xDC4"],"\x5B"=>[0,"\xDC5"],"\x5C"=>[0,"\xDC6"],"\x5D"=>[0,"\xDC7"],"\x5E"=>[0,"\xDC8"],"_"=>[0,"\xDC9"],"\x60"=>[0,"\xDC\x3D"],"a"=>[0,"\xDCA"],"b"=>[0,"\xDC_"],"c"=>[0,"\xDCb"],"d"=>[0,"\xDCd"],"e"=>[0,"\xDCf"],"f"=>[0,"\xDCg"],"g"=>[0,"\xDCh"],"h"=>[0,"\xDCl"],"i"=>[0,"\xDCm"],"j"=>[0,"\xDCn"],"k"=>[0,"\xDCp"],"l"=>[0,"\xDCr"],"m"=>[0,"\xDCu"],"n"=>[100,"\xDC"],"o"=>[110,"\xDC"],"p"=>[111,"\xDC"],"q"=>[115,"\xDC"],"r"=>[116,"\xDC"],"s"=>[118,"\xDC"],"t"=>[119,"\xDC"],"u"=>[122,"\xDC"],"v"=>[123,"\xDC"],"w"=>[125,"\xDC"],"x"=>[126,"\xDC"],"y"=>[129,"\xDC"],"z"=>[143,"\xDC"],"\x7B"=>[148,"\xDC"],"\x7C"=>[151,"\xDC"],"\x7D"=>[153,"\xDC"],"~"=>[83,"\xDC"],"\x7F"=>[10,"\xDC"],"\x80"=>[77,"\xF90"],"\x81"=>[18,"\xF90"],"\x82"=>[77,"\xF91"],"\x83"=>[18,"\xF91"],"\x84"=>[77,"\xF92"],"\x85"=>[18,"\xF92"],"\x86"=>[77,"\xF9a"],"\x87"=>[18,"\xF9a"],"\x88"=>[77,"\xF9c"],"\x89"=>[18,"\xF9c"],"\x8A"=>[77,"\xF9e"],"\x8B"=>[18,"\xF9e"],"\x8C"=>[77,"\xF9i"],"\x8D"=>[18,"\xF9i"],"\x8E"=>[77,"\xF9o"],"\x8F"=>[18,"\xF9o"],"\x90"=>[77,"\xF9s"],"\x91"=>[18,"\xF9s"],"\x92"=>[77,"\xF9t"],"\x93"=>[18,"\xF9t"],"\x94"=>[0,"\xF9\x20"],"\x95"=>[0,"\xF9\x25"],"\x96"=>[0,"\xF9-"],"\x97"=>[0,"\xF9."],"\x98"=>[0,"\xF9\x2F"],"\x99"=>[0,"\xF93"],"\x9A"=>[0,"\xF94"],"\x9B"=>[0,"\xF95"],"\x9C"=>[0,"\xF96"],"\x9D"=>[0,"\xF97"],"\x9E"=>[0,"\xF98"],"\x9F"=>[0,"\xF99"],"\xA0"=>[0,"\xF9\x3D"],"\xA1"=>[0,"\xF9A"],"\xA2"=>[0,"\xF9_"],"\xA3"=>[0,"\xF9b"],"\xA4"=>[0,"\xF9d"],"\xA5"=>[0,"\xF9f"],"\xA6"=>[0,"\xF9g"],"\xA7"=>[0,"\xF9h"],"\xA8"=>[0,"\xF9l"],"\xA9"=>[0,"\xF9m"],"\xAA"=>[0,"\xF9n"],"\xAB"=>[0,"\xF9p"],"\xAC"=>[0,"\xF9r"],"\xAD"=>[0,"\xF9u"],"\xAE"=>[100,"\xF9"],"\xAF"=>[110,"\xF9"],"\xB0"=>[111,"\xF9"],"\xB1"=>[115,"\xF9"],"\xB2"=>[116,"\xF9"],"\xB3"=>[118,"\xF9"],"\xB4"=>[119,"\xF9"],"\xB5"=>[122,"\xF9"],"\xB6"=>[123,"\xF9"],"\xB7"=>[125,"\xF9"],"\xB8"=>[126,"\xF9"],"\xB9"=>[129,"\xF9"],"\xBA"=>[143,"\xF9"],"\xBB"=>[148,"\xF9"],"\xBC"=>[151,"\xF9"],"\xBD"=>[153,"\xF9"],"\xBE"=>[83,"\xF9"],"\xBF"=>[10,"\xF9"],"\xC0"=>[92,"\x0A"],"\xC1"=>[95,"\x0A"],"\xC2"=>[137,"\x0A"],"\xC3"=>[142,"\x0A"],"\xC4"=>[150,"\x0A"],"\xC5"=>[74,"\x0A"],"\xC6"=>[90,"\x0A"],"\xC7"=>[98,"\x0A"],"\xC8"=>[107,"\x0A"],"\xC9"=>[140,"\x0A"],"\xCA"=>[146,"\x0A"],"\xCB"=>[102,"\x0A"],"\xCC"=>[113,"\x0A"],"\xCD"=>[121,"\x0A"],"\xCE"=>[128,"\x0A"],"\xCF"=>[12,"\x0A"],"\xD0"=>[92,"\x0D"],"\xD1"=>[95,"\x0D"],"\xD2"=>[137,"\x0D"],"\xD3"=>[142,"\x0D"],"\xD4"=>[150,"\x0D"],"\xD5"=>[74,"\x0D"],"\xD6"=>[90,"\x0D"],"\xD7"=>[98,"\x0D"],"\xD8"=>[107,"\x0D"],"\xD9"=>[140,"\x0D"],"\xDA"=>[146,"\x0D"],"\xDB"=>[102,"\x0D"],"\xDC"=>[113,"\x0D"],"\xDD"=>[121,"\x0D"],"\xDE"=>[128,"\x0D"],"\xDF"=>[12,"\x0D"],"\xE0"=>[92,"\x16"],"\xE1"=>[95,"\x16"],"\xE2"=>[137,"\x16"],"\xE3"=>[142,"\x16"],"\xE4"=>[150,"\x16"],"\xE5"=>[74,"\x16"],"\xE6"=>[90,"\x16"],"\xE7"=>[98,"\x16"],"\xE8"=>[107,"\x16"],"\xE9"=>[140,"\x16"],"\xEA"=>[146,"\x16"],"\xEB"=>[102,"\x16"],"\xEC"=>[113,"\x16"],"\xED"=>[121,"\x16"],"\xEE"=>[128,"\x16"],"\xEF"=>[12,"\x16"],"\xF0"=>[92,""],"\xF1"=>[95,""],"\xF2"=>[137,""],"\xF3"=>[142,""],"\xF4"=>[150,""],"\xF5"=>[74,""],"\xF6"=>[90,""],"\xF7"=>[98,""],"\xF8"=>[107,""],"\xF9"=>[140,""],"\xFA"=>[146,""],"\xFB"=>[102,""],"\xFC"=>[113,""],"\xFD"=>[121,""],"\xFE"=>[128,""],"\xFF"=>[12,""],],["\x00"=>[0,"\x1C0"],"\x01"=>[0,"\x1C1"],"\x02"=>[0,"\x1C2"],"\x03"=>[0,"\x1Ca"],"\x04"=>[0,"\x1Cc"],"\x05"=>[0,"\x1Ce"],"\x06"=>[0,"\x1Ci"],"\x07"=>[0,"\x1Co"],"\x08"=>[0,"\x1Cs"],"\x09"=>[0,"\x1Ct"],"\x0A"=>[73,"\x1C"],"\x0B"=>[88,"\x1C"],"\x0C"=>[89,"\x1C"],"\x0D"=>[96,"\x1C"],"\x0E"=>[97,"\x1C"],"\x0F"=>[99,"\x1C"],"\x10"=>[106,"\x1C"],"\x11"=>[136,"\x1C"],"\x12"=>[139,"\x1C"],"\x13"=>[141,"\x1C"],"\x14"=>[145,"\x1C"],"\x15"=>[147,"\x1C"],"\x16"=>[149,"\x1C"],"\x17"=>[101,"\x1C"],"\x18"=>[112,"\x1C"],"\x19"=>[117,"\x1C"],"\x1A"=>[120,"\x1C"],"\x1B"=>[124,"\x1C"],"\x1C"=>[127,"\x1C"],"\x1D"=>[144,"\x1C"],"\x1E"=>[152,"\x1C"],"\x1F"=>[11,"\x1C"],"\x20"=>[0,"\x1D0"],"\x21"=>[0,"\x1D1"],"\x22"=>[0,"\x1D2"],"\x23"=>[0,"\x1Da"],"\x24"=>[0,"\x1Dc"],"\x25"=>[0,"\x1De"],"\x26"=>[0,"\x1Di"],"\x27"=>[0,"\x1Do"],"\x28"=>[0,"\x1Ds"],"\x29"=>[0,"\x1Dt"],"\x2A"=>[73,"\x1D"],"\x2B"=>[88,"\x1D"],"\x2C"=>[89,"\x1D"],"-"=>[96,"\x1D"],"."=>[97,"\x1D"],"\x2F"=>[99,"\x1D"],[106,"\x1D"],[136,"\x1D"],[139,"\x1D"],[141,"\x1D"],[145,"\x1D"],[147,"\x1D"],[149,"\x1D"],[101,"\x1D"],[112,"\x1D"],[117,"\x1D"],"\x3A"=>[120,"\x1D"],"\x3B"=>[124,"\x1D"],"\x3C"=>[127,"\x1D"],"\x3D"=>[144,"\x1D"],"\x3E"=>[152,"\x1D"],"\x3F"=>[11,"\x1D"],"\x40"=>[0,"\x1E0"],"A"=>[0,"\x1E1"],"B"=>[0,"\x1E2"],"C"=>[0,"\x1Ea"],"D"=>[0,"\x1Ec"],"E"=>[0,"\x1Ee"],"F"=>[0,"\x1Ei"],"G"=>[0,"\x1Eo"],"H"=>[0,"\x1Es"],"I"=>[0,"\x1Et"],"J"=>[73,"\x1E"],"K"=>[88,"\x1E"],"L"=>[89,"\x1E"],"M"=>[96,"\x1E"],"N"=>[97,"\x1E"],"O"=>[99,"\x1E"],"P"=>[106,"\x1E"],"Q"=>[136,"\x1E"],"R"=>[139,"\x1E"],"S"=>[141,"\x1E"],"T"=>[145,"\x1E"],"U"=>[147,"\x1E"],"V"=>[149,"\x1E"],"W"=>[101,"\x1E"],"X"=>[112,"\x1E"],"Y"=>[117,"\x1E"],"Z"=>[120,"\x1E"],"\x5B"=>[124,"\x1E"],"\x5C"=>[127,"\x1E"],"\x5D"=>[144,"\x1E"],"\x5E"=>[152,"\x1E"],"_"=>[11,"\x1E"],"\x60"=>[0,"\x1F0"],"a"=>[0,"\x1F1"],"b"=>[0,"\x1F2"],"c"=>[0,"\x1Fa"],"d"=>[0,"\x1Fc"],"e"=>[0,"\x1Fe"],"f"=>[0,"\x1Fi"],"g"=>[0,"\x1Fo"],"h"=>[0,"\x1Fs"],"i"=>[0,"\x1Ft"],"j"=>[73,"\x1F"],"k"=>[88,"\x1F"],"l"=>[89,"\x1F"],"m"=>[96,"\x1F"],"n"=>[97,"\x1F"],"o"=>[99,"\x1F"],"p"=>[106,"\x1F"],"q"=>[136,"\x1F"],"r"=>[139,"\x1F"],"s"=>[141,"\x1F"],"t"=>[145,"\x1F"],"u"=>[147,"\x1F"],"v"=>[149,"\x1F"],"w"=>[101,"\x1F"],"x"=>[112,"\x1F"],"y"=>[117,"\x1F"],"z"=>[120,"\x1F"],"\x7B"=>[124,"\x1F"],"\x7C"=>[127,"\x1F"],"\x7D"=>[144,"\x1F"],"~"=>[152,"\x1F"],"\x7F"=>[11,"\x1F"],"\x80"=>[0,"\x7F0"],"\x81"=>[0,"\x7F1"],"\x82"=>[0,"\x7F2"],"\x83"=>[0,"\x7Fa"],"\x84"=>[0,"\x7Fc"],"\x85"=>[0,"\x7Fe"],"\x86"=>[0,"\x7Fi"],"\x87"=>[0,"\x7Fo"],"\x88"=>[0,"\x7Fs"],"\x89"=>[0,"\x7Ft"],"\x8A"=>[73,"\x7F"],"\x8B"=>[88,"\x7F"],"\x8C"=>[89,"\x7F"],"\x8D"=>[96,"\x7F"],"\x8E"=>[97,"\x7F"],"\x8F"=>[99,"\x7F"],"\x90"=>[106,"\x7F"],"\x91"=>[136,"\x7F"],"\x92"=>[139,"\x7F"],"\x93"=>[141,"\x7F"],"\x94"=>[145,"\x7F"],"\x95"=>[147,"\x7F"],"\x96"=>[149,"\x7F"],"\x97"=>[101,"\x7F"],"\x98"=>[112,"\x7F"],"\x99"=>[117,"\x7F"],"\x9A"=>[120,"\x7F"],"\x9B"=>[124,"\x7F"],"\x9C"=>[127,"\x7F"],"\x9D"=>[144,"\x7F"],"\x9E"=>[152,"\x7F"],"\x9F"=>[11,"\x7F"],"\xA0"=>[0,"\xDC0"],"\xA1"=>[0,"\xDC1"],"\xA2"=>[0,"\xDC2"],"\xA3"=>[0,"\xDCa"],"\xA4"=>[0,"\xDCc"],"\xA5"=>[0,"\xDCe"],"\xA6"=>[0,"\xDCi"],"\xA7"=>[0,"\xDCo"],"\xA8"=>[0,"\xDCs"],"\xA9"=>[0,"\xDCt"],"\xAA"=>[73,"\xDC"],"\xAB"=>[88,"\xDC"],"\xAC"=>[89,"\xDC"],"\xAD"=>[96,"\xDC"],"\xAE"=>[97,"\xDC"],"\xAF"=>[99,"\xDC"],"\xB0"=>[106,"\xDC"],"\xB1"=>[136,"\xDC"],"\xB2"=>[139,"\xDC"],"\xB3"=>[141,"\xDC"],"\xB4"=>[145,"\xDC"],"\xB5"=>[147,"\xDC"],"\xB6"=>[149,"\xDC"],"\xB7"=>[101,"\xDC"],"\xB8"=>[112,"\xDC"],"\xB9"=>[117,"\xDC"],"\xBA"=>[120,"\xDC"],"\xBB"=>[124,"\xDC"],"\xBC"=>[127,"\xDC"],"\xBD"=>[144,"\xDC"],"\xBE"=>[152,"\xDC"],"\xBF"=>[11,"\xDC"],"\xC0"=>[0,"\xF90"],"\xC1"=>[0,"\xF91"],"\xC2"=>[0,"\xF92"],"\xC3"=>[0,"\xF9a"],"\xC4"=>[0,"\xF9c"],"\xC5"=>[0,"\xF9e"],"\xC6"=>[0,"\xF9i"],"\xC7"=>[0,"\xF9o"],"\xC8"=>[0,"\xF9s"],"\xC9"=>[0,"\xF9t"],"\xCA"=>[73,"\xF9"],"\xCB"=>[88,"\xF9"],"\xCC"=>[89,"\xF9"],"\xCD"=>[96,"\xF9"],"\xCE"=>[97,"\xF9"],"\xCF"=>[99,"\xF9"],"\xD0"=>[106,"\xF9"],"\xD1"=>[136,"\xF9"],"\xD2"=>[139,"\xF9"],"\xD3"=>[141,"\xF9"],"\xD4"=>[145,"\xF9"],"\xD5"=>[147,"\xF9"],"\xD6"=>[149,"\xF9"],"\xD7"=>[101,"\xF9"],"\xD8"=>[112,"\xF9"],"\xD9"=>[117,"\xF9"],"\xDA"=>[120,"\xF9"],"\xDB"=>[124,"\xF9"],"\xDC"=>[127,"\xF9"],"\xDD"=>[144,"\xF9"],"\xDE"=>[152,"\xF9"],"\xDF"=>[11,"\xF9"],"\xE0"=>[93,"\x0A"],"\xE1"=>[138,"\x0A"],"\xE2"=>[75,"\x0A"],"\xE3"=>[91,"\x0A"],"\xE4"=>[108,"\x0A"],"\xE5"=>[103,"\x0A"],"\xE6"=>[114,"\x0A"],"\xE7"=>[14,"\x0A"],"\xE8"=>[93,"\x0D"],"\xE9"=>[138,"\x0D"],"\xEA"=>[75,"\x0D"],"\xEB"=>[91,"\x0D"],"\xEC"=>[108,"\x0D"],"\xED"=>[103,"\x0D"],"\xEE"=>[114,"\x0D"],"\xEF"=>[14,"\x0D"],"\xF0"=>[93,"\x16"],"\xF1"=>[138,"\x16"],"\xF2"=>[75,"\x16"],"\xF3"=>[91,"\x16"],"\xF4"=>[108,"\x16"],"\xF5"=>[103,"\x16"],"\xF6"=>[114,"\x16"],"\xF7"=>[14,"\x16"],"\xF8"=>[93,""],"\xF9"=>[138,""],"\xFA"=>[75,""],"\xFB"=>[91,""],"\xFC"=>[108,""],"\xFD"=>[103,""],"\xFE"=>[114,""],"\xFF"=>[14,""],],["\x00"=>[94,"\x0C0"],"\x01"=>[76,"\x0C0"],"\x02"=>[104,"\x0C0"],"\x03"=>[16,"\x0C0"],"\x04"=>[94,"\x0C1"],"\x05"=>[76,"\x0C1"],"\x06"=>[104,"\x0C1"],"\x07"=>[16,"\x0C1"],"\x08"=>[94,"\x0C2"],"\x09"=>[76,"\x0C2"],"\x0A"=>[104,"\x0C2"],"\x0B"=>[16,"\x0C2"],"\x0C"=>[94,"\x0Ca"],"\x0D"=>[76,"\x0Ca"],"\x0E"=>[104,"\x0Ca"],"\x0F"=>[16,"\x0Ca"],"\x10"=>[94,"\x0Cc"],"\x11"=>[76,"\x0Cc"],"\x12"=>[104,"\x0Cc"],"\x13"=>[16,"\x0Cc"],"\x14"=>[94,"\x0Ce"],"\x15"=>[76,"\x0Ce"],"\x16"=>[104,"\x0Ce"],"\x17"=>[16,"\x0Ce"],"\x18"=>[94,"\x0Ci"],"\x19"=>[76,"\x0Ci"],"\x1A"=>[104,"\x0Ci"],"\x1B"=>[16,"\x0Ci"],"\x1C"=>[94,"\x0Co"],"\x1D"=>[76,"\x0Co"],"\x1E"=>[104,"\x0Co"],"\x1F"=>[16,"\x0Co"],"\x20"=>[94,"\x0Cs"],"\x21"=>[76,"\x0Cs"],"\x22"=>[104,"\x0Cs"],"\x23"=>[16,"\x0Cs"],"\x24"=>[94,"\x0Ct"],"\x25"=>[76,"\x0Ct"],"\x26"=>[104,"\x0Ct"],"\x27"=>[16,"\x0Ct"],"\x28"=>[77,"\x0C\x20"],"\x29"=>[18,"\x0C\x20"],"\x2A"=>[77,"\x0C\x25"],"\x2B"=>[18,"\x0C\x25"],"\x2C"=>[77,"\x0C-"],"-"=>[18,"\x0C-"],"."=>[77,"\x0C."],"\x2F"=>[18,"\x0C."],[77,"\x0C\x2F"],[18,"\x0C\x2F"],[77,"\x0C3"],[18,"\x0C3"],[77,"\x0C4"],[18,"\x0C4"],[77,"\x0C5"],[18,"\x0C5"],[77,"\x0C6"],[18,"\x0C6"],"\x3A"=>[77,"\x0C7"],"\x3B"=>[18,"\x0C7"],"\x3C"=>[77,"\x0C8"],"\x3D"=>[18,"\x0C8"],"\x3E"=>[77,"\x0C9"],"\x3F"=>[18,"\x0C9"],"\x40"=>[77,"\x0C\x3D"],"A"=>[18,"\x0C\x3D"],"B"=>[77,"\x0CA"],"C"=>[18,"\x0CA"],"D"=>[77,"\x0C_"],"E"=>[18,"\x0C_"],"F"=>[77,"\x0Cb"],"G"=>[18,"\x0Cb"],"H"=>[77,"\x0Cd"],"I"=>[18,"\x0Cd"],"J"=>[77,"\x0Cf"],"K"=>[18,"\x0Cf"],"L"=>[77,"\x0Cg"],"M"=>[18,"\x0Cg"],"N"=>[77,"\x0Ch"],"O"=>[18,"\x0Ch"],"P"=>[77,"\x0Cl"],"Q"=>[18,"\x0Cl"],"R"=>[77,"\x0Cm"],"S"=>[18,"\x0Cm"],"T"=>[77,"\x0Cn"],"U"=>[18,"\x0Cn"],"V"=>[77,"\x0Cp"],"W"=>[18,"\x0Cp"],"X"=>[77,"\x0Cr"],"Y"=>[18,"\x0Cr"],"Z"=>[77,"\x0Cu"],"\x5B"=>[18,"\x0Cu"],"\x5C"=>[0,"\x0C\x3A"],"\x5D"=>[0,"\x0CB"],"\x5E"=>[0,"\x0CC"],"_"=>[0,"\x0CD"],"\x60"=>[0,"\x0CE"],"a"=>[0,"\x0CF"],"b"=>[0,"\x0CG"],"c"=>[0,"\x0CH"],"d"=>[0,"\x0CI"],"e"=>[0,"\x0CJ"],"f"=>[0,"\x0CK"],"g"=>[0,"\x0CL"],"h"=>[0,"\x0CM"],"i"=>[0,"\x0CN"],"j"=>[0,"\x0CO"],"k"=>[0,"\x0CP"],"l"=>[0,"\x0CQ"],"m"=>[0,"\x0CR"],"n"=>[0,"\x0CS"],"o"=>[0,"\x0CT"],"p"=>[0,"\x0CU"],"q"=>[0,"\x0CV"],"r"=>[0,"\x0CW"],"s"=>[0,"\x0CY"],"t"=>[0,"\x0Cj"],"u"=>[0,"\x0Ck"],"v"=>[0,"\x0Cq"],"w"=>[0,"\x0Cv"],"x"=>[0,"\x0Cw"],"y"=>[0,"\x0Cx"],"z"=>[0,"\x0Cy"],"\x7B"=>[0,"\x0Cz"],"\x7C"=>[82,"\x0C"],"\x7D"=>[87,"\x0C"],"~"=>[130,"\x0C"],"\x7F"=>[9,"\x0C"],"\x80"=>[94,"\x0E0"],"\x81"=>[76,"\x0E0"],"\x82"=>[104,"\x0E0"],"\x83"=>[16,"\x0E0"],"\x84"=>[94,"\x0E1"],"\x85"=>[76,"\x0E1"],"\x86"=>[104,"\x0E1"],"\x87"=>[16,"\x0E1"],"\x88"=>[94,"\x0E2"],"\x89"=>[76,"\x0E2"],"\x8A"=>[104,"\x0E2"],"\x8B"=>[16,"\x0E2"],"\x8C"=>[94,"\x0Ea"],"\x8D"=>[76,"\x0Ea"],"\x8E"=>[104,"\x0Ea"],"\x8F"=>[16,"\x0Ea"],"\x90"=>[94,"\x0Ec"],"\x91"=>[76,"\x0Ec"],"\x92"=>[104,"\x0Ec"],"\x93"=>[16,"\x0Ec"],"\x94"=>[94,"\x0Ee"],"\x95"=>[76,"\x0Ee"],"\x96"=>[104,"\x0Ee"],"\x97"=>[16,"\x0Ee"],"\x98"=>[94,"\x0Ei"],"\x99"=>[76,"\x0Ei"],"\x9A"=>[104,"\x0Ei"],"\x9B"=>[16,"\x0Ei"],"\x9C"=>[94,"\x0Eo"],"\x9D"=>[76,"\x0Eo"],"\x9E"=>[104,"\x0Eo"],"\x9F"=>[16,"\x0Eo"],"\xA0"=>[94,"\x0Es"],"\xA1"=>[76,"\x0Es"],"\xA2"=>[104,"\x0Es"],"\xA3"=>[16,"\x0Es"],"\xA4"=>[94,"\x0Et"],"\xA5"=>[76,"\x0Et"],"\xA6"=>[104,"\x0Et"],"\xA7"=>[16,"\x0Et"],"\xA8"=>[77,"\x0E\x20"],"\xA9"=>[18,"\x0E\x20"],"\xAA"=>[77,"\x0E\x25"],"\xAB"=>[18,"\x0E\x25"],"\xAC"=>[77,"\x0E-"],"\xAD"=>[18,"\x0E-"],"\xAE"=>[77,"\x0E."],"\xAF"=>[18,"\x0E."],"\xB0"=>[77,"\x0E\x2F"],"\xB1"=>[18,"\x0E\x2F"],"\xB2"=>[77,"\x0E3"],"\xB3"=>[18,"\x0E3"],"\xB4"=>[77,"\x0E4"],"\xB5"=>[18,"\x0E4"],"\xB6"=>[77,"\x0E5"],"\xB7"=>[18,"\x0E5"],"\xB8"=>[77,"\x0E6"],"\xB9"=>[18,"\x0E6"],"\xBA"=>[77,"\x0E7"],"\xBB"=>[18,"\x0E7"],"\xBC"=>[77,"\x0E8"],"\xBD"=>[18,"\x0E8"],"\xBE"=>[77,"\x0E9"],"\xBF"=>[18,"\x0E9"],"\xC0"=>[77,"\x0E\x3D"],"\xC1"=>[18,"\x0E\x3D"],"\xC2"=>[77,"\x0EA"],"\xC3"=>[18,"\x0EA"],"\xC4"=>[77,"\x0E_"],"\xC5"=>[18,"\x0E_"],"\xC6"=>[77,"\x0Eb"],"\xC7"=>[18,"\x0Eb"],"\xC8"=>[77,"\x0Ed"],"\xC9"=>[18,"\x0Ed"],"\xCA"=>[77,"\x0Ef"],"\xCB"=>[18,"\x0Ef"],"\xCC"=>[77,"\x0Eg"],"\xCD"=>[18,"\x0Eg"],"\xCE"=>[77,"\x0Eh"],"\xCF"=>[18,"\x0Eh"],"\xD0"=>[77,"\x0El"],"\xD1"=>[18,"\x0El"],"\xD2"=>[77,"\x0Em"],"\xD3"=>[18,"\x0Em"],"\xD4"=>[77,"\x0En"],"\xD5"=>[18,"\x0En"],"\xD6"=>[77,"\x0Ep"],"\xD7"=>[18,"\x0Ep"],"\xD8"=>[77,"\x0Er"],"\xD9"=>[18,"\x0Er"],"\xDA"=>[77,"\x0Eu"],"\xDB"=>[18,"\x0Eu"],"\xDC"=>[0,"\x0E\x3A"],"\xDD"=>[0,"\x0EB"],"\xDE"=>[0,"\x0EC"],"\xDF"=>[0,"\x0ED"],"\xE0"=>[0,"\x0EE"],"\xE1"=>[0,"\x0EF"],"\xE2"=>[0,"\x0EG"],"\xE3"=>[0,"\x0EH"],"\xE4"=>[0,"\x0EI"],"\xE5"=>[0,"\x0EJ"],"\xE6"=>[0,"\x0EK"],"\xE7"=>[0,"\x0EL"],"\xE8"=>[0,"\x0EM"],"\xE9"=>[0,"\x0EN"],"\xEA"=>[0,"\x0EO"],"\xEB"=>[0,"\x0EP"],"\xEC"=>[0,"\x0EQ"],"\xED"=>[0,"\x0ER"],"\xEE"=>[0,"\x0ES"],"\xEF"=>[0,"\x0ET"],"\xF0"=>[0,"\x0EU"],"\xF1"=>[0,"\x0EV"],"\xF2"=>[0,"\x0EW"],"\xF3"=>[0,"\x0EY"],"\xF4"=>[0,"\x0Ej"],"\xF5"=>[0,"\x0Ek"],"\xF6"=>[0,"\x0Eq"],"\xF7"=>[0,"\x0Ev"],"\xF8"=>[0,"\x0Ew"],"\xF9"=>[0,"\x0Ex"],"\xFA"=>[0,"\x0Ey"],"\xFB"=>[0,"\x0Ez"],"\xFC"=>[82,"\x0E"],"\xFD"=>[87,"\x0E"],"\xFE"=>[130,"\x0E"],"\xFF"=>[9,"\x0E"],],["\x00"=>[94,"\x0F0"],"\x01"=>[76,"\x0F0"],"\x02"=>[104,"\x0F0"],"\x03"=>[16,"\x0F0"],"\x04"=>[94,"\x0F1"],"\x05"=>[76,"\x0F1"],"\x06"=>[104,"\x0F1"],"\x07"=>[16,"\x0F1"],"\x08"=>[94,"\x0F2"],"\x09"=>[76,"\x0F2"],"\x0A"=>[104,"\x0F2"],"\x0B"=>[16,"\x0F2"],"\x0C"=>[94,"\x0Fa"],"\x0D"=>[76,"\x0Fa"],"\x0E"=>[104,"\x0Fa"],"\x0F"=>[16,"\x0Fa"],"\x10"=>[94,"\x0Fc"],"\x11"=>[76,"\x0Fc"],"\x12"=>[104,"\x0Fc"],"\x13"=>[16,"\x0Fc"],"\x14"=>[94,"\x0Fe"],"\x15"=>[76,"\x0Fe"],"\x16"=>[104,"\x0Fe"],"\x17"=>[16,"\x0Fe"],"\x18"=>[94,"\x0Fi"],"\x19"=>[76,"\x0Fi"],"\x1A"=>[104,"\x0Fi"],"\x1B"=>[16,"\x0Fi"],"\x1C"=>[94,"\x0Fo"],"\x1D"=>[76,"\x0Fo"],"\x1E"=>[104,"\x0Fo"],"\x1F"=>[16,"\x0Fo"],"\x20"=>[94,"\x0Fs"],"\x21"=>[76,"\x0Fs"],"\x22"=>[104,"\x0Fs"],"\x23"=>[16,"\x0Fs"],"\x24"=>[94,"\x0Ft"],"\x25"=>[76,"\x0Ft"],"\x26"=>[104,"\x0Ft"],"\x27"=>[16,"\x0Ft"],"\x28"=>[77,"\x0F\x20"],"\x29"=>[18,"\x0F\x20"],"\x2A"=>[77,"\x0F\x25"],"\x2B"=>[18,"\x0F\x25"],"\x2C"=>[77,"\x0F-"],"-"=>[18,"\x0F-"],"."=>[77,"\x0F."],"\x2F"=>[18,"\x0F."],[77,"\x0F\x2F"],[18,"\x0F\x2F"],[77,"\x0F3"],[18,"\x0F3"],[77,"\x0F4"],[18,"\x0F4"],[77,"\x0F5"],[18,"\x0F5"],[77,"\x0F6"],[18,"\x0F6"],"\x3A"=>[77,"\x0F7"],"\x3B"=>[18,"\x0F7"],"\x3C"=>[77,"\x0F8"],"\x3D"=>[18,"\x0F8"],"\x3E"=>[77,"\x0F9"],"\x3F"=>[18,"\x0F9"],"\x40"=>[77,"\x0F\x3D"],"A"=>[18,"\x0F\x3D"],"B"=>[77,"\x0FA"],"C"=>[18,"\x0FA"],"D"=>[77,"\x0F_"],"E"=>[18,"\x0F_"],"F"=>[77,"\x0Fb"],"G"=>[18,"\x0Fb"],"H"=>[77,"\x0Fd"],"I"=>[18,"\x0Fd"],"J"=>[77,"\x0Ff"],"K"=>[18,"\x0Ff"],"L"=>[77,"\x0Fg"],"M"=>[18,"\x0Fg"],"N"=>[77,"\x0Fh"],"O"=>[18,"\x0Fh"],"P"=>[77,"\x0Fl"],"Q"=>[18,"\x0Fl"],"R"=>[77,"\x0Fm"],"S"=>[18,"\x0Fm"],"T"=>[77,"\x0Fn"],"U"=>[18,"\x0Fn"],"V"=>[77,"\x0Fp"],"W"=>[18,"\x0Fp"],"X"=>[77,"\x0Fr"],"Y"=>[18,"\x0Fr"],"Z"=>[77,"\x0Fu"],"\x5B"=>[18,"\x0Fu"],"\x5C"=>[0,"\x0F\x3A"],"\x5D"=>[0,"\x0FB"],"\x5E"=>[0,"\x0FC"],"_"=>[0,"\x0FD"],"\x60"=>[0,"\x0FE"],"a"=>[0,"\x0FF"],"b"=>[0,"\x0FG"],"c"=>[0,"\x0FH"],"d"=>[0,"\x0FI"],"e"=>[0,"\x0FJ"],"f"=>[0,"\x0FK"],"g"=>[0,"\x0FL"],"h"=>[0,"\x0FM"],"i"=>[0,"\x0FN"],"j"=>[0,"\x0FO"],"k"=>[0,"\x0FP"],"l"=>[0,"\x0FQ"],"m"=>[0,"\x0FR"],"n"=>[0,"\x0FS"],"o"=>[0,"\x0FT"],"p"=>[0,"\x0FU"],"q"=>[0,"\x0FV"],"r"=>[0,"\x0FW"],"s"=>[0,"\x0FY"],"t"=>[0,"\x0Fj"],"u"=>[0,"\x0Fk"],"v"=>[0,"\x0Fq"],"w"=>[0,"\x0Fv"],"x"=>[0,"\x0Fw"],"y"=>[0,"\x0Fx"],"z"=>[0,"\x0Fy"],"\x7B"=>[0,"\x0Fz"],"\x7C"=>[82,"\x0F"],"\x7D"=>[87,"\x0F"],"~"=>[130,"\x0F"],"\x7F"=>[9,"\x0F"],"\x80"=>[94,"\x100"],"\x81"=>[76,"\x100"],"\x82"=>[104,"\x100"],"\x83"=>[16,"\x100"],"\x84"=>[94,"\x101"],"\x85"=>[76,"\x101"],"\x86"=>[104,"\x101"],"\x87"=>[16,"\x101"],"\x88"=>[94,"\x102"],"\x89"=>[76,"\x102"],"\x8A"=>[104,"\x102"],"\x8B"=>[16,"\x102"],"\x8C"=>[94,"\x10a"],"\x8D"=>[76,"\x10a"],"\x8E"=>[104,"\x10a"],"\x8F"=>[16,"\x10a"],"\x90"=>[94,"\x10c"],"\x91"=>[76,"\x10c"],"\x92"=>[104,"\x10c"],"\x93"=>[16,"\x10c"],"\x94"=>[94,"\x10e"],"\x95"=>[76,"\x10e"],"\x96"=>[104,"\x10e"],"\x97"=>[16,"\x10e"],"\x98"=>[94,"\x10i"],"\x99"=>[76,"\x10i"],"\x9A"=>[104,"\x10i"],"\x9B"=>[16,"\x10i"],"\x9C"=>[94,"\x10o"],"\x9D"=>[76,"\x10o"],"\x9E"=>[104,"\x10o"],"\x9F"=>[16,"\x10o"],"\xA0"=>[94,"\x10s"],"\xA1"=>[76,"\x10s"],"\xA2"=>[104,"\x10s"],"\xA3"=>[16,"\x10s"],"\xA4"=>[94,"\x10t"],"\xA5"=>[76,"\x10t"],"\xA6"=>[104,"\x10t"],"\xA7"=>[16,"\x10t"],"\xA8"=>[77,"\x10\x20"],"\xA9"=>[18,"\x10\x20"],"\xAA"=>[77,"\x10\x25"],"\xAB"=>[18,"\x10\x25"],"\xAC"=>[77,"\x10-"],"\xAD"=>[18,"\x10-"],"\xAE"=>[77,"\x10."],"\xAF"=>[18,"\x10."],"\xB0"=>[77,"\x10\x2F"],"\xB1"=>[18,"\x10\x2F"],"\xB2"=>[77,"\x103"],"\xB3"=>[18,"\x103"],"\xB4"=>[77,"\x104"],"\xB5"=>[18,"\x104"],"\xB6"=>[77,"\x105"],"\xB7"=>[18,"\x105"],"\xB8"=>[77,"\x106"],"\xB9"=>[18,"\x106"],"\xBA"=>[77,"\x107"],"\xBB"=>[18,"\x107"],"\xBC"=>[77,"\x108"],"\xBD"=>[18,"\x108"],"\xBE"=>[77,"\x109"],"\xBF"=>[18,"\x109"],"\xC0"=>[77,"\x10\x3D"],"\xC1"=>[18,"\x10\x3D"],"\xC2"=>[77,"\x10A"],"\xC3"=>[18,"\x10A"],"\xC4"=>[77,"\x10_"],"\xC5"=>[18,"\x10_"],"\xC6"=>[77,"\x10b"],"\xC7"=>[18,"\x10b"],"\xC8"=>[77,"\x10d"],"\xC9"=>[18,"\x10d"],"\xCA"=>[77,"\x10f"],"\xCB"=>[18,"\x10f"],"\xCC"=>[77,"\x10g"],"\xCD"=>[18,"\x10g"],"\xCE"=>[77,"\x10h"],"\xCF"=>[18,"\x10h"],"\xD0"=>[77,"\x10l"],"\xD1"=>[18,"\x10l"],"\xD2"=>[77,"\x10m"],"\xD3"=>[18,"\x10m"],"\xD4"=>[77,"\x10n"],"\xD5"=>[18,"\x10n"],"\xD6"=>[77,"\x10p"],"\xD7"=>[18,"\x10p"],"\xD8"=>[77,"\x10r"],"\xD9"=>[18,"\x10r"],"\xDA"=>[77,"\x10u"],"\xDB"=>[18,"\x10u"],"\xDC"=>[0,"\x10\x3A"],"\xDD"=>[0,"\x10B"],"\xDE"=>[0,"\x10C"],"\xDF"=>[0,"\x10D"],"\xE0"=>[0,"\x10E"],"\xE1"=>[0,"\x10F"],"\xE2"=>[0,"\x10G"],"\xE3"=>[0,"\x10H"],"\xE4"=>[0,"\x10I"],"\xE5"=>[0,"\x10J"],"\xE6"=>[0,"\x10K"],"\xE7"=>[0,"\x10L"],"\xE8"=>[0,"\x10M"],"\xE9"=>[0,"\x10N"],"\xEA"=>[0,"\x10O"],"\xEB"=>[0,"\x10P"],"\xEC"=>[0,"\x10Q"],"\xED"=>[0,"\x10R"],"\xEE"=>[0,"\x10S"],"\xEF"=>[0,"\x10T"],"\xF0"=>[0,"\x10U"],"\xF1"=>[0,"\x10V"],"\xF2"=>[0,"\x10W"],"\xF3"=>[0,"\x10Y"],"\xF4"=>[0,"\x10j"],"\xF5"=>[0,"\x10k"],"\xF6"=>[0,"\x10q"],"\xF7"=>[0,"\x10v"],"\xF8"=>[0,"\x10w"],"\xF9"=>[0,"\x10x"],"\xFA"=>[0,"\x10y"],"\xFB"=>[0,"\x10z"],"\xFC"=>[82,"\x10"],"\xFD"=>[87,"\x10"],"\xFE"=>[130,"\x10"],"\xFF"=>[9,"\x10"],],["\x00"=>[77,"\x0F0"],"\x01"=>[18,"\x0F0"],"\x02"=>[77,"\x0F1"],"\x03"=>[18,"\x0F1"],"\x04"=>[77,"\x0F2"],"\x05"=>[18,"\x0F2"],"\x06"=>[77,"\x0Fa"],"\x07"=>[18,"\x0Fa"],"\x08"=>[77,"\x0Fc"],"\x09"=>[18,"\x0Fc"],"\x0A"=>[77,"\x0Fe"],"\x0B"=>[18,"\x0Fe"],"\x0C"=>[77,"\x0Fi"],"\x0D"=>[18,"\x0Fi"],"\x0E"=>[77,"\x0Fo"],"\x0F"=>[18,"\x0Fo"],"\x10"=>[77,"\x0Fs"],"\x11"=>[18,"\x0Fs"],"\x12"=>[77,"\x0Ft"],"\x13"=>[18,"\x0Ft"],"\x14"=>[0,"\x0F\x20"],"\x15"=>[0,"\x0F\x25"],"\x16"=>[0,"\x0F-"],"\x17"=>[0,"\x0F."],"\x18"=>[0,"\x0F\x2F"],"\x19"=>[0,"\x0F3"],"\x1A"=>[0,"\x0F4"],"\x1B"=>[0,"\x0F5"],"\x1C"=>[0,"\x0F6"],"\x1D"=>[0,"\x0F7"],"\x1E"=>[0,"\x0F8"],"\x1F"=>[0,"\x0F9"],"\x20"=>[0,"\x0F\x3D"],"\x21"=>[0,"\x0FA"],"\x22"=>[0,"\x0F_"],"\x23"=>[0,"\x0Fb"],"\x24"=>[0,"\x0Fd"],"\x25"=>[0,"\x0Ff"],"\x26"=>[0,"\x0Fg"],"\x27"=>[0,"\x0Fh"],"\x28"=>[0,"\x0Fl"],"\x29"=>[0,"\x0Fm"],"\x2A"=>[0,"\x0Fn"],"\x2B"=>[0,"\x0Fp"],"\x2C"=>[0,"\x0Fr"],"-"=>[0,"\x0Fu"],"."=>[100,"\x0F"],"\x2F"=>[110,"\x0F"],[111,"\x0F"],[115,"\x0F"],[116,"\x0F"],[118,"\x0F"],[119,"\x0F"],[122,"\x0F"],[123,"\x0F"],[125,"\x0F"],[126,"\x0F"],[129,"\x0F"],"\x3A"=>[143,"\x0F"],"\x3B"=>[148,"\x0F"],"\x3C"=>[151,"\x0F"],"\x3D"=>[153,"\x0F"],"\x3E"=>[83,"\x0F"],"\x3F"=>[10,"\x0F"],"\x40"=>[77,"\x100"],"A"=>[18,"\x100"],"B"=>[77,"\x101"],"C"=>[18,"\x101"],"D"=>[77,"\x102"],"E"=>[18,"\x102"],"F"=>[77,"\x10a"],"G"=>[18,"\x10a"],"H"=>[77,"\x10c"],"I"=>[18,"\x10c"],"J"=>[77,"\x10e"],"K"=>[18,"\x10e"],"L"=>[77,"\x10i"],"M"=>[18,"\x10i"],"N"=>[77,"\x10o"],"O"=>[18,"\x10o"],"P"=>[77,"\x10s"],"Q"=>[18,"\x10s"],"R"=>[77,"\x10t"],"S"=>[18,"\x10t"],"T"=>[0,"\x10\x20"],"U"=>[0,"\x10\x25"],"V"=>[0,"\x10-"],"W"=>[0,"\x10."],"X"=>[0,"\x10\x2F"],"Y"=>[0,"\x103"],"Z"=>[0,"\x104"],"\x5B"=>[0,"\x105"],"\x5C"=>[0,"\x106"],"\x5D"=>[0,"\x107"],"\x5E"=>[0,"\x108"],"_"=>[0,"\x109"],"\x60"=>[0,"\x10\x3D"],"a"=>[0,"\x10A"],"b"=>[0,"\x10_"],"c"=>[0,"\x10b"],"d"=>[0,"\x10d"],"e"=>[0,"\x10f"],"f"=>[0,"\x10g"],"g"=>[0,"\x10h"],"h"=>[0,"\x10l"],"i"=>[0,"\x10m"],"j"=>[0,"\x10n"],"k"=>[0,"\x10p"],"l"=>[0,"\x10r"],"m"=>[0,"\x10u"],"n"=>[100,"\x10"],"o"=>[110,"\x10"],"p"=>[111,"\x10"],"q"=>[115,"\x10"],"r"=>[116,"\x10"],"s"=>[118,"\x10"],"t"=>[119,"\x10"],"u"=>[122,"\x10"],"v"=>[123,"\x10"],"w"=>[125,"\x10"],"x"=>[126,"\x10"],"y"=>[129,"\x10"],"z"=>[143,"\x10"],"\x7B"=>[148,"\x10"],"\x7C"=>[151,"\x10"],"\x7D"=>[153,"\x10"],"~"=>[83,"\x10"],"\x7F"=>[10,"\x10"],"\x80"=>[77,"\x110"],"\x81"=>[18,"\x110"],"\x82"=>[77,"\x111"],"\x83"=>[18,"\x111"],"\x84"=>[77,"\x112"],"\x85"=>[18,"\x112"],"\x86"=>[77,"\x11a"],"\x87"=>[18,"\x11a"],"\x88"=>[77,"\x11c"],"\x89"=>[18,"\x11c"],"\x8A"=>[77,"\x11e"],"\x8B"=>[18,"\x11e"],"\x8C"=>[77,"\x11i"],"\x8D"=>[18,"\x11i"],"\x8E"=>[77,"\x11o"],"\x8F"=>[18,"\x11o"],"\x90"=>[77,"\x11s"],"\x91"=>[18,"\x11s"],"\x92"=>[77,"\x11t"],"\x93"=>[18,"\x11t"],"\x94"=>[0,"\x11\x20"],"\x95"=>[0,"\x11\x25"],"\x96"=>[0,"\x11-"],"\x97"=>[0,"\x11."],"\x98"=>[0,"\x11\x2F"],"\x99"=>[0,"\x113"],"\x9A"=>[0,"\x114"],"\x9B"=>[0,"\x115"],"\x9C"=>[0,"\x116"],"\x9D"=>[0,"\x117"],"\x9E"=>[0,"\x118"],"\x9F"=>[0,"\x119"],"\xA0"=>[0,"\x11\x3D"],"\xA1"=>[0,"\x11A"],"\xA2"=>[0,"\x11_"],"\xA3"=>[0,"\x11b"],"\xA4"=>[0,"\x11d"],"\xA5"=>[0,"\x11f"],"\xA6"=>[0,"\x11g"],"\xA7"=>[0,"\x11h"],"\xA8"=>[0,"\x11l"],"\xA9"=>[0,"\x11m"],"\xAA"=>[0,"\x11n"],"\xAB"=>[0,"\x11p"],"\xAC"=>[0,"\x11r"],"\xAD"=>[0,"\x11u"],"\xAE"=>[100,"\x11"],"\xAF"=>[110,"\x11"],"\xB0"=>[111,"\x11"],"\xB1"=>[115,"\x11"],"\xB2"=>[116,"\x11"],"\xB3"=>[118,"\x11"],"\xB4"=>[119,"\x11"],"\xB5"=>[122,"\x11"],"\xB6"=>[123,"\x11"],"\xB7"=>[125,"\x11"],"\xB8"=>[126,"\x11"],"\xB9"=>[129,"\x11"],"\xBA"=>[143,"\x11"],"\xBB"=>[148,"\x11"],"\xBC"=>[151,"\x11"],"\xBD"=>[153,"\x11"],"\xBE"=>[83,"\x11"],"\xBF"=>[10,"\x11"],"\xC0"=>[77,"\x120"],"\xC1"=>[18,"\x120"],"\xC2"=>[77,"\x121"],"\xC3"=>[18,"\x121"],"\xC4"=>[77,"\x122"],"\xC5"=>[18,"\x122"],"\xC6"=>[77,"\x12a"],"\xC7"=>[18,"\x12a"],"\xC8"=>[77,"\x12c"],"\xC9"=>[18,"\x12c"],"\xCA"=>[77,"\x12e"],"\xCB"=>[18,"\x12e"],"\xCC"=>[77,"\x12i"],"\xCD"=>[18,"\x12i"],"\xCE"=>[77,"\x12o"],"\xCF"=>[18,"\x12o"],"\xD0"=>[77,"\x12s"],"\xD1"=>[18,"\x12s"],"\xD2"=>[77,"\x12t"],"\xD3"=>[18,"\x12t"],"\xD4"=>[0,"\x12\x20"],"\xD5"=>[0,"\x12\x25"],"\xD6"=>[0,"\x12-"],"\xD7"=>[0,"\x12."],"\xD8"=>[0,"\x12\x2F"],"\xD9"=>[0,"\x123"],"\xDA"=>[0,"\x124"],"\xDB"=>[0,"\x125"],"\xDC"=>[0,"\x126"],"\xDD"=>[0,"\x127"],"\xDE"=>[0,"\x128"],"\xDF"=>[0,"\x129"],"\xE0"=>[0,"\x12\x3D"],"\xE1"=>[0,"\x12A"],"\xE2"=>[0,"\x12_"],"\xE3"=>[0,"\x12b"],"\xE4"=>[0,"\x12d"],"\xE5"=>[0,"\x12f"],"\xE6"=>[0,"\x12g"],"\xE7"=>[0,"\x12h"],"\xE8"=>[0,"\x12l"],"\xE9"=>[0,"\x12m"],"\xEA"=>[0,"\x12n"],"\xEB"=>[0,"\x12p"],"\xEC"=>[0,"\x12r"],"\xED"=>[0,"\x12u"],"\xEE"=>[100,"\x12"],"\xEF"=>[110,"\x12"],"\xF0"=>[111,"\x12"],"\xF1"=>[115,"\x12"],"\xF2"=>[116,"\x12"],"\xF3"=>[118,"\x12"],"\xF4"=>[119,"\x12"],"\xF5"=>[122,"\x12"],"\xF6"=>[123,"\x12"],"\xF7"=>[125,"\x12"],"\xF8"=>[126,"\x12"],"\xF9"=>[129,"\x12"],"\xFA"=>[143,"\x12"],"\xFB"=>[148,"\x12"],"\xFC"=>[151,"\x12"],"\xFD"=>[153,"\x12"],"\xFE"=>[83,"\x12"],"\xFF"=>[10,"\x12"],],["\x00"=>[94,"\x110"],"\x01"=>[76,"\x110"],"\x02"=>[104,"\x110"],"\x03"=>[16,"\x110"],"\x04"=>[94,"\x111"],"\x05"=>[76,"\x111"],"\x06"=>[104,"\x111"],"\x07"=>[16,"\x111"],"\x08"=>[94,"\x112"],"\x09"=>[76,"\x112"],"\x0A"=>[104,"\x112"],"\x0B"=>[16,"\x112"],"\x0C"=>[94,"\x11a"],"\x0D"=>[76,"\x11a"],"\x0E"=>[104,"\x11a"],"\x0F"=>[16,"\x11a"],"\x10"=>[94,"\x11c"],"\x11"=>[76,"\x11c"],"\x12"=>[104,"\x11c"],"\x13"=>[16,"\x11c"],"\x14"=>[94,"\x11e"],"\x15"=>[76,"\x11e"],"\x16"=>[104,"\x11e"],"\x17"=>[16,"\x11e"],"\x18"=>[94,"\x11i"],"\x19"=>[76,"\x11i"],"\x1A"=>[104,"\x11i"],"\x1B"=>[16,"\x11i"],"\x1C"=>[94,"\x11o"],"\x1D"=>[76,"\x11o"],"\x1E"=>[104,"\x11o"],"\x1F"=>[16,"\x11o"],"\x20"=>[94,"\x11s"],"\x21"=>[76,"\x11s"],"\x22"=>[104,"\x11s"],"\x23"=>[16,"\x11s"],"\x24"=>[94,"\x11t"],"\x25"=>[76,"\x11t"],"\x26"=>[104,"\x11t"],"\x27"=>[16,"\x11t"],"\x28"=>[77,"\x11\x20"],"\x29"=>[18,"\x11\x20"],"\x2A"=>[77,"\x11\x25"],"\x2B"=>[18,"\x11\x25"],"\x2C"=>[77,"\x11-"],"-"=>[18,"\x11-"],"."=>[77,"\x11."],"\x2F"=>[18,"\x11."],[77,"\x11\x2F"],[18,"\x11\x2F"],[77,"\x113"],[18,"\x113"],[77,"\x114"],[18,"\x114"],[77,"\x115"],[18,"\x115"],[77,"\x116"],[18,"\x116"],"\x3A"=>[77,"\x117"],"\x3B"=>[18,"\x117"],"\x3C"=>[77,"\x118"],"\x3D"=>[18,"\x118"],"\x3E"=>[77,"\x119"],"\x3F"=>[18,"\x119"],"\x40"=>[77,"\x11\x3D"],"A"=>[18,"\x11\x3D"],"B"=>[77,"\x11A"],"C"=>[18,"\x11A"],"D"=>[77,"\x11_"],"E"=>[18,"\x11_"],"F"=>[77,"\x11b"],"G"=>[18,"\x11b"],"H"=>[77,"\x11d"],"I"=>[18,"\x11d"],"J"=>[77,"\x11f"],"K"=>[18,"\x11f"],"L"=>[77,"\x11g"],"M"=>[18,"\x11g"],"N"=>[77,"\x11h"],"O"=>[18,"\x11h"],"P"=>[77,"\x11l"],"Q"=>[18,"\x11l"],"R"=>[77,"\x11m"],"S"=>[18,"\x11m"],"T"=>[77,"\x11n"],"U"=>[18,"\x11n"],"V"=>[77,"\x11p"],"W"=>[18,"\x11p"],"X"=>[77,"\x11r"],"Y"=>[18,"\x11r"],"Z"=>[77,"\x11u"],"\x5B"=>[18,"\x11u"],"\x5C"=>[0,"\x11\x3A"],"\x5D"=>[0,"\x11B"],"\x5E"=>[0,"\x11C"],"_"=>[0,"\x11D"],"\x60"=>[0,"\x11E"],"a"=>[0,"\x11F"],"b"=>[0,"\x11G"],"c"=>[0,"\x11H"],"d"=>[0,"\x11I"],"e"=>[0,"\x11J"],"f"=>[0,"\x11K"],"g"=>[0,"\x11L"],"h"=>[0,"\x11M"],"i"=>[0,"\x11N"],"j"=>[0,"\x11O"],"k"=>[0,"\x11P"],"l"=>[0,"\x11Q"],"m"=>[0,"\x11R"],"n"=>[0,"\x11S"],"o"=>[0,"\x11T"],"p"=>[0,"\x11U"],"q"=>[0,"\x11V"],"r"=>[0,"\x11W"],"s"=>[0,"\x11Y"],"t"=>[0,"\x11j"],"u"=>[0,"\x11k"],"v"=>[0,"\x11q"],"w"=>[0,"\x11v"],"x"=>[0,"\x11w"],"y"=>[0,"\x11x"],"z"=>[0,"\x11y"],"\x7B"=>[0,"\x11z"],"\x7C"=>[82,"\x11"],"\x7D"=>[87,"\x11"],"~"=>[130,"\x11"],"\x7F"=>[9,"\x11"],"\x80"=>[94,"\x120"],"\x81"=>[76,"\x120"],"\x82"=>[104,"\x120"],"\x83"=>[16,"\x120"],"\x84"=>[94,"\x121"],"\x85"=>[76,"\x121"],"\x86"=>[104,"\x121"],"\x87"=>[16,"\x121"],"\x88"=>[94,"\x122"],"\x89"=>[76,"\x122"],"\x8A"=>[104,"\x122"],"\x8B"=>[16,"\x122"],"\x8C"=>[94,"\x12a"],"\x8D"=>[76,"\x12a"],"\x8E"=>[104,"\x12a"],"\x8F"=>[16,"\x12a"],"\x90"=>[94,"\x12c"],"\x91"=>[76,"\x12c"],"\x92"=>[104,"\x12c"],"\x93"=>[16,"\x12c"],"\x94"=>[94,"\x12e"],"\x95"=>[76,"\x12e"],"\x96"=>[104,"\x12e"],"\x97"=>[16,"\x12e"],"\x98"=>[94,"\x12i"],"\x99"=>[76,"\x12i"],"\x9A"=>[104,"\x12i"],"\x9B"=>[16,"\x12i"],"\x9C"=>[94,"\x12o"],"\x9D"=>[76,"\x12o"],"\x9E"=>[104,"\x12o"],"\x9F"=>[16,"\x12o"],"\xA0"=>[94,"\x12s"],"\xA1"=>[76,"\x12s"],"\xA2"=>[104,"\x12s"],"\xA3"=>[16,"\x12s"],"\xA4"=>[94,"\x12t"],"\xA5"=>[76,"\x12t"],"\xA6"=>[104,"\x12t"],"\xA7"=>[16,"\x12t"],"\xA8"=>[77,"\x12\x20"],"\xA9"=>[18,"\x12\x20"],"\xAA"=>[77,"\x12\x25"],"\xAB"=>[18,"\x12\x25"],"\xAC"=>[77,"\x12-"],"\xAD"=>[18,"\x12-"],"\xAE"=>[77,"\x12."],"\xAF"=>[18,"\x12."],"\xB0"=>[77,"\x12\x2F"],"\xB1"=>[18,"\x12\x2F"],"\xB2"=>[77,"\x123"],"\xB3"=>[18,"\x123"],"\xB4"=>[77,"\x124"],"\xB5"=>[18,"\x124"],"\xB6"=>[77,"\x125"],"\xB7"=>[18,"\x125"],"\xB8"=>[77,"\x126"],"\xB9"=>[18,"\x126"],"\xBA"=>[77,"\x127"],"\xBB"=>[18,"\x127"],"\xBC"=>[77,"\x128"],"\xBD"=>[18,"\x128"],"\xBE"=>[77,"\x129"],"\xBF"=>[18,"\x129"],"\xC0"=>[77,"\x12\x3D"],"\xC1"=>[18,"\x12\x3D"],"\xC2"=>[77,"\x12A"],"\xC3"=>[18,"\x12A"],"\xC4"=>[77,"\x12_"],"\xC5"=>[18,"\x12_"],"\xC6"=>[77,"\x12b"],"\xC7"=>[18,"\x12b"],"\xC8"=>[77,"\x12d"],"\xC9"=>[18,"\x12d"],"\xCA"=>[77,"\x12f"],"\xCB"=>[18,"\x12f"],"\xCC"=>[77,"\x12g"],"\xCD"=>[18,"\x12g"],"\xCE"=>[77,"\x12h"],"\xCF"=>[18,"\x12h"],"\xD0"=>[77,"\x12l"],"\xD1"=>[18,"\x12l"],"\xD2"=>[77,"\x12m"],"\xD3"=>[18,"\x12m"],"\xD4"=>[77,"\x12n"],"\xD5"=>[18,"\x12n"],"\xD6"=>[77,"\x12p"],"\xD7"=>[18,"\x12p"],"\xD8"=>[77,"\x12r"],"\xD9"=>[18,"\x12r"],"\xDA"=>[77,"\x12u"],"\xDB"=>[18,"\x12u"],"\xDC"=>[0,"\x12\x3A"],"\xDD"=>[0,"\x12B"],"\xDE"=>[0,"\x12C"],"\xDF"=>[0,"\x12D"],"\xE0"=>[0,"\x12E"],"\xE1"=>[0,"\x12F"],"\xE2"=>[0,"\x12G"],"\xE3"=>[0,"\x12H"],"\xE4"=>[0,"\x12I"],"\xE5"=>[0,"\x12J"],"\xE6"=>[0,"\x12K"],"\xE7"=>[0,"\x12L"],"\xE8"=>[0,"\x12M"],"\xE9"=>[0,"\x12N"],"\xEA"=>[0,"\x12O"],"\xEB"=>[0,"\x12P"],"\xEC"=>[0,"\x12Q"],"\xED"=>[0,"\x12R"],"\xEE"=>[0,"\x12S"],"\xEF"=>[0,"\x12T"],"\xF0"=>[0,"\x12U"],"\xF1"=>[0,"\x12V"],"\xF2"=>[0,"\x12W"],"\xF3"=>[0,"\x12Y"],"\xF4"=>[0,"\x12j"],"\xF5"=>[0,"\x12k"],"\xF6"=>[0,"\x12q"],"\xF7"=>[0,"\x12v"],"\xF8"=>[0,"\x12w"],"\xF9"=>[0,"\x12x"],"\xFA"=>[0,"\x12y"],"\xFB"=>[0,"\x12z"],"\xFC"=>[82,"\x12"],"\xFD"=>[87,"\x12"],"\xFE"=>[130,"\x12"],"\xFF"=>[9,"\x12"],],["\x00"=>[94,"\x130"],"\x01"=>[76,"\x130"],"\x02"=>[104,"\x130"],"\x03"=>[16,"\x130"],"\x04"=>[94,"\x131"],"\x05"=>[76,"\x131"],"\x06"=>[104,"\x131"],"\x07"=>[16,"\x131"],"\x08"=>[94,"\x132"],"\x09"=>[76,"\x132"],"\x0A"=>[104,"\x132"],"\x0B"=>[16,"\x132"],"\x0C"=>[94,"\x13a"],"\x0D"=>[76,"\x13a"],"\x0E"=>[104,"\x13a"],"\x0F"=>[16,"\x13a"],"\x10"=>[94,"\x13c"],"\x11"=>[76,"\x13c"],"\x12"=>[104,"\x13c"],"\x13"=>[16,"\x13c"],"\x14"=>[94,"\x13e"],"\x15"=>[76,"\x13e"],"\x16"=>[104,"\x13e"],"\x17"=>[16,"\x13e"],"\x18"=>[94,"\x13i"],"\x19"=>[76,"\x13i"],"\x1A"=>[104,"\x13i"],"\x1B"=>[16,"\x13i"],"\x1C"=>[94,"\x13o"],"\x1D"=>[76,"\x13o"],"\x1E"=>[104,"\x13o"],"\x1F"=>[16,"\x13o"],"\x20"=>[94,"\x13s"],"\x21"=>[76,"\x13s"],"\x22"=>[104,"\x13s"],"\x23"=>[16,"\x13s"],"\x24"=>[94,"\x13t"],"\x25"=>[76,"\x13t"],"\x26"=>[104,"\x13t"],"\x27"=>[16,"\x13t"],"\x28"=>[77,"\x13\x20"],"\x29"=>[18,"\x13\x20"],"\x2A"=>[77,"\x13\x25"],"\x2B"=>[18,"\x13\x25"],"\x2C"=>[77,"\x13-"],"-"=>[18,"\x13-"],"."=>[77,"\x13."],"\x2F"=>[18,"\x13."],[77,"\x13\x2F"],[18,"\x13\x2F"],[77,"\x133"],[18,"\x133"],[77,"\x134"],[18,"\x134"],[77,"\x135"],[18,"\x135"],[77,"\x136"],[18,"\x136"],"\x3A"=>[77,"\x137"],"\x3B"=>[18,"\x137"],"\x3C"=>[77,"\x138"],"\x3D"=>[18,"\x138"],"\x3E"=>[77,"\x139"],"\x3F"=>[18,"\x139"],"\x40"=>[77,"\x13\x3D"],"A"=>[18,"\x13\x3D"],"B"=>[77,"\x13A"],"C"=>[18,"\x13A"],"D"=>[77,"\x13_"],"E"=>[18,"\x13_"],"F"=>[77,"\x13b"],"G"=>[18,"\x13b"],"H"=>[77,"\x13d"],"I"=>[18,"\x13d"],"J"=>[77,"\x13f"],"K"=>[18,"\x13f"],"L"=>[77,"\x13g"],"M"=>[18,"\x13g"],"N"=>[77,"\x13h"],"O"=>[18,"\x13h"],"P"=>[77,"\x13l"],"Q"=>[18,"\x13l"],"R"=>[77,"\x13m"],"S"=>[18,"\x13m"],"T"=>[77,"\x13n"],"U"=>[18,"\x13n"],"V"=>[77,"\x13p"],"W"=>[18,"\x13p"],"X"=>[77,"\x13r"],"Y"=>[18,"\x13r"],"Z"=>[77,"\x13u"],"\x5B"=>[18,"\x13u"],"\x5C"=>[0,"\x13\x3A"],"\x5D"=>[0,"\x13B"],"\x5E"=>[0,"\x13C"],"_"=>[0,"\x13D"],"\x60"=>[0,"\x13E"],"a"=>[0,"\x13F"],"b"=>[0,"\x13G"],"c"=>[0,"\x13H"],"d"=>[0,"\x13I"],"e"=>[0,"\x13J"],"f"=>[0,"\x13K"],"g"=>[0,"\x13L"],"h"=>[0,"\x13M"],"i"=>[0,"\x13N"],"j"=>[0,"\x13O"],"k"=>[0,"\x13P"],"l"=>[0,"\x13Q"],"m"=>[0,"\x13R"],"n"=>[0,"\x13S"],"o"=>[0,"\x13T"],"p"=>[0,"\x13U"],"q"=>[0,"\x13V"],"r"=>[0,"\x13W"],"s"=>[0,"\x13Y"],"t"=>[0,"\x13j"],"u"=>[0,"\x13k"],"v"=>[0,"\x13q"],"w"=>[0,"\x13v"],"x"=>[0,"\x13w"],"y"=>[0,"\x13x"],"z"=>[0,"\x13y"],"\x7B"=>[0,"\x13z"],"\x7C"=>[82,"\x13"],"\x7D"=>[87,"\x13"],"~"=>[130,"\x13"],"\x7F"=>[9,"\x13"],"\x80"=>[94,"\x140"],"\x81"=>[76,"\x140"],"\x82"=>[104,"\x140"],"\x83"=>[16,"\x140"],"\x84"=>[94,"\x141"],"\x85"=>[76,"\x141"],"\x86"=>[104,"\x141"],"\x87"=>[16,"\x141"],"\x88"=>[94,"\x142"],"\x89"=>[76,"\x142"],"\x8A"=>[104,"\x142"],"\x8B"=>[16,"\x142"],"\x8C"=>[94,"\x14a"],"\x8D"=>[76,"\x14a"],"\x8E"=>[104,"\x14a"],"\x8F"=>[16,"\x14a"],"\x90"=>[94,"\x14c"],"\x91"=>[76,"\x14c"],"\x92"=>[104,"\x14c"],"\x93"=>[16,"\x14c"],"\x94"=>[94,"\x14e"],"\x95"=>[76,"\x14e"],"\x96"=>[104,"\x14e"],"\x97"=>[16,"\x14e"],"\x98"=>[94,"\x14i"],"\x99"=>[76,"\x14i"],"\x9A"=>[104,"\x14i"],"\x9B"=>[16,"\x14i"],"\x9C"=>[94,"\x14o"],"\x9D"=>[76,"\x14o"],"\x9E"=>[104,"\x14o"],"\x9F"=>[16,"\x14o"],"\xA0"=>[94,"\x14s"],"\xA1"=>[76,"\x14s"],"\xA2"=>[104,"\x14s"],"\xA3"=>[16,"\x14s"],"\xA4"=>[94,"\x14t"],"\xA5"=>[76,"\x14t"],"\xA6"=>[104,"\x14t"],"\xA7"=>[16,"\x14t"],"\xA8"=>[77,"\x14\x20"],"\xA9"=>[18,"\x14\x20"],"\xAA"=>[77,"\x14\x25"],"\xAB"=>[18,"\x14\x25"],"\xAC"=>[77,"\x14-"],"\xAD"=>[18,"\x14-"],"\xAE"=>[77,"\x14."],"\xAF"=>[18,"\x14."],"\xB0"=>[77,"\x14\x2F"],"\xB1"=>[18,"\x14\x2F"],"\xB2"=>[77,"\x143"],"\xB3"=>[18,"\x143"],"\xB4"=>[77,"\x144"],"\xB5"=>[18,"\x144"],"\xB6"=>[77,"\x145"],"\xB7"=>[18,"\x145"],"\xB8"=>[77,"\x146"],"\xB9"=>[18,"\x146"],"\xBA"=>[77,"\x147"],"\xBB"=>[18,"\x147"],"\xBC"=>[77,"\x148"],"\xBD"=>[18,"\x148"],"\xBE"=>[77,"\x149"],"\xBF"=>[18,"\x149"],"\xC0"=>[77,"\x14\x3D"],"\xC1"=>[18,"\x14\x3D"],"\xC2"=>[77,"\x14A"],"\xC3"=>[18,"\x14A"],"\xC4"=>[77,"\x14_"],"\xC5"=>[18,"\x14_"],"\xC6"=>[77,"\x14b"],"\xC7"=>[18,"\x14b"],"\xC8"=>[77,"\x14d"],"\xC9"=>[18,"\x14d"],"\xCA"=>[77,"\x14f"],"\xCB"=>[18,"\x14f"],"\xCC"=>[77,"\x14g"],"\xCD"=>[18,"\x14g"],"\xCE"=>[77,"\x14h"],"\xCF"=>[18,"\x14h"],"\xD0"=>[77,"\x14l"],"\xD1"=>[18,"\x14l"],"\xD2"=>[77,"\x14m"],"\xD3"=>[18,"\x14m"],"\xD4"=>[77,"\x14n"],"\xD5"=>[18,"\x14n"],"\xD6"=>[77,"\x14p"],"\xD7"=>[18,"\x14p"],"\xD8"=>[77,"\x14r"],"\xD9"=>[18,"\x14r"],"\xDA"=>[77,"\x14u"],"\xDB"=>[18,"\x14u"],"\xDC"=>[0,"\x14\x3A"],"\xDD"=>[0,"\x14B"],"\xDE"=>[0,"\x14C"],"\xDF"=>[0,"\x14D"],"\xE0"=>[0,"\x14E"],"\xE1"=>[0,"\x14F"],"\xE2"=>[0,"\x14G"],"\xE3"=>[0,"\x14H"],"\xE4"=>[0,"\x14I"],"\xE5"=>[0,"\x14J"],"\xE6"=>[0,"\x14K"],"\xE7"=>[0,"\x14L"],"\xE8"=>[0,"\x14M"],"\xE9"=>[0,"\x14N"],"\xEA"=>[0,"\x14O"],"\xEB"=>[0,"\x14P"],"\xEC"=>[0,"\x14Q"],"\xED"=>[0,"\x14R"],"\xEE"=>[0,"\x14S"],"\xEF"=>[0,"\x14T"],"\xF0"=>[0,"\x14U"],"\xF1"=>[0,"\x14V"],"\xF2"=>[0,"\x14W"],"\xF3"=>[0,"\x14Y"],"\xF4"=>[0,"\x14j"],"\xF5"=>[0,"\x14k"],"\xF6"=>[0,"\x14q"],"\xF7"=>[0,"\x14v"],"\xF8"=>[0,"\x14w"],"\xF9"=>[0,"\x14x"],"\xFA"=>[0,"\x14y"],"\xFB"=>[0,"\x14z"],"\xFC"=>[82,"\x14"],"\xFD"=>[87,"\x14"],"\xFE"=>[130,"\x14"],"\xFF"=>[9,"\x14"],],["\x00"=>[77,"\x130"],"\x01"=>[18,"\x130"],"\x02"=>[77,"\x131"],"\x03"=>[18,"\x131"],"\x04"=>[77,"\x132"],"\x05"=>[18,"\x132"],"\x06"=>[77,"\x13a"],"\x07"=>[18,"\x13a"],"\x08"=>[77,"\x13c"],"\x09"=>[18,"\x13c"],"\x0A"=>[77,"\x13e"],"\x0B"=>[18,"\x13e"],"\x0C"=>[77,"\x13i"],"\x0D"=>[18,"\x13i"],"\x0E"=>[77,"\x13o"],"\x0F"=>[18,"\x13o"],"\x10"=>[77,"\x13s"],"\x11"=>[18,"\x13s"],"\x12"=>[77,"\x13t"],"\x13"=>[18,"\x13t"],"\x14"=>[0,"\x13\x20"],"\x15"=>[0,"\x13\x25"],"\x16"=>[0,"\x13-"],"\x17"=>[0,"\x13."],"\x18"=>[0,"\x13\x2F"],"\x19"=>[0,"\x133"],"\x1A"=>[0,"\x134"],"\x1B"=>[0,"\x135"],"\x1C"=>[0,"\x136"],"\x1D"=>[0,"\x137"],"\x1E"=>[0,"\x138"],"\x1F"=>[0,"\x139"],"\x20"=>[0,"\x13\x3D"],"\x21"=>[0,"\x13A"],"\x22"=>[0,"\x13_"],"\x23"=>[0,"\x13b"],"\x24"=>[0,"\x13d"],"\x25"=>[0,"\x13f"],"\x26"=>[0,"\x13g"],"\x27"=>[0,"\x13h"],"\x28"=>[0,"\x13l"],"\x29"=>[0,"\x13m"],"\x2A"=>[0,"\x13n"],"\x2B"=>[0,"\x13p"],"\x2C"=>[0,"\x13r"],"-"=>[0,"\x13u"],"."=>[100,"\x13"],"\x2F"=>[110,"\x13"],[111,"\x13"],[115,"\x13"],[116,"\x13"],[118,"\x13"],[119,"\x13"],[122,"\x13"],[123,"\x13"],[125,"\x13"],[126,"\x13"],[129,"\x13"],"\x3A"=>[143,"\x13"],"\x3B"=>[148,"\x13"],"\x3C"=>[151,"\x13"],"\x3D"=>[153,"\x13"],"\x3E"=>[83,"\x13"],"\x3F"=>[10,"\x13"],"\x40"=>[77,"\x140"],"A"=>[18,"\x140"],"B"=>[77,"\x141"],"C"=>[18,"\x141"],"D"=>[77,"\x142"],"E"=>[18,"\x142"],"F"=>[77,"\x14a"],"G"=>[18,"\x14a"],"H"=>[77,"\x14c"],"I"=>[18,"\x14c"],"J"=>[77,"\x14e"],"K"=>[18,"\x14e"],"L"=>[77,"\x14i"],"M"=>[18,"\x14i"],"N"=>[77,"\x14o"],"O"=>[18,"\x14o"],"P"=>[77,"\x14s"],"Q"=>[18,"\x14s"],"R"=>[77,"\x14t"],"S"=>[18,"\x14t"],"T"=>[0,"\x14\x20"],"U"=>[0,"\x14\x25"],"V"=>[0,"\x14-"],"W"=>[0,"\x14."],"X"=>[0,"\x14\x2F"],"Y"=>[0,"\x143"],"Z"=>[0,"\x144"],"\x5B"=>[0,"\x145"],"\x5C"=>[0,"\x146"],"\x5D"=>[0,"\x147"],"\x5E"=>[0,"\x148"],"_"=>[0,"\x149"],"\x60"=>[0,"\x14\x3D"],"a"=>[0,"\x14A"],"b"=>[0,"\x14_"],"c"=>[0,"\x14b"],"d"=>[0,"\x14d"],"e"=>[0,"\x14f"],"f"=>[0,"\x14g"],"g"=>[0,"\x14h"],"h"=>[0,"\x14l"],"i"=>[0,"\x14m"],"j"=>[0,"\x14n"],"k"=>[0,"\x14p"],"l"=>[0,"\x14r"],"m"=>[0,"\x14u"],"n"=>[100,"\x14"],"o"=>[110,"\x14"],"p"=>[111,"\x14"],"q"=>[115,"\x14"],"r"=>[116,"\x14"],"s"=>[118,"\x14"],"t"=>[119,"\x14"],"u"=>[122,"\x14"],"v"=>[123,"\x14"],"w"=>[125,"\x14"],"x"=>[126,"\x14"],"y"=>[129,"\x14"],"z"=>[143,"\x14"],"\x7B"=>[148,"\x14"],"\x7C"=>[151,"\x14"],"\x7D"=>[153,"\x14"],"~"=>[83,"\x14"],"\x7F"=>[10,"\x14"],"\x80"=>[77,"\x150"],"\x81"=>[18,"\x150"],"\x82"=>[77,"\x151"],"\x83"=>[18,"\x151"],"\x84"=>[77,"\x152"],"\x85"=>[18,"\x152"],"\x86"=>[77,"\x15a"],"\x87"=>[18,"\x15a"],"\x88"=>[77,"\x15c"],"\x89"=>[18,"\x15c"],"\x8A"=>[77,"\x15e"],"\x8B"=>[18,"\x15e"],"\x8C"=>[77,"\x15i"],"\x8D"=>[18,"\x15i"],"\x8E"=>[77,"\x15o"],"\x8F"=>[18,"\x15o"],"\x90"=>[77,"\x15s"],"\x91"=>[18,"\x15s"],"\x92"=>[77,"\x15t"],"\x93"=>[18,"\x15t"],"\x94"=>[0,"\x15\x20"],"\x95"=>[0,"\x15\x25"],"\x96"=>[0,"\x15-"],"\x97"=>[0,"\x15."],"\x98"=>[0,"\x15\x2F"],"\x99"=>[0,"\x153"],"\x9A"=>[0,"\x154"],"\x9B"=>[0,"\x155"],"\x9C"=>[0,"\x156"],"\x9D"=>[0,"\x157"],"\x9E"=>[0,"\x158"],"\x9F"=>[0,"\x159"],"\xA0"=>[0,"\x15\x3D"],"\xA1"=>[0,"\x15A"],"\xA2"=>[0,"\x15_"],"\xA3"=>[0,"\x15b"],"\xA4"=>[0,"\x15d"],"\xA5"=>[0,"\x15f"],"\xA6"=>[0,"\x15g"],"\xA7"=>[0,"\x15h"],"\xA8"=>[0,"\x15l"],"\xA9"=>[0,"\x15m"],"\xAA"=>[0,"\x15n"],"\xAB"=>[0,"\x15p"],"\xAC"=>[0,"\x15r"],"\xAD"=>[0,"\x15u"],"\xAE"=>[100,"\x15"],"\xAF"=>[110,"\x15"],"\xB0"=>[111,"\x15"],"\xB1"=>[115,"\x15"],"\xB2"=>[116,"\x15"],"\xB3"=>[118,"\x15"],"\xB4"=>[119,"\x15"],"\xB5"=>[122,"\x15"],"\xB6"=>[123,"\x15"],"\xB7"=>[125,"\x15"],"\xB8"=>[126,"\x15"],"\xB9"=>[129,"\x15"],"\xBA"=>[143,"\x15"],"\xBB"=>[148,"\x15"],"\xBC"=>[151,"\x15"],"\xBD"=>[153,"\x15"],"\xBE"=>[83,"\x15"],"\xBF"=>[10,"\x15"],"\xC0"=>[77,"\x170"],"\xC1"=>[18,"\x170"],"\xC2"=>[77,"\x171"],"\xC3"=>[18,"\x171"],"\xC4"=>[77,"\x172"],"\xC5"=>[18,"\x172"],"\xC6"=>[77,"\x17a"],"\xC7"=>[18,"\x17a"],"\xC8"=>[77,"\x17c"],"\xC9"=>[18,"\x17c"],"\xCA"=>[77,"\x17e"],"\xCB"=>[18,"\x17e"],"\xCC"=>[77,"\x17i"],"\xCD"=>[18,"\x17i"],"\xCE"=>[77,"\x17o"],"\xCF"=>[18,"\x17o"],"\xD0"=>[77,"\x17s"],"\xD1"=>[18,"\x17s"],"\xD2"=>[77,"\x17t"],"\xD3"=>[18,"\x17t"],"\xD4"=>[0,"\x17\x20"],"\xD5"=>[0,"\x17\x25"],"\xD6"=>[0,"\x17-"],"\xD7"=>[0,"\x17."],"\xD8"=>[0,"\x17\x2F"],"\xD9"=>[0,"\x173"],"\xDA"=>[0,"\x174"],"\xDB"=>[0,"\x175"],"\xDC"=>[0,"\x176"],"\xDD"=>[0,"\x177"],"\xDE"=>[0,"\x178"],"\xDF"=>[0,"\x179"],"\xE0"=>[0,"\x17\x3D"],"\xE1"=>[0,"\x17A"],"\xE2"=>[0,"\x17_"],"\xE3"=>[0,"\x17b"],"\xE4"=>[0,"\x17d"],"\xE5"=>[0,"\x17f"],"\xE6"=>[0,"\x17g"],"\xE7"=>[0,"\x17h"],"\xE8"=>[0,"\x17l"],"\xE9"=>[0,"\x17m"],"\xEA"=>[0,"\x17n"],"\xEB"=>[0,"\x17p"],"\xEC"=>[0,"\x17r"],"\xED"=>[0,"\x17u"],"\xEE"=>[100,"\x17"],"\xEF"=>[110,"\x17"],"\xF0"=>[111,"\x17"],"\xF1"=>[115,"\x17"],"\xF2"=>[116,"\x17"],"\xF3"=>[118,"\x17"],"\xF4"=>[119,"\x17"],"\xF5"=>[122,"\x17"],"\xF6"=>[123,"\x17"],"\xF7"=>[125,"\x17"],"\xF8"=>[126,"\x17"],"\xF9"=>[129,"\x17"],"\xFA"=>[143,"\x17"],"\xFB"=>[148,"\x17"],"\xFC"=>[151,"\x17"],"\xFD"=>[153,"\x17"],"\xFE"=>[83,"\x17"],"\xFF"=>[10,"\x17"],],["\x00"=>[0,"\x130"],"\x01"=>[0,"\x131"],"\x02"=>[0,"\x132"],"\x03"=>[0,"\x13a"],"\x04"=>[0,"\x13c"],"\x05"=>[0,"\x13e"],"\x06"=>[0,"\x13i"],"\x07"=>[0,"\x13o"],"\x08"=>[0,"\x13s"],"\x09"=>[0,"\x13t"],"\x0A"=>[73,"\x13"],"\x0B"=>[88,"\x13"],"\x0C"=>[89,"\x13"],"\x0D"=>[96,"\x13"],"\x0E"=>[97,"\x13"],"\x0F"=>[99,"\x13"],"\x10"=>[106,"\x13"],"\x11"=>[136,"\x13"],"\x12"=>[139,"\x13"],"\x13"=>[141,"\x13"],"\x14"=>[145,"\x13"],"\x15"=>[147,"\x13"],"\x16"=>[149,"\x13"],"\x17"=>[101,"\x13"],"\x18"=>[112,"\x13"],"\x19"=>[117,"\x13"],"\x1A"=>[120,"\x13"],"\x1B"=>[124,"\x13"],"\x1C"=>[127,"\x13"],"\x1D"=>[144,"\x13"],"\x1E"=>[152,"\x13"],"\x1F"=>[11,"\x13"],"\x20"=>[0,"\x140"],"\x21"=>[0,"\x141"],"\x22"=>[0,"\x142"],"\x23"=>[0,"\x14a"],"\x24"=>[0,"\x14c"],"\x25"=>[0,"\x14e"],"\x26"=>[0,"\x14i"],"\x27"=>[0,"\x14o"],"\x28"=>[0,"\x14s"],"\x29"=>[0,"\x14t"],"\x2A"=>[73,"\x14"],"\x2B"=>[88,"\x14"],"\x2C"=>[89,"\x14"],"-"=>[96,"\x14"],"."=>[97,"\x14"],"\x2F"=>[99,"\x14"],[106,"\x14"],[136,"\x14"],[139,"\x14"],[141,"\x14"],[145,"\x14"],[147,"\x14"],[149,"\x14"],[101,"\x14"],[112,"\x14"],[117,"\x14"],"\x3A"=>[120,"\x14"],"\x3B"=>[124,"\x14"],"\x3C"=>[127,"\x14"],"\x3D"=>[144,"\x14"],"\x3E"=>[152,"\x14"],"\x3F"=>[11,"\x14"],"\x40"=>[0,"\x150"],"A"=>[0,"\x151"],"B"=>[0,"\x152"],"C"=>[0,"\x15a"],"D"=>[0,"\x15c"],"E"=>[0,"\x15e"],"F"=>[0,"\x15i"],"G"=>[0,"\x15o"],"H"=>[0,"\x15s"],"I"=>[0,"\x15t"],"J"=>[73,"\x15"],"K"=>[88,"\x15"],"L"=>[89,"\x15"],"M"=>[96,"\x15"],"N"=>[97,"\x15"],"O"=>[99,"\x15"],"P"=>[106,"\x15"],"Q"=>[136,"\x15"],"R"=>[139,"\x15"],"S"=>[141,"\x15"],"T"=>[145,"\x15"],"U"=>[147,"\x15"],"V"=>[149,"\x15"],"W"=>[101,"\x15"],"X"=>[112,"\x15"],"Y"=>[117,"\x15"],"Z"=>[120,"\x15"],"\x5B"=>[124,"\x15"],"\x5C"=>[127,"\x15"],"\x5D"=>[144,"\x15"],"\x5E"=>[152,"\x15"],"_"=>[11,"\x15"],"\x60"=>[0,"\x170"],"a"=>[0,"\x171"],"b"=>[0,"\x172"],"c"=>[0,"\x17a"],"d"=>[0,"\x17c"],"e"=>[0,"\x17e"],"f"=>[0,"\x17i"],"g"=>[0,"\x17o"],"h"=>[0,"\x17s"],"i"=>[0,"\x17t"],"j"=>[73,"\x17"],"k"=>[88,"\x17"],"l"=>[89,"\x17"],"m"=>[96,"\x17"],"n"=>[97,"\x17"],"o"=>[99,"\x17"],"p"=>[106,"\x17"],"q"=>[136,"\x17"],"r"=>[139,"\x17"],"s"=>[141,"\x17"],"t"=>[145,"\x17"],"u"=>[147,"\x17"],"v"=>[149,"\x17"],"w"=>[101,"\x17"],"x"=>[112,"\x17"],"y"=>[117,"\x17"],"z"=>[120,"\x17"],"\x7B"=>[124,"\x17"],"\x7C"=>[127,"\x17"],"\x7D"=>[144,"\x17"],"~"=>[152,"\x17"],"\x7F"=>[11,"\x17"],"\x80"=>[0,"\x180"],"\x81"=>[0,"\x181"],"\x82"=>[0,"\x182"],"\x83"=>[0,"\x18a"],"\x84"=>[0,"\x18c"],"\x85"=>[0,"\x18e"],"\x86"=>[0,"\x18i"],"\x87"=>[0,"\x18o"],"\x88"=>[0,"\x18s"],"\x89"=>[0,"\x18t"],"\x8A"=>[73,"\x18"],"\x8B"=>[88,"\x18"],"\x8C"=>[89,"\x18"],"\x8D"=>[96,"\x18"],"\x8E"=>[97,"\x18"],"\x8F"=>[99,"\x18"],"\x90"=>[106,"\x18"],"\x91"=>[136,"\x18"],"\x92"=>[139,"\x18"],"\x93"=>[141,"\x18"],"\x94"=>[145,"\x18"],"\x95"=>[147,"\x18"],"\x96"=>[149,"\x18"],"\x97"=>[101,"\x18"],"\x98"=>[112,"\x18"],"\x99"=>[117,"\x18"],"\x9A"=>[120,"\x18"],"\x9B"=>[124,"\x18"],"\x9C"=>[127,"\x18"],"\x9D"=>[144,"\x18"],"\x9E"=>[152,"\x18"],"\x9F"=>[11,"\x18"],"\xA0"=>[0,"\x190"],"\xA1"=>[0,"\x191"],"\xA2"=>[0,"\x192"],"\xA3"=>[0,"\x19a"],"\xA4"=>[0,"\x19c"],"\xA5"=>[0,"\x19e"],"\xA6"=>[0,"\x19i"],"\xA7"=>[0,"\x19o"],"\xA8"=>[0,"\x19s"],"\xA9"=>[0,"\x19t"],"\xAA"=>[73,"\x19"],"\xAB"=>[88,"\x19"],"\xAC"=>[89,"\x19"],"\xAD"=>[96,"\x19"],"\xAE"=>[97,"\x19"],"\xAF"=>[99,"\x19"],"\xB0"=>[106,"\x19"],"\xB1"=>[136,"\x19"],"\xB2"=>[139,"\x19"],"\xB3"=>[141,"\x19"],"\xB4"=>[145,"\x19"],"\xB5"=>[147,"\x19"],"\xB6"=>[149,"\x19"],"\xB7"=>[101,"\x19"],"\xB8"=>[112,"\x19"],"\xB9"=>[117,"\x19"],"\xBA"=>[120,"\x19"],"\xBB"=>[124,"\x19"],"\xBC"=>[127,"\x19"],"\xBD"=>[144,"\x19"],"\xBE"=>[152,"\x19"],"\xBF"=>[11,"\x19"],"\xC0"=>[0,"\x1A0"],"\xC1"=>[0,"\x1A1"],"\xC2"=>[0,"\x1A2"],"\xC3"=>[0,"\x1Aa"],"\xC4"=>[0,"\x1Ac"],"\xC5"=>[0,"\x1Ae"],"\xC6"=>[0,"\x1Ai"],"\xC7"=>[0,"\x1Ao"],"\xC8"=>[0,"\x1As"],"\xC9"=>[0,"\x1At"],"\xCA"=>[73,"\x1A"],"\xCB"=>[88,"\x1A"],"\xCC"=>[89,"\x1A"],"\xCD"=>[96,"\x1A"],"\xCE"=>[97,"\x1A"],"\xCF"=>[99,"\x1A"],"\xD0"=>[106,"\x1A"],"\xD1"=>[136,"\x1A"],"\xD2"=>[139,"\x1A"],"\xD3"=>[141,"\x1A"],"\xD4"=>[145,"\x1A"],"\xD5"=>[147,"\x1A"],"\xD6"=>[149,"\x1A"],"\xD7"=>[101,"\x1A"],"\xD8"=>[112,"\x1A"],"\xD9"=>[117,"\x1A"],"\xDA"=>[120,"\x1A"],"\xDB"=>[124,"\x1A"],"\xDC"=>[127,"\x1A"],"\xDD"=>[144,"\x1A"],"\xDE"=>[152,"\x1A"],"\xDF"=>[11,"\x1A"],"\xE0"=>[0,"\x1B0"],"\xE1"=>[0,"\x1B1"],"\xE2"=>[0,"\x1B2"],"\xE3"=>[0,"\x1Ba"],"\xE4"=>[0,"\x1Bc"],"\xE5"=>[0,"\x1Be"],"\xE6"=>[0,"\x1Bi"],"\xE7"=>[0,"\x1Bo"],"\xE8"=>[0,"\x1Bs"],"\xE9"=>[0,"\x1Bt"],"\xEA"=>[73,"\x1B"],"\xEB"=>[88,"\x1B"],"\xEC"=>[89,"\x1B"],"\xED"=>[96,"\x1B"],"\xEE"=>[97,"\x1B"],"\xEF"=>[99,"\x1B"],"\xF0"=>[106,"\x1B"],"\xF1"=>[136,"\x1B"],"\xF2"=>[139,"\x1B"],"\xF3"=>[141,"\x1B"],"\xF4"=>[145,"\x1B"],"\xF5"=>[147,"\x1B"],"\xF6"=>[149,"\x1B"],"\xF7"=>[101,"\x1B"],"\xF8"=>[112,"\x1B"],"\xF9"=>[117,"\x1B"],"\xFA"=>[120,"\x1B"],"\xFB"=>[124,"\x1B"],"\xFC"=>[127,"\x1B"],"\xFD"=>[144,"\x1B"],"\xFE"=>[152,"\x1B"],"\xFF"=>[11,"\x1B"],],["\x00"=>[94,"\x150"],"\x01"=>[76,"\x150"],"\x02"=>[104,"\x150"],"\x03"=>[16,"\x150"],"\x04"=>[94,"\x151"],"\x05"=>[76,"\x151"],"\x06"=>[104,"\x151"],"\x07"=>[16,"\x151"],"\x08"=>[94,"\x152"],"\x09"=>[76,"\x152"],"\x0A"=>[104,"\x152"],"\x0B"=>[16,"\x152"],"\x0C"=>[94,"\x15a"],"\x0D"=>[76,"\x15a"],"\x0E"=>[104,"\x15a"],"\x0F"=>[16,"\x15a"],"\x10"=>[94,"\x15c"],"\x11"=>[76,"\x15c"],"\x12"=>[104,"\x15c"],"\x13"=>[16,"\x15c"],"\x14"=>[94,"\x15e"],"\x15"=>[76,"\x15e"],"\x16"=>[104,"\x15e"],"\x17"=>[16,"\x15e"],"\x18"=>[94,"\x15i"],"\x19"=>[76,"\x15i"],"\x1A"=>[104,"\x15i"],"\x1B"=>[16,"\x15i"],"\x1C"=>[94,"\x15o"],"\x1D"=>[76,"\x15o"],"\x1E"=>[104,"\x15o"],"\x1F"=>[16,"\x15o"],"\x20"=>[94,"\x15s"],"\x21"=>[76,"\x15s"],"\x22"=>[104,"\x15s"],"\x23"=>[16,"\x15s"],"\x24"=>[94,"\x15t"],"\x25"=>[76,"\x15t"],"\x26"=>[104,"\x15t"],"\x27"=>[16,"\x15t"],"\x28"=>[77,"\x15\x20"],"\x29"=>[18,"\x15\x20"],"\x2A"=>[77,"\x15\x25"],"\x2B"=>[18,"\x15\x25"],"\x2C"=>[77,"\x15-"],"-"=>[18,"\x15-"],"."=>[77,"\x15."],"\x2F"=>[18,"\x15."],[77,"\x15\x2F"],[18,"\x15\x2F"],[77,"\x153"],[18,"\x153"],[77,"\x154"],[18,"\x154"],[77,"\x155"],[18,"\x155"],[77,"\x156"],[18,"\x156"],"\x3A"=>[77,"\x157"],"\x3B"=>[18,"\x157"],"\x3C"=>[77,"\x158"],"\x3D"=>[18,"\x158"],"\x3E"=>[77,"\x159"],"\x3F"=>[18,"\x159"],"\x40"=>[77,"\x15\x3D"],"A"=>[18,"\x15\x3D"],"B"=>[77,"\x15A"],"C"=>[18,"\x15A"],"D"=>[77,"\x15_"],"E"=>[18,"\x15_"],"F"=>[77,"\x15b"],"G"=>[18,"\x15b"],"H"=>[77,"\x15d"],"I"=>[18,"\x15d"],"J"=>[77,"\x15f"],"K"=>[18,"\x15f"],"L"=>[77,"\x15g"],"M"=>[18,"\x15g"],"N"=>[77,"\x15h"],"O"=>[18,"\x15h"],"P"=>[77,"\x15l"],"Q"=>[18,"\x15l"],"R"=>[77,"\x15m"],"S"=>[18,"\x15m"],"T"=>[77,"\x15n"],"U"=>[18,"\x15n"],"V"=>[77,"\x15p"],"W"=>[18,"\x15p"],"X"=>[77,"\x15r"],"Y"=>[18,"\x15r"],"Z"=>[77,"\x15u"],"\x5B"=>[18,"\x15u"],"\x5C"=>[0,"\x15\x3A"],"\x5D"=>[0,"\x15B"],"\x5E"=>[0,"\x15C"],"_"=>[0,"\x15D"],"\x60"=>[0,"\x15E"],"a"=>[0,"\x15F"],"b"=>[0,"\x15G"],"c"=>[0,"\x15H"],"d"=>[0,"\x15I"],"e"=>[0,"\x15J"],"f"=>[0,"\x15K"],"g"=>[0,"\x15L"],"h"=>[0,"\x15M"],"i"=>[0,"\x15N"],"j"=>[0,"\x15O"],"k"=>[0,"\x15P"],"l"=>[0,"\x15Q"],"m"=>[0,"\x15R"],"n"=>[0,"\x15S"],"o"=>[0,"\x15T"],"p"=>[0,"\x15U"],"q"=>[0,"\x15V"],"r"=>[0,"\x15W"],"s"=>[0,"\x15Y"],"t"=>[0,"\x15j"],"u"=>[0,"\x15k"],"v"=>[0,"\x15q"],"w"=>[0,"\x15v"],"x"=>[0,"\x15w"],"y"=>[0,"\x15x"],"z"=>[0,"\x15y"],"\x7B"=>[0,"\x15z"],"\x7C"=>[82,"\x15"],"\x7D"=>[87,"\x15"],"~"=>[130,"\x15"],"\x7F"=>[9,"\x15"],"\x80"=>[94,"\x170"],"\x81"=>[76,"\x170"],"\x82"=>[104,"\x170"],"\x83"=>[16,"\x170"],"\x84"=>[94,"\x171"],"\x85"=>[76,"\x171"],"\x86"=>[104,"\x171"],"\x87"=>[16,"\x171"],"\x88"=>[94,"\x172"],"\x89"=>[76,"\x172"],"\x8A"=>[104,"\x172"],"\x8B"=>[16,"\x172"],"\x8C"=>[94,"\x17a"],"\x8D"=>[76,"\x17a"],"\x8E"=>[104,"\x17a"],"\x8F"=>[16,"\x17a"],"\x90"=>[94,"\x17c"],"\x91"=>[76,"\x17c"],"\x92"=>[104,"\x17c"],"\x93"=>[16,"\x17c"],"\x94"=>[94,"\x17e"],"\x95"=>[76,"\x17e"],"\x96"=>[104,"\x17e"],"\x97"=>[16,"\x17e"],"\x98"=>[94,"\x17i"],"\x99"=>[76,"\x17i"],"\x9A"=>[104,"\x17i"],"\x9B"=>[16,"\x17i"],"\x9C"=>[94,"\x17o"],"\x9D"=>[76,"\x17o"],"\x9E"=>[104,"\x17o"],"\x9F"=>[16,"\x17o"],"\xA0"=>[94,"\x17s"],"\xA1"=>[76,"\x17s"],"\xA2"=>[104,"\x17s"],"\xA3"=>[16,"\x17s"],"\xA4"=>[94,"\x17t"],"\xA5"=>[76,"\x17t"],"\xA6"=>[104,"\x17t"],"\xA7"=>[16,"\x17t"],"\xA8"=>[77,"\x17\x20"],"\xA9"=>[18,"\x17\x20"],"\xAA"=>[77,"\x17\x25"],"\xAB"=>[18,"\x17\x25"],"\xAC"=>[77,"\x17-"],"\xAD"=>[18,"\x17-"],"\xAE"=>[77,"\x17."],"\xAF"=>[18,"\x17."],"\xB0"=>[77,"\x17\x2F"],"\xB1"=>[18,"\x17\x2F"],"\xB2"=>[77,"\x173"],"\xB3"=>[18,"\x173"],"\xB4"=>[77,"\x174"],"\xB5"=>[18,"\x174"],"\xB6"=>[77,"\x175"],"\xB7"=>[18,"\x175"],"\xB8"=>[77,"\x176"],"\xB9"=>[18,"\x176"],"\xBA"=>[77,"\x177"],"\xBB"=>[18,"\x177"],"\xBC"=>[77,"\x178"],"\xBD"=>[18,"\x178"],"\xBE"=>[77,"\x179"],"\xBF"=>[18,"\x179"],"\xC0"=>[77,"\x17\x3D"],"\xC1"=>[18,"\x17\x3D"],"\xC2"=>[77,"\x17A"],"\xC3"=>[18,"\x17A"],"\xC4"=>[77,"\x17_"],"\xC5"=>[18,"\x17_"],"\xC6"=>[77,"\x17b"],"\xC7"=>[18,"\x17b"],"\xC8"=>[77,"\x17d"],"\xC9"=>[18,"\x17d"],"\xCA"=>[77,"\x17f"],"\xCB"=>[18,"\x17f"],"\xCC"=>[77,"\x17g"],"\xCD"=>[18,"\x17g"],"\xCE"=>[77,"\x17h"],"\xCF"=>[18,"\x17h"],"\xD0"=>[77,"\x17l"],"\xD1"=>[18,"\x17l"],"\xD2"=>[77,"\x17m"],"\xD3"=>[18,"\x17m"],"\xD4"=>[77,"\x17n"],"\xD5"=>[18,"\x17n"],"\xD6"=>[77,"\x17p"],"\xD7"=>[18,"\x17p"],"\xD8"=>[77,"\x17r"],"\xD9"=>[18,"\x17r"],"\xDA"=>[77,"\x17u"],"\xDB"=>[18,"\x17u"],"\xDC"=>[0,"\x17\x3A"],"\xDD"=>[0,"\x17B"],"\xDE"=>[0,"\x17C"],"\xDF"=>[0,"\x17D"],"\xE0"=>[0,"\x17E"],"\xE1"=>[0,"\x17F"],"\xE2"=>[0,"\x17G"],"\xE3"=>[0,"\x17H"],"\xE4"=>[0,"\x17I"],"\xE5"=>[0,"\x17J"],"\xE6"=>[0,"\x17K"],"\xE7"=>[0,"\x17L"],"\xE8"=>[0,"\x17M"],"\xE9"=>[0,"\x17N"],"\xEA"=>[0,"\x17O"],"\xEB"=>[0,"\x17P"],"\xEC"=>[0,"\x17Q"],"\xED"=>[0,"\x17R"],"\xEE"=>[0,"\x17S"],"\xEF"=>[0,"\x17T"],"\xF0"=>[0,"\x17U"],"\xF1"=>[0,"\x17V"],"\xF2"=>[0,"\x17W"],"\xF3"=>[0,"\x17Y"],"\xF4"=>[0,"\x17j"],"\xF5"=>[0,"\x17k"],"\xF6"=>[0,"\x17q"],"\xF7"=>[0,"\x17v"],"\xF8"=>[0,"\x17w"],"\xF9"=>[0,"\x17x"],"\xFA"=>[0,"\x17y"],"\xFB"=>[0,"\x17z"],"\xFC"=>[82,"\x17"],"\xFD"=>[87,"\x17"],"\xFE"=>[130,"\x17"],"\xFF"=>[9,"\x17"],],["\x00"=>[94,"\x160"],"\x01"=>[76,"\x160"],"\x02"=>[104,"\x160"],"\x03"=>[16,"\x160"],"\x04"=>[94,"\x161"],"\x05"=>[76,"\x161"],"\x06"=>[104,"\x161"],"\x07"=>[16,"\x161"],"\x08"=>[94,"\x162"],"\x09"=>[76,"\x162"],"\x0A"=>[104,"\x162"],"\x0B"=>[16,"\x162"],"\x0C"=>[94,"\x16a"],"\x0D"=>[76,"\x16a"],"\x0E"=>[104,"\x16a"],"\x0F"=>[16,"\x16a"],"\x10"=>[94,"\x16c"],"\x11"=>[76,"\x16c"],"\x12"=>[104,"\x16c"],"\x13"=>[16,"\x16c"],"\x14"=>[94,"\x16e"],"\x15"=>[76,"\x16e"],"\x16"=>[104,"\x16e"],"\x17"=>[16,"\x16e"],"\x18"=>[94,"\x16i"],"\x19"=>[76,"\x16i"],"\x1A"=>[104,"\x16i"],"\x1B"=>[16,"\x16i"],"\x1C"=>[94,"\x16o"],"\x1D"=>[76,"\x16o"],"\x1E"=>[104,"\x16o"],"\x1F"=>[16,"\x16o"],"\x20"=>[94,"\x16s"],"\x21"=>[76,"\x16s"],"\x22"=>[104,"\x16s"],"\x23"=>[16,"\x16s"],"\x24"=>[94,"\x16t"],"\x25"=>[76,"\x16t"],"\x26"=>[104,"\x16t"],"\x27"=>[16,"\x16t"],"\x28"=>[77,"\x16\x20"],"\x29"=>[18,"\x16\x20"],"\x2A"=>[77,"\x16\x25"],"\x2B"=>[18,"\x16\x25"],"\x2C"=>[77,"\x16-"],"-"=>[18,"\x16-"],"."=>[77,"\x16."],"\x2F"=>[18,"\x16."],[77,"\x16\x2F"],[18,"\x16\x2F"],[77,"\x163"],[18,"\x163"],[77,"\x164"],[18,"\x164"],[77,"\x165"],[18,"\x165"],[77,"\x166"],[18,"\x166"],"\x3A"=>[77,"\x167"],"\x3B"=>[18,"\x167"],"\x3C"=>[77,"\x168"],"\x3D"=>[18,"\x168"],"\x3E"=>[77,"\x169"],"\x3F"=>[18,"\x169"],"\x40"=>[77,"\x16\x3D"],"A"=>[18,"\x16\x3D"],"B"=>[77,"\x16A"],"C"=>[18,"\x16A"],"D"=>[77,"\x16_"],"E"=>[18,"\x16_"],"F"=>[77,"\x16b"],"G"=>[18,"\x16b"],"H"=>[77,"\x16d"],"I"=>[18,"\x16d"],"J"=>[77,"\x16f"],"K"=>[18,"\x16f"],"L"=>[77,"\x16g"],"M"=>[18,"\x16g"],"N"=>[77,"\x16h"],"O"=>[18,"\x16h"],"P"=>[77,"\x16l"],"Q"=>[18,"\x16l"],"R"=>[77,"\x16m"],"S"=>[18,"\x16m"],"T"=>[77,"\x16n"],"U"=>[18,"\x16n"],"V"=>[77,"\x16p"],"W"=>[18,"\x16p"],"X"=>[77,"\x16r"],"Y"=>[18,"\x16r"],"Z"=>[77,"\x16u"],"\x5B"=>[18,"\x16u"],"\x5C"=>[0,"\x16\x3A"],"\x5D"=>[0,"\x16B"],"\x5E"=>[0,"\x16C"],"_"=>[0,"\x16D"],"\x60"=>[0,"\x16E"],"a"=>[0,"\x16F"],"b"=>[0,"\x16G"],"c"=>[0,"\x16H"],"d"=>[0,"\x16I"],"e"=>[0,"\x16J"],"f"=>[0,"\x16K"],"g"=>[0,"\x16L"],"h"=>[0,"\x16M"],"i"=>[0,"\x16N"],"j"=>[0,"\x16O"],"k"=>[0,"\x16P"],"l"=>[0,"\x16Q"],"m"=>[0,"\x16R"],"n"=>[0,"\x16S"],"o"=>[0,"\x16T"],"p"=>[0,"\x16U"],"q"=>[0,"\x16V"],"r"=>[0,"\x16W"],"s"=>[0,"\x16Y"],"t"=>[0,"\x16j"],"u"=>[0,"\x16k"],"v"=>[0,"\x16q"],"w"=>[0,"\x16v"],"x"=>[0,"\x16w"],"y"=>[0,"\x16x"],"z"=>[0,"\x16y"],"\x7B"=>[0,"\x16z"],"\x7C"=>[82,"\x16"],"\x7D"=>[87,"\x16"],"~"=>[130,"\x16"],"\x7F"=>[9,"\x16"],"\x80"=>[94,""],"\x81"=>[76,""],"\x82"=>[104,""],"\x83"=>[16,""],"\x84"=>[94,""],"\x85"=>[76,""],"\x86"=>[104,""],"\x87"=>[16,""],"\x88"=>[94,""],"\x89"=>[76,""],"\x8A"=>[104,""],"\x8B"=>[16,""],"\x8C"=>[94,""],"\x8D"=>[76,""],"\x8E"=>[104,""],"\x8F"=>[16,""],"\x90"=>[94,""],"\x91"=>[76,""],"\x92"=>[104,""],"\x93"=>[16,""],"\x94"=>[94,""],"\x95"=>[76,""],"\x96"=>[104,""],"\x97"=>[16,""],"\x98"=>[94,""],"\x99"=>[76,""],"\x9A"=>[104,""],"\x9B"=>[16,""],"\x9C"=>[94,""],"\x9D"=>[76,""],"\x9E"=>[104,""],"\x9F"=>[16,""],"\xA0"=>[94,""],"\xA1"=>[76,""],"\xA2"=>[104,""],"\xA3"=>[16,""],"\xA4"=>[94,""],"\xA5"=>[76,""],"\xA6"=>[104,""],"\xA7"=>[16,""],"\xA8"=>[77,""],"\xA9"=>[18,""],"\xAA"=>[77,""],"\xAB"=>[18,""],"\xAC"=>[77,""],"\xAD"=>[18,""],"\xAE"=>[77,""],"\xAF"=>[18,""],"\xB0"=>[77,""],"\xB1"=>[18,""],"\xB2"=>[77,""],"\xB3"=>[18,""],"\xB4"=>[77,""],"\xB5"=>[18,""],"\xB6"=>[77,""],"\xB7"=>[18,""],"\xB8"=>[77,""],"\xB9"=>[18,""],"\xBA"=>[77,""],"\xBB"=>[18,""],"\xBC"=>[77,""],"\xBD"=>[18,""],"\xBE"=>[77,""],"\xBF"=>[18,""],"\xC0"=>[77,""],"\xC1"=>[18,""],"\xC2"=>[77,""],"\xC3"=>[18,""],"\xC4"=>[77,""],"\xC5"=>[18,""],"\xC6"=>[77,""],"\xC7"=>[18,""],"\xC8"=>[77,""],"\xC9"=>[18,""],"\xCA"=>[77,""],"\xCB"=>[18,""],"\xCC"=>[77,""],"\xCD"=>[18,""],"\xCE"=>[77,""],"\xCF"=>[18,""],"\xD0"=>[77,""],"\xD1"=>[18,""],"\xD2"=>[77,""],"\xD3"=>[18,""],"\xD4"=>[77,""],"\xD5"=>[18,""],"\xD6"=>[77,""],"\xD7"=>[18,""],"\xD8"=>[77,""],"\xD9"=>[18,""],"\xDA"=>[77,""],"\xDB"=>[18,""],"\xDC"=>[0,""],"\xDD"=>[0,""],"\xDE"=>[0,""],"\xDF"=>[0,""],"\xE0"=>[0,""],"\xE1"=>[0,""],"\xE2"=>[0,""],"\xE3"=>[0,""],"\xE4"=>[0,""],"\xE5"=>[0,""],"\xE6"=>[0,""],"\xE7"=>[0,""],"\xE8"=>[0,""],"\xE9"=>[0,""],"\xEA"=>[0,""],"\xEB"=>[0,""],"\xEC"=>[0,""],"\xED"=>[0,""],"\xEE"=>[0,""],"\xEF"=>[0,""],"\xF0"=>[0,""],"\xF1"=>[0,""],"\xF2"=>[0,""],"\xF3"=>[0,""],"\xF4"=>[0,""],"\xF5"=>[0,""],"\xF6"=>[0,""],"\xF7"=>[0,""],"\xF8"=>[0,""],"\xF9"=>[0,""],"\xFA"=>[0,""],"\xFB"=>[0,""],"\xFC"=>[82,""],"\xFD"=>[87,""],"\xFE"=>[130,""],"\xFF"=>[9,""],],["\x00"=>[94,"\x180"],"\x01"=>[76,"\x180"],"\x02"=>[104,"\x180"],"\x03"=>[16,"\x180"],"\x04"=>[94,"\x181"],"\x05"=>[76,"\x181"],"\x06"=>[104,"\x181"],"\x07"=>[16,"\x181"],"\x08"=>[94,"\x182"],"\x09"=>[76,"\x182"],"\x0A"=>[104,"\x182"],"\x0B"=>[16,"\x182"],"\x0C"=>[94,"\x18a"],"\x0D"=>[76,"\x18a"],"\x0E"=>[104,"\x18a"],"\x0F"=>[16,"\x18a"],"\x10"=>[94,"\x18c"],"\x11"=>[76,"\x18c"],"\x12"=>[104,"\x18c"],"\x13"=>[16,"\x18c"],"\x14"=>[94,"\x18e"],"\x15"=>[76,"\x18e"],"\x16"=>[104,"\x18e"],"\x17"=>[16,"\x18e"],"\x18"=>[94,"\x18i"],"\x19"=>[76,"\x18i"],"\x1A"=>[104,"\x18i"],"\x1B"=>[16,"\x18i"],"\x1C"=>[94,"\x18o"],"\x1D"=>[76,"\x18o"],"\x1E"=>[104,"\x18o"],"\x1F"=>[16,"\x18o"],"\x20"=>[94,"\x18s"],"\x21"=>[76,"\x18s"],"\x22"=>[104,"\x18s"],"\x23"=>[16,"\x18s"],"\x24"=>[94,"\x18t"],"\x25"=>[76,"\x18t"],"\x26"=>[104,"\x18t"],"\x27"=>[16,"\x18t"],"\x28"=>[77,"\x18\x20"],"\x29"=>[18,"\x18\x20"],"\x2A"=>[77,"\x18\x25"],"\x2B"=>[18,"\x18\x25"],"\x2C"=>[77,"\x18-"],"-"=>[18,"\x18-"],"."=>[77,"\x18."],"\x2F"=>[18,"\x18."],[77,"\x18\x2F"],[18,"\x18\x2F"],[77,"\x183"],[18,"\x183"],[77,"\x184"],[18,"\x184"],[77,"\x185"],[18,"\x185"],[77,"\x186"],[18,"\x186"],"\x3A"=>[77,"\x187"],"\x3B"=>[18,"\x187"],"\x3C"=>[77,"\x188"],"\x3D"=>[18,"\x188"],"\x3E"=>[77,"\x189"],"\x3F"=>[18,"\x189"],"\x40"=>[77,"\x18\x3D"],"A"=>[18,"\x18\x3D"],"B"=>[77,"\x18A"],"C"=>[18,"\x18A"],"D"=>[77,"\x18_"],"E"=>[18,"\x18_"],"F"=>[77,"\x18b"],"G"=>[18,"\x18b"],"H"=>[77,"\x18d"],"I"=>[18,"\x18d"],"J"=>[77,"\x18f"],"K"=>[18,"\x18f"],"L"=>[77,"\x18g"],"M"=>[18,"\x18g"],"N"=>[77,"\x18h"],"O"=>[18,"\x18h"],"P"=>[77,"\x18l"],"Q"=>[18,"\x18l"],"R"=>[77,"\x18m"],"S"=>[18,"\x18m"],"T"=>[77,"\x18n"],"U"=>[18,"\x18n"],"V"=>[77,"\x18p"],"W"=>[18,"\x18p"],"X"=>[77,"\x18r"],"Y"=>[18,"\x18r"],"Z"=>[77,"\x18u"],"\x5B"=>[18,"\x18u"],"\x5C"=>[0,"\x18\x3A"],"\x5D"=>[0,"\x18B"],"\x5E"=>[0,"\x18C"],"_"=>[0,"\x18D"],"\x60"=>[0,"\x18E"],"a"=>[0,"\x18F"],"b"=>[0,"\x18G"],"c"=>[0,"\x18H"],"d"=>[0,"\x18I"],"e"=>[0,"\x18J"],"f"=>[0,"\x18K"],"g"=>[0,"\x18L"],"h"=>[0,"\x18M"],"i"=>[0,"\x18N"],"j"=>[0,"\x18O"],"k"=>[0,"\x18P"],"l"=>[0,"\x18Q"],"m"=>[0,"\x18R"],"n"=>[0,"\x18S"],"o"=>[0,"\x18T"],"p"=>[0,"\x18U"],"q"=>[0,"\x18V"],"r"=>[0,"\x18W"],"s"=>[0,"\x18Y"],"t"=>[0,"\x18j"],"u"=>[0,"\x18k"],"v"=>[0,"\x18q"],"w"=>[0,"\x18v"],"x"=>[0,"\x18w"],"y"=>[0,"\x18x"],"z"=>[0,"\x18y"],"\x7B"=>[0,"\x18z"],"\x7C"=>[82,"\x18"],"\x7D"=>[87,"\x18"],"~"=>[130,"\x18"],"\x7F"=>[9,"\x18"],"\x80"=>[94,"\x190"],"\x81"=>[76,"\x190"],"\x82"=>[104,"\x190"],"\x83"=>[16,"\x190"],"\x84"=>[94,"\x191"],"\x85"=>[76,"\x191"],"\x86"=>[104,"\x191"],"\x87"=>[16,"\x191"],"\x88"=>[94,"\x192"],"\x89"=>[76,"\x192"],"\x8A"=>[104,"\x192"],"\x8B"=>[16,"\x192"],"\x8C"=>[94,"\x19a"],"\x8D"=>[76,"\x19a"],"\x8E"=>[104,"\x19a"],"\x8F"=>[16,"\x19a"],"\x90"=>[94,"\x19c"],"\x91"=>[76,"\x19c"],"\x92"=>[104,"\x19c"],"\x93"=>[16,"\x19c"],"\x94"=>[94,"\x19e"],"\x95"=>[76,"\x19e"],"\x96"=>[104,"\x19e"],"\x97"=>[16,"\x19e"],"\x98"=>[94,"\x19i"],"\x99"=>[76,"\x19i"],"\x9A"=>[104,"\x19i"],"\x9B"=>[16,"\x19i"],"\x9C"=>[94,"\x19o"],"\x9D"=>[76,"\x19o"],"\x9E"=>[104,"\x19o"],"\x9F"=>[16,"\x19o"],"\xA0"=>[94,"\x19s"],"\xA1"=>[76,"\x19s"],"\xA2"=>[104,"\x19s"],"\xA3"=>[16,"\x19s"],"\xA4"=>[94,"\x19t"],"\xA5"=>[76,"\x19t"],"\xA6"=>[104,"\x19t"],"\xA7"=>[16,"\x19t"],"\xA8"=>[77,"\x19\x20"],"\xA9"=>[18,"\x19\x20"],"\xAA"=>[77,"\x19\x25"],"\xAB"=>[18,"\x19\x25"],"\xAC"=>[77,"\x19-"],"\xAD"=>[18,"\x19-"],"\xAE"=>[77,"\x19."],"\xAF"=>[18,"\x19."],"\xB0"=>[77,"\x19\x2F"],"\xB1"=>[18,"\x19\x2F"],"\xB2"=>[77,"\x193"],"\xB3"=>[18,"\x193"],"\xB4"=>[77,"\x194"],"\xB5"=>[18,"\x194"],"\xB6"=>[77,"\x195"],"\xB7"=>[18,"\x195"],"\xB8"=>[77,"\x196"],"\xB9"=>[18,"\x196"],"\xBA"=>[77,"\x197"],"\xBB"=>[18,"\x197"],"\xBC"=>[77,"\x198"],"\xBD"=>[18,"\x198"],"\xBE"=>[77,"\x199"],"\xBF"=>[18,"\x199"],"\xC0"=>[77,"\x19\x3D"],"\xC1"=>[18,"\x19\x3D"],"\xC2"=>[77,"\x19A"],"\xC3"=>[18,"\x19A"],"\xC4"=>[77,"\x19_"],"\xC5"=>[18,"\x19_"],"\xC6"=>[77,"\x19b"],"\xC7"=>[18,"\x19b"],"\xC8"=>[77,"\x19d"],"\xC9"=>[18,"\x19d"],"\xCA"=>[77,"\x19f"],"\xCB"=>[18,"\x19f"],"\xCC"=>[77,"\x19g"],"\xCD"=>[18,"\x19g"],"\xCE"=>[77,"\x19h"],"\xCF"=>[18,"\x19h"],"\xD0"=>[77,"\x19l"],"\xD1"=>[18,"\x19l"],"\xD2"=>[77,"\x19m"],"\xD3"=>[18,"\x19m"],"\xD4"=>[77,"\x19n"],"\xD5"=>[18,"\x19n"],"\xD6"=>[77,"\x19p"],"\xD7"=>[18,"\x19p"],"\xD8"=>[77,"\x19r"],"\xD9"=>[18,"\x19r"],"\xDA"=>[77,"\x19u"],"\xDB"=>[18,"\x19u"],"\xDC"=>[0,"\x19\x3A"],"\xDD"=>[0,"\x19B"],"\xDE"=>[0,"\x19C"],"\xDF"=>[0,"\x19D"],"\xE0"=>[0,"\x19E"],"\xE1"=>[0,"\x19F"],"\xE2"=>[0,"\x19G"],"\xE3"=>[0,"\x19H"],"\xE4"=>[0,"\x19I"],"\xE5"=>[0,"\x19J"],"\xE6"=>[0,"\x19K"],"\xE7"=>[0,"\x19L"],"\xE8"=>[0,"\x19M"],"\xE9"=>[0,"\x19N"],"\xEA"=>[0,"\x19O"],"\xEB"=>[0,"\x19P"],"\xEC"=>[0,"\x19Q"],"\xED"=>[0,"\x19R"],"\xEE"=>[0,"\x19S"],"\xEF"=>[0,"\x19T"],"\xF0"=>[0,"\x19U"],"\xF1"=>[0,"\x19V"],"\xF2"=>[0,"\x19W"],"\xF3"=>[0,"\x19Y"],"\xF4"=>[0,"\x19j"],"\xF5"=>[0,"\x19k"],"\xF6"=>[0,"\x19q"],"\xF7"=>[0,"\x19v"],"\xF8"=>[0,"\x19w"],"\xF9"=>[0,"\x19x"],"\xFA"=>[0,"\x19y"],"\xFB"=>[0,"\x19z"],"\xFC"=>[82,"\x19"],"\xFD"=>[87,"\x19"],"\xFE"=>[130,"\x19"],"\xFF"=>[9,"\x19"],],["\x00"=>[77,"\x180"],"\x01"=>[18,"\x180"],"\x02"=>[77,"\x181"],"\x03"=>[18,"\x181"],"\x04"=>[77,"\x182"],"\x05"=>[18,"\x182"],"\x06"=>[77,"\x18a"],"\x07"=>[18,"\x18a"],"\x08"=>[77,"\x18c"],"\x09"=>[18,"\x18c"],"\x0A"=>[77,"\x18e"],"\x0B"=>[18,"\x18e"],"\x0C"=>[77,"\x18i"],"\x0D"=>[18,"\x18i"],"\x0E"=>[77,"\x18o"],"\x0F"=>[18,"\x18o"],"\x10"=>[77,"\x18s"],"\x11"=>[18,"\x18s"],"\x12"=>[77,"\x18t"],"\x13"=>[18,"\x18t"],"\x14"=>[0,"\x18\x20"],"\x15"=>[0,"\x18\x25"],"\x16"=>[0,"\x18-"],"\x17"=>[0,"\x18."],"\x18"=>[0,"\x18\x2F"],"\x19"=>[0,"\x183"],"\x1A"=>[0,"\x184"],"\x1B"=>[0,"\x185"],"\x1C"=>[0,"\x186"],"\x1D"=>[0,"\x187"],"\x1E"=>[0,"\x188"],"\x1F"=>[0,"\x189"],"\x20"=>[0,"\x18\x3D"],"\x21"=>[0,"\x18A"],"\x22"=>[0,"\x18_"],"\x23"=>[0,"\x18b"],"\x24"=>[0,"\x18d"],"\x25"=>[0,"\x18f"],"\x26"=>[0,"\x18g"],"\x27"=>[0,"\x18h"],"\x28"=>[0,"\x18l"],"\x29"=>[0,"\x18m"],"\x2A"=>[0,"\x18n"],"\x2B"=>[0,"\x18p"],"\x2C"=>[0,"\x18r"],"-"=>[0,"\x18u"],"."=>[100,"\x18"],"\x2F"=>[110,"\x18"],[111,"\x18"],[115,"\x18"],[116,"\x18"],[118,"\x18"],[119,"\x18"],[122,"\x18"],[123,"\x18"],[125,"\x18"],[126,"\x18"],[129,"\x18"],"\x3A"=>[143,"\x18"],"\x3B"=>[148,"\x18"],"\x3C"=>[151,"\x18"],"\x3D"=>[153,"\x18"],"\x3E"=>[83,"\x18"],"\x3F"=>[10,"\x18"],"\x40"=>[77,"\x190"],"A"=>[18,"\x190"],"B"=>[77,"\x191"],"C"=>[18,"\x191"],"D"=>[77,"\x192"],"E"=>[18,"\x192"],"F"=>[77,"\x19a"],"G"=>[18,"\x19a"],"H"=>[77,"\x19c"],"I"=>[18,"\x19c"],"J"=>[77,"\x19e"],"K"=>[18,"\x19e"],"L"=>[77,"\x19i"],"M"=>[18,"\x19i"],"N"=>[77,"\x19o"],"O"=>[18,"\x19o"],"P"=>[77,"\x19s"],"Q"=>[18,"\x19s"],"R"=>[77,"\x19t"],"S"=>[18,"\x19t"],"T"=>[0,"\x19\x20"],"U"=>[0,"\x19\x25"],"V"=>[0,"\x19-"],"W"=>[0,"\x19."],"X"=>[0,"\x19\x2F"],"Y"=>[0,"\x193"],"Z"=>[0,"\x194"],"\x5B"=>[0,"\x195"],"\x5C"=>[0,"\x196"],"\x5D"=>[0,"\x197"],"\x5E"=>[0,"\x198"],"_"=>[0,"\x199"],"\x60"=>[0,"\x19\x3D"],"a"=>[0,"\x19A"],"b"=>[0,"\x19_"],"c"=>[0,"\x19b"],"d"=>[0,"\x19d"],"e"=>[0,"\x19f"],"f"=>[0,"\x19g"],"g"=>[0,"\x19h"],"h"=>[0,"\x19l"],"i"=>[0,"\x19m"],"j"=>[0,"\x19n"],"k"=>[0,"\x19p"],"l"=>[0,"\x19r"],"m"=>[0,"\x19u"],"n"=>[100,"\x19"],"o"=>[110,"\x19"],"p"=>[111,"\x19"],"q"=>[115,"\x19"],"r"=>[116,"\x19"],"s"=>[118,"\x19"],"t"=>[119,"\x19"],"u"=>[122,"\x19"],"v"=>[123,"\x19"],"w"=>[125,"\x19"],"x"=>[126,"\x19"],"y"=>[129,"\x19"],"z"=>[143,"\x19"],"\x7B"=>[148,"\x19"],"\x7C"=>[151,"\x19"],"\x7D"=>[153,"\x19"],"~"=>[83,"\x19"],"\x7F"=>[10,"\x19"],"\x80"=>[77,"\x1A0"],"\x81"=>[18,"\x1A0"],"\x82"=>[77,"\x1A1"],"\x83"=>[18,"\x1A1"],"\x84"=>[77,"\x1A2"],"\x85"=>[18,"\x1A2"],"\x86"=>[77,"\x1Aa"],"\x87"=>[18,"\x1Aa"],"\x88"=>[77,"\x1Ac"],"\x89"=>[18,"\x1Ac"],"\x8A"=>[77,"\x1Ae"],"\x8B"=>[18,"\x1Ae"],"\x8C"=>[77,"\x1Ai"],"\x8D"=>[18,"\x1Ai"],"\x8E"=>[77,"\x1Ao"],"\x8F"=>[18,"\x1Ao"],"\x90"=>[77,"\x1As"],"\x91"=>[18,"\x1As"],"\x92"=>[77,"\x1At"],"\x93"=>[18,"\x1At"],"\x94"=>[0,"\x1A\x20"],"\x95"=>[0,"\x1A\x25"],"\x96"=>[0,"\x1A-"],"\x97"=>[0,"\x1A."],"\x98"=>[0,"\x1A\x2F"],"\x99"=>[0,"\x1A3"],"\x9A"=>[0,"\x1A4"],"\x9B"=>[0,"\x1A5"],"\x9C"=>[0,"\x1A6"],"\x9D"=>[0,"\x1A7"],"\x9E"=>[0,"\x1A8"],"\x9F"=>[0,"\x1A9"],"\xA0"=>[0,"\x1A\x3D"],"\xA1"=>[0,"\x1AA"],"\xA2"=>[0,"\x1A_"],"\xA3"=>[0,"\x1Ab"],"\xA4"=>[0,"\x1Ad"],"\xA5"=>[0,"\x1Af"],"\xA6"=>[0,"\x1Ag"],"\xA7"=>[0,"\x1Ah"],"\xA8"=>[0,"\x1Al"],"\xA9"=>[0,"\x1Am"],"\xAA"=>[0,"\x1An"],"\xAB"=>[0,"\x1Ap"],"\xAC"=>[0,"\x1Ar"],"\xAD"=>[0,"\x1Au"],"\xAE"=>[100,"\x1A"],"\xAF"=>[110,"\x1A"],"\xB0"=>[111,"\x1A"],"\xB1"=>[115,"\x1A"],"\xB2"=>[116,"\x1A"],"\xB3"=>[118,"\x1A"],"\xB4"=>[119,"\x1A"],"\xB5"=>[122,"\x1A"],"\xB6"=>[123,"\x1A"],"\xB7"=>[125,"\x1A"],"\xB8"=>[126,"\x1A"],"\xB9"=>[129,"\x1A"],"\xBA"=>[143,"\x1A"],"\xBB"=>[148,"\x1A"],"\xBC"=>[151,"\x1A"],"\xBD"=>[153,"\x1A"],"\xBE"=>[83,"\x1A"],"\xBF"=>[10,"\x1A"],"\xC0"=>[77,"\x1B0"],"\xC1"=>[18,"\x1B0"],"\xC2"=>[77,"\x1B1"],"\xC3"=>[18,"\x1B1"],"\xC4"=>[77,"\x1B2"],"\xC5"=>[18,"\x1B2"],"\xC6"=>[77,"\x1Ba"],"\xC7"=>[18,"\x1Ba"],"\xC8"=>[77,"\x1Bc"],"\xC9"=>[18,"\x1Bc"],"\xCA"=>[77,"\x1Be"],"\xCB"=>[18,"\x1Be"],"\xCC"=>[77,"\x1Bi"],"\xCD"=>[18,"\x1Bi"],"\xCE"=>[77,"\x1Bo"],"\xCF"=>[18,"\x1Bo"],"\xD0"=>[77,"\x1Bs"],"\xD1"=>[18,"\x1Bs"],"\xD2"=>[77,"\x1Bt"],"\xD3"=>[18,"\x1Bt"],"\xD4"=>[0,"\x1B\x20"],"\xD5"=>[0,"\x1B\x25"],"\xD6"=>[0,"\x1B-"],"\xD7"=>[0,"\x1B."],"\xD8"=>[0,"\x1B\x2F"],"\xD9"=>[0,"\x1B3"],"\xDA"=>[0,"\x1B4"],"\xDB"=>[0,"\x1B5"],"\xDC"=>[0,"\x1B6"],"\xDD"=>[0,"\x1B7"],"\xDE"=>[0,"\x1B8"],"\xDF"=>[0,"\x1B9"],"\xE0"=>[0,"\x1B\x3D"],"\xE1"=>[0,"\x1BA"],"\xE2"=>[0,"\x1B_"],"\xE3"=>[0,"\x1Bb"],"\xE4"=>[0,"\x1Bd"],"\xE5"=>[0,"\x1Bf"],"\xE6"=>[0,"\x1Bg"],"\xE7"=>[0,"\x1Bh"],"\xE8"=>[0,"\x1Bl"],"\xE9"=>[0,"\x1Bm"],"\xEA"=>[0,"\x1Bn"],"\xEB"=>[0,"\x1Bp"],"\xEC"=>[0,"\x1Br"],"\xED"=>[0,"\x1Bu"],"\xEE"=>[100,"\x1B"],"\xEF"=>[110,"\x1B"],"\xF0"=>[111,"\x1B"],"\xF1"=>[115,"\x1B"],"\xF2"=>[116,"\x1B"],"\xF3"=>[118,"\x1B"],"\xF4"=>[119,"\x1B"],"\xF5"=>[122,"\x1B"],"\xF6"=>[123,"\x1B"],"\xF7"=>[125,"\x1B"],"\xF8"=>[126,"\x1B"],"\xF9"=>[129,"\x1B"],"\xFA"=>[143,"\x1B"],"\xFB"=>[148,"\x1B"],"\xFC"=>[151,"\x1B"],"\xFD"=>[153,"\x1B"],"\xFE"=>[83,"\x1B"],"\xFF"=>[10,"\x1B"],],["\x00"=>[94,"\x1A0"],"\x01"=>[76,"\x1A0"],"\x02"=>[104,"\x1A0"],"\x03"=>[16,"\x1A0"],"\x04"=>[94,"\x1A1"],"\x05"=>[76,"\x1A1"],"\x06"=>[104,"\x1A1"],"\x07"=>[16,"\x1A1"],"\x08"=>[94,"\x1A2"],"\x09"=>[76,"\x1A2"],"\x0A"=>[104,"\x1A2"],"\x0B"=>[16,"\x1A2"],"\x0C"=>[94,"\x1Aa"],"\x0D"=>[76,"\x1Aa"],"\x0E"=>[104,"\x1Aa"],"\x0F"=>[16,"\x1Aa"],"\x10"=>[94,"\x1Ac"],"\x11"=>[76,"\x1Ac"],"\x12"=>[104,"\x1Ac"],"\x13"=>[16,"\x1Ac"],"\x14"=>[94,"\x1Ae"],"\x15"=>[76,"\x1Ae"],"\x16"=>[104,"\x1Ae"],"\x17"=>[16,"\x1Ae"],"\x18"=>[94,"\x1Ai"],"\x19"=>[76,"\x1Ai"],"\x1A"=>[104,"\x1Ai"],"\x1B"=>[16,"\x1Ai"],"\x1C"=>[94,"\x1Ao"],"\x1D"=>[76,"\x1Ao"],"\x1E"=>[104,"\x1Ao"],"\x1F"=>[16,"\x1Ao"],"\x20"=>[94,"\x1As"],"\x21"=>[76,"\x1As"],"\x22"=>[104,"\x1As"],"\x23"=>[16,"\x1As"],"\x24"=>[94,"\x1At"],"\x25"=>[76,"\x1At"],"\x26"=>[104,"\x1At"],"\x27"=>[16,"\x1At"],"\x28"=>[77,"\x1A\x20"],"\x29"=>[18,"\x1A\x20"],"\x2A"=>[77,"\x1A\x25"],"\x2B"=>[18,"\x1A\x25"],"\x2C"=>[77,"\x1A-"],"-"=>[18,"\x1A-"],"."=>[77,"\x1A."],"\x2F"=>[18,"\x1A."],[77,"\x1A\x2F"],[18,"\x1A\x2F"],[77,"\x1A3"],[18,"\x1A3"],[77,"\x1A4"],[18,"\x1A4"],[77,"\x1A5"],[18,"\x1A5"],[77,"\x1A6"],[18,"\x1A6"],"\x3A"=>[77,"\x1A7"],"\x3B"=>[18,"\x1A7"],"\x3C"=>[77,"\x1A8"],"\x3D"=>[18,"\x1A8"],"\x3E"=>[77,"\x1A9"],"\x3F"=>[18,"\x1A9"],"\x40"=>[77,"\x1A\x3D"],"A"=>[18,"\x1A\x3D"],"B"=>[77,"\x1AA"],"C"=>[18,"\x1AA"],"D"=>[77,"\x1A_"],"E"=>[18,"\x1A_"],"F"=>[77,"\x1Ab"],"G"=>[18,"\x1Ab"],"H"=>[77,"\x1Ad"],"I"=>[18,"\x1Ad"],"J"=>[77,"\x1Af"],"K"=>[18,"\x1Af"],"L"=>[77,"\x1Ag"],"M"=>[18,"\x1Ag"],"N"=>[77,"\x1Ah"],"O"=>[18,"\x1Ah"],"P"=>[77,"\x1Al"],"Q"=>[18,"\x1Al"],"R"=>[77,"\x1Am"],"S"=>[18,"\x1Am"],"T"=>[77,"\x1An"],"U"=>[18,"\x1An"],"V"=>[77,"\x1Ap"],"W"=>[18,"\x1Ap"],"X"=>[77,"\x1Ar"],"Y"=>[18,"\x1Ar"],"Z"=>[77,"\x1Au"],"\x5B"=>[18,"\x1Au"],"\x5C"=>[0,"\x1A\x3A"],"\x5D"=>[0,"\x1AB"],"\x5E"=>[0,"\x1AC"],"_"=>[0,"\x1AD"],"\x60"=>[0,"\x1AE"],"a"=>[0,"\x1AF"],"b"=>[0,"\x1AG"],"c"=>[0,"\x1AH"],"d"=>[0,"\x1AI"],"e"=>[0,"\x1AJ"],"f"=>[0,"\x1AK"],"g"=>[0,"\x1AL"],"h"=>[0,"\x1AM"],"i"=>[0,"\x1AN"],"j"=>[0,"\x1AO"],"k"=>[0,"\x1AP"],"l"=>[0,"\x1AQ"],"m"=>[0,"\x1AR"],"n"=>[0,"\x1AS"],"o"=>[0,"\x1AT"],"p"=>[0,"\x1AU"],"q"=>[0,"\x1AV"],"r"=>[0,"\x1AW"],"s"=>[0,"\x1AY"],"t"=>[0,"\x1Aj"],"u"=>[0,"\x1Ak"],"v"=>[0,"\x1Aq"],"w"=>[0,"\x1Av"],"x"=>[0,"\x1Aw"],"y"=>[0,"\x1Ax"],"z"=>[0,"\x1Ay"],"\x7B"=>[0,"\x1Az"],"\x7C"=>[82,"\x1A"],"\x7D"=>[87,"\x1A"],"~"=>[130,"\x1A"],"\x7F"=>[9,"\x1A"],"\x80"=>[94,"\x1B0"],"\x81"=>[76,"\x1B0"],"\x82"=>[104,"\x1B0"],"\x83"=>[16,"\x1B0"],"\x84"=>[94,"\x1B1"],"\x85"=>[76,"\x1B1"],"\x86"=>[104,"\x1B1"],"\x87"=>[16,"\x1B1"],"\x88"=>[94,"\x1B2"],"\x89"=>[76,"\x1B2"],"\x8A"=>[104,"\x1B2"],"\x8B"=>[16,"\x1B2"],"\x8C"=>[94,"\x1Ba"],"\x8D"=>[76,"\x1Ba"],"\x8E"=>[104,"\x1Ba"],"\x8F"=>[16,"\x1Ba"],"\x90"=>[94,"\x1Bc"],"\x91"=>[76,"\x1Bc"],"\x92"=>[104,"\x1Bc"],"\x93"=>[16,"\x1Bc"],"\x94"=>[94,"\x1Be"],"\x95"=>[76,"\x1Be"],"\x96"=>[104,"\x1Be"],"\x97"=>[16,"\x1Be"],"\x98"=>[94,"\x1Bi"],"\x99"=>[76,"\x1Bi"],"\x9A"=>[104,"\x1Bi"],"\x9B"=>[16,"\x1Bi"],"\x9C"=>[94,"\x1Bo"],"\x9D"=>[76,"\x1Bo"],"\x9E"=>[104,"\x1Bo"],"\x9F"=>[16,"\x1Bo"],"\xA0"=>[94,"\x1Bs"],"\xA1"=>[76,"\x1Bs"],"\xA2"=>[104,"\x1Bs"],"\xA3"=>[16,"\x1Bs"],"\xA4"=>[94,"\x1Bt"],"\xA5"=>[76,"\x1Bt"],"\xA6"=>[104,"\x1Bt"],"\xA7"=>[16,"\x1Bt"],"\xA8"=>[77,"\x1B\x20"],"\xA9"=>[18,"\x1B\x20"],"\xAA"=>[77,"\x1B\x25"],"\xAB"=>[18,"\x1B\x25"],"\xAC"=>[77,"\x1B-"],"\xAD"=>[18,"\x1B-"],"\xAE"=>[77,"\x1B."],"\xAF"=>[18,"\x1B."],"\xB0"=>[77,"\x1B\x2F"],"\xB1"=>[18,"\x1B\x2F"],"\xB2"=>[77,"\x1B3"],"\xB3"=>[18,"\x1B3"],"\xB4"=>[77,"\x1B4"],"\xB5"=>[18,"\x1B4"],"\xB6"=>[77,"\x1B5"],"\xB7"=>[18,"\x1B5"],"\xB8"=>[77,"\x1B6"],"\xB9"=>[18,"\x1B6"],"\xBA"=>[77,"\x1B7"],"\xBB"=>[18,"\x1B7"],"\xBC"=>[77,"\x1B8"],"\xBD"=>[18,"\x1B8"],"\xBE"=>[77,"\x1B9"],"\xBF"=>[18,"\x1B9"],"\xC0"=>[77,"\x1B\x3D"],"\xC1"=>[18,"\x1B\x3D"],"\xC2"=>[77,"\x1BA"],"\xC3"=>[18,"\x1BA"],"\xC4"=>[77,"\x1B_"],"\xC5"=>[18,"\x1B_"],"\xC6"=>[77,"\x1Bb"],"\xC7"=>[18,"\x1Bb"],"\xC8"=>[77,"\x1Bd"],"\xC9"=>[18,"\x1Bd"],"\xCA"=>[77,"\x1Bf"],"\xCB"=>[18,"\x1Bf"],"\xCC"=>[77,"\x1Bg"],"\xCD"=>[18,"\x1Bg"],"\xCE"=>[77,"\x1Bh"],"\xCF"=>[18,"\x1Bh"],"\xD0"=>[77,"\x1Bl"],"\xD1"=>[18,"\x1Bl"],"\xD2"=>[77,"\x1Bm"],"\xD3"=>[18,"\x1Bm"],"\xD4"=>[77,"\x1Bn"],"\xD5"=>[18,"\x1Bn"],"\xD6"=>[77,"\x1Bp"],"\xD7"=>[18,"\x1Bp"],"\xD8"=>[77,"\x1Br"],"\xD9"=>[18,"\x1Br"],"\xDA"=>[77,"\x1Bu"],"\xDB"=>[18,"\x1Bu"],"\xDC"=>[0,"\x1B\x3A"],"\xDD"=>[0,"\x1BB"],"\xDE"=>[0,"\x1BC"],"\xDF"=>[0,"\x1BD"],"\xE0"=>[0,"\x1BE"],"\xE1"=>[0,"\x1BF"],"\xE2"=>[0,"\x1BG"],"\xE3"=>[0,"\x1BH"],"\xE4"=>[0,"\x1BI"],"\xE5"=>[0,"\x1BJ"],"\xE6"=>[0,"\x1BK"],"\xE7"=>[0,"\x1BL"],"\xE8"=>[0,"\x1BM"],"\xE9"=>[0,"\x1BN"],"\xEA"=>[0,"\x1BO"],"\xEB"=>[0,"\x1BP"],"\xEC"=>[0,"\x1BQ"],"\xED"=>[0,"\x1BR"],"\xEE"=>[0,"\x1BS"],"\xEF"=>[0,"\x1BT"],"\xF0"=>[0,"\x1BU"],"\xF1"=>[0,"\x1BV"],"\xF2"=>[0,"\x1BW"],"\xF3"=>[0,"\x1BY"],"\xF4"=>[0,"\x1Bj"],"\xF5"=>[0,"\x1Bk"],"\xF6"=>[0,"\x1Bq"],"\xF7"=>[0,"\x1Bv"],"\xF8"=>[0,"\x1Bw"],"\xF9"=>[0,"\x1Bx"],"\xFA"=>[0,"\x1By"],"\xFB"=>[0,"\x1Bz"],"\xFC"=>[82,"\x1B"],"\xFD"=>[87,"\x1B"],"\xFE"=>[130,"\x1B"],"\xFF"=>[9,"\x1B"],],["\x00"=>[94,"\x1C0"],"\x01"=>[76,"\x1C0"],"\x02"=>[104,"\x1C0"],"\x03"=>[16,"\x1C0"],"\x04"=>[94,"\x1C1"],"\x05"=>[76,"\x1C1"],"\x06"=>[104,"\x1C1"],"\x07"=>[16,"\x1C1"],"\x08"=>[94,"\x1C2"],"\x09"=>[76,"\x1C2"],"\x0A"=>[104,"\x1C2"],"\x0B"=>[16,"\x1C2"],"\x0C"=>[94,"\x1Ca"],"\x0D"=>[76,"\x1Ca"],"\x0E"=>[104,"\x1Ca"],"\x0F"=>[16,"\x1Ca"],"\x10"=>[94,"\x1Cc"],"\x11"=>[76,"\x1Cc"],"\x12"=>[104,"\x1Cc"],"\x13"=>[16,"\x1Cc"],"\x14"=>[94,"\x1Ce"],"\x15"=>[76,"\x1Ce"],"\x16"=>[104,"\x1Ce"],"\x17"=>[16,"\x1Ce"],"\x18"=>[94,"\x1Ci"],"\x19"=>[76,"\x1Ci"],"\x1A"=>[104,"\x1Ci"],"\x1B"=>[16,"\x1Ci"],"\x1C"=>[94,"\x1Co"],"\x1D"=>[76,"\x1Co"],"\x1E"=>[104,"\x1Co"],"\x1F"=>[16,"\x1Co"],"\x20"=>[94,"\x1Cs"],"\x21"=>[76,"\x1Cs"],"\x22"=>[104,"\x1Cs"],"\x23"=>[16,"\x1Cs"],"\x24"=>[94,"\x1Ct"],"\x25"=>[76,"\x1Ct"],"\x26"=>[104,"\x1Ct"],"\x27"=>[16,"\x1Ct"],"\x28"=>[77,"\x1C\x20"],"\x29"=>[18,"\x1C\x20"],"\x2A"=>[77,"\x1C\x25"],"\x2B"=>[18,"\x1C\x25"],"\x2C"=>[77,"\x1C-"],"-"=>[18,"\x1C-"],"."=>[77,"\x1C."],"\x2F"=>[18,"\x1C."],[77,"\x1C\x2F"],[18,"\x1C\x2F"],[77,"\x1C3"],[18,"\x1C3"],[77,"\x1C4"],[18,"\x1C4"],[77,"\x1C5"],[18,"\x1C5"],[77,"\x1C6"],[18,"\x1C6"],"\x3A"=>[77,"\x1C7"],"\x3B"=>[18,"\x1C7"],"\x3C"=>[77,"\x1C8"],"\x3D"=>[18,"\x1C8"],"\x3E"=>[77,"\x1C9"],"\x3F"=>[18,"\x1C9"],"\x40"=>[77,"\x1C\x3D"],"A"=>[18,"\x1C\x3D"],"B"=>[77,"\x1CA"],"C"=>[18,"\x1CA"],"D"=>[77,"\x1C_"],"E"=>[18,"\x1C_"],"F"=>[77,"\x1Cb"],"G"=>[18,"\x1Cb"],"H"=>[77,"\x1Cd"],"I"=>[18,"\x1Cd"],"J"=>[77,"\x1Cf"],"K"=>[18,"\x1Cf"],"L"=>[77,"\x1Cg"],"M"=>[18,"\x1Cg"],"N"=>[77,"\x1Ch"],"O"=>[18,"\x1Ch"],"P"=>[77,"\x1Cl"],"Q"=>[18,"\x1Cl"],"R"=>[77,"\x1Cm"],"S"=>[18,"\x1Cm"],"T"=>[77,"\x1Cn"],"U"=>[18,"\x1Cn"],"V"=>[77,"\x1Cp"],"W"=>[18,"\x1Cp"],"X"=>[77,"\x1Cr"],"Y"=>[18,"\x1Cr"],"Z"=>[77,"\x1Cu"],"\x5B"=>[18,"\x1Cu"],"\x5C"=>[0,"\x1C\x3A"],"\x5D"=>[0,"\x1CB"],"\x5E"=>[0,"\x1CC"],"_"=>[0,"\x1CD"],"\x60"=>[0,"\x1CE"],"a"=>[0,"\x1CF"],"b"=>[0,"\x1CG"],"c"=>[0,"\x1CH"],"d"=>[0,"\x1CI"],"e"=>[0,"\x1CJ"],"f"=>[0,"\x1CK"],"g"=>[0,"\x1CL"],"h"=>[0,"\x1CM"],"i"=>[0,"\x1CN"],"j"=>[0,"\x1CO"],"k"=>[0,"\x1CP"],"l"=>[0,"\x1CQ"],"m"=>[0,"\x1CR"],"n"=>[0,"\x1CS"],"o"=>[0,"\x1CT"],"p"=>[0,"\x1CU"],"q"=>[0,"\x1CV"],"r"=>[0,"\x1CW"],"s"=>[0,"\x1CY"],"t"=>[0,"\x1Cj"],"u"=>[0,"\x1Ck"],"v"=>[0,"\x1Cq"],"w"=>[0,"\x1Cv"],"x"=>[0,"\x1Cw"],"y"=>[0,"\x1Cx"],"z"=>[0,"\x1Cy"],"\x7B"=>[0,"\x1Cz"],"\x7C"=>[82,"\x1C"],"\x7D"=>[87,"\x1C"],"~"=>[130,"\x1C"],"\x7F"=>[9,"\x1C"],"\x80"=>[94,"\x1D0"],"\x81"=>[76,"\x1D0"],"\x82"=>[104,"\x1D0"],"\x83"=>[16,"\x1D0"],"\x84"=>[94,"\x1D1"],"\x85"=>[76,"\x1D1"],"\x86"=>[104,"\x1D1"],"\x87"=>[16,"\x1D1"],"\x88"=>[94,"\x1D2"],"\x89"=>[76,"\x1D2"],"\x8A"=>[104,"\x1D2"],"\x8B"=>[16,"\x1D2"],"\x8C"=>[94,"\x1Da"],"\x8D"=>[76,"\x1Da"],"\x8E"=>[104,"\x1Da"],"\x8F"=>[16,"\x1Da"],"\x90"=>[94,"\x1Dc"],"\x91"=>[76,"\x1Dc"],"\x92"=>[104,"\x1Dc"],"\x93"=>[16,"\x1Dc"],"\x94"=>[94,"\x1De"],"\x95"=>[76,"\x1De"],"\x96"=>[104,"\x1De"],"\x97"=>[16,"\x1De"],"\x98"=>[94,"\x1Di"],"\x99"=>[76,"\x1Di"],"\x9A"=>[104,"\x1Di"],"\x9B"=>[16,"\x1Di"],"\x9C"=>[94,"\x1Do"],"\x9D"=>[76,"\x1Do"],"\x9E"=>[104,"\x1Do"],"\x9F"=>[16,"\x1Do"],"\xA0"=>[94,"\x1Ds"],"\xA1"=>[76,"\x1Ds"],"\xA2"=>[104,"\x1Ds"],"\xA3"=>[16,"\x1Ds"],"\xA4"=>[94,"\x1Dt"],"\xA5"=>[76,"\x1Dt"],"\xA6"=>[104,"\x1Dt"],"\xA7"=>[16,"\x1Dt"],"\xA8"=>[77,"\x1D\x20"],"\xA9"=>[18,"\x1D\x20"],"\xAA"=>[77,"\x1D\x25"],"\xAB"=>[18,"\x1D\x25"],"\xAC"=>[77,"\x1D-"],"\xAD"=>[18,"\x1D-"],"\xAE"=>[77,"\x1D."],"\xAF"=>[18,"\x1D."],"\xB0"=>[77,"\x1D\x2F"],"\xB1"=>[18,"\x1D\x2F"],"\xB2"=>[77,"\x1D3"],"\xB3"=>[18,"\x1D3"],"\xB4"=>[77,"\x1D4"],"\xB5"=>[18,"\x1D4"],"\xB6"=>[77,"\x1D5"],"\xB7"=>[18,"\x1D5"],"\xB8"=>[77,"\x1D6"],"\xB9"=>[18,"\x1D6"],"\xBA"=>[77,"\x1D7"],"\xBB"=>[18,"\x1D7"],"\xBC"=>[77,"\x1D8"],"\xBD"=>[18,"\x1D8"],"\xBE"=>[77,"\x1D9"],"\xBF"=>[18,"\x1D9"],"\xC0"=>[77,"\x1D\x3D"],"\xC1"=>[18,"\x1D\x3D"],"\xC2"=>[77,"\x1DA"],"\xC3"=>[18,"\x1DA"],"\xC4"=>[77,"\x1D_"],"\xC5"=>[18,"\x1D_"],"\xC6"=>[77,"\x1Db"],"\xC7"=>[18,"\x1Db"],"\xC8"=>[77,"\x1Dd"],"\xC9"=>[18,"\x1Dd"],"\xCA"=>[77,"\x1Df"],"\xCB"=>[18,"\x1Df"],"\xCC"=>[77,"\x1Dg"],"\xCD"=>[18,"\x1Dg"],"\xCE"=>[77,"\x1Dh"],"\xCF"=>[18,"\x1Dh"],"\xD0"=>[77,"\x1Dl"],"\xD1"=>[18,"\x1Dl"],"\xD2"=>[77,"\x1Dm"],"\xD3"=>[18,"\x1Dm"],"\xD4"=>[77,"\x1Dn"],"\xD5"=>[18,"\x1Dn"],"\xD6"=>[77,"\x1Dp"],"\xD7"=>[18,"\x1Dp"],"\xD8"=>[77,"\x1Dr"],"\xD9"=>[18,"\x1Dr"],"\xDA"=>[77,"\x1Du"],"\xDB"=>[18,"\x1Du"],"\xDC"=>[0,"\x1D\x3A"],"\xDD"=>[0,"\x1DB"],"\xDE"=>[0,"\x1DC"],"\xDF"=>[0,"\x1DD"],"\xE0"=>[0,"\x1DE"],"\xE1"=>[0,"\x1DF"],"\xE2"=>[0,"\x1DG"],"\xE3"=>[0,"\x1DH"],"\xE4"=>[0,"\x1DI"],"\xE5"=>[0,"\x1DJ"],"\xE6"=>[0,"\x1DK"],"\xE7"=>[0,"\x1DL"],"\xE8"=>[0,"\x1DM"],"\xE9"=>[0,"\x1DN"],"\xEA"=>[0,"\x1DO"],"\xEB"=>[0,"\x1DP"],"\xEC"=>[0,"\x1DQ"],"\xED"=>[0,"\x1DR"],"\xEE"=>[0,"\x1DS"],"\xEF"=>[0,"\x1DT"],"\xF0"=>[0,"\x1DU"],"\xF1"=>[0,"\x1DV"],"\xF2"=>[0,"\x1DW"],"\xF3"=>[0,"\x1DY"],"\xF4"=>[0,"\x1Dj"],"\xF5"=>[0,"\x1Dk"],"\xF6"=>[0,"\x1Dq"],"\xF7"=>[0,"\x1Dv"],"\xF8"=>[0,"\x1Dw"],"\xF9"=>[0,"\x1Dx"],"\xFA"=>[0,"\x1Dy"],"\xFB"=>[0,"\x1Dz"],"\xFC"=>[82,"\x1D"],"\xFD"=>[87,"\x1D"],"\xFE"=>[130,"\x1D"],"\xFF"=>[9,"\x1D"],],["\x00"=>[77,"\x1C0"],"\x01"=>[18,"\x1C0"],"\x02"=>[77,"\x1C1"],"\x03"=>[18,"\x1C1"],"\x04"=>[77,"\x1C2"],"\x05"=>[18,"\x1C2"],"\x06"=>[77,"\x1Ca"],"\x07"=>[18,"\x1Ca"],"\x08"=>[77,"\x1Cc"],"\x09"=>[18,"\x1Cc"],"\x0A"=>[77,"\x1Ce"],"\x0B"=>[18,"\x1Ce"],"\x0C"=>[77,"\x1Ci"],"\x0D"=>[18,"\x1Ci"],"\x0E"=>[77,"\x1Co"],"\x0F"=>[18,"\x1Co"],"\x10"=>[77,"\x1Cs"],"\x11"=>[18,"\x1Cs"],"\x12"=>[77,"\x1Ct"],"\x13"=>[18,"\x1Ct"],"\x14"=>[0,"\x1C\x20"],"\x15"=>[0,"\x1C\x25"],"\x16"=>[0,"\x1C-"],"\x17"=>[0,"\x1C."],"\x18"=>[0,"\x1C\x2F"],"\x19"=>[0,"\x1C3"],"\x1A"=>[0,"\x1C4"],"\x1B"=>[0,"\x1C5"],"\x1C"=>[0,"\x1C6"],"\x1D"=>[0,"\x1C7"],"\x1E"=>[0,"\x1C8"],"\x1F"=>[0,"\x1C9"],"\x20"=>[0,"\x1C\x3D"],"\x21"=>[0,"\x1CA"],"\x22"=>[0,"\x1C_"],"\x23"=>[0,"\x1Cb"],"\x24"=>[0,"\x1Cd"],"\x25"=>[0,"\x1Cf"],"\x26"=>[0,"\x1Cg"],"\x27"=>[0,"\x1Ch"],"\x28"=>[0,"\x1Cl"],"\x29"=>[0,"\x1Cm"],"\x2A"=>[0,"\x1Cn"],"\x2B"=>[0,"\x1Cp"],"\x2C"=>[0,"\x1Cr"],"-"=>[0,"\x1Cu"],"."=>[100,"\x1C"],"\x2F"=>[110,"\x1C"],[111,"\x1C"],[115,"\x1C"],[116,"\x1C"],[118,"\x1C"],[119,"\x1C"],[122,"\x1C"],[123,"\x1C"],[125,"\x1C"],[126,"\x1C"],[129,"\x1C"],"\x3A"=>[143,"\x1C"],"\x3B"=>[148,"\x1C"],"\x3C"=>[151,"\x1C"],"\x3D"=>[153,"\x1C"],"\x3E"=>[83,"\x1C"],"\x3F"=>[10,"\x1C"],"\x40"=>[77,"\x1D0"],"A"=>[18,"\x1D0"],"B"=>[77,"\x1D1"],"C"=>[18,"\x1D1"],"D"=>[77,"\x1D2"],"E"=>[18,"\x1D2"],"F"=>[77,"\x1Da"],"G"=>[18,"\x1Da"],"H"=>[77,"\x1Dc"],"I"=>[18,"\x1Dc"],"J"=>[77,"\x1De"],"K"=>[18,"\x1De"],"L"=>[77,"\x1Di"],"M"=>[18,"\x1Di"],"N"=>[77,"\x1Do"],"O"=>[18,"\x1Do"],"P"=>[77,"\x1Ds"],"Q"=>[18,"\x1Ds"],"R"=>[77,"\x1Dt"],"S"=>[18,"\x1Dt"],"T"=>[0,"\x1D\x20"],"U"=>[0,"\x1D\x25"],"V"=>[0,"\x1D-"],"W"=>[0,"\x1D."],"X"=>[0,"\x1D\x2F"],"Y"=>[0,"\x1D3"],"Z"=>[0,"\x1D4"],"\x5B"=>[0,"\x1D5"],"\x5C"=>[0,"\x1D6"],"\x5D"=>[0,"\x1D7"],"\x5E"=>[0,"\x1D8"],"_"=>[0,"\x1D9"],"\x60"=>[0,"\x1D\x3D"],"a"=>[0,"\x1DA"],"b"=>[0,"\x1D_"],"c"=>[0,"\x1Db"],"d"=>[0,"\x1Dd"],"e"=>[0,"\x1Df"],"f"=>[0,"\x1Dg"],"g"=>[0,"\x1Dh"],"h"=>[0,"\x1Dl"],"i"=>[0,"\x1Dm"],"j"=>[0,"\x1Dn"],"k"=>[0,"\x1Dp"],"l"=>[0,"\x1Dr"],"m"=>[0,"\x1Du"],"n"=>[100,"\x1D"],"o"=>[110,"\x1D"],"p"=>[111,"\x1D"],"q"=>[115,"\x1D"],"r"=>[116,"\x1D"],"s"=>[118,"\x1D"],"t"=>[119,"\x1D"],"u"=>[122,"\x1D"],"v"=>[123,"\x1D"],"w"=>[125,"\x1D"],"x"=>[126,"\x1D"],"y"=>[129,"\x1D"],"z"=>[143,"\x1D"],"\x7B"=>[148,"\x1D"],"\x7C"=>[151,"\x1D"],"\x7D"=>[153,"\x1D"],"~"=>[83,"\x1D"],"\x7F"=>[10,"\x1D"],"\x80"=>[77,"\x1E0"],"\x81"=>[18,"\x1E0"],"\x82"=>[77,"\x1E1"],"\x83"=>[18,"\x1E1"],"\x84"=>[77,"\x1E2"],"\x85"=>[18,"\x1E2"],"\x86"=>[77,"\x1Ea"],"\x87"=>[18,"\x1Ea"],"\x88"=>[77,"\x1Ec"],"\x89"=>[18,"\x1Ec"],"\x8A"=>[77,"\x1Ee"],"\x8B"=>[18,"\x1Ee"],"\x8C"=>[77,"\x1Ei"],"\x8D"=>[18,"\x1Ei"],"\x8E"=>[77,"\x1Eo"],"\x8F"=>[18,"\x1Eo"],"\x90"=>[77,"\x1Es"],"\x91"=>[18,"\x1Es"],"\x92"=>[77,"\x1Et"],"\x93"=>[18,"\x1Et"],"\x94"=>[0,"\x1E\x20"],"\x95"=>[0,"\x1E\x25"],"\x96"=>[0,"\x1E-"],"\x97"=>[0,"\x1E."],"\x98"=>[0,"\x1E\x2F"],"\x99"=>[0,"\x1E3"],"\x9A"=>[0,"\x1E4"],"\x9B"=>[0,"\x1E5"],"\x9C"=>[0,"\x1E6"],"\x9D"=>[0,"\x1E7"],"\x9E"=>[0,"\x1E8"],"\x9F"=>[0,"\x1E9"],"\xA0"=>[0,"\x1E\x3D"],"\xA1"=>[0,"\x1EA"],"\xA2"=>[0,"\x1E_"],"\xA3"=>[0,"\x1Eb"],"\xA4"=>[0,"\x1Ed"],"\xA5"=>[0,"\x1Ef"],"\xA6"=>[0,"\x1Eg"],"\xA7"=>[0,"\x1Eh"],"\xA8"=>[0,"\x1El"],"\xA9"=>[0,"\x1Em"],"\xAA"=>[0,"\x1En"],"\xAB"=>[0,"\x1Ep"],"\xAC"=>[0,"\x1Er"],"\xAD"=>[0,"\x1Eu"],"\xAE"=>[100,"\x1E"],"\xAF"=>[110,"\x1E"],"\xB0"=>[111,"\x1E"],"\xB1"=>[115,"\x1E"],"\xB2"=>[116,"\x1E"],"\xB3"=>[118,"\x1E"],"\xB4"=>[119,"\x1E"],"\xB5"=>[122,"\x1E"],"\xB6"=>[123,"\x1E"],"\xB7"=>[125,"\x1E"],"\xB8"=>[126,"\x1E"],"\xB9"=>[129,"\x1E"],"\xBA"=>[143,"\x1E"],"\xBB"=>[148,"\x1E"],"\xBC"=>[151,"\x1E"],"\xBD"=>[153,"\x1E"],"\xBE"=>[83,"\x1E"],"\xBF"=>[10,"\x1E"],"\xC0"=>[77,"\x1F0"],"\xC1"=>[18,"\x1F0"],"\xC2"=>[77,"\x1F1"],"\xC3"=>[18,"\x1F1"],"\xC4"=>[77,"\x1F2"],"\xC5"=>[18,"\x1F2"],"\xC6"=>[77,"\x1Fa"],"\xC7"=>[18,"\x1Fa"],"\xC8"=>[77,"\x1Fc"],"\xC9"=>[18,"\x1Fc"],"\xCA"=>[77,"\x1Fe"],"\xCB"=>[18,"\x1Fe"],"\xCC"=>[77,"\x1Fi"],"\xCD"=>[18,"\x1Fi"],"\xCE"=>[77,"\x1Fo"],"\xCF"=>[18,"\x1Fo"],"\xD0"=>[77,"\x1Fs"],"\xD1"=>[18,"\x1Fs"],"\xD2"=>[77,"\x1Ft"],"\xD3"=>[18,"\x1Ft"],"\xD4"=>[0,"\x1F\x20"],"\xD5"=>[0,"\x1F\x25"],"\xD6"=>[0,"\x1F-"],"\xD7"=>[0,"\x1F."],"\xD8"=>[0,"\x1F\x2F"],"\xD9"=>[0,"\x1F3"],"\xDA"=>[0,"\x1F4"],"\xDB"=>[0,"\x1F5"],"\xDC"=>[0,"\x1F6"],"\xDD"=>[0,"\x1F7"],"\xDE"=>[0,"\x1F8"],"\xDF"=>[0,"\x1F9"],"\xE0"=>[0,"\x1F\x3D"],"\xE1"=>[0,"\x1FA"],"\xE2"=>[0,"\x1F_"],"\xE3"=>[0,"\x1Fb"],"\xE4"=>[0,"\x1Fd"],"\xE5"=>[0,"\x1Ff"],"\xE6"=>[0,"\x1Fg"],"\xE7"=>[0,"\x1Fh"],"\xE8"=>[0,"\x1Fl"],"\xE9"=>[0,"\x1Fm"],"\xEA"=>[0,"\x1Fn"],"\xEB"=>[0,"\x1Fp"],"\xEC"=>[0,"\x1Fr"],"\xED"=>[0,"\x1Fu"],"\xEE"=>[100,"\x1F"],"\xEF"=>[110,"\x1F"],"\xF0"=>[111,"\x1F"],"\xF1"=>[115,"\x1F"],"\xF2"=>[116,"\x1F"],"\xF3"=>[118,"\x1F"],"\xF4"=>[119,"\x1F"],"\xF5"=>[122,"\x1F"],"\xF6"=>[123,"\x1F"],"\xF7"=>[125,"\x1F"],"\xF8"=>[126,"\x1F"],"\xF9"=>[129,"\x1F"],"\xFA"=>[143,"\x1F"],"\xFB"=>[148,"\x1F"],"\xFC"=>[151,"\x1F"],"\xFD"=>[153,"\x1F"],"\xFE"=>[83,"\x1F"],"\xFF"=>[10,"\x1F"],],["\x00"=>[94,"\x1E0"],"\x01"=>[76,"\x1E0"],"\x02"=>[104,"\x1E0"],"\x03"=>[16,"\x1E0"],"\x04"=>[94,"\x1E1"],"\x05"=>[76,"\x1E1"],"\x06"=>[104,"\x1E1"],"\x07"=>[16,"\x1E1"],"\x08"=>[94,"\x1E2"],"\x09"=>[76,"\x1E2"],"\x0A"=>[104,"\x1E2"],"\x0B"=>[16,"\x1E2"],"\x0C"=>[94,"\x1Ea"],"\x0D"=>[76,"\x1Ea"],"\x0E"=>[104,"\x1Ea"],"\x0F"=>[16,"\x1Ea"],"\x10"=>[94,"\x1Ec"],"\x11"=>[76,"\x1Ec"],"\x12"=>[104,"\x1Ec"],"\x13"=>[16,"\x1Ec"],"\x14"=>[94,"\x1Ee"],"\x15"=>[76,"\x1Ee"],"\x16"=>[104,"\x1Ee"],"\x17"=>[16,"\x1Ee"],"\x18"=>[94,"\x1Ei"],"\x19"=>[76,"\x1Ei"],"\x1A"=>[104,"\x1Ei"],"\x1B"=>[16,"\x1Ei"],"\x1C"=>[94,"\x1Eo"],"\x1D"=>[76,"\x1Eo"],"\x1E"=>[104,"\x1Eo"],"\x1F"=>[16,"\x1Eo"],"\x20"=>[94,"\x1Es"],"\x21"=>[76,"\x1Es"],"\x22"=>[104,"\x1Es"],"\x23"=>[16,"\x1Es"],"\x24"=>[94,"\x1Et"],"\x25"=>[76,"\x1Et"],"\x26"=>[104,"\x1Et"],"\x27"=>[16,"\x1Et"],"\x28"=>[77,"\x1E\x20"],"\x29"=>[18,"\x1E\x20"],"\x2A"=>[77,"\x1E\x25"],"\x2B"=>[18,"\x1E\x25"],"\x2C"=>[77,"\x1E-"],"-"=>[18,"\x1E-"],"."=>[77,"\x1E."],"\x2F"=>[18,"\x1E."],[77,"\x1E\x2F"],[18,"\x1E\x2F"],[77,"\x1E3"],[18,"\x1E3"],[77,"\x1E4"],[18,"\x1E4"],[77,"\x1E5"],[18,"\x1E5"],[77,"\x1E6"],[18,"\x1E6"],"\x3A"=>[77,"\x1E7"],"\x3B"=>[18,"\x1E7"],"\x3C"=>[77,"\x1E8"],"\x3D"=>[18,"\x1E8"],"\x3E"=>[77,"\x1E9"],"\x3F"=>[18,"\x1E9"],"\x40"=>[77,"\x1E\x3D"],"A"=>[18,"\x1E\x3D"],"B"=>[77,"\x1EA"],"C"=>[18,"\x1EA"],"D"=>[77,"\x1E_"],"E"=>[18,"\x1E_"],"F"=>[77,"\x1Eb"],"G"=>[18,"\x1Eb"],"H"=>[77,"\x1Ed"],"I"=>[18,"\x1Ed"],"J"=>[77,"\x1Ef"],"K"=>[18,"\x1Ef"],"L"=>[77,"\x1Eg"],"M"=>[18,"\x1Eg"],"N"=>[77,"\x1Eh"],"O"=>[18,"\x1Eh"],"P"=>[77,"\x1El"],"Q"=>[18,"\x1El"],"R"=>[77,"\x1Em"],"S"=>[18,"\x1Em"],"T"=>[77,"\x1En"],"U"=>[18,"\x1En"],"V"=>[77,"\x1Ep"],"W"=>[18,"\x1Ep"],"X"=>[77,"\x1Er"],"Y"=>[18,"\x1Er"],"Z"=>[77,"\x1Eu"],"\x5B"=>[18,"\x1Eu"],"\x5C"=>[0,"\x1E\x3A"],"\x5D"=>[0,"\x1EB"],"\x5E"=>[0,"\x1EC"],"_"=>[0,"\x1ED"],"\x60"=>[0,"\x1EE"],"a"=>[0,"\x1EF"],"b"=>[0,"\x1EG"],"c"=>[0,"\x1EH"],"d"=>[0,"\x1EI"],"e"=>[0,"\x1EJ"],"f"=>[0,"\x1EK"],"g"=>[0,"\x1EL"],"h"=>[0,"\x1EM"],"i"=>[0,"\x1EN"],"j"=>[0,"\x1EO"],"k"=>[0,"\x1EP"],"l"=>[0,"\x1EQ"],"m"=>[0,"\x1ER"],"n"=>[0,"\x1ES"],"o"=>[0,"\x1ET"],"p"=>[0,"\x1EU"],"q"=>[0,"\x1EV"],"r"=>[0,"\x1EW"],"s"=>[0,"\x1EY"],"t"=>[0,"\x1Ej"],"u"=>[0,"\x1Ek"],"v"=>[0,"\x1Eq"],"w"=>[0,"\x1Ev"],"x"=>[0,"\x1Ew"],"y"=>[0,"\x1Ex"],"z"=>[0,"\x1Ey"],"\x7B"=>[0,"\x1Ez"],"\x7C"=>[82,"\x1E"],"\x7D"=>[87,"\x1E"],"~"=>[130,"\x1E"],"\x7F"=>[9,"\x1E"],"\x80"=>[94,"\x1F0"],"\x81"=>[76,"\x1F0"],"\x82"=>[104,"\x1F0"],"\x83"=>[16,"\x1F0"],"\x84"=>[94,"\x1F1"],"\x85"=>[76,"\x1F1"],"\x86"=>[104,"\x1F1"],"\x87"=>[16,"\x1F1"],"\x88"=>[94,"\x1F2"],"\x89"=>[76,"\x1F2"],"\x8A"=>[104,"\x1F2"],"\x8B"=>[16,"\x1F2"],"\x8C"=>[94,"\x1Fa"],"\x8D"=>[76,"\x1Fa"],"\x8E"=>[104,"\x1Fa"],"\x8F"=>[16,"\x1Fa"],"\x90"=>[94,"\x1Fc"],"\x91"=>[76,"\x1Fc"],"\x92"=>[104,"\x1Fc"],"\x93"=>[16,"\x1Fc"],"\x94"=>[94,"\x1Fe"],"\x95"=>[76,"\x1Fe"],"\x96"=>[104,"\x1Fe"],"\x97"=>[16,"\x1Fe"],"\x98"=>[94,"\x1Fi"],"\x99"=>[76,"\x1Fi"],"\x9A"=>[104,"\x1Fi"],"\x9B"=>[16,"\x1Fi"],"\x9C"=>[94,"\x1Fo"],"\x9D"=>[76,"\x1Fo"],"\x9E"=>[104,"\x1Fo"],"\x9F"=>[16,"\x1Fo"],"\xA0"=>[94,"\x1Fs"],"\xA1"=>[76,"\x1Fs"],"\xA2"=>[104,"\x1Fs"],"\xA3"=>[16,"\x1Fs"],"\xA4"=>[94,"\x1Ft"],"\xA5"=>[76,"\x1Ft"],"\xA6"=>[104,"\x1Ft"],"\xA7"=>[16,"\x1Ft"],"\xA8"=>[77,"\x1F\x20"],"\xA9"=>[18,"\x1F\x20"],"\xAA"=>[77,"\x1F\x25"],"\xAB"=>[18,"\x1F\x25"],"\xAC"=>[77,"\x1F-"],"\xAD"=>[18,"\x1F-"],"\xAE"=>[77,"\x1F."],"\xAF"=>[18,"\x1F."],"\xB0"=>[77,"\x1F\x2F"],"\xB1"=>[18,"\x1F\x2F"],"\xB2"=>[77,"\x1F3"],"\xB3"=>[18,"\x1F3"],"\xB4"=>[77,"\x1F4"],"\xB5"=>[18,"\x1F4"],"\xB6"=>[77,"\x1F5"],"\xB7"=>[18,"\x1F5"],"\xB8"=>[77,"\x1F6"],"\xB9"=>[18,"\x1F6"],"\xBA"=>[77,"\x1F7"],"\xBB"=>[18,"\x1F7"],"\xBC"=>[77,"\x1F8"],"\xBD"=>[18,"\x1F8"],"\xBE"=>[77,"\x1F9"],"\xBF"=>[18,"\x1F9"],"\xC0"=>[77,"\x1F\x3D"],"\xC1"=>[18,"\x1F\x3D"],"\xC2"=>[77,"\x1FA"],"\xC3"=>[18,"\x1FA"],"\xC4"=>[77,"\x1F_"],"\xC5"=>[18,"\x1F_"],"\xC6"=>[77,"\x1Fb"],"\xC7"=>[18,"\x1Fb"],"\xC8"=>[77,"\x1Fd"],"\xC9"=>[18,"\x1Fd"],"\xCA"=>[77,"\x1Ff"],"\xCB"=>[18,"\x1Ff"],"\xCC"=>[77,"\x1Fg"],"\xCD"=>[18,"\x1Fg"],"\xCE"=>[77,"\x1Fh"],"\xCF"=>[18,"\x1Fh"],"\xD0"=>[77,"\x1Fl"],"\xD1"=>[18,"\x1Fl"],"\xD2"=>[77,"\x1Fm"],"\xD3"=>[18,"\x1Fm"],"\xD4"=>[77,"\x1Fn"],"\xD5"=>[18,"\x1Fn"],"\xD6"=>[77,"\x1Fp"],"\xD7"=>[18,"\x1Fp"],"\xD8"=>[77,"\x1Fr"],"\xD9"=>[18,"\x1Fr"],"\xDA"=>[77,"\x1Fu"],"\xDB"=>[18,"\x1Fu"],"\xDC"=>[0,"\x1F\x3A"],"\xDD"=>[0,"\x1FB"],"\xDE"=>[0,"\x1FC"],"\xDF"=>[0,"\x1FD"],"\xE0"=>[0,"\x1FE"],"\xE1"=>[0,"\x1FF"],"\xE2"=>[0,"\x1FG"],"\xE3"=>[0,"\x1FH"],"\xE4"=>[0,"\x1FI"],"\xE5"=>[0,"\x1FJ"],"\xE6"=>[0,"\x1FK"],"\xE7"=>[0,"\x1FL"],"\xE8"=>[0,"\x1FM"],"\xE9"=>[0,"\x1FN"],"\xEA"=>[0,"\x1FO"],"\xEB"=>[0,"\x1FP"],"\xEC"=>[0,"\x1FQ"],"\xED"=>[0,"\x1FR"],"\xEE"=>[0,"\x1FS"],"\xEF"=>[0,"\x1FT"],"\xF0"=>[0,"\x1FU"],"\xF1"=>[0,"\x1FV"],"\xF2"=>[0,"\x1FW"],"\xF3"=>[0,"\x1FY"],"\xF4"=>[0,"\x1Fj"],"\xF5"=>[0,"\x1Fk"],"\xF6"=>[0,"\x1Fq"],"\xF7"=>[0,"\x1Fv"],"\xF8"=>[0,"\x1Fw"],"\xF9"=>[0,"\x1Fx"],"\xFA"=>[0,"\x1Fy"],"\xFB"=>[0,"\x1Fz"],"\xFC"=>[82,"\x1F"],"\xFD"=>[87,"\x1F"],"\xFE"=>[130,"\x1F"],"\xFF"=>[9,"\x1F"],],["\x00"=>[94,"\x200"],"\x01"=>[76,"\x200"],"\x02"=>[104,"\x200"],"\x03"=>[16,"\x200"],"\x04"=>[94,"\x201"],"\x05"=>[76,"\x201"],"\x06"=>[104,"\x201"],"\x07"=>[16,"\x201"],"\x08"=>[94,"\x202"],"\x09"=>[76,"\x202"],"\x0A"=>[104,"\x202"],"\x0B"=>[16,"\x202"],"\x0C"=>[94,"\x20a"],"\x0D"=>[76,"\x20a"],"\x0E"=>[104,"\x20a"],"\x0F"=>[16,"\x20a"],"\x10"=>[94,"\x20c"],"\x11"=>[76,"\x20c"],"\x12"=>[104,"\x20c"],"\x13"=>[16,"\x20c"],"\x14"=>[94,"\x20e"],"\x15"=>[76,"\x20e"],"\x16"=>[104,"\x20e"],"\x17"=>[16,"\x20e"],"\x18"=>[94,"\x20i"],"\x19"=>[76,"\x20i"],"\x1A"=>[104,"\x20i"],"\x1B"=>[16,"\x20i"],"\x1C"=>[94,"\x20o"],"\x1D"=>[76,"\x20o"],"\x1E"=>[104,"\x20o"],"\x1F"=>[16,"\x20o"],"\x20"=>[94,"\x20s"],"\x21"=>[76,"\x20s"],"\x22"=>[104,"\x20s"],"\x23"=>[16,"\x20s"],"\x24"=>[94,"\x20t"],"\x25"=>[76,"\x20t"],"\x26"=>[104,"\x20t"],"\x27"=>[16,"\x20t"],"\x28"=>[77,"\x20\x20"],"\x29"=>[18,"\x20\x20"],"\x2A"=>[77,"\x20\x25"],"\x2B"=>[18,"\x20\x25"],"\x2C"=>[77,"\x20-"],"-"=>[18,"\x20-"],"."=>[77,"\x20."],"\x2F"=>[18,"\x20."],[77,"\x20\x2F"],[18,"\x20\x2F"],[77,"\x203"],[18,"\x203"],[77,"\x204"],[18,"\x204"],[77,"\x205"],[18,"\x205"],[77,"\x206"],[18,"\x206"],"\x3A"=>[77,"\x207"],"\x3B"=>[18,"\x207"],"\x3C"=>[77,"\x208"],"\x3D"=>[18,"\x208"],"\x3E"=>[77,"\x209"],"\x3F"=>[18,"\x209"],"\x40"=>[77,"\x20\x3D"],"A"=>[18,"\x20\x3D"],"B"=>[77,"\x20A"],"C"=>[18,"\x20A"],"D"=>[77,"\x20_"],"E"=>[18,"\x20_"],"F"=>[77,"\x20b"],"G"=>[18,"\x20b"],"H"=>[77,"\x20d"],"I"=>[18,"\x20d"],"J"=>[77,"\x20f"],"K"=>[18,"\x20f"],"L"=>[77,"\x20g"],"M"=>[18,"\x20g"],"N"=>[77,"\x20h"],"O"=>[18,"\x20h"],"P"=>[77,"\x20l"],"Q"=>[18,"\x20l"],"R"=>[77,"\x20m"],"S"=>[18,"\x20m"],"T"=>[77,"\x20n"],"U"=>[18,"\x20n"],"V"=>[77,"\x20p"],"W"=>[18,"\x20p"],"X"=>[77,"\x20r"],"Y"=>[18,"\x20r"],"Z"=>[77,"\x20u"],"\x5B"=>[18,"\x20u"],"\x5C"=>[0,"\x20\x3A"],"\x5D"=>[0,"\x20B"],"\x5E"=>[0,"\x20C"],"_"=>[0,"\x20D"],"\x60"=>[0,"\x20E"],"a"=>[0,"\x20F"],"b"=>[0,"\x20G"],"c"=>[0,"\x20H"],"d"=>[0,"\x20I"],"e"=>[0,"\x20J"],"f"=>[0,"\x20K"],"g"=>[0,"\x20L"],"h"=>[0,"\x20M"],"i"=>[0,"\x20N"],"j"=>[0,"\x20O"],"k"=>[0,"\x20P"],"l"=>[0,"\x20Q"],"m"=>[0,"\x20R"],"n"=>[0,"\x20S"],"o"=>[0,"\x20T"],"p"=>[0,"\x20U"],"q"=>[0,"\x20V"],"r"=>[0,"\x20W"],"s"=>[0,"\x20Y"],"t"=>[0,"\x20j"],"u"=>[0,"\x20k"],"v"=>[0,"\x20q"],"w"=>[0,"\x20v"],"x"=>[0,"\x20w"],"y"=>[0,"\x20x"],"z"=>[0,"\x20y"],"\x7B"=>[0,"\x20z"],"\x7C"=>[82,"\x20"],"\x7D"=>[87,"\x20"],"~"=>[130,"\x20"],"\x7F"=>[9,"\x20"],"\x80"=>[94,"\x250"],"\x81"=>[76,"\x250"],"\x82"=>[104,"\x250"],"\x83"=>[16,"\x250"],"\x84"=>[94,"\x251"],"\x85"=>[76,"\x251"],"\x86"=>[104,"\x251"],"\x87"=>[16,"\x251"],"\x88"=>[94,"\x252"],"\x89"=>[76,"\x252"],"\x8A"=>[104,"\x252"],"\x8B"=>[16,"\x252"],"\x8C"=>[94,"\x25a"],"\x8D"=>[76,"\x25a"],"\x8E"=>[104,"\x25a"],"\x8F"=>[16,"\x25a"],"\x90"=>[94,"\x25c"],"\x91"=>[76,"\x25c"],"\x92"=>[104,"\x25c"],"\x93"=>[16,"\x25c"],"\x94"=>[94,"\x25e"],"\x95"=>[76,"\x25e"],"\x96"=>[104,"\x25e"],"\x97"=>[16,"\x25e"],"\x98"=>[94,"\x25i"],"\x99"=>[76,"\x25i"],"\x9A"=>[104,"\x25i"],"\x9B"=>[16,"\x25i"],"\x9C"=>[94,"\x25o"],"\x9D"=>[76,"\x25o"],"\x9E"=>[104,"\x25o"],"\x9F"=>[16,"\x25o"],"\xA0"=>[94,"\x25s"],"\xA1"=>[76,"\x25s"],"\xA2"=>[104,"\x25s"],"\xA3"=>[16,"\x25s"],"\xA4"=>[94,"\x25t"],"\xA5"=>[76,"\x25t"],"\xA6"=>[104,"\x25t"],"\xA7"=>[16,"\x25t"],"\xA8"=>[77,"\x25\x20"],"\xA9"=>[18,"\x25\x20"],"\xAA"=>[77,"\x25\x25"],"\xAB"=>[18,"\x25\x25"],"\xAC"=>[77,"\x25-"],"\xAD"=>[18,"\x25-"],"\xAE"=>[77,"\x25."],"\xAF"=>[18,"\x25."],"\xB0"=>[77,"\x25\x2F"],"\xB1"=>[18,"\x25\x2F"],"\xB2"=>[77,"\x253"],"\xB3"=>[18,"\x253"],"\xB4"=>[77,"\x254"],"\xB5"=>[18,"\x254"],"\xB6"=>[77,"\x255"],"\xB7"=>[18,"\x255"],"\xB8"=>[77,"\x256"],"\xB9"=>[18,"\x256"],"\xBA"=>[77,"\x257"],"\xBB"=>[18,"\x257"],"\xBC"=>[77,"\x258"],"\xBD"=>[18,"\x258"],"\xBE"=>[77,"\x259"],"\xBF"=>[18,"\x259"],"\xC0"=>[77,"\x25\x3D"],"\xC1"=>[18,"\x25\x3D"],"\xC2"=>[77,"\x25A"],"\xC3"=>[18,"\x25A"],"\xC4"=>[77,"\x25_"],"\xC5"=>[18,"\x25_"],"\xC6"=>[77,"\x25b"],"\xC7"=>[18,"\x25b"],"\xC8"=>[77,"\x25d"],"\xC9"=>[18,"\x25d"],"\xCA"=>[77,"\x25f"],"\xCB"=>[18,"\x25f"],"\xCC"=>[77,"\x25g"],"\xCD"=>[18,"\x25g"],"\xCE"=>[77,"\x25h"],"\xCF"=>[18,"\x25h"],"\xD0"=>[77,"\x25l"],"\xD1"=>[18,"\x25l"],"\xD2"=>[77,"\x25m"],"\xD3"=>[18,"\x25m"],"\xD4"=>[77,"\x25n"],"\xD5"=>[18,"\x25n"],"\xD6"=>[77,"\x25p"],"\xD7"=>[18,"\x25p"],"\xD8"=>[77,"\x25r"],"\xD9"=>[18,"\x25r"],"\xDA"=>[77,"\x25u"],"\xDB"=>[18,"\x25u"],"\xDC"=>[0,"\x25\x3A"],"\xDD"=>[0,"\x25B"],"\xDE"=>[0,"\x25C"],"\xDF"=>[0,"\x25D"],"\xE0"=>[0,"\x25E"],"\xE1"=>[0,"\x25F"],"\xE2"=>[0,"\x25G"],"\xE3"=>[0,"\x25H"],"\xE4"=>[0,"\x25I"],"\xE5"=>[0,"\x25J"],"\xE6"=>[0,"\x25K"],"\xE7"=>[0,"\x25L"],"\xE8"=>[0,"\x25M"],"\xE9"=>[0,"\x25N"],"\xEA"=>[0,"\x25O"],"\xEB"=>[0,"\x25P"],"\xEC"=>[0,"\x25Q"],"\xED"=>[0,"\x25R"],"\xEE"=>[0,"\x25S"],"\xEF"=>[0,"\x25T"],"\xF0"=>[0,"\x25U"],"\xF1"=>[0,"\x25V"],"\xF2"=>[0,"\x25W"],"\xF3"=>[0,"\x25Y"],"\xF4"=>[0,"\x25j"],"\xF5"=>[0,"\x25k"],"\xF6"=>[0,"\x25q"],"\xF7"=>[0,"\x25v"],"\xF8"=>[0,"\x25w"],"\xF9"=>[0,"\x25x"],"\xFA"=>[0,"\x25y"],"\xFB"=>[0,"\x25z"],"\xFC"=>[82,"\x25"],"\xFD"=>[87,"\x25"],"\xFE"=>[130,"\x25"],"\xFF"=>[9,"\x25"],],["\x00"=>[77,"\x200"],"\x01"=>[18,"\x200"],"\x02"=>[77,"\x201"],"\x03"=>[18,"\x201"],"\x04"=>[77,"\x202"],"\x05"=>[18,"\x202"],"\x06"=>[77,"\x20a"],"\x07"=>[18,"\x20a"],"\x08"=>[77,"\x20c"],"\x09"=>[18,"\x20c"],"\x0A"=>[77,"\x20e"],"\x0B"=>[18,"\x20e"],"\x0C"=>[77,"\x20i"],"\x0D"=>[18,"\x20i"],"\x0E"=>[77,"\x20o"],"\x0F"=>[18,"\x20o"],"\x10"=>[77,"\x20s"],"\x11"=>[18,"\x20s"],"\x12"=>[77,"\x20t"],"\x13"=>[18,"\x20t"],"\x14"=>[0,"\x20\x20"],"\x15"=>[0,"\x20\x25"],"\x16"=>[0,"\x20-"],"\x17"=>[0,"\x20."],"\x18"=>[0,"\x20\x2F"],"\x19"=>[0,"\x203"],"\x1A"=>[0,"\x204"],"\x1B"=>[0,"\x205"],"\x1C"=>[0,"\x206"],"\x1D"=>[0,"\x207"],"\x1E"=>[0,"\x208"],"\x1F"=>[0,"\x209"],"\x20"=>[0,"\x20\x3D"],"\x21"=>[0,"\x20A"],"\x22"=>[0,"\x20_"],"\x23"=>[0,"\x20b"],"\x24"=>[0,"\x20d"],"\x25"=>[0,"\x20f"],"\x26"=>[0,"\x20g"],"\x27"=>[0,"\x20h"],"\x28"=>[0,"\x20l"],"\x29"=>[0,"\x20m"],"\x2A"=>[0,"\x20n"],"\x2B"=>[0,"\x20p"],"\x2C"=>[0,"\x20r"],"-"=>[0,"\x20u"],"."=>[100,"\x20"],"\x2F"=>[110,"\x20"],[111,"\x20"],[115,"\x20"],[116,"\x20"],[118,"\x20"],[119,"\x20"],[122,"\x20"],[123,"\x20"],[125,"\x20"],[126,"\x20"],[129,"\x20"],"\x3A"=>[143,"\x20"],"\x3B"=>[148,"\x20"],"\x3C"=>[151,"\x20"],"\x3D"=>[153,"\x20"],"\x3E"=>[83,"\x20"],"\x3F"=>[10,"\x20"],"\x40"=>[77,"\x250"],"A"=>[18,"\x250"],"B"=>[77,"\x251"],"C"=>[18,"\x251"],"D"=>[77,"\x252"],"E"=>[18,"\x252"],"F"=>[77,"\x25a"],"G"=>[18,"\x25a"],"H"=>[77,"\x25c"],"I"=>[18,"\x25c"],"J"=>[77,"\x25e"],"K"=>[18,"\x25e"],"L"=>[77,"\x25i"],"M"=>[18,"\x25i"],"N"=>[77,"\x25o"],"O"=>[18,"\x25o"],"P"=>[77,"\x25s"],"Q"=>[18,"\x25s"],"R"=>[77,"\x25t"],"S"=>[18,"\x25t"],"T"=>[0,"\x25\x20"],"U"=>[0,"\x25\x25"],"V"=>[0,"\x25-"],"W"=>[0,"\x25."],"X"=>[0,"\x25\x2F"],"Y"=>[0,"\x253"],"Z"=>[0,"\x254"],"\x5B"=>[0,"\x255"],"\x5C"=>[0,"\x256"],"\x5D"=>[0,"\x257"],"\x5E"=>[0,"\x258"],"_"=>[0,"\x259"],"\x60"=>[0,"\x25\x3D"],"a"=>[0,"\x25A"],"b"=>[0,"\x25_"],"c"=>[0,"\x25b"],"d"=>[0,"\x25d"],"e"=>[0,"\x25f"],"f"=>[0,"\x25g"],"g"=>[0,"\x25h"],"h"=>[0,"\x25l"],"i"=>[0,"\x25m"],"j"=>[0,"\x25n"],"k"=>[0,"\x25p"],"l"=>[0,"\x25r"],"m"=>[0,"\x25u"],"n"=>[100,"\x25"],"o"=>[110,"\x25"],"p"=>[111,"\x25"],"q"=>[115,"\x25"],"r"=>[116,"\x25"],"s"=>[118,"\x25"],"t"=>[119,"\x25"],"u"=>[122,"\x25"],"v"=>[123,"\x25"],"w"=>[125,"\x25"],"x"=>[126,"\x25"],"y"=>[129,"\x25"],"z"=>[143,"\x25"],"\x7B"=>[148,"\x25"],"\x7C"=>[151,"\x25"],"\x7D"=>[153,"\x25"],"~"=>[83,"\x25"],"\x7F"=>[10,"\x25"],"\x80"=>[77,"-0"],"\x81"=>[18,"-0"],"\x82"=>[77,"-1"],"\x83"=>[18,"-1"],"\x84"=>[77,"-2"],"\x85"=>[18,"-2"],"\x86"=>[77,"-a"],"\x87"=>[18,"-a"],"\x88"=>[77,"-c"],"\x89"=>[18,"-c"],"\x8A"=>[77,"-e"],"\x8B"=>[18,"-e"],"\x8C"=>[77,"-i"],"\x8D"=>[18,"-i"],"\x8E"=>[77,"-o"],"\x8F"=>[18,"-o"],"\x90"=>[77,"-s"],"\x91"=>[18,"-s"],"\x92"=>[77,"-t"],"\x93"=>[18,"-t"],"\x94"=>[0,"-\x20"],"\x95"=>[0,"-\x25"],"\x96"=>[0,"--"],"\x97"=>[0,"-."],"\x98"=>[0,"-\x2F"],"\x99"=>[0,"-3"],"\x9A"=>[0,"-4"],"\x9B"=>[0,"-5"],"\x9C"=>[0,"-6"],"\x9D"=>[0,"-7"],"\x9E"=>[0,"-8"],"\x9F"=>[0,"-9"],"\xA0"=>[0,"-\x3D"],"\xA1"=>[0,"-A"],"\xA2"=>[0,"-_"],"\xA3"=>[0,"-b"],"\xA4"=>[0,"-d"],"\xA5"=>[0,"-f"],"\xA6"=>[0,"-g"],"\xA7"=>[0,"-h"],"\xA8"=>[0,"-l"],"\xA9"=>[0,"-m"],"\xAA"=>[0,"-n"],"\xAB"=>[0,"-p"],"\xAC"=>[0,"-r"],"\xAD"=>[0,"-u"],"\xAE"=>[100,"-"],"\xAF"=>[110,"-"],"\xB0"=>[111,"-"],"\xB1"=>[115,"-"],"\xB2"=>[116,"-"],"\xB3"=>[118,"-"],"\xB4"=>[119,"-"],"\xB5"=>[122,"-"],"\xB6"=>[123,"-"],"\xB7"=>[125,"-"],"\xB8"=>[126,"-"],"\xB9"=>[129,"-"],"\xBA"=>[143,"-"],"\xBB"=>[148,"-"],"\xBC"=>[151,"-"],"\xBD"=>[153,"-"],"\xBE"=>[83,"-"],"\xBF"=>[10,"-"],"\xC0"=>[77,".0"],"\xC1"=>[18,".0"],"\xC2"=>[77,".1"],"\xC3"=>[18,".1"],"\xC4"=>[77,".2"],"\xC5"=>[18,".2"],"\xC6"=>[77,".a"],"\xC7"=>[18,".a"],"\xC8"=>[77,".c"],"\xC9"=>[18,".c"],"\xCA"=>[77,".e"],"\xCB"=>[18,".e"],"\xCC"=>[77,".i"],"\xCD"=>[18,".i"],"\xCE"=>[77,".o"],"\xCF"=>[18,".o"],"\xD0"=>[77,".s"],"\xD1"=>[18,".s"],"\xD2"=>[77,".t"],"\xD3"=>[18,".t"],"\xD4"=>[0,".\x20"],"\xD5"=>[0,".\x25"],"\xD6"=>[0,".-"],"\xD7"=>[0,".."],"\xD8"=>[0,".\x2F"],"\xD9"=>[0,".3"],"\xDA"=>[0,".4"],"\xDB"=>[0,".5"],"\xDC"=>[0,".6"],"\xDD"=>[0,".7"],"\xDE"=>[0,".8"],"\xDF"=>[0,".9"],"\xE0"=>[0,".\x3D"],"\xE1"=>[0,".A"],"\xE2"=>[0,"._"],"\xE3"=>[0,".b"],"\xE4"=>[0,".d"],"\xE5"=>[0,".f"],"\xE6"=>[0,".g"],"\xE7"=>[0,".h"],"\xE8"=>[0,".l"],"\xE9"=>[0,".m"],"\xEA"=>[0,".n"],"\xEB"=>[0,".p"],"\xEC"=>[0,".r"],"\xED"=>[0,".u"],"\xEE"=>[100,"."],"\xEF"=>[110,"."],"\xF0"=>[111,"."],"\xF1"=>[115,"."],"\xF2"=>[116,"."],"\xF3"=>[118,"."],"\xF4"=>[119,"."],"\xF5"=>[122,"."],"\xF6"=>[123,"."],"\xF7"=>[125,"."],"\xF8"=>[126,"."],"\xF9"=>[129,"."],"\xFA"=>[143,"."],"\xFB"=>[148,"."],"\xFC"=>[151,"."],"\xFD"=>[153,"."],"\xFE"=>[83,"."],"\xFF"=>[10,"."],],["\x00"=>[77,"s0"],"\x01"=>[18,"s0"],"\x02"=>[77,"s1"],"\x03"=>[18,"s1"],"\x04"=>[77,"s2"],"\x05"=>[18,"s2"],"\x06"=>[77,"sa"],"\x07"=>[18,"sa"],"\x08"=>[77,"sc"],"\x09"=>[18,"sc"],"\x0A"=>[77,"se"],"\x0B"=>[18,"se"],"\x0C"=>[77,"si"],"\x0D"=>[18,"si"],"\x0E"=>[77,"so"],"\x0F"=>[18,"so"],"\x10"=>[77,"ss"],"\x11"=>[18,"ss"],"\x12"=>[77,"st"],"\x13"=>[18,"st"],"\x14"=>[0,"s\x20"],"\x15"=>[0,"s\x25"],"\x16"=>[0,"s-"],"\x17"=>[0,"s."],"\x18"=>[0,"s\x2F"],"\x19"=>[0,"s3"],"\x1A"=>[0,"s4"],"\x1B"=>[0,"s5"],"\x1C"=>[0,"s6"],"\x1D"=>[0,"s7"],"\x1E"=>[0,"s8"],"\x1F"=>[0,"s9"],"\x20"=>[0,"s\x3D"],"\x21"=>[0,"sA"],"\x22"=>[0,"s_"],"\x23"=>[0,"sb"],"\x24"=>[0,"sd"],"\x25"=>[0,"sf"],"\x26"=>[0,"sg"],"\x27"=>[0,"sh"],"\x28"=>[0,"sl"],"\x29"=>[0,"sm"],"\x2A"=>[0,"sn"],"\x2B"=>[0,"sp"],"\x2C"=>[0,"sr"],"-"=>[0,"su"],"."=>[100,"s"],"\x2F"=>[110,"s"],[111,"s"],[115,"s"],[116,"s"],[118,"s"],[119,"s"],[122,"s"],[123,"s"],[125,"s"],[126,"s"],[129,"s"],"\x3A"=>[143,"s"],"\x3B"=>[148,"s"],"\x3C"=>[151,"s"],"\x3D"=>[153,"s"],"\x3E"=>[83,"s"],"\x3F"=>[10,"s"],"\x40"=>[77,"t0"],"A"=>[18,"t0"],"B"=>[77,"t1"],"C"=>[18,"t1"],"D"=>[77,"t2"],"E"=>[18,"t2"],"F"=>[77,"ta"],"G"=>[18,"ta"],"H"=>[77,"tc"],"I"=>[18,"tc"],"J"=>[77,"te"],"K"=>[18,"te"],"L"=>[77,"ti"],"M"=>[18,"ti"],"N"=>[77,"to"],"O"=>[18,"to"],"P"=>[77,"ts"],"Q"=>[18,"ts"],"R"=>[77,"tt"],"S"=>[18,"tt"],"T"=>[0,"t\x20"],"U"=>[0,"t\x25"],"V"=>[0,"t-"],"W"=>[0,"t."],"X"=>[0,"t\x2F"],"Y"=>[0,"t3"],"Z"=>[0,"t4"],"\x5B"=>[0,"t5"],"\x5C"=>[0,"t6"],"\x5D"=>[0,"t7"],"\x5E"=>[0,"t8"],"_"=>[0,"t9"],"\x60"=>[0,"t\x3D"],"a"=>[0,"tA"],"b"=>[0,"t_"],"c"=>[0,"tb"],"d"=>[0,"td"],"e"=>[0,"tf"],"f"=>[0,"tg"],"g"=>[0,"th"],"h"=>[0,"tl"],"i"=>[0,"tm"],"j"=>[0,"tn"],"k"=>[0,"tp"],"l"=>[0,"tr"],"m"=>[0,"tu"],"n"=>[100,"t"],"o"=>[110,"t"],"p"=>[111,"t"],"q"=>[115,"t"],"r"=>[116,"t"],"s"=>[118,"t"],"t"=>[119,"t"],"u"=>[122,"t"],"v"=>[123,"t"],"w"=>[125,"t"],"x"=>[126,"t"],"y"=>[129,"t"],"z"=>[143,"t"],"\x7B"=>[148,"t"],"\x7C"=>[151,"t"],"\x7D"=>[153,"t"],"~"=>[83,"t"],"\x7F"=>[10,"t"],"\x80"=>[0,"\x200"],"\x81"=>[0,"\x201"],"\x82"=>[0,"\x202"],"\x83"=>[0,"\x20a"],"\x84"=>[0,"\x20c"],"\x85"=>[0,"\x20e"],"\x86"=>[0,"\x20i"],"\x87"=>[0,"\x20o"],"\x88"=>[0,"\x20s"],"\x89"=>[0,"\x20t"],"\x8A"=>[73,"\x20"],"\x8B"=>[88,"\x20"],"\x8C"=>[89,"\x20"],"\x8D"=>[96,"\x20"],"\x8E"=>[97,"\x20"],"\x8F"=>[99,"\x20"],"\x90"=>[106,"\x20"],"\x91"=>[136,"\x20"],"\x92"=>[139,"\x20"],"\x93"=>[141,"\x20"],"\x94"=>[145,"\x20"],"\x95"=>[147,"\x20"],"\x96"=>[149,"\x20"],"\x97"=>[101,"\x20"],"\x98"=>[112,"\x20"],"\x99"=>[117,"\x20"],"\x9A"=>[120,"\x20"],"\x9B"=>[124,"\x20"],"\x9C"=>[127,"\x20"],"\x9D"=>[144,"\x20"],"\x9E"=>[152,"\x20"],"\x9F"=>[11,"\x20"],"\xA0"=>[0,"\x250"],"\xA1"=>[0,"\x251"],"\xA2"=>[0,"\x252"],"\xA3"=>[0,"\x25a"],"\xA4"=>[0,"\x25c"],"\xA5"=>[0,"\x25e"],"\xA6"=>[0,"\x25i"],"\xA7"=>[0,"\x25o"],"\xA8"=>[0,"\x25s"],"\xA9"=>[0,"\x25t"],"\xAA"=>[73,"\x25"],"\xAB"=>[88,"\x25"],"\xAC"=>[89,"\x25"],"\xAD"=>[96,"\x25"],"\xAE"=>[97,"\x25"],"\xAF"=>[99,"\x25"],"\xB0"=>[106,"\x25"],"\xB1"=>[136,"\x25"],"\xB2"=>[139,"\x25"],"\xB3"=>[141,"\x25"],"\xB4"=>[145,"\x25"],"\xB5"=>[147,"\x25"],"\xB6"=>[149,"\x25"],"\xB7"=>[101,"\x25"],"\xB8"=>[112,"\x25"],"\xB9"=>[117,"\x25"],"\xBA"=>[120,"\x25"],"\xBB"=>[124,"\x25"],"\xBC"=>[127,"\x25"],"\xBD"=>[144,"\x25"],"\xBE"=>[152,"\x25"],"\xBF"=>[11,"\x25"],"\xC0"=>[0,"-0"],"\xC1"=>[0,"-1"],"\xC2"=>[0,"-2"],"\xC3"=>[0,"-a"],"\xC4"=>[0,"-c"],"\xC5"=>[0,"-e"],"\xC6"=>[0,"-i"],"\xC7"=>[0,"-o"],"\xC8"=>[0,"-s"],"\xC9"=>[0,"-t"],"\xCA"=>[73,"-"],"\xCB"=>[88,"-"],"\xCC"=>[89,"-"],"\xCD"=>[96,"-"],"\xCE"=>[97,"-"],"\xCF"=>[99,"-"],"\xD0"=>[106,"-"],"\xD1"=>[136,"-"],"\xD2"=>[139,"-"],"\xD3"=>[141,"-"],"\xD4"=>[145,"-"],"\xD5"=>[147,"-"],"\xD6"=>[149,"-"],"\xD7"=>[101,"-"],"\xD8"=>[112,"-"],"\xD9"=>[117,"-"],"\xDA"=>[120,"-"],"\xDB"=>[124,"-"],"\xDC"=>[127,"-"],"\xDD"=>[144,"-"],"\xDE"=>[152,"-"],"\xDF"=>[11,"-"],"\xE0"=>[0,".0"],"\xE1"=>[0,".1"],"\xE2"=>[0,".2"],"\xE3"=>[0,".a"],"\xE4"=>[0,".c"],"\xE5"=>[0,".e"],"\xE6"=>[0,".i"],"\xE7"=>[0,".o"],"\xE8"=>[0,".s"],"\xE9"=>[0,".t"],"\xEA"=>[73,"."],"\xEB"=>[88,"."],"\xEC"=>[89,"."],"\xED"=>[96,"."],"\xEE"=>[97,"."],"\xEF"=>[99,"."],"\xF0"=>[106,"."],"\xF1"=>[136,"."],"\xF2"=>[139,"."],"\xF3"=>[141,"."],"\xF4"=>[145,"."],"\xF5"=>[147,"."],"\xF6"=>[149,"."],"\xF7"=>[101,"."],"\xF8"=>[112,"."],"\xF9"=>[117,"."],"\xFA"=>[120,"."],"\xFB"=>[124,"."],"\xFC"=>[127,"."],"\xFD"=>[144,"."],"\xFE"=>[152,"."],"\xFF"=>[11,"."],],["\x00"=>[0,"s0"],"\x01"=>[0,"s1"],"\x02"=>[0,"s2"],"\x03"=>[0,"sa"],"\x04"=>[0,"sc"],"\x05"=>[0,"se"],"\x06"=>[0,"si"],"\x07"=>[0,"so"],"\x08"=>[0,"ss"],"\x09"=>[0,"st"],"\x0A"=>[73,"s"],"\x0B"=>[88,"s"],"\x0C"=>[89,"s"],"\x0D"=>[96,"s"],"\x0E"=>[97,"s"],"\x0F"=>[99,"s"],"\x10"=>[106,"s"],"\x11"=>[136,"s"],"\x12"=>[139,"s"],"\x13"=>[141,"s"],"\x14"=>[145,"s"],"\x15"=>[147,"s"],"\x16"=>[149,"s"],"\x17"=>[101,"s"],"\x18"=>[112,"s"],"\x19"=>[117,"s"],"\x1A"=>[120,"s"],"\x1B"=>[124,"s"],"\x1C"=>[127,"s"],"\x1D"=>[144,"s"],"\x1E"=>[152,"s"],"\x1F"=>[11,"s"],"\x20"=>[0,"t0"],"\x21"=>[0,"t1"],"\x22"=>[0,"t2"],"\x23"=>[0,"ta"],"\x24"=>[0,"tc"],"\x25"=>[0,"te"],"\x26"=>[0,"ti"],"\x27"=>[0,"to"],"\x28"=>[0,"ts"],"\x29"=>[0,"tt"],"\x2A"=>[73,"t"],"\x2B"=>[88,"t"],"\x2C"=>[89,"t"],"-"=>[96,"t"],"."=>[97,"t"],"\x2F"=>[99,"t"],[106,"t"],[136,"t"],[139,"t"],[141,"t"],[145,"t"],[147,"t"],[149,"t"],[101,"t"],[112,"t"],[117,"t"],"\x3A"=>[120,"t"],"\x3B"=>[124,"t"],"\x3C"=>[127,"t"],"\x3D"=>[144,"t"],"\x3E"=>[152,"t"],"\x3F"=>[11,"t"],"\x40"=>[92,"\x20"],"A"=>[95,"\x20"],"B"=>[137,"\x20"],"C"=>[142,"\x20"],"D"=>[150,"\x20"],"E"=>[74,"\x20"],"F"=>[90,"\x20"],"G"=>[98,"\x20"],"H"=>[107,"\x20"],"I"=>[140,"\x20"],"J"=>[146,"\x20"],"K"=>[102,"\x20"],"L"=>[113,"\x20"],"M"=>[121,"\x20"],"N"=>[128,"\x20"],"O"=>[12,"\x20"],"P"=>[92,"\x25"],"Q"=>[95,"\x25"],"R"=>[137,"\x25"],"S"=>[142,"\x25"],"T"=>[150,"\x25"],"U"=>[74,"\x25"],"V"=>[90,"\x25"],"W"=>[98,"\x25"],"X"=>[107,"\x25"],"Y"=>[140,"\x25"],"Z"=>[146,"\x25"],"\x5B"=>[102,"\x25"],"\x5C"=>[113,"\x25"],"\x5D"=>[121,"\x25"],"\x5E"=>[128,"\x25"],"_"=>[12,"\x25"],"\x60"=>[92,"-"],"a"=>[95,"-"],"b"=>[137,"-"],"c"=>[142,"-"],"d"=>[150,"-"],"e"=>[74,"-"],"f"=>[90,"-"],"g"=>[98,"-"],"h"=>[107,"-"],"i"=>[140,"-"],"j"=>[146,"-"],"k"=>[102,"-"],"l"=>[113,"-"],"m"=>[121,"-"],"n"=>[128,"-"],"o"=>[12,"-"],"p"=>[92,"."],"q"=>[95,"."],"r"=>[137,"."],"s"=>[142,"."],"t"=>[150,"."],"u"=>[74,"."],"v"=>[90,"."],"w"=>[98,"."],"x"=>[107,"."],"y"=>[140,"."],"z"=>[146,"."],"\x7B"=>[102,"."],"\x7C"=>[113,"."],"\x7D"=>[121,"."],"~"=>[128,"."],"\x7F"=>[12,"."],"\x80"=>[92,"\x2F"],"\x81"=>[95,"\x2F"],"\x82"=>[137,"\x2F"],"\x83"=>[142,"\x2F"],"\x84"=>[150,"\x2F"],"\x85"=>[74,"\x2F"],"\x86"=>[90,"\x2F"],"\x87"=>[98,"\x2F"],"\x88"=>[107,"\x2F"],"\x89"=>[140,"\x2F"],"\x8A"=>[146,"\x2F"],"\x8B"=>[102,"\x2F"],"\x8C"=>[113,"\x2F"],"\x8D"=>[121,"\x2F"],"\x8E"=>[128,"\x2F"],"\x8F"=>[12,"\x2F"],"\x90"=>[92,"3"],"\x91"=>[95,"3"],"\x92"=>[137,"3"],"\x93"=>[142,"3"],"\x94"=>[150,"3"],"\x95"=>[74,"3"],"\x96"=>[90,"3"],"\x97"=>[98,"3"],"\x98"=>[107,"3"],"\x99"=>[140,"3"],"\x9A"=>[146,"3"],"\x9B"=>[102,"3"],"\x9C"=>[113,"3"],"\x9D"=>[121,"3"],"\x9E"=>[128,"3"],"\x9F"=>[12,"3"],"\xA0"=>[92,"4"],"\xA1"=>[95,"4"],"\xA2"=>[137,"4"],"\xA3"=>[142,"4"],"\xA4"=>[150,"4"],"\xA5"=>[74,"4"],"\xA6"=>[90,"4"],"\xA7"=>[98,"4"],"\xA8"=>[107,"4"],"\xA9"=>[140,"4"],"\xAA"=>[146,"4"],"\xAB"=>[102,"4"],"\xAC"=>[113,"4"],"\xAD"=>[121,"4"],"\xAE"=>[128,"4"],"\xAF"=>[12,"4"],"\xB0"=>[92,"5"],"\xB1"=>[95,"5"],"\xB2"=>[137,"5"],"\xB3"=>[142,"5"],"\xB4"=>[150,"5"],"\xB5"=>[74,"5"],"\xB6"=>[90,"5"],"\xB7"=>[98,"5"],"\xB8"=>[107,"5"],"\xB9"=>[140,"5"],"\xBA"=>[146,"5"],"\xBB"=>[102,"5"],"\xBC"=>[113,"5"],"\xBD"=>[121,"5"],"\xBE"=>[128,"5"],"\xBF"=>[12,"5"],"\xC0"=>[92,"6"],"\xC1"=>[95,"6"],"\xC2"=>[137,"6"],"\xC3"=>[142,"6"],"\xC4"=>[150,"6"],"\xC5"=>[74,"6"],"\xC6"=>[90,"6"],"\xC7"=>[98,"6"],"\xC8"=>[107,"6"],"\xC9"=>[140,"6"],"\xCA"=>[146,"6"],"\xCB"=>[102,"6"],"\xCC"=>[113,"6"],"\xCD"=>[121,"6"],"\xCE"=>[128,"6"],"\xCF"=>[12,"6"],"\xD0"=>[92,"7"],"\xD1"=>[95,"7"],"\xD2"=>[137,"7"],"\xD3"=>[142,"7"],"\xD4"=>[150,"7"],"\xD5"=>[74,"7"],"\xD6"=>[90,"7"],"\xD7"=>[98,"7"],"\xD8"=>[107,"7"],"\xD9"=>[140,"7"],"\xDA"=>[146,"7"],"\xDB"=>[102,"7"],"\xDC"=>[113,"7"],"\xDD"=>[121,"7"],"\xDE"=>[128,"7"],"\xDF"=>[12,"7"],"\xE0"=>[92,"8"],"\xE1"=>[95,"8"],"\xE2"=>[137,"8"],"\xE3"=>[142,"8"],"\xE4"=>[150,"8"],"\xE5"=>[74,"8"],"\xE6"=>[90,"8"],"\xE7"=>[98,"8"],"\xE8"=>[107,"8"],"\xE9"=>[140,"8"],"\xEA"=>[146,"8"],"\xEB"=>[102,"8"],"\xEC"=>[113,"8"],"\xED"=>[121,"8"],"\xEE"=>[128,"8"],"\xEF"=>[12,"8"],"\xF0"=>[92,"9"],"\xF1"=>[95,"9"],"\xF2"=>[137,"9"],"\xF3"=>[142,"9"],"\xF4"=>[150,"9"],"\xF5"=>[74,"9"],"\xF6"=>[90,"9"],"\xF7"=>[98,"9"],"\xF8"=>[107,"9"],"\xF9"=>[140,"9"],"\xFA"=>[146,"9"],"\xFB"=>[102,"9"],"\xFC"=>[113,"9"],"\xFD"=>[121,"9"],"\xFE"=>[128,"9"],"\xFF"=>[12,"9"],],["\x00"=>[92,"0"],"\x01"=>[95,"0"],"\x02"=>[137,"0"],"\x03"=>[142,"0"],"\x04"=>[150,"0"],"\x05"=>[74,"0"],"\x06"=>[90,"0"],"\x07"=>[98,"0"],"\x08"=>[107,"0"],"\x09"=>[140,"0"],"\x0A"=>[146,"0"],"\x0B"=>[102,"0"],"\x0C"=>[113,"0"],"\x0D"=>[121,"0"],"\x0E"=>[128,"0"],"\x0F"=>[12,"0"],"\x10"=>[92,"1"],"\x11"=>[95,"1"],"\x12"=>[137,"1"],"\x13"=>[142,"1"],"\x14"=>[150,"1"],"\x15"=>[74,"1"],"\x16"=>[90,"1"],"\x17"=>[98,"1"],"\x18"=>[107,"1"],"\x19"=>[140,"1"],"\x1A"=>[146,"1"],"\x1B"=>[102,"1"],"\x1C"=>[113,"1"],"\x1D"=>[121,"1"],"\x1E"=>[128,"1"],"\x1F"=>[12,"1"],"\x20"=>[92,"2"],"\x21"=>[95,"2"],"\x22"=>[137,"2"],"\x23"=>[142,"2"],"\x24"=>[150,"2"],"\x25"=>[74,"2"],"\x26"=>[90,"2"],"\x27"=>[98,"2"],"\x28"=>[107,"2"],"\x29"=>[140,"2"],"\x2A"=>[146,"2"],"\x2B"=>[102,"2"],"\x2C"=>[113,"2"],"-"=>[121,"2"],"."=>[128,"2"],"\x2F"=>[12,"2"],[92,"a"],[95,"a"],[137,"a"],[142,"a"],[150,"a"],[74,"a"],[90,"a"],[98,"a"],[107,"a"],[140,"a"],"\x3A"=>[146,"a"],"\x3B"=>[102,"a"],"\x3C"=>[113,"a"],"\x3D"=>[121,"a"],"\x3E"=>[128,"a"],"\x3F"=>[12,"a"],"\x40"=>[92,"c"],"A"=>[95,"c"],"B"=>[137,"c"],"C"=>[142,"c"],"D"=>[150,"c"],"E"=>[74,"c"],"F"=>[90,"c"],"G"=>[98,"c"],"H"=>[107,"c"],"I"=>[140,"c"],"J"=>[146,"c"],"K"=>[102,"c"],"L"=>[113,"c"],"M"=>[121,"c"],"N"=>[128,"c"],"O"=>[12,"c"],"P"=>[92,"e"],"Q"=>[95,"e"],"R"=>[137,"e"],"S"=>[142,"e"],"T"=>[150,"e"],"U"=>[74,"e"],"V"=>[90,"e"],"W"=>[98,"e"],"X"=>[107,"e"],"Y"=>[140,"e"],"Z"=>[146,"e"],"\x5B"=>[102,"e"],"\x5C"=>[113,"e"],"\x5D"=>[121,"e"],"\x5E"=>[128,"e"],"_"=>[12,"e"],"\x60"=>[92,"i"],"a"=>[95,"i"],"b"=>[137,"i"],"c"=>[142,"i"],"d"=>[150,"i"],"e"=>[74,"i"],"f"=>[90,"i"],"g"=>[98,"i"],"h"=>[107,"i"],"i"=>[140,"i"],"j"=>[146,"i"],"k"=>[102,"i"],"l"=>[113,"i"],"m"=>[121,"i"],"n"=>[128,"i"],"o"=>[12,"i"],"p"=>[92,"o"],"q"=>[95,"o"],"r"=>[137,"o"],"s"=>[142,"o"],"t"=>[150,"o"],"u"=>[74,"o"],"v"=>[90,"o"],"w"=>[98,"o"],"x"=>[107,"o"],"y"=>[140,"o"],"z"=>[146,"o"],"\x7B"=>[102,"o"],"\x7C"=>[113,"o"],"\x7D"=>[121,"o"],"~"=>[128,"o"],"\x7F"=>[12,"o"],"\x80"=>[92,"s"],"\x81"=>[95,"s"],"\x82"=>[137,"s"],"\x83"=>[142,"s"],"\x84"=>[150,"s"],"\x85"=>[74,"s"],"\x86"=>[90,"s"],"\x87"=>[98,"s"],"\x88"=>[107,"s"],"\x89"=>[140,"s"],"\x8A"=>[146,"s"],"\x8B"=>[102,"s"],"\x8C"=>[113,"s"],"\x8D"=>[121,"s"],"\x8E"=>[128,"s"],"\x8F"=>[12,"s"],"\x90"=>[92,"t"],"\x91"=>[95,"t"],"\x92"=>[137,"t"],"\x93"=>[142,"t"],"\x94"=>[150,"t"],"\x95"=>[74,"t"],"\x96"=>[90,"t"],"\x97"=>[98,"t"],"\x98"=>[107,"t"],"\x99"=>[140,"t"],"\x9A"=>[146,"t"],"\x9B"=>[102,"t"],"\x9C"=>[113,"t"],"\x9D"=>[121,"t"],"\x9E"=>[128,"t"],"\x9F"=>[12,"t"],"\xA0"=>[93,"\x20"],"\xA1"=>[138,"\x20"],"\xA2"=>[75,"\x20"],"\xA3"=>[91,"\x20"],"\xA4"=>[108,"\x20"],"\xA5"=>[103,"\x20"],"\xA6"=>[114,"\x20"],"\xA7"=>[14,"\x20"],"\xA8"=>[93,"\x25"],"\xA9"=>[138,"\x25"],"\xAA"=>[75,"\x25"],"\xAB"=>[91,"\x25"],"\xAC"=>[108,"\x25"],"\xAD"=>[103,"\x25"],"\xAE"=>[114,"\x25"],"\xAF"=>[14,"\x25"],"\xB0"=>[93,"-"],"\xB1"=>[138,"-"],"\xB2"=>[75,"-"],"\xB3"=>[91,"-"],"\xB4"=>[108,"-"],"\xB5"=>[103,"-"],"\xB6"=>[114,"-"],"\xB7"=>[14,"-"],"\xB8"=>[93,"."],"\xB9"=>[138,"."],"\xBA"=>[75,"."],"\xBB"=>[91,"."],"\xBC"=>[108,"."],"\xBD"=>[103,"."],"\xBE"=>[114,"."],"\xBF"=>[14,"."],"\xC0"=>[93,"\x2F"],"\xC1"=>[138,"\x2F"],"\xC2"=>[75,"\x2F"],"\xC3"=>[91,"\x2F"],"\xC4"=>[108,"\x2F"],"\xC5"=>[103,"\x2F"],"\xC6"=>[114,"\x2F"],"\xC7"=>[14,"\x2F"],"\xC8"=>[93,"3"],"\xC9"=>[138,"3"],"\xCA"=>[75,"3"],"\xCB"=>[91,"3"],"\xCC"=>[108,"3"],"\xCD"=>[103,"3"],"\xCE"=>[114,"3"],"\xCF"=>[14,"3"],"\xD0"=>[93,"4"],"\xD1"=>[138,"4"],"\xD2"=>[75,"4"],"\xD3"=>[91,"4"],"\xD4"=>[108,"4"],"\xD5"=>[103,"4"],"\xD6"=>[114,"4"],"\xD7"=>[14,"4"],"\xD8"=>[93,"5"],"\xD9"=>[138,"5"],"\xDA"=>[75,"5"],"\xDB"=>[91,"5"],"\xDC"=>[108,"5"],"\xDD"=>[103,"5"],"\xDE"=>[114,"5"],"\xDF"=>[14,"5"],"\xE0"=>[93,"6"],"\xE1"=>[138,"6"],"\xE2"=>[75,"6"],"\xE3"=>[91,"6"],"\xE4"=>[108,"6"],"\xE5"=>[103,"6"],"\xE6"=>[114,"6"],"\xE7"=>[14,"6"],"\xE8"=>[93,"7"],"\xE9"=>[138,"7"],"\xEA"=>[75,"7"],"\xEB"=>[91,"7"],"\xEC"=>[108,"7"],"\xED"=>[103,"7"],"\xEE"=>[114,"7"],"\xEF"=>[14,"7"],"\xF0"=>[93,"8"],"\xF1"=>[138,"8"],"\xF2"=>[75,"8"],"\xF3"=>[91,"8"],"\xF4"=>[108,"8"],"\xF5"=>[103,"8"],"\xF6"=>[114,"8"],"\xF7"=>[14,"8"],"\xF8"=>[93,"9"],"\xF9"=>[138,"9"],"\xFA"=>[75,"9"],"\xFB"=>[91,"9"],"\xFC"=>[108,"9"],"\xFD"=>[103,"9"],"\xFE"=>[114,"9"],"\xFF"=>[14,"9"],],["\x00"=>[77,"\x210"],"\x01"=>[18,"\x210"],"\x02"=>[77,"\x211"],"\x03"=>[18,"\x211"],"\x04"=>[77,"\x212"],"\x05"=>[18,"\x212"],"\x06"=>[77,"\x21a"],"\x07"=>[18,"\x21a"],"\x08"=>[77,"\x21c"],"\x09"=>[18,"\x21c"],"\x0A"=>[77,"\x21e"],"\x0B"=>[18,"\x21e"],"\x0C"=>[77,"\x21i"],"\x0D"=>[18,"\x21i"],"\x0E"=>[77,"\x21o"],"\x0F"=>[18,"\x21o"],"\x10"=>[77,"\x21s"],"\x11"=>[18,"\x21s"],"\x12"=>[77,"\x21t"],"\x13"=>[18,"\x21t"],"\x14"=>[0,"\x21\x20"],"\x15"=>[0,"\x21\x25"],"\x16"=>[0,"\x21-"],"\x17"=>[0,"\x21."],"\x18"=>[0,"\x21\x2F"],"\x19"=>[0,"\x213"],"\x1A"=>[0,"\x214"],"\x1B"=>[0,"\x215"],"\x1C"=>[0,"\x216"],"\x1D"=>[0,"\x217"],"\x1E"=>[0,"\x218"],"\x1F"=>[0,"\x219"],"\x20"=>[0,"\x21\x3D"],"\x21"=>[0,"\x21A"],"\x22"=>[0,"\x21_"],"\x23"=>[0,"\x21b"],"\x24"=>[0,"\x21d"],"\x25"=>[0,"\x21f"],"\x26"=>[0,"\x21g"],"\x27"=>[0,"\x21h"],"\x28"=>[0,"\x21l"],"\x29"=>[0,"\x21m"],"\x2A"=>[0,"\x21n"],"\x2B"=>[0,"\x21p"],"\x2C"=>[0,"\x21r"],"-"=>[0,"\x21u"],"."=>[100,"\x21"],"\x2F"=>[110,"\x21"],[111,"\x21"],[115,"\x21"],[116,"\x21"],[118,"\x21"],[119,"\x21"],[122,"\x21"],[123,"\x21"],[125,"\x21"],[126,"\x21"],[129,"\x21"],"\x3A"=>[143,"\x21"],"\x3B"=>[148,"\x21"],"\x3C"=>[151,"\x21"],"\x3D"=>[153,"\x21"],"\x3E"=>[83,"\x21"],"\x3F"=>[10,"\x21"],"\x40"=>[77,"\x220"],"A"=>[18,"\x220"],"B"=>[77,"\x221"],"C"=>[18,"\x221"],"D"=>[77,"\x222"],"E"=>[18,"\x222"],"F"=>[77,"\x22a"],"G"=>[18,"\x22a"],"H"=>[77,"\x22c"],"I"=>[18,"\x22c"],"J"=>[77,"\x22e"],"K"=>[18,"\x22e"],"L"=>[77,"\x22i"],"M"=>[18,"\x22i"],"N"=>[77,"\x22o"],"O"=>[18,"\x22o"],"P"=>[77,"\x22s"],"Q"=>[18,"\x22s"],"R"=>[77,"\x22t"],"S"=>[18,"\x22t"],"T"=>[0,"\x22\x20"],"U"=>[0,"\x22\x25"],"V"=>[0,"\x22-"],"W"=>[0,"\x22."],"X"=>[0,"\x22\x2F"],"Y"=>[0,"\x223"],"Z"=>[0,"\x224"],"\x5B"=>[0,"\x225"],"\x5C"=>[0,"\x226"],"\x5D"=>[0,"\x227"],"\x5E"=>[0,"\x228"],"_"=>[0,"\x229"],"\x60"=>[0,"\x22\x3D"],"a"=>[0,"\x22A"],"b"=>[0,"\x22_"],"c"=>[0,"\x22b"],"d"=>[0,"\x22d"],"e"=>[0,"\x22f"],"f"=>[0,"\x22g"],"g"=>[0,"\x22h"],"h"=>[0,"\x22l"],"i"=>[0,"\x22m"],"j"=>[0,"\x22n"],"k"=>[0,"\x22p"],"l"=>[0,"\x22r"],"m"=>[0,"\x22u"],"n"=>[100,"\x22"],"o"=>[110,"\x22"],"p"=>[111,"\x22"],"q"=>[115,"\x22"],"r"=>[116,"\x22"],"s"=>[118,"\x22"],"t"=>[119,"\x22"],"u"=>[122,"\x22"],"v"=>[123,"\x22"],"w"=>[125,"\x22"],"x"=>[126,"\x22"],"y"=>[129,"\x22"],"z"=>[143,"\x22"],"\x7B"=>[148,"\x22"],"\x7C"=>[151,"\x22"],"\x7D"=>[153,"\x22"],"~"=>[83,"\x22"],"\x7F"=>[10,"\x22"],"\x80"=>[77,"\x280"],"\x81"=>[18,"\x280"],"\x82"=>[77,"\x281"],"\x83"=>[18,"\x281"],"\x84"=>[77,"\x282"],"\x85"=>[18,"\x282"],"\x86"=>[77,"\x28a"],"\x87"=>[18,"\x28a"],"\x88"=>[77,"\x28c"],"\x89"=>[18,"\x28c"],"\x8A"=>[77,"\x28e"],"\x8B"=>[18,"\x28e"],"\x8C"=>[77,"\x28i"],"\x8D"=>[18,"\x28i"],"\x8E"=>[77,"\x28o"],"\x8F"=>[18,"\x28o"],"\x90"=>[77,"\x28s"],"\x91"=>[18,"\x28s"],"\x92"=>[77,"\x28t"],"\x93"=>[18,"\x28t"],"\x94"=>[0,"\x28\x20"],"\x95"=>[0,"\x28\x25"],"\x96"=>[0,"\x28-"],"\x97"=>[0,"\x28."],"\x98"=>[0,"\x28\x2F"],"\x99"=>[0,"\x283"],"\x9A"=>[0,"\x284"],"\x9B"=>[0,"\x285"],"\x9C"=>[0,"\x286"],"\x9D"=>[0,"\x287"],"\x9E"=>[0,"\x288"],"\x9F"=>[0,"\x289"],"\xA0"=>[0,"\x28\x3D"],"\xA1"=>[0,"\x28A"],"\xA2"=>[0,"\x28_"],"\xA3"=>[0,"\x28b"],"\xA4"=>[0,"\x28d"],"\xA5"=>[0,"\x28f"],"\xA6"=>[0,"\x28g"],"\xA7"=>[0,"\x28h"],"\xA8"=>[0,"\x28l"],"\xA9"=>[0,"\x28m"],"\xAA"=>[0,"\x28n"],"\xAB"=>[0,"\x28p"],"\xAC"=>[0,"\x28r"],"\xAD"=>[0,"\x28u"],"\xAE"=>[100,"\x28"],"\xAF"=>[110,"\x28"],"\xB0"=>[111,"\x28"],"\xB1"=>[115,"\x28"],"\xB2"=>[116,"\x28"],"\xB3"=>[118,"\x28"],"\xB4"=>[119,"\x28"],"\xB5"=>[122,"\x28"],"\xB6"=>[123,"\x28"],"\xB7"=>[125,"\x28"],"\xB8"=>[126,"\x28"],"\xB9"=>[129,"\x28"],"\xBA"=>[143,"\x28"],"\xBB"=>[148,"\x28"],"\xBC"=>[151,"\x28"],"\xBD"=>[153,"\x28"],"\xBE"=>[83,"\x28"],"\xBF"=>[10,"\x28"],"\xC0"=>[77,"\x290"],"\xC1"=>[18,"\x290"],"\xC2"=>[77,"\x291"],"\xC3"=>[18,"\x291"],"\xC4"=>[77,"\x292"],"\xC5"=>[18,"\x292"],"\xC6"=>[77,"\x29a"],"\xC7"=>[18,"\x29a"],"\xC8"=>[77,"\x29c"],"\xC9"=>[18,"\x29c"],"\xCA"=>[77,"\x29e"],"\xCB"=>[18,"\x29e"],"\xCC"=>[77,"\x29i"],"\xCD"=>[18,"\x29i"],"\xCE"=>[77,"\x29o"],"\xCF"=>[18,"\x29o"],"\xD0"=>[77,"\x29s"],"\xD1"=>[18,"\x29s"],"\xD2"=>[77,"\x29t"],"\xD3"=>[18,"\x29t"],"\xD4"=>[0,"\x29\x20"],"\xD5"=>[0,"\x29\x25"],"\xD6"=>[0,"\x29-"],"\xD7"=>[0,"\x29."],"\xD8"=>[0,"\x29\x2F"],"\xD9"=>[0,"\x293"],"\xDA"=>[0,"\x294"],"\xDB"=>[0,"\x295"],"\xDC"=>[0,"\x296"],"\xDD"=>[0,"\x297"],"\xDE"=>[0,"\x298"],"\xDF"=>[0,"\x299"],"\xE0"=>[0,"\x29\x3D"],"\xE1"=>[0,"\x29A"],"\xE2"=>[0,"\x29_"],"\xE3"=>[0,"\x29b"],"\xE4"=>[0,"\x29d"],"\xE5"=>[0,"\x29f"],"\xE6"=>[0,"\x29g"],"\xE7"=>[0,"\x29h"],"\xE8"=>[0,"\x29l"],"\xE9"=>[0,"\x29m"],"\xEA"=>[0,"\x29n"],"\xEB"=>[0,"\x29p"],"\xEC"=>[0,"\x29r"],"\xED"=>[0,"\x29u"],"\xEE"=>[100,"\x29"],"\xEF"=>[110,"\x29"],"\xF0"=>[111,"\x29"],"\xF1"=>[115,"\x29"],"\xF2"=>[116,"\x29"],"\xF3"=>[118,"\x29"],"\xF4"=>[119,"\x29"],"\xF5"=>[122,"\x29"],"\xF6"=>[123,"\x29"],"\xF7"=>[125,"\x29"],"\xF8"=>[126,"\x29"],"\xF9"=>[129,"\x29"],"\xFA"=>[143,"\x29"],"\xFB"=>[148,"\x29"],"\xFC"=>[151,"\x29"],"\xFD"=>[153,"\x29"],"\xFE"=>[83,"\x29"],"\xFF"=>[10,"\x29"],],["\x00"=>[94,"\x210"],"\x01"=>[76,"\x210"],"\x02"=>[104,"\x210"],"\x03"=>[16,"\x210"],"\x04"=>[94,"\x211"],"\x05"=>[76,"\x211"],"\x06"=>[104,"\x211"],"\x07"=>[16,"\x211"],"\x08"=>[94,"\x212"],"\x09"=>[76,"\x212"],"\x0A"=>[104,"\x212"],"\x0B"=>[16,"\x212"],"\x0C"=>[94,"\x21a"],"\x0D"=>[76,"\x21a"],"\x0E"=>[104,"\x21a"],"\x0F"=>[16,"\x21a"],"\x10"=>[94,"\x21c"],"\x11"=>[76,"\x21c"],"\x12"=>[104,"\x21c"],"\x13"=>[16,"\x21c"],"\x14"=>[94,"\x21e"],"\x15"=>[76,"\x21e"],"\x16"=>[104,"\x21e"],"\x17"=>[16,"\x21e"],"\x18"=>[94,"\x21i"],"\x19"=>[76,"\x21i"],"\x1A"=>[104,"\x21i"],"\x1B"=>[16,"\x21i"],"\x1C"=>[94,"\x21o"],"\x1D"=>[76,"\x21o"],"\x1E"=>[104,"\x21o"],"\x1F"=>[16,"\x21o"],"\x20"=>[94,"\x21s"],"\x21"=>[76,"\x21s"],"\x22"=>[104,"\x21s"],"\x23"=>[16,"\x21s"],"\x24"=>[94,"\x21t"],"\x25"=>[76,"\x21t"],"\x26"=>[104,"\x21t"],"\x27"=>[16,"\x21t"],"\x28"=>[77,"\x21\x20"],"\x29"=>[18,"\x21\x20"],"\x2A"=>[77,"\x21\x25"],"\x2B"=>[18,"\x21\x25"],"\x2C"=>[77,"\x21-"],"-"=>[18,"\x21-"],"."=>[77,"\x21."],"\x2F"=>[18,"\x21."],[77,"\x21\x2F"],[18,"\x21\x2F"],[77,"\x213"],[18,"\x213"],[77,"\x214"],[18,"\x214"],[77,"\x215"],[18,"\x215"],[77,"\x216"],[18,"\x216"],"\x3A"=>[77,"\x217"],"\x3B"=>[18,"\x217"],"\x3C"=>[77,"\x218"],"\x3D"=>[18,"\x218"],"\x3E"=>[77,"\x219"],"\x3F"=>[18,"\x219"],"\x40"=>[77,"\x21\x3D"],"A"=>[18,"\x21\x3D"],"B"=>[77,"\x21A"],"C"=>[18,"\x21A"],"D"=>[77,"\x21_"],"E"=>[18,"\x21_"],"F"=>[77,"\x21b"],"G"=>[18,"\x21b"],"H"=>[77,"\x21d"],"I"=>[18,"\x21d"],"J"=>[77,"\x21f"],"K"=>[18,"\x21f"],"L"=>[77,"\x21g"],"M"=>[18,"\x21g"],"N"=>[77,"\x21h"],"O"=>[18,"\x21h"],"P"=>[77,"\x21l"],"Q"=>[18,"\x21l"],"R"=>[77,"\x21m"],"S"=>[18,"\x21m"],"T"=>[77,"\x21n"],"U"=>[18,"\x21n"],"V"=>[77,"\x21p"],"W"=>[18,"\x21p"],"X"=>[77,"\x21r"],"Y"=>[18,"\x21r"],"Z"=>[77,"\x21u"],"\x5B"=>[18,"\x21u"],"\x5C"=>[0,"\x21\x3A"],"\x5D"=>[0,"\x21B"],"\x5E"=>[0,"\x21C"],"_"=>[0,"\x21D"],"\x60"=>[0,"\x21E"],"a"=>[0,"\x21F"],"b"=>[0,"\x21G"],"c"=>[0,"\x21H"],"d"=>[0,"\x21I"],"e"=>[0,"\x21J"],"f"=>[0,"\x21K"],"g"=>[0,"\x21L"],"h"=>[0,"\x21M"],"i"=>[0,"\x21N"],"j"=>[0,"\x21O"],"k"=>[0,"\x21P"],"l"=>[0,"\x21Q"],"m"=>[0,"\x21R"],"n"=>[0,"\x21S"],"o"=>[0,"\x21T"],"p"=>[0,"\x21U"],"q"=>[0,"\x21V"],"r"=>[0,"\x21W"],"s"=>[0,"\x21Y"],"t"=>[0,"\x21j"],"u"=>[0,"\x21k"],"v"=>[0,"\x21q"],"w"=>[0,"\x21v"],"x"=>[0,"\x21w"],"y"=>[0,"\x21x"],"z"=>[0,"\x21y"],"\x7B"=>[0,"\x21z"],"\x7C"=>[82,"\x21"],"\x7D"=>[87,"\x21"],"~"=>[130,"\x21"],"\x7F"=>[9,"\x21"],"\x80"=>[94,"\x220"],"\x81"=>[76,"\x220"],"\x82"=>[104,"\x220"],"\x83"=>[16,"\x220"],"\x84"=>[94,"\x221"],"\x85"=>[76,"\x221"],"\x86"=>[104,"\x221"],"\x87"=>[16,"\x221"],"\x88"=>[94,"\x222"],"\x89"=>[76,"\x222"],"\x8A"=>[104,"\x222"],"\x8B"=>[16,"\x222"],"\x8C"=>[94,"\x22a"],"\x8D"=>[76,"\x22a"],"\x8E"=>[104,"\x22a"],"\x8F"=>[16,"\x22a"],"\x90"=>[94,"\x22c"],"\x91"=>[76,"\x22c"],"\x92"=>[104,"\x22c"],"\x93"=>[16,"\x22c"],"\x94"=>[94,"\x22e"],"\x95"=>[76,"\x22e"],"\x96"=>[104,"\x22e"],"\x97"=>[16,"\x22e"],"\x98"=>[94,"\x22i"],"\x99"=>[76,"\x22i"],"\x9A"=>[104,"\x22i"],"\x9B"=>[16,"\x22i"],"\x9C"=>[94,"\x22o"],"\x9D"=>[76,"\x22o"],"\x9E"=>[104,"\x22o"],"\x9F"=>[16,"\x22o"],"\xA0"=>[94,"\x22s"],"\xA1"=>[76,"\x22s"],"\xA2"=>[104,"\x22s"],"\xA3"=>[16,"\x22s"],"\xA4"=>[94,"\x22t"],"\xA5"=>[76,"\x22t"],"\xA6"=>[104,"\x22t"],"\xA7"=>[16,"\x22t"],"\xA8"=>[77,"\x22\x20"],"\xA9"=>[18,"\x22\x20"],"\xAA"=>[77,"\x22\x25"],"\xAB"=>[18,"\x22\x25"],"\xAC"=>[77,"\x22-"],"\xAD"=>[18,"\x22-"],"\xAE"=>[77,"\x22."],"\xAF"=>[18,"\x22."],"\xB0"=>[77,"\x22\x2F"],"\xB1"=>[18,"\x22\x2F"],"\xB2"=>[77,"\x223"],"\xB3"=>[18,"\x223"],"\xB4"=>[77,"\x224"],"\xB5"=>[18,"\x224"],"\xB6"=>[77,"\x225"],"\xB7"=>[18,"\x225"],"\xB8"=>[77,"\x226"],"\xB9"=>[18,"\x226"],"\xBA"=>[77,"\x227"],"\xBB"=>[18,"\x227"],"\xBC"=>[77,"\x228"],"\xBD"=>[18,"\x228"],"\xBE"=>[77,"\x229"],"\xBF"=>[18,"\x229"],"\xC0"=>[77,"\x22\x3D"],"\xC1"=>[18,"\x22\x3D"],"\xC2"=>[77,"\x22A"],"\xC3"=>[18,"\x22A"],"\xC4"=>[77,"\x22_"],"\xC5"=>[18,"\x22_"],"\xC6"=>[77,"\x22b"],"\xC7"=>[18,"\x22b"],"\xC8"=>[77,"\x22d"],"\xC9"=>[18,"\x22d"],"\xCA"=>[77,"\x22f"],"\xCB"=>[18,"\x22f"],"\xCC"=>[77,"\x22g"],"\xCD"=>[18,"\x22g"],"\xCE"=>[77,"\x22h"],"\xCF"=>[18,"\x22h"],"\xD0"=>[77,"\x22l"],"\xD1"=>[18,"\x22l"],"\xD2"=>[77,"\x22m"],"\xD3"=>[18,"\x22m"],"\xD4"=>[77,"\x22n"],"\xD5"=>[18,"\x22n"],"\xD6"=>[77,"\x22p"],"\xD7"=>[18,"\x22p"],"\xD8"=>[77,"\x22r"],"\xD9"=>[18,"\x22r"],"\xDA"=>[77,"\x22u"],"\xDB"=>[18,"\x22u"],"\xDC"=>[0,"\x22\x3A"],"\xDD"=>[0,"\x22B"],"\xDE"=>[0,"\x22C"],"\xDF"=>[0,"\x22D"],"\xE0"=>[0,"\x22E"],"\xE1"=>[0,"\x22F"],"\xE2"=>[0,"\x22G"],"\xE3"=>[0,"\x22H"],"\xE4"=>[0,"\x22I"],"\xE5"=>[0,"\x22J"],"\xE6"=>[0,"\x22K"],"\xE7"=>[0,"\x22L"],"\xE8"=>[0,"\x22M"],"\xE9"=>[0,"\x22N"],"\xEA"=>[0,"\x22O"],"\xEB"=>[0,"\x22P"],"\xEC"=>[0,"\x22Q"],"\xED"=>[0,"\x22R"],"\xEE"=>[0,"\x22S"],"\xEF"=>[0,"\x22T"],"\xF0"=>[0,"\x22U"],"\xF1"=>[0,"\x22V"],"\xF2"=>[0,"\x22W"],"\xF3"=>[0,"\x22Y"],"\xF4"=>[0,"\x22j"],"\xF5"=>[0,"\x22k"],"\xF6"=>[0,"\x22q"],"\xF7"=>[0,"\x22v"],"\xF8"=>[0,"\x22w"],"\xF9"=>[0,"\x22x"],"\xFA"=>[0,"\x22y"],"\xFB"=>[0,"\x22z"],"\xFC"=>[82,"\x22"],"\xFD"=>[87,"\x22"],"\xFE"=>[130,"\x22"],"\xFF"=>[9,"\x22"],],["\x00"=>[94,"\x230"],"\x01"=>[76,"\x230"],"\x02"=>[104,"\x230"],"\x03"=>[16,"\x230"],"\x04"=>[94,"\x231"],"\x05"=>[76,"\x231"],"\x06"=>[104,"\x231"],"\x07"=>[16,"\x231"],"\x08"=>[94,"\x232"],"\x09"=>[76,"\x232"],"\x0A"=>[104,"\x232"],"\x0B"=>[16,"\x232"],"\x0C"=>[94,"\x23a"],"\x0D"=>[76,"\x23a"],"\x0E"=>[104,"\x23a"],"\x0F"=>[16,"\x23a"],"\x10"=>[94,"\x23c"],"\x11"=>[76,"\x23c"],"\x12"=>[104,"\x23c"],"\x13"=>[16,"\x23c"],"\x14"=>[94,"\x23e"],"\x15"=>[76,"\x23e"],"\x16"=>[104,"\x23e"],"\x17"=>[16,"\x23e"],"\x18"=>[94,"\x23i"],"\x19"=>[76,"\x23i"],"\x1A"=>[104,"\x23i"],"\x1B"=>[16,"\x23i"],"\x1C"=>[94,"\x23o"],"\x1D"=>[76,"\x23o"],"\x1E"=>[104,"\x23o"],"\x1F"=>[16,"\x23o"],"\x20"=>[94,"\x23s"],"\x21"=>[76,"\x23s"],"\x22"=>[104,"\x23s"],"\x23"=>[16,"\x23s"],"\x24"=>[94,"\x23t"],"\x25"=>[76,"\x23t"],"\x26"=>[104,"\x23t"],"\x27"=>[16,"\x23t"],"\x28"=>[77,"\x23\x20"],"\x29"=>[18,"\x23\x20"],"\x2A"=>[77,"\x23\x25"],"\x2B"=>[18,"\x23\x25"],"\x2C"=>[77,"\x23-"],"-"=>[18,"\x23-"],"."=>[77,"\x23."],"\x2F"=>[18,"\x23."],[77,"\x23\x2F"],[18,"\x23\x2F"],[77,"\x233"],[18,"\x233"],[77,"\x234"],[18,"\x234"],[77,"\x235"],[18,"\x235"],[77,"\x236"],[18,"\x236"],"\x3A"=>[77,"\x237"],"\x3B"=>[18,"\x237"],"\x3C"=>[77,"\x238"],"\x3D"=>[18,"\x238"],"\x3E"=>[77,"\x239"],"\x3F"=>[18,"\x239"],"\x40"=>[77,"\x23\x3D"],"A"=>[18,"\x23\x3D"],"B"=>[77,"\x23A"],"C"=>[18,"\x23A"],"D"=>[77,"\x23_"],"E"=>[18,"\x23_"],"F"=>[77,"\x23b"],"G"=>[18,"\x23b"],"H"=>[77,"\x23d"],"I"=>[18,"\x23d"],"J"=>[77,"\x23f"],"K"=>[18,"\x23f"],"L"=>[77,"\x23g"],"M"=>[18,"\x23g"],"N"=>[77,"\x23h"],"O"=>[18,"\x23h"],"P"=>[77,"\x23l"],"Q"=>[18,"\x23l"],"R"=>[77,"\x23m"],"S"=>[18,"\x23m"],"T"=>[77,"\x23n"],"U"=>[18,"\x23n"],"V"=>[77,"\x23p"],"W"=>[18,"\x23p"],"X"=>[77,"\x23r"],"Y"=>[18,"\x23r"],"Z"=>[77,"\x23u"],"\x5B"=>[18,"\x23u"],"\x5C"=>[0,"\x23\x3A"],"\x5D"=>[0,"\x23B"],"\x5E"=>[0,"\x23C"],"_"=>[0,"\x23D"],"\x60"=>[0,"\x23E"],"a"=>[0,"\x23F"],"b"=>[0,"\x23G"],"c"=>[0,"\x23H"],"d"=>[0,"\x23I"],"e"=>[0,"\x23J"],"f"=>[0,"\x23K"],"g"=>[0,"\x23L"],"h"=>[0,"\x23M"],"i"=>[0,"\x23N"],"j"=>[0,"\x23O"],"k"=>[0,"\x23P"],"l"=>[0,"\x23Q"],"m"=>[0,"\x23R"],"n"=>[0,"\x23S"],"o"=>[0,"\x23T"],"p"=>[0,"\x23U"],"q"=>[0,"\x23V"],"r"=>[0,"\x23W"],"s"=>[0,"\x23Y"],"t"=>[0,"\x23j"],"u"=>[0,"\x23k"],"v"=>[0,"\x23q"],"w"=>[0,"\x23v"],"x"=>[0,"\x23w"],"y"=>[0,"\x23x"],"z"=>[0,"\x23y"],"\x7B"=>[0,"\x23z"],"\x7C"=>[82,"\x23"],"\x7D"=>[87,"\x23"],"~"=>[130,"\x23"],"\x7F"=>[9,"\x23"],"\x80"=>[94,"\x3E0"],"\x81"=>[76,"\x3E0"],"\x82"=>[104,"\x3E0"],"\x83"=>[16,"\x3E0"],"\x84"=>[94,"\x3E1"],"\x85"=>[76,"\x3E1"],"\x86"=>[104,"\x3E1"],"\x87"=>[16,"\x3E1"],"\x88"=>[94,"\x3E2"],"\x89"=>[76,"\x3E2"],"\x8A"=>[104,"\x3E2"],"\x8B"=>[16,"\x3E2"],"\x8C"=>[94,"\x3Ea"],"\x8D"=>[76,"\x3Ea"],"\x8E"=>[104,"\x3Ea"],"\x8F"=>[16,"\x3Ea"],"\x90"=>[94,"\x3Ec"],"\x91"=>[76,"\x3Ec"],"\x92"=>[104,"\x3Ec"],"\x93"=>[16,"\x3Ec"],"\x94"=>[94,"\x3Ee"],"\x95"=>[76,"\x3Ee"],"\x96"=>[104,"\x3Ee"],"\x97"=>[16,"\x3Ee"],"\x98"=>[94,"\x3Ei"],"\x99"=>[76,"\x3Ei"],"\x9A"=>[104,"\x3Ei"],"\x9B"=>[16,"\x3Ei"],"\x9C"=>[94,"\x3Eo"],"\x9D"=>[76,"\x3Eo"],"\x9E"=>[104,"\x3Eo"],"\x9F"=>[16,"\x3Eo"],"\xA0"=>[94,"\x3Es"],"\xA1"=>[76,"\x3Es"],"\xA2"=>[104,"\x3Es"],"\xA3"=>[16,"\x3Es"],"\xA4"=>[94,"\x3Et"],"\xA5"=>[76,"\x3Et"],"\xA6"=>[104,"\x3Et"],"\xA7"=>[16,"\x3Et"],"\xA8"=>[77,"\x3E\x20"],"\xA9"=>[18,"\x3E\x20"],"\xAA"=>[77,"\x3E\x25"],"\xAB"=>[18,"\x3E\x25"],"\xAC"=>[77,"\x3E-"],"\xAD"=>[18,"\x3E-"],"\xAE"=>[77,"\x3E."],"\xAF"=>[18,"\x3E."],"\xB0"=>[77,"\x3E\x2F"],"\xB1"=>[18,"\x3E\x2F"],"\xB2"=>[77,"\x3E3"],"\xB3"=>[18,"\x3E3"],"\xB4"=>[77,"\x3E4"],"\xB5"=>[18,"\x3E4"],"\xB6"=>[77,"\x3E5"],"\xB7"=>[18,"\x3E5"],"\xB8"=>[77,"\x3E6"],"\xB9"=>[18,"\x3E6"],"\xBA"=>[77,"\x3E7"],"\xBB"=>[18,"\x3E7"],"\xBC"=>[77,"\x3E8"],"\xBD"=>[18,"\x3E8"],"\xBE"=>[77,"\x3E9"],"\xBF"=>[18,"\x3E9"],"\xC0"=>[77,"\x3E\x3D"],"\xC1"=>[18,"\x3E\x3D"],"\xC2"=>[77,"\x3EA"],"\xC3"=>[18,"\x3EA"],"\xC4"=>[77,"\x3E_"],"\xC5"=>[18,"\x3E_"],"\xC6"=>[77,"\x3Eb"],"\xC7"=>[18,"\x3Eb"],"\xC8"=>[77,"\x3Ed"],"\xC9"=>[18,"\x3Ed"],"\xCA"=>[77,"\x3Ef"],"\xCB"=>[18,"\x3Ef"],"\xCC"=>[77,"\x3Eg"],"\xCD"=>[18,"\x3Eg"],"\xCE"=>[77,"\x3Eh"],"\xCF"=>[18,"\x3Eh"],"\xD0"=>[77,"\x3El"],"\xD1"=>[18,"\x3El"],"\xD2"=>[77,"\x3Em"],"\xD3"=>[18,"\x3Em"],"\xD4"=>[77,"\x3En"],"\xD5"=>[18,"\x3En"],"\xD6"=>[77,"\x3Ep"],"\xD7"=>[18,"\x3Ep"],"\xD8"=>[77,"\x3Er"],"\xD9"=>[18,"\x3Er"],"\xDA"=>[77,"\x3Eu"],"\xDB"=>[18,"\x3Eu"],"\xDC"=>[0,"\x3E\x3A"],"\xDD"=>[0,"\x3EB"],"\xDE"=>[0,"\x3EC"],"\xDF"=>[0,"\x3ED"],"\xE0"=>[0,"\x3EE"],"\xE1"=>[0,"\x3EF"],"\xE2"=>[0,"\x3EG"],"\xE3"=>[0,"\x3EH"],"\xE4"=>[0,"\x3EI"],"\xE5"=>[0,"\x3EJ"],"\xE6"=>[0,"\x3EK"],"\xE7"=>[0,"\x3EL"],"\xE8"=>[0,"\x3EM"],"\xE9"=>[0,"\x3EN"],"\xEA"=>[0,"\x3EO"],"\xEB"=>[0,"\x3EP"],"\xEC"=>[0,"\x3EQ"],"\xED"=>[0,"\x3ER"],"\xEE"=>[0,"\x3ES"],"\xEF"=>[0,"\x3ET"],"\xF0"=>[0,"\x3EU"],"\xF1"=>[0,"\x3EV"],"\xF2"=>[0,"\x3EW"],"\xF3"=>[0,"\x3EY"],"\xF4"=>[0,"\x3Ej"],"\xF5"=>[0,"\x3Ek"],"\xF6"=>[0,"\x3Eq"],"\xF7"=>[0,"\x3Ev"],"\xF8"=>[0,"\x3Ew"],"\xF9"=>[0,"\x3Ex"],"\xFA"=>[0,"\x3Ey"],"\xFB"=>[0,"\x3Ez"],"\xFC"=>[82,"\x3E"],"\xFD"=>[87,"\x3E"],"\xFE"=>[130,"\x3E"],"\xFF"=>[9,"\x3E"],],["\x00"=>[94,"\x7C0"],"\x01"=>[76,"\x7C0"],"\x02"=>[104,"\x7C0"],"\x03"=>[16,"\x7C0"],"\x04"=>[94,"\x7C1"],"\x05"=>[76,"\x7C1"],"\x06"=>[104,"\x7C1"],"\x07"=>[16,"\x7C1"],"\x08"=>[94,"\x7C2"],"\x09"=>[76,"\x7C2"],"\x0A"=>[104,"\x7C2"],"\x0B"=>[16,"\x7C2"],"\x0C"=>[94,"\x7Ca"],"\x0D"=>[76,"\x7Ca"],"\x0E"=>[104,"\x7Ca"],"\x0F"=>[16,"\x7Ca"],"\x10"=>[94,"\x7Cc"],"\x11"=>[76,"\x7Cc"],"\x12"=>[104,"\x7Cc"],"\x13"=>[16,"\x7Cc"],"\x14"=>[94,"\x7Ce"],"\x15"=>[76,"\x7Ce"],"\x16"=>[104,"\x7Ce"],"\x17"=>[16,"\x7Ce"],"\x18"=>[94,"\x7Ci"],"\x19"=>[76,"\x7Ci"],"\x1A"=>[104,"\x7Ci"],"\x1B"=>[16,"\x7Ci"],"\x1C"=>[94,"\x7Co"],"\x1D"=>[76,"\x7Co"],"\x1E"=>[104,"\x7Co"],"\x1F"=>[16,"\x7Co"],"\x20"=>[94,"\x7Cs"],"\x21"=>[76,"\x7Cs"],"\x22"=>[104,"\x7Cs"],"\x23"=>[16,"\x7Cs"],"\x24"=>[94,"\x7Ct"],"\x25"=>[76,"\x7Ct"],"\x26"=>[104,"\x7Ct"],"\x27"=>[16,"\x7Ct"],"\x28"=>[77,"\x7C\x20"],"\x29"=>[18,"\x7C\x20"],"\x2A"=>[77,"\x7C\x25"],"\x2B"=>[18,"\x7C\x25"],"\x2C"=>[77,"\x7C-"],"-"=>[18,"\x7C-"],"."=>[77,"\x7C."],"\x2F"=>[18,"\x7C."],[77,"\x7C\x2F"],[18,"\x7C\x2F"],[77,"\x7C3"],[18,"\x7C3"],[77,"\x7C4"],[18,"\x7C4"],[77,"\x7C5"],[18,"\x7C5"],[77,"\x7C6"],[18,"\x7C6"],"\x3A"=>[77,"\x7C7"],"\x3B"=>[18,"\x7C7"],"\x3C"=>[77,"\x7C8"],"\x3D"=>[18,"\x7C8"],"\x3E"=>[77,"\x7C9"],"\x3F"=>[18,"\x7C9"],"\x40"=>[77,"\x7C\x3D"],"A"=>[18,"\x7C\x3D"],"B"=>[77,"\x7CA"],"C"=>[18,"\x7CA"],"D"=>[77,"\x7C_"],"E"=>[18,"\x7C_"],"F"=>[77,"\x7Cb"],"G"=>[18,"\x7Cb"],"H"=>[77,"\x7Cd"],"I"=>[18,"\x7Cd"],"J"=>[77,"\x7Cf"],"K"=>[18,"\x7Cf"],"L"=>[77,"\x7Cg"],"M"=>[18,"\x7Cg"],"N"=>[77,"\x7Ch"],"O"=>[18,"\x7Ch"],"P"=>[77,"\x7Cl"],"Q"=>[18,"\x7Cl"],"R"=>[77,"\x7Cm"],"S"=>[18,"\x7Cm"],"T"=>[77,"\x7Cn"],"U"=>[18,"\x7Cn"],"V"=>[77,"\x7Cp"],"W"=>[18,"\x7Cp"],"X"=>[77,"\x7Cr"],"Y"=>[18,"\x7Cr"],"Z"=>[77,"\x7Cu"],"\x5B"=>[18,"\x7Cu"],"\x5C"=>[0,"\x7C\x3A"],"\x5D"=>[0,"\x7CB"],"\x5E"=>[0,"\x7CC"],"_"=>[0,"\x7CD"],"\x60"=>[0,"\x7CE"],"a"=>[0,"\x7CF"],"b"=>[0,"\x7CG"],"c"=>[0,"\x7CH"],"d"=>[0,"\x7CI"],"e"=>[0,"\x7CJ"],"f"=>[0,"\x7CK"],"g"=>[0,"\x7CL"],"h"=>[0,"\x7CM"],"i"=>[0,"\x7CN"],"j"=>[0,"\x7CO"],"k"=>[0,"\x7CP"],"l"=>[0,"\x7CQ"],"m"=>[0,"\x7CR"],"n"=>[0,"\x7CS"],"o"=>[0,"\x7CT"],"p"=>[0,"\x7CU"],"q"=>[0,"\x7CV"],"r"=>[0,"\x7CW"],"s"=>[0,"\x7CY"],"t"=>[0,"\x7Cj"],"u"=>[0,"\x7Ck"],"v"=>[0,"\x7Cq"],"w"=>[0,"\x7Cv"],"x"=>[0,"\x7Cw"],"y"=>[0,"\x7Cx"],"z"=>[0,"\x7Cy"],"\x7B"=>[0,"\x7Cz"],"\x7C"=>[82,"\x7C"],"\x7D"=>[87,"\x7C"],"~"=>[130,"\x7C"],"\x7F"=>[9,"\x7C"],"\x80"=>[77,"\x230"],"\x81"=>[18,"\x230"],"\x82"=>[77,"\x231"],"\x83"=>[18,"\x231"],"\x84"=>[77,"\x232"],"\x85"=>[18,"\x232"],"\x86"=>[77,"\x23a"],"\x87"=>[18,"\x23a"],"\x88"=>[77,"\x23c"],"\x89"=>[18,"\x23c"],"\x8A"=>[77,"\x23e"],"\x8B"=>[18,"\x23e"],"\x8C"=>[77,"\x23i"],"\x8D"=>[18,"\x23i"],"\x8E"=>[77,"\x23o"],"\x8F"=>[18,"\x23o"],"\x90"=>[77,"\x23s"],"\x91"=>[18,"\x23s"],"\x92"=>[77,"\x23t"],"\x93"=>[18,"\x23t"],"\x94"=>[0,"\x23\x20"],"\x95"=>[0,"\x23\x25"],"\x96"=>[0,"\x23-"],"\x97"=>[0,"\x23."],"\x98"=>[0,"\x23\x2F"],"\x99"=>[0,"\x233"],"\x9A"=>[0,"\x234"],"\x9B"=>[0,"\x235"],"\x9C"=>[0,"\x236"],"\x9D"=>[0,"\x237"],"\x9E"=>[0,"\x238"],"\x9F"=>[0,"\x239"],"\xA0"=>[0,"\x23\x3D"],"\xA1"=>[0,"\x23A"],"\xA2"=>[0,"\x23_"],"\xA3"=>[0,"\x23b"],"\xA4"=>[0,"\x23d"],"\xA5"=>[0,"\x23f"],"\xA6"=>[0,"\x23g"],"\xA7"=>[0,"\x23h"],"\xA8"=>[0,"\x23l"],"\xA9"=>[0,"\x23m"],"\xAA"=>[0,"\x23n"],"\xAB"=>[0,"\x23p"],"\xAC"=>[0,"\x23r"],"\xAD"=>[0,"\x23u"],"\xAE"=>[100,"\x23"],"\xAF"=>[110,"\x23"],"\xB0"=>[111,"\x23"],"\xB1"=>[115,"\x23"],"\xB2"=>[116,"\x23"],"\xB3"=>[118,"\x23"],"\xB4"=>[119,"\x23"],"\xB5"=>[122,"\x23"],"\xB6"=>[123,"\x23"],"\xB7"=>[125,"\x23"],"\xB8"=>[126,"\x23"],"\xB9"=>[129,"\x23"],"\xBA"=>[143,"\x23"],"\xBB"=>[148,"\x23"],"\xBC"=>[151,"\x23"],"\xBD"=>[153,"\x23"],"\xBE"=>[83,"\x23"],"\xBF"=>[10,"\x23"],"\xC0"=>[77,"\x3E0"],"\xC1"=>[18,"\x3E0"],"\xC2"=>[77,"\x3E1"],"\xC3"=>[18,"\x3E1"],"\xC4"=>[77,"\x3E2"],"\xC5"=>[18,"\x3E2"],"\xC6"=>[77,"\x3Ea"],"\xC7"=>[18,"\x3Ea"],"\xC8"=>[77,"\x3Ec"],"\xC9"=>[18,"\x3Ec"],"\xCA"=>[77,"\x3Ee"],"\xCB"=>[18,"\x3Ee"],"\xCC"=>[77,"\x3Ei"],"\xCD"=>[18,"\x3Ei"],"\xCE"=>[77,"\x3Eo"],"\xCF"=>[18,"\x3Eo"],"\xD0"=>[77,"\x3Es"],"\xD1"=>[18,"\x3Es"],"\xD2"=>[77,"\x3Et"],"\xD3"=>[18,"\x3Et"],"\xD4"=>[0,"\x3E\x20"],"\xD5"=>[0,"\x3E\x25"],"\xD6"=>[0,"\x3E-"],"\xD7"=>[0,"\x3E."],"\xD8"=>[0,"\x3E\x2F"],"\xD9"=>[0,"\x3E3"],"\xDA"=>[0,"\x3E4"],"\xDB"=>[0,"\x3E5"],"\xDC"=>[0,"\x3E6"],"\xDD"=>[0,"\x3E7"],"\xDE"=>[0,"\x3E8"],"\xDF"=>[0,"\x3E9"],"\xE0"=>[0,"\x3E\x3D"],"\xE1"=>[0,"\x3EA"],"\xE2"=>[0,"\x3E_"],"\xE3"=>[0,"\x3Eb"],"\xE4"=>[0,"\x3Ed"],"\xE5"=>[0,"\x3Ef"],"\xE6"=>[0,"\x3Eg"],"\xE7"=>[0,"\x3Eh"],"\xE8"=>[0,"\x3El"],"\xE9"=>[0,"\x3Em"],"\xEA"=>[0,"\x3En"],"\xEB"=>[0,"\x3Ep"],"\xEC"=>[0,"\x3Er"],"\xED"=>[0,"\x3Eu"],"\xEE"=>[100,"\x3E"],"\xEF"=>[110,"\x3E"],"\xF0"=>[111,"\x3E"],"\xF1"=>[115,"\x3E"],"\xF2"=>[116,"\x3E"],"\xF3"=>[118,"\x3E"],"\xF4"=>[119,"\x3E"],"\xF5"=>[122,"\x3E"],"\xF6"=>[123,"\x3E"],"\xF7"=>[125,"\x3E"],"\xF8"=>[126,"\x3E"],"\xF9"=>[129,"\x3E"],"\xFA"=>[143,"\x3E"],"\xFB"=>[148,"\x3E"],"\xFC"=>[151,"\x3E"],"\xFD"=>[153,"\x3E"],"\xFE"=>[83,"\x3E"],"\xFF"=>[10,"\x3E"],],["\x00"=>[94,"\x260"],"\x01"=>[76,"\x260"],"\x02"=>[104,"\x260"],"\x03"=>[16,"\x260"],"\x04"=>[94,"\x261"],"\x05"=>[76,"\x261"],"\x06"=>[104,"\x261"],"\x07"=>[16,"\x261"],"\x08"=>[94,"\x262"],"\x09"=>[76,"\x262"],"\x0A"=>[104,"\x262"],"\x0B"=>[16,"\x262"],"\x0C"=>[94,"\x26a"],"\x0D"=>[76,"\x26a"],"\x0E"=>[104,"\x26a"],"\x0F"=>[16,"\x26a"],"\x10"=>[94,"\x26c"],"\x11"=>[76,"\x26c"],"\x12"=>[104,"\x26c"],"\x13"=>[16,"\x26c"],"\x14"=>[94,"\x26e"],"\x15"=>[76,"\x26e"],"\x16"=>[104,"\x26e"],"\x17"=>[16,"\x26e"],"\x18"=>[94,"\x26i"],"\x19"=>[76,"\x26i"],"\x1A"=>[104,"\x26i"],"\x1B"=>[16,"\x26i"],"\x1C"=>[94,"\x26o"],"\x1D"=>[76,"\x26o"],"\x1E"=>[104,"\x26o"],"\x1F"=>[16,"\x26o"],"\x20"=>[94,"\x26s"],"\x21"=>[76,"\x26s"],"\x22"=>[104,"\x26s"],"\x23"=>[16,"\x26s"],"\x24"=>[94,"\x26t"],"\x25"=>[76,"\x26t"],"\x26"=>[104,"\x26t"],"\x27"=>[16,"\x26t"],"\x28"=>[77,"\x26\x20"],"\x29"=>[18,"\x26\x20"],"\x2A"=>[77,"\x26\x25"],"\x2B"=>[18,"\x26\x25"],"\x2C"=>[77,"\x26-"],"-"=>[18,"\x26-"],"."=>[77,"\x26."],"\x2F"=>[18,"\x26."],[77,"\x26\x2F"],[18,"\x26\x2F"],[77,"\x263"],[18,"\x263"],[77,"\x264"],[18,"\x264"],[77,"\x265"],[18,"\x265"],[77,"\x266"],[18,"\x266"],"\x3A"=>[77,"\x267"],"\x3B"=>[18,"\x267"],"\x3C"=>[77,"\x268"],"\x3D"=>[18,"\x268"],"\x3E"=>[77,"\x269"],"\x3F"=>[18,"\x269"],"\x40"=>[77,"\x26\x3D"],"A"=>[18,"\x26\x3D"],"B"=>[77,"\x26A"],"C"=>[18,"\x26A"],"D"=>[77,"\x26_"],"E"=>[18,"\x26_"],"F"=>[77,"\x26b"],"G"=>[18,"\x26b"],"H"=>[77,"\x26d"],"I"=>[18,"\x26d"],"J"=>[77,"\x26f"],"K"=>[18,"\x26f"],"L"=>[77,"\x26g"],"M"=>[18,"\x26g"],"N"=>[77,"\x26h"],"O"=>[18,"\x26h"],"P"=>[77,"\x26l"],"Q"=>[18,"\x26l"],"R"=>[77,"\x26m"],"S"=>[18,"\x26m"],"T"=>[77,"\x26n"],"U"=>[18,"\x26n"],"V"=>[77,"\x26p"],"W"=>[18,"\x26p"],"X"=>[77,"\x26r"],"Y"=>[18,"\x26r"],"Z"=>[77,"\x26u"],"\x5B"=>[18,"\x26u"],"\x5C"=>[0,"\x26\x3A"],"\x5D"=>[0,"\x26B"],"\x5E"=>[0,"\x26C"],"_"=>[0,"\x26D"],"\x60"=>[0,"\x26E"],"a"=>[0,"\x26F"],"b"=>[0,"\x26G"],"c"=>[0,"\x26H"],"d"=>[0,"\x26I"],"e"=>[0,"\x26J"],"f"=>[0,"\x26K"],"g"=>[0,"\x26L"],"h"=>[0,"\x26M"],"i"=>[0,"\x26N"],"j"=>[0,"\x26O"],"k"=>[0,"\x26P"],"l"=>[0,"\x26Q"],"m"=>[0,"\x26R"],"n"=>[0,"\x26S"],"o"=>[0,"\x26T"],"p"=>[0,"\x26U"],"q"=>[0,"\x26V"],"r"=>[0,"\x26W"],"s"=>[0,"\x26Y"],"t"=>[0,"\x26j"],"u"=>[0,"\x26k"],"v"=>[0,"\x26q"],"w"=>[0,"\x26v"],"x"=>[0,"\x26w"],"y"=>[0,"\x26x"],"z"=>[0,"\x26y"],"\x7B"=>[0,"\x26z"],"\x7C"=>[82,"\x26"],"\x7D"=>[87,"\x26"],"~"=>[130,"\x26"],"\x7F"=>[9,"\x26"],"\x80"=>[94,"\x2A0"],"\x81"=>[76,"\x2A0"],"\x82"=>[104,"\x2A0"],"\x83"=>[16,"\x2A0"],"\x84"=>[94,"\x2A1"],"\x85"=>[76,"\x2A1"],"\x86"=>[104,"\x2A1"],"\x87"=>[16,"\x2A1"],"\x88"=>[94,"\x2A2"],"\x89"=>[76,"\x2A2"],"\x8A"=>[104,"\x2A2"],"\x8B"=>[16,"\x2A2"],"\x8C"=>[94,"\x2Aa"],"\x8D"=>[76,"\x2Aa"],"\x8E"=>[104,"\x2Aa"],"\x8F"=>[16,"\x2Aa"],"\x90"=>[94,"\x2Ac"],"\x91"=>[76,"\x2Ac"],"\x92"=>[104,"\x2Ac"],"\x93"=>[16,"\x2Ac"],"\x94"=>[94,"\x2Ae"],"\x95"=>[76,"\x2Ae"],"\x96"=>[104,"\x2Ae"],"\x97"=>[16,"\x2Ae"],"\x98"=>[94,"\x2Ai"],"\x99"=>[76,"\x2Ai"],"\x9A"=>[104,"\x2Ai"],"\x9B"=>[16,"\x2Ai"],"\x9C"=>[94,"\x2Ao"],"\x9D"=>[76,"\x2Ao"],"\x9E"=>[104,"\x2Ao"],"\x9F"=>[16,"\x2Ao"],"\xA0"=>[94,"\x2As"],"\xA1"=>[76,"\x2As"],"\xA2"=>[104,"\x2As"],"\xA3"=>[16,"\x2As"],"\xA4"=>[94,"\x2At"],"\xA5"=>[76,"\x2At"],"\xA6"=>[104,"\x2At"],"\xA7"=>[16,"\x2At"],"\xA8"=>[77,"\x2A\x20"],"\xA9"=>[18,"\x2A\x20"],"\xAA"=>[77,"\x2A\x25"],"\xAB"=>[18,"\x2A\x25"],"\xAC"=>[77,"\x2A-"],"\xAD"=>[18,"\x2A-"],"\xAE"=>[77,"\x2A."],"\xAF"=>[18,"\x2A."],"\xB0"=>[77,"\x2A\x2F"],"\xB1"=>[18,"\x2A\x2F"],"\xB2"=>[77,"\x2A3"],"\xB3"=>[18,"\x2A3"],"\xB4"=>[77,"\x2A4"],"\xB5"=>[18,"\x2A4"],"\xB6"=>[77,"\x2A5"],"\xB7"=>[18,"\x2A5"],"\xB8"=>[77,"\x2A6"],"\xB9"=>[18,"\x2A6"],"\xBA"=>[77,"\x2A7"],"\xBB"=>[18,"\x2A7"],"\xBC"=>[77,"\x2A8"],"\xBD"=>[18,"\x2A8"],"\xBE"=>[77,"\x2A9"],"\xBF"=>[18,"\x2A9"],"\xC0"=>[77,"\x2A\x3D"],"\xC1"=>[18,"\x2A\x3D"],"\xC2"=>[77,"\x2AA"],"\xC3"=>[18,"\x2AA"],"\xC4"=>[77,"\x2A_"],"\xC5"=>[18,"\x2A_"],"\xC6"=>[77,"\x2Ab"],"\xC7"=>[18,"\x2Ab"],"\xC8"=>[77,"\x2Ad"],"\xC9"=>[18,"\x2Ad"],"\xCA"=>[77,"\x2Af"],"\xCB"=>[18,"\x2Af"],"\xCC"=>[77,"\x2Ag"],"\xCD"=>[18,"\x2Ag"],"\xCE"=>[77,"\x2Ah"],"\xCF"=>[18,"\x2Ah"],"\xD0"=>[77,"\x2Al"],"\xD1"=>[18,"\x2Al"],"\xD2"=>[77,"\x2Am"],"\xD3"=>[18,"\x2Am"],"\xD4"=>[77,"\x2An"],"\xD5"=>[18,"\x2An"],"\xD6"=>[77,"\x2Ap"],"\xD7"=>[18,"\x2Ap"],"\xD8"=>[77,"\x2Ar"],"\xD9"=>[18,"\x2Ar"],"\xDA"=>[77,"\x2Au"],"\xDB"=>[18,"\x2Au"],"\xDC"=>[0,"\x2A\x3A"],"\xDD"=>[0,"\x2AB"],"\xDE"=>[0,"\x2AC"],"\xDF"=>[0,"\x2AD"],"\xE0"=>[0,"\x2AE"],"\xE1"=>[0,"\x2AF"],"\xE2"=>[0,"\x2AG"],"\xE3"=>[0,"\x2AH"],"\xE4"=>[0,"\x2AI"],"\xE5"=>[0,"\x2AJ"],"\xE6"=>[0,"\x2AK"],"\xE7"=>[0,"\x2AL"],"\xE8"=>[0,"\x2AM"],"\xE9"=>[0,"\x2AN"],"\xEA"=>[0,"\x2AO"],"\xEB"=>[0,"\x2AP"],"\xEC"=>[0,"\x2AQ"],"\xED"=>[0,"\x2AR"],"\xEE"=>[0,"\x2AS"],"\xEF"=>[0,"\x2AT"],"\xF0"=>[0,"\x2AU"],"\xF1"=>[0,"\x2AV"],"\xF2"=>[0,"\x2AW"],"\xF3"=>[0,"\x2AY"],"\xF4"=>[0,"\x2Aj"],"\xF5"=>[0,"\x2Ak"],"\xF6"=>[0,"\x2Aq"],"\xF7"=>[0,"\x2Av"],"\xF8"=>[0,"\x2Aw"],"\xF9"=>[0,"\x2Ax"],"\xFA"=>[0,"\x2Ay"],"\xFB"=>[0,"\x2Az"],"\xFC"=>[82,"\x2A"],"\xFD"=>[87,"\x2A"],"\xFE"=>[130,"\x2A"],"\xFF"=>[9,"\x2A"],],["\x00"=>[77,"\x260"],"\x01"=>[18,"\x260"],"\x02"=>[77,"\x261"],"\x03"=>[18,"\x261"],"\x04"=>[77,"\x262"],"\x05"=>[18,"\x262"],"\x06"=>[77,"\x26a"],"\x07"=>[18,"\x26a"],"\x08"=>[77,"\x26c"],"\x09"=>[18,"\x26c"],"\x0A"=>[77,"\x26e"],"\x0B"=>[18,"\x26e"],"\x0C"=>[77,"\x26i"],"\x0D"=>[18,"\x26i"],"\x0E"=>[77,"\x26o"],"\x0F"=>[18,"\x26o"],"\x10"=>[77,"\x26s"],"\x11"=>[18,"\x26s"],"\x12"=>[77,"\x26t"],"\x13"=>[18,"\x26t"],"\x14"=>[0,"\x26\x20"],"\x15"=>[0,"\x26\x25"],"\x16"=>[0,"\x26-"],"\x17"=>[0,"\x26."],"\x18"=>[0,"\x26\x2F"],"\x19"=>[0,"\x263"],"\x1A"=>[0,"\x264"],"\x1B"=>[0,"\x265"],"\x1C"=>[0,"\x266"],"\x1D"=>[0,"\x267"],"\x1E"=>[0,"\x268"],"\x1F"=>[0,"\x269"],"\x20"=>[0,"\x26\x3D"],"\x21"=>[0,"\x26A"],"\x22"=>[0,"\x26_"],"\x23"=>[0,"\x26b"],"\x24"=>[0,"\x26d"],"\x25"=>[0,"\x26f"],"\x26"=>[0,"\x26g"],"\x27"=>[0,"\x26h"],"\x28"=>[0,"\x26l"],"\x29"=>[0,"\x26m"],"\x2A"=>[0,"\x26n"],"\x2B"=>[0,"\x26p"],"\x2C"=>[0,"\x26r"],"-"=>[0,"\x26u"],"."=>[100,"\x26"],"\x2F"=>[110,"\x26"],[111,"\x26"],[115,"\x26"],[116,"\x26"],[118,"\x26"],[119,"\x26"],[122,"\x26"],[123,"\x26"],[125,"\x26"],[126,"\x26"],[129,"\x26"],"\x3A"=>[143,"\x26"],"\x3B"=>[148,"\x26"],"\x3C"=>[151,"\x26"],"\x3D"=>[153,"\x26"],"\x3E"=>[83,"\x26"],"\x3F"=>[10,"\x26"],"\x40"=>[77,"\x2A0"],"A"=>[18,"\x2A0"],"B"=>[77,"\x2A1"],"C"=>[18,"\x2A1"],"D"=>[77,"\x2A2"],"E"=>[18,"\x2A2"],"F"=>[77,"\x2Aa"],"G"=>[18,"\x2Aa"],"H"=>[77,"\x2Ac"],"I"=>[18,"\x2Ac"],"J"=>[77,"\x2Ae"],"K"=>[18,"\x2Ae"],"L"=>[77,"\x2Ai"],"M"=>[18,"\x2Ai"],"N"=>[77,"\x2Ao"],"O"=>[18,"\x2Ao"],"P"=>[77,"\x2As"],"Q"=>[18,"\x2As"],"R"=>[77,"\x2At"],"S"=>[18,"\x2At"],"T"=>[0,"\x2A\x20"],"U"=>[0,"\x2A\x25"],"V"=>[0,"\x2A-"],"W"=>[0,"\x2A."],"X"=>[0,"\x2A\x2F"],"Y"=>[0,"\x2A3"],"Z"=>[0,"\x2A4"],"\x5B"=>[0,"\x2A5"],"\x5C"=>[0,"\x2A6"],"\x5D"=>[0,"\x2A7"],"\x5E"=>[0,"\x2A8"],"_"=>[0,"\x2A9"],"\x60"=>[0,"\x2A\x3D"],"a"=>[0,"\x2AA"],"b"=>[0,"\x2A_"],"c"=>[0,"\x2Ab"],"d"=>[0,"\x2Ad"],"e"=>[0,"\x2Af"],"f"=>[0,"\x2Ag"],"g"=>[0,"\x2Ah"],"h"=>[0,"\x2Al"],"i"=>[0,"\x2Am"],"j"=>[0,"\x2An"],"k"=>[0,"\x2Ap"],"l"=>[0,"\x2Ar"],"m"=>[0,"\x2Au"],"n"=>[100,"\x2A"],"o"=>[110,"\x2A"],"p"=>[111,"\x2A"],"q"=>[115,"\x2A"],"r"=>[116,"\x2A"],"s"=>[118,"\x2A"],"t"=>[119,"\x2A"],"u"=>[122,"\x2A"],"v"=>[123,"\x2A"],"w"=>[125,"\x2A"],"x"=>[126,"\x2A"],"y"=>[129,"\x2A"],"z"=>[143,"\x2A"],"\x7B"=>[148,"\x2A"],"\x7C"=>[151,"\x2A"],"\x7D"=>[153,"\x2A"],"~"=>[83,"\x2A"],"\x7F"=>[10,"\x2A"],"\x80"=>[77,"\x2C0"],"\x81"=>[18,"\x2C0"],"\x82"=>[77,"\x2C1"],"\x83"=>[18,"\x2C1"],"\x84"=>[77,"\x2C2"],"\x85"=>[18,"\x2C2"],"\x86"=>[77,"\x2Ca"],"\x87"=>[18,"\x2Ca"],"\x88"=>[77,"\x2Cc"],"\x89"=>[18,"\x2Cc"],"\x8A"=>[77,"\x2Ce"],"\x8B"=>[18,"\x2Ce"],"\x8C"=>[77,"\x2Ci"],"\x8D"=>[18,"\x2Ci"],"\x8E"=>[77,"\x2Co"],"\x8F"=>[18,"\x2Co"],"\x90"=>[77,"\x2Cs"],"\x91"=>[18,"\x2Cs"],"\x92"=>[77,"\x2Ct"],"\x93"=>[18,"\x2Ct"],"\x94"=>[0,"\x2C\x20"],"\x95"=>[0,"\x2C\x25"],"\x96"=>[0,"\x2C-"],"\x97"=>[0,"\x2C."],"\x98"=>[0,"\x2C\x2F"],"\x99"=>[0,"\x2C3"],"\x9A"=>[0,"\x2C4"],"\x9B"=>[0,"\x2C5"],"\x9C"=>[0,"\x2C6"],"\x9D"=>[0,"\x2C7"],"\x9E"=>[0,"\x2C8"],"\x9F"=>[0,"\x2C9"],"\xA0"=>[0,"\x2C\x3D"],"\xA1"=>[0,"\x2CA"],"\xA2"=>[0,"\x2C_"],"\xA3"=>[0,"\x2Cb"],"\xA4"=>[0,"\x2Cd"],"\xA5"=>[0,"\x2Cf"],"\xA6"=>[0,"\x2Cg"],"\xA7"=>[0,"\x2Ch"],"\xA8"=>[0,"\x2Cl"],"\xA9"=>[0,"\x2Cm"],"\xAA"=>[0,"\x2Cn"],"\xAB"=>[0,"\x2Cp"],"\xAC"=>[0,"\x2Cr"],"\xAD"=>[0,"\x2Cu"],"\xAE"=>[100,"\x2C"],"\xAF"=>[110,"\x2C"],"\xB0"=>[111,"\x2C"],"\xB1"=>[115,"\x2C"],"\xB2"=>[116,"\x2C"],"\xB3"=>[118,"\x2C"],"\xB4"=>[119,"\x2C"],"\xB5"=>[122,"\x2C"],"\xB6"=>[123,"\x2C"],"\xB7"=>[125,"\x2C"],"\xB8"=>[126,"\x2C"],"\xB9"=>[129,"\x2C"],"\xBA"=>[143,"\x2C"],"\xBB"=>[148,"\x2C"],"\xBC"=>[151,"\x2C"],"\xBD"=>[153,"\x2C"],"\xBE"=>[83,"\x2C"],"\xBF"=>[10,"\x2C"],"\xC0"=>[77,"\x3B0"],"\xC1"=>[18,"\x3B0"],"\xC2"=>[77,"\x3B1"],"\xC3"=>[18,"\x3B1"],"\xC4"=>[77,"\x3B2"],"\xC5"=>[18,"\x3B2"],"\xC6"=>[77,"\x3Ba"],"\xC7"=>[18,"\x3Ba"],"\xC8"=>[77,"\x3Bc"],"\xC9"=>[18,"\x3Bc"],"\xCA"=>[77,"\x3Be"],"\xCB"=>[18,"\x3Be"],"\xCC"=>[77,"\x3Bi"],"\xCD"=>[18,"\x3Bi"],"\xCE"=>[77,"\x3Bo"],"\xCF"=>[18,"\x3Bo"],"\xD0"=>[77,"\x3Bs"],"\xD1"=>[18,"\x3Bs"],"\xD2"=>[77,"\x3Bt"],"\xD3"=>[18,"\x3Bt"],"\xD4"=>[0,"\x3B\x20"],"\xD5"=>[0,"\x3B\x25"],"\xD6"=>[0,"\x3B-"],"\xD7"=>[0,"\x3B."],"\xD8"=>[0,"\x3B\x2F"],"\xD9"=>[0,"\x3B3"],"\xDA"=>[0,"\x3B4"],"\xDB"=>[0,"\x3B5"],"\xDC"=>[0,"\x3B6"],"\xDD"=>[0,"\x3B7"],"\xDE"=>[0,"\x3B8"],"\xDF"=>[0,"\x3B9"],"\xE0"=>[0,"\x3B\x3D"],"\xE1"=>[0,"\x3BA"],"\xE2"=>[0,"\x3B_"],"\xE3"=>[0,"\x3Bb"],"\xE4"=>[0,"\x3Bd"],"\xE5"=>[0,"\x3Bf"],"\xE6"=>[0,"\x3Bg"],"\xE7"=>[0,"\x3Bh"],"\xE8"=>[0,"\x3Bl"],"\xE9"=>[0,"\x3Bm"],"\xEA"=>[0,"\x3Bn"],"\xEB"=>[0,"\x3Bp"],"\xEC"=>[0,"\x3Br"],"\xED"=>[0,"\x3Bu"],"\xEE"=>[100,"\x3B"],"\xEF"=>[110,"\x3B"],"\xF0"=>[111,"\x3B"],"\xF1"=>[115,"\x3B"],"\xF2"=>[116,"\x3B"],"\xF3"=>[118,"\x3B"],"\xF4"=>[119,"\x3B"],"\xF5"=>[122,"\x3B"],"\xF6"=>[123,"\x3B"],"\xF7"=>[125,"\x3B"],"\xF8"=>[126,"\x3B"],"\xF9"=>[129,"\x3B"],"\xFA"=>[143,"\x3B"],"\xFB"=>[148,"\x3B"],"\xFC"=>[151,"\x3B"],"\xFD"=>[153,"\x3B"],"\xFE"=>[83,"\x3B"],"\xFF"=>[10,"\x3B"],],["\x00"=>[94,"\x270"],"\x01"=>[76,"\x270"],"\x02"=>[104,"\x270"],"\x03"=>[16,"\x270"],"\x04"=>[94,"\x271"],"\x05"=>[76,"\x271"],"\x06"=>[104,"\x271"],"\x07"=>[16,"\x271"],"\x08"=>[94,"\x272"],"\x09"=>[76,"\x272"],"\x0A"=>[104,"\x272"],"\x0B"=>[16,"\x272"],"\x0C"=>[94,"\x27a"],"\x0D"=>[76,"\x27a"],"\x0E"=>[104,"\x27a"],"\x0F"=>[16,"\x27a"],"\x10"=>[94,"\x27c"],"\x11"=>[76,"\x27c"],"\x12"=>[104,"\x27c"],"\x13"=>[16,"\x27c"],"\x14"=>[94,"\x27e"],"\x15"=>[76,"\x27e"],"\x16"=>[104,"\x27e"],"\x17"=>[16,"\x27e"],"\x18"=>[94,"\x27i"],"\x19"=>[76,"\x27i"],"\x1A"=>[104,"\x27i"],"\x1B"=>[16,"\x27i"],"\x1C"=>[94,"\x27o"],"\x1D"=>[76,"\x27o"],"\x1E"=>[104,"\x27o"],"\x1F"=>[16,"\x27o"],"\x20"=>[94,"\x27s"],"\x21"=>[76,"\x27s"],"\x22"=>[104,"\x27s"],"\x23"=>[16,"\x27s"],"\x24"=>[94,"\x27t"],"\x25"=>[76,"\x27t"],"\x26"=>[104,"\x27t"],"\x27"=>[16,"\x27t"],"\x28"=>[77,"\x27\x20"],"\x29"=>[18,"\x27\x20"],"\x2A"=>[77,"\x27\x25"],"\x2B"=>[18,"\x27\x25"],"\x2C"=>[77,"\x27-"],"-"=>[18,"\x27-"],"."=>[77,"\x27."],"\x2F"=>[18,"\x27."],[77,"\x27\x2F"],[18,"\x27\x2F"],[77,"\x273"],[18,"\x273"],[77,"\x274"],[18,"\x274"],[77,"\x275"],[18,"\x275"],[77,"\x276"],[18,"\x276"],"\x3A"=>[77,"\x277"],"\x3B"=>[18,"\x277"],"\x3C"=>[77,"\x278"],"\x3D"=>[18,"\x278"],"\x3E"=>[77,"\x279"],"\x3F"=>[18,"\x279"],"\x40"=>[77,"\x27\x3D"],"A"=>[18,"\x27\x3D"],"B"=>[77,"\x27A"],"C"=>[18,"\x27A"],"D"=>[77,"\x27_"],"E"=>[18,"\x27_"],"F"=>[77,"\x27b"],"G"=>[18,"\x27b"],"H"=>[77,"\x27d"],"I"=>[18,"\x27d"],"J"=>[77,"\x27f"],"K"=>[18,"\x27f"],"L"=>[77,"\x27g"],"M"=>[18,"\x27g"],"N"=>[77,"\x27h"],"O"=>[18,"\x27h"],"P"=>[77,"\x27l"],"Q"=>[18,"\x27l"],"R"=>[77,"\x27m"],"S"=>[18,"\x27m"],"T"=>[77,"\x27n"],"U"=>[18,"\x27n"],"V"=>[77,"\x27p"],"W"=>[18,"\x27p"],"X"=>[77,"\x27r"],"Y"=>[18,"\x27r"],"Z"=>[77,"\x27u"],"\x5B"=>[18,"\x27u"],"\x5C"=>[0,"\x27\x3A"],"\x5D"=>[0,"\x27B"],"\x5E"=>[0,"\x27C"],"_"=>[0,"\x27D"],"\x60"=>[0,"\x27E"],"a"=>[0,"\x27F"],"b"=>[0,"\x27G"],"c"=>[0,"\x27H"],"d"=>[0,"\x27I"],"e"=>[0,"\x27J"],"f"=>[0,"\x27K"],"g"=>[0,"\x27L"],"h"=>[0,"\x27M"],"i"=>[0,"\x27N"],"j"=>[0,"\x27O"],"k"=>[0,"\x27P"],"l"=>[0,"\x27Q"],"m"=>[0,"\x27R"],"n"=>[0,"\x27S"],"o"=>[0,"\x27T"],"p"=>[0,"\x27U"],"q"=>[0,"\x27V"],"r"=>[0,"\x27W"],"s"=>[0,"\x27Y"],"t"=>[0,"\x27j"],"u"=>[0,"\x27k"],"v"=>[0,"\x27q"],"w"=>[0,"\x27v"],"x"=>[0,"\x27w"],"y"=>[0,"\x27x"],"z"=>[0,"\x27y"],"\x7B"=>[0,"\x27z"],"\x7C"=>[82,"\x27"],"\x7D"=>[87,"\x27"],"~"=>[130,"\x27"],"\x7F"=>[9,"\x27"],"\x80"=>[94,"\x2B0"],"\x81"=>[76,"\x2B0"],"\x82"=>[104,"\x2B0"],"\x83"=>[16,"\x2B0"],"\x84"=>[94,"\x2B1"],"\x85"=>[76,"\x2B1"],"\x86"=>[104,"\x2B1"],"\x87"=>[16,"\x2B1"],"\x88"=>[94,"\x2B2"],"\x89"=>[76,"\x2B2"],"\x8A"=>[104,"\x2B2"],"\x8B"=>[16,"\x2B2"],"\x8C"=>[94,"\x2Ba"],"\x8D"=>[76,"\x2Ba"],"\x8E"=>[104,"\x2Ba"],"\x8F"=>[16,"\x2Ba"],"\x90"=>[94,"\x2Bc"],"\x91"=>[76,"\x2Bc"],"\x92"=>[104,"\x2Bc"],"\x93"=>[16,"\x2Bc"],"\x94"=>[94,"\x2Be"],"\x95"=>[76,"\x2Be"],"\x96"=>[104,"\x2Be"],"\x97"=>[16,"\x2Be"],"\x98"=>[94,"\x2Bi"],"\x99"=>[76,"\x2Bi"],"\x9A"=>[104,"\x2Bi"],"\x9B"=>[16,"\x2Bi"],"\x9C"=>[94,"\x2Bo"],"\x9D"=>[76,"\x2Bo"],"\x9E"=>[104,"\x2Bo"],"\x9F"=>[16,"\x2Bo"],"\xA0"=>[94,"\x2Bs"],"\xA1"=>[76,"\x2Bs"],"\xA2"=>[104,"\x2Bs"],"\xA3"=>[16,"\x2Bs"],"\xA4"=>[94,"\x2Bt"],"\xA5"=>[76,"\x2Bt"],"\xA6"=>[104,"\x2Bt"],"\xA7"=>[16,"\x2Bt"],"\xA8"=>[77,"\x2B\x20"],"\xA9"=>[18,"\x2B\x20"],"\xAA"=>[77,"\x2B\x25"],"\xAB"=>[18,"\x2B\x25"],"\xAC"=>[77,"\x2B-"],"\xAD"=>[18,"\x2B-"],"\xAE"=>[77,"\x2B."],"\xAF"=>[18,"\x2B."],"\xB0"=>[77,"\x2B\x2F"],"\xB1"=>[18,"\x2B\x2F"],"\xB2"=>[77,"\x2B3"],"\xB3"=>[18,"\x2B3"],"\xB4"=>[77,"\x2B4"],"\xB5"=>[18,"\x2B4"],"\xB6"=>[77,"\x2B5"],"\xB7"=>[18,"\x2B5"],"\xB8"=>[77,"\x2B6"],"\xB9"=>[18,"\x2B6"],"\xBA"=>[77,"\x2B7"],"\xBB"=>[18,"\x2B7"],"\xBC"=>[77,"\x2B8"],"\xBD"=>[18,"\x2B8"],"\xBE"=>[77,"\x2B9"],"\xBF"=>[18,"\x2B9"],"\xC0"=>[77,"\x2B\x3D"],"\xC1"=>[18,"\x2B\x3D"],"\xC2"=>[77,"\x2BA"],"\xC3"=>[18,"\x2BA"],"\xC4"=>[77,"\x2B_"],"\xC5"=>[18,"\x2B_"],"\xC6"=>[77,"\x2Bb"],"\xC7"=>[18,"\x2Bb"],"\xC8"=>[77,"\x2Bd"],"\xC9"=>[18,"\x2Bd"],"\xCA"=>[77,"\x2Bf"],"\xCB"=>[18,"\x2Bf"],"\xCC"=>[77,"\x2Bg"],"\xCD"=>[18,"\x2Bg"],"\xCE"=>[77,"\x2Bh"],"\xCF"=>[18,"\x2Bh"],"\xD0"=>[77,"\x2Bl"],"\xD1"=>[18,"\x2Bl"],"\xD2"=>[77,"\x2Bm"],"\xD3"=>[18,"\x2Bm"],"\xD4"=>[77,"\x2Bn"],"\xD5"=>[18,"\x2Bn"],"\xD6"=>[77,"\x2Bp"],"\xD7"=>[18,"\x2Bp"],"\xD8"=>[77,"\x2Br"],"\xD9"=>[18,"\x2Br"],"\xDA"=>[77,"\x2Bu"],"\xDB"=>[18,"\x2Bu"],"\xDC"=>[0,"\x2B\x3A"],"\xDD"=>[0,"\x2BB"],"\xDE"=>[0,"\x2BC"],"\xDF"=>[0,"\x2BD"],"\xE0"=>[0,"\x2BE"],"\xE1"=>[0,"\x2BF"],"\xE2"=>[0,"\x2BG"],"\xE3"=>[0,"\x2BH"],"\xE4"=>[0,"\x2BI"],"\xE5"=>[0,"\x2BJ"],"\xE6"=>[0,"\x2BK"],"\xE7"=>[0,"\x2BL"],"\xE8"=>[0,"\x2BM"],"\xE9"=>[0,"\x2BN"],"\xEA"=>[0,"\x2BO"],"\xEB"=>[0,"\x2BP"],"\xEC"=>[0,"\x2BQ"],"\xED"=>[0,"\x2BR"],"\xEE"=>[0,"\x2BS"],"\xEF"=>[0,"\x2BT"],"\xF0"=>[0,"\x2BU"],"\xF1"=>[0,"\x2BV"],"\xF2"=>[0,"\x2BW"],"\xF3"=>[0,"\x2BY"],"\xF4"=>[0,"\x2Bj"],"\xF5"=>[0,"\x2Bk"],"\xF6"=>[0,"\x2Bq"],"\xF7"=>[0,"\x2Bv"],"\xF8"=>[0,"\x2Bw"],"\xF9"=>[0,"\x2Bx"],"\xFA"=>[0,"\x2By"],"\xFB"=>[0,"\x2Bz"],"\xFC"=>[82,"\x2B"],"\xFD"=>[87,"\x2B"],"\xFE"=>[130,"\x2B"],"\xFF"=>[9,"\x2B"],],["\x00"=>[94,"\x3F0"],"\x01"=>[76,"\x3F0"],"\x02"=>[104,"\x3F0"],"\x03"=>[16,"\x3F0"],"\x04"=>[94,"\x3F1"],"\x05"=>[76,"\x3F1"],"\x06"=>[104,"\x3F1"],"\x07"=>[16,"\x3F1"],"\x08"=>[94,"\x3F2"],"\x09"=>[76,"\x3F2"],"\x0A"=>[104,"\x3F2"],"\x0B"=>[16,"\x3F2"],"\x0C"=>[94,"\x3Fa"],"\x0D"=>[76,"\x3Fa"],"\x0E"=>[104,"\x3Fa"],"\x0F"=>[16,"\x3Fa"],"\x10"=>[94,"\x3Fc"],"\x11"=>[76,"\x3Fc"],"\x12"=>[104,"\x3Fc"],"\x13"=>[16,"\x3Fc"],"\x14"=>[94,"\x3Fe"],"\x15"=>[76,"\x3Fe"],"\x16"=>[104,"\x3Fe"],"\x17"=>[16,"\x3Fe"],"\x18"=>[94,"\x3Fi"],"\x19"=>[76,"\x3Fi"],"\x1A"=>[104,"\x3Fi"],"\x1B"=>[16,"\x3Fi"],"\x1C"=>[94,"\x3Fo"],"\x1D"=>[76,"\x3Fo"],"\x1E"=>[104,"\x3Fo"],"\x1F"=>[16,"\x3Fo"],"\x20"=>[94,"\x3Fs"],"\x21"=>[76,"\x3Fs"],"\x22"=>[104,"\x3Fs"],"\x23"=>[16,"\x3Fs"],"\x24"=>[94,"\x3Ft"],"\x25"=>[76,"\x3Ft"],"\x26"=>[104,"\x3Ft"],"\x27"=>[16,"\x3Ft"],"\x28"=>[77,"\x3F\x20"],"\x29"=>[18,"\x3F\x20"],"\x2A"=>[77,"\x3F\x25"],"\x2B"=>[18,"\x3F\x25"],"\x2C"=>[77,"\x3F-"],"-"=>[18,"\x3F-"],"."=>[77,"\x3F."],"\x2F"=>[18,"\x3F."],[77,"\x3F\x2F"],[18,"\x3F\x2F"],[77,"\x3F3"],[18,"\x3F3"],[77,"\x3F4"],[18,"\x3F4"],[77,"\x3F5"],[18,"\x3F5"],[77,"\x3F6"],[18,"\x3F6"],"\x3A"=>[77,"\x3F7"],"\x3B"=>[18,"\x3F7"],"\x3C"=>[77,"\x3F8"],"\x3D"=>[18,"\x3F8"],"\x3E"=>[77,"\x3F9"],"\x3F"=>[18,"\x3F9"],"\x40"=>[77,"\x3F\x3D"],"A"=>[18,"\x3F\x3D"],"B"=>[77,"\x3FA"],"C"=>[18,"\x3FA"],"D"=>[77,"\x3F_"],"E"=>[18,"\x3F_"],"F"=>[77,"\x3Fb"],"G"=>[18,"\x3Fb"],"H"=>[77,"\x3Fd"],"I"=>[18,"\x3Fd"],"J"=>[77,"\x3Ff"],"K"=>[18,"\x3Ff"],"L"=>[77,"\x3Fg"],"M"=>[18,"\x3Fg"],"N"=>[77,"\x3Fh"],"O"=>[18,"\x3Fh"],"P"=>[77,"\x3Fl"],"Q"=>[18,"\x3Fl"],"R"=>[77,"\x3Fm"],"S"=>[18,"\x3Fm"],"T"=>[77,"\x3Fn"],"U"=>[18,"\x3Fn"],"V"=>[77,"\x3Fp"],"W"=>[18,"\x3Fp"],"X"=>[77,"\x3Fr"],"Y"=>[18,"\x3Fr"],"Z"=>[77,"\x3Fu"],"\x5B"=>[18,"\x3Fu"],"\x5C"=>[0,"\x3F\x3A"],"\x5D"=>[0,"\x3FB"],"\x5E"=>[0,"\x3FC"],"_"=>[0,"\x3FD"],"\x60"=>[0,"\x3FE"],"a"=>[0,"\x3FF"],"b"=>[0,"\x3FG"],"c"=>[0,"\x3FH"],"d"=>[0,"\x3FI"],"e"=>[0,"\x3FJ"],"f"=>[0,"\x3FK"],"g"=>[0,"\x3FL"],"h"=>[0,"\x3FM"],"i"=>[0,"\x3FN"],"j"=>[0,"\x3FO"],"k"=>[0,"\x3FP"],"l"=>[0,"\x3FQ"],"m"=>[0,"\x3FR"],"n"=>[0,"\x3FS"],"o"=>[0,"\x3FT"],"p"=>[0,"\x3FU"],"q"=>[0,"\x3FV"],"r"=>[0,"\x3FW"],"s"=>[0,"\x3FY"],"t"=>[0,"\x3Fj"],"u"=>[0,"\x3Fk"],"v"=>[0,"\x3Fq"],"w"=>[0,"\x3Fv"],"x"=>[0,"\x3Fw"],"y"=>[0,"\x3Fx"],"z"=>[0,"\x3Fy"],"\x7B"=>[0,"\x3Fz"],"\x7C"=>[82,"\x3F"],"\x7D"=>[87,"\x3F"],"~"=>[130,"\x3F"],"\x7F"=>[9,"\x3F"],"\x80"=>[77,"\x270"],"\x81"=>[18,"\x270"],"\x82"=>[77,"\x271"],"\x83"=>[18,"\x271"],"\x84"=>[77,"\x272"],"\x85"=>[18,"\x272"],"\x86"=>[77,"\x27a"],"\x87"=>[18,"\x27a"],"\x88"=>[77,"\x27c"],"\x89"=>[18,"\x27c"],"\x8A"=>[77,"\x27e"],"\x8B"=>[18,"\x27e"],"\x8C"=>[77,"\x27i"],"\x8D"=>[18,"\x27i"],"\x8E"=>[77,"\x27o"],"\x8F"=>[18,"\x27o"],"\x90"=>[77,"\x27s"],"\x91"=>[18,"\x27s"],"\x92"=>[77,"\x27t"],"\x93"=>[18,"\x27t"],"\x94"=>[0,"\x27\x20"],"\x95"=>[0,"\x27\x25"],"\x96"=>[0,"\x27-"],"\x97"=>[0,"\x27."],"\x98"=>[0,"\x27\x2F"],"\x99"=>[0,"\x273"],"\x9A"=>[0,"\x274"],"\x9B"=>[0,"\x275"],"\x9C"=>[0,"\x276"],"\x9D"=>[0,"\x277"],"\x9E"=>[0,"\x278"],"\x9F"=>[0,"\x279"],"\xA0"=>[0,"\x27\x3D"],"\xA1"=>[0,"\x27A"],"\xA2"=>[0,"\x27_"],"\xA3"=>[0,"\x27b"],"\xA4"=>[0,"\x27d"],"\xA5"=>[0,"\x27f"],"\xA6"=>[0,"\x27g"],"\xA7"=>[0,"\x27h"],"\xA8"=>[0,"\x27l"],"\xA9"=>[0,"\x27m"],"\xAA"=>[0,"\x27n"],"\xAB"=>[0,"\x27p"],"\xAC"=>[0,"\x27r"],"\xAD"=>[0,"\x27u"],"\xAE"=>[100,"\x27"],"\xAF"=>[110,"\x27"],"\xB0"=>[111,"\x27"],"\xB1"=>[115,"\x27"],"\xB2"=>[116,"\x27"],"\xB3"=>[118,"\x27"],"\xB4"=>[119,"\x27"],"\xB5"=>[122,"\x27"],"\xB6"=>[123,"\x27"],"\xB7"=>[125,"\x27"],"\xB8"=>[126,"\x27"],"\xB9"=>[129,"\x27"],"\xBA"=>[143,"\x27"],"\xBB"=>[148,"\x27"],"\xBC"=>[151,"\x27"],"\xBD"=>[153,"\x27"],"\xBE"=>[83,"\x27"],"\xBF"=>[10,"\x27"],"\xC0"=>[77,"\x2B0"],"\xC1"=>[18,"\x2B0"],"\xC2"=>[77,"\x2B1"],"\xC3"=>[18,"\x2B1"],"\xC4"=>[77,"\x2B2"],"\xC5"=>[18,"\x2B2"],"\xC6"=>[77,"\x2Ba"],"\xC7"=>[18,"\x2Ba"],"\xC8"=>[77,"\x2Bc"],"\xC9"=>[18,"\x2Bc"],"\xCA"=>[77,"\x2Be"],"\xCB"=>[18,"\x2Be"],"\xCC"=>[77,"\x2Bi"],"\xCD"=>[18,"\x2Bi"],"\xCE"=>[77,"\x2Bo"],"\xCF"=>[18,"\x2Bo"],"\xD0"=>[77,"\x2Bs"],"\xD1"=>[18,"\x2Bs"],"\xD2"=>[77,"\x2Bt"],"\xD3"=>[18,"\x2Bt"],"\xD4"=>[0,"\x2B\x20"],"\xD5"=>[0,"\x2B\x25"],"\xD6"=>[0,"\x2B-"],"\xD7"=>[0,"\x2B."],"\xD8"=>[0,"\x2B\x2F"],"\xD9"=>[0,"\x2B3"],"\xDA"=>[0,"\x2B4"],"\xDB"=>[0,"\x2B5"],"\xDC"=>[0,"\x2B6"],"\xDD"=>[0,"\x2B7"],"\xDE"=>[0,"\x2B8"],"\xDF"=>[0,"\x2B9"],"\xE0"=>[0,"\x2B\x3D"],"\xE1"=>[0,"\x2BA"],"\xE2"=>[0,"\x2B_"],"\xE3"=>[0,"\x2Bb"],"\xE4"=>[0,"\x2Bd"],"\xE5"=>[0,"\x2Bf"],"\xE6"=>[0,"\x2Bg"],"\xE7"=>[0,"\x2Bh"],"\xE8"=>[0,"\x2Bl"],"\xE9"=>[0,"\x2Bm"],"\xEA"=>[0,"\x2Bn"],"\xEB"=>[0,"\x2Bp"],"\xEC"=>[0,"\x2Br"],"\xED"=>[0,"\x2Bu"],"\xEE"=>[100,"\x2B"],"\xEF"=>[110,"\x2B"],"\xF0"=>[111,"\x2B"],"\xF1"=>[115,"\x2B"],"\xF2"=>[116,"\x2B"],"\xF3"=>[118,"\x2B"],"\xF4"=>[119,"\x2B"],"\xF5"=>[122,"\x2B"],"\xF6"=>[123,"\x2B"],"\xF7"=>[125,"\x2B"],"\xF8"=>[126,"\x2B"],"\xF9"=>[129,"\x2B"],"\xFA"=>[143,"\x2B"],"\xFB"=>[148,"\x2B"],"\xFC"=>[151,"\x2B"],"\xFD"=>[153,"\x2B"],"\xFE"=>[83,"\x2B"],"\xFF"=>[10,"\x2B"],],["\x00"=>[94,"\x280"],"\x01"=>[76,"\x280"],"\x02"=>[104,"\x280"],"\x03"=>[16,"\x280"],"\x04"=>[94,"\x281"],"\x05"=>[76,"\x281"],"\x06"=>[104,"\x281"],"\x07"=>[16,"\x281"],"\x08"=>[94,"\x282"],"\x09"=>[76,"\x282"],"\x0A"=>[104,"\x282"],"\x0B"=>[16,"\x282"],"\x0C"=>[94,"\x28a"],"\x0D"=>[76,"\x28a"],"\x0E"=>[104,"\x28a"],"\x0F"=>[16,"\x28a"],"\x10"=>[94,"\x28c"],"\x11"=>[76,"\x28c"],"\x12"=>[104,"\x28c"],"\x13"=>[16,"\x28c"],"\x14"=>[94,"\x28e"],"\x15"=>[76,"\x28e"],"\x16"=>[104,"\x28e"],"\x17"=>[16,"\x28e"],"\x18"=>[94,"\x28i"],"\x19"=>[76,"\x28i"],"\x1A"=>[104,"\x28i"],"\x1B"=>[16,"\x28i"],"\x1C"=>[94,"\x28o"],"\x1D"=>[76,"\x28o"],"\x1E"=>[104,"\x28o"],"\x1F"=>[16,"\x28o"],"\x20"=>[94,"\x28s"],"\x21"=>[76,"\x28s"],"\x22"=>[104,"\x28s"],"\x23"=>[16,"\x28s"],"\x24"=>[94,"\x28t"],"\x25"=>[76,"\x28t"],"\x26"=>[104,"\x28t"],"\x27"=>[16,"\x28t"],"\x28"=>[77,"\x28\x20"],"\x29"=>[18,"\x28\x20"],"\x2A"=>[77,"\x28\x25"],"\x2B"=>[18,"\x28\x25"],"\x2C"=>[77,"\x28-"],"-"=>[18,"\x28-"],"."=>[77,"\x28."],"\x2F"=>[18,"\x28."],[77,"\x28\x2F"],[18,"\x28\x2F"],[77,"\x283"],[18,"\x283"],[77,"\x284"],[18,"\x284"],[77,"\x285"],[18,"\x285"],[77,"\x286"],[18,"\x286"],"\x3A"=>[77,"\x287"],"\x3B"=>[18,"\x287"],"\x3C"=>[77,"\x288"],"\x3D"=>[18,"\x288"],"\x3E"=>[77,"\x289"],"\x3F"=>[18,"\x289"],"\x40"=>[77,"\x28\x3D"],"A"=>[18,"\x28\x3D"],"B"=>[77,"\x28A"],"C"=>[18,"\x28A"],"D"=>[77,"\x28_"],"E"=>[18,"\x28_"],"F"=>[77,"\x28b"],"G"=>[18,"\x28b"],"H"=>[77,"\x28d"],"I"=>[18,"\x28d"],"J"=>[77,"\x28f"],"K"=>[18,"\x28f"],"L"=>[77,"\x28g"],"M"=>[18,"\x28g"],"N"=>[77,"\x28h"],"O"=>[18,"\x28h"],"P"=>[77,"\x28l"],"Q"=>[18,"\x28l"],"R"=>[77,"\x28m"],"S"=>[18,"\x28m"],"T"=>[77,"\x28n"],"U"=>[18,"\x28n"],"V"=>[77,"\x28p"],"W"=>[18,"\x28p"],"X"=>[77,"\x28r"],"Y"=>[18,"\x28r"],"Z"=>[77,"\x28u"],"\x5B"=>[18,"\x28u"],"\x5C"=>[0,"\x28\x3A"],"\x5D"=>[0,"\x28B"],"\x5E"=>[0,"\x28C"],"_"=>[0,"\x28D"],"\x60"=>[0,"\x28E"],"a"=>[0,"\x28F"],"b"=>[0,"\x28G"],"c"=>[0,"\x28H"],"d"=>[0,"\x28I"],"e"=>[0,"\x28J"],"f"=>[0,"\x28K"],"g"=>[0,"\x28L"],"h"=>[0,"\x28M"],"i"=>[0,"\x28N"],"j"=>[0,"\x28O"],"k"=>[0,"\x28P"],"l"=>[0,"\x28Q"],"m"=>[0,"\x28R"],"n"=>[0,"\x28S"],"o"=>[0,"\x28T"],"p"=>[0,"\x28U"],"q"=>[0,"\x28V"],"r"=>[0,"\x28W"],"s"=>[0,"\x28Y"],"t"=>[0,"\x28j"],"u"=>[0,"\x28k"],"v"=>[0,"\x28q"],"w"=>[0,"\x28v"],"x"=>[0,"\x28w"],"y"=>[0,"\x28x"],"z"=>[0,"\x28y"],"\x7B"=>[0,"\x28z"],"\x7C"=>[82,"\x28"],"\x7D"=>[87,"\x28"],"~"=>[130,"\x28"],"\x7F"=>[9,"\x28"],"\x80"=>[94,"\x290"],"\x81"=>[76,"\x290"],"\x82"=>[104,"\x290"],"\x83"=>[16,"\x290"],"\x84"=>[94,"\x291"],"\x85"=>[76,"\x291"],"\x86"=>[104,"\x291"],"\x87"=>[16,"\x291"],"\x88"=>[94,"\x292"],"\x89"=>[76,"\x292"],"\x8A"=>[104,"\x292"],"\x8B"=>[16,"\x292"],"\x8C"=>[94,"\x29a"],"\x8D"=>[76,"\x29a"],"\x8E"=>[104,"\x29a"],"\x8F"=>[16,"\x29a"],"\x90"=>[94,"\x29c"],"\x91"=>[76,"\x29c"],"\x92"=>[104,"\x29c"],"\x93"=>[16,"\x29c"],"\x94"=>[94,"\x29e"],"\x95"=>[76,"\x29e"],"\x96"=>[104,"\x29e"],"\x97"=>[16,"\x29e"],"\x98"=>[94,"\x29i"],"\x99"=>[76,"\x29i"],"\x9A"=>[104,"\x29i"],"\x9B"=>[16,"\x29i"],"\x9C"=>[94,"\x29o"],"\x9D"=>[76,"\x29o"],"\x9E"=>[104,"\x29o"],"\x9F"=>[16,"\x29o"],"\xA0"=>[94,"\x29s"],"\xA1"=>[76,"\x29s"],"\xA2"=>[104,"\x29s"],"\xA3"=>[16,"\x29s"],"\xA4"=>[94,"\x29t"],"\xA5"=>[76,"\x29t"],"\xA6"=>[104,"\x29t"],"\xA7"=>[16,"\x29t"],"\xA8"=>[77,"\x29\x20"],"\xA9"=>[18,"\x29\x20"],"\xAA"=>[77,"\x29\x25"],"\xAB"=>[18,"\x29\x25"],"\xAC"=>[77,"\x29-"],"\xAD"=>[18,"\x29-"],"\xAE"=>[77,"\x29."],"\xAF"=>[18,"\x29."],"\xB0"=>[77,"\x29\x2F"],"\xB1"=>[18,"\x29\x2F"],"\xB2"=>[77,"\x293"],"\xB3"=>[18,"\x293"],"\xB4"=>[77,"\x294"],"\xB5"=>[18,"\x294"],"\xB6"=>[77,"\x295"],"\xB7"=>[18,"\x295"],"\xB8"=>[77,"\x296"],"\xB9"=>[18,"\x296"],"\xBA"=>[77,"\x297"],"\xBB"=>[18,"\x297"],"\xBC"=>[77,"\x298"],"\xBD"=>[18,"\x298"],"\xBE"=>[77,"\x299"],"\xBF"=>[18,"\x299"],"\xC0"=>[77,"\x29\x3D"],"\xC1"=>[18,"\x29\x3D"],"\xC2"=>[77,"\x29A"],"\xC3"=>[18,"\x29A"],"\xC4"=>[77,"\x29_"],"\xC5"=>[18,"\x29_"],"\xC6"=>[77,"\x29b"],"\xC7"=>[18,"\x29b"],"\xC8"=>[77,"\x29d"],"\xC9"=>[18,"\x29d"],"\xCA"=>[77,"\x29f"],"\xCB"=>[18,"\x29f"],"\xCC"=>[77,"\x29g"],"\xCD"=>[18,"\x29g"],"\xCE"=>[77,"\x29h"],"\xCF"=>[18,"\x29h"],"\xD0"=>[77,"\x29l"],"\xD1"=>[18,"\x29l"],"\xD2"=>[77,"\x29m"],"\xD3"=>[18,"\x29m"],"\xD4"=>[77,"\x29n"],"\xD5"=>[18,"\x29n"],"\xD6"=>[77,"\x29p"],"\xD7"=>[18,"\x29p"],"\xD8"=>[77,"\x29r"],"\xD9"=>[18,"\x29r"],"\xDA"=>[77,"\x29u"],"\xDB"=>[18,"\x29u"],"\xDC"=>[0,"\x29\x3A"],"\xDD"=>[0,"\x29B"],"\xDE"=>[0,"\x29C"],"\xDF"=>[0,"\x29D"],"\xE0"=>[0,"\x29E"],"\xE1"=>[0,"\x29F"],"\xE2"=>[0,"\x29G"],"\xE3"=>[0,"\x29H"],"\xE4"=>[0,"\x29I"],"\xE5"=>[0,"\x29J"],"\xE6"=>[0,"\x29K"],"\xE7"=>[0,"\x29L"],"\xE8"=>[0,"\x29M"],"\xE9"=>[0,"\x29N"],"\xEA"=>[0,"\x29O"],"\xEB"=>[0,"\x29P"],"\xEC"=>[0,"\x29Q"],"\xED"=>[0,"\x29R"],"\xEE"=>[0,"\x29S"],"\xEF"=>[0,"\x29T"],"\xF0"=>[0,"\x29U"],"\xF1"=>[0,"\x29V"],"\xF2"=>[0,"\x29W"],"\xF3"=>[0,"\x29Y"],"\xF4"=>[0,"\x29j"],"\xF5"=>[0,"\x29k"],"\xF6"=>[0,"\x29q"],"\xF7"=>[0,"\x29v"],"\xF8"=>[0,"\x29w"],"\xF9"=>[0,"\x29x"],"\xFA"=>[0,"\x29y"],"\xFB"=>[0,"\x29z"],"\xFC"=>[82,"\x29"],"\xFD"=>[87,"\x29"],"\xFE"=>[130,"\x29"],"\xFF"=>[9,"\x29"],],["\x00"=>[94,"\x2C0"],"\x01"=>[76,"\x2C0"],"\x02"=>[104,"\x2C0"],"\x03"=>[16,"\x2C0"],"\x04"=>[94,"\x2C1"],"\x05"=>[76,"\x2C1"],"\x06"=>[104,"\x2C1"],"\x07"=>[16,"\x2C1"],"\x08"=>[94,"\x2C2"],"\x09"=>[76,"\x2C2"],"\x0A"=>[104,"\x2C2"],"\x0B"=>[16,"\x2C2"],"\x0C"=>[94,"\x2Ca"],"\x0D"=>[76,"\x2Ca"],"\x0E"=>[104,"\x2Ca"],"\x0F"=>[16,"\x2Ca"],"\x10"=>[94,"\x2Cc"],"\x11"=>[76,"\x2Cc"],"\x12"=>[104,"\x2Cc"],"\x13"=>[16,"\x2Cc"],"\x14"=>[94,"\x2Ce"],"\x15"=>[76,"\x2Ce"],"\x16"=>[104,"\x2Ce"],"\x17"=>[16,"\x2Ce"],"\x18"=>[94,"\x2Ci"],"\x19"=>[76,"\x2Ci"],"\x1A"=>[104,"\x2Ci"],"\x1B"=>[16,"\x2Ci"],"\x1C"=>[94,"\x2Co"],"\x1D"=>[76,"\x2Co"],"\x1E"=>[104,"\x2Co"],"\x1F"=>[16,"\x2Co"],"\x20"=>[94,"\x2Cs"],"\x21"=>[76,"\x2Cs"],"\x22"=>[104,"\x2Cs"],"\x23"=>[16,"\x2Cs"],"\x24"=>[94,"\x2Ct"],"\x25"=>[76,"\x2Ct"],"\x26"=>[104,"\x2Ct"],"\x27"=>[16,"\x2Ct"],"\x28"=>[77,"\x2C\x20"],"\x29"=>[18,"\x2C\x20"],"\x2A"=>[77,"\x2C\x25"],"\x2B"=>[18,"\x2C\x25"],"\x2C"=>[77,"\x2C-"],"-"=>[18,"\x2C-"],"."=>[77,"\x2C."],"\x2F"=>[18,"\x2C."],[77,"\x2C\x2F"],[18,"\x2C\x2F"],[77,"\x2C3"],[18,"\x2C3"],[77,"\x2C4"],[18,"\x2C4"],[77,"\x2C5"],[18,"\x2C5"],[77,"\x2C6"],[18,"\x2C6"],"\x3A"=>[77,"\x2C7"],"\x3B"=>[18,"\x2C7"],"\x3C"=>[77,"\x2C8"],"\x3D"=>[18,"\x2C8"],"\x3E"=>[77,"\x2C9"],"\x3F"=>[18,"\x2C9"],"\x40"=>[77,"\x2C\x3D"],"A"=>[18,"\x2C\x3D"],"B"=>[77,"\x2CA"],"C"=>[18,"\x2CA"],"D"=>[77,"\x2C_"],"E"=>[18,"\x2C_"],"F"=>[77,"\x2Cb"],"G"=>[18,"\x2Cb"],"H"=>[77,"\x2Cd"],"I"=>[18,"\x2Cd"],"J"=>[77,"\x2Cf"],"K"=>[18,"\x2Cf"],"L"=>[77,"\x2Cg"],"M"=>[18,"\x2Cg"],"N"=>[77,"\x2Ch"],"O"=>[18,"\x2Ch"],"P"=>[77,"\x2Cl"],"Q"=>[18,"\x2Cl"],"R"=>[77,"\x2Cm"],"S"=>[18,"\x2Cm"],"T"=>[77,"\x2Cn"],"U"=>[18,"\x2Cn"],"V"=>[77,"\x2Cp"],"W"=>[18,"\x2Cp"],"X"=>[77,"\x2Cr"],"Y"=>[18,"\x2Cr"],"Z"=>[77,"\x2Cu"],"\x5B"=>[18,"\x2Cu"],"\x5C"=>[0,"\x2C\x3A"],"\x5D"=>[0,"\x2CB"],"\x5E"=>[0,"\x2CC"],"_"=>[0,"\x2CD"],"\x60"=>[0,"\x2CE"],"a"=>[0,"\x2CF"],"b"=>[0,"\x2CG"],"c"=>[0,"\x2CH"],"d"=>[0,"\x2CI"],"e"=>[0,"\x2CJ"],"f"=>[0,"\x2CK"],"g"=>[0,"\x2CL"],"h"=>[0,"\x2CM"],"i"=>[0,"\x2CN"],"j"=>[0,"\x2CO"],"k"=>[0,"\x2CP"],"l"=>[0,"\x2CQ"],"m"=>[0,"\x2CR"],"n"=>[0,"\x2CS"],"o"=>[0,"\x2CT"],"p"=>[0,"\x2CU"],"q"=>[0,"\x2CV"],"r"=>[0,"\x2CW"],"s"=>[0,"\x2CY"],"t"=>[0,"\x2Cj"],"u"=>[0,"\x2Ck"],"v"=>[0,"\x2Cq"],"w"=>[0,"\x2Cv"],"x"=>[0,"\x2Cw"],"y"=>[0,"\x2Cx"],"z"=>[0,"\x2Cy"],"\x7B"=>[0,"\x2Cz"],"\x7C"=>[82,"\x2C"],"\x7D"=>[87,"\x2C"],"~"=>[130,"\x2C"],"\x7F"=>[9,"\x2C"],"\x80"=>[94,"\x3B0"],"\x81"=>[76,"\x3B0"],"\x82"=>[104,"\x3B0"],"\x83"=>[16,"\x3B0"],"\x84"=>[94,"\x3B1"],"\x85"=>[76,"\x3B1"],"\x86"=>[104,"\x3B1"],"\x87"=>[16,"\x3B1"],"\x88"=>[94,"\x3B2"],"\x89"=>[76,"\x3B2"],"\x8A"=>[104,"\x3B2"],"\x8B"=>[16,"\x3B2"],"\x8C"=>[94,"\x3Ba"],"\x8D"=>[76,"\x3Ba"],"\x8E"=>[104,"\x3Ba"],"\x8F"=>[16,"\x3Ba"],"\x90"=>[94,"\x3Bc"],"\x91"=>[76,"\x3Bc"],"\x92"=>[104,"\x3Bc"],"\x93"=>[16,"\x3Bc"],"\x94"=>[94,"\x3Be"],"\x95"=>[76,"\x3Be"],"\x96"=>[104,"\x3Be"],"\x97"=>[16,"\x3Be"],"\x98"=>[94,"\x3Bi"],"\x99"=>[76,"\x3Bi"],"\x9A"=>[104,"\x3Bi"],"\x9B"=>[16,"\x3Bi"],"\x9C"=>[94,"\x3Bo"],"\x9D"=>[76,"\x3Bo"],"\x9E"=>[104,"\x3Bo"],"\x9F"=>[16,"\x3Bo"],"\xA0"=>[94,"\x3Bs"],"\xA1"=>[76,"\x3Bs"],"\xA2"=>[104,"\x3Bs"],"\xA3"=>[16,"\x3Bs"],"\xA4"=>[94,"\x3Bt"],"\xA5"=>[76,"\x3Bt"],"\xA6"=>[104,"\x3Bt"],"\xA7"=>[16,"\x3Bt"],"\xA8"=>[77,"\x3B\x20"],"\xA9"=>[18,"\x3B\x20"],"\xAA"=>[77,"\x3B\x25"],"\xAB"=>[18,"\x3B\x25"],"\xAC"=>[77,"\x3B-"],"\xAD"=>[18,"\x3B-"],"\xAE"=>[77,"\x3B."],"\xAF"=>[18,"\x3B."],"\xB0"=>[77,"\x3B\x2F"],"\xB1"=>[18,"\x3B\x2F"],"\xB2"=>[77,"\x3B3"],"\xB3"=>[18,"\x3B3"],"\xB4"=>[77,"\x3B4"],"\xB5"=>[18,"\x3B4"],"\xB6"=>[77,"\x3B5"],"\xB7"=>[18,"\x3B5"],"\xB8"=>[77,"\x3B6"],"\xB9"=>[18,"\x3B6"],"\xBA"=>[77,"\x3B7"],"\xBB"=>[18,"\x3B7"],"\xBC"=>[77,"\x3B8"],"\xBD"=>[18,"\x3B8"],"\xBE"=>[77,"\x3B9"],"\xBF"=>[18,"\x3B9"],"\xC0"=>[77,"\x3B\x3D"],"\xC1"=>[18,"\x3B\x3D"],"\xC2"=>[77,"\x3BA"],"\xC3"=>[18,"\x3BA"],"\xC4"=>[77,"\x3B_"],"\xC5"=>[18,"\x3B_"],"\xC6"=>[77,"\x3Bb"],"\xC7"=>[18,"\x3Bb"],"\xC8"=>[77,"\x3Bd"],"\xC9"=>[18,"\x3Bd"],"\xCA"=>[77,"\x3Bf"],"\xCB"=>[18,"\x3Bf"],"\xCC"=>[77,"\x3Bg"],"\xCD"=>[18,"\x3Bg"],"\xCE"=>[77,"\x3Bh"],"\xCF"=>[18,"\x3Bh"],"\xD0"=>[77,"\x3Bl"],"\xD1"=>[18,"\x3Bl"],"\xD2"=>[77,"\x3Bm"],"\xD3"=>[18,"\x3Bm"],"\xD4"=>[77,"\x3Bn"],"\xD5"=>[18,"\x3Bn"],"\xD6"=>[77,"\x3Bp"],"\xD7"=>[18,"\x3Bp"],"\xD8"=>[77,"\x3Br"],"\xD9"=>[18,"\x3Br"],"\xDA"=>[77,"\x3Bu"],"\xDB"=>[18,"\x3Bu"],"\xDC"=>[0,"\x3B\x3A"],"\xDD"=>[0,"\x3BB"],"\xDE"=>[0,"\x3BC"],"\xDF"=>[0,"\x3BD"],"\xE0"=>[0,"\x3BE"],"\xE1"=>[0,"\x3BF"],"\xE2"=>[0,"\x3BG"],"\xE3"=>[0,"\x3BH"],"\xE4"=>[0,"\x3BI"],"\xE5"=>[0,"\x3BJ"],"\xE6"=>[0,"\x3BK"],"\xE7"=>[0,"\x3BL"],"\xE8"=>[0,"\x3BM"],"\xE9"=>[0,"\x3BN"],"\xEA"=>[0,"\x3BO"],"\xEB"=>[0,"\x3BP"],"\xEC"=>[0,"\x3BQ"],"\xED"=>[0,"\x3BR"],"\xEE"=>[0,"\x3BS"],"\xEF"=>[0,"\x3BT"],"\xF0"=>[0,"\x3BU"],"\xF1"=>[0,"\x3BV"],"\xF2"=>[0,"\x3BW"],"\xF3"=>[0,"\x3BY"],"\xF4"=>[0,"\x3Bj"],"\xF5"=>[0,"\x3Bk"],"\xF6"=>[0,"\x3Bq"],"\xF7"=>[0,"\x3Bv"],"\xF8"=>[0,"\x3Bw"],"\xF9"=>[0,"\x3Bx"],"\xFA"=>[0,"\x3By"],"\xFB"=>[0,"\x3Bz"],"\xFC"=>[82,"\x3B"],"\xFD"=>[87,"\x3B"],"\xFE"=>[130,"\x3B"],"\xFF"=>[9,"\x3B"],],["\x00"=>[94,"-0"],"\x01"=>[76,"-0"],"\x02"=>[104,"-0"],"\x03"=>[16,"-0"],"\x04"=>[94,"-1"],"\x05"=>[76,"-1"],"\x06"=>[104,"-1"],"\x07"=>[16,"-1"],"\x08"=>[94,"-2"],"\x09"=>[76,"-2"],"\x0A"=>[104,"-2"],"\x0B"=>[16,"-2"],"\x0C"=>[94,"-a"],"\x0D"=>[76,"-a"],"\x0E"=>[104,"-a"],"\x0F"=>[16,"-a"],"\x10"=>[94,"-c"],"\x11"=>[76,"-c"],"\x12"=>[104,"-c"],"\x13"=>[16,"-c"],"\x14"=>[94,"-e"],"\x15"=>[76,"-e"],"\x16"=>[104,"-e"],"\x17"=>[16,"-e"],"\x18"=>[94,"-i"],"\x19"=>[76,"-i"],"\x1A"=>[104,"-i"],"\x1B"=>[16,"-i"],"\x1C"=>[94,"-o"],"\x1D"=>[76,"-o"],"\x1E"=>[104,"-o"],"\x1F"=>[16,"-o"],"\x20"=>[94,"-s"],"\x21"=>[76,"-s"],"\x22"=>[104,"-s"],"\x23"=>[16,"-s"],"\x24"=>[94,"-t"],"\x25"=>[76,"-t"],"\x26"=>[104,"-t"],"\x27"=>[16,"-t"],"\x28"=>[77,"-\x20"],"\x29"=>[18,"-\x20"],"\x2A"=>[77,"-\x25"],"\x2B"=>[18,"-\x25"],"\x2C"=>[77,"--"],"-"=>[18,"--"],"."=>[77,"-."],"\x2F"=>[18,"-."],[77,"-\x2F"],[18,"-\x2F"],[77,"-3"],[18,"-3"],[77,"-4"],[18,"-4"],[77,"-5"],[18,"-5"],[77,"-6"],[18,"-6"],"\x3A"=>[77,"-7"],"\x3B"=>[18,"-7"],"\x3C"=>[77,"-8"],"\x3D"=>[18,"-8"],"\x3E"=>[77,"-9"],"\x3F"=>[18,"-9"],"\x40"=>[77,"-\x3D"],"A"=>[18,"-\x3D"],"B"=>[77,"-A"],"C"=>[18,"-A"],"D"=>[77,"-_"],"E"=>[18,"-_"],"F"=>[77,"-b"],"G"=>[18,"-b"],"H"=>[77,"-d"],"I"=>[18,"-d"],"J"=>[77,"-f"],"K"=>[18,"-f"],"L"=>[77,"-g"],"M"=>[18,"-g"],"N"=>[77,"-h"],"O"=>[18,"-h"],"P"=>[77,"-l"],"Q"=>[18,"-l"],"R"=>[77,"-m"],"S"=>[18,"-m"],"T"=>[77,"-n"],"U"=>[18,"-n"],"V"=>[77,"-p"],"W"=>[18,"-p"],"X"=>[77,"-r"],"Y"=>[18,"-r"],"Z"=>[77,"-u"],"\x5B"=>[18,"-u"],"\x5C"=>[0,"-\x3A"],"\x5D"=>[0,"-B"],"\x5E"=>[0,"-C"],"_"=>[0,"-D"],"\x60"=>[0,"-E"],"a"=>[0,"-F"],"b"=>[0,"-G"],"c"=>[0,"-H"],"d"=>[0,"-I"],"e"=>[0,"-J"],"f"=>[0,"-K"],"g"=>[0,"-L"],"h"=>[0,"-M"],"i"=>[0,"-N"],"j"=>[0,"-O"],"k"=>[0,"-P"],"l"=>[0,"-Q"],"m"=>[0,"-R"],"n"=>[0,"-S"],"o"=>[0,"-T"],"p"=>[0,"-U"],"q"=>[0,"-V"],"r"=>[0,"-W"],"s"=>[0,"-Y"],"t"=>[0,"-j"],"u"=>[0,"-k"],"v"=>[0,"-q"],"w"=>[0,"-v"],"x"=>[0,"-w"],"y"=>[0,"-x"],"z"=>[0,"-y"],"\x7B"=>[0,"-z"],"\x7C"=>[82,"-"],"\x7D"=>[87,"-"],"~"=>[130,"-"],"\x7F"=>[9,"-"],"\x80"=>[94,".0"],"\x81"=>[76,".0"],"\x82"=>[104,".0"],"\x83"=>[16,".0"],"\x84"=>[94,".1"],"\x85"=>[76,".1"],"\x86"=>[104,".1"],"\x87"=>[16,".1"],"\x88"=>[94,".2"],"\x89"=>[76,".2"],"\x8A"=>[104,".2"],"\x8B"=>[16,".2"],"\x8C"=>[94,".a"],"\x8D"=>[76,".a"],"\x8E"=>[104,".a"],"\x8F"=>[16,".a"],"\x90"=>[94,".c"],"\x91"=>[76,".c"],"\x92"=>[104,".c"],"\x93"=>[16,".c"],"\x94"=>[94,".e"],"\x95"=>[76,".e"],"\x96"=>[104,".e"],"\x97"=>[16,".e"],"\x98"=>[94,".i"],"\x99"=>[76,".i"],"\x9A"=>[104,".i"],"\x9B"=>[16,".i"],"\x9C"=>[94,".o"],"\x9D"=>[76,".o"],"\x9E"=>[104,".o"],"\x9F"=>[16,".o"],"\xA0"=>[94,".s"],"\xA1"=>[76,".s"],"\xA2"=>[104,".s"],"\xA3"=>[16,".s"],"\xA4"=>[94,".t"],"\xA5"=>[76,".t"],"\xA6"=>[104,".t"],"\xA7"=>[16,".t"],"\xA8"=>[77,".\x20"],"\xA9"=>[18,".\x20"],"\xAA"=>[77,".\x25"],"\xAB"=>[18,".\x25"],"\xAC"=>[77,".-"],"\xAD"=>[18,".-"],"\xAE"=>[77,".."],"\xAF"=>[18,".."],"\xB0"=>[77,".\x2F"],"\xB1"=>[18,".\x2F"],"\xB2"=>[77,".3"],"\xB3"=>[18,".3"],"\xB4"=>[77,".4"],"\xB5"=>[18,".4"],"\xB6"=>[77,".5"],"\xB7"=>[18,".5"],"\xB8"=>[77,".6"],"\xB9"=>[18,".6"],"\xBA"=>[77,".7"],"\xBB"=>[18,".7"],"\xBC"=>[77,".8"],"\xBD"=>[18,".8"],"\xBE"=>[77,".9"],"\xBF"=>[18,".9"],"\xC0"=>[77,".\x3D"],"\xC1"=>[18,".\x3D"],"\xC2"=>[77,".A"],"\xC3"=>[18,".A"],"\xC4"=>[77,"._"],"\xC5"=>[18,"._"],"\xC6"=>[77,".b"],"\xC7"=>[18,".b"],"\xC8"=>[77,".d"],"\xC9"=>[18,".d"],"\xCA"=>[77,".f"],"\xCB"=>[18,".f"],"\xCC"=>[77,".g"],"\xCD"=>[18,".g"],"\xCE"=>[77,".h"],"\xCF"=>[18,".h"],"\xD0"=>[77,".l"],"\xD1"=>[18,".l"],"\xD2"=>[77,".m"],"\xD3"=>[18,".m"],"\xD4"=>[77,".n"],"\xD5"=>[18,".n"],"\xD6"=>[77,".p"],"\xD7"=>[18,".p"],"\xD8"=>[77,".r"],"\xD9"=>[18,".r"],"\xDA"=>[77,".u"],"\xDB"=>[18,".u"],"\xDC"=>[0,".\x3A"],"\xDD"=>[0,".B"],"\xDE"=>[0,".C"],"\xDF"=>[0,".D"],"\xE0"=>[0,".E"],"\xE1"=>[0,".F"],"\xE2"=>[0,".G"],"\xE3"=>[0,".H"],"\xE4"=>[0,".I"],"\xE5"=>[0,".J"],"\xE6"=>[0,".K"],"\xE7"=>[0,".L"],"\xE8"=>[0,".M"],"\xE9"=>[0,".N"],"\xEA"=>[0,".O"],"\xEB"=>[0,".P"],"\xEC"=>[0,".Q"],"\xED"=>[0,".R"],"\xEE"=>[0,".S"],"\xEF"=>[0,".T"],"\xF0"=>[0,".U"],"\xF1"=>[0,".V"],"\xF2"=>[0,".W"],"\xF3"=>[0,".Y"],"\xF4"=>[0,".j"],"\xF5"=>[0,".k"],"\xF6"=>[0,".q"],"\xF7"=>[0,".v"],"\xF8"=>[0,".w"],"\xF9"=>[0,".x"],"\xFA"=>[0,".y"],"\xFB"=>[0,".z"],"\xFC"=>[82,"."],"\xFD"=>[87,"."],"\xFE"=>[130,"."],"\xFF"=>[9,"."],],["\x00"=>[94,"\x2F0"],"\x01"=>[76,"\x2F0"],"\x02"=>[104,"\x2F0"],"\x03"=>[16,"\x2F0"],"\x04"=>[94,"\x2F1"],"\x05"=>[76,"\x2F1"],"\x06"=>[104,"\x2F1"],"\x07"=>[16,"\x2F1"],"\x08"=>[94,"\x2F2"],"\x09"=>[76,"\x2F2"],"\x0A"=>[104,"\x2F2"],"\x0B"=>[16,"\x2F2"],"\x0C"=>[94,"\x2Fa"],"\x0D"=>[76,"\x2Fa"],"\x0E"=>[104,"\x2Fa"],"\x0F"=>[16,"\x2Fa"],"\x10"=>[94,"\x2Fc"],"\x11"=>[76,"\x2Fc"],"\x12"=>[104,"\x2Fc"],"\x13"=>[16,"\x2Fc"],"\x14"=>[94,"\x2Fe"],"\x15"=>[76,"\x2Fe"],"\x16"=>[104,"\x2Fe"],"\x17"=>[16,"\x2Fe"],"\x18"=>[94,"\x2Fi"],"\x19"=>[76,"\x2Fi"],"\x1A"=>[104,"\x2Fi"],"\x1B"=>[16,"\x2Fi"],"\x1C"=>[94,"\x2Fo"],"\x1D"=>[76,"\x2Fo"],"\x1E"=>[104,"\x2Fo"],"\x1F"=>[16,"\x2Fo"],"\x20"=>[94,"\x2Fs"],"\x21"=>[76,"\x2Fs"],"\x22"=>[104,"\x2Fs"],"\x23"=>[16,"\x2Fs"],"\x24"=>[94,"\x2Ft"],"\x25"=>[76,"\x2Ft"],"\x26"=>[104,"\x2Ft"],"\x27"=>[16,"\x2Ft"],"\x28"=>[77,"\x2F\x20"],"\x29"=>[18,"\x2F\x20"],"\x2A"=>[77,"\x2F\x25"],"\x2B"=>[18,"\x2F\x25"],"\x2C"=>[77,"\x2F-"],"-"=>[18,"\x2F-"],"."=>[77,"\x2F."],"\x2F"=>[18,"\x2F."],[77,"\x2F\x2F"],[18,"\x2F\x2F"],[77,"\x2F3"],[18,"\x2F3"],[77,"\x2F4"],[18,"\x2F4"],[77,"\x2F5"],[18,"\x2F5"],[77,"\x2F6"],[18,"\x2F6"],"\x3A"=>[77,"\x2F7"],"\x3B"=>[18,"\x2F7"],"\x3C"=>[77,"\x2F8"],"\x3D"=>[18,"\x2F8"],"\x3E"=>[77,"\x2F9"],"\x3F"=>[18,"\x2F9"],"\x40"=>[77,"\x2F\x3D"],"A"=>[18,"\x2F\x3D"],"B"=>[77,"\x2FA"],"C"=>[18,"\x2FA"],"D"=>[77,"\x2F_"],"E"=>[18,"\x2F_"],"F"=>[77,"\x2Fb"],"G"=>[18,"\x2Fb"],"H"=>[77,"\x2Fd"],"I"=>[18,"\x2Fd"],"J"=>[77,"\x2Ff"],"K"=>[18,"\x2Ff"],"L"=>[77,"\x2Fg"],"M"=>[18,"\x2Fg"],"N"=>[77,"\x2Fh"],"O"=>[18,"\x2Fh"],"P"=>[77,"\x2Fl"],"Q"=>[18,"\x2Fl"],"R"=>[77,"\x2Fm"],"S"=>[18,"\x2Fm"],"T"=>[77,"\x2Fn"],"U"=>[18,"\x2Fn"],"V"=>[77,"\x2Fp"],"W"=>[18,"\x2Fp"],"X"=>[77,"\x2Fr"],"Y"=>[18,"\x2Fr"],"Z"=>[77,"\x2Fu"],"\x5B"=>[18,"\x2Fu"],"\x5C"=>[0,"\x2F\x3A"],"\x5D"=>[0,"\x2FB"],"\x5E"=>[0,"\x2FC"],"_"=>[0,"\x2FD"],"\x60"=>[0,"\x2FE"],"a"=>[0,"\x2FF"],"b"=>[0,"\x2FG"],"c"=>[0,"\x2FH"],"d"=>[0,"\x2FI"],"e"=>[0,"\x2FJ"],"f"=>[0,"\x2FK"],"g"=>[0,"\x2FL"],"h"=>[0,"\x2FM"],"i"=>[0,"\x2FN"],"j"=>[0,"\x2FO"],"k"=>[0,"\x2FP"],"l"=>[0,"\x2FQ"],"m"=>[0,"\x2FR"],"n"=>[0,"\x2FS"],"o"=>[0,"\x2FT"],"p"=>[0,"\x2FU"],"q"=>[0,"\x2FV"],"r"=>[0,"\x2FW"],"s"=>[0,"\x2FY"],"t"=>[0,"\x2Fj"],"u"=>[0,"\x2Fk"],"v"=>[0,"\x2Fq"],"w"=>[0,"\x2Fv"],"x"=>[0,"\x2Fw"],"y"=>[0,"\x2Fx"],"z"=>[0,"\x2Fy"],"\x7B"=>[0,"\x2Fz"],"\x7C"=>[82,"\x2F"],"\x7D"=>[87,"\x2F"],"~"=>[130,"\x2F"],"\x7F"=>[9,"\x2F"],"\x80"=>[94,"30"],"\x81"=>[76,"30"],"\x82"=>[104,"30"],"\x83"=>[16,"30"],"\x84"=>[94,"31"],"\x85"=>[76,"31"],"\x86"=>[104,"31"],"\x87"=>[16,"31"],"\x88"=>[94,"32"],"\x89"=>[76,"32"],"\x8A"=>[104,"32"],"\x8B"=>[16,"32"],"\x8C"=>[94,"3a"],"\x8D"=>[76,"3a"],"\x8E"=>[104,"3a"],"\x8F"=>[16,"3a"],"\x90"=>[94,"3c"],"\x91"=>[76,"3c"],"\x92"=>[104,"3c"],"\x93"=>[16,"3c"],"\x94"=>[94,"3e"],"\x95"=>[76,"3e"],"\x96"=>[104,"3e"],"\x97"=>[16,"3e"],"\x98"=>[94,"3i"],"\x99"=>[76,"3i"],"\x9A"=>[104,"3i"],"\x9B"=>[16,"3i"],"\x9C"=>[94,"3o"],"\x9D"=>[76,"3o"],"\x9E"=>[104,"3o"],"\x9F"=>[16,"3o"],"\xA0"=>[94,"3s"],"\xA1"=>[76,"3s"],"\xA2"=>[104,"3s"],"\xA3"=>[16,"3s"],"\xA4"=>[94,"3t"],"\xA5"=>[76,"3t"],"\xA6"=>[104,"3t"],"\xA7"=>[16,"3t"],"\xA8"=>[77,"3\x20"],"\xA9"=>[18,"3\x20"],"\xAA"=>[77,"3\x25"],"\xAB"=>[18,"3\x25"],"\xAC"=>[77,"3-"],"\xAD"=>[18,"3-"],"\xAE"=>[77,"3."],"\xAF"=>[18,"3."],"\xB0"=>[77,"3\x2F"],"\xB1"=>[18,"3\x2F"],"\xB2"=>[77,"33"],"\xB3"=>[18,"33"],"\xB4"=>[77,"34"],"\xB5"=>[18,"34"],"\xB6"=>[77,"35"],"\xB7"=>[18,"35"],"\xB8"=>[77,"36"],"\xB9"=>[18,"36"],"\xBA"=>[77,"37"],"\xBB"=>[18,"37"],"\xBC"=>[77,"38"],"\xBD"=>[18,"38"],"\xBE"=>[77,"39"],"\xBF"=>[18,"39"],"\xC0"=>[77,"3\x3D"],"\xC1"=>[18,"3\x3D"],"\xC2"=>[77,"3A"],"\xC3"=>[18,"3A"],"\xC4"=>[77,"3_"],"\xC5"=>[18,"3_"],"\xC6"=>[77,"3b"],"\xC7"=>[18,"3b"],"\xC8"=>[77,"3d"],"\xC9"=>[18,"3d"],"\xCA"=>[77,"3f"],"\xCB"=>[18,"3f"],"\xCC"=>[77,"3g"],"\xCD"=>[18,"3g"],"\xCE"=>[77,"3h"],"\xCF"=>[18,"3h"],"\xD0"=>[77,"3l"],"\xD1"=>[18,"3l"],"\xD2"=>[77,"3m"],"\xD3"=>[18,"3m"],"\xD4"=>[77,"3n"],"\xD5"=>[18,"3n"],"\xD6"=>[77,"3p"],"\xD7"=>[18,"3p"],"\xD8"=>[77,"3r"],"\xD9"=>[18,"3r"],"\xDA"=>[77,"3u"],"\xDB"=>[18,"3u"],"\xDC"=>[0,"3\x3A"],"\xDD"=>[0,"3B"],"\xDE"=>[0,"3C"],"\xDF"=>[0,"3D"],"\xE0"=>[0,"3E"],"\xE1"=>[0,"3F"],"\xE2"=>[0,"3G"],"\xE3"=>[0,"3H"],"\xE4"=>[0,"3I"],"\xE5"=>[0,"3J"],"\xE6"=>[0,"3K"],"\xE7"=>[0,"3L"],"\xE8"=>[0,"3M"],"\xE9"=>[0,"3N"],"\xEA"=>[0,"3O"],"\xEB"=>[0,"3P"],"\xEC"=>[0,"3Q"],"\xED"=>[0,"3R"],"\xEE"=>[0,"3S"],"\xEF"=>[0,"3T"],"\xF0"=>[0,"3U"],"\xF1"=>[0,"3V"],"\xF2"=>[0,"3W"],"\xF3"=>[0,"3Y"],"\xF4"=>[0,"3j"],"\xF5"=>[0,"3k"],"\xF6"=>[0,"3q"],"\xF7"=>[0,"3v"],"\xF8"=>[0,"3w"],"\xF9"=>[0,"3x"],"\xFA"=>[0,"3y"],"\xFB"=>[0,"3z"],"\xFC"=>[82,"3"],"\xFD"=>[87,"3"],"\xFE"=>[130,"3"],"\xFF"=>[9,"3"],],["\x00"=>[77,"\x2F0"],"\x01"=>[18,"\x2F0"],"\x02"=>[77,"\x2F1"],"\x03"=>[18,"\x2F1"],"\x04"=>[77,"\x2F2"],"\x05"=>[18,"\x2F2"],"\x06"=>[77,"\x2Fa"],"\x07"=>[18,"\x2Fa"],"\x08"=>[77,"\x2Fc"],"\x09"=>[18,"\x2Fc"],"\x0A"=>[77,"\x2Fe"],"\x0B"=>[18,"\x2Fe"],"\x0C"=>[77,"\x2Fi"],"\x0D"=>[18,"\x2Fi"],"\x0E"=>[77,"\x2Fo"],"\x0F"=>[18,"\x2Fo"],"\x10"=>[77,"\x2Fs"],"\x11"=>[18,"\x2Fs"],"\x12"=>[77,"\x2Ft"],"\x13"=>[18,"\x2Ft"],"\x14"=>[0,"\x2F\x20"],"\x15"=>[0,"\x2F\x25"],"\x16"=>[0,"\x2F-"],"\x17"=>[0,"\x2F."],"\x18"=>[0,"\x2F\x2F"],"\x19"=>[0,"\x2F3"],"\x1A"=>[0,"\x2F4"],"\x1B"=>[0,"\x2F5"],"\x1C"=>[0,"\x2F6"],"\x1D"=>[0,"\x2F7"],"\x1E"=>[0,"\x2F8"],"\x1F"=>[0,"\x2F9"],"\x20"=>[0,"\x2F\x3D"],"\x21"=>[0,"\x2FA"],"\x22"=>[0,"\x2F_"],"\x23"=>[0,"\x2Fb"],"\x24"=>[0,"\x2Fd"],"\x25"=>[0,"\x2Ff"],"\x26"=>[0,"\x2Fg"],"\x27"=>[0,"\x2Fh"],"\x28"=>[0,"\x2Fl"],"\x29"=>[0,"\x2Fm"],"\x2A"=>[0,"\x2Fn"],"\x2B"=>[0,"\x2Fp"],"\x2C"=>[0,"\x2Fr"],"-"=>[0,"\x2Fu"],"."=>[100,"\x2F"],"\x2F"=>[110,"\x2F"],[111,"\x2F"],[115,"\x2F"],[116,"\x2F"],[118,"\x2F"],[119,"\x2F"],[122,"\x2F"],[123,"\x2F"],[125,"\x2F"],[126,"\x2F"],[129,"\x2F"],"\x3A"=>[143,"\x2F"],"\x3B"=>[148,"\x2F"],"\x3C"=>[151,"\x2F"],"\x3D"=>[153,"\x2F"],"\x3E"=>[83,"\x2F"],"\x3F"=>[10,"\x2F"],"\x40"=>[77,"30"],"A"=>[18,"30"],"B"=>[77,"31"],"C"=>[18,"31"],"D"=>[77,"32"],"E"=>[18,"32"],"F"=>[77,"3a"],"G"=>[18,"3a"],"H"=>[77,"3c"],"I"=>[18,"3c"],"J"=>[77,"3e"],"K"=>[18,"3e"],"L"=>[77,"3i"],"M"=>[18,"3i"],"N"=>[77,"3o"],"O"=>[18,"3o"],"P"=>[77,"3s"],"Q"=>[18,"3s"],"R"=>[77,"3t"],"S"=>[18,"3t"],"T"=>[0,"3\x20"],"U"=>[0,"3\x25"],"V"=>[0,"3-"],"W"=>[0,"3."],"X"=>[0,"3\x2F"],"Y"=>[0,"33"],"Z"=>[0,"34"],"\x5B"=>[0,"35"],"\x5C"=>[0,"36"],"\x5D"=>[0,"37"],"\x5E"=>[0,"38"],"_"=>[0,"39"],"\x60"=>[0,"3\x3D"],"a"=>[0,"3A"],"b"=>[0,"3_"],"c"=>[0,"3b"],"d"=>[0,"3d"],"e"=>[0,"3f"],"f"=>[0,"3g"],"g"=>[0,"3h"],"h"=>[0,"3l"],"i"=>[0,"3m"],"j"=>[0,"3n"],"k"=>[0,"3p"],"l"=>[0,"3r"],"m"=>[0,"3u"],"n"=>[100,"3"],"o"=>[110,"3"],"p"=>[111,"3"],"q"=>[115,"3"],"r"=>[116,"3"],"s"=>[118,"3"],"t"=>[119,"3"],"u"=>[122,"3"],"v"=>[123,"3"],"w"=>[125,"3"],"x"=>[126,"3"],"y"=>[129,"3"],"z"=>[143,"3"],"\x7B"=>[148,"3"],"\x7C"=>[151,"3"],"\x7D"=>[153,"3"],"~"=>[83,"3"],"\x7F"=>[10,"3"],"\x80"=>[77,"40"],"\x81"=>[18,"40"],"\x82"=>[77,"41"],"\x83"=>[18,"41"],"\x84"=>[77,"42"],"\x85"=>[18,"42"],"\x86"=>[77,"4a"],"\x87"=>[18,"4a"],"\x88"=>[77,"4c"],"\x89"=>[18,"4c"],"\x8A"=>[77,"4e"],"\x8B"=>[18,"4e"],"\x8C"=>[77,"4i"],"\x8D"=>[18,"4i"],"\x8E"=>[77,"4o"],"\x8F"=>[18,"4o"],"\x90"=>[77,"4s"],"\x91"=>[18,"4s"],"\x92"=>[77,"4t"],"\x93"=>[18,"4t"],"\x94"=>[0,"4\x20"],"\x95"=>[0,"4\x25"],"\x96"=>[0,"4-"],"\x97"=>[0,"4."],"\x98"=>[0,"4\x2F"],"\x99"=>[0,"43"],"\x9A"=>[0,"44"],"\x9B"=>[0,"45"],"\x9C"=>[0,"46"],"\x9D"=>[0,"47"],"\x9E"=>[0,"48"],"\x9F"=>[0,"49"],"\xA0"=>[0,"4\x3D"],"\xA1"=>[0,"4A"],"\xA2"=>[0,"4_"],"\xA3"=>[0,"4b"],"\xA4"=>[0,"4d"],"\xA5"=>[0,"4f"],"\xA6"=>[0,"4g"],"\xA7"=>[0,"4h"],"\xA8"=>[0,"4l"],"\xA9"=>[0,"4m"],"\xAA"=>[0,"4n"],"\xAB"=>[0,"4p"],"\xAC"=>[0,"4r"],"\xAD"=>[0,"4u"],"\xAE"=>[100,"4"],"\xAF"=>[110,"4"],"\xB0"=>[111,"4"],"\xB1"=>[115,"4"],"\xB2"=>[116,"4"],"\xB3"=>[118,"4"],"\xB4"=>[119,"4"],"\xB5"=>[122,"4"],"\xB6"=>[123,"4"],"\xB7"=>[125,"4"],"\xB8"=>[126,"4"],"\xB9"=>[129,"4"],"\xBA"=>[143,"4"],"\xBB"=>[148,"4"],"\xBC"=>[151,"4"],"\xBD"=>[153,"4"],"\xBE"=>[83,"4"],"\xBF"=>[10,"4"],"\xC0"=>[77,"50"],"\xC1"=>[18,"50"],"\xC2"=>[77,"51"],"\xC3"=>[18,"51"],"\xC4"=>[77,"52"],"\xC5"=>[18,"52"],"\xC6"=>[77,"5a"],"\xC7"=>[18,"5a"],"\xC8"=>[77,"5c"],"\xC9"=>[18,"5c"],"\xCA"=>[77,"5e"],"\xCB"=>[18,"5e"],"\xCC"=>[77,"5i"],"\xCD"=>[18,"5i"],"\xCE"=>[77,"5o"],"\xCF"=>[18,"5o"],"\xD0"=>[77,"5s"],"\xD1"=>[18,"5s"],"\xD2"=>[77,"5t"],"\xD3"=>[18,"5t"],"\xD4"=>[0,"5\x20"],"\xD5"=>[0,"5\x25"],"\xD6"=>[0,"5-"],"\xD7"=>[0,"5."],"\xD8"=>[0,"5\x2F"],"\xD9"=>[0,"53"],"\xDA"=>[0,"54"],"\xDB"=>[0,"55"],"\xDC"=>[0,"56"],"\xDD"=>[0,"57"],"\xDE"=>[0,"58"],"\xDF"=>[0,"59"],"\xE0"=>[0,"5\x3D"],"\xE1"=>[0,"5A"],"\xE2"=>[0,"5_"],"\xE3"=>[0,"5b"],"\xE4"=>[0,"5d"],"\xE5"=>[0,"5f"],"\xE6"=>[0,"5g"],"\xE7"=>[0,"5h"],"\xE8"=>[0,"5l"],"\xE9"=>[0,"5m"],"\xEA"=>[0,"5n"],"\xEB"=>[0,"5p"],"\xEC"=>[0,"5r"],"\xED"=>[0,"5u"],"\xEE"=>[100,"5"],"\xEF"=>[110,"5"],"\xF0"=>[111,"5"],"\xF1"=>[115,"5"],"\xF2"=>[116,"5"],"\xF3"=>[118,"5"],"\xF4"=>[119,"5"],"\xF5"=>[122,"5"],"\xF6"=>[123,"5"],"\xF7"=>[125,"5"],"\xF8"=>[126,"5"],"\xF9"=>[129,"5"],"\xFA"=>[143,"5"],"\xFB"=>[148,"5"],"\xFC"=>[151,"5"],"\xFD"=>[153,"5"],"\xFE"=>[83,"5"],"\xFF"=>[10,"5"],],["\x00"=>[0,"\x2F0"],"\x01"=>[0,"\x2F1"],"\x02"=>[0,"\x2F2"],"\x03"=>[0,"\x2Fa"],"\x04"=>[0,"\x2Fc"],"\x05"=>[0,"\x2Fe"],"\x06"=>[0,"\x2Fi"],"\x07"=>[0,"\x2Fo"],"\x08"=>[0,"\x2Fs"],"\x09"=>[0,"\x2Ft"],"\x0A"=>[73,"\x2F"],"\x0B"=>[88,"\x2F"],"\x0C"=>[89,"\x2F"],"\x0D"=>[96,"\x2F"],"\x0E"=>[97,"\x2F"],"\x0F"=>[99,"\x2F"],"\x10"=>[106,"\x2F"],"\x11"=>[136,"\x2F"],"\x12"=>[139,"\x2F"],"\x13"=>[141,"\x2F"],"\x14"=>[145,"\x2F"],"\x15"=>[147,"\x2F"],"\x16"=>[149,"\x2F"],"\x17"=>[101,"\x2F"],"\x18"=>[112,"\x2F"],"\x19"=>[117,"\x2F"],"\x1A"=>[120,"\x2F"],"\x1B"=>[124,"\x2F"],"\x1C"=>[127,"\x2F"],"\x1D"=>[144,"\x2F"],"\x1E"=>[152,"\x2F"],"\x1F"=>[11,"\x2F"],"\x20"=>[0,"30"],"\x21"=>[0,"31"],"\x22"=>[0,"32"],"\x23"=>[0,"3a"],"\x24"=>[0,"3c"],"\x25"=>[0,"3e"],"\x26"=>[0,"3i"],"\x27"=>[0,"3o"],"\x28"=>[0,"3s"],"\x29"=>[0,"3t"],"\x2A"=>[73,"3"],"\x2B"=>[88,"3"],"\x2C"=>[89,"3"],"-"=>[96,"3"],"."=>[97,"3"],"\x2F"=>[99,"3"],[106,"3"],[136,"3"],[139,"3"],[141,"3"],[145,"3"],[147,"3"],[149,"3"],[101,"3"],[112,"3"],[117,"3"],"\x3A"=>[120,"3"],"\x3B"=>[124,"3"],"\x3C"=>[127,"3"],"\x3D"=>[144,"3"],"\x3E"=>[152,"3"],"\x3F"=>[11,"3"],"\x40"=>[0,"40"],"A"=>[0,"41"],"B"=>[0,"42"],"C"=>[0,"4a"],"D"=>[0,"4c"],"E"=>[0,"4e"],"F"=>[0,"4i"],"G"=>[0,"4o"],"H"=>[0,"4s"],"I"=>[0,"4t"],"J"=>[73,"4"],"K"=>[88,"4"],"L"=>[89,"4"],"M"=>[96,"4"],"N"=>[97,"4"],"O"=>[99,"4"],"P"=>[106,"4"],"Q"=>[136,"4"],"R"=>[139,"4"],"S"=>[141,"4"],"T"=>[145,"4"],"U"=>[147,"4"],"V"=>[149,"4"],"W"=>[101,"4"],"X"=>[112,"4"],"Y"=>[117,"4"],"Z"=>[120,"4"],"\x5B"=>[124,"4"],"\x5C"=>[127,"4"],"\x5D"=>[144,"4"],"\x5E"=>[152,"4"],"_"=>[11,"4"],"\x60"=>[0,"50"],"a"=>[0,"51"],"b"=>[0,"52"],"c"=>[0,"5a"],"d"=>[0,"5c"],"e"=>[0,"5e"],"f"=>[0,"5i"],"g"=>[0,"5o"],"h"=>[0,"5s"],"i"=>[0,"5t"],"j"=>[73,"5"],"k"=>[88,"5"],"l"=>[89,"5"],"m"=>[96,"5"],"n"=>[97,"5"],"o"=>[99,"5"],"p"=>[106,"5"],"q"=>[136,"5"],"r"=>[139,"5"],"s"=>[141,"5"],"t"=>[145,"5"],"u"=>[147,"5"],"v"=>[149,"5"],"w"=>[101,"5"],"x"=>[112,"5"],"y"=>[117,"5"],"z"=>[120,"5"],"\x7B"=>[124,"5"],"\x7C"=>[127,"5"],"\x7D"=>[144,"5"],"~"=>[152,"5"],"\x7F"=>[11,"5"],"\x80"=>[0,"60"],"\x81"=>[0,"61"],"\x82"=>[0,"62"],"\x83"=>[0,"6a"],"\x84"=>[0,"6c"],"\x85"=>[0,"6e"],"\x86"=>[0,"6i"],"\x87"=>[0,"6o"],"\x88"=>[0,"6s"],"\x89"=>[0,"6t"],"\x8A"=>[73,"6"],"\x8B"=>[88,"6"],"\x8C"=>[89,"6"],"\x8D"=>[96,"6"],"\x8E"=>[97,"6"],"\x8F"=>[99,"6"],"\x90"=>[106,"6"],"\x91"=>[136,"6"],"\x92"=>[139,"6"],"\x93"=>[141,"6"],"\x94"=>[145,"6"],"\x95"=>[147,"6"],"\x96"=>[149,"6"],"\x97"=>[101,"6"],"\x98"=>[112,"6"],"\x99"=>[117,"6"],"\x9A"=>[120,"6"],"\x9B"=>[124,"6"],"\x9C"=>[127,"6"],"\x9D"=>[144,"6"],"\x9E"=>[152,"6"],"\x9F"=>[11,"6"],"\xA0"=>[0,"70"],"\xA1"=>[0,"71"],"\xA2"=>[0,"72"],"\xA3"=>[0,"7a"],"\xA4"=>[0,"7c"],"\xA5"=>[0,"7e"],"\xA6"=>[0,"7i"],"\xA7"=>[0,"7o"],"\xA8"=>[0,"7s"],"\xA9"=>[0,"7t"],"\xAA"=>[73,"7"],"\xAB"=>[88,"7"],"\xAC"=>[89,"7"],"\xAD"=>[96,"7"],"\xAE"=>[97,"7"],"\xAF"=>[99,"7"],"\xB0"=>[106,"7"],"\xB1"=>[136,"7"],"\xB2"=>[139,"7"],"\xB3"=>[141,"7"],"\xB4"=>[145,"7"],"\xB5"=>[147,"7"],"\xB6"=>[149,"7"],"\xB7"=>[101,"7"],"\xB8"=>[112,"7"],"\xB9"=>[117,"7"],"\xBA"=>[120,"7"],"\xBB"=>[124,"7"],"\xBC"=>[127,"7"],"\xBD"=>[144,"7"],"\xBE"=>[152,"7"],"\xBF"=>[11,"7"],"\xC0"=>[0,"80"],"\xC1"=>[0,"81"],"\xC2"=>[0,"82"],"\xC3"=>[0,"8a"],"\xC4"=>[0,"8c"],"\xC5"=>[0,"8e"],"\xC6"=>[0,"8i"],"\xC7"=>[0,"8o"],"\xC8"=>[0,"8s"],"\xC9"=>[0,"8t"],"\xCA"=>[73,"8"],"\xCB"=>[88,"8"],"\xCC"=>[89,"8"],"\xCD"=>[96,"8"],"\xCE"=>[97,"8"],"\xCF"=>[99,"8"],"\xD0"=>[106,"8"],"\xD1"=>[136,"8"],"\xD2"=>[139,"8"],"\xD3"=>[141,"8"],"\xD4"=>[145,"8"],"\xD5"=>[147,"8"],"\xD6"=>[149,"8"],"\xD7"=>[101,"8"],"\xD8"=>[112,"8"],"\xD9"=>[117,"8"],"\xDA"=>[120,"8"],"\xDB"=>[124,"8"],"\xDC"=>[127,"8"],"\xDD"=>[144,"8"],"\xDE"=>[152,"8"],"\xDF"=>[11,"8"],"\xE0"=>[0,"90"],"\xE1"=>[0,"91"],"\xE2"=>[0,"92"],"\xE3"=>[0,"9a"],"\xE4"=>[0,"9c"],"\xE5"=>[0,"9e"],"\xE6"=>[0,"9i"],"\xE7"=>[0,"9o"],"\xE8"=>[0,"9s"],"\xE9"=>[0,"9t"],"\xEA"=>[73,"9"],"\xEB"=>[88,"9"],"\xEC"=>[89,"9"],"\xED"=>[96,"9"],"\xEE"=>[97,"9"],"\xEF"=>[99,"9"],"\xF0"=>[106,"9"],"\xF1"=>[136,"9"],"\xF2"=>[139,"9"],"\xF3"=>[141,"9"],"\xF4"=>[145,"9"],"\xF5"=>[147,"9"],"\xF6"=>[149,"9"],"\xF7"=>[101,"9"],"\xF8"=>[112,"9"],"\xF9"=>[117,"9"],"\xFA"=>[120,"9"],"\xFB"=>[124,"9"],"\xFC"=>[127,"9"],"\xFD"=>[144,"9"],"\xFE"=>[152,"9"],"\xFF"=>[11,"9"],],["\x00"=>[94,"00"],"\x01"=>[76,"00"],"\x02"=>[104,"00"],"\x03"=>[16,"00"],"\x04"=>[94,"01"],"\x05"=>[76,"01"],"\x06"=>[104,"01"],"\x07"=>[16,"01"],"\x08"=>[94,"02"],"\x09"=>[76,"02"],"\x0A"=>[104,"02"],"\x0B"=>[16,"02"],"\x0C"=>[94,"0a"],"\x0D"=>[76,"0a"],"\x0E"=>[104,"0a"],"\x0F"=>[16,"0a"],"\x10"=>[94,"0c"],"\x11"=>[76,"0c"],"\x12"=>[104,"0c"],"\x13"=>[16,"0c"],"\x14"=>[94,"0e"],"\x15"=>[76,"0e"],"\x16"=>[104,"0e"],"\x17"=>[16,"0e"],"\x18"=>[94,"0i"],"\x19"=>[76,"0i"],"\x1A"=>[104,"0i"],"\x1B"=>[16,"0i"],"\x1C"=>[94,"0o"],"\x1D"=>[76,"0o"],"\x1E"=>[104,"0o"],"\x1F"=>[16,"0o"],"\x20"=>[94,"0s"],"\x21"=>[76,"0s"],"\x22"=>[104,"0s"],"\x23"=>[16,"0s"],"\x24"=>[94,"0t"],"\x25"=>[76,"0t"],"\x26"=>[104,"0t"],"\x27"=>[16,"0t"],"\x28"=>[77,"0\x20"],"\x29"=>[18,"0\x20"],"\x2A"=>[77,"0\x25"],"\x2B"=>[18,"0\x25"],"\x2C"=>[77,"0-"],"-"=>[18,"0-"],"."=>[77,"0."],"\x2F"=>[18,"0."],[77,"0\x2F"],[18,"0\x2F"],[77,"03"],[18,"03"],[77,"04"],[18,"04"],[77,"05"],[18,"05"],[77,"06"],[18,"06"],"\x3A"=>[77,"07"],"\x3B"=>[18,"07"],"\x3C"=>[77,"08"],"\x3D"=>[18,"08"],"\x3E"=>[77,"09"],"\x3F"=>[18,"09"],"\x40"=>[77,"0\x3D"],"A"=>[18,"0\x3D"],"B"=>[77,"0A"],"C"=>[18,"0A"],"D"=>[77,"0_"],"E"=>[18,"0_"],"F"=>[77,"0b"],"G"=>[18,"0b"],"H"=>[77,"0d"],"I"=>[18,"0d"],"J"=>[77,"0f"],"K"=>[18,"0f"],"L"=>[77,"0g"],"M"=>[18,"0g"],"N"=>[77,"0h"],"O"=>[18,"0h"],"P"=>[77,"0l"],"Q"=>[18,"0l"],"R"=>[77,"0m"],"S"=>[18,"0m"],"T"=>[77,"0n"],"U"=>[18,"0n"],"V"=>[77,"0p"],"W"=>[18,"0p"],"X"=>[77,"0r"],"Y"=>[18,"0r"],"Z"=>[77,"0u"],"\x5B"=>[18,"0u"],"\x5C"=>[0,"0\x3A"],"\x5D"=>[0,"0B"],"\x5E"=>[0,"0C"],"_"=>[0,"0D"],"\x60"=>[0,"0E"],"a"=>[0,"0F"],"b"=>[0,"0G"],"c"=>[0,"0H"],"d"=>[0,"0I"],"e"=>[0,"0J"],"f"=>[0,"0K"],"g"=>[0,"0L"],"h"=>[0,"0M"],"i"=>[0,"0N"],"j"=>[0,"0O"],"k"=>[0,"0P"],"l"=>[0,"0Q"],"m"=>[0,"0R"],"n"=>[0,"0S"],"o"=>[0,"0T"],"p"=>[0,"0U"],"q"=>[0,"0V"],"r"=>[0,"0W"],"s"=>[0,"0Y"],"t"=>[0,"0j"],"u"=>[0,"0k"],"v"=>[0,"0q"],"w"=>[0,"0v"],"x"=>[0,"0w"],"y"=>[0,"0x"],"z"=>[0,"0y"],"\x7B"=>[0,"0z"],"\x7C"=>[82,"0"],"\x7D"=>[87,"0"],"~"=>[130,"0"],"\x7F"=>[9,"0"],"\x80"=>[94,"10"],"\x81"=>[76,"10"],"\x82"=>[104,"10"],"\x83"=>[16,"10"],"\x84"=>[94,"11"],"\x85"=>[76,"11"],"\x86"=>[104,"11"],"\x87"=>[16,"11"],"\x88"=>[94,"12"],"\x89"=>[76,"12"],"\x8A"=>[104,"12"],"\x8B"=>[16,"12"],"\x8C"=>[94,"1a"],"\x8D"=>[76,"1a"],"\x8E"=>[104,"1a"],"\x8F"=>[16,"1a"],"\x90"=>[94,"1c"],"\x91"=>[76,"1c"],"\x92"=>[104,"1c"],"\x93"=>[16,"1c"],"\x94"=>[94,"1e"],"\x95"=>[76,"1e"],"\x96"=>[104,"1e"],"\x97"=>[16,"1e"],"\x98"=>[94,"1i"],"\x99"=>[76,"1i"],"\x9A"=>[104,"1i"],"\x9B"=>[16,"1i"],"\x9C"=>[94,"1o"],"\x9D"=>[76,"1o"],"\x9E"=>[104,"1o"],"\x9F"=>[16,"1o"],"\xA0"=>[94,"1s"],"\xA1"=>[76,"1s"],"\xA2"=>[104,"1s"],"\xA3"=>[16,"1s"],"\xA4"=>[94,"1t"],"\xA5"=>[76,"1t"],"\xA6"=>[104,"1t"],"\xA7"=>[16,"1t"],"\xA8"=>[77,"1\x20"],"\xA9"=>[18,"1\x20"],"\xAA"=>[77,"1\x25"],"\xAB"=>[18,"1\x25"],"\xAC"=>[77,"1-"],"\xAD"=>[18,"1-"],"\xAE"=>[77,"1."],"\xAF"=>[18,"1."],"\xB0"=>[77,"1\x2F"],"\xB1"=>[18,"1\x2F"],"\xB2"=>[77,"13"],"\xB3"=>[18,"13"],"\xB4"=>[77,"14"],"\xB5"=>[18,"14"],"\xB6"=>[77,"15"],"\xB7"=>[18,"15"],"\xB8"=>[77,"16"],"\xB9"=>[18,"16"],"\xBA"=>[77,"17"],"\xBB"=>[18,"17"],"\xBC"=>[77,"18"],"\xBD"=>[18,"18"],"\xBE"=>[77,"19"],"\xBF"=>[18,"19"],"\xC0"=>[77,"1\x3D"],"\xC1"=>[18,"1\x3D"],"\xC2"=>[77,"1A"],"\xC3"=>[18,"1A"],"\xC4"=>[77,"1_"],"\xC5"=>[18,"1_"],"\xC6"=>[77,"1b"],"\xC7"=>[18,"1b"],"\xC8"=>[77,"1d"],"\xC9"=>[18,"1d"],"\xCA"=>[77,"1f"],"\xCB"=>[18,"1f"],"\xCC"=>[77,"1g"],"\xCD"=>[18,"1g"],"\xCE"=>[77,"1h"],"\xCF"=>[18,"1h"],"\xD0"=>[77,"1l"],"\xD1"=>[18,"1l"],"\xD2"=>[77,"1m"],"\xD3"=>[18,"1m"],"\xD4"=>[77,"1n"],"\xD5"=>[18,"1n"],"\xD6"=>[77,"1p"],"\xD7"=>[18,"1p"],"\xD8"=>[77,"1r"],"\xD9"=>[18,"1r"],"\xDA"=>[77,"1u"],"\xDB"=>[18,"1u"],"\xDC"=>[0,"1\x3A"],"\xDD"=>[0,"1B"],"\xDE"=>[0,"1C"],"\xDF"=>[0,"1D"],"\xE0"=>[0,"1E"],"\xE1"=>[0,"1F"],"\xE2"=>[0,"1G"],"\xE3"=>[0,"1H"],"\xE4"=>[0,"1I"],"\xE5"=>[0,"1J"],"\xE6"=>[0,"1K"],"\xE7"=>[0,"1L"],"\xE8"=>[0,"1M"],"\xE9"=>[0,"1N"],"\xEA"=>[0,"1O"],"\xEB"=>[0,"1P"],"\xEC"=>[0,"1Q"],"\xED"=>[0,"1R"],"\xEE"=>[0,"1S"],"\xEF"=>[0,"1T"],"\xF0"=>[0,"1U"],"\xF1"=>[0,"1V"],"\xF2"=>[0,"1W"],"\xF3"=>[0,"1Y"],"\xF4"=>[0,"1j"],"\xF5"=>[0,"1k"],"\xF6"=>[0,"1q"],"\xF7"=>[0,"1v"],"\xF8"=>[0,"1w"],"\xF9"=>[0,"1x"],"\xFA"=>[0,"1y"],"\xFB"=>[0,"1z"],"\xFC"=>[82,"1"],"\xFD"=>[87,"1"],"\xFE"=>[130,"1"],"\xFF"=>[9,"1"],],["\x00"=>[77,"00"],"\x01"=>[18,"00"],"\x02"=>[77,"01"],"\x03"=>[18,"01"],"\x04"=>[77,"02"],"\x05"=>[18,"02"],"\x06"=>[77,"0a"],"\x07"=>[18,"0a"],"\x08"=>[77,"0c"],"\x09"=>[18,"0c"],"\x0A"=>[77,"0e"],"\x0B"=>[18,"0e"],"\x0C"=>[77,"0i"],"\x0D"=>[18,"0i"],"\x0E"=>[77,"0o"],"\x0F"=>[18,"0o"],"\x10"=>[77,"0s"],"\x11"=>[18,"0s"],"\x12"=>[77,"0t"],"\x13"=>[18,"0t"],"\x14"=>[0,"0\x20"],"\x15"=>[0,"0\x25"],"\x16"=>[0,"0-"],"\x17"=>[0,"0."],"\x18"=>[0,"0\x2F"],"\x19"=>[0,"03"],"\x1A"=>[0,"04"],"\x1B"=>[0,"05"],"\x1C"=>[0,"06"],"\x1D"=>[0,"07"],"\x1E"=>[0,"08"],"\x1F"=>[0,"09"],"\x20"=>[0,"0\x3D"],"\x21"=>[0,"0A"],"\x22"=>[0,"0_"],"\x23"=>[0,"0b"],"\x24"=>[0,"0d"],"\x25"=>[0,"0f"],"\x26"=>[0,"0g"],"\x27"=>[0,"0h"],"\x28"=>[0,"0l"],"\x29"=>[0,"0m"],"\x2A"=>[0,"0n"],"\x2B"=>[0,"0p"],"\x2C"=>[0,"0r"],"-"=>[0,"0u"],"."=>[100,"0"],"\x2F"=>[110,"0"],[111,"0"],[115,"0"],[116,"0"],[118,"0"],[119,"0"],[122,"0"],[123,"0"],[125,"0"],[126,"0"],[129,"0"],"\x3A"=>[143,"0"],"\x3B"=>[148,"0"],"\x3C"=>[151,"0"],"\x3D"=>[153,"0"],"\x3E"=>[83,"0"],"\x3F"=>[10,"0"],"\x40"=>[77,"10"],"A"=>[18,"10"],"B"=>[77,"11"],"C"=>[18,"11"],"D"=>[77,"12"],"E"=>[18,"12"],"F"=>[77,"1a"],"G"=>[18,"1a"],"H"=>[77,"1c"],"I"=>[18,"1c"],"J"=>[77,"1e"],"K"=>[18,"1e"],"L"=>[77,"1i"],"M"=>[18,"1i"],"N"=>[77,"1o"],"O"=>[18,"1o"],"P"=>[77,"1s"],"Q"=>[18,"1s"],"R"=>[77,"1t"],"S"=>[18,"1t"],"T"=>[0,"1\x20"],"U"=>[0,"1\x25"],"V"=>[0,"1-"],"W"=>[0,"1."],"X"=>[0,"1\x2F"],"Y"=>[0,"13"],"Z"=>[0,"14"],"\x5B"=>[0,"15"],"\x5C"=>[0,"16"],"\x5D"=>[0,"17"],"\x5E"=>[0,"18"],"_"=>[0,"19"],"\x60"=>[0,"1\x3D"],"a"=>[0,"1A"],"b"=>[0,"1_"],"c"=>[0,"1b"],"d"=>[0,"1d"],"e"=>[0,"1f"],"f"=>[0,"1g"],"g"=>[0,"1h"],"h"=>[0,"1l"],"i"=>[0,"1m"],"j"=>[0,"1n"],"k"=>[0,"1p"],"l"=>[0,"1r"],"m"=>[0,"1u"],"n"=>[100,"1"],"o"=>[110,"1"],"p"=>[111,"1"],"q"=>[115,"1"],"r"=>[116,"1"],"s"=>[118,"1"],"t"=>[119,"1"],"u"=>[122,"1"],"v"=>[123,"1"],"w"=>[125,"1"],"x"=>[126,"1"],"y"=>[129,"1"],"z"=>[143,"1"],"\x7B"=>[148,"1"],"\x7C"=>[151,"1"],"\x7D"=>[153,"1"],"~"=>[83,"1"],"\x7F"=>[10,"1"],"\x80"=>[77,"20"],"\x81"=>[18,"20"],"\x82"=>[77,"21"],"\x83"=>[18,"21"],"\x84"=>[77,"22"],"\x85"=>[18,"22"],"\x86"=>[77,"2a"],"\x87"=>[18,"2a"],"\x88"=>[77,"2c"],"\x89"=>[18,"2c"],"\x8A"=>[77,"2e"],"\x8B"=>[18,"2e"],"\x8C"=>[77,"2i"],"\x8D"=>[18,"2i"],"\x8E"=>[77,"2o"],"\x8F"=>[18,"2o"],"\x90"=>[77,"2s"],"\x91"=>[18,"2s"],"\x92"=>[77,"2t"],"\x93"=>[18,"2t"],"\x94"=>[0,"2\x20"],"\x95"=>[0,"2\x25"],"\x96"=>[0,"2-"],"\x97"=>[0,"2."],"\x98"=>[0,"2\x2F"],"\x99"=>[0,"23"],"\x9A"=>[0,"24"],"\x9B"=>[0,"25"],"\x9C"=>[0,"26"],"\x9D"=>[0,"27"],"\x9E"=>[0,"28"],"\x9F"=>[0,"29"],"\xA0"=>[0,"2\x3D"],"\xA1"=>[0,"2A"],"\xA2"=>[0,"2_"],"\xA3"=>[0,"2b"],"\xA4"=>[0,"2d"],"\xA5"=>[0,"2f"],"\xA6"=>[0,"2g"],"\xA7"=>[0,"2h"],"\xA8"=>[0,"2l"],"\xA9"=>[0,"2m"],"\xAA"=>[0,"2n"],"\xAB"=>[0,"2p"],"\xAC"=>[0,"2r"],"\xAD"=>[0,"2u"],"\xAE"=>[100,"2"],"\xAF"=>[110,"2"],"\xB0"=>[111,"2"],"\xB1"=>[115,"2"],"\xB2"=>[116,"2"],"\xB3"=>[118,"2"],"\xB4"=>[119,"2"],"\xB5"=>[122,"2"],"\xB6"=>[123,"2"],"\xB7"=>[125,"2"],"\xB8"=>[126,"2"],"\xB9"=>[129,"2"],"\xBA"=>[143,"2"],"\xBB"=>[148,"2"],"\xBC"=>[151,"2"],"\xBD"=>[153,"2"],"\xBE"=>[83,"2"],"\xBF"=>[10,"2"],"\xC0"=>[77,"a0"],"\xC1"=>[18,"a0"],"\xC2"=>[77,"a1"],"\xC3"=>[18,"a1"],"\xC4"=>[77,"a2"],"\xC5"=>[18,"a2"],"\xC6"=>[77,"aa"],"\xC7"=>[18,"aa"],"\xC8"=>[77,"ac"],"\xC9"=>[18,"ac"],"\xCA"=>[77,"ae"],"\xCB"=>[18,"ae"],"\xCC"=>[77,"ai"],"\xCD"=>[18,"ai"],"\xCE"=>[77,"ao"],"\xCF"=>[18,"ao"],"\xD0"=>[77,"as"],"\xD1"=>[18,"as"],"\xD2"=>[77,"at"],"\xD3"=>[18,"at"],"\xD4"=>[0,"a\x20"],"\xD5"=>[0,"a\x25"],"\xD6"=>[0,"a-"],"\xD7"=>[0,"a."],"\xD8"=>[0,"a\x2F"],"\xD9"=>[0,"a3"],"\xDA"=>[0,"a4"],"\xDB"=>[0,"a5"],"\xDC"=>[0,"a6"],"\xDD"=>[0,"a7"],"\xDE"=>[0,"a8"],"\xDF"=>[0,"a9"],"\xE0"=>[0,"a\x3D"],"\xE1"=>[0,"aA"],"\xE2"=>[0,"a_"],"\xE3"=>[0,"ab"],"\xE4"=>[0,"ad"],"\xE5"=>[0,"af"],"\xE6"=>[0,"ag"],"\xE7"=>[0,"ah"],"\xE8"=>[0,"al"],"\xE9"=>[0,"am"],"\xEA"=>[0,"an"],"\xEB"=>[0,"ap"],"\xEC"=>[0,"ar"],"\xED"=>[0,"au"],"\xEE"=>[100,"a"],"\xEF"=>[110,"a"],"\xF0"=>[111,"a"],"\xF1"=>[115,"a"],"\xF2"=>[116,"a"],"\xF3"=>[118,"a"],"\xF4"=>[119,"a"],"\xF5"=>[122,"a"],"\xF6"=>[123,"a"],"\xF7"=>[125,"a"],"\xF8"=>[126,"a"],"\xF9"=>[129,"a"],"\xFA"=>[143,"a"],"\xFB"=>[148,"a"],"\xFC"=>[151,"a"],"\xFD"=>[153,"a"],"\xFE"=>[83,"a"],"\xFF"=>[10,"a"],],["\x00"=>[0,"00"],"\x01"=>[0,"01"],"\x02"=>[0,"02"],"\x03"=>[0,"0a"],"\x04"=>[0,"0c"],"\x05"=>[0,"0e"],"\x06"=>[0,"0i"],"\x07"=>[0,"0o"],"\x08"=>[0,"0s"],"\x09"=>[0,"0t"],"\x0A"=>[73,"0"],"\x0B"=>[88,"0"],"\x0C"=>[89,"0"],"\x0D"=>[96,"0"],"\x0E"=>[97,"0"],"\x0F"=>[99,"0"],"\x10"=>[106,"0"],"\x11"=>[136,"0"],"\x12"=>[139,"0"],"\x13"=>[141,"0"],"\x14"=>[145,"0"],"\x15"=>[147,"0"],"\x16"=>[149,"0"],"\x17"=>[101,"0"],"\x18"=>[112,"0"],"\x19"=>[117,"0"],"\x1A"=>[120,"0"],"\x1B"=>[124,"0"],"\x1C"=>[127,"0"],"\x1D"=>[144,"0"],"\x1E"=>[152,"0"],"\x1F"=>[11,"0"],"\x20"=>[0,"10"],"\x21"=>[0,"11"],"\x22"=>[0,"12"],"\x23"=>[0,"1a"],"\x24"=>[0,"1c"],"\x25"=>[0,"1e"],"\x26"=>[0,"1i"],"\x27"=>[0,"1o"],"\x28"=>[0,"1s"],"\x29"=>[0,"1t"],"\x2A"=>[73,"1"],"\x2B"=>[88,"1"],"\x2C"=>[89,"1"],"-"=>[96,"1"],"."=>[97,"1"],"\x2F"=>[99,"1"],[106,"1"],[136,"1"],[139,"1"],[141,"1"],[145,"1"],[147,"1"],[149,"1"],[101,"1"],[112,"1"],[117,"1"],"\x3A"=>[120,"1"],"\x3B"=>[124,"1"],"\x3C"=>[127,"1"],"\x3D"=>[144,"1"],"\x3E"=>[152,"1"],"\x3F"=>[11,"1"],"\x40"=>[0,"20"],"A"=>[0,"21"],"B"=>[0,"22"],"C"=>[0,"2a"],"D"=>[0,"2c"],"E"=>[0,"2e"],"F"=>[0,"2i"],"G"=>[0,"2o"],"H"=>[0,"2s"],"I"=>[0,"2t"],"J"=>[73,"2"],"K"=>[88,"2"],"L"=>[89,"2"],"M"=>[96,"2"],"N"=>[97,"2"],"O"=>[99,"2"],"P"=>[106,"2"],"Q"=>[136,"2"],"R"=>[139,"2"],"S"=>[141,"2"],"T"=>[145,"2"],"U"=>[147,"2"],"V"=>[149,"2"],"W"=>[101,"2"],"X"=>[112,"2"],"Y"=>[117,"2"],"Z"=>[120,"2"],"\x5B"=>[124,"2"],"\x5C"=>[127,"2"],"\x5D"=>[144,"2"],"\x5E"=>[152,"2"],"_"=>[11,"2"],"\x60"=>[0,"a0"],"a"=>[0,"a1"],"b"=>[0,"a2"],"c"=>[0,"aa"],"d"=>[0,"ac"],"e"=>[0,"ae"],"f"=>[0,"ai"],"g"=>[0,"ao"],"h"=>[0,"as"],"i"=>[0,"at"],"j"=>[73,"a"],"k"=>[88,"a"],"l"=>[89,"a"],"m"=>[96,"a"],"n"=>[97,"a"],"o"=>[99,"a"],"p"=>[106,"a"],"q"=>[136,"a"],"r"=>[139,"a"],"s"=>[141,"a"],"t"=>[145,"a"],"u"=>[147,"a"],"v"=>[149,"a"],"w"=>[101,"a"],"x"=>[112,"a"],"y"=>[117,"a"],"z"=>[120,"a"],"\x7B"=>[124,"a"],"\x7C"=>[127,"a"],"\x7D"=>[144,"a"],"~"=>[152,"a"],"\x7F"=>[11,"a"],"\x80"=>[0,"c0"],"\x81"=>[0,"c1"],"\x82"=>[0,"c2"],"\x83"=>[0,"ca"],"\x84"=>[0,"cc"],"\x85"=>[0,"ce"],"\x86"=>[0,"ci"],"\x87"=>[0,"co"],"\x88"=>[0,"cs"],"\x89"=>[0,"ct"],"\x8A"=>[73,"c"],"\x8B"=>[88,"c"],"\x8C"=>[89,"c"],"\x8D"=>[96,"c"],"\x8E"=>[97,"c"],"\x8F"=>[99,"c"],"\x90"=>[106,"c"],"\x91"=>[136,"c"],"\x92"=>[139,"c"],"\x93"=>[141,"c"],"\x94"=>[145,"c"],"\x95"=>[147,"c"],"\x96"=>[149,"c"],"\x97"=>[101,"c"],"\x98"=>[112,"c"],"\x99"=>[117,"c"],"\x9A"=>[120,"c"],"\x9B"=>[124,"c"],"\x9C"=>[127,"c"],"\x9D"=>[144,"c"],"\x9E"=>[152,"c"],"\x9F"=>[11,"c"],"\xA0"=>[0,"e0"],"\xA1"=>[0,"e1"],"\xA2"=>[0,"e2"],"\xA3"=>[0,"ea"],"\xA4"=>[0,"ec"],"\xA5"=>[0,"ee"],"\xA6"=>[0,"ei"],"\xA7"=>[0,"eo"],"\xA8"=>[0,"es"],"\xA9"=>[0,"et"],"\xAA"=>[73,"e"],"\xAB"=>[88,"e"],"\xAC"=>[89,"e"],"\xAD"=>[96,"e"],"\xAE"=>[97,"e"],"\xAF"=>[99,"e"],"\xB0"=>[106,"e"],"\xB1"=>[136,"e"],"\xB2"=>[139,"e"],"\xB3"=>[141,"e"],"\xB4"=>[145,"e"],"\xB5"=>[147,"e"],"\xB6"=>[149,"e"],"\xB7"=>[101,"e"],"\xB8"=>[112,"e"],"\xB9"=>[117,"e"],"\xBA"=>[120,"e"],"\xBB"=>[124,"e"],"\xBC"=>[127,"e"],"\xBD"=>[144,"e"],"\xBE"=>[152,"e"],"\xBF"=>[11,"e"],"\xC0"=>[0,"i0"],"\xC1"=>[0,"i1"],"\xC2"=>[0,"i2"],"\xC3"=>[0,"ia"],"\xC4"=>[0,"ic"],"\xC5"=>[0,"ie"],"\xC6"=>[0,"ii"],"\xC7"=>[0,"io"],"\xC8"=>[0,"is"],"\xC9"=>[0,"it"],"\xCA"=>[73,"i"],"\xCB"=>[88,"i"],"\xCC"=>[89,"i"],"\xCD"=>[96,"i"],"\xCE"=>[97,"i"],"\xCF"=>[99,"i"],"\xD0"=>[106,"i"],"\xD1"=>[136,"i"],"\xD2"=>[139,"i"],"\xD3"=>[141,"i"],"\xD4"=>[145,"i"],"\xD5"=>[147,"i"],"\xD6"=>[149,"i"],"\xD7"=>[101,"i"],"\xD8"=>[112,"i"],"\xD9"=>[117,"i"],"\xDA"=>[120,"i"],"\xDB"=>[124,"i"],"\xDC"=>[127,"i"],"\xDD"=>[144,"i"],"\xDE"=>[152,"i"],"\xDF"=>[11,"i"],"\xE0"=>[0,"o0"],"\xE1"=>[0,"o1"],"\xE2"=>[0,"o2"],"\xE3"=>[0,"oa"],"\xE4"=>[0,"oc"],"\xE5"=>[0,"oe"],"\xE6"=>[0,"oi"],"\xE7"=>[0,"oo"],"\xE8"=>[0,"os"],"\xE9"=>[0,"ot"],"\xEA"=>[73,"o"],"\xEB"=>[88,"o"],"\xEC"=>[89,"o"],"\xED"=>[96,"o"],"\xEE"=>[97,"o"],"\xEF"=>[99,"o"],"\xF0"=>[106,"o"],"\xF1"=>[136,"o"],"\xF2"=>[139,"o"],"\xF3"=>[141,"o"],"\xF4"=>[145,"o"],"\xF5"=>[147,"o"],"\xF6"=>[149,"o"],"\xF7"=>[101,"o"],"\xF8"=>[112,"o"],"\xF9"=>[117,"o"],"\xFA"=>[120,"o"],"\xFB"=>[124,"o"],"\xFC"=>[127,"o"],"\xFD"=>[144,"o"],"\xFE"=>[152,"o"],"\xFF"=>[11,"o"],],["\x00"=>[94,"20"],"\x01"=>[76,"20"],"\x02"=>[104,"20"],"\x03"=>[16,"20"],"\x04"=>[94,"21"],"\x05"=>[76,"21"],"\x06"=>[104,"21"],"\x07"=>[16,"21"],"\x08"=>[94,"22"],"\x09"=>[76,"22"],"\x0A"=>[104,"22"],"\x0B"=>[16,"22"],"\x0C"=>[94,"2a"],"\x0D"=>[76,"2a"],"\x0E"=>[104,"2a"],"\x0F"=>[16,"2a"],"\x10"=>[94,"2c"],"\x11"=>[76,"2c"],"\x12"=>[104,"2c"],"\x13"=>[16,"2c"],"\x14"=>[94,"2e"],"\x15"=>[76,"2e"],"\x16"=>[104,"2e"],"\x17"=>[16,"2e"],"\x18"=>[94,"2i"],"\x19"=>[76,"2i"],"\x1A"=>[104,"2i"],"\x1B"=>[16,"2i"],"\x1C"=>[94,"2o"],"\x1D"=>[76,"2o"],"\x1E"=>[104,"2o"],"\x1F"=>[16,"2o"],"\x20"=>[94,"2s"],"\x21"=>[76,"2s"],"\x22"=>[104,"2s"],"\x23"=>[16,"2s"],"\x24"=>[94,"2t"],"\x25"=>[76,"2t"],"\x26"=>[104,"2t"],"\x27"=>[16,"2t"],"\x28"=>[77,"2\x20"],"\x29"=>[18,"2\x20"],"\x2A"=>[77,"2\x25"],"\x2B"=>[18,"2\x25"],"\x2C"=>[77,"2-"],"-"=>[18,"2-"],"."=>[77,"2."],"\x2F"=>[18,"2."],[77,"2\x2F"],[18,"2\x2F"],[77,"23"],[18,"23"],[77,"24"],[18,"24"],[77,"25"],[18,"25"],[77,"26"],[18,"26"],"\x3A"=>[77,"27"],"\x3B"=>[18,"27"],"\x3C"=>[77,"28"],"\x3D"=>[18,"28"],"\x3E"=>[77,"29"],"\x3F"=>[18,"29"],"\x40"=>[77,"2\x3D"],"A"=>[18,"2\x3D"],"B"=>[77,"2A"],"C"=>[18,"2A"],"D"=>[77,"2_"],"E"=>[18,"2_"],"F"=>[77,"2b"],"G"=>[18,"2b"],"H"=>[77,"2d"],"I"=>[18,"2d"],"J"=>[77,"2f"],"K"=>[18,"2f"],"L"=>[77,"2g"],"M"=>[18,"2g"],"N"=>[77,"2h"],"O"=>[18,"2h"],"P"=>[77,"2l"],"Q"=>[18,"2l"],"R"=>[77,"2m"],"S"=>[18,"2m"],"T"=>[77,"2n"],"U"=>[18,"2n"],"V"=>[77,"2p"],"W"=>[18,"2p"],"X"=>[77,"2r"],"Y"=>[18,"2r"],"Z"=>[77,"2u"],"\x5B"=>[18,"2u"],"\x5C"=>[0,"2\x3A"],"\x5D"=>[0,"2B"],"\x5E"=>[0,"2C"],"_"=>[0,"2D"],"\x60"=>[0,"2E"],"a"=>[0,"2F"],"b"=>[0,"2G"],"c"=>[0,"2H"],"d"=>[0,"2I"],"e"=>[0,"2J"],"f"=>[0,"2K"],"g"=>[0,"2L"],"h"=>[0,"2M"],"i"=>[0,"2N"],"j"=>[0,"2O"],"k"=>[0,"2P"],"l"=>[0,"2Q"],"m"=>[0,"2R"],"n"=>[0,"2S"],"o"=>[0,"2T"],"p"=>[0,"2U"],"q"=>[0,"2V"],"r"=>[0,"2W"],"s"=>[0,"2Y"],"t"=>[0,"2j"],"u"=>[0,"2k"],"v"=>[0,"2q"],"w"=>[0,"2v"],"x"=>[0,"2w"],"y"=>[0,"2x"],"z"=>[0,"2y"],"\x7B"=>[0,"2z"],"\x7C"=>[82,"2"],"\x7D"=>[87,"2"],"~"=>[130,"2"],"\x7F"=>[9,"2"],"\x80"=>[94,"a0"],"\x81"=>[76,"a0"],"\x82"=>[104,"a0"],"\x83"=>[16,"a0"],"\x84"=>[94,"a1"],"\x85"=>[76,"a1"],"\x86"=>[104,"a1"],"\x87"=>[16,"a1"],"\x88"=>[94,"a2"],"\x89"=>[76,"a2"],"\x8A"=>[104,"a2"],"\x8B"=>[16,"a2"],"\x8C"=>[94,"aa"],"\x8D"=>[76,"aa"],"\x8E"=>[104,"aa"],"\x8F"=>[16,"aa"],"\x90"=>[94,"ac"],"\x91"=>[76,"ac"],"\x92"=>[104,"ac"],"\x93"=>[16,"ac"],"\x94"=>[94,"ae"],"\x95"=>[76,"ae"],"\x96"=>[104,"ae"],"\x97"=>[16,"ae"],"\x98"=>[94,"ai"],"\x99"=>[76,"ai"],"\x9A"=>[104,"ai"],"\x9B"=>[16,"ai"],"\x9C"=>[94,"ao"],"\x9D"=>[76,"ao"],"\x9E"=>[104,"ao"],"\x9F"=>[16,"ao"],"\xA0"=>[94,"as"],"\xA1"=>[76,"as"],"\xA2"=>[104,"as"],"\xA3"=>[16,"as"],"\xA4"=>[94,"at"],"\xA5"=>[76,"at"],"\xA6"=>[104,"at"],"\xA7"=>[16,"at"],"\xA8"=>[77,"a\x20"],"\xA9"=>[18,"a\x20"],"\xAA"=>[77,"a\x25"],"\xAB"=>[18,"a\x25"],"\xAC"=>[77,"a-"],"\xAD"=>[18,"a-"],"\xAE"=>[77,"a."],"\xAF"=>[18,"a."],"\xB0"=>[77,"a\x2F"],"\xB1"=>[18,"a\x2F"],"\xB2"=>[77,"a3"],"\xB3"=>[18,"a3"],"\xB4"=>[77,"a4"],"\xB5"=>[18,"a4"],"\xB6"=>[77,"a5"],"\xB7"=>[18,"a5"],"\xB8"=>[77,"a6"],"\xB9"=>[18,"a6"],"\xBA"=>[77,"a7"],"\xBB"=>[18,"a7"],"\xBC"=>[77,"a8"],"\xBD"=>[18,"a8"],"\xBE"=>[77,"a9"],"\xBF"=>[18,"a9"],"\xC0"=>[77,"a\x3D"],"\xC1"=>[18,"a\x3D"],"\xC2"=>[77,"aA"],"\xC3"=>[18,"aA"],"\xC4"=>[77,"a_"],"\xC5"=>[18,"a_"],"\xC6"=>[77,"ab"],"\xC7"=>[18,"ab"],"\xC8"=>[77,"ad"],"\xC9"=>[18,"ad"],"\xCA"=>[77,"af"],"\xCB"=>[18,"af"],"\xCC"=>[77,"ag"],"\xCD"=>[18,"ag"],"\xCE"=>[77,"ah"],"\xCF"=>[18,"ah"],"\xD0"=>[77,"al"],"\xD1"=>[18,"al"],"\xD2"=>[77,"am"],"\xD3"=>[18,"am"],"\xD4"=>[77,"an"],"\xD5"=>[18,"an"],"\xD6"=>[77,"ap"],"\xD7"=>[18,"ap"],"\xD8"=>[77,"ar"],"\xD9"=>[18,"ar"],"\xDA"=>[77,"au"],"\xDB"=>[18,"au"],"\xDC"=>[0,"a\x3A"],"\xDD"=>[0,"aB"],"\xDE"=>[0,"aC"],"\xDF"=>[0,"aD"],"\xE0"=>[0,"aE"],"\xE1"=>[0,"aF"],"\xE2"=>[0,"aG"],"\xE3"=>[0,"aH"],"\xE4"=>[0,"aI"],"\xE5"=>[0,"aJ"],"\xE6"=>[0,"aK"],"\xE7"=>[0,"aL"],"\xE8"=>[0,"aM"],"\xE9"=>[0,"aN"],"\xEA"=>[0,"aO"],"\xEB"=>[0,"aP"],"\xEC"=>[0,"aQ"],"\xED"=>[0,"aR"],"\xEE"=>[0,"aS"],"\xEF"=>[0,"aT"],"\xF0"=>[0,"aU"],"\xF1"=>[0,"aV"],"\xF2"=>[0,"aW"],"\xF3"=>[0,"aY"],"\xF4"=>[0,"aj"],"\xF5"=>[0,"ak"],"\xF6"=>[0,"aq"],"\xF7"=>[0,"av"],"\xF8"=>[0,"aw"],"\xF9"=>[0,"ax"],"\xFA"=>[0,"ay"],"\xFB"=>[0,"az"],"\xFC"=>[82,"a"],"\xFD"=>[87,"a"],"\xFE"=>[130,"a"],"\xFF"=>[9,"a"],],["\x00"=>[94,"40"],"\x01"=>[76,"40"],"\x02"=>[104,"40"],"\x03"=>[16,"40"],"\x04"=>[94,"41"],"\x05"=>[76,"41"],"\x06"=>[104,"41"],"\x07"=>[16,"41"],"\x08"=>[94,"42"],"\x09"=>[76,"42"],"\x0A"=>[104,"42"],"\x0B"=>[16,"42"],"\x0C"=>[94,"4a"],"\x0D"=>[76,"4a"],"\x0E"=>[104,"4a"],"\x0F"=>[16,"4a"],"\x10"=>[94,"4c"],"\x11"=>[76,"4c"],"\x12"=>[104,"4c"],"\x13"=>[16,"4c"],"\x14"=>[94,"4e"],"\x15"=>[76,"4e"],"\x16"=>[104,"4e"],"\x17"=>[16,"4e"],"\x18"=>[94,"4i"],"\x19"=>[76,"4i"],"\x1A"=>[104,"4i"],"\x1B"=>[16,"4i"],"\x1C"=>[94,"4o"],"\x1D"=>[76,"4o"],"\x1E"=>[104,"4o"],"\x1F"=>[16,"4o"],"\x20"=>[94,"4s"],"\x21"=>[76,"4s"],"\x22"=>[104,"4s"],"\x23"=>[16,"4s"],"\x24"=>[94,"4t"],"\x25"=>[76,"4t"],"\x26"=>[104,"4t"],"\x27"=>[16,"4t"],"\x28"=>[77,"4\x20"],"\x29"=>[18,"4\x20"],"\x2A"=>[77,"4\x25"],"\x2B"=>[18,"4\x25"],"\x2C"=>[77,"4-"],"-"=>[18,"4-"],"."=>[77,"4."],"\x2F"=>[18,"4."],[77,"4\x2F"],[18,"4\x2F"],[77,"43"],[18,"43"],[77,"44"],[18,"44"],[77,"45"],[18,"45"],[77,"46"],[18,"46"],"\x3A"=>[77,"47"],"\x3B"=>[18,"47"],"\x3C"=>[77,"48"],"\x3D"=>[18,"48"],"\x3E"=>[77,"49"],"\x3F"=>[18,"49"],"\x40"=>[77,"4\x3D"],"A"=>[18,"4\x3D"],"B"=>[77,"4A"],"C"=>[18,"4A"],"D"=>[77,"4_"],"E"=>[18,"4_"],"F"=>[77,"4b"],"G"=>[18,"4b"],"H"=>[77,"4d"],"I"=>[18,"4d"],"J"=>[77,"4f"],"K"=>[18,"4f"],"L"=>[77,"4g"],"M"=>[18,"4g"],"N"=>[77,"4h"],"O"=>[18,"4h"],"P"=>[77,"4l"],"Q"=>[18,"4l"],"R"=>[77,"4m"],"S"=>[18,"4m"],"T"=>[77,"4n"],"U"=>[18,"4n"],"V"=>[77,"4p"],"W"=>[18,"4p"],"X"=>[77,"4r"],"Y"=>[18,"4r"],"Z"=>[77,"4u"],"\x5B"=>[18,"4u"],"\x5C"=>[0,"4\x3A"],"\x5D"=>[0,"4B"],"\x5E"=>[0,"4C"],"_"=>[0,"4D"],"\x60"=>[0,"4E"],"a"=>[0,"4F"],"b"=>[0,"4G"],"c"=>[0,"4H"],"d"=>[0,"4I"],"e"=>[0,"4J"],"f"=>[0,"4K"],"g"=>[0,"4L"],"h"=>[0,"4M"],"i"=>[0,"4N"],"j"=>[0,"4O"],"k"=>[0,"4P"],"l"=>[0,"4Q"],"m"=>[0,"4R"],"n"=>[0,"4S"],"o"=>[0,"4T"],"p"=>[0,"4U"],"q"=>[0,"4V"],"r"=>[0,"4W"],"s"=>[0,"4Y"],"t"=>[0,"4j"],"u"=>[0,"4k"],"v"=>[0,"4q"],"w"=>[0,"4v"],"x"=>[0,"4w"],"y"=>[0,"4x"],"z"=>[0,"4y"],"\x7B"=>[0,"4z"],"\x7C"=>[82,"4"],"\x7D"=>[87,"4"],"~"=>[130,"4"],"\x7F"=>[9,"4"],"\x80"=>[94,"50"],"\x81"=>[76,"50"],"\x82"=>[104,"50"],"\x83"=>[16,"50"],"\x84"=>[94,"51"],"\x85"=>[76,"51"],"\x86"=>[104,"51"],"\x87"=>[16,"51"],"\x88"=>[94,"52"],"\x89"=>[76,"52"],"\x8A"=>[104,"52"],"\x8B"=>[16,"52"],"\x8C"=>[94,"5a"],"\x8D"=>[76,"5a"],"\x8E"=>[104,"5a"],"\x8F"=>[16,"5a"],"\x90"=>[94,"5c"],"\x91"=>[76,"5c"],"\x92"=>[104,"5c"],"\x93"=>[16,"5c"],"\x94"=>[94,"5e"],"\x95"=>[76,"5e"],"\x96"=>[104,"5e"],"\x97"=>[16,"5e"],"\x98"=>[94,"5i"],"\x99"=>[76,"5i"],"\x9A"=>[104,"5i"],"\x9B"=>[16,"5i"],"\x9C"=>[94,"5o"],"\x9D"=>[76,"5o"],"\x9E"=>[104,"5o"],"\x9F"=>[16,"5o"],"\xA0"=>[94,"5s"],"\xA1"=>[76,"5s"],"\xA2"=>[104,"5s"],"\xA3"=>[16,"5s"],"\xA4"=>[94,"5t"],"\xA5"=>[76,"5t"],"\xA6"=>[104,"5t"],"\xA7"=>[16,"5t"],"\xA8"=>[77,"5\x20"],"\xA9"=>[18,"5\x20"],"\xAA"=>[77,"5\x25"],"\xAB"=>[18,"5\x25"],"\xAC"=>[77,"5-"],"\xAD"=>[18,"5-"],"\xAE"=>[77,"5."],"\xAF"=>[18,"5."],"\xB0"=>[77,"5\x2F"],"\xB1"=>[18,"5\x2F"],"\xB2"=>[77,"53"],"\xB3"=>[18,"53"],"\xB4"=>[77,"54"],"\xB5"=>[18,"54"],"\xB6"=>[77,"55"],"\xB7"=>[18,"55"],"\xB8"=>[77,"56"],"\xB9"=>[18,"56"],"\xBA"=>[77,"57"],"\xBB"=>[18,"57"],"\xBC"=>[77,"58"],"\xBD"=>[18,"58"],"\xBE"=>[77,"59"],"\xBF"=>[18,"59"],"\xC0"=>[77,"5\x3D"],"\xC1"=>[18,"5\x3D"],"\xC2"=>[77,"5A"],"\xC3"=>[18,"5A"],"\xC4"=>[77,"5_"],"\xC5"=>[18,"5_"],"\xC6"=>[77,"5b"],"\xC7"=>[18,"5b"],"\xC8"=>[77,"5d"],"\xC9"=>[18,"5d"],"\xCA"=>[77,"5f"],"\xCB"=>[18,"5f"],"\xCC"=>[77,"5g"],"\xCD"=>[18,"5g"],"\xCE"=>[77,"5h"],"\xCF"=>[18,"5h"],"\xD0"=>[77,"5l"],"\xD1"=>[18,"5l"],"\xD2"=>[77,"5m"],"\xD3"=>[18,"5m"],"\xD4"=>[77,"5n"],"\xD5"=>[18,"5n"],"\xD6"=>[77,"5p"],"\xD7"=>[18,"5p"],"\xD8"=>[77,"5r"],"\xD9"=>[18,"5r"],"\xDA"=>[77,"5u"],"\xDB"=>[18,"5u"],"\xDC"=>[0,"5\x3A"],"\xDD"=>[0,"5B"],"\xDE"=>[0,"5C"],"\xDF"=>[0,"5D"],"\xE0"=>[0,"5E"],"\xE1"=>[0,"5F"],"\xE2"=>[0,"5G"],"\xE3"=>[0,"5H"],"\xE4"=>[0,"5I"],"\xE5"=>[0,"5J"],"\xE6"=>[0,"5K"],"\xE7"=>[0,"5L"],"\xE8"=>[0,"5M"],"\xE9"=>[0,"5N"],"\xEA"=>[0,"5O"],"\xEB"=>[0,"5P"],"\xEC"=>[0,"5Q"],"\xED"=>[0,"5R"],"\xEE"=>[0,"5S"],"\xEF"=>[0,"5T"],"\xF0"=>[0,"5U"],"\xF1"=>[0,"5V"],"\xF2"=>[0,"5W"],"\xF3"=>[0,"5Y"],"\xF4"=>[0,"5j"],"\xF5"=>[0,"5k"],"\xF6"=>[0,"5q"],"\xF7"=>[0,"5v"],"\xF8"=>[0,"5w"],"\xF9"=>[0,"5x"],"\xFA"=>[0,"5y"],"\xFB"=>[0,"5z"],"\xFC"=>[82,"5"],"\xFD"=>[87,"5"],"\xFE"=>[130,"5"],"\xFF"=>[9,"5"],],["\x00"=>[94,"60"],"\x01"=>[76,"60"],"\x02"=>[104,"60"],"\x03"=>[16,"60"],"\x04"=>[94,"61"],"\x05"=>[76,"61"],"\x06"=>[104,"61"],"\x07"=>[16,"61"],"\x08"=>[94,"62"],"\x09"=>[76,"62"],"\x0A"=>[104,"62"],"\x0B"=>[16,"62"],"\x0C"=>[94,"6a"],"\x0D"=>[76,"6a"],"\x0E"=>[104,"6a"],"\x0F"=>[16,"6a"],"\x10"=>[94,"6c"],"\x11"=>[76,"6c"],"\x12"=>[104,"6c"],"\x13"=>[16,"6c"],"\x14"=>[94,"6e"],"\x15"=>[76,"6e"],"\x16"=>[104,"6e"],"\x17"=>[16,"6e"],"\x18"=>[94,"6i"],"\x19"=>[76,"6i"],"\x1A"=>[104,"6i"],"\x1B"=>[16,"6i"],"\x1C"=>[94,"6o"],"\x1D"=>[76,"6o"],"\x1E"=>[104,"6o"],"\x1F"=>[16,"6o"],"\x20"=>[94,"6s"],"\x21"=>[76,"6s"],"\x22"=>[104,"6s"],"\x23"=>[16,"6s"],"\x24"=>[94,"6t"],"\x25"=>[76,"6t"],"\x26"=>[104,"6t"],"\x27"=>[16,"6t"],"\x28"=>[77,"6\x20"],"\x29"=>[18,"6\x20"],"\x2A"=>[77,"6\x25"],"\x2B"=>[18,"6\x25"],"\x2C"=>[77,"6-"],"-"=>[18,"6-"],"."=>[77,"6."],"\x2F"=>[18,"6."],[77,"6\x2F"],[18,"6\x2F"],[77,"63"],[18,"63"],[77,"64"],[18,"64"],[77,"65"],[18,"65"],[77,"66"],[18,"66"],"\x3A"=>[77,"67"],"\x3B"=>[18,"67"],"\x3C"=>[77,"68"],"\x3D"=>[18,"68"],"\x3E"=>[77,"69"],"\x3F"=>[18,"69"],"\x40"=>[77,"6\x3D"],"A"=>[18,"6\x3D"],"B"=>[77,"6A"],"C"=>[18,"6A"],"D"=>[77,"6_"],"E"=>[18,"6_"],"F"=>[77,"6b"],"G"=>[18,"6b"],"H"=>[77,"6d"],"I"=>[18,"6d"],"J"=>[77,"6f"],"K"=>[18,"6f"],"L"=>[77,"6g"],"M"=>[18,"6g"],"N"=>[77,"6h"],"O"=>[18,"6h"],"P"=>[77,"6l"],"Q"=>[18,"6l"],"R"=>[77,"6m"],"S"=>[18,"6m"],"T"=>[77,"6n"],"U"=>[18,"6n"],"V"=>[77,"6p"],"W"=>[18,"6p"],"X"=>[77,"6r"],"Y"=>[18,"6r"],"Z"=>[77,"6u"],"\x5B"=>[18,"6u"],"\x5C"=>[0,"6\x3A"],"\x5D"=>[0,"6B"],"\x5E"=>[0,"6C"],"_"=>[0,"6D"],"\x60"=>[0,"6E"],"a"=>[0,"6F"],"b"=>[0,"6G"],"c"=>[0,"6H"],"d"=>[0,"6I"],"e"=>[0,"6J"],"f"=>[0,"6K"],"g"=>[0,"6L"],"h"=>[0,"6M"],"i"=>[0,"6N"],"j"=>[0,"6O"],"k"=>[0,"6P"],"l"=>[0,"6Q"],"m"=>[0,"6R"],"n"=>[0,"6S"],"o"=>[0,"6T"],"p"=>[0,"6U"],"q"=>[0,"6V"],"r"=>[0,"6W"],"s"=>[0,"6Y"],"t"=>[0,"6j"],"u"=>[0,"6k"],"v"=>[0,"6q"],"w"=>[0,"6v"],"x"=>[0,"6w"],"y"=>[0,"6x"],"z"=>[0,"6y"],"\x7B"=>[0,"6z"],"\x7C"=>[82,"6"],"\x7D"=>[87,"6"],"~"=>[130,"6"],"\x7F"=>[9,"6"],"\x80"=>[94,"70"],"\x81"=>[76,"70"],"\x82"=>[104,"70"],"\x83"=>[16,"70"],"\x84"=>[94,"71"],"\x85"=>[76,"71"],"\x86"=>[104,"71"],"\x87"=>[16,"71"],"\x88"=>[94,"72"],"\x89"=>[76,"72"],"\x8A"=>[104,"72"],"\x8B"=>[16,"72"],"\x8C"=>[94,"7a"],"\x8D"=>[76,"7a"],"\x8E"=>[104,"7a"],"\x8F"=>[16,"7a"],"\x90"=>[94,"7c"],"\x91"=>[76,"7c"],"\x92"=>[104,"7c"],"\x93"=>[16,"7c"],"\x94"=>[94,"7e"],"\x95"=>[76,"7e"],"\x96"=>[104,"7e"],"\x97"=>[16,"7e"],"\x98"=>[94,"7i"],"\x99"=>[76,"7i"],"\x9A"=>[104,"7i"],"\x9B"=>[16,"7i"],"\x9C"=>[94,"7o"],"\x9D"=>[76,"7o"],"\x9E"=>[104,"7o"],"\x9F"=>[16,"7o"],"\xA0"=>[94,"7s"],"\xA1"=>[76,"7s"],"\xA2"=>[104,"7s"],"\xA3"=>[16,"7s"],"\xA4"=>[94,"7t"],"\xA5"=>[76,"7t"],"\xA6"=>[104,"7t"],"\xA7"=>[16,"7t"],"\xA8"=>[77,"7\x20"],"\xA9"=>[18,"7\x20"],"\xAA"=>[77,"7\x25"],"\xAB"=>[18,"7\x25"],"\xAC"=>[77,"7-"],"\xAD"=>[18,"7-"],"\xAE"=>[77,"7."],"\xAF"=>[18,"7."],"\xB0"=>[77,"7\x2F"],"\xB1"=>[18,"7\x2F"],"\xB2"=>[77,"73"],"\xB3"=>[18,"73"],"\xB4"=>[77,"74"],"\xB5"=>[18,"74"],"\xB6"=>[77,"75"],"\xB7"=>[18,"75"],"\xB8"=>[77,"76"],"\xB9"=>[18,"76"],"\xBA"=>[77,"77"],"\xBB"=>[18,"77"],"\xBC"=>[77,"78"],"\xBD"=>[18,"78"],"\xBE"=>[77,"79"],"\xBF"=>[18,"79"],"\xC0"=>[77,"7\x3D"],"\xC1"=>[18,"7\x3D"],"\xC2"=>[77,"7A"],"\xC3"=>[18,"7A"],"\xC4"=>[77,"7_"],"\xC5"=>[18,"7_"],"\xC6"=>[77,"7b"],"\xC7"=>[18,"7b"],"\xC8"=>[77,"7d"],"\xC9"=>[18,"7d"],"\xCA"=>[77,"7f"],"\xCB"=>[18,"7f"],"\xCC"=>[77,"7g"],"\xCD"=>[18,"7g"],"\xCE"=>[77,"7h"],"\xCF"=>[18,"7h"],"\xD0"=>[77,"7l"],"\xD1"=>[18,"7l"],"\xD2"=>[77,"7m"],"\xD3"=>[18,"7m"],"\xD4"=>[77,"7n"],"\xD5"=>[18,"7n"],"\xD6"=>[77,"7p"],"\xD7"=>[18,"7p"],"\xD8"=>[77,"7r"],"\xD9"=>[18,"7r"],"\xDA"=>[77,"7u"],"\xDB"=>[18,"7u"],"\xDC"=>[0,"7\x3A"],"\xDD"=>[0,"7B"],"\xDE"=>[0,"7C"],"\xDF"=>[0,"7D"],"\xE0"=>[0,"7E"],"\xE1"=>[0,"7F"],"\xE2"=>[0,"7G"],"\xE3"=>[0,"7H"],"\xE4"=>[0,"7I"],"\xE5"=>[0,"7J"],"\xE6"=>[0,"7K"],"\xE7"=>[0,"7L"],"\xE8"=>[0,"7M"],"\xE9"=>[0,"7N"],"\xEA"=>[0,"7O"],"\xEB"=>[0,"7P"],"\xEC"=>[0,"7Q"],"\xED"=>[0,"7R"],"\xEE"=>[0,"7S"],"\xEF"=>[0,"7T"],"\xF0"=>[0,"7U"],"\xF1"=>[0,"7V"],"\xF2"=>[0,"7W"],"\xF3"=>[0,"7Y"],"\xF4"=>[0,"7j"],"\xF5"=>[0,"7k"],"\xF6"=>[0,"7q"],"\xF7"=>[0,"7v"],"\xF8"=>[0,"7w"],"\xF9"=>[0,"7x"],"\xFA"=>[0,"7y"],"\xFB"=>[0,"7z"],"\xFC"=>[82,"7"],"\xFD"=>[87,"7"],"\xFE"=>[130,"7"],"\xFF"=>[9,"7"],],["\x00"=>[77,"60"],"\x01"=>[18,"60"],"\x02"=>[77,"61"],"\x03"=>[18,"61"],"\x04"=>[77,"62"],"\x05"=>[18,"62"],"\x06"=>[77,"6a"],"\x07"=>[18,"6a"],"\x08"=>[77,"6c"],"\x09"=>[18,"6c"],"\x0A"=>[77,"6e"],"\x0B"=>[18,"6e"],"\x0C"=>[77,"6i"],"\x0D"=>[18,"6i"],"\x0E"=>[77,"6o"],"\x0F"=>[18,"6o"],"\x10"=>[77,"6s"],"\x11"=>[18,"6s"],"\x12"=>[77,"6t"],"\x13"=>[18,"6t"],"\x14"=>[0,"6\x20"],"\x15"=>[0,"6\x25"],"\x16"=>[0,"6-"],"\x17"=>[0,"6."],"\x18"=>[0,"6\x2F"],"\x19"=>[0,"63"],"\x1A"=>[0,"64"],"\x1B"=>[0,"65"],"\x1C"=>[0,"66"],"\x1D"=>[0,"67"],"\x1E"=>[0,"68"],"\x1F"=>[0,"69"],"\x20"=>[0,"6\x3D"],"\x21"=>[0,"6A"],"\x22"=>[0,"6_"],"\x23"=>[0,"6b"],"\x24"=>[0,"6d"],"\x25"=>[0,"6f"],"\x26"=>[0,"6g"],"\x27"=>[0,"6h"],"\x28"=>[0,"6l"],"\x29"=>[0,"6m"],"\x2A"=>[0,"6n"],"\x2B"=>[0,"6p"],"\x2C"=>[0,"6r"],"-"=>[0,"6u"],"."=>[100,"6"],"\x2F"=>[110,"6"],[111,"6"],[115,"6"],[116,"6"],[118,"6"],[119,"6"],[122,"6"],[123,"6"],[125,"6"],[126,"6"],[129,"6"],"\x3A"=>[143,"6"],"\x3B"=>[148,"6"],"\x3C"=>[151,"6"],"\x3D"=>[153,"6"],"\x3E"=>[83,"6"],"\x3F"=>[10,"6"],"\x40"=>[77,"70"],"A"=>[18,"70"],"B"=>[77,"71"],"C"=>[18,"71"],"D"=>[77,"72"],"E"=>[18,"72"],"F"=>[77,"7a"],"G"=>[18,"7a"],"H"=>[77,"7c"],"I"=>[18,"7c"],"J"=>[77,"7e"],"K"=>[18,"7e"],"L"=>[77,"7i"],"M"=>[18,"7i"],"N"=>[77,"7o"],"O"=>[18,"7o"],"P"=>[77,"7s"],"Q"=>[18,"7s"],"R"=>[77,"7t"],"S"=>[18,"7t"],"T"=>[0,"7\x20"],"U"=>[0,"7\x25"],"V"=>[0,"7-"],"W"=>[0,"7."],"X"=>[0,"7\x2F"],"Y"=>[0,"73"],"Z"=>[0,"74"],"\x5B"=>[0,"75"],"\x5C"=>[0,"76"],"\x5D"=>[0,"77"],"\x5E"=>[0,"78"],"_"=>[0,"79"],"\x60"=>[0,"7\x3D"],"a"=>[0,"7A"],"b"=>[0,"7_"],"c"=>[0,"7b"],"d"=>[0,"7d"],"e"=>[0,"7f"],"f"=>[0,"7g"],"g"=>[0,"7h"],"h"=>[0,"7l"],"i"=>[0,"7m"],"j"=>[0,"7n"],"k"=>[0,"7p"],"l"=>[0,"7r"],"m"=>[0,"7u"],"n"=>[100,"7"],"o"=>[110,"7"],"p"=>[111,"7"],"q"=>[115,"7"],"r"=>[116,"7"],"s"=>[118,"7"],"t"=>[119,"7"],"u"=>[122,"7"],"v"=>[123,"7"],"w"=>[125,"7"],"x"=>[126,"7"],"y"=>[129,"7"],"z"=>[143,"7"],"\x7B"=>[148,"7"],"\x7C"=>[151,"7"],"\x7D"=>[153,"7"],"~"=>[83,"7"],"\x7F"=>[10,"7"],"\x80"=>[77,"80"],"\x81"=>[18,"80"],"\x82"=>[77,"81"],"\x83"=>[18,"81"],"\x84"=>[77,"82"],"\x85"=>[18,"82"],"\x86"=>[77,"8a"],"\x87"=>[18,"8a"],"\x88"=>[77,"8c"],"\x89"=>[18,"8c"],"\x8A"=>[77,"8e"],"\x8B"=>[18,"8e"],"\x8C"=>[77,"8i"],"\x8D"=>[18,"8i"],"\x8E"=>[77,"8o"],"\x8F"=>[18,"8o"],"\x90"=>[77,"8s"],"\x91"=>[18,"8s"],"\x92"=>[77,"8t"],"\x93"=>[18,"8t"],"\x94"=>[0,"8\x20"],"\x95"=>[0,"8\x25"],"\x96"=>[0,"8-"],"\x97"=>[0,"8."],"\x98"=>[0,"8\x2F"],"\x99"=>[0,"83"],"\x9A"=>[0,"84"],"\x9B"=>[0,"85"],"\x9C"=>[0,"86"],"\x9D"=>[0,"87"],"\x9E"=>[0,"88"],"\x9F"=>[0,"89"],"\xA0"=>[0,"8\x3D"],"\xA1"=>[0,"8A"],"\xA2"=>[0,"8_"],"\xA3"=>[0,"8b"],"\xA4"=>[0,"8d"],"\xA5"=>[0,"8f"],"\xA6"=>[0,"8g"],"\xA7"=>[0,"8h"],"\xA8"=>[0,"8l"],"\xA9"=>[0,"8m"],"\xAA"=>[0,"8n"],"\xAB"=>[0,"8p"],"\xAC"=>[0,"8r"],"\xAD"=>[0,"8u"],"\xAE"=>[100,"8"],"\xAF"=>[110,"8"],"\xB0"=>[111,"8"],"\xB1"=>[115,"8"],"\xB2"=>[116,"8"],"\xB3"=>[118,"8"],"\xB4"=>[119,"8"],"\xB5"=>[122,"8"],"\xB6"=>[123,"8"],"\xB7"=>[125,"8"],"\xB8"=>[126,"8"],"\xB9"=>[129,"8"],"\xBA"=>[143,"8"],"\xBB"=>[148,"8"],"\xBC"=>[151,"8"],"\xBD"=>[153,"8"],"\xBE"=>[83,"8"],"\xBF"=>[10,"8"],"\xC0"=>[77,"90"],"\xC1"=>[18,"90"],"\xC2"=>[77,"91"],"\xC3"=>[18,"91"],"\xC4"=>[77,"92"],"\xC5"=>[18,"92"],"\xC6"=>[77,"9a"],"\xC7"=>[18,"9a"],"\xC8"=>[77,"9c"],"\xC9"=>[18,"9c"],"\xCA"=>[77,"9e"],"\xCB"=>[18,"9e"],"\xCC"=>[77,"9i"],"\xCD"=>[18,"9i"],"\xCE"=>[77,"9o"],"\xCF"=>[18,"9o"],"\xD0"=>[77,"9s"],"\xD1"=>[18,"9s"],"\xD2"=>[77,"9t"],"\xD3"=>[18,"9t"],"\xD4"=>[0,"9\x20"],"\xD5"=>[0,"9\x25"],"\xD6"=>[0,"9-"],"\xD7"=>[0,"9."],"\xD8"=>[0,"9\x2F"],"\xD9"=>[0,"93"],"\xDA"=>[0,"94"],"\xDB"=>[0,"95"],"\xDC"=>[0,"96"],"\xDD"=>[0,"97"],"\xDE"=>[0,"98"],"\xDF"=>[0,"99"],"\xE0"=>[0,"9\x3D"],"\xE1"=>[0,"9A"],"\xE2"=>[0,"9_"],"\xE3"=>[0,"9b"],"\xE4"=>[0,"9d"],"\xE5"=>[0,"9f"],"\xE6"=>[0,"9g"],"\xE7"=>[0,"9h"],"\xE8"=>[0,"9l"],"\xE9"=>[0,"9m"],"\xEA"=>[0,"9n"],"\xEB"=>[0,"9p"],"\xEC"=>[0,"9r"],"\xED"=>[0,"9u"],"\xEE"=>[100,"9"],"\xEF"=>[110,"9"],"\xF0"=>[111,"9"],"\xF1"=>[115,"9"],"\xF2"=>[116,"9"],"\xF3"=>[118,"9"],"\xF4"=>[119,"9"],"\xF5"=>[122,"9"],"\xF6"=>[123,"9"],"\xF7"=>[125,"9"],"\xF8"=>[126,"9"],"\xF9"=>[129,"9"],"\xFA"=>[143,"9"],"\xFB"=>[148,"9"],"\xFC"=>[151,"9"],"\xFD"=>[153,"9"],"\xFE"=>[83,"9"],"\xFF"=>[10,"9"],],["\x00"=>[94,"80"],"\x01"=>[76,"80"],"\x02"=>[104,"80"],"\x03"=>[16,"80"],"\x04"=>[94,"81"],"\x05"=>[76,"81"],"\x06"=>[104,"81"],"\x07"=>[16,"81"],"\x08"=>[94,"82"],"\x09"=>[76,"82"],"\x0A"=>[104,"82"],"\x0B"=>[16,"82"],"\x0C"=>[94,"8a"],"\x0D"=>[76,"8a"],"\x0E"=>[104,"8a"],"\x0F"=>[16,"8a"],"\x10"=>[94,"8c"],"\x11"=>[76,"8c"],"\x12"=>[104,"8c"],"\x13"=>[16,"8c"],"\x14"=>[94,"8e"],"\x15"=>[76,"8e"],"\x16"=>[104,"8e"],"\x17"=>[16,"8e"],"\x18"=>[94,"8i"],"\x19"=>[76,"8i"],"\x1A"=>[104,"8i"],"\x1B"=>[16,"8i"],"\x1C"=>[94,"8o"],"\x1D"=>[76,"8o"],"\x1E"=>[104,"8o"],"\x1F"=>[16,"8o"],"\x20"=>[94,"8s"],"\x21"=>[76,"8s"],"\x22"=>[104,"8s"],"\x23"=>[16,"8s"],"\x24"=>[94,"8t"],"\x25"=>[76,"8t"],"\x26"=>[104,"8t"],"\x27"=>[16,"8t"],"\x28"=>[77,"8\x20"],"\x29"=>[18,"8\x20"],"\x2A"=>[77,"8\x25"],"\x2B"=>[18,"8\x25"],"\x2C"=>[77,"8-"],"-"=>[18,"8-"],"."=>[77,"8."],"\x2F"=>[18,"8."],[77,"8\x2F"],[18,"8\x2F"],[77,"83"],[18,"83"],[77,"84"],[18,"84"],[77,"85"],[18,"85"],[77,"86"],[18,"86"],"\x3A"=>[77,"87"],"\x3B"=>[18,"87"],"\x3C"=>[77,"88"],"\x3D"=>[18,"88"],"\x3E"=>[77,"89"],"\x3F"=>[18,"89"],"\x40"=>[77,"8\x3D"],"A"=>[18,"8\x3D"],"B"=>[77,"8A"],"C"=>[18,"8A"],"D"=>[77,"8_"],"E"=>[18,"8_"],"F"=>[77,"8b"],"G"=>[18,"8b"],"H"=>[77,"8d"],"I"=>[18,"8d"],"J"=>[77,"8f"],"K"=>[18,"8f"],"L"=>[77,"8g"],"M"=>[18,"8g"],"N"=>[77,"8h"],"O"=>[18,"8h"],"P"=>[77,"8l"],"Q"=>[18,"8l"],"R"=>[77,"8m"],"S"=>[18,"8m"],"T"=>[77,"8n"],"U"=>[18,"8n"],"V"=>[77,"8p"],"W"=>[18,"8p"],"X"=>[77,"8r"],"Y"=>[18,"8r"],"Z"=>[77,"8u"],"\x5B"=>[18,"8u"],"\x5C"=>[0,"8\x3A"],"\x5D"=>[0,"8B"],"\x5E"=>[0,"8C"],"_"=>[0,"8D"],"\x60"=>[0,"8E"],"a"=>[0,"8F"],"b"=>[0,"8G"],"c"=>[0,"8H"],"d"=>[0,"8I"],"e"=>[0,"8J"],"f"=>[0,"8K"],"g"=>[0,"8L"],"h"=>[0,"8M"],"i"=>[0,"8N"],"j"=>[0,"8O"],"k"=>[0,"8P"],"l"=>[0,"8Q"],"m"=>[0,"8R"],"n"=>[0,"8S"],"o"=>[0,"8T"],"p"=>[0,"8U"],"q"=>[0,"8V"],"r"=>[0,"8W"],"s"=>[0,"8Y"],"t"=>[0,"8j"],"u"=>[0,"8k"],"v"=>[0,"8q"],"w"=>[0,"8v"],"x"=>[0,"8w"],"y"=>[0,"8x"],"z"=>[0,"8y"],"\x7B"=>[0,"8z"],"\x7C"=>[82,"8"],"\x7D"=>[87,"8"],"~"=>[130,"8"],"\x7F"=>[9,"8"],"\x80"=>[94,"90"],"\x81"=>[76,"90"],"\x82"=>[104,"90"],"\x83"=>[16,"90"],"\x84"=>[94,"91"],"\x85"=>[76,"91"],"\x86"=>[104,"91"],"\x87"=>[16,"91"],"\x88"=>[94,"92"],"\x89"=>[76,"92"],"\x8A"=>[104,"92"],"\x8B"=>[16,"92"],"\x8C"=>[94,"9a"],"\x8D"=>[76,"9a"],"\x8E"=>[104,"9a"],"\x8F"=>[16,"9a"],"\x90"=>[94,"9c"],"\x91"=>[76,"9c"],"\x92"=>[104,"9c"],"\x93"=>[16,"9c"],"\x94"=>[94,"9e"],"\x95"=>[76,"9e"],"\x96"=>[104,"9e"],"\x97"=>[16,"9e"],"\x98"=>[94,"9i"],"\x99"=>[76,"9i"],"\x9A"=>[104,"9i"],"\x9B"=>[16,"9i"],"\x9C"=>[94,"9o"],"\x9D"=>[76,"9o"],"\x9E"=>[104,"9o"],"\x9F"=>[16,"9o"],"\xA0"=>[94,"9s"],"\xA1"=>[76,"9s"],"\xA2"=>[104,"9s"],"\xA3"=>[16,"9s"],"\xA4"=>[94,"9t"],"\xA5"=>[76,"9t"],"\xA6"=>[104,"9t"],"\xA7"=>[16,"9t"],"\xA8"=>[77,"9\x20"],"\xA9"=>[18,"9\x20"],"\xAA"=>[77,"9\x25"],"\xAB"=>[18,"9\x25"],"\xAC"=>[77,"9-"],"\xAD"=>[18,"9-"],"\xAE"=>[77,"9."],"\xAF"=>[18,"9."],"\xB0"=>[77,"9\x2F"],"\xB1"=>[18,"9\x2F"],"\xB2"=>[77,"93"],"\xB3"=>[18,"93"],"\xB4"=>[77,"94"],"\xB5"=>[18,"94"],"\xB6"=>[77,"95"],"\xB7"=>[18,"95"],"\xB8"=>[77,"96"],"\xB9"=>[18,"96"],"\xBA"=>[77,"97"],"\xBB"=>[18,"97"],"\xBC"=>[77,"98"],"\xBD"=>[18,"98"],"\xBE"=>[77,"99"],"\xBF"=>[18,"99"],"\xC0"=>[77,"9\x3D"],"\xC1"=>[18,"9\x3D"],"\xC2"=>[77,"9A"],"\xC3"=>[18,"9A"],"\xC4"=>[77,"9_"],"\xC5"=>[18,"9_"],"\xC6"=>[77,"9b"],"\xC7"=>[18,"9b"],"\xC8"=>[77,"9d"],"\xC9"=>[18,"9d"],"\xCA"=>[77,"9f"],"\xCB"=>[18,"9f"],"\xCC"=>[77,"9g"],"\xCD"=>[18,"9g"],"\xCE"=>[77,"9h"],"\xCF"=>[18,"9h"],"\xD0"=>[77,"9l"],"\xD1"=>[18,"9l"],"\xD2"=>[77,"9m"],"\xD3"=>[18,"9m"],"\xD4"=>[77,"9n"],"\xD5"=>[18,"9n"],"\xD6"=>[77,"9p"],"\xD7"=>[18,"9p"],"\xD8"=>[77,"9r"],"\xD9"=>[18,"9r"],"\xDA"=>[77,"9u"],"\xDB"=>[18,"9u"],"\xDC"=>[0,"9\x3A"],"\xDD"=>[0,"9B"],"\xDE"=>[0,"9C"],"\xDF"=>[0,"9D"],"\xE0"=>[0,"9E"],"\xE1"=>[0,"9F"],"\xE2"=>[0,"9G"],"\xE3"=>[0,"9H"],"\xE4"=>[0,"9I"],"\xE5"=>[0,"9J"],"\xE6"=>[0,"9K"],"\xE7"=>[0,"9L"],"\xE8"=>[0,"9M"],"\xE9"=>[0,"9N"],"\xEA"=>[0,"9O"],"\xEB"=>[0,"9P"],"\xEC"=>[0,"9Q"],"\xED"=>[0,"9R"],"\xEE"=>[0,"9S"],"\xEF"=>[0,"9T"],"\xF0"=>[0,"9U"],"\xF1"=>[0,"9V"],"\xF2"=>[0,"9W"],"\xF3"=>[0,"9Y"],"\xF4"=>[0,"9j"],"\xF5"=>[0,"9k"],"\xF6"=>[0,"9q"],"\xF7"=>[0,"9v"],"\xF8"=>[0,"9w"],"\xF9"=>[0,"9x"],"\xFA"=>[0,"9y"],"\xFB"=>[0,"9z"],"\xFC"=>[82,"9"],"\xFD"=>[87,"9"],"\xFE"=>[130,"9"],"\xFF"=>[9,"9"],],["\x00"=>[94,"\x3A0"],"\x01"=>[76,"\x3A0"],"\x02"=>[104,"\x3A0"],"\x03"=>[16,"\x3A0"],"\x04"=>[94,"\x3A1"],"\x05"=>[76,"\x3A1"],"\x06"=>[104,"\x3A1"],"\x07"=>[16,"\x3A1"],"\x08"=>[94,"\x3A2"],"\x09"=>[76,"\x3A2"],"\x0A"=>[104,"\x3A2"],"\x0B"=>[16,"\x3A2"],"\x0C"=>[94,"\x3Aa"],"\x0D"=>[76,"\x3Aa"],"\x0E"=>[104,"\x3Aa"],"\x0F"=>[16,"\x3Aa"],"\x10"=>[94,"\x3Ac"],"\x11"=>[76,"\x3Ac"],"\x12"=>[104,"\x3Ac"],"\x13"=>[16,"\x3Ac"],"\x14"=>[94,"\x3Ae"],"\x15"=>[76,"\x3Ae"],"\x16"=>[104,"\x3Ae"],"\x17"=>[16,"\x3Ae"],"\x18"=>[94,"\x3Ai"],"\x19"=>[76,"\x3Ai"],"\x1A"=>[104,"\x3Ai"],"\x1B"=>[16,"\x3Ai"],"\x1C"=>[94,"\x3Ao"],"\x1D"=>[76,"\x3Ao"],"\x1E"=>[104,"\x3Ao"],"\x1F"=>[16,"\x3Ao"],"\x20"=>[94,"\x3As"],"\x21"=>[76,"\x3As"],"\x22"=>[104,"\x3As"],"\x23"=>[16,"\x3As"],"\x24"=>[94,"\x3At"],"\x25"=>[76,"\x3At"],"\x26"=>[104,"\x3At"],"\x27"=>[16,"\x3At"],"\x28"=>[77,"\x3A\x20"],"\x29"=>[18,"\x3A\x20"],"\x2A"=>[77,"\x3A\x25"],"\x2B"=>[18,"\x3A\x25"],"\x2C"=>[77,"\x3A-"],"-"=>[18,"\x3A-"],"."=>[77,"\x3A."],"\x2F"=>[18,"\x3A."],[77,"\x3A\x2F"],[18,"\x3A\x2F"],[77,"\x3A3"],[18,"\x3A3"],[77,"\x3A4"],[18,"\x3A4"],[77,"\x3A5"],[18,"\x3A5"],[77,"\x3A6"],[18,"\x3A6"],"\x3A"=>[77,"\x3A7"],"\x3B"=>[18,"\x3A7"],"\x3C"=>[77,"\x3A8"],"\x3D"=>[18,"\x3A8"],"\x3E"=>[77,"\x3A9"],"\x3F"=>[18,"\x3A9"],"\x40"=>[77,"\x3A\x3D"],"A"=>[18,"\x3A\x3D"],"B"=>[77,"\x3AA"],"C"=>[18,"\x3AA"],"D"=>[77,"\x3A_"],"E"=>[18,"\x3A_"],"F"=>[77,"\x3Ab"],"G"=>[18,"\x3Ab"],"H"=>[77,"\x3Ad"],"I"=>[18,"\x3Ad"],"J"=>[77,"\x3Af"],"K"=>[18,"\x3Af"],"L"=>[77,"\x3Ag"],"M"=>[18,"\x3Ag"],"N"=>[77,"\x3Ah"],"O"=>[18,"\x3Ah"],"P"=>[77,"\x3Al"],"Q"=>[18,"\x3Al"],"R"=>[77,"\x3Am"],"S"=>[18,"\x3Am"],"T"=>[77,"\x3An"],"U"=>[18,"\x3An"],"V"=>[77,"\x3Ap"],"W"=>[18,"\x3Ap"],"X"=>[77,"\x3Ar"],"Y"=>[18,"\x3Ar"],"Z"=>[77,"\x3Au"],"\x5B"=>[18,"\x3Au"],"\x5C"=>[0,"\x3A\x3A"],"\x5D"=>[0,"\x3AB"],"\x5E"=>[0,"\x3AC"],"_"=>[0,"\x3AD"],"\x60"=>[0,"\x3AE"],"a"=>[0,"\x3AF"],"b"=>[0,"\x3AG"],"c"=>[0,"\x3AH"],"d"=>[0,"\x3AI"],"e"=>[0,"\x3AJ"],"f"=>[0,"\x3AK"],"g"=>[0,"\x3AL"],"h"=>[0,"\x3AM"],"i"=>[0,"\x3AN"],"j"=>[0,"\x3AO"],"k"=>[0,"\x3AP"],"l"=>[0,"\x3AQ"],"m"=>[0,"\x3AR"],"n"=>[0,"\x3AS"],"o"=>[0,"\x3AT"],"p"=>[0,"\x3AU"],"q"=>[0,"\x3AV"],"r"=>[0,"\x3AW"],"s"=>[0,"\x3AY"],"t"=>[0,"\x3Aj"],"u"=>[0,"\x3Ak"],"v"=>[0,"\x3Aq"],"w"=>[0,"\x3Av"],"x"=>[0,"\x3Aw"],"y"=>[0,"\x3Ax"],"z"=>[0,"\x3Ay"],"\x7B"=>[0,"\x3Az"],"\x7C"=>[82,"\x3A"],"\x7D"=>[87,"\x3A"],"~"=>[130,"\x3A"],"\x7F"=>[9,"\x3A"],"\x80"=>[94,"B0"],"\x81"=>[76,"B0"],"\x82"=>[104,"B0"],"\x83"=>[16,"B0"],"\x84"=>[94,"B1"],"\x85"=>[76,"B1"],"\x86"=>[104,"B1"],"\x87"=>[16,"B1"],"\x88"=>[94,"B2"],"\x89"=>[76,"B2"],"\x8A"=>[104,"B2"],"\x8B"=>[16,"B2"],"\x8C"=>[94,"Ba"],"\x8D"=>[76,"Ba"],"\x8E"=>[104,"Ba"],"\x8F"=>[16,"Ba"],"\x90"=>[94,"Bc"],"\x91"=>[76,"Bc"],"\x92"=>[104,"Bc"],"\x93"=>[16,"Bc"],"\x94"=>[94,"Be"],"\x95"=>[76,"Be"],"\x96"=>[104,"Be"],"\x97"=>[16,"Be"],"\x98"=>[94,"Bi"],"\x99"=>[76,"Bi"],"\x9A"=>[104,"Bi"],"\x9B"=>[16,"Bi"],"\x9C"=>[94,"Bo"],"\x9D"=>[76,"Bo"],"\x9E"=>[104,"Bo"],"\x9F"=>[16,"Bo"],"\xA0"=>[94,"Bs"],"\xA1"=>[76,"Bs"],"\xA2"=>[104,"Bs"],"\xA3"=>[16,"Bs"],"\xA4"=>[94,"Bt"],"\xA5"=>[76,"Bt"],"\xA6"=>[104,"Bt"],"\xA7"=>[16,"Bt"],"\xA8"=>[77,"B\x20"],"\xA9"=>[18,"B\x20"],"\xAA"=>[77,"B\x25"],"\xAB"=>[18,"B\x25"],"\xAC"=>[77,"B-"],"\xAD"=>[18,"B-"],"\xAE"=>[77,"B."],"\xAF"=>[18,"B."],"\xB0"=>[77,"B\x2F"],"\xB1"=>[18,"B\x2F"],"\xB2"=>[77,"B3"],"\xB3"=>[18,"B3"],"\xB4"=>[77,"B4"],"\xB5"=>[18,"B4"],"\xB6"=>[77,"B5"],"\xB7"=>[18,"B5"],"\xB8"=>[77,"B6"],"\xB9"=>[18,"B6"],"\xBA"=>[77,"B7"],"\xBB"=>[18,"B7"],"\xBC"=>[77,"B8"],"\xBD"=>[18,"B8"],"\xBE"=>[77,"B9"],"\xBF"=>[18,"B9"],"\xC0"=>[77,"B\x3D"],"\xC1"=>[18,"B\x3D"],"\xC2"=>[77,"BA"],"\xC3"=>[18,"BA"],"\xC4"=>[77,"B_"],"\xC5"=>[18,"B_"],"\xC6"=>[77,"Bb"],"\xC7"=>[18,"Bb"],"\xC8"=>[77,"Bd"],"\xC9"=>[18,"Bd"],"\xCA"=>[77,"Bf"],"\xCB"=>[18,"Bf"],"\xCC"=>[77,"Bg"],"\xCD"=>[18,"Bg"],"\xCE"=>[77,"Bh"],"\xCF"=>[18,"Bh"],"\xD0"=>[77,"Bl"],"\xD1"=>[18,"Bl"],"\xD2"=>[77,"Bm"],"\xD3"=>[18,"Bm"],"\xD4"=>[77,"Bn"],"\xD5"=>[18,"Bn"],"\xD6"=>[77,"Bp"],"\xD7"=>[18,"Bp"],"\xD8"=>[77,"Br"],"\xD9"=>[18,"Br"],"\xDA"=>[77,"Bu"],"\xDB"=>[18,"Bu"],"\xDC"=>[0,"B\x3A"],"\xDD"=>[0,"BB"],"\xDE"=>[0,"BC"],"\xDF"=>[0,"BD"],"\xE0"=>[0,"BE"],"\xE1"=>[0,"BF"],"\xE2"=>[0,"BG"],"\xE3"=>[0,"BH"],"\xE4"=>[0,"BI"],"\xE5"=>[0,"BJ"],"\xE6"=>[0,"BK"],"\xE7"=>[0,"BL"],"\xE8"=>[0,"BM"],"\xE9"=>[0,"BN"],"\xEA"=>[0,"BO"],"\xEB"=>[0,"BP"],"\xEC"=>[0,"BQ"],"\xED"=>[0,"BR"],"\xEE"=>[0,"BS"],"\xEF"=>[0,"BT"],"\xF0"=>[0,"BU"],"\xF1"=>[0,"BV"],"\xF2"=>[0,"BW"],"\xF3"=>[0,"BY"],"\xF4"=>[0,"Bj"],"\xF5"=>[0,"Bk"],"\xF6"=>[0,"Bq"],"\xF7"=>[0,"Bv"],"\xF8"=>[0,"Bw"],"\xF9"=>[0,"Bx"],"\xFA"=>[0,"By"],"\xFB"=>[0,"Bz"],"\xFC"=>[82,"B"],"\xFD"=>[87,"B"],"\xFE"=>[130,"B"],"\xFF"=>[9,"B"],],["\x00"=>[77,"\x3A0"],"\x01"=>[18,"\x3A0"],"\x02"=>[77,"\x3A1"],"\x03"=>[18,"\x3A1"],"\x04"=>[77,"\x3A2"],"\x05"=>[18,"\x3A2"],"\x06"=>[77,"\x3Aa"],"\x07"=>[18,"\x3Aa"],"\x08"=>[77,"\x3Ac"],"\x09"=>[18,"\x3Ac"],"\x0A"=>[77,"\x3Ae"],"\x0B"=>[18,"\x3Ae"],"\x0C"=>[77,"\x3Ai"],"\x0D"=>[18,"\x3Ai"],"\x0E"=>[77,"\x3Ao"],"\x0F"=>[18,"\x3Ao"],"\x10"=>[77,"\x3As"],"\x11"=>[18,"\x3As"],"\x12"=>[77,"\x3At"],"\x13"=>[18,"\x3At"],"\x14"=>[0,"\x3A\x20"],"\x15"=>[0,"\x3A\x25"],"\x16"=>[0,"\x3A-"],"\x17"=>[0,"\x3A."],"\x18"=>[0,"\x3A\x2F"],"\x19"=>[0,"\x3A3"],"\x1A"=>[0,"\x3A4"],"\x1B"=>[0,"\x3A5"],"\x1C"=>[0,"\x3A6"],"\x1D"=>[0,"\x3A7"],"\x1E"=>[0,"\x3A8"],"\x1F"=>[0,"\x3A9"],"\x20"=>[0,"\x3A\x3D"],"\x21"=>[0,"\x3AA"],"\x22"=>[0,"\x3A_"],"\x23"=>[0,"\x3Ab"],"\x24"=>[0,"\x3Ad"],"\x25"=>[0,"\x3Af"],"\x26"=>[0,"\x3Ag"],"\x27"=>[0,"\x3Ah"],"\x28"=>[0,"\x3Al"],"\x29"=>[0,"\x3Am"],"\x2A"=>[0,"\x3An"],"\x2B"=>[0,"\x3Ap"],"\x2C"=>[0,"\x3Ar"],"-"=>[0,"\x3Au"],"."=>[100,"\x3A"],"\x2F"=>[110,"\x3A"],[111,"\x3A"],[115,"\x3A"],[116,"\x3A"],[118,"\x3A"],[119,"\x3A"],[122,"\x3A"],[123,"\x3A"],[125,"\x3A"],[126,"\x3A"],[129,"\x3A"],"\x3A"=>[143,"\x3A"],"\x3B"=>[148,"\x3A"],"\x3C"=>[151,"\x3A"],"\x3D"=>[153,"\x3A"],"\x3E"=>[83,"\x3A"],"\x3F"=>[10,"\x3A"],"\x40"=>[77,"B0"],"A"=>[18,"B0"],"B"=>[77,"B1"],"C"=>[18,"B1"],"D"=>[77,"B2"],"E"=>[18,"B2"],"F"=>[77,"Ba"],"G"=>[18,"Ba"],"H"=>[77,"Bc"],"I"=>[18,"Bc"],"J"=>[77,"Be"],"K"=>[18,"Be"],"L"=>[77,"Bi"],"M"=>[18,"Bi"],"N"=>[77,"Bo"],"O"=>[18,"Bo"],"P"=>[77,"Bs"],"Q"=>[18,"Bs"],"R"=>[77,"Bt"],"S"=>[18,"Bt"],"T"=>[0,"B\x20"],"U"=>[0,"B\x25"],"V"=>[0,"B-"],"W"=>[0,"B."],"X"=>[0,"B\x2F"],"Y"=>[0,"B3"],"Z"=>[0,"B4"],"\x5B"=>[0,"B5"],"\x5C"=>[0,"B6"],"\x5D"=>[0,"B7"],"\x5E"=>[0,"B8"],"_"=>[0,"B9"],"\x60"=>[0,"B\x3D"],"a"=>[0,"BA"],"b"=>[0,"B_"],"c"=>[0,"Bb"],"d"=>[0,"Bd"],"e"=>[0,"Bf"],"f"=>[0,"Bg"],"g"=>[0,"Bh"],"h"=>[0,"Bl"],"i"=>[0,"Bm"],"j"=>[0,"Bn"],"k"=>[0,"Bp"],"l"=>[0,"Br"],"m"=>[0,"Bu"],"n"=>[100,"B"],"o"=>[110,"B"],"p"=>[111,"B"],"q"=>[115,"B"],"r"=>[116,"B"],"s"=>[118,"B"],"t"=>[119,"B"],"u"=>[122,"B"],"v"=>[123,"B"],"w"=>[125,"B"],"x"=>[126,"B"],"y"=>[129,"B"],"z"=>[143,"B"],"\x7B"=>[148,"B"],"\x7C"=>[151,"B"],"\x7D"=>[153,"B"],"~"=>[83,"B"],"\x7F"=>[10,"B"],"\x80"=>[77,"C0"],"\x81"=>[18,"C0"],"\x82"=>[77,"C1"],"\x83"=>[18,"C1"],"\x84"=>[77,"C2"],"\x85"=>[18,"C2"],"\x86"=>[77,"Ca"],"\x87"=>[18,"Ca"],"\x88"=>[77,"Cc"],"\x89"=>[18,"Cc"],"\x8A"=>[77,"Ce"],"\x8B"=>[18,"Ce"],"\x8C"=>[77,"Ci"],"\x8D"=>[18,"Ci"],"\x8E"=>[77,"Co"],"\x8F"=>[18,"Co"],"\x90"=>[77,"Cs"],"\x91"=>[18,"Cs"],"\x92"=>[77,"Ct"],"\x93"=>[18,"Ct"],"\x94"=>[0,"C\x20"],"\x95"=>[0,"C\x25"],"\x96"=>[0,"C-"],"\x97"=>[0,"C."],"\x98"=>[0,"C\x2F"],"\x99"=>[0,"C3"],"\x9A"=>[0,"C4"],"\x9B"=>[0,"C5"],"\x9C"=>[0,"C6"],"\x9D"=>[0,"C7"],"\x9E"=>[0,"C8"],"\x9F"=>[0,"C9"],"\xA0"=>[0,"C\x3D"],"\xA1"=>[0,"CA"],"\xA2"=>[0,"C_"],"\xA3"=>[0,"Cb"],"\xA4"=>[0,"Cd"],"\xA5"=>[0,"Cf"],"\xA6"=>[0,"Cg"],"\xA7"=>[0,"Ch"],"\xA8"=>[0,"Cl"],"\xA9"=>[0,"Cm"],"\xAA"=>[0,"Cn"],"\xAB"=>[0,"Cp"],"\xAC"=>[0,"Cr"],"\xAD"=>[0,"Cu"],"\xAE"=>[100,"C"],"\xAF"=>[110,"C"],"\xB0"=>[111,"C"],"\xB1"=>[115,"C"],"\xB2"=>[116,"C"],"\xB3"=>[118,"C"],"\xB4"=>[119,"C"],"\xB5"=>[122,"C"],"\xB6"=>[123,"C"],"\xB7"=>[125,"C"],"\xB8"=>[126,"C"],"\xB9"=>[129,"C"],"\xBA"=>[143,"C"],"\xBB"=>[148,"C"],"\xBC"=>[151,"C"],"\xBD"=>[153,"C"],"\xBE"=>[83,"C"],"\xBF"=>[10,"C"],"\xC0"=>[77,"D0"],"\xC1"=>[18,"D0"],"\xC2"=>[77,"D1"],"\xC3"=>[18,"D1"],"\xC4"=>[77,"D2"],"\xC5"=>[18,"D2"],"\xC6"=>[77,"Da"],"\xC7"=>[18,"Da"],"\xC8"=>[77,"Dc"],"\xC9"=>[18,"Dc"],"\xCA"=>[77,"De"],"\xCB"=>[18,"De"],"\xCC"=>[77,"Di"],"\xCD"=>[18,"Di"],"\xCE"=>[77,"Do"],"\xCF"=>[18,"Do"],"\xD0"=>[77,"Ds"],"\xD1"=>[18,"Ds"],"\xD2"=>[77,"Dt"],"\xD3"=>[18,"Dt"],"\xD4"=>[0,"D\x20"],"\xD5"=>[0,"D\x25"],"\xD6"=>[0,"D-"],"\xD7"=>[0,"D."],"\xD8"=>[0,"D\x2F"],"\xD9"=>[0,"D3"],"\xDA"=>[0,"D4"],"\xDB"=>[0,"D5"],"\xDC"=>[0,"D6"],"\xDD"=>[0,"D7"],"\xDE"=>[0,"D8"],"\xDF"=>[0,"D9"],"\xE0"=>[0,"D\x3D"],"\xE1"=>[0,"DA"],"\xE2"=>[0,"D_"],"\xE3"=>[0,"Db"],"\xE4"=>[0,"Dd"],"\xE5"=>[0,"Df"],"\xE6"=>[0,"Dg"],"\xE7"=>[0,"Dh"],"\xE8"=>[0,"Dl"],"\xE9"=>[0,"Dm"],"\xEA"=>[0,"Dn"],"\xEB"=>[0,"Dp"],"\xEC"=>[0,"Dr"],"\xED"=>[0,"Du"],"\xEE"=>[100,"D"],"\xEF"=>[110,"D"],"\xF0"=>[111,"D"],"\xF1"=>[115,"D"],"\xF2"=>[116,"D"],"\xF3"=>[118,"D"],"\xF4"=>[119,"D"],"\xF5"=>[122,"D"],"\xF6"=>[123,"D"],"\xF7"=>[125,"D"],"\xF8"=>[126,"D"],"\xF9"=>[129,"D"],"\xFA"=>[143,"D"],"\xFB"=>[148,"D"],"\xFC"=>[151,"D"],"\xFD"=>[153,"D"],"\xFE"=>[83,"D"],"\xFF"=>[10,"D"],],["\x00"=>[77,"r0"],"\x01"=>[18,"r0"],"\x02"=>[77,"r1"],"\x03"=>[18,"r1"],"\x04"=>[77,"r2"],"\x05"=>[18,"r2"],"\x06"=>[77,"ra"],"\x07"=>[18,"ra"],"\x08"=>[77,"rc"],"\x09"=>[18,"rc"],"\x0A"=>[77,"re"],"\x0B"=>[18,"re"],"\x0C"=>[77,"ri"],"\x0D"=>[18,"ri"],"\x0E"=>[77,"ro"],"\x0F"=>[18,"ro"],"\x10"=>[77,"rs"],"\x11"=>[18,"rs"],"\x12"=>[77,"rt"],"\x13"=>[18,"rt"],"\x14"=>[0,"r\x20"],"\x15"=>[0,"r\x25"],"\x16"=>[0,"r-"],"\x17"=>[0,"r."],"\x18"=>[0,"r\x2F"],"\x19"=>[0,"r3"],"\x1A"=>[0,"r4"],"\x1B"=>[0,"r5"],"\x1C"=>[0,"r6"],"\x1D"=>[0,"r7"],"\x1E"=>[0,"r8"],"\x1F"=>[0,"r9"],"\x20"=>[0,"r\x3D"],"\x21"=>[0,"rA"],"\x22"=>[0,"r_"],"\x23"=>[0,"rb"],"\x24"=>[0,"rd"],"\x25"=>[0,"rf"],"\x26"=>[0,"rg"],"\x27"=>[0,"rh"],"\x28"=>[0,"rl"],"\x29"=>[0,"rm"],"\x2A"=>[0,"rn"],"\x2B"=>[0,"rp"],"\x2C"=>[0,"rr"],"-"=>[0,"ru"],"."=>[100,"r"],"\x2F"=>[110,"r"],[111,"r"],[115,"r"],[116,"r"],[118,"r"],[119,"r"],[122,"r"],[123,"r"],[125,"r"],[126,"r"],[129,"r"],"\x3A"=>[143,"r"],"\x3B"=>[148,"r"],"\x3C"=>[151,"r"],"\x3D"=>[153,"r"],"\x3E"=>[83,"r"],"\x3F"=>[10,"r"],"\x40"=>[77,"u0"],"A"=>[18,"u0"],"B"=>[77,"u1"],"C"=>[18,"u1"],"D"=>[77,"u2"],"E"=>[18,"u2"],"F"=>[77,"ua"],"G"=>[18,"ua"],"H"=>[77,"uc"],"I"=>[18,"uc"],"J"=>[77,"ue"],"K"=>[18,"ue"],"L"=>[77,"ui"],"M"=>[18,"ui"],"N"=>[77,"uo"],"O"=>[18,"uo"],"P"=>[77,"us"],"Q"=>[18,"us"],"R"=>[77,"ut"],"S"=>[18,"ut"],"T"=>[0,"u\x20"],"U"=>[0,"u\x25"],"V"=>[0,"u-"],"W"=>[0,"u."],"X"=>[0,"u\x2F"],"Y"=>[0,"u3"],"Z"=>[0,"u4"],"\x5B"=>[0,"u5"],"\x5C"=>[0,"u6"],"\x5D"=>[0,"u7"],"\x5E"=>[0,"u8"],"_"=>[0,"u9"],"\x60"=>[0,"u\x3D"],"a"=>[0,"uA"],"b"=>[0,"u_"],"c"=>[0,"ub"],"d"=>[0,"ud"],"e"=>[0,"uf"],"f"=>[0,"ug"],"g"=>[0,"uh"],"h"=>[0,"ul"],"i"=>[0,"um"],"j"=>[0,"un"],"k"=>[0,"up"],"l"=>[0,"ur"],"m"=>[0,"uu"],"n"=>[100,"u"],"o"=>[110,"u"],"p"=>[111,"u"],"q"=>[115,"u"],"r"=>[116,"u"],"s"=>[118,"u"],"t"=>[119,"u"],"u"=>[122,"u"],"v"=>[123,"u"],"w"=>[125,"u"],"x"=>[126,"u"],"y"=>[129,"u"],"z"=>[143,"u"],"\x7B"=>[148,"u"],"\x7C"=>[151,"u"],"\x7D"=>[153,"u"],"~"=>[83,"u"],"\x7F"=>[10,"u"],"\x80"=>[0,"\x3A0"],"\x81"=>[0,"\x3A1"],"\x82"=>[0,"\x3A2"],"\x83"=>[0,"\x3Aa"],"\x84"=>[0,"\x3Ac"],"\x85"=>[0,"\x3Ae"],"\x86"=>[0,"\x3Ai"],"\x87"=>[0,"\x3Ao"],"\x88"=>[0,"\x3As"],"\x89"=>[0,"\x3At"],"\x8A"=>[73,"\x3A"],"\x8B"=>[88,"\x3A"],"\x8C"=>[89,"\x3A"],"\x8D"=>[96,"\x3A"],"\x8E"=>[97,"\x3A"],"\x8F"=>[99,"\x3A"],"\x90"=>[106,"\x3A"],"\x91"=>[136,"\x3A"],"\x92"=>[139,"\x3A"],"\x93"=>[141,"\x3A"],"\x94"=>[145,"\x3A"],"\x95"=>[147,"\x3A"],"\x96"=>[149,"\x3A"],"\x97"=>[101,"\x3A"],"\x98"=>[112,"\x3A"],"\x99"=>[117,"\x3A"],"\x9A"=>[120,"\x3A"],"\x9B"=>[124,"\x3A"],"\x9C"=>[127,"\x3A"],"\x9D"=>[144,"\x3A"],"\x9E"=>[152,"\x3A"],"\x9F"=>[11,"\x3A"],"\xA0"=>[0,"B0"],"\xA1"=>[0,"B1"],"\xA2"=>[0,"B2"],"\xA3"=>[0,"Ba"],"\xA4"=>[0,"Bc"],"\xA5"=>[0,"Be"],"\xA6"=>[0,"Bi"],"\xA7"=>[0,"Bo"],"\xA8"=>[0,"Bs"],"\xA9"=>[0,"Bt"],"\xAA"=>[73,"B"],"\xAB"=>[88,"B"],"\xAC"=>[89,"B"],"\xAD"=>[96,"B"],"\xAE"=>[97,"B"],"\xAF"=>[99,"B"],"\xB0"=>[106,"B"],"\xB1"=>[136,"B"],"\xB2"=>[139,"B"],"\xB3"=>[141,"B"],"\xB4"=>[145,"B"],"\xB5"=>[147,"B"],"\xB6"=>[149,"B"],"\xB7"=>[101,"B"],"\xB8"=>[112,"B"],"\xB9"=>[117,"B"],"\xBA"=>[120,"B"],"\xBB"=>[124,"B"],"\xBC"=>[127,"B"],"\xBD"=>[144,"B"],"\xBE"=>[152,"B"],"\xBF"=>[11,"B"],"\xC0"=>[0,"C0"],"\xC1"=>[0,"C1"],"\xC2"=>[0,"C2"],"\xC3"=>[0,"Ca"],"\xC4"=>[0,"Cc"],"\xC5"=>[0,"Ce"],"\xC6"=>[0,"Ci"],"\xC7"=>[0,"Co"],"\xC8"=>[0,"Cs"],"\xC9"=>[0,"Ct"],"\xCA"=>[73,"C"],"\xCB"=>[88,"C"],"\xCC"=>[89,"C"],"\xCD"=>[96,"C"],"\xCE"=>[97,"C"],"\xCF"=>[99,"C"],"\xD0"=>[106,"C"],"\xD1"=>[136,"C"],"\xD2"=>[139,"C"],"\xD3"=>[141,"C"],"\xD4"=>[145,"C"],"\xD5"=>[147,"C"],"\xD6"=>[149,"C"],"\xD7"=>[101,"C"],"\xD8"=>[112,"C"],"\xD9"=>[117,"C"],"\xDA"=>[120,"C"],"\xDB"=>[124,"C"],"\xDC"=>[127,"C"],"\xDD"=>[144,"C"],"\xDE"=>[152,"C"],"\xDF"=>[11,"C"],"\xE0"=>[0,"D0"],"\xE1"=>[0,"D1"],"\xE2"=>[0,"D2"],"\xE3"=>[0,"Da"],"\xE4"=>[0,"Dc"],"\xE5"=>[0,"De"],"\xE6"=>[0,"Di"],"\xE7"=>[0,"Do"],"\xE8"=>[0,"Ds"],"\xE9"=>[0,"Dt"],"\xEA"=>[73,"D"],"\xEB"=>[88,"D"],"\xEC"=>[89,"D"],"\xED"=>[96,"D"],"\xEE"=>[97,"D"],"\xEF"=>[99,"D"],"\xF0"=>[106,"D"],"\xF1"=>[136,"D"],"\xF2"=>[139,"D"],"\xF3"=>[141,"D"],"\xF4"=>[145,"D"],"\xF5"=>[147,"D"],"\xF6"=>[149,"D"],"\xF7"=>[101,"D"],"\xF8"=>[112,"D"],"\xF9"=>[117,"D"],"\xFA"=>[120,"D"],"\xFB"=>[124,"D"],"\xFC"=>[127,"D"],"\xFD"=>[144,"D"],"\xFE"=>[152,"D"],"\xFF"=>[11,"D"],],["\x00"=>[0,"l0"],"\x01"=>[0,"l1"],"\x02"=>[0,"l2"],"\x03"=>[0,"la"],"\x04"=>[0,"lc"],"\x05"=>[0,"le"],"\x06"=>[0,"li"],"\x07"=>[0,"lo"],"\x08"=>[0,"ls"],"\x09"=>[0,"lt"],"\x0A"=>[73,"l"],"\x0B"=>[88,"l"],"\x0C"=>[89,"l"],"\x0D"=>[96,"l"],"\x0E"=>[97,"l"],"\x0F"=>[99,"l"],"\x10"=>[106,"l"],"\x11"=>[136,"l"],"\x12"=>[139,"l"],"\x13"=>[141,"l"],"\x14"=>[145,"l"],"\x15"=>[147,"l"],"\x16"=>[149,"l"],"\x17"=>[101,"l"],"\x18"=>[112,"l"],"\x19"=>[117,"l"],"\x1A"=>[120,"l"],"\x1B"=>[124,"l"],"\x1C"=>[127,"l"],"\x1D"=>[144,"l"],"\x1E"=>[152,"l"],"\x1F"=>[11,"l"],"\x20"=>[0,"m0"],"\x21"=>[0,"m1"],"\x22"=>[0,"m2"],"\x23"=>[0,"ma"],"\x24"=>[0,"mc"],"\x25"=>[0,"me"],"\x26"=>[0,"mi"],"\x27"=>[0,"mo"],"\x28"=>[0,"ms"],"\x29"=>[0,"mt"],"\x2A"=>[73,"m"],"\x2B"=>[88,"m"],"\x2C"=>[89,"m"],"-"=>[96,"m"],"."=>[97,"m"],"\x2F"=>[99,"m"],[106,"m"],[136,"m"],[139,"m"],[141,"m"],[145,"m"],[147,"m"],[149,"m"],[101,"m"],[112,"m"],[117,"m"],"\x3A"=>[120,"m"],"\x3B"=>[124,"m"],"\x3C"=>[127,"m"],"\x3D"=>[144,"m"],"\x3E"=>[152,"m"],"\x3F"=>[11,"m"],"\x40"=>[0,"n0"],"A"=>[0,"n1"],"B"=>[0,"n2"],"C"=>[0,"na"],"D"=>[0,"nc"],"E"=>[0,"ne"],"F"=>[0,"ni"],"G"=>[0,"no"],"H"=>[0,"ns"],"I"=>[0,"nt"],"J"=>[73,"n"],"K"=>[88,"n"],"L"=>[89,"n"],"M"=>[96,"n"],"N"=>[97,"n"],"O"=>[99,"n"],"P"=>[106,"n"],"Q"=>[136,"n"],"R"=>[139,"n"],"S"=>[141,"n"],"T"=>[145,"n"],"U"=>[147,"n"],"V"=>[149,"n"],"W"=>[101,"n"],"X"=>[112,"n"],"Y"=>[117,"n"],"Z"=>[120,"n"],"\x5B"=>[124,"n"],"\x5C"=>[127,"n"],"\x5D"=>[144,"n"],"\x5E"=>[152,"n"],"_"=>[11,"n"],"\x60"=>[0,"p0"],"a"=>[0,"p1"],"b"=>[0,"p2"],"c"=>[0,"pa"],"d"=>[0,"pc"],"e"=>[0,"pe"],"f"=>[0,"pi"],"g"=>[0,"po"],"h"=>[0,"ps"],"i"=>[0,"pt"],"j"=>[73,"p"],"k"=>[88,"p"],"l"=>[89,"p"],"m"=>[96,"p"],"n"=>[97,"p"],"o"=>[99,"p"],"p"=>[106,"p"],"q"=>[136,"p"],"r"=>[139,"p"],"s"=>[141,"p"],"t"=>[145,"p"],"u"=>[147,"p"],"v"=>[149,"p"],"w"=>[101,"p"],"x"=>[112,"p"],"y"=>[117,"p"],"z"=>[120,"p"],"\x7B"=>[124,"p"],"\x7C"=>[127,"p"],"\x7D"=>[144,"p"],"~"=>[152,"p"],"\x7F"=>[11,"p"],"\x80"=>[0,"r0"],"\x81"=>[0,"r1"],"\x82"=>[0,"r2"],"\x83"=>[0,"ra"],"\x84"=>[0,"rc"],"\x85"=>[0,"re"],"\x86"=>[0,"ri"],"\x87"=>[0,"ro"],"\x88"=>[0,"rs"],"\x89"=>[0,"rt"],"\x8A"=>[73,"r"],"\x8B"=>[88,"r"],"\x8C"=>[89,"r"],"\x8D"=>[96,"r"],"\x8E"=>[97,"r"],"\x8F"=>[99,"r"],"\x90"=>[106,"r"],"\x91"=>[136,"r"],"\x92"=>[139,"r"],"\x93"=>[141,"r"],"\x94"=>[145,"r"],"\x95"=>[147,"r"],"\x96"=>[149,"r"],"\x97"=>[101,"r"],"\x98"=>[112,"r"],"\x99"=>[117,"r"],"\x9A"=>[120,"r"],"\x9B"=>[124,"r"],"\x9C"=>[127,"r"],"\x9D"=>[144,"r"],"\x9E"=>[152,"r"],"\x9F"=>[11,"r"],"\xA0"=>[0,"u0"],"\xA1"=>[0,"u1"],"\xA2"=>[0,"u2"],"\xA3"=>[0,"ua"],"\xA4"=>[0,"uc"],"\xA5"=>[0,"ue"],"\xA6"=>[0,"ui"],"\xA7"=>[0,"uo"],"\xA8"=>[0,"us"],"\xA9"=>[0,"ut"],"\xAA"=>[73,"u"],"\xAB"=>[88,"u"],"\xAC"=>[89,"u"],"\xAD"=>[96,"u"],"\xAE"=>[97,"u"],"\xAF"=>[99,"u"],"\xB0"=>[106,"u"],"\xB1"=>[136,"u"],"\xB2"=>[139,"u"],"\xB3"=>[141,"u"],"\xB4"=>[145,"u"],"\xB5"=>[147,"u"],"\xB6"=>[149,"u"],"\xB7"=>[101,"u"],"\xB8"=>[112,"u"],"\xB9"=>[117,"u"],"\xBA"=>[120,"u"],"\xBB"=>[124,"u"],"\xBC"=>[127,"u"],"\xBD"=>[144,"u"],"\xBE"=>[152,"u"],"\xBF"=>[11,"u"],"\xC0"=>[92,"\x3A"],"\xC1"=>[95,"\x3A"],"\xC2"=>[137,"\x3A"],"\xC3"=>[142,"\x3A"],"\xC4"=>[150,"\x3A"],"\xC5"=>[74,"\x3A"],"\xC6"=>[90,"\x3A"],"\xC7"=>[98,"\x3A"],"\xC8"=>[107,"\x3A"],"\xC9"=>[140,"\x3A"],"\xCA"=>[146,"\x3A"],"\xCB"=>[102,"\x3A"],"\xCC"=>[113,"\x3A"],"\xCD"=>[121,"\x3A"],"\xCE"=>[128,"\x3A"],"\xCF"=>[12,"\x3A"],"\xD0"=>[92,"B"],"\xD1"=>[95,"B"],"\xD2"=>[137,"B"],"\xD3"=>[142,"B"],"\xD4"=>[150,"B"],"\xD5"=>[74,"B"],"\xD6"=>[90,"B"],"\xD7"=>[98,"B"],"\xD8"=>[107,"B"],"\xD9"=>[140,"B"],"\xDA"=>[146,"B"],"\xDB"=>[102,"B"],"\xDC"=>[113,"B"],"\xDD"=>[121,"B"],"\xDE"=>[128,"B"],"\xDF"=>[12,"B"],"\xE0"=>[92,"C"],"\xE1"=>[95,"C"],"\xE2"=>[137,"C"],"\xE3"=>[142,"C"],"\xE4"=>[150,"C"],"\xE5"=>[74,"C"],"\xE6"=>[90,"C"],"\xE7"=>[98,"C"],"\xE8"=>[107,"C"],"\xE9"=>[140,"C"],"\xEA"=>[146,"C"],"\xEB"=>[102,"C"],"\xEC"=>[113,"C"],"\xED"=>[121,"C"],"\xEE"=>[128,"C"],"\xEF"=>[12,"C"],"\xF0"=>[92,"D"],"\xF1"=>[95,"D"],"\xF2"=>[137,"D"],"\xF3"=>[142,"D"],"\xF4"=>[150,"D"],"\xF5"=>[74,"D"],"\xF6"=>[90,"D"],"\xF7"=>[98,"D"],"\xF8"=>[107,"D"],"\xF9"=>[140,"D"],"\xFA"=>[146,"D"],"\xFB"=>[102,"D"],"\xFC"=>[113,"D"],"\xFD"=>[121,"D"],"\xFE"=>[128,"D"],"\xFF"=>[12,"D"],],["\x00"=>[92,"\x3D"],"\x01"=>[95,"\x3D"],"\x02"=>[137,"\x3D"],"\x03"=>[142,"\x3D"],"\x04"=>[150,"\x3D"],"\x05"=>[74,"\x3D"],"\x06"=>[90,"\x3D"],"\x07"=>[98,"\x3D"],"\x08"=>[107,"\x3D"],"\x09"=>[140,"\x3D"],"\x0A"=>[146,"\x3D"],"\x0B"=>[102,"\x3D"],"\x0C"=>[113,"\x3D"],"\x0D"=>[121,"\x3D"],"\x0E"=>[128,"\x3D"],"\x0F"=>[12,"\x3D"],"\x10"=>[92,"A"],"\x11"=>[95,"A"],"\x12"=>[137,"A"],"\x13"=>[142,"A"],"\x14"=>[150,"A"],"\x15"=>[74,"A"],"\x16"=>[90,"A"],"\x17"=>[98,"A"],"\x18"=>[107,"A"],"\x19"=>[140,"A"],"\x1A"=>[146,"A"],"\x1B"=>[102,"A"],"\x1C"=>[113,"A"],"\x1D"=>[121,"A"],"\x1E"=>[128,"A"],"\x1F"=>[12,"A"],"\x20"=>[92,"_"],"\x21"=>[95,"_"],"\x22"=>[137,"_"],"\x23"=>[142,"_"],"\x24"=>[150,"_"],"\x25"=>[74,"_"],"\x26"=>[90,"_"],"\x27"=>[98,"_"],"\x28"=>[107,"_"],"\x29"=>[140,"_"],"\x2A"=>[146,"_"],"\x2B"=>[102,"_"],"\x2C"=>[113,"_"],"-"=>[121,"_"],"."=>[128,"_"],"\x2F"=>[12,"_"],[92,"b"],[95,"b"],[137,"b"],[142,"b"],[150,"b"],[74,"b"],[90,"b"],[98,"b"],[107,"b"],[140,"b"],"\x3A"=>[146,"b"],"\x3B"=>[102,"b"],"\x3C"=>[113,"b"],"\x3D"=>[121,"b"],"\x3E"=>[128,"b"],"\x3F"=>[12,"b"],"\x40"=>[92,"d"],"A"=>[95,"d"],"B"=>[137,"d"],"C"=>[142,"d"],"D"=>[150,"d"],"E"=>[74,"d"],"F"=>[90,"d"],"G"=>[98,"d"],"H"=>[107,"d"],"I"=>[140,"d"],"J"=>[146,"d"],"K"=>[102,"d"],"L"=>[113,"d"],"M"=>[121,"d"],"N"=>[128,"d"],"O"=>[12,"d"],"P"=>[92,"f"],"Q"=>[95,"f"],"R"=>[137,"f"],"S"=>[142,"f"],"T"=>[150,"f"],"U"=>[74,"f"],"V"=>[90,"f"],"W"=>[98,"f"],"X"=>[107,"f"],"Y"=>[140,"f"],"Z"=>[146,"f"],"\x5B"=>[102,"f"],"\x5C"=>[113,"f"],"\x5D"=>[121,"f"],"\x5E"=>[128,"f"],"_"=>[12,"f"],"\x60"=>[92,"g"],"a"=>[95,"g"],"b"=>[137,"g"],"c"=>[142,"g"],"d"=>[150,"g"],"e"=>[74,"g"],"f"=>[90,"g"],"g"=>[98,"g"],"h"=>[107,"g"],"i"=>[140,"g"],"j"=>[146,"g"],"k"=>[102,"g"],"l"=>[113,"g"],"m"=>[121,"g"],"n"=>[128,"g"],"o"=>[12,"g"],"p"=>[92,"h"],"q"=>[95,"h"],"r"=>[137,"h"],"s"=>[142,"h"],"t"=>[150,"h"],"u"=>[74,"h"],"v"=>[90,"h"],"w"=>[98,"h"],"x"=>[107,"h"],"y"=>[140,"h"],"z"=>[146,"h"],"\x7B"=>[102,"h"],"\x7C"=>[113,"h"],"\x7D"=>[121,"h"],"~"=>[128,"h"],"\x7F"=>[12,"h"],"\x80"=>[92,"l"],"\x81"=>[95,"l"],"\x82"=>[137,"l"],"\x83"=>[142,"l"],"\x84"=>[150,"l"],"\x85"=>[74,"l"],"\x86"=>[90,"l"],"\x87"=>[98,"l"],"\x88"=>[107,"l"],"\x89"=>[140,"l"],"\x8A"=>[146,"l"],"\x8B"=>[102,"l"],"\x8C"=>[113,"l"],"\x8D"=>[121,"l"],"\x8E"=>[128,"l"],"\x8F"=>[12,"l"],"\x90"=>[92,"m"],"\x91"=>[95,"m"],"\x92"=>[137,"m"],"\x93"=>[142,"m"],"\x94"=>[150,"m"],"\x95"=>[74,"m"],"\x96"=>[90,"m"],"\x97"=>[98,"m"],"\x98"=>[107,"m"],"\x99"=>[140,"m"],"\x9A"=>[146,"m"],"\x9B"=>[102,"m"],"\x9C"=>[113,"m"],"\x9D"=>[121,"m"],"\x9E"=>[128,"m"],"\x9F"=>[12,"m"],"\xA0"=>[92,"n"],"\xA1"=>[95,"n"],"\xA2"=>[137,"n"],"\xA3"=>[142,"n"],"\xA4"=>[150,"n"],"\xA5"=>[74,"n"],"\xA6"=>[90,"n"],"\xA7"=>[98,"n"],"\xA8"=>[107,"n"],"\xA9"=>[140,"n"],"\xAA"=>[146,"n"],"\xAB"=>[102,"n"],"\xAC"=>[113,"n"],"\xAD"=>[121,"n"],"\xAE"=>[128,"n"],"\xAF"=>[12,"n"],"\xB0"=>[92,"p"],"\xB1"=>[95,"p"],"\xB2"=>[137,"p"],"\xB3"=>[142,"p"],"\xB4"=>[150,"p"],"\xB5"=>[74,"p"],"\xB6"=>[90,"p"],"\xB7"=>[98,"p"],"\xB8"=>[107,"p"],"\xB9"=>[140,"p"],"\xBA"=>[146,"p"],"\xBB"=>[102,"p"],"\xBC"=>[113,"p"],"\xBD"=>[121,"p"],"\xBE"=>[128,"p"],"\xBF"=>[12,"p"],"\xC0"=>[92,"r"],"\xC1"=>[95,"r"],"\xC2"=>[137,"r"],"\xC3"=>[142,"r"],"\xC4"=>[150,"r"],"\xC5"=>[74,"r"],"\xC6"=>[90,"r"],"\xC7"=>[98,"r"],"\xC8"=>[107,"r"],"\xC9"=>[140,"r"],"\xCA"=>[146,"r"],"\xCB"=>[102,"r"],"\xCC"=>[113,"r"],"\xCD"=>[121,"r"],"\xCE"=>[128,"r"],"\xCF"=>[12,"r"],"\xD0"=>[92,"u"],"\xD1"=>[95,"u"],"\xD2"=>[137,"u"],"\xD3"=>[142,"u"],"\xD4"=>[150,"u"],"\xD5"=>[74,"u"],"\xD6"=>[90,"u"],"\xD7"=>[98,"u"],"\xD8"=>[107,"u"],"\xD9"=>[140,"u"],"\xDA"=>[146,"u"],"\xDB"=>[102,"u"],"\xDC"=>[113,"u"],"\xDD"=>[121,"u"],"\xDE"=>[128,"u"],"\xDF"=>[12,"u"],"\xE0"=>[93,"\x3A"],"\xE1"=>[138,"\x3A"],"\xE2"=>[75,"\x3A"],"\xE3"=>[91,"\x3A"],"\xE4"=>[108,"\x3A"],"\xE5"=>[103,"\x3A"],"\xE6"=>[114,"\x3A"],"\xE7"=>[14,"\x3A"],"\xE8"=>[93,"B"],"\xE9"=>[138,"B"],"\xEA"=>[75,"B"],"\xEB"=>[91,"B"],"\xEC"=>[108,"B"],"\xED"=>[103,"B"],"\xEE"=>[114,"B"],"\xEF"=>[14,"B"],"\xF0"=>[93,"C"],"\xF1"=>[138,"C"],"\xF2"=>[75,"C"],"\xF3"=>[91,"C"],"\xF4"=>[108,"C"],"\xF5"=>[103,"C"],"\xF6"=>[114,"C"],"\xF7"=>[14,"C"],"\xF8"=>[93,"D"],"\xF9"=>[138,"D"],"\xFA"=>[75,"D"],"\xFB"=>[91,"D"],"\xFC"=>[108,"D"],"\xFD"=>[103,"D"],"\xFE"=>[114,"D"],"\xFF"=>[14,"D"],],["\x00"=>[94,"\x3C0"],"\x01"=>[76,"\x3C0"],"\x02"=>[104,"\x3C0"],"\x03"=>[16,"\x3C0"],"\x04"=>[94,"\x3C1"],"\x05"=>[76,"\x3C1"],"\x06"=>[104,"\x3C1"],"\x07"=>[16,"\x3C1"],"\x08"=>[94,"\x3C2"],"\x09"=>[76,"\x3C2"],"\x0A"=>[104,"\x3C2"],"\x0B"=>[16,"\x3C2"],"\x0C"=>[94,"\x3Ca"],"\x0D"=>[76,"\x3Ca"],"\x0E"=>[104,"\x3Ca"],"\x0F"=>[16,"\x3Ca"],"\x10"=>[94,"\x3Cc"],"\x11"=>[76,"\x3Cc"],"\x12"=>[104,"\x3Cc"],"\x13"=>[16,"\x3Cc"],"\x14"=>[94,"\x3Ce"],"\x15"=>[76,"\x3Ce"],"\x16"=>[104,"\x3Ce"],"\x17"=>[16,"\x3Ce"],"\x18"=>[94,"\x3Ci"],"\x19"=>[76,"\x3Ci"],"\x1A"=>[104,"\x3Ci"],"\x1B"=>[16,"\x3Ci"],"\x1C"=>[94,"\x3Co"],"\x1D"=>[76,"\x3Co"],"\x1E"=>[104,"\x3Co"],"\x1F"=>[16,"\x3Co"],"\x20"=>[94,"\x3Cs"],"\x21"=>[76,"\x3Cs"],"\x22"=>[104,"\x3Cs"],"\x23"=>[16,"\x3Cs"],"\x24"=>[94,"\x3Ct"],"\x25"=>[76,"\x3Ct"],"\x26"=>[104,"\x3Ct"],"\x27"=>[16,"\x3Ct"],"\x28"=>[77,"\x3C\x20"],"\x29"=>[18,"\x3C\x20"],"\x2A"=>[77,"\x3C\x25"],"\x2B"=>[18,"\x3C\x25"],"\x2C"=>[77,"\x3C-"],"-"=>[18,"\x3C-"],"."=>[77,"\x3C."],"\x2F"=>[18,"\x3C."],[77,"\x3C\x2F"],[18,"\x3C\x2F"],[77,"\x3C3"],[18,"\x3C3"],[77,"\x3C4"],[18,"\x3C4"],[77,"\x3C5"],[18,"\x3C5"],[77,"\x3C6"],[18,"\x3C6"],"\x3A"=>[77,"\x3C7"],"\x3B"=>[18,"\x3C7"],"\x3C"=>[77,"\x3C8"],"\x3D"=>[18,"\x3C8"],"\x3E"=>[77,"\x3C9"],"\x3F"=>[18,"\x3C9"],"\x40"=>[77,"\x3C\x3D"],"A"=>[18,"\x3C\x3D"],"B"=>[77,"\x3CA"],"C"=>[18,"\x3CA"],"D"=>[77,"\x3C_"],"E"=>[18,"\x3C_"],"F"=>[77,"\x3Cb"],"G"=>[18,"\x3Cb"],"H"=>[77,"\x3Cd"],"I"=>[18,"\x3Cd"],"J"=>[77,"\x3Cf"],"K"=>[18,"\x3Cf"],"L"=>[77,"\x3Cg"],"M"=>[18,"\x3Cg"],"N"=>[77,"\x3Ch"],"O"=>[18,"\x3Ch"],"P"=>[77,"\x3Cl"],"Q"=>[18,"\x3Cl"],"R"=>[77,"\x3Cm"],"S"=>[18,"\x3Cm"],"T"=>[77,"\x3Cn"],"U"=>[18,"\x3Cn"],"V"=>[77,"\x3Cp"],"W"=>[18,"\x3Cp"],"X"=>[77,"\x3Cr"],"Y"=>[18,"\x3Cr"],"Z"=>[77,"\x3Cu"],"\x5B"=>[18,"\x3Cu"],"\x5C"=>[0,"\x3C\x3A"],"\x5D"=>[0,"\x3CB"],"\x5E"=>[0,"\x3CC"],"_"=>[0,"\x3CD"],"\x60"=>[0,"\x3CE"],"a"=>[0,"\x3CF"],"b"=>[0,"\x3CG"],"c"=>[0,"\x3CH"],"d"=>[0,"\x3CI"],"e"=>[0,"\x3CJ"],"f"=>[0,"\x3CK"],"g"=>[0,"\x3CL"],"h"=>[0,"\x3CM"],"i"=>[0,"\x3CN"],"j"=>[0,"\x3CO"],"k"=>[0,"\x3CP"],"l"=>[0,"\x3CQ"],"m"=>[0,"\x3CR"],"n"=>[0,"\x3CS"],"o"=>[0,"\x3CT"],"p"=>[0,"\x3CU"],"q"=>[0,"\x3CV"],"r"=>[0,"\x3CW"],"s"=>[0,"\x3CY"],"t"=>[0,"\x3Cj"],"u"=>[0,"\x3Ck"],"v"=>[0,"\x3Cq"],"w"=>[0,"\x3Cv"],"x"=>[0,"\x3Cw"],"y"=>[0,"\x3Cx"],"z"=>[0,"\x3Cy"],"\x7B"=>[0,"\x3Cz"],"\x7C"=>[82,"\x3C"],"\x7D"=>[87,"\x3C"],"~"=>[130,"\x3C"],"\x7F"=>[9,"\x3C"],"\x80"=>[94,"\x600"],"\x81"=>[76,"\x600"],"\x82"=>[104,"\x600"],"\x83"=>[16,"\x600"],"\x84"=>[94,"\x601"],"\x85"=>[76,"\x601"],"\x86"=>[104,"\x601"],"\x87"=>[16,"\x601"],"\x88"=>[94,"\x602"],"\x89"=>[76,"\x602"],"\x8A"=>[104,"\x602"],"\x8B"=>[16,"\x602"],"\x8C"=>[94,"\x60a"],"\x8D"=>[76,"\x60a"],"\x8E"=>[104,"\x60a"],"\x8F"=>[16,"\x60a"],"\x90"=>[94,"\x60c"],"\x91"=>[76,"\x60c"],"\x92"=>[104,"\x60c"],"\x93"=>[16,"\x60c"],"\x94"=>[94,"\x60e"],"\x95"=>[76,"\x60e"],"\x96"=>[104,"\x60e"],"\x97"=>[16,"\x60e"],"\x98"=>[94,"\x60i"],"\x99"=>[76,"\x60i"],"\x9A"=>[104,"\x60i"],"\x9B"=>[16,"\x60i"],"\x9C"=>[94,"\x60o"],"\x9D"=>[76,"\x60o"],"\x9E"=>[104,"\x60o"],"\x9F"=>[16,"\x60o"],"\xA0"=>[94,"\x60s"],"\xA1"=>[76,"\x60s"],"\xA2"=>[104,"\x60s"],"\xA3"=>[16,"\x60s"],"\xA4"=>[94,"\x60t"],"\xA5"=>[76,"\x60t"],"\xA6"=>[104,"\x60t"],"\xA7"=>[16,"\x60t"],"\xA8"=>[77,"\x60\x20"],"\xA9"=>[18,"\x60\x20"],"\xAA"=>[77,"\x60\x25"],"\xAB"=>[18,"\x60\x25"],"\xAC"=>[77,"\x60-"],"\xAD"=>[18,"\x60-"],"\xAE"=>[77,"\x60."],"\xAF"=>[18,"\x60."],"\xB0"=>[77,"\x60\x2F"],"\xB1"=>[18,"\x60\x2F"],"\xB2"=>[77,"\x603"],"\xB3"=>[18,"\x603"],"\xB4"=>[77,"\x604"],"\xB5"=>[18,"\x604"],"\xB6"=>[77,"\x605"],"\xB7"=>[18,"\x605"],"\xB8"=>[77,"\x606"],"\xB9"=>[18,"\x606"],"\xBA"=>[77,"\x607"],"\xBB"=>[18,"\x607"],"\xBC"=>[77,"\x608"],"\xBD"=>[18,"\x608"],"\xBE"=>[77,"\x609"],"\xBF"=>[18,"\x609"],"\xC0"=>[77,"\x60\x3D"],"\xC1"=>[18,"\x60\x3D"],"\xC2"=>[77,"\x60A"],"\xC3"=>[18,"\x60A"],"\xC4"=>[77,"\x60_"],"\xC5"=>[18,"\x60_"],"\xC6"=>[77,"\x60b"],"\xC7"=>[18,"\x60b"],"\xC8"=>[77,"\x60d"],"\xC9"=>[18,"\x60d"],"\xCA"=>[77,"\x60f"],"\xCB"=>[18,"\x60f"],"\xCC"=>[77,"\x60g"],"\xCD"=>[18,"\x60g"],"\xCE"=>[77,"\x60h"],"\xCF"=>[18,"\x60h"],"\xD0"=>[77,"\x60l"],"\xD1"=>[18,"\x60l"],"\xD2"=>[77,"\x60m"],"\xD3"=>[18,"\x60m"],"\xD4"=>[77,"\x60n"],"\xD5"=>[18,"\x60n"],"\xD6"=>[77,"\x60p"],"\xD7"=>[18,"\x60p"],"\xD8"=>[77,"\x60r"],"\xD9"=>[18,"\x60r"],"\xDA"=>[77,"\x60u"],"\xDB"=>[18,"\x60u"],"\xDC"=>[0,"\x60\x3A"],"\xDD"=>[0,"\x60B"],"\xDE"=>[0,"\x60C"],"\xDF"=>[0,"\x60D"],"\xE0"=>[0,"\x60E"],"\xE1"=>[0,"\x60F"],"\xE2"=>[0,"\x60G"],"\xE3"=>[0,"\x60H"],"\xE4"=>[0,"\x60I"],"\xE5"=>[0,"\x60J"],"\xE6"=>[0,"\x60K"],"\xE7"=>[0,"\x60L"],"\xE8"=>[0,"\x60M"],"\xE9"=>[0,"\x60N"],"\xEA"=>[0,"\x60O"],"\xEB"=>[0,"\x60P"],"\xEC"=>[0,"\x60Q"],"\xED"=>[0,"\x60R"],"\xEE"=>[0,"\x60S"],"\xEF"=>[0,"\x60T"],"\xF0"=>[0,"\x60U"],"\xF1"=>[0,"\x60V"],"\xF2"=>[0,"\x60W"],"\xF3"=>[0,"\x60Y"],"\xF4"=>[0,"\x60j"],"\xF5"=>[0,"\x60k"],"\xF6"=>[0,"\x60q"],"\xF7"=>[0,"\x60v"],"\xF8"=>[0,"\x60w"],"\xF9"=>[0,"\x60x"],"\xFA"=>[0,"\x60y"],"\xFB"=>[0,"\x60z"],"\xFC"=>[82,"\x60"],"\xFD"=>[87,"\x60"],"\xFE"=>[130,"\x60"],"\xFF"=>[9,"\x60"],],["\x00"=>[94,"\x3D0"],"\x01"=>[76,"\x3D0"],"\x02"=>[104,"\x3D0"],"\x03"=>[16,"\x3D0"],"\x04"=>[94,"\x3D1"],"\x05"=>[76,"\x3D1"],"\x06"=>[104,"\x3D1"],"\x07"=>[16,"\x3D1"],"\x08"=>[94,"\x3D2"],"\x09"=>[76,"\x3D2"],"\x0A"=>[104,"\x3D2"],"\x0B"=>[16,"\x3D2"],"\x0C"=>[94,"\x3Da"],"\x0D"=>[76,"\x3Da"],"\x0E"=>[104,"\x3Da"],"\x0F"=>[16,"\x3Da"],"\x10"=>[94,"\x3Dc"],"\x11"=>[76,"\x3Dc"],"\x12"=>[104,"\x3Dc"],"\x13"=>[16,"\x3Dc"],"\x14"=>[94,"\x3De"],"\x15"=>[76,"\x3De"],"\x16"=>[104,"\x3De"],"\x17"=>[16,"\x3De"],"\x18"=>[94,"\x3Di"],"\x19"=>[76,"\x3Di"],"\x1A"=>[104,"\x3Di"],"\x1B"=>[16,"\x3Di"],"\x1C"=>[94,"\x3Do"],"\x1D"=>[76,"\x3Do"],"\x1E"=>[104,"\x3Do"],"\x1F"=>[16,"\x3Do"],"\x20"=>[94,"\x3Ds"],"\x21"=>[76,"\x3Ds"],"\x22"=>[104,"\x3Ds"],"\x23"=>[16,"\x3Ds"],"\x24"=>[94,"\x3Dt"],"\x25"=>[76,"\x3Dt"],"\x26"=>[104,"\x3Dt"],"\x27"=>[16,"\x3Dt"],"\x28"=>[77,"\x3D\x20"],"\x29"=>[18,"\x3D\x20"],"\x2A"=>[77,"\x3D\x25"],"\x2B"=>[18,"\x3D\x25"],"\x2C"=>[77,"\x3D-"],"-"=>[18,"\x3D-"],"."=>[77,"\x3D."],"\x2F"=>[18,"\x3D."],[77,"\x3D\x2F"],[18,"\x3D\x2F"],[77,"\x3D3"],[18,"\x3D3"],[77,"\x3D4"],[18,"\x3D4"],[77,"\x3D5"],[18,"\x3D5"],[77,"\x3D6"],[18,"\x3D6"],"\x3A"=>[77,"\x3D7"],"\x3B"=>[18,"\x3D7"],"\x3C"=>[77,"\x3D8"],"\x3D"=>[18,"\x3D8"],"\x3E"=>[77,"\x3D9"],"\x3F"=>[18,"\x3D9"],"\x40"=>[77,"\x3D\x3D"],"A"=>[18,"\x3D\x3D"],"B"=>[77,"\x3DA"],"C"=>[18,"\x3DA"],"D"=>[77,"\x3D_"],"E"=>[18,"\x3D_"],"F"=>[77,"\x3Db"],"G"=>[18,"\x3Db"],"H"=>[77,"\x3Dd"],"I"=>[18,"\x3Dd"],"J"=>[77,"\x3Df"],"K"=>[18,"\x3Df"],"L"=>[77,"\x3Dg"],"M"=>[18,"\x3Dg"],"N"=>[77,"\x3Dh"],"O"=>[18,"\x3Dh"],"P"=>[77,"\x3Dl"],"Q"=>[18,"\x3Dl"],"R"=>[77,"\x3Dm"],"S"=>[18,"\x3Dm"],"T"=>[77,"\x3Dn"],"U"=>[18,"\x3Dn"],"V"=>[77,"\x3Dp"],"W"=>[18,"\x3Dp"],"X"=>[77,"\x3Dr"],"Y"=>[18,"\x3Dr"],"Z"=>[77,"\x3Du"],"\x5B"=>[18,"\x3Du"],"\x5C"=>[0,"\x3D\x3A"],"\x5D"=>[0,"\x3DB"],"\x5E"=>[0,"\x3DC"],"_"=>[0,"\x3DD"],"\x60"=>[0,"\x3DE"],"a"=>[0,"\x3DF"],"b"=>[0,"\x3DG"],"c"=>[0,"\x3DH"],"d"=>[0,"\x3DI"],"e"=>[0,"\x3DJ"],"f"=>[0,"\x3DK"],"g"=>[0,"\x3DL"],"h"=>[0,"\x3DM"],"i"=>[0,"\x3DN"],"j"=>[0,"\x3DO"],"k"=>[0,"\x3DP"],"l"=>[0,"\x3DQ"],"m"=>[0,"\x3DR"],"n"=>[0,"\x3DS"],"o"=>[0,"\x3DT"],"p"=>[0,"\x3DU"],"q"=>[0,"\x3DV"],"r"=>[0,"\x3DW"],"s"=>[0,"\x3DY"],"t"=>[0,"\x3Dj"],"u"=>[0,"\x3Dk"],"v"=>[0,"\x3Dq"],"w"=>[0,"\x3Dv"],"x"=>[0,"\x3Dw"],"y"=>[0,"\x3Dx"],"z"=>[0,"\x3Dy"],"\x7B"=>[0,"\x3Dz"],"\x7C"=>[82,"\x3D"],"\x7D"=>[87,"\x3D"],"~"=>[130,"\x3D"],"\x7F"=>[9,"\x3D"],"\x80"=>[94,"A0"],"\x81"=>[76,"A0"],"\x82"=>[104,"A0"],"\x83"=>[16,"A0"],"\x84"=>[94,"A1"],"\x85"=>[76,"A1"],"\x86"=>[104,"A1"],"\x87"=>[16,"A1"],"\x88"=>[94,"A2"],"\x89"=>[76,"A2"],"\x8A"=>[104,"A2"],"\x8B"=>[16,"A2"],"\x8C"=>[94,"Aa"],"\x8D"=>[76,"Aa"],"\x8E"=>[104,"Aa"],"\x8F"=>[16,"Aa"],"\x90"=>[94,"Ac"],"\x91"=>[76,"Ac"],"\x92"=>[104,"Ac"],"\x93"=>[16,"Ac"],"\x94"=>[94,"Ae"],"\x95"=>[76,"Ae"],"\x96"=>[104,"Ae"],"\x97"=>[16,"Ae"],"\x98"=>[94,"Ai"],"\x99"=>[76,"Ai"],"\x9A"=>[104,"Ai"],"\x9B"=>[16,"Ai"],"\x9C"=>[94,"Ao"],"\x9D"=>[76,"Ao"],"\x9E"=>[104,"Ao"],"\x9F"=>[16,"Ao"],"\xA0"=>[94,"As"],"\xA1"=>[76,"As"],"\xA2"=>[104,"As"],"\xA3"=>[16,"As"],"\xA4"=>[94,"At"],"\xA5"=>[76,"At"],"\xA6"=>[104,"At"],"\xA7"=>[16,"At"],"\xA8"=>[77,"A\x20"],"\xA9"=>[18,"A\x20"],"\xAA"=>[77,"A\x25"],"\xAB"=>[18,"A\x25"],"\xAC"=>[77,"A-"],"\xAD"=>[18,"A-"],"\xAE"=>[77,"A."],"\xAF"=>[18,"A."],"\xB0"=>[77,"A\x2F"],"\xB1"=>[18,"A\x2F"],"\xB2"=>[77,"A3"],"\xB3"=>[18,"A3"],"\xB4"=>[77,"A4"],"\xB5"=>[18,"A4"],"\xB6"=>[77,"A5"],"\xB7"=>[18,"A5"],"\xB8"=>[77,"A6"],"\xB9"=>[18,"A6"],"\xBA"=>[77,"A7"],"\xBB"=>[18,"A7"],"\xBC"=>[77,"A8"],"\xBD"=>[18,"A8"],"\xBE"=>[77,"A9"],"\xBF"=>[18,"A9"],"\xC0"=>[77,"A\x3D"],"\xC1"=>[18,"A\x3D"],"\xC2"=>[77,"AA"],"\xC3"=>[18,"AA"],"\xC4"=>[77,"A_"],"\xC5"=>[18,"A_"],"\xC6"=>[77,"Ab"],"\xC7"=>[18,"Ab"],"\xC8"=>[77,"Ad"],"\xC9"=>[18,"Ad"],"\xCA"=>[77,"Af"],"\xCB"=>[18,"Af"],"\xCC"=>[77,"Ag"],"\xCD"=>[18,"Ag"],"\xCE"=>[77,"Ah"],"\xCF"=>[18,"Ah"],"\xD0"=>[77,"Al"],"\xD1"=>[18,"Al"],"\xD2"=>[77,"Am"],"\xD3"=>[18,"Am"],"\xD4"=>[77,"An"],"\xD5"=>[18,"An"],"\xD6"=>[77,"Ap"],"\xD7"=>[18,"Ap"],"\xD8"=>[77,"Ar"],"\xD9"=>[18,"Ar"],"\xDA"=>[77,"Au"],"\xDB"=>[18,"Au"],"\xDC"=>[0,"A\x3A"],"\xDD"=>[0,"AB"],"\xDE"=>[0,"AC"],"\xDF"=>[0,"AD"],"\xE0"=>[0,"AE"],"\xE1"=>[0,"AF"],"\xE2"=>[0,"AG"],"\xE3"=>[0,"AH"],"\xE4"=>[0,"AI"],"\xE5"=>[0,"AJ"],"\xE6"=>[0,"AK"],"\xE7"=>[0,"AL"],"\xE8"=>[0,"AM"],"\xE9"=>[0,"AN"],"\xEA"=>[0,"AO"],"\xEB"=>[0,"AP"],"\xEC"=>[0,"AQ"],"\xED"=>[0,"AR"],"\xEE"=>[0,"AS"],"\xEF"=>[0,"AT"],"\xF0"=>[0,"AU"],"\xF1"=>[0,"AV"],"\xF2"=>[0,"AW"],"\xF3"=>[0,"AY"],"\xF4"=>[0,"Aj"],"\xF5"=>[0,"Ak"],"\xF6"=>[0,"Aq"],"\xF7"=>[0,"Av"],"\xF8"=>[0,"Aw"],"\xF9"=>[0,"Ax"],"\xFA"=>[0,"Ay"],"\xFB"=>[0,"Az"],"\xFC"=>[82,"A"],"\xFD"=>[87,"A"],"\xFE"=>[130,"A"],"\xFF"=>[9,"A"],],["\x00"=>[77,"\x3D0"],"\x01"=>[18,"\x3D0"],"\x02"=>[77,"\x3D1"],"\x03"=>[18,"\x3D1"],"\x04"=>[77,"\x3D2"],"\x05"=>[18,"\x3D2"],"\x06"=>[77,"\x3Da"],"\x07"=>[18,"\x3Da"],"\x08"=>[77,"\x3Dc"],"\x09"=>[18,"\x3Dc"],"\x0A"=>[77,"\x3De"],"\x0B"=>[18,"\x3De"],"\x0C"=>[77,"\x3Di"],"\x0D"=>[18,"\x3Di"],"\x0E"=>[77,"\x3Do"],"\x0F"=>[18,"\x3Do"],"\x10"=>[77,"\x3Ds"],"\x11"=>[18,"\x3Ds"],"\x12"=>[77,"\x3Dt"],"\x13"=>[18,"\x3Dt"],"\x14"=>[0,"\x3D\x20"],"\x15"=>[0,"\x3D\x25"],"\x16"=>[0,"\x3D-"],"\x17"=>[0,"\x3D."],"\x18"=>[0,"\x3D\x2F"],"\x19"=>[0,"\x3D3"],"\x1A"=>[0,"\x3D4"],"\x1B"=>[0,"\x3D5"],"\x1C"=>[0,"\x3D6"],"\x1D"=>[0,"\x3D7"],"\x1E"=>[0,"\x3D8"],"\x1F"=>[0,"\x3D9"],"\x20"=>[0,"\x3D\x3D"],"\x21"=>[0,"\x3DA"],"\x22"=>[0,"\x3D_"],"\x23"=>[0,"\x3Db"],"\x24"=>[0,"\x3Dd"],"\x25"=>[0,"\x3Df"],"\x26"=>[0,"\x3Dg"],"\x27"=>[0,"\x3Dh"],"\x28"=>[0,"\x3Dl"],"\x29"=>[0,"\x3Dm"],"\x2A"=>[0,"\x3Dn"],"\x2B"=>[0,"\x3Dp"],"\x2C"=>[0,"\x3Dr"],"-"=>[0,"\x3Du"],"."=>[100,"\x3D"],"\x2F"=>[110,"\x3D"],[111,"\x3D"],[115,"\x3D"],[116,"\x3D"],[118,"\x3D"],[119,"\x3D"],[122,"\x3D"],[123,"\x3D"],[125,"\x3D"],[126,"\x3D"],[129,"\x3D"],"\x3A"=>[143,"\x3D"],"\x3B"=>[148,"\x3D"],"\x3C"=>[151,"\x3D"],"\x3D"=>[153,"\x3D"],"\x3E"=>[83,"\x3D"],"\x3F"=>[10,"\x3D"],"\x40"=>[77,"A0"],"A"=>[18,"A0"],"B"=>[77,"A1"],"C"=>[18,"A1"],"D"=>[77,"A2"],"E"=>[18,"A2"],"F"=>[77,"Aa"],"G"=>[18,"Aa"],"H"=>[77,"Ac"],"I"=>[18,"Ac"],"J"=>[77,"Ae"],"K"=>[18,"Ae"],"L"=>[77,"Ai"],"M"=>[18,"Ai"],"N"=>[77,"Ao"],"O"=>[18,"Ao"],"P"=>[77,"As"],"Q"=>[18,"As"],"R"=>[77,"At"],"S"=>[18,"At"],"T"=>[0,"A\x20"],"U"=>[0,"A\x25"],"V"=>[0,"A-"],"W"=>[0,"A."],"X"=>[0,"A\x2F"],"Y"=>[0,"A3"],"Z"=>[0,"A4"],"\x5B"=>[0,"A5"],"\x5C"=>[0,"A6"],"\x5D"=>[0,"A7"],"\x5E"=>[0,"A8"],"_"=>[0,"A9"],"\x60"=>[0,"A\x3D"],"a"=>[0,"AA"],"b"=>[0,"A_"],"c"=>[0,"Ab"],"d"=>[0,"Ad"],"e"=>[0,"Af"],"f"=>[0,"Ag"],"g"=>[0,"Ah"],"h"=>[0,"Al"],"i"=>[0,"Am"],"j"=>[0,"An"],"k"=>[0,"Ap"],"l"=>[0,"Ar"],"m"=>[0,"Au"],"n"=>[100,"A"],"o"=>[110,"A"],"p"=>[111,"A"],"q"=>[115,"A"],"r"=>[116,"A"],"s"=>[118,"A"],"t"=>[119,"A"],"u"=>[122,"A"],"v"=>[123,"A"],"w"=>[125,"A"],"x"=>[126,"A"],"y"=>[129,"A"],"z"=>[143,"A"],"\x7B"=>[148,"A"],"\x7C"=>[151,"A"],"\x7D"=>[153,"A"],"~"=>[83,"A"],"\x7F"=>[10,"A"],"\x80"=>[77,"_0"],"\x81"=>[18,"_0"],"\x82"=>[77,"_1"],"\x83"=>[18,"_1"],"\x84"=>[77,"_2"],"\x85"=>[18,"_2"],"\x86"=>[77,"_a"],"\x87"=>[18,"_a"],"\x88"=>[77,"_c"],"\x89"=>[18,"_c"],"\x8A"=>[77,"_e"],"\x8B"=>[18,"_e"],"\x8C"=>[77,"_i"],"\x8D"=>[18,"_i"],"\x8E"=>[77,"_o"],"\x8F"=>[18,"_o"],"\x90"=>[77,"_s"],"\x91"=>[18,"_s"],"\x92"=>[77,"_t"],"\x93"=>[18,"_t"],"\x94"=>[0,"_\x20"],"\x95"=>[0,"_\x25"],"\x96"=>[0,"_-"],"\x97"=>[0,"_."],"\x98"=>[0,"_\x2F"],"\x99"=>[0,"_3"],"\x9A"=>[0,"_4"],"\x9B"=>[0,"_5"],"\x9C"=>[0,"_6"],"\x9D"=>[0,"_7"],"\x9E"=>[0,"_8"],"\x9F"=>[0,"_9"],"\xA0"=>[0,"_\x3D"],"\xA1"=>[0,"_A"],"\xA2"=>[0,"__"],"\xA3"=>[0,"_b"],"\xA4"=>[0,"_d"],"\xA5"=>[0,"_f"],"\xA6"=>[0,"_g"],"\xA7"=>[0,"_h"],"\xA8"=>[0,"_l"],"\xA9"=>[0,"_m"],"\xAA"=>[0,"_n"],"\xAB"=>[0,"_p"],"\xAC"=>[0,"_r"],"\xAD"=>[0,"_u"],"\xAE"=>[100,"_"],"\xAF"=>[110,"_"],"\xB0"=>[111,"_"],"\xB1"=>[115,"_"],"\xB2"=>[116,"_"],"\xB3"=>[118,"_"],"\xB4"=>[119,"_"],"\xB5"=>[122,"_"],"\xB6"=>[123,"_"],"\xB7"=>[125,"_"],"\xB8"=>[126,"_"],"\xB9"=>[129,"_"],"\xBA"=>[143,"_"],"\xBB"=>[148,"_"],"\xBC"=>[151,"_"],"\xBD"=>[153,"_"],"\xBE"=>[83,"_"],"\xBF"=>[10,"_"],"\xC0"=>[77,"b0"],"\xC1"=>[18,"b0"],"\xC2"=>[77,"b1"],"\xC3"=>[18,"b1"],"\xC4"=>[77,"b2"],"\xC5"=>[18,"b2"],"\xC6"=>[77,"ba"],"\xC7"=>[18,"ba"],"\xC8"=>[77,"bc"],"\xC9"=>[18,"bc"],"\xCA"=>[77,"be"],"\xCB"=>[18,"be"],"\xCC"=>[77,"bi"],"\xCD"=>[18,"bi"],"\xCE"=>[77,"bo"],"\xCF"=>[18,"bo"],"\xD0"=>[77,"bs"],"\xD1"=>[18,"bs"],"\xD2"=>[77,"bt"],"\xD3"=>[18,"bt"],"\xD4"=>[0,"b\x20"],"\xD5"=>[0,"b\x25"],"\xD6"=>[0,"b-"],"\xD7"=>[0,"b."],"\xD8"=>[0,"b\x2F"],"\xD9"=>[0,"b3"],"\xDA"=>[0,"b4"],"\xDB"=>[0,"b5"],"\xDC"=>[0,"b6"],"\xDD"=>[0,"b7"],"\xDE"=>[0,"b8"],"\xDF"=>[0,"b9"],"\xE0"=>[0,"b\x3D"],"\xE1"=>[0,"bA"],"\xE2"=>[0,"b_"],"\xE3"=>[0,"bb"],"\xE4"=>[0,"bd"],"\xE5"=>[0,"bf"],"\xE6"=>[0,"bg"],"\xE7"=>[0,"bh"],"\xE8"=>[0,"bl"],"\xE9"=>[0,"bm"],"\xEA"=>[0,"bn"],"\xEB"=>[0,"bp"],"\xEC"=>[0,"br"],"\xED"=>[0,"bu"],"\xEE"=>[100,"b"],"\xEF"=>[110,"b"],"\xF0"=>[111,"b"],"\xF1"=>[115,"b"],"\xF2"=>[116,"b"],"\xF3"=>[118,"b"],"\xF4"=>[119,"b"],"\xF5"=>[122,"b"],"\xF6"=>[123,"b"],"\xF7"=>[125,"b"],"\xF8"=>[126,"b"],"\xF9"=>[129,"b"],"\xFA"=>[143,"b"],"\xFB"=>[148,"b"],"\xFC"=>[151,"b"],"\xFD"=>[153,"b"],"\xFE"=>[83,"b"],"\xFF"=>[10,"b"],],["\x00"=>[0,"\x3D0"],"\x01"=>[0,"\x3D1"],"\x02"=>[0,"\x3D2"],"\x03"=>[0,"\x3Da"],"\x04"=>[0,"\x3Dc"],"\x05"=>[0,"\x3De"],"\x06"=>[0,"\x3Di"],"\x07"=>[0,"\x3Do"],"\x08"=>[0,"\x3Ds"],"\x09"=>[0,"\x3Dt"],"\x0A"=>[73,"\x3D"],"\x0B"=>[88,"\x3D"],"\x0C"=>[89,"\x3D"],"\x0D"=>[96,"\x3D"],"\x0E"=>[97,"\x3D"],"\x0F"=>[99,"\x3D"],"\x10"=>[106,"\x3D"],"\x11"=>[136,"\x3D"],"\x12"=>[139,"\x3D"],"\x13"=>[141,"\x3D"],"\x14"=>[145,"\x3D"],"\x15"=>[147,"\x3D"],"\x16"=>[149,"\x3D"],"\x17"=>[101,"\x3D"],"\x18"=>[112,"\x3D"],"\x19"=>[117,"\x3D"],"\x1A"=>[120,"\x3D"],"\x1B"=>[124,"\x3D"],"\x1C"=>[127,"\x3D"],"\x1D"=>[144,"\x3D"],"\x1E"=>[152,"\x3D"],"\x1F"=>[11,"\x3D"],"\x20"=>[0,"A0"],"\x21"=>[0,"A1"],"\x22"=>[0,"A2"],"\x23"=>[0,"Aa"],"\x24"=>[0,"Ac"],"\x25"=>[0,"Ae"],"\x26"=>[0,"Ai"],"\x27"=>[0,"Ao"],"\x28"=>[0,"As"],"\x29"=>[0,"At"],"\x2A"=>[73,"A"],"\x2B"=>[88,"A"],"\x2C"=>[89,"A"],"-"=>[96,"A"],"."=>[97,"A"],"\x2F"=>[99,"A"],[106,"A"],[136,"A"],[139,"A"],[141,"A"],[145,"A"],[147,"A"],[149,"A"],[101,"A"],[112,"A"],[117,"A"],"\x3A"=>[120,"A"],"\x3B"=>[124,"A"],"\x3C"=>[127,"A"],"\x3D"=>[144,"A"],"\x3E"=>[152,"A"],"\x3F"=>[11,"A"],"\x40"=>[0,"_0"],"A"=>[0,"_1"],"B"=>[0,"_2"],"C"=>[0,"_a"],"D"=>[0,"_c"],"E"=>[0,"_e"],"F"=>[0,"_i"],"G"=>[0,"_o"],"H"=>[0,"_s"],"I"=>[0,"_t"],"J"=>[73,"_"],"K"=>[88,"_"],"L"=>[89,"_"],"M"=>[96,"_"],"N"=>[97,"_"],"O"=>[99,"_"],"P"=>[106,"_"],"Q"=>[136,"_"],"R"=>[139,"_"],"S"=>[141,"_"],"T"=>[145,"_"],"U"=>[147,"_"],"V"=>[149,"_"],"W"=>[101,"_"],"X"=>[112,"_"],"Y"=>[117,"_"],"Z"=>[120,"_"],"\x5B"=>[124,"_"],"\x5C"=>[127,"_"],"\x5D"=>[144,"_"],"\x5E"=>[152,"_"],"_"=>[11,"_"],"\x60"=>[0,"b0"],"a"=>[0,"b1"],"b"=>[0,"b2"],"c"=>[0,"ba"],"d"=>[0,"bc"],"e"=>[0,"be"],"f"=>[0,"bi"],"g"=>[0,"bo"],"h"=>[0,"bs"],"i"=>[0,"bt"],"j"=>[73,"b"],"k"=>[88,"b"],"l"=>[89,"b"],"m"=>[96,"b"],"n"=>[97,"b"],"o"=>[99,"b"],"p"=>[106,"b"],"q"=>[136,"b"],"r"=>[139,"b"],"s"=>[141,"b"],"t"=>[145,"b"],"u"=>[147,"b"],"v"=>[149,"b"],"w"=>[101,"b"],"x"=>[112,"b"],"y"=>[117,"b"],"z"=>[120,"b"],"\x7B"=>[124,"b"],"\x7C"=>[127,"b"],"\x7D"=>[144,"b"],"~"=>[152,"b"],"\x7F"=>[11,"b"],"\x80"=>[0,"d0"],"\x81"=>[0,"d1"],"\x82"=>[0,"d2"],"\x83"=>[0,"da"],"\x84"=>[0,"dc"],"\x85"=>[0,"de"],"\x86"=>[0,"di"],"\x87"=>[0,"do"],"\x88"=>[0,"ds"],"\x89"=>[0,"dt"],"\x8A"=>[73,"d"],"\x8B"=>[88,"d"],"\x8C"=>[89,"d"],"\x8D"=>[96,"d"],"\x8E"=>[97,"d"],"\x8F"=>[99,"d"],"\x90"=>[106,"d"],"\x91"=>[136,"d"],"\x92"=>[139,"d"],"\x93"=>[141,"d"],"\x94"=>[145,"d"],"\x95"=>[147,"d"],"\x96"=>[149,"d"],"\x97"=>[101,"d"],"\x98"=>[112,"d"],"\x99"=>[117,"d"],"\x9A"=>[120,"d"],"\x9B"=>[124,"d"],"\x9C"=>[127,"d"],"\x9D"=>[144,"d"],"\x9E"=>[152,"d"],"\x9F"=>[11,"d"],"\xA0"=>[0,"f0"],"\xA1"=>[0,"f1"],"\xA2"=>[0,"f2"],"\xA3"=>[0,"fa"],"\xA4"=>[0,"fc"],"\xA5"=>[0,"fe"],"\xA6"=>[0,"fi"],"\xA7"=>[0,"fo"],"\xA8"=>[0,"fs"],"\xA9"=>[0,"ft"],"\xAA"=>[73,"f"],"\xAB"=>[88,"f"],"\xAC"=>[89,"f"],"\xAD"=>[96,"f"],"\xAE"=>[97,"f"],"\xAF"=>[99,"f"],"\xB0"=>[106,"f"],"\xB1"=>[136,"f"],"\xB2"=>[139,"f"],"\xB3"=>[141,"f"],"\xB4"=>[145,"f"],"\xB5"=>[147,"f"],"\xB6"=>[149,"f"],"\xB7"=>[101,"f"],"\xB8"=>[112,"f"],"\xB9"=>[117,"f"],"\xBA"=>[120,"f"],"\xBB"=>[124,"f"],"\xBC"=>[127,"f"],"\xBD"=>[144,"f"],"\xBE"=>[152,"f"],"\xBF"=>[11,"f"],"\xC0"=>[0,"g0"],"\xC1"=>[0,"g1"],"\xC2"=>[0,"g2"],"\xC3"=>[0,"ga"],"\xC4"=>[0,"gc"],"\xC5"=>[0,"ge"],"\xC6"=>[0,"gi"],"\xC7"=>[0,"go"],"\xC8"=>[0,"gs"],"\xC9"=>[0,"gt"],"\xCA"=>[73,"g"],"\xCB"=>[88,"g"],"\xCC"=>[89,"g"],"\xCD"=>[96,"g"],"\xCE"=>[97,"g"],"\xCF"=>[99,"g"],"\xD0"=>[106,"g"],"\xD1"=>[136,"g"],"\xD2"=>[139,"g"],"\xD3"=>[141,"g"],"\xD4"=>[145,"g"],"\xD5"=>[147,"g"],"\xD6"=>[149,"g"],"\xD7"=>[101,"g"],"\xD8"=>[112,"g"],"\xD9"=>[117,"g"],"\xDA"=>[120,"g"],"\xDB"=>[124,"g"],"\xDC"=>[127,"g"],"\xDD"=>[144,"g"],"\xDE"=>[152,"g"],"\xDF"=>[11,"g"],"\xE0"=>[0,"h0"],"\xE1"=>[0,"h1"],"\xE2"=>[0,"h2"],"\xE3"=>[0,"ha"],"\xE4"=>[0,"hc"],"\xE5"=>[0,"he"],"\xE6"=>[0,"hi"],"\xE7"=>[0,"ho"],"\xE8"=>[0,"hs"],"\xE9"=>[0,"ht"],"\xEA"=>[73,"h"],"\xEB"=>[88,"h"],"\xEC"=>[89,"h"],"\xED"=>[96,"h"],"\xEE"=>[97,"h"],"\xEF"=>[99,"h"],"\xF0"=>[106,"h"],"\xF1"=>[136,"h"],"\xF2"=>[139,"h"],"\xF3"=>[141,"h"],"\xF4"=>[145,"h"],"\xF5"=>[147,"h"],"\xF6"=>[149,"h"],"\xF7"=>[101,"h"],"\xF8"=>[112,"h"],"\xF9"=>[117,"h"],"\xFA"=>[120,"h"],"\xFB"=>[124,"h"],"\xFC"=>[127,"h"],"\xFD"=>[144,"h"],"\xFE"=>[152,"h"],"\xFF"=>[11,"h"],],["\x00"=>[94,"\x400"],"\x01"=>[76,"\x400"],"\x02"=>[104,"\x400"],"\x03"=>[16,"\x400"],"\x04"=>[94,"\x401"],"\x05"=>[76,"\x401"],"\x06"=>[104,"\x401"],"\x07"=>[16,"\x401"],"\x08"=>[94,"\x402"],"\x09"=>[76,"\x402"],"\x0A"=>[104,"\x402"],"\x0B"=>[16,"\x402"],"\x0C"=>[94,"\x40a"],"\x0D"=>[76,"\x40a"],"\x0E"=>[104,"\x40a"],"\x0F"=>[16,"\x40a"],"\x10"=>[94,"\x40c"],"\x11"=>[76,"\x40c"],"\x12"=>[104,"\x40c"],"\x13"=>[16,"\x40c"],"\x14"=>[94,"\x40e"],"\x15"=>[76,"\x40e"],"\x16"=>[104,"\x40e"],"\x17"=>[16,"\x40e"],"\x18"=>[94,"\x40i"],"\x19"=>[76,"\x40i"],"\x1A"=>[104,"\x40i"],"\x1B"=>[16,"\x40i"],"\x1C"=>[94,"\x40o"],"\x1D"=>[76,"\x40o"],"\x1E"=>[104,"\x40o"],"\x1F"=>[16,"\x40o"],"\x20"=>[94,"\x40s"],"\x21"=>[76,"\x40s"],"\x22"=>[104,"\x40s"],"\x23"=>[16,"\x40s"],"\x24"=>[94,"\x40t"],"\x25"=>[76,"\x40t"],"\x26"=>[104,"\x40t"],"\x27"=>[16,"\x40t"],"\x28"=>[77,"\x40\x20"],"\x29"=>[18,"\x40\x20"],"\x2A"=>[77,"\x40\x25"],"\x2B"=>[18,"\x40\x25"],"\x2C"=>[77,"\x40-"],"-"=>[18,"\x40-"],"."=>[77,"\x40."],"\x2F"=>[18,"\x40."],[77,"\x40\x2F"],[18,"\x40\x2F"],[77,"\x403"],[18,"\x403"],[77,"\x404"],[18,"\x404"],[77,"\x405"],[18,"\x405"],[77,"\x406"],[18,"\x406"],"\x3A"=>[77,"\x407"],"\x3B"=>[18,"\x407"],"\x3C"=>[77,"\x408"],"\x3D"=>[18,"\x408"],"\x3E"=>[77,"\x409"],"\x3F"=>[18,"\x409"],"\x40"=>[77,"\x40\x3D"],"A"=>[18,"\x40\x3D"],"B"=>[77,"\x40A"],"C"=>[18,"\x40A"],"D"=>[77,"\x40_"],"E"=>[18,"\x40_"],"F"=>[77,"\x40b"],"G"=>[18,"\x40b"],"H"=>[77,"\x40d"],"I"=>[18,"\x40d"],"J"=>[77,"\x40f"],"K"=>[18,"\x40f"],"L"=>[77,"\x40g"],"M"=>[18,"\x40g"],"N"=>[77,"\x40h"],"O"=>[18,"\x40h"],"P"=>[77,"\x40l"],"Q"=>[18,"\x40l"],"R"=>[77,"\x40m"],"S"=>[18,"\x40m"],"T"=>[77,"\x40n"],"U"=>[18,"\x40n"],"V"=>[77,"\x40p"],"W"=>[18,"\x40p"],"X"=>[77,"\x40r"],"Y"=>[18,"\x40r"],"Z"=>[77,"\x40u"],"\x5B"=>[18,"\x40u"],"\x5C"=>[0,"\x40\x3A"],"\x5D"=>[0,"\x40B"],"\x5E"=>[0,"\x40C"],"_"=>[0,"\x40D"],"\x60"=>[0,"\x40E"],"a"=>[0,"\x40F"],"b"=>[0,"\x40G"],"c"=>[0,"\x40H"],"d"=>[0,"\x40I"],"e"=>[0,"\x40J"],"f"=>[0,"\x40K"],"g"=>[0,"\x40L"],"h"=>[0,"\x40M"],"i"=>[0,"\x40N"],"j"=>[0,"\x40O"],"k"=>[0,"\x40P"],"l"=>[0,"\x40Q"],"m"=>[0,"\x40R"],"n"=>[0,"\x40S"],"o"=>[0,"\x40T"],"p"=>[0,"\x40U"],"q"=>[0,"\x40V"],"r"=>[0,"\x40W"],"s"=>[0,"\x40Y"],"t"=>[0,"\x40j"],"u"=>[0,"\x40k"],"v"=>[0,"\x40q"],"w"=>[0,"\x40v"],"x"=>[0,"\x40w"],"y"=>[0,"\x40x"],"z"=>[0,"\x40y"],"\x7B"=>[0,"\x40z"],"\x7C"=>[82,"\x40"],"\x7D"=>[87,"\x40"],"~"=>[130,"\x40"],"\x7F"=>[9,"\x40"],"\x80"=>[94,"\x5B0"],"\x81"=>[76,"\x5B0"],"\x82"=>[104,"\x5B0"],"\x83"=>[16,"\x5B0"],"\x84"=>[94,"\x5B1"],"\x85"=>[76,"\x5B1"],"\x86"=>[104,"\x5B1"],"\x87"=>[16,"\x5B1"],"\x88"=>[94,"\x5B2"],"\x89"=>[76,"\x5B2"],"\x8A"=>[104,"\x5B2"],"\x8B"=>[16,"\x5B2"],"\x8C"=>[94,"\x5Ba"],"\x8D"=>[76,"\x5Ba"],"\x8E"=>[104,"\x5Ba"],"\x8F"=>[16,"\x5Ba"],"\x90"=>[94,"\x5Bc"],"\x91"=>[76,"\x5Bc"],"\x92"=>[104,"\x5Bc"],"\x93"=>[16,"\x5Bc"],"\x94"=>[94,"\x5Be"],"\x95"=>[76,"\x5Be"],"\x96"=>[104,"\x5Be"],"\x97"=>[16,"\x5Be"],"\x98"=>[94,"\x5Bi"],"\x99"=>[76,"\x5Bi"],"\x9A"=>[104,"\x5Bi"],"\x9B"=>[16,"\x5Bi"],"\x9C"=>[94,"\x5Bo"],"\x9D"=>[76,"\x5Bo"],"\x9E"=>[104,"\x5Bo"],"\x9F"=>[16,"\x5Bo"],"\xA0"=>[94,"\x5Bs"],"\xA1"=>[76,"\x5Bs"],"\xA2"=>[104,"\x5Bs"],"\xA3"=>[16,"\x5Bs"],"\xA4"=>[94,"\x5Bt"],"\xA5"=>[76,"\x5Bt"],"\xA6"=>[104,"\x5Bt"],"\xA7"=>[16,"\x5Bt"],"\xA8"=>[77,"\x5B\x20"],"\xA9"=>[18,"\x5B\x20"],"\xAA"=>[77,"\x5B\x25"],"\xAB"=>[18,"\x5B\x25"],"\xAC"=>[77,"\x5B-"],"\xAD"=>[18,"\x5B-"],"\xAE"=>[77,"\x5B."],"\xAF"=>[18,"\x5B."],"\xB0"=>[77,"\x5B\x2F"],"\xB1"=>[18,"\x5B\x2F"],"\xB2"=>[77,"\x5B3"],"\xB3"=>[18,"\x5B3"],"\xB4"=>[77,"\x5B4"],"\xB5"=>[18,"\x5B4"],"\xB6"=>[77,"\x5B5"],"\xB7"=>[18,"\x5B5"],"\xB8"=>[77,"\x5B6"],"\xB9"=>[18,"\x5B6"],"\xBA"=>[77,"\x5B7"],"\xBB"=>[18,"\x5B7"],"\xBC"=>[77,"\x5B8"],"\xBD"=>[18,"\x5B8"],"\xBE"=>[77,"\x5B9"],"\xBF"=>[18,"\x5B9"],"\xC0"=>[77,"\x5B\x3D"],"\xC1"=>[18,"\x5B\x3D"],"\xC2"=>[77,"\x5BA"],"\xC3"=>[18,"\x5BA"],"\xC4"=>[77,"\x5B_"],"\xC5"=>[18,"\x5B_"],"\xC6"=>[77,"\x5Bb"],"\xC7"=>[18,"\x5Bb"],"\xC8"=>[77,"\x5Bd"],"\xC9"=>[18,"\x5Bd"],"\xCA"=>[77,"\x5Bf"],"\xCB"=>[18,"\x5Bf"],"\xCC"=>[77,"\x5Bg"],"\xCD"=>[18,"\x5Bg"],"\xCE"=>[77,"\x5Bh"],"\xCF"=>[18,"\x5Bh"],"\xD0"=>[77,"\x5Bl"],"\xD1"=>[18,"\x5Bl"],"\xD2"=>[77,"\x5Bm"],"\xD3"=>[18,"\x5Bm"],"\xD4"=>[77,"\x5Bn"],"\xD5"=>[18,"\x5Bn"],"\xD6"=>[77,"\x5Bp"],"\xD7"=>[18,"\x5Bp"],"\xD8"=>[77,"\x5Br"],"\xD9"=>[18,"\x5Br"],"\xDA"=>[77,"\x5Bu"],"\xDB"=>[18,"\x5Bu"],"\xDC"=>[0,"\x5B\x3A"],"\xDD"=>[0,"\x5BB"],"\xDE"=>[0,"\x5BC"],"\xDF"=>[0,"\x5BD"],"\xE0"=>[0,"\x5BE"],"\xE1"=>[0,"\x5BF"],"\xE2"=>[0,"\x5BG"],"\xE3"=>[0,"\x5BH"],"\xE4"=>[0,"\x5BI"],"\xE5"=>[0,"\x5BJ"],"\xE6"=>[0,"\x5BK"],"\xE7"=>[0,"\x5BL"],"\xE8"=>[0,"\x5BM"],"\xE9"=>[0,"\x5BN"],"\xEA"=>[0,"\x5BO"],"\xEB"=>[0,"\x5BP"],"\xEC"=>[0,"\x5BQ"],"\xED"=>[0,"\x5BR"],"\xEE"=>[0,"\x5BS"],"\xEF"=>[0,"\x5BT"],"\xF0"=>[0,"\x5BU"],"\xF1"=>[0,"\x5BV"],"\xF2"=>[0,"\x5BW"],"\xF3"=>[0,"\x5BY"],"\xF4"=>[0,"\x5Bj"],"\xF5"=>[0,"\x5Bk"],"\xF6"=>[0,"\x5Bq"],"\xF7"=>[0,"\x5Bv"],"\xF8"=>[0,"\x5Bw"],"\xF9"=>[0,"\x5Bx"],"\xFA"=>[0,"\x5By"],"\xFB"=>[0,"\x5Bz"],"\xFC"=>[82,"\x5B"],"\xFD"=>[87,"\x5B"],"\xFE"=>[130,"\x5B"],"\xFF"=>[9,"\x5B"],],["\x00"=>[94,"C0"],"\x01"=>[76,"C0"],"\x02"=>[104,"C0"],"\x03"=>[16,"C0"],"\x04"=>[94,"C1"],"\x05"=>[76,"C1"],"\x06"=>[104,"C1"],"\x07"=>[16,"C1"],"\x08"=>[94,"C2"],"\x09"=>[76,"C2"],"\x0A"=>[104,"C2"],"\x0B"=>[16,"C2"],"\x0C"=>[94,"Ca"],"\x0D"=>[76,"Ca"],"\x0E"=>[104,"Ca"],"\x0F"=>[16,"Ca"],"\x10"=>[94,"Cc"],"\x11"=>[76,"Cc"],"\x12"=>[104,"Cc"],"\x13"=>[16,"Cc"],"\x14"=>[94,"Ce"],"\x15"=>[76,"Ce"],"\x16"=>[104,"Ce"],"\x17"=>[16,"Ce"],"\x18"=>[94,"Ci"],"\x19"=>[76,"Ci"],"\x1A"=>[104,"Ci"],"\x1B"=>[16,"Ci"],"\x1C"=>[94,"Co"],"\x1D"=>[76,"Co"],"\x1E"=>[104,"Co"],"\x1F"=>[16,"Co"],"\x20"=>[94,"Cs"],"\x21"=>[76,"Cs"],"\x22"=>[104,"Cs"],"\x23"=>[16,"Cs"],"\x24"=>[94,"Ct"],"\x25"=>[76,"Ct"],"\x26"=>[104,"Ct"],"\x27"=>[16,"Ct"],"\x28"=>[77,"C\x20"],"\x29"=>[18,"C\x20"],"\x2A"=>[77,"C\x25"],"\x2B"=>[18,"C\x25"],"\x2C"=>[77,"C-"],"-"=>[18,"C-"],"."=>[77,"C."],"\x2F"=>[18,"C."],[77,"C\x2F"],[18,"C\x2F"],[77,"C3"],[18,"C3"],[77,"C4"],[18,"C4"],[77,"C5"],[18,"C5"],[77,"C6"],[18,"C6"],"\x3A"=>[77,"C7"],"\x3B"=>[18,"C7"],"\x3C"=>[77,"C8"],"\x3D"=>[18,"C8"],"\x3E"=>[77,"C9"],"\x3F"=>[18,"C9"],"\x40"=>[77,"C\x3D"],"A"=>[18,"C\x3D"],"B"=>[77,"CA"],"C"=>[18,"CA"],"D"=>[77,"C_"],"E"=>[18,"C_"],"F"=>[77,"Cb"],"G"=>[18,"Cb"],"H"=>[77,"Cd"],"I"=>[18,"Cd"],"J"=>[77,"Cf"],"K"=>[18,"Cf"],"L"=>[77,"Cg"],"M"=>[18,"Cg"],"N"=>[77,"Ch"],"O"=>[18,"Ch"],"P"=>[77,"Cl"],"Q"=>[18,"Cl"],"R"=>[77,"Cm"],"S"=>[18,"Cm"],"T"=>[77,"Cn"],"U"=>[18,"Cn"],"V"=>[77,"Cp"],"W"=>[18,"Cp"],"X"=>[77,"Cr"],"Y"=>[18,"Cr"],"Z"=>[77,"Cu"],"\x5B"=>[18,"Cu"],"\x5C"=>[0,"C\x3A"],"\x5D"=>[0,"CB"],"\x5E"=>[0,"CC"],"_"=>[0,"CD"],"\x60"=>[0,"CE"],"a"=>[0,"CF"],"b"=>[0,"CG"],"c"=>[0,"CH"],"d"=>[0,"CI"],"e"=>[0,"CJ"],"f"=>[0,"CK"],"g"=>[0,"CL"],"h"=>[0,"CM"],"i"=>[0,"CN"],"j"=>[0,"CO"],"k"=>[0,"CP"],"l"=>[0,"CQ"],"m"=>[0,"CR"],"n"=>[0,"CS"],"o"=>[0,"CT"],"p"=>[0,"CU"],"q"=>[0,"CV"],"r"=>[0,"CW"],"s"=>[0,"CY"],"t"=>[0,"Cj"],"u"=>[0,"Ck"],"v"=>[0,"Cq"],"w"=>[0,"Cv"],"x"=>[0,"Cw"],"y"=>[0,"Cx"],"z"=>[0,"Cy"],"\x7B"=>[0,"Cz"],"\x7C"=>[82,"C"],"\x7D"=>[87,"C"],"~"=>[130,"C"],"\x7F"=>[9,"C"],"\x80"=>[94,"D0"],"\x81"=>[76,"D0"],"\x82"=>[104,"D0"],"\x83"=>[16,"D0"],"\x84"=>[94,"D1"],"\x85"=>[76,"D1"],"\x86"=>[104,"D1"],"\x87"=>[16,"D1"],"\x88"=>[94,"D2"],"\x89"=>[76,"D2"],"\x8A"=>[104,"D2"],"\x8B"=>[16,"D2"],"\x8C"=>[94,"Da"],"\x8D"=>[76,"Da"],"\x8E"=>[104,"Da"],"\x8F"=>[16,"Da"],"\x90"=>[94,"Dc"],"\x91"=>[76,"Dc"],"\x92"=>[104,"Dc"],"\x93"=>[16,"Dc"],"\x94"=>[94,"De"],"\x95"=>[76,"De"],"\x96"=>[104,"De"],"\x97"=>[16,"De"],"\x98"=>[94,"Di"],"\x99"=>[76,"Di"],"\x9A"=>[104,"Di"],"\x9B"=>[16,"Di"],"\x9C"=>[94,"Do"],"\x9D"=>[76,"Do"],"\x9E"=>[104,"Do"],"\x9F"=>[16,"Do"],"\xA0"=>[94,"Ds"],"\xA1"=>[76,"Ds"],"\xA2"=>[104,"Ds"],"\xA3"=>[16,"Ds"],"\xA4"=>[94,"Dt"],"\xA5"=>[76,"Dt"],"\xA6"=>[104,"Dt"],"\xA7"=>[16,"Dt"],"\xA8"=>[77,"D\x20"],"\xA9"=>[18,"D\x20"],"\xAA"=>[77,"D\x25"],"\xAB"=>[18,"D\x25"],"\xAC"=>[77,"D-"],"\xAD"=>[18,"D-"],"\xAE"=>[77,"D."],"\xAF"=>[18,"D."],"\xB0"=>[77,"D\x2F"],"\xB1"=>[18,"D\x2F"],"\xB2"=>[77,"D3"],"\xB3"=>[18,"D3"],"\xB4"=>[77,"D4"],"\xB5"=>[18,"D4"],"\xB6"=>[77,"D5"],"\xB7"=>[18,"D5"],"\xB8"=>[77,"D6"],"\xB9"=>[18,"D6"],"\xBA"=>[77,"D7"],"\xBB"=>[18,"D7"],"\xBC"=>[77,"D8"],"\xBD"=>[18,"D8"],"\xBE"=>[77,"D9"],"\xBF"=>[18,"D9"],"\xC0"=>[77,"D\x3D"],"\xC1"=>[18,"D\x3D"],"\xC2"=>[77,"DA"],"\xC3"=>[18,"DA"],"\xC4"=>[77,"D_"],"\xC5"=>[18,"D_"],"\xC6"=>[77,"Db"],"\xC7"=>[18,"Db"],"\xC8"=>[77,"Dd"],"\xC9"=>[18,"Dd"],"\xCA"=>[77,"Df"],"\xCB"=>[18,"Df"],"\xCC"=>[77,"Dg"],"\xCD"=>[18,"Dg"],"\xCE"=>[77,"Dh"],"\xCF"=>[18,"Dh"],"\xD0"=>[77,"Dl"],"\xD1"=>[18,"Dl"],"\xD2"=>[77,"Dm"],"\xD3"=>[18,"Dm"],"\xD4"=>[77,"Dn"],"\xD5"=>[18,"Dn"],"\xD6"=>[77,"Dp"],"\xD7"=>[18,"Dp"],"\xD8"=>[77,"Dr"],"\xD9"=>[18,"Dr"],"\xDA"=>[77,"Du"],"\xDB"=>[18,"Du"],"\xDC"=>[0,"D\x3A"],"\xDD"=>[0,"DB"],"\xDE"=>[0,"DC"],"\xDF"=>[0,"DD"],"\xE0"=>[0,"DE"],"\xE1"=>[0,"DF"],"\xE2"=>[0,"DG"],"\xE3"=>[0,"DH"],"\xE4"=>[0,"DI"],"\xE5"=>[0,"DJ"],"\xE6"=>[0,"DK"],"\xE7"=>[0,"DL"],"\xE8"=>[0,"DM"],"\xE9"=>[0,"DN"],"\xEA"=>[0,"DO"],"\xEB"=>[0,"DP"],"\xEC"=>[0,"DQ"],"\xED"=>[0,"DR"],"\xEE"=>[0,"DS"],"\xEF"=>[0,"DT"],"\xF0"=>[0,"DU"],"\xF1"=>[0,"DV"],"\xF2"=>[0,"DW"],"\xF3"=>[0,"DY"],"\xF4"=>[0,"Dj"],"\xF5"=>[0,"Dk"],"\xF6"=>[0,"Dq"],"\xF7"=>[0,"Dv"],"\xF8"=>[0,"Dw"],"\xF9"=>[0,"Dx"],"\xFA"=>[0,"Dy"],"\xFB"=>[0,"Dz"],"\xFC"=>[82,"D"],"\xFD"=>[87,"D"],"\xFE"=>[130,"D"],"\xFF"=>[9,"D"],],["\x00"=>[94,"E0"],"\x01"=>[76,"E0"],"\x02"=>[104,"E0"],"\x03"=>[16,"E0"],"\x04"=>[94,"E1"],"\x05"=>[76,"E1"],"\x06"=>[104,"E1"],"\x07"=>[16,"E1"],"\x08"=>[94,"E2"],"\x09"=>[76,"E2"],"\x0A"=>[104,"E2"],"\x0B"=>[16,"E2"],"\x0C"=>[94,"Ea"],"\x0D"=>[76,"Ea"],"\x0E"=>[104,"Ea"],"\x0F"=>[16,"Ea"],"\x10"=>[94,"Ec"],"\x11"=>[76,"Ec"],"\x12"=>[104,"Ec"],"\x13"=>[16,"Ec"],"\x14"=>[94,"Ee"],"\x15"=>[76,"Ee"],"\x16"=>[104,"Ee"],"\x17"=>[16,"Ee"],"\x18"=>[94,"Ei"],"\x19"=>[76,"Ei"],"\x1A"=>[104,"Ei"],"\x1B"=>[16,"Ei"],"\x1C"=>[94,"Eo"],"\x1D"=>[76,"Eo"],"\x1E"=>[104,"Eo"],"\x1F"=>[16,"Eo"],"\x20"=>[94,"Es"],"\x21"=>[76,"Es"],"\x22"=>[104,"Es"],"\x23"=>[16,"Es"],"\x24"=>[94,"Et"],"\x25"=>[76,"Et"],"\x26"=>[104,"Et"],"\x27"=>[16,"Et"],"\x28"=>[77,"E\x20"],"\x29"=>[18,"E\x20"],"\x2A"=>[77,"E\x25"],"\x2B"=>[18,"E\x25"],"\x2C"=>[77,"E-"],"-"=>[18,"E-"],"."=>[77,"E."],"\x2F"=>[18,"E."],[77,"E\x2F"],[18,"E\x2F"],[77,"E3"],[18,"E3"],[77,"E4"],[18,"E4"],[77,"E5"],[18,"E5"],[77,"E6"],[18,"E6"],"\x3A"=>[77,"E7"],"\x3B"=>[18,"E7"],"\x3C"=>[77,"E8"],"\x3D"=>[18,"E8"],"\x3E"=>[77,"E9"],"\x3F"=>[18,"E9"],"\x40"=>[77,"E\x3D"],"A"=>[18,"E\x3D"],"B"=>[77,"EA"],"C"=>[18,"EA"],"D"=>[77,"E_"],"E"=>[18,"E_"],"F"=>[77,"Eb"],"G"=>[18,"Eb"],"H"=>[77,"Ed"],"I"=>[18,"Ed"],"J"=>[77,"Ef"],"K"=>[18,"Ef"],"L"=>[77,"Eg"],"M"=>[18,"Eg"],"N"=>[77,"Eh"],"O"=>[18,"Eh"],"P"=>[77,"El"],"Q"=>[18,"El"],"R"=>[77,"Em"],"S"=>[18,"Em"],"T"=>[77,"En"],"U"=>[18,"En"],"V"=>[77,"Ep"],"W"=>[18,"Ep"],"X"=>[77,"Er"],"Y"=>[18,"Er"],"Z"=>[77,"Eu"],"\x5B"=>[18,"Eu"],"\x5C"=>[0,"E\x3A"],"\x5D"=>[0,"EB"],"\x5E"=>[0,"EC"],"_"=>[0,"ED"],"\x60"=>[0,"EE"],"a"=>[0,"EF"],"b"=>[0,"EG"],"c"=>[0,"EH"],"d"=>[0,"EI"],"e"=>[0,"EJ"],"f"=>[0,"EK"],"g"=>[0,"EL"],"h"=>[0,"EM"],"i"=>[0,"EN"],"j"=>[0,"EO"],"k"=>[0,"EP"],"l"=>[0,"EQ"],"m"=>[0,"ER"],"n"=>[0,"ES"],"o"=>[0,"ET"],"p"=>[0,"EU"],"q"=>[0,"EV"],"r"=>[0,"EW"],"s"=>[0,"EY"],"t"=>[0,"Ej"],"u"=>[0,"Ek"],"v"=>[0,"Eq"],"w"=>[0,"Ev"],"x"=>[0,"Ew"],"y"=>[0,"Ex"],"z"=>[0,"Ey"],"\x7B"=>[0,"Ez"],"\x7C"=>[82,"E"],"\x7D"=>[87,"E"],"~"=>[130,"E"],"\x7F"=>[9,"E"],"\x80"=>[94,"F0"],"\x81"=>[76,"F0"],"\x82"=>[104,"F0"],"\x83"=>[16,"F0"],"\x84"=>[94,"F1"],"\x85"=>[76,"F1"],"\x86"=>[104,"F1"],"\x87"=>[16,"F1"],"\x88"=>[94,"F2"],"\x89"=>[76,"F2"],"\x8A"=>[104,"F2"],"\x8B"=>[16,"F2"],"\x8C"=>[94,"Fa"],"\x8D"=>[76,"Fa"],"\x8E"=>[104,"Fa"],"\x8F"=>[16,"Fa"],"\x90"=>[94,"Fc"],"\x91"=>[76,"Fc"],"\x92"=>[104,"Fc"],"\x93"=>[16,"Fc"],"\x94"=>[94,"Fe"],"\x95"=>[76,"Fe"],"\x96"=>[104,"Fe"],"\x97"=>[16,"Fe"],"\x98"=>[94,"Fi"],"\x99"=>[76,"Fi"],"\x9A"=>[104,"Fi"],"\x9B"=>[16,"Fi"],"\x9C"=>[94,"Fo"],"\x9D"=>[76,"Fo"],"\x9E"=>[104,"Fo"],"\x9F"=>[16,"Fo"],"\xA0"=>[94,"Fs"],"\xA1"=>[76,"Fs"],"\xA2"=>[104,"Fs"],"\xA3"=>[16,"Fs"],"\xA4"=>[94,"Ft"],"\xA5"=>[76,"Ft"],"\xA6"=>[104,"Ft"],"\xA7"=>[16,"Ft"],"\xA8"=>[77,"F\x20"],"\xA9"=>[18,"F\x20"],"\xAA"=>[77,"F\x25"],"\xAB"=>[18,"F\x25"],"\xAC"=>[77,"F-"],"\xAD"=>[18,"F-"],"\xAE"=>[77,"F."],"\xAF"=>[18,"F."],"\xB0"=>[77,"F\x2F"],"\xB1"=>[18,"F\x2F"],"\xB2"=>[77,"F3"],"\xB3"=>[18,"F3"],"\xB4"=>[77,"F4"],"\xB5"=>[18,"F4"],"\xB6"=>[77,"F5"],"\xB7"=>[18,"F5"],"\xB8"=>[77,"F6"],"\xB9"=>[18,"F6"],"\xBA"=>[77,"F7"],"\xBB"=>[18,"F7"],"\xBC"=>[77,"F8"],"\xBD"=>[18,"F8"],"\xBE"=>[77,"F9"],"\xBF"=>[18,"F9"],"\xC0"=>[77,"F\x3D"],"\xC1"=>[18,"F\x3D"],"\xC2"=>[77,"FA"],"\xC3"=>[18,"FA"],"\xC4"=>[77,"F_"],"\xC5"=>[18,"F_"],"\xC6"=>[77,"Fb"],"\xC7"=>[18,"Fb"],"\xC8"=>[77,"Fd"],"\xC9"=>[18,"Fd"],"\xCA"=>[77,"Ff"],"\xCB"=>[18,"Ff"],"\xCC"=>[77,"Fg"],"\xCD"=>[18,"Fg"],"\xCE"=>[77,"Fh"],"\xCF"=>[18,"Fh"],"\xD0"=>[77,"Fl"],"\xD1"=>[18,"Fl"],"\xD2"=>[77,"Fm"],"\xD3"=>[18,"Fm"],"\xD4"=>[77,"Fn"],"\xD5"=>[18,"Fn"],"\xD6"=>[77,"Fp"],"\xD7"=>[18,"Fp"],"\xD8"=>[77,"Fr"],"\xD9"=>[18,"Fr"],"\xDA"=>[77,"Fu"],"\xDB"=>[18,"Fu"],"\xDC"=>[0,"F\x3A"],"\xDD"=>[0,"FB"],"\xDE"=>[0,"FC"],"\xDF"=>[0,"FD"],"\xE0"=>[0,"FE"],"\xE1"=>[0,"FF"],"\xE2"=>[0,"FG"],"\xE3"=>[0,"FH"],"\xE4"=>[0,"FI"],"\xE5"=>[0,"FJ"],"\xE6"=>[0,"FK"],"\xE7"=>[0,"FL"],"\xE8"=>[0,"FM"],"\xE9"=>[0,"FN"],"\xEA"=>[0,"FO"],"\xEB"=>[0,"FP"],"\xEC"=>[0,"FQ"],"\xED"=>[0,"FR"],"\xEE"=>[0,"FS"],"\xEF"=>[0,"FT"],"\xF0"=>[0,"FU"],"\xF1"=>[0,"FV"],"\xF2"=>[0,"FW"],"\xF3"=>[0,"FY"],"\xF4"=>[0,"Fj"],"\xF5"=>[0,"Fk"],"\xF6"=>[0,"Fq"],"\xF7"=>[0,"Fv"],"\xF8"=>[0,"Fw"],"\xF9"=>[0,"Fx"],"\xFA"=>[0,"Fy"],"\xFB"=>[0,"Fz"],"\xFC"=>[82,"F"],"\xFD"=>[87,"F"],"\xFE"=>[130,"F"],"\xFF"=>[9,"F"],],["\x00"=>[77,"E0"],"\x01"=>[18,"E0"],"\x02"=>[77,"E1"],"\x03"=>[18,"E1"],"\x04"=>[77,"E2"],"\x05"=>[18,"E2"],"\x06"=>[77,"Ea"],"\x07"=>[18,"Ea"],"\x08"=>[77,"Ec"],"\x09"=>[18,"Ec"],"\x0A"=>[77,"Ee"],"\x0B"=>[18,"Ee"],"\x0C"=>[77,"Ei"],"\x0D"=>[18,"Ei"],"\x0E"=>[77,"Eo"],"\x0F"=>[18,"Eo"],"\x10"=>[77,"Es"],"\x11"=>[18,"Es"],"\x12"=>[77,"Et"],"\x13"=>[18,"Et"],"\x14"=>[0,"E\x20"],"\x15"=>[0,"E\x25"],"\x16"=>[0,"E-"],"\x17"=>[0,"E."],"\x18"=>[0,"E\x2F"],"\x19"=>[0,"E3"],"\x1A"=>[0,"E4"],"\x1B"=>[0,"E5"],"\x1C"=>[0,"E6"],"\x1D"=>[0,"E7"],"\x1E"=>[0,"E8"],"\x1F"=>[0,"E9"],"\x20"=>[0,"E\x3D"],"\x21"=>[0,"EA"],"\x22"=>[0,"E_"],"\x23"=>[0,"Eb"],"\x24"=>[0,"Ed"],"\x25"=>[0,"Ef"],"\x26"=>[0,"Eg"],"\x27"=>[0,"Eh"],"\x28"=>[0,"El"],"\x29"=>[0,"Em"],"\x2A"=>[0,"En"],"\x2B"=>[0,"Ep"],"\x2C"=>[0,"Er"],"-"=>[0,"Eu"],"."=>[100,"E"],"\x2F"=>[110,"E"],[111,"E"],[115,"E"],[116,"E"],[118,"E"],[119,"E"],[122,"E"],[123,"E"],[125,"E"],[126,"E"],[129,"E"],"\x3A"=>[143,"E"],"\x3B"=>[148,"E"],"\x3C"=>[151,"E"],"\x3D"=>[153,"E"],"\x3E"=>[83,"E"],"\x3F"=>[10,"E"],"\x40"=>[77,"F0"],"A"=>[18,"F0"],"B"=>[77,"F1"],"C"=>[18,"F1"],"D"=>[77,"F2"],"E"=>[18,"F2"],"F"=>[77,"Fa"],"G"=>[18,"Fa"],"H"=>[77,"Fc"],"I"=>[18,"Fc"],"J"=>[77,"Fe"],"K"=>[18,"Fe"],"L"=>[77,"Fi"],"M"=>[18,"Fi"],"N"=>[77,"Fo"],"O"=>[18,"Fo"],"P"=>[77,"Fs"],"Q"=>[18,"Fs"],"R"=>[77,"Ft"],"S"=>[18,"Ft"],"T"=>[0,"F\x20"],"U"=>[0,"F\x25"],"V"=>[0,"F-"],"W"=>[0,"F."],"X"=>[0,"F\x2F"],"Y"=>[0,"F3"],"Z"=>[0,"F4"],"\x5B"=>[0,"F5"],"\x5C"=>[0,"F6"],"\x5D"=>[0,"F7"],"\x5E"=>[0,"F8"],"_"=>[0,"F9"],"\x60"=>[0,"F\x3D"],"a"=>[0,"FA"],"b"=>[0,"F_"],"c"=>[0,"Fb"],"d"=>[0,"Fd"],"e"=>[0,"Ff"],"f"=>[0,"Fg"],"g"=>[0,"Fh"],"h"=>[0,"Fl"],"i"=>[0,"Fm"],"j"=>[0,"Fn"],"k"=>[0,"Fp"],"l"=>[0,"Fr"],"m"=>[0,"Fu"],"n"=>[100,"F"],"o"=>[110,"F"],"p"=>[111,"F"],"q"=>[115,"F"],"r"=>[116,"F"],"s"=>[118,"F"],"t"=>[119,"F"],"u"=>[122,"F"],"v"=>[123,"F"],"w"=>[125,"F"],"x"=>[126,"F"],"y"=>[129,"F"],"z"=>[143,"F"],"\x7B"=>[148,"F"],"\x7C"=>[151,"F"],"\x7D"=>[153,"F"],"~"=>[83,"F"],"\x7F"=>[10,"F"],"\x80"=>[77,"G0"],"\x81"=>[18,"G0"],"\x82"=>[77,"G1"],"\x83"=>[18,"G1"],"\x84"=>[77,"G2"],"\x85"=>[18,"G2"],"\x86"=>[77,"Ga"],"\x87"=>[18,"Ga"],"\x88"=>[77,"Gc"],"\x89"=>[18,"Gc"],"\x8A"=>[77,"Ge"],"\x8B"=>[18,"Ge"],"\x8C"=>[77,"Gi"],"\x8D"=>[18,"Gi"],"\x8E"=>[77,"Go"],"\x8F"=>[18,"Go"],"\x90"=>[77,"Gs"],"\x91"=>[18,"Gs"],"\x92"=>[77,"Gt"],"\x93"=>[18,"Gt"],"\x94"=>[0,"G\x20"],"\x95"=>[0,"G\x25"],"\x96"=>[0,"G-"],"\x97"=>[0,"G."],"\x98"=>[0,"G\x2F"],"\x99"=>[0,"G3"],"\x9A"=>[0,"G4"],"\x9B"=>[0,"G5"],"\x9C"=>[0,"G6"],"\x9D"=>[0,"G7"],"\x9E"=>[0,"G8"],"\x9F"=>[0,"G9"],"\xA0"=>[0,"G\x3D"],"\xA1"=>[0,"GA"],"\xA2"=>[0,"G_"],"\xA3"=>[0,"Gb"],"\xA4"=>[0,"Gd"],"\xA5"=>[0,"Gf"],"\xA6"=>[0,"Gg"],"\xA7"=>[0,"Gh"],"\xA8"=>[0,"Gl"],"\xA9"=>[0,"Gm"],"\xAA"=>[0,"Gn"],"\xAB"=>[0,"Gp"],"\xAC"=>[0,"Gr"],"\xAD"=>[0,"Gu"],"\xAE"=>[100,"G"],"\xAF"=>[110,"G"],"\xB0"=>[111,"G"],"\xB1"=>[115,"G"],"\xB2"=>[116,"G"],"\xB3"=>[118,"G"],"\xB4"=>[119,"G"],"\xB5"=>[122,"G"],"\xB6"=>[123,"G"],"\xB7"=>[125,"G"],"\xB8"=>[126,"G"],"\xB9"=>[129,"G"],"\xBA"=>[143,"G"],"\xBB"=>[148,"G"],"\xBC"=>[151,"G"],"\xBD"=>[153,"G"],"\xBE"=>[83,"G"],"\xBF"=>[10,"G"],"\xC0"=>[77,"H0"],"\xC1"=>[18,"H0"],"\xC2"=>[77,"H1"],"\xC3"=>[18,"H1"],"\xC4"=>[77,"H2"],"\xC5"=>[18,"H2"],"\xC6"=>[77,"Ha"],"\xC7"=>[18,"Ha"],"\xC8"=>[77,"Hc"],"\xC9"=>[18,"Hc"],"\xCA"=>[77,"He"],"\xCB"=>[18,"He"],"\xCC"=>[77,"Hi"],"\xCD"=>[18,"Hi"],"\xCE"=>[77,"Ho"],"\xCF"=>[18,"Ho"],"\xD0"=>[77,"Hs"],"\xD1"=>[18,"Hs"],"\xD2"=>[77,"Ht"],"\xD3"=>[18,"Ht"],"\xD4"=>[0,"H\x20"],"\xD5"=>[0,"H\x25"],"\xD6"=>[0,"H-"],"\xD7"=>[0,"H."],"\xD8"=>[0,"H\x2F"],"\xD9"=>[0,"H3"],"\xDA"=>[0,"H4"],"\xDB"=>[0,"H5"],"\xDC"=>[0,"H6"],"\xDD"=>[0,"H7"],"\xDE"=>[0,"H8"],"\xDF"=>[0,"H9"],"\xE0"=>[0,"H\x3D"],"\xE1"=>[0,"HA"],"\xE2"=>[0,"H_"],"\xE3"=>[0,"Hb"],"\xE4"=>[0,"Hd"],"\xE5"=>[0,"Hf"],"\xE6"=>[0,"Hg"],"\xE7"=>[0,"Hh"],"\xE8"=>[0,"Hl"],"\xE9"=>[0,"Hm"],"\xEA"=>[0,"Hn"],"\xEB"=>[0,"Hp"],"\xEC"=>[0,"Hr"],"\xED"=>[0,"Hu"],"\xEE"=>[100,"H"],"\xEF"=>[110,"H"],"\xF0"=>[111,"H"],"\xF1"=>[115,"H"],"\xF2"=>[116,"H"],"\xF3"=>[118,"H"],"\xF4"=>[119,"H"],"\xF5"=>[122,"H"],"\xF6"=>[123,"H"],"\xF7"=>[125,"H"],"\xF8"=>[126,"H"],"\xF9"=>[129,"H"],"\xFA"=>[143,"H"],"\xFB"=>[148,"H"],"\xFC"=>[151,"H"],"\xFD"=>[153,"H"],"\xFE"=>[83,"H"],"\xFF"=>[10,"H"],],["\x00"=>[0,"E0"],"\x01"=>[0,"E1"],"\x02"=>[0,"E2"],"\x03"=>[0,"Ea"],"\x04"=>[0,"Ec"],"\x05"=>[0,"Ee"],"\x06"=>[0,"Ei"],"\x07"=>[0,"Eo"],"\x08"=>[0,"Es"],"\x09"=>[0,"Et"],"\x0A"=>[73,"E"],"\x0B"=>[88,"E"],"\x0C"=>[89,"E"],"\x0D"=>[96,"E"],"\x0E"=>[97,"E"],"\x0F"=>[99,"E"],"\x10"=>[106,"E"],"\x11"=>[136,"E"],"\x12"=>[139,"E"],"\x13"=>[141,"E"],"\x14"=>[145,"E"],"\x15"=>[147,"E"],"\x16"=>[149,"E"],"\x17"=>[101,"E"],"\x18"=>[112,"E"],"\x19"=>[117,"E"],"\x1A"=>[120,"E"],"\x1B"=>[124,"E"],"\x1C"=>[127,"E"],"\x1D"=>[144,"E"],"\x1E"=>[152,"E"],"\x1F"=>[11,"E"],"\x20"=>[0,"F0"],"\x21"=>[0,"F1"],"\x22"=>[0,"F2"],"\x23"=>[0,"Fa"],"\x24"=>[0,"Fc"],"\x25"=>[0,"Fe"],"\x26"=>[0,"Fi"],"\x27"=>[0,"Fo"],"\x28"=>[0,"Fs"],"\x29"=>[0,"Ft"],"\x2A"=>[73,"F"],"\x2B"=>[88,"F"],"\x2C"=>[89,"F"],"-"=>[96,"F"],"."=>[97,"F"],"\x2F"=>[99,"F"],[106,"F"],[136,"F"],[139,"F"],[141,"F"],[145,"F"],[147,"F"],[149,"F"],[101,"F"],[112,"F"],[117,"F"],"\x3A"=>[120,"F"],"\x3B"=>[124,"F"],"\x3C"=>[127,"F"],"\x3D"=>[144,"F"],"\x3E"=>[152,"F"],"\x3F"=>[11,"F"],"\x40"=>[0,"G0"],"A"=>[0,"G1"],"B"=>[0,"G2"],"C"=>[0,"Ga"],"D"=>[0,"Gc"],"E"=>[0,"Ge"],"F"=>[0,"Gi"],"G"=>[0,"Go"],"H"=>[0,"Gs"],"I"=>[0,"Gt"],"J"=>[73,"G"],"K"=>[88,"G"],"L"=>[89,"G"],"M"=>[96,"G"],"N"=>[97,"G"],"O"=>[99,"G"],"P"=>[106,"G"],"Q"=>[136,"G"],"R"=>[139,"G"],"S"=>[141,"G"],"T"=>[145,"G"],"U"=>[147,"G"],"V"=>[149,"G"],"W"=>[101,"G"],"X"=>[112,"G"],"Y"=>[117,"G"],"Z"=>[120,"G"],"\x5B"=>[124,"G"],"\x5C"=>[127,"G"],"\x5D"=>[144,"G"],"\x5E"=>[152,"G"],"_"=>[11,"G"],"\x60"=>[0,"H0"],"a"=>[0,"H1"],"b"=>[0,"H2"],"c"=>[0,"Ha"],"d"=>[0,"Hc"],"e"=>[0,"He"],"f"=>[0,"Hi"],"g"=>[0,"Ho"],"h"=>[0,"Hs"],"i"=>[0,"Ht"],"j"=>[73,"H"],"k"=>[88,"H"],"l"=>[89,"H"],"m"=>[96,"H"],"n"=>[97,"H"],"o"=>[99,"H"],"p"=>[106,"H"],"q"=>[136,"H"],"r"=>[139,"H"],"s"=>[141,"H"],"t"=>[145,"H"],"u"=>[147,"H"],"v"=>[149,"H"],"w"=>[101,"H"],"x"=>[112,"H"],"y"=>[117,"H"],"z"=>[120,"H"],"\x7B"=>[124,"H"],"\x7C"=>[127,"H"],"\x7D"=>[144,"H"],"~"=>[152,"H"],"\x7F"=>[11,"H"],"\x80"=>[0,"I0"],"\x81"=>[0,"I1"],"\x82"=>[0,"I2"],"\x83"=>[0,"Ia"],"\x84"=>[0,"Ic"],"\x85"=>[0,"Ie"],"\x86"=>[0,"Ii"],"\x87"=>[0,"Io"],"\x88"=>[0,"Is"],"\x89"=>[0,"It"],"\x8A"=>[73,"I"],"\x8B"=>[88,"I"],"\x8C"=>[89,"I"],"\x8D"=>[96,"I"],"\x8E"=>[97,"I"],"\x8F"=>[99,"I"],"\x90"=>[106,"I"],"\x91"=>[136,"I"],"\x92"=>[139,"I"],"\x93"=>[141,"I"],"\x94"=>[145,"I"],"\x95"=>[147,"I"],"\x96"=>[149,"I"],"\x97"=>[101,"I"],"\x98"=>[112,"I"],"\x99"=>[117,"I"],"\x9A"=>[120,"I"],"\x9B"=>[124,"I"],"\x9C"=>[127,"I"],"\x9D"=>[144,"I"],"\x9E"=>[152,"I"],"\x9F"=>[11,"I"],"\xA0"=>[0,"J0"],"\xA1"=>[0,"J1"],"\xA2"=>[0,"J2"],"\xA3"=>[0,"Ja"],"\xA4"=>[0,"Jc"],"\xA5"=>[0,"Je"],"\xA6"=>[0,"Ji"],"\xA7"=>[0,"Jo"],"\xA8"=>[0,"Js"],"\xA9"=>[0,"Jt"],"\xAA"=>[73,"J"],"\xAB"=>[88,"J"],"\xAC"=>[89,"J"],"\xAD"=>[96,"J"],"\xAE"=>[97,"J"],"\xAF"=>[99,"J"],"\xB0"=>[106,"J"],"\xB1"=>[136,"J"],"\xB2"=>[139,"J"],"\xB3"=>[141,"J"],"\xB4"=>[145,"J"],"\xB5"=>[147,"J"],"\xB6"=>[149,"J"],"\xB7"=>[101,"J"],"\xB8"=>[112,"J"],"\xB9"=>[117,"J"],"\xBA"=>[120,"J"],"\xBB"=>[124,"J"],"\xBC"=>[127,"J"],"\xBD"=>[144,"J"],"\xBE"=>[152,"J"],"\xBF"=>[11,"J"],"\xC0"=>[0,"K0"],"\xC1"=>[0,"K1"],"\xC2"=>[0,"K2"],"\xC3"=>[0,"Ka"],"\xC4"=>[0,"Kc"],"\xC5"=>[0,"Ke"],"\xC6"=>[0,"Ki"],"\xC7"=>[0,"Ko"],"\xC8"=>[0,"Ks"],"\xC9"=>[0,"Kt"],"\xCA"=>[73,"K"],"\xCB"=>[88,"K"],"\xCC"=>[89,"K"],"\xCD"=>[96,"K"],"\xCE"=>[97,"K"],"\xCF"=>[99,"K"],"\xD0"=>[106,"K"],"\xD1"=>[136,"K"],"\xD2"=>[139,"K"],"\xD3"=>[141,"K"],"\xD4"=>[145,"K"],"\xD5"=>[147,"K"],"\xD6"=>[149,"K"],"\xD7"=>[101,"K"],"\xD8"=>[112,"K"],"\xD9"=>[117,"K"],"\xDA"=>[120,"K"],"\xDB"=>[124,"K"],"\xDC"=>[127,"K"],"\xDD"=>[144,"K"],"\xDE"=>[152,"K"],"\xDF"=>[11,"K"],"\xE0"=>[0,"L0"],"\xE1"=>[0,"L1"],"\xE2"=>[0,"L2"],"\xE3"=>[0,"La"],"\xE4"=>[0,"Lc"],"\xE5"=>[0,"Le"],"\xE6"=>[0,"Li"],"\xE7"=>[0,"Lo"],"\xE8"=>[0,"Ls"],"\xE9"=>[0,"Lt"],"\xEA"=>[73,"L"],"\xEB"=>[88,"L"],"\xEC"=>[89,"L"],"\xED"=>[96,"L"],"\xEE"=>[97,"L"],"\xEF"=>[99,"L"],"\xF0"=>[106,"L"],"\xF1"=>[136,"L"],"\xF2"=>[139,"L"],"\xF3"=>[141,"L"],"\xF4"=>[145,"L"],"\xF5"=>[147,"L"],"\xF6"=>[149,"L"],"\xF7"=>[101,"L"],"\xF8"=>[112,"L"],"\xF9"=>[117,"L"],"\xFA"=>[120,"L"],"\xFB"=>[124,"L"],"\xFC"=>[127,"L"],"\xFD"=>[144,"L"],"\xFE"=>[152,"L"],"\xFF"=>[11,"L"],],["\x00"=>[92,"E"],"\x01"=>[95,"E"],"\x02"=>[137,"E"],"\x03"=>[142,"E"],"\x04"=>[150,"E"],"\x05"=>[74,"E"],"\x06"=>[90,"E"],"\x07"=>[98,"E"],"\x08"=>[107,"E"],"\x09"=>[140,"E"],"\x0A"=>[146,"E"],"\x0B"=>[102,"E"],"\x0C"=>[113,"E"],"\x0D"=>[121,"E"],"\x0E"=>[128,"E"],"\x0F"=>[12,"E"],"\x10"=>[92,"F"],"\x11"=>[95,"F"],"\x12"=>[137,"F"],"\x13"=>[142,"F"],"\x14"=>[150,"F"],"\x15"=>[74,"F"],"\x16"=>[90,"F"],"\x17"=>[98,"F"],"\x18"=>[107,"F"],"\x19"=>[140,"F"],"\x1A"=>[146,"F"],"\x1B"=>[102,"F"],"\x1C"=>[113,"F"],"\x1D"=>[121,"F"],"\x1E"=>[128,"F"],"\x1F"=>[12,"F"],"\x20"=>[92,"G"],"\x21"=>[95,"G"],"\x22"=>[137,"G"],"\x23"=>[142,"G"],"\x24"=>[150,"G"],"\x25"=>[74,"G"],"\x26"=>[90,"G"],"\x27"=>[98,"G"],"\x28"=>[107,"G"],"\x29"=>[140,"G"],"\x2A"=>[146,"G"],"\x2B"=>[102,"G"],"\x2C"=>[113,"G"],"-"=>[121,"G"],"."=>[128,"G"],"\x2F"=>[12,"G"],[92,"H"],[95,"H"],[137,"H"],[142,"H"],[150,"H"],[74,"H"],[90,"H"],[98,"H"],[107,"H"],[140,"H"],"\x3A"=>[146,"H"],"\x3B"=>[102,"H"],"\x3C"=>[113,"H"],"\x3D"=>[121,"H"],"\x3E"=>[128,"H"],"\x3F"=>[12,"H"],"\x40"=>[92,"I"],"A"=>[95,"I"],"B"=>[137,"I"],"C"=>[142,"I"],"D"=>[150,"I"],"E"=>[74,"I"],"F"=>[90,"I"],"G"=>[98,"I"],"H"=>[107,"I"],"I"=>[140,"I"],"J"=>[146,"I"],"K"=>[102,"I"],"L"=>[113,"I"],"M"=>[121,"I"],"N"=>[128,"I"],"O"=>[12,"I"],"P"=>[92,"J"],"Q"=>[95,"J"],"R"=>[137,"J"],"S"=>[142,"J"],"T"=>[150,"J"],"U"=>[74,"J"],"V"=>[90,"J"],"W"=>[98,"J"],"X"=>[107,"J"],"Y"=>[140,"J"],"Z"=>[146,"J"],"\x5B"=>[102,"J"],"\x5C"=>[113,"J"],"\x5D"=>[121,"J"],"\x5E"=>[128,"J"],"_"=>[12,"J"],"\x60"=>[92,"K"],"a"=>[95,"K"],"b"=>[137,"K"],"c"=>[142,"K"],"d"=>[150,"K"],"e"=>[74,"K"],"f"=>[90,"K"],"g"=>[98,"K"],"h"=>[107,"K"],"i"=>[140,"K"],"j"=>[146,"K"],"k"=>[102,"K"],"l"=>[113,"K"],"m"=>[121,"K"],"n"=>[128,"K"],"o"=>[12,"K"],"p"=>[92,"L"],"q"=>[95,"L"],"r"=>[137,"L"],"s"=>[142,"L"],"t"=>[150,"L"],"u"=>[74,"L"],"v"=>[90,"L"],"w"=>[98,"L"],"x"=>[107,"L"],"y"=>[140,"L"],"z"=>[146,"L"],"\x7B"=>[102,"L"],"\x7C"=>[113,"L"],"\x7D"=>[121,"L"],"~"=>[128,"L"],"\x7F"=>[12,"L"],"\x80"=>[92,"M"],"\x81"=>[95,"M"],"\x82"=>[137,"M"],"\x83"=>[142,"M"],"\x84"=>[150,"M"],"\x85"=>[74,"M"],"\x86"=>[90,"M"],"\x87"=>[98,"M"],"\x88"=>[107,"M"],"\x89"=>[140,"M"],"\x8A"=>[146,"M"],"\x8B"=>[102,"M"],"\x8C"=>[113,"M"],"\x8D"=>[121,"M"],"\x8E"=>[128,"M"],"\x8F"=>[12,"M"],"\x90"=>[92,"N"],"\x91"=>[95,"N"],"\x92"=>[137,"N"],"\x93"=>[142,"N"],"\x94"=>[150,"N"],"\x95"=>[74,"N"],"\x96"=>[90,"N"],"\x97"=>[98,"N"],"\x98"=>[107,"N"],"\x99"=>[140,"N"],"\x9A"=>[146,"N"],"\x9B"=>[102,"N"],"\x9C"=>[113,"N"],"\x9D"=>[121,"N"],"\x9E"=>[128,"N"],"\x9F"=>[12,"N"],"\xA0"=>[92,"O"],"\xA1"=>[95,"O"],"\xA2"=>[137,"O"],"\xA3"=>[142,"O"],"\xA4"=>[150,"O"],"\xA5"=>[74,"O"],"\xA6"=>[90,"O"],"\xA7"=>[98,"O"],"\xA8"=>[107,"O"],"\xA9"=>[140,"O"],"\xAA"=>[146,"O"],"\xAB"=>[102,"O"],"\xAC"=>[113,"O"],"\xAD"=>[121,"O"],"\xAE"=>[128,"O"],"\xAF"=>[12,"O"],"\xB0"=>[92,"P"],"\xB1"=>[95,"P"],"\xB2"=>[137,"P"],"\xB3"=>[142,"P"],"\xB4"=>[150,"P"],"\xB5"=>[74,"P"],"\xB6"=>[90,"P"],"\xB7"=>[98,"P"],"\xB8"=>[107,"P"],"\xB9"=>[140,"P"],"\xBA"=>[146,"P"],"\xBB"=>[102,"P"],"\xBC"=>[113,"P"],"\xBD"=>[121,"P"],"\xBE"=>[128,"P"],"\xBF"=>[12,"P"],"\xC0"=>[92,"Q"],"\xC1"=>[95,"Q"],"\xC2"=>[137,"Q"],"\xC3"=>[142,"Q"],"\xC4"=>[150,"Q"],"\xC5"=>[74,"Q"],"\xC6"=>[90,"Q"],"\xC7"=>[98,"Q"],"\xC8"=>[107,"Q"],"\xC9"=>[140,"Q"],"\xCA"=>[146,"Q"],"\xCB"=>[102,"Q"],"\xCC"=>[113,"Q"],"\xCD"=>[121,"Q"],"\xCE"=>[128,"Q"],"\xCF"=>[12,"Q"],"\xD0"=>[92,"R"],"\xD1"=>[95,"R"],"\xD2"=>[137,"R"],"\xD3"=>[142,"R"],"\xD4"=>[150,"R"],"\xD5"=>[74,"R"],"\xD6"=>[90,"R"],"\xD7"=>[98,"R"],"\xD8"=>[107,"R"],"\xD9"=>[140,"R"],"\xDA"=>[146,"R"],"\xDB"=>[102,"R"],"\xDC"=>[113,"R"],"\xDD"=>[121,"R"],"\xDE"=>[128,"R"],"\xDF"=>[12,"R"],"\xE0"=>[92,"S"],"\xE1"=>[95,"S"],"\xE2"=>[137,"S"],"\xE3"=>[142,"S"],"\xE4"=>[150,"S"],"\xE5"=>[74,"S"],"\xE6"=>[90,"S"],"\xE7"=>[98,"S"],"\xE8"=>[107,"S"],"\xE9"=>[140,"S"],"\xEA"=>[146,"S"],"\xEB"=>[102,"S"],"\xEC"=>[113,"S"],"\xED"=>[121,"S"],"\xEE"=>[128,"S"],"\xEF"=>[12,"S"],"\xF0"=>[92,"T"],"\xF1"=>[95,"T"],"\xF2"=>[137,"T"],"\xF3"=>[142,"T"],"\xF4"=>[150,"T"],"\xF5"=>[74,"T"],"\xF6"=>[90,"T"],"\xF7"=>[98,"T"],"\xF8"=>[107,"T"],"\xF9"=>[140,"T"],"\xFA"=>[146,"T"],"\xFB"=>[102,"T"],"\xFC"=>[113,"T"],"\xFD"=>[121,"T"],"\xFE"=>[128,"T"],"\xFF"=>[12,"T"],],["\x00"=>[94,"G0"],"\x01"=>[76,"G0"],"\x02"=>[104,"G0"],"\x03"=>[16,"G0"],"\x04"=>[94,"G1"],"\x05"=>[76,"G1"],"\x06"=>[104,"G1"],"\x07"=>[16,"G1"],"\x08"=>[94,"G2"],"\x09"=>[76,"G2"],"\x0A"=>[104,"G2"],"\x0B"=>[16,"G2"],"\x0C"=>[94,"Ga"],"\x0D"=>[76,"Ga"],"\x0E"=>[104,"Ga"],"\x0F"=>[16,"Ga"],"\x10"=>[94,"Gc"],"\x11"=>[76,"Gc"],"\x12"=>[104,"Gc"],"\x13"=>[16,"Gc"],"\x14"=>[94,"Ge"],"\x15"=>[76,"Ge"],"\x16"=>[104,"Ge"],"\x17"=>[16,"Ge"],"\x18"=>[94,"Gi"],"\x19"=>[76,"Gi"],"\x1A"=>[104,"Gi"],"\x1B"=>[16,"Gi"],"\x1C"=>[94,"Go"],"\x1D"=>[76,"Go"],"\x1E"=>[104,"Go"],"\x1F"=>[16,"Go"],"\x20"=>[94,"Gs"],"\x21"=>[76,"Gs"],"\x22"=>[104,"Gs"],"\x23"=>[16,"Gs"],"\x24"=>[94,"Gt"],"\x25"=>[76,"Gt"],"\x26"=>[104,"Gt"],"\x27"=>[16,"Gt"],"\x28"=>[77,"G\x20"],"\x29"=>[18,"G\x20"],"\x2A"=>[77,"G\x25"],"\x2B"=>[18,"G\x25"],"\x2C"=>[77,"G-"],"-"=>[18,"G-"],"."=>[77,"G."],"\x2F"=>[18,"G."],[77,"G\x2F"],[18,"G\x2F"],[77,"G3"],[18,"G3"],[77,"G4"],[18,"G4"],[77,"G5"],[18,"G5"],[77,"G6"],[18,"G6"],"\x3A"=>[77,"G7"],"\x3B"=>[18,"G7"],"\x3C"=>[77,"G8"],"\x3D"=>[18,"G8"],"\x3E"=>[77,"G9"],"\x3F"=>[18,"G9"],"\x40"=>[77,"G\x3D"],"A"=>[18,"G\x3D"],"B"=>[77,"GA"],"C"=>[18,"GA"],"D"=>[77,"G_"],"E"=>[18,"G_"],"F"=>[77,"Gb"],"G"=>[18,"Gb"],"H"=>[77,"Gd"],"I"=>[18,"Gd"],"J"=>[77,"Gf"],"K"=>[18,"Gf"],"L"=>[77,"Gg"],"M"=>[18,"Gg"],"N"=>[77,"Gh"],"O"=>[18,"Gh"],"P"=>[77,"Gl"],"Q"=>[18,"Gl"],"R"=>[77,"Gm"],"S"=>[18,"Gm"],"T"=>[77,"Gn"],"U"=>[18,"Gn"],"V"=>[77,"Gp"],"W"=>[18,"Gp"],"X"=>[77,"Gr"],"Y"=>[18,"Gr"],"Z"=>[77,"Gu"],"\x5B"=>[18,"Gu"],"\x5C"=>[0,"G\x3A"],"\x5D"=>[0,"GB"],"\x5E"=>[0,"GC"],"_"=>[0,"GD"],"\x60"=>[0,"GE"],"a"=>[0,"GF"],"b"=>[0,"GG"],"c"=>[0,"GH"],"d"=>[0,"GI"],"e"=>[0,"GJ"],"f"=>[0,"GK"],"g"=>[0,"GL"],"h"=>[0,"GM"],"i"=>[0,"GN"],"j"=>[0,"GO"],"k"=>[0,"GP"],"l"=>[0,"GQ"],"m"=>[0,"GR"],"n"=>[0,"GS"],"o"=>[0,"GT"],"p"=>[0,"GU"],"q"=>[0,"GV"],"r"=>[0,"GW"],"s"=>[0,"GY"],"t"=>[0,"Gj"],"u"=>[0,"Gk"],"v"=>[0,"Gq"],"w"=>[0,"Gv"],"x"=>[0,"Gw"],"y"=>[0,"Gx"],"z"=>[0,"Gy"],"\x7B"=>[0,"Gz"],"\x7C"=>[82,"G"],"\x7D"=>[87,"G"],"~"=>[130,"G"],"\x7F"=>[9,"G"],"\x80"=>[94,"H0"],"\x81"=>[76,"H0"],"\x82"=>[104,"H0"],"\x83"=>[16,"H0"],"\x84"=>[94,"H1"],"\x85"=>[76,"H1"],"\x86"=>[104,"H1"],"\x87"=>[16,"H1"],"\x88"=>[94,"H2"],"\x89"=>[76,"H2"],"\x8A"=>[104,"H2"],"\x8B"=>[16,"H2"],"\x8C"=>[94,"Ha"],"\x8D"=>[76,"Ha"],"\x8E"=>[104,"Ha"],"\x8F"=>[16,"Ha"],"\x90"=>[94,"Hc"],"\x91"=>[76,"Hc"],"\x92"=>[104,"Hc"],"\x93"=>[16,"Hc"],"\x94"=>[94,"He"],"\x95"=>[76,"He"],"\x96"=>[104,"He"],"\x97"=>[16,"He"],"\x98"=>[94,"Hi"],"\x99"=>[76,"Hi"],"\x9A"=>[104,"Hi"],"\x9B"=>[16,"Hi"],"\x9C"=>[94,"Ho"],"\x9D"=>[76,"Ho"],"\x9E"=>[104,"Ho"],"\x9F"=>[16,"Ho"],"\xA0"=>[94,"Hs"],"\xA1"=>[76,"Hs"],"\xA2"=>[104,"Hs"],"\xA3"=>[16,"Hs"],"\xA4"=>[94,"Ht"],"\xA5"=>[76,"Ht"],"\xA6"=>[104,"Ht"],"\xA7"=>[16,"Ht"],"\xA8"=>[77,"H\x20"],"\xA9"=>[18,"H\x20"],"\xAA"=>[77,"H\x25"],"\xAB"=>[18,"H\x25"],"\xAC"=>[77,"H-"],"\xAD"=>[18,"H-"],"\xAE"=>[77,"H."],"\xAF"=>[18,"H."],"\xB0"=>[77,"H\x2F"],"\xB1"=>[18,"H\x2F"],"\xB2"=>[77,"H3"],"\xB3"=>[18,"H3"],"\xB4"=>[77,"H4"],"\xB5"=>[18,"H4"],"\xB6"=>[77,"H5"],"\xB7"=>[18,"H5"],"\xB8"=>[77,"H6"],"\xB9"=>[18,"H6"],"\xBA"=>[77,"H7"],"\xBB"=>[18,"H7"],"\xBC"=>[77,"H8"],"\xBD"=>[18,"H8"],"\xBE"=>[77,"H9"],"\xBF"=>[18,"H9"],"\xC0"=>[77,"H\x3D"],"\xC1"=>[18,"H\x3D"],"\xC2"=>[77,"HA"],"\xC3"=>[18,"HA"],"\xC4"=>[77,"H_"],"\xC5"=>[18,"H_"],"\xC6"=>[77,"Hb"],"\xC7"=>[18,"Hb"],"\xC8"=>[77,"Hd"],"\xC9"=>[18,"Hd"],"\xCA"=>[77,"Hf"],"\xCB"=>[18,"Hf"],"\xCC"=>[77,"Hg"],"\xCD"=>[18,"Hg"],"\xCE"=>[77,"Hh"],"\xCF"=>[18,"Hh"],"\xD0"=>[77,"Hl"],"\xD1"=>[18,"Hl"],"\xD2"=>[77,"Hm"],"\xD3"=>[18,"Hm"],"\xD4"=>[77,"Hn"],"\xD5"=>[18,"Hn"],"\xD6"=>[77,"Hp"],"\xD7"=>[18,"Hp"],"\xD8"=>[77,"Hr"],"\xD9"=>[18,"Hr"],"\xDA"=>[77,"Hu"],"\xDB"=>[18,"Hu"],"\xDC"=>[0,"H\x3A"],"\xDD"=>[0,"HB"],"\xDE"=>[0,"HC"],"\xDF"=>[0,"HD"],"\xE0"=>[0,"HE"],"\xE1"=>[0,"HF"],"\xE2"=>[0,"HG"],"\xE3"=>[0,"HH"],"\xE4"=>[0,"HI"],"\xE5"=>[0,"HJ"],"\xE6"=>[0,"HK"],"\xE7"=>[0,"HL"],"\xE8"=>[0,"HM"],"\xE9"=>[0,"HN"],"\xEA"=>[0,"HO"],"\xEB"=>[0,"HP"],"\xEC"=>[0,"HQ"],"\xED"=>[0,"HR"],"\xEE"=>[0,"HS"],"\xEF"=>[0,"HT"],"\xF0"=>[0,"HU"],"\xF1"=>[0,"HV"],"\xF2"=>[0,"HW"],"\xF3"=>[0,"HY"],"\xF4"=>[0,"Hj"],"\xF5"=>[0,"Hk"],"\xF6"=>[0,"Hq"],"\xF7"=>[0,"Hv"],"\xF8"=>[0,"Hw"],"\xF9"=>[0,"Hx"],"\xFA"=>[0,"Hy"],"\xFB"=>[0,"Hz"],"\xFC"=>[82,"H"],"\xFD"=>[87,"H"],"\xFE"=>[130,"H"],"\xFF"=>[9,"H"],],["\x00"=>[94,"I0"],"\x01"=>[76,"I0"],"\x02"=>[104,"I0"],"\x03"=>[16,"I0"],"\x04"=>[94,"I1"],"\x05"=>[76,"I1"],"\x06"=>[104,"I1"],"\x07"=>[16,"I1"],"\x08"=>[94,"I2"],"\x09"=>[76,"I2"],"\x0A"=>[104,"I2"],"\x0B"=>[16,"I2"],"\x0C"=>[94,"Ia"],"\x0D"=>[76,"Ia"],"\x0E"=>[104,"Ia"],"\x0F"=>[16,"Ia"],"\x10"=>[94,"Ic"],"\x11"=>[76,"Ic"],"\x12"=>[104,"Ic"],"\x13"=>[16,"Ic"],"\x14"=>[94,"Ie"],"\x15"=>[76,"Ie"],"\x16"=>[104,"Ie"],"\x17"=>[16,"Ie"],"\x18"=>[94,"Ii"],"\x19"=>[76,"Ii"],"\x1A"=>[104,"Ii"],"\x1B"=>[16,"Ii"],"\x1C"=>[94,"Io"],"\x1D"=>[76,"Io"],"\x1E"=>[104,"Io"],"\x1F"=>[16,"Io"],"\x20"=>[94,"Is"],"\x21"=>[76,"Is"],"\x22"=>[104,"Is"],"\x23"=>[16,"Is"],"\x24"=>[94,"It"],"\x25"=>[76,"It"],"\x26"=>[104,"It"],"\x27"=>[16,"It"],"\x28"=>[77,"I\x20"],"\x29"=>[18,"I\x20"],"\x2A"=>[77,"I\x25"],"\x2B"=>[18,"I\x25"],"\x2C"=>[77,"I-"],"-"=>[18,"I-"],"."=>[77,"I."],"\x2F"=>[18,"I."],[77,"I\x2F"],[18,"I\x2F"],[77,"I3"],[18,"I3"],[77,"I4"],[18,"I4"],[77,"I5"],[18,"I5"],[77,"I6"],[18,"I6"],"\x3A"=>[77,"I7"],"\x3B"=>[18,"I7"],"\x3C"=>[77,"I8"],"\x3D"=>[18,"I8"],"\x3E"=>[77,"I9"],"\x3F"=>[18,"I9"],"\x40"=>[77,"I\x3D"],"A"=>[18,"I\x3D"],"B"=>[77,"IA"],"C"=>[18,"IA"],"D"=>[77,"I_"],"E"=>[18,"I_"],"F"=>[77,"Ib"],"G"=>[18,"Ib"],"H"=>[77,"Id"],"I"=>[18,"Id"],"J"=>[77,"If"],"K"=>[18,"If"],"L"=>[77,"Ig"],"M"=>[18,"Ig"],"N"=>[77,"Ih"],"O"=>[18,"Ih"],"P"=>[77,"Il"],"Q"=>[18,"Il"],"R"=>[77,"Im"],"S"=>[18,"Im"],"T"=>[77,"In"],"U"=>[18,"In"],"V"=>[77,"Ip"],"W"=>[18,"Ip"],"X"=>[77,"Ir"],"Y"=>[18,"Ir"],"Z"=>[77,"Iu"],"\x5B"=>[18,"Iu"],"\x5C"=>[0,"I\x3A"],"\x5D"=>[0,"IB"],"\x5E"=>[0,"IC"],"_"=>[0,"ID"],"\x60"=>[0,"IE"],"a"=>[0,"IF"],"b"=>[0,"IG"],"c"=>[0,"IH"],"d"=>[0,"II"],"e"=>[0,"IJ"],"f"=>[0,"IK"],"g"=>[0,"IL"],"h"=>[0,"IM"],"i"=>[0,"IN"],"j"=>[0,"IO"],"k"=>[0,"IP"],"l"=>[0,"IQ"],"m"=>[0,"IR"],"n"=>[0,"IS"],"o"=>[0,"IT"],"p"=>[0,"IU"],"q"=>[0,"IV"],"r"=>[0,"IW"],"s"=>[0,"IY"],"t"=>[0,"Ij"],"u"=>[0,"Ik"],"v"=>[0,"Iq"],"w"=>[0,"Iv"],"x"=>[0,"Iw"],"y"=>[0,"Ix"],"z"=>[0,"Iy"],"\x7B"=>[0,"Iz"],"\x7C"=>[82,"I"],"\x7D"=>[87,"I"],"~"=>[130,"I"],"\x7F"=>[9,"I"],"\x80"=>[94,"J0"],"\x81"=>[76,"J0"],"\x82"=>[104,"J0"],"\x83"=>[16,"J0"],"\x84"=>[94,"J1"],"\x85"=>[76,"J1"],"\x86"=>[104,"J1"],"\x87"=>[16,"J1"],"\x88"=>[94,"J2"],"\x89"=>[76,"J2"],"\x8A"=>[104,"J2"],"\x8B"=>[16,"J2"],"\x8C"=>[94,"Ja"],"\x8D"=>[76,"Ja"],"\x8E"=>[104,"Ja"],"\x8F"=>[16,"Ja"],"\x90"=>[94,"Jc"],"\x91"=>[76,"Jc"],"\x92"=>[104,"Jc"],"\x93"=>[16,"Jc"],"\x94"=>[94,"Je"],"\x95"=>[76,"Je"],"\x96"=>[104,"Je"],"\x97"=>[16,"Je"],"\x98"=>[94,"Ji"],"\x99"=>[76,"Ji"],"\x9A"=>[104,"Ji"],"\x9B"=>[16,"Ji"],"\x9C"=>[94,"Jo"],"\x9D"=>[76,"Jo"],"\x9E"=>[104,"Jo"],"\x9F"=>[16,"Jo"],"\xA0"=>[94,"Js"],"\xA1"=>[76,"Js"],"\xA2"=>[104,"Js"],"\xA3"=>[16,"Js"],"\xA4"=>[94,"Jt"],"\xA5"=>[76,"Jt"],"\xA6"=>[104,"Jt"],"\xA7"=>[16,"Jt"],"\xA8"=>[77,"J\x20"],"\xA9"=>[18,"J\x20"],"\xAA"=>[77,"J\x25"],"\xAB"=>[18,"J\x25"],"\xAC"=>[77,"J-"],"\xAD"=>[18,"J-"],"\xAE"=>[77,"J."],"\xAF"=>[18,"J."],"\xB0"=>[77,"J\x2F"],"\xB1"=>[18,"J\x2F"],"\xB2"=>[77,"J3"],"\xB3"=>[18,"J3"],"\xB4"=>[77,"J4"],"\xB5"=>[18,"J4"],"\xB6"=>[77,"J5"],"\xB7"=>[18,"J5"],"\xB8"=>[77,"J6"],"\xB9"=>[18,"J6"],"\xBA"=>[77,"J7"],"\xBB"=>[18,"J7"],"\xBC"=>[77,"J8"],"\xBD"=>[18,"J8"],"\xBE"=>[77,"J9"],"\xBF"=>[18,"J9"],"\xC0"=>[77,"J\x3D"],"\xC1"=>[18,"J\x3D"],"\xC2"=>[77,"JA"],"\xC3"=>[18,"JA"],"\xC4"=>[77,"J_"],"\xC5"=>[18,"J_"],"\xC6"=>[77,"Jb"],"\xC7"=>[18,"Jb"],"\xC8"=>[77,"Jd"],"\xC9"=>[18,"Jd"],"\xCA"=>[77,"Jf"],"\xCB"=>[18,"Jf"],"\xCC"=>[77,"Jg"],"\xCD"=>[18,"Jg"],"\xCE"=>[77,"Jh"],"\xCF"=>[18,"Jh"],"\xD0"=>[77,"Jl"],"\xD1"=>[18,"Jl"],"\xD2"=>[77,"Jm"],"\xD3"=>[18,"Jm"],"\xD4"=>[77,"Jn"],"\xD5"=>[18,"Jn"],"\xD6"=>[77,"Jp"],"\xD7"=>[18,"Jp"],"\xD8"=>[77,"Jr"],"\xD9"=>[18,"Jr"],"\xDA"=>[77,"Ju"],"\xDB"=>[18,"Ju"],"\xDC"=>[0,"J\x3A"],"\xDD"=>[0,"JB"],"\xDE"=>[0,"JC"],"\xDF"=>[0,"JD"],"\xE0"=>[0,"JE"],"\xE1"=>[0,"JF"],"\xE2"=>[0,"JG"],"\xE3"=>[0,"JH"],"\xE4"=>[0,"JI"],"\xE5"=>[0,"JJ"],"\xE6"=>[0,"JK"],"\xE7"=>[0,"JL"],"\xE8"=>[0,"JM"],"\xE9"=>[0,"JN"],"\xEA"=>[0,"JO"],"\xEB"=>[0,"JP"],"\xEC"=>[0,"JQ"],"\xED"=>[0,"JR"],"\xEE"=>[0,"JS"],"\xEF"=>[0,"JT"],"\xF0"=>[0,"JU"],"\xF1"=>[0,"JV"],"\xF2"=>[0,"JW"],"\xF3"=>[0,"JY"],"\xF4"=>[0,"Jj"],"\xF5"=>[0,"Jk"],"\xF6"=>[0,"Jq"],"\xF7"=>[0,"Jv"],"\xF8"=>[0,"Jw"],"\xF9"=>[0,"Jx"],"\xFA"=>[0,"Jy"],"\xFB"=>[0,"Jz"],"\xFC"=>[82,"J"],"\xFD"=>[87,"J"],"\xFE"=>[130,"J"],"\xFF"=>[9,"J"],],["\x00"=>[77,"I0"],"\x01"=>[18,"I0"],"\x02"=>[77,"I1"],"\x03"=>[18,"I1"],"\x04"=>[77,"I2"],"\x05"=>[18,"I2"],"\x06"=>[77,"Ia"],"\x07"=>[18,"Ia"],"\x08"=>[77,"Ic"],"\x09"=>[18,"Ic"],"\x0A"=>[77,"Ie"],"\x0B"=>[18,"Ie"],"\x0C"=>[77,"Ii"],"\x0D"=>[18,"Ii"],"\x0E"=>[77,"Io"],"\x0F"=>[18,"Io"],"\x10"=>[77,"Is"],"\x11"=>[18,"Is"],"\x12"=>[77,"It"],"\x13"=>[18,"It"],"\x14"=>[0,"I\x20"],"\x15"=>[0,"I\x25"],"\x16"=>[0,"I-"],"\x17"=>[0,"I."],"\x18"=>[0,"I\x2F"],"\x19"=>[0,"I3"],"\x1A"=>[0,"I4"],"\x1B"=>[0,"I5"],"\x1C"=>[0,"I6"],"\x1D"=>[0,"I7"],"\x1E"=>[0,"I8"],"\x1F"=>[0,"I9"],"\x20"=>[0,"I\x3D"],"\x21"=>[0,"IA"],"\x22"=>[0,"I_"],"\x23"=>[0,"Ib"],"\x24"=>[0,"Id"],"\x25"=>[0,"If"],"\x26"=>[0,"Ig"],"\x27"=>[0,"Ih"],"\x28"=>[0,"Il"],"\x29"=>[0,"Im"],"\x2A"=>[0,"In"],"\x2B"=>[0,"Ip"],"\x2C"=>[0,"Ir"],"-"=>[0,"Iu"],"."=>[100,"I"],"\x2F"=>[110,"I"],[111,"I"],[115,"I"],[116,"I"],[118,"I"],[119,"I"],[122,"I"],[123,"I"],[125,"I"],[126,"I"],[129,"I"],"\x3A"=>[143,"I"],"\x3B"=>[148,"I"],"\x3C"=>[151,"I"],"\x3D"=>[153,"I"],"\x3E"=>[83,"I"],"\x3F"=>[10,"I"],"\x40"=>[77,"J0"],"A"=>[18,"J0"],"B"=>[77,"J1"],"C"=>[18,"J1"],"D"=>[77,"J2"],"E"=>[18,"J2"],"F"=>[77,"Ja"],"G"=>[18,"Ja"],"H"=>[77,"Jc"],"I"=>[18,"Jc"],"J"=>[77,"Je"],"K"=>[18,"Je"],"L"=>[77,"Ji"],"M"=>[18,"Ji"],"N"=>[77,"Jo"],"O"=>[18,"Jo"],"P"=>[77,"Js"],"Q"=>[18,"Js"],"R"=>[77,"Jt"],"S"=>[18,"Jt"],"T"=>[0,"J\x20"],"U"=>[0,"J\x25"],"V"=>[0,"J-"],"W"=>[0,"J."],"X"=>[0,"J\x2F"],"Y"=>[0,"J3"],"Z"=>[0,"J4"],"\x5B"=>[0,"J5"],"\x5C"=>[0,"J6"],"\x5D"=>[0,"J7"],"\x5E"=>[0,"J8"],"_"=>[0,"J9"],"\x60"=>[0,"J\x3D"],"a"=>[0,"JA"],"b"=>[0,"J_"],"c"=>[0,"Jb"],"d"=>[0,"Jd"],"e"=>[0,"Jf"],"f"=>[0,"Jg"],"g"=>[0,"Jh"],"h"=>[0,"Jl"],"i"=>[0,"Jm"],"j"=>[0,"Jn"],"k"=>[0,"Jp"],"l"=>[0,"Jr"],"m"=>[0,"Ju"],"n"=>[100,"J"],"o"=>[110,"J"],"p"=>[111,"J"],"q"=>[115,"J"],"r"=>[116,"J"],"s"=>[118,"J"],"t"=>[119,"J"],"u"=>[122,"J"],"v"=>[123,"J"],"w"=>[125,"J"],"x"=>[126,"J"],"y"=>[129,"J"],"z"=>[143,"J"],"\x7B"=>[148,"J"],"\x7C"=>[151,"J"],"\x7D"=>[153,"J"],"~"=>[83,"J"],"\x7F"=>[10,"J"],"\x80"=>[77,"K0"],"\x81"=>[18,"K0"],"\x82"=>[77,"K1"],"\x83"=>[18,"K1"],"\x84"=>[77,"K2"],"\x85"=>[18,"K2"],"\x86"=>[77,"Ka"],"\x87"=>[18,"Ka"],"\x88"=>[77,"Kc"],"\x89"=>[18,"Kc"],"\x8A"=>[77,"Ke"],"\x8B"=>[18,"Ke"],"\x8C"=>[77,"Ki"],"\x8D"=>[18,"Ki"],"\x8E"=>[77,"Ko"],"\x8F"=>[18,"Ko"],"\x90"=>[77,"Ks"],"\x91"=>[18,"Ks"],"\x92"=>[77,"Kt"],"\x93"=>[18,"Kt"],"\x94"=>[0,"K\x20"],"\x95"=>[0,"K\x25"],"\x96"=>[0,"K-"],"\x97"=>[0,"K."],"\x98"=>[0,"K\x2F"],"\x99"=>[0,"K3"],"\x9A"=>[0,"K4"],"\x9B"=>[0,"K5"],"\x9C"=>[0,"K6"],"\x9D"=>[0,"K7"],"\x9E"=>[0,"K8"],"\x9F"=>[0,"K9"],"\xA0"=>[0,"K\x3D"],"\xA1"=>[0,"KA"],"\xA2"=>[0,"K_"],"\xA3"=>[0,"Kb"],"\xA4"=>[0,"Kd"],"\xA5"=>[0,"Kf"],"\xA6"=>[0,"Kg"],"\xA7"=>[0,"Kh"],"\xA8"=>[0,"Kl"],"\xA9"=>[0,"Km"],"\xAA"=>[0,"Kn"],"\xAB"=>[0,"Kp"],"\xAC"=>[0,"Kr"],"\xAD"=>[0,"Ku"],"\xAE"=>[100,"K"],"\xAF"=>[110,"K"],"\xB0"=>[111,"K"],"\xB1"=>[115,"K"],"\xB2"=>[116,"K"],"\xB3"=>[118,"K"],"\xB4"=>[119,"K"],"\xB5"=>[122,"K"],"\xB6"=>[123,"K"],"\xB7"=>[125,"K"],"\xB8"=>[126,"K"],"\xB9"=>[129,"K"],"\xBA"=>[143,"K"],"\xBB"=>[148,"K"],"\xBC"=>[151,"K"],"\xBD"=>[153,"K"],"\xBE"=>[83,"K"],"\xBF"=>[10,"K"],"\xC0"=>[77,"L0"],"\xC1"=>[18,"L0"],"\xC2"=>[77,"L1"],"\xC3"=>[18,"L1"],"\xC4"=>[77,"L2"],"\xC5"=>[18,"L2"],"\xC6"=>[77,"La"],"\xC7"=>[18,"La"],"\xC8"=>[77,"Lc"],"\xC9"=>[18,"Lc"],"\xCA"=>[77,"Le"],"\xCB"=>[18,"Le"],"\xCC"=>[77,"Li"],"\xCD"=>[18,"Li"],"\xCE"=>[77,"Lo"],"\xCF"=>[18,"Lo"],"\xD0"=>[77,"Ls"],"\xD1"=>[18,"Ls"],"\xD2"=>[77,"Lt"],"\xD3"=>[18,"Lt"],"\xD4"=>[0,"L\x20"],"\xD5"=>[0,"L\x25"],"\xD6"=>[0,"L-"],"\xD7"=>[0,"L."],"\xD8"=>[0,"L\x2F"],"\xD9"=>[0,"L3"],"\xDA"=>[0,"L4"],"\xDB"=>[0,"L5"],"\xDC"=>[0,"L6"],"\xDD"=>[0,"L7"],"\xDE"=>[0,"L8"],"\xDF"=>[0,"L9"],"\xE0"=>[0,"L\x3D"],"\xE1"=>[0,"LA"],"\xE2"=>[0,"L_"],"\xE3"=>[0,"Lb"],"\xE4"=>[0,"Ld"],"\xE5"=>[0,"Lf"],"\xE6"=>[0,"Lg"],"\xE7"=>[0,"Lh"],"\xE8"=>[0,"Ll"],"\xE9"=>[0,"Lm"],"\xEA"=>[0,"Ln"],"\xEB"=>[0,"Lp"],"\xEC"=>[0,"Lr"],"\xED"=>[0,"Lu"],"\xEE"=>[100,"L"],"\xEF"=>[110,"L"],"\xF0"=>[111,"L"],"\xF1"=>[115,"L"],"\xF2"=>[116,"L"],"\xF3"=>[118,"L"],"\xF4"=>[119,"L"],"\xF5"=>[122,"L"],"\xF6"=>[123,"L"],"\xF7"=>[125,"L"],"\xF8"=>[126,"L"],"\xF9"=>[129,"L"],"\xFA"=>[143,"L"],"\xFB"=>[148,"L"],"\xFC"=>[151,"L"],"\xFD"=>[153,"L"],"\xFE"=>[83,"L"],"\xFF"=>[10,"L"],],["\x00"=>[94,"K0"],"\x01"=>[76,"K0"],"\x02"=>[104,"K0"],"\x03"=>[16,"K0"],"\x04"=>[94,"K1"],"\x05"=>[76,"K1"],"\x06"=>[104,"K1"],"\x07"=>[16,"K1"],"\x08"=>[94,"K2"],"\x09"=>[76,"K2"],"\x0A"=>[104,"K2"],"\x0B"=>[16,"K2"],"\x0C"=>[94,"Ka"],"\x0D"=>[76,"Ka"],"\x0E"=>[104,"Ka"],"\x0F"=>[16,"Ka"],"\x10"=>[94,"Kc"],"\x11"=>[76,"Kc"],"\x12"=>[104,"Kc"],"\x13"=>[16,"Kc"],"\x14"=>[94,"Ke"],"\x15"=>[76,"Ke"],"\x16"=>[104,"Ke"],"\x17"=>[16,"Ke"],"\x18"=>[94,"Ki"],"\x19"=>[76,"Ki"],"\x1A"=>[104,"Ki"],"\x1B"=>[16,"Ki"],"\x1C"=>[94,"Ko"],"\x1D"=>[76,"Ko"],"\x1E"=>[104,"Ko"],"\x1F"=>[16,"Ko"],"\x20"=>[94,"Ks"],"\x21"=>[76,"Ks"],"\x22"=>[104,"Ks"],"\x23"=>[16,"Ks"],"\x24"=>[94,"Kt"],"\x25"=>[76,"Kt"],"\x26"=>[104,"Kt"],"\x27"=>[16,"Kt"],"\x28"=>[77,"K\x20"],"\x29"=>[18,"K\x20"],"\x2A"=>[77,"K\x25"],"\x2B"=>[18,"K\x25"],"\x2C"=>[77,"K-"],"-"=>[18,"K-"],"."=>[77,"K."],"\x2F"=>[18,"K."],[77,"K\x2F"],[18,"K\x2F"],[77,"K3"],[18,"K3"],[77,"K4"],[18,"K4"],[77,"K5"],[18,"K5"],[77,"K6"],[18,"K6"],"\x3A"=>[77,"K7"],"\x3B"=>[18,"K7"],"\x3C"=>[77,"K8"],"\x3D"=>[18,"K8"],"\x3E"=>[77,"K9"],"\x3F"=>[18,"K9"],"\x40"=>[77,"K\x3D"],"A"=>[18,"K\x3D"],"B"=>[77,"KA"],"C"=>[18,"KA"],"D"=>[77,"K_"],"E"=>[18,"K_"],"F"=>[77,"Kb"],"G"=>[18,"Kb"],"H"=>[77,"Kd"],"I"=>[18,"Kd"],"J"=>[77,"Kf"],"K"=>[18,"Kf"],"L"=>[77,"Kg"],"M"=>[18,"Kg"],"N"=>[77,"Kh"],"O"=>[18,"Kh"],"P"=>[77,"Kl"],"Q"=>[18,"Kl"],"R"=>[77,"Km"],"S"=>[18,"Km"],"T"=>[77,"Kn"],"U"=>[18,"Kn"],"V"=>[77,"Kp"],"W"=>[18,"Kp"],"X"=>[77,"Kr"],"Y"=>[18,"Kr"],"Z"=>[77,"Ku"],"\x5B"=>[18,"Ku"],"\x5C"=>[0,"K\x3A"],"\x5D"=>[0,"KB"],"\x5E"=>[0,"KC"],"_"=>[0,"KD"],"\x60"=>[0,"KE"],"a"=>[0,"KF"],"b"=>[0,"KG"],"c"=>[0,"KH"],"d"=>[0,"KI"],"e"=>[0,"KJ"],"f"=>[0,"KK"],"g"=>[0,"KL"],"h"=>[0,"KM"],"i"=>[0,"KN"],"j"=>[0,"KO"],"k"=>[0,"KP"],"l"=>[0,"KQ"],"m"=>[0,"KR"],"n"=>[0,"KS"],"o"=>[0,"KT"],"p"=>[0,"KU"],"q"=>[0,"KV"],"r"=>[0,"KW"],"s"=>[0,"KY"],"t"=>[0,"Kj"],"u"=>[0,"Kk"],"v"=>[0,"Kq"],"w"=>[0,"Kv"],"x"=>[0,"Kw"],"y"=>[0,"Kx"],"z"=>[0,"Ky"],"\x7B"=>[0,"Kz"],"\x7C"=>[82,"K"],"\x7D"=>[87,"K"],"~"=>[130,"K"],"\x7F"=>[9,"K"],"\x80"=>[94,"L0"],"\x81"=>[76,"L0"],"\x82"=>[104,"L0"],"\x83"=>[16,"L0"],"\x84"=>[94,"L1"],"\x85"=>[76,"L1"],"\x86"=>[104,"L1"],"\x87"=>[16,"L1"],"\x88"=>[94,"L2"],"\x89"=>[76,"L2"],"\x8A"=>[104,"L2"],"\x8B"=>[16,"L2"],"\x8C"=>[94,"La"],"\x8D"=>[76,"La"],"\x8E"=>[104,"La"],"\x8F"=>[16,"La"],"\x90"=>[94,"Lc"],"\x91"=>[76,"Lc"],"\x92"=>[104,"Lc"],"\x93"=>[16,"Lc"],"\x94"=>[94,"Le"],"\x95"=>[76,"Le"],"\x96"=>[104,"Le"],"\x97"=>[16,"Le"],"\x98"=>[94,"Li"],"\x99"=>[76,"Li"],"\x9A"=>[104,"Li"],"\x9B"=>[16,"Li"],"\x9C"=>[94,"Lo"],"\x9D"=>[76,"Lo"],"\x9E"=>[104,"Lo"],"\x9F"=>[16,"Lo"],"\xA0"=>[94,"Ls"],"\xA1"=>[76,"Ls"],"\xA2"=>[104,"Ls"],"\xA3"=>[16,"Ls"],"\xA4"=>[94,"Lt"],"\xA5"=>[76,"Lt"],"\xA6"=>[104,"Lt"],"\xA7"=>[16,"Lt"],"\xA8"=>[77,"L\x20"],"\xA9"=>[18,"L\x20"],"\xAA"=>[77,"L\x25"],"\xAB"=>[18,"L\x25"],"\xAC"=>[77,"L-"],"\xAD"=>[18,"L-"],"\xAE"=>[77,"L."],"\xAF"=>[18,"L."],"\xB0"=>[77,"L\x2F"],"\xB1"=>[18,"L\x2F"],"\xB2"=>[77,"L3"],"\xB3"=>[18,"L3"],"\xB4"=>[77,"L4"],"\xB5"=>[18,"L4"],"\xB6"=>[77,"L5"],"\xB7"=>[18,"L5"],"\xB8"=>[77,"L6"],"\xB9"=>[18,"L6"],"\xBA"=>[77,"L7"],"\xBB"=>[18,"L7"],"\xBC"=>[77,"L8"],"\xBD"=>[18,"L8"],"\xBE"=>[77,"L9"],"\xBF"=>[18,"L9"],"\xC0"=>[77,"L\x3D"],"\xC1"=>[18,"L\x3D"],"\xC2"=>[77,"LA"],"\xC3"=>[18,"LA"],"\xC4"=>[77,"L_"],"\xC5"=>[18,"L_"],"\xC6"=>[77,"Lb"],"\xC7"=>[18,"Lb"],"\xC8"=>[77,"Ld"],"\xC9"=>[18,"Ld"],"\xCA"=>[77,"Lf"],"\xCB"=>[18,"Lf"],"\xCC"=>[77,"Lg"],"\xCD"=>[18,"Lg"],"\xCE"=>[77,"Lh"],"\xCF"=>[18,"Lh"],"\xD0"=>[77,"Ll"],"\xD1"=>[18,"Ll"],"\xD2"=>[77,"Lm"],"\xD3"=>[18,"Lm"],"\xD4"=>[77,"Ln"],"\xD5"=>[18,"Ln"],"\xD6"=>[77,"Lp"],"\xD7"=>[18,"Lp"],"\xD8"=>[77,"Lr"],"\xD9"=>[18,"Lr"],"\xDA"=>[77,"Lu"],"\xDB"=>[18,"Lu"],"\xDC"=>[0,"L\x3A"],"\xDD"=>[0,"LB"],"\xDE"=>[0,"LC"],"\xDF"=>[0,"LD"],"\xE0"=>[0,"LE"],"\xE1"=>[0,"LF"],"\xE2"=>[0,"LG"],"\xE3"=>[0,"LH"],"\xE4"=>[0,"LI"],"\xE5"=>[0,"LJ"],"\xE6"=>[0,"LK"],"\xE7"=>[0,"LL"],"\xE8"=>[0,"LM"],"\xE9"=>[0,"LN"],"\xEA"=>[0,"LO"],"\xEB"=>[0,"LP"],"\xEC"=>[0,"LQ"],"\xED"=>[0,"LR"],"\xEE"=>[0,"LS"],"\xEF"=>[0,"LT"],"\xF0"=>[0,"LU"],"\xF1"=>[0,"LV"],"\xF2"=>[0,"LW"],"\xF3"=>[0,"LY"],"\xF4"=>[0,"Lj"],"\xF5"=>[0,"Lk"],"\xF6"=>[0,"Lq"],"\xF7"=>[0,"Lv"],"\xF8"=>[0,"Lw"],"\xF9"=>[0,"Lx"],"\xFA"=>[0,"Ly"],"\xFB"=>[0,"Lz"],"\xFC"=>[82,"L"],"\xFD"=>[87,"L"],"\xFE"=>[130,"L"],"\xFF"=>[9,"L"],],["\x00"=>[94,"M0"],"\x01"=>[76,"M0"],"\x02"=>[104,"M0"],"\x03"=>[16,"M0"],"\x04"=>[94,"M1"],"\x05"=>[76,"M1"],"\x06"=>[104,"M1"],"\x07"=>[16,"M1"],"\x08"=>[94,"M2"],"\x09"=>[76,"M2"],"\x0A"=>[104,"M2"],"\x0B"=>[16,"M2"],"\x0C"=>[94,"Ma"],"\x0D"=>[76,"Ma"],"\x0E"=>[104,"Ma"],"\x0F"=>[16,"Ma"],"\x10"=>[94,"Mc"],"\x11"=>[76,"Mc"],"\x12"=>[104,"Mc"],"\x13"=>[16,"Mc"],"\x14"=>[94,"Me"],"\x15"=>[76,"Me"],"\x16"=>[104,"Me"],"\x17"=>[16,"Me"],"\x18"=>[94,"Mi"],"\x19"=>[76,"Mi"],"\x1A"=>[104,"Mi"],"\x1B"=>[16,"Mi"],"\x1C"=>[94,"Mo"],"\x1D"=>[76,"Mo"],"\x1E"=>[104,"Mo"],"\x1F"=>[16,"Mo"],"\x20"=>[94,"Ms"],"\x21"=>[76,"Ms"],"\x22"=>[104,"Ms"],"\x23"=>[16,"Ms"],"\x24"=>[94,"Mt"],"\x25"=>[76,"Mt"],"\x26"=>[104,"Mt"],"\x27"=>[16,"Mt"],"\x28"=>[77,"M\x20"],"\x29"=>[18,"M\x20"],"\x2A"=>[77,"M\x25"],"\x2B"=>[18,"M\x25"],"\x2C"=>[77,"M-"],"-"=>[18,"M-"],"."=>[77,"M."],"\x2F"=>[18,"M."],[77,"M\x2F"],[18,"M\x2F"],[77,"M3"],[18,"M3"],[77,"M4"],[18,"M4"],[77,"M5"],[18,"M5"],[77,"M6"],[18,"M6"],"\x3A"=>[77,"M7"],"\x3B"=>[18,"M7"],"\x3C"=>[77,"M8"],"\x3D"=>[18,"M8"],"\x3E"=>[77,"M9"],"\x3F"=>[18,"M9"],"\x40"=>[77,"M\x3D"],"A"=>[18,"M\x3D"],"B"=>[77,"MA"],"C"=>[18,"MA"],"D"=>[77,"M_"],"E"=>[18,"M_"],"F"=>[77,"Mb"],"G"=>[18,"Mb"],"H"=>[77,"Md"],"I"=>[18,"Md"],"J"=>[77,"Mf"],"K"=>[18,"Mf"],"L"=>[77,"Mg"],"M"=>[18,"Mg"],"N"=>[77,"Mh"],"O"=>[18,"Mh"],"P"=>[77,"Ml"],"Q"=>[18,"Ml"],"R"=>[77,"Mm"],"S"=>[18,"Mm"],"T"=>[77,"Mn"],"U"=>[18,"Mn"],"V"=>[77,"Mp"],"W"=>[18,"Mp"],"X"=>[77,"Mr"],"Y"=>[18,"Mr"],"Z"=>[77,"Mu"],"\x5B"=>[18,"Mu"],"\x5C"=>[0,"M\x3A"],"\x5D"=>[0,"MB"],"\x5E"=>[0,"MC"],"_"=>[0,"MD"],"\x60"=>[0,"ME"],"a"=>[0,"MF"],"b"=>[0,"MG"],"c"=>[0,"MH"],"d"=>[0,"MI"],"e"=>[0,"MJ"],"f"=>[0,"MK"],"g"=>[0,"ML"],"h"=>[0,"MM"],"i"=>[0,"MN"],"j"=>[0,"MO"],"k"=>[0,"MP"],"l"=>[0,"MQ"],"m"=>[0,"MR"],"n"=>[0,"MS"],"o"=>[0,"MT"],"p"=>[0,"MU"],"q"=>[0,"MV"],"r"=>[0,"MW"],"s"=>[0,"MY"],"t"=>[0,"Mj"],"u"=>[0,"Mk"],"v"=>[0,"Mq"],"w"=>[0,"Mv"],"x"=>[0,"Mw"],"y"=>[0,"Mx"],"z"=>[0,"My"],"\x7B"=>[0,"Mz"],"\x7C"=>[82,"M"],"\x7D"=>[87,"M"],"~"=>[130,"M"],"\x7F"=>[9,"M"],"\x80"=>[94,"N0"],"\x81"=>[76,"N0"],"\x82"=>[104,"N0"],"\x83"=>[16,"N0"],"\x84"=>[94,"N1"],"\x85"=>[76,"N1"],"\x86"=>[104,"N1"],"\x87"=>[16,"N1"],"\x88"=>[94,"N2"],"\x89"=>[76,"N2"],"\x8A"=>[104,"N2"],"\x8B"=>[16,"N2"],"\x8C"=>[94,"Na"],"\x8D"=>[76,"Na"],"\x8E"=>[104,"Na"],"\x8F"=>[16,"Na"],"\x90"=>[94,"Nc"],"\x91"=>[76,"Nc"],"\x92"=>[104,"Nc"],"\x93"=>[16,"Nc"],"\x94"=>[94,"Ne"],"\x95"=>[76,"Ne"],"\x96"=>[104,"Ne"],"\x97"=>[16,"Ne"],"\x98"=>[94,"Ni"],"\x99"=>[76,"Ni"],"\x9A"=>[104,"Ni"],"\x9B"=>[16,"Ni"],"\x9C"=>[94,"No"],"\x9D"=>[76,"No"],"\x9E"=>[104,"No"],"\x9F"=>[16,"No"],"\xA0"=>[94,"Ns"],"\xA1"=>[76,"Ns"],"\xA2"=>[104,"Ns"],"\xA3"=>[16,"Ns"],"\xA4"=>[94,"Nt"],"\xA5"=>[76,"Nt"],"\xA6"=>[104,"Nt"],"\xA7"=>[16,"Nt"],"\xA8"=>[77,"N\x20"],"\xA9"=>[18,"N\x20"],"\xAA"=>[77,"N\x25"],"\xAB"=>[18,"N\x25"],"\xAC"=>[77,"N-"],"\xAD"=>[18,"N-"],"\xAE"=>[77,"N."],"\xAF"=>[18,"N."],"\xB0"=>[77,"N\x2F"],"\xB1"=>[18,"N\x2F"],"\xB2"=>[77,"N3"],"\xB3"=>[18,"N3"],"\xB4"=>[77,"N4"],"\xB5"=>[18,"N4"],"\xB6"=>[77,"N5"],"\xB7"=>[18,"N5"],"\xB8"=>[77,"N6"],"\xB9"=>[18,"N6"],"\xBA"=>[77,"N7"],"\xBB"=>[18,"N7"],"\xBC"=>[77,"N8"],"\xBD"=>[18,"N8"],"\xBE"=>[77,"N9"],"\xBF"=>[18,"N9"],"\xC0"=>[77,"N\x3D"],"\xC1"=>[18,"N\x3D"],"\xC2"=>[77,"NA"],"\xC3"=>[18,"NA"],"\xC4"=>[77,"N_"],"\xC5"=>[18,"N_"],"\xC6"=>[77,"Nb"],"\xC7"=>[18,"Nb"],"\xC8"=>[77,"Nd"],"\xC9"=>[18,"Nd"],"\xCA"=>[77,"Nf"],"\xCB"=>[18,"Nf"],"\xCC"=>[77,"Ng"],"\xCD"=>[18,"Ng"],"\xCE"=>[77,"Nh"],"\xCF"=>[18,"Nh"],"\xD0"=>[77,"Nl"],"\xD1"=>[18,"Nl"],"\xD2"=>[77,"Nm"],"\xD3"=>[18,"Nm"],"\xD4"=>[77,"Nn"],"\xD5"=>[18,"Nn"],"\xD6"=>[77,"Np"],"\xD7"=>[18,"Np"],"\xD8"=>[77,"Nr"],"\xD9"=>[18,"Nr"],"\xDA"=>[77,"Nu"],"\xDB"=>[18,"Nu"],"\xDC"=>[0,"N\x3A"],"\xDD"=>[0,"NB"],"\xDE"=>[0,"NC"],"\xDF"=>[0,"ND"],"\xE0"=>[0,"NE"],"\xE1"=>[0,"NF"],"\xE2"=>[0,"NG"],"\xE3"=>[0,"NH"],"\xE4"=>[0,"NI"],"\xE5"=>[0,"NJ"],"\xE6"=>[0,"NK"],"\xE7"=>[0,"NL"],"\xE8"=>[0,"NM"],"\xE9"=>[0,"NN"],"\xEA"=>[0,"NO"],"\xEB"=>[0,"NP"],"\xEC"=>[0,"NQ"],"\xED"=>[0,"NR"],"\xEE"=>[0,"NS"],"\xEF"=>[0,"NT"],"\xF0"=>[0,"NU"],"\xF1"=>[0,"NV"],"\xF2"=>[0,"NW"],"\xF3"=>[0,"NY"],"\xF4"=>[0,"Nj"],"\xF5"=>[0,"Nk"],"\xF6"=>[0,"Nq"],"\xF7"=>[0,"Nv"],"\xF8"=>[0,"Nw"],"\xF9"=>[0,"Nx"],"\xFA"=>[0,"Ny"],"\xFB"=>[0,"Nz"],"\xFC"=>[82,"N"],"\xFD"=>[87,"N"],"\xFE"=>[130,"N"],"\xFF"=>[9,"N"],],["\x00"=>[77,"M0"],"\x01"=>[18,"M0"],"\x02"=>[77,"M1"],"\x03"=>[18,"M1"],"\x04"=>[77,"M2"],"\x05"=>[18,"M2"],"\x06"=>[77,"Ma"],"\x07"=>[18,"Ma"],"\x08"=>[77,"Mc"],"\x09"=>[18,"Mc"],"\x0A"=>[77,"Me"],"\x0B"=>[18,"Me"],"\x0C"=>[77,"Mi"],"\x0D"=>[18,"Mi"],"\x0E"=>[77,"Mo"],"\x0F"=>[18,"Mo"],"\x10"=>[77,"Ms"],"\x11"=>[18,"Ms"],"\x12"=>[77,"Mt"],"\x13"=>[18,"Mt"],"\x14"=>[0,"M\x20"],"\x15"=>[0,"M\x25"],"\x16"=>[0,"M-"],"\x17"=>[0,"M."],"\x18"=>[0,"M\x2F"],"\x19"=>[0,"M3"],"\x1A"=>[0,"M4"],"\x1B"=>[0,"M5"],"\x1C"=>[0,"M6"],"\x1D"=>[0,"M7"],"\x1E"=>[0,"M8"],"\x1F"=>[0,"M9"],"\x20"=>[0,"M\x3D"],"\x21"=>[0,"MA"],"\x22"=>[0,"M_"],"\x23"=>[0,"Mb"],"\x24"=>[0,"Md"],"\x25"=>[0,"Mf"],"\x26"=>[0,"Mg"],"\x27"=>[0,"Mh"],"\x28"=>[0,"Ml"],"\x29"=>[0,"Mm"],"\x2A"=>[0,"Mn"],"\x2B"=>[0,"Mp"],"\x2C"=>[0,"Mr"],"-"=>[0,"Mu"],"."=>[100,"M"],"\x2F"=>[110,"M"],[111,"M"],[115,"M"],[116,"M"],[118,"M"],[119,"M"],[122,"M"],[123,"M"],[125,"M"],[126,"M"],[129,"M"],"\x3A"=>[143,"M"],"\x3B"=>[148,"M"],"\x3C"=>[151,"M"],"\x3D"=>[153,"M"],"\x3E"=>[83,"M"],"\x3F"=>[10,"M"],"\x40"=>[77,"N0"],"A"=>[18,"N0"],"B"=>[77,"N1"],"C"=>[18,"N1"],"D"=>[77,"N2"],"E"=>[18,"N2"],"F"=>[77,"Na"],"G"=>[18,"Na"],"H"=>[77,"Nc"],"I"=>[18,"Nc"],"J"=>[77,"Ne"],"K"=>[18,"Ne"],"L"=>[77,"Ni"],"M"=>[18,"Ni"],"N"=>[77,"No"],"O"=>[18,"No"],"P"=>[77,"Ns"],"Q"=>[18,"Ns"],"R"=>[77,"Nt"],"S"=>[18,"Nt"],"T"=>[0,"N\x20"],"U"=>[0,"N\x25"],"V"=>[0,"N-"],"W"=>[0,"N."],"X"=>[0,"N\x2F"],"Y"=>[0,"N3"],"Z"=>[0,"N4"],"\x5B"=>[0,"N5"],"\x5C"=>[0,"N6"],"\x5D"=>[0,"N7"],"\x5E"=>[0,"N8"],"_"=>[0,"N9"],"\x60"=>[0,"N\x3D"],"a"=>[0,"NA"],"b"=>[0,"N_"],"c"=>[0,"Nb"],"d"=>[0,"Nd"],"e"=>[0,"Nf"],"f"=>[0,"Ng"],"g"=>[0,"Nh"],"h"=>[0,"Nl"],"i"=>[0,"Nm"],"j"=>[0,"Nn"],"k"=>[0,"Np"],"l"=>[0,"Nr"],"m"=>[0,"Nu"],"n"=>[100,"N"],"o"=>[110,"N"],"p"=>[111,"N"],"q"=>[115,"N"],"r"=>[116,"N"],"s"=>[118,"N"],"t"=>[119,"N"],"u"=>[122,"N"],"v"=>[123,"N"],"w"=>[125,"N"],"x"=>[126,"N"],"y"=>[129,"N"],"z"=>[143,"N"],"\x7B"=>[148,"N"],"\x7C"=>[151,"N"],"\x7D"=>[153,"N"],"~"=>[83,"N"],"\x7F"=>[10,"N"],"\x80"=>[77,"O0"],"\x81"=>[18,"O0"],"\x82"=>[77,"O1"],"\x83"=>[18,"O1"],"\x84"=>[77,"O2"],"\x85"=>[18,"O2"],"\x86"=>[77,"Oa"],"\x87"=>[18,"Oa"],"\x88"=>[77,"Oc"],"\x89"=>[18,"Oc"],"\x8A"=>[77,"Oe"],"\x8B"=>[18,"Oe"],"\x8C"=>[77,"Oi"],"\x8D"=>[18,"Oi"],"\x8E"=>[77,"Oo"],"\x8F"=>[18,"Oo"],"\x90"=>[77,"Os"],"\x91"=>[18,"Os"],"\x92"=>[77,"Ot"],"\x93"=>[18,"Ot"],"\x94"=>[0,"O\x20"],"\x95"=>[0,"O\x25"],"\x96"=>[0,"O-"],"\x97"=>[0,"O."],"\x98"=>[0,"O\x2F"],"\x99"=>[0,"O3"],"\x9A"=>[0,"O4"],"\x9B"=>[0,"O5"],"\x9C"=>[0,"O6"],"\x9D"=>[0,"O7"],"\x9E"=>[0,"O8"],"\x9F"=>[0,"O9"],"\xA0"=>[0,"O\x3D"],"\xA1"=>[0,"OA"],"\xA2"=>[0,"O_"],"\xA3"=>[0,"Ob"],"\xA4"=>[0,"Od"],"\xA5"=>[0,"Of"],"\xA6"=>[0,"Og"],"\xA7"=>[0,"Oh"],"\xA8"=>[0,"Ol"],"\xA9"=>[0,"Om"],"\xAA"=>[0,"On"],"\xAB"=>[0,"Op"],"\xAC"=>[0,"Or"],"\xAD"=>[0,"Ou"],"\xAE"=>[100,"O"],"\xAF"=>[110,"O"],"\xB0"=>[111,"O"],"\xB1"=>[115,"O"],"\xB2"=>[116,"O"],"\xB3"=>[118,"O"],"\xB4"=>[119,"O"],"\xB5"=>[122,"O"],"\xB6"=>[123,"O"],"\xB7"=>[125,"O"],"\xB8"=>[126,"O"],"\xB9"=>[129,"O"],"\xBA"=>[143,"O"],"\xBB"=>[148,"O"],"\xBC"=>[151,"O"],"\xBD"=>[153,"O"],"\xBE"=>[83,"O"],"\xBF"=>[10,"O"],"\xC0"=>[77,"P0"],"\xC1"=>[18,"P0"],"\xC2"=>[77,"P1"],"\xC3"=>[18,"P1"],"\xC4"=>[77,"P2"],"\xC5"=>[18,"P2"],"\xC6"=>[77,"Pa"],"\xC7"=>[18,"Pa"],"\xC8"=>[77,"Pc"],"\xC9"=>[18,"Pc"],"\xCA"=>[77,"Pe"],"\xCB"=>[18,"Pe"],"\xCC"=>[77,"Pi"],"\xCD"=>[18,"Pi"],"\xCE"=>[77,"Po"],"\xCF"=>[18,"Po"],"\xD0"=>[77,"Ps"],"\xD1"=>[18,"Ps"],"\xD2"=>[77,"Pt"],"\xD3"=>[18,"Pt"],"\xD4"=>[0,"P\x20"],"\xD5"=>[0,"P\x25"],"\xD6"=>[0,"P-"],"\xD7"=>[0,"P."],"\xD8"=>[0,"P\x2F"],"\xD9"=>[0,"P3"],"\xDA"=>[0,"P4"],"\xDB"=>[0,"P5"],"\xDC"=>[0,"P6"],"\xDD"=>[0,"P7"],"\xDE"=>[0,"P8"],"\xDF"=>[0,"P9"],"\xE0"=>[0,"P\x3D"],"\xE1"=>[0,"PA"],"\xE2"=>[0,"P_"],"\xE3"=>[0,"Pb"],"\xE4"=>[0,"Pd"],"\xE5"=>[0,"Pf"],"\xE6"=>[0,"Pg"],"\xE7"=>[0,"Ph"],"\xE8"=>[0,"Pl"],"\xE9"=>[0,"Pm"],"\xEA"=>[0,"Pn"],"\xEB"=>[0,"Pp"],"\xEC"=>[0,"Pr"],"\xED"=>[0,"Pu"],"\xEE"=>[100,"P"],"\xEF"=>[110,"P"],"\xF0"=>[111,"P"],"\xF1"=>[115,"P"],"\xF2"=>[116,"P"],"\xF3"=>[118,"P"],"\xF4"=>[119,"P"],"\xF5"=>[122,"P"],"\xF6"=>[123,"P"],"\xF7"=>[125,"P"],"\xF8"=>[126,"P"],"\xF9"=>[129,"P"],"\xFA"=>[143,"P"],"\xFB"=>[148,"P"],"\xFC"=>[151,"P"],"\xFD"=>[153,"P"],"\xFE"=>[83,"P"],"\xFF"=>[10,"P"],],["\x00"=>[0,"M0"],"\x01"=>[0,"M1"],"\x02"=>[0,"M2"],"\x03"=>[0,"Ma"],"\x04"=>[0,"Mc"],"\x05"=>[0,"Me"],"\x06"=>[0,"Mi"],"\x07"=>[0,"Mo"],"\x08"=>[0,"Ms"],"\x09"=>[0,"Mt"],"\x0A"=>[73,"M"],"\x0B"=>[88,"M"],"\x0C"=>[89,"M"],"\x0D"=>[96,"M"],"\x0E"=>[97,"M"],"\x0F"=>[99,"M"],"\x10"=>[106,"M"],"\x11"=>[136,"M"],"\x12"=>[139,"M"],"\x13"=>[141,"M"],"\x14"=>[145,"M"],"\x15"=>[147,"M"],"\x16"=>[149,"M"],"\x17"=>[101,"M"],"\x18"=>[112,"M"],"\x19"=>[117,"M"],"\x1A"=>[120,"M"],"\x1B"=>[124,"M"],"\x1C"=>[127,"M"],"\x1D"=>[144,"M"],"\x1E"=>[152,"M"],"\x1F"=>[11,"M"],"\x20"=>[0,"N0"],"\x21"=>[0,"N1"],"\x22"=>[0,"N2"],"\x23"=>[0,"Na"],"\x24"=>[0,"Nc"],"\x25"=>[0,"Ne"],"\x26"=>[0,"Ni"],"\x27"=>[0,"No"],"\x28"=>[0,"Ns"],"\x29"=>[0,"Nt"],"\x2A"=>[73,"N"],"\x2B"=>[88,"N"],"\x2C"=>[89,"N"],"-"=>[96,"N"],"."=>[97,"N"],"\x2F"=>[99,"N"],[106,"N"],[136,"N"],[139,"N"],[141,"N"],[145,"N"],[147,"N"],[149,"N"],[101,"N"],[112,"N"],[117,"N"],"\x3A"=>[120,"N"],"\x3B"=>[124,"N"],"\x3C"=>[127,"N"],"\x3D"=>[144,"N"],"\x3E"=>[152,"N"],"\x3F"=>[11,"N"],"\x40"=>[0,"O0"],"A"=>[0,"O1"],"B"=>[0,"O2"],"C"=>[0,"Oa"],"D"=>[0,"Oc"],"E"=>[0,"Oe"],"F"=>[0,"Oi"],"G"=>[0,"Oo"],"H"=>[0,"Os"],"I"=>[0,"Ot"],"J"=>[73,"O"],"K"=>[88,"O"],"L"=>[89,"O"],"M"=>[96,"O"],"N"=>[97,"O"],"O"=>[99,"O"],"P"=>[106,"O"],"Q"=>[136,"O"],"R"=>[139,"O"],"S"=>[141,"O"],"T"=>[145,"O"],"U"=>[147,"O"],"V"=>[149,"O"],"W"=>[101,"O"],"X"=>[112,"O"],"Y"=>[117,"O"],"Z"=>[120,"O"],"\x5B"=>[124,"O"],"\x5C"=>[127,"O"],"\x5D"=>[144,"O"],"\x5E"=>[152,"O"],"_"=>[11,"O"],"\x60"=>[0,"P0"],"a"=>[0,"P1"],"b"=>[0,"P2"],"c"=>[0,"Pa"],"d"=>[0,"Pc"],"e"=>[0,"Pe"],"f"=>[0,"Pi"],"g"=>[0,"Po"],"h"=>[0,"Ps"],"i"=>[0,"Pt"],"j"=>[73,"P"],"k"=>[88,"P"],"l"=>[89,"P"],"m"=>[96,"P"],"n"=>[97,"P"],"o"=>[99,"P"],"p"=>[106,"P"],"q"=>[136,"P"],"r"=>[139,"P"],"s"=>[141,"P"],"t"=>[145,"P"],"u"=>[147,"P"],"v"=>[149,"P"],"w"=>[101,"P"],"x"=>[112,"P"],"y"=>[117,"P"],"z"=>[120,"P"],"\x7B"=>[124,"P"],"\x7C"=>[127,"P"],"\x7D"=>[144,"P"],"~"=>[152,"P"],"\x7F"=>[11,"P"],"\x80"=>[0,"Q0"],"\x81"=>[0,"Q1"],"\x82"=>[0,"Q2"],"\x83"=>[0,"Qa"],"\x84"=>[0,"Qc"],"\x85"=>[0,"Qe"],"\x86"=>[0,"Qi"],"\x87"=>[0,"Qo"],"\x88"=>[0,"Qs"],"\x89"=>[0,"Qt"],"\x8A"=>[73,"Q"],"\x8B"=>[88,"Q"],"\x8C"=>[89,"Q"],"\x8D"=>[96,"Q"],"\x8E"=>[97,"Q"],"\x8F"=>[99,"Q"],"\x90"=>[106,"Q"],"\x91"=>[136,"Q"],"\x92"=>[139,"Q"],"\x93"=>[141,"Q"],"\x94"=>[145,"Q"],"\x95"=>[147,"Q"],"\x96"=>[149,"Q"],"\x97"=>[101,"Q"],"\x98"=>[112,"Q"],"\x99"=>[117,"Q"],"\x9A"=>[120,"Q"],"\x9B"=>[124,"Q"],"\x9C"=>[127,"Q"],"\x9D"=>[144,"Q"],"\x9E"=>[152,"Q"],"\x9F"=>[11,"Q"],"\xA0"=>[0,"R0"],"\xA1"=>[0,"R1"],"\xA2"=>[0,"R2"],"\xA3"=>[0,"Ra"],"\xA4"=>[0,"Rc"],"\xA5"=>[0,"Re"],"\xA6"=>[0,"Ri"],"\xA7"=>[0,"Ro"],"\xA8"=>[0,"Rs"],"\xA9"=>[0,"Rt"],"\xAA"=>[73,"R"],"\xAB"=>[88,"R"],"\xAC"=>[89,"R"],"\xAD"=>[96,"R"],"\xAE"=>[97,"R"],"\xAF"=>[99,"R"],"\xB0"=>[106,"R"],"\xB1"=>[136,"R"],"\xB2"=>[139,"R"],"\xB3"=>[141,"R"],"\xB4"=>[145,"R"],"\xB5"=>[147,"R"],"\xB6"=>[149,"R"],"\xB7"=>[101,"R"],"\xB8"=>[112,"R"],"\xB9"=>[117,"R"],"\xBA"=>[120,"R"],"\xBB"=>[124,"R"],"\xBC"=>[127,"R"],"\xBD"=>[144,"R"],"\xBE"=>[152,"R"],"\xBF"=>[11,"R"],"\xC0"=>[0,"S0"],"\xC1"=>[0,"S1"],"\xC2"=>[0,"S2"],"\xC3"=>[0,"Sa"],"\xC4"=>[0,"Sc"],"\xC5"=>[0,"Se"],"\xC6"=>[0,"Si"],"\xC7"=>[0,"So"],"\xC8"=>[0,"Ss"],"\xC9"=>[0,"St"],"\xCA"=>[73,"S"],"\xCB"=>[88,"S"],"\xCC"=>[89,"S"],"\xCD"=>[96,"S"],"\xCE"=>[97,"S"],"\xCF"=>[99,"S"],"\xD0"=>[106,"S"],"\xD1"=>[136,"S"],"\xD2"=>[139,"S"],"\xD3"=>[141,"S"],"\xD4"=>[145,"S"],"\xD5"=>[147,"S"],"\xD6"=>[149,"S"],"\xD7"=>[101,"S"],"\xD8"=>[112,"S"],"\xD9"=>[117,"S"],"\xDA"=>[120,"S"],"\xDB"=>[124,"S"],"\xDC"=>[127,"S"],"\xDD"=>[144,"S"],"\xDE"=>[152,"S"],"\xDF"=>[11,"S"],"\xE0"=>[0,"T0"],"\xE1"=>[0,"T1"],"\xE2"=>[0,"T2"],"\xE3"=>[0,"Ta"],"\xE4"=>[0,"Tc"],"\xE5"=>[0,"Te"],"\xE6"=>[0,"Ti"],"\xE7"=>[0,"To"],"\xE8"=>[0,"Ts"],"\xE9"=>[0,"Tt"],"\xEA"=>[73,"T"],"\xEB"=>[88,"T"],"\xEC"=>[89,"T"],"\xED"=>[96,"T"],"\xEE"=>[97,"T"],"\xEF"=>[99,"T"],"\xF0"=>[106,"T"],"\xF1"=>[136,"T"],"\xF2"=>[139,"T"],"\xF3"=>[141,"T"],"\xF4"=>[145,"T"],"\xF5"=>[147,"T"],"\xF6"=>[149,"T"],"\xF7"=>[101,"T"],"\xF8"=>[112,"T"],"\xF9"=>[117,"T"],"\xFA"=>[120,"T"],"\xFB"=>[124,"T"],"\xFC"=>[127,"T"],"\xFD"=>[144,"T"],"\xFE"=>[152,"T"],"\xFF"=>[11,"T"],],["\x00"=>[94,"O0"],"\x01"=>[76,"O0"],"\x02"=>[104,"O0"],"\x03"=>[16,"O0"],"\x04"=>[94,"O1"],"\x05"=>[76,"O1"],"\x06"=>[104,"O1"],"\x07"=>[16,"O1"],"\x08"=>[94,"O2"],"\x09"=>[76,"O2"],"\x0A"=>[104,"O2"],"\x0B"=>[16,"O2"],"\x0C"=>[94,"Oa"],"\x0D"=>[76,"Oa"],"\x0E"=>[104,"Oa"],"\x0F"=>[16,"Oa"],"\x10"=>[94,"Oc"],"\x11"=>[76,"Oc"],"\x12"=>[104,"Oc"],"\x13"=>[16,"Oc"],"\x14"=>[94,"Oe"],"\x15"=>[76,"Oe"],"\x16"=>[104,"Oe"],"\x17"=>[16,"Oe"],"\x18"=>[94,"Oi"],"\x19"=>[76,"Oi"],"\x1A"=>[104,"Oi"],"\x1B"=>[16,"Oi"],"\x1C"=>[94,"Oo"],"\x1D"=>[76,"Oo"],"\x1E"=>[104,"Oo"],"\x1F"=>[16,"Oo"],"\x20"=>[94,"Os"],"\x21"=>[76,"Os"],"\x22"=>[104,"Os"],"\x23"=>[16,"Os"],"\x24"=>[94,"Ot"],"\x25"=>[76,"Ot"],"\x26"=>[104,"Ot"],"\x27"=>[16,"Ot"],"\x28"=>[77,"O\x20"],"\x29"=>[18,"O\x20"],"\x2A"=>[77,"O\x25"],"\x2B"=>[18,"O\x25"],"\x2C"=>[77,"O-"],"-"=>[18,"O-"],"."=>[77,"O."],"\x2F"=>[18,"O."],[77,"O\x2F"],[18,"O\x2F"],[77,"O3"],[18,"O3"],[77,"O4"],[18,"O4"],[77,"O5"],[18,"O5"],[77,"O6"],[18,"O6"],"\x3A"=>[77,"O7"],"\x3B"=>[18,"O7"],"\x3C"=>[77,"O8"],"\x3D"=>[18,"O8"],"\x3E"=>[77,"O9"],"\x3F"=>[18,"O9"],"\x40"=>[77,"O\x3D"],"A"=>[18,"O\x3D"],"B"=>[77,"OA"],"C"=>[18,"OA"],"D"=>[77,"O_"],"E"=>[18,"O_"],"F"=>[77,"Ob"],"G"=>[18,"Ob"],"H"=>[77,"Od"],"I"=>[18,"Od"],"J"=>[77,"Of"],"K"=>[18,"Of"],"L"=>[77,"Og"],"M"=>[18,"Og"],"N"=>[77,"Oh"],"O"=>[18,"Oh"],"P"=>[77,"Ol"],"Q"=>[18,"Ol"],"R"=>[77,"Om"],"S"=>[18,"Om"],"T"=>[77,"On"],"U"=>[18,"On"],"V"=>[77,"Op"],"W"=>[18,"Op"],"X"=>[77,"Or"],"Y"=>[18,"Or"],"Z"=>[77,"Ou"],"\x5B"=>[18,"Ou"],"\x5C"=>[0,"O\x3A"],"\x5D"=>[0,"OB"],"\x5E"=>[0,"OC"],"_"=>[0,"OD"],"\x60"=>[0,"OE"],"a"=>[0,"OF"],"b"=>[0,"OG"],"c"=>[0,"OH"],"d"=>[0,"OI"],"e"=>[0,"OJ"],"f"=>[0,"OK"],"g"=>[0,"OL"],"h"=>[0,"OM"],"i"=>[0,"ON"],"j"=>[0,"OO"],"k"=>[0,"OP"],"l"=>[0,"OQ"],"m"=>[0,"OR"],"n"=>[0,"OS"],"o"=>[0,"OT"],"p"=>[0,"OU"],"q"=>[0,"OV"],"r"=>[0,"OW"],"s"=>[0,"OY"],"t"=>[0,"Oj"],"u"=>[0,"Ok"],"v"=>[0,"Oq"],"w"=>[0,"Ov"],"x"=>[0,"Ow"],"y"=>[0,"Ox"],"z"=>[0,"Oy"],"\x7B"=>[0,"Oz"],"\x7C"=>[82,"O"],"\x7D"=>[87,"O"],"~"=>[130,"O"],"\x7F"=>[9,"O"],"\x80"=>[94,"P0"],"\x81"=>[76,"P0"],"\x82"=>[104,"P0"],"\x83"=>[16,"P0"],"\x84"=>[94,"P1"],"\x85"=>[76,"P1"],"\x86"=>[104,"P1"],"\x87"=>[16,"P1"],"\x88"=>[94,"P2"],"\x89"=>[76,"P2"],"\x8A"=>[104,"P2"],"\x8B"=>[16,"P2"],"\x8C"=>[94,"Pa"],"\x8D"=>[76,"Pa"],"\x8E"=>[104,"Pa"],"\x8F"=>[16,"Pa"],"\x90"=>[94,"Pc"],"\x91"=>[76,"Pc"],"\x92"=>[104,"Pc"],"\x93"=>[16,"Pc"],"\x94"=>[94,"Pe"],"\x95"=>[76,"Pe"],"\x96"=>[104,"Pe"],"\x97"=>[16,"Pe"],"\x98"=>[94,"Pi"],"\x99"=>[76,"Pi"],"\x9A"=>[104,"Pi"],"\x9B"=>[16,"Pi"],"\x9C"=>[94,"Po"],"\x9D"=>[76,"Po"],"\x9E"=>[104,"Po"],"\x9F"=>[16,"Po"],"\xA0"=>[94,"Ps"],"\xA1"=>[76,"Ps"],"\xA2"=>[104,"Ps"],"\xA3"=>[16,"Ps"],"\xA4"=>[94,"Pt"],"\xA5"=>[76,"Pt"],"\xA6"=>[104,"Pt"],"\xA7"=>[16,"Pt"],"\xA8"=>[77,"P\x20"],"\xA9"=>[18,"P\x20"],"\xAA"=>[77,"P\x25"],"\xAB"=>[18,"P\x25"],"\xAC"=>[77,"P-"],"\xAD"=>[18,"P-"],"\xAE"=>[77,"P."],"\xAF"=>[18,"P."],"\xB0"=>[77,"P\x2F"],"\xB1"=>[18,"P\x2F"],"\xB2"=>[77,"P3"],"\xB3"=>[18,"P3"],"\xB4"=>[77,"P4"],"\xB5"=>[18,"P4"],"\xB6"=>[77,"P5"],"\xB7"=>[18,"P5"],"\xB8"=>[77,"P6"],"\xB9"=>[18,"P6"],"\xBA"=>[77,"P7"],"\xBB"=>[18,"P7"],"\xBC"=>[77,"P8"],"\xBD"=>[18,"P8"],"\xBE"=>[77,"P9"],"\xBF"=>[18,"P9"],"\xC0"=>[77,"P\x3D"],"\xC1"=>[18,"P\x3D"],"\xC2"=>[77,"PA"],"\xC3"=>[18,"PA"],"\xC4"=>[77,"P_"],"\xC5"=>[18,"P_"],"\xC6"=>[77,"Pb"],"\xC7"=>[18,"Pb"],"\xC8"=>[77,"Pd"],"\xC9"=>[18,"Pd"],"\xCA"=>[77,"Pf"],"\xCB"=>[18,"Pf"],"\xCC"=>[77,"Pg"],"\xCD"=>[18,"Pg"],"\xCE"=>[77,"Ph"],"\xCF"=>[18,"Ph"],"\xD0"=>[77,"Pl"],"\xD1"=>[18,"Pl"],"\xD2"=>[77,"Pm"],"\xD3"=>[18,"Pm"],"\xD4"=>[77,"Pn"],"\xD5"=>[18,"Pn"],"\xD6"=>[77,"Pp"],"\xD7"=>[18,"Pp"],"\xD8"=>[77,"Pr"],"\xD9"=>[18,"Pr"],"\xDA"=>[77,"Pu"],"\xDB"=>[18,"Pu"],"\xDC"=>[0,"P\x3A"],"\xDD"=>[0,"PB"],"\xDE"=>[0,"PC"],"\xDF"=>[0,"PD"],"\xE0"=>[0,"PE"],"\xE1"=>[0,"PF"],"\xE2"=>[0,"PG"],"\xE3"=>[0,"PH"],"\xE4"=>[0,"PI"],"\xE5"=>[0,"PJ"],"\xE6"=>[0,"PK"],"\xE7"=>[0,"PL"],"\xE8"=>[0,"PM"],"\xE9"=>[0,"PN"],"\xEA"=>[0,"PO"],"\xEB"=>[0,"PP"],"\xEC"=>[0,"PQ"],"\xED"=>[0,"PR"],"\xEE"=>[0,"PS"],"\xEF"=>[0,"PT"],"\xF0"=>[0,"PU"],"\xF1"=>[0,"PV"],"\xF2"=>[0,"PW"],"\xF3"=>[0,"PY"],"\xF4"=>[0,"Pj"],"\xF5"=>[0,"Pk"],"\xF6"=>[0,"Pq"],"\xF7"=>[0,"Pv"],"\xF8"=>[0,"Pw"],"\xF9"=>[0,"Px"],"\xFA"=>[0,"Py"],"\xFB"=>[0,"Pz"],"\xFC"=>[82,"P"],"\xFD"=>[87,"P"],"\xFE"=>[130,"P"],"\xFF"=>[9,"P"],],["\x00"=>[94,"Q0"],"\x01"=>[76,"Q0"],"\x02"=>[104,"Q0"],"\x03"=>[16,"Q0"],"\x04"=>[94,"Q1"],"\x05"=>[76,"Q1"],"\x06"=>[104,"Q1"],"\x07"=>[16,"Q1"],"\x08"=>[94,"Q2"],"\x09"=>[76,"Q2"],"\x0A"=>[104,"Q2"],"\x0B"=>[16,"Q2"],"\x0C"=>[94,"Qa"],"\x0D"=>[76,"Qa"],"\x0E"=>[104,"Qa"],"\x0F"=>[16,"Qa"],"\x10"=>[94,"Qc"],"\x11"=>[76,"Qc"],"\x12"=>[104,"Qc"],"\x13"=>[16,"Qc"],"\x14"=>[94,"Qe"],"\x15"=>[76,"Qe"],"\x16"=>[104,"Qe"],"\x17"=>[16,"Qe"],"\x18"=>[94,"Qi"],"\x19"=>[76,"Qi"],"\x1A"=>[104,"Qi"],"\x1B"=>[16,"Qi"],"\x1C"=>[94,"Qo"],"\x1D"=>[76,"Qo"],"\x1E"=>[104,"Qo"],"\x1F"=>[16,"Qo"],"\x20"=>[94,"Qs"],"\x21"=>[76,"Qs"],"\x22"=>[104,"Qs"],"\x23"=>[16,"Qs"],"\x24"=>[94,"Qt"],"\x25"=>[76,"Qt"],"\x26"=>[104,"Qt"],"\x27"=>[16,"Qt"],"\x28"=>[77,"Q\x20"],"\x29"=>[18,"Q\x20"],"\x2A"=>[77,"Q\x25"],"\x2B"=>[18,"Q\x25"],"\x2C"=>[77,"Q-"],"-"=>[18,"Q-"],"."=>[77,"Q."],"\x2F"=>[18,"Q."],[77,"Q\x2F"],[18,"Q\x2F"],[77,"Q3"],[18,"Q3"],[77,"Q4"],[18,"Q4"],[77,"Q5"],[18,"Q5"],[77,"Q6"],[18,"Q6"],"\x3A"=>[77,"Q7"],"\x3B"=>[18,"Q7"],"\x3C"=>[77,"Q8"],"\x3D"=>[18,"Q8"],"\x3E"=>[77,"Q9"],"\x3F"=>[18,"Q9"],"\x40"=>[77,"Q\x3D"],"A"=>[18,"Q\x3D"],"B"=>[77,"QA"],"C"=>[18,"QA"],"D"=>[77,"Q_"],"E"=>[18,"Q_"],"F"=>[77,"Qb"],"G"=>[18,"Qb"],"H"=>[77,"Qd"],"I"=>[18,"Qd"],"J"=>[77,"Qf"],"K"=>[18,"Qf"],"L"=>[77,"Qg"],"M"=>[18,"Qg"],"N"=>[77,"Qh"],"O"=>[18,"Qh"],"P"=>[77,"Ql"],"Q"=>[18,"Ql"],"R"=>[77,"Qm"],"S"=>[18,"Qm"],"T"=>[77,"Qn"],"U"=>[18,"Qn"],"V"=>[77,"Qp"],"W"=>[18,"Qp"],"X"=>[77,"Qr"],"Y"=>[18,"Qr"],"Z"=>[77,"Qu"],"\x5B"=>[18,"Qu"],"\x5C"=>[0,"Q\x3A"],"\x5D"=>[0,"QB"],"\x5E"=>[0,"QC"],"_"=>[0,"QD"],"\x60"=>[0,"QE"],"a"=>[0,"QF"],"b"=>[0,"QG"],"c"=>[0,"QH"],"d"=>[0,"QI"],"e"=>[0,"QJ"],"f"=>[0,"QK"],"g"=>[0,"QL"],"h"=>[0,"QM"],"i"=>[0,"QN"],"j"=>[0,"QO"],"k"=>[0,"QP"],"l"=>[0,"QQ"],"m"=>[0,"QR"],"n"=>[0,"QS"],"o"=>[0,"QT"],"p"=>[0,"QU"],"q"=>[0,"QV"],"r"=>[0,"QW"],"s"=>[0,"QY"],"t"=>[0,"Qj"],"u"=>[0,"Qk"],"v"=>[0,"Qq"],"w"=>[0,"Qv"],"x"=>[0,"Qw"],"y"=>[0,"Qx"],"z"=>[0,"Qy"],"\x7B"=>[0,"Qz"],"\x7C"=>[82,"Q"],"\x7D"=>[87,"Q"],"~"=>[130,"Q"],"\x7F"=>[9,"Q"],"\x80"=>[94,"R0"],"\x81"=>[76,"R0"],"\x82"=>[104,"R0"],"\x83"=>[16,"R0"],"\x84"=>[94,"R1"],"\x85"=>[76,"R1"],"\x86"=>[104,"R1"],"\x87"=>[16,"R1"],"\x88"=>[94,"R2"],"\x89"=>[76,"R2"],"\x8A"=>[104,"R2"],"\x8B"=>[16,"R2"],"\x8C"=>[94,"Ra"],"\x8D"=>[76,"Ra"],"\x8E"=>[104,"Ra"],"\x8F"=>[16,"Ra"],"\x90"=>[94,"Rc"],"\x91"=>[76,"Rc"],"\x92"=>[104,"Rc"],"\x93"=>[16,"Rc"],"\x94"=>[94,"Re"],"\x95"=>[76,"Re"],"\x96"=>[104,"Re"],"\x97"=>[16,"Re"],"\x98"=>[94,"Ri"],"\x99"=>[76,"Ri"],"\x9A"=>[104,"Ri"],"\x9B"=>[16,"Ri"],"\x9C"=>[94,"Ro"],"\x9D"=>[76,"Ro"],"\x9E"=>[104,"Ro"],"\x9F"=>[16,"Ro"],"\xA0"=>[94,"Rs"],"\xA1"=>[76,"Rs"],"\xA2"=>[104,"Rs"],"\xA3"=>[16,"Rs"],"\xA4"=>[94,"Rt"],"\xA5"=>[76,"Rt"],"\xA6"=>[104,"Rt"],"\xA7"=>[16,"Rt"],"\xA8"=>[77,"R\x20"],"\xA9"=>[18,"R\x20"],"\xAA"=>[77,"R\x25"],"\xAB"=>[18,"R\x25"],"\xAC"=>[77,"R-"],"\xAD"=>[18,"R-"],"\xAE"=>[77,"R."],"\xAF"=>[18,"R."],"\xB0"=>[77,"R\x2F"],"\xB1"=>[18,"R\x2F"],"\xB2"=>[77,"R3"],"\xB3"=>[18,"R3"],"\xB4"=>[77,"R4"],"\xB5"=>[18,"R4"],"\xB6"=>[77,"R5"],"\xB7"=>[18,"R5"],"\xB8"=>[77,"R6"],"\xB9"=>[18,"R6"],"\xBA"=>[77,"R7"],"\xBB"=>[18,"R7"],"\xBC"=>[77,"R8"],"\xBD"=>[18,"R8"],"\xBE"=>[77,"R9"],"\xBF"=>[18,"R9"],"\xC0"=>[77,"R\x3D"],"\xC1"=>[18,"R\x3D"],"\xC2"=>[77,"RA"],"\xC3"=>[18,"RA"],"\xC4"=>[77,"R_"],"\xC5"=>[18,"R_"],"\xC6"=>[77,"Rb"],"\xC7"=>[18,"Rb"],"\xC8"=>[77,"Rd"],"\xC9"=>[18,"Rd"],"\xCA"=>[77,"Rf"],"\xCB"=>[18,"Rf"],"\xCC"=>[77,"Rg"],"\xCD"=>[18,"Rg"],"\xCE"=>[77,"Rh"],"\xCF"=>[18,"Rh"],"\xD0"=>[77,"Rl"],"\xD1"=>[18,"Rl"],"\xD2"=>[77,"Rm"],"\xD3"=>[18,"Rm"],"\xD4"=>[77,"Rn"],"\xD5"=>[18,"Rn"],"\xD6"=>[77,"Rp"],"\xD7"=>[18,"Rp"],"\xD8"=>[77,"Rr"],"\xD9"=>[18,"Rr"],"\xDA"=>[77,"Ru"],"\xDB"=>[18,"Ru"],"\xDC"=>[0,"R\x3A"],"\xDD"=>[0,"RB"],"\xDE"=>[0,"RC"],"\xDF"=>[0,"RD"],"\xE0"=>[0,"RE"],"\xE1"=>[0,"RF"],"\xE2"=>[0,"RG"],"\xE3"=>[0,"RH"],"\xE4"=>[0,"RI"],"\xE5"=>[0,"RJ"],"\xE6"=>[0,"RK"],"\xE7"=>[0,"RL"],"\xE8"=>[0,"RM"],"\xE9"=>[0,"RN"],"\xEA"=>[0,"RO"],"\xEB"=>[0,"RP"],"\xEC"=>[0,"RQ"],"\xED"=>[0,"RR"],"\xEE"=>[0,"RS"],"\xEF"=>[0,"RT"],"\xF0"=>[0,"RU"],"\xF1"=>[0,"RV"],"\xF2"=>[0,"RW"],"\xF3"=>[0,"RY"],"\xF4"=>[0,"Rj"],"\xF5"=>[0,"Rk"],"\xF6"=>[0,"Rq"],"\xF7"=>[0,"Rv"],"\xF8"=>[0,"Rw"],"\xF9"=>[0,"Rx"],"\xFA"=>[0,"Ry"],"\xFB"=>[0,"Rz"],"\xFC"=>[82,"R"],"\xFD"=>[87,"R"],"\xFE"=>[130,"R"],"\xFF"=>[9,"R"],],["\x00"=>[77,"Q0"],"\x01"=>[18,"Q0"],"\x02"=>[77,"Q1"],"\x03"=>[18,"Q1"],"\x04"=>[77,"Q2"],"\x05"=>[18,"Q2"],"\x06"=>[77,"Qa"],"\x07"=>[18,"Qa"],"\x08"=>[77,"Qc"],"\x09"=>[18,"Qc"],"\x0A"=>[77,"Qe"],"\x0B"=>[18,"Qe"],"\x0C"=>[77,"Qi"],"\x0D"=>[18,"Qi"],"\x0E"=>[77,"Qo"],"\x0F"=>[18,"Qo"],"\x10"=>[77,"Qs"],"\x11"=>[18,"Qs"],"\x12"=>[77,"Qt"],"\x13"=>[18,"Qt"],"\x14"=>[0,"Q\x20"],"\x15"=>[0,"Q\x25"],"\x16"=>[0,"Q-"],"\x17"=>[0,"Q."],"\x18"=>[0,"Q\x2F"],"\x19"=>[0,"Q3"],"\x1A"=>[0,"Q4"],"\x1B"=>[0,"Q5"],"\x1C"=>[0,"Q6"],"\x1D"=>[0,"Q7"],"\x1E"=>[0,"Q8"],"\x1F"=>[0,"Q9"],"\x20"=>[0,"Q\x3D"],"\x21"=>[0,"QA"],"\x22"=>[0,"Q_"],"\x23"=>[0,"Qb"],"\x24"=>[0,"Qd"],"\x25"=>[0,"Qf"],"\x26"=>[0,"Qg"],"\x27"=>[0,"Qh"],"\x28"=>[0,"Ql"],"\x29"=>[0,"Qm"],"\x2A"=>[0,"Qn"],"\x2B"=>[0,"Qp"],"\x2C"=>[0,"Qr"],"-"=>[0,"Qu"],"."=>[100,"Q"],"\x2F"=>[110,"Q"],[111,"Q"],[115,"Q"],[116,"Q"],[118,"Q"],[119,"Q"],[122,"Q"],[123,"Q"],[125,"Q"],[126,"Q"],[129,"Q"],"\x3A"=>[143,"Q"],"\x3B"=>[148,"Q"],"\x3C"=>[151,"Q"],"\x3D"=>[153,"Q"],"\x3E"=>[83,"Q"],"\x3F"=>[10,"Q"],"\x40"=>[77,"R0"],"A"=>[18,"R0"],"B"=>[77,"R1"],"C"=>[18,"R1"],"D"=>[77,"R2"],"E"=>[18,"R2"],"F"=>[77,"Ra"],"G"=>[18,"Ra"],"H"=>[77,"Rc"],"I"=>[18,"Rc"],"J"=>[77,"Re"],"K"=>[18,"Re"],"L"=>[77,"Ri"],"M"=>[18,"Ri"],"N"=>[77,"Ro"],"O"=>[18,"Ro"],"P"=>[77,"Rs"],"Q"=>[18,"Rs"],"R"=>[77,"Rt"],"S"=>[18,"Rt"],"T"=>[0,"R\x20"],"U"=>[0,"R\x25"],"V"=>[0,"R-"],"W"=>[0,"R."],"X"=>[0,"R\x2F"],"Y"=>[0,"R3"],"Z"=>[0,"R4"],"\x5B"=>[0,"R5"],"\x5C"=>[0,"R6"],"\x5D"=>[0,"R7"],"\x5E"=>[0,"R8"],"_"=>[0,"R9"],"\x60"=>[0,"R\x3D"],"a"=>[0,"RA"],"b"=>[0,"R_"],"c"=>[0,"Rb"],"d"=>[0,"Rd"],"e"=>[0,"Rf"],"f"=>[0,"Rg"],"g"=>[0,"Rh"],"h"=>[0,"Rl"],"i"=>[0,"Rm"],"j"=>[0,"Rn"],"k"=>[0,"Rp"],"l"=>[0,"Rr"],"m"=>[0,"Ru"],"n"=>[100,"R"],"o"=>[110,"R"],"p"=>[111,"R"],"q"=>[115,"R"],"r"=>[116,"R"],"s"=>[118,"R"],"t"=>[119,"R"],"u"=>[122,"R"],"v"=>[123,"R"],"w"=>[125,"R"],"x"=>[126,"R"],"y"=>[129,"R"],"z"=>[143,"R"],"\x7B"=>[148,"R"],"\x7C"=>[151,"R"],"\x7D"=>[153,"R"],"~"=>[83,"R"],"\x7F"=>[10,"R"],"\x80"=>[77,"S0"],"\x81"=>[18,"S0"],"\x82"=>[77,"S1"],"\x83"=>[18,"S1"],"\x84"=>[77,"S2"],"\x85"=>[18,"S2"],"\x86"=>[77,"Sa"],"\x87"=>[18,"Sa"],"\x88"=>[77,"Sc"],"\x89"=>[18,"Sc"],"\x8A"=>[77,"Se"],"\x8B"=>[18,"Se"],"\x8C"=>[77,"Si"],"\x8D"=>[18,"Si"],"\x8E"=>[77,"So"],"\x8F"=>[18,"So"],"\x90"=>[77,"Ss"],"\x91"=>[18,"Ss"],"\x92"=>[77,"St"],"\x93"=>[18,"St"],"\x94"=>[0,"S\x20"],"\x95"=>[0,"S\x25"],"\x96"=>[0,"S-"],"\x97"=>[0,"S."],"\x98"=>[0,"S\x2F"],"\x99"=>[0,"S3"],"\x9A"=>[0,"S4"],"\x9B"=>[0,"S5"],"\x9C"=>[0,"S6"],"\x9D"=>[0,"S7"],"\x9E"=>[0,"S8"],"\x9F"=>[0,"S9"],"\xA0"=>[0,"S\x3D"],"\xA1"=>[0,"SA"],"\xA2"=>[0,"S_"],"\xA3"=>[0,"Sb"],"\xA4"=>[0,"Sd"],"\xA5"=>[0,"Sf"],"\xA6"=>[0,"Sg"],"\xA7"=>[0,"Sh"],"\xA8"=>[0,"Sl"],"\xA9"=>[0,"Sm"],"\xAA"=>[0,"Sn"],"\xAB"=>[0,"Sp"],"\xAC"=>[0,"Sr"],"\xAD"=>[0,"Su"],"\xAE"=>[100,"S"],"\xAF"=>[110,"S"],"\xB0"=>[111,"S"],"\xB1"=>[115,"S"],"\xB2"=>[116,"S"],"\xB3"=>[118,"S"],"\xB4"=>[119,"S"],"\xB5"=>[122,"S"],"\xB6"=>[123,"S"],"\xB7"=>[125,"S"],"\xB8"=>[126,"S"],"\xB9"=>[129,"S"],"\xBA"=>[143,"S"],"\xBB"=>[148,"S"],"\xBC"=>[151,"S"],"\xBD"=>[153,"S"],"\xBE"=>[83,"S"],"\xBF"=>[10,"S"],"\xC0"=>[77,"T0"],"\xC1"=>[18,"T0"],"\xC2"=>[77,"T1"],"\xC3"=>[18,"T1"],"\xC4"=>[77,"T2"],"\xC5"=>[18,"T2"],"\xC6"=>[77,"Ta"],"\xC7"=>[18,"Ta"],"\xC8"=>[77,"Tc"],"\xC9"=>[18,"Tc"],"\xCA"=>[77,"Te"],"\xCB"=>[18,"Te"],"\xCC"=>[77,"Ti"],"\xCD"=>[18,"Ti"],"\xCE"=>[77,"To"],"\xCF"=>[18,"To"],"\xD0"=>[77,"Ts"],"\xD1"=>[18,"Ts"],"\xD2"=>[77,"Tt"],"\xD3"=>[18,"Tt"],"\xD4"=>[0,"T\x20"],"\xD5"=>[0,"T\x25"],"\xD6"=>[0,"T-"],"\xD7"=>[0,"T."],"\xD8"=>[0,"T\x2F"],"\xD9"=>[0,"T3"],"\xDA"=>[0,"T4"],"\xDB"=>[0,"T5"],"\xDC"=>[0,"T6"],"\xDD"=>[0,"T7"],"\xDE"=>[0,"T8"],"\xDF"=>[0,"T9"],"\xE0"=>[0,"T\x3D"],"\xE1"=>[0,"TA"],"\xE2"=>[0,"T_"],"\xE3"=>[0,"Tb"],"\xE4"=>[0,"Td"],"\xE5"=>[0,"Tf"],"\xE6"=>[0,"Tg"],"\xE7"=>[0,"Th"],"\xE8"=>[0,"Tl"],"\xE9"=>[0,"Tm"],"\xEA"=>[0,"Tn"],"\xEB"=>[0,"Tp"],"\xEC"=>[0,"Tr"],"\xED"=>[0,"Tu"],"\xEE"=>[100,"T"],"\xEF"=>[110,"T"],"\xF0"=>[111,"T"],"\xF1"=>[115,"T"],"\xF2"=>[116,"T"],"\xF3"=>[118,"T"],"\xF4"=>[119,"T"],"\xF5"=>[122,"T"],"\xF6"=>[123,"T"],"\xF7"=>[125,"T"],"\xF8"=>[126,"T"],"\xF9"=>[129,"T"],"\xFA"=>[143,"T"],"\xFB"=>[148,"T"],"\xFC"=>[151,"T"],"\xFD"=>[153,"T"],"\xFE"=>[83,"T"],"\xFF"=>[10,"T"],],["\x00"=>[94,"S0"],"\x01"=>[76,"S0"],"\x02"=>[104,"S0"],"\x03"=>[16,"S0"],"\x04"=>[94,"S1"],"\x05"=>[76,"S1"],"\x06"=>[104,"S1"],"\x07"=>[16,"S1"],"\x08"=>[94,"S2"],"\x09"=>[76,"S2"],"\x0A"=>[104,"S2"],"\x0B"=>[16,"S2"],"\x0C"=>[94,"Sa"],"\x0D"=>[76,"Sa"],"\x0E"=>[104,"Sa"],"\x0F"=>[16,"Sa"],"\x10"=>[94,"Sc"],"\x11"=>[76,"Sc"],"\x12"=>[104,"Sc"],"\x13"=>[16,"Sc"],"\x14"=>[94,"Se"],"\x15"=>[76,"Se"],"\x16"=>[104,"Se"],"\x17"=>[16,"Se"],"\x18"=>[94,"Si"],"\x19"=>[76,"Si"],"\x1A"=>[104,"Si"],"\x1B"=>[16,"Si"],"\x1C"=>[94,"So"],"\x1D"=>[76,"So"],"\x1E"=>[104,"So"],"\x1F"=>[16,"So"],"\x20"=>[94,"Ss"],"\x21"=>[76,"Ss"],"\x22"=>[104,"Ss"],"\x23"=>[16,"Ss"],"\x24"=>[94,"St"],"\x25"=>[76,"St"],"\x26"=>[104,"St"],"\x27"=>[16,"St"],"\x28"=>[77,"S\x20"],"\x29"=>[18,"S\x20"],"\x2A"=>[77,"S\x25"],"\x2B"=>[18,"S\x25"],"\x2C"=>[77,"S-"],"-"=>[18,"S-"],"."=>[77,"S."],"\x2F"=>[18,"S."],[77,"S\x2F"],[18,"S\x2F"],[77,"S3"],[18,"S3"],[77,"S4"],[18,"S4"],[77,"S5"],[18,"S5"],[77,"S6"],[18,"S6"],"\x3A"=>[77,"S7"],"\x3B"=>[18,"S7"],"\x3C"=>[77,"S8"],"\x3D"=>[18,"S8"],"\x3E"=>[77,"S9"],"\x3F"=>[18,"S9"],"\x40"=>[77,"S\x3D"],"A"=>[18,"S\x3D"],"B"=>[77,"SA"],"C"=>[18,"SA"],"D"=>[77,"S_"],"E"=>[18,"S_"],"F"=>[77,"Sb"],"G"=>[18,"Sb"],"H"=>[77,"Sd"],"I"=>[18,"Sd"],"J"=>[77,"Sf"],"K"=>[18,"Sf"],"L"=>[77,"Sg"],"M"=>[18,"Sg"],"N"=>[77,"Sh"],"O"=>[18,"Sh"],"P"=>[77,"Sl"],"Q"=>[18,"Sl"],"R"=>[77,"Sm"],"S"=>[18,"Sm"],"T"=>[77,"Sn"],"U"=>[18,"Sn"],"V"=>[77,"Sp"],"W"=>[18,"Sp"],"X"=>[77,"Sr"],"Y"=>[18,"Sr"],"Z"=>[77,"Su"],"\x5B"=>[18,"Su"],"\x5C"=>[0,"S\x3A"],"\x5D"=>[0,"SB"],"\x5E"=>[0,"SC"],"_"=>[0,"SD"],"\x60"=>[0,"SE"],"a"=>[0,"SF"],"b"=>[0,"SG"],"c"=>[0,"SH"],"d"=>[0,"SI"],"e"=>[0,"SJ"],"f"=>[0,"SK"],"g"=>[0,"SL"],"h"=>[0,"SM"],"i"=>[0,"SN"],"j"=>[0,"SO"],"k"=>[0,"SP"],"l"=>[0,"SQ"],"m"=>[0,"SR"],"n"=>[0,"SS"],"o"=>[0,"ST"],"p"=>[0,"SU"],"q"=>[0,"SV"],"r"=>[0,"SW"],"s"=>[0,"SY"],"t"=>[0,"Sj"],"u"=>[0,"Sk"],"v"=>[0,"Sq"],"w"=>[0,"Sv"],"x"=>[0,"Sw"],"y"=>[0,"Sx"],"z"=>[0,"Sy"],"\x7B"=>[0,"Sz"],"\x7C"=>[82,"S"],"\x7D"=>[87,"S"],"~"=>[130,"S"],"\x7F"=>[9,"S"],"\x80"=>[94,"T0"],"\x81"=>[76,"T0"],"\x82"=>[104,"T0"],"\x83"=>[16,"T0"],"\x84"=>[94,"T1"],"\x85"=>[76,"T1"],"\x86"=>[104,"T1"],"\x87"=>[16,"T1"],"\x88"=>[94,"T2"],"\x89"=>[76,"T2"],"\x8A"=>[104,"T2"],"\x8B"=>[16,"T2"],"\x8C"=>[94,"Ta"],"\x8D"=>[76,"Ta"],"\x8E"=>[104,"Ta"],"\x8F"=>[16,"Ta"],"\x90"=>[94,"Tc"],"\x91"=>[76,"Tc"],"\x92"=>[104,"Tc"],"\x93"=>[16,"Tc"],"\x94"=>[94,"Te"],"\x95"=>[76,"Te"],"\x96"=>[104,"Te"],"\x97"=>[16,"Te"],"\x98"=>[94,"Ti"],"\x99"=>[76,"Ti"],"\x9A"=>[104,"Ti"],"\x9B"=>[16,"Ti"],"\x9C"=>[94,"To"],"\x9D"=>[76,"To"],"\x9E"=>[104,"To"],"\x9F"=>[16,"To"],"\xA0"=>[94,"Ts"],"\xA1"=>[76,"Ts"],"\xA2"=>[104,"Ts"],"\xA3"=>[16,"Ts"],"\xA4"=>[94,"Tt"],"\xA5"=>[76,"Tt"],"\xA6"=>[104,"Tt"],"\xA7"=>[16,"Tt"],"\xA8"=>[77,"T\x20"],"\xA9"=>[18,"T\x20"],"\xAA"=>[77,"T\x25"],"\xAB"=>[18,"T\x25"],"\xAC"=>[77,"T-"],"\xAD"=>[18,"T-"],"\xAE"=>[77,"T."],"\xAF"=>[18,"T."],"\xB0"=>[77,"T\x2F"],"\xB1"=>[18,"T\x2F"],"\xB2"=>[77,"T3"],"\xB3"=>[18,"T3"],"\xB4"=>[77,"T4"],"\xB5"=>[18,"T4"],"\xB6"=>[77,"T5"],"\xB7"=>[18,"T5"],"\xB8"=>[77,"T6"],"\xB9"=>[18,"T6"],"\xBA"=>[77,"T7"],"\xBB"=>[18,"T7"],"\xBC"=>[77,"T8"],"\xBD"=>[18,"T8"],"\xBE"=>[77,"T9"],"\xBF"=>[18,"T9"],"\xC0"=>[77,"T\x3D"],"\xC1"=>[18,"T\x3D"],"\xC2"=>[77,"TA"],"\xC3"=>[18,"TA"],"\xC4"=>[77,"T_"],"\xC5"=>[18,"T_"],"\xC6"=>[77,"Tb"],"\xC7"=>[18,"Tb"],"\xC8"=>[77,"Td"],"\xC9"=>[18,"Td"],"\xCA"=>[77,"Tf"],"\xCB"=>[18,"Tf"],"\xCC"=>[77,"Tg"],"\xCD"=>[18,"Tg"],"\xCE"=>[77,"Th"],"\xCF"=>[18,"Th"],"\xD0"=>[77,"Tl"],"\xD1"=>[18,"Tl"],"\xD2"=>[77,"Tm"],"\xD3"=>[18,"Tm"],"\xD4"=>[77,"Tn"],"\xD5"=>[18,"Tn"],"\xD6"=>[77,"Tp"],"\xD7"=>[18,"Tp"],"\xD8"=>[77,"Tr"],"\xD9"=>[18,"Tr"],"\xDA"=>[77,"Tu"],"\xDB"=>[18,"Tu"],"\xDC"=>[0,"T\x3A"],"\xDD"=>[0,"TB"],"\xDE"=>[0,"TC"],"\xDF"=>[0,"TD"],"\xE0"=>[0,"TE"],"\xE1"=>[0,"TF"],"\xE2"=>[0,"TG"],"\xE3"=>[0,"TH"],"\xE4"=>[0,"TI"],"\xE5"=>[0,"TJ"],"\xE6"=>[0,"TK"],"\xE7"=>[0,"TL"],"\xE8"=>[0,"TM"],"\xE9"=>[0,"TN"],"\xEA"=>[0,"TO"],"\xEB"=>[0,"TP"],"\xEC"=>[0,"TQ"],"\xED"=>[0,"TR"],"\xEE"=>[0,"TS"],"\xEF"=>[0,"TT"],"\xF0"=>[0,"TU"],"\xF1"=>[0,"TV"],"\xF2"=>[0,"TW"],"\xF3"=>[0,"TY"],"\xF4"=>[0,"Tj"],"\xF5"=>[0,"Tk"],"\xF6"=>[0,"Tq"],"\xF7"=>[0,"Tv"],"\xF8"=>[0,"Tw"],"\xF9"=>[0,"Tx"],"\xFA"=>[0,"Ty"],"\xFB"=>[0,"Tz"],"\xFC"=>[82,"T"],"\xFD"=>[87,"T"],"\xFE"=>[130,"T"],"\xFF"=>[9,"T"],],["\x00"=>[94,"U0"],"\x01"=>[76,"U0"],"\x02"=>[104,"U0"],"\x03"=>[16,"U0"],"\x04"=>[94,"U1"],"\x05"=>[76,"U1"],"\x06"=>[104,"U1"],"\x07"=>[16,"U1"],"\x08"=>[94,"U2"],"\x09"=>[76,"U2"],"\x0A"=>[104,"U2"],"\x0B"=>[16,"U2"],"\x0C"=>[94,"Ua"],"\x0D"=>[76,"Ua"],"\x0E"=>[104,"Ua"],"\x0F"=>[16,"Ua"],"\x10"=>[94,"Uc"],"\x11"=>[76,"Uc"],"\x12"=>[104,"Uc"],"\x13"=>[16,"Uc"],"\x14"=>[94,"Ue"],"\x15"=>[76,"Ue"],"\x16"=>[104,"Ue"],"\x17"=>[16,"Ue"],"\x18"=>[94,"Ui"],"\x19"=>[76,"Ui"],"\x1A"=>[104,"Ui"],"\x1B"=>[16,"Ui"],"\x1C"=>[94,"Uo"],"\x1D"=>[76,"Uo"],"\x1E"=>[104,"Uo"],"\x1F"=>[16,"Uo"],"\x20"=>[94,"Us"],"\x21"=>[76,"Us"],"\x22"=>[104,"Us"],"\x23"=>[16,"Us"],"\x24"=>[94,"Ut"],"\x25"=>[76,"Ut"],"\x26"=>[104,"Ut"],"\x27"=>[16,"Ut"],"\x28"=>[77,"U\x20"],"\x29"=>[18,"U\x20"],"\x2A"=>[77,"U\x25"],"\x2B"=>[18,"U\x25"],"\x2C"=>[77,"U-"],"-"=>[18,"U-"],"."=>[77,"U."],"\x2F"=>[18,"U."],[77,"U\x2F"],[18,"U\x2F"],[77,"U3"],[18,"U3"],[77,"U4"],[18,"U4"],[77,"U5"],[18,"U5"],[77,"U6"],[18,"U6"],"\x3A"=>[77,"U7"],"\x3B"=>[18,"U7"],"\x3C"=>[77,"U8"],"\x3D"=>[18,"U8"],"\x3E"=>[77,"U9"],"\x3F"=>[18,"U9"],"\x40"=>[77,"U\x3D"],"A"=>[18,"U\x3D"],"B"=>[77,"UA"],"C"=>[18,"UA"],"D"=>[77,"U_"],"E"=>[18,"U_"],"F"=>[77,"Ub"],"G"=>[18,"Ub"],"H"=>[77,"Ud"],"I"=>[18,"Ud"],"J"=>[77,"Uf"],"K"=>[18,"Uf"],"L"=>[77,"Ug"],"M"=>[18,"Ug"],"N"=>[77,"Uh"],"O"=>[18,"Uh"],"P"=>[77,"Ul"],"Q"=>[18,"Ul"],"R"=>[77,"Um"],"S"=>[18,"Um"],"T"=>[77,"Un"],"U"=>[18,"Un"],"V"=>[77,"Up"],"W"=>[18,"Up"],"X"=>[77,"Ur"],"Y"=>[18,"Ur"],"Z"=>[77,"Uu"],"\x5B"=>[18,"Uu"],"\x5C"=>[0,"U\x3A"],"\x5D"=>[0,"UB"],"\x5E"=>[0,"UC"],"_"=>[0,"UD"],"\x60"=>[0,"UE"],"a"=>[0,"UF"],"b"=>[0,"UG"],"c"=>[0,"UH"],"d"=>[0,"UI"],"e"=>[0,"UJ"],"f"=>[0,"UK"],"g"=>[0,"UL"],"h"=>[0,"UM"],"i"=>[0,"UN"],"j"=>[0,"UO"],"k"=>[0,"UP"],"l"=>[0,"UQ"],"m"=>[0,"UR"],"n"=>[0,"US"],"o"=>[0,"UT"],"p"=>[0,"UU"],"q"=>[0,"UV"],"r"=>[0,"UW"],"s"=>[0,"UY"],"t"=>[0,"Uj"],"u"=>[0,"Uk"],"v"=>[0,"Uq"],"w"=>[0,"Uv"],"x"=>[0,"Uw"],"y"=>[0,"Ux"],"z"=>[0,"Uy"],"\x7B"=>[0,"Uz"],"\x7C"=>[82,"U"],"\x7D"=>[87,"U"],"~"=>[130,"U"],"\x7F"=>[9,"U"],"\x80"=>[94,"V0"],"\x81"=>[76,"V0"],"\x82"=>[104,"V0"],"\x83"=>[16,"V0"],"\x84"=>[94,"V1"],"\x85"=>[76,"V1"],"\x86"=>[104,"V1"],"\x87"=>[16,"V1"],"\x88"=>[94,"V2"],"\x89"=>[76,"V2"],"\x8A"=>[104,"V2"],"\x8B"=>[16,"V2"],"\x8C"=>[94,"Va"],"\x8D"=>[76,"Va"],"\x8E"=>[104,"Va"],"\x8F"=>[16,"Va"],"\x90"=>[94,"Vc"],"\x91"=>[76,"Vc"],"\x92"=>[104,"Vc"],"\x93"=>[16,"Vc"],"\x94"=>[94,"Ve"],"\x95"=>[76,"Ve"],"\x96"=>[104,"Ve"],"\x97"=>[16,"Ve"],"\x98"=>[94,"Vi"],"\x99"=>[76,"Vi"],"\x9A"=>[104,"Vi"],"\x9B"=>[16,"Vi"],"\x9C"=>[94,"Vo"],"\x9D"=>[76,"Vo"],"\x9E"=>[104,"Vo"],"\x9F"=>[16,"Vo"],"\xA0"=>[94,"Vs"],"\xA1"=>[76,"Vs"],"\xA2"=>[104,"Vs"],"\xA3"=>[16,"Vs"],"\xA4"=>[94,"Vt"],"\xA5"=>[76,"Vt"],"\xA6"=>[104,"Vt"],"\xA7"=>[16,"Vt"],"\xA8"=>[77,"V\x20"],"\xA9"=>[18,"V\x20"],"\xAA"=>[77,"V\x25"],"\xAB"=>[18,"V\x25"],"\xAC"=>[77,"V-"],"\xAD"=>[18,"V-"],"\xAE"=>[77,"V."],"\xAF"=>[18,"V."],"\xB0"=>[77,"V\x2F"],"\xB1"=>[18,"V\x2F"],"\xB2"=>[77,"V3"],"\xB3"=>[18,"V3"],"\xB4"=>[77,"V4"],"\xB5"=>[18,"V4"],"\xB6"=>[77,"V5"],"\xB7"=>[18,"V5"],"\xB8"=>[77,"V6"],"\xB9"=>[18,"V6"],"\xBA"=>[77,"V7"],"\xBB"=>[18,"V7"],"\xBC"=>[77,"V8"],"\xBD"=>[18,"V8"],"\xBE"=>[77,"V9"],"\xBF"=>[18,"V9"],"\xC0"=>[77,"V\x3D"],"\xC1"=>[18,"V\x3D"],"\xC2"=>[77,"VA"],"\xC3"=>[18,"VA"],"\xC4"=>[77,"V_"],"\xC5"=>[18,"V_"],"\xC6"=>[77,"Vb"],"\xC7"=>[18,"Vb"],"\xC8"=>[77,"Vd"],"\xC9"=>[18,"Vd"],"\xCA"=>[77,"Vf"],"\xCB"=>[18,"Vf"],"\xCC"=>[77,"Vg"],"\xCD"=>[18,"Vg"],"\xCE"=>[77,"Vh"],"\xCF"=>[18,"Vh"],"\xD0"=>[77,"Vl"],"\xD1"=>[18,"Vl"],"\xD2"=>[77,"Vm"],"\xD3"=>[18,"Vm"],"\xD4"=>[77,"Vn"],"\xD5"=>[18,"Vn"],"\xD6"=>[77,"Vp"],"\xD7"=>[18,"Vp"],"\xD8"=>[77,"Vr"],"\xD9"=>[18,"Vr"],"\xDA"=>[77,"Vu"],"\xDB"=>[18,"Vu"],"\xDC"=>[0,"V\x3A"],"\xDD"=>[0,"VB"],"\xDE"=>[0,"VC"],"\xDF"=>[0,"VD"],"\xE0"=>[0,"VE"],"\xE1"=>[0,"VF"],"\xE2"=>[0,"VG"],"\xE3"=>[0,"VH"],"\xE4"=>[0,"VI"],"\xE5"=>[0,"VJ"],"\xE6"=>[0,"VK"],"\xE7"=>[0,"VL"],"\xE8"=>[0,"VM"],"\xE9"=>[0,"VN"],"\xEA"=>[0,"VO"],"\xEB"=>[0,"VP"],"\xEC"=>[0,"VQ"],"\xED"=>[0,"VR"],"\xEE"=>[0,"VS"],"\xEF"=>[0,"VT"],"\xF0"=>[0,"VU"],"\xF1"=>[0,"VV"],"\xF2"=>[0,"VW"],"\xF3"=>[0,"VY"],"\xF4"=>[0,"Vj"],"\xF5"=>[0,"Vk"],"\xF6"=>[0,"Vq"],"\xF7"=>[0,"Vv"],"\xF8"=>[0,"Vw"],"\xF9"=>[0,"Vx"],"\xFA"=>[0,"Vy"],"\xFB"=>[0,"Vz"],"\xFC"=>[82,"V"],"\xFD"=>[87,"V"],"\xFE"=>[130,"V"],"\xFF"=>[9,"V"],],["\x00"=>[77,"U0"],"\x01"=>[18,"U0"],"\x02"=>[77,"U1"],"\x03"=>[18,"U1"],"\x04"=>[77,"U2"],"\x05"=>[18,"U2"],"\x06"=>[77,"Ua"],"\x07"=>[18,"Ua"],"\x08"=>[77,"Uc"],"\x09"=>[18,"Uc"],"\x0A"=>[77,"Ue"],"\x0B"=>[18,"Ue"],"\x0C"=>[77,"Ui"],"\x0D"=>[18,"Ui"],"\x0E"=>[77,"Uo"],"\x0F"=>[18,"Uo"],"\x10"=>[77,"Us"],"\x11"=>[18,"Us"],"\x12"=>[77,"Ut"],"\x13"=>[18,"Ut"],"\x14"=>[0,"U\x20"],"\x15"=>[0,"U\x25"],"\x16"=>[0,"U-"],"\x17"=>[0,"U."],"\x18"=>[0,"U\x2F"],"\x19"=>[0,"U3"],"\x1A"=>[0,"U4"],"\x1B"=>[0,"U5"],"\x1C"=>[0,"U6"],"\x1D"=>[0,"U7"],"\x1E"=>[0,"U8"],"\x1F"=>[0,"U9"],"\x20"=>[0,"U\x3D"],"\x21"=>[0,"UA"],"\x22"=>[0,"U_"],"\x23"=>[0,"Ub"],"\x24"=>[0,"Ud"],"\x25"=>[0,"Uf"],"\x26"=>[0,"Ug"],"\x27"=>[0,"Uh"],"\x28"=>[0,"Ul"],"\x29"=>[0,"Um"],"\x2A"=>[0,"Un"],"\x2B"=>[0,"Up"],"\x2C"=>[0,"Ur"],"-"=>[0,"Uu"],"."=>[100,"U"],"\x2F"=>[110,"U"],[111,"U"],[115,"U"],[116,"U"],[118,"U"],[119,"U"],[122,"U"],[123,"U"],[125,"U"],[126,"U"],[129,"U"],"\x3A"=>[143,"U"],"\x3B"=>[148,"U"],"\x3C"=>[151,"U"],"\x3D"=>[153,"U"],"\x3E"=>[83,"U"],"\x3F"=>[10,"U"],"\x40"=>[77,"V0"],"A"=>[18,"V0"],"B"=>[77,"V1"],"C"=>[18,"V1"],"D"=>[77,"V2"],"E"=>[18,"V2"],"F"=>[77,"Va"],"G"=>[18,"Va"],"H"=>[77,"Vc"],"I"=>[18,"Vc"],"J"=>[77,"Ve"],"K"=>[18,"Ve"],"L"=>[77,"Vi"],"M"=>[18,"Vi"],"N"=>[77,"Vo"],"O"=>[18,"Vo"],"P"=>[77,"Vs"],"Q"=>[18,"Vs"],"R"=>[77,"Vt"],"S"=>[18,"Vt"],"T"=>[0,"V\x20"],"U"=>[0,"V\x25"],"V"=>[0,"V-"],"W"=>[0,"V."],"X"=>[0,"V\x2F"],"Y"=>[0,"V3"],"Z"=>[0,"V4"],"\x5B"=>[0,"V5"],"\x5C"=>[0,"V6"],"\x5D"=>[0,"V7"],"\x5E"=>[0,"V8"],"_"=>[0,"V9"],"\x60"=>[0,"V\x3D"],"a"=>[0,"VA"],"b"=>[0,"V_"],"c"=>[0,"Vb"],"d"=>[0,"Vd"],"e"=>[0,"Vf"],"f"=>[0,"Vg"],"g"=>[0,"Vh"],"h"=>[0,"Vl"],"i"=>[0,"Vm"],"j"=>[0,"Vn"],"k"=>[0,"Vp"],"l"=>[0,"Vr"],"m"=>[0,"Vu"],"n"=>[100,"V"],"o"=>[110,"V"],"p"=>[111,"V"],"q"=>[115,"V"],"r"=>[116,"V"],"s"=>[118,"V"],"t"=>[119,"V"],"u"=>[122,"V"],"v"=>[123,"V"],"w"=>[125,"V"],"x"=>[126,"V"],"y"=>[129,"V"],"z"=>[143,"V"],"\x7B"=>[148,"V"],"\x7C"=>[151,"V"],"\x7D"=>[153,"V"],"~"=>[83,"V"],"\x7F"=>[10,"V"],"\x80"=>[77,"W0"],"\x81"=>[18,"W0"],"\x82"=>[77,"W1"],"\x83"=>[18,"W1"],"\x84"=>[77,"W2"],"\x85"=>[18,"W2"],"\x86"=>[77,"Wa"],"\x87"=>[18,"Wa"],"\x88"=>[77,"Wc"],"\x89"=>[18,"Wc"],"\x8A"=>[77,"We"],"\x8B"=>[18,"We"],"\x8C"=>[77,"Wi"],"\x8D"=>[18,"Wi"],"\x8E"=>[77,"Wo"],"\x8F"=>[18,"Wo"],"\x90"=>[77,"Ws"],"\x91"=>[18,"Ws"],"\x92"=>[77,"Wt"],"\x93"=>[18,"Wt"],"\x94"=>[0,"W\x20"],"\x95"=>[0,"W\x25"],"\x96"=>[0,"W-"],"\x97"=>[0,"W."],"\x98"=>[0,"W\x2F"],"\x99"=>[0,"W3"],"\x9A"=>[0,"W4"],"\x9B"=>[0,"W5"],"\x9C"=>[0,"W6"],"\x9D"=>[0,"W7"],"\x9E"=>[0,"W8"],"\x9F"=>[0,"W9"],"\xA0"=>[0,"W\x3D"],"\xA1"=>[0,"WA"],"\xA2"=>[0,"W_"],"\xA3"=>[0,"Wb"],"\xA4"=>[0,"Wd"],"\xA5"=>[0,"Wf"],"\xA6"=>[0,"Wg"],"\xA7"=>[0,"Wh"],"\xA8"=>[0,"Wl"],"\xA9"=>[0,"Wm"],"\xAA"=>[0,"Wn"],"\xAB"=>[0,"Wp"],"\xAC"=>[0,"Wr"],"\xAD"=>[0,"Wu"],"\xAE"=>[100,"W"],"\xAF"=>[110,"W"],"\xB0"=>[111,"W"],"\xB1"=>[115,"W"],"\xB2"=>[116,"W"],"\xB3"=>[118,"W"],"\xB4"=>[119,"W"],"\xB5"=>[122,"W"],"\xB6"=>[123,"W"],"\xB7"=>[125,"W"],"\xB8"=>[126,"W"],"\xB9"=>[129,"W"],"\xBA"=>[143,"W"],"\xBB"=>[148,"W"],"\xBC"=>[151,"W"],"\xBD"=>[153,"W"],"\xBE"=>[83,"W"],"\xBF"=>[10,"W"],"\xC0"=>[77,"Y0"],"\xC1"=>[18,"Y0"],"\xC2"=>[77,"Y1"],"\xC3"=>[18,"Y1"],"\xC4"=>[77,"Y2"],"\xC5"=>[18,"Y2"],"\xC6"=>[77,"Ya"],"\xC7"=>[18,"Ya"],"\xC8"=>[77,"Yc"],"\xC9"=>[18,"Yc"],"\xCA"=>[77,"Ye"],"\xCB"=>[18,"Ye"],"\xCC"=>[77,"Yi"],"\xCD"=>[18,"Yi"],"\xCE"=>[77,"Yo"],"\xCF"=>[18,"Yo"],"\xD0"=>[77,"Ys"],"\xD1"=>[18,"Ys"],"\xD2"=>[77,"Yt"],"\xD3"=>[18,"Yt"],"\xD4"=>[0,"Y\x20"],"\xD5"=>[0,"Y\x25"],"\xD6"=>[0,"Y-"],"\xD7"=>[0,"Y."],"\xD8"=>[0,"Y\x2F"],"\xD9"=>[0,"Y3"],"\xDA"=>[0,"Y4"],"\xDB"=>[0,"Y5"],"\xDC"=>[0,"Y6"],"\xDD"=>[0,"Y7"],"\xDE"=>[0,"Y8"],"\xDF"=>[0,"Y9"],"\xE0"=>[0,"Y\x3D"],"\xE1"=>[0,"YA"],"\xE2"=>[0,"Y_"],"\xE3"=>[0,"Yb"],"\xE4"=>[0,"Yd"],"\xE5"=>[0,"Yf"],"\xE6"=>[0,"Yg"],"\xE7"=>[0,"Yh"],"\xE8"=>[0,"Yl"],"\xE9"=>[0,"Ym"],"\xEA"=>[0,"Yn"],"\xEB"=>[0,"Yp"],"\xEC"=>[0,"Yr"],"\xED"=>[0,"Yu"],"\xEE"=>[100,"Y"],"\xEF"=>[110,"Y"],"\xF0"=>[111,"Y"],"\xF1"=>[115,"Y"],"\xF2"=>[116,"Y"],"\xF3"=>[118,"Y"],"\xF4"=>[119,"Y"],"\xF5"=>[122,"Y"],"\xF6"=>[123,"Y"],"\xF7"=>[125,"Y"],"\xF8"=>[126,"Y"],"\xF9"=>[129,"Y"],"\xFA"=>[143,"Y"],"\xFB"=>[148,"Y"],"\xFC"=>[151,"Y"],"\xFD"=>[153,"Y"],"\xFE"=>[83,"Y"],"\xFF"=>[10,"Y"],],["\x00"=>[0,"U0"],"\x01"=>[0,"U1"],"\x02"=>[0,"U2"],"\x03"=>[0,"Ua"],"\x04"=>[0,"Uc"],"\x05"=>[0,"Ue"],"\x06"=>[0,"Ui"],"\x07"=>[0,"Uo"],"\x08"=>[0,"Us"],"\x09"=>[0,"Ut"],"\x0A"=>[73,"U"],"\x0B"=>[88,"U"],"\x0C"=>[89,"U"],"\x0D"=>[96,"U"],"\x0E"=>[97,"U"],"\x0F"=>[99,"U"],"\x10"=>[106,"U"],"\x11"=>[136,"U"],"\x12"=>[139,"U"],"\x13"=>[141,"U"],"\x14"=>[145,"U"],"\x15"=>[147,"U"],"\x16"=>[149,"U"],"\x17"=>[101,"U"],"\x18"=>[112,"U"],"\x19"=>[117,"U"],"\x1A"=>[120,"U"],"\x1B"=>[124,"U"],"\x1C"=>[127,"U"],"\x1D"=>[144,"U"],"\x1E"=>[152,"U"],"\x1F"=>[11,"U"],"\x20"=>[0,"V0"],"\x21"=>[0,"V1"],"\x22"=>[0,"V2"],"\x23"=>[0,"Va"],"\x24"=>[0,"Vc"],"\x25"=>[0,"Ve"],"\x26"=>[0,"Vi"],"\x27"=>[0,"Vo"],"\x28"=>[0,"Vs"],"\x29"=>[0,"Vt"],"\x2A"=>[73,"V"],"\x2B"=>[88,"V"],"\x2C"=>[89,"V"],"-"=>[96,"V"],"."=>[97,"V"],"\x2F"=>[99,"V"],[106,"V"],[136,"V"],[139,"V"],[141,"V"],[145,"V"],[147,"V"],[149,"V"],[101,"V"],[112,"V"],[117,"V"],"\x3A"=>[120,"V"],"\x3B"=>[124,"V"],"\x3C"=>[127,"V"],"\x3D"=>[144,"V"],"\x3E"=>[152,"V"],"\x3F"=>[11,"V"],"\x40"=>[0,"W0"],"A"=>[0,"W1"],"B"=>[0,"W2"],"C"=>[0,"Wa"],"D"=>[0,"Wc"],"E"=>[0,"We"],"F"=>[0,"Wi"],"G"=>[0,"Wo"],"H"=>[0,"Ws"],"I"=>[0,"Wt"],"J"=>[73,"W"],"K"=>[88,"W"],"L"=>[89,"W"],"M"=>[96,"W"],"N"=>[97,"W"],"O"=>[99,"W"],"P"=>[106,"W"],"Q"=>[136,"W"],"R"=>[139,"W"],"S"=>[141,"W"],"T"=>[145,"W"],"U"=>[147,"W"],"V"=>[149,"W"],"W"=>[101,"W"],"X"=>[112,"W"],"Y"=>[117,"W"],"Z"=>[120,"W"],"\x5B"=>[124,"W"],"\x5C"=>[127,"W"],"\x5D"=>[144,"W"],"\x5E"=>[152,"W"],"_"=>[11,"W"],"\x60"=>[0,"Y0"],"a"=>[0,"Y1"],"b"=>[0,"Y2"],"c"=>[0,"Ya"],"d"=>[0,"Yc"],"e"=>[0,"Ye"],"f"=>[0,"Yi"],"g"=>[0,"Yo"],"h"=>[0,"Ys"],"i"=>[0,"Yt"],"j"=>[73,"Y"],"k"=>[88,"Y"],"l"=>[89,"Y"],"m"=>[96,"Y"],"n"=>[97,"Y"],"o"=>[99,"Y"],"p"=>[106,"Y"],"q"=>[136,"Y"],"r"=>[139,"Y"],"s"=>[141,"Y"],"t"=>[145,"Y"],"u"=>[147,"Y"],"v"=>[149,"Y"],"w"=>[101,"Y"],"x"=>[112,"Y"],"y"=>[117,"Y"],"z"=>[120,"Y"],"\x7B"=>[124,"Y"],"\x7C"=>[127,"Y"],"\x7D"=>[144,"Y"],"~"=>[152,"Y"],"\x7F"=>[11,"Y"],"\x80"=>[0,"j0"],"\x81"=>[0,"j1"],"\x82"=>[0,"j2"],"\x83"=>[0,"ja"],"\x84"=>[0,"jc"],"\x85"=>[0,"je"],"\x86"=>[0,"ji"],"\x87"=>[0,"jo"],"\x88"=>[0,"js"],"\x89"=>[0,"jt"],"\x8A"=>[73,"j"],"\x8B"=>[88,"j"],"\x8C"=>[89,"j"],"\x8D"=>[96,"j"],"\x8E"=>[97,"j"],"\x8F"=>[99,"j"],"\x90"=>[106,"j"],"\x91"=>[136,"j"],"\x92"=>[139,"j"],"\x93"=>[141,"j"],"\x94"=>[145,"j"],"\x95"=>[147,"j"],"\x96"=>[149,"j"],"\x97"=>[101,"j"],"\x98"=>[112,"j"],"\x99"=>[117,"j"],"\x9A"=>[120,"j"],"\x9B"=>[124,"j"],"\x9C"=>[127,"j"],"\x9D"=>[144,"j"],"\x9E"=>[152,"j"],"\x9F"=>[11,"j"],"\xA0"=>[0,"k0"],"\xA1"=>[0,"k1"],"\xA2"=>[0,"k2"],"\xA3"=>[0,"ka"],"\xA4"=>[0,"kc"],"\xA5"=>[0,"ke"],"\xA6"=>[0,"ki"],"\xA7"=>[0,"ko"],"\xA8"=>[0,"ks"],"\xA9"=>[0,"kt"],"\xAA"=>[73,"k"],"\xAB"=>[88,"k"],"\xAC"=>[89,"k"],"\xAD"=>[96,"k"],"\xAE"=>[97,"k"],"\xAF"=>[99,"k"],"\xB0"=>[106,"k"],"\xB1"=>[136,"k"],"\xB2"=>[139,"k"],"\xB3"=>[141,"k"],"\xB4"=>[145,"k"],"\xB5"=>[147,"k"],"\xB6"=>[149,"k"],"\xB7"=>[101,"k"],"\xB8"=>[112,"k"],"\xB9"=>[117,"k"],"\xBA"=>[120,"k"],"\xBB"=>[124,"k"],"\xBC"=>[127,"k"],"\xBD"=>[144,"k"],"\xBE"=>[152,"k"],"\xBF"=>[11,"k"],"\xC0"=>[0,"q0"],"\xC1"=>[0,"q1"],"\xC2"=>[0,"q2"],"\xC3"=>[0,"qa"],"\xC4"=>[0,"qc"],"\xC5"=>[0,"qe"],"\xC6"=>[0,"qi"],"\xC7"=>[0,"qo"],"\xC8"=>[0,"qs"],"\xC9"=>[0,"qt"],"\xCA"=>[73,"q"],"\xCB"=>[88,"q"],"\xCC"=>[89,"q"],"\xCD"=>[96,"q"],"\xCE"=>[97,"q"],"\xCF"=>[99,"q"],"\xD0"=>[106,"q"],"\xD1"=>[136,"q"],"\xD2"=>[139,"q"],"\xD3"=>[141,"q"],"\xD4"=>[145,"q"],"\xD5"=>[147,"q"],"\xD6"=>[149,"q"],"\xD7"=>[101,"q"],"\xD8"=>[112,"q"],"\xD9"=>[117,"q"],"\xDA"=>[120,"q"],"\xDB"=>[124,"q"],"\xDC"=>[127,"q"],"\xDD"=>[144,"q"],"\xDE"=>[152,"q"],"\xDF"=>[11,"q"],"\xE0"=>[0,"v0"],"\xE1"=>[0,"v1"],"\xE2"=>[0,"v2"],"\xE3"=>[0,"va"],"\xE4"=>[0,"vc"],"\xE5"=>[0,"ve"],"\xE6"=>[0,"vi"],"\xE7"=>[0,"vo"],"\xE8"=>[0,"vs"],"\xE9"=>[0,"vt"],"\xEA"=>[73,"v"],"\xEB"=>[88,"v"],"\xEC"=>[89,"v"],"\xED"=>[96,"v"],"\xEE"=>[97,"v"],"\xEF"=>[99,"v"],"\xF0"=>[106,"v"],"\xF1"=>[136,"v"],"\xF2"=>[139,"v"],"\xF3"=>[141,"v"],"\xF4"=>[145,"v"],"\xF5"=>[147,"v"],"\xF6"=>[149,"v"],"\xF7"=>[101,"v"],"\xF8"=>[112,"v"],"\xF9"=>[117,"v"],"\xFA"=>[120,"v"],"\xFB"=>[124,"v"],"\xFC"=>[127,"v"],"\xFD"=>[144,"v"],"\xFE"=>[152,"v"],"\xFF"=>[11,"v"],],["\x00"=>[94,"W0"],"\x01"=>[76,"W0"],"\x02"=>[104,"W0"],"\x03"=>[16,"W0"],"\x04"=>[94,"W1"],"\x05"=>[76,"W1"],"\x06"=>[104,"W1"],"\x07"=>[16,"W1"],"\x08"=>[94,"W2"],"\x09"=>[76,"W2"],"\x0A"=>[104,"W2"],"\x0B"=>[16,"W2"],"\x0C"=>[94,"Wa"],"\x0D"=>[76,"Wa"],"\x0E"=>[104,"Wa"],"\x0F"=>[16,"Wa"],"\x10"=>[94,"Wc"],"\x11"=>[76,"Wc"],"\x12"=>[104,"Wc"],"\x13"=>[16,"Wc"],"\x14"=>[94,"We"],"\x15"=>[76,"We"],"\x16"=>[104,"We"],"\x17"=>[16,"We"],"\x18"=>[94,"Wi"],"\x19"=>[76,"Wi"],"\x1A"=>[104,"Wi"],"\x1B"=>[16,"Wi"],"\x1C"=>[94,"Wo"],"\x1D"=>[76,"Wo"],"\x1E"=>[104,"Wo"],"\x1F"=>[16,"Wo"],"\x20"=>[94,"Ws"],"\x21"=>[76,"Ws"],"\x22"=>[104,"Ws"],"\x23"=>[16,"Ws"],"\x24"=>[94,"Wt"],"\x25"=>[76,"Wt"],"\x26"=>[104,"Wt"],"\x27"=>[16,"Wt"],"\x28"=>[77,"W\x20"],"\x29"=>[18,"W\x20"],"\x2A"=>[77,"W\x25"],"\x2B"=>[18,"W\x25"],"\x2C"=>[77,"W-"],"-"=>[18,"W-"],"."=>[77,"W."],"\x2F"=>[18,"W."],[77,"W\x2F"],[18,"W\x2F"],[77,"W3"],[18,"W3"],[77,"W4"],[18,"W4"],[77,"W5"],[18,"W5"],[77,"W6"],[18,"W6"],"\x3A"=>[77,"W7"],"\x3B"=>[18,"W7"],"\x3C"=>[77,"W8"],"\x3D"=>[18,"W8"],"\x3E"=>[77,"W9"],"\x3F"=>[18,"W9"],"\x40"=>[77,"W\x3D"],"A"=>[18,"W\x3D"],"B"=>[77,"WA"],"C"=>[18,"WA"],"D"=>[77,"W_"],"E"=>[18,"W_"],"F"=>[77,"Wb"],"G"=>[18,"Wb"],"H"=>[77,"Wd"],"I"=>[18,"Wd"],"J"=>[77,"Wf"],"K"=>[18,"Wf"],"L"=>[77,"Wg"],"M"=>[18,"Wg"],"N"=>[77,"Wh"],"O"=>[18,"Wh"],"P"=>[77,"Wl"],"Q"=>[18,"Wl"],"R"=>[77,"Wm"],"S"=>[18,"Wm"],"T"=>[77,"Wn"],"U"=>[18,"Wn"],"V"=>[77,"Wp"],"W"=>[18,"Wp"],"X"=>[77,"Wr"],"Y"=>[18,"Wr"],"Z"=>[77,"Wu"],"\x5B"=>[18,"Wu"],"\x5C"=>[0,"W\x3A"],"\x5D"=>[0,"WB"],"\x5E"=>[0,"WC"],"_"=>[0,"WD"],"\x60"=>[0,"WE"],"a"=>[0,"WF"],"b"=>[0,"WG"],"c"=>[0,"WH"],"d"=>[0,"WI"],"e"=>[0,"WJ"],"f"=>[0,"WK"],"g"=>[0,"WL"],"h"=>[0,"WM"],"i"=>[0,"WN"],"j"=>[0,"WO"],"k"=>[0,"WP"],"l"=>[0,"WQ"],"m"=>[0,"WR"],"n"=>[0,"WS"],"o"=>[0,"WT"],"p"=>[0,"WU"],"q"=>[0,"WV"],"r"=>[0,"WW"],"s"=>[0,"WY"],"t"=>[0,"Wj"],"u"=>[0,"Wk"],"v"=>[0,"Wq"],"w"=>[0,"Wv"],"x"=>[0,"Ww"],"y"=>[0,"Wx"],"z"=>[0,"Wy"],"\x7B"=>[0,"Wz"],"\x7C"=>[82,"W"],"\x7D"=>[87,"W"],"~"=>[130,"W"],"\x7F"=>[9,"W"],"\x80"=>[94,"Y0"],"\x81"=>[76,"Y0"],"\x82"=>[104,"Y0"],"\x83"=>[16,"Y0"],"\x84"=>[94,"Y1"],"\x85"=>[76,"Y1"],"\x86"=>[104,"Y1"],"\x87"=>[16,"Y1"],"\x88"=>[94,"Y2"],"\x89"=>[76,"Y2"],"\x8A"=>[104,"Y2"],"\x8B"=>[16,"Y2"],"\x8C"=>[94,"Ya"],"\x8D"=>[76,"Ya"],"\x8E"=>[104,"Ya"],"\x8F"=>[16,"Ya"],"\x90"=>[94,"Yc"],"\x91"=>[76,"Yc"],"\x92"=>[104,"Yc"],"\x93"=>[16,"Yc"],"\x94"=>[94,"Ye"],"\x95"=>[76,"Ye"],"\x96"=>[104,"Ye"],"\x97"=>[16,"Ye"],"\x98"=>[94,"Yi"],"\x99"=>[76,"Yi"],"\x9A"=>[104,"Yi"],"\x9B"=>[16,"Yi"],"\x9C"=>[94,"Yo"],"\x9D"=>[76,"Yo"],"\x9E"=>[104,"Yo"],"\x9F"=>[16,"Yo"],"\xA0"=>[94,"Ys"],"\xA1"=>[76,"Ys"],"\xA2"=>[104,"Ys"],"\xA3"=>[16,"Ys"],"\xA4"=>[94,"Yt"],"\xA5"=>[76,"Yt"],"\xA6"=>[104,"Yt"],"\xA7"=>[16,"Yt"],"\xA8"=>[77,"Y\x20"],"\xA9"=>[18,"Y\x20"],"\xAA"=>[77,"Y\x25"],"\xAB"=>[18,"Y\x25"],"\xAC"=>[77,"Y-"],"\xAD"=>[18,"Y-"],"\xAE"=>[77,"Y."],"\xAF"=>[18,"Y."],"\xB0"=>[77,"Y\x2F"],"\xB1"=>[18,"Y\x2F"],"\xB2"=>[77,"Y3"],"\xB3"=>[18,"Y3"],"\xB4"=>[77,"Y4"],"\xB5"=>[18,"Y4"],"\xB6"=>[77,"Y5"],"\xB7"=>[18,"Y5"],"\xB8"=>[77,"Y6"],"\xB9"=>[18,"Y6"],"\xBA"=>[77,"Y7"],"\xBB"=>[18,"Y7"],"\xBC"=>[77,"Y8"],"\xBD"=>[18,"Y8"],"\xBE"=>[77,"Y9"],"\xBF"=>[18,"Y9"],"\xC0"=>[77,"Y\x3D"],"\xC1"=>[18,"Y\x3D"],"\xC2"=>[77,"YA"],"\xC3"=>[18,"YA"],"\xC4"=>[77,"Y_"],"\xC5"=>[18,"Y_"],"\xC6"=>[77,"Yb"],"\xC7"=>[18,"Yb"],"\xC8"=>[77,"Yd"],"\xC9"=>[18,"Yd"],"\xCA"=>[77,"Yf"],"\xCB"=>[18,"Yf"],"\xCC"=>[77,"Yg"],"\xCD"=>[18,"Yg"],"\xCE"=>[77,"Yh"],"\xCF"=>[18,"Yh"],"\xD0"=>[77,"Yl"],"\xD1"=>[18,"Yl"],"\xD2"=>[77,"Ym"],"\xD3"=>[18,"Ym"],"\xD4"=>[77,"Yn"],"\xD5"=>[18,"Yn"],"\xD6"=>[77,"Yp"],"\xD7"=>[18,"Yp"],"\xD8"=>[77,"Yr"],"\xD9"=>[18,"Yr"],"\xDA"=>[77,"Yu"],"\xDB"=>[18,"Yu"],"\xDC"=>[0,"Y\x3A"],"\xDD"=>[0,"YB"],"\xDE"=>[0,"YC"],"\xDF"=>[0,"YD"],"\xE0"=>[0,"YE"],"\xE1"=>[0,"YF"],"\xE2"=>[0,"YG"],"\xE3"=>[0,"YH"],"\xE4"=>[0,"YI"],"\xE5"=>[0,"YJ"],"\xE6"=>[0,"YK"],"\xE7"=>[0,"YL"],"\xE8"=>[0,"YM"],"\xE9"=>[0,"YN"],"\xEA"=>[0,"YO"],"\xEB"=>[0,"YP"],"\xEC"=>[0,"YQ"],"\xED"=>[0,"YR"],"\xEE"=>[0,"YS"],"\xEF"=>[0,"YT"],"\xF0"=>[0,"YU"],"\xF1"=>[0,"YV"],"\xF2"=>[0,"YW"],"\xF3"=>[0,"YY"],"\xF4"=>[0,"Yj"],"\xF5"=>[0,"Yk"],"\xF6"=>[0,"Yq"],"\xF7"=>[0,"Yv"],"\xF8"=>[0,"Yw"],"\xF9"=>[0,"Yx"],"\xFA"=>[0,"Yy"],"\xFB"=>[0,"Yz"],"\xFC"=>[82,"Y"],"\xFD"=>[87,"Y"],"\xFE"=>[130,"Y"],"\xFF"=>[9,"Y"],],["\x00"=>[94,"X0"],"\x01"=>[76,"X0"],"\x02"=>[104,"X0"],"\x03"=>[16,"X0"],"\x04"=>[94,"X1"],"\x05"=>[76,"X1"],"\x06"=>[104,"X1"],"\x07"=>[16,"X1"],"\x08"=>[94,"X2"],"\x09"=>[76,"X2"],"\x0A"=>[104,"X2"],"\x0B"=>[16,"X2"],"\x0C"=>[94,"Xa"],"\x0D"=>[76,"Xa"],"\x0E"=>[104,"Xa"],"\x0F"=>[16,"Xa"],"\x10"=>[94,"Xc"],"\x11"=>[76,"Xc"],"\x12"=>[104,"Xc"],"\x13"=>[16,"Xc"],"\x14"=>[94,"Xe"],"\x15"=>[76,"Xe"],"\x16"=>[104,"Xe"],"\x17"=>[16,"Xe"],"\x18"=>[94,"Xi"],"\x19"=>[76,"Xi"],"\x1A"=>[104,"Xi"],"\x1B"=>[16,"Xi"],"\x1C"=>[94,"Xo"],"\x1D"=>[76,"Xo"],"\x1E"=>[104,"Xo"],"\x1F"=>[16,"Xo"],"\x20"=>[94,"Xs"],"\x21"=>[76,"Xs"],"\x22"=>[104,"Xs"],"\x23"=>[16,"Xs"],"\x24"=>[94,"Xt"],"\x25"=>[76,"Xt"],"\x26"=>[104,"Xt"],"\x27"=>[16,"Xt"],"\x28"=>[77,"X\x20"],"\x29"=>[18,"X\x20"],"\x2A"=>[77,"X\x25"],"\x2B"=>[18,"X\x25"],"\x2C"=>[77,"X-"],"-"=>[18,"X-"],"."=>[77,"X."],"\x2F"=>[18,"X."],[77,"X\x2F"],[18,"X\x2F"],[77,"X3"],[18,"X3"],[77,"X4"],[18,"X4"],[77,"X5"],[18,"X5"],[77,"X6"],[18,"X6"],"\x3A"=>[77,"X7"],"\x3B"=>[18,"X7"],"\x3C"=>[77,"X8"],"\x3D"=>[18,"X8"],"\x3E"=>[77,"X9"],"\x3F"=>[18,"X9"],"\x40"=>[77,"X\x3D"],"A"=>[18,"X\x3D"],"B"=>[77,"XA"],"C"=>[18,"XA"],"D"=>[77,"X_"],"E"=>[18,"X_"],"F"=>[77,"Xb"],"G"=>[18,"Xb"],"H"=>[77,"Xd"],"I"=>[18,"Xd"],"J"=>[77,"Xf"],"K"=>[18,"Xf"],"L"=>[77,"Xg"],"M"=>[18,"Xg"],"N"=>[77,"Xh"],"O"=>[18,"Xh"],"P"=>[77,"Xl"],"Q"=>[18,"Xl"],"R"=>[77,"Xm"],"S"=>[18,"Xm"],"T"=>[77,"Xn"],"U"=>[18,"Xn"],"V"=>[77,"Xp"],"W"=>[18,"Xp"],"X"=>[77,"Xr"],"Y"=>[18,"Xr"],"Z"=>[77,"Xu"],"\x5B"=>[18,"Xu"],"\x5C"=>[0,"X\x3A"],"\x5D"=>[0,"XB"],"\x5E"=>[0,"XC"],"_"=>[0,"XD"],"\x60"=>[0,"XE"],"a"=>[0,"XF"],"b"=>[0,"XG"],"c"=>[0,"XH"],"d"=>[0,"XI"],"e"=>[0,"XJ"],"f"=>[0,"XK"],"g"=>[0,"XL"],"h"=>[0,"XM"],"i"=>[0,"XN"],"j"=>[0,"XO"],"k"=>[0,"XP"],"l"=>[0,"XQ"],"m"=>[0,"XR"],"n"=>[0,"XS"],"o"=>[0,"XT"],"p"=>[0,"XU"],"q"=>[0,"XV"],"r"=>[0,"XW"],"s"=>[0,"XY"],"t"=>[0,"Xj"],"u"=>[0,"Xk"],"v"=>[0,"Xq"],"w"=>[0,"Xv"],"x"=>[0,"Xw"],"y"=>[0,"Xx"],"z"=>[0,"Xy"],"\x7B"=>[0,"Xz"],"\x7C"=>[82,"X"],"\x7D"=>[87,"X"],"~"=>[130,"X"],"\x7F"=>[9,"X"],"\x80"=>[94,"Z0"],"\x81"=>[76,"Z0"],"\x82"=>[104,"Z0"],"\x83"=>[16,"Z0"],"\x84"=>[94,"Z1"],"\x85"=>[76,"Z1"],"\x86"=>[104,"Z1"],"\x87"=>[16,"Z1"],"\x88"=>[94,"Z2"],"\x89"=>[76,"Z2"],"\x8A"=>[104,"Z2"],"\x8B"=>[16,"Z2"],"\x8C"=>[94,"Za"],"\x8D"=>[76,"Za"],"\x8E"=>[104,"Za"],"\x8F"=>[16,"Za"],"\x90"=>[94,"Zc"],"\x91"=>[76,"Zc"],"\x92"=>[104,"Zc"],"\x93"=>[16,"Zc"],"\x94"=>[94,"Ze"],"\x95"=>[76,"Ze"],"\x96"=>[104,"Ze"],"\x97"=>[16,"Ze"],"\x98"=>[94,"Zi"],"\x99"=>[76,"Zi"],"\x9A"=>[104,"Zi"],"\x9B"=>[16,"Zi"],"\x9C"=>[94,"Zo"],"\x9D"=>[76,"Zo"],"\x9E"=>[104,"Zo"],"\x9F"=>[16,"Zo"],"\xA0"=>[94,"Zs"],"\xA1"=>[76,"Zs"],"\xA2"=>[104,"Zs"],"\xA3"=>[16,"Zs"],"\xA4"=>[94,"Zt"],"\xA5"=>[76,"Zt"],"\xA6"=>[104,"Zt"],"\xA7"=>[16,"Zt"],"\xA8"=>[77,"Z\x20"],"\xA9"=>[18,"Z\x20"],"\xAA"=>[77,"Z\x25"],"\xAB"=>[18,"Z\x25"],"\xAC"=>[77,"Z-"],"\xAD"=>[18,"Z-"],"\xAE"=>[77,"Z."],"\xAF"=>[18,"Z."],"\xB0"=>[77,"Z\x2F"],"\xB1"=>[18,"Z\x2F"],"\xB2"=>[77,"Z3"],"\xB3"=>[18,"Z3"],"\xB4"=>[77,"Z4"],"\xB5"=>[18,"Z4"],"\xB6"=>[77,"Z5"],"\xB7"=>[18,"Z5"],"\xB8"=>[77,"Z6"],"\xB9"=>[18,"Z6"],"\xBA"=>[77,"Z7"],"\xBB"=>[18,"Z7"],"\xBC"=>[77,"Z8"],"\xBD"=>[18,"Z8"],"\xBE"=>[77,"Z9"],"\xBF"=>[18,"Z9"],"\xC0"=>[77,"Z\x3D"],"\xC1"=>[18,"Z\x3D"],"\xC2"=>[77,"ZA"],"\xC3"=>[18,"ZA"],"\xC4"=>[77,"Z_"],"\xC5"=>[18,"Z_"],"\xC6"=>[77,"Zb"],"\xC7"=>[18,"Zb"],"\xC8"=>[77,"Zd"],"\xC9"=>[18,"Zd"],"\xCA"=>[77,"Zf"],"\xCB"=>[18,"Zf"],"\xCC"=>[77,"Zg"],"\xCD"=>[18,"Zg"],"\xCE"=>[77,"Zh"],"\xCF"=>[18,"Zh"],"\xD0"=>[77,"Zl"],"\xD1"=>[18,"Zl"],"\xD2"=>[77,"Zm"],"\xD3"=>[18,"Zm"],"\xD4"=>[77,"Zn"],"\xD5"=>[18,"Zn"],"\xD6"=>[77,"Zp"],"\xD7"=>[18,"Zp"],"\xD8"=>[77,"Zr"],"\xD9"=>[18,"Zr"],"\xDA"=>[77,"Zu"],"\xDB"=>[18,"Zu"],"\xDC"=>[0,"Z\x3A"],"\xDD"=>[0,"ZB"],"\xDE"=>[0,"ZC"],"\xDF"=>[0,"ZD"],"\xE0"=>[0,"ZE"],"\xE1"=>[0,"ZF"],"\xE2"=>[0,"ZG"],"\xE3"=>[0,"ZH"],"\xE4"=>[0,"ZI"],"\xE5"=>[0,"ZJ"],"\xE6"=>[0,"ZK"],"\xE7"=>[0,"ZL"],"\xE8"=>[0,"ZM"],"\xE9"=>[0,"ZN"],"\xEA"=>[0,"ZO"],"\xEB"=>[0,"ZP"],"\xEC"=>[0,"ZQ"],"\xED"=>[0,"ZR"],"\xEE"=>[0,"ZS"],"\xEF"=>[0,"ZT"],"\xF0"=>[0,"ZU"],"\xF1"=>[0,"ZV"],"\xF2"=>[0,"ZW"],"\xF3"=>[0,"ZY"],"\xF4"=>[0,"Zj"],"\xF5"=>[0,"Zk"],"\xF6"=>[0,"Zq"],"\xF7"=>[0,"Zv"],"\xF8"=>[0,"Zw"],"\xF9"=>[0,"Zx"],"\xFA"=>[0,"Zy"],"\xFB"=>[0,"Zz"],"\xFC"=>[82,"Z"],"\xFD"=>[87,"Z"],"\xFE"=>[130,"Z"],"\xFF"=>[9,"Z"],],["\x00"=>[0,"\x5C0"],"\x01"=>[0,"\x5C1"],"\x02"=>[0,"\x5C2"],"\x03"=>[0,"\x5Ca"],"\x04"=>[0,"\x5Cc"],"\x05"=>[0,"\x5Ce"],"\x06"=>[0,"\x5Ci"],"\x07"=>[0,"\x5Co"],"\x08"=>[0,"\x5Cs"],"\x09"=>[0,"\x5Ct"],"\x0A"=>[73,"\x5C"],"\x0B"=>[88,"\x5C"],"\x0C"=>[89,"\x5C"],"\x0D"=>[96,"\x5C"],"\x0E"=>[97,"\x5C"],"\x0F"=>[99,"\x5C"],"\x10"=>[106,"\x5C"],"\x11"=>[136,"\x5C"],"\x12"=>[139,"\x5C"],"\x13"=>[141,"\x5C"],"\x14"=>[145,"\x5C"],"\x15"=>[147,"\x5C"],"\x16"=>[149,"\x5C"],"\x17"=>[101,"\x5C"],"\x18"=>[112,"\x5C"],"\x19"=>[117,"\x5C"],"\x1A"=>[120,"\x5C"],"\x1B"=>[124,"\x5C"],"\x1C"=>[127,"\x5C"],"\x1D"=>[144,"\x5C"],"\x1E"=>[152,"\x5C"],"\x1F"=>[11,"\x5C"],"\x20"=>[0,"\xC30"],"\x21"=>[0,"\xC31"],"\x22"=>[0,"\xC32"],"\x23"=>[0,"\xC3a"],"\x24"=>[0,"\xC3c"],"\x25"=>[0,"\xC3e"],"\x26"=>[0,"\xC3i"],"\x27"=>[0,"\xC3o"],"\x28"=>[0,"\xC3s"],"\x29"=>[0,"\xC3t"],"\x2A"=>[73,"\xC3"],"\x2B"=>[88,"\xC3"],"\x2C"=>[89,"\xC3"],"-"=>[96,"\xC3"],"."=>[97,"\xC3"],"\x2F"=>[99,"\xC3"],[106,"\xC3"],[136,"\xC3"],[139,"\xC3"],[141,"\xC3"],[145,"\xC3"],[147,"\xC3"],[149,"\xC3"],[101,"\xC3"],[112,"\xC3"],[117,"\xC3"],"\x3A"=>[120,"\xC3"],"\x3B"=>[124,"\xC3"],"\x3C"=>[127,"\xC3"],"\x3D"=>[144,"\xC3"],"\x3E"=>[152,"\xC3"],"\x3F"=>[11,"\xC3"],"\x40"=>[0,"\xD00"],"A"=>[0,"\xD01"],"B"=>[0,"\xD02"],"C"=>[0,"\xD0a"],"D"=>[0,"\xD0c"],"E"=>[0,"\xD0e"],"F"=>[0,"\xD0i"],"G"=>[0,"\xD0o"],"H"=>[0,"\xD0s"],"I"=>[0,"\xD0t"],"J"=>[73,"\xD0"],"K"=>[88,"\xD0"],"L"=>[89,"\xD0"],"M"=>[96,"\xD0"],"N"=>[97,"\xD0"],"O"=>[99,"\xD0"],"P"=>[106,"\xD0"],"Q"=>[136,"\xD0"],"R"=>[139,"\xD0"],"S"=>[141,"\xD0"],"T"=>[145,"\xD0"],"U"=>[147,"\xD0"],"V"=>[149,"\xD0"],"W"=>[101,"\xD0"],"X"=>[112,"\xD0"],"Y"=>[117,"\xD0"],"Z"=>[120,"\xD0"],"\x5B"=>[124,"\xD0"],"\x5C"=>[127,"\xD0"],"\x5D"=>[144,"\xD0"],"\x5E"=>[152,"\xD0"],"_"=>[11,"\xD0"],"\x60"=>[92,"\x80"],"a"=>[95,"\x80"],"b"=>[137,"\x80"],"c"=>[142,"\x80"],"d"=>[150,"\x80"],"e"=>[74,"\x80"],"f"=>[90,"\x80"],"g"=>[98,"\x80"],"h"=>[107,"\x80"],"i"=>[140,"\x80"],"j"=>[146,"\x80"],"k"=>[102,"\x80"],"l"=>[113,"\x80"],"m"=>[121,"\x80"],"n"=>[128,"\x80"],"o"=>[12,"\x80"],"p"=>[92,"\x82"],"q"=>[95,"\x82"],"r"=>[137,"\x82"],"s"=>[142,"\x82"],"t"=>[150,"\x82"],"u"=>[74,"\x82"],"v"=>[90,"\x82"],"w"=>[98,"\x82"],"x"=>[107,"\x82"],"y"=>[140,"\x82"],"z"=>[146,"\x82"],"\x7B"=>[102,"\x82"],"\x7C"=>[113,"\x82"],"\x7D"=>[121,"\x82"],"~"=>[128,"\x82"],"\x7F"=>[12,"\x82"],"\x80"=>[92,"\x83"],"\x81"=>[95,"\x83"],"\x82"=>[137,"\x83"],"\x83"=>[142,"\x83"],"\x84"=>[150,"\x83"],"\x85"=>[74,"\x83"],"\x86"=>[90,"\x83"],"\x87"=>[98,"\x83"],"\x88"=>[107,"\x83"],"\x89"=>[140,"\x83"],"\x8A"=>[146,"\x83"],"\x8B"=>[102,"\x83"],"\x8C"=>[113,"\x83"],"\x8D"=>[121,"\x83"],"\x8E"=>[128,"\x83"],"\x8F"=>[12,"\x83"],"\x90"=>[92,"\xA2"],"\x91"=>[95,"\xA2"],"\x92"=>[137,"\xA2"],"\x93"=>[142,"\xA2"],"\x94"=>[150,"\xA2"],"\x95"=>[74,"\xA2"],"\x96"=>[90,"\xA2"],"\x97"=>[98,"\xA2"],"\x98"=>[107,"\xA2"],"\x99"=>[140,"\xA2"],"\x9A"=>[146,"\xA2"],"\x9B"=>[102,"\xA2"],"\x9C"=>[113,"\xA2"],"\x9D"=>[121,"\xA2"],"\x9E"=>[128,"\xA2"],"\x9F"=>[12,"\xA2"],"\xA0"=>[92,"\xB8"],"\xA1"=>[95,"\xB8"],"\xA2"=>[137,"\xB8"],"\xA3"=>[142,"\xB8"],"\xA4"=>[150,"\xB8"],"\xA5"=>[74,"\xB8"],"\xA6"=>[90,"\xB8"],"\xA7"=>[98,"\xB8"],"\xA8"=>[107,"\xB8"],"\xA9"=>[140,"\xB8"],"\xAA"=>[146,"\xB8"],"\xAB"=>[102,"\xB8"],"\xAC"=>[113,"\xB8"],"\xAD"=>[121,"\xB8"],"\xAE"=>[128,"\xB8"],"\xAF"=>[12,"\xB8"],"\xB0"=>[92,"\xC2"],"\xB1"=>[95,"\xC2"],"\xB2"=>[137,"\xC2"],"\xB3"=>[142,"\xC2"],"\xB4"=>[150,"\xC2"],"\xB5"=>[74,"\xC2"],"\xB6"=>[90,"\xC2"],"\xB7"=>[98,"\xC2"],"\xB8"=>[107,"\xC2"],"\xB9"=>[140,"\xC2"],"\xBA"=>[146,"\xC2"],"\xBB"=>[102,"\xC2"],"\xBC"=>[113,"\xC2"],"\xBD"=>[121,"\xC2"],"\xBE"=>[128,"\xC2"],"\xBF"=>[12,"\xC2"],"\xC0"=>[92,"\xE0"],"\xC1"=>[95,"\xE0"],"\xC2"=>[137,"\xE0"],"\xC3"=>[142,"\xE0"],"\xC4"=>[150,"\xE0"],"\xC5"=>[74,"\xE0"],"\xC6"=>[90,"\xE0"],"\xC7"=>[98,"\xE0"],"\xC8"=>[107,"\xE0"],"\xC9"=>[140,"\xE0"],"\xCA"=>[146,"\xE0"],"\xCB"=>[102,"\xE0"],"\xCC"=>[113,"\xE0"],"\xCD"=>[121,"\xE0"],"\xCE"=>[128,"\xE0"],"\xCF"=>[12,"\xE0"],"\xD0"=>[92,"\xE2"],"\xD1"=>[95,"\xE2"],"\xD2"=>[137,"\xE2"],"\xD3"=>[142,"\xE2"],"\xD4"=>[150,"\xE2"],"\xD5"=>[74,"\xE2"],"\xD6"=>[90,"\xE2"],"\xD7"=>[98,"\xE2"],"\xD8"=>[107,"\xE2"],"\xD9"=>[140,"\xE2"],"\xDA"=>[146,"\xE2"],"\xDB"=>[102,"\xE2"],"\xDC"=>[113,"\xE2"],"\xDD"=>[121,"\xE2"],"\xDE"=>[128,"\xE2"],"\xDF"=>[12,"\xE2"],"\xE0"=>[93,"\x99"],"\xE1"=>[138,"\x99"],"\xE2"=>[75,"\x99"],"\xE3"=>[91,"\x99"],"\xE4"=>[108,"\x99"],"\xE5"=>[103,"\x99"],"\xE6"=>[114,"\x99"],"\xE7"=>[14,"\x99"],"\xE8"=>[93,"\xA1"],"\xE9"=>[138,"\xA1"],"\xEA"=>[75,"\xA1"],"\xEB"=>[91,"\xA1"],"\xEC"=>[108,"\xA1"],"\xED"=>[103,"\xA1"],"\xEE"=>[114,"\xA1"],"\xEF"=>[14,"\xA1"],"\xF0"=>[93,"\xA7"],"\xF1"=>[138,"\xA7"],"\xF2"=>[75,"\xA7"],"\xF3"=>[91,"\xA7"],"\xF4"=>[108,"\xA7"],"\xF5"=>[103,"\xA7"],"\xF6"=>[114,"\xA7"],"\xF7"=>[14,"\xA7"],"\xF8"=>[93,"\xAC"],"\xF9"=>[138,"\xAC"],"\xFA"=>[75,"\xAC"],"\xFB"=>[91,"\xAC"],"\xFC"=>[108,"\xAC"],"\xFD"=>[103,"\xAC"],"\xFE"=>[114,"\xAC"],"\xFF"=>[14,"\xAC"],],["\x00"=>[94,"\x5C0"],"\x01"=>[76,"\x5C0"],"\x02"=>[104,"\x5C0"],"\x03"=>[16,"\x5C0"],"\x04"=>[94,"\x5C1"],"\x05"=>[76,"\x5C1"],"\x06"=>[104,"\x5C1"],"\x07"=>[16,"\x5C1"],"\x08"=>[94,"\x5C2"],"\x09"=>[76,"\x5C2"],"\x0A"=>[104,"\x5C2"],"\x0B"=>[16,"\x5C2"],"\x0C"=>[94,"\x5Ca"],"\x0D"=>[76,"\x5Ca"],"\x0E"=>[104,"\x5Ca"],"\x0F"=>[16,"\x5Ca"],"\x10"=>[94,"\x5Cc"],"\x11"=>[76,"\x5Cc"],"\x12"=>[104,"\x5Cc"],"\x13"=>[16,"\x5Cc"],"\x14"=>[94,"\x5Ce"],"\x15"=>[76,"\x5Ce"],"\x16"=>[104,"\x5Ce"],"\x17"=>[16,"\x5Ce"],"\x18"=>[94,"\x5Ci"],"\x19"=>[76,"\x5Ci"],"\x1A"=>[104,"\x5Ci"],"\x1B"=>[16,"\x5Ci"],"\x1C"=>[94,"\x5Co"],"\x1D"=>[76,"\x5Co"],"\x1E"=>[104,"\x5Co"],"\x1F"=>[16,"\x5Co"],"\x20"=>[94,"\x5Cs"],"\x21"=>[76,"\x5Cs"],"\x22"=>[104,"\x5Cs"],"\x23"=>[16,"\x5Cs"],"\x24"=>[94,"\x5Ct"],"\x25"=>[76,"\x5Ct"],"\x26"=>[104,"\x5Ct"],"\x27"=>[16,"\x5Ct"],"\x28"=>[77,"\x5C\x20"],"\x29"=>[18,"\x5C\x20"],"\x2A"=>[77,"\x5C\x25"],"\x2B"=>[18,"\x5C\x25"],"\x2C"=>[77,"\x5C-"],"-"=>[18,"\x5C-"],"."=>[77,"\x5C."],"\x2F"=>[18,"\x5C."],[77,"\x5C\x2F"],[18,"\x5C\x2F"],[77,"\x5C3"],[18,"\x5C3"],[77,"\x5C4"],[18,"\x5C4"],[77,"\x5C5"],[18,"\x5C5"],[77,"\x5C6"],[18,"\x5C6"],"\x3A"=>[77,"\x5C7"],"\x3B"=>[18,"\x5C7"],"\x3C"=>[77,"\x5C8"],"\x3D"=>[18,"\x5C8"],"\x3E"=>[77,"\x5C9"],"\x3F"=>[18,"\x5C9"],"\x40"=>[77,"\x5C\x3D"],"A"=>[18,"\x5C\x3D"],"B"=>[77,"\x5CA"],"C"=>[18,"\x5CA"],"D"=>[77,"\x5C_"],"E"=>[18,"\x5C_"],"F"=>[77,"\x5Cb"],"G"=>[18,"\x5Cb"],"H"=>[77,"\x5Cd"],"I"=>[18,"\x5Cd"],"J"=>[77,"\x5Cf"],"K"=>[18,"\x5Cf"],"L"=>[77,"\x5Cg"],"M"=>[18,"\x5Cg"],"N"=>[77,"\x5Ch"],"O"=>[18,"\x5Ch"],"P"=>[77,"\x5Cl"],"Q"=>[18,"\x5Cl"],"R"=>[77,"\x5Cm"],"S"=>[18,"\x5Cm"],"T"=>[77,"\x5Cn"],"U"=>[18,"\x5Cn"],"V"=>[77,"\x5Cp"],"W"=>[18,"\x5Cp"],"X"=>[77,"\x5Cr"],"Y"=>[18,"\x5Cr"],"Z"=>[77,"\x5Cu"],"\x5B"=>[18,"\x5Cu"],"\x5C"=>[0,"\x5C\x3A"],"\x5D"=>[0,"\x5CB"],"\x5E"=>[0,"\x5CC"],"_"=>[0,"\x5CD"],"\x60"=>[0,"\x5CE"],"a"=>[0,"\x5CF"],"b"=>[0,"\x5CG"],"c"=>[0,"\x5CH"],"d"=>[0,"\x5CI"],"e"=>[0,"\x5CJ"],"f"=>[0,"\x5CK"],"g"=>[0,"\x5CL"],"h"=>[0,"\x5CM"],"i"=>[0,"\x5CN"],"j"=>[0,"\x5CO"],"k"=>[0,"\x5CP"],"l"=>[0,"\x5CQ"],"m"=>[0,"\x5CR"],"n"=>[0,"\x5CS"],"o"=>[0,"\x5CT"],"p"=>[0,"\x5CU"],"q"=>[0,"\x5CV"],"r"=>[0,"\x5CW"],"s"=>[0,"\x5CY"],"t"=>[0,"\x5Cj"],"u"=>[0,"\x5Ck"],"v"=>[0,"\x5Cq"],"w"=>[0,"\x5Cv"],"x"=>[0,"\x5Cw"],"y"=>[0,"\x5Cx"],"z"=>[0,"\x5Cy"],"\x7B"=>[0,"\x5Cz"],"\x7C"=>[82,"\x5C"],"\x7D"=>[87,"\x5C"],"~"=>[130,"\x5C"],"\x7F"=>[9,"\x5C"],"\x80"=>[94,"\xC30"],"\x81"=>[76,"\xC30"],"\x82"=>[104,"\xC30"],"\x83"=>[16,"\xC30"],"\x84"=>[94,"\xC31"],"\x85"=>[76,"\xC31"],"\x86"=>[104,"\xC31"],"\x87"=>[16,"\xC31"],"\x88"=>[94,"\xC32"],"\x89"=>[76,"\xC32"],"\x8A"=>[104,"\xC32"],"\x8B"=>[16,"\xC32"],"\x8C"=>[94,"\xC3a"],"\x8D"=>[76,"\xC3a"],"\x8E"=>[104,"\xC3a"],"\x8F"=>[16,"\xC3a"],"\x90"=>[94,"\xC3c"],"\x91"=>[76,"\xC3c"],"\x92"=>[104,"\xC3c"],"\x93"=>[16,"\xC3c"],"\x94"=>[94,"\xC3e"],"\x95"=>[76,"\xC3e"],"\x96"=>[104,"\xC3e"],"\x97"=>[16,"\xC3e"],"\x98"=>[94,"\xC3i"],"\x99"=>[76,"\xC3i"],"\x9A"=>[104,"\xC3i"],"\x9B"=>[16,"\xC3i"],"\x9C"=>[94,"\xC3o"],"\x9D"=>[76,"\xC3o"],"\x9E"=>[104,"\xC3o"],"\x9F"=>[16,"\xC3o"],"\xA0"=>[94,"\xC3s"],"\xA1"=>[76,"\xC3s"],"\xA2"=>[104,"\xC3s"],"\xA3"=>[16,"\xC3s"],"\xA4"=>[94,"\xC3t"],"\xA5"=>[76,"\xC3t"],"\xA6"=>[104,"\xC3t"],"\xA7"=>[16,"\xC3t"],"\xA8"=>[77,"\xC3\x20"],"\xA9"=>[18,"\xC3\x20"],"\xAA"=>[77,"\xC3\x25"],"\xAB"=>[18,"\xC3\x25"],"\xAC"=>[77,"\xC3-"],"\xAD"=>[18,"\xC3-"],"\xAE"=>[77,"\xC3."],"\xAF"=>[18,"\xC3."],"\xB0"=>[77,"\xC3\x2F"],"\xB1"=>[18,"\xC3\x2F"],"\xB2"=>[77,"\xC33"],"\xB3"=>[18,"\xC33"],"\xB4"=>[77,"\xC34"],"\xB5"=>[18,"\xC34"],"\xB6"=>[77,"\xC35"],"\xB7"=>[18,"\xC35"],"\xB8"=>[77,"\xC36"],"\xB9"=>[18,"\xC36"],"\xBA"=>[77,"\xC37"],"\xBB"=>[18,"\xC37"],"\xBC"=>[77,"\xC38"],"\xBD"=>[18,"\xC38"],"\xBE"=>[77,"\xC39"],"\xBF"=>[18,"\xC39"],"\xC0"=>[77,"\xC3\x3D"],"\xC1"=>[18,"\xC3\x3D"],"\xC2"=>[77,"\xC3A"],"\xC3"=>[18,"\xC3A"],"\xC4"=>[77,"\xC3_"],"\xC5"=>[18,"\xC3_"],"\xC6"=>[77,"\xC3b"],"\xC7"=>[18,"\xC3b"],"\xC8"=>[77,"\xC3d"],"\xC9"=>[18,"\xC3d"],"\xCA"=>[77,"\xC3f"],"\xCB"=>[18,"\xC3f"],"\xCC"=>[77,"\xC3g"],"\xCD"=>[18,"\xC3g"],"\xCE"=>[77,"\xC3h"],"\xCF"=>[18,"\xC3h"],"\xD0"=>[77,"\xC3l"],"\xD1"=>[18,"\xC3l"],"\xD2"=>[77,"\xC3m"],"\xD3"=>[18,"\xC3m"],"\xD4"=>[77,"\xC3n"],"\xD5"=>[18,"\xC3n"],"\xD6"=>[77,"\xC3p"],"\xD7"=>[18,"\xC3p"],"\xD8"=>[77,"\xC3r"],"\xD9"=>[18,"\xC3r"],"\xDA"=>[77,"\xC3u"],"\xDB"=>[18,"\xC3u"],"\xDC"=>[0,"\xC3\x3A"],"\xDD"=>[0,"\xC3B"],"\xDE"=>[0,"\xC3C"],"\xDF"=>[0,"\xC3D"],"\xE0"=>[0,"\xC3E"],"\xE1"=>[0,"\xC3F"],"\xE2"=>[0,"\xC3G"],"\xE3"=>[0,"\xC3H"],"\xE4"=>[0,"\xC3I"],"\xE5"=>[0,"\xC3J"],"\xE6"=>[0,"\xC3K"],"\xE7"=>[0,"\xC3L"],"\xE8"=>[0,"\xC3M"],"\xE9"=>[0,"\xC3N"],"\xEA"=>[0,"\xC3O"],"\xEB"=>[0,"\xC3P"],"\xEC"=>[0,"\xC3Q"],"\xED"=>[0,"\xC3R"],"\xEE"=>[0,"\xC3S"],"\xEF"=>[0,"\xC3T"],"\xF0"=>[0,"\xC3U"],"\xF1"=>[0,"\xC3V"],"\xF2"=>[0,"\xC3W"],"\xF3"=>[0,"\xC3Y"],"\xF4"=>[0,"\xC3j"],"\xF5"=>[0,"\xC3k"],"\xF6"=>[0,"\xC3q"],"\xF7"=>[0,"\xC3v"],"\xF8"=>[0,"\xC3w"],"\xF9"=>[0,"\xC3x"],"\xFA"=>[0,"\xC3y"],"\xFB"=>[0,"\xC3z"],"\xFC"=>[82,"\xC3"],"\xFD"=>[87,"\xC3"],"\xFE"=>[130,"\xC3"],"\xFF"=>[9,"\xC3"],],["\x00"=>[77,"\x5C0"],"\x01"=>[18,"\x5C0"],"\x02"=>[77,"\x5C1"],"\x03"=>[18,"\x5C1"],"\x04"=>[77,"\x5C2"],"\x05"=>[18,"\x5C2"],"\x06"=>[77,"\x5Ca"],"\x07"=>[18,"\x5Ca"],"\x08"=>[77,"\x5Cc"],"\x09"=>[18,"\x5Cc"],"\x0A"=>[77,"\x5Ce"],"\x0B"=>[18,"\x5Ce"],"\x0C"=>[77,"\x5Ci"],"\x0D"=>[18,"\x5Ci"],"\x0E"=>[77,"\x5Co"],"\x0F"=>[18,"\x5Co"],"\x10"=>[77,"\x5Cs"],"\x11"=>[18,"\x5Cs"],"\x12"=>[77,"\x5Ct"],"\x13"=>[18,"\x5Ct"],"\x14"=>[0,"\x5C\x20"],"\x15"=>[0,"\x5C\x25"],"\x16"=>[0,"\x5C-"],"\x17"=>[0,"\x5C."],"\x18"=>[0,"\x5C\x2F"],"\x19"=>[0,"\x5C3"],"\x1A"=>[0,"\x5C4"],"\x1B"=>[0,"\x5C5"],"\x1C"=>[0,"\x5C6"],"\x1D"=>[0,"\x5C7"],"\x1E"=>[0,"\x5C8"],"\x1F"=>[0,"\x5C9"],"\x20"=>[0,"\x5C\x3D"],"\x21"=>[0,"\x5CA"],"\x22"=>[0,"\x5C_"],"\x23"=>[0,"\x5Cb"],"\x24"=>[0,"\x5Cd"],"\x25"=>[0,"\x5Cf"],"\x26"=>[0,"\x5Cg"],"\x27"=>[0,"\x5Ch"],"\x28"=>[0,"\x5Cl"],"\x29"=>[0,"\x5Cm"],"\x2A"=>[0,"\x5Cn"],"\x2B"=>[0,"\x5Cp"],"\x2C"=>[0,"\x5Cr"],"-"=>[0,"\x5Cu"],"."=>[100,"\x5C"],"\x2F"=>[110,"\x5C"],[111,"\x5C"],[115,"\x5C"],[116,"\x5C"],[118,"\x5C"],[119,"\x5C"],[122,"\x5C"],[123,"\x5C"],[125,"\x5C"],[126,"\x5C"],[129,"\x5C"],"\x3A"=>[143,"\x5C"],"\x3B"=>[148,"\x5C"],"\x3C"=>[151,"\x5C"],"\x3D"=>[153,"\x5C"],"\x3E"=>[83,"\x5C"],"\x3F"=>[10,"\x5C"],"\x40"=>[77,"\xC30"],"A"=>[18,"\xC30"],"B"=>[77,"\xC31"],"C"=>[18,"\xC31"],"D"=>[77,"\xC32"],"E"=>[18,"\xC32"],"F"=>[77,"\xC3a"],"G"=>[18,"\xC3a"],"H"=>[77,"\xC3c"],"I"=>[18,"\xC3c"],"J"=>[77,"\xC3e"],"K"=>[18,"\xC3e"],"L"=>[77,"\xC3i"],"M"=>[18,"\xC3i"],"N"=>[77,"\xC3o"],"O"=>[18,"\xC3o"],"P"=>[77,"\xC3s"],"Q"=>[18,"\xC3s"],"R"=>[77,"\xC3t"],"S"=>[18,"\xC3t"],"T"=>[0,"\xC3\x20"],"U"=>[0,"\xC3\x25"],"V"=>[0,"\xC3-"],"W"=>[0,"\xC3."],"X"=>[0,"\xC3\x2F"],"Y"=>[0,"\xC33"],"Z"=>[0,"\xC34"],"\x5B"=>[0,"\xC35"],"\x5C"=>[0,"\xC36"],"\x5D"=>[0,"\xC37"],"\x5E"=>[0,"\xC38"],"_"=>[0,"\xC39"],"\x60"=>[0,"\xC3\x3D"],"a"=>[0,"\xC3A"],"b"=>[0,"\xC3_"],"c"=>[0,"\xC3b"],"d"=>[0,"\xC3d"],"e"=>[0,"\xC3f"],"f"=>[0,"\xC3g"],"g"=>[0,"\xC3h"],"h"=>[0,"\xC3l"],"i"=>[0,"\xC3m"],"j"=>[0,"\xC3n"],"k"=>[0,"\xC3p"],"l"=>[0,"\xC3r"],"m"=>[0,"\xC3u"],"n"=>[100,"\xC3"],"o"=>[110,"\xC3"],"p"=>[111,"\xC3"],"q"=>[115,"\xC3"],"r"=>[116,"\xC3"],"s"=>[118,"\xC3"],"t"=>[119,"\xC3"],"u"=>[122,"\xC3"],"v"=>[123,"\xC3"],"w"=>[125,"\xC3"],"x"=>[126,"\xC3"],"y"=>[129,"\xC3"],"z"=>[143,"\xC3"],"\x7B"=>[148,"\xC3"],"\x7C"=>[151,"\xC3"],"\x7D"=>[153,"\xC3"],"~"=>[83,"\xC3"],"\x7F"=>[10,"\xC3"],"\x80"=>[77,"\xD00"],"\x81"=>[18,"\xD00"],"\x82"=>[77,"\xD01"],"\x83"=>[18,"\xD01"],"\x84"=>[77,"\xD02"],"\x85"=>[18,"\xD02"],"\x86"=>[77,"\xD0a"],"\x87"=>[18,"\xD0a"],"\x88"=>[77,"\xD0c"],"\x89"=>[18,"\xD0c"],"\x8A"=>[77,"\xD0e"],"\x8B"=>[18,"\xD0e"],"\x8C"=>[77,"\xD0i"],"\x8D"=>[18,"\xD0i"],"\x8E"=>[77,"\xD0o"],"\x8F"=>[18,"\xD0o"],"\x90"=>[77,"\xD0s"],"\x91"=>[18,"\xD0s"],"\x92"=>[77,"\xD0t"],"\x93"=>[18,"\xD0t"],"\x94"=>[0,"\xD0\x20"],"\x95"=>[0,"\xD0\x25"],"\x96"=>[0,"\xD0-"],"\x97"=>[0,"\xD0."],"\x98"=>[0,"\xD0\x2F"],"\x99"=>[0,"\xD03"],"\x9A"=>[0,"\xD04"],"\x9B"=>[0,"\xD05"],"\x9C"=>[0,"\xD06"],"\x9D"=>[0,"\xD07"],"\x9E"=>[0,"\xD08"],"\x9F"=>[0,"\xD09"],"\xA0"=>[0,"\xD0\x3D"],"\xA1"=>[0,"\xD0A"],"\xA2"=>[0,"\xD0_"],"\xA3"=>[0,"\xD0b"],"\xA4"=>[0,"\xD0d"],"\xA5"=>[0,"\xD0f"],"\xA6"=>[0,"\xD0g"],"\xA7"=>[0,"\xD0h"],"\xA8"=>[0,"\xD0l"],"\xA9"=>[0,"\xD0m"],"\xAA"=>[0,"\xD0n"],"\xAB"=>[0,"\xD0p"],"\xAC"=>[0,"\xD0r"],"\xAD"=>[0,"\xD0u"],"\xAE"=>[100,"\xD0"],"\xAF"=>[110,"\xD0"],"\xB0"=>[111,"\xD0"],"\xB1"=>[115,"\xD0"],"\xB2"=>[116,"\xD0"],"\xB3"=>[118,"\xD0"],"\xB4"=>[119,"\xD0"],"\xB5"=>[122,"\xD0"],"\xB6"=>[123,"\xD0"],"\xB7"=>[125,"\xD0"],"\xB8"=>[126,"\xD0"],"\xB9"=>[129,"\xD0"],"\xBA"=>[143,"\xD0"],"\xBB"=>[148,"\xD0"],"\xBC"=>[151,"\xD0"],"\xBD"=>[153,"\xD0"],"\xBE"=>[83,"\xD0"],"\xBF"=>[10,"\xD0"],"\xC0"=>[0,"\x800"],"\xC1"=>[0,"\x801"],"\xC2"=>[0,"\x802"],"\xC3"=>[0,"\x80a"],"\xC4"=>[0,"\x80c"],"\xC5"=>[0,"\x80e"],"\xC6"=>[0,"\x80i"],"\xC7"=>[0,"\x80o"],"\xC8"=>[0,"\x80s"],"\xC9"=>[0,"\x80t"],"\xCA"=>[73,"\x80"],"\xCB"=>[88,"\x80"],"\xCC"=>[89,"\x80"],"\xCD"=>[96,"\x80"],"\xCE"=>[97,"\x80"],"\xCF"=>[99,"\x80"],"\xD0"=>[106,"\x80"],"\xD1"=>[136,"\x80"],"\xD2"=>[139,"\x80"],"\xD3"=>[141,"\x80"],"\xD4"=>[145,"\x80"],"\xD5"=>[147,"\x80"],"\xD6"=>[149,"\x80"],"\xD7"=>[101,"\x80"],"\xD8"=>[112,"\x80"],"\xD9"=>[117,"\x80"],"\xDA"=>[120,"\x80"],"\xDB"=>[124,"\x80"],"\xDC"=>[127,"\x80"],"\xDD"=>[144,"\x80"],"\xDE"=>[152,"\x80"],"\xDF"=>[11,"\x80"],"\xE0"=>[0,"\x820"],"\xE1"=>[0,"\x821"],"\xE2"=>[0,"\x822"],"\xE3"=>[0,"\x82a"],"\xE4"=>[0,"\x82c"],"\xE5"=>[0,"\x82e"],"\xE6"=>[0,"\x82i"],"\xE7"=>[0,"\x82o"],"\xE8"=>[0,"\x82s"],"\xE9"=>[0,"\x82t"],"\xEA"=>[73,"\x82"],"\xEB"=>[88,"\x82"],"\xEC"=>[89,"\x82"],"\xED"=>[96,"\x82"],"\xEE"=>[97,"\x82"],"\xEF"=>[99,"\x82"],"\xF0"=>[106,"\x82"],"\xF1"=>[136,"\x82"],"\xF2"=>[139,"\x82"],"\xF3"=>[141,"\x82"],"\xF4"=>[145,"\x82"],"\xF5"=>[147,"\x82"],"\xF6"=>[149,"\x82"],"\xF7"=>[101,"\x82"],"\xF8"=>[112,"\x82"],"\xF9"=>[117,"\x82"],"\xFA"=>[120,"\x82"],"\xFB"=>[124,"\x82"],"\xFC"=>[127,"\x82"],"\xFD"=>[144,"\x82"],"\xFE"=>[152,"\x82"],"\xFF"=>[11,"\x82"],],["\x00"=>[94,"\x5D0"],"\x01"=>[76,"\x5D0"],"\x02"=>[104,"\x5D0"],"\x03"=>[16,"\x5D0"],"\x04"=>[94,"\x5D1"],"\x05"=>[76,"\x5D1"],"\x06"=>[104,"\x5D1"],"\x07"=>[16,"\x5D1"],"\x08"=>[94,"\x5D2"],"\x09"=>[76,"\x5D2"],"\x0A"=>[104,"\x5D2"],"\x0B"=>[16,"\x5D2"],"\x0C"=>[94,"\x5Da"],"\x0D"=>[76,"\x5Da"],"\x0E"=>[104,"\x5Da"],"\x0F"=>[16,"\x5Da"],"\x10"=>[94,"\x5Dc"],"\x11"=>[76,"\x5Dc"],"\x12"=>[104,"\x5Dc"],"\x13"=>[16,"\x5Dc"],"\x14"=>[94,"\x5De"],"\x15"=>[76,"\x5De"],"\x16"=>[104,"\x5De"],"\x17"=>[16,"\x5De"],"\x18"=>[94,"\x5Di"],"\x19"=>[76,"\x5Di"],"\x1A"=>[104,"\x5Di"],"\x1B"=>[16,"\x5Di"],"\x1C"=>[94,"\x5Do"],"\x1D"=>[76,"\x5Do"],"\x1E"=>[104,"\x5Do"],"\x1F"=>[16,"\x5Do"],"\x20"=>[94,"\x5Ds"],"\x21"=>[76,"\x5Ds"],"\x22"=>[104,"\x5Ds"],"\x23"=>[16,"\x5Ds"],"\x24"=>[94,"\x5Dt"],"\x25"=>[76,"\x5Dt"],"\x26"=>[104,"\x5Dt"],"\x27"=>[16,"\x5Dt"],"\x28"=>[77,"\x5D\x20"],"\x29"=>[18,"\x5D\x20"],"\x2A"=>[77,"\x5D\x25"],"\x2B"=>[18,"\x5D\x25"],"\x2C"=>[77,"\x5D-"],"-"=>[18,"\x5D-"],"."=>[77,"\x5D."],"\x2F"=>[18,"\x5D."],[77,"\x5D\x2F"],[18,"\x5D\x2F"],[77,"\x5D3"],[18,"\x5D3"],[77,"\x5D4"],[18,"\x5D4"],[77,"\x5D5"],[18,"\x5D5"],[77,"\x5D6"],[18,"\x5D6"],"\x3A"=>[77,"\x5D7"],"\x3B"=>[18,"\x5D7"],"\x3C"=>[77,"\x5D8"],"\x3D"=>[18,"\x5D8"],"\x3E"=>[77,"\x5D9"],"\x3F"=>[18,"\x5D9"],"\x40"=>[77,"\x5D\x3D"],"A"=>[18,"\x5D\x3D"],"B"=>[77,"\x5DA"],"C"=>[18,"\x5DA"],"D"=>[77,"\x5D_"],"E"=>[18,"\x5D_"],"F"=>[77,"\x5Db"],"G"=>[18,"\x5Db"],"H"=>[77,"\x5Dd"],"I"=>[18,"\x5Dd"],"J"=>[77,"\x5Df"],"K"=>[18,"\x5Df"],"L"=>[77,"\x5Dg"],"M"=>[18,"\x5Dg"],"N"=>[77,"\x5Dh"],"O"=>[18,"\x5Dh"],"P"=>[77,"\x5Dl"],"Q"=>[18,"\x5Dl"],"R"=>[77,"\x5Dm"],"S"=>[18,"\x5Dm"],"T"=>[77,"\x5Dn"],"U"=>[18,"\x5Dn"],"V"=>[77,"\x5Dp"],"W"=>[18,"\x5Dp"],"X"=>[77,"\x5Dr"],"Y"=>[18,"\x5Dr"],"Z"=>[77,"\x5Du"],"\x5B"=>[18,"\x5Du"],"\x5C"=>[0,"\x5D\x3A"],"\x5D"=>[0,"\x5DB"],"\x5E"=>[0,"\x5DC"],"_"=>[0,"\x5DD"],"\x60"=>[0,"\x5DE"],"a"=>[0,"\x5DF"],"b"=>[0,"\x5DG"],"c"=>[0,"\x5DH"],"d"=>[0,"\x5DI"],"e"=>[0,"\x5DJ"],"f"=>[0,"\x5DK"],"g"=>[0,"\x5DL"],"h"=>[0,"\x5DM"],"i"=>[0,"\x5DN"],"j"=>[0,"\x5DO"],"k"=>[0,"\x5DP"],"l"=>[0,"\x5DQ"],"m"=>[0,"\x5DR"],"n"=>[0,"\x5DS"],"o"=>[0,"\x5DT"],"p"=>[0,"\x5DU"],"q"=>[0,"\x5DV"],"r"=>[0,"\x5DW"],"s"=>[0,"\x5DY"],"t"=>[0,"\x5Dj"],"u"=>[0,"\x5Dk"],"v"=>[0,"\x5Dq"],"w"=>[0,"\x5Dv"],"x"=>[0,"\x5Dw"],"y"=>[0,"\x5Dx"],"z"=>[0,"\x5Dy"],"\x7B"=>[0,"\x5Dz"],"\x7C"=>[82,"\x5D"],"\x7D"=>[87,"\x5D"],"~"=>[130,"\x5D"],"\x7F"=>[9,"\x5D"],"\x80"=>[94,"~0"],"\x81"=>[76,"~0"],"\x82"=>[104,"~0"],"\x83"=>[16,"~0"],"\x84"=>[94,"~1"],"\x85"=>[76,"~1"],"\x86"=>[104,"~1"],"\x87"=>[16,"~1"],"\x88"=>[94,"~2"],"\x89"=>[76,"~2"],"\x8A"=>[104,"~2"],"\x8B"=>[16,"~2"],"\x8C"=>[94,"~a"],"\x8D"=>[76,"~a"],"\x8E"=>[104,"~a"],"\x8F"=>[16,"~a"],"\x90"=>[94,"~c"],"\x91"=>[76,"~c"],"\x92"=>[104,"~c"],"\x93"=>[16,"~c"],"\x94"=>[94,"~e"],"\x95"=>[76,"~e"],"\x96"=>[104,"~e"],"\x97"=>[16,"~e"],"\x98"=>[94,"~i"],"\x99"=>[76,"~i"],"\x9A"=>[104,"~i"],"\x9B"=>[16,"~i"],"\x9C"=>[94,"~o"],"\x9D"=>[76,"~o"],"\x9E"=>[104,"~o"],"\x9F"=>[16,"~o"],"\xA0"=>[94,"~s"],"\xA1"=>[76,"~s"],"\xA2"=>[104,"~s"],"\xA3"=>[16,"~s"],"\xA4"=>[94,"~t"],"\xA5"=>[76,"~t"],"\xA6"=>[104,"~t"],"\xA7"=>[16,"~t"],"\xA8"=>[77,"~\x20"],"\xA9"=>[18,"~\x20"],"\xAA"=>[77,"~\x25"],"\xAB"=>[18,"~\x25"],"\xAC"=>[77,"~-"],"\xAD"=>[18,"~-"],"\xAE"=>[77,"~."],"\xAF"=>[18,"~."],"\xB0"=>[77,"~\x2F"],"\xB1"=>[18,"~\x2F"],"\xB2"=>[77,"~3"],"\xB3"=>[18,"~3"],"\xB4"=>[77,"~4"],"\xB5"=>[18,"~4"],"\xB6"=>[77,"~5"],"\xB7"=>[18,"~5"],"\xB8"=>[77,"~6"],"\xB9"=>[18,"~6"],"\xBA"=>[77,"~7"],"\xBB"=>[18,"~7"],"\xBC"=>[77,"~8"],"\xBD"=>[18,"~8"],"\xBE"=>[77,"~9"],"\xBF"=>[18,"~9"],"\xC0"=>[77,"~\x3D"],"\xC1"=>[18,"~\x3D"],"\xC2"=>[77,"~A"],"\xC3"=>[18,"~A"],"\xC4"=>[77,"~_"],"\xC5"=>[18,"~_"],"\xC6"=>[77,"~b"],"\xC7"=>[18,"~b"],"\xC8"=>[77,"~d"],"\xC9"=>[18,"~d"],"\xCA"=>[77,"~f"],"\xCB"=>[18,"~f"],"\xCC"=>[77,"~g"],"\xCD"=>[18,"~g"],"\xCE"=>[77,"~h"],"\xCF"=>[18,"~h"],"\xD0"=>[77,"~l"],"\xD1"=>[18,"~l"],"\xD2"=>[77,"~m"],"\xD3"=>[18,"~m"],"\xD4"=>[77,"~n"],"\xD5"=>[18,"~n"],"\xD6"=>[77,"~p"],"\xD7"=>[18,"~p"],"\xD8"=>[77,"~r"],"\xD9"=>[18,"~r"],"\xDA"=>[77,"~u"],"\xDB"=>[18,"~u"],"\xDC"=>[0,"~\x3A"],"\xDD"=>[0,"~B"],"\xDE"=>[0,"~C"],"\xDF"=>[0,"~D"],"\xE0"=>[0,"~E"],"\xE1"=>[0,"~F"],"\xE2"=>[0,"~G"],"\xE3"=>[0,"~H"],"\xE4"=>[0,"~I"],"\xE5"=>[0,"~J"],"\xE6"=>[0,"~K"],"\xE7"=>[0,"~L"],"\xE8"=>[0,"~M"],"\xE9"=>[0,"~N"],"\xEA"=>[0,"~O"],"\xEB"=>[0,"~P"],"\xEC"=>[0,"~Q"],"\xED"=>[0,"~R"],"\xEE"=>[0,"~S"],"\xEF"=>[0,"~T"],"\xF0"=>[0,"~U"],"\xF1"=>[0,"~V"],"\xF2"=>[0,"~W"],"\xF3"=>[0,"~Y"],"\xF4"=>[0,"~j"],"\xF5"=>[0,"~k"],"\xF6"=>[0,"~q"],"\xF7"=>[0,"~v"],"\xF8"=>[0,"~w"],"\xF9"=>[0,"~x"],"\xFA"=>[0,"~y"],"\xFB"=>[0,"~z"],"\xFC"=>[82,"~"],"\xFD"=>[87,"~"],"\xFE"=>[130,"~"],"\xFF"=>[9,"~"],],["\x00"=>[94,"\x5E0"],"\x01"=>[76,"\x5E0"],"\x02"=>[104,"\x5E0"],"\x03"=>[16,"\x5E0"],"\x04"=>[94,"\x5E1"],"\x05"=>[76,"\x5E1"],"\x06"=>[104,"\x5E1"],"\x07"=>[16,"\x5E1"],"\x08"=>[94,"\x5E2"],"\x09"=>[76,"\x5E2"],"\x0A"=>[104,"\x5E2"],"\x0B"=>[16,"\x5E2"],"\x0C"=>[94,"\x5Ea"],"\x0D"=>[76,"\x5Ea"],"\x0E"=>[104,"\x5Ea"],"\x0F"=>[16,"\x5Ea"],"\x10"=>[94,"\x5Ec"],"\x11"=>[76,"\x5Ec"],"\x12"=>[104,"\x5Ec"],"\x13"=>[16,"\x5Ec"],"\x14"=>[94,"\x5Ee"],"\x15"=>[76,"\x5Ee"],"\x16"=>[104,"\x5Ee"],"\x17"=>[16,"\x5Ee"],"\x18"=>[94,"\x5Ei"],"\x19"=>[76,"\x5Ei"],"\x1A"=>[104,"\x5Ei"],"\x1B"=>[16,"\x5Ei"],"\x1C"=>[94,"\x5Eo"],"\x1D"=>[76,"\x5Eo"],"\x1E"=>[104,"\x5Eo"],"\x1F"=>[16,"\x5Eo"],"\x20"=>[94,"\x5Es"],"\x21"=>[76,"\x5Es"],"\x22"=>[104,"\x5Es"],"\x23"=>[16,"\x5Es"],"\x24"=>[94,"\x5Et"],"\x25"=>[76,"\x5Et"],"\x26"=>[104,"\x5Et"],"\x27"=>[16,"\x5Et"],"\x28"=>[77,"\x5E\x20"],"\x29"=>[18,"\x5E\x20"],"\x2A"=>[77,"\x5E\x25"],"\x2B"=>[18,"\x5E\x25"],"\x2C"=>[77,"\x5E-"],"-"=>[18,"\x5E-"],"."=>[77,"\x5E."],"\x2F"=>[18,"\x5E."],[77,"\x5E\x2F"],[18,"\x5E\x2F"],[77,"\x5E3"],[18,"\x5E3"],[77,"\x5E4"],[18,"\x5E4"],[77,"\x5E5"],[18,"\x5E5"],[77,"\x5E6"],[18,"\x5E6"],"\x3A"=>[77,"\x5E7"],"\x3B"=>[18,"\x5E7"],"\x3C"=>[77,"\x5E8"],"\x3D"=>[18,"\x5E8"],"\x3E"=>[77,"\x5E9"],"\x3F"=>[18,"\x5E9"],"\x40"=>[77,"\x5E\x3D"],"A"=>[18,"\x5E\x3D"],"B"=>[77,"\x5EA"],"C"=>[18,"\x5EA"],"D"=>[77,"\x5E_"],"E"=>[18,"\x5E_"],"F"=>[77,"\x5Eb"],"G"=>[18,"\x5Eb"],"H"=>[77,"\x5Ed"],"I"=>[18,"\x5Ed"],"J"=>[77,"\x5Ef"],"K"=>[18,"\x5Ef"],"L"=>[77,"\x5Eg"],"M"=>[18,"\x5Eg"],"N"=>[77,"\x5Eh"],"O"=>[18,"\x5Eh"],"P"=>[77,"\x5El"],"Q"=>[18,"\x5El"],"R"=>[77,"\x5Em"],"S"=>[18,"\x5Em"],"T"=>[77,"\x5En"],"U"=>[18,"\x5En"],"V"=>[77,"\x5Ep"],"W"=>[18,"\x5Ep"],"X"=>[77,"\x5Er"],"Y"=>[18,"\x5Er"],"Z"=>[77,"\x5Eu"],"\x5B"=>[18,"\x5Eu"],"\x5C"=>[0,"\x5E\x3A"],"\x5D"=>[0,"\x5EB"],"\x5E"=>[0,"\x5EC"],"_"=>[0,"\x5ED"],"\x60"=>[0,"\x5EE"],"a"=>[0,"\x5EF"],"b"=>[0,"\x5EG"],"c"=>[0,"\x5EH"],"d"=>[0,"\x5EI"],"e"=>[0,"\x5EJ"],"f"=>[0,"\x5EK"],"g"=>[0,"\x5EL"],"h"=>[0,"\x5EM"],"i"=>[0,"\x5EN"],"j"=>[0,"\x5EO"],"k"=>[0,"\x5EP"],"l"=>[0,"\x5EQ"],"m"=>[0,"\x5ER"],"n"=>[0,"\x5ES"],"o"=>[0,"\x5ET"],"p"=>[0,"\x5EU"],"q"=>[0,"\x5EV"],"r"=>[0,"\x5EW"],"s"=>[0,"\x5EY"],"t"=>[0,"\x5Ej"],"u"=>[0,"\x5Ek"],"v"=>[0,"\x5Eq"],"w"=>[0,"\x5Ev"],"x"=>[0,"\x5Ew"],"y"=>[0,"\x5Ex"],"z"=>[0,"\x5Ey"],"\x7B"=>[0,"\x5Ez"],"\x7C"=>[82,"\x5E"],"\x7D"=>[87,"\x5E"],"~"=>[130,"\x5E"],"\x7F"=>[9,"\x5E"],"\x80"=>[94,"\x7D0"],"\x81"=>[76,"\x7D0"],"\x82"=>[104,"\x7D0"],"\x83"=>[16,"\x7D0"],"\x84"=>[94,"\x7D1"],"\x85"=>[76,"\x7D1"],"\x86"=>[104,"\x7D1"],"\x87"=>[16,"\x7D1"],"\x88"=>[94,"\x7D2"],"\x89"=>[76,"\x7D2"],"\x8A"=>[104,"\x7D2"],"\x8B"=>[16,"\x7D2"],"\x8C"=>[94,"\x7Da"],"\x8D"=>[76,"\x7Da"],"\x8E"=>[104,"\x7Da"],"\x8F"=>[16,"\x7Da"],"\x90"=>[94,"\x7Dc"],"\x91"=>[76,"\x7Dc"],"\x92"=>[104,"\x7Dc"],"\x93"=>[16,"\x7Dc"],"\x94"=>[94,"\x7De"],"\x95"=>[76,"\x7De"],"\x96"=>[104,"\x7De"],"\x97"=>[16,"\x7De"],"\x98"=>[94,"\x7Di"],"\x99"=>[76,"\x7Di"],"\x9A"=>[104,"\x7Di"],"\x9B"=>[16,"\x7Di"],"\x9C"=>[94,"\x7Do"],"\x9D"=>[76,"\x7Do"],"\x9E"=>[104,"\x7Do"],"\x9F"=>[16,"\x7Do"],"\xA0"=>[94,"\x7Ds"],"\xA1"=>[76,"\x7Ds"],"\xA2"=>[104,"\x7Ds"],"\xA3"=>[16,"\x7Ds"],"\xA4"=>[94,"\x7Dt"],"\xA5"=>[76,"\x7Dt"],"\xA6"=>[104,"\x7Dt"],"\xA7"=>[16,"\x7Dt"],"\xA8"=>[77,"\x7D\x20"],"\xA9"=>[18,"\x7D\x20"],"\xAA"=>[77,"\x7D\x25"],"\xAB"=>[18,"\x7D\x25"],"\xAC"=>[77,"\x7D-"],"\xAD"=>[18,"\x7D-"],"\xAE"=>[77,"\x7D."],"\xAF"=>[18,"\x7D."],"\xB0"=>[77,"\x7D\x2F"],"\xB1"=>[18,"\x7D\x2F"],"\xB2"=>[77,"\x7D3"],"\xB3"=>[18,"\x7D3"],"\xB4"=>[77,"\x7D4"],"\xB5"=>[18,"\x7D4"],"\xB6"=>[77,"\x7D5"],"\xB7"=>[18,"\x7D5"],"\xB8"=>[77,"\x7D6"],"\xB9"=>[18,"\x7D6"],"\xBA"=>[77,"\x7D7"],"\xBB"=>[18,"\x7D7"],"\xBC"=>[77,"\x7D8"],"\xBD"=>[18,"\x7D8"],"\xBE"=>[77,"\x7D9"],"\xBF"=>[18,"\x7D9"],"\xC0"=>[77,"\x7D\x3D"],"\xC1"=>[18,"\x7D\x3D"],"\xC2"=>[77,"\x7DA"],"\xC3"=>[18,"\x7DA"],"\xC4"=>[77,"\x7D_"],"\xC5"=>[18,"\x7D_"],"\xC6"=>[77,"\x7Db"],"\xC7"=>[18,"\x7Db"],"\xC8"=>[77,"\x7Dd"],"\xC9"=>[18,"\x7Dd"],"\xCA"=>[77,"\x7Df"],"\xCB"=>[18,"\x7Df"],"\xCC"=>[77,"\x7Dg"],"\xCD"=>[18,"\x7Dg"],"\xCE"=>[77,"\x7Dh"],"\xCF"=>[18,"\x7Dh"],"\xD0"=>[77,"\x7Dl"],"\xD1"=>[18,"\x7Dl"],"\xD2"=>[77,"\x7Dm"],"\xD3"=>[18,"\x7Dm"],"\xD4"=>[77,"\x7Dn"],"\xD5"=>[18,"\x7Dn"],"\xD6"=>[77,"\x7Dp"],"\xD7"=>[18,"\x7Dp"],"\xD8"=>[77,"\x7Dr"],"\xD9"=>[18,"\x7Dr"],"\xDA"=>[77,"\x7Du"],"\xDB"=>[18,"\x7Du"],"\xDC"=>[0,"\x7D\x3A"],"\xDD"=>[0,"\x7DB"],"\xDE"=>[0,"\x7DC"],"\xDF"=>[0,"\x7DD"],"\xE0"=>[0,"\x7DE"],"\xE1"=>[0,"\x7DF"],"\xE2"=>[0,"\x7DG"],"\xE3"=>[0,"\x7DH"],"\xE4"=>[0,"\x7DI"],"\xE5"=>[0,"\x7DJ"],"\xE6"=>[0,"\x7DK"],"\xE7"=>[0,"\x7DL"],"\xE8"=>[0,"\x7DM"],"\xE9"=>[0,"\x7DN"],"\xEA"=>[0,"\x7DO"],"\xEB"=>[0,"\x7DP"],"\xEC"=>[0,"\x7DQ"],"\xED"=>[0,"\x7DR"],"\xEE"=>[0,"\x7DS"],"\xEF"=>[0,"\x7DT"],"\xF0"=>[0,"\x7DU"],"\xF1"=>[0,"\x7DV"],"\xF2"=>[0,"\x7DW"],"\xF3"=>[0,"\x7DY"],"\xF4"=>[0,"\x7Dj"],"\xF5"=>[0,"\x7Dk"],"\xF6"=>[0,"\x7Dq"],"\xF7"=>[0,"\x7Dv"],"\xF8"=>[0,"\x7Dw"],"\xF9"=>[0,"\x7Dx"],"\xFA"=>[0,"\x7Dy"],"\xFB"=>[0,"\x7Dz"],"\xFC"=>[82,"\x7D"],"\xFD"=>[87,"\x7D"],"\xFE"=>[130,"\x7D"],"\xFF"=>[9,"\x7D"],],["\x00"=>[94,"_0"],"\x01"=>[76,"_0"],"\x02"=>[104,"_0"],"\x03"=>[16,"_0"],"\x04"=>[94,"_1"],"\x05"=>[76,"_1"],"\x06"=>[104,"_1"],"\x07"=>[16,"_1"],"\x08"=>[94,"_2"],"\x09"=>[76,"_2"],"\x0A"=>[104,"_2"],"\x0B"=>[16,"_2"],"\x0C"=>[94,"_a"],"\x0D"=>[76,"_a"],"\x0E"=>[104,"_a"],"\x0F"=>[16,"_a"],"\x10"=>[94,"_c"],"\x11"=>[76,"_c"],"\x12"=>[104,"_c"],"\x13"=>[16,"_c"],"\x14"=>[94,"_e"],"\x15"=>[76,"_e"],"\x16"=>[104,"_e"],"\x17"=>[16,"_e"],"\x18"=>[94,"_i"],"\x19"=>[76,"_i"],"\x1A"=>[104,"_i"],"\x1B"=>[16,"_i"],"\x1C"=>[94,"_o"],"\x1D"=>[76,"_o"],"\x1E"=>[104,"_o"],"\x1F"=>[16,"_o"],"\x20"=>[94,"_s"],"\x21"=>[76,"_s"],"\x22"=>[104,"_s"],"\x23"=>[16,"_s"],"\x24"=>[94,"_t"],"\x25"=>[76,"_t"],"\x26"=>[104,"_t"],"\x27"=>[16,"_t"],"\x28"=>[77,"_\x20"],"\x29"=>[18,"_\x20"],"\x2A"=>[77,"_\x25"],"\x2B"=>[18,"_\x25"],"\x2C"=>[77,"_-"],"-"=>[18,"_-"],"."=>[77,"_."],"\x2F"=>[18,"_."],[77,"_\x2F"],[18,"_\x2F"],[77,"_3"],[18,"_3"],[77,"_4"],[18,"_4"],[77,"_5"],[18,"_5"],[77,"_6"],[18,"_6"],"\x3A"=>[77,"_7"],"\x3B"=>[18,"_7"],"\x3C"=>[77,"_8"],"\x3D"=>[18,"_8"],"\x3E"=>[77,"_9"],"\x3F"=>[18,"_9"],"\x40"=>[77,"_\x3D"],"A"=>[18,"_\x3D"],"B"=>[77,"_A"],"C"=>[18,"_A"],"D"=>[77,"__"],"E"=>[18,"__"],"F"=>[77,"_b"],"G"=>[18,"_b"],"H"=>[77,"_d"],"I"=>[18,"_d"],"J"=>[77,"_f"],"K"=>[18,"_f"],"L"=>[77,"_g"],"M"=>[18,"_g"],"N"=>[77,"_h"],"O"=>[18,"_h"],"P"=>[77,"_l"],"Q"=>[18,"_l"],"R"=>[77,"_m"],"S"=>[18,"_m"],"T"=>[77,"_n"],"U"=>[18,"_n"],"V"=>[77,"_p"],"W"=>[18,"_p"],"X"=>[77,"_r"],"Y"=>[18,"_r"],"Z"=>[77,"_u"],"\x5B"=>[18,"_u"],"\x5C"=>[0,"_\x3A"],"\x5D"=>[0,"_B"],"\x5E"=>[0,"_C"],"_"=>[0,"_D"],"\x60"=>[0,"_E"],"a"=>[0,"_F"],"b"=>[0,"_G"],"c"=>[0,"_H"],"d"=>[0,"_I"],"e"=>[0,"_J"],"f"=>[0,"_K"],"g"=>[0,"_L"],"h"=>[0,"_M"],"i"=>[0,"_N"],"j"=>[0,"_O"],"k"=>[0,"_P"],"l"=>[0,"_Q"],"m"=>[0,"_R"],"n"=>[0,"_S"],"o"=>[0,"_T"],"p"=>[0,"_U"],"q"=>[0,"_V"],"r"=>[0,"_W"],"s"=>[0,"_Y"],"t"=>[0,"_j"],"u"=>[0,"_k"],"v"=>[0,"_q"],"w"=>[0,"_v"],"x"=>[0,"_w"],"y"=>[0,"_x"],"z"=>[0,"_y"],"\x7B"=>[0,"_z"],"\x7C"=>[82,"_"],"\x7D"=>[87,"_"],"~"=>[130,"_"],"\x7F"=>[9,"_"],"\x80"=>[94,"b0"],"\x81"=>[76,"b0"],"\x82"=>[104,"b0"],"\x83"=>[16,"b0"],"\x84"=>[94,"b1"],"\x85"=>[76,"b1"],"\x86"=>[104,"b1"],"\x87"=>[16,"b1"],"\x88"=>[94,"b2"],"\x89"=>[76,"b2"],"\x8A"=>[104,"b2"],"\x8B"=>[16,"b2"],"\x8C"=>[94,"ba"],"\x8D"=>[76,"ba"],"\x8E"=>[104,"ba"],"\x8F"=>[16,"ba"],"\x90"=>[94,"bc"],"\x91"=>[76,"bc"],"\x92"=>[104,"bc"],"\x93"=>[16,"bc"],"\x94"=>[94,"be"],"\x95"=>[76,"be"],"\x96"=>[104,"be"],"\x97"=>[16,"be"],"\x98"=>[94,"bi"],"\x99"=>[76,"bi"],"\x9A"=>[104,"bi"],"\x9B"=>[16,"bi"],"\x9C"=>[94,"bo"],"\x9D"=>[76,"bo"],"\x9E"=>[104,"bo"],"\x9F"=>[16,"bo"],"\xA0"=>[94,"bs"],"\xA1"=>[76,"bs"],"\xA2"=>[104,"bs"],"\xA3"=>[16,"bs"],"\xA4"=>[94,"bt"],"\xA5"=>[76,"bt"],"\xA6"=>[104,"bt"],"\xA7"=>[16,"bt"],"\xA8"=>[77,"b\x20"],"\xA9"=>[18,"b\x20"],"\xAA"=>[77,"b\x25"],"\xAB"=>[18,"b\x25"],"\xAC"=>[77,"b-"],"\xAD"=>[18,"b-"],"\xAE"=>[77,"b."],"\xAF"=>[18,"b."],"\xB0"=>[77,"b\x2F"],"\xB1"=>[18,"b\x2F"],"\xB2"=>[77,"b3"],"\xB3"=>[18,"b3"],"\xB4"=>[77,"b4"],"\xB5"=>[18,"b4"],"\xB6"=>[77,"b5"],"\xB7"=>[18,"b5"],"\xB8"=>[77,"b6"],"\xB9"=>[18,"b6"],"\xBA"=>[77,"b7"],"\xBB"=>[18,"b7"],"\xBC"=>[77,"b8"],"\xBD"=>[18,"b8"],"\xBE"=>[77,"b9"],"\xBF"=>[18,"b9"],"\xC0"=>[77,"b\x3D"],"\xC1"=>[18,"b\x3D"],"\xC2"=>[77,"bA"],"\xC3"=>[18,"bA"],"\xC4"=>[77,"b_"],"\xC5"=>[18,"b_"],"\xC6"=>[77,"bb"],"\xC7"=>[18,"bb"],"\xC8"=>[77,"bd"],"\xC9"=>[18,"bd"],"\xCA"=>[77,"bf"],"\xCB"=>[18,"bf"],"\xCC"=>[77,"bg"],"\xCD"=>[18,"bg"],"\xCE"=>[77,"bh"],"\xCF"=>[18,"bh"],"\xD0"=>[77,"bl"],"\xD1"=>[18,"bl"],"\xD2"=>[77,"bm"],"\xD3"=>[18,"bm"],"\xD4"=>[77,"bn"],"\xD5"=>[18,"bn"],"\xD6"=>[77,"bp"],"\xD7"=>[18,"bp"],"\xD8"=>[77,"br"],"\xD9"=>[18,"br"],"\xDA"=>[77,"bu"],"\xDB"=>[18,"bu"],"\xDC"=>[0,"b\x3A"],"\xDD"=>[0,"bB"],"\xDE"=>[0,"bC"],"\xDF"=>[0,"bD"],"\xE0"=>[0,"bE"],"\xE1"=>[0,"bF"],"\xE2"=>[0,"bG"],"\xE3"=>[0,"bH"],"\xE4"=>[0,"bI"],"\xE5"=>[0,"bJ"],"\xE6"=>[0,"bK"],"\xE7"=>[0,"bL"],"\xE8"=>[0,"bM"],"\xE9"=>[0,"bN"],"\xEA"=>[0,"bO"],"\xEB"=>[0,"bP"],"\xEC"=>[0,"bQ"],"\xED"=>[0,"bR"],"\xEE"=>[0,"bS"],"\xEF"=>[0,"bT"],"\xF0"=>[0,"bU"],"\xF1"=>[0,"bV"],"\xF2"=>[0,"bW"],"\xF3"=>[0,"bY"],"\xF4"=>[0,"bj"],"\xF5"=>[0,"bk"],"\xF6"=>[0,"bq"],"\xF7"=>[0,"bv"],"\xF8"=>[0,"bw"],"\xF9"=>[0,"bx"],"\xFA"=>[0,"by"],"\xFB"=>[0,"bz"],"\xFC"=>[82,"b"],"\xFD"=>[87,"b"],"\xFE"=>[130,"b"],"\xFF"=>[9,"b"],],["\x00"=>[94,"c0"],"\x01"=>[76,"c0"],"\x02"=>[104,"c0"],"\x03"=>[16,"c0"],"\x04"=>[94,"c1"],"\x05"=>[76,"c1"],"\x06"=>[104,"c1"],"\x07"=>[16,"c1"],"\x08"=>[94,"c2"],"\x09"=>[76,"c2"],"\x0A"=>[104,"c2"],"\x0B"=>[16,"c2"],"\x0C"=>[94,"ca"],"\x0D"=>[76,"ca"],"\x0E"=>[104,"ca"],"\x0F"=>[16,"ca"],"\x10"=>[94,"cc"],"\x11"=>[76,"cc"],"\x12"=>[104,"cc"],"\x13"=>[16,"cc"],"\x14"=>[94,"ce"],"\x15"=>[76,"ce"],"\x16"=>[104,"ce"],"\x17"=>[16,"ce"],"\x18"=>[94,"ci"],"\x19"=>[76,"ci"],"\x1A"=>[104,"ci"],"\x1B"=>[16,"ci"],"\x1C"=>[94,"co"],"\x1D"=>[76,"co"],"\x1E"=>[104,"co"],"\x1F"=>[16,"co"],"\x20"=>[94,"cs"],"\x21"=>[76,"cs"],"\x22"=>[104,"cs"],"\x23"=>[16,"cs"],"\x24"=>[94,"ct"],"\x25"=>[76,"ct"],"\x26"=>[104,"ct"],"\x27"=>[16,"ct"],"\x28"=>[77,"c\x20"],"\x29"=>[18,"c\x20"],"\x2A"=>[77,"c\x25"],"\x2B"=>[18,"c\x25"],"\x2C"=>[77,"c-"],"-"=>[18,"c-"],"."=>[77,"c."],"\x2F"=>[18,"c."],[77,"c\x2F"],[18,"c\x2F"],[77,"c3"],[18,"c3"],[77,"c4"],[18,"c4"],[77,"c5"],[18,"c5"],[77,"c6"],[18,"c6"],"\x3A"=>[77,"c7"],"\x3B"=>[18,"c7"],"\x3C"=>[77,"c8"],"\x3D"=>[18,"c8"],"\x3E"=>[77,"c9"],"\x3F"=>[18,"c9"],"\x40"=>[77,"c\x3D"],"A"=>[18,"c\x3D"],"B"=>[77,"cA"],"C"=>[18,"cA"],"D"=>[77,"c_"],"E"=>[18,"c_"],"F"=>[77,"cb"],"G"=>[18,"cb"],"H"=>[77,"cd"],"I"=>[18,"cd"],"J"=>[77,"cf"],"K"=>[18,"cf"],"L"=>[77,"cg"],"M"=>[18,"cg"],"N"=>[77,"ch"],"O"=>[18,"ch"],"P"=>[77,"cl"],"Q"=>[18,"cl"],"R"=>[77,"cm"],"S"=>[18,"cm"],"T"=>[77,"cn"],"U"=>[18,"cn"],"V"=>[77,"cp"],"W"=>[18,"cp"],"X"=>[77,"cr"],"Y"=>[18,"cr"],"Z"=>[77,"cu"],"\x5B"=>[18,"cu"],"\x5C"=>[0,"c\x3A"],"\x5D"=>[0,"cB"],"\x5E"=>[0,"cC"],"_"=>[0,"cD"],"\x60"=>[0,"cE"],"a"=>[0,"cF"],"b"=>[0,"cG"],"c"=>[0,"cH"],"d"=>[0,"cI"],"e"=>[0,"cJ"],"f"=>[0,"cK"],"g"=>[0,"cL"],"h"=>[0,"cM"],"i"=>[0,"cN"],"j"=>[0,"cO"],"k"=>[0,"cP"],"l"=>[0,"cQ"],"m"=>[0,"cR"],"n"=>[0,"cS"],"o"=>[0,"cT"],"p"=>[0,"cU"],"q"=>[0,"cV"],"r"=>[0,"cW"],"s"=>[0,"cY"],"t"=>[0,"cj"],"u"=>[0,"ck"],"v"=>[0,"cq"],"w"=>[0,"cv"],"x"=>[0,"cw"],"y"=>[0,"cx"],"z"=>[0,"cy"],"\x7B"=>[0,"cz"],"\x7C"=>[82,"c"],"\x7D"=>[87,"c"],"~"=>[130,"c"],"\x7F"=>[9,"c"],"\x80"=>[94,"e0"],"\x81"=>[76,"e0"],"\x82"=>[104,"e0"],"\x83"=>[16,"e0"],"\x84"=>[94,"e1"],"\x85"=>[76,"e1"],"\x86"=>[104,"e1"],"\x87"=>[16,"e1"],"\x88"=>[94,"e2"],"\x89"=>[76,"e2"],"\x8A"=>[104,"e2"],"\x8B"=>[16,"e2"],"\x8C"=>[94,"ea"],"\x8D"=>[76,"ea"],"\x8E"=>[104,"ea"],"\x8F"=>[16,"ea"],"\x90"=>[94,"ec"],"\x91"=>[76,"ec"],"\x92"=>[104,"ec"],"\x93"=>[16,"ec"],"\x94"=>[94,"ee"],"\x95"=>[76,"ee"],"\x96"=>[104,"ee"],"\x97"=>[16,"ee"],"\x98"=>[94,"ei"],"\x99"=>[76,"ei"],"\x9A"=>[104,"ei"],"\x9B"=>[16,"ei"],"\x9C"=>[94,"eo"],"\x9D"=>[76,"eo"],"\x9E"=>[104,"eo"],"\x9F"=>[16,"eo"],"\xA0"=>[94,"es"],"\xA1"=>[76,"es"],"\xA2"=>[104,"es"],"\xA3"=>[16,"es"],"\xA4"=>[94,"et"],"\xA5"=>[76,"et"],"\xA6"=>[104,"et"],"\xA7"=>[16,"et"],"\xA8"=>[77,"e\x20"],"\xA9"=>[18,"e\x20"],"\xAA"=>[77,"e\x25"],"\xAB"=>[18,"e\x25"],"\xAC"=>[77,"e-"],"\xAD"=>[18,"e-"],"\xAE"=>[77,"e."],"\xAF"=>[18,"e."],"\xB0"=>[77,"e\x2F"],"\xB1"=>[18,"e\x2F"],"\xB2"=>[77,"e3"],"\xB3"=>[18,"e3"],"\xB4"=>[77,"e4"],"\xB5"=>[18,"e4"],"\xB6"=>[77,"e5"],"\xB7"=>[18,"e5"],"\xB8"=>[77,"e6"],"\xB9"=>[18,"e6"],"\xBA"=>[77,"e7"],"\xBB"=>[18,"e7"],"\xBC"=>[77,"e8"],"\xBD"=>[18,"e8"],"\xBE"=>[77,"e9"],"\xBF"=>[18,"e9"],"\xC0"=>[77,"e\x3D"],"\xC1"=>[18,"e\x3D"],"\xC2"=>[77,"eA"],"\xC3"=>[18,"eA"],"\xC4"=>[77,"e_"],"\xC5"=>[18,"e_"],"\xC6"=>[77,"eb"],"\xC7"=>[18,"eb"],"\xC8"=>[77,"ed"],"\xC9"=>[18,"ed"],"\xCA"=>[77,"ef"],"\xCB"=>[18,"ef"],"\xCC"=>[77,"eg"],"\xCD"=>[18,"eg"],"\xCE"=>[77,"eh"],"\xCF"=>[18,"eh"],"\xD0"=>[77,"el"],"\xD1"=>[18,"el"],"\xD2"=>[77,"em"],"\xD3"=>[18,"em"],"\xD4"=>[77,"en"],"\xD5"=>[18,"en"],"\xD6"=>[77,"ep"],"\xD7"=>[18,"ep"],"\xD8"=>[77,"er"],"\xD9"=>[18,"er"],"\xDA"=>[77,"eu"],"\xDB"=>[18,"eu"],"\xDC"=>[0,"e\x3A"],"\xDD"=>[0,"eB"],"\xDE"=>[0,"eC"],"\xDF"=>[0,"eD"],"\xE0"=>[0,"eE"],"\xE1"=>[0,"eF"],"\xE2"=>[0,"eG"],"\xE3"=>[0,"eH"],"\xE4"=>[0,"eI"],"\xE5"=>[0,"eJ"],"\xE6"=>[0,"eK"],"\xE7"=>[0,"eL"],"\xE8"=>[0,"eM"],"\xE9"=>[0,"eN"],"\xEA"=>[0,"eO"],"\xEB"=>[0,"eP"],"\xEC"=>[0,"eQ"],"\xED"=>[0,"eR"],"\xEE"=>[0,"eS"],"\xEF"=>[0,"eT"],"\xF0"=>[0,"eU"],"\xF1"=>[0,"eV"],"\xF2"=>[0,"eW"],"\xF3"=>[0,"eY"],"\xF4"=>[0,"ej"],"\xF5"=>[0,"ek"],"\xF6"=>[0,"eq"],"\xF7"=>[0,"ev"],"\xF8"=>[0,"ew"],"\xF9"=>[0,"ex"],"\xFA"=>[0,"ey"],"\xFB"=>[0,"ez"],"\xFC"=>[82,"e"],"\xFD"=>[87,"e"],"\xFE"=>[130,"e"],"\xFF"=>[9,"e"],],["\x00"=>[77,"c0"],"\x01"=>[18,"c0"],"\x02"=>[77,"c1"],"\x03"=>[18,"c1"],"\x04"=>[77,"c2"],"\x05"=>[18,"c2"],"\x06"=>[77,"ca"],"\x07"=>[18,"ca"],"\x08"=>[77,"cc"],"\x09"=>[18,"cc"],"\x0A"=>[77,"ce"],"\x0B"=>[18,"ce"],"\x0C"=>[77,"ci"],"\x0D"=>[18,"ci"],"\x0E"=>[77,"co"],"\x0F"=>[18,"co"],"\x10"=>[77,"cs"],"\x11"=>[18,"cs"],"\x12"=>[77,"ct"],"\x13"=>[18,"ct"],"\x14"=>[0,"c\x20"],"\x15"=>[0,"c\x25"],"\x16"=>[0,"c-"],"\x17"=>[0,"c."],"\x18"=>[0,"c\x2F"],"\x19"=>[0,"c3"],"\x1A"=>[0,"c4"],"\x1B"=>[0,"c5"],"\x1C"=>[0,"c6"],"\x1D"=>[0,"c7"],"\x1E"=>[0,"c8"],"\x1F"=>[0,"c9"],"\x20"=>[0,"c\x3D"],"\x21"=>[0,"cA"],"\x22"=>[0,"c_"],"\x23"=>[0,"cb"],"\x24"=>[0,"cd"],"\x25"=>[0,"cf"],"\x26"=>[0,"cg"],"\x27"=>[0,"ch"],"\x28"=>[0,"cl"],"\x29"=>[0,"cm"],"\x2A"=>[0,"cn"],"\x2B"=>[0,"cp"],"\x2C"=>[0,"cr"],"-"=>[0,"cu"],"."=>[100,"c"],"\x2F"=>[110,"c"],[111,"c"],[115,"c"],[116,"c"],[118,"c"],[119,"c"],[122,"c"],[123,"c"],[125,"c"],[126,"c"],[129,"c"],"\x3A"=>[143,"c"],"\x3B"=>[148,"c"],"\x3C"=>[151,"c"],"\x3D"=>[153,"c"],"\x3E"=>[83,"c"],"\x3F"=>[10,"c"],"\x40"=>[77,"e0"],"A"=>[18,"e0"],"B"=>[77,"e1"],"C"=>[18,"e1"],"D"=>[77,"e2"],"E"=>[18,"e2"],"F"=>[77,"ea"],"G"=>[18,"ea"],"H"=>[77,"ec"],"I"=>[18,"ec"],"J"=>[77,"ee"],"K"=>[18,"ee"],"L"=>[77,"ei"],"M"=>[18,"ei"],"N"=>[77,"eo"],"O"=>[18,"eo"],"P"=>[77,"es"],"Q"=>[18,"es"],"R"=>[77,"et"],"S"=>[18,"et"],"T"=>[0,"e\x20"],"U"=>[0,"e\x25"],"V"=>[0,"e-"],"W"=>[0,"e."],"X"=>[0,"e\x2F"],"Y"=>[0,"e3"],"Z"=>[0,"e4"],"\x5B"=>[0,"e5"],"\x5C"=>[0,"e6"],"\x5D"=>[0,"e7"],"\x5E"=>[0,"e8"],"_"=>[0,"e9"],"\x60"=>[0,"e\x3D"],"a"=>[0,"eA"],"b"=>[0,"e_"],"c"=>[0,"eb"],"d"=>[0,"ed"],"e"=>[0,"ef"],"f"=>[0,"eg"],"g"=>[0,"eh"],"h"=>[0,"el"],"i"=>[0,"em"],"j"=>[0,"en"],"k"=>[0,"ep"],"l"=>[0,"er"],"m"=>[0,"eu"],"n"=>[100,"e"],"o"=>[110,"e"],"p"=>[111,"e"],"q"=>[115,"e"],"r"=>[116,"e"],"s"=>[118,"e"],"t"=>[119,"e"],"u"=>[122,"e"],"v"=>[123,"e"],"w"=>[125,"e"],"x"=>[126,"e"],"y"=>[129,"e"],"z"=>[143,"e"],"\x7B"=>[148,"e"],"\x7C"=>[151,"e"],"\x7D"=>[153,"e"],"~"=>[83,"e"],"\x7F"=>[10,"e"],"\x80"=>[77,"i0"],"\x81"=>[18,"i0"],"\x82"=>[77,"i1"],"\x83"=>[18,"i1"],"\x84"=>[77,"i2"],"\x85"=>[18,"i2"],"\x86"=>[77,"ia"],"\x87"=>[18,"ia"],"\x88"=>[77,"ic"],"\x89"=>[18,"ic"],"\x8A"=>[77,"ie"],"\x8B"=>[18,"ie"],"\x8C"=>[77,"ii"],"\x8D"=>[18,"ii"],"\x8E"=>[77,"io"],"\x8F"=>[18,"io"],"\x90"=>[77,"is"],"\x91"=>[18,"is"],"\x92"=>[77,"it"],"\x93"=>[18,"it"],"\x94"=>[0,"i\x20"],"\x95"=>[0,"i\x25"],"\x96"=>[0,"i-"],"\x97"=>[0,"i."],"\x98"=>[0,"i\x2F"],"\x99"=>[0,"i3"],"\x9A"=>[0,"i4"],"\x9B"=>[0,"i5"],"\x9C"=>[0,"i6"],"\x9D"=>[0,"i7"],"\x9E"=>[0,"i8"],"\x9F"=>[0,"i9"],"\xA0"=>[0,"i\x3D"],"\xA1"=>[0,"iA"],"\xA2"=>[0,"i_"],"\xA3"=>[0,"ib"],"\xA4"=>[0,"id"],"\xA5"=>[0,"if"],"\xA6"=>[0,"ig"],"\xA7"=>[0,"ih"],"\xA8"=>[0,"il"],"\xA9"=>[0,"im"],"\xAA"=>[0,"in"],"\xAB"=>[0,"ip"],"\xAC"=>[0,"ir"],"\xAD"=>[0,"iu"],"\xAE"=>[100,"i"],"\xAF"=>[110,"i"],"\xB0"=>[111,"i"],"\xB1"=>[115,"i"],"\xB2"=>[116,"i"],"\xB3"=>[118,"i"],"\xB4"=>[119,"i"],"\xB5"=>[122,"i"],"\xB6"=>[123,"i"],"\xB7"=>[125,"i"],"\xB8"=>[126,"i"],"\xB9"=>[129,"i"],"\xBA"=>[143,"i"],"\xBB"=>[148,"i"],"\xBC"=>[151,"i"],"\xBD"=>[153,"i"],"\xBE"=>[83,"i"],"\xBF"=>[10,"i"],"\xC0"=>[77,"o0"],"\xC1"=>[18,"o0"],"\xC2"=>[77,"o1"],"\xC3"=>[18,"o1"],"\xC4"=>[77,"o2"],"\xC5"=>[18,"o2"],"\xC6"=>[77,"oa"],"\xC7"=>[18,"oa"],"\xC8"=>[77,"oc"],"\xC9"=>[18,"oc"],"\xCA"=>[77,"oe"],"\xCB"=>[18,"oe"],"\xCC"=>[77,"oi"],"\xCD"=>[18,"oi"],"\xCE"=>[77,"oo"],"\xCF"=>[18,"oo"],"\xD0"=>[77,"os"],"\xD1"=>[18,"os"],"\xD2"=>[77,"ot"],"\xD3"=>[18,"ot"],"\xD4"=>[0,"o\x20"],"\xD5"=>[0,"o\x25"],"\xD6"=>[0,"o-"],"\xD7"=>[0,"o."],"\xD8"=>[0,"o\x2F"],"\xD9"=>[0,"o3"],"\xDA"=>[0,"o4"],"\xDB"=>[0,"o5"],"\xDC"=>[0,"o6"],"\xDD"=>[0,"o7"],"\xDE"=>[0,"o8"],"\xDF"=>[0,"o9"],"\xE0"=>[0,"o\x3D"],"\xE1"=>[0,"oA"],"\xE2"=>[0,"o_"],"\xE3"=>[0,"ob"],"\xE4"=>[0,"od"],"\xE5"=>[0,"of"],"\xE6"=>[0,"og"],"\xE7"=>[0,"oh"],"\xE8"=>[0,"ol"],"\xE9"=>[0,"om"],"\xEA"=>[0,"on"],"\xEB"=>[0,"op"],"\xEC"=>[0,"or"],"\xED"=>[0,"ou"],"\xEE"=>[100,"o"],"\xEF"=>[110,"o"],"\xF0"=>[111,"o"],"\xF1"=>[115,"o"],"\xF2"=>[116,"o"],"\xF3"=>[118,"o"],"\xF4"=>[119,"o"],"\xF5"=>[122,"o"],"\xF6"=>[123,"o"],"\xF7"=>[125,"o"],"\xF8"=>[126,"o"],"\xF9"=>[129,"o"],"\xFA"=>[143,"o"],"\xFB"=>[148,"o"],"\xFC"=>[151,"o"],"\xFD"=>[153,"o"],"\xFE"=>[83,"o"],"\xFF"=>[10,"o"],],["\x00"=>[94,"d0"],"\x01"=>[76,"d0"],"\x02"=>[104,"d0"],"\x03"=>[16,"d0"],"\x04"=>[94,"d1"],"\x05"=>[76,"d1"],"\x06"=>[104,"d1"],"\x07"=>[16,"d1"],"\x08"=>[94,"d2"],"\x09"=>[76,"d2"],"\x0A"=>[104,"d2"],"\x0B"=>[16,"d2"],"\x0C"=>[94,"da"],"\x0D"=>[76,"da"],"\x0E"=>[104,"da"],"\x0F"=>[16,"da"],"\x10"=>[94,"dc"],"\x11"=>[76,"dc"],"\x12"=>[104,"dc"],"\x13"=>[16,"dc"],"\x14"=>[94,"de"],"\x15"=>[76,"de"],"\x16"=>[104,"de"],"\x17"=>[16,"de"],"\x18"=>[94,"di"],"\x19"=>[76,"di"],"\x1A"=>[104,"di"],"\x1B"=>[16,"di"],"\x1C"=>[94,"do"],"\x1D"=>[76,"do"],"\x1E"=>[104,"do"],"\x1F"=>[16,"do"],"\x20"=>[94,"ds"],"\x21"=>[76,"ds"],"\x22"=>[104,"ds"],"\x23"=>[16,"ds"],"\x24"=>[94,"dt"],"\x25"=>[76,"dt"],"\x26"=>[104,"dt"],"\x27"=>[16,"dt"],"\x28"=>[77,"d\x20"],"\x29"=>[18,"d\x20"],"\x2A"=>[77,"d\x25"],"\x2B"=>[18,"d\x25"],"\x2C"=>[77,"d-"],"-"=>[18,"d-"],"."=>[77,"d."],"\x2F"=>[18,"d."],[77,"d\x2F"],[18,"d\x2F"],[77,"d3"],[18,"d3"],[77,"d4"],[18,"d4"],[77,"d5"],[18,"d5"],[77,"d6"],[18,"d6"],"\x3A"=>[77,"d7"],"\x3B"=>[18,"d7"],"\x3C"=>[77,"d8"],"\x3D"=>[18,"d8"],"\x3E"=>[77,"d9"],"\x3F"=>[18,"d9"],"\x40"=>[77,"d\x3D"],"A"=>[18,"d\x3D"],"B"=>[77,"dA"],"C"=>[18,"dA"],"D"=>[77,"d_"],"E"=>[18,"d_"],"F"=>[77,"db"],"G"=>[18,"db"],"H"=>[77,"dd"],"I"=>[18,"dd"],"J"=>[77,"df"],"K"=>[18,"df"],"L"=>[77,"dg"],"M"=>[18,"dg"],"N"=>[77,"dh"],"O"=>[18,"dh"],"P"=>[77,"dl"],"Q"=>[18,"dl"],"R"=>[77,"dm"],"S"=>[18,"dm"],"T"=>[77,"dn"],"U"=>[18,"dn"],"V"=>[77,"dp"],"W"=>[18,"dp"],"X"=>[77,"dr"],"Y"=>[18,"dr"],"Z"=>[77,"du"],"\x5B"=>[18,"du"],"\x5C"=>[0,"d\x3A"],"\x5D"=>[0,"dB"],"\x5E"=>[0,"dC"],"_"=>[0,"dD"],"\x60"=>[0,"dE"],"a"=>[0,"dF"],"b"=>[0,"dG"],"c"=>[0,"dH"],"d"=>[0,"dI"],"e"=>[0,"dJ"],"f"=>[0,"dK"],"g"=>[0,"dL"],"h"=>[0,"dM"],"i"=>[0,"dN"],"j"=>[0,"dO"],"k"=>[0,"dP"],"l"=>[0,"dQ"],"m"=>[0,"dR"],"n"=>[0,"dS"],"o"=>[0,"dT"],"p"=>[0,"dU"],"q"=>[0,"dV"],"r"=>[0,"dW"],"s"=>[0,"dY"],"t"=>[0,"dj"],"u"=>[0,"dk"],"v"=>[0,"dq"],"w"=>[0,"dv"],"x"=>[0,"dw"],"y"=>[0,"dx"],"z"=>[0,"dy"],"\x7B"=>[0,"dz"],"\x7C"=>[82,"d"],"\x7D"=>[87,"d"],"~"=>[130,"d"],"\x7F"=>[9,"d"],"\x80"=>[94,"f0"],"\x81"=>[76,"f0"],"\x82"=>[104,"f0"],"\x83"=>[16,"f0"],"\x84"=>[94,"f1"],"\x85"=>[76,"f1"],"\x86"=>[104,"f1"],"\x87"=>[16,"f1"],"\x88"=>[94,"f2"],"\x89"=>[76,"f2"],"\x8A"=>[104,"f2"],"\x8B"=>[16,"f2"],"\x8C"=>[94,"fa"],"\x8D"=>[76,"fa"],"\x8E"=>[104,"fa"],"\x8F"=>[16,"fa"],"\x90"=>[94,"fc"],"\x91"=>[76,"fc"],"\x92"=>[104,"fc"],"\x93"=>[16,"fc"],"\x94"=>[94,"fe"],"\x95"=>[76,"fe"],"\x96"=>[104,"fe"],"\x97"=>[16,"fe"],"\x98"=>[94,"fi"],"\x99"=>[76,"fi"],"\x9A"=>[104,"fi"],"\x9B"=>[16,"fi"],"\x9C"=>[94,"fo"],"\x9D"=>[76,"fo"],"\x9E"=>[104,"fo"],"\x9F"=>[16,"fo"],"\xA0"=>[94,"fs"],"\xA1"=>[76,"fs"],"\xA2"=>[104,"fs"],"\xA3"=>[16,"fs"],"\xA4"=>[94,"ft"],"\xA5"=>[76,"ft"],"\xA6"=>[104,"ft"],"\xA7"=>[16,"ft"],"\xA8"=>[77,"f\x20"],"\xA9"=>[18,"f\x20"],"\xAA"=>[77,"f\x25"],"\xAB"=>[18,"f\x25"],"\xAC"=>[77,"f-"],"\xAD"=>[18,"f-"],"\xAE"=>[77,"f."],"\xAF"=>[18,"f."],"\xB0"=>[77,"f\x2F"],"\xB1"=>[18,"f\x2F"],"\xB2"=>[77,"f3"],"\xB3"=>[18,"f3"],"\xB4"=>[77,"f4"],"\xB5"=>[18,"f4"],"\xB6"=>[77,"f5"],"\xB7"=>[18,"f5"],"\xB8"=>[77,"f6"],"\xB9"=>[18,"f6"],"\xBA"=>[77,"f7"],"\xBB"=>[18,"f7"],"\xBC"=>[77,"f8"],"\xBD"=>[18,"f8"],"\xBE"=>[77,"f9"],"\xBF"=>[18,"f9"],"\xC0"=>[77,"f\x3D"],"\xC1"=>[18,"f\x3D"],"\xC2"=>[77,"fA"],"\xC3"=>[18,"fA"],"\xC4"=>[77,"f_"],"\xC5"=>[18,"f_"],"\xC6"=>[77,"fb"],"\xC7"=>[18,"fb"],"\xC8"=>[77,"fd"],"\xC9"=>[18,"fd"],"\xCA"=>[77,"ff"],"\xCB"=>[18,"ff"],"\xCC"=>[77,"fg"],"\xCD"=>[18,"fg"],"\xCE"=>[77,"fh"],"\xCF"=>[18,"fh"],"\xD0"=>[77,"fl"],"\xD1"=>[18,"fl"],"\xD2"=>[77,"fm"],"\xD3"=>[18,"fm"],"\xD4"=>[77,"fn"],"\xD5"=>[18,"fn"],"\xD6"=>[77,"fp"],"\xD7"=>[18,"fp"],"\xD8"=>[77,"fr"],"\xD9"=>[18,"fr"],"\xDA"=>[77,"fu"],"\xDB"=>[18,"fu"],"\xDC"=>[0,"f\x3A"],"\xDD"=>[0,"fB"],"\xDE"=>[0,"fC"],"\xDF"=>[0,"fD"],"\xE0"=>[0,"fE"],"\xE1"=>[0,"fF"],"\xE2"=>[0,"fG"],"\xE3"=>[0,"fH"],"\xE4"=>[0,"fI"],"\xE5"=>[0,"fJ"],"\xE6"=>[0,"fK"],"\xE7"=>[0,"fL"],"\xE8"=>[0,"fM"],"\xE9"=>[0,"fN"],"\xEA"=>[0,"fO"],"\xEB"=>[0,"fP"],"\xEC"=>[0,"fQ"],"\xED"=>[0,"fR"],"\xEE"=>[0,"fS"],"\xEF"=>[0,"fT"],"\xF0"=>[0,"fU"],"\xF1"=>[0,"fV"],"\xF2"=>[0,"fW"],"\xF3"=>[0,"fY"],"\xF4"=>[0,"fj"],"\xF5"=>[0,"fk"],"\xF6"=>[0,"fq"],"\xF7"=>[0,"fv"],"\xF8"=>[0,"fw"],"\xF9"=>[0,"fx"],"\xFA"=>[0,"fy"],"\xFB"=>[0,"fz"],"\xFC"=>[82,"f"],"\xFD"=>[87,"f"],"\xFE"=>[130,"f"],"\xFF"=>[9,"f"],],["\x00"=>[77,"d0"],"\x01"=>[18,"d0"],"\x02"=>[77,"d1"],"\x03"=>[18,"d1"],"\x04"=>[77,"d2"],"\x05"=>[18,"d2"],"\x06"=>[77,"da"],"\x07"=>[18,"da"],"\x08"=>[77,"dc"],"\x09"=>[18,"dc"],"\x0A"=>[77,"de"],"\x0B"=>[18,"de"],"\x0C"=>[77,"di"],"\x0D"=>[18,"di"],"\x0E"=>[77,"do"],"\x0F"=>[18,"do"],"\x10"=>[77,"ds"],"\x11"=>[18,"ds"],"\x12"=>[77,"dt"],"\x13"=>[18,"dt"],"\x14"=>[0,"d\x20"],"\x15"=>[0,"d\x25"],"\x16"=>[0,"d-"],"\x17"=>[0,"d."],"\x18"=>[0,"d\x2F"],"\x19"=>[0,"d3"],"\x1A"=>[0,"d4"],"\x1B"=>[0,"d5"],"\x1C"=>[0,"d6"],"\x1D"=>[0,"d7"],"\x1E"=>[0,"d8"],"\x1F"=>[0,"d9"],"\x20"=>[0,"d\x3D"],"\x21"=>[0,"dA"],"\x22"=>[0,"d_"],"\x23"=>[0,"db"],"\x24"=>[0,"dd"],"\x25"=>[0,"df"],"\x26"=>[0,"dg"],"\x27"=>[0,"dh"],"\x28"=>[0,"dl"],"\x29"=>[0,"dm"],"\x2A"=>[0,"dn"],"\x2B"=>[0,"dp"],"\x2C"=>[0,"dr"],"-"=>[0,"du"],"."=>[100,"d"],"\x2F"=>[110,"d"],[111,"d"],[115,"d"],[116,"d"],[118,"d"],[119,"d"],[122,"d"],[123,"d"],[125,"d"],[126,"d"],[129,"d"],"\x3A"=>[143,"d"],"\x3B"=>[148,"d"],"\x3C"=>[151,"d"],"\x3D"=>[153,"d"],"\x3E"=>[83,"d"],"\x3F"=>[10,"d"],"\x40"=>[77,"f0"],"A"=>[18,"f0"],"B"=>[77,"f1"],"C"=>[18,"f1"],"D"=>[77,"f2"],"E"=>[18,"f2"],"F"=>[77,"fa"],"G"=>[18,"fa"],"H"=>[77,"fc"],"I"=>[18,"fc"],"J"=>[77,"fe"],"K"=>[18,"fe"],"L"=>[77,"fi"],"M"=>[18,"fi"],"N"=>[77,"fo"],"O"=>[18,"fo"],"P"=>[77,"fs"],"Q"=>[18,"fs"],"R"=>[77,"ft"],"S"=>[18,"ft"],"T"=>[0,"f\x20"],"U"=>[0,"f\x25"],"V"=>[0,"f-"],"W"=>[0,"f."],"X"=>[0,"f\x2F"],"Y"=>[0,"f3"],"Z"=>[0,"f4"],"\x5B"=>[0,"f5"],"\x5C"=>[0,"f6"],"\x5D"=>[0,"f7"],"\x5E"=>[0,"f8"],"_"=>[0,"f9"],"\x60"=>[0,"f\x3D"],"a"=>[0,"fA"],"b"=>[0,"f_"],"c"=>[0,"fb"],"d"=>[0,"fd"],"e"=>[0,"ff"],"f"=>[0,"fg"],"g"=>[0,"fh"],"h"=>[0,"fl"],"i"=>[0,"fm"],"j"=>[0,"fn"],"k"=>[0,"fp"],"l"=>[0,"fr"],"m"=>[0,"fu"],"n"=>[100,"f"],"o"=>[110,"f"],"p"=>[111,"f"],"q"=>[115,"f"],"r"=>[116,"f"],"s"=>[118,"f"],"t"=>[119,"f"],"u"=>[122,"f"],"v"=>[123,"f"],"w"=>[125,"f"],"x"=>[126,"f"],"y"=>[129,"f"],"z"=>[143,"f"],"\x7B"=>[148,"f"],"\x7C"=>[151,"f"],"\x7D"=>[153,"f"],"~"=>[83,"f"],"\x7F"=>[10,"f"],"\x80"=>[77,"g0"],"\x81"=>[18,"g0"],"\x82"=>[77,"g1"],"\x83"=>[18,"g1"],"\x84"=>[77,"g2"],"\x85"=>[18,"g2"],"\x86"=>[77,"ga"],"\x87"=>[18,"ga"],"\x88"=>[77,"gc"],"\x89"=>[18,"gc"],"\x8A"=>[77,"ge"],"\x8B"=>[18,"ge"],"\x8C"=>[77,"gi"],"\x8D"=>[18,"gi"],"\x8E"=>[77,"go"],"\x8F"=>[18,"go"],"\x90"=>[77,"gs"],"\x91"=>[18,"gs"],"\x92"=>[77,"gt"],"\x93"=>[18,"gt"],"\x94"=>[0,"g\x20"],"\x95"=>[0,"g\x25"],"\x96"=>[0,"g-"],"\x97"=>[0,"g."],"\x98"=>[0,"g\x2F"],"\x99"=>[0,"g3"],"\x9A"=>[0,"g4"],"\x9B"=>[0,"g5"],"\x9C"=>[0,"g6"],"\x9D"=>[0,"g7"],"\x9E"=>[0,"g8"],"\x9F"=>[0,"g9"],"\xA0"=>[0,"g\x3D"],"\xA1"=>[0,"gA"],"\xA2"=>[0,"g_"],"\xA3"=>[0,"gb"],"\xA4"=>[0,"gd"],"\xA5"=>[0,"gf"],"\xA6"=>[0,"gg"],"\xA7"=>[0,"gh"],"\xA8"=>[0,"gl"],"\xA9"=>[0,"gm"],"\xAA"=>[0,"gn"],"\xAB"=>[0,"gp"],"\xAC"=>[0,"gr"],"\xAD"=>[0,"gu"],"\xAE"=>[100,"g"],"\xAF"=>[110,"g"],"\xB0"=>[111,"g"],"\xB1"=>[115,"g"],"\xB2"=>[116,"g"],"\xB3"=>[118,"g"],"\xB4"=>[119,"g"],"\xB5"=>[122,"g"],"\xB6"=>[123,"g"],"\xB7"=>[125,"g"],"\xB8"=>[126,"g"],"\xB9"=>[129,"g"],"\xBA"=>[143,"g"],"\xBB"=>[148,"g"],"\xBC"=>[151,"g"],"\xBD"=>[153,"g"],"\xBE"=>[83,"g"],"\xBF"=>[10,"g"],"\xC0"=>[77,"h0"],"\xC1"=>[18,"h0"],"\xC2"=>[77,"h1"],"\xC3"=>[18,"h1"],"\xC4"=>[77,"h2"],"\xC5"=>[18,"h2"],"\xC6"=>[77,"ha"],"\xC7"=>[18,"ha"],"\xC8"=>[77,"hc"],"\xC9"=>[18,"hc"],"\xCA"=>[77,"he"],"\xCB"=>[18,"he"],"\xCC"=>[77,"hi"],"\xCD"=>[18,"hi"],"\xCE"=>[77,"ho"],"\xCF"=>[18,"ho"],"\xD0"=>[77,"hs"],"\xD1"=>[18,"hs"],"\xD2"=>[77,"ht"],"\xD3"=>[18,"ht"],"\xD4"=>[0,"h\x20"],"\xD5"=>[0,"h\x25"],"\xD6"=>[0,"h-"],"\xD7"=>[0,"h."],"\xD8"=>[0,"h\x2F"],"\xD9"=>[0,"h3"],"\xDA"=>[0,"h4"],"\xDB"=>[0,"h5"],"\xDC"=>[0,"h6"],"\xDD"=>[0,"h7"],"\xDE"=>[0,"h8"],"\xDF"=>[0,"h9"],"\xE0"=>[0,"h\x3D"],"\xE1"=>[0,"hA"],"\xE2"=>[0,"h_"],"\xE3"=>[0,"hb"],"\xE4"=>[0,"hd"],"\xE5"=>[0,"hf"],"\xE6"=>[0,"hg"],"\xE7"=>[0,"hh"],"\xE8"=>[0,"hl"],"\xE9"=>[0,"hm"],"\xEA"=>[0,"hn"],"\xEB"=>[0,"hp"],"\xEC"=>[0,"hr"],"\xED"=>[0,"hu"],"\xEE"=>[100,"h"],"\xEF"=>[110,"h"],"\xF0"=>[111,"h"],"\xF1"=>[115,"h"],"\xF2"=>[116,"h"],"\xF3"=>[118,"h"],"\xF4"=>[119,"h"],"\xF5"=>[122,"h"],"\xF6"=>[123,"h"],"\xF7"=>[125,"h"],"\xF8"=>[126,"h"],"\xF9"=>[129,"h"],"\xFA"=>[143,"h"],"\xFB"=>[148,"h"],"\xFC"=>[151,"h"],"\xFD"=>[153,"h"],"\xFE"=>[83,"h"],"\xFF"=>[10,"h"],],["\x00"=>[94,"g0"],"\x01"=>[76,"g0"],"\x02"=>[104,"g0"],"\x03"=>[16,"g0"],"\x04"=>[94,"g1"],"\x05"=>[76,"g1"],"\x06"=>[104,"g1"],"\x07"=>[16,"g1"],"\x08"=>[94,"g2"],"\x09"=>[76,"g2"],"\x0A"=>[104,"g2"],"\x0B"=>[16,"g2"],"\x0C"=>[94,"ga"],"\x0D"=>[76,"ga"],"\x0E"=>[104,"ga"],"\x0F"=>[16,"ga"],"\x10"=>[94,"gc"],"\x11"=>[76,"gc"],"\x12"=>[104,"gc"],"\x13"=>[16,"gc"],"\x14"=>[94,"ge"],"\x15"=>[76,"ge"],"\x16"=>[104,"ge"],"\x17"=>[16,"ge"],"\x18"=>[94,"gi"],"\x19"=>[76,"gi"],"\x1A"=>[104,"gi"],"\x1B"=>[16,"gi"],"\x1C"=>[94,"go"],"\x1D"=>[76,"go"],"\x1E"=>[104,"go"],"\x1F"=>[16,"go"],"\x20"=>[94,"gs"],"\x21"=>[76,"gs"],"\x22"=>[104,"gs"],"\x23"=>[16,"gs"],"\x24"=>[94,"gt"],"\x25"=>[76,"gt"],"\x26"=>[104,"gt"],"\x27"=>[16,"gt"],"\x28"=>[77,"g\x20"],"\x29"=>[18,"g\x20"],"\x2A"=>[77,"g\x25"],"\x2B"=>[18,"g\x25"],"\x2C"=>[77,"g-"],"-"=>[18,"g-"],"."=>[77,"g."],"\x2F"=>[18,"g."],[77,"g\x2F"],[18,"g\x2F"],[77,"g3"],[18,"g3"],[77,"g4"],[18,"g4"],[77,"g5"],[18,"g5"],[77,"g6"],[18,"g6"],"\x3A"=>[77,"g7"],"\x3B"=>[18,"g7"],"\x3C"=>[77,"g8"],"\x3D"=>[18,"g8"],"\x3E"=>[77,"g9"],"\x3F"=>[18,"g9"],"\x40"=>[77,"g\x3D"],"A"=>[18,"g\x3D"],"B"=>[77,"gA"],"C"=>[18,"gA"],"D"=>[77,"g_"],"E"=>[18,"g_"],"F"=>[77,"gb"],"G"=>[18,"gb"],"H"=>[77,"gd"],"I"=>[18,"gd"],"J"=>[77,"gf"],"K"=>[18,"gf"],"L"=>[77,"gg"],"M"=>[18,"gg"],"N"=>[77,"gh"],"O"=>[18,"gh"],"P"=>[77,"gl"],"Q"=>[18,"gl"],"R"=>[77,"gm"],"S"=>[18,"gm"],"T"=>[77,"gn"],"U"=>[18,"gn"],"V"=>[77,"gp"],"W"=>[18,"gp"],"X"=>[77,"gr"],"Y"=>[18,"gr"],"Z"=>[77,"gu"],"\x5B"=>[18,"gu"],"\x5C"=>[0,"g\x3A"],"\x5D"=>[0,"gB"],"\x5E"=>[0,"gC"],"_"=>[0,"gD"],"\x60"=>[0,"gE"],"a"=>[0,"gF"],"b"=>[0,"gG"],"c"=>[0,"gH"],"d"=>[0,"gI"],"e"=>[0,"gJ"],"f"=>[0,"gK"],"g"=>[0,"gL"],"h"=>[0,"gM"],"i"=>[0,"gN"],"j"=>[0,"gO"],"k"=>[0,"gP"],"l"=>[0,"gQ"],"m"=>[0,"gR"],"n"=>[0,"gS"],"o"=>[0,"gT"],"p"=>[0,"gU"],"q"=>[0,"gV"],"r"=>[0,"gW"],"s"=>[0,"gY"],"t"=>[0,"gj"],"u"=>[0,"gk"],"v"=>[0,"gq"],"w"=>[0,"gv"],"x"=>[0,"gw"],"y"=>[0,"gx"],"z"=>[0,"gy"],"\x7B"=>[0,"gz"],"\x7C"=>[82,"g"],"\x7D"=>[87,"g"],"~"=>[130,"g"],"\x7F"=>[9,"g"],"\x80"=>[94,"h0"],"\x81"=>[76,"h0"],"\x82"=>[104,"h0"],"\x83"=>[16,"h0"],"\x84"=>[94,"h1"],"\x85"=>[76,"h1"],"\x86"=>[104,"h1"],"\x87"=>[16,"h1"],"\x88"=>[94,"h2"],"\x89"=>[76,"h2"],"\x8A"=>[104,"h2"],"\x8B"=>[16,"h2"],"\x8C"=>[94,"ha"],"\x8D"=>[76,"ha"],"\x8E"=>[104,"ha"],"\x8F"=>[16,"ha"],"\x90"=>[94,"hc"],"\x91"=>[76,"hc"],"\x92"=>[104,"hc"],"\x93"=>[16,"hc"],"\x94"=>[94,"he"],"\x95"=>[76,"he"],"\x96"=>[104,"he"],"\x97"=>[16,"he"],"\x98"=>[94,"hi"],"\x99"=>[76,"hi"],"\x9A"=>[104,"hi"],"\x9B"=>[16,"hi"],"\x9C"=>[94,"ho"],"\x9D"=>[76,"ho"],"\x9E"=>[104,"ho"],"\x9F"=>[16,"ho"],"\xA0"=>[94,"hs"],"\xA1"=>[76,"hs"],"\xA2"=>[104,"hs"],"\xA3"=>[16,"hs"],"\xA4"=>[94,"ht"],"\xA5"=>[76,"ht"],"\xA6"=>[104,"ht"],"\xA7"=>[16,"ht"],"\xA8"=>[77,"h\x20"],"\xA9"=>[18,"h\x20"],"\xAA"=>[77,"h\x25"],"\xAB"=>[18,"h\x25"],"\xAC"=>[77,"h-"],"\xAD"=>[18,"h-"],"\xAE"=>[77,"h."],"\xAF"=>[18,"h."],"\xB0"=>[77,"h\x2F"],"\xB1"=>[18,"h\x2F"],"\xB2"=>[77,"h3"],"\xB3"=>[18,"h3"],"\xB4"=>[77,"h4"],"\xB5"=>[18,"h4"],"\xB6"=>[77,"h5"],"\xB7"=>[18,"h5"],"\xB8"=>[77,"h6"],"\xB9"=>[18,"h6"],"\xBA"=>[77,"h7"],"\xBB"=>[18,"h7"],"\xBC"=>[77,"h8"],"\xBD"=>[18,"h8"],"\xBE"=>[77,"h9"],"\xBF"=>[18,"h9"],"\xC0"=>[77,"h\x3D"],"\xC1"=>[18,"h\x3D"],"\xC2"=>[77,"hA"],"\xC3"=>[18,"hA"],"\xC4"=>[77,"h_"],"\xC5"=>[18,"h_"],"\xC6"=>[77,"hb"],"\xC7"=>[18,"hb"],"\xC8"=>[77,"hd"],"\xC9"=>[18,"hd"],"\xCA"=>[77,"hf"],"\xCB"=>[18,"hf"],"\xCC"=>[77,"hg"],"\xCD"=>[18,"hg"],"\xCE"=>[77,"hh"],"\xCF"=>[18,"hh"],"\xD0"=>[77,"hl"],"\xD1"=>[18,"hl"],"\xD2"=>[77,"hm"],"\xD3"=>[18,"hm"],"\xD4"=>[77,"hn"],"\xD5"=>[18,"hn"],"\xD6"=>[77,"hp"],"\xD7"=>[18,"hp"],"\xD8"=>[77,"hr"],"\xD9"=>[18,"hr"],"\xDA"=>[77,"hu"],"\xDB"=>[18,"hu"],"\xDC"=>[0,"h\x3A"],"\xDD"=>[0,"hB"],"\xDE"=>[0,"hC"],"\xDF"=>[0,"hD"],"\xE0"=>[0,"hE"],"\xE1"=>[0,"hF"],"\xE2"=>[0,"hG"],"\xE3"=>[0,"hH"],"\xE4"=>[0,"hI"],"\xE5"=>[0,"hJ"],"\xE6"=>[0,"hK"],"\xE7"=>[0,"hL"],"\xE8"=>[0,"hM"],"\xE9"=>[0,"hN"],"\xEA"=>[0,"hO"],"\xEB"=>[0,"hP"],"\xEC"=>[0,"hQ"],"\xED"=>[0,"hR"],"\xEE"=>[0,"hS"],"\xEF"=>[0,"hT"],"\xF0"=>[0,"hU"],"\xF1"=>[0,"hV"],"\xF2"=>[0,"hW"],"\xF3"=>[0,"hY"],"\xF4"=>[0,"hj"],"\xF5"=>[0,"hk"],"\xF6"=>[0,"hq"],"\xF7"=>[0,"hv"],"\xF8"=>[0,"hw"],"\xF9"=>[0,"hx"],"\xFA"=>[0,"hy"],"\xFB"=>[0,"hz"],"\xFC"=>[82,"h"],"\xFD"=>[87,"h"],"\xFE"=>[130,"h"],"\xFF"=>[9,"h"],],["\x00"=>[94,"i0"],"\x01"=>[76,"i0"],"\x02"=>[104,"i0"],"\x03"=>[16,"i0"],"\x04"=>[94,"i1"],"\x05"=>[76,"i1"],"\x06"=>[104,"i1"],"\x07"=>[16,"i1"],"\x08"=>[94,"i2"],"\x09"=>[76,"i2"],"\x0A"=>[104,"i2"],"\x0B"=>[16,"i2"],"\x0C"=>[94,"ia"],"\x0D"=>[76,"ia"],"\x0E"=>[104,"ia"],"\x0F"=>[16,"ia"],"\x10"=>[94,"ic"],"\x11"=>[76,"ic"],"\x12"=>[104,"ic"],"\x13"=>[16,"ic"],"\x14"=>[94,"ie"],"\x15"=>[76,"ie"],"\x16"=>[104,"ie"],"\x17"=>[16,"ie"],"\x18"=>[94,"ii"],"\x19"=>[76,"ii"],"\x1A"=>[104,"ii"],"\x1B"=>[16,"ii"],"\x1C"=>[94,"io"],"\x1D"=>[76,"io"],"\x1E"=>[104,"io"],"\x1F"=>[16,"io"],"\x20"=>[94,"is"],"\x21"=>[76,"is"],"\x22"=>[104,"is"],"\x23"=>[16,"is"],"\x24"=>[94,"it"],"\x25"=>[76,"it"],"\x26"=>[104,"it"],"\x27"=>[16,"it"],"\x28"=>[77,"i\x20"],"\x29"=>[18,"i\x20"],"\x2A"=>[77,"i\x25"],"\x2B"=>[18,"i\x25"],"\x2C"=>[77,"i-"],"-"=>[18,"i-"],"."=>[77,"i."],"\x2F"=>[18,"i."],[77,"i\x2F"],[18,"i\x2F"],[77,"i3"],[18,"i3"],[77,"i4"],[18,"i4"],[77,"i5"],[18,"i5"],[77,"i6"],[18,"i6"],"\x3A"=>[77,"i7"],"\x3B"=>[18,"i7"],"\x3C"=>[77,"i8"],"\x3D"=>[18,"i8"],"\x3E"=>[77,"i9"],"\x3F"=>[18,"i9"],"\x40"=>[77,"i\x3D"],"A"=>[18,"i\x3D"],"B"=>[77,"iA"],"C"=>[18,"iA"],"D"=>[77,"i_"],"E"=>[18,"i_"],"F"=>[77,"ib"],"G"=>[18,"ib"],"H"=>[77,"id"],"I"=>[18,"id"],"J"=>[77,"if"],"K"=>[18,"if"],"L"=>[77,"ig"],"M"=>[18,"ig"],"N"=>[77,"ih"],"O"=>[18,"ih"],"P"=>[77,"il"],"Q"=>[18,"il"],"R"=>[77,"im"],"S"=>[18,"im"],"T"=>[77,"in"],"U"=>[18,"in"],"V"=>[77,"ip"],"W"=>[18,"ip"],"X"=>[77,"ir"],"Y"=>[18,"ir"],"Z"=>[77,"iu"],"\x5B"=>[18,"iu"],"\x5C"=>[0,"i\x3A"],"\x5D"=>[0,"iB"],"\x5E"=>[0,"iC"],"_"=>[0,"iD"],"\x60"=>[0,"iE"],"a"=>[0,"iF"],"b"=>[0,"iG"],"c"=>[0,"iH"],"d"=>[0,"iI"],"e"=>[0,"iJ"],"f"=>[0,"iK"],"g"=>[0,"iL"],"h"=>[0,"iM"],"i"=>[0,"iN"],"j"=>[0,"iO"],"k"=>[0,"iP"],"l"=>[0,"iQ"],"m"=>[0,"iR"],"n"=>[0,"iS"],"o"=>[0,"iT"],"p"=>[0,"iU"],"q"=>[0,"iV"],"r"=>[0,"iW"],"s"=>[0,"iY"],"t"=>[0,"ij"],"u"=>[0,"ik"],"v"=>[0,"iq"],"w"=>[0,"iv"],"x"=>[0,"iw"],"y"=>[0,"ix"],"z"=>[0,"iy"],"\x7B"=>[0,"iz"],"\x7C"=>[82,"i"],"\x7D"=>[87,"i"],"~"=>[130,"i"],"\x7F"=>[9,"i"],"\x80"=>[94,"o0"],"\x81"=>[76,"o0"],"\x82"=>[104,"o0"],"\x83"=>[16,"o0"],"\x84"=>[94,"o1"],"\x85"=>[76,"o1"],"\x86"=>[104,"o1"],"\x87"=>[16,"o1"],"\x88"=>[94,"o2"],"\x89"=>[76,"o2"],"\x8A"=>[104,"o2"],"\x8B"=>[16,"o2"],"\x8C"=>[94,"oa"],"\x8D"=>[76,"oa"],"\x8E"=>[104,"oa"],"\x8F"=>[16,"oa"],"\x90"=>[94,"oc"],"\x91"=>[76,"oc"],"\x92"=>[104,"oc"],"\x93"=>[16,"oc"],"\x94"=>[94,"oe"],"\x95"=>[76,"oe"],"\x96"=>[104,"oe"],"\x97"=>[16,"oe"],"\x98"=>[94,"oi"],"\x99"=>[76,"oi"],"\x9A"=>[104,"oi"],"\x9B"=>[16,"oi"],"\x9C"=>[94,"oo"],"\x9D"=>[76,"oo"],"\x9E"=>[104,"oo"],"\x9F"=>[16,"oo"],"\xA0"=>[94,"os"],"\xA1"=>[76,"os"],"\xA2"=>[104,"os"],"\xA3"=>[16,"os"],"\xA4"=>[94,"ot"],"\xA5"=>[76,"ot"],"\xA6"=>[104,"ot"],"\xA7"=>[16,"ot"],"\xA8"=>[77,"o\x20"],"\xA9"=>[18,"o\x20"],"\xAA"=>[77,"o\x25"],"\xAB"=>[18,"o\x25"],"\xAC"=>[77,"o-"],"\xAD"=>[18,"o-"],"\xAE"=>[77,"o."],"\xAF"=>[18,"o."],"\xB0"=>[77,"o\x2F"],"\xB1"=>[18,"o\x2F"],"\xB2"=>[77,"o3"],"\xB3"=>[18,"o3"],"\xB4"=>[77,"o4"],"\xB5"=>[18,"o4"],"\xB6"=>[77,"o5"],"\xB7"=>[18,"o5"],"\xB8"=>[77,"o6"],"\xB9"=>[18,"o6"],"\xBA"=>[77,"o7"],"\xBB"=>[18,"o7"],"\xBC"=>[77,"o8"],"\xBD"=>[18,"o8"],"\xBE"=>[77,"o9"],"\xBF"=>[18,"o9"],"\xC0"=>[77,"o\x3D"],"\xC1"=>[18,"o\x3D"],"\xC2"=>[77,"oA"],"\xC3"=>[18,"oA"],"\xC4"=>[77,"o_"],"\xC5"=>[18,"o_"],"\xC6"=>[77,"ob"],"\xC7"=>[18,"ob"],"\xC8"=>[77,"od"],"\xC9"=>[18,"od"],"\xCA"=>[77,"of"],"\xCB"=>[18,"of"],"\xCC"=>[77,"og"],"\xCD"=>[18,"og"],"\xCE"=>[77,"oh"],"\xCF"=>[18,"oh"],"\xD0"=>[77,"ol"],"\xD1"=>[18,"ol"],"\xD2"=>[77,"om"],"\xD3"=>[18,"om"],"\xD4"=>[77,"on"],"\xD5"=>[18,"on"],"\xD6"=>[77,"op"],"\xD7"=>[18,"op"],"\xD8"=>[77,"or"],"\xD9"=>[18,"or"],"\xDA"=>[77,"ou"],"\xDB"=>[18,"ou"],"\xDC"=>[0,"o\x3A"],"\xDD"=>[0,"oB"],"\xDE"=>[0,"oC"],"\xDF"=>[0,"oD"],"\xE0"=>[0,"oE"],"\xE1"=>[0,"oF"],"\xE2"=>[0,"oG"],"\xE3"=>[0,"oH"],"\xE4"=>[0,"oI"],"\xE5"=>[0,"oJ"],"\xE6"=>[0,"oK"],"\xE7"=>[0,"oL"],"\xE8"=>[0,"oM"],"\xE9"=>[0,"oN"],"\xEA"=>[0,"oO"],"\xEB"=>[0,"oP"],"\xEC"=>[0,"oQ"],"\xED"=>[0,"oR"],"\xEE"=>[0,"oS"],"\xEF"=>[0,"oT"],"\xF0"=>[0,"oU"],"\xF1"=>[0,"oV"],"\xF2"=>[0,"oW"],"\xF3"=>[0,"oY"],"\xF4"=>[0,"oj"],"\xF5"=>[0,"ok"],"\xF6"=>[0,"oq"],"\xF7"=>[0,"ov"],"\xF8"=>[0,"ow"],"\xF9"=>[0,"ox"],"\xFA"=>[0,"oy"],"\xFB"=>[0,"oz"],"\xFC"=>[82,"o"],"\xFD"=>[87,"o"],"\xFE"=>[130,"o"],"\xFF"=>[9,"o"],],["\x00"=>[94,"j0"],"\x01"=>[76,"j0"],"\x02"=>[104,"j0"],"\x03"=>[16,"j0"],"\x04"=>[94,"j1"],"\x05"=>[76,"j1"],"\x06"=>[104,"j1"],"\x07"=>[16,"j1"],"\x08"=>[94,"j2"],"\x09"=>[76,"j2"],"\x0A"=>[104,"j2"],"\x0B"=>[16,"j2"],"\x0C"=>[94,"ja"],"\x0D"=>[76,"ja"],"\x0E"=>[104,"ja"],"\x0F"=>[16,"ja"],"\x10"=>[94,"jc"],"\x11"=>[76,"jc"],"\x12"=>[104,"jc"],"\x13"=>[16,"jc"],"\x14"=>[94,"je"],"\x15"=>[76,"je"],"\x16"=>[104,"je"],"\x17"=>[16,"je"],"\x18"=>[94,"ji"],"\x19"=>[76,"ji"],"\x1A"=>[104,"ji"],"\x1B"=>[16,"ji"],"\x1C"=>[94,"jo"],"\x1D"=>[76,"jo"],"\x1E"=>[104,"jo"],"\x1F"=>[16,"jo"],"\x20"=>[94,"js"],"\x21"=>[76,"js"],"\x22"=>[104,"js"],"\x23"=>[16,"js"],"\x24"=>[94,"jt"],"\x25"=>[76,"jt"],"\x26"=>[104,"jt"],"\x27"=>[16,"jt"],"\x28"=>[77,"j\x20"],"\x29"=>[18,"j\x20"],"\x2A"=>[77,"j\x25"],"\x2B"=>[18,"j\x25"],"\x2C"=>[77,"j-"],"-"=>[18,"j-"],"."=>[77,"j."],"\x2F"=>[18,"j."],[77,"j\x2F"],[18,"j\x2F"],[77,"j3"],[18,"j3"],[77,"j4"],[18,"j4"],[77,"j5"],[18,"j5"],[77,"j6"],[18,"j6"],"\x3A"=>[77,"j7"],"\x3B"=>[18,"j7"],"\x3C"=>[77,"j8"],"\x3D"=>[18,"j8"],"\x3E"=>[77,"j9"],"\x3F"=>[18,"j9"],"\x40"=>[77,"j\x3D"],"A"=>[18,"j\x3D"],"B"=>[77,"jA"],"C"=>[18,"jA"],"D"=>[77,"j_"],"E"=>[18,"j_"],"F"=>[77,"jb"],"G"=>[18,"jb"],"H"=>[77,"jd"],"I"=>[18,"jd"],"J"=>[77,"jf"],"K"=>[18,"jf"],"L"=>[77,"jg"],"M"=>[18,"jg"],"N"=>[77,"jh"],"O"=>[18,"jh"],"P"=>[77,"jl"],"Q"=>[18,"jl"],"R"=>[77,"jm"],"S"=>[18,"jm"],"T"=>[77,"jn"],"U"=>[18,"jn"],"V"=>[77,"jp"],"W"=>[18,"jp"],"X"=>[77,"jr"],"Y"=>[18,"jr"],"Z"=>[77,"ju"],"\x5B"=>[18,"ju"],"\x5C"=>[0,"j\x3A"],"\x5D"=>[0,"jB"],"\x5E"=>[0,"jC"],"_"=>[0,"jD"],"\x60"=>[0,"jE"],"a"=>[0,"jF"],"b"=>[0,"jG"],"c"=>[0,"jH"],"d"=>[0,"jI"],"e"=>[0,"jJ"],"f"=>[0,"jK"],"g"=>[0,"jL"],"h"=>[0,"jM"],"i"=>[0,"jN"],"j"=>[0,"jO"],"k"=>[0,"jP"],"l"=>[0,"jQ"],"m"=>[0,"jR"],"n"=>[0,"jS"],"o"=>[0,"jT"],"p"=>[0,"jU"],"q"=>[0,"jV"],"r"=>[0,"jW"],"s"=>[0,"jY"],"t"=>[0,"jj"],"u"=>[0,"jk"],"v"=>[0,"jq"],"w"=>[0,"jv"],"x"=>[0,"jw"],"y"=>[0,"jx"],"z"=>[0,"jy"],"\x7B"=>[0,"jz"],"\x7C"=>[82,"j"],"\x7D"=>[87,"j"],"~"=>[130,"j"],"\x7F"=>[9,"j"],"\x80"=>[94,"k0"],"\x81"=>[76,"k0"],"\x82"=>[104,"k0"],"\x83"=>[16,"k0"],"\x84"=>[94,"k1"],"\x85"=>[76,"k1"],"\x86"=>[104,"k1"],"\x87"=>[16,"k1"],"\x88"=>[94,"k2"],"\x89"=>[76,"k2"],"\x8A"=>[104,"k2"],"\x8B"=>[16,"k2"],"\x8C"=>[94,"ka"],"\x8D"=>[76,"ka"],"\x8E"=>[104,"ka"],"\x8F"=>[16,"ka"],"\x90"=>[94,"kc"],"\x91"=>[76,"kc"],"\x92"=>[104,"kc"],"\x93"=>[16,"kc"],"\x94"=>[94,"ke"],"\x95"=>[76,"ke"],"\x96"=>[104,"ke"],"\x97"=>[16,"ke"],"\x98"=>[94,"ki"],"\x99"=>[76,"ki"],"\x9A"=>[104,"ki"],"\x9B"=>[16,"ki"],"\x9C"=>[94,"ko"],"\x9D"=>[76,"ko"],"\x9E"=>[104,"ko"],"\x9F"=>[16,"ko"],"\xA0"=>[94,"ks"],"\xA1"=>[76,"ks"],"\xA2"=>[104,"ks"],"\xA3"=>[16,"ks"],"\xA4"=>[94,"kt"],"\xA5"=>[76,"kt"],"\xA6"=>[104,"kt"],"\xA7"=>[16,"kt"],"\xA8"=>[77,"k\x20"],"\xA9"=>[18,"k\x20"],"\xAA"=>[77,"k\x25"],"\xAB"=>[18,"k\x25"],"\xAC"=>[77,"k-"],"\xAD"=>[18,"k-"],"\xAE"=>[77,"k."],"\xAF"=>[18,"k."],"\xB0"=>[77,"k\x2F"],"\xB1"=>[18,"k\x2F"],"\xB2"=>[77,"k3"],"\xB3"=>[18,"k3"],"\xB4"=>[77,"k4"],"\xB5"=>[18,"k4"],"\xB6"=>[77,"k5"],"\xB7"=>[18,"k5"],"\xB8"=>[77,"k6"],"\xB9"=>[18,"k6"],"\xBA"=>[77,"k7"],"\xBB"=>[18,"k7"],"\xBC"=>[77,"k8"],"\xBD"=>[18,"k8"],"\xBE"=>[77,"k9"],"\xBF"=>[18,"k9"],"\xC0"=>[77,"k\x3D"],"\xC1"=>[18,"k\x3D"],"\xC2"=>[77,"kA"],"\xC3"=>[18,"kA"],"\xC4"=>[77,"k_"],"\xC5"=>[18,"k_"],"\xC6"=>[77,"kb"],"\xC7"=>[18,"kb"],"\xC8"=>[77,"kd"],"\xC9"=>[18,"kd"],"\xCA"=>[77,"kf"],"\xCB"=>[18,"kf"],"\xCC"=>[77,"kg"],"\xCD"=>[18,"kg"],"\xCE"=>[77,"kh"],"\xCF"=>[18,"kh"],"\xD0"=>[77,"kl"],"\xD1"=>[18,"kl"],"\xD2"=>[77,"km"],"\xD3"=>[18,"km"],"\xD4"=>[77,"kn"],"\xD5"=>[18,"kn"],"\xD6"=>[77,"kp"],"\xD7"=>[18,"kp"],"\xD8"=>[77,"kr"],"\xD9"=>[18,"kr"],"\xDA"=>[77,"ku"],"\xDB"=>[18,"ku"],"\xDC"=>[0,"k\x3A"],"\xDD"=>[0,"kB"],"\xDE"=>[0,"kC"],"\xDF"=>[0,"kD"],"\xE0"=>[0,"kE"],"\xE1"=>[0,"kF"],"\xE2"=>[0,"kG"],"\xE3"=>[0,"kH"],"\xE4"=>[0,"kI"],"\xE5"=>[0,"kJ"],"\xE6"=>[0,"kK"],"\xE7"=>[0,"kL"],"\xE8"=>[0,"kM"],"\xE9"=>[0,"kN"],"\xEA"=>[0,"kO"],"\xEB"=>[0,"kP"],"\xEC"=>[0,"kQ"],"\xED"=>[0,"kR"],"\xEE"=>[0,"kS"],"\xEF"=>[0,"kT"],"\xF0"=>[0,"kU"],"\xF1"=>[0,"kV"],"\xF2"=>[0,"kW"],"\xF3"=>[0,"kY"],"\xF4"=>[0,"kj"],"\xF5"=>[0,"kk"],"\xF6"=>[0,"kq"],"\xF7"=>[0,"kv"],"\xF8"=>[0,"kw"],"\xF9"=>[0,"kx"],"\xFA"=>[0,"ky"],"\xFB"=>[0,"kz"],"\xFC"=>[82,"k"],"\xFD"=>[87,"k"],"\xFE"=>[130,"k"],"\xFF"=>[9,"k"],],["\x00"=>[77,"j0"],"\x01"=>[18,"j0"],"\x02"=>[77,"j1"],"\x03"=>[18,"j1"],"\x04"=>[77,"j2"],"\x05"=>[18,"j2"],"\x06"=>[77,"ja"],"\x07"=>[18,"ja"],"\x08"=>[77,"jc"],"\x09"=>[18,"jc"],"\x0A"=>[77,"je"],"\x0B"=>[18,"je"],"\x0C"=>[77,"ji"],"\x0D"=>[18,"ji"],"\x0E"=>[77,"jo"],"\x0F"=>[18,"jo"],"\x10"=>[77,"js"],"\x11"=>[18,"js"],"\x12"=>[77,"jt"],"\x13"=>[18,"jt"],"\x14"=>[0,"j\x20"],"\x15"=>[0,"j\x25"],"\x16"=>[0,"j-"],"\x17"=>[0,"j."],"\x18"=>[0,"j\x2F"],"\x19"=>[0,"j3"],"\x1A"=>[0,"j4"],"\x1B"=>[0,"j5"],"\x1C"=>[0,"j6"],"\x1D"=>[0,"j7"],"\x1E"=>[0,"j8"],"\x1F"=>[0,"j9"],"\x20"=>[0,"j\x3D"],"\x21"=>[0,"jA"],"\x22"=>[0,"j_"],"\x23"=>[0,"jb"],"\x24"=>[0,"jd"],"\x25"=>[0,"jf"],"\x26"=>[0,"jg"],"\x27"=>[0,"jh"],"\x28"=>[0,"jl"],"\x29"=>[0,"jm"],"\x2A"=>[0,"jn"],"\x2B"=>[0,"jp"],"\x2C"=>[0,"jr"],"-"=>[0,"ju"],"."=>[100,"j"],"\x2F"=>[110,"j"],[111,"j"],[115,"j"],[116,"j"],[118,"j"],[119,"j"],[122,"j"],[123,"j"],[125,"j"],[126,"j"],[129,"j"],"\x3A"=>[143,"j"],"\x3B"=>[148,"j"],"\x3C"=>[151,"j"],"\x3D"=>[153,"j"],"\x3E"=>[83,"j"],"\x3F"=>[10,"j"],"\x40"=>[77,"k0"],"A"=>[18,"k0"],"B"=>[77,"k1"],"C"=>[18,"k1"],"D"=>[77,"k2"],"E"=>[18,"k2"],"F"=>[77,"ka"],"G"=>[18,"ka"],"H"=>[77,"kc"],"I"=>[18,"kc"],"J"=>[77,"ke"],"K"=>[18,"ke"],"L"=>[77,"ki"],"M"=>[18,"ki"],"N"=>[77,"ko"],"O"=>[18,"ko"],"P"=>[77,"ks"],"Q"=>[18,"ks"],"R"=>[77,"kt"],"S"=>[18,"kt"],"T"=>[0,"k\x20"],"U"=>[0,"k\x25"],"V"=>[0,"k-"],"W"=>[0,"k."],"X"=>[0,"k\x2F"],"Y"=>[0,"k3"],"Z"=>[0,"k4"],"\x5B"=>[0,"k5"],"\x5C"=>[0,"k6"],"\x5D"=>[0,"k7"],"\x5E"=>[0,"k8"],"_"=>[0,"k9"],"\x60"=>[0,"k\x3D"],"a"=>[0,"kA"],"b"=>[0,"k_"],"c"=>[0,"kb"],"d"=>[0,"kd"],"e"=>[0,"kf"],"f"=>[0,"kg"],"g"=>[0,"kh"],"h"=>[0,"kl"],"i"=>[0,"km"],"j"=>[0,"kn"],"k"=>[0,"kp"],"l"=>[0,"kr"],"m"=>[0,"ku"],"n"=>[100,"k"],"o"=>[110,"k"],"p"=>[111,"k"],"q"=>[115,"k"],"r"=>[116,"k"],"s"=>[118,"k"],"t"=>[119,"k"],"u"=>[122,"k"],"v"=>[123,"k"],"w"=>[125,"k"],"x"=>[126,"k"],"y"=>[129,"k"],"z"=>[143,"k"],"\x7B"=>[148,"k"],"\x7C"=>[151,"k"],"\x7D"=>[153,"k"],"~"=>[83,"k"],"\x7F"=>[10,"k"],"\x80"=>[77,"q0"],"\x81"=>[18,"q0"],"\x82"=>[77,"q1"],"\x83"=>[18,"q1"],"\x84"=>[77,"q2"],"\x85"=>[18,"q2"],"\x86"=>[77,"qa"],"\x87"=>[18,"qa"],"\x88"=>[77,"qc"],"\x89"=>[18,"qc"],"\x8A"=>[77,"qe"],"\x8B"=>[18,"qe"],"\x8C"=>[77,"qi"],"\x8D"=>[18,"qi"],"\x8E"=>[77,"qo"],"\x8F"=>[18,"qo"],"\x90"=>[77,"qs"],"\x91"=>[18,"qs"],"\x92"=>[77,"qt"],"\x93"=>[18,"qt"],"\x94"=>[0,"q\x20"],"\x95"=>[0,"q\x25"],"\x96"=>[0,"q-"],"\x97"=>[0,"q."],"\x98"=>[0,"q\x2F"],"\x99"=>[0,"q3"],"\x9A"=>[0,"q4"],"\x9B"=>[0,"q5"],"\x9C"=>[0,"q6"],"\x9D"=>[0,"q7"],"\x9E"=>[0,"q8"],"\x9F"=>[0,"q9"],"\xA0"=>[0,"q\x3D"],"\xA1"=>[0,"qA"],"\xA2"=>[0,"q_"],"\xA3"=>[0,"qb"],"\xA4"=>[0,"qd"],"\xA5"=>[0,"qf"],"\xA6"=>[0,"qg"],"\xA7"=>[0,"qh"],"\xA8"=>[0,"ql"],"\xA9"=>[0,"qm"],"\xAA"=>[0,"qn"],"\xAB"=>[0,"qp"],"\xAC"=>[0,"qr"],"\xAD"=>[0,"qu"],"\xAE"=>[100,"q"],"\xAF"=>[110,"q"],"\xB0"=>[111,"q"],"\xB1"=>[115,"q"],"\xB2"=>[116,"q"],"\xB3"=>[118,"q"],"\xB4"=>[119,"q"],"\xB5"=>[122,"q"],"\xB6"=>[123,"q"],"\xB7"=>[125,"q"],"\xB8"=>[126,"q"],"\xB9"=>[129,"q"],"\xBA"=>[143,"q"],"\xBB"=>[148,"q"],"\xBC"=>[151,"q"],"\xBD"=>[153,"q"],"\xBE"=>[83,"q"],"\xBF"=>[10,"q"],"\xC0"=>[77,"v0"],"\xC1"=>[18,"v0"],"\xC2"=>[77,"v1"],"\xC3"=>[18,"v1"],"\xC4"=>[77,"v2"],"\xC5"=>[18,"v2"],"\xC6"=>[77,"va"],"\xC7"=>[18,"va"],"\xC8"=>[77,"vc"],"\xC9"=>[18,"vc"],"\xCA"=>[77,"ve"],"\xCB"=>[18,"ve"],"\xCC"=>[77,"vi"],"\xCD"=>[18,"vi"],"\xCE"=>[77,"vo"],"\xCF"=>[18,"vo"],"\xD0"=>[77,"vs"],"\xD1"=>[18,"vs"],"\xD2"=>[77,"vt"],"\xD3"=>[18,"vt"],"\xD4"=>[0,"v\x20"],"\xD5"=>[0,"v\x25"],"\xD6"=>[0,"v-"],"\xD7"=>[0,"v."],"\xD8"=>[0,"v\x2F"],"\xD9"=>[0,"v3"],"\xDA"=>[0,"v4"],"\xDB"=>[0,"v5"],"\xDC"=>[0,"v6"],"\xDD"=>[0,"v7"],"\xDE"=>[0,"v8"],"\xDF"=>[0,"v9"],"\xE0"=>[0,"v\x3D"],"\xE1"=>[0,"vA"],"\xE2"=>[0,"v_"],"\xE3"=>[0,"vb"],"\xE4"=>[0,"vd"],"\xE5"=>[0,"vf"],"\xE6"=>[0,"vg"],"\xE7"=>[0,"vh"],"\xE8"=>[0,"vl"],"\xE9"=>[0,"vm"],"\xEA"=>[0,"vn"],"\xEB"=>[0,"vp"],"\xEC"=>[0,"vr"],"\xED"=>[0,"vu"],"\xEE"=>[100,"v"],"\xEF"=>[110,"v"],"\xF0"=>[111,"v"],"\xF1"=>[115,"v"],"\xF2"=>[116,"v"],"\xF3"=>[118,"v"],"\xF4"=>[119,"v"],"\xF5"=>[122,"v"],"\xF6"=>[123,"v"],"\xF7"=>[125,"v"],"\xF8"=>[126,"v"],"\xF9"=>[129,"v"],"\xFA"=>[143,"v"],"\xFB"=>[148,"v"],"\xFC"=>[151,"v"],"\xFD"=>[153,"v"],"\xFE"=>[83,"v"],"\xFF"=>[10,"v"],],["\x00"=>[94,"l0"],"\x01"=>[76,"l0"],"\x02"=>[104,"l0"],"\x03"=>[16,"l0"],"\x04"=>[94,"l1"],"\x05"=>[76,"l1"],"\x06"=>[104,"l1"],"\x07"=>[16,"l1"],"\x08"=>[94,"l2"],"\x09"=>[76,"l2"],"\x0A"=>[104,"l2"],"\x0B"=>[16,"l2"],"\x0C"=>[94,"la"],"\x0D"=>[76,"la"],"\x0E"=>[104,"la"],"\x0F"=>[16,"la"],"\x10"=>[94,"lc"],"\x11"=>[76,"lc"],"\x12"=>[104,"lc"],"\x13"=>[16,"lc"],"\x14"=>[94,"le"],"\x15"=>[76,"le"],"\x16"=>[104,"le"],"\x17"=>[16,"le"],"\x18"=>[94,"li"],"\x19"=>[76,"li"],"\x1A"=>[104,"li"],"\x1B"=>[16,"li"],"\x1C"=>[94,"lo"],"\x1D"=>[76,"lo"],"\x1E"=>[104,"lo"],"\x1F"=>[16,"lo"],"\x20"=>[94,"ls"],"\x21"=>[76,"ls"],"\x22"=>[104,"ls"],"\x23"=>[16,"ls"],"\x24"=>[94,"lt"],"\x25"=>[76,"lt"],"\x26"=>[104,"lt"],"\x27"=>[16,"lt"],"\x28"=>[77,"l\x20"],"\x29"=>[18,"l\x20"],"\x2A"=>[77,"l\x25"],"\x2B"=>[18,"l\x25"],"\x2C"=>[77,"l-"],"-"=>[18,"l-"],"."=>[77,"l."],"\x2F"=>[18,"l."],[77,"l\x2F"],[18,"l\x2F"],[77,"l3"],[18,"l3"],[77,"l4"],[18,"l4"],[77,"l5"],[18,"l5"],[77,"l6"],[18,"l6"],"\x3A"=>[77,"l7"],"\x3B"=>[18,"l7"],"\x3C"=>[77,"l8"],"\x3D"=>[18,"l8"],"\x3E"=>[77,"l9"],"\x3F"=>[18,"l9"],"\x40"=>[77,"l\x3D"],"A"=>[18,"l\x3D"],"B"=>[77,"lA"],"C"=>[18,"lA"],"D"=>[77,"l_"],"E"=>[18,"l_"],"F"=>[77,"lb"],"G"=>[18,"lb"],"H"=>[77,"ld"],"I"=>[18,"ld"],"J"=>[77,"lf"],"K"=>[18,"lf"],"L"=>[77,"lg"],"M"=>[18,"lg"],"N"=>[77,"lh"],"O"=>[18,"lh"],"P"=>[77,"ll"],"Q"=>[18,"ll"],"R"=>[77,"lm"],"S"=>[18,"lm"],"T"=>[77,"ln"],"U"=>[18,"ln"],"V"=>[77,"lp"],"W"=>[18,"lp"],"X"=>[77,"lr"],"Y"=>[18,"lr"],"Z"=>[77,"lu"],"\x5B"=>[18,"lu"],"\x5C"=>[0,"l\x3A"],"\x5D"=>[0,"lB"],"\x5E"=>[0,"lC"],"_"=>[0,"lD"],"\x60"=>[0,"lE"],"a"=>[0,"lF"],"b"=>[0,"lG"],"c"=>[0,"lH"],"d"=>[0,"lI"],"e"=>[0,"lJ"],"f"=>[0,"lK"],"g"=>[0,"lL"],"h"=>[0,"lM"],"i"=>[0,"lN"],"j"=>[0,"lO"],"k"=>[0,"lP"],"l"=>[0,"lQ"],"m"=>[0,"lR"],"n"=>[0,"lS"],"o"=>[0,"lT"],"p"=>[0,"lU"],"q"=>[0,"lV"],"r"=>[0,"lW"],"s"=>[0,"lY"],"t"=>[0,"lj"],"u"=>[0,"lk"],"v"=>[0,"lq"],"w"=>[0,"lv"],"x"=>[0,"lw"],"y"=>[0,"lx"],"z"=>[0,"ly"],"\x7B"=>[0,"lz"],"\x7C"=>[82,"l"],"\x7D"=>[87,"l"],"~"=>[130,"l"],"\x7F"=>[9,"l"],"\x80"=>[94,"m0"],"\x81"=>[76,"m0"],"\x82"=>[104,"m0"],"\x83"=>[16,"m0"],"\x84"=>[94,"m1"],"\x85"=>[76,"m1"],"\x86"=>[104,"m1"],"\x87"=>[16,"m1"],"\x88"=>[94,"m2"],"\x89"=>[76,"m2"],"\x8A"=>[104,"m2"],"\x8B"=>[16,"m2"],"\x8C"=>[94,"ma"],"\x8D"=>[76,"ma"],"\x8E"=>[104,"ma"],"\x8F"=>[16,"ma"],"\x90"=>[94,"mc"],"\x91"=>[76,"mc"],"\x92"=>[104,"mc"],"\x93"=>[16,"mc"],"\x94"=>[94,"me"],"\x95"=>[76,"me"],"\x96"=>[104,"me"],"\x97"=>[16,"me"],"\x98"=>[94,"mi"],"\x99"=>[76,"mi"],"\x9A"=>[104,"mi"],"\x9B"=>[16,"mi"],"\x9C"=>[94,"mo"],"\x9D"=>[76,"mo"],"\x9E"=>[104,"mo"],"\x9F"=>[16,"mo"],"\xA0"=>[94,"ms"],"\xA1"=>[76,"ms"],"\xA2"=>[104,"ms"],"\xA3"=>[16,"ms"],"\xA4"=>[94,"mt"],"\xA5"=>[76,"mt"],"\xA6"=>[104,"mt"],"\xA7"=>[16,"mt"],"\xA8"=>[77,"m\x20"],"\xA9"=>[18,"m\x20"],"\xAA"=>[77,"m\x25"],"\xAB"=>[18,"m\x25"],"\xAC"=>[77,"m-"],"\xAD"=>[18,"m-"],"\xAE"=>[77,"m."],"\xAF"=>[18,"m."],"\xB0"=>[77,"m\x2F"],"\xB1"=>[18,"m\x2F"],"\xB2"=>[77,"m3"],"\xB3"=>[18,"m3"],"\xB4"=>[77,"m4"],"\xB5"=>[18,"m4"],"\xB6"=>[77,"m5"],"\xB7"=>[18,"m5"],"\xB8"=>[77,"m6"],"\xB9"=>[18,"m6"],"\xBA"=>[77,"m7"],"\xBB"=>[18,"m7"],"\xBC"=>[77,"m8"],"\xBD"=>[18,"m8"],"\xBE"=>[77,"m9"],"\xBF"=>[18,"m9"],"\xC0"=>[77,"m\x3D"],"\xC1"=>[18,"m\x3D"],"\xC2"=>[77,"mA"],"\xC3"=>[18,"mA"],"\xC4"=>[77,"m_"],"\xC5"=>[18,"m_"],"\xC6"=>[77,"mb"],"\xC7"=>[18,"mb"],"\xC8"=>[77,"md"],"\xC9"=>[18,"md"],"\xCA"=>[77,"mf"],"\xCB"=>[18,"mf"],"\xCC"=>[77,"mg"],"\xCD"=>[18,"mg"],"\xCE"=>[77,"mh"],"\xCF"=>[18,"mh"],"\xD0"=>[77,"ml"],"\xD1"=>[18,"ml"],"\xD2"=>[77,"mm"],"\xD3"=>[18,"mm"],"\xD4"=>[77,"mn"],"\xD5"=>[18,"mn"],"\xD6"=>[77,"mp"],"\xD7"=>[18,"mp"],"\xD8"=>[77,"mr"],"\xD9"=>[18,"mr"],"\xDA"=>[77,"mu"],"\xDB"=>[18,"mu"],"\xDC"=>[0,"m\x3A"],"\xDD"=>[0,"mB"],"\xDE"=>[0,"mC"],"\xDF"=>[0,"mD"],"\xE0"=>[0,"mE"],"\xE1"=>[0,"mF"],"\xE2"=>[0,"mG"],"\xE3"=>[0,"mH"],"\xE4"=>[0,"mI"],"\xE5"=>[0,"mJ"],"\xE6"=>[0,"mK"],"\xE7"=>[0,"mL"],"\xE8"=>[0,"mM"],"\xE9"=>[0,"mN"],"\xEA"=>[0,"mO"],"\xEB"=>[0,"mP"],"\xEC"=>[0,"mQ"],"\xED"=>[0,"mR"],"\xEE"=>[0,"mS"],"\xEF"=>[0,"mT"],"\xF0"=>[0,"mU"],"\xF1"=>[0,"mV"],"\xF2"=>[0,"mW"],"\xF3"=>[0,"mY"],"\xF4"=>[0,"mj"],"\xF5"=>[0,"mk"],"\xF6"=>[0,"mq"],"\xF7"=>[0,"mv"],"\xF8"=>[0,"mw"],"\xF9"=>[0,"mx"],"\xFA"=>[0,"my"],"\xFB"=>[0,"mz"],"\xFC"=>[82,"m"],"\xFD"=>[87,"m"],"\xFE"=>[130,"m"],"\xFF"=>[9,"m"],],["\x00"=>[77,"l0"],"\x01"=>[18,"l0"],"\x02"=>[77,"l1"],"\x03"=>[18,"l1"],"\x04"=>[77,"l2"],"\x05"=>[18,"l2"],"\x06"=>[77,"la"],"\x07"=>[18,"la"],"\x08"=>[77,"lc"],"\x09"=>[18,"lc"],"\x0A"=>[77,"le"],"\x0B"=>[18,"le"],"\x0C"=>[77,"li"],"\x0D"=>[18,"li"],"\x0E"=>[77,"lo"],"\x0F"=>[18,"lo"],"\x10"=>[77,"ls"],"\x11"=>[18,"ls"],"\x12"=>[77,"lt"],"\x13"=>[18,"lt"],"\x14"=>[0,"l\x20"],"\x15"=>[0,"l\x25"],"\x16"=>[0,"l-"],"\x17"=>[0,"l."],"\x18"=>[0,"l\x2F"],"\x19"=>[0,"l3"],"\x1A"=>[0,"l4"],"\x1B"=>[0,"l5"],"\x1C"=>[0,"l6"],"\x1D"=>[0,"l7"],"\x1E"=>[0,"l8"],"\x1F"=>[0,"l9"],"\x20"=>[0,"l\x3D"],"\x21"=>[0,"lA"],"\x22"=>[0,"l_"],"\x23"=>[0,"lb"],"\x24"=>[0,"ld"],"\x25"=>[0,"lf"],"\x26"=>[0,"lg"],"\x27"=>[0,"lh"],"\x28"=>[0,"ll"],"\x29"=>[0,"lm"],"\x2A"=>[0,"ln"],"\x2B"=>[0,"lp"],"\x2C"=>[0,"lr"],"-"=>[0,"lu"],"."=>[100,"l"],"\x2F"=>[110,"l"],[111,"l"],[115,"l"],[116,"l"],[118,"l"],[119,"l"],[122,"l"],[123,"l"],[125,"l"],[126,"l"],[129,"l"],"\x3A"=>[143,"l"],"\x3B"=>[148,"l"],"\x3C"=>[151,"l"],"\x3D"=>[153,"l"],"\x3E"=>[83,"l"],"\x3F"=>[10,"l"],"\x40"=>[77,"m0"],"A"=>[18,"m0"],"B"=>[77,"m1"],"C"=>[18,"m1"],"D"=>[77,"m2"],"E"=>[18,"m2"],"F"=>[77,"ma"],"G"=>[18,"ma"],"H"=>[77,"mc"],"I"=>[18,"mc"],"J"=>[77,"me"],"K"=>[18,"me"],"L"=>[77,"mi"],"M"=>[18,"mi"],"N"=>[77,"mo"],"O"=>[18,"mo"],"P"=>[77,"ms"],"Q"=>[18,"ms"],"R"=>[77,"mt"],"S"=>[18,"mt"],"T"=>[0,"m\x20"],"U"=>[0,"m\x25"],"V"=>[0,"m-"],"W"=>[0,"m."],"X"=>[0,"m\x2F"],"Y"=>[0,"m3"],"Z"=>[0,"m4"],"\x5B"=>[0,"m5"],"\x5C"=>[0,"m6"],"\x5D"=>[0,"m7"],"\x5E"=>[0,"m8"],"_"=>[0,"m9"],"\x60"=>[0,"m\x3D"],"a"=>[0,"mA"],"b"=>[0,"m_"],"c"=>[0,"mb"],"d"=>[0,"md"],"e"=>[0,"mf"],"f"=>[0,"mg"],"g"=>[0,"mh"],"h"=>[0,"ml"],"i"=>[0,"mm"],"j"=>[0,"mn"],"k"=>[0,"mp"],"l"=>[0,"mr"],"m"=>[0,"mu"],"n"=>[100,"m"],"o"=>[110,"m"],"p"=>[111,"m"],"q"=>[115,"m"],"r"=>[116,"m"],"s"=>[118,"m"],"t"=>[119,"m"],"u"=>[122,"m"],"v"=>[123,"m"],"w"=>[125,"m"],"x"=>[126,"m"],"y"=>[129,"m"],"z"=>[143,"m"],"\x7B"=>[148,"m"],"\x7C"=>[151,"m"],"\x7D"=>[153,"m"],"~"=>[83,"m"],"\x7F"=>[10,"m"],"\x80"=>[77,"n0"],"\x81"=>[18,"n0"],"\x82"=>[77,"n1"],"\x83"=>[18,"n1"],"\x84"=>[77,"n2"],"\x85"=>[18,"n2"],"\x86"=>[77,"na"],"\x87"=>[18,"na"],"\x88"=>[77,"nc"],"\x89"=>[18,"nc"],"\x8A"=>[77,"ne"],"\x8B"=>[18,"ne"],"\x8C"=>[77,"ni"],"\x8D"=>[18,"ni"],"\x8E"=>[77,"no"],"\x8F"=>[18,"no"],"\x90"=>[77,"ns"],"\x91"=>[18,"ns"],"\x92"=>[77,"nt"],"\x93"=>[18,"nt"],"\x94"=>[0,"n\x20"],"\x95"=>[0,"n\x25"],"\x96"=>[0,"n-"],"\x97"=>[0,"n."],"\x98"=>[0,"n\x2F"],"\x99"=>[0,"n3"],"\x9A"=>[0,"n4"],"\x9B"=>[0,"n5"],"\x9C"=>[0,"n6"],"\x9D"=>[0,"n7"],"\x9E"=>[0,"n8"],"\x9F"=>[0,"n9"],"\xA0"=>[0,"n\x3D"],"\xA1"=>[0,"nA"],"\xA2"=>[0,"n_"],"\xA3"=>[0,"nb"],"\xA4"=>[0,"nd"],"\xA5"=>[0,"nf"],"\xA6"=>[0,"ng"],"\xA7"=>[0,"nh"],"\xA8"=>[0,"nl"],"\xA9"=>[0,"nm"],"\xAA"=>[0,"nn"],"\xAB"=>[0,"np"],"\xAC"=>[0,"nr"],"\xAD"=>[0,"nu"],"\xAE"=>[100,"n"],"\xAF"=>[110,"n"],"\xB0"=>[111,"n"],"\xB1"=>[115,"n"],"\xB2"=>[116,"n"],"\xB3"=>[118,"n"],"\xB4"=>[119,"n"],"\xB5"=>[122,"n"],"\xB6"=>[123,"n"],"\xB7"=>[125,"n"],"\xB8"=>[126,"n"],"\xB9"=>[129,"n"],"\xBA"=>[143,"n"],"\xBB"=>[148,"n"],"\xBC"=>[151,"n"],"\xBD"=>[153,"n"],"\xBE"=>[83,"n"],"\xBF"=>[10,"n"],"\xC0"=>[77,"p0"],"\xC1"=>[18,"p0"],"\xC2"=>[77,"p1"],"\xC3"=>[18,"p1"],"\xC4"=>[77,"p2"],"\xC5"=>[18,"p2"],"\xC6"=>[77,"pa"],"\xC7"=>[18,"pa"],"\xC8"=>[77,"pc"],"\xC9"=>[18,"pc"],"\xCA"=>[77,"pe"],"\xCB"=>[18,"pe"],"\xCC"=>[77,"pi"],"\xCD"=>[18,"pi"],"\xCE"=>[77,"po"],"\xCF"=>[18,"po"],"\xD0"=>[77,"ps"],"\xD1"=>[18,"ps"],"\xD2"=>[77,"pt"],"\xD3"=>[18,"pt"],"\xD4"=>[0,"p\x20"],"\xD5"=>[0,"p\x25"],"\xD6"=>[0,"p-"],"\xD7"=>[0,"p."],"\xD8"=>[0,"p\x2F"],"\xD9"=>[0,"p3"],"\xDA"=>[0,"p4"],"\xDB"=>[0,"p5"],"\xDC"=>[0,"p6"],"\xDD"=>[0,"p7"],"\xDE"=>[0,"p8"],"\xDF"=>[0,"p9"],"\xE0"=>[0,"p\x3D"],"\xE1"=>[0,"pA"],"\xE2"=>[0,"p_"],"\xE3"=>[0,"pb"],"\xE4"=>[0,"pd"],"\xE5"=>[0,"pf"],"\xE6"=>[0,"pg"],"\xE7"=>[0,"ph"],"\xE8"=>[0,"pl"],"\xE9"=>[0,"pm"],"\xEA"=>[0,"pn"],"\xEB"=>[0,"pp"],"\xEC"=>[0,"pr"],"\xED"=>[0,"pu"],"\xEE"=>[100,"p"],"\xEF"=>[110,"p"],"\xF0"=>[111,"p"],"\xF1"=>[115,"p"],"\xF2"=>[116,"p"],"\xF3"=>[118,"p"],"\xF4"=>[119,"p"],"\xF5"=>[122,"p"],"\xF6"=>[123,"p"],"\xF7"=>[125,"p"],"\xF8"=>[126,"p"],"\xF9"=>[129,"p"],"\xFA"=>[143,"p"],"\xFB"=>[148,"p"],"\xFC"=>[151,"p"],"\xFD"=>[153,"p"],"\xFE"=>[83,"p"],"\xFF"=>[10,"p"],],["\x00"=>[94,"n0"],"\x01"=>[76,"n0"],"\x02"=>[104,"n0"],"\x03"=>[16,"n0"],"\x04"=>[94,"n1"],"\x05"=>[76,"n1"],"\x06"=>[104,"n1"],"\x07"=>[16,"n1"],"\x08"=>[94,"n2"],"\x09"=>[76,"n2"],"\x0A"=>[104,"n2"],"\x0B"=>[16,"n2"],"\x0C"=>[94,"na"],"\x0D"=>[76,"na"],"\x0E"=>[104,"na"],"\x0F"=>[16,"na"],"\x10"=>[94,"nc"],"\x11"=>[76,"nc"],"\x12"=>[104,"nc"],"\x13"=>[16,"nc"],"\x14"=>[94,"ne"],"\x15"=>[76,"ne"],"\x16"=>[104,"ne"],"\x17"=>[16,"ne"],"\x18"=>[94,"ni"],"\x19"=>[76,"ni"],"\x1A"=>[104,"ni"],"\x1B"=>[16,"ni"],"\x1C"=>[94,"no"],"\x1D"=>[76,"no"],"\x1E"=>[104,"no"],"\x1F"=>[16,"no"],"\x20"=>[94,"ns"],"\x21"=>[76,"ns"],"\x22"=>[104,"ns"],"\x23"=>[16,"ns"],"\x24"=>[94,"nt"],"\x25"=>[76,"nt"],"\x26"=>[104,"nt"],"\x27"=>[16,"nt"],"\x28"=>[77,"n\x20"],"\x29"=>[18,"n\x20"],"\x2A"=>[77,"n\x25"],"\x2B"=>[18,"n\x25"],"\x2C"=>[77,"n-"],"-"=>[18,"n-"],"."=>[77,"n."],"\x2F"=>[18,"n."],[77,"n\x2F"],[18,"n\x2F"],[77,"n3"],[18,"n3"],[77,"n4"],[18,"n4"],[77,"n5"],[18,"n5"],[77,"n6"],[18,"n6"],"\x3A"=>[77,"n7"],"\x3B"=>[18,"n7"],"\x3C"=>[77,"n8"],"\x3D"=>[18,"n8"],"\x3E"=>[77,"n9"],"\x3F"=>[18,"n9"],"\x40"=>[77,"n\x3D"],"A"=>[18,"n\x3D"],"B"=>[77,"nA"],"C"=>[18,"nA"],"D"=>[77,"n_"],"E"=>[18,"n_"],"F"=>[77,"nb"],"G"=>[18,"nb"],"H"=>[77,"nd"],"I"=>[18,"nd"],"J"=>[77,"nf"],"K"=>[18,"nf"],"L"=>[77,"ng"],"M"=>[18,"ng"],"N"=>[77,"nh"],"O"=>[18,"nh"],"P"=>[77,"nl"],"Q"=>[18,"nl"],"R"=>[77,"nm"],"S"=>[18,"nm"],"T"=>[77,"nn"],"U"=>[18,"nn"],"V"=>[77,"np"],"W"=>[18,"np"],"X"=>[77,"nr"],"Y"=>[18,"nr"],"Z"=>[77,"nu"],"\x5B"=>[18,"nu"],"\x5C"=>[0,"n\x3A"],"\x5D"=>[0,"nB"],"\x5E"=>[0,"nC"],"_"=>[0,"nD"],"\x60"=>[0,"nE"],"a"=>[0,"nF"],"b"=>[0,"nG"],"c"=>[0,"nH"],"d"=>[0,"nI"],"e"=>[0,"nJ"],"f"=>[0,"nK"],"g"=>[0,"nL"],"h"=>[0,"nM"],"i"=>[0,"nN"],"j"=>[0,"nO"],"k"=>[0,"nP"],"l"=>[0,"nQ"],"m"=>[0,"nR"],"n"=>[0,"nS"],"o"=>[0,"nT"],"p"=>[0,"nU"],"q"=>[0,"nV"],"r"=>[0,"nW"],"s"=>[0,"nY"],"t"=>[0,"nj"],"u"=>[0,"nk"],"v"=>[0,"nq"],"w"=>[0,"nv"],"x"=>[0,"nw"],"y"=>[0,"nx"],"z"=>[0,"ny"],"\x7B"=>[0,"nz"],"\x7C"=>[82,"n"],"\x7D"=>[87,"n"],"~"=>[130,"n"],"\x7F"=>[9,"n"],"\x80"=>[94,"p0"],"\x81"=>[76,"p0"],"\x82"=>[104,"p0"],"\x83"=>[16,"p0"],"\x84"=>[94,"p1"],"\x85"=>[76,"p1"],"\x86"=>[104,"p1"],"\x87"=>[16,"p1"],"\x88"=>[94,"p2"],"\x89"=>[76,"p2"],"\x8A"=>[104,"p2"],"\x8B"=>[16,"p2"],"\x8C"=>[94,"pa"],"\x8D"=>[76,"pa"],"\x8E"=>[104,"pa"],"\x8F"=>[16,"pa"],"\x90"=>[94,"pc"],"\x91"=>[76,"pc"],"\x92"=>[104,"pc"],"\x93"=>[16,"pc"],"\x94"=>[94,"pe"],"\x95"=>[76,"pe"],"\x96"=>[104,"pe"],"\x97"=>[16,"pe"],"\x98"=>[94,"pi"],"\x99"=>[76,"pi"],"\x9A"=>[104,"pi"],"\x9B"=>[16,"pi"],"\x9C"=>[94,"po"],"\x9D"=>[76,"po"],"\x9E"=>[104,"po"],"\x9F"=>[16,"po"],"\xA0"=>[94,"ps"],"\xA1"=>[76,"ps"],"\xA2"=>[104,"ps"],"\xA3"=>[16,"ps"],"\xA4"=>[94,"pt"],"\xA5"=>[76,"pt"],"\xA6"=>[104,"pt"],"\xA7"=>[16,"pt"],"\xA8"=>[77,"p\x20"],"\xA9"=>[18,"p\x20"],"\xAA"=>[77,"p\x25"],"\xAB"=>[18,"p\x25"],"\xAC"=>[77,"p-"],"\xAD"=>[18,"p-"],"\xAE"=>[77,"p."],"\xAF"=>[18,"p."],"\xB0"=>[77,"p\x2F"],"\xB1"=>[18,"p\x2F"],"\xB2"=>[77,"p3"],"\xB3"=>[18,"p3"],"\xB4"=>[77,"p4"],"\xB5"=>[18,"p4"],"\xB6"=>[77,"p5"],"\xB7"=>[18,"p5"],"\xB8"=>[77,"p6"],"\xB9"=>[18,"p6"],"\xBA"=>[77,"p7"],"\xBB"=>[18,"p7"],"\xBC"=>[77,"p8"],"\xBD"=>[18,"p8"],"\xBE"=>[77,"p9"],"\xBF"=>[18,"p9"],"\xC0"=>[77,"p\x3D"],"\xC1"=>[18,"p\x3D"],"\xC2"=>[77,"pA"],"\xC3"=>[18,"pA"],"\xC4"=>[77,"p_"],"\xC5"=>[18,"p_"],"\xC6"=>[77,"pb"],"\xC7"=>[18,"pb"],"\xC8"=>[77,"pd"],"\xC9"=>[18,"pd"],"\xCA"=>[77,"pf"],"\xCB"=>[18,"pf"],"\xCC"=>[77,"pg"],"\xCD"=>[18,"pg"],"\xCE"=>[77,"ph"],"\xCF"=>[18,"ph"],"\xD0"=>[77,"pl"],"\xD1"=>[18,"pl"],"\xD2"=>[77,"pm"],"\xD3"=>[18,"pm"],"\xD4"=>[77,"pn"],"\xD5"=>[18,"pn"],"\xD6"=>[77,"pp"],"\xD7"=>[18,"pp"],"\xD8"=>[77,"pr"],"\xD9"=>[18,"pr"],"\xDA"=>[77,"pu"],"\xDB"=>[18,"pu"],"\xDC"=>[0,"p\x3A"],"\xDD"=>[0,"pB"],"\xDE"=>[0,"pC"],"\xDF"=>[0,"pD"],"\xE0"=>[0,"pE"],"\xE1"=>[0,"pF"],"\xE2"=>[0,"pG"],"\xE3"=>[0,"pH"],"\xE4"=>[0,"pI"],"\xE5"=>[0,"pJ"],"\xE6"=>[0,"pK"],"\xE7"=>[0,"pL"],"\xE8"=>[0,"pM"],"\xE9"=>[0,"pN"],"\xEA"=>[0,"pO"],"\xEB"=>[0,"pP"],"\xEC"=>[0,"pQ"],"\xED"=>[0,"pR"],"\xEE"=>[0,"pS"],"\xEF"=>[0,"pT"],"\xF0"=>[0,"pU"],"\xF1"=>[0,"pV"],"\xF2"=>[0,"pW"],"\xF3"=>[0,"pY"],"\xF4"=>[0,"pj"],"\xF5"=>[0,"pk"],"\xF6"=>[0,"pq"],"\xF7"=>[0,"pv"],"\xF8"=>[0,"pw"],"\xF9"=>[0,"px"],"\xFA"=>[0,"py"],"\xFB"=>[0,"pz"],"\xFC"=>[82,"p"],"\xFD"=>[87,"p"],"\xFE"=>[130,"p"],"\xFF"=>[9,"p"],],["\x00"=>[94,"q0"],"\x01"=>[76,"q0"],"\x02"=>[104,"q0"],"\x03"=>[16,"q0"],"\x04"=>[94,"q1"],"\x05"=>[76,"q1"],"\x06"=>[104,"q1"],"\x07"=>[16,"q1"],"\x08"=>[94,"q2"],"\x09"=>[76,"q2"],"\x0A"=>[104,"q2"],"\x0B"=>[16,"q2"],"\x0C"=>[94,"qa"],"\x0D"=>[76,"qa"],"\x0E"=>[104,"qa"],"\x0F"=>[16,"qa"],"\x10"=>[94,"qc"],"\x11"=>[76,"qc"],"\x12"=>[104,"qc"],"\x13"=>[16,"qc"],"\x14"=>[94,"qe"],"\x15"=>[76,"qe"],"\x16"=>[104,"qe"],"\x17"=>[16,"qe"],"\x18"=>[94,"qi"],"\x19"=>[76,"qi"],"\x1A"=>[104,"qi"],"\x1B"=>[16,"qi"],"\x1C"=>[94,"qo"],"\x1D"=>[76,"qo"],"\x1E"=>[104,"qo"],"\x1F"=>[16,"qo"],"\x20"=>[94,"qs"],"\x21"=>[76,"qs"],"\x22"=>[104,"qs"],"\x23"=>[16,"qs"],"\x24"=>[94,"qt"],"\x25"=>[76,"qt"],"\x26"=>[104,"qt"],"\x27"=>[16,"qt"],"\x28"=>[77,"q\x20"],"\x29"=>[18,"q\x20"],"\x2A"=>[77,"q\x25"],"\x2B"=>[18,"q\x25"],"\x2C"=>[77,"q-"],"-"=>[18,"q-"],"."=>[77,"q."],"\x2F"=>[18,"q."],[77,"q\x2F"],[18,"q\x2F"],[77,"q3"],[18,"q3"],[77,"q4"],[18,"q4"],[77,"q5"],[18,"q5"],[77,"q6"],[18,"q6"],"\x3A"=>[77,"q7"],"\x3B"=>[18,"q7"],"\x3C"=>[77,"q8"],"\x3D"=>[18,"q8"],"\x3E"=>[77,"q9"],"\x3F"=>[18,"q9"],"\x40"=>[77,"q\x3D"],"A"=>[18,"q\x3D"],"B"=>[77,"qA"],"C"=>[18,"qA"],"D"=>[77,"q_"],"E"=>[18,"q_"],"F"=>[77,"qb"],"G"=>[18,"qb"],"H"=>[77,"qd"],"I"=>[18,"qd"],"J"=>[77,"qf"],"K"=>[18,"qf"],"L"=>[77,"qg"],"M"=>[18,"qg"],"N"=>[77,"qh"],"O"=>[18,"qh"],"P"=>[77,"ql"],"Q"=>[18,"ql"],"R"=>[77,"qm"],"S"=>[18,"qm"],"T"=>[77,"qn"],"U"=>[18,"qn"],"V"=>[77,"qp"],"W"=>[18,"qp"],"X"=>[77,"qr"],"Y"=>[18,"qr"],"Z"=>[77,"qu"],"\x5B"=>[18,"qu"],"\x5C"=>[0,"q\x3A"],"\x5D"=>[0,"qB"],"\x5E"=>[0,"qC"],"_"=>[0,"qD"],"\x60"=>[0,"qE"],"a"=>[0,"qF"],"b"=>[0,"qG"],"c"=>[0,"qH"],"d"=>[0,"qI"],"e"=>[0,"qJ"],"f"=>[0,"qK"],"g"=>[0,"qL"],"h"=>[0,"qM"],"i"=>[0,"qN"],"j"=>[0,"qO"],"k"=>[0,"qP"],"l"=>[0,"qQ"],"m"=>[0,"qR"],"n"=>[0,"qS"],"o"=>[0,"qT"],"p"=>[0,"qU"],"q"=>[0,"qV"],"r"=>[0,"qW"],"s"=>[0,"qY"],"t"=>[0,"qj"],"u"=>[0,"qk"],"v"=>[0,"qq"],"w"=>[0,"qv"],"x"=>[0,"qw"],"y"=>[0,"qx"],"z"=>[0,"qy"],"\x7B"=>[0,"qz"],"\x7C"=>[82,"q"],"\x7D"=>[87,"q"],"~"=>[130,"q"],"\x7F"=>[9,"q"],"\x80"=>[94,"v0"],"\x81"=>[76,"v0"],"\x82"=>[104,"v0"],"\x83"=>[16,"v0"],"\x84"=>[94,"v1"],"\x85"=>[76,"v1"],"\x86"=>[104,"v1"],"\x87"=>[16,"v1"],"\x88"=>[94,"v2"],"\x89"=>[76,"v2"],"\x8A"=>[104,"v2"],"\x8B"=>[16,"v2"],"\x8C"=>[94,"va"],"\x8D"=>[76,"va"],"\x8E"=>[104,"va"],"\x8F"=>[16,"va"],"\x90"=>[94,"vc"],"\x91"=>[76,"vc"],"\x92"=>[104,"vc"],"\x93"=>[16,"vc"],"\x94"=>[94,"ve"],"\x95"=>[76,"ve"],"\x96"=>[104,"ve"],"\x97"=>[16,"ve"],"\x98"=>[94,"vi"],"\x99"=>[76,"vi"],"\x9A"=>[104,"vi"],"\x9B"=>[16,"vi"],"\x9C"=>[94,"vo"],"\x9D"=>[76,"vo"],"\x9E"=>[104,"vo"],"\x9F"=>[16,"vo"],"\xA0"=>[94,"vs"],"\xA1"=>[76,"vs"],"\xA2"=>[104,"vs"],"\xA3"=>[16,"vs"],"\xA4"=>[94,"vt"],"\xA5"=>[76,"vt"],"\xA6"=>[104,"vt"],"\xA7"=>[16,"vt"],"\xA8"=>[77,"v\x20"],"\xA9"=>[18,"v\x20"],"\xAA"=>[77,"v\x25"],"\xAB"=>[18,"v\x25"],"\xAC"=>[77,"v-"],"\xAD"=>[18,"v-"],"\xAE"=>[77,"v."],"\xAF"=>[18,"v."],"\xB0"=>[77,"v\x2F"],"\xB1"=>[18,"v\x2F"],"\xB2"=>[77,"v3"],"\xB3"=>[18,"v3"],"\xB4"=>[77,"v4"],"\xB5"=>[18,"v4"],"\xB6"=>[77,"v5"],"\xB7"=>[18,"v5"],"\xB8"=>[77,"v6"],"\xB9"=>[18,"v6"],"\xBA"=>[77,"v7"],"\xBB"=>[18,"v7"],"\xBC"=>[77,"v8"],"\xBD"=>[18,"v8"],"\xBE"=>[77,"v9"],"\xBF"=>[18,"v9"],"\xC0"=>[77,"v\x3D"],"\xC1"=>[18,"v\x3D"],"\xC2"=>[77,"vA"],"\xC3"=>[18,"vA"],"\xC4"=>[77,"v_"],"\xC5"=>[18,"v_"],"\xC6"=>[77,"vb"],"\xC7"=>[18,"vb"],"\xC8"=>[77,"vd"],"\xC9"=>[18,"vd"],"\xCA"=>[77,"vf"],"\xCB"=>[18,"vf"],"\xCC"=>[77,"vg"],"\xCD"=>[18,"vg"],"\xCE"=>[77,"vh"],"\xCF"=>[18,"vh"],"\xD0"=>[77,"vl"],"\xD1"=>[18,"vl"],"\xD2"=>[77,"vm"],"\xD3"=>[18,"vm"],"\xD4"=>[77,"vn"],"\xD5"=>[18,"vn"],"\xD6"=>[77,"vp"],"\xD7"=>[18,"vp"],"\xD8"=>[77,"vr"],"\xD9"=>[18,"vr"],"\xDA"=>[77,"vu"],"\xDB"=>[18,"vu"],"\xDC"=>[0,"v\x3A"],"\xDD"=>[0,"vB"],"\xDE"=>[0,"vC"],"\xDF"=>[0,"vD"],"\xE0"=>[0,"vE"],"\xE1"=>[0,"vF"],"\xE2"=>[0,"vG"],"\xE3"=>[0,"vH"],"\xE4"=>[0,"vI"],"\xE5"=>[0,"vJ"],"\xE6"=>[0,"vK"],"\xE7"=>[0,"vL"],"\xE8"=>[0,"vM"],"\xE9"=>[0,"vN"],"\xEA"=>[0,"vO"],"\xEB"=>[0,"vP"],"\xEC"=>[0,"vQ"],"\xED"=>[0,"vR"],"\xEE"=>[0,"vS"],"\xEF"=>[0,"vT"],"\xF0"=>[0,"vU"],"\xF1"=>[0,"vV"],"\xF2"=>[0,"vW"],"\xF3"=>[0,"vY"],"\xF4"=>[0,"vj"],"\xF5"=>[0,"vk"],"\xF6"=>[0,"vq"],"\xF7"=>[0,"vv"],"\xF8"=>[0,"vw"],"\xF9"=>[0,"vx"],"\xFA"=>[0,"vy"],"\xFB"=>[0,"vz"],"\xFC"=>[82,"v"],"\xFD"=>[87,"v"],"\xFE"=>[130,"v"],"\xFF"=>[9,"v"],],["\x00"=>[94,"r0"],"\x01"=>[76,"r0"],"\x02"=>[104,"r0"],"\x03"=>[16,"r0"],"\x04"=>[94,"r1"],"\x05"=>[76,"r1"],"\x06"=>[104,"r1"],"\x07"=>[16,"r1"],"\x08"=>[94,"r2"],"\x09"=>[76,"r2"],"\x0A"=>[104,"r2"],"\x0B"=>[16,"r2"],"\x0C"=>[94,"ra"],"\x0D"=>[76,"ra"],"\x0E"=>[104,"ra"],"\x0F"=>[16,"ra"],"\x10"=>[94,"rc"],"\x11"=>[76,"rc"],"\x12"=>[104,"rc"],"\x13"=>[16,"rc"],"\x14"=>[94,"re"],"\x15"=>[76,"re"],"\x16"=>[104,"re"],"\x17"=>[16,"re"],"\x18"=>[94,"ri"],"\x19"=>[76,"ri"],"\x1A"=>[104,"ri"],"\x1B"=>[16,"ri"],"\x1C"=>[94,"ro"],"\x1D"=>[76,"ro"],"\x1E"=>[104,"ro"],"\x1F"=>[16,"ro"],"\x20"=>[94,"rs"],"\x21"=>[76,"rs"],"\x22"=>[104,"rs"],"\x23"=>[16,"rs"],"\x24"=>[94,"rt"],"\x25"=>[76,"rt"],"\x26"=>[104,"rt"],"\x27"=>[16,"rt"],"\x28"=>[77,"r\x20"],"\x29"=>[18,"r\x20"],"\x2A"=>[77,"r\x25"],"\x2B"=>[18,"r\x25"],"\x2C"=>[77,"r-"],"-"=>[18,"r-"],"."=>[77,"r."],"\x2F"=>[18,"r."],[77,"r\x2F"],[18,"r\x2F"],[77,"r3"],[18,"r3"],[77,"r4"],[18,"r4"],[77,"r5"],[18,"r5"],[77,"r6"],[18,"r6"],"\x3A"=>[77,"r7"],"\x3B"=>[18,"r7"],"\x3C"=>[77,"r8"],"\x3D"=>[18,"r8"],"\x3E"=>[77,"r9"],"\x3F"=>[18,"r9"],"\x40"=>[77,"r\x3D"],"A"=>[18,"r\x3D"],"B"=>[77,"rA"],"C"=>[18,"rA"],"D"=>[77,"r_"],"E"=>[18,"r_"],"F"=>[77,"rb"],"G"=>[18,"rb"],"H"=>[77,"rd"],"I"=>[18,"rd"],"J"=>[77,"rf"],"K"=>[18,"rf"],"L"=>[77,"rg"],"M"=>[18,"rg"],"N"=>[77,"rh"],"O"=>[18,"rh"],"P"=>[77,"rl"],"Q"=>[18,"rl"],"R"=>[77,"rm"],"S"=>[18,"rm"],"T"=>[77,"rn"],"U"=>[18,"rn"],"V"=>[77,"rp"],"W"=>[18,"rp"],"X"=>[77,"rr"],"Y"=>[18,"rr"],"Z"=>[77,"ru"],"\x5B"=>[18,"ru"],"\x5C"=>[0,"r\x3A"],"\x5D"=>[0,"rB"],"\x5E"=>[0,"rC"],"_"=>[0,"rD"],"\x60"=>[0,"rE"],"a"=>[0,"rF"],"b"=>[0,"rG"],"c"=>[0,"rH"],"d"=>[0,"rI"],"e"=>[0,"rJ"],"f"=>[0,"rK"],"g"=>[0,"rL"],"h"=>[0,"rM"],"i"=>[0,"rN"],"j"=>[0,"rO"],"k"=>[0,"rP"],"l"=>[0,"rQ"],"m"=>[0,"rR"],"n"=>[0,"rS"],"o"=>[0,"rT"],"p"=>[0,"rU"],"q"=>[0,"rV"],"r"=>[0,"rW"],"s"=>[0,"rY"],"t"=>[0,"rj"],"u"=>[0,"rk"],"v"=>[0,"rq"],"w"=>[0,"rv"],"x"=>[0,"rw"],"y"=>[0,"rx"],"z"=>[0,"ry"],"\x7B"=>[0,"rz"],"\x7C"=>[82,"r"],"\x7D"=>[87,"r"],"~"=>[130,"r"],"\x7F"=>[9,"r"],"\x80"=>[94,"u0"],"\x81"=>[76,"u0"],"\x82"=>[104,"u0"],"\x83"=>[16,"u0"],"\x84"=>[94,"u1"],"\x85"=>[76,"u1"],"\x86"=>[104,"u1"],"\x87"=>[16,"u1"],"\x88"=>[94,"u2"],"\x89"=>[76,"u2"],"\x8A"=>[104,"u2"],"\x8B"=>[16,"u2"],"\x8C"=>[94,"ua"],"\x8D"=>[76,"ua"],"\x8E"=>[104,"ua"],"\x8F"=>[16,"ua"],"\x90"=>[94,"uc"],"\x91"=>[76,"uc"],"\x92"=>[104,"uc"],"\x93"=>[16,"uc"],"\x94"=>[94,"ue"],"\x95"=>[76,"ue"],"\x96"=>[104,"ue"],"\x97"=>[16,"ue"],"\x98"=>[94,"ui"],"\x99"=>[76,"ui"],"\x9A"=>[104,"ui"],"\x9B"=>[16,"ui"],"\x9C"=>[94,"uo"],"\x9D"=>[76,"uo"],"\x9E"=>[104,"uo"],"\x9F"=>[16,"uo"],"\xA0"=>[94,"us"],"\xA1"=>[76,"us"],"\xA2"=>[104,"us"],"\xA3"=>[16,"us"],"\xA4"=>[94,"ut"],"\xA5"=>[76,"ut"],"\xA6"=>[104,"ut"],"\xA7"=>[16,"ut"],"\xA8"=>[77,"u\x20"],"\xA9"=>[18,"u\x20"],"\xAA"=>[77,"u\x25"],"\xAB"=>[18,"u\x25"],"\xAC"=>[77,"u-"],"\xAD"=>[18,"u-"],"\xAE"=>[77,"u."],"\xAF"=>[18,"u."],"\xB0"=>[77,"u\x2F"],"\xB1"=>[18,"u\x2F"],"\xB2"=>[77,"u3"],"\xB3"=>[18,"u3"],"\xB4"=>[77,"u4"],"\xB5"=>[18,"u4"],"\xB6"=>[77,"u5"],"\xB7"=>[18,"u5"],"\xB8"=>[77,"u6"],"\xB9"=>[18,"u6"],"\xBA"=>[77,"u7"],"\xBB"=>[18,"u7"],"\xBC"=>[77,"u8"],"\xBD"=>[18,"u8"],"\xBE"=>[77,"u9"],"\xBF"=>[18,"u9"],"\xC0"=>[77,"u\x3D"],"\xC1"=>[18,"u\x3D"],"\xC2"=>[77,"uA"],"\xC3"=>[18,"uA"],"\xC4"=>[77,"u_"],"\xC5"=>[18,"u_"],"\xC6"=>[77,"ub"],"\xC7"=>[18,"ub"],"\xC8"=>[77,"ud"],"\xC9"=>[18,"ud"],"\xCA"=>[77,"uf"],"\xCB"=>[18,"uf"],"\xCC"=>[77,"ug"],"\xCD"=>[18,"ug"],"\xCE"=>[77,"uh"],"\xCF"=>[18,"uh"],"\xD0"=>[77,"ul"],"\xD1"=>[18,"ul"],"\xD2"=>[77,"um"],"\xD3"=>[18,"um"],"\xD4"=>[77,"un"],"\xD5"=>[18,"un"],"\xD6"=>[77,"up"],"\xD7"=>[18,"up"],"\xD8"=>[77,"ur"],"\xD9"=>[18,"ur"],"\xDA"=>[77,"uu"],"\xDB"=>[18,"uu"],"\xDC"=>[0,"u\x3A"],"\xDD"=>[0,"uB"],"\xDE"=>[0,"uC"],"\xDF"=>[0,"uD"],"\xE0"=>[0,"uE"],"\xE1"=>[0,"uF"],"\xE2"=>[0,"uG"],"\xE3"=>[0,"uH"],"\xE4"=>[0,"uI"],"\xE5"=>[0,"uJ"],"\xE6"=>[0,"uK"],"\xE7"=>[0,"uL"],"\xE8"=>[0,"uM"],"\xE9"=>[0,"uN"],"\xEA"=>[0,"uO"],"\xEB"=>[0,"uP"],"\xEC"=>[0,"uQ"],"\xED"=>[0,"uR"],"\xEE"=>[0,"uS"],"\xEF"=>[0,"uT"],"\xF0"=>[0,"uU"],"\xF1"=>[0,"uV"],"\xF2"=>[0,"uW"],"\xF3"=>[0,"uY"],"\xF4"=>[0,"uj"],"\xF5"=>[0,"uk"],"\xF6"=>[0,"uq"],"\xF7"=>[0,"uv"],"\xF8"=>[0,"uw"],"\xF9"=>[0,"ux"],"\xFA"=>[0,"uy"],"\xFB"=>[0,"uz"],"\xFC"=>[82,"u"],"\xFD"=>[87,"u"],"\xFE"=>[130,"u"],"\xFF"=>[9,"u"],],["\x00"=>[94,"s0"],"\x01"=>[76,"s0"],"\x02"=>[104,"s0"],"\x03"=>[16,"s0"],"\x04"=>[94,"s1"],"\x05"=>[76,"s1"],"\x06"=>[104,"s1"],"\x07"=>[16,"s1"],"\x08"=>[94,"s2"],"\x09"=>[76,"s2"],"\x0A"=>[104,"s2"],"\x0B"=>[16,"s2"],"\x0C"=>[94,"sa"],"\x0D"=>[76,"sa"],"\x0E"=>[104,"sa"],"\x0F"=>[16,"sa"],"\x10"=>[94,"sc"],"\x11"=>[76,"sc"],"\x12"=>[104,"sc"],"\x13"=>[16,"sc"],"\x14"=>[94,"se"],"\x15"=>[76,"se"],"\x16"=>[104,"se"],"\x17"=>[16,"se"],"\x18"=>[94,"si"],"\x19"=>[76,"si"],"\x1A"=>[104,"si"],"\x1B"=>[16,"si"],"\x1C"=>[94,"so"],"\x1D"=>[76,"so"],"\x1E"=>[104,"so"],"\x1F"=>[16,"so"],"\x20"=>[94,"ss"],"\x21"=>[76,"ss"],"\x22"=>[104,"ss"],"\x23"=>[16,"ss"],"\x24"=>[94,"st"],"\x25"=>[76,"st"],"\x26"=>[104,"st"],"\x27"=>[16,"st"],"\x28"=>[77,"s\x20"],"\x29"=>[18,"s\x20"],"\x2A"=>[77,"s\x25"],"\x2B"=>[18,"s\x25"],"\x2C"=>[77,"s-"],"-"=>[18,"s-"],"."=>[77,"s."],"\x2F"=>[18,"s."],[77,"s\x2F"],[18,"s\x2F"],[77,"s3"],[18,"s3"],[77,"s4"],[18,"s4"],[77,"s5"],[18,"s5"],[77,"s6"],[18,"s6"],"\x3A"=>[77,"s7"],"\x3B"=>[18,"s7"],"\x3C"=>[77,"s8"],"\x3D"=>[18,"s8"],"\x3E"=>[77,"s9"],"\x3F"=>[18,"s9"],"\x40"=>[77,"s\x3D"],"A"=>[18,"s\x3D"],"B"=>[77,"sA"],"C"=>[18,"sA"],"D"=>[77,"s_"],"E"=>[18,"s_"],"F"=>[77,"sb"],"G"=>[18,"sb"],"H"=>[77,"sd"],"I"=>[18,"sd"],"J"=>[77,"sf"],"K"=>[18,"sf"],"L"=>[77,"sg"],"M"=>[18,"sg"],"N"=>[77,"sh"],"O"=>[18,"sh"],"P"=>[77,"sl"],"Q"=>[18,"sl"],"R"=>[77,"sm"],"S"=>[18,"sm"],"T"=>[77,"sn"],"U"=>[18,"sn"],"V"=>[77,"sp"],"W"=>[18,"sp"],"X"=>[77,"sr"],"Y"=>[18,"sr"],"Z"=>[77,"su"],"\x5B"=>[18,"su"],"\x5C"=>[0,"s\x3A"],"\x5D"=>[0,"sB"],"\x5E"=>[0,"sC"],"_"=>[0,"sD"],"\x60"=>[0,"sE"],"a"=>[0,"sF"],"b"=>[0,"sG"],"c"=>[0,"sH"],"d"=>[0,"sI"],"e"=>[0,"sJ"],"f"=>[0,"sK"],"g"=>[0,"sL"],"h"=>[0,"sM"],"i"=>[0,"sN"],"j"=>[0,"sO"],"k"=>[0,"sP"],"l"=>[0,"sQ"],"m"=>[0,"sR"],"n"=>[0,"sS"],"o"=>[0,"sT"],"p"=>[0,"sU"],"q"=>[0,"sV"],"r"=>[0,"sW"],"s"=>[0,"sY"],"t"=>[0,"sj"],"u"=>[0,"sk"],"v"=>[0,"sq"],"w"=>[0,"sv"],"x"=>[0,"sw"],"y"=>[0,"sx"],"z"=>[0,"sy"],"\x7B"=>[0,"sz"],"\x7C"=>[82,"s"],"\x7D"=>[87,"s"],"~"=>[130,"s"],"\x7F"=>[9,"s"],"\x80"=>[94,"t0"],"\x81"=>[76,"t0"],"\x82"=>[104,"t0"],"\x83"=>[16,"t0"],"\x84"=>[94,"t1"],"\x85"=>[76,"t1"],"\x86"=>[104,"t1"],"\x87"=>[16,"t1"],"\x88"=>[94,"t2"],"\x89"=>[76,"t2"],"\x8A"=>[104,"t2"],"\x8B"=>[16,"t2"],"\x8C"=>[94,"ta"],"\x8D"=>[76,"ta"],"\x8E"=>[104,"ta"],"\x8F"=>[16,"ta"],"\x90"=>[94,"tc"],"\x91"=>[76,"tc"],"\x92"=>[104,"tc"],"\x93"=>[16,"tc"],"\x94"=>[94,"te"],"\x95"=>[76,"te"],"\x96"=>[104,"te"],"\x97"=>[16,"te"],"\x98"=>[94,"ti"],"\x99"=>[76,"ti"],"\x9A"=>[104,"ti"],"\x9B"=>[16,"ti"],"\x9C"=>[94,"to"],"\x9D"=>[76,"to"],"\x9E"=>[104,"to"],"\x9F"=>[16,"to"],"\xA0"=>[94,"ts"],"\xA1"=>[76,"ts"],"\xA2"=>[104,"ts"],"\xA3"=>[16,"ts"],"\xA4"=>[94,"tt"],"\xA5"=>[76,"tt"],"\xA6"=>[104,"tt"],"\xA7"=>[16,"tt"],"\xA8"=>[77,"t\x20"],"\xA9"=>[18,"t\x20"],"\xAA"=>[77,"t\x25"],"\xAB"=>[18,"t\x25"],"\xAC"=>[77,"t-"],"\xAD"=>[18,"t-"],"\xAE"=>[77,"t."],"\xAF"=>[18,"t."],"\xB0"=>[77,"t\x2F"],"\xB1"=>[18,"t\x2F"],"\xB2"=>[77,"t3"],"\xB3"=>[18,"t3"],"\xB4"=>[77,"t4"],"\xB5"=>[18,"t4"],"\xB6"=>[77,"t5"],"\xB7"=>[18,"t5"],"\xB8"=>[77,"t6"],"\xB9"=>[18,"t6"],"\xBA"=>[77,"t7"],"\xBB"=>[18,"t7"],"\xBC"=>[77,"t8"],"\xBD"=>[18,"t8"],"\xBE"=>[77,"t9"],"\xBF"=>[18,"t9"],"\xC0"=>[77,"t\x3D"],"\xC1"=>[18,"t\x3D"],"\xC2"=>[77,"tA"],"\xC3"=>[18,"tA"],"\xC4"=>[77,"t_"],"\xC5"=>[18,"t_"],"\xC6"=>[77,"tb"],"\xC7"=>[18,"tb"],"\xC8"=>[77,"td"],"\xC9"=>[18,"td"],"\xCA"=>[77,"tf"],"\xCB"=>[18,"tf"],"\xCC"=>[77,"tg"],"\xCD"=>[18,"tg"],"\xCE"=>[77,"th"],"\xCF"=>[18,"th"],"\xD0"=>[77,"tl"],"\xD1"=>[18,"tl"],"\xD2"=>[77,"tm"],"\xD3"=>[18,"tm"],"\xD4"=>[77,"tn"],"\xD5"=>[18,"tn"],"\xD6"=>[77,"tp"],"\xD7"=>[18,"tp"],"\xD8"=>[77,"tr"],"\xD9"=>[18,"tr"],"\xDA"=>[77,"tu"],"\xDB"=>[18,"tu"],"\xDC"=>[0,"t\x3A"],"\xDD"=>[0,"tB"],"\xDE"=>[0,"tC"],"\xDF"=>[0,"tD"],"\xE0"=>[0,"tE"],"\xE1"=>[0,"tF"],"\xE2"=>[0,"tG"],"\xE3"=>[0,"tH"],"\xE4"=>[0,"tI"],"\xE5"=>[0,"tJ"],"\xE6"=>[0,"tK"],"\xE7"=>[0,"tL"],"\xE8"=>[0,"tM"],"\xE9"=>[0,"tN"],"\xEA"=>[0,"tO"],"\xEB"=>[0,"tP"],"\xEC"=>[0,"tQ"],"\xED"=>[0,"tR"],"\xEE"=>[0,"tS"],"\xEF"=>[0,"tT"],"\xF0"=>[0,"tU"],"\xF1"=>[0,"tV"],"\xF2"=>[0,"tW"],"\xF3"=>[0,"tY"],"\xF4"=>[0,"tj"],"\xF5"=>[0,"tk"],"\xF6"=>[0,"tq"],"\xF7"=>[0,"tv"],"\xF8"=>[0,"tw"],"\xF9"=>[0,"tx"],"\xFA"=>[0,"ty"],"\xFB"=>[0,"tz"],"\xFC"=>[82,"t"],"\xFD"=>[87,"t"],"\xFE"=>[130,"t"],"\xFF"=>[9,"t"],],["\x00"=>[94,"w0"],"\x01"=>[76,"w0"],"\x02"=>[104,"w0"],"\x03"=>[16,"w0"],"\x04"=>[94,"w1"],"\x05"=>[76,"w1"],"\x06"=>[104,"w1"],"\x07"=>[16,"w1"],"\x08"=>[94,"w2"],"\x09"=>[76,"w2"],"\x0A"=>[104,"w2"],"\x0B"=>[16,"w2"],"\x0C"=>[94,"wa"],"\x0D"=>[76,"wa"],"\x0E"=>[104,"wa"],"\x0F"=>[16,"wa"],"\x10"=>[94,"wc"],"\x11"=>[76,"wc"],"\x12"=>[104,"wc"],"\x13"=>[16,"wc"],"\x14"=>[94,"we"],"\x15"=>[76,"we"],"\x16"=>[104,"we"],"\x17"=>[16,"we"],"\x18"=>[94,"wi"],"\x19"=>[76,"wi"],"\x1A"=>[104,"wi"],"\x1B"=>[16,"wi"],"\x1C"=>[94,"wo"],"\x1D"=>[76,"wo"],"\x1E"=>[104,"wo"],"\x1F"=>[16,"wo"],"\x20"=>[94,"ws"],"\x21"=>[76,"ws"],"\x22"=>[104,"ws"],"\x23"=>[16,"ws"],"\x24"=>[94,"wt"],"\x25"=>[76,"wt"],"\x26"=>[104,"wt"],"\x27"=>[16,"wt"],"\x28"=>[77,"w\x20"],"\x29"=>[18,"w\x20"],"\x2A"=>[77,"w\x25"],"\x2B"=>[18,"w\x25"],"\x2C"=>[77,"w-"],"-"=>[18,"w-"],"."=>[77,"w."],"\x2F"=>[18,"w."],[77,"w\x2F"],[18,"w\x2F"],[77,"w3"],[18,"w3"],[77,"w4"],[18,"w4"],[77,"w5"],[18,"w5"],[77,"w6"],[18,"w6"],"\x3A"=>[77,"w7"],"\x3B"=>[18,"w7"],"\x3C"=>[77,"w8"],"\x3D"=>[18,"w8"],"\x3E"=>[77,"w9"],"\x3F"=>[18,"w9"],"\x40"=>[77,"w\x3D"],"A"=>[18,"w\x3D"],"B"=>[77,"wA"],"C"=>[18,"wA"],"D"=>[77,"w_"],"E"=>[18,"w_"],"F"=>[77,"wb"],"G"=>[18,"wb"],"H"=>[77,"wd"],"I"=>[18,"wd"],"J"=>[77,"wf"],"K"=>[18,"wf"],"L"=>[77,"wg"],"M"=>[18,"wg"],"N"=>[77,"wh"],"O"=>[18,"wh"],"P"=>[77,"wl"],"Q"=>[18,"wl"],"R"=>[77,"wm"],"S"=>[18,"wm"],"T"=>[77,"wn"],"U"=>[18,"wn"],"V"=>[77,"wp"],"W"=>[18,"wp"],"X"=>[77,"wr"],"Y"=>[18,"wr"],"Z"=>[77,"wu"],"\x5B"=>[18,"wu"],"\x5C"=>[0,"w\x3A"],"\x5D"=>[0,"wB"],"\x5E"=>[0,"wC"],"_"=>[0,"wD"],"\x60"=>[0,"wE"],"a"=>[0,"wF"],"b"=>[0,"wG"],"c"=>[0,"wH"],"d"=>[0,"wI"],"e"=>[0,"wJ"],"f"=>[0,"wK"],"g"=>[0,"wL"],"h"=>[0,"wM"],"i"=>[0,"wN"],"j"=>[0,"wO"],"k"=>[0,"wP"],"l"=>[0,"wQ"],"m"=>[0,"wR"],"n"=>[0,"wS"],"o"=>[0,"wT"],"p"=>[0,"wU"],"q"=>[0,"wV"],"r"=>[0,"wW"],"s"=>[0,"wY"],"t"=>[0,"wj"],"u"=>[0,"wk"],"v"=>[0,"wq"],"w"=>[0,"wv"],"x"=>[0,"ww"],"y"=>[0,"wx"],"z"=>[0,"wy"],"\x7B"=>[0,"wz"],"\x7C"=>[82,"w"],"\x7D"=>[87,"w"],"~"=>[130,"w"],"\x7F"=>[9,"w"],"\x80"=>[94,"x0"],"\x81"=>[76,"x0"],"\x82"=>[104,"x0"],"\x83"=>[16,"x0"],"\x84"=>[94,"x1"],"\x85"=>[76,"x1"],"\x86"=>[104,"x1"],"\x87"=>[16,"x1"],"\x88"=>[94,"x2"],"\x89"=>[76,"x2"],"\x8A"=>[104,"x2"],"\x8B"=>[16,"x2"],"\x8C"=>[94,"xa"],"\x8D"=>[76,"xa"],"\x8E"=>[104,"xa"],"\x8F"=>[16,"xa"],"\x90"=>[94,"xc"],"\x91"=>[76,"xc"],"\x92"=>[104,"xc"],"\x93"=>[16,"xc"],"\x94"=>[94,"xe"],"\x95"=>[76,"xe"],"\x96"=>[104,"xe"],"\x97"=>[16,"xe"],"\x98"=>[94,"xi"],"\x99"=>[76,"xi"],"\x9A"=>[104,"xi"],"\x9B"=>[16,"xi"],"\x9C"=>[94,"xo"],"\x9D"=>[76,"xo"],"\x9E"=>[104,"xo"],"\x9F"=>[16,"xo"],"\xA0"=>[94,"xs"],"\xA1"=>[76,"xs"],"\xA2"=>[104,"xs"],"\xA3"=>[16,"xs"],"\xA4"=>[94,"xt"],"\xA5"=>[76,"xt"],"\xA6"=>[104,"xt"],"\xA7"=>[16,"xt"],"\xA8"=>[77,"x\x20"],"\xA9"=>[18,"x\x20"],"\xAA"=>[77,"x\x25"],"\xAB"=>[18,"x\x25"],"\xAC"=>[77,"x-"],"\xAD"=>[18,"x-"],"\xAE"=>[77,"x."],"\xAF"=>[18,"x."],"\xB0"=>[77,"x\x2F"],"\xB1"=>[18,"x\x2F"],"\xB2"=>[77,"x3"],"\xB3"=>[18,"x3"],"\xB4"=>[77,"x4"],"\xB5"=>[18,"x4"],"\xB6"=>[77,"x5"],"\xB7"=>[18,"x5"],"\xB8"=>[77,"x6"],"\xB9"=>[18,"x6"],"\xBA"=>[77,"x7"],"\xBB"=>[18,"x7"],"\xBC"=>[77,"x8"],"\xBD"=>[18,"x8"],"\xBE"=>[77,"x9"],"\xBF"=>[18,"x9"],"\xC0"=>[77,"x\x3D"],"\xC1"=>[18,"x\x3D"],"\xC2"=>[77,"xA"],"\xC3"=>[18,"xA"],"\xC4"=>[77,"x_"],"\xC5"=>[18,"x_"],"\xC6"=>[77,"xb"],"\xC7"=>[18,"xb"],"\xC8"=>[77,"xd"],"\xC9"=>[18,"xd"],"\xCA"=>[77,"xf"],"\xCB"=>[18,"xf"],"\xCC"=>[77,"xg"],"\xCD"=>[18,"xg"],"\xCE"=>[77,"xh"],"\xCF"=>[18,"xh"],"\xD0"=>[77,"xl"],"\xD1"=>[18,"xl"],"\xD2"=>[77,"xm"],"\xD3"=>[18,"xm"],"\xD4"=>[77,"xn"],"\xD5"=>[18,"xn"],"\xD6"=>[77,"xp"],"\xD7"=>[18,"xp"],"\xD8"=>[77,"xr"],"\xD9"=>[18,"xr"],"\xDA"=>[77,"xu"],"\xDB"=>[18,"xu"],"\xDC"=>[0,"x\x3A"],"\xDD"=>[0,"xB"],"\xDE"=>[0,"xC"],"\xDF"=>[0,"xD"],"\xE0"=>[0,"xE"],"\xE1"=>[0,"xF"],"\xE2"=>[0,"xG"],"\xE3"=>[0,"xH"],"\xE4"=>[0,"xI"],"\xE5"=>[0,"xJ"],"\xE6"=>[0,"xK"],"\xE7"=>[0,"xL"],"\xE8"=>[0,"xM"],"\xE9"=>[0,"xN"],"\xEA"=>[0,"xO"],"\xEB"=>[0,"xP"],"\xEC"=>[0,"xQ"],"\xED"=>[0,"xR"],"\xEE"=>[0,"xS"],"\xEF"=>[0,"xT"],"\xF0"=>[0,"xU"],"\xF1"=>[0,"xV"],"\xF2"=>[0,"xW"],"\xF3"=>[0,"xY"],"\xF4"=>[0,"xj"],"\xF5"=>[0,"xk"],"\xF6"=>[0,"xq"],"\xF7"=>[0,"xv"],"\xF8"=>[0,"xw"],"\xF9"=>[0,"xx"],"\xFA"=>[0,"xy"],"\xFB"=>[0,"xz"],"\xFC"=>[82,"x"],"\xFD"=>[87,"x"],"\xFE"=>[130,"x"],"\xFF"=>[9,"x"],],["\x00"=>[77,"w0"],"\x01"=>[18,"w0"],"\x02"=>[77,"w1"],"\x03"=>[18,"w1"],"\x04"=>[77,"w2"],"\x05"=>[18,"w2"],"\x06"=>[77,"wa"],"\x07"=>[18,"wa"],"\x08"=>[77,"wc"],"\x09"=>[18,"wc"],"\x0A"=>[77,"we"],"\x0B"=>[18,"we"],"\x0C"=>[77,"wi"],"\x0D"=>[18,"wi"],"\x0E"=>[77,"wo"],"\x0F"=>[18,"wo"],"\x10"=>[77,"ws"],"\x11"=>[18,"ws"],"\x12"=>[77,"wt"],"\x13"=>[18,"wt"],"\x14"=>[0,"w\x20"],"\x15"=>[0,"w\x25"],"\x16"=>[0,"w-"],"\x17"=>[0,"w."],"\x18"=>[0,"w\x2F"],"\x19"=>[0,"w3"],"\x1A"=>[0,"w4"],"\x1B"=>[0,"w5"],"\x1C"=>[0,"w6"],"\x1D"=>[0,"w7"],"\x1E"=>[0,"w8"],"\x1F"=>[0,"w9"],"\x20"=>[0,"w\x3D"],"\x21"=>[0,"wA"],"\x22"=>[0,"w_"],"\x23"=>[0,"wb"],"\x24"=>[0,"wd"],"\x25"=>[0,"wf"],"\x26"=>[0,"wg"],"\x27"=>[0,"wh"],"\x28"=>[0,"wl"],"\x29"=>[0,"wm"],"\x2A"=>[0,"wn"],"\x2B"=>[0,"wp"],"\x2C"=>[0,"wr"],"-"=>[0,"wu"],"."=>[100,"w"],"\x2F"=>[110,"w"],[111,"w"],[115,"w"],[116,"w"],[118,"w"],[119,"w"],[122,"w"],[123,"w"],[125,"w"],[126,"w"],[129,"w"],"\x3A"=>[143,"w"],"\x3B"=>[148,"w"],"\x3C"=>[151,"w"],"\x3D"=>[153,"w"],"\x3E"=>[83,"w"],"\x3F"=>[10,"w"],"\x40"=>[77,"x0"],"A"=>[18,"x0"],"B"=>[77,"x1"],"C"=>[18,"x1"],"D"=>[77,"x2"],"E"=>[18,"x2"],"F"=>[77,"xa"],"G"=>[18,"xa"],"H"=>[77,"xc"],"I"=>[18,"xc"],"J"=>[77,"xe"],"K"=>[18,"xe"],"L"=>[77,"xi"],"M"=>[18,"xi"],"N"=>[77,"xo"],"O"=>[18,"xo"],"P"=>[77,"xs"],"Q"=>[18,"xs"],"R"=>[77,"xt"],"S"=>[18,"xt"],"T"=>[0,"x\x20"],"U"=>[0,"x\x25"],"V"=>[0,"x-"],"W"=>[0,"x."],"X"=>[0,"x\x2F"],"Y"=>[0,"x3"],"Z"=>[0,"x4"],"\x5B"=>[0,"x5"],"\x5C"=>[0,"x6"],"\x5D"=>[0,"x7"],"\x5E"=>[0,"x8"],"_"=>[0,"x9"],"\x60"=>[0,"x\x3D"],"a"=>[0,"xA"],"b"=>[0,"x_"],"c"=>[0,"xb"],"d"=>[0,"xd"],"e"=>[0,"xf"],"f"=>[0,"xg"],"g"=>[0,"xh"],"h"=>[0,"xl"],"i"=>[0,"xm"],"j"=>[0,"xn"],"k"=>[0,"xp"],"l"=>[0,"xr"],"m"=>[0,"xu"],"n"=>[100,"x"],"o"=>[110,"x"],"p"=>[111,"x"],"q"=>[115,"x"],"r"=>[116,"x"],"s"=>[118,"x"],"t"=>[119,"x"],"u"=>[122,"x"],"v"=>[123,"x"],"w"=>[125,"x"],"x"=>[126,"x"],"y"=>[129,"x"],"z"=>[143,"x"],"\x7B"=>[148,"x"],"\x7C"=>[151,"x"],"\x7D"=>[153,"x"],"~"=>[83,"x"],"\x7F"=>[10,"x"],"\x80"=>[77,"y0"],"\x81"=>[18,"y0"],"\x82"=>[77,"y1"],"\x83"=>[18,"y1"],"\x84"=>[77,"y2"],"\x85"=>[18,"y2"],"\x86"=>[77,"ya"],"\x87"=>[18,"ya"],"\x88"=>[77,"yc"],"\x89"=>[18,"yc"],"\x8A"=>[77,"ye"],"\x8B"=>[18,"ye"],"\x8C"=>[77,"yi"],"\x8D"=>[18,"yi"],"\x8E"=>[77,"yo"],"\x8F"=>[18,"yo"],"\x90"=>[77,"ys"],"\x91"=>[18,"ys"],"\x92"=>[77,"yt"],"\x93"=>[18,"yt"],"\x94"=>[0,"y\x20"],"\x95"=>[0,"y\x25"],"\x96"=>[0,"y-"],"\x97"=>[0,"y."],"\x98"=>[0,"y\x2F"],"\x99"=>[0,"y3"],"\x9A"=>[0,"y4"],"\x9B"=>[0,"y5"],"\x9C"=>[0,"y6"],"\x9D"=>[0,"y7"],"\x9E"=>[0,"y8"],"\x9F"=>[0,"y9"],"\xA0"=>[0,"y\x3D"],"\xA1"=>[0,"yA"],"\xA2"=>[0,"y_"],"\xA3"=>[0,"yb"],"\xA4"=>[0,"yd"],"\xA5"=>[0,"yf"],"\xA6"=>[0,"yg"],"\xA7"=>[0,"yh"],"\xA8"=>[0,"yl"],"\xA9"=>[0,"ym"],"\xAA"=>[0,"yn"],"\xAB"=>[0,"yp"],"\xAC"=>[0,"yr"],"\xAD"=>[0,"yu"],"\xAE"=>[100,"y"],"\xAF"=>[110,"y"],"\xB0"=>[111,"y"],"\xB1"=>[115,"y"],"\xB2"=>[116,"y"],"\xB3"=>[118,"y"],"\xB4"=>[119,"y"],"\xB5"=>[122,"y"],"\xB6"=>[123,"y"],"\xB7"=>[125,"y"],"\xB8"=>[126,"y"],"\xB9"=>[129,"y"],"\xBA"=>[143,"y"],"\xBB"=>[148,"y"],"\xBC"=>[151,"y"],"\xBD"=>[153,"y"],"\xBE"=>[83,"y"],"\xBF"=>[10,"y"],"\xC0"=>[77,"z0"],"\xC1"=>[18,"z0"],"\xC2"=>[77,"z1"],"\xC3"=>[18,"z1"],"\xC4"=>[77,"z2"],"\xC5"=>[18,"z2"],"\xC6"=>[77,"za"],"\xC7"=>[18,"za"],"\xC8"=>[77,"zc"],"\xC9"=>[18,"zc"],"\xCA"=>[77,"ze"],"\xCB"=>[18,"ze"],"\xCC"=>[77,"zi"],"\xCD"=>[18,"zi"],"\xCE"=>[77,"zo"],"\xCF"=>[18,"zo"],"\xD0"=>[77,"zs"],"\xD1"=>[18,"zs"],"\xD2"=>[77,"zt"],"\xD3"=>[18,"zt"],"\xD4"=>[0,"z\x20"],"\xD5"=>[0,"z\x25"],"\xD6"=>[0,"z-"],"\xD7"=>[0,"z."],"\xD8"=>[0,"z\x2F"],"\xD9"=>[0,"z3"],"\xDA"=>[0,"z4"],"\xDB"=>[0,"z5"],"\xDC"=>[0,"z6"],"\xDD"=>[0,"z7"],"\xDE"=>[0,"z8"],"\xDF"=>[0,"z9"],"\xE0"=>[0,"z\x3D"],"\xE1"=>[0,"zA"],"\xE2"=>[0,"z_"],"\xE3"=>[0,"zb"],"\xE4"=>[0,"zd"],"\xE5"=>[0,"zf"],"\xE6"=>[0,"zg"],"\xE7"=>[0,"zh"],"\xE8"=>[0,"zl"],"\xE9"=>[0,"zm"],"\xEA"=>[0,"zn"],"\xEB"=>[0,"zp"],"\xEC"=>[0,"zr"],"\xED"=>[0,"zu"],"\xEE"=>[100,"z"],"\xEF"=>[110,"z"],"\xF0"=>[111,"z"],"\xF1"=>[115,"z"],"\xF2"=>[116,"z"],"\xF3"=>[118,"z"],"\xF4"=>[119,"z"],"\xF5"=>[122,"z"],"\xF6"=>[123,"z"],"\xF7"=>[125,"z"],"\xF8"=>[126,"z"],"\xF9"=>[129,"z"],"\xFA"=>[143,"z"],"\xFB"=>[148,"z"],"\xFC"=>[151,"z"],"\xFD"=>[153,"z"],"\xFE"=>[83,"z"],"\xFF"=>[10,"z"],],["\x00"=>[94,"y0"],"\x01"=>[76,"y0"],"\x02"=>[104,"y0"],"\x03"=>[16,"y0"],"\x04"=>[94,"y1"],"\x05"=>[76,"y1"],"\x06"=>[104,"y1"],"\x07"=>[16,"y1"],"\x08"=>[94,"y2"],"\x09"=>[76,"y2"],"\x0A"=>[104,"y2"],"\x0B"=>[16,"y2"],"\x0C"=>[94,"ya"],"\x0D"=>[76,"ya"],"\x0E"=>[104,"ya"],"\x0F"=>[16,"ya"],"\x10"=>[94,"yc"],"\x11"=>[76,"yc"],"\x12"=>[104,"yc"],"\x13"=>[16,"yc"],"\x14"=>[94,"ye"],"\x15"=>[76,"ye"],"\x16"=>[104,"ye"],"\x17"=>[16,"ye"],"\x18"=>[94,"yi"],"\x19"=>[76,"yi"],"\x1A"=>[104,"yi"],"\x1B"=>[16,"yi"],"\x1C"=>[94,"yo"],"\x1D"=>[76,"yo"],"\x1E"=>[104,"yo"],"\x1F"=>[16,"yo"],"\x20"=>[94,"ys"],"\x21"=>[76,"ys"],"\x22"=>[104,"ys"],"\x23"=>[16,"ys"],"\x24"=>[94,"yt"],"\x25"=>[76,"yt"],"\x26"=>[104,"yt"],"\x27"=>[16,"yt"],"\x28"=>[77,"y\x20"],"\x29"=>[18,"y\x20"],"\x2A"=>[77,"y\x25"],"\x2B"=>[18,"y\x25"],"\x2C"=>[77,"y-"],"-"=>[18,"y-"],"."=>[77,"y."],"\x2F"=>[18,"y."],[77,"y\x2F"],[18,"y\x2F"],[77,"y3"],[18,"y3"],[77,"y4"],[18,"y4"],[77,"y5"],[18,"y5"],[77,"y6"],[18,"y6"],"\x3A"=>[77,"y7"],"\x3B"=>[18,"y7"],"\x3C"=>[77,"y8"],"\x3D"=>[18,"y8"],"\x3E"=>[77,"y9"],"\x3F"=>[18,"y9"],"\x40"=>[77,"y\x3D"],"A"=>[18,"y\x3D"],"B"=>[77,"yA"],"C"=>[18,"yA"],"D"=>[77,"y_"],"E"=>[18,"y_"],"F"=>[77,"yb"],"G"=>[18,"yb"],"H"=>[77,"yd"],"I"=>[18,"yd"],"J"=>[77,"yf"],"K"=>[18,"yf"],"L"=>[77,"yg"],"M"=>[18,"yg"],"N"=>[77,"yh"],"O"=>[18,"yh"],"P"=>[77,"yl"],"Q"=>[18,"yl"],"R"=>[77,"ym"],"S"=>[18,"ym"],"T"=>[77,"yn"],"U"=>[18,"yn"],"V"=>[77,"yp"],"W"=>[18,"yp"],"X"=>[77,"yr"],"Y"=>[18,"yr"],"Z"=>[77,"yu"],"\x5B"=>[18,"yu"],"\x5C"=>[0,"y\x3A"],"\x5D"=>[0,"yB"],"\x5E"=>[0,"yC"],"_"=>[0,"yD"],"\x60"=>[0,"yE"],"a"=>[0,"yF"],"b"=>[0,"yG"],"c"=>[0,"yH"],"d"=>[0,"yI"],"e"=>[0,"yJ"],"f"=>[0,"yK"],"g"=>[0,"yL"],"h"=>[0,"yM"],"i"=>[0,"yN"],"j"=>[0,"yO"],"k"=>[0,"yP"],"l"=>[0,"yQ"],"m"=>[0,"yR"],"n"=>[0,"yS"],"o"=>[0,"yT"],"p"=>[0,"yU"],"q"=>[0,"yV"],"r"=>[0,"yW"],"s"=>[0,"yY"],"t"=>[0,"yj"],"u"=>[0,"yk"],"v"=>[0,"yq"],"w"=>[0,"yv"],"x"=>[0,"yw"],"y"=>[0,"yx"],"z"=>[0,"yy"],"\x7B"=>[0,"yz"],"\x7C"=>[82,"y"],"\x7D"=>[87,"y"],"~"=>[130,"y"],"\x7F"=>[9,"y"],"\x80"=>[94,"z0"],"\x81"=>[76,"z0"],"\x82"=>[104,"z0"],"\x83"=>[16,"z0"],"\x84"=>[94,"z1"],"\x85"=>[76,"z1"],"\x86"=>[104,"z1"],"\x87"=>[16,"z1"],"\x88"=>[94,"z2"],"\x89"=>[76,"z2"],"\x8A"=>[104,"z2"],"\x8B"=>[16,"z2"],"\x8C"=>[94,"za"],"\x8D"=>[76,"za"],"\x8E"=>[104,"za"],"\x8F"=>[16,"za"],"\x90"=>[94,"zc"],"\x91"=>[76,"zc"],"\x92"=>[104,"zc"],"\x93"=>[16,"zc"],"\x94"=>[94,"ze"],"\x95"=>[76,"ze"],"\x96"=>[104,"ze"],"\x97"=>[16,"ze"],"\x98"=>[94,"zi"],"\x99"=>[76,"zi"],"\x9A"=>[104,"zi"],"\x9B"=>[16,"zi"],"\x9C"=>[94,"zo"],"\x9D"=>[76,"zo"],"\x9E"=>[104,"zo"],"\x9F"=>[16,"zo"],"\xA0"=>[94,"zs"],"\xA1"=>[76,"zs"],"\xA2"=>[104,"zs"],"\xA3"=>[16,"zs"],"\xA4"=>[94,"zt"],"\xA5"=>[76,"zt"],"\xA6"=>[104,"zt"],"\xA7"=>[16,"zt"],"\xA8"=>[77,"z\x20"],"\xA9"=>[18,"z\x20"],"\xAA"=>[77,"z\x25"],"\xAB"=>[18,"z\x25"],"\xAC"=>[77,"z-"],"\xAD"=>[18,"z-"],"\xAE"=>[77,"z."],"\xAF"=>[18,"z."],"\xB0"=>[77,"z\x2F"],"\xB1"=>[18,"z\x2F"],"\xB2"=>[77,"z3"],"\xB3"=>[18,"z3"],"\xB4"=>[77,"z4"],"\xB5"=>[18,"z4"],"\xB6"=>[77,"z5"],"\xB7"=>[18,"z5"],"\xB8"=>[77,"z6"],"\xB9"=>[18,"z6"],"\xBA"=>[77,"z7"],"\xBB"=>[18,"z7"],"\xBC"=>[77,"z8"],"\xBD"=>[18,"z8"],"\xBE"=>[77,"z9"],"\xBF"=>[18,"z9"],"\xC0"=>[77,"z\x3D"],"\xC1"=>[18,"z\x3D"],"\xC2"=>[77,"zA"],"\xC3"=>[18,"zA"],"\xC4"=>[77,"z_"],"\xC5"=>[18,"z_"],"\xC6"=>[77,"zb"],"\xC7"=>[18,"zb"],"\xC8"=>[77,"zd"],"\xC9"=>[18,"zd"],"\xCA"=>[77,"zf"],"\xCB"=>[18,"zf"],"\xCC"=>[77,"zg"],"\xCD"=>[18,"zg"],"\xCE"=>[77,"zh"],"\xCF"=>[18,"zh"],"\xD0"=>[77,"zl"],"\xD1"=>[18,"zl"],"\xD2"=>[77,"zm"],"\xD3"=>[18,"zm"],"\xD4"=>[77,"zn"],"\xD5"=>[18,"zn"],"\xD6"=>[77,"zp"],"\xD7"=>[18,"zp"],"\xD8"=>[77,"zr"],"\xD9"=>[18,"zr"],"\xDA"=>[77,"zu"],"\xDB"=>[18,"zu"],"\xDC"=>[0,"z\x3A"],"\xDD"=>[0,"zB"],"\xDE"=>[0,"zC"],"\xDF"=>[0,"zD"],"\xE0"=>[0,"zE"],"\xE1"=>[0,"zF"],"\xE2"=>[0,"zG"],"\xE3"=>[0,"zH"],"\xE4"=>[0,"zI"],"\xE5"=>[0,"zJ"],"\xE6"=>[0,"zK"],"\xE7"=>[0,"zL"],"\xE8"=>[0,"zM"],"\xE9"=>[0,"zN"],"\xEA"=>[0,"zO"],"\xEB"=>[0,"zP"],"\xEC"=>[0,"zQ"],"\xED"=>[0,"zR"],"\xEE"=>[0,"zS"],"\xEF"=>[0,"zT"],"\xF0"=>[0,"zU"],"\xF1"=>[0,"zV"],"\xF2"=>[0,"zW"],"\xF3"=>[0,"zY"],"\xF4"=>[0,"zj"],"\xF5"=>[0,"zk"],"\xF6"=>[0,"zq"],"\xF7"=>[0,"zv"],"\xF8"=>[0,"zw"],"\xF9"=>[0,"zx"],"\xFA"=>[0,"zy"],"\xFB"=>[0,"zz"],"\xFC"=>[82,"z"],"\xFD"=>[87,"z"],"\xFE"=>[130,"z"],"\xFF"=>[9,"z"],],["\x00"=>[94,"\x7F0"],"\x01"=>[76,"\x7F0"],"\x02"=>[104,"\x7F0"],"\x03"=>[16,"\x7F0"],"\x04"=>[94,"\x7F1"],"\x05"=>[76,"\x7F1"],"\x06"=>[104,"\x7F1"],"\x07"=>[16,"\x7F1"],"\x08"=>[94,"\x7F2"],"\x09"=>[76,"\x7F2"],"\x0A"=>[104,"\x7F2"],"\x0B"=>[16,"\x7F2"],"\x0C"=>[94,"\x7Fa"],"\x0D"=>[76,"\x7Fa"],"\x0E"=>[104,"\x7Fa"],"\x0F"=>[16,"\x7Fa"],"\x10"=>[94,"\x7Fc"],"\x11"=>[76,"\x7Fc"],"\x12"=>[104,"\x7Fc"],"\x13"=>[16,"\x7Fc"],"\x14"=>[94,"\x7Fe"],"\x15"=>[76,"\x7Fe"],"\x16"=>[104,"\x7Fe"],"\x17"=>[16,"\x7Fe"],"\x18"=>[94,"\x7Fi"],"\x19"=>[76,"\x7Fi"],"\x1A"=>[104,"\x7Fi"],"\x1B"=>[16,"\x7Fi"],"\x1C"=>[94,"\x7Fo"],"\x1D"=>[76,"\x7Fo"],"\x1E"=>[104,"\x7Fo"],"\x1F"=>[16,"\x7Fo"],"\x20"=>[94,"\x7Fs"],"\x21"=>[76,"\x7Fs"],"\x22"=>[104,"\x7Fs"],"\x23"=>[16,"\x7Fs"],"\x24"=>[94,"\x7Ft"],"\x25"=>[76,"\x7Ft"],"\x26"=>[104,"\x7Ft"],"\x27"=>[16,"\x7Ft"],"\x28"=>[77,"\x7F\x20"],"\x29"=>[18,"\x7F\x20"],"\x2A"=>[77,"\x7F\x25"],"\x2B"=>[18,"\x7F\x25"],"\x2C"=>[77,"\x7F-"],"-"=>[18,"\x7F-"],"."=>[77,"\x7F."],"\x2F"=>[18,"\x7F."],[77,"\x7F\x2F"],[18,"\x7F\x2F"],[77,"\x7F3"],[18,"\x7F3"],[77,"\x7F4"],[18,"\x7F4"],[77,"\x7F5"],[18,"\x7F5"],[77,"\x7F6"],[18,"\x7F6"],"\x3A"=>[77,"\x7F7"],"\x3B"=>[18,"\x7F7"],"\x3C"=>[77,"\x7F8"],"\x3D"=>[18,"\x7F8"],"\x3E"=>[77,"\x7F9"],"\x3F"=>[18,"\x7F9"],"\x40"=>[77,"\x7F\x3D"],"A"=>[18,"\x7F\x3D"],"B"=>[77,"\x7FA"],"C"=>[18,"\x7FA"],"D"=>[77,"\x7F_"],"E"=>[18,"\x7F_"],"F"=>[77,"\x7Fb"],"G"=>[18,"\x7Fb"],"H"=>[77,"\x7Fd"],"I"=>[18,"\x7Fd"],"J"=>[77,"\x7Ff"],"K"=>[18,"\x7Ff"],"L"=>[77,"\x7Fg"],"M"=>[18,"\x7Fg"],"N"=>[77,"\x7Fh"],"O"=>[18,"\x7Fh"],"P"=>[77,"\x7Fl"],"Q"=>[18,"\x7Fl"],"R"=>[77,"\x7Fm"],"S"=>[18,"\x7Fm"],"T"=>[77,"\x7Fn"],"U"=>[18,"\x7Fn"],"V"=>[77,"\x7Fp"],"W"=>[18,"\x7Fp"],"X"=>[77,"\x7Fr"],"Y"=>[18,"\x7Fr"],"Z"=>[77,"\x7Fu"],"\x5B"=>[18,"\x7Fu"],"\x5C"=>[0,"\x7F\x3A"],"\x5D"=>[0,"\x7FB"],"\x5E"=>[0,"\x7FC"],"_"=>[0,"\x7FD"],"\x60"=>[0,"\x7FE"],"a"=>[0,"\x7FF"],"b"=>[0,"\x7FG"],"c"=>[0,"\x7FH"],"d"=>[0,"\x7FI"],"e"=>[0,"\x7FJ"],"f"=>[0,"\x7FK"],"g"=>[0,"\x7FL"],"h"=>[0,"\x7FM"],"i"=>[0,"\x7FN"],"j"=>[0,"\x7FO"],"k"=>[0,"\x7FP"],"l"=>[0,"\x7FQ"],"m"=>[0,"\x7FR"],"n"=>[0,"\x7FS"],"o"=>[0,"\x7FT"],"p"=>[0,"\x7FU"],"q"=>[0,"\x7FV"],"r"=>[0,"\x7FW"],"s"=>[0,"\x7FY"],"t"=>[0,"\x7Fj"],"u"=>[0,"\x7Fk"],"v"=>[0,"\x7Fq"],"w"=>[0,"\x7Fv"],"x"=>[0,"\x7Fw"],"y"=>[0,"\x7Fx"],"z"=>[0,"\x7Fy"],"\x7B"=>[0,"\x7Fz"],"\x7C"=>[82,"\x7F"],"\x7D"=>[87,"\x7F"],"~"=>[130,"\x7F"],"\x7F"=>[9,"\x7F"],"\x80"=>[94,"\xDC0"],"\x81"=>[76,"\xDC0"],"\x82"=>[104,"\xDC0"],"\x83"=>[16,"\xDC0"],"\x84"=>[94,"\xDC1"],"\x85"=>[76,"\xDC1"],"\x86"=>[104,"\xDC1"],"\x87"=>[16,"\xDC1"],"\x88"=>[94,"\xDC2"],"\x89"=>[76,"\xDC2"],"\x8A"=>[104,"\xDC2"],"\x8B"=>[16,"\xDC2"],"\x8C"=>[94,"\xDCa"],"\x8D"=>[76,"\xDCa"],"\x8E"=>[104,"\xDCa"],"\x8F"=>[16,"\xDCa"],"\x90"=>[94,"\xDCc"],"\x91"=>[76,"\xDCc"],"\x92"=>[104,"\xDCc"],"\x93"=>[16,"\xDCc"],"\x94"=>[94,"\xDCe"],"\x95"=>[76,"\xDCe"],"\x96"=>[104,"\xDCe"],"\x97"=>[16,"\xDCe"],"\x98"=>[94,"\xDCi"],"\x99"=>[76,"\xDCi"],"\x9A"=>[104,"\xDCi"],"\x9B"=>[16,"\xDCi"],"\x9C"=>[94,"\xDCo"],"\x9D"=>[76,"\xDCo"],"\x9E"=>[104,"\xDCo"],"\x9F"=>[16,"\xDCo"],"\xA0"=>[94,"\xDCs"],"\xA1"=>[76,"\xDCs"],"\xA2"=>[104,"\xDCs"],"\xA3"=>[16,"\xDCs"],"\xA4"=>[94,"\xDCt"],"\xA5"=>[76,"\xDCt"],"\xA6"=>[104,"\xDCt"],"\xA7"=>[16,"\xDCt"],"\xA8"=>[77,"\xDC\x20"],"\xA9"=>[18,"\xDC\x20"],"\xAA"=>[77,"\xDC\x25"],"\xAB"=>[18,"\xDC\x25"],"\xAC"=>[77,"\xDC-"],"\xAD"=>[18,"\xDC-"],"\xAE"=>[77,"\xDC."],"\xAF"=>[18,"\xDC."],"\xB0"=>[77,"\xDC\x2F"],"\xB1"=>[18,"\xDC\x2F"],"\xB2"=>[77,"\xDC3"],"\xB3"=>[18,"\xDC3"],"\xB4"=>[77,"\xDC4"],"\xB5"=>[18,"\xDC4"],"\xB6"=>[77,"\xDC5"],"\xB7"=>[18,"\xDC5"],"\xB8"=>[77,"\xDC6"],"\xB9"=>[18,"\xDC6"],"\xBA"=>[77,"\xDC7"],"\xBB"=>[18,"\xDC7"],"\xBC"=>[77,"\xDC8"],"\xBD"=>[18,"\xDC8"],"\xBE"=>[77,"\xDC9"],"\xBF"=>[18,"\xDC9"],"\xC0"=>[77,"\xDC\x3D"],"\xC1"=>[18,"\xDC\x3D"],"\xC2"=>[77,"\xDCA"],"\xC3"=>[18,"\xDCA"],"\xC4"=>[77,"\xDC_"],"\xC5"=>[18,"\xDC_"],"\xC6"=>[77,"\xDCb"],"\xC7"=>[18,"\xDCb"],"\xC8"=>[77,"\xDCd"],"\xC9"=>[18,"\xDCd"],"\xCA"=>[77,"\xDCf"],"\xCB"=>[18,"\xDCf"],"\xCC"=>[77,"\xDCg"],"\xCD"=>[18,"\xDCg"],"\xCE"=>[77,"\xDCh"],"\xCF"=>[18,"\xDCh"],"\xD0"=>[77,"\xDCl"],"\xD1"=>[18,"\xDCl"],"\xD2"=>[77,"\xDCm"],"\xD3"=>[18,"\xDCm"],"\xD4"=>[77,"\xDCn"],"\xD5"=>[18,"\xDCn"],"\xD6"=>[77,"\xDCp"],"\xD7"=>[18,"\xDCp"],"\xD8"=>[77,"\xDCr"],"\xD9"=>[18,"\xDCr"],"\xDA"=>[77,"\xDCu"],"\xDB"=>[18,"\xDCu"],"\xDC"=>[0,"\xDC\x3A"],"\xDD"=>[0,"\xDCB"],"\xDE"=>[0,"\xDCC"],"\xDF"=>[0,"\xDCD"],"\xE0"=>[0,"\xDCE"],"\xE1"=>[0,"\xDCF"],"\xE2"=>[0,"\xDCG"],"\xE3"=>[0,"\xDCH"],"\xE4"=>[0,"\xDCI"],"\xE5"=>[0,"\xDCJ"],"\xE6"=>[0,"\xDCK"],"\xE7"=>[0,"\xDCL"],"\xE8"=>[0,"\xDCM"],"\xE9"=>[0,"\xDCN"],"\xEA"=>[0,"\xDCO"],"\xEB"=>[0,"\xDCP"],"\xEC"=>[0,"\xDCQ"],"\xED"=>[0,"\xDCR"],"\xEE"=>[0,"\xDCS"],"\xEF"=>[0,"\xDCT"],"\xF0"=>[0,"\xDCU"],"\xF1"=>[0,"\xDCV"],"\xF2"=>[0,"\xDCW"],"\xF3"=>[0,"\xDCY"],"\xF4"=>[0,"\xDCj"],"\xF5"=>[0,"\xDCk"],"\xF6"=>[0,"\xDCq"],"\xF7"=>[0,"\xDCv"],"\xF8"=>[0,"\xDCw"],"\xF9"=>[0,"\xDCx"],"\xFA"=>[0,"\xDCy"],"\xFB"=>[0,"\xDCz"],"\xFC"=>[82,"\xDC"],"\xFD"=>[87,"\xDC"],"\xFE"=>[130,"\xDC"],"\xFF"=>[9,"\xDC"],],["\x00"=>[94,"\x800"],"\x01"=>[76,"\x800"],"\x02"=>[104,"\x800"],"\x03"=>[16,"\x800"],"\x04"=>[94,"\x801"],"\x05"=>[76,"\x801"],"\x06"=>[104,"\x801"],"\x07"=>[16,"\x801"],"\x08"=>[94,"\x802"],"\x09"=>[76,"\x802"],"\x0A"=>[104,"\x802"],"\x0B"=>[16,"\x802"],"\x0C"=>[94,"\x80a"],"\x0D"=>[76,"\x80a"],"\x0E"=>[104,"\x80a"],"\x0F"=>[16,"\x80a"],"\x10"=>[94,"\x80c"],"\x11"=>[76,"\x80c"],"\x12"=>[104,"\x80c"],"\x13"=>[16,"\x80c"],"\x14"=>[94,"\x80e"],"\x15"=>[76,"\x80e"],"\x16"=>[104,"\x80e"],"\x17"=>[16,"\x80e"],"\x18"=>[94,"\x80i"],"\x19"=>[76,"\x80i"],"\x1A"=>[104,"\x80i"],"\x1B"=>[16,"\x80i"],"\x1C"=>[94,"\x80o"],"\x1D"=>[76,"\x80o"],"\x1E"=>[104,"\x80o"],"\x1F"=>[16,"\x80o"],"\x20"=>[94,"\x80s"],"\x21"=>[76,"\x80s"],"\x22"=>[104,"\x80s"],"\x23"=>[16,"\x80s"],"\x24"=>[94,"\x80t"],"\x25"=>[76,"\x80t"],"\x26"=>[104,"\x80t"],"\x27"=>[16,"\x80t"],"\x28"=>[77,"\x80\x20"],"\x29"=>[18,"\x80\x20"],"\x2A"=>[77,"\x80\x25"],"\x2B"=>[18,"\x80\x25"],"\x2C"=>[77,"\x80-"],"-"=>[18,"\x80-"],"."=>[77,"\x80."],"\x2F"=>[18,"\x80."],[77,"\x80\x2F"],[18,"\x80\x2F"],[77,"\x803"],[18,"\x803"],[77,"\x804"],[18,"\x804"],[77,"\x805"],[18,"\x805"],[77,"\x806"],[18,"\x806"],"\x3A"=>[77,"\x807"],"\x3B"=>[18,"\x807"],"\x3C"=>[77,"\x808"],"\x3D"=>[18,"\x808"],"\x3E"=>[77,"\x809"],"\x3F"=>[18,"\x809"],"\x40"=>[77,"\x80\x3D"],"A"=>[18,"\x80\x3D"],"B"=>[77,"\x80A"],"C"=>[18,"\x80A"],"D"=>[77,"\x80_"],"E"=>[18,"\x80_"],"F"=>[77,"\x80b"],"G"=>[18,"\x80b"],"H"=>[77,"\x80d"],"I"=>[18,"\x80d"],"J"=>[77,"\x80f"],"K"=>[18,"\x80f"],"L"=>[77,"\x80g"],"M"=>[18,"\x80g"],"N"=>[77,"\x80h"],"O"=>[18,"\x80h"],"P"=>[77,"\x80l"],"Q"=>[18,"\x80l"],"R"=>[77,"\x80m"],"S"=>[18,"\x80m"],"T"=>[77,"\x80n"],"U"=>[18,"\x80n"],"V"=>[77,"\x80p"],"W"=>[18,"\x80p"],"X"=>[77,"\x80r"],"Y"=>[18,"\x80r"],"Z"=>[77,"\x80u"],"\x5B"=>[18,"\x80u"],"\x5C"=>[0,"\x80\x3A"],"\x5D"=>[0,"\x80B"],"\x5E"=>[0,"\x80C"],"_"=>[0,"\x80D"],"\x60"=>[0,"\x80E"],"a"=>[0,"\x80F"],"b"=>[0,"\x80G"],"c"=>[0,"\x80H"],"d"=>[0,"\x80I"],"e"=>[0,"\x80J"],"f"=>[0,"\x80K"],"g"=>[0,"\x80L"],"h"=>[0,"\x80M"],"i"=>[0,"\x80N"],"j"=>[0,"\x80O"],"k"=>[0,"\x80P"],"l"=>[0,"\x80Q"],"m"=>[0,"\x80R"],"n"=>[0,"\x80S"],"o"=>[0,"\x80T"],"p"=>[0,"\x80U"],"q"=>[0,"\x80V"],"r"=>[0,"\x80W"],"s"=>[0,"\x80Y"],"t"=>[0,"\x80j"],"u"=>[0,"\x80k"],"v"=>[0,"\x80q"],"w"=>[0,"\x80v"],"x"=>[0,"\x80w"],"y"=>[0,"\x80x"],"z"=>[0,"\x80y"],"\x7B"=>[0,"\x80z"],"\x7C"=>[82,"\x80"],"\x7D"=>[87,"\x80"],"~"=>[130,"\x80"],"\x7F"=>[9,"\x80"],"\x80"=>[94,"\x820"],"\x81"=>[76,"\x820"],"\x82"=>[104,"\x820"],"\x83"=>[16,"\x820"],"\x84"=>[94,"\x821"],"\x85"=>[76,"\x821"],"\x86"=>[104,"\x821"],"\x87"=>[16,"\x821"],"\x88"=>[94,"\x822"],"\x89"=>[76,"\x822"],"\x8A"=>[104,"\x822"],"\x8B"=>[16,"\x822"],"\x8C"=>[94,"\x82a"],"\x8D"=>[76,"\x82a"],"\x8E"=>[104,"\x82a"],"\x8F"=>[16,"\x82a"],"\x90"=>[94,"\x82c"],"\x91"=>[76,"\x82c"],"\x92"=>[104,"\x82c"],"\x93"=>[16,"\x82c"],"\x94"=>[94,"\x82e"],"\x95"=>[76,"\x82e"],"\x96"=>[104,"\x82e"],"\x97"=>[16,"\x82e"],"\x98"=>[94,"\x82i"],"\x99"=>[76,"\x82i"],"\x9A"=>[104,"\x82i"],"\x9B"=>[16,"\x82i"],"\x9C"=>[94,"\x82o"],"\x9D"=>[76,"\x82o"],"\x9E"=>[104,"\x82o"],"\x9F"=>[16,"\x82o"],"\xA0"=>[94,"\x82s"],"\xA1"=>[76,"\x82s"],"\xA2"=>[104,"\x82s"],"\xA3"=>[16,"\x82s"],"\xA4"=>[94,"\x82t"],"\xA5"=>[76,"\x82t"],"\xA6"=>[104,"\x82t"],"\xA7"=>[16,"\x82t"],"\xA8"=>[77,"\x82\x20"],"\xA9"=>[18,"\x82\x20"],"\xAA"=>[77,"\x82\x25"],"\xAB"=>[18,"\x82\x25"],"\xAC"=>[77,"\x82-"],"\xAD"=>[18,"\x82-"],"\xAE"=>[77,"\x82."],"\xAF"=>[18,"\x82."],"\xB0"=>[77,"\x82\x2F"],"\xB1"=>[18,"\x82\x2F"],"\xB2"=>[77,"\x823"],"\xB3"=>[18,"\x823"],"\xB4"=>[77,"\x824"],"\xB5"=>[18,"\x824"],"\xB6"=>[77,"\x825"],"\xB7"=>[18,"\x825"],"\xB8"=>[77,"\x826"],"\xB9"=>[18,"\x826"],"\xBA"=>[77,"\x827"],"\xBB"=>[18,"\x827"],"\xBC"=>[77,"\x828"],"\xBD"=>[18,"\x828"],"\xBE"=>[77,"\x829"],"\xBF"=>[18,"\x829"],"\xC0"=>[77,"\x82\x3D"],"\xC1"=>[18,"\x82\x3D"],"\xC2"=>[77,"\x82A"],"\xC3"=>[18,"\x82A"],"\xC4"=>[77,"\x82_"],"\xC5"=>[18,"\x82_"],"\xC6"=>[77,"\x82b"],"\xC7"=>[18,"\x82b"],"\xC8"=>[77,"\x82d"],"\xC9"=>[18,"\x82d"],"\xCA"=>[77,"\x82f"],"\xCB"=>[18,"\x82f"],"\xCC"=>[77,"\x82g"],"\xCD"=>[18,"\x82g"],"\xCE"=>[77,"\x82h"],"\xCF"=>[18,"\x82h"],"\xD0"=>[77,"\x82l"],"\xD1"=>[18,"\x82l"],"\xD2"=>[77,"\x82m"],"\xD3"=>[18,"\x82m"],"\xD4"=>[77,"\x82n"],"\xD5"=>[18,"\x82n"],"\xD6"=>[77,"\x82p"],"\xD7"=>[18,"\x82p"],"\xD8"=>[77,"\x82r"],"\xD9"=>[18,"\x82r"],"\xDA"=>[77,"\x82u"],"\xDB"=>[18,"\x82u"],"\xDC"=>[0,"\x82\x3A"],"\xDD"=>[0,"\x82B"],"\xDE"=>[0,"\x82C"],"\xDF"=>[0,"\x82D"],"\xE0"=>[0,"\x82E"],"\xE1"=>[0,"\x82F"],"\xE2"=>[0,"\x82G"],"\xE3"=>[0,"\x82H"],"\xE4"=>[0,"\x82I"],"\xE5"=>[0,"\x82J"],"\xE6"=>[0,"\x82K"],"\xE7"=>[0,"\x82L"],"\xE8"=>[0,"\x82M"],"\xE9"=>[0,"\x82N"],"\xEA"=>[0,"\x82O"],"\xEB"=>[0,"\x82P"],"\xEC"=>[0,"\x82Q"],"\xED"=>[0,"\x82R"],"\xEE"=>[0,"\x82S"],"\xEF"=>[0,"\x82T"],"\xF0"=>[0,"\x82U"],"\xF1"=>[0,"\x82V"],"\xF2"=>[0,"\x82W"],"\xF3"=>[0,"\x82Y"],"\xF4"=>[0,"\x82j"],"\xF5"=>[0,"\x82k"],"\xF6"=>[0,"\x82q"],"\xF7"=>[0,"\x82v"],"\xF8"=>[0,"\x82w"],"\xF9"=>[0,"\x82x"],"\xFA"=>[0,"\x82y"],"\xFB"=>[0,"\x82z"],"\xFC"=>[82,"\x82"],"\xFD"=>[87,"\x82"],"\xFE"=>[130,"\x82"],"\xFF"=>[9,"\x82"],],["\x00"=>[94,"\xD00"],"\x01"=>[76,"\xD00"],"\x02"=>[104,"\xD00"],"\x03"=>[16,"\xD00"],"\x04"=>[94,"\xD01"],"\x05"=>[76,"\xD01"],"\x06"=>[104,"\xD01"],"\x07"=>[16,"\xD01"],"\x08"=>[94,"\xD02"],"\x09"=>[76,"\xD02"],"\x0A"=>[104,"\xD02"],"\x0B"=>[16,"\xD02"],"\x0C"=>[94,"\xD0a"],"\x0D"=>[76,"\xD0a"],"\x0E"=>[104,"\xD0a"],"\x0F"=>[16,"\xD0a"],"\x10"=>[94,"\xD0c"],"\x11"=>[76,"\xD0c"],"\x12"=>[104,"\xD0c"],"\x13"=>[16,"\xD0c"],"\x14"=>[94,"\xD0e"],"\x15"=>[76,"\xD0e"],"\x16"=>[104,"\xD0e"],"\x17"=>[16,"\xD0e"],"\x18"=>[94,"\xD0i"],"\x19"=>[76,"\xD0i"],"\x1A"=>[104,"\xD0i"],"\x1B"=>[16,"\xD0i"],"\x1C"=>[94,"\xD0o"],"\x1D"=>[76,"\xD0o"],"\x1E"=>[104,"\xD0o"],"\x1F"=>[16,"\xD0o"],"\x20"=>[94,"\xD0s"],"\x21"=>[76,"\xD0s"],"\x22"=>[104,"\xD0s"],"\x23"=>[16,"\xD0s"],"\x24"=>[94,"\xD0t"],"\x25"=>[76,"\xD0t"],"\x26"=>[104,"\xD0t"],"\x27"=>[16,"\xD0t"],"\x28"=>[77,"\xD0\x20"],"\x29"=>[18,"\xD0\x20"],"\x2A"=>[77,"\xD0\x25"],"\x2B"=>[18,"\xD0\x25"],"\x2C"=>[77,"\xD0-"],"-"=>[18,"\xD0-"],"."=>[77,"\xD0."],"\x2F"=>[18,"\xD0."],[77,"\xD0\x2F"],[18,"\xD0\x2F"],[77,"\xD03"],[18,"\xD03"],[77,"\xD04"],[18,"\xD04"],[77,"\xD05"],[18,"\xD05"],[77,"\xD06"],[18,"\xD06"],"\x3A"=>[77,"\xD07"],"\x3B"=>[18,"\xD07"],"\x3C"=>[77,"\xD08"],"\x3D"=>[18,"\xD08"],"\x3E"=>[77,"\xD09"],"\x3F"=>[18,"\xD09"],"\x40"=>[77,"\xD0\x3D"],"A"=>[18,"\xD0\x3D"],"B"=>[77,"\xD0A"],"C"=>[18,"\xD0A"],"D"=>[77,"\xD0_"],"E"=>[18,"\xD0_"],"F"=>[77,"\xD0b"],"G"=>[18,"\xD0b"],"H"=>[77,"\xD0d"],"I"=>[18,"\xD0d"],"J"=>[77,"\xD0f"],"K"=>[18,"\xD0f"],"L"=>[77,"\xD0g"],"M"=>[18,"\xD0g"],"N"=>[77,"\xD0h"],"O"=>[18,"\xD0h"],"P"=>[77,"\xD0l"],"Q"=>[18,"\xD0l"],"R"=>[77,"\xD0m"],"S"=>[18,"\xD0m"],"T"=>[77,"\xD0n"],"U"=>[18,"\xD0n"],"V"=>[77,"\xD0p"],"W"=>[18,"\xD0p"],"X"=>[77,"\xD0r"],"Y"=>[18,"\xD0r"],"Z"=>[77,"\xD0u"],"\x5B"=>[18,"\xD0u"],"\x5C"=>[0,"\xD0\x3A"],"\x5D"=>[0,"\xD0B"],"\x5E"=>[0,"\xD0C"],"_"=>[0,"\xD0D"],"\x60"=>[0,"\xD0E"],"a"=>[0,"\xD0F"],"b"=>[0,"\xD0G"],"c"=>[0,"\xD0H"],"d"=>[0,"\xD0I"],"e"=>[0,"\xD0J"],"f"=>[0,"\xD0K"],"g"=>[0,"\xD0L"],"h"=>[0,"\xD0M"],"i"=>[0,"\xD0N"],"j"=>[0,"\xD0O"],"k"=>[0,"\xD0P"],"l"=>[0,"\xD0Q"],"m"=>[0,"\xD0R"],"n"=>[0,"\xD0S"],"o"=>[0,"\xD0T"],"p"=>[0,"\xD0U"],"q"=>[0,"\xD0V"],"r"=>[0,"\xD0W"],"s"=>[0,"\xD0Y"],"t"=>[0,"\xD0j"],"u"=>[0,"\xD0k"],"v"=>[0,"\xD0q"],"w"=>[0,"\xD0v"],"x"=>[0,"\xD0w"],"y"=>[0,"\xD0x"],"z"=>[0,"\xD0y"],"\x7B"=>[0,"\xD0z"],"\x7C"=>[82,"\xD0"],"\x7D"=>[87,"\xD0"],"~"=>[130,"\xD0"],"\x7F"=>[9,"\xD0"],"\x80"=>[77,"\x800"],"\x81"=>[18,"\x800"],"\x82"=>[77,"\x801"],"\x83"=>[18,"\x801"],"\x84"=>[77,"\x802"],"\x85"=>[18,"\x802"],"\x86"=>[77,"\x80a"],"\x87"=>[18,"\x80a"],"\x88"=>[77,"\x80c"],"\x89"=>[18,"\x80c"],"\x8A"=>[77,"\x80e"],"\x8B"=>[18,"\x80e"],"\x8C"=>[77,"\x80i"],"\x8D"=>[18,"\x80i"],"\x8E"=>[77,"\x80o"],"\x8F"=>[18,"\x80o"],"\x90"=>[77,"\x80s"],"\x91"=>[18,"\x80s"],"\x92"=>[77,"\x80t"],"\x93"=>[18,"\x80t"],"\x94"=>[0,"\x80\x20"],"\x95"=>[0,"\x80\x25"],"\x96"=>[0,"\x80-"],"\x97"=>[0,"\x80."],"\x98"=>[0,"\x80\x2F"],"\x99"=>[0,"\x803"],"\x9A"=>[0,"\x804"],"\x9B"=>[0,"\x805"],"\x9C"=>[0,"\x806"],"\x9D"=>[0,"\x807"],"\x9E"=>[0,"\x808"],"\x9F"=>[0,"\x809"],"\xA0"=>[0,"\x80\x3D"],"\xA1"=>[0,"\x80A"],"\xA2"=>[0,"\x80_"],"\xA3"=>[0,"\x80b"],"\xA4"=>[0,"\x80d"],"\xA5"=>[0,"\x80f"],"\xA6"=>[0,"\x80g"],"\xA7"=>[0,"\x80h"],"\xA8"=>[0,"\x80l"],"\xA9"=>[0,"\x80m"],"\xAA"=>[0,"\x80n"],"\xAB"=>[0,"\x80p"],"\xAC"=>[0,"\x80r"],"\xAD"=>[0,"\x80u"],"\xAE"=>[100,"\x80"],"\xAF"=>[110,"\x80"],"\xB0"=>[111,"\x80"],"\xB1"=>[115,"\x80"],"\xB2"=>[116,"\x80"],"\xB3"=>[118,"\x80"],"\xB4"=>[119,"\x80"],"\xB5"=>[122,"\x80"],"\xB6"=>[123,"\x80"],"\xB7"=>[125,"\x80"],"\xB8"=>[126,"\x80"],"\xB9"=>[129,"\x80"],"\xBA"=>[143,"\x80"],"\xBB"=>[148,"\x80"],"\xBC"=>[151,"\x80"],"\xBD"=>[153,"\x80"],"\xBE"=>[83,"\x80"],"\xBF"=>[10,"\x80"],"\xC0"=>[77,"\x820"],"\xC1"=>[18,"\x820"],"\xC2"=>[77,"\x821"],"\xC3"=>[18,"\x821"],"\xC4"=>[77,"\x822"],"\xC5"=>[18,"\x822"],"\xC6"=>[77,"\x82a"],"\xC7"=>[18,"\x82a"],"\xC8"=>[77,"\x82c"],"\xC9"=>[18,"\x82c"],"\xCA"=>[77,"\x82e"],"\xCB"=>[18,"\x82e"],"\xCC"=>[77,"\x82i"],"\xCD"=>[18,"\x82i"],"\xCE"=>[77,"\x82o"],"\xCF"=>[18,"\x82o"],"\xD0"=>[77,"\x82s"],"\xD1"=>[18,"\x82s"],"\xD2"=>[77,"\x82t"],"\xD3"=>[18,"\x82t"],"\xD4"=>[0,"\x82\x20"],"\xD5"=>[0,"\x82\x25"],"\xD6"=>[0,"\x82-"],"\xD7"=>[0,"\x82."],"\xD8"=>[0,"\x82\x2F"],"\xD9"=>[0,"\x823"],"\xDA"=>[0,"\x824"],"\xDB"=>[0,"\x825"],"\xDC"=>[0,"\x826"],"\xDD"=>[0,"\x827"],"\xDE"=>[0,"\x828"],"\xDF"=>[0,"\x829"],"\xE0"=>[0,"\x82\x3D"],"\xE1"=>[0,"\x82A"],"\xE2"=>[0,"\x82_"],"\xE3"=>[0,"\x82b"],"\xE4"=>[0,"\x82d"],"\xE5"=>[0,"\x82f"],"\xE6"=>[0,"\x82g"],"\xE7"=>[0,"\x82h"],"\xE8"=>[0,"\x82l"],"\xE9"=>[0,"\x82m"],"\xEA"=>[0,"\x82n"],"\xEB"=>[0,"\x82p"],"\xEC"=>[0,"\x82r"],"\xED"=>[0,"\x82u"],"\xEE"=>[100,"\x82"],"\xEF"=>[110,"\x82"],"\xF0"=>[111,"\x82"],"\xF1"=>[115,"\x82"],"\xF2"=>[116,"\x82"],"\xF3"=>[118,"\x82"],"\xF4"=>[119,"\x82"],"\xF5"=>[122,"\x82"],"\xF6"=>[123,"\x82"],"\xF7"=>[125,"\x82"],"\xF8"=>[126,"\x82"],"\xF9"=>[129,"\x82"],"\xFA"=>[143,"\x82"],"\xFB"=>[148,"\x82"],"\xFC"=>[151,"\x82"],"\xFD"=>[153,"\x82"],"\xFE"=>[83,"\x82"],"\xFF"=>[10,"\x82"],],["\x00"=>[94,"\x810"],"\x01"=>[76,"\x810"],"\x02"=>[104,"\x810"],"\x03"=>[16,"\x810"],"\x04"=>[94,"\x811"],"\x05"=>[76,"\x811"],"\x06"=>[104,"\x811"],"\x07"=>[16,"\x811"],"\x08"=>[94,"\x812"],"\x09"=>[76,"\x812"],"\x0A"=>[104,"\x812"],"\x0B"=>[16,"\x812"],"\x0C"=>[94,"\x81a"],"\x0D"=>[76,"\x81a"],"\x0E"=>[104,"\x81a"],"\x0F"=>[16,"\x81a"],"\x10"=>[94,"\x81c"],"\x11"=>[76,"\x81c"],"\x12"=>[104,"\x81c"],"\x13"=>[16,"\x81c"],"\x14"=>[94,"\x81e"],"\x15"=>[76,"\x81e"],"\x16"=>[104,"\x81e"],"\x17"=>[16,"\x81e"],"\x18"=>[94,"\x81i"],"\x19"=>[76,"\x81i"],"\x1A"=>[104,"\x81i"],"\x1B"=>[16,"\x81i"],"\x1C"=>[94,"\x81o"],"\x1D"=>[76,"\x81o"],"\x1E"=>[104,"\x81o"],"\x1F"=>[16,"\x81o"],"\x20"=>[94,"\x81s"],"\x21"=>[76,"\x81s"],"\x22"=>[104,"\x81s"],"\x23"=>[16,"\x81s"],"\x24"=>[94,"\x81t"],"\x25"=>[76,"\x81t"],"\x26"=>[104,"\x81t"],"\x27"=>[16,"\x81t"],"\x28"=>[77,"\x81\x20"],"\x29"=>[18,"\x81\x20"],"\x2A"=>[77,"\x81\x25"],"\x2B"=>[18,"\x81\x25"],"\x2C"=>[77,"\x81-"],"-"=>[18,"\x81-"],"."=>[77,"\x81."],"\x2F"=>[18,"\x81."],[77,"\x81\x2F"],[18,"\x81\x2F"],[77,"\x813"],[18,"\x813"],[77,"\x814"],[18,"\x814"],[77,"\x815"],[18,"\x815"],[77,"\x816"],[18,"\x816"],"\x3A"=>[77,"\x817"],"\x3B"=>[18,"\x817"],"\x3C"=>[77,"\x818"],"\x3D"=>[18,"\x818"],"\x3E"=>[77,"\x819"],"\x3F"=>[18,"\x819"],"\x40"=>[77,"\x81\x3D"],"A"=>[18,"\x81\x3D"],"B"=>[77,"\x81A"],"C"=>[18,"\x81A"],"D"=>[77,"\x81_"],"E"=>[18,"\x81_"],"F"=>[77,"\x81b"],"G"=>[18,"\x81b"],"H"=>[77,"\x81d"],"I"=>[18,"\x81d"],"J"=>[77,"\x81f"],"K"=>[18,"\x81f"],"L"=>[77,"\x81g"],"M"=>[18,"\x81g"],"N"=>[77,"\x81h"],"O"=>[18,"\x81h"],"P"=>[77,"\x81l"],"Q"=>[18,"\x81l"],"R"=>[77,"\x81m"],"S"=>[18,"\x81m"],"T"=>[77,"\x81n"],"U"=>[18,"\x81n"],"V"=>[77,"\x81p"],"W"=>[18,"\x81p"],"X"=>[77,"\x81r"],"Y"=>[18,"\x81r"],"Z"=>[77,"\x81u"],"\x5B"=>[18,"\x81u"],"\x5C"=>[0,"\x81\x3A"],"\x5D"=>[0,"\x81B"],"\x5E"=>[0,"\x81C"],"_"=>[0,"\x81D"],"\x60"=>[0,"\x81E"],"a"=>[0,"\x81F"],"b"=>[0,"\x81G"],"c"=>[0,"\x81H"],"d"=>[0,"\x81I"],"e"=>[0,"\x81J"],"f"=>[0,"\x81K"],"g"=>[0,"\x81L"],"h"=>[0,"\x81M"],"i"=>[0,"\x81N"],"j"=>[0,"\x81O"],"k"=>[0,"\x81P"],"l"=>[0,"\x81Q"],"m"=>[0,"\x81R"],"n"=>[0,"\x81S"],"o"=>[0,"\x81T"],"p"=>[0,"\x81U"],"q"=>[0,"\x81V"],"r"=>[0,"\x81W"],"s"=>[0,"\x81Y"],"t"=>[0,"\x81j"],"u"=>[0,"\x81k"],"v"=>[0,"\x81q"],"w"=>[0,"\x81v"],"x"=>[0,"\x81w"],"y"=>[0,"\x81x"],"z"=>[0,"\x81y"],"\x7B"=>[0,"\x81z"],"\x7C"=>[82,"\x81"],"\x7D"=>[87,"\x81"],"~"=>[130,"\x81"],"\x7F"=>[9,"\x81"],"\x80"=>[94,"\x840"],"\x81"=>[76,"\x840"],"\x82"=>[104,"\x840"],"\x83"=>[16,"\x840"],"\x84"=>[94,"\x841"],"\x85"=>[76,"\x841"],"\x86"=>[104,"\x841"],"\x87"=>[16,"\x841"],"\x88"=>[94,"\x842"],"\x89"=>[76,"\x842"],"\x8A"=>[104,"\x842"],"\x8B"=>[16,"\x842"],"\x8C"=>[94,"\x84a"],"\x8D"=>[76,"\x84a"],"\x8E"=>[104,"\x84a"],"\x8F"=>[16,"\x84a"],"\x90"=>[94,"\x84c"],"\x91"=>[76,"\x84c"],"\x92"=>[104,"\x84c"],"\x93"=>[16,"\x84c"],"\x94"=>[94,"\x84e"],"\x95"=>[76,"\x84e"],"\x96"=>[104,"\x84e"],"\x97"=>[16,"\x84e"],"\x98"=>[94,"\x84i"],"\x99"=>[76,"\x84i"],"\x9A"=>[104,"\x84i"],"\x9B"=>[16,"\x84i"],"\x9C"=>[94,"\x84o"],"\x9D"=>[76,"\x84o"],"\x9E"=>[104,"\x84o"],"\x9F"=>[16,"\x84o"],"\xA0"=>[94,"\x84s"],"\xA1"=>[76,"\x84s"],"\xA2"=>[104,"\x84s"],"\xA3"=>[16,"\x84s"],"\xA4"=>[94,"\x84t"],"\xA5"=>[76,"\x84t"],"\xA6"=>[104,"\x84t"],"\xA7"=>[16,"\x84t"],"\xA8"=>[77,"\x84\x20"],"\xA9"=>[18,"\x84\x20"],"\xAA"=>[77,"\x84\x25"],"\xAB"=>[18,"\x84\x25"],"\xAC"=>[77,"\x84-"],"\xAD"=>[18,"\x84-"],"\xAE"=>[77,"\x84."],"\xAF"=>[18,"\x84."],"\xB0"=>[77,"\x84\x2F"],"\xB1"=>[18,"\x84\x2F"],"\xB2"=>[77,"\x843"],"\xB3"=>[18,"\x843"],"\xB4"=>[77,"\x844"],"\xB5"=>[18,"\x844"],"\xB6"=>[77,"\x845"],"\xB7"=>[18,"\x845"],"\xB8"=>[77,"\x846"],"\xB9"=>[18,"\x846"],"\xBA"=>[77,"\x847"],"\xBB"=>[18,"\x847"],"\xBC"=>[77,"\x848"],"\xBD"=>[18,"\x848"],"\xBE"=>[77,"\x849"],"\xBF"=>[18,"\x849"],"\xC0"=>[77,"\x84\x3D"],"\xC1"=>[18,"\x84\x3D"],"\xC2"=>[77,"\x84A"],"\xC3"=>[18,"\x84A"],"\xC4"=>[77,"\x84_"],"\xC5"=>[18,"\x84_"],"\xC6"=>[77,"\x84b"],"\xC7"=>[18,"\x84b"],"\xC8"=>[77,"\x84d"],"\xC9"=>[18,"\x84d"],"\xCA"=>[77,"\x84f"],"\xCB"=>[18,"\x84f"],"\xCC"=>[77,"\x84g"],"\xCD"=>[18,"\x84g"],"\xCE"=>[77,"\x84h"],"\xCF"=>[18,"\x84h"],"\xD0"=>[77,"\x84l"],"\xD1"=>[18,"\x84l"],"\xD2"=>[77,"\x84m"],"\xD3"=>[18,"\x84m"],"\xD4"=>[77,"\x84n"],"\xD5"=>[18,"\x84n"],"\xD6"=>[77,"\x84p"],"\xD7"=>[18,"\x84p"],"\xD8"=>[77,"\x84r"],"\xD9"=>[18,"\x84r"],"\xDA"=>[77,"\x84u"],"\xDB"=>[18,"\x84u"],"\xDC"=>[0,"\x84\x3A"],"\xDD"=>[0,"\x84B"],"\xDE"=>[0,"\x84C"],"\xDF"=>[0,"\x84D"],"\xE0"=>[0,"\x84E"],"\xE1"=>[0,"\x84F"],"\xE2"=>[0,"\x84G"],"\xE3"=>[0,"\x84H"],"\xE4"=>[0,"\x84I"],"\xE5"=>[0,"\x84J"],"\xE6"=>[0,"\x84K"],"\xE7"=>[0,"\x84L"],"\xE8"=>[0,"\x84M"],"\xE9"=>[0,"\x84N"],"\xEA"=>[0,"\x84O"],"\xEB"=>[0,"\x84P"],"\xEC"=>[0,"\x84Q"],"\xED"=>[0,"\x84R"],"\xEE"=>[0,"\x84S"],"\xEF"=>[0,"\x84T"],"\xF0"=>[0,"\x84U"],"\xF1"=>[0,"\x84V"],"\xF2"=>[0,"\x84W"],"\xF3"=>[0,"\x84Y"],"\xF4"=>[0,"\x84j"],"\xF5"=>[0,"\x84k"],"\xF6"=>[0,"\x84q"],"\xF7"=>[0,"\x84v"],"\xF8"=>[0,"\x84w"],"\xF9"=>[0,"\x84x"],"\xFA"=>[0,"\x84y"],"\xFB"=>[0,"\x84z"],"\xFC"=>[82,"\x84"],"\xFD"=>[87,"\x84"],"\xFE"=>[130,"\x84"],"\xFF"=>[9,"\x84"],],["\x00"=>[94,"\xE60"],"\x01"=>[76,"\xE60"],"\x02"=>[104,"\xE60"],"\x03"=>[16,"\xE60"],"\x04"=>[94,"\xE61"],"\x05"=>[76,"\xE61"],"\x06"=>[104,"\xE61"],"\x07"=>[16,"\xE61"],"\x08"=>[94,"\xE62"],"\x09"=>[76,"\xE62"],"\x0A"=>[104,"\xE62"],"\x0B"=>[16,"\xE62"],"\x0C"=>[94,"\xE6a"],"\x0D"=>[76,"\xE6a"],"\x0E"=>[104,"\xE6a"],"\x0F"=>[16,"\xE6a"],"\x10"=>[94,"\xE6c"],"\x11"=>[76,"\xE6c"],"\x12"=>[104,"\xE6c"],"\x13"=>[16,"\xE6c"],"\x14"=>[94,"\xE6e"],"\x15"=>[76,"\xE6e"],"\x16"=>[104,"\xE6e"],"\x17"=>[16,"\xE6e"],"\x18"=>[94,"\xE6i"],"\x19"=>[76,"\xE6i"],"\x1A"=>[104,"\xE6i"],"\x1B"=>[16,"\xE6i"],"\x1C"=>[94,"\xE6o"],"\x1D"=>[76,"\xE6o"],"\x1E"=>[104,"\xE6o"],"\x1F"=>[16,"\xE6o"],"\x20"=>[94,"\xE6s"],"\x21"=>[76,"\xE6s"],"\x22"=>[104,"\xE6s"],"\x23"=>[16,"\xE6s"],"\x24"=>[94,"\xE6t"],"\x25"=>[76,"\xE6t"],"\x26"=>[104,"\xE6t"],"\x27"=>[16,"\xE6t"],"\x28"=>[77,"\xE6\x20"],"\x29"=>[18,"\xE6\x20"],"\x2A"=>[77,"\xE6\x25"],"\x2B"=>[18,"\xE6\x25"],"\x2C"=>[77,"\xE6-"],"-"=>[18,"\xE6-"],"."=>[77,"\xE6."],"\x2F"=>[18,"\xE6."],[77,"\xE6\x2F"],[18,"\xE6\x2F"],[77,"\xE63"],[18,"\xE63"],[77,"\xE64"],[18,"\xE64"],[77,"\xE65"],[18,"\xE65"],[77,"\xE66"],[18,"\xE66"],"\x3A"=>[77,"\xE67"],"\x3B"=>[18,"\xE67"],"\x3C"=>[77,"\xE68"],"\x3D"=>[18,"\xE68"],"\x3E"=>[77,"\xE69"],"\x3F"=>[18,"\xE69"],"\x40"=>[77,"\xE6\x3D"],"A"=>[18,"\xE6\x3D"],"B"=>[77,"\xE6A"],"C"=>[18,"\xE6A"],"D"=>[77,"\xE6_"],"E"=>[18,"\xE6_"],"F"=>[77,"\xE6b"],"G"=>[18,"\xE6b"],"H"=>[77,"\xE6d"],"I"=>[18,"\xE6d"],"J"=>[77,"\xE6f"],"K"=>[18,"\xE6f"],"L"=>[77,"\xE6g"],"M"=>[18,"\xE6g"],"N"=>[77,"\xE6h"],"O"=>[18,"\xE6h"],"P"=>[77,"\xE6l"],"Q"=>[18,"\xE6l"],"R"=>[77,"\xE6m"],"S"=>[18,"\xE6m"],"T"=>[77,"\xE6n"],"U"=>[18,"\xE6n"],"V"=>[77,"\xE6p"],"W"=>[18,"\xE6p"],"X"=>[77,"\xE6r"],"Y"=>[18,"\xE6r"],"Z"=>[77,"\xE6u"],"\x5B"=>[18,"\xE6u"],"\x5C"=>[0,"\xE6\x3A"],"\x5D"=>[0,"\xE6B"],"\x5E"=>[0,"\xE6C"],"_"=>[0,"\xE6D"],"\x60"=>[0,"\xE6E"],"a"=>[0,"\xE6F"],"b"=>[0,"\xE6G"],"c"=>[0,"\xE6H"],"d"=>[0,"\xE6I"],"e"=>[0,"\xE6J"],"f"=>[0,"\xE6K"],"g"=>[0,"\xE6L"],"h"=>[0,"\xE6M"],"i"=>[0,"\xE6N"],"j"=>[0,"\xE6O"],"k"=>[0,"\xE6P"],"l"=>[0,"\xE6Q"],"m"=>[0,"\xE6R"],"n"=>[0,"\xE6S"],"o"=>[0,"\xE6T"],"p"=>[0,"\xE6U"],"q"=>[0,"\xE6V"],"r"=>[0,"\xE6W"],"s"=>[0,"\xE6Y"],"t"=>[0,"\xE6j"],"u"=>[0,"\xE6k"],"v"=>[0,"\xE6q"],"w"=>[0,"\xE6v"],"x"=>[0,"\xE6w"],"y"=>[0,"\xE6x"],"z"=>[0,"\xE6y"],"\x7B"=>[0,"\xE6z"],"\x7C"=>[82,"\xE6"],"\x7D"=>[87,"\xE6"],"~"=>[130,"\xE6"],"\x7F"=>[9,"\xE6"],"\x80"=>[77,"\x810"],"\x81"=>[18,"\x810"],"\x82"=>[77,"\x811"],"\x83"=>[18,"\x811"],"\x84"=>[77,"\x812"],"\x85"=>[18,"\x812"],"\x86"=>[77,"\x81a"],"\x87"=>[18,"\x81a"],"\x88"=>[77,"\x81c"],"\x89"=>[18,"\x81c"],"\x8A"=>[77,"\x81e"],"\x8B"=>[18,"\x81e"],"\x8C"=>[77,"\x81i"],"\x8D"=>[18,"\x81i"],"\x8E"=>[77,"\x81o"],"\x8F"=>[18,"\x81o"],"\x90"=>[77,"\x81s"],"\x91"=>[18,"\x81s"],"\x92"=>[77,"\x81t"],"\x93"=>[18,"\x81t"],"\x94"=>[0,"\x81\x20"],"\x95"=>[0,"\x81\x25"],"\x96"=>[0,"\x81-"],"\x97"=>[0,"\x81."],"\x98"=>[0,"\x81\x2F"],"\x99"=>[0,"\x813"],"\x9A"=>[0,"\x814"],"\x9B"=>[0,"\x815"],"\x9C"=>[0,"\x816"],"\x9D"=>[0,"\x817"],"\x9E"=>[0,"\x818"],"\x9F"=>[0,"\x819"],"\xA0"=>[0,"\x81\x3D"],"\xA1"=>[0,"\x81A"],"\xA2"=>[0,"\x81_"],"\xA3"=>[0,"\x81b"],"\xA4"=>[0,"\x81d"],"\xA5"=>[0,"\x81f"],"\xA6"=>[0,"\x81g"],"\xA7"=>[0,"\x81h"],"\xA8"=>[0,"\x81l"],"\xA9"=>[0,"\x81m"],"\xAA"=>[0,"\x81n"],"\xAB"=>[0,"\x81p"],"\xAC"=>[0,"\x81r"],"\xAD"=>[0,"\x81u"],"\xAE"=>[100,"\x81"],"\xAF"=>[110,"\x81"],"\xB0"=>[111,"\x81"],"\xB1"=>[115,"\x81"],"\xB2"=>[116,"\x81"],"\xB3"=>[118,"\x81"],"\xB4"=>[119,"\x81"],"\xB5"=>[122,"\x81"],"\xB6"=>[123,"\x81"],"\xB7"=>[125,"\x81"],"\xB8"=>[126,"\x81"],"\xB9"=>[129,"\x81"],"\xBA"=>[143,"\x81"],"\xBB"=>[148,"\x81"],"\xBC"=>[151,"\x81"],"\xBD"=>[153,"\x81"],"\xBE"=>[83,"\x81"],"\xBF"=>[10,"\x81"],"\xC0"=>[77,"\x840"],"\xC1"=>[18,"\x840"],"\xC2"=>[77,"\x841"],"\xC3"=>[18,"\x841"],"\xC4"=>[77,"\x842"],"\xC5"=>[18,"\x842"],"\xC6"=>[77,"\x84a"],"\xC7"=>[18,"\x84a"],"\xC8"=>[77,"\x84c"],"\xC9"=>[18,"\x84c"],"\xCA"=>[77,"\x84e"],"\xCB"=>[18,"\x84e"],"\xCC"=>[77,"\x84i"],"\xCD"=>[18,"\x84i"],"\xCE"=>[77,"\x84o"],"\xCF"=>[18,"\x84o"],"\xD0"=>[77,"\x84s"],"\xD1"=>[18,"\x84s"],"\xD2"=>[77,"\x84t"],"\xD3"=>[18,"\x84t"],"\xD4"=>[0,"\x84\x20"],"\xD5"=>[0,"\x84\x25"],"\xD6"=>[0,"\x84-"],"\xD7"=>[0,"\x84."],"\xD8"=>[0,"\x84\x2F"],"\xD9"=>[0,"\x843"],"\xDA"=>[0,"\x844"],"\xDB"=>[0,"\x845"],"\xDC"=>[0,"\x846"],"\xDD"=>[0,"\x847"],"\xDE"=>[0,"\x848"],"\xDF"=>[0,"\x849"],"\xE0"=>[0,"\x84\x3D"],"\xE1"=>[0,"\x84A"],"\xE2"=>[0,"\x84_"],"\xE3"=>[0,"\x84b"],"\xE4"=>[0,"\x84d"],"\xE5"=>[0,"\x84f"],"\xE6"=>[0,"\x84g"],"\xE7"=>[0,"\x84h"],"\xE8"=>[0,"\x84l"],"\xE9"=>[0,"\x84m"],"\xEA"=>[0,"\x84n"],"\xEB"=>[0,"\x84p"],"\xEC"=>[0,"\x84r"],"\xED"=>[0,"\x84u"],"\xEE"=>[100,"\x84"],"\xEF"=>[110,"\x84"],"\xF0"=>[111,"\x84"],"\xF1"=>[115,"\x84"],"\xF2"=>[116,"\x84"],"\xF3"=>[118,"\x84"],"\xF4"=>[119,"\x84"],"\xF5"=>[122,"\x84"],"\xF6"=>[123,"\x84"],"\xF7"=>[125,"\x84"],"\xF8"=>[126,"\x84"],"\xF9"=>[129,"\x84"],"\xFA"=>[143,"\x84"],"\xFB"=>[148,"\x84"],"\xFC"=>[151,"\x84"],"\xFD"=>[153,"\x84"],"\xFE"=>[83,"\x84"],"\xFF"=>[10,"\x84"],],["\x00"=>[77,"\xE60"],"\x01"=>[18,"\xE60"],"\x02"=>[77,"\xE61"],"\x03"=>[18,"\xE61"],"\x04"=>[77,"\xE62"],"\x05"=>[18,"\xE62"],"\x06"=>[77,"\xE6a"],"\x07"=>[18,"\xE6a"],"\x08"=>[77,"\xE6c"],"\x09"=>[18,"\xE6c"],"\x0A"=>[77,"\xE6e"],"\x0B"=>[18,"\xE6e"],"\x0C"=>[77,"\xE6i"],"\x0D"=>[18,"\xE6i"],"\x0E"=>[77,"\xE6o"],"\x0F"=>[18,"\xE6o"],"\x10"=>[77,"\xE6s"],"\x11"=>[18,"\xE6s"],"\x12"=>[77,"\xE6t"],"\x13"=>[18,"\xE6t"],"\x14"=>[0,"\xE6\x20"],"\x15"=>[0,"\xE6\x25"],"\x16"=>[0,"\xE6-"],"\x17"=>[0,"\xE6."],"\x18"=>[0,"\xE6\x2F"],"\x19"=>[0,"\xE63"],"\x1A"=>[0,"\xE64"],"\x1B"=>[0,"\xE65"],"\x1C"=>[0,"\xE66"],"\x1D"=>[0,"\xE67"],"\x1E"=>[0,"\xE68"],"\x1F"=>[0,"\xE69"],"\x20"=>[0,"\xE6\x3D"],"\x21"=>[0,"\xE6A"],"\x22"=>[0,"\xE6_"],"\x23"=>[0,"\xE6b"],"\x24"=>[0,"\xE6d"],"\x25"=>[0,"\xE6f"],"\x26"=>[0,"\xE6g"],"\x27"=>[0,"\xE6h"],"\x28"=>[0,"\xE6l"],"\x29"=>[0,"\xE6m"],"\x2A"=>[0,"\xE6n"],"\x2B"=>[0,"\xE6p"],"\x2C"=>[0,"\xE6r"],"-"=>[0,"\xE6u"],"."=>[100,"\xE6"],"\x2F"=>[110,"\xE6"],[111,"\xE6"],[115,"\xE6"],[116,"\xE6"],[118,"\xE6"],[119,"\xE6"],[122,"\xE6"],[123,"\xE6"],[125,"\xE6"],[126,"\xE6"],[129,"\xE6"],"\x3A"=>[143,"\xE6"],"\x3B"=>[148,"\xE6"],"\x3C"=>[151,"\xE6"],"\x3D"=>[153,"\xE6"],"\x3E"=>[83,"\xE6"],"\x3F"=>[10,"\xE6"],"\x40"=>[0,"\x810"],"A"=>[0,"\x811"],"B"=>[0,"\x812"],"C"=>[0,"\x81a"],"D"=>[0,"\x81c"],"E"=>[0,"\x81e"],"F"=>[0,"\x81i"],"G"=>[0,"\x81o"],"H"=>[0,"\x81s"],"I"=>[0,"\x81t"],"J"=>[73,"\x81"],"K"=>[88,"\x81"],"L"=>[89,"\x81"],"M"=>[96,"\x81"],"N"=>[97,"\x81"],"O"=>[99,"\x81"],"P"=>[106,"\x81"],"Q"=>[136,"\x81"],"R"=>[139,"\x81"],"S"=>[141,"\x81"],"T"=>[145,"\x81"],"U"=>[147,"\x81"],"V"=>[149,"\x81"],"W"=>[101,"\x81"],"X"=>[112,"\x81"],"Y"=>[117,"\x81"],"Z"=>[120,"\x81"],"\x5B"=>[124,"\x81"],"\x5C"=>[127,"\x81"],"\x5D"=>[144,"\x81"],"\x5E"=>[152,"\x81"],"_"=>[11,"\x81"],"\x60"=>[0,"\x840"],"a"=>[0,"\x841"],"b"=>[0,"\x842"],"c"=>[0,"\x84a"],"d"=>[0,"\x84c"],"e"=>[0,"\x84e"],"f"=>[0,"\x84i"],"g"=>[0,"\x84o"],"h"=>[0,"\x84s"],"i"=>[0,"\x84t"],"j"=>[73,"\x84"],"k"=>[88,"\x84"],"l"=>[89,"\x84"],"m"=>[96,"\x84"],"n"=>[97,"\x84"],"o"=>[99,"\x84"],"p"=>[106,"\x84"],"q"=>[136,"\x84"],"r"=>[139,"\x84"],"s"=>[141,"\x84"],"t"=>[145,"\x84"],"u"=>[147,"\x84"],"v"=>[149,"\x84"],"w"=>[101,"\x84"],"x"=>[112,"\x84"],"y"=>[117,"\x84"],"z"=>[120,"\x84"],"\x7B"=>[124,"\x84"],"\x7C"=>[127,"\x84"],"\x7D"=>[144,"\x84"],"~"=>[152,"\x84"],"\x7F"=>[11,"\x84"],"\x80"=>[0,"\x850"],"\x81"=>[0,"\x851"],"\x82"=>[0,"\x852"],"\x83"=>[0,"\x85a"],"\x84"=>[0,"\x85c"],"\x85"=>[0,"\x85e"],"\x86"=>[0,"\x85i"],"\x87"=>[0,"\x85o"],"\x88"=>[0,"\x85s"],"\x89"=>[0,"\x85t"],"\x8A"=>[73,"\x85"],"\x8B"=>[88,"\x85"],"\x8C"=>[89,"\x85"],"\x8D"=>[96,"\x85"],"\x8E"=>[97,"\x85"],"\x8F"=>[99,"\x85"],"\x90"=>[106,"\x85"],"\x91"=>[136,"\x85"],"\x92"=>[139,"\x85"],"\x93"=>[141,"\x85"],"\x94"=>[145,"\x85"],"\x95"=>[147,"\x85"],"\x96"=>[149,"\x85"],"\x97"=>[101,"\x85"],"\x98"=>[112,"\x85"],"\x99"=>[117,"\x85"],"\x9A"=>[120,"\x85"],"\x9B"=>[124,"\x85"],"\x9C"=>[127,"\x85"],"\x9D"=>[144,"\x85"],"\x9E"=>[152,"\x85"],"\x9F"=>[11,"\x85"],"\xA0"=>[0,"\x860"],"\xA1"=>[0,"\x861"],"\xA2"=>[0,"\x862"],"\xA3"=>[0,"\x86a"],"\xA4"=>[0,"\x86c"],"\xA5"=>[0,"\x86e"],"\xA6"=>[0,"\x86i"],"\xA7"=>[0,"\x86o"],"\xA8"=>[0,"\x86s"],"\xA9"=>[0,"\x86t"],"\xAA"=>[73,"\x86"],"\xAB"=>[88,"\x86"],"\xAC"=>[89,"\x86"],"\xAD"=>[96,"\x86"],"\xAE"=>[97,"\x86"],"\xAF"=>[99,"\x86"],"\xB0"=>[106,"\x86"],"\xB1"=>[136,"\x86"],"\xB2"=>[139,"\x86"],"\xB3"=>[141,"\x86"],"\xB4"=>[145,"\x86"],"\xB5"=>[147,"\x86"],"\xB6"=>[149,"\x86"],"\xB7"=>[101,"\x86"],"\xB8"=>[112,"\x86"],"\xB9"=>[117,"\x86"],"\xBA"=>[120,"\x86"],"\xBB"=>[124,"\x86"],"\xBC"=>[127,"\x86"],"\xBD"=>[144,"\x86"],"\xBE"=>[152,"\x86"],"\xBF"=>[11,"\x86"],"\xC0"=>[0,"\x880"],"\xC1"=>[0,"\x881"],"\xC2"=>[0,"\x882"],"\xC3"=>[0,"\x88a"],"\xC4"=>[0,"\x88c"],"\xC5"=>[0,"\x88e"],"\xC6"=>[0,"\x88i"],"\xC7"=>[0,"\x88o"],"\xC8"=>[0,"\x88s"],"\xC9"=>[0,"\x88t"],"\xCA"=>[73,"\x88"],"\xCB"=>[88,"\x88"],"\xCC"=>[89,"\x88"],"\xCD"=>[96,"\x88"],"\xCE"=>[97,"\x88"],"\xCF"=>[99,"\x88"],"\xD0"=>[106,"\x88"],"\xD1"=>[136,"\x88"],"\xD2"=>[139,"\x88"],"\xD3"=>[141,"\x88"],"\xD4"=>[145,"\x88"],"\xD5"=>[147,"\x88"],"\xD6"=>[149,"\x88"],"\xD7"=>[101,"\x88"],"\xD8"=>[112,"\x88"],"\xD9"=>[117,"\x88"],"\xDA"=>[120,"\x88"],"\xDB"=>[124,"\x88"],"\xDC"=>[127,"\x88"],"\xDD"=>[144,"\x88"],"\xDE"=>[152,"\x88"],"\xDF"=>[11,"\x88"],"\xE0"=>[0,"\x920"],"\xE1"=>[0,"\x921"],"\xE2"=>[0,"\x922"],"\xE3"=>[0,"\x92a"],"\xE4"=>[0,"\x92c"],"\xE5"=>[0,"\x92e"],"\xE6"=>[0,"\x92i"],"\xE7"=>[0,"\x92o"],"\xE8"=>[0,"\x92s"],"\xE9"=>[0,"\x92t"],"\xEA"=>[73,"\x92"],"\xEB"=>[88,"\x92"],"\xEC"=>[89,"\x92"],"\xED"=>[96,"\x92"],"\xEE"=>[97,"\x92"],"\xEF"=>[99,"\x92"],"\xF0"=>[106,"\x92"],"\xF1"=>[136,"\x92"],"\xF2"=>[139,"\x92"],"\xF3"=>[141,"\x92"],"\xF4"=>[145,"\x92"],"\xF5"=>[147,"\x92"],"\xF6"=>[149,"\x92"],"\xF7"=>[101,"\x92"],"\xF8"=>[112,"\x92"],"\xF9"=>[117,"\x92"],"\xFA"=>[120,"\x92"],"\xFB"=>[124,"\x92"],"\xFC"=>[127,"\x92"],"\xFD"=>[144,"\x92"],"\xFE"=>[152,"\x92"],"\xFF"=>[11,"\x92"],],["\x00"=>[0,"\xE60"],"\x01"=>[0,"\xE61"],"\x02"=>[0,"\xE62"],"\x03"=>[0,"\xE6a"],"\x04"=>[0,"\xE6c"],"\x05"=>[0,"\xE6e"],"\x06"=>[0,"\xE6i"],"\x07"=>[0,"\xE6o"],"\x08"=>[0,"\xE6s"],"\x09"=>[0,"\xE6t"],"\x0A"=>[73,"\xE6"],"\x0B"=>[88,"\xE6"],"\x0C"=>[89,"\xE6"],"\x0D"=>[96,"\xE6"],"\x0E"=>[97,"\xE6"],"\x0F"=>[99,"\xE6"],"\x10"=>[106,"\xE6"],"\x11"=>[136,"\xE6"],"\x12"=>[139,"\xE6"],"\x13"=>[141,"\xE6"],"\x14"=>[145,"\xE6"],"\x15"=>[147,"\xE6"],"\x16"=>[149,"\xE6"],"\x17"=>[101,"\xE6"],"\x18"=>[112,"\xE6"],"\x19"=>[117,"\xE6"],"\x1A"=>[120,"\xE6"],"\x1B"=>[124,"\xE6"],"\x1C"=>[127,"\xE6"],"\x1D"=>[144,"\xE6"],"\x1E"=>[152,"\xE6"],"\x1F"=>[11,"\xE6"],"\x20"=>[92,"\x81"],"\x21"=>[95,"\x81"],"\x22"=>[137,"\x81"],"\x23"=>[142,"\x81"],"\x24"=>[150,"\x81"],"\x25"=>[74,"\x81"],"\x26"=>[90,"\x81"],"\x27"=>[98,"\x81"],"\x28"=>[107,"\x81"],"\x29"=>[140,"\x81"],"\x2A"=>[146,"\x81"],"\x2B"=>[102,"\x81"],"\x2C"=>[113,"\x81"],"-"=>[121,"\x81"],"."=>[128,"\x81"],"\x2F"=>[12,"\x81"],[92,"\x84"],[95,"\x84"],[137,"\x84"],[142,"\x84"],[150,"\x84"],[74,"\x84"],[90,"\x84"],[98,"\x84"],[107,"\x84"],[140,"\x84"],"\x3A"=>[146,"\x84"],"\x3B"=>[102,"\x84"],"\x3C"=>[113,"\x84"],"\x3D"=>[121,"\x84"],"\x3E"=>[128,"\x84"],"\x3F"=>[12,"\x84"],"\x40"=>[92,"\x85"],"A"=>[95,"\x85"],"B"=>[137,"\x85"],"C"=>[142,"\x85"],"D"=>[150,"\x85"],"E"=>[74,"\x85"],"F"=>[90,"\x85"],"G"=>[98,"\x85"],"H"=>[107,"\x85"],"I"=>[140,"\x85"],"J"=>[146,"\x85"],"K"=>[102,"\x85"],"L"=>[113,"\x85"],"M"=>[121,"\x85"],"N"=>[128,"\x85"],"O"=>[12,"\x85"],"P"=>[92,"\x86"],"Q"=>[95,"\x86"],"R"=>[137,"\x86"],"S"=>[142,"\x86"],"T"=>[150,"\x86"],"U"=>[74,"\x86"],"V"=>[90,"\x86"],"W"=>[98,"\x86"],"X"=>[107,"\x86"],"Y"=>[140,"\x86"],"Z"=>[146,"\x86"],"\x5B"=>[102,"\x86"],"\x5C"=>[113,"\x86"],"\x5D"=>[121,"\x86"],"\x5E"=>[128,"\x86"],"_"=>[12,"\x86"],"\x60"=>[92,"\x88"],"a"=>[95,"\x88"],"b"=>[137,"\x88"],"c"=>[142,"\x88"],"d"=>[150,"\x88"],"e"=>[74,"\x88"],"f"=>[90,"\x88"],"g"=>[98,"\x88"],"h"=>[107,"\x88"],"i"=>[140,"\x88"],"j"=>[146,"\x88"],"k"=>[102,"\x88"],"l"=>[113,"\x88"],"m"=>[121,"\x88"],"n"=>[128,"\x88"],"o"=>[12,"\x88"],"p"=>[92,"\x92"],"q"=>[95,"\x92"],"r"=>[137,"\x92"],"s"=>[142,"\x92"],"t"=>[150,"\x92"],"u"=>[74,"\x92"],"v"=>[90,"\x92"],"w"=>[98,"\x92"],"x"=>[107,"\x92"],"y"=>[140,"\x92"],"z"=>[146,"\x92"],"\x7B"=>[102,"\x92"],"\x7C"=>[113,"\x92"],"\x7D"=>[121,"\x92"],"~"=>[128,"\x92"],"\x7F"=>[12,"\x92"],"\x80"=>[92,"\x9A"],"\x81"=>[95,"\x9A"],"\x82"=>[137,"\x9A"],"\x83"=>[142,"\x9A"],"\x84"=>[150,"\x9A"],"\x85"=>[74,"\x9A"],"\x86"=>[90,"\x9A"],"\x87"=>[98,"\x9A"],"\x88"=>[107,"\x9A"],"\x89"=>[140,"\x9A"],"\x8A"=>[146,"\x9A"],"\x8B"=>[102,"\x9A"],"\x8C"=>[113,"\x9A"],"\x8D"=>[121,"\x9A"],"\x8E"=>[128,"\x9A"],"\x8F"=>[12,"\x9A"],"\x90"=>[92,"\x9C"],"\x91"=>[95,"\x9C"],"\x92"=>[137,"\x9C"],"\x93"=>[142,"\x9C"],"\x94"=>[150,"\x9C"],"\x95"=>[74,"\x9C"],"\x96"=>[90,"\x9C"],"\x97"=>[98,"\x9C"],"\x98"=>[107,"\x9C"],"\x99"=>[140,"\x9C"],"\x9A"=>[146,"\x9C"],"\x9B"=>[102,"\x9C"],"\x9C"=>[113,"\x9C"],"\x9D"=>[121,"\x9C"],"\x9E"=>[128,"\x9C"],"\x9F"=>[12,"\x9C"],"\xA0"=>[92,"\xA0"],"\xA1"=>[95,"\xA0"],"\xA2"=>[137,"\xA0"],"\xA3"=>[142,"\xA0"],"\xA4"=>[150,"\xA0"],"\xA5"=>[74,"\xA0"],"\xA6"=>[90,"\xA0"],"\xA7"=>[98,"\xA0"],"\xA8"=>[107,"\xA0"],"\xA9"=>[140,"\xA0"],"\xAA"=>[146,"\xA0"],"\xAB"=>[102,"\xA0"],"\xAC"=>[113,"\xA0"],"\xAD"=>[121,"\xA0"],"\xAE"=>[128,"\xA0"],"\xAF"=>[12,"\xA0"],"\xB0"=>[92,"\xA3"],"\xB1"=>[95,"\xA3"],"\xB2"=>[137,"\xA3"],"\xB3"=>[142,"\xA3"],"\xB4"=>[150,"\xA3"],"\xB5"=>[74,"\xA3"],"\xB6"=>[90,"\xA3"],"\xB7"=>[98,"\xA3"],"\xB8"=>[107,"\xA3"],"\xB9"=>[140,"\xA3"],"\xBA"=>[146,"\xA3"],"\xBB"=>[102,"\xA3"],"\xBC"=>[113,"\xA3"],"\xBD"=>[121,"\xA3"],"\xBE"=>[128,"\xA3"],"\xBF"=>[12,"\xA3"],"\xC0"=>[92,"\xA4"],"\xC1"=>[95,"\xA4"],"\xC2"=>[137,"\xA4"],"\xC3"=>[142,"\xA4"],"\xC4"=>[150,"\xA4"],"\xC5"=>[74,"\xA4"],"\xC6"=>[90,"\xA4"],"\xC7"=>[98,"\xA4"],"\xC8"=>[107,"\xA4"],"\xC9"=>[140,"\xA4"],"\xCA"=>[146,"\xA4"],"\xCB"=>[102,"\xA4"],"\xCC"=>[113,"\xA4"],"\xCD"=>[121,"\xA4"],"\xCE"=>[128,"\xA4"],"\xCF"=>[12,"\xA4"],"\xD0"=>[92,"\xA9"],"\xD1"=>[95,"\xA9"],"\xD2"=>[137,"\xA9"],"\xD3"=>[142,"\xA9"],"\xD4"=>[150,"\xA9"],"\xD5"=>[74,"\xA9"],"\xD6"=>[90,"\xA9"],"\xD7"=>[98,"\xA9"],"\xD8"=>[107,"\xA9"],"\xD9"=>[140,"\xA9"],"\xDA"=>[146,"\xA9"],"\xDB"=>[102,"\xA9"],"\xDC"=>[113,"\xA9"],"\xDD"=>[121,"\xA9"],"\xDE"=>[128,"\xA9"],"\xDF"=>[12,"\xA9"],"\xE0"=>[92,"\xAA"],"\xE1"=>[95,"\xAA"],"\xE2"=>[137,"\xAA"],"\xE3"=>[142,"\xAA"],"\xE4"=>[150,"\xAA"],"\xE5"=>[74,"\xAA"],"\xE6"=>[90,"\xAA"],"\xE7"=>[98,"\xAA"],"\xE8"=>[107,"\xAA"],"\xE9"=>[140,"\xAA"],"\xEA"=>[146,"\xAA"],"\xEB"=>[102,"\xAA"],"\xEC"=>[113,"\xAA"],"\xED"=>[121,"\xAA"],"\xEE"=>[128,"\xAA"],"\xEF"=>[12,"\xAA"],"\xF0"=>[92,"\xAD"],"\xF1"=>[95,"\xAD"],"\xF2"=>[137,"\xAD"],"\xF3"=>[142,"\xAD"],"\xF4"=>[150,"\xAD"],"\xF5"=>[74,"\xAD"],"\xF6"=>[90,"\xAD"],"\xF7"=>[98,"\xAD"],"\xF8"=>[107,"\xAD"],"\xF9"=>[140,"\xAD"],"\xFA"=>[146,"\xAD"],"\xFB"=>[102,"\xAD"],"\xFC"=>[113,"\xAD"],"\xFD"=>[121,"\xAD"],"\xFE"=>[128,"\xAD"],"\xFF"=>[12,"\xAD"],],["\x00"=>[92,"\xB0"],"\x01"=>[95,"\xB0"],"\x02"=>[137,"\xB0"],"\x03"=>[142,"\xB0"],"\x04"=>[150,"\xB0"],"\x05"=>[74,"\xB0"],"\x06"=>[90,"\xB0"],"\x07"=>[98,"\xB0"],"\x08"=>[107,"\xB0"],"\x09"=>[140,"\xB0"],"\x0A"=>[146,"\xB0"],"\x0B"=>[102,"\xB0"],"\x0C"=>[113,"\xB0"],"\x0D"=>[121,"\xB0"],"\x0E"=>[128,"\xB0"],"\x0F"=>[12,"\xB0"],"\x10"=>[92,"\xB1"],"\x11"=>[95,"\xB1"],"\x12"=>[137,"\xB1"],"\x13"=>[142,"\xB1"],"\x14"=>[150,"\xB1"],"\x15"=>[74,"\xB1"],"\x16"=>[90,"\xB1"],"\x17"=>[98,"\xB1"],"\x18"=>[107,"\xB1"],"\x19"=>[140,"\xB1"],"\x1A"=>[146,"\xB1"],"\x1B"=>[102,"\xB1"],"\x1C"=>[113,"\xB1"],"\x1D"=>[121,"\xB1"],"\x1E"=>[128,"\xB1"],"\x1F"=>[12,"\xB1"],"\x20"=>[92,"\xB3"],"\x21"=>[95,"\xB3"],"\x22"=>[137,"\xB3"],"\x23"=>[142,"\xB3"],"\x24"=>[150,"\xB3"],"\x25"=>[74,"\xB3"],"\x26"=>[90,"\xB3"],"\x27"=>[98,"\xB3"],"\x28"=>[107,"\xB3"],"\x29"=>[140,"\xB3"],"\x2A"=>[146,"\xB3"],"\x2B"=>[102,"\xB3"],"\x2C"=>[113,"\xB3"],"-"=>[121,"\xB3"],"."=>[128,"\xB3"],"\x2F"=>[12,"\xB3"],[92,"\xD1"],[95,"\xD1"],[137,"\xD1"],[142,"\xD1"],[150,"\xD1"],[74,"\xD1"],[90,"\xD1"],[98,"\xD1"],[107,"\xD1"],[140,"\xD1"],"\x3A"=>[146,"\xD1"],"\x3B"=>[102,"\xD1"],"\x3C"=>[113,"\xD1"],"\x3D"=>[121,"\xD1"],"\x3E"=>[128,"\xD1"],"\x3F"=>[12,"\xD1"],"\x40"=>[92,"\xD8"],"A"=>[95,"\xD8"],"B"=>[137,"\xD8"],"C"=>[142,"\xD8"],"D"=>[150,"\xD8"],"E"=>[74,"\xD8"],"F"=>[90,"\xD8"],"G"=>[98,"\xD8"],"H"=>[107,"\xD8"],"I"=>[140,"\xD8"],"J"=>[146,"\xD8"],"K"=>[102,"\xD8"],"L"=>[113,"\xD8"],"M"=>[121,"\xD8"],"N"=>[128,"\xD8"],"O"=>[12,"\xD8"],"P"=>[92,"\xD9"],"Q"=>[95,"\xD9"],"R"=>[137,"\xD9"],"S"=>[142,"\xD9"],"T"=>[150,"\xD9"],"U"=>[74,"\xD9"],"V"=>[90,"\xD9"],"W"=>[98,"\xD9"],"X"=>[107,"\xD9"],"Y"=>[140,"\xD9"],"Z"=>[146,"\xD9"],"\x5B"=>[102,"\xD9"],"\x5C"=>[113,"\xD9"],"\x5D"=>[121,"\xD9"],"\x5E"=>[128,"\xD9"],"_"=>[12,"\xD9"],"\x60"=>[92,"\xE3"],"a"=>[95,"\xE3"],"b"=>[137,"\xE3"],"c"=>[142,"\xE3"],"d"=>[150,"\xE3"],"e"=>[74,"\xE3"],"f"=>[90,"\xE3"],"g"=>[98,"\xE3"],"h"=>[107,"\xE3"],"i"=>[140,"\xE3"],"j"=>[146,"\xE3"],"k"=>[102,"\xE3"],"l"=>[113,"\xE3"],"m"=>[121,"\xE3"],"n"=>[128,"\xE3"],"o"=>[12,"\xE3"],"p"=>[92,"\xE5"],"q"=>[95,"\xE5"],"r"=>[137,"\xE5"],"s"=>[142,"\xE5"],"t"=>[150,"\xE5"],"u"=>[74,"\xE5"],"v"=>[90,"\xE5"],"w"=>[98,"\xE5"],"x"=>[107,"\xE5"],"y"=>[140,"\xE5"],"z"=>[146,"\xE5"],"\x7B"=>[102,"\xE5"],"\x7C"=>[113,"\xE5"],"\x7D"=>[121,"\xE5"],"~"=>[128,"\xE5"],"\x7F"=>[12,"\xE5"],"\x80"=>[92,"\xE6"],"\x81"=>[95,"\xE6"],"\x82"=>[137,"\xE6"],"\x83"=>[142,"\xE6"],"\x84"=>[150,"\xE6"],"\x85"=>[74,"\xE6"],"\x86"=>[90,"\xE6"],"\x87"=>[98,"\xE6"],"\x88"=>[107,"\xE6"],"\x89"=>[140,"\xE6"],"\x8A"=>[146,"\xE6"],"\x8B"=>[102,"\xE6"],"\x8C"=>[113,"\xE6"],"\x8D"=>[121,"\xE6"],"\x8E"=>[128,"\xE6"],"\x8F"=>[12,"\xE6"],"\x90"=>[93,"\x81"],"\x91"=>[138,"\x81"],"\x92"=>[75,"\x81"],"\x93"=>[91,"\x81"],"\x94"=>[108,"\x81"],"\x95"=>[103,"\x81"],"\x96"=>[114,"\x81"],"\x97"=>[14,"\x81"],"\x98"=>[93,"\x84"],"\x99"=>[138,"\x84"],"\x9A"=>[75,"\x84"],"\x9B"=>[91,"\x84"],"\x9C"=>[108,"\x84"],"\x9D"=>[103,"\x84"],"\x9E"=>[114,"\x84"],"\x9F"=>[14,"\x84"],"\xA0"=>[93,"\x85"],"\xA1"=>[138,"\x85"],"\xA2"=>[75,"\x85"],"\xA3"=>[91,"\x85"],"\xA4"=>[108,"\x85"],"\xA5"=>[103,"\x85"],"\xA6"=>[114,"\x85"],"\xA7"=>[14,"\x85"],"\xA8"=>[93,"\x86"],"\xA9"=>[138,"\x86"],"\xAA"=>[75,"\x86"],"\xAB"=>[91,"\x86"],"\xAC"=>[108,"\x86"],"\xAD"=>[103,"\x86"],"\xAE"=>[114,"\x86"],"\xAF"=>[14,"\x86"],"\xB0"=>[93,"\x88"],"\xB1"=>[138,"\x88"],"\xB2"=>[75,"\x88"],"\xB3"=>[91,"\x88"],"\xB4"=>[108,"\x88"],"\xB5"=>[103,"\x88"],"\xB6"=>[114,"\x88"],"\xB7"=>[14,"\x88"],"\xB8"=>[93,"\x92"],"\xB9"=>[138,"\x92"],"\xBA"=>[75,"\x92"],"\xBB"=>[91,"\x92"],"\xBC"=>[108,"\x92"],"\xBD"=>[103,"\x92"],"\xBE"=>[114,"\x92"],"\xBF"=>[14,"\x92"],"\xC0"=>[93,"\x9A"],"\xC1"=>[138,"\x9A"],"\xC2"=>[75,"\x9A"],"\xC3"=>[91,"\x9A"],"\xC4"=>[108,"\x9A"],"\xC5"=>[103,"\x9A"],"\xC6"=>[114,"\x9A"],"\xC7"=>[14,"\x9A"],"\xC8"=>[93,"\x9C"],"\xC9"=>[138,"\x9C"],"\xCA"=>[75,"\x9C"],"\xCB"=>[91,"\x9C"],"\xCC"=>[108,"\x9C"],"\xCD"=>[103,"\x9C"],"\xCE"=>[114,"\x9C"],"\xCF"=>[14,"\x9C"],"\xD0"=>[93,"\xA0"],"\xD1"=>[138,"\xA0"],"\xD2"=>[75,"\xA0"],"\xD3"=>[91,"\xA0"],"\xD4"=>[108,"\xA0"],"\xD5"=>[103,"\xA0"],"\xD6"=>[114,"\xA0"],"\xD7"=>[14,"\xA0"],"\xD8"=>[93,"\xA3"],"\xD9"=>[138,"\xA3"],"\xDA"=>[75,"\xA3"],"\xDB"=>[91,"\xA3"],"\xDC"=>[108,"\xA3"],"\xDD"=>[103,"\xA3"],"\xDE"=>[114,"\xA3"],"\xDF"=>[14,"\xA3"],"\xE0"=>[93,"\xA4"],"\xE1"=>[138,"\xA4"],"\xE2"=>[75,"\xA4"],"\xE3"=>[91,"\xA4"],"\xE4"=>[108,"\xA4"],"\xE5"=>[103,"\xA4"],"\xE6"=>[114,"\xA4"],"\xE7"=>[14,"\xA4"],"\xE8"=>[93,"\xA9"],"\xE9"=>[138,"\xA9"],"\xEA"=>[75,"\xA9"],"\xEB"=>[91,"\xA9"],"\xEC"=>[108,"\xA9"],"\xED"=>[103,"\xA9"],"\xEE"=>[114,"\xA9"],"\xEF"=>[14,"\xA9"],"\xF0"=>[93,"\xAA"],"\xF1"=>[138,"\xAA"],"\xF2"=>[75,"\xAA"],"\xF3"=>[91,"\xAA"],"\xF4"=>[108,"\xAA"],"\xF5"=>[103,"\xAA"],"\xF6"=>[114,"\xAA"],"\xF7"=>[14,"\xAA"],"\xF8"=>[93,"\xAD"],"\xF9"=>[138,"\xAD"],"\xFA"=>[75,"\xAD"],"\xFB"=>[91,"\xAD"],"\xFC"=>[108,"\xAD"],"\xFD"=>[103,"\xAD"],"\xFE"=>[114,"\xAD"],"\xFF"=>[14,"\xAD"],],["\x00"=>[94,"\x830"],"\x01"=>[76,"\x830"],"\x02"=>[104,"\x830"],"\x03"=>[16,"\x830"],"\x04"=>[94,"\x831"],"\x05"=>[76,"\x831"],"\x06"=>[104,"\x831"],"\x07"=>[16,"\x831"],"\x08"=>[94,"\x832"],"\x09"=>[76,"\x832"],"\x0A"=>[104,"\x832"],"\x0B"=>[16,"\x832"],"\x0C"=>[94,"\x83a"],"\x0D"=>[76,"\x83a"],"\x0E"=>[104,"\x83a"],"\x0F"=>[16,"\x83a"],"\x10"=>[94,"\x83c"],"\x11"=>[76,"\x83c"],"\x12"=>[104,"\x83c"],"\x13"=>[16,"\x83c"],"\x14"=>[94,"\x83e"],"\x15"=>[76,"\x83e"],"\x16"=>[104,"\x83e"],"\x17"=>[16,"\x83e"],"\x18"=>[94,"\x83i"],"\x19"=>[76,"\x83i"],"\x1A"=>[104,"\x83i"],"\x1B"=>[16,"\x83i"],"\x1C"=>[94,"\x83o"],"\x1D"=>[76,"\x83o"],"\x1E"=>[104,"\x83o"],"\x1F"=>[16,"\x83o"],"\x20"=>[94,"\x83s"],"\x21"=>[76,"\x83s"],"\x22"=>[104,"\x83s"],"\x23"=>[16,"\x83s"],"\x24"=>[94,"\x83t"],"\x25"=>[76,"\x83t"],"\x26"=>[104,"\x83t"],"\x27"=>[16,"\x83t"],"\x28"=>[77,"\x83\x20"],"\x29"=>[18,"\x83\x20"],"\x2A"=>[77,"\x83\x25"],"\x2B"=>[18,"\x83\x25"],"\x2C"=>[77,"\x83-"],"-"=>[18,"\x83-"],"."=>[77,"\x83."],"\x2F"=>[18,"\x83."],[77,"\x83\x2F"],[18,"\x83\x2F"],[77,"\x833"],[18,"\x833"],[77,"\x834"],[18,"\x834"],[77,"\x835"],[18,"\x835"],[77,"\x836"],[18,"\x836"],"\x3A"=>[77,"\x837"],"\x3B"=>[18,"\x837"],"\x3C"=>[77,"\x838"],"\x3D"=>[18,"\x838"],"\x3E"=>[77,"\x839"],"\x3F"=>[18,"\x839"],"\x40"=>[77,"\x83\x3D"],"A"=>[18,"\x83\x3D"],"B"=>[77,"\x83A"],"C"=>[18,"\x83A"],"D"=>[77,"\x83_"],"E"=>[18,"\x83_"],"F"=>[77,"\x83b"],"G"=>[18,"\x83b"],"H"=>[77,"\x83d"],"I"=>[18,"\x83d"],"J"=>[77,"\x83f"],"K"=>[18,"\x83f"],"L"=>[77,"\x83g"],"M"=>[18,"\x83g"],"N"=>[77,"\x83h"],"O"=>[18,"\x83h"],"P"=>[77,"\x83l"],"Q"=>[18,"\x83l"],"R"=>[77,"\x83m"],"S"=>[18,"\x83m"],"T"=>[77,"\x83n"],"U"=>[18,"\x83n"],"V"=>[77,"\x83p"],"W"=>[18,"\x83p"],"X"=>[77,"\x83r"],"Y"=>[18,"\x83r"],"Z"=>[77,"\x83u"],"\x5B"=>[18,"\x83u"],"\x5C"=>[0,"\x83\x3A"],"\x5D"=>[0,"\x83B"],"\x5E"=>[0,"\x83C"],"_"=>[0,"\x83D"],"\x60"=>[0,"\x83E"],"a"=>[0,"\x83F"],"b"=>[0,"\x83G"],"c"=>[0,"\x83H"],"d"=>[0,"\x83I"],"e"=>[0,"\x83J"],"f"=>[0,"\x83K"],"g"=>[0,"\x83L"],"h"=>[0,"\x83M"],"i"=>[0,"\x83N"],"j"=>[0,"\x83O"],"k"=>[0,"\x83P"],"l"=>[0,"\x83Q"],"m"=>[0,"\x83R"],"n"=>[0,"\x83S"],"o"=>[0,"\x83T"],"p"=>[0,"\x83U"],"q"=>[0,"\x83V"],"r"=>[0,"\x83W"],"s"=>[0,"\x83Y"],"t"=>[0,"\x83j"],"u"=>[0,"\x83k"],"v"=>[0,"\x83q"],"w"=>[0,"\x83v"],"x"=>[0,"\x83w"],"y"=>[0,"\x83x"],"z"=>[0,"\x83y"],"\x7B"=>[0,"\x83z"],"\x7C"=>[82,"\x83"],"\x7D"=>[87,"\x83"],"~"=>[130,"\x83"],"\x7F"=>[9,"\x83"],"\x80"=>[94,"\xA20"],"\x81"=>[76,"\xA20"],"\x82"=>[104,"\xA20"],"\x83"=>[16,"\xA20"],"\x84"=>[94,"\xA21"],"\x85"=>[76,"\xA21"],"\x86"=>[104,"\xA21"],"\x87"=>[16,"\xA21"],"\x88"=>[94,"\xA22"],"\x89"=>[76,"\xA22"],"\x8A"=>[104,"\xA22"],"\x8B"=>[16,"\xA22"],"\x8C"=>[94,"\xA2a"],"\x8D"=>[76,"\xA2a"],"\x8E"=>[104,"\xA2a"],"\x8F"=>[16,"\xA2a"],"\x90"=>[94,"\xA2c"],"\x91"=>[76,"\xA2c"],"\x92"=>[104,"\xA2c"],"\x93"=>[16,"\xA2c"],"\x94"=>[94,"\xA2e"],"\x95"=>[76,"\xA2e"],"\x96"=>[104,"\xA2e"],"\x97"=>[16,"\xA2e"],"\x98"=>[94,"\xA2i"],"\x99"=>[76,"\xA2i"],"\x9A"=>[104,"\xA2i"],"\x9B"=>[16,"\xA2i"],"\x9C"=>[94,"\xA2o"],"\x9D"=>[76,"\xA2o"],"\x9E"=>[104,"\xA2o"],"\x9F"=>[16,"\xA2o"],"\xA0"=>[94,"\xA2s"],"\xA1"=>[76,"\xA2s"],"\xA2"=>[104,"\xA2s"],"\xA3"=>[16,"\xA2s"],"\xA4"=>[94,"\xA2t"],"\xA5"=>[76,"\xA2t"],"\xA6"=>[104,"\xA2t"],"\xA7"=>[16,"\xA2t"],"\xA8"=>[77,"\xA2\x20"],"\xA9"=>[18,"\xA2\x20"],"\xAA"=>[77,"\xA2\x25"],"\xAB"=>[18,"\xA2\x25"],"\xAC"=>[77,"\xA2-"],"\xAD"=>[18,"\xA2-"],"\xAE"=>[77,"\xA2."],"\xAF"=>[18,"\xA2."],"\xB0"=>[77,"\xA2\x2F"],"\xB1"=>[18,"\xA2\x2F"],"\xB2"=>[77,"\xA23"],"\xB3"=>[18,"\xA23"],"\xB4"=>[77,"\xA24"],"\xB5"=>[18,"\xA24"],"\xB6"=>[77,"\xA25"],"\xB7"=>[18,"\xA25"],"\xB8"=>[77,"\xA26"],"\xB9"=>[18,"\xA26"],"\xBA"=>[77,"\xA27"],"\xBB"=>[18,"\xA27"],"\xBC"=>[77,"\xA28"],"\xBD"=>[18,"\xA28"],"\xBE"=>[77,"\xA29"],"\xBF"=>[18,"\xA29"],"\xC0"=>[77,"\xA2\x3D"],"\xC1"=>[18,"\xA2\x3D"],"\xC2"=>[77,"\xA2A"],"\xC3"=>[18,"\xA2A"],"\xC4"=>[77,"\xA2_"],"\xC5"=>[18,"\xA2_"],"\xC6"=>[77,"\xA2b"],"\xC7"=>[18,"\xA2b"],"\xC8"=>[77,"\xA2d"],"\xC9"=>[18,"\xA2d"],"\xCA"=>[77,"\xA2f"],"\xCB"=>[18,"\xA2f"],"\xCC"=>[77,"\xA2g"],"\xCD"=>[18,"\xA2g"],"\xCE"=>[77,"\xA2h"],"\xCF"=>[18,"\xA2h"],"\xD0"=>[77,"\xA2l"],"\xD1"=>[18,"\xA2l"],"\xD2"=>[77,"\xA2m"],"\xD3"=>[18,"\xA2m"],"\xD4"=>[77,"\xA2n"],"\xD5"=>[18,"\xA2n"],"\xD6"=>[77,"\xA2p"],"\xD7"=>[18,"\xA2p"],"\xD8"=>[77,"\xA2r"],"\xD9"=>[18,"\xA2r"],"\xDA"=>[77,"\xA2u"],"\xDB"=>[18,"\xA2u"],"\xDC"=>[0,"\xA2\x3A"],"\xDD"=>[0,"\xA2B"],"\xDE"=>[0,"\xA2C"],"\xDF"=>[0,"\xA2D"],"\xE0"=>[0,"\xA2E"],"\xE1"=>[0,"\xA2F"],"\xE2"=>[0,"\xA2G"],"\xE3"=>[0,"\xA2H"],"\xE4"=>[0,"\xA2I"],"\xE5"=>[0,"\xA2J"],"\xE6"=>[0,"\xA2K"],"\xE7"=>[0,"\xA2L"],"\xE8"=>[0,"\xA2M"],"\xE9"=>[0,"\xA2N"],"\xEA"=>[0,"\xA2O"],"\xEB"=>[0,"\xA2P"],"\xEC"=>[0,"\xA2Q"],"\xED"=>[0,"\xA2R"],"\xEE"=>[0,"\xA2S"],"\xEF"=>[0,"\xA2T"],"\xF0"=>[0,"\xA2U"],"\xF1"=>[0,"\xA2V"],"\xF2"=>[0,"\xA2W"],"\xF3"=>[0,"\xA2Y"],"\xF4"=>[0,"\xA2j"],"\xF5"=>[0,"\xA2k"],"\xF6"=>[0,"\xA2q"],"\xF7"=>[0,"\xA2v"],"\xF8"=>[0,"\xA2w"],"\xF9"=>[0,"\xA2x"],"\xFA"=>[0,"\xA2y"],"\xFB"=>[0,"\xA2z"],"\xFC"=>[82,"\xA2"],"\xFD"=>[87,"\xA2"],"\xFE"=>[130,"\xA2"],"\xFF"=>[9,"\xA2"],],["\x00"=>[77,"\x830"],"\x01"=>[18,"\x830"],"\x02"=>[77,"\x831"],"\x03"=>[18,"\x831"],"\x04"=>[77,"\x832"],"\x05"=>[18,"\x832"],"\x06"=>[77,"\x83a"],"\x07"=>[18,"\x83a"],"\x08"=>[77,"\x83c"],"\x09"=>[18,"\x83c"],"\x0A"=>[77,"\x83e"],"\x0B"=>[18,"\x83e"],"\x0C"=>[77,"\x83i"],"\x0D"=>[18,"\x83i"],"\x0E"=>[77,"\x83o"],"\x0F"=>[18,"\x83o"],"\x10"=>[77,"\x83s"],"\x11"=>[18,"\x83s"],"\x12"=>[77,"\x83t"],"\x13"=>[18,"\x83t"],"\x14"=>[0,"\x83\x20"],"\x15"=>[0,"\x83\x25"],"\x16"=>[0,"\x83-"],"\x17"=>[0,"\x83."],"\x18"=>[0,"\x83\x2F"],"\x19"=>[0,"\x833"],"\x1A"=>[0,"\x834"],"\x1B"=>[0,"\x835"],"\x1C"=>[0,"\x836"],"\x1D"=>[0,"\x837"],"\x1E"=>[0,"\x838"],"\x1F"=>[0,"\x839"],"\x20"=>[0,"\x83\x3D"],"\x21"=>[0,"\x83A"],"\x22"=>[0,"\x83_"],"\x23"=>[0,"\x83b"],"\x24"=>[0,"\x83d"],"\x25"=>[0,"\x83f"],"\x26"=>[0,"\x83g"],"\x27"=>[0,"\x83h"],"\x28"=>[0,"\x83l"],"\x29"=>[0,"\x83m"],"\x2A"=>[0,"\x83n"],"\x2B"=>[0,"\x83p"],"\x2C"=>[0,"\x83r"],"-"=>[0,"\x83u"],"."=>[100,"\x83"],"\x2F"=>[110,"\x83"],[111,"\x83"],[115,"\x83"],[116,"\x83"],[118,"\x83"],[119,"\x83"],[122,"\x83"],[123,"\x83"],[125,"\x83"],[126,"\x83"],[129,"\x83"],"\x3A"=>[143,"\x83"],"\x3B"=>[148,"\x83"],"\x3C"=>[151,"\x83"],"\x3D"=>[153,"\x83"],"\x3E"=>[83,"\x83"],"\x3F"=>[10,"\x83"],"\x40"=>[77,"\xA20"],"A"=>[18,"\xA20"],"B"=>[77,"\xA21"],"C"=>[18,"\xA21"],"D"=>[77,"\xA22"],"E"=>[18,"\xA22"],"F"=>[77,"\xA2a"],"G"=>[18,"\xA2a"],"H"=>[77,"\xA2c"],"I"=>[18,"\xA2c"],"J"=>[77,"\xA2e"],"K"=>[18,"\xA2e"],"L"=>[77,"\xA2i"],"M"=>[18,"\xA2i"],"N"=>[77,"\xA2o"],"O"=>[18,"\xA2o"],"P"=>[77,"\xA2s"],"Q"=>[18,"\xA2s"],"R"=>[77,"\xA2t"],"S"=>[18,"\xA2t"],"T"=>[0,"\xA2\x20"],"U"=>[0,"\xA2\x25"],"V"=>[0,"\xA2-"],"W"=>[0,"\xA2."],"X"=>[0,"\xA2\x2F"],"Y"=>[0,"\xA23"],"Z"=>[0,"\xA24"],"\x5B"=>[0,"\xA25"],"\x5C"=>[0,"\xA26"],"\x5D"=>[0,"\xA27"],"\x5E"=>[0,"\xA28"],"_"=>[0,"\xA29"],"\x60"=>[0,"\xA2\x3D"],"a"=>[0,"\xA2A"],"b"=>[0,"\xA2_"],"c"=>[0,"\xA2b"],"d"=>[0,"\xA2d"],"e"=>[0,"\xA2f"],"f"=>[0,"\xA2g"],"g"=>[0,"\xA2h"],"h"=>[0,"\xA2l"],"i"=>[0,"\xA2m"],"j"=>[0,"\xA2n"],"k"=>[0,"\xA2p"],"l"=>[0,"\xA2r"],"m"=>[0,"\xA2u"],"n"=>[100,"\xA2"],"o"=>[110,"\xA2"],"p"=>[111,"\xA2"],"q"=>[115,"\xA2"],"r"=>[116,"\xA2"],"s"=>[118,"\xA2"],"t"=>[119,"\xA2"],"u"=>[122,"\xA2"],"v"=>[123,"\xA2"],"w"=>[125,"\xA2"],"x"=>[126,"\xA2"],"y"=>[129,"\xA2"],"z"=>[143,"\xA2"],"\x7B"=>[148,"\xA2"],"\x7C"=>[151,"\xA2"],"\x7D"=>[153,"\xA2"],"~"=>[83,"\xA2"],"\x7F"=>[10,"\xA2"],"\x80"=>[77,"\xB80"],"\x81"=>[18,"\xB80"],"\x82"=>[77,"\xB81"],"\x83"=>[18,"\xB81"],"\x84"=>[77,"\xB82"],"\x85"=>[18,"\xB82"],"\x86"=>[77,"\xB8a"],"\x87"=>[18,"\xB8a"],"\x88"=>[77,"\xB8c"],"\x89"=>[18,"\xB8c"],"\x8A"=>[77,"\xB8e"],"\x8B"=>[18,"\xB8e"],"\x8C"=>[77,"\xB8i"],"\x8D"=>[18,"\xB8i"],"\x8E"=>[77,"\xB8o"],"\x8F"=>[18,"\xB8o"],"\x90"=>[77,"\xB8s"],"\x91"=>[18,"\xB8s"],"\x92"=>[77,"\xB8t"],"\x93"=>[18,"\xB8t"],"\x94"=>[0,"\xB8\x20"],"\x95"=>[0,"\xB8\x25"],"\x96"=>[0,"\xB8-"],"\x97"=>[0,"\xB8."],"\x98"=>[0,"\xB8\x2F"],"\x99"=>[0,"\xB83"],"\x9A"=>[0,"\xB84"],"\x9B"=>[0,"\xB85"],"\x9C"=>[0,"\xB86"],"\x9D"=>[0,"\xB87"],"\x9E"=>[0,"\xB88"],"\x9F"=>[0,"\xB89"],"\xA0"=>[0,"\xB8\x3D"],"\xA1"=>[0,"\xB8A"],"\xA2"=>[0,"\xB8_"],"\xA3"=>[0,"\xB8b"],"\xA4"=>[0,"\xB8d"],"\xA5"=>[0,"\xB8f"],"\xA6"=>[0,"\xB8g"],"\xA7"=>[0,"\xB8h"],"\xA8"=>[0,"\xB8l"],"\xA9"=>[0,"\xB8m"],"\xAA"=>[0,"\xB8n"],"\xAB"=>[0,"\xB8p"],"\xAC"=>[0,"\xB8r"],"\xAD"=>[0,"\xB8u"],"\xAE"=>[100,"\xB8"],"\xAF"=>[110,"\xB8"],"\xB0"=>[111,"\xB8"],"\xB1"=>[115,"\xB8"],"\xB2"=>[116,"\xB8"],"\xB3"=>[118,"\xB8"],"\xB4"=>[119,"\xB8"],"\xB5"=>[122,"\xB8"],"\xB6"=>[123,"\xB8"],"\xB7"=>[125,"\xB8"],"\xB8"=>[126,"\xB8"],"\xB9"=>[129,"\xB8"],"\xBA"=>[143,"\xB8"],"\xBB"=>[148,"\xB8"],"\xBC"=>[151,"\xB8"],"\xBD"=>[153,"\xB8"],"\xBE"=>[83,"\xB8"],"\xBF"=>[10,"\xB8"],"\xC0"=>[77,"\xC20"],"\xC1"=>[18,"\xC20"],"\xC2"=>[77,"\xC21"],"\xC3"=>[18,"\xC21"],"\xC4"=>[77,"\xC22"],"\xC5"=>[18,"\xC22"],"\xC6"=>[77,"\xC2a"],"\xC7"=>[18,"\xC2a"],"\xC8"=>[77,"\xC2c"],"\xC9"=>[18,"\xC2c"],"\xCA"=>[77,"\xC2e"],"\xCB"=>[18,"\xC2e"],"\xCC"=>[77,"\xC2i"],"\xCD"=>[18,"\xC2i"],"\xCE"=>[77,"\xC2o"],"\xCF"=>[18,"\xC2o"],"\xD0"=>[77,"\xC2s"],"\xD1"=>[18,"\xC2s"],"\xD2"=>[77,"\xC2t"],"\xD3"=>[18,"\xC2t"],"\xD4"=>[0,"\xC2\x20"],"\xD5"=>[0,"\xC2\x25"],"\xD6"=>[0,"\xC2-"],"\xD7"=>[0,"\xC2."],"\xD8"=>[0,"\xC2\x2F"],"\xD9"=>[0,"\xC23"],"\xDA"=>[0,"\xC24"],"\xDB"=>[0,"\xC25"],"\xDC"=>[0,"\xC26"],"\xDD"=>[0,"\xC27"],"\xDE"=>[0,"\xC28"],"\xDF"=>[0,"\xC29"],"\xE0"=>[0,"\xC2\x3D"],"\xE1"=>[0,"\xC2A"],"\xE2"=>[0,"\xC2_"],"\xE3"=>[0,"\xC2b"],"\xE4"=>[0,"\xC2d"],"\xE5"=>[0,"\xC2f"],"\xE6"=>[0,"\xC2g"],"\xE7"=>[0,"\xC2h"],"\xE8"=>[0,"\xC2l"],"\xE9"=>[0,"\xC2m"],"\xEA"=>[0,"\xC2n"],"\xEB"=>[0,"\xC2p"],"\xEC"=>[0,"\xC2r"],"\xED"=>[0,"\xC2u"],"\xEE"=>[100,"\xC2"],"\xEF"=>[110,"\xC2"],"\xF0"=>[111,"\xC2"],"\xF1"=>[115,"\xC2"],"\xF2"=>[116,"\xC2"],"\xF3"=>[118,"\xC2"],"\xF4"=>[119,"\xC2"],"\xF5"=>[122,"\xC2"],"\xF6"=>[123,"\xC2"],"\xF7"=>[125,"\xC2"],"\xF8"=>[126,"\xC2"],"\xF9"=>[129,"\xC2"],"\xFA"=>[143,"\xC2"],"\xFB"=>[148,"\xC2"],"\xFC"=>[151,"\xC2"],"\xFD"=>[153,"\xC2"],"\xFE"=>[83,"\xC2"],"\xFF"=>[10,"\xC2"],],["\x00"=>[0,"\x830"],"\x01"=>[0,"\x831"],"\x02"=>[0,"\x832"],"\x03"=>[0,"\x83a"],"\x04"=>[0,"\x83c"],"\x05"=>[0,"\x83e"],"\x06"=>[0,"\x83i"],"\x07"=>[0,"\x83o"],"\x08"=>[0,"\x83s"],"\x09"=>[0,"\x83t"],"\x0A"=>[73,"\x83"],"\x0B"=>[88,"\x83"],"\x0C"=>[89,"\x83"],"\x0D"=>[96,"\x83"],"\x0E"=>[97,"\x83"],"\x0F"=>[99,"\x83"],"\x10"=>[106,"\x83"],"\x11"=>[136,"\x83"],"\x12"=>[139,"\x83"],"\x13"=>[141,"\x83"],"\x14"=>[145,"\x83"],"\x15"=>[147,"\x83"],"\x16"=>[149,"\x83"],"\x17"=>[101,"\x83"],"\x18"=>[112,"\x83"],"\x19"=>[117,"\x83"],"\x1A"=>[120,"\x83"],"\x1B"=>[124,"\x83"],"\x1C"=>[127,"\x83"],"\x1D"=>[144,"\x83"],"\x1E"=>[152,"\x83"],"\x1F"=>[11,"\x83"],"\x20"=>[0,"\xA20"],"\x21"=>[0,"\xA21"],"\x22"=>[0,"\xA22"],"\x23"=>[0,"\xA2a"],"\x24"=>[0,"\xA2c"],"\x25"=>[0,"\xA2e"],"\x26"=>[0,"\xA2i"],"\x27"=>[0,"\xA2o"],"\x28"=>[0,"\xA2s"],"\x29"=>[0,"\xA2t"],"\x2A"=>[73,"\xA2"],"\x2B"=>[88,"\xA2"],"\x2C"=>[89,"\xA2"],"-"=>[96,"\xA2"],"."=>[97,"\xA2"],"\x2F"=>[99,"\xA2"],[106,"\xA2"],[136,"\xA2"],[139,"\xA2"],[141,"\xA2"],[145,"\xA2"],[147,"\xA2"],[149,"\xA2"],[101,"\xA2"],[112,"\xA2"],[117,"\xA2"],"\x3A"=>[120,"\xA2"],"\x3B"=>[124,"\xA2"],"\x3C"=>[127,"\xA2"],"\x3D"=>[144,"\xA2"],"\x3E"=>[152,"\xA2"],"\x3F"=>[11,"\xA2"],"\x40"=>[0,"\xB80"],"A"=>[0,"\xB81"],"B"=>[0,"\xB82"],"C"=>[0,"\xB8a"],"D"=>[0,"\xB8c"],"E"=>[0,"\xB8e"],"F"=>[0,"\xB8i"],"G"=>[0,"\xB8o"],"H"=>[0,"\xB8s"],"I"=>[0,"\xB8t"],"J"=>[73,"\xB8"],"K"=>[88,"\xB8"],"L"=>[89,"\xB8"],"M"=>[96,"\xB8"],"N"=>[97,"\xB8"],"O"=>[99,"\xB8"],"P"=>[106,"\xB8"],"Q"=>[136,"\xB8"],"R"=>[139,"\xB8"],"S"=>[141,"\xB8"],"T"=>[145,"\xB8"],"U"=>[147,"\xB8"],"V"=>[149,"\xB8"],"W"=>[101,"\xB8"],"X"=>[112,"\xB8"],"Y"=>[117,"\xB8"],"Z"=>[120,"\xB8"],"\x5B"=>[124,"\xB8"],"\x5C"=>[127,"\xB8"],"\x5D"=>[144,"\xB8"],"\x5E"=>[152,"\xB8"],"_"=>[11,"\xB8"],"\x60"=>[0,"\xC20"],"a"=>[0,"\xC21"],"b"=>[0,"\xC22"],"c"=>[0,"\xC2a"],"d"=>[0,"\xC2c"],"e"=>[0,"\xC2e"],"f"=>[0,"\xC2i"],"g"=>[0,"\xC2o"],"h"=>[0,"\xC2s"],"i"=>[0,"\xC2t"],"j"=>[73,"\xC2"],"k"=>[88,"\xC2"],"l"=>[89,"\xC2"],"m"=>[96,"\xC2"],"n"=>[97,"\xC2"],"o"=>[99,"\xC2"],"p"=>[106,"\xC2"],"q"=>[136,"\xC2"],"r"=>[139,"\xC2"],"s"=>[141,"\xC2"],"t"=>[145,"\xC2"],"u"=>[147,"\xC2"],"v"=>[149,"\xC2"],"w"=>[101,"\xC2"],"x"=>[112,"\xC2"],"y"=>[117,"\xC2"],"z"=>[120,"\xC2"],"\x7B"=>[124,"\xC2"],"\x7C"=>[127,"\xC2"],"\x7D"=>[144,"\xC2"],"~"=>[152,"\xC2"],"\x7F"=>[11,"\xC2"],"\x80"=>[0,"\xE00"],"\x81"=>[0,"\xE01"],"\x82"=>[0,"\xE02"],"\x83"=>[0,"\xE0a"],"\x84"=>[0,"\xE0c"],"\x85"=>[0,"\xE0e"],"\x86"=>[0,"\xE0i"],"\x87"=>[0,"\xE0o"],"\x88"=>[0,"\xE0s"],"\x89"=>[0,"\xE0t"],"\x8A"=>[73,"\xE0"],"\x8B"=>[88,"\xE0"],"\x8C"=>[89,"\xE0"],"\x8D"=>[96,"\xE0"],"\x8E"=>[97,"\xE0"],"\x8F"=>[99,"\xE0"],"\x90"=>[106,"\xE0"],"\x91"=>[136,"\xE0"],"\x92"=>[139,"\xE0"],"\x93"=>[141,"\xE0"],"\x94"=>[145,"\xE0"],"\x95"=>[147,"\xE0"],"\x96"=>[149,"\xE0"],"\x97"=>[101,"\xE0"],"\x98"=>[112,"\xE0"],"\x99"=>[117,"\xE0"],"\x9A"=>[120,"\xE0"],"\x9B"=>[124,"\xE0"],"\x9C"=>[127,"\xE0"],"\x9D"=>[144,"\xE0"],"\x9E"=>[152,"\xE0"],"\x9F"=>[11,"\xE0"],"\xA0"=>[0,"\xE20"],"\xA1"=>[0,"\xE21"],"\xA2"=>[0,"\xE22"],"\xA3"=>[0,"\xE2a"],"\xA4"=>[0,"\xE2c"],"\xA5"=>[0,"\xE2e"],"\xA6"=>[0,"\xE2i"],"\xA7"=>[0,"\xE2o"],"\xA8"=>[0,"\xE2s"],"\xA9"=>[0,"\xE2t"],"\xAA"=>[73,"\xE2"],"\xAB"=>[88,"\xE2"],"\xAC"=>[89,"\xE2"],"\xAD"=>[96,"\xE2"],"\xAE"=>[97,"\xE2"],"\xAF"=>[99,"\xE2"],"\xB0"=>[106,"\xE2"],"\xB1"=>[136,"\xE2"],"\xB2"=>[139,"\xE2"],"\xB3"=>[141,"\xE2"],"\xB4"=>[145,"\xE2"],"\xB5"=>[147,"\xE2"],"\xB6"=>[149,"\xE2"],"\xB7"=>[101,"\xE2"],"\xB8"=>[112,"\xE2"],"\xB9"=>[117,"\xE2"],"\xBA"=>[120,"\xE2"],"\xBB"=>[124,"\xE2"],"\xBC"=>[127,"\xE2"],"\xBD"=>[144,"\xE2"],"\xBE"=>[152,"\xE2"],"\xBF"=>[11,"\xE2"],"\xC0"=>[92,"\x99"],"\xC1"=>[95,"\x99"],"\xC2"=>[137,"\x99"],"\xC3"=>[142,"\x99"],"\xC4"=>[150,"\x99"],"\xC5"=>[74,"\x99"],"\xC6"=>[90,"\x99"],"\xC7"=>[98,"\x99"],"\xC8"=>[107,"\x99"],"\xC9"=>[140,"\x99"],"\xCA"=>[146,"\x99"],"\xCB"=>[102,"\x99"],"\xCC"=>[113,"\x99"],"\xCD"=>[121,"\x99"],"\xCE"=>[128,"\x99"],"\xCF"=>[12,"\x99"],"\xD0"=>[92,"\xA1"],"\xD1"=>[95,"\xA1"],"\xD2"=>[137,"\xA1"],"\xD3"=>[142,"\xA1"],"\xD4"=>[150,"\xA1"],"\xD5"=>[74,"\xA1"],"\xD6"=>[90,"\xA1"],"\xD7"=>[98,"\xA1"],"\xD8"=>[107,"\xA1"],"\xD9"=>[140,"\xA1"],"\xDA"=>[146,"\xA1"],"\xDB"=>[102,"\xA1"],"\xDC"=>[113,"\xA1"],"\xDD"=>[121,"\xA1"],"\xDE"=>[128,"\xA1"],"\xDF"=>[12,"\xA1"],"\xE0"=>[92,"\xA7"],"\xE1"=>[95,"\xA7"],"\xE2"=>[137,"\xA7"],"\xE3"=>[142,"\xA7"],"\xE4"=>[150,"\xA7"],"\xE5"=>[74,"\xA7"],"\xE6"=>[90,"\xA7"],"\xE7"=>[98,"\xA7"],"\xE8"=>[107,"\xA7"],"\xE9"=>[140,"\xA7"],"\xEA"=>[146,"\xA7"],"\xEB"=>[102,"\xA7"],"\xEC"=>[113,"\xA7"],"\xED"=>[121,"\xA7"],"\xEE"=>[128,"\xA7"],"\xEF"=>[12,"\xA7"],"\xF0"=>[92,"\xAC"],"\xF1"=>[95,"\xAC"],"\xF2"=>[137,"\xAC"],"\xF3"=>[142,"\xAC"],"\xF4"=>[150,"\xAC"],"\xF5"=>[74,"\xAC"],"\xF6"=>[90,"\xAC"],"\xF7"=>[98,"\xAC"],"\xF8"=>[107,"\xAC"],"\xF9"=>[140,"\xAC"],"\xFA"=>[146,"\xAC"],"\xFB"=>[102,"\xAC"],"\xFC"=>[113,"\xAC"],"\xFD"=>[121,"\xAC"],"\xFE"=>[128,"\xAC"],"\xFF"=>[12,"\xAC"],],["\x00"=>[94,"\x850"],"\x01"=>[76,"\x850"],"\x02"=>[104,"\x850"],"\x03"=>[16,"\x850"],"\x04"=>[94,"\x851"],"\x05"=>[76,"\x851"],"\x06"=>[104,"\x851"],"\x07"=>[16,"\x851"],"\x08"=>[94,"\x852"],"\x09"=>[76,"\x852"],"\x0A"=>[104,"\x852"],"\x0B"=>[16,"\x852"],"\x0C"=>[94,"\x85a"],"\x0D"=>[76,"\x85a"],"\x0E"=>[104,"\x85a"],"\x0F"=>[16,"\x85a"],"\x10"=>[94,"\x85c"],"\x11"=>[76,"\x85c"],"\x12"=>[104,"\x85c"],"\x13"=>[16,"\x85c"],"\x14"=>[94,"\x85e"],"\x15"=>[76,"\x85e"],"\x16"=>[104,"\x85e"],"\x17"=>[16,"\x85e"],"\x18"=>[94,"\x85i"],"\x19"=>[76,"\x85i"],"\x1A"=>[104,"\x85i"],"\x1B"=>[16,"\x85i"],"\x1C"=>[94,"\x85o"],"\x1D"=>[76,"\x85o"],"\x1E"=>[104,"\x85o"],"\x1F"=>[16,"\x85o"],"\x20"=>[94,"\x85s"],"\x21"=>[76,"\x85s"],"\x22"=>[104,"\x85s"],"\x23"=>[16,"\x85s"],"\x24"=>[94,"\x85t"],"\x25"=>[76,"\x85t"],"\x26"=>[104,"\x85t"],"\x27"=>[16,"\x85t"],"\x28"=>[77,"\x85\x20"],"\x29"=>[18,"\x85\x20"],"\x2A"=>[77,"\x85\x25"],"\x2B"=>[18,"\x85\x25"],"\x2C"=>[77,"\x85-"],"-"=>[18,"\x85-"],"."=>[77,"\x85."],"\x2F"=>[18,"\x85."],[77,"\x85\x2F"],[18,"\x85\x2F"],[77,"\x853"],[18,"\x853"],[77,"\x854"],[18,"\x854"],[77,"\x855"],[18,"\x855"],[77,"\x856"],[18,"\x856"],"\x3A"=>[77,"\x857"],"\x3B"=>[18,"\x857"],"\x3C"=>[77,"\x858"],"\x3D"=>[18,"\x858"],"\x3E"=>[77,"\x859"],"\x3F"=>[18,"\x859"],"\x40"=>[77,"\x85\x3D"],"A"=>[18,"\x85\x3D"],"B"=>[77,"\x85A"],"C"=>[18,"\x85A"],"D"=>[77,"\x85_"],"E"=>[18,"\x85_"],"F"=>[77,"\x85b"],"G"=>[18,"\x85b"],"H"=>[77,"\x85d"],"I"=>[18,"\x85d"],"J"=>[77,"\x85f"],"K"=>[18,"\x85f"],"L"=>[77,"\x85g"],"M"=>[18,"\x85g"],"N"=>[77,"\x85h"],"O"=>[18,"\x85h"],"P"=>[77,"\x85l"],"Q"=>[18,"\x85l"],"R"=>[77,"\x85m"],"S"=>[18,"\x85m"],"T"=>[77,"\x85n"],"U"=>[18,"\x85n"],"V"=>[77,"\x85p"],"W"=>[18,"\x85p"],"X"=>[77,"\x85r"],"Y"=>[18,"\x85r"],"Z"=>[77,"\x85u"],"\x5B"=>[18,"\x85u"],"\x5C"=>[0,"\x85\x3A"],"\x5D"=>[0,"\x85B"],"\x5E"=>[0,"\x85C"],"_"=>[0,"\x85D"],"\x60"=>[0,"\x85E"],"a"=>[0,"\x85F"],"b"=>[0,"\x85G"],"c"=>[0,"\x85H"],"d"=>[0,"\x85I"],"e"=>[0,"\x85J"],"f"=>[0,"\x85K"],"g"=>[0,"\x85L"],"h"=>[0,"\x85M"],"i"=>[0,"\x85N"],"j"=>[0,"\x85O"],"k"=>[0,"\x85P"],"l"=>[0,"\x85Q"],"m"=>[0,"\x85R"],"n"=>[0,"\x85S"],"o"=>[0,"\x85T"],"p"=>[0,"\x85U"],"q"=>[0,"\x85V"],"r"=>[0,"\x85W"],"s"=>[0,"\x85Y"],"t"=>[0,"\x85j"],"u"=>[0,"\x85k"],"v"=>[0,"\x85q"],"w"=>[0,"\x85v"],"x"=>[0,"\x85w"],"y"=>[0,"\x85x"],"z"=>[0,"\x85y"],"\x7B"=>[0,"\x85z"],"\x7C"=>[82,"\x85"],"\x7D"=>[87,"\x85"],"~"=>[130,"\x85"],"\x7F"=>[9,"\x85"],"\x80"=>[94,"\x860"],"\x81"=>[76,"\x860"],"\x82"=>[104,"\x860"],"\x83"=>[16,"\x860"],"\x84"=>[94,"\x861"],"\x85"=>[76,"\x861"],"\x86"=>[104,"\x861"],"\x87"=>[16,"\x861"],"\x88"=>[94,"\x862"],"\x89"=>[76,"\x862"],"\x8A"=>[104,"\x862"],"\x8B"=>[16,"\x862"],"\x8C"=>[94,"\x86a"],"\x8D"=>[76,"\x86a"],"\x8E"=>[104,"\x86a"],"\x8F"=>[16,"\x86a"],"\x90"=>[94,"\x86c"],"\x91"=>[76,"\x86c"],"\x92"=>[104,"\x86c"],"\x93"=>[16,"\x86c"],"\x94"=>[94,"\x86e"],"\x95"=>[76,"\x86e"],"\x96"=>[104,"\x86e"],"\x97"=>[16,"\x86e"],"\x98"=>[94,"\x86i"],"\x99"=>[76,"\x86i"],"\x9A"=>[104,"\x86i"],"\x9B"=>[16,"\x86i"],"\x9C"=>[94,"\x86o"],"\x9D"=>[76,"\x86o"],"\x9E"=>[104,"\x86o"],"\x9F"=>[16,"\x86o"],"\xA0"=>[94,"\x86s"],"\xA1"=>[76,"\x86s"],"\xA2"=>[104,"\x86s"],"\xA3"=>[16,"\x86s"],"\xA4"=>[94,"\x86t"],"\xA5"=>[76,"\x86t"],"\xA6"=>[104,"\x86t"],"\xA7"=>[16,"\x86t"],"\xA8"=>[77,"\x86\x20"],"\xA9"=>[18,"\x86\x20"],"\xAA"=>[77,"\x86\x25"],"\xAB"=>[18,"\x86\x25"],"\xAC"=>[77,"\x86-"],"\xAD"=>[18,"\x86-"],"\xAE"=>[77,"\x86."],"\xAF"=>[18,"\x86."],"\xB0"=>[77,"\x86\x2F"],"\xB1"=>[18,"\x86\x2F"],"\xB2"=>[77,"\x863"],"\xB3"=>[18,"\x863"],"\xB4"=>[77,"\x864"],"\xB5"=>[18,"\x864"],"\xB6"=>[77,"\x865"],"\xB7"=>[18,"\x865"],"\xB8"=>[77,"\x866"],"\xB9"=>[18,"\x866"],"\xBA"=>[77,"\x867"],"\xBB"=>[18,"\x867"],"\xBC"=>[77,"\x868"],"\xBD"=>[18,"\x868"],"\xBE"=>[77,"\x869"],"\xBF"=>[18,"\x869"],"\xC0"=>[77,"\x86\x3D"],"\xC1"=>[18,"\x86\x3D"],"\xC2"=>[77,"\x86A"],"\xC3"=>[18,"\x86A"],"\xC4"=>[77,"\x86_"],"\xC5"=>[18,"\x86_"],"\xC6"=>[77,"\x86b"],"\xC7"=>[18,"\x86b"],"\xC8"=>[77,"\x86d"],"\xC9"=>[18,"\x86d"],"\xCA"=>[77,"\x86f"],"\xCB"=>[18,"\x86f"],"\xCC"=>[77,"\x86g"],"\xCD"=>[18,"\x86g"],"\xCE"=>[77,"\x86h"],"\xCF"=>[18,"\x86h"],"\xD0"=>[77,"\x86l"],"\xD1"=>[18,"\x86l"],"\xD2"=>[77,"\x86m"],"\xD3"=>[18,"\x86m"],"\xD4"=>[77,"\x86n"],"\xD5"=>[18,"\x86n"],"\xD6"=>[77,"\x86p"],"\xD7"=>[18,"\x86p"],"\xD8"=>[77,"\x86r"],"\xD9"=>[18,"\x86r"],"\xDA"=>[77,"\x86u"],"\xDB"=>[18,"\x86u"],"\xDC"=>[0,"\x86\x3A"],"\xDD"=>[0,"\x86B"],"\xDE"=>[0,"\x86C"],"\xDF"=>[0,"\x86D"],"\xE0"=>[0,"\x86E"],"\xE1"=>[0,"\x86F"],"\xE2"=>[0,"\x86G"],"\xE3"=>[0,"\x86H"],"\xE4"=>[0,"\x86I"],"\xE5"=>[0,"\x86J"],"\xE6"=>[0,"\x86K"],"\xE7"=>[0,"\x86L"],"\xE8"=>[0,"\x86M"],"\xE9"=>[0,"\x86N"],"\xEA"=>[0,"\x86O"],"\xEB"=>[0,"\x86P"],"\xEC"=>[0,"\x86Q"],"\xED"=>[0,"\x86R"],"\xEE"=>[0,"\x86S"],"\xEF"=>[0,"\x86T"],"\xF0"=>[0,"\x86U"],"\xF1"=>[0,"\x86V"],"\xF2"=>[0,"\x86W"],"\xF3"=>[0,"\x86Y"],"\xF4"=>[0,"\x86j"],"\xF5"=>[0,"\x86k"],"\xF6"=>[0,"\x86q"],"\xF7"=>[0,"\x86v"],"\xF8"=>[0,"\x86w"],"\xF9"=>[0,"\x86x"],"\xFA"=>[0,"\x86y"],"\xFB"=>[0,"\x86z"],"\xFC"=>[82,"\x86"],"\xFD"=>[87,"\x86"],"\xFE"=>[130,"\x86"],"\xFF"=>[9,"\x86"],],["\x00"=>[77,"\x850"],"\x01"=>[18,"\x850"],"\x02"=>[77,"\x851"],"\x03"=>[18,"\x851"],"\x04"=>[77,"\x852"],"\x05"=>[18,"\x852"],"\x06"=>[77,"\x85a"],"\x07"=>[18,"\x85a"],"\x08"=>[77,"\x85c"],"\x09"=>[18,"\x85c"],"\x0A"=>[77,"\x85e"],"\x0B"=>[18,"\x85e"],"\x0C"=>[77,"\x85i"],"\x0D"=>[18,"\x85i"],"\x0E"=>[77,"\x85o"],"\x0F"=>[18,"\x85o"],"\x10"=>[77,"\x85s"],"\x11"=>[18,"\x85s"],"\x12"=>[77,"\x85t"],"\x13"=>[18,"\x85t"],"\x14"=>[0,"\x85\x20"],"\x15"=>[0,"\x85\x25"],"\x16"=>[0,"\x85-"],"\x17"=>[0,"\x85."],"\x18"=>[0,"\x85\x2F"],"\x19"=>[0,"\x853"],"\x1A"=>[0,"\x854"],"\x1B"=>[0,"\x855"],"\x1C"=>[0,"\x856"],"\x1D"=>[0,"\x857"],"\x1E"=>[0,"\x858"],"\x1F"=>[0,"\x859"],"\x20"=>[0,"\x85\x3D"],"\x21"=>[0,"\x85A"],"\x22"=>[0,"\x85_"],"\x23"=>[0,"\x85b"],"\x24"=>[0,"\x85d"],"\x25"=>[0,"\x85f"],"\x26"=>[0,"\x85g"],"\x27"=>[0,"\x85h"],"\x28"=>[0,"\x85l"],"\x29"=>[0,"\x85m"],"\x2A"=>[0,"\x85n"],"\x2B"=>[0,"\x85p"],"\x2C"=>[0,"\x85r"],"-"=>[0,"\x85u"],"."=>[100,"\x85"],"\x2F"=>[110,"\x85"],[111,"\x85"],[115,"\x85"],[116,"\x85"],[118,"\x85"],[119,"\x85"],[122,"\x85"],[123,"\x85"],[125,"\x85"],[126,"\x85"],[129,"\x85"],"\x3A"=>[143,"\x85"],"\x3B"=>[148,"\x85"],"\x3C"=>[151,"\x85"],"\x3D"=>[153,"\x85"],"\x3E"=>[83,"\x85"],"\x3F"=>[10,"\x85"],"\x40"=>[77,"\x860"],"A"=>[18,"\x860"],"B"=>[77,"\x861"],"C"=>[18,"\x861"],"D"=>[77,"\x862"],"E"=>[18,"\x862"],"F"=>[77,"\x86a"],"G"=>[18,"\x86a"],"H"=>[77,"\x86c"],"I"=>[18,"\x86c"],"J"=>[77,"\x86e"],"K"=>[18,"\x86e"],"L"=>[77,"\x86i"],"M"=>[18,"\x86i"],"N"=>[77,"\x86o"],"O"=>[18,"\x86o"],"P"=>[77,"\x86s"],"Q"=>[18,"\x86s"],"R"=>[77,"\x86t"],"S"=>[18,"\x86t"],"T"=>[0,"\x86\x20"],"U"=>[0,"\x86\x25"],"V"=>[0,"\x86-"],"W"=>[0,"\x86."],"X"=>[0,"\x86\x2F"],"Y"=>[0,"\x863"],"Z"=>[0,"\x864"],"\x5B"=>[0,"\x865"],"\x5C"=>[0,"\x866"],"\x5D"=>[0,"\x867"],"\x5E"=>[0,"\x868"],"_"=>[0,"\x869"],"\x60"=>[0,"\x86\x3D"],"a"=>[0,"\x86A"],"b"=>[0,"\x86_"],"c"=>[0,"\x86b"],"d"=>[0,"\x86d"],"e"=>[0,"\x86f"],"f"=>[0,"\x86g"],"g"=>[0,"\x86h"],"h"=>[0,"\x86l"],"i"=>[0,"\x86m"],"j"=>[0,"\x86n"],"k"=>[0,"\x86p"],"l"=>[0,"\x86r"],"m"=>[0,"\x86u"],"n"=>[100,"\x86"],"o"=>[110,"\x86"],"p"=>[111,"\x86"],"q"=>[115,"\x86"],"r"=>[116,"\x86"],"s"=>[118,"\x86"],"t"=>[119,"\x86"],"u"=>[122,"\x86"],"v"=>[123,"\x86"],"w"=>[125,"\x86"],"x"=>[126,"\x86"],"y"=>[129,"\x86"],"z"=>[143,"\x86"],"\x7B"=>[148,"\x86"],"\x7C"=>[151,"\x86"],"\x7D"=>[153,"\x86"],"~"=>[83,"\x86"],"\x7F"=>[10,"\x86"],"\x80"=>[77,"\x880"],"\x81"=>[18,"\x880"],"\x82"=>[77,"\x881"],"\x83"=>[18,"\x881"],"\x84"=>[77,"\x882"],"\x85"=>[18,"\x882"],"\x86"=>[77,"\x88a"],"\x87"=>[18,"\x88a"],"\x88"=>[77,"\x88c"],"\x89"=>[18,"\x88c"],"\x8A"=>[77,"\x88e"],"\x8B"=>[18,"\x88e"],"\x8C"=>[77,"\x88i"],"\x8D"=>[18,"\x88i"],"\x8E"=>[77,"\x88o"],"\x8F"=>[18,"\x88o"],"\x90"=>[77,"\x88s"],"\x91"=>[18,"\x88s"],"\x92"=>[77,"\x88t"],"\x93"=>[18,"\x88t"],"\x94"=>[0,"\x88\x20"],"\x95"=>[0,"\x88\x25"],"\x96"=>[0,"\x88-"],"\x97"=>[0,"\x88."],"\x98"=>[0,"\x88\x2F"],"\x99"=>[0,"\x883"],"\x9A"=>[0,"\x884"],"\x9B"=>[0,"\x885"],"\x9C"=>[0,"\x886"],"\x9D"=>[0,"\x887"],"\x9E"=>[0,"\x888"],"\x9F"=>[0,"\x889"],"\xA0"=>[0,"\x88\x3D"],"\xA1"=>[0,"\x88A"],"\xA2"=>[0,"\x88_"],"\xA3"=>[0,"\x88b"],"\xA4"=>[0,"\x88d"],"\xA5"=>[0,"\x88f"],"\xA6"=>[0,"\x88g"],"\xA7"=>[0,"\x88h"],"\xA8"=>[0,"\x88l"],"\xA9"=>[0,"\x88m"],"\xAA"=>[0,"\x88n"],"\xAB"=>[0,"\x88p"],"\xAC"=>[0,"\x88r"],"\xAD"=>[0,"\x88u"],"\xAE"=>[100,"\x88"],"\xAF"=>[110,"\x88"],"\xB0"=>[111,"\x88"],"\xB1"=>[115,"\x88"],"\xB2"=>[116,"\x88"],"\xB3"=>[118,"\x88"],"\xB4"=>[119,"\x88"],"\xB5"=>[122,"\x88"],"\xB6"=>[123,"\x88"],"\xB7"=>[125,"\x88"],"\xB8"=>[126,"\x88"],"\xB9"=>[129,"\x88"],"\xBA"=>[143,"\x88"],"\xBB"=>[148,"\x88"],"\xBC"=>[151,"\x88"],"\xBD"=>[153,"\x88"],"\xBE"=>[83,"\x88"],"\xBF"=>[10,"\x88"],"\xC0"=>[77,"\x920"],"\xC1"=>[18,"\x920"],"\xC2"=>[77,"\x921"],"\xC3"=>[18,"\x921"],"\xC4"=>[77,"\x922"],"\xC5"=>[18,"\x922"],"\xC6"=>[77,"\x92a"],"\xC7"=>[18,"\x92a"],"\xC8"=>[77,"\x92c"],"\xC9"=>[18,"\x92c"],"\xCA"=>[77,"\x92e"],"\xCB"=>[18,"\x92e"],"\xCC"=>[77,"\x92i"],"\xCD"=>[18,"\x92i"],"\xCE"=>[77,"\x92o"],"\xCF"=>[18,"\x92o"],"\xD0"=>[77,"\x92s"],"\xD1"=>[18,"\x92s"],"\xD2"=>[77,"\x92t"],"\xD3"=>[18,"\x92t"],"\xD4"=>[0,"\x92\x20"],"\xD5"=>[0,"\x92\x25"],"\xD6"=>[0,"\x92-"],"\xD7"=>[0,"\x92."],"\xD8"=>[0,"\x92\x2F"],"\xD9"=>[0,"\x923"],"\xDA"=>[0,"\x924"],"\xDB"=>[0,"\x925"],"\xDC"=>[0,"\x926"],"\xDD"=>[0,"\x927"],"\xDE"=>[0,"\x928"],"\xDF"=>[0,"\x929"],"\xE0"=>[0,"\x92\x3D"],"\xE1"=>[0,"\x92A"],"\xE2"=>[0,"\x92_"],"\xE3"=>[0,"\x92b"],"\xE4"=>[0,"\x92d"],"\xE5"=>[0,"\x92f"],"\xE6"=>[0,"\x92g"],"\xE7"=>[0,"\x92h"],"\xE8"=>[0,"\x92l"],"\xE9"=>[0,"\x92m"],"\xEA"=>[0,"\x92n"],"\xEB"=>[0,"\x92p"],"\xEC"=>[0,"\x92r"],"\xED"=>[0,"\x92u"],"\xEE"=>[100,"\x92"],"\xEF"=>[110,"\x92"],"\xF0"=>[111,"\x92"],"\xF1"=>[115,"\x92"],"\xF2"=>[116,"\x92"],"\xF3"=>[118,"\x92"],"\xF4"=>[119,"\x92"],"\xF5"=>[122,"\x92"],"\xF6"=>[123,"\x92"],"\xF7"=>[125,"\x92"],"\xF8"=>[126,"\x92"],"\xF9"=>[129,"\x92"],"\xFA"=>[143,"\x92"],"\xFB"=>[148,"\x92"],"\xFC"=>[151,"\x92"],"\xFD"=>[153,"\x92"],"\xFE"=>[83,"\x92"],"\xFF"=>[10,"\x92"],],["\x00"=>[94,"\x880"],"\x01"=>[76,"\x880"],"\x02"=>[104,"\x880"],"\x03"=>[16,"\x880"],"\x04"=>[94,"\x881"],"\x05"=>[76,"\x881"],"\x06"=>[104,"\x881"],"\x07"=>[16,"\x881"],"\x08"=>[94,"\x882"],"\x09"=>[76,"\x882"],"\x0A"=>[104,"\x882"],"\x0B"=>[16,"\x882"],"\x0C"=>[94,"\x88a"],"\x0D"=>[76,"\x88a"],"\x0E"=>[104,"\x88a"],"\x0F"=>[16,"\x88a"],"\x10"=>[94,"\x88c"],"\x11"=>[76,"\x88c"],"\x12"=>[104,"\x88c"],"\x13"=>[16,"\x88c"],"\x14"=>[94,"\x88e"],"\x15"=>[76,"\x88e"],"\x16"=>[104,"\x88e"],"\x17"=>[16,"\x88e"],"\x18"=>[94,"\x88i"],"\x19"=>[76,"\x88i"],"\x1A"=>[104,"\x88i"],"\x1B"=>[16,"\x88i"],"\x1C"=>[94,"\x88o"],"\x1D"=>[76,"\x88o"],"\x1E"=>[104,"\x88o"],"\x1F"=>[16,"\x88o"],"\x20"=>[94,"\x88s"],"\x21"=>[76,"\x88s"],"\x22"=>[104,"\x88s"],"\x23"=>[16,"\x88s"],"\x24"=>[94,"\x88t"],"\x25"=>[76,"\x88t"],"\x26"=>[104,"\x88t"],"\x27"=>[16,"\x88t"],"\x28"=>[77,"\x88\x20"],"\x29"=>[18,"\x88\x20"],"\x2A"=>[77,"\x88\x25"],"\x2B"=>[18,"\x88\x25"],"\x2C"=>[77,"\x88-"],"-"=>[18,"\x88-"],"."=>[77,"\x88."],"\x2F"=>[18,"\x88."],[77,"\x88\x2F"],[18,"\x88\x2F"],[77,"\x883"],[18,"\x883"],[77,"\x884"],[18,"\x884"],[77,"\x885"],[18,"\x885"],[77,"\x886"],[18,"\x886"],"\x3A"=>[77,"\x887"],"\x3B"=>[18,"\x887"],"\x3C"=>[77,"\x888"],"\x3D"=>[18,"\x888"],"\x3E"=>[77,"\x889"],"\x3F"=>[18,"\x889"],"\x40"=>[77,"\x88\x3D"],"A"=>[18,"\x88\x3D"],"B"=>[77,"\x88A"],"C"=>[18,"\x88A"],"D"=>[77,"\x88_"],"E"=>[18,"\x88_"],"F"=>[77,"\x88b"],"G"=>[18,"\x88b"],"H"=>[77,"\x88d"],"I"=>[18,"\x88d"],"J"=>[77,"\x88f"],"K"=>[18,"\x88f"],"L"=>[77,"\x88g"],"M"=>[18,"\x88g"],"N"=>[77,"\x88h"],"O"=>[18,"\x88h"],"P"=>[77,"\x88l"],"Q"=>[18,"\x88l"],"R"=>[77,"\x88m"],"S"=>[18,"\x88m"],"T"=>[77,"\x88n"],"U"=>[18,"\x88n"],"V"=>[77,"\x88p"],"W"=>[18,"\x88p"],"X"=>[77,"\x88r"],"Y"=>[18,"\x88r"],"Z"=>[77,"\x88u"],"\x5B"=>[18,"\x88u"],"\x5C"=>[0,"\x88\x3A"],"\x5D"=>[0,"\x88B"],"\x5E"=>[0,"\x88C"],"_"=>[0,"\x88D"],"\x60"=>[0,"\x88E"],"a"=>[0,"\x88F"],"b"=>[0,"\x88G"],"c"=>[0,"\x88H"],"d"=>[0,"\x88I"],"e"=>[0,"\x88J"],"f"=>[0,"\x88K"],"g"=>[0,"\x88L"],"h"=>[0,"\x88M"],"i"=>[0,"\x88N"],"j"=>[0,"\x88O"],"k"=>[0,"\x88P"],"l"=>[0,"\x88Q"],"m"=>[0,"\x88R"],"n"=>[0,"\x88S"],"o"=>[0,"\x88T"],"p"=>[0,"\x88U"],"q"=>[0,"\x88V"],"r"=>[0,"\x88W"],"s"=>[0,"\x88Y"],"t"=>[0,"\x88j"],"u"=>[0,"\x88k"],"v"=>[0,"\x88q"],"w"=>[0,"\x88v"],"x"=>[0,"\x88w"],"y"=>[0,"\x88x"],"z"=>[0,"\x88y"],"\x7B"=>[0,"\x88z"],"\x7C"=>[82,"\x88"],"\x7D"=>[87,"\x88"],"~"=>[130,"\x88"],"\x7F"=>[9,"\x88"],"\x80"=>[94,"\x920"],"\x81"=>[76,"\x920"],"\x82"=>[104,"\x920"],"\x83"=>[16,"\x920"],"\x84"=>[94,"\x921"],"\x85"=>[76,"\x921"],"\x86"=>[104,"\x921"],"\x87"=>[16,"\x921"],"\x88"=>[94,"\x922"],"\x89"=>[76,"\x922"],"\x8A"=>[104,"\x922"],"\x8B"=>[16,"\x922"],"\x8C"=>[94,"\x92a"],"\x8D"=>[76,"\x92a"],"\x8E"=>[104,"\x92a"],"\x8F"=>[16,"\x92a"],"\x90"=>[94,"\x92c"],"\x91"=>[76,"\x92c"],"\x92"=>[104,"\x92c"],"\x93"=>[16,"\x92c"],"\x94"=>[94,"\x92e"],"\x95"=>[76,"\x92e"],"\x96"=>[104,"\x92e"],"\x97"=>[16,"\x92e"],"\x98"=>[94,"\x92i"],"\x99"=>[76,"\x92i"],"\x9A"=>[104,"\x92i"],"\x9B"=>[16,"\x92i"],"\x9C"=>[94,"\x92o"],"\x9D"=>[76,"\x92o"],"\x9E"=>[104,"\x92o"],"\x9F"=>[16,"\x92o"],"\xA0"=>[94,"\x92s"],"\xA1"=>[76,"\x92s"],"\xA2"=>[104,"\x92s"],"\xA3"=>[16,"\x92s"],"\xA4"=>[94,"\x92t"],"\xA5"=>[76,"\x92t"],"\xA6"=>[104,"\x92t"],"\xA7"=>[16,"\x92t"],"\xA8"=>[77,"\x92\x20"],"\xA9"=>[18,"\x92\x20"],"\xAA"=>[77,"\x92\x25"],"\xAB"=>[18,"\x92\x25"],"\xAC"=>[77,"\x92-"],"\xAD"=>[18,"\x92-"],"\xAE"=>[77,"\x92."],"\xAF"=>[18,"\x92."],"\xB0"=>[77,"\x92\x2F"],"\xB1"=>[18,"\x92\x2F"],"\xB2"=>[77,"\x923"],"\xB3"=>[18,"\x923"],"\xB4"=>[77,"\x924"],"\xB5"=>[18,"\x924"],"\xB6"=>[77,"\x925"],"\xB7"=>[18,"\x925"],"\xB8"=>[77,"\x926"],"\xB9"=>[18,"\x926"],"\xBA"=>[77,"\x927"],"\xBB"=>[18,"\x927"],"\xBC"=>[77,"\x928"],"\xBD"=>[18,"\x928"],"\xBE"=>[77,"\x929"],"\xBF"=>[18,"\x929"],"\xC0"=>[77,"\x92\x3D"],"\xC1"=>[18,"\x92\x3D"],"\xC2"=>[77,"\x92A"],"\xC3"=>[18,"\x92A"],"\xC4"=>[77,"\x92_"],"\xC5"=>[18,"\x92_"],"\xC6"=>[77,"\x92b"],"\xC7"=>[18,"\x92b"],"\xC8"=>[77,"\x92d"],"\xC9"=>[18,"\x92d"],"\xCA"=>[77,"\x92f"],"\xCB"=>[18,"\x92f"],"\xCC"=>[77,"\x92g"],"\xCD"=>[18,"\x92g"],"\xCE"=>[77,"\x92h"],"\xCF"=>[18,"\x92h"],"\xD0"=>[77,"\x92l"],"\xD1"=>[18,"\x92l"],"\xD2"=>[77,"\x92m"],"\xD3"=>[18,"\x92m"],"\xD4"=>[77,"\x92n"],"\xD5"=>[18,"\x92n"],"\xD6"=>[77,"\x92p"],"\xD7"=>[18,"\x92p"],"\xD8"=>[77,"\x92r"],"\xD9"=>[18,"\x92r"],"\xDA"=>[77,"\x92u"],"\xDB"=>[18,"\x92u"],"\xDC"=>[0,"\x92\x3A"],"\xDD"=>[0,"\x92B"],"\xDE"=>[0,"\x92C"],"\xDF"=>[0,"\x92D"],"\xE0"=>[0,"\x92E"],"\xE1"=>[0,"\x92F"],"\xE2"=>[0,"\x92G"],"\xE3"=>[0,"\x92H"],"\xE4"=>[0,"\x92I"],"\xE5"=>[0,"\x92J"],"\xE6"=>[0,"\x92K"],"\xE7"=>[0,"\x92L"],"\xE8"=>[0,"\x92M"],"\xE9"=>[0,"\x92N"],"\xEA"=>[0,"\x92O"],"\xEB"=>[0,"\x92P"],"\xEC"=>[0,"\x92Q"],"\xED"=>[0,"\x92R"],"\xEE"=>[0,"\x92S"],"\xEF"=>[0,"\x92T"],"\xF0"=>[0,"\x92U"],"\xF1"=>[0,"\x92V"],"\xF2"=>[0,"\x92W"],"\xF3"=>[0,"\x92Y"],"\xF4"=>[0,"\x92j"],"\xF5"=>[0,"\x92k"],"\xF6"=>[0,"\x92q"],"\xF7"=>[0,"\x92v"],"\xF8"=>[0,"\x92w"],"\xF9"=>[0,"\x92x"],"\xFA"=>[0,"\x92y"],"\xFB"=>[0,"\x92z"],"\xFC"=>[82,"\x92"],"\xFD"=>[87,"\x92"],"\xFE"=>[130,"\x92"],"\xFF"=>[9,"\x92"],],["\x00"=>[94,"\x890"],"\x01"=>[76,"\x890"],"\x02"=>[104,"\x890"],"\x03"=>[16,"\x890"],"\x04"=>[94,"\x891"],"\x05"=>[76,"\x891"],"\x06"=>[104,"\x891"],"\x07"=>[16,"\x891"],"\x08"=>[94,"\x892"],"\x09"=>[76,"\x892"],"\x0A"=>[104,"\x892"],"\x0B"=>[16,"\x892"],"\x0C"=>[94,"\x89a"],"\x0D"=>[76,"\x89a"],"\x0E"=>[104,"\x89a"],"\x0F"=>[16,"\x89a"],"\x10"=>[94,"\x89c"],"\x11"=>[76,"\x89c"],"\x12"=>[104,"\x89c"],"\x13"=>[16,"\x89c"],"\x14"=>[94,"\x89e"],"\x15"=>[76,"\x89e"],"\x16"=>[104,"\x89e"],"\x17"=>[16,"\x89e"],"\x18"=>[94,"\x89i"],"\x19"=>[76,"\x89i"],"\x1A"=>[104,"\x89i"],"\x1B"=>[16,"\x89i"],"\x1C"=>[94,"\x89o"],"\x1D"=>[76,"\x89o"],"\x1E"=>[104,"\x89o"],"\x1F"=>[16,"\x89o"],"\x20"=>[94,"\x89s"],"\x21"=>[76,"\x89s"],"\x22"=>[104,"\x89s"],"\x23"=>[16,"\x89s"],"\x24"=>[94,"\x89t"],"\x25"=>[76,"\x89t"],"\x26"=>[104,"\x89t"],"\x27"=>[16,"\x89t"],"\x28"=>[77,"\x89\x20"],"\x29"=>[18,"\x89\x20"],"\x2A"=>[77,"\x89\x25"],"\x2B"=>[18,"\x89\x25"],"\x2C"=>[77,"\x89-"],"-"=>[18,"\x89-"],"."=>[77,"\x89."],"\x2F"=>[18,"\x89."],[77,"\x89\x2F"],[18,"\x89\x2F"],[77,"\x893"],[18,"\x893"],[77,"\x894"],[18,"\x894"],[77,"\x895"],[18,"\x895"],[77,"\x896"],[18,"\x896"],"\x3A"=>[77,"\x897"],"\x3B"=>[18,"\x897"],"\x3C"=>[77,"\x898"],"\x3D"=>[18,"\x898"],"\x3E"=>[77,"\x899"],"\x3F"=>[18,"\x899"],"\x40"=>[77,"\x89\x3D"],"A"=>[18,"\x89\x3D"],"B"=>[77,"\x89A"],"C"=>[18,"\x89A"],"D"=>[77,"\x89_"],"E"=>[18,"\x89_"],"F"=>[77,"\x89b"],"G"=>[18,"\x89b"],"H"=>[77,"\x89d"],"I"=>[18,"\x89d"],"J"=>[77,"\x89f"],"K"=>[18,"\x89f"],"L"=>[77,"\x89g"],"M"=>[18,"\x89g"],"N"=>[77,"\x89h"],"O"=>[18,"\x89h"],"P"=>[77,"\x89l"],"Q"=>[18,"\x89l"],"R"=>[77,"\x89m"],"S"=>[18,"\x89m"],"T"=>[77,"\x89n"],"U"=>[18,"\x89n"],"V"=>[77,"\x89p"],"W"=>[18,"\x89p"],"X"=>[77,"\x89r"],"Y"=>[18,"\x89r"],"Z"=>[77,"\x89u"],"\x5B"=>[18,"\x89u"],"\x5C"=>[0,"\x89\x3A"],"\x5D"=>[0,"\x89B"],"\x5E"=>[0,"\x89C"],"_"=>[0,"\x89D"],"\x60"=>[0,"\x89E"],"a"=>[0,"\x89F"],"b"=>[0,"\x89G"],"c"=>[0,"\x89H"],"d"=>[0,"\x89I"],"e"=>[0,"\x89J"],"f"=>[0,"\x89K"],"g"=>[0,"\x89L"],"h"=>[0,"\x89M"],"i"=>[0,"\x89N"],"j"=>[0,"\x89O"],"k"=>[0,"\x89P"],"l"=>[0,"\x89Q"],"m"=>[0,"\x89R"],"n"=>[0,"\x89S"],"o"=>[0,"\x89T"],"p"=>[0,"\x89U"],"q"=>[0,"\x89V"],"r"=>[0,"\x89W"],"s"=>[0,"\x89Y"],"t"=>[0,"\x89j"],"u"=>[0,"\x89k"],"v"=>[0,"\x89q"],"w"=>[0,"\x89v"],"x"=>[0,"\x89w"],"y"=>[0,"\x89x"],"z"=>[0,"\x89y"],"\x7B"=>[0,"\x89z"],"\x7C"=>[82,"\x89"],"\x7D"=>[87,"\x89"],"~"=>[130,"\x89"],"\x7F"=>[9,"\x89"],"\x80"=>[94,"\x8A0"],"\x81"=>[76,"\x8A0"],"\x82"=>[104,"\x8A0"],"\x83"=>[16,"\x8A0"],"\x84"=>[94,"\x8A1"],"\x85"=>[76,"\x8A1"],"\x86"=>[104,"\x8A1"],"\x87"=>[16,"\x8A1"],"\x88"=>[94,"\x8A2"],"\x89"=>[76,"\x8A2"],"\x8A"=>[104,"\x8A2"],"\x8B"=>[16,"\x8A2"],"\x8C"=>[94,"\x8Aa"],"\x8D"=>[76,"\x8Aa"],"\x8E"=>[104,"\x8Aa"],"\x8F"=>[16,"\x8Aa"],"\x90"=>[94,"\x8Ac"],"\x91"=>[76,"\x8Ac"],"\x92"=>[104,"\x8Ac"],"\x93"=>[16,"\x8Ac"],"\x94"=>[94,"\x8Ae"],"\x95"=>[76,"\x8Ae"],"\x96"=>[104,"\x8Ae"],"\x97"=>[16,"\x8Ae"],"\x98"=>[94,"\x8Ai"],"\x99"=>[76,"\x8Ai"],"\x9A"=>[104,"\x8Ai"],"\x9B"=>[16,"\x8Ai"],"\x9C"=>[94,"\x8Ao"],"\x9D"=>[76,"\x8Ao"],"\x9E"=>[104,"\x8Ao"],"\x9F"=>[16,"\x8Ao"],"\xA0"=>[94,"\x8As"],"\xA1"=>[76,"\x8As"],"\xA2"=>[104,"\x8As"],"\xA3"=>[16,"\x8As"],"\xA4"=>[94,"\x8At"],"\xA5"=>[76,"\x8At"],"\xA6"=>[104,"\x8At"],"\xA7"=>[16,"\x8At"],"\xA8"=>[77,"\x8A\x20"],"\xA9"=>[18,"\x8A\x20"],"\xAA"=>[77,"\x8A\x25"],"\xAB"=>[18,"\x8A\x25"],"\xAC"=>[77,"\x8A-"],"\xAD"=>[18,"\x8A-"],"\xAE"=>[77,"\x8A."],"\xAF"=>[18,"\x8A."],"\xB0"=>[77,"\x8A\x2F"],"\xB1"=>[18,"\x8A\x2F"],"\xB2"=>[77,"\x8A3"],"\xB3"=>[18,"\x8A3"],"\xB4"=>[77,"\x8A4"],"\xB5"=>[18,"\x8A4"],"\xB6"=>[77,"\x8A5"],"\xB7"=>[18,"\x8A5"],"\xB8"=>[77,"\x8A6"],"\xB9"=>[18,"\x8A6"],"\xBA"=>[77,"\x8A7"],"\xBB"=>[18,"\x8A7"],"\xBC"=>[77,"\x8A8"],"\xBD"=>[18,"\x8A8"],"\xBE"=>[77,"\x8A9"],"\xBF"=>[18,"\x8A9"],"\xC0"=>[77,"\x8A\x3D"],"\xC1"=>[18,"\x8A\x3D"],"\xC2"=>[77,"\x8AA"],"\xC3"=>[18,"\x8AA"],"\xC4"=>[77,"\x8A_"],"\xC5"=>[18,"\x8A_"],"\xC6"=>[77,"\x8Ab"],"\xC7"=>[18,"\x8Ab"],"\xC8"=>[77,"\x8Ad"],"\xC9"=>[18,"\x8Ad"],"\xCA"=>[77,"\x8Af"],"\xCB"=>[18,"\x8Af"],"\xCC"=>[77,"\x8Ag"],"\xCD"=>[18,"\x8Ag"],"\xCE"=>[77,"\x8Ah"],"\xCF"=>[18,"\x8Ah"],"\xD0"=>[77,"\x8Al"],"\xD1"=>[18,"\x8Al"],"\xD2"=>[77,"\x8Am"],"\xD3"=>[18,"\x8Am"],"\xD4"=>[77,"\x8An"],"\xD5"=>[18,"\x8An"],"\xD6"=>[77,"\x8Ap"],"\xD7"=>[18,"\x8Ap"],"\xD8"=>[77,"\x8Ar"],"\xD9"=>[18,"\x8Ar"],"\xDA"=>[77,"\x8Au"],"\xDB"=>[18,"\x8Au"],"\xDC"=>[0,"\x8A\x3A"],"\xDD"=>[0,"\x8AB"],"\xDE"=>[0,"\x8AC"],"\xDF"=>[0,"\x8AD"],"\xE0"=>[0,"\x8AE"],"\xE1"=>[0,"\x8AF"],"\xE2"=>[0,"\x8AG"],"\xE3"=>[0,"\x8AH"],"\xE4"=>[0,"\x8AI"],"\xE5"=>[0,"\x8AJ"],"\xE6"=>[0,"\x8AK"],"\xE7"=>[0,"\x8AL"],"\xE8"=>[0,"\x8AM"],"\xE9"=>[0,"\x8AN"],"\xEA"=>[0,"\x8AO"],"\xEB"=>[0,"\x8AP"],"\xEC"=>[0,"\x8AQ"],"\xED"=>[0,"\x8AR"],"\xEE"=>[0,"\x8AS"],"\xEF"=>[0,"\x8AT"],"\xF0"=>[0,"\x8AU"],"\xF1"=>[0,"\x8AV"],"\xF2"=>[0,"\x8AW"],"\xF3"=>[0,"\x8AY"],"\xF4"=>[0,"\x8Aj"],"\xF5"=>[0,"\x8Ak"],"\xF6"=>[0,"\x8Aq"],"\xF7"=>[0,"\x8Av"],"\xF8"=>[0,"\x8Aw"],"\xF9"=>[0,"\x8Ax"],"\xFA"=>[0,"\x8Ay"],"\xFB"=>[0,"\x8Az"],"\xFC"=>[82,"\x8A"],"\xFD"=>[87,"\x8A"],"\xFE"=>[130,"\x8A"],"\xFF"=>[9,"\x8A"],],["\x00"=>[94,"\x8B0"],"\x01"=>[76,"\x8B0"],"\x02"=>[104,"\x8B0"],"\x03"=>[16,"\x8B0"],"\x04"=>[94,"\x8B1"],"\x05"=>[76,"\x8B1"],"\x06"=>[104,"\x8B1"],"\x07"=>[16,"\x8B1"],"\x08"=>[94,"\x8B2"],"\x09"=>[76,"\x8B2"],"\x0A"=>[104,"\x8B2"],"\x0B"=>[16,"\x8B2"],"\x0C"=>[94,"\x8Ba"],"\x0D"=>[76,"\x8Ba"],"\x0E"=>[104,"\x8Ba"],"\x0F"=>[16,"\x8Ba"],"\x10"=>[94,"\x8Bc"],"\x11"=>[76,"\x8Bc"],"\x12"=>[104,"\x8Bc"],"\x13"=>[16,"\x8Bc"],"\x14"=>[94,"\x8Be"],"\x15"=>[76,"\x8Be"],"\x16"=>[104,"\x8Be"],"\x17"=>[16,"\x8Be"],"\x18"=>[94,"\x8Bi"],"\x19"=>[76,"\x8Bi"],"\x1A"=>[104,"\x8Bi"],"\x1B"=>[16,"\x8Bi"],"\x1C"=>[94,"\x8Bo"],"\x1D"=>[76,"\x8Bo"],"\x1E"=>[104,"\x8Bo"],"\x1F"=>[16,"\x8Bo"],"\x20"=>[94,"\x8Bs"],"\x21"=>[76,"\x8Bs"],"\x22"=>[104,"\x8Bs"],"\x23"=>[16,"\x8Bs"],"\x24"=>[94,"\x8Bt"],"\x25"=>[76,"\x8Bt"],"\x26"=>[104,"\x8Bt"],"\x27"=>[16,"\x8Bt"],"\x28"=>[77,"\x8B\x20"],"\x29"=>[18,"\x8B\x20"],"\x2A"=>[77,"\x8B\x25"],"\x2B"=>[18,"\x8B\x25"],"\x2C"=>[77,"\x8B-"],"-"=>[18,"\x8B-"],"."=>[77,"\x8B."],"\x2F"=>[18,"\x8B."],[77,"\x8B\x2F"],[18,"\x8B\x2F"],[77,"\x8B3"],[18,"\x8B3"],[77,"\x8B4"],[18,"\x8B4"],[77,"\x8B5"],[18,"\x8B5"],[77,"\x8B6"],[18,"\x8B6"],"\x3A"=>[77,"\x8B7"],"\x3B"=>[18,"\x8B7"],"\x3C"=>[77,"\x8B8"],"\x3D"=>[18,"\x8B8"],"\x3E"=>[77,"\x8B9"],"\x3F"=>[18,"\x8B9"],"\x40"=>[77,"\x8B\x3D"],"A"=>[18,"\x8B\x3D"],"B"=>[77,"\x8BA"],"C"=>[18,"\x8BA"],"D"=>[77,"\x8B_"],"E"=>[18,"\x8B_"],"F"=>[77,"\x8Bb"],"G"=>[18,"\x8Bb"],"H"=>[77,"\x8Bd"],"I"=>[18,"\x8Bd"],"J"=>[77,"\x8Bf"],"K"=>[18,"\x8Bf"],"L"=>[77,"\x8Bg"],"M"=>[18,"\x8Bg"],"N"=>[77,"\x8Bh"],"O"=>[18,"\x8Bh"],"P"=>[77,"\x8Bl"],"Q"=>[18,"\x8Bl"],"R"=>[77,"\x8Bm"],"S"=>[18,"\x8Bm"],"T"=>[77,"\x8Bn"],"U"=>[18,"\x8Bn"],"V"=>[77,"\x8Bp"],"W"=>[18,"\x8Bp"],"X"=>[77,"\x8Br"],"Y"=>[18,"\x8Br"],"Z"=>[77,"\x8Bu"],"\x5B"=>[18,"\x8Bu"],"\x5C"=>[0,"\x8B\x3A"],"\x5D"=>[0,"\x8BB"],"\x5E"=>[0,"\x8BC"],"_"=>[0,"\x8BD"],"\x60"=>[0,"\x8BE"],"a"=>[0,"\x8BF"],"b"=>[0,"\x8BG"],"c"=>[0,"\x8BH"],"d"=>[0,"\x8BI"],"e"=>[0,"\x8BJ"],"f"=>[0,"\x8BK"],"g"=>[0,"\x8BL"],"h"=>[0,"\x8BM"],"i"=>[0,"\x8BN"],"j"=>[0,"\x8BO"],"k"=>[0,"\x8BP"],"l"=>[0,"\x8BQ"],"m"=>[0,"\x8BR"],"n"=>[0,"\x8BS"],"o"=>[0,"\x8BT"],"p"=>[0,"\x8BU"],"q"=>[0,"\x8BV"],"r"=>[0,"\x8BW"],"s"=>[0,"\x8BY"],"t"=>[0,"\x8Bj"],"u"=>[0,"\x8Bk"],"v"=>[0,"\x8Bq"],"w"=>[0,"\x8Bv"],"x"=>[0,"\x8Bw"],"y"=>[0,"\x8Bx"],"z"=>[0,"\x8By"],"\x7B"=>[0,"\x8Bz"],"\x7C"=>[82,"\x8B"],"\x7D"=>[87,"\x8B"],"~"=>[130,"\x8B"],"\x7F"=>[9,"\x8B"],"\x80"=>[94,"\x8C0"],"\x81"=>[76,"\x8C0"],"\x82"=>[104,"\x8C0"],"\x83"=>[16,"\x8C0"],"\x84"=>[94,"\x8C1"],"\x85"=>[76,"\x8C1"],"\x86"=>[104,"\x8C1"],"\x87"=>[16,"\x8C1"],"\x88"=>[94,"\x8C2"],"\x89"=>[76,"\x8C2"],"\x8A"=>[104,"\x8C2"],"\x8B"=>[16,"\x8C2"],"\x8C"=>[94,"\x8Ca"],"\x8D"=>[76,"\x8Ca"],"\x8E"=>[104,"\x8Ca"],"\x8F"=>[16,"\x8Ca"],"\x90"=>[94,"\x8Cc"],"\x91"=>[76,"\x8Cc"],"\x92"=>[104,"\x8Cc"],"\x93"=>[16,"\x8Cc"],"\x94"=>[94,"\x8Ce"],"\x95"=>[76,"\x8Ce"],"\x96"=>[104,"\x8Ce"],"\x97"=>[16,"\x8Ce"],"\x98"=>[94,"\x8Ci"],"\x99"=>[76,"\x8Ci"],"\x9A"=>[104,"\x8Ci"],"\x9B"=>[16,"\x8Ci"],"\x9C"=>[94,"\x8Co"],"\x9D"=>[76,"\x8Co"],"\x9E"=>[104,"\x8Co"],"\x9F"=>[16,"\x8Co"],"\xA0"=>[94,"\x8Cs"],"\xA1"=>[76,"\x8Cs"],"\xA2"=>[104,"\x8Cs"],"\xA3"=>[16,"\x8Cs"],"\xA4"=>[94,"\x8Ct"],"\xA5"=>[76,"\x8Ct"],"\xA6"=>[104,"\x8Ct"],"\xA7"=>[16,"\x8Ct"],"\xA8"=>[77,"\x8C\x20"],"\xA9"=>[18,"\x8C\x20"],"\xAA"=>[77,"\x8C\x25"],"\xAB"=>[18,"\x8C\x25"],"\xAC"=>[77,"\x8C-"],"\xAD"=>[18,"\x8C-"],"\xAE"=>[77,"\x8C."],"\xAF"=>[18,"\x8C."],"\xB0"=>[77,"\x8C\x2F"],"\xB1"=>[18,"\x8C\x2F"],"\xB2"=>[77,"\x8C3"],"\xB3"=>[18,"\x8C3"],"\xB4"=>[77,"\x8C4"],"\xB5"=>[18,"\x8C4"],"\xB6"=>[77,"\x8C5"],"\xB7"=>[18,"\x8C5"],"\xB8"=>[77,"\x8C6"],"\xB9"=>[18,"\x8C6"],"\xBA"=>[77,"\x8C7"],"\xBB"=>[18,"\x8C7"],"\xBC"=>[77,"\x8C8"],"\xBD"=>[18,"\x8C8"],"\xBE"=>[77,"\x8C9"],"\xBF"=>[18,"\x8C9"],"\xC0"=>[77,"\x8C\x3D"],"\xC1"=>[18,"\x8C\x3D"],"\xC2"=>[77,"\x8CA"],"\xC3"=>[18,"\x8CA"],"\xC4"=>[77,"\x8C_"],"\xC5"=>[18,"\x8C_"],"\xC6"=>[77,"\x8Cb"],"\xC7"=>[18,"\x8Cb"],"\xC8"=>[77,"\x8Cd"],"\xC9"=>[18,"\x8Cd"],"\xCA"=>[77,"\x8Cf"],"\xCB"=>[18,"\x8Cf"],"\xCC"=>[77,"\x8Cg"],"\xCD"=>[18,"\x8Cg"],"\xCE"=>[77,"\x8Ch"],"\xCF"=>[18,"\x8Ch"],"\xD0"=>[77,"\x8Cl"],"\xD1"=>[18,"\x8Cl"],"\xD2"=>[77,"\x8Cm"],"\xD3"=>[18,"\x8Cm"],"\xD4"=>[77,"\x8Cn"],"\xD5"=>[18,"\x8Cn"],"\xD6"=>[77,"\x8Cp"],"\xD7"=>[18,"\x8Cp"],"\xD8"=>[77,"\x8Cr"],"\xD9"=>[18,"\x8Cr"],"\xDA"=>[77,"\x8Cu"],"\xDB"=>[18,"\x8Cu"],"\xDC"=>[0,"\x8C\x3A"],"\xDD"=>[0,"\x8CB"],"\xDE"=>[0,"\x8CC"],"\xDF"=>[0,"\x8CD"],"\xE0"=>[0,"\x8CE"],"\xE1"=>[0,"\x8CF"],"\xE2"=>[0,"\x8CG"],"\xE3"=>[0,"\x8CH"],"\xE4"=>[0,"\x8CI"],"\xE5"=>[0,"\x8CJ"],"\xE6"=>[0,"\x8CK"],"\xE7"=>[0,"\x8CL"],"\xE8"=>[0,"\x8CM"],"\xE9"=>[0,"\x8CN"],"\xEA"=>[0,"\x8CO"],"\xEB"=>[0,"\x8CP"],"\xEC"=>[0,"\x8CQ"],"\xED"=>[0,"\x8CR"],"\xEE"=>[0,"\x8CS"],"\xEF"=>[0,"\x8CT"],"\xF0"=>[0,"\x8CU"],"\xF1"=>[0,"\x8CV"],"\xF2"=>[0,"\x8CW"],"\xF3"=>[0,"\x8CY"],"\xF4"=>[0,"\x8Cj"],"\xF5"=>[0,"\x8Ck"],"\xF6"=>[0,"\x8Cq"],"\xF7"=>[0,"\x8Cv"],"\xF8"=>[0,"\x8Cw"],"\xF9"=>[0,"\x8Cx"],"\xFA"=>[0,"\x8Cy"],"\xFB"=>[0,"\x8Cz"],"\xFC"=>[82,"\x8C"],"\xFD"=>[87,"\x8C"],"\xFE"=>[130,"\x8C"],"\xFF"=>[9,"\x8C"],],["\x00"=>[77,"\x8B0"],"\x01"=>[18,"\x8B0"],"\x02"=>[77,"\x8B1"],"\x03"=>[18,"\x8B1"],"\x04"=>[77,"\x8B2"],"\x05"=>[18,"\x8B2"],"\x06"=>[77,"\x8Ba"],"\x07"=>[18,"\x8Ba"],"\x08"=>[77,"\x8Bc"],"\x09"=>[18,"\x8Bc"],"\x0A"=>[77,"\x8Be"],"\x0B"=>[18,"\x8Be"],"\x0C"=>[77,"\x8Bi"],"\x0D"=>[18,"\x8Bi"],"\x0E"=>[77,"\x8Bo"],"\x0F"=>[18,"\x8Bo"],"\x10"=>[77,"\x8Bs"],"\x11"=>[18,"\x8Bs"],"\x12"=>[77,"\x8Bt"],"\x13"=>[18,"\x8Bt"],"\x14"=>[0,"\x8B\x20"],"\x15"=>[0,"\x8B\x25"],"\x16"=>[0,"\x8B-"],"\x17"=>[0,"\x8B."],"\x18"=>[0,"\x8B\x2F"],"\x19"=>[0,"\x8B3"],"\x1A"=>[0,"\x8B4"],"\x1B"=>[0,"\x8B5"],"\x1C"=>[0,"\x8B6"],"\x1D"=>[0,"\x8B7"],"\x1E"=>[0,"\x8B8"],"\x1F"=>[0,"\x8B9"],"\x20"=>[0,"\x8B\x3D"],"\x21"=>[0,"\x8BA"],"\x22"=>[0,"\x8B_"],"\x23"=>[0,"\x8Bb"],"\x24"=>[0,"\x8Bd"],"\x25"=>[0,"\x8Bf"],"\x26"=>[0,"\x8Bg"],"\x27"=>[0,"\x8Bh"],"\x28"=>[0,"\x8Bl"],"\x29"=>[0,"\x8Bm"],"\x2A"=>[0,"\x8Bn"],"\x2B"=>[0,"\x8Bp"],"\x2C"=>[0,"\x8Br"],"-"=>[0,"\x8Bu"],"."=>[100,"\x8B"],"\x2F"=>[110,"\x8B"],[111,"\x8B"],[115,"\x8B"],[116,"\x8B"],[118,"\x8B"],[119,"\x8B"],[122,"\x8B"],[123,"\x8B"],[125,"\x8B"],[126,"\x8B"],[129,"\x8B"],"\x3A"=>[143,"\x8B"],"\x3B"=>[148,"\x8B"],"\x3C"=>[151,"\x8B"],"\x3D"=>[153,"\x8B"],"\x3E"=>[83,"\x8B"],"\x3F"=>[10,"\x8B"],"\x40"=>[77,"\x8C0"],"A"=>[18,"\x8C0"],"B"=>[77,"\x8C1"],"C"=>[18,"\x8C1"],"D"=>[77,"\x8C2"],"E"=>[18,"\x8C2"],"F"=>[77,"\x8Ca"],"G"=>[18,"\x8Ca"],"H"=>[77,"\x8Cc"],"I"=>[18,"\x8Cc"],"J"=>[77,"\x8Ce"],"K"=>[18,"\x8Ce"],"L"=>[77,"\x8Ci"],"M"=>[18,"\x8Ci"],"N"=>[77,"\x8Co"],"O"=>[18,"\x8Co"],"P"=>[77,"\x8Cs"],"Q"=>[18,"\x8Cs"],"R"=>[77,"\x8Ct"],"S"=>[18,"\x8Ct"],"T"=>[0,"\x8C\x20"],"U"=>[0,"\x8C\x25"],"V"=>[0,"\x8C-"],"W"=>[0,"\x8C."],"X"=>[0,"\x8C\x2F"],"Y"=>[0,"\x8C3"],"Z"=>[0,"\x8C4"],"\x5B"=>[0,"\x8C5"],"\x5C"=>[0,"\x8C6"],"\x5D"=>[0,"\x8C7"],"\x5E"=>[0,"\x8C8"],"_"=>[0,"\x8C9"],"\x60"=>[0,"\x8C\x3D"],"a"=>[0,"\x8CA"],"b"=>[0,"\x8C_"],"c"=>[0,"\x8Cb"],"d"=>[0,"\x8Cd"],"e"=>[0,"\x8Cf"],"f"=>[0,"\x8Cg"],"g"=>[0,"\x8Ch"],"h"=>[0,"\x8Cl"],"i"=>[0,"\x8Cm"],"j"=>[0,"\x8Cn"],"k"=>[0,"\x8Cp"],"l"=>[0,"\x8Cr"],"m"=>[0,"\x8Cu"],"n"=>[100,"\x8C"],"o"=>[110,"\x8C"],"p"=>[111,"\x8C"],"q"=>[115,"\x8C"],"r"=>[116,"\x8C"],"s"=>[118,"\x8C"],"t"=>[119,"\x8C"],"u"=>[122,"\x8C"],"v"=>[123,"\x8C"],"w"=>[125,"\x8C"],"x"=>[126,"\x8C"],"y"=>[129,"\x8C"],"z"=>[143,"\x8C"],"\x7B"=>[148,"\x8C"],"\x7C"=>[151,"\x8C"],"\x7D"=>[153,"\x8C"],"~"=>[83,"\x8C"],"\x7F"=>[10,"\x8C"],"\x80"=>[77,"\x8D0"],"\x81"=>[18,"\x8D0"],"\x82"=>[77,"\x8D1"],"\x83"=>[18,"\x8D1"],"\x84"=>[77,"\x8D2"],"\x85"=>[18,"\x8D2"],"\x86"=>[77,"\x8Da"],"\x87"=>[18,"\x8Da"],"\x88"=>[77,"\x8Dc"],"\x89"=>[18,"\x8Dc"],"\x8A"=>[77,"\x8De"],"\x8B"=>[18,"\x8De"],"\x8C"=>[77,"\x8Di"],"\x8D"=>[18,"\x8Di"],"\x8E"=>[77,"\x8Do"],"\x8F"=>[18,"\x8Do"],"\x90"=>[77,"\x8Ds"],"\x91"=>[18,"\x8Ds"],"\x92"=>[77,"\x8Dt"],"\x93"=>[18,"\x8Dt"],"\x94"=>[0,"\x8D\x20"],"\x95"=>[0,"\x8D\x25"],"\x96"=>[0,"\x8D-"],"\x97"=>[0,"\x8D."],"\x98"=>[0,"\x8D\x2F"],"\x99"=>[0,"\x8D3"],"\x9A"=>[0,"\x8D4"],"\x9B"=>[0,"\x8D5"],"\x9C"=>[0,"\x8D6"],"\x9D"=>[0,"\x8D7"],"\x9E"=>[0,"\x8D8"],"\x9F"=>[0,"\x8D9"],"\xA0"=>[0,"\x8D\x3D"],"\xA1"=>[0,"\x8DA"],"\xA2"=>[0,"\x8D_"],"\xA3"=>[0,"\x8Db"],"\xA4"=>[0,"\x8Dd"],"\xA5"=>[0,"\x8Df"],"\xA6"=>[0,"\x8Dg"],"\xA7"=>[0,"\x8Dh"],"\xA8"=>[0,"\x8Dl"],"\xA9"=>[0,"\x8Dm"],"\xAA"=>[0,"\x8Dn"],"\xAB"=>[0,"\x8Dp"],"\xAC"=>[0,"\x8Dr"],"\xAD"=>[0,"\x8Du"],"\xAE"=>[100,"\x8D"],"\xAF"=>[110,"\x8D"],"\xB0"=>[111,"\x8D"],"\xB1"=>[115,"\x8D"],"\xB2"=>[116,"\x8D"],"\xB3"=>[118,"\x8D"],"\xB4"=>[119,"\x8D"],"\xB5"=>[122,"\x8D"],"\xB6"=>[123,"\x8D"],"\xB7"=>[125,"\x8D"],"\xB8"=>[126,"\x8D"],"\xB9"=>[129,"\x8D"],"\xBA"=>[143,"\x8D"],"\xBB"=>[148,"\x8D"],"\xBC"=>[151,"\x8D"],"\xBD"=>[153,"\x8D"],"\xBE"=>[83,"\x8D"],"\xBF"=>[10,"\x8D"],"\xC0"=>[77,"\x8F0"],"\xC1"=>[18,"\x8F0"],"\xC2"=>[77,"\x8F1"],"\xC3"=>[18,"\x8F1"],"\xC4"=>[77,"\x8F2"],"\xC5"=>[18,"\x8F2"],"\xC6"=>[77,"\x8Fa"],"\xC7"=>[18,"\x8Fa"],"\xC8"=>[77,"\x8Fc"],"\xC9"=>[18,"\x8Fc"],"\xCA"=>[77,"\x8Fe"],"\xCB"=>[18,"\x8Fe"],"\xCC"=>[77,"\x8Fi"],"\xCD"=>[18,"\x8Fi"],"\xCE"=>[77,"\x8Fo"],"\xCF"=>[18,"\x8Fo"],"\xD0"=>[77,"\x8Fs"],"\xD1"=>[18,"\x8Fs"],"\xD2"=>[77,"\x8Ft"],"\xD3"=>[18,"\x8Ft"],"\xD4"=>[0,"\x8F\x20"],"\xD5"=>[0,"\x8F\x25"],"\xD6"=>[0,"\x8F-"],"\xD7"=>[0,"\x8F."],"\xD8"=>[0,"\x8F\x2F"],"\xD9"=>[0,"\x8F3"],"\xDA"=>[0,"\x8F4"],"\xDB"=>[0,"\x8F5"],"\xDC"=>[0,"\x8F6"],"\xDD"=>[0,"\x8F7"],"\xDE"=>[0,"\x8F8"],"\xDF"=>[0,"\x8F9"],"\xE0"=>[0,"\x8F\x3D"],"\xE1"=>[0,"\x8FA"],"\xE2"=>[0,"\x8F_"],"\xE3"=>[0,"\x8Fb"],"\xE4"=>[0,"\x8Fd"],"\xE5"=>[0,"\x8Ff"],"\xE6"=>[0,"\x8Fg"],"\xE7"=>[0,"\x8Fh"],"\xE8"=>[0,"\x8Fl"],"\xE9"=>[0,"\x8Fm"],"\xEA"=>[0,"\x8Fn"],"\xEB"=>[0,"\x8Fp"],"\xEC"=>[0,"\x8Fr"],"\xED"=>[0,"\x8Fu"],"\xEE"=>[100,"\x8F"],"\xEF"=>[110,"\x8F"],"\xF0"=>[111,"\x8F"],"\xF1"=>[115,"\x8F"],"\xF2"=>[116,"\x8F"],"\xF3"=>[118,"\x8F"],"\xF4"=>[119,"\x8F"],"\xF5"=>[122,"\x8F"],"\xF6"=>[123,"\x8F"],"\xF7"=>[125,"\x8F"],"\xF8"=>[126,"\x8F"],"\xF9"=>[129,"\x8F"],"\xFA"=>[143,"\x8F"],"\xFB"=>[148,"\x8F"],"\xFC"=>[151,"\x8F"],"\xFD"=>[153,"\x8F"],"\xFE"=>[83,"\x8F"],"\xFF"=>[10,"\x8F"],],["\x00"=>[94,"\x8D0"],"\x01"=>[76,"\x8D0"],"\x02"=>[104,"\x8D0"],"\x03"=>[16,"\x8D0"],"\x04"=>[94,"\x8D1"],"\x05"=>[76,"\x8D1"],"\x06"=>[104,"\x8D1"],"\x07"=>[16,"\x8D1"],"\x08"=>[94,"\x8D2"],"\x09"=>[76,"\x8D2"],"\x0A"=>[104,"\x8D2"],"\x0B"=>[16,"\x8D2"],"\x0C"=>[94,"\x8Da"],"\x0D"=>[76,"\x8Da"],"\x0E"=>[104,"\x8Da"],"\x0F"=>[16,"\x8Da"],"\x10"=>[94,"\x8Dc"],"\x11"=>[76,"\x8Dc"],"\x12"=>[104,"\x8Dc"],"\x13"=>[16,"\x8Dc"],"\x14"=>[94,"\x8De"],"\x15"=>[76,"\x8De"],"\x16"=>[104,"\x8De"],"\x17"=>[16,"\x8De"],"\x18"=>[94,"\x8Di"],"\x19"=>[76,"\x8Di"],"\x1A"=>[104,"\x8Di"],"\x1B"=>[16,"\x8Di"],"\x1C"=>[94,"\x8Do"],"\x1D"=>[76,"\x8Do"],"\x1E"=>[104,"\x8Do"],"\x1F"=>[16,"\x8Do"],"\x20"=>[94,"\x8Ds"],"\x21"=>[76,"\x8Ds"],"\x22"=>[104,"\x8Ds"],"\x23"=>[16,"\x8Ds"],"\x24"=>[94,"\x8Dt"],"\x25"=>[76,"\x8Dt"],"\x26"=>[104,"\x8Dt"],"\x27"=>[16,"\x8Dt"],"\x28"=>[77,"\x8D\x20"],"\x29"=>[18,"\x8D\x20"],"\x2A"=>[77,"\x8D\x25"],"\x2B"=>[18,"\x8D\x25"],"\x2C"=>[77,"\x8D-"],"-"=>[18,"\x8D-"],"."=>[77,"\x8D."],"\x2F"=>[18,"\x8D."],[77,"\x8D\x2F"],[18,"\x8D\x2F"],[77,"\x8D3"],[18,"\x8D3"],[77,"\x8D4"],[18,"\x8D4"],[77,"\x8D5"],[18,"\x8D5"],[77,"\x8D6"],[18,"\x8D6"],"\x3A"=>[77,"\x8D7"],"\x3B"=>[18,"\x8D7"],"\x3C"=>[77,"\x8D8"],"\x3D"=>[18,"\x8D8"],"\x3E"=>[77,"\x8D9"],"\x3F"=>[18,"\x8D9"],"\x40"=>[77,"\x8D\x3D"],"A"=>[18,"\x8D\x3D"],"B"=>[77,"\x8DA"],"C"=>[18,"\x8DA"],"D"=>[77,"\x8D_"],"E"=>[18,"\x8D_"],"F"=>[77,"\x8Db"],"G"=>[18,"\x8Db"],"H"=>[77,"\x8Dd"],"I"=>[18,"\x8Dd"],"J"=>[77,"\x8Df"],"K"=>[18,"\x8Df"],"L"=>[77,"\x8Dg"],"M"=>[18,"\x8Dg"],"N"=>[77,"\x8Dh"],"O"=>[18,"\x8Dh"],"P"=>[77,"\x8Dl"],"Q"=>[18,"\x8Dl"],"R"=>[77,"\x8Dm"],"S"=>[18,"\x8Dm"],"T"=>[77,"\x8Dn"],"U"=>[18,"\x8Dn"],"V"=>[77,"\x8Dp"],"W"=>[18,"\x8Dp"],"X"=>[77,"\x8Dr"],"Y"=>[18,"\x8Dr"],"Z"=>[77,"\x8Du"],"\x5B"=>[18,"\x8Du"],"\x5C"=>[0,"\x8D\x3A"],"\x5D"=>[0,"\x8DB"],"\x5E"=>[0,"\x8DC"],"_"=>[0,"\x8DD"],"\x60"=>[0,"\x8DE"],"a"=>[0,"\x8DF"],"b"=>[0,"\x8DG"],"c"=>[0,"\x8DH"],"d"=>[0,"\x8DI"],"e"=>[0,"\x8DJ"],"f"=>[0,"\x8DK"],"g"=>[0,"\x8DL"],"h"=>[0,"\x8DM"],"i"=>[0,"\x8DN"],"j"=>[0,"\x8DO"],"k"=>[0,"\x8DP"],"l"=>[0,"\x8DQ"],"m"=>[0,"\x8DR"],"n"=>[0,"\x8DS"],"o"=>[0,"\x8DT"],"p"=>[0,"\x8DU"],"q"=>[0,"\x8DV"],"r"=>[0,"\x8DW"],"s"=>[0,"\x8DY"],"t"=>[0,"\x8Dj"],"u"=>[0,"\x8Dk"],"v"=>[0,"\x8Dq"],"w"=>[0,"\x8Dv"],"x"=>[0,"\x8Dw"],"y"=>[0,"\x8Dx"],"z"=>[0,"\x8Dy"],"\x7B"=>[0,"\x8Dz"],"\x7C"=>[82,"\x8D"],"\x7D"=>[87,"\x8D"],"~"=>[130,"\x8D"],"\x7F"=>[9,"\x8D"],"\x80"=>[94,"\x8F0"],"\x81"=>[76,"\x8F0"],"\x82"=>[104,"\x8F0"],"\x83"=>[16,"\x8F0"],"\x84"=>[94,"\x8F1"],"\x85"=>[76,"\x8F1"],"\x86"=>[104,"\x8F1"],"\x87"=>[16,"\x8F1"],"\x88"=>[94,"\x8F2"],"\x89"=>[76,"\x8F2"],"\x8A"=>[104,"\x8F2"],"\x8B"=>[16,"\x8F2"],"\x8C"=>[94,"\x8Fa"],"\x8D"=>[76,"\x8Fa"],"\x8E"=>[104,"\x8Fa"],"\x8F"=>[16,"\x8Fa"],"\x90"=>[94,"\x8Fc"],"\x91"=>[76,"\x8Fc"],"\x92"=>[104,"\x8Fc"],"\x93"=>[16,"\x8Fc"],"\x94"=>[94,"\x8Fe"],"\x95"=>[76,"\x8Fe"],"\x96"=>[104,"\x8Fe"],"\x97"=>[16,"\x8Fe"],"\x98"=>[94,"\x8Fi"],"\x99"=>[76,"\x8Fi"],"\x9A"=>[104,"\x8Fi"],"\x9B"=>[16,"\x8Fi"],"\x9C"=>[94,"\x8Fo"],"\x9D"=>[76,"\x8Fo"],"\x9E"=>[104,"\x8Fo"],"\x9F"=>[16,"\x8Fo"],"\xA0"=>[94,"\x8Fs"],"\xA1"=>[76,"\x8Fs"],"\xA2"=>[104,"\x8Fs"],"\xA3"=>[16,"\x8Fs"],"\xA4"=>[94,"\x8Ft"],"\xA5"=>[76,"\x8Ft"],"\xA6"=>[104,"\x8Ft"],"\xA7"=>[16,"\x8Ft"],"\xA8"=>[77,"\x8F\x20"],"\xA9"=>[18,"\x8F\x20"],"\xAA"=>[77,"\x8F\x25"],"\xAB"=>[18,"\x8F\x25"],"\xAC"=>[77,"\x8F-"],"\xAD"=>[18,"\x8F-"],"\xAE"=>[77,"\x8F."],"\xAF"=>[18,"\x8F."],"\xB0"=>[77,"\x8F\x2F"],"\xB1"=>[18,"\x8F\x2F"],"\xB2"=>[77,"\x8F3"],"\xB3"=>[18,"\x8F3"],"\xB4"=>[77,"\x8F4"],"\xB5"=>[18,"\x8F4"],"\xB6"=>[77,"\x8F5"],"\xB7"=>[18,"\x8F5"],"\xB8"=>[77,"\x8F6"],"\xB9"=>[18,"\x8F6"],"\xBA"=>[77,"\x8F7"],"\xBB"=>[18,"\x8F7"],"\xBC"=>[77,"\x8F8"],"\xBD"=>[18,"\x8F8"],"\xBE"=>[77,"\x8F9"],"\xBF"=>[18,"\x8F9"],"\xC0"=>[77,"\x8F\x3D"],"\xC1"=>[18,"\x8F\x3D"],"\xC2"=>[77,"\x8FA"],"\xC3"=>[18,"\x8FA"],"\xC4"=>[77,"\x8F_"],"\xC5"=>[18,"\x8F_"],"\xC6"=>[77,"\x8Fb"],"\xC7"=>[18,"\x8Fb"],"\xC8"=>[77,"\x8Fd"],"\xC9"=>[18,"\x8Fd"],"\xCA"=>[77,"\x8Ff"],"\xCB"=>[18,"\x8Ff"],"\xCC"=>[77,"\x8Fg"],"\xCD"=>[18,"\x8Fg"],"\xCE"=>[77,"\x8Fh"],"\xCF"=>[18,"\x8Fh"],"\xD0"=>[77,"\x8Fl"],"\xD1"=>[18,"\x8Fl"],"\xD2"=>[77,"\x8Fm"],"\xD3"=>[18,"\x8Fm"],"\xD4"=>[77,"\x8Fn"],"\xD5"=>[18,"\x8Fn"],"\xD6"=>[77,"\x8Fp"],"\xD7"=>[18,"\x8Fp"],"\xD8"=>[77,"\x8Fr"],"\xD9"=>[18,"\x8Fr"],"\xDA"=>[77,"\x8Fu"],"\xDB"=>[18,"\x8Fu"],"\xDC"=>[0,"\x8F\x3A"],"\xDD"=>[0,"\x8FB"],"\xDE"=>[0,"\x8FC"],"\xDF"=>[0,"\x8FD"],"\xE0"=>[0,"\x8FE"],"\xE1"=>[0,"\x8FF"],"\xE2"=>[0,"\x8FG"],"\xE3"=>[0,"\x8FH"],"\xE4"=>[0,"\x8FI"],"\xE5"=>[0,"\x8FJ"],"\xE6"=>[0,"\x8FK"],"\xE7"=>[0,"\x8FL"],"\xE8"=>[0,"\x8FM"],"\xE9"=>[0,"\x8FN"],"\xEA"=>[0,"\x8FO"],"\xEB"=>[0,"\x8FP"],"\xEC"=>[0,"\x8FQ"],"\xED"=>[0,"\x8FR"],"\xEE"=>[0,"\x8FS"],"\xEF"=>[0,"\x8FT"],"\xF0"=>[0,"\x8FU"],"\xF1"=>[0,"\x8FV"],"\xF2"=>[0,"\x8FW"],"\xF3"=>[0,"\x8FY"],"\xF4"=>[0,"\x8Fj"],"\xF5"=>[0,"\x8Fk"],"\xF6"=>[0,"\x8Fq"],"\xF7"=>[0,"\x8Fv"],"\xF8"=>[0,"\x8Fw"],"\xF9"=>[0,"\x8Fx"],"\xFA"=>[0,"\x8Fy"],"\xFB"=>[0,"\x8Fz"],"\xFC"=>[82,"\x8F"],"\xFD"=>[87,"\x8F"],"\xFE"=>[130,"\x8F"],"\xFF"=>[9,"\x8F"],],["\x00"=>[94,"\x900"],"\x01"=>[76,"\x900"],"\x02"=>[104,"\x900"],"\x03"=>[16,"\x900"],"\x04"=>[94,"\x901"],"\x05"=>[76,"\x901"],"\x06"=>[104,"\x901"],"\x07"=>[16,"\x901"],"\x08"=>[94,"\x902"],"\x09"=>[76,"\x902"],"\x0A"=>[104,"\x902"],"\x0B"=>[16,"\x902"],"\x0C"=>[94,"\x90a"],"\x0D"=>[76,"\x90a"],"\x0E"=>[104,"\x90a"],"\x0F"=>[16,"\x90a"],"\x10"=>[94,"\x90c"],"\x11"=>[76,"\x90c"],"\x12"=>[104,"\x90c"],"\x13"=>[16,"\x90c"],"\x14"=>[94,"\x90e"],"\x15"=>[76,"\x90e"],"\x16"=>[104,"\x90e"],"\x17"=>[16,"\x90e"],"\x18"=>[94,"\x90i"],"\x19"=>[76,"\x90i"],"\x1A"=>[104,"\x90i"],"\x1B"=>[16,"\x90i"],"\x1C"=>[94,"\x90o"],"\x1D"=>[76,"\x90o"],"\x1E"=>[104,"\x90o"],"\x1F"=>[16,"\x90o"],"\x20"=>[94,"\x90s"],"\x21"=>[76,"\x90s"],"\x22"=>[104,"\x90s"],"\x23"=>[16,"\x90s"],"\x24"=>[94,"\x90t"],"\x25"=>[76,"\x90t"],"\x26"=>[104,"\x90t"],"\x27"=>[16,"\x90t"],"\x28"=>[77,"\x90\x20"],"\x29"=>[18,"\x90\x20"],"\x2A"=>[77,"\x90\x25"],"\x2B"=>[18,"\x90\x25"],"\x2C"=>[77,"\x90-"],"-"=>[18,"\x90-"],"."=>[77,"\x90."],"\x2F"=>[18,"\x90."],[77,"\x90\x2F"],[18,"\x90\x2F"],[77,"\x903"],[18,"\x903"],[77,"\x904"],[18,"\x904"],[77,"\x905"],[18,"\x905"],[77,"\x906"],[18,"\x906"],"\x3A"=>[77,"\x907"],"\x3B"=>[18,"\x907"],"\x3C"=>[77,"\x908"],"\x3D"=>[18,"\x908"],"\x3E"=>[77,"\x909"],"\x3F"=>[18,"\x909"],"\x40"=>[77,"\x90\x3D"],"A"=>[18,"\x90\x3D"],"B"=>[77,"\x90A"],"C"=>[18,"\x90A"],"D"=>[77,"\x90_"],"E"=>[18,"\x90_"],"F"=>[77,"\x90b"],"G"=>[18,"\x90b"],"H"=>[77,"\x90d"],"I"=>[18,"\x90d"],"J"=>[77,"\x90f"],"K"=>[18,"\x90f"],"L"=>[77,"\x90g"],"M"=>[18,"\x90g"],"N"=>[77,"\x90h"],"O"=>[18,"\x90h"],"P"=>[77,"\x90l"],"Q"=>[18,"\x90l"],"R"=>[77,"\x90m"],"S"=>[18,"\x90m"],"T"=>[77,"\x90n"],"U"=>[18,"\x90n"],"V"=>[77,"\x90p"],"W"=>[18,"\x90p"],"X"=>[77,"\x90r"],"Y"=>[18,"\x90r"],"Z"=>[77,"\x90u"],"\x5B"=>[18,"\x90u"],"\x5C"=>[0,"\x90\x3A"],"\x5D"=>[0,"\x90B"],"\x5E"=>[0,"\x90C"],"_"=>[0,"\x90D"],"\x60"=>[0,"\x90E"],"a"=>[0,"\x90F"],"b"=>[0,"\x90G"],"c"=>[0,"\x90H"],"d"=>[0,"\x90I"],"e"=>[0,"\x90J"],"f"=>[0,"\x90K"],"g"=>[0,"\x90L"],"h"=>[0,"\x90M"],"i"=>[0,"\x90N"],"j"=>[0,"\x90O"],"k"=>[0,"\x90P"],"l"=>[0,"\x90Q"],"m"=>[0,"\x90R"],"n"=>[0,"\x90S"],"o"=>[0,"\x90T"],"p"=>[0,"\x90U"],"q"=>[0,"\x90V"],"r"=>[0,"\x90W"],"s"=>[0,"\x90Y"],"t"=>[0,"\x90j"],"u"=>[0,"\x90k"],"v"=>[0,"\x90q"],"w"=>[0,"\x90v"],"x"=>[0,"\x90w"],"y"=>[0,"\x90x"],"z"=>[0,"\x90y"],"\x7B"=>[0,"\x90z"],"\x7C"=>[82,"\x90"],"\x7D"=>[87,"\x90"],"~"=>[130,"\x90"],"\x7F"=>[9,"\x90"],"\x80"=>[94,"\x910"],"\x81"=>[76,"\x910"],"\x82"=>[104,"\x910"],"\x83"=>[16,"\x910"],"\x84"=>[94,"\x911"],"\x85"=>[76,"\x911"],"\x86"=>[104,"\x911"],"\x87"=>[16,"\x911"],"\x88"=>[94,"\x912"],"\x89"=>[76,"\x912"],"\x8A"=>[104,"\x912"],"\x8B"=>[16,"\x912"],"\x8C"=>[94,"\x91a"],"\x8D"=>[76,"\x91a"],"\x8E"=>[104,"\x91a"],"\x8F"=>[16,"\x91a"],"\x90"=>[94,"\x91c"],"\x91"=>[76,"\x91c"],"\x92"=>[104,"\x91c"],"\x93"=>[16,"\x91c"],"\x94"=>[94,"\x91e"],"\x95"=>[76,"\x91e"],"\x96"=>[104,"\x91e"],"\x97"=>[16,"\x91e"],"\x98"=>[94,"\x91i"],"\x99"=>[76,"\x91i"],"\x9A"=>[104,"\x91i"],"\x9B"=>[16,"\x91i"],"\x9C"=>[94,"\x91o"],"\x9D"=>[76,"\x91o"],"\x9E"=>[104,"\x91o"],"\x9F"=>[16,"\x91o"],"\xA0"=>[94,"\x91s"],"\xA1"=>[76,"\x91s"],"\xA2"=>[104,"\x91s"],"\xA3"=>[16,"\x91s"],"\xA4"=>[94,"\x91t"],"\xA5"=>[76,"\x91t"],"\xA6"=>[104,"\x91t"],"\xA7"=>[16,"\x91t"],"\xA8"=>[77,"\x91\x20"],"\xA9"=>[18,"\x91\x20"],"\xAA"=>[77,"\x91\x25"],"\xAB"=>[18,"\x91\x25"],"\xAC"=>[77,"\x91-"],"\xAD"=>[18,"\x91-"],"\xAE"=>[77,"\x91."],"\xAF"=>[18,"\x91."],"\xB0"=>[77,"\x91\x2F"],"\xB1"=>[18,"\x91\x2F"],"\xB2"=>[77,"\x913"],"\xB3"=>[18,"\x913"],"\xB4"=>[77,"\x914"],"\xB5"=>[18,"\x914"],"\xB6"=>[77,"\x915"],"\xB7"=>[18,"\x915"],"\xB8"=>[77,"\x916"],"\xB9"=>[18,"\x916"],"\xBA"=>[77,"\x917"],"\xBB"=>[18,"\x917"],"\xBC"=>[77,"\x918"],"\xBD"=>[18,"\x918"],"\xBE"=>[77,"\x919"],"\xBF"=>[18,"\x919"],"\xC0"=>[77,"\x91\x3D"],"\xC1"=>[18,"\x91\x3D"],"\xC2"=>[77,"\x91A"],"\xC3"=>[18,"\x91A"],"\xC4"=>[77,"\x91_"],"\xC5"=>[18,"\x91_"],"\xC6"=>[77,"\x91b"],"\xC7"=>[18,"\x91b"],"\xC8"=>[77,"\x91d"],"\xC9"=>[18,"\x91d"],"\xCA"=>[77,"\x91f"],"\xCB"=>[18,"\x91f"],"\xCC"=>[77,"\x91g"],"\xCD"=>[18,"\x91g"],"\xCE"=>[77,"\x91h"],"\xCF"=>[18,"\x91h"],"\xD0"=>[77,"\x91l"],"\xD1"=>[18,"\x91l"],"\xD2"=>[77,"\x91m"],"\xD3"=>[18,"\x91m"],"\xD4"=>[77,"\x91n"],"\xD5"=>[18,"\x91n"],"\xD6"=>[77,"\x91p"],"\xD7"=>[18,"\x91p"],"\xD8"=>[77,"\x91r"],"\xD9"=>[18,"\x91r"],"\xDA"=>[77,"\x91u"],"\xDB"=>[18,"\x91u"],"\xDC"=>[0,"\x91\x3A"],"\xDD"=>[0,"\x91B"],"\xDE"=>[0,"\x91C"],"\xDF"=>[0,"\x91D"],"\xE0"=>[0,"\x91E"],"\xE1"=>[0,"\x91F"],"\xE2"=>[0,"\x91G"],"\xE3"=>[0,"\x91H"],"\xE4"=>[0,"\x91I"],"\xE5"=>[0,"\x91J"],"\xE6"=>[0,"\x91K"],"\xE7"=>[0,"\x91L"],"\xE8"=>[0,"\x91M"],"\xE9"=>[0,"\x91N"],"\xEA"=>[0,"\x91O"],"\xEB"=>[0,"\x91P"],"\xEC"=>[0,"\x91Q"],"\xED"=>[0,"\x91R"],"\xEE"=>[0,"\x91S"],"\xEF"=>[0,"\x91T"],"\xF0"=>[0,"\x91U"],"\xF1"=>[0,"\x91V"],"\xF2"=>[0,"\x91W"],"\xF3"=>[0,"\x91Y"],"\xF4"=>[0,"\x91j"],"\xF5"=>[0,"\x91k"],"\xF6"=>[0,"\x91q"],"\xF7"=>[0,"\x91v"],"\xF8"=>[0,"\x91w"],"\xF9"=>[0,"\x91x"],"\xFA"=>[0,"\x91y"],"\xFB"=>[0,"\x91z"],"\xFC"=>[82,"\x91"],"\xFD"=>[87,"\x91"],"\xFE"=>[130,"\x91"],"\xFF"=>[9,"\x91"],],["\x00"=>[77,"\x900"],"\x01"=>[18,"\x900"],"\x02"=>[77,"\x901"],"\x03"=>[18,"\x901"],"\x04"=>[77,"\x902"],"\x05"=>[18,"\x902"],"\x06"=>[77,"\x90a"],"\x07"=>[18,"\x90a"],"\x08"=>[77,"\x90c"],"\x09"=>[18,"\x90c"],"\x0A"=>[77,"\x90e"],"\x0B"=>[18,"\x90e"],"\x0C"=>[77,"\x90i"],"\x0D"=>[18,"\x90i"],"\x0E"=>[77,"\x90o"],"\x0F"=>[18,"\x90o"],"\x10"=>[77,"\x90s"],"\x11"=>[18,"\x90s"],"\x12"=>[77,"\x90t"],"\x13"=>[18,"\x90t"],"\x14"=>[0,"\x90\x20"],"\x15"=>[0,"\x90\x25"],"\x16"=>[0,"\x90-"],"\x17"=>[0,"\x90."],"\x18"=>[0,"\x90\x2F"],"\x19"=>[0,"\x903"],"\x1A"=>[0,"\x904"],"\x1B"=>[0,"\x905"],"\x1C"=>[0,"\x906"],"\x1D"=>[0,"\x907"],"\x1E"=>[0,"\x908"],"\x1F"=>[0,"\x909"],"\x20"=>[0,"\x90\x3D"],"\x21"=>[0,"\x90A"],"\x22"=>[0,"\x90_"],"\x23"=>[0,"\x90b"],"\x24"=>[0,"\x90d"],"\x25"=>[0,"\x90f"],"\x26"=>[0,"\x90g"],"\x27"=>[0,"\x90h"],"\x28"=>[0,"\x90l"],"\x29"=>[0,"\x90m"],"\x2A"=>[0,"\x90n"],"\x2B"=>[0,"\x90p"],"\x2C"=>[0,"\x90r"],"-"=>[0,"\x90u"],"."=>[100,"\x90"],"\x2F"=>[110,"\x90"],[111,"\x90"],[115,"\x90"],[116,"\x90"],[118,"\x90"],[119,"\x90"],[122,"\x90"],[123,"\x90"],[125,"\x90"],[126,"\x90"],[129,"\x90"],"\x3A"=>[143,"\x90"],"\x3B"=>[148,"\x90"],"\x3C"=>[151,"\x90"],"\x3D"=>[153,"\x90"],"\x3E"=>[83,"\x90"],"\x3F"=>[10,"\x90"],"\x40"=>[77,"\x910"],"A"=>[18,"\x910"],"B"=>[77,"\x911"],"C"=>[18,"\x911"],"D"=>[77,"\x912"],"E"=>[18,"\x912"],"F"=>[77,"\x91a"],"G"=>[18,"\x91a"],"H"=>[77,"\x91c"],"I"=>[18,"\x91c"],"J"=>[77,"\x91e"],"K"=>[18,"\x91e"],"L"=>[77,"\x91i"],"M"=>[18,"\x91i"],"N"=>[77,"\x91o"],"O"=>[18,"\x91o"],"P"=>[77,"\x91s"],"Q"=>[18,"\x91s"],"R"=>[77,"\x91t"],"S"=>[18,"\x91t"],"T"=>[0,"\x91\x20"],"U"=>[0,"\x91\x25"],"V"=>[0,"\x91-"],"W"=>[0,"\x91."],"X"=>[0,"\x91\x2F"],"Y"=>[0,"\x913"],"Z"=>[0,"\x914"],"\x5B"=>[0,"\x915"],"\x5C"=>[0,"\x916"],"\x5D"=>[0,"\x917"],"\x5E"=>[0,"\x918"],"_"=>[0,"\x919"],"\x60"=>[0,"\x91\x3D"],"a"=>[0,"\x91A"],"b"=>[0,"\x91_"],"c"=>[0,"\x91b"],"d"=>[0,"\x91d"],"e"=>[0,"\x91f"],"f"=>[0,"\x91g"],"g"=>[0,"\x91h"],"h"=>[0,"\x91l"],"i"=>[0,"\x91m"],"j"=>[0,"\x91n"],"k"=>[0,"\x91p"],"l"=>[0,"\x91r"],"m"=>[0,"\x91u"],"n"=>[100,"\x91"],"o"=>[110,"\x91"],"p"=>[111,"\x91"],"q"=>[115,"\x91"],"r"=>[116,"\x91"],"s"=>[118,"\x91"],"t"=>[119,"\x91"],"u"=>[122,"\x91"],"v"=>[123,"\x91"],"w"=>[125,"\x91"],"x"=>[126,"\x91"],"y"=>[129,"\x91"],"z"=>[143,"\x91"],"\x7B"=>[148,"\x91"],"\x7C"=>[151,"\x91"],"\x7D"=>[153,"\x91"],"~"=>[83,"\x91"],"\x7F"=>[10,"\x91"],"\x80"=>[77,"\x940"],"\x81"=>[18,"\x940"],"\x82"=>[77,"\x941"],"\x83"=>[18,"\x941"],"\x84"=>[77,"\x942"],"\x85"=>[18,"\x942"],"\x86"=>[77,"\x94a"],"\x87"=>[18,"\x94a"],"\x88"=>[77,"\x94c"],"\x89"=>[18,"\x94c"],"\x8A"=>[77,"\x94e"],"\x8B"=>[18,"\x94e"],"\x8C"=>[77,"\x94i"],"\x8D"=>[18,"\x94i"],"\x8E"=>[77,"\x94o"],"\x8F"=>[18,"\x94o"],"\x90"=>[77,"\x94s"],"\x91"=>[18,"\x94s"],"\x92"=>[77,"\x94t"],"\x93"=>[18,"\x94t"],"\x94"=>[0,"\x94\x20"],"\x95"=>[0,"\x94\x25"],"\x96"=>[0,"\x94-"],"\x97"=>[0,"\x94."],"\x98"=>[0,"\x94\x2F"],"\x99"=>[0,"\x943"],"\x9A"=>[0,"\x944"],"\x9B"=>[0,"\x945"],"\x9C"=>[0,"\x946"],"\x9D"=>[0,"\x947"],"\x9E"=>[0,"\x948"],"\x9F"=>[0,"\x949"],"\xA0"=>[0,"\x94\x3D"],"\xA1"=>[0,"\x94A"],"\xA2"=>[0,"\x94_"],"\xA3"=>[0,"\x94b"],"\xA4"=>[0,"\x94d"],"\xA5"=>[0,"\x94f"],"\xA6"=>[0,"\x94g"],"\xA7"=>[0,"\x94h"],"\xA8"=>[0,"\x94l"],"\xA9"=>[0,"\x94m"],"\xAA"=>[0,"\x94n"],"\xAB"=>[0,"\x94p"],"\xAC"=>[0,"\x94r"],"\xAD"=>[0,"\x94u"],"\xAE"=>[100,"\x94"],"\xAF"=>[110,"\x94"],"\xB0"=>[111,"\x94"],"\xB1"=>[115,"\x94"],"\xB2"=>[116,"\x94"],"\xB3"=>[118,"\x94"],"\xB4"=>[119,"\x94"],"\xB5"=>[122,"\x94"],"\xB6"=>[123,"\x94"],"\xB7"=>[125,"\x94"],"\xB8"=>[126,"\x94"],"\xB9"=>[129,"\x94"],"\xBA"=>[143,"\x94"],"\xBB"=>[148,"\x94"],"\xBC"=>[151,"\x94"],"\xBD"=>[153,"\x94"],"\xBE"=>[83,"\x94"],"\xBF"=>[10,"\x94"],"\xC0"=>[77,"\x9F0"],"\xC1"=>[18,"\x9F0"],"\xC2"=>[77,"\x9F1"],"\xC3"=>[18,"\x9F1"],"\xC4"=>[77,"\x9F2"],"\xC5"=>[18,"\x9F2"],"\xC6"=>[77,"\x9Fa"],"\xC7"=>[18,"\x9Fa"],"\xC8"=>[77,"\x9Fc"],"\xC9"=>[18,"\x9Fc"],"\xCA"=>[77,"\x9Fe"],"\xCB"=>[18,"\x9Fe"],"\xCC"=>[77,"\x9Fi"],"\xCD"=>[18,"\x9Fi"],"\xCE"=>[77,"\x9Fo"],"\xCF"=>[18,"\x9Fo"],"\xD0"=>[77,"\x9Fs"],"\xD1"=>[18,"\x9Fs"],"\xD2"=>[77,"\x9Ft"],"\xD3"=>[18,"\x9Ft"],"\xD4"=>[0,"\x9F\x20"],"\xD5"=>[0,"\x9F\x25"],"\xD6"=>[0,"\x9F-"],"\xD7"=>[0,"\x9F."],"\xD8"=>[0,"\x9F\x2F"],"\xD9"=>[0,"\x9F3"],"\xDA"=>[0,"\x9F4"],"\xDB"=>[0,"\x9F5"],"\xDC"=>[0,"\x9F6"],"\xDD"=>[0,"\x9F7"],"\xDE"=>[0,"\x9F8"],"\xDF"=>[0,"\x9F9"],"\xE0"=>[0,"\x9F\x3D"],"\xE1"=>[0,"\x9FA"],"\xE2"=>[0,"\x9F_"],"\xE3"=>[0,"\x9Fb"],"\xE4"=>[0,"\x9Fd"],"\xE5"=>[0,"\x9Ff"],"\xE6"=>[0,"\x9Fg"],"\xE7"=>[0,"\x9Fh"],"\xE8"=>[0,"\x9Fl"],"\xE9"=>[0,"\x9Fm"],"\xEA"=>[0,"\x9Fn"],"\xEB"=>[0,"\x9Fp"],"\xEC"=>[0,"\x9Fr"],"\xED"=>[0,"\x9Fu"],"\xEE"=>[100,"\x9F"],"\xEF"=>[110,"\x9F"],"\xF0"=>[111,"\x9F"],"\xF1"=>[115,"\x9F"],"\xF2"=>[116,"\x9F"],"\xF3"=>[118,"\x9F"],"\xF4"=>[119,"\x9F"],"\xF5"=>[122,"\x9F"],"\xF6"=>[123,"\x9F"],"\xF7"=>[125,"\x9F"],"\xF8"=>[126,"\x9F"],"\xF9"=>[129,"\x9F"],"\xFA"=>[143,"\x9F"],"\xFB"=>[148,"\x9F"],"\xFC"=>[151,"\x9F"],"\xFD"=>[153,"\x9F"],"\xFE"=>[83,"\x9F"],"\xFF"=>[10,"\x9F"],],["\x00"=>[94,"\x930"],"\x01"=>[76,"\x930"],"\x02"=>[104,"\x930"],"\x03"=>[16,"\x930"],"\x04"=>[94,"\x931"],"\x05"=>[76,"\x931"],"\x06"=>[104,"\x931"],"\x07"=>[16,"\x931"],"\x08"=>[94,"\x932"],"\x09"=>[76,"\x932"],"\x0A"=>[104,"\x932"],"\x0B"=>[16,"\x932"],"\x0C"=>[94,"\x93a"],"\x0D"=>[76,"\x93a"],"\x0E"=>[104,"\x93a"],"\x0F"=>[16,"\x93a"],"\x10"=>[94,"\x93c"],"\x11"=>[76,"\x93c"],"\x12"=>[104,"\x93c"],"\x13"=>[16,"\x93c"],"\x14"=>[94,"\x93e"],"\x15"=>[76,"\x93e"],"\x16"=>[104,"\x93e"],"\x17"=>[16,"\x93e"],"\x18"=>[94,"\x93i"],"\x19"=>[76,"\x93i"],"\x1A"=>[104,"\x93i"],"\x1B"=>[16,"\x93i"],"\x1C"=>[94,"\x93o"],"\x1D"=>[76,"\x93o"],"\x1E"=>[104,"\x93o"],"\x1F"=>[16,"\x93o"],"\x20"=>[94,"\x93s"],"\x21"=>[76,"\x93s"],"\x22"=>[104,"\x93s"],"\x23"=>[16,"\x93s"],"\x24"=>[94,"\x93t"],"\x25"=>[76,"\x93t"],"\x26"=>[104,"\x93t"],"\x27"=>[16,"\x93t"],"\x28"=>[77,"\x93\x20"],"\x29"=>[18,"\x93\x20"],"\x2A"=>[77,"\x93\x25"],"\x2B"=>[18,"\x93\x25"],"\x2C"=>[77,"\x93-"],"-"=>[18,"\x93-"],"."=>[77,"\x93."],"\x2F"=>[18,"\x93."],[77,"\x93\x2F"],[18,"\x93\x2F"],[77,"\x933"],[18,"\x933"],[77,"\x934"],[18,"\x934"],[77,"\x935"],[18,"\x935"],[77,"\x936"],[18,"\x936"],"\x3A"=>[77,"\x937"],"\x3B"=>[18,"\x937"],"\x3C"=>[77,"\x938"],"\x3D"=>[18,"\x938"],"\x3E"=>[77,"\x939"],"\x3F"=>[18,"\x939"],"\x40"=>[77,"\x93\x3D"],"A"=>[18,"\x93\x3D"],"B"=>[77,"\x93A"],"C"=>[18,"\x93A"],"D"=>[77,"\x93_"],"E"=>[18,"\x93_"],"F"=>[77,"\x93b"],"G"=>[18,"\x93b"],"H"=>[77,"\x93d"],"I"=>[18,"\x93d"],"J"=>[77,"\x93f"],"K"=>[18,"\x93f"],"L"=>[77,"\x93g"],"M"=>[18,"\x93g"],"N"=>[77,"\x93h"],"O"=>[18,"\x93h"],"P"=>[77,"\x93l"],"Q"=>[18,"\x93l"],"R"=>[77,"\x93m"],"S"=>[18,"\x93m"],"T"=>[77,"\x93n"],"U"=>[18,"\x93n"],"V"=>[77,"\x93p"],"W"=>[18,"\x93p"],"X"=>[77,"\x93r"],"Y"=>[18,"\x93r"],"Z"=>[77,"\x93u"],"\x5B"=>[18,"\x93u"],"\x5C"=>[0,"\x93\x3A"],"\x5D"=>[0,"\x93B"],"\x5E"=>[0,"\x93C"],"_"=>[0,"\x93D"],"\x60"=>[0,"\x93E"],"a"=>[0,"\x93F"],"b"=>[0,"\x93G"],"c"=>[0,"\x93H"],"d"=>[0,"\x93I"],"e"=>[0,"\x93J"],"f"=>[0,"\x93K"],"g"=>[0,"\x93L"],"h"=>[0,"\x93M"],"i"=>[0,"\x93N"],"j"=>[0,"\x93O"],"k"=>[0,"\x93P"],"l"=>[0,"\x93Q"],"m"=>[0,"\x93R"],"n"=>[0,"\x93S"],"o"=>[0,"\x93T"],"p"=>[0,"\x93U"],"q"=>[0,"\x93V"],"r"=>[0,"\x93W"],"s"=>[0,"\x93Y"],"t"=>[0,"\x93j"],"u"=>[0,"\x93k"],"v"=>[0,"\x93q"],"w"=>[0,"\x93v"],"x"=>[0,"\x93w"],"y"=>[0,"\x93x"],"z"=>[0,"\x93y"],"\x7B"=>[0,"\x93z"],"\x7C"=>[82,"\x93"],"\x7D"=>[87,"\x93"],"~"=>[130,"\x93"],"\x7F"=>[9,"\x93"],"\x80"=>[94,"\x950"],"\x81"=>[76,"\x950"],"\x82"=>[104,"\x950"],"\x83"=>[16,"\x950"],"\x84"=>[94,"\x951"],"\x85"=>[76,"\x951"],"\x86"=>[104,"\x951"],"\x87"=>[16,"\x951"],"\x88"=>[94,"\x952"],"\x89"=>[76,"\x952"],"\x8A"=>[104,"\x952"],"\x8B"=>[16,"\x952"],"\x8C"=>[94,"\x95a"],"\x8D"=>[76,"\x95a"],"\x8E"=>[104,"\x95a"],"\x8F"=>[16,"\x95a"],"\x90"=>[94,"\x95c"],"\x91"=>[76,"\x95c"],"\x92"=>[104,"\x95c"],"\x93"=>[16,"\x95c"],"\x94"=>[94,"\x95e"],"\x95"=>[76,"\x95e"],"\x96"=>[104,"\x95e"],"\x97"=>[16,"\x95e"],"\x98"=>[94,"\x95i"],"\x99"=>[76,"\x95i"],"\x9A"=>[104,"\x95i"],"\x9B"=>[16,"\x95i"],"\x9C"=>[94,"\x95o"],"\x9D"=>[76,"\x95o"],"\x9E"=>[104,"\x95o"],"\x9F"=>[16,"\x95o"],"\xA0"=>[94,"\x95s"],"\xA1"=>[76,"\x95s"],"\xA2"=>[104,"\x95s"],"\xA3"=>[16,"\x95s"],"\xA4"=>[94,"\x95t"],"\xA5"=>[76,"\x95t"],"\xA6"=>[104,"\x95t"],"\xA7"=>[16,"\x95t"],"\xA8"=>[77,"\x95\x20"],"\xA9"=>[18,"\x95\x20"],"\xAA"=>[77,"\x95\x25"],"\xAB"=>[18,"\x95\x25"],"\xAC"=>[77,"\x95-"],"\xAD"=>[18,"\x95-"],"\xAE"=>[77,"\x95."],"\xAF"=>[18,"\x95."],"\xB0"=>[77,"\x95\x2F"],"\xB1"=>[18,"\x95\x2F"],"\xB2"=>[77,"\x953"],"\xB3"=>[18,"\x953"],"\xB4"=>[77,"\x954"],"\xB5"=>[18,"\x954"],"\xB6"=>[77,"\x955"],"\xB7"=>[18,"\x955"],"\xB8"=>[77,"\x956"],"\xB9"=>[18,"\x956"],"\xBA"=>[77,"\x957"],"\xBB"=>[18,"\x957"],"\xBC"=>[77,"\x958"],"\xBD"=>[18,"\x958"],"\xBE"=>[77,"\x959"],"\xBF"=>[18,"\x959"],"\xC0"=>[77,"\x95\x3D"],"\xC1"=>[18,"\x95\x3D"],"\xC2"=>[77,"\x95A"],"\xC3"=>[18,"\x95A"],"\xC4"=>[77,"\x95_"],"\xC5"=>[18,"\x95_"],"\xC6"=>[77,"\x95b"],"\xC7"=>[18,"\x95b"],"\xC8"=>[77,"\x95d"],"\xC9"=>[18,"\x95d"],"\xCA"=>[77,"\x95f"],"\xCB"=>[18,"\x95f"],"\xCC"=>[77,"\x95g"],"\xCD"=>[18,"\x95g"],"\xCE"=>[77,"\x95h"],"\xCF"=>[18,"\x95h"],"\xD0"=>[77,"\x95l"],"\xD1"=>[18,"\x95l"],"\xD2"=>[77,"\x95m"],"\xD3"=>[18,"\x95m"],"\xD4"=>[77,"\x95n"],"\xD5"=>[18,"\x95n"],"\xD6"=>[77,"\x95p"],"\xD7"=>[18,"\x95p"],"\xD8"=>[77,"\x95r"],"\xD9"=>[18,"\x95r"],"\xDA"=>[77,"\x95u"],"\xDB"=>[18,"\x95u"],"\xDC"=>[0,"\x95\x3A"],"\xDD"=>[0,"\x95B"],"\xDE"=>[0,"\x95C"],"\xDF"=>[0,"\x95D"],"\xE0"=>[0,"\x95E"],"\xE1"=>[0,"\x95F"],"\xE2"=>[0,"\x95G"],"\xE3"=>[0,"\x95H"],"\xE4"=>[0,"\x95I"],"\xE5"=>[0,"\x95J"],"\xE6"=>[0,"\x95K"],"\xE7"=>[0,"\x95L"],"\xE8"=>[0,"\x95M"],"\xE9"=>[0,"\x95N"],"\xEA"=>[0,"\x95O"],"\xEB"=>[0,"\x95P"],"\xEC"=>[0,"\x95Q"],"\xED"=>[0,"\x95R"],"\xEE"=>[0,"\x95S"],"\xEF"=>[0,"\x95T"],"\xF0"=>[0,"\x95U"],"\xF1"=>[0,"\x95V"],"\xF2"=>[0,"\x95W"],"\xF3"=>[0,"\x95Y"],"\xF4"=>[0,"\x95j"],"\xF5"=>[0,"\x95k"],"\xF6"=>[0,"\x95q"],"\xF7"=>[0,"\x95v"],"\xF8"=>[0,"\x95w"],"\xF9"=>[0,"\x95x"],"\xFA"=>[0,"\x95y"],"\xFB"=>[0,"\x95z"],"\xFC"=>[82,"\x95"],"\xFD"=>[87,"\x95"],"\xFE"=>[130,"\x95"],"\xFF"=>[9,"\x95"],],["\x00"=>[77,"\x930"],"\x01"=>[18,"\x930"],"\x02"=>[77,"\x931"],"\x03"=>[18,"\x931"],"\x04"=>[77,"\x932"],"\x05"=>[18,"\x932"],"\x06"=>[77,"\x93a"],"\x07"=>[18,"\x93a"],"\x08"=>[77,"\x93c"],"\x09"=>[18,"\x93c"],"\x0A"=>[77,"\x93e"],"\x0B"=>[18,"\x93e"],"\x0C"=>[77,"\x93i"],"\x0D"=>[18,"\x93i"],"\x0E"=>[77,"\x93o"],"\x0F"=>[18,"\x93o"],"\x10"=>[77,"\x93s"],"\x11"=>[18,"\x93s"],"\x12"=>[77,"\x93t"],"\x13"=>[18,"\x93t"],"\x14"=>[0,"\x93\x20"],"\x15"=>[0,"\x93\x25"],"\x16"=>[0,"\x93-"],"\x17"=>[0,"\x93."],"\x18"=>[0,"\x93\x2F"],"\x19"=>[0,"\x933"],"\x1A"=>[0,"\x934"],"\x1B"=>[0,"\x935"],"\x1C"=>[0,"\x936"],"\x1D"=>[0,"\x937"],"\x1E"=>[0,"\x938"],"\x1F"=>[0,"\x939"],"\x20"=>[0,"\x93\x3D"],"\x21"=>[0,"\x93A"],"\x22"=>[0,"\x93_"],"\x23"=>[0,"\x93b"],"\x24"=>[0,"\x93d"],"\x25"=>[0,"\x93f"],"\x26"=>[0,"\x93g"],"\x27"=>[0,"\x93h"],"\x28"=>[0,"\x93l"],"\x29"=>[0,"\x93m"],"\x2A"=>[0,"\x93n"],"\x2B"=>[0,"\x93p"],"\x2C"=>[0,"\x93r"],"-"=>[0,"\x93u"],"."=>[100,"\x93"],"\x2F"=>[110,"\x93"],[111,"\x93"],[115,"\x93"],[116,"\x93"],[118,"\x93"],[119,"\x93"],[122,"\x93"],[123,"\x93"],[125,"\x93"],[126,"\x93"],[129,"\x93"],"\x3A"=>[143,"\x93"],"\x3B"=>[148,"\x93"],"\x3C"=>[151,"\x93"],"\x3D"=>[153,"\x93"],"\x3E"=>[83,"\x93"],"\x3F"=>[10,"\x93"],"\x40"=>[77,"\x950"],"A"=>[18,"\x950"],"B"=>[77,"\x951"],"C"=>[18,"\x951"],"D"=>[77,"\x952"],"E"=>[18,"\x952"],"F"=>[77,"\x95a"],"G"=>[18,"\x95a"],"H"=>[77,"\x95c"],"I"=>[18,"\x95c"],"J"=>[77,"\x95e"],"K"=>[18,"\x95e"],"L"=>[77,"\x95i"],"M"=>[18,"\x95i"],"N"=>[77,"\x95o"],"O"=>[18,"\x95o"],"P"=>[77,"\x95s"],"Q"=>[18,"\x95s"],"R"=>[77,"\x95t"],"S"=>[18,"\x95t"],"T"=>[0,"\x95\x20"],"U"=>[0,"\x95\x25"],"V"=>[0,"\x95-"],"W"=>[0,"\x95."],"X"=>[0,"\x95\x2F"],"Y"=>[0,"\x953"],"Z"=>[0,"\x954"],"\x5B"=>[0,"\x955"],"\x5C"=>[0,"\x956"],"\x5D"=>[0,"\x957"],"\x5E"=>[0,"\x958"],"_"=>[0,"\x959"],"\x60"=>[0,"\x95\x3D"],"a"=>[0,"\x95A"],"b"=>[0,"\x95_"],"c"=>[0,"\x95b"],"d"=>[0,"\x95d"],"e"=>[0,"\x95f"],"f"=>[0,"\x95g"],"g"=>[0,"\x95h"],"h"=>[0,"\x95l"],"i"=>[0,"\x95m"],"j"=>[0,"\x95n"],"k"=>[0,"\x95p"],"l"=>[0,"\x95r"],"m"=>[0,"\x95u"],"n"=>[100,"\x95"],"o"=>[110,"\x95"],"p"=>[111,"\x95"],"q"=>[115,"\x95"],"r"=>[116,"\x95"],"s"=>[118,"\x95"],"t"=>[119,"\x95"],"u"=>[122,"\x95"],"v"=>[123,"\x95"],"w"=>[125,"\x95"],"x"=>[126,"\x95"],"y"=>[129,"\x95"],"z"=>[143,"\x95"],"\x7B"=>[148,"\x95"],"\x7C"=>[151,"\x95"],"\x7D"=>[153,"\x95"],"~"=>[83,"\x95"],"\x7F"=>[10,"\x95"],"\x80"=>[77,"\x960"],"\x81"=>[18,"\x960"],"\x82"=>[77,"\x961"],"\x83"=>[18,"\x961"],"\x84"=>[77,"\x962"],"\x85"=>[18,"\x962"],"\x86"=>[77,"\x96a"],"\x87"=>[18,"\x96a"],"\x88"=>[77,"\x96c"],"\x89"=>[18,"\x96c"],"\x8A"=>[77,"\x96e"],"\x8B"=>[18,"\x96e"],"\x8C"=>[77,"\x96i"],"\x8D"=>[18,"\x96i"],"\x8E"=>[77,"\x96o"],"\x8F"=>[18,"\x96o"],"\x90"=>[77,"\x96s"],"\x91"=>[18,"\x96s"],"\x92"=>[77,"\x96t"],"\x93"=>[18,"\x96t"],"\x94"=>[0,"\x96\x20"],"\x95"=>[0,"\x96\x25"],"\x96"=>[0,"\x96-"],"\x97"=>[0,"\x96."],"\x98"=>[0,"\x96\x2F"],"\x99"=>[0,"\x963"],"\x9A"=>[0,"\x964"],"\x9B"=>[0,"\x965"],"\x9C"=>[0,"\x966"],"\x9D"=>[0,"\x967"],"\x9E"=>[0,"\x968"],"\x9F"=>[0,"\x969"],"\xA0"=>[0,"\x96\x3D"],"\xA1"=>[0,"\x96A"],"\xA2"=>[0,"\x96_"],"\xA3"=>[0,"\x96b"],"\xA4"=>[0,"\x96d"],"\xA5"=>[0,"\x96f"],"\xA6"=>[0,"\x96g"],"\xA7"=>[0,"\x96h"],"\xA8"=>[0,"\x96l"],"\xA9"=>[0,"\x96m"],"\xAA"=>[0,"\x96n"],"\xAB"=>[0,"\x96p"],"\xAC"=>[0,"\x96r"],"\xAD"=>[0,"\x96u"],"\xAE"=>[100,"\x96"],"\xAF"=>[110,"\x96"],"\xB0"=>[111,"\x96"],"\xB1"=>[115,"\x96"],"\xB2"=>[116,"\x96"],"\xB3"=>[118,"\x96"],"\xB4"=>[119,"\x96"],"\xB5"=>[122,"\x96"],"\xB6"=>[123,"\x96"],"\xB7"=>[125,"\x96"],"\xB8"=>[126,"\x96"],"\xB9"=>[129,"\x96"],"\xBA"=>[143,"\x96"],"\xBB"=>[148,"\x96"],"\xBC"=>[151,"\x96"],"\xBD"=>[153,"\x96"],"\xBE"=>[83,"\x96"],"\xBF"=>[10,"\x96"],"\xC0"=>[77,"\x970"],"\xC1"=>[18,"\x970"],"\xC2"=>[77,"\x971"],"\xC3"=>[18,"\x971"],"\xC4"=>[77,"\x972"],"\xC5"=>[18,"\x972"],"\xC6"=>[77,"\x97a"],"\xC7"=>[18,"\x97a"],"\xC8"=>[77,"\x97c"],"\xC9"=>[18,"\x97c"],"\xCA"=>[77,"\x97e"],"\xCB"=>[18,"\x97e"],"\xCC"=>[77,"\x97i"],"\xCD"=>[18,"\x97i"],"\xCE"=>[77,"\x97o"],"\xCF"=>[18,"\x97o"],"\xD0"=>[77,"\x97s"],"\xD1"=>[18,"\x97s"],"\xD2"=>[77,"\x97t"],"\xD3"=>[18,"\x97t"],"\xD4"=>[0,"\x97\x20"],"\xD5"=>[0,"\x97\x25"],"\xD6"=>[0,"\x97-"],"\xD7"=>[0,"\x97."],"\xD8"=>[0,"\x97\x2F"],"\xD9"=>[0,"\x973"],"\xDA"=>[0,"\x974"],"\xDB"=>[0,"\x975"],"\xDC"=>[0,"\x976"],"\xDD"=>[0,"\x977"],"\xDE"=>[0,"\x978"],"\xDF"=>[0,"\x979"],"\xE0"=>[0,"\x97\x3D"],"\xE1"=>[0,"\x97A"],"\xE2"=>[0,"\x97_"],"\xE3"=>[0,"\x97b"],"\xE4"=>[0,"\x97d"],"\xE5"=>[0,"\x97f"],"\xE6"=>[0,"\x97g"],"\xE7"=>[0,"\x97h"],"\xE8"=>[0,"\x97l"],"\xE9"=>[0,"\x97m"],"\xEA"=>[0,"\x97n"],"\xEB"=>[0,"\x97p"],"\xEC"=>[0,"\x97r"],"\xED"=>[0,"\x97u"],"\xEE"=>[100,"\x97"],"\xEF"=>[110,"\x97"],"\xF0"=>[111,"\x97"],"\xF1"=>[115,"\x97"],"\xF2"=>[116,"\x97"],"\xF3"=>[118,"\x97"],"\xF4"=>[119,"\x97"],"\xF5"=>[122,"\x97"],"\xF6"=>[123,"\x97"],"\xF7"=>[125,"\x97"],"\xF8"=>[126,"\x97"],"\xF9"=>[129,"\x97"],"\xFA"=>[143,"\x97"],"\xFB"=>[148,"\x97"],"\xFC"=>[151,"\x97"],"\xFD"=>[153,"\x97"],"\xFE"=>[83,"\x97"],"\xFF"=>[10,"\x97"],],["\x00"=>[0,"\x930"],"\x01"=>[0,"\x931"],"\x02"=>[0,"\x932"],"\x03"=>[0,"\x93a"],"\x04"=>[0,"\x93c"],"\x05"=>[0,"\x93e"],"\x06"=>[0,"\x93i"],"\x07"=>[0,"\x93o"],"\x08"=>[0,"\x93s"],"\x09"=>[0,"\x93t"],"\x0A"=>[73,"\x93"],"\x0B"=>[88,"\x93"],"\x0C"=>[89,"\x93"],"\x0D"=>[96,"\x93"],"\x0E"=>[97,"\x93"],"\x0F"=>[99,"\x93"],"\x10"=>[106,"\x93"],"\x11"=>[136,"\x93"],"\x12"=>[139,"\x93"],"\x13"=>[141,"\x93"],"\x14"=>[145,"\x93"],"\x15"=>[147,"\x93"],"\x16"=>[149,"\x93"],"\x17"=>[101,"\x93"],"\x18"=>[112,"\x93"],"\x19"=>[117,"\x93"],"\x1A"=>[120,"\x93"],"\x1B"=>[124,"\x93"],"\x1C"=>[127,"\x93"],"\x1D"=>[144,"\x93"],"\x1E"=>[152,"\x93"],"\x1F"=>[11,"\x93"],"\x20"=>[0,"\x950"],"\x21"=>[0,"\x951"],"\x22"=>[0,"\x952"],"\x23"=>[0,"\x95a"],"\x24"=>[0,"\x95c"],"\x25"=>[0,"\x95e"],"\x26"=>[0,"\x95i"],"\x27"=>[0,"\x95o"],"\x28"=>[0,"\x95s"],"\x29"=>[0,"\x95t"],"\x2A"=>[73,"\x95"],"\x2B"=>[88,"\x95"],"\x2C"=>[89,"\x95"],"-"=>[96,"\x95"],"."=>[97,"\x95"],"\x2F"=>[99,"\x95"],[106,"\x95"],[136,"\x95"],[139,"\x95"],[141,"\x95"],[145,"\x95"],[147,"\x95"],[149,"\x95"],[101,"\x95"],[112,"\x95"],[117,"\x95"],"\x3A"=>[120,"\x95"],"\x3B"=>[124,"\x95"],"\x3C"=>[127,"\x95"],"\x3D"=>[144,"\x95"],"\x3E"=>[152,"\x95"],"\x3F"=>[11,"\x95"],"\x40"=>[0,"\x960"],"A"=>[0,"\x961"],"B"=>[0,"\x962"],"C"=>[0,"\x96a"],"D"=>[0,"\x96c"],"E"=>[0,"\x96e"],"F"=>[0,"\x96i"],"G"=>[0,"\x96o"],"H"=>[0,"\x96s"],"I"=>[0,"\x96t"],"J"=>[73,"\x96"],"K"=>[88,"\x96"],"L"=>[89,"\x96"],"M"=>[96,"\x96"],"N"=>[97,"\x96"],"O"=>[99,"\x96"],"P"=>[106,"\x96"],"Q"=>[136,"\x96"],"R"=>[139,"\x96"],"S"=>[141,"\x96"],"T"=>[145,"\x96"],"U"=>[147,"\x96"],"V"=>[149,"\x96"],"W"=>[101,"\x96"],"X"=>[112,"\x96"],"Y"=>[117,"\x96"],"Z"=>[120,"\x96"],"\x5B"=>[124,"\x96"],"\x5C"=>[127,"\x96"],"\x5D"=>[144,"\x96"],"\x5E"=>[152,"\x96"],"_"=>[11,"\x96"],"\x60"=>[0,"\x970"],"a"=>[0,"\x971"],"b"=>[0,"\x972"],"c"=>[0,"\x97a"],"d"=>[0,"\x97c"],"e"=>[0,"\x97e"],"f"=>[0,"\x97i"],"g"=>[0,"\x97o"],"h"=>[0,"\x97s"],"i"=>[0,"\x97t"],"j"=>[73,"\x97"],"k"=>[88,"\x97"],"l"=>[89,"\x97"],"m"=>[96,"\x97"],"n"=>[97,"\x97"],"o"=>[99,"\x97"],"p"=>[106,"\x97"],"q"=>[136,"\x97"],"r"=>[139,"\x97"],"s"=>[141,"\x97"],"t"=>[145,"\x97"],"u"=>[147,"\x97"],"v"=>[149,"\x97"],"w"=>[101,"\x97"],"x"=>[112,"\x97"],"y"=>[117,"\x97"],"z"=>[120,"\x97"],"\x7B"=>[124,"\x97"],"\x7C"=>[127,"\x97"],"\x7D"=>[144,"\x97"],"~"=>[152,"\x97"],"\x7F"=>[11,"\x97"],"\x80"=>[0,"\x980"],"\x81"=>[0,"\x981"],"\x82"=>[0,"\x982"],"\x83"=>[0,"\x98a"],"\x84"=>[0,"\x98c"],"\x85"=>[0,"\x98e"],"\x86"=>[0,"\x98i"],"\x87"=>[0,"\x98o"],"\x88"=>[0,"\x98s"],"\x89"=>[0,"\x98t"],"\x8A"=>[73,"\x98"],"\x8B"=>[88,"\x98"],"\x8C"=>[89,"\x98"],"\x8D"=>[96,"\x98"],"\x8E"=>[97,"\x98"],"\x8F"=>[99,"\x98"],"\x90"=>[106,"\x98"],"\x91"=>[136,"\x98"],"\x92"=>[139,"\x98"],"\x93"=>[141,"\x98"],"\x94"=>[145,"\x98"],"\x95"=>[147,"\x98"],"\x96"=>[149,"\x98"],"\x97"=>[101,"\x98"],"\x98"=>[112,"\x98"],"\x99"=>[117,"\x98"],"\x9A"=>[120,"\x98"],"\x9B"=>[124,"\x98"],"\x9C"=>[127,"\x98"],"\x9D"=>[144,"\x98"],"\x9E"=>[152,"\x98"],"\x9F"=>[11,"\x98"],"\xA0"=>[0,"\x9B0"],"\xA1"=>[0,"\x9B1"],"\xA2"=>[0,"\x9B2"],"\xA3"=>[0,"\x9Ba"],"\xA4"=>[0,"\x9Bc"],"\xA5"=>[0,"\x9Be"],"\xA6"=>[0,"\x9Bi"],"\xA7"=>[0,"\x9Bo"],"\xA8"=>[0,"\x9Bs"],"\xA9"=>[0,"\x9Bt"],"\xAA"=>[73,"\x9B"],"\xAB"=>[88,"\x9B"],"\xAC"=>[89,"\x9B"],"\xAD"=>[96,"\x9B"],"\xAE"=>[97,"\x9B"],"\xAF"=>[99,"\x9B"],"\xB0"=>[106,"\x9B"],"\xB1"=>[136,"\x9B"],"\xB2"=>[139,"\x9B"],"\xB3"=>[141,"\x9B"],"\xB4"=>[145,"\x9B"],"\xB5"=>[147,"\x9B"],"\xB6"=>[149,"\x9B"],"\xB7"=>[101,"\x9B"],"\xB8"=>[112,"\x9B"],"\xB9"=>[117,"\x9B"],"\xBA"=>[120,"\x9B"],"\xBB"=>[124,"\x9B"],"\xBC"=>[127,"\x9B"],"\xBD"=>[144,"\x9B"],"\xBE"=>[152,"\x9B"],"\xBF"=>[11,"\x9B"],"\xC0"=>[0,"\x9D0"],"\xC1"=>[0,"\x9D1"],"\xC2"=>[0,"\x9D2"],"\xC3"=>[0,"\x9Da"],"\xC4"=>[0,"\x9Dc"],"\xC5"=>[0,"\x9De"],"\xC6"=>[0,"\x9Di"],"\xC7"=>[0,"\x9Do"],"\xC8"=>[0,"\x9Ds"],"\xC9"=>[0,"\x9Dt"],"\xCA"=>[73,"\x9D"],"\xCB"=>[88,"\x9D"],"\xCC"=>[89,"\x9D"],"\xCD"=>[96,"\x9D"],"\xCE"=>[97,"\x9D"],"\xCF"=>[99,"\x9D"],"\xD0"=>[106,"\x9D"],"\xD1"=>[136,"\x9D"],"\xD2"=>[139,"\x9D"],"\xD3"=>[141,"\x9D"],"\xD4"=>[145,"\x9D"],"\xD5"=>[147,"\x9D"],"\xD6"=>[149,"\x9D"],"\xD7"=>[101,"\x9D"],"\xD8"=>[112,"\x9D"],"\xD9"=>[117,"\x9D"],"\xDA"=>[120,"\x9D"],"\xDB"=>[124,"\x9D"],"\xDC"=>[127,"\x9D"],"\xDD"=>[144,"\x9D"],"\xDE"=>[152,"\x9D"],"\xDF"=>[11,"\x9D"],"\xE0"=>[0,"\x9E0"],"\xE1"=>[0,"\x9E1"],"\xE2"=>[0,"\x9E2"],"\xE3"=>[0,"\x9Ea"],"\xE4"=>[0,"\x9Ec"],"\xE5"=>[0,"\x9Ee"],"\xE6"=>[0,"\x9Ei"],"\xE7"=>[0,"\x9Eo"],"\xE8"=>[0,"\x9Es"],"\xE9"=>[0,"\x9Et"],"\xEA"=>[73,"\x9E"],"\xEB"=>[88,"\x9E"],"\xEC"=>[89,"\x9E"],"\xED"=>[96,"\x9E"],"\xEE"=>[97,"\x9E"],"\xEF"=>[99,"\x9E"],"\xF0"=>[106,"\x9E"],"\xF1"=>[136,"\x9E"],"\xF2"=>[139,"\x9E"],"\xF3"=>[141,"\x9E"],"\xF4"=>[145,"\x9E"],"\xF5"=>[147,"\x9E"],"\xF6"=>[149,"\x9E"],"\xF7"=>[101,"\x9E"],"\xF8"=>[112,"\x9E"],"\xF9"=>[117,"\x9E"],"\xFA"=>[120,"\x9E"],"\xFB"=>[124,"\x9E"],"\xFC"=>[127,"\x9E"],"\xFD"=>[144,"\x9E"],"\xFE"=>[152,"\x9E"],"\xFF"=>[11,"\x9E"],],["\x00"=>[92,"\x93"],"\x01"=>[95,"\x93"],"\x02"=>[137,"\x93"],"\x03"=>[142,"\x93"],"\x04"=>[150,"\x93"],"\x05"=>[74,"\x93"],"\x06"=>[90,"\x93"],"\x07"=>[98,"\x93"],"\x08"=>[107,"\x93"],"\x09"=>[140,"\x93"],"\x0A"=>[146,"\x93"],"\x0B"=>[102,"\x93"],"\x0C"=>[113,"\x93"],"\x0D"=>[121,"\x93"],"\x0E"=>[128,"\x93"],"\x0F"=>[12,"\x93"],"\x10"=>[92,"\x95"],"\x11"=>[95,"\x95"],"\x12"=>[137,"\x95"],"\x13"=>[142,"\x95"],"\x14"=>[150,"\x95"],"\x15"=>[74,"\x95"],"\x16"=>[90,"\x95"],"\x17"=>[98,"\x95"],"\x18"=>[107,"\x95"],"\x19"=>[140,"\x95"],"\x1A"=>[146,"\x95"],"\x1B"=>[102,"\x95"],"\x1C"=>[113,"\x95"],"\x1D"=>[121,"\x95"],"\x1E"=>[128,"\x95"],"\x1F"=>[12,"\x95"],"\x20"=>[92,"\x96"],"\x21"=>[95,"\x96"],"\x22"=>[137,"\x96"],"\x23"=>[142,"\x96"],"\x24"=>[150,"\x96"],"\x25"=>[74,"\x96"],"\x26"=>[90,"\x96"],"\x27"=>[98,"\x96"],"\x28"=>[107,"\x96"],"\x29"=>[140,"\x96"],"\x2A"=>[146,"\x96"],"\x2B"=>[102,"\x96"],"\x2C"=>[113,"\x96"],"-"=>[121,"\x96"],"."=>[128,"\x96"],"\x2F"=>[12,"\x96"],[92,"\x97"],[95,"\x97"],[137,"\x97"],[142,"\x97"],[150,"\x97"],[74,"\x97"],[90,"\x97"],[98,"\x97"],[107,"\x97"],[140,"\x97"],"\x3A"=>[146,"\x97"],"\x3B"=>[102,"\x97"],"\x3C"=>[113,"\x97"],"\x3D"=>[121,"\x97"],"\x3E"=>[128,"\x97"],"\x3F"=>[12,"\x97"],"\x40"=>[92,"\x98"],"A"=>[95,"\x98"],"B"=>[137,"\x98"],"C"=>[142,"\x98"],"D"=>[150,"\x98"],"E"=>[74,"\x98"],"F"=>[90,"\x98"],"G"=>[98,"\x98"],"H"=>[107,"\x98"],"I"=>[140,"\x98"],"J"=>[146,"\x98"],"K"=>[102,"\x98"],"L"=>[113,"\x98"],"M"=>[121,"\x98"],"N"=>[128,"\x98"],"O"=>[12,"\x98"],"P"=>[92,"\x9B"],"Q"=>[95,"\x9B"],"R"=>[137,"\x9B"],"S"=>[142,"\x9B"],"T"=>[150,"\x9B"],"U"=>[74,"\x9B"],"V"=>[90,"\x9B"],"W"=>[98,"\x9B"],"X"=>[107,"\x9B"],"Y"=>[140,"\x9B"],"Z"=>[146,"\x9B"],"\x5B"=>[102,"\x9B"],"\x5C"=>[113,"\x9B"],"\x5D"=>[121,"\x9B"],"\x5E"=>[128,"\x9B"],"_"=>[12,"\x9B"],"\x60"=>[92,"\x9D"],"a"=>[95,"\x9D"],"b"=>[137,"\x9D"],"c"=>[142,"\x9D"],"d"=>[150,"\x9D"],"e"=>[74,"\x9D"],"f"=>[90,"\x9D"],"g"=>[98,"\x9D"],"h"=>[107,"\x9D"],"i"=>[140,"\x9D"],"j"=>[146,"\x9D"],"k"=>[102,"\x9D"],"l"=>[113,"\x9D"],"m"=>[121,"\x9D"],"n"=>[128,"\x9D"],"o"=>[12,"\x9D"],"p"=>[92,"\x9E"],"q"=>[95,"\x9E"],"r"=>[137,"\x9E"],"s"=>[142,"\x9E"],"t"=>[150,"\x9E"],"u"=>[74,"\x9E"],"v"=>[90,"\x9E"],"w"=>[98,"\x9E"],"x"=>[107,"\x9E"],"y"=>[140,"\x9E"],"z"=>[146,"\x9E"],"\x7B"=>[102,"\x9E"],"\x7C"=>[113,"\x9E"],"\x7D"=>[121,"\x9E"],"~"=>[128,"\x9E"],"\x7F"=>[12,"\x9E"],"\x80"=>[92,"\xA5"],"\x81"=>[95,"\xA5"],"\x82"=>[137,"\xA5"],"\x83"=>[142,"\xA5"],"\x84"=>[150,"\xA5"],"\x85"=>[74,"\xA5"],"\x86"=>[90,"\xA5"],"\x87"=>[98,"\xA5"],"\x88"=>[107,"\xA5"],"\x89"=>[140,"\xA5"],"\x8A"=>[146,"\xA5"],"\x8B"=>[102,"\xA5"],"\x8C"=>[113,"\xA5"],"\x8D"=>[121,"\xA5"],"\x8E"=>[128,"\xA5"],"\x8F"=>[12,"\xA5"],"\x90"=>[92,"\xA6"],"\x91"=>[95,"\xA6"],"\x92"=>[137,"\xA6"],"\x93"=>[142,"\xA6"],"\x94"=>[150,"\xA6"],"\x95"=>[74,"\xA6"],"\x96"=>[90,"\xA6"],"\x97"=>[98,"\xA6"],"\x98"=>[107,"\xA6"],"\x99"=>[140,"\xA6"],"\x9A"=>[146,"\xA6"],"\x9B"=>[102,"\xA6"],"\x9C"=>[113,"\xA6"],"\x9D"=>[121,"\xA6"],"\x9E"=>[128,"\xA6"],"\x9F"=>[12,"\xA6"],"\xA0"=>[92,"\xA8"],"\xA1"=>[95,"\xA8"],"\xA2"=>[137,"\xA8"],"\xA3"=>[142,"\xA8"],"\xA4"=>[150,"\xA8"],"\xA5"=>[74,"\xA8"],"\xA6"=>[90,"\xA8"],"\xA7"=>[98,"\xA8"],"\xA8"=>[107,"\xA8"],"\xA9"=>[140,"\xA8"],"\xAA"=>[146,"\xA8"],"\xAB"=>[102,"\xA8"],"\xAC"=>[113,"\xA8"],"\xAD"=>[121,"\xA8"],"\xAE"=>[128,"\xA8"],"\xAF"=>[12,"\xA8"],"\xB0"=>[92,"\xAE"],"\xB1"=>[95,"\xAE"],"\xB2"=>[137,"\xAE"],"\xB3"=>[142,"\xAE"],"\xB4"=>[150,"\xAE"],"\xB5"=>[74,"\xAE"],"\xB6"=>[90,"\xAE"],"\xB7"=>[98,"\xAE"],"\xB8"=>[107,"\xAE"],"\xB9"=>[140,"\xAE"],"\xBA"=>[146,"\xAE"],"\xBB"=>[102,"\xAE"],"\xBC"=>[113,"\xAE"],"\xBD"=>[121,"\xAE"],"\xBE"=>[128,"\xAE"],"\xBF"=>[12,"\xAE"],"\xC0"=>[92,"\xAF"],"\xC1"=>[95,"\xAF"],"\xC2"=>[137,"\xAF"],"\xC3"=>[142,"\xAF"],"\xC4"=>[150,"\xAF"],"\xC5"=>[74,"\xAF"],"\xC6"=>[90,"\xAF"],"\xC7"=>[98,"\xAF"],"\xC8"=>[107,"\xAF"],"\xC9"=>[140,"\xAF"],"\xCA"=>[146,"\xAF"],"\xCB"=>[102,"\xAF"],"\xCC"=>[113,"\xAF"],"\xCD"=>[121,"\xAF"],"\xCE"=>[128,"\xAF"],"\xCF"=>[12,"\xAF"],"\xD0"=>[92,"\xB4"],"\xD1"=>[95,"\xB4"],"\xD2"=>[137,"\xB4"],"\xD3"=>[142,"\xB4"],"\xD4"=>[150,"\xB4"],"\xD5"=>[74,"\xB4"],"\xD6"=>[90,"\xB4"],"\xD7"=>[98,"\xB4"],"\xD8"=>[107,"\xB4"],"\xD9"=>[140,"\xB4"],"\xDA"=>[146,"\xB4"],"\xDB"=>[102,"\xB4"],"\xDC"=>[113,"\xB4"],"\xDD"=>[121,"\xB4"],"\xDE"=>[128,"\xB4"],"\xDF"=>[12,"\xB4"],"\xE0"=>[92,"\xB6"],"\xE1"=>[95,"\xB6"],"\xE2"=>[137,"\xB6"],"\xE3"=>[142,"\xB6"],"\xE4"=>[150,"\xB6"],"\xE5"=>[74,"\xB6"],"\xE6"=>[90,"\xB6"],"\xE7"=>[98,"\xB6"],"\xE8"=>[107,"\xB6"],"\xE9"=>[140,"\xB6"],"\xEA"=>[146,"\xB6"],"\xEB"=>[102,"\xB6"],"\xEC"=>[113,"\xB6"],"\xED"=>[121,"\xB6"],"\xEE"=>[128,"\xB6"],"\xEF"=>[12,"\xB6"],"\xF0"=>[92,"\xB7"],"\xF1"=>[95,"\xB7"],"\xF2"=>[137,"\xB7"],"\xF3"=>[142,"\xB7"],"\xF4"=>[150,"\xB7"],"\xF5"=>[74,"\xB7"],"\xF6"=>[90,"\xB7"],"\xF7"=>[98,"\xB7"],"\xF8"=>[107,"\xB7"],"\xF9"=>[140,"\xB7"],"\xFA"=>[146,"\xB7"],"\xFB"=>[102,"\xB7"],"\xFC"=>[113,"\xB7"],"\xFD"=>[121,"\xB7"],"\xFE"=>[128,"\xB7"],"\xFF"=>[12,"\xB7"],],["\x00"=>[94,"\x940"],"\x01"=>[76,"\x940"],"\x02"=>[104,"\x940"],"\x03"=>[16,"\x940"],"\x04"=>[94,"\x941"],"\x05"=>[76,"\x941"],"\x06"=>[104,"\x941"],"\x07"=>[16,"\x941"],"\x08"=>[94,"\x942"],"\x09"=>[76,"\x942"],"\x0A"=>[104,"\x942"],"\x0B"=>[16,"\x942"],"\x0C"=>[94,"\x94a"],"\x0D"=>[76,"\x94a"],"\x0E"=>[104,"\x94a"],"\x0F"=>[16,"\x94a"],"\x10"=>[94,"\x94c"],"\x11"=>[76,"\x94c"],"\x12"=>[104,"\x94c"],"\x13"=>[16,"\x94c"],"\x14"=>[94,"\x94e"],"\x15"=>[76,"\x94e"],"\x16"=>[104,"\x94e"],"\x17"=>[16,"\x94e"],"\x18"=>[94,"\x94i"],"\x19"=>[76,"\x94i"],"\x1A"=>[104,"\x94i"],"\x1B"=>[16,"\x94i"],"\x1C"=>[94,"\x94o"],"\x1D"=>[76,"\x94o"],"\x1E"=>[104,"\x94o"],"\x1F"=>[16,"\x94o"],"\x20"=>[94,"\x94s"],"\x21"=>[76,"\x94s"],"\x22"=>[104,"\x94s"],"\x23"=>[16,"\x94s"],"\x24"=>[94,"\x94t"],"\x25"=>[76,"\x94t"],"\x26"=>[104,"\x94t"],"\x27"=>[16,"\x94t"],"\x28"=>[77,"\x94\x20"],"\x29"=>[18,"\x94\x20"],"\x2A"=>[77,"\x94\x25"],"\x2B"=>[18,"\x94\x25"],"\x2C"=>[77,"\x94-"],"-"=>[18,"\x94-"],"."=>[77,"\x94."],"\x2F"=>[18,"\x94."],[77,"\x94\x2F"],[18,"\x94\x2F"],[77,"\x943"],[18,"\x943"],[77,"\x944"],[18,"\x944"],[77,"\x945"],[18,"\x945"],[77,"\x946"],[18,"\x946"],"\x3A"=>[77,"\x947"],"\x3B"=>[18,"\x947"],"\x3C"=>[77,"\x948"],"\x3D"=>[18,"\x948"],"\x3E"=>[77,"\x949"],"\x3F"=>[18,"\x949"],"\x40"=>[77,"\x94\x3D"],"A"=>[18,"\x94\x3D"],"B"=>[77,"\x94A"],"C"=>[18,"\x94A"],"D"=>[77,"\x94_"],"E"=>[18,"\x94_"],"F"=>[77,"\x94b"],"G"=>[18,"\x94b"],"H"=>[77,"\x94d"],"I"=>[18,"\x94d"],"J"=>[77,"\x94f"],"K"=>[18,"\x94f"],"L"=>[77,"\x94g"],"M"=>[18,"\x94g"],"N"=>[77,"\x94h"],"O"=>[18,"\x94h"],"P"=>[77,"\x94l"],"Q"=>[18,"\x94l"],"R"=>[77,"\x94m"],"S"=>[18,"\x94m"],"T"=>[77,"\x94n"],"U"=>[18,"\x94n"],"V"=>[77,"\x94p"],"W"=>[18,"\x94p"],"X"=>[77,"\x94r"],"Y"=>[18,"\x94r"],"Z"=>[77,"\x94u"],"\x5B"=>[18,"\x94u"],"\x5C"=>[0,"\x94\x3A"],"\x5D"=>[0,"\x94B"],"\x5E"=>[0,"\x94C"],"_"=>[0,"\x94D"],"\x60"=>[0,"\x94E"],"a"=>[0,"\x94F"],"b"=>[0,"\x94G"],"c"=>[0,"\x94H"],"d"=>[0,"\x94I"],"e"=>[0,"\x94J"],"f"=>[0,"\x94K"],"g"=>[0,"\x94L"],"h"=>[0,"\x94M"],"i"=>[0,"\x94N"],"j"=>[0,"\x94O"],"k"=>[0,"\x94P"],"l"=>[0,"\x94Q"],"m"=>[0,"\x94R"],"n"=>[0,"\x94S"],"o"=>[0,"\x94T"],"p"=>[0,"\x94U"],"q"=>[0,"\x94V"],"r"=>[0,"\x94W"],"s"=>[0,"\x94Y"],"t"=>[0,"\x94j"],"u"=>[0,"\x94k"],"v"=>[0,"\x94q"],"w"=>[0,"\x94v"],"x"=>[0,"\x94w"],"y"=>[0,"\x94x"],"z"=>[0,"\x94y"],"\x7B"=>[0,"\x94z"],"\x7C"=>[82,"\x94"],"\x7D"=>[87,"\x94"],"~"=>[130,"\x94"],"\x7F"=>[9,"\x94"],"\x80"=>[94,"\x9F0"],"\x81"=>[76,"\x9F0"],"\x82"=>[104,"\x9F0"],"\x83"=>[16,"\x9F0"],"\x84"=>[94,"\x9F1"],"\x85"=>[76,"\x9F1"],"\x86"=>[104,"\x9F1"],"\x87"=>[16,"\x9F1"],"\x88"=>[94,"\x9F2"],"\x89"=>[76,"\x9F2"],"\x8A"=>[104,"\x9F2"],"\x8B"=>[16,"\x9F2"],"\x8C"=>[94,"\x9Fa"],"\x8D"=>[76,"\x9Fa"],"\x8E"=>[104,"\x9Fa"],"\x8F"=>[16,"\x9Fa"],"\x90"=>[94,"\x9Fc"],"\x91"=>[76,"\x9Fc"],"\x92"=>[104,"\x9Fc"],"\x93"=>[16,"\x9Fc"],"\x94"=>[94,"\x9Fe"],"\x95"=>[76,"\x9Fe"],"\x96"=>[104,"\x9Fe"],"\x97"=>[16,"\x9Fe"],"\x98"=>[94,"\x9Fi"],"\x99"=>[76,"\x9Fi"],"\x9A"=>[104,"\x9Fi"],"\x9B"=>[16,"\x9Fi"],"\x9C"=>[94,"\x9Fo"],"\x9D"=>[76,"\x9Fo"],"\x9E"=>[104,"\x9Fo"],"\x9F"=>[16,"\x9Fo"],"\xA0"=>[94,"\x9Fs"],"\xA1"=>[76,"\x9Fs"],"\xA2"=>[104,"\x9Fs"],"\xA3"=>[16,"\x9Fs"],"\xA4"=>[94,"\x9Ft"],"\xA5"=>[76,"\x9Ft"],"\xA6"=>[104,"\x9Ft"],"\xA7"=>[16,"\x9Ft"],"\xA8"=>[77,"\x9F\x20"],"\xA9"=>[18,"\x9F\x20"],"\xAA"=>[77,"\x9F\x25"],"\xAB"=>[18,"\x9F\x25"],"\xAC"=>[77,"\x9F-"],"\xAD"=>[18,"\x9F-"],"\xAE"=>[77,"\x9F."],"\xAF"=>[18,"\x9F."],"\xB0"=>[77,"\x9F\x2F"],"\xB1"=>[18,"\x9F\x2F"],"\xB2"=>[77,"\x9F3"],"\xB3"=>[18,"\x9F3"],"\xB4"=>[77,"\x9F4"],"\xB5"=>[18,"\x9F4"],"\xB6"=>[77,"\x9F5"],"\xB7"=>[18,"\x9F5"],"\xB8"=>[77,"\x9F6"],"\xB9"=>[18,"\x9F6"],"\xBA"=>[77,"\x9F7"],"\xBB"=>[18,"\x9F7"],"\xBC"=>[77,"\x9F8"],"\xBD"=>[18,"\x9F8"],"\xBE"=>[77,"\x9F9"],"\xBF"=>[18,"\x9F9"],"\xC0"=>[77,"\x9F\x3D"],"\xC1"=>[18,"\x9F\x3D"],"\xC2"=>[77,"\x9FA"],"\xC3"=>[18,"\x9FA"],"\xC4"=>[77,"\x9F_"],"\xC5"=>[18,"\x9F_"],"\xC6"=>[77,"\x9Fb"],"\xC7"=>[18,"\x9Fb"],"\xC8"=>[77,"\x9Fd"],"\xC9"=>[18,"\x9Fd"],"\xCA"=>[77,"\x9Ff"],"\xCB"=>[18,"\x9Ff"],"\xCC"=>[77,"\x9Fg"],"\xCD"=>[18,"\x9Fg"],"\xCE"=>[77,"\x9Fh"],"\xCF"=>[18,"\x9Fh"],"\xD0"=>[77,"\x9Fl"],"\xD1"=>[18,"\x9Fl"],"\xD2"=>[77,"\x9Fm"],"\xD3"=>[18,"\x9Fm"],"\xD4"=>[77,"\x9Fn"],"\xD5"=>[18,"\x9Fn"],"\xD6"=>[77,"\x9Fp"],"\xD7"=>[18,"\x9Fp"],"\xD8"=>[77,"\x9Fr"],"\xD9"=>[18,"\x9Fr"],"\xDA"=>[77,"\x9Fu"],"\xDB"=>[18,"\x9Fu"],"\xDC"=>[0,"\x9F\x3A"],"\xDD"=>[0,"\x9FB"],"\xDE"=>[0,"\x9FC"],"\xDF"=>[0,"\x9FD"],"\xE0"=>[0,"\x9FE"],"\xE1"=>[0,"\x9FF"],"\xE2"=>[0,"\x9FG"],"\xE3"=>[0,"\x9FH"],"\xE4"=>[0,"\x9FI"],"\xE5"=>[0,"\x9FJ"],"\xE6"=>[0,"\x9FK"],"\xE7"=>[0,"\x9FL"],"\xE8"=>[0,"\x9FM"],"\xE9"=>[0,"\x9FN"],"\xEA"=>[0,"\x9FO"],"\xEB"=>[0,"\x9FP"],"\xEC"=>[0,"\x9FQ"],"\xED"=>[0,"\x9FR"],"\xEE"=>[0,"\x9FS"],"\xEF"=>[0,"\x9FT"],"\xF0"=>[0,"\x9FU"],"\xF1"=>[0,"\x9FV"],"\xF2"=>[0,"\x9FW"],"\xF3"=>[0,"\x9FY"],"\xF4"=>[0,"\x9Fj"],"\xF5"=>[0,"\x9Fk"],"\xF6"=>[0,"\x9Fq"],"\xF7"=>[0,"\x9Fv"],"\xF8"=>[0,"\x9Fw"],"\xF9"=>[0,"\x9Fx"],"\xFA"=>[0,"\x9Fy"],"\xFB"=>[0,"\x9Fz"],"\xFC"=>[82,"\x9F"],"\xFD"=>[87,"\x9F"],"\xFE"=>[130,"\x9F"],"\xFF"=>[9,"\x9F"],],["\x00"=>[94,"\x960"],"\x01"=>[76,"\x960"],"\x02"=>[104,"\x960"],"\x03"=>[16,"\x960"],"\x04"=>[94,"\x961"],"\x05"=>[76,"\x961"],"\x06"=>[104,"\x961"],"\x07"=>[16,"\x961"],"\x08"=>[94,"\x962"],"\x09"=>[76,"\x962"],"\x0A"=>[104,"\x962"],"\x0B"=>[16,"\x962"],"\x0C"=>[94,"\x96a"],"\x0D"=>[76,"\x96a"],"\x0E"=>[104,"\x96a"],"\x0F"=>[16,"\x96a"],"\x10"=>[94,"\x96c"],"\x11"=>[76,"\x96c"],"\x12"=>[104,"\x96c"],"\x13"=>[16,"\x96c"],"\x14"=>[94,"\x96e"],"\x15"=>[76,"\x96e"],"\x16"=>[104,"\x96e"],"\x17"=>[16,"\x96e"],"\x18"=>[94,"\x96i"],"\x19"=>[76,"\x96i"],"\x1A"=>[104,"\x96i"],"\x1B"=>[16,"\x96i"],"\x1C"=>[94,"\x96o"],"\x1D"=>[76,"\x96o"],"\x1E"=>[104,"\x96o"],"\x1F"=>[16,"\x96o"],"\x20"=>[94,"\x96s"],"\x21"=>[76,"\x96s"],"\x22"=>[104,"\x96s"],"\x23"=>[16,"\x96s"],"\x24"=>[94,"\x96t"],"\x25"=>[76,"\x96t"],"\x26"=>[104,"\x96t"],"\x27"=>[16,"\x96t"],"\x28"=>[77,"\x96\x20"],"\x29"=>[18,"\x96\x20"],"\x2A"=>[77,"\x96\x25"],"\x2B"=>[18,"\x96\x25"],"\x2C"=>[77,"\x96-"],"-"=>[18,"\x96-"],"."=>[77,"\x96."],"\x2F"=>[18,"\x96."],[77,"\x96\x2F"],[18,"\x96\x2F"],[77,"\x963"],[18,"\x963"],[77,"\x964"],[18,"\x964"],[77,"\x965"],[18,"\x965"],[77,"\x966"],[18,"\x966"],"\x3A"=>[77,"\x967"],"\x3B"=>[18,"\x967"],"\x3C"=>[77,"\x968"],"\x3D"=>[18,"\x968"],"\x3E"=>[77,"\x969"],"\x3F"=>[18,"\x969"],"\x40"=>[77,"\x96\x3D"],"A"=>[18,"\x96\x3D"],"B"=>[77,"\x96A"],"C"=>[18,"\x96A"],"D"=>[77,"\x96_"],"E"=>[18,"\x96_"],"F"=>[77,"\x96b"],"G"=>[18,"\x96b"],"H"=>[77,"\x96d"],"I"=>[18,"\x96d"],"J"=>[77,"\x96f"],"K"=>[18,"\x96f"],"L"=>[77,"\x96g"],"M"=>[18,"\x96g"],"N"=>[77,"\x96h"],"O"=>[18,"\x96h"],"P"=>[77,"\x96l"],"Q"=>[18,"\x96l"],"R"=>[77,"\x96m"],"S"=>[18,"\x96m"],"T"=>[77,"\x96n"],"U"=>[18,"\x96n"],"V"=>[77,"\x96p"],"W"=>[18,"\x96p"],"X"=>[77,"\x96r"],"Y"=>[18,"\x96r"],"Z"=>[77,"\x96u"],"\x5B"=>[18,"\x96u"],"\x5C"=>[0,"\x96\x3A"],"\x5D"=>[0,"\x96B"],"\x5E"=>[0,"\x96C"],"_"=>[0,"\x96D"],"\x60"=>[0,"\x96E"],"a"=>[0,"\x96F"],"b"=>[0,"\x96G"],"c"=>[0,"\x96H"],"d"=>[0,"\x96I"],"e"=>[0,"\x96J"],"f"=>[0,"\x96K"],"g"=>[0,"\x96L"],"h"=>[0,"\x96M"],"i"=>[0,"\x96N"],"j"=>[0,"\x96O"],"k"=>[0,"\x96P"],"l"=>[0,"\x96Q"],"m"=>[0,"\x96R"],"n"=>[0,"\x96S"],"o"=>[0,"\x96T"],"p"=>[0,"\x96U"],"q"=>[0,"\x96V"],"r"=>[0,"\x96W"],"s"=>[0,"\x96Y"],"t"=>[0,"\x96j"],"u"=>[0,"\x96k"],"v"=>[0,"\x96q"],"w"=>[0,"\x96v"],"x"=>[0,"\x96w"],"y"=>[0,"\x96x"],"z"=>[0,"\x96y"],"\x7B"=>[0,"\x96z"],"\x7C"=>[82,"\x96"],"\x7D"=>[87,"\x96"],"~"=>[130,"\x96"],"\x7F"=>[9,"\x96"],"\x80"=>[94,"\x970"],"\x81"=>[76,"\x970"],"\x82"=>[104,"\x970"],"\x83"=>[16,"\x970"],"\x84"=>[94,"\x971"],"\x85"=>[76,"\x971"],"\x86"=>[104,"\x971"],"\x87"=>[16,"\x971"],"\x88"=>[94,"\x972"],"\x89"=>[76,"\x972"],"\x8A"=>[104,"\x972"],"\x8B"=>[16,"\x972"],"\x8C"=>[94,"\x97a"],"\x8D"=>[76,"\x97a"],"\x8E"=>[104,"\x97a"],"\x8F"=>[16,"\x97a"],"\x90"=>[94,"\x97c"],"\x91"=>[76,"\x97c"],"\x92"=>[104,"\x97c"],"\x93"=>[16,"\x97c"],"\x94"=>[94,"\x97e"],"\x95"=>[76,"\x97e"],"\x96"=>[104,"\x97e"],"\x97"=>[16,"\x97e"],"\x98"=>[94,"\x97i"],"\x99"=>[76,"\x97i"],"\x9A"=>[104,"\x97i"],"\x9B"=>[16,"\x97i"],"\x9C"=>[94,"\x97o"],"\x9D"=>[76,"\x97o"],"\x9E"=>[104,"\x97o"],"\x9F"=>[16,"\x97o"],"\xA0"=>[94,"\x97s"],"\xA1"=>[76,"\x97s"],"\xA2"=>[104,"\x97s"],"\xA3"=>[16,"\x97s"],"\xA4"=>[94,"\x97t"],"\xA5"=>[76,"\x97t"],"\xA6"=>[104,"\x97t"],"\xA7"=>[16,"\x97t"],"\xA8"=>[77,"\x97\x20"],"\xA9"=>[18,"\x97\x20"],"\xAA"=>[77,"\x97\x25"],"\xAB"=>[18,"\x97\x25"],"\xAC"=>[77,"\x97-"],"\xAD"=>[18,"\x97-"],"\xAE"=>[77,"\x97."],"\xAF"=>[18,"\x97."],"\xB0"=>[77,"\x97\x2F"],"\xB1"=>[18,"\x97\x2F"],"\xB2"=>[77,"\x973"],"\xB3"=>[18,"\x973"],"\xB4"=>[77,"\x974"],"\xB5"=>[18,"\x974"],"\xB6"=>[77,"\x975"],"\xB7"=>[18,"\x975"],"\xB8"=>[77,"\x976"],"\xB9"=>[18,"\x976"],"\xBA"=>[77,"\x977"],"\xBB"=>[18,"\x977"],"\xBC"=>[77,"\x978"],"\xBD"=>[18,"\x978"],"\xBE"=>[77,"\x979"],"\xBF"=>[18,"\x979"],"\xC0"=>[77,"\x97\x3D"],"\xC1"=>[18,"\x97\x3D"],"\xC2"=>[77,"\x97A"],"\xC3"=>[18,"\x97A"],"\xC4"=>[77,"\x97_"],"\xC5"=>[18,"\x97_"],"\xC6"=>[77,"\x97b"],"\xC7"=>[18,"\x97b"],"\xC8"=>[77,"\x97d"],"\xC9"=>[18,"\x97d"],"\xCA"=>[77,"\x97f"],"\xCB"=>[18,"\x97f"],"\xCC"=>[77,"\x97g"],"\xCD"=>[18,"\x97g"],"\xCE"=>[77,"\x97h"],"\xCF"=>[18,"\x97h"],"\xD0"=>[77,"\x97l"],"\xD1"=>[18,"\x97l"],"\xD2"=>[77,"\x97m"],"\xD3"=>[18,"\x97m"],"\xD4"=>[77,"\x97n"],"\xD5"=>[18,"\x97n"],"\xD6"=>[77,"\x97p"],"\xD7"=>[18,"\x97p"],"\xD8"=>[77,"\x97r"],"\xD9"=>[18,"\x97r"],"\xDA"=>[77,"\x97u"],"\xDB"=>[18,"\x97u"],"\xDC"=>[0,"\x97\x3A"],"\xDD"=>[0,"\x97B"],"\xDE"=>[0,"\x97C"],"\xDF"=>[0,"\x97D"],"\xE0"=>[0,"\x97E"],"\xE1"=>[0,"\x97F"],"\xE2"=>[0,"\x97G"],"\xE3"=>[0,"\x97H"],"\xE4"=>[0,"\x97I"],"\xE5"=>[0,"\x97J"],"\xE6"=>[0,"\x97K"],"\xE7"=>[0,"\x97L"],"\xE8"=>[0,"\x97M"],"\xE9"=>[0,"\x97N"],"\xEA"=>[0,"\x97O"],"\xEB"=>[0,"\x97P"],"\xEC"=>[0,"\x97Q"],"\xED"=>[0,"\x97R"],"\xEE"=>[0,"\x97S"],"\xEF"=>[0,"\x97T"],"\xF0"=>[0,"\x97U"],"\xF1"=>[0,"\x97V"],"\xF2"=>[0,"\x97W"],"\xF3"=>[0,"\x97Y"],"\xF4"=>[0,"\x97j"],"\xF5"=>[0,"\x97k"],"\xF6"=>[0,"\x97q"],"\xF7"=>[0,"\x97v"],"\xF8"=>[0,"\x97w"],"\xF9"=>[0,"\x97x"],"\xFA"=>[0,"\x97y"],"\xFB"=>[0,"\x97z"],"\xFC"=>[82,"\x97"],"\xFD"=>[87,"\x97"],"\xFE"=>[130,"\x97"],"\xFF"=>[9,"\x97"],],["\x00"=>[94,"\x980"],"\x01"=>[76,"\x980"],"\x02"=>[104,"\x980"],"\x03"=>[16,"\x980"],"\x04"=>[94,"\x981"],"\x05"=>[76,"\x981"],"\x06"=>[104,"\x981"],"\x07"=>[16,"\x981"],"\x08"=>[94,"\x982"],"\x09"=>[76,"\x982"],"\x0A"=>[104,"\x982"],"\x0B"=>[16,"\x982"],"\x0C"=>[94,"\x98a"],"\x0D"=>[76,"\x98a"],"\x0E"=>[104,"\x98a"],"\x0F"=>[16,"\x98a"],"\x10"=>[94,"\x98c"],"\x11"=>[76,"\x98c"],"\x12"=>[104,"\x98c"],"\x13"=>[16,"\x98c"],"\x14"=>[94,"\x98e"],"\x15"=>[76,"\x98e"],"\x16"=>[104,"\x98e"],"\x17"=>[16,"\x98e"],"\x18"=>[94,"\x98i"],"\x19"=>[76,"\x98i"],"\x1A"=>[104,"\x98i"],"\x1B"=>[16,"\x98i"],"\x1C"=>[94,"\x98o"],"\x1D"=>[76,"\x98o"],"\x1E"=>[104,"\x98o"],"\x1F"=>[16,"\x98o"],"\x20"=>[94,"\x98s"],"\x21"=>[76,"\x98s"],"\x22"=>[104,"\x98s"],"\x23"=>[16,"\x98s"],"\x24"=>[94,"\x98t"],"\x25"=>[76,"\x98t"],"\x26"=>[104,"\x98t"],"\x27"=>[16,"\x98t"],"\x28"=>[77,"\x98\x20"],"\x29"=>[18,"\x98\x20"],"\x2A"=>[77,"\x98\x25"],"\x2B"=>[18,"\x98\x25"],"\x2C"=>[77,"\x98-"],"-"=>[18,"\x98-"],"."=>[77,"\x98."],"\x2F"=>[18,"\x98."],[77,"\x98\x2F"],[18,"\x98\x2F"],[77,"\x983"],[18,"\x983"],[77,"\x984"],[18,"\x984"],[77,"\x985"],[18,"\x985"],[77,"\x986"],[18,"\x986"],"\x3A"=>[77,"\x987"],"\x3B"=>[18,"\x987"],"\x3C"=>[77,"\x988"],"\x3D"=>[18,"\x988"],"\x3E"=>[77,"\x989"],"\x3F"=>[18,"\x989"],"\x40"=>[77,"\x98\x3D"],"A"=>[18,"\x98\x3D"],"B"=>[77,"\x98A"],"C"=>[18,"\x98A"],"D"=>[77,"\x98_"],"E"=>[18,"\x98_"],"F"=>[77,"\x98b"],"G"=>[18,"\x98b"],"H"=>[77,"\x98d"],"I"=>[18,"\x98d"],"J"=>[77,"\x98f"],"K"=>[18,"\x98f"],"L"=>[77,"\x98g"],"M"=>[18,"\x98g"],"N"=>[77,"\x98h"],"O"=>[18,"\x98h"],"P"=>[77,"\x98l"],"Q"=>[18,"\x98l"],"R"=>[77,"\x98m"],"S"=>[18,"\x98m"],"T"=>[77,"\x98n"],"U"=>[18,"\x98n"],"V"=>[77,"\x98p"],"W"=>[18,"\x98p"],"X"=>[77,"\x98r"],"Y"=>[18,"\x98r"],"Z"=>[77,"\x98u"],"\x5B"=>[18,"\x98u"],"\x5C"=>[0,"\x98\x3A"],"\x5D"=>[0,"\x98B"],"\x5E"=>[0,"\x98C"],"_"=>[0,"\x98D"],"\x60"=>[0,"\x98E"],"a"=>[0,"\x98F"],"b"=>[0,"\x98G"],"c"=>[0,"\x98H"],"d"=>[0,"\x98I"],"e"=>[0,"\x98J"],"f"=>[0,"\x98K"],"g"=>[0,"\x98L"],"h"=>[0,"\x98M"],"i"=>[0,"\x98N"],"j"=>[0,"\x98O"],"k"=>[0,"\x98P"],"l"=>[0,"\x98Q"],"m"=>[0,"\x98R"],"n"=>[0,"\x98S"],"o"=>[0,"\x98T"],"p"=>[0,"\x98U"],"q"=>[0,"\x98V"],"r"=>[0,"\x98W"],"s"=>[0,"\x98Y"],"t"=>[0,"\x98j"],"u"=>[0,"\x98k"],"v"=>[0,"\x98q"],"w"=>[0,"\x98v"],"x"=>[0,"\x98w"],"y"=>[0,"\x98x"],"z"=>[0,"\x98y"],"\x7B"=>[0,"\x98z"],"\x7C"=>[82,"\x98"],"\x7D"=>[87,"\x98"],"~"=>[130,"\x98"],"\x7F"=>[9,"\x98"],"\x80"=>[94,"\x9B0"],"\x81"=>[76,"\x9B0"],"\x82"=>[104,"\x9B0"],"\x83"=>[16,"\x9B0"],"\x84"=>[94,"\x9B1"],"\x85"=>[76,"\x9B1"],"\x86"=>[104,"\x9B1"],"\x87"=>[16,"\x9B1"],"\x88"=>[94,"\x9B2"],"\x89"=>[76,"\x9B2"],"\x8A"=>[104,"\x9B2"],"\x8B"=>[16,"\x9B2"],"\x8C"=>[94,"\x9Ba"],"\x8D"=>[76,"\x9Ba"],"\x8E"=>[104,"\x9Ba"],"\x8F"=>[16,"\x9Ba"],"\x90"=>[94,"\x9Bc"],"\x91"=>[76,"\x9Bc"],"\x92"=>[104,"\x9Bc"],"\x93"=>[16,"\x9Bc"],"\x94"=>[94,"\x9Be"],"\x95"=>[76,"\x9Be"],"\x96"=>[104,"\x9Be"],"\x97"=>[16,"\x9Be"],"\x98"=>[94,"\x9Bi"],"\x99"=>[76,"\x9Bi"],"\x9A"=>[104,"\x9Bi"],"\x9B"=>[16,"\x9Bi"],"\x9C"=>[94,"\x9Bo"],"\x9D"=>[76,"\x9Bo"],"\x9E"=>[104,"\x9Bo"],"\x9F"=>[16,"\x9Bo"],"\xA0"=>[94,"\x9Bs"],"\xA1"=>[76,"\x9Bs"],"\xA2"=>[104,"\x9Bs"],"\xA3"=>[16,"\x9Bs"],"\xA4"=>[94,"\x9Bt"],"\xA5"=>[76,"\x9Bt"],"\xA6"=>[104,"\x9Bt"],"\xA7"=>[16,"\x9Bt"],"\xA8"=>[77,"\x9B\x20"],"\xA9"=>[18,"\x9B\x20"],"\xAA"=>[77,"\x9B\x25"],"\xAB"=>[18,"\x9B\x25"],"\xAC"=>[77,"\x9B-"],"\xAD"=>[18,"\x9B-"],"\xAE"=>[77,"\x9B."],"\xAF"=>[18,"\x9B."],"\xB0"=>[77,"\x9B\x2F"],"\xB1"=>[18,"\x9B\x2F"],"\xB2"=>[77,"\x9B3"],"\xB3"=>[18,"\x9B3"],"\xB4"=>[77,"\x9B4"],"\xB5"=>[18,"\x9B4"],"\xB6"=>[77,"\x9B5"],"\xB7"=>[18,"\x9B5"],"\xB8"=>[77,"\x9B6"],"\xB9"=>[18,"\x9B6"],"\xBA"=>[77,"\x9B7"],"\xBB"=>[18,"\x9B7"],"\xBC"=>[77,"\x9B8"],"\xBD"=>[18,"\x9B8"],"\xBE"=>[77,"\x9B9"],"\xBF"=>[18,"\x9B9"],"\xC0"=>[77,"\x9B\x3D"],"\xC1"=>[18,"\x9B\x3D"],"\xC2"=>[77,"\x9BA"],"\xC3"=>[18,"\x9BA"],"\xC4"=>[77,"\x9B_"],"\xC5"=>[18,"\x9B_"],"\xC6"=>[77,"\x9Bb"],"\xC7"=>[18,"\x9Bb"],"\xC8"=>[77,"\x9Bd"],"\xC9"=>[18,"\x9Bd"],"\xCA"=>[77,"\x9Bf"],"\xCB"=>[18,"\x9Bf"],"\xCC"=>[77,"\x9Bg"],"\xCD"=>[18,"\x9Bg"],"\xCE"=>[77,"\x9Bh"],"\xCF"=>[18,"\x9Bh"],"\xD0"=>[77,"\x9Bl"],"\xD1"=>[18,"\x9Bl"],"\xD2"=>[77,"\x9Bm"],"\xD3"=>[18,"\x9Bm"],"\xD4"=>[77,"\x9Bn"],"\xD5"=>[18,"\x9Bn"],"\xD6"=>[77,"\x9Bp"],"\xD7"=>[18,"\x9Bp"],"\xD8"=>[77,"\x9Br"],"\xD9"=>[18,"\x9Br"],"\xDA"=>[77,"\x9Bu"],"\xDB"=>[18,"\x9Bu"],"\xDC"=>[0,"\x9B\x3A"],"\xDD"=>[0,"\x9BB"],"\xDE"=>[0,"\x9BC"],"\xDF"=>[0,"\x9BD"],"\xE0"=>[0,"\x9BE"],"\xE1"=>[0,"\x9BF"],"\xE2"=>[0,"\x9BG"],"\xE3"=>[0,"\x9BH"],"\xE4"=>[0,"\x9BI"],"\xE5"=>[0,"\x9BJ"],"\xE6"=>[0,"\x9BK"],"\xE7"=>[0,"\x9BL"],"\xE8"=>[0,"\x9BM"],"\xE9"=>[0,"\x9BN"],"\xEA"=>[0,"\x9BO"],"\xEB"=>[0,"\x9BP"],"\xEC"=>[0,"\x9BQ"],"\xED"=>[0,"\x9BR"],"\xEE"=>[0,"\x9BS"],"\xEF"=>[0,"\x9BT"],"\xF0"=>[0,"\x9BU"],"\xF1"=>[0,"\x9BV"],"\xF2"=>[0,"\x9BW"],"\xF3"=>[0,"\x9BY"],"\xF4"=>[0,"\x9Bj"],"\xF5"=>[0,"\x9Bk"],"\xF6"=>[0,"\x9Bq"],"\xF7"=>[0,"\x9Bv"],"\xF8"=>[0,"\x9Bw"],"\xF9"=>[0,"\x9Bx"],"\xFA"=>[0,"\x9By"],"\xFB"=>[0,"\x9Bz"],"\xFC"=>[82,"\x9B"],"\xFD"=>[87,"\x9B"],"\xFE"=>[130,"\x9B"],"\xFF"=>[9,"\x9B"],],["\x00"=>[77,"\x980"],"\x01"=>[18,"\x980"],"\x02"=>[77,"\x981"],"\x03"=>[18,"\x981"],"\x04"=>[77,"\x982"],"\x05"=>[18,"\x982"],"\x06"=>[77,"\x98a"],"\x07"=>[18,"\x98a"],"\x08"=>[77,"\x98c"],"\x09"=>[18,"\x98c"],"\x0A"=>[77,"\x98e"],"\x0B"=>[18,"\x98e"],"\x0C"=>[77,"\x98i"],"\x0D"=>[18,"\x98i"],"\x0E"=>[77,"\x98o"],"\x0F"=>[18,"\x98o"],"\x10"=>[77,"\x98s"],"\x11"=>[18,"\x98s"],"\x12"=>[77,"\x98t"],"\x13"=>[18,"\x98t"],"\x14"=>[0,"\x98\x20"],"\x15"=>[0,"\x98\x25"],"\x16"=>[0,"\x98-"],"\x17"=>[0,"\x98."],"\x18"=>[0,"\x98\x2F"],"\x19"=>[0,"\x983"],"\x1A"=>[0,"\x984"],"\x1B"=>[0,"\x985"],"\x1C"=>[0,"\x986"],"\x1D"=>[0,"\x987"],"\x1E"=>[0,"\x988"],"\x1F"=>[0,"\x989"],"\x20"=>[0,"\x98\x3D"],"\x21"=>[0,"\x98A"],"\x22"=>[0,"\x98_"],"\x23"=>[0,"\x98b"],"\x24"=>[0,"\x98d"],"\x25"=>[0,"\x98f"],"\x26"=>[0,"\x98g"],"\x27"=>[0,"\x98h"],"\x28"=>[0,"\x98l"],"\x29"=>[0,"\x98m"],"\x2A"=>[0,"\x98n"],"\x2B"=>[0,"\x98p"],"\x2C"=>[0,"\x98r"],"-"=>[0,"\x98u"],"."=>[100,"\x98"],"\x2F"=>[110,"\x98"],[111,"\x98"],[115,"\x98"],[116,"\x98"],[118,"\x98"],[119,"\x98"],[122,"\x98"],[123,"\x98"],[125,"\x98"],[126,"\x98"],[129,"\x98"],"\x3A"=>[143,"\x98"],"\x3B"=>[148,"\x98"],"\x3C"=>[151,"\x98"],"\x3D"=>[153,"\x98"],"\x3E"=>[83,"\x98"],"\x3F"=>[10,"\x98"],"\x40"=>[77,"\x9B0"],"A"=>[18,"\x9B0"],"B"=>[77,"\x9B1"],"C"=>[18,"\x9B1"],"D"=>[77,"\x9B2"],"E"=>[18,"\x9B2"],"F"=>[77,"\x9Ba"],"G"=>[18,"\x9Ba"],"H"=>[77,"\x9Bc"],"I"=>[18,"\x9Bc"],"J"=>[77,"\x9Be"],"K"=>[18,"\x9Be"],"L"=>[77,"\x9Bi"],"M"=>[18,"\x9Bi"],"N"=>[77,"\x9Bo"],"O"=>[18,"\x9Bo"],"P"=>[77,"\x9Bs"],"Q"=>[18,"\x9Bs"],"R"=>[77,"\x9Bt"],"S"=>[18,"\x9Bt"],"T"=>[0,"\x9B\x20"],"U"=>[0,"\x9B\x25"],"V"=>[0,"\x9B-"],"W"=>[0,"\x9B."],"X"=>[0,"\x9B\x2F"],"Y"=>[0,"\x9B3"],"Z"=>[0,"\x9B4"],"\x5B"=>[0,"\x9B5"],"\x5C"=>[0,"\x9B6"],"\x5D"=>[0,"\x9B7"],"\x5E"=>[0,"\x9B8"],"_"=>[0,"\x9B9"],"\x60"=>[0,"\x9B\x3D"],"a"=>[0,"\x9BA"],"b"=>[0,"\x9B_"],"c"=>[0,"\x9Bb"],"d"=>[0,"\x9Bd"],"e"=>[0,"\x9Bf"],"f"=>[0,"\x9Bg"],"g"=>[0,"\x9Bh"],"h"=>[0,"\x9Bl"],"i"=>[0,"\x9Bm"],"j"=>[0,"\x9Bn"],"k"=>[0,"\x9Bp"],"l"=>[0,"\x9Br"],"m"=>[0,"\x9Bu"],"n"=>[100,"\x9B"],"o"=>[110,"\x9B"],"p"=>[111,"\x9B"],"q"=>[115,"\x9B"],"r"=>[116,"\x9B"],"s"=>[118,"\x9B"],"t"=>[119,"\x9B"],"u"=>[122,"\x9B"],"v"=>[123,"\x9B"],"w"=>[125,"\x9B"],"x"=>[126,"\x9B"],"y"=>[129,"\x9B"],"z"=>[143,"\x9B"],"\x7B"=>[148,"\x9B"],"\x7C"=>[151,"\x9B"],"\x7D"=>[153,"\x9B"],"~"=>[83,"\x9B"],"\x7F"=>[10,"\x9B"],"\x80"=>[77,"\x9D0"],"\x81"=>[18,"\x9D0"],"\x82"=>[77,"\x9D1"],"\x83"=>[18,"\x9D1"],"\x84"=>[77,"\x9D2"],"\x85"=>[18,"\x9D2"],"\x86"=>[77,"\x9Da"],"\x87"=>[18,"\x9Da"],"\x88"=>[77,"\x9Dc"],"\x89"=>[18,"\x9Dc"],"\x8A"=>[77,"\x9De"],"\x8B"=>[18,"\x9De"],"\x8C"=>[77,"\x9Di"],"\x8D"=>[18,"\x9Di"],"\x8E"=>[77,"\x9Do"],"\x8F"=>[18,"\x9Do"],"\x90"=>[77,"\x9Ds"],"\x91"=>[18,"\x9Ds"],"\x92"=>[77,"\x9Dt"],"\x93"=>[18,"\x9Dt"],"\x94"=>[0,"\x9D\x20"],"\x95"=>[0,"\x9D\x25"],"\x96"=>[0,"\x9D-"],"\x97"=>[0,"\x9D."],"\x98"=>[0,"\x9D\x2F"],"\x99"=>[0,"\x9D3"],"\x9A"=>[0,"\x9D4"],"\x9B"=>[0,"\x9D5"],"\x9C"=>[0,"\x9D6"],"\x9D"=>[0,"\x9D7"],"\x9E"=>[0,"\x9D8"],"\x9F"=>[0,"\x9D9"],"\xA0"=>[0,"\x9D\x3D"],"\xA1"=>[0,"\x9DA"],"\xA2"=>[0,"\x9D_"],"\xA3"=>[0,"\x9Db"],"\xA4"=>[0,"\x9Dd"],"\xA5"=>[0,"\x9Df"],"\xA6"=>[0,"\x9Dg"],"\xA7"=>[0,"\x9Dh"],"\xA8"=>[0,"\x9Dl"],"\xA9"=>[0,"\x9Dm"],"\xAA"=>[0,"\x9Dn"],"\xAB"=>[0,"\x9Dp"],"\xAC"=>[0,"\x9Dr"],"\xAD"=>[0,"\x9Du"],"\xAE"=>[100,"\x9D"],"\xAF"=>[110,"\x9D"],"\xB0"=>[111,"\x9D"],"\xB1"=>[115,"\x9D"],"\xB2"=>[116,"\x9D"],"\xB3"=>[118,"\x9D"],"\xB4"=>[119,"\x9D"],"\xB5"=>[122,"\x9D"],"\xB6"=>[123,"\x9D"],"\xB7"=>[125,"\x9D"],"\xB8"=>[126,"\x9D"],"\xB9"=>[129,"\x9D"],"\xBA"=>[143,"\x9D"],"\xBB"=>[148,"\x9D"],"\xBC"=>[151,"\x9D"],"\xBD"=>[153,"\x9D"],"\xBE"=>[83,"\x9D"],"\xBF"=>[10,"\x9D"],"\xC0"=>[77,"\x9E0"],"\xC1"=>[18,"\x9E0"],"\xC2"=>[77,"\x9E1"],"\xC3"=>[18,"\x9E1"],"\xC4"=>[77,"\x9E2"],"\xC5"=>[18,"\x9E2"],"\xC6"=>[77,"\x9Ea"],"\xC7"=>[18,"\x9Ea"],"\xC8"=>[77,"\x9Ec"],"\xC9"=>[18,"\x9Ec"],"\xCA"=>[77,"\x9Ee"],"\xCB"=>[18,"\x9Ee"],"\xCC"=>[77,"\x9Ei"],"\xCD"=>[18,"\x9Ei"],"\xCE"=>[77,"\x9Eo"],"\xCF"=>[18,"\x9Eo"],"\xD0"=>[77,"\x9Es"],"\xD1"=>[18,"\x9Es"],"\xD2"=>[77,"\x9Et"],"\xD3"=>[18,"\x9Et"],"\xD4"=>[0,"\x9E\x20"],"\xD5"=>[0,"\x9E\x25"],"\xD6"=>[0,"\x9E-"],"\xD7"=>[0,"\x9E."],"\xD8"=>[0,"\x9E\x2F"],"\xD9"=>[0,"\x9E3"],"\xDA"=>[0,"\x9E4"],"\xDB"=>[0,"\x9E5"],"\xDC"=>[0,"\x9E6"],"\xDD"=>[0,"\x9E7"],"\xDE"=>[0,"\x9E8"],"\xDF"=>[0,"\x9E9"],"\xE0"=>[0,"\x9E\x3D"],"\xE1"=>[0,"\x9EA"],"\xE2"=>[0,"\x9E_"],"\xE3"=>[0,"\x9Eb"],"\xE4"=>[0,"\x9Ed"],"\xE5"=>[0,"\x9Ef"],"\xE6"=>[0,"\x9Eg"],"\xE7"=>[0,"\x9Eh"],"\xE8"=>[0,"\x9El"],"\xE9"=>[0,"\x9Em"],"\xEA"=>[0,"\x9En"],"\xEB"=>[0,"\x9Ep"],"\xEC"=>[0,"\x9Er"],"\xED"=>[0,"\x9Eu"],"\xEE"=>[100,"\x9E"],"\xEF"=>[110,"\x9E"],"\xF0"=>[111,"\x9E"],"\xF1"=>[115,"\x9E"],"\xF2"=>[116,"\x9E"],"\xF3"=>[118,"\x9E"],"\xF4"=>[119,"\x9E"],"\xF5"=>[122,"\x9E"],"\xF6"=>[123,"\x9E"],"\xF7"=>[125,"\x9E"],"\xF8"=>[126,"\x9E"],"\xF9"=>[129,"\x9E"],"\xFA"=>[143,"\x9E"],"\xFB"=>[148,"\x9E"],"\xFC"=>[151,"\x9E"],"\xFD"=>[153,"\x9E"],"\xFE"=>[83,"\x9E"],"\xFF"=>[10,"\x9E"],],["\x00"=>[94,"\x990"],"\x01"=>[76,"\x990"],"\x02"=>[104,"\x990"],"\x03"=>[16,"\x990"],"\x04"=>[94,"\x991"],"\x05"=>[76,"\x991"],"\x06"=>[104,"\x991"],"\x07"=>[16,"\x991"],"\x08"=>[94,"\x992"],"\x09"=>[76,"\x992"],"\x0A"=>[104,"\x992"],"\x0B"=>[16,"\x992"],"\x0C"=>[94,"\x99a"],"\x0D"=>[76,"\x99a"],"\x0E"=>[104,"\x99a"],"\x0F"=>[16,"\x99a"],"\x10"=>[94,"\x99c"],"\x11"=>[76,"\x99c"],"\x12"=>[104,"\x99c"],"\x13"=>[16,"\x99c"],"\x14"=>[94,"\x99e"],"\x15"=>[76,"\x99e"],"\x16"=>[104,"\x99e"],"\x17"=>[16,"\x99e"],"\x18"=>[94,"\x99i"],"\x19"=>[76,"\x99i"],"\x1A"=>[104,"\x99i"],"\x1B"=>[16,"\x99i"],"\x1C"=>[94,"\x99o"],"\x1D"=>[76,"\x99o"],"\x1E"=>[104,"\x99o"],"\x1F"=>[16,"\x99o"],"\x20"=>[94,"\x99s"],"\x21"=>[76,"\x99s"],"\x22"=>[104,"\x99s"],"\x23"=>[16,"\x99s"],"\x24"=>[94,"\x99t"],"\x25"=>[76,"\x99t"],"\x26"=>[104,"\x99t"],"\x27"=>[16,"\x99t"],"\x28"=>[77,"\x99\x20"],"\x29"=>[18,"\x99\x20"],"\x2A"=>[77,"\x99\x25"],"\x2B"=>[18,"\x99\x25"],"\x2C"=>[77,"\x99-"],"-"=>[18,"\x99-"],"."=>[77,"\x99."],"\x2F"=>[18,"\x99."],[77,"\x99\x2F"],[18,"\x99\x2F"],[77,"\x993"],[18,"\x993"],[77,"\x994"],[18,"\x994"],[77,"\x995"],[18,"\x995"],[77,"\x996"],[18,"\x996"],"\x3A"=>[77,"\x997"],"\x3B"=>[18,"\x997"],"\x3C"=>[77,"\x998"],"\x3D"=>[18,"\x998"],"\x3E"=>[77,"\x999"],"\x3F"=>[18,"\x999"],"\x40"=>[77,"\x99\x3D"],"A"=>[18,"\x99\x3D"],"B"=>[77,"\x99A"],"C"=>[18,"\x99A"],"D"=>[77,"\x99_"],"E"=>[18,"\x99_"],"F"=>[77,"\x99b"],"G"=>[18,"\x99b"],"H"=>[77,"\x99d"],"I"=>[18,"\x99d"],"J"=>[77,"\x99f"],"K"=>[18,"\x99f"],"L"=>[77,"\x99g"],"M"=>[18,"\x99g"],"N"=>[77,"\x99h"],"O"=>[18,"\x99h"],"P"=>[77,"\x99l"],"Q"=>[18,"\x99l"],"R"=>[77,"\x99m"],"S"=>[18,"\x99m"],"T"=>[77,"\x99n"],"U"=>[18,"\x99n"],"V"=>[77,"\x99p"],"W"=>[18,"\x99p"],"X"=>[77,"\x99r"],"Y"=>[18,"\x99r"],"Z"=>[77,"\x99u"],"\x5B"=>[18,"\x99u"],"\x5C"=>[0,"\x99\x3A"],"\x5D"=>[0,"\x99B"],"\x5E"=>[0,"\x99C"],"_"=>[0,"\x99D"],"\x60"=>[0,"\x99E"],"a"=>[0,"\x99F"],"b"=>[0,"\x99G"],"c"=>[0,"\x99H"],"d"=>[0,"\x99I"],"e"=>[0,"\x99J"],"f"=>[0,"\x99K"],"g"=>[0,"\x99L"],"h"=>[0,"\x99M"],"i"=>[0,"\x99N"],"j"=>[0,"\x99O"],"k"=>[0,"\x99P"],"l"=>[0,"\x99Q"],"m"=>[0,"\x99R"],"n"=>[0,"\x99S"],"o"=>[0,"\x99T"],"p"=>[0,"\x99U"],"q"=>[0,"\x99V"],"r"=>[0,"\x99W"],"s"=>[0,"\x99Y"],"t"=>[0,"\x99j"],"u"=>[0,"\x99k"],"v"=>[0,"\x99q"],"w"=>[0,"\x99v"],"x"=>[0,"\x99w"],"y"=>[0,"\x99x"],"z"=>[0,"\x99y"],"\x7B"=>[0,"\x99z"],"\x7C"=>[82,"\x99"],"\x7D"=>[87,"\x99"],"~"=>[130,"\x99"],"\x7F"=>[9,"\x99"],"\x80"=>[94,"\xA10"],"\x81"=>[76,"\xA10"],"\x82"=>[104,"\xA10"],"\x83"=>[16,"\xA10"],"\x84"=>[94,"\xA11"],"\x85"=>[76,"\xA11"],"\x86"=>[104,"\xA11"],"\x87"=>[16,"\xA11"],"\x88"=>[94,"\xA12"],"\x89"=>[76,"\xA12"],"\x8A"=>[104,"\xA12"],"\x8B"=>[16,"\xA12"],"\x8C"=>[94,"\xA1a"],"\x8D"=>[76,"\xA1a"],"\x8E"=>[104,"\xA1a"],"\x8F"=>[16,"\xA1a"],"\x90"=>[94,"\xA1c"],"\x91"=>[76,"\xA1c"],"\x92"=>[104,"\xA1c"],"\x93"=>[16,"\xA1c"],"\x94"=>[94,"\xA1e"],"\x95"=>[76,"\xA1e"],"\x96"=>[104,"\xA1e"],"\x97"=>[16,"\xA1e"],"\x98"=>[94,"\xA1i"],"\x99"=>[76,"\xA1i"],"\x9A"=>[104,"\xA1i"],"\x9B"=>[16,"\xA1i"],"\x9C"=>[94,"\xA1o"],"\x9D"=>[76,"\xA1o"],"\x9E"=>[104,"\xA1o"],"\x9F"=>[16,"\xA1o"],"\xA0"=>[94,"\xA1s"],"\xA1"=>[76,"\xA1s"],"\xA2"=>[104,"\xA1s"],"\xA3"=>[16,"\xA1s"],"\xA4"=>[94,"\xA1t"],"\xA5"=>[76,"\xA1t"],"\xA6"=>[104,"\xA1t"],"\xA7"=>[16,"\xA1t"],"\xA8"=>[77,"\xA1\x20"],"\xA9"=>[18,"\xA1\x20"],"\xAA"=>[77,"\xA1\x25"],"\xAB"=>[18,"\xA1\x25"],"\xAC"=>[77,"\xA1-"],"\xAD"=>[18,"\xA1-"],"\xAE"=>[77,"\xA1."],"\xAF"=>[18,"\xA1."],"\xB0"=>[77,"\xA1\x2F"],"\xB1"=>[18,"\xA1\x2F"],"\xB2"=>[77,"\xA13"],"\xB3"=>[18,"\xA13"],"\xB4"=>[77,"\xA14"],"\xB5"=>[18,"\xA14"],"\xB6"=>[77,"\xA15"],"\xB7"=>[18,"\xA15"],"\xB8"=>[77,"\xA16"],"\xB9"=>[18,"\xA16"],"\xBA"=>[77,"\xA17"],"\xBB"=>[18,"\xA17"],"\xBC"=>[77,"\xA18"],"\xBD"=>[18,"\xA18"],"\xBE"=>[77,"\xA19"],"\xBF"=>[18,"\xA19"],"\xC0"=>[77,"\xA1\x3D"],"\xC1"=>[18,"\xA1\x3D"],"\xC2"=>[77,"\xA1A"],"\xC3"=>[18,"\xA1A"],"\xC4"=>[77,"\xA1_"],"\xC5"=>[18,"\xA1_"],"\xC6"=>[77,"\xA1b"],"\xC7"=>[18,"\xA1b"],"\xC8"=>[77,"\xA1d"],"\xC9"=>[18,"\xA1d"],"\xCA"=>[77,"\xA1f"],"\xCB"=>[18,"\xA1f"],"\xCC"=>[77,"\xA1g"],"\xCD"=>[18,"\xA1g"],"\xCE"=>[77,"\xA1h"],"\xCF"=>[18,"\xA1h"],"\xD0"=>[77,"\xA1l"],"\xD1"=>[18,"\xA1l"],"\xD2"=>[77,"\xA1m"],"\xD3"=>[18,"\xA1m"],"\xD4"=>[77,"\xA1n"],"\xD5"=>[18,"\xA1n"],"\xD6"=>[77,"\xA1p"],"\xD7"=>[18,"\xA1p"],"\xD8"=>[77,"\xA1r"],"\xD9"=>[18,"\xA1r"],"\xDA"=>[77,"\xA1u"],"\xDB"=>[18,"\xA1u"],"\xDC"=>[0,"\xA1\x3A"],"\xDD"=>[0,"\xA1B"],"\xDE"=>[0,"\xA1C"],"\xDF"=>[0,"\xA1D"],"\xE0"=>[0,"\xA1E"],"\xE1"=>[0,"\xA1F"],"\xE2"=>[0,"\xA1G"],"\xE3"=>[0,"\xA1H"],"\xE4"=>[0,"\xA1I"],"\xE5"=>[0,"\xA1J"],"\xE6"=>[0,"\xA1K"],"\xE7"=>[0,"\xA1L"],"\xE8"=>[0,"\xA1M"],"\xE9"=>[0,"\xA1N"],"\xEA"=>[0,"\xA1O"],"\xEB"=>[0,"\xA1P"],"\xEC"=>[0,"\xA1Q"],"\xED"=>[0,"\xA1R"],"\xEE"=>[0,"\xA1S"],"\xEF"=>[0,"\xA1T"],"\xF0"=>[0,"\xA1U"],"\xF1"=>[0,"\xA1V"],"\xF2"=>[0,"\xA1W"],"\xF3"=>[0,"\xA1Y"],"\xF4"=>[0,"\xA1j"],"\xF5"=>[0,"\xA1k"],"\xF6"=>[0,"\xA1q"],"\xF7"=>[0,"\xA1v"],"\xF8"=>[0,"\xA1w"],"\xF9"=>[0,"\xA1x"],"\xFA"=>[0,"\xA1y"],"\xFB"=>[0,"\xA1z"],"\xFC"=>[82,"\xA1"],"\xFD"=>[87,"\xA1"],"\xFE"=>[130,"\xA1"],"\xFF"=>[9,"\xA1"],],["\x00"=>[77,"\x990"],"\x01"=>[18,"\x990"],"\x02"=>[77,"\x991"],"\x03"=>[18,"\x991"],"\x04"=>[77,"\x992"],"\x05"=>[18,"\x992"],"\x06"=>[77,"\x99a"],"\x07"=>[18,"\x99a"],"\x08"=>[77,"\x99c"],"\x09"=>[18,"\x99c"],"\x0A"=>[77,"\x99e"],"\x0B"=>[18,"\x99e"],"\x0C"=>[77,"\x99i"],"\x0D"=>[18,"\x99i"],"\x0E"=>[77,"\x99o"],"\x0F"=>[18,"\x99o"],"\x10"=>[77,"\x99s"],"\x11"=>[18,"\x99s"],"\x12"=>[77,"\x99t"],"\x13"=>[18,"\x99t"],"\x14"=>[0,"\x99\x20"],"\x15"=>[0,"\x99\x25"],"\x16"=>[0,"\x99-"],"\x17"=>[0,"\x99."],"\x18"=>[0,"\x99\x2F"],"\x19"=>[0,"\x993"],"\x1A"=>[0,"\x994"],"\x1B"=>[0,"\x995"],"\x1C"=>[0,"\x996"],"\x1D"=>[0,"\x997"],"\x1E"=>[0,"\x998"],"\x1F"=>[0,"\x999"],"\x20"=>[0,"\x99\x3D"],"\x21"=>[0,"\x99A"],"\x22"=>[0,"\x99_"],"\x23"=>[0,"\x99b"],"\x24"=>[0,"\x99d"],"\x25"=>[0,"\x99f"],"\x26"=>[0,"\x99g"],"\x27"=>[0,"\x99h"],"\x28"=>[0,"\x99l"],"\x29"=>[0,"\x99m"],"\x2A"=>[0,"\x99n"],"\x2B"=>[0,"\x99p"],"\x2C"=>[0,"\x99r"],"-"=>[0,"\x99u"],"."=>[100,"\x99"],"\x2F"=>[110,"\x99"],[111,"\x99"],[115,"\x99"],[116,"\x99"],[118,"\x99"],[119,"\x99"],[122,"\x99"],[123,"\x99"],[125,"\x99"],[126,"\x99"],[129,"\x99"],"\x3A"=>[143,"\x99"],"\x3B"=>[148,"\x99"],"\x3C"=>[151,"\x99"],"\x3D"=>[153,"\x99"],"\x3E"=>[83,"\x99"],"\x3F"=>[10,"\x99"],"\x40"=>[77,"\xA10"],"A"=>[18,"\xA10"],"B"=>[77,"\xA11"],"C"=>[18,"\xA11"],"D"=>[77,"\xA12"],"E"=>[18,"\xA12"],"F"=>[77,"\xA1a"],"G"=>[18,"\xA1a"],"H"=>[77,"\xA1c"],"I"=>[18,"\xA1c"],"J"=>[77,"\xA1e"],"K"=>[18,"\xA1e"],"L"=>[77,"\xA1i"],"M"=>[18,"\xA1i"],"N"=>[77,"\xA1o"],"O"=>[18,"\xA1o"],"P"=>[77,"\xA1s"],"Q"=>[18,"\xA1s"],"R"=>[77,"\xA1t"],"S"=>[18,"\xA1t"],"T"=>[0,"\xA1\x20"],"U"=>[0,"\xA1\x25"],"V"=>[0,"\xA1-"],"W"=>[0,"\xA1."],"X"=>[0,"\xA1\x2F"],"Y"=>[0,"\xA13"],"Z"=>[0,"\xA14"],"\x5B"=>[0,"\xA15"],"\x5C"=>[0,"\xA16"],"\x5D"=>[0,"\xA17"],"\x5E"=>[0,"\xA18"],"_"=>[0,"\xA19"],"\x60"=>[0,"\xA1\x3D"],"a"=>[0,"\xA1A"],"b"=>[0,"\xA1_"],"c"=>[0,"\xA1b"],"d"=>[0,"\xA1d"],"e"=>[0,"\xA1f"],"f"=>[0,"\xA1g"],"g"=>[0,"\xA1h"],"h"=>[0,"\xA1l"],"i"=>[0,"\xA1m"],"j"=>[0,"\xA1n"],"k"=>[0,"\xA1p"],"l"=>[0,"\xA1r"],"m"=>[0,"\xA1u"],"n"=>[100,"\xA1"],"o"=>[110,"\xA1"],"p"=>[111,"\xA1"],"q"=>[115,"\xA1"],"r"=>[116,"\xA1"],"s"=>[118,"\xA1"],"t"=>[119,"\xA1"],"u"=>[122,"\xA1"],"v"=>[123,"\xA1"],"w"=>[125,"\xA1"],"x"=>[126,"\xA1"],"y"=>[129,"\xA1"],"z"=>[143,"\xA1"],"\x7B"=>[148,"\xA1"],"\x7C"=>[151,"\xA1"],"\x7D"=>[153,"\xA1"],"~"=>[83,"\xA1"],"\x7F"=>[10,"\xA1"],"\x80"=>[77,"\xA70"],"\x81"=>[18,"\xA70"],"\x82"=>[77,"\xA71"],"\x83"=>[18,"\xA71"],"\x84"=>[77,"\xA72"],"\x85"=>[18,"\xA72"],"\x86"=>[77,"\xA7a"],"\x87"=>[18,"\xA7a"],"\x88"=>[77,"\xA7c"],"\x89"=>[18,"\xA7c"],"\x8A"=>[77,"\xA7e"],"\x8B"=>[18,"\xA7e"],"\x8C"=>[77,"\xA7i"],"\x8D"=>[18,"\xA7i"],"\x8E"=>[77,"\xA7o"],"\x8F"=>[18,"\xA7o"],"\x90"=>[77,"\xA7s"],"\x91"=>[18,"\xA7s"],"\x92"=>[77,"\xA7t"],"\x93"=>[18,"\xA7t"],"\x94"=>[0,"\xA7\x20"],"\x95"=>[0,"\xA7\x25"],"\x96"=>[0,"\xA7-"],"\x97"=>[0,"\xA7."],"\x98"=>[0,"\xA7\x2F"],"\x99"=>[0,"\xA73"],"\x9A"=>[0,"\xA74"],"\x9B"=>[0,"\xA75"],"\x9C"=>[0,"\xA76"],"\x9D"=>[0,"\xA77"],"\x9E"=>[0,"\xA78"],"\x9F"=>[0,"\xA79"],"\xA0"=>[0,"\xA7\x3D"],"\xA1"=>[0,"\xA7A"],"\xA2"=>[0,"\xA7_"],"\xA3"=>[0,"\xA7b"],"\xA4"=>[0,"\xA7d"],"\xA5"=>[0,"\xA7f"],"\xA6"=>[0,"\xA7g"],"\xA7"=>[0,"\xA7h"],"\xA8"=>[0,"\xA7l"],"\xA9"=>[0,"\xA7m"],"\xAA"=>[0,"\xA7n"],"\xAB"=>[0,"\xA7p"],"\xAC"=>[0,"\xA7r"],"\xAD"=>[0,"\xA7u"],"\xAE"=>[100,"\xA7"],"\xAF"=>[110,"\xA7"],"\xB0"=>[111,"\xA7"],"\xB1"=>[115,"\xA7"],"\xB2"=>[116,"\xA7"],"\xB3"=>[118,"\xA7"],"\xB4"=>[119,"\xA7"],"\xB5"=>[122,"\xA7"],"\xB6"=>[123,"\xA7"],"\xB7"=>[125,"\xA7"],"\xB8"=>[126,"\xA7"],"\xB9"=>[129,"\xA7"],"\xBA"=>[143,"\xA7"],"\xBB"=>[148,"\xA7"],"\xBC"=>[151,"\xA7"],"\xBD"=>[153,"\xA7"],"\xBE"=>[83,"\xA7"],"\xBF"=>[10,"\xA7"],"\xC0"=>[77,"\xAC0"],"\xC1"=>[18,"\xAC0"],"\xC2"=>[77,"\xAC1"],"\xC3"=>[18,"\xAC1"],"\xC4"=>[77,"\xAC2"],"\xC5"=>[18,"\xAC2"],"\xC6"=>[77,"\xACa"],"\xC7"=>[18,"\xACa"],"\xC8"=>[77,"\xACc"],"\xC9"=>[18,"\xACc"],"\xCA"=>[77,"\xACe"],"\xCB"=>[18,"\xACe"],"\xCC"=>[77,"\xACi"],"\xCD"=>[18,"\xACi"],"\xCE"=>[77,"\xACo"],"\xCF"=>[18,"\xACo"],"\xD0"=>[77,"\xACs"],"\xD1"=>[18,"\xACs"],"\xD2"=>[77,"\xACt"],"\xD3"=>[18,"\xACt"],"\xD4"=>[0,"\xAC\x20"],"\xD5"=>[0,"\xAC\x25"],"\xD6"=>[0,"\xAC-"],"\xD7"=>[0,"\xAC."],"\xD8"=>[0,"\xAC\x2F"],"\xD9"=>[0,"\xAC3"],"\xDA"=>[0,"\xAC4"],"\xDB"=>[0,"\xAC5"],"\xDC"=>[0,"\xAC6"],"\xDD"=>[0,"\xAC7"],"\xDE"=>[0,"\xAC8"],"\xDF"=>[0,"\xAC9"],"\xE0"=>[0,"\xAC\x3D"],"\xE1"=>[0,"\xACA"],"\xE2"=>[0,"\xAC_"],"\xE3"=>[0,"\xACb"],"\xE4"=>[0,"\xACd"],"\xE5"=>[0,"\xACf"],"\xE6"=>[0,"\xACg"],"\xE7"=>[0,"\xACh"],"\xE8"=>[0,"\xACl"],"\xE9"=>[0,"\xACm"],"\xEA"=>[0,"\xACn"],"\xEB"=>[0,"\xACp"],"\xEC"=>[0,"\xACr"],"\xED"=>[0,"\xACu"],"\xEE"=>[100,"\xAC"],"\xEF"=>[110,"\xAC"],"\xF0"=>[111,"\xAC"],"\xF1"=>[115,"\xAC"],"\xF2"=>[116,"\xAC"],"\xF3"=>[118,"\xAC"],"\xF4"=>[119,"\xAC"],"\xF5"=>[122,"\xAC"],"\xF6"=>[123,"\xAC"],"\xF7"=>[125,"\xAC"],"\xF8"=>[126,"\xAC"],"\xF9"=>[129,"\xAC"],"\xFA"=>[143,"\xAC"],"\xFB"=>[148,"\xAC"],"\xFC"=>[151,"\xAC"],"\xFD"=>[153,"\xAC"],"\xFE"=>[83,"\xAC"],"\xFF"=>[10,"\xAC"],],["\x00"=>[77,"\xE00"],"\x01"=>[18,"\xE00"],"\x02"=>[77,"\xE01"],"\x03"=>[18,"\xE01"],"\x04"=>[77,"\xE02"],"\x05"=>[18,"\xE02"],"\x06"=>[77,"\xE0a"],"\x07"=>[18,"\xE0a"],"\x08"=>[77,"\xE0c"],"\x09"=>[18,"\xE0c"],"\x0A"=>[77,"\xE0e"],"\x0B"=>[18,"\xE0e"],"\x0C"=>[77,"\xE0i"],"\x0D"=>[18,"\xE0i"],"\x0E"=>[77,"\xE0o"],"\x0F"=>[18,"\xE0o"],"\x10"=>[77,"\xE0s"],"\x11"=>[18,"\xE0s"],"\x12"=>[77,"\xE0t"],"\x13"=>[18,"\xE0t"],"\x14"=>[0,"\xE0\x20"],"\x15"=>[0,"\xE0\x25"],"\x16"=>[0,"\xE0-"],"\x17"=>[0,"\xE0."],"\x18"=>[0,"\xE0\x2F"],"\x19"=>[0,"\xE03"],"\x1A"=>[0,"\xE04"],"\x1B"=>[0,"\xE05"],"\x1C"=>[0,"\xE06"],"\x1D"=>[0,"\xE07"],"\x1E"=>[0,"\xE08"],"\x1F"=>[0,"\xE09"],"\x20"=>[0,"\xE0\x3D"],"\x21"=>[0,"\xE0A"],"\x22"=>[0,"\xE0_"],"\x23"=>[0,"\xE0b"],"\x24"=>[0,"\xE0d"],"\x25"=>[0,"\xE0f"],"\x26"=>[0,"\xE0g"],"\x27"=>[0,"\xE0h"],"\x28"=>[0,"\xE0l"],"\x29"=>[0,"\xE0m"],"\x2A"=>[0,"\xE0n"],"\x2B"=>[0,"\xE0p"],"\x2C"=>[0,"\xE0r"],"-"=>[0,"\xE0u"],"."=>[100,"\xE0"],"\x2F"=>[110,"\xE0"],[111,"\xE0"],[115,"\xE0"],[116,"\xE0"],[118,"\xE0"],[119,"\xE0"],[122,"\xE0"],[123,"\xE0"],[125,"\xE0"],[126,"\xE0"],[129,"\xE0"],"\x3A"=>[143,"\xE0"],"\x3B"=>[148,"\xE0"],"\x3C"=>[151,"\xE0"],"\x3D"=>[153,"\xE0"],"\x3E"=>[83,"\xE0"],"\x3F"=>[10,"\xE0"],"\x40"=>[77,"\xE20"],"A"=>[18,"\xE20"],"B"=>[77,"\xE21"],"C"=>[18,"\xE21"],"D"=>[77,"\xE22"],"E"=>[18,"\xE22"],"F"=>[77,"\xE2a"],"G"=>[18,"\xE2a"],"H"=>[77,"\xE2c"],"I"=>[18,"\xE2c"],"J"=>[77,"\xE2e"],"K"=>[18,"\xE2e"],"L"=>[77,"\xE2i"],"M"=>[18,"\xE2i"],"N"=>[77,"\xE2o"],"O"=>[18,"\xE2o"],"P"=>[77,"\xE2s"],"Q"=>[18,"\xE2s"],"R"=>[77,"\xE2t"],"S"=>[18,"\xE2t"],"T"=>[0,"\xE2\x20"],"U"=>[0,"\xE2\x25"],"V"=>[0,"\xE2-"],"W"=>[0,"\xE2."],"X"=>[0,"\xE2\x2F"],"Y"=>[0,"\xE23"],"Z"=>[0,"\xE24"],"\x5B"=>[0,"\xE25"],"\x5C"=>[0,"\xE26"],"\x5D"=>[0,"\xE27"],"\x5E"=>[0,"\xE28"],"_"=>[0,"\xE29"],"\x60"=>[0,"\xE2\x3D"],"a"=>[0,"\xE2A"],"b"=>[0,"\xE2_"],"c"=>[0,"\xE2b"],"d"=>[0,"\xE2d"],"e"=>[0,"\xE2f"],"f"=>[0,"\xE2g"],"g"=>[0,"\xE2h"],"h"=>[0,"\xE2l"],"i"=>[0,"\xE2m"],"j"=>[0,"\xE2n"],"k"=>[0,"\xE2p"],"l"=>[0,"\xE2r"],"m"=>[0,"\xE2u"],"n"=>[100,"\xE2"],"o"=>[110,"\xE2"],"p"=>[111,"\xE2"],"q"=>[115,"\xE2"],"r"=>[116,"\xE2"],"s"=>[118,"\xE2"],"t"=>[119,"\xE2"],"u"=>[122,"\xE2"],"v"=>[123,"\xE2"],"w"=>[125,"\xE2"],"x"=>[126,"\xE2"],"y"=>[129,"\xE2"],"z"=>[143,"\xE2"],"\x7B"=>[148,"\xE2"],"\x7C"=>[151,"\xE2"],"\x7D"=>[153,"\xE2"],"~"=>[83,"\xE2"],"\x7F"=>[10,"\xE2"],"\x80"=>[0,"\x990"],"\x81"=>[0,"\x991"],"\x82"=>[0,"\x992"],"\x83"=>[0,"\x99a"],"\x84"=>[0,"\x99c"],"\x85"=>[0,"\x99e"],"\x86"=>[0,"\x99i"],"\x87"=>[0,"\x99o"],"\x88"=>[0,"\x99s"],"\x89"=>[0,"\x99t"],"\x8A"=>[73,"\x99"],"\x8B"=>[88,"\x99"],"\x8C"=>[89,"\x99"],"\x8D"=>[96,"\x99"],"\x8E"=>[97,"\x99"],"\x8F"=>[99,"\x99"],"\x90"=>[106,"\x99"],"\x91"=>[136,"\x99"],"\x92"=>[139,"\x99"],"\x93"=>[141,"\x99"],"\x94"=>[145,"\x99"],"\x95"=>[147,"\x99"],"\x96"=>[149,"\x99"],"\x97"=>[101,"\x99"],"\x98"=>[112,"\x99"],"\x99"=>[117,"\x99"],"\x9A"=>[120,"\x99"],"\x9B"=>[124,"\x99"],"\x9C"=>[127,"\x99"],"\x9D"=>[144,"\x99"],"\x9E"=>[152,"\x99"],"\x9F"=>[11,"\x99"],"\xA0"=>[0,"\xA10"],"\xA1"=>[0,"\xA11"],"\xA2"=>[0,"\xA12"],"\xA3"=>[0,"\xA1a"],"\xA4"=>[0,"\xA1c"],"\xA5"=>[0,"\xA1e"],"\xA6"=>[0,"\xA1i"],"\xA7"=>[0,"\xA1o"],"\xA8"=>[0,"\xA1s"],"\xA9"=>[0,"\xA1t"],"\xAA"=>[73,"\xA1"],"\xAB"=>[88,"\xA1"],"\xAC"=>[89,"\xA1"],"\xAD"=>[96,"\xA1"],"\xAE"=>[97,"\xA1"],"\xAF"=>[99,"\xA1"],"\xB0"=>[106,"\xA1"],"\xB1"=>[136,"\xA1"],"\xB2"=>[139,"\xA1"],"\xB3"=>[141,"\xA1"],"\xB4"=>[145,"\xA1"],"\xB5"=>[147,"\xA1"],"\xB6"=>[149,"\xA1"],"\xB7"=>[101,"\xA1"],"\xB8"=>[112,"\xA1"],"\xB9"=>[117,"\xA1"],"\xBA"=>[120,"\xA1"],"\xBB"=>[124,"\xA1"],"\xBC"=>[127,"\xA1"],"\xBD"=>[144,"\xA1"],"\xBE"=>[152,"\xA1"],"\xBF"=>[11,"\xA1"],"\xC0"=>[0,"\xA70"],"\xC1"=>[0,"\xA71"],"\xC2"=>[0,"\xA72"],"\xC3"=>[0,"\xA7a"],"\xC4"=>[0,"\xA7c"],"\xC5"=>[0,"\xA7e"],"\xC6"=>[0,"\xA7i"],"\xC7"=>[0,"\xA7o"],"\xC8"=>[0,"\xA7s"],"\xC9"=>[0,"\xA7t"],"\xCA"=>[73,"\xA7"],"\xCB"=>[88,"\xA7"],"\xCC"=>[89,"\xA7"],"\xCD"=>[96,"\xA7"],"\xCE"=>[97,"\xA7"],"\xCF"=>[99,"\xA7"],"\xD0"=>[106,"\xA7"],"\xD1"=>[136,"\xA7"],"\xD2"=>[139,"\xA7"],"\xD3"=>[141,"\xA7"],"\xD4"=>[145,"\xA7"],"\xD5"=>[147,"\xA7"],"\xD6"=>[149,"\xA7"],"\xD7"=>[101,"\xA7"],"\xD8"=>[112,"\xA7"],"\xD9"=>[117,"\xA7"],"\xDA"=>[120,"\xA7"],"\xDB"=>[124,"\xA7"],"\xDC"=>[127,"\xA7"],"\xDD"=>[144,"\xA7"],"\xDE"=>[152,"\xA7"],"\xDF"=>[11,"\xA7"],"\xE0"=>[0,"\xAC0"],"\xE1"=>[0,"\xAC1"],"\xE2"=>[0,"\xAC2"],"\xE3"=>[0,"\xACa"],"\xE4"=>[0,"\xACc"],"\xE5"=>[0,"\xACe"],"\xE6"=>[0,"\xACi"],"\xE7"=>[0,"\xACo"],"\xE8"=>[0,"\xACs"],"\xE9"=>[0,"\xACt"],"\xEA"=>[73,"\xAC"],"\xEB"=>[88,"\xAC"],"\xEC"=>[89,"\xAC"],"\xED"=>[96,"\xAC"],"\xEE"=>[97,"\xAC"],"\xEF"=>[99,"\xAC"],"\xF0"=>[106,"\xAC"],"\xF1"=>[136,"\xAC"],"\xF2"=>[139,"\xAC"],"\xF3"=>[141,"\xAC"],"\xF4"=>[145,"\xAC"],"\xF5"=>[147,"\xAC"],"\xF6"=>[149,"\xAC"],"\xF7"=>[101,"\xAC"],"\xF8"=>[112,"\xAC"],"\xF9"=>[117,"\xAC"],"\xFA"=>[120,"\xAC"],"\xFB"=>[124,"\xAC"],"\xFC"=>[127,"\xAC"],"\xFD"=>[144,"\xAC"],"\xFE"=>[152,"\xAC"],"\xFF"=>[11,"\xAC"],],["\x00"=>[94,"\x9A0"],"\x01"=>[76,"\x9A0"],"\x02"=>[104,"\x9A0"],"\x03"=>[16,"\x9A0"],"\x04"=>[94,"\x9A1"],"\x05"=>[76,"\x9A1"],"\x06"=>[104,"\x9A1"],"\x07"=>[16,"\x9A1"],"\x08"=>[94,"\x9A2"],"\x09"=>[76,"\x9A2"],"\x0A"=>[104,"\x9A2"],"\x0B"=>[16,"\x9A2"],"\x0C"=>[94,"\x9Aa"],"\x0D"=>[76,"\x9Aa"],"\x0E"=>[104,"\x9Aa"],"\x0F"=>[16,"\x9Aa"],"\x10"=>[94,"\x9Ac"],"\x11"=>[76,"\x9Ac"],"\x12"=>[104,"\x9Ac"],"\x13"=>[16,"\x9Ac"],"\x14"=>[94,"\x9Ae"],"\x15"=>[76,"\x9Ae"],"\x16"=>[104,"\x9Ae"],"\x17"=>[16,"\x9Ae"],"\x18"=>[94,"\x9Ai"],"\x19"=>[76,"\x9Ai"],"\x1A"=>[104,"\x9Ai"],"\x1B"=>[16,"\x9Ai"],"\x1C"=>[94,"\x9Ao"],"\x1D"=>[76,"\x9Ao"],"\x1E"=>[104,"\x9Ao"],"\x1F"=>[16,"\x9Ao"],"\x20"=>[94,"\x9As"],"\x21"=>[76,"\x9As"],"\x22"=>[104,"\x9As"],"\x23"=>[16,"\x9As"],"\x24"=>[94,"\x9At"],"\x25"=>[76,"\x9At"],"\x26"=>[104,"\x9At"],"\x27"=>[16,"\x9At"],"\x28"=>[77,"\x9A\x20"],"\x29"=>[18,"\x9A\x20"],"\x2A"=>[77,"\x9A\x25"],"\x2B"=>[18,"\x9A\x25"],"\x2C"=>[77,"\x9A-"],"-"=>[18,"\x9A-"],"."=>[77,"\x9A."],"\x2F"=>[18,"\x9A."],[77,"\x9A\x2F"],[18,"\x9A\x2F"],[77,"\x9A3"],[18,"\x9A3"],[77,"\x9A4"],[18,"\x9A4"],[77,"\x9A5"],[18,"\x9A5"],[77,"\x9A6"],[18,"\x9A6"],"\x3A"=>[77,"\x9A7"],"\x3B"=>[18,"\x9A7"],"\x3C"=>[77,"\x9A8"],"\x3D"=>[18,"\x9A8"],"\x3E"=>[77,"\x9A9"],"\x3F"=>[18,"\x9A9"],"\x40"=>[77,"\x9A\x3D"],"A"=>[18,"\x9A\x3D"],"B"=>[77,"\x9AA"],"C"=>[18,"\x9AA"],"D"=>[77,"\x9A_"],"E"=>[18,"\x9A_"],"F"=>[77,"\x9Ab"],"G"=>[18,"\x9Ab"],"H"=>[77,"\x9Ad"],"I"=>[18,"\x9Ad"],"J"=>[77,"\x9Af"],"K"=>[18,"\x9Af"],"L"=>[77,"\x9Ag"],"M"=>[18,"\x9Ag"],"N"=>[77,"\x9Ah"],"O"=>[18,"\x9Ah"],"P"=>[77,"\x9Al"],"Q"=>[18,"\x9Al"],"R"=>[77,"\x9Am"],"S"=>[18,"\x9Am"],"T"=>[77,"\x9An"],"U"=>[18,"\x9An"],"V"=>[77,"\x9Ap"],"W"=>[18,"\x9Ap"],"X"=>[77,"\x9Ar"],"Y"=>[18,"\x9Ar"],"Z"=>[77,"\x9Au"],"\x5B"=>[18,"\x9Au"],"\x5C"=>[0,"\x9A\x3A"],"\x5D"=>[0,"\x9AB"],"\x5E"=>[0,"\x9AC"],"_"=>[0,"\x9AD"],"\x60"=>[0,"\x9AE"],"a"=>[0,"\x9AF"],"b"=>[0,"\x9AG"],"c"=>[0,"\x9AH"],"d"=>[0,"\x9AI"],"e"=>[0,"\x9AJ"],"f"=>[0,"\x9AK"],"g"=>[0,"\x9AL"],"h"=>[0,"\x9AM"],"i"=>[0,"\x9AN"],"j"=>[0,"\x9AO"],"k"=>[0,"\x9AP"],"l"=>[0,"\x9AQ"],"m"=>[0,"\x9AR"],"n"=>[0,"\x9AS"],"o"=>[0,"\x9AT"],"p"=>[0,"\x9AU"],"q"=>[0,"\x9AV"],"r"=>[0,"\x9AW"],"s"=>[0,"\x9AY"],"t"=>[0,"\x9Aj"],"u"=>[0,"\x9Ak"],"v"=>[0,"\x9Aq"],"w"=>[0,"\x9Av"],"x"=>[0,"\x9Aw"],"y"=>[0,"\x9Ax"],"z"=>[0,"\x9Ay"],"\x7B"=>[0,"\x9Az"],"\x7C"=>[82,"\x9A"],"\x7D"=>[87,"\x9A"],"~"=>[130,"\x9A"],"\x7F"=>[9,"\x9A"],"\x80"=>[94,"\x9C0"],"\x81"=>[76,"\x9C0"],"\x82"=>[104,"\x9C0"],"\x83"=>[16,"\x9C0"],"\x84"=>[94,"\x9C1"],"\x85"=>[76,"\x9C1"],"\x86"=>[104,"\x9C1"],"\x87"=>[16,"\x9C1"],"\x88"=>[94,"\x9C2"],"\x89"=>[76,"\x9C2"],"\x8A"=>[104,"\x9C2"],"\x8B"=>[16,"\x9C2"],"\x8C"=>[94,"\x9Ca"],"\x8D"=>[76,"\x9Ca"],"\x8E"=>[104,"\x9Ca"],"\x8F"=>[16,"\x9Ca"],"\x90"=>[94,"\x9Cc"],"\x91"=>[76,"\x9Cc"],"\x92"=>[104,"\x9Cc"],"\x93"=>[16,"\x9Cc"],"\x94"=>[94,"\x9Ce"],"\x95"=>[76,"\x9Ce"],"\x96"=>[104,"\x9Ce"],"\x97"=>[16,"\x9Ce"],"\x98"=>[94,"\x9Ci"],"\x99"=>[76,"\x9Ci"],"\x9A"=>[104,"\x9Ci"],"\x9B"=>[16,"\x9Ci"],"\x9C"=>[94,"\x9Co"],"\x9D"=>[76,"\x9Co"],"\x9E"=>[104,"\x9Co"],"\x9F"=>[16,"\x9Co"],"\xA0"=>[94,"\x9Cs"],"\xA1"=>[76,"\x9Cs"],"\xA2"=>[104,"\x9Cs"],"\xA3"=>[16,"\x9Cs"],"\xA4"=>[94,"\x9Ct"],"\xA5"=>[76,"\x9Ct"],"\xA6"=>[104,"\x9Ct"],"\xA7"=>[16,"\x9Ct"],"\xA8"=>[77,"\x9C\x20"],"\xA9"=>[18,"\x9C\x20"],"\xAA"=>[77,"\x9C\x25"],"\xAB"=>[18,"\x9C\x25"],"\xAC"=>[77,"\x9C-"],"\xAD"=>[18,"\x9C-"],"\xAE"=>[77,"\x9C."],"\xAF"=>[18,"\x9C."],"\xB0"=>[77,"\x9C\x2F"],"\xB1"=>[18,"\x9C\x2F"],"\xB2"=>[77,"\x9C3"],"\xB3"=>[18,"\x9C3"],"\xB4"=>[77,"\x9C4"],"\xB5"=>[18,"\x9C4"],"\xB6"=>[77,"\x9C5"],"\xB7"=>[18,"\x9C5"],"\xB8"=>[77,"\x9C6"],"\xB9"=>[18,"\x9C6"],"\xBA"=>[77,"\x9C7"],"\xBB"=>[18,"\x9C7"],"\xBC"=>[77,"\x9C8"],"\xBD"=>[18,"\x9C8"],"\xBE"=>[77,"\x9C9"],"\xBF"=>[18,"\x9C9"],"\xC0"=>[77,"\x9C\x3D"],"\xC1"=>[18,"\x9C\x3D"],"\xC2"=>[77,"\x9CA"],"\xC3"=>[18,"\x9CA"],"\xC4"=>[77,"\x9C_"],"\xC5"=>[18,"\x9C_"],"\xC6"=>[77,"\x9Cb"],"\xC7"=>[18,"\x9Cb"],"\xC8"=>[77,"\x9Cd"],"\xC9"=>[18,"\x9Cd"],"\xCA"=>[77,"\x9Cf"],"\xCB"=>[18,"\x9Cf"],"\xCC"=>[77,"\x9Cg"],"\xCD"=>[18,"\x9Cg"],"\xCE"=>[77,"\x9Ch"],"\xCF"=>[18,"\x9Ch"],"\xD0"=>[77,"\x9Cl"],"\xD1"=>[18,"\x9Cl"],"\xD2"=>[77,"\x9Cm"],"\xD3"=>[18,"\x9Cm"],"\xD4"=>[77,"\x9Cn"],"\xD5"=>[18,"\x9Cn"],"\xD6"=>[77,"\x9Cp"],"\xD7"=>[18,"\x9Cp"],"\xD8"=>[77,"\x9Cr"],"\xD9"=>[18,"\x9Cr"],"\xDA"=>[77,"\x9Cu"],"\xDB"=>[18,"\x9Cu"],"\xDC"=>[0,"\x9C\x3A"],"\xDD"=>[0,"\x9CB"],"\xDE"=>[0,"\x9CC"],"\xDF"=>[0,"\x9CD"],"\xE0"=>[0,"\x9CE"],"\xE1"=>[0,"\x9CF"],"\xE2"=>[0,"\x9CG"],"\xE3"=>[0,"\x9CH"],"\xE4"=>[0,"\x9CI"],"\xE5"=>[0,"\x9CJ"],"\xE6"=>[0,"\x9CK"],"\xE7"=>[0,"\x9CL"],"\xE8"=>[0,"\x9CM"],"\xE9"=>[0,"\x9CN"],"\xEA"=>[0,"\x9CO"],"\xEB"=>[0,"\x9CP"],"\xEC"=>[0,"\x9CQ"],"\xED"=>[0,"\x9CR"],"\xEE"=>[0,"\x9CS"],"\xEF"=>[0,"\x9CT"],"\xF0"=>[0,"\x9CU"],"\xF1"=>[0,"\x9CV"],"\xF2"=>[0,"\x9CW"],"\xF3"=>[0,"\x9CY"],"\xF4"=>[0,"\x9Cj"],"\xF5"=>[0,"\x9Ck"],"\xF6"=>[0,"\x9Cq"],"\xF7"=>[0,"\x9Cv"],"\xF8"=>[0,"\x9Cw"],"\xF9"=>[0,"\x9Cx"],"\xFA"=>[0,"\x9Cy"],"\xFB"=>[0,"\x9Cz"],"\xFC"=>[82,"\x9C"],"\xFD"=>[87,"\x9C"],"\xFE"=>[130,"\x9C"],"\xFF"=>[9,"\x9C"],],["\x00"=>[77,"\x9A0"],"\x01"=>[18,"\x9A0"],"\x02"=>[77,"\x9A1"],"\x03"=>[18,"\x9A1"],"\x04"=>[77,"\x9A2"],"\x05"=>[18,"\x9A2"],"\x06"=>[77,"\x9Aa"],"\x07"=>[18,"\x9Aa"],"\x08"=>[77,"\x9Ac"],"\x09"=>[18,"\x9Ac"],"\x0A"=>[77,"\x9Ae"],"\x0B"=>[18,"\x9Ae"],"\x0C"=>[77,"\x9Ai"],"\x0D"=>[18,"\x9Ai"],"\x0E"=>[77,"\x9Ao"],"\x0F"=>[18,"\x9Ao"],"\x10"=>[77,"\x9As"],"\x11"=>[18,"\x9As"],"\x12"=>[77,"\x9At"],"\x13"=>[18,"\x9At"],"\x14"=>[0,"\x9A\x20"],"\x15"=>[0,"\x9A\x25"],"\x16"=>[0,"\x9A-"],"\x17"=>[0,"\x9A."],"\x18"=>[0,"\x9A\x2F"],"\x19"=>[0,"\x9A3"],"\x1A"=>[0,"\x9A4"],"\x1B"=>[0,"\x9A5"],"\x1C"=>[0,"\x9A6"],"\x1D"=>[0,"\x9A7"],"\x1E"=>[0,"\x9A8"],"\x1F"=>[0,"\x9A9"],"\x20"=>[0,"\x9A\x3D"],"\x21"=>[0,"\x9AA"],"\x22"=>[0,"\x9A_"],"\x23"=>[0,"\x9Ab"],"\x24"=>[0,"\x9Ad"],"\x25"=>[0,"\x9Af"],"\x26"=>[0,"\x9Ag"],"\x27"=>[0,"\x9Ah"],"\x28"=>[0,"\x9Al"],"\x29"=>[0,"\x9Am"],"\x2A"=>[0,"\x9An"],"\x2B"=>[0,"\x9Ap"],"\x2C"=>[0,"\x9Ar"],"-"=>[0,"\x9Au"],"."=>[100,"\x9A"],"\x2F"=>[110,"\x9A"],[111,"\x9A"],[115,"\x9A"],[116,"\x9A"],[118,"\x9A"],[119,"\x9A"],[122,"\x9A"],[123,"\x9A"],[125,"\x9A"],[126,"\x9A"],[129,"\x9A"],"\x3A"=>[143,"\x9A"],"\x3B"=>[148,"\x9A"],"\x3C"=>[151,"\x9A"],"\x3D"=>[153,"\x9A"],"\x3E"=>[83,"\x9A"],"\x3F"=>[10,"\x9A"],"\x40"=>[77,"\x9C0"],"A"=>[18,"\x9C0"],"B"=>[77,"\x9C1"],"C"=>[18,"\x9C1"],"D"=>[77,"\x9C2"],"E"=>[18,"\x9C2"],"F"=>[77,"\x9Ca"],"G"=>[18,"\x9Ca"],"H"=>[77,"\x9Cc"],"I"=>[18,"\x9Cc"],"J"=>[77,"\x9Ce"],"K"=>[18,"\x9Ce"],"L"=>[77,"\x9Ci"],"M"=>[18,"\x9Ci"],"N"=>[77,"\x9Co"],"O"=>[18,"\x9Co"],"P"=>[77,"\x9Cs"],"Q"=>[18,"\x9Cs"],"R"=>[77,"\x9Ct"],"S"=>[18,"\x9Ct"],"T"=>[0,"\x9C\x20"],"U"=>[0,"\x9C\x25"],"V"=>[0,"\x9C-"],"W"=>[0,"\x9C."],"X"=>[0,"\x9C\x2F"],"Y"=>[0,"\x9C3"],"Z"=>[0,"\x9C4"],"\x5B"=>[0,"\x9C5"],"\x5C"=>[0,"\x9C6"],"\x5D"=>[0,"\x9C7"],"\x5E"=>[0,"\x9C8"],"_"=>[0,"\x9C9"],"\x60"=>[0,"\x9C\x3D"],"a"=>[0,"\x9CA"],"b"=>[0,"\x9C_"],"c"=>[0,"\x9Cb"],"d"=>[0,"\x9Cd"],"e"=>[0,"\x9Cf"],"f"=>[0,"\x9Cg"],"g"=>[0,"\x9Ch"],"h"=>[0,"\x9Cl"],"i"=>[0,"\x9Cm"],"j"=>[0,"\x9Cn"],"k"=>[0,"\x9Cp"],"l"=>[0,"\x9Cr"],"m"=>[0,"\x9Cu"],"n"=>[100,"\x9C"],"o"=>[110,"\x9C"],"p"=>[111,"\x9C"],"q"=>[115,"\x9C"],"r"=>[116,"\x9C"],"s"=>[118,"\x9C"],"t"=>[119,"\x9C"],"u"=>[122,"\x9C"],"v"=>[123,"\x9C"],"w"=>[125,"\x9C"],"x"=>[126,"\x9C"],"y"=>[129,"\x9C"],"z"=>[143,"\x9C"],"\x7B"=>[148,"\x9C"],"\x7C"=>[151,"\x9C"],"\x7D"=>[153,"\x9C"],"~"=>[83,"\x9C"],"\x7F"=>[10,"\x9C"],"\x80"=>[77,"\xA00"],"\x81"=>[18,"\xA00"],"\x82"=>[77,"\xA01"],"\x83"=>[18,"\xA01"],"\x84"=>[77,"\xA02"],"\x85"=>[18,"\xA02"],"\x86"=>[77,"\xA0a"],"\x87"=>[18,"\xA0a"],"\x88"=>[77,"\xA0c"],"\x89"=>[18,"\xA0c"],"\x8A"=>[77,"\xA0e"],"\x8B"=>[18,"\xA0e"],"\x8C"=>[77,"\xA0i"],"\x8D"=>[18,"\xA0i"],"\x8E"=>[77,"\xA0o"],"\x8F"=>[18,"\xA0o"],"\x90"=>[77,"\xA0s"],"\x91"=>[18,"\xA0s"],"\x92"=>[77,"\xA0t"],"\x93"=>[18,"\xA0t"],"\x94"=>[0,"\xA0\x20"],"\x95"=>[0,"\xA0\x25"],"\x96"=>[0,"\xA0-"],"\x97"=>[0,"\xA0."],"\x98"=>[0,"\xA0\x2F"],"\x99"=>[0,"\xA03"],"\x9A"=>[0,"\xA04"],"\x9B"=>[0,"\xA05"],"\x9C"=>[0,"\xA06"],"\x9D"=>[0,"\xA07"],"\x9E"=>[0,"\xA08"],"\x9F"=>[0,"\xA09"],"\xA0"=>[0,"\xA0\x3D"],"\xA1"=>[0,"\xA0A"],"\xA2"=>[0,"\xA0_"],"\xA3"=>[0,"\xA0b"],"\xA4"=>[0,"\xA0d"],"\xA5"=>[0,"\xA0f"],"\xA6"=>[0,"\xA0g"],"\xA7"=>[0,"\xA0h"],"\xA8"=>[0,"\xA0l"],"\xA9"=>[0,"\xA0m"],"\xAA"=>[0,"\xA0n"],"\xAB"=>[0,"\xA0p"],"\xAC"=>[0,"\xA0r"],"\xAD"=>[0,"\xA0u"],"\xAE"=>[100,"\xA0"],"\xAF"=>[110,"\xA0"],"\xB0"=>[111,"\xA0"],"\xB1"=>[115,"\xA0"],"\xB2"=>[116,"\xA0"],"\xB3"=>[118,"\xA0"],"\xB4"=>[119,"\xA0"],"\xB5"=>[122,"\xA0"],"\xB6"=>[123,"\xA0"],"\xB7"=>[125,"\xA0"],"\xB8"=>[126,"\xA0"],"\xB9"=>[129,"\xA0"],"\xBA"=>[143,"\xA0"],"\xBB"=>[148,"\xA0"],"\xBC"=>[151,"\xA0"],"\xBD"=>[153,"\xA0"],"\xBE"=>[83,"\xA0"],"\xBF"=>[10,"\xA0"],"\xC0"=>[77,"\xA30"],"\xC1"=>[18,"\xA30"],"\xC2"=>[77,"\xA31"],"\xC3"=>[18,"\xA31"],"\xC4"=>[77,"\xA32"],"\xC5"=>[18,"\xA32"],"\xC6"=>[77,"\xA3a"],"\xC7"=>[18,"\xA3a"],"\xC8"=>[77,"\xA3c"],"\xC9"=>[18,"\xA3c"],"\xCA"=>[77,"\xA3e"],"\xCB"=>[18,"\xA3e"],"\xCC"=>[77,"\xA3i"],"\xCD"=>[18,"\xA3i"],"\xCE"=>[77,"\xA3o"],"\xCF"=>[18,"\xA3o"],"\xD0"=>[77,"\xA3s"],"\xD1"=>[18,"\xA3s"],"\xD2"=>[77,"\xA3t"],"\xD3"=>[18,"\xA3t"],"\xD4"=>[0,"\xA3\x20"],"\xD5"=>[0,"\xA3\x25"],"\xD6"=>[0,"\xA3-"],"\xD7"=>[0,"\xA3."],"\xD8"=>[0,"\xA3\x2F"],"\xD9"=>[0,"\xA33"],"\xDA"=>[0,"\xA34"],"\xDB"=>[0,"\xA35"],"\xDC"=>[0,"\xA36"],"\xDD"=>[0,"\xA37"],"\xDE"=>[0,"\xA38"],"\xDF"=>[0,"\xA39"],"\xE0"=>[0,"\xA3\x3D"],"\xE1"=>[0,"\xA3A"],"\xE2"=>[0,"\xA3_"],"\xE3"=>[0,"\xA3b"],"\xE4"=>[0,"\xA3d"],"\xE5"=>[0,"\xA3f"],"\xE6"=>[0,"\xA3g"],"\xE7"=>[0,"\xA3h"],"\xE8"=>[0,"\xA3l"],"\xE9"=>[0,"\xA3m"],"\xEA"=>[0,"\xA3n"],"\xEB"=>[0,"\xA3p"],"\xEC"=>[0,"\xA3r"],"\xED"=>[0,"\xA3u"],"\xEE"=>[100,"\xA3"],"\xEF"=>[110,"\xA3"],"\xF0"=>[111,"\xA3"],"\xF1"=>[115,"\xA3"],"\xF2"=>[116,"\xA3"],"\xF3"=>[118,"\xA3"],"\xF4"=>[119,"\xA3"],"\xF5"=>[122,"\xA3"],"\xF6"=>[123,"\xA3"],"\xF7"=>[125,"\xA3"],"\xF8"=>[126,"\xA3"],"\xF9"=>[129,"\xA3"],"\xFA"=>[143,"\xA3"],"\xFB"=>[148,"\xA3"],"\xFC"=>[151,"\xA3"],"\xFD"=>[153,"\xA3"],"\xFE"=>[83,"\xA3"],"\xFF"=>[10,"\xA3"],],["\x00"=>[0,"\x9A0"],"\x01"=>[0,"\x9A1"],"\x02"=>[0,"\x9A2"],"\x03"=>[0,"\x9Aa"],"\x04"=>[0,"\x9Ac"],"\x05"=>[0,"\x9Ae"],"\x06"=>[0,"\x9Ai"],"\x07"=>[0,"\x9Ao"],"\x08"=>[0,"\x9As"],"\x09"=>[0,"\x9At"],"\x0A"=>[73,"\x9A"],"\x0B"=>[88,"\x9A"],"\x0C"=>[89,"\x9A"],"\x0D"=>[96,"\x9A"],"\x0E"=>[97,"\x9A"],"\x0F"=>[99,"\x9A"],"\x10"=>[106,"\x9A"],"\x11"=>[136,"\x9A"],"\x12"=>[139,"\x9A"],"\x13"=>[141,"\x9A"],"\x14"=>[145,"\x9A"],"\x15"=>[147,"\x9A"],"\x16"=>[149,"\x9A"],"\x17"=>[101,"\x9A"],"\x18"=>[112,"\x9A"],"\x19"=>[117,"\x9A"],"\x1A"=>[120,"\x9A"],"\x1B"=>[124,"\x9A"],"\x1C"=>[127,"\x9A"],"\x1D"=>[144,"\x9A"],"\x1E"=>[152,"\x9A"],"\x1F"=>[11,"\x9A"],"\x20"=>[0,"\x9C0"],"\x21"=>[0,"\x9C1"],"\x22"=>[0,"\x9C2"],"\x23"=>[0,"\x9Ca"],"\x24"=>[0,"\x9Cc"],"\x25"=>[0,"\x9Ce"],"\x26"=>[0,"\x9Ci"],"\x27"=>[0,"\x9Co"],"\x28"=>[0,"\x9Cs"],"\x29"=>[0,"\x9Ct"],"\x2A"=>[73,"\x9C"],"\x2B"=>[88,"\x9C"],"\x2C"=>[89,"\x9C"],"-"=>[96,"\x9C"],"."=>[97,"\x9C"],"\x2F"=>[99,"\x9C"],[106,"\x9C"],[136,"\x9C"],[139,"\x9C"],[141,"\x9C"],[145,"\x9C"],[147,"\x9C"],[149,"\x9C"],[101,"\x9C"],[112,"\x9C"],[117,"\x9C"],"\x3A"=>[120,"\x9C"],"\x3B"=>[124,"\x9C"],"\x3C"=>[127,"\x9C"],"\x3D"=>[144,"\x9C"],"\x3E"=>[152,"\x9C"],"\x3F"=>[11,"\x9C"],"\x40"=>[0,"\xA00"],"A"=>[0,"\xA01"],"B"=>[0,"\xA02"],"C"=>[0,"\xA0a"],"D"=>[0,"\xA0c"],"E"=>[0,"\xA0e"],"F"=>[0,"\xA0i"],"G"=>[0,"\xA0o"],"H"=>[0,"\xA0s"],"I"=>[0,"\xA0t"],"J"=>[73,"\xA0"],"K"=>[88,"\xA0"],"L"=>[89,"\xA0"],"M"=>[96,"\xA0"],"N"=>[97,"\xA0"],"O"=>[99,"\xA0"],"P"=>[106,"\xA0"],"Q"=>[136,"\xA0"],"R"=>[139,"\xA0"],"S"=>[141,"\xA0"],"T"=>[145,"\xA0"],"U"=>[147,"\xA0"],"V"=>[149,"\xA0"],"W"=>[101,"\xA0"],"X"=>[112,"\xA0"],"Y"=>[117,"\xA0"],"Z"=>[120,"\xA0"],"\x5B"=>[124,"\xA0"],"\x5C"=>[127,"\xA0"],"\x5D"=>[144,"\xA0"],"\x5E"=>[152,"\xA0"],"_"=>[11,"\xA0"],"\x60"=>[0,"\xA30"],"a"=>[0,"\xA31"],"b"=>[0,"\xA32"],"c"=>[0,"\xA3a"],"d"=>[0,"\xA3c"],"e"=>[0,"\xA3e"],"f"=>[0,"\xA3i"],"g"=>[0,"\xA3o"],"h"=>[0,"\xA3s"],"i"=>[0,"\xA3t"],"j"=>[73,"\xA3"],"k"=>[88,"\xA3"],"l"=>[89,"\xA3"],"m"=>[96,"\xA3"],"n"=>[97,"\xA3"],"o"=>[99,"\xA3"],"p"=>[106,"\xA3"],"q"=>[136,"\xA3"],"r"=>[139,"\xA3"],"s"=>[141,"\xA3"],"t"=>[145,"\xA3"],"u"=>[147,"\xA3"],"v"=>[149,"\xA3"],"w"=>[101,"\xA3"],"x"=>[112,"\xA3"],"y"=>[117,"\xA3"],"z"=>[120,"\xA3"],"\x7B"=>[124,"\xA3"],"\x7C"=>[127,"\xA3"],"\x7D"=>[144,"\xA3"],"~"=>[152,"\xA3"],"\x7F"=>[11,"\xA3"],"\x80"=>[0,"\xA40"],"\x81"=>[0,"\xA41"],"\x82"=>[0,"\xA42"],"\x83"=>[0,"\xA4a"],"\x84"=>[0,"\xA4c"],"\x85"=>[0,"\xA4e"],"\x86"=>[0,"\xA4i"],"\x87"=>[0,"\xA4o"],"\x88"=>[0,"\xA4s"],"\x89"=>[0,"\xA4t"],"\x8A"=>[73,"\xA4"],"\x8B"=>[88,"\xA4"],"\x8C"=>[89,"\xA4"],"\x8D"=>[96,"\xA4"],"\x8E"=>[97,"\xA4"],"\x8F"=>[99,"\xA4"],"\x90"=>[106,"\xA4"],"\x91"=>[136,"\xA4"],"\x92"=>[139,"\xA4"],"\x93"=>[141,"\xA4"],"\x94"=>[145,"\xA4"],"\x95"=>[147,"\xA4"],"\x96"=>[149,"\xA4"],"\x97"=>[101,"\xA4"],"\x98"=>[112,"\xA4"],"\x99"=>[117,"\xA4"],"\x9A"=>[120,"\xA4"],"\x9B"=>[124,"\xA4"],"\x9C"=>[127,"\xA4"],"\x9D"=>[144,"\xA4"],"\x9E"=>[152,"\xA4"],"\x9F"=>[11,"\xA4"],"\xA0"=>[0,"\xA90"],"\xA1"=>[0,"\xA91"],"\xA2"=>[0,"\xA92"],"\xA3"=>[0,"\xA9a"],"\xA4"=>[0,"\xA9c"],"\xA5"=>[0,"\xA9e"],"\xA6"=>[0,"\xA9i"],"\xA7"=>[0,"\xA9o"],"\xA8"=>[0,"\xA9s"],"\xA9"=>[0,"\xA9t"],"\xAA"=>[73,"\xA9"],"\xAB"=>[88,"\xA9"],"\xAC"=>[89,"\xA9"],"\xAD"=>[96,"\xA9"],"\xAE"=>[97,"\xA9"],"\xAF"=>[99,"\xA9"],"\xB0"=>[106,"\xA9"],"\xB1"=>[136,"\xA9"],"\xB2"=>[139,"\xA9"],"\xB3"=>[141,"\xA9"],"\xB4"=>[145,"\xA9"],"\xB5"=>[147,"\xA9"],"\xB6"=>[149,"\xA9"],"\xB7"=>[101,"\xA9"],"\xB8"=>[112,"\xA9"],"\xB9"=>[117,"\xA9"],"\xBA"=>[120,"\xA9"],"\xBB"=>[124,"\xA9"],"\xBC"=>[127,"\xA9"],"\xBD"=>[144,"\xA9"],"\xBE"=>[152,"\xA9"],"\xBF"=>[11,"\xA9"],"\xC0"=>[0,"\xAA0"],"\xC1"=>[0,"\xAA1"],"\xC2"=>[0,"\xAA2"],"\xC3"=>[0,"\xAAa"],"\xC4"=>[0,"\xAAc"],"\xC5"=>[0,"\xAAe"],"\xC6"=>[0,"\xAAi"],"\xC7"=>[0,"\xAAo"],"\xC8"=>[0,"\xAAs"],"\xC9"=>[0,"\xAAt"],"\xCA"=>[73,"\xAA"],"\xCB"=>[88,"\xAA"],"\xCC"=>[89,"\xAA"],"\xCD"=>[96,"\xAA"],"\xCE"=>[97,"\xAA"],"\xCF"=>[99,"\xAA"],"\xD0"=>[106,"\xAA"],"\xD1"=>[136,"\xAA"],"\xD2"=>[139,"\xAA"],"\xD3"=>[141,"\xAA"],"\xD4"=>[145,"\xAA"],"\xD5"=>[147,"\xAA"],"\xD6"=>[149,"\xAA"],"\xD7"=>[101,"\xAA"],"\xD8"=>[112,"\xAA"],"\xD9"=>[117,"\xAA"],"\xDA"=>[120,"\xAA"],"\xDB"=>[124,"\xAA"],"\xDC"=>[127,"\xAA"],"\xDD"=>[144,"\xAA"],"\xDE"=>[152,"\xAA"],"\xDF"=>[11,"\xAA"],"\xE0"=>[0,"\xAD0"],"\xE1"=>[0,"\xAD1"],"\xE2"=>[0,"\xAD2"],"\xE3"=>[0,"\xADa"],"\xE4"=>[0,"\xADc"],"\xE5"=>[0,"\xADe"],"\xE6"=>[0,"\xADi"],"\xE7"=>[0,"\xADo"],"\xE8"=>[0,"\xADs"],"\xE9"=>[0,"\xADt"],"\xEA"=>[73,"\xAD"],"\xEB"=>[88,"\xAD"],"\xEC"=>[89,"\xAD"],"\xED"=>[96,"\xAD"],"\xEE"=>[97,"\xAD"],"\xEF"=>[99,"\xAD"],"\xF0"=>[106,"\xAD"],"\xF1"=>[136,"\xAD"],"\xF2"=>[139,"\xAD"],"\xF3"=>[141,"\xAD"],"\xF4"=>[145,"\xAD"],"\xF5"=>[147,"\xAD"],"\xF6"=>[149,"\xAD"],"\xF7"=>[101,"\xAD"],"\xF8"=>[112,"\xAD"],"\xF9"=>[117,"\xAD"],"\xFA"=>[120,"\xAD"],"\xFB"=>[124,"\xAD"],"\xFC"=>[127,"\xAD"],"\xFD"=>[144,"\xAD"],"\xFE"=>[152,"\xAD"],"\xFF"=>[11,"\xAD"],],["\x00"=>[94,"\x9D0"],"\x01"=>[76,"\x9D0"],"\x02"=>[104,"\x9D0"],"\x03"=>[16,"\x9D0"],"\x04"=>[94,"\x9D1"],"\x05"=>[76,"\x9D1"],"\x06"=>[104,"\x9D1"],"\x07"=>[16,"\x9D1"],"\x08"=>[94,"\x9D2"],"\x09"=>[76,"\x9D2"],"\x0A"=>[104,"\x9D2"],"\x0B"=>[16,"\x9D2"],"\x0C"=>[94,"\x9Da"],"\x0D"=>[76,"\x9Da"],"\x0E"=>[104,"\x9Da"],"\x0F"=>[16,"\x9Da"],"\x10"=>[94,"\x9Dc"],"\x11"=>[76,"\x9Dc"],"\x12"=>[104,"\x9Dc"],"\x13"=>[16,"\x9Dc"],"\x14"=>[94,"\x9De"],"\x15"=>[76,"\x9De"],"\x16"=>[104,"\x9De"],"\x17"=>[16,"\x9De"],"\x18"=>[94,"\x9Di"],"\x19"=>[76,"\x9Di"],"\x1A"=>[104,"\x9Di"],"\x1B"=>[16,"\x9Di"],"\x1C"=>[94,"\x9Do"],"\x1D"=>[76,"\x9Do"],"\x1E"=>[104,"\x9Do"],"\x1F"=>[16,"\x9Do"],"\x20"=>[94,"\x9Ds"],"\x21"=>[76,"\x9Ds"],"\x22"=>[104,"\x9Ds"],"\x23"=>[16,"\x9Ds"],"\x24"=>[94,"\x9Dt"],"\x25"=>[76,"\x9Dt"],"\x26"=>[104,"\x9Dt"],"\x27"=>[16,"\x9Dt"],"\x28"=>[77,"\x9D\x20"],"\x29"=>[18,"\x9D\x20"],"\x2A"=>[77,"\x9D\x25"],"\x2B"=>[18,"\x9D\x25"],"\x2C"=>[77,"\x9D-"],"-"=>[18,"\x9D-"],"."=>[77,"\x9D."],"\x2F"=>[18,"\x9D."],[77,"\x9D\x2F"],[18,"\x9D\x2F"],[77,"\x9D3"],[18,"\x9D3"],[77,"\x9D4"],[18,"\x9D4"],[77,"\x9D5"],[18,"\x9D5"],[77,"\x9D6"],[18,"\x9D6"],"\x3A"=>[77,"\x9D7"],"\x3B"=>[18,"\x9D7"],"\x3C"=>[77,"\x9D8"],"\x3D"=>[18,"\x9D8"],"\x3E"=>[77,"\x9D9"],"\x3F"=>[18,"\x9D9"],"\x40"=>[77,"\x9D\x3D"],"A"=>[18,"\x9D\x3D"],"B"=>[77,"\x9DA"],"C"=>[18,"\x9DA"],"D"=>[77,"\x9D_"],"E"=>[18,"\x9D_"],"F"=>[77,"\x9Db"],"G"=>[18,"\x9Db"],"H"=>[77,"\x9Dd"],"I"=>[18,"\x9Dd"],"J"=>[77,"\x9Df"],"K"=>[18,"\x9Df"],"L"=>[77,"\x9Dg"],"M"=>[18,"\x9Dg"],"N"=>[77,"\x9Dh"],"O"=>[18,"\x9Dh"],"P"=>[77,"\x9Dl"],"Q"=>[18,"\x9Dl"],"R"=>[77,"\x9Dm"],"S"=>[18,"\x9Dm"],"T"=>[77,"\x9Dn"],"U"=>[18,"\x9Dn"],"V"=>[77,"\x9Dp"],"W"=>[18,"\x9Dp"],"X"=>[77,"\x9Dr"],"Y"=>[18,"\x9Dr"],"Z"=>[77,"\x9Du"],"\x5B"=>[18,"\x9Du"],"\x5C"=>[0,"\x9D\x3A"],"\x5D"=>[0,"\x9DB"],"\x5E"=>[0,"\x9DC"],"_"=>[0,"\x9DD"],"\x60"=>[0,"\x9DE"],"a"=>[0,"\x9DF"],"b"=>[0,"\x9DG"],"c"=>[0,"\x9DH"],"d"=>[0,"\x9DI"],"e"=>[0,"\x9DJ"],"f"=>[0,"\x9DK"],"g"=>[0,"\x9DL"],"h"=>[0,"\x9DM"],"i"=>[0,"\x9DN"],"j"=>[0,"\x9DO"],"k"=>[0,"\x9DP"],"l"=>[0,"\x9DQ"],"m"=>[0,"\x9DR"],"n"=>[0,"\x9DS"],"o"=>[0,"\x9DT"],"p"=>[0,"\x9DU"],"q"=>[0,"\x9DV"],"r"=>[0,"\x9DW"],"s"=>[0,"\x9DY"],"t"=>[0,"\x9Dj"],"u"=>[0,"\x9Dk"],"v"=>[0,"\x9Dq"],"w"=>[0,"\x9Dv"],"x"=>[0,"\x9Dw"],"y"=>[0,"\x9Dx"],"z"=>[0,"\x9Dy"],"\x7B"=>[0,"\x9Dz"],"\x7C"=>[82,"\x9D"],"\x7D"=>[87,"\x9D"],"~"=>[130,"\x9D"],"\x7F"=>[9,"\x9D"],"\x80"=>[94,"\x9E0"],"\x81"=>[76,"\x9E0"],"\x82"=>[104,"\x9E0"],"\x83"=>[16,"\x9E0"],"\x84"=>[94,"\x9E1"],"\x85"=>[76,"\x9E1"],"\x86"=>[104,"\x9E1"],"\x87"=>[16,"\x9E1"],"\x88"=>[94,"\x9E2"],"\x89"=>[76,"\x9E2"],"\x8A"=>[104,"\x9E2"],"\x8B"=>[16,"\x9E2"],"\x8C"=>[94,"\x9Ea"],"\x8D"=>[76,"\x9Ea"],"\x8E"=>[104,"\x9Ea"],"\x8F"=>[16,"\x9Ea"],"\x90"=>[94,"\x9Ec"],"\x91"=>[76,"\x9Ec"],"\x92"=>[104,"\x9Ec"],"\x93"=>[16,"\x9Ec"],"\x94"=>[94,"\x9Ee"],"\x95"=>[76,"\x9Ee"],"\x96"=>[104,"\x9Ee"],"\x97"=>[16,"\x9Ee"],"\x98"=>[94,"\x9Ei"],"\x99"=>[76,"\x9Ei"],"\x9A"=>[104,"\x9Ei"],"\x9B"=>[16,"\x9Ei"],"\x9C"=>[94,"\x9Eo"],"\x9D"=>[76,"\x9Eo"],"\x9E"=>[104,"\x9Eo"],"\x9F"=>[16,"\x9Eo"],"\xA0"=>[94,"\x9Es"],"\xA1"=>[76,"\x9Es"],"\xA2"=>[104,"\x9Es"],"\xA3"=>[16,"\x9Es"],"\xA4"=>[94,"\x9Et"],"\xA5"=>[76,"\x9Et"],"\xA6"=>[104,"\x9Et"],"\xA7"=>[16,"\x9Et"],"\xA8"=>[77,"\x9E\x20"],"\xA9"=>[18,"\x9E\x20"],"\xAA"=>[77,"\x9E\x25"],"\xAB"=>[18,"\x9E\x25"],"\xAC"=>[77,"\x9E-"],"\xAD"=>[18,"\x9E-"],"\xAE"=>[77,"\x9E."],"\xAF"=>[18,"\x9E."],"\xB0"=>[77,"\x9E\x2F"],"\xB1"=>[18,"\x9E\x2F"],"\xB2"=>[77,"\x9E3"],"\xB3"=>[18,"\x9E3"],"\xB4"=>[77,"\x9E4"],"\xB5"=>[18,"\x9E4"],"\xB6"=>[77,"\x9E5"],"\xB7"=>[18,"\x9E5"],"\xB8"=>[77,"\x9E6"],"\xB9"=>[18,"\x9E6"],"\xBA"=>[77,"\x9E7"],"\xBB"=>[18,"\x9E7"],"\xBC"=>[77,"\x9E8"],"\xBD"=>[18,"\x9E8"],"\xBE"=>[77,"\x9E9"],"\xBF"=>[18,"\x9E9"],"\xC0"=>[77,"\x9E\x3D"],"\xC1"=>[18,"\x9E\x3D"],"\xC2"=>[77,"\x9EA"],"\xC3"=>[18,"\x9EA"],"\xC4"=>[77,"\x9E_"],"\xC5"=>[18,"\x9E_"],"\xC6"=>[77,"\x9Eb"],"\xC7"=>[18,"\x9Eb"],"\xC8"=>[77,"\x9Ed"],"\xC9"=>[18,"\x9Ed"],"\xCA"=>[77,"\x9Ef"],"\xCB"=>[18,"\x9Ef"],"\xCC"=>[77,"\x9Eg"],"\xCD"=>[18,"\x9Eg"],"\xCE"=>[77,"\x9Eh"],"\xCF"=>[18,"\x9Eh"],"\xD0"=>[77,"\x9El"],"\xD1"=>[18,"\x9El"],"\xD2"=>[77,"\x9Em"],"\xD3"=>[18,"\x9Em"],"\xD4"=>[77,"\x9En"],"\xD5"=>[18,"\x9En"],"\xD6"=>[77,"\x9Ep"],"\xD7"=>[18,"\x9Ep"],"\xD8"=>[77,"\x9Er"],"\xD9"=>[18,"\x9Er"],"\xDA"=>[77,"\x9Eu"],"\xDB"=>[18,"\x9Eu"],"\xDC"=>[0,"\x9E\x3A"],"\xDD"=>[0,"\x9EB"],"\xDE"=>[0,"\x9EC"],"\xDF"=>[0,"\x9ED"],"\xE0"=>[0,"\x9EE"],"\xE1"=>[0,"\x9EF"],"\xE2"=>[0,"\x9EG"],"\xE3"=>[0,"\x9EH"],"\xE4"=>[0,"\x9EI"],"\xE5"=>[0,"\x9EJ"],"\xE6"=>[0,"\x9EK"],"\xE7"=>[0,"\x9EL"],"\xE8"=>[0,"\x9EM"],"\xE9"=>[0,"\x9EN"],"\xEA"=>[0,"\x9EO"],"\xEB"=>[0,"\x9EP"],"\xEC"=>[0,"\x9EQ"],"\xED"=>[0,"\x9ER"],"\xEE"=>[0,"\x9ES"],"\xEF"=>[0,"\x9ET"],"\xF0"=>[0,"\x9EU"],"\xF1"=>[0,"\x9EV"],"\xF2"=>[0,"\x9EW"],"\xF3"=>[0,"\x9EY"],"\xF4"=>[0,"\x9Ej"],"\xF5"=>[0,"\x9Ek"],"\xF6"=>[0,"\x9Eq"],"\xF7"=>[0,"\x9Ev"],"\xF8"=>[0,"\x9Ew"],"\xF9"=>[0,"\x9Ex"],"\xFA"=>[0,"\x9Ey"],"\xFB"=>[0,"\x9Ez"],"\xFC"=>[82,"\x9E"],"\xFD"=>[87,"\x9E"],"\xFE"=>[130,"\x9E"],"\xFF"=>[9,"\x9E"],],["\x00"=>[94,"\xA00"],"\x01"=>[76,"\xA00"],"\x02"=>[104,"\xA00"],"\x03"=>[16,"\xA00"],"\x04"=>[94,"\xA01"],"\x05"=>[76,"\xA01"],"\x06"=>[104,"\xA01"],"\x07"=>[16,"\xA01"],"\x08"=>[94,"\xA02"],"\x09"=>[76,"\xA02"],"\x0A"=>[104,"\xA02"],"\x0B"=>[16,"\xA02"],"\x0C"=>[94,"\xA0a"],"\x0D"=>[76,"\xA0a"],"\x0E"=>[104,"\xA0a"],"\x0F"=>[16,"\xA0a"],"\x10"=>[94,"\xA0c"],"\x11"=>[76,"\xA0c"],"\x12"=>[104,"\xA0c"],"\x13"=>[16,"\xA0c"],"\x14"=>[94,"\xA0e"],"\x15"=>[76,"\xA0e"],"\x16"=>[104,"\xA0e"],"\x17"=>[16,"\xA0e"],"\x18"=>[94,"\xA0i"],"\x19"=>[76,"\xA0i"],"\x1A"=>[104,"\xA0i"],"\x1B"=>[16,"\xA0i"],"\x1C"=>[94,"\xA0o"],"\x1D"=>[76,"\xA0o"],"\x1E"=>[104,"\xA0o"],"\x1F"=>[16,"\xA0o"],"\x20"=>[94,"\xA0s"],"\x21"=>[76,"\xA0s"],"\x22"=>[104,"\xA0s"],"\x23"=>[16,"\xA0s"],"\x24"=>[94,"\xA0t"],"\x25"=>[76,"\xA0t"],"\x26"=>[104,"\xA0t"],"\x27"=>[16,"\xA0t"],"\x28"=>[77,"\xA0\x20"],"\x29"=>[18,"\xA0\x20"],"\x2A"=>[77,"\xA0\x25"],"\x2B"=>[18,"\xA0\x25"],"\x2C"=>[77,"\xA0-"],"-"=>[18,"\xA0-"],"."=>[77,"\xA0."],"\x2F"=>[18,"\xA0."],[77,"\xA0\x2F"],[18,"\xA0\x2F"],[77,"\xA03"],[18,"\xA03"],[77,"\xA04"],[18,"\xA04"],[77,"\xA05"],[18,"\xA05"],[77,"\xA06"],[18,"\xA06"],"\x3A"=>[77,"\xA07"],"\x3B"=>[18,"\xA07"],"\x3C"=>[77,"\xA08"],"\x3D"=>[18,"\xA08"],"\x3E"=>[77,"\xA09"],"\x3F"=>[18,"\xA09"],"\x40"=>[77,"\xA0\x3D"],"A"=>[18,"\xA0\x3D"],"B"=>[77,"\xA0A"],"C"=>[18,"\xA0A"],"D"=>[77,"\xA0_"],"E"=>[18,"\xA0_"],"F"=>[77,"\xA0b"],"G"=>[18,"\xA0b"],"H"=>[77,"\xA0d"],"I"=>[18,"\xA0d"],"J"=>[77,"\xA0f"],"K"=>[18,"\xA0f"],"L"=>[77,"\xA0g"],"M"=>[18,"\xA0g"],"N"=>[77,"\xA0h"],"O"=>[18,"\xA0h"],"P"=>[77,"\xA0l"],"Q"=>[18,"\xA0l"],"R"=>[77,"\xA0m"],"S"=>[18,"\xA0m"],"T"=>[77,"\xA0n"],"U"=>[18,"\xA0n"],"V"=>[77,"\xA0p"],"W"=>[18,"\xA0p"],"X"=>[77,"\xA0r"],"Y"=>[18,"\xA0r"],"Z"=>[77,"\xA0u"],"\x5B"=>[18,"\xA0u"],"\x5C"=>[0,"\xA0\x3A"],"\x5D"=>[0,"\xA0B"],"\x5E"=>[0,"\xA0C"],"_"=>[0,"\xA0D"],"\x60"=>[0,"\xA0E"],"a"=>[0,"\xA0F"],"b"=>[0,"\xA0G"],"c"=>[0,"\xA0H"],"d"=>[0,"\xA0I"],"e"=>[0,"\xA0J"],"f"=>[0,"\xA0K"],"g"=>[0,"\xA0L"],"h"=>[0,"\xA0M"],"i"=>[0,"\xA0N"],"j"=>[0,"\xA0O"],"k"=>[0,"\xA0P"],"l"=>[0,"\xA0Q"],"m"=>[0,"\xA0R"],"n"=>[0,"\xA0S"],"o"=>[0,"\xA0T"],"p"=>[0,"\xA0U"],"q"=>[0,"\xA0V"],"r"=>[0,"\xA0W"],"s"=>[0,"\xA0Y"],"t"=>[0,"\xA0j"],"u"=>[0,"\xA0k"],"v"=>[0,"\xA0q"],"w"=>[0,"\xA0v"],"x"=>[0,"\xA0w"],"y"=>[0,"\xA0x"],"z"=>[0,"\xA0y"],"\x7B"=>[0,"\xA0z"],"\x7C"=>[82,"\xA0"],"\x7D"=>[87,"\xA0"],"~"=>[130,"\xA0"],"\x7F"=>[9,"\xA0"],"\x80"=>[94,"\xA30"],"\x81"=>[76,"\xA30"],"\x82"=>[104,"\xA30"],"\x83"=>[16,"\xA30"],"\x84"=>[94,"\xA31"],"\x85"=>[76,"\xA31"],"\x86"=>[104,"\xA31"],"\x87"=>[16,"\xA31"],"\x88"=>[94,"\xA32"],"\x89"=>[76,"\xA32"],"\x8A"=>[104,"\xA32"],"\x8B"=>[16,"\xA32"],"\x8C"=>[94,"\xA3a"],"\x8D"=>[76,"\xA3a"],"\x8E"=>[104,"\xA3a"],"\x8F"=>[16,"\xA3a"],"\x90"=>[94,"\xA3c"],"\x91"=>[76,"\xA3c"],"\x92"=>[104,"\xA3c"],"\x93"=>[16,"\xA3c"],"\x94"=>[94,"\xA3e"],"\x95"=>[76,"\xA3e"],"\x96"=>[104,"\xA3e"],"\x97"=>[16,"\xA3e"],"\x98"=>[94,"\xA3i"],"\x99"=>[76,"\xA3i"],"\x9A"=>[104,"\xA3i"],"\x9B"=>[16,"\xA3i"],"\x9C"=>[94,"\xA3o"],"\x9D"=>[76,"\xA3o"],"\x9E"=>[104,"\xA3o"],"\x9F"=>[16,"\xA3o"],"\xA0"=>[94,"\xA3s"],"\xA1"=>[76,"\xA3s"],"\xA2"=>[104,"\xA3s"],"\xA3"=>[16,"\xA3s"],"\xA4"=>[94,"\xA3t"],"\xA5"=>[76,"\xA3t"],"\xA6"=>[104,"\xA3t"],"\xA7"=>[16,"\xA3t"],"\xA8"=>[77,"\xA3\x20"],"\xA9"=>[18,"\xA3\x20"],"\xAA"=>[77,"\xA3\x25"],"\xAB"=>[18,"\xA3\x25"],"\xAC"=>[77,"\xA3-"],"\xAD"=>[18,"\xA3-"],"\xAE"=>[77,"\xA3."],"\xAF"=>[18,"\xA3."],"\xB0"=>[77,"\xA3\x2F"],"\xB1"=>[18,"\xA3\x2F"],"\xB2"=>[77,"\xA33"],"\xB3"=>[18,"\xA33"],"\xB4"=>[77,"\xA34"],"\xB5"=>[18,"\xA34"],"\xB6"=>[77,"\xA35"],"\xB7"=>[18,"\xA35"],"\xB8"=>[77,"\xA36"],"\xB9"=>[18,"\xA36"],"\xBA"=>[77,"\xA37"],"\xBB"=>[18,"\xA37"],"\xBC"=>[77,"\xA38"],"\xBD"=>[18,"\xA38"],"\xBE"=>[77,"\xA39"],"\xBF"=>[18,"\xA39"],"\xC0"=>[77,"\xA3\x3D"],"\xC1"=>[18,"\xA3\x3D"],"\xC2"=>[77,"\xA3A"],"\xC3"=>[18,"\xA3A"],"\xC4"=>[77,"\xA3_"],"\xC5"=>[18,"\xA3_"],"\xC6"=>[77,"\xA3b"],"\xC7"=>[18,"\xA3b"],"\xC8"=>[77,"\xA3d"],"\xC9"=>[18,"\xA3d"],"\xCA"=>[77,"\xA3f"],"\xCB"=>[18,"\xA3f"],"\xCC"=>[77,"\xA3g"],"\xCD"=>[18,"\xA3g"],"\xCE"=>[77,"\xA3h"],"\xCF"=>[18,"\xA3h"],"\xD0"=>[77,"\xA3l"],"\xD1"=>[18,"\xA3l"],"\xD2"=>[77,"\xA3m"],"\xD3"=>[18,"\xA3m"],"\xD4"=>[77,"\xA3n"],"\xD5"=>[18,"\xA3n"],"\xD6"=>[77,"\xA3p"],"\xD7"=>[18,"\xA3p"],"\xD8"=>[77,"\xA3r"],"\xD9"=>[18,"\xA3r"],"\xDA"=>[77,"\xA3u"],"\xDB"=>[18,"\xA3u"],"\xDC"=>[0,"\xA3\x3A"],"\xDD"=>[0,"\xA3B"],"\xDE"=>[0,"\xA3C"],"\xDF"=>[0,"\xA3D"],"\xE0"=>[0,"\xA3E"],"\xE1"=>[0,"\xA3F"],"\xE2"=>[0,"\xA3G"],"\xE3"=>[0,"\xA3H"],"\xE4"=>[0,"\xA3I"],"\xE5"=>[0,"\xA3J"],"\xE6"=>[0,"\xA3K"],"\xE7"=>[0,"\xA3L"],"\xE8"=>[0,"\xA3M"],"\xE9"=>[0,"\xA3N"],"\xEA"=>[0,"\xA3O"],"\xEB"=>[0,"\xA3P"],"\xEC"=>[0,"\xA3Q"],"\xED"=>[0,"\xA3R"],"\xEE"=>[0,"\xA3S"],"\xEF"=>[0,"\xA3T"],"\xF0"=>[0,"\xA3U"],"\xF1"=>[0,"\xA3V"],"\xF2"=>[0,"\xA3W"],"\xF3"=>[0,"\xA3Y"],"\xF4"=>[0,"\xA3j"],"\xF5"=>[0,"\xA3k"],"\xF6"=>[0,"\xA3q"],"\xF7"=>[0,"\xA3v"],"\xF8"=>[0,"\xA3w"],"\xF9"=>[0,"\xA3x"],"\xFA"=>[0,"\xA3y"],"\xFB"=>[0,"\xA3z"],"\xFC"=>[82,"\xA3"],"\xFD"=>[87,"\xA3"],"\xFE"=>[130,"\xA3"],"\xFF"=>[9,"\xA3"],],["\x00"=>[94,"\xA40"],"\x01"=>[76,"\xA40"],"\x02"=>[104,"\xA40"],"\x03"=>[16,"\xA40"],"\x04"=>[94,"\xA41"],"\x05"=>[76,"\xA41"],"\x06"=>[104,"\xA41"],"\x07"=>[16,"\xA41"],"\x08"=>[94,"\xA42"],"\x09"=>[76,"\xA42"],"\x0A"=>[104,"\xA42"],"\x0B"=>[16,"\xA42"],"\x0C"=>[94,"\xA4a"],"\x0D"=>[76,"\xA4a"],"\x0E"=>[104,"\xA4a"],"\x0F"=>[16,"\xA4a"],"\x10"=>[94,"\xA4c"],"\x11"=>[76,"\xA4c"],"\x12"=>[104,"\xA4c"],"\x13"=>[16,"\xA4c"],"\x14"=>[94,"\xA4e"],"\x15"=>[76,"\xA4e"],"\x16"=>[104,"\xA4e"],"\x17"=>[16,"\xA4e"],"\x18"=>[94,"\xA4i"],"\x19"=>[76,"\xA4i"],"\x1A"=>[104,"\xA4i"],"\x1B"=>[16,"\xA4i"],"\x1C"=>[94,"\xA4o"],"\x1D"=>[76,"\xA4o"],"\x1E"=>[104,"\xA4o"],"\x1F"=>[16,"\xA4o"],"\x20"=>[94,"\xA4s"],"\x21"=>[76,"\xA4s"],"\x22"=>[104,"\xA4s"],"\x23"=>[16,"\xA4s"],"\x24"=>[94,"\xA4t"],"\x25"=>[76,"\xA4t"],"\x26"=>[104,"\xA4t"],"\x27"=>[16,"\xA4t"],"\x28"=>[77,"\xA4\x20"],"\x29"=>[18,"\xA4\x20"],"\x2A"=>[77,"\xA4\x25"],"\x2B"=>[18,"\xA4\x25"],"\x2C"=>[77,"\xA4-"],"-"=>[18,"\xA4-"],"."=>[77,"\xA4."],"\x2F"=>[18,"\xA4."],[77,"\xA4\x2F"],[18,"\xA4\x2F"],[77,"\xA43"],[18,"\xA43"],[77,"\xA44"],[18,"\xA44"],[77,"\xA45"],[18,"\xA45"],[77,"\xA46"],[18,"\xA46"],"\x3A"=>[77,"\xA47"],"\x3B"=>[18,"\xA47"],"\x3C"=>[77,"\xA48"],"\x3D"=>[18,"\xA48"],"\x3E"=>[77,"\xA49"],"\x3F"=>[18,"\xA49"],"\x40"=>[77,"\xA4\x3D"],"A"=>[18,"\xA4\x3D"],"B"=>[77,"\xA4A"],"C"=>[18,"\xA4A"],"D"=>[77,"\xA4_"],"E"=>[18,"\xA4_"],"F"=>[77,"\xA4b"],"G"=>[18,"\xA4b"],"H"=>[77,"\xA4d"],"I"=>[18,"\xA4d"],"J"=>[77,"\xA4f"],"K"=>[18,"\xA4f"],"L"=>[77,"\xA4g"],"M"=>[18,"\xA4g"],"N"=>[77,"\xA4h"],"O"=>[18,"\xA4h"],"P"=>[77,"\xA4l"],"Q"=>[18,"\xA4l"],"R"=>[77,"\xA4m"],"S"=>[18,"\xA4m"],"T"=>[77,"\xA4n"],"U"=>[18,"\xA4n"],"V"=>[77,"\xA4p"],"W"=>[18,"\xA4p"],"X"=>[77,"\xA4r"],"Y"=>[18,"\xA4r"],"Z"=>[77,"\xA4u"],"\x5B"=>[18,"\xA4u"],"\x5C"=>[0,"\xA4\x3A"],"\x5D"=>[0,"\xA4B"],"\x5E"=>[0,"\xA4C"],"_"=>[0,"\xA4D"],"\x60"=>[0,"\xA4E"],"a"=>[0,"\xA4F"],"b"=>[0,"\xA4G"],"c"=>[0,"\xA4H"],"d"=>[0,"\xA4I"],"e"=>[0,"\xA4J"],"f"=>[0,"\xA4K"],"g"=>[0,"\xA4L"],"h"=>[0,"\xA4M"],"i"=>[0,"\xA4N"],"j"=>[0,"\xA4O"],"k"=>[0,"\xA4P"],"l"=>[0,"\xA4Q"],"m"=>[0,"\xA4R"],"n"=>[0,"\xA4S"],"o"=>[0,"\xA4T"],"p"=>[0,"\xA4U"],"q"=>[0,"\xA4V"],"r"=>[0,"\xA4W"],"s"=>[0,"\xA4Y"],"t"=>[0,"\xA4j"],"u"=>[0,"\xA4k"],"v"=>[0,"\xA4q"],"w"=>[0,"\xA4v"],"x"=>[0,"\xA4w"],"y"=>[0,"\xA4x"],"z"=>[0,"\xA4y"],"\x7B"=>[0,"\xA4z"],"\x7C"=>[82,"\xA4"],"\x7D"=>[87,"\xA4"],"~"=>[130,"\xA4"],"\x7F"=>[9,"\xA4"],"\x80"=>[94,"\xA90"],"\x81"=>[76,"\xA90"],"\x82"=>[104,"\xA90"],"\x83"=>[16,"\xA90"],"\x84"=>[94,"\xA91"],"\x85"=>[76,"\xA91"],"\x86"=>[104,"\xA91"],"\x87"=>[16,"\xA91"],"\x88"=>[94,"\xA92"],"\x89"=>[76,"\xA92"],"\x8A"=>[104,"\xA92"],"\x8B"=>[16,"\xA92"],"\x8C"=>[94,"\xA9a"],"\x8D"=>[76,"\xA9a"],"\x8E"=>[104,"\xA9a"],"\x8F"=>[16,"\xA9a"],"\x90"=>[94,"\xA9c"],"\x91"=>[76,"\xA9c"],"\x92"=>[104,"\xA9c"],"\x93"=>[16,"\xA9c"],"\x94"=>[94,"\xA9e"],"\x95"=>[76,"\xA9e"],"\x96"=>[104,"\xA9e"],"\x97"=>[16,"\xA9e"],"\x98"=>[94,"\xA9i"],"\x99"=>[76,"\xA9i"],"\x9A"=>[104,"\xA9i"],"\x9B"=>[16,"\xA9i"],"\x9C"=>[94,"\xA9o"],"\x9D"=>[76,"\xA9o"],"\x9E"=>[104,"\xA9o"],"\x9F"=>[16,"\xA9o"],"\xA0"=>[94,"\xA9s"],"\xA1"=>[76,"\xA9s"],"\xA2"=>[104,"\xA9s"],"\xA3"=>[16,"\xA9s"],"\xA4"=>[94,"\xA9t"],"\xA5"=>[76,"\xA9t"],"\xA6"=>[104,"\xA9t"],"\xA7"=>[16,"\xA9t"],"\xA8"=>[77,"\xA9\x20"],"\xA9"=>[18,"\xA9\x20"],"\xAA"=>[77,"\xA9\x25"],"\xAB"=>[18,"\xA9\x25"],"\xAC"=>[77,"\xA9-"],"\xAD"=>[18,"\xA9-"],"\xAE"=>[77,"\xA9."],"\xAF"=>[18,"\xA9."],"\xB0"=>[77,"\xA9\x2F"],"\xB1"=>[18,"\xA9\x2F"],"\xB2"=>[77,"\xA93"],"\xB3"=>[18,"\xA93"],"\xB4"=>[77,"\xA94"],"\xB5"=>[18,"\xA94"],"\xB6"=>[77,"\xA95"],"\xB7"=>[18,"\xA95"],"\xB8"=>[77,"\xA96"],"\xB9"=>[18,"\xA96"],"\xBA"=>[77,"\xA97"],"\xBB"=>[18,"\xA97"],"\xBC"=>[77,"\xA98"],"\xBD"=>[18,"\xA98"],"\xBE"=>[77,"\xA99"],"\xBF"=>[18,"\xA99"],"\xC0"=>[77,"\xA9\x3D"],"\xC1"=>[18,"\xA9\x3D"],"\xC2"=>[77,"\xA9A"],"\xC3"=>[18,"\xA9A"],"\xC4"=>[77,"\xA9_"],"\xC5"=>[18,"\xA9_"],"\xC6"=>[77,"\xA9b"],"\xC7"=>[18,"\xA9b"],"\xC8"=>[77,"\xA9d"],"\xC9"=>[18,"\xA9d"],"\xCA"=>[77,"\xA9f"],"\xCB"=>[18,"\xA9f"],"\xCC"=>[77,"\xA9g"],"\xCD"=>[18,"\xA9g"],"\xCE"=>[77,"\xA9h"],"\xCF"=>[18,"\xA9h"],"\xD0"=>[77,"\xA9l"],"\xD1"=>[18,"\xA9l"],"\xD2"=>[77,"\xA9m"],"\xD3"=>[18,"\xA9m"],"\xD4"=>[77,"\xA9n"],"\xD5"=>[18,"\xA9n"],"\xD6"=>[77,"\xA9p"],"\xD7"=>[18,"\xA9p"],"\xD8"=>[77,"\xA9r"],"\xD9"=>[18,"\xA9r"],"\xDA"=>[77,"\xA9u"],"\xDB"=>[18,"\xA9u"],"\xDC"=>[0,"\xA9\x3A"],"\xDD"=>[0,"\xA9B"],"\xDE"=>[0,"\xA9C"],"\xDF"=>[0,"\xA9D"],"\xE0"=>[0,"\xA9E"],"\xE1"=>[0,"\xA9F"],"\xE2"=>[0,"\xA9G"],"\xE3"=>[0,"\xA9H"],"\xE4"=>[0,"\xA9I"],"\xE5"=>[0,"\xA9J"],"\xE6"=>[0,"\xA9K"],"\xE7"=>[0,"\xA9L"],"\xE8"=>[0,"\xA9M"],"\xE9"=>[0,"\xA9N"],"\xEA"=>[0,"\xA9O"],"\xEB"=>[0,"\xA9P"],"\xEC"=>[0,"\xA9Q"],"\xED"=>[0,"\xA9R"],"\xEE"=>[0,"\xA9S"],"\xEF"=>[0,"\xA9T"],"\xF0"=>[0,"\xA9U"],"\xF1"=>[0,"\xA9V"],"\xF2"=>[0,"\xA9W"],"\xF3"=>[0,"\xA9Y"],"\xF4"=>[0,"\xA9j"],"\xF5"=>[0,"\xA9k"],"\xF6"=>[0,"\xA9q"],"\xF7"=>[0,"\xA9v"],"\xF8"=>[0,"\xA9w"],"\xF9"=>[0,"\xA9x"],"\xFA"=>[0,"\xA9y"],"\xFB"=>[0,"\xA9z"],"\xFC"=>[82,"\xA9"],"\xFD"=>[87,"\xA9"],"\xFE"=>[130,"\xA9"],"\xFF"=>[9,"\xA9"],],["\x00"=>[77,"\xA40"],"\x01"=>[18,"\xA40"],"\x02"=>[77,"\xA41"],"\x03"=>[18,"\xA41"],"\x04"=>[77,"\xA42"],"\x05"=>[18,"\xA42"],"\x06"=>[77,"\xA4a"],"\x07"=>[18,"\xA4a"],"\x08"=>[77,"\xA4c"],"\x09"=>[18,"\xA4c"],"\x0A"=>[77,"\xA4e"],"\x0B"=>[18,"\xA4e"],"\x0C"=>[77,"\xA4i"],"\x0D"=>[18,"\xA4i"],"\x0E"=>[77,"\xA4o"],"\x0F"=>[18,"\xA4o"],"\x10"=>[77,"\xA4s"],"\x11"=>[18,"\xA4s"],"\x12"=>[77,"\xA4t"],"\x13"=>[18,"\xA4t"],"\x14"=>[0,"\xA4\x20"],"\x15"=>[0,"\xA4\x25"],"\x16"=>[0,"\xA4-"],"\x17"=>[0,"\xA4."],"\x18"=>[0,"\xA4\x2F"],"\x19"=>[0,"\xA43"],"\x1A"=>[0,"\xA44"],"\x1B"=>[0,"\xA45"],"\x1C"=>[0,"\xA46"],"\x1D"=>[0,"\xA47"],"\x1E"=>[0,"\xA48"],"\x1F"=>[0,"\xA49"],"\x20"=>[0,"\xA4\x3D"],"\x21"=>[0,"\xA4A"],"\x22"=>[0,"\xA4_"],"\x23"=>[0,"\xA4b"],"\x24"=>[0,"\xA4d"],"\x25"=>[0,"\xA4f"],"\x26"=>[0,"\xA4g"],"\x27"=>[0,"\xA4h"],"\x28"=>[0,"\xA4l"],"\x29"=>[0,"\xA4m"],"\x2A"=>[0,"\xA4n"],"\x2B"=>[0,"\xA4p"],"\x2C"=>[0,"\xA4r"],"-"=>[0,"\xA4u"],"."=>[100,"\xA4"],"\x2F"=>[110,"\xA4"],[111,"\xA4"],[115,"\xA4"],[116,"\xA4"],[118,"\xA4"],[119,"\xA4"],[122,"\xA4"],[123,"\xA4"],[125,"\xA4"],[126,"\xA4"],[129,"\xA4"],"\x3A"=>[143,"\xA4"],"\x3B"=>[148,"\xA4"],"\x3C"=>[151,"\xA4"],"\x3D"=>[153,"\xA4"],"\x3E"=>[83,"\xA4"],"\x3F"=>[10,"\xA4"],"\x40"=>[77,"\xA90"],"A"=>[18,"\xA90"],"B"=>[77,"\xA91"],"C"=>[18,"\xA91"],"D"=>[77,"\xA92"],"E"=>[18,"\xA92"],"F"=>[77,"\xA9a"],"G"=>[18,"\xA9a"],"H"=>[77,"\xA9c"],"I"=>[18,"\xA9c"],"J"=>[77,"\xA9e"],"K"=>[18,"\xA9e"],"L"=>[77,"\xA9i"],"M"=>[18,"\xA9i"],"N"=>[77,"\xA9o"],"O"=>[18,"\xA9o"],"P"=>[77,"\xA9s"],"Q"=>[18,"\xA9s"],"R"=>[77,"\xA9t"],"S"=>[18,"\xA9t"],"T"=>[0,"\xA9\x20"],"U"=>[0,"\xA9\x25"],"V"=>[0,"\xA9-"],"W"=>[0,"\xA9."],"X"=>[0,"\xA9\x2F"],"Y"=>[0,"\xA93"],"Z"=>[0,"\xA94"],"\x5B"=>[0,"\xA95"],"\x5C"=>[0,"\xA96"],"\x5D"=>[0,"\xA97"],"\x5E"=>[0,"\xA98"],"_"=>[0,"\xA99"],"\x60"=>[0,"\xA9\x3D"],"a"=>[0,"\xA9A"],"b"=>[0,"\xA9_"],"c"=>[0,"\xA9b"],"d"=>[0,"\xA9d"],"e"=>[0,"\xA9f"],"f"=>[0,"\xA9g"],"g"=>[0,"\xA9h"],"h"=>[0,"\xA9l"],"i"=>[0,"\xA9m"],"j"=>[0,"\xA9n"],"k"=>[0,"\xA9p"],"l"=>[0,"\xA9r"],"m"=>[0,"\xA9u"],"n"=>[100,"\xA9"],"o"=>[110,"\xA9"],"p"=>[111,"\xA9"],"q"=>[115,"\xA9"],"r"=>[116,"\xA9"],"s"=>[118,"\xA9"],"t"=>[119,"\xA9"],"u"=>[122,"\xA9"],"v"=>[123,"\xA9"],"w"=>[125,"\xA9"],"x"=>[126,"\xA9"],"y"=>[129,"\xA9"],"z"=>[143,"\xA9"],"\x7B"=>[148,"\xA9"],"\x7C"=>[151,"\xA9"],"\x7D"=>[153,"\xA9"],"~"=>[83,"\xA9"],"\x7F"=>[10,"\xA9"],"\x80"=>[77,"\xAA0"],"\x81"=>[18,"\xAA0"],"\x82"=>[77,"\xAA1"],"\x83"=>[18,"\xAA1"],"\x84"=>[77,"\xAA2"],"\x85"=>[18,"\xAA2"],"\x86"=>[77,"\xAAa"],"\x87"=>[18,"\xAAa"],"\x88"=>[77,"\xAAc"],"\x89"=>[18,"\xAAc"],"\x8A"=>[77,"\xAAe"],"\x8B"=>[18,"\xAAe"],"\x8C"=>[77,"\xAAi"],"\x8D"=>[18,"\xAAi"],"\x8E"=>[77,"\xAAo"],"\x8F"=>[18,"\xAAo"],"\x90"=>[77,"\xAAs"],"\x91"=>[18,"\xAAs"],"\x92"=>[77,"\xAAt"],"\x93"=>[18,"\xAAt"],"\x94"=>[0,"\xAA\x20"],"\x95"=>[0,"\xAA\x25"],"\x96"=>[0,"\xAA-"],"\x97"=>[0,"\xAA."],"\x98"=>[0,"\xAA\x2F"],"\x99"=>[0,"\xAA3"],"\x9A"=>[0,"\xAA4"],"\x9B"=>[0,"\xAA5"],"\x9C"=>[0,"\xAA6"],"\x9D"=>[0,"\xAA7"],"\x9E"=>[0,"\xAA8"],"\x9F"=>[0,"\xAA9"],"\xA0"=>[0,"\xAA\x3D"],"\xA1"=>[0,"\xAAA"],"\xA2"=>[0,"\xAA_"],"\xA3"=>[0,"\xAAb"],"\xA4"=>[0,"\xAAd"],"\xA5"=>[0,"\xAAf"],"\xA6"=>[0,"\xAAg"],"\xA7"=>[0,"\xAAh"],"\xA8"=>[0,"\xAAl"],"\xA9"=>[0,"\xAAm"],"\xAA"=>[0,"\xAAn"],"\xAB"=>[0,"\xAAp"],"\xAC"=>[0,"\xAAr"],"\xAD"=>[0,"\xAAu"],"\xAE"=>[100,"\xAA"],"\xAF"=>[110,"\xAA"],"\xB0"=>[111,"\xAA"],"\xB1"=>[115,"\xAA"],"\xB2"=>[116,"\xAA"],"\xB3"=>[118,"\xAA"],"\xB4"=>[119,"\xAA"],"\xB5"=>[122,"\xAA"],"\xB6"=>[123,"\xAA"],"\xB7"=>[125,"\xAA"],"\xB8"=>[126,"\xAA"],"\xB9"=>[129,"\xAA"],"\xBA"=>[143,"\xAA"],"\xBB"=>[148,"\xAA"],"\xBC"=>[151,"\xAA"],"\xBD"=>[153,"\xAA"],"\xBE"=>[83,"\xAA"],"\xBF"=>[10,"\xAA"],"\xC0"=>[77,"\xAD0"],"\xC1"=>[18,"\xAD0"],"\xC2"=>[77,"\xAD1"],"\xC3"=>[18,"\xAD1"],"\xC4"=>[77,"\xAD2"],"\xC5"=>[18,"\xAD2"],"\xC6"=>[77,"\xADa"],"\xC7"=>[18,"\xADa"],"\xC8"=>[77,"\xADc"],"\xC9"=>[18,"\xADc"],"\xCA"=>[77,"\xADe"],"\xCB"=>[18,"\xADe"],"\xCC"=>[77,"\xADi"],"\xCD"=>[18,"\xADi"],"\xCE"=>[77,"\xADo"],"\xCF"=>[18,"\xADo"],"\xD0"=>[77,"\xADs"],"\xD1"=>[18,"\xADs"],"\xD2"=>[77,"\xADt"],"\xD3"=>[18,"\xADt"],"\xD4"=>[0,"\xAD\x20"],"\xD5"=>[0,"\xAD\x25"],"\xD6"=>[0,"\xAD-"],"\xD7"=>[0,"\xAD."],"\xD8"=>[0,"\xAD\x2F"],"\xD9"=>[0,"\xAD3"],"\xDA"=>[0,"\xAD4"],"\xDB"=>[0,"\xAD5"],"\xDC"=>[0,"\xAD6"],"\xDD"=>[0,"\xAD7"],"\xDE"=>[0,"\xAD8"],"\xDF"=>[0,"\xAD9"],"\xE0"=>[0,"\xAD\x3D"],"\xE1"=>[0,"\xADA"],"\xE2"=>[0,"\xAD_"],"\xE3"=>[0,"\xADb"],"\xE4"=>[0,"\xADd"],"\xE5"=>[0,"\xADf"],"\xE6"=>[0,"\xADg"],"\xE7"=>[0,"\xADh"],"\xE8"=>[0,"\xADl"],"\xE9"=>[0,"\xADm"],"\xEA"=>[0,"\xADn"],"\xEB"=>[0,"\xADp"],"\xEC"=>[0,"\xADr"],"\xED"=>[0,"\xADu"],"\xEE"=>[100,"\xAD"],"\xEF"=>[110,"\xAD"],"\xF0"=>[111,"\xAD"],"\xF1"=>[115,"\xAD"],"\xF2"=>[116,"\xAD"],"\xF3"=>[118,"\xAD"],"\xF4"=>[119,"\xAD"],"\xF5"=>[122,"\xAD"],"\xF6"=>[123,"\xAD"],"\xF7"=>[125,"\xAD"],"\xF8"=>[126,"\xAD"],"\xF9"=>[129,"\xAD"],"\xFA"=>[143,"\xAD"],"\xFB"=>[148,"\xAD"],"\xFC"=>[151,"\xAD"],"\xFD"=>[153,"\xAD"],"\xFE"=>[83,"\xAD"],"\xFF"=>[10,"\xAD"],],["\x00"=>[94,"\xA50"],"\x01"=>[76,"\xA50"],"\x02"=>[104,"\xA50"],"\x03"=>[16,"\xA50"],"\x04"=>[94,"\xA51"],"\x05"=>[76,"\xA51"],"\x06"=>[104,"\xA51"],"\x07"=>[16,"\xA51"],"\x08"=>[94,"\xA52"],"\x09"=>[76,"\xA52"],"\x0A"=>[104,"\xA52"],"\x0B"=>[16,"\xA52"],"\x0C"=>[94,"\xA5a"],"\x0D"=>[76,"\xA5a"],"\x0E"=>[104,"\xA5a"],"\x0F"=>[16,"\xA5a"],"\x10"=>[94,"\xA5c"],"\x11"=>[76,"\xA5c"],"\x12"=>[104,"\xA5c"],"\x13"=>[16,"\xA5c"],"\x14"=>[94,"\xA5e"],"\x15"=>[76,"\xA5e"],"\x16"=>[104,"\xA5e"],"\x17"=>[16,"\xA5e"],"\x18"=>[94,"\xA5i"],"\x19"=>[76,"\xA5i"],"\x1A"=>[104,"\xA5i"],"\x1B"=>[16,"\xA5i"],"\x1C"=>[94,"\xA5o"],"\x1D"=>[76,"\xA5o"],"\x1E"=>[104,"\xA5o"],"\x1F"=>[16,"\xA5o"],"\x20"=>[94,"\xA5s"],"\x21"=>[76,"\xA5s"],"\x22"=>[104,"\xA5s"],"\x23"=>[16,"\xA5s"],"\x24"=>[94,"\xA5t"],"\x25"=>[76,"\xA5t"],"\x26"=>[104,"\xA5t"],"\x27"=>[16,"\xA5t"],"\x28"=>[77,"\xA5\x20"],"\x29"=>[18,"\xA5\x20"],"\x2A"=>[77,"\xA5\x25"],"\x2B"=>[18,"\xA5\x25"],"\x2C"=>[77,"\xA5-"],"-"=>[18,"\xA5-"],"."=>[77,"\xA5."],"\x2F"=>[18,"\xA5."],[77,"\xA5\x2F"],[18,"\xA5\x2F"],[77,"\xA53"],[18,"\xA53"],[77,"\xA54"],[18,"\xA54"],[77,"\xA55"],[18,"\xA55"],[77,"\xA56"],[18,"\xA56"],"\x3A"=>[77,"\xA57"],"\x3B"=>[18,"\xA57"],"\x3C"=>[77,"\xA58"],"\x3D"=>[18,"\xA58"],"\x3E"=>[77,"\xA59"],"\x3F"=>[18,"\xA59"],"\x40"=>[77,"\xA5\x3D"],"A"=>[18,"\xA5\x3D"],"B"=>[77,"\xA5A"],"C"=>[18,"\xA5A"],"D"=>[77,"\xA5_"],"E"=>[18,"\xA5_"],"F"=>[77,"\xA5b"],"G"=>[18,"\xA5b"],"H"=>[77,"\xA5d"],"I"=>[18,"\xA5d"],"J"=>[77,"\xA5f"],"K"=>[18,"\xA5f"],"L"=>[77,"\xA5g"],"M"=>[18,"\xA5g"],"N"=>[77,"\xA5h"],"O"=>[18,"\xA5h"],"P"=>[77,"\xA5l"],"Q"=>[18,"\xA5l"],"R"=>[77,"\xA5m"],"S"=>[18,"\xA5m"],"T"=>[77,"\xA5n"],"U"=>[18,"\xA5n"],"V"=>[77,"\xA5p"],"W"=>[18,"\xA5p"],"X"=>[77,"\xA5r"],"Y"=>[18,"\xA5r"],"Z"=>[77,"\xA5u"],"\x5B"=>[18,"\xA5u"],"\x5C"=>[0,"\xA5\x3A"],"\x5D"=>[0,"\xA5B"],"\x5E"=>[0,"\xA5C"],"_"=>[0,"\xA5D"],"\x60"=>[0,"\xA5E"],"a"=>[0,"\xA5F"],"b"=>[0,"\xA5G"],"c"=>[0,"\xA5H"],"d"=>[0,"\xA5I"],"e"=>[0,"\xA5J"],"f"=>[0,"\xA5K"],"g"=>[0,"\xA5L"],"h"=>[0,"\xA5M"],"i"=>[0,"\xA5N"],"j"=>[0,"\xA5O"],"k"=>[0,"\xA5P"],"l"=>[0,"\xA5Q"],"m"=>[0,"\xA5R"],"n"=>[0,"\xA5S"],"o"=>[0,"\xA5T"],"p"=>[0,"\xA5U"],"q"=>[0,"\xA5V"],"r"=>[0,"\xA5W"],"s"=>[0,"\xA5Y"],"t"=>[0,"\xA5j"],"u"=>[0,"\xA5k"],"v"=>[0,"\xA5q"],"w"=>[0,"\xA5v"],"x"=>[0,"\xA5w"],"y"=>[0,"\xA5x"],"z"=>[0,"\xA5y"],"\x7B"=>[0,"\xA5z"],"\x7C"=>[82,"\xA5"],"\x7D"=>[87,"\xA5"],"~"=>[130,"\xA5"],"\x7F"=>[9,"\xA5"],"\x80"=>[94,"\xA60"],"\x81"=>[76,"\xA60"],"\x82"=>[104,"\xA60"],"\x83"=>[16,"\xA60"],"\x84"=>[94,"\xA61"],"\x85"=>[76,"\xA61"],"\x86"=>[104,"\xA61"],"\x87"=>[16,"\xA61"],"\x88"=>[94,"\xA62"],"\x89"=>[76,"\xA62"],"\x8A"=>[104,"\xA62"],"\x8B"=>[16,"\xA62"],"\x8C"=>[94,"\xA6a"],"\x8D"=>[76,"\xA6a"],"\x8E"=>[104,"\xA6a"],"\x8F"=>[16,"\xA6a"],"\x90"=>[94,"\xA6c"],"\x91"=>[76,"\xA6c"],"\x92"=>[104,"\xA6c"],"\x93"=>[16,"\xA6c"],"\x94"=>[94,"\xA6e"],"\x95"=>[76,"\xA6e"],"\x96"=>[104,"\xA6e"],"\x97"=>[16,"\xA6e"],"\x98"=>[94,"\xA6i"],"\x99"=>[76,"\xA6i"],"\x9A"=>[104,"\xA6i"],"\x9B"=>[16,"\xA6i"],"\x9C"=>[94,"\xA6o"],"\x9D"=>[76,"\xA6o"],"\x9E"=>[104,"\xA6o"],"\x9F"=>[16,"\xA6o"],"\xA0"=>[94,"\xA6s"],"\xA1"=>[76,"\xA6s"],"\xA2"=>[104,"\xA6s"],"\xA3"=>[16,"\xA6s"],"\xA4"=>[94,"\xA6t"],"\xA5"=>[76,"\xA6t"],"\xA6"=>[104,"\xA6t"],"\xA7"=>[16,"\xA6t"],"\xA8"=>[77,"\xA6\x20"],"\xA9"=>[18,"\xA6\x20"],"\xAA"=>[77,"\xA6\x25"],"\xAB"=>[18,"\xA6\x25"],"\xAC"=>[77,"\xA6-"],"\xAD"=>[18,"\xA6-"],"\xAE"=>[77,"\xA6."],"\xAF"=>[18,"\xA6."],"\xB0"=>[77,"\xA6\x2F"],"\xB1"=>[18,"\xA6\x2F"],"\xB2"=>[77,"\xA63"],"\xB3"=>[18,"\xA63"],"\xB4"=>[77,"\xA64"],"\xB5"=>[18,"\xA64"],"\xB6"=>[77,"\xA65"],"\xB7"=>[18,"\xA65"],"\xB8"=>[77,"\xA66"],"\xB9"=>[18,"\xA66"],"\xBA"=>[77,"\xA67"],"\xBB"=>[18,"\xA67"],"\xBC"=>[77,"\xA68"],"\xBD"=>[18,"\xA68"],"\xBE"=>[77,"\xA69"],"\xBF"=>[18,"\xA69"],"\xC0"=>[77,"\xA6\x3D"],"\xC1"=>[18,"\xA6\x3D"],"\xC2"=>[77,"\xA6A"],"\xC3"=>[18,"\xA6A"],"\xC4"=>[77,"\xA6_"],"\xC5"=>[18,"\xA6_"],"\xC6"=>[77,"\xA6b"],"\xC7"=>[18,"\xA6b"],"\xC8"=>[77,"\xA6d"],"\xC9"=>[18,"\xA6d"],"\xCA"=>[77,"\xA6f"],"\xCB"=>[18,"\xA6f"],"\xCC"=>[77,"\xA6g"],"\xCD"=>[18,"\xA6g"],"\xCE"=>[77,"\xA6h"],"\xCF"=>[18,"\xA6h"],"\xD0"=>[77,"\xA6l"],"\xD1"=>[18,"\xA6l"],"\xD2"=>[77,"\xA6m"],"\xD3"=>[18,"\xA6m"],"\xD4"=>[77,"\xA6n"],"\xD5"=>[18,"\xA6n"],"\xD6"=>[77,"\xA6p"],"\xD7"=>[18,"\xA6p"],"\xD8"=>[77,"\xA6r"],"\xD9"=>[18,"\xA6r"],"\xDA"=>[77,"\xA6u"],"\xDB"=>[18,"\xA6u"],"\xDC"=>[0,"\xA6\x3A"],"\xDD"=>[0,"\xA6B"],"\xDE"=>[0,"\xA6C"],"\xDF"=>[0,"\xA6D"],"\xE0"=>[0,"\xA6E"],"\xE1"=>[0,"\xA6F"],"\xE2"=>[0,"\xA6G"],"\xE3"=>[0,"\xA6H"],"\xE4"=>[0,"\xA6I"],"\xE5"=>[0,"\xA6J"],"\xE6"=>[0,"\xA6K"],"\xE7"=>[0,"\xA6L"],"\xE8"=>[0,"\xA6M"],"\xE9"=>[0,"\xA6N"],"\xEA"=>[0,"\xA6O"],"\xEB"=>[0,"\xA6P"],"\xEC"=>[0,"\xA6Q"],"\xED"=>[0,"\xA6R"],"\xEE"=>[0,"\xA6S"],"\xEF"=>[0,"\xA6T"],"\xF0"=>[0,"\xA6U"],"\xF1"=>[0,"\xA6V"],"\xF2"=>[0,"\xA6W"],"\xF3"=>[0,"\xA6Y"],"\xF4"=>[0,"\xA6j"],"\xF5"=>[0,"\xA6k"],"\xF6"=>[0,"\xA6q"],"\xF7"=>[0,"\xA6v"],"\xF8"=>[0,"\xA6w"],"\xF9"=>[0,"\xA6x"],"\xFA"=>[0,"\xA6y"],"\xFB"=>[0,"\xA6z"],"\xFC"=>[82,"\xA6"],"\xFD"=>[87,"\xA6"],"\xFE"=>[130,"\xA6"],"\xFF"=>[9,"\xA6"],],["\x00"=>[77,"\xA50"],"\x01"=>[18,"\xA50"],"\x02"=>[77,"\xA51"],"\x03"=>[18,"\xA51"],"\x04"=>[77,"\xA52"],"\x05"=>[18,"\xA52"],"\x06"=>[77,"\xA5a"],"\x07"=>[18,"\xA5a"],"\x08"=>[77,"\xA5c"],"\x09"=>[18,"\xA5c"],"\x0A"=>[77,"\xA5e"],"\x0B"=>[18,"\xA5e"],"\x0C"=>[77,"\xA5i"],"\x0D"=>[18,"\xA5i"],"\x0E"=>[77,"\xA5o"],"\x0F"=>[18,"\xA5o"],"\x10"=>[77,"\xA5s"],"\x11"=>[18,"\xA5s"],"\x12"=>[77,"\xA5t"],"\x13"=>[18,"\xA5t"],"\x14"=>[0,"\xA5\x20"],"\x15"=>[0,"\xA5\x25"],"\x16"=>[0,"\xA5-"],"\x17"=>[0,"\xA5."],"\x18"=>[0,"\xA5\x2F"],"\x19"=>[0,"\xA53"],"\x1A"=>[0,"\xA54"],"\x1B"=>[0,"\xA55"],"\x1C"=>[0,"\xA56"],"\x1D"=>[0,"\xA57"],"\x1E"=>[0,"\xA58"],"\x1F"=>[0,"\xA59"],"\x20"=>[0,"\xA5\x3D"],"\x21"=>[0,"\xA5A"],"\x22"=>[0,"\xA5_"],"\x23"=>[0,"\xA5b"],"\x24"=>[0,"\xA5d"],"\x25"=>[0,"\xA5f"],"\x26"=>[0,"\xA5g"],"\x27"=>[0,"\xA5h"],"\x28"=>[0,"\xA5l"],"\x29"=>[0,"\xA5m"],"\x2A"=>[0,"\xA5n"],"\x2B"=>[0,"\xA5p"],"\x2C"=>[0,"\xA5r"],"-"=>[0,"\xA5u"],"."=>[100,"\xA5"],"\x2F"=>[110,"\xA5"],[111,"\xA5"],[115,"\xA5"],[116,"\xA5"],[118,"\xA5"],[119,"\xA5"],[122,"\xA5"],[123,"\xA5"],[125,"\xA5"],[126,"\xA5"],[129,"\xA5"],"\x3A"=>[143,"\xA5"],"\x3B"=>[148,"\xA5"],"\x3C"=>[151,"\xA5"],"\x3D"=>[153,"\xA5"],"\x3E"=>[83,"\xA5"],"\x3F"=>[10,"\xA5"],"\x40"=>[77,"\xA60"],"A"=>[18,"\xA60"],"B"=>[77,"\xA61"],"C"=>[18,"\xA61"],"D"=>[77,"\xA62"],"E"=>[18,"\xA62"],"F"=>[77,"\xA6a"],"G"=>[18,"\xA6a"],"H"=>[77,"\xA6c"],"I"=>[18,"\xA6c"],"J"=>[77,"\xA6e"],"K"=>[18,"\xA6e"],"L"=>[77,"\xA6i"],"M"=>[18,"\xA6i"],"N"=>[77,"\xA6o"],"O"=>[18,"\xA6o"],"P"=>[77,"\xA6s"],"Q"=>[18,"\xA6s"],"R"=>[77,"\xA6t"],"S"=>[18,"\xA6t"],"T"=>[0,"\xA6\x20"],"U"=>[0,"\xA6\x25"],"V"=>[0,"\xA6-"],"W"=>[0,"\xA6."],"X"=>[0,"\xA6\x2F"],"Y"=>[0,"\xA63"],"Z"=>[0,"\xA64"],"\x5B"=>[0,"\xA65"],"\x5C"=>[0,"\xA66"],"\x5D"=>[0,"\xA67"],"\x5E"=>[0,"\xA68"],"_"=>[0,"\xA69"],"\x60"=>[0,"\xA6\x3D"],"a"=>[0,"\xA6A"],"b"=>[0,"\xA6_"],"c"=>[0,"\xA6b"],"d"=>[0,"\xA6d"],"e"=>[0,"\xA6f"],"f"=>[0,"\xA6g"],"g"=>[0,"\xA6h"],"h"=>[0,"\xA6l"],"i"=>[0,"\xA6m"],"j"=>[0,"\xA6n"],"k"=>[0,"\xA6p"],"l"=>[0,"\xA6r"],"m"=>[0,"\xA6u"],"n"=>[100,"\xA6"],"o"=>[110,"\xA6"],"p"=>[111,"\xA6"],"q"=>[115,"\xA6"],"r"=>[116,"\xA6"],"s"=>[118,"\xA6"],"t"=>[119,"\xA6"],"u"=>[122,"\xA6"],"v"=>[123,"\xA6"],"w"=>[125,"\xA6"],"x"=>[126,"\xA6"],"y"=>[129,"\xA6"],"z"=>[143,"\xA6"],"\x7B"=>[148,"\xA6"],"\x7C"=>[151,"\xA6"],"\x7D"=>[153,"\xA6"],"~"=>[83,"\xA6"],"\x7F"=>[10,"\xA6"],"\x80"=>[77,"\xA80"],"\x81"=>[18,"\xA80"],"\x82"=>[77,"\xA81"],"\x83"=>[18,"\xA81"],"\x84"=>[77,"\xA82"],"\x85"=>[18,"\xA82"],"\x86"=>[77,"\xA8a"],"\x87"=>[18,"\xA8a"],"\x88"=>[77,"\xA8c"],"\x89"=>[18,"\xA8c"],"\x8A"=>[77,"\xA8e"],"\x8B"=>[18,"\xA8e"],"\x8C"=>[77,"\xA8i"],"\x8D"=>[18,"\xA8i"],"\x8E"=>[77,"\xA8o"],"\x8F"=>[18,"\xA8o"],"\x90"=>[77,"\xA8s"],"\x91"=>[18,"\xA8s"],"\x92"=>[77,"\xA8t"],"\x93"=>[18,"\xA8t"],"\x94"=>[0,"\xA8\x20"],"\x95"=>[0,"\xA8\x25"],"\x96"=>[0,"\xA8-"],"\x97"=>[0,"\xA8."],"\x98"=>[0,"\xA8\x2F"],"\x99"=>[0,"\xA83"],"\x9A"=>[0,"\xA84"],"\x9B"=>[0,"\xA85"],"\x9C"=>[0,"\xA86"],"\x9D"=>[0,"\xA87"],"\x9E"=>[0,"\xA88"],"\x9F"=>[0,"\xA89"],"\xA0"=>[0,"\xA8\x3D"],"\xA1"=>[0,"\xA8A"],"\xA2"=>[0,"\xA8_"],"\xA3"=>[0,"\xA8b"],"\xA4"=>[0,"\xA8d"],"\xA5"=>[0,"\xA8f"],"\xA6"=>[0,"\xA8g"],"\xA7"=>[0,"\xA8h"],"\xA8"=>[0,"\xA8l"],"\xA9"=>[0,"\xA8m"],"\xAA"=>[0,"\xA8n"],"\xAB"=>[0,"\xA8p"],"\xAC"=>[0,"\xA8r"],"\xAD"=>[0,"\xA8u"],"\xAE"=>[100,"\xA8"],"\xAF"=>[110,"\xA8"],"\xB0"=>[111,"\xA8"],"\xB1"=>[115,"\xA8"],"\xB2"=>[116,"\xA8"],"\xB3"=>[118,"\xA8"],"\xB4"=>[119,"\xA8"],"\xB5"=>[122,"\xA8"],"\xB6"=>[123,"\xA8"],"\xB7"=>[125,"\xA8"],"\xB8"=>[126,"\xA8"],"\xB9"=>[129,"\xA8"],"\xBA"=>[143,"\xA8"],"\xBB"=>[148,"\xA8"],"\xBC"=>[151,"\xA8"],"\xBD"=>[153,"\xA8"],"\xBE"=>[83,"\xA8"],"\xBF"=>[10,"\xA8"],"\xC0"=>[77,"\xAE0"],"\xC1"=>[18,"\xAE0"],"\xC2"=>[77,"\xAE1"],"\xC3"=>[18,"\xAE1"],"\xC4"=>[77,"\xAE2"],"\xC5"=>[18,"\xAE2"],"\xC6"=>[77,"\xAEa"],"\xC7"=>[18,"\xAEa"],"\xC8"=>[77,"\xAEc"],"\xC9"=>[18,"\xAEc"],"\xCA"=>[77,"\xAEe"],"\xCB"=>[18,"\xAEe"],"\xCC"=>[77,"\xAEi"],"\xCD"=>[18,"\xAEi"],"\xCE"=>[77,"\xAEo"],"\xCF"=>[18,"\xAEo"],"\xD0"=>[77,"\xAEs"],"\xD1"=>[18,"\xAEs"],"\xD2"=>[77,"\xAEt"],"\xD3"=>[18,"\xAEt"],"\xD4"=>[0,"\xAE\x20"],"\xD5"=>[0,"\xAE\x25"],"\xD6"=>[0,"\xAE-"],"\xD7"=>[0,"\xAE."],"\xD8"=>[0,"\xAE\x2F"],"\xD9"=>[0,"\xAE3"],"\xDA"=>[0,"\xAE4"],"\xDB"=>[0,"\xAE5"],"\xDC"=>[0,"\xAE6"],"\xDD"=>[0,"\xAE7"],"\xDE"=>[0,"\xAE8"],"\xDF"=>[0,"\xAE9"],"\xE0"=>[0,"\xAE\x3D"],"\xE1"=>[0,"\xAEA"],"\xE2"=>[0,"\xAE_"],"\xE3"=>[0,"\xAEb"],"\xE4"=>[0,"\xAEd"],"\xE5"=>[0,"\xAEf"],"\xE6"=>[0,"\xAEg"],"\xE7"=>[0,"\xAEh"],"\xE8"=>[0,"\xAEl"],"\xE9"=>[0,"\xAEm"],"\xEA"=>[0,"\xAEn"],"\xEB"=>[0,"\xAEp"],"\xEC"=>[0,"\xAEr"],"\xED"=>[0,"\xAEu"],"\xEE"=>[100,"\xAE"],"\xEF"=>[110,"\xAE"],"\xF0"=>[111,"\xAE"],"\xF1"=>[115,"\xAE"],"\xF2"=>[116,"\xAE"],"\xF3"=>[118,"\xAE"],"\xF4"=>[119,"\xAE"],"\xF5"=>[122,"\xAE"],"\xF6"=>[123,"\xAE"],"\xF7"=>[125,"\xAE"],"\xF8"=>[126,"\xAE"],"\xF9"=>[129,"\xAE"],"\xFA"=>[143,"\xAE"],"\xFB"=>[148,"\xAE"],"\xFC"=>[151,"\xAE"],"\xFD"=>[153,"\xAE"],"\xFE"=>[83,"\xAE"],"\xFF"=>[10,"\xAE"],],["\x00"=>[0,"\xA50"],"\x01"=>[0,"\xA51"],"\x02"=>[0,"\xA52"],"\x03"=>[0,"\xA5a"],"\x04"=>[0,"\xA5c"],"\x05"=>[0,"\xA5e"],"\x06"=>[0,"\xA5i"],"\x07"=>[0,"\xA5o"],"\x08"=>[0,"\xA5s"],"\x09"=>[0,"\xA5t"],"\x0A"=>[73,"\xA5"],"\x0B"=>[88,"\xA5"],"\x0C"=>[89,"\xA5"],"\x0D"=>[96,"\xA5"],"\x0E"=>[97,"\xA5"],"\x0F"=>[99,"\xA5"],"\x10"=>[106,"\xA5"],"\x11"=>[136,"\xA5"],"\x12"=>[139,"\xA5"],"\x13"=>[141,"\xA5"],"\x14"=>[145,"\xA5"],"\x15"=>[147,"\xA5"],"\x16"=>[149,"\xA5"],"\x17"=>[101,"\xA5"],"\x18"=>[112,"\xA5"],"\x19"=>[117,"\xA5"],"\x1A"=>[120,"\xA5"],"\x1B"=>[124,"\xA5"],"\x1C"=>[127,"\xA5"],"\x1D"=>[144,"\xA5"],"\x1E"=>[152,"\xA5"],"\x1F"=>[11,"\xA5"],"\x20"=>[0,"\xA60"],"\x21"=>[0,"\xA61"],"\x22"=>[0,"\xA62"],"\x23"=>[0,"\xA6a"],"\x24"=>[0,"\xA6c"],"\x25"=>[0,"\xA6e"],"\x26"=>[0,"\xA6i"],"\x27"=>[0,"\xA6o"],"\x28"=>[0,"\xA6s"],"\x29"=>[0,"\xA6t"],"\x2A"=>[73,"\xA6"],"\x2B"=>[88,"\xA6"],"\x2C"=>[89,"\xA6"],"-"=>[96,"\xA6"],"."=>[97,"\xA6"],"\x2F"=>[99,"\xA6"],[106,"\xA6"],[136,"\xA6"],[139,"\xA6"],[141,"\xA6"],[145,"\xA6"],[147,"\xA6"],[149,"\xA6"],[101,"\xA6"],[112,"\xA6"],[117,"\xA6"],"\x3A"=>[120,"\xA6"],"\x3B"=>[124,"\xA6"],"\x3C"=>[127,"\xA6"],"\x3D"=>[144,"\xA6"],"\x3E"=>[152,"\xA6"],"\x3F"=>[11,"\xA6"],"\x40"=>[0,"\xA80"],"A"=>[0,"\xA81"],"B"=>[0,"\xA82"],"C"=>[0,"\xA8a"],"D"=>[0,"\xA8c"],"E"=>[0,"\xA8e"],"F"=>[0,"\xA8i"],"G"=>[0,"\xA8o"],"H"=>[0,"\xA8s"],"I"=>[0,"\xA8t"],"J"=>[73,"\xA8"],"K"=>[88,"\xA8"],"L"=>[89,"\xA8"],"M"=>[96,"\xA8"],"N"=>[97,"\xA8"],"O"=>[99,"\xA8"],"P"=>[106,"\xA8"],"Q"=>[136,"\xA8"],"R"=>[139,"\xA8"],"S"=>[141,"\xA8"],"T"=>[145,"\xA8"],"U"=>[147,"\xA8"],"V"=>[149,"\xA8"],"W"=>[101,"\xA8"],"X"=>[112,"\xA8"],"Y"=>[117,"\xA8"],"Z"=>[120,"\xA8"],"\x5B"=>[124,"\xA8"],"\x5C"=>[127,"\xA8"],"\x5D"=>[144,"\xA8"],"\x5E"=>[152,"\xA8"],"_"=>[11,"\xA8"],"\x60"=>[0,"\xAE0"],"a"=>[0,"\xAE1"],"b"=>[0,"\xAE2"],"c"=>[0,"\xAEa"],"d"=>[0,"\xAEc"],"e"=>[0,"\xAEe"],"f"=>[0,"\xAEi"],"g"=>[0,"\xAEo"],"h"=>[0,"\xAEs"],"i"=>[0,"\xAEt"],"j"=>[73,"\xAE"],"k"=>[88,"\xAE"],"l"=>[89,"\xAE"],"m"=>[96,"\xAE"],"n"=>[97,"\xAE"],"o"=>[99,"\xAE"],"p"=>[106,"\xAE"],"q"=>[136,"\xAE"],"r"=>[139,"\xAE"],"s"=>[141,"\xAE"],"t"=>[145,"\xAE"],"u"=>[147,"\xAE"],"v"=>[149,"\xAE"],"w"=>[101,"\xAE"],"x"=>[112,"\xAE"],"y"=>[117,"\xAE"],"z"=>[120,"\xAE"],"\x7B"=>[124,"\xAE"],"\x7C"=>[127,"\xAE"],"\x7D"=>[144,"\xAE"],"~"=>[152,"\xAE"],"\x7F"=>[11,"\xAE"],"\x80"=>[0,"\xAF0"],"\x81"=>[0,"\xAF1"],"\x82"=>[0,"\xAF2"],"\x83"=>[0,"\xAFa"],"\x84"=>[0,"\xAFc"],"\x85"=>[0,"\xAFe"],"\x86"=>[0,"\xAFi"],"\x87"=>[0,"\xAFo"],"\x88"=>[0,"\xAFs"],"\x89"=>[0,"\xAFt"],"\x8A"=>[73,"\xAF"],"\x8B"=>[88,"\xAF"],"\x8C"=>[89,"\xAF"],"\x8D"=>[96,"\xAF"],"\x8E"=>[97,"\xAF"],"\x8F"=>[99,"\xAF"],"\x90"=>[106,"\xAF"],"\x91"=>[136,"\xAF"],"\x92"=>[139,"\xAF"],"\x93"=>[141,"\xAF"],"\x94"=>[145,"\xAF"],"\x95"=>[147,"\xAF"],"\x96"=>[149,"\xAF"],"\x97"=>[101,"\xAF"],"\x98"=>[112,"\xAF"],"\x99"=>[117,"\xAF"],"\x9A"=>[120,"\xAF"],"\x9B"=>[124,"\xAF"],"\x9C"=>[127,"\xAF"],"\x9D"=>[144,"\xAF"],"\x9E"=>[152,"\xAF"],"\x9F"=>[11,"\xAF"],"\xA0"=>[0,"\xB40"],"\xA1"=>[0,"\xB41"],"\xA2"=>[0,"\xB42"],"\xA3"=>[0,"\xB4a"],"\xA4"=>[0,"\xB4c"],"\xA5"=>[0,"\xB4e"],"\xA6"=>[0,"\xB4i"],"\xA7"=>[0,"\xB4o"],"\xA8"=>[0,"\xB4s"],"\xA9"=>[0,"\xB4t"],"\xAA"=>[73,"\xB4"],"\xAB"=>[88,"\xB4"],"\xAC"=>[89,"\xB4"],"\xAD"=>[96,"\xB4"],"\xAE"=>[97,"\xB4"],"\xAF"=>[99,"\xB4"],"\xB0"=>[106,"\xB4"],"\xB1"=>[136,"\xB4"],"\xB2"=>[139,"\xB4"],"\xB3"=>[141,"\xB4"],"\xB4"=>[145,"\xB4"],"\xB5"=>[147,"\xB4"],"\xB6"=>[149,"\xB4"],"\xB7"=>[101,"\xB4"],"\xB8"=>[112,"\xB4"],"\xB9"=>[117,"\xB4"],"\xBA"=>[120,"\xB4"],"\xBB"=>[124,"\xB4"],"\xBC"=>[127,"\xB4"],"\xBD"=>[144,"\xB4"],"\xBE"=>[152,"\xB4"],"\xBF"=>[11,"\xB4"],"\xC0"=>[0,"\xB60"],"\xC1"=>[0,"\xB61"],"\xC2"=>[0,"\xB62"],"\xC3"=>[0,"\xB6a"],"\xC4"=>[0,"\xB6c"],"\xC5"=>[0,"\xB6e"],"\xC6"=>[0,"\xB6i"],"\xC7"=>[0,"\xB6o"],"\xC8"=>[0,"\xB6s"],"\xC9"=>[0,"\xB6t"],"\xCA"=>[73,"\xB6"],"\xCB"=>[88,"\xB6"],"\xCC"=>[89,"\xB6"],"\xCD"=>[96,"\xB6"],"\xCE"=>[97,"\xB6"],"\xCF"=>[99,"\xB6"],"\xD0"=>[106,"\xB6"],"\xD1"=>[136,"\xB6"],"\xD2"=>[139,"\xB6"],"\xD3"=>[141,"\xB6"],"\xD4"=>[145,"\xB6"],"\xD5"=>[147,"\xB6"],"\xD6"=>[149,"\xB6"],"\xD7"=>[101,"\xB6"],"\xD8"=>[112,"\xB6"],"\xD9"=>[117,"\xB6"],"\xDA"=>[120,"\xB6"],"\xDB"=>[124,"\xB6"],"\xDC"=>[127,"\xB6"],"\xDD"=>[144,"\xB6"],"\xDE"=>[152,"\xB6"],"\xDF"=>[11,"\xB6"],"\xE0"=>[0,"\xB70"],"\xE1"=>[0,"\xB71"],"\xE2"=>[0,"\xB72"],"\xE3"=>[0,"\xB7a"],"\xE4"=>[0,"\xB7c"],"\xE5"=>[0,"\xB7e"],"\xE6"=>[0,"\xB7i"],"\xE7"=>[0,"\xB7o"],"\xE8"=>[0,"\xB7s"],"\xE9"=>[0,"\xB7t"],"\xEA"=>[73,"\xB7"],"\xEB"=>[88,"\xB7"],"\xEC"=>[89,"\xB7"],"\xED"=>[96,"\xB7"],"\xEE"=>[97,"\xB7"],"\xEF"=>[99,"\xB7"],"\xF0"=>[106,"\xB7"],"\xF1"=>[136,"\xB7"],"\xF2"=>[139,"\xB7"],"\xF3"=>[141,"\xB7"],"\xF4"=>[145,"\xB7"],"\xF5"=>[147,"\xB7"],"\xF6"=>[149,"\xB7"],"\xF7"=>[101,"\xB7"],"\xF8"=>[112,"\xB7"],"\xF9"=>[117,"\xB7"],"\xFA"=>[120,"\xB7"],"\xFB"=>[124,"\xB7"],"\xFC"=>[127,"\xB7"],"\xFD"=>[144,"\xB7"],"\xFE"=>[152,"\xB7"],"\xFF"=>[11,"\xB7"],],["\x00"=>[94,"\xA70"],"\x01"=>[76,"\xA70"],"\x02"=>[104,"\xA70"],"\x03"=>[16,"\xA70"],"\x04"=>[94,"\xA71"],"\x05"=>[76,"\xA71"],"\x06"=>[104,"\xA71"],"\x07"=>[16,"\xA71"],"\x08"=>[94,"\xA72"],"\x09"=>[76,"\xA72"],"\x0A"=>[104,"\xA72"],"\x0B"=>[16,"\xA72"],"\x0C"=>[94,"\xA7a"],"\x0D"=>[76,"\xA7a"],"\x0E"=>[104,"\xA7a"],"\x0F"=>[16,"\xA7a"],"\x10"=>[94,"\xA7c"],"\x11"=>[76,"\xA7c"],"\x12"=>[104,"\xA7c"],"\x13"=>[16,"\xA7c"],"\x14"=>[94,"\xA7e"],"\x15"=>[76,"\xA7e"],"\x16"=>[104,"\xA7e"],"\x17"=>[16,"\xA7e"],"\x18"=>[94,"\xA7i"],"\x19"=>[76,"\xA7i"],"\x1A"=>[104,"\xA7i"],"\x1B"=>[16,"\xA7i"],"\x1C"=>[94,"\xA7o"],"\x1D"=>[76,"\xA7o"],"\x1E"=>[104,"\xA7o"],"\x1F"=>[16,"\xA7o"],"\x20"=>[94,"\xA7s"],"\x21"=>[76,"\xA7s"],"\x22"=>[104,"\xA7s"],"\x23"=>[16,"\xA7s"],"\x24"=>[94,"\xA7t"],"\x25"=>[76,"\xA7t"],"\x26"=>[104,"\xA7t"],"\x27"=>[16,"\xA7t"],"\x28"=>[77,"\xA7\x20"],"\x29"=>[18,"\xA7\x20"],"\x2A"=>[77,"\xA7\x25"],"\x2B"=>[18,"\xA7\x25"],"\x2C"=>[77,"\xA7-"],"-"=>[18,"\xA7-"],"."=>[77,"\xA7."],"\x2F"=>[18,"\xA7."],[77,"\xA7\x2F"],[18,"\xA7\x2F"],[77,"\xA73"],[18,"\xA73"],[77,"\xA74"],[18,"\xA74"],[77,"\xA75"],[18,"\xA75"],[77,"\xA76"],[18,"\xA76"],"\x3A"=>[77,"\xA77"],"\x3B"=>[18,"\xA77"],"\x3C"=>[77,"\xA78"],"\x3D"=>[18,"\xA78"],"\x3E"=>[77,"\xA79"],"\x3F"=>[18,"\xA79"],"\x40"=>[77,"\xA7\x3D"],"A"=>[18,"\xA7\x3D"],"B"=>[77,"\xA7A"],"C"=>[18,"\xA7A"],"D"=>[77,"\xA7_"],"E"=>[18,"\xA7_"],"F"=>[77,"\xA7b"],"G"=>[18,"\xA7b"],"H"=>[77,"\xA7d"],"I"=>[18,"\xA7d"],"J"=>[77,"\xA7f"],"K"=>[18,"\xA7f"],"L"=>[77,"\xA7g"],"M"=>[18,"\xA7g"],"N"=>[77,"\xA7h"],"O"=>[18,"\xA7h"],"P"=>[77,"\xA7l"],"Q"=>[18,"\xA7l"],"R"=>[77,"\xA7m"],"S"=>[18,"\xA7m"],"T"=>[77,"\xA7n"],"U"=>[18,"\xA7n"],"V"=>[77,"\xA7p"],"W"=>[18,"\xA7p"],"X"=>[77,"\xA7r"],"Y"=>[18,"\xA7r"],"Z"=>[77,"\xA7u"],"\x5B"=>[18,"\xA7u"],"\x5C"=>[0,"\xA7\x3A"],"\x5D"=>[0,"\xA7B"],"\x5E"=>[0,"\xA7C"],"_"=>[0,"\xA7D"],"\x60"=>[0,"\xA7E"],"a"=>[0,"\xA7F"],"b"=>[0,"\xA7G"],"c"=>[0,"\xA7H"],"d"=>[0,"\xA7I"],"e"=>[0,"\xA7J"],"f"=>[0,"\xA7K"],"g"=>[0,"\xA7L"],"h"=>[0,"\xA7M"],"i"=>[0,"\xA7N"],"j"=>[0,"\xA7O"],"k"=>[0,"\xA7P"],"l"=>[0,"\xA7Q"],"m"=>[0,"\xA7R"],"n"=>[0,"\xA7S"],"o"=>[0,"\xA7T"],"p"=>[0,"\xA7U"],"q"=>[0,"\xA7V"],"r"=>[0,"\xA7W"],"s"=>[0,"\xA7Y"],"t"=>[0,"\xA7j"],"u"=>[0,"\xA7k"],"v"=>[0,"\xA7q"],"w"=>[0,"\xA7v"],"x"=>[0,"\xA7w"],"y"=>[0,"\xA7x"],"z"=>[0,"\xA7y"],"\x7B"=>[0,"\xA7z"],"\x7C"=>[82,"\xA7"],"\x7D"=>[87,"\xA7"],"~"=>[130,"\xA7"],"\x7F"=>[9,"\xA7"],"\x80"=>[94,"\xAC0"],"\x81"=>[76,"\xAC0"],"\x82"=>[104,"\xAC0"],"\x83"=>[16,"\xAC0"],"\x84"=>[94,"\xAC1"],"\x85"=>[76,"\xAC1"],"\x86"=>[104,"\xAC1"],"\x87"=>[16,"\xAC1"],"\x88"=>[94,"\xAC2"],"\x89"=>[76,"\xAC2"],"\x8A"=>[104,"\xAC2"],"\x8B"=>[16,"\xAC2"],"\x8C"=>[94,"\xACa"],"\x8D"=>[76,"\xACa"],"\x8E"=>[104,"\xACa"],"\x8F"=>[16,"\xACa"],"\x90"=>[94,"\xACc"],"\x91"=>[76,"\xACc"],"\x92"=>[104,"\xACc"],"\x93"=>[16,"\xACc"],"\x94"=>[94,"\xACe"],"\x95"=>[76,"\xACe"],"\x96"=>[104,"\xACe"],"\x97"=>[16,"\xACe"],"\x98"=>[94,"\xACi"],"\x99"=>[76,"\xACi"],"\x9A"=>[104,"\xACi"],"\x9B"=>[16,"\xACi"],"\x9C"=>[94,"\xACo"],"\x9D"=>[76,"\xACo"],"\x9E"=>[104,"\xACo"],"\x9F"=>[16,"\xACo"],"\xA0"=>[94,"\xACs"],"\xA1"=>[76,"\xACs"],"\xA2"=>[104,"\xACs"],"\xA3"=>[16,"\xACs"],"\xA4"=>[94,"\xACt"],"\xA5"=>[76,"\xACt"],"\xA6"=>[104,"\xACt"],"\xA7"=>[16,"\xACt"],"\xA8"=>[77,"\xAC\x20"],"\xA9"=>[18,"\xAC\x20"],"\xAA"=>[77,"\xAC\x25"],"\xAB"=>[18,"\xAC\x25"],"\xAC"=>[77,"\xAC-"],"\xAD"=>[18,"\xAC-"],"\xAE"=>[77,"\xAC."],"\xAF"=>[18,"\xAC."],"\xB0"=>[77,"\xAC\x2F"],"\xB1"=>[18,"\xAC\x2F"],"\xB2"=>[77,"\xAC3"],"\xB3"=>[18,"\xAC3"],"\xB4"=>[77,"\xAC4"],"\xB5"=>[18,"\xAC4"],"\xB6"=>[77,"\xAC5"],"\xB7"=>[18,"\xAC5"],"\xB8"=>[77,"\xAC6"],"\xB9"=>[18,"\xAC6"],"\xBA"=>[77,"\xAC7"],"\xBB"=>[18,"\xAC7"],"\xBC"=>[77,"\xAC8"],"\xBD"=>[18,"\xAC8"],"\xBE"=>[77,"\xAC9"],"\xBF"=>[18,"\xAC9"],"\xC0"=>[77,"\xAC\x3D"],"\xC1"=>[18,"\xAC\x3D"],"\xC2"=>[77,"\xACA"],"\xC3"=>[18,"\xACA"],"\xC4"=>[77,"\xAC_"],"\xC5"=>[18,"\xAC_"],"\xC6"=>[77,"\xACb"],"\xC7"=>[18,"\xACb"],"\xC8"=>[77,"\xACd"],"\xC9"=>[18,"\xACd"],"\xCA"=>[77,"\xACf"],"\xCB"=>[18,"\xACf"],"\xCC"=>[77,"\xACg"],"\xCD"=>[18,"\xACg"],"\xCE"=>[77,"\xACh"],"\xCF"=>[18,"\xACh"],"\xD0"=>[77,"\xACl"],"\xD1"=>[18,"\xACl"],"\xD2"=>[77,"\xACm"],"\xD3"=>[18,"\xACm"],"\xD4"=>[77,"\xACn"],"\xD5"=>[18,"\xACn"],"\xD6"=>[77,"\xACp"],"\xD7"=>[18,"\xACp"],"\xD8"=>[77,"\xACr"],"\xD9"=>[18,"\xACr"],"\xDA"=>[77,"\xACu"],"\xDB"=>[18,"\xACu"],"\xDC"=>[0,"\xAC\x3A"],"\xDD"=>[0,"\xACB"],"\xDE"=>[0,"\xACC"],"\xDF"=>[0,"\xACD"],"\xE0"=>[0,"\xACE"],"\xE1"=>[0,"\xACF"],"\xE2"=>[0,"\xACG"],"\xE3"=>[0,"\xACH"],"\xE4"=>[0,"\xACI"],"\xE5"=>[0,"\xACJ"],"\xE6"=>[0,"\xACK"],"\xE7"=>[0,"\xACL"],"\xE8"=>[0,"\xACM"],"\xE9"=>[0,"\xACN"],"\xEA"=>[0,"\xACO"],"\xEB"=>[0,"\xACP"],"\xEC"=>[0,"\xACQ"],"\xED"=>[0,"\xACR"],"\xEE"=>[0,"\xACS"],"\xEF"=>[0,"\xACT"],"\xF0"=>[0,"\xACU"],"\xF1"=>[0,"\xACV"],"\xF2"=>[0,"\xACW"],"\xF3"=>[0,"\xACY"],"\xF4"=>[0,"\xACj"],"\xF5"=>[0,"\xACk"],"\xF6"=>[0,"\xACq"],"\xF7"=>[0,"\xACv"],"\xF8"=>[0,"\xACw"],"\xF9"=>[0,"\xACx"],"\xFA"=>[0,"\xACy"],"\xFB"=>[0,"\xACz"],"\xFC"=>[82,"\xAC"],"\xFD"=>[87,"\xAC"],"\xFE"=>[130,"\xAC"],"\xFF"=>[9,"\xAC"],],["\x00"=>[94,"\xA80"],"\x01"=>[76,"\xA80"],"\x02"=>[104,"\xA80"],"\x03"=>[16,"\xA80"],"\x04"=>[94,"\xA81"],"\x05"=>[76,"\xA81"],"\x06"=>[104,"\xA81"],"\x07"=>[16,"\xA81"],"\x08"=>[94,"\xA82"],"\x09"=>[76,"\xA82"],"\x0A"=>[104,"\xA82"],"\x0B"=>[16,"\xA82"],"\x0C"=>[94,"\xA8a"],"\x0D"=>[76,"\xA8a"],"\x0E"=>[104,"\xA8a"],"\x0F"=>[16,"\xA8a"],"\x10"=>[94,"\xA8c"],"\x11"=>[76,"\xA8c"],"\x12"=>[104,"\xA8c"],"\x13"=>[16,"\xA8c"],"\x14"=>[94,"\xA8e"],"\x15"=>[76,"\xA8e"],"\x16"=>[104,"\xA8e"],"\x17"=>[16,"\xA8e"],"\x18"=>[94,"\xA8i"],"\x19"=>[76,"\xA8i"],"\x1A"=>[104,"\xA8i"],"\x1B"=>[16,"\xA8i"],"\x1C"=>[94,"\xA8o"],"\x1D"=>[76,"\xA8o"],"\x1E"=>[104,"\xA8o"],"\x1F"=>[16,"\xA8o"],"\x20"=>[94,"\xA8s"],"\x21"=>[76,"\xA8s"],"\x22"=>[104,"\xA8s"],"\x23"=>[16,"\xA8s"],"\x24"=>[94,"\xA8t"],"\x25"=>[76,"\xA8t"],"\x26"=>[104,"\xA8t"],"\x27"=>[16,"\xA8t"],"\x28"=>[77,"\xA8\x20"],"\x29"=>[18,"\xA8\x20"],"\x2A"=>[77,"\xA8\x25"],"\x2B"=>[18,"\xA8\x25"],"\x2C"=>[77,"\xA8-"],"-"=>[18,"\xA8-"],"."=>[77,"\xA8."],"\x2F"=>[18,"\xA8."],[77,"\xA8\x2F"],[18,"\xA8\x2F"],[77,"\xA83"],[18,"\xA83"],[77,"\xA84"],[18,"\xA84"],[77,"\xA85"],[18,"\xA85"],[77,"\xA86"],[18,"\xA86"],"\x3A"=>[77,"\xA87"],"\x3B"=>[18,"\xA87"],"\x3C"=>[77,"\xA88"],"\x3D"=>[18,"\xA88"],"\x3E"=>[77,"\xA89"],"\x3F"=>[18,"\xA89"],"\x40"=>[77,"\xA8\x3D"],"A"=>[18,"\xA8\x3D"],"B"=>[77,"\xA8A"],"C"=>[18,"\xA8A"],"D"=>[77,"\xA8_"],"E"=>[18,"\xA8_"],"F"=>[77,"\xA8b"],"G"=>[18,"\xA8b"],"H"=>[77,"\xA8d"],"I"=>[18,"\xA8d"],"J"=>[77,"\xA8f"],"K"=>[18,"\xA8f"],"L"=>[77,"\xA8g"],"M"=>[18,"\xA8g"],"N"=>[77,"\xA8h"],"O"=>[18,"\xA8h"],"P"=>[77,"\xA8l"],"Q"=>[18,"\xA8l"],"R"=>[77,"\xA8m"],"S"=>[18,"\xA8m"],"T"=>[77,"\xA8n"],"U"=>[18,"\xA8n"],"V"=>[77,"\xA8p"],"W"=>[18,"\xA8p"],"X"=>[77,"\xA8r"],"Y"=>[18,"\xA8r"],"Z"=>[77,"\xA8u"],"\x5B"=>[18,"\xA8u"],"\x5C"=>[0,"\xA8\x3A"],"\x5D"=>[0,"\xA8B"],"\x5E"=>[0,"\xA8C"],"_"=>[0,"\xA8D"],"\x60"=>[0,"\xA8E"],"a"=>[0,"\xA8F"],"b"=>[0,"\xA8G"],"c"=>[0,"\xA8H"],"d"=>[0,"\xA8I"],"e"=>[0,"\xA8J"],"f"=>[0,"\xA8K"],"g"=>[0,"\xA8L"],"h"=>[0,"\xA8M"],"i"=>[0,"\xA8N"],"j"=>[0,"\xA8O"],"k"=>[0,"\xA8P"],"l"=>[0,"\xA8Q"],"m"=>[0,"\xA8R"],"n"=>[0,"\xA8S"],"o"=>[0,"\xA8T"],"p"=>[0,"\xA8U"],"q"=>[0,"\xA8V"],"r"=>[0,"\xA8W"],"s"=>[0,"\xA8Y"],"t"=>[0,"\xA8j"],"u"=>[0,"\xA8k"],"v"=>[0,"\xA8q"],"w"=>[0,"\xA8v"],"x"=>[0,"\xA8w"],"y"=>[0,"\xA8x"],"z"=>[0,"\xA8y"],"\x7B"=>[0,"\xA8z"],"\x7C"=>[82,"\xA8"],"\x7D"=>[87,"\xA8"],"~"=>[130,"\xA8"],"\x7F"=>[9,"\xA8"],"\x80"=>[94,"\xAE0"],"\x81"=>[76,"\xAE0"],"\x82"=>[104,"\xAE0"],"\x83"=>[16,"\xAE0"],"\x84"=>[94,"\xAE1"],"\x85"=>[76,"\xAE1"],"\x86"=>[104,"\xAE1"],"\x87"=>[16,"\xAE1"],"\x88"=>[94,"\xAE2"],"\x89"=>[76,"\xAE2"],"\x8A"=>[104,"\xAE2"],"\x8B"=>[16,"\xAE2"],"\x8C"=>[94,"\xAEa"],"\x8D"=>[76,"\xAEa"],"\x8E"=>[104,"\xAEa"],"\x8F"=>[16,"\xAEa"],"\x90"=>[94,"\xAEc"],"\x91"=>[76,"\xAEc"],"\x92"=>[104,"\xAEc"],"\x93"=>[16,"\xAEc"],"\x94"=>[94,"\xAEe"],"\x95"=>[76,"\xAEe"],"\x96"=>[104,"\xAEe"],"\x97"=>[16,"\xAEe"],"\x98"=>[94,"\xAEi"],"\x99"=>[76,"\xAEi"],"\x9A"=>[104,"\xAEi"],"\x9B"=>[16,"\xAEi"],"\x9C"=>[94,"\xAEo"],"\x9D"=>[76,"\xAEo"],"\x9E"=>[104,"\xAEo"],"\x9F"=>[16,"\xAEo"],"\xA0"=>[94,"\xAEs"],"\xA1"=>[76,"\xAEs"],"\xA2"=>[104,"\xAEs"],"\xA3"=>[16,"\xAEs"],"\xA4"=>[94,"\xAEt"],"\xA5"=>[76,"\xAEt"],"\xA6"=>[104,"\xAEt"],"\xA7"=>[16,"\xAEt"],"\xA8"=>[77,"\xAE\x20"],"\xA9"=>[18,"\xAE\x20"],"\xAA"=>[77,"\xAE\x25"],"\xAB"=>[18,"\xAE\x25"],"\xAC"=>[77,"\xAE-"],"\xAD"=>[18,"\xAE-"],"\xAE"=>[77,"\xAE."],"\xAF"=>[18,"\xAE."],"\xB0"=>[77,"\xAE\x2F"],"\xB1"=>[18,"\xAE\x2F"],"\xB2"=>[77,"\xAE3"],"\xB3"=>[18,"\xAE3"],"\xB4"=>[77,"\xAE4"],"\xB5"=>[18,"\xAE4"],"\xB6"=>[77,"\xAE5"],"\xB7"=>[18,"\xAE5"],"\xB8"=>[77,"\xAE6"],"\xB9"=>[18,"\xAE6"],"\xBA"=>[77,"\xAE7"],"\xBB"=>[18,"\xAE7"],"\xBC"=>[77,"\xAE8"],"\xBD"=>[18,"\xAE8"],"\xBE"=>[77,"\xAE9"],"\xBF"=>[18,"\xAE9"],"\xC0"=>[77,"\xAE\x3D"],"\xC1"=>[18,"\xAE\x3D"],"\xC2"=>[77,"\xAEA"],"\xC3"=>[18,"\xAEA"],"\xC4"=>[77,"\xAE_"],"\xC5"=>[18,"\xAE_"],"\xC6"=>[77,"\xAEb"],"\xC7"=>[18,"\xAEb"],"\xC8"=>[77,"\xAEd"],"\xC9"=>[18,"\xAEd"],"\xCA"=>[77,"\xAEf"],"\xCB"=>[18,"\xAEf"],"\xCC"=>[77,"\xAEg"],"\xCD"=>[18,"\xAEg"],"\xCE"=>[77,"\xAEh"],"\xCF"=>[18,"\xAEh"],"\xD0"=>[77,"\xAEl"],"\xD1"=>[18,"\xAEl"],"\xD2"=>[77,"\xAEm"],"\xD3"=>[18,"\xAEm"],"\xD4"=>[77,"\xAEn"],"\xD5"=>[18,"\xAEn"],"\xD6"=>[77,"\xAEp"],"\xD7"=>[18,"\xAEp"],"\xD8"=>[77,"\xAEr"],"\xD9"=>[18,"\xAEr"],"\xDA"=>[77,"\xAEu"],"\xDB"=>[18,"\xAEu"],"\xDC"=>[0,"\xAE\x3A"],"\xDD"=>[0,"\xAEB"],"\xDE"=>[0,"\xAEC"],"\xDF"=>[0,"\xAED"],"\xE0"=>[0,"\xAEE"],"\xE1"=>[0,"\xAEF"],"\xE2"=>[0,"\xAEG"],"\xE3"=>[0,"\xAEH"],"\xE4"=>[0,"\xAEI"],"\xE5"=>[0,"\xAEJ"],"\xE6"=>[0,"\xAEK"],"\xE7"=>[0,"\xAEL"],"\xE8"=>[0,"\xAEM"],"\xE9"=>[0,"\xAEN"],"\xEA"=>[0,"\xAEO"],"\xEB"=>[0,"\xAEP"],"\xEC"=>[0,"\xAEQ"],"\xED"=>[0,"\xAER"],"\xEE"=>[0,"\xAES"],"\xEF"=>[0,"\xAET"],"\xF0"=>[0,"\xAEU"],"\xF1"=>[0,"\xAEV"],"\xF2"=>[0,"\xAEW"],"\xF3"=>[0,"\xAEY"],"\xF4"=>[0,"\xAEj"],"\xF5"=>[0,"\xAEk"],"\xF6"=>[0,"\xAEq"],"\xF7"=>[0,"\xAEv"],"\xF8"=>[0,"\xAEw"],"\xF9"=>[0,"\xAEx"],"\xFA"=>[0,"\xAEy"],"\xFB"=>[0,"\xAEz"],"\xFC"=>[82,"\xAE"],"\xFD"=>[87,"\xAE"],"\xFE"=>[130,"\xAE"],"\xFF"=>[9,"\xAE"],],["\x00"=>[94,"\xAA0"],"\x01"=>[76,"\xAA0"],"\x02"=>[104,"\xAA0"],"\x03"=>[16,"\xAA0"],"\x04"=>[94,"\xAA1"],"\x05"=>[76,"\xAA1"],"\x06"=>[104,"\xAA1"],"\x07"=>[16,"\xAA1"],"\x08"=>[94,"\xAA2"],"\x09"=>[76,"\xAA2"],"\x0A"=>[104,"\xAA2"],"\x0B"=>[16,"\xAA2"],"\x0C"=>[94,"\xAAa"],"\x0D"=>[76,"\xAAa"],"\x0E"=>[104,"\xAAa"],"\x0F"=>[16,"\xAAa"],"\x10"=>[94,"\xAAc"],"\x11"=>[76,"\xAAc"],"\x12"=>[104,"\xAAc"],"\x13"=>[16,"\xAAc"],"\x14"=>[94,"\xAAe"],"\x15"=>[76,"\xAAe"],"\x16"=>[104,"\xAAe"],"\x17"=>[16,"\xAAe"],"\x18"=>[94,"\xAAi"],"\x19"=>[76,"\xAAi"],"\x1A"=>[104,"\xAAi"],"\x1B"=>[16,"\xAAi"],"\x1C"=>[94,"\xAAo"],"\x1D"=>[76,"\xAAo"],"\x1E"=>[104,"\xAAo"],"\x1F"=>[16,"\xAAo"],"\x20"=>[94,"\xAAs"],"\x21"=>[76,"\xAAs"],"\x22"=>[104,"\xAAs"],"\x23"=>[16,"\xAAs"],"\x24"=>[94,"\xAAt"],"\x25"=>[76,"\xAAt"],"\x26"=>[104,"\xAAt"],"\x27"=>[16,"\xAAt"],"\x28"=>[77,"\xAA\x20"],"\x29"=>[18,"\xAA\x20"],"\x2A"=>[77,"\xAA\x25"],"\x2B"=>[18,"\xAA\x25"],"\x2C"=>[77,"\xAA-"],"-"=>[18,"\xAA-"],"."=>[77,"\xAA."],"\x2F"=>[18,"\xAA."],[77,"\xAA\x2F"],[18,"\xAA\x2F"],[77,"\xAA3"],[18,"\xAA3"],[77,"\xAA4"],[18,"\xAA4"],[77,"\xAA5"],[18,"\xAA5"],[77,"\xAA6"],[18,"\xAA6"],"\x3A"=>[77,"\xAA7"],"\x3B"=>[18,"\xAA7"],"\x3C"=>[77,"\xAA8"],"\x3D"=>[18,"\xAA8"],"\x3E"=>[77,"\xAA9"],"\x3F"=>[18,"\xAA9"],"\x40"=>[77,"\xAA\x3D"],"A"=>[18,"\xAA\x3D"],"B"=>[77,"\xAAA"],"C"=>[18,"\xAAA"],"D"=>[77,"\xAA_"],"E"=>[18,"\xAA_"],"F"=>[77,"\xAAb"],"G"=>[18,"\xAAb"],"H"=>[77,"\xAAd"],"I"=>[18,"\xAAd"],"J"=>[77,"\xAAf"],"K"=>[18,"\xAAf"],"L"=>[77,"\xAAg"],"M"=>[18,"\xAAg"],"N"=>[77,"\xAAh"],"O"=>[18,"\xAAh"],"P"=>[77,"\xAAl"],"Q"=>[18,"\xAAl"],"R"=>[77,"\xAAm"],"S"=>[18,"\xAAm"],"T"=>[77,"\xAAn"],"U"=>[18,"\xAAn"],"V"=>[77,"\xAAp"],"W"=>[18,"\xAAp"],"X"=>[77,"\xAAr"],"Y"=>[18,"\xAAr"],"Z"=>[77,"\xAAu"],"\x5B"=>[18,"\xAAu"],"\x5C"=>[0,"\xAA\x3A"],"\x5D"=>[0,"\xAAB"],"\x5E"=>[0,"\xAAC"],"_"=>[0,"\xAAD"],"\x60"=>[0,"\xAAE"],"a"=>[0,"\xAAF"],"b"=>[0,"\xAAG"],"c"=>[0,"\xAAH"],"d"=>[0,"\xAAI"],"e"=>[0,"\xAAJ"],"f"=>[0,"\xAAK"],"g"=>[0,"\xAAL"],"h"=>[0,"\xAAM"],"i"=>[0,"\xAAN"],"j"=>[0,"\xAAO"],"k"=>[0,"\xAAP"],"l"=>[0,"\xAAQ"],"m"=>[0,"\xAAR"],"n"=>[0,"\xAAS"],"o"=>[0,"\xAAT"],"p"=>[0,"\xAAU"],"q"=>[0,"\xAAV"],"r"=>[0,"\xAAW"],"s"=>[0,"\xAAY"],"t"=>[0,"\xAAj"],"u"=>[0,"\xAAk"],"v"=>[0,"\xAAq"],"w"=>[0,"\xAAv"],"x"=>[0,"\xAAw"],"y"=>[0,"\xAAx"],"z"=>[0,"\xAAy"],"\x7B"=>[0,"\xAAz"],"\x7C"=>[82,"\xAA"],"\x7D"=>[87,"\xAA"],"~"=>[130,"\xAA"],"\x7F"=>[9,"\xAA"],"\x80"=>[94,"\xAD0"],"\x81"=>[76,"\xAD0"],"\x82"=>[104,"\xAD0"],"\x83"=>[16,"\xAD0"],"\x84"=>[94,"\xAD1"],"\x85"=>[76,"\xAD1"],"\x86"=>[104,"\xAD1"],"\x87"=>[16,"\xAD1"],"\x88"=>[94,"\xAD2"],"\x89"=>[76,"\xAD2"],"\x8A"=>[104,"\xAD2"],"\x8B"=>[16,"\xAD2"],"\x8C"=>[94,"\xADa"],"\x8D"=>[76,"\xADa"],"\x8E"=>[104,"\xADa"],"\x8F"=>[16,"\xADa"],"\x90"=>[94,"\xADc"],"\x91"=>[76,"\xADc"],"\x92"=>[104,"\xADc"],"\x93"=>[16,"\xADc"],"\x94"=>[94,"\xADe"],"\x95"=>[76,"\xADe"],"\x96"=>[104,"\xADe"],"\x97"=>[16,"\xADe"],"\x98"=>[94,"\xADi"],"\x99"=>[76,"\xADi"],"\x9A"=>[104,"\xADi"],"\x9B"=>[16,"\xADi"],"\x9C"=>[94,"\xADo"],"\x9D"=>[76,"\xADo"],"\x9E"=>[104,"\xADo"],"\x9F"=>[16,"\xADo"],"\xA0"=>[94,"\xADs"],"\xA1"=>[76,"\xADs"],"\xA2"=>[104,"\xADs"],"\xA3"=>[16,"\xADs"],"\xA4"=>[94,"\xADt"],"\xA5"=>[76,"\xADt"],"\xA6"=>[104,"\xADt"],"\xA7"=>[16,"\xADt"],"\xA8"=>[77,"\xAD\x20"],"\xA9"=>[18,"\xAD\x20"],"\xAA"=>[77,"\xAD\x25"],"\xAB"=>[18,"\xAD\x25"],"\xAC"=>[77,"\xAD-"],"\xAD"=>[18,"\xAD-"],"\xAE"=>[77,"\xAD."],"\xAF"=>[18,"\xAD."],"\xB0"=>[77,"\xAD\x2F"],"\xB1"=>[18,"\xAD\x2F"],"\xB2"=>[77,"\xAD3"],"\xB3"=>[18,"\xAD3"],"\xB4"=>[77,"\xAD4"],"\xB5"=>[18,"\xAD4"],"\xB6"=>[77,"\xAD5"],"\xB7"=>[18,"\xAD5"],"\xB8"=>[77,"\xAD6"],"\xB9"=>[18,"\xAD6"],"\xBA"=>[77,"\xAD7"],"\xBB"=>[18,"\xAD7"],"\xBC"=>[77,"\xAD8"],"\xBD"=>[18,"\xAD8"],"\xBE"=>[77,"\xAD9"],"\xBF"=>[18,"\xAD9"],"\xC0"=>[77,"\xAD\x3D"],"\xC1"=>[18,"\xAD\x3D"],"\xC2"=>[77,"\xADA"],"\xC3"=>[18,"\xADA"],"\xC4"=>[77,"\xAD_"],"\xC5"=>[18,"\xAD_"],"\xC6"=>[77,"\xADb"],"\xC7"=>[18,"\xADb"],"\xC8"=>[77,"\xADd"],"\xC9"=>[18,"\xADd"],"\xCA"=>[77,"\xADf"],"\xCB"=>[18,"\xADf"],"\xCC"=>[77,"\xADg"],"\xCD"=>[18,"\xADg"],"\xCE"=>[77,"\xADh"],"\xCF"=>[18,"\xADh"],"\xD0"=>[77,"\xADl"],"\xD1"=>[18,"\xADl"],"\xD2"=>[77,"\xADm"],"\xD3"=>[18,"\xADm"],"\xD4"=>[77,"\xADn"],"\xD5"=>[18,"\xADn"],"\xD6"=>[77,"\xADp"],"\xD7"=>[18,"\xADp"],"\xD8"=>[77,"\xADr"],"\xD9"=>[18,"\xADr"],"\xDA"=>[77,"\xADu"],"\xDB"=>[18,"\xADu"],"\xDC"=>[0,"\xAD\x3A"],"\xDD"=>[0,"\xADB"],"\xDE"=>[0,"\xADC"],"\xDF"=>[0,"\xADD"],"\xE0"=>[0,"\xADE"],"\xE1"=>[0,"\xADF"],"\xE2"=>[0,"\xADG"],"\xE3"=>[0,"\xADH"],"\xE4"=>[0,"\xADI"],"\xE5"=>[0,"\xADJ"],"\xE6"=>[0,"\xADK"],"\xE7"=>[0,"\xADL"],"\xE8"=>[0,"\xADM"],"\xE9"=>[0,"\xADN"],"\xEA"=>[0,"\xADO"],"\xEB"=>[0,"\xADP"],"\xEC"=>[0,"\xADQ"],"\xED"=>[0,"\xADR"],"\xEE"=>[0,"\xADS"],"\xEF"=>[0,"\xADT"],"\xF0"=>[0,"\xADU"],"\xF1"=>[0,"\xADV"],"\xF2"=>[0,"\xADW"],"\xF3"=>[0,"\xADY"],"\xF4"=>[0,"\xADj"],"\xF5"=>[0,"\xADk"],"\xF6"=>[0,"\xADq"],"\xF7"=>[0,"\xADv"],"\xF8"=>[0,"\xADw"],"\xF9"=>[0,"\xADx"],"\xFA"=>[0,"\xADy"],"\xFB"=>[0,"\xADz"],"\xFC"=>[82,"\xAD"],"\xFD"=>[87,"\xAD"],"\xFE"=>[130,"\xAD"],"\xFF"=>[9,"\xAD"],],["\x00"=>[94,"\xAB0"],"\x01"=>[76,"\xAB0"],"\x02"=>[104,"\xAB0"],"\x03"=>[16,"\xAB0"],"\x04"=>[94,"\xAB1"],"\x05"=>[76,"\xAB1"],"\x06"=>[104,"\xAB1"],"\x07"=>[16,"\xAB1"],"\x08"=>[94,"\xAB2"],"\x09"=>[76,"\xAB2"],"\x0A"=>[104,"\xAB2"],"\x0B"=>[16,"\xAB2"],"\x0C"=>[94,"\xABa"],"\x0D"=>[76,"\xABa"],"\x0E"=>[104,"\xABa"],"\x0F"=>[16,"\xABa"],"\x10"=>[94,"\xABc"],"\x11"=>[76,"\xABc"],"\x12"=>[104,"\xABc"],"\x13"=>[16,"\xABc"],"\x14"=>[94,"\xABe"],"\x15"=>[76,"\xABe"],"\x16"=>[104,"\xABe"],"\x17"=>[16,"\xABe"],"\x18"=>[94,"\xABi"],"\x19"=>[76,"\xABi"],"\x1A"=>[104,"\xABi"],"\x1B"=>[16,"\xABi"],"\x1C"=>[94,"\xABo"],"\x1D"=>[76,"\xABo"],"\x1E"=>[104,"\xABo"],"\x1F"=>[16,"\xABo"],"\x20"=>[94,"\xABs"],"\x21"=>[76,"\xABs"],"\x22"=>[104,"\xABs"],"\x23"=>[16,"\xABs"],"\x24"=>[94,"\xABt"],"\x25"=>[76,"\xABt"],"\x26"=>[104,"\xABt"],"\x27"=>[16,"\xABt"],"\x28"=>[77,"\xAB\x20"],"\x29"=>[18,"\xAB\x20"],"\x2A"=>[77,"\xAB\x25"],"\x2B"=>[18,"\xAB\x25"],"\x2C"=>[77,"\xAB-"],"-"=>[18,"\xAB-"],"."=>[77,"\xAB."],"\x2F"=>[18,"\xAB."],[77,"\xAB\x2F"],[18,"\xAB\x2F"],[77,"\xAB3"],[18,"\xAB3"],[77,"\xAB4"],[18,"\xAB4"],[77,"\xAB5"],[18,"\xAB5"],[77,"\xAB6"],[18,"\xAB6"],"\x3A"=>[77,"\xAB7"],"\x3B"=>[18,"\xAB7"],"\x3C"=>[77,"\xAB8"],"\x3D"=>[18,"\xAB8"],"\x3E"=>[77,"\xAB9"],"\x3F"=>[18,"\xAB9"],"\x40"=>[77,"\xAB\x3D"],"A"=>[18,"\xAB\x3D"],"B"=>[77,"\xABA"],"C"=>[18,"\xABA"],"D"=>[77,"\xAB_"],"E"=>[18,"\xAB_"],"F"=>[77,"\xABb"],"G"=>[18,"\xABb"],"H"=>[77,"\xABd"],"I"=>[18,"\xABd"],"J"=>[77,"\xABf"],"K"=>[18,"\xABf"],"L"=>[77,"\xABg"],"M"=>[18,"\xABg"],"N"=>[77,"\xABh"],"O"=>[18,"\xABh"],"P"=>[77,"\xABl"],"Q"=>[18,"\xABl"],"R"=>[77,"\xABm"],"S"=>[18,"\xABm"],"T"=>[77,"\xABn"],"U"=>[18,"\xABn"],"V"=>[77,"\xABp"],"W"=>[18,"\xABp"],"X"=>[77,"\xABr"],"Y"=>[18,"\xABr"],"Z"=>[77,"\xABu"],"\x5B"=>[18,"\xABu"],"\x5C"=>[0,"\xAB\x3A"],"\x5D"=>[0,"\xABB"],"\x5E"=>[0,"\xABC"],"_"=>[0,"\xABD"],"\x60"=>[0,"\xABE"],"a"=>[0,"\xABF"],"b"=>[0,"\xABG"],"c"=>[0,"\xABH"],"d"=>[0,"\xABI"],"e"=>[0,"\xABJ"],"f"=>[0,"\xABK"],"g"=>[0,"\xABL"],"h"=>[0,"\xABM"],"i"=>[0,"\xABN"],"j"=>[0,"\xABO"],"k"=>[0,"\xABP"],"l"=>[0,"\xABQ"],"m"=>[0,"\xABR"],"n"=>[0,"\xABS"],"o"=>[0,"\xABT"],"p"=>[0,"\xABU"],"q"=>[0,"\xABV"],"r"=>[0,"\xABW"],"s"=>[0,"\xABY"],"t"=>[0,"\xABj"],"u"=>[0,"\xABk"],"v"=>[0,"\xABq"],"w"=>[0,"\xABv"],"x"=>[0,"\xABw"],"y"=>[0,"\xABx"],"z"=>[0,"\xABy"],"\x7B"=>[0,"\xABz"],"\x7C"=>[82,"\xAB"],"\x7D"=>[87,"\xAB"],"~"=>[130,"\xAB"],"\x7F"=>[9,"\xAB"],"\x80"=>[94,"\xCE0"],"\x81"=>[76,"\xCE0"],"\x82"=>[104,"\xCE0"],"\x83"=>[16,"\xCE0"],"\x84"=>[94,"\xCE1"],"\x85"=>[76,"\xCE1"],"\x86"=>[104,"\xCE1"],"\x87"=>[16,"\xCE1"],"\x88"=>[94,"\xCE2"],"\x89"=>[76,"\xCE2"],"\x8A"=>[104,"\xCE2"],"\x8B"=>[16,"\xCE2"],"\x8C"=>[94,"\xCEa"],"\x8D"=>[76,"\xCEa"],"\x8E"=>[104,"\xCEa"],"\x8F"=>[16,"\xCEa"],"\x90"=>[94,"\xCEc"],"\x91"=>[76,"\xCEc"],"\x92"=>[104,"\xCEc"],"\x93"=>[16,"\xCEc"],"\x94"=>[94,"\xCEe"],"\x95"=>[76,"\xCEe"],"\x96"=>[104,"\xCEe"],"\x97"=>[16,"\xCEe"],"\x98"=>[94,"\xCEi"],"\x99"=>[76,"\xCEi"],"\x9A"=>[104,"\xCEi"],"\x9B"=>[16,"\xCEi"],"\x9C"=>[94,"\xCEo"],"\x9D"=>[76,"\xCEo"],"\x9E"=>[104,"\xCEo"],"\x9F"=>[16,"\xCEo"],"\xA0"=>[94,"\xCEs"],"\xA1"=>[76,"\xCEs"],"\xA2"=>[104,"\xCEs"],"\xA3"=>[16,"\xCEs"],"\xA4"=>[94,"\xCEt"],"\xA5"=>[76,"\xCEt"],"\xA6"=>[104,"\xCEt"],"\xA7"=>[16,"\xCEt"],"\xA8"=>[77,"\xCE\x20"],"\xA9"=>[18,"\xCE\x20"],"\xAA"=>[77,"\xCE\x25"],"\xAB"=>[18,"\xCE\x25"],"\xAC"=>[77,"\xCE-"],"\xAD"=>[18,"\xCE-"],"\xAE"=>[77,"\xCE."],"\xAF"=>[18,"\xCE."],"\xB0"=>[77,"\xCE\x2F"],"\xB1"=>[18,"\xCE\x2F"],"\xB2"=>[77,"\xCE3"],"\xB3"=>[18,"\xCE3"],"\xB4"=>[77,"\xCE4"],"\xB5"=>[18,"\xCE4"],"\xB6"=>[77,"\xCE5"],"\xB7"=>[18,"\xCE5"],"\xB8"=>[77,"\xCE6"],"\xB9"=>[18,"\xCE6"],"\xBA"=>[77,"\xCE7"],"\xBB"=>[18,"\xCE7"],"\xBC"=>[77,"\xCE8"],"\xBD"=>[18,"\xCE8"],"\xBE"=>[77,"\xCE9"],"\xBF"=>[18,"\xCE9"],"\xC0"=>[77,"\xCE\x3D"],"\xC1"=>[18,"\xCE\x3D"],"\xC2"=>[77,"\xCEA"],"\xC3"=>[18,"\xCEA"],"\xC4"=>[77,"\xCE_"],"\xC5"=>[18,"\xCE_"],"\xC6"=>[77,"\xCEb"],"\xC7"=>[18,"\xCEb"],"\xC8"=>[77,"\xCEd"],"\xC9"=>[18,"\xCEd"],"\xCA"=>[77,"\xCEf"],"\xCB"=>[18,"\xCEf"],"\xCC"=>[77,"\xCEg"],"\xCD"=>[18,"\xCEg"],"\xCE"=>[77,"\xCEh"],"\xCF"=>[18,"\xCEh"],"\xD0"=>[77,"\xCEl"],"\xD1"=>[18,"\xCEl"],"\xD2"=>[77,"\xCEm"],"\xD3"=>[18,"\xCEm"],"\xD4"=>[77,"\xCEn"],"\xD5"=>[18,"\xCEn"],"\xD6"=>[77,"\xCEp"],"\xD7"=>[18,"\xCEp"],"\xD8"=>[77,"\xCEr"],"\xD9"=>[18,"\xCEr"],"\xDA"=>[77,"\xCEu"],"\xDB"=>[18,"\xCEu"],"\xDC"=>[0,"\xCE\x3A"],"\xDD"=>[0,"\xCEB"],"\xDE"=>[0,"\xCEC"],"\xDF"=>[0,"\xCED"],"\xE0"=>[0,"\xCEE"],"\xE1"=>[0,"\xCEF"],"\xE2"=>[0,"\xCEG"],"\xE3"=>[0,"\xCEH"],"\xE4"=>[0,"\xCEI"],"\xE5"=>[0,"\xCEJ"],"\xE6"=>[0,"\xCEK"],"\xE7"=>[0,"\xCEL"],"\xE8"=>[0,"\xCEM"],"\xE9"=>[0,"\xCEN"],"\xEA"=>[0,"\xCEO"],"\xEB"=>[0,"\xCEP"],"\xEC"=>[0,"\xCEQ"],"\xED"=>[0,"\xCER"],"\xEE"=>[0,"\xCES"],"\xEF"=>[0,"\xCET"],"\xF0"=>[0,"\xCEU"],"\xF1"=>[0,"\xCEV"],"\xF2"=>[0,"\xCEW"],"\xF3"=>[0,"\xCEY"],"\xF4"=>[0,"\xCEj"],"\xF5"=>[0,"\xCEk"],"\xF6"=>[0,"\xCEq"],"\xF7"=>[0,"\xCEv"],"\xF8"=>[0,"\xCEw"],"\xF9"=>[0,"\xCEx"],"\xFA"=>[0,"\xCEy"],"\xFB"=>[0,"\xCEz"],"\xFC"=>[82,"\xCE"],"\xFD"=>[87,"\xCE"],"\xFE"=>[130,"\xCE"],"\xFF"=>[9,"\xCE"],],["\x00"=>[77,"\xAB0"],"\x01"=>[18,"\xAB0"],"\x02"=>[77,"\xAB1"],"\x03"=>[18,"\xAB1"],"\x04"=>[77,"\xAB2"],"\x05"=>[18,"\xAB2"],"\x06"=>[77,"\xABa"],"\x07"=>[18,"\xABa"],"\x08"=>[77,"\xABc"],"\x09"=>[18,"\xABc"],"\x0A"=>[77,"\xABe"],"\x0B"=>[18,"\xABe"],"\x0C"=>[77,"\xABi"],"\x0D"=>[18,"\xABi"],"\x0E"=>[77,"\xABo"],"\x0F"=>[18,"\xABo"],"\x10"=>[77,"\xABs"],"\x11"=>[18,"\xABs"],"\x12"=>[77,"\xABt"],"\x13"=>[18,"\xABt"],"\x14"=>[0,"\xAB\x20"],"\x15"=>[0,"\xAB\x25"],"\x16"=>[0,"\xAB-"],"\x17"=>[0,"\xAB."],"\x18"=>[0,"\xAB\x2F"],"\x19"=>[0,"\xAB3"],"\x1A"=>[0,"\xAB4"],"\x1B"=>[0,"\xAB5"],"\x1C"=>[0,"\xAB6"],"\x1D"=>[0,"\xAB7"],"\x1E"=>[0,"\xAB8"],"\x1F"=>[0,"\xAB9"],"\x20"=>[0,"\xAB\x3D"],"\x21"=>[0,"\xABA"],"\x22"=>[0,"\xAB_"],"\x23"=>[0,"\xABb"],"\x24"=>[0,"\xABd"],"\x25"=>[0,"\xABf"],"\x26"=>[0,"\xABg"],"\x27"=>[0,"\xABh"],"\x28"=>[0,"\xABl"],"\x29"=>[0,"\xABm"],"\x2A"=>[0,"\xABn"],"\x2B"=>[0,"\xABp"],"\x2C"=>[0,"\xABr"],"-"=>[0,"\xABu"],"."=>[100,"\xAB"],"\x2F"=>[110,"\xAB"],[111,"\xAB"],[115,"\xAB"],[116,"\xAB"],[118,"\xAB"],[119,"\xAB"],[122,"\xAB"],[123,"\xAB"],[125,"\xAB"],[126,"\xAB"],[129,"\xAB"],"\x3A"=>[143,"\xAB"],"\x3B"=>[148,"\xAB"],"\x3C"=>[151,"\xAB"],"\x3D"=>[153,"\xAB"],"\x3E"=>[83,"\xAB"],"\x3F"=>[10,"\xAB"],"\x40"=>[77,"\xCE0"],"A"=>[18,"\xCE0"],"B"=>[77,"\xCE1"],"C"=>[18,"\xCE1"],"D"=>[77,"\xCE2"],"E"=>[18,"\xCE2"],"F"=>[77,"\xCEa"],"G"=>[18,"\xCEa"],"H"=>[77,"\xCEc"],"I"=>[18,"\xCEc"],"J"=>[77,"\xCEe"],"K"=>[18,"\xCEe"],"L"=>[77,"\xCEi"],"M"=>[18,"\xCEi"],"N"=>[77,"\xCEo"],"O"=>[18,"\xCEo"],"P"=>[77,"\xCEs"],"Q"=>[18,"\xCEs"],"R"=>[77,"\xCEt"],"S"=>[18,"\xCEt"],"T"=>[0,"\xCE\x20"],"U"=>[0,"\xCE\x25"],"V"=>[0,"\xCE-"],"W"=>[0,"\xCE."],"X"=>[0,"\xCE\x2F"],"Y"=>[0,"\xCE3"],"Z"=>[0,"\xCE4"],"\x5B"=>[0,"\xCE5"],"\x5C"=>[0,"\xCE6"],"\x5D"=>[0,"\xCE7"],"\x5E"=>[0,"\xCE8"],"_"=>[0,"\xCE9"],"\x60"=>[0,"\xCE\x3D"],"a"=>[0,"\xCEA"],"b"=>[0,"\xCE_"],"c"=>[0,"\xCEb"],"d"=>[0,"\xCEd"],"e"=>[0,"\xCEf"],"f"=>[0,"\xCEg"],"g"=>[0,"\xCEh"],"h"=>[0,"\xCEl"],"i"=>[0,"\xCEm"],"j"=>[0,"\xCEn"],"k"=>[0,"\xCEp"],"l"=>[0,"\xCEr"],"m"=>[0,"\xCEu"],"n"=>[100,"\xCE"],"o"=>[110,"\xCE"],"p"=>[111,"\xCE"],"q"=>[115,"\xCE"],"r"=>[116,"\xCE"],"s"=>[118,"\xCE"],"t"=>[119,"\xCE"],"u"=>[122,"\xCE"],"v"=>[123,"\xCE"],"w"=>[125,"\xCE"],"x"=>[126,"\xCE"],"y"=>[129,"\xCE"],"z"=>[143,"\xCE"],"\x7B"=>[148,"\xCE"],"\x7C"=>[151,"\xCE"],"\x7D"=>[153,"\xCE"],"~"=>[83,"\xCE"],"\x7F"=>[10,"\xCE"],"\x80"=>[77,"\xD70"],"\x81"=>[18,"\xD70"],"\x82"=>[77,"\xD71"],"\x83"=>[18,"\xD71"],"\x84"=>[77,"\xD72"],"\x85"=>[18,"\xD72"],"\x86"=>[77,"\xD7a"],"\x87"=>[18,"\xD7a"],"\x88"=>[77,"\xD7c"],"\x89"=>[18,"\xD7c"],"\x8A"=>[77,"\xD7e"],"\x8B"=>[18,"\xD7e"],"\x8C"=>[77,"\xD7i"],"\x8D"=>[18,"\xD7i"],"\x8E"=>[77,"\xD7o"],"\x8F"=>[18,"\xD7o"],"\x90"=>[77,"\xD7s"],"\x91"=>[18,"\xD7s"],"\x92"=>[77,"\xD7t"],"\x93"=>[18,"\xD7t"],"\x94"=>[0,"\xD7\x20"],"\x95"=>[0,"\xD7\x25"],"\x96"=>[0,"\xD7-"],"\x97"=>[0,"\xD7."],"\x98"=>[0,"\xD7\x2F"],"\x99"=>[0,"\xD73"],"\x9A"=>[0,"\xD74"],"\x9B"=>[0,"\xD75"],"\x9C"=>[0,"\xD76"],"\x9D"=>[0,"\xD77"],"\x9E"=>[0,"\xD78"],"\x9F"=>[0,"\xD79"],"\xA0"=>[0,"\xD7\x3D"],"\xA1"=>[0,"\xD7A"],"\xA2"=>[0,"\xD7_"],"\xA3"=>[0,"\xD7b"],"\xA4"=>[0,"\xD7d"],"\xA5"=>[0,"\xD7f"],"\xA6"=>[0,"\xD7g"],"\xA7"=>[0,"\xD7h"],"\xA8"=>[0,"\xD7l"],"\xA9"=>[0,"\xD7m"],"\xAA"=>[0,"\xD7n"],"\xAB"=>[0,"\xD7p"],"\xAC"=>[0,"\xD7r"],"\xAD"=>[0,"\xD7u"],"\xAE"=>[100,"\xD7"],"\xAF"=>[110,"\xD7"],"\xB0"=>[111,"\xD7"],"\xB1"=>[115,"\xD7"],"\xB2"=>[116,"\xD7"],"\xB3"=>[118,"\xD7"],"\xB4"=>[119,"\xD7"],"\xB5"=>[122,"\xD7"],"\xB6"=>[123,"\xD7"],"\xB7"=>[125,"\xD7"],"\xB8"=>[126,"\xD7"],"\xB9"=>[129,"\xD7"],"\xBA"=>[143,"\xD7"],"\xBB"=>[148,"\xD7"],"\xBC"=>[151,"\xD7"],"\xBD"=>[153,"\xD7"],"\xBE"=>[83,"\xD7"],"\xBF"=>[10,"\xD7"],"\xC0"=>[77,"\xE10"],"\xC1"=>[18,"\xE10"],"\xC2"=>[77,"\xE11"],"\xC3"=>[18,"\xE11"],"\xC4"=>[77,"\xE12"],"\xC5"=>[18,"\xE12"],"\xC6"=>[77,"\xE1a"],"\xC7"=>[18,"\xE1a"],"\xC8"=>[77,"\xE1c"],"\xC9"=>[18,"\xE1c"],"\xCA"=>[77,"\xE1e"],"\xCB"=>[18,"\xE1e"],"\xCC"=>[77,"\xE1i"],"\xCD"=>[18,"\xE1i"],"\xCE"=>[77,"\xE1o"],"\xCF"=>[18,"\xE1o"],"\xD0"=>[77,"\xE1s"],"\xD1"=>[18,"\xE1s"],"\xD2"=>[77,"\xE1t"],"\xD3"=>[18,"\xE1t"],"\xD4"=>[0,"\xE1\x20"],"\xD5"=>[0,"\xE1\x25"],"\xD6"=>[0,"\xE1-"],"\xD7"=>[0,"\xE1."],"\xD8"=>[0,"\xE1\x2F"],"\xD9"=>[0,"\xE13"],"\xDA"=>[0,"\xE14"],"\xDB"=>[0,"\xE15"],"\xDC"=>[0,"\xE16"],"\xDD"=>[0,"\xE17"],"\xDE"=>[0,"\xE18"],"\xDF"=>[0,"\xE19"],"\xE0"=>[0,"\xE1\x3D"],"\xE1"=>[0,"\xE1A"],"\xE2"=>[0,"\xE1_"],"\xE3"=>[0,"\xE1b"],"\xE4"=>[0,"\xE1d"],"\xE5"=>[0,"\xE1f"],"\xE6"=>[0,"\xE1g"],"\xE7"=>[0,"\xE1h"],"\xE8"=>[0,"\xE1l"],"\xE9"=>[0,"\xE1m"],"\xEA"=>[0,"\xE1n"],"\xEB"=>[0,"\xE1p"],"\xEC"=>[0,"\xE1r"],"\xED"=>[0,"\xE1u"],"\xEE"=>[100,"\xE1"],"\xEF"=>[110,"\xE1"],"\xF0"=>[111,"\xE1"],"\xF1"=>[115,"\xE1"],"\xF2"=>[116,"\xE1"],"\xF3"=>[118,"\xE1"],"\xF4"=>[119,"\xE1"],"\xF5"=>[122,"\xE1"],"\xF6"=>[123,"\xE1"],"\xF7"=>[125,"\xE1"],"\xF8"=>[126,"\xE1"],"\xF9"=>[129,"\xE1"],"\xFA"=>[143,"\xE1"],"\xFB"=>[148,"\xE1"],"\xFC"=>[151,"\xE1"],"\xFD"=>[153,"\xE1"],"\xFE"=>[83,"\xE1"],"\xFF"=>[10,"\xE1"],],["\x00"=>[0,"\xAB0"],"\x01"=>[0,"\xAB1"],"\x02"=>[0,"\xAB2"],"\x03"=>[0,"\xABa"],"\x04"=>[0,"\xABc"],"\x05"=>[0,"\xABe"],"\x06"=>[0,"\xABi"],"\x07"=>[0,"\xABo"],"\x08"=>[0,"\xABs"],"\x09"=>[0,"\xABt"],"\x0A"=>[73,"\xAB"],"\x0B"=>[88,"\xAB"],"\x0C"=>[89,"\xAB"],"\x0D"=>[96,"\xAB"],"\x0E"=>[97,"\xAB"],"\x0F"=>[99,"\xAB"],"\x10"=>[106,"\xAB"],"\x11"=>[136,"\xAB"],"\x12"=>[139,"\xAB"],"\x13"=>[141,"\xAB"],"\x14"=>[145,"\xAB"],"\x15"=>[147,"\xAB"],"\x16"=>[149,"\xAB"],"\x17"=>[101,"\xAB"],"\x18"=>[112,"\xAB"],"\x19"=>[117,"\xAB"],"\x1A"=>[120,"\xAB"],"\x1B"=>[124,"\xAB"],"\x1C"=>[127,"\xAB"],"\x1D"=>[144,"\xAB"],"\x1E"=>[152,"\xAB"],"\x1F"=>[11,"\xAB"],"\x20"=>[0,"\xCE0"],"\x21"=>[0,"\xCE1"],"\x22"=>[0,"\xCE2"],"\x23"=>[0,"\xCEa"],"\x24"=>[0,"\xCEc"],"\x25"=>[0,"\xCEe"],"\x26"=>[0,"\xCEi"],"\x27"=>[0,"\xCEo"],"\x28"=>[0,"\xCEs"],"\x29"=>[0,"\xCEt"],"\x2A"=>[73,"\xCE"],"\x2B"=>[88,"\xCE"],"\x2C"=>[89,"\xCE"],"-"=>[96,"\xCE"],"."=>[97,"\xCE"],"\x2F"=>[99,"\xCE"],[106,"\xCE"],[136,"\xCE"],[139,"\xCE"],[141,"\xCE"],[145,"\xCE"],[147,"\xCE"],[149,"\xCE"],[101,"\xCE"],[112,"\xCE"],[117,"\xCE"],"\x3A"=>[120,"\xCE"],"\x3B"=>[124,"\xCE"],"\x3C"=>[127,"\xCE"],"\x3D"=>[144,"\xCE"],"\x3E"=>[152,"\xCE"],"\x3F"=>[11,"\xCE"],"\x40"=>[0,"\xD70"],"A"=>[0,"\xD71"],"B"=>[0,"\xD72"],"C"=>[0,"\xD7a"],"D"=>[0,"\xD7c"],"E"=>[0,"\xD7e"],"F"=>[0,"\xD7i"],"G"=>[0,"\xD7o"],"H"=>[0,"\xD7s"],"I"=>[0,"\xD7t"],"J"=>[73,"\xD7"],"K"=>[88,"\xD7"],"L"=>[89,"\xD7"],"M"=>[96,"\xD7"],"N"=>[97,"\xD7"],"O"=>[99,"\xD7"],"P"=>[106,"\xD7"],"Q"=>[136,"\xD7"],"R"=>[139,"\xD7"],"S"=>[141,"\xD7"],"T"=>[145,"\xD7"],"U"=>[147,"\xD7"],"V"=>[149,"\xD7"],"W"=>[101,"\xD7"],"X"=>[112,"\xD7"],"Y"=>[117,"\xD7"],"Z"=>[120,"\xD7"],"\x5B"=>[124,"\xD7"],"\x5C"=>[127,"\xD7"],"\x5D"=>[144,"\xD7"],"\x5E"=>[152,"\xD7"],"_"=>[11,"\xD7"],"\x60"=>[0,"\xE10"],"a"=>[0,"\xE11"],"b"=>[0,"\xE12"],"c"=>[0,"\xE1a"],"d"=>[0,"\xE1c"],"e"=>[0,"\xE1e"],"f"=>[0,"\xE1i"],"g"=>[0,"\xE1o"],"h"=>[0,"\xE1s"],"i"=>[0,"\xE1t"],"j"=>[73,"\xE1"],"k"=>[88,"\xE1"],"l"=>[89,"\xE1"],"m"=>[96,"\xE1"],"n"=>[97,"\xE1"],"o"=>[99,"\xE1"],"p"=>[106,"\xE1"],"q"=>[136,"\xE1"],"r"=>[139,"\xE1"],"s"=>[141,"\xE1"],"t"=>[145,"\xE1"],"u"=>[147,"\xE1"],"v"=>[149,"\xE1"],"w"=>[101,"\xE1"],"x"=>[112,"\xE1"],"y"=>[117,"\xE1"],"z"=>[120,"\xE1"],"\x7B"=>[124,"\xE1"],"\x7C"=>[127,"\xE1"],"\x7D"=>[144,"\xE1"],"~"=>[152,"\xE1"],"\x7F"=>[11,"\xE1"],"\x80"=>[0,"\xEC0"],"\x81"=>[0,"\xEC1"],"\x82"=>[0,"\xEC2"],"\x83"=>[0,"\xECa"],"\x84"=>[0,"\xECc"],"\x85"=>[0,"\xECe"],"\x86"=>[0,"\xECi"],"\x87"=>[0,"\xECo"],"\x88"=>[0,"\xECs"],"\x89"=>[0,"\xECt"],"\x8A"=>[73,"\xEC"],"\x8B"=>[88,"\xEC"],"\x8C"=>[89,"\xEC"],"\x8D"=>[96,"\xEC"],"\x8E"=>[97,"\xEC"],"\x8F"=>[99,"\xEC"],"\x90"=>[106,"\xEC"],"\x91"=>[136,"\xEC"],"\x92"=>[139,"\xEC"],"\x93"=>[141,"\xEC"],"\x94"=>[145,"\xEC"],"\x95"=>[147,"\xEC"],"\x96"=>[149,"\xEC"],"\x97"=>[101,"\xEC"],"\x98"=>[112,"\xEC"],"\x99"=>[117,"\xEC"],"\x9A"=>[120,"\xEC"],"\x9B"=>[124,"\xEC"],"\x9C"=>[127,"\xEC"],"\x9D"=>[144,"\xEC"],"\x9E"=>[152,"\xEC"],"\x9F"=>[11,"\xEC"],"\xA0"=>[0,"\xED0"],"\xA1"=>[0,"\xED1"],"\xA2"=>[0,"\xED2"],"\xA3"=>[0,"\xEDa"],"\xA4"=>[0,"\xEDc"],"\xA5"=>[0,"\xEDe"],"\xA6"=>[0,"\xEDi"],"\xA7"=>[0,"\xEDo"],"\xA8"=>[0,"\xEDs"],"\xA9"=>[0,"\xEDt"],"\xAA"=>[73,"\xED"],"\xAB"=>[88,"\xED"],"\xAC"=>[89,"\xED"],"\xAD"=>[96,"\xED"],"\xAE"=>[97,"\xED"],"\xAF"=>[99,"\xED"],"\xB0"=>[106,"\xED"],"\xB1"=>[136,"\xED"],"\xB2"=>[139,"\xED"],"\xB3"=>[141,"\xED"],"\xB4"=>[145,"\xED"],"\xB5"=>[147,"\xED"],"\xB6"=>[149,"\xED"],"\xB7"=>[101,"\xED"],"\xB8"=>[112,"\xED"],"\xB9"=>[117,"\xED"],"\xBA"=>[120,"\xED"],"\xBB"=>[124,"\xED"],"\xBC"=>[127,"\xED"],"\xBD"=>[144,"\xED"],"\xBE"=>[152,"\xED"],"\xBF"=>[11,"\xED"],"\xC0"=>[92,"\xC7"],"\xC1"=>[95,"\xC7"],"\xC2"=>[137,"\xC7"],"\xC3"=>[142,"\xC7"],"\xC4"=>[150,"\xC7"],"\xC5"=>[74,"\xC7"],"\xC6"=>[90,"\xC7"],"\xC7"=>[98,"\xC7"],"\xC8"=>[107,"\xC7"],"\xC9"=>[140,"\xC7"],"\xCA"=>[146,"\xC7"],"\xCB"=>[102,"\xC7"],"\xCC"=>[113,"\xC7"],"\xCD"=>[121,"\xC7"],"\xCE"=>[128,"\xC7"],"\xCF"=>[12,"\xC7"],"\xD0"=>[92,"\xCF"],"\xD1"=>[95,"\xCF"],"\xD2"=>[137,"\xCF"],"\xD3"=>[142,"\xCF"],"\xD4"=>[150,"\xCF"],"\xD5"=>[74,"\xCF"],"\xD6"=>[90,"\xCF"],"\xD7"=>[98,"\xCF"],"\xD8"=>[107,"\xCF"],"\xD9"=>[140,"\xCF"],"\xDA"=>[146,"\xCF"],"\xDB"=>[102,"\xCF"],"\xDC"=>[113,"\xCF"],"\xDD"=>[121,"\xCF"],"\xDE"=>[128,"\xCF"],"\xDF"=>[12,"\xCF"],"\xE0"=>[92,"\xEA"],"\xE1"=>[95,"\xEA"],"\xE2"=>[137,"\xEA"],"\xE3"=>[142,"\xEA"],"\xE4"=>[150,"\xEA"],"\xE5"=>[74,"\xEA"],"\xE6"=>[90,"\xEA"],"\xE7"=>[98,"\xEA"],"\xE8"=>[107,"\xEA"],"\xE9"=>[140,"\xEA"],"\xEA"=>[146,"\xEA"],"\xEB"=>[102,"\xEA"],"\xEC"=>[113,"\xEA"],"\xED"=>[121,"\xEA"],"\xEE"=>[128,"\xEA"],"\xEF"=>[12,"\xEA"],"\xF0"=>[92,"\xEB"],"\xF1"=>[95,"\xEB"],"\xF2"=>[137,"\xEB"],"\xF3"=>[142,"\xEB"],"\xF4"=>[150,"\xEB"],"\xF5"=>[74,"\xEB"],"\xF6"=>[90,"\xEB"],"\xF7"=>[98,"\xEB"],"\xF8"=>[107,"\xEB"],"\xF9"=>[140,"\xEB"],"\xFA"=>[146,"\xEB"],"\xFB"=>[102,"\xEB"],"\xFC"=>[113,"\xEB"],"\xFD"=>[121,"\xEB"],"\xFE"=>[128,"\xEB"],"\xFF"=>[12,"\xEB"],],["\x00"=>[94,"\xAF0"],"\x01"=>[76,"\xAF0"],"\x02"=>[104,"\xAF0"],"\x03"=>[16,"\xAF0"],"\x04"=>[94,"\xAF1"],"\x05"=>[76,"\xAF1"],"\x06"=>[104,"\xAF1"],"\x07"=>[16,"\xAF1"],"\x08"=>[94,"\xAF2"],"\x09"=>[76,"\xAF2"],"\x0A"=>[104,"\xAF2"],"\x0B"=>[16,"\xAF2"],"\x0C"=>[94,"\xAFa"],"\x0D"=>[76,"\xAFa"],"\x0E"=>[104,"\xAFa"],"\x0F"=>[16,"\xAFa"],"\x10"=>[94,"\xAFc"],"\x11"=>[76,"\xAFc"],"\x12"=>[104,"\xAFc"],"\x13"=>[16,"\xAFc"],"\x14"=>[94,"\xAFe"],"\x15"=>[76,"\xAFe"],"\x16"=>[104,"\xAFe"],"\x17"=>[16,"\xAFe"],"\x18"=>[94,"\xAFi"],"\x19"=>[76,"\xAFi"],"\x1A"=>[104,"\xAFi"],"\x1B"=>[16,"\xAFi"],"\x1C"=>[94,"\xAFo"],"\x1D"=>[76,"\xAFo"],"\x1E"=>[104,"\xAFo"],"\x1F"=>[16,"\xAFo"],"\x20"=>[94,"\xAFs"],"\x21"=>[76,"\xAFs"],"\x22"=>[104,"\xAFs"],"\x23"=>[16,"\xAFs"],"\x24"=>[94,"\xAFt"],"\x25"=>[76,"\xAFt"],"\x26"=>[104,"\xAFt"],"\x27"=>[16,"\xAFt"],"\x28"=>[77,"\xAF\x20"],"\x29"=>[18,"\xAF\x20"],"\x2A"=>[77,"\xAF\x25"],"\x2B"=>[18,"\xAF\x25"],"\x2C"=>[77,"\xAF-"],"-"=>[18,"\xAF-"],"."=>[77,"\xAF."],"\x2F"=>[18,"\xAF."],[77,"\xAF\x2F"],[18,"\xAF\x2F"],[77,"\xAF3"],[18,"\xAF3"],[77,"\xAF4"],[18,"\xAF4"],[77,"\xAF5"],[18,"\xAF5"],[77,"\xAF6"],[18,"\xAF6"],"\x3A"=>[77,"\xAF7"],"\x3B"=>[18,"\xAF7"],"\x3C"=>[77,"\xAF8"],"\x3D"=>[18,"\xAF8"],"\x3E"=>[77,"\xAF9"],"\x3F"=>[18,"\xAF9"],"\x40"=>[77,"\xAF\x3D"],"A"=>[18,"\xAF\x3D"],"B"=>[77,"\xAFA"],"C"=>[18,"\xAFA"],"D"=>[77,"\xAF_"],"E"=>[18,"\xAF_"],"F"=>[77,"\xAFb"],"G"=>[18,"\xAFb"],"H"=>[77,"\xAFd"],"I"=>[18,"\xAFd"],"J"=>[77,"\xAFf"],"K"=>[18,"\xAFf"],"L"=>[77,"\xAFg"],"M"=>[18,"\xAFg"],"N"=>[77,"\xAFh"],"O"=>[18,"\xAFh"],"P"=>[77,"\xAFl"],"Q"=>[18,"\xAFl"],"R"=>[77,"\xAFm"],"S"=>[18,"\xAFm"],"T"=>[77,"\xAFn"],"U"=>[18,"\xAFn"],"V"=>[77,"\xAFp"],"W"=>[18,"\xAFp"],"X"=>[77,"\xAFr"],"Y"=>[18,"\xAFr"],"Z"=>[77,"\xAFu"],"\x5B"=>[18,"\xAFu"],"\x5C"=>[0,"\xAF\x3A"],"\x5D"=>[0,"\xAFB"],"\x5E"=>[0,"\xAFC"],"_"=>[0,"\xAFD"],"\x60"=>[0,"\xAFE"],"a"=>[0,"\xAFF"],"b"=>[0,"\xAFG"],"c"=>[0,"\xAFH"],"d"=>[0,"\xAFI"],"e"=>[0,"\xAFJ"],"f"=>[0,"\xAFK"],"g"=>[0,"\xAFL"],"h"=>[0,"\xAFM"],"i"=>[0,"\xAFN"],"j"=>[0,"\xAFO"],"k"=>[0,"\xAFP"],"l"=>[0,"\xAFQ"],"m"=>[0,"\xAFR"],"n"=>[0,"\xAFS"],"o"=>[0,"\xAFT"],"p"=>[0,"\xAFU"],"q"=>[0,"\xAFV"],"r"=>[0,"\xAFW"],"s"=>[0,"\xAFY"],"t"=>[0,"\xAFj"],"u"=>[0,"\xAFk"],"v"=>[0,"\xAFq"],"w"=>[0,"\xAFv"],"x"=>[0,"\xAFw"],"y"=>[0,"\xAFx"],"z"=>[0,"\xAFy"],"\x7B"=>[0,"\xAFz"],"\x7C"=>[82,"\xAF"],"\x7D"=>[87,"\xAF"],"~"=>[130,"\xAF"],"\x7F"=>[9,"\xAF"],"\x80"=>[94,"\xB40"],"\x81"=>[76,"\xB40"],"\x82"=>[104,"\xB40"],"\x83"=>[16,"\xB40"],"\x84"=>[94,"\xB41"],"\x85"=>[76,"\xB41"],"\x86"=>[104,"\xB41"],"\x87"=>[16,"\xB41"],"\x88"=>[94,"\xB42"],"\x89"=>[76,"\xB42"],"\x8A"=>[104,"\xB42"],"\x8B"=>[16,"\xB42"],"\x8C"=>[94,"\xB4a"],"\x8D"=>[76,"\xB4a"],"\x8E"=>[104,"\xB4a"],"\x8F"=>[16,"\xB4a"],"\x90"=>[94,"\xB4c"],"\x91"=>[76,"\xB4c"],"\x92"=>[104,"\xB4c"],"\x93"=>[16,"\xB4c"],"\x94"=>[94,"\xB4e"],"\x95"=>[76,"\xB4e"],"\x96"=>[104,"\xB4e"],"\x97"=>[16,"\xB4e"],"\x98"=>[94,"\xB4i"],"\x99"=>[76,"\xB4i"],"\x9A"=>[104,"\xB4i"],"\x9B"=>[16,"\xB4i"],"\x9C"=>[94,"\xB4o"],"\x9D"=>[76,"\xB4o"],"\x9E"=>[104,"\xB4o"],"\x9F"=>[16,"\xB4o"],"\xA0"=>[94,"\xB4s"],"\xA1"=>[76,"\xB4s"],"\xA2"=>[104,"\xB4s"],"\xA3"=>[16,"\xB4s"],"\xA4"=>[94,"\xB4t"],"\xA5"=>[76,"\xB4t"],"\xA6"=>[104,"\xB4t"],"\xA7"=>[16,"\xB4t"],"\xA8"=>[77,"\xB4\x20"],"\xA9"=>[18,"\xB4\x20"],"\xAA"=>[77,"\xB4\x25"],"\xAB"=>[18,"\xB4\x25"],"\xAC"=>[77,"\xB4-"],"\xAD"=>[18,"\xB4-"],"\xAE"=>[77,"\xB4."],"\xAF"=>[18,"\xB4."],"\xB0"=>[77,"\xB4\x2F"],"\xB1"=>[18,"\xB4\x2F"],"\xB2"=>[77,"\xB43"],"\xB3"=>[18,"\xB43"],"\xB4"=>[77,"\xB44"],"\xB5"=>[18,"\xB44"],"\xB6"=>[77,"\xB45"],"\xB7"=>[18,"\xB45"],"\xB8"=>[77,"\xB46"],"\xB9"=>[18,"\xB46"],"\xBA"=>[77,"\xB47"],"\xBB"=>[18,"\xB47"],"\xBC"=>[77,"\xB48"],"\xBD"=>[18,"\xB48"],"\xBE"=>[77,"\xB49"],"\xBF"=>[18,"\xB49"],"\xC0"=>[77,"\xB4\x3D"],"\xC1"=>[18,"\xB4\x3D"],"\xC2"=>[77,"\xB4A"],"\xC3"=>[18,"\xB4A"],"\xC4"=>[77,"\xB4_"],"\xC5"=>[18,"\xB4_"],"\xC6"=>[77,"\xB4b"],"\xC7"=>[18,"\xB4b"],"\xC8"=>[77,"\xB4d"],"\xC9"=>[18,"\xB4d"],"\xCA"=>[77,"\xB4f"],"\xCB"=>[18,"\xB4f"],"\xCC"=>[77,"\xB4g"],"\xCD"=>[18,"\xB4g"],"\xCE"=>[77,"\xB4h"],"\xCF"=>[18,"\xB4h"],"\xD0"=>[77,"\xB4l"],"\xD1"=>[18,"\xB4l"],"\xD2"=>[77,"\xB4m"],"\xD3"=>[18,"\xB4m"],"\xD4"=>[77,"\xB4n"],"\xD5"=>[18,"\xB4n"],"\xD6"=>[77,"\xB4p"],"\xD7"=>[18,"\xB4p"],"\xD8"=>[77,"\xB4r"],"\xD9"=>[18,"\xB4r"],"\xDA"=>[77,"\xB4u"],"\xDB"=>[18,"\xB4u"],"\xDC"=>[0,"\xB4\x3A"],"\xDD"=>[0,"\xB4B"],"\xDE"=>[0,"\xB4C"],"\xDF"=>[0,"\xB4D"],"\xE0"=>[0,"\xB4E"],"\xE1"=>[0,"\xB4F"],"\xE2"=>[0,"\xB4G"],"\xE3"=>[0,"\xB4H"],"\xE4"=>[0,"\xB4I"],"\xE5"=>[0,"\xB4J"],"\xE6"=>[0,"\xB4K"],"\xE7"=>[0,"\xB4L"],"\xE8"=>[0,"\xB4M"],"\xE9"=>[0,"\xB4N"],"\xEA"=>[0,"\xB4O"],"\xEB"=>[0,"\xB4P"],"\xEC"=>[0,"\xB4Q"],"\xED"=>[0,"\xB4R"],"\xEE"=>[0,"\xB4S"],"\xEF"=>[0,"\xB4T"],"\xF0"=>[0,"\xB4U"],"\xF1"=>[0,"\xB4V"],"\xF2"=>[0,"\xB4W"],"\xF3"=>[0,"\xB4Y"],"\xF4"=>[0,"\xB4j"],"\xF5"=>[0,"\xB4k"],"\xF6"=>[0,"\xB4q"],"\xF7"=>[0,"\xB4v"],"\xF8"=>[0,"\xB4w"],"\xF9"=>[0,"\xB4x"],"\xFA"=>[0,"\xB4y"],"\xFB"=>[0,"\xB4z"],"\xFC"=>[82,"\xB4"],"\xFD"=>[87,"\xB4"],"\xFE"=>[130,"\xB4"],"\xFF"=>[9,"\xB4"],],["\x00"=>[77,"\xAF0"],"\x01"=>[18,"\xAF0"],"\x02"=>[77,"\xAF1"],"\x03"=>[18,"\xAF1"],"\x04"=>[77,"\xAF2"],"\x05"=>[18,"\xAF2"],"\x06"=>[77,"\xAFa"],"\x07"=>[18,"\xAFa"],"\x08"=>[77,"\xAFc"],"\x09"=>[18,"\xAFc"],"\x0A"=>[77,"\xAFe"],"\x0B"=>[18,"\xAFe"],"\x0C"=>[77,"\xAFi"],"\x0D"=>[18,"\xAFi"],"\x0E"=>[77,"\xAFo"],"\x0F"=>[18,"\xAFo"],"\x10"=>[77,"\xAFs"],"\x11"=>[18,"\xAFs"],"\x12"=>[77,"\xAFt"],"\x13"=>[18,"\xAFt"],"\x14"=>[0,"\xAF\x20"],"\x15"=>[0,"\xAF\x25"],"\x16"=>[0,"\xAF-"],"\x17"=>[0,"\xAF."],"\x18"=>[0,"\xAF\x2F"],"\x19"=>[0,"\xAF3"],"\x1A"=>[0,"\xAF4"],"\x1B"=>[0,"\xAF5"],"\x1C"=>[0,"\xAF6"],"\x1D"=>[0,"\xAF7"],"\x1E"=>[0,"\xAF8"],"\x1F"=>[0,"\xAF9"],"\x20"=>[0,"\xAF\x3D"],"\x21"=>[0,"\xAFA"],"\x22"=>[0,"\xAF_"],"\x23"=>[0,"\xAFb"],"\x24"=>[0,"\xAFd"],"\x25"=>[0,"\xAFf"],"\x26"=>[0,"\xAFg"],"\x27"=>[0,"\xAFh"],"\x28"=>[0,"\xAFl"],"\x29"=>[0,"\xAFm"],"\x2A"=>[0,"\xAFn"],"\x2B"=>[0,"\xAFp"],"\x2C"=>[0,"\xAFr"],"-"=>[0,"\xAFu"],"."=>[100,"\xAF"],"\x2F"=>[110,"\xAF"],[111,"\xAF"],[115,"\xAF"],[116,"\xAF"],[118,"\xAF"],[119,"\xAF"],[122,"\xAF"],[123,"\xAF"],[125,"\xAF"],[126,"\xAF"],[129,"\xAF"],"\x3A"=>[143,"\xAF"],"\x3B"=>[148,"\xAF"],"\x3C"=>[151,"\xAF"],"\x3D"=>[153,"\xAF"],"\x3E"=>[83,"\xAF"],"\x3F"=>[10,"\xAF"],"\x40"=>[77,"\xB40"],"A"=>[18,"\xB40"],"B"=>[77,"\xB41"],"C"=>[18,"\xB41"],"D"=>[77,"\xB42"],"E"=>[18,"\xB42"],"F"=>[77,"\xB4a"],"G"=>[18,"\xB4a"],"H"=>[77,"\xB4c"],"I"=>[18,"\xB4c"],"J"=>[77,"\xB4e"],"K"=>[18,"\xB4e"],"L"=>[77,"\xB4i"],"M"=>[18,"\xB4i"],"N"=>[77,"\xB4o"],"O"=>[18,"\xB4o"],"P"=>[77,"\xB4s"],"Q"=>[18,"\xB4s"],"R"=>[77,"\xB4t"],"S"=>[18,"\xB4t"],"T"=>[0,"\xB4\x20"],"U"=>[0,"\xB4\x25"],"V"=>[0,"\xB4-"],"W"=>[0,"\xB4."],"X"=>[0,"\xB4\x2F"],"Y"=>[0,"\xB43"],"Z"=>[0,"\xB44"],"\x5B"=>[0,"\xB45"],"\x5C"=>[0,"\xB46"],"\x5D"=>[0,"\xB47"],"\x5E"=>[0,"\xB48"],"_"=>[0,"\xB49"],"\x60"=>[0,"\xB4\x3D"],"a"=>[0,"\xB4A"],"b"=>[0,"\xB4_"],"c"=>[0,"\xB4b"],"d"=>[0,"\xB4d"],"e"=>[0,"\xB4f"],"f"=>[0,"\xB4g"],"g"=>[0,"\xB4h"],"h"=>[0,"\xB4l"],"i"=>[0,"\xB4m"],"j"=>[0,"\xB4n"],"k"=>[0,"\xB4p"],"l"=>[0,"\xB4r"],"m"=>[0,"\xB4u"],"n"=>[100,"\xB4"],"o"=>[110,"\xB4"],"p"=>[111,"\xB4"],"q"=>[115,"\xB4"],"r"=>[116,"\xB4"],"s"=>[118,"\xB4"],"t"=>[119,"\xB4"],"u"=>[122,"\xB4"],"v"=>[123,"\xB4"],"w"=>[125,"\xB4"],"x"=>[126,"\xB4"],"y"=>[129,"\xB4"],"z"=>[143,"\xB4"],"\x7B"=>[148,"\xB4"],"\x7C"=>[151,"\xB4"],"\x7D"=>[153,"\xB4"],"~"=>[83,"\xB4"],"\x7F"=>[10,"\xB4"],"\x80"=>[77,"\xB60"],"\x81"=>[18,"\xB60"],"\x82"=>[77,"\xB61"],"\x83"=>[18,"\xB61"],"\x84"=>[77,"\xB62"],"\x85"=>[18,"\xB62"],"\x86"=>[77,"\xB6a"],"\x87"=>[18,"\xB6a"],"\x88"=>[77,"\xB6c"],"\x89"=>[18,"\xB6c"],"\x8A"=>[77,"\xB6e"],"\x8B"=>[18,"\xB6e"],"\x8C"=>[77,"\xB6i"],"\x8D"=>[18,"\xB6i"],"\x8E"=>[77,"\xB6o"],"\x8F"=>[18,"\xB6o"],"\x90"=>[77,"\xB6s"],"\x91"=>[18,"\xB6s"],"\x92"=>[77,"\xB6t"],"\x93"=>[18,"\xB6t"],"\x94"=>[0,"\xB6\x20"],"\x95"=>[0,"\xB6\x25"],"\x96"=>[0,"\xB6-"],"\x97"=>[0,"\xB6."],"\x98"=>[0,"\xB6\x2F"],"\x99"=>[0,"\xB63"],"\x9A"=>[0,"\xB64"],"\x9B"=>[0,"\xB65"],"\x9C"=>[0,"\xB66"],"\x9D"=>[0,"\xB67"],"\x9E"=>[0,"\xB68"],"\x9F"=>[0,"\xB69"],"\xA0"=>[0,"\xB6\x3D"],"\xA1"=>[0,"\xB6A"],"\xA2"=>[0,"\xB6_"],"\xA3"=>[0,"\xB6b"],"\xA4"=>[0,"\xB6d"],"\xA5"=>[0,"\xB6f"],"\xA6"=>[0,"\xB6g"],"\xA7"=>[0,"\xB6h"],"\xA8"=>[0,"\xB6l"],"\xA9"=>[0,"\xB6m"],"\xAA"=>[0,"\xB6n"],"\xAB"=>[0,"\xB6p"],"\xAC"=>[0,"\xB6r"],"\xAD"=>[0,"\xB6u"],"\xAE"=>[100,"\xB6"],"\xAF"=>[110,"\xB6"],"\xB0"=>[111,"\xB6"],"\xB1"=>[115,"\xB6"],"\xB2"=>[116,"\xB6"],"\xB3"=>[118,"\xB6"],"\xB4"=>[119,"\xB6"],"\xB5"=>[122,"\xB6"],"\xB6"=>[123,"\xB6"],"\xB7"=>[125,"\xB6"],"\xB8"=>[126,"\xB6"],"\xB9"=>[129,"\xB6"],"\xBA"=>[143,"\xB6"],"\xBB"=>[148,"\xB6"],"\xBC"=>[151,"\xB6"],"\xBD"=>[153,"\xB6"],"\xBE"=>[83,"\xB6"],"\xBF"=>[10,"\xB6"],"\xC0"=>[77,"\xB70"],"\xC1"=>[18,"\xB70"],"\xC2"=>[77,"\xB71"],"\xC3"=>[18,"\xB71"],"\xC4"=>[77,"\xB72"],"\xC5"=>[18,"\xB72"],"\xC6"=>[77,"\xB7a"],"\xC7"=>[18,"\xB7a"],"\xC8"=>[77,"\xB7c"],"\xC9"=>[18,"\xB7c"],"\xCA"=>[77,"\xB7e"],"\xCB"=>[18,"\xB7e"],"\xCC"=>[77,"\xB7i"],"\xCD"=>[18,"\xB7i"],"\xCE"=>[77,"\xB7o"],"\xCF"=>[18,"\xB7o"],"\xD0"=>[77,"\xB7s"],"\xD1"=>[18,"\xB7s"],"\xD2"=>[77,"\xB7t"],"\xD3"=>[18,"\xB7t"],"\xD4"=>[0,"\xB7\x20"],"\xD5"=>[0,"\xB7\x25"],"\xD6"=>[0,"\xB7-"],"\xD7"=>[0,"\xB7."],"\xD8"=>[0,"\xB7\x2F"],"\xD9"=>[0,"\xB73"],"\xDA"=>[0,"\xB74"],"\xDB"=>[0,"\xB75"],"\xDC"=>[0,"\xB76"],"\xDD"=>[0,"\xB77"],"\xDE"=>[0,"\xB78"],"\xDF"=>[0,"\xB79"],"\xE0"=>[0,"\xB7\x3D"],"\xE1"=>[0,"\xB7A"],"\xE2"=>[0,"\xB7_"],"\xE3"=>[0,"\xB7b"],"\xE4"=>[0,"\xB7d"],"\xE5"=>[0,"\xB7f"],"\xE6"=>[0,"\xB7g"],"\xE7"=>[0,"\xB7h"],"\xE8"=>[0,"\xB7l"],"\xE9"=>[0,"\xB7m"],"\xEA"=>[0,"\xB7n"],"\xEB"=>[0,"\xB7p"],"\xEC"=>[0,"\xB7r"],"\xED"=>[0,"\xB7u"],"\xEE"=>[100,"\xB7"],"\xEF"=>[110,"\xB7"],"\xF0"=>[111,"\xB7"],"\xF1"=>[115,"\xB7"],"\xF2"=>[116,"\xB7"],"\xF3"=>[118,"\xB7"],"\xF4"=>[119,"\xB7"],"\xF5"=>[122,"\xB7"],"\xF6"=>[123,"\xB7"],"\xF7"=>[125,"\xB7"],"\xF8"=>[126,"\xB7"],"\xF9"=>[129,"\xB7"],"\xFA"=>[143,"\xB7"],"\xFB"=>[148,"\xB7"],"\xFC"=>[151,"\xB7"],"\xFD"=>[153,"\xB7"],"\xFE"=>[83,"\xB7"],"\xFF"=>[10,"\xB7"],],["\x00"=>[94,"\xB00"],"\x01"=>[76,"\xB00"],"\x02"=>[104,"\xB00"],"\x03"=>[16,"\xB00"],"\x04"=>[94,"\xB01"],"\x05"=>[76,"\xB01"],"\x06"=>[104,"\xB01"],"\x07"=>[16,"\xB01"],"\x08"=>[94,"\xB02"],"\x09"=>[76,"\xB02"],"\x0A"=>[104,"\xB02"],"\x0B"=>[16,"\xB02"],"\x0C"=>[94,"\xB0a"],"\x0D"=>[76,"\xB0a"],"\x0E"=>[104,"\xB0a"],"\x0F"=>[16,"\xB0a"],"\x10"=>[94,"\xB0c"],"\x11"=>[76,"\xB0c"],"\x12"=>[104,"\xB0c"],"\x13"=>[16,"\xB0c"],"\x14"=>[94,"\xB0e"],"\x15"=>[76,"\xB0e"],"\x16"=>[104,"\xB0e"],"\x17"=>[16,"\xB0e"],"\x18"=>[94,"\xB0i"],"\x19"=>[76,"\xB0i"],"\x1A"=>[104,"\xB0i"],"\x1B"=>[16,"\xB0i"],"\x1C"=>[94,"\xB0o"],"\x1D"=>[76,"\xB0o"],"\x1E"=>[104,"\xB0o"],"\x1F"=>[16,"\xB0o"],"\x20"=>[94,"\xB0s"],"\x21"=>[76,"\xB0s"],"\x22"=>[104,"\xB0s"],"\x23"=>[16,"\xB0s"],"\x24"=>[94,"\xB0t"],"\x25"=>[76,"\xB0t"],"\x26"=>[104,"\xB0t"],"\x27"=>[16,"\xB0t"],"\x28"=>[77,"\xB0\x20"],"\x29"=>[18,"\xB0\x20"],"\x2A"=>[77,"\xB0\x25"],"\x2B"=>[18,"\xB0\x25"],"\x2C"=>[77,"\xB0-"],"-"=>[18,"\xB0-"],"."=>[77,"\xB0."],"\x2F"=>[18,"\xB0."],[77,"\xB0\x2F"],[18,"\xB0\x2F"],[77,"\xB03"],[18,"\xB03"],[77,"\xB04"],[18,"\xB04"],[77,"\xB05"],[18,"\xB05"],[77,"\xB06"],[18,"\xB06"],"\x3A"=>[77,"\xB07"],"\x3B"=>[18,"\xB07"],"\x3C"=>[77,"\xB08"],"\x3D"=>[18,"\xB08"],"\x3E"=>[77,"\xB09"],"\x3F"=>[18,"\xB09"],"\x40"=>[77,"\xB0\x3D"],"A"=>[18,"\xB0\x3D"],"B"=>[77,"\xB0A"],"C"=>[18,"\xB0A"],"D"=>[77,"\xB0_"],"E"=>[18,"\xB0_"],"F"=>[77,"\xB0b"],"G"=>[18,"\xB0b"],"H"=>[77,"\xB0d"],"I"=>[18,"\xB0d"],"J"=>[77,"\xB0f"],"K"=>[18,"\xB0f"],"L"=>[77,"\xB0g"],"M"=>[18,"\xB0g"],"N"=>[77,"\xB0h"],"O"=>[18,"\xB0h"],"P"=>[77,"\xB0l"],"Q"=>[18,"\xB0l"],"R"=>[77,"\xB0m"],"S"=>[18,"\xB0m"],"T"=>[77,"\xB0n"],"U"=>[18,"\xB0n"],"V"=>[77,"\xB0p"],"W"=>[18,"\xB0p"],"X"=>[77,"\xB0r"],"Y"=>[18,"\xB0r"],"Z"=>[77,"\xB0u"],"\x5B"=>[18,"\xB0u"],"\x5C"=>[0,"\xB0\x3A"],"\x5D"=>[0,"\xB0B"],"\x5E"=>[0,"\xB0C"],"_"=>[0,"\xB0D"],"\x60"=>[0,"\xB0E"],"a"=>[0,"\xB0F"],"b"=>[0,"\xB0G"],"c"=>[0,"\xB0H"],"d"=>[0,"\xB0I"],"e"=>[0,"\xB0J"],"f"=>[0,"\xB0K"],"g"=>[0,"\xB0L"],"h"=>[0,"\xB0M"],"i"=>[0,"\xB0N"],"j"=>[0,"\xB0O"],"k"=>[0,"\xB0P"],"l"=>[0,"\xB0Q"],"m"=>[0,"\xB0R"],"n"=>[0,"\xB0S"],"o"=>[0,"\xB0T"],"p"=>[0,"\xB0U"],"q"=>[0,"\xB0V"],"r"=>[0,"\xB0W"],"s"=>[0,"\xB0Y"],"t"=>[0,"\xB0j"],"u"=>[0,"\xB0k"],"v"=>[0,"\xB0q"],"w"=>[0,"\xB0v"],"x"=>[0,"\xB0w"],"y"=>[0,"\xB0x"],"z"=>[0,"\xB0y"],"\x7B"=>[0,"\xB0z"],"\x7C"=>[82,"\xB0"],"\x7D"=>[87,"\xB0"],"~"=>[130,"\xB0"],"\x7F"=>[9,"\xB0"],"\x80"=>[94,"\xB10"],"\x81"=>[76,"\xB10"],"\x82"=>[104,"\xB10"],"\x83"=>[16,"\xB10"],"\x84"=>[94,"\xB11"],"\x85"=>[76,"\xB11"],"\x86"=>[104,"\xB11"],"\x87"=>[16,"\xB11"],"\x88"=>[94,"\xB12"],"\x89"=>[76,"\xB12"],"\x8A"=>[104,"\xB12"],"\x8B"=>[16,"\xB12"],"\x8C"=>[94,"\xB1a"],"\x8D"=>[76,"\xB1a"],"\x8E"=>[104,"\xB1a"],"\x8F"=>[16,"\xB1a"],"\x90"=>[94,"\xB1c"],"\x91"=>[76,"\xB1c"],"\x92"=>[104,"\xB1c"],"\x93"=>[16,"\xB1c"],"\x94"=>[94,"\xB1e"],"\x95"=>[76,"\xB1e"],"\x96"=>[104,"\xB1e"],"\x97"=>[16,"\xB1e"],"\x98"=>[94,"\xB1i"],"\x99"=>[76,"\xB1i"],"\x9A"=>[104,"\xB1i"],"\x9B"=>[16,"\xB1i"],"\x9C"=>[94,"\xB1o"],"\x9D"=>[76,"\xB1o"],"\x9E"=>[104,"\xB1o"],"\x9F"=>[16,"\xB1o"],"\xA0"=>[94,"\xB1s"],"\xA1"=>[76,"\xB1s"],"\xA2"=>[104,"\xB1s"],"\xA3"=>[16,"\xB1s"],"\xA4"=>[94,"\xB1t"],"\xA5"=>[76,"\xB1t"],"\xA6"=>[104,"\xB1t"],"\xA7"=>[16,"\xB1t"],"\xA8"=>[77,"\xB1\x20"],"\xA9"=>[18,"\xB1\x20"],"\xAA"=>[77,"\xB1\x25"],"\xAB"=>[18,"\xB1\x25"],"\xAC"=>[77,"\xB1-"],"\xAD"=>[18,"\xB1-"],"\xAE"=>[77,"\xB1."],"\xAF"=>[18,"\xB1."],"\xB0"=>[77,"\xB1\x2F"],"\xB1"=>[18,"\xB1\x2F"],"\xB2"=>[77,"\xB13"],"\xB3"=>[18,"\xB13"],"\xB4"=>[77,"\xB14"],"\xB5"=>[18,"\xB14"],"\xB6"=>[77,"\xB15"],"\xB7"=>[18,"\xB15"],"\xB8"=>[77,"\xB16"],"\xB9"=>[18,"\xB16"],"\xBA"=>[77,"\xB17"],"\xBB"=>[18,"\xB17"],"\xBC"=>[77,"\xB18"],"\xBD"=>[18,"\xB18"],"\xBE"=>[77,"\xB19"],"\xBF"=>[18,"\xB19"],"\xC0"=>[77,"\xB1\x3D"],"\xC1"=>[18,"\xB1\x3D"],"\xC2"=>[77,"\xB1A"],"\xC3"=>[18,"\xB1A"],"\xC4"=>[77,"\xB1_"],"\xC5"=>[18,"\xB1_"],"\xC6"=>[77,"\xB1b"],"\xC7"=>[18,"\xB1b"],"\xC8"=>[77,"\xB1d"],"\xC9"=>[18,"\xB1d"],"\xCA"=>[77,"\xB1f"],"\xCB"=>[18,"\xB1f"],"\xCC"=>[77,"\xB1g"],"\xCD"=>[18,"\xB1g"],"\xCE"=>[77,"\xB1h"],"\xCF"=>[18,"\xB1h"],"\xD0"=>[77,"\xB1l"],"\xD1"=>[18,"\xB1l"],"\xD2"=>[77,"\xB1m"],"\xD3"=>[18,"\xB1m"],"\xD4"=>[77,"\xB1n"],"\xD5"=>[18,"\xB1n"],"\xD6"=>[77,"\xB1p"],"\xD7"=>[18,"\xB1p"],"\xD8"=>[77,"\xB1r"],"\xD9"=>[18,"\xB1r"],"\xDA"=>[77,"\xB1u"],"\xDB"=>[18,"\xB1u"],"\xDC"=>[0,"\xB1\x3A"],"\xDD"=>[0,"\xB1B"],"\xDE"=>[0,"\xB1C"],"\xDF"=>[0,"\xB1D"],"\xE0"=>[0,"\xB1E"],"\xE1"=>[0,"\xB1F"],"\xE2"=>[0,"\xB1G"],"\xE3"=>[0,"\xB1H"],"\xE4"=>[0,"\xB1I"],"\xE5"=>[0,"\xB1J"],"\xE6"=>[0,"\xB1K"],"\xE7"=>[0,"\xB1L"],"\xE8"=>[0,"\xB1M"],"\xE9"=>[0,"\xB1N"],"\xEA"=>[0,"\xB1O"],"\xEB"=>[0,"\xB1P"],"\xEC"=>[0,"\xB1Q"],"\xED"=>[0,"\xB1R"],"\xEE"=>[0,"\xB1S"],"\xEF"=>[0,"\xB1T"],"\xF0"=>[0,"\xB1U"],"\xF1"=>[0,"\xB1V"],"\xF2"=>[0,"\xB1W"],"\xF3"=>[0,"\xB1Y"],"\xF4"=>[0,"\xB1j"],"\xF5"=>[0,"\xB1k"],"\xF6"=>[0,"\xB1q"],"\xF7"=>[0,"\xB1v"],"\xF8"=>[0,"\xB1w"],"\xF9"=>[0,"\xB1x"],"\xFA"=>[0,"\xB1y"],"\xFB"=>[0,"\xB1z"],"\xFC"=>[82,"\xB1"],"\xFD"=>[87,"\xB1"],"\xFE"=>[130,"\xB1"],"\xFF"=>[9,"\xB1"],],["\x00"=>[77,"\xB00"],"\x01"=>[18,"\xB00"],"\x02"=>[77,"\xB01"],"\x03"=>[18,"\xB01"],"\x04"=>[77,"\xB02"],"\x05"=>[18,"\xB02"],"\x06"=>[77,"\xB0a"],"\x07"=>[18,"\xB0a"],"\x08"=>[77,"\xB0c"],"\x09"=>[18,"\xB0c"],"\x0A"=>[77,"\xB0e"],"\x0B"=>[18,"\xB0e"],"\x0C"=>[77,"\xB0i"],"\x0D"=>[18,"\xB0i"],"\x0E"=>[77,"\xB0o"],"\x0F"=>[18,"\xB0o"],"\x10"=>[77,"\xB0s"],"\x11"=>[18,"\xB0s"],"\x12"=>[77,"\xB0t"],"\x13"=>[18,"\xB0t"],"\x14"=>[0,"\xB0\x20"],"\x15"=>[0,"\xB0\x25"],"\x16"=>[0,"\xB0-"],"\x17"=>[0,"\xB0."],"\x18"=>[0,"\xB0\x2F"],"\x19"=>[0,"\xB03"],"\x1A"=>[0,"\xB04"],"\x1B"=>[0,"\xB05"],"\x1C"=>[0,"\xB06"],"\x1D"=>[0,"\xB07"],"\x1E"=>[0,"\xB08"],"\x1F"=>[0,"\xB09"],"\x20"=>[0,"\xB0\x3D"],"\x21"=>[0,"\xB0A"],"\x22"=>[0,"\xB0_"],"\x23"=>[0,"\xB0b"],"\x24"=>[0,"\xB0d"],"\x25"=>[0,"\xB0f"],"\x26"=>[0,"\xB0g"],"\x27"=>[0,"\xB0h"],"\x28"=>[0,"\xB0l"],"\x29"=>[0,"\xB0m"],"\x2A"=>[0,"\xB0n"],"\x2B"=>[0,"\xB0p"],"\x2C"=>[0,"\xB0r"],"-"=>[0,"\xB0u"],"."=>[100,"\xB0"],"\x2F"=>[110,"\xB0"],[111,"\xB0"],[115,"\xB0"],[116,"\xB0"],[118,"\xB0"],[119,"\xB0"],[122,"\xB0"],[123,"\xB0"],[125,"\xB0"],[126,"\xB0"],[129,"\xB0"],"\x3A"=>[143,"\xB0"],"\x3B"=>[148,"\xB0"],"\x3C"=>[151,"\xB0"],"\x3D"=>[153,"\xB0"],"\x3E"=>[83,"\xB0"],"\x3F"=>[10,"\xB0"],"\x40"=>[77,"\xB10"],"A"=>[18,"\xB10"],"B"=>[77,"\xB11"],"C"=>[18,"\xB11"],"D"=>[77,"\xB12"],"E"=>[18,"\xB12"],"F"=>[77,"\xB1a"],"G"=>[18,"\xB1a"],"H"=>[77,"\xB1c"],"I"=>[18,"\xB1c"],"J"=>[77,"\xB1e"],"K"=>[18,"\xB1e"],"L"=>[77,"\xB1i"],"M"=>[18,"\xB1i"],"N"=>[77,"\xB1o"],"O"=>[18,"\xB1o"],"P"=>[77,"\xB1s"],"Q"=>[18,"\xB1s"],"R"=>[77,"\xB1t"],"S"=>[18,"\xB1t"],"T"=>[0,"\xB1\x20"],"U"=>[0,"\xB1\x25"],"V"=>[0,"\xB1-"],"W"=>[0,"\xB1."],"X"=>[0,"\xB1\x2F"],"Y"=>[0,"\xB13"],"Z"=>[0,"\xB14"],"\x5B"=>[0,"\xB15"],"\x5C"=>[0,"\xB16"],"\x5D"=>[0,"\xB17"],"\x5E"=>[0,"\xB18"],"_"=>[0,"\xB19"],"\x60"=>[0,"\xB1\x3D"],"a"=>[0,"\xB1A"],"b"=>[0,"\xB1_"],"c"=>[0,"\xB1b"],"d"=>[0,"\xB1d"],"e"=>[0,"\xB1f"],"f"=>[0,"\xB1g"],"g"=>[0,"\xB1h"],"h"=>[0,"\xB1l"],"i"=>[0,"\xB1m"],"j"=>[0,"\xB1n"],"k"=>[0,"\xB1p"],"l"=>[0,"\xB1r"],"m"=>[0,"\xB1u"],"n"=>[100,"\xB1"],"o"=>[110,"\xB1"],"p"=>[111,"\xB1"],"q"=>[115,"\xB1"],"r"=>[116,"\xB1"],"s"=>[118,"\xB1"],"t"=>[119,"\xB1"],"u"=>[122,"\xB1"],"v"=>[123,"\xB1"],"w"=>[125,"\xB1"],"x"=>[126,"\xB1"],"y"=>[129,"\xB1"],"z"=>[143,"\xB1"],"\x7B"=>[148,"\xB1"],"\x7C"=>[151,"\xB1"],"\x7D"=>[153,"\xB1"],"~"=>[83,"\xB1"],"\x7F"=>[10,"\xB1"],"\x80"=>[77,"\xB30"],"\x81"=>[18,"\xB30"],"\x82"=>[77,"\xB31"],"\x83"=>[18,"\xB31"],"\x84"=>[77,"\xB32"],"\x85"=>[18,"\xB32"],"\x86"=>[77,"\xB3a"],"\x87"=>[18,"\xB3a"],"\x88"=>[77,"\xB3c"],"\x89"=>[18,"\xB3c"],"\x8A"=>[77,"\xB3e"],"\x8B"=>[18,"\xB3e"],"\x8C"=>[77,"\xB3i"],"\x8D"=>[18,"\xB3i"],"\x8E"=>[77,"\xB3o"],"\x8F"=>[18,"\xB3o"],"\x90"=>[77,"\xB3s"],"\x91"=>[18,"\xB3s"],"\x92"=>[77,"\xB3t"],"\x93"=>[18,"\xB3t"],"\x94"=>[0,"\xB3\x20"],"\x95"=>[0,"\xB3\x25"],"\x96"=>[0,"\xB3-"],"\x97"=>[0,"\xB3."],"\x98"=>[0,"\xB3\x2F"],"\x99"=>[0,"\xB33"],"\x9A"=>[0,"\xB34"],"\x9B"=>[0,"\xB35"],"\x9C"=>[0,"\xB36"],"\x9D"=>[0,"\xB37"],"\x9E"=>[0,"\xB38"],"\x9F"=>[0,"\xB39"],"\xA0"=>[0,"\xB3\x3D"],"\xA1"=>[0,"\xB3A"],"\xA2"=>[0,"\xB3_"],"\xA3"=>[0,"\xB3b"],"\xA4"=>[0,"\xB3d"],"\xA5"=>[0,"\xB3f"],"\xA6"=>[0,"\xB3g"],"\xA7"=>[0,"\xB3h"],"\xA8"=>[0,"\xB3l"],"\xA9"=>[0,"\xB3m"],"\xAA"=>[0,"\xB3n"],"\xAB"=>[0,"\xB3p"],"\xAC"=>[0,"\xB3r"],"\xAD"=>[0,"\xB3u"],"\xAE"=>[100,"\xB3"],"\xAF"=>[110,"\xB3"],"\xB0"=>[111,"\xB3"],"\xB1"=>[115,"\xB3"],"\xB2"=>[116,"\xB3"],"\xB3"=>[118,"\xB3"],"\xB4"=>[119,"\xB3"],"\xB5"=>[122,"\xB3"],"\xB6"=>[123,"\xB3"],"\xB7"=>[125,"\xB3"],"\xB8"=>[126,"\xB3"],"\xB9"=>[129,"\xB3"],"\xBA"=>[143,"\xB3"],"\xBB"=>[148,"\xB3"],"\xBC"=>[151,"\xB3"],"\xBD"=>[153,"\xB3"],"\xBE"=>[83,"\xB3"],"\xBF"=>[10,"\xB3"],"\xC0"=>[77,"\xD10"],"\xC1"=>[18,"\xD10"],"\xC2"=>[77,"\xD11"],"\xC3"=>[18,"\xD11"],"\xC4"=>[77,"\xD12"],"\xC5"=>[18,"\xD12"],"\xC6"=>[77,"\xD1a"],"\xC7"=>[18,"\xD1a"],"\xC8"=>[77,"\xD1c"],"\xC9"=>[18,"\xD1c"],"\xCA"=>[77,"\xD1e"],"\xCB"=>[18,"\xD1e"],"\xCC"=>[77,"\xD1i"],"\xCD"=>[18,"\xD1i"],"\xCE"=>[77,"\xD1o"],"\xCF"=>[18,"\xD1o"],"\xD0"=>[77,"\xD1s"],"\xD1"=>[18,"\xD1s"],"\xD2"=>[77,"\xD1t"],"\xD3"=>[18,"\xD1t"],"\xD4"=>[0,"\xD1\x20"],"\xD5"=>[0,"\xD1\x25"],"\xD6"=>[0,"\xD1-"],"\xD7"=>[0,"\xD1."],"\xD8"=>[0,"\xD1\x2F"],"\xD9"=>[0,"\xD13"],"\xDA"=>[0,"\xD14"],"\xDB"=>[0,"\xD15"],"\xDC"=>[0,"\xD16"],"\xDD"=>[0,"\xD17"],"\xDE"=>[0,"\xD18"],"\xDF"=>[0,"\xD19"],"\xE0"=>[0,"\xD1\x3D"],"\xE1"=>[0,"\xD1A"],"\xE2"=>[0,"\xD1_"],"\xE3"=>[0,"\xD1b"],"\xE4"=>[0,"\xD1d"],"\xE5"=>[0,"\xD1f"],"\xE6"=>[0,"\xD1g"],"\xE7"=>[0,"\xD1h"],"\xE8"=>[0,"\xD1l"],"\xE9"=>[0,"\xD1m"],"\xEA"=>[0,"\xD1n"],"\xEB"=>[0,"\xD1p"],"\xEC"=>[0,"\xD1r"],"\xED"=>[0,"\xD1u"],"\xEE"=>[100,"\xD1"],"\xEF"=>[110,"\xD1"],"\xF0"=>[111,"\xD1"],"\xF1"=>[115,"\xD1"],"\xF2"=>[116,"\xD1"],"\xF3"=>[118,"\xD1"],"\xF4"=>[119,"\xD1"],"\xF5"=>[122,"\xD1"],"\xF6"=>[123,"\xD1"],"\xF7"=>[125,"\xD1"],"\xF8"=>[126,"\xD1"],"\xF9"=>[129,"\xD1"],"\xFA"=>[143,"\xD1"],"\xFB"=>[148,"\xD1"],"\xFC"=>[151,"\xD1"],"\xFD"=>[153,"\xD1"],"\xFE"=>[83,"\xD1"],"\xFF"=>[10,"\xD1"],],["\x00"=>[0,"\xB00"],"\x01"=>[0,"\xB01"],"\x02"=>[0,"\xB02"],"\x03"=>[0,"\xB0a"],"\x04"=>[0,"\xB0c"],"\x05"=>[0,"\xB0e"],"\x06"=>[0,"\xB0i"],"\x07"=>[0,"\xB0o"],"\x08"=>[0,"\xB0s"],"\x09"=>[0,"\xB0t"],"\x0A"=>[73,"\xB0"],"\x0B"=>[88,"\xB0"],"\x0C"=>[89,"\xB0"],"\x0D"=>[96,"\xB0"],"\x0E"=>[97,"\xB0"],"\x0F"=>[99,"\xB0"],"\x10"=>[106,"\xB0"],"\x11"=>[136,"\xB0"],"\x12"=>[139,"\xB0"],"\x13"=>[141,"\xB0"],"\x14"=>[145,"\xB0"],"\x15"=>[147,"\xB0"],"\x16"=>[149,"\xB0"],"\x17"=>[101,"\xB0"],"\x18"=>[112,"\xB0"],"\x19"=>[117,"\xB0"],"\x1A"=>[120,"\xB0"],"\x1B"=>[124,"\xB0"],"\x1C"=>[127,"\xB0"],"\x1D"=>[144,"\xB0"],"\x1E"=>[152,"\xB0"],"\x1F"=>[11,"\xB0"],"\x20"=>[0,"\xB10"],"\x21"=>[0,"\xB11"],"\x22"=>[0,"\xB12"],"\x23"=>[0,"\xB1a"],"\x24"=>[0,"\xB1c"],"\x25"=>[0,"\xB1e"],"\x26"=>[0,"\xB1i"],"\x27"=>[0,"\xB1o"],"\x28"=>[0,"\xB1s"],"\x29"=>[0,"\xB1t"],"\x2A"=>[73,"\xB1"],"\x2B"=>[88,"\xB1"],"\x2C"=>[89,"\xB1"],"-"=>[96,"\xB1"],"."=>[97,"\xB1"],"\x2F"=>[99,"\xB1"],[106,"\xB1"],[136,"\xB1"],[139,"\xB1"],[141,"\xB1"],[145,"\xB1"],[147,"\xB1"],[149,"\xB1"],[101,"\xB1"],[112,"\xB1"],[117,"\xB1"],"\x3A"=>[120,"\xB1"],"\x3B"=>[124,"\xB1"],"\x3C"=>[127,"\xB1"],"\x3D"=>[144,"\xB1"],"\x3E"=>[152,"\xB1"],"\x3F"=>[11,"\xB1"],"\x40"=>[0,"\xB30"],"A"=>[0,"\xB31"],"B"=>[0,"\xB32"],"C"=>[0,"\xB3a"],"D"=>[0,"\xB3c"],"E"=>[0,"\xB3e"],"F"=>[0,"\xB3i"],"G"=>[0,"\xB3o"],"H"=>[0,"\xB3s"],"I"=>[0,"\xB3t"],"J"=>[73,"\xB3"],"K"=>[88,"\xB3"],"L"=>[89,"\xB3"],"M"=>[96,"\xB3"],"N"=>[97,"\xB3"],"O"=>[99,"\xB3"],"P"=>[106,"\xB3"],"Q"=>[136,"\xB3"],"R"=>[139,"\xB3"],"S"=>[141,"\xB3"],"T"=>[145,"\xB3"],"U"=>[147,"\xB3"],"V"=>[149,"\xB3"],"W"=>[101,"\xB3"],"X"=>[112,"\xB3"],"Y"=>[117,"\xB3"],"Z"=>[120,"\xB3"],"\x5B"=>[124,"\xB3"],"\x5C"=>[127,"\xB3"],"\x5D"=>[144,"\xB3"],"\x5E"=>[152,"\xB3"],"_"=>[11,"\xB3"],"\x60"=>[0,"\xD10"],"a"=>[0,"\xD11"],"b"=>[0,"\xD12"],"c"=>[0,"\xD1a"],"d"=>[0,"\xD1c"],"e"=>[0,"\xD1e"],"f"=>[0,"\xD1i"],"g"=>[0,"\xD1o"],"h"=>[0,"\xD1s"],"i"=>[0,"\xD1t"],"j"=>[73,"\xD1"],"k"=>[88,"\xD1"],"l"=>[89,"\xD1"],"m"=>[96,"\xD1"],"n"=>[97,"\xD1"],"o"=>[99,"\xD1"],"p"=>[106,"\xD1"],"q"=>[136,"\xD1"],"r"=>[139,"\xD1"],"s"=>[141,"\xD1"],"t"=>[145,"\xD1"],"u"=>[147,"\xD1"],"v"=>[149,"\xD1"],"w"=>[101,"\xD1"],"x"=>[112,"\xD1"],"y"=>[117,"\xD1"],"z"=>[120,"\xD1"],"\x7B"=>[124,"\xD1"],"\x7C"=>[127,"\xD1"],"\x7D"=>[144,"\xD1"],"~"=>[152,"\xD1"],"\x7F"=>[11,"\xD1"],"\x80"=>[0,"\xD80"],"\x81"=>[0,"\xD81"],"\x82"=>[0,"\xD82"],"\x83"=>[0,"\xD8a"],"\x84"=>[0,"\xD8c"],"\x85"=>[0,"\xD8e"],"\x86"=>[0,"\xD8i"],"\x87"=>[0,"\xD8o"],"\x88"=>[0,"\xD8s"],"\x89"=>[0,"\xD8t"],"\x8A"=>[73,"\xD8"],"\x8B"=>[88,"\xD8"],"\x8C"=>[89,"\xD8"],"\x8D"=>[96,"\xD8"],"\x8E"=>[97,"\xD8"],"\x8F"=>[99,"\xD8"],"\x90"=>[106,"\xD8"],"\x91"=>[136,"\xD8"],"\x92"=>[139,"\xD8"],"\x93"=>[141,"\xD8"],"\x94"=>[145,"\xD8"],"\x95"=>[147,"\xD8"],"\x96"=>[149,"\xD8"],"\x97"=>[101,"\xD8"],"\x98"=>[112,"\xD8"],"\x99"=>[117,"\xD8"],"\x9A"=>[120,"\xD8"],"\x9B"=>[124,"\xD8"],"\x9C"=>[127,"\xD8"],"\x9D"=>[144,"\xD8"],"\x9E"=>[152,"\xD8"],"\x9F"=>[11,"\xD8"],"\xA0"=>[0,"\xD90"],"\xA1"=>[0,"\xD91"],"\xA2"=>[0,"\xD92"],"\xA3"=>[0,"\xD9a"],"\xA4"=>[0,"\xD9c"],"\xA5"=>[0,"\xD9e"],"\xA6"=>[0,"\xD9i"],"\xA7"=>[0,"\xD9o"],"\xA8"=>[0,"\xD9s"],"\xA9"=>[0,"\xD9t"],"\xAA"=>[73,"\xD9"],"\xAB"=>[88,"\xD9"],"\xAC"=>[89,"\xD9"],"\xAD"=>[96,"\xD9"],"\xAE"=>[97,"\xD9"],"\xAF"=>[99,"\xD9"],"\xB0"=>[106,"\xD9"],"\xB1"=>[136,"\xD9"],"\xB2"=>[139,"\xD9"],"\xB3"=>[141,"\xD9"],"\xB4"=>[145,"\xD9"],"\xB5"=>[147,"\xD9"],"\xB6"=>[149,"\xD9"],"\xB7"=>[101,"\xD9"],"\xB8"=>[112,"\xD9"],"\xB9"=>[117,"\xD9"],"\xBA"=>[120,"\xD9"],"\xBB"=>[124,"\xD9"],"\xBC"=>[127,"\xD9"],"\xBD"=>[144,"\xD9"],"\xBE"=>[152,"\xD9"],"\xBF"=>[11,"\xD9"],"\xC0"=>[0,"\xE30"],"\xC1"=>[0,"\xE31"],"\xC2"=>[0,"\xE32"],"\xC3"=>[0,"\xE3a"],"\xC4"=>[0,"\xE3c"],"\xC5"=>[0,"\xE3e"],"\xC6"=>[0,"\xE3i"],"\xC7"=>[0,"\xE3o"],"\xC8"=>[0,"\xE3s"],"\xC9"=>[0,"\xE3t"],"\xCA"=>[73,"\xE3"],"\xCB"=>[88,"\xE3"],"\xCC"=>[89,"\xE3"],"\xCD"=>[96,"\xE3"],"\xCE"=>[97,"\xE3"],"\xCF"=>[99,"\xE3"],"\xD0"=>[106,"\xE3"],"\xD1"=>[136,"\xE3"],"\xD2"=>[139,"\xE3"],"\xD3"=>[141,"\xE3"],"\xD4"=>[145,"\xE3"],"\xD5"=>[147,"\xE3"],"\xD6"=>[149,"\xE3"],"\xD7"=>[101,"\xE3"],"\xD8"=>[112,"\xE3"],"\xD9"=>[117,"\xE3"],"\xDA"=>[120,"\xE3"],"\xDB"=>[124,"\xE3"],"\xDC"=>[127,"\xE3"],"\xDD"=>[144,"\xE3"],"\xDE"=>[152,"\xE3"],"\xDF"=>[11,"\xE3"],"\xE0"=>[0,"\xE50"],"\xE1"=>[0,"\xE51"],"\xE2"=>[0,"\xE52"],"\xE3"=>[0,"\xE5a"],"\xE4"=>[0,"\xE5c"],"\xE5"=>[0,"\xE5e"],"\xE6"=>[0,"\xE5i"],"\xE7"=>[0,"\xE5o"],"\xE8"=>[0,"\xE5s"],"\xE9"=>[0,"\xE5t"],"\xEA"=>[73,"\xE5"],"\xEB"=>[88,"\xE5"],"\xEC"=>[89,"\xE5"],"\xED"=>[96,"\xE5"],"\xEE"=>[97,"\xE5"],"\xEF"=>[99,"\xE5"],"\xF0"=>[106,"\xE5"],"\xF1"=>[136,"\xE5"],"\xF2"=>[139,"\xE5"],"\xF3"=>[141,"\xE5"],"\xF4"=>[145,"\xE5"],"\xF5"=>[147,"\xE5"],"\xF6"=>[149,"\xE5"],"\xF7"=>[101,"\xE5"],"\xF8"=>[112,"\xE5"],"\xF9"=>[117,"\xE5"],"\xFA"=>[120,"\xE5"],"\xFB"=>[124,"\xE5"],"\xFC"=>[127,"\xE5"],"\xFD"=>[144,"\xE5"],"\xFE"=>[152,"\xE5"],"\xFF"=>[11,"\xE5"],],["\x00"=>[94,"\xB20"],"\x01"=>[76,"\xB20"],"\x02"=>[104,"\xB20"],"\x03"=>[16,"\xB20"],"\x04"=>[94,"\xB21"],"\x05"=>[76,"\xB21"],"\x06"=>[104,"\xB21"],"\x07"=>[16,"\xB21"],"\x08"=>[94,"\xB22"],"\x09"=>[76,"\xB22"],"\x0A"=>[104,"\xB22"],"\x0B"=>[16,"\xB22"],"\x0C"=>[94,"\xB2a"],"\x0D"=>[76,"\xB2a"],"\x0E"=>[104,"\xB2a"],"\x0F"=>[16,"\xB2a"],"\x10"=>[94,"\xB2c"],"\x11"=>[76,"\xB2c"],"\x12"=>[104,"\xB2c"],"\x13"=>[16,"\xB2c"],"\x14"=>[94,"\xB2e"],"\x15"=>[76,"\xB2e"],"\x16"=>[104,"\xB2e"],"\x17"=>[16,"\xB2e"],"\x18"=>[94,"\xB2i"],"\x19"=>[76,"\xB2i"],"\x1A"=>[104,"\xB2i"],"\x1B"=>[16,"\xB2i"],"\x1C"=>[94,"\xB2o"],"\x1D"=>[76,"\xB2o"],"\x1E"=>[104,"\xB2o"],"\x1F"=>[16,"\xB2o"],"\x20"=>[94,"\xB2s"],"\x21"=>[76,"\xB2s"],"\x22"=>[104,"\xB2s"],"\x23"=>[16,"\xB2s"],"\x24"=>[94,"\xB2t"],"\x25"=>[76,"\xB2t"],"\x26"=>[104,"\xB2t"],"\x27"=>[16,"\xB2t"],"\x28"=>[77,"\xB2\x20"],"\x29"=>[18,"\xB2\x20"],"\x2A"=>[77,"\xB2\x25"],"\x2B"=>[18,"\xB2\x25"],"\x2C"=>[77,"\xB2-"],"-"=>[18,"\xB2-"],"."=>[77,"\xB2."],"\x2F"=>[18,"\xB2."],[77,"\xB2\x2F"],[18,"\xB2\x2F"],[77,"\xB23"],[18,"\xB23"],[77,"\xB24"],[18,"\xB24"],[77,"\xB25"],[18,"\xB25"],[77,"\xB26"],[18,"\xB26"],"\x3A"=>[77,"\xB27"],"\x3B"=>[18,"\xB27"],"\x3C"=>[77,"\xB28"],"\x3D"=>[18,"\xB28"],"\x3E"=>[77,"\xB29"],"\x3F"=>[18,"\xB29"],"\x40"=>[77,"\xB2\x3D"],"A"=>[18,"\xB2\x3D"],"B"=>[77,"\xB2A"],"C"=>[18,"\xB2A"],"D"=>[77,"\xB2_"],"E"=>[18,"\xB2_"],"F"=>[77,"\xB2b"],"G"=>[18,"\xB2b"],"H"=>[77,"\xB2d"],"I"=>[18,"\xB2d"],"J"=>[77,"\xB2f"],"K"=>[18,"\xB2f"],"L"=>[77,"\xB2g"],"M"=>[18,"\xB2g"],"N"=>[77,"\xB2h"],"O"=>[18,"\xB2h"],"P"=>[77,"\xB2l"],"Q"=>[18,"\xB2l"],"R"=>[77,"\xB2m"],"S"=>[18,"\xB2m"],"T"=>[77,"\xB2n"],"U"=>[18,"\xB2n"],"V"=>[77,"\xB2p"],"W"=>[18,"\xB2p"],"X"=>[77,"\xB2r"],"Y"=>[18,"\xB2r"],"Z"=>[77,"\xB2u"],"\x5B"=>[18,"\xB2u"],"\x5C"=>[0,"\xB2\x3A"],"\x5D"=>[0,"\xB2B"],"\x5E"=>[0,"\xB2C"],"_"=>[0,"\xB2D"],"\x60"=>[0,"\xB2E"],"a"=>[0,"\xB2F"],"b"=>[0,"\xB2G"],"c"=>[0,"\xB2H"],"d"=>[0,"\xB2I"],"e"=>[0,"\xB2J"],"f"=>[0,"\xB2K"],"g"=>[0,"\xB2L"],"h"=>[0,"\xB2M"],"i"=>[0,"\xB2N"],"j"=>[0,"\xB2O"],"k"=>[0,"\xB2P"],"l"=>[0,"\xB2Q"],"m"=>[0,"\xB2R"],"n"=>[0,"\xB2S"],"o"=>[0,"\xB2T"],"p"=>[0,"\xB2U"],"q"=>[0,"\xB2V"],"r"=>[0,"\xB2W"],"s"=>[0,"\xB2Y"],"t"=>[0,"\xB2j"],"u"=>[0,"\xB2k"],"v"=>[0,"\xB2q"],"w"=>[0,"\xB2v"],"x"=>[0,"\xB2w"],"y"=>[0,"\xB2x"],"z"=>[0,"\xB2y"],"\x7B"=>[0,"\xB2z"],"\x7C"=>[82,"\xB2"],"\x7D"=>[87,"\xB2"],"~"=>[130,"\xB2"],"\x7F"=>[9,"\xB2"],"\x80"=>[94,"\xB50"],"\x81"=>[76,"\xB50"],"\x82"=>[104,"\xB50"],"\x83"=>[16,"\xB50"],"\x84"=>[94,"\xB51"],"\x85"=>[76,"\xB51"],"\x86"=>[104,"\xB51"],"\x87"=>[16,"\xB51"],"\x88"=>[94,"\xB52"],"\x89"=>[76,"\xB52"],"\x8A"=>[104,"\xB52"],"\x8B"=>[16,"\xB52"],"\x8C"=>[94,"\xB5a"],"\x8D"=>[76,"\xB5a"],"\x8E"=>[104,"\xB5a"],"\x8F"=>[16,"\xB5a"],"\x90"=>[94,"\xB5c"],"\x91"=>[76,"\xB5c"],"\x92"=>[104,"\xB5c"],"\x93"=>[16,"\xB5c"],"\x94"=>[94,"\xB5e"],"\x95"=>[76,"\xB5e"],"\x96"=>[104,"\xB5e"],"\x97"=>[16,"\xB5e"],"\x98"=>[94,"\xB5i"],"\x99"=>[76,"\xB5i"],"\x9A"=>[104,"\xB5i"],"\x9B"=>[16,"\xB5i"],"\x9C"=>[94,"\xB5o"],"\x9D"=>[76,"\xB5o"],"\x9E"=>[104,"\xB5o"],"\x9F"=>[16,"\xB5o"],"\xA0"=>[94,"\xB5s"],"\xA1"=>[76,"\xB5s"],"\xA2"=>[104,"\xB5s"],"\xA3"=>[16,"\xB5s"],"\xA4"=>[94,"\xB5t"],"\xA5"=>[76,"\xB5t"],"\xA6"=>[104,"\xB5t"],"\xA7"=>[16,"\xB5t"],"\xA8"=>[77,"\xB5\x20"],"\xA9"=>[18,"\xB5\x20"],"\xAA"=>[77,"\xB5\x25"],"\xAB"=>[18,"\xB5\x25"],"\xAC"=>[77,"\xB5-"],"\xAD"=>[18,"\xB5-"],"\xAE"=>[77,"\xB5."],"\xAF"=>[18,"\xB5."],"\xB0"=>[77,"\xB5\x2F"],"\xB1"=>[18,"\xB5\x2F"],"\xB2"=>[77,"\xB53"],"\xB3"=>[18,"\xB53"],"\xB4"=>[77,"\xB54"],"\xB5"=>[18,"\xB54"],"\xB6"=>[77,"\xB55"],"\xB7"=>[18,"\xB55"],"\xB8"=>[77,"\xB56"],"\xB9"=>[18,"\xB56"],"\xBA"=>[77,"\xB57"],"\xBB"=>[18,"\xB57"],"\xBC"=>[77,"\xB58"],"\xBD"=>[18,"\xB58"],"\xBE"=>[77,"\xB59"],"\xBF"=>[18,"\xB59"],"\xC0"=>[77,"\xB5\x3D"],"\xC1"=>[18,"\xB5\x3D"],"\xC2"=>[77,"\xB5A"],"\xC3"=>[18,"\xB5A"],"\xC4"=>[77,"\xB5_"],"\xC5"=>[18,"\xB5_"],"\xC6"=>[77,"\xB5b"],"\xC7"=>[18,"\xB5b"],"\xC8"=>[77,"\xB5d"],"\xC9"=>[18,"\xB5d"],"\xCA"=>[77,"\xB5f"],"\xCB"=>[18,"\xB5f"],"\xCC"=>[77,"\xB5g"],"\xCD"=>[18,"\xB5g"],"\xCE"=>[77,"\xB5h"],"\xCF"=>[18,"\xB5h"],"\xD0"=>[77,"\xB5l"],"\xD1"=>[18,"\xB5l"],"\xD2"=>[77,"\xB5m"],"\xD3"=>[18,"\xB5m"],"\xD4"=>[77,"\xB5n"],"\xD5"=>[18,"\xB5n"],"\xD6"=>[77,"\xB5p"],"\xD7"=>[18,"\xB5p"],"\xD8"=>[77,"\xB5r"],"\xD9"=>[18,"\xB5r"],"\xDA"=>[77,"\xB5u"],"\xDB"=>[18,"\xB5u"],"\xDC"=>[0,"\xB5\x3A"],"\xDD"=>[0,"\xB5B"],"\xDE"=>[0,"\xB5C"],"\xDF"=>[0,"\xB5D"],"\xE0"=>[0,"\xB5E"],"\xE1"=>[0,"\xB5F"],"\xE2"=>[0,"\xB5G"],"\xE3"=>[0,"\xB5H"],"\xE4"=>[0,"\xB5I"],"\xE5"=>[0,"\xB5J"],"\xE6"=>[0,"\xB5K"],"\xE7"=>[0,"\xB5L"],"\xE8"=>[0,"\xB5M"],"\xE9"=>[0,"\xB5N"],"\xEA"=>[0,"\xB5O"],"\xEB"=>[0,"\xB5P"],"\xEC"=>[0,"\xB5Q"],"\xED"=>[0,"\xB5R"],"\xEE"=>[0,"\xB5S"],"\xEF"=>[0,"\xB5T"],"\xF0"=>[0,"\xB5U"],"\xF1"=>[0,"\xB5V"],"\xF2"=>[0,"\xB5W"],"\xF3"=>[0,"\xB5Y"],"\xF4"=>[0,"\xB5j"],"\xF5"=>[0,"\xB5k"],"\xF6"=>[0,"\xB5q"],"\xF7"=>[0,"\xB5v"],"\xF8"=>[0,"\xB5w"],"\xF9"=>[0,"\xB5x"],"\xFA"=>[0,"\xB5y"],"\xFB"=>[0,"\xB5z"],"\xFC"=>[82,"\xB5"],"\xFD"=>[87,"\xB5"],"\xFE"=>[130,"\xB5"],"\xFF"=>[9,"\xB5"],],["\x00"=>[77,"\xB20"],"\x01"=>[18,"\xB20"],"\x02"=>[77,"\xB21"],"\x03"=>[18,"\xB21"],"\x04"=>[77,"\xB22"],"\x05"=>[18,"\xB22"],"\x06"=>[77,"\xB2a"],"\x07"=>[18,"\xB2a"],"\x08"=>[77,"\xB2c"],"\x09"=>[18,"\xB2c"],"\x0A"=>[77,"\xB2e"],"\x0B"=>[18,"\xB2e"],"\x0C"=>[77,"\xB2i"],"\x0D"=>[18,"\xB2i"],"\x0E"=>[77,"\xB2o"],"\x0F"=>[18,"\xB2o"],"\x10"=>[77,"\xB2s"],"\x11"=>[18,"\xB2s"],"\x12"=>[77,"\xB2t"],"\x13"=>[18,"\xB2t"],"\x14"=>[0,"\xB2\x20"],"\x15"=>[0,"\xB2\x25"],"\x16"=>[0,"\xB2-"],"\x17"=>[0,"\xB2."],"\x18"=>[0,"\xB2\x2F"],"\x19"=>[0,"\xB23"],"\x1A"=>[0,"\xB24"],"\x1B"=>[0,"\xB25"],"\x1C"=>[0,"\xB26"],"\x1D"=>[0,"\xB27"],"\x1E"=>[0,"\xB28"],"\x1F"=>[0,"\xB29"],"\x20"=>[0,"\xB2\x3D"],"\x21"=>[0,"\xB2A"],"\x22"=>[0,"\xB2_"],"\x23"=>[0,"\xB2b"],"\x24"=>[0,"\xB2d"],"\x25"=>[0,"\xB2f"],"\x26"=>[0,"\xB2g"],"\x27"=>[0,"\xB2h"],"\x28"=>[0,"\xB2l"],"\x29"=>[0,"\xB2m"],"\x2A"=>[0,"\xB2n"],"\x2B"=>[0,"\xB2p"],"\x2C"=>[0,"\xB2r"],"-"=>[0,"\xB2u"],"."=>[100,"\xB2"],"\x2F"=>[110,"\xB2"],[111,"\xB2"],[115,"\xB2"],[116,"\xB2"],[118,"\xB2"],[119,"\xB2"],[122,"\xB2"],[123,"\xB2"],[125,"\xB2"],[126,"\xB2"],[129,"\xB2"],"\x3A"=>[143,"\xB2"],"\x3B"=>[148,"\xB2"],"\x3C"=>[151,"\xB2"],"\x3D"=>[153,"\xB2"],"\x3E"=>[83,"\xB2"],"\x3F"=>[10,"\xB2"],"\x40"=>[77,"\xB50"],"A"=>[18,"\xB50"],"B"=>[77,"\xB51"],"C"=>[18,"\xB51"],"D"=>[77,"\xB52"],"E"=>[18,"\xB52"],"F"=>[77,"\xB5a"],"G"=>[18,"\xB5a"],"H"=>[77,"\xB5c"],"I"=>[18,"\xB5c"],"J"=>[77,"\xB5e"],"K"=>[18,"\xB5e"],"L"=>[77,"\xB5i"],"M"=>[18,"\xB5i"],"N"=>[77,"\xB5o"],"O"=>[18,"\xB5o"],"P"=>[77,"\xB5s"],"Q"=>[18,"\xB5s"],"R"=>[77,"\xB5t"],"S"=>[18,"\xB5t"],"T"=>[0,"\xB5\x20"],"U"=>[0,"\xB5\x25"],"V"=>[0,"\xB5-"],"W"=>[0,"\xB5."],"X"=>[0,"\xB5\x2F"],"Y"=>[0,"\xB53"],"Z"=>[0,"\xB54"],"\x5B"=>[0,"\xB55"],"\x5C"=>[0,"\xB56"],"\x5D"=>[0,"\xB57"],"\x5E"=>[0,"\xB58"],"_"=>[0,"\xB59"],"\x60"=>[0,"\xB5\x3D"],"a"=>[0,"\xB5A"],"b"=>[0,"\xB5_"],"c"=>[0,"\xB5b"],"d"=>[0,"\xB5d"],"e"=>[0,"\xB5f"],"f"=>[0,"\xB5g"],"g"=>[0,"\xB5h"],"h"=>[0,"\xB5l"],"i"=>[0,"\xB5m"],"j"=>[0,"\xB5n"],"k"=>[0,"\xB5p"],"l"=>[0,"\xB5r"],"m"=>[0,"\xB5u"],"n"=>[100,"\xB5"],"o"=>[110,"\xB5"],"p"=>[111,"\xB5"],"q"=>[115,"\xB5"],"r"=>[116,"\xB5"],"s"=>[118,"\xB5"],"t"=>[119,"\xB5"],"u"=>[122,"\xB5"],"v"=>[123,"\xB5"],"w"=>[125,"\xB5"],"x"=>[126,"\xB5"],"y"=>[129,"\xB5"],"z"=>[143,"\xB5"],"\x7B"=>[148,"\xB5"],"\x7C"=>[151,"\xB5"],"\x7D"=>[153,"\xB5"],"~"=>[83,"\xB5"],"\x7F"=>[10,"\xB5"],"\x80"=>[77,"\xB90"],"\x81"=>[18,"\xB90"],"\x82"=>[77,"\xB91"],"\x83"=>[18,"\xB91"],"\x84"=>[77,"\xB92"],"\x85"=>[18,"\xB92"],"\x86"=>[77,"\xB9a"],"\x87"=>[18,"\xB9a"],"\x88"=>[77,"\xB9c"],"\x89"=>[18,"\xB9c"],"\x8A"=>[77,"\xB9e"],"\x8B"=>[18,"\xB9e"],"\x8C"=>[77,"\xB9i"],"\x8D"=>[18,"\xB9i"],"\x8E"=>[77,"\xB9o"],"\x8F"=>[18,"\xB9o"],"\x90"=>[77,"\xB9s"],"\x91"=>[18,"\xB9s"],"\x92"=>[77,"\xB9t"],"\x93"=>[18,"\xB9t"],"\x94"=>[0,"\xB9\x20"],"\x95"=>[0,"\xB9\x25"],"\x96"=>[0,"\xB9-"],"\x97"=>[0,"\xB9."],"\x98"=>[0,"\xB9\x2F"],"\x99"=>[0,"\xB93"],"\x9A"=>[0,"\xB94"],"\x9B"=>[0,"\xB95"],"\x9C"=>[0,"\xB96"],"\x9D"=>[0,"\xB97"],"\x9E"=>[0,"\xB98"],"\x9F"=>[0,"\xB99"],"\xA0"=>[0,"\xB9\x3D"],"\xA1"=>[0,"\xB9A"],"\xA2"=>[0,"\xB9_"],"\xA3"=>[0,"\xB9b"],"\xA4"=>[0,"\xB9d"],"\xA5"=>[0,"\xB9f"],"\xA6"=>[0,"\xB9g"],"\xA7"=>[0,"\xB9h"],"\xA8"=>[0,"\xB9l"],"\xA9"=>[0,"\xB9m"],"\xAA"=>[0,"\xB9n"],"\xAB"=>[0,"\xB9p"],"\xAC"=>[0,"\xB9r"],"\xAD"=>[0,"\xB9u"],"\xAE"=>[100,"\xB9"],"\xAF"=>[110,"\xB9"],"\xB0"=>[111,"\xB9"],"\xB1"=>[115,"\xB9"],"\xB2"=>[116,"\xB9"],"\xB3"=>[118,"\xB9"],"\xB4"=>[119,"\xB9"],"\xB5"=>[122,"\xB9"],"\xB6"=>[123,"\xB9"],"\xB7"=>[125,"\xB9"],"\xB8"=>[126,"\xB9"],"\xB9"=>[129,"\xB9"],"\xBA"=>[143,"\xB9"],"\xBB"=>[148,"\xB9"],"\xBC"=>[151,"\xB9"],"\xBD"=>[153,"\xB9"],"\xBE"=>[83,"\xB9"],"\xBF"=>[10,"\xB9"],"\xC0"=>[77,"\xBA0"],"\xC1"=>[18,"\xBA0"],"\xC2"=>[77,"\xBA1"],"\xC3"=>[18,"\xBA1"],"\xC4"=>[77,"\xBA2"],"\xC5"=>[18,"\xBA2"],"\xC6"=>[77,"\xBAa"],"\xC7"=>[18,"\xBAa"],"\xC8"=>[77,"\xBAc"],"\xC9"=>[18,"\xBAc"],"\xCA"=>[77,"\xBAe"],"\xCB"=>[18,"\xBAe"],"\xCC"=>[77,"\xBAi"],"\xCD"=>[18,"\xBAi"],"\xCE"=>[77,"\xBAo"],"\xCF"=>[18,"\xBAo"],"\xD0"=>[77,"\xBAs"],"\xD1"=>[18,"\xBAs"],"\xD2"=>[77,"\xBAt"],"\xD3"=>[18,"\xBAt"],"\xD4"=>[0,"\xBA\x20"],"\xD5"=>[0,"\xBA\x25"],"\xD6"=>[0,"\xBA-"],"\xD7"=>[0,"\xBA."],"\xD8"=>[0,"\xBA\x2F"],"\xD9"=>[0,"\xBA3"],"\xDA"=>[0,"\xBA4"],"\xDB"=>[0,"\xBA5"],"\xDC"=>[0,"\xBA6"],"\xDD"=>[0,"\xBA7"],"\xDE"=>[0,"\xBA8"],"\xDF"=>[0,"\xBA9"],"\xE0"=>[0,"\xBA\x3D"],"\xE1"=>[0,"\xBAA"],"\xE2"=>[0,"\xBA_"],"\xE3"=>[0,"\xBAb"],"\xE4"=>[0,"\xBAd"],"\xE5"=>[0,"\xBAf"],"\xE6"=>[0,"\xBAg"],"\xE7"=>[0,"\xBAh"],"\xE8"=>[0,"\xBAl"],"\xE9"=>[0,"\xBAm"],"\xEA"=>[0,"\xBAn"],"\xEB"=>[0,"\xBAp"],"\xEC"=>[0,"\xBAr"],"\xED"=>[0,"\xBAu"],"\xEE"=>[100,"\xBA"],"\xEF"=>[110,"\xBA"],"\xF0"=>[111,"\xBA"],"\xF1"=>[115,"\xBA"],"\xF2"=>[116,"\xBA"],"\xF3"=>[118,"\xBA"],"\xF4"=>[119,"\xBA"],"\xF5"=>[122,"\xBA"],"\xF6"=>[123,"\xBA"],"\xF7"=>[125,"\xBA"],"\xF8"=>[126,"\xBA"],"\xF9"=>[129,"\xBA"],"\xFA"=>[143,"\xBA"],"\xFB"=>[148,"\xBA"],"\xFC"=>[151,"\xBA"],"\xFD"=>[153,"\xBA"],"\xFE"=>[83,"\xBA"],"\xFF"=>[10,"\xBA"],],["\x00"=>[0,"\xB20"],"\x01"=>[0,"\xB21"],"\x02"=>[0,"\xB22"],"\x03"=>[0,"\xB2a"],"\x04"=>[0,"\xB2c"],"\x05"=>[0,"\xB2e"],"\x06"=>[0,"\xB2i"],"\x07"=>[0,"\xB2o"],"\x08"=>[0,"\xB2s"],"\x09"=>[0,"\xB2t"],"\x0A"=>[73,"\xB2"],"\x0B"=>[88,"\xB2"],"\x0C"=>[89,"\xB2"],"\x0D"=>[96,"\xB2"],"\x0E"=>[97,"\xB2"],"\x0F"=>[99,"\xB2"],"\x10"=>[106,"\xB2"],"\x11"=>[136,"\xB2"],"\x12"=>[139,"\xB2"],"\x13"=>[141,"\xB2"],"\x14"=>[145,"\xB2"],"\x15"=>[147,"\xB2"],"\x16"=>[149,"\xB2"],"\x17"=>[101,"\xB2"],"\x18"=>[112,"\xB2"],"\x19"=>[117,"\xB2"],"\x1A"=>[120,"\xB2"],"\x1B"=>[124,"\xB2"],"\x1C"=>[127,"\xB2"],"\x1D"=>[144,"\xB2"],"\x1E"=>[152,"\xB2"],"\x1F"=>[11,"\xB2"],"\x20"=>[0,"\xB50"],"\x21"=>[0,"\xB51"],"\x22"=>[0,"\xB52"],"\x23"=>[0,"\xB5a"],"\x24"=>[0,"\xB5c"],"\x25"=>[0,"\xB5e"],"\x26"=>[0,"\xB5i"],"\x27"=>[0,"\xB5o"],"\x28"=>[0,"\xB5s"],"\x29"=>[0,"\xB5t"],"\x2A"=>[73,"\xB5"],"\x2B"=>[88,"\xB5"],"\x2C"=>[89,"\xB5"],"-"=>[96,"\xB5"],"."=>[97,"\xB5"],"\x2F"=>[99,"\xB5"],[106,"\xB5"],[136,"\xB5"],[139,"\xB5"],[141,"\xB5"],[145,"\xB5"],[147,"\xB5"],[149,"\xB5"],[101,"\xB5"],[112,"\xB5"],[117,"\xB5"],"\x3A"=>[120,"\xB5"],"\x3B"=>[124,"\xB5"],"\x3C"=>[127,"\xB5"],"\x3D"=>[144,"\xB5"],"\x3E"=>[152,"\xB5"],"\x3F"=>[11,"\xB5"],"\x40"=>[0,"\xB90"],"A"=>[0,"\xB91"],"B"=>[0,"\xB92"],"C"=>[0,"\xB9a"],"D"=>[0,"\xB9c"],"E"=>[0,"\xB9e"],"F"=>[0,"\xB9i"],"G"=>[0,"\xB9o"],"H"=>[0,"\xB9s"],"I"=>[0,"\xB9t"],"J"=>[73,"\xB9"],"K"=>[88,"\xB9"],"L"=>[89,"\xB9"],"M"=>[96,"\xB9"],"N"=>[97,"\xB9"],"O"=>[99,"\xB9"],"P"=>[106,"\xB9"],"Q"=>[136,"\xB9"],"R"=>[139,"\xB9"],"S"=>[141,"\xB9"],"T"=>[145,"\xB9"],"U"=>[147,"\xB9"],"V"=>[149,"\xB9"],"W"=>[101,"\xB9"],"X"=>[112,"\xB9"],"Y"=>[117,"\xB9"],"Z"=>[120,"\xB9"],"\x5B"=>[124,"\xB9"],"\x5C"=>[127,"\xB9"],"\x5D"=>[144,"\xB9"],"\x5E"=>[152,"\xB9"],"_"=>[11,"\xB9"],"\x60"=>[0,"\xBA0"],"a"=>[0,"\xBA1"],"b"=>[0,"\xBA2"],"c"=>[0,"\xBAa"],"d"=>[0,"\xBAc"],"e"=>[0,"\xBAe"],"f"=>[0,"\xBAi"],"g"=>[0,"\xBAo"],"h"=>[0,"\xBAs"],"i"=>[0,"\xBAt"],"j"=>[73,"\xBA"],"k"=>[88,"\xBA"],"l"=>[89,"\xBA"],"m"=>[96,"\xBA"],"n"=>[97,"\xBA"],"o"=>[99,"\xBA"],"p"=>[106,"\xBA"],"q"=>[136,"\xBA"],"r"=>[139,"\xBA"],"s"=>[141,"\xBA"],"t"=>[145,"\xBA"],"u"=>[147,"\xBA"],"v"=>[149,"\xBA"],"w"=>[101,"\xBA"],"x"=>[112,"\xBA"],"y"=>[117,"\xBA"],"z"=>[120,"\xBA"],"\x7B"=>[124,"\xBA"],"\x7C"=>[127,"\xBA"],"\x7D"=>[144,"\xBA"],"~"=>[152,"\xBA"],"\x7F"=>[11,"\xBA"],"\x80"=>[0,"\xBB0"],"\x81"=>[0,"\xBB1"],"\x82"=>[0,"\xBB2"],"\x83"=>[0,"\xBBa"],"\x84"=>[0,"\xBBc"],"\x85"=>[0,"\xBBe"],"\x86"=>[0,"\xBBi"],"\x87"=>[0,"\xBBo"],"\x88"=>[0,"\xBBs"],"\x89"=>[0,"\xBBt"],"\x8A"=>[73,"\xBB"],"\x8B"=>[88,"\xBB"],"\x8C"=>[89,"\xBB"],"\x8D"=>[96,"\xBB"],"\x8E"=>[97,"\xBB"],"\x8F"=>[99,"\xBB"],"\x90"=>[106,"\xBB"],"\x91"=>[136,"\xBB"],"\x92"=>[139,"\xBB"],"\x93"=>[141,"\xBB"],"\x94"=>[145,"\xBB"],"\x95"=>[147,"\xBB"],"\x96"=>[149,"\xBB"],"\x97"=>[101,"\xBB"],"\x98"=>[112,"\xBB"],"\x99"=>[117,"\xBB"],"\x9A"=>[120,"\xBB"],"\x9B"=>[124,"\xBB"],"\x9C"=>[127,"\xBB"],"\x9D"=>[144,"\xBB"],"\x9E"=>[152,"\xBB"],"\x9F"=>[11,"\xBB"],"\xA0"=>[0,"\xBD0"],"\xA1"=>[0,"\xBD1"],"\xA2"=>[0,"\xBD2"],"\xA3"=>[0,"\xBDa"],"\xA4"=>[0,"\xBDc"],"\xA5"=>[0,"\xBDe"],"\xA6"=>[0,"\xBDi"],"\xA7"=>[0,"\xBDo"],"\xA8"=>[0,"\xBDs"],"\xA9"=>[0,"\xBDt"],"\xAA"=>[73,"\xBD"],"\xAB"=>[88,"\xBD"],"\xAC"=>[89,"\xBD"],"\xAD"=>[96,"\xBD"],"\xAE"=>[97,"\xBD"],"\xAF"=>[99,"\xBD"],"\xB0"=>[106,"\xBD"],"\xB1"=>[136,"\xBD"],"\xB2"=>[139,"\xBD"],"\xB3"=>[141,"\xBD"],"\xB4"=>[145,"\xBD"],"\xB5"=>[147,"\xBD"],"\xB6"=>[149,"\xBD"],"\xB7"=>[101,"\xBD"],"\xB8"=>[112,"\xBD"],"\xB9"=>[117,"\xBD"],"\xBA"=>[120,"\xBD"],"\xBB"=>[124,"\xBD"],"\xBC"=>[127,"\xBD"],"\xBD"=>[144,"\xBD"],"\xBE"=>[152,"\xBD"],"\xBF"=>[11,"\xBD"],"\xC0"=>[0,"\xBE0"],"\xC1"=>[0,"\xBE1"],"\xC2"=>[0,"\xBE2"],"\xC3"=>[0,"\xBEa"],"\xC4"=>[0,"\xBEc"],"\xC5"=>[0,"\xBEe"],"\xC6"=>[0,"\xBEi"],"\xC7"=>[0,"\xBEo"],"\xC8"=>[0,"\xBEs"],"\xC9"=>[0,"\xBEt"],"\xCA"=>[73,"\xBE"],"\xCB"=>[88,"\xBE"],"\xCC"=>[89,"\xBE"],"\xCD"=>[96,"\xBE"],"\xCE"=>[97,"\xBE"],"\xCF"=>[99,"\xBE"],"\xD0"=>[106,"\xBE"],"\xD1"=>[136,"\xBE"],"\xD2"=>[139,"\xBE"],"\xD3"=>[141,"\xBE"],"\xD4"=>[145,"\xBE"],"\xD5"=>[147,"\xBE"],"\xD6"=>[149,"\xBE"],"\xD7"=>[101,"\xBE"],"\xD8"=>[112,"\xBE"],"\xD9"=>[117,"\xBE"],"\xDA"=>[120,"\xBE"],"\xDB"=>[124,"\xBE"],"\xDC"=>[127,"\xBE"],"\xDD"=>[144,"\xBE"],"\xDE"=>[152,"\xBE"],"\xDF"=>[11,"\xBE"],"\xE0"=>[0,"\xC40"],"\xE1"=>[0,"\xC41"],"\xE2"=>[0,"\xC42"],"\xE3"=>[0,"\xC4a"],"\xE4"=>[0,"\xC4c"],"\xE5"=>[0,"\xC4e"],"\xE6"=>[0,"\xC4i"],"\xE7"=>[0,"\xC4o"],"\xE8"=>[0,"\xC4s"],"\xE9"=>[0,"\xC4t"],"\xEA"=>[73,"\xC4"],"\xEB"=>[88,"\xC4"],"\xEC"=>[89,"\xC4"],"\xED"=>[96,"\xC4"],"\xEE"=>[97,"\xC4"],"\xEF"=>[99,"\xC4"],"\xF0"=>[106,"\xC4"],"\xF1"=>[136,"\xC4"],"\xF2"=>[139,"\xC4"],"\xF3"=>[141,"\xC4"],"\xF4"=>[145,"\xC4"],"\xF5"=>[147,"\xC4"],"\xF6"=>[149,"\xC4"],"\xF7"=>[101,"\xC4"],"\xF8"=>[112,"\xC4"],"\xF9"=>[117,"\xC4"],"\xFA"=>[120,"\xC4"],"\xFB"=>[124,"\xC4"],"\xFC"=>[127,"\xC4"],"\xFD"=>[144,"\xC4"],"\xFE"=>[152,"\xC4"],"\xFF"=>[11,"\xC4"],],["\x00"=>[94,"\xB30"],"\x01"=>[76,"\xB30"],"\x02"=>[104,"\xB30"],"\x03"=>[16,"\xB30"],"\x04"=>[94,"\xB31"],"\x05"=>[76,"\xB31"],"\x06"=>[104,"\xB31"],"\x07"=>[16,"\xB31"],"\x08"=>[94,"\xB32"],"\x09"=>[76,"\xB32"],"\x0A"=>[104,"\xB32"],"\x0B"=>[16,"\xB32"],"\x0C"=>[94,"\xB3a"],"\x0D"=>[76,"\xB3a"],"\x0E"=>[104,"\xB3a"],"\x0F"=>[16,"\xB3a"],"\x10"=>[94,"\xB3c"],"\x11"=>[76,"\xB3c"],"\x12"=>[104,"\xB3c"],"\x13"=>[16,"\xB3c"],"\x14"=>[94,"\xB3e"],"\x15"=>[76,"\xB3e"],"\x16"=>[104,"\xB3e"],"\x17"=>[16,"\xB3e"],"\x18"=>[94,"\xB3i"],"\x19"=>[76,"\xB3i"],"\x1A"=>[104,"\xB3i"],"\x1B"=>[16,"\xB3i"],"\x1C"=>[94,"\xB3o"],"\x1D"=>[76,"\xB3o"],"\x1E"=>[104,"\xB3o"],"\x1F"=>[16,"\xB3o"],"\x20"=>[94,"\xB3s"],"\x21"=>[76,"\xB3s"],"\x22"=>[104,"\xB3s"],"\x23"=>[16,"\xB3s"],"\x24"=>[94,"\xB3t"],"\x25"=>[76,"\xB3t"],"\x26"=>[104,"\xB3t"],"\x27"=>[16,"\xB3t"],"\x28"=>[77,"\xB3\x20"],"\x29"=>[18,"\xB3\x20"],"\x2A"=>[77,"\xB3\x25"],"\x2B"=>[18,"\xB3\x25"],"\x2C"=>[77,"\xB3-"],"-"=>[18,"\xB3-"],"."=>[77,"\xB3."],"\x2F"=>[18,"\xB3."],[77,"\xB3\x2F"],[18,"\xB3\x2F"],[77,"\xB33"],[18,"\xB33"],[77,"\xB34"],[18,"\xB34"],[77,"\xB35"],[18,"\xB35"],[77,"\xB36"],[18,"\xB36"],"\x3A"=>[77,"\xB37"],"\x3B"=>[18,"\xB37"],"\x3C"=>[77,"\xB38"],"\x3D"=>[18,"\xB38"],"\x3E"=>[77,"\xB39"],"\x3F"=>[18,"\xB39"],"\x40"=>[77,"\xB3\x3D"],"A"=>[18,"\xB3\x3D"],"B"=>[77,"\xB3A"],"C"=>[18,"\xB3A"],"D"=>[77,"\xB3_"],"E"=>[18,"\xB3_"],"F"=>[77,"\xB3b"],"G"=>[18,"\xB3b"],"H"=>[77,"\xB3d"],"I"=>[18,"\xB3d"],"J"=>[77,"\xB3f"],"K"=>[18,"\xB3f"],"L"=>[77,"\xB3g"],"M"=>[18,"\xB3g"],"N"=>[77,"\xB3h"],"O"=>[18,"\xB3h"],"P"=>[77,"\xB3l"],"Q"=>[18,"\xB3l"],"R"=>[77,"\xB3m"],"S"=>[18,"\xB3m"],"T"=>[77,"\xB3n"],"U"=>[18,"\xB3n"],"V"=>[77,"\xB3p"],"W"=>[18,"\xB3p"],"X"=>[77,"\xB3r"],"Y"=>[18,"\xB3r"],"Z"=>[77,"\xB3u"],"\x5B"=>[18,"\xB3u"],"\x5C"=>[0,"\xB3\x3A"],"\x5D"=>[0,"\xB3B"],"\x5E"=>[0,"\xB3C"],"_"=>[0,"\xB3D"],"\x60"=>[0,"\xB3E"],"a"=>[0,"\xB3F"],"b"=>[0,"\xB3G"],"c"=>[0,"\xB3H"],"d"=>[0,"\xB3I"],"e"=>[0,"\xB3J"],"f"=>[0,"\xB3K"],"g"=>[0,"\xB3L"],"h"=>[0,"\xB3M"],"i"=>[0,"\xB3N"],"j"=>[0,"\xB3O"],"k"=>[0,"\xB3P"],"l"=>[0,"\xB3Q"],"m"=>[0,"\xB3R"],"n"=>[0,"\xB3S"],"o"=>[0,"\xB3T"],"p"=>[0,"\xB3U"],"q"=>[0,"\xB3V"],"r"=>[0,"\xB3W"],"s"=>[0,"\xB3Y"],"t"=>[0,"\xB3j"],"u"=>[0,"\xB3k"],"v"=>[0,"\xB3q"],"w"=>[0,"\xB3v"],"x"=>[0,"\xB3w"],"y"=>[0,"\xB3x"],"z"=>[0,"\xB3y"],"\x7B"=>[0,"\xB3z"],"\x7C"=>[82,"\xB3"],"\x7D"=>[87,"\xB3"],"~"=>[130,"\xB3"],"\x7F"=>[9,"\xB3"],"\x80"=>[94,"\xD10"],"\x81"=>[76,"\xD10"],"\x82"=>[104,"\xD10"],"\x83"=>[16,"\xD10"],"\x84"=>[94,"\xD11"],"\x85"=>[76,"\xD11"],"\x86"=>[104,"\xD11"],"\x87"=>[16,"\xD11"],"\x88"=>[94,"\xD12"],"\x89"=>[76,"\xD12"],"\x8A"=>[104,"\xD12"],"\x8B"=>[16,"\xD12"],"\x8C"=>[94,"\xD1a"],"\x8D"=>[76,"\xD1a"],"\x8E"=>[104,"\xD1a"],"\x8F"=>[16,"\xD1a"],"\x90"=>[94,"\xD1c"],"\x91"=>[76,"\xD1c"],"\x92"=>[104,"\xD1c"],"\x93"=>[16,"\xD1c"],"\x94"=>[94,"\xD1e"],"\x95"=>[76,"\xD1e"],"\x96"=>[104,"\xD1e"],"\x97"=>[16,"\xD1e"],"\x98"=>[94,"\xD1i"],"\x99"=>[76,"\xD1i"],"\x9A"=>[104,"\xD1i"],"\x9B"=>[16,"\xD1i"],"\x9C"=>[94,"\xD1o"],"\x9D"=>[76,"\xD1o"],"\x9E"=>[104,"\xD1o"],"\x9F"=>[16,"\xD1o"],"\xA0"=>[94,"\xD1s"],"\xA1"=>[76,"\xD1s"],"\xA2"=>[104,"\xD1s"],"\xA3"=>[16,"\xD1s"],"\xA4"=>[94,"\xD1t"],"\xA5"=>[76,"\xD1t"],"\xA6"=>[104,"\xD1t"],"\xA7"=>[16,"\xD1t"],"\xA8"=>[77,"\xD1\x20"],"\xA9"=>[18,"\xD1\x20"],"\xAA"=>[77,"\xD1\x25"],"\xAB"=>[18,"\xD1\x25"],"\xAC"=>[77,"\xD1-"],"\xAD"=>[18,"\xD1-"],"\xAE"=>[77,"\xD1."],"\xAF"=>[18,"\xD1."],"\xB0"=>[77,"\xD1\x2F"],"\xB1"=>[18,"\xD1\x2F"],"\xB2"=>[77,"\xD13"],"\xB3"=>[18,"\xD13"],"\xB4"=>[77,"\xD14"],"\xB5"=>[18,"\xD14"],"\xB6"=>[77,"\xD15"],"\xB7"=>[18,"\xD15"],"\xB8"=>[77,"\xD16"],"\xB9"=>[18,"\xD16"],"\xBA"=>[77,"\xD17"],"\xBB"=>[18,"\xD17"],"\xBC"=>[77,"\xD18"],"\xBD"=>[18,"\xD18"],"\xBE"=>[77,"\xD19"],"\xBF"=>[18,"\xD19"],"\xC0"=>[77,"\xD1\x3D"],"\xC1"=>[18,"\xD1\x3D"],"\xC2"=>[77,"\xD1A"],"\xC3"=>[18,"\xD1A"],"\xC4"=>[77,"\xD1_"],"\xC5"=>[18,"\xD1_"],"\xC6"=>[77,"\xD1b"],"\xC7"=>[18,"\xD1b"],"\xC8"=>[77,"\xD1d"],"\xC9"=>[18,"\xD1d"],"\xCA"=>[77,"\xD1f"],"\xCB"=>[18,"\xD1f"],"\xCC"=>[77,"\xD1g"],"\xCD"=>[18,"\xD1g"],"\xCE"=>[77,"\xD1h"],"\xCF"=>[18,"\xD1h"],"\xD0"=>[77,"\xD1l"],"\xD1"=>[18,"\xD1l"],"\xD2"=>[77,"\xD1m"],"\xD3"=>[18,"\xD1m"],"\xD4"=>[77,"\xD1n"],"\xD5"=>[18,"\xD1n"],"\xD6"=>[77,"\xD1p"],"\xD7"=>[18,"\xD1p"],"\xD8"=>[77,"\xD1r"],"\xD9"=>[18,"\xD1r"],"\xDA"=>[77,"\xD1u"],"\xDB"=>[18,"\xD1u"],"\xDC"=>[0,"\xD1\x3A"],"\xDD"=>[0,"\xD1B"],"\xDE"=>[0,"\xD1C"],"\xDF"=>[0,"\xD1D"],"\xE0"=>[0,"\xD1E"],"\xE1"=>[0,"\xD1F"],"\xE2"=>[0,"\xD1G"],"\xE3"=>[0,"\xD1H"],"\xE4"=>[0,"\xD1I"],"\xE5"=>[0,"\xD1J"],"\xE6"=>[0,"\xD1K"],"\xE7"=>[0,"\xD1L"],"\xE8"=>[0,"\xD1M"],"\xE9"=>[0,"\xD1N"],"\xEA"=>[0,"\xD1O"],"\xEB"=>[0,"\xD1P"],"\xEC"=>[0,"\xD1Q"],"\xED"=>[0,"\xD1R"],"\xEE"=>[0,"\xD1S"],"\xEF"=>[0,"\xD1T"],"\xF0"=>[0,"\xD1U"],"\xF1"=>[0,"\xD1V"],"\xF2"=>[0,"\xD1W"],"\xF3"=>[0,"\xD1Y"],"\xF4"=>[0,"\xD1j"],"\xF5"=>[0,"\xD1k"],"\xF6"=>[0,"\xD1q"],"\xF7"=>[0,"\xD1v"],"\xF8"=>[0,"\xD1w"],"\xF9"=>[0,"\xD1x"],"\xFA"=>[0,"\xD1y"],"\xFB"=>[0,"\xD1z"],"\xFC"=>[82,"\xD1"],"\xFD"=>[87,"\xD1"],"\xFE"=>[130,"\xD1"],"\xFF"=>[9,"\xD1"],],["\x00"=>[94,"\xB60"],"\x01"=>[76,"\xB60"],"\x02"=>[104,"\xB60"],"\x03"=>[16,"\xB60"],"\x04"=>[94,"\xB61"],"\x05"=>[76,"\xB61"],"\x06"=>[104,"\xB61"],"\x07"=>[16,"\xB61"],"\x08"=>[94,"\xB62"],"\x09"=>[76,"\xB62"],"\x0A"=>[104,"\xB62"],"\x0B"=>[16,"\xB62"],"\x0C"=>[94,"\xB6a"],"\x0D"=>[76,"\xB6a"],"\x0E"=>[104,"\xB6a"],"\x0F"=>[16,"\xB6a"],"\x10"=>[94,"\xB6c"],"\x11"=>[76,"\xB6c"],"\x12"=>[104,"\xB6c"],"\x13"=>[16,"\xB6c"],"\x14"=>[94,"\xB6e"],"\x15"=>[76,"\xB6e"],"\x16"=>[104,"\xB6e"],"\x17"=>[16,"\xB6e"],"\x18"=>[94,"\xB6i"],"\x19"=>[76,"\xB6i"],"\x1A"=>[104,"\xB6i"],"\x1B"=>[16,"\xB6i"],"\x1C"=>[94,"\xB6o"],"\x1D"=>[76,"\xB6o"],"\x1E"=>[104,"\xB6o"],"\x1F"=>[16,"\xB6o"],"\x20"=>[94,"\xB6s"],"\x21"=>[76,"\xB6s"],"\x22"=>[104,"\xB6s"],"\x23"=>[16,"\xB6s"],"\x24"=>[94,"\xB6t"],"\x25"=>[76,"\xB6t"],"\x26"=>[104,"\xB6t"],"\x27"=>[16,"\xB6t"],"\x28"=>[77,"\xB6\x20"],"\x29"=>[18,"\xB6\x20"],"\x2A"=>[77,"\xB6\x25"],"\x2B"=>[18,"\xB6\x25"],"\x2C"=>[77,"\xB6-"],"-"=>[18,"\xB6-"],"."=>[77,"\xB6."],"\x2F"=>[18,"\xB6."],[77,"\xB6\x2F"],[18,"\xB6\x2F"],[77,"\xB63"],[18,"\xB63"],[77,"\xB64"],[18,"\xB64"],[77,"\xB65"],[18,"\xB65"],[77,"\xB66"],[18,"\xB66"],"\x3A"=>[77,"\xB67"],"\x3B"=>[18,"\xB67"],"\x3C"=>[77,"\xB68"],"\x3D"=>[18,"\xB68"],"\x3E"=>[77,"\xB69"],"\x3F"=>[18,"\xB69"],"\x40"=>[77,"\xB6\x3D"],"A"=>[18,"\xB6\x3D"],"B"=>[77,"\xB6A"],"C"=>[18,"\xB6A"],"D"=>[77,"\xB6_"],"E"=>[18,"\xB6_"],"F"=>[77,"\xB6b"],"G"=>[18,"\xB6b"],"H"=>[77,"\xB6d"],"I"=>[18,"\xB6d"],"J"=>[77,"\xB6f"],"K"=>[18,"\xB6f"],"L"=>[77,"\xB6g"],"M"=>[18,"\xB6g"],"N"=>[77,"\xB6h"],"O"=>[18,"\xB6h"],"P"=>[77,"\xB6l"],"Q"=>[18,"\xB6l"],"R"=>[77,"\xB6m"],"S"=>[18,"\xB6m"],"T"=>[77,"\xB6n"],"U"=>[18,"\xB6n"],"V"=>[77,"\xB6p"],"W"=>[18,"\xB6p"],"X"=>[77,"\xB6r"],"Y"=>[18,"\xB6r"],"Z"=>[77,"\xB6u"],"\x5B"=>[18,"\xB6u"],"\x5C"=>[0,"\xB6\x3A"],"\x5D"=>[0,"\xB6B"],"\x5E"=>[0,"\xB6C"],"_"=>[0,"\xB6D"],"\x60"=>[0,"\xB6E"],"a"=>[0,"\xB6F"],"b"=>[0,"\xB6G"],"c"=>[0,"\xB6H"],"d"=>[0,"\xB6I"],"e"=>[0,"\xB6J"],"f"=>[0,"\xB6K"],"g"=>[0,"\xB6L"],"h"=>[0,"\xB6M"],"i"=>[0,"\xB6N"],"j"=>[0,"\xB6O"],"k"=>[0,"\xB6P"],"l"=>[0,"\xB6Q"],"m"=>[0,"\xB6R"],"n"=>[0,"\xB6S"],"o"=>[0,"\xB6T"],"p"=>[0,"\xB6U"],"q"=>[0,"\xB6V"],"r"=>[0,"\xB6W"],"s"=>[0,"\xB6Y"],"t"=>[0,"\xB6j"],"u"=>[0,"\xB6k"],"v"=>[0,"\xB6q"],"w"=>[0,"\xB6v"],"x"=>[0,"\xB6w"],"y"=>[0,"\xB6x"],"z"=>[0,"\xB6y"],"\x7B"=>[0,"\xB6z"],"\x7C"=>[82,"\xB6"],"\x7D"=>[87,"\xB6"],"~"=>[130,"\xB6"],"\x7F"=>[9,"\xB6"],"\x80"=>[94,"\xB70"],"\x81"=>[76,"\xB70"],"\x82"=>[104,"\xB70"],"\x83"=>[16,"\xB70"],"\x84"=>[94,"\xB71"],"\x85"=>[76,"\xB71"],"\x86"=>[104,"\xB71"],"\x87"=>[16,"\xB71"],"\x88"=>[94,"\xB72"],"\x89"=>[76,"\xB72"],"\x8A"=>[104,"\xB72"],"\x8B"=>[16,"\xB72"],"\x8C"=>[94,"\xB7a"],"\x8D"=>[76,"\xB7a"],"\x8E"=>[104,"\xB7a"],"\x8F"=>[16,"\xB7a"],"\x90"=>[94,"\xB7c"],"\x91"=>[76,"\xB7c"],"\x92"=>[104,"\xB7c"],"\x93"=>[16,"\xB7c"],"\x94"=>[94,"\xB7e"],"\x95"=>[76,"\xB7e"],"\x96"=>[104,"\xB7e"],"\x97"=>[16,"\xB7e"],"\x98"=>[94,"\xB7i"],"\x99"=>[76,"\xB7i"],"\x9A"=>[104,"\xB7i"],"\x9B"=>[16,"\xB7i"],"\x9C"=>[94,"\xB7o"],"\x9D"=>[76,"\xB7o"],"\x9E"=>[104,"\xB7o"],"\x9F"=>[16,"\xB7o"],"\xA0"=>[94,"\xB7s"],"\xA1"=>[76,"\xB7s"],"\xA2"=>[104,"\xB7s"],"\xA3"=>[16,"\xB7s"],"\xA4"=>[94,"\xB7t"],"\xA5"=>[76,"\xB7t"],"\xA6"=>[104,"\xB7t"],"\xA7"=>[16,"\xB7t"],"\xA8"=>[77,"\xB7\x20"],"\xA9"=>[18,"\xB7\x20"],"\xAA"=>[77,"\xB7\x25"],"\xAB"=>[18,"\xB7\x25"],"\xAC"=>[77,"\xB7-"],"\xAD"=>[18,"\xB7-"],"\xAE"=>[77,"\xB7."],"\xAF"=>[18,"\xB7."],"\xB0"=>[77,"\xB7\x2F"],"\xB1"=>[18,"\xB7\x2F"],"\xB2"=>[77,"\xB73"],"\xB3"=>[18,"\xB73"],"\xB4"=>[77,"\xB74"],"\xB5"=>[18,"\xB74"],"\xB6"=>[77,"\xB75"],"\xB7"=>[18,"\xB75"],"\xB8"=>[77,"\xB76"],"\xB9"=>[18,"\xB76"],"\xBA"=>[77,"\xB77"],"\xBB"=>[18,"\xB77"],"\xBC"=>[77,"\xB78"],"\xBD"=>[18,"\xB78"],"\xBE"=>[77,"\xB79"],"\xBF"=>[18,"\xB79"],"\xC0"=>[77,"\xB7\x3D"],"\xC1"=>[18,"\xB7\x3D"],"\xC2"=>[77,"\xB7A"],"\xC3"=>[18,"\xB7A"],"\xC4"=>[77,"\xB7_"],"\xC5"=>[18,"\xB7_"],"\xC6"=>[77,"\xB7b"],"\xC7"=>[18,"\xB7b"],"\xC8"=>[77,"\xB7d"],"\xC9"=>[18,"\xB7d"],"\xCA"=>[77,"\xB7f"],"\xCB"=>[18,"\xB7f"],"\xCC"=>[77,"\xB7g"],"\xCD"=>[18,"\xB7g"],"\xCE"=>[77,"\xB7h"],"\xCF"=>[18,"\xB7h"],"\xD0"=>[77,"\xB7l"],"\xD1"=>[18,"\xB7l"],"\xD2"=>[77,"\xB7m"],"\xD3"=>[18,"\xB7m"],"\xD4"=>[77,"\xB7n"],"\xD5"=>[18,"\xB7n"],"\xD6"=>[77,"\xB7p"],"\xD7"=>[18,"\xB7p"],"\xD8"=>[77,"\xB7r"],"\xD9"=>[18,"\xB7r"],"\xDA"=>[77,"\xB7u"],"\xDB"=>[18,"\xB7u"],"\xDC"=>[0,"\xB7\x3A"],"\xDD"=>[0,"\xB7B"],"\xDE"=>[0,"\xB7C"],"\xDF"=>[0,"\xB7D"],"\xE0"=>[0,"\xB7E"],"\xE1"=>[0,"\xB7F"],"\xE2"=>[0,"\xB7G"],"\xE3"=>[0,"\xB7H"],"\xE4"=>[0,"\xB7I"],"\xE5"=>[0,"\xB7J"],"\xE6"=>[0,"\xB7K"],"\xE7"=>[0,"\xB7L"],"\xE8"=>[0,"\xB7M"],"\xE9"=>[0,"\xB7N"],"\xEA"=>[0,"\xB7O"],"\xEB"=>[0,"\xB7P"],"\xEC"=>[0,"\xB7Q"],"\xED"=>[0,"\xB7R"],"\xEE"=>[0,"\xB7S"],"\xEF"=>[0,"\xB7T"],"\xF0"=>[0,"\xB7U"],"\xF1"=>[0,"\xB7V"],"\xF2"=>[0,"\xB7W"],"\xF3"=>[0,"\xB7Y"],"\xF4"=>[0,"\xB7j"],"\xF5"=>[0,"\xB7k"],"\xF6"=>[0,"\xB7q"],"\xF7"=>[0,"\xB7v"],"\xF8"=>[0,"\xB7w"],"\xF9"=>[0,"\xB7x"],"\xFA"=>[0,"\xB7y"],"\xFB"=>[0,"\xB7z"],"\xFC"=>[82,"\xB7"],"\xFD"=>[87,"\xB7"],"\xFE"=>[130,"\xB7"],"\xFF"=>[9,"\xB7"],],["\x00"=>[94,"\xB80"],"\x01"=>[76,"\xB80"],"\x02"=>[104,"\xB80"],"\x03"=>[16,"\xB80"],"\x04"=>[94,"\xB81"],"\x05"=>[76,"\xB81"],"\x06"=>[104,"\xB81"],"\x07"=>[16,"\xB81"],"\x08"=>[94,"\xB82"],"\x09"=>[76,"\xB82"],"\x0A"=>[104,"\xB82"],"\x0B"=>[16,"\xB82"],"\x0C"=>[94,"\xB8a"],"\x0D"=>[76,"\xB8a"],"\x0E"=>[104,"\xB8a"],"\x0F"=>[16,"\xB8a"],"\x10"=>[94,"\xB8c"],"\x11"=>[76,"\xB8c"],"\x12"=>[104,"\xB8c"],"\x13"=>[16,"\xB8c"],"\x14"=>[94,"\xB8e"],"\x15"=>[76,"\xB8e"],"\x16"=>[104,"\xB8e"],"\x17"=>[16,"\xB8e"],"\x18"=>[94,"\xB8i"],"\x19"=>[76,"\xB8i"],"\x1A"=>[104,"\xB8i"],"\x1B"=>[16,"\xB8i"],"\x1C"=>[94,"\xB8o"],"\x1D"=>[76,"\xB8o"],"\x1E"=>[104,"\xB8o"],"\x1F"=>[16,"\xB8o"],"\x20"=>[94,"\xB8s"],"\x21"=>[76,"\xB8s"],"\x22"=>[104,"\xB8s"],"\x23"=>[16,"\xB8s"],"\x24"=>[94,"\xB8t"],"\x25"=>[76,"\xB8t"],"\x26"=>[104,"\xB8t"],"\x27"=>[16,"\xB8t"],"\x28"=>[77,"\xB8\x20"],"\x29"=>[18,"\xB8\x20"],"\x2A"=>[77,"\xB8\x25"],"\x2B"=>[18,"\xB8\x25"],"\x2C"=>[77,"\xB8-"],"-"=>[18,"\xB8-"],"."=>[77,"\xB8."],"\x2F"=>[18,"\xB8."],[77,"\xB8\x2F"],[18,"\xB8\x2F"],[77,"\xB83"],[18,"\xB83"],[77,"\xB84"],[18,"\xB84"],[77,"\xB85"],[18,"\xB85"],[77,"\xB86"],[18,"\xB86"],"\x3A"=>[77,"\xB87"],"\x3B"=>[18,"\xB87"],"\x3C"=>[77,"\xB88"],"\x3D"=>[18,"\xB88"],"\x3E"=>[77,"\xB89"],"\x3F"=>[18,"\xB89"],"\x40"=>[77,"\xB8\x3D"],"A"=>[18,"\xB8\x3D"],"B"=>[77,"\xB8A"],"C"=>[18,"\xB8A"],"D"=>[77,"\xB8_"],"E"=>[18,"\xB8_"],"F"=>[77,"\xB8b"],"G"=>[18,"\xB8b"],"H"=>[77,"\xB8d"],"I"=>[18,"\xB8d"],"J"=>[77,"\xB8f"],"K"=>[18,"\xB8f"],"L"=>[77,"\xB8g"],"M"=>[18,"\xB8g"],"N"=>[77,"\xB8h"],"O"=>[18,"\xB8h"],"P"=>[77,"\xB8l"],"Q"=>[18,"\xB8l"],"R"=>[77,"\xB8m"],"S"=>[18,"\xB8m"],"T"=>[77,"\xB8n"],"U"=>[18,"\xB8n"],"V"=>[77,"\xB8p"],"W"=>[18,"\xB8p"],"X"=>[77,"\xB8r"],"Y"=>[18,"\xB8r"],"Z"=>[77,"\xB8u"],"\x5B"=>[18,"\xB8u"],"\x5C"=>[0,"\xB8\x3A"],"\x5D"=>[0,"\xB8B"],"\x5E"=>[0,"\xB8C"],"_"=>[0,"\xB8D"],"\x60"=>[0,"\xB8E"],"a"=>[0,"\xB8F"],"b"=>[0,"\xB8G"],"c"=>[0,"\xB8H"],"d"=>[0,"\xB8I"],"e"=>[0,"\xB8J"],"f"=>[0,"\xB8K"],"g"=>[0,"\xB8L"],"h"=>[0,"\xB8M"],"i"=>[0,"\xB8N"],"j"=>[0,"\xB8O"],"k"=>[0,"\xB8P"],"l"=>[0,"\xB8Q"],"m"=>[0,"\xB8R"],"n"=>[0,"\xB8S"],"o"=>[0,"\xB8T"],"p"=>[0,"\xB8U"],"q"=>[0,"\xB8V"],"r"=>[0,"\xB8W"],"s"=>[0,"\xB8Y"],"t"=>[0,"\xB8j"],"u"=>[0,"\xB8k"],"v"=>[0,"\xB8q"],"w"=>[0,"\xB8v"],"x"=>[0,"\xB8w"],"y"=>[0,"\xB8x"],"z"=>[0,"\xB8y"],"\x7B"=>[0,"\xB8z"],"\x7C"=>[82,"\xB8"],"\x7D"=>[87,"\xB8"],"~"=>[130,"\xB8"],"\x7F"=>[9,"\xB8"],"\x80"=>[94,"\xC20"],"\x81"=>[76,"\xC20"],"\x82"=>[104,"\xC20"],"\x83"=>[16,"\xC20"],"\x84"=>[94,"\xC21"],"\x85"=>[76,"\xC21"],"\x86"=>[104,"\xC21"],"\x87"=>[16,"\xC21"],"\x88"=>[94,"\xC22"],"\x89"=>[76,"\xC22"],"\x8A"=>[104,"\xC22"],"\x8B"=>[16,"\xC22"],"\x8C"=>[94,"\xC2a"],"\x8D"=>[76,"\xC2a"],"\x8E"=>[104,"\xC2a"],"\x8F"=>[16,"\xC2a"],"\x90"=>[94,"\xC2c"],"\x91"=>[76,"\xC2c"],"\x92"=>[104,"\xC2c"],"\x93"=>[16,"\xC2c"],"\x94"=>[94,"\xC2e"],"\x95"=>[76,"\xC2e"],"\x96"=>[104,"\xC2e"],"\x97"=>[16,"\xC2e"],"\x98"=>[94,"\xC2i"],"\x99"=>[76,"\xC2i"],"\x9A"=>[104,"\xC2i"],"\x9B"=>[16,"\xC2i"],"\x9C"=>[94,"\xC2o"],"\x9D"=>[76,"\xC2o"],"\x9E"=>[104,"\xC2o"],"\x9F"=>[16,"\xC2o"],"\xA0"=>[94,"\xC2s"],"\xA1"=>[76,"\xC2s"],"\xA2"=>[104,"\xC2s"],"\xA3"=>[16,"\xC2s"],"\xA4"=>[94,"\xC2t"],"\xA5"=>[76,"\xC2t"],"\xA6"=>[104,"\xC2t"],"\xA7"=>[16,"\xC2t"],"\xA8"=>[77,"\xC2\x20"],"\xA9"=>[18,"\xC2\x20"],"\xAA"=>[77,"\xC2\x25"],"\xAB"=>[18,"\xC2\x25"],"\xAC"=>[77,"\xC2-"],"\xAD"=>[18,"\xC2-"],"\xAE"=>[77,"\xC2."],"\xAF"=>[18,"\xC2."],"\xB0"=>[77,"\xC2\x2F"],"\xB1"=>[18,"\xC2\x2F"],"\xB2"=>[77,"\xC23"],"\xB3"=>[18,"\xC23"],"\xB4"=>[77,"\xC24"],"\xB5"=>[18,"\xC24"],"\xB6"=>[77,"\xC25"],"\xB7"=>[18,"\xC25"],"\xB8"=>[77,"\xC26"],"\xB9"=>[18,"\xC26"],"\xBA"=>[77,"\xC27"],"\xBB"=>[18,"\xC27"],"\xBC"=>[77,"\xC28"],"\xBD"=>[18,"\xC28"],"\xBE"=>[77,"\xC29"],"\xBF"=>[18,"\xC29"],"\xC0"=>[77,"\xC2\x3D"],"\xC1"=>[18,"\xC2\x3D"],"\xC2"=>[77,"\xC2A"],"\xC3"=>[18,"\xC2A"],"\xC4"=>[77,"\xC2_"],"\xC5"=>[18,"\xC2_"],"\xC6"=>[77,"\xC2b"],"\xC7"=>[18,"\xC2b"],"\xC8"=>[77,"\xC2d"],"\xC9"=>[18,"\xC2d"],"\xCA"=>[77,"\xC2f"],"\xCB"=>[18,"\xC2f"],"\xCC"=>[77,"\xC2g"],"\xCD"=>[18,"\xC2g"],"\xCE"=>[77,"\xC2h"],"\xCF"=>[18,"\xC2h"],"\xD0"=>[77,"\xC2l"],"\xD1"=>[18,"\xC2l"],"\xD2"=>[77,"\xC2m"],"\xD3"=>[18,"\xC2m"],"\xD4"=>[77,"\xC2n"],"\xD5"=>[18,"\xC2n"],"\xD6"=>[77,"\xC2p"],"\xD7"=>[18,"\xC2p"],"\xD8"=>[77,"\xC2r"],"\xD9"=>[18,"\xC2r"],"\xDA"=>[77,"\xC2u"],"\xDB"=>[18,"\xC2u"],"\xDC"=>[0,"\xC2\x3A"],"\xDD"=>[0,"\xC2B"],"\xDE"=>[0,"\xC2C"],"\xDF"=>[0,"\xC2D"],"\xE0"=>[0,"\xC2E"],"\xE1"=>[0,"\xC2F"],"\xE2"=>[0,"\xC2G"],"\xE3"=>[0,"\xC2H"],"\xE4"=>[0,"\xC2I"],"\xE5"=>[0,"\xC2J"],"\xE6"=>[0,"\xC2K"],"\xE7"=>[0,"\xC2L"],"\xE8"=>[0,"\xC2M"],"\xE9"=>[0,"\xC2N"],"\xEA"=>[0,"\xC2O"],"\xEB"=>[0,"\xC2P"],"\xEC"=>[0,"\xC2Q"],"\xED"=>[0,"\xC2R"],"\xEE"=>[0,"\xC2S"],"\xEF"=>[0,"\xC2T"],"\xF0"=>[0,"\xC2U"],"\xF1"=>[0,"\xC2V"],"\xF2"=>[0,"\xC2W"],"\xF3"=>[0,"\xC2Y"],"\xF4"=>[0,"\xC2j"],"\xF5"=>[0,"\xC2k"],"\xF6"=>[0,"\xC2q"],"\xF7"=>[0,"\xC2v"],"\xF8"=>[0,"\xC2w"],"\xF9"=>[0,"\xC2x"],"\xFA"=>[0,"\xC2y"],"\xFB"=>[0,"\xC2z"],"\xFC"=>[82,"\xC2"],"\xFD"=>[87,"\xC2"],"\xFE"=>[130,"\xC2"],"\xFF"=>[9,"\xC2"],],["\x00"=>[94,"\xB90"],"\x01"=>[76,"\xB90"],"\x02"=>[104,"\xB90"],"\x03"=>[16,"\xB90"],"\x04"=>[94,"\xB91"],"\x05"=>[76,"\xB91"],"\x06"=>[104,"\xB91"],"\x07"=>[16,"\xB91"],"\x08"=>[94,"\xB92"],"\x09"=>[76,"\xB92"],"\x0A"=>[104,"\xB92"],"\x0B"=>[16,"\xB92"],"\x0C"=>[94,"\xB9a"],"\x0D"=>[76,"\xB9a"],"\x0E"=>[104,"\xB9a"],"\x0F"=>[16,"\xB9a"],"\x10"=>[94,"\xB9c"],"\x11"=>[76,"\xB9c"],"\x12"=>[104,"\xB9c"],"\x13"=>[16,"\xB9c"],"\x14"=>[94,"\xB9e"],"\x15"=>[76,"\xB9e"],"\x16"=>[104,"\xB9e"],"\x17"=>[16,"\xB9e"],"\x18"=>[94,"\xB9i"],"\x19"=>[76,"\xB9i"],"\x1A"=>[104,"\xB9i"],"\x1B"=>[16,"\xB9i"],"\x1C"=>[94,"\xB9o"],"\x1D"=>[76,"\xB9o"],"\x1E"=>[104,"\xB9o"],"\x1F"=>[16,"\xB9o"],"\x20"=>[94,"\xB9s"],"\x21"=>[76,"\xB9s"],"\x22"=>[104,"\xB9s"],"\x23"=>[16,"\xB9s"],"\x24"=>[94,"\xB9t"],"\x25"=>[76,"\xB9t"],"\x26"=>[104,"\xB9t"],"\x27"=>[16,"\xB9t"],"\x28"=>[77,"\xB9\x20"],"\x29"=>[18,"\xB9\x20"],"\x2A"=>[77,"\xB9\x25"],"\x2B"=>[18,"\xB9\x25"],"\x2C"=>[77,"\xB9-"],"-"=>[18,"\xB9-"],"."=>[77,"\xB9."],"\x2F"=>[18,"\xB9."],[77,"\xB9\x2F"],[18,"\xB9\x2F"],[77,"\xB93"],[18,"\xB93"],[77,"\xB94"],[18,"\xB94"],[77,"\xB95"],[18,"\xB95"],[77,"\xB96"],[18,"\xB96"],"\x3A"=>[77,"\xB97"],"\x3B"=>[18,"\xB97"],"\x3C"=>[77,"\xB98"],"\x3D"=>[18,"\xB98"],"\x3E"=>[77,"\xB99"],"\x3F"=>[18,"\xB99"],"\x40"=>[77,"\xB9\x3D"],"A"=>[18,"\xB9\x3D"],"B"=>[77,"\xB9A"],"C"=>[18,"\xB9A"],"D"=>[77,"\xB9_"],"E"=>[18,"\xB9_"],"F"=>[77,"\xB9b"],"G"=>[18,"\xB9b"],"H"=>[77,"\xB9d"],"I"=>[18,"\xB9d"],"J"=>[77,"\xB9f"],"K"=>[18,"\xB9f"],"L"=>[77,"\xB9g"],"M"=>[18,"\xB9g"],"N"=>[77,"\xB9h"],"O"=>[18,"\xB9h"],"P"=>[77,"\xB9l"],"Q"=>[18,"\xB9l"],"R"=>[77,"\xB9m"],"S"=>[18,"\xB9m"],"T"=>[77,"\xB9n"],"U"=>[18,"\xB9n"],"V"=>[77,"\xB9p"],"W"=>[18,"\xB9p"],"X"=>[77,"\xB9r"],"Y"=>[18,"\xB9r"],"Z"=>[77,"\xB9u"],"\x5B"=>[18,"\xB9u"],"\x5C"=>[0,"\xB9\x3A"],"\x5D"=>[0,"\xB9B"],"\x5E"=>[0,"\xB9C"],"_"=>[0,"\xB9D"],"\x60"=>[0,"\xB9E"],"a"=>[0,"\xB9F"],"b"=>[0,"\xB9G"],"c"=>[0,"\xB9H"],"d"=>[0,"\xB9I"],"e"=>[0,"\xB9J"],"f"=>[0,"\xB9K"],"g"=>[0,"\xB9L"],"h"=>[0,"\xB9M"],"i"=>[0,"\xB9N"],"j"=>[0,"\xB9O"],"k"=>[0,"\xB9P"],"l"=>[0,"\xB9Q"],"m"=>[0,"\xB9R"],"n"=>[0,"\xB9S"],"o"=>[0,"\xB9T"],"p"=>[0,"\xB9U"],"q"=>[0,"\xB9V"],"r"=>[0,"\xB9W"],"s"=>[0,"\xB9Y"],"t"=>[0,"\xB9j"],"u"=>[0,"\xB9k"],"v"=>[0,"\xB9q"],"w"=>[0,"\xB9v"],"x"=>[0,"\xB9w"],"y"=>[0,"\xB9x"],"z"=>[0,"\xB9y"],"\x7B"=>[0,"\xB9z"],"\x7C"=>[82,"\xB9"],"\x7D"=>[87,"\xB9"],"~"=>[130,"\xB9"],"\x7F"=>[9,"\xB9"],"\x80"=>[94,"\xBA0"],"\x81"=>[76,"\xBA0"],"\x82"=>[104,"\xBA0"],"\x83"=>[16,"\xBA0"],"\x84"=>[94,"\xBA1"],"\x85"=>[76,"\xBA1"],"\x86"=>[104,"\xBA1"],"\x87"=>[16,"\xBA1"],"\x88"=>[94,"\xBA2"],"\x89"=>[76,"\xBA2"],"\x8A"=>[104,"\xBA2"],"\x8B"=>[16,"\xBA2"],"\x8C"=>[94,"\xBAa"],"\x8D"=>[76,"\xBAa"],"\x8E"=>[104,"\xBAa"],"\x8F"=>[16,"\xBAa"],"\x90"=>[94,"\xBAc"],"\x91"=>[76,"\xBAc"],"\x92"=>[104,"\xBAc"],"\x93"=>[16,"\xBAc"],"\x94"=>[94,"\xBAe"],"\x95"=>[76,"\xBAe"],"\x96"=>[104,"\xBAe"],"\x97"=>[16,"\xBAe"],"\x98"=>[94,"\xBAi"],"\x99"=>[76,"\xBAi"],"\x9A"=>[104,"\xBAi"],"\x9B"=>[16,"\xBAi"],"\x9C"=>[94,"\xBAo"],"\x9D"=>[76,"\xBAo"],"\x9E"=>[104,"\xBAo"],"\x9F"=>[16,"\xBAo"],"\xA0"=>[94,"\xBAs"],"\xA1"=>[76,"\xBAs"],"\xA2"=>[104,"\xBAs"],"\xA3"=>[16,"\xBAs"],"\xA4"=>[94,"\xBAt"],"\xA5"=>[76,"\xBAt"],"\xA6"=>[104,"\xBAt"],"\xA7"=>[16,"\xBAt"],"\xA8"=>[77,"\xBA\x20"],"\xA9"=>[18,"\xBA\x20"],"\xAA"=>[77,"\xBA\x25"],"\xAB"=>[18,"\xBA\x25"],"\xAC"=>[77,"\xBA-"],"\xAD"=>[18,"\xBA-"],"\xAE"=>[77,"\xBA."],"\xAF"=>[18,"\xBA."],"\xB0"=>[77,"\xBA\x2F"],"\xB1"=>[18,"\xBA\x2F"],"\xB2"=>[77,"\xBA3"],"\xB3"=>[18,"\xBA3"],"\xB4"=>[77,"\xBA4"],"\xB5"=>[18,"\xBA4"],"\xB6"=>[77,"\xBA5"],"\xB7"=>[18,"\xBA5"],"\xB8"=>[77,"\xBA6"],"\xB9"=>[18,"\xBA6"],"\xBA"=>[77,"\xBA7"],"\xBB"=>[18,"\xBA7"],"\xBC"=>[77,"\xBA8"],"\xBD"=>[18,"\xBA8"],"\xBE"=>[77,"\xBA9"],"\xBF"=>[18,"\xBA9"],"\xC0"=>[77,"\xBA\x3D"],"\xC1"=>[18,"\xBA\x3D"],"\xC2"=>[77,"\xBAA"],"\xC3"=>[18,"\xBAA"],"\xC4"=>[77,"\xBA_"],"\xC5"=>[18,"\xBA_"],"\xC6"=>[77,"\xBAb"],"\xC7"=>[18,"\xBAb"],"\xC8"=>[77,"\xBAd"],"\xC9"=>[18,"\xBAd"],"\xCA"=>[77,"\xBAf"],"\xCB"=>[18,"\xBAf"],"\xCC"=>[77,"\xBAg"],"\xCD"=>[18,"\xBAg"],"\xCE"=>[77,"\xBAh"],"\xCF"=>[18,"\xBAh"],"\xD0"=>[77,"\xBAl"],"\xD1"=>[18,"\xBAl"],"\xD2"=>[77,"\xBAm"],"\xD3"=>[18,"\xBAm"],"\xD4"=>[77,"\xBAn"],"\xD5"=>[18,"\xBAn"],"\xD6"=>[77,"\xBAp"],"\xD7"=>[18,"\xBAp"],"\xD8"=>[77,"\xBAr"],"\xD9"=>[18,"\xBAr"],"\xDA"=>[77,"\xBAu"],"\xDB"=>[18,"\xBAu"],"\xDC"=>[0,"\xBA\x3A"],"\xDD"=>[0,"\xBAB"],"\xDE"=>[0,"\xBAC"],"\xDF"=>[0,"\xBAD"],"\xE0"=>[0,"\xBAE"],"\xE1"=>[0,"\xBAF"],"\xE2"=>[0,"\xBAG"],"\xE3"=>[0,"\xBAH"],"\xE4"=>[0,"\xBAI"],"\xE5"=>[0,"\xBAJ"],"\xE6"=>[0,"\xBAK"],"\xE7"=>[0,"\xBAL"],"\xE8"=>[0,"\xBAM"],"\xE9"=>[0,"\xBAN"],"\xEA"=>[0,"\xBAO"],"\xEB"=>[0,"\xBAP"],"\xEC"=>[0,"\xBAQ"],"\xED"=>[0,"\xBAR"],"\xEE"=>[0,"\xBAS"],"\xEF"=>[0,"\xBAT"],"\xF0"=>[0,"\xBAU"],"\xF1"=>[0,"\xBAV"],"\xF2"=>[0,"\xBAW"],"\xF3"=>[0,"\xBAY"],"\xF4"=>[0,"\xBAj"],"\xF5"=>[0,"\xBAk"],"\xF6"=>[0,"\xBAq"],"\xF7"=>[0,"\xBAv"],"\xF8"=>[0,"\xBAw"],"\xF9"=>[0,"\xBAx"],"\xFA"=>[0,"\xBAy"],"\xFB"=>[0,"\xBAz"],"\xFC"=>[82,"\xBA"],"\xFD"=>[87,"\xBA"],"\xFE"=>[130,"\xBA"],"\xFF"=>[9,"\xBA"],],["\x00"=>[94,"\xBB0"],"\x01"=>[76,"\xBB0"],"\x02"=>[104,"\xBB0"],"\x03"=>[16,"\xBB0"],"\x04"=>[94,"\xBB1"],"\x05"=>[76,"\xBB1"],"\x06"=>[104,"\xBB1"],"\x07"=>[16,"\xBB1"],"\x08"=>[94,"\xBB2"],"\x09"=>[76,"\xBB2"],"\x0A"=>[104,"\xBB2"],"\x0B"=>[16,"\xBB2"],"\x0C"=>[94,"\xBBa"],"\x0D"=>[76,"\xBBa"],"\x0E"=>[104,"\xBBa"],"\x0F"=>[16,"\xBBa"],"\x10"=>[94,"\xBBc"],"\x11"=>[76,"\xBBc"],"\x12"=>[104,"\xBBc"],"\x13"=>[16,"\xBBc"],"\x14"=>[94,"\xBBe"],"\x15"=>[76,"\xBBe"],"\x16"=>[104,"\xBBe"],"\x17"=>[16,"\xBBe"],"\x18"=>[94,"\xBBi"],"\x19"=>[76,"\xBBi"],"\x1A"=>[104,"\xBBi"],"\x1B"=>[16,"\xBBi"],"\x1C"=>[94,"\xBBo"],"\x1D"=>[76,"\xBBo"],"\x1E"=>[104,"\xBBo"],"\x1F"=>[16,"\xBBo"],"\x20"=>[94,"\xBBs"],"\x21"=>[76,"\xBBs"],"\x22"=>[104,"\xBBs"],"\x23"=>[16,"\xBBs"],"\x24"=>[94,"\xBBt"],"\x25"=>[76,"\xBBt"],"\x26"=>[104,"\xBBt"],"\x27"=>[16,"\xBBt"],"\x28"=>[77,"\xBB\x20"],"\x29"=>[18,"\xBB\x20"],"\x2A"=>[77,"\xBB\x25"],"\x2B"=>[18,"\xBB\x25"],"\x2C"=>[77,"\xBB-"],"-"=>[18,"\xBB-"],"."=>[77,"\xBB."],"\x2F"=>[18,"\xBB."],[77,"\xBB\x2F"],[18,"\xBB\x2F"],[77,"\xBB3"],[18,"\xBB3"],[77,"\xBB4"],[18,"\xBB4"],[77,"\xBB5"],[18,"\xBB5"],[77,"\xBB6"],[18,"\xBB6"],"\x3A"=>[77,"\xBB7"],"\x3B"=>[18,"\xBB7"],"\x3C"=>[77,"\xBB8"],"\x3D"=>[18,"\xBB8"],"\x3E"=>[77,"\xBB9"],"\x3F"=>[18,"\xBB9"],"\x40"=>[77,"\xBB\x3D"],"A"=>[18,"\xBB\x3D"],"B"=>[77,"\xBBA"],"C"=>[18,"\xBBA"],"D"=>[77,"\xBB_"],"E"=>[18,"\xBB_"],"F"=>[77,"\xBBb"],"G"=>[18,"\xBBb"],"H"=>[77,"\xBBd"],"I"=>[18,"\xBBd"],"J"=>[77,"\xBBf"],"K"=>[18,"\xBBf"],"L"=>[77,"\xBBg"],"M"=>[18,"\xBBg"],"N"=>[77,"\xBBh"],"O"=>[18,"\xBBh"],"P"=>[77,"\xBBl"],"Q"=>[18,"\xBBl"],"R"=>[77,"\xBBm"],"S"=>[18,"\xBBm"],"T"=>[77,"\xBBn"],"U"=>[18,"\xBBn"],"V"=>[77,"\xBBp"],"W"=>[18,"\xBBp"],"X"=>[77,"\xBBr"],"Y"=>[18,"\xBBr"],"Z"=>[77,"\xBBu"],"\x5B"=>[18,"\xBBu"],"\x5C"=>[0,"\xBB\x3A"],"\x5D"=>[0,"\xBBB"],"\x5E"=>[0,"\xBBC"],"_"=>[0,"\xBBD"],"\x60"=>[0,"\xBBE"],"a"=>[0,"\xBBF"],"b"=>[0,"\xBBG"],"c"=>[0,"\xBBH"],"d"=>[0,"\xBBI"],"e"=>[0,"\xBBJ"],"f"=>[0,"\xBBK"],"g"=>[0,"\xBBL"],"h"=>[0,"\xBBM"],"i"=>[0,"\xBBN"],"j"=>[0,"\xBBO"],"k"=>[0,"\xBBP"],"l"=>[0,"\xBBQ"],"m"=>[0,"\xBBR"],"n"=>[0,"\xBBS"],"o"=>[0,"\xBBT"],"p"=>[0,"\xBBU"],"q"=>[0,"\xBBV"],"r"=>[0,"\xBBW"],"s"=>[0,"\xBBY"],"t"=>[0,"\xBBj"],"u"=>[0,"\xBBk"],"v"=>[0,"\xBBq"],"w"=>[0,"\xBBv"],"x"=>[0,"\xBBw"],"y"=>[0,"\xBBx"],"z"=>[0,"\xBBy"],"\x7B"=>[0,"\xBBz"],"\x7C"=>[82,"\xBB"],"\x7D"=>[87,"\xBB"],"~"=>[130,"\xBB"],"\x7F"=>[9,"\xBB"],"\x80"=>[94,"\xBD0"],"\x81"=>[76,"\xBD0"],"\x82"=>[104,"\xBD0"],"\x83"=>[16,"\xBD0"],"\x84"=>[94,"\xBD1"],"\x85"=>[76,"\xBD1"],"\x86"=>[104,"\xBD1"],"\x87"=>[16,"\xBD1"],"\x88"=>[94,"\xBD2"],"\x89"=>[76,"\xBD2"],"\x8A"=>[104,"\xBD2"],"\x8B"=>[16,"\xBD2"],"\x8C"=>[94,"\xBDa"],"\x8D"=>[76,"\xBDa"],"\x8E"=>[104,"\xBDa"],"\x8F"=>[16,"\xBDa"],"\x90"=>[94,"\xBDc"],"\x91"=>[76,"\xBDc"],"\x92"=>[104,"\xBDc"],"\x93"=>[16,"\xBDc"],"\x94"=>[94,"\xBDe"],"\x95"=>[76,"\xBDe"],"\x96"=>[104,"\xBDe"],"\x97"=>[16,"\xBDe"],"\x98"=>[94,"\xBDi"],"\x99"=>[76,"\xBDi"],"\x9A"=>[104,"\xBDi"],"\x9B"=>[16,"\xBDi"],"\x9C"=>[94,"\xBDo"],"\x9D"=>[76,"\xBDo"],"\x9E"=>[104,"\xBDo"],"\x9F"=>[16,"\xBDo"],"\xA0"=>[94,"\xBDs"],"\xA1"=>[76,"\xBDs"],"\xA2"=>[104,"\xBDs"],"\xA3"=>[16,"\xBDs"],"\xA4"=>[94,"\xBDt"],"\xA5"=>[76,"\xBDt"],"\xA6"=>[104,"\xBDt"],"\xA7"=>[16,"\xBDt"],"\xA8"=>[77,"\xBD\x20"],"\xA9"=>[18,"\xBD\x20"],"\xAA"=>[77,"\xBD\x25"],"\xAB"=>[18,"\xBD\x25"],"\xAC"=>[77,"\xBD-"],"\xAD"=>[18,"\xBD-"],"\xAE"=>[77,"\xBD."],"\xAF"=>[18,"\xBD."],"\xB0"=>[77,"\xBD\x2F"],"\xB1"=>[18,"\xBD\x2F"],"\xB2"=>[77,"\xBD3"],"\xB3"=>[18,"\xBD3"],"\xB4"=>[77,"\xBD4"],"\xB5"=>[18,"\xBD4"],"\xB6"=>[77,"\xBD5"],"\xB7"=>[18,"\xBD5"],"\xB8"=>[77,"\xBD6"],"\xB9"=>[18,"\xBD6"],"\xBA"=>[77,"\xBD7"],"\xBB"=>[18,"\xBD7"],"\xBC"=>[77,"\xBD8"],"\xBD"=>[18,"\xBD8"],"\xBE"=>[77,"\xBD9"],"\xBF"=>[18,"\xBD9"],"\xC0"=>[77,"\xBD\x3D"],"\xC1"=>[18,"\xBD\x3D"],"\xC2"=>[77,"\xBDA"],"\xC3"=>[18,"\xBDA"],"\xC4"=>[77,"\xBD_"],"\xC5"=>[18,"\xBD_"],"\xC6"=>[77,"\xBDb"],"\xC7"=>[18,"\xBDb"],"\xC8"=>[77,"\xBDd"],"\xC9"=>[18,"\xBDd"],"\xCA"=>[77,"\xBDf"],"\xCB"=>[18,"\xBDf"],"\xCC"=>[77,"\xBDg"],"\xCD"=>[18,"\xBDg"],"\xCE"=>[77,"\xBDh"],"\xCF"=>[18,"\xBDh"],"\xD0"=>[77,"\xBDl"],"\xD1"=>[18,"\xBDl"],"\xD2"=>[77,"\xBDm"],"\xD3"=>[18,"\xBDm"],"\xD4"=>[77,"\xBDn"],"\xD5"=>[18,"\xBDn"],"\xD6"=>[77,"\xBDp"],"\xD7"=>[18,"\xBDp"],"\xD8"=>[77,"\xBDr"],"\xD9"=>[18,"\xBDr"],"\xDA"=>[77,"\xBDu"],"\xDB"=>[18,"\xBDu"],"\xDC"=>[0,"\xBD\x3A"],"\xDD"=>[0,"\xBDB"],"\xDE"=>[0,"\xBDC"],"\xDF"=>[0,"\xBDD"],"\xE0"=>[0,"\xBDE"],"\xE1"=>[0,"\xBDF"],"\xE2"=>[0,"\xBDG"],"\xE3"=>[0,"\xBDH"],"\xE4"=>[0,"\xBDI"],"\xE5"=>[0,"\xBDJ"],"\xE6"=>[0,"\xBDK"],"\xE7"=>[0,"\xBDL"],"\xE8"=>[0,"\xBDM"],"\xE9"=>[0,"\xBDN"],"\xEA"=>[0,"\xBDO"],"\xEB"=>[0,"\xBDP"],"\xEC"=>[0,"\xBDQ"],"\xED"=>[0,"\xBDR"],"\xEE"=>[0,"\xBDS"],"\xEF"=>[0,"\xBDT"],"\xF0"=>[0,"\xBDU"],"\xF1"=>[0,"\xBDV"],"\xF2"=>[0,"\xBDW"],"\xF3"=>[0,"\xBDY"],"\xF4"=>[0,"\xBDj"],"\xF5"=>[0,"\xBDk"],"\xF6"=>[0,"\xBDq"],"\xF7"=>[0,"\xBDv"],"\xF8"=>[0,"\xBDw"],"\xF9"=>[0,"\xBDx"],"\xFA"=>[0,"\xBDy"],"\xFB"=>[0,"\xBDz"],"\xFC"=>[82,"\xBD"],"\xFD"=>[87,"\xBD"],"\xFE"=>[130,"\xBD"],"\xFF"=>[9,"\xBD"],],["\x00"=>[77,"\xBB0"],"\x01"=>[18,"\xBB0"],"\x02"=>[77,"\xBB1"],"\x03"=>[18,"\xBB1"],"\x04"=>[77,"\xBB2"],"\x05"=>[18,"\xBB2"],"\x06"=>[77,"\xBBa"],"\x07"=>[18,"\xBBa"],"\x08"=>[77,"\xBBc"],"\x09"=>[18,"\xBBc"],"\x0A"=>[77,"\xBBe"],"\x0B"=>[18,"\xBBe"],"\x0C"=>[77,"\xBBi"],"\x0D"=>[18,"\xBBi"],"\x0E"=>[77,"\xBBo"],"\x0F"=>[18,"\xBBo"],"\x10"=>[77,"\xBBs"],"\x11"=>[18,"\xBBs"],"\x12"=>[77,"\xBBt"],"\x13"=>[18,"\xBBt"],"\x14"=>[0,"\xBB\x20"],"\x15"=>[0,"\xBB\x25"],"\x16"=>[0,"\xBB-"],"\x17"=>[0,"\xBB."],"\x18"=>[0,"\xBB\x2F"],"\x19"=>[0,"\xBB3"],"\x1A"=>[0,"\xBB4"],"\x1B"=>[0,"\xBB5"],"\x1C"=>[0,"\xBB6"],"\x1D"=>[0,"\xBB7"],"\x1E"=>[0,"\xBB8"],"\x1F"=>[0,"\xBB9"],"\x20"=>[0,"\xBB\x3D"],"\x21"=>[0,"\xBBA"],"\x22"=>[0,"\xBB_"],"\x23"=>[0,"\xBBb"],"\x24"=>[0,"\xBBd"],"\x25"=>[0,"\xBBf"],"\x26"=>[0,"\xBBg"],"\x27"=>[0,"\xBBh"],"\x28"=>[0,"\xBBl"],"\x29"=>[0,"\xBBm"],"\x2A"=>[0,"\xBBn"],"\x2B"=>[0,"\xBBp"],"\x2C"=>[0,"\xBBr"],"-"=>[0,"\xBBu"],"."=>[100,"\xBB"],"\x2F"=>[110,"\xBB"],[111,"\xBB"],[115,"\xBB"],[116,"\xBB"],[118,"\xBB"],[119,"\xBB"],[122,"\xBB"],[123,"\xBB"],[125,"\xBB"],[126,"\xBB"],[129,"\xBB"],"\x3A"=>[143,"\xBB"],"\x3B"=>[148,"\xBB"],"\x3C"=>[151,"\xBB"],"\x3D"=>[153,"\xBB"],"\x3E"=>[83,"\xBB"],"\x3F"=>[10,"\xBB"],"\x40"=>[77,"\xBD0"],"A"=>[18,"\xBD0"],"B"=>[77,"\xBD1"],"C"=>[18,"\xBD1"],"D"=>[77,"\xBD2"],"E"=>[18,"\xBD2"],"F"=>[77,"\xBDa"],"G"=>[18,"\xBDa"],"H"=>[77,"\xBDc"],"I"=>[18,"\xBDc"],"J"=>[77,"\xBDe"],"K"=>[18,"\xBDe"],"L"=>[77,"\xBDi"],"M"=>[18,"\xBDi"],"N"=>[77,"\xBDo"],"O"=>[18,"\xBDo"],"P"=>[77,"\xBDs"],"Q"=>[18,"\xBDs"],"R"=>[77,"\xBDt"],"S"=>[18,"\xBDt"],"T"=>[0,"\xBD\x20"],"U"=>[0,"\xBD\x25"],"V"=>[0,"\xBD-"],"W"=>[0,"\xBD."],"X"=>[0,"\xBD\x2F"],"Y"=>[0,"\xBD3"],"Z"=>[0,"\xBD4"],"\x5B"=>[0,"\xBD5"],"\x5C"=>[0,"\xBD6"],"\x5D"=>[0,"\xBD7"],"\x5E"=>[0,"\xBD8"],"_"=>[0,"\xBD9"],"\x60"=>[0,"\xBD\x3D"],"a"=>[0,"\xBDA"],"b"=>[0,"\xBD_"],"c"=>[0,"\xBDb"],"d"=>[0,"\xBDd"],"e"=>[0,"\xBDf"],"f"=>[0,"\xBDg"],"g"=>[0,"\xBDh"],"h"=>[0,"\xBDl"],"i"=>[0,"\xBDm"],"j"=>[0,"\xBDn"],"k"=>[0,"\xBDp"],"l"=>[0,"\xBDr"],"m"=>[0,"\xBDu"],"n"=>[100,"\xBD"],"o"=>[110,"\xBD"],"p"=>[111,"\xBD"],"q"=>[115,"\xBD"],"r"=>[116,"\xBD"],"s"=>[118,"\xBD"],"t"=>[119,"\xBD"],"u"=>[122,"\xBD"],"v"=>[123,"\xBD"],"w"=>[125,"\xBD"],"x"=>[126,"\xBD"],"y"=>[129,"\xBD"],"z"=>[143,"\xBD"],"\x7B"=>[148,"\xBD"],"\x7C"=>[151,"\xBD"],"\x7D"=>[153,"\xBD"],"~"=>[83,"\xBD"],"\x7F"=>[10,"\xBD"],"\x80"=>[77,"\xBE0"],"\x81"=>[18,"\xBE0"],"\x82"=>[77,"\xBE1"],"\x83"=>[18,"\xBE1"],"\x84"=>[77,"\xBE2"],"\x85"=>[18,"\xBE2"],"\x86"=>[77,"\xBEa"],"\x87"=>[18,"\xBEa"],"\x88"=>[77,"\xBEc"],"\x89"=>[18,"\xBEc"],"\x8A"=>[77,"\xBEe"],"\x8B"=>[18,"\xBEe"],"\x8C"=>[77,"\xBEi"],"\x8D"=>[18,"\xBEi"],"\x8E"=>[77,"\xBEo"],"\x8F"=>[18,"\xBEo"],"\x90"=>[77,"\xBEs"],"\x91"=>[18,"\xBEs"],"\x92"=>[77,"\xBEt"],"\x93"=>[18,"\xBEt"],"\x94"=>[0,"\xBE\x20"],"\x95"=>[0,"\xBE\x25"],"\x96"=>[0,"\xBE-"],"\x97"=>[0,"\xBE."],"\x98"=>[0,"\xBE\x2F"],"\x99"=>[0,"\xBE3"],"\x9A"=>[0,"\xBE4"],"\x9B"=>[0,"\xBE5"],"\x9C"=>[0,"\xBE6"],"\x9D"=>[0,"\xBE7"],"\x9E"=>[0,"\xBE8"],"\x9F"=>[0,"\xBE9"],"\xA0"=>[0,"\xBE\x3D"],"\xA1"=>[0,"\xBEA"],"\xA2"=>[0,"\xBE_"],"\xA3"=>[0,"\xBEb"],"\xA4"=>[0,"\xBEd"],"\xA5"=>[0,"\xBEf"],"\xA6"=>[0,"\xBEg"],"\xA7"=>[0,"\xBEh"],"\xA8"=>[0,"\xBEl"],"\xA9"=>[0,"\xBEm"],"\xAA"=>[0,"\xBEn"],"\xAB"=>[0,"\xBEp"],"\xAC"=>[0,"\xBEr"],"\xAD"=>[0,"\xBEu"],"\xAE"=>[100,"\xBE"],"\xAF"=>[110,"\xBE"],"\xB0"=>[111,"\xBE"],"\xB1"=>[115,"\xBE"],"\xB2"=>[116,"\xBE"],"\xB3"=>[118,"\xBE"],"\xB4"=>[119,"\xBE"],"\xB5"=>[122,"\xBE"],"\xB6"=>[123,"\xBE"],"\xB7"=>[125,"\xBE"],"\xB8"=>[126,"\xBE"],"\xB9"=>[129,"\xBE"],"\xBA"=>[143,"\xBE"],"\xBB"=>[148,"\xBE"],"\xBC"=>[151,"\xBE"],"\xBD"=>[153,"\xBE"],"\xBE"=>[83,"\xBE"],"\xBF"=>[10,"\xBE"],"\xC0"=>[77,"\xC40"],"\xC1"=>[18,"\xC40"],"\xC2"=>[77,"\xC41"],"\xC3"=>[18,"\xC41"],"\xC4"=>[77,"\xC42"],"\xC5"=>[18,"\xC42"],"\xC6"=>[77,"\xC4a"],"\xC7"=>[18,"\xC4a"],"\xC8"=>[77,"\xC4c"],"\xC9"=>[18,"\xC4c"],"\xCA"=>[77,"\xC4e"],"\xCB"=>[18,"\xC4e"],"\xCC"=>[77,"\xC4i"],"\xCD"=>[18,"\xC4i"],"\xCE"=>[77,"\xC4o"],"\xCF"=>[18,"\xC4o"],"\xD0"=>[77,"\xC4s"],"\xD1"=>[18,"\xC4s"],"\xD2"=>[77,"\xC4t"],"\xD3"=>[18,"\xC4t"],"\xD4"=>[0,"\xC4\x20"],"\xD5"=>[0,"\xC4\x25"],"\xD6"=>[0,"\xC4-"],"\xD7"=>[0,"\xC4."],"\xD8"=>[0,"\xC4\x2F"],"\xD9"=>[0,"\xC43"],"\xDA"=>[0,"\xC44"],"\xDB"=>[0,"\xC45"],"\xDC"=>[0,"\xC46"],"\xDD"=>[0,"\xC47"],"\xDE"=>[0,"\xC48"],"\xDF"=>[0,"\xC49"],"\xE0"=>[0,"\xC4\x3D"],"\xE1"=>[0,"\xC4A"],"\xE2"=>[0,"\xC4_"],"\xE3"=>[0,"\xC4b"],"\xE4"=>[0,"\xC4d"],"\xE5"=>[0,"\xC4f"],"\xE6"=>[0,"\xC4g"],"\xE7"=>[0,"\xC4h"],"\xE8"=>[0,"\xC4l"],"\xE9"=>[0,"\xC4m"],"\xEA"=>[0,"\xC4n"],"\xEB"=>[0,"\xC4p"],"\xEC"=>[0,"\xC4r"],"\xED"=>[0,"\xC4u"],"\xEE"=>[100,"\xC4"],"\xEF"=>[110,"\xC4"],"\xF0"=>[111,"\xC4"],"\xF1"=>[115,"\xC4"],"\xF2"=>[116,"\xC4"],"\xF3"=>[118,"\xC4"],"\xF4"=>[119,"\xC4"],"\xF5"=>[122,"\xC4"],"\xF6"=>[123,"\xC4"],"\xF7"=>[125,"\xC4"],"\xF8"=>[126,"\xC4"],"\xF9"=>[129,"\xC4"],"\xFA"=>[143,"\xC4"],"\xFB"=>[148,"\xC4"],"\xFC"=>[151,"\xC4"],"\xFD"=>[153,"\xC4"],"\xFE"=>[83,"\xC4"],"\xFF"=>[10,"\xC4"],],["\x00"=>[94,"\xBC0"],"\x01"=>[76,"\xBC0"],"\x02"=>[104,"\xBC0"],"\x03"=>[16,"\xBC0"],"\x04"=>[94,"\xBC1"],"\x05"=>[76,"\xBC1"],"\x06"=>[104,"\xBC1"],"\x07"=>[16,"\xBC1"],"\x08"=>[94,"\xBC2"],"\x09"=>[76,"\xBC2"],"\x0A"=>[104,"\xBC2"],"\x0B"=>[16,"\xBC2"],"\x0C"=>[94,"\xBCa"],"\x0D"=>[76,"\xBCa"],"\x0E"=>[104,"\xBCa"],"\x0F"=>[16,"\xBCa"],"\x10"=>[94,"\xBCc"],"\x11"=>[76,"\xBCc"],"\x12"=>[104,"\xBCc"],"\x13"=>[16,"\xBCc"],"\x14"=>[94,"\xBCe"],"\x15"=>[76,"\xBCe"],"\x16"=>[104,"\xBCe"],"\x17"=>[16,"\xBCe"],"\x18"=>[94,"\xBCi"],"\x19"=>[76,"\xBCi"],"\x1A"=>[104,"\xBCi"],"\x1B"=>[16,"\xBCi"],"\x1C"=>[94,"\xBCo"],"\x1D"=>[76,"\xBCo"],"\x1E"=>[104,"\xBCo"],"\x1F"=>[16,"\xBCo"],"\x20"=>[94,"\xBCs"],"\x21"=>[76,"\xBCs"],"\x22"=>[104,"\xBCs"],"\x23"=>[16,"\xBCs"],"\x24"=>[94,"\xBCt"],"\x25"=>[76,"\xBCt"],"\x26"=>[104,"\xBCt"],"\x27"=>[16,"\xBCt"],"\x28"=>[77,"\xBC\x20"],"\x29"=>[18,"\xBC\x20"],"\x2A"=>[77,"\xBC\x25"],"\x2B"=>[18,"\xBC\x25"],"\x2C"=>[77,"\xBC-"],"-"=>[18,"\xBC-"],"."=>[77,"\xBC."],"\x2F"=>[18,"\xBC."],[77,"\xBC\x2F"],[18,"\xBC\x2F"],[77,"\xBC3"],[18,"\xBC3"],[77,"\xBC4"],[18,"\xBC4"],[77,"\xBC5"],[18,"\xBC5"],[77,"\xBC6"],[18,"\xBC6"],"\x3A"=>[77,"\xBC7"],"\x3B"=>[18,"\xBC7"],"\x3C"=>[77,"\xBC8"],"\x3D"=>[18,"\xBC8"],"\x3E"=>[77,"\xBC9"],"\x3F"=>[18,"\xBC9"],"\x40"=>[77,"\xBC\x3D"],"A"=>[18,"\xBC\x3D"],"B"=>[77,"\xBCA"],"C"=>[18,"\xBCA"],"D"=>[77,"\xBC_"],"E"=>[18,"\xBC_"],"F"=>[77,"\xBCb"],"G"=>[18,"\xBCb"],"H"=>[77,"\xBCd"],"I"=>[18,"\xBCd"],"J"=>[77,"\xBCf"],"K"=>[18,"\xBCf"],"L"=>[77,"\xBCg"],"M"=>[18,"\xBCg"],"N"=>[77,"\xBCh"],"O"=>[18,"\xBCh"],"P"=>[77,"\xBCl"],"Q"=>[18,"\xBCl"],"R"=>[77,"\xBCm"],"S"=>[18,"\xBCm"],"T"=>[77,"\xBCn"],"U"=>[18,"\xBCn"],"V"=>[77,"\xBCp"],"W"=>[18,"\xBCp"],"X"=>[77,"\xBCr"],"Y"=>[18,"\xBCr"],"Z"=>[77,"\xBCu"],"\x5B"=>[18,"\xBCu"],"\x5C"=>[0,"\xBC\x3A"],"\x5D"=>[0,"\xBCB"],"\x5E"=>[0,"\xBCC"],"_"=>[0,"\xBCD"],"\x60"=>[0,"\xBCE"],"a"=>[0,"\xBCF"],"b"=>[0,"\xBCG"],"c"=>[0,"\xBCH"],"d"=>[0,"\xBCI"],"e"=>[0,"\xBCJ"],"f"=>[0,"\xBCK"],"g"=>[0,"\xBCL"],"h"=>[0,"\xBCM"],"i"=>[0,"\xBCN"],"j"=>[0,"\xBCO"],"k"=>[0,"\xBCP"],"l"=>[0,"\xBCQ"],"m"=>[0,"\xBCR"],"n"=>[0,"\xBCS"],"o"=>[0,"\xBCT"],"p"=>[0,"\xBCU"],"q"=>[0,"\xBCV"],"r"=>[0,"\xBCW"],"s"=>[0,"\xBCY"],"t"=>[0,"\xBCj"],"u"=>[0,"\xBCk"],"v"=>[0,"\xBCq"],"w"=>[0,"\xBCv"],"x"=>[0,"\xBCw"],"y"=>[0,"\xBCx"],"z"=>[0,"\xBCy"],"\x7B"=>[0,"\xBCz"],"\x7C"=>[82,"\xBC"],"\x7D"=>[87,"\xBC"],"~"=>[130,"\xBC"],"\x7F"=>[9,"\xBC"],"\x80"=>[94,"\xBF0"],"\x81"=>[76,"\xBF0"],"\x82"=>[104,"\xBF0"],"\x83"=>[16,"\xBF0"],"\x84"=>[94,"\xBF1"],"\x85"=>[76,"\xBF1"],"\x86"=>[104,"\xBF1"],"\x87"=>[16,"\xBF1"],"\x88"=>[94,"\xBF2"],"\x89"=>[76,"\xBF2"],"\x8A"=>[104,"\xBF2"],"\x8B"=>[16,"\xBF2"],"\x8C"=>[94,"\xBFa"],"\x8D"=>[76,"\xBFa"],"\x8E"=>[104,"\xBFa"],"\x8F"=>[16,"\xBFa"],"\x90"=>[94,"\xBFc"],"\x91"=>[76,"\xBFc"],"\x92"=>[104,"\xBFc"],"\x93"=>[16,"\xBFc"],"\x94"=>[94,"\xBFe"],"\x95"=>[76,"\xBFe"],"\x96"=>[104,"\xBFe"],"\x97"=>[16,"\xBFe"],"\x98"=>[94,"\xBFi"],"\x99"=>[76,"\xBFi"],"\x9A"=>[104,"\xBFi"],"\x9B"=>[16,"\xBFi"],"\x9C"=>[94,"\xBFo"],"\x9D"=>[76,"\xBFo"],"\x9E"=>[104,"\xBFo"],"\x9F"=>[16,"\xBFo"],"\xA0"=>[94,"\xBFs"],"\xA1"=>[76,"\xBFs"],"\xA2"=>[104,"\xBFs"],"\xA3"=>[16,"\xBFs"],"\xA4"=>[94,"\xBFt"],"\xA5"=>[76,"\xBFt"],"\xA6"=>[104,"\xBFt"],"\xA7"=>[16,"\xBFt"],"\xA8"=>[77,"\xBF\x20"],"\xA9"=>[18,"\xBF\x20"],"\xAA"=>[77,"\xBF\x25"],"\xAB"=>[18,"\xBF\x25"],"\xAC"=>[77,"\xBF-"],"\xAD"=>[18,"\xBF-"],"\xAE"=>[77,"\xBF."],"\xAF"=>[18,"\xBF."],"\xB0"=>[77,"\xBF\x2F"],"\xB1"=>[18,"\xBF\x2F"],"\xB2"=>[77,"\xBF3"],"\xB3"=>[18,"\xBF3"],"\xB4"=>[77,"\xBF4"],"\xB5"=>[18,"\xBF4"],"\xB6"=>[77,"\xBF5"],"\xB7"=>[18,"\xBF5"],"\xB8"=>[77,"\xBF6"],"\xB9"=>[18,"\xBF6"],"\xBA"=>[77,"\xBF7"],"\xBB"=>[18,"\xBF7"],"\xBC"=>[77,"\xBF8"],"\xBD"=>[18,"\xBF8"],"\xBE"=>[77,"\xBF9"],"\xBF"=>[18,"\xBF9"],"\xC0"=>[77,"\xBF\x3D"],"\xC1"=>[18,"\xBF\x3D"],"\xC2"=>[77,"\xBFA"],"\xC3"=>[18,"\xBFA"],"\xC4"=>[77,"\xBF_"],"\xC5"=>[18,"\xBF_"],"\xC6"=>[77,"\xBFb"],"\xC7"=>[18,"\xBFb"],"\xC8"=>[77,"\xBFd"],"\xC9"=>[18,"\xBFd"],"\xCA"=>[77,"\xBFf"],"\xCB"=>[18,"\xBFf"],"\xCC"=>[77,"\xBFg"],"\xCD"=>[18,"\xBFg"],"\xCE"=>[77,"\xBFh"],"\xCF"=>[18,"\xBFh"],"\xD0"=>[77,"\xBFl"],"\xD1"=>[18,"\xBFl"],"\xD2"=>[77,"\xBFm"],"\xD3"=>[18,"\xBFm"],"\xD4"=>[77,"\xBFn"],"\xD5"=>[18,"\xBFn"],"\xD6"=>[77,"\xBFp"],"\xD7"=>[18,"\xBFp"],"\xD8"=>[77,"\xBFr"],"\xD9"=>[18,"\xBFr"],"\xDA"=>[77,"\xBFu"],"\xDB"=>[18,"\xBFu"],"\xDC"=>[0,"\xBF\x3A"],"\xDD"=>[0,"\xBFB"],"\xDE"=>[0,"\xBFC"],"\xDF"=>[0,"\xBFD"],"\xE0"=>[0,"\xBFE"],"\xE1"=>[0,"\xBFF"],"\xE2"=>[0,"\xBFG"],"\xE3"=>[0,"\xBFH"],"\xE4"=>[0,"\xBFI"],"\xE5"=>[0,"\xBFJ"],"\xE6"=>[0,"\xBFK"],"\xE7"=>[0,"\xBFL"],"\xE8"=>[0,"\xBFM"],"\xE9"=>[0,"\xBFN"],"\xEA"=>[0,"\xBFO"],"\xEB"=>[0,"\xBFP"],"\xEC"=>[0,"\xBFQ"],"\xED"=>[0,"\xBFR"],"\xEE"=>[0,"\xBFS"],"\xEF"=>[0,"\xBFT"],"\xF0"=>[0,"\xBFU"],"\xF1"=>[0,"\xBFV"],"\xF2"=>[0,"\xBFW"],"\xF3"=>[0,"\xBFY"],"\xF4"=>[0,"\xBFj"],"\xF5"=>[0,"\xBFk"],"\xF6"=>[0,"\xBFq"],"\xF7"=>[0,"\xBFv"],"\xF8"=>[0,"\xBFw"],"\xF9"=>[0,"\xBFx"],"\xFA"=>[0,"\xBFy"],"\xFB"=>[0,"\xBFz"],"\xFC"=>[82,"\xBF"],"\xFD"=>[87,"\xBF"],"\xFE"=>[130,"\xBF"],"\xFF"=>[9,"\xBF"],],["\x00"=>[77,"\xBC0"],"\x01"=>[18,"\xBC0"],"\x02"=>[77,"\xBC1"],"\x03"=>[18,"\xBC1"],"\x04"=>[77,"\xBC2"],"\x05"=>[18,"\xBC2"],"\x06"=>[77,"\xBCa"],"\x07"=>[18,"\xBCa"],"\x08"=>[77,"\xBCc"],"\x09"=>[18,"\xBCc"],"\x0A"=>[77,"\xBCe"],"\x0B"=>[18,"\xBCe"],"\x0C"=>[77,"\xBCi"],"\x0D"=>[18,"\xBCi"],"\x0E"=>[77,"\xBCo"],"\x0F"=>[18,"\xBCo"],"\x10"=>[77,"\xBCs"],"\x11"=>[18,"\xBCs"],"\x12"=>[77,"\xBCt"],"\x13"=>[18,"\xBCt"],"\x14"=>[0,"\xBC\x20"],"\x15"=>[0,"\xBC\x25"],"\x16"=>[0,"\xBC-"],"\x17"=>[0,"\xBC."],"\x18"=>[0,"\xBC\x2F"],"\x19"=>[0,"\xBC3"],"\x1A"=>[0,"\xBC4"],"\x1B"=>[0,"\xBC5"],"\x1C"=>[0,"\xBC6"],"\x1D"=>[0,"\xBC7"],"\x1E"=>[0,"\xBC8"],"\x1F"=>[0,"\xBC9"],"\x20"=>[0,"\xBC\x3D"],"\x21"=>[0,"\xBCA"],"\x22"=>[0,"\xBC_"],"\x23"=>[0,"\xBCb"],"\x24"=>[0,"\xBCd"],"\x25"=>[0,"\xBCf"],"\x26"=>[0,"\xBCg"],"\x27"=>[0,"\xBCh"],"\x28"=>[0,"\xBCl"],"\x29"=>[0,"\xBCm"],"\x2A"=>[0,"\xBCn"],"\x2B"=>[0,"\xBCp"],"\x2C"=>[0,"\xBCr"],"-"=>[0,"\xBCu"],"."=>[100,"\xBC"],"\x2F"=>[110,"\xBC"],[111,"\xBC"],[115,"\xBC"],[116,"\xBC"],[118,"\xBC"],[119,"\xBC"],[122,"\xBC"],[123,"\xBC"],[125,"\xBC"],[126,"\xBC"],[129,"\xBC"],"\x3A"=>[143,"\xBC"],"\x3B"=>[148,"\xBC"],"\x3C"=>[151,"\xBC"],"\x3D"=>[153,"\xBC"],"\x3E"=>[83,"\xBC"],"\x3F"=>[10,"\xBC"],"\x40"=>[77,"\xBF0"],"A"=>[18,"\xBF0"],"B"=>[77,"\xBF1"],"C"=>[18,"\xBF1"],"D"=>[77,"\xBF2"],"E"=>[18,"\xBF2"],"F"=>[77,"\xBFa"],"G"=>[18,"\xBFa"],"H"=>[77,"\xBFc"],"I"=>[18,"\xBFc"],"J"=>[77,"\xBFe"],"K"=>[18,"\xBFe"],"L"=>[77,"\xBFi"],"M"=>[18,"\xBFi"],"N"=>[77,"\xBFo"],"O"=>[18,"\xBFo"],"P"=>[77,"\xBFs"],"Q"=>[18,"\xBFs"],"R"=>[77,"\xBFt"],"S"=>[18,"\xBFt"],"T"=>[0,"\xBF\x20"],"U"=>[0,"\xBF\x25"],"V"=>[0,"\xBF-"],"W"=>[0,"\xBF."],"X"=>[0,"\xBF\x2F"],"Y"=>[0,"\xBF3"],"Z"=>[0,"\xBF4"],"\x5B"=>[0,"\xBF5"],"\x5C"=>[0,"\xBF6"],"\x5D"=>[0,"\xBF7"],"\x5E"=>[0,"\xBF8"],"_"=>[0,"\xBF9"],"\x60"=>[0,"\xBF\x3D"],"a"=>[0,"\xBFA"],"b"=>[0,"\xBF_"],"c"=>[0,"\xBFb"],"d"=>[0,"\xBFd"],"e"=>[0,"\xBFf"],"f"=>[0,"\xBFg"],"g"=>[0,"\xBFh"],"h"=>[0,"\xBFl"],"i"=>[0,"\xBFm"],"j"=>[0,"\xBFn"],"k"=>[0,"\xBFp"],"l"=>[0,"\xBFr"],"m"=>[0,"\xBFu"],"n"=>[100,"\xBF"],"o"=>[110,"\xBF"],"p"=>[111,"\xBF"],"q"=>[115,"\xBF"],"r"=>[116,"\xBF"],"s"=>[118,"\xBF"],"t"=>[119,"\xBF"],"u"=>[122,"\xBF"],"v"=>[123,"\xBF"],"w"=>[125,"\xBF"],"x"=>[126,"\xBF"],"y"=>[129,"\xBF"],"z"=>[143,"\xBF"],"\x7B"=>[148,"\xBF"],"\x7C"=>[151,"\xBF"],"\x7D"=>[153,"\xBF"],"~"=>[83,"\xBF"],"\x7F"=>[10,"\xBF"],"\x80"=>[77,"\xC50"],"\x81"=>[18,"\xC50"],"\x82"=>[77,"\xC51"],"\x83"=>[18,"\xC51"],"\x84"=>[77,"\xC52"],"\x85"=>[18,"\xC52"],"\x86"=>[77,"\xC5a"],"\x87"=>[18,"\xC5a"],"\x88"=>[77,"\xC5c"],"\x89"=>[18,"\xC5c"],"\x8A"=>[77,"\xC5e"],"\x8B"=>[18,"\xC5e"],"\x8C"=>[77,"\xC5i"],"\x8D"=>[18,"\xC5i"],"\x8E"=>[77,"\xC5o"],"\x8F"=>[18,"\xC5o"],"\x90"=>[77,"\xC5s"],"\x91"=>[18,"\xC5s"],"\x92"=>[77,"\xC5t"],"\x93"=>[18,"\xC5t"],"\x94"=>[0,"\xC5\x20"],"\x95"=>[0,"\xC5\x25"],"\x96"=>[0,"\xC5-"],"\x97"=>[0,"\xC5."],"\x98"=>[0,"\xC5\x2F"],"\x99"=>[0,"\xC53"],"\x9A"=>[0,"\xC54"],"\x9B"=>[0,"\xC55"],"\x9C"=>[0,"\xC56"],"\x9D"=>[0,"\xC57"],"\x9E"=>[0,"\xC58"],"\x9F"=>[0,"\xC59"],"\xA0"=>[0,"\xC5\x3D"],"\xA1"=>[0,"\xC5A"],"\xA2"=>[0,"\xC5_"],"\xA3"=>[0,"\xC5b"],"\xA4"=>[0,"\xC5d"],"\xA5"=>[0,"\xC5f"],"\xA6"=>[0,"\xC5g"],"\xA7"=>[0,"\xC5h"],"\xA8"=>[0,"\xC5l"],"\xA9"=>[0,"\xC5m"],"\xAA"=>[0,"\xC5n"],"\xAB"=>[0,"\xC5p"],"\xAC"=>[0,"\xC5r"],"\xAD"=>[0,"\xC5u"],"\xAE"=>[100,"\xC5"],"\xAF"=>[110,"\xC5"],"\xB0"=>[111,"\xC5"],"\xB1"=>[115,"\xC5"],"\xB2"=>[116,"\xC5"],"\xB3"=>[118,"\xC5"],"\xB4"=>[119,"\xC5"],"\xB5"=>[122,"\xC5"],"\xB6"=>[123,"\xC5"],"\xB7"=>[125,"\xC5"],"\xB8"=>[126,"\xC5"],"\xB9"=>[129,"\xC5"],"\xBA"=>[143,"\xC5"],"\xBB"=>[148,"\xC5"],"\xBC"=>[151,"\xC5"],"\xBD"=>[153,"\xC5"],"\xBE"=>[83,"\xC5"],"\xBF"=>[10,"\xC5"],"\xC0"=>[77,"\xE70"],"\xC1"=>[18,"\xE70"],"\xC2"=>[77,"\xE71"],"\xC3"=>[18,"\xE71"],"\xC4"=>[77,"\xE72"],"\xC5"=>[18,"\xE72"],"\xC6"=>[77,"\xE7a"],"\xC7"=>[18,"\xE7a"],"\xC8"=>[77,"\xE7c"],"\xC9"=>[18,"\xE7c"],"\xCA"=>[77,"\xE7e"],"\xCB"=>[18,"\xE7e"],"\xCC"=>[77,"\xE7i"],"\xCD"=>[18,"\xE7i"],"\xCE"=>[77,"\xE7o"],"\xCF"=>[18,"\xE7o"],"\xD0"=>[77,"\xE7s"],"\xD1"=>[18,"\xE7s"],"\xD2"=>[77,"\xE7t"],"\xD3"=>[18,"\xE7t"],"\xD4"=>[0,"\xE7\x20"],"\xD5"=>[0,"\xE7\x25"],"\xD6"=>[0,"\xE7-"],"\xD7"=>[0,"\xE7."],"\xD8"=>[0,"\xE7\x2F"],"\xD9"=>[0,"\xE73"],"\xDA"=>[0,"\xE74"],"\xDB"=>[0,"\xE75"],"\xDC"=>[0,"\xE76"],"\xDD"=>[0,"\xE77"],"\xDE"=>[0,"\xE78"],"\xDF"=>[0,"\xE79"],"\xE0"=>[0,"\xE7\x3D"],"\xE1"=>[0,"\xE7A"],"\xE2"=>[0,"\xE7_"],"\xE3"=>[0,"\xE7b"],"\xE4"=>[0,"\xE7d"],"\xE5"=>[0,"\xE7f"],"\xE6"=>[0,"\xE7g"],"\xE7"=>[0,"\xE7h"],"\xE8"=>[0,"\xE7l"],"\xE9"=>[0,"\xE7m"],"\xEA"=>[0,"\xE7n"],"\xEB"=>[0,"\xE7p"],"\xEC"=>[0,"\xE7r"],"\xED"=>[0,"\xE7u"],"\xEE"=>[100,"\xE7"],"\xEF"=>[110,"\xE7"],"\xF0"=>[111,"\xE7"],"\xF1"=>[115,"\xE7"],"\xF2"=>[116,"\xE7"],"\xF3"=>[118,"\xE7"],"\xF4"=>[119,"\xE7"],"\xF5"=>[122,"\xE7"],"\xF6"=>[123,"\xE7"],"\xF7"=>[125,"\xE7"],"\xF8"=>[126,"\xE7"],"\xF9"=>[129,"\xE7"],"\xFA"=>[143,"\xE7"],"\xFB"=>[148,"\xE7"],"\xFC"=>[151,"\xE7"],"\xFD"=>[153,"\xE7"],"\xFE"=>[83,"\xE7"],"\xFF"=>[10,"\xE7"],],["\x00"=>[94,"\xBE0"],"\x01"=>[76,"\xBE0"],"\x02"=>[104,"\xBE0"],"\x03"=>[16,"\xBE0"],"\x04"=>[94,"\xBE1"],"\x05"=>[76,"\xBE1"],"\x06"=>[104,"\xBE1"],"\x07"=>[16,"\xBE1"],"\x08"=>[94,"\xBE2"],"\x09"=>[76,"\xBE2"],"\x0A"=>[104,"\xBE2"],"\x0B"=>[16,"\xBE2"],"\x0C"=>[94,"\xBEa"],"\x0D"=>[76,"\xBEa"],"\x0E"=>[104,"\xBEa"],"\x0F"=>[16,"\xBEa"],"\x10"=>[94,"\xBEc"],"\x11"=>[76,"\xBEc"],"\x12"=>[104,"\xBEc"],"\x13"=>[16,"\xBEc"],"\x14"=>[94,"\xBEe"],"\x15"=>[76,"\xBEe"],"\x16"=>[104,"\xBEe"],"\x17"=>[16,"\xBEe"],"\x18"=>[94,"\xBEi"],"\x19"=>[76,"\xBEi"],"\x1A"=>[104,"\xBEi"],"\x1B"=>[16,"\xBEi"],"\x1C"=>[94,"\xBEo"],"\x1D"=>[76,"\xBEo"],"\x1E"=>[104,"\xBEo"],"\x1F"=>[16,"\xBEo"],"\x20"=>[94,"\xBEs"],"\x21"=>[76,"\xBEs"],"\x22"=>[104,"\xBEs"],"\x23"=>[16,"\xBEs"],"\x24"=>[94,"\xBEt"],"\x25"=>[76,"\xBEt"],"\x26"=>[104,"\xBEt"],"\x27"=>[16,"\xBEt"],"\x28"=>[77,"\xBE\x20"],"\x29"=>[18,"\xBE\x20"],"\x2A"=>[77,"\xBE\x25"],"\x2B"=>[18,"\xBE\x25"],"\x2C"=>[77,"\xBE-"],"-"=>[18,"\xBE-"],"."=>[77,"\xBE."],"\x2F"=>[18,"\xBE."],[77,"\xBE\x2F"],[18,"\xBE\x2F"],[77,"\xBE3"],[18,"\xBE3"],[77,"\xBE4"],[18,"\xBE4"],[77,"\xBE5"],[18,"\xBE5"],[77,"\xBE6"],[18,"\xBE6"],"\x3A"=>[77,"\xBE7"],"\x3B"=>[18,"\xBE7"],"\x3C"=>[77,"\xBE8"],"\x3D"=>[18,"\xBE8"],"\x3E"=>[77,"\xBE9"],"\x3F"=>[18,"\xBE9"],"\x40"=>[77,"\xBE\x3D"],"A"=>[18,"\xBE\x3D"],"B"=>[77,"\xBEA"],"C"=>[18,"\xBEA"],"D"=>[77,"\xBE_"],"E"=>[18,"\xBE_"],"F"=>[77,"\xBEb"],"G"=>[18,"\xBEb"],"H"=>[77,"\xBEd"],"I"=>[18,"\xBEd"],"J"=>[77,"\xBEf"],"K"=>[18,"\xBEf"],"L"=>[77,"\xBEg"],"M"=>[18,"\xBEg"],"N"=>[77,"\xBEh"],"O"=>[18,"\xBEh"],"P"=>[77,"\xBEl"],"Q"=>[18,"\xBEl"],"R"=>[77,"\xBEm"],"S"=>[18,"\xBEm"],"T"=>[77,"\xBEn"],"U"=>[18,"\xBEn"],"V"=>[77,"\xBEp"],"W"=>[18,"\xBEp"],"X"=>[77,"\xBEr"],"Y"=>[18,"\xBEr"],"Z"=>[77,"\xBEu"],"\x5B"=>[18,"\xBEu"],"\x5C"=>[0,"\xBE\x3A"],"\x5D"=>[0,"\xBEB"],"\x5E"=>[0,"\xBEC"],"_"=>[0,"\xBED"],"\x60"=>[0,"\xBEE"],"a"=>[0,"\xBEF"],"b"=>[0,"\xBEG"],"c"=>[0,"\xBEH"],"d"=>[0,"\xBEI"],"e"=>[0,"\xBEJ"],"f"=>[0,"\xBEK"],"g"=>[0,"\xBEL"],"h"=>[0,"\xBEM"],"i"=>[0,"\xBEN"],"j"=>[0,"\xBEO"],"k"=>[0,"\xBEP"],"l"=>[0,"\xBEQ"],"m"=>[0,"\xBER"],"n"=>[0,"\xBES"],"o"=>[0,"\xBET"],"p"=>[0,"\xBEU"],"q"=>[0,"\xBEV"],"r"=>[0,"\xBEW"],"s"=>[0,"\xBEY"],"t"=>[0,"\xBEj"],"u"=>[0,"\xBEk"],"v"=>[0,"\xBEq"],"w"=>[0,"\xBEv"],"x"=>[0,"\xBEw"],"y"=>[0,"\xBEx"],"z"=>[0,"\xBEy"],"\x7B"=>[0,"\xBEz"],"\x7C"=>[82,"\xBE"],"\x7D"=>[87,"\xBE"],"~"=>[130,"\xBE"],"\x7F"=>[9,"\xBE"],"\x80"=>[94,"\xC40"],"\x81"=>[76,"\xC40"],"\x82"=>[104,"\xC40"],"\x83"=>[16,"\xC40"],"\x84"=>[94,"\xC41"],"\x85"=>[76,"\xC41"],"\x86"=>[104,"\xC41"],"\x87"=>[16,"\xC41"],"\x88"=>[94,"\xC42"],"\x89"=>[76,"\xC42"],"\x8A"=>[104,"\xC42"],"\x8B"=>[16,"\xC42"],"\x8C"=>[94,"\xC4a"],"\x8D"=>[76,"\xC4a"],"\x8E"=>[104,"\xC4a"],"\x8F"=>[16,"\xC4a"],"\x90"=>[94,"\xC4c"],"\x91"=>[76,"\xC4c"],"\x92"=>[104,"\xC4c"],"\x93"=>[16,"\xC4c"],"\x94"=>[94,"\xC4e"],"\x95"=>[76,"\xC4e"],"\x96"=>[104,"\xC4e"],"\x97"=>[16,"\xC4e"],"\x98"=>[94,"\xC4i"],"\x99"=>[76,"\xC4i"],"\x9A"=>[104,"\xC4i"],"\x9B"=>[16,"\xC4i"],"\x9C"=>[94,"\xC4o"],"\x9D"=>[76,"\xC4o"],"\x9E"=>[104,"\xC4o"],"\x9F"=>[16,"\xC4o"],"\xA0"=>[94,"\xC4s"],"\xA1"=>[76,"\xC4s"],"\xA2"=>[104,"\xC4s"],"\xA3"=>[16,"\xC4s"],"\xA4"=>[94,"\xC4t"],"\xA5"=>[76,"\xC4t"],"\xA6"=>[104,"\xC4t"],"\xA7"=>[16,"\xC4t"],"\xA8"=>[77,"\xC4\x20"],"\xA9"=>[18,"\xC4\x20"],"\xAA"=>[77,"\xC4\x25"],"\xAB"=>[18,"\xC4\x25"],"\xAC"=>[77,"\xC4-"],"\xAD"=>[18,"\xC4-"],"\xAE"=>[77,"\xC4."],"\xAF"=>[18,"\xC4."],"\xB0"=>[77,"\xC4\x2F"],"\xB1"=>[18,"\xC4\x2F"],"\xB2"=>[77,"\xC43"],"\xB3"=>[18,"\xC43"],"\xB4"=>[77,"\xC44"],"\xB5"=>[18,"\xC44"],"\xB6"=>[77,"\xC45"],"\xB7"=>[18,"\xC45"],"\xB8"=>[77,"\xC46"],"\xB9"=>[18,"\xC46"],"\xBA"=>[77,"\xC47"],"\xBB"=>[18,"\xC47"],"\xBC"=>[77,"\xC48"],"\xBD"=>[18,"\xC48"],"\xBE"=>[77,"\xC49"],"\xBF"=>[18,"\xC49"],"\xC0"=>[77,"\xC4\x3D"],"\xC1"=>[18,"\xC4\x3D"],"\xC2"=>[77,"\xC4A"],"\xC3"=>[18,"\xC4A"],"\xC4"=>[77,"\xC4_"],"\xC5"=>[18,"\xC4_"],"\xC6"=>[77,"\xC4b"],"\xC7"=>[18,"\xC4b"],"\xC8"=>[77,"\xC4d"],"\xC9"=>[18,"\xC4d"],"\xCA"=>[77,"\xC4f"],"\xCB"=>[18,"\xC4f"],"\xCC"=>[77,"\xC4g"],"\xCD"=>[18,"\xC4g"],"\xCE"=>[77,"\xC4h"],"\xCF"=>[18,"\xC4h"],"\xD0"=>[77,"\xC4l"],"\xD1"=>[18,"\xC4l"],"\xD2"=>[77,"\xC4m"],"\xD3"=>[18,"\xC4m"],"\xD4"=>[77,"\xC4n"],"\xD5"=>[18,"\xC4n"],"\xD6"=>[77,"\xC4p"],"\xD7"=>[18,"\xC4p"],"\xD8"=>[77,"\xC4r"],"\xD9"=>[18,"\xC4r"],"\xDA"=>[77,"\xC4u"],"\xDB"=>[18,"\xC4u"],"\xDC"=>[0,"\xC4\x3A"],"\xDD"=>[0,"\xC4B"],"\xDE"=>[0,"\xC4C"],"\xDF"=>[0,"\xC4D"],"\xE0"=>[0,"\xC4E"],"\xE1"=>[0,"\xC4F"],"\xE2"=>[0,"\xC4G"],"\xE3"=>[0,"\xC4H"],"\xE4"=>[0,"\xC4I"],"\xE5"=>[0,"\xC4J"],"\xE6"=>[0,"\xC4K"],"\xE7"=>[0,"\xC4L"],"\xE8"=>[0,"\xC4M"],"\xE9"=>[0,"\xC4N"],"\xEA"=>[0,"\xC4O"],"\xEB"=>[0,"\xC4P"],"\xEC"=>[0,"\xC4Q"],"\xED"=>[0,"\xC4R"],"\xEE"=>[0,"\xC4S"],"\xEF"=>[0,"\xC4T"],"\xF0"=>[0,"\xC4U"],"\xF1"=>[0,"\xC4V"],"\xF2"=>[0,"\xC4W"],"\xF3"=>[0,"\xC4Y"],"\xF4"=>[0,"\xC4j"],"\xF5"=>[0,"\xC4k"],"\xF6"=>[0,"\xC4q"],"\xF7"=>[0,"\xC4v"],"\xF8"=>[0,"\xC4w"],"\xF9"=>[0,"\xC4x"],"\xFA"=>[0,"\xC4y"],"\xFB"=>[0,"\xC4z"],"\xFC"=>[82,"\xC4"],"\xFD"=>[87,"\xC4"],"\xFE"=>[130,"\xC4"],"\xFF"=>[9,"\xC4"],],["\x00"=>[77,"\xC00"],"\x01"=>[18,"\xC00"],"\x02"=>[77,"\xC01"],"\x03"=>[18,"\xC01"],"\x04"=>[77,"\xC02"],"\x05"=>[18,"\xC02"],"\x06"=>[77,"\xC0a"],"\x07"=>[18,"\xC0a"],"\x08"=>[77,"\xC0c"],"\x09"=>[18,"\xC0c"],"\x0A"=>[77,"\xC0e"],"\x0B"=>[18,"\xC0e"],"\x0C"=>[77,"\xC0i"],"\x0D"=>[18,"\xC0i"],"\x0E"=>[77,"\xC0o"],"\x0F"=>[18,"\xC0o"],"\x10"=>[77,"\xC0s"],"\x11"=>[18,"\xC0s"],"\x12"=>[77,"\xC0t"],"\x13"=>[18,"\xC0t"],"\x14"=>[0,"\xC0\x20"],"\x15"=>[0,"\xC0\x25"],"\x16"=>[0,"\xC0-"],"\x17"=>[0,"\xC0."],"\x18"=>[0,"\xC0\x2F"],"\x19"=>[0,"\xC03"],"\x1A"=>[0,"\xC04"],"\x1B"=>[0,"\xC05"],"\x1C"=>[0,"\xC06"],"\x1D"=>[0,"\xC07"],"\x1E"=>[0,"\xC08"],"\x1F"=>[0,"\xC09"],"\x20"=>[0,"\xC0\x3D"],"\x21"=>[0,"\xC0A"],"\x22"=>[0,"\xC0_"],"\x23"=>[0,"\xC0b"],"\x24"=>[0,"\xC0d"],"\x25"=>[0,"\xC0f"],"\x26"=>[0,"\xC0g"],"\x27"=>[0,"\xC0h"],"\x28"=>[0,"\xC0l"],"\x29"=>[0,"\xC0m"],"\x2A"=>[0,"\xC0n"],"\x2B"=>[0,"\xC0p"],"\x2C"=>[0,"\xC0r"],"-"=>[0,"\xC0u"],"."=>[100,"\xC0"],"\x2F"=>[110,"\xC0"],[111,"\xC0"],[115,"\xC0"],[116,"\xC0"],[118,"\xC0"],[119,"\xC0"],[122,"\xC0"],[123,"\xC0"],[125,"\xC0"],[126,"\xC0"],[129,"\xC0"],"\x3A"=>[143,"\xC0"],"\x3B"=>[148,"\xC0"],"\x3C"=>[151,"\xC0"],"\x3D"=>[153,"\xC0"],"\x3E"=>[83,"\xC0"],"\x3F"=>[10,"\xC0"],"\x40"=>[77,"\xC10"],"A"=>[18,"\xC10"],"B"=>[77,"\xC11"],"C"=>[18,"\xC11"],"D"=>[77,"\xC12"],"E"=>[18,"\xC12"],"F"=>[77,"\xC1a"],"G"=>[18,"\xC1a"],"H"=>[77,"\xC1c"],"I"=>[18,"\xC1c"],"J"=>[77,"\xC1e"],"K"=>[18,"\xC1e"],"L"=>[77,"\xC1i"],"M"=>[18,"\xC1i"],"N"=>[77,"\xC1o"],"O"=>[18,"\xC1o"],"P"=>[77,"\xC1s"],"Q"=>[18,"\xC1s"],"R"=>[77,"\xC1t"],"S"=>[18,"\xC1t"],"T"=>[0,"\xC1\x20"],"U"=>[0,"\xC1\x25"],"V"=>[0,"\xC1-"],"W"=>[0,"\xC1."],"X"=>[0,"\xC1\x2F"],"Y"=>[0,"\xC13"],"Z"=>[0,"\xC14"],"\x5B"=>[0,"\xC15"],"\x5C"=>[0,"\xC16"],"\x5D"=>[0,"\xC17"],"\x5E"=>[0,"\xC18"],"_"=>[0,"\xC19"],"\x60"=>[0,"\xC1\x3D"],"a"=>[0,"\xC1A"],"b"=>[0,"\xC1_"],"c"=>[0,"\xC1b"],"d"=>[0,"\xC1d"],"e"=>[0,"\xC1f"],"f"=>[0,"\xC1g"],"g"=>[0,"\xC1h"],"h"=>[0,"\xC1l"],"i"=>[0,"\xC1m"],"j"=>[0,"\xC1n"],"k"=>[0,"\xC1p"],"l"=>[0,"\xC1r"],"m"=>[0,"\xC1u"],"n"=>[100,"\xC1"],"o"=>[110,"\xC1"],"p"=>[111,"\xC1"],"q"=>[115,"\xC1"],"r"=>[116,"\xC1"],"s"=>[118,"\xC1"],"t"=>[119,"\xC1"],"u"=>[122,"\xC1"],"v"=>[123,"\xC1"],"w"=>[125,"\xC1"],"x"=>[126,"\xC1"],"y"=>[129,"\xC1"],"z"=>[143,"\xC1"],"\x7B"=>[148,"\xC1"],"\x7C"=>[151,"\xC1"],"\x7D"=>[153,"\xC1"],"~"=>[83,"\xC1"],"\x7F"=>[10,"\xC1"],"\x80"=>[77,"\xC80"],"\x81"=>[18,"\xC80"],"\x82"=>[77,"\xC81"],"\x83"=>[18,"\xC81"],"\x84"=>[77,"\xC82"],"\x85"=>[18,"\xC82"],"\x86"=>[77,"\xC8a"],"\x87"=>[18,"\xC8a"],"\x88"=>[77,"\xC8c"],"\x89"=>[18,"\xC8c"],"\x8A"=>[77,"\xC8e"],"\x8B"=>[18,"\xC8e"],"\x8C"=>[77,"\xC8i"],"\x8D"=>[18,"\xC8i"],"\x8E"=>[77,"\xC8o"],"\x8F"=>[18,"\xC8o"],"\x90"=>[77,"\xC8s"],"\x91"=>[18,"\xC8s"],"\x92"=>[77,"\xC8t"],"\x93"=>[18,"\xC8t"],"\x94"=>[0,"\xC8\x20"],"\x95"=>[0,"\xC8\x25"],"\x96"=>[0,"\xC8-"],"\x97"=>[0,"\xC8."],"\x98"=>[0,"\xC8\x2F"],"\x99"=>[0,"\xC83"],"\x9A"=>[0,"\xC84"],"\x9B"=>[0,"\xC85"],"\x9C"=>[0,"\xC86"],"\x9D"=>[0,"\xC87"],"\x9E"=>[0,"\xC88"],"\x9F"=>[0,"\xC89"],"\xA0"=>[0,"\xC8\x3D"],"\xA1"=>[0,"\xC8A"],"\xA2"=>[0,"\xC8_"],"\xA3"=>[0,"\xC8b"],"\xA4"=>[0,"\xC8d"],"\xA5"=>[0,"\xC8f"],"\xA6"=>[0,"\xC8g"],"\xA7"=>[0,"\xC8h"],"\xA8"=>[0,"\xC8l"],"\xA9"=>[0,"\xC8m"],"\xAA"=>[0,"\xC8n"],"\xAB"=>[0,"\xC8p"],"\xAC"=>[0,"\xC8r"],"\xAD"=>[0,"\xC8u"],"\xAE"=>[100,"\xC8"],"\xAF"=>[110,"\xC8"],"\xB0"=>[111,"\xC8"],"\xB1"=>[115,"\xC8"],"\xB2"=>[116,"\xC8"],"\xB3"=>[118,"\xC8"],"\xB4"=>[119,"\xC8"],"\xB5"=>[122,"\xC8"],"\xB6"=>[123,"\xC8"],"\xB7"=>[125,"\xC8"],"\xB8"=>[126,"\xC8"],"\xB9"=>[129,"\xC8"],"\xBA"=>[143,"\xC8"],"\xBB"=>[148,"\xC8"],"\xBC"=>[151,"\xC8"],"\xBD"=>[153,"\xC8"],"\xBE"=>[83,"\xC8"],"\xBF"=>[10,"\xC8"],"\xC0"=>[77,"\xC90"],"\xC1"=>[18,"\xC90"],"\xC2"=>[77,"\xC91"],"\xC3"=>[18,"\xC91"],"\xC4"=>[77,"\xC92"],"\xC5"=>[18,"\xC92"],"\xC6"=>[77,"\xC9a"],"\xC7"=>[18,"\xC9a"],"\xC8"=>[77,"\xC9c"],"\xC9"=>[18,"\xC9c"],"\xCA"=>[77,"\xC9e"],"\xCB"=>[18,"\xC9e"],"\xCC"=>[77,"\xC9i"],"\xCD"=>[18,"\xC9i"],"\xCE"=>[77,"\xC9o"],"\xCF"=>[18,"\xC9o"],"\xD0"=>[77,"\xC9s"],"\xD1"=>[18,"\xC9s"],"\xD2"=>[77,"\xC9t"],"\xD3"=>[18,"\xC9t"],"\xD4"=>[0,"\xC9\x20"],"\xD5"=>[0,"\xC9\x25"],"\xD6"=>[0,"\xC9-"],"\xD7"=>[0,"\xC9."],"\xD8"=>[0,"\xC9\x2F"],"\xD9"=>[0,"\xC93"],"\xDA"=>[0,"\xC94"],"\xDB"=>[0,"\xC95"],"\xDC"=>[0,"\xC96"],"\xDD"=>[0,"\xC97"],"\xDE"=>[0,"\xC98"],"\xDF"=>[0,"\xC99"],"\xE0"=>[0,"\xC9\x3D"],"\xE1"=>[0,"\xC9A"],"\xE2"=>[0,"\xC9_"],"\xE3"=>[0,"\xC9b"],"\xE4"=>[0,"\xC9d"],"\xE5"=>[0,"\xC9f"],"\xE6"=>[0,"\xC9g"],"\xE7"=>[0,"\xC9h"],"\xE8"=>[0,"\xC9l"],"\xE9"=>[0,"\xC9m"],"\xEA"=>[0,"\xC9n"],"\xEB"=>[0,"\xC9p"],"\xEC"=>[0,"\xC9r"],"\xED"=>[0,"\xC9u"],"\xEE"=>[100,"\xC9"],"\xEF"=>[110,"\xC9"],"\xF0"=>[111,"\xC9"],"\xF1"=>[115,"\xC9"],"\xF2"=>[116,"\xC9"],"\xF3"=>[118,"\xC9"],"\xF4"=>[119,"\xC9"],"\xF5"=>[122,"\xC9"],"\xF6"=>[123,"\xC9"],"\xF7"=>[125,"\xC9"],"\xF8"=>[126,"\xC9"],"\xF9"=>[129,"\xC9"],"\xFA"=>[143,"\xC9"],"\xFB"=>[148,"\xC9"],"\xFC"=>[151,"\xC9"],"\xFD"=>[153,"\xC9"],"\xFE"=>[83,"\xC9"],"\xFF"=>[10,"\xC9"],],["\x00"=>[0,"\xC00"],"\x01"=>[0,"\xC01"],"\x02"=>[0,"\xC02"],"\x03"=>[0,"\xC0a"],"\x04"=>[0,"\xC0c"],"\x05"=>[0,"\xC0e"],"\x06"=>[0,"\xC0i"],"\x07"=>[0,"\xC0o"],"\x08"=>[0,"\xC0s"],"\x09"=>[0,"\xC0t"],"\x0A"=>[73,"\xC0"],"\x0B"=>[88,"\xC0"],"\x0C"=>[89,"\xC0"],"\x0D"=>[96,"\xC0"],"\x0E"=>[97,"\xC0"],"\x0F"=>[99,"\xC0"],"\x10"=>[106,"\xC0"],"\x11"=>[136,"\xC0"],"\x12"=>[139,"\xC0"],"\x13"=>[141,"\xC0"],"\x14"=>[145,"\xC0"],"\x15"=>[147,"\xC0"],"\x16"=>[149,"\xC0"],"\x17"=>[101,"\xC0"],"\x18"=>[112,"\xC0"],"\x19"=>[117,"\xC0"],"\x1A"=>[120,"\xC0"],"\x1B"=>[124,"\xC0"],"\x1C"=>[127,"\xC0"],"\x1D"=>[144,"\xC0"],"\x1E"=>[152,"\xC0"],"\x1F"=>[11,"\xC0"],"\x20"=>[0,"\xC10"],"\x21"=>[0,"\xC11"],"\x22"=>[0,"\xC12"],"\x23"=>[0,"\xC1a"],"\x24"=>[0,"\xC1c"],"\x25"=>[0,"\xC1e"],"\x26"=>[0,"\xC1i"],"\x27"=>[0,"\xC1o"],"\x28"=>[0,"\xC1s"],"\x29"=>[0,"\xC1t"],"\x2A"=>[73,"\xC1"],"\x2B"=>[88,"\xC1"],"\x2C"=>[89,"\xC1"],"-"=>[96,"\xC1"],"."=>[97,"\xC1"],"\x2F"=>[99,"\xC1"],[106,"\xC1"],[136,"\xC1"],[139,"\xC1"],[141,"\xC1"],[145,"\xC1"],[147,"\xC1"],[149,"\xC1"],[101,"\xC1"],[112,"\xC1"],[117,"\xC1"],"\x3A"=>[120,"\xC1"],"\x3B"=>[124,"\xC1"],"\x3C"=>[127,"\xC1"],"\x3D"=>[144,"\xC1"],"\x3E"=>[152,"\xC1"],"\x3F"=>[11,"\xC1"],"\x40"=>[0,"\xC80"],"A"=>[0,"\xC81"],"B"=>[0,"\xC82"],"C"=>[0,"\xC8a"],"D"=>[0,"\xC8c"],"E"=>[0,"\xC8e"],"F"=>[0,"\xC8i"],"G"=>[0,"\xC8o"],"H"=>[0,"\xC8s"],"I"=>[0,"\xC8t"],"J"=>[73,"\xC8"],"K"=>[88,"\xC8"],"L"=>[89,"\xC8"],"M"=>[96,"\xC8"],"N"=>[97,"\xC8"],"O"=>[99,"\xC8"],"P"=>[106,"\xC8"],"Q"=>[136,"\xC8"],"R"=>[139,"\xC8"],"S"=>[141,"\xC8"],"T"=>[145,"\xC8"],"U"=>[147,"\xC8"],"V"=>[149,"\xC8"],"W"=>[101,"\xC8"],"X"=>[112,"\xC8"],"Y"=>[117,"\xC8"],"Z"=>[120,"\xC8"],"\x5B"=>[124,"\xC8"],"\x5C"=>[127,"\xC8"],"\x5D"=>[144,"\xC8"],"\x5E"=>[152,"\xC8"],"_"=>[11,"\xC8"],"\x60"=>[0,"\xC90"],"a"=>[0,"\xC91"],"b"=>[0,"\xC92"],"c"=>[0,"\xC9a"],"d"=>[0,"\xC9c"],"e"=>[0,"\xC9e"],"f"=>[0,"\xC9i"],"g"=>[0,"\xC9o"],"h"=>[0,"\xC9s"],"i"=>[0,"\xC9t"],"j"=>[73,"\xC9"],"k"=>[88,"\xC9"],"l"=>[89,"\xC9"],"m"=>[96,"\xC9"],"n"=>[97,"\xC9"],"o"=>[99,"\xC9"],"p"=>[106,"\xC9"],"q"=>[136,"\xC9"],"r"=>[139,"\xC9"],"s"=>[141,"\xC9"],"t"=>[145,"\xC9"],"u"=>[147,"\xC9"],"v"=>[149,"\xC9"],"w"=>[101,"\xC9"],"x"=>[112,"\xC9"],"y"=>[117,"\xC9"],"z"=>[120,"\xC9"],"\x7B"=>[124,"\xC9"],"\x7C"=>[127,"\xC9"],"\x7D"=>[144,"\xC9"],"~"=>[152,"\xC9"],"\x7F"=>[11,"\xC9"],"\x80"=>[0,"\xCA0"],"\x81"=>[0,"\xCA1"],"\x82"=>[0,"\xCA2"],"\x83"=>[0,"\xCAa"],"\x84"=>[0,"\xCAc"],"\x85"=>[0,"\xCAe"],"\x86"=>[0,"\xCAi"],"\x87"=>[0,"\xCAo"],"\x88"=>[0,"\xCAs"],"\x89"=>[0,"\xCAt"],"\x8A"=>[73,"\xCA"],"\x8B"=>[88,"\xCA"],"\x8C"=>[89,"\xCA"],"\x8D"=>[96,"\xCA"],"\x8E"=>[97,"\xCA"],"\x8F"=>[99,"\xCA"],"\x90"=>[106,"\xCA"],"\x91"=>[136,"\xCA"],"\x92"=>[139,"\xCA"],"\x93"=>[141,"\xCA"],"\x94"=>[145,"\xCA"],"\x95"=>[147,"\xCA"],"\x96"=>[149,"\xCA"],"\x97"=>[101,"\xCA"],"\x98"=>[112,"\xCA"],"\x99"=>[117,"\xCA"],"\x9A"=>[120,"\xCA"],"\x9B"=>[124,"\xCA"],"\x9C"=>[127,"\xCA"],"\x9D"=>[144,"\xCA"],"\x9E"=>[152,"\xCA"],"\x9F"=>[11,"\xCA"],"\xA0"=>[0,"\xCD0"],"\xA1"=>[0,"\xCD1"],"\xA2"=>[0,"\xCD2"],"\xA3"=>[0,"\xCDa"],"\xA4"=>[0,"\xCDc"],"\xA5"=>[0,"\xCDe"],"\xA6"=>[0,"\xCDi"],"\xA7"=>[0,"\xCDo"],"\xA8"=>[0,"\xCDs"],"\xA9"=>[0,"\xCDt"],"\xAA"=>[73,"\xCD"],"\xAB"=>[88,"\xCD"],"\xAC"=>[89,"\xCD"],"\xAD"=>[96,"\xCD"],"\xAE"=>[97,"\xCD"],"\xAF"=>[99,"\xCD"],"\xB0"=>[106,"\xCD"],"\xB1"=>[136,"\xCD"],"\xB2"=>[139,"\xCD"],"\xB3"=>[141,"\xCD"],"\xB4"=>[145,"\xCD"],"\xB5"=>[147,"\xCD"],"\xB6"=>[149,"\xCD"],"\xB7"=>[101,"\xCD"],"\xB8"=>[112,"\xCD"],"\xB9"=>[117,"\xCD"],"\xBA"=>[120,"\xCD"],"\xBB"=>[124,"\xCD"],"\xBC"=>[127,"\xCD"],"\xBD"=>[144,"\xCD"],"\xBE"=>[152,"\xCD"],"\xBF"=>[11,"\xCD"],"\xC0"=>[0,"\xD20"],"\xC1"=>[0,"\xD21"],"\xC2"=>[0,"\xD22"],"\xC3"=>[0,"\xD2a"],"\xC4"=>[0,"\xD2c"],"\xC5"=>[0,"\xD2e"],"\xC6"=>[0,"\xD2i"],"\xC7"=>[0,"\xD2o"],"\xC8"=>[0,"\xD2s"],"\xC9"=>[0,"\xD2t"],"\xCA"=>[73,"\xD2"],"\xCB"=>[88,"\xD2"],"\xCC"=>[89,"\xD2"],"\xCD"=>[96,"\xD2"],"\xCE"=>[97,"\xD2"],"\xCF"=>[99,"\xD2"],"\xD0"=>[106,"\xD2"],"\xD1"=>[136,"\xD2"],"\xD2"=>[139,"\xD2"],"\xD3"=>[141,"\xD2"],"\xD4"=>[145,"\xD2"],"\xD5"=>[147,"\xD2"],"\xD6"=>[149,"\xD2"],"\xD7"=>[101,"\xD2"],"\xD8"=>[112,"\xD2"],"\xD9"=>[117,"\xD2"],"\xDA"=>[120,"\xD2"],"\xDB"=>[124,"\xD2"],"\xDC"=>[127,"\xD2"],"\xDD"=>[144,"\xD2"],"\xDE"=>[152,"\xD2"],"\xDF"=>[11,"\xD2"],"\xE0"=>[0,"\xD50"],"\xE1"=>[0,"\xD51"],"\xE2"=>[0,"\xD52"],"\xE3"=>[0,"\xD5a"],"\xE4"=>[0,"\xD5c"],"\xE5"=>[0,"\xD5e"],"\xE6"=>[0,"\xD5i"],"\xE7"=>[0,"\xD5o"],"\xE8"=>[0,"\xD5s"],"\xE9"=>[0,"\xD5t"],"\xEA"=>[73,"\xD5"],"\xEB"=>[88,"\xD5"],"\xEC"=>[89,"\xD5"],"\xED"=>[96,"\xD5"],"\xEE"=>[97,"\xD5"],"\xEF"=>[99,"\xD5"],"\xF0"=>[106,"\xD5"],"\xF1"=>[136,"\xD5"],"\xF2"=>[139,"\xD5"],"\xF3"=>[141,"\xD5"],"\xF4"=>[145,"\xD5"],"\xF5"=>[147,"\xD5"],"\xF6"=>[149,"\xD5"],"\xF7"=>[101,"\xD5"],"\xF8"=>[112,"\xD5"],"\xF9"=>[117,"\xD5"],"\xFA"=>[120,"\xD5"],"\xFB"=>[124,"\xD5"],"\xFC"=>[127,"\xD5"],"\xFD"=>[144,"\xD5"],"\xFE"=>[152,"\xD5"],"\xFF"=>[11,"\xD5"],],["\x00"=>[92,"\xC0"],"\x01"=>[95,"\xC0"],"\x02"=>[137,"\xC0"],"\x03"=>[142,"\xC0"],"\x04"=>[150,"\xC0"],"\x05"=>[74,"\xC0"],"\x06"=>[90,"\xC0"],"\x07"=>[98,"\xC0"],"\x08"=>[107,"\xC0"],"\x09"=>[140,"\xC0"],"\x0A"=>[146,"\xC0"],"\x0B"=>[102,"\xC0"],"\x0C"=>[113,"\xC0"],"\x0D"=>[121,"\xC0"],"\x0E"=>[128,"\xC0"],"\x0F"=>[12,"\xC0"],"\x10"=>[92,"\xC1"],"\x11"=>[95,"\xC1"],"\x12"=>[137,"\xC1"],"\x13"=>[142,"\xC1"],"\x14"=>[150,"\xC1"],"\x15"=>[74,"\xC1"],"\x16"=>[90,"\xC1"],"\x17"=>[98,"\xC1"],"\x18"=>[107,"\xC1"],"\x19"=>[140,"\xC1"],"\x1A"=>[146,"\xC1"],"\x1B"=>[102,"\xC1"],"\x1C"=>[113,"\xC1"],"\x1D"=>[121,"\xC1"],"\x1E"=>[128,"\xC1"],"\x1F"=>[12,"\xC1"],"\x20"=>[92,"\xC8"],"\x21"=>[95,"\xC8"],"\x22"=>[137,"\xC8"],"\x23"=>[142,"\xC8"],"\x24"=>[150,"\xC8"],"\x25"=>[74,"\xC8"],"\x26"=>[90,"\xC8"],"\x27"=>[98,"\xC8"],"\x28"=>[107,"\xC8"],"\x29"=>[140,"\xC8"],"\x2A"=>[146,"\xC8"],"\x2B"=>[102,"\xC8"],"\x2C"=>[113,"\xC8"],"-"=>[121,"\xC8"],"."=>[128,"\xC8"],"\x2F"=>[12,"\xC8"],[92,"\xC9"],[95,"\xC9"],[137,"\xC9"],[142,"\xC9"],[150,"\xC9"],[74,"\xC9"],[90,"\xC9"],[98,"\xC9"],[107,"\xC9"],[140,"\xC9"],"\x3A"=>[146,"\xC9"],"\x3B"=>[102,"\xC9"],"\x3C"=>[113,"\xC9"],"\x3D"=>[121,"\xC9"],"\x3E"=>[128,"\xC9"],"\x3F"=>[12,"\xC9"],"\x40"=>[92,"\xCA"],"A"=>[95,"\xCA"],"B"=>[137,"\xCA"],"C"=>[142,"\xCA"],"D"=>[150,"\xCA"],"E"=>[74,"\xCA"],"F"=>[90,"\xCA"],"G"=>[98,"\xCA"],"H"=>[107,"\xCA"],"I"=>[140,"\xCA"],"J"=>[146,"\xCA"],"K"=>[102,"\xCA"],"L"=>[113,"\xCA"],"M"=>[121,"\xCA"],"N"=>[128,"\xCA"],"O"=>[12,"\xCA"],"P"=>[92,"\xCD"],"Q"=>[95,"\xCD"],"R"=>[137,"\xCD"],"S"=>[142,"\xCD"],"T"=>[150,"\xCD"],"U"=>[74,"\xCD"],"V"=>[90,"\xCD"],"W"=>[98,"\xCD"],"X"=>[107,"\xCD"],"Y"=>[140,"\xCD"],"Z"=>[146,"\xCD"],"\x5B"=>[102,"\xCD"],"\x5C"=>[113,"\xCD"],"\x5D"=>[121,"\xCD"],"\x5E"=>[128,"\xCD"],"_"=>[12,"\xCD"],"\x60"=>[92,"\xD2"],"a"=>[95,"\xD2"],"b"=>[137,"\xD2"],"c"=>[142,"\xD2"],"d"=>[150,"\xD2"],"e"=>[74,"\xD2"],"f"=>[90,"\xD2"],"g"=>[98,"\xD2"],"h"=>[107,"\xD2"],"i"=>[140,"\xD2"],"j"=>[146,"\xD2"],"k"=>[102,"\xD2"],"l"=>[113,"\xD2"],"m"=>[121,"\xD2"],"n"=>[128,"\xD2"],"o"=>[12,"\xD2"],"p"=>[92,"\xD5"],"q"=>[95,"\xD5"],"r"=>[137,"\xD5"],"s"=>[142,"\xD5"],"t"=>[150,"\xD5"],"u"=>[74,"\xD5"],"v"=>[90,"\xD5"],"w"=>[98,"\xD5"],"x"=>[107,"\xD5"],"y"=>[140,"\xD5"],"z"=>[146,"\xD5"],"\x7B"=>[102,"\xD5"],"\x7C"=>[113,"\xD5"],"\x7D"=>[121,"\xD5"],"~"=>[128,"\xD5"],"\x7F"=>[12,"\xD5"],"\x80"=>[92,"\xDA"],"\x81"=>[95,"\xDA"],"\x82"=>[137,"\xDA"],"\x83"=>[142,"\xDA"],"\x84"=>[150,"\xDA"],"\x85"=>[74,"\xDA"],"\x86"=>[90,"\xDA"],"\x87"=>[98,"\xDA"],"\x88"=>[107,"\xDA"],"\x89"=>[140,"\xDA"],"\x8A"=>[146,"\xDA"],"\x8B"=>[102,"\xDA"],"\x8C"=>[113,"\xDA"],"\x8D"=>[121,"\xDA"],"\x8E"=>[128,"\xDA"],"\x8F"=>[12,"\xDA"],"\x90"=>[92,"\xDB"],"\x91"=>[95,"\xDB"],"\x92"=>[137,"\xDB"],"\x93"=>[142,"\xDB"],"\x94"=>[150,"\xDB"],"\x95"=>[74,"\xDB"],"\x96"=>[90,"\xDB"],"\x97"=>[98,"\xDB"],"\x98"=>[107,"\xDB"],"\x99"=>[140,"\xDB"],"\x9A"=>[146,"\xDB"],"\x9B"=>[102,"\xDB"],"\x9C"=>[113,"\xDB"],"\x9D"=>[121,"\xDB"],"\x9E"=>[128,"\xDB"],"\x9F"=>[12,"\xDB"],"\xA0"=>[92,"\xEE"],"\xA1"=>[95,"\xEE"],"\xA2"=>[137,"\xEE"],"\xA3"=>[142,"\xEE"],"\xA4"=>[150,"\xEE"],"\xA5"=>[74,"\xEE"],"\xA6"=>[90,"\xEE"],"\xA7"=>[98,"\xEE"],"\xA8"=>[107,"\xEE"],"\xA9"=>[140,"\xEE"],"\xAA"=>[146,"\xEE"],"\xAB"=>[102,"\xEE"],"\xAC"=>[113,"\xEE"],"\xAD"=>[121,"\xEE"],"\xAE"=>[128,"\xEE"],"\xAF"=>[12,"\xEE"],"\xB0"=>[92,"\xF0"],"\xB1"=>[95,"\xF0"],"\xB2"=>[137,"\xF0"],"\xB3"=>[142,"\xF0"],"\xB4"=>[150,"\xF0"],"\xB5"=>[74,"\xF0"],"\xB6"=>[90,"\xF0"],"\xB7"=>[98,"\xF0"],"\xB8"=>[107,"\xF0"],"\xB9"=>[140,"\xF0"],"\xBA"=>[146,"\xF0"],"\xBB"=>[102,"\xF0"],"\xBC"=>[113,"\xF0"],"\xBD"=>[121,"\xF0"],"\xBE"=>[128,"\xF0"],"\xBF"=>[12,"\xF0"],"\xC0"=>[92,"\xF2"],"\xC1"=>[95,"\xF2"],"\xC2"=>[137,"\xF2"],"\xC3"=>[142,"\xF2"],"\xC4"=>[150,"\xF2"],"\xC5"=>[74,"\xF2"],"\xC6"=>[90,"\xF2"],"\xC7"=>[98,"\xF2"],"\xC8"=>[107,"\xF2"],"\xC9"=>[140,"\xF2"],"\xCA"=>[146,"\xF2"],"\xCB"=>[102,"\xF2"],"\xCC"=>[113,"\xF2"],"\xCD"=>[121,"\xF2"],"\xCE"=>[128,"\xF2"],"\xCF"=>[12,"\xF2"],"\xD0"=>[92,"\xF3"],"\xD1"=>[95,"\xF3"],"\xD2"=>[137,"\xF3"],"\xD3"=>[142,"\xF3"],"\xD4"=>[150,"\xF3"],"\xD5"=>[74,"\xF3"],"\xD6"=>[90,"\xF3"],"\xD7"=>[98,"\xF3"],"\xD8"=>[107,"\xF3"],"\xD9"=>[140,"\xF3"],"\xDA"=>[146,"\xF3"],"\xDB"=>[102,"\xF3"],"\xDC"=>[113,"\xF3"],"\xDD"=>[121,"\xF3"],"\xDE"=>[128,"\xF3"],"\xDF"=>[12,"\xF3"],"\xE0"=>[92,"\xFF"],"\xE1"=>[95,"\xFF"],"\xE2"=>[137,"\xFF"],"\xE3"=>[142,"\xFF"],"\xE4"=>[150,"\xFF"],"\xE5"=>[74,"\xFF"],"\xE6"=>[90,"\xFF"],"\xE7"=>[98,"\xFF"],"\xE8"=>[107,"\xFF"],"\xE9"=>[140,"\xFF"],"\xEA"=>[146,"\xFF"],"\xEB"=>[102,"\xFF"],"\xEC"=>[113,"\xFF"],"\xED"=>[121,"\xFF"],"\xEE"=>[128,"\xFF"],"\xEF"=>[12,"\xFF"],"\xF0"=>[93,"\xCB"],"\xF1"=>[138,"\xCB"],"\xF2"=>[75,"\xCB"],"\xF3"=>[91,"\xCB"],"\xF4"=>[108,"\xCB"],"\xF5"=>[103,"\xCB"],"\xF6"=>[114,"\xCB"],"\xF7"=>[14,"\xCB"],"\xF8"=>[93,"\xCC"],"\xF9"=>[138,"\xCC"],"\xFA"=>[75,"\xCC"],"\xFB"=>[91,"\xCC"],"\xFC"=>[108,"\xCC"],"\xFD"=>[103,"\xCC"],"\xFE"=>[114,"\xCC"],"\xFF"=>[14,"\xCC"],],["\x00"=>[94,"\xC00"],"\x01"=>[76,"\xC00"],"\x02"=>[104,"\xC00"],"\x03"=>[16,"\xC00"],"\x04"=>[94,"\xC01"],"\x05"=>[76,"\xC01"],"\x06"=>[104,"\xC01"],"\x07"=>[16,"\xC01"],"\x08"=>[94,"\xC02"],"\x09"=>[76,"\xC02"],"\x0A"=>[104,"\xC02"],"\x0B"=>[16,"\xC02"],"\x0C"=>[94,"\xC0a"],"\x0D"=>[76,"\xC0a"],"\x0E"=>[104,"\xC0a"],"\x0F"=>[16,"\xC0a"],"\x10"=>[94,"\xC0c"],"\x11"=>[76,"\xC0c"],"\x12"=>[104,"\xC0c"],"\x13"=>[16,"\xC0c"],"\x14"=>[94,"\xC0e"],"\x15"=>[76,"\xC0e"],"\x16"=>[104,"\xC0e"],"\x17"=>[16,"\xC0e"],"\x18"=>[94,"\xC0i"],"\x19"=>[76,"\xC0i"],"\x1A"=>[104,"\xC0i"],"\x1B"=>[16,"\xC0i"],"\x1C"=>[94,"\xC0o"],"\x1D"=>[76,"\xC0o"],"\x1E"=>[104,"\xC0o"],"\x1F"=>[16,"\xC0o"],"\x20"=>[94,"\xC0s"],"\x21"=>[76,"\xC0s"],"\x22"=>[104,"\xC0s"],"\x23"=>[16,"\xC0s"],"\x24"=>[94,"\xC0t"],"\x25"=>[76,"\xC0t"],"\x26"=>[104,"\xC0t"],"\x27"=>[16,"\xC0t"],"\x28"=>[77,"\xC0\x20"],"\x29"=>[18,"\xC0\x20"],"\x2A"=>[77,"\xC0\x25"],"\x2B"=>[18,"\xC0\x25"],"\x2C"=>[77,"\xC0-"],"-"=>[18,"\xC0-"],"."=>[77,"\xC0."],"\x2F"=>[18,"\xC0."],[77,"\xC0\x2F"],[18,"\xC0\x2F"],[77,"\xC03"],[18,"\xC03"],[77,"\xC04"],[18,"\xC04"],[77,"\xC05"],[18,"\xC05"],[77,"\xC06"],[18,"\xC06"],"\x3A"=>[77,"\xC07"],"\x3B"=>[18,"\xC07"],"\x3C"=>[77,"\xC08"],"\x3D"=>[18,"\xC08"],"\x3E"=>[77,"\xC09"],"\x3F"=>[18,"\xC09"],"\x40"=>[77,"\xC0\x3D"],"A"=>[18,"\xC0\x3D"],"B"=>[77,"\xC0A"],"C"=>[18,"\xC0A"],"D"=>[77,"\xC0_"],"E"=>[18,"\xC0_"],"F"=>[77,"\xC0b"],"G"=>[18,"\xC0b"],"H"=>[77,"\xC0d"],"I"=>[18,"\xC0d"],"J"=>[77,"\xC0f"],"K"=>[18,"\xC0f"],"L"=>[77,"\xC0g"],"M"=>[18,"\xC0g"],"N"=>[77,"\xC0h"],"O"=>[18,"\xC0h"],"P"=>[77,"\xC0l"],"Q"=>[18,"\xC0l"],"R"=>[77,"\xC0m"],"S"=>[18,"\xC0m"],"T"=>[77,"\xC0n"],"U"=>[18,"\xC0n"],"V"=>[77,"\xC0p"],"W"=>[18,"\xC0p"],"X"=>[77,"\xC0r"],"Y"=>[18,"\xC0r"],"Z"=>[77,"\xC0u"],"\x5B"=>[18,"\xC0u"],"\x5C"=>[0,"\xC0\x3A"],"\x5D"=>[0,"\xC0B"],"\x5E"=>[0,"\xC0C"],"_"=>[0,"\xC0D"],"\x60"=>[0,"\xC0E"],"a"=>[0,"\xC0F"],"b"=>[0,"\xC0G"],"c"=>[0,"\xC0H"],"d"=>[0,"\xC0I"],"e"=>[0,"\xC0J"],"f"=>[0,"\xC0K"],"g"=>[0,"\xC0L"],"h"=>[0,"\xC0M"],"i"=>[0,"\xC0N"],"j"=>[0,"\xC0O"],"k"=>[0,"\xC0P"],"l"=>[0,"\xC0Q"],"m"=>[0,"\xC0R"],"n"=>[0,"\xC0S"],"o"=>[0,"\xC0T"],"p"=>[0,"\xC0U"],"q"=>[0,"\xC0V"],"r"=>[0,"\xC0W"],"s"=>[0,"\xC0Y"],"t"=>[0,"\xC0j"],"u"=>[0,"\xC0k"],"v"=>[0,"\xC0q"],"w"=>[0,"\xC0v"],"x"=>[0,"\xC0w"],"y"=>[0,"\xC0x"],"z"=>[0,"\xC0y"],"\x7B"=>[0,"\xC0z"],"\x7C"=>[82,"\xC0"],"\x7D"=>[87,"\xC0"],"~"=>[130,"\xC0"],"\x7F"=>[9,"\xC0"],"\x80"=>[94,"\xC10"],"\x81"=>[76,"\xC10"],"\x82"=>[104,"\xC10"],"\x83"=>[16,"\xC10"],"\x84"=>[94,"\xC11"],"\x85"=>[76,"\xC11"],"\x86"=>[104,"\xC11"],"\x87"=>[16,"\xC11"],"\x88"=>[94,"\xC12"],"\x89"=>[76,"\xC12"],"\x8A"=>[104,"\xC12"],"\x8B"=>[16,"\xC12"],"\x8C"=>[94,"\xC1a"],"\x8D"=>[76,"\xC1a"],"\x8E"=>[104,"\xC1a"],"\x8F"=>[16,"\xC1a"],"\x90"=>[94,"\xC1c"],"\x91"=>[76,"\xC1c"],"\x92"=>[104,"\xC1c"],"\x93"=>[16,"\xC1c"],"\x94"=>[94,"\xC1e"],"\x95"=>[76,"\xC1e"],"\x96"=>[104,"\xC1e"],"\x97"=>[16,"\xC1e"],"\x98"=>[94,"\xC1i"],"\x99"=>[76,"\xC1i"],"\x9A"=>[104,"\xC1i"],"\x9B"=>[16,"\xC1i"],"\x9C"=>[94,"\xC1o"],"\x9D"=>[76,"\xC1o"],"\x9E"=>[104,"\xC1o"],"\x9F"=>[16,"\xC1o"],"\xA0"=>[94,"\xC1s"],"\xA1"=>[76,"\xC1s"],"\xA2"=>[104,"\xC1s"],"\xA3"=>[16,"\xC1s"],"\xA4"=>[94,"\xC1t"],"\xA5"=>[76,"\xC1t"],"\xA6"=>[104,"\xC1t"],"\xA7"=>[16,"\xC1t"],"\xA8"=>[77,"\xC1\x20"],"\xA9"=>[18,"\xC1\x20"],"\xAA"=>[77,"\xC1\x25"],"\xAB"=>[18,"\xC1\x25"],"\xAC"=>[77,"\xC1-"],"\xAD"=>[18,"\xC1-"],"\xAE"=>[77,"\xC1."],"\xAF"=>[18,"\xC1."],"\xB0"=>[77,"\xC1\x2F"],"\xB1"=>[18,"\xC1\x2F"],"\xB2"=>[77,"\xC13"],"\xB3"=>[18,"\xC13"],"\xB4"=>[77,"\xC14"],"\xB5"=>[18,"\xC14"],"\xB6"=>[77,"\xC15"],"\xB7"=>[18,"\xC15"],"\xB8"=>[77,"\xC16"],"\xB9"=>[18,"\xC16"],"\xBA"=>[77,"\xC17"],"\xBB"=>[18,"\xC17"],"\xBC"=>[77,"\xC18"],"\xBD"=>[18,"\xC18"],"\xBE"=>[77,"\xC19"],"\xBF"=>[18,"\xC19"],"\xC0"=>[77,"\xC1\x3D"],"\xC1"=>[18,"\xC1\x3D"],"\xC2"=>[77,"\xC1A"],"\xC3"=>[18,"\xC1A"],"\xC4"=>[77,"\xC1_"],"\xC5"=>[18,"\xC1_"],"\xC6"=>[77,"\xC1b"],"\xC7"=>[18,"\xC1b"],"\xC8"=>[77,"\xC1d"],"\xC9"=>[18,"\xC1d"],"\xCA"=>[77,"\xC1f"],"\xCB"=>[18,"\xC1f"],"\xCC"=>[77,"\xC1g"],"\xCD"=>[18,"\xC1g"],"\xCE"=>[77,"\xC1h"],"\xCF"=>[18,"\xC1h"],"\xD0"=>[77,"\xC1l"],"\xD1"=>[18,"\xC1l"],"\xD2"=>[77,"\xC1m"],"\xD3"=>[18,"\xC1m"],"\xD4"=>[77,"\xC1n"],"\xD5"=>[18,"\xC1n"],"\xD6"=>[77,"\xC1p"],"\xD7"=>[18,"\xC1p"],"\xD8"=>[77,"\xC1r"],"\xD9"=>[18,"\xC1r"],"\xDA"=>[77,"\xC1u"],"\xDB"=>[18,"\xC1u"],"\xDC"=>[0,"\xC1\x3A"],"\xDD"=>[0,"\xC1B"],"\xDE"=>[0,"\xC1C"],"\xDF"=>[0,"\xC1D"],"\xE0"=>[0,"\xC1E"],"\xE1"=>[0,"\xC1F"],"\xE2"=>[0,"\xC1G"],"\xE3"=>[0,"\xC1H"],"\xE4"=>[0,"\xC1I"],"\xE5"=>[0,"\xC1J"],"\xE6"=>[0,"\xC1K"],"\xE7"=>[0,"\xC1L"],"\xE8"=>[0,"\xC1M"],"\xE9"=>[0,"\xC1N"],"\xEA"=>[0,"\xC1O"],"\xEB"=>[0,"\xC1P"],"\xEC"=>[0,"\xC1Q"],"\xED"=>[0,"\xC1R"],"\xEE"=>[0,"\xC1S"],"\xEF"=>[0,"\xC1T"],"\xF0"=>[0,"\xC1U"],"\xF1"=>[0,"\xC1V"],"\xF2"=>[0,"\xC1W"],"\xF3"=>[0,"\xC1Y"],"\xF4"=>[0,"\xC1j"],"\xF5"=>[0,"\xC1k"],"\xF6"=>[0,"\xC1q"],"\xF7"=>[0,"\xC1v"],"\xF8"=>[0,"\xC1w"],"\xF9"=>[0,"\xC1x"],"\xFA"=>[0,"\xC1y"],"\xFB"=>[0,"\xC1z"],"\xFC"=>[82,"\xC1"],"\xFD"=>[87,"\xC1"],"\xFE"=>[130,"\xC1"],"\xFF"=>[9,"\xC1"],],["\x00"=>[94,"\xC50"],"\x01"=>[76,"\xC50"],"\x02"=>[104,"\xC50"],"\x03"=>[16,"\xC50"],"\x04"=>[94,"\xC51"],"\x05"=>[76,"\xC51"],"\x06"=>[104,"\xC51"],"\x07"=>[16,"\xC51"],"\x08"=>[94,"\xC52"],"\x09"=>[76,"\xC52"],"\x0A"=>[104,"\xC52"],"\x0B"=>[16,"\xC52"],"\x0C"=>[94,"\xC5a"],"\x0D"=>[76,"\xC5a"],"\x0E"=>[104,"\xC5a"],"\x0F"=>[16,"\xC5a"],"\x10"=>[94,"\xC5c"],"\x11"=>[76,"\xC5c"],"\x12"=>[104,"\xC5c"],"\x13"=>[16,"\xC5c"],"\x14"=>[94,"\xC5e"],"\x15"=>[76,"\xC5e"],"\x16"=>[104,"\xC5e"],"\x17"=>[16,"\xC5e"],"\x18"=>[94,"\xC5i"],"\x19"=>[76,"\xC5i"],"\x1A"=>[104,"\xC5i"],"\x1B"=>[16,"\xC5i"],"\x1C"=>[94,"\xC5o"],"\x1D"=>[76,"\xC5o"],"\x1E"=>[104,"\xC5o"],"\x1F"=>[16,"\xC5o"],"\x20"=>[94,"\xC5s"],"\x21"=>[76,"\xC5s"],"\x22"=>[104,"\xC5s"],"\x23"=>[16,"\xC5s"],"\x24"=>[94,"\xC5t"],"\x25"=>[76,"\xC5t"],"\x26"=>[104,"\xC5t"],"\x27"=>[16,"\xC5t"],"\x28"=>[77,"\xC5\x20"],"\x29"=>[18,"\xC5\x20"],"\x2A"=>[77,"\xC5\x25"],"\x2B"=>[18,"\xC5\x25"],"\x2C"=>[77,"\xC5-"],"-"=>[18,"\xC5-"],"."=>[77,"\xC5."],"\x2F"=>[18,"\xC5."],[77,"\xC5\x2F"],[18,"\xC5\x2F"],[77,"\xC53"],[18,"\xC53"],[77,"\xC54"],[18,"\xC54"],[77,"\xC55"],[18,"\xC55"],[77,"\xC56"],[18,"\xC56"],"\x3A"=>[77,"\xC57"],"\x3B"=>[18,"\xC57"],"\x3C"=>[77,"\xC58"],"\x3D"=>[18,"\xC58"],"\x3E"=>[77,"\xC59"],"\x3F"=>[18,"\xC59"],"\x40"=>[77,"\xC5\x3D"],"A"=>[18,"\xC5\x3D"],"B"=>[77,"\xC5A"],"C"=>[18,"\xC5A"],"D"=>[77,"\xC5_"],"E"=>[18,"\xC5_"],"F"=>[77,"\xC5b"],"G"=>[18,"\xC5b"],"H"=>[77,"\xC5d"],"I"=>[18,"\xC5d"],"J"=>[77,"\xC5f"],"K"=>[18,"\xC5f"],"L"=>[77,"\xC5g"],"M"=>[18,"\xC5g"],"N"=>[77,"\xC5h"],"O"=>[18,"\xC5h"],"P"=>[77,"\xC5l"],"Q"=>[18,"\xC5l"],"R"=>[77,"\xC5m"],"S"=>[18,"\xC5m"],"T"=>[77,"\xC5n"],"U"=>[18,"\xC5n"],"V"=>[77,"\xC5p"],"W"=>[18,"\xC5p"],"X"=>[77,"\xC5r"],"Y"=>[18,"\xC5r"],"Z"=>[77,"\xC5u"],"\x5B"=>[18,"\xC5u"],"\x5C"=>[0,"\xC5\x3A"],"\x5D"=>[0,"\xC5B"],"\x5E"=>[0,"\xC5C"],"_"=>[0,"\xC5D"],"\x60"=>[0,"\xC5E"],"a"=>[0,"\xC5F"],"b"=>[0,"\xC5G"],"c"=>[0,"\xC5H"],"d"=>[0,"\xC5I"],"e"=>[0,"\xC5J"],"f"=>[0,"\xC5K"],"g"=>[0,"\xC5L"],"h"=>[0,"\xC5M"],"i"=>[0,"\xC5N"],"j"=>[0,"\xC5O"],"k"=>[0,"\xC5P"],"l"=>[0,"\xC5Q"],"m"=>[0,"\xC5R"],"n"=>[0,"\xC5S"],"o"=>[0,"\xC5T"],"p"=>[0,"\xC5U"],"q"=>[0,"\xC5V"],"r"=>[0,"\xC5W"],"s"=>[0,"\xC5Y"],"t"=>[0,"\xC5j"],"u"=>[0,"\xC5k"],"v"=>[0,"\xC5q"],"w"=>[0,"\xC5v"],"x"=>[0,"\xC5w"],"y"=>[0,"\xC5x"],"z"=>[0,"\xC5y"],"\x7B"=>[0,"\xC5z"],"\x7C"=>[82,"\xC5"],"\x7D"=>[87,"\xC5"],"~"=>[130,"\xC5"],"\x7F"=>[9,"\xC5"],"\x80"=>[94,"\xE70"],"\x81"=>[76,"\xE70"],"\x82"=>[104,"\xE70"],"\x83"=>[16,"\xE70"],"\x84"=>[94,"\xE71"],"\x85"=>[76,"\xE71"],"\x86"=>[104,"\xE71"],"\x87"=>[16,"\xE71"],"\x88"=>[94,"\xE72"],"\x89"=>[76,"\xE72"],"\x8A"=>[104,"\xE72"],"\x8B"=>[16,"\xE72"],"\x8C"=>[94,"\xE7a"],"\x8D"=>[76,"\xE7a"],"\x8E"=>[104,"\xE7a"],"\x8F"=>[16,"\xE7a"],"\x90"=>[94,"\xE7c"],"\x91"=>[76,"\xE7c"],"\x92"=>[104,"\xE7c"],"\x93"=>[16,"\xE7c"],"\x94"=>[94,"\xE7e"],"\x95"=>[76,"\xE7e"],"\x96"=>[104,"\xE7e"],"\x97"=>[16,"\xE7e"],"\x98"=>[94,"\xE7i"],"\x99"=>[76,"\xE7i"],"\x9A"=>[104,"\xE7i"],"\x9B"=>[16,"\xE7i"],"\x9C"=>[94,"\xE7o"],"\x9D"=>[76,"\xE7o"],"\x9E"=>[104,"\xE7o"],"\x9F"=>[16,"\xE7o"],"\xA0"=>[94,"\xE7s"],"\xA1"=>[76,"\xE7s"],"\xA2"=>[104,"\xE7s"],"\xA3"=>[16,"\xE7s"],"\xA4"=>[94,"\xE7t"],"\xA5"=>[76,"\xE7t"],"\xA6"=>[104,"\xE7t"],"\xA7"=>[16,"\xE7t"],"\xA8"=>[77,"\xE7\x20"],"\xA9"=>[18,"\xE7\x20"],"\xAA"=>[77,"\xE7\x25"],"\xAB"=>[18,"\xE7\x25"],"\xAC"=>[77,"\xE7-"],"\xAD"=>[18,"\xE7-"],"\xAE"=>[77,"\xE7."],"\xAF"=>[18,"\xE7."],"\xB0"=>[77,"\xE7\x2F"],"\xB1"=>[18,"\xE7\x2F"],"\xB2"=>[77,"\xE73"],"\xB3"=>[18,"\xE73"],"\xB4"=>[77,"\xE74"],"\xB5"=>[18,"\xE74"],"\xB6"=>[77,"\xE75"],"\xB7"=>[18,"\xE75"],"\xB8"=>[77,"\xE76"],"\xB9"=>[18,"\xE76"],"\xBA"=>[77,"\xE77"],"\xBB"=>[18,"\xE77"],"\xBC"=>[77,"\xE78"],"\xBD"=>[18,"\xE78"],"\xBE"=>[77,"\xE79"],"\xBF"=>[18,"\xE79"],"\xC0"=>[77,"\xE7\x3D"],"\xC1"=>[18,"\xE7\x3D"],"\xC2"=>[77,"\xE7A"],"\xC3"=>[18,"\xE7A"],"\xC4"=>[77,"\xE7_"],"\xC5"=>[18,"\xE7_"],"\xC6"=>[77,"\xE7b"],"\xC7"=>[18,"\xE7b"],"\xC8"=>[77,"\xE7d"],"\xC9"=>[18,"\xE7d"],"\xCA"=>[77,"\xE7f"],"\xCB"=>[18,"\xE7f"],"\xCC"=>[77,"\xE7g"],"\xCD"=>[18,"\xE7g"],"\xCE"=>[77,"\xE7h"],"\xCF"=>[18,"\xE7h"],"\xD0"=>[77,"\xE7l"],"\xD1"=>[18,"\xE7l"],"\xD2"=>[77,"\xE7m"],"\xD3"=>[18,"\xE7m"],"\xD4"=>[77,"\xE7n"],"\xD5"=>[18,"\xE7n"],"\xD6"=>[77,"\xE7p"],"\xD7"=>[18,"\xE7p"],"\xD8"=>[77,"\xE7r"],"\xD9"=>[18,"\xE7r"],"\xDA"=>[77,"\xE7u"],"\xDB"=>[18,"\xE7u"],"\xDC"=>[0,"\xE7\x3A"],"\xDD"=>[0,"\xE7B"],"\xDE"=>[0,"\xE7C"],"\xDF"=>[0,"\xE7D"],"\xE0"=>[0,"\xE7E"],"\xE1"=>[0,"\xE7F"],"\xE2"=>[0,"\xE7G"],"\xE3"=>[0,"\xE7H"],"\xE4"=>[0,"\xE7I"],"\xE5"=>[0,"\xE7J"],"\xE6"=>[0,"\xE7K"],"\xE7"=>[0,"\xE7L"],"\xE8"=>[0,"\xE7M"],"\xE9"=>[0,"\xE7N"],"\xEA"=>[0,"\xE7O"],"\xEB"=>[0,"\xE7P"],"\xEC"=>[0,"\xE7Q"],"\xED"=>[0,"\xE7R"],"\xEE"=>[0,"\xE7S"],"\xEF"=>[0,"\xE7T"],"\xF0"=>[0,"\xE7U"],"\xF1"=>[0,"\xE7V"],"\xF2"=>[0,"\xE7W"],"\xF3"=>[0,"\xE7Y"],"\xF4"=>[0,"\xE7j"],"\xF5"=>[0,"\xE7k"],"\xF6"=>[0,"\xE7q"],"\xF7"=>[0,"\xE7v"],"\xF8"=>[0,"\xE7w"],"\xF9"=>[0,"\xE7x"],"\xFA"=>[0,"\xE7y"],"\xFB"=>[0,"\xE7z"],"\xFC"=>[82,"\xE7"],"\xFD"=>[87,"\xE7"],"\xFE"=>[130,"\xE7"],"\xFF"=>[9,"\xE7"],],["\x00"=>[94,"\xC60"],"\x01"=>[76,"\xC60"],"\x02"=>[104,"\xC60"],"\x03"=>[16,"\xC60"],"\x04"=>[94,"\xC61"],"\x05"=>[76,"\xC61"],"\x06"=>[104,"\xC61"],"\x07"=>[16,"\xC61"],"\x08"=>[94,"\xC62"],"\x09"=>[76,"\xC62"],"\x0A"=>[104,"\xC62"],"\x0B"=>[16,"\xC62"],"\x0C"=>[94,"\xC6a"],"\x0D"=>[76,"\xC6a"],"\x0E"=>[104,"\xC6a"],"\x0F"=>[16,"\xC6a"],"\x10"=>[94,"\xC6c"],"\x11"=>[76,"\xC6c"],"\x12"=>[104,"\xC6c"],"\x13"=>[16,"\xC6c"],"\x14"=>[94,"\xC6e"],"\x15"=>[76,"\xC6e"],"\x16"=>[104,"\xC6e"],"\x17"=>[16,"\xC6e"],"\x18"=>[94,"\xC6i"],"\x19"=>[76,"\xC6i"],"\x1A"=>[104,"\xC6i"],"\x1B"=>[16,"\xC6i"],"\x1C"=>[94,"\xC6o"],"\x1D"=>[76,"\xC6o"],"\x1E"=>[104,"\xC6o"],"\x1F"=>[16,"\xC6o"],"\x20"=>[94,"\xC6s"],"\x21"=>[76,"\xC6s"],"\x22"=>[104,"\xC6s"],"\x23"=>[16,"\xC6s"],"\x24"=>[94,"\xC6t"],"\x25"=>[76,"\xC6t"],"\x26"=>[104,"\xC6t"],"\x27"=>[16,"\xC6t"],"\x28"=>[77,"\xC6\x20"],"\x29"=>[18,"\xC6\x20"],"\x2A"=>[77,"\xC6\x25"],"\x2B"=>[18,"\xC6\x25"],"\x2C"=>[77,"\xC6-"],"-"=>[18,"\xC6-"],"."=>[77,"\xC6."],"\x2F"=>[18,"\xC6."],[77,"\xC6\x2F"],[18,"\xC6\x2F"],[77,"\xC63"],[18,"\xC63"],[77,"\xC64"],[18,"\xC64"],[77,"\xC65"],[18,"\xC65"],[77,"\xC66"],[18,"\xC66"],"\x3A"=>[77,"\xC67"],"\x3B"=>[18,"\xC67"],"\x3C"=>[77,"\xC68"],"\x3D"=>[18,"\xC68"],"\x3E"=>[77,"\xC69"],"\x3F"=>[18,"\xC69"],"\x40"=>[77,"\xC6\x3D"],"A"=>[18,"\xC6\x3D"],"B"=>[77,"\xC6A"],"C"=>[18,"\xC6A"],"D"=>[77,"\xC6_"],"E"=>[18,"\xC6_"],"F"=>[77,"\xC6b"],"G"=>[18,"\xC6b"],"H"=>[77,"\xC6d"],"I"=>[18,"\xC6d"],"J"=>[77,"\xC6f"],"K"=>[18,"\xC6f"],"L"=>[77,"\xC6g"],"M"=>[18,"\xC6g"],"N"=>[77,"\xC6h"],"O"=>[18,"\xC6h"],"P"=>[77,"\xC6l"],"Q"=>[18,"\xC6l"],"R"=>[77,"\xC6m"],"S"=>[18,"\xC6m"],"T"=>[77,"\xC6n"],"U"=>[18,"\xC6n"],"V"=>[77,"\xC6p"],"W"=>[18,"\xC6p"],"X"=>[77,"\xC6r"],"Y"=>[18,"\xC6r"],"Z"=>[77,"\xC6u"],"\x5B"=>[18,"\xC6u"],"\x5C"=>[0,"\xC6\x3A"],"\x5D"=>[0,"\xC6B"],"\x5E"=>[0,"\xC6C"],"_"=>[0,"\xC6D"],"\x60"=>[0,"\xC6E"],"a"=>[0,"\xC6F"],"b"=>[0,"\xC6G"],"c"=>[0,"\xC6H"],"d"=>[0,"\xC6I"],"e"=>[0,"\xC6J"],"f"=>[0,"\xC6K"],"g"=>[0,"\xC6L"],"h"=>[0,"\xC6M"],"i"=>[0,"\xC6N"],"j"=>[0,"\xC6O"],"k"=>[0,"\xC6P"],"l"=>[0,"\xC6Q"],"m"=>[0,"\xC6R"],"n"=>[0,"\xC6S"],"o"=>[0,"\xC6T"],"p"=>[0,"\xC6U"],"q"=>[0,"\xC6V"],"r"=>[0,"\xC6W"],"s"=>[0,"\xC6Y"],"t"=>[0,"\xC6j"],"u"=>[0,"\xC6k"],"v"=>[0,"\xC6q"],"w"=>[0,"\xC6v"],"x"=>[0,"\xC6w"],"y"=>[0,"\xC6x"],"z"=>[0,"\xC6y"],"\x7B"=>[0,"\xC6z"],"\x7C"=>[82,"\xC6"],"\x7D"=>[87,"\xC6"],"~"=>[130,"\xC6"],"\x7F"=>[9,"\xC6"],"\x80"=>[94,"\xE40"],"\x81"=>[76,"\xE40"],"\x82"=>[104,"\xE40"],"\x83"=>[16,"\xE40"],"\x84"=>[94,"\xE41"],"\x85"=>[76,"\xE41"],"\x86"=>[104,"\xE41"],"\x87"=>[16,"\xE41"],"\x88"=>[94,"\xE42"],"\x89"=>[76,"\xE42"],"\x8A"=>[104,"\xE42"],"\x8B"=>[16,"\xE42"],"\x8C"=>[94,"\xE4a"],"\x8D"=>[76,"\xE4a"],"\x8E"=>[104,"\xE4a"],"\x8F"=>[16,"\xE4a"],"\x90"=>[94,"\xE4c"],"\x91"=>[76,"\xE4c"],"\x92"=>[104,"\xE4c"],"\x93"=>[16,"\xE4c"],"\x94"=>[94,"\xE4e"],"\x95"=>[76,"\xE4e"],"\x96"=>[104,"\xE4e"],"\x97"=>[16,"\xE4e"],"\x98"=>[94,"\xE4i"],"\x99"=>[76,"\xE4i"],"\x9A"=>[104,"\xE4i"],"\x9B"=>[16,"\xE4i"],"\x9C"=>[94,"\xE4o"],"\x9D"=>[76,"\xE4o"],"\x9E"=>[104,"\xE4o"],"\x9F"=>[16,"\xE4o"],"\xA0"=>[94,"\xE4s"],"\xA1"=>[76,"\xE4s"],"\xA2"=>[104,"\xE4s"],"\xA3"=>[16,"\xE4s"],"\xA4"=>[94,"\xE4t"],"\xA5"=>[76,"\xE4t"],"\xA6"=>[104,"\xE4t"],"\xA7"=>[16,"\xE4t"],"\xA8"=>[77,"\xE4\x20"],"\xA9"=>[18,"\xE4\x20"],"\xAA"=>[77,"\xE4\x25"],"\xAB"=>[18,"\xE4\x25"],"\xAC"=>[77,"\xE4-"],"\xAD"=>[18,"\xE4-"],"\xAE"=>[77,"\xE4."],"\xAF"=>[18,"\xE4."],"\xB0"=>[77,"\xE4\x2F"],"\xB1"=>[18,"\xE4\x2F"],"\xB2"=>[77,"\xE43"],"\xB3"=>[18,"\xE43"],"\xB4"=>[77,"\xE44"],"\xB5"=>[18,"\xE44"],"\xB6"=>[77,"\xE45"],"\xB7"=>[18,"\xE45"],"\xB8"=>[77,"\xE46"],"\xB9"=>[18,"\xE46"],"\xBA"=>[77,"\xE47"],"\xBB"=>[18,"\xE47"],"\xBC"=>[77,"\xE48"],"\xBD"=>[18,"\xE48"],"\xBE"=>[77,"\xE49"],"\xBF"=>[18,"\xE49"],"\xC0"=>[77,"\xE4\x3D"],"\xC1"=>[18,"\xE4\x3D"],"\xC2"=>[77,"\xE4A"],"\xC3"=>[18,"\xE4A"],"\xC4"=>[77,"\xE4_"],"\xC5"=>[18,"\xE4_"],"\xC6"=>[77,"\xE4b"],"\xC7"=>[18,"\xE4b"],"\xC8"=>[77,"\xE4d"],"\xC9"=>[18,"\xE4d"],"\xCA"=>[77,"\xE4f"],"\xCB"=>[18,"\xE4f"],"\xCC"=>[77,"\xE4g"],"\xCD"=>[18,"\xE4g"],"\xCE"=>[77,"\xE4h"],"\xCF"=>[18,"\xE4h"],"\xD0"=>[77,"\xE4l"],"\xD1"=>[18,"\xE4l"],"\xD2"=>[77,"\xE4m"],"\xD3"=>[18,"\xE4m"],"\xD4"=>[77,"\xE4n"],"\xD5"=>[18,"\xE4n"],"\xD6"=>[77,"\xE4p"],"\xD7"=>[18,"\xE4p"],"\xD8"=>[77,"\xE4r"],"\xD9"=>[18,"\xE4r"],"\xDA"=>[77,"\xE4u"],"\xDB"=>[18,"\xE4u"],"\xDC"=>[0,"\xE4\x3A"],"\xDD"=>[0,"\xE4B"],"\xDE"=>[0,"\xE4C"],"\xDF"=>[0,"\xE4D"],"\xE0"=>[0,"\xE4E"],"\xE1"=>[0,"\xE4F"],"\xE2"=>[0,"\xE4G"],"\xE3"=>[0,"\xE4H"],"\xE4"=>[0,"\xE4I"],"\xE5"=>[0,"\xE4J"],"\xE6"=>[0,"\xE4K"],"\xE7"=>[0,"\xE4L"],"\xE8"=>[0,"\xE4M"],"\xE9"=>[0,"\xE4N"],"\xEA"=>[0,"\xE4O"],"\xEB"=>[0,"\xE4P"],"\xEC"=>[0,"\xE4Q"],"\xED"=>[0,"\xE4R"],"\xEE"=>[0,"\xE4S"],"\xEF"=>[0,"\xE4T"],"\xF0"=>[0,"\xE4U"],"\xF1"=>[0,"\xE4V"],"\xF2"=>[0,"\xE4W"],"\xF3"=>[0,"\xE4Y"],"\xF4"=>[0,"\xE4j"],"\xF5"=>[0,"\xE4k"],"\xF6"=>[0,"\xE4q"],"\xF7"=>[0,"\xE4v"],"\xF8"=>[0,"\xE4w"],"\xF9"=>[0,"\xE4x"],"\xFA"=>[0,"\xE4y"],"\xFB"=>[0,"\xE4z"],"\xFC"=>[82,"\xE4"],"\xFD"=>[87,"\xE4"],"\xFE"=>[130,"\xE4"],"\xFF"=>[9,"\xE4"],],["\x00"=>[77,"\xC60"],"\x01"=>[18,"\xC60"],"\x02"=>[77,"\xC61"],"\x03"=>[18,"\xC61"],"\x04"=>[77,"\xC62"],"\x05"=>[18,"\xC62"],"\x06"=>[77,"\xC6a"],"\x07"=>[18,"\xC6a"],"\x08"=>[77,"\xC6c"],"\x09"=>[18,"\xC6c"],"\x0A"=>[77,"\xC6e"],"\x0B"=>[18,"\xC6e"],"\x0C"=>[77,"\xC6i"],"\x0D"=>[18,"\xC6i"],"\x0E"=>[77,"\xC6o"],"\x0F"=>[18,"\xC6o"],"\x10"=>[77,"\xC6s"],"\x11"=>[18,"\xC6s"],"\x12"=>[77,"\xC6t"],"\x13"=>[18,"\xC6t"],"\x14"=>[0,"\xC6\x20"],"\x15"=>[0,"\xC6\x25"],"\x16"=>[0,"\xC6-"],"\x17"=>[0,"\xC6."],"\x18"=>[0,"\xC6\x2F"],"\x19"=>[0,"\xC63"],"\x1A"=>[0,"\xC64"],"\x1B"=>[0,"\xC65"],"\x1C"=>[0,"\xC66"],"\x1D"=>[0,"\xC67"],"\x1E"=>[0,"\xC68"],"\x1F"=>[0,"\xC69"],"\x20"=>[0,"\xC6\x3D"],"\x21"=>[0,"\xC6A"],"\x22"=>[0,"\xC6_"],"\x23"=>[0,"\xC6b"],"\x24"=>[0,"\xC6d"],"\x25"=>[0,"\xC6f"],"\x26"=>[0,"\xC6g"],"\x27"=>[0,"\xC6h"],"\x28"=>[0,"\xC6l"],"\x29"=>[0,"\xC6m"],"\x2A"=>[0,"\xC6n"],"\x2B"=>[0,"\xC6p"],"\x2C"=>[0,"\xC6r"],"-"=>[0,"\xC6u"],"."=>[100,"\xC6"],"\x2F"=>[110,"\xC6"],[111,"\xC6"],[115,"\xC6"],[116,"\xC6"],[118,"\xC6"],[119,"\xC6"],[122,"\xC6"],[123,"\xC6"],[125,"\xC6"],[126,"\xC6"],[129,"\xC6"],"\x3A"=>[143,"\xC6"],"\x3B"=>[148,"\xC6"],"\x3C"=>[151,"\xC6"],"\x3D"=>[153,"\xC6"],"\x3E"=>[83,"\xC6"],"\x3F"=>[10,"\xC6"],"\x40"=>[77,"\xE40"],"A"=>[18,"\xE40"],"B"=>[77,"\xE41"],"C"=>[18,"\xE41"],"D"=>[77,"\xE42"],"E"=>[18,"\xE42"],"F"=>[77,"\xE4a"],"G"=>[18,"\xE4a"],"H"=>[77,"\xE4c"],"I"=>[18,"\xE4c"],"J"=>[77,"\xE4e"],"K"=>[18,"\xE4e"],"L"=>[77,"\xE4i"],"M"=>[18,"\xE4i"],"N"=>[77,"\xE4o"],"O"=>[18,"\xE4o"],"P"=>[77,"\xE4s"],"Q"=>[18,"\xE4s"],"R"=>[77,"\xE4t"],"S"=>[18,"\xE4t"],"T"=>[0,"\xE4\x20"],"U"=>[0,"\xE4\x25"],"V"=>[0,"\xE4-"],"W"=>[0,"\xE4."],"X"=>[0,"\xE4\x2F"],"Y"=>[0,"\xE43"],"Z"=>[0,"\xE44"],"\x5B"=>[0,"\xE45"],"\x5C"=>[0,"\xE46"],"\x5D"=>[0,"\xE47"],"\x5E"=>[0,"\xE48"],"_"=>[0,"\xE49"],"\x60"=>[0,"\xE4\x3D"],"a"=>[0,"\xE4A"],"b"=>[0,"\xE4_"],"c"=>[0,"\xE4b"],"d"=>[0,"\xE4d"],"e"=>[0,"\xE4f"],"f"=>[0,"\xE4g"],"g"=>[0,"\xE4h"],"h"=>[0,"\xE4l"],"i"=>[0,"\xE4m"],"j"=>[0,"\xE4n"],"k"=>[0,"\xE4p"],"l"=>[0,"\xE4r"],"m"=>[0,"\xE4u"],"n"=>[100,"\xE4"],"o"=>[110,"\xE4"],"p"=>[111,"\xE4"],"q"=>[115,"\xE4"],"r"=>[116,"\xE4"],"s"=>[118,"\xE4"],"t"=>[119,"\xE4"],"u"=>[122,"\xE4"],"v"=>[123,"\xE4"],"w"=>[125,"\xE4"],"x"=>[126,"\xE4"],"y"=>[129,"\xE4"],"z"=>[143,"\xE4"],"\x7B"=>[148,"\xE4"],"\x7C"=>[151,"\xE4"],"\x7D"=>[153,"\xE4"],"~"=>[83,"\xE4"],"\x7F"=>[10,"\xE4"],"\x80"=>[77,"\xE80"],"\x81"=>[18,"\xE80"],"\x82"=>[77,"\xE81"],"\x83"=>[18,"\xE81"],"\x84"=>[77,"\xE82"],"\x85"=>[18,"\xE82"],"\x86"=>[77,"\xE8a"],"\x87"=>[18,"\xE8a"],"\x88"=>[77,"\xE8c"],"\x89"=>[18,"\xE8c"],"\x8A"=>[77,"\xE8e"],"\x8B"=>[18,"\xE8e"],"\x8C"=>[77,"\xE8i"],"\x8D"=>[18,"\xE8i"],"\x8E"=>[77,"\xE8o"],"\x8F"=>[18,"\xE8o"],"\x90"=>[77,"\xE8s"],"\x91"=>[18,"\xE8s"],"\x92"=>[77,"\xE8t"],"\x93"=>[18,"\xE8t"],"\x94"=>[0,"\xE8\x20"],"\x95"=>[0,"\xE8\x25"],"\x96"=>[0,"\xE8-"],"\x97"=>[0,"\xE8."],"\x98"=>[0,"\xE8\x2F"],"\x99"=>[0,"\xE83"],"\x9A"=>[0,"\xE84"],"\x9B"=>[0,"\xE85"],"\x9C"=>[0,"\xE86"],"\x9D"=>[0,"\xE87"],"\x9E"=>[0,"\xE88"],"\x9F"=>[0,"\xE89"],"\xA0"=>[0,"\xE8\x3D"],"\xA1"=>[0,"\xE8A"],"\xA2"=>[0,"\xE8_"],"\xA3"=>[0,"\xE8b"],"\xA4"=>[0,"\xE8d"],"\xA5"=>[0,"\xE8f"],"\xA6"=>[0,"\xE8g"],"\xA7"=>[0,"\xE8h"],"\xA8"=>[0,"\xE8l"],"\xA9"=>[0,"\xE8m"],"\xAA"=>[0,"\xE8n"],"\xAB"=>[0,"\xE8p"],"\xAC"=>[0,"\xE8r"],"\xAD"=>[0,"\xE8u"],"\xAE"=>[100,"\xE8"],"\xAF"=>[110,"\xE8"],"\xB0"=>[111,"\xE8"],"\xB1"=>[115,"\xE8"],"\xB2"=>[116,"\xE8"],"\xB3"=>[118,"\xE8"],"\xB4"=>[119,"\xE8"],"\xB5"=>[122,"\xE8"],"\xB6"=>[123,"\xE8"],"\xB7"=>[125,"\xE8"],"\xB8"=>[126,"\xE8"],"\xB9"=>[129,"\xE8"],"\xBA"=>[143,"\xE8"],"\xBB"=>[148,"\xE8"],"\xBC"=>[151,"\xE8"],"\xBD"=>[153,"\xE8"],"\xBE"=>[83,"\xE8"],"\xBF"=>[10,"\xE8"],"\xC0"=>[77,"\xE90"],"\xC1"=>[18,"\xE90"],"\xC2"=>[77,"\xE91"],"\xC3"=>[18,"\xE91"],"\xC4"=>[77,"\xE92"],"\xC5"=>[18,"\xE92"],"\xC6"=>[77,"\xE9a"],"\xC7"=>[18,"\xE9a"],"\xC8"=>[77,"\xE9c"],"\xC9"=>[18,"\xE9c"],"\xCA"=>[77,"\xE9e"],"\xCB"=>[18,"\xE9e"],"\xCC"=>[77,"\xE9i"],"\xCD"=>[18,"\xE9i"],"\xCE"=>[77,"\xE9o"],"\xCF"=>[18,"\xE9o"],"\xD0"=>[77,"\xE9s"],"\xD1"=>[18,"\xE9s"],"\xD2"=>[77,"\xE9t"],"\xD3"=>[18,"\xE9t"],"\xD4"=>[0,"\xE9\x20"],"\xD5"=>[0,"\xE9\x25"],"\xD6"=>[0,"\xE9-"],"\xD7"=>[0,"\xE9."],"\xD8"=>[0,"\xE9\x2F"],"\xD9"=>[0,"\xE93"],"\xDA"=>[0,"\xE94"],"\xDB"=>[0,"\xE95"],"\xDC"=>[0,"\xE96"],"\xDD"=>[0,"\xE97"],"\xDE"=>[0,"\xE98"],"\xDF"=>[0,"\xE99"],"\xE0"=>[0,"\xE9\x3D"],"\xE1"=>[0,"\xE9A"],"\xE2"=>[0,"\xE9_"],"\xE3"=>[0,"\xE9b"],"\xE4"=>[0,"\xE9d"],"\xE5"=>[0,"\xE9f"],"\xE6"=>[0,"\xE9g"],"\xE7"=>[0,"\xE9h"],"\xE8"=>[0,"\xE9l"],"\xE9"=>[0,"\xE9m"],"\xEA"=>[0,"\xE9n"],"\xEB"=>[0,"\xE9p"],"\xEC"=>[0,"\xE9r"],"\xED"=>[0,"\xE9u"],"\xEE"=>[100,"\xE9"],"\xEF"=>[110,"\xE9"],"\xF0"=>[111,"\xE9"],"\xF1"=>[115,"\xE9"],"\xF2"=>[116,"\xE9"],"\xF3"=>[118,"\xE9"],"\xF4"=>[119,"\xE9"],"\xF5"=>[122,"\xE9"],"\xF6"=>[123,"\xE9"],"\xF7"=>[125,"\xE9"],"\xF8"=>[126,"\xE9"],"\xF9"=>[129,"\xE9"],"\xFA"=>[143,"\xE9"],"\xFB"=>[148,"\xE9"],"\xFC"=>[151,"\xE9"],"\xFD"=>[153,"\xE9"],"\xFE"=>[83,"\xE9"],"\xFF"=>[10,"\xE9"],],["\x00"=>[94,"\xC70"],"\x01"=>[76,"\xC70"],"\x02"=>[104,"\xC70"],"\x03"=>[16,"\xC70"],"\x04"=>[94,"\xC71"],"\x05"=>[76,"\xC71"],"\x06"=>[104,"\xC71"],"\x07"=>[16,"\xC71"],"\x08"=>[94,"\xC72"],"\x09"=>[76,"\xC72"],"\x0A"=>[104,"\xC72"],"\x0B"=>[16,"\xC72"],"\x0C"=>[94,"\xC7a"],"\x0D"=>[76,"\xC7a"],"\x0E"=>[104,"\xC7a"],"\x0F"=>[16,"\xC7a"],"\x10"=>[94,"\xC7c"],"\x11"=>[76,"\xC7c"],"\x12"=>[104,"\xC7c"],"\x13"=>[16,"\xC7c"],"\x14"=>[94,"\xC7e"],"\x15"=>[76,"\xC7e"],"\x16"=>[104,"\xC7e"],"\x17"=>[16,"\xC7e"],"\x18"=>[94,"\xC7i"],"\x19"=>[76,"\xC7i"],"\x1A"=>[104,"\xC7i"],"\x1B"=>[16,"\xC7i"],"\x1C"=>[94,"\xC7o"],"\x1D"=>[76,"\xC7o"],"\x1E"=>[104,"\xC7o"],"\x1F"=>[16,"\xC7o"],"\x20"=>[94,"\xC7s"],"\x21"=>[76,"\xC7s"],"\x22"=>[104,"\xC7s"],"\x23"=>[16,"\xC7s"],"\x24"=>[94,"\xC7t"],"\x25"=>[76,"\xC7t"],"\x26"=>[104,"\xC7t"],"\x27"=>[16,"\xC7t"],"\x28"=>[77,"\xC7\x20"],"\x29"=>[18,"\xC7\x20"],"\x2A"=>[77,"\xC7\x25"],"\x2B"=>[18,"\xC7\x25"],"\x2C"=>[77,"\xC7-"],"-"=>[18,"\xC7-"],"."=>[77,"\xC7."],"\x2F"=>[18,"\xC7."],[77,"\xC7\x2F"],[18,"\xC7\x2F"],[77,"\xC73"],[18,"\xC73"],[77,"\xC74"],[18,"\xC74"],[77,"\xC75"],[18,"\xC75"],[77,"\xC76"],[18,"\xC76"],"\x3A"=>[77,"\xC77"],"\x3B"=>[18,"\xC77"],"\x3C"=>[77,"\xC78"],"\x3D"=>[18,"\xC78"],"\x3E"=>[77,"\xC79"],"\x3F"=>[18,"\xC79"],"\x40"=>[77,"\xC7\x3D"],"A"=>[18,"\xC7\x3D"],"B"=>[77,"\xC7A"],"C"=>[18,"\xC7A"],"D"=>[77,"\xC7_"],"E"=>[18,"\xC7_"],"F"=>[77,"\xC7b"],"G"=>[18,"\xC7b"],"H"=>[77,"\xC7d"],"I"=>[18,"\xC7d"],"J"=>[77,"\xC7f"],"K"=>[18,"\xC7f"],"L"=>[77,"\xC7g"],"M"=>[18,"\xC7g"],"N"=>[77,"\xC7h"],"O"=>[18,"\xC7h"],"P"=>[77,"\xC7l"],"Q"=>[18,"\xC7l"],"R"=>[77,"\xC7m"],"S"=>[18,"\xC7m"],"T"=>[77,"\xC7n"],"U"=>[18,"\xC7n"],"V"=>[77,"\xC7p"],"W"=>[18,"\xC7p"],"X"=>[77,"\xC7r"],"Y"=>[18,"\xC7r"],"Z"=>[77,"\xC7u"],"\x5B"=>[18,"\xC7u"],"\x5C"=>[0,"\xC7\x3A"],"\x5D"=>[0,"\xC7B"],"\x5E"=>[0,"\xC7C"],"_"=>[0,"\xC7D"],"\x60"=>[0,"\xC7E"],"a"=>[0,"\xC7F"],"b"=>[0,"\xC7G"],"c"=>[0,"\xC7H"],"d"=>[0,"\xC7I"],"e"=>[0,"\xC7J"],"f"=>[0,"\xC7K"],"g"=>[0,"\xC7L"],"h"=>[0,"\xC7M"],"i"=>[0,"\xC7N"],"j"=>[0,"\xC7O"],"k"=>[0,"\xC7P"],"l"=>[0,"\xC7Q"],"m"=>[0,"\xC7R"],"n"=>[0,"\xC7S"],"o"=>[0,"\xC7T"],"p"=>[0,"\xC7U"],"q"=>[0,"\xC7V"],"r"=>[0,"\xC7W"],"s"=>[0,"\xC7Y"],"t"=>[0,"\xC7j"],"u"=>[0,"\xC7k"],"v"=>[0,"\xC7q"],"w"=>[0,"\xC7v"],"x"=>[0,"\xC7w"],"y"=>[0,"\xC7x"],"z"=>[0,"\xC7y"],"\x7B"=>[0,"\xC7z"],"\x7C"=>[82,"\xC7"],"\x7D"=>[87,"\xC7"],"~"=>[130,"\xC7"],"\x7F"=>[9,"\xC7"],"\x80"=>[94,"\xCF0"],"\x81"=>[76,"\xCF0"],"\x82"=>[104,"\xCF0"],"\x83"=>[16,"\xCF0"],"\x84"=>[94,"\xCF1"],"\x85"=>[76,"\xCF1"],"\x86"=>[104,"\xCF1"],"\x87"=>[16,"\xCF1"],"\x88"=>[94,"\xCF2"],"\x89"=>[76,"\xCF2"],"\x8A"=>[104,"\xCF2"],"\x8B"=>[16,"\xCF2"],"\x8C"=>[94,"\xCFa"],"\x8D"=>[76,"\xCFa"],"\x8E"=>[104,"\xCFa"],"\x8F"=>[16,"\xCFa"],"\x90"=>[94,"\xCFc"],"\x91"=>[76,"\xCFc"],"\x92"=>[104,"\xCFc"],"\x93"=>[16,"\xCFc"],"\x94"=>[94,"\xCFe"],"\x95"=>[76,"\xCFe"],"\x96"=>[104,"\xCFe"],"\x97"=>[16,"\xCFe"],"\x98"=>[94,"\xCFi"],"\x99"=>[76,"\xCFi"],"\x9A"=>[104,"\xCFi"],"\x9B"=>[16,"\xCFi"],"\x9C"=>[94,"\xCFo"],"\x9D"=>[76,"\xCFo"],"\x9E"=>[104,"\xCFo"],"\x9F"=>[16,"\xCFo"],"\xA0"=>[94,"\xCFs"],"\xA1"=>[76,"\xCFs"],"\xA2"=>[104,"\xCFs"],"\xA3"=>[16,"\xCFs"],"\xA4"=>[94,"\xCFt"],"\xA5"=>[76,"\xCFt"],"\xA6"=>[104,"\xCFt"],"\xA7"=>[16,"\xCFt"],"\xA8"=>[77,"\xCF\x20"],"\xA9"=>[18,"\xCF\x20"],"\xAA"=>[77,"\xCF\x25"],"\xAB"=>[18,"\xCF\x25"],"\xAC"=>[77,"\xCF-"],"\xAD"=>[18,"\xCF-"],"\xAE"=>[77,"\xCF."],"\xAF"=>[18,"\xCF."],"\xB0"=>[77,"\xCF\x2F"],"\xB1"=>[18,"\xCF\x2F"],"\xB2"=>[77,"\xCF3"],"\xB3"=>[18,"\xCF3"],"\xB4"=>[77,"\xCF4"],"\xB5"=>[18,"\xCF4"],"\xB6"=>[77,"\xCF5"],"\xB7"=>[18,"\xCF5"],"\xB8"=>[77,"\xCF6"],"\xB9"=>[18,"\xCF6"],"\xBA"=>[77,"\xCF7"],"\xBB"=>[18,"\xCF7"],"\xBC"=>[77,"\xCF8"],"\xBD"=>[18,"\xCF8"],"\xBE"=>[77,"\xCF9"],"\xBF"=>[18,"\xCF9"],"\xC0"=>[77,"\xCF\x3D"],"\xC1"=>[18,"\xCF\x3D"],"\xC2"=>[77,"\xCFA"],"\xC3"=>[18,"\xCFA"],"\xC4"=>[77,"\xCF_"],"\xC5"=>[18,"\xCF_"],"\xC6"=>[77,"\xCFb"],"\xC7"=>[18,"\xCFb"],"\xC8"=>[77,"\xCFd"],"\xC9"=>[18,"\xCFd"],"\xCA"=>[77,"\xCFf"],"\xCB"=>[18,"\xCFf"],"\xCC"=>[77,"\xCFg"],"\xCD"=>[18,"\xCFg"],"\xCE"=>[77,"\xCFh"],"\xCF"=>[18,"\xCFh"],"\xD0"=>[77,"\xCFl"],"\xD1"=>[18,"\xCFl"],"\xD2"=>[77,"\xCFm"],"\xD3"=>[18,"\xCFm"],"\xD4"=>[77,"\xCFn"],"\xD5"=>[18,"\xCFn"],"\xD6"=>[77,"\xCFp"],"\xD7"=>[18,"\xCFp"],"\xD8"=>[77,"\xCFr"],"\xD9"=>[18,"\xCFr"],"\xDA"=>[77,"\xCFu"],"\xDB"=>[18,"\xCFu"],"\xDC"=>[0,"\xCF\x3A"],"\xDD"=>[0,"\xCFB"],"\xDE"=>[0,"\xCFC"],"\xDF"=>[0,"\xCFD"],"\xE0"=>[0,"\xCFE"],"\xE1"=>[0,"\xCFF"],"\xE2"=>[0,"\xCFG"],"\xE3"=>[0,"\xCFH"],"\xE4"=>[0,"\xCFI"],"\xE5"=>[0,"\xCFJ"],"\xE6"=>[0,"\xCFK"],"\xE7"=>[0,"\xCFL"],"\xE8"=>[0,"\xCFM"],"\xE9"=>[0,"\xCFN"],"\xEA"=>[0,"\xCFO"],"\xEB"=>[0,"\xCFP"],"\xEC"=>[0,"\xCFQ"],"\xED"=>[0,"\xCFR"],"\xEE"=>[0,"\xCFS"],"\xEF"=>[0,"\xCFT"],"\xF0"=>[0,"\xCFU"],"\xF1"=>[0,"\xCFV"],"\xF2"=>[0,"\xCFW"],"\xF3"=>[0,"\xCFY"],"\xF4"=>[0,"\xCFj"],"\xF5"=>[0,"\xCFk"],"\xF6"=>[0,"\xCFq"],"\xF7"=>[0,"\xCFv"],"\xF8"=>[0,"\xCFw"],"\xF9"=>[0,"\xCFx"],"\xFA"=>[0,"\xCFy"],"\xFB"=>[0,"\xCFz"],"\xFC"=>[82,"\xCF"],"\xFD"=>[87,"\xCF"],"\xFE"=>[130,"\xCF"],"\xFF"=>[9,"\xCF"],],["\x00"=>[77,"\xC70"],"\x01"=>[18,"\xC70"],"\x02"=>[77,"\xC71"],"\x03"=>[18,"\xC71"],"\x04"=>[77,"\xC72"],"\x05"=>[18,"\xC72"],"\x06"=>[77,"\xC7a"],"\x07"=>[18,"\xC7a"],"\x08"=>[77,"\xC7c"],"\x09"=>[18,"\xC7c"],"\x0A"=>[77,"\xC7e"],"\x0B"=>[18,"\xC7e"],"\x0C"=>[77,"\xC7i"],"\x0D"=>[18,"\xC7i"],"\x0E"=>[77,"\xC7o"],"\x0F"=>[18,"\xC7o"],"\x10"=>[77,"\xC7s"],"\x11"=>[18,"\xC7s"],"\x12"=>[77,"\xC7t"],"\x13"=>[18,"\xC7t"],"\x14"=>[0,"\xC7\x20"],"\x15"=>[0,"\xC7\x25"],"\x16"=>[0,"\xC7-"],"\x17"=>[0,"\xC7."],"\x18"=>[0,"\xC7\x2F"],"\x19"=>[0,"\xC73"],"\x1A"=>[0,"\xC74"],"\x1B"=>[0,"\xC75"],"\x1C"=>[0,"\xC76"],"\x1D"=>[0,"\xC77"],"\x1E"=>[0,"\xC78"],"\x1F"=>[0,"\xC79"],"\x20"=>[0,"\xC7\x3D"],"\x21"=>[0,"\xC7A"],"\x22"=>[0,"\xC7_"],"\x23"=>[0,"\xC7b"],"\x24"=>[0,"\xC7d"],"\x25"=>[0,"\xC7f"],"\x26"=>[0,"\xC7g"],"\x27"=>[0,"\xC7h"],"\x28"=>[0,"\xC7l"],"\x29"=>[0,"\xC7m"],"\x2A"=>[0,"\xC7n"],"\x2B"=>[0,"\xC7p"],"\x2C"=>[0,"\xC7r"],"-"=>[0,"\xC7u"],"."=>[100,"\xC7"],"\x2F"=>[110,"\xC7"],[111,"\xC7"],[115,"\xC7"],[116,"\xC7"],[118,"\xC7"],[119,"\xC7"],[122,"\xC7"],[123,"\xC7"],[125,"\xC7"],[126,"\xC7"],[129,"\xC7"],"\x3A"=>[143,"\xC7"],"\x3B"=>[148,"\xC7"],"\x3C"=>[151,"\xC7"],"\x3D"=>[153,"\xC7"],"\x3E"=>[83,"\xC7"],"\x3F"=>[10,"\xC7"],"\x40"=>[77,"\xCF0"],"A"=>[18,"\xCF0"],"B"=>[77,"\xCF1"],"C"=>[18,"\xCF1"],"D"=>[77,"\xCF2"],"E"=>[18,"\xCF2"],"F"=>[77,"\xCFa"],"G"=>[18,"\xCFa"],"H"=>[77,"\xCFc"],"I"=>[18,"\xCFc"],"J"=>[77,"\xCFe"],"K"=>[18,"\xCFe"],"L"=>[77,"\xCFi"],"M"=>[18,"\xCFi"],"N"=>[77,"\xCFo"],"O"=>[18,"\xCFo"],"P"=>[77,"\xCFs"],"Q"=>[18,"\xCFs"],"R"=>[77,"\xCFt"],"S"=>[18,"\xCFt"],"T"=>[0,"\xCF\x20"],"U"=>[0,"\xCF\x25"],"V"=>[0,"\xCF-"],"W"=>[0,"\xCF."],"X"=>[0,"\xCF\x2F"],"Y"=>[0,"\xCF3"],"Z"=>[0,"\xCF4"],"\x5B"=>[0,"\xCF5"],"\x5C"=>[0,"\xCF6"],"\x5D"=>[0,"\xCF7"],"\x5E"=>[0,"\xCF8"],"_"=>[0,"\xCF9"],"\x60"=>[0,"\xCF\x3D"],"a"=>[0,"\xCFA"],"b"=>[0,"\xCF_"],"c"=>[0,"\xCFb"],"d"=>[0,"\xCFd"],"e"=>[0,"\xCFf"],"f"=>[0,"\xCFg"],"g"=>[0,"\xCFh"],"h"=>[0,"\xCFl"],"i"=>[0,"\xCFm"],"j"=>[0,"\xCFn"],"k"=>[0,"\xCFp"],"l"=>[0,"\xCFr"],"m"=>[0,"\xCFu"],"n"=>[100,"\xCF"],"o"=>[110,"\xCF"],"p"=>[111,"\xCF"],"q"=>[115,"\xCF"],"r"=>[116,"\xCF"],"s"=>[118,"\xCF"],"t"=>[119,"\xCF"],"u"=>[122,"\xCF"],"v"=>[123,"\xCF"],"w"=>[125,"\xCF"],"x"=>[126,"\xCF"],"y"=>[129,"\xCF"],"z"=>[143,"\xCF"],"\x7B"=>[148,"\xCF"],"\x7C"=>[151,"\xCF"],"\x7D"=>[153,"\xCF"],"~"=>[83,"\xCF"],"\x7F"=>[10,"\xCF"],"\x80"=>[77,"\xEA0"],"\x81"=>[18,"\xEA0"],"\x82"=>[77,"\xEA1"],"\x83"=>[18,"\xEA1"],"\x84"=>[77,"\xEA2"],"\x85"=>[18,"\xEA2"],"\x86"=>[77,"\xEAa"],"\x87"=>[18,"\xEAa"],"\x88"=>[77,"\xEAc"],"\x89"=>[18,"\xEAc"],"\x8A"=>[77,"\xEAe"],"\x8B"=>[18,"\xEAe"],"\x8C"=>[77,"\xEAi"],"\x8D"=>[18,"\xEAi"],"\x8E"=>[77,"\xEAo"],"\x8F"=>[18,"\xEAo"],"\x90"=>[77,"\xEAs"],"\x91"=>[18,"\xEAs"],"\x92"=>[77,"\xEAt"],"\x93"=>[18,"\xEAt"],"\x94"=>[0,"\xEA\x20"],"\x95"=>[0,"\xEA\x25"],"\x96"=>[0,"\xEA-"],"\x97"=>[0,"\xEA."],"\x98"=>[0,"\xEA\x2F"],"\x99"=>[0,"\xEA3"],"\x9A"=>[0,"\xEA4"],"\x9B"=>[0,"\xEA5"],"\x9C"=>[0,"\xEA6"],"\x9D"=>[0,"\xEA7"],"\x9E"=>[0,"\xEA8"],"\x9F"=>[0,"\xEA9"],"\xA0"=>[0,"\xEA\x3D"],"\xA1"=>[0,"\xEAA"],"\xA2"=>[0,"\xEA_"],"\xA3"=>[0,"\xEAb"],"\xA4"=>[0,"\xEAd"],"\xA5"=>[0,"\xEAf"],"\xA6"=>[0,"\xEAg"],"\xA7"=>[0,"\xEAh"],"\xA8"=>[0,"\xEAl"],"\xA9"=>[0,"\xEAm"],"\xAA"=>[0,"\xEAn"],"\xAB"=>[0,"\xEAp"],"\xAC"=>[0,"\xEAr"],"\xAD"=>[0,"\xEAu"],"\xAE"=>[100,"\xEA"],"\xAF"=>[110,"\xEA"],"\xB0"=>[111,"\xEA"],"\xB1"=>[115,"\xEA"],"\xB2"=>[116,"\xEA"],"\xB3"=>[118,"\xEA"],"\xB4"=>[119,"\xEA"],"\xB5"=>[122,"\xEA"],"\xB6"=>[123,"\xEA"],"\xB7"=>[125,"\xEA"],"\xB8"=>[126,"\xEA"],"\xB9"=>[129,"\xEA"],"\xBA"=>[143,"\xEA"],"\xBB"=>[148,"\xEA"],"\xBC"=>[151,"\xEA"],"\xBD"=>[153,"\xEA"],"\xBE"=>[83,"\xEA"],"\xBF"=>[10,"\xEA"],"\xC0"=>[77,"\xEB0"],"\xC1"=>[18,"\xEB0"],"\xC2"=>[77,"\xEB1"],"\xC3"=>[18,"\xEB1"],"\xC4"=>[77,"\xEB2"],"\xC5"=>[18,"\xEB2"],"\xC6"=>[77,"\xEBa"],"\xC7"=>[18,"\xEBa"],"\xC8"=>[77,"\xEBc"],"\xC9"=>[18,"\xEBc"],"\xCA"=>[77,"\xEBe"],"\xCB"=>[18,"\xEBe"],"\xCC"=>[77,"\xEBi"],"\xCD"=>[18,"\xEBi"],"\xCE"=>[77,"\xEBo"],"\xCF"=>[18,"\xEBo"],"\xD0"=>[77,"\xEBs"],"\xD1"=>[18,"\xEBs"],"\xD2"=>[77,"\xEBt"],"\xD3"=>[18,"\xEBt"],"\xD4"=>[0,"\xEB\x20"],"\xD5"=>[0,"\xEB\x25"],"\xD6"=>[0,"\xEB-"],"\xD7"=>[0,"\xEB."],"\xD8"=>[0,"\xEB\x2F"],"\xD9"=>[0,"\xEB3"],"\xDA"=>[0,"\xEB4"],"\xDB"=>[0,"\xEB5"],"\xDC"=>[0,"\xEB6"],"\xDD"=>[0,"\xEB7"],"\xDE"=>[0,"\xEB8"],"\xDF"=>[0,"\xEB9"],"\xE0"=>[0,"\xEB\x3D"],"\xE1"=>[0,"\xEBA"],"\xE2"=>[0,"\xEB_"],"\xE3"=>[0,"\xEBb"],"\xE4"=>[0,"\xEBd"],"\xE5"=>[0,"\xEBf"],"\xE6"=>[0,"\xEBg"],"\xE7"=>[0,"\xEBh"],"\xE8"=>[0,"\xEBl"],"\xE9"=>[0,"\xEBm"],"\xEA"=>[0,"\xEBn"],"\xEB"=>[0,"\xEBp"],"\xEC"=>[0,"\xEBr"],"\xED"=>[0,"\xEBu"],"\xEE"=>[100,"\xEB"],"\xEF"=>[110,"\xEB"],"\xF0"=>[111,"\xEB"],"\xF1"=>[115,"\xEB"],"\xF2"=>[116,"\xEB"],"\xF3"=>[118,"\xEB"],"\xF4"=>[119,"\xEB"],"\xF5"=>[122,"\xEB"],"\xF6"=>[123,"\xEB"],"\xF7"=>[125,"\xEB"],"\xF8"=>[126,"\xEB"],"\xF9"=>[129,"\xEB"],"\xFA"=>[143,"\xEB"],"\xFB"=>[148,"\xEB"],"\xFC"=>[151,"\xEB"],"\xFD"=>[153,"\xEB"],"\xFE"=>[83,"\xEB"],"\xFF"=>[10,"\xEB"],],["\x00"=>[77,"\xEC0"],"\x01"=>[18,"\xEC0"],"\x02"=>[77,"\xEC1"],"\x03"=>[18,"\xEC1"],"\x04"=>[77,"\xEC2"],"\x05"=>[18,"\xEC2"],"\x06"=>[77,"\xECa"],"\x07"=>[18,"\xECa"],"\x08"=>[77,"\xECc"],"\x09"=>[18,"\xECc"],"\x0A"=>[77,"\xECe"],"\x0B"=>[18,"\xECe"],"\x0C"=>[77,"\xECi"],"\x0D"=>[18,"\xECi"],"\x0E"=>[77,"\xECo"],"\x0F"=>[18,"\xECo"],"\x10"=>[77,"\xECs"],"\x11"=>[18,"\xECs"],"\x12"=>[77,"\xECt"],"\x13"=>[18,"\xECt"],"\x14"=>[0,"\xEC\x20"],"\x15"=>[0,"\xEC\x25"],"\x16"=>[0,"\xEC-"],"\x17"=>[0,"\xEC."],"\x18"=>[0,"\xEC\x2F"],"\x19"=>[0,"\xEC3"],"\x1A"=>[0,"\xEC4"],"\x1B"=>[0,"\xEC5"],"\x1C"=>[0,"\xEC6"],"\x1D"=>[0,"\xEC7"],"\x1E"=>[0,"\xEC8"],"\x1F"=>[0,"\xEC9"],"\x20"=>[0,"\xEC\x3D"],"\x21"=>[0,"\xECA"],"\x22"=>[0,"\xEC_"],"\x23"=>[0,"\xECb"],"\x24"=>[0,"\xECd"],"\x25"=>[0,"\xECf"],"\x26"=>[0,"\xECg"],"\x27"=>[0,"\xECh"],"\x28"=>[0,"\xECl"],"\x29"=>[0,"\xECm"],"\x2A"=>[0,"\xECn"],"\x2B"=>[0,"\xECp"],"\x2C"=>[0,"\xECr"],"-"=>[0,"\xECu"],"."=>[100,"\xEC"],"\x2F"=>[110,"\xEC"],[111,"\xEC"],[115,"\xEC"],[116,"\xEC"],[118,"\xEC"],[119,"\xEC"],[122,"\xEC"],[123,"\xEC"],[125,"\xEC"],[126,"\xEC"],[129,"\xEC"],"\x3A"=>[143,"\xEC"],"\x3B"=>[148,"\xEC"],"\x3C"=>[151,"\xEC"],"\x3D"=>[153,"\xEC"],"\x3E"=>[83,"\xEC"],"\x3F"=>[10,"\xEC"],"\x40"=>[77,"\xED0"],"A"=>[18,"\xED0"],"B"=>[77,"\xED1"],"C"=>[18,"\xED1"],"D"=>[77,"\xED2"],"E"=>[18,"\xED2"],"F"=>[77,"\xEDa"],"G"=>[18,"\xEDa"],"H"=>[77,"\xEDc"],"I"=>[18,"\xEDc"],"J"=>[77,"\xEDe"],"K"=>[18,"\xEDe"],"L"=>[77,"\xEDi"],"M"=>[18,"\xEDi"],"N"=>[77,"\xEDo"],"O"=>[18,"\xEDo"],"P"=>[77,"\xEDs"],"Q"=>[18,"\xEDs"],"R"=>[77,"\xEDt"],"S"=>[18,"\xEDt"],"T"=>[0,"\xED\x20"],"U"=>[0,"\xED\x25"],"V"=>[0,"\xED-"],"W"=>[0,"\xED."],"X"=>[0,"\xED\x2F"],"Y"=>[0,"\xED3"],"Z"=>[0,"\xED4"],"\x5B"=>[0,"\xED5"],"\x5C"=>[0,"\xED6"],"\x5D"=>[0,"\xED7"],"\x5E"=>[0,"\xED8"],"_"=>[0,"\xED9"],"\x60"=>[0,"\xED\x3D"],"a"=>[0,"\xEDA"],"b"=>[0,"\xED_"],"c"=>[0,"\xEDb"],"d"=>[0,"\xEDd"],"e"=>[0,"\xEDf"],"f"=>[0,"\xEDg"],"g"=>[0,"\xEDh"],"h"=>[0,"\xEDl"],"i"=>[0,"\xEDm"],"j"=>[0,"\xEDn"],"k"=>[0,"\xEDp"],"l"=>[0,"\xEDr"],"m"=>[0,"\xEDu"],"n"=>[100,"\xED"],"o"=>[110,"\xED"],"p"=>[111,"\xED"],"q"=>[115,"\xED"],"r"=>[116,"\xED"],"s"=>[118,"\xED"],"t"=>[119,"\xED"],"u"=>[122,"\xED"],"v"=>[123,"\xED"],"w"=>[125,"\xED"],"x"=>[126,"\xED"],"y"=>[129,"\xED"],"z"=>[143,"\xED"],"\x7B"=>[148,"\xED"],"\x7C"=>[151,"\xED"],"\x7D"=>[153,"\xED"],"~"=>[83,"\xED"],"\x7F"=>[10,"\xED"],"\x80"=>[0,"\xC70"],"\x81"=>[0,"\xC71"],"\x82"=>[0,"\xC72"],"\x83"=>[0,"\xC7a"],"\x84"=>[0,"\xC7c"],"\x85"=>[0,"\xC7e"],"\x86"=>[0,"\xC7i"],"\x87"=>[0,"\xC7o"],"\x88"=>[0,"\xC7s"],"\x89"=>[0,"\xC7t"],"\x8A"=>[73,"\xC7"],"\x8B"=>[88,"\xC7"],"\x8C"=>[89,"\xC7"],"\x8D"=>[96,"\xC7"],"\x8E"=>[97,"\xC7"],"\x8F"=>[99,"\xC7"],"\x90"=>[106,"\xC7"],"\x91"=>[136,"\xC7"],"\x92"=>[139,"\xC7"],"\x93"=>[141,"\xC7"],"\x94"=>[145,"\xC7"],"\x95"=>[147,"\xC7"],"\x96"=>[149,"\xC7"],"\x97"=>[101,"\xC7"],"\x98"=>[112,"\xC7"],"\x99"=>[117,"\xC7"],"\x9A"=>[120,"\xC7"],"\x9B"=>[124,"\xC7"],"\x9C"=>[127,"\xC7"],"\x9D"=>[144,"\xC7"],"\x9E"=>[152,"\xC7"],"\x9F"=>[11,"\xC7"],"\xA0"=>[0,"\xCF0"],"\xA1"=>[0,"\xCF1"],"\xA2"=>[0,"\xCF2"],"\xA3"=>[0,"\xCFa"],"\xA4"=>[0,"\xCFc"],"\xA5"=>[0,"\xCFe"],"\xA6"=>[0,"\xCFi"],"\xA7"=>[0,"\xCFo"],"\xA8"=>[0,"\xCFs"],"\xA9"=>[0,"\xCFt"],"\xAA"=>[73,"\xCF"],"\xAB"=>[88,"\xCF"],"\xAC"=>[89,"\xCF"],"\xAD"=>[96,"\xCF"],"\xAE"=>[97,"\xCF"],"\xAF"=>[99,"\xCF"],"\xB0"=>[106,"\xCF"],"\xB1"=>[136,"\xCF"],"\xB2"=>[139,"\xCF"],"\xB3"=>[141,"\xCF"],"\xB4"=>[145,"\xCF"],"\xB5"=>[147,"\xCF"],"\xB6"=>[149,"\xCF"],"\xB7"=>[101,"\xCF"],"\xB8"=>[112,"\xCF"],"\xB9"=>[117,"\xCF"],"\xBA"=>[120,"\xCF"],"\xBB"=>[124,"\xCF"],"\xBC"=>[127,"\xCF"],"\xBD"=>[144,"\xCF"],"\xBE"=>[152,"\xCF"],"\xBF"=>[11,"\xCF"],"\xC0"=>[0,"\xEA0"],"\xC1"=>[0,"\xEA1"],"\xC2"=>[0,"\xEA2"],"\xC3"=>[0,"\xEAa"],"\xC4"=>[0,"\xEAc"],"\xC5"=>[0,"\xEAe"],"\xC6"=>[0,"\xEAi"],"\xC7"=>[0,"\xEAo"],"\xC8"=>[0,"\xEAs"],"\xC9"=>[0,"\xEAt"],"\xCA"=>[73,"\xEA"],"\xCB"=>[88,"\xEA"],"\xCC"=>[89,"\xEA"],"\xCD"=>[96,"\xEA"],"\xCE"=>[97,"\xEA"],"\xCF"=>[99,"\xEA"],"\xD0"=>[106,"\xEA"],"\xD1"=>[136,"\xEA"],"\xD2"=>[139,"\xEA"],"\xD3"=>[141,"\xEA"],"\xD4"=>[145,"\xEA"],"\xD5"=>[147,"\xEA"],"\xD6"=>[149,"\xEA"],"\xD7"=>[101,"\xEA"],"\xD8"=>[112,"\xEA"],"\xD9"=>[117,"\xEA"],"\xDA"=>[120,"\xEA"],"\xDB"=>[124,"\xEA"],"\xDC"=>[127,"\xEA"],"\xDD"=>[144,"\xEA"],"\xDE"=>[152,"\xEA"],"\xDF"=>[11,"\xEA"],"\xE0"=>[0,"\xEB0"],"\xE1"=>[0,"\xEB1"],"\xE2"=>[0,"\xEB2"],"\xE3"=>[0,"\xEBa"],"\xE4"=>[0,"\xEBc"],"\xE5"=>[0,"\xEBe"],"\xE6"=>[0,"\xEBi"],"\xE7"=>[0,"\xEBo"],"\xE8"=>[0,"\xEBs"],"\xE9"=>[0,"\xEBt"],"\xEA"=>[73,"\xEB"],"\xEB"=>[88,"\xEB"],"\xEC"=>[89,"\xEB"],"\xED"=>[96,"\xEB"],"\xEE"=>[97,"\xEB"],"\xEF"=>[99,"\xEB"],"\xF0"=>[106,"\xEB"],"\xF1"=>[136,"\xEB"],"\xF2"=>[139,"\xEB"],"\xF3"=>[141,"\xEB"],"\xF4"=>[145,"\xEB"],"\xF5"=>[147,"\xEB"],"\xF6"=>[149,"\xEB"],"\xF7"=>[101,"\xEB"],"\xF8"=>[112,"\xEB"],"\xF9"=>[117,"\xEB"],"\xFA"=>[120,"\xEB"],"\xFB"=>[124,"\xEB"],"\xFC"=>[127,"\xEB"],"\xFD"=>[144,"\xEB"],"\xFE"=>[152,"\xEB"],"\xFF"=>[11,"\xEB"],],["\x00"=>[94,"\xC80"],"\x01"=>[76,"\xC80"],"\x02"=>[104,"\xC80"],"\x03"=>[16,"\xC80"],"\x04"=>[94,"\xC81"],"\x05"=>[76,"\xC81"],"\x06"=>[104,"\xC81"],"\x07"=>[16,"\xC81"],"\x08"=>[94,"\xC82"],"\x09"=>[76,"\xC82"],"\x0A"=>[104,"\xC82"],"\x0B"=>[16,"\xC82"],"\x0C"=>[94,"\xC8a"],"\x0D"=>[76,"\xC8a"],"\x0E"=>[104,"\xC8a"],"\x0F"=>[16,"\xC8a"],"\x10"=>[94,"\xC8c"],"\x11"=>[76,"\xC8c"],"\x12"=>[104,"\xC8c"],"\x13"=>[16,"\xC8c"],"\x14"=>[94,"\xC8e"],"\x15"=>[76,"\xC8e"],"\x16"=>[104,"\xC8e"],"\x17"=>[16,"\xC8e"],"\x18"=>[94,"\xC8i"],"\x19"=>[76,"\xC8i"],"\x1A"=>[104,"\xC8i"],"\x1B"=>[16,"\xC8i"],"\x1C"=>[94,"\xC8o"],"\x1D"=>[76,"\xC8o"],"\x1E"=>[104,"\xC8o"],"\x1F"=>[16,"\xC8o"],"\x20"=>[94,"\xC8s"],"\x21"=>[76,"\xC8s"],"\x22"=>[104,"\xC8s"],"\x23"=>[16,"\xC8s"],"\x24"=>[94,"\xC8t"],"\x25"=>[76,"\xC8t"],"\x26"=>[104,"\xC8t"],"\x27"=>[16,"\xC8t"],"\x28"=>[77,"\xC8\x20"],"\x29"=>[18,"\xC8\x20"],"\x2A"=>[77,"\xC8\x25"],"\x2B"=>[18,"\xC8\x25"],"\x2C"=>[77,"\xC8-"],"-"=>[18,"\xC8-"],"."=>[77,"\xC8."],"\x2F"=>[18,"\xC8."],[77,"\xC8\x2F"],[18,"\xC8\x2F"],[77,"\xC83"],[18,"\xC83"],[77,"\xC84"],[18,"\xC84"],[77,"\xC85"],[18,"\xC85"],[77,"\xC86"],[18,"\xC86"],"\x3A"=>[77,"\xC87"],"\x3B"=>[18,"\xC87"],"\x3C"=>[77,"\xC88"],"\x3D"=>[18,"\xC88"],"\x3E"=>[77,"\xC89"],"\x3F"=>[18,"\xC89"],"\x40"=>[77,"\xC8\x3D"],"A"=>[18,"\xC8\x3D"],"B"=>[77,"\xC8A"],"C"=>[18,"\xC8A"],"D"=>[77,"\xC8_"],"E"=>[18,"\xC8_"],"F"=>[77,"\xC8b"],"G"=>[18,"\xC8b"],"H"=>[77,"\xC8d"],"I"=>[18,"\xC8d"],"J"=>[77,"\xC8f"],"K"=>[18,"\xC8f"],"L"=>[77,"\xC8g"],"M"=>[18,"\xC8g"],"N"=>[77,"\xC8h"],"O"=>[18,"\xC8h"],"P"=>[77,"\xC8l"],"Q"=>[18,"\xC8l"],"R"=>[77,"\xC8m"],"S"=>[18,"\xC8m"],"T"=>[77,"\xC8n"],"U"=>[18,"\xC8n"],"V"=>[77,"\xC8p"],"W"=>[18,"\xC8p"],"X"=>[77,"\xC8r"],"Y"=>[18,"\xC8r"],"Z"=>[77,"\xC8u"],"\x5B"=>[18,"\xC8u"],"\x5C"=>[0,"\xC8\x3A"],"\x5D"=>[0,"\xC8B"],"\x5E"=>[0,"\xC8C"],"_"=>[0,"\xC8D"],"\x60"=>[0,"\xC8E"],"a"=>[0,"\xC8F"],"b"=>[0,"\xC8G"],"c"=>[0,"\xC8H"],"d"=>[0,"\xC8I"],"e"=>[0,"\xC8J"],"f"=>[0,"\xC8K"],"g"=>[0,"\xC8L"],"h"=>[0,"\xC8M"],"i"=>[0,"\xC8N"],"j"=>[0,"\xC8O"],"k"=>[0,"\xC8P"],"l"=>[0,"\xC8Q"],"m"=>[0,"\xC8R"],"n"=>[0,"\xC8S"],"o"=>[0,"\xC8T"],"p"=>[0,"\xC8U"],"q"=>[0,"\xC8V"],"r"=>[0,"\xC8W"],"s"=>[0,"\xC8Y"],"t"=>[0,"\xC8j"],"u"=>[0,"\xC8k"],"v"=>[0,"\xC8q"],"w"=>[0,"\xC8v"],"x"=>[0,"\xC8w"],"y"=>[0,"\xC8x"],"z"=>[0,"\xC8y"],"\x7B"=>[0,"\xC8z"],"\x7C"=>[82,"\xC8"],"\x7D"=>[87,"\xC8"],"~"=>[130,"\xC8"],"\x7F"=>[9,"\xC8"],"\x80"=>[94,"\xC90"],"\x81"=>[76,"\xC90"],"\x82"=>[104,"\xC90"],"\x83"=>[16,"\xC90"],"\x84"=>[94,"\xC91"],"\x85"=>[76,"\xC91"],"\x86"=>[104,"\xC91"],"\x87"=>[16,"\xC91"],"\x88"=>[94,"\xC92"],"\x89"=>[76,"\xC92"],"\x8A"=>[104,"\xC92"],"\x8B"=>[16,"\xC92"],"\x8C"=>[94,"\xC9a"],"\x8D"=>[76,"\xC9a"],"\x8E"=>[104,"\xC9a"],"\x8F"=>[16,"\xC9a"],"\x90"=>[94,"\xC9c"],"\x91"=>[76,"\xC9c"],"\x92"=>[104,"\xC9c"],"\x93"=>[16,"\xC9c"],"\x94"=>[94,"\xC9e"],"\x95"=>[76,"\xC9e"],"\x96"=>[104,"\xC9e"],"\x97"=>[16,"\xC9e"],"\x98"=>[94,"\xC9i"],"\x99"=>[76,"\xC9i"],"\x9A"=>[104,"\xC9i"],"\x9B"=>[16,"\xC9i"],"\x9C"=>[94,"\xC9o"],"\x9D"=>[76,"\xC9o"],"\x9E"=>[104,"\xC9o"],"\x9F"=>[16,"\xC9o"],"\xA0"=>[94,"\xC9s"],"\xA1"=>[76,"\xC9s"],"\xA2"=>[104,"\xC9s"],"\xA3"=>[16,"\xC9s"],"\xA4"=>[94,"\xC9t"],"\xA5"=>[76,"\xC9t"],"\xA6"=>[104,"\xC9t"],"\xA7"=>[16,"\xC9t"],"\xA8"=>[77,"\xC9\x20"],"\xA9"=>[18,"\xC9\x20"],"\xAA"=>[77,"\xC9\x25"],"\xAB"=>[18,"\xC9\x25"],"\xAC"=>[77,"\xC9-"],"\xAD"=>[18,"\xC9-"],"\xAE"=>[77,"\xC9."],"\xAF"=>[18,"\xC9."],"\xB0"=>[77,"\xC9\x2F"],"\xB1"=>[18,"\xC9\x2F"],"\xB2"=>[77,"\xC93"],"\xB3"=>[18,"\xC93"],"\xB4"=>[77,"\xC94"],"\xB5"=>[18,"\xC94"],"\xB6"=>[77,"\xC95"],"\xB7"=>[18,"\xC95"],"\xB8"=>[77,"\xC96"],"\xB9"=>[18,"\xC96"],"\xBA"=>[77,"\xC97"],"\xBB"=>[18,"\xC97"],"\xBC"=>[77,"\xC98"],"\xBD"=>[18,"\xC98"],"\xBE"=>[77,"\xC99"],"\xBF"=>[18,"\xC99"],"\xC0"=>[77,"\xC9\x3D"],"\xC1"=>[18,"\xC9\x3D"],"\xC2"=>[77,"\xC9A"],"\xC3"=>[18,"\xC9A"],"\xC4"=>[77,"\xC9_"],"\xC5"=>[18,"\xC9_"],"\xC6"=>[77,"\xC9b"],"\xC7"=>[18,"\xC9b"],"\xC8"=>[77,"\xC9d"],"\xC9"=>[18,"\xC9d"],"\xCA"=>[77,"\xC9f"],"\xCB"=>[18,"\xC9f"],"\xCC"=>[77,"\xC9g"],"\xCD"=>[18,"\xC9g"],"\xCE"=>[77,"\xC9h"],"\xCF"=>[18,"\xC9h"],"\xD0"=>[77,"\xC9l"],"\xD1"=>[18,"\xC9l"],"\xD2"=>[77,"\xC9m"],"\xD3"=>[18,"\xC9m"],"\xD4"=>[77,"\xC9n"],"\xD5"=>[18,"\xC9n"],"\xD6"=>[77,"\xC9p"],"\xD7"=>[18,"\xC9p"],"\xD8"=>[77,"\xC9r"],"\xD9"=>[18,"\xC9r"],"\xDA"=>[77,"\xC9u"],"\xDB"=>[18,"\xC9u"],"\xDC"=>[0,"\xC9\x3A"],"\xDD"=>[0,"\xC9B"],"\xDE"=>[0,"\xC9C"],"\xDF"=>[0,"\xC9D"],"\xE0"=>[0,"\xC9E"],"\xE1"=>[0,"\xC9F"],"\xE2"=>[0,"\xC9G"],"\xE3"=>[0,"\xC9H"],"\xE4"=>[0,"\xC9I"],"\xE5"=>[0,"\xC9J"],"\xE6"=>[0,"\xC9K"],"\xE7"=>[0,"\xC9L"],"\xE8"=>[0,"\xC9M"],"\xE9"=>[0,"\xC9N"],"\xEA"=>[0,"\xC9O"],"\xEB"=>[0,"\xC9P"],"\xEC"=>[0,"\xC9Q"],"\xED"=>[0,"\xC9R"],"\xEE"=>[0,"\xC9S"],"\xEF"=>[0,"\xC9T"],"\xF0"=>[0,"\xC9U"],"\xF1"=>[0,"\xC9V"],"\xF2"=>[0,"\xC9W"],"\xF3"=>[0,"\xC9Y"],"\xF4"=>[0,"\xC9j"],"\xF5"=>[0,"\xC9k"],"\xF6"=>[0,"\xC9q"],"\xF7"=>[0,"\xC9v"],"\xF8"=>[0,"\xC9w"],"\xF9"=>[0,"\xC9x"],"\xFA"=>[0,"\xC9y"],"\xFB"=>[0,"\xC9z"],"\xFC"=>[82,"\xC9"],"\xFD"=>[87,"\xC9"],"\xFE"=>[130,"\xC9"],"\xFF"=>[9,"\xC9"],],["\x00"=>[77,"\xCA0"],"\x01"=>[18,"\xCA0"],"\x02"=>[77,"\xCA1"],"\x03"=>[18,"\xCA1"],"\x04"=>[77,"\xCA2"],"\x05"=>[18,"\xCA2"],"\x06"=>[77,"\xCAa"],"\x07"=>[18,"\xCAa"],"\x08"=>[77,"\xCAc"],"\x09"=>[18,"\xCAc"],"\x0A"=>[77,"\xCAe"],"\x0B"=>[18,"\xCAe"],"\x0C"=>[77,"\xCAi"],"\x0D"=>[18,"\xCAi"],"\x0E"=>[77,"\xCAo"],"\x0F"=>[18,"\xCAo"],"\x10"=>[77,"\xCAs"],"\x11"=>[18,"\xCAs"],"\x12"=>[77,"\xCAt"],"\x13"=>[18,"\xCAt"],"\x14"=>[0,"\xCA\x20"],"\x15"=>[0,"\xCA\x25"],"\x16"=>[0,"\xCA-"],"\x17"=>[0,"\xCA."],"\x18"=>[0,"\xCA\x2F"],"\x19"=>[0,"\xCA3"],"\x1A"=>[0,"\xCA4"],"\x1B"=>[0,"\xCA5"],"\x1C"=>[0,"\xCA6"],"\x1D"=>[0,"\xCA7"],"\x1E"=>[0,"\xCA8"],"\x1F"=>[0,"\xCA9"],"\x20"=>[0,"\xCA\x3D"],"\x21"=>[0,"\xCAA"],"\x22"=>[0,"\xCA_"],"\x23"=>[0,"\xCAb"],"\x24"=>[0,"\xCAd"],"\x25"=>[0,"\xCAf"],"\x26"=>[0,"\xCAg"],"\x27"=>[0,"\xCAh"],"\x28"=>[0,"\xCAl"],"\x29"=>[0,"\xCAm"],"\x2A"=>[0,"\xCAn"],"\x2B"=>[0,"\xCAp"],"\x2C"=>[0,"\xCAr"],"-"=>[0,"\xCAu"],"."=>[100,"\xCA"],"\x2F"=>[110,"\xCA"],[111,"\xCA"],[115,"\xCA"],[116,"\xCA"],[118,"\xCA"],[119,"\xCA"],[122,"\xCA"],[123,"\xCA"],[125,"\xCA"],[126,"\xCA"],[129,"\xCA"],"\x3A"=>[143,"\xCA"],"\x3B"=>[148,"\xCA"],"\x3C"=>[151,"\xCA"],"\x3D"=>[153,"\xCA"],"\x3E"=>[83,"\xCA"],"\x3F"=>[10,"\xCA"],"\x40"=>[77,"\xCD0"],"A"=>[18,"\xCD0"],"B"=>[77,"\xCD1"],"C"=>[18,"\xCD1"],"D"=>[77,"\xCD2"],"E"=>[18,"\xCD2"],"F"=>[77,"\xCDa"],"G"=>[18,"\xCDa"],"H"=>[77,"\xCDc"],"I"=>[18,"\xCDc"],"J"=>[77,"\xCDe"],"K"=>[18,"\xCDe"],"L"=>[77,"\xCDi"],"M"=>[18,"\xCDi"],"N"=>[77,"\xCDo"],"O"=>[18,"\xCDo"],"P"=>[77,"\xCDs"],"Q"=>[18,"\xCDs"],"R"=>[77,"\xCDt"],"S"=>[18,"\xCDt"],"T"=>[0,"\xCD\x20"],"U"=>[0,"\xCD\x25"],"V"=>[0,"\xCD-"],"W"=>[0,"\xCD."],"X"=>[0,"\xCD\x2F"],"Y"=>[0,"\xCD3"],"Z"=>[0,"\xCD4"],"\x5B"=>[0,"\xCD5"],"\x5C"=>[0,"\xCD6"],"\x5D"=>[0,"\xCD7"],"\x5E"=>[0,"\xCD8"],"_"=>[0,"\xCD9"],"\x60"=>[0,"\xCD\x3D"],"a"=>[0,"\xCDA"],"b"=>[0,"\xCD_"],"c"=>[0,"\xCDb"],"d"=>[0,"\xCDd"],"e"=>[0,"\xCDf"],"f"=>[0,"\xCDg"],"g"=>[0,"\xCDh"],"h"=>[0,"\xCDl"],"i"=>[0,"\xCDm"],"j"=>[0,"\xCDn"],"k"=>[0,"\xCDp"],"l"=>[0,"\xCDr"],"m"=>[0,"\xCDu"],"n"=>[100,"\xCD"],"o"=>[110,"\xCD"],"p"=>[111,"\xCD"],"q"=>[115,"\xCD"],"r"=>[116,"\xCD"],"s"=>[118,"\xCD"],"t"=>[119,"\xCD"],"u"=>[122,"\xCD"],"v"=>[123,"\xCD"],"w"=>[125,"\xCD"],"x"=>[126,"\xCD"],"y"=>[129,"\xCD"],"z"=>[143,"\xCD"],"\x7B"=>[148,"\xCD"],"\x7C"=>[151,"\xCD"],"\x7D"=>[153,"\xCD"],"~"=>[83,"\xCD"],"\x7F"=>[10,"\xCD"],"\x80"=>[77,"\xD20"],"\x81"=>[18,"\xD20"],"\x82"=>[77,"\xD21"],"\x83"=>[18,"\xD21"],"\x84"=>[77,"\xD22"],"\x85"=>[18,"\xD22"],"\x86"=>[77,"\xD2a"],"\x87"=>[18,"\xD2a"],"\x88"=>[77,"\xD2c"],"\x89"=>[18,"\xD2c"],"\x8A"=>[77,"\xD2e"],"\x8B"=>[18,"\xD2e"],"\x8C"=>[77,"\xD2i"],"\x8D"=>[18,"\xD2i"],"\x8E"=>[77,"\xD2o"],"\x8F"=>[18,"\xD2o"],"\x90"=>[77,"\xD2s"],"\x91"=>[18,"\xD2s"],"\x92"=>[77,"\xD2t"],"\x93"=>[18,"\xD2t"],"\x94"=>[0,"\xD2\x20"],"\x95"=>[0,"\xD2\x25"],"\x96"=>[0,"\xD2-"],"\x97"=>[0,"\xD2."],"\x98"=>[0,"\xD2\x2F"],"\x99"=>[0,"\xD23"],"\x9A"=>[0,"\xD24"],"\x9B"=>[0,"\xD25"],"\x9C"=>[0,"\xD26"],"\x9D"=>[0,"\xD27"],"\x9E"=>[0,"\xD28"],"\x9F"=>[0,"\xD29"],"\xA0"=>[0,"\xD2\x3D"],"\xA1"=>[0,"\xD2A"],"\xA2"=>[0,"\xD2_"],"\xA3"=>[0,"\xD2b"],"\xA4"=>[0,"\xD2d"],"\xA5"=>[0,"\xD2f"],"\xA6"=>[0,"\xD2g"],"\xA7"=>[0,"\xD2h"],"\xA8"=>[0,"\xD2l"],"\xA9"=>[0,"\xD2m"],"\xAA"=>[0,"\xD2n"],"\xAB"=>[0,"\xD2p"],"\xAC"=>[0,"\xD2r"],"\xAD"=>[0,"\xD2u"],"\xAE"=>[100,"\xD2"],"\xAF"=>[110,"\xD2"],"\xB0"=>[111,"\xD2"],"\xB1"=>[115,"\xD2"],"\xB2"=>[116,"\xD2"],"\xB3"=>[118,"\xD2"],"\xB4"=>[119,"\xD2"],"\xB5"=>[122,"\xD2"],"\xB6"=>[123,"\xD2"],"\xB7"=>[125,"\xD2"],"\xB8"=>[126,"\xD2"],"\xB9"=>[129,"\xD2"],"\xBA"=>[143,"\xD2"],"\xBB"=>[148,"\xD2"],"\xBC"=>[151,"\xD2"],"\xBD"=>[153,"\xD2"],"\xBE"=>[83,"\xD2"],"\xBF"=>[10,"\xD2"],"\xC0"=>[77,"\xD50"],"\xC1"=>[18,"\xD50"],"\xC2"=>[77,"\xD51"],"\xC3"=>[18,"\xD51"],"\xC4"=>[77,"\xD52"],"\xC5"=>[18,"\xD52"],"\xC6"=>[77,"\xD5a"],"\xC7"=>[18,"\xD5a"],"\xC8"=>[77,"\xD5c"],"\xC9"=>[18,"\xD5c"],"\xCA"=>[77,"\xD5e"],"\xCB"=>[18,"\xD5e"],"\xCC"=>[77,"\xD5i"],"\xCD"=>[18,"\xD5i"],"\xCE"=>[77,"\xD5o"],"\xCF"=>[18,"\xD5o"],"\xD0"=>[77,"\xD5s"],"\xD1"=>[18,"\xD5s"],"\xD2"=>[77,"\xD5t"],"\xD3"=>[18,"\xD5t"],"\xD4"=>[0,"\xD5\x20"],"\xD5"=>[0,"\xD5\x25"],"\xD6"=>[0,"\xD5-"],"\xD7"=>[0,"\xD5."],"\xD8"=>[0,"\xD5\x2F"],"\xD9"=>[0,"\xD53"],"\xDA"=>[0,"\xD54"],"\xDB"=>[0,"\xD55"],"\xDC"=>[0,"\xD56"],"\xDD"=>[0,"\xD57"],"\xDE"=>[0,"\xD58"],"\xDF"=>[0,"\xD59"],"\xE0"=>[0,"\xD5\x3D"],"\xE1"=>[0,"\xD5A"],"\xE2"=>[0,"\xD5_"],"\xE3"=>[0,"\xD5b"],"\xE4"=>[0,"\xD5d"],"\xE5"=>[0,"\xD5f"],"\xE6"=>[0,"\xD5g"],"\xE7"=>[0,"\xD5h"],"\xE8"=>[0,"\xD5l"],"\xE9"=>[0,"\xD5m"],"\xEA"=>[0,"\xD5n"],"\xEB"=>[0,"\xD5p"],"\xEC"=>[0,"\xD5r"],"\xED"=>[0,"\xD5u"],"\xEE"=>[100,"\xD5"],"\xEF"=>[110,"\xD5"],"\xF0"=>[111,"\xD5"],"\xF1"=>[115,"\xD5"],"\xF2"=>[116,"\xD5"],"\xF3"=>[118,"\xD5"],"\xF4"=>[119,"\xD5"],"\xF5"=>[122,"\xD5"],"\xF6"=>[123,"\xD5"],"\xF7"=>[125,"\xD5"],"\xF8"=>[126,"\xD5"],"\xF9"=>[129,"\xD5"],"\xFA"=>[143,"\xD5"],"\xFB"=>[148,"\xD5"],"\xFC"=>[151,"\xD5"],"\xFD"=>[153,"\xD5"],"\xFE"=>[83,"\xD5"],"\xFF"=>[10,"\xD5"],],["\x00"=>[94,"\xCA0"],"\x01"=>[76,"\xCA0"],"\x02"=>[104,"\xCA0"],"\x03"=>[16,"\xCA0"],"\x04"=>[94,"\xCA1"],"\x05"=>[76,"\xCA1"],"\x06"=>[104,"\xCA1"],"\x07"=>[16,"\xCA1"],"\x08"=>[94,"\xCA2"],"\x09"=>[76,"\xCA2"],"\x0A"=>[104,"\xCA2"],"\x0B"=>[16,"\xCA2"],"\x0C"=>[94,"\xCAa"],"\x0D"=>[76,"\xCAa"],"\x0E"=>[104,"\xCAa"],"\x0F"=>[16,"\xCAa"],"\x10"=>[94,"\xCAc"],"\x11"=>[76,"\xCAc"],"\x12"=>[104,"\xCAc"],"\x13"=>[16,"\xCAc"],"\x14"=>[94,"\xCAe"],"\x15"=>[76,"\xCAe"],"\x16"=>[104,"\xCAe"],"\x17"=>[16,"\xCAe"],"\x18"=>[94,"\xCAi"],"\x19"=>[76,"\xCAi"],"\x1A"=>[104,"\xCAi"],"\x1B"=>[16,"\xCAi"],"\x1C"=>[94,"\xCAo"],"\x1D"=>[76,"\xCAo"],"\x1E"=>[104,"\xCAo"],"\x1F"=>[16,"\xCAo"],"\x20"=>[94,"\xCAs"],"\x21"=>[76,"\xCAs"],"\x22"=>[104,"\xCAs"],"\x23"=>[16,"\xCAs"],"\x24"=>[94,"\xCAt"],"\x25"=>[76,"\xCAt"],"\x26"=>[104,"\xCAt"],"\x27"=>[16,"\xCAt"],"\x28"=>[77,"\xCA\x20"],"\x29"=>[18,"\xCA\x20"],"\x2A"=>[77,"\xCA\x25"],"\x2B"=>[18,"\xCA\x25"],"\x2C"=>[77,"\xCA-"],"-"=>[18,"\xCA-"],"."=>[77,"\xCA."],"\x2F"=>[18,"\xCA."],[77,"\xCA\x2F"],[18,"\xCA\x2F"],[77,"\xCA3"],[18,"\xCA3"],[77,"\xCA4"],[18,"\xCA4"],[77,"\xCA5"],[18,"\xCA5"],[77,"\xCA6"],[18,"\xCA6"],"\x3A"=>[77,"\xCA7"],"\x3B"=>[18,"\xCA7"],"\x3C"=>[77,"\xCA8"],"\x3D"=>[18,"\xCA8"],"\x3E"=>[77,"\xCA9"],"\x3F"=>[18,"\xCA9"],"\x40"=>[77,"\xCA\x3D"],"A"=>[18,"\xCA\x3D"],"B"=>[77,"\xCAA"],"C"=>[18,"\xCAA"],"D"=>[77,"\xCA_"],"E"=>[18,"\xCA_"],"F"=>[77,"\xCAb"],"G"=>[18,"\xCAb"],"H"=>[77,"\xCAd"],"I"=>[18,"\xCAd"],"J"=>[77,"\xCAf"],"K"=>[18,"\xCAf"],"L"=>[77,"\xCAg"],"M"=>[18,"\xCAg"],"N"=>[77,"\xCAh"],"O"=>[18,"\xCAh"],"P"=>[77,"\xCAl"],"Q"=>[18,"\xCAl"],"R"=>[77,"\xCAm"],"S"=>[18,"\xCAm"],"T"=>[77,"\xCAn"],"U"=>[18,"\xCAn"],"V"=>[77,"\xCAp"],"W"=>[18,"\xCAp"],"X"=>[77,"\xCAr"],"Y"=>[18,"\xCAr"],"Z"=>[77,"\xCAu"],"\x5B"=>[18,"\xCAu"],"\x5C"=>[0,"\xCA\x3A"],"\x5D"=>[0,"\xCAB"],"\x5E"=>[0,"\xCAC"],"_"=>[0,"\xCAD"],"\x60"=>[0,"\xCAE"],"a"=>[0,"\xCAF"],"b"=>[0,"\xCAG"],"c"=>[0,"\xCAH"],"d"=>[0,"\xCAI"],"e"=>[0,"\xCAJ"],"f"=>[0,"\xCAK"],"g"=>[0,"\xCAL"],"h"=>[0,"\xCAM"],"i"=>[0,"\xCAN"],"j"=>[0,"\xCAO"],"k"=>[0,"\xCAP"],"l"=>[0,"\xCAQ"],"m"=>[0,"\xCAR"],"n"=>[0,"\xCAS"],"o"=>[0,"\xCAT"],"p"=>[0,"\xCAU"],"q"=>[0,"\xCAV"],"r"=>[0,"\xCAW"],"s"=>[0,"\xCAY"],"t"=>[0,"\xCAj"],"u"=>[0,"\xCAk"],"v"=>[0,"\xCAq"],"w"=>[0,"\xCAv"],"x"=>[0,"\xCAw"],"y"=>[0,"\xCAx"],"z"=>[0,"\xCAy"],"\x7B"=>[0,"\xCAz"],"\x7C"=>[82,"\xCA"],"\x7D"=>[87,"\xCA"],"~"=>[130,"\xCA"],"\x7F"=>[9,"\xCA"],"\x80"=>[94,"\xCD0"],"\x81"=>[76,"\xCD0"],"\x82"=>[104,"\xCD0"],"\x83"=>[16,"\xCD0"],"\x84"=>[94,"\xCD1"],"\x85"=>[76,"\xCD1"],"\x86"=>[104,"\xCD1"],"\x87"=>[16,"\xCD1"],"\x88"=>[94,"\xCD2"],"\x89"=>[76,"\xCD2"],"\x8A"=>[104,"\xCD2"],"\x8B"=>[16,"\xCD2"],"\x8C"=>[94,"\xCDa"],"\x8D"=>[76,"\xCDa"],"\x8E"=>[104,"\xCDa"],"\x8F"=>[16,"\xCDa"],"\x90"=>[94,"\xCDc"],"\x91"=>[76,"\xCDc"],"\x92"=>[104,"\xCDc"],"\x93"=>[16,"\xCDc"],"\x94"=>[94,"\xCDe"],"\x95"=>[76,"\xCDe"],"\x96"=>[104,"\xCDe"],"\x97"=>[16,"\xCDe"],"\x98"=>[94,"\xCDi"],"\x99"=>[76,"\xCDi"],"\x9A"=>[104,"\xCDi"],"\x9B"=>[16,"\xCDi"],"\x9C"=>[94,"\xCDo"],"\x9D"=>[76,"\xCDo"],"\x9E"=>[104,"\xCDo"],"\x9F"=>[16,"\xCDo"],"\xA0"=>[94,"\xCDs"],"\xA1"=>[76,"\xCDs"],"\xA2"=>[104,"\xCDs"],"\xA3"=>[16,"\xCDs"],"\xA4"=>[94,"\xCDt"],"\xA5"=>[76,"\xCDt"],"\xA6"=>[104,"\xCDt"],"\xA7"=>[16,"\xCDt"],"\xA8"=>[77,"\xCD\x20"],"\xA9"=>[18,"\xCD\x20"],"\xAA"=>[77,"\xCD\x25"],"\xAB"=>[18,"\xCD\x25"],"\xAC"=>[77,"\xCD-"],"\xAD"=>[18,"\xCD-"],"\xAE"=>[77,"\xCD."],"\xAF"=>[18,"\xCD."],"\xB0"=>[77,"\xCD\x2F"],"\xB1"=>[18,"\xCD\x2F"],"\xB2"=>[77,"\xCD3"],"\xB3"=>[18,"\xCD3"],"\xB4"=>[77,"\xCD4"],"\xB5"=>[18,"\xCD4"],"\xB6"=>[77,"\xCD5"],"\xB7"=>[18,"\xCD5"],"\xB8"=>[77,"\xCD6"],"\xB9"=>[18,"\xCD6"],"\xBA"=>[77,"\xCD7"],"\xBB"=>[18,"\xCD7"],"\xBC"=>[77,"\xCD8"],"\xBD"=>[18,"\xCD8"],"\xBE"=>[77,"\xCD9"],"\xBF"=>[18,"\xCD9"],"\xC0"=>[77,"\xCD\x3D"],"\xC1"=>[18,"\xCD\x3D"],"\xC2"=>[77,"\xCDA"],"\xC3"=>[18,"\xCDA"],"\xC4"=>[77,"\xCD_"],"\xC5"=>[18,"\xCD_"],"\xC6"=>[77,"\xCDb"],"\xC7"=>[18,"\xCDb"],"\xC8"=>[77,"\xCDd"],"\xC9"=>[18,"\xCDd"],"\xCA"=>[77,"\xCDf"],"\xCB"=>[18,"\xCDf"],"\xCC"=>[77,"\xCDg"],"\xCD"=>[18,"\xCDg"],"\xCE"=>[77,"\xCDh"],"\xCF"=>[18,"\xCDh"],"\xD0"=>[77,"\xCDl"],"\xD1"=>[18,"\xCDl"],"\xD2"=>[77,"\xCDm"],"\xD3"=>[18,"\xCDm"],"\xD4"=>[77,"\xCDn"],"\xD5"=>[18,"\xCDn"],"\xD6"=>[77,"\xCDp"],"\xD7"=>[18,"\xCDp"],"\xD8"=>[77,"\xCDr"],"\xD9"=>[18,"\xCDr"],"\xDA"=>[77,"\xCDu"],"\xDB"=>[18,"\xCDu"],"\xDC"=>[0,"\xCD\x3A"],"\xDD"=>[0,"\xCDB"],"\xDE"=>[0,"\xCDC"],"\xDF"=>[0,"\xCDD"],"\xE0"=>[0,"\xCDE"],"\xE1"=>[0,"\xCDF"],"\xE2"=>[0,"\xCDG"],"\xE3"=>[0,"\xCDH"],"\xE4"=>[0,"\xCDI"],"\xE5"=>[0,"\xCDJ"],"\xE6"=>[0,"\xCDK"],"\xE7"=>[0,"\xCDL"],"\xE8"=>[0,"\xCDM"],"\xE9"=>[0,"\xCDN"],"\xEA"=>[0,"\xCDO"],"\xEB"=>[0,"\xCDP"],"\xEC"=>[0,"\xCDQ"],"\xED"=>[0,"\xCDR"],"\xEE"=>[0,"\xCDS"],"\xEF"=>[0,"\xCDT"],"\xF0"=>[0,"\xCDU"],"\xF1"=>[0,"\xCDV"],"\xF2"=>[0,"\xCDW"],"\xF3"=>[0,"\xCDY"],"\xF4"=>[0,"\xCDj"],"\xF5"=>[0,"\xCDk"],"\xF6"=>[0,"\xCDq"],"\xF7"=>[0,"\xCDv"],"\xF8"=>[0,"\xCDw"],"\xF9"=>[0,"\xCDx"],"\xFA"=>[0,"\xCDy"],"\xFB"=>[0,"\xCDz"],"\xFC"=>[82,"\xCD"],"\xFD"=>[87,"\xCD"],"\xFE"=>[130,"\xCD"],"\xFF"=>[9,"\xCD"],],["\x00"=>[77,"\xF20"],"\x01"=>[18,"\xF20"],"\x02"=>[77,"\xF21"],"\x03"=>[18,"\xF21"],"\x04"=>[77,"\xF22"],"\x05"=>[18,"\xF22"],"\x06"=>[77,"\xF2a"],"\x07"=>[18,"\xF2a"],"\x08"=>[77,"\xF2c"],"\x09"=>[18,"\xF2c"],"\x0A"=>[77,"\xF2e"],"\x0B"=>[18,"\xF2e"],"\x0C"=>[77,"\xF2i"],"\x0D"=>[18,"\xF2i"],"\x0E"=>[77,"\xF2o"],"\x0F"=>[18,"\xF2o"],"\x10"=>[77,"\xF2s"],"\x11"=>[18,"\xF2s"],"\x12"=>[77,"\xF2t"],"\x13"=>[18,"\xF2t"],"\x14"=>[0,"\xF2\x20"],"\x15"=>[0,"\xF2\x25"],"\x16"=>[0,"\xF2-"],"\x17"=>[0,"\xF2."],"\x18"=>[0,"\xF2\x2F"],"\x19"=>[0,"\xF23"],"\x1A"=>[0,"\xF24"],"\x1B"=>[0,"\xF25"],"\x1C"=>[0,"\xF26"],"\x1D"=>[0,"\xF27"],"\x1E"=>[0,"\xF28"],"\x1F"=>[0,"\xF29"],"\x20"=>[0,"\xF2\x3D"],"\x21"=>[0,"\xF2A"],"\x22"=>[0,"\xF2_"],"\x23"=>[0,"\xF2b"],"\x24"=>[0,"\xF2d"],"\x25"=>[0,"\xF2f"],"\x26"=>[0,"\xF2g"],"\x27"=>[0,"\xF2h"],"\x28"=>[0,"\xF2l"],"\x29"=>[0,"\xF2m"],"\x2A"=>[0,"\xF2n"],"\x2B"=>[0,"\xF2p"],"\x2C"=>[0,"\xF2r"],"-"=>[0,"\xF2u"],"."=>[100,"\xF2"],"\x2F"=>[110,"\xF2"],[111,"\xF2"],[115,"\xF2"],[116,"\xF2"],[118,"\xF2"],[119,"\xF2"],[122,"\xF2"],[123,"\xF2"],[125,"\xF2"],[126,"\xF2"],[129,"\xF2"],"\x3A"=>[143,"\xF2"],"\x3B"=>[148,"\xF2"],"\x3C"=>[151,"\xF2"],"\x3D"=>[153,"\xF2"],"\x3E"=>[83,"\xF2"],"\x3F"=>[10,"\xF2"],"\x40"=>[77,"\xF30"],"A"=>[18,"\xF30"],"B"=>[77,"\xF31"],"C"=>[18,"\xF31"],"D"=>[77,"\xF32"],"E"=>[18,"\xF32"],"F"=>[77,"\xF3a"],"G"=>[18,"\xF3a"],"H"=>[77,"\xF3c"],"I"=>[18,"\xF3c"],"J"=>[77,"\xF3e"],"K"=>[18,"\xF3e"],"L"=>[77,"\xF3i"],"M"=>[18,"\xF3i"],"N"=>[77,"\xF3o"],"O"=>[18,"\xF3o"],"P"=>[77,"\xF3s"],"Q"=>[18,"\xF3s"],"R"=>[77,"\xF3t"],"S"=>[18,"\xF3t"],"T"=>[0,"\xF3\x20"],"U"=>[0,"\xF3\x25"],"V"=>[0,"\xF3-"],"W"=>[0,"\xF3."],"X"=>[0,"\xF3\x2F"],"Y"=>[0,"\xF33"],"Z"=>[0,"\xF34"],"\x5B"=>[0,"\xF35"],"\x5C"=>[0,"\xF36"],"\x5D"=>[0,"\xF37"],"\x5E"=>[0,"\xF38"],"_"=>[0,"\xF39"],"\x60"=>[0,"\xF3\x3D"],"a"=>[0,"\xF3A"],"b"=>[0,"\xF3_"],"c"=>[0,"\xF3b"],"d"=>[0,"\xF3d"],"e"=>[0,"\xF3f"],"f"=>[0,"\xF3g"],"g"=>[0,"\xF3h"],"h"=>[0,"\xF3l"],"i"=>[0,"\xF3m"],"j"=>[0,"\xF3n"],"k"=>[0,"\xF3p"],"l"=>[0,"\xF3r"],"m"=>[0,"\xF3u"],"n"=>[100,"\xF3"],"o"=>[110,"\xF3"],"p"=>[111,"\xF3"],"q"=>[115,"\xF3"],"r"=>[116,"\xF3"],"s"=>[118,"\xF3"],"t"=>[119,"\xF3"],"u"=>[122,"\xF3"],"v"=>[123,"\xF3"],"w"=>[125,"\xF3"],"x"=>[126,"\xF3"],"y"=>[129,"\xF3"],"z"=>[143,"\xF3"],"\x7B"=>[148,"\xF3"],"\x7C"=>[151,"\xF3"],"\x7D"=>[153,"\xF3"],"~"=>[83,"\xF3"],"\x7F"=>[10,"\xF3"],"\x80"=>[77,"\xFF0"],"\x81"=>[18,"\xFF0"],"\x82"=>[77,"\xFF1"],"\x83"=>[18,"\xFF1"],"\x84"=>[77,"\xFF2"],"\x85"=>[18,"\xFF2"],"\x86"=>[77,"\xFFa"],"\x87"=>[18,"\xFFa"],"\x88"=>[77,"\xFFc"],"\x89"=>[18,"\xFFc"],"\x8A"=>[77,"\xFFe"],"\x8B"=>[18,"\xFFe"],"\x8C"=>[77,"\xFFi"],"\x8D"=>[18,"\xFFi"],"\x8E"=>[77,"\xFFo"],"\x8F"=>[18,"\xFFo"],"\x90"=>[77,"\xFFs"],"\x91"=>[18,"\xFFs"],"\x92"=>[77,"\xFFt"],"\x93"=>[18,"\xFFt"],"\x94"=>[0,"\xFF\x20"],"\x95"=>[0,"\xFF\x25"],"\x96"=>[0,"\xFF-"],"\x97"=>[0,"\xFF."],"\x98"=>[0,"\xFF\x2F"],"\x99"=>[0,"\xFF3"],"\x9A"=>[0,"\xFF4"],"\x9B"=>[0,"\xFF5"],"\x9C"=>[0,"\xFF6"],"\x9D"=>[0,"\xFF7"],"\x9E"=>[0,"\xFF8"],"\x9F"=>[0,"\xFF9"],"\xA0"=>[0,"\xFF\x3D"],"\xA1"=>[0,"\xFFA"],"\xA2"=>[0,"\xFF_"],"\xA3"=>[0,"\xFFb"],"\xA4"=>[0,"\xFFd"],"\xA5"=>[0,"\xFFf"],"\xA6"=>[0,"\xFFg"],"\xA7"=>[0,"\xFFh"],"\xA8"=>[0,"\xFFl"],"\xA9"=>[0,"\xFFm"],"\xAA"=>[0,"\xFFn"],"\xAB"=>[0,"\xFFp"],"\xAC"=>[0,"\xFFr"],"\xAD"=>[0,"\xFFu"],"\xAE"=>[100,"\xFF"],"\xAF"=>[110,"\xFF"],"\xB0"=>[111,"\xFF"],"\xB1"=>[115,"\xFF"],"\xB2"=>[116,"\xFF"],"\xB3"=>[118,"\xFF"],"\xB4"=>[119,"\xFF"],"\xB5"=>[122,"\xFF"],"\xB6"=>[123,"\xFF"],"\xB7"=>[125,"\xFF"],"\xB8"=>[126,"\xFF"],"\xB9"=>[129,"\xFF"],"\xBA"=>[143,"\xFF"],"\xBB"=>[148,"\xFF"],"\xBC"=>[151,"\xFF"],"\xBD"=>[153,"\xFF"],"\xBE"=>[83,"\xFF"],"\xBF"=>[10,"\xFF"],"\xC0"=>[0,"\xCB0"],"\xC1"=>[0,"\xCB1"],"\xC2"=>[0,"\xCB2"],"\xC3"=>[0,"\xCBa"],"\xC4"=>[0,"\xCBc"],"\xC5"=>[0,"\xCBe"],"\xC6"=>[0,"\xCBi"],"\xC7"=>[0,"\xCBo"],"\xC8"=>[0,"\xCBs"],"\xC9"=>[0,"\xCBt"],"\xCA"=>[73,"\xCB"],"\xCB"=>[88,"\xCB"],"\xCC"=>[89,"\xCB"],"\xCD"=>[96,"\xCB"],"\xCE"=>[97,"\xCB"],"\xCF"=>[99,"\xCB"],"\xD0"=>[106,"\xCB"],"\xD1"=>[136,"\xCB"],"\xD2"=>[139,"\xCB"],"\xD3"=>[141,"\xCB"],"\xD4"=>[145,"\xCB"],"\xD5"=>[147,"\xCB"],"\xD6"=>[149,"\xCB"],"\xD7"=>[101,"\xCB"],"\xD8"=>[112,"\xCB"],"\xD9"=>[117,"\xCB"],"\xDA"=>[120,"\xCB"],"\xDB"=>[124,"\xCB"],"\xDC"=>[127,"\xCB"],"\xDD"=>[144,"\xCB"],"\xDE"=>[152,"\xCB"],"\xDF"=>[11,"\xCB"],"\xE0"=>[0,"\xCC0"],"\xE1"=>[0,"\xCC1"],"\xE2"=>[0,"\xCC2"],"\xE3"=>[0,"\xCCa"],"\xE4"=>[0,"\xCCc"],"\xE5"=>[0,"\xCCe"],"\xE6"=>[0,"\xCCi"],"\xE7"=>[0,"\xCCo"],"\xE8"=>[0,"\xCCs"],"\xE9"=>[0,"\xCCt"],"\xEA"=>[73,"\xCC"],"\xEB"=>[88,"\xCC"],"\xEC"=>[89,"\xCC"],"\xED"=>[96,"\xCC"],"\xEE"=>[97,"\xCC"],"\xEF"=>[99,"\xCC"],"\xF0"=>[106,"\xCC"],"\xF1"=>[136,"\xCC"],"\xF2"=>[139,"\xCC"],"\xF3"=>[141,"\xCC"],"\xF4"=>[145,"\xCC"],"\xF5"=>[147,"\xCC"],"\xF6"=>[149,"\xCC"],"\xF7"=>[101,"\xCC"],"\xF8"=>[112,"\xCC"],"\xF9"=>[117,"\xCC"],"\xFA"=>[120,"\xCC"],"\xFB"=>[124,"\xCC"],"\xFC"=>[127,"\xCC"],"\xFD"=>[144,"\xCC"],"\xFE"=>[152,"\xCC"],"\xFF"=>[11,"\xCC"],],["\x00"=>[0,"\xDA0"],"\x01"=>[0,"\xDA1"],"\x02"=>[0,"\xDA2"],"\x03"=>[0,"\xDAa"],"\x04"=>[0,"\xDAc"],"\x05"=>[0,"\xDAe"],"\x06"=>[0,"\xDAi"],"\x07"=>[0,"\xDAo"],"\x08"=>[0,"\xDAs"],"\x09"=>[0,"\xDAt"],"\x0A"=>[73,"\xDA"],"\x0B"=>[88,"\xDA"],"\x0C"=>[89,"\xDA"],"\x0D"=>[96,"\xDA"],"\x0E"=>[97,"\xDA"],"\x0F"=>[99,"\xDA"],"\x10"=>[106,"\xDA"],"\x11"=>[136,"\xDA"],"\x12"=>[139,"\xDA"],"\x13"=>[141,"\xDA"],"\x14"=>[145,"\xDA"],"\x15"=>[147,"\xDA"],"\x16"=>[149,"\xDA"],"\x17"=>[101,"\xDA"],"\x18"=>[112,"\xDA"],"\x19"=>[117,"\xDA"],"\x1A"=>[120,"\xDA"],"\x1B"=>[124,"\xDA"],"\x1C"=>[127,"\xDA"],"\x1D"=>[144,"\xDA"],"\x1E"=>[152,"\xDA"],"\x1F"=>[11,"\xDA"],"\x20"=>[0,"\xDB0"],"\x21"=>[0,"\xDB1"],"\x22"=>[0,"\xDB2"],"\x23"=>[0,"\xDBa"],"\x24"=>[0,"\xDBc"],"\x25"=>[0,"\xDBe"],"\x26"=>[0,"\xDBi"],"\x27"=>[0,"\xDBo"],"\x28"=>[0,"\xDBs"],"\x29"=>[0,"\xDBt"],"\x2A"=>[73,"\xDB"],"\x2B"=>[88,"\xDB"],"\x2C"=>[89,"\xDB"],"-"=>[96,"\xDB"],"."=>[97,"\xDB"],"\x2F"=>[99,"\xDB"],[106,"\xDB"],[136,"\xDB"],[139,"\xDB"],[141,"\xDB"],[145,"\xDB"],[147,"\xDB"],[149,"\xDB"],[101,"\xDB"],[112,"\xDB"],[117,"\xDB"],"\x3A"=>[120,"\xDB"],"\x3B"=>[124,"\xDB"],"\x3C"=>[127,"\xDB"],"\x3D"=>[144,"\xDB"],"\x3E"=>[152,"\xDB"],"\x3F"=>[11,"\xDB"],"\x40"=>[0,"\xEE0"],"A"=>[0,"\xEE1"],"B"=>[0,"\xEE2"],"C"=>[0,"\xEEa"],"D"=>[0,"\xEEc"],"E"=>[0,"\xEEe"],"F"=>[0,"\xEEi"],"G"=>[0,"\xEEo"],"H"=>[0,"\xEEs"],"I"=>[0,"\xEEt"],"J"=>[73,"\xEE"],"K"=>[88,"\xEE"],"L"=>[89,"\xEE"],"M"=>[96,"\xEE"],"N"=>[97,"\xEE"],"O"=>[99,"\xEE"],"P"=>[106,"\xEE"],"Q"=>[136,"\xEE"],"R"=>[139,"\xEE"],"S"=>[141,"\xEE"],"T"=>[145,"\xEE"],"U"=>[147,"\xEE"],"V"=>[149,"\xEE"],"W"=>[101,"\xEE"],"X"=>[112,"\xEE"],"Y"=>[117,"\xEE"],"Z"=>[120,"\xEE"],"\x5B"=>[124,"\xEE"],"\x5C"=>[127,"\xEE"],"\x5D"=>[144,"\xEE"],"\x5E"=>[152,"\xEE"],"_"=>[11,"\xEE"],"\x60"=>[0,"\xF00"],"a"=>[0,"\xF01"],"b"=>[0,"\xF02"],"c"=>[0,"\xF0a"],"d"=>[0,"\xF0c"],"e"=>[0,"\xF0e"],"f"=>[0,"\xF0i"],"g"=>[0,"\xF0o"],"h"=>[0,"\xF0s"],"i"=>[0,"\xF0t"],"j"=>[73,"\xF0"],"k"=>[88,"\xF0"],"l"=>[89,"\xF0"],"m"=>[96,"\xF0"],"n"=>[97,"\xF0"],"o"=>[99,"\xF0"],"p"=>[106,"\xF0"],"q"=>[136,"\xF0"],"r"=>[139,"\xF0"],"s"=>[141,"\xF0"],"t"=>[145,"\xF0"],"u"=>[147,"\xF0"],"v"=>[149,"\xF0"],"w"=>[101,"\xF0"],"x"=>[112,"\xF0"],"y"=>[117,"\xF0"],"z"=>[120,"\xF0"],"\x7B"=>[124,"\xF0"],"\x7C"=>[127,"\xF0"],"\x7D"=>[144,"\xF0"],"~"=>[152,"\xF0"],"\x7F"=>[11,"\xF0"],"\x80"=>[0,"\xF20"],"\x81"=>[0,"\xF21"],"\x82"=>[0,"\xF22"],"\x83"=>[0,"\xF2a"],"\x84"=>[0,"\xF2c"],"\x85"=>[0,"\xF2e"],"\x86"=>[0,"\xF2i"],"\x87"=>[0,"\xF2o"],"\x88"=>[0,"\xF2s"],"\x89"=>[0,"\xF2t"],"\x8A"=>[73,"\xF2"],"\x8B"=>[88,"\xF2"],"\x8C"=>[89,"\xF2"],"\x8D"=>[96,"\xF2"],"\x8E"=>[97,"\xF2"],"\x8F"=>[99,"\xF2"],"\x90"=>[106,"\xF2"],"\x91"=>[136,"\xF2"],"\x92"=>[139,"\xF2"],"\x93"=>[141,"\xF2"],"\x94"=>[145,"\xF2"],"\x95"=>[147,"\xF2"],"\x96"=>[149,"\xF2"],"\x97"=>[101,"\xF2"],"\x98"=>[112,"\xF2"],"\x99"=>[117,"\xF2"],"\x9A"=>[120,"\xF2"],"\x9B"=>[124,"\xF2"],"\x9C"=>[127,"\xF2"],"\x9D"=>[144,"\xF2"],"\x9E"=>[152,"\xF2"],"\x9F"=>[11,"\xF2"],"\xA0"=>[0,"\xF30"],"\xA1"=>[0,"\xF31"],"\xA2"=>[0,"\xF32"],"\xA3"=>[0,"\xF3a"],"\xA4"=>[0,"\xF3c"],"\xA5"=>[0,"\xF3e"],"\xA6"=>[0,"\xF3i"],"\xA7"=>[0,"\xF3o"],"\xA8"=>[0,"\xF3s"],"\xA9"=>[0,"\xF3t"],"\xAA"=>[73,"\xF3"],"\xAB"=>[88,"\xF3"],"\xAC"=>[89,"\xF3"],"\xAD"=>[96,"\xF3"],"\xAE"=>[97,"\xF3"],"\xAF"=>[99,"\xF3"],"\xB0"=>[106,"\xF3"],"\xB1"=>[136,"\xF3"],"\xB2"=>[139,"\xF3"],"\xB3"=>[141,"\xF3"],"\xB4"=>[145,"\xF3"],"\xB5"=>[147,"\xF3"],"\xB6"=>[149,"\xF3"],"\xB7"=>[101,"\xF3"],"\xB8"=>[112,"\xF3"],"\xB9"=>[117,"\xF3"],"\xBA"=>[120,"\xF3"],"\xBB"=>[124,"\xF3"],"\xBC"=>[127,"\xF3"],"\xBD"=>[144,"\xF3"],"\xBE"=>[152,"\xF3"],"\xBF"=>[11,"\xF3"],"\xC0"=>[0,"\xFF0"],"\xC1"=>[0,"\xFF1"],"\xC2"=>[0,"\xFF2"],"\xC3"=>[0,"\xFFa"],"\xC4"=>[0,"\xFFc"],"\xC5"=>[0,"\xFFe"],"\xC6"=>[0,"\xFFi"],"\xC7"=>[0,"\xFFo"],"\xC8"=>[0,"\xFFs"],"\xC9"=>[0,"\xFFt"],"\xCA"=>[73,"\xFF"],"\xCB"=>[88,"\xFF"],"\xCC"=>[89,"\xFF"],"\xCD"=>[96,"\xFF"],"\xCE"=>[97,"\xFF"],"\xCF"=>[99,"\xFF"],"\xD0"=>[106,"\xFF"],"\xD1"=>[136,"\xFF"],"\xD2"=>[139,"\xFF"],"\xD3"=>[141,"\xFF"],"\xD4"=>[145,"\xFF"],"\xD5"=>[147,"\xFF"],"\xD6"=>[149,"\xFF"],"\xD7"=>[101,"\xFF"],"\xD8"=>[112,"\xFF"],"\xD9"=>[117,"\xFF"],"\xDA"=>[120,"\xFF"],"\xDB"=>[124,"\xFF"],"\xDC"=>[127,"\xFF"],"\xDD"=>[144,"\xFF"],"\xDE"=>[152,"\xFF"],"\xDF"=>[11,"\xFF"],"\xE0"=>[92,"\xCB"],"\xE1"=>[95,"\xCB"],"\xE2"=>[137,"\xCB"],"\xE3"=>[142,"\xCB"],"\xE4"=>[150,"\xCB"],"\xE5"=>[74,"\xCB"],"\xE6"=>[90,"\xCB"],"\xE7"=>[98,"\xCB"],"\xE8"=>[107,"\xCB"],"\xE9"=>[140,"\xCB"],"\xEA"=>[146,"\xCB"],"\xEB"=>[102,"\xCB"],"\xEC"=>[113,"\xCB"],"\xED"=>[121,"\xCB"],"\xEE"=>[128,"\xCB"],"\xEF"=>[12,"\xCB"],"\xF0"=>[92,"\xCC"],"\xF1"=>[95,"\xCC"],"\xF2"=>[137,"\xCC"],"\xF3"=>[142,"\xCC"],"\xF4"=>[150,"\xCC"],"\xF5"=>[74,"\xCC"],"\xF6"=>[90,"\xCC"],"\xF7"=>[98,"\xCC"],"\xF8"=>[107,"\xCC"],"\xF9"=>[140,"\xCC"],"\xFA"=>[146,"\xCC"],"\xFB"=>[102,"\xCC"],"\xFC"=>[113,"\xCC"],"\xFD"=>[121,"\xCC"],"\xFE"=>[128,"\xCC"],"\xFF"=>[12,"\xCC"],],["\x00"=>[94,"\xCB0"],"\x01"=>[76,"\xCB0"],"\x02"=>[104,"\xCB0"],"\x03"=>[16,"\xCB0"],"\x04"=>[94,"\xCB1"],"\x05"=>[76,"\xCB1"],"\x06"=>[104,"\xCB1"],"\x07"=>[16,"\xCB1"],"\x08"=>[94,"\xCB2"],"\x09"=>[76,"\xCB2"],"\x0A"=>[104,"\xCB2"],"\x0B"=>[16,"\xCB2"],"\x0C"=>[94,"\xCBa"],"\x0D"=>[76,"\xCBa"],"\x0E"=>[104,"\xCBa"],"\x0F"=>[16,"\xCBa"],"\x10"=>[94,"\xCBc"],"\x11"=>[76,"\xCBc"],"\x12"=>[104,"\xCBc"],"\x13"=>[16,"\xCBc"],"\x14"=>[94,"\xCBe"],"\x15"=>[76,"\xCBe"],"\x16"=>[104,"\xCBe"],"\x17"=>[16,"\xCBe"],"\x18"=>[94,"\xCBi"],"\x19"=>[76,"\xCBi"],"\x1A"=>[104,"\xCBi"],"\x1B"=>[16,"\xCBi"],"\x1C"=>[94,"\xCBo"],"\x1D"=>[76,"\xCBo"],"\x1E"=>[104,"\xCBo"],"\x1F"=>[16,"\xCBo"],"\x20"=>[94,"\xCBs"],"\x21"=>[76,"\xCBs"],"\x22"=>[104,"\xCBs"],"\x23"=>[16,"\xCBs"],"\x24"=>[94,"\xCBt"],"\x25"=>[76,"\xCBt"],"\x26"=>[104,"\xCBt"],"\x27"=>[16,"\xCBt"],"\x28"=>[77,"\xCB\x20"],"\x29"=>[18,"\xCB\x20"],"\x2A"=>[77,"\xCB\x25"],"\x2B"=>[18,"\xCB\x25"],"\x2C"=>[77,"\xCB-"],"-"=>[18,"\xCB-"],"."=>[77,"\xCB."],"\x2F"=>[18,"\xCB."],[77,"\xCB\x2F"],[18,"\xCB\x2F"],[77,"\xCB3"],[18,"\xCB3"],[77,"\xCB4"],[18,"\xCB4"],[77,"\xCB5"],[18,"\xCB5"],[77,"\xCB6"],[18,"\xCB6"],"\x3A"=>[77,"\xCB7"],"\x3B"=>[18,"\xCB7"],"\x3C"=>[77,"\xCB8"],"\x3D"=>[18,"\xCB8"],"\x3E"=>[77,"\xCB9"],"\x3F"=>[18,"\xCB9"],"\x40"=>[77,"\xCB\x3D"],"A"=>[18,"\xCB\x3D"],"B"=>[77,"\xCBA"],"C"=>[18,"\xCBA"],"D"=>[77,"\xCB_"],"E"=>[18,"\xCB_"],"F"=>[77,"\xCBb"],"G"=>[18,"\xCBb"],"H"=>[77,"\xCBd"],"I"=>[18,"\xCBd"],"J"=>[77,"\xCBf"],"K"=>[18,"\xCBf"],"L"=>[77,"\xCBg"],"M"=>[18,"\xCBg"],"N"=>[77,"\xCBh"],"O"=>[18,"\xCBh"],"P"=>[77,"\xCBl"],"Q"=>[18,"\xCBl"],"R"=>[77,"\xCBm"],"S"=>[18,"\xCBm"],"T"=>[77,"\xCBn"],"U"=>[18,"\xCBn"],"V"=>[77,"\xCBp"],"W"=>[18,"\xCBp"],"X"=>[77,"\xCBr"],"Y"=>[18,"\xCBr"],"Z"=>[77,"\xCBu"],"\x5B"=>[18,"\xCBu"],"\x5C"=>[0,"\xCB\x3A"],"\x5D"=>[0,"\xCBB"],"\x5E"=>[0,"\xCBC"],"_"=>[0,"\xCBD"],"\x60"=>[0,"\xCBE"],"a"=>[0,"\xCBF"],"b"=>[0,"\xCBG"],"c"=>[0,"\xCBH"],"d"=>[0,"\xCBI"],"e"=>[0,"\xCBJ"],"f"=>[0,"\xCBK"],"g"=>[0,"\xCBL"],"h"=>[0,"\xCBM"],"i"=>[0,"\xCBN"],"j"=>[0,"\xCBO"],"k"=>[0,"\xCBP"],"l"=>[0,"\xCBQ"],"m"=>[0,"\xCBR"],"n"=>[0,"\xCBS"],"o"=>[0,"\xCBT"],"p"=>[0,"\xCBU"],"q"=>[0,"\xCBV"],"r"=>[0,"\xCBW"],"s"=>[0,"\xCBY"],"t"=>[0,"\xCBj"],"u"=>[0,"\xCBk"],"v"=>[0,"\xCBq"],"w"=>[0,"\xCBv"],"x"=>[0,"\xCBw"],"y"=>[0,"\xCBx"],"z"=>[0,"\xCBy"],"\x7B"=>[0,"\xCBz"],"\x7C"=>[82,"\xCB"],"\x7D"=>[87,"\xCB"],"~"=>[130,"\xCB"],"\x7F"=>[9,"\xCB"],"\x80"=>[94,"\xCC0"],"\x81"=>[76,"\xCC0"],"\x82"=>[104,"\xCC0"],"\x83"=>[16,"\xCC0"],"\x84"=>[94,"\xCC1"],"\x85"=>[76,"\xCC1"],"\x86"=>[104,"\xCC1"],"\x87"=>[16,"\xCC1"],"\x88"=>[94,"\xCC2"],"\x89"=>[76,"\xCC2"],"\x8A"=>[104,"\xCC2"],"\x8B"=>[16,"\xCC2"],"\x8C"=>[94,"\xCCa"],"\x8D"=>[76,"\xCCa"],"\x8E"=>[104,"\xCCa"],"\x8F"=>[16,"\xCCa"],"\x90"=>[94,"\xCCc"],"\x91"=>[76,"\xCCc"],"\x92"=>[104,"\xCCc"],"\x93"=>[16,"\xCCc"],"\x94"=>[94,"\xCCe"],"\x95"=>[76,"\xCCe"],"\x96"=>[104,"\xCCe"],"\x97"=>[16,"\xCCe"],"\x98"=>[94,"\xCCi"],"\x99"=>[76,"\xCCi"],"\x9A"=>[104,"\xCCi"],"\x9B"=>[16,"\xCCi"],"\x9C"=>[94,"\xCCo"],"\x9D"=>[76,"\xCCo"],"\x9E"=>[104,"\xCCo"],"\x9F"=>[16,"\xCCo"],"\xA0"=>[94,"\xCCs"],"\xA1"=>[76,"\xCCs"],"\xA2"=>[104,"\xCCs"],"\xA3"=>[16,"\xCCs"],"\xA4"=>[94,"\xCCt"],"\xA5"=>[76,"\xCCt"],"\xA6"=>[104,"\xCCt"],"\xA7"=>[16,"\xCCt"],"\xA8"=>[77,"\xCC\x20"],"\xA9"=>[18,"\xCC\x20"],"\xAA"=>[77,"\xCC\x25"],"\xAB"=>[18,"\xCC\x25"],"\xAC"=>[77,"\xCC-"],"\xAD"=>[18,"\xCC-"],"\xAE"=>[77,"\xCC."],"\xAF"=>[18,"\xCC."],"\xB0"=>[77,"\xCC\x2F"],"\xB1"=>[18,"\xCC\x2F"],"\xB2"=>[77,"\xCC3"],"\xB3"=>[18,"\xCC3"],"\xB4"=>[77,"\xCC4"],"\xB5"=>[18,"\xCC4"],"\xB6"=>[77,"\xCC5"],"\xB7"=>[18,"\xCC5"],"\xB8"=>[77,"\xCC6"],"\xB9"=>[18,"\xCC6"],"\xBA"=>[77,"\xCC7"],"\xBB"=>[18,"\xCC7"],"\xBC"=>[77,"\xCC8"],"\xBD"=>[18,"\xCC8"],"\xBE"=>[77,"\xCC9"],"\xBF"=>[18,"\xCC9"],"\xC0"=>[77,"\xCC\x3D"],"\xC1"=>[18,"\xCC\x3D"],"\xC2"=>[77,"\xCCA"],"\xC3"=>[18,"\xCCA"],"\xC4"=>[77,"\xCC_"],"\xC5"=>[18,"\xCC_"],"\xC6"=>[77,"\xCCb"],"\xC7"=>[18,"\xCCb"],"\xC8"=>[77,"\xCCd"],"\xC9"=>[18,"\xCCd"],"\xCA"=>[77,"\xCCf"],"\xCB"=>[18,"\xCCf"],"\xCC"=>[77,"\xCCg"],"\xCD"=>[18,"\xCCg"],"\xCE"=>[77,"\xCCh"],"\xCF"=>[18,"\xCCh"],"\xD0"=>[77,"\xCCl"],"\xD1"=>[18,"\xCCl"],"\xD2"=>[77,"\xCCm"],"\xD3"=>[18,"\xCCm"],"\xD4"=>[77,"\xCCn"],"\xD5"=>[18,"\xCCn"],"\xD6"=>[77,"\xCCp"],"\xD7"=>[18,"\xCCp"],"\xD8"=>[77,"\xCCr"],"\xD9"=>[18,"\xCCr"],"\xDA"=>[77,"\xCCu"],"\xDB"=>[18,"\xCCu"],"\xDC"=>[0,"\xCC\x3A"],"\xDD"=>[0,"\xCCB"],"\xDE"=>[0,"\xCCC"],"\xDF"=>[0,"\xCCD"],"\xE0"=>[0,"\xCCE"],"\xE1"=>[0,"\xCCF"],"\xE2"=>[0,"\xCCG"],"\xE3"=>[0,"\xCCH"],"\xE4"=>[0,"\xCCI"],"\xE5"=>[0,"\xCCJ"],"\xE6"=>[0,"\xCCK"],"\xE7"=>[0,"\xCCL"],"\xE8"=>[0,"\xCCM"],"\xE9"=>[0,"\xCCN"],"\xEA"=>[0,"\xCCO"],"\xEB"=>[0,"\xCCP"],"\xEC"=>[0,"\xCCQ"],"\xED"=>[0,"\xCCR"],"\xEE"=>[0,"\xCCS"],"\xEF"=>[0,"\xCCT"],"\xF0"=>[0,"\xCCU"],"\xF1"=>[0,"\xCCV"],"\xF2"=>[0,"\xCCW"],"\xF3"=>[0,"\xCCY"],"\xF4"=>[0,"\xCCj"],"\xF5"=>[0,"\xCCk"],"\xF6"=>[0,"\xCCq"],"\xF7"=>[0,"\xCCv"],"\xF8"=>[0,"\xCCw"],"\xF9"=>[0,"\xCCx"],"\xFA"=>[0,"\xCCy"],"\xFB"=>[0,"\xCCz"],"\xFC"=>[82,"\xCC"],"\xFD"=>[87,"\xCC"],"\xFE"=>[130,"\xCC"],"\xFF"=>[9,"\xCC"],],["\x00"=>[94,"\xFF0"],"\x01"=>[76,"\xFF0"],"\x02"=>[104,"\xFF0"],"\x03"=>[16,"\xFF0"],"\x04"=>[94,"\xFF1"],"\x05"=>[76,"\xFF1"],"\x06"=>[104,"\xFF1"],"\x07"=>[16,"\xFF1"],"\x08"=>[94,"\xFF2"],"\x09"=>[76,"\xFF2"],"\x0A"=>[104,"\xFF2"],"\x0B"=>[16,"\xFF2"],"\x0C"=>[94,"\xFFa"],"\x0D"=>[76,"\xFFa"],"\x0E"=>[104,"\xFFa"],"\x0F"=>[16,"\xFFa"],"\x10"=>[94,"\xFFc"],"\x11"=>[76,"\xFFc"],"\x12"=>[104,"\xFFc"],"\x13"=>[16,"\xFFc"],"\x14"=>[94,"\xFFe"],"\x15"=>[76,"\xFFe"],"\x16"=>[104,"\xFFe"],"\x17"=>[16,"\xFFe"],"\x18"=>[94,"\xFFi"],"\x19"=>[76,"\xFFi"],"\x1A"=>[104,"\xFFi"],"\x1B"=>[16,"\xFFi"],"\x1C"=>[94,"\xFFo"],"\x1D"=>[76,"\xFFo"],"\x1E"=>[104,"\xFFo"],"\x1F"=>[16,"\xFFo"],"\x20"=>[94,"\xFFs"],"\x21"=>[76,"\xFFs"],"\x22"=>[104,"\xFFs"],"\x23"=>[16,"\xFFs"],"\x24"=>[94,"\xFFt"],"\x25"=>[76,"\xFFt"],"\x26"=>[104,"\xFFt"],"\x27"=>[16,"\xFFt"],"\x28"=>[77,"\xFF\x20"],"\x29"=>[18,"\xFF\x20"],"\x2A"=>[77,"\xFF\x25"],"\x2B"=>[18,"\xFF\x25"],"\x2C"=>[77,"\xFF-"],"-"=>[18,"\xFF-"],"."=>[77,"\xFF."],"\x2F"=>[18,"\xFF."],[77,"\xFF\x2F"],[18,"\xFF\x2F"],[77,"\xFF3"],[18,"\xFF3"],[77,"\xFF4"],[18,"\xFF4"],[77,"\xFF5"],[18,"\xFF5"],[77,"\xFF6"],[18,"\xFF6"],"\x3A"=>[77,"\xFF7"],"\x3B"=>[18,"\xFF7"],"\x3C"=>[77,"\xFF8"],"\x3D"=>[18,"\xFF8"],"\x3E"=>[77,"\xFF9"],"\x3F"=>[18,"\xFF9"],"\x40"=>[77,"\xFF\x3D"],"A"=>[18,"\xFF\x3D"],"B"=>[77,"\xFFA"],"C"=>[18,"\xFFA"],"D"=>[77,"\xFF_"],"E"=>[18,"\xFF_"],"F"=>[77,"\xFFb"],"G"=>[18,"\xFFb"],"H"=>[77,"\xFFd"],"I"=>[18,"\xFFd"],"J"=>[77,"\xFFf"],"K"=>[18,"\xFFf"],"L"=>[77,"\xFFg"],"M"=>[18,"\xFFg"],"N"=>[77,"\xFFh"],"O"=>[18,"\xFFh"],"P"=>[77,"\xFFl"],"Q"=>[18,"\xFFl"],"R"=>[77,"\xFFm"],"S"=>[18,"\xFFm"],"T"=>[77,"\xFFn"],"U"=>[18,"\xFFn"],"V"=>[77,"\xFFp"],"W"=>[18,"\xFFp"],"X"=>[77,"\xFFr"],"Y"=>[18,"\xFFr"],"Z"=>[77,"\xFFu"],"\x5B"=>[18,"\xFFu"],"\x5C"=>[0,"\xFF\x3A"],"\x5D"=>[0,"\xFFB"],"\x5E"=>[0,"\xFFC"],"_"=>[0,"\xFFD"],"\x60"=>[0,"\xFFE"],"a"=>[0,"\xFFF"],"b"=>[0,"\xFFG"],"c"=>[0,"\xFFH"],"d"=>[0,"\xFFI"],"e"=>[0,"\xFFJ"],"f"=>[0,"\xFFK"],"g"=>[0,"\xFFL"],"h"=>[0,"\xFFM"],"i"=>[0,"\xFFN"],"j"=>[0,"\xFFO"],"k"=>[0,"\xFFP"],"l"=>[0,"\xFFQ"],"m"=>[0,"\xFFR"],"n"=>[0,"\xFFS"],"o"=>[0,"\xFFT"],"p"=>[0,"\xFFU"],"q"=>[0,"\xFFV"],"r"=>[0,"\xFFW"],"s"=>[0,"\xFFY"],"t"=>[0,"\xFFj"],"u"=>[0,"\xFFk"],"v"=>[0,"\xFFq"],"w"=>[0,"\xFFv"],"x"=>[0,"\xFFw"],"y"=>[0,"\xFFx"],"z"=>[0,"\xFFy"],"\x7B"=>[0,"\xFFz"],"\x7C"=>[82,"\xFF"],"\x7D"=>[87,"\xFF"],"~"=>[130,"\xFF"],"\x7F"=>[9,"\xFF"],"\x80"=>[77,"\xCB0"],"\x81"=>[18,"\xCB0"],"\x82"=>[77,"\xCB1"],"\x83"=>[18,"\xCB1"],"\x84"=>[77,"\xCB2"],"\x85"=>[18,"\xCB2"],"\x86"=>[77,"\xCBa"],"\x87"=>[18,"\xCBa"],"\x88"=>[77,"\xCBc"],"\x89"=>[18,"\xCBc"],"\x8A"=>[77,"\xCBe"],"\x8B"=>[18,"\xCBe"],"\x8C"=>[77,"\xCBi"],"\x8D"=>[18,"\xCBi"],"\x8E"=>[77,"\xCBo"],"\x8F"=>[18,"\xCBo"],"\x90"=>[77,"\xCBs"],"\x91"=>[18,"\xCBs"],"\x92"=>[77,"\xCBt"],"\x93"=>[18,"\xCBt"],"\x94"=>[0,"\xCB\x20"],"\x95"=>[0,"\xCB\x25"],"\x96"=>[0,"\xCB-"],"\x97"=>[0,"\xCB."],"\x98"=>[0,"\xCB\x2F"],"\x99"=>[0,"\xCB3"],"\x9A"=>[0,"\xCB4"],"\x9B"=>[0,"\xCB5"],"\x9C"=>[0,"\xCB6"],"\x9D"=>[0,"\xCB7"],"\x9E"=>[0,"\xCB8"],"\x9F"=>[0,"\xCB9"],"\xA0"=>[0,"\xCB\x3D"],"\xA1"=>[0,"\xCBA"],"\xA2"=>[0,"\xCB_"],"\xA3"=>[0,"\xCBb"],"\xA4"=>[0,"\xCBd"],"\xA5"=>[0,"\xCBf"],"\xA6"=>[0,"\xCBg"],"\xA7"=>[0,"\xCBh"],"\xA8"=>[0,"\xCBl"],"\xA9"=>[0,"\xCBm"],"\xAA"=>[0,"\xCBn"],"\xAB"=>[0,"\xCBp"],"\xAC"=>[0,"\xCBr"],"\xAD"=>[0,"\xCBu"],"\xAE"=>[100,"\xCB"],"\xAF"=>[110,"\xCB"],"\xB0"=>[111,"\xCB"],"\xB1"=>[115,"\xCB"],"\xB2"=>[116,"\xCB"],"\xB3"=>[118,"\xCB"],"\xB4"=>[119,"\xCB"],"\xB5"=>[122,"\xCB"],"\xB6"=>[123,"\xCB"],"\xB7"=>[125,"\xCB"],"\xB8"=>[126,"\xCB"],"\xB9"=>[129,"\xCB"],"\xBA"=>[143,"\xCB"],"\xBB"=>[148,"\xCB"],"\xBC"=>[151,"\xCB"],"\xBD"=>[153,"\xCB"],"\xBE"=>[83,"\xCB"],"\xBF"=>[10,"\xCB"],"\xC0"=>[77,"\xCC0"],"\xC1"=>[18,"\xCC0"],"\xC2"=>[77,"\xCC1"],"\xC3"=>[18,"\xCC1"],"\xC4"=>[77,"\xCC2"],"\xC5"=>[18,"\xCC2"],"\xC6"=>[77,"\xCCa"],"\xC7"=>[18,"\xCCa"],"\xC8"=>[77,"\xCCc"],"\xC9"=>[18,"\xCCc"],"\xCA"=>[77,"\xCCe"],"\xCB"=>[18,"\xCCe"],"\xCC"=>[77,"\xCCi"],"\xCD"=>[18,"\xCCi"],"\xCE"=>[77,"\xCCo"],"\xCF"=>[18,"\xCCo"],"\xD0"=>[77,"\xCCs"],"\xD1"=>[18,"\xCCs"],"\xD2"=>[77,"\xCCt"],"\xD3"=>[18,"\xCCt"],"\xD4"=>[0,"\xCC\x20"],"\xD5"=>[0,"\xCC\x25"],"\xD6"=>[0,"\xCC-"],"\xD7"=>[0,"\xCC."],"\xD8"=>[0,"\xCC\x2F"],"\xD9"=>[0,"\xCC3"],"\xDA"=>[0,"\xCC4"],"\xDB"=>[0,"\xCC5"],"\xDC"=>[0,"\xCC6"],"\xDD"=>[0,"\xCC7"],"\xDE"=>[0,"\xCC8"],"\xDF"=>[0,"\xCC9"],"\xE0"=>[0,"\xCC\x3D"],"\xE1"=>[0,"\xCCA"],"\xE2"=>[0,"\xCC_"],"\xE3"=>[0,"\xCCb"],"\xE4"=>[0,"\xCCd"],"\xE5"=>[0,"\xCCf"],"\xE6"=>[0,"\xCCg"],"\xE7"=>[0,"\xCCh"],"\xE8"=>[0,"\xCCl"],"\xE9"=>[0,"\xCCm"],"\xEA"=>[0,"\xCCn"],"\xEB"=>[0,"\xCCp"],"\xEC"=>[0,"\xCCr"],"\xED"=>[0,"\xCCu"],"\xEE"=>[100,"\xCC"],"\xEF"=>[110,"\xCC"],"\xF0"=>[111,"\xCC"],"\xF1"=>[115,"\xCC"],"\xF2"=>[116,"\xCC"],"\xF3"=>[118,"\xCC"],"\xF4"=>[119,"\xCC"],"\xF5"=>[122,"\xCC"],"\xF6"=>[123,"\xCC"],"\xF7"=>[125,"\xCC"],"\xF8"=>[126,"\xCC"],"\xF9"=>[129,"\xCC"],"\xFA"=>[143,"\xCC"],"\xFB"=>[148,"\xCC"],"\xFC"=>[151,"\xCC"],"\xFD"=>[153,"\xCC"],"\xFE"=>[83,"\xCC"],"\xFF"=>[10,"\xCC"],],["\x00"=>[94,"\xD20"],"\x01"=>[76,"\xD20"],"\x02"=>[104,"\xD20"],"\x03"=>[16,"\xD20"],"\x04"=>[94,"\xD21"],"\x05"=>[76,"\xD21"],"\x06"=>[104,"\xD21"],"\x07"=>[16,"\xD21"],"\x08"=>[94,"\xD22"],"\x09"=>[76,"\xD22"],"\x0A"=>[104,"\xD22"],"\x0B"=>[16,"\xD22"],"\x0C"=>[94,"\xD2a"],"\x0D"=>[76,"\xD2a"],"\x0E"=>[104,"\xD2a"],"\x0F"=>[16,"\xD2a"],"\x10"=>[94,"\xD2c"],"\x11"=>[76,"\xD2c"],"\x12"=>[104,"\xD2c"],"\x13"=>[16,"\xD2c"],"\x14"=>[94,"\xD2e"],"\x15"=>[76,"\xD2e"],"\x16"=>[104,"\xD2e"],"\x17"=>[16,"\xD2e"],"\x18"=>[94,"\xD2i"],"\x19"=>[76,"\xD2i"],"\x1A"=>[104,"\xD2i"],"\x1B"=>[16,"\xD2i"],"\x1C"=>[94,"\xD2o"],"\x1D"=>[76,"\xD2o"],"\x1E"=>[104,"\xD2o"],"\x1F"=>[16,"\xD2o"],"\x20"=>[94,"\xD2s"],"\x21"=>[76,"\xD2s"],"\x22"=>[104,"\xD2s"],"\x23"=>[16,"\xD2s"],"\x24"=>[94,"\xD2t"],"\x25"=>[76,"\xD2t"],"\x26"=>[104,"\xD2t"],"\x27"=>[16,"\xD2t"],"\x28"=>[77,"\xD2\x20"],"\x29"=>[18,"\xD2\x20"],"\x2A"=>[77,"\xD2\x25"],"\x2B"=>[18,"\xD2\x25"],"\x2C"=>[77,"\xD2-"],"-"=>[18,"\xD2-"],"."=>[77,"\xD2."],"\x2F"=>[18,"\xD2."],[77,"\xD2\x2F"],[18,"\xD2\x2F"],[77,"\xD23"],[18,"\xD23"],[77,"\xD24"],[18,"\xD24"],[77,"\xD25"],[18,"\xD25"],[77,"\xD26"],[18,"\xD26"],"\x3A"=>[77,"\xD27"],"\x3B"=>[18,"\xD27"],"\x3C"=>[77,"\xD28"],"\x3D"=>[18,"\xD28"],"\x3E"=>[77,"\xD29"],"\x3F"=>[18,"\xD29"],"\x40"=>[77,"\xD2\x3D"],"A"=>[18,"\xD2\x3D"],"B"=>[77,"\xD2A"],"C"=>[18,"\xD2A"],"D"=>[77,"\xD2_"],"E"=>[18,"\xD2_"],"F"=>[77,"\xD2b"],"G"=>[18,"\xD2b"],"H"=>[77,"\xD2d"],"I"=>[18,"\xD2d"],"J"=>[77,"\xD2f"],"K"=>[18,"\xD2f"],"L"=>[77,"\xD2g"],"M"=>[18,"\xD2g"],"N"=>[77,"\xD2h"],"O"=>[18,"\xD2h"],"P"=>[77,"\xD2l"],"Q"=>[18,"\xD2l"],"R"=>[77,"\xD2m"],"S"=>[18,"\xD2m"],"T"=>[77,"\xD2n"],"U"=>[18,"\xD2n"],"V"=>[77,"\xD2p"],"W"=>[18,"\xD2p"],"X"=>[77,"\xD2r"],"Y"=>[18,"\xD2r"],"Z"=>[77,"\xD2u"],"\x5B"=>[18,"\xD2u"],"\x5C"=>[0,"\xD2\x3A"],"\x5D"=>[0,"\xD2B"],"\x5E"=>[0,"\xD2C"],"_"=>[0,"\xD2D"],"\x60"=>[0,"\xD2E"],"a"=>[0,"\xD2F"],"b"=>[0,"\xD2G"],"c"=>[0,"\xD2H"],"d"=>[0,"\xD2I"],"e"=>[0,"\xD2J"],"f"=>[0,"\xD2K"],"g"=>[0,"\xD2L"],"h"=>[0,"\xD2M"],"i"=>[0,"\xD2N"],"j"=>[0,"\xD2O"],"k"=>[0,"\xD2P"],"l"=>[0,"\xD2Q"],"m"=>[0,"\xD2R"],"n"=>[0,"\xD2S"],"o"=>[0,"\xD2T"],"p"=>[0,"\xD2U"],"q"=>[0,"\xD2V"],"r"=>[0,"\xD2W"],"s"=>[0,"\xD2Y"],"t"=>[0,"\xD2j"],"u"=>[0,"\xD2k"],"v"=>[0,"\xD2q"],"w"=>[0,"\xD2v"],"x"=>[0,"\xD2w"],"y"=>[0,"\xD2x"],"z"=>[0,"\xD2y"],"\x7B"=>[0,"\xD2z"],"\x7C"=>[82,"\xD2"],"\x7D"=>[87,"\xD2"],"~"=>[130,"\xD2"],"\x7F"=>[9,"\xD2"],"\x80"=>[94,"\xD50"],"\x81"=>[76,"\xD50"],"\x82"=>[104,"\xD50"],"\x83"=>[16,"\xD50"],"\x84"=>[94,"\xD51"],"\x85"=>[76,"\xD51"],"\x86"=>[104,"\xD51"],"\x87"=>[16,"\xD51"],"\x88"=>[94,"\xD52"],"\x89"=>[76,"\xD52"],"\x8A"=>[104,"\xD52"],"\x8B"=>[16,"\xD52"],"\x8C"=>[94,"\xD5a"],"\x8D"=>[76,"\xD5a"],"\x8E"=>[104,"\xD5a"],"\x8F"=>[16,"\xD5a"],"\x90"=>[94,"\xD5c"],"\x91"=>[76,"\xD5c"],"\x92"=>[104,"\xD5c"],"\x93"=>[16,"\xD5c"],"\x94"=>[94,"\xD5e"],"\x95"=>[76,"\xD5e"],"\x96"=>[104,"\xD5e"],"\x97"=>[16,"\xD5e"],"\x98"=>[94,"\xD5i"],"\x99"=>[76,"\xD5i"],"\x9A"=>[104,"\xD5i"],"\x9B"=>[16,"\xD5i"],"\x9C"=>[94,"\xD5o"],"\x9D"=>[76,"\xD5o"],"\x9E"=>[104,"\xD5o"],"\x9F"=>[16,"\xD5o"],"\xA0"=>[94,"\xD5s"],"\xA1"=>[76,"\xD5s"],"\xA2"=>[104,"\xD5s"],"\xA3"=>[16,"\xD5s"],"\xA4"=>[94,"\xD5t"],"\xA5"=>[76,"\xD5t"],"\xA6"=>[104,"\xD5t"],"\xA7"=>[16,"\xD5t"],"\xA8"=>[77,"\xD5\x20"],"\xA9"=>[18,"\xD5\x20"],"\xAA"=>[77,"\xD5\x25"],"\xAB"=>[18,"\xD5\x25"],"\xAC"=>[77,"\xD5-"],"\xAD"=>[18,"\xD5-"],"\xAE"=>[77,"\xD5."],"\xAF"=>[18,"\xD5."],"\xB0"=>[77,"\xD5\x2F"],"\xB1"=>[18,"\xD5\x2F"],"\xB2"=>[77,"\xD53"],"\xB3"=>[18,"\xD53"],"\xB4"=>[77,"\xD54"],"\xB5"=>[18,"\xD54"],"\xB6"=>[77,"\xD55"],"\xB7"=>[18,"\xD55"],"\xB8"=>[77,"\xD56"],"\xB9"=>[18,"\xD56"],"\xBA"=>[77,"\xD57"],"\xBB"=>[18,"\xD57"],"\xBC"=>[77,"\xD58"],"\xBD"=>[18,"\xD58"],"\xBE"=>[77,"\xD59"],"\xBF"=>[18,"\xD59"],"\xC0"=>[77,"\xD5\x3D"],"\xC1"=>[18,"\xD5\x3D"],"\xC2"=>[77,"\xD5A"],"\xC3"=>[18,"\xD5A"],"\xC4"=>[77,"\xD5_"],"\xC5"=>[18,"\xD5_"],"\xC6"=>[77,"\xD5b"],"\xC7"=>[18,"\xD5b"],"\xC8"=>[77,"\xD5d"],"\xC9"=>[18,"\xD5d"],"\xCA"=>[77,"\xD5f"],"\xCB"=>[18,"\xD5f"],"\xCC"=>[77,"\xD5g"],"\xCD"=>[18,"\xD5g"],"\xCE"=>[77,"\xD5h"],"\xCF"=>[18,"\xD5h"],"\xD0"=>[77,"\xD5l"],"\xD1"=>[18,"\xD5l"],"\xD2"=>[77,"\xD5m"],"\xD3"=>[18,"\xD5m"],"\xD4"=>[77,"\xD5n"],"\xD5"=>[18,"\xD5n"],"\xD6"=>[77,"\xD5p"],"\xD7"=>[18,"\xD5p"],"\xD8"=>[77,"\xD5r"],"\xD9"=>[18,"\xD5r"],"\xDA"=>[77,"\xD5u"],"\xDB"=>[18,"\xD5u"],"\xDC"=>[0,"\xD5\x3A"],"\xDD"=>[0,"\xD5B"],"\xDE"=>[0,"\xD5C"],"\xDF"=>[0,"\xD5D"],"\xE0"=>[0,"\xD5E"],"\xE1"=>[0,"\xD5F"],"\xE2"=>[0,"\xD5G"],"\xE3"=>[0,"\xD5H"],"\xE4"=>[0,"\xD5I"],"\xE5"=>[0,"\xD5J"],"\xE6"=>[0,"\xD5K"],"\xE7"=>[0,"\xD5L"],"\xE8"=>[0,"\xD5M"],"\xE9"=>[0,"\xD5N"],"\xEA"=>[0,"\xD5O"],"\xEB"=>[0,"\xD5P"],"\xEC"=>[0,"\xD5Q"],"\xED"=>[0,"\xD5R"],"\xEE"=>[0,"\xD5S"],"\xEF"=>[0,"\xD5T"],"\xF0"=>[0,"\xD5U"],"\xF1"=>[0,"\xD5V"],"\xF2"=>[0,"\xD5W"],"\xF3"=>[0,"\xD5Y"],"\xF4"=>[0,"\xD5j"],"\xF5"=>[0,"\xD5k"],"\xF6"=>[0,"\xD5q"],"\xF7"=>[0,"\xD5v"],"\xF8"=>[0,"\xD5w"],"\xF9"=>[0,"\xD5x"],"\xFA"=>[0,"\xD5y"],"\xFB"=>[0,"\xD5z"],"\xFC"=>[82,"\xD5"],"\xFD"=>[87,"\xD5"],"\xFE"=>[130,"\xD5"],"\xFF"=>[9,"\xD5"],],["\x00"=>[0,"\xD30"],"\x01"=>[0,"\xD31"],"\x02"=>[0,"\xD32"],"\x03"=>[0,"\xD3a"],"\x04"=>[0,"\xD3c"],"\x05"=>[0,"\xD3e"],"\x06"=>[0,"\xD3i"],"\x07"=>[0,"\xD3o"],"\x08"=>[0,"\xD3s"],"\x09"=>[0,"\xD3t"],"\x0A"=>[73,"\xD3"],"\x0B"=>[88,"\xD3"],"\x0C"=>[89,"\xD3"],"\x0D"=>[96,"\xD3"],"\x0E"=>[97,"\xD3"],"\x0F"=>[99,"\xD3"],"\x10"=>[106,"\xD3"],"\x11"=>[136,"\xD3"],"\x12"=>[139,"\xD3"],"\x13"=>[141,"\xD3"],"\x14"=>[145,"\xD3"],"\x15"=>[147,"\xD3"],"\x16"=>[149,"\xD3"],"\x17"=>[101,"\xD3"],"\x18"=>[112,"\xD3"],"\x19"=>[117,"\xD3"],"\x1A"=>[120,"\xD3"],"\x1B"=>[124,"\xD3"],"\x1C"=>[127,"\xD3"],"\x1D"=>[144,"\xD3"],"\x1E"=>[152,"\xD3"],"\x1F"=>[11,"\xD3"],"\x20"=>[0,"\xD40"],"\x21"=>[0,"\xD41"],"\x22"=>[0,"\xD42"],"\x23"=>[0,"\xD4a"],"\x24"=>[0,"\xD4c"],"\x25"=>[0,"\xD4e"],"\x26"=>[0,"\xD4i"],"\x27"=>[0,"\xD4o"],"\x28"=>[0,"\xD4s"],"\x29"=>[0,"\xD4t"],"\x2A"=>[73,"\xD4"],"\x2B"=>[88,"\xD4"],"\x2C"=>[89,"\xD4"],"-"=>[96,"\xD4"],"."=>[97,"\xD4"],"\x2F"=>[99,"\xD4"],[106,"\xD4"],[136,"\xD4"],[139,"\xD4"],[141,"\xD4"],[145,"\xD4"],[147,"\xD4"],[149,"\xD4"],[101,"\xD4"],[112,"\xD4"],[117,"\xD4"],"\x3A"=>[120,"\xD4"],"\x3B"=>[124,"\xD4"],"\x3C"=>[127,"\xD4"],"\x3D"=>[144,"\xD4"],"\x3E"=>[152,"\xD4"],"\x3F"=>[11,"\xD4"],"\x40"=>[0,"\xD60"],"A"=>[0,"\xD61"],"B"=>[0,"\xD62"],"C"=>[0,"\xD6a"],"D"=>[0,"\xD6c"],"E"=>[0,"\xD6e"],"F"=>[0,"\xD6i"],"G"=>[0,"\xD6o"],"H"=>[0,"\xD6s"],"I"=>[0,"\xD6t"],"J"=>[73,"\xD6"],"K"=>[88,"\xD6"],"L"=>[89,"\xD6"],"M"=>[96,"\xD6"],"N"=>[97,"\xD6"],"O"=>[99,"\xD6"],"P"=>[106,"\xD6"],"Q"=>[136,"\xD6"],"R"=>[139,"\xD6"],"S"=>[141,"\xD6"],"T"=>[145,"\xD6"],"U"=>[147,"\xD6"],"V"=>[149,"\xD6"],"W"=>[101,"\xD6"],"X"=>[112,"\xD6"],"Y"=>[117,"\xD6"],"Z"=>[120,"\xD6"],"\x5B"=>[124,"\xD6"],"\x5C"=>[127,"\xD6"],"\x5D"=>[144,"\xD6"],"\x5E"=>[152,"\xD6"],"_"=>[11,"\xD6"],"\x60"=>[0,"\xDD0"],"a"=>[0,"\xDD1"],"b"=>[0,"\xDD2"],"c"=>[0,"\xDDa"],"d"=>[0,"\xDDc"],"e"=>[0,"\xDDe"],"f"=>[0,"\xDDi"],"g"=>[0,"\xDDo"],"h"=>[0,"\xDDs"],"i"=>[0,"\xDDt"],"j"=>[73,"\xDD"],"k"=>[88,"\xDD"],"l"=>[89,"\xDD"],"m"=>[96,"\xDD"],"n"=>[97,"\xDD"],"o"=>[99,"\xDD"],"p"=>[106,"\xDD"],"q"=>[136,"\xDD"],"r"=>[139,"\xDD"],"s"=>[141,"\xDD"],"t"=>[145,"\xDD"],"u"=>[147,"\xDD"],"v"=>[149,"\xDD"],"w"=>[101,"\xDD"],"x"=>[112,"\xDD"],"y"=>[117,"\xDD"],"z"=>[120,"\xDD"],"\x7B"=>[124,"\xDD"],"\x7C"=>[127,"\xDD"],"\x7D"=>[144,"\xDD"],"~"=>[152,"\xDD"],"\x7F"=>[11,"\xDD"],"\x80"=>[0,"\xDE0"],"\x81"=>[0,"\xDE1"],"\x82"=>[0,"\xDE2"],"\x83"=>[0,"\xDEa"],"\x84"=>[0,"\xDEc"],"\x85"=>[0,"\xDEe"],"\x86"=>[0,"\xDEi"],"\x87"=>[0,"\xDEo"],"\x88"=>[0,"\xDEs"],"\x89"=>[0,"\xDEt"],"\x8A"=>[73,"\xDE"],"\x8B"=>[88,"\xDE"],"\x8C"=>[89,"\xDE"],"\x8D"=>[96,"\xDE"],"\x8E"=>[97,"\xDE"],"\x8F"=>[99,"\xDE"],"\x90"=>[106,"\xDE"],"\x91"=>[136,"\xDE"],"\x92"=>[139,"\xDE"],"\x93"=>[141,"\xDE"],"\x94"=>[145,"\xDE"],"\x95"=>[147,"\xDE"],"\x96"=>[149,"\xDE"],"\x97"=>[101,"\xDE"],"\x98"=>[112,"\xDE"],"\x99"=>[117,"\xDE"],"\x9A"=>[120,"\xDE"],"\x9B"=>[124,"\xDE"],"\x9C"=>[127,"\xDE"],"\x9D"=>[144,"\xDE"],"\x9E"=>[152,"\xDE"],"\x9F"=>[11,"\xDE"],"\xA0"=>[0,"\xDF0"],"\xA1"=>[0,"\xDF1"],"\xA2"=>[0,"\xDF2"],"\xA3"=>[0,"\xDFa"],"\xA4"=>[0,"\xDFc"],"\xA5"=>[0,"\xDFe"],"\xA6"=>[0,"\xDFi"],"\xA7"=>[0,"\xDFo"],"\xA8"=>[0,"\xDFs"],"\xA9"=>[0,"\xDFt"],"\xAA"=>[73,"\xDF"],"\xAB"=>[88,"\xDF"],"\xAC"=>[89,"\xDF"],"\xAD"=>[96,"\xDF"],"\xAE"=>[97,"\xDF"],"\xAF"=>[99,"\xDF"],"\xB0"=>[106,"\xDF"],"\xB1"=>[136,"\xDF"],"\xB2"=>[139,"\xDF"],"\xB3"=>[141,"\xDF"],"\xB4"=>[145,"\xDF"],"\xB5"=>[147,"\xDF"],"\xB6"=>[149,"\xDF"],"\xB7"=>[101,"\xDF"],"\xB8"=>[112,"\xDF"],"\xB9"=>[117,"\xDF"],"\xBA"=>[120,"\xDF"],"\xBB"=>[124,"\xDF"],"\xBC"=>[127,"\xDF"],"\xBD"=>[144,"\xDF"],"\xBE"=>[152,"\xDF"],"\xBF"=>[11,"\xDF"],"\xC0"=>[0,"\xF10"],"\xC1"=>[0,"\xF11"],"\xC2"=>[0,"\xF12"],"\xC3"=>[0,"\xF1a"],"\xC4"=>[0,"\xF1c"],"\xC5"=>[0,"\xF1e"],"\xC6"=>[0,"\xF1i"],"\xC7"=>[0,"\xF1o"],"\xC8"=>[0,"\xF1s"],"\xC9"=>[0,"\xF1t"],"\xCA"=>[73,"\xF1"],"\xCB"=>[88,"\xF1"],"\xCC"=>[89,"\xF1"],"\xCD"=>[96,"\xF1"],"\xCE"=>[97,"\xF1"],"\xCF"=>[99,"\xF1"],"\xD0"=>[106,"\xF1"],"\xD1"=>[136,"\xF1"],"\xD2"=>[139,"\xF1"],"\xD3"=>[141,"\xF1"],"\xD4"=>[145,"\xF1"],"\xD5"=>[147,"\xF1"],"\xD6"=>[149,"\xF1"],"\xD7"=>[101,"\xF1"],"\xD8"=>[112,"\xF1"],"\xD9"=>[117,"\xF1"],"\xDA"=>[120,"\xF1"],"\xDB"=>[124,"\xF1"],"\xDC"=>[127,"\xF1"],"\xDD"=>[144,"\xF1"],"\xDE"=>[152,"\xF1"],"\xDF"=>[11,"\xF1"],"\xE0"=>[0,"\xF40"],"\xE1"=>[0,"\xF41"],"\xE2"=>[0,"\xF42"],"\xE3"=>[0,"\xF4a"],"\xE4"=>[0,"\xF4c"],"\xE5"=>[0,"\xF4e"],"\xE6"=>[0,"\xF4i"],"\xE7"=>[0,"\xF4o"],"\xE8"=>[0,"\xF4s"],"\xE9"=>[0,"\xF4t"],"\xEA"=>[73,"\xF4"],"\xEB"=>[88,"\xF4"],"\xEC"=>[89,"\xF4"],"\xED"=>[96,"\xF4"],"\xEE"=>[97,"\xF4"],"\xEF"=>[99,"\xF4"],"\xF0"=>[106,"\xF4"],"\xF1"=>[136,"\xF4"],"\xF2"=>[139,"\xF4"],"\xF3"=>[141,"\xF4"],"\xF4"=>[145,"\xF4"],"\xF5"=>[147,"\xF4"],"\xF6"=>[149,"\xF4"],"\xF7"=>[101,"\xF4"],"\xF8"=>[112,"\xF4"],"\xF9"=>[117,"\xF4"],"\xFA"=>[120,"\xF4"],"\xFB"=>[124,"\xF4"],"\xFC"=>[127,"\xF4"],"\xFD"=>[144,"\xF4"],"\xFE"=>[152,"\xF4"],"\xFF"=>[11,"\xF4"],],["\x00"=>[92,"\xD3"],"\x01"=>[95,"\xD3"],"\x02"=>[137,"\xD3"],"\x03"=>[142,"\xD3"],"\x04"=>[150,"\xD3"],"\x05"=>[74,"\xD3"],"\x06"=>[90,"\xD3"],"\x07"=>[98,"\xD3"],"\x08"=>[107,"\xD3"],"\x09"=>[140,"\xD3"],"\x0A"=>[146,"\xD3"],"\x0B"=>[102,"\xD3"],"\x0C"=>[113,"\xD3"],"\x0D"=>[121,"\xD3"],"\x0E"=>[128,"\xD3"],"\x0F"=>[12,"\xD3"],"\x10"=>[92,"\xD4"],"\x11"=>[95,"\xD4"],"\x12"=>[137,"\xD4"],"\x13"=>[142,"\xD4"],"\x14"=>[150,"\xD4"],"\x15"=>[74,"\xD4"],"\x16"=>[90,"\xD4"],"\x17"=>[98,"\xD4"],"\x18"=>[107,"\xD4"],"\x19"=>[140,"\xD4"],"\x1A"=>[146,"\xD4"],"\x1B"=>[102,"\xD4"],"\x1C"=>[113,"\xD4"],"\x1D"=>[121,"\xD4"],"\x1E"=>[128,"\xD4"],"\x1F"=>[12,"\xD4"],"\x20"=>[92,"\xD6"],"\x21"=>[95,"\xD6"],"\x22"=>[137,"\xD6"],"\x23"=>[142,"\xD6"],"\x24"=>[150,"\xD6"],"\x25"=>[74,"\xD6"],"\x26"=>[90,"\xD6"],"\x27"=>[98,"\xD6"],"\x28"=>[107,"\xD6"],"\x29"=>[140,"\xD6"],"\x2A"=>[146,"\xD6"],"\x2B"=>[102,"\xD6"],"\x2C"=>[113,"\xD6"],"-"=>[121,"\xD6"],"."=>[128,"\xD6"],"\x2F"=>[12,"\xD6"],[92,"\xDD"],[95,"\xDD"],[137,"\xDD"],[142,"\xDD"],[150,"\xDD"],[74,"\xDD"],[90,"\xDD"],[98,"\xDD"],[107,"\xDD"],[140,"\xDD"],"\x3A"=>[146,"\xDD"],"\x3B"=>[102,"\xDD"],"\x3C"=>[113,"\xDD"],"\x3D"=>[121,"\xDD"],"\x3E"=>[128,"\xDD"],"\x3F"=>[12,"\xDD"],"\x40"=>[92,"\xDE"],"A"=>[95,"\xDE"],"B"=>[137,"\xDE"],"C"=>[142,"\xDE"],"D"=>[150,"\xDE"],"E"=>[74,"\xDE"],"F"=>[90,"\xDE"],"G"=>[98,"\xDE"],"H"=>[107,"\xDE"],"I"=>[140,"\xDE"],"J"=>[146,"\xDE"],"K"=>[102,"\xDE"],"L"=>[113,"\xDE"],"M"=>[121,"\xDE"],"N"=>[128,"\xDE"],"O"=>[12,"\xDE"],"P"=>[92,"\xDF"],"Q"=>[95,"\xDF"],"R"=>[137,"\xDF"],"S"=>[142,"\xDF"],"T"=>[150,"\xDF"],"U"=>[74,"\xDF"],"V"=>[90,"\xDF"],"W"=>[98,"\xDF"],"X"=>[107,"\xDF"],"Y"=>[140,"\xDF"],"Z"=>[146,"\xDF"],"\x5B"=>[102,"\xDF"],"\x5C"=>[113,"\xDF"],"\x5D"=>[121,"\xDF"],"\x5E"=>[128,"\xDF"],"_"=>[12,"\xDF"],"\x60"=>[92,"\xF1"],"a"=>[95,"\xF1"],"b"=>[137,"\xF1"],"c"=>[142,"\xF1"],"d"=>[150,"\xF1"],"e"=>[74,"\xF1"],"f"=>[90,"\xF1"],"g"=>[98,"\xF1"],"h"=>[107,"\xF1"],"i"=>[140,"\xF1"],"j"=>[146,"\xF1"],"k"=>[102,"\xF1"],"l"=>[113,"\xF1"],"m"=>[121,"\xF1"],"n"=>[128,"\xF1"],"o"=>[12,"\xF1"],"p"=>[92,"\xF4"],"q"=>[95,"\xF4"],"r"=>[137,"\xF4"],"s"=>[142,"\xF4"],"t"=>[150,"\xF4"],"u"=>[74,"\xF4"],"v"=>[90,"\xF4"],"w"=>[98,"\xF4"],"x"=>[107,"\xF4"],"y"=>[140,"\xF4"],"z"=>[146,"\xF4"],"\x7B"=>[102,"\xF4"],"\x7C"=>[113,"\xF4"],"\x7D"=>[121,"\xF4"],"~"=>[128,"\xF4"],"\x7F"=>[12,"\xF4"],"\x80"=>[92,"\xF5"],"\x81"=>[95,"\xF5"],"\x82"=>[137,"\xF5"],"\x83"=>[142,"\xF5"],"\x84"=>[150,"\xF5"],"\x85"=>[74,"\xF5"],"\x86"=>[90,"\xF5"],"\x87"=>[98,"\xF5"],"\x88"=>[107,"\xF5"],"\x89"=>[140,"\xF5"],"\x8A"=>[146,"\xF5"],"\x8B"=>[102,"\xF5"],"\x8C"=>[113,"\xF5"],"\x8D"=>[121,"\xF5"],"\x8E"=>[128,"\xF5"],"\x8F"=>[12,"\xF5"],"\x90"=>[92,"\xF6"],"\x91"=>[95,"\xF6"],"\x92"=>[137,"\xF6"],"\x93"=>[142,"\xF6"],"\x94"=>[150,"\xF6"],"\x95"=>[74,"\xF6"],"\x96"=>[90,"\xF6"],"\x97"=>[98,"\xF6"],"\x98"=>[107,"\xF6"],"\x99"=>[140,"\xF6"],"\x9A"=>[146,"\xF6"],"\x9B"=>[102,"\xF6"],"\x9C"=>[113,"\xF6"],"\x9D"=>[121,"\xF6"],"\x9E"=>[128,"\xF6"],"\x9F"=>[12,"\xF6"],"\xA0"=>[92,"\xF7"],"\xA1"=>[95,"\xF7"],"\xA2"=>[137,"\xF7"],"\xA3"=>[142,"\xF7"],"\xA4"=>[150,"\xF7"],"\xA5"=>[74,"\xF7"],"\xA6"=>[90,"\xF7"],"\xA7"=>[98,"\xF7"],"\xA8"=>[107,"\xF7"],"\xA9"=>[140,"\xF7"],"\xAA"=>[146,"\xF7"],"\xAB"=>[102,"\xF7"],"\xAC"=>[113,"\xF7"],"\xAD"=>[121,"\xF7"],"\xAE"=>[128,"\xF7"],"\xAF"=>[12,"\xF7"],"\xB0"=>[92,"\xF8"],"\xB1"=>[95,"\xF8"],"\xB2"=>[137,"\xF8"],"\xB3"=>[142,"\xF8"],"\xB4"=>[150,"\xF8"],"\xB5"=>[74,"\xF8"],"\xB6"=>[90,"\xF8"],"\xB7"=>[98,"\xF8"],"\xB8"=>[107,"\xF8"],"\xB9"=>[140,"\xF8"],"\xBA"=>[146,"\xF8"],"\xBB"=>[102,"\xF8"],"\xBC"=>[113,"\xF8"],"\xBD"=>[121,"\xF8"],"\xBE"=>[128,"\xF8"],"\xBF"=>[12,"\xF8"],"\xC0"=>[92,"\xFA"],"\xC1"=>[95,"\xFA"],"\xC2"=>[137,"\xFA"],"\xC3"=>[142,"\xFA"],"\xC4"=>[150,"\xFA"],"\xC5"=>[74,"\xFA"],"\xC6"=>[90,"\xFA"],"\xC7"=>[98,"\xFA"],"\xC8"=>[107,"\xFA"],"\xC9"=>[140,"\xFA"],"\xCA"=>[146,"\xFA"],"\xCB"=>[102,"\xFA"],"\xCC"=>[113,"\xFA"],"\xCD"=>[121,"\xFA"],"\xCE"=>[128,"\xFA"],"\xCF"=>[12,"\xFA"],"\xD0"=>[92,"\xFB"],"\xD1"=>[95,"\xFB"],"\xD2"=>[137,"\xFB"],"\xD3"=>[142,"\xFB"],"\xD4"=>[150,"\xFB"],"\xD5"=>[74,"\xFB"],"\xD6"=>[90,"\xFB"],"\xD7"=>[98,"\xFB"],"\xD8"=>[107,"\xFB"],"\xD9"=>[140,"\xFB"],"\xDA"=>[146,"\xFB"],"\xDB"=>[102,"\xFB"],"\xDC"=>[113,"\xFB"],"\xDD"=>[121,"\xFB"],"\xDE"=>[128,"\xFB"],"\xDF"=>[12,"\xFB"],"\xE0"=>[92,"\xFC"],"\xE1"=>[95,"\xFC"],"\xE2"=>[137,"\xFC"],"\xE3"=>[142,"\xFC"],"\xE4"=>[150,"\xFC"],"\xE5"=>[74,"\xFC"],"\xE6"=>[90,"\xFC"],"\xE7"=>[98,"\xFC"],"\xE8"=>[107,"\xFC"],"\xE9"=>[140,"\xFC"],"\xEA"=>[146,"\xFC"],"\xEB"=>[102,"\xFC"],"\xEC"=>[113,"\xFC"],"\xED"=>[121,"\xFC"],"\xEE"=>[128,"\xFC"],"\xEF"=>[12,"\xFC"],"\xF0"=>[92,"\xFD"],"\xF1"=>[95,"\xFD"],"\xF2"=>[137,"\xFD"],"\xF3"=>[142,"\xFD"],"\xF4"=>[150,"\xFD"],"\xF5"=>[74,"\xFD"],"\xF6"=>[90,"\xFD"],"\xF7"=>[98,"\xFD"],"\xF8"=>[107,"\xFD"],"\xF9"=>[140,"\xFD"],"\xFA"=>[146,"\xFD"],"\xFB"=>[102,"\xFD"],"\xFC"=>[113,"\xFD"],"\xFD"=>[121,"\xFD"],"\xFE"=>[128,"\xFD"],"\xFF"=>[12,"\xFD"],],["\x00"=>[94,"\xD30"],"\x01"=>[76,"\xD30"],"\x02"=>[104,"\xD30"],"\x03"=>[16,"\xD30"],"\x04"=>[94,"\xD31"],"\x05"=>[76,"\xD31"],"\x06"=>[104,"\xD31"],"\x07"=>[16,"\xD31"],"\x08"=>[94,"\xD32"],"\x09"=>[76,"\xD32"],"\x0A"=>[104,"\xD32"],"\x0B"=>[16,"\xD32"],"\x0C"=>[94,"\xD3a"],"\x0D"=>[76,"\xD3a"],"\x0E"=>[104,"\xD3a"],"\x0F"=>[16,"\xD3a"],"\x10"=>[94,"\xD3c"],"\x11"=>[76,"\xD3c"],"\x12"=>[104,"\xD3c"],"\x13"=>[16,"\xD3c"],"\x14"=>[94,"\xD3e"],"\x15"=>[76,"\xD3e"],"\x16"=>[104,"\xD3e"],"\x17"=>[16,"\xD3e"],"\x18"=>[94,"\xD3i"],"\x19"=>[76,"\xD3i"],"\x1A"=>[104,"\xD3i"],"\x1B"=>[16,"\xD3i"],"\x1C"=>[94,"\xD3o"],"\x1D"=>[76,"\xD3o"],"\x1E"=>[104,"\xD3o"],"\x1F"=>[16,"\xD3o"],"\x20"=>[94,"\xD3s"],"\x21"=>[76,"\xD3s"],"\x22"=>[104,"\xD3s"],"\x23"=>[16,"\xD3s"],"\x24"=>[94,"\xD3t"],"\x25"=>[76,"\xD3t"],"\x26"=>[104,"\xD3t"],"\x27"=>[16,"\xD3t"],"\x28"=>[77,"\xD3\x20"],"\x29"=>[18,"\xD3\x20"],"\x2A"=>[77,"\xD3\x25"],"\x2B"=>[18,"\xD3\x25"],"\x2C"=>[77,"\xD3-"],"-"=>[18,"\xD3-"],"."=>[77,"\xD3."],"\x2F"=>[18,"\xD3."],[77,"\xD3\x2F"],[18,"\xD3\x2F"],[77,"\xD33"],[18,"\xD33"],[77,"\xD34"],[18,"\xD34"],[77,"\xD35"],[18,"\xD35"],[77,"\xD36"],[18,"\xD36"],"\x3A"=>[77,"\xD37"],"\x3B"=>[18,"\xD37"],"\x3C"=>[77,"\xD38"],"\x3D"=>[18,"\xD38"],"\x3E"=>[77,"\xD39"],"\x3F"=>[18,"\xD39"],"\x40"=>[77,"\xD3\x3D"],"A"=>[18,"\xD3\x3D"],"B"=>[77,"\xD3A"],"C"=>[18,"\xD3A"],"D"=>[77,"\xD3_"],"E"=>[18,"\xD3_"],"F"=>[77,"\xD3b"],"G"=>[18,"\xD3b"],"H"=>[77,"\xD3d"],"I"=>[18,"\xD3d"],"J"=>[77,"\xD3f"],"K"=>[18,"\xD3f"],"L"=>[77,"\xD3g"],"M"=>[18,"\xD3g"],"N"=>[77,"\xD3h"],"O"=>[18,"\xD3h"],"P"=>[77,"\xD3l"],"Q"=>[18,"\xD3l"],"R"=>[77,"\xD3m"],"S"=>[18,"\xD3m"],"T"=>[77,"\xD3n"],"U"=>[18,"\xD3n"],"V"=>[77,"\xD3p"],"W"=>[18,"\xD3p"],"X"=>[77,"\xD3r"],"Y"=>[18,"\xD3r"],"Z"=>[77,"\xD3u"],"\x5B"=>[18,"\xD3u"],"\x5C"=>[0,"\xD3\x3A"],"\x5D"=>[0,"\xD3B"],"\x5E"=>[0,"\xD3C"],"_"=>[0,"\xD3D"],"\x60"=>[0,"\xD3E"],"a"=>[0,"\xD3F"],"b"=>[0,"\xD3G"],"c"=>[0,"\xD3H"],"d"=>[0,"\xD3I"],"e"=>[0,"\xD3J"],"f"=>[0,"\xD3K"],"g"=>[0,"\xD3L"],"h"=>[0,"\xD3M"],"i"=>[0,"\xD3N"],"j"=>[0,"\xD3O"],"k"=>[0,"\xD3P"],"l"=>[0,"\xD3Q"],"m"=>[0,"\xD3R"],"n"=>[0,"\xD3S"],"o"=>[0,"\xD3T"],"p"=>[0,"\xD3U"],"q"=>[0,"\xD3V"],"r"=>[0,"\xD3W"],"s"=>[0,"\xD3Y"],"t"=>[0,"\xD3j"],"u"=>[0,"\xD3k"],"v"=>[0,"\xD3q"],"w"=>[0,"\xD3v"],"x"=>[0,"\xD3w"],"y"=>[0,"\xD3x"],"z"=>[0,"\xD3y"],"\x7B"=>[0,"\xD3z"],"\x7C"=>[82,"\xD3"],"\x7D"=>[87,"\xD3"],"~"=>[130,"\xD3"],"\x7F"=>[9,"\xD3"],"\x80"=>[94,"\xD40"],"\x81"=>[76,"\xD40"],"\x82"=>[104,"\xD40"],"\x83"=>[16,"\xD40"],"\x84"=>[94,"\xD41"],"\x85"=>[76,"\xD41"],"\x86"=>[104,"\xD41"],"\x87"=>[16,"\xD41"],"\x88"=>[94,"\xD42"],"\x89"=>[76,"\xD42"],"\x8A"=>[104,"\xD42"],"\x8B"=>[16,"\xD42"],"\x8C"=>[94,"\xD4a"],"\x8D"=>[76,"\xD4a"],"\x8E"=>[104,"\xD4a"],"\x8F"=>[16,"\xD4a"],"\x90"=>[94,"\xD4c"],"\x91"=>[76,"\xD4c"],"\x92"=>[104,"\xD4c"],"\x93"=>[16,"\xD4c"],"\x94"=>[94,"\xD4e"],"\x95"=>[76,"\xD4e"],"\x96"=>[104,"\xD4e"],"\x97"=>[16,"\xD4e"],"\x98"=>[94,"\xD4i"],"\x99"=>[76,"\xD4i"],"\x9A"=>[104,"\xD4i"],"\x9B"=>[16,"\xD4i"],"\x9C"=>[94,"\xD4o"],"\x9D"=>[76,"\xD4o"],"\x9E"=>[104,"\xD4o"],"\x9F"=>[16,"\xD4o"],"\xA0"=>[94,"\xD4s"],"\xA1"=>[76,"\xD4s"],"\xA2"=>[104,"\xD4s"],"\xA3"=>[16,"\xD4s"],"\xA4"=>[94,"\xD4t"],"\xA5"=>[76,"\xD4t"],"\xA6"=>[104,"\xD4t"],"\xA7"=>[16,"\xD4t"],"\xA8"=>[77,"\xD4\x20"],"\xA9"=>[18,"\xD4\x20"],"\xAA"=>[77,"\xD4\x25"],"\xAB"=>[18,"\xD4\x25"],"\xAC"=>[77,"\xD4-"],"\xAD"=>[18,"\xD4-"],"\xAE"=>[77,"\xD4."],"\xAF"=>[18,"\xD4."],"\xB0"=>[77,"\xD4\x2F"],"\xB1"=>[18,"\xD4\x2F"],"\xB2"=>[77,"\xD43"],"\xB3"=>[18,"\xD43"],"\xB4"=>[77,"\xD44"],"\xB5"=>[18,"\xD44"],"\xB6"=>[77,"\xD45"],"\xB7"=>[18,"\xD45"],"\xB8"=>[77,"\xD46"],"\xB9"=>[18,"\xD46"],"\xBA"=>[77,"\xD47"],"\xBB"=>[18,"\xD47"],"\xBC"=>[77,"\xD48"],"\xBD"=>[18,"\xD48"],"\xBE"=>[77,"\xD49"],"\xBF"=>[18,"\xD49"],"\xC0"=>[77,"\xD4\x3D"],"\xC1"=>[18,"\xD4\x3D"],"\xC2"=>[77,"\xD4A"],"\xC3"=>[18,"\xD4A"],"\xC4"=>[77,"\xD4_"],"\xC5"=>[18,"\xD4_"],"\xC6"=>[77,"\xD4b"],"\xC7"=>[18,"\xD4b"],"\xC8"=>[77,"\xD4d"],"\xC9"=>[18,"\xD4d"],"\xCA"=>[77,"\xD4f"],"\xCB"=>[18,"\xD4f"],"\xCC"=>[77,"\xD4g"],"\xCD"=>[18,"\xD4g"],"\xCE"=>[77,"\xD4h"],"\xCF"=>[18,"\xD4h"],"\xD0"=>[77,"\xD4l"],"\xD1"=>[18,"\xD4l"],"\xD2"=>[77,"\xD4m"],"\xD3"=>[18,"\xD4m"],"\xD4"=>[77,"\xD4n"],"\xD5"=>[18,"\xD4n"],"\xD6"=>[77,"\xD4p"],"\xD7"=>[18,"\xD4p"],"\xD8"=>[77,"\xD4r"],"\xD9"=>[18,"\xD4r"],"\xDA"=>[77,"\xD4u"],"\xDB"=>[18,"\xD4u"],"\xDC"=>[0,"\xD4\x3A"],"\xDD"=>[0,"\xD4B"],"\xDE"=>[0,"\xD4C"],"\xDF"=>[0,"\xD4D"],"\xE0"=>[0,"\xD4E"],"\xE1"=>[0,"\xD4F"],"\xE2"=>[0,"\xD4G"],"\xE3"=>[0,"\xD4H"],"\xE4"=>[0,"\xD4I"],"\xE5"=>[0,"\xD4J"],"\xE6"=>[0,"\xD4K"],"\xE7"=>[0,"\xD4L"],"\xE8"=>[0,"\xD4M"],"\xE9"=>[0,"\xD4N"],"\xEA"=>[0,"\xD4O"],"\xEB"=>[0,"\xD4P"],"\xEC"=>[0,"\xD4Q"],"\xED"=>[0,"\xD4R"],"\xEE"=>[0,"\xD4S"],"\xEF"=>[0,"\xD4T"],"\xF0"=>[0,"\xD4U"],"\xF1"=>[0,"\xD4V"],"\xF2"=>[0,"\xD4W"],"\xF3"=>[0,"\xD4Y"],"\xF4"=>[0,"\xD4j"],"\xF5"=>[0,"\xD4k"],"\xF6"=>[0,"\xD4q"],"\xF7"=>[0,"\xD4v"],"\xF8"=>[0,"\xD4w"],"\xF9"=>[0,"\xD4x"],"\xFA"=>[0,"\xD4y"],"\xFB"=>[0,"\xD4z"],"\xFC"=>[82,"\xD4"],"\xFD"=>[87,"\xD4"],"\xFE"=>[130,"\xD4"],"\xFF"=>[9,"\xD4"],],["\x00"=>[77,"\xD30"],"\x01"=>[18,"\xD30"],"\x02"=>[77,"\xD31"],"\x03"=>[18,"\xD31"],"\x04"=>[77,"\xD32"],"\x05"=>[18,"\xD32"],"\x06"=>[77,"\xD3a"],"\x07"=>[18,"\xD3a"],"\x08"=>[77,"\xD3c"],"\x09"=>[18,"\xD3c"],"\x0A"=>[77,"\xD3e"],"\x0B"=>[18,"\xD3e"],"\x0C"=>[77,"\xD3i"],"\x0D"=>[18,"\xD3i"],"\x0E"=>[77,"\xD3o"],"\x0F"=>[18,"\xD3o"],"\x10"=>[77,"\xD3s"],"\x11"=>[18,"\xD3s"],"\x12"=>[77,"\xD3t"],"\x13"=>[18,"\xD3t"],"\x14"=>[0,"\xD3\x20"],"\x15"=>[0,"\xD3\x25"],"\x16"=>[0,"\xD3-"],"\x17"=>[0,"\xD3."],"\x18"=>[0,"\xD3\x2F"],"\x19"=>[0,"\xD33"],"\x1A"=>[0,"\xD34"],"\x1B"=>[0,"\xD35"],"\x1C"=>[0,"\xD36"],"\x1D"=>[0,"\xD37"],"\x1E"=>[0,"\xD38"],"\x1F"=>[0,"\xD39"],"\x20"=>[0,"\xD3\x3D"],"\x21"=>[0,"\xD3A"],"\x22"=>[0,"\xD3_"],"\x23"=>[0,"\xD3b"],"\x24"=>[0,"\xD3d"],"\x25"=>[0,"\xD3f"],"\x26"=>[0,"\xD3g"],"\x27"=>[0,"\xD3h"],"\x28"=>[0,"\xD3l"],"\x29"=>[0,"\xD3m"],"\x2A"=>[0,"\xD3n"],"\x2B"=>[0,"\xD3p"],"\x2C"=>[0,"\xD3r"],"-"=>[0,"\xD3u"],"."=>[100,"\xD3"],"\x2F"=>[110,"\xD3"],[111,"\xD3"],[115,"\xD3"],[116,"\xD3"],[118,"\xD3"],[119,"\xD3"],[122,"\xD3"],[123,"\xD3"],[125,"\xD3"],[126,"\xD3"],[129,"\xD3"],"\x3A"=>[143,"\xD3"],"\x3B"=>[148,"\xD3"],"\x3C"=>[151,"\xD3"],"\x3D"=>[153,"\xD3"],"\x3E"=>[83,"\xD3"],"\x3F"=>[10,"\xD3"],"\x40"=>[77,"\xD40"],"A"=>[18,"\xD40"],"B"=>[77,"\xD41"],"C"=>[18,"\xD41"],"D"=>[77,"\xD42"],"E"=>[18,"\xD42"],"F"=>[77,"\xD4a"],"G"=>[18,"\xD4a"],"H"=>[77,"\xD4c"],"I"=>[18,"\xD4c"],"J"=>[77,"\xD4e"],"K"=>[18,"\xD4e"],"L"=>[77,"\xD4i"],"M"=>[18,"\xD4i"],"N"=>[77,"\xD4o"],"O"=>[18,"\xD4o"],"P"=>[77,"\xD4s"],"Q"=>[18,"\xD4s"],"R"=>[77,"\xD4t"],"S"=>[18,"\xD4t"],"T"=>[0,"\xD4\x20"],"U"=>[0,"\xD4\x25"],"V"=>[0,"\xD4-"],"W"=>[0,"\xD4."],"X"=>[0,"\xD4\x2F"],"Y"=>[0,"\xD43"],"Z"=>[0,"\xD44"],"\x5B"=>[0,"\xD45"],"\x5C"=>[0,"\xD46"],"\x5D"=>[0,"\xD47"],"\x5E"=>[0,"\xD48"],"_"=>[0,"\xD49"],"\x60"=>[0,"\xD4\x3D"],"a"=>[0,"\xD4A"],"b"=>[0,"\xD4_"],"c"=>[0,"\xD4b"],"d"=>[0,"\xD4d"],"e"=>[0,"\xD4f"],"f"=>[0,"\xD4g"],"g"=>[0,"\xD4h"],"h"=>[0,"\xD4l"],"i"=>[0,"\xD4m"],"j"=>[0,"\xD4n"],"k"=>[0,"\xD4p"],"l"=>[0,"\xD4r"],"m"=>[0,"\xD4u"],"n"=>[100,"\xD4"],"o"=>[110,"\xD4"],"p"=>[111,"\xD4"],"q"=>[115,"\xD4"],"r"=>[116,"\xD4"],"s"=>[118,"\xD4"],"t"=>[119,"\xD4"],"u"=>[122,"\xD4"],"v"=>[123,"\xD4"],"w"=>[125,"\xD4"],"x"=>[126,"\xD4"],"y"=>[129,"\xD4"],"z"=>[143,"\xD4"],"\x7B"=>[148,"\xD4"],"\x7C"=>[151,"\xD4"],"\x7D"=>[153,"\xD4"],"~"=>[83,"\xD4"],"\x7F"=>[10,"\xD4"],"\x80"=>[77,"\xD60"],"\x81"=>[18,"\xD60"],"\x82"=>[77,"\xD61"],"\x83"=>[18,"\xD61"],"\x84"=>[77,"\xD62"],"\x85"=>[18,"\xD62"],"\x86"=>[77,"\xD6a"],"\x87"=>[18,"\xD6a"],"\x88"=>[77,"\xD6c"],"\x89"=>[18,"\xD6c"],"\x8A"=>[77,"\xD6e"],"\x8B"=>[18,"\xD6e"],"\x8C"=>[77,"\xD6i"],"\x8D"=>[18,"\xD6i"],"\x8E"=>[77,"\xD6o"],"\x8F"=>[18,"\xD6o"],"\x90"=>[77,"\xD6s"],"\x91"=>[18,"\xD6s"],"\x92"=>[77,"\xD6t"],"\x93"=>[18,"\xD6t"],"\x94"=>[0,"\xD6\x20"],"\x95"=>[0,"\xD6\x25"],"\x96"=>[0,"\xD6-"],"\x97"=>[0,"\xD6."],"\x98"=>[0,"\xD6\x2F"],"\x99"=>[0,"\xD63"],"\x9A"=>[0,"\xD64"],"\x9B"=>[0,"\xD65"],"\x9C"=>[0,"\xD66"],"\x9D"=>[0,"\xD67"],"\x9E"=>[0,"\xD68"],"\x9F"=>[0,"\xD69"],"\xA0"=>[0,"\xD6\x3D"],"\xA1"=>[0,"\xD6A"],"\xA2"=>[0,"\xD6_"],"\xA3"=>[0,"\xD6b"],"\xA4"=>[0,"\xD6d"],"\xA5"=>[0,"\xD6f"],"\xA6"=>[0,"\xD6g"],"\xA7"=>[0,"\xD6h"],"\xA8"=>[0,"\xD6l"],"\xA9"=>[0,"\xD6m"],"\xAA"=>[0,"\xD6n"],"\xAB"=>[0,"\xD6p"],"\xAC"=>[0,"\xD6r"],"\xAD"=>[0,"\xD6u"],"\xAE"=>[100,"\xD6"],"\xAF"=>[110,"\xD6"],"\xB0"=>[111,"\xD6"],"\xB1"=>[115,"\xD6"],"\xB2"=>[116,"\xD6"],"\xB3"=>[118,"\xD6"],"\xB4"=>[119,"\xD6"],"\xB5"=>[122,"\xD6"],"\xB6"=>[123,"\xD6"],"\xB7"=>[125,"\xD6"],"\xB8"=>[126,"\xD6"],"\xB9"=>[129,"\xD6"],"\xBA"=>[143,"\xD6"],"\xBB"=>[148,"\xD6"],"\xBC"=>[151,"\xD6"],"\xBD"=>[153,"\xD6"],"\xBE"=>[83,"\xD6"],"\xBF"=>[10,"\xD6"],"\xC0"=>[77,"\xDD0"],"\xC1"=>[18,"\xDD0"],"\xC2"=>[77,"\xDD1"],"\xC3"=>[18,"\xDD1"],"\xC4"=>[77,"\xDD2"],"\xC5"=>[18,"\xDD2"],"\xC6"=>[77,"\xDDa"],"\xC7"=>[18,"\xDDa"],"\xC8"=>[77,"\xDDc"],"\xC9"=>[18,"\xDDc"],"\xCA"=>[77,"\xDDe"],"\xCB"=>[18,"\xDDe"],"\xCC"=>[77,"\xDDi"],"\xCD"=>[18,"\xDDi"],"\xCE"=>[77,"\xDDo"],"\xCF"=>[18,"\xDDo"],"\xD0"=>[77,"\xDDs"],"\xD1"=>[18,"\xDDs"],"\xD2"=>[77,"\xDDt"],"\xD3"=>[18,"\xDDt"],"\xD4"=>[0,"\xDD\x20"],"\xD5"=>[0,"\xDD\x25"],"\xD6"=>[0,"\xDD-"],"\xD7"=>[0,"\xDD."],"\xD8"=>[0,"\xDD\x2F"],"\xD9"=>[0,"\xDD3"],"\xDA"=>[0,"\xDD4"],"\xDB"=>[0,"\xDD5"],"\xDC"=>[0,"\xDD6"],"\xDD"=>[0,"\xDD7"],"\xDE"=>[0,"\xDD8"],"\xDF"=>[0,"\xDD9"],"\xE0"=>[0,"\xDD\x3D"],"\xE1"=>[0,"\xDDA"],"\xE2"=>[0,"\xDD_"],"\xE3"=>[0,"\xDDb"],"\xE4"=>[0,"\xDDd"],"\xE5"=>[0,"\xDDf"],"\xE6"=>[0,"\xDDg"],"\xE7"=>[0,"\xDDh"],"\xE8"=>[0,"\xDDl"],"\xE9"=>[0,"\xDDm"],"\xEA"=>[0,"\xDDn"],"\xEB"=>[0,"\xDDp"],"\xEC"=>[0,"\xDDr"],"\xED"=>[0,"\xDDu"],"\xEE"=>[100,"\xDD"],"\xEF"=>[110,"\xDD"],"\xF0"=>[111,"\xDD"],"\xF1"=>[115,"\xDD"],"\xF2"=>[116,"\xDD"],"\xF3"=>[118,"\xDD"],"\xF4"=>[119,"\xDD"],"\xF5"=>[122,"\xDD"],"\xF6"=>[123,"\xDD"],"\xF7"=>[125,"\xDD"],"\xF8"=>[126,"\xDD"],"\xF9"=>[129,"\xDD"],"\xFA"=>[143,"\xDD"],"\xFB"=>[148,"\xDD"],"\xFC"=>[151,"\xDD"],"\xFD"=>[153,"\xDD"],"\xFE"=>[83,"\xDD"],"\xFF"=>[10,"\xDD"],],["\x00"=>[94,"\xD60"],"\x01"=>[76,"\xD60"],"\x02"=>[104,"\xD60"],"\x03"=>[16,"\xD60"],"\x04"=>[94,"\xD61"],"\x05"=>[76,"\xD61"],"\x06"=>[104,"\xD61"],"\x07"=>[16,"\xD61"],"\x08"=>[94,"\xD62"],"\x09"=>[76,"\xD62"],"\x0A"=>[104,"\xD62"],"\x0B"=>[16,"\xD62"],"\x0C"=>[94,"\xD6a"],"\x0D"=>[76,"\xD6a"],"\x0E"=>[104,"\xD6a"],"\x0F"=>[16,"\xD6a"],"\x10"=>[94,"\xD6c"],"\x11"=>[76,"\xD6c"],"\x12"=>[104,"\xD6c"],"\x13"=>[16,"\xD6c"],"\x14"=>[94,"\xD6e"],"\x15"=>[76,"\xD6e"],"\x16"=>[104,"\xD6e"],"\x17"=>[16,"\xD6e"],"\x18"=>[94,"\xD6i"],"\x19"=>[76,"\xD6i"],"\x1A"=>[104,"\xD6i"],"\x1B"=>[16,"\xD6i"],"\x1C"=>[94,"\xD6o"],"\x1D"=>[76,"\xD6o"],"\x1E"=>[104,"\xD6o"],"\x1F"=>[16,"\xD6o"],"\x20"=>[94,"\xD6s"],"\x21"=>[76,"\xD6s"],"\x22"=>[104,"\xD6s"],"\x23"=>[16,"\xD6s"],"\x24"=>[94,"\xD6t"],"\x25"=>[76,"\xD6t"],"\x26"=>[104,"\xD6t"],"\x27"=>[16,"\xD6t"],"\x28"=>[77,"\xD6\x20"],"\x29"=>[18,"\xD6\x20"],"\x2A"=>[77,"\xD6\x25"],"\x2B"=>[18,"\xD6\x25"],"\x2C"=>[77,"\xD6-"],"-"=>[18,"\xD6-"],"."=>[77,"\xD6."],"\x2F"=>[18,"\xD6."],[77,"\xD6\x2F"],[18,"\xD6\x2F"],[77,"\xD63"],[18,"\xD63"],[77,"\xD64"],[18,"\xD64"],[77,"\xD65"],[18,"\xD65"],[77,"\xD66"],[18,"\xD66"],"\x3A"=>[77,"\xD67"],"\x3B"=>[18,"\xD67"],"\x3C"=>[77,"\xD68"],"\x3D"=>[18,"\xD68"],"\x3E"=>[77,"\xD69"],"\x3F"=>[18,"\xD69"],"\x40"=>[77,"\xD6\x3D"],"A"=>[18,"\xD6\x3D"],"B"=>[77,"\xD6A"],"C"=>[18,"\xD6A"],"D"=>[77,"\xD6_"],"E"=>[18,"\xD6_"],"F"=>[77,"\xD6b"],"G"=>[18,"\xD6b"],"H"=>[77,"\xD6d"],"I"=>[18,"\xD6d"],"J"=>[77,"\xD6f"],"K"=>[18,"\xD6f"],"L"=>[77,"\xD6g"],"M"=>[18,"\xD6g"],"N"=>[77,"\xD6h"],"O"=>[18,"\xD6h"],"P"=>[77,"\xD6l"],"Q"=>[18,"\xD6l"],"R"=>[77,"\xD6m"],"S"=>[18,"\xD6m"],"T"=>[77,"\xD6n"],"U"=>[18,"\xD6n"],"V"=>[77,"\xD6p"],"W"=>[18,"\xD6p"],"X"=>[77,"\xD6r"],"Y"=>[18,"\xD6r"],"Z"=>[77,"\xD6u"],"\x5B"=>[18,"\xD6u"],"\x5C"=>[0,"\xD6\x3A"],"\x5D"=>[0,"\xD6B"],"\x5E"=>[0,"\xD6C"],"_"=>[0,"\xD6D"],"\x60"=>[0,"\xD6E"],"a"=>[0,"\xD6F"],"b"=>[0,"\xD6G"],"c"=>[0,"\xD6H"],"d"=>[0,"\xD6I"],"e"=>[0,"\xD6J"],"f"=>[0,"\xD6K"],"g"=>[0,"\xD6L"],"h"=>[0,"\xD6M"],"i"=>[0,"\xD6N"],"j"=>[0,"\xD6O"],"k"=>[0,"\xD6P"],"l"=>[0,"\xD6Q"],"m"=>[0,"\xD6R"],"n"=>[0,"\xD6S"],"o"=>[0,"\xD6T"],"p"=>[0,"\xD6U"],"q"=>[0,"\xD6V"],"r"=>[0,"\xD6W"],"s"=>[0,"\xD6Y"],"t"=>[0,"\xD6j"],"u"=>[0,"\xD6k"],"v"=>[0,"\xD6q"],"w"=>[0,"\xD6v"],"x"=>[0,"\xD6w"],"y"=>[0,"\xD6x"],"z"=>[0,"\xD6y"],"\x7B"=>[0,"\xD6z"],"\x7C"=>[82,"\xD6"],"\x7D"=>[87,"\xD6"],"~"=>[130,"\xD6"],"\x7F"=>[9,"\xD6"],"\x80"=>[94,"\xDD0"],"\x81"=>[76,"\xDD0"],"\x82"=>[104,"\xDD0"],"\x83"=>[16,"\xDD0"],"\x84"=>[94,"\xDD1"],"\x85"=>[76,"\xDD1"],"\x86"=>[104,"\xDD1"],"\x87"=>[16,"\xDD1"],"\x88"=>[94,"\xDD2"],"\x89"=>[76,"\xDD2"],"\x8A"=>[104,"\xDD2"],"\x8B"=>[16,"\xDD2"],"\x8C"=>[94,"\xDDa"],"\x8D"=>[76,"\xDDa"],"\x8E"=>[104,"\xDDa"],"\x8F"=>[16,"\xDDa"],"\x90"=>[94,"\xDDc"],"\x91"=>[76,"\xDDc"],"\x92"=>[104,"\xDDc"],"\x93"=>[16,"\xDDc"],"\x94"=>[94,"\xDDe"],"\x95"=>[76,"\xDDe"],"\x96"=>[104,"\xDDe"],"\x97"=>[16,"\xDDe"],"\x98"=>[94,"\xDDi"],"\x99"=>[76,"\xDDi"],"\x9A"=>[104,"\xDDi"],"\x9B"=>[16,"\xDDi"],"\x9C"=>[94,"\xDDo"],"\x9D"=>[76,"\xDDo"],"\x9E"=>[104,"\xDDo"],"\x9F"=>[16,"\xDDo"],"\xA0"=>[94,"\xDDs"],"\xA1"=>[76,"\xDDs"],"\xA2"=>[104,"\xDDs"],"\xA3"=>[16,"\xDDs"],"\xA4"=>[94,"\xDDt"],"\xA5"=>[76,"\xDDt"],"\xA6"=>[104,"\xDDt"],"\xA7"=>[16,"\xDDt"],"\xA8"=>[77,"\xDD\x20"],"\xA9"=>[18,"\xDD\x20"],"\xAA"=>[77,"\xDD\x25"],"\xAB"=>[18,"\xDD\x25"],"\xAC"=>[77,"\xDD-"],"\xAD"=>[18,"\xDD-"],"\xAE"=>[77,"\xDD."],"\xAF"=>[18,"\xDD."],"\xB0"=>[77,"\xDD\x2F"],"\xB1"=>[18,"\xDD\x2F"],"\xB2"=>[77,"\xDD3"],"\xB3"=>[18,"\xDD3"],"\xB4"=>[77,"\xDD4"],"\xB5"=>[18,"\xDD4"],"\xB6"=>[77,"\xDD5"],"\xB7"=>[18,"\xDD5"],"\xB8"=>[77,"\xDD6"],"\xB9"=>[18,"\xDD6"],"\xBA"=>[77,"\xDD7"],"\xBB"=>[18,"\xDD7"],"\xBC"=>[77,"\xDD8"],"\xBD"=>[18,"\xDD8"],"\xBE"=>[77,"\xDD9"],"\xBF"=>[18,"\xDD9"],"\xC0"=>[77,"\xDD\x3D"],"\xC1"=>[18,"\xDD\x3D"],"\xC2"=>[77,"\xDDA"],"\xC3"=>[18,"\xDDA"],"\xC4"=>[77,"\xDD_"],"\xC5"=>[18,"\xDD_"],"\xC6"=>[77,"\xDDb"],"\xC7"=>[18,"\xDDb"],"\xC8"=>[77,"\xDDd"],"\xC9"=>[18,"\xDDd"],"\xCA"=>[77,"\xDDf"],"\xCB"=>[18,"\xDDf"],"\xCC"=>[77,"\xDDg"],"\xCD"=>[18,"\xDDg"],"\xCE"=>[77,"\xDDh"],"\xCF"=>[18,"\xDDh"],"\xD0"=>[77,"\xDDl"],"\xD1"=>[18,"\xDDl"],"\xD2"=>[77,"\xDDm"],"\xD3"=>[18,"\xDDm"],"\xD4"=>[77,"\xDDn"],"\xD5"=>[18,"\xDDn"],"\xD6"=>[77,"\xDDp"],"\xD7"=>[18,"\xDDp"],"\xD8"=>[77,"\xDDr"],"\xD9"=>[18,"\xDDr"],"\xDA"=>[77,"\xDDu"],"\xDB"=>[18,"\xDDu"],"\xDC"=>[0,"\xDD\x3A"],"\xDD"=>[0,"\xDDB"],"\xDE"=>[0,"\xDDC"],"\xDF"=>[0,"\xDDD"],"\xE0"=>[0,"\xDDE"],"\xE1"=>[0,"\xDDF"],"\xE2"=>[0,"\xDDG"],"\xE3"=>[0,"\xDDH"],"\xE4"=>[0,"\xDDI"],"\xE5"=>[0,"\xDDJ"],"\xE6"=>[0,"\xDDK"],"\xE7"=>[0,"\xDDL"],"\xE8"=>[0,"\xDDM"],"\xE9"=>[0,"\xDDN"],"\xEA"=>[0,"\xDDO"],"\xEB"=>[0,"\xDDP"],"\xEC"=>[0,"\xDDQ"],"\xED"=>[0,"\xDDR"],"\xEE"=>[0,"\xDDS"],"\xEF"=>[0,"\xDDT"],"\xF0"=>[0,"\xDDU"],"\xF1"=>[0,"\xDDV"],"\xF2"=>[0,"\xDDW"],"\xF3"=>[0,"\xDDY"],"\xF4"=>[0,"\xDDj"],"\xF5"=>[0,"\xDDk"],"\xF6"=>[0,"\xDDq"],"\xF7"=>[0,"\xDDv"],"\xF8"=>[0,"\xDDw"],"\xF9"=>[0,"\xDDx"],"\xFA"=>[0,"\xDDy"],"\xFB"=>[0,"\xDDz"],"\xFC"=>[82,"\xDD"],"\xFD"=>[87,"\xDD"],"\xFE"=>[130,"\xDD"],"\xFF"=>[9,"\xDD"],],["\x00"=>[94,"\xD70"],"\x01"=>[76,"\xD70"],"\x02"=>[104,"\xD70"],"\x03"=>[16,"\xD70"],"\x04"=>[94,"\xD71"],"\x05"=>[76,"\xD71"],"\x06"=>[104,"\xD71"],"\x07"=>[16,"\xD71"],"\x08"=>[94,"\xD72"],"\x09"=>[76,"\xD72"],"\x0A"=>[104,"\xD72"],"\x0B"=>[16,"\xD72"],"\x0C"=>[94,"\xD7a"],"\x0D"=>[76,"\xD7a"],"\x0E"=>[104,"\xD7a"],"\x0F"=>[16,"\xD7a"],"\x10"=>[94,"\xD7c"],"\x11"=>[76,"\xD7c"],"\x12"=>[104,"\xD7c"],"\x13"=>[16,"\xD7c"],"\x14"=>[94,"\xD7e"],"\x15"=>[76,"\xD7e"],"\x16"=>[104,"\xD7e"],"\x17"=>[16,"\xD7e"],"\x18"=>[94,"\xD7i"],"\x19"=>[76,"\xD7i"],"\x1A"=>[104,"\xD7i"],"\x1B"=>[16,"\xD7i"],"\x1C"=>[94,"\xD7o"],"\x1D"=>[76,"\xD7o"],"\x1E"=>[104,"\xD7o"],"\x1F"=>[16,"\xD7o"],"\x20"=>[94,"\xD7s"],"\x21"=>[76,"\xD7s"],"\x22"=>[104,"\xD7s"],"\x23"=>[16,"\xD7s"],"\x24"=>[94,"\xD7t"],"\x25"=>[76,"\xD7t"],"\x26"=>[104,"\xD7t"],"\x27"=>[16,"\xD7t"],"\x28"=>[77,"\xD7\x20"],"\x29"=>[18,"\xD7\x20"],"\x2A"=>[77,"\xD7\x25"],"\x2B"=>[18,"\xD7\x25"],"\x2C"=>[77,"\xD7-"],"-"=>[18,"\xD7-"],"."=>[77,"\xD7."],"\x2F"=>[18,"\xD7."],[77,"\xD7\x2F"],[18,"\xD7\x2F"],[77,"\xD73"],[18,"\xD73"],[77,"\xD74"],[18,"\xD74"],[77,"\xD75"],[18,"\xD75"],[77,"\xD76"],[18,"\xD76"],"\x3A"=>[77,"\xD77"],"\x3B"=>[18,"\xD77"],"\x3C"=>[77,"\xD78"],"\x3D"=>[18,"\xD78"],"\x3E"=>[77,"\xD79"],"\x3F"=>[18,"\xD79"],"\x40"=>[77,"\xD7\x3D"],"A"=>[18,"\xD7\x3D"],"B"=>[77,"\xD7A"],"C"=>[18,"\xD7A"],"D"=>[77,"\xD7_"],"E"=>[18,"\xD7_"],"F"=>[77,"\xD7b"],"G"=>[18,"\xD7b"],"H"=>[77,"\xD7d"],"I"=>[18,"\xD7d"],"J"=>[77,"\xD7f"],"K"=>[18,"\xD7f"],"L"=>[77,"\xD7g"],"M"=>[18,"\xD7g"],"N"=>[77,"\xD7h"],"O"=>[18,"\xD7h"],"P"=>[77,"\xD7l"],"Q"=>[18,"\xD7l"],"R"=>[77,"\xD7m"],"S"=>[18,"\xD7m"],"T"=>[77,"\xD7n"],"U"=>[18,"\xD7n"],"V"=>[77,"\xD7p"],"W"=>[18,"\xD7p"],"X"=>[77,"\xD7r"],"Y"=>[18,"\xD7r"],"Z"=>[77,"\xD7u"],"\x5B"=>[18,"\xD7u"],"\x5C"=>[0,"\xD7\x3A"],"\x5D"=>[0,"\xD7B"],"\x5E"=>[0,"\xD7C"],"_"=>[0,"\xD7D"],"\x60"=>[0,"\xD7E"],"a"=>[0,"\xD7F"],"b"=>[0,"\xD7G"],"c"=>[0,"\xD7H"],"d"=>[0,"\xD7I"],"e"=>[0,"\xD7J"],"f"=>[0,"\xD7K"],"g"=>[0,"\xD7L"],"h"=>[0,"\xD7M"],"i"=>[0,"\xD7N"],"j"=>[0,"\xD7O"],"k"=>[0,"\xD7P"],"l"=>[0,"\xD7Q"],"m"=>[0,"\xD7R"],"n"=>[0,"\xD7S"],"o"=>[0,"\xD7T"],"p"=>[0,"\xD7U"],"q"=>[0,"\xD7V"],"r"=>[0,"\xD7W"],"s"=>[0,"\xD7Y"],"t"=>[0,"\xD7j"],"u"=>[0,"\xD7k"],"v"=>[0,"\xD7q"],"w"=>[0,"\xD7v"],"x"=>[0,"\xD7w"],"y"=>[0,"\xD7x"],"z"=>[0,"\xD7y"],"\x7B"=>[0,"\xD7z"],"\x7C"=>[82,"\xD7"],"\x7D"=>[87,"\xD7"],"~"=>[130,"\xD7"],"\x7F"=>[9,"\xD7"],"\x80"=>[94,"\xE10"],"\x81"=>[76,"\xE10"],"\x82"=>[104,"\xE10"],"\x83"=>[16,"\xE10"],"\x84"=>[94,"\xE11"],"\x85"=>[76,"\xE11"],"\x86"=>[104,"\xE11"],"\x87"=>[16,"\xE11"],"\x88"=>[94,"\xE12"],"\x89"=>[76,"\xE12"],"\x8A"=>[104,"\xE12"],"\x8B"=>[16,"\xE12"],"\x8C"=>[94,"\xE1a"],"\x8D"=>[76,"\xE1a"],"\x8E"=>[104,"\xE1a"],"\x8F"=>[16,"\xE1a"],"\x90"=>[94,"\xE1c"],"\x91"=>[76,"\xE1c"],"\x92"=>[104,"\xE1c"],"\x93"=>[16,"\xE1c"],"\x94"=>[94,"\xE1e"],"\x95"=>[76,"\xE1e"],"\x96"=>[104,"\xE1e"],"\x97"=>[16,"\xE1e"],"\x98"=>[94,"\xE1i"],"\x99"=>[76,"\xE1i"],"\x9A"=>[104,"\xE1i"],"\x9B"=>[16,"\xE1i"],"\x9C"=>[94,"\xE1o"],"\x9D"=>[76,"\xE1o"],"\x9E"=>[104,"\xE1o"],"\x9F"=>[16,"\xE1o"],"\xA0"=>[94,"\xE1s"],"\xA1"=>[76,"\xE1s"],"\xA2"=>[104,"\xE1s"],"\xA3"=>[16,"\xE1s"],"\xA4"=>[94,"\xE1t"],"\xA5"=>[76,"\xE1t"],"\xA6"=>[104,"\xE1t"],"\xA7"=>[16,"\xE1t"],"\xA8"=>[77,"\xE1\x20"],"\xA9"=>[18,"\xE1\x20"],"\xAA"=>[77,"\xE1\x25"],"\xAB"=>[18,"\xE1\x25"],"\xAC"=>[77,"\xE1-"],"\xAD"=>[18,"\xE1-"],"\xAE"=>[77,"\xE1."],"\xAF"=>[18,"\xE1."],"\xB0"=>[77,"\xE1\x2F"],"\xB1"=>[18,"\xE1\x2F"],"\xB2"=>[77,"\xE13"],"\xB3"=>[18,"\xE13"],"\xB4"=>[77,"\xE14"],"\xB5"=>[18,"\xE14"],"\xB6"=>[77,"\xE15"],"\xB7"=>[18,"\xE15"],"\xB8"=>[77,"\xE16"],"\xB9"=>[18,"\xE16"],"\xBA"=>[77,"\xE17"],"\xBB"=>[18,"\xE17"],"\xBC"=>[77,"\xE18"],"\xBD"=>[18,"\xE18"],"\xBE"=>[77,"\xE19"],"\xBF"=>[18,"\xE19"],"\xC0"=>[77,"\xE1\x3D"],"\xC1"=>[18,"\xE1\x3D"],"\xC2"=>[77,"\xE1A"],"\xC3"=>[18,"\xE1A"],"\xC4"=>[77,"\xE1_"],"\xC5"=>[18,"\xE1_"],"\xC6"=>[77,"\xE1b"],"\xC7"=>[18,"\xE1b"],"\xC8"=>[77,"\xE1d"],"\xC9"=>[18,"\xE1d"],"\xCA"=>[77,"\xE1f"],"\xCB"=>[18,"\xE1f"],"\xCC"=>[77,"\xE1g"],"\xCD"=>[18,"\xE1g"],"\xCE"=>[77,"\xE1h"],"\xCF"=>[18,"\xE1h"],"\xD0"=>[77,"\xE1l"],"\xD1"=>[18,"\xE1l"],"\xD2"=>[77,"\xE1m"],"\xD3"=>[18,"\xE1m"],"\xD4"=>[77,"\xE1n"],"\xD5"=>[18,"\xE1n"],"\xD6"=>[77,"\xE1p"],"\xD7"=>[18,"\xE1p"],"\xD8"=>[77,"\xE1r"],"\xD9"=>[18,"\xE1r"],"\xDA"=>[77,"\xE1u"],"\xDB"=>[18,"\xE1u"],"\xDC"=>[0,"\xE1\x3A"],"\xDD"=>[0,"\xE1B"],"\xDE"=>[0,"\xE1C"],"\xDF"=>[0,"\xE1D"],"\xE0"=>[0,"\xE1E"],"\xE1"=>[0,"\xE1F"],"\xE2"=>[0,"\xE1G"],"\xE3"=>[0,"\xE1H"],"\xE4"=>[0,"\xE1I"],"\xE5"=>[0,"\xE1J"],"\xE6"=>[0,"\xE1K"],"\xE7"=>[0,"\xE1L"],"\xE8"=>[0,"\xE1M"],"\xE9"=>[0,"\xE1N"],"\xEA"=>[0,"\xE1O"],"\xEB"=>[0,"\xE1P"],"\xEC"=>[0,"\xE1Q"],"\xED"=>[0,"\xE1R"],"\xEE"=>[0,"\xE1S"],"\xEF"=>[0,"\xE1T"],"\xF0"=>[0,"\xE1U"],"\xF1"=>[0,"\xE1V"],"\xF2"=>[0,"\xE1W"],"\xF3"=>[0,"\xE1Y"],"\xF4"=>[0,"\xE1j"],"\xF5"=>[0,"\xE1k"],"\xF6"=>[0,"\xE1q"],"\xF7"=>[0,"\xE1v"],"\xF8"=>[0,"\xE1w"],"\xF9"=>[0,"\xE1x"],"\xFA"=>[0,"\xE1y"],"\xFB"=>[0,"\xE1z"],"\xFC"=>[82,"\xE1"],"\xFD"=>[87,"\xE1"],"\xFE"=>[130,"\xE1"],"\xFF"=>[9,"\xE1"],],["\x00"=>[94,"\xD80"],"\x01"=>[76,"\xD80"],"\x02"=>[104,"\xD80"],"\x03"=>[16,"\xD80"],"\x04"=>[94,"\xD81"],"\x05"=>[76,"\xD81"],"\x06"=>[104,"\xD81"],"\x07"=>[16,"\xD81"],"\x08"=>[94,"\xD82"],"\x09"=>[76,"\xD82"],"\x0A"=>[104,"\xD82"],"\x0B"=>[16,"\xD82"],"\x0C"=>[94,"\xD8a"],"\x0D"=>[76,"\xD8a"],"\x0E"=>[104,"\xD8a"],"\x0F"=>[16,"\xD8a"],"\x10"=>[94,"\xD8c"],"\x11"=>[76,"\xD8c"],"\x12"=>[104,"\xD8c"],"\x13"=>[16,"\xD8c"],"\x14"=>[94,"\xD8e"],"\x15"=>[76,"\xD8e"],"\x16"=>[104,"\xD8e"],"\x17"=>[16,"\xD8e"],"\x18"=>[94,"\xD8i"],"\x19"=>[76,"\xD8i"],"\x1A"=>[104,"\xD8i"],"\x1B"=>[16,"\xD8i"],"\x1C"=>[94,"\xD8o"],"\x1D"=>[76,"\xD8o"],"\x1E"=>[104,"\xD8o"],"\x1F"=>[16,"\xD8o"],"\x20"=>[94,"\xD8s"],"\x21"=>[76,"\xD8s"],"\x22"=>[104,"\xD8s"],"\x23"=>[16,"\xD8s"],"\x24"=>[94,"\xD8t"],"\x25"=>[76,"\xD8t"],"\x26"=>[104,"\xD8t"],"\x27"=>[16,"\xD8t"],"\x28"=>[77,"\xD8\x20"],"\x29"=>[18,"\xD8\x20"],"\x2A"=>[77,"\xD8\x25"],"\x2B"=>[18,"\xD8\x25"],"\x2C"=>[77,"\xD8-"],"-"=>[18,"\xD8-"],"."=>[77,"\xD8."],"\x2F"=>[18,"\xD8."],[77,"\xD8\x2F"],[18,"\xD8\x2F"],[77,"\xD83"],[18,"\xD83"],[77,"\xD84"],[18,"\xD84"],[77,"\xD85"],[18,"\xD85"],[77,"\xD86"],[18,"\xD86"],"\x3A"=>[77,"\xD87"],"\x3B"=>[18,"\xD87"],"\x3C"=>[77,"\xD88"],"\x3D"=>[18,"\xD88"],"\x3E"=>[77,"\xD89"],"\x3F"=>[18,"\xD89"],"\x40"=>[77,"\xD8\x3D"],"A"=>[18,"\xD8\x3D"],"B"=>[77,"\xD8A"],"C"=>[18,"\xD8A"],"D"=>[77,"\xD8_"],"E"=>[18,"\xD8_"],"F"=>[77,"\xD8b"],"G"=>[18,"\xD8b"],"H"=>[77,"\xD8d"],"I"=>[18,"\xD8d"],"J"=>[77,"\xD8f"],"K"=>[18,"\xD8f"],"L"=>[77,"\xD8g"],"M"=>[18,"\xD8g"],"N"=>[77,"\xD8h"],"O"=>[18,"\xD8h"],"P"=>[77,"\xD8l"],"Q"=>[18,"\xD8l"],"R"=>[77,"\xD8m"],"S"=>[18,"\xD8m"],"T"=>[77,"\xD8n"],"U"=>[18,"\xD8n"],"V"=>[77,"\xD8p"],"W"=>[18,"\xD8p"],"X"=>[77,"\xD8r"],"Y"=>[18,"\xD8r"],"Z"=>[77,"\xD8u"],"\x5B"=>[18,"\xD8u"],"\x5C"=>[0,"\xD8\x3A"],"\x5D"=>[0,"\xD8B"],"\x5E"=>[0,"\xD8C"],"_"=>[0,"\xD8D"],"\x60"=>[0,"\xD8E"],"a"=>[0,"\xD8F"],"b"=>[0,"\xD8G"],"c"=>[0,"\xD8H"],"d"=>[0,"\xD8I"],"e"=>[0,"\xD8J"],"f"=>[0,"\xD8K"],"g"=>[0,"\xD8L"],"h"=>[0,"\xD8M"],"i"=>[0,"\xD8N"],"j"=>[0,"\xD8O"],"k"=>[0,"\xD8P"],"l"=>[0,"\xD8Q"],"m"=>[0,"\xD8R"],"n"=>[0,"\xD8S"],"o"=>[0,"\xD8T"],"p"=>[0,"\xD8U"],"q"=>[0,"\xD8V"],"r"=>[0,"\xD8W"],"s"=>[0,"\xD8Y"],"t"=>[0,"\xD8j"],"u"=>[0,"\xD8k"],"v"=>[0,"\xD8q"],"w"=>[0,"\xD8v"],"x"=>[0,"\xD8w"],"y"=>[0,"\xD8x"],"z"=>[0,"\xD8y"],"\x7B"=>[0,"\xD8z"],"\x7C"=>[82,"\xD8"],"\x7D"=>[87,"\xD8"],"~"=>[130,"\xD8"],"\x7F"=>[9,"\xD8"],"\x80"=>[94,"\xD90"],"\x81"=>[76,"\xD90"],"\x82"=>[104,"\xD90"],"\x83"=>[16,"\xD90"],"\x84"=>[94,"\xD91"],"\x85"=>[76,"\xD91"],"\x86"=>[104,"\xD91"],"\x87"=>[16,"\xD91"],"\x88"=>[94,"\xD92"],"\x89"=>[76,"\xD92"],"\x8A"=>[104,"\xD92"],"\x8B"=>[16,"\xD92"],"\x8C"=>[94,"\xD9a"],"\x8D"=>[76,"\xD9a"],"\x8E"=>[104,"\xD9a"],"\x8F"=>[16,"\xD9a"],"\x90"=>[94,"\xD9c"],"\x91"=>[76,"\xD9c"],"\x92"=>[104,"\xD9c"],"\x93"=>[16,"\xD9c"],"\x94"=>[94,"\xD9e"],"\x95"=>[76,"\xD9e"],"\x96"=>[104,"\xD9e"],"\x97"=>[16,"\xD9e"],"\x98"=>[94,"\xD9i"],"\x99"=>[76,"\xD9i"],"\x9A"=>[104,"\xD9i"],"\x9B"=>[16,"\xD9i"],"\x9C"=>[94,"\xD9o"],"\x9D"=>[76,"\xD9o"],"\x9E"=>[104,"\xD9o"],"\x9F"=>[16,"\xD9o"],"\xA0"=>[94,"\xD9s"],"\xA1"=>[76,"\xD9s"],"\xA2"=>[104,"\xD9s"],"\xA3"=>[16,"\xD9s"],"\xA4"=>[94,"\xD9t"],"\xA5"=>[76,"\xD9t"],"\xA6"=>[104,"\xD9t"],"\xA7"=>[16,"\xD9t"],"\xA8"=>[77,"\xD9\x20"],"\xA9"=>[18,"\xD9\x20"],"\xAA"=>[77,"\xD9\x25"],"\xAB"=>[18,"\xD9\x25"],"\xAC"=>[77,"\xD9-"],"\xAD"=>[18,"\xD9-"],"\xAE"=>[77,"\xD9."],"\xAF"=>[18,"\xD9."],"\xB0"=>[77,"\xD9\x2F"],"\xB1"=>[18,"\xD9\x2F"],"\xB2"=>[77,"\xD93"],"\xB3"=>[18,"\xD93"],"\xB4"=>[77,"\xD94"],"\xB5"=>[18,"\xD94"],"\xB6"=>[77,"\xD95"],"\xB7"=>[18,"\xD95"],"\xB8"=>[77,"\xD96"],"\xB9"=>[18,"\xD96"],"\xBA"=>[77,"\xD97"],"\xBB"=>[18,"\xD97"],"\xBC"=>[77,"\xD98"],"\xBD"=>[18,"\xD98"],"\xBE"=>[77,"\xD99"],"\xBF"=>[18,"\xD99"],"\xC0"=>[77,"\xD9\x3D"],"\xC1"=>[18,"\xD9\x3D"],"\xC2"=>[77,"\xD9A"],"\xC3"=>[18,"\xD9A"],"\xC4"=>[77,"\xD9_"],"\xC5"=>[18,"\xD9_"],"\xC6"=>[77,"\xD9b"],"\xC7"=>[18,"\xD9b"],"\xC8"=>[77,"\xD9d"],"\xC9"=>[18,"\xD9d"],"\xCA"=>[77,"\xD9f"],"\xCB"=>[18,"\xD9f"],"\xCC"=>[77,"\xD9g"],"\xCD"=>[18,"\xD9g"],"\xCE"=>[77,"\xD9h"],"\xCF"=>[18,"\xD9h"],"\xD0"=>[77,"\xD9l"],"\xD1"=>[18,"\xD9l"],"\xD2"=>[77,"\xD9m"],"\xD3"=>[18,"\xD9m"],"\xD4"=>[77,"\xD9n"],"\xD5"=>[18,"\xD9n"],"\xD6"=>[77,"\xD9p"],"\xD7"=>[18,"\xD9p"],"\xD8"=>[77,"\xD9r"],"\xD9"=>[18,"\xD9r"],"\xDA"=>[77,"\xD9u"],"\xDB"=>[18,"\xD9u"],"\xDC"=>[0,"\xD9\x3A"],"\xDD"=>[0,"\xD9B"],"\xDE"=>[0,"\xD9C"],"\xDF"=>[0,"\xD9D"],"\xE0"=>[0,"\xD9E"],"\xE1"=>[0,"\xD9F"],"\xE2"=>[0,"\xD9G"],"\xE3"=>[0,"\xD9H"],"\xE4"=>[0,"\xD9I"],"\xE5"=>[0,"\xD9J"],"\xE6"=>[0,"\xD9K"],"\xE7"=>[0,"\xD9L"],"\xE8"=>[0,"\xD9M"],"\xE9"=>[0,"\xD9N"],"\xEA"=>[0,"\xD9O"],"\xEB"=>[0,"\xD9P"],"\xEC"=>[0,"\xD9Q"],"\xED"=>[0,"\xD9R"],"\xEE"=>[0,"\xD9S"],"\xEF"=>[0,"\xD9T"],"\xF0"=>[0,"\xD9U"],"\xF1"=>[0,"\xD9V"],"\xF2"=>[0,"\xD9W"],"\xF3"=>[0,"\xD9Y"],"\xF4"=>[0,"\xD9j"],"\xF5"=>[0,"\xD9k"],"\xF6"=>[0,"\xD9q"],"\xF7"=>[0,"\xD9v"],"\xF8"=>[0,"\xD9w"],"\xF9"=>[0,"\xD9x"],"\xFA"=>[0,"\xD9y"],"\xFB"=>[0,"\xD9z"],"\xFC"=>[82,"\xD9"],"\xFD"=>[87,"\xD9"],"\xFE"=>[130,"\xD9"],"\xFF"=>[9,"\xD9"],],["\x00"=>[77,"\xD80"],"\x01"=>[18,"\xD80"],"\x02"=>[77,"\xD81"],"\x03"=>[18,"\xD81"],"\x04"=>[77,"\xD82"],"\x05"=>[18,"\xD82"],"\x06"=>[77,"\xD8a"],"\x07"=>[18,"\xD8a"],"\x08"=>[77,"\xD8c"],"\x09"=>[18,"\xD8c"],"\x0A"=>[77,"\xD8e"],"\x0B"=>[18,"\xD8e"],"\x0C"=>[77,"\xD8i"],"\x0D"=>[18,"\xD8i"],"\x0E"=>[77,"\xD8o"],"\x0F"=>[18,"\xD8o"],"\x10"=>[77,"\xD8s"],"\x11"=>[18,"\xD8s"],"\x12"=>[77,"\xD8t"],"\x13"=>[18,"\xD8t"],"\x14"=>[0,"\xD8\x20"],"\x15"=>[0,"\xD8\x25"],"\x16"=>[0,"\xD8-"],"\x17"=>[0,"\xD8."],"\x18"=>[0,"\xD8\x2F"],"\x19"=>[0,"\xD83"],"\x1A"=>[0,"\xD84"],"\x1B"=>[0,"\xD85"],"\x1C"=>[0,"\xD86"],"\x1D"=>[0,"\xD87"],"\x1E"=>[0,"\xD88"],"\x1F"=>[0,"\xD89"],"\x20"=>[0,"\xD8\x3D"],"\x21"=>[0,"\xD8A"],"\x22"=>[0,"\xD8_"],"\x23"=>[0,"\xD8b"],"\x24"=>[0,"\xD8d"],"\x25"=>[0,"\xD8f"],"\x26"=>[0,"\xD8g"],"\x27"=>[0,"\xD8h"],"\x28"=>[0,"\xD8l"],"\x29"=>[0,"\xD8m"],"\x2A"=>[0,"\xD8n"],"\x2B"=>[0,"\xD8p"],"\x2C"=>[0,"\xD8r"],"-"=>[0,"\xD8u"],"."=>[100,"\xD8"],"\x2F"=>[110,"\xD8"],[111,"\xD8"],[115,"\xD8"],[116,"\xD8"],[118,"\xD8"],[119,"\xD8"],[122,"\xD8"],[123,"\xD8"],[125,"\xD8"],[126,"\xD8"],[129,"\xD8"],"\x3A"=>[143,"\xD8"],"\x3B"=>[148,"\xD8"],"\x3C"=>[151,"\xD8"],"\x3D"=>[153,"\xD8"],"\x3E"=>[83,"\xD8"],"\x3F"=>[10,"\xD8"],"\x40"=>[77,"\xD90"],"A"=>[18,"\xD90"],"B"=>[77,"\xD91"],"C"=>[18,"\xD91"],"D"=>[77,"\xD92"],"E"=>[18,"\xD92"],"F"=>[77,"\xD9a"],"G"=>[18,"\xD9a"],"H"=>[77,"\xD9c"],"I"=>[18,"\xD9c"],"J"=>[77,"\xD9e"],"K"=>[18,"\xD9e"],"L"=>[77,"\xD9i"],"M"=>[18,"\xD9i"],"N"=>[77,"\xD9o"],"O"=>[18,"\xD9o"],"P"=>[77,"\xD9s"],"Q"=>[18,"\xD9s"],"R"=>[77,"\xD9t"],"S"=>[18,"\xD9t"],"T"=>[0,"\xD9\x20"],"U"=>[0,"\xD9\x25"],"V"=>[0,"\xD9-"],"W"=>[0,"\xD9."],"X"=>[0,"\xD9\x2F"],"Y"=>[0,"\xD93"],"Z"=>[0,"\xD94"],"\x5B"=>[0,"\xD95"],"\x5C"=>[0,"\xD96"],"\x5D"=>[0,"\xD97"],"\x5E"=>[0,"\xD98"],"_"=>[0,"\xD99"],"\x60"=>[0,"\xD9\x3D"],"a"=>[0,"\xD9A"],"b"=>[0,"\xD9_"],"c"=>[0,"\xD9b"],"d"=>[0,"\xD9d"],"e"=>[0,"\xD9f"],"f"=>[0,"\xD9g"],"g"=>[0,"\xD9h"],"h"=>[0,"\xD9l"],"i"=>[0,"\xD9m"],"j"=>[0,"\xD9n"],"k"=>[0,"\xD9p"],"l"=>[0,"\xD9r"],"m"=>[0,"\xD9u"],"n"=>[100,"\xD9"],"o"=>[110,"\xD9"],"p"=>[111,"\xD9"],"q"=>[115,"\xD9"],"r"=>[116,"\xD9"],"s"=>[118,"\xD9"],"t"=>[119,"\xD9"],"u"=>[122,"\xD9"],"v"=>[123,"\xD9"],"w"=>[125,"\xD9"],"x"=>[126,"\xD9"],"y"=>[129,"\xD9"],"z"=>[143,"\xD9"],"\x7B"=>[148,"\xD9"],"\x7C"=>[151,"\xD9"],"\x7D"=>[153,"\xD9"],"~"=>[83,"\xD9"],"\x7F"=>[10,"\xD9"],"\x80"=>[77,"\xE30"],"\x81"=>[18,"\xE30"],"\x82"=>[77,"\xE31"],"\x83"=>[18,"\xE31"],"\x84"=>[77,"\xE32"],"\x85"=>[18,"\xE32"],"\x86"=>[77,"\xE3a"],"\x87"=>[18,"\xE3a"],"\x88"=>[77,"\xE3c"],"\x89"=>[18,"\xE3c"],"\x8A"=>[77,"\xE3e"],"\x8B"=>[18,"\xE3e"],"\x8C"=>[77,"\xE3i"],"\x8D"=>[18,"\xE3i"],"\x8E"=>[77,"\xE3o"],"\x8F"=>[18,"\xE3o"],"\x90"=>[77,"\xE3s"],"\x91"=>[18,"\xE3s"],"\x92"=>[77,"\xE3t"],"\x93"=>[18,"\xE3t"],"\x94"=>[0,"\xE3\x20"],"\x95"=>[0,"\xE3\x25"],"\x96"=>[0,"\xE3-"],"\x97"=>[0,"\xE3."],"\x98"=>[0,"\xE3\x2F"],"\x99"=>[0,"\xE33"],"\x9A"=>[0,"\xE34"],"\x9B"=>[0,"\xE35"],"\x9C"=>[0,"\xE36"],"\x9D"=>[0,"\xE37"],"\x9E"=>[0,"\xE38"],"\x9F"=>[0,"\xE39"],"\xA0"=>[0,"\xE3\x3D"],"\xA1"=>[0,"\xE3A"],"\xA2"=>[0,"\xE3_"],"\xA3"=>[0,"\xE3b"],"\xA4"=>[0,"\xE3d"],"\xA5"=>[0,"\xE3f"],"\xA6"=>[0,"\xE3g"],"\xA7"=>[0,"\xE3h"],"\xA8"=>[0,"\xE3l"],"\xA9"=>[0,"\xE3m"],"\xAA"=>[0,"\xE3n"],"\xAB"=>[0,"\xE3p"],"\xAC"=>[0,"\xE3r"],"\xAD"=>[0,"\xE3u"],"\xAE"=>[100,"\xE3"],"\xAF"=>[110,"\xE3"],"\xB0"=>[111,"\xE3"],"\xB1"=>[115,"\xE3"],"\xB2"=>[116,"\xE3"],"\xB3"=>[118,"\xE3"],"\xB4"=>[119,"\xE3"],"\xB5"=>[122,"\xE3"],"\xB6"=>[123,"\xE3"],"\xB7"=>[125,"\xE3"],"\xB8"=>[126,"\xE3"],"\xB9"=>[129,"\xE3"],"\xBA"=>[143,"\xE3"],"\xBB"=>[148,"\xE3"],"\xBC"=>[151,"\xE3"],"\xBD"=>[153,"\xE3"],"\xBE"=>[83,"\xE3"],"\xBF"=>[10,"\xE3"],"\xC0"=>[77,"\xE50"],"\xC1"=>[18,"\xE50"],"\xC2"=>[77,"\xE51"],"\xC3"=>[18,"\xE51"],"\xC4"=>[77,"\xE52"],"\xC5"=>[18,"\xE52"],"\xC6"=>[77,"\xE5a"],"\xC7"=>[18,"\xE5a"],"\xC8"=>[77,"\xE5c"],"\xC9"=>[18,"\xE5c"],"\xCA"=>[77,"\xE5e"],"\xCB"=>[18,"\xE5e"],"\xCC"=>[77,"\xE5i"],"\xCD"=>[18,"\xE5i"],"\xCE"=>[77,"\xE5o"],"\xCF"=>[18,"\xE5o"],"\xD0"=>[77,"\xE5s"],"\xD1"=>[18,"\xE5s"],"\xD2"=>[77,"\xE5t"],"\xD3"=>[18,"\xE5t"],"\xD4"=>[0,"\xE5\x20"],"\xD5"=>[0,"\xE5\x25"],"\xD6"=>[0,"\xE5-"],"\xD7"=>[0,"\xE5."],"\xD8"=>[0,"\xE5\x2F"],"\xD9"=>[0,"\xE53"],"\xDA"=>[0,"\xE54"],"\xDB"=>[0,"\xE55"],"\xDC"=>[0,"\xE56"],"\xDD"=>[0,"\xE57"],"\xDE"=>[0,"\xE58"],"\xDF"=>[0,"\xE59"],"\xE0"=>[0,"\xE5\x3D"],"\xE1"=>[0,"\xE5A"],"\xE2"=>[0,"\xE5_"],"\xE3"=>[0,"\xE5b"],"\xE4"=>[0,"\xE5d"],"\xE5"=>[0,"\xE5f"],"\xE6"=>[0,"\xE5g"],"\xE7"=>[0,"\xE5h"],"\xE8"=>[0,"\xE5l"],"\xE9"=>[0,"\xE5m"],"\xEA"=>[0,"\xE5n"],"\xEB"=>[0,"\xE5p"],"\xEC"=>[0,"\xE5r"],"\xED"=>[0,"\xE5u"],"\xEE"=>[100,"\xE5"],"\xEF"=>[110,"\xE5"],"\xF0"=>[111,"\xE5"],"\xF1"=>[115,"\xE5"],"\xF2"=>[116,"\xE5"],"\xF3"=>[118,"\xE5"],"\xF4"=>[119,"\xE5"],"\xF5"=>[122,"\xE5"],"\xF6"=>[123,"\xE5"],"\xF7"=>[125,"\xE5"],"\xF8"=>[126,"\xE5"],"\xF9"=>[129,"\xE5"],"\xFA"=>[143,"\xE5"],"\xFB"=>[148,"\xE5"],"\xFC"=>[151,"\xE5"],"\xFD"=>[153,"\xE5"],"\xFE"=>[83,"\xE5"],"\xFF"=>[10,"\xE5"],],["\x00"=>[77,"\xDA0"],"\x01"=>[18,"\xDA0"],"\x02"=>[77,"\xDA1"],"\x03"=>[18,"\xDA1"],"\x04"=>[77,"\xDA2"],"\x05"=>[18,"\xDA2"],"\x06"=>[77,"\xDAa"],"\x07"=>[18,"\xDAa"],"\x08"=>[77,"\xDAc"],"\x09"=>[18,"\xDAc"],"\x0A"=>[77,"\xDAe"],"\x0B"=>[18,"\xDAe"],"\x0C"=>[77,"\xDAi"],"\x0D"=>[18,"\xDAi"],"\x0E"=>[77,"\xDAo"],"\x0F"=>[18,"\xDAo"],"\x10"=>[77,"\xDAs"],"\x11"=>[18,"\xDAs"],"\x12"=>[77,"\xDAt"],"\x13"=>[18,"\xDAt"],"\x14"=>[0,"\xDA\x20"],"\x15"=>[0,"\xDA\x25"],"\x16"=>[0,"\xDA-"],"\x17"=>[0,"\xDA."],"\x18"=>[0,"\xDA\x2F"],"\x19"=>[0,"\xDA3"],"\x1A"=>[0,"\xDA4"],"\x1B"=>[0,"\xDA5"],"\x1C"=>[0,"\xDA6"],"\x1D"=>[0,"\xDA7"],"\x1E"=>[0,"\xDA8"],"\x1F"=>[0,"\xDA9"],"\x20"=>[0,"\xDA\x3D"],"\x21"=>[0,"\xDAA"],"\x22"=>[0,"\xDA_"],"\x23"=>[0,"\xDAb"],"\x24"=>[0,"\xDAd"],"\x25"=>[0,"\xDAf"],"\x26"=>[0,"\xDAg"],"\x27"=>[0,"\xDAh"],"\x28"=>[0,"\xDAl"],"\x29"=>[0,"\xDAm"],"\x2A"=>[0,"\xDAn"],"\x2B"=>[0,"\xDAp"],"\x2C"=>[0,"\xDAr"],"-"=>[0,"\xDAu"],"."=>[100,"\xDA"],"\x2F"=>[110,"\xDA"],[111,"\xDA"],[115,"\xDA"],[116,"\xDA"],[118,"\xDA"],[119,"\xDA"],[122,"\xDA"],[123,"\xDA"],[125,"\xDA"],[126,"\xDA"],[129,"\xDA"],"\x3A"=>[143,"\xDA"],"\x3B"=>[148,"\xDA"],"\x3C"=>[151,"\xDA"],"\x3D"=>[153,"\xDA"],"\x3E"=>[83,"\xDA"],"\x3F"=>[10,"\xDA"],"\x40"=>[77,"\xDB0"],"A"=>[18,"\xDB0"],"B"=>[77,"\xDB1"],"C"=>[18,"\xDB1"],"D"=>[77,"\xDB2"],"E"=>[18,"\xDB2"],"F"=>[77,"\xDBa"],"G"=>[18,"\xDBa"],"H"=>[77,"\xDBc"],"I"=>[18,"\xDBc"],"J"=>[77,"\xDBe"],"K"=>[18,"\xDBe"],"L"=>[77,"\xDBi"],"M"=>[18,"\xDBi"],"N"=>[77,"\xDBo"],"O"=>[18,"\xDBo"],"P"=>[77,"\xDBs"],"Q"=>[18,"\xDBs"],"R"=>[77,"\xDBt"],"S"=>[18,"\xDBt"],"T"=>[0,"\xDB\x20"],"U"=>[0,"\xDB\x25"],"V"=>[0,"\xDB-"],"W"=>[0,"\xDB."],"X"=>[0,"\xDB\x2F"],"Y"=>[0,"\xDB3"],"Z"=>[0,"\xDB4"],"\x5B"=>[0,"\xDB5"],"\x5C"=>[0,"\xDB6"],"\x5D"=>[0,"\xDB7"],"\x5E"=>[0,"\xDB8"],"_"=>[0,"\xDB9"],"\x60"=>[0,"\xDB\x3D"],"a"=>[0,"\xDBA"],"b"=>[0,"\xDB_"],"c"=>[0,"\xDBb"],"d"=>[0,"\xDBd"],"e"=>[0,"\xDBf"],"f"=>[0,"\xDBg"],"g"=>[0,"\xDBh"],"h"=>[0,"\xDBl"],"i"=>[0,"\xDBm"],"j"=>[0,"\xDBn"],"k"=>[0,"\xDBp"],"l"=>[0,"\xDBr"],"m"=>[0,"\xDBu"],"n"=>[100,"\xDB"],"o"=>[110,"\xDB"],"p"=>[111,"\xDB"],"q"=>[115,"\xDB"],"r"=>[116,"\xDB"],"s"=>[118,"\xDB"],"t"=>[119,"\xDB"],"u"=>[122,"\xDB"],"v"=>[123,"\xDB"],"w"=>[125,"\xDB"],"x"=>[126,"\xDB"],"y"=>[129,"\xDB"],"z"=>[143,"\xDB"],"\x7B"=>[148,"\xDB"],"\x7C"=>[151,"\xDB"],"\x7D"=>[153,"\xDB"],"~"=>[83,"\xDB"],"\x7F"=>[10,"\xDB"],"\x80"=>[77,"\xEE0"],"\x81"=>[18,"\xEE0"],"\x82"=>[77,"\xEE1"],"\x83"=>[18,"\xEE1"],"\x84"=>[77,"\xEE2"],"\x85"=>[18,"\xEE2"],"\x86"=>[77,"\xEEa"],"\x87"=>[18,"\xEEa"],"\x88"=>[77,"\xEEc"],"\x89"=>[18,"\xEEc"],"\x8A"=>[77,"\xEEe"],"\x8B"=>[18,"\xEEe"],"\x8C"=>[77,"\xEEi"],"\x8D"=>[18,"\xEEi"],"\x8E"=>[77,"\xEEo"],"\x8F"=>[18,"\xEEo"],"\x90"=>[77,"\xEEs"],"\x91"=>[18,"\xEEs"],"\x92"=>[77,"\xEEt"],"\x93"=>[18,"\xEEt"],"\x94"=>[0,"\xEE\x20"],"\x95"=>[0,"\xEE\x25"],"\x96"=>[0,"\xEE-"],"\x97"=>[0,"\xEE."],"\x98"=>[0,"\xEE\x2F"],"\x99"=>[0,"\xEE3"],"\x9A"=>[0,"\xEE4"],"\x9B"=>[0,"\xEE5"],"\x9C"=>[0,"\xEE6"],"\x9D"=>[0,"\xEE7"],"\x9E"=>[0,"\xEE8"],"\x9F"=>[0,"\xEE9"],"\xA0"=>[0,"\xEE\x3D"],"\xA1"=>[0,"\xEEA"],"\xA2"=>[0,"\xEE_"],"\xA3"=>[0,"\xEEb"],"\xA4"=>[0,"\xEEd"],"\xA5"=>[0,"\xEEf"],"\xA6"=>[0,"\xEEg"],"\xA7"=>[0,"\xEEh"],"\xA8"=>[0,"\xEEl"],"\xA9"=>[0,"\xEEm"],"\xAA"=>[0,"\xEEn"],"\xAB"=>[0,"\xEEp"],"\xAC"=>[0,"\xEEr"],"\xAD"=>[0,"\xEEu"],"\xAE"=>[100,"\xEE"],"\xAF"=>[110,"\xEE"],"\xB0"=>[111,"\xEE"],"\xB1"=>[115,"\xEE"],"\xB2"=>[116,"\xEE"],"\xB3"=>[118,"\xEE"],"\xB4"=>[119,"\xEE"],"\xB5"=>[122,"\xEE"],"\xB6"=>[123,"\xEE"],"\xB7"=>[125,"\xEE"],"\xB8"=>[126,"\xEE"],"\xB9"=>[129,"\xEE"],"\xBA"=>[143,"\xEE"],"\xBB"=>[148,"\xEE"],"\xBC"=>[151,"\xEE"],"\xBD"=>[153,"\xEE"],"\xBE"=>[83,"\xEE"],"\xBF"=>[10,"\xEE"],"\xC0"=>[77,"\xF00"],"\xC1"=>[18,"\xF00"],"\xC2"=>[77,"\xF01"],"\xC3"=>[18,"\xF01"],"\xC4"=>[77,"\xF02"],"\xC5"=>[18,"\xF02"],"\xC6"=>[77,"\xF0a"],"\xC7"=>[18,"\xF0a"],"\xC8"=>[77,"\xF0c"],"\xC9"=>[18,"\xF0c"],"\xCA"=>[77,"\xF0e"],"\xCB"=>[18,"\xF0e"],"\xCC"=>[77,"\xF0i"],"\xCD"=>[18,"\xF0i"],"\xCE"=>[77,"\xF0o"],"\xCF"=>[18,"\xF0o"],"\xD0"=>[77,"\xF0s"],"\xD1"=>[18,"\xF0s"],"\xD2"=>[77,"\xF0t"],"\xD3"=>[18,"\xF0t"],"\xD4"=>[0,"\xF0\x20"],"\xD5"=>[0,"\xF0\x25"],"\xD6"=>[0,"\xF0-"],"\xD7"=>[0,"\xF0."],"\xD8"=>[0,"\xF0\x2F"],"\xD9"=>[0,"\xF03"],"\xDA"=>[0,"\xF04"],"\xDB"=>[0,"\xF05"],"\xDC"=>[0,"\xF06"],"\xDD"=>[0,"\xF07"],"\xDE"=>[0,"\xF08"],"\xDF"=>[0,"\xF09"],"\xE0"=>[0,"\xF0\x3D"],"\xE1"=>[0,"\xF0A"],"\xE2"=>[0,"\xF0_"],"\xE3"=>[0,"\xF0b"],"\xE4"=>[0,"\xF0d"],"\xE5"=>[0,"\xF0f"],"\xE6"=>[0,"\xF0g"],"\xE7"=>[0,"\xF0h"],"\xE8"=>[0,"\xF0l"],"\xE9"=>[0,"\xF0m"],"\xEA"=>[0,"\xF0n"],"\xEB"=>[0,"\xF0p"],"\xEC"=>[0,"\xF0r"],"\xED"=>[0,"\xF0u"],"\xEE"=>[100,"\xF0"],"\xEF"=>[110,"\xF0"],"\xF0"=>[111,"\xF0"],"\xF1"=>[115,"\xF0"],"\xF2"=>[116,"\xF0"],"\xF3"=>[118,"\xF0"],"\xF4"=>[119,"\xF0"],"\xF5"=>[122,"\xF0"],"\xF6"=>[123,"\xF0"],"\xF7"=>[125,"\xF0"],"\xF8"=>[126,"\xF0"],"\xF9"=>[129,"\xF0"],"\xFA"=>[143,"\xF0"],"\xFB"=>[148,"\xF0"],"\xFC"=>[151,"\xF0"],"\xFD"=>[153,"\xF0"],"\xFE"=>[83,"\xF0"],"\xFF"=>[10,"\xF0"],],["\x00"=>[94,"\xDA0"],"\x01"=>[76,"\xDA0"],"\x02"=>[104,"\xDA0"],"\x03"=>[16,"\xDA0"],"\x04"=>[94,"\xDA1"],"\x05"=>[76,"\xDA1"],"\x06"=>[104,"\xDA1"],"\x07"=>[16,"\xDA1"],"\x08"=>[94,"\xDA2"],"\x09"=>[76,"\xDA2"],"\x0A"=>[104,"\xDA2"],"\x0B"=>[16,"\xDA2"],"\x0C"=>[94,"\xDAa"],"\x0D"=>[76,"\xDAa"],"\x0E"=>[104,"\xDAa"],"\x0F"=>[16,"\xDAa"],"\x10"=>[94,"\xDAc"],"\x11"=>[76,"\xDAc"],"\x12"=>[104,"\xDAc"],"\x13"=>[16,"\xDAc"],"\x14"=>[94,"\xDAe"],"\x15"=>[76,"\xDAe"],"\x16"=>[104,"\xDAe"],"\x17"=>[16,"\xDAe"],"\x18"=>[94,"\xDAi"],"\x19"=>[76,"\xDAi"],"\x1A"=>[104,"\xDAi"],"\x1B"=>[16,"\xDAi"],"\x1C"=>[94,"\xDAo"],"\x1D"=>[76,"\xDAo"],"\x1E"=>[104,"\xDAo"],"\x1F"=>[16,"\xDAo"],"\x20"=>[94,"\xDAs"],"\x21"=>[76,"\xDAs"],"\x22"=>[104,"\xDAs"],"\x23"=>[16,"\xDAs"],"\x24"=>[94,"\xDAt"],"\x25"=>[76,"\xDAt"],"\x26"=>[104,"\xDAt"],"\x27"=>[16,"\xDAt"],"\x28"=>[77,"\xDA\x20"],"\x29"=>[18,"\xDA\x20"],"\x2A"=>[77,"\xDA\x25"],"\x2B"=>[18,"\xDA\x25"],"\x2C"=>[77,"\xDA-"],"-"=>[18,"\xDA-"],"."=>[77,"\xDA."],"\x2F"=>[18,"\xDA."],[77,"\xDA\x2F"],[18,"\xDA\x2F"],[77,"\xDA3"],[18,"\xDA3"],[77,"\xDA4"],[18,"\xDA4"],[77,"\xDA5"],[18,"\xDA5"],[77,"\xDA6"],[18,"\xDA6"],"\x3A"=>[77,"\xDA7"],"\x3B"=>[18,"\xDA7"],"\x3C"=>[77,"\xDA8"],"\x3D"=>[18,"\xDA8"],"\x3E"=>[77,"\xDA9"],"\x3F"=>[18,"\xDA9"],"\x40"=>[77,"\xDA\x3D"],"A"=>[18,"\xDA\x3D"],"B"=>[77,"\xDAA"],"C"=>[18,"\xDAA"],"D"=>[77,"\xDA_"],"E"=>[18,"\xDA_"],"F"=>[77,"\xDAb"],"G"=>[18,"\xDAb"],"H"=>[77,"\xDAd"],"I"=>[18,"\xDAd"],"J"=>[77,"\xDAf"],"K"=>[18,"\xDAf"],"L"=>[77,"\xDAg"],"M"=>[18,"\xDAg"],"N"=>[77,"\xDAh"],"O"=>[18,"\xDAh"],"P"=>[77,"\xDAl"],"Q"=>[18,"\xDAl"],"R"=>[77,"\xDAm"],"S"=>[18,"\xDAm"],"T"=>[77,"\xDAn"],"U"=>[18,"\xDAn"],"V"=>[77,"\xDAp"],"W"=>[18,"\xDAp"],"X"=>[77,"\xDAr"],"Y"=>[18,"\xDAr"],"Z"=>[77,"\xDAu"],"\x5B"=>[18,"\xDAu"],"\x5C"=>[0,"\xDA\x3A"],"\x5D"=>[0,"\xDAB"],"\x5E"=>[0,"\xDAC"],"_"=>[0,"\xDAD"],"\x60"=>[0,"\xDAE"],"a"=>[0,"\xDAF"],"b"=>[0,"\xDAG"],"c"=>[0,"\xDAH"],"d"=>[0,"\xDAI"],"e"=>[0,"\xDAJ"],"f"=>[0,"\xDAK"],"g"=>[0,"\xDAL"],"h"=>[0,"\xDAM"],"i"=>[0,"\xDAN"],"j"=>[0,"\xDAO"],"k"=>[0,"\xDAP"],"l"=>[0,"\xDAQ"],"m"=>[0,"\xDAR"],"n"=>[0,"\xDAS"],"o"=>[0,"\xDAT"],"p"=>[0,"\xDAU"],"q"=>[0,"\xDAV"],"r"=>[0,"\xDAW"],"s"=>[0,"\xDAY"],"t"=>[0,"\xDAj"],"u"=>[0,"\xDAk"],"v"=>[0,"\xDAq"],"w"=>[0,"\xDAv"],"x"=>[0,"\xDAw"],"y"=>[0,"\xDAx"],"z"=>[0,"\xDAy"],"\x7B"=>[0,"\xDAz"],"\x7C"=>[82,"\xDA"],"\x7D"=>[87,"\xDA"],"~"=>[130,"\xDA"],"\x7F"=>[9,"\xDA"],"\x80"=>[94,"\xDB0"],"\x81"=>[76,"\xDB0"],"\x82"=>[104,"\xDB0"],"\x83"=>[16,"\xDB0"],"\x84"=>[94,"\xDB1"],"\x85"=>[76,"\xDB1"],"\x86"=>[104,"\xDB1"],"\x87"=>[16,"\xDB1"],"\x88"=>[94,"\xDB2"],"\x89"=>[76,"\xDB2"],"\x8A"=>[104,"\xDB2"],"\x8B"=>[16,"\xDB2"],"\x8C"=>[94,"\xDBa"],"\x8D"=>[76,"\xDBa"],"\x8E"=>[104,"\xDBa"],"\x8F"=>[16,"\xDBa"],"\x90"=>[94,"\xDBc"],"\x91"=>[76,"\xDBc"],"\x92"=>[104,"\xDBc"],"\x93"=>[16,"\xDBc"],"\x94"=>[94,"\xDBe"],"\x95"=>[76,"\xDBe"],"\x96"=>[104,"\xDBe"],"\x97"=>[16,"\xDBe"],"\x98"=>[94,"\xDBi"],"\x99"=>[76,"\xDBi"],"\x9A"=>[104,"\xDBi"],"\x9B"=>[16,"\xDBi"],"\x9C"=>[94,"\xDBo"],"\x9D"=>[76,"\xDBo"],"\x9E"=>[104,"\xDBo"],"\x9F"=>[16,"\xDBo"],"\xA0"=>[94,"\xDBs"],"\xA1"=>[76,"\xDBs"],"\xA2"=>[104,"\xDBs"],"\xA3"=>[16,"\xDBs"],"\xA4"=>[94,"\xDBt"],"\xA5"=>[76,"\xDBt"],"\xA6"=>[104,"\xDBt"],"\xA7"=>[16,"\xDBt"],"\xA8"=>[77,"\xDB\x20"],"\xA9"=>[18,"\xDB\x20"],"\xAA"=>[77,"\xDB\x25"],"\xAB"=>[18,"\xDB\x25"],"\xAC"=>[77,"\xDB-"],"\xAD"=>[18,"\xDB-"],"\xAE"=>[77,"\xDB."],"\xAF"=>[18,"\xDB."],"\xB0"=>[77,"\xDB\x2F"],"\xB1"=>[18,"\xDB\x2F"],"\xB2"=>[77,"\xDB3"],"\xB3"=>[18,"\xDB3"],"\xB4"=>[77,"\xDB4"],"\xB5"=>[18,"\xDB4"],"\xB6"=>[77,"\xDB5"],"\xB7"=>[18,"\xDB5"],"\xB8"=>[77,"\xDB6"],"\xB9"=>[18,"\xDB6"],"\xBA"=>[77,"\xDB7"],"\xBB"=>[18,"\xDB7"],"\xBC"=>[77,"\xDB8"],"\xBD"=>[18,"\xDB8"],"\xBE"=>[77,"\xDB9"],"\xBF"=>[18,"\xDB9"],"\xC0"=>[77,"\xDB\x3D"],"\xC1"=>[18,"\xDB\x3D"],"\xC2"=>[77,"\xDBA"],"\xC3"=>[18,"\xDBA"],"\xC4"=>[77,"\xDB_"],"\xC5"=>[18,"\xDB_"],"\xC6"=>[77,"\xDBb"],"\xC7"=>[18,"\xDBb"],"\xC8"=>[77,"\xDBd"],"\xC9"=>[18,"\xDBd"],"\xCA"=>[77,"\xDBf"],"\xCB"=>[18,"\xDBf"],"\xCC"=>[77,"\xDBg"],"\xCD"=>[18,"\xDBg"],"\xCE"=>[77,"\xDBh"],"\xCF"=>[18,"\xDBh"],"\xD0"=>[77,"\xDBl"],"\xD1"=>[18,"\xDBl"],"\xD2"=>[77,"\xDBm"],"\xD3"=>[18,"\xDBm"],"\xD4"=>[77,"\xDBn"],"\xD5"=>[18,"\xDBn"],"\xD6"=>[77,"\xDBp"],"\xD7"=>[18,"\xDBp"],"\xD8"=>[77,"\xDBr"],"\xD9"=>[18,"\xDBr"],"\xDA"=>[77,"\xDBu"],"\xDB"=>[18,"\xDBu"],"\xDC"=>[0,"\xDB\x3A"],"\xDD"=>[0,"\xDBB"],"\xDE"=>[0,"\xDBC"],"\xDF"=>[0,"\xDBD"],"\xE0"=>[0,"\xDBE"],"\xE1"=>[0,"\xDBF"],"\xE2"=>[0,"\xDBG"],"\xE3"=>[0,"\xDBH"],"\xE4"=>[0,"\xDBI"],"\xE5"=>[0,"\xDBJ"],"\xE6"=>[0,"\xDBK"],"\xE7"=>[0,"\xDBL"],"\xE8"=>[0,"\xDBM"],"\xE9"=>[0,"\xDBN"],"\xEA"=>[0,"\xDBO"],"\xEB"=>[0,"\xDBP"],"\xEC"=>[0,"\xDBQ"],"\xED"=>[0,"\xDBR"],"\xEE"=>[0,"\xDBS"],"\xEF"=>[0,"\xDBT"],"\xF0"=>[0,"\xDBU"],"\xF1"=>[0,"\xDBV"],"\xF2"=>[0,"\xDBW"],"\xF3"=>[0,"\xDBY"],"\xF4"=>[0,"\xDBj"],"\xF5"=>[0,"\xDBk"],"\xF6"=>[0,"\xDBq"],"\xF7"=>[0,"\xDBv"],"\xF8"=>[0,"\xDBw"],"\xF9"=>[0,"\xDBx"],"\xFA"=>[0,"\xDBy"],"\xFB"=>[0,"\xDBz"],"\xFC"=>[82,"\xDB"],"\xFD"=>[87,"\xDB"],"\xFE"=>[130,"\xDB"],"\xFF"=>[9,"\xDB"],],["\x00"=>[94,"\xDE0"],"\x01"=>[76,"\xDE0"],"\x02"=>[104,"\xDE0"],"\x03"=>[16,"\xDE0"],"\x04"=>[94,"\xDE1"],"\x05"=>[76,"\xDE1"],"\x06"=>[104,"\xDE1"],"\x07"=>[16,"\xDE1"],"\x08"=>[94,"\xDE2"],"\x09"=>[76,"\xDE2"],"\x0A"=>[104,"\xDE2"],"\x0B"=>[16,"\xDE2"],"\x0C"=>[94,"\xDEa"],"\x0D"=>[76,"\xDEa"],"\x0E"=>[104,"\xDEa"],"\x0F"=>[16,"\xDEa"],"\x10"=>[94,"\xDEc"],"\x11"=>[76,"\xDEc"],"\x12"=>[104,"\xDEc"],"\x13"=>[16,"\xDEc"],"\x14"=>[94,"\xDEe"],"\x15"=>[76,"\xDEe"],"\x16"=>[104,"\xDEe"],"\x17"=>[16,"\xDEe"],"\x18"=>[94,"\xDEi"],"\x19"=>[76,"\xDEi"],"\x1A"=>[104,"\xDEi"],"\x1B"=>[16,"\xDEi"],"\x1C"=>[94,"\xDEo"],"\x1D"=>[76,"\xDEo"],"\x1E"=>[104,"\xDEo"],"\x1F"=>[16,"\xDEo"],"\x20"=>[94,"\xDEs"],"\x21"=>[76,"\xDEs"],"\x22"=>[104,"\xDEs"],"\x23"=>[16,"\xDEs"],"\x24"=>[94,"\xDEt"],"\x25"=>[76,"\xDEt"],"\x26"=>[104,"\xDEt"],"\x27"=>[16,"\xDEt"],"\x28"=>[77,"\xDE\x20"],"\x29"=>[18,"\xDE\x20"],"\x2A"=>[77,"\xDE\x25"],"\x2B"=>[18,"\xDE\x25"],"\x2C"=>[77,"\xDE-"],"-"=>[18,"\xDE-"],"."=>[77,"\xDE."],"\x2F"=>[18,"\xDE."],[77,"\xDE\x2F"],[18,"\xDE\x2F"],[77,"\xDE3"],[18,"\xDE3"],[77,"\xDE4"],[18,"\xDE4"],[77,"\xDE5"],[18,"\xDE5"],[77,"\xDE6"],[18,"\xDE6"],"\x3A"=>[77,"\xDE7"],"\x3B"=>[18,"\xDE7"],"\x3C"=>[77,"\xDE8"],"\x3D"=>[18,"\xDE8"],"\x3E"=>[77,"\xDE9"],"\x3F"=>[18,"\xDE9"],"\x40"=>[77,"\xDE\x3D"],"A"=>[18,"\xDE\x3D"],"B"=>[77,"\xDEA"],"C"=>[18,"\xDEA"],"D"=>[77,"\xDE_"],"E"=>[18,"\xDE_"],"F"=>[77,"\xDEb"],"G"=>[18,"\xDEb"],"H"=>[77,"\xDEd"],"I"=>[18,"\xDEd"],"J"=>[77,"\xDEf"],"K"=>[18,"\xDEf"],"L"=>[77,"\xDEg"],"M"=>[18,"\xDEg"],"N"=>[77,"\xDEh"],"O"=>[18,"\xDEh"],"P"=>[77,"\xDEl"],"Q"=>[18,"\xDEl"],"R"=>[77,"\xDEm"],"S"=>[18,"\xDEm"],"T"=>[77,"\xDEn"],"U"=>[18,"\xDEn"],"V"=>[77,"\xDEp"],"W"=>[18,"\xDEp"],"X"=>[77,"\xDEr"],"Y"=>[18,"\xDEr"],"Z"=>[77,"\xDEu"],"\x5B"=>[18,"\xDEu"],"\x5C"=>[0,"\xDE\x3A"],"\x5D"=>[0,"\xDEB"],"\x5E"=>[0,"\xDEC"],"_"=>[0,"\xDED"],"\x60"=>[0,"\xDEE"],"a"=>[0,"\xDEF"],"b"=>[0,"\xDEG"],"c"=>[0,"\xDEH"],"d"=>[0,"\xDEI"],"e"=>[0,"\xDEJ"],"f"=>[0,"\xDEK"],"g"=>[0,"\xDEL"],"h"=>[0,"\xDEM"],"i"=>[0,"\xDEN"],"j"=>[0,"\xDEO"],"k"=>[0,"\xDEP"],"l"=>[0,"\xDEQ"],"m"=>[0,"\xDER"],"n"=>[0,"\xDES"],"o"=>[0,"\xDET"],"p"=>[0,"\xDEU"],"q"=>[0,"\xDEV"],"r"=>[0,"\xDEW"],"s"=>[0,"\xDEY"],"t"=>[0,"\xDEj"],"u"=>[0,"\xDEk"],"v"=>[0,"\xDEq"],"w"=>[0,"\xDEv"],"x"=>[0,"\xDEw"],"y"=>[0,"\xDEx"],"z"=>[0,"\xDEy"],"\x7B"=>[0,"\xDEz"],"\x7C"=>[82,"\xDE"],"\x7D"=>[87,"\xDE"],"~"=>[130,"\xDE"],"\x7F"=>[9,"\xDE"],"\x80"=>[94,"\xDF0"],"\x81"=>[76,"\xDF0"],"\x82"=>[104,"\xDF0"],"\x83"=>[16,"\xDF0"],"\x84"=>[94,"\xDF1"],"\x85"=>[76,"\xDF1"],"\x86"=>[104,"\xDF1"],"\x87"=>[16,"\xDF1"],"\x88"=>[94,"\xDF2"],"\x89"=>[76,"\xDF2"],"\x8A"=>[104,"\xDF2"],"\x8B"=>[16,"\xDF2"],"\x8C"=>[94,"\xDFa"],"\x8D"=>[76,"\xDFa"],"\x8E"=>[104,"\xDFa"],"\x8F"=>[16,"\xDFa"],"\x90"=>[94,"\xDFc"],"\x91"=>[76,"\xDFc"],"\x92"=>[104,"\xDFc"],"\x93"=>[16,"\xDFc"],"\x94"=>[94,"\xDFe"],"\x95"=>[76,"\xDFe"],"\x96"=>[104,"\xDFe"],"\x97"=>[16,"\xDFe"],"\x98"=>[94,"\xDFi"],"\x99"=>[76,"\xDFi"],"\x9A"=>[104,"\xDFi"],"\x9B"=>[16,"\xDFi"],"\x9C"=>[94,"\xDFo"],"\x9D"=>[76,"\xDFo"],"\x9E"=>[104,"\xDFo"],"\x9F"=>[16,"\xDFo"],"\xA0"=>[94,"\xDFs"],"\xA1"=>[76,"\xDFs"],"\xA2"=>[104,"\xDFs"],"\xA3"=>[16,"\xDFs"],"\xA4"=>[94,"\xDFt"],"\xA5"=>[76,"\xDFt"],"\xA6"=>[104,"\xDFt"],"\xA7"=>[16,"\xDFt"],"\xA8"=>[77,"\xDF\x20"],"\xA9"=>[18,"\xDF\x20"],"\xAA"=>[77,"\xDF\x25"],"\xAB"=>[18,"\xDF\x25"],"\xAC"=>[77,"\xDF-"],"\xAD"=>[18,"\xDF-"],"\xAE"=>[77,"\xDF."],"\xAF"=>[18,"\xDF."],"\xB0"=>[77,"\xDF\x2F"],"\xB1"=>[18,"\xDF\x2F"],"\xB2"=>[77,"\xDF3"],"\xB3"=>[18,"\xDF3"],"\xB4"=>[77,"\xDF4"],"\xB5"=>[18,"\xDF4"],"\xB6"=>[77,"\xDF5"],"\xB7"=>[18,"\xDF5"],"\xB8"=>[77,"\xDF6"],"\xB9"=>[18,"\xDF6"],"\xBA"=>[77,"\xDF7"],"\xBB"=>[18,"\xDF7"],"\xBC"=>[77,"\xDF8"],"\xBD"=>[18,"\xDF8"],"\xBE"=>[77,"\xDF9"],"\xBF"=>[18,"\xDF9"],"\xC0"=>[77,"\xDF\x3D"],"\xC1"=>[18,"\xDF\x3D"],"\xC2"=>[77,"\xDFA"],"\xC3"=>[18,"\xDFA"],"\xC4"=>[77,"\xDF_"],"\xC5"=>[18,"\xDF_"],"\xC6"=>[77,"\xDFb"],"\xC7"=>[18,"\xDFb"],"\xC8"=>[77,"\xDFd"],"\xC9"=>[18,"\xDFd"],"\xCA"=>[77,"\xDFf"],"\xCB"=>[18,"\xDFf"],"\xCC"=>[77,"\xDFg"],"\xCD"=>[18,"\xDFg"],"\xCE"=>[77,"\xDFh"],"\xCF"=>[18,"\xDFh"],"\xD0"=>[77,"\xDFl"],"\xD1"=>[18,"\xDFl"],"\xD2"=>[77,"\xDFm"],"\xD3"=>[18,"\xDFm"],"\xD4"=>[77,"\xDFn"],"\xD5"=>[18,"\xDFn"],"\xD6"=>[77,"\xDFp"],"\xD7"=>[18,"\xDFp"],"\xD8"=>[77,"\xDFr"],"\xD9"=>[18,"\xDFr"],"\xDA"=>[77,"\xDFu"],"\xDB"=>[18,"\xDFu"],"\xDC"=>[0,"\xDF\x3A"],"\xDD"=>[0,"\xDFB"],"\xDE"=>[0,"\xDFC"],"\xDF"=>[0,"\xDFD"],"\xE0"=>[0,"\xDFE"],"\xE1"=>[0,"\xDFF"],"\xE2"=>[0,"\xDFG"],"\xE3"=>[0,"\xDFH"],"\xE4"=>[0,"\xDFI"],"\xE5"=>[0,"\xDFJ"],"\xE6"=>[0,"\xDFK"],"\xE7"=>[0,"\xDFL"],"\xE8"=>[0,"\xDFM"],"\xE9"=>[0,"\xDFN"],"\xEA"=>[0,"\xDFO"],"\xEB"=>[0,"\xDFP"],"\xEC"=>[0,"\xDFQ"],"\xED"=>[0,"\xDFR"],"\xEE"=>[0,"\xDFS"],"\xEF"=>[0,"\xDFT"],"\xF0"=>[0,"\xDFU"],"\xF1"=>[0,"\xDFV"],"\xF2"=>[0,"\xDFW"],"\xF3"=>[0,"\xDFY"],"\xF4"=>[0,"\xDFj"],"\xF5"=>[0,"\xDFk"],"\xF6"=>[0,"\xDFq"],"\xF7"=>[0,"\xDFv"],"\xF8"=>[0,"\xDFw"],"\xF9"=>[0,"\xDFx"],"\xFA"=>[0,"\xDFy"],"\xFB"=>[0,"\xDFz"],"\xFC"=>[82,"\xDF"],"\xFD"=>[87,"\xDF"],"\xFE"=>[130,"\xDF"],"\xFF"=>[9,"\xDF"],],["\x00"=>[77,"\xDE0"],"\x01"=>[18,"\xDE0"],"\x02"=>[77,"\xDE1"],"\x03"=>[18,"\xDE1"],"\x04"=>[77,"\xDE2"],"\x05"=>[18,"\xDE2"],"\x06"=>[77,"\xDEa"],"\x07"=>[18,"\xDEa"],"\x08"=>[77,"\xDEc"],"\x09"=>[18,"\xDEc"],"\x0A"=>[77,"\xDEe"],"\x0B"=>[18,"\xDEe"],"\x0C"=>[77,"\xDEi"],"\x0D"=>[18,"\xDEi"],"\x0E"=>[77,"\xDEo"],"\x0F"=>[18,"\xDEo"],"\x10"=>[77,"\xDEs"],"\x11"=>[18,"\xDEs"],"\x12"=>[77,"\xDEt"],"\x13"=>[18,"\xDEt"],"\x14"=>[0,"\xDE\x20"],"\x15"=>[0,"\xDE\x25"],"\x16"=>[0,"\xDE-"],"\x17"=>[0,"\xDE."],"\x18"=>[0,"\xDE\x2F"],"\x19"=>[0,"\xDE3"],"\x1A"=>[0,"\xDE4"],"\x1B"=>[0,"\xDE5"],"\x1C"=>[0,"\xDE6"],"\x1D"=>[0,"\xDE7"],"\x1E"=>[0,"\xDE8"],"\x1F"=>[0,"\xDE9"],"\x20"=>[0,"\xDE\x3D"],"\x21"=>[0,"\xDEA"],"\x22"=>[0,"\xDE_"],"\x23"=>[0,"\xDEb"],"\x24"=>[0,"\xDEd"],"\x25"=>[0,"\xDEf"],"\x26"=>[0,"\xDEg"],"\x27"=>[0,"\xDEh"],"\x28"=>[0,"\xDEl"],"\x29"=>[0,"\xDEm"],"\x2A"=>[0,"\xDEn"],"\x2B"=>[0,"\xDEp"],"\x2C"=>[0,"\xDEr"],"-"=>[0,"\xDEu"],"."=>[100,"\xDE"],"\x2F"=>[110,"\xDE"],[111,"\xDE"],[115,"\xDE"],[116,"\xDE"],[118,"\xDE"],[119,"\xDE"],[122,"\xDE"],[123,"\xDE"],[125,"\xDE"],[126,"\xDE"],[129,"\xDE"],"\x3A"=>[143,"\xDE"],"\x3B"=>[148,"\xDE"],"\x3C"=>[151,"\xDE"],"\x3D"=>[153,"\xDE"],"\x3E"=>[83,"\xDE"],"\x3F"=>[10,"\xDE"],"\x40"=>[77,"\xDF0"],"A"=>[18,"\xDF0"],"B"=>[77,"\xDF1"],"C"=>[18,"\xDF1"],"D"=>[77,"\xDF2"],"E"=>[18,"\xDF2"],"F"=>[77,"\xDFa"],"G"=>[18,"\xDFa"],"H"=>[77,"\xDFc"],"I"=>[18,"\xDFc"],"J"=>[77,"\xDFe"],"K"=>[18,"\xDFe"],"L"=>[77,"\xDFi"],"M"=>[18,"\xDFi"],"N"=>[77,"\xDFo"],"O"=>[18,"\xDFo"],"P"=>[77,"\xDFs"],"Q"=>[18,"\xDFs"],"R"=>[77,"\xDFt"],"S"=>[18,"\xDFt"],"T"=>[0,"\xDF\x20"],"U"=>[0,"\xDF\x25"],"V"=>[0,"\xDF-"],"W"=>[0,"\xDF."],"X"=>[0,"\xDF\x2F"],"Y"=>[0,"\xDF3"],"Z"=>[0,"\xDF4"],"\x5B"=>[0,"\xDF5"],"\x5C"=>[0,"\xDF6"],"\x5D"=>[0,"\xDF7"],"\x5E"=>[0,"\xDF8"],"_"=>[0,"\xDF9"],"\x60"=>[0,"\xDF\x3D"],"a"=>[0,"\xDFA"],"b"=>[0,"\xDF_"],"c"=>[0,"\xDFb"],"d"=>[0,"\xDFd"],"e"=>[0,"\xDFf"],"f"=>[0,"\xDFg"],"g"=>[0,"\xDFh"],"h"=>[0,"\xDFl"],"i"=>[0,"\xDFm"],"j"=>[0,"\xDFn"],"k"=>[0,"\xDFp"],"l"=>[0,"\xDFr"],"m"=>[0,"\xDFu"],"n"=>[100,"\xDF"],"o"=>[110,"\xDF"],"p"=>[111,"\xDF"],"q"=>[115,"\xDF"],"r"=>[116,"\xDF"],"s"=>[118,"\xDF"],"t"=>[119,"\xDF"],"u"=>[122,"\xDF"],"v"=>[123,"\xDF"],"w"=>[125,"\xDF"],"x"=>[126,"\xDF"],"y"=>[129,"\xDF"],"z"=>[143,"\xDF"],"\x7B"=>[148,"\xDF"],"\x7C"=>[151,"\xDF"],"\x7D"=>[153,"\xDF"],"~"=>[83,"\xDF"],"\x7F"=>[10,"\xDF"],"\x80"=>[77,"\xF10"],"\x81"=>[18,"\xF10"],"\x82"=>[77,"\xF11"],"\x83"=>[18,"\xF11"],"\x84"=>[77,"\xF12"],"\x85"=>[18,"\xF12"],"\x86"=>[77,"\xF1a"],"\x87"=>[18,"\xF1a"],"\x88"=>[77,"\xF1c"],"\x89"=>[18,"\xF1c"],"\x8A"=>[77,"\xF1e"],"\x8B"=>[18,"\xF1e"],"\x8C"=>[77,"\xF1i"],"\x8D"=>[18,"\xF1i"],"\x8E"=>[77,"\xF1o"],"\x8F"=>[18,"\xF1o"],"\x90"=>[77,"\xF1s"],"\x91"=>[18,"\xF1s"],"\x92"=>[77,"\xF1t"],"\x93"=>[18,"\xF1t"],"\x94"=>[0,"\xF1\x20"],"\x95"=>[0,"\xF1\x25"],"\x96"=>[0,"\xF1-"],"\x97"=>[0,"\xF1."],"\x98"=>[0,"\xF1\x2F"],"\x99"=>[0,"\xF13"],"\x9A"=>[0,"\xF14"],"\x9B"=>[0,"\xF15"],"\x9C"=>[0,"\xF16"],"\x9D"=>[0,"\xF17"],"\x9E"=>[0,"\xF18"],"\x9F"=>[0,"\xF19"],"\xA0"=>[0,"\xF1\x3D"],"\xA1"=>[0,"\xF1A"],"\xA2"=>[0,"\xF1_"],"\xA3"=>[0,"\xF1b"],"\xA4"=>[0,"\xF1d"],"\xA5"=>[0,"\xF1f"],"\xA6"=>[0,"\xF1g"],"\xA7"=>[0,"\xF1h"],"\xA8"=>[0,"\xF1l"],"\xA9"=>[0,"\xF1m"],"\xAA"=>[0,"\xF1n"],"\xAB"=>[0,"\xF1p"],"\xAC"=>[0,"\xF1r"],"\xAD"=>[0,"\xF1u"],"\xAE"=>[100,"\xF1"],"\xAF"=>[110,"\xF1"],"\xB0"=>[111,"\xF1"],"\xB1"=>[115,"\xF1"],"\xB2"=>[116,"\xF1"],"\xB3"=>[118,"\xF1"],"\xB4"=>[119,"\xF1"],"\xB5"=>[122,"\xF1"],"\xB6"=>[123,"\xF1"],"\xB7"=>[125,"\xF1"],"\xB8"=>[126,"\xF1"],"\xB9"=>[129,"\xF1"],"\xBA"=>[143,"\xF1"],"\xBB"=>[148,"\xF1"],"\xBC"=>[151,"\xF1"],"\xBD"=>[153,"\xF1"],"\xBE"=>[83,"\xF1"],"\xBF"=>[10,"\xF1"],"\xC0"=>[77,"\xF40"],"\xC1"=>[18,"\xF40"],"\xC2"=>[77,"\xF41"],"\xC3"=>[18,"\xF41"],"\xC4"=>[77,"\xF42"],"\xC5"=>[18,"\xF42"],"\xC6"=>[77,"\xF4a"],"\xC7"=>[18,"\xF4a"],"\xC8"=>[77,"\xF4c"],"\xC9"=>[18,"\xF4c"],"\xCA"=>[77,"\xF4e"],"\xCB"=>[18,"\xF4e"],"\xCC"=>[77,"\xF4i"],"\xCD"=>[18,"\xF4i"],"\xCE"=>[77,"\xF4o"],"\xCF"=>[18,"\xF4o"],"\xD0"=>[77,"\xF4s"],"\xD1"=>[18,"\xF4s"],"\xD2"=>[77,"\xF4t"],"\xD3"=>[18,"\xF4t"],"\xD4"=>[0,"\xF4\x20"],"\xD5"=>[0,"\xF4\x25"],"\xD6"=>[0,"\xF4-"],"\xD7"=>[0,"\xF4."],"\xD8"=>[0,"\xF4\x2F"],"\xD9"=>[0,"\xF43"],"\xDA"=>[0,"\xF44"],"\xDB"=>[0,"\xF45"],"\xDC"=>[0,"\xF46"],"\xDD"=>[0,"\xF47"],"\xDE"=>[0,"\xF48"],"\xDF"=>[0,"\xF49"],"\xE0"=>[0,"\xF4\x3D"],"\xE1"=>[0,"\xF4A"],"\xE2"=>[0,"\xF4_"],"\xE3"=>[0,"\xF4b"],"\xE4"=>[0,"\xF4d"],"\xE5"=>[0,"\xF4f"],"\xE6"=>[0,"\xF4g"],"\xE7"=>[0,"\xF4h"],"\xE8"=>[0,"\xF4l"],"\xE9"=>[0,"\xF4m"],"\xEA"=>[0,"\xF4n"],"\xEB"=>[0,"\xF4p"],"\xEC"=>[0,"\xF4r"],"\xED"=>[0,"\xF4u"],"\xEE"=>[100,"\xF4"],"\xEF"=>[110,"\xF4"],"\xF0"=>[111,"\xF4"],"\xF1"=>[115,"\xF4"],"\xF2"=>[116,"\xF4"],"\xF3"=>[118,"\xF4"],"\xF4"=>[119,"\xF4"],"\xF5"=>[122,"\xF4"],"\xF6"=>[123,"\xF4"],"\xF7"=>[125,"\xF4"],"\xF8"=>[126,"\xF4"],"\xF9"=>[129,"\xF4"],"\xFA"=>[143,"\xF4"],"\xFB"=>[148,"\xF4"],"\xFC"=>[151,"\xF4"],"\xFD"=>[153,"\xF4"],"\xFE"=>[83,"\xF4"],"\xFF"=>[10,"\xF4"],],["\x00"=>[94,"\xE00"],"\x01"=>[76,"\xE00"],"\x02"=>[104,"\xE00"],"\x03"=>[16,"\xE00"],"\x04"=>[94,"\xE01"],"\x05"=>[76,"\xE01"],"\x06"=>[104,"\xE01"],"\x07"=>[16,"\xE01"],"\x08"=>[94,"\xE02"],"\x09"=>[76,"\xE02"],"\x0A"=>[104,"\xE02"],"\x0B"=>[16,"\xE02"],"\x0C"=>[94,"\xE0a"],"\x0D"=>[76,"\xE0a"],"\x0E"=>[104,"\xE0a"],"\x0F"=>[16,"\xE0a"],"\x10"=>[94,"\xE0c"],"\x11"=>[76,"\xE0c"],"\x12"=>[104,"\xE0c"],"\x13"=>[16,"\xE0c"],"\x14"=>[94,"\xE0e"],"\x15"=>[76,"\xE0e"],"\x16"=>[104,"\xE0e"],"\x17"=>[16,"\xE0e"],"\x18"=>[94,"\xE0i"],"\x19"=>[76,"\xE0i"],"\x1A"=>[104,"\xE0i"],"\x1B"=>[16,"\xE0i"],"\x1C"=>[94,"\xE0o"],"\x1D"=>[76,"\xE0o"],"\x1E"=>[104,"\xE0o"],"\x1F"=>[16,"\xE0o"],"\x20"=>[94,"\xE0s"],"\x21"=>[76,"\xE0s"],"\x22"=>[104,"\xE0s"],"\x23"=>[16,"\xE0s"],"\x24"=>[94,"\xE0t"],"\x25"=>[76,"\xE0t"],"\x26"=>[104,"\xE0t"],"\x27"=>[16,"\xE0t"],"\x28"=>[77,"\xE0\x20"],"\x29"=>[18,"\xE0\x20"],"\x2A"=>[77,"\xE0\x25"],"\x2B"=>[18,"\xE0\x25"],"\x2C"=>[77,"\xE0-"],"-"=>[18,"\xE0-"],"."=>[77,"\xE0."],"\x2F"=>[18,"\xE0."],[77,"\xE0\x2F"],[18,"\xE0\x2F"],[77,"\xE03"],[18,"\xE03"],[77,"\xE04"],[18,"\xE04"],[77,"\xE05"],[18,"\xE05"],[77,"\xE06"],[18,"\xE06"],"\x3A"=>[77,"\xE07"],"\x3B"=>[18,"\xE07"],"\x3C"=>[77,"\xE08"],"\x3D"=>[18,"\xE08"],"\x3E"=>[77,"\xE09"],"\x3F"=>[18,"\xE09"],"\x40"=>[77,"\xE0\x3D"],"A"=>[18,"\xE0\x3D"],"B"=>[77,"\xE0A"],"C"=>[18,"\xE0A"],"D"=>[77,"\xE0_"],"E"=>[18,"\xE0_"],"F"=>[77,"\xE0b"],"G"=>[18,"\xE0b"],"H"=>[77,"\xE0d"],"I"=>[18,"\xE0d"],"J"=>[77,"\xE0f"],"K"=>[18,"\xE0f"],"L"=>[77,"\xE0g"],"M"=>[18,"\xE0g"],"N"=>[77,"\xE0h"],"O"=>[18,"\xE0h"],"P"=>[77,"\xE0l"],"Q"=>[18,"\xE0l"],"R"=>[77,"\xE0m"],"S"=>[18,"\xE0m"],"T"=>[77,"\xE0n"],"U"=>[18,"\xE0n"],"V"=>[77,"\xE0p"],"W"=>[18,"\xE0p"],"X"=>[77,"\xE0r"],"Y"=>[18,"\xE0r"],"Z"=>[77,"\xE0u"],"\x5B"=>[18,"\xE0u"],"\x5C"=>[0,"\xE0\x3A"],"\x5D"=>[0,"\xE0B"],"\x5E"=>[0,"\xE0C"],"_"=>[0,"\xE0D"],"\x60"=>[0,"\xE0E"],"a"=>[0,"\xE0F"],"b"=>[0,"\xE0G"],"c"=>[0,"\xE0H"],"d"=>[0,"\xE0I"],"e"=>[0,"\xE0J"],"f"=>[0,"\xE0K"],"g"=>[0,"\xE0L"],"h"=>[0,"\xE0M"],"i"=>[0,"\xE0N"],"j"=>[0,"\xE0O"],"k"=>[0,"\xE0P"],"l"=>[0,"\xE0Q"],"m"=>[0,"\xE0R"],"n"=>[0,"\xE0S"],"o"=>[0,"\xE0T"],"p"=>[0,"\xE0U"],"q"=>[0,"\xE0V"],"r"=>[0,"\xE0W"],"s"=>[0,"\xE0Y"],"t"=>[0,"\xE0j"],"u"=>[0,"\xE0k"],"v"=>[0,"\xE0q"],"w"=>[0,"\xE0v"],"x"=>[0,"\xE0w"],"y"=>[0,"\xE0x"],"z"=>[0,"\xE0y"],"\x7B"=>[0,"\xE0z"],"\x7C"=>[82,"\xE0"],"\x7D"=>[87,"\xE0"],"~"=>[130,"\xE0"],"\x7F"=>[9,"\xE0"],"\x80"=>[94,"\xE20"],"\x81"=>[76,"\xE20"],"\x82"=>[104,"\xE20"],"\x83"=>[16,"\xE20"],"\x84"=>[94,"\xE21"],"\x85"=>[76,"\xE21"],"\x86"=>[104,"\xE21"],"\x87"=>[16,"\xE21"],"\x88"=>[94,"\xE22"],"\x89"=>[76,"\xE22"],"\x8A"=>[104,"\xE22"],"\x8B"=>[16,"\xE22"],"\x8C"=>[94,"\xE2a"],"\x8D"=>[76,"\xE2a"],"\x8E"=>[104,"\xE2a"],"\x8F"=>[16,"\xE2a"],"\x90"=>[94,"\xE2c"],"\x91"=>[76,"\xE2c"],"\x92"=>[104,"\xE2c"],"\x93"=>[16,"\xE2c"],"\x94"=>[94,"\xE2e"],"\x95"=>[76,"\xE2e"],"\x96"=>[104,"\xE2e"],"\x97"=>[16,"\xE2e"],"\x98"=>[94,"\xE2i"],"\x99"=>[76,"\xE2i"],"\x9A"=>[104,"\xE2i"],"\x9B"=>[16,"\xE2i"],"\x9C"=>[94,"\xE2o"],"\x9D"=>[76,"\xE2o"],"\x9E"=>[104,"\xE2o"],"\x9F"=>[16,"\xE2o"],"\xA0"=>[94,"\xE2s"],"\xA1"=>[76,"\xE2s"],"\xA2"=>[104,"\xE2s"],"\xA3"=>[16,"\xE2s"],"\xA4"=>[94,"\xE2t"],"\xA5"=>[76,"\xE2t"],"\xA6"=>[104,"\xE2t"],"\xA7"=>[16,"\xE2t"],"\xA8"=>[77,"\xE2\x20"],"\xA9"=>[18,"\xE2\x20"],"\xAA"=>[77,"\xE2\x25"],"\xAB"=>[18,"\xE2\x25"],"\xAC"=>[77,"\xE2-"],"\xAD"=>[18,"\xE2-"],"\xAE"=>[77,"\xE2."],"\xAF"=>[18,"\xE2."],"\xB0"=>[77,"\xE2\x2F"],"\xB1"=>[18,"\xE2\x2F"],"\xB2"=>[77,"\xE23"],"\xB3"=>[18,"\xE23"],"\xB4"=>[77,"\xE24"],"\xB5"=>[18,"\xE24"],"\xB6"=>[77,"\xE25"],"\xB7"=>[18,"\xE25"],"\xB8"=>[77,"\xE26"],"\xB9"=>[18,"\xE26"],"\xBA"=>[77,"\xE27"],"\xBB"=>[18,"\xE27"],"\xBC"=>[77,"\xE28"],"\xBD"=>[18,"\xE28"],"\xBE"=>[77,"\xE29"],"\xBF"=>[18,"\xE29"],"\xC0"=>[77,"\xE2\x3D"],"\xC1"=>[18,"\xE2\x3D"],"\xC2"=>[77,"\xE2A"],"\xC3"=>[18,"\xE2A"],"\xC4"=>[77,"\xE2_"],"\xC5"=>[18,"\xE2_"],"\xC6"=>[77,"\xE2b"],"\xC7"=>[18,"\xE2b"],"\xC8"=>[77,"\xE2d"],"\xC9"=>[18,"\xE2d"],"\xCA"=>[77,"\xE2f"],"\xCB"=>[18,"\xE2f"],"\xCC"=>[77,"\xE2g"],"\xCD"=>[18,"\xE2g"],"\xCE"=>[77,"\xE2h"],"\xCF"=>[18,"\xE2h"],"\xD0"=>[77,"\xE2l"],"\xD1"=>[18,"\xE2l"],"\xD2"=>[77,"\xE2m"],"\xD3"=>[18,"\xE2m"],"\xD4"=>[77,"\xE2n"],"\xD5"=>[18,"\xE2n"],"\xD6"=>[77,"\xE2p"],"\xD7"=>[18,"\xE2p"],"\xD8"=>[77,"\xE2r"],"\xD9"=>[18,"\xE2r"],"\xDA"=>[77,"\xE2u"],"\xDB"=>[18,"\xE2u"],"\xDC"=>[0,"\xE2\x3A"],"\xDD"=>[0,"\xE2B"],"\xDE"=>[0,"\xE2C"],"\xDF"=>[0,"\xE2D"],"\xE0"=>[0,"\xE2E"],"\xE1"=>[0,"\xE2F"],"\xE2"=>[0,"\xE2G"],"\xE3"=>[0,"\xE2H"],"\xE4"=>[0,"\xE2I"],"\xE5"=>[0,"\xE2J"],"\xE6"=>[0,"\xE2K"],"\xE7"=>[0,"\xE2L"],"\xE8"=>[0,"\xE2M"],"\xE9"=>[0,"\xE2N"],"\xEA"=>[0,"\xE2O"],"\xEB"=>[0,"\xE2P"],"\xEC"=>[0,"\xE2Q"],"\xED"=>[0,"\xE2R"],"\xEE"=>[0,"\xE2S"],"\xEF"=>[0,"\xE2T"],"\xF0"=>[0,"\xE2U"],"\xF1"=>[0,"\xE2V"],"\xF2"=>[0,"\xE2W"],"\xF3"=>[0,"\xE2Y"],"\xF4"=>[0,"\xE2j"],"\xF5"=>[0,"\xE2k"],"\xF6"=>[0,"\xE2q"],"\xF7"=>[0,"\xE2v"],"\xF8"=>[0,"\xE2w"],"\xF9"=>[0,"\xE2x"],"\xFA"=>[0,"\xE2y"],"\xFB"=>[0,"\xE2z"],"\xFC"=>[82,"\xE2"],"\xFD"=>[87,"\xE2"],"\xFE"=>[130,"\xE2"],"\xFF"=>[9,"\xE2"],],["\x00"=>[94,"\xE30"],"\x01"=>[76,"\xE30"],"\x02"=>[104,"\xE30"],"\x03"=>[16,"\xE30"],"\x04"=>[94,"\xE31"],"\x05"=>[76,"\xE31"],"\x06"=>[104,"\xE31"],"\x07"=>[16,"\xE31"],"\x08"=>[94,"\xE32"],"\x09"=>[76,"\xE32"],"\x0A"=>[104,"\xE32"],"\x0B"=>[16,"\xE32"],"\x0C"=>[94,"\xE3a"],"\x0D"=>[76,"\xE3a"],"\x0E"=>[104,"\xE3a"],"\x0F"=>[16,"\xE3a"],"\x10"=>[94,"\xE3c"],"\x11"=>[76,"\xE3c"],"\x12"=>[104,"\xE3c"],"\x13"=>[16,"\xE3c"],"\x14"=>[94,"\xE3e"],"\x15"=>[76,"\xE3e"],"\x16"=>[104,"\xE3e"],"\x17"=>[16,"\xE3e"],"\x18"=>[94,"\xE3i"],"\x19"=>[76,"\xE3i"],"\x1A"=>[104,"\xE3i"],"\x1B"=>[16,"\xE3i"],"\x1C"=>[94,"\xE3o"],"\x1D"=>[76,"\xE3o"],"\x1E"=>[104,"\xE3o"],"\x1F"=>[16,"\xE3o"],"\x20"=>[94,"\xE3s"],"\x21"=>[76,"\xE3s"],"\x22"=>[104,"\xE3s"],"\x23"=>[16,"\xE3s"],"\x24"=>[94,"\xE3t"],"\x25"=>[76,"\xE3t"],"\x26"=>[104,"\xE3t"],"\x27"=>[16,"\xE3t"],"\x28"=>[77,"\xE3\x20"],"\x29"=>[18,"\xE3\x20"],"\x2A"=>[77,"\xE3\x25"],"\x2B"=>[18,"\xE3\x25"],"\x2C"=>[77,"\xE3-"],"-"=>[18,"\xE3-"],"."=>[77,"\xE3."],"\x2F"=>[18,"\xE3."],[77,"\xE3\x2F"],[18,"\xE3\x2F"],[77,"\xE33"],[18,"\xE33"],[77,"\xE34"],[18,"\xE34"],[77,"\xE35"],[18,"\xE35"],[77,"\xE36"],[18,"\xE36"],"\x3A"=>[77,"\xE37"],"\x3B"=>[18,"\xE37"],"\x3C"=>[77,"\xE38"],"\x3D"=>[18,"\xE38"],"\x3E"=>[77,"\xE39"],"\x3F"=>[18,"\xE39"],"\x40"=>[77,"\xE3\x3D"],"A"=>[18,"\xE3\x3D"],"B"=>[77,"\xE3A"],"C"=>[18,"\xE3A"],"D"=>[77,"\xE3_"],"E"=>[18,"\xE3_"],"F"=>[77,"\xE3b"],"G"=>[18,"\xE3b"],"H"=>[77,"\xE3d"],"I"=>[18,"\xE3d"],"J"=>[77,"\xE3f"],"K"=>[18,"\xE3f"],"L"=>[77,"\xE3g"],"M"=>[18,"\xE3g"],"N"=>[77,"\xE3h"],"O"=>[18,"\xE3h"],"P"=>[77,"\xE3l"],"Q"=>[18,"\xE3l"],"R"=>[77,"\xE3m"],"S"=>[18,"\xE3m"],"T"=>[77,"\xE3n"],"U"=>[18,"\xE3n"],"V"=>[77,"\xE3p"],"W"=>[18,"\xE3p"],"X"=>[77,"\xE3r"],"Y"=>[18,"\xE3r"],"Z"=>[77,"\xE3u"],"\x5B"=>[18,"\xE3u"],"\x5C"=>[0,"\xE3\x3A"],"\x5D"=>[0,"\xE3B"],"\x5E"=>[0,"\xE3C"],"_"=>[0,"\xE3D"],"\x60"=>[0,"\xE3E"],"a"=>[0,"\xE3F"],"b"=>[0,"\xE3G"],"c"=>[0,"\xE3H"],"d"=>[0,"\xE3I"],"e"=>[0,"\xE3J"],"f"=>[0,"\xE3K"],"g"=>[0,"\xE3L"],"h"=>[0,"\xE3M"],"i"=>[0,"\xE3N"],"j"=>[0,"\xE3O"],"k"=>[0,"\xE3P"],"l"=>[0,"\xE3Q"],"m"=>[0,"\xE3R"],"n"=>[0,"\xE3S"],"o"=>[0,"\xE3T"],"p"=>[0,"\xE3U"],"q"=>[0,"\xE3V"],"r"=>[0,"\xE3W"],"s"=>[0,"\xE3Y"],"t"=>[0,"\xE3j"],"u"=>[0,"\xE3k"],"v"=>[0,"\xE3q"],"w"=>[0,"\xE3v"],"x"=>[0,"\xE3w"],"y"=>[0,"\xE3x"],"z"=>[0,"\xE3y"],"\x7B"=>[0,"\xE3z"],"\x7C"=>[82,"\xE3"],"\x7D"=>[87,"\xE3"],"~"=>[130,"\xE3"],"\x7F"=>[9,"\xE3"],"\x80"=>[94,"\xE50"],"\x81"=>[76,"\xE50"],"\x82"=>[104,"\xE50"],"\x83"=>[16,"\xE50"],"\x84"=>[94,"\xE51"],"\x85"=>[76,"\xE51"],"\x86"=>[104,"\xE51"],"\x87"=>[16,"\xE51"],"\x88"=>[94,"\xE52"],"\x89"=>[76,"\xE52"],"\x8A"=>[104,"\xE52"],"\x8B"=>[16,"\xE52"],"\x8C"=>[94,"\xE5a"],"\x8D"=>[76,"\xE5a"],"\x8E"=>[104,"\xE5a"],"\x8F"=>[16,"\xE5a"],"\x90"=>[94,"\xE5c"],"\x91"=>[76,"\xE5c"],"\x92"=>[104,"\xE5c"],"\x93"=>[16,"\xE5c"],"\x94"=>[94,"\xE5e"],"\x95"=>[76,"\xE5e"],"\x96"=>[104,"\xE5e"],"\x97"=>[16,"\xE5e"],"\x98"=>[94,"\xE5i"],"\x99"=>[76,"\xE5i"],"\x9A"=>[104,"\xE5i"],"\x9B"=>[16,"\xE5i"],"\x9C"=>[94,"\xE5o"],"\x9D"=>[76,"\xE5o"],"\x9E"=>[104,"\xE5o"],"\x9F"=>[16,"\xE5o"],"\xA0"=>[94,"\xE5s"],"\xA1"=>[76,"\xE5s"],"\xA2"=>[104,"\xE5s"],"\xA3"=>[16,"\xE5s"],"\xA4"=>[94,"\xE5t"],"\xA5"=>[76,"\xE5t"],"\xA6"=>[104,"\xE5t"],"\xA7"=>[16,"\xE5t"],"\xA8"=>[77,"\xE5\x20"],"\xA9"=>[18,"\xE5\x20"],"\xAA"=>[77,"\xE5\x25"],"\xAB"=>[18,"\xE5\x25"],"\xAC"=>[77,"\xE5-"],"\xAD"=>[18,"\xE5-"],"\xAE"=>[77,"\xE5."],"\xAF"=>[18,"\xE5."],"\xB0"=>[77,"\xE5\x2F"],"\xB1"=>[18,"\xE5\x2F"],"\xB2"=>[77,"\xE53"],"\xB3"=>[18,"\xE53"],"\xB4"=>[77,"\xE54"],"\xB5"=>[18,"\xE54"],"\xB6"=>[77,"\xE55"],"\xB7"=>[18,"\xE55"],"\xB8"=>[77,"\xE56"],"\xB9"=>[18,"\xE56"],"\xBA"=>[77,"\xE57"],"\xBB"=>[18,"\xE57"],"\xBC"=>[77,"\xE58"],"\xBD"=>[18,"\xE58"],"\xBE"=>[77,"\xE59"],"\xBF"=>[18,"\xE59"],"\xC0"=>[77,"\xE5\x3D"],"\xC1"=>[18,"\xE5\x3D"],"\xC2"=>[77,"\xE5A"],"\xC3"=>[18,"\xE5A"],"\xC4"=>[77,"\xE5_"],"\xC5"=>[18,"\xE5_"],"\xC6"=>[77,"\xE5b"],"\xC7"=>[18,"\xE5b"],"\xC8"=>[77,"\xE5d"],"\xC9"=>[18,"\xE5d"],"\xCA"=>[77,"\xE5f"],"\xCB"=>[18,"\xE5f"],"\xCC"=>[77,"\xE5g"],"\xCD"=>[18,"\xE5g"],"\xCE"=>[77,"\xE5h"],"\xCF"=>[18,"\xE5h"],"\xD0"=>[77,"\xE5l"],"\xD1"=>[18,"\xE5l"],"\xD2"=>[77,"\xE5m"],"\xD3"=>[18,"\xE5m"],"\xD4"=>[77,"\xE5n"],"\xD5"=>[18,"\xE5n"],"\xD6"=>[77,"\xE5p"],"\xD7"=>[18,"\xE5p"],"\xD8"=>[77,"\xE5r"],"\xD9"=>[18,"\xE5r"],"\xDA"=>[77,"\xE5u"],"\xDB"=>[18,"\xE5u"],"\xDC"=>[0,"\xE5\x3A"],"\xDD"=>[0,"\xE5B"],"\xDE"=>[0,"\xE5C"],"\xDF"=>[0,"\xE5D"],"\xE0"=>[0,"\xE5E"],"\xE1"=>[0,"\xE5F"],"\xE2"=>[0,"\xE5G"],"\xE3"=>[0,"\xE5H"],"\xE4"=>[0,"\xE5I"],"\xE5"=>[0,"\xE5J"],"\xE6"=>[0,"\xE5K"],"\xE7"=>[0,"\xE5L"],"\xE8"=>[0,"\xE5M"],"\xE9"=>[0,"\xE5N"],"\xEA"=>[0,"\xE5O"],"\xEB"=>[0,"\xE5P"],"\xEC"=>[0,"\xE5Q"],"\xED"=>[0,"\xE5R"],"\xEE"=>[0,"\xE5S"],"\xEF"=>[0,"\xE5T"],"\xF0"=>[0,"\xE5U"],"\xF1"=>[0,"\xE5V"],"\xF2"=>[0,"\xE5W"],"\xF3"=>[0,"\xE5Y"],"\xF4"=>[0,"\xE5j"],"\xF5"=>[0,"\xE5k"],"\xF6"=>[0,"\xE5q"],"\xF7"=>[0,"\xE5v"],"\xF8"=>[0,"\xE5w"],"\xF9"=>[0,"\xE5x"],"\xFA"=>[0,"\xE5y"],"\xFB"=>[0,"\xE5z"],"\xFC"=>[82,"\xE5"],"\xFD"=>[87,"\xE5"],"\xFE"=>[130,"\xE5"],"\xFF"=>[9,"\xE5"],],["\x00"=>[94,"\xE80"],"\x01"=>[76,"\xE80"],"\x02"=>[104,"\xE80"],"\x03"=>[16,"\xE80"],"\x04"=>[94,"\xE81"],"\x05"=>[76,"\xE81"],"\x06"=>[104,"\xE81"],"\x07"=>[16,"\xE81"],"\x08"=>[94,"\xE82"],"\x09"=>[76,"\xE82"],"\x0A"=>[104,"\xE82"],"\x0B"=>[16,"\xE82"],"\x0C"=>[94,"\xE8a"],"\x0D"=>[76,"\xE8a"],"\x0E"=>[104,"\xE8a"],"\x0F"=>[16,"\xE8a"],"\x10"=>[94,"\xE8c"],"\x11"=>[76,"\xE8c"],"\x12"=>[104,"\xE8c"],"\x13"=>[16,"\xE8c"],"\x14"=>[94,"\xE8e"],"\x15"=>[76,"\xE8e"],"\x16"=>[104,"\xE8e"],"\x17"=>[16,"\xE8e"],"\x18"=>[94,"\xE8i"],"\x19"=>[76,"\xE8i"],"\x1A"=>[104,"\xE8i"],"\x1B"=>[16,"\xE8i"],"\x1C"=>[94,"\xE8o"],"\x1D"=>[76,"\xE8o"],"\x1E"=>[104,"\xE8o"],"\x1F"=>[16,"\xE8o"],"\x20"=>[94,"\xE8s"],"\x21"=>[76,"\xE8s"],"\x22"=>[104,"\xE8s"],"\x23"=>[16,"\xE8s"],"\x24"=>[94,"\xE8t"],"\x25"=>[76,"\xE8t"],"\x26"=>[104,"\xE8t"],"\x27"=>[16,"\xE8t"],"\x28"=>[77,"\xE8\x20"],"\x29"=>[18,"\xE8\x20"],"\x2A"=>[77,"\xE8\x25"],"\x2B"=>[18,"\xE8\x25"],"\x2C"=>[77,"\xE8-"],"-"=>[18,"\xE8-"],"."=>[77,"\xE8."],"\x2F"=>[18,"\xE8."],[77,"\xE8\x2F"],[18,"\xE8\x2F"],[77,"\xE83"],[18,"\xE83"],[77,"\xE84"],[18,"\xE84"],[77,"\xE85"],[18,"\xE85"],[77,"\xE86"],[18,"\xE86"],"\x3A"=>[77,"\xE87"],"\x3B"=>[18,"\xE87"],"\x3C"=>[77,"\xE88"],"\x3D"=>[18,"\xE88"],"\x3E"=>[77,"\xE89"],"\x3F"=>[18,"\xE89"],"\x40"=>[77,"\xE8\x3D"],"A"=>[18,"\xE8\x3D"],"B"=>[77,"\xE8A"],"C"=>[18,"\xE8A"],"D"=>[77,"\xE8_"],"E"=>[18,"\xE8_"],"F"=>[77,"\xE8b"],"G"=>[18,"\xE8b"],"H"=>[77,"\xE8d"],"I"=>[18,"\xE8d"],"J"=>[77,"\xE8f"],"K"=>[18,"\xE8f"],"L"=>[77,"\xE8g"],"M"=>[18,"\xE8g"],"N"=>[77,"\xE8h"],"O"=>[18,"\xE8h"],"P"=>[77,"\xE8l"],"Q"=>[18,"\xE8l"],"R"=>[77,"\xE8m"],"S"=>[18,"\xE8m"],"T"=>[77,"\xE8n"],"U"=>[18,"\xE8n"],"V"=>[77,"\xE8p"],"W"=>[18,"\xE8p"],"X"=>[77,"\xE8r"],"Y"=>[18,"\xE8r"],"Z"=>[77,"\xE8u"],"\x5B"=>[18,"\xE8u"],"\x5C"=>[0,"\xE8\x3A"],"\x5D"=>[0,"\xE8B"],"\x5E"=>[0,"\xE8C"],"_"=>[0,"\xE8D"],"\x60"=>[0,"\xE8E"],"a"=>[0,"\xE8F"],"b"=>[0,"\xE8G"],"c"=>[0,"\xE8H"],"d"=>[0,"\xE8I"],"e"=>[0,"\xE8J"],"f"=>[0,"\xE8K"],"g"=>[0,"\xE8L"],"h"=>[0,"\xE8M"],"i"=>[0,"\xE8N"],"j"=>[0,"\xE8O"],"k"=>[0,"\xE8P"],"l"=>[0,"\xE8Q"],"m"=>[0,"\xE8R"],"n"=>[0,"\xE8S"],"o"=>[0,"\xE8T"],"p"=>[0,"\xE8U"],"q"=>[0,"\xE8V"],"r"=>[0,"\xE8W"],"s"=>[0,"\xE8Y"],"t"=>[0,"\xE8j"],"u"=>[0,"\xE8k"],"v"=>[0,"\xE8q"],"w"=>[0,"\xE8v"],"x"=>[0,"\xE8w"],"y"=>[0,"\xE8x"],"z"=>[0,"\xE8y"],"\x7B"=>[0,"\xE8z"],"\x7C"=>[82,"\xE8"],"\x7D"=>[87,"\xE8"],"~"=>[130,"\xE8"],"\x7F"=>[9,"\xE8"],"\x80"=>[94,"\xE90"],"\x81"=>[76,"\xE90"],"\x82"=>[104,"\xE90"],"\x83"=>[16,"\xE90"],"\x84"=>[94,"\xE91"],"\x85"=>[76,"\xE91"],"\x86"=>[104,"\xE91"],"\x87"=>[16,"\xE91"],"\x88"=>[94,"\xE92"],"\x89"=>[76,"\xE92"],"\x8A"=>[104,"\xE92"],"\x8B"=>[16,"\xE92"],"\x8C"=>[94,"\xE9a"],"\x8D"=>[76,"\xE9a"],"\x8E"=>[104,"\xE9a"],"\x8F"=>[16,"\xE9a"],"\x90"=>[94,"\xE9c"],"\x91"=>[76,"\xE9c"],"\x92"=>[104,"\xE9c"],"\x93"=>[16,"\xE9c"],"\x94"=>[94,"\xE9e"],"\x95"=>[76,"\xE9e"],"\x96"=>[104,"\xE9e"],"\x97"=>[16,"\xE9e"],"\x98"=>[94,"\xE9i"],"\x99"=>[76,"\xE9i"],"\x9A"=>[104,"\xE9i"],"\x9B"=>[16,"\xE9i"],"\x9C"=>[94,"\xE9o"],"\x9D"=>[76,"\xE9o"],"\x9E"=>[104,"\xE9o"],"\x9F"=>[16,"\xE9o"],"\xA0"=>[94,"\xE9s"],"\xA1"=>[76,"\xE9s"],"\xA2"=>[104,"\xE9s"],"\xA3"=>[16,"\xE9s"],"\xA4"=>[94,"\xE9t"],"\xA5"=>[76,"\xE9t"],"\xA6"=>[104,"\xE9t"],"\xA7"=>[16,"\xE9t"],"\xA8"=>[77,"\xE9\x20"],"\xA9"=>[18,"\xE9\x20"],"\xAA"=>[77,"\xE9\x25"],"\xAB"=>[18,"\xE9\x25"],"\xAC"=>[77,"\xE9-"],"\xAD"=>[18,"\xE9-"],"\xAE"=>[77,"\xE9."],"\xAF"=>[18,"\xE9."],"\xB0"=>[77,"\xE9\x2F"],"\xB1"=>[18,"\xE9\x2F"],"\xB2"=>[77,"\xE93"],"\xB3"=>[18,"\xE93"],"\xB4"=>[77,"\xE94"],"\xB5"=>[18,"\xE94"],"\xB6"=>[77,"\xE95"],"\xB7"=>[18,"\xE95"],"\xB8"=>[77,"\xE96"],"\xB9"=>[18,"\xE96"],"\xBA"=>[77,"\xE97"],"\xBB"=>[18,"\xE97"],"\xBC"=>[77,"\xE98"],"\xBD"=>[18,"\xE98"],"\xBE"=>[77,"\xE99"],"\xBF"=>[18,"\xE99"],"\xC0"=>[77,"\xE9\x3D"],"\xC1"=>[18,"\xE9\x3D"],"\xC2"=>[77,"\xE9A"],"\xC3"=>[18,"\xE9A"],"\xC4"=>[77,"\xE9_"],"\xC5"=>[18,"\xE9_"],"\xC6"=>[77,"\xE9b"],"\xC7"=>[18,"\xE9b"],"\xC8"=>[77,"\xE9d"],"\xC9"=>[18,"\xE9d"],"\xCA"=>[77,"\xE9f"],"\xCB"=>[18,"\xE9f"],"\xCC"=>[77,"\xE9g"],"\xCD"=>[18,"\xE9g"],"\xCE"=>[77,"\xE9h"],"\xCF"=>[18,"\xE9h"],"\xD0"=>[77,"\xE9l"],"\xD1"=>[18,"\xE9l"],"\xD2"=>[77,"\xE9m"],"\xD3"=>[18,"\xE9m"],"\xD4"=>[77,"\xE9n"],"\xD5"=>[18,"\xE9n"],"\xD6"=>[77,"\xE9p"],"\xD7"=>[18,"\xE9p"],"\xD8"=>[77,"\xE9r"],"\xD9"=>[18,"\xE9r"],"\xDA"=>[77,"\xE9u"],"\xDB"=>[18,"\xE9u"],"\xDC"=>[0,"\xE9\x3A"],"\xDD"=>[0,"\xE9B"],"\xDE"=>[0,"\xE9C"],"\xDF"=>[0,"\xE9D"],"\xE0"=>[0,"\xE9E"],"\xE1"=>[0,"\xE9F"],"\xE2"=>[0,"\xE9G"],"\xE3"=>[0,"\xE9H"],"\xE4"=>[0,"\xE9I"],"\xE5"=>[0,"\xE9J"],"\xE6"=>[0,"\xE9K"],"\xE7"=>[0,"\xE9L"],"\xE8"=>[0,"\xE9M"],"\xE9"=>[0,"\xE9N"],"\xEA"=>[0,"\xE9O"],"\xEB"=>[0,"\xE9P"],"\xEC"=>[0,"\xE9Q"],"\xED"=>[0,"\xE9R"],"\xEE"=>[0,"\xE9S"],"\xEF"=>[0,"\xE9T"],"\xF0"=>[0,"\xE9U"],"\xF1"=>[0,"\xE9V"],"\xF2"=>[0,"\xE9W"],"\xF3"=>[0,"\xE9Y"],"\xF4"=>[0,"\xE9j"],"\xF5"=>[0,"\xE9k"],"\xF6"=>[0,"\xE9q"],"\xF7"=>[0,"\xE9v"],"\xF8"=>[0,"\xE9w"],"\xF9"=>[0,"\xE9x"],"\xFA"=>[0,"\xE9y"],"\xFB"=>[0,"\xE9z"],"\xFC"=>[82,"\xE9"],"\xFD"=>[87,"\xE9"],"\xFE"=>[130,"\xE9"],"\xFF"=>[9,"\xE9"],],["\x00"=>[94,"\xEA0"],"\x01"=>[76,"\xEA0"],"\x02"=>[104,"\xEA0"],"\x03"=>[16,"\xEA0"],"\x04"=>[94,"\xEA1"],"\x05"=>[76,"\xEA1"],"\x06"=>[104,"\xEA1"],"\x07"=>[16,"\xEA1"],"\x08"=>[94,"\xEA2"],"\x09"=>[76,"\xEA2"],"\x0A"=>[104,"\xEA2"],"\x0B"=>[16,"\xEA2"],"\x0C"=>[94,"\xEAa"],"\x0D"=>[76,"\xEAa"],"\x0E"=>[104,"\xEAa"],"\x0F"=>[16,"\xEAa"],"\x10"=>[94,"\xEAc"],"\x11"=>[76,"\xEAc"],"\x12"=>[104,"\xEAc"],"\x13"=>[16,"\xEAc"],"\x14"=>[94,"\xEAe"],"\x15"=>[76,"\xEAe"],"\x16"=>[104,"\xEAe"],"\x17"=>[16,"\xEAe"],"\x18"=>[94,"\xEAi"],"\x19"=>[76,"\xEAi"],"\x1A"=>[104,"\xEAi"],"\x1B"=>[16,"\xEAi"],"\x1C"=>[94,"\xEAo"],"\x1D"=>[76,"\xEAo"],"\x1E"=>[104,"\xEAo"],"\x1F"=>[16,"\xEAo"],"\x20"=>[94,"\xEAs"],"\x21"=>[76,"\xEAs"],"\x22"=>[104,"\xEAs"],"\x23"=>[16,"\xEAs"],"\x24"=>[94,"\xEAt"],"\x25"=>[76,"\xEAt"],"\x26"=>[104,"\xEAt"],"\x27"=>[16,"\xEAt"],"\x28"=>[77,"\xEA\x20"],"\x29"=>[18,"\xEA\x20"],"\x2A"=>[77,"\xEA\x25"],"\x2B"=>[18,"\xEA\x25"],"\x2C"=>[77,"\xEA-"],"-"=>[18,"\xEA-"],"."=>[77,"\xEA."],"\x2F"=>[18,"\xEA."],[77,"\xEA\x2F"],[18,"\xEA\x2F"],[77,"\xEA3"],[18,"\xEA3"],[77,"\xEA4"],[18,"\xEA4"],[77,"\xEA5"],[18,"\xEA5"],[77,"\xEA6"],[18,"\xEA6"],"\x3A"=>[77,"\xEA7"],"\x3B"=>[18,"\xEA7"],"\x3C"=>[77,"\xEA8"],"\x3D"=>[18,"\xEA8"],"\x3E"=>[77,"\xEA9"],"\x3F"=>[18,"\xEA9"],"\x40"=>[77,"\xEA\x3D"],"A"=>[18,"\xEA\x3D"],"B"=>[77,"\xEAA"],"C"=>[18,"\xEAA"],"D"=>[77,"\xEA_"],"E"=>[18,"\xEA_"],"F"=>[77,"\xEAb"],"G"=>[18,"\xEAb"],"H"=>[77,"\xEAd"],"I"=>[18,"\xEAd"],"J"=>[77,"\xEAf"],"K"=>[18,"\xEAf"],"L"=>[77,"\xEAg"],"M"=>[18,"\xEAg"],"N"=>[77,"\xEAh"],"O"=>[18,"\xEAh"],"P"=>[77,"\xEAl"],"Q"=>[18,"\xEAl"],"R"=>[77,"\xEAm"],"S"=>[18,"\xEAm"],"T"=>[77,"\xEAn"],"U"=>[18,"\xEAn"],"V"=>[77,"\xEAp"],"W"=>[18,"\xEAp"],"X"=>[77,"\xEAr"],"Y"=>[18,"\xEAr"],"Z"=>[77,"\xEAu"],"\x5B"=>[18,"\xEAu"],"\x5C"=>[0,"\xEA\x3A"],"\x5D"=>[0,"\xEAB"],"\x5E"=>[0,"\xEAC"],"_"=>[0,"\xEAD"],"\x60"=>[0,"\xEAE"],"a"=>[0,"\xEAF"],"b"=>[0,"\xEAG"],"c"=>[0,"\xEAH"],"d"=>[0,"\xEAI"],"e"=>[0,"\xEAJ"],"f"=>[0,"\xEAK"],"g"=>[0,"\xEAL"],"h"=>[0,"\xEAM"],"i"=>[0,"\xEAN"],"j"=>[0,"\xEAO"],"k"=>[0,"\xEAP"],"l"=>[0,"\xEAQ"],"m"=>[0,"\xEAR"],"n"=>[0,"\xEAS"],"o"=>[0,"\xEAT"],"p"=>[0,"\xEAU"],"q"=>[0,"\xEAV"],"r"=>[0,"\xEAW"],"s"=>[0,"\xEAY"],"t"=>[0,"\xEAj"],"u"=>[0,"\xEAk"],"v"=>[0,"\xEAq"],"w"=>[0,"\xEAv"],"x"=>[0,"\xEAw"],"y"=>[0,"\xEAx"],"z"=>[0,"\xEAy"],"\x7B"=>[0,"\xEAz"],"\x7C"=>[82,"\xEA"],"\x7D"=>[87,"\xEA"],"~"=>[130,"\xEA"],"\x7F"=>[9,"\xEA"],"\x80"=>[94,"\xEB0"],"\x81"=>[76,"\xEB0"],"\x82"=>[104,"\xEB0"],"\x83"=>[16,"\xEB0"],"\x84"=>[94,"\xEB1"],"\x85"=>[76,"\xEB1"],"\x86"=>[104,"\xEB1"],"\x87"=>[16,"\xEB1"],"\x88"=>[94,"\xEB2"],"\x89"=>[76,"\xEB2"],"\x8A"=>[104,"\xEB2"],"\x8B"=>[16,"\xEB2"],"\x8C"=>[94,"\xEBa"],"\x8D"=>[76,"\xEBa"],"\x8E"=>[104,"\xEBa"],"\x8F"=>[16,"\xEBa"],"\x90"=>[94,"\xEBc"],"\x91"=>[76,"\xEBc"],"\x92"=>[104,"\xEBc"],"\x93"=>[16,"\xEBc"],"\x94"=>[94,"\xEBe"],"\x95"=>[76,"\xEBe"],"\x96"=>[104,"\xEBe"],"\x97"=>[16,"\xEBe"],"\x98"=>[94,"\xEBi"],"\x99"=>[76,"\xEBi"],"\x9A"=>[104,"\xEBi"],"\x9B"=>[16,"\xEBi"],"\x9C"=>[94,"\xEBo"],"\x9D"=>[76,"\xEBo"],"\x9E"=>[104,"\xEBo"],"\x9F"=>[16,"\xEBo"],"\xA0"=>[94,"\xEBs"],"\xA1"=>[76,"\xEBs"],"\xA2"=>[104,"\xEBs"],"\xA3"=>[16,"\xEBs"],"\xA4"=>[94,"\xEBt"],"\xA5"=>[76,"\xEBt"],"\xA6"=>[104,"\xEBt"],"\xA7"=>[16,"\xEBt"],"\xA8"=>[77,"\xEB\x20"],"\xA9"=>[18,"\xEB\x20"],"\xAA"=>[77,"\xEB\x25"],"\xAB"=>[18,"\xEB\x25"],"\xAC"=>[77,"\xEB-"],"\xAD"=>[18,"\xEB-"],"\xAE"=>[77,"\xEB."],"\xAF"=>[18,"\xEB."],"\xB0"=>[77,"\xEB\x2F"],"\xB1"=>[18,"\xEB\x2F"],"\xB2"=>[77,"\xEB3"],"\xB3"=>[18,"\xEB3"],"\xB4"=>[77,"\xEB4"],"\xB5"=>[18,"\xEB4"],"\xB6"=>[77,"\xEB5"],"\xB7"=>[18,"\xEB5"],"\xB8"=>[77,"\xEB6"],"\xB9"=>[18,"\xEB6"],"\xBA"=>[77,"\xEB7"],"\xBB"=>[18,"\xEB7"],"\xBC"=>[77,"\xEB8"],"\xBD"=>[18,"\xEB8"],"\xBE"=>[77,"\xEB9"],"\xBF"=>[18,"\xEB9"],"\xC0"=>[77,"\xEB\x3D"],"\xC1"=>[18,"\xEB\x3D"],"\xC2"=>[77,"\xEBA"],"\xC3"=>[18,"\xEBA"],"\xC4"=>[77,"\xEB_"],"\xC5"=>[18,"\xEB_"],"\xC6"=>[77,"\xEBb"],"\xC7"=>[18,"\xEBb"],"\xC8"=>[77,"\xEBd"],"\xC9"=>[18,"\xEBd"],"\xCA"=>[77,"\xEBf"],"\xCB"=>[18,"\xEBf"],"\xCC"=>[77,"\xEBg"],"\xCD"=>[18,"\xEBg"],"\xCE"=>[77,"\xEBh"],"\xCF"=>[18,"\xEBh"],"\xD0"=>[77,"\xEBl"],"\xD1"=>[18,"\xEBl"],"\xD2"=>[77,"\xEBm"],"\xD3"=>[18,"\xEBm"],"\xD4"=>[77,"\xEBn"],"\xD5"=>[18,"\xEBn"],"\xD6"=>[77,"\xEBp"],"\xD7"=>[18,"\xEBp"],"\xD8"=>[77,"\xEBr"],"\xD9"=>[18,"\xEBr"],"\xDA"=>[77,"\xEBu"],"\xDB"=>[18,"\xEBu"],"\xDC"=>[0,"\xEB\x3A"],"\xDD"=>[0,"\xEBB"],"\xDE"=>[0,"\xEBC"],"\xDF"=>[0,"\xEBD"],"\xE0"=>[0,"\xEBE"],"\xE1"=>[0,"\xEBF"],"\xE2"=>[0,"\xEBG"],"\xE3"=>[0,"\xEBH"],"\xE4"=>[0,"\xEBI"],"\xE5"=>[0,"\xEBJ"],"\xE6"=>[0,"\xEBK"],"\xE7"=>[0,"\xEBL"],"\xE8"=>[0,"\xEBM"],"\xE9"=>[0,"\xEBN"],"\xEA"=>[0,"\xEBO"],"\xEB"=>[0,"\xEBP"],"\xEC"=>[0,"\xEBQ"],"\xED"=>[0,"\xEBR"],"\xEE"=>[0,"\xEBS"],"\xEF"=>[0,"\xEBT"],"\xF0"=>[0,"\xEBU"],"\xF1"=>[0,"\xEBV"],"\xF2"=>[0,"\xEBW"],"\xF3"=>[0,"\xEBY"],"\xF4"=>[0,"\xEBj"],"\xF5"=>[0,"\xEBk"],"\xF6"=>[0,"\xEBq"],"\xF7"=>[0,"\xEBv"],"\xF8"=>[0,"\xEBw"],"\xF9"=>[0,"\xEBx"],"\xFA"=>[0,"\xEBy"],"\xFB"=>[0,"\xEBz"],"\xFC"=>[82,"\xEB"],"\xFD"=>[87,"\xEB"],"\xFE"=>[130,"\xEB"],"\xFF"=>[9,"\xEB"],],["\x00"=>[94,"\xEC0"],"\x01"=>[76,"\xEC0"],"\x02"=>[104,"\xEC0"],"\x03"=>[16,"\xEC0"],"\x04"=>[94,"\xEC1"],"\x05"=>[76,"\xEC1"],"\x06"=>[104,"\xEC1"],"\x07"=>[16,"\xEC1"],"\x08"=>[94,"\xEC2"],"\x09"=>[76,"\xEC2"],"\x0A"=>[104,"\xEC2"],"\x0B"=>[16,"\xEC2"],"\x0C"=>[94,"\xECa"],"\x0D"=>[76,"\xECa"],"\x0E"=>[104,"\xECa"],"\x0F"=>[16,"\xECa"],"\x10"=>[94,"\xECc"],"\x11"=>[76,"\xECc"],"\x12"=>[104,"\xECc"],"\x13"=>[16,"\xECc"],"\x14"=>[94,"\xECe"],"\x15"=>[76,"\xECe"],"\x16"=>[104,"\xECe"],"\x17"=>[16,"\xECe"],"\x18"=>[94,"\xECi"],"\x19"=>[76,"\xECi"],"\x1A"=>[104,"\xECi"],"\x1B"=>[16,"\xECi"],"\x1C"=>[94,"\xECo"],"\x1D"=>[76,"\xECo"],"\x1E"=>[104,"\xECo"],"\x1F"=>[16,"\xECo"],"\x20"=>[94,"\xECs"],"\x21"=>[76,"\xECs"],"\x22"=>[104,"\xECs"],"\x23"=>[16,"\xECs"],"\x24"=>[94,"\xECt"],"\x25"=>[76,"\xECt"],"\x26"=>[104,"\xECt"],"\x27"=>[16,"\xECt"],"\x28"=>[77,"\xEC\x20"],"\x29"=>[18,"\xEC\x20"],"\x2A"=>[77,"\xEC\x25"],"\x2B"=>[18,"\xEC\x25"],"\x2C"=>[77,"\xEC-"],"-"=>[18,"\xEC-"],"."=>[77,"\xEC."],"\x2F"=>[18,"\xEC."],[77,"\xEC\x2F"],[18,"\xEC\x2F"],[77,"\xEC3"],[18,"\xEC3"],[77,"\xEC4"],[18,"\xEC4"],[77,"\xEC5"],[18,"\xEC5"],[77,"\xEC6"],[18,"\xEC6"],"\x3A"=>[77,"\xEC7"],"\x3B"=>[18,"\xEC7"],"\x3C"=>[77,"\xEC8"],"\x3D"=>[18,"\xEC8"],"\x3E"=>[77,"\xEC9"],"\x3F"=>[18,"\xEC9"],"\x40"=>[77,"\xEC\x3D"],"A"=>[18,"\xEC\x3D"],"B"=>[77,"\xECA"],"C"=>[18,"\xECA"],"D"=>[77,"\xEC_"],"E"=>[18,"\xEC_"],"F"=>[77,"\xECb"],"G"=>[18,"\xECb"],"H"=>[77,"\xECd"],"I"=>[18,"\xECd"],"J"=>[77,"\xECf"],"K"=>[18,"\xECf"],"L"=>[77,"\xECg"],"M"=>[18,"\xECg"],"N"=>[77,"\xECh"],"O"=>[18,"\xECh"],"P"=>[77,"\xECl"],"Q"=>[18,"\xECl"],"R"=>[77,"\xECm"],"S"=>[18,"\xECm"],"T"=>[77,"\xECn"],"U"=>[18,"\xECn"],"V"=>[77,"\xECp"],"W"=>[18,"\xECp"],"X"=>[77,"\xECr"],"Y"=>[18,"\xECr"],"Z"=>[77,"\xECu"],"\x5B"=>[18,"\xECu"],"\x5C"=>[0,"\xEC\x3A"],"\x5D"=>[0,"\xECB"],"\x5E"=>[0,"\xECC"],"_"=>[0,"\xECD"],"\x60"=>[0,"\xECE"],"a"=>[0,"\xECF"],"b"=>[0,"\xECG"],"c"=>[0,"\xECH"],"d"=>[0,"\xECI"],"e"=>[0,"\xECJ"],"f"=>[0,"\xECK"],"g"=>[0,"\xECL"],"h"=>[0,"\xECM"],"i"=>[0,"\xECN"],"j"=>[0,"\xECO"],"k"=>[0,"\xECP"],"l"=>[0,"\xECQ"],"m"=>[0,"\xECR"],"n"=>[0,"\xECS"],"o"=>[0,"\xECT"],"p"=>[0,"\xECU"],"q"=>[0,"\xECV"],"r"=>[0,"\xECW"],"s"=>[0,"\xECY"],"t"=>[0,"\xECj"],"u"=>[0,"\xECk"],"v"=>[0,"\xECq"],"w"=>[0,"\xECv"],"x"=>[0,"\xECw"],"y"=>[0,"\xECx"],"z"=>[0,"\xECy"],"\x7B"=>[0,"\xECz"],"\x7C"=>[82,"\xEC"],"\x7D"=>[87,"\xEC"],"~"=>[130,"\xEC"],"\x7F"=>[9,"\xEC"],"\x80"=>[94,"\xED0"],"\x81"=>[76,"\xED0"],"\x82"=>[104,"\xED0"],"\x83"=>[16,"\xED0"],"\x84"=>[94,"\xED1"],"\x85"=>[76,"\xED1"],"\x86"=>[104,"\xED1"],"\x87"=>[16,"\xED1"],"\x88"=>[94,"\xED2"],"\x89"=>[76,"\xED2"],"\x8A"=>[104,"\xED2"],"\x8B"=>[16,"\xED2"],"\x8C"=>[94,"\xEDa"],"\x8D"=>[76,"\xEDa"],"\x8E"=>[104,"\xEDa"],"\x8F"=>[16,"\xEDa"],"\x90"=>[94,"\xEDc"],"\x91"=>[76,"\xEDc"],"\x92"=>[104,"\xEDc"],"\x93"=>[16,"\xEDc"],"\x94"=>[94,"\xEDe"],"\x95"=>[76,"\xEDe"],"\x96"=>[104,"\xEDe"],"\x97"=>[16,"\xEDe"],"\x98"=>[94,"\xEDi"],"\x99"=>[76,"\xEDi"],"\x9A"=>[104,"\xEDi"],"\x9B"=>[16,"\xEDi"],"\x9C"=>[94,"\xEDo"],"\x9D"=>[76,"\xEDo"],"\x9E"=>[104,"\xEDo"],"\x9F"=>[16,"\xEDo"],"\xA0"=>[94,"\xEDs"],"\xA1"=>[76,"\xEDs"],"\xA2"=>[104,"\xEDs"],"\xA3"=>[16,"\xEDs"],"\xA4"=>[94,"\xEDt"],"\xA5"=>[76,"\xEDt"],"\xA6"=>[104,"\xEDt"],"\xA7"=>[16,"\xEDt"],"\xA8"=>[77,"\xED\x20"],"\xA9"=>[18,"\xED\x20"],"\xAA"=>[77,"\xED\x25"],"\xAB"=>[18,"\xED\x25"],"\xAC"=>[77,"\xED-"],"\xAD"=>[18,"\xED-"],"\xAE"=>[77,"\xED."],"\xAF"=>[18,"\xED."],"\xB0"=>[77,"\xED\x2F"],"\xB1"=>[18,"\xED\x2F"],"\xB2"=>[77,"\xED3"],"\xB3"=>[18,"\xED3"],"\xB4"=>[77,"\xED4"],"\xB5"=>[18,"\xED4"],"\xB6"=>[77,"\xED5"],"\xB7"=>[18,"\xED5"],"\xB8"=>[77,"\xED6"],"\xB9"=>[18,"\xED6"],"\xBA"=>[77,"\xED7"],"\xBB"=>[18,"\xED7"],"\xBC"=>[77,"\xED8"],"\xBD"=>[18,"\xED8"],"\xBE"=>[77,"\xED9"],"\xBF"=>[18,"\xED9"],"\xC0"=>[77,"\xED\x3D"],"\xC1"=>[18,"\xED\x3D"],"\xC2"=>[77,"\xEDA"],"\xC3"=>[18,"\xEDA"],"\xC4"=>[77,"\xED_"],"\xC5"=>[18,"\xED_"],"\xC6"=>[77,"\xEDb"],"\xC7"=>[18,"\xEDb"],"\xC8"=>[77,"\xEDd"],"\xC9"=>[18,"\xEDd"],"\xCA"=>[77,"\xEDf"],"\xCB"=>[18,"\xEDf"],"\xCC"=>[77,"\xEDg"],"\xCD"=>[18,"\xEDg"],"\xCE"=>[77,"\xEDh"],"\xCF"=>[18,"\xEDh"],"\xD0"=>[77,"\xEDl"],"\xD1"=>[18,"\xEDl"],"\xD2"=>[77,"\xEDm"],"\xD3"=>[18,"\xEDm"],"\xD4"=>[77,"\xEDn"],"\xD5"=>[18,"\xEDn"],"\xD6"=>[77,"\xEDp"],"\xD7"=>[18,"\xEDp"],"\xD8"=>[77,"\xEDr"],"\xD9"=>[18,"\xEDr"],"\xDA"=>[77,"\xEDu"],"\xDB"=>[18,"\xEDu"],"\xDC"=>[0,"\xED\x3A"],"\xDD"=>[0,"\xEDB"],"\xDE"=>[0,"\xEDC"],"\xDF"=>[0,"\xEDD"],"\xE0"=>[0,"\xEDE"],"\xE1"=>[0,"\xEDF"],"\xE2"=>[0,"\xEDG"],"\xE3"=>[0,"\xEDH"],"\xE4"=>[0,"\xEDI"],"\xE5"=>[0,"\xEDJ"],"\xE6"=>[0,"\xEDK"],"\xE7"=>[0,"\xEDL"],"\xE8"=>[0,"\xEDM"],"\xE9"=>[0,"\xEDN"],"\xEA"=>[0,"\xEDO"],"\xEB"=>[0,"\xEDP"],"\xEC"=>[0,"\xEDQ"],"\xED"=>[0,"\xEDR"],"\xEE"=>[0,"\xEDS"],"\xEF"=>[0,"\xEDT"],"\xF0"=>[0,"\xEDU"],"\xF1"=>[0,"\xEDV"],"\xF2"=>[0,"\xEDW"],"\xF3"=>[0,"\xEDY"],"\xF4"=>[0,"\xEDj"],"\xF5"=>[0,"\xEDk"],"\xF6"=>[0,"\xEDq"],"\xF7"=>[0,"\xEDv"],"\xF8"=>[0,"\xEDw"],"\xF9"=>[0,"\xEDx"],"\xFA"=>[0,"\xEDy"],"\xFB"=>[0,"\xEDz"],"\xFC"=>[82,"\xED"],"\xFD"=>[87,"\xED"],"\xFE"=>[130,"\xED"],"\xFF"=>[9,"\xED"],],["\x00"=>[94,"\xEE0"],"\x01"=>[76,"\xEE0"],"\x02"=>[104,"\xEE0"],"\x03"=>[16,"\xEE0"],"\x04"=>[94,"\xEE1"],"\x05"=>[76,"\xEE1"],"\x06"=>[104,"\xEE1"],"\x07"=>[16,"\xEE1"],"\x08"=>[94,"\xEE2"],"\x09"=>[76,"\xEE2"],"\x0A"=>[104,"\xEE2"],"\x0B"=>[16,"\xEE2"],"\x0C"=>[94,"\xEEa"],"\x0D"=>[76,"\xEEa"],"\x0E"=>[104,"\xEEa"],"\x0F"=>[16,"\xEEa"],"\x10"=>[94,"\xEEc"],"\x11"=>[76,"\xEEc"],"\x12"=>[104,"\xEEc"],"\x13"=>[16,"\xEEc"],"\x14"=>[94,"\xEEe"],"\x15"=>[76,"\xEEe"],"\x16"=>[104,"\xEEe"],"\x17"=>[16,"\xEEe"],"\x18"=>[94,"\xEEi"],"\x19"=>[76,"\xEEi"],"\x1A"=>[104,"\xEEi"],"\x1B"=>[16,"\xEEi"],"\x1C"=>[94,"\xEEo"],"\x1D"=>[76,"\xEEo"],"\x1E"=>[104,"\xEEo"],"\x1F"=>[16,"\xEEo"],"\x20"=>[94,"\xEEs"],"\x21"=>[76,"\xEEs"],"\x22"=>[104,"\xEEs"],"\x23"=>[16,"\xEEs"],"\x24"=>[94,"\xEEt"],"\x25"=>[76,"\xEEt"],"\x26"=>[104,"\xEEt"],"\x27"=>[16,"\xEEt"],"\x28"=>[77,"\xEE\x20"],"\x29"=>[18,"\xEE\x20"],"\x2A"=>[77,"\xEE\x25"],"\x2B"=>[18,"\xEE\x25"],"\x2C"=>[77,"\xEE-"],"-"=>[18,"\xEE-"],"."=>[77,"\xEE."],"\x2F"=>[18,"\xEE."],[77,"\xEE\x2F"],[18,"\xEE\x2F"],[77,"\xEE3"],[18,"\xEE3"],[77,"\xEE4"],[18,"\xEE4"],[77,"\xEE5"],[18,"\xEE5"],[77,"\xEE6"],[18,"\xEE6"],"\x3A"=>[77,"\xEE7"],"\x3B"=>[18,"\xEE7"],"\x3C"=>[77,"\xEE8"],"\x3D"=>[18,"\xEE8"],"\x3E"=>[77,"\xEE9"],"\x3F"=>[18,"\xEE9"],"\x40"=>[77,"\xEE\x3D"],"A"=>[18,"\xEE\x3D"],"B"=>[77,"\xEEA"],"C"=>[18,"\xEEA"],"D"=>[77,"\xEE_"],"E"=>[18,"\xEE_"],"F"=>[77,"\xEEb"],"G"=>[18,"\xEEb"],"H"=>[77,"\xEEd"],"I"=>[18,"\xEEd"],"J"=>[77,"\xEEf"],"K"=>[18,"\xEEf"],"L"=>[77,"\xEEg"],"M"=>[18,"\xEEg"],"N"=>[77,"\xEEh"],"O"=>[18,"\xEEh"],"P"=>[77,"\xEEl"],"Q"=>[18,"\xEEl"],"R"=>[77,"\xEEm"],"S"=>[18,"\xEEm"],"T"=>[77,"\xEEn"],"U"=>[18,"\xEEn"],"V"=>[77,"\xEEp"],"W"=>[18,"\xEEp"],"X"=>[77,"\xEEr"],"Y"=>[18,"\xEEr"],"Z"=>[77,"\xEEu"],"\x5B"=>[18,"\xEEu"],"\x5C"=>[0,"\xEE\x3A"],"\x5D"=>[0,"\xEEB"],"\x5E"=>[0,"\xEEC"],"_"=>[0,"\xEED"],"\x60"=>[0,"\xEEE"],"a"=>[0,"\xEEF"],"b"=>[0,"\xEEG"],"c"=>[0,"\xEEH"],"d"=>[0,"\xEEI"],"e"=>[0,"\xEEJ"],"f"=>[0,"\xEEK"],"g"=>[0,"\xEEL"],"h"=>[0,"\xEEM"],"i"=>[0,"\xEEN"],"j"=>[0,"\xEEO"],"k"=>[0,"\xEEP"],"l"=>[0,"\xEEQ"],"m"=>[0,"\xEER"],"n"=>[0,"\xEES"],"o"=>[0,"\xEET"],"p"=>[0,"\xEEU"],"q"=>[0,"\xEEV"],"r"=>[0,"\xEEW"],"s"=>[0,"\xEEY"],"t"=>[0,"\xEEj"],"u"=>[0,"\xEEk"],"v"=>[0,"\xEEq"],"w"=>[0,"\xEEv"],"x"=>[0,"\xEEw"],"y"=>[0,"\xEEx"],"z"=>[0,"\xEEy"],"\x7B"=>[0,"\xEEz"],"\x7C"=>[82,"\xEE"],"\x7D"=>[87,"\xEE"],"~"=>[130,"\xEE"],"\x7F"=>[9,"\xEE"],"\x80"=>[94,"\xF00"],"\x81"=>[76,"\xF00"],"\x82"=>[104,"\xF00"],"\x83"=>[16,"\xF00"],"\x84"=>[94,"\xF01"],"\x85"=>[76,"\xF01"],"\x86"=>[104,"\xF01"],"\x87"=>[16,"\xF01"],"\x88"=>[94,"\xF02"],"\x89"=>[76,"\xF02"],"\x8A"=>[104,"\xF02"],"\x8B"=>[16,"\xF02"],"\x8C"=>[94,"\xF0a"],"\x8D"=>[76,"\xF0a"],"\x8E"=>[104,"\xF0a"],"\x8F"=>[16,"\xF0a"],"\x90"=>[94,"\xF0c"],"\x91"=>[76,"\xF0c"],"\x92"=>[104,"\xF0c"],"\x93"=>[16,"\xF0c"],"\x94"=>[94,"\xF0e"],"\x95"=>[76,"\xF0e"],"\x96"=>[104,"\xF0e"],"\x97"=>[16,"\xF0e"],"\x98"=>[94,"\xF0i"],"\x99"=>[76,"\xF0i"],"\x9A"=>[104,"\xF0i"],"\x9B"=>[16,"\xF0i"],"\x9C"=>[94,"\xF0o"],"\x9D"=>[76,"\xF0o"],"\x9E"=>[104,"\xF0o"],"\x9F"=>[16,"\xF0o"],"\xA0"=>[94,"\xF0s"],"\xA1"=>[76,"\xF0s"],"\xA2"=>[104,"\xF0s"],"\xA3"=>[16,"\xF0s"],"\xA4"=>[94,"\xF0t"],"\xA5"=>[76,"\xF0t"],"\xA6"=>[104,"\xF0t"],"\xA7"=>[16,"\xF0t"],"\xA8"=>[77,"\xF0\x20"],"\xA9"=>[18,"\xF0\x20"],"\xAA"=>[77,"\xF0\x25"],"\xAB"=>[18,"\xF0\x25"],"\xAC"=>[77,"\xF0-"],"\xAD"=>[18,"\xF0-"],"\xAE"=>[77,"\xF0."],"\xAF"=>[18,"\xF0."],"\xB0"=>[77,"\xF0\x2F"],"\xB1"=>[18,"\xF0\x2F"],"\xB2"=>[77,"\xF03"],"\xB3"=>[18,"\xF03"],"\xB4"=>[77,"\xF04"],"\xB5"=>[18,"\xF04"],"\xB6"=>[77,"\xF05"],"\xB7"=>[18,"\xF05"],"\xB8"=>[77,"\xF06"],"\xB9"=>[18,"\xF06"],"\xBA"=>[77,"\xF07"],"\xBB"=>[18,"\xF07"],"\xBC"=>[77,"\xF08"],"\xBD"=>[18,"\xF08"],"\xBE"=>[77,"\xF09"],"\xBF"=>[18,"\xF09"],"\xC0"=>[77,"\xF0\x3D"],"\xC1"=>[18,"\xF0\x3D"],"\xC2"=>[77,"\xF0A"],"\xC3"=>[18,"\xF0A"],"\xC4"=>[77,"\xF0_"],"\xC5"=>[18,"\xF0_"],"\xC6"=>[77,"\xF0b"],"\xC7"=>[18,"\xF0b"],"\xC8"=>[77,"\xF0d"],"\xC9"=>[18,"\xF0d"],"\xCA"=>[77,"\xF0f"],"\xCB"=>[18,"\xF0f"],"\xCC"=>[77,"\xF0g"],"\xCD"=>[18,"\xF0g"],"\xCE"=>[77,"\xF0h"],"\xCF"=>[18,"\xF0h"],"\xD0"=>[77,"\xF0l"],"\xD1"=>[18,"\xF0l"],"\xD2"=>[77,"\xF0m"],"\xD3"=>[18,"\xF0m"],"\xD4"=>[77,"\xF0n"],"\xD5"=>[18,"\xF0n"],"\xD6"=>[77,"\xF0p"],"\xD7"=>[18,"\xF0p"],"\xD8"=>[77,"\xF0r"],"\xD9"=>[18,"\xF0r"],"\xDA"=>[77,"\xF0u"],"\xDB"=>[18,"\xF0u"],"\xDC"=>[0,"\xF0\x3A"],"\xDD"=>[0,"\xF0B"],"\xDE"=>[0,"\xF0C"],"\xDF"=>[0,"\xF0D"],"\xE0"=>[0,"\xF0E"],"\xE1"=>[0,"\xF0F"],"\xE2"=>[0,"\xF0G"],"\xE3"=>[0,"\xF0H"],"\xE4"=>[0,"\xF0I"],"\xE5"=>[0,"\xF0J"],"\xE6"=>[0,"\xF0K"],"\xE7"=>[0,"\xF0L"],"\xE8"=>[0,"\xF0M"],"\xE9"=>[0,"\xF0N"],"\xEA"=>[0,"\xF0O"],"\xEB"=>[0,"\xF0P"],"\xEC"=>[0,"\xF0Q"],"\xED"=>[0,"\xF0R"],"\xEE"=>[0,"\xF0S"],"\xEF"=>[0,"\xF0T"],"\xF0"=>[0,"\xF0U"],"\xF1"=>[0,"\xF0V"],"\xF2"=>[0,"\xF0W"],"\xF3"=>[0,"\xF0Y"],"\xF4"=>[0,"\xF0j"],"\xF5"=>[0,"\xF0k"],"\xF6"=>[0,"\xF0q"],"\xF7"=>[0,"\xF0v"],"\xF8"=>[0,"\xF0w"],"\xF9"=>[0,"\xF0x"],"\xFA"=>[0,"\xF0y"],"\xFB"=>[0,"\xF0z"],"\xFC"=>[82,"\xF0"],"\xFD"=>[87,"\xF0"],"\xFE"=>[130,"\xF0"],"\xFF"=>[9,"\xF0"],],["\x00"=>[94,"\xF10"],"\x01"=>[76,"\xF10"],"\x02"=>[104,"\xF10"],"\x03"=>[16,"\xF10"],"\x04"=>[94,"\xF11"],"\x05"=>[76,"\xF11"],"\x06"=>[104,"\xF11"],"\x07"=>[16,"\xF11"],"\x08"=>[94,"\xF12"],"\x09"=>[76,"\xF12"],"\x0A"=>[104,"\xF12"],"\x0B"=>[16,"\xF12"],"\x0C"=>[94,"\xF1a"],"\x0D"=>[76,"\xF1a"],"\x0E"=>[104,"\xF1a"],"\x0F"=>[16,"\xF1a"],"\x10"=>[94,"\xF1c"],"\x11"=>[76,"\xF1c"],"\x12"=>[104,"\xF1c"],"\x13"=>[16,"\xF1c"],"\x14"=>[94,"\xF1e"],"\x15"=>[76,"\xF1e"],"\x16"=>[104,"\xF1e"],"\x17"=>[16,"\xF1e"],"\x18"=>[94,"\xF1i"],"\x19"=>[76,"\xF1i"],"\x1A"=>[104,"\xF1i"],"\x1B"=>[16,"\xF1i"],"\x1C"=>[94,"\xF1o"],"\x1D"=>[76,"\xF1o"],"\x1E"=>[104,"\xF1o"],"\x1F"=>[16,"\xF1o"],"\x20"=>[94,"\xF1s"],"\x21"=>[76,"\xF1s"],"\x22"=>[104,"\xF1s"],"\x23"=>[16,"\xF1s"],"\x24"=>[94,"\xF1t"],"\x25"=>[76,"\xF1t"],"\x26"=>[104,"\xF1t"],"\x27"=>[16,"\xF1t"],"\x28"=>[77,"\xF1\x20"],"\x29"=>[18,"\xF1\x20"],"\x2A"=>[77,"\xF1\x25"],"\x2B"=>[18,"\xF1\x25"],"\x2C"=>[77,"\xF1-"],"-"=>[18,"\xF1-"],"."=>[77,"\xF1."],"\x2F"=>[18,"\xF1."],[77,"\xF1\x2F"],[18,"\xF1\x2F"],[77,"\xF13"],[18,"\xF13"],[77,"\xF14"],[18,"\xF14"],[77,"\xF15"],[18,"\xF15"],[77,"\xF16"],[18,"\xF16"],"\x3A"=>[77,"\xF17"],"\x3B"=>[18,"\xF17"],"\x3C"=>[77,"\xF18"],"\x3D"=>[18,"\xF18"],"\x3E"=>[77,"\xF19"],"\x3F"=>[18,"\xF19"],"\x40"=>[77,"\xF1\x3D"],"A"=>[18,"\xF1\x3D"],"B"=>[77,"\xF1A"],"C"=>[18,"\xF1A"],"D"=>[77,"\xF1_"],"E"=>[18,"\xF1_"],"F"=>[77,"\xF1b"],"G"=>[18,"\xF1b"],"H"=>[77,"\xF1d"],"I"=>[18,"\xF1d"],"J"=>[77,"\xF1f"],"K"=>[18,"\xF1f"],"L"=>[77,"\xF1g"],"M"=>[18,"\xF1g"],"N"=>[77,"\xF1h"],"O"=>[18,"\xF1h"],"P"=>[77,"\xF1l"],"Q"=>[18,"\xF1l"],"R"=>[77,"\xF1m"],"S"=>[18,"\xF1m"],"T"=>[77,"\xF1n"],"U"=>[18,"\xF1n"],"V"=>[77,"\xF1p"],"W"=>[18,"\xF1p"],"X"=>[77,"\xF1r"],"Y"=>[18,"\xF1r"],"Z"=>[77,"\xF1u"],"\x5B"=>[18,"\xF1u"],"\x5C"=>[0,"\xF1\x3A"],"\x5D"=>[0,"\xF1B"],"\x5E"=>[0,"\xF1C"],"_"=>[0,"\xF1D"],"\x60"=>[0,"\xF1E"],"a"=>[0,"\xF1F"],"b"=>[0,"\xF1G"],"c"=>[0,"\xF1H"],"d"=>[0,"\xF1I"],"e"=>[0,"\xF1J"],"f"=>[0,"\xF1K"],"g"=>[0,"\xF1L"],"h"=>[0,"\xF1M"],"i"=>[0,"\xF1N"],"j"=>[0,"\xF1O"],"k"=>[0,"\xF1P"],"l"=>[0,"\xF1Q"],"m"=>[0,"\xF1R"],"n"=>[0,"\xF1S"],"o"=>[0,"\xF1T"],"p"=>[0,"\xF1U"],"q"=>[0,"\xF1V"],"r"=>[0,"\xF1W"],"s"=>[0,"\xF1Y"],"t"=>[0,"\xF1j"],"u"=>[0,"\xF1k"],"v"=>[0,"\xF1q"],"w"=>[0,"\xF1v"],"x"=>[0,"\xF1w"],"y"=>[0,"\xF1x"],"z"=>[0,"\xF1y"],"\x7B"=>[0,"\xF1z"],"\x7C"=>[82,"\xF1"],"\x7D"=>[87,"\xF1"],"~"=>[130,"\xF1"],"\x7F"=>[9,"\xF1"],"\x80"=>[94,"\xF40"],"\x81"=>[76,"\xF40"],"\x82"=>[104,"\xF40"],"\x83"=>[16,"\xF40"],"\x84"=>[94,"\xF41"],"\x85"=>[76,"\xF41"],"\x86"=>[104,"\xF41"],"\x87"=>[16,"\xF41"],"\x88"=>[94,"\xF42"],"\x89"=>[76,"\xF42"],"\x8A"=>[104,"\xF42"],"\x8B"=>[16,"\xF42"],"\x8C"=>[94,"\xF4a"],"\x8D"=>[76,"\xF4a"],"\x8E"=>[104,"\xF4a"],"\x8F"=>[16,"\xF4a"],"\x90"=>[94,"\xF4c"],"\x91"=>[76,"\xF4c"],"\x92"=>[104,"\xF4c"],"\x93"=>[16,"\xF4c"],"\x94"=>[94,"\xF4e"],"\x95"=>[76,"\xF4e"],"\x96"=>[104,"\xF4e"],"\x97"=>[16,"\xF4e"],"\x98"=>[94,"\xF4i"],"\x99"=>[76,"\xF4i"],"\x9A"=>[104,"\xF4i"],"\x9B"=>[16,"\xF4i"],"\x9C"=>[94,"\xF4o"],"\x9D"=>[76,"\xF4o"],"\x9E"=>[104,"\xF4o"],"\x9F"=>[16,"\xF4o"],"\xA0"=>[94,"\xF4s"],"\xA1"=>[76,"\xF4s"],"\xA2"=>[104,"\xF4s"],"\xA3"=>[16,"\xF4s"],"\xA4"=>[94,"\xF4t"],"\xA5"=>[76,"\xF4t"],"\xA6"=>[104,"\xF4t"],"\xA7"=>[16,"\xF4t"],"\xA8"=>[77,"\xF4\x20"],"\xA9"=>[18,"\xF4\x20"],"\xAA"=>[77,"\xF4\x25"],"\xAB"=>[18,"\xF4\x25"],"\xAC"=>[77,"\xF4-"],"\xAD"=>[18,"\xF4-"],"\xAE"=>[77,"\xF4."],"\xAF"=>[18,"\xF4."],"\xB0"=>[77,"\xF4\x2F"],"\xB1"=>[18,"\xF4\x2F"],"\xB2"=>[77,"\xF43"],"\xB3"=>[18,"\xF43"],"\xB4"=>[77,"\xF44"],"\xB5"=>[18,"\xF44"],"\xB6"=>[77,"\xF45"],"\xB7"=>[18,"\xF45"],"\xB8"=>[77,"\xF46"],"\xB9"=>[18,"\xF46"],"\xBA"=>[77,"\xF47"],"\xBB"=>[18,"\xF47"],"\xBC"=>[77,"\xF48"],"\xBD"=>[18,"\xF48"],"\xBE"=>[77,"\xF49"],"\xBF"=>[18,"\xF49"],"\xC0"=>[77,"\xF4\x3D"],"\xC1"=>[18,"\xF4\x3D"],"\xC2"=>[77,"\xF4A"],"\xC3"=>[18,"\xF4A"],"\xC4"=>[77,"\xF4_"],"\xC5"=>[18,"\xF4_"],"\xC6"=>[77,"\xF4b"],"\xC7"=>[18,"\xF4b"],"\xC8"=>[77,"\xF4d"],"\xC9"=>[18,"\xF4d"],"\xCA"=>[77,"\xF4f"],"\xCB"=>[18,"\xF4f"],"\xCC"=>[77,"\xF4g"],"\xCD"=>[18,"\xF4g"],"\xCE"=>[77,"\xF4h"],"\xCF"=>[18,"\xF4h"],"\xD0"=>[77,"\xF4l"],"\xD1"=>[18,"\xF4l"],"\xD2"=>[77,"\xF4m"],"\xD3"=>[18,"\xF4m"],"\xD4"=>[77,"\xF4n"],"\xD5"=>[18,"\xF4n"],"\xD6"=>[77,"\xF4p"],"\xD7"=>[18,"\xF4p"],"\xD8"=>[77,"\xF4r"],"\xD9"=>[18,"\xF4r"],"\xDA"=>[77,"\xF4u"],"\xDB"=>[18,"\xF4u"],"\xDC"=>[0,"\xF4\x3A"],"\xDD"=>[0,"\xF4B"],"\xDE"=>[0,"\xF4C"],"\xDF"=>[0,"\xF4D"],"\xE0"=>[0,"\xF4E"],"\xE1"=>[0,"\xF4F"],"\xE2"=>[0,"\xF4G"],"\xE3"=>[0,"\xF4H"],"\xE4"=>[0,"\xF4I"],"\xE5"=>[0,"\xF4J"],"\xE6"=>[0,"\xF4K"],"\xE7"=>[0,"\xF4L"],"\xE8"=>[0,"\xF4M"],"\xE9"=>[0,"\xF4N"],"\xEA"=>[0,"\xF4O"],"\xEB"=>[0,"\xF4P"],"\xEC"=>[0,"\xF4Q"],"\xED"=>[0,"\xF4R"],"\xEE"=>[0,"\xF4S"],"\xEF"=>[0,"\xF4T"],"\xF0"=>[0,"\xF4U"],"\xF1"=>[0,"\xF4V"],"\xF2"=>[0,"\xF4W"],"\xF3"=>[0,"\xF4Y"],"\xF4"=>[0,"\xF4j"],"\xF5"=>[0,"\xF4k"],"\xF6"=>[0,"\xF4q"],"\xF7"=>[0,"\xF4v"],"\xF8"=>[0,"\xF4w"],"\xF9"=>[0,"\xF4x"],"\xFA"=>[0,"\xF4y"],"\xFB"=>[0,"\xF4z"],"\xFC"=>[82,"\xF4"],"\xFD"=>[87,"\xF4"],"\xFE"=>[130,"\xF4"],"\xFF"=>[9,"\xF4"],],["\x00"=>[94,"\xF20"],"\x01"=>[76,"\xF20"],"\x02"=>[104,"\xF20"],"\x03"=>[16,"\xF20"],"\x04"=>[94,"\xF21"],"\x05"=>[76,"\xF21"],"\x06"=>[104,"\xF21"],"\x07"=>[16,"\xF21"],"\x08"=>[94,"\xF22"],"\x09"=>[76,"\xF22"],"\x0A"=>[104,"\xF22"],"\x0B"=>[16,"\xF22"],"\x0C"=>[94,"\xF2a"],"\x0D"=>[76,"\xF2a"],"\x0E"=>[104,"\xF2a"],"\x0F"=>[16,"\xF2a"],"\x10"=>[94,"\xF2c"],"\x11"=>[76,"\xF2c"],"\x12"=>[104,"\xF2c"],"\x13"=>[16,"\xF2c"],"\x14"=>[94,"\xF2e"],"\x15"=>[76,"\xF2e"],"\x16"=>[104,"\xF2e"],"\x17"=>[16,"\xF2e"],"\x18"=>[94,"\xF2i"],"\x19"=>[76,"\xF2i"],"\x1A"=>[104,"\xF2i"],"\x1B"=>[16,"\xF2i"],"\x1C"=>[94,"\xF2o"],"\x1D"=>[76,"\xF2o"],"\x1E"=>[104,"\xF2o"],"\x1F"=>[16,"\xF2o"],"\x20"=>[94,"\xF2s"],"\x21"=>[76,"\xF2s"],"\x22"=>[104,"\xF2s"],"\x23"=>[16,"\xF2s"],"\x24"=>[94,"\xF2t"],"\x25"=>[76,"\xF2t"],"\x26"=>[104,"\xF2t"],"\x27"=>[16,"\xF2t"],"\x28"=>[77,"\xF2\x20"],"\x29"=>[18,"\xF2\x20"],"\x2A"=>[77,"\xF2\x25"],"\x2B"=>[18,"\xF2\x25"],"\x2C"=>[77,"\xF2-"],"-"=>[18,"\xF2-"],"."=>[77,"\xF2."],"\x2F"=>[18,"\xF2."],[77,"\xF2\x2F"],[18,"\xF2\x2F"],[77,"\xF23"],[18,"\xF23"],[77,"\xF24"],[18,"\xF24"],[77,"\xF25"],[18,"\xF25"],[77,"\xF26"],[18,"\xF26"],"\x3A"=>[77,"\xF27"],"\x3B"=>[18,"\xF27"],"\x3C"=>[77,"\xF28"],"\x3D"=>[18,"\xF28"],"\x3E"=>[77,"\xF29"],"\x3F"=>[18,"\xF29"],"\x40"=>[77,"\xF2\x3D"],"A"=>[18,"\xF2\x3D"],"B"=>[77,"\xF2A"],"C"=>[18,"\xF2A"],"D"=>[77,"\xF2_"],"E"=>[18,"\xF2_"],"F"=>[77,"\xF2b"],"G"=>[18,"\xF2b"],"H"=>[77,"\xF2d"],"I"=>[18,"\xF2d"],"J"=>[77,"\xF2f"],"K"=>[18,"\xF2f"],"L"=>[77,"\xF2g"],"M"=>[18,"\xF2g"],"N"=>[77,"\xF2h"],"O"=>[18,"\xF2h"],"P"=>[77,"\xF2l"],"Q"=>[18,"\xF2l"],"R"=>[77,"\xF2m"],"S"=>[18,"\xF2m"],"T"=>[77,"\xF2n"],"U"=>[18,"\xF2n"],"V"=>[77,"\xF2p"],"W"=>[18,"\xF2p"],"X"=>[77,"\xF2r"],"Y"=>[18,"\xF2r"],"Z"=>[77,"\xF2u"],"\x5B"=>[18,"\xF2u"],"\x5C"=>[0,"\xF2\x3A"],"\x5D"=>[0,"\xF2B"],"\x5E"=>[0,"\xF2C"],"_"=>[0,"\xF2D"],"\x60"=>[0,"\xF2E"],"a"=>[0,"\xF2F"],"b"=>[0,"\xF2G"],"c"=>[0,"\xF2H"],"d"=>[0,"\xF2I"],"e"=>[0,"\xF2J"],"f"=>[0,"\xF2K"],"g"=>[0,"\xF2L"],"h"=>[0,"\xF2M"],"i"=>[0,"\xF2N"],"j"=>[0,"\xF2O"],"k"=>[0,"\xF2P"],"l"=>[0,"\xF2Q"],"m"=>[0,"\xF2R"],"n"=>[0,"\xF2S"],"o"=>[0,"\xF2T"],"p"=>[0,"\xF2U"],"q"=>[0,"\xF2V"],"r"=>[0,"\xF2W"],"s"=>[0,"\xF2Y"],"t"=>[0,"\xF2j"],"u"=>[0,"\xF2k"],"v"=>[0,"\xF2q"],"w"=>[0,"\xF2v"],"x"=>[0,"\xF2w"],"y"=>[0,"\xF2x"],"z"=>[0,"\xF2y"],"\x7B"=>[0,"\xF2z"],"\x7C"=>[82,"\xF2"],"\x7D"=>[87,"\xF2"],"~"=>[130,"\xF2"],"\x7F"=>[9,"\xF2"],"\x80"=>[94,"\xF30"],"\x81"=>[76,"\xF30"],"\x82"=>[104,"\xF30"],"\x83"=>[16,"\xF30"],"\x84"=>[94,"\xF31"],"\x85"=>[76,"\xF31"],"\x86"=>[104,"\xF31"],"\x87"=>[16,"\xF31"],"\x88"=>[94,"\xF32"],"\x89"=>[76,"\xF32"],"\x8A"=>[104,"\xF32"],"\x8B"=>[16,"\xF32"],"\x8C"=>[94,"\xF3a"],"\x8D"=>[76,"\xF3a"],"\x8E"=>[104,"\xF3a"],"\x8F"=>[16,"\xF3a"],"\x90"=>[94,"\xF3c"],"\x91"=>[76,"\xF3c"],"\x92"=>[104,"\xF3c"],"\x93"=>[16,"\xF3c"],"\x94"=>[94,"\xF3e"],"\x95"=>[76,"\xF3e"],"\x96"=>[104,"\xF3e"],"\x97"=>[16,"\xF3e"],"\x98"=>[94,"\xF3i"],"\x99"=>[76,"\xF3i"],"\x9A"=>[104,"\xF3i"],"\x9B"=>[16,"\xF3i"],"\x9C"=>[94,"\xF3o"],"\x9D"=>[76,"\xF3o"],"\x9E"=>[104,"\xF3o"],"\x9F"=>[16,"\xF3o"],"\xA0"=>[94,"\xF3s"],"\xA1"=>[76,"\xF3s"],"\xA2"=>[104,"\xF3s"],"\xA3"=>[16,"\xF3s"],"\xA4"=>[94,"\xF3t"],"\xA5"=>[76,"\xF3t"],"\xA6"=>[104,"\xF3t"],"\xA7"=>[16,"\xF3t"],"\xA8"=>[77,"\xF3\x20"],"\xA9"=>[18,"\xF3\x20"],"\xAA"=>[77,"\xF3\x25"],"\xAB"=>[18,"\xF3\x25"],"\xAC"=>[77,"\xF3-"],"\xAD"=>[18,"\xF3-"],"\xAE"=>[77,"\xF3."],"\xAF"=>[18,"\xF3."],"\xB0"=>[77,"\xF3\x2F"],"\xB1"=>[18,"\xF3\x2F"],"\xB2"=>[77,"\xF33"],"\xB3"=>[18,"\xF33"],"\xB4"=>[77,"\xF34"],"\xB5"=>[18,"\xF34"],"\xB6"=>[77,"\xF35"],"\xB7"=>[18,"\xF35"],"\xB8"=>[77,"\xF36"],"\xB9"=>[18,"\xF36"],"\xBA"=>[77,"\xF37"],"\xBB"=>[18,"\xF37"],"\xBC"=>[77,"\xF38"],"\xBD"=>[18,"\xF38"],"\xBE"=>[77,"\xF39"],"\xBF"=>[18,"\xF39"],"\xC0"=>[77,"\xF3\x3D"],"\xC1"=>[18,"\xF3\x3D"],"\xC2"=>[77,"\xF3A"],"\xC3"=>[18,"\xF3A"],"\xC4"=>[77,"\xF3_"],"\xC5"=>[18,"\xF3_"],"\xC6"=>[77,"\xF3b"],"\xC7"=>[18,"\xF3b"],"\xC8"=>[77,"\xF3d"],"\xC9"=>[18,"\xF3d"],"\xCA"=>[77,"\xF3f"],"\xCB"=>[18,"\xF3f"],"\xCC"=>[77,"\xF3g"],"\xCD"=>[18,"\xF3g"],"\xCE"=>[77,"\xF3h"],"\xCF"=>[18,"\xF3h"],"\xD0"=>[77,"\xF3l"],"\xD1"=>[18,"\xF3l"],"\xD2"=>[77,"\xF3m"],"\xD3"=>[18,"\xF3m"],"\xD4"=>[77,"\xF3n"],"\xD5"=>[18,"\xF3n"],"\xD6"=>[77,"\xF3p"],"\xD7"=>[18,"\xF3p"],"\xD8"=>[77,"\xF3r"],"\xD9"=>[18,"\xF3r"],"\xDA"=>[77,"\xF3u"],"\xDB"=>[18,"\xF3u"],"\xDC"=>[0,"\xF3\x3A"],"\xDD"=>[0,"\xF3B"],"\xDE"=>[0,"\xF3C"],"\xDF"=>[0,"\xF3D"],"\xE0"=>[0,"\xF3E"],"\xE1"=>[0,"\xF3F"],"\xE2"=>[0,"\xF3G"],"\xE3"=>[0,"\xF3H"],"\xE4"=>[0,"\xF3I"],"\xE5"=>[0,"\xF3J"],"\xE6"=>[0,"\xF3K"],"\xE7"=>[0,"\xF3L"],"\xE8"=>[0,"\xF3M"],"\xE9"=>[0,"\xF3N"],"\xEA"=>[0,"\xF3O"],"\xEB"=>[0,"\xF3P"],"\xEC"=>[0,"\xF3Q"],"\xED"=>[0,"\xF3R"],"\xEE"=>[0,"\xF3S"],"\xEF"=>[0,"\xF3T"],"\xF0"=>[0,"\xF3U"],"\xF1"=>[0,"\xF3V"],"\xF2"=>[0,"\xF3W"],"\xF3"=>[0,"\xF3Y"],"\xF4"=>[0,"\xF3j"],"\xF5"=>[0,"\xF3k"],"\xF6"=>[0,"\xF3q"],"\xF7"=>[0,"\xF3v"],"\xF8"=>[0,"\xF3w"],"\xF9"=>[0,"\xF3x"],"\xFA"=>[0,"\xF3y"],"\xFB"=>[0,"\xF3z"],"\xFC"=>[82,"\xF3"],"\xFD"=>[87,"\xF3"],"\xFE"=>[130,"\xF3"],"\xFF"=>[9,"\xF3"],],["\x00"=>[0,"\xF50"],"\x01"=>[0,"\xF51"],"\x02"=>[0,"\xF52"],"\x03"=>[0,"\xF5a"],"\x04"=>[0,"\xF5c"],"\x05"=>[0,"\xF5e"],"\x06"=>[0,"\xF5i"],"\x07"=>[0,"\xF5o"],"\x08"=>[0,"\xF5s"],"\x09"=>[0,"\xF5t"],"\x0A"=>[73,"\xF5"],"\x0B"=>[88,"\xF5"],"\x0C"=>[89,"\xF5"],"\x0D"=>[96,"\xF5"],"\x0E"=>[97,"\xF5"],"\x0F"=>[99,"\xF5"],"\x10"=>[106,"\xF5"],"\x11"=>[136,"\xF5"],"\x12"=>[139,"\xF5"],"\x13"=>[141,"\xF5"],"\x14"=>[145,"\xF5"],"\x15"=>[147,"\xF5"],"\x16"=>[149,"\xF5"],"\x17"=>[101,"\xF5"],"\x18"=>[112,"\xF5"],"\x19"=>[117,"\xF5"],"\x1A"=>[120,"\xF5"],"\x1B"=>[124,"\xF5"],"\x1C"=>[127,"\xF5"],"\x1D"=>[144,"\xF5"],"\x1E"=>[152,"\xF5"],"\x1F"=>[11,"\xF5"],"\x20"=>[0,"\xF60"],"\x21"=>[0,"\xF61"],"\x22"=>[0,"\xF62"],"\x23"=>[0,"\xF6a"],"\x24"=>[0,"\xF6c"],"\x25"=>[0,"\xF6e"],"\x26"=>[0,"\xF6i"],"\x27"=>[0,"\xF6o"],"\x28"=>[0,"\xF6s"],"\x29"=>[0,"\xF6t"],"\x2A"=>[73,"\xF6"],"\x2B"=>[88,"\xF6"],"\x2C"=>[89,"\xF6"],"-"=>[96,"\xF6"],"."=>[97,"\xF6"],"\x2F"=>[99,"\xF6"],[106,"\xF6"],[136,"\xF6"],[139,"\xF6"],[141,"\xF6"],[145,"\xF6"],[147,"\xF6"],[149,"\xF6"],[101,"\xF6"],[112,"\xF6"],[117,"\xF6"],"\x3A"=>[120,"\xF6"],"\x3B"=>[124,"\xF6"],"\x3C"=>[127,"\xF6"],"\x3D"=>[144,"\xF6"],"\x3E"=>[152,"\xF6"],"\x3F"=>[11,"\xF6"],"\x40"=>[0,"\xF70"],"A"=>[0,"\xF71"],"B"=>[0,"\xF72"],"C"=>[0,"\xF7a"],"D"=>[0,"\xF7c"],"E"=>[0,"\xF7e"],"F"=>[0,"\xF7i"],"G"=>[0,"\xF7o"],"H"=>[0,"\xF7s"],"I"=>[0,"\xF7t"],"J"=>[73,"\xF7"],"K"=>[88,"\xF7"],"L"=>[89,"\xF7"],"M"=>[96,"\xF7"],"N"=>[97,"\xF7"],"O"=>[99,"\xF7"],"P"=>[106,"\xF7"],"Q"=>[136,"\xF7"],"R"=>[139,"\xF7"],"S"=>[141,"\xF7"],"T"=>[145,"\xF7"],"U"=>[147,"\xF7"],"V"=>[149,"\xF7"],"W"=>[101,"\xF7"],"X"=>[112,"\xF7"],"Y"=>[117,"\xF7"],"Z"=>[120,"\xF7"],"\x5B"=>[124,"\xF7"],"\x5C"=>[127,"\xF7"],"\x5D"=>[144,"\xF7"],"\x5E"=>[152,"\xF7"],"_"=>[11,"\xF7"],"\x60"=>[0,"\xF80"],"a"=>[0,"\xF81"],"b"=>[0,"\xF82"],"c"=>[0,"\xF8a"],"d"=>[0,"\xF8c"],"e"=>[0,"\xF8e"],"f"=>[0,"\xF8i"],"g"=>[0,"\xF8o"],"h"=>[0,"\xF8s"],"i"=>[0,"\xF8t"],"j"=>[73,"\xF8"],"k"=>[88,"\xF8"],"l"=>[89,"\xF8"],"m"=>[96,"\xF8"],"n"=>[97,"\xF8"],"o"=>[99,"\xF8"],"p"=>[106,"\xF8"],"q"=>[136,"\xF8"],"r"=>[139,"\xF8"],"s"=>[141,"\xF8"],"t"=>[145,"\xF8"],"u"=>[147,"\xF8"],"v"=>[149,"\xF8"],"w"=>[101,"\xF8"],"x"=>[112,"\xF8"],"y"=>[117,"\xF8"],"z"=>[120,"\xF8"],"\x7B"=>[124,"\xF8"],"\x7C"=>[127,"\xF8"],"\x7D"=>[144,"\xF8"],"~"=>[152,"\xF8"],"\x7F"=>[11,"\xF8"],"\x80"=>[0,"\xFA0"],"\x81"=>[0,"\xFA1"],"\x82"=>[0,"\xFA2"],"\x83"=>[0,"\xFAa"],"\x84"=>[0,"\xFAc"],"\x85"=>[0,"\xFAe"],"\x86"=>[0,"\xFAi"],"\x87"=>[0,"\xFAo"],"\x88"=>[0,"\xFAs"],"\x89"=>[0,"\xFAt"],"\x8A"=>[73,"\xFA"],"\x8B"=>[88,"\xFA"],"\x8C"=>[89,"\xFA"],"\x8D"=>[96,"\xFA"],"\x8E"=>[97,"\xFA"],"\x8F"=>[99,"\xFA"],"\x90"=>[106,"\xFA"],"\x91"=>[136,"\xFA"],"\x92"=>[139,"\xFA"],"\x93"=>[141,"\xFA"],"\x94"=>[145,"\xFA"],"\x95"=>[147,"\xFA"],"\x96"=>[149,"\xFA"],"\x97"=>[101,"\xFA"],"\x98"=>[112,"\xFA"],"\x99"=>[117,"\xFA"],"\x9A"=>[120,"\xFA"],"\x9B"=>[124,"\xFA"],"\x9C"=>[127,"\xFA"],"\x9D"=>[144,"\xFA"],"\x9E"=>[152,"\xFA"],"\x9F"=>[11,"\xFA"],"\xA0"=>[0,"\xFB0"],"\xA1"=>[0,"\xFB1"],"\xA2"=>[0,"\xFB2"],"\xA3"=>[0,"\xFBa"],"\xA4"=>[0,"\xFBc"],"\xA5"=>[0,"\xFBe"],"\xA6"=>[0,"\xFBi"],"\xA7"=>[0,"\xFBo"],"\xA8"=>[0,"\xFBs"],"\xA9"=>[0,"\xFBt"],"\xAA"=>[73,"\xFB"],"\xAB"=>[88,"\xFB"],"\xAC"=>[89,"\xFB"],"\xAD"=>[96,"\xFB"],"\xAE"=>[97,"\xFB"],"\xAF"=>[99,"\xFB"],"\xB0"=>[106,"\xFB"],"\xB1"=>[136,"\xFB"],"\xB2"=>[139,"\xFB"],"\xB3"=>[141,"\xFB"],"\xB4"=>[145,"\xFB"],"\xB5"=>[147,"\xFB"],"\xB6"=>[149,"\xFB"],"\xB7"=>[101,"\xFB"],"\xB8"=>[112,"\xFB"],"\xB9"=>[117,"\xFB"],"\xBA"=>[120,"\xFB"],"\xBB"=>[124,"\xFB"],"\xBC"=>[127,"\xFB"],"\xBD"=>[144,"\xFB"],"\xBE"=>[152,"\xFB"],"\xBF"=>[11,"\xFB"],"\xC0"=>[0,"\xFC0"],"\xC1"=>[0,"\xFC1"],"\xC2"=>[0,"\xFC2"],"\xC3"=>[0,"\xFCa"],"\xC4"=>[0,"\xFCc"],"\xC5"=>[0,"\xFCe"],"\xC6"=>[0,"\xFCi"],"\xC7"=>[0,"\xFCo"],"\xC8"=>[0,"\xFCs"],"\xC9"=>[0,"\xFCt"],"\xCA"=>[73,"\xFC"],"\xCB"=>[88,"\xFC"],"\xCC"=>[89,"\xFC"],"\xCD"=>[96,"\xFC"],"\xCE"=>[97,"\xFC"],"\xCF"=>[99,"\xFC"],"\xD0"=>[106,"\xFC"],"\xD1"=>[136,"\xFC"],"\xD2"=>[139,"\xFC"],"\xD3"=>[141,"\xFC"],"\xD4"=>[145,"\xFC"],"\xD5"=>[147,"\xFC"],"\xD6"=>[149,"\xFC"],"\xD7"=>[101,"\xFC"],"\xD8"=>[112,"\xFC"],"\xD9"=>[117,"\xFC"],"\xDA"=>[120,"\xFC"],"\xDB"=>[124,"\xFC"],"\xDC"=>[127,"\xFC"],"\xDD"=>[144,"\xFC"],"\xDE"=>[152,"\xFC"],"\xDF"=>[11,"\xFC"],"\xE0"=>[0,"\xFD0"],"\xE1"=>[0,"\xFD1"],"\xE2"=>[0,"\xFD2"],"\xE3"=>[0,"\xFDa"],"\xE4"=>[0,"\xFDc"],"\xE5"=>[0,"\xFDe"],"\xE6"=>[0,"\xFDi"],"\xE7"=>[0,"\xFDo"],"\xE8"=>[0,"\xFDs"],"\xE9"=>[0,"\xFDt"],"\xEA"=>[73,"\xFD"],"\xEB"=>[88,"\xFD"],"\xEC"=>[89,"\xFD"],"\xED"=>[96,"\xFD"],"\xEE"=>[97,"\xFD"],"\xEF"=>[99,"\xFD"],"\xF0"=>[106,"\xFD"],"\xF1"=>[136,"\xFD"],"\xF2"=>[139,"\xFD"],"\xF3"=>[141,"\xFD"],"\xF4"=>[145,"\xFD"],"\xF5"=>[147,"\xFD"],"\xF6"=>[149,"\xFD"],"\xF7"=>[101,"\xFD"],"\xF8"=>[112,"\xFD"],"\xF9"=>[117,"\xFD"],"\xFA"=>[120,"\xFD"],"\xFB"=>[124,"\xFD"],"\xFC"=>[127,"\xFD"],"\xFD"=>[144,"\xFD"],"\xFE"=>[152,"\xFD"],"\xFF"=>[11,"\xFD"],],["\x00"=>[94,"\xF50"],"\x01"=>[76,"\xF50"],"\x02"=>[104,"\xF50"],"\x03"=>[16,"\xF50"],"\x04"=>[94,"\xF51"],"\x05"=>[76,"\xF51"],"\x06"=>[104,"\xF51"],"\x07"=>[16,"\xF51"],"\x08"=>[94,"\xF52"],"\x09"=>[76,"\xF52"],"\x0A"=>[104,"\xF52"],"\x0B"=>[16,"\xF52"],"\x0C"=>[94,"\xF5a"],"\x0D"=>[76,"\xF5a"],"\x0E"=>[104,"\xF5a"],"\x0F"=>[16,"\xF5a"],"\x10"=>[94,"\xF5c"],"\x11"=>[76,"\xF5c"],"\x12"=>[104,"\xF5c"],"\x13"=>[16,"\xF5c"],"\x14"=>[94,"\xF5e"],"\x15"=>[76,"\xF5e"],"\x16"=>[104,"\xF5e"],"\x17"=>[16,"\xF5e"],"\x18"=>[94,"\xF5i"],"\x19"=>[76,"\xF5i"],"\x1A"=>[104,"\xF5i"],"\x1B"=>[16,"\xF5i"],"\x1C"=>[94,"\xF5o"],"\x1D"=>[76,"\xF5o"],"\x1E"=>[104,"\xF5o"],"\x1F"=>[16,"\xF5o"],"\x20"=>[94,"\xF5s"],"\x21"=>[76,"\xF5s"],"\x22"=>[104,"\xF5s"],"\x23"=>[16,"\xF5s"],"\x24"=>[94,"\xF5t"],"\x25"=>[76,"\xF5t"],"\x26"=>[104,"\xF5t"],"\x27"=>[16,"\xF5t"],"\x28"=>[77,"\xF5\x20"],"\x29"=>[18,"\xF5\x20"],"\x2A"=>[77,"\xF5\x25"],"\x2B"=>[18,"\xF5\x25"],"\x2C"=>[77,"\xF5-"],"-"=>[18,"\xF5-"],"."=>[77,"\xF5."],"\x2F"=>[18,"\xF5."],[77,"\xF5\x2F"],[18,"\xF5\x2F"],[77,"\xF53"],[18,"\xF53"],[77,"\xF54"],[18,"\xF54"],[77,"\xF55"],[18,"\xF55"],[77,"\xF56"],[18,"\xF56"],"\x3A"=>[77,"\xF57"],"\x3B"=>[18,"\xF57"],"\x3C"=>[77,"\xF58"],"\x3D"=>[18,"\xF58"],"\x3E"=>[77,"\xF59"],"\x3F"=>[18,"\xF59"],"\x40"=>[77,"\xF5\x3D"],"A"=>[18,"\xF5\x3D"],"B"=>[77,"\xF5A"],"C"=>[18,"\xF5A"],"D"=>[77,"\xF5_"],"E"=>[18,"\xF5_"],"F"=>[77,"\xF5b"],"G"=>[18,"\xF5b"],"H"=>[77,"\xF5d"],"I"=>[18,"\xF5d"],"J"=>[77,"\xF5f"],"K"=>[18,"\xF5f"],"L"=>[77,"\xF5g"],"M"=>[18,"\xF5g"],"N"=>[77,"\xF5h"],"O"=>[18,"\xF5h"],"P"=>[77,"\xF5l"],"Q"=>[18,"\xF5l"],"R"=>[77,"\xF5m"],"S"=>[18,"\xF5m"],"T"=>[77,"\xF5n"],"U"=>[18,"\xF5n"],"V"=>[77,"\xF5p"],"W"=>[18,"\xF5p"],"X"=>[77,"\xF5r"],"Y"=>[18,"\xF5r"],"Z"=>[77,"\xF5u"],"\x5B"=>[18,"\xF5u"],"\x5C"=>[0,"\xF5\x3A"],"\x5D"=>[0,"\xF5B"],"\x5E"=>[0,"\xF5C"],"_"=>[0,"\xF5D"],"\x60"=>[0,"\xF5E"],"a"=>[0,"\xF5F"],"b"=>[0,"\xF5G"],"c"=>[0,"\xF5H"],"d"=>[0,"\xF5I"],"e"=>[0,"\xF5J"],"f"=>[0,"\xF5K"],"g"=>[0,"\xF5L"],"h"=>[0,"\xF5M"],"i"=>[0,"\xF5N"],"j"=>[0,"\xF5O"],"k"=>[0,"\xF5P"],"l"=>[0,"\xF5Q"],"m"=>[0,"\xF5R"],"n"=>[0,"\xF5S"],"o"=>[0,"\xF5T"],"p"=>[0,"\xF5U"],"q"=>[0,"\xF5V"],"r"=>[0,"\xF5W"],"s"=>[0,"\xF5Y"],"t"=>[0,"\xF5j"],"u"=>[0,"\xF5k"],"v"=>[0,"\xF5q"],"w"=>[0,"\xF5v"],"x"=>[0,"\xF5w"],"y"=>[0,"\xF5x"],"z"=>[0,"\xF5y"],"\x7B"=>[0,"\xF5z"],"\x7C"=>[82,"\xF5"],"\x7D"=>[87,"\xF5"],"~"=>[130,"\xF5"],"\x7F"=>[9,"\xF5"],"\x80"=>[94,"\xF60"],"\x81"=>[76,"\xF60"],"\x82"=>[104,"\xF60"],"\x83"=>[16,"\xF60"],"\x84"=>[94,"\xF61"],"\x85"=>[76,"\xF61"],"\x86"=>[104,"\xF61"],"\x87"=>[16,"\xF61"],"\x88"=>[94,"\xF62"],"\x89"=>[76,"\xF62"],"\x8A"=>[104,"\xF62"],"\x8B"=>[16,"\xF62"],"\x8C"=>[94,"\xF6a"],"\x8D"=>[76,"\xF6a"],"\x8E"=>[104,"\xF6a"],"\x8F"=>[16,"\xF6a"],"\x90"=>[94,"\xF6c"],"\x91"=>[76,"\xF6c"],"\x92"=>[104,"\xF6c"],"\x93"=>[16,"\xF6c"],"\x94"=>[94,"\xF6e"],"\x95"=>[76,"\xF6e"],"\x96"=>[104,"\xF6e"],"\x97"=>[16,"\xF6e"],"\x98"=>[94,"\xF6i"],"\x99"=>[76,"\xF6i"],"\x9A"=>[104,"\xF6i"],"\x9B"=>[16,"\xF6i"],"\x9C"=>[94,"\xF6o"],"\x9D"=>[76,"\xF6o"],"\x9E"=>[104,"\xF6o"],"\x9F"=>[16,"\xF6o"],"\xA0"=>[94,"\xF6s"],"\xA1"=>[76,"\xF6s"],"\xA2"=>[104,"\xF6s"],"\xA3"=>[16,"\xF6s"],"\xA4"=>[94,"\xF6t"],"\xA5"=>[76,"\xF6t"],"\xA6"=>[104,"\xF6t"],"\xA7"=>[16,"\xF6t"],"\xA8"=>[77,"\xF6\x20"],"\xA9"=>[18,"\xF6\x20"],"\xAA"=>[77,"\xF6\x25"],"\xAB"=>[18,"\xF6\x25"],"\xAC"=>[77,"\xF6-"],"\xAD"=>[18,"\xF6-"],"\xAE"=>[77,"\xF6."],"\xAF"=>[18,"\xF6."],"\xB0"=>[77,"\xF6\x2F"],"\xB1"=>[18,"\xF6\x2F"],"\xB2"=>[77,"\xF63"],"\xB3"=>[18,"\xF63"],"\xB4"=>[77,"\xF64"],"\xB5"=>[18,"\xF64"],"\xB6"=>[77,"\xF65"],"\xB7"=>[18,"\xF65"],"\xB8"=>[77,"\xF66"],"\xB9"=>[18,"\xF66"],"\xBA"=>[77,"\xF67"],"\xBB"=>[18,"\xF67"],"\xBC"=>[77,"\xF68"],"\xBD"=>[18,"\xF68"],"\xBE"=>[77,"\xF69"],"\xBF"=>[18,"\xF69"],"\xC0"=>[77,"\xF6\x3D"],"\xC1"=>[18,"\xF6\x3D"],"\xC2"=>[77,"\xF6A"],"\xC3"=>[18,"\xF6A"],"\xC4"=>[77,"\xF6_"],"\xC5"=>[18,"\xF6_"],"\xC6"=>[77,"\xF6b"],"\xC7"=>[18,"\xF6b"],"\xC8"=>[77,"\xF6d"],"\xC9"=>[18,"\xF6d"],"\xCA"=>[77,"\xF6f"],"\xCB"=>[18,"\xF6f"],"\xCC"=>[77,"\xF6g"],"\xCD"=>[18,"\xF6g"],"\xCE"=>[77,"\xF6h"],"\xCF"=>[18,"\xF6h"],"\xD0"=>[77,"\xF6l"],"\xD1"=>[18,"\xF6l"],"\xD2"=>[77,"\xF6m"],"\xD3"=>[18,"\xF6m"],"\xD4"=>[77,"\xF6n"],"\xD5"=>[18,"\xF6n"],"\xD6"=>[77,"\xF6p"],"\xD7"=>[18,"\xF6p"],"\xD8"=>[77,"\xF6r"],"\xD9"=>[18,"\xF6r"],"\xDA"=>[77,"\xF6u"],"\xDB"=>[18,"\xF6u"],"\xDC"=>[0,"\xF6\x3A"],"\xDD"=>[0,"\xF6B"],"\xDE"=>[0,"\xF6C"],"\xDF"=>[0,"\xF6D"],"\xE0"=>[0,"\xF6E"],"\xE1"=>[0,"\xF6F"],"\xE2"=>[0,"\xF6G"],"\xE3"=>[0,"\xF6H"],"\xE4"=>[0,"\xF6I"],"\xE5"=>[0,"\xF6J"],"\xE6"=>[0,"\xF6K"],"\xE7"=>[0,"\xF6L"],"\xE8"=>[0,"\xF6M"],"\xE9"=>[0,"\xF6N"],"\xEA"=>[0,"\xF6O"],"\xEB"=>[0,"\xF6P"],"\xEC"=>[0,"\xF6Q"],"\xED"=>[0,"\xF6R"],"\xEE"=>[0,"\xF6S"],"\xEF"=>[0,"\xF6T"],"\xF0"=>[0,"\xF6U"],"\xF1"=>[0,"\xF6V"],"\xF2"=>[0,"\xF6W"],"\xF3"=>[0,"\xF6Y"],"\xF4"=>[0,"\xF6j"],"\xF5"=>[0,"\xF6k"],"\xF6"=>[0,"\xF6q"],"\xF7"=>[0,"\xF6v"],"\xF8"=>[0,"\xF6w"],"\xF9"=>[0,"\xF6x"],"\xFA"=>[0,"\xF6y"],"\xFB"=>[0,"\xF6z"],"\xFC"=>[82,"\xF6"],"\xFD"=>[87,"\xF6"],"\xFE"=>[130,"\xF6"],"\xFF"=>[9,"\xF6"],],["\x00"=>[77,"\xF50"],"\x01"=>[18,"\xF50"],"\x02"=>[77,"\xF51"],"\x03"=>[18,"\xF51"],"\x04"=>[77,"\xF52"],"\x05"=>[18,"\xF52"],"\x06"=>[77,"\xF5a"],"\x07"=>[18,"\xF5a"],"\x08"=>[77,"\xF5c"],"\x09"=>[18,"\xF5c"],"\x0A"=>[77,"\xF5e"],"\x0B"=>[18,"\xF5e"],"\x0C"=>[77,"\xF5i"],"\x0D"=>[18,"\xF5i"],"\x0E"=>[77,"\xF5o"],"\x0F"=>[18,"\xF5o"],"\x10"=>[77,"\xF5s"],"\x11"=>[18,"\xF5s"],"\x12"=>[77,"\xF5t"],"\x13"=>[18,"\xF5t"],"\x14"=>[0,"\xF5\x20"],"\x15"=>[0,"\xF5\x25"],"\x16"=>[0,"\xF5-"],"\x17"=>[0,"\xF5."],"\x18"=>[0,"\xF5\x2F"],"\x19"=>[0,"\xF53"],"\x1A"=>[0,"\xF54"],"\x1B"=>[0,"\xF55"],"\x1C"=>[0,"\xF56"],"\x1D"=>[0,"\xF57"],"\x1E"=>[0,"\xF58"],"\x1F"=>[0,"\xF59"],"\x20"=>[0,"\xF5\x3D"],"\x21"=>[0,"\xF5A"],"\x22"=>[0,"\xF5_"],"\x23"=>[0,"\xF5b"],"\x24"=>[0,"\xF5d"],"\x25"=>[0,"\xF5f"],"\x26"=>[0,"\xF5g"],"\x27"=>[0,"\xF5h"],"\x28"=>[0,"\xF5l"],"\x29"=>[0,"\xF5m"],"\x2A"=>[0,"\xF5n"],"\x2B"=>[0,"\xF5p"],"\x2C"=>[0,"\xF5r"],"-"=>[0,"\xF5u"],"."=>[100,"\xF5"],"\x2F"=>[110,"\xF5"],[111,"\xF5"],[115,"\xF5"],[116,"\xF5"],[118,"\xF5"],[119,"\xF5"],[122,"\xF5"],[123,"\xF5"],[125,"\xF5"],[126,"\xF5"],[129,"\xF5"],"\x3A"=>[143,"\xF5"],"\x3B"=>[148,"\xF5"],"\x3C"=>[151,"\xF5"],"\x3D"=>[153,"\xF5"],"\x3E"=>[83,"\xF5"],"\x3F"=>[10,"\xF5"],"\x40"=>[77,"\xF60"],"A"=>[18,"\xF60"],"B"=>[77,"\xF61"],"C"=>[18,"\xF61"],"D"=>[77,"\xF62"],"E"=>[18,"\xF62"],"F"=>[77,"\xF6a"],"G"=>[18,"\xF6a"],"H"=>[77,"\xF6c"],"I"=>[18,"\xF6c"],"J"=>[77,"\xF6e"],"K"=>[18,"\xF6e"],"L"=>[77,"\xF6i"],"M"=>[18,"\xF6i"],"N"=>[77,"\xF6o"],"O"=>[18,"\xF6o"],"P"=>[77,"\xF6s"],"Q"=>[18,"\xF6s"],"R"=>[77,"\xF6t"],"S"=>[18,"\xF6t"],"T"=>[0,"\xF6\x20"],"U"=>[0,"\xF6\x25"],"V"=>[0,"\xF6-"],"W"=>[0,"\xF6."],"X"=>[0,"\xF6\x2F"],"Y"=>[0,"\xF63"],"Z"=>[0,"\xF64"],"\x5B"=>[0,"\xF65"],"\x5C"=>[0,"\xF66"],"\x5D"=>[0,"\xF67"],"\x5E"=>[0,"\xF68"],"_"=>[0,"\xF69"],"\x60"=>[0,"\xF6\x3D"],"a"=>[0,"\xF6A"],"b"=>[0,"\xF6_"],"c"=>[0,"\xF6b"],"d"=>[0,"\xF6d"],"e"=>[0,"\xF6f"],"f"=>[0,"\xF6g"],"g"=>[0,"\xF6h"],"h"=>[0,"\xF6l"],"i"=>[0,"\xF6m"],"j"=>[0,"\xF6n"],"k"=>[0,"\xF6p"],"l"=>[0,"\xF6r"],"m"=>[0,"\xF6u"],"n"=>[100,"\xF6"],"o"=>[110,"\xF6"],"p"=>[111,"\xF6"],"q"=>[115,"\xF6"],"r"=>[116,"\xF6"],"s"=>[118,"\xF6"],"t"=>[119,"\xF6"],"u"=>[122,"\xF6"],"v"=>[123,"\xF6"],"w"=>[125,"\xF6"],"x"=>[126,"\xF6"],"y"=>[129,"\xF6"],"z"=>[143,"\xF6"],"\x7B"=>[148,"\xF6"],"\x7C"=>[151,"\xF6"],"\x7D"=>[153,"\xF6"],"~"=>[83,"\xF6"],"\x7F"=>[10,"\xF6"],"\x80"=>[77,"\xF70"],"\x81"=>[18,"\xF70"],"\x82"=>[77,"\xF71"],"\x83"=>[18,"\xF71"],"\x84"=>[77,"\xF72"],"\x85"=>[18,"\xF72"],"\x86"=>[77,"\xF7a"],"\x87"=>[18,"\xF7a"],"\x88"=>[77,"\xF7c"],"\x89"=>[18,"\xF7c"],"\x8A"=>[77,"\xF7e"],"\x8B"=>[18,"\xF7e"],"\x8C"=>[77,"\xF7i"],"\x8D"=>[18,"\xF7i"],"\x8E"=>[77,"\xF7o"],"\x8F"=>[18,"\xF7o"],"\x90"=>[77,"\xF7s"],"\x91"=>[18,"\xF7s"],"\x92"=>[77,"\xF7t"],"\x93"=>[18,"\xF7t"],"\x94"=>[0,"\xF7\x20"],"\x95"=>[0,"\xF7\x25"],"\x96"=>[0,"\xF7-"],"\x97"=>[0,"\xF7."],"\x98"=>[0,"\xF7\x2F"],"\x99"=>[0,"\xF73"],"\x9A"=>[0,"\xF74"],"\x9B"=>[0,"\xF75"],"\x9C"=>[0,"\xF76"],"\x9D"=>[0,"\xF77"],"\x9E"=>[0,"\xF78"],"\x9F"=>[0,"\xF79"],"\xA0"=>[0,"\xF7\x3D"],"\xA1"=>[0,"\xF7A"],"\xA2"=>[0,"\xF7_"],"\xA3"=>[0,"\xF7b"],"\xA4"=>[0,"\xF7d"],"\xA5"=>[0,"\xF7f"],"\xA6"=>[0,"\xF7g"],"\xA7"=>[0,"\xF7h"],"\xA8"=>[0,"\xF7l"],"\xA9"=>[0,"\xF7m"],"\xAA"=>[0,"\xF7n"],"\xAB"=>[0,"\xF7p"],"\xAC"=>[0,"\xF7r"],"\xAD"=>[0,"\xF7u"],"\xAE"=>[100,"\xF7"],"\xAF"=>[110,"\xF7"],"\xB0"=>[111,"\xF7"],"\xB1"=>[115,"\xF7"],"\xB2"=>[116,"\xF7"],"\xB3"=>[118,"\xF7"],"\xB4"=>[119,"\xF7"],"\xB5"=>[122,"\xF7"],"\xB6"=>[123,"\xF7"],"\xB7"=>[125,"\xF7"],"\xB8"=>[126,"\xF7"],"\xB9"=>[129,"\xF7"],"\xBA"=>[143,"\xF7"],"\xBB"=>[148,"\xF7"],"\xBC"=>[151,"\xF7"],"\xBD"=>[153,"\xF7"],"\xBE"=>[83,"\xF7"],"\xBF"=>[10,"\xF7"],"\xC0"=>[77,"\xF80"],"\xC1"=>[18,"\xF80"],"\xC2"=>[77,"\xF81"],"\xC3"=>[18,"\xF81"],"\xC4"=>[77,"\xF82"],"\xC5"=>[18,"\xF82"],"\xC6"=>[77,"\xF8a"],"\xC7"=>[18,"\xF8a"],"\xC8"=>[77,"\xF8c"],"\xC9"=>[18,"\xF8c"],"\xCA"=>[77,"\xF8e"],"\xCB"=>[18,"\xF8e"],"\xCC"=>[77,"\xF8i"],"\xCD"=>[18,"\xF8i"],"\xCE"=>[77,"\xF8o"],"\xCF"=>[18,"\xF8o"],"\xD0"=>[77,"\xF8s"],"\xD1"=>[18,"\xF8s"],"\xD2"=>[77,"\xF8t"],"\xD3"=>[18,"\xF8t"],"\xD4"=>[0,"\xF8\x20"],"\xD5"=>[0,"\xF8\x25"],"\xD6"=>[0,"\xF8-"],"\xD7"=>[0,"\xF8."],"\xD8"=>[0,"\xF8\x2F"],"\xD9"=>[0,"\xF83"],"\xDA"=>[0,"\xF84"],"\xDB"=>[0,"\xF85"],"\xDC"=>[0,"\xF86"],"\xDD"=>[0,"\xF87"],"\xDE"=>[0,"\xF88"],"\xDF"=>[0,"\xF89"],"\xE0"=>[0,"\xF8\x3D"],"\xE1"=>[0,"\xF8A"],"\xE2"=>[0,"\xF8_"],"\xE3"=>[0,"\xF8b"],"\xE4"=>[0,"\xF8d"],"\xE5"=>[0,"\xF8f"],"\xE6"=>[0,"\xF8g"],"\xE7"=>[0,"\xF8h"],"\xE8"=>[0,"\xF8l"],"\xE9"=>[0,"\xF8m"],"\xEA"=>[0,"\xF8n"],"\xEB"=>[0,"\xF8p"],"\xEC"=>[0,"\xF8r"],"\xED"=>[0,"\xF8u"],"\xEE"=>[100,"\xF8"],"\xEF"=>[110,"\xF8"],"\xF0"=>[111,"\xF8"],"\xF1"=>[115,"\xF8"],"\xF2"=>[116,"\xF8"],"\xF3"=>[118,"\xF8"],"\xF4"=>[119,"\xF8"],"\xF5"=>[122,"\xF8"],"\xF6"=>[123,"\xF8"],"\xF7"=>[125,"\xF8"],"\xF8"=>[126,"\xF8"],"\xF9"=>[129,"\xF8"],"\xFA"=>[143,"\xF8"],"\xFB"=>[148,"\xF8"],"\xFC"=>[151,"\xF8"],"\xFD"=>[153,"\xF8"],"\xFE"=>[83,"\xF8"],"\xFF"=>[10,"\xF8"],],["\x00"=>[94,"\xF70"],"\x01"=>[76,"\xF70"],"\x02"=>[104,"\xF70"],"\x03"=>[16,"\xF70"],"\x04"=>[94,"\xF71"],"\x05"=>[76,"\xF71"],"\x06"=>[104,"\xF71"],"\x07"=>[16,"\xF71"],"\x08"=>[94,"\xF72"],"\x09"=>[76,"\xF72"],"\x0A"=>[104,"\xF72"],"\x0B"=>[16,"\xF72"],"\x0C"=>[94,"\xF7a"],"\x0D"=>[76,"\xF7a"],"\x0E"=>[104,"\xF7a"],"\x0F"=>[16,"\xF7a"],"\x10"=>[94,"\xF7c"],"\x11"=>[76,"\xF7c"],"\x12"=>[104,"\xF7c"],"\x13"=>[16,"\xF7c"],"\x14"=>[94,"\xF7e"],"\x15"=>[76,"\xF7e"],"\x16"=>[104,"\xF7e"],"\x17"=>[16,"\xF7e"],"\x18"=>[94,"\xF7i"],"\x19"=>[76,"\xF7i"],"\x1A"=>[104,"\xF7i"],"\x1B"=>[16,"\xF7i"],"\x1C"=>[94,"\xF7o"],"\x1D"=>[76,"\xF7o"],"\x1E"=>[104,"\xF7o"],"\x1F"=>[16,"\xF7o"],"\x20"=>[94,"\xF7s"],"\x21"=>[76,"\xF7s"],"\x22"=>[104,"\xF7s"],"\x23"=>[16,"\xF7s"],"\x24"=>[94,"\xF7t"],"\x25"=>[76,"\xF7t"],"\x26"=>[104,"\xF7t"],"\x27"=>[16,"\xF7t"],"\x28"=>[77,"\xF7\x20"],"\x29"=>[18,"\xF7\x20"],"\x2A"=>[77,"\xF7\x25"],"\x2B"=>[18,"\xF7\x25"],"\x2C"=>[77,"\xF7-"],"-"=>[18,"\xF7-"],"."=>[77,"\xF7."],"\x2F"=>[18,"\xF7."],[77,"\xF7\x2F"],[18,"\xF7\x2F"],[77,"\xF73"],[18,"\xF73"],[77,"\xF74"],[18,"\xF74"],[77,"\xF75"],[18,"\xF75"],[77,"\xF76"],[18,"\xF76"],"\x3A"=>[77,"\xF77"],"\x3B"=>[18,"\xF77"],"\x3C"=>[77,"\xF78"],"\x3D"=>[18,"\xF78"],"\x3E"=>[77,"\xF79"],"\x3F"=>[18,"\xF79"],"\x40"=>[77,"\xF7\x3D"],"A"=>[18,"\xF7\x3D"],"B"=>[77,"\xF7A"],"C"=>[18,"\xF7A"],"D"=>[77,"\xF7_"],"E"=>[18,"\xF7_"],"F"=>[77,"\xF7b"],"G"=>[18,"\xF7b"],"H"=>[77,"\xF7d"],"I"=>[18,"\xF7d"],"J"=>[77,"\xF7f"],"K"=>[18,"\xF7f"],"L"=>[77,"\xF7g"],"M"=>[18,"\xF7g"],"N"=>[77,"\xF7h"],"O"=>[18,"\xF7h"],"P"=>[77,"\xF7l"],"Q"=>[18,"\xF7l"],"R"=>[77,"\xF7m"],"S"=>[18,"\xF7m"],"T"=>[77,"\xF7n"],"U"=>[18,"\xF7n"],"V"=>[77,"\xF7p"],"W"=>[18,"\xF7p"],"X"=>[77,"\xF7r"],"Y"=>[18,"\xF7r"],"Z"=>[77,"\xF7u"],"\x5B"=>[18,"\xF7u"],"\x5C"=>[0,"\xF7\x3A"],"\x5D"=>[0,"\xF7B"],"\x5E"=>[0,"\xF7C"],"_"=>[0,"\xF7D"],"\x60"=>[0,"\xF7E"],"a"=>[0,"\xF7F"],"b"=>[0,"\xF7G"],"c"=>[0,"\xF7H"],"d"=>[0,"\xF7I"],"e"=>[0,"\xF7J"],"f"=>[0,"\xF7K"],"g"=>[0,"\xF7L"],"h"=>[0,"\xF7M"],"i"=>[0,"\xF7N"],"j"=>[0,"\xF7O"],"k"=>[0,"\xF7P"],"l"=>[0,"\xF7Q"],"m"=>[0,"\xF7R"],"n"=>[0,"\xF7S"],"o"=>[0,"\xF7T"],"p"=>[0,"\xF7U"],"q"=>[0,"\xF7V"],"r"=>[0,"\xF7W"],"s"=>[0,"\xF7Y"],"t"=>[0,"\xF7j"],"u"=>[0,"\xF7k"],"v"=>[0,"\xF7q"],"w"=>[0,"\xF7v"],"x"=>[0,"\xF7w"],"y"=>[0,"\xF7x"],"z"=>[0,"\xF7y"],"\x7B"=>[0,"\xF7z"],"\x7C"=>[82,"\xF7"],"\x7D"=>[87,"\xF7"],"~"=>[130,"\xF7"],"\x7F"=>[9,"\xF7"],"\x80"=>[94,"\xF80"],"\x81"=>[76,"\xF80"],"\x82"=>[104,"\xF80"],"\x83"=>[16,"\xF80"],"\x84"=>[94,"\xF81"],"\x85"=>[76,"\xF81"],"\x86"=>[104,"\xF81"],"\x87"=>[16,"\xF81"],"\x88"=>[94,"\xF82"],"\x89"=>[76,"\xF82"],"\x8A"=>[104,"\xF82"],"\x8B"=>[16,"\xF82"],"\x8C"=>[94,"\xF8a"],"\x8D"=>[76,"\xF8a"],"\x8E"=>[104,"\xF8a"],"\x8F"=>[16,"\xF8a"],"\x90"=>[94,"\xF8c"],"\x91"=>[76,"\xF8c"],"\x92"=>[104,"\xF8c"],"\x93"=>[16,"\xF8c"],"\x94"=>[94,"\xF8e"],"\x95"=>[76,"\xF8e"],"\x96"=>[104,"\xF8e"],"\x97"=>[16,"\xF8e"],"\x98"=>[94,"\xF8i"],"\x99"=>[76,"\xF8i"],"\x9A"=>[104,"\xF8i"],"\x9B"=>[16,"\xF8i"],"\x9C"=>[94,"\xF8o"],"\x9D"=>[76,"\xF8o"],"\x9E"=>[104,"\xF8o"],"\x9F"=>[16,"\xF8o"],"\xA0"=>[94,"\xF8s"],"\xA1"=>[76,"\xF8s"],"\xA2"=>[104,"\xF8s"],"\xA3"=>[16,"\xF8s"],"\xA4"=>[94,"\xF8t"],"\xA5"=>[76,"\xF8t"],"\xA6"=>[104,"\xF8t"],"\xA7"=>[16,"\xF8t"],"\xA8"=>[77,"\xF8\x20"],"\xA9"=>[18,"\xF8\x20"],"\xAA"=>[77,"\xF8\x25"],"\xAB"=>[18,"\xF8\x25"],"\xAC"=>[77,"\xF8-"],"\xAD"=>[18,"\xF8-"],"\xAE"=>[77,"\xF8."],"\xAF"=>[18,"\xF8."],"\xB0"=>[77,"\xF8\x2F"],"\xB1"=>[18,"\xF8\x2F"],"\xB2"=>[77,"\xF83"],"\xB3"=>[18,"\xF83"],"\xB4"=>[77,"\xF84"],"\xB5"=>[18,"\xF84"],"\xB6"=>[77,"\xF85"],"\xB7"=>[18,"\xF85"],"\xB8"=>[77,"\xF86"],"\xB9"=>[18,"\xF86"],"\xBA"=>[77,"\xF87"],"\xBB"=>[18,"\xF87"],"\xBC"=>[77,"\xF88"],"\xBD"=>[18,"\xF88"],"\xBE"=>[77,"\xF89"],"\xBF"=>[18,"\xF89"],"\xC0"=>[77,"\xF8\x3D"],"\xC1"=>[18,"\xF8\x3D"],"\xC2"=>[77,"\xF8A"],"\xC3"=>[18,"\xF8A"],"\xC4"=>[77,"\xF8_"],"\xC5"=>[18,"\xF8_"],"\xC6"=>[77,"\xF8b"],"\xC7"=>[18,"\xF8b"],"\xC8"=>[77,"\xF8d"],"\xC9"=>[18,"\xF8d"],"\xCA"=>[77,"\xF8f"],"\xCB"=>[18,"\xF8f"],"\xCC"=>[77,"\xF8g"],"\xCD"=>[18,"\xF8g"],"\xCE"=>[77,"\xF8h"],"\xCF"=>[18,"\xF8h"],"\xD0"=>[77,"\xF8l"],"\xD1"=>[18,"\xF8l"],"\xD2"=>[77,"\xF8m"],"\xD3"=>[18,"\xF8m"],"\xD4"=>[77,"\xF8n"],"\xD5"=>[18,"\xF8n"],"\xD6"=>[77,"\xF8p"],"\xD7"=>[18,"\xF8p"],"\xD8"=>[77,"\xF8r"],"\xD9"=>[18,"\xF8r"],"\xDA"=>[77,"\xF8u"],"\xDB"=>[18,"\xF8u"],"\xDC"=>[0,"\xF8\x3A"],"\xDD"=>[0,"\xF8B"],"\xDE"=>[0,"\xF8C"],"\xDF"=>[0,"\xF8D"],"\xE0"=>[0,"\xF8E"],"\xE1"=>[0,"\xF8F"],"\xE2"=>[0,"\xF8G"],"\xE3"=>[0,"\xF8H"],"\xE4"=>[0,"\xF8I"],"\xE5"=>[0,"\xF8J"],"\xE6"=>[0,"\xF8K"],"\xE7"=>[0,"\xF8L"],"\xE8"=>[0,"\xF8M"],"\xE9"=>[0,"\xF8N"],"\xEA"=>[0,"\xF8O"],"\xEB"=>[0,"\xF8P"],"\xEC"=>[0,"\xF8Q"],"\xED"=>[0,"\xF8R"],"\xEE"=>[0,"\xF8S"],"\xEF"=>[0,"\xF8T"],"\xF0"=>[0,"\xF8U"],"\xF1"=>[0,"\xF8V"],"\xF2"=>[0,"\xF8W"],"\xF3"=>[0,"\xF8Y"],"\xF4"=>[0,"\xF8j"],"\xF5"=>[0,"\xF8k"],"\xF6"=>[0,"\xF8q"],"\xF7"=>[0,"\xF8v"],"\xF8"=>[0,"\xF8w"],"\xF9"=>[0,"\xF8x"],"\xFA"=>[0,"\xF8y"],"\xFB"=>[0,"\xF8z"],"\xFC"=>[82,"\xF8"],"\xFD"=>[87,"\xF8"],"\xFE"=>[130,"\xF8"],"\xFF"=>[9,"\xF8"],],["\x00"=>[94,"\xFA0"],"\x01"=>[76,"\xFA0"],"\x02"=>[104,"\xFA0"],"\x03"=>[16,"\xFA0"],"\x04"=>[94,"\xFA1"],"\x05"=>[76,"\xFA1"],"\x06"=>[104,"\xFA1"],"\x07"=>[16,"\xFA1"],"\x08"=>[94,"\xFA2"],"\x09"=>[76,"\xFA2"],"\x0A"=>[104,"\xFA2"],"\x0B"=>[16,"\xFA2"],"\x0C"=>[94,"\xFAa"],"\x0D"=>[76,"\xFAa"],"\x0E"=>[104,"\xFAa"],"\x0F"=>[16,"\xFAa"],"\x10"=>[94,"\xFAc"],"\x11"=>[76,"\xFAc"],"\x12"=>[104,"\xFAc"],"\x13"=>[16,"\xFAc"],"\x14"=>[94,"\xFAe"],"\x15"=>[76,"\xFAe"],"\x16"=>[104,"\xFAe"],"\x17"=>[16,"\xFAe"],"\x18"=>[94,"\xFAi"],"\x19"=>[76,"\xFAi"],"\x1A"=>[104,"\xFAi"],"\x1B"=>[16,"\xFAi"],"\x1C"=>[94,"\xFAo"],"\x1D"=>[76,"\xFAo"],"\x1E"=>[104,"\xFAo"],"\x1F"=>[16,"\xFAo"],"\x20"=>[94,"\xFAs"],"\x21"=>[76,"\xFAs"],"\x22"=>[104,"\xFAs"],"\x23"=>[16,"\xFAs"],"\x24"=>[94,"\xFAt"],"\x25"=>[76,"\xFAt"],"\x26"=>[104,"\xFAt"],"\x27"=>[16,"\xFAt"],"\x28"=>[77,"\xFA\x20"],"\x29"=>[18,"\xFA\x20"],"\x2A"=>[77,"\xFA\x25"],"\x2B"=>[18,"\xFA\x25"],"\x2C"=>[77,"\xFA-"],"-"=>[18,"\xFA-"],"."=>[77,"\xFA."],"\x2F"=>[18,"\xFA."],[77,"\xFA\x2F"],[18,"\xFA\x2F"],[77,"\xFA3"],[18,"\xFA3"],[77,"\xFA4"],[18,"\xFA4"],[77,"\xFA5"],[18,"\xFA5"],[77,"\xFA6"],[18,"\xFA6"],"\x3A"=>[77,"\xFA7"],"\x3B"=>[18,"\xFA7"],"\x3C"=>[77,"\xFA8"],"\x3D"=>[18,"\xFA8"],"\x3E"=>[77,"\xFA9"],"\x3F"=>[18,"\xFA9"],"\x40"=>[77,"\xFA\x3D"],"A"=>[18,"\xFA\x3D"],"B"=>[77,"\xFAA"],"C"=>[18,"\xFAA"],"D"=>[77,"\xFA_"],"E"=>[18,"\xFA_"],"F"=>[77,"\xFAb"],"G"=>[18,"\xFAb"],"H"=>[77,"\xFAd"],"I"=>[18,"\xFAd"],"J"=>[77,"\xFAf"],"K"=>[18,"\xFAf"],"L"=>[77,"\xFAg"],"M"=>[18,"\xFAg"],"N"=>[77,"\xFAh"],"O"=>[18,"\xFAh"],"P"=>[77,"\xFAl"],"Q"=>[18,"\xFAl"],"R"=>[77,"\xFAm"],"S"=>[18,"\xFAm"],"T"=>[77,"\xFAn"],"U"=>[18,"\xFAn"],"V"=>[77,"\xFAp"],"W"=>[18,"\xFAp"],"X"=>[77,"\xFAr"],"Y"=>[18,"\xFAr"],"Z"=>[77,"\xFAu"],"\x5B"=>[18,"\xFAu"],"\x5C"=>[0,"\xFA\x3A"],"\x5D"=>[0,"\xFAB"],"\x5E"=>[0,"\xFAC"],"_"=>[0,"\xFAD"],"\x60"=>[0,"\xFAE"],"a"=>[0,"\xFAF"],"b"=>[0,"\xFAG"],"c"=>[0,"\xFAH"],"d"=>[0,"\xFAI"],"e"=>[0,"\xFAJ"],"f"=>[0,"\xFAK"],"g"=>[0,"\xFAL"],"h"=>[0,"\xFAM"],"i"=>[0,"\xFAN"],"j"=>[0,"\xFAO"],"k"=>[0,"\xFAP"],"l"=>[0,"\xFAQ"],"m"=>[0,"\xFAR"],"n"=>[0,"\xFAS"],"o"=>[0,"\xFAT"],"p"=>[0,"\xFAU"],"q"=>[0,"\xFAV"],"r"=>[0,"\xFAW"],"s"=>[0,"\xFAY"],"t"=>[0,"\xFAj"],"u"=>[0,"\xFAk"],"v"=>[0,"\xFAq"],"w"=>[0,"\xFAv"],"x"=>[0,"\xFAw"],"y"=>[0,"\xFAx"],"z"=>[0,"\xFAy"],"\x7B"=>[0,"\xFAz"],"\x7C"=>[82,"\xFA"],"\x7D"=>[87,"\xFA"],"~"=>[130,"\xFA"],"\x7F"=>[9,"\xFA"],"\x80"=>[94,"\xFB0"],"\x81"=>[76,"\xFB0"],"\x82"=>[104,"\xFB0"],"\x83"=>[16,"\xFB0"],"\x84"=>[94,"\xFB1"],"\x85"=>[76,"\xFB1"],"\x86"=>[104,"\xFB1"],"\x87"=>[16,"\xFB1"],"\x88"=>[94,"\xFB2"],"\x89"=>[76,"\xFB2"],"\x8A"=>[104,"\xFB2"],"\x8B"=>[16,"\xFB2"],"\x8C"=>[94,"\xFBa"],"\x8D"=>[76,"\xFBa"],"\x8E"=>[104,"\xFBa"],"\x8F"=>[16,"\xFBa"],"\x90"=>[94,"\xFBc"],"\x91"=>[76,"\xFBc"],"\x92"=>[104,"\xFBc"],"\x93"=>[16,"\xFBc"],"\x94"=>[94,"\xFBe"],"\x95"=>[76,"\xFBe"],"\x96"=>[104,"\xFBe"],"\x97"=>[16,"\xFBe"],"\x98"=>[94,"\xFBi"],"\x99"=>[76,"\xFBi"],"\x9A"=>[104,"\xFBi"],"\x9B"=>[16,"\xFBi"],"\x9C"=>[94,"\xFBo"],"\x9D"=>[76,"\xFBo"],"\x9E"=>[104,"\xFBo"],"\x9F"=>[16,"\xFBo"],"\xA0"=>[94,"\xFBs"],"\xA1"=>[76,"\xFBs"],"\xA2"=>[104,"\xFBs"],"\xA3"=>[16,"\xFBs"],"\xA4"=>[94,"\xFBt"],"\xA5"=>[76,"\xFBt"],"\xA6"=>[104,"\xFBt"],"\xA7"=>[16,"\xFBt"],"\xA8"=>[77,"\xFB\x20"],"\xA9"=>[18,"\xFB\x20"],"\xAA"=>[77,"\xFB\x25"],"\xAB"=>[18,"\xFB\x25"],"\xAC"=>[77,"\xFB-"],"\xAD"=>[18,"\xFB-"],"\xAE"=>[77,"\xFB."],"\xAF"=>[18,"\xFB."],"\xB0"=>[77,"\xFB\x2F"],"\xB1"=>[18,"\xFB\x2F"],"\xB2"=>[77,"\xFB3"],"\xB3"=>[18,"\xFB3"],"\xB4"=>[77,"\xFB4"],"\xB5"=>[18,"\xFB4"],"\xB6"=>[77,"\xFB5"],"\xB7"=>[18,"\xFB5"],"\xB8"=>[77,"\xFB6"],"\xB9"=>[18,"\xFB6"],"\xBA"=>[77,"\xFB7"],"\xBB"=>[18,"\xFB7"],"\xBC"=>[77,"\xFB8"],"\xBD"=>[18,"\xFB8"],"\xBE"=>[77,"\xFB9"],"\xBF"=>[18,"\xFB9"],"\xC0"=>[77,"\xFB\x3D"],"\xC1"=>[18,"\xFB\x3D"],"\xC2"=>[77,"\xFBA"],"\xC3"=>[18,"\xFBA"],"\xC4"=>[77,"\xFB_"],"\xC5"=>[18,"\xFB_"],"\xC6"=>[77,"\xFBb"],"\xC7"=>[18,"\xFBb"],"\xC8"=>[77,"\xFBd"],"\xC9"=>[18,"\xFBd"],"\xCA"=>[77,"\xFBf"],"\xCB"=>[18,"\xFBf"],"\xCC"=>[77,"\xFBg"],"\xCD"=>[18,"\xFBg"],"\xCE"=>[77,"\xFBh"],"\xCF"=>[18,"\xFBh"],"\xD0"=>[77,"\xFBl"],"\xD1"=>[18,"\xFBl"],"\xD2"=>[77,"\xFBm"],"\xD3"=>[18,"\xFBm"],"\xD4"=>[77,"\xFBn"],"\xD5"=>[18,"\xFBn"],"\xD6"=>[77,"\xFBp"],"\xD7"=>[18,"\xFBp"],"\xD8"=>[77,"\xFBr"],"\xD9"=>[18,"\xFBr"],"\xDA"=>[77,"\xFBu"],"\xDB"=>[18,"\xFBu"],"\xDC"=>[0,"\xFB\x3A"],"\xDD"=>[0,"\xFBB"],"\xDE"=>[0,"\xFBC"],"\xDF"=>[0,"\xFBD"],"\xE0"=>[0,"\xFBE"],"\xE1"=>[0,"\xFBF"],"\xE2"=>[0,"\xFBG"],"\xE3"=>[0,"\xFBH"],"\xE4"=>[0,"\xFBI"],"\xE5"=>[0,"\xFBJ"],"\xE6"=>[0,"\xFBK"],"\xE7"=>[0,"\xFBL"],"\xE8"=>[0,"\xFBM"],"\xE9"=>[0,"\xFBN"],"\xEA"=>[0,"\xFBO"],"\xEB"=>[0,"\xFBP"],"\xEC"=>[0,"\xFBQ"],"\xED"=>[0,"\xFBR"],"\xEE"=>[0,"\xFBS"],"\xEF"=>[0,"\xFBT"],"\xF0"=>[0,"\xFBU"],"\xF1"=>[0,"\xFBV"],"\xF2"=>[0,"\xFBW"],"\xF3"=>[0,"\xFBY"],"\xF4"=>[0,"\xFBj"],"\xF5"=>[0,"\xFBk"],"\xF6"=>[0,"\xFBq"],"\xF7"=>[0,"\xFBv"],"\xF8"=>[0,"\xFBw"],"\xF9"=>[0,"\xFBx"],"\xFA"=>[0,"\xFBy"],"\xFB"=>[0,"\xFBz"],"\xFC"=>[82,"\xFB"],"\xFD"=>[87,"\xFB"],"\xFE"=>[130,"\xFB"],"\xFF"=>[9,"\xFB"],],["\x00"=>[77,"\xFA0"],"\x01"=>[18,"\xFA0"],"\x02"=>[77,"\xFA1"],"\x03"=>[18,"\xFA1"],"\x04"=>[77,"\xFA2"],"\x05"=>[18,"\xFA2"],"\x06"=>[77,"\xFAa"],"\x07"=>[18,"\xFAa"],"\x08"=>[77,"\xFAc"],"\x09"=>[18,"\xFAc"],"\x0A"=>[77,"\xFAe"],"\x0B"=>[18,"\xFAe"],"\x0C"=>[77,"\xFAi"],"\x0D"=>[18,"\xFAi"],"\x0E"=>[77,"\xFAo"],"\x0F"=>[18,"\xFAo"],"\x10"=>[77,"\xFAs"],"\x11"=>[18,"\xFAs"],"\x12"=>[77,"\xFAt"],"\x13"=>[18,"\xFAt"],"\x14"=>[0,"\xFA\x20"],"\x15"=>[0,"\xFA\x25"],"\x16"=>[0,"\xFA-"],"\x17"=>[0,"\xFA."],"\x18"=>[0,"\xFA\x2F"],"\x19"=>[0,"\xFA3"],"\x1A"=>[0,"\xFA4"],"\x1B"=>[0,"\xFA5"],"\x1C"=>[0,"\xFA6"],"\x1D"=>[0,"\xFA7"],"\x1E"=>[0,"\xFA8"],"\x1F"=>[0,"\xFA9"],"\x20"=>[0,"\xFA\x3D"],"\x21"=>[0,"\xFAA"],"\x22"=>[0,"\xFA_"],"\x23"=>[0,"\xFAb"],"\x24"=>[0,"\xFAd"],"\x25"=>[0,"\xFAf"],"\x26"=>[0,"\xFAg"],"\x27"=>[0,"\xFAh"],"\x28"=>[0,"\xFAl"],"\x29"=>[0,"\xFAm"],"\x2A"=>[0,"\xFAn"],"\x2B"=>[0,"\xFAp"],"\x2C"=>[0,"\xFAr"],"-"=>[0,"\xFAu"],"."=>[100,"\xFA"],"\x2F"=>[110,"\xFA"],[111,"\xFA"],[115,"\xFA"],[116,"\xFA"],[118,"\xFA"],[119,"\xFA"],[122,"\xFA"],[123,"\xFA"],[125,"\xFA"],[126,"\xFA"],[129,"\xFA"],"\x3A"=>[143,"\xFA"],"\x3B"=>[148,"\xFA"],"\x3C"=>[151,"\xFA"],"\x3D"=>[153,"\xFA"],"\x3E"=>[83,"\xFA"],"\x3F"=>[10,"\xFA"],"\x40"=>[77,"\xFB0"],"A"=>[18,"\xFB0"],"B"=>[77,"\xFB1"],"C"=>[18,"\xFB1"],"D"=>[77,"\xFB2"],"E"=>[18,"\xFB2"],"F"=>[77,"\xFBa"],"G"=>[18,"\xFBa"],"H"=>[77,"\xFBc"],"I"=>[18,"\xFBc"],"J"=>[77,"\xFBe"],"K"=>[18,"\xFBe"],"L"=>[77,"\xFBi"],"M"=>[18,"\xFBi"],"N"=>[77,"\xFBo"],"O"=>[18,"\xFBo"],"P"=>[77,"\xFBs"],"Q"=>[18,"\xFBs"],"R"=>[77,"\xFBt"],"S"=>[18,"\xFBt"],"T"=>[0,"\xFB\x20"],"U"=>[0,"\xFB\x25"],"V"=>[0,"\xFB-"],"W"=>[0,"\xFB."],"X"=>[0,"\xFB\x2F"],"Y"=>[0,"\xFB3"],"Z"=>[0,"\xFB4"],"\x5B"=>[0,"\xFB5"],"\x5C"=>[0,"\xFB6"],"\x5D"=>[0,"\xFB7"],"\x5E"=>[0,"\xFB8"],"_"=>[0,"\xFB9"],"\x60"=>[0,"\xFB\x3D"],"a"=>[0,"\xFBA"],"b"=>[0,"\xFB_"],"c"=>[0,"\xFBb"],"d"=>[0,"\xFBd"],"e"=>[0,"\xFBf"],"f"=>[0,"\xFBg"],"g"=>[0,"\xFBh"],"h"=>[0,"\xFBl"],"i"=>[0,"\xFBm"],"j"=>[0,"\xFBn"],"k"=>[0,"\xFBp"],"l"=>[0,"\xFBr"],"m"=>[0,"\xFBu"],"n"=>[100,"\xFB"],"o"=>[110,"\xFB"],"p"=>[111,"\xFB"],"q"=>[115,"\xFB"],"r"=>[116,"\xFB"],"s"=>[118,"\xFB"],"t"=>[119,"\xFB"],"u"=>[122,"\xFB"],"v"=>[123,"\xFB"],"w"=>[125,"\xFB"],"x"=>[126,"\xFB"],"y"=>[129,"\xFB"],"z"=>[143,"\xFB"],"\x7B"=>[148,"\xFB"],"\x7C"=>[151,"\xFB"],"\x7D"=>[153,"\xFB"],"~"=>[83,"\xFB"],"\x7F"=>[10,"\xFB"],"\x80"=>[77,"\xFC0"],"\x81"=>[18,"\xFC0"],"\x82"=>[77,"\xFC1"],"\x83"=>[18,"\xFC1"],"\x84"=>[77,"\xFC2"],"\x85"=>[18,"\xFC2"],"\x86"=>[77,"\xFCa"],"\x87"=>[18,"\xFCa"],"\x88"=>[77,"\xFCc"],"\x89"=>[18,"\xFCc"],"\x8A"=>[77,"\xFCe"],"\x8B"=>[18,"\xFCe"],"\x8C"=>[77,"\xFCi"],"\x8D"=>[18,"\xFCi"],"\x8E"=>[77,"\xFCo"],"\x8F"=>[18,"\xFCo"],"\x90"=>[77,"\xFCs"],"\x91"=>[18,"\xFCs"],"\x92"=>[77,"\xFCt"],"\x93"=>[18,"\xFCt"],"\x94"=>[0,"\xFC\x20"],"\x95"=>[0,"\xFC\x25"],"\x96"=>[0,"\xFC-"],"\x97"=>[0,"\xFC."],"\x98"=>[0,"\xFC\x2F"],"\x99"=>[0,"\xFC3"],"\x9A"=>[0,"\xFC4"],"\x9B"=>[0,"\xFC5"],"\x9C"=>[0,"\xFC6"],"\x9D"=>[0,"\xFC7"],"\x9E"=>[0,"\xFC8"],"\x9F"=>[0,"\xFC9"],"\xA0"=>[0,"\xFC\x3D"],"\xA1"=>[0,"\xFCA"],"\xA2"=>[0,"\xFC_"],"\xA3"=>[0,"\xFCb"],"\xA4"=>[0,"\xFCd"],"\xA5"=>[0,"\xFCf"],"\xA6"=>[0,"\xFCg"],"\xA7"=>[0,"\xFCh"],"\xA8"=>[0,"\xFCl"],"\xA9"=>[0,"\xFCm"],"\xAA"=>[0,"\xFCn"],"\xAB"=>[0,"\xFCp"],"\xAC"=>[0,"\xFCr"],"\xAD"=>[0,"\xFCu"],"\xAE"=>[100,"\xFC"],"\xAF"=>[110,"\xFC"],"\xB0"=>[111,"\xFC"],"\xB1"=>[115,"\xFC"],"\xB2"=>[116,"\xFC"],"\xB3"=>[118,"\xFC"],"\xB4"=>[119,"\xFC"],"\xB5"=>[122,"\xFC"],"\xB6"=>[123,"\xFC"],"\xB7"=>[125,"\xFC"],"\xB8"=>[126,"\xFC"],"\xB9"=>[129,"\xFC"],"\xBA"=>[143,"\xFC"],"\xBB"=>[148,"\xFC"],"\xBC"=>[151,"\xFC"],"\xBD"=>[153,"\xFC"],"\xBE"=>[83,"\xFC"],"\xBF"=>[10,"\xFC"],"\xC0"=>[77,"\xFD0"],"\xC1"=>[18,"\xFD0"],"\xC2"=>[77,"\xFD1"],"\xC3"=>[18,"\xFD1"],"\xC4"=>[77,"\xFD2"],"\xC5"=>[18,"\xFD2"],"\xC6"=>[77,"\xFDa"],"\xC7"=>[18,"\xFDa"],"\xC8"=>[77,"\xFDc"],"\xC9"=>[18,"\xFDc"],"\xCA"=>[77,"\xFDe"],"\xCB"=>[18,"\xFDe"],"\xCC"=>[77,"\xFDi"],"\xCD"=>[18,"\xFDi"],"\xCE"=>[77,"\xFDo"],"\xCF"=>[18,"\xFDo"],"\xD0"=>[77,"\xFDs"],"\xD1"=>[18,"\xFDs"],"\xD2"=>[77,"\xFDt"],"\xD3"=>[18,"\xFDt"],"\xD4"=>[0,"\xFD\x20"],"\xD5"=>[0,"\xFD\x25"],"\xD6"=>[0,"\xFD-"],"\xD7"=>[0,"\xFD."],"\xD8"=>[0,"\xFD\x2F"],"\xD9"=>[0,"\xFD3"],"\xDA"=>[0,"\xFD4"],"\xDB"=>[0,"\xFD5"],"\xDC"=>[0,"\xFD6"],"\xDD"=>[0,"\xFD7"],"\xDE"=>[0,"\xFD8"],"\xDF"=>[0,"\xFD9"],"\xE0"=>[0,"\xFD\x3D"],"\xE1"=>[0,"\xFDA"],"\xE2"=>[0,"\xFD_"],"\xE3"=>[0,"\xFDb"],"\xE4"=>[0,"\xFDd"],"\xE5"=>[0,"\xFDf"],"\xE6"=>[0,"\xFDg"],"\xE7"=>[0,"\xFDh"],"\xE8"=>[0,"\xFDl"],"\xE9"=>[0,"\xFDm"],"\xEA"=>[0,"\xFDn"],"\xEB"=>[0,"\xFDp"],"\xEC"=>[0,"\xFDr"],"\xED"=>[0,"\xFDu"],"\xEE"=>[100,"\xFD"],"\xEF"=>[110,"\xFD"],"\xF0"=>[111,"\xFD"],"\xF1"=>[115,"\xFD"],"\xF2"=>[116,"\xFD"],"\xF3"=>[118,"\xFD"],"\xF4"=>[119,"\xFD"],"\xF5"=>[122,"\xFD"],"\xF6"=>[123,"\xFD"],"\xF7"=>[125,"\xFD"],"\xF8"=>[126,"\xFD"],"\xF9"=>[129,"\xFD"],"\xFA"=>[143,"\xFD"],"\xFB"=>[148,"\xFD"],"\xFC"=>[151,"\xFD"],"\xFD"=>[153,"\xFD"],"\xFE"=>[83,"\xFD"],"\xFF"=>[10,"\xFD"],],["\x00"=>[94,"\xFC0"],"\x01"=>[76,"\xFC0"],"\x02"=>[104,"\xFC0"],"\x03"=>[16,"\xFC0"],"\x04"=>[94,"\xFC1"],"\x05"=>[76,"\xFC1"],"\x06"=>[104,"\xFC1"],"\x07"=>[16,"\xFC1"],"\x08"=>[94,"\xFC2"],"\x09"=>[76,"\xFC2"],"\x0A"=>[104,"\xFC2"],"\x0B"=>[16,"\xFC2"],"\x0C"=>[94,"\xFCa"],"\x0D"=>[76,"\xFCa"],"\x0E"=>[104,"\xFCa"],"\x0F"=>[16,"\xFCa"],"\x10"=>[94,"\xFCc"],"\x11"=>[76,"\xFCc"],"\x12"=>[104,"\xFCc"],"\x13"=>[16,"\xFCc"],"\x14"=>[94,"\xFCe"],"\x15"=>[76,"\xFCe"],"\x16"=>[104,"\xFCe"],"\x17"=>[16,"\xFCe"],"\x18"=>[94,"\xFCi"],"\x19"=>[76,"\xFCi"],"\x1A"=>[104,"\xFCi"],"\x1B"=>[16,"\xFCi"],"\x1C"=>[94,"\xFCo"],"\x1D"=>[76,"\xFCo"],"\x1E"=>[104,"\xFCo"],"\x1F"=>[16,"\xFCo"],"\x20"=>[94,"\xFCs"],"\x21"=>[76,"\xFCs"],"\x22"=>[104,"\xFCs"],"\x23"=>[16,"\xFCs"],"\x24"=>[94,"\xFCt"],"\x25"=>[76,"\xFCt"],"\x26"=>[104,"\xFCt"],"\x27"=>[16,"\xFCt"],"\x28"=>[77,"\xFC\x20"],"\x29"=>[18,"\xFC\x20"],"\x2A"=>[77,"\xFC\x25"],"\x2B"=>[18,"\xFC\x25"],"\x2C"=>[77,"\xFC-"],"-"=>[18,"\xFC-"],"."=>[77,"\xFC."],"\x2F"=>[18,"\xFC."],[77,"\xFC\x2F"],[18,"\xFC\x2F"],[77,"\xFC3"],[18,"\xFC3"],[77,"\xFC4"],[18,"\xFC4"],[77,"\xFC5"],[18,"\xFC5"],[77,"\xFC6"],[18,"\xFC6"],"\x3A"=>[77,"\xFC7"],"\x3B"=>[18,"\xFC7"],"\x3C"=>[77,"\xFC8"],"\x3D"=>[18,"\xFC8"],"\x3E"=>[77,"\xFC9"],"\x3F"=>[18,"\xFC9"],"\x40"=>[77,"\xFC\x3D"],"A"=>[18,"\xFC\x3D"],"B"=>[77,"\xFCA"],"C"=>[18,"\xFCA"],"D"=>[77,"\xFC_"],"E"=>[18,"\xFC_"],"F"=>[77,"\xFCb"],"G"=>[18,"\xFCb"],"H"=>[77,"\xFCd"],"I"=>[18,"\xFCd"],"J"=>[77,"\xFCf"],"K"=>[18,"\xFCf"],"L"=>[77,"\xFCg"],"M"=>[18,"\xFCg"],"N"=>[77,"\xFCh"],"O"=>[18,"\xFCh"],"P"=>[77,"\xFCl"],"Q"=>[18,"\xFCl"],"R"=>[77,"\xFCm"],"S"=>[18,"\xFCm"],"T"=>[77,"\xFCn"],"U"=>[18,"\xFCn"],"V"=>[77,"\xFCp"],"W"=>[18,"\xFCp"],"X"=>[77,"\xFCr"],"Y"=>[18,"\xFCr"],"Z"=>[77,"\xFCu"],"\x5B"=>[18,"\xFCu"],"\x5C"=>[0,"\xFC\x3A"],"\x5D"=>[0,"\xFCB"],"\x5E"=>[0,"\xFCC"],"_"=>[0,"\xFCD"],"\x60"=>[0,"\xFCE"],"a"=>[0,"\xFCF"],"b"=>[0,"\xFCG"],"c"=>[0,"\xFCH"],"d"=>[0,"\xFCI"],"e"=>[0,"\xFCJ"],"f"=>[0,"\xFCK"],"g"=>[0,"\xFCL"],"h"=>[0,"\xFCM"],"i"=>[0,"\xFCN"],"j"=>[0,"\xFCO"],"k"=>[0,"\xFCP"],"l"=>[0,"\xFCQ"],"m"=>[0,"\xFCR"],"n"=>[0,"\xFCS"],"o"=>[0,"\xFCT"],"p"=>[0,"\xFCU"],"q"=>[0,"\xFCV"],"r"=>[0,"\xFCW"],"s"=>[0,"\xFCY"],"t"=>[0,"\xFCj"],"u"=>[0,"\xFCk"],"v"=>[0,"\xFCq"],"w"=>[0,"\xFCv"],"x"=>[0,"\xFCw"],"y"=>[0,"\xFCx"],"z"=>[0,"\xFCy"],"\x7B"=>[0,"\xFCz"],"\x7C"=>[82,"\xFC"],"\x7D"=>[87,"\xFC"],"~"=>[130,"\xFC"],"\x7F"=>[9,"\xFC"],"\x80"=>[94,"\xFD0"],"\x81"=>[76,"\xFD0"],"\x82"=>[104,"\xFD0"],"\x83"=>[16,"\xFD0"],"\x84"=>[94,"\xFD1"],"\x85"=>[76,"\xFD1"],"\x86"=>[104,"\xFD1"],"\x87"=>[16,"\xFD1"],"\x88"=>[94,"\xFD2"],"\x89"=>[76,"\xFD2"],"\x8A"=>[104,"\xFD2"],"\x8B"=>[16,"\xFD2"],"\x8C"=>[94,"\xFDa"],"\x8D"=>[76,"\xFDa"],"\x8E"=>[104,"\xFDa"],"\x8F"=>[16,"\xFDa"],"\x90"=>[94,"\xFDc"],"\x91"=>[76,"\xFDc"],"\x92"=>[104,"\xFDc"],"\x93"=>[16,"\xFDc"],"\x94"=>[94,"\xFDe"],"\x95"=>[76,"\xFDe"],"\x96"=>[104,"\xFDe"],"\x97"=>[16,"\xFDe"],"\x98"=>[94,"\xFDi"],"\x99"=>[76,"\xFDi"],"\x9A"=>[104,"\xFDi"],"\x9B"=>[16,"\xFDi"],"\x9C"=>[94,"\xFDo"],"\x9D"=>[76,"\xFDo"],"\x9E"=>[104,"\xFDo"],"\x9F"=>[16,"\xFDo"],"\xA0"=>[94,"\xFDs"],"\xA1"=>[76,"\xFDs"],"\xA2"=>[104,"\xFDs"],"\xA3"=>[16,"\xFDs"],"\xA4"=>[94,"\xFDt"],"\xA5"=>[76,"\xFDt"],"\xA6"=>[104,"\xFDt"],"\xA7"=>[16,"\xFDt"],"\xA8"=>[77,"\xFD\x20"],"\xA9"=>[18,"\xFD\x20"],"\xAA"=>[77,"\xFD\x25"],"\xAB"=>[18,"\xFD\x25"],"\xAC"=>[77,"\xFD-"],"\xAD"=>[18,"\xFD-"],"\xAE"=>[77,"\xFD."],"\xAF"=>[18,"\xFD."],"\xB0"=>[77,"\xFD\x2F"],"\xB1"=>[18,"\xFD\x2F"],"\xB2"=>[77,"\xFD3"],"\xB3"=>[18,"\xFD3"],"\xB4"=>[77,"\xFD4"],"\xB5"=>[18,"\xFD4"],"\xB6"=>[77,"\xFD5"],"\xB7"=>[18,"\xFD5"],"\xB8"=>[77,"\xFD6"],"\xB9"=>[18,"\xFD6"],"\xBA"=>[77,"\xFD7"],"\xBB"=>[18,"\xFD7"],"\xBC"=>[77,"\xFD8"],"\xBD"=>[18,"\xFD8"],"\xBE"=>[77,"\xFD9"],"\xBF"=>[18,"\xFD9"],"\xC0"=>[77,"\xFD\x3D"],"\xC1"=>[18,"\xFD\x3D"],"\xC2"=>[77,"\xFDA"],"\xC3"=>[18,"\xFDA"],"\xC4"=>[77,"\xFD_"],"\xC5"=>[18,"\xFD_"],"\xC6"=>[77,"\xFDb"],"\xC7"=>[18,"\xFDb"],"\xC8"=>[77,"\xFDd"],"\xC9"=>[18,"\xFDd"],"\xCA"=>[77,"\xFDf"],"\xCB"=>[18,"\xFDf"],"\xCC"=>[77,"\xFDg"],"\xCD"=>[18,"\xFDg"],"\xCE"=>[77,"\xFDh"],"\xCF"=>[18,"\xFDh"],"\xD0"=>[77,"\xFDl"],"\xD1"=>[18,"\xFDl"],"\xD2"=>[77,"\xFDm"],"\xD3"=>[18,"\xFDm"],"\xD4"=>[77,"\xFDn"],"\xD5"=>[18,"\xFDn"],"\xD6"=>[77,"\xFDp"],"\xD7"=>[18,"\xFDp"],"\xD8"=>[77,"\xFDr"],"\xD9"=>[18,"\xFDr"],"\xDA"=>[77,"\xFDu"],"\xDB"=>[18,"\xFDu"],"\xDC"=>[0,"\xFD\x3A"],"\xDD"=>[0,"\xFDB"],"\xDE"=>[0,"\xFDC"],"\xDF"=>[0,"\xFDD"],"\xE0"=>[0,"\xFDE"],"\xE1"=>[0,"\xFDF"],"\xE2"=>[0,"\xFDG"],"\xE3"=>[0,"\xFDH"],"\xE4"=>[0,"\xFDI"],"\xE5"=>[0,"\xFDJ"],"\xE6"=>[0,"\xFDK"],"\xE7"=>[0,"\xFDL"],"\xE8"=>[0,"\xFDM"],"\xE9"=>[0,"\xFDN"],"\xEA"=>[0,"\xFDO"],"\xEB"=>[0,"\xFDP"],"\xEC"=>[0,"\xFDQ"],"\xED"=>[0,"\xFDR"],"\xEE"=>[0,"\xFDS"],"\xEF"=>[0,"\xFDT"],"\xF0"=>[0,"\xFDU"],"\xF1"=>[0,"\xFDV"],"\xF2"=>[0,"\xFDW"],"\xF3"=>[0,"\xFDY"],"\xF4"=>[0,"\xFDj"],"\xF5"=>[0,"\xFDk"],"\xF6"=>[0,"\xFDq"],"\xF7"=>[0,"\xFDv"],"\xF8"=>[0,"\xFDw"],"\xF9"=>[0,"\xFDx"],"\xFA"=>[0,"\xFDy"],"\xFB"=>[0,"\xFDz"],"\xFC"=>[82,"\xFD"],"\xFD"=>[87,"\xFD"],"\xFE"=>[130,"\xFD"],"\xFF"=>[9,"\xFD"],],]; #define FFI_SCOPE "amphp-hpack-nghttp2" #define FFI_LIB "libnghttp2.so" typedef struct nghttp2_hd_deflater nghttp2_hd_deflater; typedef struct nghttp2_hd_inflater nghttp2_hd_inflater; typedef struct { uint8_t *name; uint8_t *value; size_t namelen; size_t valuelen; uint8_t flags; } nghttp2_nv; int nghttp2_hd_deflate_new(nghttp2_hd_deflater **deflater_ptr, size_t deflate_hd_table_bufsize_max); ssize_t nghttp2_hd_deflate_hd(nghttp2_hd_deflater *deflater, uint8_t *buf, size_t buflen, const nghttp2_nv *nva, size_t nvlen); size_t nghttp2_hd_deflate_bound(nghttp2_hd_deflater *deflater, const nghttp2_nv *nva, size_t nvlen); int nghttp2_hd_inflate_new(nghttp2_hd_inflater **inflater_ptr); ssize_t nghttp2_hd_inflate_hd2(nghttp2_hd_inflater *inflater, nghttp2_nv *nv_out, int *inflate_flags, const uint8_t *in, size_t inlen, int in_final); int nghttp2_hd_inflate_end_headers(nghttp2_hd_inflater *inflater); $name) { if (isset(self::$indexMap[$name])) { continue; } self::$indexMap[$name] = $index + 1; } } // (micro-)optimized decode private static function huffmanLookupInit(): array { if (('cli' !== \PHP_SAPI && 'phpdbg' !== \PHP_SAPI) || \filter_var(\ini_get('opcache.enable_cli'), \FILTER_VALIDATE_BOOLEAN)) { return require __DIR__ . '/huffman-lookup.php'; } \gc_disable(); $encodingAccess = []; $terminals = []; $index = 7; foreach (self::HUFFMAN_CODE as $chr => $bits) { $len = self::HUFFMAN_CODE_LENGTHS[$chr]; for ($bit = 0; $bit < 8; $bit++) { $offlen = $len + $bit; $next = $bit; for ($byte = ($offlen - 1) >> 3; $byte > 0; $byte--) { $cur = \str_pad(\decbin(($bits >> ($byte * 8 - ((0x30 - $offlen) & 7))) & 0xFF), 8, "0", STR_PAD_LEFT); if (($encodingAccess[$next][$cur][0] ?? 0) !== 0) { $next = $encodingAccess[$next][$cur][0]; } else { $encodingAccess[$next][$cur] = [++$index, null]; $next = $index; } } $key = \str_pad( \decbin($bits & ((1 << ((($offlen - 1) & 7) + 1)) - 1)), (($offlen - 1) & 7) + 1, "0", STR_PAD_LEFT ); $encodingAccess[$next][$key] = [null, $chr > 0xFF ? "" : \chr($chr)]; if ($offlen & 7) { $terminals[$offlen & 7][] = [$key, $next]; } else { $encodingAccess[$next][$key][0] = 0; } } } $memoize = []; for ($off = 7; $off > 0; $off--) { foreach ($terminals[$off] as [$key, $next]) { if ($encodingAccess[$next][$key][0] === null) { foreach ($encodingAccess[$off] as $chr => $cur) { $encodingAccess[$next][($memoize[$key] ?? $memoize[$key] = \str_pad($key, 8, "0", STR_PAD_RIGHT)) | $chr] = [$cur[0], $encodingAccess[$next][$key][1] != "" ? $encodingAccess[$next][$key][1] . $cur[1] : ""]; } unset($encodingAccess[$next][$key]); } } } $memoize = []; for ($off = 7; $off > 0; $off--) { foreach ($terminals[$off] as [$key, $next]) { foreach ($encodingAccess[$next] as $k => $v) { if (\strlen($k) !== 1) { $encodingAccess[$next][$memoize[$k] ?? $memoize[$k] = \chr(\bindec($k))] = $v; unset($encodingAccess[$next][$k]); } } } unset($encodingAccess[$off]); } \gc_enable(); return $encodingAccess; } /** * @param string $input * * @return string|null Returns null if decoding fails. */ public static function huffmanDecode(string $input) /* : ?string */ { $huffmanLookup = self::$huffmanLookup; $lookup = 0; $lengths = self::$huffmanLengths; $length = \strlen($input); $out = \str_repeat("\0", (int) \floor($length / 5 * 8 + 1)); // max length // Fail if EOS symbol is found. if (\strpos($input, "\x3f\xff\xff\xff") !== false) { return null; } for ($bitCount = $off = $i = 0; $i < $length; $i++) { [$lookup, $chr] = $huffmanLookup[$lookup][$input[$i]]; if ($chr === null) { continue; } if ($chr === "") { return null; } $out[$off++] = $chr[0]; $bitCount += $lengths[$chr[0]]; if (isset($chr[1])) { $out[$off++] = $chr[1]; $bitCount += $lengths[$chr[1]]; } } // Padding longer than 7-bits if ($i && $chr === null) { return null; } // Check for 0's in padding if ($bitCount & 7) { $mask = 0xff >> ($bitCount & 7); if ((\ord($input[$i - 1]) & $mask) !== $mask) { return null; } } return \substr($out, 0, $off); } private static function huffmanCodesInit(): array { if (('cli' !== \PHP_SAPI && 'phpdbg' !== \PHP_SAPI) || \filter_var(\ini_get('opcache.enable_cli'), \FILTER_VALIDATE_BOOLEAN)) { return require __DIR__ . '/huffman-codes.php'; } $lookup = []; for ($chr = 0; $chr <= 0xFF; $chr++) { $bits = self::HUFFMAN_CODE[$chr]; $length = self::HUFFMAN_CODE_LENGTHS[$chr]; for ($bit = 0; $bit < 8; $bit++) { $bytes = ($length + $bit - 1) >> 3; $codes = []; for ($byte = $bytes; $byte >= 0; $byte--) { $codes[] = \chr( $byte ? $bits >> ($length - ($bytes - $byte + 1) * 8 + $bit) : ($bits << ((0x30 - $length - $bit) & 7)) ); } $lookup[$bit][\chr($chr)] = $codes; } } return $lookup; } private static function huffmanLengthsInit(): array { $lengths = []; for ($chr = 0; $chr <= 0xFF; $chr++) { $lengths[\chr($chr)] = self::HUFFMAN_CODE_LENGTHS[$chr]; } return $lengths; } public static function huffmanEncode(string $input): string { $codes = self::$huffmanCodes; $lengths = self::$huffmanLengths; $length = \strlen($input); $out = \str_repeat("\0", $length * 5 + 1); // max length for ($bitCount = $i = 0; $i < $length; $i++) { $chr = $input[$i]; $byte = $bitCount >> 3; foreach ($codes[$bitCount & 7][$chr] as $bits) { // Note: |= can't be used with strings in PHP $out[$byte] = $out[$byte] | $bits; $byte++; } $bitCount += $lengths[$chr]; } if ($bitCount & 7) { // Note: |= can't be used with strings in PHP $out[$byte - 1] = $out[$byte - 1] | \chr(0xFF >> ($bitCount & 7)); } return $i ? \substr($out, 0, $byte) : ''; } /** @see RFC 7541 Appendix A */ const LAST_INDEX = 61; const TABLE = [ // starts at 1 [":authority", ""], [":method", "GET"], [":method", "POST"], [":path", "/"], [":path", "/index.html"], [":scheme", "http"], [":scheme", "https"], [":status", "200"], [":status", "204"], [":status", "206"], [":status", "304"], [":status", "400"], [":status", "404"], [":status", "500"], ["accept-charset", ""], ["accept-encoding", "gzip, deflate"], ["accept-language", ""], ["accept-ranges", ""], ["accept", ""], ["access-control-allow-origin", ""], ["age", ""], ["allow", ""], ["authorization", ""], ["cache-control", ""], ["content-disposition", ""], ["content-encoding", ""], ["content-language", ""], ["content-length", ""], ["content-location", ""], ["content-range", ""], ["content-type", ""], ["cookie", ""], ["date", ""], ["etag", ""], ["expect", ""], ["expires", ""], ["from", ""], ["host", ""], ["if-match", ""], ["if-modified-since", ""], ["if-none-match", ""], ["if-range", ""], ["if-unmodified-since", ""], ["last-modified", ""], ["link", ""], ["location", ""], ["max-forwards", ""], ["proxy-authentication", ""], ["proxy-authorization", ""], ["range", ""], ["referer", ""], ["refresh", ""], ["retry-after", ""], ["server", ""], ["set-cookie", ""], ["strict-transport-security", ""], ["transfer-encoding", ""], ["user-agent", ""], ["vary", ""], ["via", ""], ["www-authenticate", ""] ]; private static function decodeDynamicInteger(string $input, int &$off): int { if (!isset($input[$off])) { throw new HPackException('Invalid input data, too short for dynamic integer'); } $c = \ord($input[$off++]); $int = $c & 0x7f; $i = 0; while ($c & 0x80) { if (!isset($input[$off])) { return -0x80; } $c = \ord($input[$off++]); $int += ($c & 0x7f) << (++$i * 7); } return $int; } /** * @param int $maxSize Upper limit on table size. */ public function __construct(int $maxSize = self::DEFAULT_MAX_SIZE) { $this->hardMaxSize = $maxSize; } /** * Sets the upper limit on table size. Dynamic table updates requesting a size above this size will result in a * decoding error (i.e., returning null from decode()). * * @param int $maxSize */ public function setTableSizeLimit(int $maxSize) /* : void */ { $this->hardMaxSize = $maxSize; } /** * Resizes the table to the given size, removing old entries as per section 4.4 if necessary. * * @param int|null $size */ public function resizeTable(int $size = null) /* : void */ { if ($size !== null) { $this->currentMaxSize = \max(0, \min($size, $this->hardMaxSize)); } while ($this->size > $this->currentMaxSize) { [$name, $value] = \array_pop($this->headers); $this->size -= 32 + \strlen($name) + \strlen($value); } } /** * @param string $input Encoded headers. * @param int $maxSize Maximum length of the decoded header string. * * @return string[][]|null Returns null if decoding fails or if $maxSize is exceeded. */ public function decode(string $input, int $maxSize) /* : ?array */ { $headers = []; $off = 0; $inputLength = \strlen($input); $size = 0; try { // dynamic $table as per 2.3.2 while ($off < $inputLength) { $index = \ord($input[$off++]); if ($index & 0x80) { // range check if ($index <= self::LAST_INDEX + 0x80) { if ($index === 0x80) { return null; } [$name, $value] = $headers[] = self::TABLE[$index - 0x81]; } else { if ($index == 0xff) { $index = self::decodeDynamicInteger($input, $off) + 0xff; } $index -= 0x81 + self::LAST_INDEX; if (!isset($this->headers[$index])) { return null; } [$name, $value] = $headers[] = $this->headers[$index]; } } elseif (($index & 0x60) !== 0x20) { // (($index & 0x40) || !($index & 0x20)): bit 4: never index is ignored $dynamic = (bool) ($index & 0x40); if ($index & ($dynamic ? 0x3f : 0x0f)) { // separate length if ($dynamic) { if ($index === 0x7f) { $index = self::decodeDynamicInteger($input, $off) + 0x3f; } else { $index &= 0x3f; } } else { $index &= 0x0f; if ($index === 0x0f) { $index = self::decodeDynamicInteger($input, $off) + 0x0f; } } if ($index < 0) { return null; } if ($index <= self::LAST_INDEX) { $header = self::TABLE[$index - 1]; } elseif (!isset($this->headers[$index - 1 - self::LAST_INDEX])) { return null; } else { $header = $this->headers[$index - 1 - self::LAST_INDEX]; } } else { if ($off >= $inputLength) { return null; } $length = \ord($input[$off++]); $huffman = $length & 0x80; $length &= 0x7f; if ($length === 0x7f) { $length = self::decodeDynamicInteger($input, $off) + 0x7f; } if ($inputLength - $off < $length || $length <= 0) { return null; } if ($huffman) { $header = [self::huffmanDecode(\substr($input, $off, $length))]; if ($header[0] === null) { return null; } } else { $header = [\substr($input, $off, $length)]; } $off += $length; } if ($off >= $inputLength) { return null; } $length = \ord($input[$off++]); $huffman = $length & 0x80; $length &= 0x7f; if ($length === 0x7f) { $length = self::decodeDynamicInteger($input, $off) + 0x7f; } if ($inputLength - $off < $length || $length < 0) { return null; } if ($huffman) { $header[1] = self::huffmanDecode(\substr($input, $off, $length)); if ($header[1] === null) { return null; } } else { $header[1] = \substr($input, $off, $length); } $off += $length; if ($dynamic) { \array_unshift($this->headers, $header); $this->size += 32 + \strlen($header[0]) + \strlen($header[1]); if ($this->currentMaxSize < $this->size) { $this->resizeTable(); } } [$name, $value] = $headers[] = $header; } else { // if ($index & 0x20) { if ($off >= $inputLength) { return null; // Dynamic table size update must not be the last entry in header block. } $index &= 0x1f; if ($index === 0x1f) { $index = self::decodeDynamicInteger($input, $off) + 0x1f; } if ($index > $this->hardMaxSize) { return null; } $this->resizeTable($index); continue; } $size += \strlen($name) + \strlen($value); if ($size > $maxSize) { return null; } } } catch (HPackException $e) { return null; } return $headers; } private static function encodeDynamicInteger(int $int): string { $out = ""; for ($i = 0; ($int >> $i) > 0x80; $i += 7) { $out .= \chr(0x80 | (($int >> $i) & 0x7f)); } return $out . \chr($int >> $i); } /** * @param string[][] $headers * @param int $compressionThreshold Compress strings whose length is at least the number of bytes given. * * @return string */ public function encode(array $headers, int $compressionThreshold = self::DEFAULT_COMPRESSION_THRESHOLD): string { // @TODO implementation is deliberately primitive... [doesn't use any dynamic table...] $output = ""; foreach ($headers as [$name, $value]) { if (isset(self::$indexMap[$name])) { $index = self::$indexMap[$name]; if ($index < 0x10) { $output .= \chr($index); } else { $output .= "\x0f" . \chr($index - 0x0f); } } else { $output .= "\0" . $this->encodeString($name, $compressionThreshold); } $output .= $this->encodeString($value, $compressionThreshold); } return $output; } private function encodeString(string $value, int $compressionThreshold): string { $prefix = "\0"; if (\strlen($value) >= $compressionThreshold) { $value = self::huffmanEncode($value); $prefix = "\x80"; } if (\strlen($value) < 0x7f) { return ($prefix | \chr(\strlen($value))) . $value; } return ($prefix | "\x7f") . self::encodeDynamicInteger(\strlen($value) - 0x7f) . $value; } } (function () { static::init(); })->bindTo(null, HPackNative::class)(); self::FLAG_NO_COPY_SENSITIVE, 'cookie' => self::FLAG_NO_COPY_SENSITIVE, 'proxy-authorization' => self::FLAG_NO_COPY_SENSITIVE, 'set-cookie' => self::FLAG_NO_COPY_SENSITIVE, ]; private static $ffi; private static $deflatePtrType; private static $inflatePtrType; private static $nvType; private static $nvSize; private static $charType; private static $uint8Type; private static $uint8PtrType; private static $decodeNv; private static $decodeNvPtr; private static $decodeFlags; private static $decodeFlagsPtr; private static $supported; public static function isSupported(): bool { if (isset(self::$supported)) { return self::$supported; } if (!\extension_loaded('ffi')) { return self::$supported = false; } if (!\class_exists(FFI::class)) { return self::$supported = false; } try { self::init(); return self::$supported = true; } catch (\Throwable $e) { return self::$supported = false; } } private static function init(): void { if (self::$ffi !== null) { return; } $header = \file_get_contents(__DIR__ . '/amp-hpack.h'); try { self::$ffi = FFI::cdef($header, 'libnghttp2.so'); } catch (\Throwable $exception) { self::$ffi = FFI::cdef($header, 'libnghttp2.dylib'); } self::$deflatePtrType = self::$ffi->type('nghttp2_hd_deflater*'); self::$inflatePtrType = self::$ffi->type('nghttp2_hd_inflater*'); self::$nvType = self::$ffi->type('nghttp2_nv'); self::$nvSize = FFI::sizeof(self::$nvType); self::$charType = self::$ffi->type('char'); self::$uint8Type = self::$ffi->type('uint8_t'); self::$uint8PtrType = self::$ffi->type('uint8_t*'); self::$decodeNv = self::$ffi->new(self::$nvType); self::$decodeNvPtr = FFI::addr(self::$decodeNv); self::$decodeFlags = self::$ffi->new('int'); self::$decodeFlagsPtr = FFI::addr(self::$decodeFlags); } private static function createBufferFromString(string $value) { $length = \strlen($value); $buffer = FFI::new(FFI::arrayType(self::$uint8Type, [$length])); FFI::memcpy($buffer, $value, $length); return $buffer; } private $deflatePtr; private $inflatePtr; /** * @param int $maxSize Upper limit on table size. */ public function __construct(int $maxSize = 4096) { self::init(); $this->deflatePtr = self::$ffi->new(self::$deflatePtrType); $this->inflatePtr = self::$ffi->new(self::$inflatePtrType); $return = self::$ffi->nghttp2_hd_deflate_new(FFI::addr($this->deflatePtr), $maxSize); if ($return !== 0) { throw new \RuntimeException('Failed to init deflate context'); } $return = self::$ffi->nghttp2_hd_inflate_new(FFI::addr($this->inflatePtr)); if ($return !== 0) { throw new \RuntimeException('Failed to init inflate context'); } } /** * @param string $input Encoded headers. * @param int $maxSize Maximum length of the decoded header string. * * @return string[][]|null Returns null if decoding fails or if $maxSize is exceeded. */ public function decode(string $input, int $maxSize): ?array { $ffi = self::$ffi; $pair = self::$decodeNv; $pairPtr = self::$decodeNvPtr; $flags = self::$decodeFlags; $flagsPtr = self::$decodeFlagsPtr; $inflate = $this->inflatePtr; $size = 0; $bufferLength = \strlen($input); $buffer = self::createBufferFromString($input); $offset = 0; $bufferPtr = FFI::cast(self::$uint8PtrType, $buffer); $headers = []; while (true) { $read = $ffi->nghttp2_hd_inflate_hd2($inflate, $pairPtr, $flagsPtr, $bufferPtr, $bufferLength - $offset, 1); if ($read < 0) { return null; } $offset += $read; $bufferPtr += $read; $cFlags = $flags->cdata; if ($cFlags & 0x02) { // NGHTTP2_HD_INFLATE_EMIT $nameLength = $pair->namelen; $valueLength = $pair->valuelen; $headers[] = [ FFI::string($pair->name, $nameLength), FFI::string($pair->value, $valueLength), ]; $size += $nameLength + $valueLength; if ($size > $maxSize) { return null; } } if ($cFlags & 0x01) { // NGHTTP2_HD_INFLATE_FINAL $ffi->nghttp2_hd_inflate_end_headers($inflate); FFI::memset($pair, 0, self::$nvSize); return $headers; } if ($read === 0 || $offset > $bufferLength) { return null; } } return null; } /** * @param string[][] $headers * * @return string Encoded headers. */ public function encode(array $headers): string { $ffi = self::$ffi; // To keep memory buffers $buffers = []; $headerCount = \count($headers); $current = 0; $pairs = $ffi->new(FFI::arrayType(self::$nvType, [$headerCount])); foreach ($headers as $index => [$name, $value]) { \assert($index === $current); $pair = $pairs[$current]; $nameBuffer = self::createBufferFromString($name); $valueBuffer = self::createBufferFromString($value); $pair->name = FFI::cast(self::$uint8PtrType, $nameBuffer); $pair->namelen = \strlen($name); $pair->value = FFI::cast(self::$uint8PtrType, $valueBuffer); $pair->valuelen = \strlen($value); $pair->flags = self::SENSITIVE_HEADERS[$name] ?? self::FLAG_NO_COPY; $buffers[] = $nameBuffer; $buffers[] = $valueBuffer; $current++; } $bufferLength = $ffi->nghttp2_hd_deflate_bound($this->deflatePtr, $pairs, $headerCount); $buffer = FFI::new(FFI::arrayType(self::$uint8Type, [$bufferLength])); $bufferLength = $ffi->nghttp2_hd_deflate_hd($this->deflatePtr, $buffer, $bufferLength, $pairs, $headerCount); if ($bufferLength < 0) { throw new HPackException('Failed to compress headers using nghttp2'); } return FFI::string($buffer, $bufferLength); } } ["\xFF","\xC0"],"\x01"=>["\xFF","\xFF","\xB0"],"\x02"=>["\xFF","\xFF","\xFE","\x20"],"\x03"=>["\xFF","\xFF","\xFE","0"],"\x04"=>["\xFF","\xFF","\xFE","\x40"],"\x05"=>["\xFF","\xFF","\xFE","P"],"\x06"=>["\xFF","\xFF","\xFE","\x60"],"\x07"=>["\xFF","\xFF","\xFE","p"],"\x08"=>["\xFF","\xFF","\xFE","\x80"],"\x09"=>["\xFF","\xFF","\xEA"],"\x0A"=>["\xFF","\xFF","\xFF","\xF0"],"\x0B"=>["\xFF","\xFF","\xFE","\x90"],"\x0C"=>["\xFF","\xFF","\xFE","\xA0"],"\x0D"=>["\xFF","\xFF","\xFF","\xF4"],"\x0E"=>["\xFF","\xFF","\xFE","\xB0"],"\x0F"=>["\xFF","\xFF","\xFE","\xC0"],"\x10"=>["\xFF","\xFF","\xFE","\xD0"],"\x11"=>["\xFF","\xFF","\xFE","\xE0"],"\x12"=>["\xFF","\xFF","\xFE","\xF0"],"\x13"=>["\xFF","\xFF","\xFF","\x00"],"\x14"=>["\xFF","\xFF","\xFF","\x10"],"\x15"=>["\xFF","\xFF","\xFF","\x20"],"\x16"=>["\xFF","\xFF","\xFF","\xF8"],"\x17"=>["\xFF","\xFF","\xFF","0"],"\x18"=>["\xFF","\xFF","\xFF","\x40"],"\x19"=>["\xFF","\xFF","\xFF","P"],"\x1A"=>["\xFF","\xFF","\xFF","\x60"],"\x1B"=>["\xFF","\xFF","\xFF","p"],"\x1C"=>["\xFF","\xFF","\xFF","\x80"],"\x1D"=>["\xFF","\xFF","\xFF","\x90"],"\x1E"=>["\xFF","\xFF","\xFF","\xA0"],"\x1F"=>["\xFF","\xFF","\xFF","\xB0"],"\x20"=>["P"],"\x21"=>["\xFE","\x00"],"\x22"=>["\xFE","\x40"],"\x23"=>["\xFF","\xA0"],"\x24"=>["\xFF","\xC8"],"\x25"=>["T"],"\x26"=>["\xF8"],"\x27"=>["\xFF","\x40"],"\x28"=>["\xFE","\x80"],"\x29"=>["\xFE","\xC0"],"\x2A"=>["\xF9"],"\x2B"=>["\xFF","\x60"],"\x2C"=>["\xFA"],"-"=>["X"],"."=>["\x5C"],"\x2F"=>["\x60"],["\x00"],["\x08"],["\x10"],["d"],["h"],["l"],["p"],["t"],["x"],["\x7C"],"\x3A"=>["\xB8"],"\x3B"=>["\xFB"],"\x3C"=>["\xFF","\xF8"],"\x3D"=>["\x80"],"\x3E"=>["\xFF","\xB0"],"\x3F"=>["\xFF","\x00"],"\x40"=>["\xFF","\xD0"],"A"=>["\x84"],"B"=>["\xBA"],"C"=>["\xBC"],"D"=>["\xBE"],"E"=>["\xC0"],"F"=>["\xC2"],"G"=>["\xC4"],"H"=>["\xC6"],"I"=>["\xC8"],"J"=>["\xCA"],"K"=>["\xCC"],"L"=>["\xCE"],"M"=>["\xD0"],"N"=>["\xD2"],"O"=>["\xD4"],"P"=>["\xD6"],"Q"=>["\xD8"],"R"=>["\xDA"],"S"=>["\xDC"],"T"=>["\xDE"],"U"=>["\xE0"],"V"=>["\xE2"],"W"=>["\xE4"],"X"=>["\xFC"],"Y"=>["\xE6"],"Z"=>["\xFD"],"\x5B"=>["\xFF","\xD8"],"\x5C"=>["\xFF","\xFE","\x00"],"\x5D"=>["\xFF","\xE0"],"\x5E"=>["\xFF","\xF0"],"_"=>["\x88"],"\x60"=>["\xFF","\xFA"],"a"=>["\x18"],"b"=>["\x8C"],"c"=>["\x20"],"d"=>["\x90"],"e"=>["\x28"],"f"=>["\x94"],"g"=>["\x98"],"h"=>["\x9C"],"i"=>["0"],"j"=>["\xE8"],"k"=>["\xEA"],"l"=>["\xA0"],"m"=>["\xA4"],"n"=>["\xA8"],"o"=>["8"],"p"=>["\xAC"],"q"=>["\xEC"],"r"=>["\xB0"],"s"=>["\x40"],"t"=>["H"],"u"=>["\xB4"],"v"=>["\xEE"],"w"=>["\xF0"],"x"=>["\xF2"],"y"=>["\xF4"],"z"=>["\xF6"],"\x7B"=>["\xFF","\xFC"],"\x7C"=>["\xFF","\x80"],"\x7D"=>["\xFF","\xF4"],"~"=>["\xFF","\xE8"],"\x7F"=>["\xFF","\xFF","\xFF","\xC0"],"\x80"=>["\xFF","\xFE","\x60"],"\x81"=>["\xFF","\xFF","H"],"\x82"=>["\xFF","\xFE","p"],"\x83"=>["\xFF","\xFE","\x80"],"\x84"=>["\xFF","\xFF","L"],"\x85"=>["\xFF","\xFF","P"],"\x86"=>["\xFF","\xFF","T"],"\x87"=>["\xFF","\xFF","\xB2"],"\x88"=>["\xFF","\xFF","X"],"\x89"=>["\xFF","\xFF","\xB4"],"\x8A"=>["\xFF","\xFF","\xB6"],"\x8B"=>["\xFF","\xFF","\xB8"],"\x8C"=>["\xFF","\xFF","\xBA"],"\x8D"=>["\xFF","\xFF","\xBC"],"\x8E"=>["\xFF","\xFF","\xEB"],"\x8F"=>["\xFF","\xFF","\xBE"],"\x90"=>["\xFF","\xFF","\xEC"],"\x91"=>["\xFF","\xFF","\xED"],"\x92"=>["\xFF","\xFF","\x5C"],"\x93"=>["\xFF","\xFF","\xC0"],"\x94"=>["\xFF","\xFF","\xEE"],"\x95"=>["\xFF","\xFF","\xC2"],"\x96"=>["\xFF","\xFF","\xC4"],"\x97"=>["\xFF","\xFF","\xC6"],"\x98"=>["\xFF","\xFF","\xC8"],"\x99"=>["\xFF","\xFE","\xE0"],"\x9A"=>["\xFF","\xFF","\x60"],"\x9B"=>["\xFF","\xFF","\xCA"],"\x9C"=>["\xFF","\xFF","d"],"\x9D"=>["\xFF","\xFF","\xCC"],"\x9E"=>["\xFF","\xFF","\xCE"],"\x9F"=>["\xFF","\xFF","\xEF"],"\xA0"=>["\xFF","\xFF","h"],"\xA1"=>["\xFF","\xFE","\xE8"],"\xA2"=>["\xFF","\xFE","\x90"],"\xA3"=>["\xFF","\xFF","l"],"\xA4"=>["\xFF","\xFF","p"],"\xA5"=>["\xFF","\xFF","\xD0"],"\xA6"=>["\xFF","\xFF","\xD2"],"\xA7"=>["\xFF","\xFE","\xF0"],"\xA8"=>["\xFF","\xFF","\xD4"],"\xA9"=>["\xFF","\xFF","t"],"\xAA"=>["\xFF","\xFF","x"],"\xAB"=>["\xFF","\xFF","\xF0"],"\xAC"=>["\xFF","\xFE","\xF8"],"\xAD"=>["\xFF","\xFF","\x7C"],"\xAE"=>["\xFF","\xFF","\xD6"],"\xAF"=>["\xFF","\xFF","\xD8"],"\xB0"=>["\xFF","\xFF","\x00"],"\xB1"=>["\xFF","\xFF","\x08"],"\xB2"=>["\xFF","\xFF","\x80"],"\xB3"=>["\xFF","\xFF","\x10"],"\xB4"=>["\xFF","\xFF","\xDA"],"\xB5"=>["\xFF","\xFF","\x84"],"\xB6"=>["\xFF","\xFF","\xDC"],"\xB7"=>["\xFF","\xFF","\xDE"],"\xB8"=>["\xFF","\xFE","\xA0"],"\xB9"=>["\xFF","\xFF","\x88"],"\xBA"=>["\xFF","\xFF","\x8C"],"\xBB"=>["\xFF","\xFF","\x90"],"\xBC"=>["\xFF","\xFF","\xE0"],"\xBD"=>["\xFF","\xFF","\x94"],"\xBE"=>["\xFF","\xFF","\x98"],"\xBF"=>["\xFF","\xFF","\xE2"],"\xC0"=>["\xFF","\xFF","\xF8","\x00"],"\xC1"=>["\xFF","\xFF","\xF8","\x40"],"\xC2"=>["\xFF","\xFE","\xB0"],"\xC3"=>["\xFF","\xFE","\x20"],"\xC4"=>["\xFF","\xFF","\x9C"],"\xC5"=>["\xFF","\xFF","\xE4"],"\xC6"=>["\xFF","\xFF","\xA0"],"\xC7"=>["\xFF","\xFF","\xF6","\x00"],"\xC8"=>["\xFF","\xFF","\xF8","\x80"],"\xC9"=>["\xFF","\xFF","\xF8","\xC0"],"\xCA"=>["\xFF","\xFF","\xF9","\x00"],"\xCB"=>["\xFF","\xFF","\xFB","\xC0"],"\xCC"=>["\xFF","\xFF","\xFB","\xE0"],"\xCD"=>["\xFF","\xFF","\xF9","\x40"],"\xCE"=>["\xFF","\xFF","\xF1"],"\xCF"=>["\xFF","\xFF","\xF6","\x80"],"\xD0"=>["\xFF","\xFE","\x40"],"\xD1"=>["\xFF","\xFF","\x18"],"\xD2"=>["\xFF","\xFF","\xF9","\x80"],"\xD3"=>["\xFF","\xFF","\xFC","\x00"],"\xD4"=>["\xFF","\xFF","\xFC","\x20"],"\xD5"=>["\xFF","\xFF","\xF9","\xC0"],"\xD6"=>["\xFF","\xFF","\xFC","\x40"],"\xD7"=>["\xFF","\xFF","\xF2"],"\xD8"=>["\xFF","\xFF","\x20"],"\xD9"=>["\xFF","\xFF","\x28"],"\xDA"=>["\xFF","\xFF","\xFA","\x00"],"\xDB"=>["\xFF","\xFF","\xFA","\x40"],"\xDC"=>["\xFF","\xFF","\xFF","\xD0"],"\xDD"=>["\xFF","\xFF","\xFC","\x60"],"\xDE"=>["\xFF","\xFF","\xFC","\x80"],"\xDF"=>["\xFF","\xFF","\xFC","\xA0"],"\xE0"=>["\xFF","\xFE","\xC0"],"\xE1"=>["\xFF","\xFF","\xF3"],"\xE2"=>["\xFF","\xFE","\xD0"],"\xE3"=>["\xFF","\xFF","0"],"\xE4"=>["\xFF","\xFF","\xA4"],"\xE5"=>["\xFF","\xFF","8"],"\xE6"=>["\xFF","\xFF","\x40"],"\xE7"=>["\xFF","\xFF","\xE6"],"\xE8"=>["\xFF","\xFF","\xA8"],"\xE9"=>["\xFF","\xFF","\xAC"],"\xEA"=>["\xFF","\xFF","\xF7","\x00"],"\xEB"=>["\xFF","\xFF","\xF7","\x80"],"\xEC"=>["\xFF","\xFF","\xF4"],"\xED"=>["\xFF","\xFF","\xF5"],"\xEE"=>["\xFF","\xFF","\xFA","\x80"],"\xEF"=>["\xFF","\xFF","\xE8"],"\xF0"=>["\xFF","\xFF","\xFA","\xC0"],"\xF1"=>["\xFF","\xFF","\xFC","\xC0"],"\xF2"=>["\xFF","\xFF","\xFB","\x00"],"\xF3"=>["\xFF","\xFF","\xFB","\x40"],"\xF4"=>["\xFF","\xFF","\xFC","\xE0"],"\xF5"=>["\xFF","\xFF","\xFD","\x00"],"\xF6"=>["\xFF","\xFF","\xFD","\x20"],"\xF7"=>["\xFF","\xFF","\xFD","\x40"],"\xF8"=>["\xFF","\xFF","\xFD","\x60"],"\xF9"=>["\xFF","\xFF","\xFF","\xE0"],"\xFA"=>["\xFF","\xFF","\xFD","\x80"],"\xFB"=>["\xFF","\xFF","\xFD","\xA0"],"\xFC"=>["\xFF","\xFF","\xFD","\xC0"],"\xFD"=>["\xFF","\xFF","\xFD","\xE0"],"\xFE"=>["\xFF","\xFF","\xFE","\x00"],"\xFF"=>["\xFF","\xFF","\xFB","\x80"],],["\x00"=>["\x7F","\xE0"],"\x01"=>["\x7F","\xFF","\xD8"],"\x02"=>["\x7F","\xFF","\xFF","\x10"],"\x03"=>["\x7F","\xFF","\xFF","\x18"],"\x04"=>["\x7F","\xFF","\xFF","\x20"],"\x05"=>["\x7F","\xFF","\xFF","\x28"],"\x06"=>["\x7F","\xFF","\xFF","0"],"\x07"=>["\x7F","\xFF","\xFF","8"],"\x08"=>["\x7F","\xFF","\xFF","\x40"],"\x09"=>["\x7F","\xFF","\xF5","\x00"],"\x0A"=>["\x7F","\xFF","\xFF","\xF8"],"\x0B"=>["\x7F","\xFF","\xFF","H"],"\x0C"=>["\x7F","\xFF","\xFF","P"],"\x0D"=>["\x7F","\xFF","\xFF","\xFA"],"\x0E"=>["\x7F","\xFF","\xFF","X"],"\x0F"=>["\x7F","\xFF","\xFF","\x60"],"\x10"=>["\x7F","\xFF","\xFF","h"],"\x11"=>["\x7F","\xFF","\xFF","p"],"\x12"=>["\x7F","\xFF","\xFF","x"],"\x13"=>["\x7F","\xFF","\xFF","\x80"],"\x14"=>["\x7F","\xFF","\xFF","\x88"],"\x15"=>["\x7F","\xFF","\xFF","\x90"],"\x16"=>["\x7F","\xFF","\xFF","\xFC"],"\x17"=>["\x7F","\xFF","\xFF","\x98"],"\x18"=>["\x7F","\xFF","\xFF","\xA0"],"\x19"=>["\x7F","\xFF","\xFF","\xA8"],"\x1A"=>["\x7F","\xFF","\xFF","\xB0"],"\x1B"=>["\x7F","\xFF","\xFF","\xB8"],"\x1C"=>["\x7F","\xFF","\xFF","\xC0"],"\x1D"=>["\x7F","\xFF","\xFF","\xC8"],"\x1E"=>["\x7F","\xFF","\xFF","\xD0"],"\x1F"=>["\x7F","\xFF","\xFF","\xD8"],"\x20"=>["\x28"],"\x21"=>["\x7F","\x00"],"\x22"=>["\x7F","\x20"],"\x23"=>["\x7F","\xD0"],"\x24"=>["\x7F","\xE4"],"\x25"=>["\x2A"],"\x26"=>["\x7C","\x00"],"\x27"=>["\x7F","\xA0"],"\x28"=>["\x7F","\x40"],"\x29"=>["\x7F","\x60"],"\x2A"=>["\x7C","\x80"],"\x2B"=>["\x7F","\xB0"],"\x2C"=>["\x7D","\x00"],"-"=>["\x2C"],"."=>["."],"\x2F"=>["0"],["\x00"],["\x04"],["\x08"],["2"],["4"],["6"],["8"],["\x3A"],["\x3C"],["\x3E"],"\x3A"=>["\x5C"],"\x3B"=>["\x7D","\x80"],"\x3C"=>["\x7F","\xFC"],"\x3D"=>["\x40"],"\x3E"=>["\x7F","\xD8"],"\x3F"=>["\x7F","\x80"],"\x40"=>["\x7F","\xE8"],"A"=>["B"],"B"=>["\x5D"],"C"=>["\x5E"],"D"=>["_"],"E"=>["\x60"],"F"=>["a"],"G"=>["b"],"H"=>["c"],"I"=>["d"],"J"=>["e"],"K"=>["f"],"L"=>["g"],"M"=>["h"],"N"=>["i"],"O"=>["j"],"P"=>["k"],"Q"=>["l"],"R"=>["m"],"S"=>["n"],"T"=>["o"],"U"=>["p"],"V"=>["q"],"W"=>["r"],"X"=>["~","\x00"],"Y"=>["s"],"Z"=>["~","\x80"],"\x5B"=>["\x7F","\xEC"],"\x5C"=>["\x7F","\xFF","\x00"],"\x5D"=>["\x7F","\xF0"],"\x5E"=>["\x7F","\xF8"],"_"=>["D"],"\x60"=>["\x7F","\xFD"],"a"=>["\x0C"],"b"=>["F"],"c"=>["\x10"],"d"=>["H"],"e"=>["\x14"],"f"=>["J"],"g"=>["L"],"h"=>["N"],"i"=>["\x18"],"j"=>["t"],"k"=>["u"],"l"=>["P"],"m"=>["R"],"n"=>["T"],"o"=>["\x1C"],"p"=>["V"],"q"=>["v"],"r"=>["X"],"s"=>["\x20"],"t"=>["\x24"],"u"=>["Z"],"v"=>["w"],"w"=>["x"],"x"=>["y"],"y"=>["z"],"z"=>["\x7B"],"\x7B"=>["\x7F","\xFE"],"\x7C"=>["\x7F","\xC0"],"\x7D"=>["\x7F","\xFA"],"~"=>["\x7F","\xF4"],"\x7F"=>["\x7F","\xFF","\xFF","\xE0"],"\x80"=>["\x7F","\xFF","0"],"\x81"=>["\x7F","\xFF","\xA4"],"\x82"=>["\x7F","\xFF","8"],"\x83"=>["\x7F","\xFF","\x40"],"\x84"=>["\x7F","\xFF","\xA6"],"\x85"=>["\x7F","\xFF","\xA8"],"\x86"=>["\x7F","\xFF","\xAA"],"\x87"=>["\x7F","\xFF","\xD9"],"\x88"=>["\x7F","\xFF","\xAC"],"\x89"=>["\x7F","\xFF","\xDA"],"\x8A"=>["\x7F","\xFF","\xDB"],"\x8B"=>["\x7F","\xFF","\xDC"],"\x8C"=>["\x7F","\xFF","\xDD"],"\x8D"=>["\x7F","\xFF","\xDE"],"\x8E"=>["\x7F","\xFF","\xF5","\x80"],"\x8F"=>["\x7F","\xFF","\xDF"],"\x90"=>["\x7F","\xFF","\xF6","\x00"],"\x91"=>["\x7F","\xFF","\xF6","\x80"],"\x92"=>["\x7F","\xFF","\xAE"],"\x93"=>["\x7F","\xFF","\xE0"],"\x94"=>["\x7F","\xFF","\xF7","\x00"],"\x95"=>["\x7F","\xFF","\xE1"],"\x96"=>["\x7F","\xFF","\xE2"],"\x97"=>["\x7F","\xFF","\xE3"],"\x98"=>["\x7F","\xFF","\xE4"],"\x99"=>["\x7F","\xFF","p"],"\x9A"=>["\x7F","\xFF","\xB0"],"\x9B"=>["\x7F","\xFF","\xE5"],"\x9C"=>["\x7F","\xFF","\xB2"],"\x9D"=>["\x7F","\xFF","\xE6"],"\x9E"=>["\x7F","\xFF","\xE7"],"\x9F"=>["\x7F","\xFF","\xF7","\x80"],"\xA0"=>["\x7F","\xFF","\xB4"],"\xA1"=>["\x7F","\xFF","t"],"\xA2"=>["\x7F","\xFF","H"],"\xA3"=>["\x7F","\xFF","\xB6"],"\xA4"=>["\x7F","\xFF","\xB8"],"\xA5"=>["\x7F","\xFF","\xE8"],"\xA6"=>["\x7F","\xFF","\xE9"],"\xA7"=>["\x7F","\xFF","x"],"\xA8"=>["\x7F","\xFF","\xEA"],"\xA9"=>["\x7F","\xFF","\xBA"],"\xAA"=>["\x7F","\xFF","\xBC"],"\xAB"=>["\x7F","\xFF","\xF8","\x00"],"\xAC"=>["\x7F","\xFF","\x7C"],"\xAD"=>["\x7F","\xFF","\xBE"],"\xAE"=>["\x7F","\xFF","\xEB"],"\xAF"=>["\x7F","\xFF","\xEC"],"\xB0"=>["\x7F","\xFF","\x80"],"\xB1"=>["\x7F","\xFF","\x84"],"\xB2"=>["\x7F","\xFF","\xC0"],"\xB3"=>["\x7F","\xFF","\x88"],"\xB4"=>["\x7F","\xFF","\xED"],"\xB5"=>["\x7F","\xFF","\xC2"],"\xB6"=>["\x7F","\xFF","\xEE"],"\xB7"=>["\x7F","\xFF","\xEF"],"\xB8"=>["\x7F","\xFF","P"],"\xB9"=>["\x7F","\xFF","\xC4"],"\xBA"=>["\x7F","\xFF","\xC6"],"\xBB"=>["\x7F","\xFF","\xC8"],"\xBC"=>["\x7F","\xFF","\xF0"],"\xBD"=>["\x7F","\xFF","\xCA"],"\xBE"=>["\x7F","\xFF","\xCC"],"\xBF"=>["\x7F","\xFF","\xF1"],"\xC0"=>["\x7F","\xFF","\xFC","\x00"],"\xC1"=>["\x7F","\xFF","\xFC","\x20"],"\xC2"=>["\x7F","\xFF","X"],"\xC3"=>["\x7F","\xFF","\x10"],"\xC4"=>["\x7F","\xFF","\xCE"],"\xC5"=>["\x7F","\xFF","\xF2"],"\xC6"=>["\x7F","\xFF","\xD0"],"\xC7"=>["\x7F","\xFF","\xFB","\x00"],"\xC8"=>["\x7F","\xFF","\xFC","\x40"],"\xC9"=>["\x7F","\xFF","\xFC","\x60"],"\xCA"=>["\x7F","\xFF","\xFC","\x80"],"\xCB"=>["\x7F","\xFF","\xFD","\xE0"],"\xCC"=>["\x7F","\xFF","\xFD","\xF0"],"\xCD"=>["\x7F","\xFF","\xFC","\xA0"],"\xCE"=>["\x7F","\xFF","\xF8","\x80"],"\xCF"=>["\x7F","\xFF","\xFB","\x40"],"\xD0"=>["\x7F","\xFF","\x20"],"\xD1"=>["\x7F","\xFF","\x8C"],"\xD2"=>["\x7F","\xFF","\xFC","\xC0"],"\xD3"=>["\x7F","\xFF","\xFE","\x00"],"\xD4"=>["\x7F","\xFF","\xFE","\x10"],"\xD5"=>["\x7F","\xFF","\xFC","\xE0"],"\xD6"=>["\x7F","\xFF","\xFE","\x20"],"\xD7"=>["\x7F","\xFF","\xF9","\x00"],"\xD8"=>["\x7F","\xFF","\x90"],"\xD9"=>["\x7F","\xFF","\x94"],"\xDA"=>["\x7F","\xFF","\xFD","\x00"],"\xDB"=>["\x7F","\xFF","\xFD","\x20"],"\xDC"=>["\x7F","\xFF","\xFF","\xE8"],"\xDD"=>["\x7F","\xFF","\xFE","0"],"\xDE"=>["\x7F","\xFF","\xFE","\x40"],"\xDF"=>["\x7F","\xFF","\xFE","P"],"\xE0"=>["\x7F","\xFF","\x60"],"\xE1"=>["\x7F","\xFF","\xF9","\x80"],"\xE2"=>["\x7F","\xFF","h"],"\xE3"=>["\x7F","\xFF","\x98"],"\xE4"=>["\x7F","\xFF","\xD2"],"\xE5"=>["\x7F","\xFF","\x9C"],"\xE6"=>["\x7F","\xFF","\xA0"],"\xE7"=>["\x7F","\xFF","\xF3"],"\xE8"=>["\x7F","\xFF","\xD4"],"\xE9"=>["\x7F","\xFF","\xD6"],"\xEA"=>["\x7F","\xFF","\xFB","\x80"],"\xEB"=>["\x7F","\xFF","\xFB","\xC0"],"\xEC"=>["\x7F","\xFF","\xFA","\x00"],"\xED"=>["\x7F","\xFF","\xFA","\x80"],"\xEE"=>["\x7F","\xFF","\xFD","\x40"],"\xEF"=>["\x7F","\xFF","\xF4"],"\xF0"=>["\x7F","\xFF","\xFD","\x60"],"\xF1"=>["\x7F","\xFF","\xFE","\x60"],"\xF2"=>["\x7F","\xFF","\xFD","\x80"],"\xF3"=>["\x7F","\xFF","\xFD","\xA0"],"\xF4"=>["\x7F","\xFF","\xFE","p"],"\xF5"=>["\x7F","\xFF","\xFE","\x80"],"\xF6"=>["\x7F","\xFF","\xFE","\x90"],"\xF7"=>["\x7F","\xFF","\xFE","\xA0"],"\xF8"=>["\x7F","\xFF","\xFE","\xB0"],"\xF9"=>["\x7F","\xFF","\xFF","\xF0"],"\xFA"=>["\x7F","\xFF","\xFE","\xC0"],"\xFB"=>["\x7F","\xFF","\xFE","\xD0"],"\xFC"=>["\x7F","\xFF","\xFE","\xE0"],"\xFD"=>["\x7F","\xFF","\xFE","\xF0"],"\xFE"=>["\x7F","\xFF","\xFF","\x00"],"\xFF"=>["\x7F","\xFF","\xFD","\xC0"],],["\x00"=>["\x3F","\xF0"],"\x01"=>["\x3F","\xFF","\xEC","\x00"],"\x02"=>["\x3F","\xFF","\xFF","\x88"],"\x03"=>["\x3F","\xFF","\xFF","\x8C"],"\x04"=>["\x3F","\xFF","\xFF","\x90"],"\x05"=>["\x3F","\xFF","\xFF","\x94"],"\x06"=>["\x3F","\xFF","\xFF","\x98"],"\x07"=>["\x3F","\xFF","\xFF","\x9C"],"\x08"=>["\x3F","\xFF","\xFF","\xA0"],"\x09"=>["\x3F","\xFF","\xFA","\x80"],"\x0A"=>["\x3F","\xFF","\xFF","\xFC"],"\x0B"=>["\x3F","\xFF","\xFF","\xA4"],"\x0C"=>["\x3F","\xFF","\xFF","\xA8"],"\x0D"=>["\x3F","\xFF","\xFF","\xFD"],"\x0E"=>["\x3F","\xFF","\xFF","\xAC"],"\x0F"=>["\x3F","\xFF","\xFF","\xB0"],"\x10"=>["\x3F","\xFF","\xFF","\xB4"],"\x11"=>["\x3F","\xFF","\xFF","\xB8"],"\x12"=>["\x3F","\xFF","\xFF","\xBC"],"\x13"=>["\x3F","\xFF","\xFF","\xC0"],"\x14"=>["\x3F","\xFF","\xFF","\xC4"],"\x15"=>["\x3F","\xFF","\xFF","\xC8"],"\x16"=>["\x3F","\xFF","\xFF","\xFE"],"\x17"=>["\x3F","\xFF","\xFF","\xCC"],"\x18"=>["\x3F","\xFF","\xFF","\xD0"],"\x19"=>["\x3F","\xFF","\xFF","\xD4"],"\x1A"=>["\x3F","\xFF","\xFF","\xD8"],"\x1B"=>["\x3F","\xFF","\xFF","\xDC"],"\x1C"=>["\x3F","\xFF","\xFF","\xE0"],"\x1D"=>["\x3F","\xFF","\xFF","\xE4"],"\x1E"=>["\x3F","\xFF","\xFF","\xE8"],"\x1F"=>["\x3F","\xFF","\xFF","\xEC"],"\x20"=>["\x14"],"\x21"=>["\x3F","\x80"],"\x22"=>["\x3F","\x90"],"\x23"=>["\x3F","\xE8"],"\x24"=>["\x3F","\xF2"],"\x25"=>["\x15"],"\x26"=>["\x3E","\x00"],"\x27"=>["\x3F","\xD0"],"\x28"=>["\x3F","\xA0"],"\x29"=>["\x3F","\xB0"],"\x2A"=>["\x3E","\x40"],"\x2B"=>["\x3F","\xD8"],"\x2C"=>["\x3E","\x80"],"-"=>["\x16"],"."=>["\x17"],"\x2F"=>["\x18"],["\x00"],["\x02"],["\x04"],["\x19"],["\x1A"],["\x1B"],["\x1C"],["\x1D"],["\x1E"],["\x1F"],"\x3A"=>[".","\x00"],"\x3B"=>["\x3E","\xC0"],"\x3C"=>["\x3F","\xFE","\x00"],"\x3D"=>["\x20"],"\x3E"=>["\x3F","\xEC"],"\x3F"=>["\x3F","\xC0"],"\x40"=>["\x3F","\xF4"],"A"=>["\x21"],"B"=>[".","\x80"],"C"=>["\x2F","\x00"],"D"=>["\x2F","\x80"],"E"=>["0","\x00"],"F"=>["0","\x80"],"G"=>["1","\x00"],"H"=>["1","\x80"],"I"=>["2","\x00"],"J"=>["2","\x80"],"K"=>["3","\x00"],"L"=>["3","\x80"],"M"=>["4","\x00"],"N"=>["4","\x80"],"O"=>["5","\x00"],"P"=>["5","\x80"],"Q"=>["6","\x00"],"R"=>["6","\x80"],"S"=>["7","\x00"],"T"=>["7","\x80"],"U"=>["8","\x00"],"V"=>["8","\x80"],"W"=>["9","\x00"],"X"=>["\x3F","\x00"],"Y"=>["9","\x80"],"Z"=>["\x3F","\x40"],"\x5B"=>["\x3F","\xF6"],"\x5C"=>["\x3F","\xFF","\x80"],"\x5D"=>["\x3F","\xF8"],"\x5E"=>["\x3F","\xFC"],"_"=>["\x22"],"\x60"=>["\x3F","\xFE","\x80"],"a"=>["\x06"],"b"=>["\x23"],"c"=>["\x08"],"d"=>["\x24"],"e"=>["\x0A"],"f"=>["\x25"],"g"=>["\x26"],"h"=>["\x27"],"i"=>["\x0C"],"j"=>["\x3A","\x00"],"k"=>["\x3A","\x80"],"l"=>["\x28"],"m"=>["\x29"],"n"=>["\x2A"],"o"=>["\x0E"],"p"=>["\x2B"],"q"=>["\x3B","\x00"],"r"=>["\x2C"],"s"=>["\x10"],"t"=>["\x12"],"u"=>["-"],"v"=>["\x3B","\x80"],"w"=>["\x3C","\x00"],"x"=>["\x3C","\x80"],"y"=>["\x3D","\x00"],"z"=>["\x3D","\x80"],"\x7B"=>["\x3F","\xFF","\x00"],"\x7C"=>["\x3F","\xE0"],"\x7D"=>["\x3F","\xFD"],"~"=>["\x3F","\xFA"],"\x7F"=>["\x3F","\xFF","\xFF","\xF0"],"\x80"=>["\x3F","\xFF","\x98"],"\x81"=>["\x3F","\xFF","\xD2"],"\x82"=>["\x3F","\xFF","\x9C"],"\x83"=>["\x3F","\xFF","\xA0"],"\x84"=>["\x3F","\xFF","\xD3"],"\x85"=>["\x3F","\xFF","\xD4"],"\x86"=>["\x3F","\xFF","\xD5"],"\x87"=>["\x3F","\xFF","\xEC","\x80"],"\x88"=>["\x3F","\xFF","\xD6"],"\x89"=>["\x3F","\xFF","\xED","\x00"],"\x8A"=>["\x3F","\xFF","\xED","\x80"],"\x8B"=>["\x3F","\xFF","\xEE","\x00"],"\x8C"=>["\x3F","\xFF","\xEE","\x80"],"\x8D"=>["\x3F","\xFF","\xEF","\x00"],"\x8E"=>["\x3F","\xFF","\xFA","\xC0"],"\x8F"=>["\x3F","\xFF","\xEF","\x80"],"\x90"=>["\x3F","\xFF","\xFB","\x00"],"\x91"=>["\x3F","\xFF","\xFB","\x40"],"\x92"=>["\x3F","\xFF","\xD7"],"\x93"=>["\x3F","\xFF","\xF0","\x00"],"\x94"=>["\x3F","\xFF","\xFB","\x80"],"\x95"=>["\x3F","\xFF","\xF0","\x80"],"\x96"=>["\x3F","\xFF","\xF1","\x00"],"\x97"=>["\x3F","\xFF","\xF1","\x80"],"\x98"=>["\x3F","\xFF","\xF2","\x00"],"\x99"=>["\x3F","\xFF","\xB8"],"\x9A"=>["\x3F","\xFF","\xD8"],"\x9B"=>["\x3F","\xFF","\xF2","\x80"],"\x9C"=>["\x3F","\xFF","\xD9"],"\x9D"=>["\x3F","\xFF","\xF3","\x00"],"\x9E"=>["\x3F","\xFF","\xF3","\x80"],"\x9F"=>["\x3F","\xFF","\xFB","\xC0"],"\xA0"=>["\x3F","\xFF","\xDA"],"\xA1"=>["\x3F","\xFF","\xBA"],"\xA2"=>["\x3F","\xFF","\xA4"],"\xA3"=>["\x3F","\xFF","\xDB"],"\xA4"=>["\x3F","\xFF","\xDC"],"\xA5"=>["\x3F","\xFF","\xF4","\x00"],"\xA6"=>["\x3F","\xFF","\xF4","\x80"],"\xA7"=>["\x3F","\xFF","\xBC"],"\xA8"=>["\x3F","\xFF","\xF5","\x00"],"\xA9"=>["\x3F","\xFF","\xDD"],"\xAA"=>["\x3F","\xFF","\xDE"],"\xAB"=>["\x3F","\xFF","\xFC","\x00"],"\xAC"=>["\x3F","\xFF","\xBE"],"\xAD"=>["\x3F","\xFF","\xDF"],"\xAE"=>["\x3F","\xFF","\xF5","\x80"],"\xAF"=>["\x3F","\xFF","\xF6","\x00"],"\xB0"=>["\x3F","\xFF","\xC0"],"\xB1"=>["\x3F","\xFF","\xC2"],"\xB2"=>["\x3F","\xFF","\xE0"],"\xB3"=>["\x3F","\xFF","\xC4"],"\xB4"=>["\x3F","\xFF","\xF6","\x80"],"\xB5"=>["\x3F","\xFF","\xE1"],"\xB6"=>["\x3F","\xFF","\xF7","\x00"],"\xB7"=>["\x3F","\xFF","\xF7","\x80"],"\xB8"=>["\x3F","\xFF","\xA8"],"\xB9"=>["\x3F","\xFF","\xE2"],"\xBA"=>["\x3F","\xFF","\xE3"],"\xBB"=>["\x3F","\xFF","\xE4"],"\xBC"=>["\x3F","\xFF","\xF8","\x00"],"\xBD"=>["\x3F","\xFF","\xE5"],"\xBE"=>["\x3F","\xFF","\xE6"],"\xBF"=>["\x3F","\xFF","\xF8","\x80"],"\xC0"=>["\x3F","\xFF","\xFE","\x00"],"\xC1"=>["\x3F","\xFF","\xFE","\x10"],"\xC2"=>["\x3F","\xFF","\xAC"],"\xC3"=>["\x3F","\xFF","\x88"],"\xC4"=>["\x3F","\xFF","\xE7"],"\xC5"=>["\x3F","\xFF","\xF9","\x00"],"\xC6"=>["\x3F","\xFF","\xE8"],"\xC7"=>["\x3F","\xFF","\xFD","\x80"],"\xC8"=>["\x3F","\xFF","\xFE","\x20"],"\xC9"=>["\x3F","\xFF","\xFE","0"],"\xCA"=>["\x3F","\xFF","\xFE","\x40"],"\xCB"=>["\x3F","\xFF","\xFE","\xF0"],"\xCC"=>["\x3F","\xFF","\xFE","\xF8"],"\xCD"=>["\x3F","\xFF","\xFE","P"],"\xCE"=>["\x3F","\xFF","\xFC","\x40"],"\xCF"=>["\x3F","\xFF","\xFD","\xA0"],"\xD0"=>["\x3F","\xFF","\x90"],"\xD1"=>["\x3F","\xFF","\xC6"],"\xD2"=>["\x3F","\xFF","\xFE","\x60"],"\xD3"=>["\x3F","\xFF","\xFF","\x00"],"\xD4"=>["\x3F","\xFF","\xFF","\x08"],"\xD5"=>["\x3F","\xFF","\xFE","p"],"\xD6"=>["\x3F","\xFF","\xFF","\x10"],"\xD7"=>["\x3F","\xFF","\xFC","\x80"],"\xD8"=>["\x3F","\xFF","\xC8"],"\xD9"=>["\x3F","\xFF","\xCA"],"\xDA"=>["\x3F","\xFF","\xFE","\x80"],"\xDB"=>["\x3F","\xFF","\xFE","\x90"],"\xDC"=>["\x3F","\xFF","\xFF","\xF4"],"\xDD"=>["\x3F","\xFF","\xFF","\x18"],"\xDE"=>["\x3F","\xFF","\xFF","\x20"],"\xDF"=>["\x3F","\xFF","\xFF","\x28"],"\xE0"=>["\x3F","\xFF","\xB0"],"\xE1"=>["\x3F","\xFF","\xFC","\xC0"],"\xE2"=>["\x3F","\xFF","\xB4"],"\xE3"=>["\x3F","\xFF","\xCC"],"\xE4"=>["\x3F","\xFF","\xE9"],"\xE5"=>["\x3F","\xFF","\xCE"],"\xE6"=>["\x3F","\xFF","\xD0"],"\xE7"=>["\x3F","\xFF","\xF9","\x80"],"\xE8"=>["\x3F","\xFF","\xEA"],"\xE9"=>["\x3F","\xFF","\xEB"],"\xEA"=>["\x3F","\xFF","\xFD","\xC0"],"\xEB"=>["\x3F","\xFF","\xFD","\xE0"],"\xEC"=>["\x3F","\xFF","\xFD","\x00"],"\xED"=>["\x3F","\xFF","\xFD","\x40"],"\xEE"=>["\x3F","\xFF","\xFE","\xA0"],"\xEF"=>["\x3F","\xFF","\xFA","\x00"],"\xF0"=>["\x3F","\xFF","\xFE","\xB0"],"\xF1"=>["\x3F","\xFF","\xFF","0"],"\xF2"=>["\x3F","\xFF","\xFE","\xC0"],"\xF3"=>["\x3F","\xFF","\xFE","\xD0"],"\xF4"=>["\x3F","\xFF","\xFF","8"],"\xF5"=>["\x3F","\xFF","\xFF","\x40"],"\xF6"=>["\x3F","\xFF","\xFF","H"],"\xF7"=>["\x3F","\xFF","\xFF","P"],"\xF8"=>["\x3F","\xFF","\xFF","X"],"\xF9"=>["\x3F","\xFF","\xFF","\xF8"],"\xFA"=>["\x3F","\xFF","\xFF","\x60"],"\xFB"=>["\x3F","\xFF","\xFF","h"],"\xFC"=>["\x3F","\xFF","\xFF","p"],"\xFD"=>["\x3F","\xFF","\xFF","x"],"\xFE"=>["\x3F","\xFF","\xFF","\x80"],"\xFF"=>["\x3F","\xFF","\xFE","\xE0"],],["\x00"=>["\x1F","\xF8"],"\x01"=>["\x1F","\xFF","\xF6","\x00"],"\x02"=>["\x1F","\xFF","\xFF","\xC4"],"\x03"=>["\x1F","\xFF","\xFF","\xC6"],"\x04"=>["\x1F","\xFF","\xFF","\xC8"],"\x05"=>["\x1F","\xFF","\xFF","\xCA"],"\x06"=>["\x1F","\xFF","\xFF","\xCC"],"\x07"=>["\x1F","\xFF","\xFF","\xCE"],"\x08"=>["\x1F","\xFF","\xFF","\xD0"],"\x09"=>["\x1F","\xFF","\xFD","\x40"],"\x0A"=>["\x1F","\xFF","\xFF","\xFE","\x00"],"\x0B"=>["\x1F","\xFF","\xFF","\xD2"],"\x0C"=>["\x1F","\xFF","\xFF","\xD4"],"\x0D"=>["\x1F","\xFF","\xFF","\xFE","\x80"],"\x0E"=>["\x1F","\xFF","\xFF","\xD6"],"\x0F"=>["\x1F","\xFF","\xFF","\xD8"],"\x10"=>["\x1F","\xFF","\xFF","\xDA"],"\x11"=>["\x1F","\xFF","\xFF","\xDC"],"\x12"=>["\x1F","\xFF","\xFF","\xDE"],"\x13"=>["\x1F","\xFF","\xFF","\xE0"],"\x14"=>["\x1F","\xFF","\xFF","\xE2"],"\x15"=>["\x1F","\xFF","\xFF","\xE4"],"\x16"=>["\x1F","\xFF","\xFF","\xFF","\x00"],"\x17"=>["\x1F","\xFF","\xFF","\xE6"],"\x18"=>["\x1F","\xFF","\xFF","\xE8"],"\x19"=>["\x1F","\xFF","\xFF","\xEA"],"\x1A"=>["\x1F","\xFF","\xFF","\xEC"],"\x1B"=>["\x1F","\xFF","\xFF","\xEE"],"\x1C"=>["\x1F","\xFF","\xFF","\xF0"],"\x1D"=>["\x1F","\xFF","\xFF","\xF2"],"\x1E"=>["\x1F","\xFF","\xFF","\xF4"],"\x1F"=>["\x1F","\xFF","\xFF","\xF6"],"\x20"=>["\x0A","\x00"],"\x21"=>["\x1F","\xC0"],"\x22"=>["\x1F","\xC8"],"\x23"=>["\x1F","\xF4"],"\x24"=>["\x1F","\xF9"],"\x25"=>["\x0A","\x80"],"\x26"=>["\x1F","\x00"],"\x27"=>["\x1F","\xE8"],"\x28"=>["\x1F","\xD0"],"\x29"=>["\x1F","\xD8"],"\x2A"=>["\x1F","\x20"],"\x2B"=>["\x1F","\xEC"],"\x2C"=>["\x1F","\x40"],"-"=>["\x0B","\x00"],"."=>["\x0B","\x80"],"\x2F"=>["\x0C","\x00"],["\x00"],["\x01"],["\x02"],["\x0C","\x80"],["\x0D","\x00"],["\x0D","\x80"],["\x0E","\x00"],["\x0E","\x80"],["\x0F","\x00"],["\x0F","\x80"],"\x3A"=>["\x17","\x00"],"\x3B"=>["\x1F","\x60"],"\x3C"=>["\x1F","\xFF","\x00"],"\x3D"=>["\x10","\x00"],"\x3E"=>["\x1F","\xF6"],"\x3F"=>["\x1F","\xE0"],"\x40"=>["\x1F","\xFA"],"A"=>["\x10","\x80"],"B"=>["\x17","\x40"],"C"=>["\x17","\x80"],"D"=>["\x17","\xC0"],"E"=>["\x18","\x00"],"F"=>["\x18","\x40"],"G"=>["\x18","\x80"],"H"=>["\x18","\xC0"],"I"=>["\x19","\x00"],"J"=>["\x19","\x40"],"K"=>["\x19","\x80"],"L"=>["\x19","\xC0"],"M"=>["\x1A","\x00"],"N"=>["\x1A","\x40"],"O"=>["\x1A","\x80"],"P"=>["\x1A","\xC0"],"Q"=>["\x1B","\x00"],"R"=>["\x1B","\x40"],"S"=>["\x1B","\x80"],"T"=>["\x1B","\xC0"],"U"=>["\x1C","\x00"],"V"=>["\x1C","\x40"],"W"=>["\x1C","\x80"],"X"=>["\x1F","\x80"],"Y"=>["\x1C","\xC0"],"Z"=>["\x1F","\xA0"],"\x5B"=>["\x1F","\xFB"],"\x5C"=>["\x1F","\xFF","\xC0"],"\x5D"=>["\x1F","\xFC"],"\x5E"=>["\x1F","\xFE","\x00"],"_"=>["\x11","\x00"],"\x60"=>["\x1F","\xFF","\x40"],"a"=>["\x03"],"b"=>["\x11","\x80"],"c"=>["\x04"],"d"=>["\x12","\x00"],"e"=>["\x05"],"f"=>["\x12","\x80"],"g"=>["\x13","\x00"],"h"=>["\x13","\x80"],"i"=>["\x06"],"j"=>["\x1D","\x00"],"k"=>["\x1D","\x40"],"l"=>["\x14","\x00"],"m"=>["\x14","\x80"],"n"=>["\x15","\x00"],"o"=>["\x07"],"p"=>["\x15","\x80"],"q"=>["\x1D","\x80"],"r"=>["\x16","\x00"],"s"=>["\x08"],"t"=>["\x09"],"u"=>["\x16","\x80"],"v"=>["\x1D","\xC0"],"w"=>["\x1E","\x00"],"x"=>["\x1E","\x40"],"y"=>["\x1E","\x80"],"z"=>["\x1E","\xC0"],"\x7B"=>["\x1F","\xFF","\x80"],"\x7C"=>["\x1F","\xF0"],"\x7D"=>["\x1F","\xFE","\x80"],"~"=>["\x1F","\xFD"],"\x7F"=>["\x1F","\xFF","\xFF","\xF8"],"\x80"=>["\x1F","\xFF","\xCC"],"\x81"=>["\x1F","\xFF","\xE9","\x00"],"\x82"=>["\x1F","\xFF","\xCE"],"\x83"=>["\x1F","\xFF","\xD0"],"\x84"=>["\x1F","\xFF","\xE9","\x80"],"\x85"=>["\x1F","\xFF","\xEA","\x00"],"\x86"=>["\x1F","\xFF","\xEA","\x80"],"\x87"=>["\x1F","\xFF","\xF6","\x40"],"\x88"=>["\x1F","\xFF","\xEB","\x00"],"\x89"=>["\x1F","\xFF","\xF6","\x80"],"\x8A"=>["\x1F","\xFF","\xF6","\xC0"],"\x8B"=>["\x1F","\xFF","\xF7","\x00"],"\x8C"=>["\x1F","\xFF","\xF7","\x40"],"\x8D"=>["\x1F","\xFF","\xF7","\x80"],"\x8E"=>["\x1F","\xFF","\xFD","\x60"],"\x8F"=>["\x1F","\xFF","\xF7","\xC0"],"\x90"=>["\x1F","\xFF","\xFD","\x80"],"\x91"=>["\x1F","\xFF","\xFD","\xA0"],"\x92"=>["\x1F","\xFF","\xEB","\x80"],"\x93"=>["\x1F","\xFF","\xF8","\x00"],"\x94"=>["\x1F","\xFF","\xFD","\xC0"],"\x95"=>["\x1F","\xFF","\xF8","\x40"],"\x96"=>["\x1F","\xFF","\xF8","\x80"],"\x97"=>["\x1F","\xFF","\xF8","\xC0"],"\x98"=>["\x1F","\xFF","\xF9","\x00"],"\x99"=>["\x1F","\xFF","\xDC"],"\x9A"=>["\x1F","\xFF","\xEC","\x00"],"\x9B"=>["\x1F","\xFF","\xF9","\x40"],"\x9C"=>["\x1F","\xFF","\xEC","\x80"],"\x9D"=>["\x1F","\xFF","\xF9","\x80"],"\x9E"=>["\x1F","\xFF","\xF9","\xC0"],"\x9F"=>["\x1F","\xFF","\xFD","\xE0"],"\xA0"=>["\x1F","\xFF","\xED","\x00"],"\xA1"=>["\x1F","\xFF","\xDD"],"\xA2"=>["\x1F","\xFF","\xD2"],"\xA3"=>["\x1F","\xFF","\xED","\x80"],"\xA4"=>["\x1F","\xFF","\xEE","\x00"],"\xA5"=>["\x1F","\xFF","\xFA","\x00"],"\xA6"=>["\x1F","\xFF","\xFA","\x40"],"\xA7"=>["\x1F","\xFF","\xDE"],"\xA8"=>["\x1F","\xFF","\xFA","\x80"],"\xA9"=>["\x1F","\xFF","\xEE","\x80"],"\xAA"=>["\x1F","\xFF","\xEF","\x00"],"\xAB"=>["\x1F","\xFF","\xFE","\x00"],"\xAC"=>["\x1F","\xFF","\xDF"],"\xAD"=>["\x1F","\xFF","\xEF","\x80"],"\xAE"=>["\x1F","\xFF","\xFA","\xC0"],"\xAF"=>["\x1F","\xFF","\xFB","\x00"],"\xB0"=>["\x1F","\xFF","\xE0"],"\xB1"=>["\x1F","\xFF","\xE1"],"\xB2"=>["\x1F","\xFF","\xF0","\x00"],"\xB3"=>["\x1F","\xFF","\xE2"],"\xB4"=>["\x1F","\xFF","\xFB","\x40"],"\xB5"=>["\x1F","\xFF","\xF0","\x80"],"\xB6"=>["\x1F","\xFF","\xFB","\x80"],"\xB7"=>["\x1F","\xFF","\xFB","\xC0"],"\xB8"=>["\x1F","\xFF","\xD4"],"\xB9"=>["\x1F","\xFF","\xF1","\x00"],"\xBA"=>["\x1F","\xFF","\xF1","\x80"],"\xBB"=>["\x1F","\xFF","\xF2","\x00"],"\xBC"=>["\x1F","\xFF","\xFC","\x00"],"\xBD"=>["\x1F","\xFF","\xF2","\x80"],"\xBE"=>["\x1F","\xFF","\xF3","\x00"],"\xBF"=>["\x1F","\xFF","\xFC","\x40"],"\xC0"=>["\x1F","\xFF","\xFF","\x00"],"\xC1"=>["\x1F","\xFF","\xFF","\x08"],"\xC2"=>["\x1F","\xFF","\xD6"],"\xC3"=>["\x1F","\xFF","\xC4"],"\xC4"=>["\x1F","\xFF","\xF3","\x80"],"\xC5"=>["\x1F","\xFF","\xFC","\x80"],"\xC6"=>["\x1F","\xFF","\xF4","\x00"],"\xC7"=>["\x1F","\xFF","\xFE","\xC0"],"\xC8"=>["\x1F","\xFF","\xFF","\x10"],"\xC9"=>["\x1F","\xFF","\xFF","\x18"],"\xCA"=>["\x1F","\xFF","\xFF","\x20"],"\xCB"=>["\x1F","\xFF","\xFF","x"],"\xCC"=>["\x1F","\xFF","\xFF","\x7C"],"\xCD"=>["\x1F","\xFF","\xFF","\x28"],"\xCE"=>["\x1F","\xFF","\xFE","\x20"],"\xCF"=>["\x1F","\xFF","\xFE","\xD0"],"\xD0"=>["\x1F","\xFF","\xC8"],"\xD1"=>["\x1F","\xFF","\xE3"],"\xD2"=>["\x1F","\xFF","\xFF","0"],"\xD3"=>["\x1F","\xFF","\xFF","\x80"],"\xD4"=>["\x1F","\xFF","\xFF","\x84"],"\xD5"=>["\x1F","\xFF","\xFF","8"],"\xD6"=>["\x1F","\xFF","\xFF","\x88"],"\xD7"=>["\x1F","\xFF","\xFE","\x40"],"\xD8"=>["\x1F","\xFF","\xE4"],"\xD9"=>["\x1F","\xFF","\xE5"],"\xDA"=>["\x1F","\xFF","\xFF","\x40"],"\xDB"=>["\x1F","\xFF","\xFF","H"],"\xDC"=>["\x1F","\xFF","\xFF","\xFA"],"\xDD"=>["\x1F","\xFF","\xFF","\x8C"],"\xDE"=>["\x1F","\xFF","\xFF","\x90"],"\xDF"=>["\x1F","\xFF","\xFF","\x94"],"\xE0"=>["\x1F","\xFF","\xD8"],"\xE1"=>["\x1F","\xFF","\xFE","\x60"],"\xE2"=>["\x1F","\xFF","\xDA"],"\xE3"=>["\x1F","\xFF","\xE6"],"\xE4"=>["\x1F","\xFF","\xF4","\x80"],"\xE5"=>["\x1F","\xFF","\xE7"],"\xE6"=>["\x1F","\xFF","\xE8"],"\xE7"=>["\x1F","\xFF","\xFC","\xC0"],"\xE8"=>["\x1F","\xFF","\xF5","\x00"],"\xE9"=>["\x1F","\xFF","\xF5","\x80"],"\xEA"=>["\x1F","\xFF","\xFE","\xE0"],"\xEB"=>["\x1F","\xFF","\xFE","\xF0"],"\xEC"=>["\x1F","\xFF","\xFE","\x80"],"\xED"=>["\x1F","\xFF","\xFE","\xA0"],"\xEE"=>["\x1F","\xFF","\xFF","P"],"\xEF"=>["\x1F","\xFF","\xFD","\x00"],"\xF0"=>["\x1F","\xFF","\xFF","X"],"\xF1"=>["\x1F","\xFF","\xFF","\x98"],"\xF2"=>["\x1F","\xFF","\xFF","\x60"],"\xF3"=>["\x1F","\xFF","\xFF","h"],"\xF4"=>["\x1F","\xFF","\xFF","\x9C"],"\xF5"=>["\x1F","\xFF","\xFF","\xA0"],"\xF6"=>["\x1F","\xFF","\xFF","\xA4"],"\xF7"=>["\x1F","\xFF","\xFF","\xA8"],"\xF8"=>["\x1F","\xFF","\xFF","\xAC"],"\xF9"=>["\x1F","\xFF","\xFF","\xFC"],"\xFA"=>["\x1F","\xFF","\xFF","\xB0"],"\xFB"=>["\x1F","\xFF","\xFF","\xB4"],"\xFC"=>["\x1F","\xFF","\xFF","\xB8"],"\xFD"=>["\x1F","\xFF","\xFF","\xBC"],"\xFE"=>["\x1F","\xFF","\xFF","\xC0"],"\xFF"=>["\x1F","\xFF","\xFF","p"],],["\x00"=>["\x0F","\xFC","\x00"],"\x01"=>["\x0F","\xFF","\xFB","\x00"],"\x02"=>["\x0F","\xFF","\xFF","\xE2"],"\x03"=>["\x0F","\xFF","\xFF","\xE3"],"\x04"=>["\x0F","\xFF","\xFF","\xE4"],"\x05"=>["\x0F","\xFF","\xFF","\xE5"],"\x06"=>["\x0F","\xFF","\xFF","\xE6"],"\x07"=>["\x0F","\xFF","\xFF","\xE7"],"\x08"=>["\x0F","\xFF","\xFF","\xE8"],"\x09"=>["\x0F","\xFF","\xFE","\xA0"],"\x0A"=>["\x0F","\xFF","\xFF","\xFF","\x00"],"\x0B"=>["\x0F","\xFF","\xFF","\xE9"],"\x0C"=>["\x0F","\xFF","\xFF","\xEA"],"\x0D"=>["\x0F","\xFF","\xFF","\xFF","\x40"],"\x0E"=>["\x0F","\xFF","\xFF","\xEB"],"\x0F"=>["\x0F","\xFF","\xFF","\xEC"],"\x10"=>["\x0F","\xFF","\xFF","\xED"],"\x11"=>["\x0F","\xFF","\xFF","\xEE"],"\x12"=>["\x0F","\xFF","\xFF","\xEF"],"\x13"=>["\x0F","\xFF","\xFF","\xF0"],"\x14"=>["\x0F","\xFF","\xFF","\xF1"],"\x15"=>["\x0F","\xFF","\xFF","\xF2"],"\x16"=>["\x0F","\xFF","\xFF","\xFF","\x80"],"\x17"=>["\x0F","\xFF","\xFF","\xF3"],"\x18"=>["\x0F","\xFF","\xFF","\xF4"],"\x19"=>["\x0F","\xFF","\xFF","\xF5"],"\x1A"=>["\x0F","\xFF","\xFF","\xF6"],"\x1B"=>["\x0F","\xFF","\xFF","\xF7"],"\x1C"=>["\x0F","\xFF","\xFF","\xF8"],"\x1D"=>["\x0F","\xFF","\xFF","\xF9"],"\x1E"=>["\x0F","\xFF","\xFF","\xFA"],"\x1F"=>["\x0F","\xFF","\xFF","\xFB"],"\x20"=>["\x05","\x00"],"\x21"=>["\x0F","\xE0"],"\x22"=>["\x0F","\xE4"],"\x23"=>["\x0F","\xFA"],"\x24"=>["\x0F","\xFC","\x80"],"\x25"=>["\x05","\x40"],"\x26"=>["\x0F","\x80"],"\x27"=>["\x0F","\xF4"],"\x28"=>["\x0F","\xE8"],"\x29"=>["\x0F","\xEC"],"\x2A"=>["\x0F","\x90"],"\x2B"=>["\x0F","\xF6"],"\x2C"=>["\x0F","\xA0"],"-"=>["\x05","\x80"],"."=>["\x05","\xC0"],"\x2F"=>["\x06","\x00"],["\x00","\x00"],["\x00","\x80"],["\x01","\x00"],["\x06","\x40"],["\x06","\x80"],["\x06","\xC0"],["\x07","\x00"],["\x07","\x40"],["\x07","\x80"],["\x07","\xC0"],"\x3A"=>["\x0B","\x80"],"\x3B"=>["\x0F","\xB0"],"\x3C"=>["\x0F","\xFF","\x80"],"\x3D"=>["\x08","\x00"],"\x3E"=>["\x0F","\xFB"],"\x3F"=>["\x0F","\xF0"],"\x40"=>["\x0F","\xFD","\x00"],"A"=>["\x08","\x40"],"B"=>["\x0B","\xA0"],"C"=>["\x0B","\xC0"],"D"=>["\x0B","\xE0"],"E"=>["\x0C","\x00"],"F"=>["\x0C","\x20"],"G"=>["\x0C","\x40"],"H"=>["\x0C","\x60"],"I"=>["\x0C","\x80"],"J"=>["\x0C","\xA0"],"K"=>["\x0C","\xC0"],"L"=>["\x0C","\xE0"],"M"=>["\x0D","\x00"],"N"=>["\x0D","\x20"],"O"=>["\x0D","\x40"],"P"=>["\x0D","\x60"],"Q"=>["\x0D","\x80"],"R"=>["\x0D","\xA0"],"S"=>["\x0D","\xC0"],"T"=>["\x0D","\xE0"],"U"=>["\x0E","\x00"],"V"=>["\x0E","\x20"],"W"=>["\x0E","\x40"],"X"=>["\x0F","\xC0"],"Y"=>["\x0E","\x60"],"Z"=>["\x0F","\xD0"],"\x5B"=>["\x0F","\xFD","\x80"],"\x5C"=>["\x0F","\xFF","\xE0"],"\x5D"=>["\x0F","\xFE","\x00"],"\x5E"=>["\x0F","\xFF","\x00"],"_"=>["\x08","\x80"],"\x60"=>["\x0F","\xFF","\xA0"],"a"=>["\x01","\x80"],"b"=>["\x08","\xC0"],"c"=>["\x02","\x00"],"d"=>["\x09","\x00"],"e"=>["\x02","\x80"],"f"=>["\x09","\x40"],"g"=>["\x09","\x80"],"h"=>["\x09","\xC0"],"i"=>["\x03","\x00"],"j"=>["\x0E","\x80"],"k"=>["\x0E","\xA0"],"l"=>["\x0A","\x00"],"m"=>["\x0A","\x40"],"n"=>["\x0A","\x80"],"o"=>["\x03","\x80"],"p"=>["\x0A","\xC0"],"q"=>["\x0E","\xC0"],"r"=>["\x0B","\x00"],"s"=>["\x04","\x00"],"t"=>["\x04","\x80"],"u"=>["\x0B","\x40"],"v"=>["\x0E","\xE0"],"w"=>["\x0F","\x00"],"x"=>["\x0F","\x20"],"y"=>["\x0F","\x40"],"z"=>["\x0F","\x60"],"\x7B"=>["\x0F","\xFF","\xC0"],"\x7C"=>["\x0F","\xF8"],"\x7D"=>["\x0F","\xFF","\x40"],"~"=>["\x0F","\xFE","\x80"],"\x7F"=>["\x0F","\xFF","\xFF","\xFC"],"\x80"=>["\x0F","\xFF","\xE6"],"\x81"=>["\x0F","\xFF","\xF4","\x80"],"\x82"=>["\x0F","\xFF","\xE7"],"\x83"=>["\x0F","\xFF","\xE8"],"\x84"=>["\x0F","\xFF","\xF4","\xC0"],"\x85"=>["\x0F","\xFF","\xF5","\x00"],"\x86"=>["\x0F","\xFF","\xF5","\x40"],"\x87"=>["\x0F","\xFF","\xFB","\x20"],"\x88"=>["\x0F","\xFF","\xF5","\x80"],"\x89"=>["\x0F","\xFF","\xFB","\x40"],"\x8A"=>["\x0F","\xFF","\xFB","\x60"],"\x8B"=>["\x0F","\xFF","\xFB","\x80"],"\x8C"=>["\x0F","\xFF","\xFB","\xA0"],"\x8D"=>["\x0F","\xFF","\xFB","\xC0"],"\x8E"=>["\x0F","\xFF","\xFE","\xB0"],"\x8F"=>["\x0F","\xFF","\xFB","\xE0"],"\x90"=>["\x0F","\xFF","\xFE","\xC0"],"\x91"=>["\x0F","\xFF","\xFE","\xD0"],"\x92"=>["\x0F","\xFF","\xF5","\xC0"],"\x93"=>["\x0F","\xFF","\xFC","\x00"],"\x94"=>["\x0F","\xFF","\xFE","\xE0"],"\x95"=>["\x0F","\xFF","\xFC","\x20"],"\x96"=>["\x0F","\xFF","\xFC","\x40"],"\x97"=>["\x0F","\xFF","\xFC","\x60"],"\x98"=>["\x0F","\xFF","\xFC","\x80"],"\x99"=>["\x0F","\xFF","\xEE","\x00"],"\x9A"=>["\x0F","\xFF","\xF6","\x00"],"\x9B"=>["\x0F","\xFF","\xFC","\xA0"],"\x9C"=>["\x0F","\xFF","\xF6","\x40"],"\x9D"=>["\x0F","\xFF","\xFC","\xC0"],"\x9E"=>["\x0F","\xFF","\xFC","\xE0"],"\x9F"=>["\x0F","\xFF","\xFE","\xF0"],"\xA0"=>["\x0F","\xFF","\xF6","\x80"],"\xA1"=>["\x0F","\xFF","\xEE","\x80"],"\xA2"=>["\x0F","\xFF","\xE9"],"\xA3"=>["\x0F","\xFF","\xF6","\xC0"],"\xA4"=>["\x0F","\xFF","\xF7","\x00"],"\xA5"=>["\x0F","\xFF","\xFD","\x00"],"\xA6"=>["\x0F","\xFF","\xFD","\x20"],"\xA7"=>["\x0F","\xFF","\xEF","\x00"],"\xA8"=>["\x0F","\xFF","\xFD","\x40"],"\xA9"=>["\x0F","\xFF","\xF7","\x40"],"\xAA"=>["\x0F","\xFF","\xF7","\x80"],"\xAB"=>["\x0F","\xFF","\xFF","\x00"],"\xAC"=>["\x0F","\xFF","\xEF","\x80"],"\xAD"=>["\x0F","\xFF","\xF7","\xC0"],"\xAE"=>["\x0F","\xFF","\xFD","\x60"],"\xAF"=>["\x0F","\xFF","\xFD","\x80"],"\xB0"=>["\x0F","\xFF","\xF0","\x00"],"\xB1"=>["\x0F","\xFF","\xF0","\x80"],"\xB2"=>["\x0F","\xFF","\xF8","\x00"],"\xB3"=>["\x0F","\xFF","\xF1","\x00"],"\xB4"=>["\x0F","\xFF","\xFD","\xA0"],"\xB5"=>["\x0F","\xFF","\xF8","\x40"],"\xB6"=>["\x0F","\xFF","\xFD","\xC0"],"\xB7"=>["\x0F","\xFF","\xFD","\xE0"],"\xB8"=>["\x0F","\xFF","\xEA"],"\xB9"=>["\x0F","\xFF","\xF8","\x80"],"\xBA"=>["\x0F","\xFF","\xF8","\xC0"],"\xBB"=>["\x0F","\xFF","\xF9","\x00"],"\xBC"=>["\x0F","\xFF","\xFE","\x00"],"\xBD"=>["\x0F","\xFF","\xF9","\x40"],"\xBE"=>["\x0F","\xFF","\xF9","\x80"],"\xBF"=>["\x0F","\xFF","\xFE","\x20"],"\xC0"=>["\x0F","\xFF","\xFF","\x80"],"\xC1"=>["\x0F","\xFF","\xFF","\x84"],"\xC2"=>["\x0F","\xFF","\xEB"],"\xC3"=>["\x0F","\xFF","\xE2"],"\xC4"=>["\x0F","\xFF","\xF9","\xC0"],"\xC5"=>["\x0F","\xFF","\xFE","\x40"],"\xC6"=>["\x0F","\xFF","\xFA","\x00"],"\xC7"=>["\x0F","\xFF","\xFF","\x60"],"\xC8"=>["\x0F","\xFF","\xFF","\x88"],"\xC9"=>["\x0F","\xFF","\xFF","\x8C"],"\xCA"=>["\x0F","\xFF","\xFF","\x90"],"\xCB"=>["\x0F","\xFF","\xFF","\xBC"],"\xCC"=>["\x0F","\xFF","\xFF","\xBE"],"\xCD"=>["\x0F","\xFF","\xFF","\x94"],"\xCE"=>["\x0F","\xFF","\xFF","\x10"],"\xCF"=>["\x0F","\xFF","\xFF","h"],"\xD0"=>["\x0F","\xFF","\xE4"],"\xD1"=>["\x0F","\xFF","\xF1","\x80"],"\xD2"=>["\x0F","\xFF","\xFF","\x98"],"\xD3"=>["\x0F","\xFF","\xFF","\xC0"],"\xD4"=>["\x0F","\xFF","\xFF","\xC2"],"\xD5"=>["\x0F","\xFF","\xFF","\x9C"],"\xD6"=>["\x0F","\xFF","\xFF","\xC4"],"\xD7"=>["\x0F","\xFF","\xFF","\x20"],"\xD8"=>["\x0F","\xFF","\xF2","\x00"],"\xD9"=>["\x0F","\xFF","\xF2","\x80"],"\xDA"=>["\x0F","\xFF","\xFF","\xA0"],"\xDB"=>["\x0F","\xFF","\xFF","\xA4"],"\xDC"=>["\x0F","\xFF","\xFF","\xFD"],"\xDD"=>["\x0F","\xFF","\xFF","\xC6"],"\xDE"=>["\x0F","\xFF","\xFF","\xC8"],"\xDF"=>["\x0F","\xFF","\xFF","\xCA"],"\xE0"=>["\x0F","\xFF","\xEC"],"\xE1"=>["\x0F","\xFF","\xFF","0"],"\xE2"=>["\x0F","\xFF","\xED"],"\xE3"=>["\x0F","\xFF","\xF3","\x00"],"\xE4"=>["\x0F","\xFF","\xFA","\x40"],"\xE5"=>["\x0F","\xFF","\xF3","\x80"],"\xE6"=>["\x0F","\xFF","\xF4","\x00"],"\xE7"=>["\x0F","\xFF","\xFE","\x60"],"\xE8"=>["\x0F","\xFF","\xFA","\x80"],"\xE9"=>["\x0F","\xFF","\xFA","\xC0"],"\xEA"=>["\x0F","\xFF","\xFF","p"],"\xEB"=>["\x0F","\xFF","\xFF","x"],"\xEC"=>["\x0F","\xFF","\xFF","\x40"],"\xED"=>["\x0F","\xFF","\xFF","P"],"\xEE"=>["\x0F","\xFF","\xFF","\xA8"],"\xEF"=>["\x0F","\xFF","\xFE","\x80"],"\xF0"=>["\x0F","\xFF","\xFF","\xAC"],"\xF1"=>["\x0F","\xFF","\xFF","\xCC"],"\xF2"=>["\x0F","\xFF","\xFF","\xB0"],"\xF3"=>["\x0F","\xFF","\xFF","\xB4"],"\xF4"=>["\x0F","\xFF","\xFF","\xCE"],"\xF5"=>["\x0F","\xFF","\xFF","\xD0"],"\xF6"=>["\x0F","\xFF","\xFF","\xD2"],"\xF7"=>["\x0F","\xFF","\xFF","\xD4"],"\xF8"=>["\x0F","\xFF","\xFF","\xD6"],"\xF9"=>["\x0F","\xFF","\xFF","\xFE"],"\xFA"=>["\x0F","\xFF","\xFF","\xD8"],"\xFB"=>["\x0F","\xFF","\xFF","\xDA"],"\xFC"=>["\x0F","\xFF","\xFF","\xDC"],"\xFD"=>["\x0F","\xFF","\xFF","\xDE"],"\xFE"=>["\x0F","\xFF","\xFF","\xE0"],"\xFF"=>["\x0F","\xFF","\xFF","\xB8"],],["\x00"=>["\x07","\xFE","\x00"],"\x01"=>["\x07","\xFF","\xFD","\x80"],"\x02"=>["\x07","\xFF","\xFF","\xF1","\x00"],"\x03"=>["\x07","\xFF","\xFF","\xF1","\x80"],"\x04"=>["\x07","\xFF","\xFF","\xF2","\x00"],"\x05"=>["\x07","\xFF","\xFF","\xF2","\x80"],"\x06"=>["\x07","\xFF","\xFF","\xF3","\x00"],"\x07"=>["\x07","\xFF","\xFF","\xF3","\x80"],"\x08"=>["\x07","\xFF","\xFF","\xF4","\x00"],"\x09"=>["\x07","\xFF","\xFF","P"],"\x0A"=>["\x07","\xFF","\xFF","\xFF","\x80"],"\x0B"=>["\x07","\xFF","\xFF","\xF4","\x80"],"\x0C"=>["\x07","\xFF","\xFF","\xF5","\x00"],"\x0D"=>["\x07","\xFF","\xFF","\xFF","\xA0"],"\x0E"=>["\x07","\xFF","\xFF","\xF5","\x80"],"\x0F"=>["\x07","\xFF","\xFF","\xF6","\x00"],"\x10"=>["\x07","\xFF","\xFF","\xF6","\x80"],"\x11"=>["\x07","\xFF","\xFF","\xF7","\x00"],"\x12"=>["\x07","\xFF","\xFF","\xF7","\x80"],"\x13"=>["\x07","\xFF","\xFF","\xF8","\x00"],"\x14"=>["\x07","\xFF","\xFF","\xF8","\x80"],"\x15"=>["\x07","\xFF","\xFF","\xF9","\x00"],"\x16"=>["\x07","\xFF","\xFF","\xFF","\xC0"],"\x17"=>["\x07","\xFF","\xFF","\xF9","\x80"],"\x18"=>["\x07","\xFF","\xFF","\xFA","\x00"],"\x19"=>["\x07","\xFF","\xFF","\xFA","\x80"],"\x1A"=>["\x07","\xFF","\xFF","\xFB","\x00"],"\x1B"=>["\x07","\xFF","\xFF","\xFB","\x80"],"\x1C"=>["\x07","\xFF","\xFF","\xFC","\x00"],"\x1D"=>["\x07","\xFF","\xFF","\xFC","\x80"],"\x1E"=>["\x07","\xFF","\xFF","\xFD","\x00"],"\x1F"=>["\x07","\xFF","\xFF","\xFD","\x80"],"\x20"=>["\x02","\x80"],"\x21"=>["\x07","\xF0"],"\x22"=>["\x07","\xF2"],"\x23"=>["\x07","\xFD","\x00"],"\x24"=>["\x07","\xFE","\x40"],"\x25"=>["\x02","\xA0"],"\x26"=>["\x07","\xC0"],"\x27"=>["\x07","\xFA"],"\x28"=>["\x07","\xF4"],"\x29"=>["\x07","\xF6"],"\x2A"=>["\x07","\xC8"],"\x2B"=>["\x07","\xFB"],"\x2C"=>["\x07","\xD0"],"-"=>["\x02","\xC0"],"."=>["\x02","\xE0"],"\x2F"=>["\x03","\x00"],["\x00","\x00"],["\x00","\x40"],["\x00","\x80"],["\x03","\x20"],["\x03","\x40"],["\x03","\x60"],["\x03","\x80"],["\x03","\xA0"],["\x03","\xC0"],["\x03","\xE0"],"\x3A"=>["\x05","\xC0"],"\x3B"=>["\x07","\xD8"],"\x3C"=>["\x07","\xFF","\xC0"],"\x3D"=>["\x04","\x00"],"\x3E"=>["\x07","\xFD","\x80"],"\x3F"=>["\x07","\xF8"],"\x40"=>["\x07","\xFE","\x80"],"A"=>["\x04","\x20"],"B"=>["\x05","\xD0"],"C"=>["\x05","\xE0"],"D"=>["\x05","\xF0"],"E"=>["\x06","\x00"],"F"=>["\x06","\x10"],"G"=>["\x06","\x20"],"H"=>["\x06","0"],"I"=>["\x06","\x40"],"J"=>["\x06","P"],"K"=>["\x06","\x60"],"L"=>["\x06","p"],"M"=>["\x06","\x80"],"N"=>["\x06","\x90"],"O"=>["\x06","\xA0"],"P"=>["\x06","\xB0"],"Q"=>["\x06","\xC0"],"R"=>["\x06","\xD0"],"S"=>["\x06","\xE0"],"T"=>["\x06","\xF0"],"U"=>["\x07","\x00"],"V"=>["\x07","\x10"],"W"=>["\x07","\x20"],"X"=>["\x07","\xE0"],"Y"=>["\x07","0"],"Z"=>["\x07","\xE8"],"\x5B"=>["\x07","\xFE","\xC0"],"\x5C"=>["\x07","\xFF","\xF0"],"\x5D"=>["\x07","\xFF","\x00"],"\x5E"=>["\x07","\xFF","\x80"],"_"=>["\x04","\x40"],"\x60"=>["\x07","\xFF","\xD0"],"a"=>["\x00","\xC0"],"b"=>["\x04","\x60"],"c"=>["\x01","\x00"],"d"=>["\x04","\x80"],"e"=>["\x01","\x40"],"f"=>["\x04","\xA0"],"g"=>["\x04","\xC0"],"h"=>["\x04","\xE0"],"i"=>["\x01","\x80"],"j"=>["\x07","\x40"],"k"=>["\x07","P"],"l"=>["\x05","\x00"],"m"=>["\x05","\x20"],"n"=>["\x05","\x40"],"o"=>["\x01","\xC0"],"p"=>["\x05","\x60"],"q"=>["\x07","\x60"],"r"=>["\x05","\x80"],"s"=>["\x02","\x00"],"t"=>["\x02","\x40"],"u"=>["\x05","\xA0"],"v"=>["\x07","p"],"w"=>["\x07","\x80"],"x"=>["\x07","\x90"],"y"=>["\x07","\xA0"],"z"=>["\x07","\xB0"],"\x7B"=>["\x07","\xFF","\xE0"],"\x7C"=>["\x07","\xFC"],"\x7D"=>["\x07","\xFF","\xA0"],"~"=>["\x07","\xFF","\x40"],"\x7F"=>["\x07","\xFF","\xFF","\xFE","\x00"],"\x80"=>["\x07","\xFF","\xF3","\x00"],"\x81"=>["\x07","\xFF","\xFA","\x40"],"\x82"=>["\x07","\xFF","\xF3","\x80"],"\x83"=>["\x07","\xFF","\xF4","\x00"],"\x84"=>["\x07","\xFF","\xFA","\x60"],"\x85"=>["\x07","\xFF","\xFA","\x80"],"\x86"=>["\x07","\xFF","\xFA","\xA0"],"\x87"=>["\x07","\xFF","\xFD","\x90"],"\x88"=>["\x07","\xFF","\xFA","\xC0"],"\x89"=>["\x07","\xFF","\xFD","\xA0"],"\x8A"=>["\x07","\xFF","\xFD","\xB0"],"\x8B"=>["\x07","\xFF","\xFD","\xC0"],"\x8C"=>["\x07","\xFF","\xFD","\xD0"],"\x8D"=>["\x07","\xFF","\xFD","\xE0"],"\x8E"=>["\x07","\xFF","\xFF","X"],"\x8F"=>["\x07","\xFF","\xFD","\xF0"],"\x90"=>["\x07","\xFF","\xFF","\x60"],"\x91"=>["\x07","\xFF","\xFF","h"],"\x92"=>["\x07","\xFF","\xFA","\xE0"],"\x93"=>["\x07","\xFF","\xFE","\x00"],"\x94"=>["\x07","\xFF","\xFF","p"],"\x95"=>["\x07","\xFF","\xFE","\x10"],"\x96"=>["\x07","\xFF","\xFE","\x20"],"\x97"=>["\x07","\xFF","\xFE","0"],"\x98"=>["\x07","\xFF","\xFE","\x40"],"\x99"=>["\x07","\xFF","\xF7","\x00"],"\x9A"=>["\x07","\xFF","\xFB","\x00"],"\x9B"=>["\x07","\xFF","\xFE","P"],"\x9C"=>["\x07","\xFF","\xFB","\x20"],"\x9D"=>["\x07","\xFF","\xFE","\x60"],"\x9E"=>["\x07","\xFF","\xFE","p"],"\x9F"=>["\x07","\xFF","\xFF","x"],"\xA0"=>["\x07","\xFF","\xFB","\x40"],"\xA1"=>["\x07","\xFF","\xF7","\x40"],"\xA2"=>["\x07","\xFF","\xF4","\x80"],"\xA3"=>["\x07","\xFF","\xFB","\x60"],"\xA4"=>["\x07","\xFF","\xFB","\x80"],"\xA5"=>["\x07","\xFF","\xFE","\x80"],"\xA6"=>["\x07","\xFF","\xFE","\x90"],"\xA7"=>["\x07","\xFF","\xF7","\x80"],"\xA8"=>["\x07","\xFF","\xFE","\xA0"],"\xA9"=>["\x07","\xFF","\xFB","\xA0"],"\xAA"=>["\x07","\xFF","\xFB","\xC0"],"\xAB"=>["\x07","\xFF","\xFF","\x80"],"\xAC"=>["\x07","\xFF","\xF7","\xC0"],"\xAD"=>["\x07","\xFF","\xFB","\xE0"],"\xAE"=>["\x07","\xFF","\xFE","\xB0"],"\xAF"=>["\x07","\xFF","\xFE","\xC0"],"\xB0"=>["\x07","\xFF","\xF8","\x00"],"\xB1"=>["\x07","\xFF","\xF8","\x40"],"\xB2"=>["\x07","\xFF","\xFC","\x00"],"\xB3"=>["\x07","\xFF","\xF8","\x80"],"\xB4"=>["\x07","\xFF","\xFE","\xD0"],"\xB5"=>["\x07","\xFF","\xFC","\x20"],"\xB6"=>["\x07","\xFF","\xFE","\xE0"],"\xB7"=>["\x07","\xFF","\xFE","\xF0"],"\xB8"=>["\x07","\xFF","\xF5","\x00"],"\xB9"=>["\x07","\xFF","\xFC","\x40"],"\xBA"=>["\x07","\xFF","\xFC","\x60"],"\xBB"=>["\x07","\xFF","\xFC","\x80"],"\xBC"=>["\x07","\xFF","\xFF","\x00"],"\xBD"=>["\x07","\xFF","\xFC","\xA0"],"\xBE"=>["\x07","\xFF","\xFC","\xC0"],"\xBF"=>["\x07","\xFF","\xFF","\x10"],"\xC0"=>["\x07","\xFF","\xFF","\xC0"],"\xC1"=>["\x07","\xFF","\xFF","\xC2"],"\xC2"=>["\x07","\xFF","\xF5","\x80"],"\xC3"=>["\x07","\xFF","\xF1"],"\xC4"=>["\x07","\xFF","\xFC","\xE0"],"\xC5"=>["\x07","\xFF","\xFF","\x20"],"\xC6"=>["\x07","\xFF","\xFD","\x00"],"\xC7"=>["\x07","\xFF","\xFF","\xB0"],"\xC8"=>["\x07","\xFF","\xFF","\xC4"],"\xC9"=>["\x07","\xFF","\xFF","\xC6"],"\xCA"=>["\x07","\xFF","\xFF","\xC8"],"\xCB"=>["\x07","\xFF","\xFF","\xDE"],"\xCC"=>["\x07","\xFF","\xFF","\xDF"],"\xCD"=>["\x07","\xFF","\xFF","\xCA"],"\xCE"=>["\x07","\xFF","\xFF","\x88"],"\xCF"=>["\x07","\xFF","\xFF","\xB4"],"\xD0"=>["\x07","\xFF","\xF2"],"\xD1"=>["\x07","\xFF","\xF8","\xC0"],"\xD2"=>["\x07","\xFF","\xFF","\xCC"],"\xD3"=>["\x07","\xFF","\xFF","\xE0"],"\xD4"=>["\x07","\xFF","\xFF","\xE1"],"\xD5"=>["\x07","\xFF","\xFF","\xCE"],"\xD6"=>["\x07","\xFF","\xFF","\xE2"],"\xD7"=>["\x07","\xFF","\xFF","\x90"],"\xD8"=>["\x07","\xFF","\xF9","\x00"],"\xD9"=>["\x07","\xFF","\xF9","\x40"],"\xDA"=>["\x07","\xFF","\xFF","\xD0"],"\xDB"=>["\x07","\xFF","\xFF","\xD2"],"\xDC"=>["\x07","\xFF","\xFF","\xFE","\x80"],"\xDD"=>["\x07","\xFF","\xFF","\xE3"],"\xDE"=>["\x07","\xFF","\xFF","\xE4"],"\xDF"=>["\x07","\xFF","\xFF","\xE5"],"\xE0"=>["\x07","\xFF","\xF6","\x00"],"\xE1"=>["\x07","\xFF","\xFF","\x98"],"\xE2"=>["\x07","\xFF","\xF6","\x80"],"\xE3"=>["\x07","\xFF","\xF9","\x80"],"\xE4"=>["\x07","\xFF","\xFD","\x20"],"\xE5"=>["\x07","\xFF","\xF9","\xC0"],"\xE6"=>["\x07","\xFF","\xFA","\x00"],"\xE7"=>["\x07","\xFF","\xFF","0"],"\xE8"=>["\x07","\xFF","\xFD","\x40"],"\xE9"=>["\x07","\xFF","\xFD","\x60"],"\xEA"=>["\x07","\xFF","\xFF","\xB8"],"\xEB"=>["\x07","\xFF","\xFF","\xBC"],"\xEC"=>["\x07","\xFF","\xFF","\xA0"],"\xED"=>["\x07","\xFF","\xFF","\xA8"],"\xEE"=>["\x07","\xFF","\xFF","\xD4"],"\xEF"=>["\x07","\xFF","\xFF","\x40"],"\xF0"=>["\x07","\xFF","\xFF","\xD6"],"\xF1"=>["\x07","\xFF","\xFF","\xE6"],"\xF2"=>["\x07","\xFF","\xFF","\xD8"],"\xF3"=>["\x07","\xFF","\xFF","\xDA"],"\xF4"=>["\x07","\xFF","\xFF","\xE7"],"\xF5"=>["\x07","\xFF","\xFF","\xE8"],"\xF6"=>["\x07","\xFF","\xFF","\xE9"],"\xF7"=>["\x07","\xFF","\xFF","\xEA"],"\xF8"=>["\x07","\xFF","\xFF","\xEB"],"\xF9"=>["\x07","\xFF","\xFF","\xFF","\x00"],"\xFA"=>["\x07","\xFF","\xFF","\xEC"],"\xFB"=>["\x07","\xFF","\xFF","\xED"],"\xFC"=>["\x07","\xFF","\xFF","\xEE"],"\xFD"=>["\x07","\xFF","\xFF","\xEF"],"\xFE"=>["\x07","\xFF","\xFF","\xF0"],"\xFF"=>["\x07","\xFF","\xFF","\xDC"],],["\x00"=>["\x03","\xFF","\x00"],"\x01"=>["\x03","\xFF","\xFE","\xC0"],"\x02"=>["\x03","\xFF","\xFF","\xF8","\x80"],"\x03"=>["\x03","\xFF","\xFF","\xF8","\xC0"],"\x04"=>["\x03","\xFF","\xFF","\xF9","\x00"],"\x05"=>["\x03","\xFF","\xFF","\xF9","\x40"],"\x06"=>["\x03","\xFF","\xFF","\xF9","\x80"],"\x07"=>["\x03","\xFF","\xFF","\xF9","\xC0"],"\x08"=>["\x03","\xFF","\xFF","\xFA","\x00"],"\x09"=>["\x03","\xFF","\xFF","\xA8"],"\x0A"=>["\x03","\xFF","\xFF","\xFF","\xC0"],"\x0B"=>["\x03","\xFF","\xFF","\xFA","\x40"],"\x0C"=>["\x03","\xFF","\xFF","\xFA","\x80"],"\x0D"=>["\x03","\xFF","\xFF","\xFF","\xD0"],"\x0E"=>["\x03","\xFF","\xFF","\xFA","\xC0"],"\x0F"=>["\x03","\xFF","\xFF","\xFB","\x00"],"\x10"=>["\x03","\xFF","\xFF","\xFB","\x40"],"\x11"=>["\x03","\xFF","\xFF","\xFB","\x80"],"\x12"=>["\x03","\xFF","\xFF","\xFB","\xC0"],"\x13"=>["\x03","\xFF","\xFF","\xFC","\x00"],"\x14"=>["\x03","\xFF","\xFF","\xFC","\x40"],"\x15"=>["\x03","\xFF","\xFF","\xFC","\x80"],"\x16"=>["\x03","\xFF","\xFF","\xFF","\xE0"],"\x17"=>["\x03","\xFF","\xFF","\xFC","\xC0"],"\x18"=>["\x03","\xFF","\xFF","\xFD","\x00"],"\x19"=>["\x03","\xFF","\xFF","\xFD","\x40"],"\x1A"=>["\x03","\xFF","\xFF","\xFD","\x80"],"\x1B"=>["\x03","\xFF","\xFF","\xFD","\xC0"],"\x1C"=>["\x03","\xFF","\xFF","\xFE","\x00"],"\x1D"=>["\x03","\xFF","\xFF","\xFE","\x40"],"\x1E"=>["\x03","\xFF","\xFF","\xFE","\x80"],"\x1F"=>["\x03","\xFF","\xFF","\xFE","\xC0"],"\x20"=>["\x01","\x40"],"\x21"=>["\x03","\xF8"],"\x22"=>["\x03","\xF9"],"\x23"=>["\x03","\xFE","\x80"],"\x24"=>["\x03","\xFF","\x20"],"\x25"=>["\x01","P"],"\x26"=>["\x03","\xE0"],"\x27"=>["\x03","\xFD","\x00"],"\x28"=>["\x03","\xFA"],"\x29"=>["\x03","\xFB"],"\x2A"=>["\x03","\xE4"],"\x2B"=>["\x03","\xFD","\x80"],"\x2C"=>["\x03","\xE8"],"-"=>["\x01","\x60"],"."=>["\x01","p"],"\x2F"=>["\x01","\x80"],["\x00","\x00"],["\x00","\x20"],["\x00","\x40"],["\x01","\x90"],["\x01","\xA0"],["\x01","\xB0"],["\x01","\xC0"],["\x01","\xD0"],["\x01","\xE0"],["\x01","\xF0"],"\x3A"=>["\x02","\xE0"],"\x3B"=>["\x03","\xEC"],"\x3C"=>["\x03","\xFF","\xE0"],"\x3D"=>["\x02","\x00"],"\x3E"=>["\x03","\xFE","\xC0"],"\x3F"=>["\x03","\xFC"],"\x40"=>["\x03","\xFF","\x40"],"A"=>["\x02","\x10"],"B"=>["\x02","\xE8"],"C"=>["\x02","\xF0"],"D"=>["\x02","\xF8"],"E"=>["\x03","\x00"],"F"=>["\x03","\x08"],"G"=>["\x03","\x10"],"H"=>["\x03","\x18"],"I"=>["\x03","\x20"],"J"=>["\x03","\x28"],"K"=>["\x03","0"],"L"=>["\x03","8"],"M"=>["\x03","\x40"],"N"=>["\x03","H"],"O"=>["\x03","P"],"P"=>["\x03","X"],"Q"=>["\x03","\x60"],"R"=>["\x03","h"],"S"=>["\x03","p"],"T"=>["\x03","x"],"U"=>["\x03","\x80"],"V"=>["\x03","\x88"],"W"=>["\x03","\x90"],"X"=>["\x03","\xF0"],"Y"=>["\x03","\x98"],"Z"=>["\x03","\xF4"],"\x5B"=>["\x03","\xFF","\x60"],"\x5C"=>["\x03","\xFF","\xF8","\x00"],"\x5D"=>["\x03","\xFF","\x80"],"\x5E"=>["\x03","\xFF","\xC0"],"_"=>["\x02","\x20"],"\x60"=>["\x03","\xFF","\xE8"],"a"=>["\x00","\x60"],"b"=>["\x02","0"],"c"=>["\x00","\x80"],"d"=>["\x02","\x40"],"e"=>["\x00","\xA0"],"f"=>["\x02","P"],"g"=>["\x02","\x60"],"h"=>["\x02","p"],"i"=>["\x00","\xC0"],"j"=>["\x03","\xA0"],"k"=>["\x03","\xA8"],"l"=>["\x02","\x80"],"m"=>["\x02","\x90"],"n"=>["\x02","\xA0"],"o"=>["\x00","\xE0"],"p"=>["\x02","\xB0"],"q"=>["\x03","\xB0"],"r"=>["\x02","\xC0"],"s"=>["\x01","\x00"],"t"=>["\x01","\x20"],"u"=>["\x02","\xD0"],"v"=>["\x03","\xB8"],"w"=>["\x03","\xC0"],"x"=>["\x03","\xC8"],"y"=>["\x03","\xD0"],"z"=>["\x03","\xD8"],"\x7B"=>["\x03","\xFF","\xF0"],"\x7C"=>["\x03","\xFE","\x00"],"\x7D"=>["\x03","\xFF","\xD0"],"~"=>["\x03","\xFF","\xA0"],"\x7F"=>["\x03","\xFF","\xFF","\xFF","\x00"],"\x80"=>["\x03","\xFF","\xF9","\x80"],"\x81"=>["\x03","\xFF","\xFD","\x20"],"\x82"=>["\x03","\xFF","\xF9","\xC0"],"\x83"=>["\x03","\xFF","\xFA","\x00"],"\x84"=>["\x03","\xFF","\xFD","0"],"\x85"=>["\x03","\xFF","\xFD","\x40"],"\x86"=>["\x03","\xFF","\xFD","P"],"\x87"=>["\x03","\xFF","\xFE","\xC8"],"\x88"=>["\x03","\xFF","\xFD","\x60"],"\x89"=>["\x03","\xFF","\xFE","\xD0"],"\x8A"=>["\x03","\xFF","\xFE","\xD8"],"\x8B"=>["\x03","\xFF","\xFE","\xE0"],"\x8C"=>["\x03","\xFF","\xFE","\xE8"],"\x8D"=>["\x03","\xFF","\xFE","\xF0"],"\x8E"=>["\x03","\xFF","\xFF","\xAC"],"\x8F"=>["\x03","\xFF","\xFE","\xF8"],"\x90"=>["\x03","\xFF","\xFF","\xB0"],"\x91"=>["\x03","\xFF","\xFF","\xB4"],"\x92"=>["\x03","\xFF","\xFD","p"],"\x93"=>["\x03","\xFF","\xFF","\x00"],"\x94"=>["\x03","\xFF","\xFF","\xB8"],"\x95"=>["\x03","\xFF","\xFF","\x08"],"\x96"=>["\x03","\xFF","\xFF","\x10"],"\x97"=>["\x03","\xFF","\xFF","\x18"],"\x98"=>["\x03","\xFF","\xFF","\x20"],"\x99"=>["\x03","\xFF","\xFB","\x80"],"\x9A"=>["\x03","\xFF","\xFD","\x80"],"\x9B"=>["\x03","\xFF","\xFF","\x28"],"\x9C"=>["\x03","\xFF","\xFD","\x90"],"\x9D"=>["\x03","\xFF","\xFF","0"],"\x9E"=>["\x03","\xFF","\xFF","8"],"\x9F"=>["\x03","\xFF","\xFF","\xBC"],"\xA0"=>["\x03","\xFF","\xFD","\xA0"],"\xA1"=>["\x03","\xFF","\xFB","\xA0"],"\xA2"=>["\x03","\xFF","\xFA","\x40"],"\xA3"=>["\x03","\xFF","\xFD","\xB0"],"\xA4"=>["\x03","\xFF","\xFD","\xC0"],"\xA5"=>["\x03","\xFF","\xFF","\x40"],"\xA6"=>["\x03","\xFF","\xFF","H"],"\xA7"=>["\x03","\xFF","\xFB","\xC0"],"\xA8"=>["\x03","\xFF","\xFF","P"],"\xA9"=>["\x03","\xFF","\xFD","\xD0"],"\xAA"=>["\x03","\xFF","\xFD","\xE0"],"\xAB"=>["\x03","\xFF","\xFF","\xC0"],"\xAC"=>["\x03","\xFF","\xFB","\xE0"],"\xAD"=>["\x03","\xFF","\xFD","\xF0"],"\xAE"=>["\x03","\xFF","\xFF","X"],"\xAF"=>["\x03","\xFF","\xFF","\x60"],"\xB0"=>["\x03","\xFF","\xFC","\x00"],"\xB1"=>["\x03","\xFF","\xFC","\x20"],"\xB2"=>["\x03","\xFF","\xFE","\x00"],"\xB3"=>["\x03","\xFF","\xFC","\x40"],"\xB4"=>["\x03","\xFF","\xFF","h"],"\xB5"=>["\x03","\xFF","\xFE","\x10"],"\xB6"=>["\x03","\xFF","\xFF","p"],"\xB7"=>["\x03","\xFF","\xFF","x"],"\xB8"=>["\x03","\xFF","\xFA","\x80"],"\xB9"=>["\x03","\xFF","\xFE","\x20"],"\xBA"=>["\x03","\xFF","\xFE","0"],"\xBB"=>["\x03","\xFF","\xFE","\x40"],"\xBC"=>["\x03","\xFF","\xFF","\x80"],"\xBD"=>["\x03","\xFF","\xFE","P"],"\xBE"=>["\x03","\xFF","\xFE","\x60"],"\xBF"=>["\x03","\xFF","\xFF","\x88"],"\xC0"=>["\x03","\xFF","\xFF","\xE0"],"\xC1"=>["\x03","\xFF","\xFF","\xE1"],"\xC2"=>["\x03","\xFF","\xFA","\xC0"],"\xC3"=>["\x03","\xFF","\xF8","\x80"],"\xC4"=>["\x03","\xFF","\xFE","p"],"\xC5"=>["\x03","\xFF","\xFF","\x90"],"\xC6"=>["\x03","\xFF","\xFE","\x80"],"\xC7"=>["\x03","\xFF","\xFF","\xD8"],"\xC8"=>["\x03","\xFF","\xFF","\xE2"],"\xC9"=>["\x03","\xFF","\xFF","\xE3"],"\xCA"=>["\x03","\xFF","\xFF","\xE4"],"\xCB"=>["\x03","\xFF","\xFF","\xEF","\x00"],"\xCC"=>["\x03","\xFF","\xFF","\xEF","\x80"],"\xCD"=>["\x03","\xFF","\xFF","\xE5"],"\xCE"=>["\x03","\xFF","\xFF","\xC4"],"\xCF"=>["\x03","\xFF","\xFF","\xDA"],"\xD0"=>["\x03","\xFF","\xF9","\x00"],"\xD1"=>["\x03","\xFF","\xFC","\x60"],"\xD2"=>["\x03","\xFF","\xFF","\xE6"],"\xD3"=>["\x03","\xFF","\xFF","\xF0","\x00"],"\xD4"=>["\x03","\xFF","\xFF","\xF0","\x80"],"\xD5"=>["\x03","\xFF","\xFF","\xE7"],"\xD6"=>["\x03","\xFF","\xFF","\xF1","\x00"],"\xD7"=>["\x03","\xFF","\xFF","\xC8"],"\xD8"=>["\x03","\xFF","\xFC","\x80"],"\xD9"=>["\x03","\xFF","\xFC","\xA0"],"\xDA"=>["\x03","\xFF","\xFF","\xE8"],"\xDB"=>["\x03","\xFF","\xFF","\xE9"],"\xDC"=>["\x03","\xFF","\xFF","\xFF","\x40"],"\xDD"=>["\x03","\xFF","\xFF","\xF1","\x80"],"\xDE"=>["\x03","\xFF","\xFF","\xF2","\x00"],"\xDF"=>["\x03","\xFF","\xFF","\xF2","\x80"],"\xE0"=>["\x03","\xFF","\xFB","\x00"],"\xE1"=>["\x03","\xFF","\xFF","\xCC"],"\xE2"=>["\x03","\xFF","\xFB","\x40"],"\xE3"=>["\x03","\xFF","\xFC","\xC0"],"\xE4"=>["\x03","\xFF","\xFE","\x90"],"\xE5"=>["\x03","\xFF","\xFC","\xE0"],"\xE6"=>["\x03","\xFF","\xFD","\x00"],"\xE7"=>["\x03","\xFF","\xFF","\x98"],"\xE8"=>["\x03","\xFF","\xFE","\xA0"],"\xE9"=>["\x03","\xFF","\xFE","\xB0"],"\xEA"=>["\x03","\xFF","\xFF","\xDC"],"\xEB"=>["\x03","\xFF","\xFF","\xDE"],"\xEC"=>["\x03","\xFF","\xFF","\xD0"],"\xED"=>["\x03","\xFF","\xFF","\xD4"],"\xEE"=>["\x03","\xFF","\xFF","\xEA"],"\xEF"=>["\x03","\xFF","\xFF","\xA0"],"\xF0"=>["\x03","\xFF","\xFF","\xEB"],"\xF1"=>["\x03","\xFF","\xFF","\xF3","\x00"],"\xF2"=>["\x03","\xFF","\xFF","\xEC"],"\xF3"=>["\x03","\xFF","\xFF","\xED"],"\xF4"=>["\x03","\xFF","\xFF","\xF3","\x80"],"\xF5"=>["\x03","\xFF","\xFF","\xF4","\x00"],"\xF6"=>["\x03","\xFF","\xFF","\xF4","\x80"],"\xF7"=>["\x03","\xFF","\xFF","\xF5","\x00"],"\xF8"=>["\x03","\xFF","\xFF","\xF5","\x80"],"\xF9"=>["\x03","\xFF","\xFF","\xFF","\x80"],"\xFA"=>["\x03","\xFF","\xFF","\xF6","\x00"],"\xFB"=>["\x03","\xFF","\xFF","\xF6","\x80"],"\xFC"=>["\x03","\xFF","\xFF","\xF7","\x00"],"\xFD"=>["\x03","\xFF","\xFF","\xF7","\x80"],"\xFE"=>["\x03","\xFF","\xFF","\xF8","\x00"],"\xFF"=>["\x03","\xFF","\xFF","\xEE"],],["\x00"=>["\x01","\xFF","\x80"],"\x01"=>["\x01","\xFF","\xFF","\x60"],"\x02"=>["\x01","\xFF","\xFF","\xFC","\x40"],"\x03"=>["\x01","\xFF","\xFF","\xFC","\x60"],"\x04"=>["\x01","\xFF","\xFF","\xFC","\x80"],"\x05"=>["\x01","\xFF","\xFF","\xFC","\xA0"],"\x06"=>["\x01","\xFF","\xFF","\xFC","\xC0"],"\x07"=>["\x01","\xFF","\xFF","\xFC","\xE0"],"\x08"=>["\x01","\xFF","\xFF","\xFD","\x00"],"\x09"=>["\x01","\xFF","\xFF","\xD4"],"\x0A"=>["\x01","\xFF","\xFF","\xFF","\xE0"],"\x0B"=>["\x01","\xFF","\xFF","\xFD","\x20"],"\x0C"=>["\x01","\xFF","\xFF","\xFD","\x40"],"\x0D"=>["\x01","\xFF","\xFF","\xFF","\xE8"],"\x0E"=>["\x01","\xFF","\xFF","\xFD","\x60"],"\x0F"=>["\x01","\xFF","\xFF","\xFD","\x80"],"\x10"=>["\x01","\xFF","\xFF","\xFD","\xA0"],"\x11"=>["\x01","\xFF","\xFF","\xFD","\xC0"],"\x12"=>["\x01","\xFF","\xFF","\xFD","\xE0"],"\x13"=>["\x01","\xFF","\xFF","\xFE","\x00"],"\x14"=>["\x01","\xFF","\xFF","\xFE","\x20"],"\x15"=>["\x01","\xFF","\xFF","\xFE","\x40"],"\x16"=>["\x01","\xFF","\xFF","\xFF","\xF0"],"\x17"=>["\x01","\xFF","\xFF","\xFE","\x60"],"\x18"=>["\x01","\xFF","\xFF","\xFE","\x80"],"\x19"=>["\x01","\xFF","\xFF","\xFE","\xA0"],"\x1A"=>["\x01","\xFF","\xFF","\xFE","\xC0"],"\x1B"=>["\x01","\xFF","\xFF","\xFE","\xE0"],"\x1C"=>["\x01","\xFF","\xFF","\xFF","\x00"],"\x1D"=>["\x01","\xFF","\xFF","\xFF","\x20"],"\x1E"=>["\x01","\xFF","\xFF","\xFF","\x40"],"\x1F"=>["\x01","\xFF","\xFF","\xFF","\x60"],"\x20"=>["\x00","\xA0"],"\x21"=>["\x01","\xFC","\x00"],"\x22"=>["\x01","\xFC","\x80"],"\x23"=>["\x01","\xFF","\x40"],"\x24"=>["\x01","\xFF","\x90"],"\x25"=>["\x00","\xA8"],"\x26"=>["\x01","\xF0"],"\x27"=>["\x01","\xFE","\x80"],"\x28"=>["\x01","\xFD","\x00"],"\x29"=>["\x01","\xFD","\x80"],"\x2A"=>["\x01","\xF2"],"\x2B"=>["\x01","\xFE","\xC0"],"\x2C"=>["\x01","\xF4"],"-"=>["\x00","\xB0"],"."=>["\x00","\xB8"],"\x2F"=>["\x00","\xC0"],["\x00","\x00"],["\x00","\x10"],["\x00","\x20"],["\x00","\xC8"],["\x00","\xD0"],["\x00","\xD8"],["\x00","\xE0"],["\x00","\xE8"],["\x00","\xF0"],["\x00","\xF8"],"\x3A"=>["\x01","p"],"\x3B"=>["\x01","\xF6"],"\x3C"=>["\x01","\xFF","\xF0"],"\x3D"=>["\x01","\x00"],"\x3E"=>["\x01","\xFF","\x60"],"\x3F"=>["\x01","\xFE","\x00"],"\x40"=>["\x01","\xFF","\xA0"],"A"=>["\x01","\x08"],"B"=>["\x01","t"],"C"=>["\x01","x"],"D"=>["\x01","\x7C"],"E"=>["\x01","\x80"],"F"=>["\x01","\x84"],"G"=>["\x01","\x88"],"H"=>["\x01","\x8C"],"I"=>["\x01","\x90"],"J"=>["\x01","\x94"],"K"=>["\x01","\x98"],"L"=>["\x01","\x9C"],"M"=>["\x01","\xA0"],"N"=>["\x01","\xA4"],"O"=>["\x01","\xA8"],"P"=>["\x01","\xAC"],"Q"=>["\x01","\xB0"],"R"=>["\x01","\xB4"],"S"=>["\x01","\xB8"],"T"=>["\x01","\xBC"],"U"=>["\x01","\xC0"],"V"=>["\x01","\xC4"],"W"=>["\x01","\xC8"],"X"=>["\x01","\xF8"],"Y"=>["\x01","\xCC"],"Z"=>["\x01","\xFA"],"\x5B"=>["\x01","\xFF","\xB0"],"\x5C"=>["\x01","\xFF","\xFC","\x00"],"\x5D"=>["\x01","\xFF","\xC0"],"\x5E"=>["\x01","\xFF","\xE0"],"_"=>["\x01","\x10"],"\x60"=>["\x01","\xFF","\xF4"],"a"=>["\x00","0"],"b"=>["\x01","\x18"],"c"=>["\x00","\x40"],"d"=>["\x01","\x20"],"e"=>["\x00","P"],"f"=>["\x01","\x28"],"g"=>["\x01","0"],"h"=>["\x01","8"],"i"=>["\x00","\x60"],"j"=>["\x01","\xD0"],"k"=>["\x01","\xD4"],"l"=>["\x01","\x40"],"m"=>["\x01","H"],"n"=>["\x01","P"],"o"=>["\x00","p"],"p"=>["\x01","X"],"q"=>["\x01","\xD8"],"r"=>["\x01","\x60"],"s"=>["\x00","\x80"],"t"=>["\x00","\x90"],"u"=>["\x01","h"],"v"=>["\x01","\xDC"],"w"=>["\x01","\xE0"],"x"=>["\x01","\xE4"],"y"=>["\x01","\xE8"],"z"=>["\x01","\xEC"],"\x7B"=>["\x01","\xFF","\xF8"],"\x7C"=>["\x01","\xFF","\x00"],"\x7D"=>["\x01","\xFF","\xE8"],"~"=>["\x01","\xFF","\xD0"],"\x7F"=>["\x01","\xFF","\xFF","\xFF","\x80"],"\x80"=>["\x01","\xFF","\xFC","\xC0"],"\x81"=>["\x01","\xFF","\xFE","\x90"],"\x82"=>["\x01","\xFF","\xFC","\xE0"],"\x83"=>["\x01","\xFF","\xFD","\x00"],"\x84"=>["\x01","\xFF","\xFE","\x98"],"\x85"=>["\x01","\xFF","\xFE","\xA0"],"\x86"=>["\x01","\xFF","\xFE","\xA8"],"\x87"=>["\x01","\xFF","\xFF","d"],"\x88"=>["\x01","\xFF","\xFE","\xB0"],"\x89"=>["\x01","\xFF","\xFF","h"],"\x8A"=>["\x01","\xFF","\xFF","l"],"\x8B"=>["\x01","\xFF","\xFF","p"],"\x8C"=>["\x01","\xFF","\xFF","t"],"\x8D"=>["\x01","\xFF","\xFF","x"],"\x8E"=>["\x01","\xFF","\xFF","\xD6"],"\x8F"=>["\x01","\xFF","\xFF","\x7C"],"\x90"=>["\x01","\xFF","\xFF","\xD8"],"\x91"=>["\x01","\xFF","\xFF","\xDA"],"\x92"=>["\x01","\xFF","\xFE","\xB8"],"\x93"=>["\x01","\xFF","\xFF","\x80"],"\x94"=>["\x01","\xFF","\xFF","\xDC"],"\x95"=>["\x01","\xFF","\xFF","\x84"],"\x96"=>["\x01","\xFF","\xFF","\x88"],"\x97"=>["\x01","\xFF","\xFF","\x8C"],"\x98"=>["\x01","\xFF","\xFF","\x90"],"\x99"=>["\x01","\xFF","\xFD","\xC0"],"\x9A"=>["\x01","\xFF","\xFE","\xC0"],"\x9B"=>["\x01","\xFF","\xFF","\x94"],"\x9C"=>["\x01","\xFF","\xFE","\xC8"],"\x9D"=>["\x01","\xFF","\xFF","\x98"],"\x9E"=>["\x01","\xFF","\xFF","\x9C"],"\x9F"=>["\x01","\xFF","\xFF","\xDE"],"\xA0"=>["\x01","\xFF","\xFE","\xD0"],"\xA1"=>["\x01","\xFF","\xFD","\xD0"],"\xA2"=>["\x01","\xFF","\xFD","\x20"],"\xA3"=>["\x01","\xFF","\xFE","\xD8"],"\xA4"=>["\x01","\xFF","\xFE","\xE0"],"\xA5"=>["\x01","\xFF","\xFF","\xA0"],"\xA6"=>["\x01","\xFF","\xFF","\xA4"],"\xA7"=>["\x01","\xFF","\xFD","\xE0"],"\xA8"=>["\x01","\xFF","\xFF","\xA8"],"\xA9"=>["\x01","\xFF","\xFE","\xE8"],"\xAA"=>["\x01","\xFF","\xFE","\xF0"],"\xAB"=>["\x01","\xFF","\xFF","\xE0"],"\xAC"=>["\x01","\xFF","\xFD","\xF0"],"\xAD"=>["\x01","\xFF","\xFE","\xF8"],"\xAE"=>["\x01","\xFF","\xFF","\xAC"],"\xAF"=>["\x01","\xFF","\xFF","\xB0"],"\xB0"=>["\x01","\xFF","\xFE","\x00"],"\xB1"=>["\x01","\xFF","\xFE","\x10"],"\xB2"=>["\x01","\xFF","\xFF","\x00"],"\xB3"=>["\x01","\xFF","\xFE","\x20"],"\xB4"=>["\x01","\xFF","\xFF","\xB4"],"\xB5"=>["\x01","\xFF","\xFF","\x08"],"\xB6"=>["\x01","\xFF","\xFF","\xB8"],"\xB7"=>["\x01","\xFF","\xFF","\xBC"],"\xB8"=>["\x01","\xFF","\xFD","\x40"],"\xB9"=>["\x01","\xFF","\xFF","\x10"],"\xBA"=>["\x01","\xFF","\xFF","\x18"],"\xBB"=>["\x01","\xFF","\xFF","\x20"],"\xBC"=>["\x01","\xFF","\xFF","\xC0"],"\xBD"=>["\x01","\xFF","\xFF","\x28"],"\xBE"=>["\x01","\xFF","\xFF","0"],"\xBF"=>["\x01","\xFF","\xFF","\xC4"],"\xC0"=>["\x01","\xFF","\xFF","\xF0","\x00"],"\xC1"=>["\x01","\xFF","\xFF","\xF0","\x80"],"\xC2"=>["\x01","\xFF","\xFD","\x60"],"\xC3"=>["\x01","\xFF","\xFC","\x40"],"\xC4"=>["\x01","\xFF","\xFF","8"],"\xC5"=>["\x01","\xFF","\xFF","\xC8"],"\xC6"=>["\x01","\xFF","\xFF","\x40"],"\xC7"=>["\x01","\xFF","\xFF","\xEC"],"\xC8"=>["\x01","\xFF","\xFF","\xF1","\x00"],"\xC9"=>["\x01","\xFF","\xFF","\xF1","\x80"],"\xCA"=>["\x01","\xFF","\xFF","\xF2","\x00"],"\xCB"=>["\x01","\xFF","\xFF","\xF7","\x80"],"\xCC"=>["\x01","\xFF","\xFF","\xF7","\xC0"],"\xCD"=>["\x01","\xFF","\xFF","\xF2","\x80"],"\xCE"=>["\x01","\xFF","\xFF","\xE2"],"\xCF"=>["\x01","\xFF","\xFF","\xED"],"\xD0"=>["\x01","\xFF","\xFC","\x80"],"\xD1"=>["\x01","\xFF","\xFE","0"],"\xD2"=>["\x01","\xFF","\xFF","\xF3","\x00"],"\xD3"=>["\x01","\xFF","\xFF","\xF8","\x00"],"\xD4"=>["\x01","\xFF","\xFF","\xF8","\x40"],"\xD5"=>["\x01","\xFF","\xFF","\xF3","\x80"],"\xD6"=>["\x01","\xFF","\xFF","\xF8","\x80"],"\xD7"=>["\x01","\xFF","\xFF","\xE4"],"\xD8"=>["\x01","\xFF","\xFE","\x40"],"\xD9"=>["\x01","\xFF","\xFE","P"],"\xDA"=>["\x01","\xFF","\xFF","\xF4","\x00"],"\xDB"=>["\x01","\xFF","\xFF","\xF4","\x80"],"\xDC"=>["\x01","\xFF","\xFF","\xFF","\xA0"],"\xDD"=>["\x01","\xFF","\xFF","\xF8","\xC0"],"\xDE"=>["\x01","\xFF","\xFF","\xF9","\x00"],"\xDF"=>["\x01","\xFF","\xFF","\xF9","\x40"],"\xE0"=>["\x01","\xFF","\xFD","\x80"],"\xE1"=>["\x01","\xFF","\xFF","\xE6"],"\xE2"=>["\x01","\xFF","\xFD","\xA0"],"\xE3"=>["\x01","\xFF","\xFE","\x60"],"\xE4"=>["\x01","\xFF","\xFF","H"],"\xE5"=>["\x01","\xFF","\xFE","p"],"\xE6"=>["\x01","\xFF","\xFE","\x80"],"\xE7"=>["\x01","\xFF","\xFF","\xCC"],"\xE8"=>["\x01","\xFF","\xFF","P"],"\xE9"=>["\x01","\xFF","\xFF","X"],"\xEA"=>["\x01","\xFF","\xFF","\xEE"],"\xEB"=>["\x01","\xFF","\xFF","\xEF"],"\xEC"=>["\x01","\xFF","\xFF","\xE8"],"\xED"=>["\x01","\xFF","\xFF","\xEA"],"\xEE"=>["\x01","\xFF","\xFF","\xF5","\x00"],"\xEF"=>["\x01","\xFF","\xFF","\xD0"],"\xF0"=>["\x01","\xFF","\xFF","\xF5","\x80"],"\xF1"=>["\x01","\xFF","\xFF","\xF9","\x80"],"\xF2"=>["\x01","\xFF","\xFF","\xF6","\x00"],"\xF3"=>["\x01","\xFF","\xFF","\xF6","\x80"],"\xF4"=>["\x01","\xFF","\xFF","\xF9","\xC0"],"\xF5"=>["\x01","\xFF","\xFF","\xFA","\x00"],"\xF6"=>["\x01","\xFF","\xFF","\xFA","\x40"],"\xF7"=>["\x01","\xFF","\xFF","\xFA","\x80"],"\xF8"=>["\x01","\xFF","\xFF","\xFA","\xC0"],"\xF9"=>["\x01","\xFF","\xFF","\xFF","\xC0"],"\xFA"=>["\x01","\xFF","\xFF","\xFB","\x00"],"\xFB"=>["\x01","\xFF","\xFF","\xFB","\x40"],"\xFC"=>["\x01","\xFF","\xFF","\xFB","\x80"],"\xFD"=>["\x01","\xFF","\xFF","\xFB","\xC0"],"\xFE"=>["\x01","\xFF","\xFF","\xFC","\x00"],"\xFF"=>["\x01","\xFF","\xFF","\xF7","\x00"],],]; implementation = new HPackNghttp2($tableSizeLimit); } else { $this->implementation = new HPackNative($tableSizeLimit); } } /** * @param string $input Input to decode. * @param int $maxSize Maximum deflated size. * * @return array|null Decoded headers. */ public function decode(string $input, int $maxSize): ?array { return $this->implementation->decode($input, $maxSize); } /** * @param array $headers Headers to encode. * * @return string Encoded headers. * * @throws HPackException If encoding fails. */ public function encode(array $headers): string { return $this->implementation->encode($headers); } } sharedState = $sharedState = new class { use Struct; /** @var string[] */ public $cache = []; /** @var int[] */ public $cacheTimeouts = []; /** @var bool */ public $isSortNeeded = false; public function collectGarbage(): void { $now = \time(); if ($this->isSortNeeded) { \asort($this->cacheTimeouts); $this->isSortNeeded = false; } foreach ($this->cacheTimeouts as $key => $expiry) { if ($now <= $expiry) { break; } unset( $this->cache[$key], $this->cacheTimeouts[$key] ); } } }; $this->ttlWatcherId = Loop::repeat($gcInterval, [$sharedState, "collectGarbage"]); $this->maxSize = $maxSize; Loop::unreference($this->ttlWatcherId); } public function __destruct() { $this->sharedState->cache = []; $this->sharedState->cacheTimeouts = []; Loop::cancel($this->ttlWatcherId); } /** @inheritdoc */ public function get(string $key): Promise { if (!isset($this->sharedState->cache[$key])) { return new Success(null); } if (isset($this->sharedState->cacheTimeouts[$key]) && \time() > $this->sharedState->cacheTimeouts[$key]) { unset( $this->sharedState->cache[$key], $this->sharedState->cacheTimeouts[$key] ); return new Success(null); } return new Success($this->sharedState->cache[$key]); } /** @inheritdoc */ public function set(string $key, string $value, int $ttl = null): Promise { if ($ttl === null) { unset($this->sharedState->cacheTimeouts[$key]); } elseif ($ttl >= 0) { $expiry = \time() + $ttl; $this->sharedState->cacheTimeouts[$key] = $expiry; $this->sharedState->isSortNeeded = true; } else { throw new \Error("Invalid cache TTL ({$ttl}; integer >= 0 or null required"); } unset($this->sharedState->cache[$key]); if (\count($this->sharedState->cache) === $this->maxSize) { \array_shift($this->sharedState->cache); } $this->sharedState->cache[$key] = $value; /** @var Promise */ return new Success; } /** @inheritdoc */ public function delete(string $key): Promise { $exists = isset($this->sharedState->cache[$key]); unset( $this->sharedState->cache[$key], $this->sharedState->cacheTimeouts[$key] ); return new Success($exists); } } cache = $cache; $this->keyPrefix = $keyPrefix; } /** * Gets the specified key prefix. * * @return string */ public function getKeyPrefix(): string { return $this->keyPrefix; } /** @inheritdoc */ public function get(string $key): Promise { return $this->cache->get($this->keyPrefix . $key); } /** @inheritdoc */ public function set(string $key, string $value, int $ttl = null): Promise { return $this->cache->set($this->keyPrefix . $key, $value, $ttl); } /** @inheritdoc */ public function delete(string $key): Promise { return $this->cache->delete($this->keyPrefix . $key); } } */ private $cache; /** @var KeyedMutex */ private $mutex; /** * @param SerializedCache $cache * @param KeyedMutex $mutex */ public function __construct(SerializedCache $cache, KeyedMutex $mutex) { $this->cache = $cache; $this->mutex = $mutex; } /** * Obtains the lock for the given key, then invokes the $create callback with the current cached value (which may * be null if the key did not exist in the cache). The value returned from the callback is stored in the cache and * the promise returned from this method is resolved with the value. * * @param string $key * @param callable(string, mixed|null): mixed $create Receives $key and $value as parameters. * @param int|null $ttl Timeout in seconds. The default `null` $ttl value indicates no timeout. * * @return Promise * * @psalm-param callable(string, TValue|null):(TValue|Promise|\Generator) * $create * @psalm-return Promise * * @throws CacheException If the $create callback throws an exception while generating the value. * @throws SerializationException If serializing the value returned from the callback fails. */ public function compute(string $key, callable $create, ?int $ttl = null): Promise { return call(function () use ($key, $create, $ttl): \Generator { $lock = yield from $this->lock($key); \assert($lock instanceof Lock); try { $value = yield $this->cache->get($key); return yield from $this->create($create, $key, $value, $ttl); } finally { $lock->release(); } }); } /** * Attempts to get the value for the given key. If the key is not found, the key is locked, the $create callback * is invoked with the key as the first parameter. The value returned from the callback is stored in the cache and * the promise returned from this method is resolved with the value. * * @param string $key Cache key. * @param callable(string): mixed $create Receives $key as parameter. * @param int|null $ttl Timeout in seconds. The default `null` $ttl value indicates no timeout. * * @return Promise * * @psalm-param callable(string, TValue|null):(TValue|Promise|\Generator) * $create * @psalm-return Promise * * @throws CacheException If the $create callback throws an exception while generating the value. * @throws SerializationException If serializing the value returned from the callback fails. */ public function computeIfAbsent(string $key, callable $create, ?int $ttl = null): Promise { return call(function () use ($key, $create, $ttl): \Generator { $value = yield $this->cache->get($key); if ($value !== null) { return $value; } $lock = yield from $this->lock($key); \assert($lock instanceof Lock); try { // Attempt to get the value again, since it may have been set while obtaining the lock. $value = yield $this->cache->get($key); if ($value !== null) { return $value; } return yield from $this->create($create, $key, null, $ttl); } finally { $lock->release(); } }); } /** * Attempts to get the value for the given key. If the key exists, the key is locked, the $create callback * is invoked with the key as the first parameter and the current key value as the second parameter. The value * returned from the callback is stored in the cache and the promise returned from this method is resolved with * the value. * * @param string $key Cache key. * @param callable(string, mixed): mixed $create Receives $key and $value as parameters. * @param int|null $ttl Timeout in seconds. The default `null` $ttl value indicates no timeout. * * @return Promise * * @psalm-param callable(string, TValue|null): (TValue|Promise|\Generator) $create * @psalm-return Promise * * @throws CacheException If the $create callback throws an exception while generating the value. * @throws SerializationException If serializing the value returned from the callback fails. */ public function computeIfPresent(string $key, callable $create, ?int $ttl = null): Promise { return call(function () use ($key, $create, $ttl): \Generator { $value = yield $this->cache->get($key); if ($value === null) { return null; } $lock = yield from $this->lock($key); \assert($lock instanceof Lock); try { // Attempt to get the value again, since it may have been set while obtaining the lock. $value = yield $this->cache->get($key); if ($value === null) { return null; } return yield from $this->create($create, $key, $value, $ttl); } finally { $lock->release(); } }); } /** * The lock is obtained for the key before setting the value. * * @param string $key Cache key. * @param mixed $value Value to cache. * @param int|null $ttl Timeout in seconds. The default `null` $ttl value indicates no timeout. * * @return Promise Resolves either successfully or fails with a CacheException on failure. * * @psalm-param TValue $value * @psalm-return Promise * * @throws CacheException * @throws SerializationException * * @see SerializedCache::set() */ public function set(string $key, $value, ?int $ttl = null): Promise { return call(function () use ($key, $value, $ttl): \Generator { $lock = yield from $this->lock($key); \assert($lock instanceof Lock); try { yield $this->cache->set($key, $value, $ttl); } finally { $lock->release(); } }); } /** * Returns the cached value for the key or the given default value if the key does not exist. * * @template TDefault * * @param string $key Cache key. * @param mixed $default Default value returned if the key does not exist. Null by default. * * @return Promise Resolved with null iff $default is null. * * @psalm-param TDefault $default * @psalm-return Promise * * @throws CacheException * @throws SerializationException * * @see SerializedCache::get() */ public function get(string $key, $default = null): Promise { return call(function () use ($key, $default): \Generator { $value = yield $this->cache->get($key); if ($value === null) { return $default; } return $value; }); } /** * The lock is obtained for the key before deleting the key. * * @param string $key * * @return Promise * * @see SerializedCache::delete() */ public function delete(string $key): Promise { return call(function () use ($key): \Generator { $lock = yield from $this->lock($key); \assert($lock instanceof Lock); try { return yield $this->cache->delete($key); } finally { $lock->release(); } }); } private function lock(string $key): \Generator { try { return yield $this->mutex->acquire($key); } catch (\Throwable $exception) { throw new CacheException( \sprintf('Exception thrown when obtaining the lock for key "%s"', $key), 0, $exception ); } } /** * @psalm-param TValue|null $value * @psalm-return \Generator */ private function create(callable $create, string $key, $value, ?int $ttl): \Generator { try { $value = yield call($create, $key, $value); } catch (\Throwable $exception) { throw new CacheException( \sprintf('Exception thrown while creating the value for key "%s"', $key), 0, $exception ); } yield $this->cache->set($key, $value, $ttl); return $value; } } */ return new Success; } /** @inheritdoc */ public function delete(string $key): Promise { return new Success(false); } } Resolves to the cached value nor `null` if it doesn't exist or fails with a * CacheException on failure. */ public function get(string $key): Promise; /** * Sets a value associated with the given key. Overrides existing values (if they exist). * * The eventual resolution value of the resulting promise is unimportant. The success or failure of the promise * indicates the operation's success. * * @param $key string Cache key. * @param $value string Value to cache. * @param $ttl int Timeout in seconds. The default `null` $ttl value indicates no timeout. Values less than 0 MUST * throw an \Error. * * @return Promise Resolves either successfully or fails with a CacheException on failure. */ public function set(string $key, string $value, int $ttl = null): Promise; /** * Deletes a value associated with the given key if it exists. * * Implementations SHOULD return boolean `true` or `false` to indicate whether the specified key existed at the time * the delete operation was requested. If such information is not available, the implementation MUST resolve the * promise with `null`. * * Implementations MUST transparently succeed operations for non-existent keys. * * @param $key string Cache key. * * @return Promise Resolves to `true` / `false` to indicate whether the key existed or fails with a * CacheException on failure. May also resolve with `null` if that information is not available. */ public function delete(string $key): Promise; } cache = $cache; $this->serializer = $serializer; } /** * Fetch a value from the cache and unserialize it. * * @param $key string Cache key. * * @return Promise Resolves to the cached value or `null` if it doesn't exist. Fails with a * CacheException or SerializationException on failure. * * @psalm-return Promise * * @see Cache::get() */ public function get(string $key): Promise { return call(function () use ($key) { $data = yield $this->cache->get($key); if ($data === null) { return null; } return $this->serializer->unserialize($data); }); } /** * Serializes a value and stores its serialization to the cache. * * @param $key string Cache key. * @param $value mixed Value to cache. * @param $ttl int Timeout in seconds. The default `null` $ttl value indicates no timeout. Values less than 0 MUST * throw an \Error. * * @psalm-param TValue $value * * @return Promise Resolves either successfully or fails with a CacheException or SerializationException. * * @see Cache::set() */ public function set(string $key, $value, int $ttl = null): Promise { if ($value === null) { return new Failure(new CacheException('Cannot store NULL in serialized cache')); } try { $value = $this->serializer->serialize($value); } catch (SerializationException $exception) { return new Failure($exception); } return $this->cache->set($key, $value, $ttl); } /** * Deletes a value associated with the given key if it exists. * * @param $key string Cache key. * * @return Promise Resolves to `true` / `false` to indicate whether the key existed or fails with a * CacheException on failure. May also resolve with `null` if that information is not available. * * @see Cache::delete() */ public function delete(string $key): Promise { return $this->cache->delete($key); } } directory = $directory = \rtrim($directory, "/\\"); $this->mutex = $mutex; if (!\interface_exists(Driver::class)) { throw new \Error(__CLASS__ . ' requires amphp/file to be installed'); } $this->ampFileVersion2 = $ampFileVersion2 = \function_exists('Amp\File\listFiles'); $gcWatcher = static function () use ($directory, $mutex, $ampFileVersion2): \Generator { try { /** @psalm-suppress UndefinedFunction */ $files = yield $ampFileVersion2 ? File\listFiles($directory) : File\scandir($directory); foreach ($files as $file) { if (\strlen($file) !== 70 || \substr($file, -\strlen('.cache')) !== '.cache') { continue; } /** @var Lock $lock */ $lock = yield $mutex->acquire($file); try { /** @var File\File $handle */ /** @psalm-suppress UndefinedFunction */ $handle = yield $ampFileVersion2 ? File\openFile($directory . '/' . $file, 'r') : File\open($directory . '/' . $file, 'r'); $ttl = yield $handle->read(4); if ($ttl === null || \strlen($ttl) !== 4) { yield $handle->close(); continue; } $ttl = \unpack('Nttl', $ttl)['ttl']; if ($ttl < \time()) { /** @psalm-suppress UndefinedFunction */ yield $ampFileVersion2 ? File\deleteFile($directory . '/' . $file) : File\unlink($directory . '/' . $file); } } catch (\Throwable $e) { // ignore } finally { $lock->release(); } } } catch (\Throwable $e) { // ignore } }; // trigger once, so short running scripts also GC and don't grow forever Loop::defer($gcWatcher); $this->gcWatcher = Loop::repeat(300000, $gcWatcher); } public function __destruct() { if ($this->gcWatcher !== null) { Loop::cancel($this->gcWatcher); } } /** @inheritdoc */ public function get(string $key): Promise { return call(function () use ($key) { $filename = $this->getFilename($key); /** @var Lock $lock */ $lock = yield $this->mutex->acquire($filename); try { /** @psalm-suppress UndefinedFunction */ $cacheContent = yield $this->ampFileVersion2 ? File\read($this->directory . '/' . $filename) : File\get($this->directory . '/' . $filename); if (\strlen($cacheContent) < 4) { return null; } $ttl = \unpack('Nttl', \substr($cacheContent, 0, 4))['ttl']; if ($ttl < \time()) { /** @psalm-suppress UndefinedFunction */ yield $this->ampFileVersion2 ? File\deleteFile($this->directory . '/' . $filename) : File\unlink($this->directory . '/' . $filename); return null; } $value = \substr($cacheContent, 4); \assert(\is_string($value)); return $value; } catch (\Throwable $e) { return null; } finally { $lock->release(); } }); } /** @inheritdoc */ public function set(string $key, string $value, int $ttl = null): Promise { if ($ttl < 0) { throw new \Error("Invalid cache TTL ({$ttl}); integer >= 0 or null required"); } return call(function () use ($key, $value, $ttl) { $filename = $this->getFilename($key); /** @var Lock $lock */ $lock = yield $this->mutex->acquire($filename); if ($ttl === null) { $ttl = \PHP_INT_MAX; } else { $ttl = \time() + $ttl; } $encodedTtl = \pack('N', $ttl); try { /** @psalm-suppress UndefinedFunction */ yield $this->ampFileVersion2 ? File\write($this->directory . '/' . $filename, $encodedTtl . $value) : File\put($this->directory . '/' . $filename, $encodedTtl . $value); } finally { $lock->release(); } }); } /** @inheritdoc */ public function delete(string $key): Promise { return call(function () use ($key) { $filename = $this->getFilename($key); /** @var Lock $lock */ $lock = yield $this->mutex->acquire($filename); try { /** @psalm-suppress UndefinedFunction */ return yield $this->ampFileVersion2 ? File\deleteFile($this->directory . '/' . $filename) : File\unlink($this->directory . '/' . $filename); } finally { $lock->release(); } }); } } { "name": "amphp/cache", "homepage": "https://github.com/amphp/cache", "description": "A promise-aware caching API for Amp.", "license": "MIT", "support": { "issues": "https://github.com/amphp/cache/issues", "irc": "irc://irc.freenode.org/amphp" }, "authors": [ { "name": "Niklas Keller", "email": "me@kelunik.com" }, { "name": "Daniel Lowrey", "email": "rdlowrey@php.net" } ], "require": { "php": ">=7.1", "amphp/amp": "^2", "amphp/serialization": "^1", "amphp/sync": "^1.2" }, "require-dev": { "amphp/phpunit-util": "^1.1", "phpunit/phpunit": "^6 | ^7 | ^8 | ^9", "amphp/php-cs-fixer-config": "dev-master", "amphp/file": "^1 || ^2", "vimeo/psalm": "^4" }, "autoload": { "psr-4": { "Amp\\Cache\\": "lib" } }, "autoload-dev": { "psr-4": { "Amp\\Cache\\Test\\": "test" } }, "conflict": { "amphp/file": "<0.2 || >=3" } } assertSame('SELECT * FROM foo', $error->getQuery()); $this->assertStringStartsWith("Amp\Sql\QueryError: error\nCurrent query was SELECT * FROM foo", (string) $error); } } { "name": "amphp/sql", "description": "Asynchronous SQL client for Amp.", "keywords": [ "database", "db", "sql", "asynchronous", "async" ], "homepage": "http://amphp.org", "license": "MIT", "require": { "php": ">=7.1", "amphp/amp": "^2" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master", "phpunit/phpunit": "^8" }, "autoload": { "psr-4": { "Amp\\Sql\\": "src" } }, "autoload-dev": { "psr-4": { "Amp\\Sql\\Test\\": "test" } }, "config": { "platform": { "php": "7.2.0" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "php-cs-fixer fix -v --diff --dry-run", "cs-fix": "php-cs-fixer fix -v --diff", "test": "phpunit --coverage-text" } } */ public function execute(array $params = []): Promise; /** * @return string The SQL string used to prepare the statement. */ public function getQuery(): string; } 'host', 'username' => 'user', 'pass' => 'password', 'database' => 'db', 'dbname' => 'db', ]; /** @var string */ private $host; /** @var int */ private $port; /** @var string|null */ private $user; /** @var string|null */ private $password; /** @var string|null */ private $database; /** * Parses a connection string into an array of keys and values given. * * @param string $connectionString * @param string[] $keymap Map of alternative key names to canonical key names. * * @return string[] */ protected static function parseConnectionString(string $connectionString, array $keymap = self::KEY_MAP): array { $values = []; $params = \explode(";", $connectionString); if (\count($params) === 1) { // Attempt to explode on a space if no ';' are found. $params = \explode(" ", $connectionString); } foreach ($params as $param) { list($key, $value) = \array_map("trim", \explode("=", $param, 2) + [1 => '']); if (isset($keymap[$key])) { $key = $keymap[$key]; } $values[$key] = $value; } if (\preg_match('/^(.+):(\d{1,5})$/', $values["host"] ?? "", $matches)) { $values["host"] = $matches[1]; $values["port"] = $matches[2]; } return $values; } public function __construct(string $host, int $port, string $user = null, string $password = null, string $database = null) { $this->host = $host; $this->port = $port; $this->user = $user; $this->password = $password; $this->database = $database; } final public function getHost(): string { return $this->host; } final public function withHost(string $host): self { $new = clone $this; $new->host = $host; return $new; } final public function getPort(): int { return $this->port; } final public function withPort(int $port): self { $new = clone $this; $new->port = $port; return $new; } /** * @return string|null */ final public function getUser() /* : ?string */ { return $this->user; } final public function withUser(string $user = null): self { $new = clone $this; $new->user = $user; return $new; } /** * @return string|null */ final public function getPassword() /* : ?string */ { return $this->password; } final public function withPassword(string $password = null): self { $new = clone $this; $new->password = $password; return $new; } /** * @return string|null */ final public function getDatabase() /* : ?string */ { return $this->database; } final public function withDatabase(string $database = null): self { $new = clone $this; $new->database = $database; return $new; } } */ public function beginTransaction(int $isolation = Transaction::ISOLATION_COMMITTED): Promise; } * * @throws FailureException If the operation fails due to unexpected condition. * @throws ConnectionException If the connection to the database is lost. * @throws QueryError If the operation fails due to an error in the query (such as a syntax error). */ public function query(string $sql): Promise; /** * @param string $sql SQL query to prepare. * * @return Promise * * @throws FailureException If the operation fails due to unexpected condition. * @throws ConnectionException If the connection to the database is lost. * @throws QueryError If the operation fails due to an error in the query (such as a syntax error). */ public function prepare(string $sql): Promise; /** * @param string $sql SQL query to prepare and execute. * @param mixed[] $params Query parameters. * * @return Promise * * @throws FailureException If the operation fails due to unexpected condition. * @throws ConnectionException If the connection to the database is lost. * @throws QueryError If the operation fails due to an error in the query (such as a syntax error). */ public function execute(string $sql, array $params = []): Promise; /** * Closes the executor. No further queries may be performed. */ public function close(); } */ public function connect(ConnectionConfig $config): Promise; } * * @throws TransactionError If the transaction has been committed or rolled back. */ public function commit(): Promise; /** * Rolls back the transaction and makes it inactive. * * @return Promise * * @throws TransactionError If the transaction has been committed or rolled back. */ public function rollback(): Promise; /** * Creates a savepoint with the given identifier. * * @param string $identifier Savepoint identifier. * * @return Promise * * @throws TransactionError If the transaction has been committed or rolled back. */ public function createSavepoint(string $identifier): Promise; /** * Rolls back to the savepoint with the given identifier. * * @param string $identifier Savepoint identifier. * * @return Promise * * @throws TransactionError If the transaction has been committed or rolled back. */ public function rollbackTo(string $identifier): Promise; /** * Releases the savepoint with the given identifier. * * @param string $identifier Savepoint identifier. * * @return Promise * * @throws TransactionError If the transaction has been committed or rolled back. */ public function releaseSavepoint(string $identifier): Promise; } query = $query; } parent::__construct($message, 0, $previous); } final public function getQuery(): string { return $this->query; } public function __toString(): string { if ($this->query === "") { return parent::__toString(); } $msg = $this->message; $this->message .= "\nCurrent query was {$this->query}"; $str = parent::__toString(); $this->message = $msg; return $str; } } */ public function extractConnection(): Promise; /** * @return int Total number of active connections in the pool. */ public function getConnectionCount(): int; /** * @return int Total number of idle connections in the pool. */ public function getIdleConnectionCount(): int; /** * @return int Maximum number of connections this pool will create. */ public function getConnectionLimit(): int; /** * @return int Number of seconds a connection may remain idle before it is automatically closed. */ public function getIdleTimeout(): int; } hostLoader = $hostLoader ?? new HostLoader; } public function loadConfig(): Promise { return call(function () { $keys = [ "HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\Tcpip\\Parameters\\NameServer", "HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\Tcpip\\Parameters\\DhcpNameServer", ]; $reader = new WindowsRegistry; $nameserver = ""; while ($nameserver === "" && ($key = \array_shift($keys))) { try { $nameserver = yield $reader->read($key); } catch (KeyNotFoundException $e) { // retry other possible locations } } if ($nameserver === "") { $interfaces = "HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\Tcpip\\Parameters\\Interfaces"; $subKeys = yield $reader->listKeys($interfaces); foreach ($subKeys as $key) { foreach (["NameServer", "DhcpNameServer"] as $property) { try { $nameserver = yield $reader->read("{$key}\\{$property}"); if ($nameserver !== "") { break 2; } } catch (KeyNotFoundException $e) { // retry other possible locations } } } } if ($nameserver === "") { throw new ConfigException("Could not find a nameserver in the Windows Registry"); } $nameservers = []; // Microsoft documents space as delimiter, AppVeyor uses comma, we just accept both foreach (\explode(" ", \strtr($nameserver, ",", " ")) as $nameserver) { $nameserver = \trim($nameserver); $ip = @\inet_pton($nameserver); if ($ip === false) { continue; } if (isset($ip[15])) { // IPv6 $nameservers[] = "[" . $nameserver . "]:53"; } else { // IPv4 $nameservers[] = $nameserver . ":53"; } } $hosts = yield $this->hostLoader->loadHosts(); return new Config($nameservers, $hosts); }); } } query($name, Record::A); } public function query(string $name, int $type): Promise { if ($type !== Record::A) { return new Failure(new DnsException("Query for '{$name}' failed, because loading the system's DNS configuration failed and querying records other than A records isn't supported in blocking fallback mode.")); } $result = \gethostbynamel($name); if ($result === false) { return new Failure(new DnsException("Query for '{$name}' failed, because loading the system's DNS configuration failed and blocking fallback via gethostbynamel() failed, too.")); } if ($result === []) { return new Failure(new NoRecordException("No records returned for '{$name}' using blocking fallback mode.")); } $records = []; foreach ($result as $record) { $records[] = new Record($record, Record::A, null); } return new Success($records); } } validateNameserver($nameserver); } if ($timeout < 0) { throw new ConfigException("Invalid timeout ({$timeout}), must be 0 or greater"); } if ($attempts < 1) { throw new ConfigException("Invalid attempt count ({$attempts}), must be 1 or greater"); } // Windows does not include localhost in its host file. Fetch it from the system instead if (!isset($knownHosts[Record::A]["localhost"]) && !isset($knownHosts[Record::AAAA]["localhost"])) { // PHP currently provides no way to **resolve** IPv6 hostnames (not even with fallback) $local = \gethostbyname("localhost"); if ($local !== "localhost") { $knownHosts[Record::A]["localhost"] = $local; } else { $knownHosts[Record::AAAA]["localhost"] = '::1'; } } $this->nameservers = $nameservers; $this->knownHosts = $knownHosts; $this->timeout = $timeout; $this->attempts = $attempts; } public function withSearchList(array $searchList): self { $self = clone $this; $self->searchList = $searchList; return $self; } /** * @throws ConfigException */ public function withNdots(int $ndots): self { if ($ndots < 0) { throw new ConfigException("Invalid ndots ({$ndots}), must be greater or equal to 0"); } if ($ndots > 15) { $ndots = 15; } $self = clone $this; $self->ndots = $ndots; return $self; } public function withRotationEnabled(bool $enabled = true): self { $self = clone $this; $self->rotation = $enabled; return $self; } private function validateNameserver($nameserver) { if (!$nameserver || !\is_string($nameserver)) { throw new ConfigException("Invalid nameserver: {$nameserver}"); } if ($nameserver[0] === "[") { // IPv6 $addr = \strstr(\substr($nameserver, 1), "]", true); $port = \substr($nameserver, \strrpos($nameserver, "]") + 1); if ($port !== "" && !\preg_match("(^:(\\d+)$)", $port, $match)) { throw new ConfigException("Invalid nameserver: {$nameserver}"); } $port = $port === "" ? 53 : \substr($port, 1); } else { // IPv4 $arr = \explode(":", $nameserver, 2); if (\count($arr) === 2) { list($addr, $port) = $arr; } else { $addr = $arr[0]; $port = 53; } } $addr = \trim($addr, "[]"); $port = (int) $port; if (!$inAddr = @\inet_pton($addr)) { throw new ConfigException("Invalid server IP: {$addr}"); } if ($port < 1 || $port > 65535) { throw new ConfigException("Invalid server port: {$port}"); } } public function getNameservers(): array { return $this->nameservers; } public function getKnownHosts(): array { return $this->knownHosts; } public function getTimeout(): int { return $this->timeout; } public function getAttempts(): int { return $this->attempts; } public function getSearchList(): array { return $this->searchList; } public function getNdots(): int { return $this->ndots; } public function isRotationEnabled(): bool { return $this->rotation; } } self::DEFAULT_TIMEOUT, "attempts" => self::DEFAULT_ATTEMPTS, "ndots" => self::DEFAULT_NDOTS, "rotate" => false, ]; private $path; private $hostLoader; public function __construct(string $path = "/etc/resolv.conf", HostLoader $hostLoader = null) { $this->path = $path; $this->hostLoader = $hostLoader ?? new HostLoader; } protected function readFile(string $path): Promise { \set_error_handler(function (int $errno, string $message) use ($path) { throw new ConfigException("Could not read configuration file '{$path}' ({$errno}) $message"); }); try { // Blocking file access, but this file should be local and usually loaded only once. $fileContent = \file_get_contents($path); } catch (ConfigException $exception) { return new Failure($exception); } finally { \restore_error_handler(); } return new Success($fileContent); } final public function loadConfig(): Promise { return call(function () { $nameservers = []; $searchList = []; $options = self::DEFAULT_OPTIONS; $haveLocaldomainEnv = false; /* Allow user to override the local domain definition. */ if ($localdomain = \getenv("LOCALDOMAIN")) { /* Set search list to be blank-separated strings from rest of env value. Permits users of LOCALDOMAIN to still have a search list, and anyone to set the one that they want to use as an individual (even more important now that the rfc1535 stuff restricts searches). */ $searchList = $this->splitOnWhitespace($localdomain); $haveLocaldomainEnv = true; } $fileContent = yield $this->readFile($this->path); $lines = \explode("\n", $fileContent); foreach ($lines as $line) { $line = \preg_split('#\s+#', $line, 2); if (\count($line) !== 2) { continue; } list($type, $value) = $line; if ($type === "nameserver") { if (\count($nameservers) === self::MAX_NAMESERVERS) { continue; } $value = \trim($value); $ip = @\inet_pton($value); if ($ip === false) { continue; } if (isset($ip[15])) { // IPv6 $nameservers[] = "[" . $value . "]:53"; } else { // IPv4 $nameservers[] = $value . ":53"; } } elseif ($type === "domain" && !$haveLocaldomainEnv) { // LOCALDOMAIN env overrides config $searchList = $this->splitOnWhitespace($value); } elseif ($type === "search" && !$haveLocaldomainEnv) { // LOCALDOMAIN env overrides config $searchList = $this->splitOnWhitespace($value); } elseif ($type === "options") { $option = $this->parseOption($value); if (\count($option) === 2) { $options[$option[0]] = $option[1]; } } } $hosts = yield $this->hostLoader->loadHosts(); if (\count($searchList) === 0) { $hostname = \gethostname(); $dot = \strpos(".", $hostname); if ($dot !== false && $dot < \strlen($hostname)) { $searchList = [ \substr($hostname, $dot), ]; } } if (\count($searchList) > self::MAX_DNS_SEARCH) { $searchList = \array_slice($searchList, 0, self::MAX_DNS_SEARCH); } $resOptions = \getenv("RES_OPTIONS"); if ($resOptions) { foreach ($this->splitOnWhitespace($resOptions) as $option) { $option = $this->parseOption($option); if (\count($option) === 2) { $options[$option[0]] = $option[1]; } } } $config = new Config($nameservers, $hosts, $options["timeout"], $options["attempts"]); return $config->withSearchList($searchList) ->withNdots($options["ndots"]) ->withRotationEnabled($options["rotate"]); }); } private function splitOnWhitespace(string $names): array { return \preg_split("#\s+#", \trim($names)); } private function parseOption(string $option): array { $optline = \explode(':', $option, 2); list($name, $value) = $optline + [1 => null]; switch ($name) { case "timeout": $value = (int) $value; if ($value < 0) { return []; // don't overwrite option value } // The value for this option is silently capped to 30s return ["timeout", (int) \min($value * 1000, self::MAX_TIMEOUT)]; case "attempts": $value = (int) $value; if ($value < 0) { return []; // don't overwrite option value } // The value for this option is silently capped to 5 return ["attempts", (int) \min($value, self::MAX_ATTEMPTS)]; case "ndots": $value = (int) $value; if ($value < 0) { return []; // don't overwrite option value } // The value for this option is silently capped to 15 return ["ndots", (int) \min($value, self::MAX_NDOTS)]; case "rotate": return ["rotate", true]; } return []; } } resolve(new self($socket)); }); try { return yield Promise\timeout($deferred->promise(), $timeout); } catch (Amp\TimeoutException $e) { throw new TimeoutException("Name resolution timed out, could not connect to server at $uri"); } finally { Loop::cancel($watcher); } }); } public static function parser(callable $callback): \Generator { $decoder = (new DecoderFactory)->create(); while (true) { $length = yield 2; $length = \unpack("n", $length)[1]; $rawData = yield $length; $callback($decoder->decode($rawData)); } } protected function __construct($socket) { parent::__construct($socket); $this->encoder = (new EncoderFactory)->create(); $this->queue = new \SplQueue; $this->parser = new Parser(self::parser([$this->queue, 'push'])); } protected function send(Message $message): Promise { $data = $this->encoder->encode($message); $promise = $this->write(\pack("n", \strlen($data)) . $data); $promise->onResolve(function ($error) { if ($error) { $this->isAlive = false; } }); return $promise; } protected function receive(): Promise { if ($this->queue->isEmpty()) { return call(function () { do { $chunk = yield $this->read(); if ($chunk === null) { $this->isAlive = false; throw new DnsException("Reading from the server failed"); } $this->parser->push($chunk); } while ($this->queue->isEmpty()); return $this->queue->shift(); }); } return new Success($this->queue->shift()); } public function isAlive(): bool { return $this->isAlive; } } */ abstract public static function connect(string $uri): Promise; /** * @param Message $message * * @return Promise */ abstract protected function send(Message $message): Promise; /** * @return Promise */ abstract protected function receive(): Promise; /** * @return bool */ abstract public function isAlive(): bool; public function getLastActivity(): int { return $this->lastActivity; } protected function __construct($socket) { $this->input = new ResourceInputStream($socket); $this->output = new ResourceOutputStream($socket); $this->messageFactory = new MessageFactory; $this->lastActivity = \time(); $this->onResolve = function (\Throwable $exception = null, Message $message = null) { $this->lastActivity = \time(); $this->receiving = false; if ($exception) { $this->error($exception); return; } \assert($message instanceof Message); $id = $message->getId(); // Ignore duplicate and invalid responses. if (isset($this->pending[$id]) && $this->matchesQuestion($message, $this->pending[$id]->question)) { /** @var Deferred $deferred */ $deferred = $this->pending[$id]->deferred; unset($this->pending[$id]); $deferred->resolve($message); } if (empty($this->pending)) { $this->input->unreference(); } elseif (!$this->receiving) { $this->input->reference(); $this->receiving = true; $this->receive()->onResolve($this->onResolve); } }; } /** * @param \LibDNS\Records\Question $question * @param int $timeout * * @return \Amp\Promise<\LibDNS\Messages\Message> */ final public function ask(Question $question, int $timeout): Promise { return call(function () use ($question, $timeout) { $this->lastActivity = \time(); if (\count($this->pending) > self::MAX_CONCURRENT_REQUESTS) { $deferred = new Deferred; $this->queue[] = $deferred; yield $deferred->promise(); } do { $id = \random_int(0, 0xffff); } while (isset($this->pending[$id])); $deferred = new Deferred; $pending = new class { use Amp\Struct; public $deferred; public $question; }; $pending->deferred = $deferred; $pending->question = $question; $this->pending[$id] = $pending; $message = $this->createMessage($question, $id); try { yield $this->send($message); } catch (StreamException $exception) { $exception = new DnsException("Sending the request failed", 0, $exception); $this->error($exception); throw $exception; } $this->input->reference(); if (!$this->receiving) { $this->receiving = true; $this->receive()->onResolve($this->onResolve); } try { // Work around an OPCache issue that returns an empty array with "return yield ...", // so assign to a variable first and return after the try block. // // See https://github.com/amphp/dns/issues/58. // See https://bugs.php.net/bug.php?id=74840. $result = yield Promise\timeout($deferred->promise(), $timeout); } catch (Amp\TimeoutException $exception) { unset($this->pending[$id]); if (empty($this->pending)) { $this->input->unreference(); } throw new TimeoutException("Didn't receive a response within {$timeout} milliseconds."); } finally { if ($this->queue) { $deferred = \array_shift($this->queue); $deferred->resolve(); } } return $result; }); } final public function close() { $this->input->close(); $this->output->close(); } private function error(\Throwable $exception) { $this->close(); if (empty($this->pending)) { return; } if (!$exception instanceof DnsException) { $message = "Unexpected error during resolution: " . $exception->getMessage(); $exception = new DnsException($message, 0, $exception); } $pending = $this->pending; $this->pending = []; foreach ($pending as $pendingQuestion) { /** @var Deferred $deferred */ $deferred = $pendingQuestion->deferred; $deferred->fail($exception); } } final protected function read(): Promise { return $this->input->read(); } final protected function write(string $data): Promise { return $this->output->write($data); } final protected function createMessage(Question $question, int $id): Message { $request = $this->messageFactory->create(MessageTypes::QUERY); $request->getQuestionRecords()->add($question); $request->isRecursionDesired(true); $request->setID($id); return $request; } private function matchesQuestion(Message $message, Question $question): bool { if ($message->getType() !== MessageTypes::RESPONSE) { return false; } $questionRecords = $message->getQuestionRecords(); // We only ever ask one question at a time if (\count($questionRecords) !== 1) { return false; } $questionRecord = $questionRecords->getIterator()->current(); if ($questionRecord->getClass() !== $question->getClass()) { return false; } if ($questionRecord->getType() !== $question->getType()) { return false; } if ($questionRecord->getName()->getValue() !== $question->getName()->getValue()) { return false; } return true; } } encoder = (new EncoderFactory)->create(); $this->decoder = (new DecoderFactory)->create(); } protected function send(Message $message): Promise { $data = $this->encoder->encode($message); return $this->write($data); } protected function receive(): Promise { return call(function () { $data = yield $this->read(); if ($data === null) { throw new DnsException("Reading from the server failed"); } return $this->decoder->decode($data); }); } public function isAlive(): bool { return true; } } value = $value; $this->type = $type; $this->ttl = $ttl; } public function getValue(): string { return $this->value; } public function getType(): int { return $this->type; } public function getTtl() { return $this->ttl; } /** * Converts an record type integer back into its name as defined in this class. * * Returns "unknown ()" in case a name for this record is not known. * * @param int $type Record type as integer. * * @return string Name of the constant for this record in this class. */ public static function getName(int $type): string { static $types; if (0 > $type || 0xffff < $type) { $message = \sprintf('%d does not correspond to a valid record type (must be between 0 and 65535).', $type); throw new \Error($message); } if ($types === null) { $types = \array_flip( (new \ReflectionClass(self::class)) ->getConstants() ); } return $types[$type] ?? "unknown ({$type})"; } } resolve($name, $typeRestriction); } /** * @see Resolver::query() */ function query(string $name, int $type): Promise { return resolver()->query($name, $type); } /** * Checks whether a string is a valid DNS name. * * @param string $name String to check. * * @return bool */ function isValidName(string $name) { try { normalizeName($name); return true; } catch (InvalidNameException $e) { return false; } } /** * Normalizes a DNS name and automatically checks it for validity. * * @param string $name DNS name. * * @return string Normalized DNS name. * @throws InvalidNameException If an invalid name or an IDN name without ext/intl being installed has been passed. */ function normalizeName(string $name): string { static $pattern = '/^(?[a-z0-9]([a-z0-9-_]{0,61}[a-z0-9])?)(\.(?&name))*\.?$/i'; if (\function_exists('idn_to_ascii') && \defined('INTL_IDNA_VARIANT_UTS46')) { if (false === $result = \idn_to_ascii($name, 0, \INTL_IDNA_VARIANT_UTS46)) { throw new InvalidNameException("Name '{$name}' could not be processed for IDN."); } $name = $result; } elseif (\preg_match('/[\x80-\xff]/', $name)) { throw new InvalidNameException( "Name '{$name}' contains non-ASCII characters and IDN support is not available. " . "Verify that ext/intl is installed for IDN support and that ICU is at least version 4.6." ); } if (isset($name[253]) || !\preg_match($pattern, $name)) { throw new InvalidNameException("Name '{$name}' is not a valid hostname."); } if ($name[\strlen($name)-1] === '.') { $name = \substr($name, 0, -1); } return $name; } cache = $cache ?? new ArrayCache(5000 /* default gc interval */, 256 /* size */); $this->configLoader = $configLoader ?? (\stripos(PHP_OS, "win") === 0 ? new WindowsConfigLoader : new UnixConfigLoader); $this->questionFactory = new QuestionFactory; $this->blockingFallbackResolver = new BlockingFallbackResolver; $sockets = &$this->sockets; $this->gcWatcher = Loop::repeat(5000, static function () use (&$sockets) { if (!$sockets) { return; } $now = \time(); foreach ($sockets as $key => $server) { if ($server->getLastActivity() < $now - 60) { $server->close(); unset($sockets[$key]); } } }); Loop::unreference($this->gcWatcher); } public function __destruct() { Loop::cancel($this->gcWatcher); } /** @inheritdoc */ public function resolve(string $name, int $typeRestriction = null): Promise { if ($typeRestriction !== null && $typeRestriction !== Record::A && $typeRestriction !== Record::AAAA) { throw new \Error("Invalid value for parameter 2: null|Record::A|Record::AAAA expected"); } return call(function () use ($name, $typeRestriction) { if ($this->configStatus === self::CONFIG_NOT_LOADED) { yield $this->reloadConfig(); } if ($this->configStatus === self::CONFIG_FAILED) { return $this->blockingFallbackResolver->resolve($name, $typeRestriction); } switch ($typeRestriction) { case Record::A: if (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) { return [new Record($name, Record::A, null)]; } if (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { throw new DnsException("Got an IPv6 address, but type is restricted to IPv4"); } break; case Record::AAAA: if (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { return [new Record($name, Record::AAAA, null)]; } if (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) { throw new DnsException("Got an IPv4 address, but type is restricted to IPv6"); } break; default: if (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) { return [new Record($name, Record::A, null)]; } if (\filter_var($name, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) { return [new Record($name, Record::AAAA, null)]; } break; } $dots = \substr_count($name, "."); // Should be replaced with $name[-1] from 7.1 $trailingDot = \substr($name, -1, 1) === "."; $name = normalizeName($name); if ($records = $this->queryHosts($name, $typeRestriction)) { return $records; } // Follow RFC 6761 and never send queries for localhost to the caching DNS server // Usually, these queries are already resolved via queryHosts() if ($name === 'localhost') { return $typeRestriction === Record::AAAA ? [new Record('::1', Record::AAAA, null)] : [new Record('127.0.0.1', Record::A, null)]; } $searchList = [null]; if (!$trailingDot && $dots < $this->config->getNdots()) { $searchList = \array_merge($this->config->getSearchList(), $searchList); } foreach ($searchList as $searchIndex => $search) { for ($redirects = 0; $redirects < 5; $redirects++) { $searchName = $name; if ($search !== null) { $searchName = $name . "." . $search; } try { if ($typeRestriction) { return yield $this->query($searchName, $typeRestriction); } try { list(, $records) = yield Promise\some([ $this->query($searchName, Record::A), $this->query($searchName, Record::AAAA), ]); return \array_merge(...$records); } catch (MultiReasonException $e) { $errors = []; foreach ($e->getReasons() as $reason) { if ($reason instanceof NoRecordException) { throw $reason; } if ($searchIndex < \count($searchList) - 1 && \in_array($reason->getCode(), [2, 3], true)) { continue 2; } $errors[] = $reason->getMessage(); } throw new DnsException( "All query attempts failed for {$searchName}: " . \implode(", ", $errors), 0, $e ); } } catch (NoRecordException $e) { try { /** @var Record[] $cnameRecords */ $cnameRecords = yield $this->query($searchName, Record::CNAME); $name = $cnameRecords[0]->getValue(); continue; } catch (NoRecordException $e) { /** @var Record[] $dnameRecords */ $dnameRecords = yield $this->query($searchName, Record::DNAME); $name = $dnameRecords[0]->getValue(); continue; } } catch (DnsException $e) { if ($searchIndex < \count($searchList) - 1 && \in_array($e->getCode(), [2, 3], true)) { continue 2; } throw $e; } } } throw new DnsException("Giving up resolution of '{$searchName}', too many redirects"); }); } /** * Reloads the configuration in the background. * * Once it's finished, the configuration will be used for new requests. * * @return Promise */ public function reloadConfig(): Promise { if ($this->pendingConfig) { return $this->pendingConfig; } $promise = call(function () { try { $this->config = yield $this->configLoader->loadConfig(); $this->configStatus = self::CONFIG_LOADED; } catch (ConfigException $e) { $this->configStatus = self::CONFIG_FAILED; try { \trigger_error( "Could not load the system's DNS configuration, using synchronous, blocking fallback", \E_USER_WARNING ); } catch (\Throwable $triggerException) { \set_error_handler(null); \trigger_error( "Could not load the system's DNS configuration, using synchronous, blocking fallback", \E_USER_WARNING ); \restore_error_handler(); } } }); $this->pendingConfig = $promise; $promise->onResolve(function () { $this->pendingConfig = null; }); return $promise; } /** @inheritdoc */ public function query(string $name, int $type): Promise { $pendingQueryKey = $type . " " . $name; if (isset($this->pendingQueries[$pendingQueryKey])) { return $this->pendingQueries[$pendingQueryKey]; } $promise = call(function () use ($name, $type) { if ($this->configStatus === self::CONFIG_NOT_LOADED) { yield $this->reloadConfig(); } if ($this->configStatus === self::CONFIG_FAILED) { return $this->blockingFallbackResolver->query($name, $type); } $name = $this->normalizeName($name, $type); $question = $this->createQuestion($name, $type); if (null !== $cachedValue = yield $this->cache->get($this->getCacheKey($name, $type))) { return $this->decodeCachedResult($name, $type, $cachedValue); } $nameservers = $this->selectNameservers(); $nameserversCount = \count($nameservers); $attempts = $this->config->getAttempts(); $protocol = "udp"; $attempt = 0; /** @var Socket $socket */ $uri = $protocol . "://" . $nameservers[0]; $socket = yield $this->getSocket($uri); $attemptDescription = []; while ($attempt < $attempts) { try { if (!$socket->isAlive()) { unset($this->sockets[$uri]); $socket->close(); $uri = $protocol . "://" . $nameservers[$attempt % $nameserversCount]; $socket = yield $this->getSocket($uri); } $attemptDescription[] = $uri; /** @var Message $response */ $response = yield $socket->ask($question, $this->config->getTimeout()); $this->assertAcceptableResponse($response, $name); // UDP sockets are never reused, they're not in the $this->sockets map if ($protocol === "udp") { // Defer call, because it interferes with the unreference() call in Internal\Socket otherwise Loop::defer(static function () use ($socket) { $socket->close(); }); } if ($response->isTruncated()) { if ($protocol !== "tcp") { // Retry with TCP, don't count attempt $protocol = "tcp"; $uri = $protocol . "://" . $nameservers[$attempt % $nameserversCount]; $socket = yield $this->getSocket($uri); continue; } throw new DnsException("Server returned a truncated response for '{$name}' (" . Record::getName($type) . ")"); } $answers = $response->getAnswerRecords(); $result = []; $ttls = []; /** @var \LibDNS\Records\Resource $record */ foreach ($answers as $record) { $recordType = $record->getType(); $result[$recordType][] = (string) $record->getData(); // Cache for max one day $ttls[$recordType] = \min($ttls[$recordType] ?? 86400, $record->getTTL()); } foreach ($result as $recordType => $records) { // We don't care here whether storing in the cache fails $this->cache->set( $this->getCacheKey($name, $recordType), \json_encode($records), $ttls[$recordType] ); } if (!isset($result[$type])) { // "it MUST NOT cache it for longer than five (5) minutes" per RFC 2308 section 7.1 $this->cache->set($this->getCacheKey($name, $type), \json_encode([]), 300); throw new NoRecordException("No records returned for '{$name}' (" . Record::getName($type) . ")"); } return \array_map(static function ($data) use ($type, $ttls) { return new Record($data, $type, $ttls[$type]); }, $result[$type]); } catch (TimeoutException $e) { // Defer call, because it might interfere with the unreference() call in Internal\Socket otherwise Loop::defer(function () use ($socket, $uri) { unset($this->sockets[$uri]); $socket->close(); }); $uri = $protocol . "://" . $nameservers[++$attempt % $nameserversCount]; $socket = yield $this->getSocket($uri); continue; } } throw new TimeoutException(\sprintf( "No response for '%s' (%s) from any nameserver within %d ms after %d attempts, tried %s", $name, Record::getName($type), $this->config->getTimeout(), $attempts, \implode(", ", $attemptDescription) )); }); $this->pendingQueries[$type . " " . $name] = $promise; $promise->onResolve(function () use ($name, $type) { unset($this->pendingQueries[$type . " " . $name]); }); return $promise; } private function queryHosts(string $name, int $typeRestriction = null): array { $hosts = $this->config->getKnownHosts(); $records = []; $returnIPv4 = $typeRestriction === null || $typeRestriction === Record::A; $returnIPv6 = $typeRestriction === null || $typeRestriction === Record::AAAA; if ($returnIPv4 && isset($hosts[Record::A][$name])) { $records[] = new Record($hosts[Record::A][$name], Record::A, null); } if ($returnIPv6 && isset($hosts[Record::AAAA][$name])) { $records[] = new Record($hosts[Record::AAAA][$name], Record::AAAA, null); } return $records; } private function normalizeName(string $name, int $type) { if ($type === Record::PTR) { if (($packedIp = @\inet_pton($name)) !== false) { if (isset($packedIp[4])) { // IPv6 $name = \wordwrap(\strrev(\bin2hex($packedIp)), 1, ".", true) . ".ip6.arpa"; } else { // IPv4 $name = \inet_ntop(\strrev($packedIp)) . ".in-addr.arpa"; } } } elseif (\in_array($type, [Record::A, Record::AAAA], true)) { $name = normalizeName($name); } return $name; } /** * @param string $name * @param int $type * * @return Question */ private function createQuestion(string $name, int $type): Question { if (0 > $type || 0xffff < $type) { $message = \sprintf('%d does not correspond to a valid record type (must be between 0 and 65535).', $type); throw new \Error($message); } $question = $this->questionFactory->create($type); $question->setName($name); return $question; } private function getCacheKey(string $name, int $type): string { return self::CACHE_PREFIX . $name . "#" . $type; } private function decodeCachedResult(string $name, int $type, string $encoded): array { $decoded = \json_decode($encoded, true); if (!$decoded) { throw new NoRecordException("No records returned for {$name} (cached result)"); } $result = []; foreach ($decoded as $data) { $result[] = new Record($data, $type); } return $result; } private function getSocket($uri): Promise { // We use a new socket for each UDP request, as that increases the entropy and mitigates response forgery. if (\substr($uri, 0, 3) === "udp") { return UdpSocket::connect($uri); } // Over TCP we might reuse sockets if the server allows to keep them open. Sequence IDs in TCP are already // better than a random port. Additionally, a TCP connection is more expensive. if (isset($this->sockets[$uri])) { return new Success($this->sockets[$uri]); } if (isset($this->pendingSockets[$uri])) { return $this->pendingSockets[$uri]; } $server = TcpSocket::connect($uri); $server->onResolve(function ($error, $server) use ($uri) { unset($this->pendingSockets[$uri]); if (!$error) { $this->sockets[$uri] = $server; } }); return $server; } /** * @throws DnsException */ private function assertAcceptableResponse(Message $response, string $name) { if ($response->getResponseCode() !== 0) { // https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml $errors = [ 1 => 'FormErr', 2 => 'ServFail', 3 => 'NXDomain', 4 => 'NotImp', 5 => 'Refused', 6 => 'YXDomain', 7 => 'YXRRSet', 8 => 'NXRRSet', 9 => 'NotAuth', 10 => 'NotZone', 11 => 'DSOTYPENI', 16 => 'BADVERS', 17 => 'BADKEY', 18 => 'BADTIME', 19 => 'BADMODE', 20 => 'BADNAME', 21 => 'BADALG', 22 => 'BADTRUNC', 23 => 'BADCOOKIE', ]; throw new DnsException(\sprintf( "Name resolution failed for '%s'; server returned error code: %d (%s)", $name, $response->getResponseCode(), $errors[$response->getResponseCode()] ?? 'UNKNOWN' ), $response->getResponseCode()); } } private function selectNameservers(): array { $nameservers = $this->config->getNameservers(); if ($this->config->isRotationEnabled() && ($nameserversCount = \count($nameservers)) > 1) { $nameservers = \array_merge( \array_slice($nameservers, $this->nextNameserver), \array_slice($nameservers, 0, $this->nextNameserver) ); $this->nextNameserver = ++$this->nextNameserver % $nameserversCount; } return $nameservers; } } path = $path ?? $this->getDefaultPath(); } private function getDefaultPath(): string { return \stripos(PHP_OS, "win") === 0 ? 'C:\Windows\system32\drivers\etc\hosts' : '/etc/hosts'; } protected function readFile(string $path): Promise { \set_error_handler(function (int $errno, string $message) use ($path) { throw new ConfigException("Could not read configuration file '{$path}' ({$errno}) $message"); }); try { // Blocking file access, but this file should be local and usually loaded only once. $fileContent = \file_get_contents($path); } catch (ConfigException $exception) { return new Failure($exception); } finally { \restore_error_handler(); } return new Success($fileContent); } public function loadHosts(): Promise { return call(function () { try { $contents = yield $this->readFile($this->path); } catch (ConfigException $exception) { return []; } $data = []; $lines = \array_filter(\array_map("trim", \explode("\n", $contents))); foreach ($lines as $line) { if ($line[0] === "#") { // Skip comments continue; } $parts = \preg_split('/\s+/', $line); if (!($ip = @\inet_pton($parts[0]))) { continue; } elseif (isset($ip[4])) { $key = Record::AAAA; } else { $key = Record::A; } for ($i = 1, $l = \count($parts); $i < $l; $i++) { try { $normalizedName = normalizeName($parts[$i]); $data[$key][$normalizedName] = $parts[0]; } catch (InvalidNameException $e) { // ignore invalid entries } } } return $data; }); } } =7.0", "ext-json": "*", "amphp/amp": "^2", "amphp/byte-stream": "^1.1", "amphp/cache": "^1.2", "amphp/parser": "^1", "amphp/windows-registry": "^0.3", "daverandom/libdns": "^2.0.1", "ext-filter": "*" }, "require-dev": { "amphp/phpunit-util": "^1", "phpunit/phpunit": "^6 || ^7 || ^8 || ^9", "amphp/php-cs-fixer-config": "dev-master" }, "autoload": { "psr-4": { "Amp\\Dns\\": "lib" }, "files": [ "lib/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Dns\\Test\\": "test" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff --dry-run", "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" } } name = $name; $this->trace = $trace; } /** * @deprecated Use TaskFailureThrowable::getOriginalClassName() instead. * * Returns the class name of the error thrown from the task. * * @return string */ public function getName(): string { return $this->name; } /** * @deprecated Use TaskFailureThrowable::getOriginalTraceAsString() instead. * * Gets the stack trace at the point the error was thrown in the task. * * @return string */ public function getWorkerTrace(): string { return $this->trace; } } className = $envClassName; } /** * {@inheritdoc} * * The type of worker created depends on the extensions available. If multi-threading is enabled, a WorkerThread * will be created. If threads are not available a WorkerProcess will be created. */ public function create(): Worker { if (Parallel::isSupported()) { return new WorkerParallel($this->className); } if (Thread::isSupported()) { return new WorkerThread($this->className); } return new WorkerProcess( $this->className, [], \getenv("AMP_PHP_BINARY") ?: (\defined("AMP_PHP_BINARY") ? \AMP_PHP_BINARY : null) ); } } queue = $queue = new \SplPriorityQueue; $data = &$this->data; $this->timer = Loop::repeat(1000, static function (string $watcherId) use ($queue, &$data): void { $time = \time(); while (!$queue->isEmpty()) { list($key, $expiration) = $queue->top(); if (!isset($data[$key])) { // Item removed. $queue->extract(); continue; } $struct = $data[$key]; if ($struct->expire === 0) { // Item was set again without a TTL. $queue->extract(); continue; } if ($struct->expire !== $expiration) { // Expiration changed or TTL updated. $queue->extract(); continue; } if ($time < $struct->expire) { // Item at top has not expired, break out of loop. break; } unset($data[$key]); $queue->extract(); } if ($queue->isEmpty()) { Loop::disable($watcherId); } }); Loop::disable($this->timer); Loop::unreference($this->timer); } /** * @param string $key * * @return bool */ public function exists(string $key): bool { return isset($this->data[$key]); } /** * @param string $key * * @return mixed|null Returns null if the key does not exist. */ public function get(string $key) { if (!isset($this->data[$key])) { return null; } $struct = $this->data[$key]; if ($struct->ttl !== null) { $expire = \time() + $struct->ttl; if ($struct->expire < $expire) { $struct->expire = $expire; $this->queue->insert([$key, $struct->expire], -$struct->expire); } } return $struct->data; } /** * @param string $key * @param mixed $value Using null for the value deletes the key. * @param int $ttl Number of seconds until data is automatically deleted. Use null for unlimited TTL. * * @throws \Error If the time-to-live is not a positive integer. */ public function set(string $key, $value, int $ttl = null): void { if ($value === null) { $this->delete($key); return; } if ($ttl !== null && $ttl <= 0) { throw new \Error("The time-to-live must be a positive integer or null"); } $struct = new class { use Struct; public $data; public $expire = 0; public $ttl; }; $struct->data = $value; if ($ttl !== null) { $struct->ttl = $ttl; $struct->expire = \time() + $ttl; $this->queue->insert([$key, $struct->expire], -$struct->expire); Loop::enable($this->timer); } $this->data[$key] = $struct; } /** * @param string $key */ public function delete(string $key): void { unset($this->data[$key]); } /** * Alias of exists(). * * @param $key * * @return bool */ public function offsetExists($key): bool { return $this->exists($key); } /** * Alias of get(). * * @param string $key * * @return mixed */ #[\ReturnTypeWillChange] public function offsetGet($key) { return $this->get($key); } /** * Alias of set() with $ttl = null. * * @param string $key * @param mixed $value */ public function offsetSet($key, $value): void { $this->set($key, $value); } /** * Alias of delete(). * * @param string $key */ public function offsetUnset($key): void { $this->delete($key); } /** * Removes all values. */ public function clear(): void { $this->data = []; Loop::disable($this->timer); $this->queue = new \SplPriorityQueue; } } bindTo(null, null)(); } if (!\class_exists($className)) { throw new \Error(\sprintf("Invalid environment class name '%s'", $className)); } if (!\is_subclass_of($className, Environment::class)) { throw new \Error(\sprintf("The class '%s' does not implement '%s'", $className, Environment::class)); } $environment = new $className; if (!\defined("AMP_WORKER")) { \define("AMP_WORKER", \AMP_CONTEXT); } $runner = new TaskRunner($channel, $environment); return $runner->run(); }, $envClassName, $bootstrapPath)); } } name = $name; $this->trace = $trace; } /** * @deprecated Use TaskFailureThrowable::getOriginalClassName() instead. * * Returns the class name of the exception thrown from the task. * * @return string */ public function getName(): string { return $this->name; } /** * @deprecated Use TaskFailureThrowable::getOriginalTraceAsString() instead. * * Gets the stack trace at the point the exception was thrown in the task. * * @return string */ public function getWorkerTrace(): string { return $this->trace; } } originalMessage = $message; $this->originalCode = $code; $this->originalTrace = $trace; } /** * @return string Original exception class name. */ public function getOriginalClassName(): string { return $this->getName(); } /** * @return string Original exception message. */ public function getOriginalMessage(): string { return $this->originalMessage; } /** * @return int|string Original exception code. */ public function getOriginalCode() { return $this->originalCode; } /** * Returns the original exception stack trace. * * @return array Same as {@see Throwable::getTrace()}, except all function arguments are formatted as strings. */ public function getOriginalTrace(): array { return $this->originalTrace; } /** * Original backtrace flattened to a human-readable string. * * @return string */ public function getOriginalTraceAsString(): string { return $this->getWorkerTrace(); } } bootstrapPath = $bootstrapFilePath; $this->className = $envClassName; } /** * {@inheritdoc} * * The type of worker created depends on the extensions available. If multi-threading is enabled, a WorkerThread * will be created. If threads are not available a WorkerProcess will be created. */ public function create(): Worker { if (Parallel::isSupported()) { return new WorkerParallel($this->className, $this->bootstrapPath); } if (Thread::isSupported()) { return new WorkerThread($this->className, $this->bootstrapPath); } return new WorkerProcess( $this->className, [], \getenv("AMP_PHP_BINARY") ?: (\defined("AMP_PHP_BINARY") ? \AMP_PHP_BINARY : null), $this->bootstrapPath ); } } worker = $worker; $this->push = $push; } /** * Automatically pushes the worker back into the queue. */ public function __destruct() { ($this->push)($this->worker); } /** * {@inheritdoc} */ public function isRunning(): bool { return $this->worker->isRunning(); } /** * {@inheritdoc} */ public function isIdle(): bool { return $this->worker->isIdle(); } /** * {@inheritdoc} */ public function enqueue(Task $task): Promise { return $this->worker->enqueue($task); } /** * {@inheritdoc} */ public function shutdown(): Promise { return $this->worker->shutdown(); } /** * {@inheritdoc} */ public function kill(): void { $this->worker->kill(); } } id = $id; } /** * @return string Task identifier. */ public function getId(): string { return $this->id; } /** * @return Promise Resolved with the task result or failure reason. */ abstract public function promise(): Promise; } process = new Process($script, null, $env, $binary); } public function receive(): Promise { return $this->process->receive(); } public function send($data): Promise { return $this->process->send($data); } public function isRunning(): bool { return $this->process->isRunning(); } public function start(): Promise { return call(function () { $result = yield $this->process->start(); $stdout = $this->process->getStdout(); $stdout->unreference(); $stderr = $this->process->getStderr(); $stderr->unreference(); ByteStream\pipe($stdout, ByteStream\getStdout()); ByteStream\pipe($stderr, ByteStream\getStderr()); return $result; }); } public function kill(): void { if ($this->process->isRunning()) { $this->process->kill(); } } public function join(): Promise { return $this->process->join(); } } task = $task; $this->id = $id++; } public function getId(): string { return $this->id; } public function getTask(): Task { // Classes that cannot be autoloaded will be unserialized as an instance of __PHP_Incomplete_Class. if ($this->task instanceof \__PHP_Incomplete_Class) { throw new \Error(\sprintf("Classes implementing %s must be autoloadable by the Composer autoloader", Task::class)); } return $this->task; } } type = \get_class($exception); $this->parent = $exception instanceof \Error ? self::PARENT_ERROR : self::PARENT_EXCEPTION; $this->message = $exception->getMessage(); $this->code = $exception->getCode(); $this->trace = Sync\flattenThrowableBacktrace($exception); if ($previous = $exception->getPrevious()) { $this->previous = new self($id, $previous); } } public function promise(): Promise { return new Failure($this->createException()); } private function createException(): TaskFailureThrowable { $previous = $this->previous ? $this->previous->createException() : null; if ($this->parent === self::PARENT_ERROR) { return new TaskFailureError($this->type, $this->message, $this->code, $this->trace, $previous); } return new TaskFailureException($this->type, $this->message, $this->code, $this->trace, $previous); } } result = $result; } public function promise(): Promise { if ($this->result instanceof \__PHP_Incomplete_Class) { return new Failure(new \Error(\sprintf( "Class instances returned from %s::run() must be autoloadable by the Composer autoloader", Task::class ))); } return new Success($this->result); } } run(); }; Resolves with the return value of {@see Task::run()}. * * @throws TaskFailureThrowable Promise fails if {@see Task::run()} throws an exception. */ public function enqueue(Task $task): Promise; /** * @return Promise Resolves with the worker exit code. */ public function shutdown(): Promise; /** * Immediately kills the context. */ public function kill(); } */ function enqueue(Task $task): Promise { return pool()->enqueue($task); } /** * Enqueues a callable to be executed by the global worker pool. * * @param callable $callable Callable needs to be serializable. * @param mixed ...$args Arguments have to be serializable. * * @return Promise */ function enqueueCallable(callable $callable, ...$args) { return enqueue(new CallableTask($callable, $args)); } /** * Gets a worker from the global worker pool. * * @return \Amp\Parallel\Worker\Worker */ function worker(): Worker { return pool()->getWorker(); } /** * Creates a worker using the global worker factory. * * @return \Amp\Parallel\Worker\Worker */ function create(): Worker { return factory()->create(); } /** * Gets or sets the global worker factory. * * @param WorkerFactory|null $factory * * @return WorkerFactory */ function factory(WorkerFactory $factory = null): WorkerFactory { if ($factory === null) { $factory = Loop::getState(LOOP_FACTORY_IDENTIFIER); if ($factory) { return $factory; } $factory = new DefaultWorkerFactory; } Loop::setState(LOOP_FACTORY_IDENTIFIER, $factory); return $factory; } callable = $callable; $this->args = $args; } public function run(Environment $environment) { if ($this->callable instanceof \__PHP_Incomplete_Class) { throw new \Error('When using a class instance as a callable, the class must be autoloadable'); } if (\is_array($this->callable) && ($this->callable[0] ?? null) instanceof \__PHP_Incomplete_Class) { throw new \Error('When using a class instance method as a callable, the class must be autoloadable'); } if (!\is_callable($this->callable)) { $message = 'User-defined functions must be autoloadable (that is, defined in a file autoloaded by composer)'; if (\is_string($this->callable)) { $message .= \sprintf("; unable to load function '%s'", $this->callable); } throw new \Error($message); } return ($this->callable)(...$this->args); } } maxSize = $maxSize; // Use the global factory if none is given. $this->factory = $factory ?: factory(); $this->workers = new \SplObjectStorage; $this->idleWorkers = new \SplQueue; $this->busyQueue = new \SplQueue; $workers = $this->workers; $idleWorkers = $this->idleWorkers; $busyQueue = $this->busyQueue; $this->push = static function (Worker $worker) use ($workers, $idleWorkers, $busyQueue): void { if (!$workers->contains($worker) || ($workers[$worker] -= 1) > 0) { return; } // Worker is completely idle, remove from busy queue and add to idle queue. foreach ($busyQueue as $key => $busy) { if ($busy === $worker) { unset($busyQueue[$key]); break; } } $idleWorkers->push($worker); }; } public function __destruct() { if ($this->isRunning()) { $this->kill(); } } /** * Checks if the pool is running. * * @return bool True if the pool is running, otherwise false. */ public function isRunning(): bool { return $this->running; } /** * Checks if the pool has any idle workers. * * @return bool True if the pool has at least one idle worker, otherwise false. */ public function isIdle(): bool { return $this->idleWorkers->count() > 0 || $this->workers->count() === 0; } /** * {@inheritdoc} */ public function getMaxSize(): int { return $this->maxSize; } /** * {@inheritdoc} */ public function getWorkerCount(): int { return $this->workers->count(); } /** * {@inheritdoc} */ public function getIdleWorkerCount(): int { return $this->idleWorkers->count(); } /** * Enqueues a {@see Task} to be executed by the worker pool. * * @param Task $task The task to enqueue. * * @return Promise The return value of Task::run(). * * @throws StatusError If the pool has been shutdown. * @throws TaskFailureThrowable If the task throws an exception. */ public function enqueue(Task $task): Promise { $worker = $this->pull(); $promise = $worker->enqueue($task); $promise->onResolve(function () use ($worker): void { ($this->push)($worker); }); return $promise; } /** * Shuts down the pool and all workers in it. * * @return Promise Array of exit status from all workers. * * @throws StatusError If the pool has not been started. */ public function shutdown(): Promise { if ($this->exitStatus) { return $this->exitStatus; } $this->running = false; $shutdowns = []; foreach ($this->workers as $worker) { if ($worker->isRunning()) { $shutdowns[] = $worker->shutdown(); } } return $this->exitStatus = Promise\all($shutdowns); } /** * Kills all workers in the pool and halts the worker pool. */ public function kill(): void { $this->running = false; foreach ($this->workers as $worker) { \assert($worker instanceof Worker); if ($worker->isRunning()) { $worker->kill(); } } } /** * {@inheritdoc} */ public function getWorker(): Worker { return new Internal\PooledWorker($this->pull(), $this->push); } /** * Pulls a worker from the pool. * * @return Worker * @throws StatusError */ private function pull(): Worker { if (!$this->isRunning()) { throw new StatusError("The pool was shutdown"); } do { if ($this->idleWorkers->isEmpty()) { if ($this->getWorkerCount() >= $this->maxSize) { // All possible workers busy, so shift from head (will be pushed back onto tail below). $worker = $this->busyQueue->shift(); } else { // Max worker count has not been reached, so create another worker. $worker = $this->factory->create(); if (!$worker->isRunning()) { throw new WorkerException('Worker factory did not create a viable worker'); } $this->workers->attach($worker, 0); break; } } else { // Shift a worker off the idle queue. $worker = $this->idleWorkers->shift(); } \assert($worker instanceof Worker); if ($worker->isRunning()) { break; } // Worker crashed; trigger error and remove it from the pool. asyncCall(function () use ($worker): \Generator { try { $code = yield $worker->shutdown(); \trigger_error('Worker in pool exited unexpectedly with code ' . $code, \E_USER_WARNING); } catch (\Throwable $exception) { \trigger_error( 'Worker in pool crashed with exception on shutdown: ' . $exception->getMessage(), \E_USER_WARNING ); } }); $this->workers->detach($worker); } while (true); $this->busyQueue->push($worker); $this->workers[$worker] += 1; return $worker; } } channel = $channel; $this->environment = $environment; } /** * Runs the task runner, receiving tasks from the parent and sending the result of those tasks. * * @return \Amp\Promise */ public function run(): Promise { return new Coroutine($this->execute()); } /** * @coroutine * * @return \Generator */ private function execute(): \Generator { $job = yield $this->channel->receive(); while ($job instanceof Internal\Job) { try { $result = yield call([$job->getTask(), "run"], $this->environment); $result = new Internal\TaskSuccess($job->getId(), $result); } catch (\Throwable $exception) { $result = new Internal\TaskFailure($job->getId(), $exception); } $job = null; // Free memory from last job. try { yield $this->channel->send($result); } catch (SerializationException $exception) { // Could not serialize task result. yield $this->channel->send(new Internal\TaskFailure($result->getId(), $exception)); } $result = null; // Free memory from last result. $job = yield $this->channel->receive(); } return $job; } } isRunning()) { throw new \Error("The context was already running"); } $this->context = $context; $context = &$this->context; $pending = &$this->pending; \register_shutdown_function(static function () use (&$context, &$pending): void { if ($context === null || !$context->isRunning()) { return; } try { Promise\wait(Promise\timeout(call(function () use ($context, $pending): \Generator { if ($pending) { yield $pending; } yield $context->send(0); return yield $context->join(); }), self::SHUTDOWN_TIMEOUT)); } catch (\Throwable $exception) { if ($context !== null) { $context->kill(); } } }); } /** * {@inheritdoc} */ public function isRunning(): bool { // Report as running unless shutdown or crashed. return !$this->started || ($this->exitStatus === null && $this->context !== null && $this->context->isRunning()); } /** * {@inheritdoc} */ public function isIdle(): bool { return $this->pending === null; } /** * {@inheritdoc} */ public function enqueue(Task $task): Promise { if ($this->exitStatus) { throw new StatusError("The worker has been shut down"); } $promise = $this->pending = call(function () use ($task): \Generator { if ($this->pending) { try { yield $this->pending; } catch (\Throwable $exception) { // Ignore error from prior job. } } if ($this->exitStatus !== null || $this->context === null) { throw new WorkerException("The worker was shutdown"); } if (!$this->context->isRunning()) { if ($this->started) { throw new WorkerException("The worker crashed"); } $this->started = true; yield $this->context->start(); } $job = new Internal\Job($task); try { yield $this->context->send($job); $result = yield $this->context->receive(); } catch (ChannelException $exception) { try { yield Promise\timeout($this->context->join(), self::ERROR_TIMEOUT); } catch (TimeoutException $timeout) { $this->kill(); throw new WorkerException("The worker failed unexpectedly", 0, $exception); } throw new WorkerException("The worker exited unexpectedly", 0, $exception); } if (!$result instanceof Internal\TaskResult) { $this->kill(); throw new WorkerException("Context did not return a task result"); } if ($result->getId() !== $job->getId()) { $this->kill(); throw new WorkerException("Task results returned out of order"); } return $result->promise(); }); $promise->onResolve(function () use ($promise): void { if ($this->pending === $promise) { $this->pending = null; } }); return $promise; } /** * {@inheritdoc} */ public function shutdown(): Promise { if ($this->exitStatus !== null) { return $this->exitStatus; } if ($this->context === null || !$this->context->isRunning()) { return $this->exitStatus = new Success(-1); // Context crashed? } return $this->exitStatus = call(function (): \Generator { if ($this->pending) { // If a task is currently running, wait for it to finish. yield Promise\any([$this->pending]); } yield $this->context->send(0); try { return yield Promise\timeout($this->context->join(), self::SHUTDOWN_TIMEOUT); } catch (\Throwable $exception) { $this->context->kill(); throw new WorkerException("Failed to gracefully shutdown worker", 0, $exception); } finally { // Null properties to free memory because the shutdown function has references to these. $this->context = null; $this->pending = null; } }); } /** * {@inheritdoc} */ public function kill(): void { if ($this->exitStatus !== null || $this->context === null) { return; } if ($this->context->isRunning()) { $this->context->kill(); $this->exitStatus = new Failure(new WorkerException("The worker was killed")); return; } $this->exitStatus = new Success(0); // Null properties to free memory because the shutdown function has references to these. $this->context = null; $this->pending = null; } } originalMessage = $message; $this->originalCode = $code; $this->originalTrace = $trace; } /** * @return string Original exception class name. */ public function getOriginalClassName(): string { return $this->getName(); } /** * @return string Original exception message. */ public function getOriginalMessage(): string { return $this->originalMessage; } /** * @return int|string Original exception code. */ public function getOriginalCode() { return $this->originalCode; } /** * Returns the original exception stack trace. * * @return array Same as {@see Throwable::getTrace()}, except all function arguments are formatted as strings. */ public function getOriginalTrace(): array { return $this->originalTrace; } /** * Original backtrace flattened to a human-readable string. * * @return string */ public function getOriginalTraceAsString(): string { return $this->getWorkerTrace(); } } The thread object that was spawned. */ public static function run($script): Promise { $thread = new self($script); return call(function () use ($thread): \Generator { yield $thread->start(); return $thread; }); } /** * @param string|array $script Path to PHP script or array with first element as path and following elements options * to the PHP script (e.g.: ['bin/worker', 'Option1Value', 'Option2Value']. * * @throws \Error Thrown if the pthreads extension is not available. */ public function __construct($script) { if (!self::isSupported()) { throw new \Error("The parallel extension is required to create parallel threads."); } $this->hub = Loop::getState(self::class); if (!$this->hub instanceof Internal\ParallelHub) { $this->hub = new Internal\ParallelHub; Loop::setState(self::class, $this->hub); } if (\is_array($script)) { $this->script = (string) \array_shift($script); $this->args = \array_values(\array_map("strval", $script)); } else { $this->script = (string) $script; } if (self::$autoloadPath === null) { $paths = [ \dirname(__DIR__, 2) . \DIRECTORY_SEPARATOR . "vendor" . \DIRECTORY_SEPARATOR . "autoload.php", \dirname(__DIR__, 4) . \DIRECTORY_SEPARATOR . "autoload.php", ]; foreach ($paths as $path) { if (\file_exists($path)) { self::$autoloadPath = $path; break; } } if (self::$autoloadPath === null) { throw new \Error("Could not locate autoload.php"); } } } /** * Returns the thread to the condition before starting. The new thread can be started and run independently of the * first thread. */ public function __clone() { $this->runtime = null; $this->channel = null; $this->id = null; $this->oid = 0; $this->killed = false; } /** * Kills the thread if it is still running. * * @throws \Amp\Parallel\Context\ContextException */ public function __destruct() { if (\getmypid() === $this->oid) { $this->kill(); } } /** * Checks if the context is running. * * @return bool True if the context is running, otherwise false. */ public function isRunning(): bool { return $this->channel !== null; } /** * Spawns the thread and begins the thread's execution. * * @return Promise Resolved once the thread has started. * * @throws \Amp\Parallel\Context\StatusError If the thread has already been started. * @throws \Amp\Parallel\Context\ContextException If starting the thread was unsuccessful. */ public function start(): Promise { if ($this->oid !== 0) { throw new StatusError('The thread has already been started.'); } $this->oid = \getmypid(); $this->runtime = new Runtime(self::$autoloadPath); $this->id = self::$nextId++; $future = $this->runtime->run(static function (int $id, string $uri, string $key, string $path, array $argv): int { // @codeCoverageIgnoreStart // Only executed in thread. \define("AMP_CONTEXT", "parallel"); \define("AMP_CONTEXT_ID", $id); if (!$socket = \stream_socket_client($uri, $errno, $errstr, 5, \STREAM_CLIENT_CONNECT)) { \trigger_error("Could not connect to IPC socket", E_USER_ERROR); return 1; } $channel = new ChannelledSocket($socket, $socket); try { Promise\wait($channel->send($key)); } catch (\Throwable $exception) { \trigger_error("Could not send key to parent", E_USER_ERROR); return 1; } try { Loop::unreference(Loop::repeat(self::EXIT_CHECK_FREQUENCY, function (): void { // Timer to give the chance for the PHP VM to be interrupted by Runtime::kill(), since system calls such as // select() will not be interrupted. })); try { if (!\is_file($path)) { throw new \Error(\sprintf("No script found at '%s' (be sure to provide the full path to the script)", $path)); } $argc = \array_unshift($argv, $path); try { // Protect current scope by requiring script within another function. $callable = (function () use ($argc, $argv): callable { // Using $argc so it is available to the required script. return require $argv[0]; })->bindTo(null, null)(); } catch (\TypeError $exception) { throw new \Error(\sprintf("Script '%s' did not return a callable function", $path), 0, $exception); } catch (\ParseError $exception) { throw new \Error(\sprintf("Script '%s' contains a parse error", $path), 0, $exception); } $result = new ExitSuccess(Promise\wait(call($callable, $channel))); } catch (\Throwable $exception) { $result = new ExitFailure($exception); } Promise\wait(call(function () use ($channel, $result): \Generator { try { yield $channel->send($result); } catch (SerializationException $exception) { // Serializing the result failed. Send the reason why. yield $channel->send(new ExitFailure($exception)); } })); } catch (\Throwable $exception) { \trigger_error("Could not send result to parent; be sure to shutdown the child before ending the parent", E_USER_ERROR); return 1; } finally { $channel->close(); } return 0; // @codeCoverageIgnoreEnd }, [ $this->id, $this->hub->getUri(), $this->hub->generateKey($this->id, self::KEY_LENGTH), $this->script, $this->args ]); return call(function () use ($future): \Generator { try { $this->channel = yield $this->hub->accept($this->id); $this->hub->add($this->id, $this->channel, $future); } catch (\Throwable $exception) { $this->kill(); throw new ContextException("Starting the parallel runtime failed", 0, $exception); } if ($this->killed) { $this->kill(); } return $this->id; }); } /** * Immediately kills the context. */ public function kill(): void { $this->killed = true; if ($this->runtime !== null) { try { $this->runtime->kill(); } finally { $this->close(); } } } /** * Closes channel and socket if still open. */ private function close(): void { $this->runtime = null; if ($this->channel !== null) { $this->channel->close(); } $this->channel = null; $this->hub->remove($this->id); } /** * Gets a promise that resolves when the context ends and joins with the * parent context. * * @return \Amp\Promise * * @throws StatusError Thrown if the context has not been started. * @throws SynchronizationError Thrown if an exit status object is not received. * @throws ContextException If the context stops responding. */ public function join(): Promise { if ($this->channel === null) { throw new StatusError('The thread has not been started or has already finished.'); } return call(function (): \Generator { try { $response = yield $this->channel->receive(); $this->close(); } catch (\Throwable $exception) { $this->kill(); throw new ContextException("Failed to receive result from thread", 0, $exception); } if (!$response instanceof ExitResult) { $this->kill(); throw new SynchronizationError('Did not receive an exit result from thread.'); } return $response->getResult(); }); } /** * {@inheritdoc} */ public function receive(): Promise { if ($this->channel === null) { throw new StatusError('The thread has not been started.'); } return call(function (): \Generator { try { $data = yield $this->channel->receive(); } catch (ChannelException $e) { throw new ContextException("The thread stopped responding, potentially due to a fatal error or calling exit", 0, $e); } if ($data instanceof ExitResult) { $data = $data->getResult(); throw new SynchronizationError(\sprintf( 'Thread unexpectedly exited with result of type: %s', \is_object($data) ? \get_class($data) : \gettype($data) )); } return $data; }); } /** * {@inheritdoc} */ public function send($data): Promise { if ($this->channel === null) { throw new StatusError('The thread has not been started or has already finished.'); } if ($data instanceof ExitResult) { throw new \Error('Cannot send exit result objects.'); } return call(function () use ($data): \Generator { try { return yield $this->channel->send($data); } catch (ChannelException $e) { if ($this->channel === null) { throw new ContextException("The thread stopped responding, potentially due to a fatal error or calling exit", 0, $e); } try { $data = yield Promise\timeout($this->join(), 100); } catch (ContextException | ChannelException | TimeoutException $ex) { $this->kill(); throw new ContextException("The thread stopped responding, potentially due to a fatal error or calling exit", 0, $e); } throw new SynchronizationError(\sprintf( 'Thread unexpectedly exited with result of type: %s', \is_object($data) ? \get_class($data) : \gettype($data) ), 0, $e); } }); } /** * Returns the ID of the thread. This ID will be unique to this process. * * @return int * * @throws \Amp\Process\StatusError */ public function getId(): int { if ($this->id === null) { throw new StatusError('The thread has not been started'); } return $this->id; } } Resolved once the context has started. */ public function start(): Promise; /** * Immediately kills the context. */ public function kill(); /** * @return \Amp\Promise Resolves with the returned from the context. * * @throws \Amp\Parallel\Context\ContextException If the context dies unexpectedly. * @throws \Amp\Parallel\Sync\PanicError If the context throws an uncaught exception. */ public function join(): Promise; } */ public function run($script): Promise; } */ public static function run($script, string $cwd = null, array $env = [], string $binary = null): Promise { $process = new self($script, $cwd, $env, $binary); return call(function () use ($process): \Generator { yield $process->start(); return $process; }); } /** * @param string|array $script Path to PHP script or array with first element as path and following elements options * to the PHP script (e.g.: ['bin/worker', 'Option1Value', 'Option2Value']. * @param string|null $cwd Working directory. * @param mixed[] $env Array of environment variables. * @param string $binary Path to PHP binary. Null will attempt to automatically locate the binary. * * @throws \Error If the PHP binary path given cannot be found or is not executable. */ public function __construct($script, string $cwd = null, array $env = [], string $binary = null) { $this->hub = Loop::getState(self::class); if (!$this->hub instanceof Internal\ProcessHub) { $this->hub = new Internal\ProcessHub; Loop::setState(self::class, $this->hub); } $options = [ "html_errors" => "0", "display_errors" => "0", "log_errors" => "1", ]; if ($binary === null) { if (\PHP_SAPI === "cli") { $binary = \PHP_BINARY; } else { $binary = self::$binaryPath ?? self::locateBinary(); } } elseif (!\is_executable($binary)) { throw new \Error(\sprintf("The PHP binary path '%s' was not found or is not executable", $binary)); } // Write process runner to external file if inside a PHAR, // because PHP can't open files inside a PHAR directly except for the stub. if (\strpos(self::SCRIPT_PATH, "phar://") === 0) { if (self::$pharScriptPath) { $scriptPath = self::$pharScriptPath; } else { $path = \dirname(self::SCRIPT_PATH); if (\substr(\Phar::running(false), -5) !== ".phar") { self::$pharCopy = \sys_get_temp_dir() . "/phar-" . \bin2hex(\random_bytes(10)) . ".phar"; \copy(\Phar::running(false), self::$pharCopy); \register_shutdown_function(static function (): void { @\unlink(self::$pharCopy); }); $path = "phar://" . self::$pharCopy . "/" . \substr($path, \strlen(\Phar::running(true))); } $contents = \file_get_contents(self::SCRIPT_PATH); $contents = \str_replace("__DIR__", \var_export($path, true), $contents); $suffix = \bin2hex(\random_bytes(10)); self::$pharScriptPath = $scriptPath = \sys_get_temp_dir() . "/amp-process-runner-" . $suffix . ".php"; \file_put_contents($scriptPath, $contents); \register_shutdown_function(static function (): void { @\unlink(self::$pharScriptPath); }); } // Monkey-patch the script path in the same way, only supported if the command is given as array. if (isset(self::$pharCopy) && \is_array($script) && isset($script[0])) { $script[0] = "phar://" . self::$pharCopy . \substr($script[0], \strlen(\Phar::running(true))); } } else { $scriptPath = self::SCRIPT_PATH; } if (\is_array($script)) { $script = \implode(" ", \array_map("escapeshellarg", $script)); } else { $script = \escapeshellarg($script); } $command = \implode(" ", [ \escapeshellarg($binary), $this->formatOptions($options), \escapeshellarg($scriptPath), $this->hub->getUri(), $script, ]); $this->process = new BaseProcess($command, $cwd, $env); } private static function locateBinary(): string { $executable = \strncasecmp(\PHP_OS, "WIN", 3) === 0 ? "php.exe" : "php"; $paths = \array_filter(\explode(\PATH_SEPARATOR, \getenv("PATH"))); $paths[] = \PHP_BINDIR; $paths = \array_unique($paths); foreach ($paths as $path) { $path .= \DIRECTORY_SEPARATOR . $executable; if (\is_executable($path)) { return self::$binaryPath = $path; } } throw new \Error("Could not locate PHP executable binary"); } private function formatOptions(array $options): string { $result = []; foreach ($options as $option => $value) { $result[] = \sprintf("-d%s=%s", $option, $value); } return \implode(" ", $result); } /** * Private method to prevent cloning. */ private function __clone() { } /** * {@inheritdoc} */ public function start(): Promise { return call(function (): \Generator { try { $pid = yield $this->process->start(); yield $this->process->getStdin()->write($this->hub->generateKey($pid, self::KEY_LENGTH)); $this->channel = yield $this->hub->accept($pid); return $pid; } catch (\Throwable $exception) { if ($this->isRunning()) { $this->kill(); } throw new ContextException("Starting the process failed", 0, $exception); } }); } /** * {@inheritdoc} */ public function isRunning(): bool { return $this->process->isRunning(); } /** * {@inheritdoc} */ public function receive(): Promise { if ($this->channel === null) { throw new StatusError("The process has not been started"); } return call(function (): \Generator { try { $data = yield $this->channel->receive(); } catch (ChannelException $e) { throw new ContextException("The process stopped responding, potentially due to a fatal error or calling exit", 0, $e); } if ($data instanceof ExitResult) { $data = $data->getResult(); throw new SynchronizationError(\sprintf( 'Process unexpectedly exited with result of type: %s', \is_object($data) ? \get_class($data) : \gettype($data) )); } return $data; }); } /** * {@inheritdoc} */ public function send($data): Promise { if ($this->channel === null) { throw new StatusError("The process has not been started"); } if ($data instanceof ExitResult) { throw new \Error("Cannot send exit result objects"); } return call(function () use ($data): \Generator { try { return yield $this->channel->send($data); } catch (ChannelException $e) { if ($this->channel === null) { throw new ContextException("The process stopped responding, potentially due to a fatal error or calling exit", 0, $e); } try { $data = yield Promise\timeout($this->join(), 100); } catch (ContextException | ChannelException | TimeoutException $ex) { if ($this->isRunning()) { $this->kill(); } throw new ContextException("The process stopped responding, potentially due to a fatal error or calling exit", 0, $e); } throw new SynchronizationError(\sprintf( 'Process unexpectedly exited with result of type: %s', \is_object($data) ? \get_class($data) : \gettype($data) ), 0, $e); } }); } /** * {@inheritdoc} */ public function join(): Promise { if ($this->channel === null) { throw new StatusError("The process has not been started"); } return call(function (): \Generator { try { $data = yield $this->channel->receive(); } catch (\Throwable $exception) { if ($this->isRunning()) { $this->kill(); } throw new ContextException("Failed to receive result from process", 0, $exception); } if (!$data instanceof ExitResult) { if ($this->isRunning()) { $this->kill(); } throw new SynchronizationError("Did not receive an exit result from process"); } $this->channel->close(); $code = yield $this->process->join(); if ($code !== 0) { throw new ContextException(\sprintf("Process exited with code %d", $code)); } return $data->getResult(); }); } /** * Send a signal to the process. * * @see \Amp\Process\Process::signal() * * @param int $signo * * @throws \Amp\Process\ProcessException * @throws \Amp\Process\StatusError */ public function signal(int $signo): void { $this->process->signal($signo); } /** * Returns the PID of the process. * * @see \Amp\Process\Process::getPid() * * @return int * * @throws \Amp\Process\StatusError */ public function getPid(): int { return $this->process->getPid(); } /** * Returns the STDIN stream of the process. * * @see \Amp\Process\Process::getStdin() * * @return ProcessOutputStream * * @throws \Amp\Process\StatusError */ public function getStdin(): ProcessOutputStream { return $this->process->getStdin(); } /** * Returns the STDOUT stream of the process. * * @see \Amp\Process\Process::getStdout() * * @return ProcessInputStream * * @throws \Amp\Process\StatusError */ public function getStdout(): ProcessInputStream { return $this->process->getStdout(); } /** * Returns the STDOUT stream of the process. * * @see \Amp\Process\Process::getStderr() * * @return ProcessInputStream * * @throws \Amp\Process\StatusError */ public function getStderr(): ProcessInputStream { return $this->process->getStderr(); } /** * {@inheritdoc} */ public function kill(): void { $this->process->kill(); if ($this->channel !== null) { $this->channel->close(); } } } send($key)); } catch (\Throwable $exception) { \trigger_error("Could not send key to parent", E_USER_ERROR); exit(1); } try { if (!isset($argv[0])) { throw new \Error("No script path given"); } if (!\is_file($argv[0])) { throw new \Error(\sprintf("No script found at '%s' (be sure to provide the full path to the script)", $argv[0])); } try { // Protect current scope by requiring script within another function. $callable = (function () use ($argc, $argv): callable { // Using $argc so it is available to the required script. return require $argv[0]; })(); } catch (\TypeError $exception) { throw new \Error(\sprintf("Script '%s' did not return a callable function", $argv[0]), 0, $exception); } catch (\ParseError $exception) { throw new \Error(\sprintf("Script '%s' contains a parse error: " . $exception->getMessage(), $argv[0]), 0, $exception); } $result = new Sync\ExitSuccess(Promise\wait(call($callable, $channel))); } catch (\Throwable $exception) { $result = new Sync\ExitFailure($exception); } try { Promise\wait(call(function () use ($channel, $result): \Generator { try { yield $channel->send($result); } catch (Sync\SerializationException $exception) { // Serializing the result failed. Send the reason why. yield $channel->send(new Sync\ExitFailure($exception)); } })); } catch (\Throwable $exception) { \trigger_error("Could not send result to parent; be sure to shutdown the child before ending the parent", E_USER_ERROR); exit(1); } })(); uri = "tcp://127.0.0.1:0"; } else { $suffix = \bin2hex(\random_bytes(10)); $path = \sys_get_temp_dir() . "/amp-parallel-ipc-" . $suffix . ".sock"; $this->uri = "unix://" . $path; $this->toUnlink = $path; } $context = \stream_context_create([ 'socket' => ['backlog' => 128], ]); $this->server = \stream_socket_server( $this->uri, $errno, $errstr, \STREAM_SERVER_BIND | \STREAM_SERVER_LISTEN, $context ); if (!$this->server) { throw new \RuntimeException(\sprintf("Could not create IPC server: (Errno: %d) %s", $errno, $errstr)); } if ($isWindows) { $name = \stream_socket_get_name($this->server, false); $port = \substr($name, \strrpos($name, ":") + 1); $this->uri = "tcp://127.0.0.1:" . $port; } $keys = &$this->keys; $acceptor = &$this->acceptor; $this->watcher = Loop::onReadable( $this->server, static function (string $watcher, $server) use (&$keys, &$acceptor): void { // Error reporting suppressed since stream_socket_accept() emits E_WARNING on client accept failure. while ($client = @\stream_socket_accept($server, 0)) { // Timeout of 0 to be non-blocking. asyncCall(static function () use ($client, &$keys, &$acceptor) { $channel = new ChannelledSocket($client, $client); try { $received = yield Promise\timeout($channel->receive(), self::KEY_RECEIVE_TIMEOUT); } catch (\Throwable $exception) { $channel->close(); return; // Ignore possible foreign connection attempt. } if (!\is_string($received) || !isset($keys[$received])) { $channel->close(); return; // Ignore possible foreign connection attempt. } $pid = $keys[$received]; $deferred = $acceptor[$pid]; unset($acceptor[$pid], $keys[$received]); $deferred->resolve($channel); }); } } ); Loop::disable($this->watcher); } public function __destruct() { Loop::cancel($this->watcher); \fclose($this->server); if ($this->toUnlink !== null) { @\unlink($this->toUnlink); } } public function getUri(): string { return $this->uri; } public function generateKey(int $pid, int $length): string { $key = \random_bytes($length); $this->keys[$key] = $pid; return $key; } public function accept(int $pid): Promise { return call(function () use ($pid): \Generator { $this->acceptor[$pid] = new Deferred; Loop::enable($this->watcher); try { $channel = yield Promise\timeout($this->acceptor[$pid]->promise(), self::PROCESS_START_TIMEOUT); } catch (TimeoutException $exception) { $key = \array_search($pid, $this->keys, true); \assert(\is_string($key), "Key for {$pid} not found"); unset($this->acceptor[$pid], $this->keys[$key]); throw new ContextException("Starting the process timed out", 0, $exception); } finally { if (empty($this->acceptor)) { Loop::disable($this->watcher); } } return $channel; }); } } events = new Events; $this->events->setBlocking(false); $channels = &$this->channels; $this->watcher = Loop::repeat(self::EXIT_CHECK_FREQUENCY, static function () use (&$channels, $events): void { while ($event = $events->poll()) { $id = (int) $event->source; \assert(isset($channels[$id]), 'Channel for context ID not found'); $channel = $channels[$id]; unset($channels[$id]); $channel->close(); } }); Loop::disable($this->watcher); Loop::unreference($this->watcher); } public function add(int $id, ChannelledSocket $channel, Future $future): void { $this->channels[$id] = $channel; $this->events->addFuture((string) $id, $future); Loop::enable($this->watcher); } public function remove(int $id): void { if (!isset($this->channels[$id])) { return; } unset($this->channels[$id]); $this->events->remove((string) $id); if (empty($this->channels)) { Loop::disable($this->watcher); } } } id = $id; $this->function = $function; $this->args = $args; $this->socket = $socket; } /** * Runs the thread code and the initialized function. * * @codeCoverageIgnore Only executed in thread. */ public function run() { \define("AMP_CONTEXT", "thread"); \define("AMP_CONTEXT_ID", $this->id); /* First thing we need to do is re-initialize the class autoloader. If * we don't do this first, any object of a class that was loaded after * the thread started will just be garbage data and unserializable * values (like resources) will be lost. This happens even with * thread-safe objects. */ // Protect scope by using an unbound closure (protects static access as well). (static function (): void { $paths = [ \dirname(__DIR__, 3) . \DIRECTORY_SEPARATOR . "vendor" . \DIRECTORY_SEPARATOR . "autoload.php", \dirname(__DIR__, 5) . \DIRECTORY_SEPARATOR . "autoload.php", ]; foreach ($paths as $path) { if (\file_exists($path)) { $autoloadPath = $path; break; } } if (!isset($autoloadPath)) { throw new \Error("Could not locate autoload.php"); } require $autoloadPath; })->bindTo(null, null)(); // At this point, the thread environment has been prepared so begin using the thread. if ($this->killed) { return; // Thread killed while requiring autoloader, simply exit. } Loop::run(function (): \Generator { $watcher = Loop::repeat(self::KILL_CHECK_FREQUENCY, function (): void { if ($this->killed) { Loop::stop(); } }); Loop::unreference($watcher); try { $channel = new ChannelledSocket($this->socket, $this->socket); yield from $this->execute($channel); } catch (\Throwable $exception) { return; // Parent context exited or destroyed thread, no need to continue. } finally { Loop::cancel($watcher); } }); } /** * Sets a local variable to true so the running event loop can check for a kill signal. */ public function kill() { return $this->killed = true; } /** * @param \Amp\Parallel\Sync\Channel $channel * * @return \Generator * * @codeCoverageIgnore Only executed in thread. */ private function execute(Channel $channel): \Generator { try { $result = new ExitSuccess(yield call($this->function, $channel, ...$this->args)); } catch (\Throwable $exception) { $result = new ExitFailure($exception); } if ($this->killed) { return; // Parent is not listening for a result. } // Attempt to return the result. try { try { yield $channel->send($result); } catch (SerializationException $exception) { // Serializing the result failed. Send the reason why. yield $channel->send(new ExitFailure($exception)); } } catch (ChannelException $exception) { // The result was not sendable! The parent context must have died or killed the context. } } } create($script); } /** * Creates and starts a process based on installed extensions (a thread if ext-parallel is installed, otherwise a child * process). * * @param string|string[] $script Path to PHP script or array with first element as path and following elements options * to the PHP script (e.g.: ['bin/worker', 'Option1Value', 'Option2Value']. * * @return Promise */ function run($script): Promise { return factory()->run($script); } /** * Gets or sets the global context factory. * * @param ContextFactory|null $factory * * @return ContextFactory */ function factory(?ContextFactory $factory = null): ContextFactory { if ($factory === null) { $factory = Loop::getState(LOOP_FACTORY_IDENTIFIER); if ($factory) { return $factory; } $factory = new DefaultContextFactory; } Loop::setState(LOOP_FACTORY_IDENTIFIER, $factory); return $factory; } The thread object that was spawned. */ public static function run(callable $function, ...$args): Promise { $thread = new self($function, ...$args); return call(function () use ($thread): \Generator { yield $thread->start(); return $thread; }); } /** * Creates a new thread. * * @param callable $function The callable to invoke in the thread. First argument is an instance of * \Amp\Parallel\Sync\Channel. * @param mixed ...$args Additional arguments to pass to the given callable. * * @throws \Error Thrown if the pthreads extension is not available. */ public function __construct(callable $function, ...$args) { if (!self::isSupported()) { throw new \Error("The pthreads extension is required to create threads."); } $this->function = $function; $this->args = $args; } /** * Returns the thread to the condition before starting. The new thread can be started and run independently of the * first thread. */ public function __clone() { $this->thread = null; $this->socket = null; $this->channel = null; $this->oid = 0; } /** * Kills the thread if it is still running. * * @throws \Amp\Parallel\Context\ContextException */ public function __destruct() { if (\getmypid() === $this->oid) { $this->kill(); } } /** * Checks if the context is running. * * @return bool True if the context is running, otherwise false. */ public function isRunning(): bool { return $this->channel !== null; } /** * Spawns the thread and begins the thread's execution. * * @return Promise Resolved once the thread has started. * * @throws \Amp\Parallel\Context\StatusError If the thread has already been started. * @throws \Amp\Parallel\Context\ContextException If starting the thread was unsuccessful. */ public function start(): Promise { if ($this->oid !== 0) { throw new StatusError('The thread has already been started.'); } $this->oid = \getmypid(); $sockets = @\stream_socket_pair( \stripos(\PHP_OS, "win") === 0 ? STREAM_PF_INET : STREAM_PF_UNIX, STREAM_SOCK_STREAM, STREAM_IPPROTO_IP ); if ($sockets === false) { $message = "Failed to create socket pair"; if ($error = \error_get_last()) { $message .= \sprintf(" Errno: %d; %s", $error["type"], $error["message"]); } return new Failure(new ContextException($message)); } list($channel, $this->socket) = $sockets; $this->id = self::$nextId++; $thread = $this->thread = new Internal\Thread($this->id, $this->socket, $this->function, $this->args); if (!$this->thread->start(\PTHREADS_INHERIT_INI)) { return new Failure(new ContextException('Failed to start the thread.')); } $channel = $this->channel = new ChannelledSocket($channel, $channel); $this->watcher = Loop::repeat(self::EXIT_CHECK_FREQUENCY, static function ($watcher) use ($thread, $channel): void { if (!$thread->isRunning()) { // Delay closing to avoid race condition between thread exiting and data becoming available. Loop::delay(self::EXIT_CHECK_FREQUENCY, [$channel, "close"]); Loop::cancel($watcher); } }); Loop::disable($this->watcher); return new Success($this->id); } /** * Immediately kills the context. * * @throws ContextException If killing the thread was unsuccessful. */ public function kill(): void { if ($this->thread !== null) { try { if ($this->thread->isRunning() && !$this->thread->kill()) { throw new ContextException('Could not kill thread.'); } } finally { $this->close(); } } } /** * Closes channel and socket if still open. */ private function close(): void { if ($this->channel !== null) { $this->channel->close(); } $this->channel = null; Loop::cancel($this->watcher); } /** * Gets a promise that resolves when the context ends and joins with the * parent context. * * @return \Amp\Promise * * @throws StatusError Thrown if the context has not been started. * @throws SynchronizationError Thrown if an exit status object is not received. * @throws ContextException If the context stops responding. */ public function join(): Promise { if ($this->channel == null || $this->thread === null) { throw new StatusError('The thread has not been started or has already finished.'); } return call(function (): \Generator { Loop::enable($this->watcher); try { $response = yield $this->channel->receive(); } catch (\Throwable $exception) { $this->kill(); throw new ContextException("Failed to receive result from thread", 0, $exception); } finally { Loop::disable($this->watcher); $this->close(); } if (!$response instanceof ExitResult) { $this->kill(); throw new SynchronizationError('Did not receive an exit result from thread.'); } return $response->getResult(); }); } /** * {@inheritdoc} */ public function receive(): Promise { if ($this->channel === null) { throw new StatusError('The process has not been started.'); } return call(function (): \Generator { Loop::enable($this->watcher); try { $data = yield $this->channel->receive(); } finally { Loop::disable($this->watcher); } if ($data instanceof ExitResult) { $data = $data->getResult(); throw new SynchronizationError(\sprintf( 'Thread process unexpectedly exited with result of type: %s', \is_object($data) ? \get_class($data) : \gettype($data) )); } return $data; }); } /** * {@inheritdoc} */ public function send($data): Promise { if ($this->channel === null) { throw new StatusError('The thread has not been started or has already finished.'); } if ($data instanceof ExitResult) { throw new \Error('Cannot send exit result objects.'); } return call(function () use ($data): \Generator { Loop::enable($this->watcher); try { $result = yield $this->channel->send($data); } finally { Loop::disable($this->watcher); } return $result; }); } /** * Returns the ID of the thread. This ID will be unique to this process. * * @return int * * @throws \Amp\Process\StatusError */ public function getId(): int { if ($this->id === null) { throw new StatusError('The thread has not been started'); } return $this->id; } } originalMessage = $message; $this->originalCode = $code; $this->originalTrace = $trace; } /** * @return string Original exception class name. */ public function getOriginalClassName(): string { return $this->getName(); } /** * @return string Original exception message. */ public function getOriginalMessage(): string { return $this->originalMessage; } /** * @return int|string Original exception code. */ public function getOriginalCode() { return $this->originalCode; } /** * Original exception stack trace. * * @return array Same as {@see Throwable::getTrace()}, except all function arguments are formatted as strings. */ public function getOriginalTrace(): array { return $this->originalTrace; } /** * Original backtrace flattened to a human-readable string. * * @return string */ public function getOriginalTraceAsString(): string { return $this->getPanicTrace(); } } init($value, $size, $permissions); return $parcel; } /** * @param string $id * @param Serializer|null $serializer * * @return self * * @throws SharedMemoryException */ public static function use(string $id, ?Serializer $serializer = null): self { $parcel = new self($id, $serializer); $parcel->open(); return $parcel; } /** * @param string $id * @param Serializer|null $serializer */ private function __construct(string $id, ?Serializer $serializer = null) { if (!\extension_loaded("shmop")) { throw new \Error(__CLASS__ . " requires the shmop extension"); } $this->id = $id; $this->key = self::makeKey($this->id); $this->serializer = $serializer ?? new NativeSerializer; } /** * @param mixed $value * @param int $size * @param int $permissions * * @throws SharedMemoryException * @throws SyncException * @throws \Error If the size or permissions are invalid. */ private function init($value, int $size = 8192, int $permissions = 0600): void { if ($size <= 0) { throw new \Error('The memory size must be greater than 0'); } if ($permissions <= 0 || $permissions > 0777) { throw new \Error('Invalid permissions'); } $this->semaphore = PosixSemaphore::create($this->id, 1); $this->initializer = \getmypid(); $this->memOpen($this->key, 'n', $permissions, $size + self::MEM_DATA_OFFSET); $this->setHeader(self::STATE_ALLOCATED, 0, $permissions); $this->wrap($value); } private function open(): void { $this->semaphore = PosixSemaphore::use($this->id); $this->memOpen($this->key, 'w', 0, 0); } /** * Checks if the object has been freed. * * Note that this does not check if the object has been destroyed; it only * checks if this handle has freed its reference to the object. * * @return bool True if the object is freed, otherwise false. */ private function isFreed(): bool { // If we are no longer connected to the memory segment, check if it has // been invalidated. if ($this->handle !== null) { $this->handleMovedMemory(); $header = $this->getHeader(); return $header['state'] === static::STATE_FREED; } return true; } /** * {@inheritdoc} */ public function unwrap(): Promise { return call(function () { $lock = yield $this->semaphore->acquire(); \assert($lock instanceof Lock); try { return $this->getValue(); } finally { $lock->release(); } }); } /** * @return mixed * * @throws SharedMemoryException * @throws SerializationException */ private function getValue() { if ($this->isFreed()) { throw new SharedMemoryException('The object has already been freed'); } $header = $this->getHeader(); // Make sure the header is in a valid state and format. if ($header['state'] !== self::STATE_ALLOCATED || $header['size'] <= 0) { throw new SharedMemoryException('Shared object memory is corrupt'); } // Read the actual value data from memory and unserialize it. $data = $this->memGet(self::MEM_DATA_OFFSET, $header['size']); return $this->serializer->unserialize($data); } /** * If the value requires more memory to store than currently allocated, a * new shared memory segment will be allocated with a larger size to store * the value in. The previous memory segment will be cleaned up and marked * for deletion. Other processes and threads will be notified of the new * memory segment on the next read attempt. Once all running processes and * threads disconnect from the old segment, it will be freed by the OS. */ private function wrap($value): void { if ($this->isFreed()) { throw new SharedMemoryException('The object has already been freed'); } $serialized = $this->serializer->serialize($value); $size = \strlen($serialized); $header = $this->getHeader(); /* If we run out of space, we need to allocate a new shared memory segment that is larger than the current one. To coordinate with other processes, we will leave a message in the old segment that the segment has moved and along with the new key. The old segment will be discarded automatically after all other processes notice the change and close the old handle. */ if (\shmop_size($this->handle) < $size + self::MEM_DATA_OFFSET) { $this->key = $this->key < 0xffffffff ? $this->key + 1 : \random_int(0x10, 0xfffffffe); $this->setHeader(self::STATE_MOVED, $this->key, 0); $this->memDelete(); \shmop_close($this->handle); $this->memOpen($this->key, 'n', $header['permissions'], $size * 2); } // Rewrite the header and the serialized value to memory. $this->setHeader(self::STATE_ALLOCATED, $size, $header['permissions']); $this->memSet(self::MEM_DATA_OFFSET, $serialized); } /** * {@inheritdoc} */ public function synchronized(callable $callback): Promise { return call(function () use ($callback): \Generator { $lock = yield $this->semaphore->acquire(); \assert($lock instanceof Lock); try { $result = yield call($callback, $this->getValue()); if ($result !== null) { $this->wrap($result); } } finally { $lock->release(); } return $result; }); } /** * Frees the shared object from memory. * * The memory containing the shared value will be invalidated. When all * process disconnect from the object, the shared memory block will be * destroyed by the OS. */ public function __destruct() { if ($this->initializer === 0 || $this->initializer !== \getmypid()) { return; } if ($this->isFreed()) { return; } // Invalidate the memory block by setting its state to FREED. $this->setHeader(static::STATE_FREED, 0, 0); // Request the block to be deleted, then close our local handle. $this->memDelete(); \shmop_close($this->handle); $this->handle = null; $this->semaphore = null; } /** * Private method to prevent cloning. */ private function __clone() { } /** * Prevent serialization. */ public function __sleep() { throw new \Error('A shared memory parcel cannot be serialized!'); } /** * Updates the current memory segment handle, handling any moves made on the * data. * * @throws SharedMemoryException */ private function handleMovedMemory(): void { // Read from the memory block and handle moved blocks until we find the // correct block. while (true) { $header = $this->getHeader(); // If the state is STATE_MOVED, the memory is stale and has been moved // to a new location. Move handle and try to read again. if ($header['state'] !== self::STATE_MOVED) { break; } \shmop_close($this->handle); $this->key = $header['size']; $this->memOpen($this->key, 'w', 0, 0); } } /** * Reads and returns the data header at the current memory segment. * * @return array An associative array of header data. * * @throws SharedMemoryException */ private function getHeader(): array { $data = $this->memGet(0, self::MEM_DATA_OFFSET); return \unpack('Cstate/Lsize/Spermissions', $data); } /** * Sets the header data for the current memory segment. * * @param int $state An object state. * @param int $size The size of the stored data, or other value. * @param int $permissions The permissions mask on the memory segment. * * @throws SharedMemoryException */ private function setHeader(int $state, int $size, int $permissions): void { $header = \pack('CLS', $state, $size, $permissions); $this->memSet(0, $header); } /** * Opens a shared memory handle. * * @param int $key The shared memory key. * @param string $mode The mode to open the shared memory in. * @param int $permissions Process permissions on the shared memory. * @param int $size The size to crate the shared memory in bytes. * * @throws SharedMemoryException */ private function memOpen(int $key, string $mode, int $permissions, int $size): void { $handle = @\shmop_open($key, $mode, $permissions, $size); if ($handle === false) { $error = \error_get_last(); throw new SharedMemoryException( 'Failed to create shared memory block: ' . ($error['message'] ?? 'unknown error') ); } $this->handle = $handle; } /** * Reads binary data from shared memory. * * @param int $offset The offset to read from. * @param int $size The number of bytes to read. * * @return string The binary data at the given offset. * * @throws SharedMemoryException */ private function memGet(int $offset, int $size): string { $data = \shmop_read($this->handle, $offset, $size); if ($data === false) { $error = \error_get_last(); throw new SharedMemoryException( 'Failed to read from shared memory block: ' . ($error['message'] ?? 'unknown error') ); } return $data; } /** * Writes binary data to shared memory. * * @param int $offset The offset to write to. * @param string $data The binary data to write. * * @throws SharedMemoryException */ private function memSet(int $offset, string $data): void { if (!\shmop_write($this->handle, $data, $offset)) { $error = \error_get_last(); throw new SharedMemoryException( 'Failed to write to shared memory block: ' . ($error['message'] ?? 'unknown error') ); } } /** * Requests the shared memory segment to be deleted. * * @throws SharedMemoryException */ private function memDelete(): void { if (!\shmop_delete($this->handle)) { $error = \error_get_last(); throw new SharedMemoryException( 'Failed to discard shared memory block' . ($error['message'] ?? 'unknown error') ); } } private static function makeKey(string $id): int { return \abs(\unpack("l", \md5($id, true))[1]); } } mutex = new ThreadedMutex; $this->storage = new Internal\ParcelStorage($value); } /** * {@inheritdoc} */ public function unwrap(): Promise { return new Success($this->storage->get()); } /** * @return \Amp\Promise */ public function synchronized(callable $callback): Promise { return call(function () use ($callback): \Generator { /** @var \Amp\Sync\Lock $lock */ $lock = yield $this->mutex->acquire(); try { $result = yield call($callback, $this->storage->get()); if ($result !== null) { $this->storage->set($result); } } finally { $lock->release(); } return $result; }); } } channel = new ChannelledStream( $this->read = new ResourceInputStream($read), $this->write = new ResourceOutputStream($write), $serializer ); } /** * {@inheritdoc} */ public function receive(): Promise { return $this->channel->receive(); } /** * {@inheritdoc} */ public function send($data): Promise { return $this->channel->send($data); } public function unreference(): void { $this->read->unreference(); } public function reference(): void { $this->read->reference(); } /** * Closes the read and write resource streams. */ public function close(): void { $this->read->close(); $this->write->close(); } } Resolves with the return value of $callback or fails if $callback * throws an exception. */ public function synchronized(callable $callback): Promise; /** * @return \Amp\Promise A promise for the value inside the parcel. */ public function unwrap(): Promise; } name = $name; $this->trace = $trace; } /** * @deprecated Use ContextPanicError::getOriginalClassName() instead. * * Returns the class name of the uncaught exception. * * @return string */ public function getName(): string { return $this->name; } /** * @deprecated Use ContextPanicError::getOriginalTraceAsString() instead. * * Gets the stack trace at the point the panic occurred. * * @return string */ public function getPanicTrace(): string { return $this->trace; } } * * @throws \Amp\Parallel\Context\StatusError Thrown if the context has not been started. * @throws \Amp\Parallel\Sync\SynchronizationError If the context has not been started or the context * unexpectedly ends. * @throws \Amp\Parallel\Sync\ChannelException If receiving from the channel fails. * @throws \Amp\Parallel\Sync\SerializationException If unserializing the data fails. */ public function receive(): Promise; /** * @param mixed $data * * @return \Amp\Promise Resolves with the number of bytes sent on the channel. * * @throws \Amp\Parallel\Context\StatusError Thrown if the context has not been started. * @throws \Amp\Parallel\Sync\SynchronizationError If the context has not been started or the context * unexpectedly ends. * @throws \Amp\Parallel\Sync\ChannelException If sending on the channel fails. * @throws \Error If an ExitResult object is given. * @throws \Amp\Parallel\Sync\SerializationException If serializing the data fails. */ public function send($data): Promise; } value = $value; } /** * @return mixed */ public function get() { return $this->value; } /** * @param mixed $value */ public function set($value): void { $this->value = $value; } } getTrace(); foreach ($trace as &$call) { unset($call['object']); $call['args'] = \array_map(__NAMESPACE__ . '\\flattenArgument', $call['args'] ?? []); } return $trace; } /** * @param array $trace Backtrace produced by {@see formatFlattenedBacktrace()}. * * @return string */ function formatFlattenedBacktrace(array $trace): string { $output = []; foreach ($trace as $index => $call) { if (isset($call['class'])) { $name = $call['class'] . $call['type'] . $call['function']; } else { $name = $call['function']; } $output[] = \sprintf( '#%d %s(%d): %s(%s)', $index, $call['file'] ?? '[internal function]', $call['line'] ?? 0, $name, \implode(', ', $call['args'] ?? ['...']) ); } return \implode("\n", $output); } /** * @param mixed $value * * @return string Serializable string representation of $value for backtraces. */ function flattenArgument($value): string { if ($value instanceof \Closure) { $closureReflection = new \ReflectionFunction($value); return \sprintf( 'Closure(%s:%s)', $closureReflection->getFileName(), $closureReflection->getStartLine() ); } if (\is_object($value)) { return \sprintf('Object(%s)', \get_class($value)); } if (\is_array($value)) { return 'Array([' . \implode(', ', \array_map(__FUNCTION__, $value)) . '])'; } if (\is_resource($value)) { return \sprintf('Resource(%s)', \get_resource_type($value)); } if (\is_string($value)) { return '"' . $value . '"'; } if (\is_null($value)) { return 'null'; } if (\is_bool($value)) { return $value ? 'true' : 'false'; } return (string) $value; } serializer = $serializer ?? new NativeSerializer; parent::__construct(self::parser($callback, $this->serializer)); } /** * @param mixed $data Data to encode to send over a channel. * * @return string Encoded data that can be parsed by this class. * * @throws SerializationException */ public function encode($data): string { $data = $this->serializer->serialize($data); return \pack("CL", 0, \strlen($data)) . $data; } /** * @param callable $push * @param Serializer $serializer * * @return \Generator * * @throws ChannelException * @throws SerializationException */ private static function parser(callable $push, Serializer $serializer): \Generator { while (true) { $header = yield self::HEADER_LENGTH; $data = \unpack("Cprefix/Llength", $header); if ($data["prefix"] !== 0) { $data = $header . yield; throw new ChannelException("Invalid packet received: " . encodeUnprintableChars($data)); } $data = yield $data["length"]; $push($serializer->unserialize($data)); } } } read = $read; $this->write = $write; $this->received = new \SplQueue; $this->parser = new ChannelParser([$this->received, 'push'], $serializer); } /** * {@inheritdoc} */ public function send($data): Promise { return call(function () use ($data): \Generator { try { return yield $this->write->write($this->parser->encode($data)); } catch (StreamException $exception) { throw new ChannelException("Sending on the channel failed. Did the context die?", 0, $exception); } }); } /** * {@inheritdoc} */ public function receive(): Promise { return call(function (): \Generator { while ($this->received->isEmpty()) { try { $chunk = yield $this->read->read(); } catch (StreamException $exception) { throw new ChannelException("Reading from the channel failed. Did the context die?", 0, $exception); } if ($chunk === null) { throw new ChannelException("The channel closed unexpectedly. Did the context die?"); } $this->parser->push($chunk); } return $this->received->shift(); }); } } result = $result; } /** * {@inheritdoc} */ public function getResult() { return $this->result; } } type = \get_class($exception); $this->message = $exception->getMessage(); $this->code = $exception->getCode(); $this->trace = flattenThrowableBacktrace($exception); if ($previous = $exception->getPrevious()) { $this->previous = new self($previous); } } /** * {@inheritdoc} */ public function getResult() { throw $this->createException(); } private function createException(): ContextPanicError { $previous = $this->previous ? $this->previous->createException() : null; return new ContextPanicError($this->type, $this->message, $this->code, $this->trace, $previous); } } { "name": "amphp/parallel", "description": "Parallel processing component for Amp.", "keywords": [ "asynchronous", "async", "concurrent", "multi-threading", "multi-processing" ], "homepage": "https://github.com/amphp/parallel", "license": "MIT", "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Stephen Coakley", "email": "me@stephencoakley.com" } ], "require": { "php": ">=7.1", "amphp/amp": "^2", "amphp/byte-stream": "^1.6.1", "amphp/parser": "^1", "amphp/process": "^1", "amphp/serialization": "^1", "amphp/sync": "^1.0.1" }, "require-dev": { "phpunit/phpunit": "^8 || ^7", "amphp/phpunit-util": "^1.1", "amphp/php-cs-fixer-config": "dev-master" }, "autoload": { "psr-4": { "Amp\\Parallel\\": "lib" }, "files": [ "lib/Context/functions.php", "lib/Sync/functions.php", "lib/Worker/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Parallel\\Example\\": "examples", "Amp\\Parallel\\Test\\": "test" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "php-cs-fixer fix -v --diff --dry-run", "cs-fix": "php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" } } { "name": "amphp/websocket", "homepage": "https://github.com/amphp/websocket", "description": "Shared code for websocket servers and clients.", "support": { "issues": "https://github.com/amphp/websocket/issues" }, "keywords": [ "async", "non-blocking", "websocket", "http", "amp", "amphp" ], "license": "MIT", "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" }, { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" } ], "require": { "php": ">=7.1", "amphp/amp": "^2.2", "amphp/byte-stream": "^1.6.1", "amphp/socket": "^1", "cash/lrucache": "^1" }, "require-dev": { "phpunit/phpunit": "^8 || ^7", "amphp/phpunit-util": "^1.1.2", "amphp/php-cs-fixer-config": "dev-master", "vimeo/psalm": "^3.11@dev" }, "suggest": { "ext-zlib": "Required for compression" }, "autoload": { "psr-4": { "Amp\\Websocket\\": "src" }, "files": [ "src/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Websocket\\Test\\": "test" }, "files": [ "test/functions.php" ] } } bytesPerSecondLimit = \PHP_INT_MAX; $options->framesPerSecondLimit = \PHP_INT_MAX; $options->messageSizeLimit = 2 ** 30; // 1 GB $options->frameSizeLimit = 2 ** 20 * 100; // 100 MB if (\extension_loaded('zlib')) { $options->compressionEnabled = true; } return $options; } private function __construct() { // Private constructor to require use of named constructors. } /** * @return int Number of bytes that will be buffered when streaming a message * body before sending a frame. */ public function getStreamThreshold(): int { return $this->streamThreshold; } /** * @param int $streamThreshold Number of bytes that will be buffered when * streaming a message body before sending a frame. Default is 32768 (32KB) * * @return self * * @throws \Error if the number is less than 1. */ public function withStreamThreshold(int $streamThreshold): self { if ($streamThreshold < 1) { throw new \Error('$streamThreshold must be a positive integer greater than 0'); } $clone = clone $this; $clone->streamThreshold = $streamThreshold; return $clone; } /** * @return int If a message exceeds this number of bytes, it is split into * multiple frames, each no bigger than this value. */ public function getFrameSplitThreshold(): int { return $this->frameSplitThreshold; } /** * @param int $frameSplitThreshold If a message exceeds this number of bytes, * it is split into multiple frames, each no bigger than this value. * Default is 32768 (32KB) * * @return self * * @throws \Error if number is less than 1. */ public function withFrameSplitThreshold(int $frameSplitThreshold): self { if ($frameSplitThreshold < 1) { throw new \Error('$frameSplitThreshold must be a positive integer greater than 0'); } $clone = clone $this; $clone->frameSplitThreshold = $frameSplitThreshold; return $clone; } /** * @return int Maximum frame size that can be received from the peer. If a * larger frame is received, the connection is ended with a POLICY_VIOLATION. */ public function getFrameSizeLimit(): int { return $this->frameSizeLimit; } /** * @param int $frameSizeLimit Maximum frame size that can be received from the peer. * If a larger frame is received, the connection is ended with a POLICY_VIOLATION. * Default is 2097152 (2MB) * * @return self * * @throws \Error if number is less than 1. */ public function withFrameSizeLimit(int $frameSizeLimit): self { if ($frameSizeLimit < 1) { throw new \Error('$frameSizeLimit must be a positive integer greater than 0'); } $clone = clone $this; $clone->frameSizeLimit = $frameSizeLimit; return $clone; } /** * @return int Maximum number of bytes the peer can send per second before being throttled. */ public function getBytesPerSecondLimit(): int { return $this->bytesPerSecondLimit; } /** * @param int $bytesPerSecond Maximum number of bytes the peer can send per * second before being throttled. Default is 1048576 (1MB) * * @return self * * @throws \Error if number is less than 1. */ public function withBytesPerSecondLimit(int $bytesPerSecond): self { if ($bytesPerSecond < 1) { throw new \Error('$bytesPerSecond must be a positive integer greater than 0'); } $clone = clone $this; $clone->bytesPerSecondLimit = $bytesPerSecond; return $clone; } /** * @return int Maximum number of frames the peer can send per second before being throttled. */ public function getFramesPerSecondLimit(): int { return $this->framesPerSecondLimit; } /** * @param int $framesPerSecond Maximum number of frames the peer can send per * second before being throttled. * * @return self * * @throws \Error if number is less than 1. */ public function withFramesPerSecondLimit(int $framesPerSecond): self { if ($framesPerSecond < 1) { throw new \Error('$bytesPerSecond must be a positive integer greater than 0'); } $clone = clone $this; $clone->framesPerSecondLimit = $framesPerSecond; return $clone; } /** * @return int Maximum message size that can be received from the remote endpoint. * If a larger message is received, the connection is ended with a POLICY_VIOLATION. */ public function getMessageSizeLimit(): int { return $this->messageSizeLimit; } /** * @param int $messageSizeLimit Maximum message size that can be received * from the remote endpoint. If a larger message is received, the connection * is ended with a POLICY_VIOLATION. Default is 10485760 (10MB) * * @return self * * @throws \Error if number is less than 1. */ public function withMessageSizeLimit(int $messageSizeLimit): self { if ($messageSizeLimit < 1) { throw new \Error('$messageSizeLimit must be a positive integer greater than 0'); } $clone = clone $this; $clone->messageSizeLimit = $messageSizeLimit; return $clone; } /** * @return bool If true ends the connection if a binary frame is received. */ public function isTextOnly(): bool { return $this->textOnly; } /** * @param bool $textOnly If true ends the connection if a binary frame is received. * * @return self */ public function withTextOnly(bool $textOnly): self { $clone = clone $this; $clone->textOnly = $textOnly; return $clone; } /** * @return bool If true validates that all text received and sent is UTF-8. */ public function isValidateUtf8(): bool { return $this->validateUtf8; } /** * @param bool $validateUtf8 If true validates that all text received and sent is UTF-8. * * @return self */ public function withValidateUtf8(bool $validateUtf8): self { $clone = clone $this; $clone->validateUtf8 = $validateUtf8; return $clone; } /** * @return int Number of seconds to wait to receive peer close frame. */ public function getClosePeriod(): int { return $this->closePeriod; } /** * @param int $closePeriod Number of seconds to wait to receive peer close * frame. Default is 3. * * @return self * * @throws \Error if number is less than 1. */ public function withClosePeriod(int $closePeriod): self { if ($closePeriod < 1) { throw new \Error('$closePeriod must be a positive integer greater than 0'); } $clone = clone $this; $clone->closePeriod = $closePeriod; return $clone; } /** * @return bool Whether to request or accept per-message compression. */ public function isCompressionEnabled(): bool { return $this->compressionEnabled; } /** * @return self Enables requesting or accepting per-message compression. */ public function withCompression(): self { $clone = clone $this; $clone->compressionEnabled = true; return $clone; } /** * @return self Disables requesting or accepting per-message compression. */ public function withoutCompression(): self { $clone = clone $this; $clone->compressionEnabled = false; return $clone; } /** * @return bool If enabled, sends a ping frame to the peer every X seconds (determined * by the heartbeat period) if there is no other activity on the connection. */ public function isHeartbeatEnabled(): bool { return $this->heartbeatEnabled; } /** * @return self Enables heartbeat; If enabled, sends a ping frame to the * peer every X seconds (determined by the heartbeat period) if there * is no other activity on the connection. */ public function withHeartbeat(): self { $clone = clone $this; $clone->heartbeatEnabled = true; return $clone; } /** * @return self Disables heartbeat; If disabled, will not periodically send * a ping frame to the peer during timetrames of inactivity on the connection. */ public function withoutHeartbeat(): self { $clone = clone $this; $clone->heartbeatEnabled = false; return $clone; } /** * @return int Duration in seconds between pings or other connection activity if the heartbeat is enabled. */ public function getHeartbeatPeriod(): int { return $this->heartbeatPeriod; } /** * @param int $heartbeatPeriod Duration in seconds between pings or other * connection activity if the heartbeat is enabled. Default is 10. * * @return self * * @throws \Error if number is less than 1. */ public function withHeartbeatPeriod(int $heartbeatPeriod): self { if ($heartbeatPeriod < 1) { throw new \Error('$heartbeatPeriod must be a positive integer greater than 0'); } $clone = clone $this; $clone->heartbeatPeriod = $heartbeatPeriod; return $clone; } /** * @return int The number of unanswered pings before the connection is closed. */ public function getQueuedPingLimit(): int { return $this->queuedPingLimit; } /** * @param int $queuedPingLimit The number of unanswered pings before the connection is closed. * * @return self * * @throws \Error if number is less than 1. */ public function withQueuedPingLimit(int $queuedPingLimit): self { if ($queuedPingLimit < 1) { throw new \Error('$queuedPingLimit must be a positive integer greater than 0'); } $clone = clone $this; $clone->queuedPingLimit = $queuedPingLimit; return $clone; } } 'NORMAL_CLOSE', self::GOING_AWAY => 'GOING_AWAY', self::PROTOCOL_ERROR => 'PROTOCOL_ERROR', self::UNACCEPTABLE_TYPE => 'UNACCEPTABLE_TYPE', self::NONE => 'NONE', self::ABNORMAL_CLOSE => 'ABNORMAL_CLOSE', self::INCONSISTENT_FRAME_DATA_TYPE => 'INCONSISTENT_FRAME_DATA_TYPE', self::POLICY_VIOLATION => 'POLICY_VIOLATION', self::MESSAGE_TOO_LARGE => 'MESSAGE_TOO_LARGE', self::EXPECTED_EXTENSION_MISSING => 'EXPECTED_EXTENSION_MISSING', self::UNEXPECTED_SERVER_ERROR => 'UNEXPECTED_SERVER_ERROR', self::SERVICE_RESTARTING => 'SERVICE_RESTARTING', self::TRY_AGAIN_LATER => 'TRY_AGAIN_LATER', self::BAD_GATEWAY => 'BAD_GATEWAY', self::TLS_HANDSHAKE_FAILURE => 'TLS_HANDSHAKE_FAILURE', ][$code] ?? null; } /** * @codeCoverageIgnore Class cannot be instigated. */ private function __construct() { // no instances allowed } } stream = new Payload($stream); $this->binary = $binary; } /** * @return bool True if the message is UTF-8 text, false if it is binary. * * @see Message::isBinary() */ public function isText(): bool { return !$this->binary; } /** * @return bool True if the message is binary, false if it is UTF-8 text. * * @see Message::isText() */ public function isBinary(): bool { return $this->binary; } public function read(): Promise { return $this->stream->read(); } public function buffer(): Promise { return $this->stream->buffer(); } } reason = $reason; } public function getReason(): string { return $this->reason; } } 15) { return null; // Invalid option value. } $clientWindowSize = $value; } $headerOut .= '; client_max_window_bits=' . $clientWindowSize; break; case 'client_no_context_takeover': $clientContextTakeover = false; $headerOut .= '; client_no_context_takeover'; break; case 'server_max_window_bits': if (isset($parts[1])) { $value = (int) $parts[1]; if ($value < 8 || $value > 15) { return null; // Invalid option value. } $serverWindowSize = $value; } $headerOut .= '; server_max_window_bits=' . $serverWindowSize; break; case 'server_no_context_takeover': $serverContextTakeover = false; $headerOut .= '; server_no_context_takeover'; break; default: return null; // Unrecognized option; do not accept extension request. } } if ($isServer) { return new self($clientWindowSize, $serverWindowSize, $clientContextTakeover, $serverContextTakeover); } return new self($serverWindowSize, $clientWindowSize, $serverContextTakeover, $clientContextTakeover); } /** @var resource */ private $deflate; /** @var resource */ private $inflate; /** @var int */ private $sendingFlushMode; /** @var int */ private $receivingFlushMode; private function __construct( int $receivingWindowSize, int $sendingWindowSize, bool $receivingContextTakeover, bool $sendingContextTakeover ) { $this->receivingFlushMode = $receivingContextTakeover ? \ZLIB_SYNC_FLUSH : \ZLIB_FULL_FLUSH; $this->sendingFlushMode = $sendingContextTakeover ? \ZLIB_SYNC_FLUSH : \ZLIB_FULL_FLUSH; if (($this->inflate = \inflate_init(\ZLIB_ENCODING_RAW, ['window' => $receivingWindowSize])) === false) { throw new \RuntimeException('Failed initializing inflate context'); } if (($this->deflate = \deflate_init(\ZLIB_ENCODING_RAW, ['window' => $sendingWindowSize])) === false) { throw new \RuntimeException('Failed initializing deflate context'); } } public function getRsv(): int { return self::RSV; } public function getCompressionThreshold(): int { return self::MINIMUM_LENGTH; } public function decompress(string $data, bool $isFinal): ?string { if ($isFinal) { $data .= self::EMPTY_BLOCK; } $data = \inflate_add($this->inflate, $data, $this->receivingFlushMode); if (false === $data) { return null; } return $data; } public function compress(string $data, bool $isFinal): string { $data = \deflate_add($this->deflate, $data, $this->sendingFlushMode); if ($data === false) { throw new \RuntimeException('Failed to compress data'); } if ($isFinal && \substr($data, -4) === self::EMPTY_BLOCK) { $data = \substr($data, 0, -4); } return $data; } } id = self::$nextId++; $this->connectedAt = $time; $this->compressionEnabled = $compressionEnabled; } } socket = $socket; $this->options = $options; $this->masked = $masked; $this->compressionContext = $compression; $this->closeDeferred = new Deferred; if (self::$watcher === null) { self::$now = getCurrentTime(); self::$heartbeatTimeouts = new class(\PHP_INT_MAX) extends LRUCache implements \IteratorAggregate { public function getIterator(): \Iterator { yield from $this->data; } }; self::$watcher = Loop::repeat(1000, static function (): void { self::$now = getCurrentTime(); self::$bytesReadInLastSecond = []; self::$framesReadInLastSecond = []; if (!empty(self::$rateDeferreds)) { /** @psalm-suppress PossiblyNullArgument */ Loop::unreference(self::$watcher); $rateDeferreds = self::$rateDeferreds; self::$rateDeferreds = []; foreach ($rateDeferreds as $deferred) { $deferred->resolve(); } } foreach (self::$heartbeatTimeouts as $clientId => $expiryTime) { if ($expiryTime >= self::$now) { break; } $client = self::$clients[$clientId]; self::$heartbeatTimeouts->put($clientId, self::$now + $client->options->getHeartbeatPeriod() * 1000); if ($client->getUnansweredPingCount() > $client->options->getQueuedPingLimit()) { $client->close(Code::POLICY_VIOLATION, 'Exceeded unanswered PING limit'); continue; } $client->ping(); } }); Loop::unreference(self::$watcher); } $this->metadata = new ClientMetadata(self::$now, $compression !== null); self::$clients[$this->metadata->id] = $this; if ($this->options->isHeartbeatEnabled()) { self::$heartbeatTimeouts->put($this->metadata->id, self::$now + $this->options->getHeartbeatPeriod() * 1000); } Promise\rethrow(new Coroutine($this->read())); } public function receive(): Promise { if ($this->nextMessageDeferred) { throw new \Error('Await the previous promise returned from receive() before calling receive() again.'); } // There might be messages already buffered and a close frame already received if ($this->messages) { $message = \reset($this->messages); unset($this->messages[\key($this->messages)]); return new Success($message); } if ($this->metadata->closedAt) { return new Success; } $this->nextMessageDeferred = new Deferred; return $this->nextMessageDeferred->promise(); } public function getId(): int { return $this->metadata->id; } public function getUnansweredPingCount(): int { return $this->metadata->pingCount - $this->metadata->pongCount; } public function isConnected(): bool { return !$this->metadata->closedAt; } public function getLocalAddress(): SocketAddress { return $this->socket->getLocalAddress(); } public function getRemoteAddress(): SocketAddress { return $this->socket->getRemoteAddress(); } public function getTlsInfo(): ?TlsInfo { return $this->socket instanceof EncryptableSocket ? $this->socket->getTlsInfo() : null; } public function getCloseCode(): int { if ($this->metadata->closeCode === null) { throw new \Error('The client has not closed'); } return $this->metadata->closeCode; } public function getCloseReason(): string { if ($this->metadata->closeReason === null) { throw new \Error('The client has not closed'); } return $this->metadata->closeReason; } public function isClosedByPeer(): bool { if (!$this->metadata->closedAt) { throw new \Error('The client has not closed'); } return $this->metadata->closedByPeer; } public function getOptions(): Options { return $this->options; } public function getInfo(): ClientMetadata { return clone $this->metadata; } private function read(): \Generator { $maxFramesPerSecond = $this->options->getFramesPerSecondLimit(); $maxBytesPerSecond = $this->options->getBytesPerSecondLimit(); $heartbeatEnabled = $this->options->isHeartbeatEnabled(); $heartbeatPeriod = $this->options->getHeartbeatPeriod() * 1000; $parser = $this->parser(); try { while (($chunk = yield $this->socket->read()) !== null) { if ($chunk === '') { continue; } $this->metadata->lastReadAt = self::$now; $this->metadata->bytesRead += \strlen($chunk); self::$bytesReadInLastSecond[$this->metadata->id] = (self::$bytesReadInLastSecond[$this->metadata->id] ?? 0) + \strlen($chunk); if ($heartbeatEnabled) { self::$heartbeatTimeouts->put($this->metadata->id, self::$now + $heartbeatPeriod); } $parser->send($chunk); $chunk = ''; // Free memory from last chunk read. if ((self::$framesReadInLastSecond[$this->metadata->id] ?? 0) >= $maxFramesPerSecond || (self::$bytesReadInLastSecond[$this->metadata->id] ?? 0) >= $maxBytesPerSecond ) { /** @psalm-suppress PossiblyNullArgument */ Loop::reference(self::$watcher); // Reference watcher to keep loop running until rate limit released. self::$rateDeferreds[$this->metadata->id] = $deferred = new Deferred; yield $deferred->promise(); } if ($this->lastEmit && !$this->metadata->closedAt) { yield $this->lastEmit; } } } catch (\Throwable $exception) { $message = 'TCP connection closed with exception: ' . $exception->getMessage(); } if ($this->closeDeferred !== null) { $deferred = $this->closeDeferred; $this->closeDeferred = null; $deferred->resolve(); } if (!$this->metadata->closedAt) { $this->metadata->closedByPeer = true; $this->close(Code::ABNORMAL_CLOSE, $message ?? 'TCP connection closed unexpectedly'); } } private function onData(int $opcode, string $data, bool $terminated): void { // Ignore further data received after initiating close. if ($this->metadata->closedAt) { return; } $this->metadata->lastDataReadAt = self::$now; ++$this->metadata->framesRead; self::$framesReadInLastSecond[$this->metadata->id] = (self::$framesReadInLastSecond[$this->metadata->id] ?? 0) + 1; if (!$this->currentMessageEmitter) { if ($opcode === Opcode::CONT) { $this->onError( Code::PROTOCOL_ERROR, 'Illegal CONTINUATION opcode; initial message payload frame must be TEXT or BINARY' ); return; } if ($terminated) { $stream = new InMemoryStream($data); ++$this->metadata->messagesRead; } else { $this->currentMessageEmitter = new Emitter; $stream = new IteratorStream($this->currentMessageEmitter->iterate()); } if ($opcode === Opcode::BIN) { $message = Message::fromBinary($stream); } else { $message = Message::fromText($stream); } if ($this->nextMessageDeferred) { $deferred = $this->nextMessageDeferred; $this->nextMessageDeferred = null; $deferred->resolve($message); } else { $this->messages[] = $message; } if ($terminated) { return; } } elseif ($opcode !== Opcode::CONT) { $this->onError( Code::PROTOCOL_ERROR, 'Illegal data type opcode after unfinished previous data type frame; opcode MUST be CONTINUATION' ); return; } $promise = $this->currentMessageEmitter->emit($data); $this->lastEmit = $this->nextMessageDeferred ? null : $promise; if ($terminated) { $emitter = $this->currentMessageEmitter; $this->currentMessageEmitter = null; $emitter->complete(); ++$this->metadata->messagesRead; } } private function onControlFrame(int $opcode, string $data): void { // Close already completed, so ignore any further data from the parser. if ($this->metadata->closedAt && $this->closeDeferred === null) { return; } ++$this->metadata->framesRead; self::$framesReadInLastSecond[$this->metadata->id] = (self::$framesReadInLastSecond[$this->metadata->id] ?? 0) + 1; switch ($opcode) { case Opcode::CLOSE: if ($this->closeDeferred) { $deferred = $this->closeDeferred; $this->closeDeferred = null; $deferred->resolve(); } if ($this->metadata->closedAt) { break; } $this->metadata->closedByPeer = true; $length = \strlen($data); if ($length === 0) { $code = Code::NONE; $reason = ''; } elseif ($length < 2) { $code = Code::PROTOCOL_ERROR; $reason = 'Close code must be two bytes'; } else { $code = \current(\unpack('n', \substr($data, 0, 2))); $reason = \substr($data, 2); if ($code < 1000 // Reserved and unused. || ($code >= 1004 && $code <= 1006) // Should not be sent over wire || ($code >= 1014 && $code <= 1015) // Should not be sent over wire || ($code >= 1016 && $code <= 1999) // Disallowed, reserved for future use || ($code >= 2000 && $code <= 2999) // Disallowed, reserved for Websocket extensions // 3000-3999 allowed, reserved for libraries // 4000-4999 allowed, reserved for applications || $code >= 5000 // >= 5000 invalid ) { $code = Code::PROTOCOL_ERROR; $reason = 'Invalid close code'; } elseif ($this->options->isValidateUtf8() && !\preg_match('//u', $reason)) { $code = Code::INCONSISTENT_FRAME_DATA_TYPE; $reason = 'Close reason must be valid UTF-8'; } } $this->close($code, $reason); break; case Opcode::PING: $this->write($data, Opcode::PONG); break; case Opcode::PONG: if (!\preg_match('/^[1-9][0-9]*$/', $data)) { // Ignore pong payload that is not an integer. break; } // We need a min() here, else someone might just send a pong frame with a very high pong count and // leave TCP connection in open state... Then we'd accumulate connections which never are cleaned up... $this->metadata->pongCount = \min($this->metadata->pingCount, (int) $data); break; } } private function onError(int $code, string $reason): void { $this->close($code, $reason); } public function send(string $data): Promise { \assert((bool) \preg_match('//u', $data), 'Text data must be UTF-8'); return $this->lastWrite = new Coroutine($this->sendData($data, Opcode::TEXT)); } public function sendBinary(string $data): Promise { return $this->lastWrite = new Coroutine($this->sendData($data, Opcode::BIN)); } public function stream(InputStream $stream): Promise { return $this->lastWrite = new Coroutine($this->sendStream($stream, Opcode::TEXT)); } public function streamBinary(InputStream $stream): Promise { return $this->lastWrite = new Coroutine($this->sendStream($stream, Opcode::BIN)); } public function ping(): Promise { $this->metadata->lastHeartbeatAt = self::$now; ++$this->metadata->pingCount; return $this->write((string) $this->metadata->pingCount, Opcode::PING); } private function sendData(string $data, int $opcode): \Generator { if ($this->lastWrite) { yield $this->lastWrite; } ++$this->metadata->messagesSent; $this->metadata->lastDataSentAt = self::$now; $rsv = 0; $compress = false; if ($this->compressionContext && $opcode === Opcode::TEXT && \strlen($data) > $this->compressionContext->getCompressionThreshold() ) { $rsv |= $this->compressionContext->getRsv(); $compress = true; } try { if (\strlen($data) > $this->options->getFrameSplitThreshold()) { $length = \strlen($data); $slices = (int) \ceil($length / $this->options->getFrameSplitThreshold()); $length = (int) \ceil($length / $slices); for ($i = 0; $i < $slices - 1; ++$i) { $chunk = \substr($data, $length * $i, $length); if ($compress) { /** @psalm-suppress PossiblyNullReference */ $chunk = $this->compressionContext->compress($chunk, false); } yield $this->write($chunk, $opcode, $rsv, false); $opcode = Opcode::CONT; $rsv = 0; // RSV must be 0 in continuation frames. } $data = \substr($data, $length * $i, $length); } if ($compress) { /** @psalm-suppress PossiblyNullReference */ $data = $this->compressionContext->compress($data, true); } yield $this->write($data, $opcode, $rsv, true); } catch (StreamException $exception) { $code = Code::ABNORMAL_CLOSE; $reason = 'Writing to the client failed'; yield $this->close($code, $reason); throw new ClosedException('Client unexpectedly closed', $code, $reason); } } private function sendStream(InputStream $stream, int $opcode): \Generator { if ($this->lastWrite) { yield $this->lastWrite; } $rsv = 0; $compress = false; if ($this->compressionContext && $opcode === Opcode::TEXT) { $rsv |= $this->compressionContext->getRsv(); $compress = true; } try { $buffer = yield $stream->read(); if ($buffer === null) { return yield $this->write('', $opcode, 0, true); } $streamThreshold = $this->options->getStreamThreshold(); while (($chunk = yield $stream->read()) !== null) { if ($chunk === '') { continue; } if (\strlen($buffer) < $streamThreshold) { $buffer .= $chunk; continue; } if ($compress) { /** @psalm-suppress PossiblyNullReference */ $buffer = $this->compressionContext->compress($buffer, false); } yield $this->write($buffer, $opcode, $rsv, false); $opcode = Opcode::CONT; $rsv = 0; // RSV must be 0 in continuation frames. $buffer = $chunk; } if ($compress) { /** @psalm-suppress PossiblyNullReference */ $buffer = $this->compressionContext->compress($buffer, true); } yield $this->write($buffer, $opcode, $rsv, true); } catch (StreamException $exception) { $code = Code::ABNORMAL_CLOSE; $reason = 'Writing to the client failed'; yield $this->close($code, $reason); throw new ClosedException('Client unexpectedly closed', $code, $reason); } catch (\Throwable $exception) { yield $this->close(Code::UNEXPECTED_SERVER_ERROR, 'Error while reading message data'); throw $exception; } } private function write(string $data, int $opcode, int $rsv = 0, bool $isFinal = true): Promise { if ($this->metadata->closedAt) { return new Success(0); } $frame = $this->compile($data, $opcode, $rsv, $isFinal); ++$this->metadata->framesSent; $this->metadata->bytesSent += \strlen($frame); $this->metadata->lastSentAt = self::$now; return $this->socket->write($frame); } private function compile(string $data, int $opcode, int $rsv, bool $isFinal): string { $length = \strlen($data); $w = \chr(((int) $isFinal << 7) | ($rsv << 4) | $opcode); $maskFlag = $this->masked ? 0x80 : 0; if ($length > 0xFFFF) { $w .= \chr(0x7F | $maskFlag) . \pack('J', $length); } elseif ($length > 0x7D) { $w .= \chr(0x7E | $maskFlag) . \pack('n', $length); } else { $w .= \chr($length | $maskFlag); } if ($this->masked) { $mask = \random_bytes(4); return $w . $mask . ($data ^ \str_repeat($mask, ($length + 3) >> 2)); } return $w . $data; } public function close(int $code = Code::NORMAL_CLOSE, string $reason = ''): Promise { if ($this->metadata->closedAt) { return new Success([$this->metadata->closeCode, $this->metadata->closeReason]); } return call(function () use ($code, $reason) { try { \assert($code !== Code::NONE || $reason === ''); $promise = $this->write($code !== Code::NONE ? \pack('n', $code) . $reason : '', Opcode::CLOSE); $this->metadata->closedAt = self::$now; $this->metadata->closeCode = $code; $this->metadata->closeReason = $reason; if ($this->currentMessageEmitter) { $emitter = $this->currentMessageEmitter; $this->currentMessageEmitter = null; $emitter->fail(new ClosedException( 'Connection closed while streaming message body', $code, $reason )); } if ($this->nextMessageDeferred) { $deferred = $this->nextMessageDeferred; $this->nextMessageDeferred = null; switch ($code) { case Code::NORMAL_CLOSE: case Code::GOING_AWAY: case Code::NONE: $deferred->resolve(); break; default: $deferred->fail(new ClosedException( 'Connection closed abnormally while awaiting message', $code, $reason )); break; } } yield $promise; // Wait for writing close frame to complete. if ($this->closeDeferred !== null) { // Wait for peer close frame for configured number of seconds. yield Promise\timeout($this->closeDeferred->promise(), $this->options->getClosePeriod() * 1000); } } catch (\Throwable $exception) { // Failed to write close frame or to receive response frame, but we were disconnecting anyway. } $this->socket->close(); $this->lastWrite = null; $this->lastEmit = null; $onClose = $this->onClose; $this->onClose = null; if ($onClose !== null) { foreach ($onClose as $callback) { Promise\rethrow(call($callback, $this, $code, $reason)); } } unset(self::$clients[$this->metadata->id]); self::$heartbeatTimeouts->remove($this->metadata->id); if (empty(self::$clients)) { /** @psalm-suppress PossiblyNullArgument */ Loop::cancel(self::$watcher); self::$watcher = null; self::$heartbeatTimeouts = null; } return [$this->metadata->closeCode, $this->metadata->closeReason]; }); } public function onClose(callable $callback): void { if ($this->onClose === null) { Promise\rethrow(call($callback, $this, $this->metadata->closeCode, $this->metadata->closeReason)); return; } $this->onClose[] = $callback; } /** * A stateful generator websocket frame parser. * * @return \Generator */ private function parser(): \Generator { $frameSizeLimit = $this->options->getFrameSizeLimit(); $messageSizeLimit = $this->options->getMessageSizeLimit(); $textOnly = $this->options->isTextOnly(); $doUtf8Validation = $validateUtf8 = $this->options->isValidateUtf8(); $compressionContext = $this->compressionContext; $compressedFlag = $compressionContext ? $compressionContext->getRsv() : 0; $dataMsgBytesRecd = 0; $savedBuffer = ''; $compressed = false; $buffer = yield; $offset = 0; $bufferSize = \strlen($buffer); while (true) { $payload = ''; // Free memory from last frame payload. while ($bufferSize < 2) { $buffer = \substr($buffer, $offset); $offset = 0; $buffer .= yield; $bufferSize = \strlen($buffer); } $firstByte = \ord($buffer[$offset]); $secondByte = \ord($buffer[$offset + 1]); $offset += 2; $bufferSize -= 2; $final = (bool) ($firstByte & 0b10000000); $rsv = ($firstByte & 0b01110000) >> 4; $opcode = $firstByte & 0b00001111; $isMasked = (bool) ($secondByte & 0b10000000); $maskingKey = ''; $frameLength = $secondByte & 0b01111111; if ($opcode >= 3 && $opcode <= 7) { $this->onError(Code::PROTOCOL_ERROR, 'Use of reserved non-control frame opcode'); return; } if ($opcode >= 11 && $opcode <= 15) { $this->onError(Code::PROTOCOL_ERROR, 'Use of reserved control frame opcode'); return; } $isControlFrame = $opcode >= 0x08; if ($isControlFrame || $opcode === Opcode::CONT) { // Control and continuation frames if ($rsv !== 0) { $this->onError(Code::PROTOCOL_ERROR, 'RSV must be 0 for control or continuation frames'); return; } } else { // Text and binary frames if ($rsv !== 0 && (!$compressionContext || $rsv & ~$compressedFlag)) { $this->onError(Code::PROTOCOL_ERROR, 'Invalid RSV value for negotiated extensions'); return; } $doUtf8Validation = $validateUtf8 && $opcode === Opcode::TEXT; $compressed = (bool) ($rsv & $compressedFlag); } if ($frameLength === 0x7E) { while ($bufferSize < 2) { $buffer = \substr($buffer, $offset); $offset = 0; $buffer .= yield; $bufferSize = \strlen($buffer); } $frameLength = \unpack('n', $buffer[$offset] . $buffer[$offset + 1])[1]; $offset += 2; $bufferSize -= 2; } elseif ($frameLength === 0x7F) { while ($bufferSize < 8) { $buffer = \substr($buffer, $offset); $offset = 0; $buffer .= yield; $bufferSize = \strlen($buffer); } $lengthLong32Pair = \unpack('N2', \substr($buffer, $offset, 8)); $offset += 8; $bufferSize -= 8; if (\PHP_INT_MAX === 0x7fffffff) { if ($lengthLong32Pair[1] !== 0 || $lengthLong32Pair[2] < 0) { $this->onError( Code::MESSAGE_TOO_LARGE, 'Received payload exceeds maximum allowable size' ); return; } $frameLength = $lengthLong32Pair[2]; } else { $frameLength = ($lengthLong32Pair[1] << 32) | $lengthLong32Pair[2]; if ($frameLength < 0) { $this->onError( Code::PROTOCOL_ERROR, 'Most significant bit of 64-bit length field set' ); return; } } } if ($frameLength > 0 && $isMasked === $this->masked) { $this->onError( Code::PROTOCOL_ERROR, 'Payload mask error' ); return; } if ($isControlFrame) { if (!$final) { $this->onError( Code::PROTOCOL_ERROR, 'Illegal control frame fragmentation' ); return; } if ($frameLength > 125) { $this->onError( Code::PROTOCOL_ERROR, 'Control frame payload must be of maximum 125 bytes or less' ); return; } } if ($frameSizeLimit && $frameLength > $frameSizeLimit) { $this->onError( Code::MESSAGE_TOO_LARGE, 'Received payload exceeds maximum allowable size' ); return; } if ($messageSizeLimit && ($frameLength + $dataMsgBytesRecd) > $messageSizeLimit) { $this->onError( Code::MESSAGE_TOO_LARGE, 'Received payload exceeds maximum allowable size' ); return; } if ($textOnly && $opcode === Opcode::BIN) { $this->onError( Code::UNACCEPTABLE_TYPE, 'BINARY opcodes (0x02) not accepted' ); return; } if ($isMasked) { while ($bufferSize < 4) { $buffer = \substr($buffer, $offset); $offset = 0; $buffer .= yield; $bufferSize = \strlen($buffer); } $maskingKey = \substr($buffer, $offset, 4); $offset += 4; $bufferSize -= 4; } while ($bufferSize < $frameLength) { $chunk = yield; $buffer .= $chunk; $bufferSize += \strlen($chunk); } $payload = \substr($buffer, $offset, $frameLength); $buffer = \substr($buffer, $offset + $frameLength); $offset = 0; $bufferSize = \strlen($buffer); if ($isMasked) { // This is memory hungry but it's ~70x faster than iterating byte-by-byte // over the masked string. Deal with it; manual iteration is untenable. /** @psalm-suppress InvalidOperand String operands expected. */ $payload ^= \str_repeat($maskingKey, ($frameLength + 3) >> 2); } if ($isControlFrame) { $this->onControlFrame($opcode, $payload); continue; } $dataMsgBytesRecd += $frameLength; if ($savedBuffer !== '') { $payload = $savedBuffer . $payload; $savedBuffer = ''; } if ($compressed) { /** @psalm-suppress PossiblyNullReference */ $payload = $compressionContext->decompress($payload, $final); if ($payload === null) { // Decompression failed. $this->onError( Code::PROTOCOL_ERROR, 'Invalid compressed data' ); return; } } if ($doUtf8Validation) { if ($final) { $valid = \preg_match('//u', $payload); } else { for ($i = 0; !($valid = \preg_match('//u', $payload)); $i++) { $savedBuffer = \substr($payload, -1) . $savedBuffer; $payload = \substr($payload, 0, -1); if ($i === 3) { // Remove a maximum of three bytes break; } } } /** @psalm-suppress PossiblyUndefinedVariable Defined in either condition above. */ if (!$valid) { $this->onError( Code::INCONSISTENT_FRAME_DATA_TYPE, 'Invalid TEXT data; UTF-8 required' ); return; } } if ($final) { $dataMsgBytesRecd = 0; } $this->onData($opcode, $payload, $final); } } } Resolves to message sent by the remote. * * @throws ClosedException Thrown if the connection is closed. */ public function receive(): Promise; /** * @return int Unique identifier for the client. */ public function getId(): int; /** * @return bool True if the client is still connected, false otherwise. Returns false as soon as the closing * handshake is initiated by the server or client. */ public function isConnected(): bool; /** * @return SocketAddress Local socket address. */ public function getLocalAddress(): SocketAddress; /** * @return SocketAddress Remote socket address. */ public function getRemoteAddress(): SocketAddress; /** * @return TlsInfo|null TlsInfo object if connection is secure. */ public function getTlsInfo(): ?TlsInfo; /** * @return int Number of pings sent that have not been answered. */ public function getUnansweredPingCount(): int; /** * @return int Client close code (generally one of those listed in Code, though not necessarily). * * @throws \Error Thrown if the client has not closed. */ public function getCloseCode(): int; /** * @return string Client close reason. * * @throws \Error Thrown if the client has not closed. */ public function getCloseReason(): string; /** * @return bool True if the peer initiated the websocket close. * * @throws \Error Thrown if the client has not closed. */ public function isClosedByPeer(): bool; /** * Sends a text message to the endpoint. All data sent with this method must be valid UTF-8. Use `sendBinary()` if * you want to send binary data. * * @param string $data Payload to send. * * @return Promise Resolves once the message has been sent to the peer. * * @throws ClosedException Thrown if sending to the client fails. */ public function send(string $data): Promise; /** * Sends a binary message to the endpoint. * * @param string $data Payload to send. * * @return Promise Resolves once the message has been sent to the peer. * * @throws ClosedException Thrown if sending to the client fails. */ public function sendBinary(string $data): Promise; /** * Streams the given UTF-8 text stream to the endpoint. This method should be used only for large payloads such as * files. Use send() for smaller payloads. * * @param InputStream $stream * * @return Promise Resolves once the message has been sent to the peer. * * @throws ClosedException Thrown if sending to the client fails. */ public function stream(InputStream $stream): Promise; /** * Streams the given binary to the endpoint. This method should be used only for large payloads such as * files. Use sendBinary() for smaller payloads. * * @param InputStream $stream * * @return Promise Resolves once the message has been sent to the peer. * * @throws ClosedException Thrown if sending to the client fails. */ public function streamBinary(InputStream $stream): Promise; /** * Sends a ping to the endpoint. * * @return Promise Resolves with the number of bytes sent to the other endpoint. */ public function ping(): Promise; /** * @return Options The options object associated with this client. */ public function getOptions(): Options; /** * Returns connection metadata. * * @return ClientMetadata */ public function getInfo(): ClientMetadata; /** * Closes the client connection. * * @param int $code * @param string $reason * * @return Promise Resolves with an array containing the close code at key 0 and the close reason at key 1. * These may differ from those provided if the connection was closed prior. */ public function close(int $code = Code::NORMAL_CLOSE, string $reason = ''): Promise; /** * Attaches a callback invoked when the client closes. The callback is passed this object as the first parameter, * the close code as the second parameter, and the close reason as the third parameter. * * @param callable(Client $client, int $code, string $reason) $callback */ public function onClose(callable $callback): void; } { "name": "amphp/mysql", "description": "Asynchronous MySQL client for PHP based on Amp.", "license": "MIT", "authors": [ { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" } ], "require": { "php": ">=7.1", "amphp/amp": "^2", "amphp/socket": "^1", "amphp/sql": "^1", "amphp/sql-common": "^1" }, "require-dev": { "ext-openssl": "*", "amphp/process": "^1", "amphp/file": "^2 || ^1 || ^0.3.5", "phpunit/phpunit": "^9 || ^8 || ^7", "amphp/phpunit-util": "^1.1.2", "amphp/php-cs-fixer-config": "dev-master", "phpbench/phpbench": "^0.13.0" }, "autoload": { "psr-4": { "Amp\\Mysql\\": "src" }, "files": [ "src/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Mysql\\Test\\": "test", "Amp\\Mysql\\Bench\\": "benchmarks" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "php-cs-fixer fix -v --diff --dry-run", "cs-fix": "php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit" } } query("SELECT 1 AS value"); while (yield $result->advance()) { $row = $result->getCurrent(); \var_dump($row['value']); } $db->close(); }); query("SELECT a + b FROM tmp; SELECT a - b FROM tmp;"); $i = 0; /** @var Mysql\ResultSet $result */ do { print PHP_EOL . "Query " . ++$i . " Results:" . PHP_EOL; while (yield $result->advance()) { \var_dump($result->getCurrent()); } } while (yield $result->nextResultSet()); // Advances to the next result set. yield $db->query("DROP TABLE tmp"); $db->close(); }); query("SELECT a * b FROM tmp"); $promises[] = $db->execute("SELECT POW(a, ?) AS power FROM tmp", [2]); /** * @var Mysql\ResultSet $result1 * @var Mysql\ResultSet $result2 */ list($result1, $result2) = yield $promises; // Both queries execute simultaneously. Wait for both to finish here. print "Query 1 Results:" . PHP_EOL; while (yield $result1->advance()) { \var_dump($result1->getCurrent()); } print PHP_EOL . "Query 2 Results:" . PHP_EOL; while (yield $result2->advance()) { \var_dump($result2->getCurrent()); } yield $db->query("DROP TABLE tmp"); $db->close(); }); query("CREATE TABLE IF NOT EXISTS tmp (a INT(10), b INT(10))"); print "Table successfully created." . PHP_EOL; /** @var Mysql\Statement $statement */ $statement = yield $db->prepare("INSERT INTO tmp (a, b) VALUES (?, ? * 2)"); $promises = []; foreach (\range(1, 5) as $num) { $promises[] = $statement->execute([$num, $num]); } /* wait until everything is inserted */ yield $promises; print "Insertion successful (if it wasn't, an exception would have been thrown by now)" . PHP_EOL; /** @var Mysql\ResultSet $result */ $result = yield $db->query("SELECT a, b FROM tmp"); while (yield $result->advance()) { \var_dump($result->getCurrent()); } yield $db->query("DROP TABLE tmp"); $db->close(); }); withCharset("latin1_general_ci"); /** @var Mysql\Connection $db */ $db = yield Mysql\connect($config); echo "Character set changed\n"; /* optional, as connection will automatically close when destructed. */ $db->close(); }); beginTransaction(); yield $transaction->execute("INSERT INTO tmp VALUES (?, ? * 2)", [6, 6]); /** @var Mysql\ResultSet $result */ $result = yield $transaction->execute("SELECT * FROM tmp WHERE a >= ?", [5]); // Two rows should be returned. while (yield $result->advance()) { \var_dump($result->getCurrent()); } yield $transaction->rollback(); // Run same query again, should only return a single row since the other was rolled back. $result = yield $db->execute("SELECT * FROM tmp WHERE a >= ?", [5]); while (yield $result->advance()) { \var_dump($result->getCurrent()); } $db->close(); }); query("DROP TABLE IF EXISTS tmp"); yield $db->query("CREATE TABLE tmp (a INT(10), b INT(10))"); $statement = yield $db->prepare("INSERT INTO tmp (a, b) VALUES (?, ? * 2)"); $promises = []; foreach (\range(1, 5) as $num) { $promises[] = $statement->execute([$num, $num]); } return yield $promises; } { "bootstrap": "vendor/autoload.php", "path": "benchmarks", "php_binary": "php_no_xdebug" } processor = $processor; $this->query = $query; $this->stmtId = $stmtId; $this->result = $result; $this->numParamCount = $this->paramCount = $this->result->columnsToFetch; $this->byNamed = $named; foreach ($named as $name => $ids) { foreach ($ids as $id) { $this->named[$id] = $name; $this->numParamCount--; } } $this->lastUsedAt = \time(); } private function getProcessor(): Internal\Processor { if ($this->processor === null) { throw new \Error("The statement has been closed"); } if (!$this->processor->isAlive()) { throw new ConnectionException("Connection went away"); } return $this->processor; } public function isAlive(): bool { if ($this->processor === null) { return false; } return $this->processor->isAlive(); } /** {@inheritdoc} */ public function bind($paramId, $data): void { if (\is_int($paramId)) { if ($paramId >= $this->numParamCount) { throw new \Error("Parameter id $paramId is not defined for this prepared statement"); } $i = $paramId; } elseif (\is_string($paramId)) { if (!isset($this->byNamed[$paramId])) { throw new \Error("Parameter :$paramId is not defined for this prepared statement"); } $array = $this->byNamed[$paramId]; $i = \reset($array); } else { throw new \TypeError("Invalid parameter ID type"); } if (!\is_scalar($data) && !(\is_object($data) && \method_exists($data, '__toString'))) { throw new \TypeError("Data must be scalar or object that implements __toString method"); } do { $realId = -1; while (isset($this->named[++$realId]) || $i-- > 0) { if (!\is_numeric($paramId) && isset($this->named[$realId]) && $this->named[$realId] == $paramId) { break; } } $this->getProcessor()->bindParam($this->stmtId, $realId, $data); } while (isset($array) && $i = \next($array)); if (isset($this->prebound[$paramId])) { $this->prebound[$paramId] .= (string) $data; } else { $this->prebound[$paramId] = (string) $data; } } /** {@inheritdoc} */ public function execute(array $params = []): Promise { $this->lastUsedAt = \time(); $prebound = $args = []; for ($unnamed = $i = 0; $i < $this->paramCount; $i++) { if (isset($this->named[$i])) { $name = $this->named[$i]; if (\array_key_exists($name, $params)) { $args[$i] = $params[$name]; } elseif (!\array_key_exists($name, $this->prebound)) { throw new \Error("Named parameter '$name' missing for executing prepared statement"); } else { $prebound[$i] = $this->prebound[$name]; } } elseif (\array_key_exists($unnamed, $params)) { $args[$i] = $params[$unnamed]; $unnamed++; } elseif (!\array_key_exists($unnamed, $this->prebound)) { throw new \Error("Parameter $unnamed for prepared statement missing"); } else { $prebound[$i] = $this->prebound[$unnamed++]; } } return call(function () use ($prebound, $args) { $result = yield $this->getProcessor() ->execute($this->stmtId, $this->query, $this->result->params, $prebound, $args); if ($result instanceof Internal\ResultProxy) { $result = new ConnectionResultSet($result); return $result; } if ($result instanceof CommandResult) { return $result; } throw new FailureException("Unrecognized result type"); }); } public function getQuery(): string { return $this->query; } private function close(): void { if ($this->processor === null) { return; } $this->processor->closeStmt($this->stmtId); $this->processor->unreference(); $this->processor = null; } public function reset(): Promise { return $this->getProcessor()->resetStmt($this->stmtId); } public function getFields(): Promise { if ($this->result->state >= Internal\ResultProxy::COLUMNS_FETCHED) { return new Success($this->result->columns); } if (isset($this->result->deferreds[Internal\ResultProxy::COLUMNS_FETCHED][0])) { return $this->result->deferreds[Internal\ResultProxy::COLUMNS_FETCHED][0][0]->promise(); } $deferred = new Deferred; $this->result->deferreds[Internal\ResultProxy::COLUMNS_FETCHED][0] = [$deferred, &$this->result->columns, null]; return $deferred->promise(); } /** {@inheritdoc} */ public function getLastUsedAt(): int { return $this->lastUsedAt; } public function __destruct() { $this->close(); } } affectedRows = $affectedRows; $this->lastInsertId = $lastInsertId; } /** * @return int Number of rows affected by the modification query. */ public function getAffectedRowCount(): int { return $this->affectedRows; } /** * @return int Insert ID of the last auto increment row. */ public function getLastInsertId(): int { return $this->lastInsertId; } } */ public function getFields(): Promise; /** * Reset statement to state just after preparing. * * @return Promise */ public function reset(): Promise; } result = $result; $this->producer = self::makeIterator($result); } private static function makeIterator(Internal\ResultProxy $result): Iterator { return new Producer(static function (callable $emit) use ($result) { $row = yield self::fetchRow($result); while ($row !== null) { $next = self::fetchRow($result); // Fetch next row while emitting last row. yield $emit($row); $row = yield $next; } }); } public function __destruct() { if (!$this->result) { return; } $producer = $this->producer; asyncCall(static function () use ($producer) { try { while (yield $producer->advance()); } catch (\Throwable $exception) { // Ignore iterator failure when destroying. } }); } /** * {@inheritdoc} */ public function advance(): Promise { $this->currentRow = null; return $this->producer->advance(); } /** * {@inheritdoc} */ public function getCurrent(): array { if ($this->currentRow !== null) { return $this->currentRow; } if (!$this->columnNames) { $this->columnNames = \array_column($this->result->columns, "name"); } return $this->currentRow = \array_combine($this->columnNames, $this->producer->getCurrent()); } private static function fetchRow(Internal\ResultProxy $result): Promise { if ($result->userFetched < $result->fetchedRows) { $row = $result->rows[$result->userFetched]; unset($result->rows[$result->userFetched]); $result->userFetched++; return new Success($row); } if ($result->state === Internal\ResultProxy::ROWS_FETCHED) { return new Success; } $deferred = new Deferred; /* We need to increment the internal counter, else the next time fetch is called, * it'll simply return the row we fetch here instead of fetching a new row * since callback order on promises isn't defined, we can't do this via onResolve() */ $incRow = function ($row) use ($result) { unset($result->rows[$result->userFetched++]); return $row; }; $result->deferreds[Internal\ResultProxy::UNFETCHED][] = [$deferred, null, $incRow]; return $deferred->promise(); } /** * @return Promise Resolves with true if another result set exists, false if all result sets have * been consumed. */ public function nextResultSet(): Promise { if (!$this->result) { return new Success(false); } return call(function () { while (yield $this->advance()); // Consume any values left in the current result. $this->columnNames = null; $deferred = $this->result->next ?: $this->result->next = new Deferred; $this->result = yield $deferred->promise(); if ($this->result) { $this->producer = self::makeIterator($this->result); return true; } return false; }); } /** * @return Promise * * @throws \Error If nextResultSet() has been invoked and no further result sets were available. */ public function getFields(): Promise { if ($this->result === null) { throw new \Error("The current result set is empty; call this method before invoking ResultSet::nextResultSet()"); } if ($this->result->state >= Internal\ResultProxy::COLUMNS_FETCHED) { return new Success($this->result->columns); } $deferred = new Deferred; $this->result->deferreds[Internal\ResultProxy::COLUMNS_FETCHED][] = [$deferred, &$this->result->columns, null]; return $deferred->promise(); } } connector = $connector ?? Socket\connector(); } public function connect(SqlConnectionConfig $config, ?CancellationToken $token = null): Promise { if (!$config instanceof ConnectionConfig) { throw new \TypeError(\sprintf("Must provide an instance of %s to MySQL connectors", ConnectionConfig::class)); } return Connection::connect($config, $token, $this->connector); } } statement = $statement; } protected function createResultSet(SqlResultSet $resultSet, callable $release): SqlResultSet { \assert($resultSet instanceof ResultSet); return new PooledResultSet($resultSet, $release); } public function bind($paramId, $data): void { $this->statement->bind($paramId, $data); } public function getFields(): Promise { return $this->statement->getFields(); } public function reset(): Promise { return $this->statement->reset(); } } Resolves with true if another result set exists, false if all result sets have * been consumed. */ public function nextResultSet(): Promise; /** * @return Promise * * @throws \Error If nextResultSet() has been invoked and no further result sets were available. */ public function getFields(): Promise; } 'host', 'username' => 'user', 'pass' => 'password', 'database' => 'db', 'dbname' => 'db', 'compress' => 'compression', 'useCompression' => 'compression', 'cs' => 'charset', 'localInfile' => 'local-infile', ]; public const DEFAULT_CHARSET = "utf8mb4"; public const DEFAULT_COLLATE = "utf8mb4_general_ci"; /** @var bool */ private $useCompression = false; /** @var bool */ private $useLocalInfile = false; /** @var ConnectContext */ private $context; /** @var string */ private $charset = "utf8mb4"; /** @var string */ private $collate = "utf8mb4_general_ci"; /* @var string private key to use for sha256_password auth method */ private $key; public static function fromString(string $connectionString, ConnectContext $context = null): self { $parts = self::parseConnectionString($connectionString, self::KEY_MAP); if (!isset($parts['host'])) { throw new \Error('Host must be provided in connection string'); } return new self( $parts['host'], (int) ($parts['port'] ?? self::DEFAULT_PORT), $parts['user'] ?? null, $parts['password'] ?? null, $parts['db'] ?? null, $context, $parts['charset'] ?? self::DEFAULT_CHARSET, $parts['collate'] ?? self::DEFAULT_COLLATE, ($parts['compression'] ?? '') === 'on', ($parts['local-infile'] ?? '') === 'on' ); } public function __construct( string $host, int $port = self::DEFAULT_PORT, string $user = null, string $password = null, string $database = null, ConnectContext $context = null, string $charset = self::DEFAULT_CHARSET, string $collate = self::DEFAULT_COLLATE, bool $useCompression = false, string $key = '', bool $useLocalInfile = false ) { parent::__construct($host, $port, $user, $password, $database); $this->context = $context ?? (new ConnectContext); $this->charset = $charset; $this->collate = $collate; $this->useCompression = $useCompression; $this->key = $key; $this->useLocalInfile = $useLocalInfile; } public function getConnectionString(): string { return $this->getHost()[0] == "/" ? 'unix://' . $this->getHost() : 'tcp://' . $this->getHost() . ':' . $this->getPort(); } public function isCompressionEnabled(): bool { return $this->useCompression; } public function withCompression(): self { $new = clone $this; $new->useCompression = true; return $new; } public function withoutCompression(): self { $new = clone $this; $new->useCompression = false; return $new; } public function isLocalInfileEnabled(): bool { return $this->useLocalInfile; } public function withLocalInfile(): self { $new = clone $this; $new->useLocalInfile = true; return $new; } public function withoutLocalInfile(): self { $new = clone $this; $new->useLocalInfile = false; return $new; } public function getConnectContext() { return $this->context; } public function withConnectContext(ConnectContext $context): self { $new = clone $this; $new->context = $context; return $new; } public function getCharset(): string { return $this->charset; } public function getCollation(): string { return $this->collate; } public function withCharset(string $charset = self::DEFAULT_CHARSET, string $collate = self::DEFAULT_COLLATE): self { $new = clone $this; $new->charset = $charset; $new->collate = $collate; return $new; } public function getKey(): string { return $this->key; } public function withKey(string $key): self { $new = clone $this; $new->key = $key; return $new; } } [], self::COLUMNS_FETCHED => [], self::ROWS_FETCHED => []]; /** @var int */ public $state = self::UNFETCHED; /** @var \Amp\Deferred|null */ public $next; public const UNFETCHED = 0; public const COLUMNS_FETCHED = 1; public const ROWS_FETCHED = 2; public const SINGLE_ROW_FETCH = 255; public function setColumns(int $columns): void { $this->columnCount = $this->columnsToFetch = $columns; } public function updateState(int $state): void { $this->state = $state; if ($state === self::ROWS_FETCHED) { $this->rowFetched(null); } if (empty($this->deferreds[$state])) { return; } foreach ($this->deferreds[$state] as [$deferred, $rows, $cb]) { $deferred->resolve($cb ? $cb($rows) : $rows); } $this->deferreds[$state] = []; } public function rowFetched(?array $row): void { if ($row !== null) { $this->rows[$this->fetchedRows++] = $row; } [$entry, , $cb] = \current($this->deferreds[self::UNFETCHED]); if ($entry !== null) { unset($this->deferreds[self::UNFETCHED][\key($this->deferreds[self::UNFETCHED])]); $entry->resolve($cb && $row ? $cb($row) : $row); } } public function fail(FailureException $e): void { foreach ($this->deferreds as $state) { foreach ($this->deferreds[$state] as [$deferred]) { $deferred->fail($e); } $this->deferreds[$state] = []; } } /** * @return array * * @codeCoverageIgnore */ public function __debugInfo(): array { $tmp = clone $this; foreach ($tmp->deferreds as &$type) { foreach ($type as &$entry) { unset($entry[0], $entry[2]); } } return (array) $tmp; } } socket = $socket; $this->connInfo = new ConnectionState; $this->config = $config; $this->lastUsedAt = \time(); } public function isAlive(): bool { return $this->connectionState <= self::READY; } public function isReady(): bool { return $this->connectionState === self::READY; } public function unreference(): void { if (!--$this->refcount) { $this->appendTask(function () { $this->close(); }); } } private function ready(): void { if (!empty($this->deferreds)) { return; } if (!empty($this->onReady)) { \array_shift($this->onReady)(); return; } $this->resetIds(); if ($this->socket) { try { $this->socket->unreference(); } catch (Loop\InvalidWatcherError $exception) { // Undefined destruct order can cause unref of an invalid watcher if the loop is swapped. // Generally this will only happen during tests. } } } private function addDeferred(Deferred $deferred): void { \assert($this->socket, "The connection has been closed"); $this->deferreds[] = $deferred; $this->socket->reference(); } public function connect(CancellationToken $token): Promise { \assert(!$this->processors, self::class."::connect() must not be called twice"); $this->deferreds[] = $deferred = new Deferred; // Will be resolved in sendHandshake(). $this->processors = [$this->parseMysql()]; $id = $token->subscribe(function (): void { $this->close(); }); Promise\rethrow(new Coroutine($this->read())); $promise = $deferred->promise(); $promise->onResolve(static function () use ($id, $token): void { $token->unsubscribe($id); }); if ($this->config->getCharset() !== ConnectionConfig::DEFAULT_CHARSET || $this->config->getCollation() !== ConnectionConfig::DEFAULT_COLLATE) { $promise->onResolve(function (?\Throwable $exception): void { if ($exception) { return; } $charset = $this->config->getCharset(); $collate = $this->config->getCollation(); $this->query("SET NAMES '$charset'" . ($collate === "" ? "" : " COLLATE '$collate'")); }); } return $promise; } private function read(): \Generator { try { while (($bytes = yield $this->socket->read()) !== null) { // @codeCoverageIgnoreStart \assert((function () use ($bytes) { if (\defined("MYSQL_DEBUG")) { \fwrite(STDERR, "in: "); for ($i = 0; $i < \min(\strlen($bytes), 200); $i++) { \fwrite(STDERR, \dechex(\ord($bytes[$i])) . " "); } $r = \range("\0", "\x1f"); unset($r[10], $r[9]); \fwrite(STDERR, "len: " . \strlen($bytes) . "\n"); \fwrite(STDERR, \str_replace($r, ".", \substr($bytes, 0, 200)) . "\n"); } return true; })()); // @codeCoverageIgnoreEnd $this->lastUsedAt = \time(); $this->processData($bytes); $bytes = null; // Free last data read. if (!$this->socket) { // Connection closed. break; } } } catch (\Throwable $exception) { // $exception used as previous exception below. } finally { $this->close(); } if (!empty($this->deferreds) || $this->result) { $exception = new ConnectionException("Connection closed unexpectedly", 0, $exception ?? null); $result = $this->result; $this->result = null; if ($result) { $result->fail($exception); } foreach ($this->deferreds as $deferred) { $deferred->fail($exception); } } } private function processData(string $data): void { foreach ($this->processors as $processor) { if (empty($data = $processor->send($data))) { return; } } \assert(\is_array($data), "Final processor should yield an array"); foreach ($data as $packet) { $this->parsePayload($packet); } } private function getDeferred(): Deferred { return \array_shift($this->deferreds); } private function appendTask(callable $callback): void { if ($this->packetCallback || $this->parseCallback || !empty($this->onReady) || !empty($this->deferreds) || $this->connectionState !== self::READY ) { $this->onReady[] = $callback; } else { $callback(); } } public function getConnInfo(): ConnectionState { return clone $this->connInfo; } public function getConnectionId(): int { return $this->connectionId; } public function getLastUsedAt(): int { return $this->lastUsedAt; } protected function startCommand(callable $callback): Promise { if ($this->connectionState > self::READY) { throw new \Error("The connection has been closed"); } $deferred = new Deferred; $this->appendTask(function () use ($callback, $deferred) { $this->seqId = $this->compressionId = -1; $this->addDeferred($deferred); $callback(); }); return $deferred->promise(); } public function setCharset(string $charset, string $collate = ""): Promise { return \Amp\call(function () use ($charset, $collate) { if ($collate === "" && false !== $off = \strpos($charset, "_")) { $collate = $charset; $charset = \substr($collate, 0, $off); } $query = "SET NAMES '$charset'" . ($collate === "" ? "" : " COLLATE '$collate'"); $result = yield $this->query($query); $this->config = $this->config->withCharset($charset, $collate); return $result; }); } /** @see 14.6.3 COM_INIT_DB */ public function useDb(string $db): Promise { return $this->startCommand(function () use ($db) { $this->config = $this->config->withDatabase($db); $this->write("\x02$db"); }); } /** @see 14.6.4 COM_QUERY */ public function query(string $query): Promise { return $this->startCommand(function () use ($query) { $this->query = $query; $this->parseCallback = [$this, "handleQuery"]; $this->write("\x03$query"); }); } /** @see 14.7.4 COM_STMT_PREPARE */ public function prepare(string $query): Promise { return $this->startCommand(function () use ($query) { $this->query = $query; $this->parseCallback = [$this, "handlePrepare"]; $query = \preg_replace_callback(self::STATEMENT_PARAM_REGEX, function ($m) { static $index = 0; if ($m[2] !== "?") { $this->named[$m[3]][] = $index; } $index++; return "?"; }, $query); $this->write("\x16$query"); }); } /** @see 14.6.18 COM_CHANGE_USER */ /* @TODO broken, my test server doesn't support that command, can't test now public function changeUser($user, $pass, $db = null) { return $this->startCommand(function() use ($user, $pass, $db) { $this->config->user = $user; $this->config->pass = $pass; $this->config->db = $db; $payload = "\x11"; $payload .= "$user\0"; $auth = $this->secureAuth($this->config->pass, $this->authPluginData); if ($this->capabilities & self::CLIENT_SECURE_CONNECTION) { $payload .= ord($auth) . $auth; } else { $payload .= "$auth\0"; } $payload .= "$db\0"; $this->write($payload); $this->parseCallback = [$this, "authSwitchRequest"]; }); } */ /** @see 14.6.15 COM_PING */ public function ping(): Promise { return $this->startCommand(function () { $this->write("\x0e"); }); } /** @see 14.6.19 COM_RESET_CONNECTION */ public function resetConnection(): Promise { return $this->startCommand(function () { $this->write("\x1f"); }); } /** @see 14.7.5 COM_STMT_SEND_LONG_DATA */ public function bindParam(int $stmtId, int $paramId, string $data): void { $payload = "\x18"; $payload .= DataTypes::encodeInt32($stmtId); $payload .= DataTypes::encodeInt16($paramId); $payload .= $data; $this->appendTask(function () use ($payload) { $this->resetIds(); $this->write($payload); $this->ready(); }); } /** @see 14.7.6 COM_STMT_EXECUTE */ // prebound params: null-bit set, type MYSQL_TYPE_LONG_BLOB, no value // $params is by-ref, because the actual result object might not yet have been filled completely with data upon call of this method ... public function execute(int $stmtId, string $query, array &$params, array $prebound, array $data = []): Promise { $deferred = new Deferred; $this->appendTask(function () use ($stmtId, $query, &$params, $prebound, $data, $deferred) { $payload = "\x17"; $payload .= DataTypes::encodeInt32($stmtId); $payload .= \chr(0); // cursor flag // @TODO cursor types?! $payload .= DataTypes::encodeInt32(1); $paramCount = \count($params); $bound = !empty($data) || !empty($prebound); $types = ""; $values = ""; if ($paramCount) { $args = $data + \array_fill(0, $paramCount, null); \ksort($args); $args = \array_slice($args, 0, $paramCount); $nullOff = \strlen($payload); $payload .= \str_repeat("\0", ($paramCount + 7) >> 3); foreach ($args as $paramId => $param) { if ($param === null) { $off = $nullOff + ($paramId >> 3); $payload[$off] = $payload[$off] | \chr(1 << ($paramId % 8)); } else { $bound = 1; } $paramType = $params[$paramId]['type'] ?? null; if ($paramType === null) { $deferred->fail(new \RuntimeException("Type not found for param ID $paramId")); return; } list($unsigned, $type, $value) = DataTypes::encodeBinary($param); if (isset($prebound[$paramId])) { if (!DataTypes::isBindable($paramType)) { $deferred->fail(new FailureException("Cannot use bind with columns of type " . $paramType)); return; } $types .= \chr(DataTypes::MYSQL_TYPE_LONG_BLOB); } else { if ($paramType === DataTypes::MYSQL_TYPE_JSON && $type === DataTypes::MYSQL_TYPE_LONG_BLOB) { $type = DataTypes::MYSQL_TYPE_JSON; } $types .= \chr($type); } $types .= $unsigned?"\x80":"\0"; $values .= $value; } $payload .= \chr($bound); if ($bound) { $payload .= $types; $payload .= $values; } } $this->query = $query; $this->resetIds(); $this->addDeferred($deferred); $this->write($payload); // apparently LOAD DATA LOCAL INFILE requests are not supported via prepared statements $this->packetCallback = [$this, "handleExecute"]; }); return $deferred->promise(); // do not use $this->startCommand(), that might unexpectedly reset the seqId! } /** @see 14.7.7 COM_STMT_CLOSE */ public function closeStmt(int $stmtId): void { $payload = "\x19" . DataTypes::encodeInt32($stmtId); $this->appendTask(function () use ($payload) { if ($this->connectionState === self::READY) { $this->resetIds(); $this->write($payload); $this->resetIds(); // does not expect a reply - must be reset immediately } $this->ready(); }); } /** @see 14.6.5 COM_FIELD_LIST */ public function listFields(string $table, string $like = "%"): Promise { return $this->startCommand(static function () use ($table, $like) { $this->write("\x04$table\0$like"); $this->parseCallback = [$this, "handleFieldlist"]; }); } public function listAllFields(string $table, string $like = "%"): Promise { $deferred = new Deferred; $columns = []; $onResolve = function ($error, $array) use (&$columns, &$onResolve, $deferred) { if ($error) { $deferred->fail($error); return; } if ($array === null) { $deferred->resolve($columns); return; } list($columns[], $promise) = $array; $promise->onResolve($onResolve); }; $this->listFields($table, $like)->onResolve($onResolve); return $deferred->promise(); } /** @see 14.6.6 COM_CREATE_DB */ public function createDatabase(string $db): Promise { return $this->startCommand(function () use ($db) { $this->write("\x05$db"); }); } /** @see 14.6.7 COM_DROP_DB */ public function dropDatabase(string $db): Promise { return $this->startCommand(function () use ($db) { $this->write("\x06$db"); }); } /** * @param $subcommand int one of the self::REFRESH_* constants * @see 14.6.8 COM_REFRESH */ public function refresh(int $subcommand): Promise { return $this->startCommand(function () use ($subcommand) { $this->write("\x07" . \chr($subcommand)); }); } /** @see 14.6.9 COM_SHUTDOWN */ public function shutdown(): Promise { return $this->startCommand(function () { $this->write("\x08\x00"); /* SHUTDOWN_DEFAULT / SHUTDOWN_WAIT_ALL_BUFFERS, only one in use */ }); } /** @see 14.6.10 COM_STATISTICS */ public function statistics(): Promise { return $this->startCommand(function () { $this->write("\x09"); $this->parseCallback = [$this, "readStatistics"]; }); } /** @see 14.6.11 COM_PROCESS_INFO */ public function processInfo(): Promise { return $this->startCommand(function () { $this->write("\x0a"); $this->query("SHOW PROCESSLIST"); }); } /** @see 14.6.13 COM_PROCESS_KILL */ public function killProcess(int $process): Promise { return $this->startCommand(function () use ($process) { $this->write("\x0c" . DataTypes::encodeInt32($process)); }); } /** @see 14.6.14 COM_DEBUG */ public function debugStdout(): Promise { return $this->startCommand(function () { $this->write("\x0d"); }); } /** @see 14.7.8 COM_STMT_RESET */ public function resetStmt(int $stmtId): Promise { $payload = "\x1a" . DataTypes::encodeInt32($stmtId); $deferred = new Deferred; $this->appendTask(function () use ($payload, $deferred) { $this->resetIds(); $this->addDeferred($deferred); $this->write($payload); }); return $deferred->promise(); } /** @see 14.8.4 COM_STMT_FETCH */ public function fetchStmt(int $stmtId): Promise { $payload = "\x1c" . DataTypes::encodeInt32($stmtId) . DataTypes::encodeInt32(1); $deferred = new Deferred; $this->appendTask(function () use ($payload, $deferred) { $this->resetIds(); $this->addDeferred($deferred); $this->write($payload); }); return $deferred->promise(); } private function established(): void { // @TODO flags to use? $this->capabilities |= self::CLIENT_SESSION_TRACK | self::CLIENT_TRANSACTIONS | self::CLIENT_PROTOCOL_41 | self::CLIENT_SECURE_CONNECTION | self::CLIENT_MULTI_RESULTS | self::CLIENT_PS_MULTI_RESULTS | self::CLIENT_MULTI_STATEMENTS | self::CLIENT_PLUGIN_AUTH | self::CLIENT_PLUGIN_AUTH_LENENC_CLIENT_DATA; if (\extension_loaded("zlib") && $this->config->isCompressionEnabled()) { $this->capabilities |= self::CLIENT_COMPRESS; } if ($this->config->isLocalInfileEnabled()) { $this->capabilities |= self::CLIENT_LOCAL_INFILE; } } /** @see 14.1.3.2 ERR-Packet */ private function handleError(string $packet): void { $off = 1; $this->connInfo->errorCode = DataTypes::decodeUnsigned16(\substr($packet, $off, 2)); $off += 2; if ($this->capabilities & self::CLIENT_PROTOCOL_41) { $this->connInfo->errorState = \substr($packet, $off, 6); $off += 6; } $this->connInfo->errorMsg = \substr($packet, $off); $this->parseCallback = null; if ($this->connectionState < self::READY) { // connection failure $this->close(); $this->getDeferred()->fail(new InitializationException("Could not connect to {$this->config->getConnectionString()}: {$this->connInfo->errorState} {$this->connInfo->errorMsg}")); return; } if ($this->result === null && empty($this->deferreds)) { // connection killed without pending query or active result $this->close(); return; } $deferred = $this->result ?? $this->getDeferred(); // normal error $exception = new QueryError("MySQL error ({$this->connInfo->errorCode}): {$this->connInfo->errorState} {$this->connInfo->errorMsg}", $this->query); $this->result = null; $this->query = null; $deferred->fail($exception); $this->ready(); } /** @see 14.1.3.1 OK-Packet */ private function parseOk(string $packet): void { $off = 1; $this->connInfo->affectedRows = DataTypes::decodeUnsigned(\substr($packet, $off), $intlen); $off += $intlen; $this->connInfo->insertId = DataTypes::decodeUnsigned(\substr($packet, $off), $intlen); $off += $intlen; if ($this->capabilities & (self::CLIENT_PROTOCOL_41 | self::CLIENT_TRANSACTIONS)) { $this->connInfo->statusFlags = DataTypes::decodeUnsigned16(\substr($packet, $off)); $off += 2; $this->connInfo->warnings = DataTypes::decodeUnsigned16(\substr($packet, $off)); $off += 2; } if ($this->capabilities & self::CLIENT_SESSION_TRACK) { // Even though it seems required according to 14.1.3.1, there is no length encoded string, i.e. no trailing NULL byte ....??? if (\strlen($packet) > $off) { $this->connInfo->statusInfo = DataTypes::decodeStringOff(DataTypes::MYSQL_TYPE_STRING, $packet, $off); if ($this->connInfo->statusFlags & StatusFlags::SERVER_SESSION_STATE_CHANGED) { $sessionState = DataTypes::decodeString(\substr($packet, $off), $intlen, $sessionStateLen); $len = 0; while ($len < $sessionStateLen) { $data = DataTypes::decodeString(\substr($sessionState, $len + 1), $datalen, $intlen); switch ($type = DataTypes::decodeUnsigned8(\substr($sessionState, $len))) { case SessionStateTypes::SESSION_TRACK_SYSTEM_VARIABLES: $var = DataTypes::decodeString($data, $varintlen, $strlen); $this->connInfo->sessionState[$type][$var] = DataTypes::decodeString(\substr($data, $varintlen + $strlen)); break; case SessionStateTypes::SESSION_TRACK_SCHEMA: case SessionStateTypes::SESSION_TRACK_STATE_CHANGE: case SessionStateTypes::SESSION_TRACK_GTIDS: case SessionStateTypes::SESSION_TRACK_TRANSACTION_CHARACTERISTICS: case SessionStateTypes::SESSION_TRACK_TRANSACTION_STATE: $this->connInfo->sessionState[$type] = DataTypes::decodeString($data); break; default: throw new \Error("$type is not a valid mysql session state type"); } $len += 1 + $intlen + $datalen; } } } else { $this->connInfo->statusInfo = ""; } } else { $this->connInfo->statusInfo = \substr($packet, $off); } } private function handleOk(string $packet): void { $this->parseOk($packet); $this->getDeferred()->resolve(new CommandResult($this->connInfo->affectedRows, $this->connInfo->insertId)); $this->ready(); } /** @see 14.1.3.3 EOF-Packet */ private function parseEof(string $packet): void { if ($this->capabilities & self::CLIENT_PROTOCOL_41) { $this->connInfo->warnings = DataTypes::decodeUnsigned16(\substr($packet, 1)); $this->connInfo->statusFlags = DataTypes::decodeUnsigned16(\substr($packet, 3)); } } private function handleEof(string $packet): void { $this->parseEof($packet); $exception = new FailureException($this->connInfo->errorMsg, $this->connInfo->errorCode); $this->getDeferred()->fail($exception); $this->ready(); } /** @see 14.2.5 Connection Phase Packets */ private function handleHandshake(string $packet): void { $off = 1; $this->protocol = \ord($packet); if ($this->protocol !== 0x0a) { throw new ConnectionException("Unsupported protocol version ".\ord($packet)." (Expected: 10)"); } $this->connInfo->serverVersion = DataTypes::decodeNullString(\substr($packet, $off), $len); $off += $len + 1; $this->connectionId = DataTypes::decodeUnsigned32(\substr($packet, $off)); $off += 4; $this->authPluginData = \substr($packet, $off, 8); $off += 8; $off += 1; // filler byte $this->serverCapabilities = DataTypes::decodeUnsigned16(\substr($packet, $off)); $off += 2; if (\strlen($packet) > $off) { $this->connInfo->charset = \ord(\substr($packet, $off)); $off += 1; $this->connInfo->statusFlags = DataTypes::decodeUnsigned16(\substr($packet, $off)); $off += 2; $this->serverCapabilities += DataTypes::decodeUnsigned16(\substr($packet, $off)) << 16; $off += 2; $this->authPluginDataLen = $this->serverCapabilities & self::CLIENT_PLUGIN_AUTH ? \ord(\substr($packet, $off)) : 0; $off += 1; if ($this->serverCapabilities & self::CLIENT_SECURE_CONNECTION) { $off += 10; $strlen = \max(13, $this->authPluginDataLen - 8); $this->authPluginData .= \substr($packet, $off, $strlen); $off += $strlen; if ($this->serverCapabilities & self::CLIENT_PLUGIN_AUTH) { $this->authPluginName = DataTypes::decodeNullString(\substr($packet, $off)); } } } $this->sendHandshake(); } /** @see 14.2.5 Connection Phase Packets */ private function handleAuthSwitch($packet) { $off = 1; $this->authPluginName = DataTypes::decodeNullString(\substr($packet, $off)); $off += \strlen($this->authPluginName) + 1; $this->authPluginData = \substr($packet, $off); $this->sendAuthSwitchResponse(); } private function sendAuthSwitchResponse() { $this->write($this->getAuthData()); } /** @see 14.6.4.1.2 LOCAL INFILE Request */ private function handleLocalInfileRequest(string $packet): void { \Amp\asyncCall(function () use ($packet) { try { $filePath = \substr($packet, 1); /** @var \Amp\File\File $fileHandle */ if (\function_exists("Amp\\File\\openFile")) { // amphp/file 2.x $fileHandle = yield File\openFile($filePath, 'r'); } elseif (\function_exists("Amp\\File\\open")) { // amphp/file 1.x or 0.3.x $fileHandle = yield File\open($filePath, 'r'); } else { throw new \Error("amphp/file must be installed for LOCAL INFILE queries"); } while ("" != ($chunk = yield $fileHandle->read())) { $this->write($chunk); } $this->write(""); } catch (\Throwable $e) { $this->getDeferred()->fail(new ConnectionException("Failed to transfer a file to the server", 0, $e)); } }); } /** @see 14.6.4.1.1 Text Resultset */ private function handleQuery(string $packet): void { switch (\ord($packet)) { case self::OK_PACKET: $this->parseOk($packet); if ($this->connInfo->statusFlags & StatusFlags::SERVER_MORE_RESULTS_EXISTS) { $this->getDeferred()->resolve($result = new ResultProxy); $this->result = $result; $result->updateState(ResultProxy::COLUMNS_FETCHED); $this->successfulResultsetFetch(); } else { $this->parseCallback = null; $this->getDeferred()->resolve(new CommandResult($this->connInfo->affectedRows, $this->connInfo->insertId)); $this->ready(); } return; case self::LOCAL_INFILE_REQUEST: if ($this->config->isLocalInfileEnabled()) { $this->handleLocalInfileRequest($packet); } else { $this->getDeferred()->fail(new ConnectionException("Unexpected LOCAL_INFILE_REQUEST packet")); } return; case self::ERR_PACKET: $this->handleError($packet); return; } $this->parseCallback = [$this, "handleTextColumnDefinition"]; $this->getDeferred()->resolve($result = new ResultProxy); /* we need to resolve before assigning vars, so that a onResolve() handler won't have a partial result available */ $this->result = $result; $result->setColumns(DataTypes::decodeUnsigned($packet)); } /** @see 14.7.1 Binary Protocol Resultset */ private function handleExecute(string $packet): void { $this->parseCallback = [$this, "handleBinaryColumnDefinition"]; $this->getDeferred()->resolve($result = new ResultProxy); /* we need to resolve before assigning vars, so that a onResolve() handler won't have a partial result available */ $this->result = $result; $result->setColumns(\ord($packet)); } private function handleFieldList(string $packet): void { if (\ord($packet) === self::ERR_PACKET) { $this->parseCallback = null; $this->handleError($packet); } elseif (\ord($packet) === self::EOF_PACKET) { $this->parseCallback = null; $this->parseEof($packet); $this->getDeferred()->resolve(null); $this->ready(); } else { $this->addDeferred($deferred = new Deferred); $this->getDeferred()->resolve([$this->parseColumnDefinition($packet), $deferred]); } } private function handleTextColumnDefinition(string $packet): void { $this->handleColumnDefinition($packet, "handleTextResultSetRow"); } private function handleBinaryColumnDefinition(string $packet): void { $this->handleColumnDefinition($packet, "handleBinaryResultSetRow"); } private function handleColumnDefinition(string $packet, string $cbMethod): void { if (!$this->result->columnsToFetch--) { $this->result->updateState(ResultProxy::COLUMNS_FETCHED); if (\ord($packet) === self::ERR_PACKET) { $this->parseCallback = null; $this->handleError($packet); } else { $cb = $this->parseCallback = [$this, $cbMethod]; if ($this->capabilities & self::CLIENT_DEPRECATE_EOF) { $cb($packet); } else { $this->parseEof($packet); // we don't need the EOF packet, skip! } } return; } $this->result->columns[] = $this->parseColumnDefinition($packet); } private function prepareParams(string $packet): void { if (!$this->result->columnsToFetch--) { $this->result->columnsToFetch = $this->result->columnCount; if (!$this->result->columnsToFetch) { $this->prepareFields($packet); } else { $this->parseCallback = [$this, "prepareFields"]; } return; } $this->result->params[] = $this->parseColumnDefinition($packet); } private function prepareFields(string $packet): void { if (!$this->result->columnsToFetch--) { $this->parseCallback = null; $this->query = null; $result = $this->result; $this->result = null; $this->ready(); $result->updateState(ResultProxy::COLUMNS_FETCHED); return; } $this->result->columns[] = $this->parseColumnDefinition($packet); } /** @see 14.6.4.1.1.2 Column Defintion */ private function parseColumnDefinition(string $packet): array { $off = 0; $column = []; if ($this->capabilities & self::CLIENT_PROTOCOL_41) { $column["catalog"] = DataTypes::decodeStringOff(DataTypes::MYSQL_TYPE_STRING, $packet, $off); $column["schema"] = DataTypes::decodeStringOff(DataTypes::MYSQL_TYPE_STRING, $packet, $off); $column["table"] = DataTypes::decodeStringOff(DataTypes::MYSQL_TYPE_STRING, $packet, $off); $column["original_table"] = DataTypes::decodeStringOff(DataTypes::MYSQL_TYPE_STRING, $packet, $off); $column["name"] = DataTypes::decodeStringOff(DataTypes::MYSQL_TYPE_STRING, $packet, $off); $column["original_name"] = DataTypes::decodeStringOff(DataTypes::MYSQL_TYPE_STRING, $packet, $off); $fixlen = DataTypes::decodeUnsignedOff($packet, $off); $len = 0; $column["charset"] = DataTypes::decodeUnsigned16(\substr($packet, $off + $len)); $len += 2; $column["columnlen"] = DataTypes::decodeUnsigned32(\substr($packet, $off + $len)); $len += 4; $column["type"] = \ord($packet[$off + $len]); $len += 1; $column["flags"] = DataTypes::decodeUnsigned16(\substr($packet, $off + $len)); $len += 2; $column["decimals"] = \ord($packet[$off + $len]); //$len += 1; $off += $fixlen; } else { $column["table"] = DataTypes::decodeStringOff(DataTypes::MYSQL_TYPE_STRING, $packet, $off); $column["name"] = DataTypes::decodeStringOff(DataTypes::MYSQL_TYPE_STRING, $packet, $off); $collen = DataTypes::decodeUnsignedOff($packet, $off); $column["columnlen"] = DataTypes::decodeIntByLen(\substr($packet, $off), $collen); $off += $collen; $typelen = DataTypes::decodeUnsignedOff($packet, $off); $column["type"] = DataTypes::decodeIntByLen(\substr($packet, $off), $typelen); $off += $typelen; $len = 1; $flaglen = $this->capabilities & self::CLIENT_LONG_FLAG ? DataTypes::decodeUnsigned(\substr($packet, $off, 9), $len) : \ord($packet[$off]); $off += $len; if ($flaglen > 2) { $len = 2; $column["flags"] = DataTypes::decodeUnsigned16(\substr($packet, $off, 4)); } else { $len = 1; $column["flags"] = \ord($packet[$off]); } $column["decimals"] = \ord($packet[$off + $len]); $off += $flaglen; } if ($off < \strlen($packet)) { $column["defaults"] = DataTypes::decodeString(\substr($packet, $off)); } return $column; } private function successfulResultsetFetch(): void { $result = $this->result; $deferred = &$result->next; if (!$deferred) { $deferred = new Deferred; } if ($this->connInfo->statusFlags & StatusFlags::SERVER_MORE_RESULTS_EXISTS) { $this->parseCallback = [$this, "handleQuery"]; $this->addDeferred($deferred); } else { $this->parseCallback = null; $this->query = null; $this->result = null; $deferred->resolve(); $this->ready(); } $result->updateState(ResultProxy::ROWS_FETCHED); } /** @see 14.6.4.1.1.3 Resultset Row */ private function handleTextResultSetRow(string $packet): void { $packettype = \ord($packet); if ($packettype === self::EOF_PACKET) { if ($this->capabilities & self::CLIENT_DEPRECATE_EOF) { $this->parseOk($packet); } else { $this->parseEof($packet); } $this->successfulResultsetFetch(); return; } elseif ($packettype === self::ERR_PACKET) { $this->handleError($packet); return; } $off = 0; $columns = $this->result->columns; $fields = []; for ($i = 0; $off < \strlen($packet); ++$i) { if (\ord($packet[$off]) === 0xfb) { $fields[] = null; $off += 1; } else { $fields[] = DataTypes::decodeStringOff($columns[$i]["type"], $packet, $off); } } $this->result->rowFetched($fields); } /** @see 14.7.2 Binary Protocol Resultset Row */ private function handleBinaryResultSetRow(string $packet): void { $packettype = \ord($packet); if ($packettype === self::EOF_PACKET) { $this->parseEof($packet); $this->successfulResultsetFetch(); return; } elseif ($packettype === self::ERR_PACKET) { $this->handleError($packet); return; } $off = 1; // skip first byte $columnCount = $this->result->columnCount; $columns = $this->result->columns; $fields = []; for ($i = 0; $i < $columnCount; $i++) { if (\ord($packet[$off + (($i + 2) >> 3)]) & (1 << (($i + 2) % 8))) { $fields[$i] = null; } } $off += ($columnCount + 9) >> 3; for ($i = 0; $off < \strlen($packet); $i++) { while (\array_key_exists($i, $fields)) { $i++; } $fields[$i] = DataTypes::decodeBinary($columns[$i]["type"], \substr($packet, $off), $len); $off += $len; } \ksort($fields); $this->result->rowFetched($fields); } /** @see 14.7.4.1 COM_STMT_PREPARE Response */ private function handlePrepare(string $packet): void { switch (\ord($packet)) { case self::OK_PACKET: break; case self::ERR_PACKET: $this->handleError($packet); return; default: throw new ConnectionException("Unexpected value for first byte of COM_STMT_PREPARE Response"); } $off = 1; $stmtId = DataTypes::decodeUnsigned32(\substr($packet, $off)); $off += 4; $columns = DataTypes::decodeUnsigned16(\substr($packet, $off)); $off += 2; $params = DataTypes::decodeUnsigned16(\substr($packet, $off)); $off += 2; $off += 1; // filler $this->connInfo->warnings = DataTypes::decodeUnsigned16(\substr($packet, $off)); $this->result = new ResultProxy; $this->result->columnsToFetch = $params; $this->result->columnCount = $columns; $this->refcount++; $this->getDeferred()->resolve(new ConnectionStatement($this, $this->query, $stmtId, $this->named, $this->result)); $this->named = []; if ($params) { $this->parseCallback = [$this, "prepareParams"]; } else { $this->prepareParams($packet); } } private function readStatistics(string $packet): void { $this->getDeferred()->resolve($packet); $this->parseCallback = null; $this->ready(); } /** @see 14.6.2 COM_QUIT */ public function sendClose(): Promise { return $this->startCommand(function () { $this->write("\x01"); $this->connectionState = self::CLOSING; }); } public function close(): void { if ($this->connectionState === self::CLOSING && $this->deferreds) { \array_pop($this->deferreds)->resolve(); } $this->connectionState = self::CLOSED; if ($this->socket) { $this->socket->close(); $this->socket = null; } } private function resetIds(): void { if ($this->pendingWrite) { $this->pendingWrite->onResolve(function () { $this->seqId = $this->compressionId = -1; }); return; } $this->seqId = $this->compressionId = -1; } private function write(string $packet): Promise { \assert(!$this->socket->isClosed(), 'The connection was closed during a call to write'); if (\strlen($packet) < self::MAX_PACKET_LENGTH) { return $this->sendPacket($packet); } return call(function () use ($packet) { while (\strlen($packet) >= self::MAX_PACKET_LENGTH) { yield $this->sendPacket(\substr($packet, 0, self::MAX_PACKET_LENGTH)); $packet = \substr($packet, self::MAX_PACKET_LENGTH); } yield $this->sendPacket($packet); }); } /** * @see 14.1.2 MySQL Packets */ private function sendPacket(string $out): Promise { $packet = DataTypes::encodeInt32(\strlen($out) | (++$this->seqId << 24)) . $out; // @codeCoverageIgnoreStart \assert((function () use ($packet) { if (\defined("MYSQL_DEBUG")) { \fwrite(STDERR, "out: "); for ($i = 0; $i < \min(\strlen($packet), 200); $i++) { \fwrite(STDERR, \dechex(\ord($packet[$i])) . " "); } $r = \range("\0", "\x1f"); unset($r[10], $r[9]); \fwrite(STDERR, "len: ".\strlen($packet)."\n"); \fwrite(STDERR, \str_replace($r, ".", \substr($packet, 0, 200))."\n"); } return true; })()); // @codeCoverageIgnoreEnd if (($this->capabilities & self::CLIENT_COMPRESS) && $this->connectionState === self::READY) { $packet = $this->compressPacket($packet); } return $this->pendingWrite = $this->socket->write($packet); } /** * @see 14.4 Compression */ private function compressPacket(string $packet): string { $length = \strlen($packet); if ($length < self::COMPRESSION_MINIMUM_LENGTH) { return $this->makeCompressedPacket(0, $packet); } $deflated = \zlib_encode($packet, \ZLIB_ENCODING_DEFLATE); if ($length < \strlen($deflated)) { return $this->makeCompressedPacket(0, $packet); } return $this->makeCompressedPacket($length, $deflated); } private function makeCompressedPacket(int $uncompressed, string $packet): string { return DataTypes::encodeInt32(\strlen($packet) | (++$this->compressionId << 24)) . DataTypes::encodeInt24($uncompressed) . $packet; } /** @see 14.4 Compression */ private function parseCompression(): \Generator { $inflated = ""; $buf = ""; while (true) { while (\strlen($buf) < 7) { $buf .= yield $inflated; $inflated = ""; } $size = DataTypes::decodeUnsigned24($buf); $this->compressionId = \ord($buf[3]); $uncompressed = DataTypes::decodeUnsigned24(\substr($buf, 4, 3)); $buf = \substr($buf, 7); if ($size > 0) { while (\strlen($buf) < $size) { $buf .= yield $inflated; $inflated = ""; } if ($uncompressed === 0) { $inflated .= \substr($buf, 0, $size); } else { $inflated .= \zlib_decode(\substr($buf, 0, $size), $uncompressed); } $buf = \substr($buf, $size); } } } /** * @see 14.1.2 MySQL Packet * @see 14.1.3 Generic Response Packets */ private function parseMysql(): \Generator { $buf = ""; $parsed = []; while (true) { $packet = ""; do { while (\strlen($buf) < 4) { $buf .= yield $parsed; $parsed = []; } $len = DataTypes::decodeUnsigned24($buf); $this->seqId = \ord($buf[3]); $buf = \substr($buf, 4); while (\strlen($buf) < ($len & 0xffffff)) { $buf .= yield $parsed; $parsed = []; } $lastIn = $len !== 0xffffff; if ($lastIn) { $size = $len % 0xffffff; } else { $size = 0xffffff; } $packet .= \substr($buf, 0, $size); $buf = \substr($buf, $size); } while (!$lastIn); if (\strlen($packet) > 0) { $parsed[] = $packet; } } } private function parsePayload(string $packet): void { if ($this->connectionState === self::UNCONNECTED) { $this->established(); $this->connectionState = self::ESTABLISHED; $this->handleHandshake($packet); return; } if ($this->connectionState === self::ESTABLISHED) { switch (\ord($packet)) { case self::OK_PACKET: if ($this->capabilities & self::CLIENT_COMPRESS) { $this->processors = \array_merge([$this->parseCompression()], $this->processors); } $this->connectionState = self::READY; $this->handleOk($packet); break; case self::ERR_PACKET: $this->handleError($packet); break; case self::AUTH_SWITCH_PACKET: $this->handleAuthSwitch($packet); break; case self::EXTRA_AUTH_PACKET: /** @see 14.2.5 Connection Phase Packets (AuthMoreData) */ switch ($this->authPluginName) { case "sha256_password": $key = \substr($packet, 1); $this->config = $this->config->withKey($key); $this->sendHandshake(); break; case "caching_sha2_password": switch (\ord(\substr($packet, 1, 1))) { case 3: // success return; // expecting OK afterwards case 4: // fast auth failure if ($this->capabilities & self::CLIENT_SSL || $this->config->getHost()[0] === "/" /* unix domain socket, information not trivially available from $this->socket */) { $this->write($this->config->getPassword() . "\0"); } else { $this->write("\x02"); } break; case 0x2d: // certificate $pubkey = \substr($packet, 1); $this->write($this->sha256Auth($this->config->getPassword(), $this->authPluginData, $pubkey)); break; } break; default: throw new ConnectionException("Unexpected EXTRA_AUTH_PACKET in authentication phase for method {$this->authPluginName}"); } break; } return; } if ($this->parseCallback) { ($this->parseCallback)($packet); return; } $cb = $this->packetCallback; $this->packetCallback = null; switch (\ord($packet)) { case self::OK_PACKET: $this->handleOk($packet); break; case self::ERR_PACKET: $this->handleError($packet); break; case self::EOF_PACKET: if (\strlen($packet) < 6) { $this->handleEof($packet); break; } // no break default: if (!$cb) { throw new ConnectionException("Unexpected packet type: " . \ord($packet)); } $cb($packet); } } private function secureAuth(string $pass, string $scramble): string { $hash = \sha1($pass, 1); return $hash ^ \sha1(\substr($scramble, 0, 20) . \sha1($hash, 1), 1); } private function sha256Auth(string $pass, string $scramble, string $key): string { \openssl_public_encrypt("$pass\0" ^ \str_repeat($scramble, \ceil(\strlen($pass) / \strlen($scramble))), $auth, $key, OPENSSL_PKCS1_OAEP_PADDING); return $auth; } private function sha2Auth(string $pass, string $scramble): string { $digestStage1 = \hash("sha256", $pass, true); $digestStage2 = \hash("sha256", $digestStage1, true); $scrambleStage1 = \hash("sha256", $digestStage2 . \substr($scramble, 0, 20), true); return $digestStage1 ^ $scrambleStage1; } private function authSwitchRequest(string $packet): void { $this->parseCallback = null; switch (\ord($packet)) { case self::EOF_PACKET: if (\strlen($packet) === 1) { break; } $len = \strpos($packet, "\0"); $pluginName = \substr($packet, 0, $len); // @TODO mysql_native_pass only now... $authPluginData = \substr($packet, $len + 1); $this->write($this->secureAuth($this->config->getPassword(), $authPluginData)); break; case self::ERR_PACKET: $this->handleError($packet); return; default: throw new ConnectionException("AuthSwitchRequest: Expecting 0xfe (or ERR_Packet), got 0x".\dechex(\ord($packet))); } } /** * @see 14.2.5 Connection Phase Packets * @see 14.3 Authentication Method */ private function sendHandshake(bool $inSSL = false): void { if ($this->config->getDatabase() !== null) { $this->capabilities |= self::CLIENT_CONNECT_WITH_DB; } if ($this->config->getConnectContext()->getTlsContext() !== null) { $this->capabilities |= self::CLIENT_SSL; } $this->capabilities &= $this->serverCapabilities; $payload = ""; $payload .= \pack("V", $this->capabilities); $payload .= \pack("V", 1 << 24 - 1); // max-packet size $payload .= \chr(ConnectionConfig::BIN_CHARSET); $payload .= \str_repeat("\0", 23); // reserved if (!$inSSL && ($this->capabilities & self::CLIENT_SSL)) { \Amp\asyncCall(function () use ($payload) { try { yield $this->write($payload); yield $this->socket->setupTls(); $this->sendHandshake(true); } catch (\Throwable $e) { $this->close(); $this->getDeferred()->fail($e); } }); return; } $payload .= $this->config->getUser()."\0"; $auth = $this->getAuthData(); if ($this->capabilities & self::CLIENT_PLUGIN_AUTH_LENENC_CLIENT_DATA) { $payload .= DataTypes::encodeInt(\strlen($auth)); $payload .= $auth; } elseif ($this->capabilities & self::CLIENT_SECURE_CONNECTION) { $payload .= \chr(\strlen($auth)); $payload .= $auth; } else { $payload .= "$auth\0"; } if ($this->capabilities & self::CLIENT_CONNECT_WITH_DB) { $payload .= "{$this->config->getDatabase()}\0"; } if ($this->capabilities & self::CLIENT_PLUGIN_AUTH) { $payload .= "{$this->authPluginName}\0"; } if ($this->capabilities & self::CLIENT_CONNECT_ATTRS) { // connection attributes?! 5.6.6+ only! } $this->write($payload); } private function getAuthData(): string { $password = (string) $this->config->getPassword(); if ($password === "") { return ""; } if ($this->capabilities & self::CLIENT_PLUGIN_AUTH) { switch ($this->authPluginName) { case "mysql_native_password": return $this->secureAuth($password, $this->authPluginData); case "mysql_clear_password": return $password; case "sha256_password": $key = $this->config->getKey(); if ($key !== "") { return $this->sha256Auth($password, $this->authPluginData, $key); } return "\x01"; case "caching_sha2_password": return $this->sha2Auth($password, $this->authPluginData); case "mysql_old_password": throw new ConnectionException("mysql_old_password is outdated and insecure. Intentionally not implemented!"); default: throw new ConnectionException("Invalid (or unimplemented?) auth method requested by server: {$this->authPluginName}"); } } return $this->secureAuth($password, $this->authPluginData); } } * * @throws \Amp\Sql\FailureException If connecting fails. * @throws \Error If the connection string does not contain a host, user, and password. */ function connect(SqlConnectionConfig $config): Promise { return connector()->connect($config); } /** * Create a pool using the global Connector instance. * * @param SqlConnectionConfig $config * @param int $maxConnections * @param int $idleTimeout * * @return Pool * * @throws \Error If the connection string does not contain a host, user, and password. */ function pool( SqlConnectionConfig $config, int $maxConnections = ConnectionPool::DEFAULT_MAX_CONNECTIONS, int $idleTimeout = ConnectionPool::DEFAULT_IDLE_TIMEOUT ): Pool { return new Pool($config, $maxConnections, $idleTimeout, connector()); } = 0) { $unsigned = 1; } if ($param >= 0 && $param < (1 << 15)) { $value = self::encodeInt16($param); $type = self::MYSQL_TYPE_SHORT; } else { $value = self::encodeInt64($param); $type = self::MYSQL_TYPE_LONGLONG; } break; case "double": $value = \pack("e", $param); $type = self::MYSQL_TYPE_DOUBLE; break; case "string": $type = self::MYSQL_TYPE_LONG_BLOB; $value = self::encodeInt(\strlen($param)) . $param; break; case "NULL": $type = self::MYSQL_TYPE_NULL; $value = ""; break; default: throw new FailureException("Unexpected type for binding parameter: " . \gettype($param)); } return [$unsigned, $type, $value]; } /** @see 14.7.3 Binary Protocol Value */ public static function decodeBinary(int $type, string $str, ?int &$len = null) /* : mixed */ { $unsigned = $type & 0x80; switch ($type) { case self::MYSQL_TYPE_STRING: case self::MYSQL_TYPE_VARCHAR: case self::MYSQL_TYPE_VAR_STRING: case self::MYSQL_TYPE_ENUM: case self::MYSQL_TYPE_SET: case self::MYSQL_TYPE_LONG_BLOB: case self::MYSQL_TYPE_MEDIUM_BLOB: case self::MYSQL_TYPE_BLOB: case self::MYSQL_TYPE_TINY_BLOB: case self::MYSQL_TYPE_GEOMETRY: case self::MYSQL_TYPE_BIT: case self::MYSQL_TYPE_DECIMAL: case self::MYSQL_TYPE_NEWDECIMAL: case self::MYSQL_TYPE_JSON: $ret = self::decodeString($str, $intlen, $len); $len += $intlen; return $ret; case self::MYSQL_TYPE_LONGLONG: case self::MYSQL_TYPE_LONGLONG | 0x80: $len = 8; return $unsigned ? self::decodeUnsigned64($str) : self::decodeInt64($str); case self::MYSQL_TYPE_LONG: case self::MYSQL_TYPE_LONG | 0x80: case self::MYSQL_TYPE_INT24: case self::MYSQL_TYPE_INT24 | 0x80: $len = 4; return $unsigned ? self::decodeUnsigned32($str) : self::decodeInt32($str); case self::MYSQL_TYPE_SHORT: case self::MYSQL_TYPE_SHORT | 0x80: case self::MYSQL_TYPE_YEAR: $len = 2; return $unsigned ? self::decodeUnsigned16($str) : self::decodeInt16($str); case self::MYSQL_TYPE_TINY: case self::MYSQL_TYPE_TINY | 0x80: $len = 1; return $unsigned ? \ord($str) : self::decodeInt8($str); case self::MYSQL_TYPE_DOUBLE: $len = 8; return \unpack("e", $str)[1]; case self::MYSQL_TYPE_FLOAT: $len = 4; return \unpack("g", $str)[1]; case self::MYSQL_TYPE_DATE: case self::MYSQL_TYPE_DATETIME: case self::MYSQL_TYPE_TIMESTAMP: $year = $month = $day = $hour = $minute = $second = $microsecond = 0; switch ($len = \ord($str) + 1) { case 12: $microsecond = self::decodeUnsigned32(\substr($str, 8)); // no break case 8: $second = \ord($str[7]); $minute = \ord($str[6]); $hour = \ord($str[5]); // no break case 5: $day = \ord($str[4]); $month = \ord($str[3]); $year = self::decodeUnsigned16(\substr($str, 1)); // no break case 1: break; default: throw new FailureException("Unexpected string length for date in binary protocol: " . ($len - 1)); } $result = \sprintf('%04d-%02d-%02d', $year, $month, $day); if ($type === self::MYSQL_TYPE_DATE) { return $result; } $result .= \sprintf(' %02d:%02d:%02d', $hour, $minute, $second); if ($microsecond) { $result .= \sprintf('.%06d', $microsecond); } return $result; case self::MYSQL_TYPE_TIME: $negative = $day = $hour = $minute = $second = $microsecond = 0; switch ($len = \ord($str) + 1) { case 13: $microsecond = self::decodeUnsigned32(\substr($str, 9)); // no break case 9: $second = \ord($str[8]); $minute = \ord($str[7]); $hour = \ord($str[6]); $day = self::decodeUnsigned32(\substr($str, 2)); $negative = \ord($str[1]); // no break case 1: break; default: throw new FailureException("Unexpected string length for time in binary protocol: " . ($len - 1)); } $hour += $day * 24; $result = \sprintf('%s%02d:%02d:%02d', ($negative ? "-" : ""), $hour, $minute, $second); if ($microsecond) { $result .= \sprintf('.%06d', $microsecond); } return $result; case self::MYSQL_TYPE_NULL: $len = 0; return null; default: throw new FailureException("Invalid type for Binary Protocol: 0x" . \dechex($type)); } } public static function decodeNullString(string $str, ?int &$len = null): string { return \substr($str, 0, $len = \strpos($str, "\0")); } public static function decodeStringOff(int $type, string $str, int &$off) /* : mixed */ { $len = self::decodeUnsignedOff($str, $off); $off += $len; $data = (string) \substr($str, $off - $len, $len); switch ($type) { case self::MYSQL_TYPE_LONGLONG | 0x80: return $type; // Return UNSIGNED BIGINT as a string. case self::MYSQL_TYPE_LONGLONG: case self::MYSQL_TYPE_LONG | 0x80: if (\PHP_INT_SIZE < 8) { return $type; // Return BIGINT and UNSIGNED INT as string on 32-bit. } // no break case self::MYSQL_TYPE_LONG: case self::MYSQL_TYPE_INT24: case self::MYSQL_TYPE_INT24 | 0x80: case self::MYSQL_TYPE_SHORT: case self::MYSQL_TYPE_SHORT | 0x80: case self::MYSQL_TYPE_TINY: case self::MYSQL_TYPE_TINY | 0x80: case self::MYSQL_TYPE_YEAR: return (int) $data; case self::MYSQL_TYPE_DOUBLE: case self::MYSQL_TYPE_FLOAT: return (float) $data; default: return $data; } } public static function decodeUnsignedOff(string $str, int &$off): int { $int = \ord($str[$off]); if ($int < 0xfb) { $off += 1; return $int; } if ($int == 0xfc) { $off += 3; return self::decodeUnsigned16(\substr($str, $off - 2, 2)); } if ($int == 0xfd) { $off += 4; return self::decodeUnsigned24(\substr($str, $off - 3, 3)); } if ($int == 0xfe) { $off += 9; return self::decodeUnsigned64(\substr($str, $off - 8, 8)); } // If that happens connection is borked... throw new FailureException("$int is not in ranges [0x00, 0xfa] or [0xfc, 0xfe]"); } public static function decodeString(string $str, ?int &$intlen = null, ?int &$len = null): string { $len = self::decodeUnsigned($str, $intlen); return \substr($str, $intlen, $len); } public static function decodeUnsigned(string $str, ?int &$len = null) { $int = \ord($str); if ($int < 0xfb) { $len = 1; return $int; } if ($int == 0xfc) { $len = 3; return self::decodeUnsigned16(\substr($str, 1, 2)); } if ($int == 0xfd) { $len = 4; return self::decodeUnsigned24(\substr($str, 1, 4)); } if ($int == 0xfe) { $len = 9; return self::decodeUnsigned64(\substr($str, 1, 8)); } // If that happens connection is borked... throw new FailureException("$int is not in ranges [0x00, 0xfa] or [0xfc, 0xfe]"); } public static function decodeIntByLen(string $str, int $len): int { $int = 0; while ($len--) { $int = ($int << 8) + \ord($str[$len]); } return $int; } public static function decodeInt8(string $str): int { $int = \ord($str); if ($int < (1 << 7)) { return $int; } $shift = \PHP_INT_SIZE * 8 - 8; return $int << $shift >> $shift; } public static function decodeUnsigned8(string $str): int { return \ord($str); } public static function decodeInt16(string $str): int { $int = \unpack("v", $str)[1]; if ($int < (1 << 15)) { return $int; } $shift = \PHP_INT_SIZE * 8 - 16; return $int << $shift >> $shift; } public static function decodeUnsigned16(string $str) { return \unpack("v", $str)[1]; } public static function decodeInt24(string $str): int { $int = \unpack("V", \substr($str, 0, 3) . "\x00")[1]; if ($int < (1 << 23)) { return $int; } $shift = \PHP_INT_SIZE * 8 - 24; return $int << $shift >> $shift; } public static function decodeUnsigned24(string $str): int { return \unpack("V", \substr($str, 0, 3) . "\x00")[1]; } public static function decodeInt32($str): int { if (\PHP_INT_SIZE > 4) { $int = \unpack("V", $str)[1]; if ($int < (1 << 31)) { return $int; } return $int << 32 >> 32; } return \unpack("V", $str)[1]; } public static function decodeUnsigned32(string $str) /* : int|string */ { if (\PHP_INT_SIZE > 4) { return \unpack("V", $str)[1]; } \assert(\extension_loaded("gmp"), "The GMP extension is required for UNSIGNED INT fields on 32-bit systems"); return \gmp_strval(\gmp_import(\substr($str, 0, 4), 1, \GMP_LSW_FIRST)); } public static function decodeInt64(string $str) /* : int|string */ { if (\PHP_INT_SIZE > 4) { return \unpack("P", $str)[1]; } \assert(\extension_loaded("gmp"), "The GMP extension is required for BIGINT fields on 32-bit systems"); return \gmp_strval(\gmp_import(\substr($str, 0, 8), 1, \GMP_LSW_FIRST)); } public static function decodeUnsigned64(string $str) /* : int|string */ { \assert(\extension_loaded("gmp"), "The GMP extension is required for UNSIGNED BIGINT fields"); return \gmp_strval(\gmp_import(\substr($str, 0, 8), 1, \GMP_LSW_FIRST)); } public static function encodeInt(int $int): string { if ($int < 0xfb) { return \chr($int); } if ($int < (1 << 16)) { return "\xfc" . self::encodeInt16($int); } if ($int < (1 << 24)) { return "\xfd" . self::encodeInt24($int); } if ($int < (1 << 62) * 4) { return "\xfe" . self::encodeInt64($int); } throw new FailureException("encodeInt doesn't allow integers bigger than 2^64 - 1 (current: $int)"); } public static function encodeInt16(int $int): string { return \pack("v", $int); } public static function encodeInt24(int $int): string { return \substr(\pack("V", $int), 0, 3); } public static function encodeInt32(int $int): string { return \pack("V", $int); } public static function encodeInt64(int $int): string { return \pack("VV", $int & 0xffffffff, $int >> 32); } public static function isBindable(int $type): bool { switch ($type) { case self::MYSQL_TYPE_JSON: return false; default: return true; } } } */ public static function connect( ConnectionConfig $config, ?CancellationToken $token = null, ?Socket\Connector $connector = null ): Promise { $token = $token ?? new NullCancellationToken; return call(function () use ($config, $token, $connector) { $socket = yield ($connector ?? Socket\connector()) ->connect($config->getConnectionString(), $config->getConnectContext(), $token); $processor = new Internal\Processor($socket, $config); yield $processor->connect($token); return new self($processor); }); } /** * @param Internal\Processor $processor */ private function __construct(Internal\Processor $processor) { $this->processor = $processor; $this->release = function () { \assert($this->busy instanceof Deferred); $deferred = $this->busy; $this->busy = null; $deferred->resolve(); }; } /** * @return bool False if the connection has been closed. */ public function isAlive(): bool { return $this->processor->isAlive(); } /** * @return int Timestamp of the last time this connection was used. */ public function getLastUsedAt(): int { return $this->processor->getLastUsedAt(); } public function isReady(): bool { return $this->processor->isReady(); } public function setCharset(string $charset, string $collate = ""): Promise { return $this->processor->setCharset($charset, $collate); } public function close() { $processor = $this->processor; // Send close command if connection is not already in a closed or closing state if ($processor->isAlive()) { $processor->sendClose()->onResolve(static function () use ($processor) { $processor->close(); }); } } public function useDb(string $db): Promise { return $this->processor->useDb($db); } /** * @param int $subcommand int one of the self::REFRESH_* constants * * @return Promise */ public function refresh(int $subcommand): Promise { return $this->processor->refresh($subcommand); } public function query(string $query): Promise { return call(function () use ($query) { while ($this->busy) { yield $this->busy->promise(); } $result = yield $this->processor->query($query); if ($result instanceof Internal\ResultProxy) { return new ConnectionResultSet($result); } if ($result instanceof CommandResult) { return $result; } throw new FailureException("Unrecognized result type"); }); } public function beginTransaction(int $isolation = ConnectionTransaction::ISOLATION_COMMITTED): Promise { return call(function () use ($isolation) { switch ($isolation) { case ConnectionTransaction::ISOLATION_UNCOMMITTED: yield $this->query("SET SESSION TRANSACTION ISOLATION LEVEL READ UNCOMMITTED"); break; case ConnectionTransaction::ISOLATION_COMMITTED: yield $this->query("SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED"); break; case ConnectionTransaction::ISOLATION_REPEATABLE: yield $this->query("SET SESSION TRANSACTION ISOLATION LEVEL REPEATABLE READ"); break; case ConnectionTransaction::ISOLATION_SERIALIZABLE: yield $this->query("SET SESSION TRANSACTION ISOLATION LEVEL SERIALIZABLE"); break; default: throw new \Error("Invalid transaction type"); } yield $this->query("START TRANSACTION"); $this->busy = new Deferred; return new ConnectionTransaction($this->processor, $this->release, $isolation); }); } public function ping(): Promise { return $this->processor->ping(); } public function prepare(string $query): Promise { return call(function () use ($query) { while ($this->busy) { yield $this->busy->promise(); } return $this->processor->prepare($query); }); } /** * {@inheritdoc} */ public function execute(string $sql, array $params = []): Promise { return call(function () use ($sql, $params) { /** @var Statement $statment */ $statment = yield $this->prepare($sql); return yield $statment->execute($params); }); } public function __destruct() { $this->processor->unreference(); } } isolation = $isolation; break; default: throw new \Error("Isolation must be a valid transaction isolation level"); } $this->processor = $processor; $refCount =& $this->refCount; $this->release = static function () use (&$refCount, $release) { if (--$refCount === 0) { $release(); } }; } public function __destruct() { if ($this->processor && $this->processor->isAlive()) { $this->rollback(); // Invokes $this->release callback. } } /** * {@inheritdoc} */ public function getLastUsedAt(): int { return $this->processor->getLastUsedAt(); } /** * {@inheritdoc} * * Closes and commits all changes in the transaction. */ public function close(): void { if ($this->processor) { $this->commit(); // Invokes $this->release callback. } } /** * {@inheritdoc} */ public function isAlive(): bool { return $this->processor && $this->processor->isAlive(); } /** * @return bool True if the transaction is active, false if it has been committed or rolled back. */ public function isActive(): bool { return $this->processor !== null; } /** * @return int */ public function getIsolationLevel(): int { return $this->isolation; } /** * {@inheritdoc} * * @throws TransactionError If the transaction has been committed or rolled back. */ public function query(string $sql): Promise { if ($this->processor === null) { throw new TransactionError("The transaction has been committed or rolled back"); } return call(function () use ($sql) { $result = yield $this->processor->query($sql); if ($result instanceof Internal\ResultProxy) { ++$this->refCount; return new PooledResultSet(new ConnectionResultSet($result), $this->release); } return $result; }); } /** * {@inheritdoc} * * @throws TransactionError If the transaction has been committed or rolled back. */ public function prepare(string $sql): Promise { if ($this->processor === null) { throw new TransactionError("The transaction has been committed or rolled back"); } return call(function () use ($sql) { $statement = yield $this->processor->prepare($sql); return new PooledStatement($statement, $this->release); }); } /** * {@inheritdoc} * * @throws TransactionError If the transaction has been committed or rolled back. */ public function execute(string $sql, array $params = []): Promise { if ($this->processor === null) { throw new TransactionError("The transaction has been committed or rolled back"); } return call(function () use ($sql, $params) { $statement = yield $this->processor->prepare($sql); \assert($statement instanceof Statement); $result = yield $statement->execute($params); if ($result instanceof ResultSet) { ++$this->refCount; return new PooledResultSet($result, $this->release); } return $result; }); } /** * Commits the transaction and makes it inactive. * * @return Promise<\Amp\Sql\CommandResult> * * @throws TransactionError If the transaction has been committed or rolled back. */ public function commit(): Promise { if ($this->processor === null) { throw new TransactionError("The transaction has been committed or rolled back"); } $promise = $this->processor->query("COMMIT"); $this->processor = null; $promise->onResolve($this->release); return $promise; } /** * Rolls back the transaction and makes it inactive. * * @return Promise<\Amp\Sql\CommandResult> * * @throws TransactionError If the transaction has been committed or rolled back. */ public function rollback(): Promise { if ($this->processor === null) { throw new TransactionError("The transaction has been committed or rolled back"); } $promise = $this->processor->query("ROLLBACK"); $this->processor = null; $promise->onResolve($this->release); return $promise; } /** * Creates a savepoint with the given identifier. * * @param string $identifier Savepoint identifier. * * @return Promise<\Amp\Sql\CommandResult> * * @throws TransactionError If the transaction has been committed or rolled back. */ public function createSavepoint(string $identifier): Promise { return $this->query(\sprintf("SAVEPOINT `%s%s`", self::SAVEPOINT_PREFIX, \sha1($identifier))); } /** * Rolls back to the savepoint with the given identifier. * * @param string $identifier Savepoint identifier. * * @return Promise<\Amp\Sql\CommandResult> * * @throws TransactionError If the transaction has been committed or rolled back. */ public function rollbackTo(string $identifier): Promise { return $this->query(\sprintf("ROLLBACK TO `%s%s`", self::SAVEPOINT_PREFIX, \sha1($identifier))); } /** * Releases the savepoint with the given identifier. * * @param string $identifier Savepoint identifier. * * @return Promise<\Amp\Sql\CommandResult> * * @throws TransactionError If the transaction has been committed or rolled back. */ public function releaseSavepoint(string $identifier): Promise { return $this->query(\sprintf("RELEASE SAVEPOINT `%s%s`", self::SAVEPOINT_PREFIX, \sha1($identifier))); } } result = $result; $this->release = &$release; parent::__construct($this->result, static function () use (&$release) { if ($release !== null) { $release(); } }); } public function advance(): Promise { $promise = $this->result->advance(); $promise->onResolve(function (\Throwable $exception = null, bool $moreResults = null) { if ($moreResults || $this->release === null) { return; } $this->nextResultPromise = $this->result->nextResultSet(); $this->nextResultPromise->onResolve(function (\Throwable $exception = null, bool $moreResults = null) { $this->nextResultPromise = null; if ($moreResults || $this->release === null) { return; } $release = $this->release; $this->release = null; $release(); }); }); return $promise; } public function nextResultSet(): Promise { if ($this->nextResultPromise !== null) { $nextResultPromise = $this->nextResultPromise; $this->nextResultPromise = null; return $nextResultPromise; } $promise = $this->result->nextResultSet(); $promise->onResolve(function (\Throwable $exception = null, bool $moreResults = null) { if ($moreResults || $this->release === null) { return; } $release = $this->release; $this->release = null; $release(); }); return $promise; } public function getFields(): Promise { return $this->result->getFields(); } } reset(); foreach ($this->params as $paramId => $data) { $statement->bind($paramId, $data); } return $statement; }); } protected function createResultSet(SqlResultSet $resultSet, callable $release): SqlResultSet { \assert( $resultSet instanceof ConnectionResultSet || $resultSet instanceof PooledResultSet ); return new PooledResultSet($resultSet, $release); } public function bind($paramId, $data): void { if (!\is_int($paramId) && !\is_string($paramId)) { throw new \TypeError("Invalid parameter ID type"); } $this->params[$paramId] = $data; } public function reset(): Promise { $this->params = []; return new Success; } /** * @return Promise */ public function getFields(): Promise { return call(function () { $statement = yield from $this->pop(); \assert($statement instanceof Statement); $fields = yield $statement->getFields(); $this->push($statement); return $fields; }); } } host;user=$this->user;pass=$this->pass"); $connector = new CancellableConnector; $this->connectionPool = new ConnectionPool($config, $this->poolLimit, 10, $connector); $connectionPromise = $connector->connect($config); $this->connection = wait($connectionPromise); $this->pdoConnection = new \PDO("mysql:host=$this->host;port=3306", $this->user, $this->pass); } public function onAfterMethods() { $this->connectionPool->close(); $this->connection->close(); } public function benchPdoQueries() { foreach (\range(1, $this->maxQueries) as $ii) { $resultSet = $this->pdoConnection->query("SELECT $ii"); $resultSet->fetch(\PDO::FETCH_ASSOC); } } public function benchSyncQueries() { wait(call(function () { $connection = $this->connection; foreach (\range(1, $this->maxQueries) as $i) { /** @var ResultSet $resultSet */ $resultSet = yield $connection->query("SELECT $i"); yield $resultSet->advance(); } })); } public function benchAsyncQueries() { wait(call(function () { $connection = $this->connection; /** @var ResultSet[] $resultSets */ $resultSets = yield \array_map(function ($i) use ($connection) { return $connection->query("SELECT $i"); }, \range(1, $this->maxQueries)); yield \array_map(function ($resultSet) { /** @var ResultSet $resultSet */ return $resultSet->advance(); }, $resultSets); })); } public function benchAsyncQueriesUsingPool() { wait(call(function () { $connection = $this->connectionPool; /** @var ResultSet[] $resultSets */ $resultSets = yield \array_map(function ($i) use ($connection) { return $connection->query("SELECT $i"); }, \range(1, $this->maxQueries)); yield \array_map(function ($resultSet) { /** @var ResultSet $resultSet */ return $resultSet->advance(); }, $resultSets); })); } } withBytesPerSecondLimit(\PHP_INT_MAX) ->withFrameSizeLimit(\PHP_INT_MAX) ->withFramesPerSecondLimit(\PHP_INT_MAX) ->withMessageSizeLimit(\PHP_INT_MAX) ->withValidateUtf8(true); /** @var Connection $connection */ $connection = yield Client\connect('ws://127.0.0.1:9001/getCaseCount'); /** @var Message $message */ $message = yield $connection->receive(); $cases = (int) yield $message->buffer(); echo "Going to run {$cases} test cases." . PHP_EOL; for ($i = 1; $i < $cases; $i++) { $connection = yield Client\connect('ws://127.0.0.1:9001/getCaseInfo?case=' . $i . '&agent=' . AGENT); $message = yield $connection->receive(); $info = \json_decode(yield $message->buffer(), true); print $info['id'] . ' ' . \str_repeat('-', 80 - \strlen($info['id']) - 1) . PHP_EOL; print \wordwrap($info['description'], 80, PHP_EOL) . ' '; $handshake = new Handshake('ws://127.0.0.1:9001/runCase?case=' . $i . '&agent=' . AGENT, $options); $connection = yield Client\connect($handshake); try { while ($message = yield $connection->receive()) { $content = yield $message->buffer(); if ($message->isBinary()) { yield $connection->sendBinary($content); } else { yield $connection->send($content); } } } catch (ClosedException $e) { // ignore } catch (AssertionError $e) { print 'Assertion error: ' . $e->getMessage() . PHP_EOL; $connection->close(); } catch (Error $e) { print 'Error: ' . $e->getMessage() . PHP_EOL; $connection->close(); } catch (StreamException $e) { print 'Stream exception: ' . $e->getMessage() . PHP_EOL; $connection->close(); } $connection = yield Client\connect('ws://127.0.0.1:9001/getCaseStatus?case=' . $i . '&agent=' . AGENT); $message = yield $connection->receive(); print($result = \json_decode(yield $message->buffer(), true)['behavior']); if ($result === 'FAILED') { $errors++; } print PHP_EOL . PHP_EOL; } $connection = yield Client\connect('ws://127.0.0.1:9001/updateReports?agent=' . AGENT); $connection->close(); Loop::stop(); if ($errors) { exit(1); } }); { "url": "ws://127.0.0.1:9001", "outdir": "./reports/clients", "cases": [ "*" ], "exclude-cases": [ "12.2*", "12.3*", "12.4*", "12.5*" ] } { "name": "amphp/websocket-client", "description": "Async WebSocket client for PHP based on Amp.", "license": "MIT", "authors": [ { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "support": { "issues": "https://github.com/amphp/websocket-client/issues" }, "keywords": [ "async", "non-blocking", "websocket", "client", "http", "amp", "amphp" ], "require": { "php": ">=7.2", "amphp/amp": "^2.2", "amphp/http": "^1.3", "amphp/http-client": "^4", "amphp/socket": "^1", "amphp/websocket": "^1", "league/uri": "^6", "psr/http-message": "^1" }, "require-dev": { "amphp/http-server": "^2", "amphp/websocket-server": "dev-master as 2.0-rc4", "amphp/phpunit-util": "^1.1", "amphp/php-cs-fixer-config": "dev-master", "phpunit/phpunit": "^8 || ^7", "psr/log": "^1", "vimeo/psalm": "^3.11@dev" }, "minimum-stability": "RC", "autoload": { "psr-4": { "Amp\\Websocket\\Client\\": "src" }, "files": [ "src/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Websocket\\Client\\Test\\": "test" } } } response = $response; } public function getResponse(): Response { return $this->response; } } uri = $this->makeUri($uri); $this->options = $this->checkOptions($options); $this->setHeaders($headers); } /** * @return PsrUri Websocket URI (scheme will be either ws or wss). */ public function getUri(): PsrUri { return $this->uri; } /** * @param string|PsrUri $uri * * @return self Cloned object */ public function withUri($uri): self { $clone = clone $this; $clone->uri = $clone->makeUri($uri); return $clone; } /** * @return Options */ public function getOptions(): Options { return $this->options; } /** * @param Options $options * * @return self Cloned object. */ public function withOptions(Options $options): self { $clone = clone $this; $clone->options = $clone->checkOptions($options); return $clone; } /** * @return int Timeout in milliseconds for the TCP connection. */ public function getTcpConnectTimeout(): int { return $this->tcpConnectTimeout; } public function withTcpConnectTimeout(int $tcpConnectTimeout): self { $clone = clone $this; $clone->tcpConnectTimeout = $tcpConnectTimeout; return $clone; } /** * @return int Timeout in milliseconds for the TLS handshake. */ public function getTlsHandshakeTimeout(): int { return $this->tlsHandshakeTimeout; } public function withTlsHandshakeTimeout(int $tlsHandshakeTimeout): self { $clone = clone $this; $clone->tlsHandshakeTimeout = $tlsHandshakeTimeout; return $clone; } public function getHeaderSizeLimit(): int { return $this->headerSizeLimit; } public function withHeaderSizeLimit(int $headerSizeLimit): self { $clone = clone $this; $clone->headerSizeLimit = $headerSizeLimit; return $clone; } /** * Replaces all headers in the returned instance. * * @param string[]|string[][] $headers * * @return self Cloned object. */ public function withHeaders(array $headers): self { $clone = clone $this; foreach ($clone->getRawHeaders() as [$field]) { $clone->removeHeader($field); } $clone->setHeaders($headers); return $clone; } /** * Replaces the given header in the returned instance. * * @param string $name * @param string|string[] $value * * @return self Cloned object. */ public function withHeader(string $name, $value): self { $clone = clone $this; $clone->setHeader($name, $value); return $clone; } /** * Adds the given header in the returned instance. * * @param string $name * @param string|string[] $value * * @return self Cloned object. */ public function withAddedHeader(string $name, $value): self { $clone = clone $this; $clone->addHeader($name, $value); return $clone; } /** * Removes the given header in the returned instance. * * @param string $name * * @return self Cloned object. */ public function withoutHeader(string $name): self { $clone = clone $this; $clone->removeHeader($name); return $clone; } protected function setHeader(string $name, $value): void { if (($name[0] ?? ':') === ':') { throw new \Error("Header name cannot be empty or start with a colon (:)"); } parent::setHeader($name, $value); } protected function addHeader(string $name, $value): void { if (($name[0] ?? ':') === ':') { throw new \Error("Header name cannot be empty or start with a colon (:)"); } parent::addHeader($name, $value); } /** * @param string|PsrUri $uri * * @return PsrUri */ private function makeUri($uri): PsrUri { if (\is_string($uri)) { try { $uri = Uri\Http::createFromString($uri); } catch (\Exception $exception) { throw new \Error('Invalid Websocket URI provided', 0, $exception); } } /** @psalm-suppress DocblockTypeContradiction */ if (!$uri instanceof PsrUri) { throw new \TypeError(\sprintf( 'Must provide an instance of %s or a websocket URI as a string', PsrUri::class )); } switch ($uri->getScheme()) { case 'ws': case 'wss': break; default: throw new \Error('The URI scheme must be ws or wss: \'' . $uri->getScheme() . '\''); } return $uri; } private function checkOptions(?Options $options): Options { if ($options === null) { return Options::createClientDefault(); } return $options; } } client = $client; $this->connectionFactory = $connectionFactory ?? new Rfc6455ConnectionFactory; $this->compressionFactory = $compressionFactory ?? new Rfc7692CompressionFactory; } public function connect(Handshake $handshake, ?CancellationToken $cancellationToken = null): Promise { return call(function () use ($handshake, $cancellationToken) { $key = Websocket\generateKey(); $request = $this->generateRequest($handshake, $key); $options = $handshake->getOptions(); $deferred = new Deferred; $connectionFactory = $this->connectionFactory; $compressionFactory = $this->compressionFactory; $request->setUpgradeHandler(static function (EncryptableSocket $socket, Request $request, Response $response) use ( $connectionFactory, $compressionFactory, $deferred, $key, $options ): void { if (\strtolower((string) $response->getHeader('upgrade')) !== 'websocket') { $deferred->fail(new ConnectionException('Upgrade header does not equal "websocket"', $response)); return; } if (!Websocket\validateAcceptForKey((string) $response->getHeader('sec-websocket-accept'), $key)) { $deferred->fail(new ConnectionException('Invalid Sec-WebSocket-Accept header', $response)); return; } $extensions = self::splitField($response, 'sec-websocket-extensions'); foreach ($extensions as $extension) { if ($compressionContext = $compressionFactory->fromServerHeader($extension)) { break; } } $deferred->resolve($connectionFactory->createConnection($response, $socket, $options, $compressionContext ?? null)); }); /** @var Response $response */ $response = yield $this->client->request($request, $cancellationToken); if ($response->getStatus() !== Http\Status::SWITCHING_PROTOCOLS) { throw new ConnectionException(\sprintf( 'A %s (%d) response was not received; instead received response status: %s (%d)', Http\Status::getReason(Http\Status::SWITCHING_PROTOCOLS), Http\Status::SWITCHING_PROTOCOLS, $response->getReason(), $response->getStatus() ), $response); } return yield $deferred->promise(); }); } /** * @param Handshake $handshake * @param string $key * * @return Request */ private function generateRequest(Handshake $handshake, string $key): Request { $uri = $handshake->getUri(); $uri = $uri->withScheme($uri->getScheme() === 'wss' ? 'https' : 'http'); $request = new Request($uri, 'GET'); $request->setHeaders($handshake->getHeaders()); $request->setTcpConnectTimeout($handshake->getTcpConnectTimeout()); $request->setTlsHandshakeTimeout($handshake->getTlsHandshakeTimeout()); $request->setHeaderSizeLimit($handshake->getHeaderSizeLimit()); if (!$request->hasHeader('origin')) { $origin = $uri ->withUserInfo('') ->withPath('') ->withQuery(''); $request->setHeader('origin', (string) $origin); } $extensions = self::splitField($request, 'sec-websocket-extensions'); if ($handshake->getOptions()->isCompressionEnabled() && \extension_loaded('zlib')) { $extensions[] = $this->compressionFactory->createRequestHeader(); } if (!empty($extensions)) { $request->setHeader('sec-websocket-extensions', \implode(', ', $extensions)); } $request->setProtocolVersions(['1.1']); $request->setHeader('connection', 'Upgrade'); $request->setHeader('upgrade', 'websocket'); $request->setHeader('sec-websocket-version', '13'); $request->setHeader('sec-websocket-key', $key); return $request; } private static function splitField(Message $message, string $headerName): array { $header = \implode(', ', $message->getHeaderArray($headerName)); if ($header === '') { return []; } \preg_match_all('(([^",]+(?:"((?:[^\\\\"]|\\\\.)*)"|([^,]*))?),?\s*)', $header, $matches, \PREG_SET_ORDER); $values = []; foreach ($matches as $match) { // decode escaped characters $values[] = \preg_replace('(\\\\(.))', '\1', \trim($match[1])); } return $values; } } * * @throws ConnectionException If the response received is invalid or is not a switching protocols (101) response. * @throws HttpException Thrown if the request fails. */ function connect( $handshake, ?ConnectContext $connectContext = null, ?CancellationToken $cancellationToken = null ): Promise { if (!$handshake instanceof Handshake) { $handshake = new Handshake($handshake); } if ($connectContext === null) { $connectContext = (new ConnectContext)->withTcpNoDelay(); } $httpClient = (new HttpClientBuilder) ->usingPool(new UnlimitedConnectionPool(new DefaultConnectionFactory(null, $connectContext))) ->build(); return (new Rfc6455Connector($httpClient))->connect($handshake, $cancellationToken); } * * @throws HttpException Thrown if the request fails. * @throws ConnectionException If the response received is invalid or is not a switching protocols (101) response. */ public function connect(Handshake $handshake, ?CancellationToken $cancellationToken = null): Promise; } client = $client; $this->response = $response; } public function getResponse(): Response { return $this->response; } public function receive(): Promise { return $this->client->receive(); } public function getId(): int { return $this->client->getId(); } public function getOptions(): Options { return $this->client->getOptions(); } public function isConnected(): bool { return $this->client->isConnected(); } public function getLocalAddress(): SocketAddress { return $this->client->getLocalAddress(); } public function getRemoteAddress(): SocketAddress { return $this->client->getRemoteAddress(); } public function getTlsInfo(): ?TlsInfo { return $this->client->getTlsInfo(); } public function isClosedByPeer(): bool { return $this->client->isClosedByPeer(); } public function getUnansweredPingCount(): int { return $this->client->getUnansweredPingCount(); } public function getCloseCode(): int { return $this->client->getCloseCode(); } public function getCloseReason(): string { return $this->client->getCloseReason(); } public function send(string $data): Promise { return $this->client->send($data); } public function sendBinary(string $data): Promise { return $this->client->sendBinary($data); } public function stream(InputStream $stream): Promise { return $this->client->stream($stream); } public function streamBinary(InputStream $stream): Promise { return $this->client->streamBinary($stream); } public function ping(): Promise { return $this->client->ping(); } public function getInfo(): ClientMetadata { return $this->client->getInfo(); } public function close(int $code = Code::NORMAL_CLOSE, string $reason = ''): Promise { return $this->client->close($code, $reason); } public function onClose(callable $onClose): void { $this->client->onClose($onClose); } } >>>?>=>;>:>}s>?> 6> >> <>Rich>PEdU%s\" 02@`_HLXpX@.text.0 `.rdataH*@,4@@.datap`@.pdataHb@@.gfidsf@@.rsrch@@.relocLF@B@SHH_H3HD$xHD$@HILD$@~f11tH 4D3H$395-fH$t9 f~fD$XHft$\D$`0fD$ZHT$X3fD$HHeL$L e0fD$JHT$HHKE3Ht$0DHt$(Ht$ P0H$H$tH Z43';0=3'tDH4c3HL$xH3HĀ[@SUVWAVAWHXH^H3HD$HL$3AH\$0IH\$(D\$ LL$@DHՋ/u!/EHK4M3vDӃWfoA@EECMAHAKHMAfBnLECfnDMfnTASfBn\AKfbEKfBnDMfbHfbHfAfBnLfofnTfn\fbfbfbffoD;]ffofsffofsff~D;sWA+ƒr9A‹A+HHDEJ@fPH@ IuD;s AH|DL$@D;tEƉ|$ IH 33HL$HH3HXA_A^_^][@SHH\H3H$HD$PHILD$P~f-tH 3D!3 bHD$xHD$8L$@D$0D$xHcH bHL$H_,D$0LD$XȈD$|AL$yL$zD$XD$}H2D$@L${HKHD$ D$hZCH$H3HĐ[H\$ AVHH[[H3HD$paHكE3Dt$dD$@-HKLL$hHD$HEFHD$dLt$0Lt$(HT$@HD$ ,u)W,DH=2HL$H,3DD$hAs%DL$@H m2HL$H,3RH$H|$H<t$H 2D^HL$H[,3Ot@}L ?M L X3DH k3HL$H,3DL$@HD$`H$AHD$XfD$`D$PE;tH 1H|$HLHc n`LHOHcH|`q'tH r3H|$H@t$aCHt+H3HKLD$PAHD$ ADH$H$HL$pH3EH$HĀA^3Hz| HH|3øH\$ UAVAWH$HHXH3HpE3LAI HH|H$IH${ED|$@EDPED`I޿@LACAEtISDH9XtA;rA;u#A@sICHXDPADPAEtISH9htA;rA;uiA@scICHhD`AD`Du?AEtISH9THtA;rA;uA@sICHDHDD$@ADD$@HHL`L|$ LP3HT$@(؃='AI~yH}pI HT$@HI(I t;HIHP}(I t `t|HIH`W(uHDžI3IHcLL$4D$0AIHD$0HD$ HK+(uEH 0PH$H$HpH3NH$HĀA_A^]DH0L$4H }1p'H'1됃H\$Ht$H|$AVH 3AHHYPHAXHHcLFHHE3HHQ%tjuHOHE3AP%tCH|F`hHHHNHHN(HH i1H 0 3H\$0Ht$8H|$@H A^H\$Hl$Ht$ WHPHTH3HD$HHك&HKLL$@3HD$8HD$0AHt$ $tZH-1DD$@tjLD$0HKAD$0Hl$ tIHT$8LL$@HKAHt$ V$u$mt$DH'1HKr$HK%HL$HH3 H\$hHl$pHt$xHP_H\$Ht$WHpHSH3HD$`H3t$T%HKLL$PHD$HDFHD$THt$0Ht$(HT$@HD$ D$@"%;tqDD$PEHT$HLL$XHKHt$ o#DD$XDL$PE;uuHKHD$THt$0LL$PHt$(HT$@AHD$ $uO#HX0DHK<#HL$`H3L\$pI[Is I_ËH 0"HN0묋H\$Hl$Ht$WPH+H|RH3H$@X@ۍ4@h"3LL$0HHl$ DHT$@H8"uv"H03T$0;tDH 03Ή5X#DHT$@HHXΉ5|X#HT$@DHHlXHdLL$0Hl$ AHT$@H!u!H03>T$0tH ?1:3"D$@tH 13LL$0Hl$ AHT$@H!uT!H#23D$0=uH U2 3@8l@tH 2 3Hl$(DHl$ LD$@3ҹ Hc؅uH 2h 3SHH@HO"Dω\$(LD$@HW3HD$  uH 3 3H$@H3!L$PI[IkIs I_HXHOH3HD$H3T$@HID$AHD$@HD$8AD$AAD$BADD$DLD$0LL$ AD$CD$0HL$HH3HXH\$Hl$Ht$ WAVAWHPHaOH3HD$@3Ht$(DLI HT$ qD$ =uIAHHHH|Et[AHT$(AAuH2e HfI HT$ t|$ u4HH|۸$D DH1 3HL$@H3cL\$PI[(Ik0Is8IA_A^_@USWH$PHH&NH3HH=THu"HTHt HHT)tH 1 LNju  at=,TH$HuxL$ADEL$E3A@AH؉8DBDxHCHHH|L|$(LMxL D|$ 33b3HMAH,HMzH uH1` PHUpHuH+16 &D9}pH@SHEHD$HLMHE3HD$@LEHRHD$8L|$0D$( D$ u{H( HMfHM\HMRHMHDEL 0HMxlHExLL$PD|$PLL|$(3D|$ HHHEHL$`3HD$XD$hLL$hHLqH3L|$(D|$ HHHEHL$x3HD$pELMHL+H3L|$(D|$ HHHEHM3HEhHMЃH,u9H/vHMHUpCuH0[NDEpL 60HMxt1Ht!HMxHIEpH X%KL$H$L$HH3< Hİ_[]H\$Ht$ WH0HJH3HD$(3HHt$ HDF HHT$ 0H9\$ t8u 73HL$(H3 H\$PHt$XH0_H\$Ht$WH HI`HֹLHt.t H t/tH{CH\$0Ht$8H _HHֹLHt!uCH{H\$0Ht$8H _H >/HH\$03Ht$8H _@SH HHI|t=w H [ËH /d3H [@SH HYIH+t;H /$H [LAH\$WH IHf-uf9BufzuH\$@H _Ht$0Lt$8EtrIL5HE3H5gHEMΐMHL+B +uHutAIL;| IcH @MLH MHARBf-3f9B)HJH2.IiLL5wGE3H5GHMHuofMIM+B +uHutAIL;|}IcH @IHtmH@Hu IH :MfDMIM+fDB +uHutAIL;|IcH @IHuIH P-;30H@IHuH \-3LGH LHt$0Lt$8H\$@H _H\$Hl$HL$VWAVH 3Hc3H|$@=bLHcLM^L=ZLH=WLH;}NffILD$@Dtd~~t u HH;|Ƀ=LAH-LHt$tH Q+n3HK=KfHH,LHt!t H *HdKbKH !+H9=IKuH +9=KuH ,qH\$HHl$PH A^_^HLHT$LD$LL$ SVWH0HHt$`HE3Ht$ LHH H0_^[Hl$Ht$H|$ ATAVAWH0ILHyHl$(ME3HD$ 3LHHIAHA;uAlHcϸHH\$PHI@HmHHt7IGLcMHl$(HHD$ BAHăuH6AHH\$PHl$XHt$`H|$hH0A_A^A\HL$HT$LD$LL$ H8H=Iu3H8úH\$0JHHu H\$0H8HT$@LD$HHL$ HT$ HcI&E3HJf wIs fDHH EIHSHH\$0H8LISMCMK SH`HEBH3HD$P3ICDD$(AIC3ICICHT$xHu&LD$HH )HL$PH3H`[L$HL$@LL$HH )HT$@DHL$PH3H`[Hl$Ht$ AVH@cH\$PE3HH|$XH 1HH#HHXH4HLt$8ALt$0LÉl$(3ҹHt$ NzuLt$8ALt$0LDt$(3ҹLt$ aHc^HHHILt$8ALt$0LÉ|$(3ҹHD$ HRLHp(HH $GHtH G4L5GHH|$XH\$PHl$`Ht$hH@A^H%ffH; ?uHfuH@SH  ;8 c HCtlR H 6 uV,t H   t 3H [ù̹H(3H(H(sjH( H\$Ht$WH0+u @2@t$ ؋ Du xuJDHH  t HH s lD@@t$ OHH8t"HtHHrE3AP3HH8tHmtH x Hj H> LH u1 @uE 3ұ!u ̀|$ u H\$@Ht$HH0_H(/H(v@SH H3GHF0HȺ H [H%HL$H8 t)H O>HD$8H6?HD$8HH>H?H=HD$@H>j= d=n=HkH f=HHkH <HL HkH <HL H H8@SVWH@HW H3E3HT$`H Ht9Hd$8HL$hHT$`LHL$0LHL$pHL$(3H\$  ǃ|H@_^[H(t!eH%0HHH;t3H Au2H(ð@SH AɻDÈAu2u 3H [H\$UHH@كct+u'H XAt2zH \AgH;I¹@?+ȰIL3LELEELEM@LELEELE @M@ @H\$PH@]ùlHLMZf9uyHcHuH 9PEu_ f9AuTL+AHQHAH L H$I;tJ L;r BL;rH(3Hu2z$}2 22H@SH 3҅t uH?H [@SH =@tuHAH [@SH H9HًH3??HHu H9HH ?"3ɅHDHH [H(HH(H\$ UHH HeH2-+H!9H;uoHM HEHE H1EX HM H1E E HMH H3E H3EH3HH#H3-+H;HDH8H\$HHH8H ]3̸̸@H >H% ̰H>H(HHH(39X8H?H?H\$UH$@Hٹt)%x>HM3A%HMHHHE3sHtjjeso xe e`eeg>fHfeeegffgfrg"h0hdgfgh|gVgffg@g8ge*ggHgtf,ffZf(<@=@0@$0@0@p@@q@SuccessSignal not expected at this timeInvalid stream identifierInvalid process identifierDuplicate stream identifierInvalid client security tokenInvalid server security tokenFailed to set socket #%d to non-blocking mode, failed with %dConnecting socket #%d unexpectedly succeededConnecting socket #%d failedFailed to send %s to socket #%dFailed to send %s to socket #%d: sent %d of %d bytesFailed to set socket #%d to blocking mode, failed with %dhandshakeFailed to read handshake data from socket #%dFailed to read handshake data from socket #%d: received %d of expected %d bytesHandshake failed for socket #%d: Unexpected signal code %d from server, expecting HANDSHAKE_ACKUnknown errorHandshake failed for socket #%d: Server rejected connection: %d: %sHandshake failed for socket #%d: Invalid server tokenhandshake ackFailed to connect socket #%d: Unknown errorFailed to connect socket #%dFailed to create socket #%dselect() operation failedselect() unexpectedly returned zero socketsFailed to create pipe for process I/O stream #%dFailed to set handle information for process I/O stream #%dFailed to create child processFailed to read from child process pipe #%ddataFailed to read from socket #%dFailed to send data to child process pipe #%dFailed to send data to child process pipe #%d: sent %d of %d bytesFailed to read tokens from stdinFailed to read tokens from stdin: received %d of expected %d bytesFailed to read token-command separator from stdinFailed to read token-command separator from stdin: received %d of expected 1 byteFailed to read token-command separator from stdin: expected 0, got %dFailed to read command from stdinFailed to read command from stdin: command too longFailed to read command from stdin: missing null terminatorFailed to read command from stdin: invalid UTF-8 stringFailed to read command from stdin: failed to decode UTF-8 stringRetrieving copy thread #%d exit code failedWait operation on copy threads failedWSAStartup failed: %dWait operation on connect thread failedRetrieving connect thread exit code failedPIDWait operation on child process failedRetrieving process exit code failedexit codepC@C@C@D@8D@pD@D@addressporttoken-sizecwdError parsing server addressInvalid server addressInvalid server port: %dInvalid token size: %d=Unknown option: %sOption %s requires a valueProcess label not suppliedServer port not supplied127.0.0.1%d: %s%s: %d: %s%s U%s\hYMU%s\ |Y|MU%s\ YMU%s\p@B@C@RSDS3ެmNH^gC:\Users\Dave\source\repos\windows-process-wrapper\Release\ProcessWrapper64.pdb GCTL-.text$mn=.text$mn$00=6.text$x@.idata$5B.00cfgC.CRT$XCAC.CRT$XCAAC.CRT$XCZ C.CRT$XIA(C.CRT$XIAA0C.CRT$XIAC8C.CRT$XIZ@C.CRT$XPAHC.CRT$XPZPC.CRT$XTAXC.CRT$XTZ`C.rdataY.rdata$zzzdbg\.rtc$IAA\.rtc$IZZ \.rtc$TAA(\.rtc$TZZ0\.xdata_.idata$2`.idata$3`.idata$4c.idata$6p.datap.bssH.pdata.gfids$y.rsrc$01.rsrc$02 0<x!tdS0\!S0\ p`P0<H 0<4<p!t\\!d\\!\\!\\*4 P<p!td=\!=\!td=\td42#dT4 p<Hd4 p<`/ d T 4  p<@<H' dT4p<@$6p0P<!&&=<d:!i"]!!i"]d 4 R p<(d42 p20@@;d 4 2pT 4 2p`Rp`0 t d T R!4 +^,^!+^,^b!4,-^!4,-^#0<P- -t "4 d T r  d 4R p0<<1R2=R22P  brp`0 "0<o55=5P  4 rP  4 2P4Pt42 P0B`Re@beHAaeAbjjeso xe e`eeg>fHfeeegffgfrg"h0hdgfgh|gVgffg@g8ge*ggHgtf,ffZfTReadFileSetHandleInformationGetStdHandleWriteFileWaitForMultipleObjectsCreatePipeWaitForSingleObjectMultiByteToWideChar4GetExitCodeThreadVGetLastErrorCloseHandleCreateThreadGetCurrentProcessIdCreateProcessW3GetExitCodeProcessFormatMessageWXInterlockedFlushSListWideCharToMultiByteZInterlockedPushEntrySListTInitializeSListHeadYInterlockedPopEntrySListKERNEL32.dllHWSARecv WSAConnectMWSASend InetPtonWWS2_32.dllFwcsstr__C_specific_handler>memsetVCRUNTIME140.dllfreemallocnwcstol!_errno_aligned_free__stdio_common_vswprintf_s__acrt_iob_funcrealloc_aligned_malloc__stdio_common_vfprintf__stdio_common_vswprintf@_seh_filter_exeB_set_app_type __setusermatherr_configure_wide_argv5_initialize_wide_environment)_get_initial_wide_environment6_initterm7_initterm_eUexit#_exitT_set_fmode__p___argc__p___wargv_cexit_c_exit=_register_thread_local_exe_atexit_callback_configthreadlocale_set_new_mode__p__commode4_initialize_onexit_table<_register_onexit_function_crt_atexitgterminateapi-ms-win-crt-heap-l1-1-0.dllapi-ms-win-crt-convert-l1-1-0.dllapi-ms-win-crt-runtime-l1-1-0.dllapi-ms-win-crt-stdio-l1-1-0.dllapi-ms-win-crt-math-l1-1-0.dllapi-ms-win-crt-locale-l1-1-0.dllRtlCaptureContextRtlLookupFunctionEntryRtlVirtualUnwindUnhandledExceptionFilterRSetUnhandledExceptionFilterGetCurrentProcesspTerminateProcesspIsProcessorFeaturePresent0QueryPerformanceCounterGetCurrentThreadIdGetSystemTimeAsFileTimejIsDebuggerPresentmGetModuleHandleW;memcmp<memcpy2-+] f/ U@`&@U@@'@U@'@V@'@S0\S @\ \X\`fh\p\\\\\\\\=\=](]8](]P] d]X]`]  ] !]!i"]i"%^%%^%Q&,^`&:'D^@''T^''T^')\^)+p^++^+^,^^,,^,,^,-^-.-^.--^-_.^`./ _0!0(_$00T^00_0 1_ 12,_22_22T^23\_34d_4M4_P44T^4e5_h56p_6(6T^(6S6T^T66T^66_6h7_77_79_9l9_|99_99D^:J:D^T:<_<<_<E=_`==_==_==T_=>_ Er7 0`xe 8 P ` p    h(ж%xw>wX({}(  :|6 EcșO͝Qҥ^թcˣcҦ_G۝5מCk7*NH%K/G=xÐ?4{/9ϚHשaӬo[>Q<n:s<V-Y9Gbl3\!_CR:dgIo(澏Dxs۵xӞKդWe/n9Βo?sIoHV4;wCqV'_u_<\F%loĴժeໂԮr]yIL`yޢ{a_:ف`>£qxoa9ʯר]ݴtۼլlFj`waKD}>jHVطYPAMp֩bݳrÐὄxRl~d\myL]Idv;%ØU}Ƞ]Ÿgx9UhKIKӦ_ڰn⿉պǩ{ܼҳ{WbVM<ц`%Ző?ب[mAg@޾ͥαŒŽkիh͞U7e$[Aۛn'ЛIק[mAg@޿ͥƧvݳrڰl٬cΛJ9j&[AhJ}/ЙDӟM٬eڰmֻؽtڰnתb͝O3r(Z S;\!1Ε<ӠOڮiܳqƕᾆpIӯvƒ@0-f%nNV=i%‹2ΘA֧\تbݶwŒڰlC?2Ʃ{ϣ]1n'c$lMfI|/ΘCӡPդW۱nᾇܳr|cnbٹͥgw6c$hJjK=բP֧[ٮiݷz۳r|̒9 ќI, ňԭq⿈ܹǢgT]ױuժg֪g׬gѠS9Ȍ1٬eӣV~IŠÌἂh@ oMQ( @ Q \]:eÕKɜT뾕Tŝ_ӨcУ]˜RBii ftn#e8aH—Sզ[ԣTҠQש`٭gگl۲qЩleӣWɑ77o~[[9{9zɚOМIʓ=ǐ7Ë3Č3͖?КDҝHԠOתbݷzໃ۲rԡQٚ6ƏA%m9H&29'|5tB˕@1y+t)m'm'{,2ǐ9ϙCԢQ֥Xۯiֲylu<ó26\ajÂl8p<p;DN)%l%0<Ŏ7},k&oOT<G3G2Z@xUr(Ì5ЛGԢQInxjrٰoϗ>Bzƈ(p=n:n:6k9@"w$U<b'[nOQ:( w"OV=ǘl&Ō3=e㽄Ɩ۱n̓86ќGĊ-n:n:n:m9\0X-X.Y0M+{6O( ":+ dK#JlQ&hnZ<> 'S;d#nvէ^ۯl὆ƕتa͐/͔8n;n<n:Ήm9n9uCQYYQsB`3B#}(jQ)_yZ(P:}]spkI-RF4\ګbتbܲq߾DvӅW8 m9m87n:}Otydo?D#?3!MIğelcV* ǿL٫cتbثd}ؼqΛJ0̛MPsAϗe~ƘuȪsqXxY[z_^T,/'u/⽃׼_(()'=ة`٬fگj޶xǖ͡ثbj}O(kݣhK:s%x+3Fɔ?v&vT$`CE[==^(ʙL޿zr655C=ڬcܲpܲpܳrϦߺϘA*m~^ቢᯣБrJ9gd@bɜV̚K907ѡT۷˯E <0n2ة`ܲqܲpܲo~˝ǖգSl  s)bL+g|@Kŝ\ͤcԪh֯rЮyȧswAv-"!+fIq>]Oo1ТYܲpܲpܲo޶wƔɟɟ\zb=UƊpFt\7yZF%R6( / гoq,M5[OXEo;%`H"z9{n+ 4rQ}+̖@ԟLēEԣWݱlܱmݴr޶wǕҿfbŒ࿌ط̫ylxRE7!)eϗ?ϗ?ԡQ۰lܲpܲpܲo༂ΤșգSkI9*ê߷y٭f٭h֩a˙K5/|,x+h%\!xVF1V>vTk&/Ɏ2˒7ϖ>њEק\ثdڮi۱nݴsĐӬ߹~ϗ@'i‘جfΞQÎ:000/m'\!]!iKB/_D\ p(0Ȏ2Ȏ2͖?֦Zتbتbتb٫d޷z˟ͣש_=kCnX67϶دn2/000{,e$_"\!Z@C/dHa"v*0ȏ4̕>ҟNק]تbتbتaڭhὅ̡޷yКE+ҞL' b“ΠV100~-h%d$d$]!Y@L6mNi%1Ɛ9МHԢQԢRԣTר^تb٬f߹~ș༃ћHhЛ̗CpW.[C{ŕϠV3-j&d$d$d$yVbE]B[ |,˔>њCӞKԢRԢRԢRգT٬eߺǗӡQƇ# ̒7Ǣfl>6ҶȘӧb{4c$c#d$b#mMcF_CkLm(ɔ?њCҜFԡQԢRգTש_޶yǗངԡRʍ-͓9+NBݾɚԭpHq/f&[ cFaDaD`Df.ӤXգSӟM֦Z٬fܴtແ޹حhќJgLj& ː3mIΠV6༃ɛխm˜U~>i1g0p6FϡX߹}۴vخl۴v޸}۴u֩bΚGƊ,)V}p ݲmМI۲qđ˞Ɣ}ܳr۱oݴs~Ï͟W‘DƕH͙F{ɑ9O…%er ̒6ń"ԤV9ܴtŔșʜʝɛῈٮifɍ.КFʋ(~ЛF$֧[Wٮh۱nڰmتb`ѝK"nŅ#?  ?(0` $?,ʍ+t$|,e7A“HD߯L͞TʚNǕFÏ=2n(6" XduEq%'o,tu<˟Yԩd׬g٭fϥbӭp޷zݷzܶzڳuլkϢZ~q)hAƓC˔<3-v*r)p(j&h%j&u)},/‹4ɒ:ќGԢRԢQԣSר^ݳpկuv{Te,0_;ʑ6m9l8o:tF% )R9k$':ΚGŌ2.z,o(`"oN\BM7G2K5_CvTh%x+/ʒ9ѝJԢRբRӡQD{mWxtp`VG{֫eΕ;rƊ,ɏ4n;o<n:rh72\Ċ0|X54~,s)g%vSI3& f9*1 Q& F2rQr)0ɐ5ЛGПOl;{so˪wƔ̟٭g͔:rȎ2˓:m9{En:^o;]1 ,% 5L6΀[wUjLcGX?5& ` )* eHp(0ȏ4f4S޴r༄Ē˟תa̒7_ȏ7q?m:n:Zp}Oo;V-!?shB[V̧kFDAAlhaIIIxM֦Yتbتbتbتa۰nἄ‘xzIЛG$ȖHm9m:m9͐n;X~{ytmly^p:*@޵u̦§}g.% zzyu=ՠMتbتbتbتc٭g༂ēѭӟN˔;ўLm9l7(r@k~~~˞{܊ikɲW>m/vU+W@?nUswIO'/aE߼6ܲpҬȨu4w9ҚAר_٫dڭh۰mܱo޷zđ̠ԮتbКE(ҞM[xHsl~pW^Ijv)[KΛJÌ5y*^X?L5JH-\@(:`C!u*ΛJᾇTXr**)$##Gy:Қ@ة`ܱoܲpܲpܲpܳq⿉ƕֲ༂ҝJrաNl;lۚw\!A:+0nl2ƜZԠNÌ5~-o'b _l$/˖Cܳrʠqc: E2sY1˘Hة^ܲpܲpܲpܲpܲo߹~ŒЧ͡գUϙD b~~.}N~t~~ῢܙxL;k oP p&Eʠ]ңXΙEŏ9Œ7Í7˕?ԢS߷yܾxƱ@4X% VA1eM's6ئXܲoܲpܲpܲpܲpݵuÏʜֲ٭gКF6ytz }9kSO  x.p$r;|ƞaիjիhڮgٮj߸{ٷѴŢkh.&iq*+ uTy`7uTc~R|7a+ԢS۰mܲpܲpܲpܲpܲq⿉Ɩ״~МHn# Q8*d?"q"g5@H^Ψmܻiɦn˺^t=Du" t4Mm)- _"w)0̘EԟLƔDo2ҠPۯkܲqܲpܲpܲpܲoແƔ̧to3YbN.˺dZwJ|b:dN+K:}1$W5e95 h {)n#g JSA%(w=|3`"0" _"x*4ќIӟMҞL͚JӠOڮiܰmڰlݳrݴsݴtἃ˟˫T{eAĐǔőٷ˩teTh@ 7*C3g5(Z% D5   '' 5D3KhQ,rrAJ㾋;j&wUbC/̏e$y+‹5ѝKӟNӠNԠOգT֧]?|6S۶zϥٸگioKŒœœœƔƕǕȕt!WUE-z`]VP{c1v*]!qQx! TU=c#z,ō3ќGר]ר]ר]ڭe˯#-..ZULoV-ڵ{⾅ֲͣܳqyVǕœœœœœœœē]O;rN侂ແແἀ̨oPΛKƏ9Ċ1/v*`"sR1# mK5vSm'.ʑ6ӡPר^ר]ר]ڭe˯#-..ZULoV-ڵ{⾅ֲͣܳqxWǗœœœœœœŔǕgh{ݴsڮiר^բSȑ:É0Ê1.r)b#uTH4>,bE\ p(.Ȑ7ӠOգUեW֦Yק\۱plB# T<TເᾆΤִ۱oqRǘœŔœĒÏᾆ֯pӤYգSӠOӟMӟLӟM̖@0{,n'e$xV]C<+P9kLa#u*0˕?ӟMӟMӟMӟNӠOգTר^?|6S۶{⿉ΥٸگixeIĖ⾇ແ޷zܴt۱nگj٭h٭g٬eԢRӟLӟMӟMӟMҞLđ?u*k&g%{WkLB/J5_CtSg%z+1ϚEӟMӟMӟMӟMӟLգT۰mܰlڰlݳrݴsݴtὅ̭͢TdS8ػ۰l٭g٭f٭f٭g٭g٭g٭g٭g֥YӟMӟMӟM˗F7{-t)j&}Y sRT<9(S;lLZ l'-Í7ϗ@КDҝJӟMӟMӟMר]ܲpܲpܲpܲpܲpܲoὅʛάvn3YI:#nʱ޶v٭f٭g٭g٭g٭g٭g٭g٭gتaԠOΛI;}.y+y+x+d$uTlM@-C0X?vTb#s).̕=ϗ?ϗ?Ϙ@ћFҞKԠPڮhܲpܲpܲpܲpܲpܳqŽʝڹЛHn!6w٬f٭g٭g٭g٭g٭g٭gٮhثcȕF1y+y+y+y+k&]![!`D:)O8bFxUl'v*/̓9ϗ?ϗ?ϗ?ϗ?ϘAգUܱoܲpܲpܲpܲpܲp޶wǖΣض٭gћF5 yWɝگl٭g٭g٭g٭g٭h٬fѢXƑ?0{+y+y+y+o'^"\![!N7@.V>mN~Y p(|,ƍ2ȏ3̔:ϗ?ϗ?ϗ?КDק\٬f۰lܲpܲpܲpܲo༃ɚԮ͢ԣTΚG qcO1r׿ແ٭f٭g٭g٭gԦ]ɖF3/0.z+y+r(_"\!]!uT?-H3^CsRb#n'/Ɏ2Ȏ2ɏ3͕<ϗ?ИAդVتbتbتc٭g۱mܲpݴsđ˝ٹߺѝIlԠN3''(u͢ڰl٭g֩a̚L6/0000.u*a#\!\!]!eH:)N8eHxUg%p(0Ȏ2Ȏ2Ȏ2ɏ4Η?ԢTتbتbتbتbتbثdڮișѩӭר]ЛF!ҞM}eAʥᾇѡVÎ;0000000/j&]!\!\![ V=;*Q:iK~Z j&v*0ǎ2Ȏ2Ȏ2ʑ6ѝKة`تbتbتbتbتbتa٭hᾆȘٸ༂ҞK|RϜMK89( .uϥѣ[1000000/r)d$c#_"]!vTL7=+T<lM^!l&|,/ċ1ɐ4̖>ҟMԢRեXتaتbتbتbتbثd޸{̠șԣUЛGўLx_8}œ͜P100000v*d$d$d$d$b#oOO8?-U<mNa"o'/3Ȓ<ўKԢQԢRԢRԢR֦Zتbتbتbتbݵu⿉ǗΤ֧]̓:QЖ:͙H:*!ZЩᾇ̛O1000z+f%d$d$d$d$a#jK_CT;gI]!r(0˕>ϙBћFԡQԢRԢRԢRԢRԢS֧\تbتcܴtῈŔЧڰmΖ=ˑ7͕=l7]E;tӭ༃ϟT4/}-g%d$d$d$d$d$Z dGcFZ@hJb#y+5ЙCњCњCӟMԢRԢRԢRԢRԢRԢSש`ݶw⿈ƔϦܳsϘAʑ6͔; b3_ѳԮᾆԧ_;j&c#d$d$d$d$d$rQbFcF_D]BxVp(2ϘAњCњCҝIԢRԢRԢRԢQԢR֦[۱oᾇɚΣ۱nϘAΕ;Ζ>7(xArڻհԩfDl+c#c#d$d$`"hJcFcFcF_C_DjK9ӟMњDњBћDӠOԢRԣT֧[٭hܳt߹~œŔש`Ζ?ʑ7̓9_'_F(Iq޽ҬÏܳsˠ[Bo.e%c#zWbEbEbEbEaE_CtV'șNڭf֦ZԠOԠO֦Z٬f۰nݵwߺ׬hΙE̔:Pʐ6˒8s1wQϞP_޸zϦ˟ὄ۲pХ`O>d,sS"oP pQ!wW%f/B̜Pة_ໂܴtܳr޶xᾆ޺תe͙FǍ2xĉ*̎-/ΘB~ѝK<ٮiƖҫɛᾆ޶wگlҥ]˞VǚTǛTΠX֨^ڭdڭg߹}ʜԫj˞VϤ`Цdժfԥ\ϜKʓ;ŋ/bÇ)%'z#֣RΙCդW޷y˞ӭΤÐເ߷y޶v޶u޷xߺ~⿈đΣᾆΜL`'C,`-e-Yʼn+=Ç'#Ȍ)g ͕=ȍ2МH0֦Zݵvœ͢ϧϦΣͣϦѫӭɛ޷yԤVhʑ6ЛHΖ<ʐ5ЛF&ӡQjש`۲p߹~ῇແ۲q֧[ѝK2ʐ5ΗA= SɎ4ϘAќG;ҞLQҞLXўKPЛG7Ζ=Ą$Nj,00 ? <  0??PNG  IHDR\rfIDATx}w.mo;؄B $+I(]r wRH% 5 \$@(0lhUFhW[L|F3yyOdOcƖkFOTO矼C<chMݬP a ݠvA϶ksrCS t , 0p4xW)c10p!ԶgUA7VJeNgkt;gΩ08&< 8Y5dAӍ7 #w?{[|ajpLTK{CSgy|.ߢi=,,SU@_:U>pq9E!77#0g.UH(:T") I`BHRu( M5t0wG 1pL?5 ˜Z{p,.6PV,Efw"tX2uh@, \ʿ86?<[zJ3,T |)dG:IAgXٮX28qLKX@G5K9_F \ cpe6'+|:/v_ɱ)w?{[v=G%><':Ȧ4t ŨoE 8o/qe9F/+o ]CH(פ7UrV~N+D/3B:xl0~d^o 9]8O0+")1Y@BEXNH4Gʆ p;OkfϱWr%uv_nW41YϘN1 ى=<&`չ p z2~^5ԡWRK$UG_BCOTF_$ituFӜ+Br<|gD|W(|n/fJVb(fȪ="A̿WDξ \.x!P wb)l`N|%׸hv'|_ >Uՠ)8qd 3˲ . Q\/ V}00*^t$VbH" cRw֞_ ߎ/eWE` C‚4y栀4mٮx."GX]\Ex?*` yM9JuKO9/n Z֐IaJJ{VSzES |d#φiHu[ t%s׎NYd|_4;UB$ObkO 2<}wSQ /y|_f75@\-0`RO"CAuN|ġj=:QnI/7DDR>~r":;80ˇ%4RWP|xӷmhFGfGǪ6?TB 9&U(PݽcZA L Ey^E⑃|WcLpPYjPEBlVGcVl;2L gp`8t -nW>5Luq .]و @Dp(,gb R5N1u%ƃX `=V}jꚋop 0 i$ͬlKcł#ȳ9Ku ?Cud՗Km8xeد~)[ri7{rq hIPICwLt)f4P_Ϊ}cD 9 k7c>J(濥<<7BPjPt(7GωrJv/_~4ZVa?z}2<>vB3)I5ә0(FRZN?Yid[Zq}vAQ*dzx0nZ.[`-) 4:2w2&Rax} mZӒ{b *d?\׉o;wFs~^6aZLRL-Ԍ#[f5`ς%d12pjD<{`)~EIJpGK`)7o]?ij3C.|fxyAS2 ,AџP!?M7Ptղ;<-ϤCMMF]N=Xm#>:O-R%pq B.vܑCϾ)Ic ~h~ѐI86;A ,ҋ|MdͭukZ _)b29 aǡ#ݓ\/a%"Y0`(I{CX=`x xuZx,tG%t뇋crЂfPQIf.3Q $5p +Ky67,wHDB~.C|yK-/&Gr~˙M bPtH̵b/2b2S:B@)E*2܎;BRt|0`Ztb{CN> uy#`8<[_`lj (&|8:ڌ<`}P&'_ TX Do0G%5jbt NLC_&ֶ~f~àJ9K fPۏ`(9~10‹?P ?-9V=^_Ug ?% #,0cJձo((Qe7[̔cH{]SNIuS~k]l5-l[a> "4l`$NÂu'"kf$ _6MȂXFph*Lry"*70sCe QBAiTlx ,%!r kb0b$/!zy+w?m~6 kydey;AWV2nLV@lZu4 M)~Fp'P<8oX]+eW|Hd/o!80, ɳ-tzw~<7 )QF2r3>Š8&g oLeh:k< S 0&ou P_!s?༡{d 0C53ӧ9$ұd EjPt%D Cp6γ/R |{:(IWo,\2R|FƊ d&H}N(%?ԁa:} C~]{C7<~Uw}Q1YZ8͇ }m:(U|X \߃;wq]k#a MLrp5rPy⊁EPE)J mlV>S8QUUjD[%`e nɸ~o֜K<ү'+5W~͠=eCm6JS튛ٚvr THIVﰜwǐڨe&^Lx+T_`.k`~I5CK8fP7oa:Exo/Vrdh5\W*,B`)bс>k/$}d徉/cmǮτ.^/dH?!Ii+Rs2,+?s63|=]gQB=]V;ƿR(+R!gpMtxjyb7? kf]5KcS3o*Ң?``J!TW ,k Х$T Z" ->В1(d$ #=.%@U c S#cSZx 4_)G 3]y:s>t'UW˄o\_kœf@`zb ’U]5Ÿ 5:yД}>Pk05 R Z20yX}_glDXҜPۚ 0K,k5Mvݿ\3BE.EWFTp4 PWMDC_vU5p& AD2~KK CS R aHASJCzNL|"P]$+H&`/a$qh6߭@%`8- 8>2WqU+8x1`cG-~aIh3"Cdu2B%#Х %5EwEx)P;b)P?LAuucƊΑJRⶐ OP;CXS'l)&h=C pt~ ) G1%0% AT""^46Ko8,c'*'g^*خvO.>#x~hyc~+/Eft~ 04 &EyR܀Fdb$BH4@t8Pu#sT" Cp΢:B)wߴjUQF2MlU~A1cP_ ge+1@ڜz]x˝C9Tbᔆ# o^M)$Ra<3y˒g}jae,]쒫 z< ,޿|hL H[myU?nC MÊl5!UYNI@T0E$jQ>ލe-Qj>jMO33HcgQI;Gq Zd[`8~RRxQ!,_p"D2N1P+ jx]"Bm8)œ . 3!N[ !g~E֡[)qs*٨BJEY &ي`<d0NuN x jLz6kPUՈ nQ?yÚ{R3P C$'ޯ Twj5&ZF!Xϡp;_ {4:ppJ+p g4ypB[+ ]bs&֚"G0R3#ӖwJ"p<89 &SpT㍚S+L'᷐T|W2d!c|nǮ(µhX|8`MF!kǕIh8 6. Vbt.P aSM[(( $TIB+3!Cdz'ϵq sxMa+.<4ETI@BёRu\ J Tc kO9w⢔tBUpJ+ LERtG=cE 6cnc=)j9̍LnxR3X2궚 ص_y܀bdյnS_O6IS7)p_%4Z+%?v4/T:[/˹UVg9s)*TBRuD\@B5"m X0C'&F&Rh7U8ER%Ns< Ȃ*NF!:l„)9;H5߬2*Ij?`RSqܬ-p5a ~%SQ*M\R$bE܀H4ҤV {Y\pBKP ̙]L?(rf8-N?ItzԺjt|nRz[i%Nqs&pJ 8BISU ӚCr ArcuZp4mLoTҠ4EdV3ܮR1^P]`w5̘t/T8\_<@0YS.\$Rw4)".k9~)'Ԣ׷p0[{5WrN98yxfyvJY,oc:TW%!6Ll7g+5x@%(j sI?M79"Apd\8@3 rqEJͱv-t6u:P/[`]>X. k%@yTП5s"YS.Lj.CʭJG kzaA{ȅ o% {:ul3X6e U<8!X/Gy&z82tRNuC~weol?)]1+cM` (^< @ܓ7wD|k W)J1QJ 7PA'cWM7*񢘟Qpl$ ﱩda\R0T`'0b铲 ?0~X0LoeNV*Rg+"s,;Al-QFȝ ppiT׺̯sgrGRR  M+k'*2jJ&ߔL- f R <+`Xl[x,ˮoZzbޖH/ee磚rn@h.'eA2]V@5N|LNCI(,i*\4M`UTN\k*i^i[QIC\1ƄfMJO韏jEʹe:k%Nj2NP ? *XĊX~1Wc|n{k@`^QuHJB~dv U)*eMsdPeF*``(~r )߼` ؆ @1m_]37U71Y?*W;X@]`b w@m7)(4L WrV+ņO~ E? ZA  cox6/] X8ZWt$d0w̎Km' Z2)hS6%#9+<5jrE͓R lg#G0`-q˽mk21E4ӻiOc1k6|v>W22`hj[ S6\mjH/ (kjXS;0bCAVs5Xz3me HV|,z̞5kȀ%ƒH2a%YMlPMv&S*_ rHq[P" mu߹w)`j+h'*bdDL[RTm->\6%Ž AIiRV@ġ(<@< jU")QWN+?mb'/504j[ӁY!N‚CS!U c| i.N3ByXirr5L/Iժ`ufv̟P~@S Le[X 6PJ0z2ZvץDINq2 *gY: ,M? q8%;3Xh0T_]y='JDչ}י*$2YD DTWA8b9%CNږ 3;p[E-}+dJ^C? bmNr,إ3}jwSHSY3fM?ƋC)6#zʦfu'.Gs\r`QEFuͶ@>'N.0scUkRu}Z SR#˭GU(2uZTBL+dO [/8o/TѱR4$! 3J ?`F Ir6Ic`ө> U4Px!7ޗފDlǎF @4M>>S/͋w?Y*M+H`CEAOnQk`J?dad™PM? ܓ EwrsEޅp-^4ѽ6}oP]%ƙ`82 @ՠ߻=?mD,AɎ{[4hi[TA0fxVAs Yz2 +k EJ<0S:%,9='X^X"_{o _%?MvcRP>fE4x\xͧ&/Riŕv!42 .Gii*t@Z>uy3Vu()VXtE•t6~^r9c@ug|? f ;h߼!P4)Bt$}Z 1Yz`,Pu=RaQghZO?5 LM0+@Xb1'|&'._ˀg ~6<.n8*Y\~oC Ǜo BMš S/ٳWk:Pq8"!))ZVJُHaD$WbЦI#Hļ>gG5 iZ tc}jls9Jy_Vȇ$+!ʢڴQĔ|aCJNu^u`p^;9gRVC֕!oN4 X~k,J $nDLƤFO5yPcCf-Ȁ{ڗs':)DJjddM+z@X^zF,aX,1ρɺlPՠvcZL hIP%̱ n >3B.,l`iun **߿H́[9u" ǵ-}zi -1R2H%!'m1̜o"%Cէ-D9Y+ BntW㬒J"% eiER07Sd8+n% by<}|>foy9,51 КY 56p6@:% ewqcr#Nfxf,r܋(i=I#;KƆ33?s-ѡVG%uT²9VNx ;wƃ@}0e`=r=h:qNWrx@ H+"C5;w=469@qPJ. ,O'P1Ux]XŒF:h IWrCrXeUd BNn9K 0ѵ'VJ po /DTh0ǛI>u(n Ln,<:.#GPZ'qp1aVS~SQ]2- Hf[ˌYRu$U#3|"0ևܲrb]ky2s]wu-y/D;0"4)؍>sgND5ݰuW\6|^mK4lF eƋ/>U~䋶,Aea)ABYVxᅚfpβl(`8' j|VGA`ڌӴn܋,A`BF/>+{AXI~GO}`͸er  E3ƴ" %6voNji}50^’fVzm;|Tj۞q7f$N׵lH#@n)qBي/0AAГx_+?j"¡=rƪ}oi:`/ 3Z)&OxߟJw20 ș!ϘB5I.+oAH8lda(EBwTWͨ_ӂ!F}Yv;AT33 4cC7?7xj" `}<;^,Y.ie@ix!iŒ>~{hՎ[L!4xl*EX*y%!䶳?zRo^U)fԸY4GN)_- G-I(~ha*&yhf@JՏ@6xo(K!X.fոrFe,+'.A ΚCu|?ѵ}\FFm#Z\` ;x.w8ULCۼ.GPn];u\]S+25ҟbF"tb ]A>YŠT 95@O~$g޿kǸcNI:7VzQG5An2%VR !H=Њp|u|vSӣÕ0U94_ [۶Vtfedh^KIHw$®)vx'<A@d|7XфU0gL2jK-R,CZ[@awc}p]we>? _?Џ ;@7(]Ss^t^Y-f\0zpaz(yxoI 1^b8/Y8ĹJo!_F1a1[KYz 8n`sOS>鏧/VИ؁eHpP.߷}N oݟcTfbMG#ZcWV ]XdḖ/*]NA %&0]GwODSoWƂlgsͳ9VXa /V!hASZqFgjy]⌫q Gnկ rm/,:4puZӬk֘4x1jbmNNFFW1,`mGף_yL1%P,2Of¯= x~RZ7`{$4'TDed^lLw/33 NF1ʟct_KFQibzb $UI]n㘏ƩիWgUrFp?8ϩ412ND S}7^qW LU"O!<%E8pF/jv 8o"S7P0rdtgA]{ff!'s+}f!nLh>PR-xBxgr|WM#\ |EEoT"e%V} @@רn5**Ҭp!7Jvo/ `f5J\l(  ʬ矼Cf uZ%FM4IIPRCoL}s-qY5υP>ؘYjAϝ?ה;^`HB&GHX,S°@oJ:1 @J5SӄQOTF爄}C)3;I۽ql1]C5,J&#=ΰWW0T1Tt{vyug;w,g0ËYï?F-PPJ˱+HDHJGoL([m֝!§*+z j +69(-h5" %kQ]`v'Ղ矼CaFyK) lOT۽qKbP %Sh2**’fQ Hv 5{ZN|0{6k 4 $TUtG匲VCkЅiĬz_ѐ'6̈h纮gAﺦ3|@vry}UH^/5 ZWRxom}',٘tM:t[%2Pa3t?-7 \ccWKonch 1ztpfآ$ːdRTS'#FcHcϟt=+`y! k6ǵo5"3Y\ 1Lύ /lGg4b 矼Dמf@O3DlK ǃq ̏F)B>OK)qL1 p4+PL֠gcn F2ʕ6vȿ$"EB 73P`ddԾ'pMkϙ&_]3 M5Lr= wё!hH#kogq@GRq,1Y%kB]VfaU)p:l &i4Q=~?yG0}P%$p㩮az F'N褆6|bwY_K MA =V.Pљכ{_mQx-j_]3#*|"f,x/Z0♕rBNN+\W9599m L%]0A=KI)9%HH2|37syL)j*<*pҺ1uLib;N!,)k Xnja.S ew\֐Tty_@>;|~;t3I)<wJxPS]_ BV+3c{6a{6"8d]XAqwĶ0ճ7#̩4+mA3AGxoka8m`8dCwKGjCqw ~͉k$QW w琚'NZ9Q~Z9mr9G `fj$ULP'ƈd @2;-=vx7>\ _Sro#HNu-gUL+  ]EX~@&ݵmFۺ!GTxLA0`܇8 # 3#cKV+}j"aćj:2Euє@<{iId 1pcѼXxḇR=BTRaeTWV-f0)1IC"=#B_jo|HG]Hv 5O |D v@W_է3"H:u,WcC>j*ks\̍|M78x;e.Զ4d[uf~D᠅@pPq\cgrO`2睏[ =;#TfD_tbgCN&=60r`@g_6M4ݵg! p؁|_Ǝg\_fx\"SjV=vD < 7 oB 2@yPe./ E30wCM[|*VY/) #C9Kc'cG!ֹ9ND Rx=%|'_`̒^@m5 {t5',:(o-Ub(Nf~كǢї-nj}H9dc>T18M*VD Y3pF!B+igJ;)1*+¼ J}0N𮝣 S]6QGYm~~+`Ns S l2mLsBC 48(, \-bܝ]e7`f ݣ3&|Ml[ޢrT(V3Ej""|,{cհuhnAwT﯃BS>GaIP.7q20Q g=sGgq%D~C>$ Alb}Юra4VhSMdCo%˃Zo,w,SCۼ Qș`Yr;LV +%U,X݆'_C:>b\QM85t_~kőÝ6G"[Apf$#ÝؼV *1U;cdžRCN6ƹZtp0tWn~G/u|湂~0Z*f;tM> QU1uƂ^9էNϠM_{oq}^ HsHg>; ˿F m7aTce]`kA ԕ?9𜷆 mup5 -BrmqDԇJC/$Ƀ۰/hU7>V4zy] <|9C~]P]()})Ը@ws|/6+6CX?4T[2 V_bzOǡ-Et"鎴߯ܲ^ZDܬ`8n!D^o +]?t;6=NxhKj-04*:xŽߏMꏏ OAS.<' 8ƍ_w=UbX.6F8tiq3>=ܮZF>:b̬ڜ%.<jN'?5ͳ8~^׆Oߺz|n>!tElc{ǗRg[~Xu?G䲽-I)HiqE%g!r,>\{On>nٲ{)]\t?jn(_c?/]{碩NOid-(V+`ga<]5q҂h’Cuա;*t+3<39xx+ϺN6[|88U xW?/ٻn ~GUZ2 eP70 9C5W!!x|>x8bѱiP4*Y ݻN8P:>w\+?YUXނK~e )ɼ\5-a37_1Ț1ήug;#|W>X'ﱺMA5P]iVTW?A?P2+7+Ph5Z֞UT!X}/4`;8Z?.j-S}cMş5_׶+/7SkW~!a_nj'kCᷱrfpHSZ2MXӍ3xdLA!^"K rV1HŁa ^E(%[1~ E}_S =-x&xlϫxD3ڊ:Ү?TӀI cNڻ~Yt,Ï.&s?x E5Z M1UH MJ,#p$Rhc ͋X8ϥ 1[⅑p ']{ xg,i7ns_o ݃S/Khzj I3LW *A*3g؜ !8 ,x@fnozxla|@@ԀL_D~op wiXv-<¦ n4UI&{ǖ-[p}ᑇ&;-$Y7@ P]5i^q8@}]d=_?a&߼ CΦ ǁVar}EotO|={8~fqf.u̞3k`3A3mo!"άfG~a$Z Y cPD$ <ą}r >u3`Qמ"n}I큟~fq?|vs3E4)#}`E/ OTW}glw z_ Kŋxb|cu݀o}F 1ZT)i8 5ˋo(%F<۔(b滭;S*]?K `bLx`V04 %Ԃf A3O)55W=xpeB+`S:S:.A@U$ m!x b| 9gl_VZ銫{oAkZ[ 7ov$C(";͉ѮF;C/?8RH$(xG# 9g?+/sDFpCJjۋ*)(SLM7@JEGgpqh 毛VV$b` 5.nGN> {p+Ko|Ȏ޸nbnbF;VܤtIcВQJ 7̉ѳN`I)(spP@x ?yhBn~f1[˗fN*bX5j>@BS%$aꀛRMBuD5|ڄG{r F20jBAXc0w_XÄ9׭u;l!FJL IVF0CF{XpeE4f"1{[7?[y`?ܞn+F:Rit(QL-kYmMJdYCVX͟<0 JJsEQ~iZ[WUBw9*ᅟ/; TS.T|K/^_v h5F?/?XvU'TtqpI#hB%?m2nu_oѵw0;?h菚'HPŶVAC*0GO7yr# b0 Ca!7,E2@UݼfMt0.x3? kA)|t {m(7mrMܑ=wOy.]8ft|Tjx?e4MH&Tr Z" ´R@2BGK]U/m5t 8o>]w<Vmsߌ:u$TSFMW 743UPe`3 /0,ÀIq"H tzC`838 MAcUW0 .:%*2c clMZ̎j$ \̈́+g(<)jp9Rg6駾J:nı콩]fh}:(MUqXWm8d}?fj2X2IEǡ FoH<&l?j*wjX=XRui㍉B@t~] jȡC)u 'S'!nSc@eC왩ghX7mhmGSrmf^p8I-Yd C#YCF] qp;55 ^,6 5ɫ>= zDj"+[ˠKq N]NAA1{JHAuM#[?0^$U)E[`1Z뱷{7eW$#@$>CVAf)j>)]oCٸC&?Au??ɷMKp3g1nC7|f2 D"S)g*Tt,K&m/f`gAX~u/vBd>k뷘4aƟu+ﻱP%Ux{}~fqXҡ/fUY 52‰k0QLS9¯'cУ#tEJόSG@b8AV2˚e܇G̦܃µ-ߘ^8J`$s\gaSZe4yx,!< xx7<1N7?]: @4V&*:b´CR&|k /w\GǠm4)u!!4|tc20 S0kt?o?6oP- W8YFQ\jRM6_CvP}d pe~>ړdK=gfzg ZAV<R/x[0K }9H%RX8FMkF5(Y!yཋ~aN8q)g9"Ҵ"ZT4bYi8857 S*R~:R_=}`{G|#Mȍ*B,~'#7m8*it9r|~l^eN5CJ yp+⻷ oo_-̟3q<AͼVLP*]{0M 0rVpjxVǡk3R:x;d]SRUj$gH;U7ATҠh:9;EȡJ_:9#̍S*nr?_Gý7\²wRe@8af|'讗pO?H>t,3o1A @KFAUJ>D|,3`^*n Rg?ܼSd+W>} ڃ7.%`(1CIf|Ρ,O*|t,2t`s7ż{lR*MVdN iuT cjlQB 9'hkI=w)Rt a~oB΄oB e˔ ˓/aY\r'vSGzm芁зs/n={ՀjKq\nPo \riV=90oA~Oߦi~boMEG] gx<ڷ _ʻ-p-䚖B ԁcMOҌL\B5Ldzd?zGbܾt`J8}6\EJ M+EIj=c&j㖏a@aF؎b=׽{RI݊Y(ڮ<ynǔ'li5jb1\r-WƮ#lFeOݦYə;=_Hk*}P%"Тj"f"l^~pPP ʻPL d'm]?yj r@7Gx2)\=& @320`Z4#1={3 %xQk\CNR<_I4 >^Ҏ۝zբBP/z3V-=W59Ν k{^oqkj*4l\A3NK ZhCk8/i73nj4kVp PmLEOQ*UۅpFw`&egPq%|+::؋˻4yy,1oX'^/x^9)% /PkR]PCӈ.qM1eYpZβ6J֥(*SIaW_ߖQ*'`9JBDfRY!?}[66Ԕ:-T(+]C8xma7݌K6a٤L7,CO8~' I}iw|ɗj !4CjR}wl+E:N(<;e!g vJq)-cRkJa):4^=P%#H>S q*`3K%@Ebs. b!Oi/?1`{'YI)I*Kz&P ~{f13(ˣ΅{3đÇ?wX@uz=X,\ ƙXq~j#h;j,v_X"n@S_ihB@xˏυm?ש^$8R5 \zB%dv/KuRv܋xkJfRMy_I2<  i[D :R sjY!XÙ ko>,]^H#}O:P˨no~z~8c [7>TS0dg 8/n AG[5.;z^zՙ,@7Vm;xe/TqK'>N.q@hC7 ۮ$CI 4'J1 ;{f;_^1g*㳻f6,s @W|~5;{tD$Y)Ts}.QqZB"ִ(% cu>n̚5dF)W=X0ewTkPWſ [O`8qƭ޼9!^݋f¿j><͂kND$ f$ =b&Ҩæ? IX9_kA/.1U$z ycxMP ~o>qfohe@l:_/Xhf{x|##? |׎rn s0}ĜnDIMZbQ?nA{`SGc} #fw0nʛ!UĜ pN<"\f)m}fn70`f"},~Ua\!w&@`Yf?v"25 ǃp"@ږG̹sA{@~6o1|vX>ӟ^/29~5O` >Z|"eGw2['<,oYG!bݺuqHdoO%_`0D"a#%yW#?Sz8V ָ٢aٗ;J[u߹wͿXڪ/^\?2(xmg糖`#,A[Z ~wuegK }1OO*rBEǙ ;rㄕr<CWS1|LR.(ʒ5DZCq<=owH?7^~_8̭ v;q}jɳڏ<(tM%>TRM? 3s XOfPMDp}\D"a[P*) 돍+A%+: xw|37QZj^/~&k\q7G0"n>fN?
    ZIx* &߬_|lzol|~Yg?m b9*V^ 8E} V'bvΡ)$mw?t^cBRONEnt%}b /|Z#-`ӲK¼MH08 ^-g{$ M矺qPdD݉!F3 8x2 ]z-V_jDxygu/gwٕyb .O_1LHiw4w|+n9W ik,ǟk*:3u>sP *x!,UQHDÈv"MȇaV@*`& ;k)ږ(sL/{Coq`,fdxf-^Y{[I̭s>EW ?D=+i*ӄ?ģ}@ȿ'OkzG: BXѱfYm>׃Ԃˊϋ e33TTr<խ$\b\@eؿk!l·v?+_⹃n +{h/,;SJ)ފ`4'FXW$u+NT6jm! 5vc];AJiD=BmkPӌoC#攫׿0 n46*o׮X ZIA3_);wolWR+^rE0)R9J)$F/5މ B S}-lAԮ=۟s,e@8BM3ǃj*' 7C.*`DQ5X W0C~wދ7>sOPLkG[ً?x^~?tYW~'?;ƠNK|ҩ?Q!?;L]>>޷oU\^1]T[.xTzV[n] bw5V}VWk: CNaF`CNG}fWM#~|!x!t̛OuM%z󷥛Uݕ-5g'zf/غ /PC Œuz*%K]<|F)PS1NȄޭJ J\5:)+!6,ylCNb͟ٹV>.uywFL=[ }dۯ_/) #G^~k,q2 Pz?0n6W1E`p X`/+BM3Sq$bG`2O: T*'IH4(S? (:yg޷Xw6g$#h /4ܳq2IDATmrpUQxN8闏)iμN' ,xϤ/9* $Ǚ>˛l`7__Fpu"ˁEh0\uZyC;!ֵua0@iЛaaxEjG/'@3*=xLu1Ԑ9jC$t>AUG* 35M+(Zqo~Hx:1sK~^> >{1ADFY{#}gzi26`@灭֝7#:R=ᙑssH(=Ղun~&X°`8 p BKV6ER PX .%ji@="aSJ^uMU_9@ {[>׀~vb rsy]p4"о8AoۖQD"G $% ^l:R D=܃X!_/J\$W)1nx3tmB>^poXk'.O*Ww ѵwk߆2 G@a7d=`8oZ~ڌ`!j:an' M n./CCA˽ZQY`bmWQU0 P ./ĺ_lU[F}19Io߶-+X"S+pBݷ۷mCۺ g0#TG_wcHo1|Lf)SY4B>PN X<@BՔ0}@U9mT y ` $Ӯ҇@ ae]^0o6t33 zj4CX'V.a`Pc,e?G HO*7mwoDD`{n3]sP.G8qL+>-},K`=عsN?}H$9@>~z{ #;`)wX>?P:g;r b3gt'[Ŕ*땷JRABvaÜwy5No`=s8_ x-8_ -*/z@X L:"0z{(ezrvMf`]>p,w!y,!Ԅ,kD_H=ᄝSM2`-Ք/tx6Pc3ZJ_|7d3jc+8onR[,K tu/SO> Ҍ'^/sP92@y9@y@u ˒t߿r&ǔ+T&F3J)FhYiO5g̥.'Y',=iNF]20r`lg…HW' ‰mX"Bޕq P8z"LaNd*j9 /L6QI0-EZ3q l B5.8XVPN-[fezҳYhR#'1"ԅPU^@ ̞=@ yG0xF+OT5P/un/G|?' n=@(5 ߑ#:3c ;%:5 ctȿ y9x^`P ÂPv1sr-Ftjr` y.ûyE Զ@ׂPzY灭_a'7^qOǃ3@GAKj藙xg&\|ܷ&Xß S=B3{Hoۆg_z˲`,(s>:ك}ol%wq% ?^Lyko&ӲFuW!:;%[isX &]{*{֜9hji˼NiIؾWOF`hjvCNe,>5:-F j* 9irR }!QP# ru_r<"\|1Z[[QSS2)ÉHql1|9A)<ŅCf埊,?' ((8_d}VZn ̍`9z-جbHF{BKFlk)R@-h(4nTГb,92CPLbསϺ`.1PJ|aSćz/qF|Iqyg3>O86W/X+뮼!|%#/W<j`܈ 2˪qR-; -6æ}1E@  @bf,JIU[0:6 `8$][(%a@KYc5Sa?Q3f >?t>QWWK`cyEsN1`4* GRUtXqe*2G]%PȼCKFa)3U*̺+$i7Լ_\Ƭ' 29 fBl{ E_iwv_{}kעt/ȇCOMkPx\qpL3yO~;;Y((#އRԃ1GjX{nRk["#Mͣ%^CBR *&٬UL)v3-]Hgr~$!4 `7gúf6ir<37ݩn?Kym2#}Bnu~w5zx)Ê_LI #vQjPel߶ <x[x+uKФe!z,G3G"ch%+ioXHj(M2.]TWZAw0i; 0-Uh(V44*jX1uQކ%#+X ‰`8)iXPs7i/Pާ ݃Da4qƑã=9]5>,hEa>ՏOG2G~KC)Eoލv]{srXle+Pt\ pOpI5٠ C@59J٥zsJ&φc P6:*^zAt2Yǡ_DxIS U HY@[q߀jXyǒesLT;>Ï'J5`AS%]jI${yxf-UD@pW1݉ށ4[4uZ  VoLd Q3cn U Xi8blW ?**w宄,#/Wb f -TRٟs"{‰z|v:aVU~E__4<0 }V>̍'&G+; Ǎf~n,XF(~ NSkpm j*&CSR@8J k0xQLQm%pDW6BH~S6nM 05[~5{ Cao.=hs[n #1EpM7 ҆QNSEi%4$0}|K ~6 \j= ͺ>՗ lFY_9 <'GgC=HA2/mzkWJޗ,P]5}<׀qʾw<pD_0 kxM>bʯ}aD0B^Vh"]6+7>F55e w_A $a TVcQu0++@y_"26 \W;4m<8` %p准^y/0 7sd3  CJ@ (Rґ5`|2H NWCt9Gs,fPUx0n1 Tt37^gKy{: NCR D~";oS68;ت:9~o_i+XºN BjLflC8ٜgD3EDlFb2t&35aH#8y]Ko{{_)|>{~ϹtOy{ؤ$wꭁ#nbIB3r |ɨΤzox>"xO6sj V?o>m\ D_4Y~{`L rtQIwLJf$سY H+5, ISWmW}s˟Gұ1%e=E%Ix`z&O&G_T&BO*oX1BnDv3x]$ܥ t_YM\8( U(']em-'9|PDίCjDr"J˝wK/u<1QоuS/$PUC3sPN f8 (ů~trCDI]-JRĿ_Ԁ%͋@3fJBnTz ̤>3' 5\'<ݥBpPk;o"oP&Mz{ $4nTDWH~E*x_f>9{PoHO4u79pP"S?~;kK[fJ6˂2`n $tUU n4梜XoGf) 1!rv-L}tGӤm˞dX|}69GL$)A\Pn M7h)"+eF(%))_(>Aׂ \HԵH'<3s@XXo d',1蜌 hd9h+AfS#3iCb lȌpXݱ&MqVV{?u~.\%@[s‰$Ihj :3&f QBn6'n狶~$iw hY{#N@iߺCW첁\eAN|aӳ bHDʘ~;)Th_`D?Xj yb=t.peDپ>":=I?0SL D j.ܷ *.ǐ9SN_*H]-?\0n/6x+2ڷz =l';<AUť SRz<4g}LV?5t.1Մj D hj #) iz+D#8?;Xso'ل#YL)2#h̍YREWWomo,hjj(934ӉaRӐ4 vXDC0YZ7jqk=V*Mw^[p1t]SMc ?p0GiݼEWJȡ6H񭵪6?܃ۉpclڻI)Y$w}.bm羰iqrň.~}춯˗n뺙uQ^rdL%n_߫s-u ]qR҇+1ȮIENDB` h  00 % X4VS_VERSION_INFO?StringFileInfo080904b0,CompanyNameamphpVFileDescriptionExecutes a command and passes the stdio streams of the created process to TCP sockets0FileVersion1.0.0.0: InternalNameProcessW.exeVLegalCopyrightCopyright (C) amphp 2017B OriginalFilenameProcessW.exe@ProductNameProcess Wrapper4ProductVersion0.0.0.0DVarFileInfo$Translation  @(0`hPȥХبp@PXhpMZ@ !L!This program cannot be run in DOS mode. $ύύύÍӋ͍Ӊ͍ӏݍӎrAʍύ󔍊eӂ̍eu΍ύ΍eӈ΍RichύPELh%s\ ( 1-@@@TYp@PUpU@@p.text&( `.rdata!@",@@.datapN@.gfids P@@.rsrcR@@.reloc@p0@BU8p@3ʼnEVWEEPh~fv@@t"P6hC@ 3_^M3]Ã=s@t8fE̡s@s@PEE@@fE΍E-fEs@Es@P@@fEEjjjjWPv@@t!6hC@3_^M3]@@=3't"6hC@P, 3_^M3]ËM_3^]Up@3ʼnEES] VuWjjjEE}PSVQE@@u+Wuh0D@@@P3_^[M3I]3ӍNW(fnQI@fnAfnIfnYfbfnAfbfnQfbfnIffnYfbfbfbf;rf(fsf(fsff~M333;s,+ȃrK|;rM;s ƍȋE;t(QPuuhpD@*3_^[M3K]ËM_^3[5]U$p@3ʼnESVWEEPh~fs@@t#P3hD@ 3_^[M3]Ë;5s@E=s@0@@MMȈEEEhTE@EEMKjPEu} tM_^C3[K]U$p@3ʼnEs@SVEWPE@@EEjjPEPjEPw@@u57hhE@@@P) u@@3_^[M3]ËEs/uP7hE@ou@@3_^[M3]Ë] tP7hhF@6닊KtF} S@(G@PP7hHG@u@@3_^[M3]ÍMfEMMEE;tQP7hE@]S5s@ s@r@;ustA:u't6B:Aut)B:Au tB:At7hG@A]EGES@@EOh ]Up@3ʼnEUEUEEEEVu VEEUIjPE&M 3^ ]Up@3ʼnESVW33EP4 @@E=u DGu~F|ͅtIjjEPW@@uhHQ@$@@P = @@3EP4ׅt"}u1F|_^[M3 ]VhP@$@@PH M3_^3[ ]Up@3ĉ$=s@Vu Wujj@@s@tPL@@ht@h@@tPhQ@LUV@txto$dt_=,@@$jjPh@jjjxD$4jPG L$0Gt"jV@@u0hQ@$@@PD_^$3 ]Í$PV @@u0hR@$@@P_^$3 ]Ã$uL$0_t$hhR@t$T1e$jD$j@D$D$M_^3[\]UEMH]UVW-uf9Gufu _^]Ã} tE0IWVhs@@Ѓ _^]Ã-f9GuGh@T@P@@6΅utV;YtWjW6_P9>tVYt6 Y P76U 1uV u jjmYYE=MEQP! YYËeuu@ }uS EEUjt@@ux@@h p@@Pl@@]U$j= tjY)`q@ \q@Xq@Tq@5Pq@=Lq@fxq@f lq@fHq@fDq@f%@q@f-E@+PQiYYt'x$|!EE3Ɂ8ËeE2Ut}u 3s@]U=s@t} uuu YY]Up@3s@uȃu hs@YY#E]UuYH]Ueep@VWN@;t t Уp@fEP\@@E3EE`@@1E0@@1EEPd@@ME3M3M3;uO@u G ȉ p@щ p@_^]33@ø@hs@L@@ðhhj uj=øs@HHHH39 p@øs@øs@U$SVjtM)3hVP5s@ |xffftfpflfhEEDž@jPEVP{E E@EEX@@VXۍEEۉEt@@EPx@@u !s@^[]jT@@ȅu2øMZf9uA<8PEu f9HuۃxtvՃhF3@t@@UE8csmu%xu@= t=!t="t =@t3]$SV Y@ Y@;sW>t 8׃;r_^[SVY@Y@;sW>t ׃;r_^[%pA@hK4@d5D$l$l$+SVWp@1E3PeuEEEEdËMd Y__^[]QUuuu uh*@hp@]U%s@(S3C p@j $me3 p@3VWs@}S[wOW E؋MEineIE5ntel ȋEj5Genu XjYS[wOW uCE%?=t#=`t=pt=Pt=`t=pu=s@=s@=s@}EEEEE|2jX3S[]؉sKS EܩEEt =s@_^tm p@s@tUtN3ЉEUEM3Ƀu3u/p@s@E p@t s@p@3[]39p@%@@%@@%A@%4A@%@@%HA@%DA@%@A@%0A@%,A@% A@%LA@%dA@%8A@%A@%A@%A@%A@%@@%@@%hA@%A@%A@% A@%$A@%(A@%h@@QL$+#ȋ%;r Y$-%@@[[[[[[[ \ \4\D\R\b\x\\\\\\\]aaaanaRa>a*a a`a]v]]^]T]os F]<]]]]]^_&^_^Z_d_P__n^__B_```_^^4_]^^^_R^8^ ^]&__1@+@+@+@`p@p@SuccessSignal not expected at this timeInvalid stream identifierInvalid process identifierDuplicate stream identifierInvalid client security tokenInvalid server security tokenFailed to set socket #%d to non-blocking mode, failed with %dConnecting socket #%d unexpectedly succeededConnecting socket #%d failedFailed to send %s to socket #%dFailed to send %s to socket #%d: sent %d of %d bytesFailed to set socket #%d to blocking mode, failed with %dhandshakeFailed to read handshake data from socket #%dFailed to read handshake data from socket #%d: received %d of expected %d bytesHandshake failed for socket #%d: Unexpected signal code %d from server, expecting HANDSHAKE_ACKUnknown errorHandshake failed for socket #%d: Server rejected connection: %d: %sHandshake failed for socket #%d: Invalid server tokenhandshake ackFailed to connect socket #%d: Unknown errorFailed to connect socket #%dFailed to create socket #%dselect() operation failedselect() unexpectedly returned zero socketsFailed to create pipe for process I/O stream #%dFailed to set handle information for process I/O stream #%dFailed to create child processFailed to read from child process pipe #%ddataFailed to read from socket #%dFailed to send data to child process pipe #%dFailed to send data to child process pipe #%d: sent %d of %d bytesFailed to read tokens from stdinFailed to read tokens from stdin: received %d of expected %d bytesFailed to read token-command separator from stdinFailed to read token-command separator from stdin: received %d of expected 1 byteFailed to read token-command separator from stdin: expected 0, got %dFailed to read command from stdinFailed to read command from stdin: command too longFailed to read command from stdin: missing null terminatorFailed to read command from stdin: invalid UTF-8 stringFailed to read command from stdin: failed to decode UTF-8 stringRetrieving copy thread #%d exit code failedWait operation on copy threads failedWSAStartup failed: %dWait operation on connect thread failedRetrieving connect thread exit code failedPIDWait operation on child process failedRetrieving process exit code failedexit codeA@A@A@0B@hB@B@B@addressporttoken-sizecwdError parsing server addressInvalid server addressInvalid server port: %dInvalid token size: %d=Unknown option: %sOption %s requires a valueProcess label not suppliedServer port not supplied127.0.0.1%d: %s%s: %d: %s%s h%s\f$V$Bh%s\ VBh%s\ hVBh%s\\p@ V@pA@K4RSDS0=|@EC:\Users\Dave\source\repos\windows-process-wrapper\Release\ProcessWrapper.pdb""GCTL&.text$mn@p.idata$5pA.00cfgtA.CRT$XCAxA.CRT$XCAA|A.CRT$XCZA.CRT$XIAA.CRT$XIAAA.CRT$XIACA.CRT$XIZA.CRT$XPAA.CRT$XPZA.CRT$XTAA.CRT$XTZA.rdata V.rdata$sxdata$V.rdata$zzzdbgY.rtc$IAA Y.rtc$IZZY.rtc$TAAY.rtc$TZZY<.xdata$xTY.idata$2Z.idata$3Zp.idata$4[^.idata$6p`.data`p8.bss .gfids$y.rsrc$01.rsrc$02,@-@ 0@0@Z.]@Zj]@Z]@Z*`@ZJ`@[l`Ap[`TA[`@ [`@[[[[[[[ \ \4\D\R\b\x\\\\\\\]aaaanaRa>a*a a`a]v]]^]T]os F]<]]]]]^_&^_^Z_d_P__n^__B_```_^^4_]^^^_R^8^ ^]&__PReadFileSetHandleInformationGetStdHandleWriteFileWaitForMultipleObjectsCreatePipeWaitForSingleObjectMultiByteToWideChar-GetExitCodeThreadPGetLastErrorCloseHandleCreateThread GetCurrentProcessIdCreateProcessW,GetExitCodeProcessFormatMessageWTInterlockedFlushSListWideCharToMultiByteWInterlockedPushEntrySListKInitializeSListHeadVInterlockedPopEntrySListKERNEL32.dllHWSARecv WSAConnectMWSASend InetPtonWWS2_32.dllPwcsstrHmemset5_except_handler4_commonVCRUNTIME140.dllfreemallocnwcstol#_errno_aligned_free__stdio_common_vswprintf_s__acrt_iob_funcrealloc_aligned_malloc__stdio_common_vfprintf__stdio_common_vswprintfB_seh_filter_exeD_set_app_type.__setusermatherr_configure_wide_argv7_initialize_wide_environment+_get_initial_wide_environment8_initterm9_initterm_eXexit%_exitT_set_fmode__p___argc__p___wargv_cexit_c_exit?_register_thread_local_exe_atexit_callback_configthreadlocale_set_new_mode__p__commode6_initialize_onexit_table>_register_onexit_function_crt_atexit_controlfp_sjterminateapi-ms-win-crt-heap-l1-1-0.dllapi-ms-win-crt-convert-l1-1-0.dllapi-ms-win-crt-runtime-l1-1-0.dllapi-ms-win-crt-stdio-l1-1-0.dllapi-ms-win-crt-math-l1-1-0.dllapi-ms-win-crt-locale-l1-1-0.dllUnhandledExceptionFilterCSetUnhandledExceptionFilter GetCurrentProcessaTerminateProcessmIsProcessorFeaturePresent-QueryPerformanceCounterGetCurrentThreadIdGetSystemTimeAsFileTimegIsDebuggerPresentgGetModuleHandleWFmemcpyDN@8S@#@HS@$@TS@ %@lS@%@ Es4 0`xe 8 P ` p    h(Ц%xg>gX(k}(  :|6 EcșO͝Qҥ^թcˣcҦ_G۝5מCk7*NH%K/G=xÐ?4{/9ϚHשaӬo[>Q<n:s<V-Y9Gbl3\!_CR:dgIo(澏Dxs۵xӞKդWe/n9Βo?sIoHV4;wCqV'_u_<\F%loĴժeໂԮr]yIL`yޢ{a_:ف`>£qxoa9ʯר]ݴtۼլlFj`waKD}>jHVطYPAMp֩bݳrÐὄxRl~d\myL]Idv;%ØU}Ƞ]Ÿgx9UhKIKӦ_ڰn⿉պǩ{ܼҳ{WbVM<ц`%Ző?ب[mAg@޾ͥαŒŽkիh͞U7e$[Aۛn'ЛIק[mAg@޿ͥƧvݳrڰl٬cΛJ9j&[AhJ}/ЙDӟM٬eڰmֻؽtڰnתb͝O3r(Z S;\!1Ε<ӠOڮiܳqƕᾆpIӯvƒ@0-f%nNV=i%‹2ΘA֧\تbݶwŒڰlC?2Ʃ{ϣ]1n'c$lMfI|/ΘCӡPդW۱nᾇܳr|cnbٹͥgw6c$hJjK=բP֧[ٮiݷz۳r|̒9 ќI, ňԭq⿈ܹǢgT]ױuժg֪g׬gѠS9Ȍ1٬eӣV~IŠÌἂh@ oMQ( @ Q \]:eÕKɜT뾕Tŝ_ӨcУ]˜RBii ftn#e8aH—Sզ[ԣTҠQש`٭gگl۲qЩleӣWɑ77o~[[9{9zɚOМIʓ=ǐ7Ë3Č3͖?КDҝHԠOתbݷzໃ۲rԡQٚ6ƏA%m9H&29'|5tB˕@1y+t)m'm'{,2ǐ9ϙCԢQ֥Xۯiֲylu<ó26\ajÂl8p<p;DN)%l%0<Ŏ7},k&oOT<G3G2Z@xUr(Ì5ЛGԢQInxjrٰoϗ>Bzƈ(p=n:n:6k9@"w$U<b'[nOQ:( w"OV=ǘl&Ō3=e㽄Ɩ۱n̓86ќGĊ-n:n:n:m9\0X-X.Y0M+{6O( ":+ dK#JlQ&hnZ<> 'S;d#nvէ^ۯl὆ƕتa͐/͔8n;n<n:Ήm9n9uCQYYQsB`3B#}(jQ)_yZ(P:}]spkI-RF4\ګbتbܲq߾DvӅW8 m9m87n:}Otydo?D#?3!MIğelcV* ǿL٫cتbثd}ؼqΛJ0̛MPsAϗe~ƘuȪsqXxY[z_^T,/'u/⽃׼_(()'=ة`٬fگj޶xǖ͡ثbj}O(kݣhK:s%x+3Fɔ?v&vT$`CE[==^(ʙL޿zr655C=ڬcܲpܲpܳrϦߺϘA*m~^ቢᯣБrJ9gd@bɜV̚K907ѡT۷˯E <0n2ة`ܲqܲpܲo~˝ǖգSl  s)bL+g|@Kŝ\ͤcԪh֯rЮyȧswAv-"!+fIq>]Oo1ТYܲpܲpܲo޶wƔɟɟ\zb=UƊpFt\7yZF%R6( / гoq,M5[OXEo;%`H"z9{n+ 4rQ}+̖@ԟLēEԣWݱlܱmݴr޶wǕҿfbŒ࿌ط̫ylxRE7!)eϗ?ϗ?ԡQ۰lܲpܲpܲo༂ΤșգSkI9*ê߷y٭f٭h֩a˙K5/|,x+h%\!xVF1V>vTk&/Ɏ2˒7ϖ>њEק\ثdڮi۱nݴsĐӬ߹~ϗ@'i‘جfΞQÎ:000/m'\!]!iKB/_D\ p(0Ȏ2Ȏ2͖?֦Zتbتbتb٫d޷z˟ͣש_=kCnX67϶دn2/000{,e$_"\!Z@C/dHa"v*0ȏ4̕>ҟNק]تbتbتaڭhὅ̡޷yКE+ҞL' b“ΠV100~-h%d$d$]!Y@L6mNi%1Ɛ9МHԢQԢRԣTר^تb٬f߹~ș༃ћHhЛ̗CpW.[C{ŕϠV3-j&d$d$d$yVbE]B[ |,˔>њCӞKԢRԢRԢRգT٬eߺǗӡQƇ# ̒7Ǣfl>6ҶȘӧb{4c$c#d$b#mMcF_CkLm(ɔ?њCҜFԡQԢRգTש_޶yǗངԡRʍ-͓9+NBݾɚԭpHq/f&[ cFaDaD`Df.ӤXգSӟM֦Z٬fܴtແ޹حhќJgLj& ː3mIΠV6༃ɛխm˜U~>i1g0p6FϡX߹}۴vخl۴v޸}۴u֩bΚGƊ,)V}p ݲmМI۲qđ˞Ɣ}ܳr۱oݴs~Ï͟W‘DƕH͙F{ɑ9O…%er ̒6ń"ԤV9ܴtŔșʜʝɛῈٮifɍ.КFʋ(~ЛF$֧[Wٮh۱nڰmتb`ѝK"nŅ#?  ?(0` $?,ʍ+t$|,e7A“HD߯L͞TʚNǕFÏ=2n(6" XduEq%'o,tu<˟Yԩd׬g٭fϥbӭp޷zݷzܶzڳuլkϢZ~q)hAƓC˔<3-v*r)p(j&h%j&u)},/‹4ɒ:ќGԢRԢQԣSר^ݳpկuv{Te,0_;ʑ6m9l8o:tF% )R9k$':ΚGŌ2.z,o(`"oN\BM7G2K5_CvTh%x+/ʒ9ѝJԢRբRӡQD{mWxtp`VG{֫eΕ;rƊ,ɏ4n;o<n:rh72\Ċ0|X54~,s)g%vSI3& f9*1 Q& F2rQr)0ɐ5ЛGПOl;{so˪wƔ̟٭g͔:rȎ2˓:m9{En:^o;]1 ,% 5L6΀[wUjLcGX?5& ` )* eHp(0ȏ4f4S޴r༄Ē˟תa̒7_ȏ7q?m:n:Zp}Oo;V-!?shB[V̧kFDAAlhaIIIxM֦Yتbتbتbتa۰nἄ‘xzIЛG$ȖHm9m:m9͐n;X~{ytmly^p:*@޵u̦§}g.% zzyu=ՠMتbتbتbتc٭g༂ēѭӟN˔;ўLm9l7(r@k~~~˞{܊ikɲW>m/vU+W@?nUswIO'/aE߼6ܲpҬȨu4w9ҚAר_٫dڭh۰mܱo޷zđ̠ԮتbКE(ҞM[xHsl~pW^Ijv)[KΛJÌ5y*^X?L5JH-\@(:`C!u*ΛJᾇTXr**)$##Gy:Қ@ة`ܱoܲpܲpܲpܳq⿉ƕֲ༂ҝJrաNl;lۚw\!A:+0nl2ƜZԠNÌ5~-o'b _l$/˖Cܳrʠqc: E2sY1˘Hة^ܲpܲpܲpܲpܲo߹~ŒЧ͡գUϙD b~~.}N~t~~ῢܙxL;k oP p&Eʠ]ңXΙEŏ9Œ7Í7˕?ԢS߷yܾxƱ@4X% VA1eM's6ئXܲoܲpܲpܲpܲpݵuÏʜֲ٭gКF6ytz }9kSO  x.p$r;|ƞaիjիhڮgٮj߸{ٷѴŢkh.&iq*+ uTy`7uTc~R|7a+ԢS۰mܲpܲpܲpܲpܲq⿉Ɩ״~МHn# Q8*d?"q"g5@H^Ψmܻiɦn˺^t=Du" t4Mm)- _"w)0̘EԟLƔDo2ҠPۯkܲqܲpܲpܲpܲoແƔ̧to3YbN.˺dZwJ|b:dN+K:}1$W5e95 h {)n#g JSA%(w=|3`"0" _"x*4ќIӟMҞL͚JӠOڮiܰmڰlݳrݴsݴtἃ˟˫T{eAĐǔőٷ˩teTh@ 7*C3g5(Z% D5   '' 5D3KhQ,rrAJ㾋;j&wUbC/̏e$y+‹5ѝKӟNӠNԠOգT֧]?|6S۶zϥٸگioKŒœœœƔƕǕȕt!WUE-z`]VP{c1v*]!qQx! TU=c#z,ō3ќGר]ר]ר]ڭe˯#-..ZULoV-ڵ{⾅ֲͣܳqyVǕœœœœœœœē]O;rN侂ແແἀ̨oPΛKƏ9Ċ1/v*`"sR1# mK5vSm'.ʑ6ӡPר^ר]ר]ڭe˯#-..ZULoV-ڵ{⾅ֲͣܳqxWǗœœœœœœŔǕgh{ݴsڮiר^բSȑ:É0Ê1.r)b#uTH4>,bE\ p(.Ȑ7ӠOգUեW֦Yק\۱plB# T<TເᾆΤִ۱oqRǘœŔœĒÏᾆ֯pӤYգSӠOӟMӟLӟM̖@0{,n'e$xV]C<+P9kLa#u*0˕?ӟMӟMӟMӟNӠOգTר^?|6S۶{⿉ΥٸگixeIĖ⾇ແ޷zܴt۱nگj٭h٭g٬eԢRӟLӟMӟMӟMҞLđ?u*k&g%{WkLB/J5_CtSg%z+1ϚEӟMӟMӟMӟMӟLգT۰mܰlڰlݳrݴsݴtὅ̭͢TdS8ػ۰l٭g٭f٭f٭g٭g٭g٭g٭g֥YӟMӟMӟM˗F7{-t)j&}Y sRT<9(S;lLZ l'-Í7ϗ@КDҝJӟMӟMӟMר]ܲpܲpܲpܲpܲpܲoὅʛάvn3YI:#nʱ޶v٭f٭g٭g٭g٭g٭g٭g٭gتaԠOΛI;}.y+y+x+d$uTlM@-C0X?vTb#s).̕=ϗ?ϗ?Ϙ@ћFҞKԠPڮhܲpܲpܲpܲpܲpܳqŽʝڹЛHn!6w٬f٭g٭g٭g٭g٭g٭gٮhثcȕF1y+y+y+y+k&]![!`D:)O8bFxUl'v*/̓9ϗ?ϗ?ϗ?ϗ?ϘAգUܱoܲpܲpܲpܲpܲp޶wǖΣض٭gћF5 yWɝگl٭g٭g٭g٭g٭h٬fѢXƑ?0{+y+y+y+o'^"\![!N7@.V>mN~Y p(|,ƍ2ȏ3̔:ϗ?ϗ?ϗ?КDק\٬f۰lܲpܲpܲpܲo༃ɚԮ͢ԣTΚG qcO1r׿ແ٭f٭g٭g٭gԦ]ɖF3/0.z+y+r(_"\!]!uT?-H3^CsRb#n'/Ɏ2Ȏ2ɏ3͕<ϗ?ИAդVتbتbتc٭g۱mܲpݴsđ˝ٹߺѝIlԠN3''(u͢ڰl٭g֩a̚L6/0000.u*a#\!\!]!eH:)N8eHxUg%p(0Ȏ2Ȏ2Ȏ2ɏ4Η?ԢTتbتbتbتbتbثdڮișѩӭר]ЛF!ҞM}eAʥᾇѡVÎ;0000000/j&]!\!\![ V=;*Q:iK~Z j&v*0ǎ2Ȏ2Ȏ2ʑ6ѝKة`تbتbتbتbتbتa٭hᾆȘٸ༂ҞK|RϜMK89( .uϥѣ[1000000/r)d$c#_"]!vTL7=+T<lM^!l&|,/ċ1ɐ4̖>ҟMԢRեXتaتbتbتbتbثd޸{̠șԣUЛGўLx_8}œ͜P100000v*d$d$d$d$b#oOO8?-U<mNa"o'/3Ȓ<ўKԢQԢRԢRԢR֦Zتbتbتbتbݵu⿉ǗΤ֧]̓:QЖ:͙H:*!ZЩᾇ̛O1000z+f%d$d$d$d$a#jK_CT;gI]!r(0˕>ϙBћFԡQԢRԢRԢRԢRԢS֧\تbتcܴtῈŔЧڰmΖ=ˑ7͕=l7]E;tӭ༃ϟT4/}-g%d$d$d$d$d$Z dGcFZ@hJb#y+5ЙCњCњCӟMԢRԢRԢRԢRԢRԢSש`ݶw⿈ƔϦܳsϘAʑ6͔; b3_ѳԮᾆԧ_;j&c#d$d$d$d$d$rQbFcF_D]BxVp(2ϘAњCњCҝIԢRԢRԢRԢQԢR֦[۱oᾇɚΣ۱nϘAΕ;Ζ>7(xArڻհԩfDl+c#c#d$d$`"hJcFcFcF_C_DjK9ӟMњDњBћDӠOԢRԣT֧[٭hܳt߹~œŔש`Ζ?ʑ7̓9_'_F(Iq޽ҬÏܳsˠ[Bo.e%c#zWbEbEbEbEaE_CtV'șNڭf֦ZԠOԠO֦Z٬f۰nݵwߺ׬hΙE̔:Pʐ6˒8s1wQϞP_޸zϦ˟ὄ۲pХ`O>d,sS"oP pQ!wW%f/B̜Pة_ໂܴtܳr޶xᾆ޺תe͙FǍ2xĉ*̎-/ΘB~ѝK<ٮiƖҫɛᾆ޶wگlҥ]˞VǚTǛTΠX֨^ڭdڭg߹}ʜԫj˞VϤ`Цdժfԥ\ϜKʓ;ŋ/bÇ)%'z#֣RΙCդW޷y˞ӭΤÐເ߷y޶v޶u޷xߺ~⿈đΣᾆΜL`'C,`-e-Yʼn+=Ç'#Ȍ)g ͕=ȍ2МH0֦Zݵvœ͢ϧϦΣͣϦѫӭɛ޷yԤVhʑ6ЛHΖ<ʐ5ЛF&ӡQjש`۲p߹~ῇແ۲q֧[ѝK2ʐ5ΗA= SɎ4ϘAќG;ҞLQҞLXўKPЛG7Ζ=Ą$Nj,00 ? <  0??PNG  IHDR\rfIDATx}w.mo;؄B $+I(]r wRH% 5 \$@(0lhUFhW[L|F3yyOdOcƖkFOTO矼C<chMݬP a ݠvA϶ksrCS t , 0p4xW)c10p!ԶgUA7VJeNgkt;gΩ08&< 8Y5dAӍ7 #w?{[|ajpLTK{CSgy|.ߢi=,,SU@_:U>pq9E!77#0g.UH(:T") I`BHRu( M5t0wG 1pL?5 ˜Z{p,.6PV,Efw"tX2uh@, \ʿ86?<[zJ3,T |)dG:IAgXٮX28qLKX@G5K9_F \ cpe6'+|:/v_ɱ)w?{[v=G%><':Ȧ4t ŨoE 8o/qe9F/+o ]CH(פ7UrV~N+D/3B:xl0~d^o 9]8O0+")1Y@BEXNH4Gʆ p;OkfϱWr%uv_nW41YϘN1 ى=<&`չ p z2~^5ԡWRK$UG_BCOTF_$ituFӜ+Br<|gD|W(|n/fJVb(fȪ="A̿WDξ \.x!P wb)l`N|%׸hv'|_ >Uՠ)8qd 3˲ . Q\/ V}00*^t$VbH" cRw֞_ ߎ/eWE` C‚4y栀4mٮx."GX]\Ex?*` yM9JuKO9/n Z֐IaJJ{VSzES |d#φiHu[ t%s׎NYd|_4;UB$ObkO 2<}wSQ /y|_f75@\-0`RO"CAuN|ġj=:QnI/7DDR>~r":;80ˇ%4RWP|xӷmhFGfGǪ6?TB 9&U(PݽcZA L Ey^E⑃|WcLpPYjPEBlVGcVl;2L gp`8t -nW>5Luq .]و @Dp(,gb R5N1u%ƃX `=V}jꚋop 0 i$ͬlKcł#ȳ9Ku ?Cud՗Km8xeد~)[ri7{rq hIPICwLt)f4P_Ϊ}cD 9 k7c>J(濥<<7BPjPt(7GωrJv/_~4ZVa?z}2<>vB3)I5ә0(FRZN?Yid[Zq}vAQ*dzx0nZ.[`-) 4:2w2&Rax} mZӒ{b *d?\׉o;wFs~^6aZLRL-Ԍ#[f5`ς%d12pjD<{`)~EIJpGK`)7o]?ij3C.|fxyAS2 ,AџP!?M7Ptղ;<-ϤCMMF]N=Xm#>:O-R%pq B.vܑCϾ)Ic ~h~ѐI86;A ,ҋ|MdͭukZ _)b29 aǡ#ݓ\/a%"Y0`(I{CX=`x xuZx,tG%t뇋crЂfPQIf.3Q $5p +Ky67,wHDB~.C|yK-/&Gr~˙M bPtH̵b/2b2S:B@)E*2܎;BRt|0`Ztb{CN> uy#`8<[_`lj (&|8:ڌ<`}P&'_ TX Do0G%5jbt NLC_&ֶ~f~àJ9K fPۏ`(9~10‹?P ?-9V=^_Ug ?% #,0cJձo((Qe7[̔cH{]SNIuS~k]l5-l[a> "4l`$NÂu'"kf$ _6MȂXFph*Lry"*70sCe QBAiTlx ,%!r kb0b$/!zy+w?m~6 kydey;AWV2nLV@lZu4 M)~Fp'P<8oX]+eW|Hd/o!80, ɳ-tzw~<7 )QF2r3>Š8&g oLeh:k< S 0&ou P_!s?༡{d 0C53ӧ9$ұd EjPt%D Cp6γ/R |{:(IWo,\2R|FƊ d&H}N(%?ԁa:} C~]{C7<~Uw}Q1YZ8͇ }m:(U|X \߃;wq]k#a MLrp5rPy⊁EPE)J mlV>S8QUUjD[%`e nɸ~o֜K<ү'+5W~͠=eCm6JS튛ٚvr THIVﰜwǐڨe&^Lx+T_`.k`~I5CK8fP7oa:Exo/Vrdh5\W*,B`)bс>k/$}d徉/cmǮτ.^/dH?!Ii+Rs2,+?s63|=]gQB=]V;ƿR(+R!gpMtxjyb7? kf]5KcS3o*Ң?``J!TW ,k Х$T Z" ->В1(d$ #=.%@U c S#cSZx 4_)G 3]y:s>t'UW˄o\_kœf@`zb ’U]5Ÿ 5:yД}>Pk05 R Z20yX}_glDXҜPۚ 0K,k5Mvݿ\3BE.EWFTp4 PWMDC_vU5p& AD2~KK CS R aHASJCzNL|"P]$+H&`/a$qh6߭@%`8- 8>2WqU+8x1`cG-~aIh3"Cdu2B%#Х %5EwEx)P;b)P?LAuucƊΑJRⶐ OP;CXS'l)&h=C pt~ ) G1%0% AT""^46Ko8,c'*'g^*خvO.>#x~hyc~+/Eft~ 04 &EyR܀Fdb$BH4@t8Pu#sT" Cp΢:B)wߴjUQF2MlU~A1cP_ ge+1@ڜz]x˝C9Tbᔆ# o^M)$Ra<3y˒g}jae,]쒫 z< ,޿|hL H[myU?nC MÊl5!UYNI@T0E$jQ>ލe-Qj>jMO33HcgQI;Gq Zd[`8~RRxQ!,_p"D2N1P+ jx]"Bm8)œ . 3!N[ !g~E֡[)qs*٨BJEY &ي`<d0NuN x jLz6kPUՈ nQ?yÚ{R3P C$'ޯ Twj5&ZF!Xϡp;_ {4:ppJ+p g4ypB[+ ]bs&֚"G0R3#ӖwJ"p<89 &SpT㍚S+L'᷐T|W2d!c|nǮ(µhX|8`MF!kǕIh8 6. Vbt.P aSM[(( $TIB+3!Cdz'ϵq sxMa+.<4ETI@BёRu\ J Tc kO9w⢔tBUpJ+ LERtG=cE 6cnc=)j9̍LnxR3X2궚 ص_y܀bdյnS_O6IS7)p_%4Z+%?v4/T:[/˹UVg9s)*TBRuD\@B5"m X0C'&F&Rh7U8ER%Ns< Ȃ*NF!:l„)9;H5߬2*Ij?`RSqܬ-p5a ~%SQ*M\R$bE܀H4ҤV {Y\pBKP ̙]L?(rf8-N?ItzԺjt|nRz[i%Nqs&pJ 8BISU ӚCr ArcuZp4mLoTҠ4EdV3ܮR1^P]`w5̘t/T8\_<@0YS.\$Rw4)".k9~)'Ԣ׷p0[{5WrN98yxfyvJY,oc:TW%!6Ll7g+5x@%(j sI?M79"Apd\8@3 rqEJͱv-t6u:P/[`]>X. k%@yTП5s"YS.Lj.CʭJG kzaA{ȅ o% {:ul3X6e U<8!X/Gy&z82tRNuC~weol?)]1+cM` (^< @ܓ7wD|k W)J1QJ 7PA'cWM7*񢘟Qpl$ ﱩda\R0T`'0b铲 ?0~X0LoeNV*Rg+"s,;Al-QFȝ ppiT׺̯sgrGRR  M+k'*2jJ&ߔL- f R <+`Xl[x,ˮoZzbޖH/ee磚rn@h.'eA2]V@5N|LNCI(,i*\4M`UTN\k*i^i[QIC\1ƄfMJO韏jEʹe:k%Nj2NP ? *XĊX~1Wc|n{k@`^QuHJB~dv U)*eMsdPeF*``(~r )߼` ؆ @1m_]37U71Y?*W;X@]`b w@m7)(4L WrV+ņO~ E? ZA  cox6/] X8ZWt$d0w̎Km' Z2)hS6%#9+<5jrE͓R lg#G0`-q˽mk21E4ӻiOc1k6|v>W22`hj[ S6\mjH/ (kjXS;0bCAVs5Xz3me HV|,z̞5kȀ%ƒH2a%YMlPMv&S*_ rHq[P" mu߹w)`j+h'*bdDL[RTm->\6%Ž AIiRV@ġ(<@< jU")QWN+?mb'/504j[ӁY!N‚CS!U c| i.N3ByXirr5L/Iժ`ufv̟P~@S Le[X 6PJ0z2ZvץDINq2 *gY: ,M? q8%;3Xh0T_]y='JDչ}י*$2YD DTWA8b9%CNږ 3;p[E-}+dJ^C? bmNr,إ3}jwSHSY3fM?ƋC)6#zʦfu'.Gs\r`QEFuͶ@>'N.0scUkRu}Z SR#˭GU(2uZTBL+dO [/8o/TѱR4$! 3J ?`F Ir6Ic`ө> U4Px!7ޗފDlǎF @4M>>S/͋w?Y*M+H`CEAOnQk`J?dad™PM? ܓ EwrsEޅp-^4ѽ6}oP]%ƙ`82 @ՠ߻=?mD,AɎ{[4hi[TA0fxVAs Yz2 +k EJ<0S:%,9='X^X"_{o _%?MvcRP>fE4x\xͧ&/Riŕv!42 .Gii*t@Z>uy3Vu()VXtE•t6~^r9c@ug|? f ;h߼!P4)Bt$}Z 1Yz`,Pu=RaQghZO?5 LM0+@Xb1'|&'._ˀg ~6<.n8*Y\~oC Ǜo BMš S/ٳWk:Pq8"!))ZVJُHaD$WbЦI#Hļ>gG5 iZ tc}jls9Jy_Vȇ$+!ʢڴQĔ|aCJNu^u`p^;9gRVC֕!oN4 X~k,J $nDLƤFO5yPcCf-Ȁ{ڗs':)DJjddM+z@X^zF,aX,1ρɺlPՠvcZL hIP%̱ n >3B.,l`iun **߿H́[9u" ǵ-}zi -1R2H%!'m1̜o"%Cէ-D9Y+ BntW㬒J"% eiER07Sd8+n% by<}|>foy9,51 КY 56p6@:% ewqcr#Nfxf,r܋(i=I#;KƆ33?s-ѡVG%uT²9VNx ;wƃ@}0e`=r=h:qNWrx@ H+"C5;w=469@qPJ. ,O'P1Ux]XŒF:h IWrCrXeUd BNn9K 0ѵ'VJ po /DTh0ǛI>u(n Ln,<:.#GPZ'qp1aVS~SQ]2- Hf[ˌYRu$U#3|"0ևܲrb]ky2s]wu-y/D;0"4)؍>sgND5ݰuW\6|^mK4lF eƋ/>U~䋶,Aea)ABYVxᅚfpβl(`8' j|VGA`ڌӴn܋,A`BF/>+{AXI~GO}`͸er  E3ƴ" %6voNji}50^’fVzm;|Tj۞q7f$N׵lH#@n)qBي/0AAГx_+?j"¡=rƪ}oi:`/ 3Z)&OxߟJw20 ș!ϘB5I.+oAH8lda(EBwTWͨ_ӂ!F}Yv;AT33 4cC7?7xj" `}<;^,Y.ie@ix!iŒ>~{hՎ[L!4xl*EX*y%!䶳?zRo^U)fԸY4GN)_- G-I(~ha*&yhf@JՏ@6xo(K!X.fոrFe,+'.A ΚCu|?ѵ}\FFm#Z\` ;x.w8ULCۼ.GPn];u\]S+25ҟbF"tb ]A>YŠT 95@O~$g޿kǸcNI:7VzQG5An2%VR !H=Њp|u|vSӣÕ0U94_ [۶Vtfedh^KIHw$®)vx'<A@d|7XфU0gL2jK-R,CZ[@awc}p]we>? _?Џ ;@7(]Ss^t^Y-f\0zpaz(yxoI 1^b8/Y8ĹJo!_F1a1[KYz 8n`sOS>鏧/VИ؁eHpP.߷}N oݟcTfbMG#ZcWV ]XdḖ/*]NA %&0]GwODSoWƂlgsͳ9VXa /V!hASZqFgjy]⌫q Gnկ rm/,:4puZӬk֘4x1jbmNNFFW1,`mGף_yL1%P,2Of¯= x~RZ7`{$4'TDed^lLw/33 NF1ʟct_KFQibzb $UI]n㘏ƩիWgUrFp?8ϩ412ND S}7^qW LU"O!<%E8pF/jv 8o"S7P0rdtgA]{ff!'s+}f!nLh>PR-xBxgr|WM#\ |EEoT"e%V} @@רn5**Ҭp!7Jvo/ `f5J\l(  ʬ矼Cf uZ%FM4IIPRCoL}s-qY5υP>ؘYjAϝ?ה;^`HB&GHX,S°@oJ:1 @J5SӄQOTF爄}C)3;I۽ql1]C5,J&#=ΰWW0T1Tt{vyug;w,g0ËYï?F-PPJ˱+HDHJGoL([m֝!§*+z j +69(-h5" %kQ]`v'Ղ矼CaFyK) lOT۽qKbP %Sh2**’fQ Hv 5{ZN|0{6k 4 $TUtG匲VCkЅiĬz_ѐ'6̈h纮gAﺦ3|@vry}UH^/5 ZWRxom}',٘tM:t[%2Pa3t?-7 \ccWKonch 1ztpfآ$ːdRTS'#FcHcϟt=+`y! k6ǵo5"3Y\ 1Lύ /lGg4b 矼Dמf@O3DlK ǃq ̏F)B>OK)qL1 p4+PL֠gcn F2ʕ6vȿ$"EB 73P`ddԾ'pMkϙ&_]3 M5Lr= wё!hH#kogq@GRq,1Y%kB]VfaU)p:l &i4Q=~?yG0}P%$p㩮az F'N褆6|bwY_K MA =V.Pљכ{_mQx-j_]3#*|"f,x/Z0♕rBNN+\W9599m L%]0A=KI)9%HH2|37syL)j*<*pҺ1uLib;N!,)k Xnja.S ew\֐Tty_@>;|~;t3I)<wJxPS]_ BV+3c{6a{6"8d]XAqwĶ0ճ7#̩4+mA3AGxoka8m`8dCwKGjCqw ~͉k$QW w琚'NZ9Q~Z9mr9G `fj$ULP'ƈd @2;-=vx7>\ _Sro#HNu-gUL+  ]EX~@&ݵmFۺ!GTxLA0`܇8 # 3#cKV+}j"aćj:2Euє@<{iId 1pcѼXxḇR=BTRaeTWV-f0)1IC"=#B_jo|HG]Hv 5O |D v@W_է3"H:u,WcC>j*ks\̍|M78x;e.Զ4d[uf~D᠅@pPq\cgrO`2睏[ =;#TfD_tbgCN&=60r`@g_6M4ݵg! p؁|_Ǝg\_fx\"SjV=vD < 7 oB 2@yPe./ E30wCM[|*VY/) #C9Kc'cG!ֹ9ND Rx=%|'_`̒^@m5 {t5',:(o-Ub(Nf~كǢї-nj}H9dc>T18M*VD Y3pF!B+igJ;)1*+¼ J}0N𮝣 S]6QGYm~~+`Ns S l2mLsBC 48(, \-bܝ]e7`f ݣ3&|Ml[ޢrT(V3Ej""|,{cհuhnAwT﯃BS>GaIP.7q20Q g=sGgq%D~C>$ Alb}Юra4VhSMdCo%˃Zo,w,SCۼ Qș`Yr;LV +%U,X݆'_C:>b\QM85t_~kőÝ6G"[Apf$#ÝؼV *1U;cdžRCN6ƹZtp0tWn~G/u|湂~0Z*f;tM> QU1uƂ^9էNϠM_{oq}^ HsHg>; ˿F m7aTce]`kA ԕ?9𜷆 mup5 -BrmqDԇJC/$Ƀ۰/hU7>V4zy] <|9C~]P]()})Ը@ws|/6+6CX?4T[2 V_bzOǡ-Et"鎴߯ܲ^ZDܬ`8n!D^o +]?t;6=NxhKj-04*:xŽߏMꏏ OAS.<' 8ƍ_w=UbX.6F8tiq3>=ܮZF>:b̬ڜ%.<jN'?5ͳ8~^׆Oߺz|n>!tElc{ǗRg[~Xu?G䲽-I)HiqE%g!r,>\{On>nٲ{)]\t?jn(_c?/]{碩NOid-(V+`ga<]5q҂h’Cuա;*t+3<39xx+ϺN6[|88U xW?/ٻn ~GUZ2 eP70 9C5W!!x|>x8bѱiP4*Y ݻN8P:>w\+?YUXނK~e )ɼ\5-a37_1Ț1ήug;#|W>X'ﱺMA5P]iVTW?A?P2+7+Ph5Z֞UT!X}/4`;8Z?.j-S}cMş5_׶+/7SkW~!a_nj'kCᷱrfpHSZ2MXӍ3xdLA!^"K rV1HŁa ^E(%[1~ E}_S =-x&xlϫxD3ڊ:Ү?TӀI cNڻ~Yt,Ï.&s?x E5Z M1UH MJ,#p$Rhc ͋X8ϥ 1[⅑p ']{ xg,i7ns_o ݃S/Khzj I3LW *A*3g؜ !8 ,x@fnozxla|@@ԀL_D~op wiXv-<¦ n4UI&{ǖ-[p}ᑇ&;-$Y7@ P]5i^q8@}]d=_?a&߼ CΦ ǁVar}EotO|={8~fqf.u̞3k`3A3mo!"άfG~a$Z Y cPD$ <ą}r >u3`Qמ"n}I큟~fq?|vs3E4)#}`E/ OTW}glw z_ Kŋxb|cu݀o}F 1ZT)i8 5ˋo(%F<۔(b滭;S*]?K `bLx`V04 %Ԃf A3O)55W=xpeB+`S:S:.A@U$ m!x b| 9gl_VZ銫{oAkZ[ 7ov$C(";͉ѮF;C/?8RH$(xG# 9g?+/sDFpCJjۋ*)(SLM7@JEGgpqh 毛VV$b` 5.nGN> {p+Ko|Ȏ޸nbnbF;VܤtIcВQJ 7̉ѳN`I)(spP@x ?yhBn~f1[˗fN*bX5j>@BS%$aꀛRMBuD5|ڄG{r F20jBAXc0w_XÄ9׭u;l!FJL IVF0CF{XpeE4f"1{[7?[y`?ܞn+F:Rit(QL-kYmMJdYCVX͟<0 JJsEQ~iZ[WUBw9*ᅟ/; TS.T|K/^_v h5F?/?XvU'TtqpI#hB%?m2nu_oѵw0;?h菚'HPŶVAC*0GO7yr# b0 Ca!7,E2@UݼfMt0.x3? kA)|t {m(7mrMܑ=wOy.]8ft|Tjx?e4MH&Tr Z" ´R@2BGK]U/m5t 8o>]w<Vmsߌ:u$TSFMW 743UPe`3 /0,ÀIq"H tzC`838 MAcUW0 .:%*2c clMZ̎j$ \̈́+g(<)jp9Rg6駾J:nı콩]fh}:(MUqXWm8d}?fj2X2IEǡ FoH<&l?j*wjX=XRui㍉B@t~] jȡC)u 'S'!nSc@eC왩ghX7mhmGSrmf^p8I-Yd C#YCF] qp;55 ^,6 5ɫ>= zDj"+[ˠKq N]NAA1{JHAuM#[?0^$U)E[`1Z뱷{7eW$#@$>CVAf)j>)]oCٸC&?Au??ɷMKp3g1nC7|f2 D"S)g*Tt,K&m/f`gAX~u/vBd>k뷘4aƟu+ﻱP%Ux{}~fqXҡ/fUY 52‰k0QLS9¯'cУ#tEJόSG@b8AV2˚e܇G̦܃µ-ߘ^8J`$s\gaSZe4yx,!< xx7<1N7?]: @4V&*:b´CR&|k /w\GǠm4)u!!4|tc20 S0kt?o?6oP- W8YFQ\jRM6_CvP}d pe~>ړdK=gfzg ZAV<R/x[0K }9H%RX8FMkF5(Y!yཋ~aN8q)g9"Ҵ"ZT4bYi8857 S*R~:R_=}`{G|#Mȍ*B,~'#7m8*it9r|~l^eN5CJ yp+⻷ oo_-̟3q<AͼVLP*]{0M 0rVpjxVǡk3R:x;d]SRUj$gH;U7ATҠh:9;EȡJ_:9#̍S*nr?_Gý7\²wRe@8af|'讗pO?H>t,3o1A @KFAUJ>D|,3`^*n Rg?ܼSd+W>} ڃ7.%`(1CIf|Ρ,O*|t,2t`s7ż{lR*MVdN iuT cjlQB 9'hkI=w)Rt a~oB΄oB e˔ ˓/aY\r'vSGzm芁зs/n={ՀjKq\nPo \riV=90oA~Oߦi~boMEG] gx<ڷ _ʻ-p-䚖B ԁcMOҌL\B5Ldzd?zGbܾt`J8}6\EJ M+EIj=c&j㖏a@aF؎b=׽{RI݊Y(ڮ<ynǔ'li5jb1\r-WƮ#lFeOݦYə;=_Hk*}P%"Тj"f"l^~pPP ʻPL d'm]?yj r@7Gx2)\=& @320`Z4#1={3 %xQk\CNR<_I4 >^Ҏ۝zբBP/z3V-=W59Ν k{^oqkj*4l\A3NK ZhCk8/i73nj4kVp PmLEOQ*UۅpFw`&egPq%|+::؋˻4yy,1oX'^/x^9)% /PkR]PCӈ.qM1eYpZβ6J֥(*SIaW_ߖQ*'`9JBDfRY!?}[66Ԕ:-T(+]C8xma7݌K6a٤L7,CO8~' I}iw|ɗj !4CjR}wl+E:N(<;e!g vJq)-cRkJa):4^=P%#H>S q*`3K%@Ebs. b!Oi/?1`{'YI)I*Kz&P ~{f13(ˣ΅{3đÇ?wX@uz=X,\ ƙXq~j#h;j,v_X"n@S_ihB@xˏυm?ש^$8R5 \zB%dv/KuRv܋xkJfRMy_I2<  i[D :R sjY!XÙ ko>,]^H#}O:P˨no~z~8c [7>TS0dg 8/n AG[5.;z^zՙ,@7Vm;xe/TqK'>N.q@hC7 ۮ$CI 4'J1 ;{f;_^1g*㳻f6,s @W|~5;{tD$Y)Ts}.QqZB"ִ(% cu>n̚5dF)W=X0ewTkPWſ [O`8qƭ޼9!^݋f¿j><͂kND$ f$ =b&Ҩæ? IX9_kA/.1U$z ycxMP ~o>qfohe@l:_/Xhf{x|##? |׎rn s0}ĜnDIMZbQ?nA{`SGc} #fw0nʛ!UĜ pN<"\f)m}fn70`f"},~Ua\!w&@`Yf?v"25 ǃp"@ږG̹sA{@~6o1|vX>ӟ^/29~5O` >Z|"eGw2['<,oYG!bݺuqHdoO%_`0D"a#%yW#?Sz8V ָ٢aٗ;J[u߹wͿXڪ/^\?2(xmg糖`#,A[Z ~wuegK }1OO*rBEǙ ;rㄕr<CWS1|LR.(ʒ5DZCq<=owH?7^~_8̭ v;q}jɳڏ<(tM%>TRM? 3s XOfPMDp}\D"a[P*) 돍+A%+: xw|37QZj^/~&k\q7G0"n>fN?
      ZIx* &߬_|lzol|~Yg?m b9*V^ 8E} V'bvΡ)$mw?t^cBRONEnt%}b /|Z#-`ӲK¼MH08 ^-g{$ M矺qPdD݉!F3 8x2 ]z-V_jDxygu/gwٕyb .O_1LHiw4w|+n9W ik,ǟk*:3u>sP *x!,UQHDÈv"MȇaV@*`& ;k)ږ(sL/{Coq`,fdxf-^Y{[I̭s>EW ?D=+i*ӄ?ģ}@ȿ'OkzG: BXѱfYm>׃Ԃˊϋ e33TTr<խ$\b\@eؿk!l·v?+_⹃n +{h/,;SJ)ފ`4'FXW$u+NT6jm! 5vc];AJiD=BmkPӌoC#攫׿0 n46*o׮X ZIA3_);wolWR+^rE0)R9J)$F/5މ B S}-lAԮ=۟s,e@8BM3ǃj*' 7C.*`DQ5X W0C~wދ7>sOPLkG[ً?x^~?tYW~'?;ƠNK|ҩ?Q!?;L]>>޷oU\^1]T[.xTzV[n] bw5V}VWk: CNaF`CNG}fWM#~|!x!t̛OuM%z󷥛Uݕ-5g'zf/غ /PC Œuz*%K]<|F)PS1NȄޭJ J\5:)+!6,ylCNb͟ٹV>.uywFL=[ }dۯ_/) #G^~k,q2 Pz?0n6W1E`p X`/+BM3Sq$bG`2O: T*'IH4(S? (:yg޷Xw6g$#h /4ܳq2IDATmrpUQxN8闏)iμN' ,xϤ/9* $Ǚ>˛l`7__Fpu"ˁEh0\uZyC;!ֵua0@iЛaaxEjG/'@3*=xLu1Ԑ9jC$t>AUG* 35M+(Zqo~Hx:1sK~^> >{1ADFY{#}gzi26`@灭֝7#:R=ᙑssH(=Ղun~&X°`8 p BKV6ER PX .%ji@="aSJ^uMU_9@ {[>׀~vb rsy]p4"о8AoۖQD"G $% ^l:R D=܃X!_/J\$W)1nx3tmB>^poXk'.O*Ww ѵwk߆2 G@a7d=`8oZ~ڌ`!j:an' M n./CCA˽ZQY`bmWQU0 P ./ĺ_lU[F}19Io߶-+X"S+pBݷ۷mCۺ g0#TG_wcHo1|Lf)SY4B>PN X<@BՔ0}@U9mT y ` $Ӯ҇@ ae]^0o6t33 zj4CX'V.a`Pc,e?G HO*7mwoDD`{n3]sP.G8qL+>-},K`=عsN?}H$9@>~z{ #;`)wX>?P:g;r b3gt'[Ŕ*땷JRABvaÜwy5No`=s8_ x-8_ -*/z@X L:"0z{(ezrvMf`]>p,w!y,!Ԅ,kD_H=ᄝSM2`-Ք/tx6Pc3ZJ_|7d3jc+8onR[,K tu/SO> Ҍ'^/sP92@y9@y@u ˒t߿r&ǔ+T&F3J)FhYiO5g̥.'Y',=iNF]20r`lg…HW' ‰mX"Bޕq P8z"LaNd*j9 /L6QI0-EZ3q l B5.8XVPN-[fezҳYhR#'1"ԅPU^@ ̞=@ yG0xF+OT5P/un/G|?' n=@(5 ߑ#:3c ;%:5 ctȿ y9x^`P ÂPv1sr-Ftjr` y.ûyE Զ@ׂPzY灭_a'7^qOǃ3@GAKj藙xg&\|ܷ&Xß S=B3{Hoۆg_z˲`,(s>:ك}ol%wq% ?^Lyko&ӲFuW!:;%[isX &]{*{֜9hji˼NiIؾWOF`hjvCNe,>5:-F j* 9irR }!QP# ru_r<"\|1Z[[QSS2)ÉHql1|9A)<ŅCf埊,?' ((8_d}VZn ̍`9z-جbHF{BKFlk)R@-h(4nTГb,92CPLbསϺ`.1PJ|aSćz/qF|Iqyg3>O86W/X+뮼!|%#/W<j`܈ 2˪qR-; -6æ}1E@  @bf,JIU[0:6 `8$][(%a@KYc5Sa?Q3f >?t>QWWK`cyEsN1`4* GRUtXqe*2G]%PȼCKFa)3U*̺+$i7Լ_\Ƭ' 29 fBl{ E_iwv_{}kעt/ȇCOMkPx\qpL3yO~;;Y((#އRԃ1GjX{nRk["#Mͣ%^CBR *&٬UL)v3-]Hgr~$!4 `7gúf6ir<37ݩn?Kym2#}Bnu~w5zx)Ê_LI #vQjPel߶ <x[x+uKФe!z,G3G"ch%+ioXHj(M2.]TWZAw0i; 0-Uh(V44*jX1uQކ%#+X ‰`8)iXPs7i/Pާ ݃Da4qƑã=9]5>,hEa>ՏOG2G~KC)Eoލv]{srXle+Pt\ pOpI5٠ C@59J٥zsJ&φc P6:*^zAt2Yǡ_DxIS U HY@[q߀jXyǒesLT;>Ï'J5`AS%]jI${yxf-UD@pW1݉ށ4[4uZ  VoLd Q3cn U Xi8blW ?**w宄,#/Wb f -TRٟs"{‰z|v:aVU~E__4<0 }V>̍'&G+; Ǎf~n,XF(~ NSkpm j*&CSR@8J k0xQLQm%pDW6BH~S6nM 05[~5{ Cao.=hs[n #1EpM7 ҆QNSEi%4$0}|K ~6 \j= ͺ>՗ lFY_9 <'GgC=HA2/mzkWJޗ,P]5}<׀qʾw<pD_0 kxM>bʯ}aD0B^Vh"]6+7>F55e w_A $a TVcQu0++@y_"26 \W;4m<8` %p准^y/0 7sd3  CJ@ (Rґ5`|2H NWCt9Gs,fPUx0n1 Tt37^gKy{: NCR D~";oS68;ت:9~o_i+XºN BjLflC8ٜgD3EDlFb2t&35aH#8y]Ko{{_)|>{~ϹtOy{ؤ$wꭁ#nbIB3r |ɨΤzox>"xO6sj V?o>m\ D_4Y~{`L rtQIwLJf$سY H+5, ISWmW}s˟Gұ1%e=E%Ix`z&O&G_T&BO*oX1BnDv3x]$ܥ t_YM\8( U(']em-'9|PDίCjDr"J˝wK/u<1QоuS/$PUC3sPN f8 (ů~trCDI]-JRĿ_Ԁ%͋@3fJBnTz ̤>3' 5\'<ݥBpPk;o"oP&Mz{ $4nTDWH~E*x_f>9{PoHO4u79pP"S?~;kK[fJ6˂2`n $tUU n4梜XoGf) 1!rv-L}tGӤm˞dX|}69GL$)A\Pn M7h)"+eF(%))_(>Aׂ \HԵH'<3s@XXo d',1蜌 hd9h+AfS#3iCb lȌpXݱ&MqVV{?u~.\%@[s‰$Ihj :3&f QBn6'n狶~$iw hY{#N@iߺCW첁\eAN|aӳ bHDʘ~;)Th_`D?Xj yb=t.peDپ>":=I?0SL D j.ܷ *.ǐ9SN_*H]-?\0n/6x+2ڷz =l';<AUť SRz<4g}LV?5t.1Մj D hj #) iz+D#8?;Xso'ل#YL)2#h̍YREWWomo,hjj(934ӉaRӐ4 vXDC0YZ7jqk=V*Mw^[p1t]SMc ?p0GiݼEWJȡ6H񭵪6?܃ۉpclڻI)Y$w}.bm羰iqrň.~}춯˗n뺙uQ^rdL%n_߫s-u ]qR҇+1ȮIENDB` h  00 % X4VS_VERSION_INFO?StringFileInfo080904b0,CompanyNameamphpVFileDescriptionExecutes a command and passes the stdio streams of the created process to TCP sockets0FileVersion1.0.0.0: InternalNameProcessW.exeVLegalCopyrightCopyright (C) amphp 2017B OriginalFilenameProcessW.exe@ProductNameProcess Wrapper4ProductVersion0.0.0.0DVarFileInfo$Translation  0)050U0k0u00000000 1G1z1112223)363<3c333334 44H4V44444445#5v5556&6A6e6678/8Z88888 99M9g999999: :":J:d:j:::::;*;Q;W;;;;;<)->_>g>>>7?Y??????? L0,0>0F0Q0V0a0k000000&1/15111142M2W2]222223H333333344/4>4\444444'5B5U5e5y55$6-6I6m666666667/777<7A7O7W7n7v77777777"8V88888'909G9r999999::?:f:::::::::::<;e;;;< <>>(>8>H>Q>>>1?D?W?c?s????????0F0S0z000000 11!1P1X1p1v11111222222;3A33333334[4`4s4444/585@555555555 666"6(6.646:6@6F6L6R6X6^6d6j6p6v6|66666666666@p1x11111P$3 3$3(3,30343566,909L9P9p0 0$0,00080<0D0 $value) { if (\is_array($value)) { throw new \Error("\$env cannot accept array values"); } $envVars[(string) $key] = (string) $value; } $this->command = $command; $this->cwd = $cwd; $this->env = $envVars; $this->options = $options; $this->processRunner = Loop::getState(self::class); if ($this->processRunner === null) { $this->processRunner = IS_WINDOWS ? new WindowsProcessRunner : new PosixProcessRunner; Loop::setState(self::class, $this->processRunner); } } /** * Stops the process if it is still running. */ public function __destruct() { if ($this->handle !== null) { $this->processRunner->destroy($this->handle); } } public function __clone() { throw new \Error("Cloning is not allowed!"); } /** * Start the process. * * @return Promise Resolves with the PID. * * @throws StatusError If the process has already been started. */ public function start(): Promise { if ($this->handle) { throw new StatusError("Process has already been started."); } return call(function () { $this->handle = $this->processRunner->start($this->command, $this->cwd, $this->env, $this->options); return $this->pid = yield $this->handle->pidDeferred->promise(); }); } /** * Wait for the process to end. * * @return Promise Succeeds with process exit code or fails with a ProcessException if the process is killed. * * @throws StatusError If the process has already been started. */ public function join(): Promise { if (!$this->handle) { throw new StatusError("Process has not been started."); } return $this->processRunner->join($this->handle); } /** * Forcibly end the process. * * @throws StatusError If the process is not running. * @throws ProcessException If terminating the process fails. */ public function kill() { if (!$this->isRunning()) { throw new StatusError("Process is not running."); } $this->processRunner->kill($this->handle); } /** * Send a signal signal to the process. * * @param int $signo Signal number to send to process. * * @throws StatusError If the process is not running. * @throws ProcessException If sending the signal fails. */ public function signal(int $signo) { if (!$this->isRunning()) { throw new StatusError("Process is not running."); } $this->processRunner->signal($this->handle, $signo); } /** * Returns the PID of the child process. * * @return int * * @throws StatusError If the process has not started or has not completed starting. */ public function getPid(): int { if (!$this->pid) { throw new StatusError("Process has not been started or has not completed starting."); } return $this->pid; } /** * Returns the command to execute. * * @return string The command to execute. */ public function getCommand(): string { return $this->command; } /** * Gets the current working directory. * * @return string The current working directory an empty string if inherited from the current PHP process. */ public function getWorkingDirectory(): string { if ($this->cwd === "") { return \getcwd() ?: ""; } return $this->cwd; } /** * Gets the environment variables array. * * @return string[] Array of environment variables. */ public function getEnv(): array { return $this->env; } /** * Gets the options to pass to proc_open(). * * @return mixed[] Array of options. */ public function getOptions(): array { return $this->options; } /** * Determines if the process is still running. * * @return bool */ public function isRunning(): bool { return $this->handle && $this->handle->status !== ProcessStatus::ENDED; } /** * Gets the process input stream (STDIN). * * @return ProcessOutputStream */ public function getStdin(): ProcessOutputStream { if (!$this->handle || $this->handle->status === ProcessStatus::STARTING) { throw new StatusError("Process has not been started or has not completed starting."); } return $this->handle->stdin; } /** * Gets the process output stream (STDOUT). * * @return ProcessInputStream */ public function getStdout(): ProcessInputStream { if (!$this->handle || $this->handle->status === ProcessStatus::STARTING) { throw new StatusError("Process has not been started or has not completed starting."); } return $this->handle->stdout; } /** * Gets the process error stream (STDERR). * * @return ProcessInputStream */ public function getStderr(): ProcessInputStream { if (!$this->handle || $this->handle->status === ProcessStatus::STARTING) { throw new StatusError("Process has not been started or has not completed starting."); } return $this->handle->stderr; } public function __debugInfo(): array { return [ 'command' => $this->getCommand(), 'cwd' => $this->getWorkingDirectory(), 'env' => $this->getEnv(), 'options' => $this->getOptions(), 'pid' => $this->pid, 'status' => $this->handle ? $this->handle->status : -1, ]; } } queuedWrites = new \SplQueue; $resourceStreamPromise->onResolve(function ($error, $resourceStream) { if ($error) { $this->error = new StreamException("Failed to launch process", 0, $error); while (!$this->queuedWrites->isEmpty()) { list(, $deferred) = $this->queuedWrites->shift(); $deferred->fail($this->error); } return; } while (!$this->queuedWrites->isEmpty()) { /** * @var string $data * @var \Amp\Deferred $deferred */ list($data, $deferred) = $this->queuedWrites->shift(); $deferred->resolve($resourceStream->write($data)); } $this->resourceStream = $resourceStream; if ($this->shouldClose) { $this->resourceStream->close(); } }); } /** @inheritdoc */ public function write(string $data): Promise { if ($this->resourceStream) { return $this->resourceStream->write($data); } if ($this->error) { return new Failure($this->error); } if ($this->shouldClose) { throw new ClosedException("Stream has already been closed."); } $deferred = new Deferred; $this->queuedWrites->push([$data, $deferred]); return $deferred->promise(); } /** @inheritdoc */ public function end(string $finalData = ""): Promise { if ($this->resourceStream) { return $this->resourceStream->end($finalData); } if ($this->error) { return new Failure($this->error); } if ($this->shouldClose) { throw new ClosedException("Stream has already been closed."); } $deferred = new Deferred; $this->queuedWrites->push([$finalData, $deferred]); $this->shouldClose = true; return $deferred->promise(); } public function close() { $this->shouldClose = true; if ($this->resourceStream) { $this->resourceStream->close(); } elseif (!$this->queuedWrites->isEmpty()) { $error = new ClosedException("Stream closed."); do { list(, $deferred) = $this->queuedWrites->shift(); $deferred->fail($error); } while (!$this->queuedWrites->isEmpty()); } } } Succeeds with exit code of the process or fails if the process is killed. */ public function join(ProcessHandle $handle): Promise; /** * Forcibly end the child process. * * @param ProcessHandle $handle The process descriptor. * * @throws ProcessException If terminating the process fails. */ public function kill(ProcessHandle $handle); /** * Send a signal signal to the child process. * * @param ProcessHandle $handle The process descriptor. * @param int $signo Signal number to send to process. * * @throws ProcessException If sending the signal fails. */ public function signal(ProcessHandle $handle, int $signo); /** * Release all resources held by the process handle. * * @param ProcessHandle $handle The process descriptor. */ public function destroy(ProcessHandle $handle); } extraDataPipeWatcher = null; $handle->status = ProcessStatus::ENDED; if (!\is_resource($stream) || \feof($stream)) { $handle->joinDeferred->fail(new ProcessException("Process ended unexpectedly")); } else { $handle->joinDeferred->resolve((int) \rtrim(@\stream_get_contents($stream))); } $handle->wait(); } public static function onProcessStartExtraDataPipeReadable($watcher, $stream, $data) { Loop::cancel($watcher); $pid = \rtrim(@\fgets($stream)); /** @var $deferreds Deferred[] */ list($handle, $pipes, $deferreds) = $data; if (!$pid || !\is_numeric($pid)) { $error = new ProcessException("Could not determine PID"); $handle->pidDeferred->fail($error); foreach ($deferreds as $deferred) { /** @var $deferred Deferred */ $deferred->fail($error); } if ($handle->status < ProcessStatus::ENDED) { $handle->status = ProcessStatus::ENDED; $handle->joinDeferred->fail($error); } return; } $handle->status = ProcessStatus::RUNNING; $handle->pidDeferred->resolve((int) $pid); $deferreds[0]->resolve($pipes[0]); $deferreds[1]->resolve($pipes[1]); $deferreds[2]->resolve($pipes[2]); if ($handle->extraDataPipeWatcher !== null) { Loop::enable($handle->extraDataPipeWatcher); } } /** @inheritdoc */ public function start(string $command, string $cwd = null, array $env = [], array $options = []): ProcessHandle { $command = \sprintf( '{ (%s) <&3 3<&- 3>/dev/null & } 3<&0; trap "" INT TERM QUIT HUP;' . 'pid=$!; echo $pid >&3; wait $pid; RC=$?; echo $RC >&3; exit $RC', $command ); $handle = new Handle; $handle->proc = @\proc_open($command, $this->generateFds(), $pipes, $cwd ?: null, $env ?: null, $options); if (!\is_resource($handle->proc)) { $message = "Could not start process"; if ($error = \error_get_last()) { $message .= \sprintf(" Errno: %d; %s", $error["type"], $error["message"]); } throw new ProcessException($message); } $status = \proc_get_status($handle->proc); if (!$status) { \proc_close($handle->proc); throw new ProcessException("Could not get process status"); } $handle->shellPid = \proc_get_status($handle->proc)['pid']; $stdinDeferred = new Deferred; $handle->stdin = new ProcessOutputStream($stdinDeferred->promise()); $stdoutDeferred = new Deferred; $handle->stdout = new ProcessInputStream($stdoutDeferred->promise()); $stderrDeferred = new Deferred; $handle->stderr = new ProcessInputStream($stderrDeferred->promise()); $handle->extraDataPipe = $pipes[3]; \stream_set_blocking($pipes[3], false); $handle->extraDataPipeStartWatcher = Loop::onReadable($pipes[3], [self::class, 'onProcessStartExtraDataPipeReadable'], [$handle, [ new ResourceOutputStream($pipes[0]), new ResourceInputStream($pipes[1]), new ResourceInputStream($pipes[2]), ], [ $stdinDeferred, $stdoutDeferred, $stderrDeferred ]]); $handle->extraDataPipeWatcher = Loop::onReadable($pipes[3], [self::class, 'onProcessEndExtraDataPipeReadable'], $handle); Loop::unreference($handle->extraDataPipeWatcher); Loop::disable($handle->extraDataPipeWatcher); return $handle; } private function generateFds(): array { if (self::$fdPath === null) { self::$fdPath = \file_exists("/dev/fd") ? "/dev/fd" : "/proc/self/fd"; } $fdList = @\scandir(self::$fdPath, \SCANDIR_SORT_NONE); if ($fdList === false) { throw new ProcessException("Unable to list open file descriptors"); } $fdList = \array_filter($fdList, function (string $path): bool { return $path !== "." && $path !== ".."; }); $fds = []; foreach ($fdList as $id) { $fds[(int) $id] = ["file", "/dev/null", "r"]; } return self::FD_SPEC + $fds; } /** @inheritdoc */ public function join(ProcessHandle $handle): Promise { /** @var Handle $handle */ if ($handle->extraDataPipeWatcher !== null) { Loop::reference($handle->extraDataPipeWatcher); } return $handle->joinDeferred->promise(); } /** @inheritdoc */ public function kill(ProcessHandle $handle) { /** @var Handle $handle */ if ($handle->extraDataPipeWatcher !== null) { Loop::cancel($handle->extraDataPipeWatcher); $handle->extraDataPipeWatcher = null; } /** @var Handle $handle */ if ($handle->extraDataPipeStartWatcher !== null) { Loop::cancel($handle->extraDataPipeStartWatcher); $handle->extraDataPipeStartWatcher = null; } if (!\proc_terminate($handle->proc, 9)) { // Forcefully kill the process using SIGKILL. throw new ProcessException("Terminating process failed"); } $handle->pidDeferred->promise()->onResolve(function ($error, $pid) { // The function should not call posix_kill() if $pid is null (i.e., there was an error starting the process). if ($error) { return; } // ignore errors because process not always detached @\posix_kill($pid, 9); }); if ($handle->status < ProcessStatus::ENDED) { $handle->status = ProcessStatus::ENDED; $handle->joinDeferred->fail(new ProcessException("The process was killed")); } $this->free($handle); } /** @inheritdoc */ public function signal(ProcessHandle $handle, int $signo) { $handle->pidDeferred->promise()->onResolve(function ($error, $pid) use ($signo) { if ($error) { return; } @\posix_kill($pid, $signo); }); } /** @inheritdoc */ public function destroy(ProcessHandle $handle) { /** @var Handle $handle */ if ($handle->status < ProcessStatus::ENDED && \getmypid() === $handle->originalParentPid) { try { $this->kill($handle); return; } catch (ProcessException $e) { // ignore } } $this->free($handle); } private function free(Handle $handle) { /** @var Handle $handle */ if ($handle->extraDataPipeWatcher !== null) { Loop::cancel($handle->extraDataPipeWatcher); $handle->extraDataPipeWatcher = null; } /** @var Handle $handle */ if ($handle->extraDataPipeStartWatcher !== null) { Loop::cancel($handle->extraDataPipeStartWatcher); $handle->extraDataPipeStartWatcher = null; } if (\is_resource($handle->extraDataPipe)) { \fclose($handle->extraDataPipe); } $handle->stdin->close(); $handle->stdout->close(); $handle->stderr->close(); if (\is_resource($handle->proc)) { \proc_close($handle->proc); } } } pidDeferred = new Deferred; $this->joinDeferred = new Deferred; $this->originalParentPid = \getmypid(); } /** @var Deferred */ public $joinDeferred; /** @var resource */ public $proc; /** @var resource */ public $extraDataPipe; /** @var string */ public $extraDataPipeWatcher; /** @var string */ public $extraDataPipeStartWatcher; /** @var int */ public $originalParentPid; /** @var int */ public $shellPid; public function wait() { if ($this->shellPid === 0) { return; } $pid = $this->shellPid; $this->shellPid = 0; Loop::unreference(Loop::repeat(100, static function (string $watcherId) use ($pid) { if (!\extension_loaded('pcntl') || \pcntl_waitpid($pid, $status, \WNOHANG) !== 0) { Loop::cancel($watcherId); } })); } public function __destruct() { $this->wait(); } } server = \stream_socket_server(self::SERVER_SOCKET_URI, $errNo, $errStr, $flags); if (!$this->server) { throw new \Error("Failed to create TCP server socket for process wrapper: {$errNo}: {$errStr}"); } if (!\stream_set_blocking($this->server, false)) { throw new \Error("Failed to set server socket to non-blocking mode"); } list($this->address, $this->port) = \explode(':', \stream_socket_get_name($this->server, false)); $this->port = (int) $this->port; Loop::unreference(Loop::onReadable($this->server, [$this, 'onServerSocketReadable'])); } private function failClientHandshake($socket, int $code) { \fwrite($socket, \chr(SignalCode::HANDSHAKE_ACK) . \chr($code)); \fclose($socket); unset($this->pendingClients[(int) $socket]); } public function failHandleStart(Handle $handle, string $message, ...$args) { Loop::cancel($handle->connectTimeoutWatcher); unset($this->pendingProcesses[$handle->wrapperPid]); foreach ($handle->sockets as $socket) { \fclose($socket); } $error = new ProcessException(\vsprintf($message, $args)); $deferreds = $handle->stdioDeferreds; $deferreds[] = $handle->joinDeferred; $handle->stdioDeferreds = []; foreach ($deferreds as $deferred) { $deferred->fail($error); } } /** * Read data from a client socket. * * This method cleans up internal state as appropriate. Returns null if the read fails or needs to be repeated. * * @param resource $socket * @param int $length * @param PendingSocketClient $state * * @return string|null */ private function readDataFromPendingClient($socket, int $length, PendingSocketClient $state) { $data = \fread($socket, $length); if ($data === false || $data === '') { return null; } $data = $state->receivedDataBuffer . $data; if (\strlen($data) < $length) { $state->receivedDataBuffer = $data; return null; } $state->receivedDataBuffer = ''; Loop::cancel($state->readWatcher); return $data; } public function onReadableHandshake($watcher, $socket) { $socketId = (int) $socket; $pendingClient = $this->pendingClients[$socketId]; if (null === $data = $this->readDataFromPendingClient($socket, self::SECURITY_TOKEN_SIZE + 6, $pendingClient)) { return; } $packet = \unpack('Csignal/Npid/Cstream_id/a*client_token', $data); // validate the client's handshake if ($packet['signal'] !== SignalCode::HANDSHAKE) { $this->failClientHandshake($socket, HandshakeStatus::SIGNAL_UNEXPECTED); return; } if ($packet['stream_id'] > 2) { $this->failClientHandshake($socket, HandshakeStatus::INVALID_STREAM_ID); return; } if (!isset($this->pendingProcesses[$packet['pid']])) { $this->failClientHandshake($socket, HandshakeStatus::INVALID_PROCESS_ID); return; } $handle = $this->pendingProcesses[$packet['pid']]; if (isset($handle->sockets[$packet['stream_id']])) { $this->failClientHandshake($socket, HandshakeStatus::DUPLICATE_STREAM_ID); \trigger_error(\sprintf( "%s: Received duplicate socket for process #%s stream #%d", self::class, $handle->pid, $packet['stream_id'] ), E_USER_WARNING); return; } if (!\hash_equals($packet['client_token'], $handle->securityTokens[$packet['stream_id']])) { $this->failClientHandshake($socket, HandshakeStatus::INVALID_CLIENT_TOKEN); $this->failHandleStart($handle, "Invalid client security token for stream #%d", $packet['stream_id']); return; } $ackData = \chr(SignalCode::HANDSHAKE_ACK) . \chr(HandshakeStatus::SUCCESS) . $handle->securityTokens[$packet['stream_id'] + 3]; // Unless we set the security token size so high that it won't fit in the // buffer, this probably shouldn't ever happen unless something has gone wrong if (\fwrite($socket, $ackData) !== self::SECURITY_TOKEN_SIZE + 2) { unset($this->pendingClients[$socketId]); return; } $pendingClient->pid = $packet['pid']; $pendingClient->streamId = $packet['stream_id']; $pendingClient->readWatcher = Loop::onReadable($socket, [$this, 'onReadableHandshakeAck']); } public function onReadableHandshakeAck($watcher, $socket) { $socketId = (int) $socket; $pendingClient = $this->pendingClients[$socketId]; // can happen if the start promise was failed if (!isset($this->pendingProcesses[$pendingClient->pid]) || $this->pendingProcesses[$pendingClient->pid]->status === ProcessStatus::ENDED) { \fclose($socket); Loop::cancel($watcher); Loop::cancel($pendingClient->timeoutWatcher); unset($this->pendingClients[$socketId]); return; } if (null === $data = $this->readDataFromPendingClient($socket, 2, $pendingClient)) { return; } Loop::cancel($pendingClient->timeoutWatcher); unset($this->pendingClients[$socketId]); $handle = $this->pendingProcesses[$pendingClient->pid]; $packet = \unpack('Csignal/Cstatus', $data); if ($packet['signal'] !== SignalCode::HANDSHAKE_ACK || $packet['status'] !== HandshakeStatus::SUCCESS) { $this->failHandleStart( $handle, "Client rejected handshake with code %d for stream #%d", $packet['status'], $pendingClient->streamId ); return; } $handle->sockets[$pendingClient->streamId] = $socket; if (\count($handle->sockets) === 3) { $handle->childPidWatcher = Loop::onReadable($handle->sockets[0], [$this, 'onReadableChildPid'], $handle); $deferreds = $handle->stdioDeferreds; $handle->stdioDeferreds = []; // clear, so there's no double resolution if process spawn fails $deferreds[0]->resolve(new ResourceOutputStream($handle->sockets[0])); $deferreds[1]->resolve(new ResourceInputStream($handle->sockets[1])); $deferreds[2]->resolve(new ResourceInputStream($handle->sockets[2])); } } public function onReadableChildPid($watcher, $socket, Handle $handle) { $data = \fread($socket, 5); if ($data === false || $data === '') { return; } Loop::cancel($handle->childPidWatcher); Loop::cancel($handle->connectTimeoutWatcher); $handle->childPidWatcher = null; if (\strlen($data) !== 5) { $this->failHandleStart( $handle, 'Failed to read PID from wrapper: Received %d of 5 expected bytes', \strlen($data) ); return; } $packet = \unpack('Csignal/Npid', $data); if ($packet['signal'] !== SignalCode::CHILD_PID) { $this->failHandleStart( $handle, "Failed to read PID from wrapper: Unexpected signal code %d", $packet['signal'] ); return; } // Required, because a process might be destroyed while starting if ($handle->status === ProcessStatus::STARTING) { $handle->status = ProcessStatus::RUNNING; $handle->exitCodeWatcher = Loop::onReadable($handle->sockets[0], [$this, 'onReadableExitCode'], $handle); if (!$handle->exitCodeRequested) { Loop::unreference($handle->exitCodeWatcher); } } $handle->pidDeferred->resolve($packet['pid']); unset($this->pendingProcesses[$handle->wrapperPid]); } public function onReadableExitCode($watcher, $socket, Handle $handle) { $data = \fread($socket, 5); if ($data === false || $data === '') { return; } Loop::cancel($handle->exitCodeWatcher); $handle->exitCodeWatcher = null; if (\strlen($data) !== 5) { $handle->status = ProcessStatus::ENDED; $handle->joinDeferred->fail(new ProcessException( \sprintf('Failed to read exit code from wrapper: Received %d of 5 expected bytes', \strlen($data)) )); return; } $packet = \unpack('Csignal/Ncode', $data); if ($packet['signal'] !== SignalCode::EXIT_CODE) { $this->failHandleStart( $handle, "Failed to read exit code from wrapper: Unexpected signal code %d", $packet['signal'] ); return; } $handle->status = ProcessStatus::ENDED; $handle->joinDeferred->resolve($packet['code']); $handle->stdin->close(); $handle->stdout->close(); $handle->stderr->close(); // Explicitly \fclose() sockets, as resource streams shut only one side down. foreach ($handle->sockets as $sock) { // Ensure socket is still open before attempting to close. if (\is_resource($sock)) { @\fclose($sock); } } } public function onClientSocketConnectTimeout($watcher, $socket) { $id = (int) $socket; Loop::cancel($this->pendingClients[$id]->readWatcher); unset($this->pendingClients[$id]); \fclose($socket); } public function onServerSocketReadable() { $socket = \stream_socket_accept($this->server); if (!\stream_set_blocking($socket, false)) { throw new \Error("Failed to set client socket to non-blocking mode"); } $pendingClient = new PendingSocketClient; $pendingClient->readWatcher = Loop::onReadable($socket, [$this, 'onReadableHandshake']); $pendingClient->timeoutWatcher = Loop::delay(self::CONNECT_TIMEOUT, [$this, 'onClientSocketConnectTimeout'], $socket); $this->pendingClients[(int) $socket] = $pendingClient; } public function onProcessConnectTimeout($watcher, Handle $handle) { $running = \is_resource($handle->proc) && \proc_get_status($handle->proc)['running']; $error = null; if (!$running) { $error = \stream_get_contents($handle->wrapperStderrPipe); } $error = $error ?: 'Process did not connect to server before timeout elapsed'; foreach ($handle->sockets as $socket) { \fclose($socket); } $error = new ProcessException(\trim($error)); foreach ($handle->stdioDeferreds as $deferred) { $deferred->fail($error); } \fclose($handle->wrapperStderrPipe); \proc_close($handle->proc); $handle->joinDeferred->fail($error); } public function registerPendingProcess(Handle $handle) { // Use Loop::defer() to start the timeout only after the loop has ticked once. This prevents issues with many // things started at once, see https://github.com/amphp/process/issues/21. $handle->connectTimeoutWatcher = Loop::defer(function () use ($handle) { $handle->connectTimeoutWatcher = Loop::delay( self::CONNECT_TIMEOUT, [$this, 'onProcessConnectTimeout'], $handle ); }); $this->pendingProcesses[$handle->wrapperPid] = $handle; } } socketConnector->address, $this->socketConnector->port, SocketConnector::SECURITY_TOKEN_SIZE ); if ($workingDirectory !== '') { $result .= ' ' . \escapeshellarg('--cwd=' . \rtrim($workingDirectory, '\\')); } return $result; } public function __construct() { $this->socketConnector = new SocketConnector; } /** @inheritdoc */ public function start(string $command, string $cwd = null, array $env = [], array $options = []): ProcessHandle { if (\strpos($command, "\0") !== false) { throw new ProcessException("Can't execute commands that contain null bytes."); } $options['bypass_shell'] = true; $handle = new Handle; $handle->proc = @\proc_open( $this->makeCommand($cwd ?? ''), self::FD_SPEC, $pipes, $cwd ?: null, $env ?: null, $options ); if (!\is_resource($handle->proc)) { $message = "Could not start process"; if ($error = \error_get_last()) { $message .= \sprintf(" Errno: %d; %s", $error["type"], $error["message"]); } throw new ProcessException($message); } $status = \proc_get_status($handle->proc); if (!$status) { \proc_close($handle->proc); throw new ProcessException("Could not get process status"); } $securityTokens = \random_bytes(SocketConnector::SECURITY_TOKEN_SIZE * 6); $written = \fwrite($pipes[0], $securityTokens . "\0" . $command . "\0"); \fclose($pipes[0]); \fclose($pipes[1]); if ($written !== SocketConnector::SECURITY_TOKEN_SIZE * 6 + \strlen($command) + 2) { \fclose($pipes[2]); \proc_close($handle->proc); throw new ProcessException("Could not send security tokens / command to process wrapper"); } $handle->securityTokens = \str_split($securityTokens, SocketConnector::SECURITY_TOKEN_SIZE); $handle->wrapperPid = $status['pid']; $handle->wrapperStderrPipe = $pipes[2]; $stdinDeferred = new Deferred; $handle->stdioDeferreds[] = $stdinDeferred; $handle->stdin = new ProcessOutputStream($stdinDeferred->promise()); $stdoutDeferred = new Deferred; $handle->stdioDeferreds[] = $stdoutDeferred; $handle->stdout = new ProcessInputStream($stdoutDeferred->promise()); $stderrDeferred = new Deferred; $handle->stdioDeferreds[] = $stderrDeferred; $handle->stderr = new ProcessInputStream($stderrDeferred->promise()); $this->socketConnector->registerPendingProcess($handle); return $handle; } /** @inheritdoc */ public function join(ProcessHandle $handle): Promise { /** @var Handle $handle */ $handle->exitCodeRequested = true; if ($handle->exitCodeWatcher !== null) { Loop::reference($handle->exitCodeWatcher); } return $handle->joinDeferred->promise(); } /** @inheritdoc */ public function kill(ProcessHandle $handle) { /** @var Handle $handle */ \exec('taskkill /F /T /PID ' . $handle->wrapperPid . ' 2>&1', $output, $exitCode); $failStart = false; if ($handle->childPidWatcher !== null) { Loop::cancel($handle->childPidWatcher); $handle->childPidWatcher = null; $handle->pidDeferred->fail(new ProcessException("The process was killed")); $failStart = true; } if ($handle->exitCodeWatcher !== null) { Loop::cancel($handle->exitCodeWatcher); $handle->exitCodeWatcher = null; $handle->joinDeferred->fail(new ProcessException("The process was killed")); } $handle->status = ProcessStatus::ENDED; if ($failStart || $handle->stdioDeferreds) { $this->socketConnector->failHandleStart($handle, "The process was killed"); } $this->free($handle); } /** @inheritdoc */ public function signal(ProcessHandle $handle, int $signo) { throw new ProcessException('Signals are not supported on Windows'); } /** @inheritdoc */ public function destroy(ProcessHandle $handle) { /** @var Handle $handle */ if ($handle->status < ProcessStatus::ENDED && \is_resource($handle->proc)) { try { $this->kill($handle); return; } catch (ProcessException $e) { // ignore } } $this->free($handle); } private function free(Handle $handle) { if ($handle->childPidWatcher !== null) { Loop::cancel($handle->childPidWatcher); $handle->childPidWatcher = null; } if ($handle->exitCodeWatcher !== null) { Loop::cancel($handle->exitCodeWatcher); $handle->exitCodeWatcher = null; } $handle->stdin->close(); $handle->stdout->close(); $handle->stderr->close(); foreach ($handle->sockets as $socket) { if (\is_resource($socket)) { @\fclose($socket); } } if (\is_resource($handle->wrapperStderrPipe)) { @\fclose($handle->wrapperStderrPipe); } if (\is_resource($handle->proc)) { \proc_close($handle->proc); } } } joinDeferred = new Deferred; $this->pidDeferred = new Deferred; } /** @var Deferred */ public $joinDeferred; /** @var string */ public $exitCodeWatcher; /** @var bool */ public $exitCodeRequested = false; /** @var resource */ public $proc; /** @var int */ public $wrapperPid; /** @var resource */ public $wrapperStderrPipe; /** @var resource[] */ public $sockets = []; /** @var Deferred[] */ public $stdioDeferreds; /** @var string */ public $childPidWatcher; /** @var string */ public $connectTimeoutWatcher; /** @var string[] */ public $securityTokens; } onResolve(function ($error, $resourceStream) { if ($error) { $this->error = new StreamException("Failed to launch process", 0, $error); if ($this->initialRead) { $initialRead = $this->initialRead; $this->initialRead = null; $initialRead->fail($this->error); } return; } $this->resourceStream = $resourceStream; if (!$this->referenced) { $this->resourceStream->unreference(); } if ($this->shouldClose) { $this->resourceStream->close(); } if ($this->initialRead) { $initialRead = $this->initialRead; $this->initialRead = null; $initialRead->resolve($this->shouldClose ? null : $this->resourceStream->read()); } }); } /** * Reads data from the stream. * * @return Promise Resolves with a string when new data is available or `null` if the stream has closed. * * @throws PendingReadError Thrown if another read operation is still pending. */ public function read(): Promise { if ($this->initialRead) { throw new PendingReadError; } if ($this->error) { return new Failure($this->error); } if ($this->resourceStream) { return $this->resourceStream->read(); } if ($this->shouldClose) { return new Success; // Resolve reads on closed streams with null. } $this->initialRead = new Deferred; return $this->initialRead->promise(); } public function reference() { $this->referenced = true; if ($this->resourceStream) { $this->resourceStream->reference(); } } public function unreference() { $this->referenced = false; if ($this->resourceStream) { $this->resourceStream->unreference(); } } public function close() { $this->shouldClose = true; if ($this->initialRead) { $initialRead = $this->initialRead; $this->initialRead = null; $initialRead->resolve(); } if ($this->resourceStream) { $this->resourceStream->close(); } } } { "name": "amphp/process", "homepage": "https://github.com/amphp/process", "description": "Asynchronous process manager.", "require": { "php": ">=7", "amphp/amp": "^2", "amphp/byte-stream": "^1.4" }, "require-dev": { "phpunit/phpunit": "^6", "amphp/phpunit-util": "^1", "amphp/php-cs-fixer-config": "dev-master" }, "license": "MIT", "authors": [ { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "autoload": { "psr-4": { "Amp\\Process\\": "lib" }, "files": ["lib/functions.php"] }, "autoload-dev": { "psr-4": { "Amp\\Process\\Test\\": "test" } }, "config": { "platform": { "php": "7.0.33" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff --dry-run", "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" } } query($key); $lines = \array_filter($lines, function ($line) { return '' !== $line && $line[0] === ' '; }); $values = \array_map(function ($line) { return \preg_split("(\\s+)", \ltrim($line), 3); }, $lines); $foundValue = null; foreach ($values as $v) { if ($v[0] === $value) { if (\count($v) >= 3) { return $v[2]; } $foundValue = $v; } } if ($foundValue) { throw new KeyNotFoundException("Windows registry key '{$key}\\{$value}' was found, but could not be read correctly, got " . \var_export($foundValue, true)); } throw new KeyNotFoundException("Windows registry key '{$key}\\{$value}' not found."); }); } public function listKeys(string $key): Promise { return call(function () use ($key) { $lines = yield $this->query($key); $lines = \array_filter($lines, function ($line) { return '' !== $line && $line[0] !== ' '; }); return $lines; }); } private function query(string $key): Promise { return call(function () use ($key) { if (0 !== \stripos(\PHP_OS, 'WIN')) { throw new \Error('Not running on Windows.'); } $key = \strtr($key, '/', "\\"); $cmd = \sprintf('reg query %s', \escapeshellarg($key)); $process = new Process($cmd); yield $process->start(); $stdout = yield ByteStream\buffer($process->getStdout()); $code = yield $process->join(); if ($code !== 0) { throw new KeyNotFoundException("Windows registry key '{$key}' not found."); } return \explode("\n", \str_replace("\r", '', $stdout)); }); } } { "name": "amphp/windows-registry", "description": "Windows Registry Reader.", "type": "library", "license": "MIT", "authors": [ { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "autoload": { "psr-4": { "Amp\\WindowsRegistry\\": "lib" } }, "require": { "amphp/amp": "^2", "amphp/byte-stream": "^1.4", "amphp/process": "^1" }, "require-dev": { "amphp/php-cs-fixer-config": "dev-master" }, "config": { "platform": { "php": "7.0.0" } } } assertSame($expectation, PublicSuffixList::isPublicSuffix($domain)); } public function provideTestData(): array { $lines = \file(__DIR__ . '/../fixture/public_suffix_list_tests.txt', \FILE_IGNORE_NEW_LINES | \FILE_SKIP_EMPTY_LINES); $lines = \array_filter($lines, static function ($line) { return \substr($line, 0, 2) !== '//'; }); return \array_map(static function ($line) { $parts = \explode(' ', $line); return [ $parts[0], (bool) $parts[1], ]; }, $lines); } } jar = $this->createJar(); } /** * @dataProvider provideCookieDomainMatchData * * @param ResponseCookie $cookie * @param string $domain * @param bool $returned * * @return \Generator */ public function testCookieDomainMatching(ResponseCookie $cookie, string $domain, bool $returned): \Generator { $this->jar->store($cookie); $requestCookies = yield $this->jar->get($this->getUri('https', $domain, '/')); if ($returned) { $requestCookie = new RequestCookie($cookie->getName(), $cookie->getValue()); $this->assertSame((string) $requestCookie, \implode('; ', $requestCookies)); } else { $this->assertSame([], $requestCookies); } } public function provideCookieDomainMatchData(): array { // See http://stackoverflow.com/a/1063760/2373138 for cases return [ [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('.foo.bar.example.com')), 'foo.bar', false, ], /* previous security issue */ [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('.example.com')), 'example.com', true, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('.example.com')), 'www.example.com', true, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('example.com')), 'example.com', true, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('example.com')), 'www.example.com', false, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('example.com')), 'anotherexample.com', false, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('anotherexample.com')), 'example.com', false, ], ]; } abstract protected function createJar(): CookieJar; } createMock(PsrUri::class); $uri->method('getScheme') ->willReturn(\strtolower($scheme)); $uri->method('getHost') ->willReturn(\strtolower($host)); $uri->method('getPath') ->willReturn($path); return $uri; } } withDomain('.foo.bar.example.com')), 'foo.bar', false, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('.example.com')), 'example.com', true, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('.example.com')), 'www.example.com', true, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('example.com')), 'example.com', true, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('example.com')), 'www.example.com', true, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('example.com')), 'anotherexample.com', false, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('anotherexample.com')), 'example.com', false, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('com')), 'anotherexample.com', false, ], [ new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('.com')), 'anotherexample.com', false, ], [new ResponseCookie('foo', 'bar', CookieAttributes::empty()->withDomain('')), 'example.com', true], ]; } public function setUp(): void { parent::setUp(); $this->jar = new InMemoryCookieJar; $socket = Socket\Server::listen('127.0.0.1:0'); $socket->unreference(); $this->address = $socket->getAddress(); $this->server = new Server([$socket], new CallableRequestHandler(function () { return new ServerResponse(Status::OK, ['set-cookie' => $this->cookieHeader], ''); }), new NullLogger, (new Options)->withHttp1Timeout(1)->withHttp2Timeout(1)); wait($this->server->start()); $this->client = (new HttpClientBuilder) ->usingPool(new UnlimitedConnectionPool(new DefaultConnectionFactory(new StaticConnector( $this->address, connector() )))) ->interceptNetwork(new CookieInterceptor($this->jar)) ->build(); } /** * @dataProvider provideCookieDomainMatchData * * @param ResponseCookie $cookie * @param string $requestDomain * @param bool $accept * * @return \Generator */ public function testCookieAccepting(ResponseCookie $cookie, string $requestDomain, bool $accept): \Generator { $this->cookieHeader = (string) $cookie; /** @var Response $response */ $response = yield $this->client->request(new Request('http://' . $requestDomain . '/')); yield $response->getBody()->buffer(); $cookies = $this->jar->getAll(); if ($accept) { $this->assertCount(1, $cookies); } else { $this->assertSame([], $cookies); } wait($this->server->stop()); } } // This Source Code Form is subject to the terms of the Mozilla Public // License, v. 2.0. If a copy of the MPL was not distributed with this // file, You can obtain one at https://mozilla.org/MPL/2.0/. // Please pull this list from, and only from https://publicsuffix.org/list/public_suffix_list.dat, // rather than any other VCS sites. Pulling from any other URL is not guaranteed to be supported. // Instructions on pulling and using this list can be found at https://publicsuffix.org/list/. // ===BEGIN ICANN DOMAINS=== // ac : https://en.wikipedia.org/wiki/.ac ac com.ac edu.ac gov.ac net.ac mil.ac org.ac // ad : https://en.wikipedia.org/wiki/.ad ad nom.ad // ae : https://en.wikipedia.org/wiki/.ae // see also: "Domain Name Eligibility Policy" at http://www.aeda.ae/eng/aepolicy.php ae co.ae net.ae org.ae sch.ae ac.ae gov.ae mil.ae // aero : see https://www.information.aero/index.php?id=66 aero accident-investigation.aero accident-prevention.aero aerobatic.aero aeroclub.aero aerodrome.aero agents.aero aircraft.aero airline.aero airport.aero air-surveillance.aero airtraffic.aero air-traffic-control.aero ambulance.aero amusement.aero association.aero author.aero ballooning.aero broker.aero caa.aero cargo.aero catering.aero certification.aero championship.aero charter.aero civilaviation.aero club.aero conference.aero consultant.aero consulting.aero control.aero council.aero crew.aero design.aero dgca.aero educator.aero emergency.aero engine.aero engineer.aero entertainment.aero equipment.aero exchange.aero express.aero federation.aero flight.aero fuel.aero gliding.aero government.aero groundhandling.aero group.aero hanggliding.aero homebuilt.aero insurance.aero journal.aero journalist.aero leasing.aero logistics.aero magazine.aero maintenance.aero media.aero microlight.aero modelling.aero navigation.aero parachuting.aero paragliding.aero passenger-association.aero pilot.aero press.aero production.aero recreation.aero repbody.aero res.aero research.aero rotorcraft.aero safety.aero scientist.aero services.aero show.aero skydiving.aero software.aero student.aero trader.aero trading.aero trainer.aero union.aero workinggroup.aero works.aero // af : http://www.nic.af/help.jsp af gov.af com.af org.af net.af edu.af // ag : http://www.nic.ag/prices.htm ag com.ag org.ag net.ag co.ag nom.ag // ai : http://nic.com.ai/ ai off.ai com.ai net.ai org.ai // al : http://www.ert.gov.al/ert_alb/faq_det.html?Id=31 al com.al edu.al gov.al mil.al net.al org.al // am : https://www.amnic.net/policy/en/Policy_EN.pdf am co.am com.am commune.am net.am org.am // ao : https://en.wikipedia.org/wiki/.ao // http://www.dns.ao/REGISTR.DOC ao ed.ao gv.ao og.ao co.ao pb.ao it.ao // aq : https://en.wikipedia.org/wiki/.aq aq // ar : https://nic.ar/es/nic-argentina/normativa ar bet.ar com.ar coop.ar edu.ar gob.ar gov.ar int.ar mil.ar musica.ar mutual.ar net.ar org.ar senasa.ar tur.ar // arpa : https://en.wikipedia.org/wiki/.arpa // Confirmed by registry 2008-06-18 arpa e164.arpa in-addr.arpa ip6.arpa iris.arpa uri.arpa urn.arpa // as : https://en.wikipedia.org/wiki/.as as gov.as // asia : https://en.wikipedia.org/wiki/.asia asia // at : https://en.wikipedia.org/wiki/.at // Confirmed by registry 2008-06-17 at ac.at co.at gv.at or.at sth.ac.at // au : https://en.wikipedia.org/wiki/.au // http://www.auda.org.au/ au // 2LDs com.au net.au org.au edu.au gov.au asn.au id.au // Historic 2LDs (closed to new registration, but sites still exist) info.au conf.au oz.au // CGDNs - http://www.cgdn.org.au/ act.au nsw.au nt.au qld.au sa.au tas.au vic.au wa.au // 3LDs act.edu.au catholic.edu.au // eq.edu.au - Removed at the request of the Queensland Department of Education nsw.edu.au nt.edu.au qld.edu.au sa.edu.au tas.edu.au vic.edu.au wa.edu.au // act.gov.au Bug 984824 - Removed at request of Greg Tankard // nsw.gov.au Bug 547985 - Removed at request of // nt.gov.au Bug 940478 - Removed at request of Greg Connors qld.gov.au sa.gov.au tas.gov.au vic.gov.au wa.gov.au // 4LDs // education.tas.edu.au - Removed at the request of the Department of Education Tasmania schools.nsw.edu.au // aw : https://en.wikipedia.org/wiki/.aw aw com.aw // ax : https://en.wikipedia.org/wiki/.ax ax // az : https://en.wikipedia.org/wiki/.az az com.az net.az int.az gov.az org.az edu.az info.az pp.az mil.az name.az pro.az biz.az // ba : http://nic.ba/users_data/files/pravilnik_o_registraciji.pdf ba com.ba edu.ba gov.ba mil.ba net.ba org.ba // bb : https://en.wikipedia.org/wiki/.bb bb biz.bb co.bb com.bb edu.bb gov.bb info.bb net.bb org.bb store.bb tv.bb // bd : https://en.wikipedia.org/wiki/.bd *.bd // be : https://en.wikipedia.org/wiki/.be // Confirmed by registry 2008-06-08 be ac.be // bf : https://en.wikipedia.org/wiki/.bf bf gov.bf // bg : https://en.wikipedia.org/wiki/.bg // https://www.register.bg/user/static/rules/en/index.html bg a.bg b.bg c.bg d.bg e.bg f.bg g.bg h.bg i.bg j.bg k.bg l.bg m.bg n.bg o.bg p.bg q.bg r.bg s.bg t.bg u.bg v.bg w.bg x.bg y.bg z.bg 0.bg 1.bg 2.bg 3.bg 4.bg 5.bg 6.bg 7.bg 8.bg 9.bg // bh : https://en.wikipedia.org/wiki/.bh bh com.bh edu.bh net.bh org.bh gov.bh // bi : https://en.wikipedia.org/wiki/.bi // http://whois.nic.bi/ bi co.bi com.bi edu.bi or.bi org.bi // biz : https://en.wikipedia.org/wiki/.biz biz // bj : https://en.wikipedia.org/wiki/.bj bj asso.bj barreau.bj gouv.bj // bm : http://www.bermudanic.bm/dnr-text.txt bm com.bm edu.bm gov.bm net.bm org.bm // bn : http://www.bnnic.bn/faqs bn com.bn edu.bn gov.bn net.bn org.bn // bo : https://nic.bo/delegacion2015.php#h-1.10 bo com.bo edu.bo gob.bo int.bo org.bo net.bo mil.bo tv.bo web.bo // Social Domains academia.bo agro.bo arte.bo blog.bo bolivia.bo ciencia.bo cooperativa.bo democracia.bo deporte.bo ecologia.bo economia.bo empresa.bo indigena.bo industria.bo info.bo medicina.bo movimiento.bo musica.bo natural.bo nombre.bo noticias.bo patria.bo politica.bo profesional.bo plurinacional.bo pueblo.bo revista.bo salud.bo tecnologia.bo tksat.bo transporte.bo wiki.bo // br : http://registro.br/dominio/categoria.html // Submitted by registry br 9guacu.br abc.br adm.br adv.br agr.br aju.br am.br anani.br aparecida.br app.br arq.br art.br ato.br b.br barueri.br belem.br bhz.br bib.br bio.br blog.br bmd.br boavista.br bsb.br campinagrande.br campinas.br caxias.br cim.br cng.br cnt.br com.br contagem.br coop.br coz.br cri.br cuiaba.br curitiba.br def.br des.br det.br dev.br ecn.br eco.br edu.br emp.br enf.br eng.br esp.br etc.br eti.br far.br feira.br flog.br floripa.br fm.br fnd.br fortal.br fot.br foz.br fst.br g12.br geo.br ggf.br goiania.br gov.br // gov.br 26 states + df https://en.wikipedia.org/wiki/States_of_Brazil ac.gov.br al.gov.br am.gov.br ap.gov.br ba.gov.br ce.gov.br df.gov.br es.gov.br go.gov.br ma.gov.br mg.gov.br ms.gov.br mt.gov.br pa.gov.br pb.gov.br pe.gov.br pi.gov.br pr.gov.br rj.gov.br rn.gov.br ro.gov.br rr.gov.br rs.gov.br sc.gov.br se.gov.br sp.gov.br to.gov.br gru.br imb.br ind.br inf.br jab.br jampa.br jdf.br joinville.br jor.br jus.br leg.br lel.br log.br londrina.br macapa.br maceio.br manaus.br maringa.br mat.br med.br mil.br morena.br mp.br mus.br natal.br net.br niteroi.br *.nom.br not.br ntr.br odo.br ong.br org.br osasco.br palmas.br poa.br ppg.br pro.br psc.br psi.br pvh.br qsl.br radio.br rec.br recife.br rep.br ribeirao.br rio.br riobranco.br riopreto.br salvador.br sampa.br santamaria.br santoandre.br saobernardo.br saogonca.br seg.br sjc.br slg.br slz.br sorocaba.br srv.br taxi.br tc.br tec.br teo.br the.br tmp.br trd.br tur.br tv.br udi.br vet.br vix.br vlog.br wiki.br zlg.br // bs : http://www.nic.bs/rules.html bs com.bs net.bs org.bs edu.bs gov.bs // bt : https://en.wikipedia.org/wiki/.bt bt com.bt edu.bt gov.bt net.bt org.bt // bv : No registrations at this time. // Submitted by registry bv // bw : https://en.wikipedia.org/wiki/.bw // http://www.gobin.info/domainname/bw.doc // list of other 2nd level tlds ? bw co.bw org.bw // by : https://en.wikipedia.org/wiki/.by // http://tld.by/rules_2006_en.html // list of other 2nd level tlds ? by gov.by mil.by // Official information does not indicate that com.by is a reserved // second-level domain, but it's being used as one (see www.google.com.by and // www.yahoo.com.by, for example), so we list it here for safety's sake. com.by // http://hoster.by/ of.by // bz : https://en.wikipedia.org/wiki/.bz // http://www.belizenic.bz/ bz com.bz net.bz org.bz edu.bz gov.bz // ca : https://en.wikipedia.org/wiki/.ca ca // ca geographical names ab.ca bc.ca mb.ca nb.ca nf.ca nl.ca ns.ca nt.ca nu.ca on.ca pe.ca qc.ca sk.ca yk.ca // gc.ca: https://en.wikipedia.org/wiki/.gc.ca // see also: http://registry.gc.ca/en/SubdomainFAQ gc.ca // cat : https://en.wikipedia.org/wiki/.cat cat // cc : https://en.wikipedia.org/wiki/.cc cc // cd : https://en.wikipedia.org/wiki/.cd // see also: https://www.nic.cd/domain/insertDomain_2.jsp?act=1 cd gov.cd // cf : https://en.wikipedia.org/wiki/.cf cf // cg : https://en.wikipedia.org/wiki/.cg cg // ch : https://en.wikipedia.org/wiki/.ch ch // ci : https://en.wikipedia.org/wiki/.ci // http://www.nic.ci/index.php?page=charte ci org.ci or.ci com.ci co.ci edu.ci ed.ci ac.ci net.ci go.ci asso.ci aéroport.ci int.ci presse.ci md.ci gouv.ci // ck : https://en.wikipedia.org/wiki/.ck *.ck !www.ck // cl : https://www.nic.cl // Confirmed by .CL registry cl co.cl gob.cl gov.cl mil.cl // cm : https://en.wikipedia.org/wiki/.cm plus bug 981927 cm co.cm com.cm gov.cm net.cm // cn : https://en.wikipedia.org/wiki/.cn // Submitted by registry cn ac.cn com.cn edu.cn gov.cn net.cn org.cn mil.cn 公司.cn 网络.cn 網絡.cn // cn geographic names ah.cn bj.cn cq.cn fj.cn gd.cn gs.cn gz.cn gx.cn ha.cn hb.cn he.cn hi.cn hl.cn hn.cn jl.cn js.cn jx.cn ln.cn nm.cn nx.cn qh.cn sc.cn sd.cn sh.cn sn.cn sx.cn tj.cn xj.cn xz.cn yn.cn zj.cn hk.cn mo.cn tw.cn // co : https://en.wikipedia.org/wiki/.co // Submitted by registry co arts.co com.co edu.co firm.co gov.co info.co int.co mil.co net.co nom.co org.co rec.co web.co // com : https://en.wikipedia.org/wiki/.com com // coop : https://en.wikipedia.org/wiki/.coop coop // cr : http://www.nic.cr/niccr_publico/showRegistroDominiosScreen.do cr ac.cr co.cr ed.cr fi.cr go.cr or.cr sa.cr // cu : https://en.wikipedia.org/wiki/.cu cu com.cu edu.cu org.cu net.cu gov.cu inf.cu // cv : https://en.wikipedia.org/wiki/.cv // cv : http://www.dns.cv/tldcv_portal/do?com=DS;5446457100;111;+PAGE(4000018)+K-CAT-CODIGO(RDOM)+RCNT(100); <- registration rules cv com.cv edu.cv int.cv nome.cv org.cv // cw : http://www.una.cw/cw_registry/ // Confirmed by registry 2013-03-26 cw com.cw edu.cw net.cw org.cw // cx : https://en.wikipedia.org/wiki/.cx // list of other 2nd level tlds ? cx gov.cx // cy : http://www.nic.cy/ // Submitted by registry Panayiotou Fotia cy ac.cy biz.cy com.cy ekloges.cy gov.cy ltd.cy name.cy net.cy org.cy parliament.cy press.cy pro.cy tm.cy // cz : https://en.wikipedia.org/wiki/.cz cz // de : https://en.wikipedia.org/wiki/.de // Confirmed by registry (with technical // reservations) 2008-07-01 de // dj : https://en.wikipedia.org/wiki/.dj dj // dk : https://en.wikipedia.org/wiki/.dk // Confirmed by registry 2008-06-17 dk // dm : https://en.wikipedia.org/wiki/.dm dm com.dm net.dm org.dm edu.dm gov.dm // do : https://en.wikipedia.org/wiki/.do do art.do com.do edu.do gob.do gov.do mil.do net.do org.do sld.do web.do // dz : http://www.nic.dz/images/pdf_nic/charte.pdf dz art.dz asso.dz com.dz edu.dz gov.dz org.dz net.dz pol.dz soc.dz tm.dz // ec : http://www.nic.ec/reg/paso1.asp // Submitted by registry ec com.ec info.ec net.ec fin.ec k12.ec med.ec pro.ec org.ec edu.ec gov.ec gob.ec mil.ec // edu : https://en.wikipedia.org/wiki/.edu edu // ee : http://www.eenet.ee/EENet/dom_reeglid.html#lisa_B ee edu.ee gov.ee riik.ee lib.ee med.ee com.ee pri.ee aip.ee org.ee fie.ee // eg : https://en.wikipedia.org/wiki/.eg eg com.eg edu.eg eun.eg gov.eg mil.eg name.eg net.eg org.eg sci.eg // er : https://en.wikipedia.org/wiki/.er *.er // es : https://www.nic.es/site_ingles/ingles/dominios/index.html es com.es nom.es org.es gob.es edu.es // et : https://en.wikipedia.org/wiki/.et et com.et gov.et org.et edu.et biz.et name.et info.et net.et // eu : https://en.wikipedia.org/wiki/.eu eu // fi : https://en.wikipedia.org/wiki/.fi fi // aland.fi : https://en.wikipedia.org/wiki/.ax // This domain is being phased out in favor of .ax. As there are still many // domains under aland.fi, we still keep it on the list until aland.fi is // completely removed. // TODO: Check for updates (expected to be phased out around Q1/2009) aland.fi // fj : http://domains.fj/ // Submitted by registry 2020-02-11 fj ac.fj biz.fj com.fj gov.fj info.fj mil.fj name.fj net.fj org.fj pro.fj // fk : https://en.wikipedia.org/wiki/.fk *.fk // fm : https://en.wikipedia.org/wiki/.fm com.fm edu.fm net.fm org.fm fm // fo : https://en.wikipedia.org/wiki/.fo fo // fr : http://www.afnic.fr/ // domaines descriptifs : https://www.afnic.fr/medias/documents/Cadre_legal/Afnic_Naming_Policy_12122016_VEN.pdf fr asso.fr com.fr gouv.fr nom.fr prd.fr tm.fr // domaines sectoriels : https://www.afnic.fr/en/products-and-services/the-fr-tld/sector-based-fr-domains-4.html aeroport.fr avocat.fr avoues.fr cci.fr chambagri.fr chirurgiens-dentistes.fr experts-comptables.fr geometre-expert.fr greta.fr huissier-justice.fr medecin.fr notaires.fr pharmacien.fr port.fr veterinaire.fr // ga : https://en.wikipedia.org/wiki/.ga ga // gb : This registry is effectively dormant // Submitted by registry gb // gd : https://en.wikipedia.org/wiki/.gd edu.gd gov.gd gd // ge : http://www.nic.net.ge/policy_en.pdf ge com.ge edu.ge gov.ge org.ge mil.ge net.ge pvt.ge // gf : https://en.wikipedia.org/wiki/.gf gf // gg : http://www.channelisles.net/register-domains/ // Confirmed by registry 2013-11-28 gg co.gg net.gg org.gg // gh : https://en.wikipedia.org/wiki/.gh // see also: http://www.nic.gh/reg_now.php // Although domains directly at second level are not possible at the moment, // they have been possible for some time and may come back. gh com.gh edu.gh gov.gh org.gh mil.gh // gi : http://www.nic.gi/rules.html gi com.gi ltd.gi gov.gi mod.gi edu.gi org.gi // gl : https://en.wikipedia.org/wiki/.gl // http://nic.gl gl co.gl com.gl edu.gl net.gl org.gl // gm : http://www.nic.gm/htmlpages%5Cgm-policy.htm gm // gn : http://psg.com/dns/gn/gn.txt // Submitted by registry gn ac.gn com.gn edu.gn gov.gn org.gn net.gn // gov : https://en.wikipedia.org/wiki/.gov gov // gp : http://www.nic.gp/index.php?lang=en gp com.gp net.gp mobi.gp edu.gp org.gp asso.gp // gq : https://en.wikipedia.org/wiki/.gq gq // gr : https://grweb.ics.forth.gr/english/1617-B-2005.html // Submitted by registry gr com.gr edu.gr net.gr org.gr gov.gr // gs : https://en.wikipedia.org/wiki/.gs gs // gt : https://www.gt/sitio/registration_policy.php?lang=en gt com.gt edu.gt gob.gt ind.gt mil.gt net.gt org.gt // gu : http://gadao.gov.gu/register.html // University of Guam : https://www.uog.edu // Submitted by uognoc@triton.uog.edu gu com.gu edu.gu gov.gu guam.gu info.gu net.gu org.gu web.gu // gw : https://en.wikipedia.org/wiki/.gw // gw : https://nic.gw/regras/ gw // gy : https://en.wikipedia.org/wiki/.gy // http://registry.gy/ gy co.gy com.gy edu.gy gov.gy net.gy org.gy // hk : https://www.hkirc.hk // Submitted by registry hk com.hk edu.hk gov.hk idv.hk net.hk org.hk 公司.hk 教育.hk 敎育.hk 政府.hk 個人.hk 个人.hk 箇人.hk 網络.hk 网络.hk 组織.hk 網絡.hk 网絡.hk 组织.hk 組織.hk 組织.hk // hm : https://en.wikipedia.org/wiki/.hm hm // hn : http://www.nic.hn/politicas/ps02,,05.html hn com.hn edu.hn org.hn net.hn mil.hn gob.hn // hr : http://www.dns.hr/documents/pdf/HRTLD-regulations.pdf hr iz.hr from.hr name.hr com.hr // ht : http://www.nic.ht/info/charte.cfm ht com.ht shop.ht firm.ht info.ht adult.ht net.ht pro.ht org.ht med.ht art.ht coop.ht pol.ht asso.ht edu.ht rel.ht gouv.ht perso.ht // hu : http://www.domain.hu/domain/English/sld.html // Confirmed by registry 2008-06-12 hu co.hu info.hu org.hu priv.hu sport.hu tm.hu 2000.hu agrar.hu bolt.hu casino.hu city.hu erotica.hu erotika.hu film.hu forum.hu games.hu hotel.hu ingatlan.hu jogasz.hu konyvelo.hu lakas.hu media.hu news.hu reklam.hu sex.hu shop.hu suli.hu szex.hu tozsde.hu utazas.hu video.hu // id : https://pandi.id/en/domain/registration-requirements/ id ac.id biz.id co.id desa.id go.id mil.id my.id net.id or.id ponpes.id sch.id web.id // ie : https://en.wikipedia.org/wiki/.ie ie gov.ie // il : http://www.isoc.org.il/domains/ il ac.il co.il gov.il idf.il k12.il muni.il net.il org.il // im : https://www.nic.im/ // Submitted by registry im ac.im co.im com.im ltd.co.im net.im org.im plc.co.im tt.im tv.im // in : https://en.wikipedia.org/wiki/.in // see also: https://registry.in/Policies // Please note, that nic.in is not an official eTLD, but used by most // government institutions. in co.in firm.in net.in org.in gen.in ind.in nic.in ac.in edu.in res.in gov.in mil.in // info : https://en.wikipedia.org/wiki/.info info // int : https://en.wikipedia.org/wiki/.int // Confirmed by registry 2008-06-18 int eu.int // io : http://www.nic.io/rules.html // list of other 2nd level tlds ? io com.io // iq : http://www.cmc.iq/english/iq/iqregister1.htm iq gov.iq edu.iq mil.iq com.iq org.iq net.iq // ir : http://www.nic.ir/Terms_and_Conditions_ir,_Appendix_1_Domain_Rules // Also see http://www.nic.ir/Internationalized_Domain_Names // Two .ir entries added at request of , 2010-04-16 ir ac.ir co.ir gov.ir id.ir net.ir org.ir sch.ir // xn--mgba3a4f16a.ir (.ir, Persian YEH) ایران.ir // xn--mgba3a4fra.ir (.ir, Arabic YEH) ايران.ir // is : http://www.isnic.is/domain/rules.php // Confirmed by registry 2008-12-06 is net.is com.is edu.is gov.is org.is int.is // it : https://en.wikipedia.org/wiki/.it it gov.it edu.it // Reserved geo-names (regions and provinces): // https://www.nic.it/sites/default/files/archivio/docs/Regulation_assignation_v7.1.pdf // Regions abr.it abruzzo.it aosta-valley.it aostavalley.it bas.it basilicata.it cal.it calabria.it cam.it campania.it emilia-romagna.it emiliaromagna.it emr.it friuli-v-giulia.it friuli-ve-giulia.it friuli-vegiulia.it friuli-venezia-giulia.it friuli-veneziagiulia.it friuli-vgiulia.it friuliv-giulia.it friulive-giulia.it friulivegiulia.it friulivenezia-giulia.it friuliveneziagiulia.it friulivgiulia.it fvg.it laz.it lazio.it lig.it liguria.it lom.it lombardia.it lombardy.it lucania.it mar.it marche.it mol.it molise.it piedmont.it piemonte.it pmn.it pug.it puglia.it sar.it sardegna.it sardinia.it sic.it sicilia.it sicily.it taa.it tos.it toscana.it trentin-sud-tirol.it trentin-süd-tirol.it trentin-sudtirol.it trentin-südtirol.it trentin-sued-tirol.it trentin-suedtirol.it trentino-a-adige.it trentino-aadige.it trentino-alto-adige.it trentino-altoadige.it trentino-s-tirol.it trentino-stirol.it trentino-sud-tirol.it trentino-süd-tirol.it trentino-sudtirol.it trentino-südtirol.it trentino-sued-tirol.it trentino-suedtirol.it trentino.it trentinoa-adige.it trentinoaadige.it trentinoalto-adige.it trentinoaltoadige.it trentinos-tirol.it trentinostirol.it trentinosud-tirol.it trentinosüd-tirol.it trentinosudtirol.it trentinosüdtirol.it trentinosued-tirol.it trentinosuedtirol.it trentinsud-tirol.it trentinsüd-tirol.it trentinsudtirol.it trentinsüdtirol.it trentinsued-tirol.it trentinsuedtirol.it tuscany.it umb.it umbria.it val-d-aosta.it val-daosta.it vald-aosta.it valdaosta.it valle-aosta.it valle-d-aosta.it valle-daosta.it valleaosta.it valled-aosta.it valledaosta.it vallee-aoste.it vallée-aoste.it vallee-d-aoste.it vallée-d-aoste.it valleeaoste.it valléeaoste.it valleedaoste.it valléedaoste.it vao.it vda.it ven.it veneto.it // Provinces ag.it agrigento.it al.it alessandria.it alto-adige.it altoadige.it an.it ancona.it andria-barletta-trani.it andria-trani-barletta.it andriabarlettatrani.it andriatranibarletta.it ao.it aosta.it aoste.it ap.it aq.it aquila.it ar.it arezzo.it ascoli-piceno.it ascolipiceno.it asti.it at.it av.it avellino.it ba.it balsan-sudtirol.it balsan-südtirol.it balsan-suedtirol.it balsan.it bari.it barletta-trani-andria.it barlettatraniandria.it belluno.it benevento.it bergamo.it bg.it bi.it biella.it bl.it bn.it bo.it bologna.it bolzano-altoadige.it bolzano.it bozen-sudtirol.it bozen-südtirol.it bozen-suedtirol.it bozen.it br.it brescia.it brindisi.it bs.it bt.it bulsan-sudtirol.it bulsan-südtirol.it bulsan-suedtirol.it bulsan.it bz.it ca.it cagliari.it caltanissetta.it campidano-medio.it campidanomedio.it campobasso.it carbonia-iglesias.it carboniaiglesias.it carrara-massa.it carraramassa.it caserta.it catania.it catanzaro.it cb.it ce.it cesena-forli.it cesena-forlì.it cesenaforli.it cesenaforlì.it ch.it chieti.it ci.it cl.it cn.it co.it como.it cosenza.it cr.it cremona.it crotone.it cs.it ct.it cuneo.it cz.it dell-ogliastra.it dellogliastra.it en.it enna.it fc.it fe.it fermo.it ferrara.it fg.it fi.it firenze.it florence.it fm.it foggia.it forli-cesena.it forlì-cesena.it forlicesena.it forlìcesena.it fr.it frosinone.it ge.it genoa.it genova.it go.it gorizia.it gr.it grosseto.it iglesias-carbonia.it iglesiascarbonia.it im.it imperia.it is.it isernia.it kr.it la-spezia.it laquila.it laspezia.it latina.it lc.it le.it lecce.it lecco.it li.it livorno.it lo.it lodi.it lt.it lu.it lucca.it macerata.it mantova.it massa-carrara.it massacarrara.it matera.it mb.it mc.it me.it medio-campidano.it mediocampidano.it messina.it mi.it milan.it milano.it mn.it mo.it modena.it monza-brianza.it monza-e-della-brianza.it monza.it monzabrianza.it monzaebrianza.it monzaedellabrianza.it ms.it mt.it na.it naples.it napoli.it no.it novara.it nu.it nuoro.it og.it ogliastra.it olbia-tempio.it olbiatempio.it or.it oristano.it ot.it pa.it padova.it padua.it palermo.it parma.it pavia.it pc.it pd.it pe.it perugia.it pesaro-urbino.it pesarourbino.it pescara.it pg.it pi.it piacenza.it pisa.it pistoia.it pn.it po.it pordenone.it potenza.it pr.it prato.it pt.it pu.it pv.it pz.it ra.it ragusa.it ravenna.it rc.it re.it reggio-calabria.it reggio-emilia.it reggiocalabria.it reggioemilia.it rg.it ri.it rieti.it rimini.it rm.it rn.it ro.it roma.it rome.it rovigo.it sa.it salerno.it sassari.it savona.it si.it siena.it siracusa.it so.it sondrio.it sp.it sr.it ss.it suedtirol.it südtirol.it sv.it ta.it taranto.it te.it tempio-olbia.it tempioolbia.it teramo.it terni.it tn.it to.it torino.it tp.it tr.it trani-andria-barletta.it trani-barletta-andria.it traniandriabarletta.it tranibarlettaandria.it trapani.it trento.it treviso.it trieste.it ts.it turin.it tv.it ud.it udine.it urbino-pesaro.it urbinopesaro.it va.it varese.it vb.it vc.it ve.it venezia.it venice.it verbania.it vercelli.it verona.it vi.it vibo-valentia.it vibovalentia.it vicenza.it viterbo.it vr.it vs.it vt.it vv.it // je : http://www.channelisles.net/register-domains/ // Confirmed by registry 2013-11-28 je co.je net.je org.je // jm : http://www.com.jm/register.html *.jm // jo : http://www.dns.jo/Registration_policy.aspx jo com.jo org.jo net.jo edu.jo sch.jo gov.jo mil.jo name.jo // jobs : https://en.wikipedia.org/wiki/.jobs jobs // jp : https://en.wikipedia.org/wiki/.jp // http://jprs.co.jp/en/jpdomain.html // Submitted by registry jp // jp organizational type names ac.jp ad.jp co.jp ed.jp go.jp gr.jp lg.jp ne.jp or.jp // jp prefecture type names aichi.jp akita.jp aomori.jp chiba.jp ehime.jp fukui.jp fukuoka.jp fukushima.jp gifu.jp gunma.jp hiroshima.jp hokkaido.jp hyogo.jp ibaraki.jp ishikawa.jp iwate.jp kagawa.jp kagoshima.jp kanagawa.jp kochi.jp kumamoto.jp kyoto.jp mie.jp miyagi.jp miyazaki.jp nagano.jp nagasaki.jp nara.jp niigata.jp oita.jp okayama.jp okinawa.jp osaka.jp saga.jp saitama.jp shiga.jp shimane.jp shizuoka.jp tochigi.jp tokushima.jp tokyo.jp tottori.jp toyama.jp wakayama.jp yamagata.jp yamaguchi.jp yamanashi.jp 栃木.jp 愛知.jp 愛媛.jp 兵庫.jp 熊本.jp 茨城.jp 北海道.jp 千葉.jp 和歌山.jp 長崎.jp 長野.jp 新潟.jp 青森.jp 静岡.jp 東京.jp 石川.jp 埼玉.jp 三重.jp 京都.jp 佐賀.jp 大分.jp 大阪.jp 奈良.jp 宮城.jp 宮崎.jp 富山.jp 山口.jp 山形.jp 山梨.jp 岩手.jp 岐阜.jp 岡山.jp 島根.jp 広島.jp 徳島.jp 沖縄.jp 滋賀.jp 神奈川.jp 福井.jp 福岡.jp 福島.jp 秋田.jp 群馬.jp 香川.jp 高知.jp 鳥取.jp 鹿児島.jp // jp geographic type names // http://jprs.jp/doc/rule/saisoku-1.html *.kawasaki.jp *.kitakyushu.jp *.kobe.jp *.nagoya.jp *.sapporo.jp *.sendai.jp *.yokohama.jp !city.kawasaki.jp !city.kitakyushu.jp !city.kobe.jp !city.nagoya.jp !city.sapporo.jp !city.sendai.jp !city.yokohama.jp // 4th level registration aisai.aichi.jp ama.aichi.jp anjo.aichi.jp asuke.aichi.jp chiryu.aichi.jp chita.aichi.jp fuso.aichi.jp gamagori.aichi.jp handa.aichi.jp hazu.aichi.jp hekinan.aichi.jp higashiura.aichi.jp ichinomiya.aichi.jp inazawa.aichi.jp inuyama.aichi.jp isshiki.aichi.jp iwakura.aichi.jp kanie.aichi.jp kariya.aichi.jp kasugai.aichi.jp kira.aichi.jp kiyosu.aichi.jp komaki.aichi.jp konan.aichi.jp kota.aichi.jp mihama.aichi.jp miyoshi.aichi.jp nishio.aichi.jp nisshin.aichi.jp obu.aichi.jp oguchi.aichi.jp oharu.aichi.jp okazaki.aichi.jp owariasahi.aichi.jp seto.aichi.jp shikatsu.aichi.jp shinshiro.aichi.jp shitara.aichi.jp tahara.aichi.jp takahama.aichi.jp tobishima.aichi.jp toei.aichi.jp togo.aichi.jp tokai.aichi.jp tokoname.aichi.jp toyoake.aichi.jp toyohashi.aichi.jp toyokawa.aichi.jp toyone.aichi.jp toyota.aichi.jp tsushima.aichi.jp yatomi.aichi.jp akita.akita.jp daisen.akita.jp fujisato.akita.jp gojome.akita.jp hachirogata.akita.jp happou.akita.jp higashinaruse.akita.jp honjo.akita.jp honjyo.akita.jp ikawa.akita.jp kamikoani.akita.jp kamioka.akita.jp katagami.akita.jp kazuno.akita.jp kitaakita.akita.jp kosaka.akita.jp kyowa.akita.jp misato.akita.jp mitane.akita.jp moriyoshi.akita.jp nikaho.akita.jp noshiro.akita.jp odate.akita.jp oga.akita.jp ogata.akita.jp semboku.akita.jp yokote.akita.jp yurihonjo.akita.jp aomori.aomori.jp gonohe.aomori.jp hachinohe.aomori.jp hashikami.aomori.jp hiranai.aomori.jp hirosaki.aomori.jp itayanagi.aomori.jp kuroishi.aomori.jp misawa.aomori.jp mutsu.aomori.jp nakadomari.aomori.jp noheji.aomori.jp oirase.aomori.jp owani.aomori.jp rokunohe.aomori.jp sannohe.aomori.jp shichinohe.aomori.jp shingo.aomori.jp takko.aomori.jp towada.aomori.jp tsugaru.aomori.jp tsuruta.aomori.jp abiko.chiba.jp asahi.chiba.jp chonan.chiba.jp chosei.chiba.jp choshi.chiba.jp chuo.chiba.jp funabashi.chiba.jp futtsu.chiba.jp hanamigawa.chiba.jp ichihara.chiba.jp ichikawa.chiba.jp ichinomiya.chiba.jp inzai.chiba.jp isumi.chiba.jp kamagaya.chiba.jp kamogawa.chiba.jp kashiwa.chiba.jp katori.chiba.jp katsuura.chiba.jp kimitsu.chiba.jp kisarazu.chiba.jp kozaki.chiba.jp kujukuri.chiba.jp kyonan.chiba.jp matsudo.chiba.jp midori.chiba.jp mihama.chiba.jp minamiboso.chiba.jp mobara.chiba.jp mutsuzawa.chiba.jp nagara.chiba.jp nagareyama.chiba.jp narashino.chiba.jp narita.chiba.jp noda.chiba.jp oamishirasato.chiba.jp omigawa.chiba.jp onjuku.chiba.jp otaki.chiba.jp sakae.chiba.jp sakura.chiba.jp shimofusa.chiba.jp shirako.chiba.jp shiroi.chiba.jp shisui.chiba.jp sodegaura.chiba.jp sosa.chiba.jp tako.chiba.jp tateyama.chiba.jp togane.chiba.jp tohnosho.chiba.jp tomisato.chiba.jp urayasu.chiba.jp yachimata.chiba.jp yachiyo.chiba.jp yokaichiba.chiba.jp yokoshibahikari.chiba.jp yotsukaido.chiba.jp ainan.ehime.jp honai.ehime.jp ikata.ehime.jp imabari.ehime.jp iyo.ehime.jp kamijima.ehime.jp kihoku.ehime.jp kumakogen.ehime.jp masaki.ehime.jp matsuno.ehime.jp matsuyama.ehime.jp namikata.ehime.jp niihama.ehime.jp ozu.ehime.jp saijo.ehime.jp seiyo.ehime.jp shikokuchuo.ehime.jp tobe.ehime.jp toon.ehime.jp uchiko.ehime.jp uwajima.ehime.jp yawatahama.ehime.jp echizen.fukui.jp eiheiji.fukui.jp fukui.fukui.jp ikeda.fukui.jp katsuyama.fukui.jp mihama.fukui.jp minamiechizen.fukui.jp obama.fukui.jp ohi.fukui.jp ono.fukui.jp sabae.fukui.jp sakai.fukui.jp takahama.fukui.jp tsuruga.fukui.jp wakasa.fukui.jp ashiya.fukuoka.jp buzen.fukuoka.jp chikugo.fukuoka.jp chikuho.fukuoka.jp chikujo.fukuoka.jp chikushino.fukuoka.jp chikuzen.fukuoka.jp chuo.fukuoka.jp dazaifu.fukuoka.jp fukuchi.fukuoka.jp hakata.fukuoka.jp higashi.fukuoka.jp hirokawa.fukuoka.jp hisayama.fukuoka.jp iizuka.fukuoka.jp inatsuki.fukuoka.jp kaho.fukuoka.jp kasuga.fukuoka.jp kasuya.fukuoka.jp kawara.fukuoka.jp keisen.fukuoka.jp koga.fukuoka.jp kurate.fukuoka.jp kurogi.fukuoka.jp kurume.fukuoka.jp minami.fukuoka.jp miyako.fukuoka.jp miyama.fukuoka.jp miyawaka.fukuoka.jp mizumaki.fukuoka.jp munakata.fukuoka.jp nakagawa.fukuoka.jp nakama.fukuoka.jp nishi.fukuoka.jp nogata.fukuoka.jp ogori.fukuoka.jp okagaki.fukuoka.jp okawa.fukuoka.jp oki.fukuoka.jp omuta.fukuoka.jp onga.fukuoka.jp onojo.fukuoka.jp oto.fukuoka.jp saigawa.fukuoka.jp sasaguri.fukuoka.jp shingu.fukuoka.jp shinyoshitomi.fukuoka.jp shonai.fukuoka.jp soeda.fukuoka.jp sue.fukuoka.jp tachiarai.fukuoka.jp tagawa.fukuoka.jp takata.fukuoka.jp toho.fukuoka.jp toyotsu.fukuoka.jp tsuiki.fukuoka.jp ukiha.fukuoka.jp umi.fukuoka.jp usui.fukuoka.jp yamada.fukuoka.jp yame.fukuoka.jp yanagawa.fukuoka.jp yukuhashi.fukuoka.jp aizubange.fukushima.jp aizumisato.fukushima.jp aizuwakamatsu.fukushima.jp asakawa.fukushima.jp bandai.fukushima.jp date.fukushima.jp fukushima.fukushima.jp furudono.fukushima.jp futaba.fukushima.jp hanawa.fukushima.jp higashi.fukushima.jp hirata.fukushima.jp hirono.fukushima.jp iitate.fukushima.jp inawashiro.fukushima.jp ishikawa.fukushima.jp iwaki.fukushima.jp izumizaki.fukushima.jp kagamiishi.fukushima.jp kaneyama.fukushima.jp kawamata.fukushima.jp kitakata.fukushima.jp kitashiobara.fukushima.jp koori.fukushima.jp koriyama.fukushima.jp kunimi.fukushima.jp miharu.fukushima.jp mishima.fukushima.jp namie.fukushima.jp nango.fukushima.jp nishiaizu.fukushima.jp nishigo.fukushima.jp okuma.fukushima.jp omotego.fukushima.jp ono.fukushima.jp otama.fukushima.jp samegawa.fukushima.jp shimogo.fukushima.jp shirakawa.fukushima.jp showa.fukushima.jp soma.fukushima.jp sukagawa.fukushima.jp taishin.fukushima.jp tamakawa.fukushima.jp tanagura.fukushima.jp tenei.fukushima.jp yabuki.fukushima.jp yamato.fukushima.jp yamatsuri.fukushima.jp yanaizu.fukushima.jp yugawa.fukushima.jp anpachi.gifu.jp ena.gifu.jp gifu.gifu.jp ginan.gifu.jp godo.gifu.jp gujo.gifu.jp hashima.gifu.jp hichiso.gifu.jp hida.gifu.jp higashishirakawa.gifu.jp ibigawa.gifu.jp ikeda.gifu.jp kakamigahara.gifu.jp kani.gifu.jp kasahara.gifu.jp kasamatsu.gifu.jp kawaue.gifu.jp kitagata.gifu.jp mino.gifu.jp minokamo.gifu.jp mitake.gifu.jp mizunami.gifu.jp motosu.gifu.jp nakatsugawa.gifu.jp ogaki.gifu.jp sakahogi.gifu.jp seki.gifu.jp sekigahara.gifu.jp shirakawa.gifu.jp tajimi.gifu.jp takayama.gifu.jp tarui.gifu.jp toki.gifu.jp tomika.gifu.jp wanouchi.gifu.jp yamagata.gifu.jp yaotsu.gifu.jp yoro.gifu.jp annaka.gunma.jp chiyoda.gunma.jp fujioka.gunma.jp higashiagatsuma.gunma.jp isesaki.gunma.jp itakura.gunma.jp kanna.gunma.jp kanra.gunma.jp katashina.gunma.jp kawaba.gunma.jp kiryu.gunma.jp kusatsu.gunma.jp maebashi.gunma.jp meiwa.gunma.jp midori.gunma.jp minakami.gunma.jp naganohara.gunma.jp nakanojo.gunma.jp nanmoku.gunma.jp numata.gunma.jp oizumi.gunma.jp ora.gunma.jp ota.gunma.jp shibukawa.gunma.jp shimonita.gunma.jp shinto.gunma.jp showa.gunma.jp takasaki.gunma.jp takayama.gunma.jp tamamura.gunma.jp tatebayashi.gunma.jp tomioka.gunma.jp tsukiyono.gunma.jp tsumagoi.gunma.jp ueno.gunma.jp yoshioka.gunma.jp asaminami.hiroshima.jp daiwa.hiroshima.jp etajima.hiroshima.jp fuchu.hiroshima.jp fukuyama.hiroshima.jp hatsukaichi.hiroshima.jp higashihiroshima.hiroshima.jp hongo.hiroshima.jp jinsekikogen.hiroshima.jp kaita.hiroshima.jp kui.hiroshima.jp kumano.hiroshima.jp kure.hiroshima.jp mihara.hiroshima.jp miyoshi.hiroshima.jp naka.hiroshima.jp onomichi.hiroshima.jp osakikamijima.hiroshima.jp otake.hiroshima.jp saka.hiroshima.jp sera.hiroshima.jp seranishi.hiroshima.jp shinichi.hiroshima.jp shobara.hiroshima.jp takehara.hiroshima.jp abashiri.hokkaido.jp abira.hokkaido.jp aibetsu.hokkaido.jp akabira.hokkaido.jp akkeshi.hokkaido.jp asahikawa.hokkaido.jp ashibetsu.hokkaido.jp ashoro.hokkaido.jp assabu.hokkaido.jp atsuma.hokkaido.jp bibai.hokkaido.jp biei.hokkaido.jp bifuka.hokkaido.jp bihoro.hokkaido.jp biratori.hokkaido.jp chippubetsu.hokkaido.jp chitose.hokkaido.jp date.hokkaido.jp ebetsu.hokkaido.jp embetsu.hokkaido.jp eniwa.hokkaido.jp erimo.hokkaido.jp esan.hokkaido.jp esashi.hokkaido.jp fukagawa.hokkaido.jp fukushima.hokkaido.jp furano.hokkaido.jp furubira.hokkaido.jp haboro.hokkaido.jp hakodate.hokkaido.jp hamatonbetsu.hokkaido.jp hidaka.hokkaido.jp higashikagura.hokkaido.jp higashikawa.hokkaido.jp hiroo.hokkaido.jp hokuryu.hokkaido.jp hokuto.hokkaido.jp honbetsu.hokkaido.jp horokanai.hokkaido.jp horonobe.hokkaido.jp ikeda.hokkaido.jp imakane.hokkaido.jp ishikari.hokkaido.jp iwamizawa.hokkaido.jp iwanai.hokkaido.jp kamifurano.hokkaido.jp kamikawa.hokkaido.jp kamishihoro.hokkaido.jp kamisunagawa.hokkaido.jp kamoenai.hokkaido.jp kayabe.hokkaido.jp kembuchi.hokkaido.jp kikonai.hokkaido.jp kimobetsu.hokkaido.jp kitahiroshima.hokkaido.jp kitami.hokkaido.jp kiyosato.hokkaido.jp koshimizu.hokkaido.jp kunneppu.hokkaido.jp kuriyama.hokkaido.jp kuromatsunai.hokkaido.jp kushiro.hokkaido.jp kutchan.hokkaido.jp kyowa.hokkaido.jp mashike.hokkaido.jp matsumae.hokkaido.jp mikasa.hokkaido.jp minamifurano.hokkaido.jp mombetsu.hokkaido.jp moseushi.hokkaido.jp mukawa.hokkaido.jp muroran.hokkaido.jp naie.hokkaido.jp nakagawa.hokkaido.jp nakasatsunai.hokkaido.jp nakatombetsu.hokkaido.jp nanae.hokkaido.jp nanporo.hokkaido.jp nayoro.hokkaido.jp nemuro.hokkaido.jp niikappu.hokkaido.jp niki.hokkaido.jp nishiokoppe.hokkaido.jp noboribetsu.hokkaido.jp numata.hokkaido.jp obihiro.hokkaido.jp obira.hokkaido.jp oketo.hokkaido.jp okoppe.hokkaido.jp otaru.hokkaido.jp otobe.hokkaido.jp otofuke.hokkaido.jp otoineppu.hokkaido.jp oumu.hokkaido.jp ozora.hokkaido.jp pippu.hokkaido.jp rankoshi.hokkaido.jp rebun.hokkaido.jp rikubetsu.hokkaido.jp rishiri.hokkaido.jp rishirifuji.hokkaido.jp saroma.hokkaido.jp sarufutsu.hokkaido.jp shakotan.hokkaido.jp shari.hokkaido.jp shibecha.hokkaido.jp shibetsu.hokkaido.jp shikabe.hokkaido.jp shikaoi.hokkaido.jp shimamaki.hokkaido.jp shimizu.hokkaido.jp shimokawa.hokkaido.jp shinshinotsu.hokkaido.jp shintoku.hokkaido.jp shiranuka.hokkaido.jp shiraoi.hokkaido.jp shiriuchi.hokkaido.jp sobetsu.hokkaido.jp sunagawa.hokkaido.jp taiki.hokkaido.jp takasu.hokkaido.jp takikawa.hokkaido.jp takinoue.hokkaido.jp teshikaga.hokkaido.jp tobetsu.hokkaido.jp tohma.hokkaido.jp tomakomai.hokkaido.jp tomari.hokkaido.jp toya.hokkaido.jp toyako.hokkaido.jp toyotomi.hokkaido.jp toyoura.hokkaido.jp tsubetsu.hokkaido.jp tsukigata.hokkaido.jp urakawa.hokkaido.jp urausu.hokkaido.jp uryu.hokkaido.jp utashinai.hokkaido.jp wakkanai.hokkaido.jp wassamu.hokkaido.jp yakumo.hokkaido.jp yoichi.hokkaido.jp aioi.hyogo.jp akashi.hyogo.jp ako.hyogo.jp amagasaki.hyogo.jp aogaki.hyogo.jp asago.hyogo.jp ashiya.hyogo.jp awaji.hyogo.jp fukusaki.hyogo.jp goshiki.hyogo.jp harima.hyogo.jp himeji.hyogo.jp ichikawa.hyogo.jp inagawa.hyogo.jp itami.hyogo.jp kakogawa.hyogo.jp kamigori.hyogo.jp kamikawa.hyogo.jp kasai.hyogo.jp kasuga.hyogo.jp kawanishi.hyogo.jp miki.hyogo.jp minamiawaji.hyogo.jp nishinomiya.hyogo.jp nishiwaki.hyogo.jp ono.hyogo.jp sanda.hyogo.jp sannan.hyogo.jp sasayama.hyogo.jp sayo.hyogo.jp shingu.hyogo.jp shinonsen.hyogo.jp shiso.hyogo.jp sumoto.hyogo.jp taishi.hyogo.jp taka.hyogo.jp takarazuka.hyogo.jp takasago.hyogo.jp takino.hyogo.jp tamba.hyogo.jp tatsuno.hyogo.jp toyooka.hyogo.jp yabu.hyogo.jp yashiro.hyogo.jp yoka.hyogo.jp yokawa.hyogo.jp ami.ibaraki.jp asahi.ibaraki.jp bando.ibaraki.jp chikusei.ibaraki.jp daigo.ibaraki.jp fujishiro.ibaraki.jp hitachi.ibaraki.jp hitachinaka.ibaraki.jp hitachiomiya.ibaraki.jp hitachiota.ibaraki.jp ibaraki.ibaraki.jp ina.ibaraki.jp inashiki.ibaraki.jp itako.ibaraki.jp iwama.ibaraki.jp joso.ibaraki.jp kamisu.ibaraki.jp kasama.ibaraki.jp kashima.ibaraki.jp kasumigaura.ibaraki.jp koga.ibaraki.jp miho.ibaraki.jp mito.ibaraki.jp moriya.ibaraki.jp naka.ibaraki.jp namegata.ibaraki.jp oarai.ibaraki.jp ogawa.ibaraki.jp omitama.ibaraki.jp ryugasaki.ibaraki.jp sakai.ibaraki.jp sakuragawa.ibaraki.jp shimodate.ibaraki.jp shimotsuma.ibaraki.jp shirosato.ibaraki.jp sowa.ibaraki.jp suifu.ibaraki.jp takahagi.ibaraki.jp tamatsukuri.ibaraki.jp tokai.ibaraki.jp tomobe.ibaraki.jp tone.ibaraki.jp toride.ibaraki.jp tsuchiura.ibaraki.jp tsukuba.ibaraki.jp uchihara.ibaraki.jp ushiku.ibaraki.jp yachiyo.ibaraki.jp yamagata.ibaraki.jp yawara.ibaraki.jp yuki.ibaraki.jp anamizu.ishikawa.jp hakui.ishikawa.jp hakusan.ishikawa.jp kaga.ishikawa.jp kahoku.ishikawa.jp kanazawa.ishikawa.jp kawakita.ishikawa.jp komatsu.ishikawa.jp nakanoto.ishikawa.jp nanao.ishikawa.jp nomi.ishikawa.jp nonoichi.ishikawa.jp noto.ishikawa.jp shika.ishikawa.jp suzu.ishikawa.jp tsubata.ishikawa.jp tsurugi.ishikawa.jp uchinada.ishikawa.jp wajima.ishikawa.jp fudai.iwate.jp fujisawa.iwate.jp hanamaki.iwate.jp hiraizumi.iwate.jp hirono.iwate.jp ichinohe.iwate.jp ichinoseki.iwate.jp iwaizumi.iwate.jp iwate.iwate.jp joboji.iwate.jp kamaishi.iwate.jp kanegasaki.iwate.jp karumai.iwate.jp kawai.iwate.jp kitakami.iwate.jp kuji.iwate.jp kunohe.iwate.jp kuzumaki.iwate.jp miyako.iwate.jp mizusawa.iwate.jp morioka.iwate.jp ninohe.iwate.jp noda.iwate.jp ofunato.iwate.jp oshu.iwate.jp otsuchi.iwate.jp rikuzentakata.iwate.jp shiwa.iwate.jp shizukuishi.iwate.jp sumita.iwate.jp tanohata.iwate.jp tono.iwate.jp yahaba.iwate.jp yamada.iwate.jp ayagawa.kagawa.jp higashikagawa.kagawa.jp kanonji.kagawa.jp kotohira.kagawa.jp manno.kagawa.jp marugame.kagawa.jp mitoyo.kagawa.jp naoshima.kagawa.jp sanuki.kagawa.jp tadotsu.kagawa.jp takamatsu.kagawa.jp tonosho.kagawa.jp uchinomi.kagawa.jp utazu.kagawa.jp zentsuji.kagawa.jp akune.kagoshima.jp amami.kagoshima.jp hioki.kagoshima.jp isa.kagoshima.jp isen.kagoshima.jp izumi.kagoshima.jp kagoshima.kagoshima.jp kanoya.kagoshima.jp kawanabe.kagoshima.jp kinko.kagoshima.jp kouyama.kagoshima.jp makurazaki.kagoshima.jp matsumoto.kagoshima.jp minamitane.kagoshima.jp nakatane.kagoshima.jp nishinoomote.kagoshima.jp satsumasendai.kagoshima.jp soo.kagoshima.jp tarumizu.kagoshima.jp yusui.kagoshima.jp aikawa.kanagawa.jp atsugi.kanagawa.jp ayase.kanagawa.jp chigasaki.kanagawa.jp ebina.kanagawa.jp fujisawa.kanagawa.jp hadano.kanagawa.jp hakone.kanagawa.jp hiratsuka.kanagawa.jp isehara.kanagawa.jp kaisei.kanagawa.jp kamakura.kanagawa.jp kiyokawa.kanagawa.jp matsuda.kanagawa.jp minamiashigara.kanagawa.jp miura.kanagawa.jp nakai.kanagawa.jp ninomiya.kanagawa.jp odawara.kanagawa.jp oi.kanagawa.jp oiso.kanagawa.jp sagamihara.kanagawa.jp samukawa.kanagawa.jp tsukui.kanagawa.jp yamakita.kanagawa.jp yamato.kanagawa.jp yokosuka.kanagawa.jp yugawara.kanagawa.jp zama.kanagawa.jp zushi.kanagawa.jp aki.kochi.jp geisei.kochi.jp hidaka.kochi.jp higashitsuno.kochi.jp ino.kochi.jp kagami.kochi.jp kami.kochi.jp kitagawa.kochi.jp kochi.kochi.jp mihara.kochi.jp motoyama.kochi.jp muroto.kochi.jp nahari.kochi.jp nakamura.kochi.jp nankoku.kochi.jp nishitosa.kochi.jp niyodogawa.kochi.jp ochi.kochi.jp okawa.kochi.jp otoyo.kochi.jp otsuki.kochi.jp sakawa.kochi.jp sukumo.kochi.jp susaki.kochi.jp tosa.kochi.jp tosashimizu.kochi.jp toyo.kochi.jp tsuno.kochi.jp umaji.kochi.jp yasuda.kochi.jp yusuhara.kochi.jp amakusa.kumamoto.jp arao.kumamoto.jp aso.kumamoto.jp choyo.kumamoto.jp gyokuto.kumamoto.jp kamiamakusa.kumamoto.jp kikuchi.kumamoto.jp kumamoto.kumamoto.jp mashiki.kumamoto.jp mifune.kumamoto.jp minamata.kumamoto.jp minamioguni.kumamoto.jp nagasu.kumamoto.jp nishihara.kumamoto.jp oguni.kumamoto.jp ozu.kumamoto.jp sumoto.kumamoto.jp takamori.kumamoto.jp uki.kumamoto.jp uto.kumamoto.jp yamaga.kumamoto.jp yamato.kumamoto.jp yatsushiro.kumamoto.jp ayabe.kyoto.jp fukuchiyama.kyoto.jp higashiyama.kyoto.jp ide.kyoto.jp ine.kyoto.jp joyo.kyoto.jp kameoka.kyoto.jp kamo.kyoto.jp kita.kyoto.jp kizu.kyoto.jp kumiyama.kyoto.jp kyotamba.kyoto.jp kyotanabe.kyoto.jp kyotango.kyoto.jp maizuru.kyoto.jp minami.kyoto.jp minamiyamashiro.kyoto.jp miyazu.kyoto.jp muko.kyoto.jp nagaokakyo.kyoto.jp nakagyo.kyoto.jp nantan.kyoto.jp oyamazaki.kyoto.jp sakyo.kyoto.jp seika.kyoto.jp tanabe.kyoto.jp uji.kyoto.jp ujitawara.kyoto.jp wazuka.kyoto.jp yamashina.kyoto.jp yawata.kyoto.jp asahi.mie.jp inabe.mie.jp ise.mie.jp kameyama.mie.jp kawagoe.mie.jp kiho.mie.jp kisosaki.mie.jp kiwa.mie.jp komono.mie.jp kumano.mie.jp kuwana.mie.jp matsusaka.mie.jp meiwa.mie.jp mihama.mie.jp minamiise.mie.jp misugi.mie.jp miyama.mie.jp nabari.mie.jp shima.mie.jp suzuka.mie.jp tado.mie.jp taiki.mie.jp taki.mie.jp tamaki.mie.jp toba.mie.jp tsu.mie.jp udono.mie.jp ureshino.mie.jp watarai.mie.jp yokkaichi.mie.jp furukawa.miyagi.jp higashimatsushima.miyagi.jp ishinomaki.miyagi.jp iwanuma.miyagi.jp kakuda.miyagi.jp kami.miyagi.jp kawasaki.miyagi.jp marumori.miyagi.jp matsushima.miyagi.jp minamisanriku.miyagi.jp misato.miyagi.jp murata.miyagi.jp natori.miyagi.jp ogawara.miyagi.jp ohira.miyagi.jp onagawa.miyagi.jp osaki.miyagi.jp rifu.miyagi.jp semine.miyagi.jp shibata.miyagi.jp shichikashuku.miyagi.jp shikama.miyagi.jp shiogama.miyagi.jp shiroishi.miyagi.jp tagajo.miyagi.jp taiwa.miyagi.jp tome.miyagi.jp tomiya.miyagi.jp wakuya.miyagi.jp watari.miyagi.jp yamamoto.miyagi.jp zao.miyagi.jp aya.miyazaki.jp ebino.miyazaki.jp gokase.miyazaki.jp hyuga.miyazaki.jp kadogawa.miyazaki.jp kawaminami.miyazaki.jp kijo.miyazaki.jp kitagawa.miyazaki.jp kitakata.miyazaki.jp kitaura.miyazaki.jp kobayashi.miyazaki.jp kunitomi.miyazaki.jp kushima.miyazaki.jp mimata.miyazaki.jp miyakonojo.miyazaki.jp miyazaki.miyazaki.jp morotsuka.miyazaki.jp nichinan.miyazaki.jp nishimera.miyazaki.jp nobeoka.miyazaki.jp saito.miyazaki.jp shiiba.miyazaki.jp shintomi.miyazaki.jp takaharu.miyazaki.jp takanabe.miyazaki.jp takazaki.miyazaki.jp tsuno.miyazaki.jp achi.nagano.jp agematsu.nagano.jp anan.nagano.jp aoki.nagano.jp asahi.nagano.jp azumino.nagano.jp chikuhoku.nagano.jp chikuma.nagano.jp chino.nagano.jp fujimi.nagano.jp hakuba.nagano.jp hara.nagano.jp hiraya.nagano.jp iida.nagano.jp iijima.nagano.jp iiyama.nagano.jp iizuna.nagano.jp ikeda.nagano.jp ikusaka.nagano.jp ina.nagano.jp karuizawa.nagano.jp kawakami.nagano.jp kiso.nagano.jp kisofukushima.nagano.jp kitaaiki.nagano.jp komagane.nagano.jp komoro.nagano.jp matsukawa.nagano.jp matsumoto.nagano.jp miasa.nagano.jp minamiaiki.nagano.jp minamimaki.nagano.jp minamiminowa.nagano.jp minowa.nagano.jp miyada.nagano.jp miyota.nagano.jp mochizuki.nagano.jp nagano.nagano.jp nagawa.nagano.jp nagiso.nagano.jp nakagawa.nagano.jp nakano.nagano.jp nozawaonsen.nagano.jp obuse.nagano.jp ogawa.nagano.jp okaya.nagano.jp omachi.nagano.jp omi.nagano.jp ookuwa.nagano.jp ooshika.nagano.jp otaki.nagano.jp otari.nagano.jp sakae.nagano.jp sakaki.nagano.jp saku.nagano.jp sakuho.nagano.jp shimosuwa.nagano.jp shinanomachi.nagano.jp shiojiri.nagano.jp suwa.nagano.jp suzaka.nagano.jp takagi.nagano.jp takamori.nagano.jp takayama.nagano.jp tateshina.nagano.jp tatsuno.nagano.jp togakushi.nagano.jp togura.nagano.jp tomi.nagano.jp ueda.nagano.jp wada.nagano.jp yamagata.nagano.jp yamanouchi.nagano.jp yasaka.nagano.jp yasuoka.nagano.jp chijiwa.nagasaki.jp futsu.nagasaki.jp goto.nagasaki.jp hasami.nagasaki.jp hirado.nagasaki.jp iki.nagasaki.jp isahaya.nagasaki.jp kawatana.nagasaki.jp kuchinotsu.nagasaki.jp matsuura.nagasaki.jp nagasaki.nagasaki.jp obama.nagasaki.jp omura.nagasaki.jp oseto.nagasaki.jp saikai.nagasaki.jp sasebo.nagasaki.jp seihi.nagasaki.jp shimabara.nagasaki.jp shinkamigoto.nagasaki.jp togitsu.nagasaki.jp tsushima.nagasaki.jp unzen.nagasaki.jp ando.nara.jp gose.nara.jp heguri.nara.jp higashiyoshino.nara.jp ikaruga.nara.jp ikoma.nara.jp kamikitayama.nara.jp kanmaki.nara.jp kashiba.nara.jp kashihara.nara.jp katsuragi.nara.jp kawai.nara.jp kawakami.nara.jp kawanishi.nara.jp koryo.nara.jp kurotaki.nara.jp mitsue.nara.jp miyake.nara.jp nara.nara.jp nosegawa.nara.jp oji.nara.jp ouda.nara.jp oyodo.nara.jp sakurai.nara.jp sango.nara.jp shimoichi.nara.jp shimokitayama.nara.jp shinjo.nara.jp soni.nara.jp takatori.nara.jp tawaramoto.nara.jp tenkawa.nara.jp tenri.nara.jp uda.nara.jp yamatokoriyama.nara.jp yamatotakada.nara.jp yamazoe.nara.jp yoshino.nara.jp aga.niigata.jp agano.niigata.jp gosen.niigata.jp itoigawa.niigata.jp izumozaki.niigata.jp joetsu.niigata.jp kamo.niigata.jp kariwa.niigata.jp kashiwazaki.niigata.jp minamiuonuma.niigata.jp mitsuke.niigata.jp muika.niigata.jp murakami.niigata.jp myoko.niigata.jp nagaoka.niigata.jp niigata.niigata.jp ojiya.niigata.jp omi.niigata.jp sado.niigata.jp sanjo.niigata.jp seiro.niigata.jp seirou.niigata.jp sekikawa.niigata.jp shibata.niigata.jp tagami.niigata.jp tainai.niigata.jp tochio.niigata.jp tokamachi.niigata.jp tsubame.niigata.jp tsunan.niigata.jp uonuma.niigata.jp yahiko.niigata.jp yoita.niigata.jp yuzawa.niigata.jp beppu.oita.jp bungoono.oita.jp bungotakada.oita.jp hasama.oita.jp hiji.oita.jp himeshima.oita.jp hita.oita.jp kamitsue.oita.jp kokonoe.oita.jp kuju.oita.jp kunisaki.oita.jp kusu.oita.jp oita.oita.jp saiki.oita.jp taketa.oita.jp tsukumi.oita.jp usa.oita.jp usuki.oita.jp yufu.oita.jp akaiwa.okayama.jp asakuchi.okayama.jp bizen.okayama.jp hayashima.okayama.jp ibara.okayama.jp kagamino.okayama.jp kasaoka.okayama.jp kibichuo.okayama.jp kumenan.okayama.jp kurashiki.okayama.jp maniwa.okayama.jp misaki.okayama.jp nagi.okayama.jp niimi.okayama.jp nishiawakura.okayama.jp okayama.okayama.jp satosho.okayama.jp setouchi.okayama.jp shinjo.okayama.jp shoo.okayama.jp soja.okayama.jp takahashi.okayama.jp tamano.okayama.jp tsuyama.okayama.jp wake.okayama.jp yakage.okayama.jp aguni.okinawa.jp ginowan.okinawa.jp ginoza.okinawa.jp gushikami.okinawa.jp haebaru.okinawa.jp higashi.okinawa.jp hirara.okinawa.jp iheya.okinawa.jp ishigaki.okinawa.jp ishikawa.okinawa.jp itoman.okinawa.jp izena.okinawa.jp kadena.okinawa.jp kin.okinawa.jp kitadaito.okinawa.jp kitanakagusuku.okinawa.jp kumejima.okinawa.jp kunigami.okinawa.jp minamidaito.okinawa.jp motobu.okinawa.jp nago.okinawa.jp naha.okinawa.jp nakagusuku.okinawa.jp nakijin.okinawa.jp nanjo.okinawa.jp nishihara.okinawa.jp ogimi.okinawa.jp okinawa.okinawa.jp onna.okinawa.jp shimoji.okinawa.jp taketomi.okinawa.jp tarama.okinawa.jp tokashiki.okinawa.jp tomigusuku.okinawa.jp tonaki.okinawa.jp urasoe.okinawa.jp uruma.okinawa.jp yaese.okinawa.jp yomitan.okinawa.jp yonabaru.okinawa.jp yonaguni.okinawa.jp zamami.okinawa.jp abeno.osaka.jp chihayaakasaka.osaka.jp chuo.osaka.jp daito.osaka.jp fujiidera.osaka.jp habikino.osaka.jp hannan.osaka.jp higashiosaka.osaka.jp higashisumiyoshi.osaka.jp higashiyodogawa.osaka.jp hirakata.osaka.jp ibaraki.osaka.jp ikeda.osaka.jp izumi.osaka.jp izumiotsu.osaka.jp izumisano.osaka.jp kadoma.osaka.jp kaizuka.osaka.jp kanan.osaka.jp kashiwara.osaka.jp katano.osaka.jp kawachinagano.osaka.jp kishiwada.osaka.jp kita.osaka.jp kumatori.osaka.jp matsubara.osaka.jp minato.osaka.jp minoh.osaka.jp misaki.osaka.jp moriguchi.osaka.jp neyagawa.osaka.jp nishi.osaka.jp nose.osaka.jp osakasayama.osaka.jp sakai.osaka.jp sayama.osaka.jp sennan.osaka.jp settsu.osaka.jp shijonawate.osaka.jp shimamoto.osaka.jp suita.osaka.jp tadaoka.osaka.jp taishi.osaka.jp tajiri.osaka.jp takaishi.osaka.jp takatsuki.osaka.jp tondabayashi.osaka.jp toyonaka.osaka.jp toyono.osaka.jp yao.osaka.jp ariake.saga.jp arita.saga.jp fukudomi.saga.jp genkai.saga.jp hamatama.saga.jp hizen.saga.jp imari.saga.jp kamimine.saga.jp kanzaki.saga.jp karatsu.saga.jp kashima.saga.jp kitagata.saga.jp kitahata.saga.jp kiyama.saga.jp kouhoku.saga.jp kyuragi.saga.jp nishiarita.saga.jp ogi.saga.jp omachi.saga.jp ouchi.saga.jp saga.saga.jp shiroishi.saga.jp taku.saga.jp tara.saga.jp tosu.saga.jp yoshinogari.saga.jp arakawa.saitama.jp asaka.saitama.jp chichibu.saitama.jp fujimi.saitama.jp fujimino.saitama.jp fukaya.saitama.jp hanno.saitama.jp hanyu.saitama.jp hasuda.saitama.jp hatogaya.saitama.jp hatoyama.saitama.jp hidaka.saitama.jp higashichichibu.saitama.jp higashimatsuyama.saitama.jp honjo.saitama.jp ina.saitama.jp iruma.saitama.jp iwatsuki.saitama.jp kamiizumi.saitama.jp kamikawa.saitama.jp kamisato.saitama.jp kasukabe.saitama.jp kawagoe.saitama.jp kawaguchi.saitama.jp kawajima.saitama.jp kazo.saitama.jp kitamoto.saitama.jp koshigaya.saitama.jp kounosu.saitama.jp kuki.saitama.jp kumagaya.saitama.jp matsubushi.saitama.jp minano.saitama.jp misato.saitama.jp miyashiro.saitama.jp miyoshi.saitama.jp moroyama.saitama.jp nagatoro.saitama.jp namegawa.saitama.jp niiza.saitama.jp ogano.saitama.jp ogawa.saitama.jp ogose.saitama.jp okegawa.saitama.jp omiya.saitama.jp otaki.saitama.jp ranzan.saitama.jp ryokami.saitama.jp saitama.saitama.jp sakado.saitama.jp satte.saitama.jp sayama.saitama.jp shiki.saitama.jp shiraoka.saitama.jp soka.saitama.jp sugito.saitama.jp toda.saitama.jp tokigawa.saitama.jp tokorozawa.saitama.jp tsurugashima.saitama.jp urawa.saitama.jp warabi.saitama.jp yashio.saitama.jp yokoze.saitama.jp yono.saitama.jp yorii.saitama.jp yoshida.saitama.jp yoshikawa.saitama.jp yoshimi.saitama.jp aisho.shiga.jp gamo.shiga.jp higashiomi.shiga.jp hikone.shiga.jp koka.shiga.jp konan.shiga.jp kosei.shiga.jp koto.shiga.jp kusatsu.shiga.jp maibara.shiga.jp moriyama.shiga.jp nagahama.shiga.jp nishiazai.shiga.jp notogawa.shiga.jp omihachiman.shiga.jp otsu.shiga.jp ritto.shiga.jp ryuoh.shiga.jp takashima.shiga.jp takatsuki.shiga.jp torahime.shiga.jp toyosato.shiga.jp yasu.shiga.jp akagi.shimane.jp ama.shimane.jp gotsu.shimane.jp hamada.shimane.jp higashiizumo.shimane.jp hikawa.shimane.jp hikimi.shimane.jp izumo.shimane.jp kakinoki.shimane.jp masuda.shimane.jp matsue.shimane.jp misato.shimane.jp nishinoshima.shimane.jp ohda.shimane.jp okinoshima.shimane.jp okuizumo.shimane.jp shimane.shimane.jp tamayu.shimane.jp tsuwano.shimane.jp unnan.shimane.jp yakumo.shimane.jp yasugi.shimane.jp yatsuka.shimane.jp arai.shizuoka.jp atami.shizuoka.jp fuji.shizuoka.jp fujieda.shizuoka.jp fujikawa.shizuoka.jp fujinomiya.shizuoka.jp fukuroi.shizuoka.jp gotemba.shizuoka.jp haibara.shizuoka.jp hamamatsu.shizuoka.jp higashiizu.shizuoka.jp ito.shizuoka.jp iwata.shizuoka.jp izu.shizuoka.jp izunokuni.shizuoka.jp kakegawa.shizuoka.jp kannami.shizuoka.jp kawanehon.shizuoka.jp kawazu.shizuoka.jp kikugawa.shizuoka.jp kosai.shizuoka.jp makinohara.shizuoka.jp matsuzaki.shizuoka.jp minamiizu.shizuoka.jp mishima.shizuoka.jp morimachi.shizuoka.jp nishiizu.shizuoka.jp numazu.shizuoka.jp omaezaki.shizuoka.jp shimada.shizuoka.jp shimizu.shizuoka.jp shimoda.shizuoka.jp shizuoka.shizuoka.jp susono.shizuoka.jp yaizu.shizuoka.jp yoshida.shizuoka.jp ashikaga.tochigi.jp bato.tochigi.jp haga.tochigi.jp ichikai.tochigi.jp iwafune.tochigi.jp kaminokawa.tochigi.jp kanuma.tochigi.jp karasuyama.tochigi.jp kuroiso.tochigi.jp mashiko.tochigi.jp mibu.tochigi.jp moka.tochigi.jp motegi.tochigi.jp nasu.tochigi.jp nasushiobara.tochigi.jp nikko.tochigi.jp nishikata.tochigi.jp nogi.tochigi.jp ohira.tochigi.jp ohtawara.tochigi.jp oyama.tochigi.jp sakura.tochigi.jp sano.tochigi.jp shimotsuke.tochigi.jp shioya.tochigi.jp takanezawa.tochigi.jp tochigi.tochigi.jp tsuga.tochigi.jp ujiie.tochigi.jp utsunomiya.tochigi.jp yaita.tochigi.jp aizumi.tokushima.jp anan.tokushima.jp ichiba.tokushima.jp itano.tokushima.jp kainan.tokushima.jp komatsushima.tokushima.jp matsushige.tokushima.jp mima.tokushima.jp minami.tokushima.jp miyoshi.tokushima.jp mugi.tokushima.jp nakagawa.tokushima.jp naruto.tokushima.jp sanagochi.tokushima.jp shishikui.tokushima.jp tokushima.tokushima.jp wajiki.tokushima.jp adachi.tokyo.jp akiruno.tokyo.jp akishima.tokyo.jp aogashima.tokyo.jp arakawa.tokyo.jp bunkyo.tokyo.jp chiyoda.tokyo.jp chofu.tokyo.jp chuo.tokyo.jp edogawa.tokyo.jp fuchu.tokyo.jp fussa.tokyo.jp hachijo.tokyo.jp hachioji.tokyo.jp hamura.tokyo.jp higashikurume.tokyo.jp higashimurayama.tokyo.jp higashiyamato.tokyo.jp hino.tokyo.jp hinode.tokyo.jp hinohara.tokyo.jp inagi.tokyo.jp itabashi.tokyo.jp katsushika.tokyo.jp kita.tokyo.jp kiyose.tokyo.jp kodaira.tokyo.jp koganei.tokyo.jp kokubunji.tokyo.jp komae.tokyo.jp koto.tokyo.jp kouzushima.tokyo.jp kunitachi.tokyo.jp machida.tokyo.jp meguro.tokyo.jp minato.tokyo.jp mitaka.tokyo.jp mizuho.tokyo.jp musashimurayama.tokyo.jp musashino.tokyo.jp nakano.tokyo.jp nerima.tokyo.jp ogasawara.tokyo.jp okutama.tokyo.jp ome.tokyo.jp oshima.tokyo.jp ota.tokyo.jp setagaya.tokyo.jp shibuya.tokyo.jp shinagawa.tokyo.jp shinjuku.tokyo.jp suginami.tokyo.jp sumida.tokyo.jp tachikawa.tokyo.jp taito.tokyo.jp tama.tokyo.jp toshima.tokyo.jp chizu.tottori.jp hino.tottori.jp kawahara.tottori.jp koge.tottori.jp kotoura.tottori.jp misasa.tottori.jp nanbu.tottori.jp nichinan.tottori.jp sakaiminato.tottori.jp tottori.tottori.jp wakasa.tottori.jp yazu.tottori.jp yonago.tottori.jp asahi.toyama.jp fuchu.toyama.jp fukumitsu.toyama.jp funahashi.toyama.jp himi.toyama.jp imizu.toyama.jp inami.toyama.jp johana.toyama.jp kamiichi.toyama.jp kurobe.toyama.jp nakaniikawa.toyama.jp namerikawa.toyama.jp nanto.toyama.jp nyuzen.toyama.jp oyabe.toyama.jp taira.toyama.jp takaoka.toyama.jp tateyama.toyama.jp toga.toyama.jp tonami.toyama.jp toyama.toyama.jp unazuki.toyama.jp uozu.toyama.jp yamada.toyama.jp arida.wakayama.jp aridagawa.wakayama.jp gobo.wakayama.jp hashimoto.wakayama.jp hidaka.wakayama.jp hirogawa.wakayama.jp inami.wakayama.jp iwade.wakayama.jp kainan.wakayama.jp kamitonda.wakayama.jp katsuragi.wakayama.jp kimino.wakayama.jp kinokawa.wakayama.jp kitayama.wakayama.jp koya.wakayama.jp koza.wakayama.jp kozagawa.wakayama.jp kudoyama.wakayama.jp kushimoto.wakayama.jp mihama.wakayama.jp misato.wakayama.jp nachikatsuura.wakayama.jp shingu.wakayama.jp shirahama.wakayama.jp taiji.wakayama.jp tanabe.wakayama.jp wakayama.wakayama.jp yuasa.wakayama.jp yura.wakayama.jp asahi.yamagata.jp funagata.yamagata.jp higashine.yamagata.jp iide.yamagata.jp kahoku.yamagata.jp kaminoyama.yamagata.jp kaneyama.yamagata.jp kawanishi.yamagata.jp mamurogawa.yamagata.jp mikawa.yamagata.jp murayama.yamagata.jp nagai.yamagata.jp nakayama.yamagata.jp nanyo.yamagata.jp nishikawa.yamagata.jp obanazawa.yamagata.jp oe.yamagata.jp oguni.yamagata.jp ohkura.yamagata.jp oishida.yamagata.jp sagae.yamagata.jp sakata.yamagata.jp sakegawa.yamagata.jp shinjo.yamagata.jp shirataka.yamagata.jp shonai.yamagata.jp takahata.yamagata.jp tendo.yamagata.jp tozawa.yamagata.jp tsuruoka.yamagata.jp yamagata.yamagata.jp yamanobe.yamagata.jp yonezawa.yamagata.jp yuza.yamagata.jp abu.yamaguchi.jp hagi.yamaguchi.jp hikari.yamaguchi.jp hofu.yamaguchi.jp iwakuni.yamaguchi.jp kudamatsu.yamaguchi.jp mitou.yamaguchi.jp nagato.yamaguchi.jp oshima.yamaguchi.jp shimonoseki.yamaguchi.jp shunan.yamaguchi.jp tabuse.yamaguchi.jp tokuyama.yamaguchi.jp toyota.yamaguchi.jp ube.yamaguchi.jp yuu.yamaguchi.jp chuo.yamanashi.jp doshi.yamanashi.jp fuefuki.yamanashi.jp fujikawa.yamanashi.jp fujikawaguchiko.yamanashi.jp fujiyoshida.yamanashi.jp hayakawa.yamanashi.jp hokuto.yamanashi.jp ichikawamisato.yamanashi.jp kai.yamanashi.jp kofu.yamanashi.jp koshu.yamanashi.jp kosuge.yamanashi.jp minami-alps.yamanashi.jp minobu.yamanashi.jp nakamichi.yamanashi.jp nanbu.yamanashi.jp narusawa.yamanashi.jp nirasaki.yamanashi.jp nishikatsura.yamanashi.jp oshino.yamanashi.jp otsuki.yamanashi.jp showa.yamanashi.jp tabayama.yamanashi.jp tsuru.yamanashi.jp uenohara.yamanashi.jp yamanakako.yamanashi.jp yamanashi.yamanashi.jp // ke : http://www.kenic.or.ke/index.php/en/ke-domains/ke-domains ke ac.ke co.ke go.ke info.ke me.ke mobi.ke ne.ke or.ke sc.ke // kg : http://www.domain.kg/dmn_n.html kg org.kg net.kg com.kg edu.kg gov.kg mil.kg // kh : http://www.mptc.gov.kh/dns_registration.htm *.kh // ki : http://www.ki/dns/index.html ki edu.ki biz.ki net.ki org.ki gov.ki info.ki com.ki // km : https://en.wikipedia.org/wiki/.km // http://www.domaine.km/documents/charte.doc km org.km nom.km gov.km prd.km tm.km edu.km mil.km ass.km com.km // These are only mentioned as proposed suggestions at domaine.km, but // https://en.wikipedia.org/wiki/.km says they're available for registration: coop.km asso.km presse.km medecin.km notaires.km pharmaciens.km veterinaire.km gouv.km // kn : https://en.wikipedia.org/wiki/.kn // http://www.dot.kn/domainRules.html kn net.kn org.kn edu.kn gov.kn // kp : http://www.kcce.kp/en_index.php kp com.kp edu.kp gov.kp org.kp rep.kp tra.kp // kr : https://en.wikipedia.org/wiki/.kr // see also: http://domain.nida.or.kr/eng/registration.jsp kr ac.kr co.kr es.kr go.kr hs.kr kg.kr mil.kr ms.kr ne.kr or.kr pe.kr re.kr sc.kr // kr geographical names busan.kr chungbuk.kr chungnam.kr daegu.kr daejeon.kr gangwon.kr gwangju.kr gyeongbuk.kr gyeonggi.kr gyeongnam.kr incheon.kr jeju.kr jeonbuk.kr jeonnam.kr seoul.kr ulsan.kr // kw : https://www.nic.kw/policies/ // Confirmed by registry kw com.kw edu.kw emb.kw gov.kw ind.kw net.kw org.kw // ky : http://www.icta.ky/da_ky_reg_dom.php // Confirmed by registry 2008-06-17 ky edu.ky gov.ky com.ky org.ky net.ky // kz : https://en.wikipedia.org/wiki/.kz // see also: http://www.nic.kz/rules/index.jsp kz org.kz edu.kz net.kz gov.kz mil.kz com.kz // la : https://en.wikipedia.org/wiki/.la // Submitted by registry la int.la net.la info.la edu.la gov.la per.la com.la org.la // lb : https://en.wikipedia.org/wiki/.lb // Submitted by registry lb com.lb edu.lb gov.lb net.lb org.lb // lc : https://en.wikipedia.org/wiki/.lc // see also: http://www.nic.lc/rules.htm lc com.lc net.lc co.lc org.lc edu.lc gov.lc // li : https://en.wikipedia.org/wiki/.li li // lk : https://www.nic.lk/index.php/domain-registration/lk-domain-naming-structure lk gov.lk sch.lk net.lk int.lk com.lk org.lk edu.lk ngo.lk soc.lk web.lk ltd.lk assn.lk grp.lk hotel.lk ac.lk // lr : http://psg.com/dns/lr/lr.txt // Submitted by registry lr com.lr edu.lr gov.lr org.lr net.lr // ls : http://www.nic.ls/ // Confirmed by registry ls ac.ls biz.ls co.ls edu.ls gov.ls info.ls net.ls org.ls sc.ls // lt : https://en.wikipedia.org/wiki/.lt lt // gov.lt : http://www.gov.lt/index_en.php gov.lt // lu : http://www.dns.lu/en/ lu // lv : http://www.nic.lv/DNS/En/generic.php lv com.lv edu.lv gov.lv org.lv mil.lv id.lv net.lv asn.lv conf.lv // ly : http://www.nic.ly/regulations.php ly com.ly net.ly gov.ly plc.ly edu.ly sch.ly med.ly org.ly id.ly // ma : https://en.wikipedia.org/wiki/.ma // http://www.anrt.ma/fr/admin/download/upload/file_fr782.pdf ma co.ma net.ma gov.ma org.ma ac.ma press.ma // mc : http://www.nic.mc/ mc tm.mc asso.mc // md : https://en.wikipedia.org/wiki/.md md // me : https://en.wikipedia.org/wiki/.me me co.me net.me org.me edu.me ac.me gov.me its.me priv.me // mg : http://nic.mg/nicmg/?page_id=39 mg org.mg nom.mg gov.mg prd.mg tm.mg edu.mg mil.mg com.mg co.mg // mh : https://en.wikipedia.org/wiki/.mh mh // mil : https://en.wikipedia.org/wiki/.mil mil // mk : https://en.wikipedia.org/wiki/.mk // see also: http://dns.marnet.net.mk/postapka.php mk com.mk org.mk net.mk edu.mk gov.mk inf.mk name.mk // ml : http://www.gobin.info/domainname/ml-template.doc // see also: https://en.wikipedia.org/wiki/.ml ml com.ml edu.ml gouv.ml gov.ml net.ml org.ml presse.ml // mm : https://en.wikipedia.org/wiki/.mm *.mm // mn : https://en.wikipedia.org/wiki/.mn mn gov.mn edu.mn org.mn // mo : http://www.monic.net.mo/ mo com.mo net.mo org.mo edu.mo gov.mo // mobi : https://en.wikipedia.org/wiki/.mobi mobi // mp : http://www.dot.mp/ // Confirmed by registry 2008-06-17 mp // mq : https://en.wikipedia.org/wiki/.mq mq // mr : https://en.wikipedia.org/wiki/.mr mr gov.mr // ms : http://www.nic.ms/pdf/MS_Domain_Name_Rules.pdf ms com.ms edu.ms gov.ms net.ms org.ms // mt : https://www.nic.org.mt/go/policy // Submitted by registry mt com.mt edu.mt net.mt org.mt // mu : https://en.wikipedia.org/wiki/.mu mu com.mu net.mu org.mu gov.mu ac.mu co.mu or.mu // museum : http://about.museum/naming/ // http://index.museum/ museum academy.museum agriculture.museum air.museum airguard.museum alabama.museum alaska.museum amber.museum ambulance.museum american.museum americana.museum americanantiques.museum americanart.museum amsterdam.museum and.museum annefrank.museum anthro.museum anthropology.museum antiques.museum aquarium.museum arboretum.museum archaeological.museum archaeology.museum architecture.museum art.museum artanddesign.museum artcenter.museum artdeco.museum arteducation.museum artgallery.museum arts.museum artsandcrafts.museum asmatart.museum assassination.museum assisi.museum association.museum astronomy.museum atlanta.museum austin.museum australia.museum automotive.museum aviation.museum axis.museum badajoz.museum baghdad.museum bahn.museum bale.museum baltimore.museum barcelona.museum baseball.museum basel.museum baths.museum bauern.museum beauxarts.museum beeldengeluid.museum bellevue.museum bergbau.museum berkeley.museum berlin.museum bern.museum bible.museum bilbao.museum bill.museum birdart.museum birthplace.museum bonn.museum boston.museum botanical.museum botanicalgarden.museum botanicgarden.museum botany.museum brandywinevalley.museum brasil.museum bristol.museum british.museum britishcolumbia.museum broadcast.museum brunel.museum brussel.museum brussels.museum bruxelles.museum building.museum burghof.museum bus.museum bushey.museum cadaques.museum california.museum cambridge.museum can.museum canada.museum capebreton.museum carrier.museum cartoonart.museum casadelamoneda.museum castle.museum castres.museum celtic.museum center.museum chattanooga.museum cheltenham.museum chesapeakebay.museum chicago.museum children.museum childrens.museum childrensgarden.museum chiropractic.museum chocolate.museum christiansburg.museum cincinnati.museum cinema.museum circus.museum civilisation.museum civilization.museum civilwar.museum clinton.museum clock.museum coal.museum coastaldefence.museum cody.museum coldwar.museum collection.museum colonialwilliamsburg.museum coloradoplateau.museum columbia.museum columbus.museum communication.museum communications.museum community.museum computer.museum computerhistory.museum comunicações.museum contemporary.museum contemporaryart.museum convent.museum copenhagen.museum corporation.museum correios-e-telecomunicações.museum corvette.museum costume.museum countryestate.museum county.museum crafts.museum cranbrook.museum creation.museum cultural.museum culturalcenter.museum culture.museum cyber.museum cymru.museum dali.museum dallas.museum database.museum ddr.museum decorativearts.museum delaware.museum delmenhorst.museum denmark.museum depot.museum design.museum detroit.museum dinosaur.museum discovery.museum dolls.museum donostia.museum durham.museum eastafrica.museum eastcoast.museum education.museum educational.museum egyptian.museum eisenbahn.museum elburg.museum elvendrell.museum embroidery.museum encyclopedic.museum england.museum entomology.museum environment.museum environmentalconservation.museum epilepsy.museum essex.museum estate.museum ethnology.museum exeter.museum exhibition.museum family.museum farm.museum farmequipment.museum farmers.museum farmstead.museum field.museum figueres.museum filatelia.museum film.museum fineart.museum finearts.museum finland.museum flanders.museum florida.museum force.museum fortmissoula.museum fortworth.museum foundation.museum francaise.museum frankfurt.museum franziskaner.museum freemasonry.museum freiburg.museum fribourg.museum frog.museum fundacio.museum furniture.museum gallery.museum garden.museum gateway.museum geelvinck.museum gemological.museum geology.museum georgia.museum giessen.museum glas.museum glass.museum gorge.museum grandrapids.museum graz.museum guernsey.museum halloffame.museum hamburg.museum handson.museum harvestcelebration.museum hawaii.museum health.museum heimatunduhren.museum hellas.museum helsinki.museum hembygdsforbund.museum heritage.museum histoire.museum historical.museum historicalsociety.museum historichouses.museum historisch.museum historisches.museum history.museum historyofscience.museum horology.museum house.museum humanities.museum illustration.museum imageandsound.museum indian.museum indiana.museum indianapolis.museum indianmarket.museum intelligence.museum interactive.museum iraq.museum iron.museum isleofman.museum jamison.museum jefferson.museum jerusalem.museum jewelry.museum jewish.museum jewishart.museum jfk.museum journalism.museum judaica.museum judygarland.museum juedisches.museum juif.museum karate.museum karikatur.museum kids.museum koebenhavn.museum koeln.museum kunst.museum kunstsammlung.museum kunstunddesign.museum labor.museum labour.museum lajolla.museum lancashire.museum landes.museum lans.museum läns.museum larsson.museum lewismiller.museum lincoln.museum linz.museum living.museum livinghistory.museum localhistory.museum london.museum losangeles.museum louvre.museum loyalist.museum lucerne.museum luxembourg.museum luzern.museum mad.museum madrid.museum mallorca.museum manchester.museum mansion.museum mansions.museum manx.museum marburg.museum maritime.museum maritimo.museum maryland.museum marylhurst.museum media.museum medical.museum medizinhistorisches.museum meeres.museum memorial.museum mesaverde.museum michigan.museum midatlantic.museum military.museum mill.museum miners.museum mining.museum minnesota.museum missile.museum missoula.museum modern.museum moma.museum money.museum monmouth.museum monticello.museum montreal.museum moscow.museum motorcycle.museum muenchen.museum muenster.museum mulhouse.museum muncie.museum museet.museum museumcenter.museum museumvereniging.museum music.museum national.museum nationalfirearms.museum nationalheritage.museum nativeamerican.museum naturalhistory.museum naturalhistorymuseum.museum naturalsciences.museum nature.museum naturhistorisches.museum natuurwetenschappen.museum naumburg.museum naval.museum nebraska.museum neues.museum newhampshire.museum newjersey.museum newmexico.museum newport.museum newspaper.museum newyork.museum niepce.museum norfolk.museum north.museum nrw.museum nyc.museum nyny.museum oceanographic.museum oceanographique.museum omaha.museum online.museum ontario.museum openair.museum oregon.museum oregontrail.museum otago.museum oxford.museum pacific.museum paderborn.museum palace.museum paleo.museum palmsprings.museum panama.museum paris.museum pasadena.museum pharmacy.museum philadelphia.museum philadelphiaarea.museum philately.museum phoenix.museum photography.museum pilots.museum pittsburgh.museum planetarium.museum plantation.museum plants.museum plaza.museum portal.museum portland.museum portlligat.museum posts-and-telecommunications.museum preservation.museum presidio.museum press.museum project.museum public.museum pubol.museum quebec.museum railroad.museum railway.museum research.museum resistance.museum riodejaneiro.museum rochester.museum rockart.museum roma.museum russia.museum saintlouis.museum salem.museum salvadordali.museum salzburg.museum sandiego.museum sanfrancisco.museum santabarbara.museum santacruz.museum santafe.museum saskatchewan.museum satx.museum savannahga.museum schlesisches.museum schoenbrunn.museum schokoladen.museum school.museum schweiz.museum science.museum scienceandhistory.museum scienceandindustry.museum sciencecenter.museum sciencecenters.museum science-fiction.museum sciencehistory.museum sciences.museum sciencesnaturelles.museum scotland.museum seaport.museum settlement.museum settlers.museum shell.museum sherbrooke.museum sibenik.museum silk.museum ski.museum skole.museum society.museum sologne.museum soundandvision.museum southcarolina.museum southwest.museum space.museum spy.museum square.museum stadt.museum stalbans.museum starnberg.museum state.museum stateofdelaware.museum station.museum steam.museum steiermark.museum stjohn.museum stockholm.museum stpetersburg.museum stuttgart.museum suisse.museum surgeonshall.museum surrey.museum svizzera.museum sweden.museum sydney.museum tank.museum tcm.museum technology.museum telekommunikation.museum television.museum texas.museum textile.museum theater.museum time.museum timekeeping.museum topology.museum torino.museum touch.museum town.museum transport.museum tree.museum trolley.museum trust.museum trustee.museum uhren.museum ulm.museum undersea.museum university.museum usa.museum usantiques.museum usarts.museum uscountryestate.museum usculture.museum usdecorativearts.museum usgarden.museum ushistory.museum ushuaia.museum uslivinghistory.museum utah.museum uvic.museum valley.museum vantaa.museum versailles.museum viking.museum village.museum virginia.museum virtual.museum virtuel.museum vlaanderen.museum volkenkunde.museum wales.museum wallonie.museum war.museum washingtondc.museum watchandclock.museum watch-and-clock.museum western.museum westfalen.museum whaling.museum wildlife.museum williamsburg.museum windmill.museum workshop.museum york.museum yorkshire.museum yosemite.museum youth.museum zoological.museum zoology.museum ירושלים.museum иком.museum // mv : https://en.wikipedia.org/wiki/.mv // "mv" included because, contra Wikipedia, google.mv exists. mv aero.mv biz.mv com.mv coop.mv edu.mv gov.mv info.mv int.mv mil.mv museum.mv name.mv net.mv org.mv pro.mv // mw : http://www.registrar.mw/ mw ac.mw biz.mw co.mw com.mw coop.mw edu.mw gov.mw int.mw museum.mw net.mw org.mw // mx : http://www.nic.mx/ // Submitted by registry mx com.mx org.mx gob.mx edu.mx net.mx // my : http://www.mynic.my/ // Available strings: https://mynic.my/resources/domains/buying-a-domain/ my biz.my com.my edu.my gov.my mil.my name.my net.my org.my // mz : http://www.uem.mz/ // Submitted by registry mz ac.mz adv.mz co.mz edu.mz gov.mz mil.mz net.mz org.mz // na : http://www.na-nic.com.na/ // http://www.info.na/domain/ na info.na pro.na name.na school.na or.na dr.na us.na mx.na ca.na in.na cc.na tv.na ws.na mobi.na co.na com.na org.na // name : has 2nd-level tlds, but there's no list of them name // nc : http://www.cctld.nc/ nc asso.nc nom.nc // ne : https://en.wikipedia.org/wiki/.ne ne // net : https://en.wikipedia.org/wiki/.net net // nf : https://en.wikipedia.org/wiki/.nf nf com.nf net.nf per.nf rec.nf web.nf arts.nf firm.nf info.nf other.nf store.nf // ng : http://www.nira.org.ng/index.php/join-us/register-ng-domain/189-nira-slds ng com.ng edu.ng gov.ng i.ng mil.ng mobi.ng name.ng net.ng org.ng sch.ng // ni : http://www.nic.ni/ ni ac.ni biz.ni co.ni com.ni edu.ni gob.ni in.ni info.ni int.ni mil.ni net.ni nom.ni org.ni web.ni // nl : https://en.wikipedia.org/wiki/.nl // https://www.sidn.nl/ // ccTLD for the Netherlands nl // no : https://www.norid.no/en/om-domenenavn/regelverk-for-no/ // Norid geographical second level domains : https://www.norid.no/en/om-domenenavn/regelverk-for-no/vedlegg-b/ // Norid category second level domains : https://www.norid.no/en/om-domenenavn/regelverk-for-no/vedlegg-c/ // Norid category second-level domains managed by parties other than Norid : https://www.norid.no/en/om-domenenavn/regelverk-for-no/vedlegg-d/ // RSS feed: https://teknisk.norid.no/en/feed/ no // Norid category second level domains : https://www.norid.no/en/om-domenenavn/regelverk-for-no/vedlegg-c/ fhs.no vgs.no fylkesbibl.no folkebibl.no museum.no idrett.no priv.no // Norid category second-level domains managed by parties other than Norid : https://www.norid.no/en/om-domenenavn/regelverk-for-no/vedlegg-d/ mil.no stat.no dep.no kommune.no herad.no // Norid geographical second level domains : https://www.norid.no/en/om-domenenavn/regelverk-for-no/vedlegg-b/ // counties aa.no ah.no bu.no fm.no hl.no hm.no jan-mayen.no mr.no nl.no nt.no of.no ol.no oslo.no rl.no sf.no st.no svalbard.no tm.no tr.no va.no vf.no // primary and lower secondary schools per county gs.aa.no gs.ah.no gs.bu.no gs.fm.no gs.hl.no gs.hm.no gs.jan-mayen.no gs.mr.no gs.nl.no gs.nt.no gs.of.no gs.ol.no gs.oslo.no gs.rl.no gs.sf.no gs.st.no gs.svalbard.no gs.tm.no gs.tr.no gs.va.no gs.vf.no // cities akrehamn.no åkrehamn.no algard.no ålgård.no arna.no brumunddal.no bryne.no bronnoysund.no brønnøysund.no drobak.no drøbak.no egersund.no fetsund.no floro.no florø.no fredrikstad.no hokksund.no honefoss.no hønefoss.no jessheim.no jorpeland.no jørpeland.no kirkenes.no kopervik.no krokstadelva.no langevag.no langevåg.no leirvik.no mjondalen.no mjøndalen.no mo-i-rana.no mosjoen.no mosjøen.no nesoddtangen.no orkanger.no osoyro.no osøyro.no raholt.no råholt.no sandnessjoen.no sandnessjøen.no skedsmokorset.no slattum.no spjelkavik.no stathelle.no stavern.no stjordalshalsen.no stjørdalshalsen.no tananger.no tranby.no vossevangen.no // communities afjord.no åfjord.no agdenes.no al.no ål.no alesund.no ålesund.no alstahaug.no alta.no áltá.no alaheadju.no álaheadju.no alvdal.no amli.no åmli.no amot.no åmot.no andebu.no andoy.no andøy.no andasuolo.no ardal.no årdal.no aremark.no arendal.no ås.no aseral.no åseral.no asker.no askim.no askvoll.no askoy.no askøy.no asnes.no åsnes.no audnedaln.no aukra.no aure.no aurland.no aurskog-holand.no aurskog-høland.no austevoll.no austrheim.no averoy.no averøy.no balestrand.no ballangen.no balat.no bálát.no balsfjord.no bahccavuotna.no báhccavuotna.no bamble.no bardu.no beardu.no beiarn.no bajddar.no bájddar.no baidar.no báidár.no berg.no bergen.no berlevag.no berlevåg.no bearalvahki.no bearalváhki.no bindal.no birkenes.no bjarkoy.no bjarkøy.no bjerkreim.no bjugn.no bodo.no bodø.no badaddja.no bådåddjå.no budejju.no bokn.no bremanger.no bronnoy.no brønnøy.no bygland.no bykle.no barum.no bærum.no bo.telemark.no bø.telemark.no bo.nordland.no bø.nordland.no bievat.no bievát.no bomlo.no bømlo.no batsfjord.no båtsfjord.no bahcavuotna.no báhcavuotna.no dovre.no drammen.no drangedal.no dyroy.no dyrøy.no donna.no dønna.no eid.no eidfjord.no eidsberg.no eidskog.no eidsvoll.no eigersund.no elverum.no enebakk.no engerdal.no etne.no etnedal.no evenes.no evenassi.no evenášši.no evje-og-hornnes.no farsund.no fauske.no fuossko.no fuoisku.no fedje.no fet.no finnoy.no finnøy.no fitjar.no fjaler.no fjell.no flakstad.no flatanger.no flekkefjord.no flesberg.no flora.no fla.no flå.no folldal.no forsand.no fosnes.no frei.no frogn.no froland.no frosta.no frana.no fræna.no froya.no frøya.no fusa.no fyresdal.no forde.no førde.no gamvik.no gangaviika.no gáŋgaviika.no gaular.no gausdal.no gildeskal.no gildeskål.no giske.no gjemnes.no gjerdrum.no gjerstad.no gjesdal.no gjovik.no gjøvik.no gloppen.no gol.no gran.no grane.no granvin.no gratangen.no grimstad.no grong.no kraanghke.no kråanghke.no grue.no gulen.no hadsel.no halden.no halsa.no hamar.no hamaroy.no habmer.no hábmer.no hapmir.no hápmir.no hammerfest.no hammarfeasta.no hámmárfeasta.no haram.no hareid.no harstad.no hasvik.no aknoluokta.no ákŋoluokta.no hattfjelldal.no aarborte.no haugesund.no hemne.no hemnes.no hemsedal.no heroy.more-og-romsdal.no herøy.møre-og-romsdal.no heroy.nordland.no herøy.nordland.no hitra.no hjartdal.no hjelmeland.no hobol.no hobøl.no hof.no hol.no hole.no holmestrand.no holtalen.no holtålen.no hornindal.no horten.no hurdal.no hurum.no hvaler.no hyllestad.no hagebostad.no hægebostad.no hoyanger.no høyanger.no hoylandet.no høylandet.no ha.no hå.no ibestad.no inderoy.no inderøy.no iveland.no jevnaker.no jondal.no jolster.no jølster.no karasjok.no karasjohka.no kárášjohka.no karlsoy.no galsa.no gálsá.no karmoy.no karmøy.no kautokeino.no guovdageaidnu.no klepp.no klabu.no klæbu.no kongsberg.no kongsvinger.no kragero.no kragerø.no kristiansand.no kristiansund.no krodsherad.no krødsherad.no kvalsund.no rahkkeravju.no ráhkkerávju.no kvam.no kvinesdal.no kvinnherad.no kviteseid.no kvitsoy.no kvitsøy.no kvafjord.no kvæfjord.no giehtavuoatna.no kvanangen.no kvænangen.no navuotna.no návuotna.no kafjord.no kåfjord.no gaivuotna.no gáivuotna.no larvik.no lavangen.no lavagis.no loabat.no loabát.no lebesby.no davvesiida.no leikanger.no leirfjord.no leka.no leksvik.no lenvik.no leangaviika.no leaŋgaviika.no lesja.no levanger.no lier.no lierne.no lillehammer.no lillesand.no lindesnes.no lindas.no lindås.no lom.no loppa.no lahppi.no láhppi.no lund.no lunner.no luroy.no lurøy.no luster.no lyngdal.no lyngen.no ivgu.no lardal.no lerdal.no lærdal.no lodingen.no lødingen.no lorenskog.no lørenskog.no loten.no løten.no malvik.no masoy.no måsøy.no muosat.no muosát.no mandal.no marker.no marnardal.no masfjorden.no meland.no meldal.no melhus.no meloy.no meløy.no meraker.no meråker.no moareke.no moåreke.no midsund.no midtre-gauldal.no modalen.no modum.no molde.no moskenes.no moss.no mosvik.no malselv.no målselv.no malatvuopmi.no málatvuopmi.no namdalseid.no aejrie.no namsos.no namsskogan.no naamesjevuemie.no nååmesjevuemie.no laakesvuemie.no nannestad.no narvik.no narviika.no naustdal.no nedre-eiker.no nes.akershus.no nes.buskerud.no nesna.no nesodden.no nesseby.no unjarga.no unjárga.no nesset.no nissedal.no nittedal.no nord-aurdal.no nord-fron.no nord-odal.no norddal.no nordkapp.no davvenjarga.no davvenjárga.no nordre-land.no nordreisa.no raisa.no ráisa.no nore-og-uvdal.no notodden.no naroy.no nærøy.no notteroy.no nøtterøy.no odda.no oksnes.no øksnes.no oppdal.no oppegard.no oppegård.no orkdal.no orland.no ørland.no orskog.no ørskog.no orsta.no ørsta.no os.hedmark.no os.hordaland.no osen.no osteroy.no osterøy.no ostre-toten.no østre-toten.no overhalla.no ovre-eiker.no øvre-eiker.no oyer.no øyer.no oygarden.no øygarden.no oystre-slidre.no øystre-slidre.no porsanger.no porsangu.no porsáŋgu.no porsgrunn.no radoy.no radøy.no rakkestad.no rana.no ruovat.no randaberg.no rauma.no rendalen.no rennebu.no rennesoy.no rennesøy.no rindal.no ringebu.no ringerike.no ringsaker.no rissa.no risor.no risør.no roan.no rollag.no rygge.no ralingen.no rælingen.no rodoy.no rødøy.no romskog.no rømskog.no roros.no røros.no rost.no røst.no royken.no røyken.no royrvik.no røyrvik.no rade.no råde.no salangen.no siellak.no saltdal.no salat.no sálát.no sálat.no samnanger.no sande.more-og-romsdal.no sande.møre-og-romsdal.no sande.vestfold.no sandefjord.no sandnes.no sandoy.no sandøy.no sarpsborg.no sauda.no sauherad.no sel.no selbu.no selje.no seljord.no sigdal.no siljan.no sirdal.no skaun.no skedsmo.no ski.no skien.no skiptvet.no skjervoy.no skjervøy.no skierva.no skiervá.no skjak.no skjåk.no skodje.no skanland.no skånland.no skanit.no skánit.no smola.no smøla.no snillfjord.no snasa.no snåsa.no snoasa.no snaase.no snåase.no sogndal.no sokndal.no sola.no solund.no songdalen.no sortland.no spydeberg.no stange.no stavanger.no steigen.no steinkjer.no stjordal.no stjørdal.no stokke.no stor-elvdal.no stord.no stordal.no storfjord.no omasvuotna.no strand.no stranda.no stryn.no sula.no suldal.no sund.no sunndal.no surnadal.no sveio.no svelvik.no sykkylven.no sogne.no søgne.no somna.no sømna.no sondre-land.no søndre-land.no sor-aurdal.no sør-aurdal.no sor-fron.no sør-fron.no sor-odal.no sør-odal.no sor-varanger.no sør-varanger.no matta-varjjat.no mátta-várjjat.no sorfold.no sørfold.no sorreisa.no sørreisa.no sorum.no sørum.no tana.no deatnu.no time.no tingvoll.no tinn.no tjeldsund.no dielddanuorri.no tjome.no tjøme.no tokke.no tolga.no torsken.no tranoy.no tranøy.no tromso.no tromsø.no tromsa.no romsa.no trondheim.no troandin.no trysil.no trana.no træna.no trogstad.no trøgstad.no tvedestrand.no tydal.no tynset.no tysfjord.no divtasvuodna.no divttasvuotna.no tysnes.no tysvar.no tysvær.no tonsberg.no tønsberg.no ullensaker.no ullensvang.no ulvik.no utsira.no vadso.no vadsø.no cahcesuolo.no čáhcesuolo.no vaksdal.no valle.no vang.no vanylven.no vardo.no vardø.no varggat.no várggát.no vefsn.no vaapste.no vega.no vegarshei.no vegårshei.no vennesla.no verdal.no verran.no vestby.no vestnes.no vestre-slidre.no vestre-toten.no vestvagoy.no vestvågøy.no vevelstad.no vik.no vikna.no vindafjord.no volda.no voss.no varoy.no værøy.no vagan.no vågan.no voagat.no vagsoy.no vågsøy.no vaga.no vågå.no valer.ostfold.no våler.østfold.no valer.hedmark.no våler.hedmark.no // np : http://www.mos.com.np/register.html *.np // nr : http://cenpac.net.nr/dns/index.html // Submitted by registry nr biz.nr info.nr gov.nr edu.nr org.nr net.nr com.nr // nu : https://en.wikipedia.org/wiki/.nu nu // nz : https://en.wikipedia.org/wiki/.nz // Submitted by registry nz ac.nz co.nz cri.nz geek.nz gen.nz govt.nz health.nz iwi.nz kiwi.nz maori.nz mil.nz māori.nz net.nz org.nz parliament.nz school.nz // om : https://en.wikipedia.org/wiki/.om om co.om com.om edu.om gov.om med.om museum.om net.om org.om pro.om // onion : https://tools.ietf.org/html/rfc7686 onion // org : https://en.wikipedia.org/wiki/.org org // pa : http://www.nic.pa/ // Some additional second level "domains" resolve directly as hostnames, such as // pannet.pa, so we add a rule for "pa". pa ac.pa gob.pa com.pa org.pa sld.pa edu.pa net.pa ing.pa abo.pa med.pa nom.pa // pe : https://www.nic.pe/InformeFinalComision.pdf pe edu.pe gob.pe nom.pe mil.pe org.pe com.pe net.pe // pf : http://www.gobin.info/domainname/formulaire-pf.pdf pf com.pf org.pf edu.pf // pg : https://en.wikipedia.org/wiki/.pg *.pg // ph : http://www.domains.ph/FAQ2.asp // Submitted by registry ph com.ph net.ph org.ph gov.ph edu.ph ngo.ph mil.ph i.ph // pk : http://pk5.pknic.net.pk/pk5/msgNamepk.PK pk com.pk net.pk edu.pk org.pk fam.pk biz.pk web.pk gov.pk gob.pk gok.pk gon.pk gop.pk gos.pk info.pk // pl http://www.dns.pl/english/index.html // Submitted by registry pl com.pl net.pl org.pl // pl functional domains (http://www.dns.pl/english/index.html) aid.pl agro.pl atm.pl auto.pl biz.pl edu.pl gmina.pl gsm.pl info.pl mail.pl miasta.pl media.pl mil.pl nieruchomosci.pl nom.pl pc.pl powiat.pl priv.pl realestate.pl rel.pl sex.pl shop.pl sklep.pl sos.pl szkola.pl targi.pl tm.pl tourism.pl travel.pl turystyka.pl // Government domains gov.pl ap.gov.pl ic.gov.pl is.gov.pl us.gov.pl kmpsp.gov.pl kppsp.gov.pl kwpsp.gov.pl psp.gov.pl wskr.gov.pl kwp.gov.pl mw.gov.pl ug.gov.pl um.gov.pl umig.gov.pl ugim.gov.pl upow.gov.pl uw.gov.pl starostwo.gov.pl pa.gov.pl po.gov.pl psse.gov.pl pup.gov.pl rzgw.gov.pl sa.gov.pl so.gov.pl sr.gov.pl wsa.gov.pl sko.gov.pl uzs.gov.pl wiih.gov.pl winb.gov.pl pinb.gov.pl wios.gov.pl witd.gov.pl wzmiuw.gov.pl piw.gov.pl wiw.gov.pl griw.gov.pl wif.gov.pl oum.gov.pl sdn.gov.pl zp.gov.pl uppo.gov.pl mup.gov.pl wuoz.gov.pl konsulat.gov.pl oirm.gov.pl // pl regional domains (http://www.dns.pl/english/index.html) augustow.pl babia-gora.pl bedzin.pl beskidy.pl bialowieza.pl bialystok.pl bielawa.pl bieszczady.pl boleslawiec.pl bydgoszcz.pl bytom.pl cieszyn.pl czeladz.pl czest.pl dlugoleka.pl elblag.pl elk.pl glogow.pl gniezno.pl gorlice.pl grajewo.pl ilawa.pl jaworzno.pl jelenia-gora.pl jgora.pl kalisz.pl kazimierz-dolny.pl karpacz.pl kartuzy.pl kaszuby.pl katowice.pl kepno.pl ketrzyn.pl klodzko.pl kobierzyce.pl kolobrzeg.pl konin.pl konskowola.pl kutno.pl lapy.pl lebork.pl legnica.pl lezajsk.pl limanowa.pl lomza.pl lowicz.pl lubin.pl lukow.pl malbork.pl malopolska.pl mazowsze.pl mazury.pl mielec.pl mielno.pl mragowo.pl naklo.pl nowaruda.pl nysa.pl olawa.pl olecko.pl olkusz.pl olsztyn.pl opoczno.pl opole.pl ostroda.pl ostroleka.pl ostrowiec.pl ostrowwlkp.pl pila.pl pisz.pl podhale.pl podlasie.pl polkowice.pl pomorze.pl pomorskie.pl prochowice.pl pruszkow.pl przeworsk.pl pulawy.pl radom.pl rawa-maz.pl rybnik.pl rzeszow.pl sanok.pl sejny.pl slask.pl slupsk.pl sosnowiec.pl stalowa-wola.pl skoczow.pl starachowice.pl stargard.pl suwalki.pl swidnica.pl swiebodzin.pl swinoujscie.pl szczecin.pl szczytno.pl tarnobrzeg.pl tgory.pl turek.pl tychy.pl ustka.pl walbrzych.pl warmia.pl warszawa.pl waw.pl wegrow.pl wielun.pl wlocl.pl wloclawek.pl wodzislaw.pl wolomin.pl wroclaw.pl zachpomor.pl zagan.pl zarow.pl zgora.pl zgorzelec.pl // pm : http://www.afnic.fr/medias/documents/AFNIC-naming-policy2012.pdf pm // pn : http://www.government.pn/PnRegistry/policies.htm pn gov.pn co.pn org.pn edu.pn net.pn // post : https://en.wikipedia.org/wiki/.post post // pr : http://www.nic.pr/index.asp?f=1 pr com.pr net.pr org.pr gov.pr edu.pr isla.pr pro.pr biz.pr info.pr name.pr // these aren't mentioned on nic.pr, but on https://en.wikipedia.org/wiki/.pr est.pr prof.pr ac.pr // pro : http://registry.pro/get-pro pro aaa.pro aca.pro acct.pro avocat.pro bar.pro cpa.pro eng.pro jur.pro law.pro med.pro recht.pro // ps : https://en.wikipedia.org/wiki/.ps // http://www.nic.ps/registration/policy.html#reg ps edu.ps gov.ps sec.ps plo.ps com.ps org.ps net.ps // pt : https://www.dns.pt/en/domain/pt-terms-and-conditions-registration-rules/ pt net.pt gov.pt org.pt edu.pt int.pt publ.pt com.pt nome.pt // pw : https://en.wikipedia.org/wiki/.pw pw co.pw ne.pw or.pw ed.pw go.pw belau.pw // py : http://www.nic.py/pautas.html#seccion_9 // Submitted by registry py com.py coop.py edu.py gov.py mil.py net.py org.py // qa : http://domains.qa/en/ qa com.qa edu.qa gov.qa mil.qa name.qa net.qa org.qa sch.qa // re : http://www.afnic.re/obtenir/chartes/nommage-re/annexe-descriptifs re asso.re com.re nom.re // ro : http://www.rotld.ro/ ro arts.ro com.ro firm.ro info.ro nom.ro nt.ro org.ro rec.ro store.ro tm.ro www.ro // rs : https://www.rnids.rs/en/domains/national-domains rs ac.rs co.rs edu.rs gov.rs in.rs org.rs // ru : https://cctld.ru/files/pdf/docs/en/rules_ru-rf.pdf // Submitted by George Georgievsky ru // rw : https://www.ricta.org.rw/sites/default/files/resources/registry_registrar_contract_0.pdf rw ac.rw co.rw coop.rw gov.rw mil.rw net.rw org.rw // sa : http://www.nic.net.sa/ sa com.sa net.sa org.sa gov.sa med.sa pub.sa edu.sa sch.sa // sb : http://www.sbnic.net.sb/ // Submitted by registry sb com.sb edu.sb gov.sb net.sb org.sb // sc : http://www.nic.sc/ sc com.sc gov.sc net.sc org.sc edu.sc // sd : http://www.isoc.sd/sudanic.isoc.sd/billing_pricing.htm // Submitted by registry sd com.sd net.sd org.sd edu.sd med.sd tv.sd gov.sd info.sd // se : https://en.wikipedia.org/wiki/.se // Submitted by registry se a.se ac.se b.se bd.se brand.se c.se d.se e.se f.se fh.se fhsk.se fhv.se g.se h.se i.se k.se komforb.se kommunalforbund.se komvux.se l.se lanbib.se m.se n.se naturbruksgymn.se o.se org.se p.se parti.se pp.se press.se r.se s.se t.se tm.se u.se w.se x.se y.se z.se // sg : http://www.nic.net.sg/page/registration-policies-procedures-and-guidelines sg com.sg net.sg org.sg gov.sg edu.sg per.sg // sh : http://www.nic.sh/registrar.html sh com.sh net.sh gov.sh org.sh mil.sh // si : https://en.wikipedia.org/wiki/.si si // sj : No registrations at this time. // Submitted by registry sj // sk : https://en.wikipedia.org/wiki/.sk // list of 2nd level domains ? sk // sl : http://www.nic.sl // Submitted by registry sl com.sl net.sl edu.sl gov.sl org.sl // sm : https://en.wikipedia.org/wiki/.sm sm // sn : https://en.wikipedia.org/wiki/.sn sn art.sn com.sn edu.sn gouv.sn org.sn perso.sn univ.sn // so : http://sonic.so/policies/ so com.so edu.so gov.so me.so net.so org.so // sr : https://en.wikipedia.org/wiki/.sr sr // ss : https://registry.nic.ss/ // Submitted by registry ss biz.ss com.ss edu.ss gov.ss me.ss net.ss org.ss sch.ss // st : http://www.nic.st/html/policyrules/ st co.st com.st consulado.st edu.st embaixada.st mil.st net.st org.st principe.st saotome.st store.st // su : https://en.wikipedia.org/wiki/.su su // sv : http://www.svnet.org.sv/niveldos.pdf sv com.sv edu.sv gob.sv org.sv red.sv // sx : https://en.wikipedia.org/wiki/.sx // Submitted by registry sx gov.sx // sy : https://en.wikipedia.org/wiki/.sy // see also: http://www.gobin.info/domainname/sy.doc sy edu.sy gov.sy net.sy mil.sy com.sy org.sy // sz : https://en.wikipedia.org/wiki/.sz // http://www.sispa.org.sz/ sz co.sz ac.sz org.sz // tc : https://en.wikipedia.org/wiki/.tc tc // td : https://en.wikipedia.org/wiki/.td td // tel: https://en.wikipedia.org/wiki/.tel // http://www.telnic.org/ tel // tf : https://en.wikipedia.org/wiki/.tf tf // tg : https://en.wikipedia.org/wiki/.tg // http://www.nic.tg/ tg // th : https://en.wikipedia.org/wiki/.th // Submitted by registry th ac.th co.th go.th in.th mi.th net.th or.th // tj : http://www.nic.tj/policy.html tj ac.tj biz.tj co.tj com.tj edu.tj go.tj gov.tj int.tj mil.tj name.tj net.tj nic.tj org.tj test.tj web.tj // tk : https://en.wikipedia.org/wiki/.tk tk // tl : https://en.wikipedia.org/wiki/.tl tl gov.tl // tm : http://www.nic.tm/local.html tm com.tm co.tm org.tm net.tm nom.tm gov.tm mil.tm edu.tm // tn : http://www.registre.tn/fr/ // https://whois.ati.tn/ tn com.tn ens.tn fin.tn gov.tn ind.tn info.tn intl.tn mincom.tn nat.tn net.tn org.tn perso.tn tourism.tn // to : https://en.wikipedia.org/wiki/.to // Submitted by registry to com.to gov.to net.to org.to edu.to mil.to // tr : https://nic.tr/ // https://nic.tr/forms/eng/policies.pdf // https://nic.tr/index.php?USRACTN=PRICELST tr av.tr bbs.tr bel.tr biz.tr com.tr dr.tr edu.tr gen.tr gov.tr info.tr mil.tr k12.tr kep.tr name.tr net.tr org.tr pol.tr tel.tr tsk.tr tv.tr web.tr // Used by Northern Cyprus nc.tr // Used by government agencies of Northern Cyprus gov.nc.tr // tt : http://www.nic.tt/ tt co.tt com.tt org.tt net.tt biz.tt info.tt pro.tt int.tt coop.tt jobs.tt mobi.tt travel.tt museum.tt aero.tt name.tt gov.tt edu.tt // tv : https://en.wikipedia.org/wiki/.tv // Not listing any 2LDs as reserved since none seem to exist in practice, // Wikipedia notwithstanding. tv // tw : https://en.wikipedia.org/wiki/.tw tw edu.tw gov.tw mil.tw com.tw net.tw org.tw idv.tw game.tw ebiz.tw club.tw 網路.tw 組織.tw 商業.tw // tz : http://www.tznic.or.tz/index.php/domains // Submitted by registry tz ac.tz co.tz go.tz hotel.tz info.tz me.tz mil.tz mobi.tz ne.tz or.tz sc.tz tv.tz // ua : https://hostmaster.ua/policy/?ua // Submitted by registry ua // ua 2LD com.ua edu.ua gov.ua in.ua net.ua org.ua // ua geographic names // https://hostmaster.ua/2ld/ cherkassy.ua cherkasy.ua chernigov.ua chernihiv.ua chernivtsi.ua chernovtsy.ua ck.ua cn.ua cr.ua crimea.ua cv.ua dn.ua dnepropetrovsk.ua dnipropetrovsk.ua donetsk.ua dp.ua if.ua ivano-frankivsk.ua kh.ua kharkiv.ua kharkov.ua kherson.ua khmelnitskiy.ua khmelnytskyi.ua kiev.ua kirovograd.ua km.ua kr.ua krym.ua ks.ua kv.ua kyiv.ua lg.ua lt.ua lugansk.ua lutsk.ua lv.ua lviv.ua mk.ua mykolaiv.ua nikolaev.ua od.ua odesa.ua odessa.ua pl.ua poltava.ua rivne.ua rovno.ua rv.ua sb.ua sebastopol.ua sevastopol.ua sm.ua sumy.ua te.ua ternopil.ua uz.ua uzhgorod.ua vinnica.ua vinnytsia.ua vn.ua volyn.ua yalta.ua zaporizhzhe.ua zaporizhzhia.ua zhitomir.ua zhytomyr.ua zp.ua zt.ua // ug : https://www.registry.co.ug/ ug co.ug or.ug ac.ug sc.ug go.ug ne.ug com.ug org.ug // uk : https://en.wikipedia.org/wiki/.uk // Submitted by registry uk ac.uk co.uk gov.uk ltd.uk me.uk net.uk nhs.uk org.uk plc.uk police.uk *.sch.uk // us : https://en.wikipedia.org/wiki/.us us dni.us fed.us isa.us kids.us nsn.us // us geographic names ak.us al.us ar.us as.us az.us ca.us co.us ct.us dc.us de.us fl.us ga.us gu.us hi.us ia.us id.us il.us in.us ks.us ky.us la.us ma.us md.us me.us mi.us mn.us mo.us ms.us mt.us nc.us nd.us ne.us nh.us nj.us nm.us nv.us ny.us oh.us ok.us or.us pa.us pr.us ri.us sc.us sd.us tn.us tx.us ut.us vi.us vt.us va.us wa.us wi.us wv.us wy.us // The registrar notes several more specific domains available in each state, // such as state.*.us, dst.*.us, etc., but resolution of these is somewhat // haphazard; in some states these domains resolve as addresses, while in others // only subdomains are available, or even nothing at all. We include the // most common ones where it's clear that different sites are different // entities. k12.ak.us k12.al.us k12.ar.us k12.as.us k12.az.us k12.ca.us k12.co.us k12.ct.us k12.dc.us k12.de.us k12.fl.us k12.ga.us k12.gu.us // k12.hi.us Bug 614565 - Hawaii has a state-wide DOE login k12.ia.us k12.id.us k12.il.us k12.in.us k12.ks.us k12.ky.us k12.la.us k12.ma.us k12.md.us k12.me.us k12.mi.us k12.mn.us k12.mo.us k12.ms.us k12.mt.us k12.nc.us // k12.nd.us Bug 1028347 - Removed at request of Travis Rosso k12.ne.us k12.nh.us k12.nj.us k12.nm.us k12.nv.us k12.ny.us k12.oh.us k12.ok.us k12.or.us k12.pa.us k12.pr.us // k12.ri.us Removed at request of Kim Cournoyer k12.sc.us // k12.sd.us Bug 934131 - Removed at request of James Booze k12.tn.us k12.tx.us k12.ut.us k12.vi.us k12.vt.us k12.va.us k12.wa.us k12.wi.us // k12.wv.us Bug 947705 - Removed at request of Verne Britton k12.wy.us cc.ak.us cc.al.us cc.ar.us cc.as.us cc.az.us cc.ca.us cc.co.us cc.ct.us cc.dc.us cc.de.us cc.fl.us cc.ga.us cc.gu.us cc.hi.us cc.ia.us cc.id.us cc.il.us cc.in.us cc.ks.us cc.ky.us cc.la.us cc.ma.us cc.md.us cc.me.us cc.mi.us cc.mn.us cc.mo.us cc.ms.us cc.mt.us cc.nc.us cc.nd.us cc.ne.us cc.nh.us cc.nj.us cc.nm.us cc.nv.us cc.ny.us cc.oh.us cc.ok.us cc.or.us cc.pa.us cc.pr.us cc.ri.us cc.sc.us cc.sd.us cc.tn.us cc.tx.us cc.ut.us cc.vi.us cc.vt.us cc.va.us cc.wa.us cc.wi.us cc.wv.us cc.wy.us lib.ak.us lib.al.us lib.ar.us lib.as.us lib.az.us lib.ca.us lib.co.us lib.ct.us lib.dc.us // lib.de.us Issue #243 - Moved to Private section at request of Ed Moore lib.fl.us lib.ga.us lib.gu.us lib.hi.us lib.ia.us lib.id.us lib.il.us lib.in.us lib.ks.us lib.ky.us lib.la.us lib.ma.us lib.md.us lib.me.us lib.mi.us lib.mn.us lib.mo.us lib.ms.us lib.mt.us lib.nc.us lib.nd.us lib.ne.us lib.nh.us lib.nj.us lib.nm.us lib.nv.us lib.ny.us lib.oh.us lib.ok.us lib.or.us lib.pa.us lib.pr.us lib.ri.us lib.sc.us lib.sd.us lib.tn.us lib.tx.us lib.ut.us lib.vi.us lib.vt.us lib.va.us lib.wa.us lib.wi.us // lib.wv.us Bug 941670 - Removed at request of Larry W Arnold lib.wy.us // k12.ma.us contains school districts in Massachusetts. The 4LDs are // managed independently except for private (PVT), charter (CHTR) and // parochial (PAROCH) schools. Those are delegated directly to the // 5LD operators. pvt.k12.ma.us chtr.k12.ma.us paroch.k12.ma.us // Merit Network, Inc. maintains the registry for =~ /(k12|cc|lib).mi.us/ and the following // see also: http://domreg.merit.edu // see also: whois -h whois.domreg.merit.edu help ann-arbor.mi.us cog.mi.us dst.mi.us eaton.mi.us gen.mi.us mus.mi.us tec.mi.us washtenaw.mi.us // uy : http://www.nic.org.uy/ uy com.uy edu.uy gub.uy mil.uy net.uy org.uy // uz : http://www.reg.uz/ uz co.uz com.uz net.uz org.uz // va : https://en.wikipedia.org/wiki/.va va // vc : https://en.wikipedia.org/wiki/.vc // Submitted by registry vc com.vc net.vc org.vc gov.vc mil.vc edu.vc // ve : https://registro.nic.ve/ // Submitted by registry nic@nic.ve and nicve@conatel.gob.ve ve arts.ve bib.ve co.ve com.ve e12.ve edu.ve firm.ve gob.ve gov.ve info.ve int.ve mil.ve net.ve nom.ve org.ve rar.ve rec.ve store.ve tec.ve web.ve // vg : https://en.wikipedia.org/wiki/.vg vg // vi : http://www.nic.vi/newdomainform.htm // http://www.nic.vi/Domain_Rules/body_domain_rules.html indicates some other // TLDs are "reserved", such as edu.vi and gov.vi, but doesn't actually say they // are available for registration (which they do not seem to be). vi co.vi com.vi k12.vi net.vi org.vi // vn : https://www.dot.vn/vnnic/vnnic/domainregistration.jsp vn com.vn net.vn org.vn edu.vn gov.vn int.vn ac.vn biz.vn info.vn name.vn pro.vn health.vn // vu : https://en.wikipedia.org/wiki/.vu // http://www.vunic.vu/ vu com.vu edu.vu net.vu org.vu // wf : http://www.afnic.fr/medias/documents/AFNIC-naming-policy2012.pdf wf // ws : https://en.wikipedia.org/wiki/.ws // http://samoanic.ws/index.dhtml ws com.ws net.ws org.ws gov.ws edu.ws // yt : http://www.afnic.fr/medias/documents/AFNIC-naming-policy2012.pdf yt // IDN ccTLDs // When submitting patches, please maintain a sort by ISO 3166 ccTLD, then // U-label, and follow this format: // // A-Label ("", [, variant info]) : // // [sponsoring org] // U-Label // xn--mgbaam7a8h ("Emerat", Arabic) : AE // http://nic.ae/english/arabicdomain/rules.jsp امارات // xn--y9a3aq ("hye", Armenian) : AM // ISOC AM (operated by .am Registry) հայ // xn--54b7fta0cc ("Bangla", Bangla) : BD বাংলা // xn--90ae ("bg", Bulgarian) : BG бг // xn--mgbcpq6gpa1a ("albahrain", Arabic) : BH البحرين // xn--90ais ("bel", Belarusian/Russian Cyrillic) : BY // Operated by .by registry бел // xn--fiqs8s ("Zhongguo/China", Chinese, Simplified) : CN // CNNIC // http://cnnic.cn/html/Dir/2005/10/11/3218.htm 中国 // xn--fiqz9s ("Zhongguo/China", Chinese, Traditional) : CN // CNNIC // http://cnnic.cn/html/Dir/2005/10/11/3218.htm 中國 // xn--lgbbat1ad8j ("Algeria/Al Jazair", Arabic) : DZ الجزائر // xn--wgbh1c ("Egypt/Masr", Arabic) : EG // http://www.dotmasr.eg/ مصر // xn--e1a4c ("eu", Cyrillic) : EU // https://eurid.eu ею // xn--qxa6a ("eu", Greek) : EU // https://eurid.eu ευ // xn--mgbah1a3hjkrd ("Mauritania", Arabic) : MR موريتانيا // xn--node ("ge", Georgian Mkhedruli) : GE გე // xn--qxam ("el", Greek) : GR // Hellenic Ministry of Infrastructure, Transport, and Networks ελ // xn--j6w193g ("Hong Kong", Chinese) : HK // https://www.hkirc.hk // Submitted by registry // https://www.hkirc.hk/content.jsp?id=30#!/34 香港 公司.香港 教育.香港 政府.香港 個人.香港 網絡.香港 組織.香港 // xn--2scrj9c ("Bharat", Kannada) : IN // India ಭಾರತ // xn--3hcrj9c ("Bharat", Oriya) : IN // India ଭାରତ // xn--45br5cyl ("Bharatam", Assamese) : IN // India ভাৰত // xn--h2breg3eve ("Bharatam", Sanskrit) : IN // India भारतम् // xn--h2brj9c8c ("Bharot", Santali) : IN // India भारोत // xn--mgbgu82a ("Bharat", Sindhi) : IN // India ڀارت // xn--rvc1e0am3e ("Bharatam", Malayalam) : IN // India ഭാരതം // xn--h2brj9c ("Bharat", Devanagari) : IN // India भारत // xn--mgbbh1a ("Bharat", Kashmiri) : IN // India بارت // xn--mgbbh1a71e ("Bharat", Arabic) : IN // India بھارت // xn--fpcrj9c3d ("Bharat", Telugu) : IN // India భారత్ // xn--gecrj9c ("Bharat", Gujarati) : IN // India ભારત // xn--s9brj9c ("Bharat", Gurmukhi) : IN // India ਭਾਰਤ // xn--45brj9c ("Bharat", Bengali) : IN // India ভারত // xn--xkc2dl3a5ee0h ("India", Tamil) : IN // India இந்தியா // xn--mgba3a4f16a ("Iran", Persian) : IR ایران // xn--mgba3a4fra ("Iran", Arabic) : IR ايران // xn--mgbtx2b ("Iraq", Arabic) : IQ // Communications and Media Commission عراق // xn--mgbayh7gpa ("al-Ordon", Arabic) : JO // National Information Technology Center (NITC) // Royal Scientific Society, Al-Jubeiha الاردن // xn--3e0b707e ("Republic of Korea", Hangul) : KR 한국 // xn--80ao21a ("Kaz", Kazakh) : KZ қаз // xn--q7ce6a ("Lao", Lao) : LA ລາວ // xn--fzc2c9e2c ("Lanka", Sinhalese-Sinhala) : LK // https://nic.lk ලංකා // xn--xkc2al3hye2a ("Ilangai", Tamil) : LK // https://nic.lk இலங்கை // xn--mgbc0a9azcg ("Morocco/al-Maghrib", Arabic) : MA المغرب // xn--d1alf ("mkd", Macedonian) : MK // MARnet мкд // xn--l1acc ("mon", Mongolian) : MN мон // xn--mix891f ("Macao", Chinese, Traditional) : MO // MONIC / HNET Asia (Registry Operator for .mo) 澳門 // xn--mix082f ("Macao", Chinese, Simplified) : MO 澳门 // xn--mgbx4cd0ab ("Malaysia", Malay) : MY مليسيا // xn--mgb9awbf ("Oman", Arabic) : OM عمان // xn--mgbai9azgqp6j ("Pakistan", Urdu/Arabic) : PK پاکستان // xn--mgbai9a5eva00b ("Pakistan", Urdu/Arabic, variant) : PK پاكستان // xn--ygbi2ammx ("Falasteen", Arabic) : PS // The Palestinian National Internet Naming Authority (PNINA) // http://www.pnina.ps فلسطين // xn--90a3ac ("srb", Cyrillic) : RS // https://www.rnids.rs/en/domains/national-domains срб пр.срб орг.срб обр.срб од.срб упр.срб ак.срб // xn--p1ai ("rf", Russian-Cyrillic) : RU // https://cctld.ru/files/pdf/docs/en/rules_ru-rf.pdf // Submitted by George Georgievsky рф // xn--wgbl6a ("Qatar", Arabic) : QA // http://www.ict.gov.qa/ قطر // xn--mgberp4a5d4ar ("AlSaudiah", Arabic) : SA // http://www.nic.net.sa/ السعودية // xn--mgberp4a5d4a87g ("AlSaudiah", Arabic, variant) : SA السعودیة // xn--mgbqly7c0a67fbc ("AlSaudiah", Arabic, variant) : SA السعودیۃ // xn--mgbqly7cvafr ("AlSaudiah", Arabic, variant) : SA السعوديه // xn--mgbpl2fh ("sudan", Arabic) : SD // Operated by .sd registry سودان // xn--yfro4i67o Singapore ("Singapore", Chinese) : SG 新加坡 // xn--clchc0ea0b2g2a9gcd ("Singapore", Tamil) : SG சிங்கப்பூர் // xn--ogbpf8fl ("Syria", Arabic) : SY سورية // xn--mgbtf8fl ("Syria", Arabic, variant) : SY سوريا // xn--o3cw4h ("Thai", Thai) : TH // http://www.thnic.co.th ไทย ศึกษา.ไทย ธุรกิจ.ไทย รัฐบาล.ไทย ทหาร.ไทย เน็ต.ไทย องค์กร.ไทย // xn--pgbs0dh ("Tunisia", Arabic) : TN // http://nic.tn تونس // xn--kpry57d ("Taiwan", Chinese, Traditional) : TW // http://www.twnic.net/english/dn/dn_07a.htm 台灣 // xn--kprw13d ("Taiwan", Chinese, Simplified) : TW // http://www.twnic.net/english/dn/dn_07a.htm 台湾 // xn--nnx388a ("Taiwan", Chinese, variant) : TW 臺灣 // xn--j1amh ("ukr", Cyrillic) : UA укр // xn--mgb2ddes ("AlYemen", Arabic) : YE اليمن // xxx : http://icmregistry.com xxx // ye : http://www.y.net.ye/services/domain_name.htm ye com.ye edu.ye gov.ye net.ye mil.ye org.ye // za : https://www.zadna.org.za/content/page/domain-information/ ac.za agric.za alt.za co.za edu.za gov.za grondar.za law.za mil.za net.za ngo.za nic.za nis.za nom.za org.za school.za tm.za web.za // zm : https://zicta.zm/ // Submitted by registry zm ac.zm biz.zm co.zm com.zm edu.zm gov.zm info.zm mil.zm net.zm org.zm sch.zm // zw : https://www.potraz.gov.zw/ // Confirmed by registry 2017-01-25 zw ac.zw co.zw gov.zw mil.zw org.zw // newGTLDs // List of new gTLDs imported from https://www.icann.org/resources/registries/gtlds/v2/gtlds.json on 2021-10-08T15:12:46Z // This list is auto-generated, don't edit it manually. // aaa : 2015-02-26 American Automobile Association, Inc. aaa // aarp : 2015-05-21 AARP aarp // abarth : 2015-07-30 Fiat Chrysler Automobiles N.V. abarth // abb : 2014-10-24 ABB Ltd abb // abbott : 2014-07-24 Abbott Laboratories, Inc. abbott // abbvie : 2015-07-30 AbbVie Inc. abbvie // abc : 2015-07-30 Disney Enterprises, Inc. abc // able : 2015-06-25 Able Inc. able // abogado : 2014-04-24 Registry Services, LLC abogado // abudhabi : 2015-07-30 Abu Dhabi Systems and Information Centre abudhabi // academy : 2013-11-07 Binky Moon, LLC academy // accenture : 2014-08-15 Accenture plc accenture // accountant : 2014-11-20 dot Accountant Limited accountant // accountants : 2014-03-20 Binky Moon, LLC accountants // aco : 2015-01-08 ACO Severin Ahlmann GmbH & Co. KG aco // actor : 2013-12-12 Dog Beach, LLC actor // adac : 2015-07-16 Allgemeiner Deutscher Automobil-Club e.V. (ADAC) adac // ads : 2014-12-04 Charleston Road Registry Inc. ads // adult : 2014-10-16 ICM Registry AD LLC adult // aeg : 2015-03-19 Aktiebolaget Electrolux aeg // aetna : 2015-05-21 Aetna Life Insurance Company aetna // afamilycompany : 2015-07-23 Johnson Shareholdings, Inc. afamilycompany // afl : 2014-10-02 Australian Football League afl // africa : 2014-03-24 ZA Central Registry NPC trading as Registry.Africa africa // agakhan : 2015-04-23 Fondation Aga Khan (Aga Khan Foundation) agakhan // agency : 2013-11-14 Binky Moon, LLC agency // aig : 2014-12-18 American International Group, Inc. aig // airbus : 2015-07-30 Airbus S.A.S. airbus // airforce : 2014-03-06 Dog Beach, LLC airforce // airtel : 2014-10-24 Bharti Airtel Limited airtel // akdn : 2015-04-23 Fondation Aga Khan (Aga Khan Foundation) akdn // alfaromeo : 2015-07-31 Fiat Chrysler Automobiles N.V. alfaromeo // alibaba : 2015-01-15 Alibaba Group Holding Limited alibaba // alipay : 2015-01-15 Alibaba Group Holding Limited alipay // allfinanz : 2014-07-03 Allfinanz Deutsche Vermögensberatung Aktiengesellschaft allfinanz // allstate : 2015-07-31 Allstate Fire and Casualty Insurance Company allstate // ally : 2015-06-18 Ally Financial Inc. ally // alsace : 2014-07-02 Region Grand Est alsace // alstom : 2015-07-30 ALSTOM alstom // amazon : 2019-12-19 Amazon Registry Services, Inc. amazon // americanexpress : 2015-07-31 American Express Travel Related Services Company, Inc. americanexpress // americanfamily : 2015-07-23 AmFam, Inc. americanfamily // amex : 2015-07-31 American Express Travel Related Services Company, Inc. amex // amfam : 2015-07-23 AmFam, Inc. amfam // amica : 2015-05-28 Amica Mutual Insurance Company amica // amsterdam : 2014-07-24 Gemeente Amsterdam amsterdam // analytics : 2014-12-18 Campus IP LLC analytics // android : 2014-08-07 Charleston Road Registry Inc. android // anquan : 2015-01-08 Beijing Qihu Keji Co., Ltd. anquan // anz : 2015-07-31 Australia and New Zealand Banking Group Limited anz // aol : 2015-09-17 Oath Inc. aol // apartments : 2014-12-11 Binky Moon, LLC apartments // app : 2015-05-14 Charleston Road Registry Inc. app // apple : 2015-05-14 Apple Inc. apple // aquarelle : 2014-07-24 Aquarelle.com aquarelle // arab : 2015-11-12 League of Arab States arab // aramco : 2014-11-20 Aramco Services Company aramco // archi : 2014-02-06 Afilias Limited archi // army : 2014-03-06 Dog Beach, LLC army // art : 2016-03-24 UK Creative Ideas Limited art // arte : 2014-12-11 Association Relative à la Télévision Européenne G.E.I.E. arte // asda : 2015-07-31 Wal-Mart Stores, Inc. asda // associates : 2014-03-06 Binky Moon, LLC associates // athleta : 2015-07-30 The Gap, Inc. athleta // attorney : 2014-03-20 Dog Beach, LLC attorney // auction : 2014-03-20 Dog Beach, LLC auction // audi : 2015-05-21 AUDI Aktiengesellschaft audi // audible : 2015-06-25 Amazon Registry Services, Inc. audible // audio : 2014-03-20 UNR Corp. audio // auspost : 2015-08-13 Australian Postal Corporation auspost // author : 2014-12-18 Amazon Registry Services, Inc. author // auto : 2014-11-13 XYZ.COM LLC auto // autos : 2014-01-09 XYZ.COM LLC autos // avianca : 2015-01-08 Avianca Holdings S.A. avianca // aws : 2015-06-25 AWS Registry LLC aws // axa : 2013-12-19 AXA Group Operations SAS axa // azure : 2014-12-18 Microsoft Corporation azure // baby : 2015-04-09 XYZ.COM LLC baby // baidu : 2015-01-08 Baidu, Inc. baidu // banamex : 2015-07-30 Citigroup Inc. banamex // bananarepublic : 2015-07-31 The Gap, Inc. bananarepublic // band : 2014-06-12 Dog Beach, LLC band // bank : 2014-09-25 fTLD Registry Services LLC bank // bar : 2013-12-12 Punto 2012 Sociedad Anonima Promotora de Inversion de Capital Variable bar // barcelona : 2014-07-24 Municipi de Barcelona barcelona // barclaycard : 2014-11-20 Barclays Bank PLC barclaycard // barclays : 2014-11-20 Barclays Bank PLC barclays // barefoot : 2015-06-11 Gallo Vineyards, Inc. barefoot // bargains : 2013-11-14 Binky Moon, LLC bargains // baseball : 2015-10-29 MLB Advanced Media DH, LLC baseball // basketball : 2015-08-20 Fédération Internationale de Basketball (FIBA) basketball // bauhaus : 2014-04-17 Werkhaus GmbH bauhaus // bayern : 2014-01-23 Bayern Connect GmbH bayern // bbc : 2014-12-18 British Broadcasting Corporation bbc // bbt : 2015-07-23 BB&T Corporation bbt // bbva : 2014-10-02 BANCO BILBAO VIZCAYA ARGENTARIA, S.A. bbva // bcg : 2015-04-02 The Boston Consulting Group, Inc. bcg // bcn : 2014-07-24 Municipi de Barcelona bcn // beats : 2015-05-14 Beats Electronics, LLC beats // beauty : 2015-12-03 XYZ.COM LLC beauty // beer : 2014-01-09 Registry Services, LLC beer // bentley : 2014-12-18 Bentley Motors Limited bentley // berlin : 2013-10-31 dotBERLIN GmbH & Co. KG berlin // best : 2013-12-19 BestTLD Pty Ltd best // bestbuy : 2015-07-31 BBY Solutions, Inc. bestbuy // bet : 2015-05-07 Afilias Limited bet // bharti : 2014-01-09 Bharti Enterprises (Holding) Private Limited bharti // bible : 2014-06-19 American Bible Society bible // bid : 2013-12-19 dot Bid Limited bid // bike : 2013-08-27 Binky Moon, LLC bike // bing : 2014-12-18 Microsoft Corporation bing // bingo : 2014-12-04 Binky Moon, LLC bingo // bio : 2014-03-06 Afilias Limited bio // black : 2014-01-16 Afilias Limited black // blackfriday : 2014-01-16 UNR Corp. blackfriday // blockbuster : 2015-07-30 Dish DBS Corporation blockbuster // blog : 2015-05-14 Knock Knock WHOIS There, LLC blog // bloomberg : 2014-07-17 Bloomberg IP Holdings LLC bloomberg // blue : 2013-11-07 Afilias Limited blue // bms : 2014-10-30 Bristol-Myers Squibb Company bms // bmw : 2014-01-09 Bayerische Motoren Werke Aktiengesellschaft bmw // bnpparibas : 2014-05-29 BNP Paribas bnpparibas // boats : 2014-12-04 XYZ.COM LLC boats // boehringer : 2015-07-09 Boehringer Ingelheim International GmbH boehringer // bofa : 2015-07-31 Bank of America Corporation bofa // bom : 2014-10-16 Núcleo de Informação e Coordenação do Ponto BR - NIC.br bom // bond : 2014-06-05 ShortDot SA bond // boo : 2014-01-30 Charleston Road Registry Inc. boo // book : 2015-08-27 Amazon Registry Services, Inc. book // booking : 2015-07-16 Booking.com B.V. booking // bosch : 2015-06-18 Robert Bosch GMBH bosch // bostik : 2015-05-28 Bostik SA bostik // boston : 2015-12-10 Boston TLD Management, LLC boston // bot : 2014-12-18 Amazon Registry Services, Inc. bot // boutique : 2013-11-14 Binky Moon, LLC boutique // box : 2015-11-12 Intercap Registry Inc. box // bradesco : 2014-12-18 Banco Bradesco S.A. bradesco // bridgestone : 2014-12-18 Bridgestone Corporation bridgestone // broadway : 2014-12-22 Celebrate Broadway, Inc. broadway // broker : 2014-12-11 Dog Beach, LLC broker // brother : 2015-01-29 Brother Industries, Ltd. brother // brussels : 2014-02-06 DNS.be vzw brussels // budapest : 2013-11-21 Minds + Machines Group Limited budapest // bugatti : 2015-07-23 Bugatti International SA bugatti // build : 2013-11-07 Plan Bee LLC build // builders : 2013-11-07 Binky Moon, LLC builders // business : 2013-11-07 Binky Moon, LLC business // buy : 2014-12-18 Amazon Registry Services, Inc. buy // buzz : 2013-10-02 DOTSTRATEGY CO. buzz // bzh : 2014-02-27 Association www.bzh bzh // cab : 2013-10-24 Binky Moon, LLC cab // cafe : 2015-02-11 Binky Moon, LLC cafe // cal : 2014-07-24 Charleston Road Registry Inc. cal // call : 2014-12-18 Amazon Registry Services, Inc. call // calvinklein : 2015-07-30 PVH gTLD Holdings LLC calvinklein // cam : 2016-04-21 AC Webconnecting Holding B.V. cam // camera : 2013-08-27 Binky Moon, LLC camera // camp : 2013-11-07 Binky Moon, LLC camp // cancerresearch : 2014-05-15 Australian Cancer Research Foundation cancerresearch // canon : 2014-09-12 Canon Inc. canon // capetown : 2014-03-24 ZA Central Registry NPC trading as ZA Central Registry capetown // capital : 2014-03-06 Binky Moon, LLC capital // capitalone : 2015-08-06 Capital One Financial Corporation capitalone // car : 2015-01-22 XYZ.COM LLC car // caravan : 2013-12-12 Caravan International, Inc. caravan // cards : 2013-12-05 Binky Moon, LLC cards // care : 2014-03-06 Binky Moon, LLC care // career : 2013-10-09 dotCareer LLC career // careers : 2013-10-02 Binky Moon, LLC careers // cars : 2014-11-13 XYZ.COM LLC cars // casa : 2013-11-21 Registry Services, LLC casa // case : 2015-09-03 CNH Industrial N.V. case // cash : 2014-03-06 Binky Moon, LLC cash // casino : 2014-12-18 Binky Moon, LLC casino // catering : 2013-12-05 Binky Moon, LLC catering // catholic : 2015-10-21 Pontificium Consilium de Comunicationibus Socialibus (PCCS) (Pontifical Council for Social Communication) catholic // cba : 2014-06-26 COMMONWEALTH BANK OF AUSTRALIA cba // cbn : 2014-08-22 The Christian Broadcasting Network, Inc. cbn // cbre : 2015-07-02 CBRE, Inc. cbre // cbs : 2015-08-06 CBS Domains Inc. cbs // center : 2013-11-07 Binky Moon, LLC center // ceo : 2013-11-07 CEOTLD Pty Ltd ceo // cern : 2014-06-05 European Organization for Nuclear Research ("CERN") cern // cfa : 2014-08-28 CFA Institute cfa // cfd : 2014-12-11 ShortDot SA cfd // chanel : 2015-04-09 Chanel International B.V. chanel // channel : 2014-05-08 Charleston Road Registry Inc. channel // charity : 2018-04-11 Binky Moon, LLC charity // chase : 2015-04-30 JPMorgan Chase Bank, National Association chase // chat : 2014-12-04 Binky Moon, LLC chat // cheap : 2013-11-14 Binky Moon, LLC cheap // chintai : 2015-06-11 CHINTAI Corporation chintai // christmas : 2013-11-21 UNR Corp. christmas // chrome : 2014-07-24 Charleston Road Registry Inc. chrome // church : 2014-02-06 Binky Moon, LLC church // cipriani : 2015-02-19 Hotel Cipriani Srl cipriani // circle : 2014-12-18 Amazon Registry Services, Inc. circle // cisco : 2014-12-22 Cisco Technology, Inc. cisco // citadel : 2015-07-23 Citadel Domain LLC citadel // citi : 2015-07-30 Citigroup Inc. citi // citic : 2014-01-09 CITIC Group Corporation citic // city : 2014-05-29 Binky Moon, LLC city // cityeats : 2014-12-11 Lifestyle Domain Holdings, Inc. cityeats // claims : 2014-03-20 Binky Moon, LLC claims // cleaning : 2013-12-05 Binky Moon, LLC cleaning // click : 2014-06-05 UNR Corp. click // clinic : 2014-03-20 Binky Moon, LLC clinic // clinique : 2015-10-01 The Estée Lauder Companies Inc. clinique // clothing : 2013-08-27 Binky Moon, LLC clothing // cloud : 2015-04-16 Aruba PEC S.p.A. cloud // club : 2013-11-08 Registry Services, LLC club // clubmed : 2015-06-25 Club Méditerranée S.A. clubmed // coach : 2014-10-09 Binky Moon, LLC coach // codes : 2013-10-31 Binky Moon, LLC codes // coffee : 2013-10-17 Binky Moon, LLC coffee // college : 2014-01-16 XYZ.COM LLC college // cologne : 2014-02-05 dotKoeln GmbH cologne // comcast : 2015-07-23 Comcast IP Holdings I, LLC comcast // commbank : 2014-06-26 COMMONWEALTH BANK OF AUSTRALIA commbank // community : 2013-12-05 Binky Moon, LLC community // company : 2013-11-07 Binky Moon, LLC company // compare : 2015-10-08 Registry Services, LLC compare // computer : 2013-10-24 Binky Moon, LLC computer // comsec : 2015-01-08 VeriSign, Inc. comsec // condos : 2013-12-05 Binky Moon, LLC condos // construction : 2013-09-16 Binky Moon, LLC construction // consulting : 2013-12-05 Dog Beach, LLC consulting // contact : 2015-01-08 Dog Beach, LLC contact // contractors : 2013-09-10 Binky Moon, LLC contractors // cooking : 2013-11-21 Registry Services, LLC cooking // cookingchannel : 2015-07-02 Lifestyle Domain Holdings, Inc. cookingchannel // cool : 2013-11-14 Binky Moon, LLC cool // corsica : 2014-09-25 Collectivité de Corse corsica // country : 2013-12-19 DotCountry LLC country // coupon : 2015-02-26 Amazon Registry Services, Inc. coupon // coupons : 2015-03-26 Binky Moon, LLC coupons // courses : 2014-12-04 OPEN UNIVERSITIES AUSTRALIA PTY LTD courses // cpa : 2019-06-10 American Institute of Certified Public Accountants cpa // credit : 2014-03-20 Binky Moon, LLC credit // creditcard : 2014-03-20 Binky Moon, LLC creditcard // creditunion : 2015-01-22 DotCooperation LLC creditunion // cricket : 2014-10-09 dot Cricket Limited cricket // crown : 2014-10-24 Crown Equipment Corporation crown // crs : 2014-04-03 Federated Co-operatives Limited crs // cruise : 2015-12-10 Viking River Cruises (Bermuda) Ltd. cruise // cruises : 2013-12-05 Binky Moon, LLC cruises // csc : 2014-09-25 Alliance-One Services, Inc. csc // cuisinella : 2014-04-03 SCHMIDT GROUPE S.A.S. cuisinella // cymru : 2014-05-08 Nominet UK cymru // cyou : 2015-01-22 ShortDot SA cyou // dabur : 2014-02-06 Dabur India Limited dabur // dad : 2014-01-23 Charleston Road Registry Inc. dad // dance : 2013-10-24 Dog Beach, LLC dance // data : 2016-06-02 Dish DBS Corporation data // date : 2014-11-20 dot Date Limited date // dating : 2013-12-05 Binky Moon, LLC dating // datsun : 2014-03-27 NISSAN MOTOR CO., LTD. datsun // day : 2014-01-30 Charleston Road Registry Inc. day // dclk : 2014-11-20 Charleston Road Registry Inc. dclk // dds : 2015-05-07 Registry Services, LLC dds // deal : 2015-06-25 Amazon Registry Services, Inc. deal // dealer : 2014-12-22 Intercap Registry Inc. dealer // deals : 2014-05-22 Binky Moon, LLC deals // degree : 2014-03-06 Dog Beach, LLC degree // delivery : 2014-09-11 Binky Moon, LLC delivery // dell : 2014-10-24 Dell Inc. dell // deloitte : 2015-07-31 Deloitte Touche Tohmatsu deloitte // delta : 2015-02-19 Delta Air Lines, Inc. delta // democrat : 2013-10-24 Dog Beach, LLC democrat // dental : 2014-03-20 Binky Moon, LLC dental // dentist : 2014-03-20 Dog Beach, LLC dentist // desi : 2013-11-14 Desi Networks LLC desi // design : 2014-11-07 Registry Services, LLC design // dev : 2014-10-16 Charleston Road Registry Inc. dev // dhl : 2015-07-23 Deutsche Post AG dhl // diamonds : 2013-09-22 Binky Moon, LLC diamonds // diet : 2014-06-26 UNR Corp. diet // digital : 2014-03-06 Binky Moon, LLC digital // direct : 2014-04-10 Binky Moon, LLC direct // directory : 2013-09-20 Binky Moon, LLC directory // discount : 2014-03-06 Binky Moon, LLC discount // discover : 2015-07-23 Discover Financial Services discover // dish : 2015-07-30 Dish DBS Corporation dish // diy : 2015-11-05 Lifestyle Domain Holdings, Inc. diy // dnp : 2013-12-13 Dai Nippon Printing Co., Ltd. dnp // docs : 2014-10-16 Charleston Road Registry Inc. docs // doctor : 2016-06-02 Binky Moon, LLC doctor // dog : 2014-12-04 Binky Moon, LLC dog // domains : 2013-10-17 Binky Moon, LLC domains // dot : 2015-05-21 Dish DBS Corporation dot // download : 2014-11-20 dot Support Limited download // drive : 2015-03-05 Charleston Road Registry Inc. drive // dtv : 2015-06-04 Dish DBS Corporation dtv // dubai : 2015-01-01 Dubai Smart Government Department dubai // duck : 2015-07-23 Johnson Shareholdings, Inc. duck // dunlop : 2015-07-02 The Goodyear Tire & Rubber Company dunlop // dupont : 2015-06-25 DuPont Specialty Products USA, LLC dupont // durban : 2014-03-24 ZA Central Registry NPC trading as ZA Central Registry durban // dvag : 2014-06-23 Deutsche Vermögensberatung Aktiengesellschaft DVAG dvag // dvr : 2016-05-26 DISH Technologies L.L.C. dvr // earth : 2014-12-04 Interlink Co., Ltd. earth // eat : 2014-01-23 Charleston Road Registry Inc. eat // eco : 2016-07-08 Big Room Inc. eco // edeka : 2014-12-18 EDEKA Verband kaufmännischer Genossenschaften e.V. edeka // education : 2013-11-07 Binky Moon, LLC education // email : 2013-10-31 Binky Moon, LLC email // emerck : 2014-04-03 Merck KGaA emerck // energy : 2014-09-11 Binky Moon, LLC energy // engineer : 2014-03-06 Dog Beach, LLC engineer // engineering : 2014-03-06 Binky Moon, LLC engineering // enterprises : 2013-09-20 Binky Moon, LLC enterprises // epson : 2014-12-04 Seiko Epson Corporation epson // equipment : 2013-08-27 Binky Moon, LLC equipment // ericsson : 2015-07-09 Telefonaktiebolaget L M Ericsson ericsson // erni : 2014-04-03 ERNI Group Holding AG erni // esq : 2014-05-08 Charleston Road Registry Inc. esq // estate : 2013-08-27 Binky Moon, LLC estate // etisalat : 2015-09-03 Emirates Telecommunications Corporation (trading as Etisalat) etisalat // eurovision : 2014-04-24 European Broadcasting Union (EBU) eurovision // eus : 2013-12-12 Puntueus Fundazioa eus // events : 2013-12-05 Binky Moon, LLC events // exchange : 2014-03-06 Binky Moon, LLC exchange // expert : 2013-11-21 Binky Moon, LLC expert // exposed : 2013-12-05 Binky Moon, LLC exposed // express : 2015-02-11 Binky Moon, LLC express // extraspace : 2015-05-14 Extra Space Storage LLC extraspace // fage : 2014-12-18 Fage International S.A. fage // fail : 2014-03-06 Binky Moon, LLC fail // fairwinds : 2014-11-13 FairWinds Partners, LLC fairwinds // faith : 2014-11-20 dot Faith Limited faith // family : 2015-04-02 Dog Beach, LLC family // fan : 2014-03-06 Dog Beach, LLC fan // fans : 2014-11-07 ZDNS International Limited fans // farm : 2013-11-07 Binky Moon, LLC farm // farmers : 2015-07-09 Farmers Insurance Exchange farmers // fashion : 2014-07-03 Registry Services, LLC fashion // fast : 2014-12-18 Amazon Registry Services, Inc. fast // fedex : 2015-08-06 Federal Express Corporation fedex // feedback : 2013-12-19 Top Level Spectrum, Inc. feedback // ferrari : 2015-07-31 Fiat Chrysler Automobiles N.V. ferrari // ferrero : 2014-12-18 Ferrero Trading Lux S.A. ferrero // fiat : 2015-07-31 Fiat Chrysler Automobiles N.V. fiat // fidelity : 2015-07-30 Fidelity Brokerage Services LLC fidelity // fido : 2015-08-06 Rogers Communications Canada Inc. fido // film : 2015-01-08 Motion Picture Domain Registry Pty Ltd film // final : 2014-10-16 Núcleo de Informação e Coordenação do Ponto BR - NIC.br final // finance : 2014-03-20 Binky Moon, LLC finance // financial : 2014-03-06 Binky Moon, LLC financial // fire : 2015-06-25 Amazon Registry Services, Inc. fire // firestone : 2014-12-18 Bridgestone Licensing Services, Inc firestone // firmdale : 2014-03-27 Firmdale Holdings Limited firmdale // fish : 2013-12-12 Binky Moon, LLC fish // fishing : 2013-11-21 Registry Services, LLC fishing // fit : 2014-11-07 Registry Services, LLC fit // fitness : 2014-03-06 Binky Moon, LLC fitness // flickr : 2015-04-02 Flickr, Inc. flickr // flights : 2013-12-05 Binky Moon, LLC flights // flir : 2015-07-23 FLIR Systems, Inc. flir // florist : 2013-11-07 Binky Moon, LLC florist // flowers : 2014-10-09 UNR Corp. flowers // fly : 2014-05-08 Charleston Road Registry Inc. fly // foo : 2014-01-23 Charleston Road Registry Inc. foo // food : 2016-04-21 Lifestyle Domain Holdings, Inc. food // foodnetwork : 2015-07-02 Lifestyle Domain Holdings, Inc. foodnetwork // football : 2014-12-18 Binky Moon, LLC football // ford : 2014-11-13 Ford Motor Company ford // forex : 2014-12-11 Dog Beach, LLC forex // forsale : 2014-05-22 Dog Beach, LLC forsale // forum : 2015-04-02 Fegistry, LLC forum // foundation : 2013-12-05 Binky Moon, LLC foundation // fox : 2015-09-11 FOX Registry, LLC fox // free : 2015-12-10 Amazon Registry Services, Inc. free // fresenius : 2015-07-30 Fresenius Immobilien-Verwaltungs-GmbH fresenius // frl : 2014-05-15 FRLregistry B.V. frl // frogans : 2013-12-19 OP3FT frogans // frontdoor : 2015-07-02 Lifestyle Domain Holdings, Inc. frontdoor // frontier : 2015-02-05 Frontier Communications Corporation frontier // ftr : 2015-07-16 Frontier Communications Corporation ftr // fujitsu : 2015-07-30 Fujitsu Limited fujitsu // fun : 2016-01-14 Radix FZC fun // fund : 2014-03-20 Binky Moon, LLC fund // furniture : 2014-03-20 Binky Moon, LLC furniture // futbol : 2013-09-20 Dog Beach, LLC futbol // fyi : 2015-04-02 Binky Moon, LLC fyi // gal : 2013-11-07 Asociación puntoGAL gal // gallery : 2013-09-13 Binky Moon, LLC gallery // gallo : 2015-06-11 Gallo Vineyards, Inc. gallo // gallup : 2015-02-19 Gallup, Inc. gallup // game : 2015-05-28 UNR Corp. game // games : 2015-05-28 Dog Beach, LLC games // gap : 2015-07-31 The Gap, Inc. gap // garden : 2014-06-26 Registry Services, LLC garden // gay : 2019-05-23 Top Level Design, LLC gay // gbiz : 2014-07-17 Charleston Road Registry Inc. gbiz // gdn : 2014-07-31 Joint Stock Company "Navigation-information systems" gdn // gea : 2014-12-04 GEA Group Aktiengesellschaft gea // gent : 2014-01-23 COMBELL NV gent // genting : 2015-03-12 Resorts World Inc Pte. Ltd. genting // george : 2015-07-31 Wal-Mart Stores, Inc. george // ggee : 2014-01-09 GMO Internet, Inc. ggee // gift : 2013-10-17 DotGift, LLC gift // gifts : 2014-07-03 Binky Moon, LLC gifts // gives : 2014-03-06 Dog Beach, LLC gives // giving : 2014-11-13 Giving Limited giving // glade : 2015-07-23 Johnson Shareholdings, Inc. glade // glass : 2013-11-07 Binky Moon, LLC glass // gle : 2014-07-24 Charleston Road Registry Inc. gle // global : 2014-04-17 Dot Global Domain Registry Limited global // globo : 2013-12-19 Globo Comunicação e Participações S.A globo // gmail : 2014-05-01 Charleston Road Registry Inc. gmail // gmbh : 2016-01-29 Binky Moon, LLC gmbh // gmo : 2014-01-09 GMO Internet, Inc. gmo // gmx : 2014-04-24 1&1 Mail & Media GmbH gmx // godaddy : 2015-07-23 Go Daddy East, LLC godaddy // gold : 2015-01-22 Binky Moon, LLC gold // goldpoint : 2014-11-20 YODOBASHI CAMERA CO.,LTD. goldpoint // golf : 2014-12-18 Binky Moon, LLC golf // goo : 2014-12-18 NTT Resonant Inc. goo // goodyear : 2015-07-02 The Goodyear Tire & Rubber Company goodyear // goog : 2014-11-20 Charleston Road Registry Inc. goog // google : 2014-07-24 Charleston Road Registry Inc. google // gop : 2014-01-16 Republican State Leadership Committee, Inc. gop // got : 2014-12-18 Amazon Registry Services, Inc. got // grainger : 2015-05-07 Grainger Registry Services, LLC grainger // graphics : 2013-09-13 Binky Moon, LLC graphics // gratis : 2014-03-20 Binky Moon, LLC gratis // green : 2014-05-08 Afilias Limited green // gripe : 2014-03-06 Binky Moon, LLC gripe // grocery : 2016-06-16 Wal-Mart Stores, Inc. grocery // group : 2014-08-15 Binky Moon, LLC group // guardian : 2015-07-30 The Guardian Life Insurance Company of America guardian // gucci : 2014-11-13 Guccio Gucci S.p.a. gucci // guge : 2014-08-28 Charleston Road Registry Inc. guge // guide : 2013-09-13 Binky Moon, LLC guide // guitars : 2013-11-14 UNR Corp. guitars // guru : 2013-08-27 Binky Moon, LLC guru // hair : 2015-12-03 XYZ.COM LLC hair // hamburg : 2014-02-20 Hamburg Top-Level-Domain GmbH hamburg // hangout : 2014-11-13 Charleston Road Registry Inc. hangout // haus : 2013-12-05 Dog Beach, LLC haus // hbo : 2015-07-30 HBO Registry Services, Inc. hbo // hdfc : 2015-07-30 HOUSING DEVELOPMENT FINANCE CORPORATION LIMITED hdfc // hdfcbank : 2015-02-12 HDFC Bank Limited hdfcbank // health : 2015-02-11 DotHealth, LLC health // healthcare : 2014-06-12 Binky Moon, LLC healthcare // help : 2014-06-26 UNR Corp. help // helsinki : 2015-02-05 City of Helsinki helsinki // here : 2014-02-06 Charleston Road Registry Inc. here // hermes : 2014-07-10 HERMES INTERNATIONAL hermes // hgtv : 2015-07-02 Lifestyle Domain Holdings, Inc. hgtv // hiphop : 2014-03-06 UNR Corp. hiphop // hisamitsu : 2015-07-16 Hisamitsu Pharmaceutical Co.,Inc. hisamitsu // hitachi : 2014-10-31 Hitachi, Ltd. hitachi // hiv : 2014-03-13 UNR Corp. hiv // hkt : 2015-05-14 PCCW-HKT DataCom Services Limited hkt // hockey : 2015-03-19 Binky Moon, LLC hockey // holdings : 2013-08-27 Binky Moon, LLC holdings // holiday : 2013-11-07 Binky Moon, LLC holiday // homedepot : 2015-04-02 Home Depot Product Authority, LLC homedepot // homegoods : 2015-07-16 The TJX Companies, Inc. homegoods // homes : 2014-01-09 XYZ.COM LLC homes // homesense : 2015-07-16 The TJX Companies, Inc. homesense // honda : 2014-12-18 Honda Motor Co., Ltd. honda // horse : 2013-11-21 Registry Services, LLC horse // hospital : 2016-10-20 Binky Moon, LLC hospital // host : 2014-04-17 Radix FZC host // hosting : 2014-05-29 UNR Corp. hosting // hot : 2015-08-27 Amazon Registry Services, Inc. hot // hoteles : 2015-03-05 Travel Reservations SRL hoteles // hotels : 2016-04-07 Booking.com B.V. hotels // hotmail : 2014-12-18 Microsoft Corporation hotmail // house : 2013-11-07 Binky Moon, LLC house // how : 2014-01-23 Charleston Road Registry Inc. how // hsbc : 2014-10-24 HSBC Global Services (UK) Limited hsbc // hughes : 2015-07-30 Hughes Satellite Systems Corporation hughes // hyatt : 2015-07-30 Hyatt GTLD, L.L.C. hyatt // hyundai : 2015-07-09 Hyundai Motor Company hyundai // ibm : 2014-07-31 International Business Machines Corporation ibm // icbc : 2015-02-19 Industrial and Commercial Bank of China Limited icbc // ice : 2014-10-30 IntercontinentalExchange, Inc. ice // icu : 2015-01-08 ShortDot SA icu // ieee : 2015-07-23 IEEE Global LLC ieee // ifm : 2014-01-30 ifm electronic gmbh ifm // ikano : 2015-07-09 Ikano S.A. ikano // imamat : 2015-08-06 Fondation Aga Khan (Aga Khan Foundation) imamat // imdb : 2015-06-25 Amazon Registry Services, Inc. imdb // immo : 2014-07-10 Binky Moon, LLC immo // immobilien : 2013-11-07 Dog Beach, LLC immobilien // inc : 2018-03-10 Intercap Registry Inc. inc // industries : 2013-12-05 Binky Moon, LLC industries // infiniti : 2014-03-27 NISSAN MOTOR CO., LTD. infiniti // ing : 2014-01-23 Charleston Road Registry Inc. ing // ink : 2013-12-05 Top Level Design, LLC ink // institute : 2013-11-07 Binky Moon, LLC institute // insurance : 2015-02-19 fTLD Registry Services LLC insurance // insure : 2014-03-20 Binky Moon, LLC insure // international : 2013-11-07 Binky Moon, LLC international // intuit : 2015-07-30 Intuit Administrative Services, Inc. intuit // investments : 2014-03-20 Binky Moon, LLC investments // ipiranga : 2014-08-28 Ipiranga Produtos de Petroleo S.A. ipiranga // irish : 2014-08-07 Binky Moon, LLC irish // ismaili : 2015-08-06 Fondation Aga Khan (Aga Khan Foundation) ismaili // ist : 2014-08-28 Istanbul Metropolitan Municipality ist // istanbul : 2014-08-28 Istanbul Metropolitan Municipality istanbul // itau : 2014-10-02 Itau Unibanco Holding S.A. itau // itv : 2015-07-09 ITV Services Limited itv // jaguar : 2014-11-13 Jaguar Land Rover Ltd jaguar // java : 2014-06-19 Oracle Corporation java // jcb : 2014-11-20 JCB Co., Ltd. jcb // jeep : 2015-07-30 FCA US LLC. jeep // jetzt : 2014-01-09 Binky Moon, LLC jetzt // jewelry : 2015-03-05 Binky Moon, LLC jewelry // jio : 2015-04-02 Reliance Industries Limited jio // jll : 2015-04-02 Jones Lang LaSalle Incorporated jll // jmp : 2015-03-26 Matrix IP LLC jmp // jnj : 2015-06-18 Johnson & Johnson Services, Inc. jnj // joburg : 2014-03-24 ZA Central Registry NPC trading as ZA Central Registry joburg // jot : 2014-12-18 Amazon Registry Services, Inc. jot // joy : 2014-12-18 Amazon Registry Services, Inc. joy // jpmorgan : 2015-04-30 JPMorgan Chase Bank, National Association jpmorgan // jprs : 2014-09-18 Japan Registry Services Co., Ltd. jprs // juegos : 2014-03-20 UNR Corp. juegos // juniper : 2015-07-30 JUNIPER NETWORKS, INC. juniper // kaufen : 2013-11-07 Dog Beach, LLC kaufen // kddi : 2014-09-12 KDDI CORPORATION kddi // kerryhotels : 2015-04-30 Kerry Trading Co. Limited kerryhotels // kerrylogistics : 2015-04-09 Kerry Trading Co. Limited kerrylogistics // kerryproperties : 2015-04-09 Kerry Trading Co. Limited kerryproperties // kfh : 2014-12-04 Kuwait Finance House kfh // kia : 2015-07-09 KIA MOTORS CORPORATION kia // kids : 2021-08-13 DotKids Foundation Limited kids // kim : 2013-09-23 Afilias Limited kim // kinder : 2014-11-07 Ferrero Trading Lux S.A. kinder // kindle : 2015-06-25 Amazon Registry Services, Inc. kindle // kitchen : 2013-09-20 Binky Moon, LLC kitchen // kiwi : 2013-09-20 DOT KIWI LIMITED kiwi // koeln : 2014-01-09 dotKoeln GmbH koeln // komatsu : 2015-01-08 Komatsu Ltd. komatsu // kosher : 2015-08-20 Kosher Marketing Assets LLC kosher // kpmg : 2015-04-23 KPMG International Cooperative (KPMG International Genossenschaft) kpmg // kpn : 2015-01-08 Koninklijke KPN N.V. kpn // krd : 2013-12-05 KRG Department of Information Technology krd // kred : 2013-12-19 KredTLD Pty Ltd kred // kuokgroup : 2015-04-09 Kerry Trading Co. Limited kuokgroup // kyoto : 2014-11-07 Academic Institution: Kyoto Jyoho Gakuen kyoto // lacaixa : 2014-01-09 Fundación Bancaria Caixa d’Estalvis i Pensions de Barcelona, “la Caixa” lacaixa // lamborghini : 2015-06-04 Automobili Lamborghini S.p.A. lamborghini // lamer : 2015-10-01 The Estée Lauder Companies Inc. lamer // lancaster : 2015-02-12 LANCASTER lancaster // lancia : 2015-07-31 Fiat Chrysler Automobiles N.V. lancia // land : 2013-09-10 Binky Moon, LLC land // landrover : 2014-11-13 Jaguar Land Rover Ltd landrover // lanxess : 2015-07-30 LANXESS Corporation lanxess // lasalle : 2015-04-02 Jones Lang LaSalle Incorporated lasalle // lat : 2014-10-16 ECOM-LAC Federaciòn de Latinoamèrica y el Caribe para Internet y el Comercio Electrònico lat // latino : 2015-07-30 Dish DBS Corporation latino // latrobe : 2014-06-16 La Trobe University latrobe // law : 2015-01-22 Registry Services, LLC law // lawyer : 2014-03-20 Dog Beach, LLC lawyer // lds : 2014-03-20 IRI Domain Management, LLC lds // lease : 2014-03-06 Binky Moon, LLC lease // leclerc : 2014-08-07 A.C.D. LEC Association des Centres Distributeurs Edouard Leclerc leclerc // lefrak : 2015-07-16 LeFrak Organization, Inc. lefrak // legal : 2014-10-16 Binky Moon, LLC legal // lego : 2015-07-16 LEGO Juris A/S lego // lexus : 2015-04-23 TOYOTA MOTOR CORPORATION lexus // lgbt : 2014-05-08 Afilias Limited lgbt // lidl : 2014-09-18 Schwarz Domains und Services GmbH & Co. KG lidl // life : 2014-02-06 Binky Moon, LLC life // lifeinsurance : 2015-01-15 American Council of Life Insurers lifeinsurance // lifestyle : 2014-12-11 Lifestyle Domain Holdings, Inc. lifestyle // lighting : 2013-08-27 Binky Moon, LLC lighting // like : 2014-12-18 Amazon Registry Services, Inc. like // lilly : 2015-07-31 Eli Lilly and Company lilly // limited : 2014-03-06 Binky Moon, LLC limited // limo : 2013-10-17 Binky Moon, LLC limo // lincoln : 2014-11-13 Ford Motor Company lincoln // linde : 2014-12-04 Linde Aktiengesellschaft linde // link : 2013-11-14 UNR Corp. link // lipsy : 2015-06-25 Lipsy Ltd lipsy // live : 2014-12-04 Dog Beach, LLC live // living : 2015-07-30 Lifestyle Domain Holdings, Inc. living // lixil : 2015-03-19 LIXIL Group Corporation lixil // llc : 2017-12-14 Afilias Limited llc // llp : 2019-08-26 UNR Corp. llp // loan : 2014-11-20 dot Loan Limited loan // loans : 2014-03-20 Binky Moon, LLC loans // locker : 2015-06-04 Dish DBS Corporation locker // locus : 2015-06-25 Locus Analytics LLC locus // loft : 2015-07-30 Annco, Inc. loft // lol : 2015-01-30 UNR Corp. lol // london : 2013-11-14 Dot London Domains Limited london // lotte : 2014-11-07 Lotte Holdings Co., Ltd. lotte // lotto : 2014-04-10 Afilias Limited lotto // love : 2014-12-22 Merchant Law Group LLP love // lpl : 2015-07-30 LPL Holdings, Inc. lpl // lplfinancial : 2015-07-30 LPL Holdings, Inc. lplfinancial // ltd : 2014-09-25 Binky Moon, LLC ltd // ltda : 2014-04-17 InterNetX, Corp ltda // lundbeck : 2015-08-06 H. Lundbeck A/S lundbeck // luxe : 2014-01-09 Registry Services, LLC luxe // luxury : 2013-10-17 Luxury Partners, LLC luxury // macys : 2015-07-31 Macys, Inc. macys // madrid : 2014-05-01 Comunidad de Madrid madrid // maif : 2014-10-02 Mutuelle Assurance Instituteur France (MAIF) maif // maison : 2013-12-05 Binky Moon, LLC maison // makeup : 2015-01-15 XYZ.COM LLC makeup // man : 2014-12-04 MAN SE man // management : 2013-11-07 Binky Moon, LLC management // mango : 2013-10-24 PUNTO FA S.L. mango // map : 2016-06-09 Charleston Road Registry Inc. map // market : 2014-03-06 Dog Beach, LLC market // marketing : 2013-11-07 Binky Moon, LLC marketing // markets : 2014-12-11 Dog Beach, LLC markets // marriott : 2014-10-09 Marriott Worldwide Corporation marriott // marshalls : 2015-07-16 The TJX Companies, Inc. marshalls // maserati : 2015-07-31 Fiat Chrysler Automobiles N.V. maserati // mattel : 2015-08-06 Mattel Sites, Inc. mattel // mba : 2015-04-02 Binky Moon, LLC mba // mckinsey : 2015-07-31 McKinsey Holdings, Inc. mckinsey // med : 2015-08-06 Medistry LLC med // media : 2014-03-06 Binky Moon, LLC media // meet : 2014-01-16 Charleston Road Registry Inc. meet // melbourne : 2014-05-29 The Crown in right of the State of Victoria, represented by its Department of State Development, Business and Innovation melbourne // meme : 2014-01-30 Charleston Road Registry Inc. meme // memorial : 2014-10-16 Dog Beach, LLC memorial // men : 2015-02-26 Exclusive Registry Limited men // menu : 2013-09-11 Dot Menu Registry, LLC menu // merckmsd : 2016-07-14 MSD Registry Holdings, Inc. merckmsd // miami : 2013-12-19 Minds + Machines Group Limited miami // microsoft : 2014-12-18 Microsoft Corporation microsoft // mini : 2014-01-09 Bayerische Motoren Werke Aktiengesellschaft mini // mint : 2015-07-30 Intuit Administrative Services, Inc. mint // mit : 2015-07-02 Massachusetts Institute of Technology mit // mitsubishi : 2015-07-23 Mitsubishi Corporation mitsubishi // mlb : 2015-05-21 MLB Advanced Media DH, LLC mlb // mls : 2015-04-23 The Canadian Real Estate Association mls // mma : 2014-11-07 MMA IARD mma // mobile : 2016-06-02 Dish DBS Corporation mobile // moda : 2013-11-07 Dog Beach, LLC moda // moe : 2013-11-13 Interlink Co., Ltd. moe // moi : 2014-12-18 Amazon Registry Services, Inc. moi // mom : 2015-04-16 UNR Corp. mom // monash : 2013-09-30 Monash University monash // money : 2014-10-16 Binky Moon, LLC money // monster : 2015-09-11 XYZ.COM LLC monster // mormon : 2013-12-05 IRI Domain Management, LLC mormon // mortgage : 2014-03-20 Dog Beach, LLC mortgage // moscow : 2013-12-19 Foundation for Assistance for Internet Technologies and Infrastructure Development (FAITID) moscow // moto : 2015-06-04 Motorola Trademark Holdings, LLC moto // motorcycles : 2014-01-09 XYZ.COM LLC motorcycles // mov : 2014-01-30 Charleston Road Registry Inc. mov // movie : 2015-02-05 Binky Moon, LLC movie // msd : 2015-07-23 MSD Registry Holdings, Inc. msd // mtn : 2014-12-04 MTN Dubai Limited mtn // mtr : 2015-03-12 MTR Corporation Limited mtr // music : 2021-05-04 DotMusic Limited music // mutual : 2015-04-02 Northwestern Mutual MU TLD Registry, LLC mutual // nab : 2015-08-20 National Australia Bank Limited nab // nagoya : 2013-10-24 GMO Registry, Inc. nagoya // natura : 2015-03-12 NATURA COSMÉTICOS S.A. natura // navy : 2014-03-06 Dog Beach, LLC navy // nba : 2015-07-31 NBA REGISTRY, LLC nba // nec : 2015-01-08 NEC Corporation nec // netbank : 2014-06-26 COMMONWEALTH BANK OF AUSTRALIA netbank // netflix : 2015-06-18 Netflix, Inc. netflix // network : 2013-11-14 Binky Moon, LLC network // neustar : 2013-12-05 NeuStar, Inc. neustar // new : 2014-01-30 Charleston Road Registry Inc. new // news : 2014-12-18 Dog Beach, LLC news // next : 2015-06-18 Next plc next // nextdirect : 2015-06-18 Next plc nextdirect // nexus : 2014-07-24 Charleston Road Registry Inc. nexus // nfl : 2015-07-23 NFL Reg Ops LLC nfl // ngo : 2014-03-06 Public Interest Registry ngo // nhk : 2014-02-13 Japan Broadcasting Corporation (NHK) nhk // nico : 2014-12-04 DWANGO Co., Ltd. nico // nike : 2015-07-23 NIKE, Inc. nike // nikon : 2015-05-21 NIKON CORPORATION nikon // ninja : 2013-11-07 Dog Beach, LLC ninja // nissan : 2014-03-27 NISSAN MOTOR CO., LTD. nissan // nissay : 2015-10-29 Nippon Life Insurance Company nissay // nokia : 2015-01-08 Nokia Corporation nokia // northwesternmutual : 2015-06-18 Northwestern Mutual Registry, LLC northwesternmutual // norton : 2014-12-04 NortonLifeLock Inc. norton // now : 2015-06-25 Amazon Registry Services, Inc. now // nowruz : 2014-09-04 Asia Green IT System Bilgisayar San. ve Tic. Ltd. Sti. nowruz // nowtv : 2015-05-14 Starbucks (HK) Limited nowtv // nra : 2014-05-22 NRA Holdings Company, INC. nra // nrw : 2013-11-21 Minds + Machines GmbH nrw // ntt : 2014-10-31 NIPPON TELEGRAPH AND TELEPHONE CORPORATION ntt // nyc : 2014-01-23 The City of New York by and through the New York City Department of Information Technology & Telecommunications nyc // obi : 2014-09-25 OBI Group Holding SE & Co. KGaA obi // observer : 2015-04-30 Dog Beach, LLC observer // off : 2015-07-23 Johnson Shareholdings, Inc. off // office : 2015-03-12 Microsoft Corporation office // okinawa : 2013-12-05 BRregistry, Inc. okinawa // olayan : 2015-05-14 Crescent Holding GmbH olayan // olayangroup : 2015-05-14 Crescent Holding GmbH olayangroup // oldnavy : 2015-07-31 The Gap, Inc. oldnavy // ollo : 2015-06-04 Dish DBS Corporation ollo // omega : 2015-01-08 The Swatch Group Ltd omega // one : 2014-11-07 One.com A/S one // ong : 2014-03-06 Public Interest Registry ong // onl : 2013-09-16 iRegistry GmbH onl // online : 2015-01-15 Radix FZC online // ooo : 2014-01-09 INFIBEAM AVENUES LIMITED ooo // open : 2015-07-31 American Express Travel Related Services Company, Inc. open // oracle : 2014-06-19 Oracle Corporation oracle // orange : 2015-03-12 Orange Brand Services Limited orange // organic : 2014-03-27 Afilias Limited organic // origins : 2015-10-01 The Estée Lauder Companies Inc. origins // osaka : 2014-09-04 Osaka Registry Co., Ltd. osaka // otsuka : 2013-10-11 Otsuka Holdings Co., Ltd. otsuka // ott : 2015-06-04 Dish DBS Corporation ott // ovh : 2014-01-16 MédiaBC ovh // page : 2014-12-04 Charleston Road Registry Inc. page // panasonic : 2015-07-30 Panasonic Corporation panasonic // paris : 2014-01-30 City of Paris paris // pars : 2014-09-04 Asia Green IT System Bilgisayar San. ve Tic. Ltd. Sti. pars // partners : 2013-12-05 Binky Moon, LLC partners // parts : 2013-12-05 Binky Moon, LLC parts // party : 2014-09-11 Blue Sky Registry Limited party // passagens : 2015-03-05 Travel Reservations SRL passagens // pay : 2015-08-27 Amazon Registry Services, Inc. pay // pccw : 2015-05-14 PCCW Enterprises Limited pccw // pet : 2015-05-07 Afilias Limited pet // pfizer : 2015-09-11 Pfizer Inc. pfizer // pharmacy : 2014-06-19 National Association of Boards of Pharmacy pharmacy // phd : 2016-07-28 Charleston Road Registry Inc. phd // philips : 2014-11-07 Koninklijke Philips N.V. philips // phone : 2016-06-02 Dish DBS Corporation phone // photo : 2013-11-14 UNR Corp. photo // photography : 2013-09-20 Binky Moon, LLC photography // photos : 2013-10-17 Binky Moon, LLC photos // physio : 2014-05-01 PhysBiz Pty Ltd physio // pics : 2013-11-14 UNR Corp. pics // pictet : 2014-06-26 Pictet Europe S.A. pictet // pictures : 2014-03-06 Binky Moon, LLC pictures // pid : 2015-01-08 Top Level Spectrum, Inc. pid // pin : 2014-12-18 Amazon Registry Services, Inc. pin // ping : 2015-06-11 Ping Registry Provider, Inc. ping // pink : 2013-10-01 Afilias Limited pink // pioneer : 2015-07-16 Pioneer Corporation pioneer // pizza : 2014-06-26 Binky Moon, LLC pizza // place : 2014-04-24 Binky Moon, LLC place // play : 2015-03-05 Charleston Road Registry Inc. play // playstation : 2015-07-02 Sony Interactive Entertainment Inc. playstation // plumbing : 2013-09-10 Binky Moon, LLC plumbing // plus : 2015-02-05 Binky Moon, LLC plus // pnc : 2015-07-02 PNC Domain Co., LLC pnc // pohl : 2014-06-23 Deutsche Vermögensberatung Aktiengesellschaft DVAG pohl // poker : 2014-07-03 Afilias Limited poker // politie : 2015-08-20 Politie Nederland politie // porn : 2014-10-16 ICM Registry PN LLC porn // pramerica : 2015-07-30 Prudential Financial, Inc. pramerica // praxi : 2013-12-05 Praxi S.p.A. praxi // press : 2014-04-03 Radix FZC press // prime : 2015-06-25 Amazon Registry Services, Inc. prime // prod : 2014-01-23 Charleston Road Registry Inc. prod // productions : 2013-12-05 Binky Moon, LLC productions // prof : 2014-07-24 Charleston Road Registry Inc. prof // progressive : 2015-07-23 Progressive Casualty Insurance Company progressive // promo : 2014-12-18 Afilias Limited promo // properties : 2013-12-05 Binky Moon, LLC properties // property : 2014-05-22 UNR Corp. property // protection : 2015-04-23 XYZ.COM LLC protection // pru : 2015-07-30 Prudential Financial, Inc. pru // prudential : 2015-07-30 Prudential Financial, Inc. prudential // pub : 2013-12-12 Dog Beach, LLC pub // pwc : 2015-10-29 PricewaterhouseCoopers LLP pwc // qpon : 2013-11-14 dotCOOL, Inc. qpon // quebec : 2013-12-19 PointQuébec Inc quebec // quest : 2015-03-26 XYZ.COM LLC quest // racing : 2014-12-04 Premier Registry Limited racing // radio : 2016-07-21 European Broadcasting Union (EBU) radio // raid : 2015-07-23 Johnson Shareholdings, Inc. raid // read : 2014-12-18 Amazon Registry Services, Inc. read // realestate : 2015-09-11 dotRealEstate LLC realestate // realtor : 2014-05-29 Real Estate Domains LLC realtor // realty : 2015-03-19 Dog Beach, LLC realty // recipes : 2013-10-17 Binky Moon, LLC recipes // red : 2013-11-07 Afilias Limited red // redstone : 2014-10-31 Redstone Haute Couture Co., Ltd. redstone // redumbrella : 2015-03-26 Travelers TLD, LLC redumbrella // rehab : 2014-03-06 Dog Beach, LLC rehab // reise : 2014-03-13 Binky Moon, LLC reise // reisen : 2014-03-06 Binky Moon, LLC reisen // reit : 2014-09-04 National Association of Real Estate Investment Trusts, Inc. reit // reliance : 2015-04-02 Reliance Industries Limited reliance // ren : 2013-12-12 ZDNS International Limited ren // rent : 2014-12-04 XYZ.COM LLC rent // rentals : 2013-12-05 Binky Moon, LLC rentals // repair : 2013-11-07 Binky Moon, LLC repair // report : 2013-12-05 Binky Moon, LLC report // republican : 2014-03-20 Dog Beach, LLC republican // rest : 2013-12-19 Punto 2012 Sociedad Anonima Promotora de Inversion de Capital Variable rest // restaurant : 2014-07-03 Binky Moon, LLC restaurant // review : 2014-11-20 dot Review Limited review // reviews : 2013-09-13 Dog Beach, LLC reviews // rexroth : 2015-06-18 Robert Bosch GMBH rexroth // rich : 2013-11-21 iRegistry GmbH rich // richardli : 2015-05-14 Pacific Century Asset Management (HK) Limited richardli // ricoh : 2014-11-20 Ricoh Company, Ltd. ricoh // ril : 2015-04-02 Reliance Industries Limited ril // rio : 2014-02-27 Empresa Municipal de Informática SA - IPLANRIO rio // rip : 2014-07-10 Dog Beach, LLC rip // rocher : 2014-12-18 Ferrero Trading Lux S.A. rocher // rocks : 2013-11-14 Dog Beach, LLC rocks // rodeo : 2013-12-19 Registry Services, LLC rodeo // rogers : 2015-08-06 Rogers Communications Canada Inc. rogers // room : 2014-12-18 Amazon Registry Services, Inc. room // rsvp : 2014-05-08 Charleston Road Registry Inc. rsvp // rugby : 2016-12-15 World Rugby Strategic Developments Limited rugby // ruhr : 2013-10-02 regiodot GmbH & Co. KG ruhr // run : 2015-03-19 Binky Moon, LLC run // rwe : 2015-04-02 RWE AG rwe // ryukyu : 2014-01-09 BRregistry, Inc. ryukyu // saarland : 2013-12-12 dotSaarland GmbH saarland // safe : 2014-12-18 Amazon Registry Services, Inc. safe // safety : 2015-01-08 Safety Registry Services, LLC. safety // sakura : 2014-12-18 SAKURA Internet Inc. sakura // sale : 2014-10-16 Dog Beach, LLC sale // salon : 2014-12-11 Binky Moon, LLC salon // samsclub : 2015-07-31 Wal-Mart Stores, Inc. samsclub // samsung : 2014-04-03 SAMSUNG SDS CO., LTD samsung // sandvik : 2014-11-13 Sandvik AB sandvik // sandvikcoromant : 2014-11-07 Sandvik AB sandvikcoromant // sanofi : 2014-10-09 Sanofi sanofi // sap : 2014-03-27 SAP AG sap // sarl : 2014-07-03 Binky Moon, LLC sarl // sas : 2015-04-02 Research IP LLC sas // save : 2015-06-25 Amazon Registry Services, Inc. save // saxo : 2014-10-31 Saxo Bank A/S saxo // sbi : 2015-03-12 STATE BANK OF INDIA sbi // sbs : 2014-11-07 ShortDot SA sbs // sca : 2014-03-13 SVENSKA CELLULOSA AKTIEBOLAGET SCA (publ) sca // scb : 2014-02-20 The Siam Commercial Bank Public Company Limited ("SCB") scb // schaeffler : 2015-08-06 Schaeffler Technologies AG & Co. KG schaeffler // schmidt : 2014-04-03 SCHMIDT GROUPE S.A.S. schmidt // scholarships : 2014-04-24 Scholarships.com, LLC scholarships // school : 2014-12-18 Binky Moon, LLC school // schule : 2014-03-06 Binky Moon, LLC schule // schwarz : 2014-09-18 Schwarz Domains und Services GmbH & Co. KG schwarz // science : 2014-09-11 dot Science Limited science // scjohnson : 2015-07-23 Johnson Shareholdings, Inc. scjohnson // scot : 2014-01-23 Dot Scot Registry Limited scot // search : 2016-06-09 Charleston Road Registry Inc. search // seat : 2014-05-22 SEAT, S.A. (Sociedad Unipersonal) seat // secure : 2015-08-27 Amazon Registry Services, Inc. secure // security : 2015-05-14 XYZ.COM LLC security // seek : 2014-12-04 Seek Limited seek // select : 2015-10-08 Registry Services, LLC select // sener : 2014-10-24 Sener Ingeniería y Sistemas, S.A. sener // services : 2014-02-27 Binky Moon, LLC services // ses : 2015-07-23 SES ses // seven : 2015-08-06 Seven West Media Ltd seven // sew : 2014-07-17 SEW-EURODRIVE GmbH & Co KG sew // sex : 2014-11-13 ICM Registry SX LLC sex // sexy : 2013-09-11 UNR Corp. sexy // sfr : 2015-08-13 Societe Francaise du Radiotelephone - SFR sfr // shangrila : 2015-09-03 Shangri‐La International Hotel Management Limited shangrila // sharp : 2014-05-01 Sharp Corporation sharp // shaw : 2015-04-23 Shaw Cablesystems G.P. shaw // shell : 2015-07-30 Shell Information Technology International Inc shell // shia : 2014-09-04 Asia Green IT System Bilgisayar San. ve Tic. Ltd. Sti. shia // shiksha : 2013-11-14 Afilias Limited shiksha // shoes : 2013-10-02 Binky Moon, LLC shoes // shop : 2016-04-08 GMO Registry, Inc. shop // shopping : 2016-03-31 Binky Moon, LLC shopping // shouji : 2015-01-08 Beijing Qihu Keji Co., Ltd. shouji // show : 2015-03-05 Binky Moon, LLC show // showtime : 2015-08-06 CBS Domains Inc. showtime // silk : 2015-06-25 Amazon Registry Services, Inc. silk // sina : 2015-03-12 Sina Corporation sina // singles : 2013-08-27 Binky Moon, LLC singles // site : 2015-01-15 Radix FZC site // ski : 2015-04-09 Afilias Limited ski // skin : 2015-01-15 XYZ.COM LLC skin // sky : 2014-06-19 Sky International AG sky // skype : 2014-12-18 Microsoft Corporation skype // sling : 2015-07-30 DISH Technologies L.L.C. sling // smart : 2015-07-09 Smart Communications, Inc. (SMART) smart // smile : 2014-12-18 Amazon Registry Services, Inc. smile // sncf : 2015-02-19 Société Nationale des Chemins de fer Francais S N C F sncf // soccer : 2015-03-26 Binky Moon, LLC soccer // social : 2013-11-07 Dog Beach, LLC social // softbank : 2015-07-02 SoftBank Group Corp. softbank // software : 2014-03-20 Dog Beach, LLC software // sohu : 2013-12-19 Sohu.com Limited sohu // solar : 2013-11-07 Binky Moon, LLC solar // solutions : 2013-11-07 Binky Moon, LLC solutions // song : 2015-02-26 Amazon Registry Services, Inc. song // sony : 2015-01-08 Sony Corporation sony // soy : 2014-01-23 Charleston Road Registry Inc. soy // spa : 2019-09-19 Asia Spa and Wellness Promotion Council Limited spa // space : 2014-04-03 Radix FZC space // sport : 2017-11-16 Global Association of International Sports Federations (GAISF) sport // spot : 2015-02-26 Amazon Registry Services, Inc. spot // srl : 2015-05-07 InterNetX, Corp srl // stada : 2014-11-13 STADA Arzneimittel AG stada // staples : 2015-07-30 Staples, Inc. staples // star : 2015-01-08 Star India Private Limited star // statebank : 2015-03-12 STATE BANK OF INDIA statebank // statefarm : 2015-07-30 State Farm Mutual Automobile Insurance Company statefarm // stc : 2014-10-09 Saudi Telecom Company stc // stcgroup : 2014-10-09 Saudi Telecom Company stcgroup // stockholm : 2014-12-18 Stockholms kommun stockholm // storage : 2014-12-22 XYZ.COM LLC storage // store : 2015-04-09 Radix FZC store // stream : 2016-01-08 dot Stream Limited stream // studio : 2015-02-11 Dog Beach, LLC studio // study : 2014-12-11 OPEN UNIVERSITIES AUSTRALIA PTY LTD study // style : 2014-12-04 Binky Moon, LLC style // sucks : 2014-12-22 Vox Populi Registry Ltd. sucks // supplies : 2013-12-19 Binky Moon, LLC supplies // supply : 2013-12-19 Binky Moon, LLC supply // support : 2013-10-24 Binky Moon, LLC support // surf : 2014-01-09 Registry Services, LLC surf // surgery : 2014-03-20 Binky Moon, LLC surgery // suzuki : 2014-02-20 SUZUKI MOTOR CORPORATION suzuki // swatch : 2015-01-08 The Swatch Group Ltd swatch // swiss : 2014-10-16 Swiss Confederation swiss // sydney : 2014-09-18 State of New South Wales, Department of Premier and Cabinet sydney // systems : 2013-11-07 Binky Moon, LLC systems // tab : 2014-12-04 Tabcorp Holdings Limited tab // taipei : 2014-07-10 Taipei City Government taipei // talk : 2015-04-09 Amazon Registry Services, Inc. talk // taobao : 2015-01-15 Alibaba Group Holding Limited taobao // target : 2015-07-31 Target Domain Holdings, LLC target // tatamotors : 2015-03-12 Tata Motors Ltd tatamotors // tatar : 2014-04-24 Limited Liability Company "Coordination Center of Regional Domain of Tatarstan Republic" tatar // tattoo : 2013-08-30 UNR Corp. tattoo // tax : 2014-03-20 Binky Moon, LLC tax // taxi : 2015-03-19 Binky Moon, LLC taxi // tci : 2014-09-12 Asia Green IT System Bilgisayar San. ve Tic. Ltd. Sti. tci // tdk : 2015-06-11 TDK Corporation tdk // team : 2015-03-05 Binky Moon, LLC team // tech : 2015-01-30 Radix FZC tech // technology : 2013-09-13 Binky Moon, LLC technology // temasek : 2014-08-07 Temasek Holdings (Private) Limited temasek // tennis : 2014-12-04 Binky Moon, LLC tennis // teva : 2015-07-02 Teva Pharmaceutical Industries Limited teva // thd : 2015-04-02 Home Depot Product Authority, LLC thd // theater : 2015-03-19 Binky Moon, LLC theater // theatre : 2015-05-07 XYZ.COM LLC theatre // tiaa : 2015-07-23 Teachers Insurance and Annuity Association of America tiaa // tickets : 2015-02-05 XYZ.COM LLC tickets // tienda : 2013-11-14 Binky Moon, LLC tienda // tiffany : 2015-01-30 Tiffany and Company tiffany // tips : 2013-09-20 Binky Moon, LLC tips // tires : 2014-11-07 Binky Moon, LLC tires // tirol : 2014-04-24 punkt Tirol GmbH tirol // tjmaxx : 2015-07-16 The TJX Companies, Inc. tjmaxx // tjx : 2015-07-16 The TJX Companies, Inc. tjx // tkmaxx : 2015-07-16 The TJX Companies, Inc. tkmaxx // tmall : 2015-01-15 Alibaba Group Holding Limited tmall // today : 2013-09-20 Binky Moon, LLC today // tokyo : 2013-11-13 GMO Registry, Inc. tokyo // tools : 2013-11-21 Binky Moon, LLC tools // top : 2014-03-20 .TOP Registry top // toray : 2014-12-18 Toray Industries, Inc. toray // toshiba : 2014-04-10 TOSHIBA Corporation toshiba // total : 2015-08-06 Total SA total // tours : 2015-01-22 Binky Moon, LLC tours // town : 2014-03-06 Binky Moon, LLC town // toyota : 2015-04-23 TOYOTA MOTOR CORPORATION toyota // toys : 2014-03-06 Binky Moon, LLC toys // trade : 2014-01-23 Elite Registry Limited trade // trading : 2014-12-11 Dog Beach, LLC trading // training : 2013-11-07 Binky Moon, LLC training // travel : 2015-10-09 Dog Beach, LLC travel // travelchannel : 2015-07-02 Lifestyle Domain Holdings, Inc. travelchannel // travelers : 2015-03-26 Travelers TLD, LLC travelers // travelersinsurance : 2015-03-26 Travelers TLD, LLC travelersinsurance // trust : 2014-10-16 UNR Corp. trust // trv : 2015-03-26 Travelers TLD, LLC trv // tube : 2015-06-11 Latin American Telecom LLC tube // tui : 2014-07-03 TUI AG tui // tunes : 2015-02-26 Amazon Registry Services, Inc. tunes // tushu : 2014-12-18 Amazon Registry Services, Inc. tushu // tvs : 2015-02-19 T V SUNDRAM IYENGAR & SONS LIMITED tvs // ubank : 2015-08-20 National Australia Bank Limited ubank // ubs : 2014-12-11 UBS AG ubs // unicom : 2015-10-15 China United Network Communications Corporation Limited unicom // university : 2014-03-06 Binky Moon, LLC university // uno : 2013-09-11 Radix FZC uno // uol : 2014-05-01 UBN INTERNET LTDA. uol // ups : 2015-06-25 UPS Market Driver, Inc. ups // vacations : 2013-12-05 Binky Moon, LLC vacations // vana : 2014-12-11 Lifestyle Domain Holdings, Inc. vana // vanguard : 2015-09-03 The Vanguard Group, Inc. vanguard // vegas : 2014-01-16 Dot Vegas, Inc. vegas // ventures : 2013-08-27 Binky Moon, LLC ventures // verisign : 2015-08-13 VeriSign, Inc. verisign // versicherung : 2014-03-20 tldbox GmbH versicherung // vet : 2014-03-06 Dog Beach, LLC vet // viajes : 2013-10-17 Binky Moon, LLC viajes // video : 2014-10-16 Dog Beach, LLC video // vig : 2015-05-14 VIENNA INSURANCE GROUP AG Wiener Versicherung Gruppe vig // viking : 2015-04-02 Viking River Cruises (Bermuda) Ltd. viking // villas : 2013-12-05 Binky Moon, LLC villas // vin : 2015-06-18 Binky Moon, LLC vin // vip : 2015-01-22 Registry Services, LLC vip // virgin : 2014-09-25 Virgin Enterprises Limited virgin // visa : 2015-07-30 Visa Worldwide Pte. Limited visa // vision : 2013-12-05 Binky Moon, LLC vision // viva : 2014-11-07 Saudi Telecom Company viva // vivo : 2015-07-31 Telefonica Brasil S.A. vivo // vlaanderen : 2014-02-06 DNS.be vzw vlaanderen // vodka : 2013-12-19 Registry Services, LLC vodka // volkswagen : 2015-05-14 Volkswagen Group of America Inc. volkswagen // volvo : 2015-11-12 Volvo Holding Sverige Aktiebolag volvo // vote : 2013-11-21 Monolith Registry LLC vote // voting : 2013-11-13 Valuetainment Corp. voting // voto : 2013-11-21 Monolith Registry LLC voto // voyage : 2013-08-27 Binky Moon, LLC voyage // vuelos : 2015-03-05 Travel Reservations SRL vuelos // wales : 2014-05-08 Nominet UK wales // walmart : 2015-07-31 Wal-Mart Stores, Inc. walmart // walter : 2014-11-13 Sandvik AB walter // wang : 2013-10-24 Zodiac Wang Limited wang // wanggou : 2014-12-18 Amazon Registry Services, Inc. wanggou // watch : 2013-11-14 Binky Moon, LLC watch // watches : 2014-12-22 Afilias Limited watches // weather : 2015-01-08 International Business Machines Corporation weather // weatherchannel : 2015-03-12 International Business Machines Corporation weatherchannel // webcam : 2014-01-23 dot Webcam Limited webcam // weber : 2015-06-04 Saint-Gobain Weber SA weber // website : 2014-04-03 Radix FZC website // wedding : 2014-04-24 Registry Services, LLC wedding // weibo : 2015-03-05 Sina Corporation weibo // weir : 2015-01-29 Weir Group IP Limited weir // whoswho : 2014-02-20 Who's Who Registry whoswho // wien : 2013-10-28 punkt.wien GmbH wien // wiki : 2013-11-07 Top Level Design, LLC wiki // williamhill : 2014-03-13 William Hill Organization Limited williamhill // win : 2014-11-20 First Registry Limited win // windows : 2014-12-18 Microsoft Corporation windows // wine : 2015-06-18 Binky Moon, LLC wine // winners : 2015-07-16 The TJX Companies, Inc. winners // wme : 2014-02-13 William Morris Endeavor Entertainment, LLC wme // wolterskluwer : 2015-08-06 Wolters Kluwer N.V. wolterskluwer // woodside : 2015-07-09 Woodside Petroleum Limited woodside // work : 2013-12-19 Registry Services, LLC work // works : 2013-11-14 Binky Moon, LLC works // world : 2014-06-12 Binky Moon, LLC world // wow : 2015-10-08 Amazon Registry Services, Inc. wow // wtc : 2013-12-19 World Trade Centers Association, Inc. wtc // wtf : 2014-03-06 Binky Moon, LLC wtf // xbox : 2014-12-18 Microsoft Corporation xbox // xerox : 2014-10-24 Xerox DNHC LLC xerox // xfinity : 2015-07-09 Comcast IP Holdings I, LLC xfinity // xihuan : 2015-01-08 Beijing Qihu Keji Co., Ltd. xihuan // xin : 2014-12-11 Elegant Leader Limited xin // xn--11b4c3d : 2015-01-15 VeriSign Sarl कॉम // xn--1ck2e1b : 2015-02-26 Amazon Registry Services, Inc. セール // xn--1qqw23a : 2014-01-09 Guangzhou YU Wei Information Technology Co., Ltd. 佛山 // xn--30rr7y : 2014-06-12 Excellent First Limited 慈善 // xn--3bst00m : 2013-09-13 Eagle Horizon Limited 集团 // xn--3ds443g : 2013-09-08 TLD REGISTRY LIMITED OY 在线 // xn--3oq18vl8pn36a : 2015-07-02 Volkswagen (China) Investment Co., Ltd. 大众汽车 // xn--3pxu8k : 2015-01-15 VeriSign Sarl 点看 // xn--42c2d9a : 2015-01-15 VeriSign Sarl คอม // xn--45q11c : 2013-11-21 Zodiac Gemini Ltd 八卦 // xn--4gbrim : 2013-10-04 Helium TLDs Ltd موقع // xn--55qw42g : 2013-11-08 China Organizational Name Administration Center 公益 // xn--55qx5d : 2013-11-14 China Internet Network Information Center (CNNIC) 公司 // xn--5su34j936bgsg : 2015-09-03 Shangri‐La International Hotel Management Limited 香格里拉 // xn--5tzm5g : 2014-12-22 Global Website TLD Asia Limited 网站 // xn--6frz82g : 2013-09-23 Afilias Limited 移动 // xn--6qq986b3xl : 2013-09-13 Tycoon Treasure Limited 我爱你 // xn--80adxhks : 2013-12-19 Foundation for Assistance for Internet Technologies and Infrastructure Development (FAITID) москва // xn--80aqecdr1a : 2015-10-21 Pontificium Consilium de Comunicationibus Socialibus (PCCS) (Pontifical Council for Social Communication) католик // xn--80asehdb : 2013-07-14 CORE Association онлайн // xn--80aswg : 2013-07-14 CORE Association сайт // xn--8y0a063a : 2015-03-26 China United Network Communications Corporation Limited 联通 // xn--9dbq2a : 2015-01-15 VeriSign Sarl קום // xn--9et52u : 2014-06-12 RISE VICTORY LIMITED 时尚 // xn--9krt00a : 2015-03-12 Sina Corporation 微博 // xn--b4w605ferd : 2014-08-07 Temasek Holdings (Private) Limited 淡马锡 // xn--bck1b9a5dre4c : 2015-02-26 Amazon Registry Services, Inc. ファッション // xn--c1avg : 2013-11-14 Public Interest Registry орг // xn--c2br7g : 2015-01-15 VeriSign Sarl नेट // xn--cck2b3b : 2015-02-26 Amazon Registry Services, Inc. ストア // xn--cckwcxetd : 2019-12-19 Amazon Registry Services, Inc. アマゾン // xn--cg4bki : 2013-09-27 SAMSUNG SDS CO., LTD 삼성 // xn--czr694b : 2014-01-16 Internet DotTrademark Organisation Limited 商标 // xn--czrs0t : 2013-12-19 Binky Moon, LLC 商店 // xn--czru2d : 2013-11-21 Zodiac Aquarius Limited 商城 // xn--d1acj3b : 2013-11-20 The Foundation for Network Initiatives “The Smart Internet” дети // xn--eckvdtc9d : 2014-12-18 Amazon Registry Services, Inc. ポイント // xn--efvy88h : 2014-08-22 Guangzhou YU Wei Information Technology Co., Ltd. 新闻 // xn--fct429k : 2015-04-09 Amazon Registry Services, Inc. 家電 // xn--fhbei : 2015-01-15 VeriSign Sarl كوم // xn--fiq228c5hs : 2013-09-08 TLD REGISTRY LIMITED OY 中文网 // xn--fiq64b : 2013-10-14 CITIC Group Corporation 中信 // xn--fjq720a : 2014-05-22 Binky Moon, LLC 娱乐 // xn--flw351e : 2014-07-31 Charleston Road Registry Inc. 谷歌 // xn--fzys8d69uvgm : 2015-05-14 PCCW Enterprises Limited 電訊盈科 // xn--g2xx48c : 2015-01-30 Nawang Heli(Xiamen) Network Service Co., LTD. 购物 // xn--gckr3f0f : 2015-02-26 Amazon Registry Services, Inc. クラウド // xn--gk3at1e : 2015-10-08 Amazon Registry Services, Inc. 通販 // xn--hxt814e : 2014-05-15 Zodiac Taurus Limited 网店 // xn--i1b6b1a6a2e : 2013-11-14 Public Interest Registry संगठन // xn--imr513n : 2014-12-11 Internet DotTrademark Organisation Limited 餐厅 // xn--io0a7i : 2013-11-14 China Internet Network Information Center (CNNIC) 网络 // xn--j1aef : 2015-01-15 VeriSign Sarl ком // xn--jlq480n2rg : 2019-12-19 Amazon Registry Services, Inc. 亚马逊 // xn--jlq61u9w7b : 2015-01-08 Nokia Corporation 诺基亚 // xn--jvr189m : 2015-02-26 Amazon Registry Services, Inc. 食品 // xn--kcrx77d1x4a : 2014-11-07 Koninklijke Philips N.V. 飞利浦 // xn--kput3i : 2014-02-13 Beijing RITT-Net Technology Development Co., Ltd 手机 // xn--mgba3a3ejt : 2014-11-20 Aramco Services Company ارامكو // xn--mgba7c0bbn0a : 2015-05-14 Crescent Holding GmbH العليان // xn--mgbaakc7dvf : 2015-09-03 Emirates Telecommunications Corporation (trading as Etisalat) اتصالات // xn--mgbab2bd : 2013-10-31 CORE Association بازار // xn--mgbca7dzdo : 2015-07-30 Abu Dhabi Systems and Information Centre ابوظبي // xn--mgbi4ecexp : 2015-10-21 Pontificium Consilium de Comunicationibus Socialibus (PCCS) (Pontifical Council for Social Communication) كاثوليك // xn--mgbt3dhd : 2014-09-04 Asia Green IT System Bilgisayar San. ve Tic. Ltd. Sti. همراه // xn--mk1bu44c : 2015-01-15 VeriSign Sarl 닷컴 // xn--mxtq1m : 2014-03-06 Net-Chinese Co., Ltd. 政府 // xn--ngbc5azd : 2013-07-13 International Domain Registry Pty. Ltd. شبكة // xn--ngbe9e0a : 2014-12-04 Kuwait Finance House بيتك // xn--ngbrx : 2015-11-12 League of Arab States عرب // xn--nqv7f : 2013-11-14 Public Interest Registry 机构 // xn--nqv7fs00ema : 2013-11-14 Public Interest Registry 组织机构 // xn--nyqy26a : 2014-11-07 Stable Tone Limited 健康 // xn--otu796d : 2017-08-06 Jiang Yu Liang Cai Technology Company Limited 招聘 // xn--p1acf : 2013-12-12 Rusnames Limited рус // xn--pssy2u : 2015-01-15 VeriSign Sarl 大拿 // xn--q9jyb4c : 2013-09-17 Charleston Road Registry Inc. みんな // xn--qcka1pmc : 2014-07-31 Charleston Road Registry Inc. グーグル // xn--rhqv96g : 2013-09-11 Stable Tone Limited 世界 // xn--rovu88b : 2015-02-26 Amazon Registry Services, Inc. 書籍 // xn--ses554g : 2014-01-16 KNET Co., Ltd. 网址 // xn--t60b56a : 2015-01-15 VeriSign Sarl 닷넷 // xn--tckwe : 2015-01-15 VeriSign Sarl コム // xn--tiq49xqyj : 2015-10-21 Pontificium Consilium de Comunicationibus Socialibus (PCCS) (Pontifical Council for Social Communication) 天主教 // xn--unup4y : 2013-07-14 Binky Moon, LLC 游戏 // xn--vermgensberater-ctb : 2014-06-23 Deutsche Vermögensberatung Aktiengesellschaft DVAG vermögensberater // xn--vermgensberatung-pwb : 2014-06-23 Deutsche Vermögensberatung Aktiengesellschaft DVAG vermögensberatung // xn--vhquv : 2013-08-27 Binky Moon, LLC 企业 // xn--vuq861b : 2014-10-16 Beijing Tele-info Network Technology Co., Ltd. 信息 // xn--w4r85el8fhu5dnra : 2015-04-30 Kerry Trading Co. Limited 嘉里大酒店 // xn--w4rs40l : 2015-07-30 Kerry Trading Co. Limited 嘉里 // xn--xhq521b : 2013-11-14 Guangzhou YU Wei Information Technology Co., Ltd. 广东 // xn--zfr164b : 2013-11-08 China Organizational Name Administration Center 政务 // xyz : 2013-12-05 XYZ.COM LLC xyz // yachts : 2014-01-09 XYZ.COM LLC yachts // yahoo : 2015-04-02 Oath Inc. yahoo // yamaxun : 2014-12-18 Amazon Registry Services, Inc. yamaxun // yandex : 2014-04-10 Yandex Europe B.V. yandex // yodobashi : 2014-11-20 YODOBASHI CAMERA CO.,LTD. yodobashi // yoga : 2014-05-29 Registry Services, LLC yoga // yokohama : 2013-12-12 GMO Registry, Inc. yokohama // you : 2015-04-09 Amazon Registry Services, Inc. you // youtube : 2014-05-01 Charleston Road Registry Inc. youtube // yun : 2015-01-08 Beijing Qihu Keji Co., Ltd. yun // zappos : 2015-06-25 Amazon Registry Services, Inc. zappos // zara : 2014-11-07 Industria de Diseño Textil, S.A. (INDITEX, S.A.) zara // zero : 2014-12-18 Amazon Registry Services, Inc. zero // zip : 2014-05-08 Charleston Road Registry Inc. zip // zone : 2013-11-14 Binky Moon, LLC zone // zuerich : 2014-11-07 Kanton Zürich (Canton of Zurich) zuerich // ===END ICANN DOMAINS=== // ===BEGIN PRIVATE DOMAINS=== // (Note: these are in alphabetical order by company name) // 1GB LLC : https://www.1gb.ua/ // Submitted by 1GB LLC cc.ua inf.ua ltd.ua // 611coin : https://611project.org/ 611.to // Aaron Marais' Gitlab pages: https://lab.aaronleem.co.za // Submitted by Aaron Marais graphox.us // accesso Technology Group, plc. : https://accesso.com/ // Submitted by accesso Team *.devcdnaccesso.com // Adobe : https://www.adobe.com/ // Submitted by Ian Boston and Lars Trieloff adobeaemcloud.com *.dev.adobeaemcloud.com hlx.live adobeaemcloud.net hlx.page hlx3.page // Agnat sp. z o.o. : https://domena.pl // Submitted by Przemyslaw Plewa beep.pl // alboto.ca : http://alboto.ca // Submitted by Anton Avramov barsy.ca // Alces Software Ltd : http://alces-software.com // Submitted by Mark J. Titorenko *.compute.estate *.alces.network // all-inkl.com : https://all-inkl.com // Submitted by Werner Kaltofen kasserver.com // Altervista: https://www.altervista.org // Submitted by Carlo Cannas altervista.org // alwaysdata : https://www.alwaysdata.com // Submitted by Cyril alwaysdata.net // Amazon CloudFront : https://aws.amazon.com/cloudfront/ // Submitted by Donavan Miller cloudfront.net // Amazon Elastic Compute Cloud : https://aws.amazon.com/ec2/ // Submitted by Luke Wells *.compute.amazonaws.com *.compute-1.amazonaws.com *.compute.amazonaws.com.cn us-east-1.amazonaws.com // Amazon Elastic Beanstalk : https://aws.amazon.com/elasticbeanstalk/ // Submitted by Luke Wells cn-north-1.eb.amazonaws.com.cn cn-northwest-1.eb.amazonaws.com.cn elasticbeanstalk.com ap-northeast-1.elasticbeanstalk.com ap-northeast-2.elasticbeanstalk.com ap-northeast-3.elasticbeanstalk.com ap-south-1.elasticbeanstalk.com ap-southeast-1.elasticbeanstalk.com ap-southeast-2.elasticbeanstalk.com ca-central-1.elasticbeanstalk.com eu-central-1.elasticbeanstalk.com eu-west-1.elasticbeanstalk.com eu-west-2.elasticbeanstalk.com eu-west-3.elasticbeanstalk.com sa-east-1.elasticbeanstalk.com us-east-1.elasticbeanstalk.com us-east-2.elasticbeanstalk.com us-gov-west-1.elasticbeanstalk.com us-west-1.elasticbeanstalk.com us-west-2.elasticbeanstalk.com // Amazon Elastic Load Balancing : https://aws.amazon.com/elasticloadbalancing/ // Submitted by Luke Wells *.elb.amazonaws.com *.elb.amazonaws.com.cn // Amazon Global Accelerator : https://aws.amazon.com/global-accelerator/ // Submitted by Daniel Massaguer awsglobalaccelerator.com // Amazon S3 : https://aws.amazon.com/s3/ // Submitted by Luke Wells s3.amazonaws.com s3-ap-northeast-1.amazonaws.com s3-ap-northeast-2.amazonaws.com s3-ap-south-1.amazonaws.com s3-ap-southeast-1.amazonaws.com s3-ap-southeast-2.amazonaws.com s3-ca-central-1.amazonaws.com s3-eu-central-1.amazonaws.com s3-eu-west-1.amazonaws.com s3-eu-west-2.amazonaws.com s3-eu-west-3.amazonaws.com s3-external-1.amazonaws.com s3-fips-us-gov-west-1.amazonaws.com s3-sa-east-1.amazonaws.com s3-us-gov-west-1.amazonaws.com s3-us-east-2.amazonaws.com s3-us-west-1.amazonaws.com s3-us-west-2.amazonaws.com s3.ap-northeast-2.amazonaws.com s3.ap-south-1.amazonaws.com s3.cn-north-1.amazonaws.com.cn s3.ca-central-1.amazonaws.com s3.eu-central-1.amazonaws.com s3.eu-west-2.amazonaws.com s3.eu-west-3.amazonaws.com s3.us-east-2.amazonaws.com s3.dualstack.ap-northeast-1.amazonaws.com s3.dualstack.ap-northeast-2.amazonaws.com s3.dualstack.ap-south-1.amazonaws.com s3.dualstack.ap-southeast-1.amazonaws.com s3.dualstack.ap-southeast-2.amazonaws.com s3.dualstack.ca-central-1.amazonaws.com s3.dualstack.eu-central-1.amazonaws.com s3.dualstack.eu-west-1.amazonaws.com s3.dualstack.eu-west-2.amazonaws.com s3.dualstack.eu-west-3.amazonaws.com s3.dualstack.sa-east-1.amazonaws.com s3.dualstack.us-east-1.amazonaws.com s3.dualstack.us-east-2.amazonaws.com s3-website-us-east-1.amazonaws.com s3-website-us-west-1.amazonaws.com s3-website-us-west-2.amazonaws.com s3-website-ap-northeast-1.amazonaws.com s3-website-ap-southeast-1.amazonaws.com s3-website-ap-southeast-2.amazonaws.com s3-website-eu-west-1.amazonaws.com s3-website-sa-east-1.amazonaws.com s3-website.ap-northeast-2.amazonaws.com s3-website.ap-south-1.amazonaws.com s3-website.ca-central-1.amazonaws.com s3-website.eu-central-1.amazonaws.com s3-website.eu-west-2.amazonaws.com s3-website.eu-west-3.amazonaws.com s3-website.us-east-2.amazonaws.com // Amsterdam Wireless: https://www.amsterdamwireless.nl/ // Submitted by Imre Jonk amsw.nl // Amune : https://amune.org/ // Submitted by Team Amune t3l3p0rt.net tele.amune.org // Apigee : https://apigee.com/ // Submitted by Apigee Security Team apigee.io // Apphud : https://apphud.com // Submitted by Alexander Selivanov siiites.com // Appspace : https://www.appspace.com // Submitted by Appspace Security Team appspacehosted.com appspaceusercontent.com // Appudo UG (haftungsbeschränkt) : https://www.appudo.com // Submitted by Alexander Hochbaum appudo.net // Aptible : https://www.aptible.com/ // Submitted by Thomas Orozco on-aptible.com // ASEINet : https://www.aseinet.com/ // Submitted by Asei SEKIGUCHI user.aseinet.ne.jp gv.vc d.gv.vc // Asociación Amigos de la Informática "Euskalamiga" : http://encounter.eus/ // Submitted by Hector Martin user.party.eus // Association potager.org : https://potager.org/ // Submitted by Lunar pimienta.org poivron.org potager.org sweetpepper.org // ASUSTOR Inc. : http://www.asustor.com // Submitted by Vincent Tseng myasustor.com // Atlassian : https://atlassian.com // Submitted by Sam Smyth cdn.prod.atlassian-dev.net // AVM : https://avm.de // Submitted by Andreas Weise myfritz.net // AVStack Pte. Ltd. : https://avstack.io // Submitted by Jasper Hugo onavstack.net // AW AdvisorWebsites.com Software Inc : https://advisorwebsites.com // Submitted by James Kennedy *.awdev.ca *.advisor.ws // AZ.pl sp. z.o.o: https://az.pl // Submited by Krzysztof Wolski ecommerce-shop.pl // b-data GmbH : https://www.b-data.io // Submitted by Olivier Benz b-data.io // backplane : https://www.backplane.io // Submitted by Anthony Voutas backplaneapp.io // Balena : https://www.balena.io // Submitted by Petros Angelatos balena-devices.com // University of Banja Luka : https://unibl.org // Domains for Republic of Srpska administrative entity. // Submitted by Marko Ivanovic rs.ba // Banzai Cloud // Submitted by Janos Matyas *.banzai.cloud app.banzaicloud.io *.backyards.banzaicloud.io // BetaInABox // Submitted by Adrian betainabox.com // BinaryLane : http://www.binarylane.com // Submitted by Nathan O'Sullivan bnr.la // Bitbucket : http://bitbucket.org // Submitted by Andy Ortlieb bitbucket.io // Blackbaud, Inc. : https://www.blackbaud.com // Submitted by Paul Crowder blackbaudcdn.net // Blatech : http://www.blatech.net // Submitted by Luke Bratch of.je // Blue Bite, LLC : https://bluebite.com // Submitted by Joshua Weiss bluebite.io // Boomla : https://boomla.com // Submitted by Tibor Halter boomla.net // Boutir : https://www.boutir.com // Submitted by Eric Ng Ka Ka boutir.com // Boxfuse : https://boxfuse.com // Submitted by Axel Fontaine boxfuse.io // bplaced : https://www.bplaced.net/ // Submitted by Miroslav Bozic square7.ch bplaced.com bplaced.de square7.de bplaced.net square7.net // Brendly : https://brendly.rs // Submitted by Dusan Radovanovic shop.brendly.rs // BrowserSafetyMark // Submitted by Dave Tharp browsersafetymark.io // Bytemark Hosting : https://www.bytemark.co.uk // Submitted by Paul Cammish uk0.bigv.io dh.bytemark.co.uk vm.bytemark.co.uk // Caf.js Labs LLC : https://www.cafjs.com // Submitted by Antonio Lain cafjs.com // callidomus : https://www.callidomus.com/ // Submitted by Marcus Popp mycd.eu // Carrd : https://carrd.co // Submitted by AJ drr.ac uwu.ai carrd.co crd.co ju.mp // CentralNic : http://www.centralnic.com/names/domains // Submitted by registry ae.org br.com cn.com com.de com.se de.com eu.com gb.net hu.net jp.net jpn.com mex.com ru.com sa.com se.net uk.com uk.net us.com za.bz za.com // No longer operated by CentralNic, these entries should be adopted and/or removed by current operators // Submitted by Gavin Brown ar.com gb.com hu.com kr.com no.com qc.com uy.com // Africa.com Web Solutions Ltd : https://registry.africa.com // Submitted by Gavin Brown africa.com // iDOT Services Limited : http://www.domain.gr.com // Submitted by Gavin Brown gr.com // Radix FZC : http://domains.in.net // Submitted by Gavin Brown in.net web.in // US REGISTRY LLC : http://us.org // Submitted by Gavin Brown us.org // co.com Registry, LLC : https://registry.co.com // Submitted by Gavin Brown co.com // Roar Domains LLC : https://roar.basketball/ // Submitted by Gavin Brown aus.basketball nz.basketball // BRS Media : https://brsmedia.com/ // Submitted by Gavin Brown radio.am radio.fm // c.la : http://www.c.la/ c.la // certmgr.org : https://certmgr.org // Submitted by B. Blechschmidt certmgr.org // Cityhost LLC : https://cityhost.ua // Submitted by Maksym Rivtin cx.ua // Civilized Discourse Construction Kit, Inc. : https://www.discourse.org/ // Submitted by Rishabh Nambiar & Michael Brown discourse.group discourse.team // ClearVox : http://www.clearvox.nl/ // Submitted by Leon Rowland virtueeldomein.nl // Clever Cloud : https://www.clever-cloud.com/ // Submitted by Quentin Adam cleverapps.io // Clerk : https://www.clerk.dev // Submitted by Colin Sidoti clerk.app clerkstage.app *.lcl.dev *.lclstage.dev *.stg.dev *.stgstage.dev // ClickRising : https://clickrising.com/ // Submitted by Umut Gumeli clickrising.net // Cloud66 : https://www.cloud66.com/ // Submitted by Khash Sajadi c66.me cloud66.ws cloud66.zone // CloudAccess.net : https://www.cloudaccess.net/ // Submitted by Pawel Panek jdevcloud.com wpdevcloud.com cloudaccess.host freesite.host cloudaccess.net // cloudControl : https://www.cloudcontrol.com/ // Submitted by Tobias Wilken cloudcontrolled.com cloudcontrolapp.com // Cloudera, Inc. : https://www.cloudera.com/ // Submitted by Kedarnath Waikar *.cloudera.site // Cloudflare, Inc. : https://www.cloudflare.com/ // Submitted by Cloudflare Team pages.dev trycloudflare.com workers.dev // Clovyr : https://clovyr.io // Submitted by Patrick Nielsen wnext.app // co.ca : http://registry.co.ca/ co.ca // Co & Co : https://co-co.nl/ // Submitted by Govert Versluis *.otap.co // i-registry s.r.o. : http://www.i-registry.cz/ // Submitted by Martin Semrad co.cz // CDN77.com : http://www.cdn77.com // Submitted by Jan Krpes c.cdn77.org cdn77-ssl.net r.cdn77.net rsc.cdn77.org ssl.origin.cdn77-secure.org // Cloud DNS Ltd : http://www.cloudns.net // Submitted by Aleksander Hristov cloudns.asia cloudns.biz cloudns.club cloudns.cc cloudns.eu cloudns.in cloudns.info cloudns.org cloudns.pro cloudns.pw cloudns.us // CNPY : https://cnpy.gdn // Submitted by Angelo Gladding cnpy.gdn // CoDNS B.V. co.nl co.no // Combell.com : https://www.combell.com // Submitted by Thomas Wouters webhosting.be hosting-cluster.nl // Coordination Center for TLD RU and XN--P1AI : https://cctld.ru/en/domains/domens_ru/reserved/ // Submitted by George Georgievsky ac.ru edu.ru gov.ru int.ru mil.ru test.ru // COSIMO GmbH : http://www.cosimo.de // Submitted by Rene Marticke dyn.cosidns.de dynamisches-dns.de dnsupdater.de internet-dns.de l-o-g-i-n.de dynamic-dns.info feste-ip.net knx-server.net static-access.net // Craynic, s.r.o. : http://www.craynic.com/ // Submitted by Ales Krajnik realm.cz // Cryptonomic : https://cryptonomic.net/ // Submitted by Andrew Cady *.cryptonomic.net // Cupcake : https://cupcake.io/ // Submitted by Jonathan Rudenberg cupcake.is // Curv UG : https://curv-labs.de/ // Submitted by Marvin Wiesner curv.dev // Customer OCI - Oracle Dyn https://cloud.oracle.com/home https://dyn.com/dns/ // Submitted by Gregory Drake // Note: This is intended to also include customer-oci.com due to wildcards implicitly including the current label *.customer-oci.com *.oci.customer-oci.com *.ocp.customer-oci.com *.ocs.customer-oci.com // cyon GmbH : https://www.cyon.ch/ // Submitted by Dominic Luechinger cyon.link cyon.site // Danger Science Group: https://dangerscience.com/ // Submitted by Skylar MacDonald fnwk.site folionetwork.site platform0.app // Daplie, Inc : https://daplie.com // Submitted by AJ ONeal daplie.me localhost.daplie.me // Datto, Inc. : https://www.datto.com/ // Submitted by Philipp Heckel dattolocal.com dattorelay.com dattoweb.com mydatto.com dattolocal.net mydatto.net // Dansk.net : http://www.dansk.net/ // Submitted by Anani Voule biz.dk co.dk firm.dk reg.dk store.dk // dappnode.io : https://dappnode.io/ // Submitted by Abel Boldu / DAppNode Team dyndns.dappnode.io // dapps.earth : https://dapps.earth/ // Submitted by Daniil Burdakov *.dapps.earth *.bzz.dapps.earth // Dark, Inc. : https://darklang.com // Submitted by Paul Biggar builtwithdark.com // DataDetect, LLC. : https://datadetect.com // Submitted by Andrew Banchich demo.datadetect.com instance.datadetect.com // Datawire, Inc : https://www.datawire.io // Submitted by Richard Li edgestack.me // DDNS5 : https://ddns5.com // Submitted by Cameron Elliott ddns5.com // Debian : https://www.debian.org/ // Submitted by Peter Palfrader / Debian Sysadmin Team debian.net // Deno Land Inc : https://deno.com/ // Submitted by Luca Casonato deno.dev deno-staging.dev // deSEC : https://desec.io/ // Submitted by Peter Thomassen dedyn.io // Diher Solutions : https://diher.solutions // Submitted by Didi Hermawan *.rss.my.id *.diher.solutions // DNS Africa Ltd https://dns.business // Submitted by Calvin Browne jozi.biz // DNShome : https://www.dnshome.de/ // Submitted by Norbert Auler dnshome.de // DotArai : https://www.dotarai.com/ // Submitted by Atsadawat Netcharadsang online.th shop.th // DrayTek Corp. : https://www.draytek.com/ // Submitted by Paul Fang drayddns.com // DreamCommerce : https://shoper.pl/ // Submitted by Konrad Kotarba shoparena.pl // DreamHost : http://www.dreamhost.com/ // Submitted by Andrew Farmer dreamhosters.com // Drobo : http://www.drobo.com/ // Submitted by Ricardo Padilha mydrobo.com // Drud Holdings, LLC. : https://www.drud.com/ // Submitted by Kevin Bridges drud.io drud.us // DuckDNS : http://www.duckdns.org/ // Submitted by Richard Harper duckdns.org // Bip : https://bip.sh // Submitted by Joel Kennedy bip.sh // bitbridge.net : Submitted by Craig Welch, abeliidev@gmail.com bitbridge.net // dy.fi : http://dy.fi/ // Submitted by Heikki Hannikainen dy.fi tunk.org // DynDNS.com : http://www.dyndns.com/services/dns/dyndns/ dyndns-at-home.com dyndns-at-work.com dyndns-blog.com dyndns-free.com dyndns-home.com dyndns-ip.com dyndns-mail.com dyndns-office.com dyndns-pics.com dyndns-remote.com dyndns-server.com dyndns-web.com dyndns-wiki.com dyndns-work.com dyndns.biz dyndns.info dyndns.org dyndns.tv at-band-camp.net ath.cx barrel-of-knowledge.info barrell-of-knowledge.info better-than.tv blogdns.com blogdns.net blogdns.org blogsite.org boldlygoingnowhere.org broke-it.net buyshouses.net cechire.com dnsalias.com dnsalias.net dnsalias.org dnsdojo.com dnsdojo.net dnsdojo.org does-it.net doesntexist.com doesntexist.org dontexist.com dontexist.net dontexist.org doomdns.com doomdns.org dvrdns.org dyn-o-saur.com dynalias.com dynalias.net dynalias.org dynathome.net dyndns.ws endofinternet.net endofinternet.org endoftheinternet.org est-a-la-maison.com est-a-la-masion.com est-le-patron.com est-mon-blogueur.com for-better.biz for-more.biz for-our.info for-some.biz for-the.biz forgot.her.name forgot.his.name from-ak.com from-al.com from-ar.com from-az.net from-ca.com from-co.net from-ct.com from-dc.com from-de.com from-fl.com from-ga.com from-hi.com from-ia.com from-id.com from-il.com from-in.com from-ks.com from-ky.com from-la.net from-ma.com from-md.com from-me.org from-mi.com from-mn.com from-mo.com from-ms.com from-mt.com from-nc.com from-nd.com from-ne.com from-nh.com from-nj.com from-nm.com from-nv.com from-ny.net from-oh.com from-ok.com from-or.com from-pa.com from-pr.com from-ri.com from-sc.com from-sd.com from-tn.com from-tx.com from-ut.com from-va.com from-vt.com from-wa.com from-wi.com from-wv.com from-wy.com ftpaccess.cc fuettertdasnetz.de game-host.org game-server.cc getmyip.com gets-it.net go.dyndns.org gotdns.com gotdns.org groks-the.info groks-this.info ham-radio-op.net here-for-more.info hobby-site.com hobby-site.org home.dyndns.org homedns.org homeftp.net homeftp.org homeip.net homelinux.com homelinux.net homelinux.org homeunix.com homeunix.net homeunix.org iamallama.com in-the-band.net is-a-anarchist.com is-a-blogger.com is-a-bookkeeper.com is-a-bruinsfan.org is-a-bulls-fan.com is-a-candidate.org is-a-caterer.com is-a-celticsfan.org is-a-chef.com is-a-chef.net is-a-chef.org is-a-conservative.com is-a-cpa.com is-a-cubicle-slave.com is-a-democrat.com is-a-designer.com is-a-doctor.com is-a-financialadvisor.com is-a-geek.com is-a-geek.net is-a-geek.org is-a-green.com is-a-guru.com is-a-hard-worker.com is-a-hunter.com is-a-knight.org is-a-landscaper.com is-a-lawyer.com is-a-liberal.com is-a-libertarian.com is-a-linux-user.org is-a-llama.com is-a-musician.com is-a-nascarfan.com is-a-nurse.com is-a-painter.com is-a-patsfan.org is-a-personaltrainer.com is-a-photographer.com is-a-player.com is-a-republican.com is-a-rockstar.com is-a-socialist.com is-a-soxfan.org is-a-student.com is-a-teacher.com is-a-techie.com is-a-therapist.com is-an-accountant.com is-an-actor.com is-an-actress.com is-an-anarchist.com is-an-artist.com is-an-engineer.com is-an-entertainer.com is-by.us is-certified.com is-found.org is-gone.com is-into-anime.com is-into-cars.com is-into-cartoons.com is-into-games.com is-leet.com is-lost.org is-not-certified.com is-saved.org is-slick.com is-uberleet.com is-very-bad.org is-very-evil.org is-very-good.org is-very-nice.org is-very-sweet.org is-with-theband.com isa-geek.com isa-geek.net isa-geek.org isa-hockeynut.com issmarterthanyou.com isteingeek.de istmein.de kicks-ass.net kicks-ass.org knowsitall.info land-4-sale.us lebtimnetz.de leitungsen.de likes-pie.com likescandy.com merseine.nu mine.nu misconfused.org mypets.ws myphotos.cc neat-url.com office-on-the.net on-the-web.tv podzone.net podzone.org readmyblog.org saves-the-whales.com scrapper-site.net scrapping.cc selfip.biz selfip.com selfip.info selfip.net selfip.org sells-for-less.com sells-for-u.com sells-it.net sellsyourhome.org servebbs.com servebbs.net servebbs.org serveftp.net serveftp.org servegame.org shacknet.nu simple-url.com space-to-rent.com stuff-4-sale.org stuff-4-sale.us teaches-yoga.com thruhere.net traeumtgerade.de webhop.biz webhop.info webhop.net webhop.org worse-than.tv writesthisblog.com // ddnss.de : https://www.ddnss.de/ // Submitted by Robert Niedziela ddnss.de dyn.ddnss.de dyndns.ddnss.de dyndns1.de dyn-ip24.de home-webserver.de dyn.home-webserver.de myhome-server.de ddnss.org // Definima : http://www.definima.com/ // Submitted by Maxence Bitterli definima.net definima.io // DigitalOcean App Platform : https://www.digitalocean.com/products/app-platform/ // Submitted by Braxton Huggins ondigitalocean.app // DigitalOcean Spaces : https://www.digitalocean.com/products/spaces/ // Submitted by Robin H. Johnson *.digitaloceanspaces.com // dnstrace.pro : https://dnstrace.pro/ // Submitted by Chris Partridge bci.dnstrace.pro // Dynu.com : https://www.dynu.com/ // Submitted by Sue Ye ddnsfree.com ddnsgeek.com giize.com gleeze.com kozow.com loseyourip.com ooguy.com theworkpc.com casacam.net dynu.net accesscam.org camdvr.org freeddns.org mywire.org webredirect.org myddns.rocks blogsite.xyz // dynv6 : https://dynv6.com // Submitted by Dominik Menke dynv6.net // Ellucian : https://ellucian.com // Submitted by Josue Colon elluciancrmadvance.com elluciancrmadvise.com elluciancrmrecruit.com // E4YOU spol. s.r.o. : https://e4you.cz/ // Submitted by Vladimir Dudr e4.cz // eero : https://eero.com/ // Submitted by Yue Kang eero.online eero-stage.online // Elementor : Elementor Ltd. // Submitted by Anton Barkan elementor.cloud elementor.cool // En root‽ : https://en-root.org // Submitted by Emmanuel Raviart en-root.fr // Enalean SAS: https://www.enalean.com // Submitted by Thomas Cottier mytuleap.com tuleap-partners.com // ECG Robotics, Inc: https://ecgrobotics.org // Submitted by onred.one staging.onred.one // EU.org https://eu.org/ // Submitted by Pierre Beyssac eu.org al.eu.org asso.eu.org at.eu.org au.eu.org be.eu.org bg.eu.org ca.eu.org cd.eu.org ch.eu.org cn.eu.org cy.eu.org cz.eu.org de.eu.org dk.eu.org edu.eu.org ee.eu.org es.eu.org fi.eu.org fr.eu.org gr.eu.org hr.eu.org hu.eu.org ie.eu.org il.eu.org in.eu.org int.eu.org is.eu.org it.eu.org jp.eu.org kr.eu.org lt.eu.org lu.eu.org lv.eu.org mc.eu.org me.eu.org mk.eu.org mt.eu.org my.eu.org net.eu.org ng.eu.org nl.eu.org no.eu.org nz.eu.org paris.eu.org pl.eu.org pt.eu.org q-a.eu.org ro.eu.org ru.eu.org se.eu.org si.eu.org sk.eu.org tr.eu.org uk.eu.org us.eu.org // Eurobyte : https://eurobyte.ru // Submitted by Evgeniy Subbotin eurodir.ru // Evennode : http://www.evennode.com/ // Submitted by Michal Kralik eu-1.evennode.com eu-2.evennode.com eu-3.evennode.com eu-4.evennode.com us-1.evennode.com us-2.evennode.com us-3.evennode.com us-4.evennode.com // eDirect Corp. : https://hosting.url.com.tw/ // Submitted by C.S. chang twmail.cc twmail.net twmail.org mymailer.com.tw url.tw // Fabrica Technologies, Inc. : https://www.fabrica.dev/ // Submitted by Eric Jiang onfabrica.com // Facebook, Inc. // Submitted by Peter Ruibal apps.fbsbx.com // FAITID : https://faitid.org/ // Submitted by Maxim Alzoba // https://www.flexireg.net/stat_info ru.net adygeya.ru bashkiria.ru bir.ru cbg.ru com.ru dagestan.ru grozny.ru kalmykia.ru kustanai.ru marine.ru mordovia.ru msk.ru mytis.ru nalchik.ru nov.ru pyatigorsk.ru spb.ru vladikavkaz.ru vladimir.ru abkhazia.su adygeya.su aktyubinsk.su arkhangelsk.su armenia.su ashgabad.su azerbaijan.su balashov.su bashkiria.su bryansk.su bukhara.su chimkent.su dagestan.su east-kazakhstan.su exnet.su georgia.su grozny.su ivanovo.su jambyl.su kalmykia.su kaluga.su karacol.su karaganda.su karelia.su khakassia.su krasnodar.su kurgan.su kustanai.su lenug.su mangyshlak.su mordovia.su msk.su murmansk.su nalchik.su navoi.su north-kazakhstan.su nov.su obninsk.su penza.su pokrovsk.su sochi.su spb.su tashkent.su termez.su togliatti.su troitsk.su tselinograd.su tula.su tuva.su vladikavkaz.su vladimir.su vologda.su // Fancy Bits, LLC : http://getchannels.com // Submitted by Aman Gupta channelsdvr.net u.channelsdvr.net // Fastly Inc. : http://www.fastly.com/ // Submitted by Fastly Security edgecompute.app fastly-terrarium.com fastlylb.net map.fastlylb.net freetls.fastly.net map.fastly.net a.prod.fastly.net global.prod.fastly.net a.ssl.fastly.net b.ssl.fastly.net global.ssl.fastly.net // FASTVPS EESTI OU : https://fastvps.ru/ // Submitted by Likhachev Vasiliy fastvps-server.com fastvps.host myfast.host fastvps.site myfast.space // Fedora : https://fedoraproject.org/ // submitted by Patrick Uiterwijk fedorainfracloud.org fedorapeople.org cloud.fedoraproject.org app.os.fedoraproject.org app.os.stg.fedoraproject.org // FearWorks Media Ltd. : https://fearworksmedia.co.uk // submitted by Keith Fairley couk.me ukco.me conn.uk copro.uk hosp.uk // Fermax : https://fermax.com/ // submitted by Koen Van Isterdael mydobiss.com // FH Muenster : https://www.fh-muenster.de // Submitted by Robin Naundorf fh-muenster.io // Filegear Inc. : https://www.filegear.com // Submitted by Jason Zhu filegear.me filegear-au.me filegear-de.me filegear-gb.me filegear-ie.me filegear-jp.me filegear-sg.me // Firebase, Inc. // Submitted by Chris Raynor firebaseapp.com // Firewebkit : https://www.firewebkit.com // Submitted by Majid Qureshi fireweb.app // FLAP : https://www.flap.cloud // Submitted by Louis Chemineau flap.id // fly.io: https://fly.io // Submitted by Kurt Mackey fly.dev edgeapp.net shw.io // Flynn : https://flynn.io // Submitted by Jonathan Rudenberg flynnhosting.net // Forgerock : https://www.forgerock.com // Submitted by Roderick Parr forgeblocks.com id.forgerock.io // Framer : https://www.framer.com // Submitted by Koen Rouwhorst framer.app framercanvas.com // Frusky MEDIA&PR : https://www.frusky.de // Submitted by Victor Pupynin *.frusky.de // RavPage : https://www.ravpage.co.il // Submitted by Roni Horowitz ravpage.co.il // Frederik Braun https://frederik-braun.com // Submitted by Frederik Braun 0e.vc // Freebox : http://www.freebox.fr // Submitted by Romain Fliedel freebox-os.com freeboxos.com fbx-os.fr fbxos.fr freebox-os.fr freeboxos.fr // freedesktop.org : https://www.freedesktop.org // Submitted by Daniel Stone freedesktop.org // freemyip.com : https://freemyip.com // Submitted by Cadence freemyip.com // FunkFeuer - Verein zur Förderung freier Netze : https://www.funkfeuer.at // Submitted by Daniel A. Maierhofer wien.funkfeuer.at // Futureweb OG : http://www.futureweb.at // Submitted by Andreas Schnederle-Wagner *.futurecms.at *.ex.futurecms.at *.in.futurecms.at futurehosting.at futuremailing.at *.ex.ortsinfo.at *.kunden.ortsinfo.at *.statics.cloud // GDS : https://www.gov.uk/service-manual/operations/operating-servicegovuk-subdomains // Submitted by David Illsley service.gov.uk // Gehirn Inc. : https://www.gehirn.co.jp/ // Submitted by Kohei YOSHIDA gehirn.ne.jp usercontent.jp // Gentlent, Inc. : https://www.gentlent.com // Submitted by Tom Klein gentapps.com gentlentapis.com lab.ms cdn-edges.net // Ghost Foundation : https://ghost.org // Submitted by Matt Hanley ghost.io // GignoSystemJapan: http://gsj.bz // Submitted by GignoSystemJapan gsj.bz // GitHub, Inc. // Submitted by Patrick Toomey githubusercontent.com githubpreview.dev github.io // GitLab, Inc. // Submitted by Alex Hanselka gitlab.io // Gitplac.si - https://gitplac.si // Submitted by Aljaž Starc gitapp.si gitpage.si // Glitch, Inc : https://glitch.com // Submitted by Mads Hartmann glitch.me // Global NOG Alliance : https://nogalliance.org/ // Submitted by Sander Steffann nog.community // Globe Hosting SRL : https://www.globehosting.com/ // Submitted by Gavin Brown co.ro shop.ro // GMO Pepabo, Inc. : https://pepabo.com/ // Submitted by dojineko lolipop.io // GOV.UK Platform as a Service : https://www.cloud.service.gov.uk/ // Submitted by Tom Whitwell cloudapps.digital london.cloudapps.digital // GOV.UK Pay : https://www.payments.service.gov.uk/ // Submitted by Richard Baker pymnt.uk // UKHomeOffice : https://www.gov.uk/government/organisations/home-office // Submitted by Jon Shanks homeoffice.gov.uk // GlobeHosting, Inc. // Submitted by Zoltan Egresi ro.im // GoIP DNS Services : http://www.goip.de // Submitted by Christian Poulter goip.de // Google, Inc. // Submitted by Eduardo Vela run.app a.run.app web.app *.0emm.com appspot.com *.r.appspot.com codespot.com googleapis.com googlecode.com pagespeedmobilizer.com publishproxy.com withgoogle.com withyoutube.com *.gateway.dev cloud.goog translate.goog *.usercontent.goog cloudfunctions.net blogspot.ae blogspot.al blogspot.am blogspot.ba blogspot.be blogspot.bg blogspot.bj blogspot.ca blogspot.cf blogspot.ch blogspot.cl blogspot.co.at blogspot.co.id blogspot.co.il blogspot.co.ke blogspot.co.nz blogspot.co.uk blogspot.co.za blogspot.com blogspot.com.ar blogspot.com.au blogspot.com.br blogspot.com.by blogspot.com.co blogspot.com.cy blogspot.com.ee blogspot.com.eg blogspot.com.es blogspot.com.mt blogspot.com.ng blogspot.com.tr blogspot.com.uy blogspot.cv blogspot.cz blogspot.de blogspot.dk blogspot.fi blogspot.fr blogspot.gr blogspot.hk blogspot.hr blogspot.hu blogspot.ie blogspot.in blogspot.is blogspot.it blogspot.jp blogspot.kr blogspot.li blogspot.lt blogspot.lu blogspot.md blogspot.mk blogspot.mr blogspot.mx blogspot.my blogspot.nl blogspot.no blogspot.pe blogspot.pt blogspot.qa blogspot.re blogspot.ro blogspot.rs blogspot.ru blogspot.se blogspot.sg blogspot.si blogspot.sk blogspot.sn blogspot.td blogspot.tw blogspot.ug blogspot.vn // Goupile : https://goupile.fr // Submitted by Niels Martignene goupile.fr // Group 53, LLC : https://www.group53.com // Submitted by Tyler Todd awsmppl.com // GünstigBestellen : https://günstigbestellen.de // Submitted by Furkan Akkoc günstigbestellen.de günstigliefern.de // Hakaran group: http://hakaran.cz // Submited by Arseniy Sokolov fin.ci free.hr caa.li ua.rs conf.se // Handshake : https://handshake.org // Submitted by Mike Damm hs.zone hs.run // Hashbang : https://hashbang.sh hashbang.sh // Hasura : https://hasura.io // Submitted by Shahidh K Muhammed hasura.app hasura-app.io // Heilbronn University of Applied Sciences - Faculty Informatics (GitLab Pages): https://www.hs-heilbronn.de // Submitted by Richard Zowalla pages.it.hs-heilbronn.de // Hepforge : https://www.hepforge.org // Submitted by David Grellscheid hepforge.org // Heroku : https://www.heroku.com/ // Submitted by Tom Maher herokuapp.com herokussl.com // Hibernating Rhinos // Submitted by Oren Eini myravendb.com ravendb.community ravendb.me development.run ravendb.run // home.pl S.A.: https://home.pl // Submited by Krzysztof Wolski homesklep.pl // Hong Kong Productivity Council: https://www.hkpc.org/ // Submitted by SECaaS Team secaas.hk // HOSTBIP REGISTRY : https://www.hostbip.com/ // Submitted by Atanunu Igbunuroghene orx.biz biz.gl col.ng firm.ng gen.ng ltd.ng ngo.ng edu.scot sch.so org.yt // HostyHosting (hostyhosting.com) hostyhosting.io // Häkkinen.fi // Submitted by Eero Häkkinen häkkinen.fi // Ici la Lune : http://www.icilalune.com/ // Submitted by Simon Morvan *.moonscale.io moonscale.net // iki.fi // Submitted by Hannu Aronsson iki.fi // Impertrix Solutions : // Submitted by Zhixiang Zhao impertrixcdn.com impertrix.com // Incsub, LLC: https://incsub.com/ // Submitted by Aaron Edwards smushcdn.com wphostedmail.com wpmucdn.com tempurl.host wpmudev.host // Individual Network Berlin e.V. : https://www.in-berlin.de/ // Submitted by Christian Seitz dyn-berlin.de in-berlin.de in-brb.de in-butter.de in-dsl.de in-dsl.net in-dsl.org in-vpn.de in-vpn.net in-vpn.org // info.at : http://www.info.at/ biz.at info.at // info.cx : http://info.cx // Submitted by Jacob Slater info.cx // Interlegis : http://www.interlegis.leg.br // Submitted by Gabriel Ferreira ac.leg.br al.leg.br am.leg.br ap.leg.br ba.leg.br ce.leg.br df.leg.br es.leg.br go.leg.br ma.leg.br mg.leg.br ms.leg.br mt.leg.br pa.leg.br pb.leg.br pe.leg.br pi.leg.br pr.leg.br rj.leg.br rn.leg.br ro.leg.br rr.leg.br rs.leg.br sc.leg.br se.leg.br sp.leg.br to.leg.br // intermetrics GmbH : https://pixolino.com/ // Submitted by Wolfgang Schwarz pixolino.com // Internet-Pro, LLP: https://netangels.ru/ // Submited by Vasiliy Sheredeko na4u.ru // iopsys software solutions AB : https://iopsys.eu/ // Submitted by Roman Azarenko iopsys.se // IPiFony Systems, Inc. : https://www.ipifony.com/ // Submitted by Matthew Hardeman ipifony.net // IServ GmbH : https://iserv.eu // Submitted by Kim-Alexander Brodowski mein-iserv.de schulserver.de test-iserv.de iserv.dev // I-O DATA DEVICE, INC. : http://www.iodata.com/ // Submitted by Yuji Minagawa iobb.net // Jelastic, Inc. : https://jelastic.com/ // Submited by Ihor Kolodyuk mel.cloudlets.com.au cloud.interhostsolutions.be users.scale.virtualcloud.com.br mycloud.by alp1.ae.flow.ch appengine.flow.ch es-1.axarnet.cloud diadem.cloud vip.jelastic.cloud jele.cloud it1.eur.aruba.jenv-aruba.cloud it1.jenv-aruba.cloud keliweb.cloud cs.keliweb.cloud oxa.cloud tn.oxa.cloud uk.oxa.cloud primetel.cloud uk.primetel.cloud ca.reclaim.cloud uk.reclaim.cloud us.reclaim.cloud ch.trendhosting.cloud de.trendhosting.cloud jele.club amscompute.com clicketcloud.com dopaas.com hidora.com paas.hosted-by-previder.com rag-cloud.hosteur.com rag-cloud-ch.hosteur.com jcloud.ik-server.com jcloud-ver-jpc.ik-server.com demo.jelastic.com kilatiron.com paas.massivegrid.com jed.wafaicloud.com lon.wafaicloud.com ryd.wafaicloud.com j.scaleforce.com.cy jelastic.dogado.eu fi.cloudplatform.fi demo.datacenter.fi paas.datacenter.fi jele.host mircloud.host paas.beebyte.io sekd1.beebyteapp.io jele.io cloud-fr1.unispace.io jc.neen.it cloud.jelastic.open.tim.it jcloud.kz upaas.kazteleport.kz cloudjiffy.net fra1-de.cloudjiffy.net west1-us.cloudjiffy.net jls-sto1.elastx.net jls-sto2.elastx.net jls-sto3.elastx.net faststacks.net fr-1.paas.massivegrid.net lon-1.paas.massivegrid.net lon-2.paas.massivegrid.net ny-1.paas.massivegrid.net ny-2.paas.massivegrid.net sg-1.paas.massivegrid.net jelastic.saveincloud.net nordeste-idc.saveincloud.net j.scaleforce.net jelastic.tsukaeru.net sdscloud.pl unicloud.pl mircloud.ru jelastic.regruhosting.ru enscaled.sg jele.site jelastic.team orangecloud.tn j.layershift.co.uk phx.enscaled.us mircloud.us // Jino : https://www.jino.ru // Submitted by Sergey Ulyashin myjino.ru *.hosting.myjino.ru *.landing.myjino.ru *.spectrum.myjino.ru *.vps.myjino.ru // Jotelulu S.L. : https://jotelulu.com // Submitted by Daniel Fariña jotelulu.cloud // Joyent : https://www.joyent.com/ // Submitted by Brian Bennett *.triton.zone *.cns.joyent.com // JS.ORG : http://dns.js.org // Submitted by Stefan Keim js.org // KaasHosting : http://www.kaashosting.nl/ // Submitted by Wouter Bakker kaas.gg khplay.nl // Keyweb AG : https://www.keyweb.de // Submitted by Martin Dannehl keymachine.de // KingHost : https://king.host // Submitted by Felipe Keller Braz kinghost.net uni5.net // KnightPoint Systems, LLC : http://www.knightpoint.com/ // Submitted by Roy Keene knightpoint.systems // KUROKU LTD : https://kuroku.ltd/ // Submitted by DisposaBoy oya.to // Katholieke Universiteit Leuven: https://www.kuleuven.be // Submitted by Abuse KU Leuven kuleuven.cloud ezproxy.kuleuven.be // .KRD : http://nic.krd/data/krd/Registration%20Policy.pdf co.krd edu.krd // Krellian Ltd. : https://krellian.com // Submitted by Ben Francis krellian.net webthings.io // LCube - Professional hosting e.K. : https://www.lcube-webhosting.de // Submitted by Lars Laehn git-repos.de lcube-server.de svn-repos.de // Leadpages : https://www.leadpages.net // Submitted by Greg Dallavalle leadpages.co lpages.co lpusercontent.com // Lelux.fi : https://lelux.fi/ // Submitted by Lelux Admin lelux.site // Lifetime Hosting : https://Lifetime.Hosting/ // Submitted by Mike Fillator co.business co.education co.events co.financial co.network co.place co.technology // Lightmaker Property Manager, Inc. : https://app.lmpm.com/ // Submitted by Greg Holland app.lmpm.com // linkyard ldt: https://www.linkyard.ch/ // Submitted by Mario Siegenthaler linkyard.cloud linkyard-cloud.ch // Linode : https://linode.com // Submitted by members.linode.com *.nodebalancer.linode.com *.linodeobjects.com ip.linodeusercontent.com // LiquidNet Ltd : http://www.liquidnetlimited.com/ // Submitted by Victor Velchev we.bs // localzone.xyz // Submitted by Kenny Niehage localzone.xyz // Log'in Line : https://www.loginline.com/ // Submitted by Rémi Mach loginline.app loginline.dev loginline.io loginline.services loginline.site // Lokalized : https://lokalized.nl // Submitted by Noah Taheij servers.run // Lõhmus Family, The // Submitted by Heiki Lõhmus lohmus.me // LubMAN UMCS Sp. z o.o : https://lubman.pl/ // Submitted by Ireneusz Maliszewski krasnik.pl leczna.pl lubartow.pl lublin.pl poniatowa.pl swidnik.pl // Lug.org.uk : https://lug.org.uk // Submitted by Jon Spriggs glug.org.uk lug.org.uk lugs.org.uk // Lukanet Ltd : https://lukanet.com // Submitted by Anton Avramov barsy.bg barsy.co.uk barsyonline.co.uk barsycenter.com barsyonline.com barsy.club barsy.de barsy.eu barsy.in barsy.info barsy.io barsy.me barsy.menu barsy.mobi barsy.net barsy.online barsy.org barsy.pro barsy.pub barsy.ro barsy.shop barsy.site barsy.support barsy.uk // Magento Commerce // Submitted by Damien Tournoud *.magentosite.cloud // May First - People Link : https://mayfirst.org/ // Submitted by Jamie McClelland mayfirst.info mayfirst.org // Mail.Ru Group : https://hb.cldmail.ru // Submitted by Ilya Zaretskiy hb.cldmail.ru // Mail Transfer Platform : https://www.neupeer.com // Submitted by Li Hui cn.vu // Maze Play: https://www.mazeplay.com // Submitted by Adam Humpherys mazeplay.com // mcpe.me : https://mcpe.me // Submitted by Noa Heyl mcpe.me // McHost : https://mchost.ru // Submitted by Evgeniy Subbotin mcdir.me mcdir.ru mcpre.ru vps.mcdir.ru // Mediatech : https://mediatech.by // Submitted by Evgeniy Kozhuhovskiy mediatech.by mediatech.dev // Medicom Health : https://medicomhealth.com // Submitted by Michael Olson hra.health // Memset hosting : https://www.memset.com // Submitted by Tom Whitwell miniserver.com memset.net // MetaCentrum, CESNET z.s.p.o. : https://www.metacentrum.cz/en/ // Submitted by Zdeněk Šustr *.cloud.metacentrum.cz custom.metacentrum.cz // MetaCentrum, CESNET z.s.p.o. : https://www.metacentrum.cz/en/ // Submitted by Radim Janča flt.cloud.muni.cz usr.cloud.muni.cz // Meteor Development Group : https://www.meteor.com/hosting // Submitted by Pierre Carrier meteorapp.com eu.meteorapp.com // Michau Enterprises Limited : http://www.co.pl/ co.pl // Microsoft Corporation : http://microsoft.com // Submitted by Mitch Webster *.azurecontainer.io azurewebsites.net azure-mobile.net cloudapp.net azurestaticapps.net centralus.azurestaticapps.net eastasia.azurestaticapps.net eastus2.azurestaticapps.net westeurope.azurestaticapps.net westus2.azurestaticapps.net // minion.systems : http://minion.systems // Submitted by Robert Böttinger csx.cc // Mintere : https://mintere.com/ // Submitted by Ben Aubin mintere.site // MobileEducation, LLC : https://joinforte.com // Submitted by Grayson Martin forte.id // Mozilla Corporation : https://mozilla.com // Submitted by Ben Francis mozilla-iot.org // Mozilla Foundation : https://mozilla.org/ // Submitted by glob bmoattachments.org // MSK-IX : https://www.msk-ix.ru/ // Submitted by Khannanov Roman net.ru org.ru pp.ru // Mythic Beasts : https://www.mythic-beasts.com // Submitted by Paul Cammish hostedpi.com customer.mythic-beasts.com caracal.mythic-beasts.com fentiger.mythic-beasts.com lynx.mythic-beasts.com ocelot.mythic-beasts.com oncilla.mythic-beasts.com onza.mythic-beasts.com sphinx.mythic-beasts.com vs.mythic-beasts.com x.mythic-beasts.com yali.mythic-beasts.com cust.retrosnub.co.uk // Nabu Casa : https://www.nabucasa.com // Submitted by Paulus Schoutsen ui.nabu.casa // Names.of.London : https://names.of.london/ // Submitted by James Stevens or pony.club of.fashion in.london of.london from.marketing with.marketing for.men repair.men and.mom for.mom for.one under.one for.sale that.win from.work to.work // Netlify : https://www.netlify.com // Submitted by Jessica Parsons netlify.app // Neustar Inc. // Submitted by Trung Tran 4u.com // ngrok : https://ngrok.com/ // Submitted by Alan Shreve ngrok.io // Nimbus Hosting Ltd. : https://www.nimbushosting.co.uk/ // Submitted by Nicholas Ford nh-serv.co.uk // NFSN, Inc. : https://www.NearlyFreeSpeech.NET/ // Submitted by Jeff Wheelhouse nfshost.com // Noop : https://noop.app // Submitted by Nathaniel Schweinberg *.developer.app noop.app // Northflank Ltd. : https://northflank.com/ // Submitted by Marco Suter *.northflank.app *.code.run // Noticeable : https://noticeable.io // Submitted by Laurent Pellegrino noticeable.news // Now-DNS : https://now-dns.com // Submitted by Steve Russell dnsking.ch mypi.co n4t.co 001www.com ddnslive.com myiphost.com forumz.info 16-b.it 32-b.it 64-b.it soundcast.me tcp4.me dnsup.net hicam.net now-dns.net ownip.net vpndns.net dynserv.org now-dns.org x443.pw now-dns.top ntdll.top freeddns.us crafting.xyz zapto.xyz // nsupdate.info : https://www.nsupdate.info/ // Submitted by Thomas Waldmann nsupdate.info nerdpol.ovh // No-IP.com : https://noip.com/ // Submitted by Deven Reza blogsyte.com brasilia.me cable-modem.org ciscofreak.com collegefan.org couchpotatofries.org damnserver.com ddns.me ditchyourip.com dnsfor.me dnsiskinky.com dvrcam.info dynns.com eating-organic.net fantasyleague.cc geekgalaxy.com golffan.us health-carereform.com homesecuritymac.com homesecuritypc.com hopto.me ilovecollege.info loginto.me mlbfan.org mmafan.biz myactivedirectory.com mydissent.net myeffect.net mymediapc.net mypsx.net mysecuritycamera.com mysecuritycamera.net mysecuritycamera.org net-freaks.com nflfan.org nhlfan.net no-ip.ca no-ip.co.uk no-ip.net noip.us onthewifi.com pgafan.net point2this.com pointto.us privatizehealthinsurance.net quicksytes.com read-books.org securitytactics.com serveexchange.com servehumour.com servep2p.com servesarcasm.com stufftoread.com ufcfan.org unusualperson.com workisboring.com 3utilities.com bounceme.net ddns.net ddnsking.com gotdns.ch hopto.org myftp.biz myftp.org myvnc.com no-ip.biz no-ip.info no-ip.org noip.me redirectme.net servebeer.com serveblog.net servecounterstrike.com serveftp.com servegame.com servehalflife.com servehttp.com serveirc.com serveminecraft.net servemp3.com servepics.com servequake.com sytes.net webhop.me zapto.org // NodeArt : https://nodeart.io // Submitted by Konstantin Nosov stage.nodeart.io // Nodum B.V. : https://nodum.io/ // Submitted by Wietse Wind nodum.co nodum.io // Nucleos Inc. : https://nucleos.com // Submitted by Piotr Zduniak pcloud.host // NYC.mn : http://www.information.nyc.mn // Submitted by Matthew Brown nyc.mn // Observable, Inc. : https://observablehq.com // Submitted by Mike Bostock static.observableusercontent.com // Octopodal Solutions, LLC. : https://ulterius.io/ // Submitted by Andrew Sampson cya.gg // OMG.LOL : // Submitted by Adam Newbold omg.lol // Omnibond Systems, LLC. : https://www.omnibond.com // Submitted by Cole Estep cloudycluster.net // OmniWe Limited: https://omniwe.com // Submitted by Vicary Archangel omniwe.site // One.com: https://www.one.com/ // Submitted by Jacob Bunk Nielsen service.one // One Fold Media : http://www.onefoldmedia.com/ // Submitted by Eddie Jones nid.io // Open Social : https://www.getopensocial.com/ // Submitted by Alexander Varwijk opensocial.site // OpenCraft GmbH : http://opencraft.com/ // Submitted by Sven Marnach opencraft.hosting // OpenResearch GmbH: https://openresearch.com/ // Submitted by Philipp Schmid orsites.com // Opera Software, A.S.A. // Submitted by Yngve Pettersen operaunite.com // Oursky Limited : https://authgear.com/, https://skygear.io/ // Submited by Authgear Team , Skygear Developer authgear-staging.com authgearapps.com skygearapp.com // OutSystems // Submitted by Duarte Santos outsystemscloud.com // OVHcloud: https://ovhcloud.com // Submitted by Vincent Cassé *.webpaas.ovh.net *.hosting.ovh.net // OwnProvider GmbH: http://www.ownprovider.com // Submitted by Jan Moennich ownprovider.com own.pm // OwO : https://whats-th.is/ // Submitted by Dean Sheather *.owo.codes // OX : http://www.ox.rs // Submitted by Adam Grand ox.rs // oy.lc // Submitted by Charly Coste oy.lc // Pagefog : https://pagefog.com/ // Submitted by Derek Myers pgfog.com // Pagefront : https://www.pagefronthq.com/ // Submitted by Jason Kriss pagefrontapp.com // PageXL : https://pagexl.com // Submitted by Yann Guichard pagexl.com // Paywhirl, Inc : https://paywhirl.com/ // Submitted by Daniel Netzer *.paywhirl.com // pcarrier.ca Software Inc: https://pcarrier.ca/ // Submitted by Pierre Carrier bar0.net bar1.net bar2.net rdv.to // .pl domains (grandfathered) art.pl gliwice.pl krakow.pl poznan.pl wroc.pl zakopane.pl // Pantheon Systems, Inc. : https://pantheon.io/ // Submitted by Gary Dylina pantheonsite.io gotpantheon.com // Peplink | Pepwave : http://peplink.com/ // Submitted by Steve Leung mypep.link // Perspecta : https://perspecta.com/ // Submitted by Kenneth Van Alstyne perspecta.cloud // PE Ulyanov Kirill Sergeevich : https://airy.host // Submitted by Kirill Ulyanov lk3.ru // Planet-Work : https://www.planet-work.com/ // Submitted by Frédéric VANNIÈRE on-web.fr // Platform.sh : https://platform.sh // Submitted by Nikola Kotur bc.platform.sh ent.platform.sh eu.platform.sh us.platform.sh *.platformsh.site *.tst.site // Platter: https://platter.dev // Submitted by Patrick Flor platter-app.com platter-app.dev platterp.us // Plesk : https://www.plesk.com/ // Submitted by Anton Akhtyamov pdns.page plesk.page pleskns.com // Port53 : https://port53.io/ // Submitted by Maximilian Schieder dyn53.io // Positive Codes Technology Company : http://co.bn/faq.html // Submitted by Zulfais co.bn // Postman, Inc : https://postman.com // Submitted by Rahul Dhawan postman-echo.com pstmn.io mock.pstmn.io httpbin.org //prequalifyme.today : https://prequalifyme.today //Submitted by DeepakTiwari deepak@ivylead.io prequalifyme.today // prgmr.com : https://prgmr.com/ // Submitted by Sarah Newman xen.prgmr.com // priv.at : http://www.nic.priv.at/ // Submitted by registry priv.at // privacytools.io : https://www.privacytools.io/ // Submitted by Jonah Aragon prvcy.page // Protocol Labs : https://protocol.ai/ // Submitted by Michael Burns *.dweb.link // Protonet GmbH : http://protonet.io // Submitted by Martin Meier protonet.io // Publication Presse Communication SARL : https://ppcom.fr // Submitted by Yaacov Akiba Slama chirurgiens-dentistes-en-france.fr byen.site // pubtls.org: https://www.pubtls.org // Submitted by Kor Nielsen pubtls.org // PythonAnywhere LLP: https://www.pythonanywhere.com // Submitted by Giles Thomas pythonanywhere.com eu.pythonanywhere.com // QOTO, Org. // Submitted by Jeffrey Phillips Freeman qoto.io // Qualifio : https://qualifio.com/ // Submitted by Xavier De Cock qualifioapp.com // QuickBackend: https://www.quickbackend.com // Submitted by Dani Biro qbuser.com // Rad Web Hosting: https://radwebhosting.com // Submitted by Scott Claeys cloudsite.builders // Redgate Software: https://red-gate.com // Submitted by Andrew Farries instances.spawn.cc // Redstar Consultants : https://www.redstarconsultants.com/ // Submitted by Jons Slemmer instantcloud.cn // Russian Academy of Sciences // Submitted by Tech Support ras.ru // QA2 // Submitted by Daniel Dent (https://www.danieldent.com/) qa2.com // QCX // Submitted by Cassandra Beelen qcx.io *.sys.qcx.io // QNAP System Inc : https://www.qnap.com // Submitted by Nick Chang dev-myqnapcloud.com alpha-myqnapcloud.com myqnapcloud.com // Quip : https://quip.com // Submitted by Patrick Linehan *.quipelements.com // Qutheory LLC : http://qutheory.io // Submitted by Jonas Schwartz vapor.cloud vaporcloud.io // Rackmaze LLC : https://www.rackmaze.com // Submitted by Kirill Pertsev rackmaze.com rackmaze.net // Rakuten Games, Inc : https://dev.viberplay.io // Submitted by Joshua Zhang g.vbrplsbx.io // Rancher Labs, Inc : https://rancher.com // Submitted by Vincent Fiduccia *.on-k3s.io *.on-rancher.cloud *.on-rio.io // Read The Docs, Inc : https://www.readthedocs.org // Submitted by David Fischer readthedocs.io // Red Hat, Inc. OpenShift : https://openshift.redhat.com/ // Submitted by Tim Kramer rhcloud.com // Render : https://render.com // Submitted by Anurag Goel app.render.com onrender.com // Repl.it : https://repl.it // Submitted by Mason Clayton repl.co id.repl.co repl.run // Resin.io : https://resin.io // Submitted by Tim Perry resindevice.io devices.resinstaging.io // RethinkDB : https://www.rethinkdb.com/ // Submitted by Chris Kastorff hzc.io // Revitalised Limited : http://www.revitalised.co.uk // Submitted by Jack Price wellbeingzone.eu wellbeingzone.co.uk // Rico Developments Limited : https://adimo.co // Submitted by Colin Brown adimo.co.uk // Riseup Networks : https://riseup.net // Submitted by Micah Anderson itcouldbewor.se // Rochester Institute of Technology : http://www.rit.edu/ // Submitted by Jennifer Herting git-pages.rit.edu // Rusnames Limited: http://rusnames.ru/ // Submitted by Sergey Zotov биз.рус ком.рус крым.рус мир.рус мск.рус орг.рус самара.рус сочи.рус спб.рус я.рус // Sandstorm Development Group, Inc. : https://sandcats.io/ // Submitted by Asheesh Laroia sandcats.io // SBE network solutions GmbH : https://www.sbe.de/ // Submitted by Norman Meilick logoip.de logoip.com // schokokeks.org GbR : https://schokokeks.org/ // Submitted by Hanno Böck schokokeks.net // Scottish Government: https://www.gov.scot // Submitted by Martin Ellis gov.scot service.gov.scot // Scry Security : http://www.scrysec.com // Submitted by Shante Adam scrysec.com // Securepoint GmbH : https://www.securepoint.de // Submitted by Erik Anders firewall-gateway.com firewall-gateway.de my-gateway.de my-router.de spdns.de spdns.eu firewall-gateway.net my-firewall.org myfirewall.org spdns.org // Seidat : https://www.seidat.com // Submitted by Artem Kondratev seidat.net // Sellfy : https://sellfy.com // Submitted by Yuriy Romadin sellfy.store // Senseering GmbH : https://www.senseering.de // Submitted by Felix Mönckemeyer senseering.net // Sendmsg: https://www.sendmsg.co.il // Submitted by Assaf Stern minisite.ms // Service Magnet : https://myservicemagnet.com // Submitted by Dave Sanders magnet.page // Service Online LLC : http://drs.ua/ // Submitted by Serhii Bulakh biz.ua co.ua pp.ua // Shift Crypto AG : https://shiftcrypto.ch // Submitted by alex shiftcrypto.dev shiftcrypto.io // ShiftEdit : https://shiftedit.net/ // Submitted by Adam Jimenez shiftedit.io // Shopblocks : http://www.shopblocks.com/ // Submitted by Alex Bowers myshopblocks.com // Shopify : https://www.shopify.com // Submitted by Alex Richter myshopify.com // Shopit : https://www.shopitcommerce.com/ // Submitted by Craig McMahon shopitsite.com // shopware AG : https://shopware.com // Submitted by Jens Küper shopware.store // Siemens Mobility GmbH // Submitted by Oliver Graebner mo-siemens.io // SinaAppEngine : http://sae.sina.com.cn/ // Submitted by SinaAppEngine 1kapp.com appchizi.com applinzi.com sinaapp.com vipsinaapp.com // Siteleaf : https://www.siteleaf.com/ // Submitted by Skylar Challand siteleaf.net // Skyhat : http://www.skyhat.io // Submitted by Shante Adam bounty-full.com alpha.bounty-full.com beta.bounty-full.com // Small Technology Foundation : https://small-tech.org // Submitted by Aral Balkan small-web.org // Smoove.io : https://www.smoove.io/ // Submitted by Dan Kozak vp4.me // Snowplow Analytics : https://snowplowanalytics.com/ // Submitted by Ian Streeter try-snowplow.com // SourceHut : https://sourcehut.org // Submitted by Drew DeVault srht.site // Stackhero : https://www.stackhero.io // Submitted by Adrien Gillon stackhero-network.com // Staclar : https://staclar.com // Submitted by Matthias Merkel novecore.site // staticland : https://static.land // Submitted by Seth Vincent static.land dev.static.land sites.static.land // Storebase : https://www.storebase.io // Submitted by Tony Schirmer storebase.store // Strategic System Consulting (eApps Hosting): https://www.eapps.com/ // Submitted by Alex Oancea vps-host.net atl.jelastic.vps-host.net njs.jelastic.vps-host.net ric.jelastic.vps-host.net // Sony Interactive Entertainment LLC : https://sie.com/ // Submitted by David Coles playstation-cloud.com // SourceLair PC : https://www.sourcelair.com // Submitted by Antonis Kalipetis apps.lair.io *.stolos.io // SpaceKit : https://www.spacekit.io/ // Submitted by Reza Akhavan spacekit.io // SpeedPartner GmbH: https://www.speedpartner.de/ // Submitted by Stefan Neufeind customer.speedpartner.de // Spreadshop (sprd.net AG) : https://www.spreadshop.com/ // Submitted by Martin Breest myspreadshop.at myspreadshop.com.au myspreadshop.be myspreadshop.ca myspreadshop.ch myspreadshop.com myspreadshop.de myspreadshop.dk myspreadshop.es myspreadshop.fi myspreadshop.fr myspreadshop.ie myspreadshop.it myspreadshop.net myspreadshop.nl myspreadshop.no myspreadshop.pl myspreadshop.se myspreadshop.co.uk // Standard Library : https://stdlib.com // Submitted by Jacob Lee api.stdlib.com // Storj Labs Inc. : https://storj.io/ // Submitted by Philip Hutchins storj.farm // Studenten Net Twente : http://www.snt.utwente.nl/ // Submitted by Silke Hofstra utwente.io // Student-Run Computing Facility : https://www.srcf.net/ // Submitted by Edwin Balani soc.srcf.net user.srcf.net // Sub 6 Limited: http://www.sub6.com // Submitted by Dan Miller temp-dns.com // Supabase : https://supabase.io // Submitted by Inian Parameshwaran supabase.co supabase.in supabase.net su.paba.se // Symfony, SAS : https://symfony.com/ // Submitted by Fabien Potencier *.s5y.io *.sensiosite.cloud // Syncloud : https://syncloud.org // Submitted by Boris Rybalkin syncloud.it // Synology, Inc. : https://www.synology.com/ // Submitted by Rony Weng diskstation.me dscloud.biz dscloud.me dscloud.mobi dsmynas.com dsmynas.net dsmynas.org familyds.com familyds.net familyds.org i234.me myds.me synology.me vpnplus.to direct.quickconnect.to // Tabit Technologies Ltd. : https://tabit.cloud/ // Submitted by Oren Agiv tabitorder.co.il // TAIFUN Software AG : http://taifun-software.de // Submitted by Bjoern Henke taifun-dns.de // Tailscale Inc. : https://www.tailscale.com // Submitted by David Anderson beta.tailscale.net ts.net // TASK geographical domains (www.task.gda.pl/uslugi/dns) gda.pl gdansk.pl gdynia.pl med.pl sopot.pl // Teckids e.V. : https://www.teckids.org // Submitted by Dominik George edugit.org // Telebit : https://telebit.cloud // Submitted by AJ ONeal telebit.app telebit.io *.telebit.xyz // The Gwiddle Foundation : https://gwiddlefoundation.org.uk // Submitted by Joshua Bayfield gwiddle.co.uk // Thingdust AG : https://thingdust.com/ // Submitted by Adrian Imboden *.firenet.ch *.svc.firenet.ch reservd.com thingdustdata.com cust.dev.thingdust.io cust.disrec.thingdust.io cust.prod.thingdust.io cust.testing.thingdust.io reservd.dev.thingdust.io reservd.disrec.thingdust.io reservd.testing.thingdust.io // ticket i/O GmbH : https://ticket.io // Submitted by Christian Franke tickets.io // Tlon.io : https://tlon.io // Submitted by Mark Staarink arvo.network azimuth.network tlon.network // Tor Project, Inc. : https://torproject.org // Submitted by Antoine Beaupré bloxcms.com townnews-staging.com // TradableBits: https://tradablebits.com // Submitted by Dmitry Khrisanov dmitry@tradablebits.com tbits.me // TrafficPlex GmbH : https://www.trafficplex.de/ // Submitted by Phillipp Röll 12hp.at 2ix.at 4lima.at lima-city.at 12hp.ch 2ix.ch 4lima.ch lima-city.ch trafficplex.cloud de.cool 12hp.de 2ix.de 4lima.de lima-city.de 1337.pictures clan.rip lima-city.rocks webspace.rocks lima.zone // TransIP : https://www.transip.nl // Submitted by Rory Breuk *.transurl.be *.transurl.eu *.transurl.nl // TuxFamily : http://tuxfamily.org // Submitted by TuxFamily administrators tuxfamily.org // TwoDNS : https://www.twodns.de/ // Submitted by TwoDNS-Support dd-dns.de diskstation.eu diskstation.org dray-dns.de draydns.de dyn-vpn.de dynvpn.de mein-vigor.de my-vigor.de my-wan.de syno-ds.de synology-diskstation.de synology-ds.de // Uberspace : https://uberspace.de // Submitted by Moritz Werner uber.space *.uberspace.de // UDR Limited : http://www.udr.hk.com // Submitted by registry hk.com hk.org ltd.hk inc.hk // United Gameserver GmbH : https://united-gameserver.de // Submitted by Stefan Schwarz virtualuser.de virtual-user.de // Upli : https://upli.io // Submitted by Lenny Bakkalian upli.io // urown.net : https://urown.net // Submitted by Hostmaster urown.cloud dnsupdate.info // .US // Submitted by Ed Moore lib.de.us // VeryPositive SIA : http://very.lv // Submitted by Danko Aleksejevs 2038.io // Vercel, Inc : https://vercel.com/ // Submitted by Connor Davis vercel.app vercel.dev now.sh // Viprinet Europe GmbH : http://www.viprinet.com // Submitted by Simon Kissel router.management // Virtual-Info : https://www.virtual-info.info/ // Submitted by Adnan RIHAN v-info.info // Voorloper.com: https://voorloper.com // Submitted by Nathan van Bakel voorloper.cloud // Voxel.sh DNS : https://voxel.sh/dns/ // Submitted by Mia Rehlinger neko.am nyaa.am be.ax cat.ax es.ax eu.ax gg.ax mc.ax us.ax xy.ax nl.ci xx.gl app.gp blog.gt de.gt to.gt be.gy cc.hn blog.kg io.kg jp.kg tv.kg uk.kg us.kg de.ls at.md de.md jp.md to.md indie.porn vxl.sh ch.tc me.tc we.tc nyan.to at.vg blog.vu dev.vu me.vu // V.UA Domain Administrator : https://domain.v.ua/ // Submitted by Serhii Rostilo v.ua // Waffle Computer Inc., Ltd. : https://docs.waffleinfo.com // Submitted by Masayuki Note wafflecell.com // WapBlog.ID : https://www.wapblog.id // Submitted by Fajar Sodik idnblogger.com indowapblog.com bloger.id wblog.id wbq.me fastblog.net // WebHare bv: https://www.webhare.com/ // Submitted by Arnold Hendriks *.webhare.dev // WebHotelier Technologies Ltd: https://www.webhotelier.net/ // Submitted by Apostolos Tsakpinis reserve-online.net reserve-online.com bookonline.app hotelwithflight.com // WeDeploy by Liferay, Inc. : https://www.wedeploy.com // Submitted by Henrique Vicente wedeploy.io wedeploy.me wedeploy.sh // Western Digital Technologies, Inc : https://www.wdc.com // Submitted by Jung Jin remotewd.com // WIARD Enterprises : https://wiardweb.com // Submitted by Kidd Hustle pages.wiardweb.com // Wikimedia Labs : https://wikitech.wikimedia.org // Submitted by Arturo Borrero Gonzalez wmflabs.org toolforge.org wmcloud.org // WISP : https://wisp.gg // Submitted by Stepan Fedotov panel.gg daemon.panel.gg // WoltLab GmbH : https://www.woltlab.com // Submitted by Tim Düsterhus woltlab-demo.com myforum.community community-pro.de diskussionsbereich.de community-pro.net meinforum.net // Woods Valldata : https://www.woodsvalldata.co.uk/ // Submitted by Chris Whittle affinitylottery.org.uk raffleentry.org.uk weeklylottery.org.uk // WP Engine : https://wpengine.com/ // Submitted by Michael Smith // Submitted by Brandon DuRette wpenginepowered.com js.wpenginepowered.com // Wix.com, Inc. : https://www.wix.com // Submitted by Shahar Talmi wixsite.com editorx.io // XenonCloud GbR: https://xenoncloud.net // Submitted by Julian Uphoff half.host // XnBay Technology : http://www.xnbay.com/ // Submitted by XnBay Developer xnbay.com u2.xnbay.com u2-local.xnbay.com // XS4ALL Internet bv : https://www.xs4all.nl/ // Submitted by Daniel Mostertman cistron.nl demon.nl xs4all.space // Yandex.Cloud LLC: https://cloud.yandex.com // Submitted by Alexander Lodin yandexcloud.net storage.yandexcloud.net website.yandexcloud.net // YesCourse Pty Ltd : https://yescourse.com // Submitted by Atul Bhouraskar official.academy // Yola : https://www.yola.com/ // Submitted by Stefano Rivera yolasite.com // Yombo : https://yombo.net // Submitted by Mitch Schwenk ybo.faith yombo.me homelink.one ybo.party ybo.review ybo.science ybo.trade // Yunohost : https://yunohost.org // Submitted by Valentin Grimaud ynh.fr nohost.me noho.st // ZaNiC : http://www.za.net/ // Submitted by registry za.net za.org // Zine EOOD : https://zine.bg/ // Submitted by Martin Angelov bss.design // Zitcom A/S : https://www.zitcom.dk // Submitted by Emil Stahl basicserver.io virtualserver.io enterprisecloud.nu // ===END PRIVATE DOMAINS==={ "symbol-whitelist": [ "null", "true", "false", "static", "self", "parent", "array", "string", "int", "float", "bool", "iterable", "callable", "void", "object", "Amp\\File\\Driver", "Amp\\File\\exists", "Amp\\File\\get", "Amp\\File\\isdir", "Amp\\File\\mkdir", "Amp\\File\\open", "Amp\\File\\put", "Amp\\File\\size" ], "php-core-extensions": [ "Core", "date", "pcre", "Phar", "Reflection", "SPL", "standard" ] } { "name": "amphp/http-client-cookies", "homepage": "https://github.com/amphp/http-client-cookies", "description": "Automatic cookie handling for Amp's HTTP client.", "keywords": [ "http", "cookie", "cookies", "client", "async" ], "license": "MIT", "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@gmail.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "require": { "php": ">=7.2", "ext-filter": "*", "amphp/amp": "^2.3", "amphp/dns": "^1.2", "amphp/http": "^1.5", "amphp/http-client": "^4", "amphp/sync": "^1.3", "psr/http-message": "^1.0" }, "require-dev": { "amphp/socket": "^1", "amphp/file": "^2", "amphp/phpunit-util": "^1.1", "amphp/php-cs-fixer-config": "dev-master", "phpunit/phpunit": "^7 || ^8", "friendsofphp/php-cs-fixer": "^2.3", "amphp/http-server": "dev-master" }, "autoload": { "psr-4": { "Amp\\Http\\Client\\Cookie\\": "src" } }, "autoload-dev": { "psr-4": { "Amp\\Http\\Client\\Cookie\\": "test" } }, "conflict": { "amphp/file": "<1 || >=3" }, "scripts": { "check": [ "@cs", "@test" ], "cs": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff --dry-run", "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" } } interceptNetwork(new CookieInterceptor($cookieJar)) ->build(); /** @var Response $firstResponse */ $firstResponse = yield $httpClient->request(new Request('https://google.com/')); yield $firstResponse->getBody()->buffer(); /** @var Response $secondResponse */ $secondResponse = yield $httpClient->request(new Request('https://google.com/')); yield $secondResponse->getBody()->buffer(); /** @var Response $otherDomainResponse */ $otherDomainResponse = yield $httpClient->request(new Request('https://amphp.org/')); yield $otherDomainResponse->getBody()->buffer(); print "== first request cookies ==\r\n"; print \implode("\r\n", $firstResponse->getRequest()->getHeaderArray('cookie')); print "\r\n\r\n"; print "== first response cookies ==\r\n"; print \implode("\r\n", $firstResponse->getHeaderArray('set-cookie')); print "\r\n\r\n"; print "== second request sends cookies back ==\r\n"; print \implode("\r\n", $secondResponse->getRequest()->getHeaderArray('cookie')); print "\r\n\r\n"; print "== other domain request does not send cookies ==\r\n"; print \implode("\r\n", $otherDomainResponse->getRequest()->getHeaderArray('cookie')); }); interceptNetwork(new CookieInterceptor($cookieJar)) ->build(); /** @var Response $firstResponse */ $firstResponse = yield $httpClient->request(new Request('https://google.com/')); yield $firstResponse->getBody()->buffer(); /** @var Response $secondResponse */ $secondResponse = yield $httpClient->request(new Request('https://google.com/')); yield $secondResponse->getBody()->buffer(); /** @var Response $otherDomainResponse */ $otherDomainResponse = yield $httpClient->request(new Request('https://amphp.org/')); yield $otherDomainResponse->getBody()->buffer(); print "== first request cookies ==\r\n"; print \implode("\r\n", $firstResponse->getRequest()->getHeaderArray('cookie')); print "\r\n\r\n"; print "== first response cookies ==\r\n"; print \implode("\r\n", $firstResponse->getHeaderArray('set-cookie')); print "\r\n\r\n"; print "== second request sends cookies back ==\r\n"; print \implode("\r\n", $secondResponse->getRequest()->getHeaderArray('cookie')); print "\r\n\r\n"; print "== other domain request (might send different cookies) ==\r\n"; print \implode("\r\n", $otherDomainResponse->getRequest()->getHeaderArray('cookie')); }); cookieJar = $cookieJar; } public function requestViaNetwork(Request $request, CancellationToken $cancellation, Stream $stream): Promise { return call(function () use ($request, $cancellation, $stream) { yield from $this->assignApplicableRequestCookies($request); $request->interceptPush(function (Response $response) { yield from $this->storeCookies($response); }); /** @var Response $response */ $response = yield $stream->request($request, $cancellation); yield from $this->storeCookies($response); return $response; }); } private function assignApplicableRequestCookies(Request $request): \Generator { $applicableCookies = yield $this->cookieJar->get($request->getUri()); if (!$applicableCookies) { return; // No cookies matched our request; we're finished. } $cookiePairs = []; /** @var RequestCookie $cookie */ foreach ($applicableCookies as $cookie) { $cookiePairs[] = (string) $cookie; } if ($cookiePairs) { if ($request->hasHeader('cookie')) { \array_unshift($cookiePairs, $request->getHeader('cookie')); } $request->setHeader('cookie', \implode('; ', $cookiePairs)); } } private function createResponseCookie(string $requestDomain, string $rawCookieStr): ?ResponseCookie { try { $cookie = ResponseCookie::fromHeader($rawCookieStr); if ($cookie === null) { return null; } if (!$cookie->getDomain()) { $cookie = $cookie->withDomain($requestDomain); } else { // https://tools.ietf.org/html/rfc6265#section-4.1.2.3 $cookieDomain = $cookie->getDomain(); // If a domain is set, left dots are ignored and it's always a wildcard $cookieDomain = \ltrim($cookieDomain, '.'); if ($cookieDomain !== $requestDomain) { // ignore cookies on domains that are public suffixes if (PublicSuffixList::isPublicSuffix($cookieDomain)) { return null; } // cookie origin would not be included when sending the cookie $cookieDomainLength = \strlen($cookieDomain); if (\substr($requestDomain, 0, -$cookieDomainLength - 1) . '.' . $cookieDomain !== $requestDomain) { return null; } } // always add the dot, it's used internally for wildcard matching when an explicit domain is sent $cookie = $cookie->withDomain('.' . $cookieDomain); } return $cookie; } catch (InvalidNameException $e) { // Ignore malformed Set-Cookie headers } return null; } /** * @param Response $response * * @return \Generator * @throws \Amp\Http\Client\HttpException */ private function storeCookies(Response $response): \Generator { if ($response->hasHeader('set-cookie')) { $requestDomain = $response->getRequest()->getUri()->getHost(); $rawCookies = $response->getHeaderArray('set-cookie'); $cookies = []; foreach ($rawCookies as $rawCookie) { $cookie = $this->createResponseCookie($requestDomain, $rawCookie); if ($cookie !== null) { $cookies[] = $cookie; } } if ($cookies) { yield $this->cookieJar->store(...$cookies); } } } } $label) { if ($label !== '*') { $labels[$key] = normalizeName($label); } } $rule = \implode('.', $labels); $regexParts = []; foreach (\explode('.', $rule) as $part) { if ($part === '*') { $regexParts[] = '[^.]+'; } else { /** @noinspection PregQuoteUsageInspection */ // We use (), so we don't have that problem $regexParts[] = \preg_quote($part); } } $regex = \array_reduce($regexParts, static function ($carry, $item) use ($exception) { if ($carry === '') { return $item; } return $item . "(?:\\." . $carry . ')' . ($exception ? '' : '?'); }, ''); return $regex; } private function __construct() { // no instances should be built } } */ private $cookieJar; /** @var string */ private $storagePath; /** @var Mutex */ private $mutex; /** @var bool */ private $persistSessionCookies = false; public function __construct(string $storagePath, ?Mutex $mutex = null) { if (!\interface_exists(File\Driver::class)) { throw new \Error(self::class . ' requires amphp/file to be installed. Run composer require amphp/file to install it.'); } $this->storagePath = $storagePath; $this->mutex = $mutex ?? new LocalMutex; } public function enableSessionCookiePersistence() { $this->persistSessionCookies = true; } public function disableSessionCookiePersistence() { $this->persistSessionCookies = false; } public function get(PsrUri $uri): Promise { return call(function () use ($uri) { /** @var CookieJar $cookieJar */ $cookieJar = yield $this->read(); return $cookieJar->get($uri); }); } public function store(ResponseCookie ...$cookies): Promise { return call(function () use ($cookies) { /** @var InMemoryCookieJar $cookieJar */ $cookieJar = yield $this->read(); yield $cookieJar->store(...$cookies); yield $this->write($cookieJar); }); } private function read(): Promise { if ($this->cookieJar) { return $this->cookieJar; } return $this->cookieJar = call(function () { /** @var Lock $lock */ $lock = yield $this->mutex->acquire(); $cookieJar = new InMemoryCookieJar; if (!yield File\exists($this->storagePath)) { return $cookieJar; } $readPromise = \function_exists('Amp\\File\\read') ? File\read($this->storagePath) : File\get($this->storagePath); $lines = \explode("\n", yield $readPromise); foreach ($lines as $line) { $line = \trim($line); if ($line) { $cookie = ResponseCookie::fromHeader($line); if ($cookie === null) { continue; } try { $cookieJar->store($cookie); } catch (HttpException $e) { // ignore invalid cookies in storage } } } $lock->release(); return $cookieJar; }); } private function write(InMemoryCookieJar $cookieJar): Promise { return call(function () use ($cookieJar) { $cookieData = ''; foreach ($cookieJar->getAll() as $cookie) { /** @var $cookie ResponseCookie */ if ($cookie->getExpiry() ? $cookie->getExpiry()->getTimestamp() > \time() : $this->persistSessionCookies) { $cookieData .= $cookie . "\r\n"; } } /** @var Lock $lock */ $lock = yield $this->mutex->acquire(); if (\function_exists('Amp\\File\\createDirectoryRecursively')) { try { yield File\createDirectoryRecursively(\dirname($this->storagePath), 0755); } catch (File\FilesystemException $e) { throw new HttpException('Failed to create cookie storage directory: ' . $this->storagePath); } yield File\write($this->storagePath, $cookieData); } else { if (!yield File\isdir(\dirname($this->storagePath))) { yield File\mkdir(\dirname($this->storagePath), 0755, true); if (!yield File\isdir(\dirname($this->storagePath))) { throw new HttpException('Failed to create cookie storage directory: ' . $this->storagePath); } } yield File\put($this->storagePath, $cookieData); } $lock->release(); }); } } Returns an array (possibly empty) of all cookie matches. */ public function get(PsrUri $uri): Promise; /** * Store a cookie. * * @param ResponseCookie ...$cookie * * @return Promise * * @throws HttpException */ public function store(ResponseCookie ...$cookie): Promise; } getDomain() === '') { throw new HttpException("Can't store cookie without domain information."); } $this->cookies[$cookie->getDomain()][$cookie->getPath() ?: '/'][$cookie->getName()] = $cookie; } return new Success; } public function get(PsrUri $uri): Promise { $this->clearExpiredCookies(); $path = $uri->getPath() ?: '/'; $domain = $uri->getHost(); $isRequestSecure = $uri->getScheme() === 'https'; $matches = []; foreach ($this->cookies as $cookieDomain => $domainCookies) { if (!$this->matchesDomain($domain, $cookieDomain)) { continue; } foreach ($domainCookies as $cookiePath => $pathCookies) { if (!$this->matchesPath($path, $cookiePath)) { continue; } foreach ($pathCookies as $cookieName => $cookie) { if ($isRequestSecure || !$cookie->isSecure()) { try { $matches[] = new RequestCookie($cookie->getName(), $cookie->getValue()); } catch (InvalidCookieException $e) { // ignore cookie } } } } } return new Success($matches); } public function getAll(): array { $cookies = []; foreach ($this->cookies as $cookiesPerDomain) { foreach ($cookiesPerDomain as $cookiesPerPath) { foreach ($cookiesPerPath as $cookie) { $cookies[] = $cookie; } } } return $cookies; } public function clear(): void { $this->cookies = []; } private function clearExpiredCookies(): void { foreach ($this->cookies as $domain => $domainCookies) { foreach ($domainCookies as $path => $pathCookies) { foreach ($pathCookies as $name => $cookie) { /** @var ResponseCookie $cookie */ if ($cookie->getExpiry() && $cookie->getExpiry()->getTimestamp() < \time()) { unset($this->cookies[$domain][$path][$name]); } } } } } /** * @param string $requestDomain * @param string $cookieDomain * * @return bool * * @link http://tools.ietf.org/html/rfc6265#section-5.1.3 */ private function matchesDomain(string $requestDomain, string $cookieDomain): bool { if ($requestDomain === \ltrim($cookieDomain, '.')) { return true; } /** @noinspection SubStrUsedAsStrPosInspection */ $isWildcardCookieDomain = $cookieDomain[0] === '.'; if (!$isWildcardCookieDomain) { return false; } if (\filter_var($requestDomain, FILTER_VALIDATE_IP)) { return false; } if (\substr($requestDomain, 0, -\strlen($cookieDomain)) . $cookieDomain === $requestDomain) { return true; } return false; } /** * @link http://tools.ietf.org/html/rfc6265#section-5.1.4 * * @param string $requestPath * @param string $cookiePath * * @return bool */ private function matchesPath(string $requestPath, string $cookiePath): bool { if ($requestPath === $cookiePath) { return true; } if (\strpos($requestPath, $cookiePath) !== 0) { return false; } if ((\substr($cookiePath, -1) === '/' || $requestPath[\strlen($cookiePath)] === '/')) { return true; } return false; } } { "name": "amphp/http", "description": "Basic HTTP primitives which can be shared by servers and clients.", "type": "library", "license": "MIT", "authors": [ { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "autoload": { "psr-4": { "Amp\\Http\\": "src" }, "files": [ "src/functions.php" ] }, "require": { "php": ">=7.1", "amphp/hpack": "^3" }, "require-dev": { "phpunit/phpunit": "^9 || ^8 || ^7", "amphp/php-cs-fixer-config": "^2-dev" }, "scripts": { "test": "php -dzend.assertions=1 -dassert.exception=1 vendor/bin/phpunit", "code-style": "php vendor/bin/php-cs-fixer fix" }, "extra": { "branch-alias": { "dev-master": "1.x-dev" } } } withSecure(); break; case 'httponly': $meta = $meta->withHttpOnly(); break; default: $unknownAttributes[] = $part; break; } } else { switch ($key) { case 'expires': $time = self::parseDate($pieces[1]); if ($time === null) { break; // break is correct, see https://tools.ietf.org/html/rfc6265#section-5.2.1 } $meta = $meta->withExpiry($time); break; case 'max-age': $maxAge = \trim($pieces[1]); // This also allows +1.42, but avoids a more complicated manual check if (!\is_numeric($maxAge)) { break; // break is correct, see https://tools.ietf.org/html/rfc6265#section-5.2.2 } $meta = $meta->withMaxAge($maxAge); break; case 'path': $meta = $meta->withPath($pieces[1]); break; case 'domain': $meta = $meta->withDomain($pieces[1]); break; case 'samesite': $normalizedValue = \ucfirst(\strtolower($pieces[1])); if (!\in_array($normalizedValue, [ CookieAttributes::SAMESITE_NONE, CookieAttributes::SAMESITE_LAX, CookieAttributes::SAMESITE_STRICT, ], true)) { $unknownAttributes[] = $part; } else { $meta = $meta->withSameSite($normalizedValue); } break; default: $unknownAttributes[] = $part; break; } } } try { $cookie = new self($name, $value, $meta); $cookie->unknownAttributes = $unknownAttributes; return $cookie; } catch (InvalidCookieException $e) { return null; } } /** * @param string $date Formatted cookie date * * @return \DateTimeImmutable|null Parsed date. */ private static function parseDate(string $date): ?\DateTimeImmutable { foreach (self::$dateFormats as $dateFormat) { if ($parsedDate = \DateTimeImmutable::createFromFormat($dateFormat, $date, new \DateTimeZone('GMT'))) { return $parsedDate; } } return null; } /** @var string[] */ private $unknownAttributes = []; /** @var string */ private $name; /** @var string */ private $value; /** @var CookieAttributes */ private $attributes; /** * @param string $name Name of the cookie. * @param string $value Value of the cookie. * @param CookieAttributes $attributes Attributes of the cookie. * * @throws InvalidCookieException If name or value is invalid. */ public function __construct( string $name, string $value = '', CookieAttributes $attributes = null ) { if (!\preg_match('(^[^()<>@,;:\\\"/[\]?={}\x01-\x20\x7F]++$)', $name)) { throw new InvalidCookieException("Invalid cookie name: '{$name}'"); } if (!\preg_match('(^[\x21\x23-\x2B\x2D-\x3A\x3C-\x5B\x5D-\x7E]*+$)', $value)) { throw new InvalidCookieException("Invalid cookie value: '{$value}'"); } $this->name = $name; $this->value = $value; $this->attributes = $attributes ?? CookieAttributes::default(); } /** * @return string Name of the cookie. */ public function getName(): string { return $this->name; } public function withName(string $name): self { if (!\preg_match('(^[^()<>@,;:\\\"/[\]?={}\x01-\x20\x7F]++$)', $name)) { throw new InvalidCookieException("Invalid cookie name: '{$name}'"); } $clone = clone $this; $clone->name = $name; return $clone; } /** * @return string Value of the cookie. */ public function getValue(): string { return $this->value; } public function withValue(string $value): self { if (!\preg_match('(^[\x21\x23-\x2B\x2D-\x3A\x3C-\x5B\x5D-\x7E]*+$)', $value)) { throw new InvalidCookieException("Invalid cookie value: '{$value}'"); } $clone = clone $this; $clone->value = $value; return $clone; } /** * @return \DateTimeImmutable|null Expiry if set, otherwise `null`. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.1 */ public function getExpiry(): ?\DateTimeImmutable { return $this->attributes->getExpiry(); } public function withExpiry(\DateTimeInterface $expiry): self { return $this->withAttributes($this->attributes->withExpiry($expiry)); } public function withoutExpiry(): self { return $this->withAttributes($this->attributes->withoutExpiry()); } /** * @return int|null Max-Age if set, otherwise `null`. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.2 */ public function getMaxAge(): ?int { return $this->attributes->getMaxAge(); } public function withMaxAge(int $maxAge): self { return $this->withAttributes($this->attributes->withMaxAge($maxAge)); } public function withoutMaxAge(): self { return $this->withAttributes($this->attributes->withoutMaxAge()); } /** * @return string Cookie path. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.4 */ public function getPath(): string { return $this->attributes->getPath(); } public function withPath(string $path): self { return $this->withAttributes($this->attributes->withPath($path)); } /** * @return string Cookie domain. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.3 */ public function getDomain(): string { return $this->attributes->getDomain(); } public function withDomain(string $domain): self { return $this->withAttributes($this->attributes->withDomain($domain)); } /** * @return bool Whether the secure flag is enabled or not. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.5 */ public function isSecure(): bool { return $this->attributes->isSecure(); } public function withSecure(): self { return $this->withAttributes($this->attributes->withSecure()); } public function withoutSecure(): self { return $this->withAttributes($this->attributes->withoutSecure()); } /** * @return bool Whether the httpOnly flag is enabled or not. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.6 */ public function isHttpOnly(): bool { return $this->attributes->isHttpOnly(); } public function withHttpOnly(): self { return $this->withAttributes($this->attributes->withHttpOnly()); } public function withoutHttpOnly(): self { return $this->withAttributes($this->attributes->withoutHttpOnly()); } public function withSameSite(string $sameSite): self { return $this->withAttributes($this->attributes->withSameSite($sameSite)); } public function withoutSameSite(): self { return $this->withAttributes($this->attributes->withoutSameSite()); } public function getSameSite(): ?string { return $this->attributes->getSameSite(); } /** * @return CookieAttributes All cookie attributes. */ public function getAttributes(): CookieAttributes { return $this->attributes; } public function withAttributes(CookieAttributes $attributes): self { $clone = clone $this; $clone->attributes = $attributes; return $clone; } /** * @return string Representation of the cookie as in a 'set-cookie' header. */ public function __toString(): string { $line = $this->name . '=' . $this->value; $line .= $this->attributes; $unknownAttributes = \implode('; ', $this->unknownAttributes); if ($unknownAttributes !== '') { $line .= '; ' . $unknownAttributes; } return $line; } } @,;:\\\"/[\]?={}\x01-\x20\x7F]*+$)', $name)) { throw new InvalidCookieException("Invalid cookie name: '{$name}'"); } if (!\preg_match('(^[\x21\x23-\x2B\x2D-\x3A\x3C-\x5B\x5D-\x7E]*+$)', $value)) { throw new InvalidCookieException("Invalid cookie value: '{$value}'"); } $this->name = $name; $this->value = $value; } /** * @return string Name of the cookie. */ public function getName(): string { return $this->name; } public function withName(string $name): self { if (!\preg_match('(^[^()<>@,;:\\\"/[\]?={}\x01-\x20\x7F]++$)', $name)) { throw new InvalidCookieException("Invalid cookie name: '{$name}'"); } $clone = clone $this; $clone->name = $name; return $clone; } /** * @return string Value of the cookie. */ public function getValue(): string { return $this->value; } public function withValue(string $value): self { if (!\preg_match('(^[\x21\x23-\x2B\x2D-\x3A\x3C-\x5B\x5D-\x7E]*+$)', $value)) { throw new InvalidCookieException("Invalid cookie value: '{$value}'"); } $clone = clone $this; $clone->value = $value; return $clone; } /** * @return string Representation of the cookie as in a 'cookie' header. */ public function __toString(): string { return $this->name . '=' . $this->value; } } httpOnly = false; return $new; } /** * @return CookieAttributes Default cookie attributes, which means httpOnly is enabled by default. * * @see self::empty() */ public static function default(): self { return new self; } /** @var string */ private $path = ''; /** @var string */ private $domain = ''; /** @var int|null */ private $maxAge; /** @var \DateTimeImmutable */ private $expiry; /** @var bool */ private $secure = false; /** @var bool */ private $httpOnly = true; /** @var string|null */ private $sameSite; private function __construct() { // only allow creation via named constructors } /** * @param string $path Cookie path. * * @return self Cloned instance with the specified operation applied. Cloned instance with the specified operation * applied. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.4 */ public function withPath(string $path): self { $new = clone $this; $new->path = $path; return $new; } /** * @param string $domain Cookie domain. * * @return self Cloned instance with the specified operation applied. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.3 */ public function withDomain(string $domain): self { $new = clone $this; $new->domain = $domain; return $new; } /** * @param string $sameSite Cookie SameSite attribute value. * * @return self Cloned instance with the specified operation applied. * * @link https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-03#section-5.3.7 */ public function withSameSite(string $sameSite): self { $normalizedValue = \ucfirst(\strtolower($sameSite)); if (!\in_array($normalizedValue, [self::SAMESITE_NONE, self::SAMESITE_LAX, self::SAMESITE_STRICT], true)) { throw new \Error("Invalid SameSite attribute: " . $sameSite); } $new = clone $this; $new->sameSite = $normalizedValue; return $new; } /** * @return self Cloned instance with the specified operation applied. * * @link https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-03#section-5.3.7 */ public function withoutSameSite(): self { $new = clone $this; $new->sameSite = null; return $new; } /** * Applies the given maximum age to the cookie. * * @param int $maxAge Cookie maximum age. * * @return self Cloned instance with the specified operation applied. * * @see self::withoutMaxAge() * @see self::withExpiry() * * @link https://tools.ietf.org/html/rfc6265#section-5.2.2 */ public function withMaxAge(int $maxAge): self { $new = clone $this; $new->maxAge = $maxAge; return $new; } /** * Removes any max-age information. * * @return self Cloned instance with the specified operation applied. * * @see self::withMaxAge() * * @link https://tools.ietf.org/html/rfc6265#section-5.2.2 */ public function withoutMaxAge(): self { $new = clone $this; $new->maxAge = null; return $new; } /** * Applies the given expiry to the cookie. * * @return self Cloned instance with the specified operation applied. * * @see self::withMaxAge() * @see self::withoutExpiry() * * @link https://tools.ietf.org/html/rfc6265#section-5.2.1 */ public function withExpiry(\DateTimeInterface $date): self { $new = clone $this; if ($date instanceof \DateTimeImmutable) { $new->expiry = $date; } elseif ($date instanceof \DateTime) { $new->expiry = \DateTimeImmutable::createFromMutable($date); } else { $new->expiry = new \DateTimeImmutable("@" . $date->getTimestamp()); } return $new; } /** * Removes any expiry information. * * @return self Cloned instance with the specified operation applied. * * @see self::withExpiry() * * @link https://tools.ietf.org/html/rfc6265#section-5.2.1 */ public function withoutExpiry(): self { $new = clone $this; $new->expiry = null; return $new; } /** * @return self Cloned instance with the specified operation applied. * * @see self::withoutSecure() * * @link https://tools.ietf.org/html/rfc6265#section-5.2.5 */ public function withSecure(): self { $new = clone $this; $new->secure = true; return $new; } /** * @return self Cloned instance with the specified operation applied. * * @see self::withSecure() * * @link https://tools.ietf.org/html/rfc6265#section-5.2.5 */ public function withoutSecure(): self { $new = clone $this; $new->secure = false; return $new; } /** * @return self Cloned instance with the specified operation applied. * * @see self::withoutHttpOnly() * * @link https://tools.ietf.org/html/rfc6265#section-5.2.6 */ public function withHttpOnly(): self { $new = clone $this; $new->httpOnly = true; return $new; } /** * @return self Cloned instance with the specified operation applied. * * @see self::withHttpOnly() * * @link https://tools.ietf.org/html/rfc6265#section-5.2.6 */ public function withoutHttpOnly(): self { $new = clone $this; $new->httpOnly = false; return $new; } /** * @return string Cookie path. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.4 */ public function getPath(): string { return $this->path; } /** * @return string Cookie domain. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.3 */ public function getDomain(): string { return $this->domain; } /** * @return string Cookie domain. * * @link https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-03#section-5.3.7 */ public function getSameSite(): ?string { return $this->sameSite; } /** * @return int|null Cookie maximum age in seconds or `null` if no value is set. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.2 */ public function getMaxAge(): ?int { return $this->maxAge; } /** * @return \DateTimeImmutable|null Cookie expiry or `null` if no value is set. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.2 */ public function getExpiry(): ?\DateTimeImmutable { return $this->expiry; } /** * @return bool Whether the secure flag is enabled or not. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.5 */ public function isSecure(): bool { return $this->secure; } /** * @return bool Whether the httpOnly flag is enabled or not. * * @link https://tools.ietf.org/html/rfc6265#section-5.2.6 */ public function isHttpOnly(): bool { return $this->httpOnly; } /** * @return string Representation of the cookie attributes appended to key=value in a 'set-cookie' header. */ public function __toString(): string { $string = ''; if ($this->expiry) { $string .= '; Expires=' . \gmdate('D, j M Y G:i:s T', $this->expiry->getTimestamp()); } if ($this->maxAge) { $string .= '; Max-Age=' . $this->maxAge; } if ('' !== $this->path) { $string .= '; Path=' . $this->path; } if ('' !== $this->domain) { $string .= '; Domain=' . $this->domain; } if ($this->secure) { $string .= '; Secure'; } if ($this->httpOnly) { $string .= '; HttpOnly'; } if ($this->sameSite !== null) { $string .= '; SameSite=' . $this->sameSite; } return $string; } } 'Continue', 101 => 'Switching Protocols', 102 => 'Processing', 103 => 'Early Hints', 200 => 'OK', 201 => 'Created', 202 => 'Accepted', 203 => 'Non-Authoritative Information', 204 => 'No Content', 205 => 'Reset Content', 206 => 'Partial Content', 207 => 'Multi-Status', 208 => 'Already Reported', 226 => 'IM Used', 300 => 'Multiple Choices', 301 => 'Moved Permanently', 302 => 'Found', 303 => 'See Other', 304 => 'Not Modified', 305 => 'Use Proxy', 307 => 'Temporary Redirect', 308 => 'Permanent Redirect', 400 => 'Bad Request', 401 => 'Unauthorized', 402 => 'Payment Required', 403 => 'Forbidden', 404 => 'Not Found', 405 => 'Method Not Allowed', 406 => 'Not Acceptable', 407 => 'Proxy Authentication Required', 408 => 'Request Timeout', 409 => 'Conflict', 410 => 'Gone', 411 => 'Length Required', 412 => 'Precondition Failed', 413 => 'Payload Too Large', 414 => 'URI Too Long', 415 => 'Unsupported Media Type', 416 => 'Range Not Satisfiable', 417 => 'Expectation Failed', 421 => 'Misdirected Request', 422 => 'Unprocessable Entity', 423 => 'Locked', 424 => 'Failed Dependency', 426 => 'Upgrade Required', 428 => 'Precondition Required', 429 => 'Too Many Requests', 431 => 'Request Header Fields Too Large', 451 => 'Unavailable For Legal Reasons', 500 => 'Internal Server Error', 501 => 'Not Implemented', 502 => 'Bad Gateway', 503 => 'Service Unavailable', 504 => 'Gateway Timeout', 505 => 'HTTP Version Not Supported', 506 => 'Variant Also Negotiates', 507 => 'Insufficient Storage', 508 => 'Loop Detected', 510 => 'Not Extended', 511 => 'Network Authentication Required', ][$code] ?? ''; } } streamId = $streamId; } public function getStreamId(): int { return $this->streamId; } } true, ]; public const KNOWN_REQUEST_PSEUDO_HEADERS = [ ":method" => true, ":authority" => true, ":path" => true, ":scheme" => true, ]; // SETTINGS Flags - https://http2.github.io/http2-spec/#rfc.section.6.5 public const ACK = 0x01; // HEADERS Flags - https://http2.github.io/http2-spec/#rfc.section.6.2 public const NO_FLAG = 0x00; public const END_STREAM = 0x01; public const END_HEADERS = 0x04; public const PADDED = 0x08; public const PRIORITY_FLAG = 0x20; // Frame Types - https://http2.github.io/http2-spec/#rfc.section.11.2 public const DATA = 0x00; public const HEADERS = 0x01; public const PRIORITY = 0x02; public const RST_STREAM = 0x03; public const SETTINGS = 0x04; public const PUSH_PROMISE = 0x05; public const PING = 0x06; public const GOAWAY = 0x07; public const WINDOW_UPDATE = 0x08; public const CONTINUATION = 0x09; // Settings public const HEADER_TABLE_SIZE = 0x1; // 1 << 12 public const ENABLE_PUSH = 0x2; // 1 public const MAX_CONCURRENT_STREAMS = 0x3; // INF public const INITIAL_WINDOW_SIZE = 0x4; // 1 << 16 - 1 public const MAX_FRAME_SIZE = 0x5; // 1 << 14 public const MAX_HEADER_LIST_SIZE = 0x6; // INF // Error codes public const GRACEFUL_SHUTDOWN = 0x0; public const PROTOCOL_ERROR = 0x1; public const INTERNAL_ERROR = 0x2; public const FLOW_CONTROL_ERROR = 0x3; public const SETTINGS_TIMEOUT = 0x4; public const STREAM_CLOSED = 0x5; public const FRAME_SIZE_ERROR = 0x6; public const REFUSED_STREAM = 0x7; public const CANCEL = 0x8; public const COMPRESSION_ERROR = 0x9; public const CONNECT_ERROR = 0xa; public const ENHANCE_YOUR_CALM = 0xb; public const INADEQUATE_SECURITY = 0xc; public const HTTP_1_1_REQUIRED = 0xd; public static function getFrameName(int $type): string { $names = [ self::DATA => 'DATA', self::HEADERS => 'HEADERS', self::PRIORITY => 'PRIORITY', self::RST_STREAM => 'RST_STREAM', self::SETTINGS => 'SETTINGS', self::PUSH_PROMISE => 'PUSH_PROMISE', self::PING => 'PING', self::GOAWAY => 'GOAWAY', self::WINDOW_UPDATE => 'WINDOW_UPDATE', self::CONTINUATION => 'CONTINUATION', ]; return $names[$type] ?? ('0x' . \bin2hex(\chr($type))); } public static function logDebugFrame( string $action, int $frameType, int $frameFlags, int $streamId, int $frameLength ): bool { $env = \getenv("AMP_DEBUG_HTTP2_FRAMES") ?: "0"; if (($env !== "0" && $env !== "false") || (\defined("AMP_DEBUG_HTTP2_FRAMES") && \AMP_DEBUG_HTTP2_FRAMES)) { \fwrite( \STDERR, $action . ' ' . self::getFrameName($frameType) . ' ' . "\r\n" ); } return true; } /** @var string */ private $buffer = ''; /** @var int */ private $bufferOffset = 0; /** @var int */ private $headerSizeLimit = self::DEFAULT_MAX_FRAME_SIZE; // Should be configurable? /** @var bool */ private $continuationExpected = false; /** @var int */ private $headerFrameType = 0; /** @var string */ private $headerBuffer = ''; /** @var int */ private $headerStream = 0; /** @var HPack */ private $hpack; /** @var Http2Processor */ private $handler; /** @var int */ private $receivedFrameCount = 0; /** @var int */ private $receivedByteCount = 0; public function __construct(Http2Processor $handler) { $this->hpack = new HPack; $this->handler = $handler; } public function getReceivedByteCount(): int { return $this->receivedByteCount; } public function getReceivedFrameCount(): int { return $this->receivedFrameCount; } public function parse(string $settings = null): \Generator { if ($settings !== null) { $this->parseSettings($settings, \strlen($settings), self::NO_FLAG, 0); } $this->buffer = yield; while (true) { $frameHeader = yield from $this->consume(9); [ 'length' => $frameLength, 'type' => $frameType, 'flags' => $frameFlags, 'id' => $streamId, ] = \unpack('Nlength/ctype/cflags/Nid', "\0" . $frameHeader); $streamId &= 0x7fffffff; $frameBuffer = $frameLength === 0 ? '' : yield from $this->consume($frameLength); $this->receivedFrameCount++; \assert(self::logDebugFrame('recv', $frameType, $frameFlags, $streamId, $frameLength)); try { // Do we want to allow increasing the maximum frame size? if ($frameLength > self::DEFAULT_MAX_FRAME_SIZE) { throw new Http2ConnectionException("Frame size limit exceeded", self::FRAME_SIZE_ERROR); } if ($this->continuationExpected && $frameType !== self::CONTINUATION) { throw new Http2ConnectionException("Expected continuation frame", self::PROTOCOL_ERROR); } switch ($frameType) { case self::DATA: $this->parseDataFrame($frameBuffer, $frameLength, $frameFlags, $streamId); break; case self::PUSH_PROMISE: $this->parsePushPromise($frameBuffer, $frameLength, $frameFlags, $streamId); break; case self::HEADERS: $this->parseHeaders($frameBuffer, $frameLength, $frameFlags, $streamId); break; case self::PRIORITY: $this->parsePriorityFrame($frameBuffer, $frameLength, $streamId); break; case self::RST_STREAM: $this->parseStreamReset($frameBuffer, $frameLength, $streamId); break; case self::SETTINGS: $this->parseSettings($frameBuffer, $frameLength, $frameFlags, $streamId); break; case self::PING: $this->parsePing($frameBuffer, $frameLength, $frameFlags, $streamId); break; case self::GOAWAY: $this->parseGoAway($frameBuffer, $frameLength, $streamId); break; case self::WINDOW_UPDATE: $this->parseWindowUpdate($frameBuffer, $frameLength, $streamId); break; case self::CONTINUATION: $this->parseContinuation($frameBuffer, $frameFlags, $streamId); break; default: // Ignore and discard unknown frame per spec break; } } catch (Http2StreamException $exception) { $this->handler->handleStreamException($exception); } catch (Http2ConnectionException $exception) { $this->handler->handleConnectionException($exception); throw $exception; } } } private function consume(int $bytes): \Generator { $bufferEnd = $this->bufferOffset + $bytes; while (\strlen($this->buffer) < $bufferEnd) { $this->buffer .= yield; } $consumed = \substr($this->buffer, $this->bufferOffset, $bytes); if ($bufferEnd > 2048) { $this->buffer = \substr($this->buffer, $bufferEnd); $this->bufferOffset = 0; } else { $this->bufferOffset += $bytes; } $this->receivedByteCount += $bytes; return $consumed; } private function parseDataFrame(string $frameBuffer, int $frameLength, int $frameFlags, int $streamId): void { $isPadded = $frameFlags & self::PADDED; $headerLength = $isPadded ? 1 : 0; if ($frameLength < $headerLength) { $this->throwInvalidFrameSizeError(); } $header = $headerLength === 0 ? '' : \substr($frameBuffer, 0, $headerLength); $padding = $isPadded ? \ord($header[0]) : 0; if ($streamId === 0) { $this->throwInvalidZeroStreamIdError(); } if ($frameLength - $headerLength - $padding < 0) { $this->throwInvalidPaddingError(); } $data = \substr($frameBuffer, $headerLength, $frameLength - $headerLength - $padding); $this->handler->handleData($streamId, $data); if ($frameFlags & self::END_STREAM) { $this->handler->handleStreamEnd($streamId); } } /** @see https://http2.github.io/http2-spec/#rfc.section.6.6 */ private function parsePushPromise(string $frameBuffer, int $frameLength, int $frameFlags, int $streamId): void { $isPadded = $frameFlags & self::PADDED; $headerLength = $isPadded ? 5 : 4; if ($frameLength < $headerLength) { $this->throwInvalidFrameSizeError(); } $header = \substr($frameBuffer, 0, $headerLength); $padding = $isPadded ? \ord($header[0]) : 0; $pushId = \unpack("N", $header)[1] & 0x7fffffff; if ($frameLength - $headerLength - $padding < 0) { $this->throwInvalidPaddingError(); } $this->headerFrameType = self::PUSH_PROMISE; $this->pushHeaderBlockFragment( $pushId, \substr($frameBuffer, $headerLength, $frameLength - $headerLength - $padding) ); if ($frameFlags & self::END_HEADERS) { $this->continuationExpected = false; [$pseudo, $headers] = $this->parseHeaderBuffer(); $this->handler->handlePushPromise($streamId, $pushId, $pseudo, $headers); } else { $this->continuationExpected = true; } if ($frameFlags & self::END_STREAM) { $this->handler->handleStreamEnd($streamId); } } private function parseHeaderBuffer(): array { if ($this->headerStream === 0) { throw new Http2ConnectionException('Invalid stream ID 0 for header block', self::PROTOCOL_ERROR); } if ($this->headerBuffer === '') { throw new Http2StreamException('Invalid empty header section', $this->headerStream, self::PROTOCOL_ERROR); } $decoded = $this->hpack->decode($this->headerBuffer, $this->headerSizeLimit); if ($decoded === null) { throw new Http2ConnectionException("Compression error in headers", self::COMPRESSION_ERROR); } $headers = []; $pseudo = []; foreach ($decoded as [$name, $value]) { if (!\preg_match(self::HEADER_NAME_REGEX, $name)) { throw new Http2StreamException("Invalid header field name", $this->headerStream, self::PROTOCOL_ERROR); } if ($name[0] === ':') { if (!empty($headers)) { throw new Http2ConnectionException( "Pseudo header after other headers", self::PROTOCOL_ERROR ); } if (isset($pseudo[$name])) { throw new Http2ConnectionException( "Repeat pseudo header", self::PROTOCOL_ERROR ); } $pseudo[$name] = $value; continue; } $headers[$name][] = $value; } $this->headerBuffer = ''; $this->headerStream = 0; return [$pseudo, $headers]; } private function pushHeaderBlockFragment(int $streamId, string $buffer): void { if ($this->headerStream !== 0 && $this->headerStream !== $streamId) { throw new Http2ConnectionException( "Expected CONTINUATION frame for stream ID " . $this->headerStream, self::PROTOCOL_ERROR ); } $this->headerStream = $streamId; $this->headerBuffer .= $buffer; } /** @see https://http2.github.io/http2-spec/#HEADERS */ private function parseHeaders(string $frameBuffer, int $frameLength, int $frameFlags, int $streamId): void { if ($streamId === 0) { $this->throwInvalidZeroStreamIdError(); } $headerLength = 0; $isPadded = $frameFlags & self::PADDED; $isPriority = $frameFlags & self::PRIORITY_FLAG; if ($isPadded) { $headerLength++; } if ($isPriority) { $headerLength += 5; } if ($frameLength < $headerLength) { $this->throwInvalidFrameSizeError(); } $header = \substr($frameBuffer, 0, $headerLength); $padding = $isPadded ? \ord($header[0]) : 0; if ($isPriority) { ['parent' => $parent, 'weight' => $weight] = \unpack("Nparent/cweight", $header, $isPadded ? 1 : 0); $parent &= 0x7fffffff; if ($parent === $streamId) { $this->throwInvalidRecursiveDependency($streamId); } $this->handler->handlePriority($streamId, $parent, $weight + 1); } if ($frameLength - $headerLength - $padding < 0) { $this->throwInvalidPaddingError(); } $this->headerFrameType = self::HEADERS; $this->pushHeaderBlockFragment( $streamId, \substr($frameBuffer, $headerLength, $frameLength - $headerLength - $padding) ); $ended = $frameFlags & self::END_STREAM; if ($frameFlags & self::END_HEADERS) { $this->continuationExpected = false; $headersTooLarge = \strlen($this->headerBuffer) > $this->headerSizeLimit; [$pseudo, $headers] = $this->parseHeaderBuffer(); // This must happen after the parsing, otherwise we loose the connection state and must close the whole // connection, which is not what we want here… if ($headersTooLarge) { throw new Http2StreamException( "Headers exceed maximum configured size of {$this->headerSizeLimit} bytes", $streamId, self::ENHANCE_YOUR_CALM ); } $this->handler->handleHeaders($streamId, $pseudo, $headers, $ended); } else { $this->continuationExpected = true; } if ($ended) { $this->handler->handleStreamEnd($streamId); } } private function parsePriorityFrame(string $frameBuffer, int $frameLength, int $streamId): void { if ($frameLength !== 5) { $this->throwInvalidFrameSizeError(); } ['parent' => $parent, 'weight' => $weight] = \unpack("Nparent/cweight", $frameBuffer); if ($exclusive = ($parent & 0x80000000)) { $parent &= 0x7fffffff; } if ($streamId === 0) { $this->throwInvalidZeroStreamIdError(); } if ($parent === $streamId) { $this->throwInvalidRecursiveDependency($streamId); } $this->handler->handlePriority($streamId, $parent, $weight + 1); } private function parseStreamReset(string $frameBuffer, int $frameLength, int $streamId): void { if ($frameLength !== 4) { $this->throwInvalidFrameSizeError(); } if ($streamId === 0) { $this->throwInvalidZeroStreamIdError(); } $errorCode = \unpack('N', $frameBuffer)[1]; $this->handler->handleStreamReset($streamId, $errorCode); } private function parseSettings(string $frameBuffer, int $frameLength, int $frameFlags, int $streamId): void { if ($streamId !== 0) { $this->throwInvalidNonZeroStreamIdError(); } if ($frameFlags & self::ACK) { if ($frameLength) { $this->throwInvalidFrameSizeError(); } return; // Got ACK, nothing to do } if ($frameLength % 6 !== 0) { $this->throwInvalidFrameSizeError(); } if ($frameLength > 60) { // Even with room for a few future options, sending that a big SETTINGS frame is just about // wasting our processing time. We declare this a protocol error. throw new Http2ConnectionException("Excessive SETTINGS frame", self::PROTOCOL_ERROR); } $settings = []; while ($frameLength > 0) { ['key' => $key, 'value' => $value] = \unpack("nkey/Nvalue", $frameBuffer); if ($value < 0) { throw new Http2ConnectionException( "Invalid setting: {$value}", self::PROTOCOL_ERROR ); } $settings[$key] = $value; $frameBuffer = \substr($frameBuffer, 6); $frameLength -= 6; } $this->handler->handleSettings($settings); } /** @see https://http2.github.io/http2-spec/#rfc.section.6.7 */ private function parsePing(string $frameBuffer, int $frameLength, int $frameFlags, int $streamId): void { if ($frameLength !== 8) { $this->throwInvalidFrameSizeError(); } if ($streamId !== 0) { $this->throwInvalidNonZeroStreamIdError(); } if ($frameFlags & self::ACK) { $this->handler->handlePong($frameBuffer); } else { $this->handler->handlePing($frameBuffer); } } /** @see https://http2.github.io/http2-spec/#rfc.section.6.8 */ private function parseGoAway(string $frameBuffer, int $frameLength, int $streamId): void { if ($frameLength < 8) { $this->throwInvalidFrameSizeError(); } if ($streamId !== 0) { $this->throwInvalidNonZeroStreamIdError(); } ['last' => $lastId, 'error' => $error] = \unpack("Nlast/Nerror", $frameBuffer); $this->handler->handleShutdown($lastId & 0x7fffffff, $error); } /** @see https://http2.github.io/http2-spec/#rfc.section.6.9 */ private function parseWindowUpdate(string $frameBuffer, int $frameLength, int $streamId): void { if ($frameLength !== 4) { $this->throwInvalidFrameSizeError(); } $windowSize = \unpack('N', $frameBuffer)[1]; if ($windowSize === 0) { if ($streamId) { throw new Http2StreamException( "Invalid zero window update value", $streamId, self::PROTOCOL_ERROR ); } throw new Http2ConnectionException("Invalid zero window update value", self::PROTOCOL_ERROR); } if ($streamId) { $this->handler->handleStreamWindowIncrement($streamId, $windowSize); } else { $this->handler->handleConnectionWindowIncrement($windowSize); } } /** @see https://http2.github.io/http2-spec/#rfc.section.6.10 */ private function parseContinuation(string $frameBuffer, int $frameFlags, int $streamId): void { if ($streamId !== $this->headerStream) { throw new Http2ConnectionException( "Invalid CONTINUATION frame stream ID", self::PROTOCOL_ERROR ); } if ($this->headerBuffer === '') { throw new Http2ConnectionException( "Unexpected CONTINUATION frame for stream ID " . $this->headerStream, self::PROTOCOL_ERROR ); } $this->pushHeaderBlockFragment($streamId, $frameBuffer); $ended = $frameFlags & self::END_STREAM; if ($frameFlags & self::END_HEADERS) { $this->continuationExpected = false; $isPush = $this->headerFrameType === self::PUSH_PROMISE; $pushId = $this->headerStream; [$pseudo, $headers] = $this->parseHeaderBuffer(); if ($isPush) { $this->handler->handlePushPromise($streamId, $pushId, $pseudo, $headers); } else { $this->handler->handleHeaders($streamId, $pseudo, $headers, $ended); } } if ($ended) { $this->handler->handleStreamEnd($streamId); } } private function throwInvalidFrameSizeError(): void { throw new Http2ConnectionException("Invalid frame length", self::PROTOCOL_ERROR); } private function throwInvalidRecursiveDependency(int $streamId): void { throw new Http2ConnectionException( "Invalid recursive dependency for stream {$streamId}", self::PROTOCOL_ERROR ); } private function throwInvalidPaddingError(): void { throw new Http2ConnectionException("Padding greater than length", self::PROTOCOL_ERROR); } private function throwInvalidZeroStreamIdError(): void { throw new Http2ConnectionException("Invalid zero stream ID", self::PROTOCOL_ERROR); } private function throwInvalidNonZeroStreamIdError(): void { throw new Http2ConnectionException("Invalid non-zero stream ID", self::PROTOCOL_ERROR); } } 'accept', 'accept' => 'accept', 'Accept-Encoding' => 'accept-encoding', 'accept-encoding' => 'accept-encoding', 'Accept-Language' => 'accept-language', 'accept-language' => 'accept-language', 'Connection' => 'connection', 'connection' => 'connection', 'Cookie' => 'cookie', 'cookie' => 'cookie', 'Host' => 'host', 'host' => 'host', 'Sec-Fetch-Dest' => 'sec-fetch-dest', 'sec-fetch-dest' => 'sec-fetch-dest', 'Sec-Fetch-Mode' => 'sec-fetch-mode', 'sec-fetch-mode' => 'sec-fetch-mode', 'Sec-Fetch-Site' => 'sec-fetch-site', 'sec-fetch-site' => 'sec-fetch-site', 'Sec-Fetch-User' => 'sec-fetch-user', 'sec-fetch-user' => 'sec-fetch-user', 'Upgrade-Insecure-Requests' => 'upgrade-insecure-requests', 'upgrade-insecure-requests' => 'upgrade-insecure-requests', 'User-Agent' => 'user-agent', 'user-agent' => 'user-agent', ]; /** @var string[][] */ private $headers = []; /** @var string[][] */ private $headerCase = []; /** * Returns the headers as a string-indexed array of arrays of strings or an empty array if no headers * have been set. * * @return string[][] */ public function getHeaders(): array { return $this->headers; } /** * Returns the headers as list of [field, name] pairs in the original casing provided by the application or server. */ final public function getRawHeaders(): array { $headers = []; foreach ($this->headers as $lcName => $values) { $size = \count($values); for ($i = 0; $i < $size; $i++) { $headers[] = [$this->headerCase[$lcName][$i], $values[$i]]; } } return $headers; } /** * Returns the array of values for the given header or an empty array if the header does not exist. * * @return string[] */ public function getHeaderArray(string $name): array { return $this->headers[self::HEADER_LOWER[$name] ?? \strtolower($name)] ?? []; } /** * Returns the value of the given header. If multiple headers are present for the named header, only the first * header value will be returned. Use getHeaderArray() to return an array of all values for the particular header. * Returns null if the header does not exist. * * @return string|null */ public function getHeader(string $name) { return $this->headers[self::HEADER_LOWER[$name] ?? \strtolower($name)][0] ?? null; } /** * Sets the headers from the given array. * * @param string[]|string[][] $headers */ protected function setHeaders(array $headers) { // Ensure this is an atomic operation, either all headers are set or none. $before = $this->headers; $beforeCase = $this->headerCase; try { foreach ($headers as $name => $value) { $this->setHeader($name, $value); } } catch (\Throwable $e) { $this->headers = $before; $this->headerCase = $beforeCase; throw $e; } } /** * Sets the named header to the given value. * * @param string|string[] $value * * @throws \Error If the header name or value is invalid. */ protected function setHeader(string $name, $value) { \assert($this->isNameValid($name), "Invalid header name"); if (\is_array($value)) { if (!$value) { $this->removeHeader($name); return; } $value = \array_values(\array_map("strval", $value)); } else { $value = [(string) $value]; } \assert($this->isValueValid($value), "Invalid header value"); $lcName = self::HEADER_LOWER[$name] ?? \strtolower($name); $this->headers[$lcName] = $value; $this->headerCase[$lcName] = []; foreach ($value as $_) { $this->headerCase[$lcName][] = $name; } } /** * Adds the value to the named header, or creates the header with the given value if it did not exist. * * @param string|string[] $value * * @throws \Error If the header name or value is invalid. */ protected function addHeader(string $name, $value) { \assert($this->isNameValid($name), "Invalid header name"); if (\is_array($value)) { if (!$value) { return; } $value = \array_values(\array_map("strval", $value)); } else { $value = [(string) $value]; } \assert($this->isValueValid($value), "Invalid header value"); $lcName = self::HEADER_LOWER[$name] ?? \strtolower($name); if (isset($this->headers[$lcName])) { $this->headers[$lcName] = \array_merge($this->headers[$lcName], $value); foreach ($value as $_) { $this->headerCase[$lcName][] = $name; } } else { $this->headers[$lcName] = $value; foreach ($value as $_) { $this->headerCase[$lcName][] = $name; } } } /** * Removes the given header if it exists. */ protected function removeHeader(string $name) { $lcName = self::HEADER_LOWER[$name] ?? \strtolower($name); unset($this->headers[$lcName], $this->headerCase[$lcName]); } /** * Checks if given header exists. */ public function hasHeader(string $name): bool { return isset($this->headers[self::HEADER_LOWER[$name] ?? \strtolower($name)]); } private function isNameValid(string $name): bool { return (bool) \preg_match('/^[A-Za-z0-9`~!#$%^&_|\'\-:]+$/', $name); } /** * Determines if the given value is a valid header value. * * @param string[] $values * * @throws \Error If the given value cannot be converted to a string and is not an array of values that can be * converted to strings. */ private function isValueValid(array $values): bool { foreach ($values as $value) { if (\preg_match("/[^\t\r\n\x20-\x7e\x80-\xfe]|\r\n/", $value)) { return false; } } return true; } } getHeaderArray($headerName)); if ($header === '') { return []; } \preg_match_all('(([^"=,]+)(?:=(?:"((?:[^\\\\"]|\\\\.)*)"|([^,"]*)))?,?\s*)', $header, $matches, \PREG_SET_ORDER); $totalMatchedLength = 0; $pairs = []; foreach ($matches as $match) { $totalMatchedLength += \strlen($match[0]); $key = \trim($match[1]); $value = ($match[2] ?? '') . \trim($match[3] ?? ''); if (($match[2] ?? '') !== '') { // decode escaped characters $value = \preg_replace('(\\\\(.))', '\1', $value); } $pairs[] = [$key, $value]; } if ($totalMatchedLength !== \strlen($header)) { return null; // parse error } return $pairs; } /** * @param array $pairs Output of {@code parseFieldValueComponents}. Keys are handled case-insensitively. * * @return array|null Map of keys to values or {@code null} if incompatible duplicates are found. */ function createFieldValueComponentMap(?array $pairs): ?array { if ($pairs === null) { return null; } $map = []; foreach ($pairs as $pair) { \assert(\count($pair) === 2); \assert(\is_string($pair[0])); \assert(\is_string($pair[1])); } foreach ($pairs as [$key, $value]) { $key = \strtolower($key); if (isset($map[$key]) && $map[$key] !== $value) { return null; // incompatible duplicates } $map[$key] = $value; } return $map; } /** * Format timestamp in seconds as an HTTP date header. * * @param int|null $timestamp Timestamp to format, current time if `null`. * * @return string Formatted date header value. */ function formatDateHeader(?int $timestamp = null): string { static $cachedTimestamp, $cachedFormattedDate; $timestamp = $timestamp ?? \time(); if ($cachedTimestamp === $timestamp) { return $cachedFormattedDate; } return $cachedFormattedDate = \gmdate("D, d M Y H:i:s", $cachedTimestamp = $timestamp) . " GMT"; } @,;:\\\"/[\]?={}\x01-\x20\x7F]++)$)"; public const HEADER_VALUE_REGEX = "(^[ \t]*+((?:[ \t]*+[\x21-\x7E\x80-\xFF]++)*+)[ \t]*+$)"; public const HEADER_REGEX = "(^([^()<>@,;:\\\"/[\]?={}\x01-\x20\x7F]++):[ \t]*+((?:[ \t]*+[\x21-\x7E\x80-\xFF]++)*+)[ \t]*+\r\n)m"; public const HEADER_FOLD_REGEX = "(\r\n[ \t]++)"; /** * Parses headers according to RFC 7230 and 2616. * * Allows empty header values, as HTTP/1.0 allows that. * * @return array Associative array mapping header names to arrays of values. * * @throws InvalidHeaderException If invalid headers have been passed. */ public static function parseHeaders(string $rawHeaders): array { $headers = []; foreach (self::parseRawHeaders($rawHeaders) as $header) { // Unfortunately, we can't avoid the \strtolower() calls due to \array_change_key_case() behavior // when equal headers are present with different casing, e.g. 'set-cookie' and 'Set-Cookie'. // Accessing headers directly instead of using foreach (... as list(...)) is slightly faster. $headers[\strtolower($header[0])][] = $header[1]; } return $headers; } /** * Parses headers according to RFC 7230 and 2616. * * Allows empty header values, as HTTP/1.0 allows that. * * @return array List of [field, value] header pairs. * * @throws InvalidHeaderException If invalid headers have been passed. */ public static function parseRawHeaders(string $rawHeaders): array { // Ensure that the last line also ends with a newline, this is important. \assert(\substr($rawHeaders, -2) === "\r\n", "Argument 1 must end with CRLF: " . \bin2hex($rawHeaders)); /** @var array[] $matches */ $count = \preg_match_all(self::HEADER_REGEX, $rawHeaders, $matches, \PREG_SET_ORDER); // If these aren't the same, then one line didn't match and there's an invalid header. if ($count !== \substr_count($rawHeaders, "\n")) { // Folding is deprecated, see https://tools.ietf.org/html/rfc7230#section-3.2.4 if (\preg_match(self::HEADER_FOLD_REGEX, $rawHeaders)) { throw new InvalidHeaderException("Invalid header syntax: Obsolete line folding"); } throw new InvalidHeaderException("Invalid header syntax"); } $headers = []; foreach ($matches as $match) { // We avoid a call to \trim() here due to the regex. // Accessing matches directly instead of using foreach (... as list(...)) is slightly faster. $headers[] = [$match[1], $match[2]]; } return $headers; } /** * Format headers in to their on-the-wire format. * * Headers are always validated syntactically. This protects against response splitting and header injection * attacks. * * @param array $headers Headers in a format as returned by {@see parseHeaders()}. * * @return string Formatted headers. * * @throws InvalidHeaderException If header names or values are invalid. */ public static function formatHeaders(array $headers): string { $headerList = []; foreach ($headers as $name => $values) { foreach ($values as $value) { // PHP casts integer-like keys to integers $headerList[] = [(string) $name, $value]; } } return self::formatRawHeaders($headerList); } /** * Format headers in to their on-the-wire HTTP/1 format. * * Headers are always validated syntactically. This protects against response splitting and header injection * attacks. * * @param array $headers List of headers in [field, value] format as returned by {@see Message::getRawHeaders()}. * * @return string Formatted headers. * * @throws InvalidHeaderException If header names or values are invalid. */ public static function formatRawHeaders(array $headers): string { $buffer = ""; $lines = 0; foreach ($headers as [$name, $value]) { // Ignore any HTTP/2 pseudo headers if (($name[0] ?? '') === ':') { continue; } $buffer .= "{$name}: {$value}\r\n"; $lines++; } $count = \preg_match_all(self::HEADER_REGEX, $buffer); if ($lines !== $count || $lines !== \substr_count($buffer, "\n")) { throw new InvalidHeaderException("Invalid headers"); } return $buffer; } } { "name": "amphp/socket", "homepage": "https://github.com/amphp/socket", "description": "Async socket connection / server tools for Amp.", "support": { "issues": "https://github.com/amphp/socket/issues" }, "keywords": [ "tcp", "sockets", "tls", "encryption", "async", "non-blocking", "amp" ], "license": "MIT", "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@gmail.com" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "require": { "php": ">=7.1", "ext-openssl": "*", "amphp/amp": "^2", "amphp/dns": "^1 || ^0.9", "amphp/byte-stream": "^1.6", "kelunik/certificate": "^1.1", "league/uri-parser": "^1.4" }, "require-dev": { "phpunit/phpunit": "^6 || ^7 || ^8", "amphp/phpunit-util": "^1", "amphp/php-cs-fixer-config": "dev-master", "vimeo/psalm": "^3.9@dev" }, "autoload": { "psr-4": { "Amp\\Socket\\": "src" }, "files": [ "src/functions.php", "src/Internal/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Socket\\Test\\": "test" } }, "scripts": { "check": [ "@cs", "@test" ], "cs": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff --dry-run", "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix -v --diff", "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit --coverage-text" }, "extra": { "branch-alias": { "dev-master": "1.x-dev" } } } resolver = $resolver; } public function connect(string $uri, ?ConnectContext $context = null, ?CancellationToken $token = null): Promise { $resolver = $this->resolver; return call(static function () use ($uri, $context, $token, $resolver) { $context = $context ?? new ConnectContext; $token = $token ?? new NullCancellationToken; $attempt = 0; $uris = []; $failures = []; [$scheme, $host, $port] = Internal\parseUri($uri); if ($host[0] === '[') { $host = \substr($host, 1, -1); } if ($port === 0 || @\inet_pton($host)) { // Host is already an IP address or file path. $uris = [$uri]; } else { // Host is not an IP address, so resolve the domain name. $records = yield ($resolver ?? Dns\resolver())->resolve($host, $context->getDnsTypeRestriction()); // Usually the faster response should be preferred, but we don't have a reliable way of determining IPv6 // support, so we always prefer IPv4 here. \usort($records, static function (Dns\Record $a, Dns\Record $b) { return $a->getType() - $b->getType(); }); foreach ($records as $record) { /** @var Dns\Record $record */ if ($record->getType() === Dns\Record::AAAA) { $uris[] = \sprintf('%s://[%s]:%d', $scheme, $record->getValue(), $port); } else { $uris[] = \sprintf('%s://%s:%d', $scheme, $record->getValue(), $port); } } } $flags = \STREAM_CLIENT_CONNECT | \STREAM_CLIENT_ASYNC_CONNECT; $timeout = $context->getConnectTimeout(); foreach ($uris as $builtUri) { try { $streamContext = \stream_context_create($context->withoutTlsContext()->toStreamContextArray()); /** @psalm-suppress NullArgument */ if (!$socket = @\stream_socket_client($builtUri, $errno, $errstr, null, $flags, $streamContext)) { throw new ConnectException(\sprintf( 'Connection to %s failed: [Error #%d] %s%s', $uri, $errno, $errstr, $failures ? '; previous attempts: ' . \implode($failures) : '' ), $errno); } \stream_set_blocking($socket, false); $deferred = new Deferred; $watcher = Loop::onWritable($socket, static function () use ($deferred) { $deferred->resolve(); }); $id = $token->subscribe([$deferred, 'fail']); try { yield Promise\timeout($deferred->promise(), $timeout); } catch (TimeoutException $e) { throw new ConnectException(\sprintf( 'Connecting to %s failed: timeout exceeded (%d ms)%s', $uri, $timeout, $failures ? '; previous attempts: ' . \implode($failures) : '' ), 110); // See ETIMEDOUT in http://www.virtsync.com/c-error-codes-include-errno } finally { Loop::cancel($watcher); $token->unsubscribe($id); } // The following hack looks like the only way to detect connection refused errors with PHP's stream sockets. /** @psalm-suppress TypeDoesNotContainType */ if (\stream_socket_get_name($socket, true) === false) { \fclose($socket); throw new ConnectException(\sprintf( 'Connection to %s refused%s', $uri, $failures ? '; previous attempts: ' . \implode($failures) : '' ), 111); // See ECONNREFUSED in http://www.virtsync.com/c-error-codes-include-errno } } catch (ConnectException $e) { // Includes only error codes used in this file, as error codes on other OS families might be different. // In fact, this might show a confusing error message on OS families that return 110 or 111 by itself. $knownReasons = [ 110 => 'connection timeout', 111 => 'connection refused', ]; $code = $e->getCode(); $reason = $knownReasons[$code] ?? ('Error #' . $code); if (++$attempt === $context->getMaxAttempts()) { break; } $failures[] = "{$uri} ({$reason})"; continue; // Could not connect to host, try next host in the list. } return ResourceSocket::fromClientSocket($socket, $context->getTlsContext()); } /** * This is reached if either all URIs failed or the maximum number of attempts is reached. * * @noinspection PhpUndefinedVariableInspection * @psalm-suppress PossiblyUndefinedVariable */ throw $e; }); } } Resolves to an EncryptableSocket instance once a connection is available. * * @throws SocketException * @throws CancelledException */ public function checkout( string $uri, ConnectContext $context = null, CancellationToken $token = null ): Promise; /** * Return a previously checked-out socket to the pool so it can be reused. * * @param EncryptableSocket $socket Socket instance. * * @throws \Error If the provided resource is unknown to the pool. */ public function checkin(EncryptableSocket $socket): void; /** * Remove the specified socket from the pool. * * @param EncryptableSocket $socket Socket instance. * * @throws \Error If the provided resource is unknown to the pool. */ public function clear(EncryptableSocket $socket): void; } certFile = $certFile; $this->keyFile = $keyFile ?? $certFile; } /** * @return string */ public function getCertFile(): string { return $this->certFile; } /** * @return string */ public function getKeyFile(): string { return $this->keyFile; } } = 70400 ? \STREAM_CRYPTO_METHOD_TLSv1_3_SERVER : 0; private const TLS_VERSIONS = \PHP_VERSION_ID >= 70400 ? [ 'TLSv1.0' => self::TLSv1_0, 'TLSv1.1' => self::TLSv1_1, 'TLSv1.2' => self::TLSv1_2, 'TLSv1.3' => self::TLSv1_3, ] : [ 'TLSv1.0' => self::TLSv1_0, 'TLSv1.1' => self::TLSv1_1, 'TLSv1.2' => self::TLSv1_2, ]; /** @var int */ private $minVersion = self::TLSv1_0; /** @var null|string */ private $peerName; /** @var bool */ private $verifyPeer = false; /** @var int */ private $verifyDepth = 10; /** @var null|string */ private $ciphers; /** @var null|string */ private $caFile; /** @var null|string */ private $caPath; /** @var bool */ private $capturePeer = false; /** @var null|Certificate */ private $defaultCertificate; /** @var Certificate[] */ private $certificates = []; /** @var int */ private $securityLevel = 2; /** @var string[] */ private $alpnProtocols = []; /** * Minimum TLS version to negotiate. * * Defaults to TLS 1.0. * * @param int $version One of the `ServerTlsContext::TLSv*` constants. * * @return self Cloned, modified instance. * @throws \Error If an invalid minimum version is given. */ public function withMinimumVersion(int $version): self { if (!\in_array($version, self::TLS_VERSIONS, true)) { throw new \Error(\sprintf( 'Invalid minimum version, only %s allowed', implode(', ', \array_keys(self::TLS_VERSIONS)) )); } $clone = clone $this; $clone->minVersion = $version; return $clone; } /** * Returns the minimum TLS version to negotiate. * * @return int */ public function getMinimumVersion(): int { return $this->minVersion; } /** * Expected name of the peer. * * @param string|null $peerName * * @return self Cloned, modified instance. */ public function withPeerName(string $peerName = null): self { $clone = clone $this; $clone->peerName = $peerName; return $clone; } /** * @return null|string Expected name of the peer or `null` if such an expectation doesn't exist. */ public function getPeerName(): ?string { return $this->peerName; } /** * Enable peer verification. * * @return self Cloned, modified instance. */ public function withPeerVerification(): self { $clone = clone $this; $clone->verifyPeer = true; return $clone; } /** * Disable peer verification, this is the default for servers. * * @return self Cloned, modified instance. */ public function withoutPeerVerification(): self { $clone = clone $this; $clone->verifyPeer = false; return $clone; } /** * @return bool Whether peer verification is enabled. */ public function hasPeerVerification(): bool { return $this->verifyPeer; } /** * Maximum chain length the peer might present including the certificates in the local trust store. * * @param int $verifyDepth Maximum length of the certificate chain. * * @return self Cloned, modified instance. */ public function withVerificationDepth(int $verifyDepth): self { if ($verifyDepth < 0) { throw new \Error("Invalid verification depth ({$verifyDepth}), must be greater than or equal to 0"); } $clone = clone $this; $clone->verifyDepth = $verifyDepth; return $clone; } /** * @return int Maximum length of the certificate chain. */ public function getVerificationDepth(): int { return $this->verifyDepth; } /** * List of ciphers to negotiate, the server's order is always preferred. * * @param string|null $ciphers List of ciphers in OpenSSL's format (colon separated). * * @return self Cloned, modified instance. */ public function withCiphers(string $ciphers = null): self { $clone = clone $this; $clone->ciphers = $ciphers; return $clone; } /** * @return string List of ciphers in OpenSSL's format (colon separated). */ public function getCiphers(): string { return $this->ciphers ?? \OPENSSL_DEFAULT_STREAM_CIPHERS; } /** * CAFile to check for trusted certificates. * * @param string|null $cafile Path to the file or `null` to unset. * * @return self Cloned, modified instance. */ public function withCaFile(string $cafile = null): self { $clone = clone $this; $clone->caFile = $cafile; return $clone; } /** * @return null|string Path to the file if one is set, otherwise `null`. */ public function getCaFile(): ?string { return $this->caFile; } /** * CAPath to check for trusted certificates. * * @param string|null $capath Path to the file or `null` to unset. * * @return self Cloned, modified instance. */ public function withCaPath(string $capath = null): self { $clone = clone $this; $clone->caPath = $capath; return $clone; } /** * @return null|string Path to the file if one is set, otherwise `null`. */ public function getCaPath(): ?string { return $this->caPath; } /** * Capture the certificates sent by the peer. * * Note: This is the chain as sent by the peer, NOT the verified chain. * * @return self Cloned, modified instance. */ public function withPeerCapturing(): self { $clone = clone $this; $clone->capturePeer = true; return $clone; } /** * Don't capture the certificates sent by the peer. * * @return self Cloned, modified instance. */ public function withoutPeerCapturing(): self { $clone = clone $this; $clone->capturePeer = false; return $clone; } /** * @return bool Whether to capture the certificates sent by the peer. */ public function hasPeerCapturing(): bool { return $this->capturePeer; } /** * Default certificate to use in case no SNI certificate matches. * * @param Certificate|null $defaultCertificate * * @return self Cloned, modified instance. */ public function withDefaultCertificate(Certificate $defaultCertificate = null): self { $clone = clone $this; $clone->defaultCertificate = $defaultCertificate; return $clone; } /** * @return Certificate|null Default certificate to use in case no SNI certificate matches, or `null` if unset. */ public function getDefaultCertificate(): ?Certificate { return $this->defaultCertificate; } /** * Certificates to use for the given host names. * * @param array $certificates Must be a associative array mapping hostnames to certificate instances. * * @return self Cloned, modified instance. */ public function withCertificates(array $certificates): self { foreach ($certificates as $key => $certificate) { if (!\is_string($key)) { throw new \TypeError('Expected an array mapping domain names to Certificate instances'); } if (!$certificate instanceof Certificate) { throw new \TypeError('Expected an array of Certificate instances'); } if (\PHP_VERSION_ID < 70200 && $certificate->getCertFile() !== $certificate->getKeyFile()) { throw new \Error( 'Different files for cert and key are not supported on this version of PHP. ' . 'Please upgrade to PHP 7.2 or later.' ); } } $clone = clone $this; $clone->certificates = $certificates; return $clone; } /** * @return array Associative array mapping hostnames to certificate instances. */ public function getCertificates(): array { return $this->certificates; } /** * Security level to use. * * Requires OpenSSL 1.1.0 or higher. * * @param int $level Must be between 0 and 5. * * @return self Cloned, modified instance. */ public function withSecurityLevel(int $level): self { // See https://www.openssl.org/docs/manmaster/man3/SSL_CTX_set_security_level.html // Level 2 is not recommended, because of SHA-1 by that document, // but SHA-1 should be phased out now on general internet use. // We therefore default to level 2. if ($level < 0 || $level > 5) { throw new \Error("Invalid security level ({$level}), must be between 0 and 5."); } if (!hasTlsSecurityLevelSupport()) { throw new \Error("Can't set a security level, as PHP is compiled with OpenSSL < 1.1.0."); } $clone = clone $this; $clone->securityLevel = $level; return $clone; } /** * @return int Security level between 0 and 5. Always 0 for OpenSSL < 1.1.0. */ public function getSecurityLevel(): int { // 0 is equivalent to previous versions of OpenSSL and just does nothing if (!hasTlsSecurityLevelSupport()) { return 0; } return $this->securityLevel; } /** * @param string[] $protocols * * @return self Cloned, modified instance. */ public function withApplicationLayerProtocols(array $protocols): self { if (!hasTlsAlpnSupport()) { throw new \Error("Can't set an application layer protocol list, as PHP is compiled with OpenSSL < 1.0.2."); } foreach ($protocols as $protocol) { if (!\is_string($protocol)) { throw new \TypeError("Protocol names must be strings"); } } $clone = clone $this; $clone->alpnProtocols = $protocols; return $clone; } /** * @return string[] */ public function getApplicationLayerProtocols(): array { return $this->alpnProtocols; } /** * Converts this TLS context into PHP's equivalent stream context array. * * @return array Stream context array compatible with PHP's streams. */ public function toStreamContextArray(): array { $options = [ 'crypto_method' => $this->toStreamCryptoMethod(), 'peer_name' => $this->peerName, 'verify_peer' => $this->verifyPeer, 'verify_peer_name' => $this->verifyPeer, 'verify_depth' => $this->verifyDepth, 'ciphers' => $this->ciphers ?? \OPENSSL_DEFAULT_STREAM_CIPHERS, 'honor_cipher_order' => true, 'single_dh_use' => true, 'no_ticket' => true, 'capture_peer_cert' => $this->capturePeer, 'capture_peer_chain' => $this->capturePeer, ]; if (!empty($this->alpnProtocols)) { $options['alpn_protocols'] = \implode(',', $this->alpnProtocols); } if ($this->defaultCertificate !== null) { $options['local_cert'] = $this->defaultCertificate->getCertFile(); if ($this->defaultCertificate->getCertFile() !== $this->defaultCertificate->getKeyFile()) { $options['local_pk'] = $this->defaultCertificate->getKeyFile(); } } if ($this->certificates) { $options['SNI_server_certs'] = \array_map(static function (Certificate $certificate) { if ($certificate->getCertFile() === $certificate->getKeyFile()) { return $certificate->getCertFile(); } return [ 'local_cert' => $certificate->getCertFile(), 'local_pk' => $certificate->getKeyFile(), ]; }, $this->certificates); } if ($this->caFile !== null) { $options['cafile'] = $this->caFile; } if ($this->caPath !== null) { $options['capath'] = $this->caPath; } if (\OPENSSL_VERSION_NUMBER >= 0x10100000) { $options['security_level'] = $this->securityLevel; } return ['ssl' => $options]; } /** * @return int Crypto method compatible with PHP's streams. */ public function toStreamCryptoMethod(): int { switch ($this->minVersion) { case self::TLSv1_0: return self::TLSv1_0 | self::TLSv1_1 | self::TLSv1_2 | self::TLSv1_3; case self::TLSv1_1: return self::TLSv1_1 | self::TLSv1_2 | self::TLSv1_3; case self::TLSv1_2: return self::TLSv1_2 | self::TLSv1_3; case self::TLSv1_3: return self::TLSv1_3; default: throw new \RuntimeException('Unknown minimum TLS version: ' . $this->minVersion); } } } 65535)) { throw new \Error('Port number must be null or an integer between 1 and 65535'); } if (\strrpos($host, ':')) { $host = \trim($host, '[]'); } $this->host = $host; $this->port = $port; } /** * @return string */ public function getHost(): string { return $this->host; } /** * @return int */ public function getPort(): ?int { return $this->port; } /** * @return string host:port formatted string. */ public function toString(): string { $host = $this->host; if (\strrpos($host, ':')) { $host = '[' . $host . ']'; } if ($this->port === null) { return $host; } return $host . ':' . $this->port; } /** * @see toString * * @return string */ public function __toString(): string { return $this->toString(); } } toStreamContextArray()); // Error reporting suppressed since stream_socket_server() emits an E_WARNING on failure (checked below). $server = @\stream_socket_server($uri, $errno, $errstr, STREAM_SERVER_BIND, $streamContext); if (!$server || $errno) { throw new SocketException( \sprintf('Could not create datagram %s: [Error: #%d] %s', $uri, $errno, $errstr), $errno ); } return new self($server, $context->getChunkSize()); } /** @var resource|null UDP socket resource. */ private $socket; /** @var string Watcher ID. */ private $watcher; /** @var SocketAddress */ private $address; /** @var Deferred|null */ private $reader; /** @var int */ private $chunkSize; /** * @param resource $socket A bound udp socket resource * @param int $chunkSize Maximum chunk size for the * * @throws \Error If a stream resource is not given for $socket. */ public function __construct($socket, int $chunkSize = self::DEFAULT_CHUNK_SIZE) { if (!\is_resource($socket) || \get_resource_type($socket) !== 'stream') { throw new \Error('Invalid resource given to constructor!'); } $this->socket = $socket; $this->address = SocketAddress::fromLocalResource($socket); $this->chunkSize = &$chunkSize; \stream_set_blocking($this->socket, false); $reader = &$this->reader; $this->watcher = Loop::onReadable($this->socket, static function ($watcher, $socket) use ( &$reader, &$chunkSize ) { $deferred = $reader; $reader = null; \assert($deferred !== null); $data = @\stream_socket_recvfrom($socket, $chunkSize, 0, $address); /** @psalm-suppress TypeDoesNotContainType */ if ($data === false) { Loop::cancel($watcher); $deferred->resolve(); return; } $deferred->resolve([SocketAddress::fromSocketName($address), $data]); /** @psalm-suppress RedundantCondition Resolution of the deferred above might read immediately again */ if (!$reader) { Loop::disable($watcher); } }); Loop::disable($this->watcher); } /** * Automatically cancels the loop watcher. */ public function __destruct() { if (!$this->socket) { return; } $this->free(); } /** * @return Promise Resolves with null if the socket is closed. * * @throws PendingReceiveError If a receive request is already pending. */ public function receive(): Promise { if ($this->reader) { throw new PendingReceiveError; } if (!$this->socket) { return new Success; // Resolve with null when endpoint is closed. } $this->reader = new Deferred; Loop::enable($this->watcher); return $this->reader->promise(); } /** * @param SocketAddress $address * @param string $data * * @return Promise Resolves with the number of bytes written to the socket. * * @throws SocketException If the UDP socket closes before the data can be sent. */ public function send(SocketAddress $address, string $data): Promise { if (!$this->socket) { return new Failure(new SocketException('The endpoint is not writable')); } try { try { \set_error_handler(static function (int $errno, string $errstr) { throw new SocketException(\sprintf('Could not send packet on endpoint: %s', $errstr)); }); $result = \stream_socket_sendto($this->socket, $data, 0, $address->toString()); /** @psalm-suppress TypeDoesNotContainType */ if ($result < 0 || $result === false) { throw new SocketException('Could not send packet on endpoint: Unknown error'); } } finally { \restore_error_handler(); } } catch (SocketException $e) { return new Failure($e); } return new Success($result); } /** * Raw stream socket resource. * * @return resource|null */ final public function getResource() { return $this->socket; } /** * References the receive watcher. * * @see Loop::reference() */ final public function reference(): void { Loop::reference($this->watcher); } /** * Unreferences the receive watcher. * * @see Loop::unreference() */ final public function unreference(): void { Loop::unreference($this->watcher); } /** * Closes the datagram socket and stops receiving data. Any pending read is resolved with null. */ public function close(): void { if ($this->socket) { /** @psalm-suppress InvalidPropertyAssignmentValue */ \fclose($this->socket); } $this->free(); } /** * @return bool */ public function isClosed(): bool { return $this->socket === null; } /** * @return SocketAddress */ public function getAddress(): SocketAddress { return $this->address; } /** * @param int $chunkSize The new maximum packet size to receive. */ public function setChunkSize(int $chunkSize): void { $this->chunkSize = $chunkSize; } private function free(): void { Loop::cancel($this->watcher); $this->socket = null; if ($this->reader) { $this->reader->resolve(); $this->reader = null; } } } withBindTo(null); } public function withBindTo(?string $bindTo): self { $bindTo = normalizeBindToOption($bindTo); $clone = clone $this; $clone->bindTo = $bindTo; return $clone; } public function getBindTo(): ?string { return $this->bindTo; } public function getBacklog(): int { return $this->backlog; } public function withBacklog(int $backlog): self { $clone = clone $this; $clone->backlog = $backlog; return $clone; } public function hasReusePort(): bool { return $this->reusePort; } public function withReusePort(): self { $clone = clone $this; $clone->reusePort = true; return $clone; } public function withoutReusePort(): self { $clone = clone $this; $clone->reusePort = false; return $clone; } public function hasBroadcast(): bool { return $this->broadcast; } public function withBroadcast(): self { $clone = clone $this; $clone->broadcast = true; return $clone; } public function withoutBroadcast(): self { $clone = clone $this; $clone->broadcast = false; return $clone; } public function hasTcpNoDelay(): bool { return $this->tcpNoDelay; } public function withTcpNoDelay(): self { $clone = clone $this; $clone->tcpNoDelay = true; return $clone; } public function withoutTcpNoDelay(): self { $clone = clone $this; $clone->tcpNoDelay = false; return $clone; } public function getTlsContext(): ?ServerTlsContext { return $this->tlsContext; } public function withoutTlsContext(): self { return $this->withTlsContext(null); } public function withTlsContext(?ServerTlsContext $tlsContext): self { $clone = clone $this; $clone->tlsContext = $tlsContext; return $clone; } public function getChunkSize(): int { return $this->chunkSize; } public function withChunkSize(int $chunkSize): self { $clone = clone $this; $clone->chunkSize = $chunkSize; return $clone; } public function toStreamContextArray(): array { $array = ['socket' => [ 'bindto' => $this->bindTo, 'backlog' => $this->backlog, 'ipv6_v6only' => true, // SO_REUSEADDR has SO_REUSEPORT semantics on Windows 'so_reuseaddr' => $this->reusePort && \stripos(\PHP_OS, 'WIN') === 0, 'so_reuseport' => $this->reusePort, 'so_broadcast' => $this->broadcast, 'tcp_nodelay' => $this->tcpNoDelay, ]]; if ($this->tlsContext) { $array = \array_merge($array, $this->tlsContext->toStreamContextArray()); } return $array; } } * * @internal */ function setupTls($socket, array $options, ?CancellationToken $cancellationToken): Promise { $cancellationToken = $cancellationToken ?? new NullCancellationToken; if (isset(\stream_get_meta_data($socket)['crypto'])) { return new Failure(new TlsException("Can't setup TLS, because it has already been set up")); } \error_clear_last(); \stream_context_set_option($socket, $options); try { \set_error_handler(static function (int $errno, string $errstr) { new TlsException('TLS negotiation failed: ' . $errstr); }); $result = \stream_socket_enable_crypto($socket, $enable = true); if ($result === false) { throw new TlsException('TLS negotiation failed: Unknown error'); } } catch (TlsException $e) { return new Failure($e); } finally { \restore_error_handler(); } // Yes, that function can return true / false / 0, don't use weak comparisons. if ($result === true) { /** @psalm-suppress InvalidReturnStatement */ return new Success; } return call(static function () use ($socket, $cancellationToken) { $cancellationToken->throwIfRequested(); $deferred = new Deferred; // Watcher is guaranteed to be created, because we throw above if cancellation has already been requested $id = $cancellationToken->subscribe(static function ($e) use ($deferred, &$watcher) { Loop::cancel($watcher); $deferred->fail($e); }); $watcher = Loop::onReadable($socket, static function (string $watcher, $socket, Deferred $deferred) use ( $cancellationToken, $id ) { try { try { \set_error_handler(static function (int $errno, string $errstr) use ($socket) { if (\feof($socket)) { $errstr = 'Connection reset by peer'; } throw new TlsException('TLS negotiation failed: ' . $errstr); }); $result = \stream_socket_enable_crypto($socket, true); if ($result === false) { $message = \feof($socket) ? 'Connection reset by peer' : 'Unknown error'; throw new TlsException('TLS negotiation failed: ' . $message); } } finally { \restore_error_handler(); } } catch (TlsException $e) { Loop::cancel($watcher); $cancellationToken->unsubscribe($id); $deferred->fail($e); return; } // If $result is 0, just wait for the next invocation if ($result === true) { Loop::cancel($watcher); $cancellationToken->unsubscribe($id); $deferred->resolve(); } }, $deferred); return $deferred->promise(); }); } /** * Disable encryption on an existing socket stream. * * @param resource $socket * * @return Promise * * @internal * @psalm-suppress InvalidReturnType */ function shutdownTls($socket): Promise { // note that disabling crypto *ALWAYS* returns false, immediately // don't set _enabled to false, TLS can be setup only once @\stream_socket_enable_crypto($socket, false); /** @psalm-suppress InvalidReturnStatement */ return new Success; } /** * Normalizes "bindto" options to add a ":0" in case no port is present, otherwise PHP will silently ignore those. * * @param string|null $bindTo * * @return string|null * * @throws \Error If an invalid option has been passed. */ function normalizeBindToOption(string $bindTo = null) { if ($bindTo === null) { return null; } if (\preg_match("/\\[(?P[0-9a-f:]+)\\](:(?P\\d+))?$/", $bindTo, $match)) { $ip = $match['ip']; $port = $match['port'] ?? 0; if (@\inet_pton($ip) === false) { throw new \Error("Invalid IPv6 address: {$ip}"); } if ($port < 0 || $port > 65535) { throw new \Error("Invalid port: {$port}"); } return "[{$ip}]:{$port}"; } if (\preg_match("/(?P\\d+\\.\\d+\\.\\d+\\.\\d+)(:(?P\\d+))?$/", $bindTo, $match)) { $ip = $match['ip']; $port = $match['port'] ?? 0; if (@\inet_pton($ip) === false) { throw new \Error("Invalid IPv4 address: {$ip}"); } if ($port < 0 || $port > 65535) { throw new \Error("Invalid port: {$port}"); } return "{$ip}:{$port}"; } throw new \Error("Invalid bindTo value: {$bindTo}"); } /** * Cleans up return values of stream_socket_get_name. * * @param string|false $address * * @return string|null */ function cleanupSocketName($address) { // https://3v4l.org/5C1lo if ($address === false || $address === "\0") { return null; } // Check if this is an IPv6 address which includes multiple colons but no square brackets // @see https://github.com/reactphp/socket/blob/v0.8.10/src/TcpServer.php#L179-L184 // @license https://github.com/reactphp/socket/blob/v0.8.10/LICENSE $pos = \strrpos($address, ':'); if ($pos !== false && \strpos($address, ':') < $pos && $address[0] !== '[') { $port = \substr($address, $pos + 1); $address = '[' . \substr($address, 0, $pos) . ']:' . $port; } // -- End of imported code ----- // return $address; } getResource())["crypto"]`. * @param array $tlsContext Context obtained via `stream_context_get_options($socket->getResource())["ssl"])`. * * @return self */ public static function fromMetaData(array $cryptoInfo, array $tlsContext): self { if (isset($tlsContext["peer_certificate"])) { $certificates = \array_merge([$tlsContext["peer_certificate"]], $tlsContext["peer_certificate_chain"] ?? []); } else { $certificates = $tlsContext["peer_certificate_chain"] ?? []; } return new self( $cryptoInfo["protocol"], $cryptoInfo["cipher_name"], $cryptoInfo["cipher_bits"], $cryptoInfo["cipher_version"], $cryptoInfo["alpn_protocol"] ?? null, empty($certificates) ? null : $certificates ); } private function __construct(string $version, string $cipherName, int $cipherBits, string $cipherVersion, ?string $alpnProtocol, ?array $certificates) { $this->version = $version; $this->cipherName = $cipherName; $this->cipherBits = $cipherBits; $this->cipherVersion = $cipherVersion; $this->alpnProtocol = $alpnProtocol; $this->certificates = $certificates; } public function getVersion(): string { return $this->version; } public function getCipherName(): string { return $this->cipherName; } public function getCipherBits(): int { return $this->cipherBits; } public function getCipherVersion(): string { return $this->cipherVersion; } public function getApplicationLayerProtocol(): ?string { return $this->alpnProtocol; } /** * @return Certificate[] * * @throws SocketException If peer certificates were not captured. */ public function getPeerCertificates(): array { if ($this->certificates === null) { throw new SocketException("Peer certificates not captured; use ClientTlsContext::withPeerCapturing() to capture peer certificates"); } if ($this->parsedCertificates === null) { $this->parsedCertificates = \array_map(static function ($resource) { return new Certificate($resource); }, $this->certificates); } return $this->parsedCertificates; } } setupTls()` after accepting new clients. * * @param string $uri URI in scheme://host:port format. TCP is assumed if no scheme is present. * @param BindContext|null $context Context options for listening. * * @return Server * * @throws SocketException If binding to the specified URI failed. * @throws \Error If an invalid scheme is given. * @see Server::listen() * * @deprecated Use Server::listen() instead. */ function listen(string $uri, ?BindContext $context = null): Server { return Server::listen($uri, $context); } /** * Set or access the global socket Connector instance. * * @param Connector|null $connector * * @return Connector */ function connector(Connector $connector = null): Connector { if ($connector === null) { if ($connector = Loop::getState(LOOP_CONNECTOR_IDENTIFIER)) { return $connector; } $connector = new DnsConnector; } Loop::setState(LOOP_CONNECTOR_IDENTIFIER, $connector); return $connector; } /** * Asynchronously establish a socket connection to the specified URI. * * @param string $uri URI in scheme://host:port format. TCP is assumed if no scheme is present. * @param ConnectContext $context Socket connect context to use when connecting. * @param CancellationToken|null $token * * @return Promise * * @throws ConnectException * @throws CancelledException */ function connect(string $uri, ConnectContext $context = null, CancellationToken $token = null): Promise { return connector()->connect($uri, $context, $token); } /** * Returns a pair of connected stream socket resources. * * @return ResourceSocket[] Pair of socket resources. * * @throws SocketException If creating the sockets fails. */ function createPair(): array { try { \set_error_handler(static function (int $errno, string $errstr) { throw new SocketException(\sprintf('Failed to create socket pair. Errno: %d; %s', $errno, $errstr)); }); $sockets = \stream_socket_pair(\stripos(PHP_OS, 'win') === 0 ? STREAM_PF_INET : STREAM_PF_UNIX, STREAM_SOCK_STREAM, STREAM_IPPROTO_IP); if ($sockets === false) { throw new SocketException('Failed to create socket pair.'); } } finally { \restore_error_handler(); } return [ResourceSocket::fromClientSocket($sockets[0]), ResourceSocket::fromClientSocket($sockets[1])]; } /** * @see https://wiki.openssl.org/index.php/Manual:OPENSSL_VERSION_NUMBER(3) * @return bool */ function hasTlsAlpnSupport(): bool { return \defined('OPENSSL_VERSION_NUMBER') && \OPENSSL_VERSION_NUMBER >= 0x10002000; } function hasTlsSecurityLevelSupport(): bool { return \defined('OPENSSL_VERSION_NUMBER') && \OPENSSL_VERSION_NUMBER >= 0x10100000; } * * @throws ConnectException * @throws CancelledException */ public function connect( string $uri, ?ConnectContext $context = null, ?CancellationToken $token = null ): Promise; } Resolved when TLS is successfully set up on the socket. * * @throws SocketException Promise fails and the socket is closed if setting up TLS fails. */ public function setupTls(?CancellationToken $cancellationToken = null): Promise; /** * @param CancellationToken|null $cancellationToken * * @return Promise Resolved when TLS is successfully shutdown. * * @throws SocketException Promise fails and the socket is closed if shutting down TLS fails. */ public function shutdownTls(?CancellationToken $cancellationToken = null): Promise; /** * @return int One of the TLS_STATE_* constants defined in this interface. */ public function getTlsState(): int; /** * @return TlsInfo|null The TLS (crypto) context info if TLS is enabled on the socket or null otherwise. */ public function getTlsInfo(): ?TlsInfo; } uri = $uri; $this->connector = $connector; } public function connect(string $uri, ?ConnectContext $context = null, ?CancellationToken $token = null): Promise { return $this->connector->connect($this->uri, $context, $token); } } = 70400 ? \STREAM_CRYPTO_METHOD_TLSv1_3_CLIENT : 0; private const TLS_VERSIONS = \PHP_VERSION_ID >= 70400 ? [ 'TLSv1.0' => self::TLSv1_0, 'TLSv1.1' => self::TLSv1_1, 'TLSv1.2' => self::TLSv1_2, 'TLSv1.3' => self::TLSv1_3, ] : [ 'TLSv1.0' => self::TLSv1_0, 'TLSv1.1' => self::TLSv1_1, 'TLSv1.2' => self::TLSv1_2, ]; /** @var int */ private $minVersion = self::TLSv1_0; /** @var string|null */ private $peerName; /** @var bool */ private $verifyPeer = true; /** @var int */ private $verifyDepth = 10; /** @var string|null */ private $ciphers; /** @var string|null */ private $caFile; /** @var string|null */ private $caPath; /** @var bool */ private $capturePeer = false; /** @var bool */ private $sniEnabled = true; /** @var int */ private $securityLevel = 2; /** @var Certificate|null */ private $certificate; /** @var string[] */ private $alpnProtocols = []; public function __construct(string $peerName) { $this->peerName = $peerName; } /** * Minimum TLS version to negotiate. * * Defaults to TLS 1.0. * * @param int $version One of the `ClientTlsContext::TLSv*` constants. * * @return self Cloned, modified instance. * @throws \Error If an invalid minimum version is given. */ public function withMinimumVersion(int $version): self { if (!\in_array($version, self::TLS_VERSIONS, true)) { throw new \Error(\sprintf( 'Invalid minimum version, only %s allowed', implode(', ', \array_keys(self::TLS_VERSIONS)) )); } $clone = clone $this; $clone->minVersion = $version; return $clone; } /** * Returns the minimum TLS version to negotiate. * * @return int */ public function getMinimumVersion(): int { return $this->minVersion; } /** * Expected name of the peer. * * @param string $peerName * * @return self Cloned, modified instance. */ public function withPeerName(string $peerName): self { $clone = clone $this; $clone->peerName = $peerName; return $clone; } /** * @return null|string Expected name of the peer or `null` if such an expectation doesn't exist. */ public function getPeerName(): ?string { return $this->peerName; } /** * Enable peer verification. * * @return self Cloned, modified instance. */ public function withPeerVerification(): self { $clone = clone $this; $clone->verifyPeer = true; return $clone; } /** * Disable peer verification, this is the default for servers. * * Warning: You usually shouldn't disable this setting for clients, because it allows active MitM attackers to * intercept the communication and change it without anyone noticing. * * @return self Cloned, modified instance. */ public function withoutPeerVerification(): self { $clone = clone $this; $clone->verifyPeer = false; return $clone; } /** * @return bool Whether peer verification is enabled. */ public function hasPeerVerification(): bool { return $this->verifyPeer; } /** * Maximum chain length the peer might present including the certificates in the local trust store. * * @param int $verifyDepth Maximum length of the certificate chain. * * @return self Cloned, modified instance. */ public function withVerificationDepth(int $verifyDepth): self { if ($verifyDepth < 0) { throw new \Error("Invalid verification depth ({$verifyDepth}), must be greater than or equal to 0"); } $clone = clone $this; $clone->verifyDepth = $verifyDepth; return $clone; } /** * @return int Maximum length of the certificate chain. */ public function getVerificationDepth(): int { return $this->verifyDepth; } /** * List of ciphers to negotiate, the server's order is always preferred. * * @param string|null $ciphers List of ciphers in OpenSSL's format (colon separated). * * @return self Cloned, modified instance. */ public function withCiphers(string $ciphers = null): self { $clone = clone $this; $clone->ciphers = $ciphers; return $clone; } /** * @return string List of ciphers in OpenSSL's format (colon separated). */ public function getCiphers(): string { return $this->ciphers ?? \OPENSSL_DEFAULT_STREAM_CIPHERS; } /** * CAFile to check for trusted certificates. * * @param string|null $cafile Path to the file or `null` to unset. * * @return self Cloned, modified instance. */ public function withCaFile(string $cafile = null): self { $clone = clone $this; $clone->caFile = $cafile; return $clone; } /** * @return null|string Path to the file if one is set, otherwise `null`. */ public function getCaFile(): ?string { return $this->caFile; } /** * CAPath to check for trusted certificates. * * @param string|null $capath Path to the file or `null` to unset. * * @return self Cloned, modified instance. */ public function withCaPath(string $capath = null): self { $clone = clone $this; $clone->caPath = $capath; return $clone; } /** * @return null|string Path to the file if one is set, otherwise `null`. */ public function getCaPath(): ?string { return $this->caPath; } /** * Capture the certificates sent by the peer. * * Note: This is the chain as sent by the peer, NOT the verified chain. * * @return self Cloned, modified instance. */ public function withPeerCapturing(): self { $clone = clone $this; $clone->capturePeer = true; return $clone; } /** * Don't capture the certificates sent by the peer. * * @return self Cloned, modified instance. */ public function withoutPeerCapturing(): self { $clone = clone $this; $clone->capturePeer = false; return $clone; } /** * @return bool Whether to capture the certificates sent by the peer. */ public function hasPeerCapturing(): bool { return $this->capturePeer; } /** * Enable SNI. * * @return self Cloned, modified instance. */ public function withSni(): self { $clone = clone $this; $clone->sniEnabled = true; return $clone; } /** * Disable SNI. * * @return self Cloned, modified instance. */ public function withoutSni(): self { $clone = clone $this; $clone->sniEnabled = false; return $clone; } /** * @return bool Whether SNI is enabled or not. */ public function hasSni(): bool { return $this->sniEnabled; } /** * Security level to use. * * Requires OpenSSL 1.1.0 or higher. * * @param int $level Must be between 0 and 5. * * @return self Cloned, modified instance. */ public function withSecurityLevel(int $level): self { // See https://www.openssl.org/docs/manmaster/man3/SSL_CTX_set_security_level.html // Level 2 is not recommended, because of SHA-1 by that document, // but SHA-1 should be phased out now on general internet use. // We therefore default to level 2. if ($level < 0 || $level > 5) { throw new \Error("Invalid security level ({$level}), must be between 0 and 5."); } if (!hasTlsSecurityLevelSupport()) { throw new \Error("Can't set a security level, as PHP is compiled with OpenSSL < 1.1.0."); } $clone = clone $this; $clone->securityLevel = $level; return $clone; } /** * @return int Security level between 0 and 5. Always 0 for OpenSSL < 1.1.0. */ public function getSecurityLevel(): int { // 0 is equivalent to previous versions of OpenSSL and just does nothing if (!hasTlsSecurityLevelSupport()) { return 0; } return $this->securityLevel; } /** * Client certificate to use, if key is no present it assumes it is present in the same file as the certificate. * * @param Certificate $certificate Certificate and private key info * * @return self Cloned, modified instance. */ public function withCertificate(Certificate $certificate = null): self { $clone = clone $this; $clone->certificate = $certificate; return $clone; } public function getCertificate(): ?Certificate { return $this->certificate; } /** * @param string[] $protocols * * @return self Cloned, modified instance. */ public function withApplicationLayerProtocols(array $protocols): self { if (!hasTlsAlpnSupport()) { throw new \Error("Can't set an application layer protocol list, as PHP is compiled with OpenSSL < 1.0.2."); } foreach ($protocols as $protocol) { if (!\is_string($protocol)) { throw new \TypeError("Protocol names must be strings"); } } $clone = clone $this; $clone->alpnProtocols = $protocols; return $clone; } /** * @return string[] */ public function getApplicationLayerProtocols(): array { return $this->alpnProtocols; } /** * Converts this TLS context into PHP's equivalent stream context array. * * @return array Stream context array compatible with PHP's streams. */ public function toStreamContextArray(): array { $options = [ 'crypto_method' => $this->toStreamCryptoMethod(), 'peer_name' => $this->peerName, 'verify_peer' => $this->verifyPeer, 'verify_peer_name' => $this->verifyPeer, 'verify_depth' => $this->verifyDepth, 'ciphers' => $this->ciphers ?? \OPENSSL_DEFAULT_STREAM_CIPHERS, 'capture_peer_cert' => $this->capturePeer, 'capture_peer_cert_chain' => $this->capturePeer, 'SNI_enabled' => $this->sniEnabled, ]; if ($this->certificate !== null) { $options['local_cert'] = $this->certificate->getCertFile(); if ($this->certificate->getCertFile() !== $this->certificate->getKeyFile()) { $options['local_pk'] = $this->certificate->getKeyFile(); } } if ($this->caFile !== null) { $options['cafile'] = $this->caFile; } if ($this->caPath !== null) { $options['capath'] = $this->caPath; } if (hasTlsSecurityLevelSupport()) { $options['security_level'] = $this->securityLevel; } if (!empty($this->alpnProtocols)) { $options['alpn_protocols'] = \implode(',', $this->alpnProtocols); } return ['ssl' => $options]; } /** * @return int Crypto method compatible with PHP's streams. */ public function toStreamCryptoMethod(): int { switch ($this->minVersion) { case self::TLSv1_0: return self::TLSv1_0 | self::TLSv1_1 | self::TLSv1_2 | self::TLSv1_3; case self::TLSv1_1: return self::TLSv1_1 | self::TLSv1_2 | self::TLSv1_3; case self::TLSv1_2: return self::TLSv1_2 | self::TLSv1_3; case self::TLSv1_3: return self::TLSv1_3; default: throw new \RuntimeException('Unknown minimum TLS version: ' . $this->minVersion); } } } withBindTo(null); } public function withBindTo(?string $bindTo): self { $bindTo = normalizeBindToOption($bindTo); $clone = clone $this; $clone->bindTo = $bindTo; return $clone; } public function getBindTo(): ?string { return $this->bindTo; } public function withConnectTimeout(int $timeout): self { if ($timeout <= 0) { throw new \Error("Invalid connect timeout ({$timeout}), must be greater than 0"); } $clone = clone $this; $clone->connectTimeout = $timeout; return $clone; } public function getConnectTimeout(): int { return $this->connectTimeout; } public function withMaxAttempts(int $maxAttempts): self { if ($maxAttempts <= 0) { throw new \Error("Invalid max attempts ({$maxAttempts}), must be greater than 0"); } $clone = clone $this; $clone->maxAttempts = $maxAttempts; return $clone; } public function getMaxAttempts(): int { return $this->maxAttempts; } public function withoutDnsTypeRestriction(): self { return $this->withDnsTypeRestriction(null); } public function withDnsTypeRestriction(?int $type): self { if ($type !== null && $type !== Record::AAAA && $type !== Record::A) { throw new \Error('Invalid resolver type restriction'); } $clone = clone $this; $clone->typeRestriction = $type; return $clone; } public function getDnsTypeRestriction(): ?int { return $this->typeRestriction; } public function hasTcpNoDelay(): bool { return $this->tcpNoDelay; } public function withTcpNoDelay(): self { $clone = clone $this; $clone->tcpNoDelay = true; return $clone; } public function withoutTcpNoDelay(): self { $clone = clone $this; $clone->tcpNoDelay = false; return $clone; } public function withoutTlsContext(): self { return $this->withTlsContext(null); } public function withTlsContext(?ClientTlsContext $tlsContext): self { $clone = clone $this; $clone->tlsContext = $tlsContext; return $clone; } public function getTlsContext(): ?ClientTlsContext { return $this->tlsContext; } public function toStreamContextArray(): array { $options = [ 'tcp_nodelay' => $this->tcpNoDelay, ]; if ($this->bindTo !== null) { $options['bindto'] = $this->bindTo; } $array = ['socket' => $options]; if ($this->tlsContext) { $array = \array_merge($array, $this->tlsContext->toStreamContextArray()); } return $array; } } null, 'unix' => null, ]; /** @var object[][] */ private $sockets = []; /** @var string[] */ private $objectIdCacheKeyMap = []; /** @var int[] */ private $pendingCount = []; /** @var int */ private $idleTimeout; /** @var Connector */ private $connector; public function __construct(int $idleTimeout = 10000, ?Connector $connector = null) { $this->idleTimeout = $idleTimeout; $this->connector = $connector ?? connector(); } /** @inheritdoc */ public function checkout( string $uri, ConnectContext $context = null, CancellationToken $token = null ): Promise { // A request might already be cancelled before we reach the checkout, so do not even attempt to checkout in that // case. The weird logic is required to throw the token's exception instead of creating a new one. if ($token && $token->isRequested()) { try { $token->throwIfRequested(); } catch (CancelledException $e) { return new Failure($e); } } [$uri, $fragment] = $this->normalizeUri($uri); $cacheKey = $uri; if ($context && ($tlsContext = $context->getTlsContext())) { $cacheKey .= ' + ' . \serialize($tlsContext->toStreamContextArray()); } if ($fragment !== null) { $cacheKey .= ' # ' . $fragment; } if (empty($this->sockets[$cacheKey])) { return $this->checkoutNewSocket($uri, $cacheKey, $context, $token); } foreach ($this->sockets[$cacheKey] as $socketId => $socket) { if (!$socket->isAvailable) { continue; } if ($socket->object instanceof ResourceSocket) { $resource = $socket->object->getResource(); if (!$resource || !\is_resource($resource) || \feof($resource)) { $this->clearFromId(\spl_object_hash($socket->object)); continue; } } elseif ($socket->object->isClosed()) { $this->clearFromId(\spl_object_hash($socket->object)); continue; } $socket->isAvailable = false; if ($socket->idleWatcher !== null) { Loop::disable($socket->idleWatcher); } return new Success($socket->object); } return $this->checkoutNewSocket($uri, $cacheKey, $context, $token); } /** @inheritdoc */ public function clear(EncryptableSocket $socket): void { $this->clearFromId(\spl_object_hash($socket)); } /** @inheritdoc */ public function checkin(EncryptableSocket $socket): void { $objectId = \spl_object_hash($socket); if (!isset($this->objectIdCacheKeyMap[$objectId])) { throw new \Error( \sprintf('Unknown socket: %d', $objectId) ); } $cacheKey = $this->objectIdCacheKeyMap[$objectId]; if ($socket instanceof ResourceSocket) { $resource = $socket->getResource(); if (!$resource || !\is_resource($resource) || \feof($resource)) { $this->clearFromId(\spl_object_hash($socket)); return; } } elseif ($socket->isClosed()) { $this->clearFromId(\spl_object_hash($socket)); return; } $socket = $this->sockets[$cacheKey][$objectId]; $socket->isAvailable = true; if (isset($socket->idleWatcher)) { Loop::enable($socket->idleWatcher); } else { $socket->idleWatcher = Loop::delay($this->idleTimeout, function () use ($socket) { $this->clearFromId(\spl_object_hash($socket->object)); }); Loop::unreference($socket->idleWatcher); } } /** * @param string $uri * * @return array * * @throws SocketException */ private function normalizeUri(string $uri): array { if (\stripos($uri, 'unix://') === 0) { return \explode('#', $uri) + [null, null]; } try { $parts = Uri\parse($uri); } catch (\Exception $exception) { throw new SocketException('Could not parse URI', 0, $exception); } if ($parts['scheme'] === null) { throw new SocketException('Invalid URI for socket pool; no scheme given'); } $port = $parts['port'] ?? 0; if ($port === 0 || $parts['host'] === null) { throw new SocketException('Invalid URI for socket pool; missing host or port'); } $scheme = \strtolower($parts['scheme']); $host = \strtolower($parts['host']); if (!\array_key_exists($scheme, self::ALLOWED_SCHEMES)) { throw new SocketException(\sprintf( "Invalid URI for socket pool; '%s' scheme not allowed - scheme must be one of %s", $scheme, \implode(', ', \array_keys(self::ALLOWED_SCHEMES)) )); } if ($parts['query'] !== null) { throw new SocketException('Invalid URI for socket pool; query component not allowed'); } if ($parts['path'] !== '') { throw new SocketException('Invalid URI for socket pool; path component must be empty'); } if ($parts['user'] !== null) { throw new SocketException('Invalid URI for socket pool; user component not allowed'); } return [$scheme . '://' . $host . ':' . $port, $parts['fragment']]; } private function checkoutNewSocket( string $uri, string $cacheKey, ConnectContext $connectContext = null, CancellationToken $token = null ): Promise { return call(function () use ($uri, $cacheKey, $connectContext, $token) { $this->pendingCount[$uri] = ($this->pendingCount[$uri] ?? 0) + 1; try { /** @var EncryptableSocket $socket */ $socket = yield $this->connector->connect($uri, $connectContext, $token); } finally { if (--$this->pendingCount[$uri] === 0) { unset($this->pendingCount[$uri]); } } /** @psalm-suppress MissingConstructor */ $socketEntry = new class { use Struct; /** @var string */ public $uri; /** @var EncryptableSocket */ public $object; /** @var bool */ public $isAvailable; /** @var string|null */ public $idleWatcher; }; $socketEntry->uri = $uri; $socketEntry->isAvailable = false; $socketEntry->object = $socket; $objectId = \spl_object_hash($socket); $this->sockets[$cacheKey][$objectId] = $socketEntry; $this->objectIdCacheKeyMap[$objectId] = $cacheKey; return $socket; }); } private function clearFromId(string $objectId): void { if (!isset($this->objectIdCacheKeyMap[$objectId])) { throw new \Error( \sprintf('Unknown socket: %d', $objectId) ); } $cacheKey = $this->objectIdCacheKeyMap[$objectId]; $socket = $this->sockets[$cacheKey][$objectId]; if ($socket->idleWatcher) { Loop::cancel($socket->idleWatcher); } unset( $this->sockets[$cacheKey][$objectId], $this->objectIdCacheKeyMap[$objectId] ); if (empty($this->sockets[$cacheKey])) { unset($this->sockets[$cacheKey]); } } } setupTls()` after accepting new clients. * * @param string $uri URI in scheme://host:port format. TCP is assumed if no scheme is present. * @param BindContext|null $context Context options for listening. * * @return Server * * @throws SocketException If binding to the specified URI failed. * @throws \Error If an invalid scheme is given. */ public static function listen(string $uri, ?BindContext $context = null): self { $context = $context ?? new BindContext; $scheme = \strstr($uri, '://', true); if ($scheme === false) { $uri = 'tcp://' . $uri; } elseif (!\in_array($scheme, ['tcp', 'unix'])) { throw new \Error('Only tcp and unix schemes allowed for server creation'); } $streamContext = \stream_context_create($context->toStreamContextArray()); // Error reporting suppressed since stream_socket_server() emits an E_WARNING on failure (checked below). $server = @\stream_socket_server($uri, $errno, $errstr, STREAM_SERVER_BIND | STREAM_SERVER_LISTEN, $streamContext); if (!$server || $errno) { throw new SocketException(\sprintf('Could not create server %s: [Error: #%d] %s', $uri, $errno, $errstr), $errno); } return new self($server, $context->getChunkSize()); } /** * @param resource $socket A bound socket server resource * @param int $chunkSize Chunk size for the input and output stream. * * @throws \Error If a stream resource is not given for $socket. */ public function __construct($socket, int $chunkSize = ResourceSocket::DEFAULT_CHUNK_SIZE) { if (!\is_resource($socket) || \get_resource_type($socket) !== 'stream') { throw new \Error('Invalid resource given to constructor!'); } $this->socket = $socket; $this->chunkSize = $chunkSize; $this->address = SocketAddress::fromLocalResource($socket); \stream_set_blocking($this->socket, false); $acceptor = &$this->acceptor; $this->watcher = Loop::onReadable($this->socket, static function ($watcher, $socket) use ( &$acceptor, $chunkSize ) { // Error reporting suppressed since stream_socket_accept() emits E_WARNING on client accept failure. if (!$client = @\stream_socket_accept($socket, 0)) { // Timeout of 0 to be non-blocking. return; // Accepting client failed. } $deferred = $acceptor; $acceptor = null; \assert($deferred !== null); $deferred->resolve(ResourceSocket::fromServerSocket($client, $chunkSize)); /** @psalm-suppress RedundantCondition Resolution of the deferred above might accept immediately again */ if (!$acceptor) { Loop::disable($watcher); } }); Loop::disable($this->watcher); } /** * Automatically cancels the loop watcher. */ public function __destruct() { if (!$this->socket) { return; } $this->free(); } private function free(): void { Loop::cancel($this->watcher); $this->socket = null; if ($this->acceptor) { $this->acceptor->resolve(); $this->acceptor = null; } } /** * @return Promise * * @throws PendingAcceptError If another accept request is pending. */ public function accept(): Promise { if ($this->acceptor) { throw new PendingAcceptError; } if (!$this->socket) { return new Success; // Resolve with null when server is closed. } // Error reporting suppressed since stream_socket_accept() emits E_WARNING on client accept failure. if ($client = @\stream_socket_accept($this->socket, 0)) { // Timeout of 0 to be non-blocking. return new Success(ResourceSocket::fromServerSocket($client, $this->chunkSize)); } $this->acceptor = new Deferred; Loop::enable($this->watcher); return $this->acceptor->promise(); } /** * Closes the server and stops accepting connections. Any socket clients accepted will not be closed. */ public function close(): void { if ($this->socket) { /** @psalm-suppress InvalidPropertyAssignmentValue */ \fclose($this->socket); } $this->free(); } /** * @return bool */ public function isClosed(): bool { return $this->socket === null; } /** * References the accept watcher. * * @see Loop::reference() */ final public function reference(): void { Loop::reference($this->watcher); } /** * Unreferences the accept watcher. * * @see Loop::unreference() */ final public function unreference(): void { Loop::unreference($this->watcher); } /** * @return SocketAddress */ public function getAddress(): SocketAddress { return $this->address; } /** * Raw stream socket resource. * * @return resource|null */ final public function getResource() { return $this->socket; } } tlsContext = $tlsContext; $this->reader = new ResourceInputStream($resource, $chunkSize); $this->writer = new ResourceOutputStream($resource, $chunkSize); $this->remoteAddress = SocketAddress::fromPeerResource($resource); $this->localAddress = SocketAddress::fromLocalResource($resource); $this->tlsState = self::TLS_STATE_DISABLED; } /** @inheritDoc */ public function setupTls(?CancellationToken $cancellationToken = null): Promise { $resource = $this->getResource(); if ($resource === null) { return new Failure(new ClosedException("Can't setup TLS, because the socket has already been closed")); } $this->tlsState = self::TLS_STATE_SETUP_PENDING; if ($this->tlsContext) { $promise = Internal\setupTls($resource, $this->tlsContext->toStreamContextArray(), $cancellationToken); } else { $context = @\stream_context_get_options($resource); if (empty($context['ssl'])) { return new Failure(new TlsException( "Can't enable TLS without configuration. " . "If you used Amp\\Socket\\listen(), be sure to pass a ServerTlsContext within the BindContext " . "in the second argument, otherwise set the 'ssl' context option to the PHP stream resource." )); } $promise = Internal\setupTls($resource, $context, $cancellationToken); } return call(function () use ($promise) { try { yield $promise; $this->tlsState = self::TLS_STATE_ENABLED; } catch (\Throwable $exception) { $this->close(); throw $exception; } }); } /** @inheritDoc */ public function shutdownTls(?CancellationToken $cancellationToken = null): Promise { if (($resource = $this->reader->getResource()) === null) { return new Failure(new ClosedException("Can't shutdown TLS, because the socket has already been closed")); } $this->tlsState = self::TLS_STATE_SHUTDOWN_PENDING; return call(function () use ($resource) { try { yield Internal\shutdownTls($resource); } finally { $this->tlsState = self::TLS_STATE_DISABLED; } }); } /** @inheritDoc */ public function read(): Promise { return $this->reader->read(); } /** @inheritDoc */ public function write(string $data): Promise { return $this->writer->write($data); } /** @inheritDoc */ public function end(string $data = ''): Promise { $promise = $this->writer->end($data); $promise->onResolve(function () { $this->close(); }); return $promise; } /** @inheritDoc */ public function close(): void { $this->reader->close(); $this->writer->close(); } /** @inheritDoc */ public function reference(): void { $this->reader->reference(); } /** @inheritDoc */ public function unreference(): void { $this->reader->unreference(); } /** @inheritDoc */ public function getLocalAddress(): SocketAddress { return $this->localAddress; } /** * @inheritDoc * * @return resource|null */ public function getResource() { return $this->reader->getResource(); } /** @inheritDoc */ public function getRemoteAddress(): SocketAddress { return $this->remoteAddress; } /** @inheritDoc */ public function getTlsState(): int { return $this->tlsState; } /** @inheritDoc */ public function getTlsInfo(): ?TlsInfo { if (null !== $this->tlsInfo) { return $this->tlsInfo; } $resource = $this->getResource(); if ($resource === null || !\is_resource($resource)) { return null; } return $this->tlsInfo = TlsInfo::fromStreamResource($resource); } /** @inheritDoc */ public function isClosed(): bool { return $this->getResource() === null; } /** * @param int $chunkSize New chunk size for reading and writing. */ public function setChunkSize(int $chunkSize): void { $this->reader->setChunkSize($chunkSize); $this->writer->setChunkSize($chunkSize); } } { "name": "amphp/log", "homepage": "https://github.com/amphp/log", "description": "Non-blocking logging for PHP based on Amp and Monolog.", "keywords": [ "log", "logging", "logger", "async", "non-blocking", "amp", "amphp" ], "license": "MIT", "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "require": { "php": ">=7.1", "amphp/amp": "^2", "amphp/byte-stream": "^1.3", "monolog/monolog": "^2 || ^1.23" }, "require-dev": { "amphp/phpunit-util": "^1.1", "amphp/php-cs-fixer-config": "dev-master", "phpunit/phpunit": "^8 || ^7" }, "autoload": { "psr-4": { "Amp\\Log\\": "src" }, "files": [ "src/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Log\\Test\\": "test" } }, "scripts": { "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit", "code-style": "@php ./vendor/bin/php-cs-fixer fix" } } setFormatter(new ConsoleFormatter); $logger = new Logger('hello-world'); $logger->pushHandler($handler); $logger->debug("Hello, world!"); $logger->info("Hello, world!"); $logger->notice("Hello, world!"); $logger->error("Hello, world!"); $logger->alert("Hello, world!"); stream = $outputStream; $stream = &$this->stream; $exception = &$this->exception; $this->onResolve = static function (\Throwable $e = null) use (&$stream, &$exception) { if (!$stream) { return; // Prior write already failed, ignore this failure. } if ($e) { $stream = null; $exception = $e; throw $e; } }; } /** * Writes the record down to the log of the implementing handler. * * @param array $record * * @return void */ protected function write(array $record): void { if ($this->exception) { throw $this->exception; } $this->stream->write((string) $record['formatted'])->onResolve($this->onResolve); } } setAnsiColorOption(); } public function format(array $record): string { if ($this->colors) { $record['level_name'] = $this->ansifyLevel($record['level_name']); $record['channel'] = "\033[1m{$record['channel']}\033[0m"; } return parent::format($record); } private function setAnsiColorOption(): void { $value = \getenv("AMP_LOG_COLOR"); if ($value === false || $value === '') { $value = "auto"; } $value = \strtolower($value); switch ($value) { case "1": case "true": case "on": $this->colors = true; break; case "0": case "false": case "off": $this->colors = false; break; default: $this->colors = hasColorSupport(); break; } } private function ansifyLevel(string $level): string { $level = \strtolower($level); switch ($level) { case LogLevel::EMERGENCY: case LogLevel::ALERT: case LogLevel::CRITICAL: case LogLevel::ERROR: return "\033[1;31m{$level}\033[0m"; // bold + red case LogLevel::WARNING: return "\033[1;33m{$level}\033[0m"; // bold + yellow case LogLevel::NOTICE: return "\033[1;32m{$level}\033[0m"; // bold + green case LogLevel::INFO: return "\033[1;35m{$level}\033[0m"; // bold + magenta case LogLevel::DEBUG: return "\033[1;36m{$level}\033[0m"; // bold + cyan default: return "\033[1m{$level}\033[0m"; // bold } } } token = $source->getToken(); $trace = \debug_backtrace(\DEBUG_BACKTRACE_IGNORE_ARGS); $this->watcher = Loop::delay($timeout, static function () use ($source, $message, $trace) { $trace = formatStacktrace($trace); $source->cancel(new TimeoutException("$message\r\nTimeoutCancellationToken was created here:\r\n$trace")); }); Loop::unreference($this->watcher); } /** * Cancels the delay watcher. */ public function __destruct() { Loop::cancel($this->watcher); } /** * {@inheritdoc} */ public function subscribe(callable $callback): string { return $this->token->subscribe($callback); } /** * {@inheritdoc} */ public function unsubscribe(string $id) { $this->token->unsubscribe($id); } /** * {@inheritdoc} */ public function isRequested(): bool { return $this->token->isRequested(); } /** * {@inheritdoc} */ public function throwIfRequested() { $this->token->throwIfRequested(); } } current(); $prefix .= \sprintf( "; %s yielded at key %s", \is_object($yielded) ? \get_class($yielded) : \gettype($yielded), \var_export($generator->key(), true) ); if (!$generator->valid()) { parent::__construct($prefix, 0, $previous); return; } $reflGen = new \ReflectionGenerator($generator); $exeGen = $reflGen->getExecutingGenerator(); if ($isSubgenerator = ($exeGen !== $generator)) { $reflGen = new \ReflectionGenerator($exeGen); } parent::__construct(\sprintf( "%s on line %s in %s", $prefix, $reflGen->getExecutingLine(), $reflGen->getExecutingFile() ), 0, $previous); } } */ final class Delayed implements Promise { use Internal\Placeholder; /** @var string|null Event loop watcher identifier. */ private $watcher; /** * @param int $time Milliseconds before succeeding the promise. * @param TReturn $value Succeed the promise with this value. */ public function __construct(int $time, $value = null) { $this->watcher = Loop::delay($time, function () use ($value) { $this->watcher = null; $this->resolve($value); }); } /** * References the internal watcher in the event loop, keeping the loop running while this promise is pending. * * @return self */ public function reference(): self { if ($this->watcher !== null) { Loop::reference($this->watcher); } return $this; } /** * Unreferences the internal watcher in the event loop, allowing the loop to stop while this promise is pending if * no other events are pending in the loop. * * @return self */ public function unreference(): self { if ($this->watcher !== null) { Loop::unreference($this->watcher); } return $this; } } generateStructPropertyError($property) ); } /** * @param string $property * @param mixed $value * * @psalm-return no-return */ public function __set(string $property, $value) { throw new \Error( $this->generateStructPropertyError($property) ); } private function generateStructPropertyError(string $property): string { $suggestion = $this->suggestPropertyName($property); $suggestStr = ($suggestion == "") ? "" : " ... did you mean \"{$suggestion}?\""; return \sprintf( "%s property \"%s\" does not exist%s", \str_replace("\0", "@", \get_class($this)), // Handle anonymous class names. $property, $suggestStr ); } private function suggestPropertyName(string $badProperty): string { $badProperty = \strtolower($badProperty); $bestMatch = ""; $bestMatchPercentage = 0; /** @psalm-suppress RawObjectIteration */ foreach ($this as $property => $value) { // Never suggest properties that begin with an underscore if ($property[0] === "_") { continue; } \similar_text($badProperty, \strtolower($property), $byRefPercentage); if ($byRefPercentage > $bestMatchPercentage) { $bestMatchPercentage = $byRefPercentage; $bestMatch = $property; } } return ($bestMatchPercentage >= $this->__propertySuggestThreshold) ? $bestMatch : ""; } } getToken(); * * $response = yield $httpClient->request("https://example.com/stream", $token); * $responseBody = $response->getBody(); * * while (($chunk = yield $response->read()) !== null) { * // consume $chunk * * if ($noLongerInterested) { * $cancellationTokenSource->cancel(); * break; * } * } * ``` * * @see CancellationToken * @see CancelledException */ final class CancellationTokenSource { /** @var CancellationToken */ private $token; /** @var callable|null */ private $onCancel; public function __construct() { $onCancel = null; $this->token = new class($onCancel) implements CancellationToken { /** @var string */ private $nextId = "a"; /** @var callable[] */ private $callbacks = []; /** @var \Throwable|null */ private $exception; /** * @param mixed $onCancel * @param-out callable $onCancel */ public function __construct(&$onCancel) { /** @psalm-suppress MissingClosureReturnType We still support PHP 7.0 */ $onCancel = function (\Throwable $exception) { $this->exception = $exception; $callbacks = $this->callbacks; $this->callbacks = []; foreach ($callbacks as $callback) { $this->invokeCallback($callback); } }; } /** * @param callable $callback * * @return void */ private function invokeCallback(callable $callback) { // No type declaration to prevent exception outside the try! try { /** @var mixed $result */ $result = $callback($this->exception); if ($result instanceof \Generator) { /** @psalm-var \Generator $result */ $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { Loop::defer(static function () use ($exception) { throw $exception; }); } } public function subscribe(callable $callback): string { $id = $this->nextId++; if ($this->exception) { $this->invokeCallback($callback); } else { $this->callbacks[$id] = $callback; } return $id; } public function unsubscribe(string $id) { unset($this->callbacks[$id]); } public function isRequested(): bool { return isset($this->exception); } public function throwIfRequested() { if (isset($this->exception)) { throw $this->exception; } } }; $this->onCancel = $onCancel; } public function getToken(): CancellationToken { return $this->token; } /** * @param \Throwable|null $previous Exception to be used as the previous exception to CancelledException. * * @return void */ public function cancel(\Throwable $previous = null) { if ($this->onCancel === null) { return; } $onCancel = $this->onCancel; $this->onCancel = null; $onCancel(new CancelledException($previous)); } } * * @throws \Error If the prior promise returned from this method has not resolved. * @throws \Throwable The exception used to fail the iterator. */ public function advance(): Promise; /** * Gets the last emitted value or throws an exception if the iterator has completed. * * @return mixed Value emitted from the iterator. * @psalm-return TValue * * @throws \Error If the iterator has resolved or advance() was not called before calling this method. * @throws \Throwable The exception used to fail the iterator. */ public function getCurrent(); } , mixed, * mixed>|null) | callable(\Throwable|null, mixed): void $onResolved * * @return void */ public function onResolve(callable $onResolved); } getMethod($method); } return self::$__reflectionMethods[$method]->getClosure($this); } /** * Creates a callable from a protected or private static method that may be invoked by methods requiring a * publicly invokable callback. * * @param string $method Static method name. * * @return callable * * @psalm-suppress MixedInferredReturnType */ private static function callableFromStaticMethod(string $method): callable { if (!isset(self::$__reflectionMethods[$method])) { if (self::$__reflectionClass === null) { self::$__reflectionClass = new \ReflectionClass(self::class); } self::$__reflectionMethods[$method] = self::$__reflectionClass->getMethod($method); } return self::$__reflectionMethods[$method]->getClosure(); } } } else { /** @psalm-suppress DuplicateClass */ trait CallableMaker { /** * @deprecated Use \Closure::fromCallable() instead of this method in PHP 7.1. */ private function callableFromInstanceMethod(string $method): callable { return \Closure::fromCallable([$this, $method]); } /** * @deprecated Use \Closure::fromCallable() instead of this method in PHP 7.1. */ private static function callableFromStaticMethod(string $method): callable { return \Closure::fromCallable([self::class, $method]); } } } // @codeCoverageIgnoreEnd reasons = $reasons; } /** * @return \Throwable[] */ public function getReasons(): array { return $this->reasons; } } */ final class Coroutine implements Promise { use Internal\Placeholder; /** * Attempts to transform the non-promise yielded from the generator into a promise, otherwise returns an instance * `Amp\Failure` failed with an instance of `Amp\InvalidYieldError`. * * @param mixed $yielded Non-promise yielded from generator. * @param \Generator $generator No type for performance, we already know the type. * * @return Promise */ private static function transform($yielded, $generator): Promise { $exception = null; // initialize here, see https://github.com/vimeo/psalm/issues/2951 try { if (\is_array($yielded)) { return Promise\all($yielded); } if ($yielded instanceof ReactPromise) { return Promise\adapt($yielded); } // No match, continue to returning Failure below. } catch (\Throwable $exception) { // Conversion to promise failed, fall-through to returning Failure below. } return new Failure(new InvalidYieldError( $generator, \sprintf( "Unexpected yield; Expected an instance of %s or %s or an array of such instances", Promise::class, ReactPromise::class ), $exception )); } /** * @param \Generator $generator * @psalm-param \Generator,mixed,Promise|ReactPromise|TReturn> $generator */ public function __construct(\Generator $generator) { try { $yielded = $generator->current(); if (!$yielded instanceof Promise) { if (!$generator->valid()) { $this->resolve($generator->getReturn()); return; } $yielded = self::transform($yielded, $generator); } } catch (\Throwable $exception) { $this->fail($exception); return; } /** * @param \Throwable|null $e Exception to be thrown into the generator. * @param mixed $v Value to be sent into the generator. * * @return void * * @psalm-suppress MissingClosureParamType * @psalm-suppress MissingClosureReturnType */ $onResolve = function (\Throwable $e = null, $v) use ($generator, &$onResolve) { /** @var bool $immediate Used to control iterative coroutine continuation. */ static $immediate = true; /** @var \Throwable|null $exception Promise failure reason when executing next coroutine step, null at all other times. */ static $exception; /** @var mixed $value Promise success value when executing next coroutine step, null at all other times. */ static $value; $exception = $e; /** @psalm-suppress MixedAssignment */ $value = $v; if (!$immediate) { $immediate = true; return; } try { try { do { if ($exception) { // Throw exception at current execution point. $yielded = $generator->throw($exception); } else { // Send the new value and execute to next yield statement. $yielded = $generator->send($value); } if (!$yielded instanceof Promise) { if (!$generator->valid()) { $this->resolve($generator->getReturn()); $onResolve = null; return; } $yielded = self::transform($yielded, $generator); } $immediate = false; $yielded->onResolve($onResolve); } while ($immediate); $immediate = true; } catch (\Throwable $exception) { $this->fail($exception); $onResolve = null; } finally { $exception = null; $value = null; } } catch (\Throwable $e) { Loop::defer(static function () use ($e) { throw $e; }); } }; try { $yielded->onResolve($onResolve); unset($generator, $yielded, $onResolve); } catch (\Throwable $e) { Loop::defer(static function () use ($e) { throw $e; }); } } } defer($callback); } self::$driver->run(); } /** * Stop the event loop. * * When an event loop is stopped, it continues with its current tick and exits the loop afterwards. Multiple calls * to stop MUST be ignored and MUST NOT raise an exception. * * @return void */ public static function stop() { self::$driver->stop(); } /** * Defer the execution of a callback. * * The deferred callable MUST be executed before any other type of watcher in a tick. Order of enabling MUST be * preserved when executing the callbacks. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param callable(string $watcherId, mixed $data) $callback The callback to defer. The `$watcherId` will be * invalidated before the callback call. * @param mixed $data Arbitrary data given to the callback function as the `$data` parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. */ public static function defer(callable $callback, $data = null): string { return self::$driver->defer($callback, $data); } /** * Delay the execution of a callback. * * The delay is a minimum and approximate, accuracy is not guaranteed. Order of calls MUST be determined by which * timers expire first, but timers with the same expiration time MAY be executed in any order. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param int $delay The amount of time, in milliseconds, to delay the execution for. * @param callable(string $watcherId, mixed $data) $callback The callback to delay. The `$watcherId` will be * invalidated before the callback call. * @param mixed $data Arbitrary data given to the callback function as the `$data` parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. */ public static function delay(int $delay, callable $callback, $data = null): string { return self::$driver->delay($delay, $callback, $data); } /** * Repeatedly execute a callback. * * The interval between executions is a minimum and approximate, accuracy is not guaranteed. Order of calls MUST be * determined by which timers expire first, but timers with the same expiration time MAY be executed in any order. * The first execution is scheduled after the first interval period. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param int $interval The time interval, in milliseconds, to wait between executions. * @param callable(string $watcherId, mixed $data) $callback The callback to repeat. * @param mixed $data Arbitrary data given to the callback function as the `$data` parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. */ public static function repeat(int $interval, callable $callback, $data = null): string { return self::$driver->repeat($interval, $callback, $data); } /** * Execute a callback when a stream resource becomes readable or is closed for reading. * * Warning: Closing resources locally, e.g. with `fclose`, might not invoke the callback. Be sure to `cancel` the * watcher when closing the resource locally. Drivers MAY choose to notify the user if there are watchers on invalid * resources, but are not required to, due to the high performance impact. Watchers on closed resources are * therefore undefined behavior. * * Multiple watchers on the same stream MAY be executed in any order. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param resource $stream The stream to monitor. * @param callable(string $watcherId, resource $stream, mixed $data) $callback The callback to execute. * @param mixed $data Arbitrary data given to the callback function as the `$data` parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. */ public static function onReadable($stream, callable $callback, $data = null): string { return self::$driver->onReadable($stream, $callback, $data); } /** * Execute a callback when a stream resource becomes writable or is closed for writing. * * Warning: Closing resources locally, e.g. with `fclose`, might not invoke the callback. Be sure to `cancel` the * watcher when closing the resource locally. Drivers MAY choose to notify the user if there are watchers on invalid * resources, but are not required to, due to the high performance impact. Watchers on closed resources are * therefore undefined behavior. * * Multiple watchers on the same stream MAY be executed in any order. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param resource $stream The stream to monitor. * @param callable(string $watcherId, resource $stream, mixed $data) $callback The callback to execute. * @param mixed $data Arbitrary data given to the callback function as the `$data` parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. */ public static function onWritable($stream, callable $callback, $data = null): string { return self::$driver->onWritable($stream, $callback, $data); } /** * Execute a callback when a signal is received. * * Warning: Installing the same signal on different instances of this interface is deemed undefined behavior. * Implementations MAY try to detect this, if possible, but are not required to. This is due to technical * limitations of the signals being registered globally per process. * * Multiple watchers on the same signal MAY be executed in any order. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param int $signo The signal number to monitor. * @param callable(string $watcherId, int $signo, mixed $data) $callback The callback to execute. * @param mixed $data Arbitrary data given to the callback function as the $data parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. * * @throws UnsupportedFeatureException If signal handling is not supported. */ public static function onSignal(int $signo, callable $callback, $data = null): string { return self::$driver->onSignal($signo, $callback, $data); } /** * Enable a watcher to be active starting in the next tick. * * Watchers MUST immediately be marked as enabled, but only be activated (i.e. callbacks can be called) right before * the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param string $watcherId The watcher identifier. * * @return void * * @throws InvalidWatcherError If the watcher identifier is invalid. */ public static function enable(string $watcherId) { self::$driver->enable($watcherId); } /** * Disable a watcher immediately. * * A watcher MUST be disabled immediately, e.g. if a defer watcher disables a later defer watcher, the second defer * watcher isn't executed in this tick. * * Disabling a watcher MUST NOT invalidate the watcher. Calling this function MUST NOT fail, even if passed an * invalid watcher. * * @param string $watcherId The watcher identifier. * * @return void */ public static function disable(string $watcherId) { if (\PHP_VERSION_ID < 70200 && !isset(self::$driver)) { // Prior to PHP 7.2, self::$driver may be unset during destruct. // See https://github.com/amphp/amp/issues/212. return; } self::$driver->disable($watcherId); } /** * Cancel a watcher. * * This will detatch the event loop from all resources that are associated to the watcher. After this operation the * watcher is permanently invalid. Calling this function MUST NOT fail, even if passed an invalid watcher. * * @param string $watcherId The watcher identifier. * * @return void */ public static function cancel(string $watcherId) { if (\PHP_VERSION_ID < 70200 && !isset(self::$driver)) { // Prior to PHP 7.2, self::$driver may be unset during destruct. // See https://github.com/amphp/amp/issues/212. return; } self::$driver->cancel($watcherId); } /** * Reference a watcher. * * This will keep the event loop alive whilst the watcher is still being monitored. Watchers have this state by * default. * * @param string $watcherId The watcher identifier. * * @return void * * @throws InvalidWatcherError If the watcher identifier is invalid. */ public static function reference(string $watcherId) { self::$driver->reference($watcherId); } /** * Unreference a watcher. * * The event loop should exit the run method when only unreferenced watchers are still being monitored. Watchers * are all referenced by default. * * @param string $watcherId The watcher identifier. * * @return void */ public static function unreference(string $watcherId) { if (\PHP_VERSION_ID < 70200 && !isset(self::$driver)) { // Prior to PHP 7.2, self::$driver may be unset during destruct. // See https://github.com/amphp/amp/issues/212. return; } self::$driver->unreference($watcherId); } /** * Returns the current loop time in millisecond increments. Note this value does not necessarily correlate to * wall-clock time, rather the value returned is meant to be used in relative comparisons to prior values returned * by this method (intervals, expiration calculations, etc.) and is only updated once per loop tick. * * @return int */ public static function now(): int { return self::$driver->now(); } /** * Stores information in the loop bound registry. * * Stored information is package private. Packages MUST NOT retrieve the stored state of other packages. Packages * MUST use their namespace as prefix for keys. They may do so by using `SomeClass::class` as key. * * If packages want to expose loop bound state to consumers other than the package, they SHOULD provide a dedicated * interface for that purpose instead of sharing the storage key. * * @param string $key The namespaced storage key. * @param mixed $value The value to be stored. * * @return void */ public static function setState(string $key, $value) { self::$driver->setState($key, $value); } /** * Gets information stored bound to the loop. * * Stored information is package private. Packages MUST NOT retrieve the stored state of other packages. Packages * MUST use their namespace as prefix for keys. They may do so by using `SomeClass::class` as key. * * If packages want to expose loop bound state to consumers other than the package, they SHOULD provide a dedicated * interface for that purpose instead of sharing the storage key. * * @param string $key The namespaced storage key. * * @return mixed The previously stored value or `null` if it doesn't exist. */ public static function getState(string $key) { return self::$driver->getState($key); } /** * Set a callback to be executed when an error occurs. * * The callback receives the error as the first and only parameter. The return value of the callback gets ignored. * If it can't handle the error, it MUST throw the error. Errors thrown by the callback or during its invocation * MUST be thrown into the `run` loop and stop the driver. * * Subsequent calls to this method will overwrite the previous handler. * * @param callable(\Throwable $error)|null $callback The callback to execute. `null` will clear the * current handler. * * @return callable(\Throwable $error)|null The previous handler, `null` if there was none. */ public static function setErrorHandler(callable $callback = null) { return self::$driver->setErrorHandler($callback); } /** * Retrieve an associative array of information about the event loop driver. * * The returned array MUST contain the following data describing the driver's currently registered watchers: * * [ * "defer" => ["enabled" => int, "disabled" => int], * "delay" => ["enabled" => int, "disabled" => int], * "repeat" => ["enabled" => int, "disabled" => int], * "on_readable" => ["enabled" => int, "disabled" => int], * "on_writable" => ["enabled" => int, "disabled" => int], * "on_signal" => ["enabled" => int, "disabled" => int], * "enabled_watchers" => ["referenced" => int, "unreferenced" => int], * "running" => bool * ]; * * Implementations MAY optionally add more information in the array but at minimum the above `key => value` format * MUST always be provided. * * @return array Statistics about the loop in the described format. */ public static function getInfo(): array { return self::$driver->getInfo(); } /** * Retrieve the event loop driver that is in scope. * * @return Driver */ public static function get(): Driver { return self::$driver; } } // Default factory, don't move this to a file loaded by the composer "files" autoload mechanism, otherwise custom // implementations might have issues setting a default loop, because it's overridden by us then. // @codeCoverageIgnoreStart Loop::set((new DriverFactory)->create()); // @codeCoverageIgnoreEnd Has public emit, complete, and fail methods. */ private $emitter; /** @var Iterator Hides producer methods. */ private $iterator; public function __construct() { $this->emitter = new class implements Iterator { use Internal\Producer { emit as public; complete as public; fail as public; } }; $this->iterator = new Internal\PrivateIterator($this->emitter); } /** * @return Iterator * @psalm-return Iterator */ public function iterate(): Iterator { return $this->iterator; } /** * Emits a value to the iterator. * * @param mixed $value * * @psalm-param TValue $value * * @return Promise * @psalm-return Promise * @psalm-suppress MixedInferredReturnType * @psalm-suppress MixedReturnStatement */ public function emit($value): Promise { /** @psalm-suppress UndefinedInterfaceMethod */ return $this->emitter->emit($value); } /** * Completes the iterator. * * @return void */ public function complete() { /** @psalm-suppress UndefinedInterfaceMethod */ $this->emitter->complete(); } /** * Fails the iterator with the given reason. * * @param \Throwable $reason * * @return void */ public function fail(\Throwable $reason) { /** @psalm-suppress UndefinedInterfaceMethod */ $this->emitter->fail($reason); } } */ final class Success implements Promise { /** @var mixed */ private $value; /** * @param mixed $value Anything other than a Promise object. * * @psalm-param TValue $value * * @throws \Error If a promise is given as the value. */ public function __construct($value = null) { if ($value instanceof Promise || $value instanceof ReactPromise) { throw new \Error("Cannot use a promise as success value"); } $this->value = $value; } /** * {@inheritdoc} */ public function onResolve(callable $onResolved) { try { $result = $onResolved(null, $this->value); if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { Promise\rethrow($result); } } catch (\Throwable $exception) { Loop::defer(static function () use ($exception) { throw $exception; }); } } } , mixed, * mixed>|null)|callable(\Throwable|null, mixed): void */ private $onResolved; /** @var null|array */ private $resolutionTrace; /** * @inheritdoc */ public function onResolve(callable $onResolved) { if ($this->resolved) { if ($this->result instanceof Promise) { $this->result->onResolve($onResolved); return; } try { /** @var mixed $result */ $result = $onResolved(null, $this->result); if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { Promise\rethrow($result); } } catch (\Throwable $exception) { Loop::defer(static function () use ($exception) { throw $exception; }); } return; } if (null === $this->onResolved) { $this->onResolved = $onResolved; return; } if (!$this->onResolved instanceof ResolutionQueue) { /** @psalm-suppress InternalClass */ $this->onResolved = new ResolutionQueue($this->onResolved); } /** @psalm-suppress InternalMethod */ $this->onResolved->push($onResolved); } public function __destruct() { try { $this->result = null; } catch (\Throwable $e) { Loop::defer(static function () use ($e) { throw $e; }); } } /** * @param mixed $value * * @return void * * @throws \Error Thrown if the promise has already been resolved. */ private function resolve($value = null) { if ($this->resolved) { $message = "Promise has already been resolved"; if (isset($this->resolutionTrace)) { $trace = formatStacktrace($this->resolutionTrace); $message .= ". Previous resolution trace:\n\n{$trace}\n\n"; } else { // @codeCoverageIgnoreStart $message .= ", define environment variable AMP_DEBUG or const AMP_DEBUG = true and enable assertions " . "for a stacktrace of the previous resolution."; // @codeCoverageIgnoreEnd } throw new \Error($message); } \assert((function () { $env = \getenv("AMP_DEBUG") ?: "0"; if (($env !== "0" && $env !== "false") || (\defined("AMP_DEBUG") && \AMP_DEBUG)) { $trace = \debug_backtrace(\DEBUG_BACKTRACE_IGNORE_ARGS); \array_shift($trace); // remove current closure $this->resolutionTrace = $trace; } return true; })()); if ($value instanceof ReactPromise) { $value = Promise\adapt($value); } $this->resolved = true; $this->result = $value; if ($this->onResolved === null) { return; } $onResolved = $this->onResolved; $this->onResolved = null; if ($this->result instanceof Promise) { $this->result->onResolve($onResolved); return; } try { /** @var mixed $result */ $result = $onResolved(null, $this->result); $onResolved = null; // allow garbage collection of $onResolved, to catch any exceptions from destructors if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { Promise\rethrow($result); } } catch (\Throwable $exception) { Loop::defer(static function () use ($exception) { throw $exception; }); } } /** * @param \Throwable $reason Failure reason. * * @return void */ private function fail(\Throwable $reason) { $this->resolve(new Failure($reason)); } /** * @return bool True if the placeholder has been resolved. */ private function isResolved(): bool { return $this->resolved; } } promise = $promise; } public function onResolve(callable $onResolved) { $this->promise->onResolve($onResolved); } } $trace Output of * `debug_backtrace()`. * * @return string Formatted stacktrace. * * @codeCoverageIgnore * @internal */ function formatStacktrace(array $trace): string { return \implode("\n", \array_map(static function ($e, $i) { $line = "#{$i} "; if (isset($e["file"])) { $line .= "{$e['file']}:{$e['line']} "; } if (isset($e["type"])) { $line .= $e["class"] . $e["type"]; } return $line . $e["function"] . "()"; }, $trace, \array_keys($trace))); } /** * Creates a `TypeError` with a standardized error message. * * @param string[] $expected Expected types. * @param mixed $given Given value. * * @return \TypeError * * @internal */ function createTypeError(array $expected, $given): \TypeError { $givenType = \is_object($given) ? \sprintf("instance of %s", \get_class($given)) : \gettype($given); if (\count($expected) === 1) { $expectedType = "Expected the following type: " . \array_pop($expected); } else { $expectedType = "Expected one of the following types: " . \implode(", ", $expected); } return new \TypeError("{$expectedType}; {$givenType} given"); } /** * Returns the current time relative to an arbitrary point in time. * * @return int Time in milliseconds. */ function getCurrentTime(): int { /** @var int|null $startTime */ static $startTime; /** @var int|null $nextWarning */ static $nextWarning; if (\PHP_INT_SIZE === 4) { // @codeCoverageIgnoreStart if ($startTime === null) { $startTime = \PHP_VERSION_ID >= 70300 ? \hrtime(false)[0] : \time(); $nextWarning = \PHP_INT_MAX - 86400 * 7; } if (\PHP_VERSION_ID >= 70300) { list($seconds, $nanoseconds) = \hrtime(false); $seconds -= $startTime; if ($seconds >= $nextWarning) { $timeToOverflow = (\PHP_INT_MAX - $seconds * 1000) / 1000; \trigger_error( "getCurrentTime() will overflow in $timeToOverflow seconds, please restart the process before that. " . "You're using a 32 bit version of PHP, so time will overflow about every 24 days. Regular restarts are required.", \E_USER_WARNING ); /** @psalm-suppress PossiblyNullOperand */ $nextWarning += 600; // every 10 minutes } return (int) ($seconds * 1000 + $nanoseconds / 1000000); } $seconds = \microtime(true) - $startTime; if ($seconds >= $nextWarning) { $timeToOverflow = (\PHP_INT_MAX - $seconds * 1000) / 1000; \trigger_error( "getCurrentTime() will overflow in $timeToOverflow seconds, please restart the process before that. " . "You're using a 32 bit version of PHP, so time will overflow about every 24 days. Regular restarts are required.", \E_USER_WARNING ); /** @psalm-suppress PossiblyNullOperand */ $nextWarning += 600; // every 10 minutes } return (int) ($seconds * 1000); // @codeCoverageIgnoreEnd } if (\PHP_VERSION_ID >= 70300) { list($seconds, $nanoseconds) = \hrtime(false); return (int) ($seconds * 1000 + $nanoseconds / 1000000); } return (int) (\microtime(true) * 1000); } , mixed, * mixed>|null) | callable(\Throwable|null, mixed): void> */ private $queue = []; /** * @param callable|null $callback Initial callback to add to queue. * * @psalm-param null|callable(\Throwable|null, mixed): (Promise|\React\Promise\PromiseInterface|\Generator, mixed, * mixed>|null) | callable(\Throwable|null, mixed): void $callback */ public function __construct(callable $callback = null) { if ($callback !== null) { $this->push($callback); } } /** * Unrolls instances of self to avoid blowing up the call stack on resolution. * * @param callable $callback * * @psalm-param callable(\Throwable|null, mixed): (Promise|\React\Promise\PromiseInterface|\Generator, mixed, * mixed>|null) | callable(\Throwable|null, mixed): void $callback * * @return void */ public function push(callable $callback) { if ($callback instanceof self) { $this->queue = \array_merge($this->queue, $callback->queue); return; } $this->queue[] = $callback; } /** * Calls each callback in the queue, passing the provided values to the function. * * @param \Throwable|null $exception * @param mixed $value * * @return void */ public function __invoke($exception, $value) { foreach ($this->queue as $callback) { try { $result = $callback($exception, $value); if ($result === null) { continue; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { Promise\rethrow($result); } } catch (\Throwable $exception) { Loop::defer(static function () use ($exception) { throw $exception; }); } } } } */ public function advance(): Promise { if ($this->waiting !== null) { throw new \Error("The prior promise returned must resolve before invoking this method again"); } unset($this->values[$this->consumePosition]); $position = ++$this->consumePosition; if (\array_key_exists($position, $this->values)) { \assert(isset($this->backPressure[$position])); $deferred = $this->backPressure[$position]; unset($this->backPressure[$position]); $deferred->resolve(); return new Success(true); } if ($this->complete) { return $this->complete; } $this->waiting = new Deferred; return $this->waiting->promise(); } /** * {@inheritdoc} * * @return TValue */ public function getCurrent() { if (empty($this->values) && $this->complete) { throw new \Error("The iterator has completed"); } if (!\array_key_exists($this->consumePosition, $this->values)) { throw new \Error("Promise returned from advance() must resolve before calling this method"); } return $this->values[$this->consumePosition]; } /** * Emits a value from the iterator. The returned promise is resolved once the emitted value has been consumed. * * @param mixed $value * * @return Promise * @psalm-return Promise * * @throws \Error If the iterator has completed. */ private function emit($value): Promise { if ($this->complete) { throw new \Error("Iterators cannot emit values after calling complete"); } if ($value instanceof ReactPromise) { $value = Promise\adapt($value); } if ($value instanceof Promise) { $deferred = new Deferred; $value->onResolve(function ($e, $v) use ($deferred) { if ($this->complete) { $deferred->fail( new \Error("The iterator was completed before the promise result could be emitted") ); return; } if ($e) { $this->fail($e); $deferred->fail($e); return; } $deferred->resolve($this->emit($v)); }); return $deferred->promise(); } $position = ++$this->emitPosition; $this->values[$position] = $value; if ($this->waiting !== null) { $waiting = $this->waiting; $this->waiting = null; $waiting->resolve(true); return new Success; // Consumer was already waiting for a new value, so back-pressure is unnecessary. } $this->backPressure[$position] = $pressure = new Deferred; return $pressure->promise(); } /** * Completes the iterator. * * @return void * * @throws \Error If the iterator has already been completed. */ private function complete() { if ($this->complete) { $message = "Iterator has already been completed"; if (isset($this->resolutionTrace)) { $trace = formatStacktrace($this->resolutionTrace); $message .= ". Previous completion trace:\n\n{$trace}\n\n"; } else { // @codeCoverageIgnoreStart $message .= ", define environment variable AMP_DEBUG or const AMP_DEBUG = true and enable assertions " . "for a stacktrace of the previous resolution."; // @codeCoverageIgnoreEnd } throw new \Error($message); } \assert((function () { $env = \getenv("AMP_DEBUG") ?: "0"; if (($env !== "0" && $env !== "false") || (\defined("AMP_DEBUG") && \AMP_DEBUG)) { $trace = \debug_backtrace(\DEBUG_BACKTRACE_IGNORE_ARGS); \array_shift($trace); // remove current closure $this->resolutionTrace = $trace; } return true; })()); $this->complete = new Success(false); if ($this->waiting !== null) { $waiting = $this->waiting; $this->waiting = null; $waiting->resolve($this->complete); } } /** * @param \Throwable $exception * * @return void */ private function fail(\Throwable $exception) { $this->complete = new Failure($exception); if ($this->waiting !== null) { $waiting = $this->waiting; $this->waiting = null; $waiting->resolve($this->complete); } } } */ final class PrivateIterator implements Iterator { /** @var Iterator */ private $iterator; /** * @param Iterator $iterator * * @psalm-param Iterator $iterator */ public function __construct(Iterator $iterator) { $this->iterator = $iterator; } /** * @return Promise */ public function advance(): Promise { return $this->iterator->advance(); } /** * @psalm-return TValue */ public function getCurrent() { return $this->iterator->getCurrent(); } } */ final class Failure implements Promise { /** @var \Throwable $exception */ private $exception; /** * @param \Throwable $exception Rejection reason. */ public function __construct(\Throwable $exception) { $this->exception = $exception; } /** * {@inheritdoc} */ public function onResolve(callable $onResolved) { try { /** @var mixed $result */ $result = $onResolved($this->exception, null); if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { Promise\rethrow($result); } } catch (\Throwable $exception) { Loop::defer(static function () use ($exception) { throw $exception; }); } } } * @template T as TReturn|Promise|\Generator * * @formatter:off * * @param callable(...mixed): T $callback * * @return callable * @psalm-return (T is Promise ? (callable(mixed...): Promise) : (T is \Generator ? (TGenerator is Promise ? (callable(mixed...): Promise) : (callable(mixed...): Promise)) : (callable(mixed...): Promise))) * * @formatter:on * * @see asyncCoroutine() * * @psalm-suppress InvalidReturnType */ function coroutine(callable $callback): callable { /** @psalm-suppress InvalidReturnStatement */ return static function (...$args) use ($callback): Promise { return call($callback, ...$args); }; } /** * Returns a new function that wraps $callback in a promise/coroutine-aware function that automatically runs * Generators as coroutines. The returned function always returns void when invoked. Errors are forwarded to the * loop's error handler using `Amp\Promise\rethrow()`. * * Use this function to create a coroutine-aware callable for a non-promise-aware callback caller. * * @param callable(...mixed): mixed $callback * * @return callable * @psalm-return callable(mixed...): void * * @see coroutine() */ function asyncCoroutine(callable $callback): callable { return static function (...$args) use ($callback) { Promise\rethrow(call($callback, ...$args)); }; } /** * Calls the given function, always returning a promise. If the function returns a Generator, it will be run as a * coroutine. If the function throws, a failed promise will be returned. * * @template TReturn * @template TPromise * @template TGeneratorReturn * @template TGeneratorPromise * * @template TGenerator as TGeneratorReturn|Promise * @template T as TReturn|Promise|\Generator * * @formatter:off * * @param callable(...mixed): T $callback * @param mixed ...$args Arguments to pass to the function. * * @return Promise * @psalm-return (T is Promise ? Promise : (T is \Generator ? (TGenerator is Promise ? Promise : Promise) : Promise)) * * @formatter:on */ function call(callable $callback, ...$args): Promise { try { $result = $callback(...$args); } catch (\Throwable $exception) { return new Failure($exception); } if ($result instanceof \Generator) { return new Coroutine($result); } if ($result instanceof Promise) { return $result; } if ($result instanceof ReactPromise) { return Promise\adapt($result); } return new Success($result); } /** * Calls the given function. If the function returns a Generator, it will be run as a coroutine. If the function * throws or returns a failing promise, the failure is forwarded to the loop error handler. * * @param callable(...mixed): mixed $callback * @param mixed ...$args Arguments to pass to the function. * * @return void */ function asyncCall(callable $callback, ...$args) { Promise\rethrow(call($callback, ...$args)); } /** * Sleeps for the specified number of milliseconds. * * @param int $milliseconds * * @return Delayed */ function delay(int $milliseconds): Delayed { return new Delayed($milliseconds); } /** * Returns the current time relative to an arbitrary point in time. * * @return int Time in milliseconds. */ function getCurrentTime(): int { return Internal\getCurrentTime(); } } namespace Amp\Promise { use Amp\Deferred; use Amp\Loop; use Amp\MultiReasonException; use Amp\Promise; use Amp\Success; use Amp\TimeoutException; use React\Promise\PromiseInterface as ReactPromise; use function Amp\call; use function Amp\Internal\createTypeError; /** * Registers a callback that will forward the failure reason to the event loop's error handler if the promise fails. * * Use this function if you neither return the promise nor handle a possible error yourself to prevent errors from * going entirely unnoticed. * * @param Promise|ReactPromise $promise Promise to register the handler on. * * @return void * @throws \TypeError If $promise is not an instance of \Amp\Promise or \React\Promise\PromiseInterface. * */ function rethrow($promise) { if (!$promise instanceof Promise) { if ($promise instanceof ReactPromise) { $promise = adapt($promise); } else { throw createTypeError([Promise::class, ReactPromise::class], $promise); } } $promise->onResolve(static function ($exception) { if ($exception) { throw $exception; } }); } /** * Runs the event loop until the promise is resolved. Should not be called within a running event loop. * * Use this function only in synchronous contexts to wait for an asynchronous operation. Use coroutines and yield to * await promise resolution in a fully asynchronous application instead. * * @template TPromise * @template T as Promise|ReactPromise * * @param Promise|ReactPromise $promise Promise to wait for. * * @return mixed Promise success value. * * @psalm-param T $promise * @psalm-return (T is Promise ? TPromise : mixed) * * @throws \TypeError If $promise is not an instance of \Amp\Promise or \React\Promise\PromiseInterface. * @throws \Error If the event loop stopped without the $promise being resolved. * @throws \Throwable Promise failure reason. */ function wait($promise) { if (!$promise instanceof Promise) { if ($promise instanceof ReactPromise) { $promise = adapt($promise); } else { throw createTypeError([Promise::class, ReactPromise::class], $promise); } } $resolved = false; try { Loop::run(function () use (&$resolved, &$value, &$exception, $promise) { $promise->onResolve(function ($e, $v) use (&$resolved, &$value, &$exception) { Loop::stop(); $resolved = true; $exception = $e; $value = $v; }); }); } catch (\Throwable $throwable) { throw new \Error("Loop exceptionally stopped without resolving the promise", 0, $throwable); } if (!$resolved) { throw new \Error("Loop stopped without resolving the promise"); } if ($exception) { throw $exception; } return $value; } /** * Creates an artificial timeout for any `Promise`. * * If the timeout expires before the promise is resolved, the returned promise fails with an instance of * `Amp\TimeoutException`. * * @template TReturn * * @param Promise|ReactPromise $promise Promise to which the timeout is applied. * @param int $timeout Timeout in milliseconds. * * @return Promise * * @throws \TypeError If $promise is not an instance of \Amp\Promise or \React\Promise\PromiseInterface. */ function timeout($promise, int $timeout): Promise { if (!$promise instanceof Promise) { if ($promise instanceof ReactPromise) { $promise = adapt($promise); } else { throw createTypeError([Promise::class, ReactPromise::class], $promise); } } $deferred = new Deferred; $watcher = Loop::delay($timeout, static function () use (&$deferred) { $temp = $deferred; // prevent double resolve $deferred = null; $temp->fail(new TimeoutException); }); Loop::unreference($watcher); $promise->onResolve(function () use (&$deferred, $promise, $watcher) { if ($deferred !== null) { Loop::cancel($watcher); $deferred->resolve($promise); } }); return $deferred->promise(); } /** * Creates an artificial timeout for any `Promise`. * * If the promise is resolved before the timeout expires, the result is returned * * If the timeout expires before the promise is resolved, a default value is returned * * @template TReturn * * @param Promise|ReactPromise $promise Promise to which the timeout is applied. * @param int $timeout Timeout in milliseconds. * @param TReturn $default * * @return Promise * * @throws \TypeError If $promise is not an instance of \Amp\Promise or \React\Promise\PromiseInterface. */ function timeoutWithDefault($promise, int $timeout, $default = null): Promise { $promise = timeout($promise, $timeout); return call(static function () use ($promise, $default) { try { return yield $promise; } catch (TimeoutException $exception) { return $default; } }); } /** * Adapts any object with a done(callable $onFulfilled, callable $onRejected) or then(callable $onFulfilled, * callable $onRejected) method to a promise usable by components depending on placeholders implementing * \AsyncInterop\Promise. * * @param object $promise Object with a done() or then() method. * * @return Promise Promise resolved by the $thenable object. * * @throws \Error If the provided object does not have a then() method. */ function adapt($promise): Promise { if (!\is_object($promise)) { throw new \Error("Object must be provided"); } $deferred = new Deferred; if (\method_exists($promise, 'done')) { $promise->done([$deferred, 'resolve'], [$deferred, 'fail']); } elseif (\method_exists($promise, 'then')) { $promise->then([$deferred, 'resolve'], [$deferred, 'fail']); } else { throw new \Error("Object must have a 'then' or 'done' method"); } return $deferred->promise(); } /** * Returns a promise that is resolved when all promises are resolved. The returned promise will not fail. * Returned promise succeeds with a two-item array delineating successful and failed promise results, * with keys identical and corresponding to the original given array. * * This function is the same as some() with the notable exception that it will never fail even * if all promises in the array resolve unsuccessfully. * * @template TValue * * @param Promise[]|ReactPromise[] $promises * * @return Promise * * @throws \Error If a non-Promise is in the array. */ function any(array $promises): Promise { return some($promises, 0); } /** * Returns a promise that succeeds when all promises succeed, and fails if any promise fails. Returned * promise succeeds with an array of values used to succeed each contained promise, with keys corresponding to * the array of promises. * * @param Promise[]|ReactPromise[] $promises Array of only promises. * * @return Promise * * @throws \Error If a non-Promise is in the array. * * @template TValue * * @psalm-param array|ReactPromise> $promises * @psalm-assert array|ReactPromise> $promises $promises * @psalm-return Promise> */ function all(array $promises): Promise { if (empty($promises)) { return new Success([]); } $deferred = new Deferred; $result = $deferred->promise(); $pending = \count($promises); $values = []; foreach ($promises as $key => $promise) { if ($promise instanceof ReactPromise) { $promise = adapt($promise); } elseif (!$promise instanceof Promise) { throw createTypeError([Promise::class, ReactPromise::class], $promise); } $values[$key] = null; // add entry to array to preserve order $promise->onResolve(function ($exception, $value) use (&$deferred, &$values, &$pending, $key) { if ($pending === 0) { return; } if ($exception) { $pending = 0; $deferred->fail($exception); $deferred = null; return; } $values[$key] = $value; if (0 === --$pending) { $deferred->resolve($values); } }); } return $result; } /** * Returns a promise that succeeds when the first promise succeeds, and fails only if all promises fail. * * @template TValue * * @param Promise[]|ReactPromise[] $promises Array of only promises. * * @return Promise * * @throws \Error If the array is empty or a non-Promise is in the array. */ function first(array $promises): Promise { if (empty($promises)) { throw new \Error("No promises provided"); } $deferred = new Deferred; $result = $deferred->promise(); $pending = \count($promises); $exceptions = []; foreach ($promises as $key => $promise) { if ($promise instanceof ReactPromise) { $promise = adapt($promise); } elseif (!$promise instanceof Promise) { throw createTypeError([Promise::class, ReactPromise::class], $promise); } $exceptions[$key] = null; // add entry to array to preserve order $promise->onResolve(function ($error, $value) use (&$deferred, &$exceptions, &$pending, $key) { if ($pending === 0) { return; } if (!$error) { $pending = 0; $deferred->resolve($value); $deferred = null; return; } $exceptions[$key] = $error; if (0 === --$pending) { $deferred->fail(new MultiReasonException($exceptions)); } }); } return $result; } /** * Resolves with a two-item array delineating successful and failed Promise results. * * The returned promise will only fail if the given number of required promises fail. * * @template TValue * * @param Promise[]|ReactPromise[] $promises Array of only promises. * @param int $required Number of promises that must succeed for the * returned promise to succeed. * * @return Promise * * @throws \Error If a non-Promise is in the array. */ function some(array $promises, int $required = 1): Promise { if ($required < 0) { throw new \Error("Number of promises required must be non-negative"); } $pending = \count($promises); if ($required > $pending) { throw new \Error("Too few promises provided"); } if (empty($promises)) { return new Success([[], []]); } $deferred = new Deferred; $result = $deferred->promise(); $values = []; $exceptions = []; foreach ($promises as $key => $promise) { if ($promise instanceof ReactPromise) { $promise = adapt($promise); } elseif (!$promise instanceof Promise) { throw createTypeError([Promise::class, ReactPromise::class], $promise); } $values[$key] = $exceptions[$key] = null; // add entry to arrays to preserve order $promise->onResolve(static function ($exception, $value) use ( &$values, &$exceptions, &$pending, $key, $required, $deferred ) { if ($exception) { $exceptions[$key] = $exception; unset($values[$key]); } else { $values[$key] = $value; unset($exceptions[$key]); } if (0 === --$pending) { if (\count($values) < $required) { $deferred->fail(new MultiReasonException($exceptions)); } else { $deferred->resolve([$exceptions, $values]); } } }); } return $result; } /** * Wraps a promise into another promise, altering the exception or result. * * @param Promise|ReactPromise $promise * @param callable $callback * * @return Promise */ function wrap($promise, callable $callback): Promise { if ($promise instanceof ReactPromise) { $promise = adapt($promise); } elseif (!$promise instanceof Promise) { throw createTypeError([Promise::class, ReactPromise::class], $promise); } $deferred = new Deferred(); $promise->onResolve(static function (\Throwable $exception = null, $result) use ($deferred, $callback) { try { $result = $callback($exception, $result); } catch (\Throwable $exception) { $deferred->fail($exception); return; } $deferred->resolve($result); }); return $deferred->promise(); } } namespace Amp\Iterator { use Amp\Delayed; use Amp\Emitter; use Amp\Iterator; use Amp\Producer; use Amp\Promise; use function Amp\call; use function Amp\coroutine; use function Amp\Internal\createTypeError; /** * Creates an iterator from the given iterable, emitting the each value. The iterable may contain promises. If any * promise fails, the iterator will fail with the same reason. * * @param array|\Traversable $iterable Elements to emit. * @param int $delay Delay between element emissions in milliseconds. * * @return Iterator * * @throws \TypeError If the argument is not an array or instance of \Traversable. */ function fromIterable(/* iterable */ $iterable, int $delay = 0 ): Iterator { if (!$iterable instanceof \Traversable && !\is_array($iterable)) { throw createTypeError(["array", "Traversable"], $iterable); } if ($delay) { return new Producer(static function (callable $emit) use ($iterable, $delay) { foreach ($iterable as $value) { yield new Delayed($delay); yield $emit($value); } }); } return new Producer(static function (callable $emit) use ($iterable) { foreach ($iterable as $value) { yield $emit($value); } }); } /** * @template TValue * @template TReturn * * @param Iterator $iterator * @param callable (TValue $value): TReturn $onEmit * * @return Iterator */ function map(Iterator $iterator, callable $onEmit): Iterator { return new Producer(static function (callable $emit) use ($iterator, $onEmit) { while (yield $iterator->advance()) { yield $emit($onEmit($iterator->getCurrent())); } }); } /** * @template TValue * * @param Iterator $iterator * @param callable(TValue $value):bool $filter * * @return Iterator */ function filter(Iterator $iterator, callable $filter): Iterator { return new Producer(static function (callable $emit) use ($iterator, $filter) { while (yield $iterator->advance()) { if ($filter($iterator->getCurrent())) { yield $emit($iterator->getCurrent()); } } }); } /** * Creates an iterator that emits values emitted from any iterator in the array of iterators. * * @param Iterator[] $iterators * * @return Iterator */ function merge(array $iterators): Iterator { $emitter = new Emitter; $result = $emitter->iterate(); $coroutine = coroutine(static function (Iterator $iterator) use (&$emitter) { while ((yield $iterator->advance()) && $emitter !== null) { yield $emitter->emit($iterator->getCurrent()); } }); $coroutines = []; foreach ($iterators as $iterator) { if (!$iterator instanceof Iterator) { throw createTypeError([Iterator::class], $iterator); } $coroutines[] = $coroutine($iterator); } Promise\all($coroutines)->onResolve(static function ($exception) use (&$emitter) { if ($exception) { $emitter->fail($exception); $emitter = null; } else { $emitter->complete(); } }); return $result; } /** * Concatenates the given iterators into a single iterator, emitting values from a single iterator at a time. The * prior iterator must complete before values are emitted from any subsequent iterators. Iterators are concatenated * in the order given (iteration order of the array). * * @param Iterator[] $iterators * * @return Iterator */ function concat(array $iterators): Iterator { foreach ($iterators as $iterator) { if (!$iterator instanceof Iterator) { throw createTypeError([Iterator::class], $iterator); } } $emitter = new Emitter; $previous = []; $promise = Promise\all($previous); $coroutine = coroutine(static function (Iterator $iterator, callable $emit) { while (yield $iterator->advance()) { yield $emit($iterator->getCurrent()); } }); foreach ($iterators as $iterator) { $emit = coroutine(static function ($value) use ($emitter, $promise) { static $pending = true, $failed = false; if ($failed) { return; } if ($pending) { try { yield $promise; $pending = false; } catch (\Throwable $exception) { $failed = true; return; // Prior iterator failed. } } yield $emitter->emit($value); }); $previous[] = $coroutine($iterator, $emit); $promise = Promise\all($previous); } $promise->onResolve(static function ($exception) use ($emitter) { if ($exception) { $emitter->fail($exception); return; } $emitter->complete(); }); return $emitter->iterate(); } /** * Discards all remaining items and returns the number of discarded items. * * @template TValue * * @param Iterator $iterator * * @return Promise * * @psalm-param Iterator $iterator * @psalm-return Promise */ function discard(Iterator $iterator): Promise { return call(static function () use ($iterator): \Generator { $count = 0; while (yield $iterator->advance()) { $count++; } return $count; }); } /** * Collects all items from an iterator into an array. * * @template TValue * * @param Iterator $iterator * * @psalm-param Iterator $iterator * * @return Promise * @psalm-return Promise> */ function toArray(Iterator $iterator): Promise { return call(static function () use ($iterator) { /** @psalm-var list $array */ $array = []; while (yield $iterator->advance()) { $array[] = $iterator->getCurrent(); } return $array; }); } } throwIfRequested(); * } * ``` * * potentially multiple times, it allows writing * * ```php * $token = $token ?? new NullCancellationToken; * * // ... * * $token->throwIfRequested(); * ``` * * instead. */ final class NullCancellationToken implements CancellationToken { /** @inheritdoc */ public function subscribe(callable $callback): string { return "null-token"; } /** @inheritdoc */ public function unsubscribe(string $id) { // nothing to do } /** @inheritdoc */ public function isRequested(): bool { return false; } /** @inheritdoc */ public function throwIfRequested() { // nothing to do } } */ final class Producer implements Iterator { /** * @use Internal\Producer */ use CallableMaker, Internal\Producer; /** * @param callable(callable(TValue):Promise):\Generator $producer * * @throws \Error Thrown if the callable does not return a Generator. */ public function __construct(callable $producer) { $result = $producer($this->callableFromInstanceMethod("emit")); if (!$result instanceof \Generator) { throw new \Error("The callable did not return a Generator"); } $coroutine = new Coroutine($result); $coroutine->onResolve(function ($exception) { if ($this->complete) { return; } if ($exception) { $this->fail($exception); return; } $this->complete(); }); } } watcherId = $watcherId; parent::__construct($message); } /** * @return string The watcher identifier. */ public function getWatcherId() { return $this->watcherId; } } handle = \uv_loop_new(); /** * @param $event * @param $status * @param $events * @param $resource * * @return void */ $this->ioCallback = function ($event, $status, $events, $resource) { $watchers = $this->watchers[(int) $event]; switch ($status) { case 0: // OK break; default: // Invoke the callback on errors, as this matches behavior with other loop back-ends. // Re-enable watcher as libuv disables the watcher on non-zero status. $flags = 0; foreach ($watchers as $watcher) { $flags |= $watcher->enabled ? $watcher->type : 0; } \uv_poll_start($event, $flags, $this->ioCallback); break; } foreach ($watchers as $watcher) { // $events is OR'ed with 4 to trigger watcher if no events are indicated (0) or on UV_DISCONNECT (4). // http://docs.libuv.org/en/v1.x/poll.html if (!($watcher->enabled && ($watcher->type & $events || ($events | 4) === 4))) { continue; } try { $result = ($watcher->callback)($watcher->id, $resource, $watcher->data); if ($result === null) { continue; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } } }; /** * @param $event * * @return void */ $this->timerCallback = function ($event) { $watcher = $this->watchers[(int) $event][0]; if ($watcher->type & Watcher::DELAY) { unset($this->events[$watcher->id], $this->watchers[(int) $event]); // Avoid call to uv_is_active(). $this->cancel($watcher->id); // Remove reference to watcher in parent. } elseif ($watcher->value === 0) { // Disable and re-enable so it's not executed repeatedly in the same tick // See https://github.com/amphp/amp/issues/131 $this->disable($watcher->id); $this->enable($watcher->id); } try { $result = ($watcher->callback)($watcher->id, $watcher->data); if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } }; /** * @param $event * @param $signo * * @return void */ $this->signalCallback = function ($event, $signo) { $watcher = $this->watchers[(int) $event][0]; try { $result = ($watcher->callback)($watcher->id, $signo, $watcher->data); if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } }; } /** * {@inheritdoc} */ public function cancel(string $watcherId) { parent::cancel($watcherId); if (!isset($this->events[$watcherId])) { return; } $event = $this->events[$watcherId]; $eventId = (int) $event; if (isset($this->watchers[$eventId][0])) { // All except IO watchers. unset($this->watchers[$eventId]); } elseif (isset($this->watchers[$eventId][$watcherId])) { $watcher = $this->watchers[$eventId][$watcherId]; unset($this->watchers[$eventId][$watcherId]); if (empty($this->watchers[$eventId])) { unset($this->watchers[$eventId], $this->streams[(int) $watcher->value]); } } unset($this->events[$watcherId]); } public static function isSupported(): bool { return \extension_loaded("uv"); } /** * {@inheritdoc} */ public function now(): int { \uv_update_time($this->handle); /** @psalm-suppress TooManyArguments */ return \uv_now($this->handle); } /** * {@inheritdoc} */ public function getHandle() { return $this->handle; } /** * {@inheritdoc} * * @return void */ protected function dispatch(bool $blocking) { /** @psalm-suppress TooManyArguments */ \uv_run($this->handle, $blocking ? \UV::RUN_ONCE : \UV::RUN_NOWAIT); } /** * {@inheritdoc} * * @return void */ protected function activate(array $watchers) { $now = $this->now(); foreach ($watchers as $watcher) { $id = $watcher->id; switch ($watcher->type) { case Watcher::READABLE: case Watcher::WRITABLE: \assert(\is_resource($watcher->value)); $streamId = (int) $watcher->value; if (isset($this->streams[$streamId])) { $event = $this->streams[$streamId]; } elseif (isset($this->events[$id])) { $event = $this->streams[$streamId] = $this->events[$id]; } else { /** @psalm-suppress UndefinedFunction */ $event = $this->streams[$streamId] = \uv_poll_init_socket($this->handle, $watcher->value); } $eventId = (int) $event; $this->events[$id] = $event; $this->watchers[$eventId][$id] = $watcher; $flags = 0; foreach ($this->watchers[$eventId] as $w) { $flags |= $w->enabled ? $w->type : 0; } \uv_poll_start($event, $flags, $this->ioCallback); break; case Watcher::DELAY: case Watcher::REPEAT: \assert(\is_int($watcher->value)); if (isset($this->events[$id])) { $event = $this->events[$id]; } else { $event = $this->events[$id] = \uv_timer_init($this->handle); } $this->watchers[(int) $event] = [$watcher]; \uv_timer_start( $event, \max(0, $watcher->expiration - $now), ($watcher->type & Watcher::REPEAT) ? $watcher->value : 0, $this->timerCallback ); break; case Watcher::SIGNAL: \assert(\is_int($watcher->value)); if (isset($this->events[$id])) { $event = $this->events[$id]; } else { /** @psalm-suppress UndefinedFunction */ $event = $this->events[$id] = \uv_signal_init($this->handle); } $this->watchers[(int) $event] = [$watcher]; /** @psalm-suppress UndefinedFunction */ \uv_signal_start($event, $this->signalCallback, $watcher->value); break; default: // @codeCoverageIgnoreStart throw new \Error("Unknown watcher type"); // @codeCoverageIgnoreEnd } } } /** * {@inheritdoc} * * @return void */ protected function deactivate(Watcher $watcher) { $id = $watcher->id; if (!isset($this->events[$id])) { return; } $event = $this->events[$id]; if (!\uv_is_active($event)) { return; } switch ($watcher->type) { case Watcher::READABLE: case Watcher::WRITABLE: $flags = 0; foreach ($this->watchers[(int) $event] as $w) { $flags |= $w->enabled ? $w->type : 0; } if ($flags) { \uv_poll_start($event, $flags, $this->ioCallback); } else { \uv_poll_stop($event); } break; case Watcher::DELAY: case Watcher::REPEAT: \uv_timer_stop($event); break; case Watcher::SIGNAL: \uv_signal_stop($event); break; default: // @codeCoverageIgnoreStart throw new \Error("Unknown watcher type"); // @codeCoverageIgnoreEnd } } } timerQueue = new Internal\TimerQueue; $this->signalHandling = \extension_loaded("pcntl"); $this->nowOffset = getCurrentTime(); $this->now = \random_int(0, $this->nowOffset); $this->nowOffset -= $this->now; $this->streamSelectErrorHandler = function ($errno, $message) { // Casing changed in PHP 8 from 'unable' to 'Unable' if (\stripos($message, "stream_select(): unable to select [4]: ") === 0) { // EINTR $this->streamSelectIgnoreResult = true; return; } if (\strpos($message, 'FD_SETSIZE') !== false) { $message = \str_replace(["\r\n", "\n", "\r"], " ", $message); $pattern = '(stream_select\(\): You MUST recompile PHP with a larger value of FD_SETSIZE. It is set to (\d+), but you have descriptors numbered at least as high as (\d+)\.)'; if (\preg_match($pattern, $message, $match)) { $helpLink = 'https://amphp.org/amp/event-loop/#implementations'; $message = 'You have reached the limits of stream_select(). It has a FD_SETSIZE of ' . $match[1] . ', but you have file descriptors numbered at least as high as ' . $match[2] . '. ' . "You can install one of the extensions listed on {$helpLink} to support a higher number of " . "concurrent file descriptors. If a large number of open file descriptors is unexpected, you " . "might be leaking file descriptors that aren't closed correctly."; } } throw new \Exception($message, $errno); }; } /** * {@inheritdoc} * * @throws \Amp\Loop\UnsupportedFeatureException If the pcntl extension is not available. */ public function onSignal(int $signo, callable $callback, $data = null): string { if (!$this->signalHandling) { throw new UnsupportedFeatureException("Signal handling requires the pcntl extension"); } return parent::onSignal($signo, $callback, $data); } /** * {@inheritdoc} */ public function now(): int { $this->now = getCurrentTime() - $this->nowOffset; return $this->now; } /** * {@inheritdoc} */ public function getHandle() { return null; } /** * @param bool $blocking * * @return void * * @throws \Throwable */ protected function dispatch(bool $blocking) { $this->selectStreams( $this->readStreams, $this->writeStreams, $blocking ? $this->getTimeout() : 0 ); $now = $this->now(); while ($watcher = $this->timerQueue->extract($now)) { if ($watcher->type & Watcher::REPEAT) { $watcher->enabled = false; // Trick base class into adding to enable queue when calling enable() $this->enable($watcher->id); } else { $this->cancel($watcher->id); } try { // Execute the timer. $result = ($watcher->callback)($watcher->id, $watcher->data); if ($result === null) { continue; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } } if ($this->signalHandling) { \pcntl_signal_dispatch(); } } /** * {@inheritdoc} * * @return void */ protected function activate(array $watchers) { foreach ($watchers as $watcher) { switch ($watcher->type) { case Watcher::READABLE: \assert(\is_resource($watcher->value)); $streamId = (int) $watcher->value; $this->readWatchers[$streamId][$watcher->id] = $watcher; $this->readStreams[$streamId] = $watcher->value; break; case Watcher::WRITABLE: \assert(\is_resource($watcher->value)); $streamId = (int) $watcher->value; $this->writeWatchers[$streamId][$watcher->id] = $watcher; $this->writeStreams[$streamId] = $watcher->value; break; case Watcher::DELAY: case Watcher::REPEAT: \assert(\is_int($watcher->value)); $this->timerQueue->insert($watcher); break; case Watcher::SIGNAL: \assert(\is_int($watcher->value)); if (!isset($this->signalWatchers[$watcher->value])) { if (!@\pcntl_signal($watcher->value, $this->callableFromInstanceMethod('handleSignal'))) { $message = "Failed to register signal handler"; if ($error = \error_get_last()) { $message .= \sprintf("; Errno: %d; %s", $error["type"], $error["message"]); } throw new \Error($message); } } $this->signalWatchers[$watcher->value][$watcher->id] = $watcher; break; default: // @codeCoverageIgnoreStart throw new \Error("Unknown watcher type"); // @codeCoverageIgnoreEnd } } } /** * {@inheritdoc} * * @return void */ protected function deactivate(Watcher $watcher) { switch ($watcher->type) { case Watcher::READABLE: $streamId = (int) $watcher->value; unset($this->readWatchers[$streamId][$watcher->id]); if (empty($this->readWatchers[$streamId])) { unset($this->readWatchers[$streamId], $this->readStreams[$streamId]); } break; case Watcher::WRITABLE: $streamId = (int) $watcher->value; unset($this->writeWatchers[$streamId][$watcher->id]); if (empty($this->writeWatchers[$streamId])) { unset($this->writeWatchers[$streamId], $this->writeStreams[$streamId]); } break; case Watcher::DELAY: case Watcher::REPEAT: $this->timerQueue->remove($watcher); break; case Watcher::SIGNAL: \assert(\is_int($watcher->value)); if (isset($this->signalWatchers[$watcher->value])) { unset($this->signalWatchers[$watcher->value][$watcher->id]); if (empty($this->signalWatchers[$watcher->value])) { unset($this->signalWatchers[$watcher->value]); @\pcntl_signal($watcher->value, \SIG_DFL); } } break; default: // @codeCoverageIgnoreStart throw new \Error("Unknown watcher type"); // @codeCoverageIgnoreEnd } } /** * @param resource[] $read * @param resource[] $write * @param int $timeout * * @return void */ private function selectStreams(array $read, array $write, int $timeout) { $timeout /= self::MILLISEC_PER_SEC; if (!empty($read) || !empty($write)) { // Use stream_select() if there are any streams in the loop. if ($timeout >= 0) { $seconds = (int) $timeout; $microseconds = (int) (($timeout - $seconds) * self::MICROSEC_PER_SEC); } else { $seconds = null; $microseconds = null; } // Failed connection attempts are indicated via except on Windows // @link https://github.com/reactphp/event-loop/blob/8bd064ce23c26c4decf186c2a5a818c9a8209eb0/src/StreamSelectLoop.php#L279-L287 // @link https://docs.microsoft.com/de-de/windows/win32/api/winsock2/nf-winsock2-select $except = null; if (\DIRECTORY_SEPARATOR === '\\') { $except = $write; } \set_error_handler($this->streamSelectErrorHandler); try { $result = \stream_select($read, $write, $except, $seconds, $microseconds); } finally { \restore_error_handler(); } if ($this->streamSelectIgnoreResult || $result === 0) { $this->streamSelectIgnoreResult = false; return; } if (!$result) { $this->error(new \Exception('Unknown error during stream_select')); return; } foreach ($read as $stream) { $streamId = (int) $stream; if (!isset($this->readWatchers[$streamId])) { continue; // All read watchers disabled. } foreach ($this->readWatchers[$streamId] as $watcher) { if (!isset($this->readWatchers[$streamId][$watcher->id])) { continue; // Watcher disabled by another IO watcher. } try { $result = ($watcher->callback)($watcher->id, $stream, $watcher->data); if ($result === null) { continue; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } } } \assert(\is_array($write)); // See https://github.com/vimeo/psalm/issues/3036 if ($except) { foreach ($except as $key => $socket) { $write[$key] = $socket; } } foreach ($write as $stream) { $streamId = (int) $stream; if (!isset($this->writeWatchers[$streamId])) { continue; // All write watchers disabled. } foreach ($this->writeWatchers[$streamId] as $watcher) { if (!isset($this->writeWatchers[$streamId][$watcher->id])) { continue; // Watcher disabled by another IO watcher. } try { $result = ($watcher->callback)($watcher->id, $stream, $watcher->data); if ($result === null) { continue; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } } } return; } if ($timeout < 0) { // Only signal watchers are enabled, so sleep indefinitely. \usleep(\PHP_INT_MAX); return; } if ($timeout > 0) { // Sleep until next timer expires. \usleep((int) ($timeout * self::MICROSEC_PER_SEC)); } } /** * @return int Milliseconds until next timer expires or -1 if there are no pending times. */ private function getTimeout(): int { $expiration = $this->timerQueue->peek(); if ($expiration === null) { return -1; } $expiration -= getCurrentTime() - $this->nowOffset; return $expiration > 0 ? $expiration : 0; } /** * @param int $signo * * @return void */ private function handleSignal(int $signo) { foreach ($this->signalWatchers[$signo] as $watcher) { if (!isset($this->signalWatchers[$signo][$watcher->id])) { continue; } try { $result = ($watcher->callback)($watcher->id, $signo, $watcher->data); if ($result === null) { continue; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } } } } driver = $driver; } public function run() { $this->driver->run(); } public function stop() { $this->driver->stop(); } public function defer(callable $callback, $data = null): string { $id = $this->driver->defer(function (...$args) use ($callback) { $this->cancel($args[0]); return $callback(...$args); }, $data); $this->creationTraces[$id] = formatStacktrace(\debug_backtrace(\DEBUG_BACKTRACE_IGNORE_ARGS)); $this->enabledWatchers[$id] = true; return $id; } public function delay(int $delay, callable $callback, $data = null): string { $id = $this->driver->delay($delay, function (...$args) use ($callback) { $this->cancel($args[0]); return $callback(...$args); }, $data); $this->creationTraces[$id] = formatStacktrace(\debug_backtrace(\DEBUG_BACKTRACE_IGNORE_ARGS)); $this->enabledWatchers[$id] = true; return $id; } public function repeat(int $interval, callable $callback, $data = null): string { $id = $this->driver->repeat($interval, $callback, $data); $this->creationTraces[$id] = formatStacktrace(\debug_backtrace(\DEBUG_BACKTRACE_IGNORE_ARGS)); $this->enabledWatchers[$id] = true; return $id; } public function onReadable($stream, callable $callback, $data = null): string { $id = $this->driver->onReadable($stream, $callback, $data); $this->creationTraces[$id] = formatStacktrace(\debug_backtrace(\DEBUG_BACKTRACE_IGNORE_ARGS)); $this->enabledWatchers[$id] = true; return $id; } public function onWritable($stream, callable $callback, $data = null): string { $id = $this->driver->onWritable($stream, $callback, $data); $this->creationTraces[$id] = formatStacktrace(\debug_backtrace(\DEBUG_BACKTRACE_IGNORE_ARGS)); $this->enabledWatchers[$id] = true; return $id; } public function onSignal(int $signo, callable $callback, $data = null): string { $id = $this->driver->onSignal($signo, $callback, $data); $this->creationTraces[$id] = formatStacktrace(\debug_backtrace(\DEBUG_BACKTRACE_IGNORE_ARGS)); $this->enabledWatchers[$id] = true; return $id; } public function enable(string $watcherId) { try { $this->driver->enable($watcherId); $this->enabledWatchers[$watcherId] = true; } catch (InvalidWatcherError $e) { throw new InvalidWatcherError( $watcherId, $e->getMessage() . "\r\n\r\n" . $this->getTraces($watcherId) ); } } public function cancel(string $watcherId) { $this->driver->cancel($watcherId); if (!isset($this->cancelTraces[$watcherId])) { $this->cancelTraces[$watcherId] = formatStacktrace(\debug_backtrace(\DEBUG_BACKTRACE_IGNORE_ARGS)); } unset($this->enabledWatchers[$watcherId], $this->unreferencedWatchers[$watcherId]); } public function disable(string $watcherId) { $this->driver->disable($watcherId); unset($this->enabledWatchers[$watcherId]); } public function reference(string $watcherId) { try { $this->driver->reference($watcherId); unset($this->unreferencedWatchers[$watcherId]); } catch (InvalidWatcherError $e) { throw new InvalidWatcherError( $watcherId, $e->getMessage() . "\r\n\r\n" . $this->getTraces($watcherId) ); } } public function unreference(string $watcherId) { $this->driver->unreference($watcherId); $this->unreferencedWatchers[$watcherId] = true; } public function setErrorHandler(callable $callback = null) { return $this->driver->setErrorHandler($callback); } /** @inheritdoc */ public function getHandle() { $this->driver->getHandle(); } public function dump(): string { $dump = "Enabled, referenced watchers keeping the loop running: "; foreach ($this->enabledWatchers as $watcher => $_) { if (isset($this->unreferencedWatchers[$watcher])) { continue; } $dump .= "Watcher ID: " . $watcher . "\r\n"; $dump .= $this->getCreationTrace($watcher); $dump .= "\r\n\r\n"; } return \rtrim($dump); } public function getInfo(): array { return $this->driver->getInfo(); } public function __debugInfo() { return $this->driver->__debugInfo(); } public function now(): int { return $this->driver->now(); } protected function error(\Throwable $exception) { $this->driver->error($exception); } /** * @inheritdoc * * @return void */ protected function activate(array $watchers) { // nothing to do in a decorator } /** * @inheritdoc * * @return void */ protected function dispatch(bool $blocking) { // nothing to do in a decorator } /** * @inheritdoc * * @return void */ protected function deactivate(Watcher $watcher) { // nothing to do in a decorator } private function getTraces(string $watcherId): string { return "Creation Trace:\r\n" . $this->getCreationTrace($watcherId) . "\r\n\r\n" . "Cancellation Trace:\r\n" . $this->getCancelTrace($watcherId); } private function getCreationTrace(string $watcher): string { if (!isset($this->creationTraces[$watcher])) { return 'No creation trace, yet.'; } return $this->creationTraces[$watcher]; } private function getCancelTrace(string $watcher): string { if (!isset($this->cancelTraces[$watcher])) { return 'No cancellation trace, yet.'; } return $this->cancelTraces[$watcher]; } } handle = new \EvLoop; $this->nowOffset = getCurrentTime(); $this->now = \random_int(0, $this->nowOffset); $this->nowOffset -= $this->now; if (self::$activeSignals === null) { self::$activeSignals = &$this->signals; } /** * @param \EvIO $event * * @return void */ $this->ioCallback = function (\EvIO $event) { /** @var Watcher $watcher */ $watcher = $event->data; try { $result = ($watcher->callback)($watcher->id, $watcher->value, $watcher->data); if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } }; /** * @param \EvTimer $event * * @return void */ $this->timerCallback = function (\EvTimer $event) { /** @var Watcher $watcher */ $watcher = $event->data; if ($watcher->type & Watcher::DELAY) { $this->cancel($watcher->id); } elseif ($watcher->value === 0) { // Disable and re-enable so it's not executed repeatedly in the same tick // See https://github.com/amphp/amp/issues/131 $this->disable($watcher->id); $this->enable($watcher->id); } try { $result = ($watcher->callback)($watcher->id, $watcher->data); if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } }; /** * @param \EvSignal $event * * @return void */ $this->signalCallback = function (\EvSignal $event) { /** @var Watcher $watcher */ $watcher = $event->data; try { $result = ($watcher->callback)($watcher->id, $watcher->value, $watcher->data); if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } }; } /** * {@inheritdoc} */ public function cancel(string $watcherId) { parent::cancel($watcherId); unset($this->events[$watcherId]); } public function __destruct() { foreach ($this->events as $event) { /** @psalm-suppress all */ if ($event !== null) { // Events may have been nulled in extension depending on destruct order. $event->stop(); } } // We need to clear all references to events manually, see // https://bitbucket.org/osmanov/pecl-ev/issues/31/segfault-in-ev_timer_stop $this->events = []; } /** * {@inheritdoc} */ public function run() { $active = self::$activeSignals; \assert($active !== null); foreach ($active as $event) { $event->stop(); } self::$activeSignals = &$this->signals; foreach ($this->signals as $event) { $event->start(); } try { parent::run(); } finally { foreach ($this->signals as $event) { $event->stop(); } self::$activeSignals = &$active; foreach ($active as $event) { $event->start(); } } } /** * {@inheritdoc} */ public function stop() { $this->handle->stop(); parent::stop(); } /** * {@inheritdoc} */ public function now(): int { $this->now = getCurrentTime() - $this->nowOffset; return $this->now; } /** * {@inheritdoc} */ public function getHandle(): \EvLoop { return $this->handle; } /** * {@inheritdoc} * * @return void */ protected function dispatch(bool $blocking) { $this->handle->run($blocking ? \Ev::RUN_ONCE : \Ev::RUN_ONCE | \Ev::RUN_NOWAIT); } /** * {@inheritdoc} * * @return void */ protected function activate(array $watchers) { $this->handle->nowUpdate(); $now = $this->now(); foreach ($watchers as $watcher) { if (!isset($this->events[$id = $watcher->id])) { switch ($watcher->type) { case Watcher::READABLE: \assert(\is_resource($watcher->value)); $this->events[$id] = $this->handle->io($watcher->value, \Ev::READ, $this->ioCallback, $watcher); break; case Watcher::WRITABLE: \assert(\is_resource($watcher->value)); $this->events[$id] = $this->handle->io( $watcher->value, \Ev::WRITE, $this->ioCallback, $watcher ); break; case Watcher::DELAY: case Watcher::REPEAT: \assert(\is_int($watcher->value)); $interval = $watcher->value / self::MILLISEC_PER_SEC; $this->events[$id] = $this->handle->timer( \max(0, ($watcher->expiration - $now) / self::MILLISEC_PER_SEC), ($watcher->type & Watcher::REPEAT) ? $interval : 0, $this->timerCallback, $watcher ); break; case Watcher::SIGNAL: \assert(\is_int($watcher->value)); $this->events[$id] = $this->handle->signal($watcher->value, $this->signalCallback, $watcher); break; default: // @codeCoverageIgnoreStart throw new \Error("Unknown watcher type"); // @codeCoverageIgnoreEnd } } else { $this->events[$id]->start(); } if ($watcher->type === Watcher::SIGNAL) { /** @psalm-suppress PropertyTypeCoercion */ $this->signals[$id] = $this->events[$id]; } } } /** * {@inheritdoc} * * @return void */ protected function deactivate(Watcher $watcher) { if (isset($this->events[$id = $watcher->id])) { $this->events[$id]->stop(); if ($watcher->type === Watcher::SIGNAL) { unset($this->signals[$id]); } } } } createDriverFromEnv()) { return $driver; } if (UvDriver::isSupported()) { return new UvDriver; } if (EvDriver::isSupported()) { return new EvDriver; } if (EventDriver::isSupported()) { return new EventDriver; } return new NativeDriver; })(); if (\getenv("AMP_DEBUG_TRACE_WATCHERS")) { return new TracingDriver($driver); } return $driver; } /** * @return Driver|null */ private function createDriverFromEnv() { $driver = \getenv("AMP_LOOP_DRIVER"); if (!$driver) { return null; } if (!\class_exists($driver)) { throw new \Error(\sprintf( "Driver '%s' does not exist.", $driver )); } if (!\is_subclass_of($driver, Driver::class)) { throw new \Error(\sprintf( "Driver '%s' is not a subclass of '%s'.", $driver, Driver::class )); } return new $driver; } } // @codeCoverageIgnoreEnd requireFeatures(\EventConfig::FEATURE_FDS); } $this->handle = new \EventBase($config); $this->nowOffset = getCurrentTime(); $this->now = \random_int(0, $this->nowOffset); $this->nowOffset -= $this->now; if (self::$activeSignals === null) { self::$activeSignals = &$this->signals; } /** * @param $resource * @param $what * @param Watcher $watcher * * @return void */ $this->ioCallback = function ($resource, $what, Watcher $watcher) { \assert(\is_resource($watcher->value)); try { $result = ($watcher->callback)($watcher->id, $watcher->value, $watcher->data); if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } }; /** * @param $resource * @param $what * @param Watcher $watcher * * @return void */ $this->timerCallback = function ($resource, $what, Watcher $watcher) { \assert(\is_int($watcher->value)); if ($watcher->type & Watcher::DELAY) { $this->cancel($watcher->id); } else { $this->events[$watcher->id]->add($watcher->value / self::MILLISEC_PER_SEC); } try { $result = ($watcher->callback)($watcher->id, $watcher->data); if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } }; /** * @param $signum * @param $what * @param Watcher $watcher * * @return void */ $this->signalCallback = function ($signum, $what, Watcher $watcher) { try { $result = ($watcher->callback)($watcher->id, $watcher->value, $watcher->data); if ($result === null) { return; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } }; } /** * {@inheritdoc} */ public function cancel(string $watcherId) { parent::cancel($watcherId); if (isset($this->events[$watcherId])) { $this->events[$watcherId]->free(); unset($this->events[$watcherId]); } } public static function isSupported(): bool { return \extension_loaded("event"); } /** * @codeCoverageIgnore */ public function __destruct() { // Unset here, otherwise $event->del() in the loop may fail with a warning, because __destruct order isn't defined. // Related https://github.com/amphp/amp/issues/159. $events = $this->events; $this->events = []; foreach ($events as $event) { if ($event !== null) { // Events may have been nulled in extension depending on destruct order. $event->free(); } } // Manually free the loop handle to fully release loop resources. // See https://github.com/amphp/amp/issues/177. if ($this->handle !== null) { $this->handle->free(); $this->handle = null; } } /** * {@inheritdoc} */ public function run() { $active = self::$activeSignals; \assert($active !== null); foreach ($active as $event) { $event->del(); } self::$activeSignals = &$this->signals; foreach ($this->signals as $event) { /** @psalm-suppress TooFewArguments https://github.com/JetBrains/phpstorm-stubs/pull/763 */ $event->add(); } try { parent::run(); } finally { foreach ($this->signals as $event) { $event->del(); } self::$activeSignals = &$active; foreach ($active as $event) { /** @psalm-suppress TooFewArguments https://github.com/JetBrains/phpstorm-stubs/pull/763 */ $event->add(); } } } /** * {@inheritdoc} */ public function stop() { $this->handle->stop(); parent::stop(); } /** * {@inheritdoc} */ public function now(): int { $this->now = getCurrentTime() - $this->nowOffset; return $this->now; } /** * {@inheritdoc} */ public function getHandle(): \EventBase { return $this->handle; } /** * {@inheritdoc} * * @return void */ protected function dispatch(bool $blocking) { $this->handle->loop($blocking ? \EventBase::LOOP_ONCE : \EventBase::LOOP_ONCE | \EventBase::LOOP_NONBLOCK); } /** * {@inheritdoc} * * @return void */ protected function activate(array $watchers) { $now = $this->now(); foreach ($watchers as $watcher) { if (!isset($this->events[$id = $watcher->id])) { switch ($watcher->type) { case Watcher::READABLE: \assert(\is_resource($watcher->value)); $this->events[$id] = new \Event( $this->handle, $watcher->value, \Event::READ | \Event::PERSIST, $this->ioCallback, $watcher ); break; case Watcher::WRITABLE: \assert(\is_resource($watcher->value)); $this->events[$id] = new \Event( $this->handle, $watcher->value, \Event::WRITE | \Event::PERSIST, $this->ioCallback, $watcher ); break; case Watcher::DELAY: case Watcher::REPEAT: \assert(\is_int($watcher->value)); $this->events[$id] = new \Event( $this->handle, -1, \Event::TIMEOUT, $this->timerCallback, $watcher ); break; case Watcher::SIGNAL: \assert(\is_int($watcher->value)); $this->events[$id] = new \Event( $this->handle, $watcher->value, \Event::SIGNAL | \Event::PERSIST, $this->signalCallback, $watcher ); break; default: // @codeCoverageIgnoreStart throw new \Error("Unknown watcher type"); // @codeCoverageIgnoreEnd } } switch ($watcher->type) { case Watcher::DELAY: case Watcher::REPEAT: \assert(\is_int($watcher->value)); $interval = \max(0, $watcher->expiration - $now); $this->events[$id]->add($interval > 0 ? $interval / self::MILLISEC_PER_SEC : 0); break; case Watcher::SIGNAL: $this->signals[$id] = $this->events[$id]; // no break default: /** @psalm-suppress TooFewArguments https://github.com/JetBrains/phpstorm-stubs/pull/763 */ $this->events[$id]->add(); break; } } } /** * {@inheritdoc} * * @return void */ protected function deactivate(Watcher $watcher) { if (isset($this->events[$id = $watcher->id])) { $this->events[$id]->del(); if ($watcher->type === Watcher::SIGNAL) { unset($this->signals[$id]); } } } } data[$node]; while ($node !== 0 && $entry->expiration < $this->data[$parent = ($node - 1) >> 1]->expiration) { $this->swap($node, $parent); $node = $parent; } } /** * @param int $node Rebuild the data array from the given node downward. * * @return void */ private function heapifyDown(int $node) { $length = \count($this->data); while (($child = ($node << 1) + 1) < $length) { if ($this->data[$child]->expiration < $this->data[$node]->expiration && ($child + 1 >= $length || $this->data[$child]->expiration < $this->data[$child + 1]->expiration) ) { // Left child is less than parent and right child. $swap = $child; } elseif ($child + 1 < $length && $this->data[$child + 1]->expiration < $this->data[$node]->expiration) { // Right child is less than parent and left child. $swap = $child + 1; } else { // Left and right child are greater than parent. break; } $this->swap($node, $swap); $node = $swap; } } private function swap(int $left, int $right) { $temp = $this->data[$left]; $this->data[$left] = $this->data[$right]; $this->pointers[$this->data[$right]->id] = $left; $this->data[$right] = $temp; $this->pointers[$temp->id] = $right; } /** * Inserts the watcher into the queue. Time complexity: O(log(n)). * * @param Watcher $watcher * * @psalm-param Watcher $watcher * * @return void */ public function insert(Watcher $watcher) { \assert($watcher->expiration !== null); \assert(!isset($this->pointers[$watcher->id])); $node = \count($this->data); $this->data[$node] = $watcher; $this->pointers[$watcher->id] = $node; $this->heapifyUp($node); } /** * Removes the given watcher from the queue. Time complexity: O(log(n)). * * @param Watcher $watcher * * @psalm-param Watcher $watcher * * @return void */ public function remove(Watcher $watcher) { $id = $watcher->id; if (!isset($this->pointers[$id])) { return; } $this->removeAndRebuild($this->pointers[$id]); } /** * Deletes and returns the Watcher on top of the heap if it has expired, otherwise null is returned. * Time complexity: O(log(n)). * * @param int $now Current loop time. * * @return Watcher|null Expired watcher at the top of the heap or null if the watcher has not expired. * * @psalm-return Watcher|null */ public function extract(int $now) { if (empty($this->data)) { return null; } $watcher = $this->data[0]; if ($watcher->expiration > $now) { return null; } $this->removeAndRebuild(0); return $watcher; } /** * Returns the expiration time value at the top of the heap. Time complexity: O(1). * * @return int|null Expiration time of the watcher at the top of the heap or null if the heap is empty. */ public function peek() { return isset($this->data[0]) ? $this->data[0]->expiration : null; } /** * @param int $node Remove the given node and then rebuild the data array. * * @return void */ private function removeAndRebuild(int $node) { $length = \count($this->data) - 1; $id = $this->data[$node]->id; $left = $this->data[$node] = $this->data[$length]; $this->pointers[$left->id] = $node; unset($this->data[$length], $this->pointers[$id]); if ($node < $length) { // don't need to do anything if we removed the last element $parent = ($node - 1) >> 1; if ($parent >= 0 && $this->data[$node]->expiration < $this->data[$parent]->expiration) { $this->heapifyUp($node); } else { $this->heapifyDown($node); } } } } running = true; try { while ($this->running) { if ($this->isEmpty()) { return; } $this->tick(); } } finally { $this->stop(); } } /** * @return bool True if no enabled and referenced watchers remain in the loop. */ private function isEmpty(): bool { foreach ($this->watchers as $watcher) { if ($watcher->enabled && $watcher->referenced) { return false; } } return true; } /** * Executes a single tick of the event loop. * * @return void */ private function tick() { if (empty($this->deferQueue)) { $this->deferQueue = $this->nextTickQueue; } else { $this->deferQueue = \array_merge($this->deferQueue, $this->nextTickQueue); } $this->nextTickQueue = []; $this->activate($this->enableQueue); $this->enableQueue = []; foreach ($this->deferQueue as $watcher) { if (!isset($this->deferQueue[$watcher->id])) { continue; // Watcher disabled by another defer watcher. } unset($this->watchers[$watcher->id], $this->deferQueue[$watcher->id]); try { /** @var mixed $result */ $result = ($watcher->callback)($watcher->id, $watcher->data); if ($result === null) { continue; } if ($result instanceof \Generator) { $result = new Coroutine($result); } if ($result instanceof Promise || $result instanceof ReactPromise) { rethrow($result); } } catch (\Throwable $exception) { $this->error($exception); } } /** @psalm-suppress RedundantCondition */ $this->dispatch(empty($this->nextTickQueue) && empty($this->enableQueue) && $this->running && !$this->isEmpty()); } /** * Activates (enables) all the given watchers. * * @param Watcher[] $watchers * * @return void */ abstract protected function activate(array $watchers); /** * Dispatches any pending read/write, timer, and signal events. * * @param bool $blocking * * @return void */ abstract protected function dispatch(bool $blocking); /** * Stop the event loop. * * When an event loop is stopped, it continues with its current tick and exits the loop afterwards. Multiple calls * to stop MUST be ignored and MUST NOT raise an exception. * * @return void */ public function stop() { $this->running = false; } /** * Defer the execution of a callback. * * The deferred callable MUST be executed before any other type of watcher in a tick. Order of enabling MUST be * preserved when executing the callbacks. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param callable (string $watcherId, mixed $data) $callback The callback to defer. The `$watcherId` will be * invalidated before the callback call. * @param mixed $data Arbitrary data given to the callback function as the `$data` parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. */ public function defer(callable $callback, $data = null): string { /** @psalm-var Watcher $watcher */ $watcher = new Watcher; $watcher->type = Watcher::DEFER; $watcher->id = $this->nextId++; $watcher->callback = $callback; $watcher->data = $data; $this->watchers[$watcher->id] = $watcher; $this->nextTickQueue[$watcher->id] = $watcher; return $watcher->id; } /** * Delay the execution of a callback. * * The delay is a minimum and approximate, accuracy is not guaranteed. Order of calls MUST be determined by which * timers expire first, but timers with the same expiration time MAY be executed in any order. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param int $delay The amount of time, in milliseconds, to delay the execution for. * @param callable (string $watcherId, mixed $data) $callback The callback to delay. The `$watcherId` will be * invalidated before the callback call. * @param mixed $data Arbitrary data given to the callback function as the `$data` parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. */ public function delay(int $delay, callable $callback, $data = null): string { if ($delay < 0) { throw new \Error("Delay must be greater than or equal to zero"); } /** @psalm-var Watcher $watcher */ $watcher = new Watcher; $watcher->type = Watcher::DELAY; $watcher->id = $this->nextId++; $watcher->callback = $callback; $watcher->value = $delay; $watcher->expiration = $this->now() + $delay; $watcher->data = $data; $this->watchers[$watcher->id] = $watcher; $this->enableQueue[$watcher->id] = $watcher; return $watcher->id; } /** * Repeatedly execute a callback. * * The interval between executions is a minimum and approximate, accuracy is not guaranteed. Order of calls MUST be * determined by which timers expire first, but timers with the same expiration time MAY be executed in any order. * The first execution is scheduled after the first interval period. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param int $interval The time interval, in milliseconds, to wait between executions. * @param callable (string $watcherId, mixed $data) $callback The callback to repeat. * @param mixed $data Arbitrary data given to the callback function as the `$data` parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. */ public function repeat(int $interval, callable $callback, $data = null): string { if ($interval < 0) { throw new \Error("Interval must be greater than or equal to zero"); } /** @psalm-var Watcher $watcher */ $watcher = new Watcher; $watcher->type = Watcher::REPEAT; $watcher->id = $this->nextId++; $watcher->callback = $callback; $watcher->value = $interval; $watcher->expiration = $this->now() + $interval; $watcher->data = $data; $this->watchers[$watcher->id] = $watcher; $this->enableQueue[$watcher->id] = $watcher; return $watcher->id; } /** * Execute a callback when a stream resource becomes readable or is closed for reading. * * Warning: Closing resources locally, e.g. with `fclose`, might not invoke the callback. Be sure to `cancel` the * watcher when closing the resource locally. Drivers MAY choose to notify the user if there are watchers on invalid * resources, but are not required to, due to the high performance impact. Watchers on closed resources are * therefore undefined behavior. * * Multiple watchers on the same stream MAY be executed in any order. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param resource $stream The stream to monitor. * @param callable (string $watcherId, resource $stream, mixed $data) $callback The callback to execute. * @param mixed $data Arbitrary data given to the callback function as the `$data` parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. */ public function onReadable($stream, callable $callback, $data = null): string { /** @psalm-var Watcher $watcher */ $watcher = new Watcher; $watcher->type = Watcher::READABLE; $watcher->id = $this->nextId++; $watcher->callback = $callback; $watcher->value = $stream; $watcher->data = $data; $this->watchers[$watcher->id] = $watcher; $this->enableQueue[$watcher->id] = $watcher; return $watcher->id; } /** * Execute a callback when a stream resource becomes writable or is closed for writing. * * Warning: Closing resources locally, e.g. with `fclose`, might not invoke the callback. Be sure to `cancel` the * watcher when closing the resource locally. Drivers MAY choose to notify the user if there are watchers on invalid * resources, but are not required to, due to the high performance impact. Watchers on closed resources are * therefore undefined behavior. * * Multiple watchers on the same stream MAY be executed in any order. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param resource $stream The stream to monitor. * @param callable (string $watcherId, resource $stream, mixed $data) $callback The callback to execute. * @param mixed $data Arbitrary data given to the callback function as the `$data` parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. */ public function onWritable($stream, callable $callback, $data = null): string { /** @psalm-var Watcher $watcher */ $watcher = new Watcher; $watcher->type = Watcher::WRITABLE; $watcher->id = $this->nextId++; $watcher->callback = $callback; $watcher->value = $stream; $watcher->data = $data; $this->watchers[$watcher->id] = $watcher; $this->enableQueue[$watcher->id] = $watcher; return $watcher->id; } /** * Execute a callback when a signal is received. * * Warning: Installing the same signal on different instances of this interface is deemed undefined behavior. * Implementations MAY try to detect this, if possible, but are not required to. This is due to technical * limitations of the signals being registered globally per process. * * Multiple watchers on the same signal MAY be executed in any order. * * The created watcher MUST immediately be marked as enabled, but only be activated (i.e. callback can be called) * right before the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param int $signo The signal number to monitor. * @param callable (string $watcherId, int $signo, mixed $data) $callback The callback to execute. * @param mixed $data Arbitrary data given to the callback function as the $data parameter. * * @return string An unique identifier that can be used to cancel, enable or disable the watcher. * * @throws UnsupportedFeatureException If signal handling is not supported. */ public function onSignal(int $signo, callable $callback, $data = null): string { /** @psalm-var Watcher $watcher */ $watcher = new Watcher; $watcher->type = Watcher::SIGNAL; $watcher->id = $this->nextId++; $watcher->callback = $callback; $watcher->value = $signo; $watcher->data = $data; $this->watchers[$watcher->id] = $watcher; $this->enableQueue[$watcher->id] = $watcher; return $watcher->id; } /** * Enable a watcher to be active starting in the next tick. * * Watchers MUST immediately be marked as enabled, but only be activated (i.e. callbacks can be called) right before * the next tick. Callbacks of watchers MUST NOT be called in the tick they were enabled. * * @param string $watcherId The watcher identifier. * * @return void * * @throws InvalidWatcherError If the watcher identifier is invalid. */ public function enable(string $watcherId) { if (!isset($this->watchers[$watcherId])) { throw new InvalidWatcherError($watcherId, "Cannot enable an invalid watcher identifier: '{$watcherId}'"); } $watcher = $this->watchers[$watcherId]; if ($watcher->enabled) { return; // Watcher already enabled. } $watcher->enabled = true; switch ($watcher->type) { case Watcher::DEFER: $this->nextTickQueue[$watcher->id] = $watcher; break; case Watcher::REPEAT: case Watcher::DELAY: \assert(\is_int($watcher->value)); $watcher->expiration = $this->now() + $watcher->value; $this->enableQueue[$watcher->id] = $watcher; break; default: $this->enableQueue[$watcher->id] = $watcher; break; } } /** * Cancel a watcher. * * This will detach the event loop from all resources that are associated to the watcher. After this operation the * watcher is permanently invalid. Calling this function MUST NOT fail, even if passed an invalid watcher. * * @param string $watcherId The watcher identifier. * * @return void */ public function cancel(string $watcherId) { $this->disable($watcherId); unset($this->watchers[$watcherId]); } /** * Disable a watcher immediately. * * A watcher MUST be disabled immediately, e.g. if a defer watcher disables a later defer watcher, the second defer * watcher isn't executed in this tick. * * Disabling a watcher MUST NOT invalidate the watcher. Calling this function MUST NOT fail, even if passed an * invalid watcher. * * @param string $watcherId The watcher identifier. * * @return void */ public function disable(string $watcherId) { if (!isset($this->watchers[$watcherId])) { return; } $watcher = $this->watchers[$watcherId]; if (!$watcher->enabled) { return; // Watcher already disabled. } $watcher->enabled = false; $id = $watcher->id; switch ($watcher->type) { case Watcher::DEFER: if (isset($this->nextTickQueue[$id])) { // Watcher was only queued to be enabled. unset($this->nextTickQueue[$id]); } else { unset($this->deferQueue[$id]); } break; default: if (isset($this->enableQueue[$id])) { // Watcher was only queued to be enabled. unset($this->enableQueue[$id]); } else { $this->deactivate($watcher); } break; } } /** * Deactivates (disables) the given watcher. * * @param Watcher $watcher * * @return void */ abstract protected function deactivate(Watcher $watcher); /** * Reference a watcher. * * This will keep the event loop alive whilst the watcher is still being monitored. Watchers have this state by * default. * * @param string $watcherId The watcher identifier. * * @return void * * @throws InvalidWatcherError If the watcher identifier is invalid. */ public function reference(string $watcherId) { if (!isset($this->watchers[$watcherId])) { throw new InvalidWatcherError($watcherId, "Cannot reference an invalid watcher identifier: '{$watcherId}'"); } $this->watchers[$watcherId]->referenced = true; } /** * Unreference a watcher. * * The event loop should exit the run method when only unreferenced watchers are still being monitored. Watchers * are all referenced by default. * * @param string $watcherId The watcher identifier. * * @return void */ public function unreference(string $watcherId) { if (!isset($this->watchers[$watcherId])) { return; } $this->watchers[$watcherId]->referenced = false; } /** * Stores information in the loop bound registry. * * Stored information is package private. Packages MUST NOT retrieve the stored state of other packages. Packages * MUST use their namespace as prefix for keys. They may do so by using `SomeClass::class` as key. * * If packages want to expose loop bound state to consumers other than the package, they SHOULD provide a dedicated * interface for that purpose instead of sharing the storage key. * * @param string $key The namespaced storage key. * @param mixed $value The value to be stored. * * @return void */ final public function setState(string $key, $value) { if ($value === null) { unset($this->registry[$key]); } else { $this->registry[$key] = $value; } } /** * Gets information stored bound to the loop. * * Stored information is package private. Packages MUST NOT retrieve the stored state of other packages. Packages * MUST use their namespace as prefix for keys. They may do so by using `SomeClass::class` as key. * * If packages want to expose loop bound state to consumers other than the package, they SHOULD provide a dedicated * interface for that purpose instead of sharing the storage key. * * @param string $key The namespaced storage key. * * @return mixed The previously stored value or `null` if it doesn't exist. */ final public function getState(string $key) { return isset($this->registry[$key]) ? $this->registry[$key] : null; } /** * Set a callback to be executed when an error occurs. * * The callback receives the error as the first and only parameter. The return value of the callback gets ignored. * If it can't handle the error, it MUST throw the error. Errors thrown by the callback or during its invocation * MUST be thrown into the `run` loop and stop the driver. * * Subsequent calls to this method will overwrite the previous handler. * * @param callable(\Throwable $error):void|null $callback The callback to execute. `null` will clear the * current handler. * * @return callable(\Throwable $error):void|null The previous handler, `null` if there was none. */ public function setErrorHandler(callable $callback = null) { $previous = $this->errorHandler; $this->errorHandler = $callback; return $previous; } /** * Invokes the error handler with the given exception. * * @param \Throwable $exception The exception thrown from a watcher callback. * * @return void * @throws \Throwable If no error handler has been set. */ protected function error(\Throwable $exception) { if ($this->errorHandler === null) { throw $exception; } ($this->errorHandler)($exception); } /** * Returns the current loop time in millisecond increments. Note this value does not necessarily correlate to * wall-clock time, rather the value returned is meant to be used in relative comparisons to prior values returned * by this method (intervals, expiration calculations, etc.) and is only updated once per loop tick. * * Extending classes should override this function to return a value cached once per loop tick. * * @return int */ public function now(): int { return (int) (\microtime(true) * self::MILLISEC_PER_SEC); } /** * Get the underlying loop handle. * * Example: the `uv_loop` resource for `libuv` or the `EvLoop` object for `libev` or `null` for a native driver. * * Note: This function is *not* exposed in the `Loop` class. Users shall access it directly on the respective loop * instance. * * @return null|object|resource The loop handle the event loop operates on. `null` if there is none. */ abstract public function getHandle(); /** * Returns the same array of data as getInfo(). * * @return array */ public function __debugInfo() { // @codeCoverageIgnoreStart return $this->getInfo(); // @codeCoverageIgnoreEnd } /** * Retrieve an associative array of information about the event loop driver. * * The returned array MUST contain the following data describing the driver's currently registered watchers: * * [ * "defer" => ["enabled" => int, "disabled" => int], * "delay" => ["enabled" => int, "disabled" => int], * "repeat" => ["enabled" => int, "disabled" => int], * "on_readable" => ["enabled" => int, "disabled" => int], * "on_writable" => ["enabled" => int, "disabled" => int], * "on_signal" => ["enabled" => int, "disabled" => int], * "enabled_watchers" => ["referenced" => int, "unreferenced" => int], * "running" => bool * ]; * * Implementations MAY optionally add more information in the array but at minimum the above `key => value` format * MUST always be provided. * * @return array Statistics about the loop in the described format. */ public function getInfo(): array { $watchers = [ "referenced" => 0, "unreferenced" => 0, ]; $defer = $delay = $repeat = $onReadable = $onWritable = $onSignal = [ "enabled" => 0, "disabled" => 0, ]; foreach ($this->watchers as $watcher) { switch ($watcher->type) { case Watcher::READABLE: $array = &$onReadable; break; case Watcher::WRITABLE: $array = &$onWritable; break; case Watcher::SIGNAL: $array = &$onSignal; break; case Watcher::DEFER: $array = &$defer; break; case Watcher::DELAY: $array = &$delay; break; case Watcher::REPEAT: $array = &$repeat; break; default: // @codeCoverageIgnoreStart throw new \Error("Unknown watcher type"); // @codeCoverageIgnoreEnd } if ($watcher->enabled) { ++$array["enabled"]; if ($watcher->referenced) { ++$watchers["referenced"]; } else { ++$watchers["unreferenced"]; } } else { ++$array["disabled"]; } } return [ "enabled_watchers" => $watchers, "defer" => $defer, "delay" => $delay, "repeat" => $repeat, "on_readable" => $onReadable, "on_writable" => $onWritable, "on_signal" => $onSignal, "running" => (bool) $this->running, ]; } } promisor = $promisor; } /** * {@inheritdoc} */ public function onResolve(callable $onResolved) { if ($this->promise === null) { \assert($this->promisor !== null); $provider = $this->promisor; $this->promisor = null; $this->promise = call($provider); } \assert($this->promise !== null); $this->promise->onResolve($onResolved); } } Has public resolve and fail methods. */ private $resolver; /** @var Promise Hides placeholder methods */ private $promise; public function __construct() { $this->resolver = new class implements Promise { use Internal\Placeholder { resolve as public; fail as public; isResolved as public; } }; $this->promise = new Internal\PrivatePromise($this->resolver); } /** * @return Promise */ public function promise(): Promise { return $this->promise; } /** * Fulfill the promise with the given value. * * @param mixed $value * * @psalm-param TValue|Promise $value * * @return void */ public function resolve($value = null) { /** @psalm-suppress UndefinedInterfaceMethod */ $this->resolver->resolve($value); } /** * Fails the promise the the given reason. * * @param \Throwable $reason * * @return void */ public function fail(\Throwable $reason) { /** @psalm-suppress UndefinedInterfaceMethod */ $this->resolver->fail($reason); } /** * @return bool True if the promise has been resolved. */ public function isResolved(): bool { return $this->resolver->isResolved(); } } exception; $thatCallbacks = &$this->callbacks; foreach ($tokens as $token) { $id = $token->subscribe(static function (CancelledException $exception) use (&$thatException, &$thatCallbacks) { $thatException = $exception; $callbacks = $thatCallbacks; $thatCallbacks = []; foreach ($callbacks as $callback) { asyncCall($callback, $thatException); } }); $this->tokens[] = [$token, $id]; } } public function __destruct() { foreach ($this->tokens as list($token, $id)) { /** @var CancellationToken $token */ $token->unsubscribe($id); } } /** @inheritdoc */ public function subscribe(callable $callback): string { $id = $this->nextId++; if ($this->exception) { asyncCall($callback, $this->exception); } else { $this->callbacks[$id] = $callback; } return $id; } /** @inheritdoc */ public function unsubscribe(string $id) { unset($this->callbacks[$id]); } /** @inheritdoc */ public function isRequested(): bool { foreach ($this->tokens as list($token)) { if ($token->isRequested()) { return true; } } return false; } /** @inheritdoc */ public function throwIfRequested() { foreach ($this->tokens as list($token)) { $token->throwIfRequested(); } } } { "name": "amphp/amp", "homepage": "https://amphp.org/amp", "description": "A non-blocking concurrency framework for PHP applications.", "keywords": [ "async", "asynchronous", "concurrency", "promise", "awaitable", "future", "non-blocking", "event", "event-loop" ], "license": "MIT", "authors": [ { "name": "Daniel Lowrey", "email": "rdlowrey@php.net" }, { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Bob Weinand", "email": "bobwei9@hotmail.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "require": { "php": ">=7.1" }, "require-dev": { "ext-json": "*", "amphp/phpunit-util": "^1", "amphp/php-cs-fixer-config": "dev-master", "react/promise": "^2", "phpunit/phpunit": "^7 | ^8 | ^9", "psalm/phar": "^3.11@dev", "jetbrains/phpstorm-stubs": "^2019.3" }, "autoload": { "psr-4": { "Amp\\": "lib" }, "files": [ "lib/functions.php", "lib/Internal/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\Test\\": "test" } }, "support": { "issues": "https://github.com/amphp/amp/issues", "irc": "irc://irc.freenode.org/amphp" }, "extra": { "branch-alias": { "dev-master": "2.x-dev" } }, "scripts": { "test": "@php -dzend.assertions=1 -dassert.exception=1 ./vendor/bin/phpunit", "code-style": "@php ./vendor/bin/php-cs-fixer fix" } } read()) !== null) { * $buffer .= $chunk; * } * * return $buffer; * }); * } * ``` */ interface InputStream { /** * Reads data from the stream. * * @return Promise Resolves with a string when new data is available or `null` if the stream has closed. * * @psalm-return Promise * * @throws PendingReadError Thrown if another read operation is still pending. */ public function read(): Promise; } deferred = new Deferred; } public function write(string $data): Promise { if ($this->closed) { throw new ClosedException("The stream has already been closed."); } $this->contents .= $data; return new Success(\strlen($data)); } public function end(string $finalData = ""): Promise { if ($this->closed) { throw new ClosedException("The stream has already been closed."); } $this->contents .= $finalData; $this->closed = true; $this->deferred->resolve($this->contents); $this->contents = ""; return new Success(\strlen($finalData)); } public function onResolve(callable $onResolved) { $this->deferred->promise()->onResolve($onResolved); } } source = $inputStream; $this->delimiter = $delimiter === null ? "\n" : $delimiter; $this->lineMode = $delimiter === null; } /** * @return Promise */ public function readLine(): Promise { return call(function () { if (false !== \strpos($this->buffer, $this->delimiter)) { list($line, $this->buffer) = \explode($this->delimiter, $this->buffer, 2); return $this->lineMode ? \rtrim($line, "\r") : $line; } while (null !== $chunk = yield $this->source->read()) { $this->buffer .= $chunk; if (false !== \strpos($this->buffer, $this->delimiter)) { list($line, $this->buffer) = \explode($this->delimiter, $this->buffer, 2); return $this->lineMode ? \rtrim($line, "\r") : $line; } } if ($this->buffer === "") { return null; } $line = $this->buffer; $this->buffer = ""; return $this->lineMode ? \rtrim($line, "\r") : $line; }); } public function getBuffer(): string { return $this->buffer; } /** * @return void */ public function clearBuffer() { $this->buffer = ""; } } destination = $destination; } public function write(string $data): Promise { $this->buffer .= $data; $length = \strlen($this->buffer); $chunk = \base64_decode(\substr($this->buffer, 0, $length - $length % 4), true); if ($chunk === false) { return new Failure(new StreamException('Invalid base64 near offset ' . $this->offset)); } $this->offset += $length - $length % 4; $this->buffer = \substr($this->buffer, $length - $length % 4); return $this->destination->write($chunk); } public function end(string $finalData = ""): Promise { $this->offset += \strlen($this->buffer); $chunk = \base64_decode($this->buffer . $finalData, true); if ($chunk === false) { return new Failure(new StreamException('Invalid base64 near offset ' . $this->offset)); } $this->buffer = ''; return $this->destination->end($chunk); } } destination = $destination; } public function write(string $data): Promise { $this->buffer .= $data; $length = \strlen($this->buffer); $chunk = \base64_encode(\substr($this->buffer, 0, $length - $length % 3)); $this->buffer = \substr($this->buffer, $length - $length % 3); return $this->destination->write($chunk); } public function end(string $finalData = ""): Promise { $chunk = \base64_encode($this->buffer . $finalData); $this->buffer = ''; return $this->destination->end($chunk); } } source = $source; } public function read(): Promise { return call(function () { if ($this->source === null) { throw new StreamException('Failed to read stream chunk due to invalid base64 data'); } $chunk = yield $this->source->read(); if ($chunk === null) { if ($this->buffer === null) { return null; } $chunk = \base64_decode($this->buffer, true); if ($chunk === false) { $this->source = null; $this->buffer = null; throw new StreamException('Failed to read stream chunk due to invalid base64 data'); } $this->buffer = null; return $chunk; } $this->buffer .= $chunk; $length = \strlen($this->buffer); $chunk = \base64_decode(\substr($this->buffer, 0, $length - $length % 4), true); if ($chunk === false) { $this->source = null; $this->buffer = null; throw new StreamException('Failed to read stream chunk due to invalid base64 data'); } $this->buffer = \substr($this->buffer, $length - $length % 4); return $chunk; }); } } source = $source; } public function read(): Promise { return call(function () { $chunk = yield $this->source->read(); if ($chunk === null) { if ($this->buffer === null) { return null; } $chunk = \base64_encode($this->buffer); $this->buffer = null; return $chunk; } $this->buffer .= $chunk; $length = \strlen($this->buffer); $chunk = \base64_encode(\substr($this->buffer, 0, $length - $length % 3)); $this->buffer = \substr($this->buffer, $length - $length % 3); return $chunk; }); } } */ private $writes; /** @var bool */ private $writable = true; /** @var int|null */ private $chunkSize; /** * @param resource $stream Stream resource. * @param int|null $chunkSize Chunk size per `fwrite()` operation. */ public function __construct($stream, int $chunkSize = null) { if (!\is_resource($stream) || \get_resource_type($stream) !== 'stream') { throw new \Error("Expected a valid stream"); } $meta = \stream_get_meta_data($stream); if (\strpos($meta["mode"], "r") !== false && \strpos($meta["mode"], "+") === false) { throw new \Error("Expected a writable stream"); } \stream_set_blocking($stream, false); \stream_set_write_buffer($stream, 0); $this->resource = $stream; $this->chunkSize = &$chunkSize; $writes = $this->writes = new \SplQueue; $writable = &$this->writable; $resource = &$this->resource; $this->watcher = Loop::onWritable($stream, static function ($watcher, $stream) use ($writes, &$chunkSize, &$writable, &$resource) { static $emptyWrites = 0; try { while (!$writes->isEmpty()) { /** @var Deferred $deferred */ list($data, $previous, $deferred) = $writes->shift(); $length = \strlen($data); if ($length === 0) { $deferred->resolve(0); continue; } if (!\is_resource($stream) || (($metaData = @\stream_get_meta_data($stream)) && $metaData['eof'])) { throw new ClosedException("The stream was closed by the peer"); } // Error reporting suppressed since fwrite() emits E_WARNING if the pipe is broken or the buffer is full. // Use conditional, because PHP doesn't like getting null passed if ($chunkSize) { $written = @\fwrite($stream, $data, $chunkSize); } else { $written = @\fwrite($stream, $data); } \assert( $written !== false || \PHP_VERSION_ID >= 70400, // PHP 7.4+ returns false on EPIPE. "Trying to write on a previously fclose()'d resource. Do NOT manually fclose() resources the still referenced in the loop." ); // PHP 7.4.0 and 7.4.1 may return false on EAGAIN. if ($written === false && \PHP_VERSION_ID >= 70402) { $message = "Failed to write to stream"; if ($error = \error_get_last()) { $message .= \sprintf("; %s", $error["message"]); } throw new StreamException($message); } // Broken pipes between processes on macOS/FreeBSD do not detect EOF properly. if ($written === 0 || $written === false) { if ($emptyWrites++ > self::MAX_CONSECUTIVE_EMPTY_WRITES) { $message = "Failed to write to stream after multiple attempts"; if ($error = \error_get_last()) { $message .= \sprintf("; %s", $error["message"]); } throw new StreamException($message); } $writes->unshift([$data, $previous, $deferred]); return; } $emptyWrites = 0; if ($length > $written) { $data = \substr($data, $written); $writes->unshift([$data, $written + $previous, $deferred]); return; } $deferred->resolve($written + $previous); } } catch (\Throwable $exception) { $resource = null; $writable = false; /** @psalm-suppress PossiblyUndefinedVariable */ $deferred->fail($exception); while (!$writes->isEmpty()) { list(, , $deferred) = $writes->shift(); $deferred->fail($exception); } Loop::cancel($watcher); } finally { if ($writes->isEmpty()) { Loop::disable($watcher); } } }); Loop::disable($this->watcher); } /** * Writes data to the stream. * * @param string $data Bytes to write. * * @return Promise Succeeds once the data has been successfully written to the stream. * * @throws ClosedException If the stream has already been closed. */ public function write(string $data): Promise { return $this->send($data, false); } /** * Closes the stream after all pending writes have been completed. Optionally writes a final data chunk before. * * @param string $finalData Bytes to write. * * @return Promise Succeeds once the data has been successfully written to the stream. * * @throws ClosedException If the stream has already been closed. */ public function end(string $finalData = ""): Promise { return $this->send($finalData, true); } private function send(string $data, bool $end = false): Promise { if (!$this->writable) { return new Failure(new ClosedException("The stream is not writable")); } $length = \strlen($data); $written = 0; if ($end) { $this->writable = false; } if ($this->writes->isEmpty()) { if ($length === 0) { if ($end) { $this->close(); } return new Success(0); } if (!\is_resource($this->resource) || (($metaData = @\stream_get_meta_data($this->resource)) && $metaData['eof'])) { return new Failure(new ClosedException("The stream was closed by the peer")); } // Error reporting suppressed since fwrite() emits E_WARNING if the pipe is broken or the buffer is full. // Use conditional, because PHP doesn't like getting null passed. if ($this->chunkSize) { $written = @\fwrite($this->resource, $data, $this->chunkSize); } else { $written = @\fwrite($this->resource, $data); } \assert( $written !== false || \PHP_VERSION_ID >= 70400, // PHP 7.4+ returns false on EPIPE. "Trying to write on a previously fclose()'d resource. Do NOT manually fclose() resources the still referenced in the loop." ); // PHP 7.4.0 and 7.4.1 may return false on EAGAIN. if ($written === false && \PHP_VERSION_ID >= 70402) { $message = "Failed to write to stream"; if ($error = \error_get_last()) { $message .= \sprintf("; %s", $error["message"]); } return new Failure(new StreamException($message)); } $written = (int) $written; // Cast potential false to 0. if ($length === $written) { if ($end) { $this->close(); } return new Success($written); } $data = \substr($data, $written); } $deferred = new Deferred; if ($length - $written > self::LARGE_CHUNK_SIZE) { $chunks = \str_split($data, self::LARGE_CHUNK_SIZE); $data = \array_pop($chunks); foreach ($chunks as $chunk) { $this->writes->push([$chunk, $written, new Deferred]); $written += self::LARGE_CHUNK_SIZE; } } $this->writes->push([$data, $written, $deferred]); Loop::enable($this->watcher); $promise = $deferred->promise(); if ($end) { $promise->onResolve([$this, "close"]); } return $promise; } /** * Closes the stream forcefully. Multiple `close()` calls are ignored. * * @return void */ public function close() { if (\is_resource($this->resource)) { // Error suppression, as resource might already be closed $meta = @\stream_get_meta_data($this->resource); if ($meta && \strpos($meta["mode"], "+") !== false) { @\stream_socket_shutdown($this->resource, \STREAM_SHUT_WR); } else { /** @psalm-suppress InvalidPropertyAssignmentValue psalm reports this as closed-resource */ @\fclose($this->resource); } } $this->free(); } /** * Nulls reference to resource, marks stream unwritable, and fails any pending write. * * @return void */ private function free() { $this->resource = null; $this->writable = false; if (!$this->writes->isEmpty()) { $exception = new ClosedException("The socket was closed before writing completed"); do { /** @var Deferred $deferred */ list(, , $deferred) = $this->writes->shift(); $deferred->fail($exception); } while (!$this->writes->isEmpty()); } Loop::cancel($this->watcher); } /** * @return resource|null Stream resource or null if end() has been called or the stream closed. */ public function getResource() { return $this->resource; } /** * @return void */ public function setChunkSize(int $chunkSize) { $this->chunkSize = $chunkSize; } public function __destruct() { if ($this->resource !== null) { $this->free(); } } } read()) !== null) { * // Immediately use $chunk, reducing memory consumption since the entire message is never buffered. * } * * @deprecated Use Amp\ByteStream\Payload instead. */ class Message implements InputStream, Promise { /** @var InputStream */ private $source; /** @var string */ private $buffer = ""; /** @var Deferred|null */ private $pendingRead; /** @var Coroutine|null */ private $coroutine; /** @var bool True if onResolve() has been called. */ private $buffering = false; /** @var Deferred|null */ private $backpressure; /** @var bool True if the iterator has completed. */ private $complete = false; /** @var \Throwable|null Used to fail future reads on failure. */ private $error; /** * @param InputStream $source An iterator that only emits strings. */ public function __construct(InputStream $source) { $this->source = $source; } private function consume(): \Generator { while (($chunk = yield $this->source->read()) !== null) { $buffer = $this->buffer .= $chunk; if ($buffer === "") { continue; // Do not succeed reads with empty string. } elseif ($this->pendingRead) { $deferred = $this->pendingRead; $this->pendingRead = null; $this->buffer = ""; $deferred->resolve($buffer); $buffer = ""; // Destroy last emitted chunk to free memory. } elseif (!$this->buffering) { $buffer = ""; // Destroy last emitted chunk to free memory. $this->backpressure = new Deferred; yield $this->backpressure->promise(); } } $this->complete = true; if ($this->pendingRead) { $deferred = $this->pendingRead; $this->pendingRead = null; $deferred->resolve($this->buffer !== "" ? $this->buffer : null); $this->buffer = ""; } return $this->buffer; } /** @inheritdoc */ final public function read(): Promise { if ($this->pendingRead) { throw new PendingReadError; } if ($this->coroutine === null) { $this->coroutine = new Coroutine($this->consume()); $this->coroutine->onResolve(function ($error) { if ($error) { $this->error = $error; } if ($this->pendingRead) { $deferred = $this->pendingRead; $this->pendingRead = null; $deferred->fail($error); } }); } if ($this->error) { return new Failure($this->error); } if ($this->buffer !== "") { $buffer = $this->buffer; $this->buffer = ""; if ($this->backpressure) { $backpressure = $this->backpressure; $this->backpressure = null; $backpressure->resolve(); } return new Success($buffer); } if ($this->complete) { return new Success; } $this->pendingRead = new Deferred; return $this->pendingRead->promise(); } /** @inheritdoc */ final public function onResolve(callable $onResolved) { $this->buffering = true; if ($this->coroutine === null) { $this->coroutine = new Coroutine($this->consume()); } if ($this->backpressure) { $backpressure = $this->backpressure; $this->backpressure = null; $backpressure->resolve(); } $this->coroutine->onResolve($onResolved); } /** * Exposes the source input stream. * * This might be required to resolve a promise with an InputStream, because promises in Amp can't be resolved with * other promises. * * @return InputStream */ final public function getInputStream(): InputStream { return $this->source; } } */ private $iterator; /** @var \Throwable|null */ private $exception; /** @var bool */ private $pending = false; /** * @psam-param Iterator $iterator */ public function __construct(Iterator $iterator) { $this->iterator = $iterator; } /** @inheritdoc */ public function read(): Promise { if ($this->exception) { return new Failure($this->exception); } if ($this->pending) { throw new PendingReadError; } $this->pending = true; /** @var Deferred $deferred */ $deferred = new Deferred; $this->iterator->advance()->onResolve(function ($error, $hasNextElement) use ($deferred) { $this->pending = false; if ($error) { $this->exception = $error; $deferred->fail($error); } elseif ($hasNextElement) { $chunk = $this->iterator->getCurrent(); if (!\is_string($chunk)) { $this->exception = new StreamException(\sprintf( "Unexpected iterator value of type '%s', expected string", \is_object($chunk) ? \get_class($chunk) : \gettype($chunk) )); $deferred->fail($this->exception); return; } $deferred->resolve($chunk); } else { $deferred->resolve(); } }); return $deferred->promise(); } } read()) !== null) { $written += \strlen($chunk); $writePromise = $destination->write($chunk); $chunk = null; // free memory yield $writePromise; } return $written; }); } /** * @param \Amp\ByteStream\InputStream $source * * @return \Amp\Promise */ function buffer(InputStream $source): Promise { return call(function () use ($source): \Generator { $buffer = ""; while (($chunk = yield $source->read()) !== null) { $buffer .= $chunk; $chunk = null; // free memory } return $buffer; }); } /** * The php://input input buffer stream for the process associated with the currently active event loop. * * @return ResourceInputStream */ function getInputBufferStream(): ResourceInputStream { static $key = InputStream::class . '\\input'; $stream = Loop::getState($key); if (!$stream) { $stream = new ResourceInputStream(\fopen('php://input', 'rb')); Loop::setState($key, $stream); } return $stream; } /** * The php://output output buffer stream for the process associated with the currently active event loop. * * @return ResourceOutputStream */ function getOutputBufferStream(): ResourceOutputStream { static $key = OutputStream::class . '\\output'; $stream = Loop::getState($key); if (!$stream) { $stream = new ResourceOutputStream(\fopen('php://output', 'wb')); Loop::setState($key, $stream); } return $stream; } /** * The STDIN stream for the process associated with the currently active event loop. * * @return ResourceInputStream */ function getStdin(): ResourceInputStream { static $key = InputStream::class . '\\stdin'; $stream = Loop::getState($key); if (!$stream) { $stream = new ResourceInputStream(\STDIN); Loop::setState($key, $stream); } return $stream; } /** * The STDOUT stream for the process associated with the currently active event loop. * * @return ResourceOutputStream */ function getStdout(): ResourceOutputStream { static $key = OutputStream::class . '\\stdout'; $stream = Loop::getState($key); if (!$stream) { $stream = new ResourceOutputStream(\STDOUT); Loop::setState($key, $stream); } return $stream; } /** * The STDERR stream for the process associated with the currently active event loop. * * @return ResourceOutputStream */ function getStderr(): ResourceOutputStream { static $key = OutputStream::class . '\\stderr'; $stream = Loop::getState($key); if (!$stream) { $stream = new ResourceOutputStream(\STDERR); Loop::setState($key, $stream); } return $stream; } function parseLineDelimitedJson(InputStream $stream, bool $assoc = false, int $depth = 512, int $options = 0): Iterator { return new Producer(static function (callable $emit) use ($stream, $assoc, $depth, $options) { $reader = new LineReader($stream); while (null !== $line = yield $reader->readLine()) { $line = \trim($line); if ($line === '') { continue; } /** @noinspection PhpComposerExtensionStubsInspection */ $data = \json_decode($line, $assoc, $depth, $options); /** @noinspection PhpComposerExtensionStubsInspection */ $error = \json_last_error(); /** @noinspection PhpComposerExtensionStubsInspection */ if ($error !== \JSON_ERROR_NONE) { /** @noinspection PhpComposerExtensionStubsInspection */ throw new StreamException('Failed to parse JSON: ' . \json_last_error_msg(), $error); } yield $emit($data); } }); } useSingleRead = $useSingleRead; if (\strpos($meta["mode"], "r") === false && \strpos($meta["mode"], "+") === false) { throw new \Error("Expected a readable stream"); } \stream_set_blocking($stream, false); \stream_set_read_buffer($stream, 0); $this->resource = &$stream; $this->chunkSize = &$chunkSize; $deferred = &$this->deferred; $readable = &$this->readable; $this->watcher = Loop::onReadable($this->resource, static function ($watcher) use ( &$deferred, &$readable, &$stream, &$chunkSize, $useSingleRead ) { if ($useSingleRead) { $data = @\fread($stream, $chunkSize); } else { $data = @\stream_get_contents($stream, $chunkSize); } \assert($data !== false, "Trying to read from a previously fclose()'d resource. Do NOT manually fclose() resources the loop still has a reference to."); // Error suppression, because pthreads does crazy things with resources, // which might be closed during two operations. // See https://github.com/amphp/byte-stream/issues/32 if ($data === '' && @\feof($stream)) { $readable = false; $stream = null; $data = null; // Stream closed, resolve read with null. Loop::cancel($watcher); } else { Loop::disable($watcher); } $temp = $deferred; $deferred = null; \assert($temp instanceof Deferred); $temp->resolve($data); }); $this->immediateCallable = static function ($watcherId, $data) use (&$deferred) { $temp = $deferred; $deferred = null; \assert($temp instanceof Deferred); $temp->resolve($data); }; Loop::disable($this->watcher); } /** @inheritdoc */ public function read(): Promise { if ($this->deferred !== null) { throw new PendingReadError; } if (!$this->readable) { return new Success; // Resolve with null on closed stream. } \assert($this->resource !== null); // Attempt a direct read, because Windows suffers from slow I/O on STDIN otherwise. if ($this->useSingleRead) { $data = @\fread($this->resource, $this->chunkSize); } else { $data = @\stream_get_contents($this->resource, $this->chunkSize); } \assert($data !== false, "Trying to read from a previously fclose()'d resource. Do NOT manually fclose() resources the loop still has a reference to."); if ($data === '') { // Error suppression, because pthreads does crazy things with resources, // which might be closed during two operations. // See https://github.com/amphp/byte-stream/issues/32 if (@\feof($this->resource)) { $this->readable = false; $this->resource = null; Loop::cancel($this->watcher); return new Success; // Stream closed, resolve read with null. } $this->deferred = new Deferred; Loop::enable($this->watcher); return $this->deferred->promise(); } // Prevent an immediate read → write loop from blocking everything // See e.g. examples/benchmark-throughput.php $this->deferred = new Deferred; $this->immediateWatcher = Loop::defer($this->immediateCallable, $data); return $this->deferred->promise(); } /** * Closes the stream forcefully. Multiple `close()` calls are ignored. * * @return void */ public function close() { if (\is_resource($this->resource)) { // Error suppression, as resource might already be closed $meta = @\stream_get_meta_data($this->resource); if ($meta && \strpos($meta["mode"], "+") !== false) { @\stream_socket_shutdown($this->resource, \STREAM_SHUT_RD); } else { /** @psalm-suppress InvalidPropertyAssignmentValue */ @\fclose($this->resource); } } $this->free(); } /** * Nulls reference to resource, marks stream unreadable, and succeeds any pending read with null. * * @return void */ private function free() { $this->readable = false; $this->resource = null; if ($this->deferred !== null) { $deferred = $this->deferred; $this->deferred = null; $deferred->resolve(); } Loop::cancel($this->watcher); if ($this->immediateWatcher !== null) { Loop::cancel($this->immediateWatcher); } } /** * @return resource|null The stream resource or null if the stream has closed. */ public function getResource() { return $this->resource; } /** * @return void */ public function setChunkSize(int $chunkSize) { $this->chunkSize = $chunkSize; } /** * References the read watcher, so the loop keeps running in case there's an active read. * * @return void * * @see Loop::reference() */ public function reference() { if (!$this->resource) { throw new \Error("Resource has already been freed"); } Loop::reference($this->watcher); } /** * Unreferences the read watcher, so the loop doesn't keep running even if there are active reads. * * @return void * * @see Loop::unreference() */ public function unreference() { if (!$this->resource) { throw new \Error("Resource has already been freed"); } Loop::unreference($this->watcher); } public function __destruct() { if ($this->resource !== null) { $this->free(); } } } contents = $contents; } /** * Reads data from the stream. * * @return Promise Resolves with the full contents or `null` if the stream has closed / already been consumed. */ public function read(): Promise { if ($this->contents === null) { return new Success; } $promise = new Success($this->contents); $this->contents = null; return $promise; } } streams = $streams; } /** @inheritDoc */ public function read(): Promise { if ($this->reading) { throw new PendingReadError; } if (!$this->streams) { return new Success(null); } return call(function () { $this->reading = true; try { while ($this->streams) { $chunk = yield $this->streams[0]->read(); if ($chunk === null) { \array_shift($this->streams); continue; } return $chunk; } return null; } finally { $this->reading = false; } }); } } destination = $destination; $this->encoding = $encoding; $this->options = $options; $this->resource = @\deflate_init($encoding, $options); if ($this->resource === false) { throw new StreamException("Failed initializing deflate context"); } } /** @inheritdoc */ public function write(string $data): Promise { if ($this->resource === null) { throw new ClosedException("The stream has already been closed"); } \assert($this->destination !== null); $compressed = \deflate_add($this->resource, $data, \ZLIB_SYNC_FLUSH); if ($compressed === false) { throw new StreamException("Failed adding data to deflate context"); } $promise = $this->destination->write($compressed); $promise->onResolve(function ($error) { if ($error) { $this->close(); } }); return $promise; } /** @inheritdoc */ public function end(string $finalData = ""): Promise { if ($this->resource === null) { throw new ClosedException("The stream has already been closed"); } \assert($this->destination !== null); $compressed = \deflate_add($this->resource, $finalData, \ZLIB_FINISH); if ($compressed === false) { throw new StreamException("Failed adding data to deflate context"); } $promise = $this->destination->end($compressed); $promise->onResolve(function () { $this->close(); }); return $promise; } /** * @internal * @return void */ private function close() { $this->resource = null; $this->destination = null; } /** * Gets the used compression encoding. * * @return int Encoding specified on construction time. */ public function getEncoding(): int { return $this->encoding; } /** * Gets the used compression options. * * @return array Options array passed on construction time. */ public function getOptions(): array { return $this->options; } } stream = $stream; } public function __destruct() { if (!$this->promise) { Promise\rethrow(new Coroutine($this->consume())); } } private function consume(): \Generator { try { if ($this->lastRead && null === yield $this->lastRead) { return; } while (null !== yield $this->stream->read()) { // Discard unread bytes from message. } } catch (\Throwable $exception) { // If exception is thrown here the connection closed anyway. } } /** * @inheritdoc * * @throws \Error If a buffered message was requested by calling buffer(). */ final public function read(): Promise { if ($this->promise) { throw new \Error("Cannot stream message data once a buffered message has been requested"); } return $this->lastRead = $this->stream->read(); } /** * Buffers the entire message and resolves the returned promise then. * * @return Promise Resolves with the entire message contents. */ final public function buffer(): Promise { if ($this->promise) { return $this->promise; } return $this->promise = call(function () { $buffer = ''; if ($this->lastRead && null === yield $this->lastRead) { return $buffer; } while (null !== $chunk = yield $this->stream->read()) { $buffer .= $chunk; } return $buffer; }); } } source = $source; $this->encoding = $encoding; $this->options = $options; $this->resource = @\inflate_init($encoding, $options); if ($this->resource === false) { throw new StreamException("Failed initializing deflate context"); } } /** @inheritdoc */ public function read(): Promise { return call(function () { if ($this->resource === null) { return null; } \assert($this->source !== null); $data = yield $this->source->read(); // Needs a double guard, as stream might have been closed while reading /** @psalm-suppress ParadoxicalCondition */ if ($this->resource === null) { return null; } if ($data === null) { $decompressed = @\inflate_add($this->resource, "", \ZLIB_FINISH); if ($decompressed === false) { throw new StreamException("Failed adding data to deflate context"); } $this->close(); return $decompressed; } $decompressed = @\inflate_add($this->resource, $data, \ZLIB_SYNC_FLUSH); if ($decompressed === false) { throw new StreamException("Failed adding data to deflate context"); } return $decompressed; }); } /** * @internal * @return void */ private function close() { $this->resource = null; $this->source = null; } /** * Gets the used compression encoding. * * @return int Encoding specified on construction time. */ public function getEncoding(): int { return $this->encoding; } /** * Gets the used compression options. * * @return array Options array passed on construction time. */ public function getOptions(): array { return $this->options; } } { "name": "amphp/byte-stream", "homepage": "http://amphp.org/byte-stream", "description": "A stream abstraction to make working with non-blocking I/O simple.", "support": { "issues": "https://github.com/amphp/byte-stream/issues", "irc": "irc://irc.freenode.org/amphp" }, "keywords": [ "stream", "async", "non-blocking", "amp", "amphp", "io" ], "license": "MIT", "authors": [ { "name": "Aaron Piotrowski", "email": "aaron@trowski.com" }, { "name": "Niklas Keller", "email": "me@kelunik.com" } ], "require": { "php": ">=7.1", "amphp/amp": "^2" }, "require-dev": { "amphp/phpunit-util": "^1.4", "phpunit/phpunit": "^6 || ^7 || ^8", "friendsofphp/php-cs-fixer": "^2.3", "amphp/php-cs-fixer-config": "dev-master", "psalm/phar": "^3.11.4", "jetbrains/phpstorm-stubs": "^2019.3" }, "autoload": { "psr-4": { "Amp\\ByteStream\\": "lib" }, "files": [ "lib/functions.php" ] }, "autoload-dev": { "psr-4": { "Amp\\ByteStream\\Test\\": "test" } }, "extra": { "branch-alias": { "dev-master": "1.x-dev" } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Polyfill\Mbstring; /** * Partial mbstring implementation in PHP, iconv based, UTF-8 centric. * * Implemented: * - mb_chr - Returns a specific character from its Unicode code point * - mb_convert_encoding - Convert character encoding * - mb_convert_variables - Convert character code in variable(s) * - mb_decode_mimeheader - Decode string in MIME header field * - mb_encode_mimeheader - Encode string for MIME header XXX NATIVE IMPLEMENTATION IS REALLY BUGGED * - mb_decode_numericentity - Decode HTML numeric string reference to character * - mb_encode_numericentity - Encode character to HTML numeric string reference * - mb_convert_case - Perform case folding on a string * - mb_detect_encoding - Detect character encoding * - mb_get_info - Get internal settings of mbstring * - mb_http_input - Detect HTTP input character encoding * - mb_http_output - Set/Get HTTP output character encoding * - mb_internal_encoding - Set/Get internal character encoding * - mb_list_encodings - Returns an array of all supported encodings * - mb_ord - Returns the Unicode code point of a character * - mb_output_handler - Callback function converts character encoding in output buffer * - mb_scrub - Replaces ill-formed byte sequences with substitute characters * - mb_strlen - Get string length * - mb_strpos - Find position of first occurrence of string in a string * - mb_strrpos - Find position of last occurrence of a string in a string * - mb_str_split - Convert a string to an array * - mb_strtolower - Make a string lowercase * - mb_strtoupper - Make a string uppercase * - mb_substitute_character - Set/Get substitution character * - mb_substr - Get part of string * - mb_stripos - Finds position of first occurrence of a string within another, case insensitive * - mb_stristr - Finds first occurrence of a string within another, case insensitive * - mb_strrchr - Finds the last occurrence of a character in a string within another * - mb_strrichr - Finds the last occurrence of a character in a string within another, case insensitive * - mb_strripos - Finds position of last occurrence of a string within another, case insensitive * - mb_strstr - Finds first occurrence of a string within another * - mb_strwidth - Return width of string * - mb_substr_count - Count the number of substring occurrences * * Not implemented: * - mb_convert_kana - Convert "kana" one from another ("zen-kaku", "han-kaku" and more) * - mb_ereg_* - Regular expression with multibyte support * - mb_parse_str - Parse GET/POST/COOKIE data and set global variable * - mb_preferred_mime_name - Get MIME charset string * - mb_regex_encoding - Returns current encoding for multibyte regex as string * - mb_regex_set_options - Set/Get the default options for mbregex functions * - mb_send_mail - Send encoded mail * - mb_split - Split multibyte string using regular expression * - mb_strcut - Get part of string * - mb_strimwidth - Get truncated string with specified width * * @author Nicolas Grekas * * @internal */ final class Mbstring { public const MB_CASE_FOLD = \PHP_INT_MAX; private const CASE_FOLD = [ ['µ', 'ſ', "\xCD\x85", 'ς', "\xCF\x90", "\xCF\x91", "\xCF\x95", "\xCF\x96", "\xCF\xB0", "\xCF\xB1", "\xCF\xB5", "\xE1\xBA\x9B", "\xE1\xBE\xBE"], ['μ', 's', 'ι', 'σ', 'β', 'θ', 'φ', 'π', 'κ', 'ρ', 'ε', "\xE1\xB9\xA1", 'ι'], ]; private static $encodingList = ['ASCII', 'UTF-8']; private static $language = 'neutral'; private static $internalEncoding = 'UTF-8'; public static function mb_convert_encoding($s, $toEncoding, $fromEncoding = null) { if (\is_array($fromEncoding) || (null !== $fromEncoding && false !== strpos($fromEncoding, ','))) { $fromEncoding = self::mb_detect_encoding($s, $fromEncoding); } else { $fromEncoding = self::getEncoding($fromEncoding); } $toEncoding = self::getEncoding($toEncoding); if ('BASE64' === $fromEncoding) { $s = base64_decode($s); $fromEncoding = $toEncoding; } if ('BASE64' === $toEncoding) { return base64_encode($s); } if ('HTML-ENTITIES' === $toEncoding || 'HTML' === $toEncoding) { if ('HTML-ENTITIES' === $fromEncoding || 'HTML' === $fromEncoding) { $fromEncoding = 'Windows-1252'; } if ('UTF-8' !== $fromEncoding) { $s = iconv($fromEncoding, 'UTF-8//IGNORE', $s); } return preg_replace_callback('/[\x80-\xFF]+/', [__CLASS__, 'html_encoding_callback'], $s); } if ('HTML-ENTITIES' === $fromEncoding) { $s = html_entity_decode($s, \ENT_COMPAT, 'UTF-8'); $fromEncoding = 'UTF-8'; } return iconv($fromEncoding, $toEncoding.'//IGNORE', $s); } public static function mb_convert_variables($toEncoding, $fromEncoding, &...$vars) { $ok = true; array_walk_recursive($vars, function (&$v) use (&$ok, $toEncoding, $fromEncoding) { if (false === $v = self::mb_convert_encoding($v, $toEncoding, $fromEncoding)) { $ok = false; } }); return $ok ? $fromEncoding : false; } public static function mb_decode_mimeheader($s) { return iconv_mime_decode($s, 2, self::$internalEncoding); } public static function mb_encode_mimeheader($s, $charset = null, $transferEncoding = null, $linefeed = null, $indent = null) { trigger_error('mb_encode_mimeheader() is bugged. Please use iconv_mime_encode() instead', \E_USER_WARNING); } public static function mb_decode_numericentity($s, $convmap, $encoding = null) { if (null !== $s && !\is_scalar($s) && !(\is_object($s) && method_exists($s, '__toString'))) { trigger_error('mb_decode_numericentity() expects parameter 1 to be string, '.\gettype($s).' given', \E_USER_WARNING); return null; } if (!\is_array($convmap) || (80000 > \PHP_VERSION_ID && !$convmap)) { return false; } if (null !== $encoding && !\is_scalar($encoding)) { trigger_error('mb_decode_numericentity() expects parameter 3 to be string, '.\gettype($s).' given', \E_USER_WARNING); return ''; // Instead of null (cf. mb_encode_numericentity). } $s = (string) $s; if ('' === $s) { return ''; } $encoding = self::getEncoding($encoding); if ('UTF-8' === $encoding) { $encoding = null; if (!preg_match('//u', $s)) { $s = @iconv('UTF-8', 'UTF-8//IGNORE', $s); } } else { $s = iconv($encoding, 'UTF-8//IGNORE', $s); } $cnt = floor(\count($convmap) / 4) * 4; for ($i = 0; $i < $cnt; $i += 4) { // collector_decode_htmlnumericentity ignores $convmap[$i + 3] $convmap[$i] += $convmap[$i + 2]; $convmap[$i + 1] += $convmap[$i + 2]; } $s = preg_replace_callback('/&#(?:0*([0-9]+)|x0*([0-9a-fA-F]+))(?!&);?/', function (array $m) use ($cnt, $convmap) { $c = isset($m[2]) ? (int) hexdec($m[2]) : $m[1]; for ($i = 0; $i < $cnt; $i += 4) { if ($c >= $convmap[$i] && $c <= $convmap[$i + 1]) { return self::mb_chr($c - $convmap[$i + 2]); } } return $m[0]; }, $s); if (null === $encoding) { return $s; } return iconv('UTF-8', $encoding.'//IGNORE', $s); } public static function mb_encode_numericentity($s, $convmap, $encoding = null, $is_hex = false) { if (null !== $s && !\is_scalar($s) && !(\is_object($s) && method_exists($s, '__toString'))) { trigger_error('mb_encode_numericentity() expects parameter 1 to be string, '.\gettype($s).' given', \E_USER_WARNING); return null; } if (!\is_array($convmap) || (80000 > \PHP_VERSION_ID && !$convmap)) { return false; } if (null !== $encoding && !\is_scalar($encoding)) { trigger_error('mb_encode_numericentity() expects parameter 3 to be string, '.\gettype($s).' given', \E_USER_WARNING); return null; // Instead of '' (cf. mb_decode_numericentity). } if (null !== $is_hex && !\is_scalar($is_hex)) { trigger_error('mb_encode_numericentity() expects parameter 4 to be boolean, '.\gettype($s).' given', \E_USER_WARNING); return null; } $s = (string) $s; if ('' === $s) { return ''; } $encoding = self::getEncoding($encoding); if ('UTF-8' === $encoding) { $encoding = null; if (!preg_match('//u', $s)) { $s = @iconv('UTF-8', 'UTF-8//IGNORE', $s); } } else { $s = iconv($encoding, 'UTF-8//IGNORE', $s); } static $ulenMask = ["\xC0" => 2, "\xD0" => 2, "\xE0" => 3, "\xF0" => 4]; $cnt = floor(\count($convmap) / 4) * 4; $i = 0; $len = \strlen($s); $result = ''; while ($i < $len) { $ulen = $s[$i] < "\x80" ? 1 : $ulenMask[$s[$i] & "\xF0"]; $uchr = substr($s, $i, $ulen); $i += $ulen; $c = self::mb_ord($uchr); for ($j = 0; $j < $cnt; $j += 4) { if ($c >= $convmap[$j] && $c <= $convmap[$j + 1]) { $cOffset = ($c + $convmap[$j + 2]) & $convmap[$j + 3]; $result .= $is_hex ? sprintf('&#x%X;', $cOffset) : '&#'.$cOffset.';'; continue 2; } } $result .= $uchr; } if (null === $encoding) { return $result; } return iconv('UTF-8', $encoding.'//IGNORE', $result); } public static function mb_convert_case($s, $mode, $encoding = null) { $s = (string) $s; if ('' === $s) { return ''; } $encoding = self::getEncoding($encoding); if ('UTF-8' === $encoding) { $encoding = null; if (!preg_match('//u', $s)) { $s = @iconv('UTF-8', 'UTF-8//IGNORE', $s); } } else { $s = iconv($encoding, 'UTF-8//IGNORE', $s); } if (\MB_CASE_TITLE == $mode) { static $titleRegexp = null; if (null === $titleRegexp) { $titleRegexp = self::getData('titleCaseRegexp'); } $s = preg_replace_callback($titleRegexp, [__CLASS__, 'title_case'], $s); } else { if (\MB_CASE_UPPER == $mode) { static $upper = null; if (null === $upper) { $upper = self::getData('upperCase'); } $map = $upper; } else { if (self::MB_CASE_FOLD === $mode) { $s = str_replace(self::CASE_FOLD[0], self::CASE_FOLD[1], $s); } static $lower = null; if (null === $lower) { $lower = self::getData('lowerCase'); } $map = $lower; } static $ulenMask = ["\xC0" => 2, "\xD0" => 2, "\xE0" => 3, "\xF0" => 4]; $i = 0; $len = \strlen($s); while ($i < $len) { $ulen = $s[$i] < "\x80" ? 1 : $ulenMask[$s[$i] & "\xF0"]; $uchr = substr($s, $i, $ulen); $i += $ulen; if (isset($map[$uchr])) { $uchr = $map[$uchr]; $nlen = \strlen($uchr); if ($nlen == $ulen) { $nlen = $i; do { $s[--$nlen] = $uchr[--$ulen]; } while ($ulen); } else { $s = substr_replace($s, $uchr, $i - $ulen, $ulen); $len += $nlen - $ulen; $i += $nlen - $ulen; } } } } if (null === $encoding) { return $s; } return iconv('UTF-8', $encoding.'//IGNORE', $s); } public static function mb_internal_encoding($encoding = null) { if (null === $encoding) { return self::$internalEncoding; } $normalizedEncoding = self::getEncoding($encoding); if ('UTF-8' === $normalizedEncoding || false !== @iconv($normalizedEncoding, $normalizedEncoding, ' ')) { self::$internalEncoding = $normalizedEncoding; return true; } if (80000 > \PHP_VERSION_ID) { return false; } throw new \ValueError(sprintf('Argument #1 ($encoding) must be a valid encoding, "%s" given', $encoding)); } public static function mb_language($lang = null) { if (null === $lang) { return self::$language; } switch ($normalizedLang = strtolower($lang)) { case 'uni': case 'neutral': self::$language = $normalizedLang; return true; } if (80000 > \PHP_VERSION_ID) { return false; } throw new \ValueError(sprintf('Argument #1 ($language) must be a valid language, "%s" given', $lang)); } public static function mb_list_encodings() { return ['UTF-8']; } public static function mb_encoding_aliases($encoding) { switch (strtoupper($encoding)) { case 'UTF8': case 'UTF-8': return ['utf8']; } return false; } public static function mb_check_encoding($var = null, $encoding = null) { if (null === $encoding) { if (null === $var) { return false; } $encoding = self::$internalEncoding; } return self::mb_detect_encoding($var, [$encoding]) || false !== @iconv($encoding, $encoding, $var); } public static function mb_detect_encoding($str, $encodingList = null, $strict = false) { if (null === $encodingList) { $encodingList = self::$encodingList; } else { if (!\is_array($encodingList)) { $encodingList = array_map('trim', explode(',', $encodingList)); } $encodingList = array_map('strtoupper', $encodingList); } foreach ($encodingList as $enc) { switch ($enc) { case 'ASCII': if (!preg_match('/[\x80-\xFF]/', $str)) { return $enc; } break; case 'UTF8': case 'UTF-8': if (preg_match('//u', $str)) { return 'UTF-8'; } break; default: if (0 === strncmp($enc, 'ISO-8859-', 9)) { return $enc; } } } return false; } public static function mb_detect_order($encodingList = null) { if (null === $encodingList) { return self::$encodingList; } if (!\is_array($encodingList)) { $encodingList = array_map('trim', explode(',', $encodingList)); } $encodingList = array_map('strtoupper', $encodingList); foreach ($encodingList as $enc) { switch ($enc) { default: if (strncmp($enc, 'ISO-8859-', 9)) { return false; } // no break case 'ASCII': case 'UTF8': case 'UTF-8': } } self::$encodingList = $encodingList; return true; } public static function mb_strlen($s, $encoding = null) { $encoding = self::getEncoding($encoding); if ('CP850' === $encoding || 'ASCII' === $encoding) { return \strlen($s); } return @iconv_strlen($s, $encoding); } public static function mb_strpos($haystack, $needle, $offset = 0, $encoding = null) { $encoding = self::getEncoding($encoding); if ('CP850' === $encoding || 'ASCII' === $encoding) { return strpos($haystack, $needle, $offset); } $needle = (string) $needle; if ('' === $needle) { if (80000 > \PHP_VERSION_ID) { trigger_error(__METHOD__.': Empty delimiter', \E_USER_WARNING); return false; } return 0; } return iconv_strpos($haystack, $needle, $offset, $encoding); } public static function mb_strrpos($haystack, $needle, $offset = 0, $encoding = null) { $encoding = self::getEncoding($encoding); if ('CP850' === $encoding || 'ASCII' === $encoding) { return strrpos($haystack, $needle, $offset); } if ($offset != (int) $offset) { $offset = 0; } elseif ($offset = (int) $offset) { if ($offset < 0) { if (0 > $offset += self::mb_strlen($needle)) { $haystack = self::mb_substr($haystack, 0, $offset, $encoding); } $offset = 0; } else { $haystack = self::mb_substr($haystack, $offset, 2147483647, $encoding); } } $pos = '' !== $needle || 80000 > \PHP_VERSION_ID ? iconv_strrpos($haystack, $needle, $encoding) : self::mb_strlen($haystack, $encoding); return false !== $pos ? $offset + $pos : false; } public static function mb_str_split($string, $split_length = 1, $encoding = null) { if (null !== $string && !\is_scalar($string) && !(\is_object($string) && method_exists($string, '__toString'))) { trigger_error('mb_str_split() expects parameter 1 to be string, '.\gettype($string).' given', \E_USER_WARNING); return null; } if (1 > $split_length = (int) $split_length) { if (80000 > \PHP_VERSION_ID) { trigger_error('The length of each segment must be greater than zero', \E_USER_WARNING); return false; } throw new \ValueError('Argument #2 ($length) must be greater than 0'); } if (null === $encoding) { $encoding = mb_internal_encoding(); } if ('UTF-8' === $encoding = self::getEncoding($encoding)) { $rx = '/('; while (65535 < $split_length) { $rx .= '.{65535}'; $split_length -= 65535; } $rx .= '.{'.$split_length.'})/us'; return preg_split($rx, $string, -1, \PREG_SPLIT_DELIM_CAPTURE | \PREG_SPLIT_NO_EMPTY); } $result = []; $length = mb_strlen($string, $encoding); for ($i = 0; $i < $length; $i += $split_length) { $result[] = mb_substr($string, $i, $split_length, $encoding); } return $result; } public static function mb_strtolower($s, $encoding = null) { return self::mb_convert_case($s, \MB_CASE_LOWER, $encoding); } public static function mb_strtoupper($s, $encoding = null) { return self::mb_convert_case($s, \MB_CASE_UPPER, $encoding); } public static function mb_substitute_character($c = null) { if (null === $c) { return 'none'; } if (0 === strcasecmp($c, 'none')) { return true; } if (80000 > \PHP_VERSION_ID) { return false; } if (\is_int($c) || 'long' === $c || 'entity' === $c) { return false; } throw new \ValueError('Argument #1 ($substitute_character) must be "none", "long", "entity" or a valid codepoint'); } public static function mb_substr($s, $start, $length = null, $encoding = null) { $encoding = self::getEncoding($encoding); if ('CP850' === $encoding || 'ASCII' === $encoding) { return (string) substr($s, $start, null === $length ? 2147483647 : $length); } if ($start < 0) { $start = iconv_strlen($s, $encoding) + $start; if ($start < 0) { $start = 0; } } if (null === $length) { $length = 2147483647; } elseif ($length < 0) { $length = iconv_strlen($s, $encoding) + $length - $start; if ($length < 0) { return ''; } } return (string) iconv_substr($s, $start, $length, $encoding); } public static function mb_stripos($haystack, $needle, $offset = 0, $encoding = null) { $haystack = self::mb_convert_case($haystack, self::MB_CASE_FOLD, $encoding); $needle = self::mb_convert_case($needle, self::MB_CASE_FOLD, $encoding); return self::mb_strpos($haystack, $needle, $offset, $encoding); } public static function mb_stristr($haystack, $needle, $part = false, $encoding = null) { $pos = self::mb_stripos($haystack, $needle, 0, $encoding); return self::getSubpart($pos, $part, $haystack, $encoding); } public static function mb_strrchr($haystack, $needle, $part = false, $encoding = null) { $encoding = self::getEncoding($encoding); if ('CP850' === $encoding || 'ASCII' === $encoding) { $pos = strrpos($haystack, $needle); } else { $needle = self::mb_substr($needle, 0, 1, $encoding); $pos = iconv_strrpos($haystack, $needle, $encoding); } return self::getSubpart($pos, $part, $haystack, $encoding); } public static function mb_strrichr($haystack, $needle, $part = false, $encoding = null) { $needle = self::mb_substr($needle, 0, 1, $encoding); $pos = self::mb_strripos($haystack, $needle, $encoding); return self::getSubpart($pos, $part, $haystack, $encoding); } public static function mb_strripos($haystack, $needle, $offset = 0, $encoding = null) { $haystack = self::mb_convert_case($haystack, self::MB_CASE_FOLD, $encoding); $needle = self::mb_convert_case($needle, self::MB_CASE_FOLD, $encoding); return self::mb_strrpos($haystack, $needle, $offset, $encoding); } public static function mb_strstr($haystack, $needle, $part = false, $encoding = null) { $pos = strpos($haystack, $needle); if (false === $pos) { return false; } if ($part) { return substr($haystack, 0, $pos); } return substr($haystack, $pos); } public static function mb_get_info($type = 'all') { $info = [ 'internal_encoding' => self::$internalEncoding, 'http_output' => 'pass', 'http_output_conv_mimetypes' => '^(text/|application/xhtml\+xml)', 'func_overload' => 0, 'func_overload_list' => 'no overload', 'mail_charset' => 'UTF-8', 'mail_header_encoding' => 'BASE64', 'mail_body_encoding' => 'BASE64', 'illegal_chars' => 0, 'encoding_translation' => 'Off', 'language' => self::$language, 'detect_order' => self::$encodingList, 'substitute_character' => 'none', 'strict_detection' => 'Off', ]; if ('all' === $type) { return $info; } if (isset($info[$type])) { return $info[$type]; } return false; } public static function mb_http_input($type = '') { return false; } public static function mb_http_output($encoding = null) { return null !== $encoding ? 'pass' === $encoding : 'pass'; } public static function mb_strwidth($s, $encoding = null) { $encoding = self::getEncoding($encoding); if ('UTF-8' !== $encoding) { $s = iconv($encoding, 'UTF-8//IGNORE', $s); } $s = preg_replace('/[\x{1100}-\x{115F}\x{2329}\x{232A}\x{2E80}-\x{303E}\x{3040}-\x{A4CF}\x{AC00}-\x{D7A3}\x{F900}-\x{FAFF}\x{FE10}-\x{FE19}\x{FE30}-\x{FE6F}\x{FF00}-\x{FF60}\x{FFE0}-\x{FFE6}\x{20000}-\x{2FFFD}\x{30000}-\x{3FFFD}]/u', '', $s, -1, $wide); return ($wide << 1) + iconv_strlen($s, 'UTF-8'); } public static function mb_substr_count($haystack, $needle, $encoding = null) { return substr_count($haystack, $needle); } public static function mb_output_handler($contents, $status) { return $contents; } public static function mb_chr($code, $encoding = null) { if (0x80 > $code %= 0x200000) { $s = \chr($code); } elseif (0x800 > $code) { $s = \chr(0xC0 | $code >> 6).\chr(0x80 | $code & 0x3F); } elseif (0x10000 > $code) { $s = \chr(0xE0 | $code >> 12).\chr(0x80 | $code >> 6 & 0x3F).\chr(0x80 | $code & 0x3F); } else { $s = \chr(0xF0 | $code >> 18).\chr(0x80 | $code >> 12 & 0x3F).\chr(0x80 | $code >> 6 & 0x3F).\chr(0x80 | $code & 0x3F); } if ('UTF-8' !== $encoding = self::getEncoding($encoding)) { $s = mb_convert_encoding($s, $encoding, 'UTF-8'); } return $s; } public static function mb_ord($s, $encoding = null) { if ('UTF-8' !== $encoding = self::getEncoding($encoding)) { $s = mb_convert_encoding($s, 'UTF-8', $encoding); } if (1 === \strlen($s)) { return \ord($s); } $code = ($s = unpack('C*', substr($s, 0, 4))) ? $s[1] : 0; if (0xF0 <= $code) { return (($code - 0xF0) << 18) + (($s[2] - 0x80) << 12) + (($s[3] - 0x80) << 6) + $s[4] - 0x80; } if (0xE0 <= $code) { return (($code - 0xE0) << 12) + (($s[2] - 0x80) << 6) + $s[3] - 0x80; } if (0xC0 <= $code) { return (($code - 0xC0) << 6) + $s[2] - 0x80; } return $code; } private static function getSubpart($pos, $part, $haystack, $encoding) { if (false === $pos) { return false; } if ($part) { return self::mb_substr($haystack, 0, $pos, $encoding); } return self::mb_substr($haystack, $pos, null, $encoding); } private static function html_encoding_callback(array $m) { $i = 1; $entities = ''; $m = unpack('C*', htmlentities($m[0], \ENT_COMPAT, 'UTF-8')); while (isset($m[$i])) { if (0x80 > $m[$i]) { $entities .= \chr($m[$i++]); continue; } if (0xF0 <= $m[$i]) { $c = (($m[$i++] - 0xF0) << 18) + (($m[$i++] - 0x80) << 12) + (($m[$i++] - 0x80) << 6) + $m[$i++] - 0x80; } elseif (0xE0 <= $m[$i]) { $c = (($m[$i++] - 0xE0) << 12) + (($m[$i++] - 0x80) << 6) + $m[$i++] - 0x80; } else { $c = (($m[$i++] - 0xC0) << 6) + $m[$i++] - 0x80; } $entities .= '&#'.$c.';'; } return $entities; } private static function title_case(array $s) { return self::mb_convert_case($s[1], \MB_CASE_UPPER, 'UTF-8').self::mb_convert_case($s[2], \MB_CASE_LOWER, 'UTF-8'); } private static function getData($file) { if (file_exists($file = __DIR__.'/Resources/unidata/'.$file.'.php')) { return require $file; } return false; } private static function getEncoding($encoding) { if (null === $encoding) { return self::$internalEncoding; } if ('UTF-8' === $encoding) { return 'UTF-8'; } $encoding = strtoupper($encoding); if ('8BIT' === $encoding || 'BINARY' === $encoding) { return 'CP850'; } if ('UTF8' === $encoding) { return 'UTF-8'; } return $encoding; } } { "name": "symfony/polyfill-mbstring", "type": "library", "description": "Symfony polyfill for the Mbstring extension", "keywords": ["polyfill", "shim", "compatibility", "portable", "mbstring"], "homepage": "https://symfony.com", "license": "MIT", "authors": [ { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "require": { "php": ">=7.1" }, "provide": { "ext-mbstring": "*" }, "autoload": { "psr-4": { "Symfony\\Polyfill\\Mbstring\\": "" }, "files": [ "bootstrap.php" ] }, "suggest": { "ext-mbstring": "For best performance" }, "minimum-stability": "dev", "extra": { "branch-alias": { "dev-main": "1.27-dev" }, "thanks": { "name": "symfony/polyfill", "url": "https://github.com/symfony/polyfill" } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ use Symfony\Polyfill\Mbstring as p; if (\PHP_VERSION_ID >= 80000) { return require __DIR__.'/bootstrap80.php'; } if (!function_exists('mb_convert_encoding')) { function mb_convert_encoding($string, $to_encoding, $from_encoding = null) { return p\Mbstring::mb_convert_encoding($string, $to_encoding, $from_encoding); } } if (!function_exists('mb_decode_mimeheader')) { function mb_decode_mimeheader($string) { return p\Mbstring::mb_decode_mimeheader($string); } } if (!function_exists('mb_encode_mimeheader')) { function mb_encode_mimeheader($string, $charset = null, $transfer_encoding = null, $newline = "\r\n", $indent = 0) { return p\Mbstring::mb_encode_mimeheader($string, $charset, $transfer_encoding, $newline, $indent); } } if (!function_exists('mb_decode_numericentity')) { function mb_decode_numericentity($string, $map, $encoding = null) { return p\Mbstring::mb_decode_numericentity($string, $map, $encoding); } } if (!function_exists('mb_encode_numericentity')) { function mb_encode_numericentity($string, $map, $encoding = null, $hex = false) { return p\Mbstring::mb_encode_numericentity($string, $map, $encoding, $hex); } } if (!function_exists('mb_convert_case')) { function mb_convert_case($string, $mode, $encoding = null) { return p\Mbstring::mb_convert_case($string, $mode, $encoding); } } if (!function_exists('mb_internal_encoding')) { function mb_internal_encoding($encoding = null) { return p\Mbstring::mb_internal_encoding($encoding); } } if (!function_exists('mb_language')) { function mb_language($language = null) { return p\Mbstring::mb_language($language); } } if (!function_exists('mb_list_encodings')) { function mb_list_encodings() { return p\Mbstring::mb_list_encodings(); } } if (!function_exists('mb_encoding_aliases')) { function mb_encoding_aliases($encoding) { return p\Mbstring::mb_encoding_aliases($encoding); } } if (!function_exists('mb_check_encoding')) { function mb_check_encoding($value = null, $encoding = null) { return p\Mbstring::mb_check_encoding($value, $encoding); } } if (!function_exists('mb_detect_encoding')) { function mb_detect_encoding($string, $encodings = null, $strict = false) { return p\Mbstring::mb_detect_encoding($string, $encodings, $strict); } } if (!function_exists('mb_detect_order')) { function mb_detect_order($encoding = null) { return p\Mbstring::mb_detect_order($encoding); } } if (!function_exists('mb_parse_str')) { function mb_parse_str($string, &$result = []) { parse_str($string, $result); return (bool) $result; } } if (!function_exists('mb_strlen')) { function mb_strlen($string, $encoding = null) { return p\Mbstring::mb_strlen($string, $encoding); } } if (!function_exists('mb_strpos')) { function mb_strpos($haystack, $needle, $offset = 0, $encoding = null) { return p\Mbstring::mb_strpos($haystack, $needle, $offset, $encoding); } } if (!function_exists('mb_strtolower')) { function mb_strtolower($string, $encoding = null) { return p\Mbstring::mb_strtolower($string, $encoding); } } if (!function_exists('mb_strtoupper')) { function mb_strtoupper($string, $encoding = null) { return p\Mbstring::mb_strtoupper($string, $encoding); } } if (!function_exists('mb_substitute_character')) { function mb_substitute_character($substitute_character = null) { return p\Mbstring::mb_substitute_character($substitute_character); } } if (!function_exists('mb_substr')) { function mb_substr($string, $start, $length = 2147483647, $encoding = null) { return p\Mbstring::mb_substr($string, $start, $length, $encoding); } } if (!function_exists('mb_stripos')) { function mb_stripos($haystack, $needle, $offset = 0, $encoding = null) { return p\Mbstring::mb_stripos($haystack, $needle, $offset, $encoding); } } if (!function_exists('mb_stristr')) { function mb_stristr($haystack, $needle, $before_needle = false, $encoding = null) { return p\Mbstring::mb_stristr($haystack, $needle, $before_needle, $encoding); } } if (!function_exists('mb_strrchr')) { function mb_strrchr($haystack, $needle, $before_needle = false, $encoding = null) { return p\Mbstring::mb_strrchr($haystack, $needle, $before_needle, $encoding); } } if (!function_exists('mb_strrichr')) { function mb_strrichr($haystack, $needle, $before_needle = false, $encoding = null) { return p\Mbstring::mb_strrichr($haystack, $needle, $before_needle, $encoding); } } if (!function_exists('mb_strripos')) { function mb_strripos($haystack, $needle, $offset = 0, $encoding = null) { return p\Mbstring::mb_strripos($haystack, $needle, $offset, $encoding); } } if (!function_exists('mb_strrpos')) { function mb_strrpos($haystack, $needle, $offset = 0, $encoding = null) { return p\Mbstring::mb_strrpos($haystack, $needle, $offset, $encoding); } } if (!function_exists('mb_strstr')) { function mb_strstr($haystack, $needle, $before_needle = false, $encoding = null) { return p\Mbstring::mb_strstr($haystack, $needle, $before_needle, $encoding); } } if (!function_exists('mb_get_info')) { function mb_get_info($type = 'all') { return p\Mbstring::mb_get_info($type); } } if (!function_exists('mb_http_output')) { function mb_http_output($encoding = null) { return p\Mbstring::mb_http_output($encoding); } } if (!function_exists('mb_strwidth')) { function mb_strwidth($string, $encoding = null) { return p\Mbstring::mb_strwidth($string, $encoding); } } if (!function_exists('mb_substr_count')) { function mb_substr_count($haystack, $needle, $encoding = null) { return p\Mbstring::mb_substr_count($haystack, $needle, $encoding); } } if (!function_exists('mb_output_handler')) { function mb_output_handler($string, $status) { return p\Mbstring::mb_output_handler($string, $status); } } if (!function_exists('mb_http_input')) { function mb_http_input($type = null) { return p\Mbstring::mb_http_input($type); } } if (!function_exists('mb_convert_variables')) { function mb_convert_variables($to_encoding, $from_encoding, &...$vars) { return p\Mbstring::mb_convert_variables($to_encoding, $from_encoding, ...$vars); } } if (!function_exists('mb_ord')) { function mb_ord($string, $encoding = null) { return p\Mbstring::mb_ord($string, $encoding); } } if (!function_exists('mb_chr')) { function mb_chr($codepoint, $encoding = null) { return p\Mbstring::mb_chr($codepoint, $encoding); } } if (!function_exists('mb_scrub')) { function mb_scrub($string, $encoding = null) { $encoding = null === $encoding ? mb_internal_encoding() : $encoding; return mb_convert_encoding($string, $encoding, $encoding); } } if (!function_exists('mb_str_split')) { function mb_str_split($string, $length = 1, $encoding = null) { return p\Mbstring::mb_str_split($string, $length, $encoding); } } if (extension_loaded('mbstring')) { return; } if (!defined('MB_CASE_UPPER')) { define('MB_CASE_UPPER', 0); } if (!defined('MB_CASE_LOWER')) { define('MB_CASE_LOWER', 1); } if (!defined('MB_CASE_TITLE')) { define('MB_CASE_TITLE', 2); } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ use Symfony\Polyfill\Mbstring as p; if (!function_exists('mb_convert_encoding')) { function mb_convert_encoding(array|string|null $string, ?string $to_encoding, array|string|null $from_encoding = null): array|string|false { return p\Mbstring::mb_convert_encoding($string ?? '', (string) $to_encoding, $from_encoding); } } if (!function_exists('mb_decode_mimeheader')) { function mb_decode_mimeheader(?string $string): string { return p\Mbstring::mb_decode_mimeheader((string) $string); } } if (!function_exists('mb_encode_mimeheader')) { function mb_encode_mimeheader(?string $string, ?string $charset = null, ?string $transfer_encoding = null, ?string $newline = "\r\n", ?int $indent = 0): string { return p\Mbstring::mb_encode_mimeheader((string) $string, $charset, $transfer_encoding, (string) $newline, (int) $indent); } } if (!function_exists('mb_decode_numericentity')) { function mb_decode_numericentity(?string $string, array $map, ?string $encoding = null): string { return p\Mbstring::mb_decode_numericentity((string) $string, $map, $encoding); } } if (!function_exists('mb_encode_numericentity')) { function mb_encode_numericentity(?string $string, array $map, ?string $encoding = null, ?bool $hex = false): string { return p\Mbstring::mb_encode_numericentity((string) $string, $map, $encoding, (bool) $hex); } } if (!function_exists('mb_convert_case')) { function mb_convert_case(?string $string, ?int $mode, ?string $encoding = null): string { return p\Mbstring::mb_convert_case((string) $string, (int) $mode, $encoding); } } if (!function_exists('mb_internal_encoding')) { function mb_internal_encoding(?string $encoding = null): string|bool { return p\Mbstring::mb_internal_encoding($encoding); } } if (!function_exists('mb_language')) { function mb_language(?string $language = null): string|bool { return p\Mbstring::mb_language($language); } } if (!function_exists('mb_list_encodings')) { function mb_list_encodings(): array { return p\Mbstring::mb_list_encodings(); } } if (!function_exists('mb_encoding_aliases')) { function mb_encoding_aliases(?string $encoding): array { return p\Mbstring::mb_encoding_aliases((string) $encoding); } } if (!function_exists('mb_check_encoding')) { function mb_check_encoding(array|string|null $value = null, ?string $encoding = null): bool { return p\Mbstring::mb_check_encoding($value, $encoding); } } if (!function_exists('mb_detect_encoding')) { function mb_detect_encoding(?string $string, array|string|null $encodings = null, ?bool $strict = false): string|false { return p\Mbstring::mb_detect_encoding((string) $string, $encodings, (bool) $strict); } } if (!function_exists('mb_detect_order')) { function mb_detect_order(array|string|null $encoding = null): array|bool { return p\Mbstring::mb_detect_order($encoding); } } if (!function_exists('mb_parse_str')) { function mb_parse_str(?string $string, &$result = []): bool { parse_str((string) $string, $result); return (bool) $result; } } if (!function_exists('mb_strlen')) { function mb_strlen(?string $string, ?string $encoding = null): int { return p\Mbstring::mb_strlen((string) $string, $encoding); } } if (!function_exists('mb_strpos')) { function mb_strpos(?string $haystack, ?string $needle, ?int $offset = 0, ?string $encoding = null): int|false { return p\Mbstring::mb_strpos((string) $haystack, (string) $needle, (int) $offset, $encoding); } } if (!function_exists('mb_strtolower')) { function mb_strtolower(?string $string, ?string $encoding = null): string { return p\Mbstring::mb_strtolower((string) $string, $encoding); } } if (!function_exists('mb_strtoupper')) { function mb_strtoupper(?string $string, ?string $encoding = null): string { return p\Mbstring::mb_strtoupper((string) $string, $encoding); } } if (!function_exists('mb_substitute_character')) { function mb_substitute_character(string|int|null $substitute_character = null): string|int|bool { return p\Mbstring::mb_substitute_character($substitute_character); } } if (!function_exists('mb_substr')) { function mb_substr(?string $string, ?int $start, ?int $length = null, ?string $encoding = null): string { return p\Mbstring::mb_substr((string) $string, (int) $start, $length, $encoding); } } if (!function_exists('mb_stripos')) { function mb_stripos(?string $haystack, ?string $needle, ?int $offset = 0, ?string $encoding = null): int|false { return p\Mbstring::mb_stripos((string) $haystack, (string) $needle, (int) $offset, $encoding); } } if (!function_exists('mb_stristr')) { function mb_stristr(?string $haystack, ?string $needle, ?bool $before_needle = false, ?string $encoding = null): string|false { return p\Mbstring::mb_stristr((string) $haystack, (string) $needle, (bool) $before_needle, $encoding); } } if (!function_exists('mb_strrchr')) { function mb_strrchr(?string $haystack, ?string $needle, ?bool $before_needle = false, ?string $encoding = null): string|false { return p\Mbstring::mb_strrchr((string) $haystack, (string) $needle, (bool) $before_needle, $encoding); } } if (!function_exists('mb_strrichr')) { function mb_strrichr(?string $haystack, ?string $needle, ?bool $before_needle = false, ?string $encoding = null): string|false { return p\Mbstring::mb_strrichr((string) $haystack, (string) $needle, (bool) $before_needle, $encoding); } } if (!function_exists('mb_strripos')) { function mb_strripos(?string $haystack, ?string $needle, ?int $offset = 0, ?string $encoding = null): int|false { return p\Mbstring::mb_strripos((string) $haystack, (string) $needle, (int) $offset, $encoding); } } if (!function_exists('mb_strrpos')) { function mb_strrpos(?string $haystack, ?string $needle, ?int $offset = 0, ?string $encoding = null): int|false { return p\Mbstring::mb_strrpos((string) $haystack, (string) $needle, (int) $offset, $encoding); } } if (!function_exists('mb_strstr')) { function mb_strstr(?string $haystack, ?string $needle, ?bool $before_needle = false, ?string $encoding = null): string|false { return p\Mbstring::mb_strstr((string) $haystack, (string) $needle, (bool) $before_needle, $encoding); } } if (!function_exists('mb_get_info')) { function mb_get_info(?string $type = 'all'): array|string|int|false { return p\Mbstring::mb_get_info((string) $type); } } if (!function_exists('mb_http_output')) { function mb_http_output(?string $encoding = null): string|bool { return p\Mbstring::mb_http_output($encoding); } } if (!function_exists('mb_strwidth')) { function mb_strwidth(?string $string, ?string $encoding = null): int { return p\Mbstring::mb_strwidth((string) $string, $encoding); } } if (!function_exists('mb_substr_count')) { function mb_substr_count(?string $haystack, ?string $needle, ?string $encoding = null): int { return p\Mbstring::mb_substr_count((string) $haystack, (string) $needle, $encoding); } } if (!function_exists('mb_output_handler')) { function mb_output_handler(?string $string, ?int $status): string { return p\Mbstring::mb_output_handler((string) $string, (int) $status); } } if (!function_exists('mb_http_input')) { function mb_http_input(?string $type = null): array|string|false { return p\Mbstring::mb_http_input($type); } } if (!function_exists('mb_convert_variables')) { function mb_convert_variables(?string $to_encoding, array|string|null $from_encoding, mixed &$var, mixed &...$vars): string|false { return p\Mbstring::mb_convert_variables((string) $to_encoding, $from_encoding ?? '', $var, ...$vars); } } if (!function_exists('mb_ord')) { function mb_ord(?string $string, ?string $encoding = null): int|false { return p\Mbstring::mb_ord((string) $string, $encoding); } } if (!function_exists('mb_chr')) { function mb_chr(?int $codepoint, ?string $encoding = null): string|false { return p\Mbstring::mb_chr((int) $codepoint, $encoding); } } if (!function_exists('mb_scrub')) { function mb_scrub(?string $string, ?string $encoding = null): string { $encoding ??= mb_internal_encoding(); return mb_convert_encoding((string) $string, $encoding, $encoding); } } if (!function_exists('mb_str_split')) { function mb_str_split(?string $string, ?int $length = 1, ?string $encoding = null): array { return p\Mbstring::mb_str_split((string) $string, (int) $length, $encoding); } } if (extension_loaded('mbstring')) { return; } if (!defined('MB_CASE_UPPER')) { define('MB_CASE_UPPER', 0); } if (!defined('MB_CASE_LOWER')) { define('MB_CASE_LOWER', 1); } if (!defined('MB_CASE_TITLE')) { define('MB_CASE_TITLE', 2); } 'a', 'B' => 'b', 'C' => 'c', 'D' => 'd', 'E' => 'e', 'F' => 'f', 'G' => 'g', 'H' => 'h', 'I' => 'i', 'J' => 'j', 'K' => 'k', 'L' => 'l', 'M' => 'm', 'N' => 'n', 'O' => 'o', 'P' => 'p', 'Q' => 'q', 'R' => 'r', 'S' => 's', 'T' => 't', 'U' => 'u', 'V' => 'v', 'W' => 'w', 'X' => 'x', 'Y' => 'y', 'Z' => 'z', 'À' => 'à', 'Á' => 'á', 'Â' => 'â', 'Ã' => 'ã', 'Ä' => 'ä', 'Å' => 'å', 'Æ' => 'æ', 'Ç' => 'ç', 'È' => 'è', 'É' => 'é', 'Ê' => 'ê', 'Ë' => 'ë', 'Ì' => 'ì', 'Í' => 'í', 'Î' => 'î', 'Ï' => 'ï', 'Ð' => 'ð', 'Ñ' => 'ñ', 'Ò' => 'ò', 'Ó' => 'ó', 'Ô' => 'ô', 'Õ' => 'õ', 'Ö' => 'ö', 'Ø' => 'ø', 'Ù' => 'ù', 'Ú' => 'ú', 'Û' => 'û', 'Ü' => 'ü', 'Ý' => 'ý', 'Þ' => 'þ', 'Ā' => 'ā', 'Ă' => 'ă', 'Ą' => 'ą', 'Ć' => 'ć', 'Ĉ' => 'ĉ', 'Ċ' => 'ċ', 'Č' => 'č', 'Ď' => 'ď', 'Đ' => 'đ', 'Ē' => 'ē', 'Ĕ' => 'ĕ', 'Ė' => 'ė', 'Ę' => 'ę', 'Ě' => 'ě', 'Ĝ' => 'ĝ', 'Ğ' => 'ğ', 'Ġ' => 'ġ', 'Ģ' => 'ģ', 'Ĥ' => 'ĥ', 'Ħ' => 'ħ', 'Ĩ' => 'ĩ', 'Ī' => 'ī', 'Ĭ' => 'ĭ', 'Į' => 'į', 'İ' => 'i̇', 'IJ' => 'ij', 'Ĵ' => 'ĵ', 'Ķ' => 'ķ', 'Ĺ' => 'ĺ', 'Ļ' => 'ļ', 'Ľ' => 'ľ', 'Ŀ' => 'ŀ', 'Ł' => 'ł', 'Ń' => 'ń', 'Ņ' => 'ņ', 'Ň' => 'ň', 'Ŋ' => 'ŋ', 'Ō' => 'ō', 'Ŏ' => 'ŏ', 'Ő' => 'ő', 'Œ' => 'œ', 'Ŕ' => 'ŕ', 'Ŗ' => 'ŗ', 'Ř' => 'ř', 'Ś' => 'ś', 'Ŝ' => 'ŝ', 'Ş' => 'ş', 'Š' => 'š', 'Ţ' => 'ţ', 'Ť' => 'ť', 'Ŧ' => 'ŧ', 'Ũ' => 'ũ', 'Ū' => 'ū', 'Ŭ' => 'ŭ', 'Ů' => 'ů', 'Ű' => 'ű', 'Ų' => 'ų', 'Ŵ' => 'ŵ', 'Ŷ' => 'ŷ', 'Ÿ' => 'ÿ', 'Ź' => 'ź', 'Ż' => 'ż', 'Ž' => 'ž', 'Ɓ' => 'ɓ', 'Ƃ' => 'ƃ', 'Ƅ' => 'ƅ', 'Ɔ' => 'ɔ', 'Ƈ' => 'ƈ', 'Ɖ' => 'ɖ', 'Ɗ' => 'ɗ', 'Ƌ' => 'ƌ', 'Ǝ' => 'ǝ', 'Ə' => 'ə', 'Ɛ' => 'ɛ', 'Ƒ' => 'ƒ', 'Ɠ' => 'ɠ', 'Ɣ' => 'ɣ', 'Ɩ' => 'ɩ', 'Ɨ' => 'ɨ', 'Ƙ' => 'ƙ', 'Ɯ' => 'ɯ', 'Ɲ' => 'ɲ', 'Ɵ' => 'ɵ', 'Ơ' => 'ơ', 'Ƣ' => 'ƣ', 'Ƥ' => 'ƥ', 'Ʀ' => 'ʀ', 'Ƨ' => 'ƨ', 'Ʃ' => 'ʃ', 'Ƭ' => 'ƭ', 'Ʈ' => 'ʈ', 'Ư' => 'ư', 'Ʊ' => 'ʊ', 'Ʋ' => 'ʋ', 'Ƴ' => 'ƴ', 'Ƶ' => 'ƶ', 'Ʒ' => 'ʒ', 'Ƹ' => 'ƹ', 'Ƽ' => 'ƽ', 'DŽ' => 'dž', 'Dž' => 'dž', 'LJ' => 'lj', 'Lj' => 'lj', 'NJ' => 'nj', 'Nj' => 'nj', 'Ǎ' => 'ǎ', 'Ǐ' => 'ǐ', 'Ǒ' => 'ǒ', 'Ǔ' => 'ǔ', 'Ǖ' => 'ǖ', 'Ǘ' => 'ǘ', 'Ǚ' => 'ǚ', 'Ǜ' => 'ǜ', 'Ǟ' => 'ǟ', 'Ǡ' => 'ǡ', 'Ǣ' => 'ǣ', 'Ǥ' => 'ǥ', 'Ǧ' => 'ǧ', 'Ǩ' => 'ǩ', 'Ǫ' => 'ǫ', 'Ǭ' => 'ǭ', 'Ǯ' => 'ǯ', 'DZ' => 'dz', 'Dz' => 'dz', 'Ǵ' => 'ǵ', 'Ƕ' => 'ƕ', 'Ƿ' => 'ƿ', 'Ǹ' => 'ǹ', 'Ǻ' => 'ǻ', 'Ǽ' => 'ǽ', 'Ǿ' => 'ǿ', 'Ȁ' => 'ȁ', 'Ȃ' => 'ȃ', 'Ȅ' => 'ȅ', 'Ȇ' => 'ȇ', 'Ȉ' => 'ȉ', 'Ȋ' => 'ȋ', 'Ȍ' => 'ȍ', 'Ȏ' => 'ȏ', 'Ȑ' => 'ȑ', 'Ȓ' => 'ȓ', 'Ȕ' => 'ȕ', 'Ȗ' => 'ȗ', 'Ș' => 'ș', 'Ț' => 'ț', 'Ȝ' => 'ȝ', 'Ȟ' => 'ȟ', 'Ƞ' => 'ƞ', 'Ȣ' => 'ȣ', 'Ȥ' => 'ȥ', 'Ȧ' => 'ȧ', 'Ȩ' => 'ȩ', 'Ȫ' => 'ȫ', 'Ȭ' => 'ȭ', 'Ȯ' => 'ȯ', 'Ȱ' => 'ȱ', 'Ȳ' => 'ȳ', 'Ⱥ' => 'ⱥ', 'Ȼ' => 'ȼ', 'Ƚ' => 'ƚ', 'Ⱦ' => 'ⱦ', 'Ɂ' => 'ɂ', 'Ƀ' => 'ƀ', 'Ʉ' => 'ʉ', 'Ʌ' => 'ʌ', 'Ɇ' => 'ɇ', 'Ɉ' => 'ɉ', 'Ɋ' => 'ɋ', 'Ɍ' => 'ɍ', 'Ɏ' => 'ɏ', 'Ͱ' => 'ͱ', 'Ͳ' => 'ͳ', 'Ͷ' => 'ͷ', 'Ϳ' => 'ϳ', 'Ά' => 'ά', 'Έ' => 'έ', 'Ή' => 'ή', 'Ί' => 'ί', 'Ό' => 'ό', 'Ύ' => 'ύ', 'Ώ' => 'ώ', 'Α' => 'α', 'Β' => 'β', 'Γ' => 'γ', 'Δ' => 'δ', 'Ε' => 'ε', 'Ζ' => 'ζ', 'Η' => 'η', 'Θ' => 'θ', 'Ι' => 'ι', 'Κ' => 'κ', 'Λ' => 'λ', 'Μ' => 'μ', 'Ν' => 'ν', 'Ξ' => 'ξ', 'Ο' => 'ο', 'Π' => 'π', 'Ρ' => 'ρ', 'Σ' => 'σ', 'Τ' => 'τ', 'Υ' => 'υ', 'Φ' => 'φ', 'Χ' => 'χ', 'Ψ' => 'ψ', 'Ω' => 'ω', 'Ϊ' => 'ϊ', 'Ϋ' => 'ϋ', 'Ϗ' => 'ϗ', 'Ϙ' => 'ϙ', 'Ϛ' => 'ϛ', 'Ϝ' => 'ϝ', 'Ϟ' => 'ϟ', 'Ϡ' => 'ϡ', 'Ϣ' => 'ϣ', 'Ϥ' => 'ϥ', 'Ϧ' => 'ϧ', 'Ϩ' => 'ϩ', 'Ϫ' => 'ϫ', 'Ϭ' => 'ϭ', 'Ϯ' => 'ϯ', 'ϴ' => 'θ', 'Ϸ' => 'ϸ', 'Ϲ' => 'ϲ', 'Ϻ' => 'ϻ', 'Ͻ' => 'ͻ', 'Ͼ' => 'ͼ', 'Ͽ' => 'ͽ', 'Ѐ' => 'ѐ', 'Ё' => 'ё', 'Ђ' => 'ђ', 'Ѓ' => 'ѓ', 'Є' => 'є', 'Ѕ' => 'ѕ', 'І' => 'і', 'Ї' => 'ї', 'Ј' => 'ј', 'Љ' => 'љ', 'Њ' => 'њ', 'Ћ' => 'ћ', 'Ќ' => 'ќ', 'Ѝ' => 'ѝ', 'Ў' => 'ў', 'Џ' => 'џ', 'А' => 'а', 'Б' => 'б', 'В' => 'в', 'Г' => 'г', 'Д' => 'д', 'Е' => 'е', 'Ж' => 'ж', 'З' => 'з', 'И' => 'и', 'Й' => 'й', 'К' => 'к', 'Л' => 'л', 'М' => 'м', 'Н' => 'н', 'О' => 'о', 'П' => 'п', 'Р' => 'р', 'С' => 'с', 'Т' => 'т', 'У' => 'у', 'Ф' => 'ф', 'Х' => 'х', 'Ц' => 'ц', 'Ч' => 'ч', 'Ш' => 'ш', 'Щ' => 'щ', 'Ъ' => 'ъ', 'Ы' => 'ы', 'Ь' => 'ь', 'Э' => 'э', 'Ю' => 'ю', 'Я' => 'я', 'Ѡ' => 'ѡ', 'Ѣ' => 'ѣ', 'Ѥ' => 'ѥ', 'Ѧ' => 'ѧ', 'Ѩ' => 'ѩ', 'Ѫ' => 'ѫ', 'Ѭ' => 'ѭ', 'Ѯ' => 'ѯ', 'Ѱ' => 'ѱ', 'Ѳ' => 'ѳ', 'Ѵ' => 'ѵ', 'Ѷ' => 'ѷ', 'Ѹ' => 'ѹ', 'Ѻ' => 'ѻ', 'Ѽ' => 'ѽ', 'Ѿ' => 'ѿ', 'Ҁ' => 'ҁ', 'Ҋ' => 'ҋ', 'Ҍ' => 'ҍ', 'Ҏ' => 'ҏ', 'Ґ' => 'ґ', 'Ғ' => 'ғ', 'Ҕ' => 'ҕ', 'Җ' => 'җ', 'Ҙ' => 'ҙ', 'Қ' => 'қ', 'Ҝ' => 'ҝ', 'Ҟ' => 'ҟ', 'Ҡ' => 'ҡ', 'Ң' => 'ң', 'Ҥ' => 'ҥ', 'Ҧ' => 'ҧ', 'Ҩ' => 'ҩ', 'Ҫ' => 'ҫ', 'Ҭ' => 'ҭ', 'Ү' => 'ү', 'Ұ' => 'ұ', 'Ҳ' => 'ҳ', 'Ҵ' => 'ҵ', 'Ҷ' => 'ҷ', 'Ҹ' => 'ҹ', 'Һ' => 'һ', 'Ҽ' => 'ҽ', 'Ҿ' => 'ҿ', 'Ӏ' => 'ӏ', 'Ӂ' => 'ӂ', 'Ӄ' => 'ӄ', 'Ӆ' => 'ӆ', 'Ӈ' => 'ӈ', 'Ӊ' => 'ӊ', 'Ӌ' => 'ӌ', 'Ӎ' => 'ӎ', 'Ӑ' => 'ӑ', 'Ӓ' => 'ӓ', 'Ӕ' => 'ӕ', 'Ӗ' => 'ӗ', 'Ә' => 'ә', 'Ӛ' => 'ӛ', 'Ӝ' => 'ӝ', 'Ӟ' => 'ӟ', 'Ӡ' => 'ӡ', 'Ӣ' => 'ӣ', 'Ӥ' => 'ӥ', 'Ӧ' => 'ӧ', 'Ө' => 'ө', 'Ӫ' => 'ӫ', 'Ӭ' => 'ӭ', 'Ӯ' => 'ӯ', 'Ӱ' => 'ӱ', 'Ӳ' => 'ӳ', 'Ӵ' => 'ӵ', 'Ӷ' => 'ӷ', 'Ӹ' => 'ӹ', 'Ӻ' => 'ӻ', 'Ӽ' => 'ӽ', 'Ӿ' => 'ӿ', 'Ԁ' => 'ԁ', 'Ԃ' => 'ԃ', 'Ԅ' => 'ԅ', 'Ԇ' => 'ԇ', 'Ԉ' => 'ԉ', 'Ԋ' => 'ԋ', 'Ԍ' => 'ԍ', 'Ԏ' => 'ԏ', 'Ԑ' => 'ԑ', 'Ԓ' => 'ԓ', 'Ԕ' => 'ԕ', 'Ԗ' => 'ԗ', 'Ԙ' => 'ԙ', 'Ԛ' => 'ԛ', 'Ԝ' => 'ԝ', 'Ԟ' => 'ԟ', 'Ԡ' => 'ԡ', 'Ԣ' => 'ԣ', 'Ԥ' => 'ԥ', 'Ԧ' => 'ԧ', 'Ԩ' => 'ԩ', 'Ԫ' => 'ԫ', 'Ԭ' => 'ԭ', 'Ԯ' => 'ԯ', 'Ա' => 'ա', 'Բ' => 'բ', 'Գ' => 'գ', 'Դ' => 'դ', 'Ե' => 'ե', 'Զ' => 'զ', 'Է' => 'է', 'Ը' => 'ը', 'Թ' => 'թ', 'Ժ' => 'ժ', 'Ի' => 'ի', 'Լ' => 'լ', 'Խ' => 'խ', 'Ծ' => 'ծ', 'Կ' => 'կ', 'Հ' => 'հ', 'Ձ' => 'ձ', 'Ղ' => 'ղ', 'Ճ' => 'ճ', 'Մ' => 'մ', 'Յ' => 'յ', 'Ն' => 'ն', 'Շ' => 'շ', 'Ո' => 'ո', 'Չ' => 'չ', 'Պ' => 'պ', 'Ջ' => 'ջ', 'Ռ' => 'ռ', 'Ս' => 'ս', 'Վ' => 'վ', 'Տ' => 'տ', 'Ր' => 'ր', 'Ց' => 'ց', 'Ւ' => 'ւ', 'Փ' => 'փ', 'Ք' => 'ք', 'Օ' => 'օ', 'Ֆ' => 'ֆ', 'Ⴀ' => 'ⴀ', 'Ⴁ' => 'ⴁ', 'Ⴂ' => 'ⴂ', 'Ⴃ' => 'ⴃ', 'Ⴄ' => 'ⴄ', 'Ⴅ' => 'ⴅ', 'Ⴆ' => 'ⴆ', 'Ⴇ' => 'ⴇ', 'Ⴈ' => 'ⴈ', 'Ⴉ' => 'ⴉ', 'Ⴊ' => 'ⴊ', 'Ⴋ' => 'ⴋ', 'Ⴌ' => 'ⴌ', 'Ⴍ' => 'ⴍ', 'Ⴎ' => 'ⴎ', 'Ⴏ' => 'ⴏ', 'Ⴐ' => 'ⴐ', 'Ⴑ' => 'ⴑ', 'Ⴒ' => 'ⴒ', 'Ⴓ' => 'ⴓ', 'Ⴔ' => 'ⴔ', 'Ⴕ' => 'ⴕ', 'Ⴖ' => 'ⴖ', 'Ⴗ' => 'ⴗ', 'Ⴘ' => 'ⴘ', 'Ⴙ' => 'ⴙ', 'Ⴚ' => 'ⴚ', 'Ⴛ' => 'ⴛ', 'Ⴜ' => 'ⴜ', 'Ⴝ' => 'ⴝ', 'Ⴞ' => 'ⴞ', 'Ⴟ' => 'ⴟ', 'Ⴠ' => 'ⴠ', 'Ⴡ' => 'ⴡ', 'Ⴢ' => 'ⴢ', 'Ⴣ' => 'ⴣ', 'Ⴤ' => 'ⴤ', 'Ⴥ' => 'ⴥ', 'Ⴧ' => 'ⴧ', 'Ⴭ' => 'ⴭ', 'Ꭰ' => 'ꭰ', 'Ꭱ' => 'ꭱ', 'Ꭲ' => 'ꭲ', 'Ꭳ' => 'ꭳ', 'Ꭴ' => 'ꭴ', 'Ꭵ' => 'ꭵ', 'Ꭶ' => 'ꭶ', 'Ꭷ' => 'ꭷ', 'Ꭸ' => 'ꭸ', 'Ꭹ' => 'ꭹ', 'Ꭺ' => 'ꭺ', 'Ꭻ' => 'ꭻ', 'Ꭼ' => 'ꭼ', 'Ꭽ' => 'ꭽ', 'Ꭾ' => 'ꭾ', 'Ꭿ' => 'ꭿ', 'Ꮀ' => 'ꮀ', 'Ꮁ' => 'ꮁ', 'Ꮂ' => 'ꮂ', 'Ꮃ' => 'ꮃ', 'Ꮄ' => 'ꮄ', 'Ꮅ' => 'ꮅ', 'Ꮆ' => 'ꮆ', 'Ꮇ' => 'ꮇ', 'Ꮈ' => 'ꮈ', 'Ꮉ' => 'ꮉ', 'Ꮊ' => 'ꮊ', 'Ꮋ' => 'ꮋ', 'Ꮌ' => 'ꮌ', 'Ꮍ' => 'ꮍ', 'Ꮎ' => 'ꮎ', 'Ꮏ' => 'ꮏ', 'Ꮐ' => 'ꮐ', 'Ꮑ' => 'ꮑ', 'Ꮒ' => 'ꮒ', 'Ꮓ' => 'ꮓ', 'Ꮔ' => 'ꮔ', 'Ꮕ' => 'ꮕ', 'Ꮖ' => 'ꮖ', 'Ꮗ' => 'ꮗ', 'Ꮘ' => 'ꮘ', 'Ꮙ' => 'ꮙ', 'Ꮚ' => 'ꮚ', 'Ꮛ' => 'ꮛ', 'Ꮜ' => 'ꮜ', 'Ꮝ' => 'ꮝ', 'Ꮞ' => 'ꮞ', 'Ꮟ' => 'ꮟ', 'Ꮠ' => 'ꮠ', 'Ꮡ' => 'ꮡ', 'Ꮢ' => 'ꮢ', 'Ꮣ' => 'ꮣ', 'Ꮤ' => 'ꮤ', 'Ꮥ' => 'ꮥ', 'Ꮦ' => 'ꮦ', 'Ꮧ' => 'ꮧ', 'Ꮨ' => 'ꮨ', 'Ꮩ' => 'ꮩ', 'Ꮪ' => 'ꮪ', 'Ꮫ' => 'ꮫ', 'Ꮬ' => 'ꮬ', 'Ꮭ' => 'ꮭ', 'Ꮮ' => 'ꮮ', 'Ꮯ' => 'ꮯ', 'Ꮰ' => 'ꮰ', 'Ꮱ' => 'ꮱ', 'Ꮲ' => 'ꮲ', 'Ꮳ' => 'ꮳ', 'Ꮴ' => 'ꮴ', 'Ꮵ' => 'ꮵ', 'Ꮶ' => 'ꮶ', 'Ꮷ' => 'ꮷ', 'Ꮸ' => 'ꮸ', 'Ꮹ' => 'ꮹ', 'Ꮺ' => 'ꮺ', 'Ꮻ' => 'ꮻ', 'Ꮼ' => 'ꮼ', 'Ꮽ' => 'ꮽ', 'Ꮾ' => 'ꮾ', 'Ꮿ' => 'ꮿ', 'Ᏸ' => 'ᏸ', 'Ᏹ' => 'ᏹ', 'Ᏺ' => 'ᏺ', 'Ᏻ' => 'ᏻ', 'Ᏼ' => 'ᏼ', 'Ᏽ' => 'ᏽ', 'Ა' => 'ა', 'Ბ' => 'ბ', 'Გ' => 'გ', 'Დ' => 'დ', 'Ე' => 'ე', 'Ვ' => 'ვ', 'Ზ' => 'ზ', 'Თ' => 'თ', 'Ი' => 'ი', 'Კ' => 'კ', 'Ლ' => 'ლ', 'Მ' => 'მ', 'Ნ' => 'ნ', 'Ო' => 'ო', 'Პ' => 'პ', 'Ჟ' => 'ჟ', 'Რ' => 'რ', 'Ს' => 'ს', 'Ტ' => 'ტ', 'Უ' => 'უ', 'Ფ' => 'ფ', 'Ქ' => 'ქ', 'Ღ' => 'ღ', 'Ყ' => 'ყ', 'Შ' => 'შ', 'Ჩ' => 'ჩ', 'Ც' => 'ც', 'Ძ' => 'ძ', 'Წ' => 'წ', 'Ჭ' => 'ჭ', 'Ხ' => 'ხ', 'Ჯ' => 'ჯ', 'Ჰ' => 'ჰ', 'Ჱ' => 'ჱ', 'Ჲ' => 'ჲ', 'Ჳ' => 'ჳ', 'Ჴ' => 'ჴ', 'Ჵ' => 'ჵ', 'Ჶ' => 'ჶ', 'Ჷ' => 'ჷ', 'Ჸ' => 'ჸ', 'Ჹ' => 'ჹ', 'Ჺ' => 'ჺ', 'Ჽ' => 'ჽ', 'Ჾ' => 'ჾ', 'Ჿ' => 'ჿ', 'Ḁ' => 'ḁ', 'Ḃ' => 'ḃ', 'Ḅ' => 'ḅ', 'Ḇ' => 'ḇ', 'Ḉ' => 'ḉ', 'Ḋ' => 'ḋ', 'Ḍ' => 'ḍ', 'Ḏ' => 'ḏ', 'Ḑ' => 'ḑ', 'Ḓ' => 'ḓ', 'Ḕ' => 'ḕ', 'Ḗ' => 'ḗ', 'Ḙ' => 'ḙ', 'Ḛ' => 'ḛ', 'Ḝ' => 'ḝ', 'Ḟ' => 'ḟ', 'Ḡ' => 'ḡ', 'Ḣ' => 'ḣ', 'Ḥ' => 'ḥ', 'Ḧ' => 'ḧ', 'Ḩ' => 'ḩ', 'Ḫ' => 'ḫ', 'Ḭ' => 'ḭ', 'Ḯ' => 'ḯ', 'Ḱ' => 'ḱ', 'Ḳ' => 'ḳ', 'Ḵ' => 'ḵ', 'Ḷ' => 'ḷ', 'Ḹ' => 'ḹ', 'Ḻ' => 'ḻ', 'Ḽ' => 'ḽ', 'Ḿ' => 'ḿ', 'Ṁ' => 'ṁ', 'Ṃ' => 'ṃ', 'Ṅ' => 'ṅ', 'Ṇ' => 'ṇ', 'Ṉ' => 'ṉ', 'Ṋ' => 'ṋ', 'Ṍ' => 'ṍ', 'Ṏ' => 'ṏ', 'Ṑ' => 'ṑ', 'Ṓ' => 'ṓ', 'Ṕ' => 'ṕ', 'Ṗ' => 'ṗ', 'Ṙ' => 'ṙ', 'Ṛ' => 'ṛ', 'Ṝ' => 'ṝ', 'Ṟ' => 'ṟ', 'Ṡ' => 'ṡ', 'Ṣ' => 'ṣ', 'Ṥ' => 'ṥ', 'Ṧ' => 'ṧ', 'Ṩ' => 'ṩ', 'Ṫ' => 'ṫ', 'Ṭ' => 'ṭ', 'Ṯ' => 'ṯ', 'Ṱ' => 'ṱ', 'Ṳ' => 'ṳ', 'Ṵ' => 'ṵ', 'Ṷ' => 'ṷ', 'Ṹ' => 'ṹ', 'Ṻ' => 'ṻ', 'Ṽ' => 'ṽ', 'Ṿ' => 'ṿ', 'Ẁ' => 'ẁ', 'Ẃ' => 'ẃ', 'Ẅ' => 'ẅ', 'Ẇ' => 'ẇ', 'Ẉ' => 'ẉ', 'Ẋ' => 'ẋ', 'Ẍ' => 'ẍ', 'Ẏ' => 'ẏ', 'Ẑ' => 'ẑ', 'Ẓ' => 'ẓ', 'Ẕ' => 'ẕ', 'ẞ' => 'ß', 'Ạ' => 'ạ', 'Ả' => 'ả', 'Ấ' => 'ấ', 'Ầ' => 'ầ', 'Ẩ' => 'ẩ', 'Ẫ' => 'ẫ', 'Ậ' => 'ậ', 'Ắ' => 'ắ', 'Ằ' => 'ằ', 'Ẳ' => 'ẳ', 'Ẵ' => 'ẵ', 'Ặ' => 'ặ', 'Ẹ' => 'ẹ', 'Ẻ' => 'ẻ', 'Ẽ' => 'ẽ', 'Ế' => 'ế', 'Ề' => 'ề', 'Ể' => 'ể', 'Ễ' => 'ễ', 'Ệ' => 'ệ', 'Ỉ' => 'ỉ', 'Ị' => 'ị', 'Ọ' => 'ọ', 'Ỏ' => 'ỏ', 'Ố' => 'ố', 'Ồ' => 'ồ', 'Ổ' => 'ổ', 'Ỗ' => 'ỗ', 'Ộ' => 'ộ', 'Ớ' => 'ớ', 'Ờ' => 'ờ', 'Ở' => 'ở', 'Ỡ' => 'ỡ', 'Ợ' => 'ợ', 'Ụ' => 'ụ', 'Ủ' => 'ủ', 'Ứ' => 'ứ', 'Ừ' => 'ừ', 'Ử' => 'ử', 'Ữ' => 'ữ', 'Ự' => 'ự', 'Ỳ' => 'ỳ', 'Ỵ' => 'ỵ', 'Ỷ' => 'ỷ', 'Ỹ' => 'ỹ', 'Ỻ' => 'ỻ', 'Ỽ' => 'ỽ', 'Ỿ' => 'ỿ', 'Ἀ' => 'ἀ', 'Ἁ' => 'ἁ', 'Ἂ' => 'ἂ', 'Ἃ' => 'ἃ', 'Ἄ' => 'ἄ', 'Ἅ' => 'ἅ', 'Ἆ' => 'ἆ', 'Ἇ' => 'ἇ', 'Ἐ' => 'ἐ', 'Ἑ' => 'ἑ', 'Ἒ' => 'ἒ', 'Ἓ' => 'ἓ', 'Ἔ' => 'ἔ', 'Ἕ' => 'ἕ', 'Ἠ' => 'ἠ', 'Ἡ' => 'ἡ', 'Ἢ' => 'ἢ', 'Ἣ' => 'ἣ', 'Ἤ' => 'ἤ', 'Ἥ' => 'ἥ', 'Ἦ' => 'ἦ', 'Ἧ' => 'ἧ', 'Ἰ' => 'ἰ', 'Ἱ' => 'ἱ', 'Ἲ' => 'ἲ', 'Ἳ' => 'ἳ', 'Ἴ' => 'ἴ', 'Ἵ' => 'ἵ', 'Ἶ' => 'ἶ', 'Ἷ' => 'ἷ', 'Ὀ' => 'ὀ', 'Ὁ' => 'ὁ', 'Ὂ' => 'ὂ', 'Ὃ' => 'ὃ', 'Ὄ' => 'ὄ', 'Ὅ' => 'ὅ', 'Ὑ' => 'ὑ', 'Ὓ' => 'ὓ', 'Ὕ' => 'ὕ', 'Ὗ' => 'ὗ', 'Ὠ' => 'ὠ', 'Ὡ' => 'ὡ', 'Ὢ' => 'ὢ', 'Ὣ' => 'ὣ', 'Ὤ' => 'ὤ', 'Ὥ' => 'ὥ', 'Ὦ' => 'ὦ', 'Ὧ' => 'ὧ', 'ᾈ' => 'ᾀ', 'ᾉ' => 'ᾁ', 'ᾊ' => 'ᾂ', 'ᾋ' => 'ᾃ', 'ᾌ' => 'ᾄ', 'ᾍ' => 'ᾅ', 'ᾎ' => 'ᾆ', 'ᾏ' => 'ᾇ', 'ᾘ' => 'ᾐ', 'ᾙ' => 'ᾑ', 'ᾚ' => 'ᾒ', 'ᾛ' => 'ᾓ', 'ᾜ' => 'ᾔ', 'ᾝ' => 'ᾕ', 'ᾞ' => 'ᾖ', 'ᾟ' => 'ᾗ', 'ᾨ' => 'ᾠ', 'ᾩ' => 'ᾡ', 'ᾪ' => 'ᾢ', 'ᾫ' => 'ᾣ', 'ᾬ' => 'ᾤ', 'ᾭ' => 'ᾥ', 'ᾮ' => 'ᾦ', 'ᾯ' => 'ᾧ', 'Ᾰ' => 'ᾰ', 'Ᾱ' => 'ᾱ', 'Ὰ' => 'ὰ', 'Ά' => 'ά', 'ᾼ' => 'ᾳ', 'Ὲ' => 'ὲ', 'Έ' => 'έ', 'Ὴ' => 'ὴ', 'Ή' => 'ή', 'ῌ' => 'ῃ', 'Ῐ' => 'ῐ', 'Ῑ' => 'ῑ', 'Ὶ' => 'ὶ', 'Ί' => 'ί', 'Ῠ' => 'ῠ', 'Ῡ' => 'ῡ', 'Ὺ' => 'ὺ', 'Ύ' => 'ύ', 'Ῥ' => 'ῥ', 'Ὸ' => 'ὸ', 'Ό' => 'ό', 'Ὼ' => 'ὼ', 'Ώ' => 'ώ', 'ῼ' => 'ῳ', 'Ω' => 'ω', 'K' => 'k', 'Å' => 'å', 'Ⅎ' => 'ⅎ', 'Ⅰ' => 'ⅰ', 'Ⅱ' => 'ⅱ', 'Ⅲ' => 'ⅲ', 'Ⅳ' => 'ⅳ', 'Ⅴ' => 'ⅴ', 'Ⅵ' => 'ⅵ', 'Ⅶ' => 'ⅶ', 'Ⅷ' => 'ⅷ', 'Ⅸ' => 'ⅸ', 'Ⅹ' => 'ⅹ', 'Ⅺ' => 'ⅺ', 'Ⅻ' => 'ⅻ', 'Ⅼ' => 'ⅼ', 'Ⅽ' => 'ⅽ', 'Ⅾ' => 'ⅾ', 'Ⅿ' => 'ⅿ', 'Ↄ' => 'ↄ', 'Ⓐ' => 'ⓐ', 'Ⓑ' => 'ⓑ', 'Ⓒ' => 'ⓒ', 'Ⓓ' => 'ⓓ', 'Ⓔ' => 'ⓔ', 'Ⓕ' => 'ⓕ', 'Ⓖ' => 'ⓖ', 'Ⓗ' => 'ⓗ', 'Ⓘ' => 'ⓘ', 'Ⓙ' => 'ⓙ', 'Ⓚ' => 'ⓚ', 'Ⓛ' => 'ⓛ', 'Ⓜ' => 'ⓜ', 'Ⓝ' => 'ⓝ', 'Ⓞ' => 'ⓞ', 'Ⓟ' => 'ⓟ', 'Ⓠ' => 'ⓠ', 'Ⓡ' => 'ⓡ', 'Ⓢ' => 'ⓢ', 'Ⓣ' => 'ⓣ', 'Ⓤ' => 'ⓤ', 'Ⓥ' => 'ⓥ', 'Ⓦ' => 'ⓦ', 'Ⓧ' => 'ⓧ', 'Ⓨ' => 'ⓨ', 'Ⓩ' => 'ⓩ', 'Ⰰ' => 'ⰰ', 'Ⰱ' => 'ⰱ', 'Ⰲ' => 'ⰲ', 'Ⰳ' => 'ⰳ', 'Ⰴ' => 'ⰴ', 'Ⰵ' => 'ⰵ', 'Ⰶ' => 'ⰶ', 'Ⰷ' => 'ⰷ', 'Ⰸ' => 'ⰸ', 'Ⰹ' => 'ⰹ', 'Ⰺ' => 'ⰺ', 'Ⰻ' => 'ⰻ', 'Ⰼ' => 'ⰼ', 'Ⰽ' => 'ⰽ', 'Ⰾ' => 'ⰾ', 'Ⰿ' => 'ⰿ', 'Ⱀ' => 'ⱀ', 'Ⱁ' => 'ⱁ', 'Ⱂ' => 'ⱂ', 'Ⱃ' => 'ⱃ', 'Ⱄ' => 'ⱄ', 'Ⱅ' => 'ⱅ', 'Ⱆ' => 'ⱆ', 'Ⱇ' => 'ⱇ', 'Ⱈ' => 'ⱈ', 'Ⱉ' => 'ⱉ', 'Ⱊ' => 'ⱊ', 'Ⱋ' => 'ⱋ', 'Ⱌ' => 'ⱌ', 'Ⱍ' => 'ⱍ', 'Ⱎ' => 'ⱎ', 'Ⱏ' => 'ⱏ', 'Ⱐ' => 'ⱐ', 'Ⱑ' => 'ⱑ', 'Ⱒ' => 'ⱒ', 'Ⱓ' => 'ⱓ', 'Ⱔ' => 'ⱔ', 'Ⱕ' => 'ⱕ', 'Ⱖ' => 'ⱖ', 'Ⱗ' => 'ⱗ', 'Ⱘ' => 'ⱘ', 'Ⱙ' => 'ⱙ', 'Ⱚ' => 'ⱚ', 'Ⱛ' => 'ⱛ', 'Ⱜ' => 'ⱜ', 'Ⱝ' => 'ⱝ', 'Ⱞ' => 'ⱞ', 'Ⱡ' => 'ⱡ', 'Ɫ' => 'ɫ', 'Ᵽ' => 'ᵽ', 'Ɽ' => 'ɽ', 'Ⱨ' => 'ⱨ', 'Ⱪ' => 'ⱪ', 'Ⱬ' => 'ⱬ', 'Ɑ' => 'ɑ', 'Ɱ' => 'ɱ', 'Ɐ' => 'ɐ', 'Ɒ' => 'ɒ', 'Ⱳ' => 'ⱳ', 'Ⱶ' => 'ⱶ', 'Ȿ' => 'ȿ', 'Ɀ' => 'ɀ', 'Ⲁ' => 'ⲁ', 'Ⲃ' => 'ⲃ', 'Ⲅ' => 'ⲅ', 'Ⲇ' => 'ⲇ', 'Ⲉ' => 'ⲉ', 'Ⲋ' => 'ⲋ', 'Ⲍ' => 'ⲍ', 'Ⲏ' => 'ⲏ', 'Ⲑ' => 'ⲑ', 'Ⲓ' => 'ⲓ', 'Ⲕ' => 'ⲕ', 'Ⲗ' => 'ⲗ', 'Ⲙ' => 'ⲙ', 'Ⲛ' => 'ⲛ', 'Ⲝ' => 'ⲝ', 'Ⲟ' => 'ⲟ', 'Ⲡ' => 'ⲡ', 'Ⲣ' => 'ⲣ', 'Ⲥ' => 'ⲥ', 'Ⲧ' => 'ⲧ', 'Ⲩ' => 'ⲩ', 'Ⲫ' => 'ⲫ', 'Ⲭ' => 'ⲭ', 'Ⲯ' => 'ⲯ', 'Ⲱ' => 'ⲱ', 'Ⲳ' => 'ⲳ', 'Ⲵ' => 'ⲵ', 'Ⲷ' => 'ⲷ', 'Ⲹ' => 'ⲹ', 'Ⲻ' => 'ⲻ', 'Ⲽ' => 'ⲽ', 'Ⲿ' => 'ⲿ', 'Ⳁ' => 'ⳁ', 'Ⳃ' => 'ⳃ', 'Ⳅ' => 'ⳅ', 'Ⳇ' => 'ⳇ', 'Ⳉ' => 'ⳉ', 'Ⳋ' => 'ⳋ', 'Ⳍ' => 'ⳍ', 'Ⳏ' => 'ⳏ', 'Ⳑ' => 'ⳑ', 'Ⳓ' => 'ⳓ', 'Ⳕ' => 'ⳕ', 'Ⳗ' => 'ⳗ', 'Ⳙ' => 'ⳙ', 'Ⳛ' => 'ⳛ', 'Ⳝ' => 'ⳝ', 'Ⳟ' => 'ⳟ', 'Ⳡ' => 'ⳡ', 'Ⳣ' => 'ⳣ', 'Ⳬ' => 'ⳬ', 'Ⳮ' => 'ⳮ', 'Ⳳ' => 'ⳳ', 'Ꙁ' => 'ꙁ', 'Ꙃ' => 'ꙃ', 'Ꙅ' => 'ꙅ', 'Ꙇ' => 'ꙇ', 'Ꙉ' => 'ꙉ', 'Ꙋ' => 'ꙋ', 'Ꙍ' => 'ꙍ', 'Ꙏ' => 'ꙏ', 'Ꙑ' => 'ꙑ', 'Ꙓ' => 'ꙓ', 'Ꙕ' => 'ꙕ', 'Ꙗ' => 'ꙗ', 'Ꙙ' => 'ꙙ', 'Ꙛ' => 'ꙛ', 'Ꙝ' => 'ꙝ', 'Ꙟ' => 'ꙟ', 'Ꙡ' => 'ꙡ', 'Ꙣ' => 'ꙣ', 'Ꙥ' => 'ꙥ', 'Ꙧ' => 'ꙧ', 'Ꙩ' => 'ꙩ', 'Ꙫ' => 'ꙫ', 'Ꙭ' => 'ꙭ', 'Ꚁ' => 'ꚁ', 'Ꚃ' => 'ꚃ', 'Ꚅ' => 'ꚅ', 'Ꚇ' => 'ꚇ', 'Ꚉ' => 'ꚉ', 'Ꚋ' => 'ꚋ', 'Ꚍ' => 'ꚍ', 'Ꚏ' => 'ꚏ', 'Ꚑ' => 'ꚑ', 'Ꚓ' => 'ꚓ', 'Ꚕ' => 'ꚕ', 'Ꚗ' => 'ꚗ', 'Ꚙ' => 'ꚙ', 'Ꚛ' => 'ꚛ', 'Ꜣ' => 'ꜣ', 'Ꜥ' => 'ꜥ', 'Ꜧ' => 'ꜧ', 'Ꜩ' => 'ꜩ', 'Ꜫ' => 'ꜫ', 'Ꜭ' => 'ꜭ', 'Ꜯ' => 'ꜯ', 'Ꜳ' => 'ꜳ', 'Ꜵ' => 'ꜵ', 'Ꜷ' => 'ꜷ', 'Ꜹ' => 'ꜹ', 'Ꜻ' => 'ꜻ', 'Ꜽ' => 'ꜽ', 'Ꜿ' => 'ꜿ', 'Ꝁ' => 'ꝁ', 'Ꝃ' => 'ꝃ', 'Ꝅ' => 'ꝅ', 'Ꝇ' => 'ꝇ', 'Ꝉ' => 'ꝉ', 'Ꝋ' => 'ꝋ', 'Ꝍ' => 'ꝍ', 'Ꝏ' => 'ꝏ', 'Ꝑ' => 'ꝑ', 'Ꝓ' => 'ꝓ', 'Ꝕ' => 'ꝕ', 'Ꝗ' => 'ꝗ', 'Ꝙ' => 'ꝙ', 'Ꝛ' => 'ꝛ', 'Ꝝ' => 'ꝝ', 'Ꝟ' => 'ꝟ', 'Ꝡ' => 'ꝡ', 'Ꝣ' => 'ꝣ', 'Ꝥ' => 'ꝥ', 'Ꝧ' => 'ꝧ', 'Ꝩ' => 'ꝩ', 'Ꝫ' => 'ꝫ', 'Ꝭ' => 'ꝭ', 'Ꝯ' => 'ꝯ', 'Ꝺ' => 'ꝺ', 'Ꝼ' => 'ꝼ', 'Ᵹ' => 'ᵹ', 'Ꝿ' => 'ꝿ', 'Ꞁ' => 'ꞁ', 'Ꞃ' => 'ꞃ', 'Ꞅ' => 'ꞅ', 'Ꞇ' => 'ꞇ', 'Ꞌ' => 'ꞌ', 'Ɥ' => 'ɥ', 'Ꞑ' => 'ꞑ', 'Ꞓ' => 'ꞓ', 'Ꞗ' => 'ꞗ', 'Ꞙ' => 'ꞙ', 'Ꞛ' => 'ꞛ', 'Ꞝ' => 'ꞝ', 'Ꞟ' => 'ꞟ', 'Ꞡ' => 'ꞡ', 'Ꞣ' => 'ꞣ', 'Ꞥ' => 'ꞥ', 'Ꞧ' => 'ꞧ', 'Ꞩ' => 'ꞩ', 'Ɦ' => 'ɦ', 'Ɜ' => 'ɜ', 'Ɡ' => 'ɡ', 'Ɬ' => 'ɬ', 'Ɪ' => 'ɪ', 'Ʞ' => 'ʞ', 'Ʇ' => 'ʇ', 'Ʝ' => 'ʝ', 'Ꭓ' => 'ꭓ', 'Ꞵ' => 'ꞵ', 'Ꞷ' => 'ꞷ', 'Ꞹ' => 'ꞹ', 'Ꞻ' => 'ꞻ', 'Ꞽ' => 'ꞽ', 'Ꞿ' => 'ꞿ', 'Ꟃ' => 'ꟃ', 'Ꞔ' => 'ꞔ', 'Ʂ' => 'ʂ', 'Ᶎ' => 'ᶎ', 'Ꟈ' => 'ꟈ', 'Ꟊ' => 'ꟊ', 'Ꟶ' => 'ꟶ', 'Ａ' => 'ａ', 'Ｂ' => 'ｂ', 'Ｃ' => 'ｃ', 'Ｄ' => 'ｄ', 'Ｅ' => 'ｅ', 'Ｆ' => 'ｆ', 'Ｇ' => 'ｇ', 'Ｈ' => 'ｈ', 'Ｉ' => 'ｉ', 'Ｊ' => 'ｊ', 'Ｋ' => 'ｋ', 'Ｌ' => 'ｌ', 'Ｍ' => 'ｍ', 'Ｎ' => 'ｎ', 'Ｏ' => 'ｏ', 'Ｐ' => 'ｐ', 'Ｑ' => 'ｑ', 'Ｒ' => 'ｒ', 'Ｓ' => 'ｓ', 'Ｔ' => 'ｔ', 'Ｕ' => 'ｕ', 'Ｖ' => 'ｖ', 'Ｗ' => 'ｗ', 'Ｘ' => 'ｘ', 'Ｙ' => 'ｙ', 'Ｚ' => 'ｚ', '𐐀' => '𐐨', '𐐁' => '𐐩', '𐐂' => '𐐪', '𐐃' => '𐐫', '𐐄' => '𐐬', '𐐅' => '𐐭', '𐐆' => '𐐮', '𐐇' => '𐐯', '𐐈' => '𐐰', '𐐉' => '𐐱', '𐐊' => '𐐲', '𐐋' => '𐐳', '𐐌' => '𐐴', '𐐍' => '𐐵', '𐐎' => '𐐶', '𐐏' => '𐐷', '𐐐' => '𐐸', '𐐑' => '𐐹', '𐐒' => '𐐺', '𐐓' => '𐐻', '𐐔' => '𐐼', '𐐕' => '𐐽', '𐐖' => '𐐾', '𐐗' => '𐐿', '𐐘' => '𐑀', '𐐙' => '𐑁', '𐐚' => '𐑂', '𐐛' => '𐑃', '𐐜' => '𐑄', '𐐝' => '𐑅', '𐐞' => '𐑆', '𐐟' => '𐑇', '𐐠' => '𐑈', '𐐡' => '𐑉', '𐐢' => '𐑊', '𐐣' => '𐑋', '𐐤' => '𐑌', '𐐥' => '𐑍', '𐐦' => '𐑎', '𐐧' => '𐑏', '𐒰' => '𐓘', '𐒱' => '𐓙', '𐒲' => '𐓚', '𐒳' => '𐓛', '𐒴' => '𐓜', '𐒵' => '𐓝', '𐒶' => '𐓞', '𐒷' => '𐓟', '𐒸' => '𐓠', '𐒹' => '𐓡', '𐒺' => '𐓢', '𐒻' => '𐓣', '𐒼' => '𐓤', '𐒽' => '𐓥', '𐒾' => '𐓦', '𐒿' => '𐓧', '𐓀' => '𐓨', '𐓁' => '𐓩', '𐓂' => '𐓪', '𐓃' => '𐓫', '𐓄' => '𐓬', '𐓅' => '𐓭', '𐓆' => '𐓮', '𐓇' => '𐓯', '𐓈' => '𐓰', '𐓉' => '𐓱', '𐓊' => '𐓲', '𐓋' => '𐓳', '𐓌' => '𐓴', '𐓍' => '𐓵', '𐓎' => '𐓶', '𐓏' => '𐓷', '𐓐' => '𐓸', '𐓑' => '𐓹', '𐓒' => '𐓺', '𐓓' => '𐓻', '𐲀' => '𐳀', '𐲁' => '𐳁', '𐲂' => '𐳂', '𐲃' => '𐳃', '𐲄' => '𐳄', '𐲅' => '𐳅', '𐲆' => '𐳆', '𐲇' => '𐳇', '𐲈' => '𐳈', '𐲉' => '𐳉', '𐲊' => '𐳊', '𐲋' => '𐳋', '𐲌' => '𐳌', '𐲍' => '𐳍', '𐲎' => '𐳎', '𐲏' => '𐳏', '𐲐' => '𐳐', '𐲑' => '𐳑', '𐲒' => '𐳒', '𐲓' => '𐳓', '𐲔' => '𐳔', '𐲕' => '𐳕', '𐲖' => '𐳖', '𐲗' => '𐳗', '𐲘' => '𐳘', '𐲙' => '𐳙', '𐲚' => '𐳚', '𐲛' => '𐳛', '𐲜' => '𐳜', '𐲝' => '𐳝', '𐲞' => '𐳞', '𐲟' => '𐳟', '𐲠' => '𐳠', '𐲡' => '𐳡', '𐲢' => '𐳢', '𐲣' => '𐳣', '𐲤' => '𐳤', '𐲥' => '𐳥', '𐲦' => '𐳦', '𐲧' => '𐳧', '𐲨' => '𐳨', '𐲩' => '𐳩', '𐲪' => '𐳪', '𐲫' => '𐳫', '𐲬' => '𐳬', '𐲭' => '𐳭', '𐲮' => '𐳮', '𐲯' => '𐳯', '𐲰' => '𐳰', '𐲱' => '𐳱', '𐲲' => '𐳲', '𑢠' => '𑣀', '𑢡' => '𑣁', '𑢢' => '𑣂', '𑢣' => '𑣃', '𑢤' => '𑣄', '𑢥' => '𑣅', '𑢦' => '𑣆', '𑢧' => '𑣇', '𑢨' => '𑣈', '𑢩' => '𑣉', '𑢪' => '𑣊', '𑢫' => '𑣋', '𑢬' => '𑣌', '𑢭' => '𑣍', '𑢮' => '𑣎', '𑢯' => '𑣏', '𑢰' => '𑣐', '𑢱' => '𑣑', '𑢲' => '𑣒', '𑢳' => '𑣓', '𑢴' => '𑣔', '𑢵' => '𑣕', '𑢶' => '𑣖', '𑢷' => '𑣗', '𑢸' => '𑣘', '𑢹' => '𑣙', '𑢺' => '𑣚', '𑢻' => '𑣛', '𑢼' => '𑣜', '𑢽' => '𑣝', '𑢾' => '𑣞', '𑢿' => '𑣟', '𖹀' => '𖹠', '𖹁' => '𖹡', '𖹂' => '𖹢', '𖹃' => '𖹣', '𖹄' => '𖹤', '𖹅' => '𖹥', '𖹆' => '𖹦', '𖹇' => '𖹧', '𖹈' => '𖹨', '𖹉' => '𖹩', '𖹊' => '𖹪', '𖹋' => '𖹫', '𖹌' => '𖹬', '𖹍' => '𖹭', '𖹎' => '𖹮', '𖹏' => '𖹯', '𖹐' => '𖹰', '𖹑' => '𖹱', '𖹒' => '𖹲', '𖹓' => '𖹳', '𖹔' => '𖹴', '𖹕' => '𖹵', '𖹖' => '𖹶', '𖹗' => '𖹷', '𖹘' => '𖹸', '𖹙' => '𖹹', '𖹚' => '𖹺', '𖹛' => '𖹻', '𖹜' => '𖹼', '𖹝' => '𖹽', '𖹞' => '𖹾', '𖹟' => '𖹿', '𞤀' => '𞤢', '𞤁' => '𞤣', '𞤂' => '𞤤', '𞤃' => '𞤥', '𞤄' => '𞤦', '𞤅' => '𞤧', '𞤆' => '𞤨', '𞤇' => '𞤩', '𞤈' => '𞤪', '𞤉' => '𞤫', '𞤊' => '𞤬', '𞤋' => '𞤭', '𞤌' => '𞤮', '𞤍' => '𞤯', '𞤎' => '𞤰', '𞤏' => '𞤱', '𞤐' => '𞤲', '𞤑' => '𞤳', '𞤒' => '𞤴', '𞤓' => '𞤵', '𞤔' => '𞤶', '𞤕' => '𞤷', '𞤖' => '𞤸', '𞤗' => '𞤹', '𞤘' => '𞤺', '𞤙' => '𞤻', '𞤚' => '𞤼', '𞤛' => '𞤽', '𞤜' => '𞤾', '𞤝' => '𞤿', '𞤞' => '𞥀', '𞤟' => '𞥁', '𞤠' => '𞥂', '𞤡' => '𞥃', ); 'A', 'b' => 'B', 'c' => 'C', 'd' => 'D', 'e' => 'E', 'f' => 'F', 'g' => 'G', 'h' => 'H', 'i' => 'I', 'j' => 'J', 'k' => 'K', 'l' => 'L', 'm' => 'M', 'n' => 'N', 'o' => 'O', 'p' => 'P', 'q' => 'Q', 'r' => 'R', 's' => 'S', 't' => 'T', 'u' => 'U', 'v' => 'V', 'w' => 'W', 'x' => 'X', 'y' => 'Y', 'z' => 'Z', 'µ' => 'Μ', 'à' => 'À', 'á' => 'Á', 'â' => 'Â', 'ã' => 'Ã', 'ä' => 'Ä', 'å' => 'Å', 'æ' => 'Æ', 'ç' => 'Ç', 'è' => 'È', 'é' => 'É', 'ê' => 'Ê', 'ë' => 'Ë', 'ì' => 'Ì', 'í' => 'Í', 'î' => 'Î', 'ï' => 'Ï', 'ð' => 'Ð', 'ñ' => 'Ñ', 'ò' => 'Ò', 'ó' => 'Ó', 'ô' => 'Ô', 'õ' => 'Õ', 'ö' => 'Ö', 'ø' => 'Ø', 'ù' => 'Ù', 'ú' => 'Ú', 'û' => 'Û', 'ü' => 'Ü', 'ý' => 'Ý', 'þ' => 'Þ', 'ÿ' => 'Ÿ', 'ā' => 'Ā', 'ă' => 'Ă', 'ą' => 'Ą', 'ć' => 'Ć', 'ĉ' => 'Ĉ', 'ċ' => 'Ċ', 'č' => 'Č', 'ď' => 'Ď', 'đ' => 'Đ', 'ē' => 'Ē', 'ĕ' => 'Ĕ', 'ė' => 'Ė', 'ę' => 'Ę', 'ě' => 'Ě', 'ĝ' => 'Ĝ', 'ğ' => 'Ğ', 'ġ' => 'Ġ', 'ģ' => 'Ģ', 'ĥ' => 'Ĥ', 'ħ' => 'Ħ', 'ĩ' => 'Ĩ', 'ī' => 'Ī', 'ĭ' => 'Ĭ', 'į' => 'Į', 'ı' => 'I', 'ij' => 'IJ', 'ĵ' => 'Ĵ', 'ķ' => 'Ķ', 'ĺ' => 'Ĺ', 'ļ' => 'Ļ', 'ľ' => 'Ľ', 'ŀ' => 'Ŀ', 'ł' => 'Ł', 'ń' => 'Ń', 'ņ' => 'Ņ', 'ň' => 'Ň', 'ŋ' => 'Ŋ', 'ō' => 'Ō', 'ŏ' => 'Ŏ', 'ő' => 'Ő', 'œ' => 'Œ', 'ŕ' => 'Ŕ', 'ŗ' => 'Ŗ', 'ř' => 'Ř', 'ś' => 'Ś', 'ŝ' => 'Ŝ', 'ş' => 'Ş', 'š' => 'Š', 'ţ' => 'Ţ', 'ť' => 'Ť', 'ŧ' => 'Ŧ', 'ũ' => 'Ũ', 'ū' => 'Ū', 'ŭ' => 'Ŭ', 'ů' => 'Ů', 'ű' => 'Ű', 'ų' => 'Ų', 'ŵ' => 'Ŵ', 'ŷ' => 'Ŷ', 'ź' => 'Ź', 'ż' => 'Ż', 'ž' => 'Ž', 'ſ' => 'S', 'ƀ' => 'Ƀ', 'ƃ' => 'Ƃ', 'ƅ' => 'Ƅ', 'ƈ' => 'Ƈ', 'ƌ' => 'Ƌ', 'ƒ' => 'Ƒ', 'ƕ' => 'Ƕ', 'ƙ' => 'Ƙ', 'ƚ' => 'Ƚ', 'ƞ' => 'Ƞ', 'ơ' => 'Ơ', 'ƣ' => 'Ƣ', 'ƥ' => 'Ƥ', 'ƨ' => 'Ƨ', 'ƭ' => 'Ƭ', 'ư' => 'Ư', 'ƴ' => 'Ƴ', 'ƶ' => 'Ƶ', 'ƹ' => 'Ƹ', 'ƽ' => 'Ƽ', 'ƿ' => 'Ƿ', 'Dž' => 'DŽ', 'dž' => 'DŽ', 'Lj' => 'LJ', 'lj' => 'LJ', 'Nj' => 'NJ', 'nj' => 'NJ', 'ǎ' => 'Ǎ', 'ǐ' => 'Ǐ', 'ǒ' => 'Ǒ', 'ǔ' => 'Ǔ', 'ǖ' => 'Ǖ', 'ǘ' => 'Ǘ', 'ǚ' => 'Ǚ', 'ǜ' => 'Ǜ', 'ǝ' => 'Ǝ', 'ǟ' => 'Ǟ', 'ǡ' => 'Ǡ', 'ǣ' => 'Ǣ', 'ǥ' => 'Ǥ', 'ǧ' => 'Ǧ', 'ǩ' => 'Ǩ', 'ǫ' => 'Ǫ', 'ǭ' => 'Ǭ', 'ǯ' => 'Ǯ', 'Dz' => 'DZ', 'dz' => 'DZ', 'ǵ' => 'Ǵ', 'ǹ' => 'Ǹ', 'ǻ' => 'Ǻ', 'ǽ' => 'Ǽ', 'ǿ' => 'Ǿ', 'ȁ' => 'Ȁ', 'ȃ' => 'Ȃ', 'ȅ' => 'Ȅ', 'ȇ' => 'Ȇ', 'ȉ' => 'Ȉ', 'ȋ' => 'Ȋ', 'ȍ' => 'Ȍ', 'ȏ' => 'Ȏ', 'ȑ' => 'Ȑ', 'ȓ' => 'Ȓ', 'ȕ' => 'Ȕ', 'ȗ' => 'Ȗ', 'ș' => 'Ș', 'ț' => 'Ț', 'ȝ' => 'Ȝ', 'ȟ' => 'Ȟ', 'ȣ' => 'Ȣ', 'ȥ' => 'Ȥ', 'ȧ' => 'Ȧ', 'ȩ' => 'Ȩ', 'ȫ' => 'Ȫ', 'ȭ' => 'Ȭ', 'ȯ' => 'Ȯ', 'ȱ' => 'Ȱ', 'ȳ' => 'Ȳ', 'ȼ' => 'Ȼ', 'ȿ' => 'Ȿ', 'ɀ' => 'Ɀ', 'ɂ' => 'Ɂ', 'ɇ' => 'Ɇ', 'ɉ' => 'Ɉ', 'ɋ' => 'Ɋ', 'ɍ' => 'Ɍ', 'ɏ' => 'Ɏ', 'ɐ' => 'Ɐ', 'ɑ' => 'Ɑ', 'ɒ' => 'Ɒ', 'ɓ' => 'Ɓ', 'ɔ' => 'Ɔ', 'ɖ' => 'Ɖ', 'ɗ' => 'Ɗ', 'ə' => 'Ə', 'ɛ' => 'Ɛ', 'ɜ' => 'Ɜ', 'ɠ' => 'Ɠ', 'ɡ' => 'Ɡ', 'ɣ' => 'Ɣ', 'ɥ' => 'Ɥ', 'ɦ' => 'Ɦ', 'ɨ' => 'Ɨ', 'ɩ' => 'Ɩ', 'ɪ' => 'Ɪ', 'ɫ' => 'Ɫ', 'ɬ' => 'Ɬ', 'ɯ' => 'Ɯ', 'ɱ' => 'Ɱ', 'ɲ' => 'Ɲ', 'ɵ' => 'Ɵ', 'ɽ' => 'Ɽ', 'ʀ' => 'Ʀ', 'ʂ' => 'Ʂ', 'ʃ' => 'Ʃ', 'ʇ' => 'Ʇ', 'ʈ' => 'Ʈ', 'ʉ' => 'Ʉ', 'ʊ' => 'Ʊ', 'ʋ' => 'Ʋ', 'ʌ' => 'Ʌ', 'ʒ' => 'Ʒ', 'ʝ' => 'Ʝ', 'ʞ' => 'Ʞ', 'ͅ' => 'Ι', 'ͱ' => 'Ͱ', 'ͳ' => 'Ͳ', 'ͷ' => 'Ͷ', 'ͻ' => 'Ͻ', 'ͼ' => 'Ͼ', 'ͽ' => 'Ͽ', 'ά' => 'Ά', 'έ' => 'Έ', 'ή' => 'Ή', 'ί' => 'Ί', 'α' => 'Α', 'β' => 'Β', 'γ' => 'Γ', 'δ' => 'Δ', 'ε' => 'Ε', 'ζ' => 'Ζ', 'η' => 'Η', 'θ' => 'Θ', 'ι' => 'Ι', 'κ' => 'Κ', 'λ' => 'Λ', 'μ' => 'Μ', 'ν' => 'Ν', 'ξ' => 'Ξ', 'ο' => 'Ο', 'π' => 'Π', 'ρ' => 'Ρ', 'ς' => 'Σ', 'σ' => 'Σ', 'τ' => 'Τ', 'υ' => 'Υ', 'φ' => 'Φ', 'χ' => 'Χ', 'ψ' => 'Ψ', 'ω' => 'Ω', 'ϊ' => 'Ϊ', 'ϋ' => 'Ϋ', 'ό' => 'Ό', 'ύ' => 'Ύ', 'ώ' => 'Ώ', 'ϐ' => 'Β', 'ϑ' => 'Θ', 'ϕ' => 'Φ', 'ϖ' => 'Π', 'ϗ' => 'Ϗ', 'ϙ' => 'Ϙ', 'ϛ' => 'Ϛ', 'ϝ' => 'Ϝ', 'ϟ' => 'Ϟ', 'ϡ' => 'Ϡ', 'ϣ' => 'Ϣ', 'ϥ' => 'Ϥ', 'ϧ' => 'Ϧ', 'ϩ' => 'Ϩ', 'ϫ' => 'Ϫ', 'ϭ' => 'Ϭ', 'ϯ' => 'Ϯ', 'ϰ' => 'Κ', 'ϱ' => 'Ρ', 'ϲ' => 'Ϲ', 'ϳ' => 'Ϳ', 'ϵ' => 'Ε', 'ϸ' => 'Ϸ', 'ϻ' => 'Ϻ', 'а' => 'А', 'б' => 'Б', 'в' => 'В', 'г' => 'Г', 'д' => 'Д', 'е' => 'Е', 'ж' => 'Ж', 'з' => 'З', 'и' => 'И', 'й' => 'Й', 'к' => 'К', 'л' => 'Л', 'м' => 'М', 'н' => 'Н', 'о' => 'О', 'п' => 'П', 'р' => 'Р', 'с' => 'С', 'т' => 'Т', 'у' => 'У', 'ф' => 'Ф', 'х' => 'Х', 'ц' => 'Ц', 'ч' => 'Ч', 'ш' => 'Ш', 'щ' => 'Щ', 'ъ' => 'Ъ', 'ы' => 'Ы', 'ь' => 'Ь', 'э' => 'Э', 'ю' => 'Ю', 'я' => 'Я', 'ѐ' => 'Ѐ', 'ё' => 'Ё', 'ђ' => 'Ђ', 'ѓ' => 'Ѓ', 'є' => 'Є', 'ѕ' => 'Ѕ', 'і' => 'І', 'ї' => 'Ї', 'ј' => 'Ј', 'љ' => 'Љ', 'њ' => 'Њ', 'ћ' => 'Ћ', 'ќ' => 'Ќ', 'ѝ' => 'Ѝ', 'ў' => 'Ў', 'џ' => 'Џ', 'ѡ' => 'Ѡ', 'ѣ' => 'Ѣ', 'ѥ' => 'Ѥ', 'ѧ' => 'Ѧ', 'ѩ' => 'Ѩ', 'ѫ' => 'Ѫ', 'ѭ' => 'Ѭ', 'ѯ' => 'Ѯ', 'ѱ' => 'Ѱ', 'ѳ' => 'Ѳ', 'ѵ' => 'Ѵ', 'ѷ' => 'Ѷ', 'ѹ' => 'Ѹ', 'ѻ' => 'Ѻ', 'ѽ' => 'Ѽ', 'ѿ' => 'Ѿ', 'ҁ' => 'Ҁ', 'ҋ' => 'Ҋ', 'ҍ' => 'Ҍ', 'ҏ' => 'Ҏ', 'ґ' => 'Ґ', 'ғ' => 'Ғ', 'ҕ' => 'Ҕ', 'җ' => 'Җ', 'ҙ' => 'Ҙ', 'қ' => 'Қ', 'ҝ' => 'Ҝ', 'ҟ' => 'Ҟ', 'ҡ' => 'Ҡ', 'ң' => 'Ң', 'ҥ' => 'Ҥ', 'ҧ' => 'Ҧ', 'ҩ' => 'Ҩ', 'ҫ' => 'Ҫ', 'ҭ' => 'Ҭ', 'ү' => 'Ү', 'ұ' => 'Ұ', 'ҳ' => 'Ҳ', 'ҵ' => 'Ҵ', 'ҷ' => 'Ҷ', 'ҹ' => 'Ҹ', 'һ' => 'Һ', 'ҽ' => 'Ҽ', 'ҿ' => 'Ҿ', 'ӂ' => 'Ӂ', 'ӄ' => 'Ӄ', 'ӆ' => 'Ӆ', 'ӈ' => 'Ӈ', 'ӊ' => 'Ӊ', 'ӌ' => 'Ӌ', 'ӎ' => 'Ӎ', 'ӏ' => 'Ӏ', 'ӑ' => 'Ӑ', 'ӓ' => 'Ӓ', 'ӕ' => 'Ӕ', 'ӗ' => 'Ӗ', 'ә' => 'Ә', 'ӛ' => 'Ӛ', 'ӝ' => 'Ӝ', 'ӟ' => 'Ӟ', 'ӡ' => 'Ӡ', 'ӣ' => 'Ӣ', 'ӥ' => 'Ӥ', 'ӧ' => 'Ӧ', 'ө' => 'Ө', 'ӫ' => 'Ӫ', 'ӭ' => 'Ӭ', 'ӯ' => 'Ӯ', 'ӱ' => 'Ӱ', 'ӳ' => 'Ӳ', 'ӵ' => 'Ӵ', 'ӷ' => 'Ӷ', 'ӹ' => 'Ӹ', 'ӻ' => 'Ӻ', 'ӽ' => 'Ӽ', 'ӿ' => 'Ӿ', 'ԁ' => 'Ԁ', 'ԃ' => 'Ԃ', 'ԅ' => 'Ԅ', 'ԇ' => 'Ԇ', 'ԉ' => 'Ԉ', 'ԋ' => 'Ԋ', 'ԍ' => 'Ԍ', 'ԏ' => 'Ԏ', 'ԑ' => 'Ԑ', 'ԓ' => 'Ԓ', 'ԕ' => 'Ԕ', 'ԗ' => 'Ԗ', 'ԙ' => 'Ԙ', 'ԛ' => 'Ԛ', 'ԝ' => 'Ԝ', 'ԟ' => 'Ԟ', 'ԡ' => 'Ԡ', 'ԣ' => 'Ԣ', 'ԥ' => 'Ԥ', 'ԧ' => 'Ԧ', 'ԩ' => 'Ԩ', 'ԫ' => 'Ԫ', 'ԭ' => 'Ԭ', 'ԯ' => 'Ԯ', 'ա' => 'Ա', 'բ' => 'Բ', 'գ' => 'Գ', 'դ' => 'Դ', 'ե' => 'Ե', 'զ' => 'Զ', 'է' => 'Է', 'ը' => 'Ը', 'թ' => 'Թ', 'ժ' => 'Ժ', 'ի' => 'Ի', 'լ' => 'Լ', 'խ' => 'Խ', 'ծ' => 'Ծ', 'կ' => 'Կ', 'հ' => 'Հ', 'ձ' => 'Ձ', 'ղ' => 'Ղ', 'ճ' => 'Ճ', 'մ' => 'Մ', 'յ' => 'Յ', 'ն' => 'Ն', 'շ' => 'Շ', 'ո' => 'Ո', 'չ' => 'Չ', 'պ' => 'Պ', 'ջ' => 'Ջ', 'ռ' => 'Ռ', 'ս' => 'Ս', 'վ' => 'Վ', 'տ' => 'Տ', 'ր' => 'Ր', 'ց' => 'Ց', 'ւ' => 'Ւ', 'փ' => 'Փ', 'ք' => 'Ք', 'օ' => 'Օ', 'ֆ' => 'Ֆ', 'ა' => 'Ა', 'ბ' => 'Ბ', 'გ' => 'Გ', 'დ' => 'Დ', 'ე' => 'Ე', 'ვ' => 'Ვ', 'ზ' => 'Ზ', 'თ' => 'Თ', 'ი' => 'Ი', 'კ' => 'Კ', 'ლ' => 'Ლ', 'მ' => 'Მ', 'ნ' => 'Ნ', 'ო' => 'Ო', 'პ' => 'Პ', 'ჟ' => 'Ჟ', 'რ' => 'Რ', 'ს' => 'Ს', 'ტ' => 'Ტ', 'უ' => 'Უ', 'ფ' => 'Ფ', 'ქ' => 'Ქ', 'ღ' => 'Ღ', 'ყ' => 'Ყ', 'შ' => 'Შ', 'ჩ' => 'Ჩ', 'ც' => 'Ც', 'ძ' => 'Ძ', 'წ' => 'Წ', 'ჭ' => 'Ჭ', 'ხ' => 'Ხ', 'ჯ' => 'Ჯ', 'ჰ' => 'Ჰ', 'ჱ' => 'Ჱ', 'ჲ' => 'Ჲ', 'ჳ' => 'Ჳ', 'ჴ' => 'Ჴ', 'ჵ' => 'Ჵ', 'ჶ' => 'Ჶ', 'ჷ' => 'Ჷ', 'ჸ' => 'Ჸ', 'ჹ' => 'Ჹ', 'ჺ' => 'Ჺ', 'ჽ' => 'Ჽ', 'ჾ' => 'Ჾ', 'ჿ' => 'Ჿ', 'ᏸ' => 'Ᏸ', 'ᏹ' => 'Ᏹ', 'ᏺ' => 'Ᏺ', 'ᏻ' => 'Ᏻ', 'ᏼ' => 'Ᏼ', 'ᏽ' => 'Ᏽ', 'ᲀ' => 'В', 'ᲁ' => 'Д', 'ᲂ' => 'О', 'ᲃ' => 'С', 'ᲄ' => 'Т', 'ᲅ' => 'Т', 'ᲆ' => 'Ъ', 'ᲇ' => 'Ѣ', 'ᲈ' => 'Ꙋ', 'ᵹ' => 'Ᵹ', 'ᵽ' => 'Ᵽ', 'ᶎ' => 'Ᶎ', 'ḁ' => 'Ḁ', 'ḃ' => 'Ḃ', 'ḅ' => 'Ḅ', 'ḇ' => 'Ḇ', 'ḉ' => 'Ḉ', 'ḋ' => 'Ḋ', 'ḍ' => 'Ḍ', 'ḏ' => 'Ḏ', 'ḑ' => 'Ḑ', 'ḓ' => 'Ḓ', 'ḕ' => 'Ḕ', 'ḗ' => 'Ḗ', 'ḙ' => 'Ḙ', 'ḛ' => 'Ḛ', 'ḝ' => 'Ḝ', 'ḟ' => 'Ḟ', 'ḡ' => 'Ḡ', 'ḣ' => 'Ḣ', 'ḥ' => 'Ḥ', 'ḧ' => 'Ḧ', 'ḩ' => 'Ḩ', 'ḫ' => 'Ḫ', 'ḭ' => 'Ḭ', 'ḯ' => 'Ḯ', 'ḱ' => 'Ḱ', 'ḳ' => 'Ḳ', 'ḵ' => 'Ḵ', 'ḷ' => 'Ḷ', 'ḹ' => 'Ḹ', 'ḻ' => 'Ḻ', 'ḽ' => 'Ḽ', 'ḿ' => 'Ḿ', 'ṁ' => 'Ṁ', 'ṃ' => 'Ṃ', 'ṅ' => 'Ṅ', 'ṇ' => 'Ṇ', 'ṉ' => 'Ṉ', 'ṋ' => 'Ṋ', 'ṍ' => 'Ṍ', 'ṏ' => 'Ṏ', 'ṑ' => 'Ṑ', 'ṓ' => 'Ṓ', 'ṕ' => 'Ṕ', 'ṗ' => 'Ṗ', 'ṙ' => 'Ṙ', 'ṛ' => 'Ṛ', 'ṝ' => 'Ṝ', 'ṟ' => 'Ṟ', 'ṡ' => 'Ṡ', 'ṣ' => 'Ṣ', 'ṥ' => 'Ṥ', 'ṧ' => 'Ṧ', 'ṩ' => 'Ṩ', 'ṫ' => 'Ṫ', 'ṭ' => 'Ṭ', 'ṯ' => 'Ṯ', 'ṱ' => 'Ṱ', 'ṳ' => 'Ṳ', 'ṵ' => 'Ṵ', 'ṷ' => 'Ṷ', 'ṹ' => 'Ṹ', 'ṻ' => 'Ṻ', 'ṽ' => 'Ṽ', 'ṿ' => 'Ṿ', 'ẁ' => 'Ẁ', 'ẃ' => 'Ẃ', 'ẅ' => 'Ẅ', 'ẇ' => 'Ẇ', 'ẉ' => 'Ẉ', 'ẋ' => 'Ẋ', 'ẍ' => 'Ẍ', 'ẏ' => 'Ẏ', 'ẑ' => 'Ẑ', 'ẓ' => 'Ẓ', 'ẕ' => 'Ẕ', 'ẛ' => 'Ṡ', 'ạ' => 'Ạ', 'ả' => 'Ả', 'ấ' => 'Ấ', 'ầ' => 'Ầ', 'ẩ' => 'Ẩ', 'ẫ' => 'Ẫ', 'ậ' => 'Ậ', 'ắ' => 'Ắ', 'ằ' => 'Ằ', 'ẳ' => 'Ẳ', 'ẵ' => 'Ẵ', 'ặ' => 'Ặ', 'ẹ' => 'Ẹ', 'ẻ' => 'Ẻ', 'ẽ' => 'Ẽ', 'ế' => 'Ế', 'ề' => 'Ề', 'ể' => 'Ể', 'ễ' => 'Ễ', 'ệ' => 'Ệ', 'ỉ' => 'Ỉ', 'ị' => 'Ị', 'ọ' => 'Ọ', 'ỏ' => 'Ỏ', 'ố' => 'Ố', 'ồ' => 'Ồ', 'ổ' => 'Ổ', 'ỗ' => 'Ỗ', 'ộ' => 'Ộ', 'ớ' => 'Ớ', 'ờ' => 'Ờ', 'ở' => 'Ở', 'ỡ' => 'Ỡ', 'ợ' => 'Ợ', 'ụ' => 'Ụ', 'ủ' => 'Ủ', 'ứ' => 'Ứ', 'ừ' => 'Ừ', 'ử' => 'Ử', 'ữ' => 'Ữ', 'ự' => 'Ự', 'ỳ' => 'Ỳ', 'ỵ' => 'Ỵ', 'ỷ' => 'Ỷ', 'ỹ' => 'Ỹ', 'ỻ' => 'Ỻ', 'ỽ' => 'Ỽ', 'ỿ' => 'Ỿ', 'ἀ' => 'Ἀ', 'ἁ' => 'Ἁ', 'ἂ' => 'Ἂ', 'ἃ' => 'Ἃ', 'ἄ' => 'Ἄ', 'ἅ' => 'Ἅ', 'ἆ' => 'Ἆ', 'ἇ' => 'Ἇ', 'ἐ' => 'Ἐ', 'ἑ' => 'Ἑ', 'ἒ' => 'Ἒ', 'ἓ' => 'Ἓ', 'ἔ' => 'Ἔ', 'ἕ' => 'Ἕ', 'ἠ' => 'Ἠ', 'ἡ' => 'Ἡ', 'ἢ' => 'Ἢ', 'ἣ' => 'Ἣ', 'ἤ' => 'Ἤ', 'ἥ' => 'Ἥ', 'ἦ' => 'Ἦ', 'ἧ' => 'Ἧ', 'ἰ' => 'Ἰ', 'ἱ' => 'Ἱ', 'ἲ' => 'Ἲ', 'ἳ' => 'Ἳ', 'ἴ' => 'Ἴ', 'ἵ' => 'Ἵ', 'ἶ' => 'Ἶ', 'ἷ' => 'Ἷ', 'ὀ' => 'Ὀ', 'ὁ' => 'Ὁ', 'ὂ' => 'Ὂ', 'ὃ' => 'Ὃ', 'ὄ' => 'Ὄ', 'ὅ' => 'Ὅ', 'ὑ' => 'Ὑ', 'ὓ' => 'Ὓ', 'ὕ' => 'Ὕ', 'ὗ' => 'Ὗ', 'ὠ' => 'Ὠ', 'ὡ' => 'Ὡ', 'ὢ' => 'Ὢ', 'ὣ' => 'Ὣ', 'ὤ' => 'Ὤ', 'ὥ' => 'Ὥ', 'ὦ' => 'Ὦ', 'ὧ' => 'Ὧ', 'ὰ' => 'Ὰ', 'ά' => 'Ά', 'ὲ' => 'Ὲ', 'έ' => 'Έ', 'ὴ' => 'Ὴ', 'ή' => 'Ή', 'ὶ' => 'Ὶ', 'ί' => 'Ί', 'ὸ' => 'Ὸ', 'ό' => 'Ό', 'ὺ' => 'Ὺ', 'ύ' => 'Ύ', 'ὼ' => 'Ὼ', 'ώ' => 'Ώ', 'ᾀ' => 'ἈΙ', 'ᾁ' => 'ἉΙ', 'ᾂ' => 'ἊΙ', 'ᾃ' => 'ἋΙ', 'ᾄ' => 'ἌΙ', 'ᾅ' => 'ἍΙ', 'ᾆ' => 'ἎΙ', 'ᾇ' => 'ἏΙ', 'ᾐ' => 'ἨΙ', 'ᾑ' => 'ἩΙ', 'ᾒ' => 'ἪΙ', 'ᾓ' => 'ἫΙ', 'ᾔ' => 'ἬΙ', 'ᾕ' => 'ἭΙ', 'ᾖ' => 'ἮΙ', 'ᾗ' => 'ἯΙ', 'ᾠ' => 'ὨΙ', 'ᾡ' => 'ὩΙ', 'ᾢ' => 'ὪΙ', 'ᾣ' => 'ὫΙ', 'ᾤ' => 'ὬΙ', 'ᾥ' => 'ὭΙ', 'ᾦ' => 'ὮΙ', 'ᾧ' => 'ὯΙ', 'ᾰ' => 'Ᾰ', 'ᾱ' => 'Ᾱ', 'ᾳ' => 'ΑΙ', 'ι' => 'Ι', 'ῃ' => 'ΗΙ', 'ῐ' => 'Ῐ', 'ῑ' => 'Ῑ', 'ῠ' => 'Ῠ', 'ῡ' => 'Ῡ', 'ῥ' => 'Ῥ', 'ῳ' => 'ΩΙ', 'ⅎ' => 'Ⅎ', 'ⅰ' => 'Ⅰ', 'ⅱ' => 'Ⅱ', 'ⅲ' => 'Ⅲ', 'ⅳ' => 'Ⅳ', 'ⅴ' => 'Ⅴ', 'ⅵ' => 'Ⅵ', 'ⅶ' => 'Ⅶ', 'ⅷ' => 'Ⅷ', 'ⅸ' => 'Ⅸ', 'ⅹ' => 'Ⅹ', 'ⅺ' => 'Ⅺ', 'ⅻ' => 'Ⅻ', 'ⅼ' => 'Ⅼ', 'ⅽ' => 'Ⅽ', 'ⅾ' => 'Ⅾ', 'ⅿ' => 'Ⅿ', 'ↄ' => 'Ↄ', 'ⓐ' => 'Ⓐ', 'ⓑ' => 'Ⓑ', 'ⓒ' => 'Ⓒ', 'ⓓ' => 'Ⓓ', 'ⓔ' => 'Ⓔ', 'ⓕ' => 'Ⓕ', 'ⓖ' => 'Ⓖ', 'ⓗ' => 'Ⓗ', 'ⓘ' => 'Ⓘ', 'ⓙ' => 'Ⓙ', 'ⓚ' => 'Ⓚ', 'ⓛ' => 'Ⓛ', 'ⓜ' => 'Ⓜ', 'ⓝ' => 'Ⓝ', 'ⓞ' => 'Ⓞ', 'ⓟ' => 'Ⓟ', 'ⓠ' => 'Ⓠ', 'ⓡ' => 'Ⓡ', 'ⓢ' => 'Ⓢ', 'ⓣ' => 'Ⓣ', 'ⓤ' => 'Ⓤ', 'ⓥ' => 'Ⓥ', 'ⓦ' => 'Ⓦ', 'ⓧ' => 'Ⓧ', 'ⓨ' => 'Ⓨ', 'ⓩ' => 'Ⓩ', 'ⰰ' => 'Ⰰ', 'ⰱ' => 'Ⰱ', 'ⰲ' => 'Ⰲ', 'ⰳ' => 'Ⰳ', 'ⰴ' => 'Ⰴ', 'ⰵ' => 'Ⰵ', 'ⰶ' => 'Ⰶ', 'ⰷ' => 'Ⰷ', 'ⰸ' => 'Ⰸ', 'ⰹ' => 'Ⰹ', 'ⰺ' => 'Ⰺ', 'ⰻ' => 'Ⰻ', 'ⰼ' => 'Ⰼ', 'ⰽ' => 'Ⰽ', 'ⰾ' => 'Ⰾ', 'ⰿ' => 'Ⰿ', 'ⱀ' => 'Ⱀ', 'ⱁ' => 'Ⱁ', 'ⱂ' => 'Ⱂ', 'ⱃ' => 'Ⱃ', 'ⱄ' => 'Ⱄ', 'ⱅ' => 'Ⱅ', 'ⱆ' => 'Ⱆ', 'ⱇ' => 'Ⱇ', 'ⱈ' => 'Ⱈ', 'ⱉ' => 'Ⱉ', 'ⱊ' => 'Ⱊ', 'ⱋ' => 'Ⱋ', 'ⱌ' => 'Ⱌ', 'ⱍ' => 'Ⱍ', 'ⱎ' => 'Ⱎ', 'ⱏ' => 'Ⱏ', 'ⱐ' => 'Ⱐ', 'ⱑ' => 'Ⱑ', 'ⱒ' => 'Ⱒ', 'ⱓ' => 'Ⱓ', 'ⱔ' => 'Ⱔ', 'ⱕ' => 'Ⱕ', 'ⱖ' => 'Ⱖ', 'ⱗ' => 'Ⱗ', 'ⱘ' => 'Ⱘ', 'ⱙ' => 'Ⱙ', 'ⱚ' => 'Ⱚ', 'ⱛ' => 'Ⱛ', 'ⱜ' => 'Ⱜ', 'ⱝ' => 'Ⱝ', 'ⱞ' => 'Ⱞ', 'ⱡ' => 'Ⱡ', 'ⱥ' => 'Ⱥ', 'ⱦ' => 'Ⱦ', 'ⱨ' => 'Ⱨ', 'ⱪ' => 'Ⱪ', 'ⱬ' => 'Ⱬ', 'ⱳ' => 'Ⱳ', 'ⱶ' => 'Ⱶ', 'ⲁ' => 'Ⲁ', 'ⲃ' => 'Ⲃ', 'ⲅ' => 'Ⲅ', 'ⲇ' => 'Ⲇ', 'ⲉ' => 'Ⲉ', 'ⲋ' => 'Ⲋ', 'ⲍ' => 'Ⲍ', 'ⲏ' => 'Ⲏ', 'ⲑ' => 'Ⲑ', 'ⲓ' => 'Ⲓ', 'ⲕ' => 'Ⲕ', 'ⲗ' => 'Ⲗ', 'ⲙ' => 'Ⲙ', 'ⲛ' => 'Ⲛ', 'ⲝ' => 'Ⲝ', 'ⲟ' => 'Ⲟ', 'ⲡ' => 'Ⲡ', 'ⲣ' => 'Ⲣ', 'ⲥ' => 'Ⲥ', 'ⲧ' => 'Ⲧ', 'ⲩ' => 'Ⲩ', 'ⲫ' => 'Ⲫ', 'ⲭ' => 'Ⲭ', 'ⲯ' => 'Ⲯ', 'ⲱ' => 'Ⲱ', 'ⲳ' => 'Ⲳ', 'ⲵ' => 'Ⲵ', 'ⲷ' => 'Ⲷ', 'ⲹ' => 'Ⲹ', 'ⲻ' => 'Ⲻ', 'ⲽ' => 'Ⲽ', 'ⲿ' => 'Ⲿ', 'ⳁ' => 'Ⳁ', 'ⳃ' => 'Ⳃ', 'ⳅ' => 'Ⳅ', 'ⳇ' => 'Ⳇ', 'ⳉ' => 'Ⳉ', 'ⳋ' => 'Ⳋ', 'ⳍ' => 'Ⳍ', 'ⳏ' => 'Ⳏ', 'ⳑ' => 'Ⳑ', 'ⳓ' => 'Ⳓ', 'ⳕ' => 'Ⳕ', 'ⳗ' => 'Ⳗ', 'ⳙ' => 'Ⳙ', 'ⳛ' => 'Ⳛ', 'ⳝ' => 'Ⳝ', 'ⳟ' => 'Ⳟ', 'ⳡ' => 'Ⳡ', 'ⳣ' => 'Ⳣ', 'ⳬ' => 'Ⳬ', 'ⳮ' => 'Ⳮ', 'ⳳ' => 'Ⳳ', 'ⴀ' => 'Ⴀ', 'ⴁ' => 'Ⴁ', 'ⴂ' => 'Ⴂ', 'ⴃ' => 'Ⴃ', 'ⴄ' => 'Ⴄ', 'ⴅ' => 'Ⴅ', 'ⴆ' => 'Ⴆ', 'ⴇ' => 'Ⴇ', 'ⴈ' => 'Ⴈ', 'ⴉ' => 'Ⴉ', 'ⴊ' => 'Ⴊ', 'ⴋ' => 'Ⴋ', 'ⴌ' => 'Ⴌ', 'ⴍ' => 'Ⴍ', 'ⴎ' => 'Ⴎ', 'ⴏ' => 'Ⴏ', 'ⴐ' => 'Ⴐ', 'ⴑ' => 'Ⴑ', 'ⴒ' => 'Ⴒ', 'ⴓ' => 'Ⴓ', 'ⴔ' => 'Ⴔ', 'ⴕ' => 'Ⴕ', 'ⴖ' => 'Ⴖ', 'ⴗ' => 'Ⴗ', 'ⴘ' => 'Ⴘ', 'ⴙ' => 'Ⴙ', 'ⴚ' => 'Ⴚ', 'ⴛ' => 'Ⴛ', 'ⴜ' => 'Ⴜ', 'ⴝ' => 'Ⴝ', 'ⴞ' => 'Ⴞ', 'ⴟ' => 'Ⴟ', 'ⴠ' => 'Ⴠ', 'ⴡ' => 'Ⴡ', 'ⴢ' => 'Ⴢ', 'ⴣ' => 'Ⴣ', 'ⴤ' => 'Ⴤ', 'ⴥ' => 'Ⴥ', 'ⴧ' => 'Ⴧ', 'ⴭ' => 'Ⴭ', 'ꙁ' => 'Ꙁ', 'ꙃ' => 'Ꙃ', 'ꙅ' => 'Ꙅ', 'ꙇ' => 'Ꙇ', 'ꙉ' => 'Ꙉ', 'ꙋ' => 'Ꙋ', 'ꙍ' => 'Ꙍ', 'ꙏ' => 'Ꙏ', 'ꙑ' => 'Ꙑ', 'ꙓ' => 'Ꙓ', 'ꙕ' => 'Ꙕ', 'ꙗ' => 'Ꙗ', 'ꙙ' => 'Ꙙ', 'ꙛ' => 'Ꙛ', 'ꙝ' => 'Ꙝ', 'ꙟ' => 'Ꙟ', 'ꙡ' => 'Ꙡ', 'ꙣ' => 'Ꙣ', 'ꙥ' => 'Ꙥ', 'ꙧ' => 'Ꙧ', 'ꙩ' => 'Ꙩ', 'ꙫ' => 'Ꙫ', 'ꙭ' => 'Ꙭ', 'ꚁ' => 'Ꚁ', 'ꚃ' => 'Ꚃ', 'ꚅ' => 'Ꚅ', 'ꚇ' => 'Ꚇ', 'ꚉ' => 'Ꚉ', 'ꚋ' => 'Ꚋ', 'ꚍ' => 'Ꚍ', 'ꚏ' => 'Ꚏ', 'ꚑ' => 'Ꚑ', 'ꚓ' => 'Ꚓ', 'ꚕ' => 'Ꚕ', 'ꚗ' => 'Ꚗ', 'ꚙ' => 'Ꚙ', 'ꚛ' => 'Ꚛ', 'ꜣ' => 'Ꜣ', 'ꜥ' => 'Ꜥ', 'ꜧ' => 'Ꜧ', 'ꜩ' => 'Ꜩ', 'ꜫ' => 'Ꜫ', 'ꜭ' => 'Ꜭ', 'ꜯ' => 'Ꜯ', 'ꜳ' => 'Ꜳ', 'ꜵ' => 'Ꜵ', 'ꜷ' => 'Ꜷ', 'ꜹ' => 'Ꜹ', 'ꜻ' => 'Ꜻ', 'ꜽ' => 'Ꜽ', 'ꜿ' => 'Ꜿ', 'ꝁ' => 'Ꝁ', 'ꝃ' => 'Ꝃ', 'ꝅ' => 'Ꝅ', 'ꝇ' => 'Ꝇ', 'ꝉ' => 'Ꝉ', 'ꝋ' => 'Ꝋ', 'ꝍ' => 'Ꝍ', 'ꝏ' => 'Ꝏ', 'ꝑ' => 'Ꝑ', 'ꝓ' => 'Ꝓ', 'ꝕ' => 'Ꝕ', 'ꝗ' => 'Ꝗ', 'ꝙ' => 'Ꝙ', 'ꝛ' => 'Ꝛ', 'ꝝ' => 'Ꝝ', 'ꝟ' => 'Ꝟ', 'ꝡ' => 'Ꝡ', 'ꝣ' => 'Ꝣ', 'ꝥ' => 'Ꝥ', 'ꝧ' => 'Ꝧ', 'ꝩ' => 'Ꝩ', 'ꝫ' => 'Ꝫ', 'ꝭ' => 'Ꝭ', 'ꝯ' => 'Ꝯ', 'ꝺ' => 'Ꝺ', 'ꝼ' => 'Ꝼ', 'ꝿ' => 'Ꝿ', 'ꞁ' => 'Ꞁ', 'ꞃ' => 'Ꞃ', 'ꞅ' => 'Ꞅ', 'ꞇ' => 'Ꞇ', 'ꞌ' => 'Ꞌ', 'ꞑ' => 'Ꞑ', 'ꞓ' => 'Ꞓ', 'ꞔ' => 'Ꞔ', 'ꞗ' => 'Ꞗ', 'ꞙ' => 'Ꞙ', 'ꞛ' => 'Ꞛ', 'ꞝ' => 'Ꞝ', 'ꞟ' => 'Ꞟ', 'ꞡ' => 'Ꞡ', 'ꞣ' => 'Ꞣ', 'ꞥ' => 'Ꞥ', 'ꞧ' => 'Ꞧ', 'ꞩ' => 'Ꞩ', 'ꞵ' => 'Ꞵ', 'ꞷ' => 'Ꞷ', 'ꞹ' => 'Ꞹ', 'ꞻ' => 'Ꞻ', 'ꞽ' => 'Ꞽ', 'ꞿ' => 'Ꞿ', 'ꟃ' => 'Ꟃ', 'ꟈ' => 'Ꟈ', 'ꟊ' => 'Ꟊ', 'ꟶ' => 'Ꟶ', 'ꭓ' => 'Ꭓ', 'ꭰ' => 'Ꭰ', 'ꭱ' => 'Ꭱ', 'ꭲ' => 'Ꭲ', 'ꭳ' => 'Ꭳ', 'ꭴ' => 'Ꭴ', 'ꭵ' => 'Ꭵ', 'ꭶ' => 'Ꭶ', 'ꭷ' => 'Ꭷ', 'ꭸ' => 'Ꭸ', 'ꭹ' => 'Ꭹ', 'ꭺ' => 'Ꭺ', 'ꭻ' => 'Ꭻ', 'ꭼ' => 'Ꭼ', 'ꭽ' => 'Ꭽ', 'ꭾ' => 'Ꭾ', 'ꭿ' => 'Ꭿ', 'ꮀ' => 'Ꮀ', 'ꮁ' => 'Ꮁ', 'ꮂ' => 'Ꮂ', 'ꮃ' => 'Ꮃ', 'ꮄ' => 'Ꮄ', 'ꮅ' => 'Ꮅ', 'ꮆ' => 'Ꮆ', 'ꮇ' => 'Ꮇ', 'ꮈ' => 'Ꮈ', 'ꮉ' => 'Ꮉ', 'ꮊ' => 'Ꮊ', 'ꮋ' => 'Ꮋ', 'ꮌ' => 'Ꮌ', 'ꮍ' => 'Ꮍ', 'ꮎ' => 'Ꮎ', 'ꮏ' => 'Ꮏ', 'ꮐ' => 'Ꮐ', 'ꮑ' => 'Ꮑ', 'ꮒ' => 'Ꮒ', 'ꮓ' => 'Ꮓ', 'ꮔ' => 'Ꮔ', 'ꮕ' => 'Ꮕ', 'ꮖ' => 'Ꮖ', 'ꮗ' => 'Ꮗ', 'ꮘ' => 'Ꮘ', 'ꮙ' => 'Ꮙ', 'ꮚ' => 'Ꮚ', 'ꮛ' => 'Ꮛ', 'ꮜ' => 'Ꮜ', 'ꮝ' => 'Ꮝ', 'ꮞ' => 'Ꮞ', 'ꮟ' => 'Ꮟ', 'ꮠ' => 'Ꮠ', 'ꮡ' => 'Ꮡ', 'ꮢ' => 'Ꮢ', 'ꮣ' => 'Ꮣ', 'ꮤ' => 'Ꮤ', 'ꮥ' => 'Ꮥ', 'ꮦ' => 'Ꮦ', 'ꮧ' => 'Ꮧ', 'ꮨ' => 'Ꮨ', 'ꮩ' => 'Ꮩ', 'ꮪ' => 'Ꮪ', 'ꮫ' => 'Ꮫ', 'ꮬ' => 'Ꮬ', 'ꮭ' => 'Ꮭ', 'ꮮ' => 'Ꮮ', 'ꮯ' => 'Ꮯ', 'ꮰ' => 'Ꮰ', 'ꮱ' => 'Ꮱ', 'ꮲ' => 'Ꮲ', 'ꮳ' => 'Ꮳ', 'ꮴ' => 'Ꮴ', 'ꮵ' => 'Ꮵ', 'ꮶ' => 'Ꮶ', 'ꮷ' => 'Ꮷ', 'ꮸ' => 'Ꮸ', 'ꮹ' => 'Ꮹ', 'ꮺ' => 'Ꮺ', 'ꮻ' => 'Ꮻ', 'ꮼ' => 'Ꮼ', 'ꮽ' => 'Ꮽ', 'ꮾ' => 'Ꮾ', 'ꮿ' => 'Ꮿ', 'ａ' => 'Ａ', 'ｂ' => 'Ｂ', 'ｃ' => 'Ｃ', 'ｄ' => 'Ｄ', 'ｅ' => 'Ｅ', 'ｆ' => 'Ｆ', 'ｇ' => 'Ｇ', 'ｈ' => 'Ｈ', 'ｉ' => 'Ｉ', 'ｊ' => 'Ｊ', 'ｋ' => 'Ｋ', 'ｌ' => 'Ｌ', 'ｍ' => 'Ｍ', 'ｎ' => 'Ｎ', 'ｏ' => 'Ｏ', 'ｐ' => 'Ｐ', 'ｑ' => 'Ｑ', 'ｒ' => 'Ｒ', 'ｓ' => 'Ｓ', 'ｔ' => 'Ｔ', 'ｕ' => 'Ｕ', 'ｖ' => 'Ｖ', 'ｗ' => 'Ｗ', 'ｘ' => 'Ｘ', 'ｙ' => 'Ｙ', 'ｚ' => 'Ｚ', '𐐨' => '𐐀', '𐐩' => '𐐁', '𐐪' => '𐐂', '𐐫' => '𐐃', '𐐬' => '𐐄', '𐐭' => '𐐅', '𐐮' => '𐐆', '𐐯' => '𐐇', '𐐰' => '𐐈', '𐐱' => '𐐉', '𐐲' => '𐐊', '𐐳' => '𐐋', '𐐴' => '𐐌', '𐐵' => '𐐍', '𐐶' => '𐐎', '𐐷' => '𐐏', '𐐸' => '𐐐', '𐐹' => '𐐑', '𐐺' => '𐐒', '𐐻' => '𐐓', '𐐼' => '𐐔', '𐐽' => '𐐕', '𐐾' => '𐐖', '𐐿' => '𐐗', '𐑀' => '𐐘', '𐑁' => '𐐙', '𐑂' => '𐐚', '𐑃' => '𐐛', '𐑄' => '𐐜', '𐑅' => '𐐝', '𐑆' => '𐐞', '𐑇' => '𐐟', '𐑈' => '𐐠', '𐑉' => '𐐡', '𐑊' => '𐐢', '𐑋' => '𐐣', '𐑌' => '𐐤', '𐑍' => '𐐥', '𐑎' => '𐐦', '𐑏' => '𐐧', '𐓘' => '𐒰', '𐓙' => '𐒱', '𐓚' => '𐒲', '𐓛' => '𐒳', '𐓜' => '𐒴', '𐓝' => '𐒵', '𐓞' => '𐒶', '𐓟' => '𐒷', '𐓠' => '𐒸', '𐓡' => '𐒹', '𐓢' => '𐒺', '𐓣' => '𐒻', '𐓤' => '𐒼', '𐓥' => '𐒽', '𐓦' => '𐒾', '𐓧' => '𐒿', '𐓨' => '𐓀', '𐓩' => '𐓁', '𐓪' => '𐓂', '𐓫' => '𐓃', '𐓬' => '𐓄', '𐓭' => '𐓅', '𐓮' => '𐓆', '𐓯' => '𐓇', '𐓰' => '𐓈', '𐓱' => '𐓉', '𐓲' => '𐓊', '𐓳' => '𐓋', '𐓴' => '𐓌', '𐓵' => '𐓍', '𐓶' => '𐓎', '𐓷' => '𐓏', '𐓸' => '𐓐', '𐓹' => '𐓑', '𐓺' => '𐓒', '𐓻' => '𐓓', '𐳀' => '𐲀', '𐳁' => '𐲁', '𐳂' => '𐲂', '𐳃' => '𐲃', '𐳄' => '𐲄', '𐳅' => '𐲅', '𐳆' => '𐲆', '𐳇' => '𐲇', '𐳈' => '𐲈', '𐳉' => '𐲉', '𐳊' => '𐲊', '𐳋' => '𐲋', '𐳌' => '𐲌', '𐳍' => '𐲍', '𐳎' => '𐲎', '𐳏' => '𐲏', '𐳐' => '𐲐', '𐳑' => '𐲑', '𐳒' => '𐲒', '𐳓' => '𐲓', '𐳔' => '𐲔', '𐳕' => '𐲕', '𐳖' => '𐲖', '𐳗' => '𐲗', '𐳘' => '𐲘', '𐳙' => '𐲙', '𐳚' => '𐲚', '𐳛' => '𐲛', '𐳜' => '𐲜', '𐳝' => '𐲝', '𐳞' => '𐲞', '𐳟' => '𐲟', '𐳠' => '𐲠', '𐳡' => '𐲡', '𐳢' => '𐲢', '𐳣' => '𐲣', '𐳤' => '𐲤', '𐳥' => '𐲥', '𐳦' => '𐲦', '𐳧' => '𐲧', '𐳨' => '𐲨', '𐳩' => '𐲩', '𐳪' => '𐲪', '𐳫' => '𐲫', '𐳬' => '𐲬', '𐳭' => '𐲭', '𐳮' => '𐲮', '𐳯' => '𐲯', '𐳰' => '𐲰', '𐳱' => '𐲱', '𐳲' => '𐲲', '𑣀' => '𑢠', '𑣁' => '𑢡', '𑣂' => '𑢢', '𑣃' => '𑢣', '𑣄' => '𑢤', '𑣅' => '𑢥', '𑣆' => '𑢦', '𑣇' => '𑢧', '𑣈' => '𑢨', '𑣉' => '𑢩', '𑣊' => '𑢪', '𑣋' => '𑢫', '𑣌' => '𑢬', '𑣍' => '𑢭', '𑣎' => '𑢮', '𑣏' => '𑢯', '𑣐' => '𑢰', '𑣑' => '𑢱', '𑣒' => '𑢲', '𑣓' => '𑢳', '𑣔' => '𑢴', '𑣕' => '𑢵', '𑣖' => '𑢶', '𑣗' => '𑢷', '𑣘' => '𑢸', '𑣙' => '𑢹', '𑣚' => '𑢺', '𑣛' => '𑢻', '𑣜' => '𑢼', '𑣝' => '𑢽', '𑣞' => '𑢾', '𑣟' => '𑢿', '𖹠' => '𖹀', '𖹡' => '𖹁', '𖹢' => '𖹂', '𖹣' => '𖹃', '𖹤' => '𖹄', '𖹥' => '𖹅', '𖹦' => '𖹆', '𖹧' => '𖹇', '𖹨' => '𖹈', '𖹩' => '𖹉', '𖹪' => '𖹊', '𖹫' => '𖹋', '𖹬' => '𖹌', '𖹭' => '𖹍', '𖹮' => '𖹎', '𖹯' => '𖹏', '𖹰' => '𖹐', '𖹱' => '𖹑', '𖹲' => '𖹒', '𖹳' => '𖹓', '𖹴' => '𖹔', '𖹵' => '𖹕', '𖹶' => '𖹖', '𖹷' => '𖹗', '𖹸' => '𖹘', '𖹹' => '𖹙', '𖹺' => '𖹚', '𖹻' => '𖹛', '𖹼' => '𖹜', '𖹽' => '𖹝', '𖹾' => '𖹞', '𖹿' => '𖹟', '𞤢' => '𞤀', '𞤣' => '𞤁', '𞤤' => '𞤂', '𞤥' => '𞤃', '𞤦' => '𞤄', '𞤧' => '𞤅', '𞤨' => '𞤆', '𞤩' => '𞤇', '𞤪' => '𞤈', '𞤫' => '𞤉', '𞤬' => '𞤊', '𞤭' => '𞤋', '𞤮' => '𞤌', '𞤯' => '𞤍', '𞤰' => '𞤎', '𞤱' => '𞤏', '𞤲' => '𞤐', '𞤳' => '𞤑', '𞤴' => '𞤒', '𞤵' => '𞤓', '𞤶' => '𞤔', '𞤷' => '𞤕', '𞤸' => '𞤖', '𞤹' => '𞤗', '𞤺' => '𞤘', '𞤻' => '𞤙', '𞤼' => '𞤚', '𞤽' => '𞤛', '𞤾' => '𞤜', '𞤿' => '𞤝', '𞥀' => '𞤞', '𞥁' => '𞤟', '𞥂' => '𞤠', '𞥃' => '𞤡', 'ß' => 'SS', 'ff' => 'FF', 'fi' => 'FI', 'fl' => 'FL', 'ffi' => 'FFI', 'ffl' => 'FFL', 'ſt' => 'ST', 'st' => 'ST', 'և' => 'ԵՒ', 'ﬓ' => 'ՄՆ', 'ﬔ' => 'ՄԵ', 'ﬕ' => 'ՄԻ', 'ﬖ' => 'ՎՆ', 'ﬗ' => 'ՄԽ', 'ʼn' => 'ʼN', 'ΐ' => 'Ϊ́', 'ΰ' => 'Ϋ́', 'ǰ' => 'J̌', 'ẖ' => 'H̱', 'ẗ' => 'T̈', 'ẘ' => 'W̊', 'ẙ' => 'Y̊', 'ẚ' => 'Aʾ', 'ὐ' => 'Υ̓', 'ὒ' => 'Υ̓̀', 'ὔ' => 'Υ̓́', 'ὖ' => 'Υ̓͂', 'ᾶ' => 'Α͂', 'ῆ' => 'Η͂', 'ῒ' => 'Ϊ̀', 'ΐ' => 'Ϊ́', 'ῖ' => 'Ι͂', 'ῗ' => 'Ϊ͂', 'ῢ' => 'Ϋ̀', 'ΰ' => 'Ϋ́', 'ῤ' => 'Ρ̓', 'ῦ' => 'Υ͂', 'ῧ' => 'Ϋ͂', 'ῶ' => 'Ω͂', 'ᾈ' => 'ἈΙ', 'ᾉ' => 'ἉΙ', 'ᾊ' => 'ἊΙ', 'ᾋ' => 'ἋΙ', 'ᾌ' => 'ἌΙ', 'ᾍ' => 'ἍΙ', 'ᾎ' => 'ἎΙ', 'ᾏ' => 'ἏΙ', 'ᾘ' => 'ἨΙ', 'ᾙ' => 'ἩΙ', 'ᾚ' => 'ἪΙ', 'ᾛ' => 'ἫΙ', 'ᾜ' => 'ἬΙ', 'ᾝ' => 'ἭΙ', 'ᾞ' => 'ἮΙ', 'ᾟ' => 'ἯΙ', 'ᾨ' => 'ὨΙ', 'ᾩ' => 'ὩΙ', 'ᾪ' => 'ὪΙ', 'ᾫ' => 'ὫΙ', 'ᾬ' => 'ὬΙ', 'ᾭ' => 'ὭΙ', 'ᾮ' => 'ὮΙ', 'ᾯ' => 'ὯΙ', 'ᾼ' => 'ΑΙ', 'ῌ' => 'ΗΙ', 'ῼ' => 'ΩΙ', 'ᾲ' => 'ᾺΙ', 'ᾴ' => 'ΆΙ', 'ῂ' => 'ῊΙ', 'ῄ' => 'ΉΙ', 'ῲ' => 'ῺΙ', 'ῴ' => 'ΏΙ', 'ᾷ' => 'Α͂Ι', 'ῇ' => 'Η͂Ι', 'ῷ' => 'Ω͂Ι', ); * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Polyfill\Php80; /** * @author Fedonyuk Anton * * @internal */ class PhpToken implements \Stringable { /** * @var int */ public $id; /** * @var string */ public $text; /** * @var int */ public $line; /** * @var int */ public $pos; public function __construct(int $id, string $text, int $line = -1, int $position = -1) { $this->id = $id; $this->text = $text; $this->line = $line; $this->pos = $position; } public function getTokenName(): ?string { if ('UNKNOWN' === $name = token_name($this->id)) { $name = \strlen($this->text) > 1 || \ord($this->text) < 32 ? null : $this->text; } return $name; } /** * @param int|string|array $kind */ public function is($kind): bool { foreach ((array) $kind as $value) { if (\in_array($value, [$this->id, $this->text], true)) { return true; } } return false; } public function isIgnorable(): bool { return \in_array($this->id, [\T_WHITESPACE, \T_COMMENT, \T_DOC_COMMENT, \T_OPEN_TAG], true); } public function __toString(): string { return (string) $this->text; } /** * @return static[] */ public static function tokenize(string $code, int $flags = 0): array { $line = 1; $position = 0; $tokens = token_get_all($code, $flags); foreach ($tokens as $index => $token) { if (\is_string($token)) { $id = \ord($token); $text = $token; } else { [$id, $text, $line] = $token; } $tokens[$index] = new static($id, $text, $line, $position); $position += \strlen($text); } return $tokens; } } { "name": "symfony/polyfill-php80", "type": "library", "description": "Symfony polyfill backporting some PHP 8.0+ features to lower PHP versions", "keywords": ["polyfill", "shim", "compatibility", "portable"], "homepage": "https://symfony.com", "license": "MIT", "authors": [ { "name": "Ion Bazan", "email": "ion.bazan@gmail.com" }, { "name": "Nicolas Grekas", "email": "p@tchwork.com" }, { "name": "Symfony Community", "homepage": "https://symfony.com/contributors" } ], "require": { "php": ">=7.1" }, "autoload": { "psr-4": { "Symfony\\Polyfill\\Php80\\": "" }, "files": [ "bootstrap.php" ], "classmap": [ "Resources/stubs" ] }, "minimum-stability": "dev", "extra": { "branch-alias": { "dev-main": "1.27-dev" }, "thanks": { "name": "symfony/polyfill", "url": "https://github.com/symfony/polyfill" } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ use Symfony\Polyfill\Php80 as p; if (\PHP_VERSION_ID >= 80000) { return; } if (!defined('FILTER_VALIDATE_BOOL') && defined('FILTER_VALIDATE_BOOLEAN')) { define('FILTER_VALIDATE_BOOL', \FILTER_VALIDATE_BOOLEAN); } if (!function_exists('fdiv')) { function fdiv(float $num1, float $num2): float { return p\Php80::fdiv($num1, $num2); } } if (!function_exists('preg_last_error_msg')) { function preg_last_error_msg(): string { return p\Php80::preg_last_error_msg(); } } if (!function_exists('str_contains')) { function str_contains(?string $haystack, ?string $needle): bool { return p\Php80::str_contains($haystack ?? '', $needle ?? ''); } } if (!function_exists('str_starts_with')) { function str_starts_with(?string $haystack, ?string $needle): bool { return p\Php80::str_starts_with($haystack ?? '', $needle ?? ''); } } if (!function_exists('str_ends_with')) { function str_ends_with(?string $haystack, ?string $needle): bool { return p\Php80::str_ends_with($haystack ?? '', $needle ?? ''); } } if (!function_exists('get_debug_type')) { function get_debug_type($value): string { return p\Php80::get_debug_type($value); } } if (!function_exists('get_resource_id')) { function get_resource_id($resource): int { return p\Php80::get_resource_id($resource); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Polyfill\Php80; /** * @author Ion Bazan * @author Nico Oelgart * @author Nicolas Grekas * * @internal */ final class Php80 { public static function fdiv(float $dividend, float $divisor): float { return @($dividend / $divisor); } public static function get_debug_type($value): string { switch (true) { case null === $value: return 'null'; case \is_bool($value): return 'bool'; case \is_string($value): return 'string'; case \is_array($value): return 'array'; case \is_int($value): return 'int'; case \is_float($value): return 'float'; case \is_object($value): break; case $value instanceof \__PHP_Incomplete_Class: return '__PHP_Incomplete_Class'; default: if (null === $type = @get_resource_type($value)) { return 'unknown'; } if ('Unknown' === $type) { $type = 'closed'; } return "resource ($type)"; } $class = \get_class($value); if (false === strpos($class, '@')) { return $class; } return (get_parent_class($class) ?: key(class_implements($class)) ?: 'class').'@anonymous'; } public static function get_resource_id($res): int { if (!\is_resource($res) && null === @get_resource_type($res)) { throw new \TypeError(sprintf('Argument 1 passed to get_resource_id() must be of the type resource, %s given', get_debug_type($res))); } return (int) $res; } public static function preg_last_error_msg(): string { switch (preg_last_error()) { case \PREG_INTERNAL_ERROR: return 'Internal error'; case \PREG_BAD_UTF8_ERROR: return 'Malformed UTF-8 characters, possibly incorrectly encoded'; case \PREG_BAD_UTF8_OFFSET_ERROR: return 'The offset did not correspond to the beginning of a valid UTF-8 code point'; case \PREG_BACKTRACK_LIMIT_ERROR: return 'Backtrack limit exhausted'; case \PREG_RECURSION_LIMIT_ERROR: return 'Recursion limit exhausted'; case \PREG_JIT_STACKLIMIT_ERROR: return 'JIT stack limit exhausted'; case \PREG_NO_ERROR: return 'No error'; default: return 'Unknown error'; } } public static function str_contains(string $haystack, string $needle): bool { return '' === $needle || false !== strpos($haystack, $needle); } public static function str_starts_with(string $haystack, string $needle): bool { return 0 === strncmp($haystack, $needle, \strlen($needle)); } public static function str_ends_with(string $haystack, string $needle): bool { if ('' === $needle || $needle === $haystack) { return true; } if ('' === $haystack) { return false; } $needleLength = \strlen($needle); return $needleLength <= \strlen($haystack) && 0 === substr_compare($haystack, $needle, -$needleLength); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ if (\PHP_VERSION_ID < 80000) { class UnhandledMatchError extends Error { } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ if (\PHP_VERSION_ID < 80000) { class ValueError extends Error { } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ if (\PHP_VERSION_ID < 80000 && extension_loaded('tokenizer')) { class PhpToken extends Symfony\Polyfill\Php80\PhpToken { } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ #[Attribute(Attribute::TARGET_CLASS)] final class Attribute { public const TARGET_CLASS = 1; public const TARGET_FUNCTION = 2; public const TARGET_METHOD = 4; public const TARGET_PROPERTY = 8; public const TARGET_CLASS_CONSTANT = 16; public const TARGET_PARAMETER = 32; public const TARGET_ALL = 63; public const IS_REPEATABLE = 64; /** @var int */ public $flags; public function __construct(int $flags = self::TARGET_ALL) { $this->flags = $flags; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ if (\PHP_VERSION_ID < 80000) { interface Stringable { /** * @return string */ public function __toString(); } } 2b618e0557f937060a5931088fcde3bee24dfde7-812b618e0557f937060a5931088fcde3bee24dfde7-81q !;Z^9IKv Ev'޶AGBMB