SimplePie.class.php 473 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842984398449845984698479848984998509851985298539854985598569857985898599860986198629863986498659866986798689869987098719872987398749875987698779878987998809881988298839884988598869887988898899890989198929893989498959896989798989899990099019902990399049905990699079908990999109911991299139914991599169917991899199920992199229923992499259926992799289929993099319932993399349935993699379938993999409941994299439944994599469947994899499950995199529953995499559956995799589959996099619962996399649965996699679968996999709971997299739974997599769977997899799980998199829983998499859986998799889989999099919992999399949995999699979998999910000100011000210003100041000510006100071000810009100101001110012100131001410015100161001710018100191002010021100221002310024100251002610027100281002910030100311003210033100341003510036100371003810039100401004110042100431004410045100461004710048100491005010051100521005310054100551005610057100581005910060100611006210063100641006510066100671006810069100701007110072100731007410075100761007710078100791008010081100821008310084100851008610087100881008910090100911009210093100941009510096100971009810099101001010110102101031010410105101061010710108101091011010111101121011310114101151011610117101181011910120101211012210123101241012510126101271012810129101301013110132101331013410135101361013710138101391014010141101421014310144101451014610147101481014910150101511015210153101541015510156101571015810159101601016110162101631016410165101661016710168101691017010171101721017310174101751017610177101781017910180101811018210183101841018510186101871018810189101901019110192101931019410195101961019710198101991020010201102021020310204102051020610207102081020910210102111021210213102141021510216102171021810219102201022110222102231022410225102261022710228102291023010231102321023310234102351023610237102381023910240102411024210243102441024510246102471024810249102501025110252102531025410255102561025710258102591026010261102621026310264102651026610267102681026910270102711027210273102741027510276102771027810279102801028110282102831028410285102861028710288102891029010291102921029310294102951029610297102981029910300103011030210303103041030510306103071030810309103101031110312103131031410315103161031710318103191032010321103221032310324103251032610327103281032910330103311033210333103341033510336103371033810339103401034110342103431034410345103461034710348103491035010351103521035310354103551035610357103581035910360103611036210363103641036510366103671036810369103701037110372103731037410375103761037710378103791038010381103821038310384103851038610387103881038910390103911039210393103941039510396103971039810399104001040110402104031040410405104061040710408104091041010411104121041310414104151041610417104181041910420104211042210423104241042510426104271042810429104301043110432104331043410435104361043710438104391044010441104421044310444104451044610447104481044910450104511045210453104541045510456104571045810459104601046110462104631046410465104661046710468104691047010471104721047310474104751047610477104781047910480104811048210483104841048510486104871048810489104901049110492104931049410495104961049710498104991050010501105021050310504105051050610507105081050910510105111051210513105141051510516105171051810519105201052110522105231052410525105261052710528105291053010531105321053310534105351053610537105381053910540105411054210543105441054510546105471054810549105501055110552105531055410555105561055710558105591056010561105621056310564105651056610567105681056910570105711057210573105741057510576105771057810579105801058110582105831058410585105861058710588105891059010591105921059310594105951059610597105981059910600106011060210603106041060510606106071060810609106101061110612106131061410615106161061710618106191062010621106221062310624106251062610627106281062910630106311063210633106341063510636106371063810639106401064110642106431064410645106461064710648106491065010651106521065310654106551065610657106581065910660106611066210663106641066510666106671066810669106701067110672106731067410675106761067710678106791068010681106821068310684106851068610687106881068910690106911069210693106941069510696106971069810699107001070110702107031070410705107061070710708107091071010711107121071310714107151071610717107181071910720107211072210723107241072510726107271072810729107301073110732107331073410735107361073710738107391074010741107421074310744107451074610747107481074910750107511075210753107541075510756107571075810759107601076110762107631076410765107661076710768107691077010771107721077310774107751077610777107781077910780107811078210783107841078510786107871078810789107901079110792107931079410795107961079710798107991080010801108021080310804108051080610807108081080910810108111081210813108141081510816108171081810819108201082110822108231082410825108261082710828108291083010831108321083310834108351083610837108381083910840108411084210843108441084510846108471084810849108501085110852108531085410855108561085710858108591086010861108621086310864108651086610867108681086910870108711087210873108741087510876108771087810879108801088110882108831088410885108861088710888108891089010891108921089310894108951089610897108981089910900109011090210903109041090510906109071090810909109101091110912109131091410915109161091710918109191092010921109221092310924109251092610927109281092910930109311093210933109341093510936109371093810939109401094110942109431094410945109461094710948109491095010951109521095310954109551095610957109581095910960109611096210963109641096510966109671096810969109701097110972109731097410975109761097710978109791098010981109821098310984109851098610987109881098910990109911099210993109941099510996109971099810999110001100111002110031100411005110061100711008110091101011011110121101311014110151101611017110181101911020110211102211023110241102511026110271102811029110301103111032110331103411035110361103711038110391104011041110421104311044110451104611047110481104911050110511105211053110541105511056110571105811059110601106111062110631106411065110661106711068110691107011071110721107311074110751107611077110781107911080110811108211083110841108511086110871108811089110901109111092110931109411095110961109711098110991110011101111021110311104111051110611107111081110911110111111111211113111141111511116111171111811119111201112111122111231112411125111261112711128111291113011131111321113311134111351113611137111381113911140111411114211143111441114511146111471114811149111501115111152111531115411155111561115711158111591116011161111621116311164111651116611167111681116911170111711117211173111741117511176111771117811179111801118111182111831118411185111861118711188111891119011191111921119311194111951119611197111981119911200112011120211203112041120511206112071120811209112101121111212112131121411215112161121711218112191122011221112221122311224112251122611227112281122911230112311123211233112341123511236112371123811239112401124111242112431124411245112461124711248112491125011251112521125311254112551125611257112581125911260112611126211263112641126511266112671126811269112701127111272112731127411275112761127711278112791128011281112821128311284112851128611287112881128911290112911129211293112941129511296112971129811299113001130111302113031130411305113061130711308113091131011311113121131311314113151131611317113181131911320113211132211323113241132511326113271132811329113301133111332113331133411335113361133711338113391134011341113421134311344113451134611347113481134911350113511135211353113541135511356113571135811359113601136111362113631136411365113661136711368113691137011371113721137311374113751137611377113781137911380113811138211383113841138511386113871138811389113901139111392113931139411395113961139711398113991140011401114021140311404114051140611407114081140911410114111141211413114141141511416114171141811419114201142111422114231142411425114261142711428114291143011431114321143311434114351143611437114381143911440114411144211443114441144511446114471144811449114501145111452114531145411455114561145711458114591146011461114621146311464114651146611467114681146911470114711147211473114741147511476114771147811479114801148111482114831148411485114861148711488114891149011491114921149311494114951149611497114981149911500115011150211503115041150511506115071150811509115101151111512115131151411515115161151711518115191152011521115221152311524115251152611527115281152911530115311153211533115341153511536115371153811539115401154111542115431154411545115461154711548115491155011551115521155311554115551155611557115581155911560115611156211563115641156511566115671156811569115701157111572115731157411575115761157711578115791158011581115821158311584115851158611587115881158911590115911159211593115941159511596115971159811599116001160111602116031160411605116061160711608116091161011611116121161311614116151161611617116181161911620116211162211623116241162511626116271162811629116301163111632116331163411635116361163711638116391164011641116421164311644116451164611647116481164911650116511165211653116541165511656116571165811659116601166111662116631166411665116661166711668116691167011671116721167311674116751167611677116781167911680116811168211683116841168511686116871168811689116901169111692116931169411695116961169711698116991170011701117021170311704117051170611707117081170911710117111171211713117141171511716117171171811719117201172111722117231172411725117261172711728117291173011731117321173311734117351173611737117381173911740117411174211743117441174511746117471174811749117501175111752117531175411755117561175711758117591176011761117621176311764117651176611767117681176911770117711177211773117741177511776117771177811779117801178111782117831178411785117861178711788117891179011791117921179311794117951179611797117981179911800118011180211803118041180511806118071180811809118101181111812118131181411815118161181711818118191182011821118221182311824118251182611827118281182911830118311183211833118341183511836118371183811839118401184111842118431184411845118461184711848118491185011851118521185311854118551185611857118581185911860118611186211863118641186511866118671186811869118701187111872118731187411875118761187711878118791188011881118821188311884118851188611887118881188911890118911189211893118941189511896118971189811899119001190111902119031190411905119061190711908119091191011911119121191311914119151191611917119181191911920119211192211923119241192511926119271192811929119301193111932119331193411935119361193711938119391194011941119421194311944119451194611947119481194911950119511195211953119541195511956119571195811959119601196111962119631196411965119661196711968119691197011971119721197311974119751197611977119781197911980119811198211983119841198511986119871198811989119901199111992119931199411995119961199711998119991200012001120021200312004120051200612007120081200912010120111201212013120141201512016120171201812019120201202112022120231202412025120261202712028120291203012031120321203312034120351203612037120381203912040120411204212043120441204512046120471204812049120501205112052120531205412055120561205712058120591206012061120621206312064120651206612067120681206912070120711207212073120741207512076120771207812079120801208112082120831208412085120861208712088120891209012091120921209312094120951209612097120981209912100121011210212103121041210512106121071210812109121101211112112121131211412115121161211712118121191212012121121221212312124121251212612127121281212912130121311213212133121341213512136121371213812139121401214112142121431214412145121461214712148121491215012151121521215312154121551215612157121581215912160121611216212163121641216512166121671216812169121701217112172121731217412175121761217712178121791218012181121821218312184121851218612187121881218912190121911219212193121941219512196121971219812199122001220112202122031220412205122061220712208122091221012211122121221312214122151221612217122181221912220122211222212223122241222512226122271222812229122301223112232122331223412235122361223712238122391224012241122421224312244122451224612247122481224912250122511225212253122541225512256122571225812259122601226112262122631226412265122661226712268122691227012271122721227312274122751227612277122781227912280122811228212283122841228512286122871228812289122901229112292122931229412295122961229712298122991230012301123021230312304123051230612307123081230912310123111231212313123141231512316123171231812319123201232112322123231232412325123261232712328123291233012331123321233312334123351233612337123381233912340123411234212343123441234512346123471234812349123501235112352123531235412355123561235712358123591236012361123621236312364123651236612367123681236912370123711237212373123741237512376123771237812379123801238112382123831238412385123861238712388123891239012391123921239312394123951239612397123981239912400124011240212403124041240512406124071240812409124101241112412124131241412415124161241712418124191242012421124221242312424124251242612427124281242912430124311243212433124341243512436124371243812439124401244112442124431244412445124461244712448124491245012451124521245312454124551245612457124581245912460124611246212463124641246512466124671246812469124701247112472124731247412475124761247712478124791248012481124821248312484124851248612487124881248912490124911249212493124941249512496124971249812499125001250112502125031250412505125061250712508125091251012511125121251312514125151251612517125181251912520125211252212523125241252512526125271252812529125301253112532125331253412535125361253712538125391254012541125421254312544125451254612547125481254912550125511255212553125541255512556125571255812559125601256112562125631256412565125661256712568125691257012571125721257312574125751257612577125781257912580125811258212583125841258512586125871258812589125901259112592125931259412595125961259712598125991260012601126021260312604126051260612607126081260912610126111261212613126141261512616126171261812619126201262112622126231262412625126261262712628126291263012631126321263312634126351263612637126381263912640126411264212643126441264512646126471264812649126501265112652126531265412655126561265712658126591266012661126621266312664126651266612667126681266912670126711267212673126741267512676126771267812679126801268112682126831268412685126861268712688126891269012691126921269312694126951269612697126981269912700127011270212703127041270512706127071270812709127101271112712127131271412715127161271712718127191272012721127221272312724127251272612727127281272912730127311273212733127341273512736127371273812739127401274112742127431274412745127461274712748127491275012751127521275312754127551275612757127581275912760127611276212763127641276512766127671276812769127701277112772127731277412775127761277712778127791278012781127821278312784127851278612787127881278912790127911279212793127941279512796127971279812799128001280112802128031280412805128061280712808128091281012811128121281312814128151281612817128181281912820128211282212823128241282512826128271282812829128301283112832128331283412835128361283712838128391284012841128421284312844128451284612847128481284912850128511285212853128541285512856128571285812859128601286112862128631286412865128661286712868128691287012871128721287312874128751287612877128781287912880128811288212883128841288512886128871288812889128901289112892128931289412895128961289712898128991290012901129021290312904129051290612907129081290912910129111291212913129141291512916129171291812919129201292112922129231292412925129261292712928129291293012931129321293312934129351293612937129381293912940129411294212943129441294512946129471294812949129501295112952129531295412955129561295712958129591296012961129621296312964129651296612967129681296912970129711297212973129741297512976129771297812979129801298112982129831298412985129861298712988129891299012991129921299312994129951299612997129981299913000130011300213003130041300513006130071300813009130101301113012130131301413015130161301713018130191302013021130221302313024130251302613027130281302913030130311303213033130341303513036130371303813039130401304113042130431304413045130461304713048130491305013051130521305313054130551305613057130581305913060130611306213063130641306513066130671306813069130701307113072130731307413075130761307713078130791308013081130821308313084130851308613087130881308913090130911309213093130941309513096130971309813099131001310113102131031310413105131061310713108131091311013111131121311313114131151311613117131181311913120131211312213123131241312513126131271312813129131301313113132131331313413135131361313713138131391314013141131421314313144131451314613147131481314913150131511315213153131541315513156131571315813159131601316113162131631316413165131661316713168131691317013171131721317313174131751317613177131781317913180131811318213183131841318513186131871318813189131901319113192131931319413195131961319713198131991320013201132021320313204132051320613207132081320913210132111321213213132141321513216132171321813219132201322113222132231322413225132261322713228132291323013231132321323313234132351323613237132381323913240132411324213243132441324513246132471324813249132501325113252132531325413255132561325713258132591326013261132621326313264132651326613267132681326913270132711327213273132741327513276132771327813279132801328113282132831328413285132861328713288132891329013291132921329313294132951329613297132981329913300133011330213303133041330513306133071330813309133101331113312133131331413315133161331713318133191332013321133221332313324133251332613327133281332913330133311333213333133341333513336133371333813339133401334113342133431334413345133461334713348133491335013351133521335313354133551335613357133581335913360133611336213363133641336513366133671336813369133701337113372133731337413375133761337713378133791338013381133821338313384133851338613387133881338913390133911339213393133941339513396133971339813399134001340113402134031340413405134061340713408134091341013411134121341313414134151341613417134181341913420134211342213423134241342513426134271342813429134301343113432134331343413435134361343713438134391344013441134421344313444134451344613447134481344913450134511345213453134541345513456134571345813459134601346113462134631346413465134661346713468134691347013471134721347313474134751347613477134781347913480134811348213483134841348513486134871348813489134901349113492134931349413495134961349713498134991350013501135021350313504135051350613507135081350913510135111351213513135141351513516135171351813519135201352113522135231352413525135261352713528135291353013531135321353313534135351353613537135381353913540135411354213543135441354513546135471354813549135501355113552135531355413555135561355713558135591356013561135621356313564135651356613567135681356913570135711357213573135741357513576135771357813579135801358113582135831358413585135861358713588135891359013591135921359313594135951359613597135981359913600136011360213603136041360513606136071360813609136101361113612136131361413615136161361713618136191362013621136221362313624136251362613627136281362913630136311363213633136341363513636136371363813639136401364113642136431364413645136461364713648136491365013651136521365313654136551365613657136581365913660136611366213663136641366513666136671366813669136701367113672136731367413675136761367713678136791368013681136821368313684136851368613687136881368913690136911369213693136941369513696136971369813699137001370113702137031370413705137061370713708137091371013711137121371313714137151371613717137181371913720137211372213723137241372513726137271372813729137301373113732137331373413735137361373713738137391374013741137421374313744137451374613747137481374913750137511375213753137541375513756137571375813759137601376113762137631376413765137661376713768137691377013771137721377313774137751377613777137781377913780137811378213783137841378513786137871378813789137901379113792137931379413795137961379713798137991380013801138021380313804138051380613807138081380913810138111381213813138141381513816138171381813819138201382113822138231382413825138261382713828138291383013831138321383313834138351383613837138381383913840138411384213843138441384513846138471384813849138501385113852138531385413855138561385713858138591386013861138621386313864138651386613867138681386913870138711387213873138741387513876138771387813879138801388113882138831388413885138861388713888138891389013891138921389313894138951389613897138981389913900139011390213903139041390513906139071390813909139101391113912139131391413915139161391713918139191392013921139221392313924139251392613927139281392913930139311393213933139341393513936139371393813939139401394113942139431394413945139461394713948139491395013951139521395313954139551395613957139581395913960139611396213963139641396513966139671396813969139701397113972139731397413975139761397713978139791398013981139821398313984139851398613987139881398913990139911399213993139941399513996139971399813999140001400114002140031400414005140061400714008140091401014011140121401314014140151401614017140181401914020140211402214023140241402514026140271402814029140301403114032140331403414035140361403714038140391404014041140421404314044140451404614047140481404914050140511405214053140541405514056140571405814059140601406114062140631406414065140661406714068140691407014071140721407314074140751407614077140781407914080140811408214083140841408514086140871408814089140901409114092140931409414095140961409714098140991410014101141021410314104141051410614107141081410914110141111411214113141141411514116141171411814119141201412114122141231412414125141261412714128141291413014131141321413314134141351413614137141381413914140141411414214143141441414514146141471414814149141501415114152141531415414155141561415714158141591416014161141621416314164141651416614167141681416914170141711417214173141741417514176141771417814179141801418114182141831418414185141861418714188141891419014191141921419314194141951419614197141981419914200142011420214203142041420514206142071420814209142101421114212142131421414215142161421714218142191422014221142221422314224142251422614227142281422914230142311423214233142341423514236142371423814239142401424114242142431424414245142461424714248142491425014251142521425314254142551425614257142581425914260142611426214263142641426514266142671426814269142701427114272142731427414275142761427714278142791428014281142821428314284142851428614287142881428914290142911429214293142941429514296142971429814299143001430114302143031430414305143061430714308143091431014311143121431314314143151431614317143181431914320143211432214323143241432514326143271432814329143301433114332143331433414335143361433714338143391434014341143421434314344143451434614347143481434914350143511435214353143541435514356143571435814359143601436114362143631436414365143661436714368143691437014371143721437314374143751437614377143781437914380143811438214383143841438514386143871438814389143901439114392143931439414395143961439714398143991440014401144021440314404144051440614407144081440914410144111441214413144141441514416144171441814419144201442114422144231442414425144261442714428144291443014431144321443314434144351443614437144381443914440144411444214443144441444514446144471444814449144501445114452144531445414455144561445714458144591446014461144621446314464144651446614467144681446914470144711447214473144741447514476144771447814479144801448114482144831448414485144861448714488144891449014491144921449314494144951449614497144981449914500145011450214503145041450514506145071450814509145101451114512145131451414515145161451714518145191452014521145221452314524145251452614527145281452914530145311453214533145341453514536145371453814539145401454114542145431454414545145461454714548145491455014551145521455314554145551455614557145581455914560145611456214563145641456514566145671456814569145701457114572145731457414575145761457714578145791458014581145821458314584145851458614587145881458914590145911459214593145941459514596145971459814599146001460114602146031460414605146061460714608146091461014611146121461314614146151461614617146181461914620146211462214623146241462514626146271462814629146301463114632146331463414635146361463714638146391464014641146421464314644146451464614647146481464914650146511465214653146541465514656146571465814659146601466114662146631466414665146661466714668146691467014671146721467314674146751467614677146781467914680146811468214683146841468514686146871468814689146901469114692146931469414695146961469714698146991470014701147021470314704147051470614707147081470914710147111471214713147141471514716147171471814719147201472114722147231472414725147261472714728147291473014731147321473314734147351473614737147381473914740147411474214743147441474514746147471474814749147501475114752147531475414755147561475714758147591476014761147621476314764147651476614767147681476914770147711477214773147741477514776147771477814779147801478114782147831478414785147861478714788147891479014791147921479314794147951479614797147981479914800148011480214803148041480514806148071480814809148101481114812148131481414815148161481714818148191482014821148221482314824148251482614827148281482914830148311483214833148341483514836148371483814839148401484114842148431484414845148461484714848148491485014851148521485314854148551485614857148581485914860148611486214863148641486514866148671486814869148701487114872148731487414875148761487714878148791488014881148821488314884148851488614887148881488914890148911489214893148941489514896148971489814899149001490114902149031490414905149061490714908149091491014911149121491314914149151491614917149181491914920149211492214923149241492514926149271492814929149301493114932149331493414935149361493714938149391494014941149421494314944149451494614947149481494914950149511495214953149541495514956149571495814959149601496114962149631496414965149661496714968149691497014971149721497314974149751497614977149781497914980149811498214983149841498514986149871498814989149901499114992149931499414995149961499714998149991500015001150021500315004150051500615007150081500915010150111501215013150141501515016150171501815019150201502115022150231502415025150261502715028150291503015031150321503315034150351503615037150381503915040150411504215043150441504515046150471504815049150501505115052150531505415055150561505715058150591506015061150621506315064150651506615067150681506915070150711507215073150741507515076150771507815079150801508115082150831508415085150861508715088150891509015091150921509315094150951509615097150981509915100151011510215103151041510515106151071510815109151101511115112151131511415115151161511715118151191512015121151221512315124151251512615127151281512915130151311513215133151341513515136151371513815139151401514115142151431514415145151461514715148151491515015151151521515315154151551515615157151581515915160151611516215163151641516515166151671516815169151701517115172151731517415175151761517715178151791518015181151821518315184151851518615187151881518915190151911519215193151941519515196151971519815199152001520115202152031520415205152061520715208152091521015211152121521315214152151521615217152181521915220152211522215223152241522515226152271522815229152301523115232152331523415235152361523715238152391524015241152421524315244152451524615247152481524915250152511525215253152541525515256152571525815259152601526115262152631526415265152661526715268152691527015271152721527315274152751527615277152781527915280152811528215283152841528515286152871528815289152901529115292152931529415295152961529715298152991530015301153021530315304153051530615307153081530915310153111531215313153141531515316153171531815319153201532115322153231532415325153261532715328153291533015331153321533315334153351533615337153381533915340153411534215343153441534515346153471534815349153501535115352153531535415355153561535715358153591536015361153621536315364153651536615367153681536915370153711537215373153741537515376153771537815379153801538115382153831538415385153861538715388153891539015391153921539315394153951539615397153981539915400154011540215403154041540515406154071540815409154101541115412154131541415415154161541715418154191542015421154221542315424154251542615427154281542915430154311543215433154341543515436154371543815439154401544115442154431544415445154461544715448154491545015451154521545315454154551545615457154581545915460154611546215463154641546515466154671546815469154701547115472154731547415475154761547715478154791548015481154821548315484154851548615487154881548915490154911549215493154941549515496154971549815499155001550115502155031550415505155061550715508155091551015511155121551315514155151551615517155181551915520155211552215523155241552515526155271552815529155301553115532155331553415535155361553715538155391554015541155421554315544155451554615547155481554915550155511555215553155541555515556155571555815559155601556115562155631556415565155661556715568155691557015571155721557315574155751557615577155781557915580155811558215583155841558515586155871558815589155901559115592155931559415595155961559715598155991560015601156021560315604156051560615607156081560915610156111561215613156141561515616156171561815619156201562115622156231562415625156261562715628156291563015631156321563315634156351563615637156381563915640156411564215643156441564515646156471564815649156501565115652156531565415655156561565715658156591566015661156621566315664156651566615667156681566915670156711567215673156741567515676156771567815679156801568115682156831568415685156861568715688156891569015691156921569315694156951569615697156981569915700157011570215703157041570515706157071570815709157101571115712157131571415715157161571715718157191572015721157221572315724157251572615727157281572915730157311573215733157341573515736157371573815739157401574115742157431574415745157461574715748157491575015751157521575315754157551575615757157581575915760157611576215763157641576515766157671576815769157701577115772157731577415775157761577715778157791578015781157821578315784157851578615787157881578915790157911579215793157941579515796157971579815799158001580115802158031580415805158061580715808158091581015811158121581315814158151581615817158181581915820158211582215823158241582515826158271582815829158301583115832158331583415835158361583715838158391584015841158421584315844158451584615847158481584915850158511585215853158541585515856158571585815859158601586115862158631586415865158661586715868158691587015871158721587315874158751587615877158781587915880158811588215883158841588515886158871588815889158901589115892158931589415895158961589715898158991590015901159021590315904159051590615907159081590915910159111591215913159141591515916159171591815919159201592115922159231592415925159261592715928159291593015931159321593315934159351593615937159381593915940159411594215943159441594515946159471594815949159501595115952159531595415955159561595715958159591596015961159621596315964159651596615967159681596915970159711597215973159741597515976159771597815979159801598115982159831598415985159861598715988159891599015991159921599315994159951599615997159981599916000160011600216003160041600516006160071600816009160101601116012160131601416015160161601716018160191602016021160221602316024160251602616027160281602916030160311603216033160341603516036160371603816039160401604116042160431604416045160461604716048160491605016051160521605316054160551605616057160581605916060160611606216063160641606516066160671606816069160701607116072160731607416075160761607716078160791608016081160821608316084160851608616087160881608916090160911609216093160941609516096160971609816099161001610116102161031610416105161061610716108161091611016111161121611316114161151611616117161181611916120161211612216123161241612516126161271612816129161301613116132161331613416135161361613716138161391614016141161421614316144161451614616147161481614916150161511615216153161541615516156161571615816159161601616116162161631616416165161661616716168161691617016171161721617316174161751617616177161781617916180161811618216183161841618516186161871618816189161901619116192161931619416195161961619716198161991620016201162021620316204162051620616207162081620916210162111621216213162141621516216162171621816219162201622116222162231622416225162261622716228162291623016231162321623316234162351623616237162381623916240162411624216243162441624516246162471624816249162501625116252162531625416255162561625716258162591626016261162621626316264162651626616267162681626916270162711627216273162741627516276162771627816279162801628116282162831628416285162861628716288162891629016291162921629316294162951629616297162981629916300163011630216303163041630516306163071630816309163101631116312163131631416315163161631716318163191632016321163221632316324163251632616327163281632916330163311633216333163341633516336163371633816339163401634116342163431634416345163461634716348163491635016351163521635316354163551635616357163581635916360163611636216363163641636516366163671636816369163701637116372163731637416375163761637716378163791638016381163821638316384163851638616387163881638916390163911639216393163941639516396163971639816399164001640116402164031640416405164061640716408164091641016411164121641316414164151641616417164181641916420164211642216423164241642516426164271642816429164301643116432164331643416435164361643716438164391644016441164421644316444164451644616447164481644916450164511645216453164541645516456164571645816459164601646116462164631646416465164661646716468164691647016471164721647316474164751647616477164781647916480164811648216483164841648516486164871648816489164901649116492164931649416495164961649716498164991650016501165021650316504165051650616507165081650916510165111651216513165141651516516165171651816519165201652116522165231652416525165261652716528165291653016531165321653316534165351653616537165381653916540165411654216543165441654516546165471654816549165501655116552165531655416555165561655716558165591656016561165621656316564165651656616567165681656916570165711657216573165741657516576165771657816579165801658116582165831658416585165861658716588165891659016591165921659316594165951659616597165981659916600166011660216603166041660516606166071660816609166101661116612166131661416615166161661716618166191662016621166221662316624166251662616627166281662916630166311663216633166341663516636166371663816639166401664116642166431664416645166461664716648166491665016651166521665316654166551665616657166581665916660166611666216663166641666516666166671666816669166701667116672166731667416675166761667716678166791668016681166821668316684166851668616687166881668916690166911669216693166941669516696166971669816699167001670116702167031670416705167061670716708167091671016711167121671316714167151671616717167181671916720167211672216723167241672516726167271672816729167301673116732167331673416735167361673716738167391674016741167421674316744167451674616747167481674916750167511675216753167541675516756167571675816759167601676116762167631676416765167661676716768167691677016771167721677316774167751677616777167781677916780167811678216783167841678516786167871678816789167901679116792167931679416795167961679716798167991680016801168021680316804168051680616807168081680916810168111681216813168141681516816168171681816819168201682116822168231682416825168261682716828168291683016831168321683316834168351683616837168381683916840168411684216843168441684516846168471684816849168501685116852168531685416855168561685716858168591686016861168621686316864168651686616867168681686916870168711687216873168741687516876168771687816879168801688116882168831688416885168861688716888168891689016891168921689316894168951689616897168981689916900169011690216903169041690516906169071690816909169101691116912169131691416915169161691716918169191692016921169221692316924169251692616927169281692916930169311693216933169341693516936169371693816939169401694116942169431694416945169461694716948169491695016951169521695316954169551695616957169581695916960169611696216963169641696516966169671696816969169701697116972169731697416975169761697716978169791698016981169821698316984169851698616987169881698916990169911699216993169941699516996169971699816999170001700117002170031700417005170061700717008170091701017011170121701317014170151701617017170181701917020170211702217023170241702517026170271702817029170301703117032170331703417035170361703717038170391704017041170421704317044170451704617047170481704917050170511705217053170541705517056170571705817059170601706117062170631706417065170661706717068170691707017071170721707317074170751707617077170781707917080170811708217083170841708517086170871708817089170901709117092170931709417095170961709717098170991710017101171021710317104171051710617107171081710917110171111711217113171141711517116171171711817119171201712117122171231712417125171261712717128171291713017131171321713317134171351713617137171381713917140171411714217143171441714517146171471714817149171501715117152171531715417155171561715717158171591716017161171621716317164171651716617167171681716917170171711717217173171741717517176171771717817179171801718117182171831718417185171861718717188171891719017191171921719317194171951719617197171981719917200172011720217203172041720517206172071720817209172101721117212172131721417215172161721717218172191722017221172221722317224172251722617227172281722917230172311723217233172341723517236172371723817239172401724117242172431724417245172461724717248172491725017251172521725317254172551725617257172581725917260172611726217263172641726517266172671726817269172701727117272172731727417275172761727717278172791728017281172821728317284172851728617287172881728917290172911729217293172941729517296172971729817299173001730117302173031730417305173061730717308173091731017311173121731317314173151731617317173181731917320173211732217323173241732517326173271732817329173301733117332173331733417335173361733717338173391734017341173421734317344173451734617347173481734917350173511735217353173541735517356173571735817359173601736117362173631736417365173661736717368173691737017371173721737317374173751737617377173781737917380173811738217383173841738517386173871738817389173901739117392173931739417395173961739717398173991740017401174021740317404174051740617407174081740917410174111741217413174141741517416174171741817419174201742117422174231742417425174261742717428174291743017431174321743317434174351743617437174381743917440174411744217443174441744517446174471744817449174501745117452174531745417455174561745717458174591746017461174621746317464174651746617467174681746917470174711747217473174741747517476174771747817479174801748117482174831748417485174861748717488174891749017491174921749317494174951749617497174981749917500175011750217503175041750517506175071750817509175101751117512175131751417515175161751717518175191752017521175221752317524175251752617527175281752917530175311753217533175341753517536175371753817539175401754117542175431754417545175461754717548175491755017551175521755317554175551755617557175581755917560175611756217563175641756517566175671756817569175701757117572175731757417575175761757717578175791758017581175821758317584175851758617587175881758917590175911759217593175941759517596175971759817599176001760117602176031760417605176061760717608176091761017611176121761317614176151761617617176181761917620176211762217623176241762517626176271762817629176301763117632176331763417635176361763717638176391764017641176421764317644176451764617647176481764917650176511765217653176541765517656176571765817659176601766117662176631766417665176661766717668176691767017671176721767317674176751767617677176781767917680176811768217683176841768517686176871768817689176901769117692176931769417695176961769717698176991770017701177021770317704177051770617707177081770917710177111771217713177141771517716177171771817719177201772117722177231772417725177261772717728177291773017731177321773317734177351773617737177381773917740177411774217743177441774517746177471774817749177501775117752177531775417755177561775717758177591776017761177621776317764177651776617767177681776917770177711777217773177741777517776177771777817779177801778117782177831778417785177861778717788177891779017791177921779317794177951779617797177981779917800178011780217803178041780517806178071780817809178101781117812178131781417815178161781717818178191782017821178221782317824178251782617827178281782917830178311783217833178341783517836178371783817839178401784117842178431784417845178461784717848178491785017851178521785317854178551785617857178581785917860178611786217863178641786517866178671786817869178701787117872178731787417875178761787717878178791788017881178821788317884178851788617887178881788917890178911789217893178941789517896178971789817899179001790117902179031790417905179061790717908179091791017911179121791317914179151791617917179181791917920179211792217923179241792517926179271792817929179301793117932179331793417935179361793717938179391794017941179421794317944179451794617947179481794917950179511795217953179541795517956179571795817959179601796117962179631796417965179661796717968179691797017971179721797317974179751797617977179781797917980179811798217983179841798517986179871798817989179901799117992179931799417995179961799717998179991800018001180021800318004180051800618007180081800918010180111801218013180141801518016180171801818019180201802118022180231802418025180261802718028180291803018031180321803318034180351803618037180381803918040180411804218043180441804518046180471804818049180501805118052180531805418055180561805718058180591806018061180621806318064180651806618067180681806918070180711807218073180741807518076180771807818079180801808118082180831808418085180861808718088180891809018091180921809318094180951809618097180981809918100181011810218103181041810518106181071810818109181101811118112181131811418115181161811718118181191812018121181221812318124181251812618127181281812918130181311813218133181341813518136181371813818139181401814118142181431814418145181461814718148181491815018151181521815318154181551815618157181581815918160181611816218163181641816518166181671816818169181701817118172181731817418175181761817718178181791818018181181821818318184181851818618187181881818918190181911819218193181941819518196181971819818199182001820118202182031820418205182061820718208182091821018211182121821318214182151821618217182181821918220182211822218223182241822518226182271822818229182301823118232182331823418235182361823718238182391824018241182421824318244182451824618247182481824918250182511825218253182541825518256182571825818259182601826118262182631826418265182661826718268182691827018271182721827318274182751827618277182781827918280182811828218283182841828518286182871828818289182901829118292182931829418295182961829718298182991830018301183021830318304183051830618307183081830918310183111831218313183141831518316183171831818319183201832118322183231832418325183261832718328183291833018331183321833318334183351833618337183381833918340183411834218343183441834518346183471834818349183501835118352183531835418355183561835718358183591836018361183621836318364183651836618367183681836918370183711837218373183741837518376183771837818379183801838118382183831838418385183861838718388183891839018391183921839318394183951839618397183981839918400184011840218403184041840518406184071840818409184101841118412184131841418415184161841718418184191842018421184221842318424184251842618427184281842918430184311843218433184341843518436184371843818439184401844118442184431844418445184461844718448184491845018451184521845318454184551845618457184581845918460184611846218463184641846518466184671846818469184701847118472184731847418475184761847718478184791848018481184821848318484184851848618487184881848918490184911849218493184941849518496184971849818499185001850118502185031850418505185061850718508185091851018511
  1. <?php
  2. /**
  3. * SimplePie
  4. *
  5. * A PHP-Based RSS and Atom Feed Framework.
  6. * Takes the hard work out of managing a complete RSS/Atom solution.
  7. *
  8. * Please note: This file is automatically generated by a build script. The
  9. * full original source is always available from http://simplepie.org/
  10. *
  11. * Copyright (c) 2004-2016, Ryan Parman, Sam Sneddon, Ryan McCue, and contributors
  12. * All rights reserved.
  13. *
  14. * Redistribution and use in source and binary forms, with or without modification, are
  15. * permitted provided that the following conditions are met:
  16. *
  17. * * Redistributions of source code must retain the above copyright notice, this list of
  18. * conditions and the following disclaimer.
  19. *
  20. * * Redistributions in binary form must reproduce the above copyright notice, this list
  21. * of conditions and the following disclaimer in the documentation and/or other materials
  22. * provided with the distribution.
  23. *
  24. * * Neither the name of the SimplePie Team nor the names of its contributors may be used
  25. * to endorse or promote products derived from this software without specific prior
  26. * written permission.
  27. *
  28. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS
  29. * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
  30. * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS
  31. * AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  32. * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  33. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  34. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  35. * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  36. * POSSIBILITY OF SUCH DAMAGE.
  37. *
  38. * @package SimplePie
  39. * @copyright 2004-2016 Ryan Parman, Sam Sneddon, Ryan McCue
  40. * @author Ryan Parman
  41. * @author Sam Sneddon
  42. * @author Ryan McCue
  43. * @link http://simplepie.org/ SimplePie
  44. * @license http://www.opensource.org/licenses/bsd-license.php BSD License
  45. */
  46. /**
  47. * SimplePie Name
  48. */
  49. define('SIMPLEPIE_NAME', 'SimplePie');
  50. /**
  51. * SimplePie Version
  52. */
  53. define('SIMPLEPIE_VERSION', '1.5.4');
  54. /**
  55. * SimplePie Build
  56. * @todo Hardcode for release (there's no need to have to call SimplePie_Misc::get_build() only every load of simplepie.inc)
  57. */
  58. define('SIMPLEPIE_BUILD', '20200203211057');
  59. /**
  60. * SimplePie Website URL
  61. */
  62. define('SIMPLEPIE_URL', 'http://simplepie.org');
  63. /**
  64. * SimplePie Useragent
  65. * @see SimplePie::set_useragent()
  66. */
  67. define('SIMPLEPIE_USERAGENT', SIMPLEPIE_NAME . '/' . SIMPLEPIE_VERSION . ' (Feed Parser; ' . SIMPLEPIE_URL . '; Allow like Gecko) Build/' . SIMPLEPIE_BUILD);
  68. /**
  69. * SimplePie Linkback
  70. */
  71. define('SIMPLEPIE_LINKBACK', '<a href="' . SIMPLEPIE_URL . '" title="' . SIMPLEPIE_NAME . ' ' . SIMPLEPIE_VERSION . '">' . SIMPLEPIE_NAME . '</a>');
  72. /**
  73. * No Autodiscovery
  74. * @see SimplePie::set_autodiscovery_level()
  75. */
  76. define('SIMPLEPIE_LOCATOR_NONE', 0);
  77. /**
  78. * Feed Link Element Autodiscovery
  79. * @see SimplePie::set_autodiscovery_level()
  80. */
  81. define('SIMPLEPIE_LOCATOR_AUTODISCOVERY', 1);
  82. /**
  83. * Local Feed Extension Autodiscovery
  84. * @see SimplePie::set_autodiscovery_level()
  85. */
  86. define('SIMPLEPIE_LOCATOR_LOCAL_EXTENSION', 2);
  87. /**
  88. * Local Feed Body Autodiscovery
  89. * @see SimplePie::set_autodiscovery_level()
  90. */
  91. define('SIMPLEPIE_LOCATOR_LOCAL_BODY', 4);
  92. /**
  93. * Remote Feed Extension Autodiscovery
  94. * @see SimplePie::set_autodiscovery_level()
  95. */
  96. define('SIMPLEPIE_LOCATOR_REMOTE_EXTENSION', 8);
  97. /**
  98. * Remote Feed Body Autodiscovery
  99. * @see SimplePie::set_autodiscovery_level()
  100. */
  101. define('SIMPLEPIE_LOCATOR_REMOTE_BODY', 16);
  102. /**
  103. * All Feed Autodiscovery
  104. * @see SimplePie::set_autodiscovery_level()
  105. */
  106. define('SIMPLEPIE_LOCATOR_ALL', 31);
  107. /**
  108. * No known feed type
  109. */
  110. define('SIMPLEPIE_TYPE_NONE', 0);
  111. /**
  112. * RSS 0.90
  113. */
  114. define('SIMPLEPIE_TYPE_RSS_090', 1);
  115. /**
  116. * RSS 0.91 (Netscape)
  117. */
  118. define('SIMPLEPIE_TYPE_RSS_091_NETSCAPE', 2);
  119. /**
  120. * RSS 0.91 (Userland)
  121. */
  122. define('SIMPLEPIE_TYPE_RSS_091_USERLAND', 4);
  123. /**
  124. * RSS 0.91 (both Netscape and Userland)
  125. */
  126. define('SIMPLEPIE_TYPE_RSS_091', 6);
  127. /**
  128. * RSS 0.92
  129. */
  130. define('SIMPLEPIE_TYPE_RSS_092', 8);
  131. /**
  132. * RSS 0.93
  133. */
  134. define('SIMPLEPIE_TYPE_RSS_093', 16);
  135. /**
  136. * RSS 0.94
  137. */
  138. define('SIMPLEPIE_TYPE_RSS_094', 32);
  139. /**
  140. * RSS 1.0
  141. */
  142. define('SIMPLEPIE_TYPE_RSS_10', 64);
  143. /**
  144. * RSS 2.0
  145. */
  146. define('SIMPLEPIE_TYPE_RSS_20', 128);
  147. /**
  148. * RDF-based RSS
  149. */
  150. define('SIMPLEPIE_TYPE_RSS_RDF', 65);
  151. /**
  152. * Non-RDF-based RSS (truly intended as syndication format)
  153. */
  154. define('SIMPLEPIE_TYPE_RSS_SYNDICATION', 190);
  155. /**
  156. * All RSS
  157. */
  158. define('SIMPLEPIE_TYPE_RSS_ALL', 255);
  159. /**
  160. * Atom 0.3
  161. */
  162. define('SIMPLEPIE_TYPE_ATOM_03', 256);
  163. /**
  164. * Atom 1.0
  165. */
  166. define('SIMPLEPIE_TYPE_ATOM_10', 512);
  167. /**
  168. * All Atom
  169. */
  170. define('SIMPLEPIE_TYPE_ATOM_ALL', 768);
  171. /**
  172. * All feed types
  173. */
  174. define('SIMPLEPIE_TYPE_ALL', 1023);
  175. /**
  176. * No construct
  177. */
  178. define('SIMPLEPIE_CONSTRUCT_NONE', 0);
  179. /**
  180. * Text construct
  181. */
  182. define('SIMPLEPIE_CONSTRUCT_TEXT', 1);
  183. /**
  184. * HTML construct
  185. */
  186. define('SIMPLEPIE_CONSTRUCT_HTML', 2);
  187. /**
  188. * XHTML construct
  189. */
  190. define('SIMPLEPIE_CONSTRUCT_XHTML', 4);
  191. /**
  192. * base64-encoded construct
  193. */
  194. define('SIMPLEPIE_CONSTRUCT_BASE64', 8);
  195. /**
  196. * IRI construct
  197. */
  198. define('SIMPLEPIE_CONSTRUCT_IRI', 16);
  199. /**
  200. * A construct that might be HTML
  201. */
  202. define('SIMPLEPIE_CONSTRUCT_MAYBE_HTML', 32);
  203. /**
  204. * All constructs
  205. */
  206. define('SIMPLEPIE_CONSTRUCT_ALL', 63);
  207. /**
  208. * Don't change case
  209. */
  210. define('SIMPLEPIE_SAME_CASE', 1);
  211. /**
  212. * Change to lowercase
  213. */
  214. define('SIMPLEPIE_LOWERCASE', 2);
  215. /**
  216. * Change to uppercase
  217. */
  218. define('SIMPLEPIE_UPPERCASE', 4);
  219. /**
  220. * PCRE for HTML attributes
  221. */
  222. define('SIMPLEPIE_PCRE_HTML_ATTRIBUTE', '((?:[\x09\x0A\x0B\x0C\x0D\x20]+[^\x09\x0A\x0B\x0C\x0D\x20\x2F\x3E][^\x09\x0A\x0B\x0C\x0D\x20\x2F\x3D\x3E]*(?:[\x09\x0A\x0B\x0C\x0D\x20]*=[\x09\x0A\x0B\x0C\x0D\x20]*(?:"(?:[^"]*)"|\'(?:[^\']*)\'|(?:[^\x09\x0A\x0B\x0C\x0D\x20\x22\x27\x3E][^\x09\x0A\x0B\x0C\x0D\x20\x3E]*)?))?)*)[\x09\x0A\x0B\x0C\x0D\x20]*');
  223. /**
  224. * PCRE for XML attributes
  225. */
  226. define('SIMPLEPIE_PCRE_XML_ATTRIBUTE', '((?:\s+(?:(?:[^\s:]+:)?[^\s:]+)\s*=\s*(?:"(?:[^"]*)"|\'(?:[^\']*)\'))*)\s*');
  227. /**
  228. * XML Namespace
  229. */
  230. define('SIMPLEPIE_NAMESPACE_XML', 'http://www.w3.org/XML/1998/namespace');
  231. /**
  232. * Atom 1.0 Namespace
  233. */
  234. define('SIMPLEPIE_NAMESPACE_ATOM_10', 'http://www.w3.org/2005/Atom');
  235. /**
  236. * Atom 0.3 Namespace
  237. */
  238. define('SIMPLEPIE_NAMESPACE_ATOM_03', 'http://purl.org/atom/ns#');
  239. /**
  240. * RDF Namespace
  241. */
  242. define('SIMPLEPIE_NAMESPACE_RDF', 'http://www.w3.org/1999/02/22-rdf-syntax-ns#');
  243. /**
  244. * RSS 0.90 Namespace
  245. */
  246. define('SIMPLEPIE_NAMESPACE_RSS_090', 'http://my.netscape.com/rdf/simple/0.9/');
  247. /**
  248. * RSS 1.0 Namespace
  249. */
  250. define('SIMPLEPIE_NAMESPACE_RSS_10', 'http://purl.org/rss/1.0/');
  251. /**
  252. * RSS 1.0 Content Module Namespace
  253. */
  254. define('SIMPLEPIE_NAMESPACE_RSS_10_MODULES_CONTENT', 'http://purl.org/rss/1.0/modules/content/');
  255. /**
  256. * RSS 2.0 Namespace
  257. * (Stupid, I know, but I'm certain it will confuse people less with support.)
  258. */
  259. define('SIMPLEPIE_NAMESPACE_RSS_20', '');
  260. /**
  261. * DC 1.0 Namespace
  262. */
  263. define('SIMPLEPIE_NAMESPACE_DC_10', 'http://purl.org/dc/elements/1.0/');
  264. /**
  265. * DC 1.1 Namespace
  266. */
  267. define('SIMPLEPIE_NAMESPACE_DC_11', 'http://purl.org/dc/elements/1.1/');
  268. /**
  269. * W3C Basic Geo (WGS84 lat/long) Vocabulary Namespace
  270. */
  271. define('SIMPLEPIE_NAMESPACE_W3C_BASIC_GEO', 'http://www.w3.org/2003/01/geo/wgs84_pos#');
  272. /**
  273. * GeoRSS Namespace
  274. */
  275. define('SIMPLEPIE_NAMESPACE_GEORSS', 'http://www.georss.org/georss');
  276. /**
  277. * Media RSS Namespace
  278. */
  279. define('SIMPLEPIE_NAMESPACE_MEDIARSS', 'http://search.yahoo.com/mrss/');
  280. /**
  281. * Wrong Media RSS Namespace. Caused by a long-standing typo in the spec.
  282. */
  283. define('SIMPLEPIE_NAMESPACE_MEDIARSS_WRONG', 'http://search.yahoo.com/mrss');
  284. /**
  285. * Wrong Media RSS Namespace #2. New namespace introduced in Media RSS 1.5.
  286. */
  287. define('SIMPLEPIE_NAMESPACE_MEDIARSS_WRONG2', 'http://video.search.yahoo.com/mrss');
  288. /**
  289. * Wrong Media RSS Namespace #3. A possible typo of the Media RSS 1.5 namespace.
  290. */
  291. define('SIMPLEPIE_NAMESPACE_MEDIARSS_WRONG3', 'http://video.search.yahoo.com/mrss/');
  292. /**
  293. * Wrong Media RSS Namespace #4. New spec location after the RSS Advisory Board takes it over, but not a valid namespace.
  294. */
  295. define('SIMPLEPIE_NAMESPACE_MEDIARSS_WRONG4', 'http://www.rssboard.org/media-rss');
  296. /**
  297. * Wrong Media RSS Namespace #5. A possible typo of the RSS Advisory Board URL.
  298. */
  299. define('SIMPLEPIE_NAMESPACE_MEDIARSS_WRONG5', 'http://www.rssboard.org/media-rss/');
  300. /**
  301. * iTunes RSS Namespace
  302. */
  303. define('SIMPLEPIE_NAMESPACE_ITUNES', 'http://www.itunes.com/dtds/podcast-1.0.dtd');
  304. /**
  305. * XHTML Namespace
  306. */
  307. define('SIMPLEPIE_NAMESPACE_XHTML', 'http://www.w3.org/1999/xhtml');
  308. /**
  309. * IANA Link Relations Registry
  310. */
  311. define('SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY', 'http://www.iana.org/assignments/relation/');
  312. /**
  313. * No file source
  314. */
  315. define('SIMPLEPIE_FILE_SOURCE_NONE', 0);
  316. /**
  317. * Remote file source
  318. */
  319. define('SIMPLEPIE_FILE_SOURCE_REMOTE', 1);
  320. /**
  321. * Local file source
  322. */
  323. define('SIMPLEPIE_FILE_SOURCE_LOCAL', 2);
  324. /**
  325. * fsockopen() file source
  326. */
  327. define('SIMPLEPIE_FILE_SOURCE_FSOCKOPEN', 4);
  328. /**
  329. * cURL file source
  330. */
  331. define('SIMPLEPIE_FILE_SOURCE_CURL', 8);
  332. /**
  333. * file_get_contents() file source
  334. */
  335. define('SIMPLEPIE_FILE_SOURCE_FILE_GET_CONTENTS', 16);
  336. /**
  337. * SimplePie
  338. *
  339. * @package SimplePie
  340. * @subpackage API
  341. */
  342. class SimplePie
  343. {
  344. /**
  345. * @var array Raw data
  346. * @access private
  347. */
  348. public $data = array();
  349. /**
  350. * @var mixed Error string
  351. * @access private
  352. */
  353. public $error;
  354. /**
  355. * @var object Instance of SimplePie_Sanitize (or other class)
  356. * @see SimplePie::set_sanitize_class()
  357. * @access private
  358. */
  359. public $sanitize;
  360. /**
  361. * @var string SimplePie Useragent
  362. * @see SimplePie::set_useragent()
  363. * @access private
  364. */
  365. public $useragent = SIMPLEPIE_USERAGENT;
  366. /**
  367. * @var string Feed URL
  368. * @see SimplePie::set_feed_url()
  369. * @access private
  370. */
  371. public $feed_url;
  372. /**
  373. * @var string Original feed URL, or new feed URL iff HTTP 301 Moved Permanently
  374. * @see SimplePie::subscribe_url()
  375. * @access private
  376. */
  377. public $permanent_url = null;
  378. /**
  379. * @var object Instance of SimplePie_File to use as a feed
  380. * @see SimplePie::set_file()
  381. * @access private
  382. */
  383. public $file;
  384. /**
  385. * @var string Raw feed data
  386. * @see SimplePie::set_raw_data()
  387. * @access private
  388. */
  389. public $raw_data;
  390. /**
  391. * @var int Timeout for fetching remote files
  392. * @see SimplePie::set_timeout()
  393. * @access private
  394. */
  395. public $timeout = 10;
  396. /**
  397. * @var array Custom curl options
  398. * @see SimplePie::set_curl_options()
  399. * @access private
  400. */
  401. public $curl_options = array();
  402. /**
  403. * @var bool Forces fsockopen() to be used for remote files instead
  404. * of cURL, even if a new enough version is installed
  405. * @see SimplePie::force_fsockopen()
  406. * @access private
  407. */
  408. public $force_fsockopen = false;
  409. /**
  410. * @var bool Force the given data/URL to be treated as a feed no matter what
  411. * it appears like
  412. * @see SimplePie::force_feed()
  413. * @access private
  414. */
  415. public $force_feed = false;
  416. /**
  417. * @var bool Enable/Disable Caching
  418. * @see SimplePie::enable_cache()
  419. * @access private
  420. */
  421. public $cache = true;
  422. /**
  423. * @var bool Force SimplePie to fallback to expired cache, if enabled,
  424. * when feed is unavailable.
  425. * @see SimplePie::force_cache_fallback()
  426. * @access private
  427. */
  428. public $force_cache_fallback = false;
  429. /**
  430. * @var int Cache duration (in seconds)
  431. * @see SimplePie::set_cache_duration()
  432. * @access private
  433. */
  434. public $cache_duration = 3600;
  435. /**
  436. * @var int Auto-discovery cache duration (in seconds)
  437. * @see SimplePie::set_autodiscovery_cache_duration()
  438. * @access private
  439. */
  440. public $autodiscovery_cache_duration = 604800; // 7 Days.
  441. /**
  442. * @var string Cache location (relative to executing script)
  443. * @see SimplePie::set_cache_location()
  444. * @access private
  445. */
  446. public $cache_location = './cache';
  447. /**
  448. * @var string Function that creates the cache filename
  449. * @see SimplePie::set_cache_name_function()
  450. * @access private
  451. */
  452. public $cache_name_function = 'md5';
  453. /**
  454. * @var bool Reorder feed by date descending
  455. * @see SimplePie::enable_order_by_date()
  456. * @access private
  457. */
  458. public $order_by_date = true;
  459. /**
  460. * @var mixed Force input encoding to be set to the follow value
  461. * (false, or anything type-cast to false, disables this feature)
  462. * @see SimplePie::set_input_encoding()
  463. * @access private
  464. */
  465. public $input_encoding = false;
  466. /**
  467. * @var int Feed Autodiscovery Level
  468. * @see SimplePie::set_autodiscovery_level()
  469. * @access private
  470. */
  471. public $autodiscovery = SIMPLEPIE_LOCATOR_ALL;
  472. /**
  473. * Class registry object
  474. *
  475. * @var SimplePie_Registry
  476. */
  477. public $registry;
  478. /**
  479. * @var int Maximum number of feeds to check with autodiscovery
  480. * @see SimplePie::set_max_checked_feeds()
  481. * @access private
  482. */
  483. public $max_checked_feeds = 10;
  484. /**
  485. * @var array All the feeds found during the autodiscovery process
  486. * @see SimplePie::get_all_discovered_feeds()
  487. * @access private
  488. */
  489. public $all_discovered_feeds = array();
  490. /**
  491. * @var string Web-accessible path to the handler_image.php file.
  492. * @see SimplePie::set_image_handler()
  493. * @access private
  494. */
  495. public $image_handler = '';
  496. /**
  497. * @var array Stores the URLs when multiple feeds are being initialized.
  498. * @see SimplePie::set_feed_url()
  499. * @access private
  500. */
  501. public $multifeed_url = array();
  502. /**
  503. * @var array Stores SimplePie objects when multiple feeds initialized.
  504. * @access private
  505. */
  506. public $multifeed_objects = array();
  507. /**
  508. * @var array Stores the get_object_vars() array for use with multifeeds.
  509. * @see SimplePie::set_feed_url()
  510. * @access private
  511. */
  512. public $config_settings = null;
  513. /**
  514. * @var integer Stores the number of items to return per-feed with multifeeds.
  515. * @see SimplePie::set_item_limit()
  516. * @access private
  517. */
  518. public $item_limit = 0;
  519. /**
  520. * @var bool Stores if last-modified and/or etag headers were sent with the
  521. * request when checking a feed.
  522. */
  523. public $check_modified = false;
  524. /**
  525. * @var array Stores the default attributes to be stripped by strip_attributes().
  526. * @see SimplePie::strip_attributes()
  527. * @access private
  528. */
  529. public $strip_attributes = array('bgsound', 'class', 'expr', 'id', 'style', 'onclick', 'onerror', 'onfinish', 'onmouseover', 'onmouseout', 'onfocus', 'onblur', 'lowsrc', 'dynsrc');
  530. /**
  531. * @var array Stores the default attributes to add to different tags by add_attributes().
  532. * @see SimplePie::add_attributes()
  533. * @access private
  534. */
  535. public $add_attributes = array('audio' => array('preload' => 'none'), 'iframe' => array('sandbox' => 'allow-scripts allow-same-origin'), 'video' => array('preload' => 'none'));
  536. /**
  537. * @var array Stores the default tags to be stripped by strip_htmltags().
  538. * @see SimplePie::strip_htmltags()
  539. * @access private
  540. */
  541. public $strip_htmltags = array('base', 'blink', 'body', 'doctype', 'embed', 'font', 'form', 'frame', 'frameset', 'html', 'iframe', 'input', 'marquee', 'meta', 'noscript', 'object', 'param', 'script', 'style');
  542. /**
  543. * @var bool Should we throw exceptions, or use the old-style error property?
  544. * @access private
  545. */
  546. public $enable_exceptions = false;
  547. /**
  548. * The SimplePie class contains feed level data and options
  549. *
  550. * To use SimplePie, create the SimplePie object with no parameters. You can
  551. * then set configuration options using the provided methods. After setting
  552. * them, you must initialise the feed using $feed->init(). At that point the
  553. * object's methods and properties will be available to you.
  554. *
  555. * Previously, it was possible to pass in the feed URL along with cache
  556. * options directly into the constructor. This has been removed as of 1.3 as
  557. * it caused a lot of confusion.
  558. *
  559. * @since 1.0 Preview Release
  560. */
  561. public function __construct()
  562. {
  563. if (version_compare(PHP_VERSION, '5.6', '<'))
  564. {
  565. trigger_error('Please upgrade to PHP 5.6 or newer.');
  566. die();
  567. }
  568. // Other objects, instances created here so we can set options on them
  569. $this->sanitize = new SimplePie_Sanitize();
  570. $this->registry = new SimplePie_Registry();
  571. if (func_num_args() > 0)
  572. {
  573. $level = defined('E_USER_DEPRECATED') ? E_USER_DEPRECATED : E_USER_WARNING;
  574. trigger_error('Passing parameters to the constructor is no longer supported. Please use set_feed_url(), set_cache_location(), and set_cache_duration() directly.', $level);
  575. $args = func_get_args();
  576. switch (count($args)) {
  577. case 3:
  578. $this->set_cache_duration($args[2]);
  579. case 2:
  580. $this->set_cache_location($args[1]);
  581. case 1:
  582. $this->set_feed_url($args[0]);
  583. $this->init();
  584. }
  585. }
  586. }
  587. /**
  588. * Used for converting object to a string
  589. */
  590. public function __toString()
  591. {
  592. return md5(serialize($this->data));
  593. }
  594. /**
  595. * Remove items that link back to this before destroying this object
  596. */
  597. public function __destruct()
  598. {
  599. if ((version_compare(PHP_VERSION, '5.6', '<') || !gc_enabled()) && !ini_get('zend.ze1_compatibility_mode'))
  600. {
  601. if (!empty($this->data['items']))
  602. {
  603. foreach ($this->data['items'] as $item)
  604. {
  605. $item->__destruct();
  606. }
  607. unset($item, $this->data['items']);
  608. }
  609. if (!empty($this->data['ordered_items']))
  610. {
  611. foreach ($this->data['ordered_items'] as $item)
  612. {
  613. $item->__destruct();
  614. }
  615. unset($item, $this->data['ordered_items']);
  616. }
  617. }
  618. }
  619. /**
  620. * Force the given data/URL to be treated as a feed
  621. *
  622. * This tells SimplePie to ignore the content-type provided by the server.
  623. * Be careful when using this option, as it will also disable autodiscovery.
  624. *
  625. * @since 1.1
  626. * @param bool $enable Force the given data/URL to be treated as a feed
  627. */
  628. public function force_feed($enable = false)
  629. {
  630. $this->force_feed = (bool) $enable;
  631. }
  632. /**
  633. * Set the URL of the feed you want to parse
  634. *
  635. * This allows you to enter the URL of the feed you want to parse, or the
  636. * website you want to try to use auto-discovery on. This takes priority
  637. * over any set raw data.
  638. *
  639. * You can set multiple feeds to mash together by passing an array instead
  640. * of a string for the $url. Remember that with each additional feed comes
  641. * additional processing and resources.
  642. *
  643. * @since 1.0 Preview Release
  644. * @see set_raw_data()
  645. * @param string|array $url This is the URL (or array of URLs) that you want to parse.
  646. */
  647. public function set_feed_url($url)
  648. {
  649. $this->multifeed_url = array();
  650. if (is_array($url))
  651. {
  652. foreach ($url as $value)
  653. {
  654. $this->multifeed_url[] = $this->registry->call('Misc', 'fix_protocol', array($value, 1));
  655. }
  656. }
  657. else
  658. {
  659. $this->feed_url = $this->registry->call('Misc', 'fix_protocol', array($url, 1));
  660. $this->permanent_url = $this->feed_url;
  661. }
  662. }
  663. /**
  664. * Set an instance of {@see SimplePie_File} to use as a feed
  665. *
  666. * @param SimplePie_File &$file
  667. * @return bool True on success, false on failure
  668. */
  669. public function set_file(&$file)
  670. {
  671. if ($file instanceof SimplePie_File)
  672. {
  673. $this->feed_url = $file->url;
  674. $this->permanent_url = $this->feed_url;
  675. $this->file =& $file;
  676. return true;
  677. }
  678. return false;
  679. }
  680. /**
  681. * Set the raw XML data to parse
  682. *
  683. * Allows you to use a string of RSS/Atom data instead of a remote feed.
  684. *
  685. * If you have a feed available as a string in PHP, you can tell SimplePie
  686. * to parse that data string instead of a remote feed. Any set feed URL
  687. * takes precedence.
  688. *
  689. * @since 1.0 Beta 3
  690. * @param string $data RSS or Atom data as a string.
  691. * @see set_feed_url()
  692. */
  693. public function set_raw_data($data)
  694. {
  695. $this->raw_data = $data;
  696. }
  697. /**
  698. * Set the default timeout for fetching remote feeds
  699. *
  700. * This allows you to change the maximum time the feed's server to respond
  701. * and send the feed back.
  702. *
  703. * @since 1.0 Beta 3
  704. * @param int $timeout The maximum number of seconds to spend waiting to retrieve a feed.
  705. */
  706. public function set_timeout($timeout = 10)
  707. {
  708. $this->timeout = (int) $timeout;
  709. }
  710. /**
  711. * Set custom curl options
  712. *
  713. * This allows you to change default curl options
  714. *
  715. * @since 1.0 Beta 3
  716. * @param array $curl_options Curl options to add to default settings
  717. */
  718. public function set_curl_options(array $curl_options = array())
  719. {
  720. $this->curl_options = $curl_options;
  721. }
  722. /**
  723. * Force SimplePie to use fsockopen() instead of cURL
  724. *
  725. * @since 1.0 Beta 3
  726. * @param bool $enable Force fsockopen() to be used
  727. */
  728. public function force_fsockopen($enable = false)
  729. {
  730. $this->force_fsockopen = (bool) $enable;
  731. }
  732. /**
  733. * Enable/disable caching in SimplePie.
  734. *
  735. * This option allows you to disable caching all-together in SimplePie.
  736. * However, disabling the cache can lead to longer load times.
  737. *
  738. * @since 1.0 Preview Release
  739. * @param bool $enable Enable caching
  740. */
  741. public function enable_cache($enable = true)
  742. {
  743. $this->cache = (bool) $enable;
  744. }
  745. /**
  746. * SimplePie to continue to fall back to expired cache, if enabled, when
  747. * feed is unavailable.
  748. *
  749. * This tells SimplePie to ignore any file errors and fall back to cache
  750. * instead. This only works if caching is enabled and cached content
  751. * still exists.
  752. * @param bool $enable Force use of cache on fail.
  753. */
  754. public function force_cache_fallback($enable = false)
  755. {
  756. $this->force_cache_fallback= (bool) $enable;
  757. }
  758. /**
  759. * Set the length of time (in seconds) that the contents of a feed will be
  760. * cached
  761. *
  762. * @param int $seconds The feed content cache duration
  763. */
  764. public function set_cache_duration($seconds = 3600)
  765. {
  766. $this->cache_duration = (int) $seconds;
  767. }
  768. /**
  769. * Set the length of time (in seconds) that the autodiscovered feed URL will
  770. * be cached
  771. *
  772. * @param int $seconds The autodiscovered feed URL cache duration.
  773. */
  774. public function set_autodiscovery_cache_duration($seconds = 604800)
  775. {
  776. $this->autodiscovery_cache_duration = (int) $seconds;
  777. }
  778. /**
  779. * Set the file system location where the cached files should be stored
  780. *
  781. * @param string $location The file system location.
  782. */
  783. public function set_cache_location($location = './cache')
  784. {
  785. $this->cache_location = (string) $location;
  786. }
  787. /**
  788. * Set whether feed items should be sorted into reverse chronological order
  789. *
  790. * @param bool $enable Sort as reverse chronological order.
  791. */
  792. public function enable_order_by_date($enable = true)
  793. {
  794. $this->order_by_date = (bool) $enable;
  795. }
  796. /**
  797. * Set the character encoding used to parse the feed
  798. *
  799. * This overrides the encoding reported by the feed, however it will fall
  800. * back to the normal encoding detection if the override fails
  801. *
  802. * @param string $encoding Character encoding
  803. */
  804. public function set_input_encoding($encoding = false)
  805. {
  806. if ($encoding)
  807. {
  808. $this->input_encoding = (string) $encoding;
  809. }
  810. else
  811. {
  812. $this->input_encoding = false;
  813. }
  814. }
  815. /**
  816. * Set how much feed autodiscovery to do
  817. *
  818. * @see SIMPLEPIE_LOCATOR_NONE
  819. * @see SIMPLEPIE_LOCATOR_AUTODISCOVERY
  820. * @see SIMPLEPIE_LOCATOR_LOCAL_EXTENSION
  821. * @see SIMPLEPIE_LOCATOR_LOCAL_BODY
  822. * @see SIMPLEPIE_LOCATOR_REMOTE_EXTENSION
  823. * @see SIMPLEPIE_LOCATOR_REMOTE_BODY
  824. * @see SIMPLEPIE_LOCATOR_ALL
  825. * @param int $level Feed Autodiscovery Level (level can be a combination of the above constants, see bitwise OR operator)
  826. */
  827. public function set_autodiscovery_level($level = SIMPLEPIE_LOCATOR_ALL)
  828. {
  829. $this->autodiscovery = (int) $level;
  830. }
  831. /**
  832. * Get the class registry
  833. *
  834. * Use this to override SimplePie's default classes
  835. * @see SimplePie_Registry
  836. * @return SimplePie_Registry
  837. */
  838. public function &get_registry()
  839. {
  840. return $this->registry;
  841. }
  842. /**#@+
  843. * Useful when you are overloading or extending SimplePie's default classes.
  844. *
  845. * @deprecated Use {@see get_registry()} instead
  846. * @link http://php.net/manual/en/language.oop5.basic.php#language.oop5.basic.extends PHP5 extends documentation
  847. * @param string $class Name of custom class
  848. * @return boolean True on success, false otherwise
  849. */
  850. /**
  851. * Set which class SimplePie uses for caching
  852. */
  853. public function set_cache_class($class = 'SimplePie_Cache')
  854. {
  855. return $this->registry->register('Cache', $class, true);
  856. }
  857. /**
  858. * Set which class SimplePie uses for auto-discovery
  859. */
  860. public function set_locator_class($class = 'SimplePie_Locator')
  861. {
  862. return $this->registry->register('Locator', $class, true);
  863. }
  864. /**
  865. * Set which class SimplePie uses for XML parsing
  866. */
  867. public function set_parser_class($class = 'SimplePie_Parser')
  868. {
  869. return $this->registry->register('Parser', $class, true);
  870. }
  871. /**
  872. * Set which class SimplePie uses for remote file fetching
  873. */
  874. public function set_file_class($class = 'SimplePie_File')
  875. {
  876. return $this->registry->register('File', $class, true);
  877. }
  878. /**
  879. * Set which class SimplePie uses for data sanitization
  880. */
  881. public function set_sanitize_class($class = 'SimplePie_Sanitize')
  882. {
  883. return $this->registry->register('Sanitize', $class, true);
  884. }
  885. /**
  886. * Set which class SimplePie uses for handling feed items
  887. */
  888. public function set_item_class($class = 'SimplePie_Item')
  889. {
  890. return $this->registry->register('Item', $class, true);
  891. }
  892. /**
  893. * Set which class SimplePie uses for handling author data
  894. */
  895. public function set_author_class($class = 'SimplePie_Author')
  896. {
  897. return $this->registry->register('Author', $class, true);
  898. }
  899. /**
  900. * Set which class SimplePie uses for handling category data
  901. */
  902. public function set_category_class($class = 'SimplePie_Category')
  903. {
  904. return $this->registry->register('Category', $class, true);
  905. }
  906. /**
  907. * Set which class SimplePie uses for feed enclosures
  908. */
  909. public function set_enclosure_class($class = 'SimplePie_Enclosure')
  910. {
  911. return $this->registry->register('Enclosure', $class, true);
  912. }
  913. /**
  914. * Set which class SimplePie uses for `<media:text>` captions
  915. */
  916. public function set_caption_class($class = 'SimplePie_Caption')
  917. {
  918. return $this->registry->register('Caption', $class, true);
  919. }
  920. /**
  921. * Set which class SimplePie uses for `<media:copyright>`
  922. */
  923. public function set_copyright_class($class = 'SimplePie_Copyright')
  924. {
  925. return $this->registry->register('Copyright', $class, true);
  926. }
  927. /**
  928. * Set which class SimplePie uses for `<media:credit>`
  929. */
  930. public function set_credit_class($class = 'SimplePie_Credit')
  931. {
  932. return $this->registry->register('Credit', $class, true);
  933. }
  934. /**
  935. * Set which class SimplePie uses for `<media:rating>`
  936. */
  937. public function set_rating_class($class = 'SimplePie_Rating')
  938. {
  939. return $this->registry->register('Rating', $class, true);
  940. }
  941. /**
  942. * Set which class SimplePie uses for `<media:restriction>`
  943. */
  944. public function set_restriction_class($class = 'SimplePie_Restriction')
  945. {
  946. return $this->registry->register('Restriction', $class, true);
  947. }
  948. /**
  949. * Set which class SimplePie uses for content-type sniffing
  950. */
  951. public function set_content_type_sniffer_class($class = 'SimplePie_Content_Type_Sniffer')
  952. {
  953. return $this->registry->register('Content_Type_Sniffer', $class, true);
  954. }
  955. /**
  956. * Set which class SimplePie uses item sources
  957. */
  958. public function set_source_class($class = 'SimplePie_Source')
  959. {
  960. return $this->registry->register('Source', $class, true);
  961. }
  962. /**#@-*/
  963. /**
  964. * Set the user agent string
  965. *
  966. * @param string $ua New user agent string.
  967. */
  968. public function set_useragent($ua = SIMPLEPIE_USERAGENT)
  969. {
  970. $this->useragent = (string) $ua;
  971. }
  972. /**
  973. * Set callback function to create cache filename with
  974. *
  975. * @param mixed $function Callback function
  976. */
  977. public function set_cache_name_function($function = 'md5')
  978. {
  979. if (is_callable($function))
  980. {
  981. $this->cache_name_function = $function;
  982. }
  983. }
  984. /**
  985. * Set options to make SP as fast as possible
  986. *
  987. * Forgoes a substantial amount of data sanitization in favor of speed. This
  988. * turns SimplePie into a dumb parser of feeds.
  989. *
  990. * @param bool $set Whether to set them or not
  991. */
  992. public function set_stupidly_fast($set = false)
  993. {
  994. if ($set)
  995. {
  996. $this->enable_order_by_date(false);
  997. $this->remove_div(false);
  998. $this->strip_comments(false);
  999. $this->strip_htmltags(false);
  1000. $this->strip_attributes(false);
  1001. $this->add_attributes(false);
  1002. $this->set_image_handler(false);
  1003. }
  1004. }
  1005. /**
  1006. * Set maximum number of feeds to check with autodiscovery
  1007. *
  1008. * @param int $max Maximum number of feeds to check
  1009. */
  1010. public function set_max_checked_feeds($max = 10)
  1011. {
  1012. $this->max_checked_feeds = (int) $max;
  1013. }
  1014. public function remove_div($enable = true)
  1015. {
  1016. $this->sanitize->remove_div($enable);
  1017. }
  1018. public function strip_htmltags($tags = '', $encode = null)
  1019. {
  1020. if ($tags === '')
  1021. {
  1022. $tags = $this->strip_htmltags;
  1023. }
  1024. $this->sanitize->strip_htmltags($tags);
  1025. if ($encode !== null)
  1026. {
  1027. $this->sanitize->encode_instead_of_strip($tags);
  1028. }
  1029. }
  1030. public function encode_instead_of_strip($enable = true)
  1031. {
  1032. $this->sanitize->encode_instead_of_strip($enable);
  1033. }
  1034. public function strip_attributes($attribs = '')
  1035. {
  1036. if ($attribs === '')
  1037. {
  1038. $attribs = $this->strip_attributes;
  1039. }
  1040. $this->sanitize->strip_attributes($attribs);
  1041. }
  1042. public function add_attributes($attribs = '')
  1043. {
  1044. if ($attribs === '')
  1045. {
  1046. $attribs = $this->add_attributes;
  1047. }
  1048. $this->sanitize->add_attributes($attribs);
  1049. }
  1050. /**
  1051. * Set the output encoding
  1052. *
  1053. * Allows you to override SimplePie's output to match that of your webpage.
  1054. * This is useful for times when your webpages are not being served as
  1055. * UTF-8. This setting will be obeyed by {@see handle_content_type()}, and
  1056. * is similar to {@see set_input_encoding()}.
  1057. *
  1058. * It should be noted, however, that not all character encodings can support
  1059. * all characters. If your page is being served as ISO-8859-1 and you try
  1060. * to display a Japanese feed, you'll likely see garbled characters.
  1061. * Because of this, it is highly recommended to ensure that your webpages
  1062. * are served as UTF-8.
  1063. *
  1064. * The number of supported character encodings depends on whether your web
  1065. * host supports {@link http://php.net/mbstring mbstring},
  1066. * {@link http://php.net/iconv iconv}, or both. See
  1067. * {@link http://simplepie.org/wiki/faq/Supported_Character_Encodings} for
  1068. * more information.
  1069. *
  1070. * @param string $encoding
  1071. */
  1072. public function set_output_encoding($encoding = 'UTF-8')
  1073. {
  1074. $this->sanitize->set_output_encoding($encoding);
  1075. }
  1076. public function strip_comments($strip = false)
  1077. {
  1078. $this->sanitize->strip_comments($strip);
  1079. }
  1080. /**
  1081. * Set element/attribute key/value pairs of HTML attributes
  1082. * containing URLs that need to be resolved relative to the feed
  1083. *
  1084. * Defaults to |a|@href, |area|@href, |blockquote|@cite, |del|@cite,
  1085. * |form|@action, |img|@longdesc, |img|@src, |input|@src, |ins|@cite,
  1086. * |q|@cite
  1087. *
  1088. * @since 1.0
  1089. * @param array|null $element_attribute Element/attribute key/value pairs, null for default
  1090. */
  1091. public function set_url_replacements($element_attribute = null)
  1092. {
  1093. $this->sanitize->set_url_replacements($element_attribute);
  1094. }
  1095. /**
  1096. * Set the handler to enable the display of cached images.
  1097. *
  1098. * @param string $page Web-accessible path to the handler_image.php file.
  1099. * @param string $qs The query string that the value should be passed to.
  1100. */
  1101. public function set_image_handler($page = false, $qs = 'i')
  1102. {
  1103. if ($page !== false)
  1104. {
  1105. $this->sanitize->set_image_handler($page . '?' . $qs . '=');
  1106. }
  1107. else
  1108. {
  1109. $this->image_handler = '';
  1110. }
  1111. }
  1112. /**
  1113. * Set the limit for items returned per-feed with multifeeds
  1114. *
  1115. * @param integer $limit The maximum number of items to return.
  1116. */
  1117. public function set_item_limit($limit = 0)
  1118. {
  1119. $this->item_limit = (int) $limit;
  1120. }
  1121. /**
  1122. * Enable throwing exceptions
  1123. *
  1124. * @param boolean $enable Should we throw exceptions, or use the old-style error property?
  1125. */
  1126. public function enable_exceptions($enable = true)
  1127. {
  1128. $this->enable_exceptions = $enable;
  1129. }
  1130. /**
  1131. * Initialize the feed object
  1132. *
  1133. * This is what makes everything happen. Period. This is where all of the
  1134. * configuration options get processed, feeds are fetched, cached, and
  1135. * parsed, and all of that other good stuff.
  1136. *
  1137. * @return boolean True if successful, false otherwise
  1138. */
  1139. public function init()
  1140. {
  1141. // Check absolute bare minimum requirements.
  1142. if (!extension_loaded('xml') || !extension_loaded('pcre'))
  1143. {
  1144. $this->error = 'XML or PCRE extensions not loaded!';
  1145. return false;
  1146. }
  1147. // Then check the xml extension is sane (i.e., libxml 2.7.x issue on PHP < 5.2.9 and libxml 2.7.0 to 2.7.2 on any version) if we don't have xmlreader.
  1148. elseif (!extension_loaded('xmlreader'))
  1149. {
  1150. static $xml_is_sane = null;
  1151. if ($xml_is_sane === null)
  1152. {
  1153. $parser_check = xml_parser_create();
  1154. xml_parse_into_struct($parser_check, '<foo>&amp;</foo>', $values);
  1155. xml_parser_free($parser_check);
  1156. $xml_is_sane = isset($values[0]['value']);
  1157. }
  1158. if (!$xml_is_sane)
  1159. {
  1160. return false;
  1161. }
  1162. }
  1163. // The default sanitize class gets set in the constructor, check if it has
  1164. // changed.
  1165. if ($this->registry->get_class('Sanitize') !== 'SimplePie_Sanitize') {
  1166. $this->sanitize = $this->registry->create('Sanitize');
  1167. }
  1168. if (method_exists($this->sanitize, 'set_registry'))
  1169. {
  1170. $this->sanitize->set_registry($this->registry);
  1171. }
  1172. // Pass whatever was set with config options over to the sanitizer.
  1173. // Pass the classes in for legacy support; new classes should use the registry instead
  1174. $this->sanitize->pass_cache_data($this->cache, $this->cache_location, $this->cache_name_function, $this->registry->get_class('Cache'));
  1175. $this->sanitize->pass_file_data($this->registry->get_class('File'), $this->timeout, $this->useragent, $this->force_fsockopen, $this->curl_options);
  1176. if (!empty($this->multifeed_url))
  1177. {
  1178. $i = 0;
  1179. $success = 0;
  1180. $this->multifeed_objects = array();
  1181. $this->error = array();
  1182. foreach ($this->multifeed_url as $url)
  1183. {
  1184. $this->multifeed_objects[$i] = clone $this;
  1185. $this->multifeed_objects[$i]->set_feed_url($url);
  1186. $single_success = $this->multifeed_objects[$i]->init();
  1187. $success |= $single_success;
  1188. if (!$single_success)
  1189. {
  1190. $this->error[$i] = $this->multifeed_objects[$i]->error();
  1191. }
  1192. $i++;
  1193. }
  1194. return (bool) $success;
  1195. }
  1196. elseif ($this->feed_url === null && $this->raw_data === null)
  1197. {
  1198. return false;
  1199. }
  1200. $this->error = null;
  1201. $this->data = array();
  1202. $this->check_modified = false;
  1203. $this->multifeed_objects = array();
  1204. $cache = false;
  1205. if ($this->feed_url !== null)
  1206. {
  1207. $parsed_feed_url = $this->registry->call('Misc', 'parse_url', array($this->feed_url));
  1208. // Decide whether to enable caching
  1209. if ($this->cache && $parsed_feed_url['scheme'] !== '')
  1210. {
  1211. $cache = $this->registry->call('Cache', 'get_handler', array($this->cache_location, call_user_func($this->cache_name_function, $this->feed_url), 'spc'));
  1212. }
  1213. // Fetch the data via SimplePie_File into $this->raw_data
  1214. if (($fetched = $this->fetch_data($cache)) === true)
  1215. {
  1216. return true;
  1217. }
  1218. elseif ($fetched === false) {
  1219. return false;
  1220. }
  1221. list($headers, $sniffed) = $fetched;
  1222. }
  1223. // Empty response check
  1224. if(empty($this->raw_data)){
  1225. $this->error = "A feed could not be found at `$this->feed_url`. Empty body.";
  1226. $this->registry->call('Misc', 'error', array($this->error, E_USER_NOTICE, __FILE__, __LINE__));
  1227. return false;
  1228. }
  1229. // Set up array of possible encodings
  1230. $encodings = array();
  1231. // First check to see if input has been overridden.
  1232. if ($this->input_encoding !== false)
  1233. {
  1234. $encodings[] = strtoupper($this->input_encoding);
  1235. }
  1236. $application_types = array('application/xml', 'application/xml-dtd', 'application/xml-external-parsed-entity');
  1237. $text_types = array('text/xml', 'text/xml-external-parsed-entity');
  1238. // RFC 3023 (only applies to sniffed content)
  1239. if (isset($sniffed))
  1240. {
  1241. if (in_array($sniffed, $application_types) || substr($sniffed, 0, 12) === 'application/' && substr($sniffed, -4) === '+xml')
  1242. {
  1243. if (isset($headers['content-type']) && preg_match('/;\x20?charset=([^;]*)/i', $headers['content-type'], $charset))
  1244. {
  1245. $encodings[] = strtoupper($charset[1]);
  1246. }
  1247. $encodings = array_merge($encodings, $this->registry->call('Misc', 'xml_encoding', array($this->raw_data, &$this->registry)));
  1248. $encodings[] = 'UTF-8';
  1249. }
  1250. elseif (in_array($sniffed, $text_types) || substr($sniffed, 0, 5) === 'text/' && substr($sniffed, -4) === '+xml')
  1251. {
  1252. if (isset($headers['content-type']) && preg_match('/;\x20?charset=([^;]*)/i', $headers['content-type'], $charset))
  1253. {
  1254. $encodings[] = strtoupper($charset[1]);
  1255. }
  1256. $encodings[] = 'US-ASCII';
  1257. }
  1258. // Text MIME-type default
  1259. elseif (substr($sniffed, 0, 5) === 'text/')
  1260. {
  1261. $encodings[] = 'UTF-8';
  1262. }
  1263. }
  1264. // Fallback to XML 1.0 Appendix F.1/UTF-8/ISO-8859-1
  1265. $encodings = array_merge($encodings, $this->registry->call('Misc', 'xml_encoding', array($this->raw_data, &$this->registry)));
  1266. $encodings[] = 'UTF-8';
  1267. $encodings[] = 'ISO-8859-1';
  1268. // There's no point in trying an encoding twice
  1269. $encodings = array_unique($encodings);
  1270. // Loop through each possible encoding, till we return something, or run out of possibilities
  1271. foreach ($encodings as $encoding)
  1272. {
  1273. // Change the encoding to UTF-8 (as we always use UTF-8 internally)
  1274. if ($utf8_data = $this->registry->call('Misc', 'change_encoding', array($this->raw_data, $encoding, 'UTF-8')))
  1275. {
  1276. // Create new parser
  1277. $parser = $this->registry->create('Parser');
  1278. // If it's parsed fine
  1279. if ($parser->parse($utf8_data, 'UTF-8', $this->permanent_url))
  1280. {
  1281. $this->data = $parser->get_data();
  1282. if (!($this->get_type() & ~SIMPLEPIE_TYPE_NONE))
  1283. {
  1284. $this->error = "A feed could not be found at `$this->feed_url`. This does not appear to be a valid RSS or Atom feed.";
  1285. $this->registry->call('Misc', 'error', array($this->error, E_USER_NOTICE, __FILE__, __LINE__));
  1286. return false;
  1287. }
  1288. if (isset($headers))
  1289. {
  1290. $this->data['headers'] = $headers;
  1291. }
  1292. $this->data['build'] = SIMPLEPIE_BUILD;
  1293. // Cache the file if caching is enabled
  1294. if ($cache && !$cache->save($this))
  1295. {
  1296. trigger_error("$this->cache_location is not writable. Make sure you've set the correct relative or absolute path, and that the location is server-writable.", E_USER_WARNING);
  1297. }
  1298. return true;
  1299. }
  1300. }
  1301. }
  1302. if (isset($parser))
  1303. {
  1304. // We have an error, just set SimplePie_Misc::error to it and quit
  1305. $this->error = $this->feed_url;
  1306. $this->error .= sprintf(' is invalid XML, likely due to invalid characters. XML error: %s at line %d, column %d', $parser->get_error_string(), $parser->get_current_line(), $parser->get_current_column());
  1307. }
  1308. else
  1309. {
  1310. $this->error = 'The data could not be converted to UTF-8.';
  1311. if (!extension_loaded('mbstring') && !extension_loaded('iconv') && !class_exists('\UConverter')) {
  1312. $this->error .= ' You MUST have either the iconv, mbstring or intl (PHP 5.5+) extension installed and enabled.';
  1313. } else {
  1314. $missingExtensions = array();
  1315. if (!extension_loaded('iconv')) {
  1316. $missingExtensions[] = 'iconv';
  1317. }
  1318. if (!extension_loaded('mbstring')) {
  1319. $missingExtensions[] = 'mbstring';
  1320. }
  1321. if (!class_exists('\UConverter')) {
  1322. $missingExtensions[] = 'intl (PHP 5.5+)';
  1323. }
  1324. $this->error .= ' Try installing/enabling the ' . implode(' or ', $missingExtensions) . ' extension.';
  1325. }
  1326. }
  1327. $this->registry->call('Misc', 'error', array($this->error, E_USER_NOTICE, __FILE__, __LINE__));
  1328. return false;
  1329. }
  1330. /**
  1331. * Fetch the data via SimplePie_File
  1332. *
  1333. * If the data is already cached, attempt to fetch it from there instead
  1334. * @param SimplePie_Cache|false $cache Cache handler, or false to not load from the cache
  1335. * @return array|true Returns true if the data was loaded from the cache, or an array of HTTP headers and sniffed type
  1336. */
  1337. protected function fetch_data(&$cache)
  1338. {
  1339. // If it's enabled, use the cache
  1340. if ($cache)
  1341. {
  1342. // Load the Cache
  1343. $this->data = $cache->load();
  1344. if (!empty($this->data))
  1345. {
  1346. // If the cache is for an outdated build of SimplePie
  1347. if (!isset($this->data['build']) || $this->data['build'] !== SIMPLEPIE_BUILD)
  1348. {
  1349. $cache->unlink();
  1350. $this->data = array();
  1351. }
  1352. // If we've hit a collision just rerun it with caching disabled
  1353. elseif (isset($this->data['url']) && $this->data['url'] !== $this->feed_url)
  1354. {
  1355. $cache = false;
  1356. $this->data = array();
  1357. }
  1358. // If we've got a non feed_url stored (if the page isn't actually a feed, or is a redirect) use that URL.
  1359. elseif (isset($this->data['feed_url']))
  1360. {
  1361. // If the autodiscovery cache is still valid use it.
  1362. if ($cache->mtime() + $this->autodiscovery_cache_duration > time())
  1363. {
  1364. // Do not need to do feed autodiscovery yet.
  1365. if ($this->data['feed_url'] !== $this->data['url'])
  1366. {
  1367. $this->set_feed_url($this->data['feed_url']);
  1368. return $this->init();
  1369. }
  1370. $cache->unlink();
  1371. $this->data = array();
  1372. }
  1373. }
  1374. // Check if the cache has been updated
  1375. elseif ($cache->mtime() + $this->cache_duration < time())
  1376. {
  1377. // Want to know if we tried to send last-modified and/or etag headers
  1378. // when requesting this file. (Note that it's up to the file to
  1379. // support this, but we don't always send the headers either.)
  1380. $this->check_modified = true;
  1381. if (isset($this->data['headers']['last-modified']) || isset($this->data['headers']['etag']))
  1382. {
  1383. $headers = array(
  1384. 'Accept' => 'application/atom+xml, application/rss+xml, application/rdf+xml;q=0.9, application/xml;q=0.8, text/xml;q=0.8, text/html;q=0.7, unknown/unknown;q=0.1, application/unknown;q=0.1, */*;q=0.1',
  1385. );
  1386. if (isset($this->data['headers']['last-modified']))
  1387. {
  1388. $headers['if-modified-since'] = $this->data['headers']['last-modified'];
  1389. }
  1390. if (isset($this->data['headers']['etag']))
  1391. {
  1392. $headers['if-none-match'] = $this->data['headers']['etag'];
  1393. }
  1394. $file = $this->registry->create('File', array($this->feed_url, $this->timeout/10, 5, $headers, $this->useragent, $this->force_fsockopen, $this->curl_options));
  1395. if ($file->success)
  1396. {
  1397. if ($file->status_code === 304)
  1398. {
  1399. // Set raw_data to false here too, to signify that the cache
  1400. // is still valid.
  1401. $this->raw_data = false;
  1402. $cache->touch();
  1403. return true;
  1404. }
  1405. }
  1406. else
  1407. {
  1408. $this->check_modified = false;
  1409. if($this->force_cache_fallback)
  1410. {
  1411. $cache->touch();
  1412. return true;
  1413. }
  1414. unset($file);
  1415. }
  1416. }
  1417. }
  1418. // If the cache is still valid, just return true
  1419. else
  1420. {
  1421. $this->raw_data = false;
  1422. return true;
  1423. }
  1424. }
  1425. // If the cache is empty, delete it
  1426. else
  1427. {
  1428. $cache->unlink();
  1429. $this->data = array();
  1430. }
  1431. }
  1432. // If we don't already have the file (it'll only exist if we've opened it to check if the cache has been modified), open it.
  1433. if (!isset($file))
  1434. {
  1435. if ($this->file instanceof SimplePie_File && $this->file->url === $this->feed_url)
  1436. {
  1437. $file =& $this->file;
  1438. }
  1439. else
  1440. {
  1441. $headers = array(
  1442. 'Accept' => 'application/atom+xml, application/rss+xml, application/rdf+xml;q=0.9, application/xml;q=0.8, text/xml;q=0.8, text/html;q=0.7, unknown/unknown;q=0.1, application/unknown;q=0.1, */*;q=0.1',
  1443. );
  1444. $file = $this->registry->create('File', array($this->feed_url, $this->timeout, 5, $headers, $this->useragent, $this->force_fsockopen, $this->curl_options));
  1445. }
  1446. }
  1447. // If the file connection has an error, set SimplePie::error to that and quit
  1448. if (!$file->success && !($file->method & SIMPLEPIE_FILE_SOURCE_REMOTE === 0 || ($file->status_code === 200 || $file->status_code > 206 && $file->status_code < 300)))
  1449. {
  1450. $this->error = $file->error;
  1451. return !empty($this->data);
  1452. }
  1453. if (!$this->force_feed)
  1454. {
  1455. // Check if the supplied URL is a feed, if it isn't, look for it.
  1456. $locate = $this->registry->create('Locator', array(&$file, $this->timeout, $this->useragent, $this->max_checked_feeds, $this->force_fsockopen, $this->curl_options));
  1457. if (!$locate->is_feed($file))
  1458. {
  1459. $copyStatusCode = $file->status_code;
  1460. $copyContentType = $file->headers['content-type'];
  1461. try
  1462. {
  1463. $microformats = false;
  1464. if (class_exists('DOMXpath') && function_exists('Mf2\parse')) {
  1465. $doc = new DOMDocument();
  1466. @$doc->loadHTML($file->body);
  1467. $xpath = new DOMXpath($doc);
  1468. // Check for both h-feed and h-entry, as both a feed with no entries
  1469. // and a list of entries without an h-feed wrapper are both valid.
  1470. $query = '//*[contains(concat(" ", @class, " "), " h-feed ") or '.
  1471. 'contains(concat(" ", @class, " "), " h-entry ")]';
  1472. $result = $xpath->query($query);
  1473. $microformats = $result->length !== 0;
  1474. }
  1475. // Now also do feed discovery, but if microformats were found don't
  1476. // overwrite the current value of file.
  1477. $discovered = $locate->find($this->autodiscovery,
  1478. $this->all_discovered_feeds);
  1479. if ($microformats)
  1480. {
  1481. if ($hub = $locate->get_rel_link('hub'))
  1482. {
  1483. $self = $locate->get_rel_link('self');
  1484. $this->store_links($file, $hub, $self);
  1485. }
  1486. // Push the current file onto all_discovered feeds so the user can
  1487. // be shown this as one of the options.
  1488. if (isset($this->all_discovered_feeds)) {
  1489. $this->all_discovered_feeds[] = $file;
  1490. }
  1491. }
  1492. else
  1493. {
  1494. if ($discovered)
  1495. {
  1496. $file = $discovered;
  1497. }
  1498. else
  1499. {
  1500. // We need to unset this so that if SimplePie::set_file() has
  1501. // been called that object is untouched
  1502. unset($file);
  1503. $this->error = "A feed could not be found at `$this->feed_url`; the status code is `$copyStatusCode` and content-type is `$copyContentType`";
  1504. $this->registry->call('Misc', 'error', array($this->error, E_USER_NOTICE, __FILE__, __LINE__));
  1505. return false;
  1506. }
  1507. }
  1508. }
  1509. catch (SimplePie_Exception $e)
  1510. {
  1511. // We need to unset this so that if SimplePie::set_file() has been called that object is untouched
  1512. unset($file);
  1513. // This is usually because DOMDocument doesn't exist
  1514. $this->error = $e->getMessage();
  1515. $this->registry->call('Misc', 'error', array($this->error, E_USER_NOTICE, $e->getFile(), $e->getLine()));
  1516. return false;
  1517. }
  1518. if ($cache)
  1519. {
  1520. $this->data = array('url' => $this->feed_url, 'feed_url' => $file->url, 'build' => SIMPLEPIE_BUILD);
  1521. if (!$cache->save($this))
  1522. {
  1523. trigger_error("$this->cache_location is not writable. Make sure you've set the correct relative or absolute path, and that the location is server-writable.", E_USER_WARNING);
  1524. }
  1525. $cache = $this->registry->call('Cache', 'get_handler', array($this->cache_location, call_user_func($this->cache_name_function, $file->url), 'spc'));
  1526. }
  1527. }
  1528. $this->feed_url = $file->url;
  1529. $locate = null;
  1530. }
  1531. $this->raw_data = $file->body;
  1532. $this->permanent_url = $file->permanent_url;
  1533. $headers = $file->headers;
  1534. $sniffer = $this->registry->create('Content_Type_Sniffer', array(&$file));
  1535. $sniffed = $sniffer->get_type();
  1536. return array($headers, $sniffed);
  1537. }
  1538. /**
  1539. * Get the error message for the occured error
  1540. *
  1541. * @return string|array Error message, or array of messages for multifeeds
  1542. */
  1543. public function error()
  1544. {
  1545. return $this->error;
  1546. }
  1547. /**
  1548. * Get the raw XML
  1549. *
  1550. * This is the same as the old `$feed->enable_xml_dump(true)`, but returns
  1551. * the data instead of printing it.
  1552. *
  1553. * @return string|boolean Raw XML data, false if the cache is used
  1554. */
  1555. public function get_raw_data()
  1556. {
  1557. return $this->raw_data;
  1558. }
  1559. /**
  1560. * Get the character encoding used for output
  1561. *
  1562. * @since Preview Release
  1563. * @return string
  1564. */
  1565. public function get_encoding()
  1566. {
  1567. return $this->sanitize->output_encoding;
  1568. }
  1569. /**
  1570. * Send the content-type header with correct encoding
  1571. *
  1572. * This method ensures that the SimplePie-enabled page is being served with
  1573. * the correct {@link http://www.iana.org/assignments/media-types/ mime-type}
  1574. * and character encoding HTTP headers (character encoding determined by the
  1575. * {@see set_output_encoding} config option).
  1576. *
  1577. * This won't work properly if any content or whitespace has already been
  1578. * sent to the browser, because it relies on PHP's
  1579. * {@link http://php.net/header header()} function, and these are the
  1580. * circumstances under which the function works.
  1581. *
  1582. * Because it's setting these settings for the entire page (as is the nature
  1583. * of HTTP headers), this should only be used once per page (again, at the
  1584. * top).
  1585. *
  1586. * @param string $mime MIME type to serve the page as
  1587. */
  1588. public function handle_content_type($mime = 'text/html')
  1589. {
  1590. if (!headers_sent())
  1591. {
  1592. $header = "Content-type: $mime;";
  1593. if ($this->get_encoding())
  1594. {
  1595. $header .= ' charset=' . $this->get_encoding();
  1596. }
  1597. else
  1598. {
  1599. $header .= ' charset=UTF-8';
  1600. }
  1601. header($header);
  1602. }
  1603. }
  1604. /**
  1605. * Get the type of the feed
  1606. *
  1607. * This returns a SIMPLEPIE_TYPE_* constant, which can be tested against
  1608. * using {@link http://php.net/language.operators.bitwise bitwise operators}
  1609. *
  1610. * @since 0.8 (usage changed to using constants in 1.0)
  1611. * @see SIMPLEPIE_TYPE_NONE Unknown.
  1612. * @see SIMPLEPIE_TYPE_RSS_090 RSS 0.90.
  1613. * @see SIMPLEPIE_TYPE_RSS_091_NETSCAPE RSS 0.91 (Netscape).
  1614. * @see SIMPLEPIE_TYPE_RSS_091_USERLAND RSS 0.91 (Userland).
  1615. * @see SIMPLEPIE_TYPE_RSS_091 RSS 0.91.
  1616. * @see SIMPLEPIE_TYPE_RSS_092 RSS 0.92.
  1617. * @see SIMPLEPIE_TYPE_RSS_093 RSS 0.93.
  1618. * @see SIMPLEPIE_TYPE_RSS_094 RSS 0.94.
  1619. * @see SIMPLEPIE_TYPE_RSS_10 RSS 1.0.
  1620. * @see SIMPLEPIE_TYPE_RSS_20 RSS 2.0.x.
  1621. * @see SIMPLEPIE_TYPE_RSS_RDF RDF-based RSS.
  1622. * @see SIMPLEPIE_TYPE_RSS_SYNDICATION Non-RDF-based RSS (truly intended as syndication format).
  1623. * @see SIMPLEPIE_TYPE_RSS_ALL Any version of RSS.
  1624. * @see SIMPLEPIE_TYPE_ATOM_03 Atom 0.3.
  1625. * @see SIMPLEPIE_TYPE_ATOM_10 Atom 1.0.
  1626. * @see SIMPLEPIE_TYPE_ATOM_ALL Any version of Atom.
  1627. * @see SIMPLEPIE_TYPE_ALL Any known/supported feed type.
  1628. * @return int SIMPLEPIE_TYPE_* constant
  1629. */
  1630. public function get_type()
  1631. {
  1632. if (!isset($this->data['type']))
  1633. {
  1634. $this->data['type'] = SIMPLEPIE_TYPE_ALL;
  1635. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed']))
  1636. {
  1637. $this->data['type'] &= SIMPLEPIE_TYPE_ATOM_10;
  1638. }
  1639. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed']))
  1640. {
  1641. $this->data['type'] &= SIMPLEPIE_TYPE_ATOM_03;
  1642. }
  1643. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF']))
  1644. {
  1645. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_10]['channel'])
  1646. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_10]['image'])
  1647. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_10]['item'])
  1648. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_10]['textinput']))
  1649. {
  1650. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_10;
  1651. }
  1652. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_090]['channel'])
  1653. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_090]['image'])
  1654. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_090]['item'])
  1655. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_090]['textinput']))
  1656. {
  1657. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_090;
  1658. }
  1659. }
  1660. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss']))
  1661. {
  1662. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_ALL;
  1663. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['attribs']['']['version']))
  1664. {
  1665. switch (trim($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['attribs']['']['version']))
  1666. {
  1667. case '0.91':
  1668. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_091;
  1669. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_20]['skiphours']['hour'][0]['data']))
  1670. {
  1671. switch (trim($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_20]['skiphours']['hour'][0]['data']))
  1672. {
  1673. case '0':
  1674. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_091_NETSCAPE;
  1675. break;
  1676. case '24':
  1677. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_091_USERLAND;
  1678. break;
  1679. }
  1680. }
  1681. break;
  1682. case '0.92':
  1683. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_092;
  1684. break;
  1685. case '0.93':
  1686. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_093;
  1687. break;
  1688. case '0.94':
  1689. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_094;
  1690. break;
  1691. case '2.0':
  1692. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_20;
  1693. break;
  1694. }
  1695. }
  1696. }
  1697. else
  1698. {
  1699. $this->data['type'] = SIMPLEPIE_TYPE_NONE;
  1700. }
  1701. }
  1702. return $this->data['type'];
  1703. }
  1704. /**
  1705. * Get the URL for the feed
  1706. *
  1707. * When the 'permanent' mode is enabled, returns the original feed URL,
  1708. * except in the case of an `HTTP 301 Moved Permanently` status response,
  1709. * in which case the location of the first redirection is returned.
  1710. *
  1711. * When the 'permanent' mode is disabled (default),
  1712. * may or may not be different from the URL passed to {@see set_feed_url()},
  1713. * depending on whether auto-discovery was used, and whether there were
  1714. * any redirects along the way.
  1715. *
  1716. * @since Preview Release (previously called `get_feed_url()` since SimplePie 0.8.)
  1717. * @todo Support <itunes:new-feed-url>
  1718. * @todo Also, |atom:link|@rel=self
  1719. * @param bool $permanent Permanent mode to return only the original URL or the first redirection
  1720. * iff it is a 301 redirection
  1721. * @return string|null
  1722. */
  1723. public function subscribe_url($permanent = false)
  1724. {
  1725. if ($permanent)
  1726. {
  1727. if ($this->permanent_url !== null)
  1728. {
  1729. // sanitize encodes ampersands which are required when used in a url.
  1730. return str_replace('&amp;', '&',
  1731. $this->sanitize($this->permanent_url,
  1732. SIMPLEPIE_CONSTRUCT_IRI));
  1733. }
  1734. }
  1735. else
  1736. {
  1737. if ($this->feed_url !== null)
  1738. {
  1739. return str_replace('&amp;', '&',
  1740. $this->sanitize($this->feed_url,
  1741. SIMPLEPIE_CONSTRUCT_IRI));
  1742. }
  1743. }
  1744. return null;
  1745. }
  1746. /**
  1747. * Get data for an feed-level element
  1748. *
  1749. * This method allows you to get access to ANY element/attribute that is a
  1750. * sub-element of the opening feed tag.
  1751. *
  1752. * The return value is an indexed array of elements matching the given
  1753. * namespace and tag name. Each element has `attribs`, `data` and `child`
  1754. * subkeys. For `attribs` and `child`, these contain namespace subkeys.
  1755. * `attribs` then has one level of associative name => value data (where
  1756. * `value` is a string) after the namespace. `child` has tag-indexed keys
  1757. * after the namespace, each member of which is an indexed array matching
  1758. * this same format.
  1759. *
  1760. * For example:
  1761. * <pre>
  1762. * // This is probably a bad example because we already support
  1763. * // <media:content> natively, but it shows you how to parse through
  1764. * // the nodes.
  1765. * $group = $item->get_item_tags(SIMPLEPIE_NAMESPACE_MEDIARSS, 'group');
  1766. * $content = $group[0]['child'][SIMPLEPIE_NAMESPACE_MEDIARSS]['content'];
  1767. * $file = $content[0]['attribs']['']['url'];
  1768. * echo $file;
  1769. * </pre>
  1770. *
  1771. * @since 1.0
  1772. * @see http://simplepie.org/wiki/faq/supported_xml_namespaces
  1773. * @param string $namespace The URL of the XML namespace of the elements you're trying to access
  1774. * @param string $tag Tag name
  1775. * @return array
  1776. */
  1777. public function get_feed_tags($namespace, $tag)
  1778. {
  1779. $type = $this->get_type();
  1780. if ($type & SIMPLEPIE_TYPE_ATOM_10)
  1781. {
  1782. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0]['child'][$namespace][$tag]))
  1783. {
  1784. return $this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0]['child'][$namespace][$tag];
  1785. }
  1786. }
  1787. if ($type & SIMPLEPIE_TYPE_ATOM_03)
  1788. {
  1789. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0]['child'][$namespace][$tag]))
  1790. {
  1791. return $this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0]['child'][$namespace][$tag];
  1792. }
  1793. }
  1794. if ($type & SIMPLEPIE_TYPE_RSS_RDF)
  1795. {
  1796. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][$namespace][$tag]))
  1797. {
  1798. return $this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][$namespace][$tag];
  1799. }
  1800. }
  1801. if ($type & SIMPLEPIE_TYPE_RSS_SYNDICATION)
  1802. {
  1803. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['child'][$namespace][$tag]))
  1804. {
  1805. return $this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['child'][$namespace][$tag];
  1806. }
  1807. }
  1808. return null;
  1809. }
  1810. /**
  1811. * Get data for an channel-level element
  1812. *
  1813. * This method allows you to get access to ANY element/attribute in the
  1814. * channel/header section of the feed.
  1815. *
  1816. * See {@see SimplePie::get_feed_tags()} for a description of the return value
  1817. *
  1818. * @since 1.0
  1819. * @see http://simplepie.org/wiki/faq/supported_xml_namespaces
  1820. * @param string $namespace The URL of the XML namespace of the elements you're trying to access
  1821. * @param string $tag Tag name
  1822. * @return array
  1823. */
  1824. public function get_channel_tags($namespace, $tag)
  1825. {
  1826. $type = $this->get_type();
  1827. if ($type & SIMPLEPIE_TYPE_ATOM_ALL)
  1828. {
  1829. if ($return = $this->get_feed_tags($namespace, $tag))
  1830. {
  1831. return $return;
  1832. }
  1833. }
  1834. if ($type & SIMPLEPIE_TYPE_RSS_10)
  1835. {
  1836. if ($channel = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'channel'))
  1837. {
  1838. if (isset($channel[0]['child'][$namespace][$tag]))
  1839. {
  1840. return $channel[0]['child'][$namespace][$tag];
  1841. }
  1842. }
  1843. }
  1844. if ($type & SIMPLEPIE_TYPE_RSS_090)
  1845. {
  1846. if ($channel = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'channel'))
  1847. {
  1848. if (isset($channel[0]['child'][$namespace][$tag]))
  1849. {
  1850. return $channel[0]['child'][$namespace][$tag];
  1851. }
  1852. }
  1853. }
  1854. if ($type & SIMPLEPIE_TYPE_RSS_SYNDICATION)
  1855. {
  1856. if ($channel = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'channel'))
  1857. {
  1858. if (isset($channel[0]['child'][$namespace][$tag]))
  1859. {
  1860. return $channel[0]['child'][$namespace][$tag];
  1861. }
  1862. }
  1863. }
  1864. return null;
  1865. }
  1866. /**
  1867. * Get data for an channel-level element
  1868. *
  1869. * This method allows you to get access to ANY element/attribute in the
  1870. * image/logo section of the feed.
  1871. *
  1872. * See {@see SimplePie::get_feed_tags()} for a description of the return value
  1873. *
  1874. * @since 1.0
  1875. * @see http://simplepie.org/wiki/faq/supported_xml_namespaces
  1876. * @param string $namespace The URL of the XML namespace of the elements you're trying to access
  1877. * @param string $tag Tag name
  1878. * @return array
  1879. */
  1880. public function get_image_tags($namespace, $tag)
  1881. {
  1882. $type = $this->get_type();
  1883. if ($type & SIMPLEPIE_TYPE_RSS_10)
  1884. {
  1885. if ($image = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'image'))
  1886. {
  1887. if (isset($image[0]['child'][$namespace][$tag]))
  1888. {
  1889. return $image[0]['child'][$namespace][$tag];
  1890. }
  1891. }
  1892. }
  1893. if ($type & SIMPLEPIE_TYPE_RSS_090)
  1894. {
  1895. if ($image = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'image'))
  1896. {
  1897. if (isset($image[0]['child'][$namespace][$tag]))
  1898. {
  1899. return $image[0]['child'][$namespace][$tag];
  1900. }
  1901. }
  1902. }
  1903. if ($type & SIMPLEPIE_TYPE_RSS_SYNDICATION)
  1904. {
  1905. if ($image = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'image'))
  1906. {
  1907. if (isset($image[0]['child'][$namespace][$tag]))
  1908. {
  1909. return $image[0]['child'][$namespace][$tag];
  1910. }
  1911. }
  1912. }
  1913. return null;
  1914. }
  1915. /**
  1916. * Get the base URL value from the feed
  1917. *
  1918. * Uses `<xml:base>` if available, otherwise uses the first link in the
  1919. * feed, or failing that, the URL of the feed itself.
  1920. *
  1921. * @see get_link
  1922. * @see subscribe_url
  1923. *
  1924. * @param array $element
  1925. * @return string
  1926. */
  1927. public function get_base($element = array())
  1928. {
  1929. if (!($this->get_type() & SIMPLEPIE_TYPE_RSS_SYNDICATION) && !empty($element['xml_base_explicit']) && isset($element['xml_base']))
  1930. {
  1931. return $element['xml_base'];
  1932. }
  1933. elseif ($this->get_link() !== null)
  1934. {
  1935. return $this->get_link();
  1936. }
  1937. return $this->subscribe_url();
  1938. }
  1939. /**
  1940. * Sanitize feed data
  1941. *
  1942. * @access private
  1943. * @see SimplePie_Sanitize::sanitize()
  1944. * @param string $data Data to sanitize
  1945. * @param int $type One of the SIMPLEPIE_CONSTRUCT_* constants
  1946. * @param string $base Base URL to resolve URLs against
  1947. * @return string Sanitized data
  1948. */
  1949. public function sanitize($data, $type, $base = '')
  1950. {
  1951. try
  1952. {
  1953. return $this->sanitize->sanitize($data, $type, $base);
  1954. }
  1955. catch (SimplePie_Exception $e)
  1956. {
  1957. if (!$this->enable_exceptions)
  1958. {
  1959. $this->error = $e->getMessage();
  1960. $this->registry->call('Misc', 'error', array($this->error, E_USER_WARNING, $e->getFile(), $e->getLine()));
  1961. return '';
  1962. }
  1963. throw $e;
  1964. }
  1965. }
  1966. /**
  1967. * Get the title of the feed
  1968. *
  1969. * Uses `<atom:title>`, `<title>` or `<dc:title>`
  1970. *
  1971. * @since 1.0 (previously called `get_feed_title` since 0.8)
  1972. * @return string|null
  1973. */
  1974. public function get_title()
  1975. {
  1976. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'title'))
  1977. {
  1978. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_10_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  1979. }
  1980. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'title'))
  1981. {
  1982. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_03_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  1983. }
  1984. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'title'))
  1985. {
  1986. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));
  1987. }
  1988. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'title'))
  1989. {
  1990. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));
  1991. }
  1992. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'title'))
  1993. {
  1994. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));
  1995. }
  1996. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'title'))
  1997. {
  1998. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  1999. }
  2000. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'title'))
  2001. {
  2002. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2003. }
  2004. return null;
  2005. }
  2006. /**
  2007. * Get a category for the feed
  2008. *
  2009. * @since Unknown
  2010. * @param int $key The category that you want to return. Remember that arrays begin with 0, not 1
  2011. * @return SimplePie_Category|null
  2012. */
  2013. public function get_category($key = 0)
  2014. {
  2015. $categories = $this->get_categories();
  2016. if (isset($categories[$key]))
  2017. {
  2018. return $categories[$key];
  2019. }
  2020. return null;
  2021. }
  2022. /**
  2023. * Get all categories for the feed
  2024. *
  2025. * Uses `<atom:category>`, `<category>` or `<dc:subject>`
  2026. *
  2027. * @since Unknown
  2028. * @return array|null List of {@see SimplePie_Category} objects
  2029. */
  2030. public function get_categories()
  2031. {
  2032. $categories = array();
  2033. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'category') as $category)
  2034. {
  2035. $term = null;
  2036. $scheme = null;
  2037. $label = null;
  2038. if (isset($category['attribs']['']['term']))
  2039. {
  2040. $term = $this->sanitize($category['attribs']['']['term'], SIMPLEPIE_CONSTRUCT_TEXT);
  2041. }
  2042. if (isset($category['attribs']['']['scheme']))
  2043. {
  2044. $scheme = $this->sanitize($category['attribs']['']['scheme'], SIMPLEPIE_CONSTRUCT_TEXT);
  2045. }
  2046. if (isset($category['attribs']['']['label']))
  2047. {
  2048. $label = $this->sanitize($category['attribs']['']['label'], SIMPLEPIE_CONSTRUCT_TEXT);
  2049. }
  2050. $categories[] = $this->registry->create('Category', array($term, $scheme, $label));
  2051. }
  2052. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'category') as $category)
  2053. {
  2054. // This is really the label, but keep this as the term also for BC.
  2055. // Label will also work on retrieving because that falls back to term.
  2056. $term = $this->sanitize($category['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2057. if (isset($category['attribs']['']['domain']))
  2058. {
  2059. $scheme = $this->sanitize($category['attribs']['']['domain'], SIMPLEPIE_CONSTRUCT_TEXT);
  2060. }
  2061. else
  2062. {
  2063. $scheme = null;
  2064. }
  2065. $categories[] = $this->registry->create('Category', array($term, $scheme, null));
  2066. }
  2067. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'subject') as $category)
  2068. {
  2069. $categories[] = $this->registry->create('Category', array($this->sanitize($category['data'], SIMPLEPIE_CONSTRUCT_TEXT), null, null));
  2070. }
  2071. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'subject') as $category)
  2072. {
  2073. $categories[] = $this->registry->create('Category', array($this->sanitize($category['data'], SIMPLEPIE_CONSTRUCT_TEXT), null, null));
  2074. }
  2075. if (!empty($categories))
  2076. {
  2077. return array_unique($categories);
  2078. }
  2079. return null;
  2080. }
  2081. /**
  2082. * Get an author for the feed
  2083. *
  2084. * @since 1.1
  2085. * @param int $key The author that you want to return. Remember that arrays begin with 0, not 1
  2086. * @return SimplePie_Author|null
  2087. */
  2088. public function get_author($key = 0)
  2089. {
  2090. $authors = $this->get_authors();
  2091. if (isset($authors[$key]))
  2092. {
  2093. return $authors[$key];
  2094. }
  2095. return null;
  2096. }
  2097. /**
  2098. * Get all authors for the feed
  2099. *
  2100. * Uses `<atom:author>`, `<author>`, `<dc:creator>` or `<itunes:author>`
  2101. *
  2102. * @since 1.1
  2103. * @return array|null List of {@see SimplePie_Author} objects
  2104. */
  2105. public function get_authors()
  2106. {
  2107. $authors = array();
  2108. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'author') as $author)
  2109. {
  2110. $name = null;
  2111. $uri = null;
  2112. $email = null;
  2113. if (isset($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['name'][0]['data']))
  2114. {
  2115. $name = $this->sanitize($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['name'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2116. }
  2117. if (isset($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['uri'][0]['data']))
  2118. {
  2119. $uri = $this->sanitize($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['uri'][0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['uri'][0]));
  2120. }
  2121. if (isset($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['email'][0]['data']))
  2122. {
  2123. $email = $this->sanitize($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['email'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2124. }
  2125. if ($name !== null || $email !== null || $uri !== null)
  2126. {
  2127. $authors[] = $this->registry->create('Author', array($name, $uri, $email));
  2128. }
  2129. }
  2130. if ($author = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'author'))
  2131. {
  2132. $name = null;
  2133. $url = null;
  2134. $email = null;
  2135. if (isset($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['name'][0]['data']))
  2136. {
  2137. $name = $this->sanitize($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['name'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2138. }
  2139. if (isset($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['url'][0]['data']))
  2140. {
  2141. $url = $this->sanitize($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['url'][0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['url'][0]));
  2142. }
  2143. if (isset($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['email'][0]['data']))
  2144. {
  2145. $email = $this->sanitize($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['email'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2146. }
  2147. if ($name !== null || $email !== null || $url !== null)
  2148. {
  2149. $authors[] = $this->registry->create('Author', array($name, $url, $email));
  2150. }
  2151. }
  2152. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'creator') as $author)
  2153. {
  2154. $authors[] = $this->registry->create('Author', array($this->sanitize($author['data'], SIMPLEPIE_CONSTRUCT_TEXT), null, null));
  2155. }
  2156. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'creator') as $author)
  2157. {
  2158. $authors[] = $this->registry->create('Author', array($this->sanitize($author['data'], SIMPLEPIE_CONSTRUCT_TEXT), null, null));
  2159. }
  2160. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ITUNES, 'author') as $author)
  2161. {
  2162. $authors[] = $this->registry->create('Author', array($this->sanitize($author['data'], SIMPLEPIE_CONSTRUCT_TEXT), null, null));
  2163. }
  2164. if (!empty($authors))
  2165. {
  2166. return array_unique($authors);
  2167. }
  2168. return null;
  2169. }
  2170. /**
  2171. * Get a contributor for the feed
  2172. *
  2173. * @since 1.1
  2174. * @param int $key The contrbutor that you want to return. Remember that arrays begin with 0, not 1
  2175. * @return SimplePie_Author|null
  2176. */
  2177. public function get_contributor($key = 0)
  2178. {
  2179. $contributors = $this->get_contributors();
  2180. if (isset($contributors[$key]))
  2181. {
  2182. return $contributors[$key];
  2183. }
  2184. return null;
  2185. }
  2186. /**
  2187. * Get all contributors for the feed
  2188. *
  2189. * Uses `<atom:contributor>`
  2190. *
  2191. * @since 1.1
  2192. * @return array|null List of {@see SimplePie_Author} objects
  2193. */
  2194. public function get_contributors()
  2195. {
  2196. $contributors = array();
  2197. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'contributor') as $contributor)
  2198. {
  2199. $name = null;
  2200. $uri = null;
  2201. $email = null;
  2202. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['name'][0]['data']))
  2203. {
  2204. $name = $this->sanitize($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['name'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2205. }
  2206. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['uri'][0]['data']))
  2207. {
  2208. $uri = $this->sanitize($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['uri'][0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['uri'][0]));
  2209. }
  2210. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['email'][0]['data']))
  2211. {
  2212. $email = $this->sanitize($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['email'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2213. }
  2214. if ($name !== null || $email !== null || $uri !== null)
  2215. {
  2216. $contributors[] = $this->registry->create('Author', array($name, $uri, $email));
  2217. }
  2218. }
  2219. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'contributor') as $contributor)
  2220. {
  2221. $name = null;
  2222. $url = null;
  2223. $email = null;
  2224. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['name'][0]['data']))
  2225. {
  2226. $name = $this->sanitize($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['name'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2227. }
  2228. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['url'][0]['data']))
  2229. {
  2230. $url = $this->sanitize($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['url'][0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['url'][0]));
  2231. }
  2232. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['email'][0]['data']))
  2233. {
  2234. $email = $this->sanitize($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['email'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2235. }
  2236. if ($name !== null || $email !== null || $url !== null)
  2237. {
  2238. $contributors[] = $this->registry->create('Author', array($name, $url, $email));
  2239. }
  2240. }
  2241. if (!empty($contributors))
  2242. {
  2243. return array_unique($contributors);
  2244. }
  2245. return null;
  2246. }
  2247. /**
  2248. * Get a single link for the feed
  2249. *
  2250. * @since 1.0 (previously called `get_feed_link` since Preview Release, `get_feed_permalink()` since 0.8)
  2251. * @param int $key The link that you want to return. Remember that arrays begin with 0, not 1
  2252. * @param string $rel The relationship of the link to return
  2253. * @return string|null Link URL
  2254. */
  2255. public function get_link($key = 0, $rel = 'alternate')
  2256. {
  2257. $links = $this->get_links($rel);
  2258. if (isset($links[$key]))
  2259. {
  2260. return $links[$key];
  2261. }
  2262. return null;
  2263. }
  2264. /**
  2265. * Get the permalink for the item
  2266. *
  2267. * Returns the first link available with a relationship of "alternate".
  2268. * Identical to {@see get_link()} with key 0
  2269. *
  2270. * @see get_link
  2271. * @since 1.0 (previously called `get_feed_link` since Preview Release, `get_feed_permalink()` since 0.8)
  2272. * @internal Added for parity between the parent-level and the item/entry-level.
  2273. * @return string|null Link URL
  2274. */
  2275. public function get_permalink()
  2276. {
  2277. return $this->get_link(0);
  2278. }
  2279. /**
  2280. * Get all links for the feed
  2281. *
  2282. * Uses `<atom:link>` or `<link>`
  2283. *
  2284. * @since Beta 2
  2285. * @param string $rel The relationship of links to return
  2286. * @return array|null Links found for the feed (strings)
  2287. */
  2288. public function get_links($rel = 'alternate')
  2289. {
  2290. if (!isset($this->data['links']))
  2291. {
  2292. $this->data['links'] = array();
  2293. if ($links = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'link'))
  2294. {
  2295. foreach ($links as $link)
  2296. {
  2297. if (isset($link['attribs']['']['href']))
  2298. {
  2299. $link_rel = (isset($link['attribs']['']['rel'])) ? $link['attribs']['']['rel'] : 'alternate';
  2300. $this->data['links'][$link_rel][] = $this->sanitize($link['attribs']['']['href'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($link));
  2301. }
  2302. }
  2303. }
  2304. if ($links = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'link'))
  2305. {
  2306. foreach ($links as $link)
  2307. {
  2308. if (isset($link['attribs']['']['href']))
  2309. {
  2310. $link_rel = (isset($link['attribs']['']['rel'])) ? $link['attribs']['']['rel'] : 'alternate';
  2311. $this->data['links'][$link_rel][] = $this->sanitize($link['attribs']['']['href'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($link));
  2312. }
  2313. }
  2314. }
  2315. if ($links = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'link'))
  2316. {
  2317. $this->data['links']['alternate'][] = $this->sanitize($links[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($links[0]));
  2318. }
  2319. if ($links = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'link'))
  2320. {
  2321. $this->data['links']['alternate'][] = $this->sanitize($links[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($links[0]));
  2322. }
  2323. if ($links = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'link'))
  2324. {
  2325. $this->data['links']['alternate'][] = $this->sanitize($links[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($links[0]));
  2326. }
  2327. $keys = array_keys($this->data['links']);
  2328. foreach ($keys as $key)
  2329. {
  2330. if ($this->registry->call('Misc', 'is_isegment_nz_nc', array($key)))
  2331. {
  2332. if (isset($this->data['links'][SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY . $key]))
  2333. {
  2334. $this->data['links'][SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY . $key] = array_merge($this->data['links'][$key], $this->data['links'][SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY . $key]);
  2335. $this->data['links'][$key] =& $this->data['links'][SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY . $key];
  2336. }
  2337. else
  2338. {
  2339. $this->data['links'][SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY . $key] =& $this->data['links'][$key];
  2340. }
  2341. }
  2342. elseif (substr($key, 0, 41) === SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY)
  2343. {
  2344. $this->data['links'][substr($key, 41)] =& $this->data['links'][$key];
  2345. }
  2346. $this->data['links'][$key] = array_unique($this->data['links'][$key]);
  2347. }
  2348. }
  2349. if (isset($this->data['headers']['link']) &&
  2350. preg_match('/<([^>]+)>; rel='.preg_quote($rel).'/',
  2351. $this->data['headers']['link'], $match))
  2352. {
  2353. return array($match[1]);
  2354. }
  2355. else if (isset($this->data['links'][$rel]))
  2356. {
  2357. return $this->data['links'][$rel];
  2358. }
  2359. return null;
  2360. }
  2361. public function get_all_discovered_feeds()
  2362. {
  2363. return $this->all_discovered_feeds;
  2364. }
  2365. /**
  2366. * Get the content for the item
  2367. *
  2368. * Uses `<atom:subtitle>`, `<atom:tagline>`, `<description>`,
  2369. * `<dc:description>`, `<itunes:summary>` or `<itunes:subtitle>`
  2370. *
  2371. * @since 1.0 (previously called `get_feed_description()` since 0.8)
  2372. * @return string|null
  2373. */
  2374. public function get_description()
  2375. {
  2376. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'subtitle'))
  2377. {
  2378. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_10_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  2379. }
  2380. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'tagline'))
  2381. {
  2382. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_03_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  2383. }
  2384. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'description'))
  2385. {
  2386. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));
  2387. }
  2388. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'description'))
  2389. {
  2390. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));
  2391. }
  2392. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'description'))
  2393. {
  2394. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_HTML, $this->get_base($return[0]));
  2395. }
  2396. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'description'))
  2397. {
  2398. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2399. }
  2400. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'description'))
  2401. {
  2402. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2403. }
  2404. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ITUNES, 'summary'))
  2405. {
  2406. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_HTML, $this->get_base($return[0]));
  2407. }
  2408. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ITUNES, 'subtitle'))
  2409. {
  2410. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_HTML, $this->get_base($return[0]));
  2411. }
  2412. return null;
  2413. }
  2414. /**
  2415. * Get the copyright info for the feed
  2416. *
  2417. * Uses `<atom:rights>`, `<atom:copyright>` or `<dc:rights>`
  2418. *
  2419. * @since 1.0 (previously called `get_feed_copyright()` since 0.8)
  2420. * @return string|null
  2421. */
  2422. public function get_copyright()
  2423. {
  2424. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'rights'))
  2425. {
  2426. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_10_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  2427. }
  2428. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'copyright'))
  2429. {
  2430. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_03_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  2431. }
  2432. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'copyright'))
  2433. {
  2434. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2435. }
  2436. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'rights'))
  2437. {
  2438. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2439. }
  2440. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'rights'))
  2441. {
  2442. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2443. }
  2444. return null;
  2445. }
  2446. /**
  2447. * Get the language for the feed
  2448. *
  2449. * Uses `<language>`, `<dc:language>`, or @xml_lang
  2450. *
  2451. * @since 1.0 (previously called `get_feed_language()` since 0.8)
  2452. * @return string|null
  2453. */
  2454. public function get_language()
  2455. {
  2456. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'language'))
  2457. {
  2458. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2459. }
  2460. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'language'))
  2461. {
  2462. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2463. }
  2464. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'language'))
  2465. {
  2466. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2467. }
  2468. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0]['xml_lang']))
  2469. {
  2470. return $this->sanitize($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0]['xml_lang'], SIMPLEPIE_CONSTRUCT_TEXT);
  2471. }
  2472. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0]['xml_lang']))
  2473. {
  2474. return $this->sanitize($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0]['xml_lang'], SIMPLEPIE_CONSTRUCT_TEXT);
  2475. }
  2476. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['xml_lang']))
  2477. {
  2478. return $this->sanitize($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['xml_lang'], SIMPLEPIE_CONSTRUCT_TEXT);
  2479. }
  2480. elseif (isset($this->data['headers']['content-language']))
  2481. {
  2482. return $this->sanitize($this->data['headers']['content-language'], SIMPLEPIE_CONSTRUCT_TEXT);
  2483. }
  2484. return null;
  2485. }
  2486. /**
  2487. * Get the latitude coordinates for the item
  2488. *
  2489. * Compatible with the W3C WGS84 Basic Geo and GeoRSS specifications
  2490. *
  2491. * Uses `<geo:lat>` or `<georss:point>`
  2492. *
  2493. * @since 1.0
  2494. * @link http://www.w3.org/2003/01/geo/ W3C WGS84 Basic Geo
  2495. * @link http://www.georss.org/ GeoRSS
  2496. * @return string|null
  2497. */
  2498. public function get_latitude()
  2499. {
  2500. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_W3C_BASIC_GEO, 'lat'))
  2501. {
  2502. return (float) $return[0]['data'];
  2503. }
  2504. elseif (($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_GEORSS, 'point')) && preg_match('/^((?:-)?[0-9]+(?:\.[0-9]+)) ((?:-)?[0-9]+(?:\.[0-9]+))$/', trim($return[0]['data']), $match))
  2505. {
  2506. return (float) $match[1];
  2507. }
  2508. return null;
  2509. }
  2510. /**
  2511. * Get the longitude coordinates for the feed
  2512. *
  2513. * Compatible with the W3C WGS84 Basic Geo and GeoRSS specifications
  2514. *
  2515. * Uses `<geo:long>`, `<geo:lon>` or `<georss:point>`
  2516. *
  2517. * @since 1.0
  2518. * @link http://www.w3.org/2003/01/geo/ W3C WGS84 Basic Geo
  2519. * @link http://www.georss.org/ GeoRSS
  2520. * @return string|null
  2521. */
  2522. public function get_longitude()
  2523. {
  2524. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_W3C_BASIC_GEO, 'long'))
  2525. {
  2526. return (float) $return[0]['data'];
  2527. }
  2528. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_W3C_BASIC_GEO, 'lon'))
  2529. {
  2530. return (float) $return[0]['data'];
  2531. }
  2532. elseif (($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_GEORSS, 'point')) && preg_match('/^((?:-)?[0-9]+(?:\.[0-9]+)) ((?:-)?[0-9]+(?:\.[0-9]+))$/', trim($return[0]['data']), $match))
  2533. {
  2534. return (float) $match[2];
  2535. }
  2536. return null;
  2537. }
  2538. /**
  2539. * Get the feed logo's title
  2540. *
  2541. * RSS 0.9.0, 1.0 and 2.0 feeds are allowed to have a "feed logo" title.
  2542. *
  2543. * Uses `<image><title>` or `<image><dc:title>`
  2544. *
  2545. * @return string|null
  2546. */
  2547. public function get_image_title()
  2548. {
  2549. if ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'title'))
  2550. {
  2551. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2552. }
  2553. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'title'))
  2554. {
  2555. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2556. }
  2557. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'title'))
  2558. {
  2559. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2560. }
  2561. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_DC_11, 'title'))
  2562. {
  2563. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2564. }
  2565. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_DC_10, 'title'))
  2566. {
  2567. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2568. }
  2569. return null;
  2570. }
  2571. /**
  2572. * Get the feed logo's URL
  2573. *
  2574. * RSS 0.9.0, 2.0, Atom 1.0, and feeds with iTunes RSS tags are allowed to
  2575. * have a "feed logo" URL. This points directly to the image itself.
  2576. *
  2577. * Uses `<itunes:image>`, `<atom:logo>`, `<atom:icon>`,
  2578. * `<image><title>` or `<image><dc:title>`
  2579. *
  2580. * @return string|null
  2581. */
  2582. public function get_image_url()
  2583. {
  2584. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ITUNES, 'image'))
  2585. {
  2586. return $this->sanitize($return[0]['attribs']['']['href'], SIMPLEPIE_CONSTRUCT_IRI);
  2587. }
  2588. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'logo'))
  2589. {
  2590. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2591. }
  2592. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'icon'))
  2593. {
  2594. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2595. }
  2596. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'url'))
  2597. {
  2598. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2599. }
  2600. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'url'))
  2601. {
  2602. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2603. }
  2604. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'url'))
  2605. {
  2606. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2607. }
  2608. return null;
  2609. }
  2610. /**
  2611. * Get the feed logo's link
  2612. *
  2613. * RSS 0.9.0, 1.0 and 2.0 feeds are allowed to have a "feed logo" link. This
  2614. * points to a human-readable page that the image should link to.
  2615. *
  2616. * Uses `<itunes:image>`, `<atom:logo>`, `<atom:icon>`,
  2617. * `<image><title>` or `<image><dc:title>`
  2618. *
  2619. * @return string|null
  2620. */
  2621. public function get_image_link()
  2622. {
  2623. if ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'link'))
  2624. {
  2625. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2626. }
  2627. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'link'))
  2628. {
  2629. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2630. }
  2631. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'link'))
  2632. {
  2633. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2634. }
  2635. return null;
  2636. }
  2637. /**
  2638. * Get the feed logo's link
  2639. *
  2640. * RSS 2.0 feeds are allowed to have a "feed logo" width.
  2641. *
  2642. * Uses `<image><width>` or defaults to 88.0 if no width is specified and
  2643. * the feed is an RSS 2.0 feed.
  2644. *
  2645. * @return int|float|null
  2646. */
  2647. public function get_image_width()
  2648. {
  2649. if ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'width'))
  2650. {
  2651. return round($return[0]['data']);
  2652. }
  2653. elseif ($this->get_type() & SIMPLEPIE_TYPE_RSS_SYNDICATION && $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'url'))
  2654. {
  2655. return 88.0;
  2656. }
  2657. return null;
  2658. }
  2659. /**
  2660. * Get the feed logo's height
  2661. *
  2662. * RSS 2.0 feeds are allowed to have a "feed logo" height.
  2663. *
  2664. * Uses `<image><height>` or defaults to 31.0 if no height is specified and
  2665. * the feed is an RSS 2.0 feed.
  2666. *
  2667. * @return int|float|null
  2668. */
  2669. public function get_image_height()
  2670. {
  2671. if ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'height'))
  2672. {
  2673. return round($return[0]['data']);
  2674. }
  2675. elseif ($this->get_type() & SIMPLEPIE_TYPE_RSS_SYNDICATION && $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'url'))
  2676. {
  2677. return 31.0;
  2678. }
  2679. return null;
  2680. }
  2681. /**
  2682. * Get the number of items in the feed
  2683. *
  2684. * This is well-suited for {@link http://php.net/for for()} loops with
  2685. * {@see get_item()}
  2686. *
  2687. * @param int $max Maximum value to return. 0 for no limit
  2688. * @return int Number of items in the feed
  2689. */
  2690. public function get_item_quantity($max = 0)
  2691. {
  2692. $max = (int) $max;
  2693. $qty = count($this->get_items());
  2694. if ($max === 0)
  2695. {
  2696. return $qty;
  2697. }
  2698. return ($qty > $max) ? $max : $qty;
  2699. }
  2700. /**
  2701. * Get a single item from the feed
  2702. *
  2703. * This is better suited for {@link http://php.net/for for()} loops, whereas
  2704. * {@see get_items()} is better suited for
  2705. * {@link http://php.net/foreach foreach()} loops.
  2706. *
  2707. * @see get_item_quantity()
  2708. * @since Beta 2
  2709. * @param int $key The item that you want to return. Remember that arrays begin with 0, not 1
  2710. * @return SimplePie_Item|null
  2711. */
  2712. public function get_item($key = 0)
  2713. {
  2714. $items = $this->get_items();
  2715. if (isset($items[$key]))
  2716. {
  2717. return $items[$key];
  2718. }
  2719. return null;
  2720. }
  2721. /**
  2722. * Get all items from the feed
  2723. *
  2724. * This is better suited for {@link http://php.net/for for()} loops, whereas
  2725. * {@see get_items()} is better suited for
  2726. * {@link http://php.net/foreach foreach()} loops.
  2727. *
  2728. * @see get_item_quantity
  2729. * @since Beta 2
  2730. * @param int $start Index to start at
  2731. * @param int $end Number of items to return. 0 for all items after `$start`
  2732. * @return SimplePie_Item[]|null List of {@see SimplePie_Item} objects
  2733. */
  2734. public function get_items($start = 0, $end = 0)
  2735. {
  2736. if (!isset($this->data['items']))
  2737. {
  2738. if (!empty($this->multifeed_objects))
  2739. {
  2740. $this->data['items'] = SimplePie::merge_items($this->multifeed_objects, $start, $end, $this->item_limit);
  2741. if (empty($this->data['items']))
  2742. {
  2743. return array();
  2744. }
  2745. return $this->data['items'];
  2746. }
  2747. $this->data['items'] = array();
  2748. if ($items = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'entry'))
  2749. {
  2750. $keys = array_keys($items);
  2751. foreach ($keys as $key)
  2752. {
  2753. $this->data['items'][] = $this->registry->create('Item', array($this, $items[$key]));
  2754. }
  2755. }
  2756. if ($items = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'entry'))
  2757. {
  2758. $keys = array_keys($items);
  2759. foreach ($keys as $key)
  2760. {
  2761. $this->data['items'][] = $this->registry->create('Item', array($this, $items[$key]));
  2762. }
  2763. }
  2764. if ($items = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'item'))
  2765. {
  2766. $keys = array_keys($items);
  2767. foreach ($keys as $key)
  2768. {
  2769. $this->data['items'][] = $this->registry->create('Item', array($this, $items[$key]));
  2770. }
  2771. }
  2772. if ($items = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'item'))
  2773. {
  2774. $keys = array_keys($items);
  2775. foreach ($keys as $key)
  2776. {
  2777. $this->data['items'][] = $this->registry->create('Item', array($this, $items[$key]));
  2778. }
  2779. }
  2780. if ($items = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'item'))
  2781. {
  2782. $keys = array_keys($items);
  2783. foreach ($keys as $key)
  2784. {
  2785. $this->data['items'][] = $this->registry->create('Item', array($this, $items[$key]));
  2786. }
  2787. }
  2788. }
  2789. if (empty($this->data['items']))
  2790. {
  2791. return array();
  2792. }
  2793. if ($this->order_by_date)
  2794. {
  2795. if (!isset($this->data['ordered_items']))
  2796. {
  2797. $this->data['ordered_items'] = $this->data['items'];
  2798. usort($this->data['ordered_items'], array(get_class($this), 'sort_items'));
  2799. }
  2800. $items = $this->data['ordered_items'];
  2801. }
  2802. else
  2803. {
  2804. $items = $this->data['items'];
  2805. }
  2806. // Slice the data as desired
  2807. if ($end === 0)
  2808. {
  2809. return array_slice($items, $start);
  2810. }
  2811. return array_slice($items, $start, $end);
  2812. }
  2813. /**
  2814. * Set the favicon handler
  2815. *
  2816. * @deprecated Use your own favicon handling instead
  2817. */
  2818. public function set_favicon_handler($page = false, $qs = 'i')
  2819. {
  2820. $level = defined('E_USER_DEPRECATED') ? E_USER_DEPRECATED : E_USER_WARNING;
  2821. trigger_error('Favicon handling has been removed, please use your own handling', $level);
  2822. return false;
  2823. }
  2824. /**
  2825. * Get the favicon for the current feed
  2826. *
  2827. * @deprecated Use your own favicon handling instead
  2828. */
  2829. public function get_favicon()
  2830. {
  2831. $level = defined('E_USER_DEPRECATED') ? E_USER_DEPRECATED : E_USER_WARNING;
  2832. trigger_error('Favicon handling has been removed, please use your own handling', $level);
  2833. if (($url = $this->get_link()) !== null)
  2834. {
  2835. return 'https://www.google.com/s2/favicons?domain=' . urlencode($url);
  2836. }
  2837. return false;
  2838. }
  2839. /**
  2840. * Magic method handler
  2841. *
  2842. * @param string $method Method name
  2843. * @param array $args Arguments to the method
  2844. * @return mixed
  2845. */
  2846. public function __call($method, $args)
  2847. {
  2848. if (strpos($method, 'subscribe_') === 0)
  2849. {
  2850. $level = defined('E_USER_DEPRECATED') ? E_USER_DEPRECATED : E_USER_WARNING;
  2851. trigger_error('subscribe_*() has been deprecated, implement the callback yourself', $level);
  2852. return '';
  2853. }
  2854. if ($method === 'enable_xml_dump')
  2855. {
  2856. $level = defined('E_USER_DEPRECATED') ? E_USER_DEPRECATED : E_USER_WARNING;
  2857. trigger_error('enable_xml_dump() has been deprecated, use get_raw_data() instead', $level);
  2858. return false;
  2859. }
  2860. $class = get_class($this);
  2861. $trace = debug_backtrace();
  2862. $file = $trace[0]['file'];
  2863. $line = $trace[0]['line'];
  2864. trigger_error("Call to undefined method $class::$method() in $file on line $line", E_USER_ERROR);
  2865. }
  2866. /**
  2867. * Sorting callback for items
  2868. *
  2869. * @access private
  2870. * @param SimplePie $a
  2871. * @param SimplePie $b
  2872. * @return boolean
  2873. */
  2874. public static function sort_items($a, $b)
  2875. {
  2876. $a_date = $a->get_date('U');
  2877. $b_date = $b->get_date('U');
  2878. if ($a_date && $b_date) {
  2879. return $a_date > $b_date ? -1 : 1;
  2880. }
  2881. // Sort items without dates to the top.
  2882. if ($a_date) {
  2883. return 1;
  2884. }
  2885. if ($b_date) {
  2886. return -1;
  2887. }
  2888. return 0;
  2889. }
  2890. /**
  2891. * Merge items from several feeds into one
  2892. *
  2893. * If you're merging multiple feeds together, they need to all have dates
  2894. * for the items or else SimplePie will refuse to sort them.
  2895. *
  2896. * @link http://simplepie.org/wiki/tutorial/sort_multiple_feeds_by_time_and_date#if_feeds_require_separate_per-feed_settings
  2897. * @param array $urls List of SimplePie feed objects to merge
  2898. * @param int $start Starting item
  2899. * @param int $end Number of items to return
  2900. * @param int $limit Maximum number of items per feed
  2901. * @return array
  2902. */
  2903. public static function merge_items($urls, $start = 0, $end = 0, $limit = 0)
  2904. {
  2905. if (is_array($urls) && sizeof($urls) > 0)
  2906. {
  2907. $items = array();
  2908. foreach ($urls as $arg)
  2909. {
  2910. if ($arg instanceof SimplePie)
  2911. {
  2912. $items = array_merge($items, $arg->get_items(0, $limit));
  2913. }
  2914. else
  2915. {
  2916. trigger_error('Arguments must be SimplePie objects', E_USER_WARNING);
  2917. }
  2918. }
  2919. usort($items, array(get_class($urls[0]), 'sort_items'));
  2920. if ($end === 0)
  2921. {
  2922. return array_slice($items, $start);
  2923. }
  2924. return array_slice($items, $start, $end);
  2925. }
  2926. trigger_error('Cannot merge zero SimplePie objects', E_USER_WARNING);
  2927. return array();
  2928. }
  2929. /**
  2930. * Store PubSubHubbub links as headers
  2931. *
  2932. * There is no way to find PuSH links in the body of a microformats feed,
  2933. * so they are added to the headers when found, to be used later by get_links.
  2934. * @param SimplePie_File $file
  2935. * @param string $hub
  2936. * @param string $self
  2937. */
  2938. private function store_links(&$file, $hub, $self) {
  2939. if (isset($file->headers['link']['hub']) ||
  2940. (isset($file->headers['link']) &&
  2941. preg_match('/rel=hub/', $file->headers['link'])))
  2942. {
  2943. return;
  2944. }
  2945. if ($hub)
  2946. {
  2947. if (isset($file->headers['link']))
  2948. {
  2949. if ($file->headers['link'] !== '')
  2950. {
  2951. $file->headers['link'] = ', ';
  2952. }
  2953. }
  2954. else
  2955. {
  2956. $file->headers['link'] = '';
  2957. }
  2958. $file->headers['link'] .= '<'.$hub.'>; rel=hub';
  2959. if ($self)
  2960. {
  2961. $file->headers['link'] .= ', <'.$self.'>; rel=self';
  2962. }
  2963. }
  2964. }
  2965. }
  2966. /**
  2967. * Manages all author-related data
  2968. *
  2969. * Used by {@see SimplePie_Item::get_author()} and {@see SimplePie::get_authors()}
  2970. *
  2971. * This class can be overloaded with {@see SimplePie::set_author_class()}
  2972. *
  2973. * @package SimplePie
  2974. * @subpackage API
  2975. */
  2976. class SimplePie_Author
  2977. {
  2978. /**
  2979. * Author's name
  2980. *
  2981. * @var string
  2982. * @see get_name()
  2983. */
  2984. var $name;
  2985. /**
  2986. * Author's link
  2987. *
  2988. * @var string
  2989. * @see get_link()
  2990. */
  2991. var $link;
  2992. /**
  2993. * Author's email address
  2994. *
  2995. * @var string
  2996. * @see get_email()
  2997. */
  2998. var $email;
  2999. /**
  3000. * Constructor, used to input the data
  3001. *
  3002. * @param string $name
  3003. * @param string $link
  3004. * @param string $email
  3005. */
  3006. public function __construct($name = null, $link = null, $email = null)
  3007. {
  3008. $this->name = $name;
  3009. $this->link = $link;
  3010. $this->email = $email;
  3011. }
  3012. /**
  3013. * String-ified version
  3014. *
  3015. * @return string
  3016. */
  3017. public function __toString()
  3018. {
  3019. // There is no $this->data here
  3020. return md5(serialize($this));
  3021. }
  3022. /**
  3023. * Author's name
  3024. *
  3025. * @return string|null
  3026. */
  3027. public function get_name()
  3028. {
  3029. if ($this->name !== null)
  3030. {
  3031. return $this->name;
  3032. }
  3033. return null;
  3034. }
  3035. /**
  3036. * Author's link
  3037. *
  3038. * @return string|null
  3039. */
  3040. public function get_link()
  3041. {
  3042. if ($this->link !== null)
  3043. {
  3044. return $this->link;
  3045. }
  3046. return null;
  3047. }
  3048. /**
  3049. * Author's email address
  3050. *
  3051. * @return string|null
  3052. */
  3053. public function get_email()
  3054. {
  3055. if ($this->email !== null)
  3056. {
  3057. return $this->email;
  3058. }
  3059. return null;
  3060. }
  3061. }
  3062. /**
  3063. * Used to create cache objects
  3064. *
  3065. * This class can be overloaded with {@see SimplePie::set_cache_class()},
  3066. * although the preferred way is to create your own handler
  3067. * via {@see register()}
  3068. *
  3069. * @package SimplePie
  3070. * @subpackage Caching
  3071. */
  3072. class SimplePie_Cache
  3073. {
  3074. /**
  3075. * Cache handler classes
  3076. *
  3077. * These receive 3 parameters to their constructor, as documented in
  3078. * {@see register()}
  3079. * @var array
  3080. */
  3081. protected static $handlers = array(
  3082. 'mysql' => 'SimplePie_Cache_MySQL',
  3083. 'memcache' => 'SimplePie_Cache_Memcache',
  3084. 'memcached' => 'SimplePie_Cache_Memcached',
  3085. 'redis' => 'SimplePie_Cache_Redis'
  3086. );
  3087. /**
  3088. * Don't call the constructor. Please.
  3089. */
  3090. private function __construct() { }
  3091. /**
  3092. * Create a new SimplePie_Cache object
  3093. *
  3094. * @param string $location URL location (scheme is used to determine handler)
  3095. * @param string $filename Unique identifier for cache object
  3096. * @param string $extension 'spi' or 'spc'
  3097. * @return SimplePie_Cache_Base Type of object depends on scheme of `$location`
  3098. */
  3099. public static function get_handler($location, $filename, $extension)
  3100. {
  3101. $type = explode(':', $location, 2);
  3102. $type = $type[0];
  3103. if (!empty(self::$handlers[$type]))
  3104. {
  3105. $class = self::$handlers[$type];
  3106. return new $class($location, $filename, $extension);
  3107. }
  3108. return new SimplePie_Cache_File($location, $filename, $extension);
  3109. }
  3110. /**
  3111. * Create a new SimplePie_Cache object
  3112. *
  3113. * @deprecated Use {@see get_handler} instead
  3114. */
  3115. public function create($location, $filename, $extension)
  3116. {
  3117. trigger_error('Cache::create() has been replaced with Cache::get_handler(). Switch to the registry system to use this.', E_USER_DEPRECATED);
  3118. return self::get_handler($location, $filename, $extension);
  3119. }
  3120. /**
  3121. * Register a handler
  3122. *
  3123. * @param string $type DSN type to register for
  3124. * @param string $class Name of handler class. Must implement SimplePie_Cache_Base
  3125. */
  3126. public static function register($type, $class)
  3127. {
  3128. self::$handlers[$type] = $class;
  3129. }
  3130. /**
  3131. * Parse a URL into an array
  3132. *
  3133. * @param string $url
  3134. * @return array
  3135. */
  3136. public static function parse_URL($url)
  3137. {
  3138. $params = parse_url($url);
  3139. $params['extras'] = array();
  3140. if (isset($params['query']))
  3141. {
  3142. parse_str($params['query'], $params['extras']);
  3143. }
  3144. return $params;
  3145. }
  3146. }
  3147. /**
  3148. * Base for cache objects
  3149. *
  3150. * Classes to be used with {@see SimplePie_Cache::register()} are expected
  3151. * to implement this interface.
  3152. *
  3153. * @package SimplePie
  3154. * @subpackage Caching
  3155. */
  3156. interface SimplePie_Cache_Base
  3157. {
  3158. /**
  3159. * Feed cache type
  3160. *
  3161. * @var string
  3162. */
  3163. const TYPE_FEED = 'spc';
  3164. /**
  3165. * Image cache type
  3166. *
  3167. * @var string
  3168. */
  3169. const TYPE_IMAGE = 'spi';
  3170. /**
  3171. * Create a new cache object
  3172. *
  3173. * @param string $location Location string (from SimplePie::$cache_location)
  3174. * @param string $name Unique ID for the cache
  3175. * @param string $type Either TYPE_FEED for SimplePie data, or TYPE_IMAGE for image data
  3176. */
  3177. public function __construct($location, $name, $type);
  3178. /**
  3179. * Save data to the cache
  3180. *
  3181. * @param array|SimplePie $data Data to store in the cache. If passed a SimplePie object, only cache the $data property
  3182. * @return bool Successfulness
  3183. */
  3184. public function save($data);
  3185. /**
  3186. * Retrieve the data saved to the cache
  3187. *
  3188. * @return array Data for SimplePie::$data
  3189. */
  3190. public function load();
  3191. /**
  3192. * Retrieve the last modified time for the cache
  3193. *
  3194. * @return int Timestamp
  3195. */
  3196. public function mtime();
  3197. /**
  3198. * Set the last modified time to the current time
  3199. *
  3200. * @return bool Success status
  3201. */
  3202. public function touch();
  3203. /**
  3204. * Remove the cache
  3205. *
  3206. * @return bool Success status
  3207. */
  3208. public function unlink();
  3209. }
  3210. /**
  3211. * Base class for database-based caches
  3212. *
  3213. * @package SimplePie
  3214. * @subpackage Caching
  3215. */
  3216. abstract class SimplePie_Cache_DB implements SimplePie_Cache_Base
  3217. {
  3218. /**
  3219. * Helper for database conversion
  3220. *
  3221. * Converts a given {@see SimplePie} object into data to be stored
  3222. *
  3223. * @param SimplePie $data
  3224. * @return array First item is the serialized data for storage, second item is the unique ID for this item
  3225. */
  3226. protected static function prepare_simplepie_object_for_cache($data)
  3227. {
  3228. $items = $data->get_items();
  3229. $items_by_id = array();
  3230. if (!empty($items))
  3231. {
  3232. foreach ($items as $item)
  3233. {
  3234. $items_by_id[$item->get_id()] = $item;
  3235. }
  3236. if (count($items_by_id) !== count($items))
  3237. {
  3238. $items_by_id = array();
  3239. foreach ($items as $item)
  3240. {
  3241. $items_by_id[$item->get_id(true)] = $item;
  3242. }
  3243. }
  3244. if (isset($data->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0]))
  3245. {
  3246. $channel =& $data->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0];
  3247. }
  3248. elseif (isset($data->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0]))
  3249. {
  3250. $channel =& $data->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0];
  3251. }
  3252. elseif (isset($data->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]))
  3253. {
  3254. $channel =& $data->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0];
  3255. }
  3256. elseif (isset($data->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_20]['channel'][0]))
  3257. {
  3258. $channel =& $data->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_20]['channel'][0];
  3259. }
  3260. else
  3261. {
  3262. $channel = null;
  3263. }
  3264. if ($channel !== null)
  3265. {
  3266. if (isset($channel['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['entry']))
  3267. {
  3268. unset($channel['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['entry']);
  3269. }
  3270. if (isset($channel['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['entry']))
  3271. {
  3272. unset($channel['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['entry']);
  3273. }
  3274. if (isset($channel['child'][SIMPLEPIE_NAMESPACE_RSS_10]['item']))
  3275. {
  3276. unset($channel['child'][SIMPLEPIE_NAMESPACE_RSS_10]['item']);
  3277. }
  3278. if (isset($channel['child'][SIMPLEPIE_NAMESPACE_RSS_090]['item']))
  3279. {
  3280. unset($channel['child'][SIMPLEPIE_NAMESPACE_RSS_090]['item']);
  3281. }
  3282. if (isset($channel['child'][SIMPLEPIE_NAMESPACE_RSS_20]['item']))
  3283. {
  3284. unset($channel['child'][SIMPLEPIE_NAMESPACE_RSS_20]['item']);
  3285. }
  3286. }
  3287. if (isset($data->data['items']))
  3288. {
  3289. unset($data->data['items']);
  3290. }
  3291. if (isset($data->data['ordered_items']))
  3292. {
  3293. unset($data->data['ordered_items']);
  3294. }
  3295. }
  3296. return array(serialize($data->data), $items_by_id);
  3297. }
  3298. }
  3299. /**
  3300. * Caches data to the filesystem
  3301. *
  3302. * @package SimplePie
  3303. * @subpackage Caching
  3304. */
  3305. class SimplePie_Cache_File implements SimplePie_Cache_Base
  3306. {
  3307. /**
  3308. * Location string
  3309. *
  3310. * @see SimplePie::$cache_location
  3311. * @var string
  3312. */
  3313. protected $location;
  3314. /**
  3315. * Filename
  3316. *
  3317. * @var string
  3318. */
  3319. protected $filename;
  3320. /**
  3321. * File extension
  3322. *
  3323. * @var string
  3324. */
  3325. protected $extension;
  3326. /**
  3327. * File path
  3328. *
  3329. * @var string
  3330. */
  3331. protected $name;
  3332. /**
  3333. * Create a new cache object
  3334. *
  3335. * @param string $location Location string (from SimplePie::$cache_location)
  3336. * @param string $name Unique ID for the cache
  3337. * @param string $type Either TYPE_FEED for SimplePie data, or TYPE_IMAGE for image data
  3338. */
  3339. public function __construct($location, $name, $type)
  3340. {
  3341. $this->location = $location;
  3342. $this->filename = $name;
  3343. $this->extension = $type;
  3344. $this->name = "$this->location/$this->filename.$this->extension";
  3345. }
  3346. /**
  3347. * Save data to the cache
  3348. *
  3349. * @param array|SimplePie $data Data to store in the cache. If passed a SimplePie object, only cache the $data property
  3350. * @return bool Successfulness
  3351. */
  3352. public function save($data)
  3353. {
  3354. if (file_exists($this->name) && is_writable($this->name) || file_exists($this->location) && is_writable($this->location))
  3355. {
  3356. if ($data instanceof SimplePie)
  3357. {
  3358. $data = $data->data;
  3359. }
  3360. $data = serialize($data);
  3361. return (bool) file_put_contents($this->name, $data);
  3362. }
  3363. return false;
  3364. }
  3365. /**
  3366. * Retrieve the data saved to the cache
  3367. *
  3368. * @return array Data for SimplePie::$data
  3369. */
  3370. public function load()
  3371. {
  3372. if (file_exists($this->name) && is_readable($this->name))
  3373. {
  3374. return unserialize(file_get_contents($this->name));
  3375. }
  3376. return false;
  3377. }
  3378. /**
  3379. * Retrieve the last modified time for the cache
  3380. *
  3381. * @return int Timestamp
  3382. */
  3383. public function mtime()
  3384. {
  3385. return @filemtime($this->name);
  3386. }
  3387. /**
  3388. * Set the last modified time to the current time
  3389. *
  3390. * @return bool Success status
  3391. */
  3392. public function touch()
  3393. {
  3394. return @touch($this->name);
  3395. }
  3396. /**
  3397. * Remove the cache
  3398. *
  3399. * @return bool Success status
  3400. */
  3401. public function unlink()
  3402. {
  3403. if (file_exists($this->name))
  3404. {
  3405. return unlink($this->name);
  3406. }
  3407. return false;
  3408. }
  3409. }
  3410. /**
  3411. * Caches data to memcache
  3412. *
  3413. * Registered for URLs with the "memcache" protocol
  3414. *
  3415. * For example, `memcache://localhost:11211/?timeout=3600&prefix=sp_` will
  3416. * connect to memcache on `localhost` on port 11211. All tables will be
  3417. * prefixed with `sp_` and data will expire after 3600 seconds
  3418. *
  3419. * @package SimplePie
  3420. * @subpackage Caching
  3421. * @uses Memcache
  3422. */
  3423. class SimplePie_Cache_Memcache implements SimplePie_Cache_Base
  3424. {
  3425. /**
  3426. * Memcache instance
  3427. *
  3428. * @var Memcache
  3429. */
  3430. protected $cache;
  3431. /**
  3432. * Options
  3433. *
  3434. * @var array
  3435. */
  3436. protected $options;
  3437. /**
  3438. * Cache name
  3439. *
  3440. * @var string
  3441. */
  3442. protected $name;
  3443. /**
  3444. * Create a new cache object
  3445. *
  3446. * @param string $location Location string (from SimplePie::$cache_location)
  3447. * @param string $name Unique ID for the cache
  3448. * @param string $type Either TYPE_FEED for SimplePie data, or TYPE_IMAGE for image data
  3449. */
  3450. public function __construct($location, $name, $type)
  3451. {
  3452. $this->options = array(
  3453. 'host' => '127.0.0.1',
  3454. 'port' => 11211,
  3455. 'extras' => array(
  3456. 'timeout' => 3600, // one hour
  3457. 'prefix' => 'simplepie_',
  3458. ),
  3459. );
  3460. $this->options = SimplePie_Misc::array_merge_recursive($this->options, SimplePie_Cache::parse_URL($location));
  3461. $this->name = $this->options['extras']['prefix'] . md5("$name:$type");
  3462. $this->cache = new Memcache();
  3463. $this->cache->addServer($this->options['host'], (int) $this->options['port']);
  3464. }
  3465. /**
  3466. * Save data to the cache
  3467. *
  3468. * @param array|SimplePie $data Data to store in the cache. If passed a SimplePie object, only cache the $data property
  3469. * @return bool Successfulness
  3470. */
  3471. public function save($data)
  3472. {
  3473. if ($data instanceof SimplePie)
  3474. {
  3475. $data = $data->data;
  3476. }
  3477. return $this->cache->set($this->name, serialize($data), MEMCACHE_COMPRESSED, (int) $this->options['extras']['timeout']);
  3478. }
  3479. /**
  3480. * Retrieve the data saved to the cache
  3481. *
  3482. * @return array Data for SimplePie::$data
  3483. */
  3484. public function load()
  3485. {
  3486. $data = $this->cache->get($this->name);
  3487. if ($data !== false)
  3488. {
  3489. return unserialize($data);
  3490. }
  3491. return false;
  3492. }
  3493. /**
  3494. * Retrieve the last modified time for the cache
  3495. *
  3496. * @return int Timestamp
  3497. */
  3498. public function mtime()
  3499. {
  3500. $data = $this->cache->get($this->name);
  3501. if ($data !== false)
  3502. {
  3503. // essentially ignore the mtime because Memcache expires on its own
  3504. return time();
  3505. }
  3506. return false;
  3507. }
  3508. /**
  3509. * Set the last modified time to the current time
  3510. *
  3511. * @return bool Success status
  3512. */
  3513. public function touch()
  3514. {
  3515. $data = $this->cache->get($this->name);
  3516. if ($data !== false)
  3517. {
  3518. return $this->cache->set($this->name, $data, MEMCACHE_COMPRESSED, (int) $this->options['extras']['timeout']);
  3519. }
  3520. return false;
  3521. }
  3522. /**
  3523. * Remove the cache
  3524. *
  3525. * @return bool Success status
  3526. */
  3527. public function unlink()
  3528. {
  3529. return $this->cache->delete($this->name, 0);
  3530. }
  3531. }
  3532. /**
  3533. * Caches data to memcached
  3534. *
  3535. * Registered for URLs with the "memcached" protocol
  3536. *
  3537. * For example, `memcached://localhost:11211/?timeout=3600&prefix=sp_` will
  3538. * connect to memcached on `localhost` on port 11211. All tables will be
  3539. * prefixed with `sp_` and data will expire after 3600 seconds
  3540. *
  3541. * @package SimplePie
  3542. * @subpackage Caching
  3543. * @author Paul L. McNeely
  3544. * @uses Memcached
  3545. */
  3546. class SimplePie_Cache_Memcached implements SimplePie_Cache_Base
  3547. {
  3548. /**
  3549. * Memcached instance
  3550. * @var Memcached
  3551. */
  3552. protected $cache;
  3553. /**
  3554. * Options
  3555. * @var array
  3556. */
  3557. protected $options;
  3558. /**
  3559. * Cache name
  3560. * @var string
  3561. */
  3562. protected $name;
  3563. /**
  3564. * Create a new cache object
  3565. * @param string $location Location string (from SimplePie::$cache_location)
  3566. * @param string $name Unique ID for the cache
  3567. * @param string $type Either TYPE_FEED for SimplePie data, or TYPE_IMAGE for image data
  3568. */
  3569. public function __construct($location, $name, $type) {
  3570. $this->options = array(
  3571. 'host' => '127.0.0.1',
  3572. 'port' => 11211,
  3573. 'extras' => array(
  3574. 'timeout' => 3600, // one hour
  3575. 'prefix' => 'simplepie_',
  3576. ),
  3577. );
  3578. $this->options = SimplePie_Misc::array_merge_recursive($this->options, SimplePie_Cache::parse_URL($location));
  3579. $this->name = $this->options['extras']['prefix'] . md5("$name:$type");
  3580. $this->cache = new Memcached();
  3581. $this->cache->addServer($this->options['host'], (int)$this->options['port']);
  3582. }
  3583. /**
  3584. * Save data to the cache
  3585. * @param array|SimplePie $data Data to store in the cache. If passed a SimplePie object, only cache the $data property
  3586. * @return bool Successfulness
  3587. */
  3588. public function save($data) {
  3589. if ($data instanceof SimplePie) {
  3590. $data = $data->data;
  3591. }
  3592. return $this->setData(serialize($data));
  3593. }
  3594. /**
  3595. * Retrieve the data saved to the cache
  3596. * @return array Data for SimplePie::$data
  3597. */
  3598. public function load() {
  3599. $data = $this->cache->get($this->name);
  3600. if ($data !== false) {
  3601. return unserialize($data);
  3602. }
  3603. return false;
  3604. }
  3605. /**
  3606. * Retrieve the last modified time for the cache
  3607. * @return int Timestamp
  3608. */
  3609. public function mtime() {
  3610. $data = $this->cache->get($this->name . '_mtime');
  3611. return (int) $data;
  3612. }
  3613. /**
  3614. * Set the last modified time to the current time
  3615. * @return bool Success status
  3616. */
  3617. public function touch() {
  3618. $data = $this->cache->get($this->name);
  3619. return $this->setData($data);
  3620. }
  3621. /**
  3622. * Remove the cache
  3623. * @return bool Success status
  3624. */
  3625. public function unlink() {
  3626. return $this->cache->delete($this->name, 0);
  3627. }
  3628. /**
  3629. * Set the last modified time and data to Memcached
  3630. * @return bool Success status
  3631. */
  3632. private function setData($data) {
  3633. if ($data !== false) {
  3634. $this->cache->set($this->name . '_mtime', time(), (int)$this->options['extras']['timeout']);
  3635. return $this->cache->set($this->name, $data, (int)$this->options['extras']['timeout']);
  3636. }
  3637. return false;
  3638. }
  3639. }
  3640. /**
  3641. * Caches data to a MySQL database
  3642. *
  3643. * Registered for URLs with the "mysql" protocol
  3644. *
  3645. * For example, `mysql://root:password@localhost:3306/mydb?prefix=sp_` will
  3646. * connect to the `mydb` database on `localhost` on port 3306, with the user
  3647. * `root` and the password `password`. All tables will be prefixed with `sp_`
  3648. *
  3649. * @package SimplePie
  3650. * @subpackage Caching
  3651. */
  3652. class SimplePie_Cache_MySQL extends SimplePie_Cache_DB
  3653. {
  3654. /**
  3655. * PDO instance
  3656. *
  3657. * @var PDO
  3658. */
  3659. protected $mysql;
  3660. /**
  3661. * Options
  3662. *
  3663. * @var array
  3664. */
  3665. protected $options;
  3666. /**
  3667. * Cache ID
  3668. *
  3669. * @var string
  3670. */
  3671. protected $id;
  3672. /**
  3673. * Create a new cache object
  3674. *
  3675. * @param string $location Location string (from SimplePie::$cache_location)
  3676. * @param string $name Unique ID for the cache
  3677. * @param string $type Either TYPE_FEED for SimplePie data, or TYPE_IMAGE for image data
  3678. */
  3679. public function __construct($location, $name, $type)
  3680. {
  3681. $this->options = array(
  3682. 'user' => null,
  3683. 'pass' => null,
  3684. 'host' => '127.0.0.1',
  3685. 'port' => '3306',
  3686. 'path' => '',
  3687. 'extras' => array(
  3688. 'prefix' => '',
  3689. 'cache_purge_time' => 2592000
  3690. ),
  3691. );
  3692. $this->options = SimplePie_Misc::array_merge_recursive($this->options, SimplePie_Cache::parse_URL($location));
  3693. // Path is prefixed with a "/"
  3694. $this->options['dbname'] = substr($this->options['path'], 1);
  3695. try
  3696. {
  3697. $this->mysql = new PDO("mysql:dbname={$this->options['dbname']};host={$this->options['host']};port={$this->options['port']}", $this->options['user'], $this->options['pass'], array(PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES utf8'));
  3698. }
  3699. catch (PDOException $e)
  3700. {
  3701. $this->mysql = null;
  3702. return;
  3703. }
  3704. $this->id = $name . $type;
  3705. if (!$query = $this->mysql->query('SHOW TABLES'))
  3706. {
  3707. $this->mysql = null;
  3708. return;
  3709. }
  3710. $db = array();
  3711. while ($row = $query->fetchColumn())
  3712. {
  3713. $db[] = $row;
  3714. }
  3715. if (!in_array($this->options['extras']['prefix'] . 'cache_data', $db))
  3716. {
  3717. $query = $this->mysql->exec('CREATE TABLE `' . $this->options['extras']['prefix'] . 'cache_data` (`id` TEXT CHARACTER SET utf8 NOT NULL, `items` SMALLINT NOT NULL DEFAULT 0, `data` BLOB NOT NULL, `mtime` INT UNSIGNED NOT NULL, UNIQUE (`id`(125)))');
  3718. if ($query === false)
  3719. {
  3720. trigger_error("Can't create " . $this->options['extras']['prefix'] . "cache_data table, check permissions", E_USER_WARNING);
  3721. $this->mysql = null;
  3722. return;
  3723. }
  3724. }
  3725. if (!in_array($this->options['extras']['prefix'] . 'items', $db))
  3726. {
  3727. $query = $this->mysql->exec('CREATE TABLE `' . $this->options['extras']['prefix'] . 'items` (`feed_id` TEXT CHARACTER SET utf8 NOT NULL, `id` TEXT CHARACTER SET utf8 NOT NULL, `data` MEDIUMBLOB NOT NULL, `posted` INT UNSIGNED NOT NULL, INDEX `feed_id` (`feed_id`(125)))');
  3728. if ($query === false)
  3729. {
  3730. trigger_error("Can't create " . $this->options['extras']['prefix'] . "items table, check permissions", E_USER_WARNING);
  3731. $this->mysql = null;
  3732. return;
  3733. }
  3734. }
  3735. }
  3736. /**
  3737. * Save data to the cache
  3738. *
  3739. * @param array|SimplePie $data Data to store in the cache. If passed a SimplePie object, only cache the $data property
  3740. * @return bool Successfulness
  3741. */
  3742. public function save($data)
  3743. {
  3744. if ($this->mysql === null)
  3745. {
  3746. return false;
  3747. }
  3748. $query = $this->mysql->prepare('DELETE i, cd FROM `' . $this->options['extras']['prefix'] . 'cache_data` cd, ' .
  3749. '`' . $this->options['extras']['prefix'] . 'items` i ' .
  3750. 'WHERE cd.id = i.feed_id ' .
  3751. 'AND cd.mtime < (unix_timestamp() - :purge_time)');
  3752. $query->bindValue(':purge_time', $this->options['extras']['cache_purge_time']);
  3753. if (!$query->execute())
  3754. {
  3755. return false;
  3756. }
  3757. if ($data instanceof SimplePie)
  3758. {
  3759. $data = clone $data;
  3760. $prepared = self::prepare_simplepie_object_for_cache($data);
  3761. $query = $this->mysql->prepare('SELECT COUNT(*) FROM `' . $this->options['extras']['prefix'] . 'cache_data` WHERE `id` = :feed');
  3762. $query->bindValue(':feed', $this->id);
  3763. if ($query->execute())
  3764. {
  3765. if ($query->fetchColumn() > 0)
  3766. {
  3767. $items = count($prepared[1]);
  3768. if ($items)
  3769. {
  3770. $sql = 'UPDATE `' . $this->options['extras']['prefix'] . 'cache_data` SET `items` = :items, `data` = :data, `mtime` = :time WHERE `id` = :feed';
  3771. $query = $this->mysql->prepare($sql);
  3772. $query->bindValue(':items', $items);
  3773. }
  3774. else
  3775. {
  3776. $sql = 'UPDATE `' . $this->options['extras']['prefix'] . 'cache_data` SET `data` = :data, `mtime` = :time WHERE `id` = :feed';
  3777. $query = $this->mysql->prepare($sql);
  3778. }
  3779. $query->bindValue(':data', $prepared[0]);
  3780. $query->bindValue(':time', time());
  3781. $query->bindValue(':feed', $this->id);
  3782. if (!$query->execute())
  3783. {
  3784. return false;
  3785. }
  3786. }
  3787. else
  3788. {
  3789. $query = $this->mysql->prepare('INSERT INTO `' . $this->options['extras']['prefix'] . 'cache_data` (`id`, `items`, `data`, `mtime`) VALUES(:feed, :count, :data, :time)');
  3790. $query->bindValue(':feed', $this->id);
  3791. $query->bindValue(':count', count($prepared[1]));
  3792. $query->bindValue(':data', $prepared[0]);
  3793. $query->bindValue(':time', time());
  3794. if (!$query->execute())
  3795. {
  3796. return false;
  3797. }
  3798. }
  3799. $ids = array_keys($prepared[1]);
  3800. if (!empty($ids))
  3801. {
  3802. foreach ($ids as $id)
  3803. {
  3804. $database_ids[] = $this->mysql->quote($id);
  3805. }
  3806. $query = $this->mysql->prepare('SELECT `id` FROM `' . $this->options['extras']['prefix'] . 'items` WHERE `id` = ' . implode(' OR `id` = ', $database_ids) . ' AND `feed_id` = :feed');
  3807. $query->bindValue(':feed', $this->id);
  3808. if ($query->execute())
  3809. {
  3810. $existing_ids = array();
  3811. while ($row = $query->fetchColumn())
  3812. {
  3813. $existing_ids[] = $row;
  3814. }
  3815. $new_ids = array_diff($ids, $existing_ids);
  3816. foreach ($new_ids as $new_id)
  3817. {
  3818. if (!($date = $prepared[1][$new_id]->get_date('U')))
  3819. {
  3820. $date = time();
  3821. }
  3822. $query = $this->mysql->prepare('INSERT INTO `' . $this->options['extras']['prefix'] . 'items` (`feed_id`, `id`, `data`, `posted`) VALUES(:feed, :id, :data, :date)');
  3823. $query->bindValue(':feed', $this->id);
  3824. $query->bindValue(':id', $new_id);
  3825. $query->bindValue(':data', serialize($prepared[1][$new_id]->data));
  3826. $query->bindValue(':date', $date);
  3827. if (!$query->execute())
  3828. {
  3829. return false;
  3830. }
  3831. }
  3832. return true;
  3833. }
  3834. }
  3835. else
  3836. {
  3837. return true;
  3838. }
  3839. }
  3840. }
  3841. else
  3842. {
  3843. $query = $this->mysql->prepare('SELECT `id` FROM `' . $this->options['extras']['prefix'] . 'cache_data` WHERE `id` = :feed');
  3844. $query->bindValue(':feed', $this->id);
  3845. if ($query->execute())
  3846. {
  3847. if ($query->rowCount() > 0)
  3848. {
  3849. $query = $this->mysql->prepare('UPDATE `' . $this->options['extras']['prefix'] . 'cache_data` SET `items` = 0, `data` = :data, `mtime` = :time WHERE `id` = :feed');
  3850. $query->bindValue(':data', serialize($data));
  3851. $query->bindValue(':time', time());
  3852. $query->bindValue(':feed', $this->id);
  3853. if ($this->execute())
  3854. {
  3855. return true;
  3856. }
  3857. }
  3858. else
  3859. {
  3860. $query = $this->mysql->prepare('INSERT INTO `' . $this->options['extras']['prefix'] . 'cache_data` (`id`, `items`, `data`, `mtime`) VALUES(:id, 0, :data, :time)');
  3861. $query->bindValue(':id', $this->id);
  3862. $query->bindValue(':data', serialize($data));
  3863. $query->bindValue(':time', time());
  3864. if ($query->execute())
  3865. {
  3866. return true;
  3867. }
  3868. }
  3869. }
  3870. }
  3871. return false;
  3872. }
  3873. /**
  3874. * Retrieve the data saved to the cache
  3875. *
  3876. * @return array Data for SimplePie::$data
  3877. */
  3878. public function load()
  3879. {
  3880. if ($this->mysql === null)
  3881. {
  3882. return false;
  3883. }
  3884. $query = $this->mysql->prepare('SELECT `items`, `data` FROM `' . $this->options['extras']['prefix'] . 'cache_data` WHERE `id` = :id');
  3885. $query->bindValue(':id', $this->id);
  3886. if ($query->execute() && ($row = $query->fetch()))
  3887. {
  3888. $data = unserialize($row[1]);
  3889. if (isset($this->options['items'][0]))
  3890. {
  3891. $items = (int) $this->options['items'][0];
  3892. }
  3893. else
  3894. {
  3895. $items = (int) $row[0];
  3896. }
  3897. if ($items !== 0)
  3898. {
  3899. if (isset($data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0]))
  3900. {
  3901. $feed =& $data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0];
  3902. }
  3903. elseif (isset($data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0]))
  3904. {
  3905. $feed =& $data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0];
  3906. }
  3907. elseif (isset($data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]))
  3908. {
  3909. $feed =& $data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0];
  3910. }
  3911. elseif (isset($data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]))
  3912. {
  3913. $feed =& $data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0];
  3914. }
  3915. else
  3916. {
  3917. $feed = null;
  3918. }
  3919. if ($feed !== null)
  3920. {
  3921. $sql = 'SELECT `data` FROM `' . $this->options['extras']['prefix'] . 'items` WHERE `feed_id` = :feed ORDER BY `posted` DESC';
  3922. if ($items > 0)
  3923. {
  3924. $sql .= ' LIMIT ' . $items;
  3925. }
  3926. $query = $this->mysql->prepare($sql);
  3927. $query->bindValue(':feed', $this->id);
  3928. if ($query->execute())
  3929. {
  3930. while ($row = $query->fetchColumn())
  3931. {
  3932. $feed['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['entry'][] = unserialize($row);
  3933. }
  3934. }
  3935. else
  3936. {
  3937. return false;
  3938. }
  3939. }
  3940. }
  3941. return $data;
  3942. }
  3943. return false;
  3944. }
  3945. /**
  3946. * Retrieve the last modified time for the cache
  3947. *
  3948. * @return int Timestamp
  3949. */
  3950. public function mtime()
  3951. {
  3952. if ($this->mysql === null)
  3953. {
  3954. return false;
  3955. }
  3956. $query = $this->mysql->prepare('SELECT `mtime` FROM `' . $this->options['extras']['prefix'] . 'cache_data` WHERE `id` = :id');
  3957. $query->bindValue(':id', $this->id);
  3958. if ($query->execute() && ($time = $query->fetchColumn()))
  3959. {
  3960. return $time;
  3961. }
  3962. return false;
  3963. }
  3964. /**
  3965. * Set the last modified time to the current time
  3966. *
  3967. * @return bool Success status
  3968. */
  3969. public function touch()
  3970. {
  3971. if ($this->mysql === null)
  3972. {
  3973. return false;
  3974. }
  3975. $query = $this->mysql->prepare('UPDATE `' . $this->options['extras']['prefix'] . 'cache_data` SET `mtime` = :time WHERE `id` = :id');
  3976. $query->bindValue(':time', time());
  3977. $query->bindValue(':id', $this->id);
  3978. return $query->execute() && $query->rowCount() > 0;
  3979. }
  3980. /**
  3981. * Remove the cache
  3982. *
  3983. * @return bool Success status
  3984. */
  3985. public function unlink()
  3986. {
  3987. if ($this->mysql === null)
  3988. {
  3989. return false;
  3990. }
  3991. $query = $this->mysql->prepare('DELETE FROM `' . $this->options['extras']['prefix'] . 'cache_data` WHERE `id` = :id');
  3992. $query->bindValue(':id', $this->id);
  3993. $query2 = $this->mysql->prepare('DELETE FROM `' . $this->options['extras']['prefix'] . 'items` WHERE `feed_id` = :id');
  3994. $query2->bindValue(':id', $this->id);
  3995. return $query->execute() && $query2->execute();
  3996. }
  3997. }
  3998. /**
  3999. * Caches data to redis
  4000. *
  4001. * Registered for URLs with the "redis" protocol
  4002. *
  4003. * For example, `redis://localhost:6379/?timeout=3600&prefix=sp_&dbIndex=0` will
  4004. * connect to redis on `localhost` on port 6379. All tables will be
  4005. * prefixed with `simple_primary-` and data will expire after 3600 seconds
  4006. *
  4007. * @package SimplePie
  4008. * @subpackage Caching
  4009. * @uses Redis
  4010. */
  4011. class SimplePie_Cache_Redis implements SimplePie_Cache_Base {
  4012. /**
  4013. * Redis instance
  4014. *
  4015. * @var \Redis
  4016. */
  4017. protected $cache;
  4018. /**
  4019. * Options
  4020. *
  4021. * @var array
  4022. */
  4023. protected $options;
  4024. /**
  4025. * Cache name
  4026. *
  4027. * @var string
  4028. */
  4029. protected $name;
  4030. /**
  4031. * Cache Data
  4032. *
  4033. * @var type
  4034. */
  4035. protected $data;
  4036. /**
  4037. * Create a new cache object
  4038. *
  4039. * @param string $location Location string (from SimplePie::$cache_location)
  4040. * @param string $name Unique ID for the cache
  4041. * @param string $type Either TYPE_FEED for SimplePie data, or TYPE_IMAGE for image data
  4042. */
  4043. public function __construct($location, $name, $options = null) {
  4044. //$this->cache = \flow\simple\cache\Redis::getRedisClientInstance();
  4045. $parsed = SimplePie_Cache::parse_URL($location);
  4046. $redis = new Redis();
  4047. $redis->connect($parsed['host'], $parsed['port']);
  4048. if (isset($parsed['pass'])) {
  4049. $redis->auth($parsed['pass']);
  4050. }
  4051. if (isset($parsed['path'])) {
  4052. $redis->select((int)substr($parsed['path'], 1));
  4053. }
  4054. $this->cache = $redis;
  4055. if (!is_null($options) && is_array($options)) {
  4056. $this->options = $options;
  4057. } else {
  4058. $this->options = array (
  4059. 'prefix' => 'rss:simple_primary:',
  4060. 'expire' => 0,
  4061. );
  4062. }
  4063. $this->name = $this->options['prefix'] . $name;
  4064. }
  4065. /**
  4066. * @param \Redis $cache
  4067. */
  4068. public function setRedisClient(\Redis $cache) {
  4069. $this->cache = $cache;
  4070. }
  4071. /**
  4072. * Save data to the cache
  4073. *
  4074. * @param array|SimplePie $data Data to store in the cache. If passed a SimplePie object, only cache the $data property
  4075. * @return bool Successfulness
  4076. */
  4077. public function save($data) {
  4078. if ($data instanceof SimplePie) {
  4079. $data = $data->data;
  4080. }
  4081. $response = $this->cache->set($this->name, serialize($data));
  4082. if ($this->options['expire']) {
  4083. $this->cache->expire($this->name, $this->options['expire']);
  4084. }
  4085. return $response;
  4086. }
  4087. /**
  4088. * Retrieve the data saved to the cache
  4089. *
  4090. * @return array Data for SimplePie::$data
  4091. */
  4092. public function load() {
  4093. $data = $this->cache->get($this->name);
  4094. if ($data !== false) {
  4095. return unserialize($data);
  4096. }
  4097. return false;
  4098. }
  4099. /**
  4100. * Retrieve the last modified time for the cache
  4101. *
  4102. * @return int Timestamp
  4103. */
  4104. public function mtime() {
  4105. $data = $this->cache->get($this->name);
  4106. if ($data !== false) {
  4107. return time();
  4108. }
  4109. return false;
  4110. }
  4111. /**
  4112. * Set the last modified time to the current time
  4113. *
  4114. * @return bool Success status
  4115. */
  4116. public function touch() {
  4117. $data = $this->cache->get($this->name);
  4118. if ($data !== false) {
  4119. $return = $this->cache->set($this->name, $data);
  4120. if ($this->options['expire']) {
  4121. return $this->cache->expire($this->name, $this->ttl);
  4122. }
  4123. return $return;
  4124. }
  4125. return false;
  4126. }
  4127. /**
  4128. * Remove the cache
  4129. *
  4130. * @return bool Success status
  4131. */
  4132. public function unlink() {
  4133. return $this->cache->set($this->name, null);
  4134. }
  4135. }
  4136. /**
  4137. * Handles `<media:text>` captions as defined in Media RSS.
  4138. *
  4139. * Used by {@see SimplePie_Enclosure::get_caption()} and {@see SimplePie_Enclosure::get_captions()}
  4140. *
  4141. * This class can be overloaded with {@see SimplePie::set_caption_class()}
  4142. *
  4143. * @package SimplePie
  4144. * @subpackage API
  4145. */
  4146. class SimplePie_Caption
  4147. {
  4148. /**
  4149. * Content type
  4150. *
  4151. * @var string
  4152. * @see get_type()
  4153. */
  4154. var $type;
  4155. /**
  4156. * Language
  4157. *
  4158. * @var string
  4159. * @see get_language()
  4160. */
  4161. var $lang;
  4162. /**
  4163. * Start time
  4164. *
  4165. * @var string
  4166. * @see get_starttime()
  4167. */
  4168. var $startTime;
  4169. /**
  4170. * End time
  4171. *
  4172. * @var string
  4173. * @see get_endtime()
  4174. */
  4175. var $endTime;
  4176. /**
  4177. * Caption text
  4178. *
  4179. * @var string
  4180. * @see get_text()
  4181. */
  4182. var $text;
  4183. /**
  4184. * Constructor, used to input the data
  4185. *
  4186. * For documentation on all the parameters, see the corresponding
  4187. * properties and their accessors
  4188. */
  4189. public function __construct($type = null, $lang = null, $startTime = null, $endTime = null, $text = null)
  4190. {
  4191. $this->type = $type;
  4192. $this->lang = $lang;
  4193. $this->startTime = $startTime;
  4194. $this->endTime = $endTime;
  4195. $this->text = $text;
  4196. }
  4197. /**
  4198. * String-ified version
  4199. *
  4200. * @return string
  4201. */
  4202. public function __toString()
  4203. {
  4204. // There is no $this->data here
  4205. return md5(serialize($this));
  4206. }
  4207. /**
  4208. * Get the end time
  4209. *
  4210. * @return string|null Time in the format 'hh:mm:ss.SSS'
  4211. */
  4212. public function get_endtime()
  4213. {
  4214. if ($this->endTime !== null)
  4215. {
  4216. return $this->endTime;
  4217. }
  4218. return null;
  4219. }
  4220. /**
  4221. * Get the language
  4222. *
  4223. * @link http://tools.ietf.org/html/rfc3066
  4224. * @return string|null Language code as per RFC 3066
  4225. */
  4226. public function get_language()
  4227. {
  4228. if ($this->lang !== null)
  4229. {
  4230. return $this->lang;
  4231. }
  4232. return null;
  4233. }
  4234. /**
  4235. * Get the start time
  4236. *
  4237. * @return string|null Time in the format 'hh:mm:ss.SSS'
  4238. */
  4239. public function get_starttime()
  4240. {
  4241. if ($this->startTime !== null)
  4242. {
  4243. return $this->startTime;
  4244. }
  4245. return null;
  4246. }
  4247. /**
  4248. * Get the text of the caption
  4249. *
  4250. * @return string|null
  4251. */
  4252. public function get_text()
  4253. {
  4254. if ($this->text !== null)
  4255. {
  4256. return $this->text;
  4257. }
  4258. return null;
  4259. }
  4260. /**
  4261. * Get the content type (not MIME type)
  4262. *
  4263. * @return string|null Either 'text' or 'html'
  4264. */
  4265. public function get_type()
  4266. {
  4267. if ($this->type !== null)
  4268. {
  4269. return $this->type;
  4270. }
  4271. return null;
  4272. }
  4273. }
  4274. /**
  4275. * Manages all category-related data
  4276. *
  4277. * Used by {@see SimplePie_Item::get_category()} and {@see SimplePie_Item::get_categories()}
  4278. *
  4279. * This class can be overloaded with {@see SimplePie::set_category_class()}
  4280. *
  4281. * @package SimplePie
  4282. * @subpackage API
  4283. */
  4284. class SimplePie_Category
  4285. {
  4286. /**
  4287. * Category identifier
  4288. *
  4289. * @var string|null
  4290. * @see get_term
  4291. */
  4292. var $term;
  4293. /**
  4294. * Categorization scheme identifier
  4295. *
  4296. * @var string|null
  4297. * @see get_scheme()
  4298. */
  4299. var $scheme;
  4300. /**
  4301. * Human readable label
  4302. *
  4303. * @var string|null
  4304. * @see get_label()
  4305. */
  4306. var $label;
  4307. /**
  4308. * Category type
  4309. *
  4310. * category for <category>
  4311. * subject for <dc:subject>
  4312. *
  4313. * @var string|null
  4314. * @see get_type()
  4315. */
  4316. var $type;
  4317. /**
  4318. * Constructor, used to input the data
  4319. *
  4320. * @param string|null $term
  4321. * @param string|null $scheme
  4322. * @param string|null $label
  4323. * @param string|null $type
  4324. */
  4325. public function __construct($term = null, $scheme = null, $label = null, $type = null)
  4326. {
  4327. $this->term = $term;
  4328. $this->scheme = $scheme;
  4329. $this->label = $label;
  4330. $this->type = $type;
  4331. }
  4332. /**
  4333. * String-ified version
  4334. *
  4335. * @return string
  4336. */
  4337. public function __toString()
  4338. {
  4339. // There is no $this->data here
  4340. return md5(serialize($this));
  4341. }
  4342. /**
  4343. * Get the category identifier
  4344. *
  4345. * @return string|null
  4346. */
  4347. public function get_term()
  4348. {
  4349. return $this->term;
  4350. }
  4351. /**
  4352. * Get the categorization scheme identifier
  4353. *
  4354. * @return string|null
  4355. */
  4356. public function get_scheme()
  4357. {
  4358. return $this->scheme;
  4359. }
  4360. /**
  4361. * Get the human readable label
  4362. *
  4363. * @param bool $strict
  4364. * @return string|null
  4365. */
  4366. public function get_label($strict = false)
  4367. {
  4368. if ($this->label === null && $strict !== true)
  4369. {
  4370. return $this->get_term();
  4371. }
  4372. return $this->label;
  4373. }
  4374. /**
  4375. * Get the category type
  4376. *
  4377. * @return string|null
  4378. */
  4379. public function get_type()
  4380. {
  4381. return $this->type;
  4382. }
  4383. }
  4384. /**
  4385. * Content-type sniffing
  4386. *
  4387. * Based on the rules in http://tools.ietf.org/html/draft-abarth-mime-sniff-06
  4388. *
  4389. * This is used since we can't always trust Content-Type headers, and is based
  4390. * upon the HTML5 parsing rules.
  4391. *
  4392. *
  4393. * This class can be overloaded with {@see SimplePie::set_content_type_sniffer_class()}
  4394. *
  4395. * @package SimplePie
  4396. * @subpackage HTTP
  4397. */
  4398. class SimplePie_Content_Type_Sniffer
  4399. {
  4400. /**
  4401. * File object
  4402. *
  4403. * @var SimplePie_File
  4404. */
  4405. var $file;
  4406. /**
  4407. * Create an instance of the class with the input file
  4408. *
  4409. * @param SimplePie_Content_Type_Sniffer $file Input file
  4410. */
  4411. public function __construct($file)
  4412. {
  4413. $this->file = $file;
  4414. }
  4415. /**
  4416. * Get the Content-Type of the specified file
  4417. *
  4418. * @return string Actual Content-Type
  4419. */
  4420. public function get_type()
  4421. {
  4422. if (isset($this->file->headers['content-type']))
  4423. {
  4424. if (!isset($this->file->headers['content-encoding'])
  4425. && ($this->file->headers['content-type'] === 'text/plain'
  4426. || $this->file->headers['content-type'] === 'text/plain; charset=ISO-8859-1'
  4427. || $this->file->headers['content-type'] === 'text/plain; charset=iso-8859-1'
  4428. || $this->file->headers['content-type'] === 'text/plain; charset=UTF-8'))
  4429. {
  4430. return $this->text_or_binary();
  4431. }
  4432. if (($pos = strpos($this->file->headers['content-type'], ';')) !== false)
  4433. {
  4434. $official = substr($this->file->headers['content-type'], 0, $pos);
  4435. }
  4436. else
  4437. {
  4438. $official = $this->file->headers['content-type'];
  4439. }
  4440. $official = trim(strtolower($official));
  4441. if ($official === 'unknown/unknown'
  4442. || $official === 'application/unknown')
  4443. {
  4444. return $this->unknown();
  4445. }
  4446. elseif (substr($official, -4) === '+xml'
  4447. || $official === 'text/xml'
  4448. || $official === 'application/xml')
  4449. {
  4450. return $official;
  4451. }
  4452. elseif (substr($official, 0, 6) === 'image/')
  4453. {
  4454. if ($return = $this->image())
  4455. {
  4456. return $return;
  4457. }
  4458. return $official;
  4459. }
  4460. elseif ($official === 'text/html')
  4461. {
  4462. return $this->feed_or_html();
  4463. }
  4464. return $official;
  4465. }
  4466. return $this->unknown();
  4467. }
  4468. /**
  4469. * Sniff text or binary
  4470. *
  4471. * @return string Actual Content-Type
  4472. */
  4473. public function text_or_binary()
  4474. {
  4475. if (substr($this->file->body, 0, 2) === "\xFE\xFF"
  4476. || substr($this->file->body, 0, 2) === "\xFF\xFE"
  4477. || substr($this->file->body, 0, 4) === "\x00\x00\xFE\xFF"
  4478. || substr($this->file->body, 0, 3) === "\xEF\xBB\xBF")
  4479. {
  4480. return 'text/plain';
  4481. }
  4482. elseif (preg_match('/[\x00-\x08\x0E-\x1A\x1C-\x1F]/', $this->file->body))
  4483. {
  4484. return 'application/octect-stream';
  4485. }
  4486. return 'text/plain';
  4487. }
  4488. /**
  4489. * Sniff unknown
  4490. *
  4491. * @return string Actual Content-Type
  4492. */
  4493. public function unknown()
  4494. {
  4495. $ws = strspn($this->file->body, "\x09\x0A\x0B\x0C\x0D\x20");
  4496. if (strtolower(substr($this->file->body, $ws, 14)) === '<!doctype html'
  4497. || strtolower(substr($this->file->body, $ws, 5)) === '<html'
  4498. || strtolower(substr($this->file->body, $ws, 7)) === '<script')
  4499. {
  4500. return 'text/html';
  4501. }
  4502. elseif (substr($this->file->body, 0, 5) === '%PDF-')
  4503. {
  4504. return 'application/pdf';
  4505. }
  4506. elseif (substr($this->file->body, 0, 11) === '%!PS-Adobe-')
  4507. {
  4508. return 'application/postscript';
  4509. }
  4510. elseif (substr($this->file->body, 0, 6) === 'GIF87a'
  4511. || substr($this->file->body, 0, 6) === 'GIF89a')
  4512. {
  4513. return 'image/gif';
  4514. }
  4515. elseif (substr($this->file->body, 0, 8) === "\x89\x50\x4E\x47\x0D\x0A\x1A\x0A")
  4516. {
  4517. return 'image/png';
  4518. }
  4519. elseif (substr($this->file->body, 0, 3) === "\xFF\xD8\xFF")
  4520. {
  4521. return 'image/jpeg';
  4522. }
  4523. elseif (substr($this->file->body, 0, 2) === "\x42\x4D")
  4524. {
  4525. return 'image/bmp';
  4526. }
  4527. elseif (substr($this->file->body, 0, 4) === "\x00\x00\x01\x00")
  4528. {
  4529. return 'image/vnd.microsoft.icon';
  4530. }
  4531. return $this->text_or_binary();
  4532. }
  4533. /**
  4534. * Sniff images
  4535. *
  4536. * @return string Actual Content-Type
  4537. */
  4538. public function image()
  4539. {
  4540. if (substr($this->file->body, 0, 6) === 'GIF87a'
  4541. || substr($this->file->body, 0, 6) === 'GIF89a')
  4542. {
  4543. return 'image/gif';
  4544. }
  4545. elseif (substr($this->file->body, 0, 8) === "\x89\x50\x4E\x47\x0D\x0A\x1A\x0A")
  4546. {
  4547. return 'image/png';
  4548. }
  4549. elseif (substr($this->file->body, 0, 3) === "\xFF\xD8\xFF")
  4550. {
  4551. return 'image/jpeg';
  4552. }
  4553. elseif (substr($this->file->body, 0, 2) === "\x42\x4D")
  4554. {
  4555. return 'image/bmp';
  4556. }
  4557. elseif (substr($this->file->body, 0, 4) === "\x00\x00\x01\x00")
  4558. {
  4559. return 'image/vnd.microsoft.icon';
  4560. }
  4561. return false;
  4562. }
  4563. /**
  4564. * Sniff HTML
  4565. *
  4566. * @return string Actual Content-Type
  4567. */
  4568. public function feed_or_html()
  4569. {
  4570. $len = strlen($this->file->body);
  4571. $pos = strspn($this->file->body, "\x09\x0A\x0D\x20\xEF\xBB\xBF");
  4572. while ($pos < $len)
  4573. {
  4574. switch ($this->file->body[$pos])
  4575. {
  4576. case "\x09":
  4577. case "\x0A":
  4578. case "\x0D":
  4579. case "\x20":
  4580. $pos += strspn($this->file->body, "\x09\x0A\x0D\x20", $pos);
  4581. continue 2;
  4582. case '<':
  4583. $pos++;
  4584. break;
  4585. default:
  4586. return 'text/html';
  4587. }
  4588. if (substr($this->file->body, $pos, 3) === '!--')
  4589. {
  4590. $pos += 3;
  4591. if ($pos < $len && ($pos = strpos($this->file->body, '-->', $pos)) !== false)
  4592. {
  4593. $pos += 3;
  4594. }
  4595. else
  4596. {
  4597. return 'text/html';
  4598. }
  4599. }
  4600. elseif (substr($this->file->body, $pos, 1) === '!')
  4601. {
  4602. if ($pos < $len && ($pos = strpos($this->file->body, '>', $pos)) !== false)
  4603. {
  4604. $pos++;
  4605. }
  4606. else
  4607. {
  4608. return 'text/html';
  4609. }
  4610. }
  4611. elseif (substr($this->file->body, $pos, 1) === '?')
  4612. {
  4613. if ($pos < $len && ($pos = strpos($this->file->body, '?>', $pos)) !== false)
  4614. {
  4615. $pos += 2;
  4616. }
  4617. else
  4618. {
  4619. return 'text/html';
  4620. }
  4621. }
  4622. elseif (substr($this->file->body, $pos, 3) === 'rss'
  4623. || substr($this->file->body, $pos, 7) === 'rdf:RDF')
  4624. {
  4625. return 'application/rss+xml';
  4626. }
  4627. elseif (substr($this->file->body, $pos, 4) === 'feed')
  4628. {
  4629. return 'application/atom+xml';
  4630. }
  4631. else
  4632. {
  4633. return 'text/html';
  4634. }
  4635. }
  4636. return 'text/html';
  4637. }
  4638. }
  4639. /**
  4640. * Manages `<media:copyright>` copyright tags as defined in Media RSS
  4641. *
  4642. * Used by {@see SimplePie_Enclosure::get_copyright()}
  4643. *
  4644. * This class can be overloaded with {@see SimplePie::set_copyright_class()}
  4645. *
  4646. * @package SimplePie
  4647. * @subpackage API
  4648. */
  4649. class SimplePie_Copyright
  4650. {
  4651. /**
  4652. * Copyright URL
  4653. *
  4654. * @var string
  4655. * @see get_url()
  4656. */
  4657. var $url;
  4658. /**
  4659. * Attribution
  4660. *
  4661. * @var string
  4662. * @see get_attribution()
  4663. */
  4664. var $label;
  4665. /**
  4666. * Constructor, used to input the data
  4667. *
  4668. * For documentation on all the parameters, see the corresponding
  4669. * properties and their accessors
  4670. */
  4671. public function __construct($url = null, $label = null)
  4672. {
  4673. $this->url = $url;
  4674. $this->label = $label;
  4675. }
  4676. /**
  4677. * String-ified version
  4678. *
  4679. * @return string
  4680. */
  4681. public function __toString()
  4682. {
  4683. // There is no $this->data here
  4684. return md5(serialize($this));
  4685. }
  4686. /**
  4687. * Get the copyright URL
  4688. *
  4689. * @return string|null URL to copyright information
  4690. */
  4691. public function get_url()
  4692. {
  4693. if ($this->url !== null)
  4694. {
  4695. return $this->url;
  4696. }
  4697. return null;
  4698. }
  4699. /**
  4700. * Get the attribution text
  4701. *
  4702. * @return string|null
  4703. */
  4704. public function get_attribution()
  4705. {
  4706. if ($this->label !== null)
  4707. {
  4708. return $this->label;
  4709. }
  4710. return null;
  4711. }
  4712. }
  4713. /**
  4714. * SimplePie class.
  4715. *
  4716. * Class for backward compatibility.
  4717. *
  4718. * @deprecated Use {@see SimplePie} directly
  4719. * @package SimplePie
  4720. * @subpackage API
  4721. */
  4722. class SimplePie_Core extends SimplePie
  4723. {
  4724. }
  4725. /**
  4726. * Handles `<media:credit>` as defined in Media RSS
  4727. *
  4728. * Used by {@see SimplePie_Enclosure::get_credit()} and {@see SimplePie_Enclosure::get_credits()}
  4729. *
  4730. * This class can be overloaded with {@see SimplePie::set_credit_class()}
  4731. *
  4732. * @package SimplePie
  4733. * @subpackage API
  4734. */
  4735. class SimplePie_Credit
  4736. {
  4737. /**
  4738. * Credited role
  4739. *
  4740. * @var string
  4741. * @see get_role()
  4742. */
  4743. var $role;
  4744. /**
  4745. * Organizational scheme
  4746. *
  4747. * @var string
  4748. * @see get_scheme()
  4749. */
  4750. var $scheme;
  4751. /**
  4752. * Credited name
  4753. *
  4754. * @var string
  4755. * @see get_name()
  4756. */
  4757. var $name;
  4758. /**
  4759. * Constructor, used to input the data
  4760. *
  4761. * For documentation on all the parameters, see the corresponding
  4762. * properties and their accessors
  4763. */
  4764. public function __construct($role = null, $scheme = null, $name = null)
  4765. {
  4766. $this->role = $role;
  4767. $this->scheme = $scheme;
  4768. $this->name = $name;
  4769. }
  4770. /**
  4771. * String-ified version
  4772. *
  4773. * @return string
  4774. */
  4775. public function __toString()
  4776. {
  4777. // There is no $this->data here
  4778. return md5(serialize($this));
  4779. }
  4780. /**
  4781. * Get the role of the person receiving credit
  4782. *
  4783. * @return string|null
  4784. */
  4785. public function get_role()
  4786. {
  4787. if ($this->role !== null)
  4788. {
  4789. return $this->role;
  4790. }
  4791. return null;
  4792. }
  4793. /**
  4794. * Get the organizational scheme
  4795. *
  4796. * @return string|null
  4797. */
  4798. public function get_scheme()
  4799. {
  4800. if ($this->scheme !== null)
  4801. {
  4802. return $this->scheme;
  4803. }
  4804. return null;
  4805. }
  4806. /**
  4807. * Get the credited person/entity's name
  4808. *
  4809. * @return string|null
  4810. */
  4811. public function get_name()
  4812. {
  4813. if ($this->name !== null)
  4814. {
  4815. return $this->name;
  4816. }
  4817. return null;
  4818. }
  4819. }
  4820. /**
  4821. * Decode HTML Entities
  4822. *
  4823. * This implements HTML5 as of revision 967 (2007-06-28)
  4824. *
  4825. * @deprecated Use DOMDocument instead!
  4826. * @package SimplePie
  4827. */
  4828. class SimplePie_Decode_HTML_Entities
  4829. {
  4830. /**
  4831. * Data to be parsed
  4832. *
  4833. * @access private
  4834. * @var string
  4835. */
  4836. var $data = '';
  4837. /**
  4838. * Currently consumed bytes
  4839. *
  4840. * @access private
  4841. * @var string
  4842. */
  4843. var $consumed = '';
  4844. /**
  4845. * Position of the current byte being parsed
  4846. *
  4847. * @access private
  4848. * @var int
  4849. */
  4850. var $position = 0;
  4851. /**
  4852. * Create an instance of the class with the input data
  4853. *
  4854. * @access public
  4855. * @param string $data Input data
  4856. */
  4857. public function __construct($data)
  4858. {
  4859. $this->data = $data;
  4860. }
  4861. /**
  4862. * Parse the input data
  4863. *
  4864. * @access public
  4865. * @return string Output data
  4866. */
  4867. public function parse()
  4868. {
  4869. while (($this->position = strpos($this->data, '&', $this->position)) !== false)
  4870. {
  4871. $this->consume();
  4872. $this->entity();
  4873. $this->consumed = '';
  4874. }
  4875. return $this->data;
  4876. }
  4877. /**
  4878. * Consume the next byte
  4879. *
  4880. * @access private
  4881. * @return mixed The next byte, or false, if there is no more data
  4882. */
  4883. public function consume()
  4884. {
  4885. if (isset($this->data[$this->position]))
  4886. {
  4887. $this->consumed .= $this->data[$this->position];
  4888. return $this->data[$this->position++];
  4889. }
  4890. return false;
  4891. }
  4892. /**
  4893. * Consume a range of characters
  4894. *
  4895. * @access private
  4896. * @param string $chars Characters to consume
  4897. * @return mixed A series of characters that match the range, or false
  4898. */
  4899. public function consume_range($chars)
  4900. {
  4901. if ($len = strspn($this->data, $chars, $this->position))
  4902. {
  4903. $data = substr($this->data, $this->position, $len);
  4904. $this->consumed .= $data;
  4905. $this->position += $len;
  4906. return $data;
  4907. }
  4908. return false;
  4909. }
  4910. /**
  4911. * Unconsume one byte
  4912. *
  4913. * @access private
  4914. */
  4915. public function unconsume()
  4916. {
  4917. $this->consumed = substr($this->consumed, 0, -1);
  4918. $this->position--;
  4919. }
  4920. /**
  4921. * Decode an entity
  4922. *
  4923. * @access private
  4924. */
  4925. public function entity()
  4926. {
  4927. switch ($this->consume())
  4928. {
  4929. case "\x09":
  4930. case "\x0A":
  4931. case "\x0B":
  4932. case "\x0C":
  4933. case "\x20":
  4934. case "\x3C":
  4935. case "\x26":
  4936. case false:
  4937. break;
  4938. case "\x23":
  4939. switch ($this->consume())
  4940. {
  4941. case "\x78":
  4942. case "\x58":
  4943. $range = '0123456789ABCDEFabcdef';
  4944. $hex = true;
  4945. break;
  4946. default:
  4947. $range = '0123456789';
  4948. $hex = false;
  4949. $this->unconsume();
  4950. break;
  4951. }
  4952. if ($codepoint = $this->consume_range($range))
  4953. {
  4954. static $windows_1252_specials = array(0x0D => "\x0A", 0x80 => "\xE2\x82\xAC", 0x81 => "\xEF\xBF\xBD", 0x82 => "\xE2\x80\x9A", 0x83 => "\xC6\x92", 0x84 => "\xE2\x80\x9E", 0x85 => "\xE2\x80\xA6", 0x86 => "\xE2\x80\xA0", 0x87 => "\xE2\x80\xA1", 0x88 => "\xCB\x86", 0x89 => "\xE2\x80\xB0", 0x8A => "\xC5\xA0", 0x8B => "\xE2\x80\xB9", 0x8C => "\xC5\x92", 0x8D => "\xEF\xBF\xBD", 0x8E => "\xC5\xBD", 0x8F => "\xEF\xBF\xBD", 0x90 => "\xEF\xBF\xBD", 0x91 => "\xE2\x80\x98", 0x92 => "\xE2\x80\x99", 0x93 => "\xE2\x80\x9C", 0x94 => "\xE2\x80\x9D", 0x95 => "\xE2\x80\xA2", 0x96 => "\xE2\x80\x93", 0x97 => "\xE2\x80\x94", 0x98 => "\xCB\x9C", 0x99 => "\xE2\x84\xA2", 0x9A => "\xC5\xA1", 0x9B => "\xE2\x80\xBA", 0x9C => "\xC5\x93", 0x9D => "\xEF\xBF\xBD", 0x9E => "\xC5\xBE", 0x9F => "\xC5\xB8");
  4955. if ($hex)
  4956. {
  4957. $codepoint = hexdec($codepoint);
  4958. }
  4959. else
  4960. {
  4961. $codepoint = intval($codepoint);
  4962. }
  4963. if (isset($windows_1252_specials[$codepoint]))
  4964. {
  4965. $replacement = $windows_1252_specials[$codepoint];
  4966. }
  4967. else
  4968. {
  4969. $replacement = SimplePie_Misc::codepoint_to_utf8($codepoint);
  4970. }
  4971. if (!in_array($this->consume(), array(';', false), true))
  4972. {
  4973. $this->unconsume();
  4974. }
  4975. $consumed_length = strlen($this->consumed);
  4976. $this->data = substr_replace($this->data, $replacement, $this->position - $consumed_length, $consumed_length);
  4977. $this->position += strlen($replacement) - $consumed_length;
  4978. }
  4979. break;
  4980. default:
  4981. static $entities = array(
  4982. 'Aacute' => "\xC3\x81",
  4983. 'aacute' => "\xC3\xA1",
  4984. 'Aacute;' => "\xC3\x81",
  4985. 'aacute;' => "\xC3\xA1",
  4986. 'Acirc' => "\xC3\x82",
  4987. 'acirc' => "\xC3\xA2",
  4988. 'Acirc;' => "\xC3\x82",
  4989. 'acirc;' => "\xC3\xA2",
  4990. 'acute' => "\xC2\xB4",
  4991. 'acute;' => "\xC2\xB4",
  4992. 'AElig' => "\xC3\x86",
  4993. 'aelig' => "\xC3\xA6",
  4994. 'AElig;' => "\xC3\x86",
  4995. 'aelig;' => "\xC3\xA6",
  4996. 'Agrave' => "\xC3\x80",
  4997. 'agrave' => "\xC3\xA0",
  4998. 'Agrave;' => "\xC3\x80",
  4999. 'agrave;' => "\xC3\xA0",
  5000. 'alefsym;' => "\xE2\x84\xB5",
  5001. 'Alpha;' => "\xCE\x91",
  5002. 'alpha;' => "\xCE\xB1",
  5003. 'AMP' => "\x26",
  5004. 'amp' => "\x26",
  5005. 'AMP;' => "\x26",
  5006. 'amp;' => "\x26",
  5007. 'and;' => "\xE2\x88\xA7",
  5008. 'ang;' => "\xE2\x88\xA0",
  5009. 'apos;' => "\x27",
  5010. 'Aring' => "\xC3\x85",
  5011. 'aring' => "\xC3\xA5",
  5012. 'Aring;' => "\xC3\x85",
  5013. 'aring;' => "\xC3\xA5",
  5014. 'asymp;' => "\xE2\x89\x88",
  5015. 'Atilde' => "\xC3\x83",
  5016. 'atilde' => "\xC3\xA3",
  5017. 'Atilde;' => "\xC3\x83",
  5018. 'atilde;' => "\xC3\xA3",
  5019. 'Auml' => "\xC3\x84",
  5020. 'auml' => "\xC3\xA4",
  5021. 'Auml;' => "\xC3\x84",
  5022. 'auml;' => "\xC3\xA4",
  5023. 'bdquo;' => "\xE2\x80\x9E",
  5024. 'Beta;' => "\xCE\x92",
  5025. 'beta;' => "\xCE\xB2",
  5026. 'brvbar' => "\xC2\xA6",
  5027. 'brvbar;' => "\xC2\xA6",
  5028. 'bull;' => "\xE2\x80\xA2",
  5029. 'cap;' => "\xE2\x88\xA9",
  5030. 'Ccedil' => "\xC3\x87",
  5031. 'ccedil' => "\xC3\xA7",
  5032. 'Ccedil;' => "\xC3\x87",
  5033. 'ccedil;' => "\xC3\xA7",
  5034. 'cedil' => "\xC2\xB8",
  5035. 'cedil;' => "\xC2\xB8",
  5036. 'cent' => "\xC2\xA2",
  5037. 'cent;' => "\xC2\xA2",
  5038. 'Chi;' => "\xCE\xA7",
  5039. 'chi;' => "\xCF\x87",
  5040. 'circ;' => "\xCB\x86",
  5041. 'clubs;' => "\xE2\x99\xA3",
  5042. 'cong;' => "\xE2\x89\x85",
  5043. 'COPY' => "\xC2\xA9",
  5044. 'copy' => "\xC2\xA9",
  5045. 'COPY;' => "\xC2\xA9",
  5046. 'copy;' => "\xC2\xA9",
  5047. 'crarr;' => "\xE2\x86\xB5",
  5048. 'cup;' => "\xE2\x88\xAA",
  5049. 'curren' => "\xC2\xA4",
  5050. 'curren;' => "\xC2\xA4",
  5051. 'Dagger;' => "\xE2\x80\xA1",
  5052. 'dagger;' => "\xE2\x80\xA0",
  5053. 'dArr;' => "\xE2\x87\x93",
  5054. 'darr;' => "\xE2\x86\x93",
  5055. 'deg' => "\xC2\xB0",
  5056. 'deg;' => "\xC2\xB0",
  5057. 'Delta;' => "\xCE\x94",
  5058. 'delta;' => "\xCE\xB4",
  5059. 'diams;' => "\xE2\x99\xA6",
  5060. 'divide' => "\xC3\xB7",
  5061. 'divide;' => "\xC3\xB7",
  5062. 'Eacute' => "\xC3\x89",
  5063. 'eacute' => "\xC3\xA9",
  5064. 'Eacute;' => "\xC3\x89",
  5065. 'eacute;' => "\xC3\xA9",
  5066. 'Ecirc' => "\xC3\x8A",
  5067. 'ecirc' => "\xC3\xAA",
  5068. 'Ecirc;' => "\xC3\x8A",
  5069. 'ecirc;' => "\xC3\xAA",
  5070. 'Egrave' => "\xC3\x88",
  5071. 'egrave' => "\xC3\xA8",
  5072. 'Egrave;' => "\xC3\x88",
  5073. 'egrave;' => "\xC3\xA8",
  5074. 'empty;' => "\xE2\x88\x85",
  5075. 'emsp;' => "\xE2\x80\x83",
  5076. 'ensp;' => "\xE2\x80\x82",
  5077. 'Epsilon;' => "\xCE\x95",
  5078. 'epsilon;' => "\xCE\xB5",
  5079. 'equiv;' => "\xE2\x89\xA1",
  5080. 'Eta;' => "\xCE\x97",
  5081. 'eta;' => "\xCE\xB7",
  5082. 'ETH' => "\xC3\x90",
  5083. 'eth' => "\xC3\xB0",
  5084. 'ETH;' => "\xC3\x90",
  5085. 'eth;' => "\xC3\xB0",
  5086. 'Euml' => "\xC3\x8B",
  5087. 'euml' => "\xC3\xAB",
  5088. 'Euml;' => "\xC3\x8B",
  5089. 'euml;' => "\xC3\xAB",
  5090. 'euro;' => "\xE2\x82\xAC",
  5091. 'exist;' => "\xE2\x88\x83",
  5092. 'fnof;' => "\xC6\x92",
  5093. 'forall;' => "\xE2\x88\x80",
  5094. 'frac12' => "\xC2\xBD",
  5095. 'frac12;' => "\xC2\xBD",
  5096. 'frac14' => "\xC2\xBC",
  5097. 'frac14;' => "\xC2\xBC",
  5098. 'frac34' => "\xC2\xBE",
  5099. 'frac34;' => "\xC2\xBE",
  5100. 'frasl;' => "\xE2\x81\x84",
  5101. 'Gamma;' => "\xCE\x93",
  5102. 'gamma;' => "\xCE\xB3",
  5103. 'ge;' => "\xE2\x89\xA5",
  5104. 'GT' => "\x3E",
  5105. 'gt' => "\x3E",
  5106. 'GT;' => "\x3E",
  5107. 'gt;' => "\x3E",
  5108. 'hArr;' => "\xE2\x87\x94",
  5109. 'harr;' => "\xE2\x86\x94",
  5110. 'hearts;' => "\xE2\x99\xA5",
  5111. 'hellip;' => "\xE2\x80\xA6",
  5112. 'Iacute' => "\xC3\x8D",
  5113. 'iacute' => "\xC3\xAD",
  5114. 'Iacute;' => "\xC3\x8D",
  5115. 'iacute;' => "\xC3\xAD",
  5116. 'Icirc' => "\xC3\x8E",
  5117. 'icirc' => "\xC3\xAE",
  5118. 'Icirc;' => "\xC3\x8E",
  5119. 'icirc;' => "\xC3\xAE",
  5120. 'iexcl' => "\xC2\xA1",
  5121. 'iexcl;' => "\xC2\xA1",
  5122. 'Igrave' => "\xC3\x8C",
  5123. 'igrave' => "\xC3\xAC",
  5124. 'Igrave;' => "\xC3\x8C",
  5125. 'igrave;' => "\xC3\xAC",
  5126. 'image;' => "\xE2\x84\x91",
  5127. 'infin;' => "\xE2\x88\x9E",
  5128. 'int;' => "\xE2\x88\xAB",
  5129. 'Iota;' => "\xCE\x99",
  5130. 'iota;' => "\xCE\xB9",
  5131. 'iquest' => "\xC2\xBF",
  5132. 'iquest;' => "\xC2\xBF",
  5133. 'isin;' => "\xE2\x88\x88",
  5134. 'Iuml' => "\xC3\x8F",
  5135. 'iuml' => "\xC3\xAF",
  5136. 'Iuml;' => "\xC3\x8F",
  5137. 'iuml;' => "\xC3\xAF",
  5138. 'Kappa;' => "\xCE\x9A",
  5139. 'kappa;' => "\xCE\xBA",
  5140. 'Lambda;' => "\xCE\x9B",
  5141. 'lambda;' => "\xCE\xBB",
  5142. 'lang;' => "\xE3\x80\x88",
  5143. 'laquo' => "\xC2\xAB",
  5144. 'laquo;' => "\xC2\xAB",
  5145. 'lArr;' => "\xE2\x87\x90",
  5146. 'larr;' => "\xE2\x86\x90",
  5147. 'lceil;' => "\xE2\x8C\x88",
  5148. 'ldquo;' => "\xE2\x80\x9C",
  5149. 'le;' => "\xE2\x89\xA4",
  5150. 'lfloor;' => "\xE2\x8C\x8A",
  5151. 'lowast;' => "\xE2\x88\x97",
  5152. 'loz;' => "\xE2\x97\x8A",
  5153. 'lrm;' => "\xE2\x80\x8E",
  5154. 'lsaquo;' => "\xE2\x80\xB9",
  5155. 'lsquo;' => "\xE2\x80\x98",
  5156. 'LT' => "\x3C",
  5157. 'lt' => "\x3C",
  5158. 'LT;' => "\x3C",
  5159. 'lt;' => "\x3C",
  5160. 'macr' => "\xC2\xAF",
  5161. 'macr;' => "\xC2\xAF",
  5162. 'mdash;' => "\xE2\x80\x94",
  5163. 'micro' => "\xC2\xB5",
  5164. 'micro;' => "\xC2\xB5",
  5165. 'middot' => "\xC2\xB7",
  5166. 'middot;' => "\xC2\xB7",
  5167. 'minus;' => "\xE2\x88\x92",
  5168. 'Mu;' => "\xCE\x9C",
  5169. 'mu;' => "\xCE\xBC",
  5170. 'nabla;' => "\xE2\x88\x87",
  5171. 'nbsp' => "\xC2\xA0",
  5172. 'nbsp;' => "\xC2\xA0",
  5173. 'ndash;' => "\xE2\x80\x93",
  5174. 'ne;' => "\xE2\x89\xA0",
  5175. 'ni;' => "\xE2\x88\x8B",
  5176. 'not' => "\xC2\xAC",
  5177. 'not;' => "\xC2\xAC",
  5178. 'notin;' => "\xE2\x88\x89",
  5179. 'nsub;' => "\xE2\x8A\x84",
  5180. 'Ntilde' => "\xC3\x91",
  5181. 'ntilde' => "\xC3\xB1",
  5182. 'Ntilde;' => "\xC3\x91",
  5183. 'ntilde;' => "\xC3\xB1",
  5184. 'Nu;' => "\xCE\x9D",
  5185. 'nu;' => "\xCE\xBD",
  5186. 'Oacute' => "\xC3\x93",
  5187. 'oacute' => "\xC3\xB3",
  5188. 'Oacute;' => "\xC3\x93",
  5189. 'oacute;' => "\xC3\xB3",
  5190. 'Ocirc' => "\xC3\x94",
  5191. 'ocirc' => "\xC3\xB4",
  5192. 'Ocirc;' => "\xC3\x94",
  5193. 'ocirc;' => "\xC3\xB4",
  5194. 'OElig;' => "\xC5\x92",
  5195. 'oelig;' => "\xC5\x93",
  5196. 'Ograve' => "\xC3\x92",
  5197. 'ograve' => "\xC3\xB2",
  5198. 'Ograve;' => "\xC3\x92",
  5199. 'ograve;' => "\xC3\xB2",
  5200. 'oline;' => "\xE2\x80\xBE",
  5201. 'Omega;' => "\xCE\xA9",
  5202. 'omega;' => "\xCF\x89",
  5203. 'Omicron;' => "\xCE\x9F",
  5204. 'omicron;' => "\xCE\xBF",
  5205. 'oplus;' => "\xE2\x8A\x95",
  5206. 'or;' => "\xE2\x88\xA8",
  5207. 'ordf' => "\xC2\xAA",
  5208. 'ordf;' => "\xC2\xAA",
  5209. 'ordm' => "\xC2\xBA",
  5210. 'ordm;' => "\xC2\xBA",
  5211. 'Oslash' => "\xC3\x98",
  5212. 'oslash' => "\xC3\xB8",
  5213. 'Oslash;' => "\xC3\x98",
  5214. 'oslash;' => "\xC3\xB8",
  5215. 'Otilde' => "\xC3\x95",
  5216. 'otilde' => "\xC3\xB5",
  5217. 'Otilde;' => "\xC3\x95",
  5218. 'otilde;' => "\xC3\xB5",
  5219. 'otimes;' => "\xE2\x8A\x97",
  5220. 'Ouml' => "\xC3\x96",
  5221. 'ouml' => "\xC3\xB6",
  5222. 'Ouml;' => "\xC3\x96",
  5223. 'ouml;' => "\xC3\xB6",
  5224. 'para' => "\xC2\xB6",
  5225. 'para;' => "\xC2\xB6",
  5226. 'part;' => "\xE2\x88\x82",
  5227. 'permil;' => "\xE2\x80\xB0",
  5228. 'perp;' => "\xE2\x8A\xA5",
  5229. 'Phi;' => "\xCE\xA6",
  5230. 'phi;' => "\xCF\x86",
  5231. 'Pi;' => "\xCE\xA0",
  5232. 'pi;' => "\xCF\x80",
  5233. 'piv;' => "\xCF\x96",
  5234. 'plusmn' => "\xC2\xB1",
  5235. 'plusmn;' => "\xC2\xB1",
  5236. 'pound' => "\xC2\xA3",
  5237. 'pound;' => "\xC2\xA3",
  5238. 'Prime;' => "\xE2\x80\xB3",
  5239. 'prime;' => "\xE2\x80\xB2",
  5240. 'prod;' => "\xE2\x88\x8F",
  5241. 'prop;' => "\xE2\x88\x9D",
  5242. 'Psi;' => "\xCE\xA8",
  5243. 'psi;' => "\xCF\x88",
  5244. 'QUOT' => "\x22",
  5245. 'quot' => "\x22",
  5246. 'QUOT;' => "\x22",
  5247. 'quot;' => "\x22",
  5248. 'radic;' => "\xE2\x88\x9A",
  5249. 'rang;' => "\xE3\x80\x89",
  5250. 'raquo' => "\xC2\xBB",
  5251. 'raquo;' => "\xC2\xBB",
  5252. 'rArr;' => "\xE2\x87\x92",
  5253. 'rarr;' => "\xE2\x86\x92",
  5254. 'rceil;' => "\xE2\x8C\x89",
  5255. 'rdquo;' => "\xE2\x80\x9D",
  5256. 'real;' => "\xE2\x84\x9C",
  5257. 'REG' => "\xC2\xAE",
  5258. 'reg' => "\xC2\xAE",
  5259. 'REG;' => "\xC2\xAE",
  5260. 'reg;' => "\xC2\xAE",
  5261. 'rfloor;' => "\xE2\x8C\x8B",
  5262. 'Rho;' => "\xCE\xA1",
  5263. 'rho;' => "\xCF\x81",
  5264. 'rlm;' => "\xE2\x80\x8F",
  5265. 'rsaquo;' => "\xE2\x80\xBA",
  5266. 'rsquo;' => "\xE2\x80\x99",
  5267. 'sbquo;' => "\xE2\x80\x9A",
  5268. 'Scaron;' => "\xC5\xA0",
  5269. 'scaron;' => "\xC5\xA1",
  5270. 'sdot;' => "\xE2\x8B\x85",
  5271. 'sect' => "\xC2\xA7",
  5272. 'sect;' => "\xC2\xA7",
  5273. 'shy' => "\xC2\xAD",
  5274. 'shy;' => "\xC2\xAD",
  5275. 'Sigma;' => "\xCE\xA3",
  5276. 'sigma;' => "\xCF\x83",
  5277. 'sigmaf;' => "\xCF\x82",
  5278. 'sim;' => "\xE2\x88\xBC",
  5279. 'spades;' => "\xE2\x99\xA0",
  5280. 'sub;' => "\xE2\x8A\x82",
  5281. 'sube;' => "\xE2\x8A\x86",
  5282. 'sum;' => "\xE2\x88\x91",
  5283. 'sup;' => "\xE2\x8A\x83",
  5284. 'sup1' => "\xC2\xB9",
  5285. 'sup1;' => "\xC2\xB9",
  5286. 'sup2' => "\xC2\xB2",
  5287. 'sup2;' => "\xC2\xB2",
  5288. 'sup3' => "\xC2\xB3",
  5289. 'sup3;' => "\xC2\xB3",
  5290. 'supe;' => "\xE2\x8A\x87",
  5291. 'szlig' => "\xC3\x9F",
  5292. 'szlig;' => "\xC3\x9F",
  5293. 'Tau;' => "\xCE\xA4",
  5294. 'tau;' => "\xCF\x84",
  5295. 'there4;' => "\xE2\x88\xB4",
  5296. 'Theta;' => "\xCE\x98",
  5297. 'theta;' => "\xCE\xB8",
  5298. 'thetasym;' => "\xCF\x91",
  5299. 'thinsp;' => "\xE2\x80\x89",
  5300. 'THORN' => "\xC3\x9E",
  5301. 'thorn' => "\xC3\xBE",
  5302. 'THORN;' => "\xC3\x9E",
  5303. 'thorn;' => "\xC3\xBE",
  5304. 'tilde;' => "\xCB\x9C",
  5305. 'times' => "\xC3\x97",
  5306. 'times;' => "\xC3\x97",
  5307. 'TRADE;' => "\xE2\x84\xA2",
  5308. 'trade;' => "\xE2\x84\xA2",
  5309. 'Uacute' => "\xC3\x9A",
  5310. 'uacute' => "\xC3\xBA",
  5311. 'Uacute;' => "\xC3\x9A",
  5312. 'uacute;' => "\xC3\xBA",
  5313. 'uArr;' => "\xE2\x87\x91",
  5314. 'uarr;' => "\xE2\x86\x91",
  5315. 'Ucirc' => "\xC3\x9B",
  5316. 'ucirc' => "\xC3\xBB",
  5317. 'Ucirc;' => "\xC3\x9B",
  5318. 'ucirc;' => "\xC3\xBB",
  5319. 'Ugrave' => "\xC3\x99",
  5320. 'ugrave' => "\xC3\xB9",
  5321. 'Ugrave;' => "\xC3\x99",
  5322. 'ugrave;' => "\xC3\xB9",
  5323. 'uml' => "\xC2\xA8",
  5324. 'uml;' => "\xC2\xA8",
  5325. 'upsih;' => "\xCF\x92",
  5326. 'Upsilon;' => "\xCE\xA5",
  5327. 'upsilon;' => "\xCF\x85",
  5328. 'Uuml' => "\xC3\x9C",
  5329. 'uuml' => "\xC3\xBC",
  5330. 'Uuml;' => "\xC3\x9C",
  5331. 'uuml;' => "\xC3\xBC",
  5332. 'weierp;' => "\xE2\x84\x98",
  5333. 'Xi;' => "\xCE\x9E",
  5334. 'xi;' => "\xCE\xBE",
  5335. 'Yacute' => "\xC3\x9D",
  5336. 'yacute' => "\xC3\xBD",
  5337. 'Yacute;' => "\xC3\x9D",
  5338. 'yacute;' => "\xC3\xBD",
  5339. 'yen' => "\xC2\xA5",
  5340. 'yen;' => "\xC2\xA5",
  5341. 'yuml' => "\xC3\xBF",
  5342. 'Yuml;' => "\xC5\xB8",
  5343. 'yuml;' => "\xC3\xBF",
  5344. 'Zeta;' => "\xCE\x96",
  5345. 'zeta;' => "\xCE\xB6",
  5346. 'zwj;' => "\xE2\x80\x8D",
  5347. 'zwnj;' => "\xE2\x80\x8C"
  5348. );
  5349. for ($i = 0, $match = null; $i < 9 && $this->consume() !== false; $i++)
  5350. {
  5351. $consumed = substr($this->consumed, 1);
  5352. if (isset($entities[$consumed]))
  5353. {
  5354. $match = $consumed;
  5355. }
  5356. }
  5357. if ($match !== null)
  5358. {
  5359. $this->data = substr_replace($this->data, $entities[$match], $this->position - strlen($consumed) - 1, strlen($match) + 1);
  5360. $this->position += strlen($entities[$match]) - strlen($consumed) - 1;
  5361. }
  5362. break;
  5363. }
  5364. }
  5365. }
  5366. /**
  5367. * Handles everything related to enclosures (including Media RSS and iTunes RSS)
  5368. *
  5369. * Used by {@see SimplePie_Item::get_enclosure()} and {@see SimplePie_Item::get_enclosures()}
  5370. *
  5371. * This class can be overloaded with {@see SimplePie::set_enclosure_class()}
  5372. *
  5373. * @package SimplePie
  5374. * @subpackage API
  5375. */
  5376. class SimplePie_Enclosure
  5377. {
  5378. /**
  5379. * @var string
  5380. * @see get_bitrate()
  5381. */
  5382. var $bitrate;
  5383. /**
  5384. * @var array
  5385. * @see get_captions()
  5386. */
  5387. var $captions;
  5388. /**
  5389. * @var array
  5390. * @see get_categories()
  5391. */
  5392. var $categories;
  5393. /**
  5394. * @var int
  5395. * @see get_channels()
  5396. */
  5397. var $channels;
  5398. /**
  5399. * @var SimplePie_Copyright
  5400. * @see get_copyright()
  5401. */
  5402. var $copyright;
  5403. /**
  5404. * @var array
  5405. * @see get_credits()
  5406. */
  5407. var $credits;
  5408. /**
  5409. * @var string
  5410. * @see get_description()
  5411. */
  5412. var $description;
  5413. /**
  5414. * @var int
  5415. * @see get_duration()
  5416. */
  5417. var $duration;
  5418. /**
  5419. * @var string
  5420. * @see get_expression()
  5421. */
  5422. var $expression;
  5423. /**
  5424. * @var string
  5425. * @see get_framerate()
  5426. */
  5427. var $framerate;
  5428. /**
  5429. * @var string
  5430. * @see get_handler()
  5431. */
  5432. var $handler;
  5433. /**
  5434. * @var array
  5435. * @see get_hashes()
  5436. */
  5437. var $hashes;
  5438. /**
  5439. * @var string
  5440. * @see get_height()
  5441. */
  5442. var $height;
  5443. /**
  5444. * @deprecated
  5445. * @var null
  5446. */
  5447. var $javascript;
  5448. /**
  5449. * @var array
  5450. * @see get_keywords()
  5451. */
  5452. var $keywords;
  5453. /**
  5454. * @var string
  5455. * @see get_language()
  5456. */
  5457. var $lang;
  5458. /**
  5459. * @var string
  5460. * @see get_length()
  5461. */
  5462. var $length;
  5463. /**
  5464. * @var string
  5465. * @see get_link()
  5466. */
  5467. var $link;
  5468. /**
  5469. * @var string
  5470. * @see get_medium()
  5471. */
  5472. var $medium;
  5473. /**
  5474. * @var string
  5475. * @see get_player()
  5476. */
  5477. var $player;
  5478. /**
  5479. * @var array
  5480. * @see get_ratings()
  5481. */
  5482. var $ratings;
  5483. /**
  5484. * @var array
  5485. * @see get_restrictions()
  5486. */
  5487. var $restrictions;
  5488. /**
  5489. * @var string
  5490. * @see get_sampling_rate()
  5491. */
  5492. var $samplingrate;
  5493. /**
  5494. * @var array
  5495. * @see get_thumbnails()
  5496. */
  5497. var $thumbnails;
  5498. /**
  5499. * @var string
  5500. * @see get_title()
  5501. */
  5502. var $title;
  5503. /**
  5504. * @var string
  5505. * @see get_type()
  5506. */
  5507. var $type;
  5508. /**
  5509. * @var string
  5510. * @see get_width()
  5511. */
  5512. var $width;
  5513. /**
  5514. * Constructor, used to input the data
  5515. *
  5516. * For documentation on all the parameters, see the corresponding
  5517. * properties and their accessors
  5518. *
  5519. * @uses idna_convert If available, this will convert an IDN
  5520. */
  5521. public function __construct($link = null, $type = null, $length = null, $javascript = null, $bitrate = null, $captions = null, $categories = null, $channels = null, $copyright = null, $credits = null, $description = null, $duration = null, $expression = null, $framerate = null, $hashes = null, $height = null, $keywords = null, $lang = null, $medium = null, $player = null, $ratings = null, $restrictions = null, $samplingrate = null, $thumbnails = null, $title = null, $width = null)
  5522. {
  5523. $this->bitrate = $bitrate;
  5524. $this->captions = $captions;
  5525. $this->categories = $categories;
  5526. $this->channels = $channels;
  5527. $this->copyright = $copyright;
  5528. $this->credits = $credits;
  5529. $this->description = $description;
  5530. $this->duration = $duration;
  5531. $this->expression = $expression;
  5532. $this->framerate = $framerate;
  5533. $this->hashes = $hashes;
  5534. $this->height = $height;
  5535. $this->keywords = $keywords;
  5536. $this->lang = $lang;
  5537. $this->length = $length;
  5538. $this->link = $link;
  5539. $this->medium = $medium;
  5540. $this->player = $player;
  5541. $this->ratings = $ratings;
  5542. $this->restrictions = $restrictions;
  5543. $this->samplingrate = $samplingrate;
  5544. $this->thumbnails = $thumbnails;
  5545. $this->title = $title;
  5546. $this->type = $type;
  5547. $this->width = $width;
  5548. if (class_exists('idna_convert'))
  5549. {
  5550. $idn = new idna_convert();
  5551. $parsed = SimplePie_Misc::parse_url($link);
  5552. $this->link = SimplePie_Misc::compress_parse_url($parsed['scheme'], $idn->encode($parsed['authority']), $parsed['path'], $parsed['query'], $parsed['fragment']);
  5553. }
  5554. $this->handler = $this->get_handler(); // Needs to load last
  5555. }
  5556. /**
  5557. * String-ified version
  5558. *
  5559. * @return string
  5560. */
  5561. public function __toString()
  5562. {
  5563. // There is no $this->data here
  5564. return md5(serialize($this));
  5565. }
  5566. /**
  5567. * Get the bitrate
  5568. *
  5569. * @return string|null
  5570. */
  5571. public function get_bitrate()
  5572. {
  5573. if ($this->bitrate !== null)
  5574. {
  5575. return $this->bitrate;
  5576. }
  5577. return null;
  5578. }
  5579. /**
  5580. * Get a single caption
  5581. *
  5582. * @param int $key
  5583. * @return SimplePie_Caption|null
  5584. */
  5585. public function get_caption($key = 0)
  5586. {
  5587. $captions = $this->get_captions();
  5588. if (isset($captions[$key]))
  5589. {
  5590. return $captions[$key];
  5591. }
  5592. return null;
  5593. }
  5594. /**
  5595. * Get all captions
  5596. *
  5597. * @return array|null Array of {@see SimplePie_Caption} objects
  5598. */
  5599. public function get_captions()
  5600. {
  5601. if ($this->captions !== null)
  5602. {
  5603. return $this->captions;
  5604. }
  5605. return null;
  5606. }
  5607. /**
  5608. * Get a single category
  5609. *
  5610. * @param int $key
  5611. * @return SimplePie_Category|null
  5612. */
  5613. public function get_category($key = 0)
  5614. {
  5615. $categories = $this->get_categories();
  5616. if (isset($categories[$key]))
  5617. {
  5618. return $categories[$key];
  5619. }
  5620. return null;
  5621. }
  5622. /**
  5623. * Get all categories
  5624. *
  5625. * @return array|null Array of {@see SimplePie_Category} objects
  5626. */
  5627. public function get_categories()
  5628. {
  5629. if ($this->categories !== null)
  5630. {
  5631. return $this->categories;
  5632. }
  5633. return null;
  5634. }
  5635. /**
  5636. * Get the number of audio channels
  5637. *
  5638. * @return int|null
  5639. */
  5640. public function get_channels()
  5641. {
  5642. if ($this->channels !== null)
  5643. {
  5644. return $this->channels;
  5645. }
  5646. return null;
  5647. }
  5648. /**
  5649. * Get the copyright information
  5650. *
  5651. * @return SimplePie_Copyright|null
  5652. */
  5653. public function get_copyright()
  5654. {
  5655. if ($this->copyright !== null)
  5656. {
  5657. return $this->copyright;
  5658. }
  5659. return null;
  5660. }
  5661. /**
  5662. * Get a single credit
  5663. *
  5664. * @param int $key
  5665. * @return SimplePie_Credit|null
  5666. */
  5667. public function get_credit($key = 0)
  5668. {
  5669. $credits = $this->get_credits();
  5670. if (isset($credits[$key]))
  5671. {
  5672. return $credits[$key];
  5673. }
  5674. return null;
  5675. }
  5676. /**
  5677. * Get all credits
  5678. *
  5679. * @return array|null Array of {@see SimplePie_Credit} objects
  5680. */
  5681. public function get_credits()
  5682. {
  5683. if ($this->credits !== null)
  5684. {
  5685. return $this->credits;
  5686. }
  5687. return null;
  5688. }
  5689. /**
  5690. * Get the description of the enclosure
  5691. *
  5692. * @return string|null
  5693. */
  5694. public function get_description()
  5695. {
  5696. if ($this->description !== null)
  5697. {
  5698. return $this->description;
  5699. }
  5700. return null;
  5701. }
  5702. /**
  5703. * Get the duration of the enclosure
  5704. *
  5705. * @param bool $convert Convert seconds into hh:mm:ss
  5706. * @return string|int|null 'hh:mm:ss' string if `$convert` was specified, otherwise integer (or null if none found)
  5707. */
  5708. public function get_duration($convert = false)
  5709. {
  5710. if ($this->duration !== null)
  5711. {
  5712. if ($convert)
  5713. {
  5714. $time = SimplePie_Misc::time_hms($this->duration);
  5715. return $time;
  5716. }
  5717. return $this->duration;
  5718. }
  5719. return null;
  5720. }
  5721. /**
  5722. * Get the expression
  5723. *
  5724. * @return string Probably one of 'sample', 'full', 'nonstop', 'clip'. Defaults to 'full'
  5725. */
  5726. public function get_expression()
  5727. {
  5728. if ($this->expression !== null)
  5729. {
  5730. return $this->expression;
  5731. }
  5732. return 'full';
  5733. }
  5734. /**
  5735. * Get the file extension
  5736. *
  5737. * @return string|null
  5738. */
  5739. public function get_extension()
  5740. {
  5741. if ($this->link !== null)
  5742. {
  5743. $url = SimplePie_Misc::parse_url($this->link);
  5744. if ($url['path'] !== '')
  5745. {
  5746. return pathinfo($url['path'], PATHINFO_EXTENSION);
  5747. }
  5748. }
  5749. return null;
  5750. }
  5751. /**
  5752. * Get the framerate (in frames-per-second)
  5753. *
  5754. * @return string|null
  5755. */
  5756. public function get_framerate()
  5757. {
  5758. if ($this->framerate !== null)
  5759. {
  5760. return $this->framerate;
  5761. }
  5762. return null;
  5763. }
  5764. /**
  5765. * Get the preferred handler
  5766. *
  5767. * @return string|null One of 'flash', 'fmedia', 'quicktime', 'wmedia', 'mp3'
  5768. */
  5769. public function get_handler()
  5770. {
  5771. return $this->get_real_type(true);
  5772. }
  5773. /**
  5774. * Get a single hash
  5775. *
  5776. * @link http://www.rssboard.org/media-rss#media-hash
  5777. * @param int $key
  5778. * @return string|null Hash as per `media:hash`, prefixed with "$algo:"
  5779. */
  5780. public function get_hash($key = 0)
  5781. {
  5782. $hashes = $this->get_hashes();
  5783. if (isset($hashes[$key]))
  5784. {
  5785. return $hashes[$key];
  5786. }
  5787. return null;
  5788. }
  5789. /**
  5790. * Get all credits
  5791. *
  5792. * @return array|null Array of strings, see {@see get_hash()}
  5793. */
  5794. public function get_hashes()
  5795. {
  5796. if ($this->hashes !== null)
  5797. {
  5798. return $this->hashes;
  5799. }
  5800. return null;
  5801. }
  5802. /**
  5803. * Get the height
  5804. *
  5805. * @return string|null
  5806. */
  5807. public function get_height()
  5808. {
  5809. if ($this->height !== null)
  5810. {
  5811. return $this->height;
  5812. }
  5813. return null;
  5814. }
  5815. /**
  5816. * Get the language
  5817. *
  5818. * @link http://tools.ietf.org/html/rfc3066
  5819. * @return string|null Language code as per RFC 3066
  5820. */
  5821. public function get_language()
  5822. {
  5823. if ($this->lang !== null)
  5824. {
  5825. return $this->lang;
  5826. }
  5827. return null;
  5828. }
  5829. /**
  5830. * Get a single keyword
  5831. *
  5832. * @param int $key
  5833. * @return string|null
  5834. */
  5835. public function get_keyword($key = 0)
  5836. {
  5837. $keywords = $this->get_keywords();
  5838. if (isset($keywords[$key]))
  5839. {
  5840. return $keywords[$key];
  5841. }
  5842. return null;
  5843. }
  5844. /**
  5845. * Get all keywords
  5846. *
  5847. * @return array|null Array of strings
  5848. */
  5849. public function get_keywords()
  5850. {
  5851. if ($this->keywords !== null)
  5852. {
  5853. return $this->keywords;
  5854. }
  5855. return null;
  5856. }
  5857. /**
  5858. * Get length
  5859. *
  5860. * @return float Length in bytes
  5861. */
  5862. public function get_length()
  5863. {
  5864. if ($this->length !== null)
  5865. {
  5866. return $this->length;
  5867. }
  5868. return null;
  5869. }
  5870. /**
  5871. * Get the URL
  5872. *
  5873. * @return string|null
  5874. */
  5875. public function get_link()
  5876. {
  5877. if ($this->link !== null)
  5878. {
  5879. return urldecode($this->link);
  5880. }
  5881. return null;
  5882. }
  5883. /**
  5884. * Get the medium
  5885. *
  5886. * @link http://www.rssboard.org/media-rss#media-content
  5887. * @return string|null Should be one of 'image', 'audio', 'video', 'document', 'executable'
  5888. */
  5889. public function get_medium()
  5890. {
  5891. if ($this->medium !== null)
  5892. {
  5893. return $this->medium;
  5894. }
  5895. return null;
  5896. }
  5897. /**
  5898. * Get the player URL
  5899. *
  5900. * Typically the same as {@see get_permalink()}
  5901. * @return string|null Player URL
  5902. */
  5903. public function get_player()
  5904. {
  5905. if ($this->player !== null)
  5906. {
  5907. return $this->player;
  5908. }
  5909. return null;
  5910. }
  5911. /**
  5912. * Get a single rating
  5913. *
  5914. * @param int $key
  5915. * @return SimplePie_Rating|null
  5916. */
  5917. public function get_rating($key = 0)
  5918. {
  5919. $ratings = $this->get_ratings();
  5920. if (isset($ratings[$key]))
  5921. {
  5922. return $ratings[$key];
  5923. }
  5924. return null;
  5925. }
  5926. /**
  5927. * Get all ratings
  5928. *
  5929. * @return array|null Array of {@see SimplePie_Rating} objects
  5930. */
  5931. public function get_ratings()
  5932. {
  5933. if ($this->ratings !== null)
  5934. {
  5935. return $this->ratings;
  5936. }
  5937. return null;
  5938. }
  5939. /**
  5940. * Get a single restriction
  5941. *
  5942. * @param int $key
  5943. * @return SimplePie_Restriction|null
  5944. */
  5945. public function get_restriction($key = 0)
  5946. {
  5947. $restrictions = $this->get_restrictions();
  5948. if (isset($restrictions[$key]))
  5949. {
  5950. return $restrictions[$key];
  5951. }
  5952. return null;
  5953. }
  5954. /**
  5955. * Get all restrictions
  5956. *
  5957. * @return array|null Array of {@see SimplePie_Restriction} objects
  5958. */
  5959. public function get_restrictions()
  5960. {
  5961. if ($this->restrictions !== null)
  5962. {
  5963. return $this->restrictions;
  5964. }
  5965. return null;
  5966. }
  5967. /**
  5968. * Get the sampling rate (in kHz)
  5969. *
  5970. * @return string|null
  5971. */
  5972. public function get_sampling_rate()
  5973. {
  5974. if ($this->samplingrate !== null)
  5975. {
  5976. return $this->samplingrate;
  5977. }
  5978. return null;
  5979. }
  5980. /**
  5981. * Get the file size (in MiB)
  5982. *
  5983. * @return float|null File size in mebibytes (1048 bytes)
  5984. */
  5985. public function get_size()
  5986. {
  5987. $length = $this->get_length();
  5988. if ($length !== null)
  5989. {
  5990. return round($length/1048576, 2);
  5991. }
  5992. return null;
  5993. }
  5994. /**
  5995. * Get a single thumbnail
  5996. *
  5997. * @param int $key
  5998. * @return string|null Thumbnail URL
  5999. */
  6000. public function get_thumbnail($key = 0)
  6001. {
  6002. $thumbnails = $this->get_thumbnails();
  6003. if (isset($thumbnails[$key]))
  6004. {
  6005. return $thumbnails[$key];
  6006. }
  6007. return null;
  6008. }
  6009. /**
  6010. * Get all thumbnails
  6011. *
  6012. * @return array|null Array of thumbnail URLs
  6013. */
  6014. public function get_thumbnails()
  6015. {
  6016. if ($this->thumbnails !== null)
  6017. {
  6018. return $this->thumbnails;
  6019. }
  6020. return null;
  6021. }
  6022. /**
  6023. * Get the title
  6024. *
  6025. * @return string|null
  6026. */
  6027. public function get_title()
  6028. {
  6029. if ($this->title !== null)
  6030. {
  6031. return $this->title;
  6032. }
  6033. return null;
  6034. }
  6035. /**
  6036. * Get mimetype of the enclosure
  6037. *
  6038. * @see get_real_type()
  6039. * @return string|null MIME type
  6040. */
  6041. public function get_type()
  6042. {
  6043. if ($this->type !== null)
  6044. {
  6045. return $this->type;
  6046. }
  6047. return null;
  6048. }
  6049. /**
  6050. * Get the width
  6051. *
  6052. * @return string|null
  6053. */
  6054. public function get_width()
  6055. {
  6056. if ($this->width !== null)
  6057. {
  6058. return $this->width;
  6059. }
  6060. return null;
  6061. }
  6062. /**
  6063. * Embed the enclosure using `<embed>`
  6064. *
  6065. * @deprecated Use the second parameter to {@see embed} instead
  6066. *
  6067. * @param array|string $options See first paramter to {@see embed}
  6068. * @return string HTML string to output
  6069. */
  6070. public function native_embed($options='')
  6071. {
  6072. return $this->embed($options, true);
  6073. }
  6074. /**
  6075. * Embed the enclosure using Javascript
  6076. *
  6077. * `$options` is an array or comma-separated key:value string, with the
  6078. * following properties:
  6079. *
  6080. * - `alt` (string): Alternate content for when an end-user does not have
  6081. * the appropriate handler installed or when a file type is
  6082. * unsupported. Can be any text or HTML. Defaults to blank.
  6083. * - `altclass` (string): If a file type is unsupported, the end-user will
  6084. * see the alt text (above) linked directly to the content. That link
  6085. * will have this value as its class name. Defaults to blank.
  6086. * - `audio` (string): This is an image that should be used as a
  6087. * placeholder for audio files before they're loaded (QuickTime-only).
  6088. * Can be any relative or absolute URL. Defaults to blank.
  6089. * - `bgcolor` (string): The background color for the media, if not
  6090. * already transparent. Defaults to `#ffffff`.
  6091. * - `height` (integer): The height of the embedded media. Accepts any
  6092. * numeric pixel value (such as `360`) or `auto`. Defaults to `auto`,
  6093. * and it is recommended that you use this default.
  6094. * - `loop` (boolean): Do you want the media to loop when it's done?
  6095. * Defaults to `false`.
  6096. * - `mediaplayer` (string): The location of the included
  6097. * `mediaplayer.swf` file. This allows for the playback of Flash Video
  6098. * (`.flv`) files, and is the default handler for non-Odeo MP3's.
  6099. * Defaults to blank.
  6100. * - `video` (string): This is an image that should be used as a
  6101. * placeholder for video files before they're loaded (QuickTime-only).
  6102. * Can be any relative or absolute URL. Defaults to blank.
  6103. * - `width` (integer): The width of the embedded media. Accepts any
  6104. * numeric pixel value (such as `480`) or `auto`. Defaults to `auto`,
  6105. * and it is recommended that you use this default.
  6106. * - `widescreen` (boolean): Is the enclosure widescreen or standard?
  6107. * This applies only to video enclosures, and will automatically resize
  6108. * the content appropriately. Defaults to `false`, implying 4:3 mode.
  6109. *
  6110. * Note: Non-widescreen (4:3) mode with `width` and `height` set to `auto`
  6111. * will default to 480x360 video resolution. Widescreen (16:9) mode with
  6112. * `width` and `height` set to `auto` will default to 480x270 video resolution.
  6113. *
  6114. * @todo If the dimensions for media:content are defined, use them when width/height are set to 'auto'.
  6115. * @param array|string $options Comma-separated key:value list, or array
  6116. * @param bool $native Use `<embed>`
  6117. * @return string HTML string to output
  6118. */
  6119. public function embed($options = '', $native = false)
  6120. {
  6121. // Set up defaults
  6122. $audio = '';
  6123. $video = '';
  6124. $alt = '';
  6125. $altclass = '';
  6126. $loop = 'false';
  6127. $width = 'auto';
  6128. $height = 'auto';
  6129. $bgcolor = '#ffffff';
  6130. $mediaplayer = '';
  6131. $widescreen = false;
  6132. $handler = $this->get_handler();
  6133. $type = $this->get_real_type();
  6134. // Process options and reassign values as necessary
  6135. if (is_array($options))
  6136. {
  6137. extract($options);
  6138. }
  6139. else
  6140. {
  6141. $options = explode(',', $options);
  6142. foreach($options as $option)
  6143. {
  6144. $opt = explode(':', $option, 2);
  6145. if (isset($opt[0], $opt[1]))
  6146. {
  6147. $opt[0] = trim($opt[0]);
  6148. $opt[1] = trim($opt[1]);
  6149. switch ($opt[0])
  6150. {
  6151. case 'audio':
  6152. $audio = $opt[1];
  6153. break;
  6154. case 'video':
  6155. $video = $opt[1];
  6156. break;
  6157. case 'alt':
  6158. $alt = $opt[1];
  6159. break;
  6160. case 'altclass':
  6161. $altclass = $opt[1];
  6162. break;
  6163. case 'loop':
  6164. $loop = $opt[1];
  6165. break;
  6166. case 'width':
  6167. $width = $opt[1];
  6168. break;
  6169. case 'height':
  6170. $height = $opt[1];
  6171. break;
  6172. case 'bgcolor':
  6173. $bgcolor = $opt[1];
  6174. break;
  6175. case 'mediaplayer':
  6176. $mediaplayer = $opt[1];
  6177. break;
  6178. case 'widescreen':
  6179. $widescreen = $opt[1];
  6180. break;
  6181. }
  6182. }
  6183. }
  6184. }
  6185. $mime = explode('/', $type, 2);
  6186. $mime = $mime[0];
  6187. // Process values for 'auto'
  6188. if ($width === 'auto')
  6189. {
  6190. if ($mime === 'video')
  6191. {
  6192. if ($height === 'auto')
  6193. {
  6194. $width = 480;
  6195. }
  6196. elseif ($widescreen)
  6197. {
  6198. $width = round((intval($height)/9)*16);
  6199. }
  6200. else
  6201. {
  6202. $width = round((intval($height)/3)*4);
  6203. }
  6204. }
  6205. else
  6206. {
  6207. $width = '100%';
  6208. }
  6209. }
  6210. if ($height === 'auto')
  6211. {
  6212. if ($mime === 'audio')
  6213. {
  6214. $height = 0;
  6215. }
  6216. elseif ($mime === 'video')
  6217. {
  6218. if ($width === 'auto')
  6219. {
  6220. if ($widescreen)
  6221. {
  6222. $height = 270;
  6223. }
  6224. else
  6225. {
  6226. $height = 360;
  6227. }
  6228. }
  6229. elseif ($widescreen)
  6230. {
  6231. $height = round((intval($width)/16)*9);
  6232. }
  6233. else
  6234. {
  6235. $height = round((intval($width)/4)*3);
  6236. }
  6237. }
  6238. else
  6239. {
  6240. $height = 376;
  6241. }
  6242. }
  6243. elseif ($mime === 'audio')
  6244. {
  6245. $height = 0;
  6246. }
  6247. // Set proper placeholder value
  6248. if ($mime === 'audio')
  6249. {
  6250. $placeholder = $audio;
  6251. }
  6252. elseif ($mime === 'video')
  6253. {
  6254. $placeholder = $video;
  6255. }
  6256. $embed = '';
  6257. // Flash
  6258. if ($handler === 'flash')
  6259. {
  6260. if ($native)
  6261. {
  6262. $embed .= "<embed src=\"" . $this->get_link() . "\" pluginspage=\"http://adobe.com/go/getflashplayer\" type=\"$type\" quality=\"high\" width=\"$width\" height=\"$height\" bgcolor=\"$bgcolor\" loop=\"$loop\"></embed>";
  6263. }
  6264. else
  6265. {
  6266. $embed .= "<script type='text/javascript'>embed_flash('$bgcolor', '$width', '$height', '" . $this->get_link() . "', '$loop', '$type');</script>";
  6267. }
  6268. }
  6269. // Flash Media Player file types.
  6270. // Preferred handler for MP3 file types.
  6271. elseif ($handler === 'fmedia' || ($handler === 'mp3' && $mediaplayer !== ''))
  6272. {
  6273. $height += 20;
  6274. if ($native)
  6275. {
  6276. $embed .= "<embed src=\"$mediaplayer\" pluginspage=\"http://adobe.com/go/getflashplayer\" type=\"application/x-shockwave-flash\" quality=\"high\" width=\"$width\" height=\"$height\" wmode=\"transparent\" flashvars=\"file=" . rawurlencode($this->get_link().'?file_extension=.'.$this->get_extension()) . "&autostart=false&repeat=$loop&showdigits=true&showfsbutton=false\"></embed>";
  6277. }
  6278. else
  6279. {
  6280. $embed .= "<script type='text/javascript'>embed_flv('$width', '$height', '" . rawurlencode($this->get_link().'?file_extension=.'.$this->get_extension()) . "', '$placeholder', '$loop', '$mediaplayer');</script>";
  6281. }
  6282. }
  6283. // QuickTime 7 file types. Need to test with QuickTime 6.
  6284. // Only handle MP3's if the Flash Media Player is not present.
  6285. elseif ($handler === 'quicktime' || ($handler === 'mp3' && $mediaplayer === ''))
  6286. {
  6287. $height += 16;
  6288. if ($native)
  6289. {
  6290. if ($placeholder !== '')
  6291. {
  6292. $embed .= "<embed type=\"$type\" style=\"cursor:hand; cursor:pointer;\" href=\"" . $this->get_link() . "\" src=\"$placeholder\" width=\"$width\" height=\"$height\" autoplay=\"false\" target=\"myself\" controller=\"false\" loop=\"$loop\" scale=\"aspect\" bgcolor=\"$bgcolor\" pluginspage=\"http://apple.com/quicktime/download/\"></embed>";
  6293. }
  6294. else
  6295. {
  6296. $embed .= "<embed type=\"$type\" style=\"cursor:hand; cursor:pointer;\" src=\"" . $this->get_link() . "\" width=\"$width\" height=\"$height\" autoplay=\"false\" target=\"myself\" controller=\"true\" loop=\"$loop\" scale=\"aspect\" bgcolor=\"$bgcolor\" pluginspage=\"http://apple.com/quicktime/download/\"></embed>";
  6297. }
  6298. }
  6299. else
  6300. {
  6301. $embed .= "<script type='text/javascript'>embed_quicktime('$type', '$bgcolor', '$width', '$height', '" . $this->get_link() . "', '$placeholder', '$loop');</script>";
  6302. }
  6303. }
  6304. // Windows Media
  6305. elseif ($handler === 'wmedia')
  6306. {
  6307. $height += 45;
  6308. if ($native)
  6309. {
  6310. $embed .= "<embed type=\"application/x-mplayer2\" src=\"" . $this->get_link() . "\" autosize=\"1\" width=\"$width\" height=\"$height\" showcontrols=\"1\" showstatusbar=\"0\" showdisplay=\"0\" autostart=\"0\"></embed>";
  6311. }
  6312. else
  6313. {
  6314. $embed .= "<script type='text/javascript'>embed_wmedia('$width', '$height', '" . $this->get_link() . "');</script>";
  6315. }
  6316. }
  6317. // Everything else
  6318. else $embed .= '<a href="' . $this->get_link() . '" class="' . $altclass . '">' . $alt . '</a>';
  6319. return $embed;
  6320. }
  6321. /**
  6322. * Get the real media type
  6323. *
  6324. * Often, feeds lie to us, necessitating a bit of deeper inspection. This
  6325. * converts types to their canonical representations based on the file
  6326. * extension
  6327. *
  6328. * @see get_type()
  6329. * @param bool $find_handler Internal use only, use {@see get_handler()} instead
  6330. * @return string MIME type
  6331. */
  6332. public function get_real_type($find_handler = false)
  6333. {
  6334. // Mime-types by handler.
  6335. $types_flash = array('application/x-shockwave-flash', 'application/futuresplash'); // Flash
  6336. $types_fmedia = array('video/flv', 'video/x-flv','flv-application/octet-stream'); // Flash Media Player
  6337. $types_quicktime = array('audio/3gpp', 'audio/3gpp2', 'audio/aac', 'audio/x-aac', 'audio/aiff', 'audio/x-aiff', 'audio/mid', 'audio/midi', 'audio/x-midi', 'audio/mp4', 'audio/m4a', 'audio/x-m4a', 'audio/wav', 'audio/x-wav', 'video/3gpp', 'video/3gpp2', 'video/m4v', 'video/x-m4v', 'video/mp4', 'video/mpeg', 'video/x-mpeg', 'video/quicktime', 'video/sd-video'); // QuickTime
  6338. $types_wmedia = array('application/asx', 'application/x-mplayer2', 'audio/x-ms-wma', 'audio/x-ms-wax', 'video/x-ms-asf-plugin', 'video/x-ms-asf', 'video/x-ms-wm', 'video/x-ms-wmv', 'video/x-ms-wvx'); // Windows Media
  6339. $types_mp3 = array('audio/mp3', 'audio/x-mp3', 'audio/mpeg', 'audio/x-mpeg'); // MP3
  6340. if ($this->get_type() !== null)
  6341. {
  6342. $type = strtolower($this->type);
  6343. }
  6344. else
  6345. {
  6346. $type = null;
  6347. }
  6348. // If we encounter an unsupported mime-type, check the file extension and guess intelligently.
  6349. if (!in_array($type, array_merge($types_flash, $types_fmedia, $types_quicktime, $types_wmedia, $types_mp3)))
  6350. {
  6351. switch (strtolower($this->get_extension()))
  6352. {
  6353. // Audio mime-types
  6354. case 'aac':
  6355. case 'adts':
  6356. $type = 'audio/acc';
  6357. break;
  6358. case 'aif':
  6359. case 'aifc':
  6360. case 'aiff':
  6361. case 'cdda':
  6362. $type = 'audio/aiff';
  6363. break;
  6364. case 'bwf':
  6365. $type = 'audio/wav';
  6366. break;
  6367. case 'kar':
  6368. case 'mid':
  6369. case 'midi':
  6370. case 'smf':
  6371. $type = 'audio/midi';
  6372. break;
  6373. case 'm4a':
  6374. $type = 'audio/x-m4a';
  6375. break;
  6376. case 'mp3':
  6377. case 'swa':
  6378. $type = 'audio/mp3';
  6379. break;
  6380. case 'wav':
  6381. $type = 'audio/wav';
  6382. break;
  6383. case 'wax':
  6384. $type = 'audio/x-ms-wax';
  6385. break;
  6386. case 'wma':
  6387. $type = 'audio/x-ms-wma';
  6388. break;
  6389. // Video mime-types
  6390. case '3gp':
  6391. case '3gpp':
  6392. $type = 'video/3gpp';
  6393. break;
  6394. case '3g2':
  6395. case '3gp2':
  6396. $type = 'video/3gpp2';
  6397. break;
  6398. case 'asf':
  6399. $type = 'video/x-ms-asf';
  6400. break;
  6401. case 'flv':
  6402. $type = 'video/x-flv';
  6403. break;
  6404. case 'm1a':
  6405. case 'm1s':
  6406. case 'm1v':
  6407. case 'm15':
  6408. case 'm75':
  6409. case 'mp2':
  6410. case 'mpa':
  6411. case 'mpeg':
  6412. case 'mpg':
  6413. case 'mpm':
  6414. case 'mpv':
  6415. $type = 'video/mpeg';
  6416. break;
  6417. case 'm4v':
  6418. $type = 'video/x-m4v';
  6419. break;
  6420. case 'mov':
  6421. case 'qt':
  6422. $type = 'video/quicktime';
  6423. break;
  6424. case 'mp4':
  6425. case 'mpg4':
  6426. $type = 'video/mp4';
  6427. break;
  6428. case 'sdv':
  6429. $type = 'video/sd-video';
  6430. break;
  6431. case 'wm':
  6432. $type = 'video/x-ms-wm';
  6433. break;
  6434. case 'wmv':
  6435. $type = 'video/x-ms-wmv';
  6436. break;
  6437. case 'wvx':
  6438. $type = 'video/x-ms-wvx';
  6439. break;
  6440. // Flash mime-types
  6441. case 'spl':
  6442. $type = 'application/futuresplash';
  6443. break;
  6444. case 'swf':
  6445. $type = 'application/x-shockwave-flash';
  6446. break;
  6447. }
  6448. }
  6449. if ($find_handler)
  6450. {
  6451. if (in_array($type, $types_flash))
  6452. {
  6453. return 'flash';
  6454. }
  6455. elseif (in_array($type, $types_fmedia))
  6456. {
  6457. return 'fmedia';
  6458. }
  6459. elseif (in_array($type, $types_quicktime))
  6460. {
  6461. return 'quicktime';
  6462. }
  6463. elseif (in_array($type, $types_wmedia))
  6464. {
  6465. return 'wmedia';
  6466. }
  6467. elseif (in_array($type, $types_mp3))
  6468. {
  6469. return 'mp3';
  6470. }
  6471. return null;
  6472. }
  6473. return $type;
  6474. }
  6475. }
  6476. /**
  6477. * General SimplePie exception class
  6478. *
  6479. * @package SimplePie
  6480. */
  6481. class SimplePie_Exception extends Exception
  6482. {
  6483. }
  6484. /**
  6485. * Used for fetching remote files and reading local files
  6486. *
  6487. * Supports HTTP 1.0 via cURL or fsockopen, with spotty HTTP 1.1 support
  6488. *
  6489. * This class can be overloaded with {@see SimplePie::set_file_class()}
  6490. *
  6491. * @package SimplePie
  6492. * @subpackage HTTP
  6493. * @todo Move to properly supporting RFC2616 (HTTP/1.1)
  6494. */
  6495. class SimplePie_File
  6496. {
  6497. var $url;
  6498. var $useragent;
  6499. var $success = true;
  6500. var $headers = array();
  6501. var $body;
  6502. var $status_code;
  6503. var $redirects = 0;
  6504. var $error;
  6505. var $method = SIMPLEPIE_FILE_SOURCE_NONE;
  6506. var $permanent_url;
  6507. public function __construct($url, $timeout = 10, $redirects = 5, $headers = null, $useragent = null, $force_fsockopen = false, $curl_options = array())
  6508. {
  6509. if (class_exists('idna_convert'))
  6510. {
  6511. $idn = new idna_convert();
  6512. $parsed = SimplePie_Misc::parse_url($url);
  6513. $url = SimplePie_Misc::compress_parse_url($parsed['scheme'], $idn->encode($parsed['authority']), $parsed['path'], $parsed['query'], NULL);
  6514. }
  6515. $this->url = $url;
  6516. $this->permanent_url = $url;
  6517. $this->useragent = $useragent;
  6518. if (preg_match('/^http(s)?:\/\//i', $url))
  6519. {
  6520. if ($useragent === null)
  6521. {
  6522. $useragent = ini_get('user_agent');
  6523. $this->useragent = $useragent;
  6524. }
  6525. if (!is_array($headers))
  6526. {
  6527. $headers = array();
  6528. }
  6529. if (!$force_fsockopen && function_exists('curl_exec'))
  6530. {
  6531. $this->method = SIMPLEPIE_FILE_SOURCE_REMOTE | SIMPLEPIE_FILE_SOURCE_CURL;
  6532. $fp = curl_init();
  6533. $headers2 = array();
  6534. foreach ($headers as $key => $value)
  6535. {
  6536. $headers2[] = "$key: $value";
  6537. }
  6538. if (version_compare(SimplePie_Misc::get_curl_version(), '7.10.5', '>='))
  6539. {
  6540. curl_setopt($fp, CURLOPT_ENCODING, '');
  6541. }
  6542. curl_setopt($fp, CURLOPT_URL, $url);
  6543. curl_setopt($fp, CURLOPT_HEADER, 1);
  6544. curl_setopt($fp, CURLOPT_RETURNTRANSFER, 1);
  6545. curl_setopt($fp, CURLOPT_FAILONERROR, 1);
  6546. curl_setopt($fp, CURLOPT_TIMEOUT, $timeout);
  6547. curl_setopt($fp, CURLOPT_CONNECTTIMEOUT, $timeout);
  6548. curl_setopt($fp, CURLOPT_REFERER, $url);
  6549. curl_setopt($fp, CURLOPT_USERAGENT, $useragent);
  6550. curl_setopt($fp, CURLOPT_HTTPHEADER, $headers2);
  6551. if (!ini_get('open_basedir') && !ini_get('safe_mode') && version_compare(SimplePie_Misc::get_curl_version(), '7.15.2', '>='))
  6552. {
  6553. curl_setopt($fp, CURLOPT_FOLLOWLOCATION, 1);
  6554. curl_setopt($fp, CURLOPT_MAXREDIRS, $redirects);
  6555. }
  6556. foreach ($curl_options as $curl_param => $curl_value) {
  6557. curl_setopt($fp, $curl_param, $curl_value);
  6558. }
  6559. $this->headers = curl_exec($fp);
  6560. if (curl_errno($fp) === 23 || curl_errno($fp) === 61)
  6561. {
  6562. curl_setopt($fp, CURLOPT_ENCODING, 'none');
  6563. $this->headers = curl_exec($fp);
  6564. }
  6565. if (curl_errno($fp))
  6566. {
  6567. $this->error = 'cURL error ' . curl_errno($fp) . ': ' . curl_error($fp);
  6568. $this->success = false;
  6569. }
  6570. else
  6571. {
  6572. // Use the updated url provided by curl_getinfo after any redirects.
  6573. if ($info = curl_getinfo($fp)) {
  6574. $this->url = $info['url'];
  6575. }
  6576. curl_close($fp);
  6577. $this->headers = SimplePie_HTTP_Parser::prepareHeaders($this->headers, $info['redirect_count'] + 1);
  6578. $parser = new SimplePie_HTTP_Parser($this->headers);
  6579. if ($parser->parse())
  6580. {
  6581. $this->headers = $parser->headers;
  6582. $this->body = trim($parser->body);
  6583. $this->status_code = $parser->status_code;
  6584. if ((in_array($this->status_code, array(300, 301, 302, 303, 307)) || $this->status_code > 307 && $this->status_code < 400) && isset($this->headers['location']) && $this->redirects < $redirects)
  6585. {
  6586. $this->redirects++;
  6587. $location = SimplePie_Misc::absolutize_url($this->headers['location'], $url);
  6588. $previousStatusCode = $this->status_code;
  6589. $this->__construct($location, $timeout, $redirects, $headers, $useragent, $force_fsockopen);
  6590. $this->permanent_url = ($previousStatusCode == 301) ? $location : $url;
  6591. return;
  6592. }
  6593. }
  6594. }
  6595. }
  6596. else
  6597. {
  6598. $this->method = SIMPLEPIE_FILE_SOURCE_REMOTE | SIMPLEPIE_FILE_SOURCE_FSOCKOPEN;
  6599. $url_parts = parse_url($url);
  6600. $socket_host = $url_parts['host'];
  6601. if (isset($url_parts['scheme']) && strtolower($url_parts['scheme']) === 'https')
  6602. {
  6603. $socket_host = "ssl://$url_parts[host]";
  6604. $url_parts['port'] = 443;
  6605. }
  6606. if (!isset($url_parts['port']))
  6607. {
  6608. $url_parts['port'] = 80;
  6609. }
  6610. $fp = @fsockopen($socket_host, $url_parts['port'], $errno, $errstr, $timeout);
  6611. if (!$fp)
  6612. {
  6613. $this->error = 'fsockopen error: ' . $errstr;
  6614. $this->success = false;
  6615. }
  6616. else
  6617. {
  6618. stream_set_timeout($fp, $timeout);
  6619. if (isset($url_parts['path']))
  6620. {
  6621. if (isset($url_parts['query']))
  6622. {
  6623. $get = "$url_parts[path]?$url_parts[query]";
  6624. }
  6625. else
  6626. {
  6627. $get = $url_parts['path'];
  6628. }
  6629. }
  6630. else
  6631. {
  6632. $get = '/';
  6633. }
  6634. $out = "GET $get HTTP/1.1\r\n";
  6635. $out .= "Host: $url_parts[host]\r\n";
  6636. $out .= "User-Agent: $useragent\r\n";
  6637. if (extension_loaded('zlib'))
  6638. {
  6639. $out .= "Accept-Encoding: x-gzip,gzip,deflate\r\n";
  6640. }
  6641. if (isset($url_parts['user']) && isset($url_parts['pass']))
  6642. {
  6643. $out .= "Authorization: Basic " . base64_encode("$url_parts[user]:$url_parts[pass]") . "\r\n";
  6644. }
  6645. foreach ($headers as $key => $value)
  6646. {
  6647. $out .= "$key: $value\r\n";
  6648. }
  6649. $out .= "Connection: Close\r\n\r\n";
  6650. fwrite($fp, $out);
  6651. $info = stream_get_meta_data($fp);
  6652. $this->headers = '';
  6653. while (!$info['eof'] && !$info['timed_out'])
  6654. {
  6655. $this->headers .= fread($fp, 1160);
  6656. $info = stream_get_meta_data($fp);
  6657. }
  6658. if (!$info['timed_out'])
  6659. {
  6660. $parser = new SimplePie_HTTP_Parser($this->headers);
  6661. if ($parser->parse())
  6662. {
  6663. $this->headers = $parser->headers;
  6664. $this->body = $parser->body;
  6665. $this->status_code = $parser->status_code;
  6666. if ((in_array($this->status_code, array(300, 301, 302, 303, 307)) || $this->status_code > 307 && $this->status_code < 400) && isset($this->headers['location']) && $this->redirects < $redirects)
  6667. {
  6668. $this->redirects++;
  6669. $location = SimplePie_Misc::absolutize_url($this->headers['location'], $url);
  6670. $previousStatusCode = $this->status_code;
  6671. $this->__construct($location, $timeout, $redirects, $headers, $useragent, $force_fsockopen);
  6672. $this->permanent_url = ($previousStatusCode == 301) ? $location : $url;
  6673. return;
  6674. }
  6675. if (isset($this->headers['content-encoding']))
  6676. {
  6677. // Hey, we act dumb elsewhere, so let's do that here too
  6678. switch (strtolower(trim($this->headers['content-encoding'], "\x09\x0A\x0D\x20")))
  6679. {
  6680. case 'gzip':
  6681. case 'x-gzip':
  6682. $decoder = new SimplePie_gzdecode($this->body);
  6683. if (!$decoder->parse())
  6684. {
  6685. $this->error = 'Unable to decode HTTP "gzip" stream';
  6686. $this->success = false;
  6687. }
  6688. else
  6689. {
  6690. $this->body = trim($decoder->data);
  6691. }
  6692. break;
  6693. case 'deflate':
  6694. if (($decompressed = gzinflate($this->body)) !== false)
  6695. {
  6696. $this->body = $decompressed;
  6697. }
  6698. else if (($decompressed = gzuncompress($this->body)) !== false)
  6699. {
  6700. $this->body = $decompressed;
  6701. }
  6702. else if (function_exists('gzdecode') && ($decompressed = gzdecode($this->body)) !== false)
  6703. {
  6704. $this->body = $decompressed;
  6705. }
  6706. else
  6707. {
  6708. $this->error = 'Unable to decode HTTP "deflate" stream';
  6709. $this->success = false;
  6710. }
  6711. break;
  6712. default:
  6713. $this->error = 'Unknown content coding';
  6714. $this->success = false;
  6715. }
  6716. }
  6717. }
  6718. }
  6719. else
  6720. {
  6721. $this->error = 'fsocket timed out';
  6722. $this->success = false;
  6723. }
  6724. fclose($fp);
  6725. }
  6726. }
  6727. }
  6728. else
  6729. {
  6730. $this->method = SIMPLEPIE_FILE_SOURCE_LOCAL | SIMPLEPIE_FILE_SOURCE_FILE_GET_CONTENTS;
  6731. if (empty($url) || !($this->body = trim(file_get_contents($url))))
  6732. {
  6733. $this->error = 'file_get_contents could not read the file';
  6734. $this->success = false;
  6735. }
  6736. }
  6737. }
  6738. }
  6739. /**
  6740. * HTTP Response Parser
  6741. *
  6742. * @package SimplePie
  6743. * @subpackage HTTP
  6744. */
  6745. class SimplePie_HTTP_Parser
  6746. {
  6747. /**
  6748. * HTTP Version
  6749. *
  6750. * @var float
  6751. */
  6752. public $http_version = 0.0;
  6753. /**
  6754. * Status code
  6755. *
  6756. * @var int
  6757. */
  6758. public $status_code = 0;
  6759. /**
  6760. * Reason phrase
  6761. *
  6762. * @var string
  6763. */
  6764. public $reason = '';
  6765. /**
  6766. * Key/value pairs of the headers
  6767. *
  6768. * @var array
  6769. */
  6770. public $headers = array();
  6771. /**
  6772. * Body of the response
  6773. *
  6774. * @var string
  6775. */
  6776. public $body = '';
  6777. /**
  6778. * Current state of the state machine
  6779. *
  6780. * @var string
  6781. */
  6782. protected $state = 'http_version';
  6783. /**
  6784. * Input data
  6785. *
  6786. * @var string
  6787. */
  6788. protected $data = '';
  6789. /**
  6790. * Input data length (to avoid calling strlen() everytime this is needed)
  6791. *
  6792. * @var int
  6793. */
  6794. protected $data_length = 0;
  6795. /**
  6796. * Current position of the pointer
  6797. *
  6798. * @var int
  6799. */
  6800. protected $position = 0;
  6801. /**
  6802. * Name of the hedaer currently being parsed
  6803. *
  6804. * @var string
  6805. */
  6806. protected $name = '';
  6807. /**
  6808. * Value of the hedaer currently being parsed
  6809. *
  6810. * @var string
  6811. */
  6812. protected $value = '';
  6813. /**
  6814. * Create an instance of the class with the input data
  6815. *
  6816. * @param string $data Input data
  6817. */
  6818. public function __construct($data)
  6819. {
  6820. $this->data = $data;
  6821. $this->data_length = strlen($this->data);
  6822. }
  6823. /**
  6824. * Parse the input data
  6825. *
  6826. * @return bool true on success, false on failure
  6827. */
  6828. public function parse()
  6829. {
  6830. while ($this->state && $this->state !== 'emit' && $this->has_data())
  6831. {
  6832. $state = $this->state;
  6833. $this->$state();
  6834. }
  6835. $this->data = '';
  6836. if ($this->state === 'emit' || $this->state === 'body')
  6837. {
  6838. return true;
  6839. }
  6840. $this->http_version = '';
  6841. $this->status_code = '';
  6842. $this->reason = '';
  6843. $this->headers = array();
  6844. $this->body = '';
  6845. return false;
  6846. }
  6847. /**
  6848. * Check whether there is data beyond the pointer
  6849. *
  6850. * @return bool true if there is further data, false if not
  6851. */
  6852. protected function has_data()
  6853. {
  6854. return (bool) ($this->position < $this->data_length);
  6855. }
  6856. /**
  6857. * See if the next character is LWS
  6858. *
  6859. * @return bool true if the next character is LWS, false if not
  6860. */
  6861. protected function is_linear_whitespace()
  6862. {
  6863. return (bool) ($this->data[$this->position] === "\x09"
  6864. || $this->data[$this->position] === "\x20"
  6865. || ($this->data[$this->position] === "\x0A"
  6866. && isset($this->data[$this->position + 1])
  6867. && ($this->data[$this->position + 1] === "\x09" || $this->data[$this->position + 1] === "\x20")));
  6868. }
  6869. /**
  6870. * Parse the HTTP version
  6871. */
  6872. protected function http_version()
  6873. {
  6874. if (strpos($this->data, "\x0A") !== false && strtoupper(substr($this->data, 0, 5)) === 'HTTP/')
  6875. {
  6876. $len = strspn($this->data, '0123456789.', 5);
  6877. $this->http_version = substr($this->data, 5, $len);
  6878. $this->position += 5 + $len;
  6879. if (substr_count($this->http_version, '.') <= 1)
  6880. {
  6881. $this->http_version = (float) $this->http_version;
  6882. $this->position += strspn($this->data, "\x09\x20", $this->position);
  6883. $this->state = 'status';
  6884. }
  6885. else
  6886. {
  6887. $this->state = false;
  6888. }
  6889. }
  6890. else
  6891. {
  6892. $this->state = false;
  6893. }
  6894. }
  6895. /**
  6896. * Parse the status code
  6897. */
  6898. protected function status()
  6899. {
  6900. if ($len = strspn($this->data, '0123456789', $this->position))
  6901. {
  6902. $this->status_code = (int) substr($this->data, $this->position, $len);
  6903. $this->position += $len;
  6904. $this->state = 'reason';
  6905. }
  6906. else
  6907. {
  6908. $this->state = false;
  6909. }
  6910. }
  6911. /**
  6912. * Parse the reason phrase
  6913. */
  6914. protected function reason()
  6915. {
  6916. $len = strcspn($this->data, "\x0A", $this->position);
  6917. $this->reason = trim(substr($this->data, $this->position, $len), "\x09\x0D\x20");
  6918. $this->position += $len + 1;
  6919. $this->state = 'new_line';
  6920. }
  6921. /**
  6922. * Deal with a new line, shifting data around as needed
  6923. */
  6924. protected function new_line()
  6925. {
  6926. $this->value = trim($this->value, "\x0D\x20");
  6927. if ($this->name !== '' && $this->value !== '')
  6928. {
  6929. $this->name = strtolower($this->name);
  6930. // We should only use the last Content-Type header. c.f. issue #1
  6931. if (isset($this->headers[$this->name]) && $this->name !== 'content-type')
  6932. {
  6933. $this->headers[$this->name] .= ', ' . $this->value;
  6934. }
  6935. else
  6936. {
  6937. $this->headers[$this->name] = $this->value;
  6938. }
  6939. }
  6940. $this->name = '';
  6941. $this->value = '';
  6942. if (substr($this->data[$this->position], 0, 2) === "\x0D\x0A")
  6943. {
  6944. $this->position += 2;
  6945. $this->state = 'body';
  6946. }
  6947. elseif ($this->data[$this->position] === "\x0A")
  6948. {
  6949. $this->position++;
  6950. $this->state = 'body';
  6951. }
  6952. else
  6953. {
  6954. $this->state = 'name';
  6955. }
  6956. }
  6957. /**
  6958. * Parse a header name
  6959. */
  6960. protected function name()
  6961. {
  6962. $len = strcspn($this->data, "\x0A:", $this->position);
  6963. if (isset($this->data[$this->position + $len]))
  6964. {
  6965. if ($this->data[$this->position + $len] === "\x0A")
  6966. {
  6967. $this->position += $len;
  6968. $this->state = 'new_line';
  6969. }
  6970. else
  6971. {
  6972. $this->name = substr($this->data, $this->position, $len);
  6973. $this->position += $len + 1;
  6974. $this->state = 'value';
  6975. }
  6976. }
  6977. else
  6978. {
  6979. $this->state = false;
  6980. }
  6981. }
  6982. /**
  6983. * Parse LWS, replacing consecutive LWS characters with a single space
  6984. */
  6985. protected function linear_whitespace()
  6986. {
  6987. do
  6988. {
  6989. if (substr($this->data, $this->position, 2) === "\x0D\x0A")
  6990. {
  6991. $this->position += 2;
  6992. }
  6993. elseif ($this->data[$this->position] === "\x0A")
  6994. {
  6995. $this->position++;
  6996. }
  6997. $this->position += strspn($this->data, "\x09\x20", $this->position);
  6998. } while ($this->has_data() && $this->is_linear_whitespace());
  6999. $this->value .= "\x20";
  7000. }
  7001. /**
  7002. * See what state to move to while within non-quoted header values
  7003. */
  7004. protected function value()
  7005. {
  7006. if ($this->is_linear_whitespace())
  7007. {
  7008. $this->linear_whitespace();
  7009. }
  7010. else
  7011. {
  7012. switch ($this->data[$this->position])
  7013. {
  7014. case '"':
  7015. // Workaround for ETags: we have to include the quotes as
  7016. // part of the tag.
  7017. if (strtolower($this->name) === 'etag')
  7018. {
  7019. $this->value .= '"';
  7020. $this->position++;
  7021. $this->state = 'value_char';
  7022. break;
  7023. }
  7024. $this->position++;
  7025. $this->state = 'quote';
  7026. break;
  7027. case "\x0A":
  7028. $this->position++;
  7029. $this->state = 'new_line';
  7030. break;
  7031. default:
  7032. $this->state = 'value_char';
  7033. break;
  7034. }
  7035. }
  7036. }
  7037. /**
  7038. * Parse a header value while outside quotes
  7039. */
  7040. protected function value_char()
  7041. {
  7042. $len = strcspn($this->data, "\x09\x20\x0A\"", $this->position);
  7043. $this->value .= substr($this->data, $this->position, $len);
  7044. $this->position += $len;
  7045. $this->state = 'value';
  7046. }
  7047. /**
  7048. * See what state to move to while within quoted header values
  7049. */
  7050. protected function quote()
  7051. {
  7052. if ($this->is_linear_whitespace())
  7053. {
  7054. $this->linear_whitespace();
  7055. }
  7056. else
  7057. {
  7058. switch ($this->data[$this->position])
  7059. {
  7060. case '"':
  7061. $this->position++;
  7062. $this->state = 'value';
  7063. break;
  7064. case "\x0A":
  7065. $this->position++;
  7066. $this->state = 'new_line';
  7067. break;
  7068. case '\\':
  7069. $this->position++;
  7070. $this->state = 'quote_escaped';
  7071. break;
  7072. default:
  7073. $this->state = 'quote_char';
  7074. break;
  7075. }
  7076. }
  7077. }
  7078. /**
  7079. * Parse a header value while within quotes
  7080. */
  7081. protected function quote_char()
  7082. {
  7083. $len = strcspn($this->data, "\x09\x20\x0A\"\\", $this->position);
  7084. $this->value .= substr($this->data, $this->position, $len);
  7085. $this->position += $len;
  7086. $this->state = 'value';
  7087. }
  7088. /**
  7089. * Parse an escaped character within quotes
  7090. */
  7091. protected function quote_escaped()
  7092. {
  7093. $this->value .= $this->data[$this->position];
  7094. $this->position++;
  7095. $this->state = 'quote';
  7096. }
  7097. /**
  7098. * Parse the body
  7099. */
  7100. protected function body()
  7101. {
  7102. $this->body = substr($this->data, $this->position);
  7103. if (!empty($this->headers['transfer-encoding']))
  7104. {
  7105. unset($this->headers['transfer-encoding']);
  7106. $this->state = 'chunked';
  7107. }
  7108. else
  7109. {
  7110. $this->state = 'emit';
  7111. }
  7112. }
  7113. /**
  7114. * Parsed a "Transfer-Encoding: chunked" body
  7115. */
  7116. protected function chunked()
  7117. {
  7118. if (!preg_match('/^([0-9a-f]+)[^\r\n]*\r\n/i', trim($this->body)))
  7119. {
  7120. $this->state = 'emit';
  7121. return;
  7122. }
  7123. $decoded = '';
  7124. $encoded = $this->body;
  7125. while (true)
  7126. {
  7127. $is_chunked = (bool) preg_match( '/^([0-9a-f]+)[^\r\n]*\r\n/i', $encoded, $matches );
  7128. if (!$is_chunked)
  7129. {
  7130. // Looks like it's not chunked after all
  7131. $this->state = 'emit';
  7132. return;
  7133. }
  7134. $length = hexdec(trim($matches[1]));
  7135. if ($length === 0)
  7136. {
  7137. // Ignore trailer headers
  7138. $this->state = 'emit';
  7139. $this->body = $decoded;
  7140. return;
  7141. }
  7142. $chunk_length = strlen($matches[0]);
  7143. $decoded .= $part = substr($encoded, $chunk_length, $length);
  7144. $encoded = substr($encoded, $chunk_length + $length + 2);
  7145. if (trim($encoded) === '0' || empty($encoded))
  7146. {
  7147. $this->state = 'emit';
  7148. $this->body = $decoded;
  7149. return;
  7150. }
  7151. }
  7152. }
  7153. /**
  7154. * Prepare headers (take care of proxies headers)
  7155. *
  7156. * @param string $headers Raw headers
  7157. * @param integer $count Redirection count. Default to 1.
  7158. *
  7159. * @return string
  7160. */
  7161. static public function prepareHeaders($headers, $count = 1)
  7162. {
  7163. $data = explode("\r\n\r\n", $headers, $count);
  7164. $data = array_pop($data);
  7165. if (false !== stripos($data, "HTTP/1.0 200 Connection established\r\n\r\n")) {
  7166. $data = str_ireplace("HTTP/1.0 200 Connection established\r\n\r\n", '', $data);
  7167. }
  7168. if (false !== stripos($data, "HTTP/1.1 200 Connection established\r\n\r\n")) {
  7169. $data = str_ireplace("HTTP/1.1 200 Connection established\r\n\r\n", '', $data);
  7170. }
  7171. return $data;
  7172. }
  7173. }
  7174. /**
  7175. * IRI parser/serialiser/normaliser
  7176. *
  7177. * @package SimplePie
  7178. * @subpackage HTTP
  7179. * @author Sam Sneddon
  7180. * @author Steve Minutillo
  7181. * @author Ryan McCue
  7182. * @copyright 2007-2012 Sam Sneddon, Steve Minutillo, Ryan McCue
  7183. * @license http://www.opensource.org/licenses/bsd-license.php
  7184. */
  7185. class SimplePie_IRI
  7186. {
  7187. /**
  7188. * Scheme
  7189. *
  7190. * @var string
  7191. */
  7192. protected $scheme = null;
  7193. /**
  7194. * User Information
  7195. *
  7196. * @var string
  7197. */
  7198. protected $iuserinfo = null;
  7199. /**
  7200. * ihost
  7201. *
  7202. * @var string
  7203. */
  7204. protected $ihost = null;
  7205. /**
  7206. * Port
  7207. *
  7208. * @var string
  7209. */
  7210. protected $port = null;
  7211. /**
  7212. * ipath
  7213. *
  7214. * @var string
  7215. */
  7216. protected $ipath = '';
  7217. /**
  7218. * iquery
  7219. *
  7220. * @var string
  7221. */
  7222. protected $iquery = null;
  7223. /**
  7224. * ifragment
  7225. *
  7226. * @var string
  7227. */
  7228. protected $ifragment = null;
  7229. /**
  7230. * Normalization database
  7231. *
  7232. * Each key is the scheme, each value is an array with each key as the IRI
  7233. * part and value as the default value for that part.
  7234. */
  7235. protected $normalization = array(
  7236. 'acap' => array(
  7237. 'port' => 674
  7238. ),
  7239. 'dict' => array(
  7240. 'port' => 2628
  7241. ),
  7242. 'file' => array(
  7243. 'ihost' => 'localhost'
  7244. ),
  7245. 'http' => array(
  7246. 'port' => 80,
  7247. 'ipath' => '/'
  7248. ),
  7249. 'https' => array(
  7250. 'port' => 443,
  7251. 'ipath' => '/'
  7252. ),
  7253. );
  7254. /**
  7255. * Return the entire IRI when you try and read the object as a string
  7256. *
  7257. * @return string
  7258. */
  7259. public function __toString()
  7260. {
  7261. return $this->get_iri();
  7262. }
  7263. /**
  7264. * Overload __set() to provide access via properties
  7265. *
  7266. * @param string $name Property name
  7267. * @param mixed $value Property value
  7268. */
  7269. public function __set($name, $value)
  7270. {
  7271. if (method_exists($this, 'set_' . $name))
  7272. {
  7273. call_user_func(array($this, 'set_' . $name), $value);
  7274. }
  7275. elseif (
  7276. $name === 'iauthority'
  7277. || $name === 'iuserinfo'
  7278. || $name === 'ihost'
  7279. || $name === 'ipath'
  7280. || $name === 'iquery'
  7281. || $name === 'ifragment'
  7282. )
  7283. {
  7284. call_user_func(array($this, 'set_' . substr($name, 1)), $value);
  7285. }
  7286. }
  7287. /**
  7288. * Overload __get() to provide access via properties
  7289. *
  7290. * @param string $name Property name
  7291. * @return mixed
  7292. */
  7293. public function __get($name)
  7294. {
  7295. // isset() returns false for null, we don't want to do that
  7296. // Also why we use array_key_exists below instead of isset()
  7297. $props = get_object_vars($this);
  7298. if (
  7299. $name === 'iri' ||
  7300. $name === 'uri' ||
  7301. $name === 'iauthority' ||
  7302. $name === 'authority'
  7303. )
  7304. {
  7305. $return = $this->{