SimplePie.php 96 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378
  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. * Copyright (c) 2004-2017, Ryan Parman, Sam Sneddon, Ryan McCue, and contributors
  9. * All rights reserved.
  10. *
  11. * Redistribution and use in source and binary forms, with or without modification, are
  12. * permitted provided that the following conditions are met:
  13. *
  14. * * Redistributions of source code must retain the above copyright notice, this list of
  15. * conditions and the following disclaimer.
  16. *
  17. * * Redistributions in binary form must reproduce the above copyright notice, this list
  18. * of conditions and the following disclaimer in the documentation and/or other materials
  19. * provided with the distribution.
  20. *
  21. * * Neither the name of the SimplePie Team nor the names of its contributors may be used
  22. * to endorse or promote products derived from this software without specific prior
  23. * written permission.
  24. *
  25. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS
  26. * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
  27. * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS
  28. * AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  29. * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  30. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  31. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  32. * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  33. * POSSIBILITY OF SUCH DAMAGE.
  34. *
  35. * @package SimplePie
  36. * @version 1.5.8
  37. * @copyright 2004-2017 Ryan Parman, Sam Sneddon, Ryan McCue
  38. * @author Ryan Parman
  39. * @author Sam Sneddon
  40. * @author Ryan McCue
  41. * @link http://simplepie.org/ SimplePie
  42. * @license http://www.opensource.org/licenses/bsd-license.php BSD License
  43. */
  44. /**
  45. * SimplePie Name
  46. */
  47. define('SIMPLEPIE_NAME', 'SimplePie');
  48. /**
  49. * SimplePie Version
  50. */
  51. define('SIMPLEPIE_VERSION', '1.5.8');
  52. /**
  53. * SimplePie Build
  54. * @todo Hardcode for release (there's no need to have to call SimplePie_Misc::get_build() only every load of simplepie.inc)
  55. */
  56. define('SIMPLEPIE_BUILD', gmdate('YmdHis', SimplePie_Misc::get_build()));
  57. /**
  58. * SimplePie Website URL
  59. */
  60. define('SIMPLEPIE_URL', 'http://simplepie.org');
  61. /**
  62. * SimplePie Useragent
  63. * @see SimplePie::set_useragent()
  64. */
  65. define('SIMPLEPIE_USERAGENT', SIMPLEPIE_NAME . '/' . SIMPLEPIE_VERSION . ' (Feed Parser; ' . SIMPLEPIE_URL . '; Allow like Gecko) Build/' . SIMPLEPIE_BUILD);
  66. /**
  67. * SimplePie Linkback
  68. */
  69. define('SIMPLEPIE_LINKBACK', '<a href="' . SIMPLEPIE_URL . '" title="' . SIMPLEPIE_NAME . ' ' . SIMPLEPIE_VERSION . '">' . SIMPLEPIE_NAME . '</a>');
  70. /**
  71. * Use syslog to report HTTP requests done by SimplePie.
  72. * @see SimplePie::set_syslog()
  73. */
  74. define('SIMPLEPIE_SYSLOG', true); //FreshRSS
  75. /**
  76. * No Autodiscovery
  77. * @see SimplePie::set_autodiscovery_level()
  78. */
  79. define('SIMPLEPIE_LOCATOR_NONE', 0);
  80. /**
  81. * Feed Link Element Autodiscovery
  82. * @see SimplePie::set_autodiscovery_level()
  83. */
  84. define('SIMPLEPIE_LOCATOR_AUTODISCOVERY', 1);
  85. /**
  86. * Local Feed Extension Autodiscovery
  87. * @see SimplePie::set_autodiscovery_level()
  88. */
  89. define('SIMPLEPIE_LOCATOR_LOCAL_EXTENSION', 2);
  90. /**
  91. * Local Feed Body Autodiscovery
  92. * @see SimplePie::set_autodiscovery_level()
  93. */
  94. define('SIMPLEPIE_LOCATOR_LOCAL_BODY', 4);
  95. /**
  96. * Remote Feed Extension Autodiscovery
  97. * @see SimplePie::set_autodiscovery_level()
  98. */
  99. define('SIMPLEPIE_LOCATOR_REMOTE_EXTENSION', 8);
  100. /**
  101. * Remote Feed Body Autodiscovery
  102. * @see SimplePie::set_autodiscovery_level()
  103. */
  104. define('SIMPLEPIE_LOCATOR_REMOTE_BODY', 16);
  105. /**
  106. * All Feed Autodiscovery
  107. * @see SimplePie::set_autodiscovery_level()
  108. */
  109. define('SIMPLEPIE_LOCATOR_ALL', 31);
  110. /**
  111. * No known feed type
  112. */
  113. define('SIMPLEPIE_TYPE_NONE', 0);
  114. /**
  115. * RSS 0.90
  116. */
  117. define('SIMPLEPIE_TYPE_RSS_090', 1);
  118. /**
  119. * RSS 0.91 (Netscape)
  120. */
  121. define('SIMPLEPIE_TYPE_RSS_091_NETSCAPE', 2);
  122. /**
  123. * RSS 0.91 (Userland)
  124. */
  125. define('SIMPLEPIE_TYPE_RSS_091_USERLAND', 4);
  126. /**
  127. * RSS 0.91 (both Netscape and Userland)
  128. */
  129. define('SIMPLEPIE_TYPE_RSS_091', 6);
  130. /**
  131. * RSS 0.92
  132. */
  133. define('SIMPLEPIE_TYPE_RSS_092', 8);
  134. /**
  135. * RSS 0.93
  136. */
  137. define('SIMPLEPIE_TYPE_RSS_093', 16);
  138. /**
  139. * RSS 0.94
  140. */
  141. define('SIMPLEPIE_TYPE_RSS_094', 32);
  142. /**
  143. * RSS 1.0
  144. */
  145. define('SIMPLEPIE_TYPE_RSS_10', 64);
  146. /**
  147. * RSS 2.0
  148. */
  149. define('SIMPLEPIE_TYPE_RSS_20', 128);
  150. /**
  151. * RDF-based RSS
  152. */
  153. define('SIMPLEPIE_TYPE_RSS_RDF', 65);
  154. /**
  155. * Non-RDF-based RSS (truly intended as syndication format)
  156. */
  157. define('SIMPLEPIE_TYPE_RSS_SYNDICATION', 190);
  158. /**
  159. * All RSS
  160. */
  161. define('SIMPLEPIE_TYPE_RSS_ALL', 255);
  162. /**
  163. * Atom 0.3
  164. */
  165. define('SIMPLEPIE_TYPE_ATOM_03', 256);
  166. /**
  167. * Atom 1.0
  168. */
  169. define('SIMPLEPIE_TYPE_ATOM_10', 512);
  170. /**
  171. * All Atom
  172. */
  173. define('SIMPLEPIE_TYPE_ATOM_ALL', 768);
  174. /**
  175. * All feed types
  176. */
  177. define('SIMPLEPIE_TYPE_ALL', 1023);
  178. /**
  179. * No construct
  180. */
  181. define('SIMPLEPIE_CONSTRUCT_NONE', 0);
  182. /**
  183. * Text construct
  184. */
  185. define('SIMPLEPIE_CONSTRUCT_TEXT', 1);
  186. /**
  187. * HTML construct
  188. */
  189. define('SIMPLEPIE_CONSTRUCT_HTML', 2);
  190. /**
  191. * XHTML construct
  192. */
  193. define('SIMPLEPIE_CONSTRUCT_XHTML', 4);
  194. /**
  195. * base64-encoded construct
  196. */
  197. define('SIMPLEPIE_CONSTRUCT_BASE64', 8);
  198. /**
  199. * IRI construct
  200. */
  201. define('SIMPLEPIE_CONSTRUCT_IRI', 16);
  202. /**
  203. * A construct that might be HTML
  204. */
  205. define('SIMPLEPIE_CONSTRUCT_MAYBE_HTML', 32);
  206. /**
  207. * All constructs
  208. */
  209. define('SIMPLEPIE_CONSTRUCT_ALL', 63);
  210. /**
  211. * Don't change case
  212. */
  213. define('SIMPLEPIE_SAME_CASE', 1);
  214. /**
  215. * Change to lowercase
  216. */
  217. define('SIMPLEPIE_LOWERCASE', 2);
  218. /**
  219. * Change to uppercase
  220. */
  221. define('SIMPLEPIE_UPPERCASE', 4);
  222. /**
  223. * PCRE for HTML attributes
  224. */
  225. 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]*');
  226. /**
  227. * PCRE for XML attributes
  228. */
  229. define('SIMPLEPIE_PCRE_XML_ATTRIBUTE', '((?:\s+(?:(?:[^\s:]+:)?[^\s:]+)\s*=\s*(?:"(?:[^"]*)"|\'(?:[^\']*)\'))*)\s*');
  230. /**
  231. * XML Namespace
  232. */
  233. define('SIMPLEPIE_NAMESPACE_XML', 'http://www.w3.org/XML/1998/namespace');
  234. /**
  235. * Atom 1.0 Namespace
  236. */
  237. define('SIMPLEPIE_NAMESPACE_ATOM_10', 'http://www.w3.org/2005/Atom');
  238. /**
  239. * Atom 0.3 Namespace
  240. */
  241. define('SIMPLEPIE_NAMESPACE_ATOM_03', 'http://purl.org/atom/ns#');
  242. /**
  243. * RDF Namespace
  244. */
  245. define('SIMPLEPIE_NAMESPACE_RDF', 'http://www.w3.org/1999/02/22-rdf-syntax-ns#');
  246. /**
  247. * RSS 0.90 Namespace
  248. */
  249. define('SIMPLEPIE_NAMESPACE_RSS_090', 'http://my.netscape.com/rdf/simple/0.9/');
  250. /**
  251. * RSS 1.0 Namespace
  252. */
  253. define('SIMPLEPIE_NAMESPACE_RSS_10', 'http://purl.org/rss/1.0/');
  254. /**
  255. * RSS 1.0 Content Module Namespace
  256. */
  257. define('SIMPLEPIE_NAMESPACE_RSS_10_MODULES_CONTENT', 'http://purl.org/rss/1.0/modules/content/');
  258. /**
  259. * RSS 2.0 Namespace
  260. * (Stupid, I know, but I'm certain it will confuse people less with support.)
  261. */
  262. define('SIMPLEPIE_NAMESPACE_RSS_20', '');
  263. /**
  264. * DC 1.0 Namespace
  265. */
  266. define('SIMPLEPIE_NAMESPACE_DC_10', 'http://purl.org/dc/elements/1.0/');
  267. /**
  268. * DC 1.1 Namespace
  269. */
  270. define('SIMPLEPIE_NAMESPACE_DC_11', 'http://purl.org/dc/elements/1.1/');
  271. /**
  272. * W3C Basic Geo (WGS84 lat/long) Vocabulary Namespace
  273. */
  274. define('SIMPLEPIE_NAMESPACE_W3C_BASIC_GEO', 'http://www.w3.org/2003/01/geo/wgs84_pos#');
  275. /**
  276. * GeoRSS Namespace
  277. */
  278. define('SIMPLEPIE_NAMESPACE_GEORSS', 'http://www.georss.org/georss');
  279. /**
  280. * Media RSS Namespace
  281. */
  282. define('SIMPLEPIE_NAMESPACE_MEDIARSS', 'http://search.yahoo.com/mrss/');
  283. /**
  284. * Wrong Media RSS Namespace. Caused by a long-standing typo in the spec.
  285. */
  286. define('SIMPLEPIE_NAMESPACE_MEDIARSS_WRONG', 'http://search.yahoo.com/mrss');
  287. /**
  288. * Wrong Media RSS Namespace #2. New namespace introduced in Media RSS 1.5.
  289. */
  290. define('SIMPLEPIE_NAMESPACE_MEDIARSS_WRONG2', 'http://video.search.yahoo.com/mrss');
  291. /**
  292. * Wrong Media RSS Namespace #3. A possible typo of the Media RSS 1.5 namespace.
  293. */
  294. define('SIMPLEPIE_NAMESPACE_MEDIARSS_WRONG3', 'http://video.search.yahoo.com/mrss/');
  295. /**
  296. * Wrong Media RSS Namespace #4. New spec location after the RSS Advisory Board takes it over, but not a valid namespace.
  297. */
  298. define('SIMPLEPIE_NAMESPACE_MEDIARSS_WRONG4', 'http://www.rssboard.org/media-rss');
  299. /**
  300. * Wrong Media RSS Namespace #5. A possible typo of the RSS Advisory Board URL.
  301. */
  302. define('SIMPLEPIE_NAMESPACE_MEDIARSS_WRONG5', 'http://www.rssboard.org/media-rss/');
  303. /**
  304. * iTunes RSS Namespace
  305. */
  306. define('SIMPLEPIE_NAMESPACE_ITUNES', 'http://www.itunes.com/dtds/podcast-1.0.dtd');
  307. /**
  308. * XHTML Namespace
  309. */
  310. define('SIMPLEPIE_NAMESPACE_XHTML', 'http://www.w3.org/1999/xhtml');
  311. /**
  312. * IANA Link Relations Registry
  313. */
  314. define('SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY', 'http://www.iana.org/assignments/relation/');
  315. /**
  316. * No file source
  317. */
  318. define('SIMPLEPIE_FILE_SOURCE_NONE', 0);
  319. /**
  320. * Remote file source
  321. */
  322. define('SIMPLEPIE_FILE_SOURCE_REMOTE', 1);
  323. /**
  324. * Local file source
  325. */
  326. define('SIMPLEPIE_FILE_SOURCE_LOCAL', 2);
  327. /**
  328. * fsockopen() file source
  329. */
  330. define('SIMPLEPIE_FILE_SOURCE_FSOCKOPEN', 4);
  331. /**
  332. * cURL file source
  333. */
  334. define('SIMPLEPIE_FILE_SOURCE_CURL', 8);
  335. /**
  336. * file_get_contents() file source
  337. */
  338. define('SIMPLEPIE_FILE_SOURCE_FILE_GET_CONTENTS', 16);
  339. /**
  340. * SimplePie
  341. *
  342. * @package SimplePie
  343. * @subpackage API
  344. */
  345. class SimplePie
  346. {
  347. /**
  348. * @var array Raw data
  349. * @access private
  350. */
  351. public $data = array();
  352. /**
  353. * @var mixed Error string
  354. * @access private
  355. */
  356. public $error;
  357. /**
  358. * @var int HTTP status code
  359. * @see SimplePie::status_code()
  360. * @access private
  361. */
  362. public $status_code;
  363. /**
  364. * @var object Instance of SimplePie_Sanitize (or other class)
  365. * @see SimplePie::set_sanitize_class()
  366. * @access private
  367. */
  368. public $sanitize;
  369. /**
  370. * @var string SimplePie Useragent
  371. * @see SimplePie::set_useragent()
  372. * @access private
  373. */
  374. public $useragent = SIMPLEPIE_USERAGENT;
  375. /**
  376. * @var string Feed URL
  377. * @see SimplePie::set_feed_url()
  378. * @access private
  379. */
  380. public $feed_url;
  381. /**
  382. * @var string Original feed URL, or new feed URL iff HTTP 301 Moved Permanently
  383. * @see SimplePie::subscribe_url()
  384. * @access private
  385. */
  386. public $permanent_url = null;
  387. /**
  388. * @var object Instance of SimplePie_File to use as a feed
  389. * @see SimplePie::set_file()
  390. * @access private
  391. */
  392. public $file;
  393. /**
  394. * @var string Raw feed data
  395. * @see SimplePie::set_raw_data()
  396. * @access private
  397. */
  398. public $raw_data;
  399. /**
  400. * @var int Timeout for fetching remote files
  401. * @see SimplePie::set_timeout()
  402. * @access private
  403. */
  404. public $timeout = 10;
  405. /**
  406. * @var array Custom curl options
  407. * @see SimplePie::set_curl_options()
  408. * @access private
  409. */
  410. public $curl_options = array();
  411. /**
  412. * @var bool Forces fsockopen() to be used for remote files instead
  413. * of cURL, even if a new enough version is installed
  414. * @see SimplePie::force_fsockopen()
  415. * @access private
  416. */
  417. public $force_fsockopen = false;
  418. /**
  419. * @var bool Force the given data/URL to be treated as a feed no matter what
  420. * it appears like
  421. * @see SimplePie::force_feed()
  422. * @access private
  423. */
  424. public $force_feed = false;
  425. /**
  426. * @var bool Enable/Disable Caching
  427. * @see SimplePie::enable_cache()
  428. * @access private
  429. */
  430. public $cache = true;
  431. /**
  432. * @var bool Force SimplePie to fallback to expired cache, if enabled,
  433. * when feed is unavailable.
  434. * @see SimplePie::force_cache_fallback()
  435. * @access private
  436. */
  437. public $force_cache_fallback = false;
  438. /**
  439. * @var int Cache duration (in seconds)
  440. * @see SimplePie::set_cache_duration()
  441. * @access private
  442. */
  443. public $cache_duration = 3600;
  444. /**
  445. * @var int Auto-discovery cache duration (in seconds)
  446. * @see SimplePie::set_autodiscovery_cache_duration()
  447. * @access private
  448. */
  449. public $autodiscovery_cache_duration = 604800; // 7 Days.
  450. /**
  451. * @var string Cache location (relative to executing script)
  452. * @see SimplePie::set_cache_location()
  453. * @access private
  454. */
  455. public $cache_location = './cache';
  456. /**
  457. * @var string Function that creates the cache filename
  458. * @see SimplePie::set_cache_name_function()
  459. * @access private
  460. */
  461. public $cache_name_function = 'md5';
  462. /**
  463. * @var bool Reorder feed by date descending
  464. * @see SimplePie::enable_order_by_date()
  465. * @access private
  466. */
  467. public $order_by_date = true;
  468. /**
  469. * @var mixed Force input encoding to be set to the follow value
  470. * (false, or anything type-cast to false, disables this feature)
  471. * @see SimplePie::set_input_encoding()
  472. * @access private
  473. */
  474. public $input_encoding = false;
  475. /**
  476. * @var int Feed Autodiscovery Level
  477. * @see SimplePie::set_autodiscovery_level()
  478. * @access private
  479. */
  480. public $autodiscovery = SIMPLEPIE_LOCATOR_ALL;
  481. /**
  482. * Class registry object
  483. *
  484. * @var SimplePie_Registry
  485. */
  486. public $registry;
  487. /**
  488. * @var int Maximum number of feeds to check with autodiscovery
  489. * @see SimplePie::set_max_checked_feeds()
  490. * @access private
  491. */
  492. public $max_checked_feeds = 10;
  493. /**
  494. * @var array All the feeds found during the autodiscovery process
  495. * @see SimplePie::get_all_discovered_feeds()
  496. * @access private
  497. */
  498. public $all_discovered_feeds = array();
  499. /**
  500. * @var string Web-accessible path to the handler_image.php file.
  501. * @see SimplePie::set_image_handler()
  502. * @access private
  503. */
  504. public $image_handler = '';
  505. /**
  506. * @var array Stores the URLs when multiple feeds are being initialized.
  507. * @see SimplePie::set_feed_url()
  508. * @access private
  509. */
  510. public $multifeed_url = array();
  511. /**
  512. * @var array Stores SimplePie objects when multiple feeds initialized.
  513. * @access private
  514. */
  515. public $multifeed_objects = array();
  516. /**
  517. * @var array Stores the get_object_vars() array for use with multifeeds.
  518. * @see SimplePie::set_feed_url()
  519. * @access private
  520. */
  521. public $config_settings = null;
  522. /**
  523. * @var integer Stores the number of items to return per-feed with multifeeds.
  524. * @see SimplePie::set_item_limit()
  525. * @access private
  526. */
  527. public $item_limit = 0;
  528. /**
  529. * @var bool Stores if last-modified and/or etag headers were sent with the
  530. * request when checking a feed.
  531. */
  532. public $check_modified = false;
  533. /**
  534. * @var array Stores the default attributes to be stripped by strip_attributes().
  535. * @see SimplePie::strip_attributes()
  536. * @access private
  537. */
  538. public $strip_attributes = array('bgsound', 'class', 'expr', 'id', 'style', 'onclick', 'onerror', 'onfinish', 'onmouseover', 'onmouseout', 'onfocus', 'onblur', 'lowsrc', 'dynsrc');
  539. /**
  540. * @var array Stores the default attributes to add to different tags by add_attributes().
  541. * @see SimplePie::add_attributes()
  542. * @access private
  543. */
  544. public $add_attributes = array('audio' => array('preload' => 'none'), 'iframe' => array('sandbox' => 'allow-scripts allow-same-origin'), 'video' => array('preload' => 'none'));
  545. /**
  546. * @var array Stores the default tags to be stripped by strip_htmltags().
  547. * @see SimplePie::strip_htmltags()
  548. * @access private
  549. */
  550. public $strip_htmltags = array('base', 'blink', 'body', 'doctype', 'embed', 'font', 'form', 'frame', 'frameset', 'html', 'iframe', 'input', 'marquee', 'meta', 'noscript', 'object', 'param', 'script', 'style');
  551. /**
  552. * @var bool Should we throw exceptions, or use the old-style error property?
  553. * @access private
  554. */
  555. public $enable_exceptions = false;
  556. /**
  557. * Use syslog to report HTTP requests done by SimplePie.
  558. * @see SimplePie::set_syslog()
  559. */
  560. public $syslog_enabled = SIMPLEPIE_SYSLOG;
  561. /**
  562. * The SimplePie class contains feed level data and options
  563. *
  564. * To use SimplePie, create the SimplePie object with no parameters. You can
  565. * then set configuration options using the provided methods. After setting
  566. * them, you must initialise the feed using $feed->init(). At that point the
  567. * object's methods and properties will be available to you.
  568. *
  569. * Previously, it was possible to pass in the feed URL along with cache
  570. * options directly into the constructor. This has been removed as of 1.3 as
  571. * it caused a lot of confusion.
  572. *
  573. * @since 1.0 Preview Release
  574. */
  575. public function __construct()
  576. {
  577. if (version_compare(PHP_VERSION, '5.6', '<'))
  578. {
  579. trigger_error('Please upgrade to PHP 5.6 or newer.');
  580. die();
  581. }
  582. // Other objects, instances created here so we can set options on them
  583. $this->sanitize = new SimplePie_Sanitize();
  584. $this->registry = new SimplePie_Registry();
  585. if (func_num_args() > 0)
  586. {
  587. $level = defined('E_USER_DEPRECATED') ? E_USER_DEPRECATED : E_USER_WARNING;
  588. 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);
  589. $args = func_get_args();
  590. switch (count($args)) {
  591. case 3:
  592. $this->set_cache_duration($args[2]);
  593. case 2:
  594. $this->set_cache_location($args[1]);
  595. case 1:
  596. $this->set_feed_url($args[0]);
  597. $this->init();
  598. }
  599. }
  600. }
  601. /**
  602. * Used for converting object to a string
  603. */
  604. public function __toString()
  605. {
  606. return md5(serialize($this->data));
  607. }
  608. /**
  609. * Remove items that link back to this before destroying this object
  610. */
  611. public function __destruct()
  612. {
  613. if (!gc_enabled())
  614. {
  615. if (!empty($this->data['items']))
  616. {
  617. foreach ($this->data['items'] as $item)
  618. {
  619. $item->__destruct();
  620. }
  621. unset($item, $this->data['items']);
  622. }
  623. if (!empty($this->data['ordered_items']))
  624. {
  625. foreach ($this->data['ordered_items'] as $item)
  626. {
  627. $item->__destruct();
  628. }
  629. unset($item, $this->data['ordered_items']);
  630. }
  631. }
  632. }
  633. /**
  634. * Force the given data/URL to be treated as a feed
  635. *
  636. * This tells SimplePie to ignore the content-type provided by the server.
  637. * Be careful when using this option, as it will also disable autodiscovery.
  638. *
  639. * @since 1.1
  640. * @param bool $enable Force the given data/URL to be treated as a feed
  641. */
  642. public function force_feed($enable = false)
  643. {
  644. $this->force_feed = (bool) $enable;
  645. }
  646. /**
  647. * Set the URL of the feed you want to parse
  648. *
  649. * This allows you to enter the URL of the feed you want to parse, or the
  650. * website you want to try to use auto-discovery on. This takes priority
  651. * over any set raw data.
  652. *
  653. * You can set multiple feeds to mash together by passing an array instead
  654. * of a string for the $url. Remember that with each additional feed comes
  655. * additional processing and resources.
  656. *
  657. * @since 1.0 Preview Release
  658. * @see set_raw_data()
  659. * @param string|array $url This is the URL (or array of URLs) that you want to parse.
  660. */
  661. public function set_feed_url($url)
  662. {
  663. $this->multifeed_url = array();
  664. if (is_array($url))
  665. {
  666. foreach ($url as $value)
  667. {
  668. $this->multifeed_url[] = $this->registry->call('Misc', 'fix_protocol', array($value, 1));
  669. }
  670. }
  671. else
  672. {
  673. $this->feed_url = $this->registry->call('Misc', 'fix_protocol', array($url, 1));
  674. $this->permanent_url = $this->feed_url;
  675. }
  676. }
  677. /**
  678. * Set an instance of {@see SimplePie_File} to use as a feed
  679. *
  680. * @param SimplePie_File &$file
  681. * @return bool True on success, false on failure
  682. */
  683. public function set_file(&$file)
  684. {
  685. if ($file instanceof SimplePie_File)
  686. {
  687. $this->feed_url = $file->url;
  688. $this->permanent_url = $this->feed_url;
  689. $this->file =& $file;
  690. return true;
  691. }
  692. return false;
  693. }
  694. /**
  695. * Set the raw XML data to parse
  696. *
  697. * Allows you to use a string of RSS/Atom data instead of a remote feed.
  698. *
  699. * If you have a feed available as a string in PHP, you can tell SimplePie
  700. * to parse that data string instead of a remote feed. Any set feed URL
  701. * takes precedence.
  702. *
  703. * @since 1.0 Beta 3
  704. * @param string $data RSS or Atom data as a string.
  705. * @see set_feed_url()
  706. */
  707. public function set_raw_data($data)
  708. {
  709. $this->raw_data = $data;
  710. }
  711. /**
  712. * Set the default timeout for fetching remote feeds
  713. *
  714. * This allows you to change the maximum time the feed's server to respond
  715. * and send the feed back.
  716. *
  717. * @since 1.0 Beta 3
  718. * @param int $timeout The maximum number of seconds to spend waiting to retrieve a feed.
  719. */
  720. public function set_timeout($timeout = 10)
  721. {
  722. $this->timeout = (int) $timeout;
  723. }
  724. /**
  725. * Set custom curl options
  726. *
  727. * This allows you to change default curl options
  728. *
  729. * @since 1.0 Beta 3
  730. * @param array $curl_options Curl options to add to default settings
  731. */
  732. public function set_curl_options(array $curl_options = array())
  733. {
  734. $this->curl_options = $curl_options;
  735. }
  736. /**
  737. * Force SimplePie to use fsockopen() instead of cURL
  738. *
  739. * @since 1.0 Beta 3
  740. * @param bool $enable Force fsockopen() to be used
  741. */
  742. public function force_fsockopen($enable = false)
  743. {
  744. $this->force_fsockopen = (bool) $enable;
  745. }
  746. /**
  747. * Enable/disable caching in SimplePie.
  748. *
  749. * This option allows you to disable caching all-together in SimplePie.
  750. * However, disabling the cache can lead to longer load times.
  751. *
  752. * @since 1.0 Preview Release
  753. * @param bool $enable Enable caching
  754. */
  755. public function enable_cache($enable = true)
  756. {
  757. $this->cache = (bool) $enable;
  758. }
  759. /**
  760. * SimplePie to continue to fall back to expired cache, if enabled, when
  761. * feed is unavailable.
  762. *
  763. * This tells SimplePie to ignore any file errors and fall back to cache
  764. * instead. This only works if caching is enabled and cached content
  765. * still exists.
  766. * @param bool $enable Force use of cache on fail.
  767. */
  768. public function force_cache_fallback($enable = false)
  769. {
  770. $this->force_cache_fallback= (bool) $enable;
  771. }
  772. /**
  773. * Set the length of time (in seconds) that the contents of a feed will be
  774. * cached
  775. *
  776. * @param int $seconds The feed content cache duration
  777. */
  778. public function set_cache_duration($seconds = 3600)
  779. {
  780. $this->cache_duration = (int) $seconds;
  781. }
  782. /**
  783. * Set the length of time (in seconds) that the autodiscovered feed URL will
  784. * be cached
  785. *
  786. * @param int $seconds The autodiscovered feed URL cache duration.
  787. */
  788. public function set_autodiscovery_cache_duration($seconds = 604800)
  789. {
  790. $this->autodiscovery_cache_duration = (int) $seconds;
  791. }
  792. /**
  793. * Set the file system location where the cached files should be stored
  794. *
  795. * @param string $location The file system location.
  796. */
  797. public function set_cache_location($location = './cache')
  798. {
  799. $this->cache_location = (string) $location;
  800. }
  801. /**
  802. * Return the filename (i.e. hash, without path and without extension) of the file to cache a given URL.
  803. * @param string $url The URL of the feed to be cached.
  804. * @return string A filename (i.e. hash, without path and without extension).
  805. */
  806. public function get_cache_filename($url)
  807. {
  808. // Append custom parameters to the URL to avoid cache pollution in case of multiple calls with different parameters.
  809. $url .= $this->force_feed ? '#force_feed' : '';
  810. $options = array();
  811. if ($this->timeout != 10)
  812. {
  813. $options[CURLOPT_TIMEOUT] = $this->timeout;
  814. }
  815. if ($this->useragent !== SIMPLEPIE_USERAGENT)
  816. {
  817. $options[CURLOPT_USERAGENT] = $this->useragent;
  818. }
  819. if (!empty($this->curl_options))
  820. {
  821. foreach ($this->curl_options as $k => $v)
  822. {
  823. $options[$k] = $v;
  824. }
  825. }
  826. if (!empty($options))
  827. {
  828. ksort($options);
  829. $url .= '#' . urlencode(var_export($options, true));
  830. }
  831. return call_user_func($this->cache_name_function, $url);
  832. }
  833. /**
  834. * Set whether feed items should be sorted into reverse chronological order
  835. *
  836. * @param bool $enable Sort as reverse chronological order.
  837. */
  838. public function enable_order_by_date($enable = true)
  839. {
  840. $this->order_by_date = (bool) $enable;
  841. }
  842. /**
  843. * Set the character encoding used to parse the feed
  844. *
  845. * This overrides the encoding reported by the feed, however it will fall
  846. * back to the normal encoding detection if the override fails
  847. *
  848. * @param string $encoding Character encoding
  849. */
  850. public function set_input_encoding($encoding = false)
  851. {
  852. if ($encoding)
  853. {
  854. $this->input_encoding = (string) $encoding;
  855. }
  856. else
  857. {
  858. $this->input_encoding = false;
  859. }
  860. }
  861. /**
  862. * Set how much feed autodiscovery to do
  863. *
  864. * @see SIMPLEPIE_LOCATOR_NONE
  865. * @see SIMPLEPIE_LOCATOR_AUTODISCOVERY
  866. * @see SIMPLEPIE_LOCATOR_LOCAL_EXTENSION
  867. * @see SIMPLEPIE_LOCATOR_LOCAL_BODY
  868. * @see SIMPLEPIE_LOCATOR_REMOTE_EXTENSION
  869. * @see SIMPLEPIE_LOCATOR_REMOTE_BODY
  870. * @see SIMPLEPIE_LOCATOR_ALL
  871. * @param int $level Feed Autodiscovery Level (level can be a combination of the above constants, see bitwise OR operator)
  872. */
  873. public function set_autodiscovery_level($level = SIMPLEPIE_LOCATOR_ALL)
  874. {
  875. $this->autodiscovery = (int) $level;
  876. }
  877. /**
  878. * Get the class registry
  879. *
  880. * Use this to override SimplePie's default classes
  881. * @see SimplePie_Registry
  882. * @return SimplePie_Registry
  883. */
  884. public function &get_registry()
  885. {
  886. return $this->registry;
  887. }
  888. /**#@+
  889. * Useful when you are overloading or extending SimplePie's default classes.
  890. *
  891. * @deprecated Use {@see get_registry()} instead
  892. * @link http://php.net/manual/en/language.oop5.basic.php#language.oop5.basic.extends PHP5 extends documentation
  893. * @param string $class Name of custom class
  894. * @return boolean True on success, false otherwise
  895. */
  896. /**
  897. * Set which class SimplePie uses for caching
  898. */
  899. public function set_cache_class($class = 'SimplePie_Cache')
  900. {
  901. return $this->registry->register('Cache', $class, true);
  902. }
  903. /**
  904. * Set which class SimplePie uses for auto-discovery
  905. */
  906. public function set_locator_class($class = 'SimplePie_Locator')
  907. {
  908. return $this->registry->register('Locator', $class, true);
  909. }
  910. /**
  911. * Set which class SimplePie uses for XML parsing
  912. */
  913. public function set_parser_class($class = 'SimplePie_Parser')
  914. {
  915. return $this->registry->register('Parser', $class, true);
  916. }
  917. /**
  918. * Set which class SimplePie uses for remote file fetching
  919. */
  920. public function set_file_class($class = 'SimplePie_File')
  921. {
  922. return $this->registry->register('File', $class, true);
  923. }
  924. /**
  925. * Set which class SimplePie uses for data sanitization
  926. */
  927. public function set_sanitize_class($class = 'SimplePie_Sanitize')
  928. {
  929. return $this->registry->register('Sanitize', $class, true);
  930. }
  931. /**
  932. * Set which class SimplePie uses for handling feed items
  933. */
  934. public function set_item_class($class = 'SimplePie_Item')
  935. {
  936. return $this->registry->register('Item', $class, true);
  937. }
  938. /**
  939. * Set which class SimplePie uses for handling author data
  940. */
  941. public function set_author_class($class = 'SimplePie_Author')
  942. {
  943. return $this->registry->register('Author', $class, true);
  944. }
  945. /**
  946. * Set which class SimplePie uses for handling category data
  947. */
  948. public function set_category_class($class = 'SimplePie_Category')
  949. {
  950. return $this->registry->register('Category', $class, true);
  951. }
  952. /**
  953. * Set which class SimplePie uses for feed enclosures
  954. */
  955. public function set_enclosure_class($class = 'SimplePie_Enclosure')
  956. {
  957. return $this->registry->register('Enclosure', $class, true);
  958. }
  959. /**
  960. * Set which class SimplePie uses for `<media:text>` captions
  961. */
  962. public function set_caption_class($class = 'SimplePie_Caption')
  963. {
  964. return $this->registry->register('Caption', $class, true);
  965. }
  966. /**
  967. * Set which class SimplePie uses for `<media:copyright>`
  968. */
  969. public function set_copyright_class($class = 'SimplePie_Copyright')
  970. {
  971. return $this->registry->register('Copyright', $class, true);
  972. }
  973. /**
  974. * Set which class SimplePie uses for `<media:credit>`
  975. */
  976. public function set_credit_class($class = 'SimplePie_Credit')
  977. {
  978. return $this->registry->register('Credit', $class, true);
  979. }
  980. /**
  981. * Set which class SimplePie uses for `<media:rating>`
  982. */
  983. public function set_rating_class($class = 'SimplePie_Rating')
  984. {
  985. return $this->registry->register('Rating', $class, true);
  986. }
  987. /**
  988. * Set which class SimplePie uses for `<media:restriction>`
  989. */
  990. public function set_restriction_class($class = 'SimplePie_Restriction')
  991. {
  992. return $this->registry->register('Restriction', $class, true);
  993. }
  994. /**
  995. * Set which class SimplePie uses for content-type sniffing
  996. */
  997. public function set_content_type_sniffer_class($class = 'SimplePie_Content_Type_Sniffer')
  998. {
  999. return $this->registry->register('Content_Type_Sniffer', $class, true);
  1000. }
  1001. /**
  1002. * Set which class SimplePie uses item sources
  1003. */
  1004. public function set_source_class($class = 'SimplePie_Source')
  1005. {
  1006. return $this->registry->register('Source', $class, true);
  1007. }
  1008. /**#@-*/
  1009. /**
  1010. * Set the user agent string
  1011. *
  1012. * @param string $ua New user agent string.
  1013. */
  1014. public function set_useragent($ua = SIMPLEPIE_USERAGENT)
  1015. {
  1016. $this->useragent = (string) $ua;
  1017. }
  1018. /**
  1019. * Set callback function to create cache filename with
  1020. *
  1021. * @param mixed $function Callback function
  1022. */
  1023. public function set_cache_name_function($function = 'md5')
  1024. {
  1025. if (is_callable($function))
  1026. {
  1027. $this->cache_name_function = $function;
  1028. }
  1029. }
  1030. /**
  1031. * Set options to make SP as fast as possible
  1032. *
  1033. * Forgoes a substantial amount of data sanitization in favor of speed. This
  1034. * turns SimplePie into a dumb parser of feeds.
  1035. *
  1036. * @param bool $set Whether to set them or not
  1037. */
  1038. public function set_stupidly_fast($set = false)
  1039. {
  1040. if ($set)
  1041. {
  1042. $this->enable_order_by_date(false);
  1043. $this->remove_div(false);
  1044. $this->strip_comments(false);
  1045. $this->strip_htmltags(false);
  1046. $this->strip_attributes(false);
  1047. $this->add_attributes(false);
  1048. $this->set_image_handler(false);
  1049. $this->set_https_domains(array());
  1050. }
  1051. }
  1052. /**
  1053. * Set maximum number of feeds to check with autodiscovery
  1054. *
  1055. * @param int $max Maximum number of feeds to check
  1056. */
  1057. public function set_max_checked_feeds($max = 10)
  1058. {
  1059. $this->max_checked_feeds = (int) $max;
  1060. }
  1061. public function remove_div($enable = true)
  1062. {
  1063. $this->sanitize->remove_div($enable);
  1064. }
  1065. public function strip_htmltags($tags = '', $encode = null)
  1066. {
  1067. if ($tags === '')
  1068. {
  1069. $tags = $this->strip_htmltags;
  1070. }
  1071. $this->sanitize->strip_htmltags($tags);
  1072. if ($encode !== null)
  1073. {
  1074. $this->sanitize->encode_instead_of_strip($tags);
  1075. }
  1076. }
  1077. public function encode_instead_of_strip($enable = true)
  1078. {
  1079. $this->sanitize->encode_instead_of_strip($enable);
  1080. }
  1081. public function strip_attributes($attribs = '')
  1082. {
  1083. if ($attribs === '')
  1084. {
  1085. $attribs = $this->strip_attributes;
  1086. }
  1087. $this->sanitize->strip_attributes($attribs);
  1088. }
  1089. public function add_attributes($attribs = '')
  1090. {
  1091. if ($attribs === '')
  1092. {
  1093. $attribs = $this->add_attributes;
  1094. }
  1095. $this->sanitize->add_attributes($attribs);
  1096. }
  1097. /**
  1098. * Use syslog to report HTTP requests done by SimplePie.
  1099. */
  1100. public function set_syslog($value = SIMPLEPIE_SYSLOG) //FreshRSS
  1101. {
  1102. $this->syslog_enabled = $value == true;
  1103. }
  1104. /**
  1105. * Set the output encoding
  1106. *
  1107. * Allows you to override SimplePie's output to match that of your webpage.
  1108. * This is useful for times when your webpages are not being served as
  1109. * UTF-8. This setting will be obeyed by {@see handle_content_type()}, and
  1110. * is similar to {@see set_input_encoding()}.
  1111. *
  1112. * It should be noted, however, that not all character encodings can support
  1113. * all characters. If your page is being served as ISO-8859-1 and you try
  1114. * to display a Japanese feed, you'll likely see garbled characters.
  1115. * Because of this, it is highly recommended to ensure that your webpages
  1116. * are served as UTF-8.
  1117. *
  1118. * The number of supported character encodings depends on whether your web
  1119. * host supports {@link http://php.net/mbstring mbstring},
  1120. * {@link http://php.net/iconv iconv}, or both. See
  1121. * {@link http://simplepie.org/wiki/faq/Supported_Character_Encodings} for
  1122. * more information.
  1123. *
  1124. * @param string $encoding
  1125. */
  1126. public function set_output_encoding($encoding = 'UTF-8')
  1127. {
  1128. $this->sanitize->set_output_encoding($encoding);
  1129. }
  1130. public function strip_comments($strip = false)
  1131. {
  1132. $this->sanitize->strip_comments($strip);
  1133. }
  1134. /**
  1135. * Set element/attribute key/value pairs of HTML attributes
  1136. * containing URLs that need to be resolved relative to the feed
  1137. *
  1138. * Defaults to |a|@href, |area|@href, |blockquote|@cite, |del|@cite,
  1139. * |form|@action, |img|@longdesc, |img|@src, |input|@src, |ins|@cite,
  1140. * |q|@cite
  1141. *
  1142. * @since 1.0
  1143. * @param array|null $element_attribute Element/attribute key/value pairs, null for default
  1144. */
  1145. public function set_url_replacements($element_attribute = null)
  1146. {
  1147. $this->sanitize->set_url_replacements($element_attribute);
  1148. }
  1149. /**
  1150. * Set the list of domains for which to force HTTPS.
  1151. * @see SimplePie_Sanitize::set_https_domains()
  1152. * @param array List of HTTPS domains. Example array('biz', 'example.com', 'example.org', 'www.example.net').
  1153. */
  1154. public function set_https_domains($domains = array())
  1155. {
  1156. if (is_array($domains))
  1157. {
  1158. $this->sanitize->set_https_domains($domains);
  1159. }
  1160. }
  1161. /**
  1162. * Set the handler to enable the display of cached images.
  1163. *
  1164. * @param string $page Web-accessible path to the handler_image.php file.
  1165. * @param string $qs The query string that the value should be passed to.
  1166. */
  1167. public function set_image_handler($page = false, $qs = 'i')
  1168. {
  1169. if ($page !== false)
  1170. {
  1171. $this->sanitize->set_image_handler($page . '?' . $qs . '=');
  1172. }
  1173. else
  1174. {
  1175. $this->image_handler = '';
  1176. }
  1177. }
  1178. /**
  1179. * Set the limit for items returned per-feed with multifeeds
  1180. *
  1181. * @param integer $limit The maximum number of items to return.
  1182. */
  1183. public function set_item_limit($limit = 0)
  1184. {
  1185. $this->item_limit = (int) $limit;
  1186. }
  1187. /**
  1188. * Enable throwing exceptions
  1189. *
  1190. * @param boolean $enable Should we throw exceptions, or use the old-style error property?
  1191. */
  1192. public function enable_exceptions($enable = true)
  1193. {
  1194. $this->enable_exceptions = $enable;
  1195. }
  1196. function cleanMd5($rss)
  1197. {
  1198. //Process by chunks not to use too much memory
  1199. if (($stream = fopen('php://temp', 'r+')) &&
  1200. fwrite($stream, $rss) &&
  1201. rewind($stream))
  1202. {
  1203. $ctx = hash_init('md5');
  1204. while ($stream_data = fread($stream, 1048576))
  1205. {
  1206. hash_update($ctx, preg_replace([
  1207. '#<(lastBuildDate|pubDate|updated|feedDate|dc:date|slash:comments)>[^<]+</\\1>#',
  1208. '#<(media:starRating|media:statistics) [^/<>]+/>#',
  1209. '#<!--.+?-->#s',
  1210. ], '', $stream_data));
  1211. }
  1212. fclose($stream);
  1213. return hash_final($ctx);
  1214. }
  1215. return '';
  1216. }
  1217. /**
  1218. * Initialize the feed object
  1219. *
  1220. * This is what makes everything happen. Period. This is where all of the
  1221. * configuration options get processed, feeds are fetched, cached, and
  1222. * parsed, and all of that other good stuff.
  1223. *
  1224. * @return boolean|integer positive integer with modification time if using cache, boolean true if otherwise successful, false otherwise
  1225. */
  1226. public function init()
  1227. {
  1228. // Check absolute bare minimum requirements.
  1229. if (!extension_loaded('xml') || !extension_loaded('pcre'))
  1230. {
  1231. $this->error = 'XML or PCRE extensions not loaded!';
  1232. return false;
  1233. }
  1234. // 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.
  1235. elseif (!extension_loaded('xmlreader'))
  1236. {
  1237. static $xml_is_sane = null;
  1238. if ($xml_is_sane === null)
  1239. {
  1240. $parser_check = xml_parser_create();
  1241. xml_parse_into_struct($parser_check, '<foo>&amp;</foo>', $values);
  1242. xml_parser_free($parser_check);
  1243. $xml_is_sane = isset($values[0]['value']);
  1244. }
  1245. if (!$xml_is_sane)
  1246. {
  1247. return false;
  1248. }
  1249. }
  1250. // The default sanitize class gets set in the constructor, check if it has
  1251. // changed.
  1252. if ($this->registry->get_class('Sanitize') !== 'SimplePie_Sanitize') {
  1253. $this->sanitize = $this->registry->create('Sanitize');
  1254. }
  1255. if (method_exists($this->sanitize, 'set_registry'))
  1256. {
  1257. $this->sanitize->set_registry($this->registry);
  1258. }
  1259. // Pass whatever was set with config options over to the sanitizer.
  1260. // Pass the classes in for legacy support; new classes should use the registry instead
  1261. $this->sanitize->pass_cache_data($this->cache, $this->cache_location, $this->cache_name_function, $this->registry->get_class('Cache'));
  1262. $this->sanitize->pass_file_data($this->registry->get_class('File'), $this->timeout, $this->useragent, $this->force_fsockopen, $this->curl_options);
  1263. if (!empty($this->multifeed_url))
  1264. {
  1265. $i = 0;
  1266. $success = 0;
  1267. $this->multifeed_objects = array();
  1268. $this->error = array();
  1269. foreach ($this->multifeed_url as $url)
  1270. {
  1271. $this->multifeed_objects[$i] = clone $this;
  1272. $this->multifeed_objects[$i]->set_feed_url($url);
  1273. $single_success = $this->multifeed_objects[$i]->init();
  1274. $success |= $single_success;
  1275. if (!$single_success)
  1276. {
  1277. $this->error[$i] = $this->multifeed_objects[$i]->error();
  1278. }
  1279. $i++;
  1280. }
  1281. return (bool) $success;
  1282. }
  1283. elseif ($this->feed_url === null && $this->raw_data === null)
  1284. {
  1285. return false;
  1286. }
  1287. $this->error = null;
  1288. $this->data = array();
  1289. $this->check_modified = false;
  1290. $this->multifeed_objects = array();
  1291. $cache = false;
  1292. if ($this->feed_url !== null)
  1293. {
  1294. $parsed_feed_url = $this->registry->call('Misc', 'parse_url', array($this->feed_url));
  1295. // Decide whether to enable caching
  1296. if ($this->cache && $parsed_feed_url['scheme'] !== '')
  1297. {
  1298. $filename = $this->get_cache_filename($this->feed_url);
  1299. $cache = $this->registry->call('Cache', 'get_handler', array($this->cache_location, $filename, 'spc'));
  1300. }
  1301. // Fetch the data via SimplePie_File into $this->raw_data
  1302. if (($fetched = $this->fetch_data($cache)) === true)
  1303. {
  1304. return empty($this->data['mtime']) ? false : $this->data['mtime'];
  1305. }
  1306. elseif ($fetched === false) {
  1307. return false;
  1308. }
  1309. list($headers, $sniffed) = $fetched;
  1310. if (isset($this->data['md5']))
  1311. {
  1312. $md5 = $this->data['md5'];
  1313. }
  1314. }
  1315. // Empty response check
  1316. if(empty($this->raw_data)){
  1317. $this->error = "A feed could not be found at `$this->feed_url`. Empty body.";
  1318. $this->registry->call('Misc', 'error', array($this->error, E_USER_NOTICE, __FILE__, __LINE__));
  1319. return false;
  1320. }
  1321. // Set up array of possible encodings
  1322. $encodings = array();
  1323. // First check to see if input has been overridden.
  1324. if ($this->input_encoding !== false)
  1325. {
  1326. $encodings[] = strtoupper($this->input_encoding);
  1327. }
  1328. $application_types = array('application/xml', 'application/xml-dtd', 'application/xml-external-parsed-entity');
  1329. $text_types = array('text/xml', 'text/xml-external-parsed-entity');
  1330. // RFC 3023 (only applies to sniffed content)
  1331. if (isset($sniffed))
  1332. {
  1333. if (in_array($sniffed, $application_types) || substr($sniffed, 0, 12) === 'application/' && substr($sniffed, -4) === '+xml')
  1334. {
  1335. if (isset($headers['content-type']) && preg_match('/;\x20?charset=([^;]*)/i', $headers['content-type'], $charset))
  1336. {
  1337. $encodings[] = strtoupper($charset[1]);
  1338. }
  1339. else
  1340. {
  1341. $encodings[] = ''; //FreshRSS: Let the DOM parser decide first
  1342. }
  1343. }
  1344. elseif (in_array($sniffed, $text_types) || substr($sniffed, 0, 5) === 'text/' && substr($sniffed, -4) === '+xml')
  1345. {
  1346. if (isset($headers['content-type']) && preg_match('/;\x20?charset=([^;]*)/i', $headers['content-type'], $charset))
  1347. {
  1348. $encodings[] = strtoupper($charset[1]);
  1349. }
  1350. else
  1351. {
  1352. $encodings[] = ''; //FreshRSS: Let the DOM parser decide first
  1353. }
  1354. $encodings[] = 'US-ASCII';
  1355. }
  1356. // Text MIME-type default
  1357. elseif (substr($sniffed, 0, 5) === 'text/')
  1358. {
  1359. $encodings[] = 'UTF-8';
  1360. }
  1361. }
  1362. // Fallback to XML 1.0 Appendix F.1/UTF-8/ISO-8859-1
  1363. $encodings = array_merge($encodings, $this->registry->call('Misc', 'xml_encoding', array($this->raw_data, &$this->registry)));
  1364. $encodings[] = 'UTF-8';
  1365. $encodings[] = 'ISO-8859-1';
  1366. // There's no point in trying an encoding twice
  1367. $encodings = array_unique($encodings);
  1368. // Loop through each possible encoding, till we return something, or run out of possibilities
  1369. foreach ($encodings as $encoding)
  1370. {
  1371. // Change the encoding to UTF-8 (as we always use UTF-8 internally)
  1372. if ($utf8_data = (empty($encoding) || $encoding === 'UTF-8') ? $this->raw_data : //FreshRSS
  1373. $this->registry->call('Misc', 'change_encoding', array($this->raw_data, $encoding, 'UTF-8')))
  1374. {
  1375. // Create new parser
  1376. $parser = $this->registry->create('Parser');
  1377. // If it's parsed fine
  1378. if ($parser->parse($utf8_data, empty($encoding) ? '' : 'UTF-8', $this->permanent_url)) //FreshRSS
  1379. {
  1380. $this->data = $parser->get_data();
  1381. if (!($this->get_type() & ~SIMPLEPIE_TYPE_NONE))
  1382. {
  1383. $this->error = "A feed could not be found at `$this->feed_url`. This does not appear to be a valid RSS or Atom feed.";
  1384. $this->registry->call('Misc', 'error', array($this->error, E_USER_NOTICE, __FILE__, __LINE__));
  1385. return false;
  1386. }
  1387. if (isset($headers))
  1388. {
  1389. $this->data['headers'] = $headers;
  1390. }
  1391. $this->data['build'] = SIMPLEPIE_BUILD;
  1392. $this->data['mtime'] = time();
  1393. $this->data['md5'] = empty($md5) ? $this->cleanMd5($this->raw_data) : $md5;
  1394. // Cache the file if caching is enabled
  1395. if ($cache && !$cache->save($this))
  1396. {
  1397. 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);
  1398. }
  1399. return true;
  1400. }
  1401. }
  1402. }
  1403. if (isset($parser))
  1404. {
  1405. // We have an error, just set SimplePie_Misc::error to it and quit
  1406. $this->error = $this->feed_url;
  1407. $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());
  1408. }
  1409. else
  1410. {
  1411. $this->error = 'The data could not be converted to UTF-8.';
  1412. if (!extension_loaded('mbstring') && !extension_loaded('iconv') && !class_exists('\UConverter')) {
  1413. $this->error .= ' You MUST have either the iconv, mbstring or intl (PHP 5.5+) extension installed and enabled.';
  1414. } else {
  1415. $missingExtensions = array();
  1416. if (!extension_loaded('iconv')) {
  1417. $missingExtensions[] = 'iconv';
  1418. }
  1419. if (!extension_loaded('mbstring')) {
  1420. $missingExtensions[] = 'mbstring';
  1421. }
  1422. if (!class_exists('\UConverter')) {
  1423. $missingExtensions[] = 'intl (PHP 5.5+)';
  1424. }
  1425. $this->error .= ' Try installing/enabling the ' . implode(' or ', $missingExtensions) . ' extension.';
  1426. }
  1427. }
  1428. $this->registry->call('Misc', 'error', array($this->error, E_USER_NOTICE, __FILE__, __LINE__));
  1429. return false;
  1430. }
  1431. /**
  1432. * Fetch the data via SimplePie_File
  1433. *
  1434. * If the data is already cached, attempt to fetch it from there instead
  1435. * @param SimplePie_Cache_Base|false $cache Cache handler, or false to not load from the cache
  1436. * @return array|true Returns true if the data was loaded from the cache, or an array of HTTP headers and sniffed type
  1437. */
  1438. protected function fetch_data(&$cache)
  1439. {
  1440. // If it's enabled, use the cache
  1441. if ($cache)
  1442. {
  1443. // Load the Cache
  1444. $this->data = $cache->load();
  1445. if ($cache->mtime() + $this->cache_duration > time())
  1446. {
  1447. $this->raw_data = false;
  1448. return true; // If the cache is still valid, just return true
  1449. }
  1450. elseif (!empty($this->data))
  1451. {
  1452. // If the cache is for an outdated build of SimplePie
  1453. if (!isset($this->data['build']) || $this->data['build'] !== SIMPLEPIE_BUILD)
  1454. {
  1455. $cache->unlink();
  1456. $this->data = array();
  1457. }
  1458. // If we've hit a collision just rerun it with caching disabled
  1459. elseif (isset($this->data['url']) && $this->data['url'] !== $this->feed_url)
  1460. {
  1461. $cache = false;
  1462. $this->data = array();
  1463. }
  1464. // If we've got a non feed_url stored (if the page isn't actually a feed, or is a redirect) use that URL.
  1465. elseif (isset($this->data['feed_url']))
  1466. {
  1467. // If the autodiscovery cache is still valid use it.
  1468. if ($cache->mtime() + $this->autodiscovery_cache_duration > time())
  1469. {
  1470. // Do not need to do feed autodiscovery yet.
  1471. if ($this->data['feed_url'] !== $this->data['url'])
  1472. {
  1473. $this->set_feed_url($this->data['feed_url']);
  1474. return $this->init();
  1475. }
  1476. $cache->unlink();
  1477. $this->data = array();
  1478. }
  1479. }
  1480. // Check if the cache has been updated
  1481. else
  1482. {
  1483. $headers = array(
  1484. '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',
  1485. );
  1486. if (isset($this->data['headers']['last-modified']))
  1487. {
  1488. $headers['if-modified-since'] = $this->data['headers']['last-modified'];
  1489. }
  1490. if (isset($this->data['headers']['etag']))
  1491. {
  1492. $headers['if-none-match'] = $this->data['headers']['etag'];
  1493. }
  1494. $file = $this->registry->create('File', array($this->feed_url, $this->timeout, 5, $headers, $this->useragent, $this->force_fsockopen, $this->curl_options, $this->syslog_enabled));
  1495. $this->status_code = $file->status_code;
  1496. if ($file->success)
  1497. {
  1498. if ($file->status_code === 304)
  1499. {
  1500. $cache->touch();
  1501. return true;
  1502. }
  1503. }
  1504. else
  1505. {
  1506. $this->check_modified = false;
  1507. $cache->touch();
  1508. $this->error = $file->error;
  1509. return !empty($this->data);
  1510. }
  1511. $md5 = $this->cleanMd5($file->body);
  1512. if ($this->data['md5'] === $md5) {
  1513. if ($this->syslog_enabled)
  1514. {
  1515. syslog(LOG_DEBUG, 'SimplePie MD5 cache match for ' . SimplePie_Misc::url_remove_credentials($this->feed_url));
  1516. }
  1517. $cache->touch();
  1518. return true; //Content unchanged even though server did not send a 304
  1519. } else {
  1520. if ($this->syslog_enabled)
  1521. {
  1522. syslog(LOG_DEBUG, 'SimplePie MD5 cache no match for ' . SimplePie_Misc::url_remove_credentials($this->feed_url));
  1523. }
  1524. $this->data['md5'] = $md5;
  1525. }
  1526. }
  1527. }
  1528. // If the cache is empty
  1529. else
  1530. {
  1531. $cache->touch(); //To keep the date/time of the last tentative update
  1532. $this->data = array();
  1533. }
  1534. }
  1535. // 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.
  1536. if (!isset($file))
  1537. {
  1538. if ($this->file instanceof SimplePie_File && $this->file->url === $this->feed_url)
  1539. {
  1540. $file =& $this->file;
  1541. }
  1542. else
  1543. {
  1544. $headers = array(
  1545. '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',
  1546. );
  1547. $file = $this->registry->create('File', array($this->feed_url, $this->timeout, 5, $headers, $this->useragent, $this->force_fsockopen, $this->curl_options, $this->syslog_enabled));
  1548. }
  1549. }
  1550. $this->status_code = $file->status_code;
  1551. // If the file connection has an error, set SimplePie::error to that and quit
  1552. if (!$file->success && !($file->method & SIMPLEPIE_FILE_SOURCE_REMOTE === 0 || ($file->status_code === 200 || $file->status_code > 206 && $file->status_code < 300)))
  1553. {
  1554. $this->error = $file->error;
  1555. return !empty($this->data);
  1556. }
  1557. if (!$this->force_feed)
  1558. {
  1559. // Check if the supplied URL is a feed, if it isn't, look for it.
  1560. $locate = $this->registry->create('Locator', array(&$file, $this->timeout, $this->useragent, $this->max_checked_feeds, $this->force_fsockopen, $this->curl_options));
  1561. if (!$locate->is_feed($file))
  1562. {
  1563. $copyStatusCode = $file->status_code;
  1564. $copyContentType = $file->headers['content-type'];
  1565. try
  1566. {
  1567. $microformats = false;
  1568. if (class_exists('DOMXpath') && function_exists('Mf2\parse')) {
  1569. $doc = new DOMDocument();
  1570. @$doc->loadHTML($file->body);
  1571. $xpath = new DOMXpath($doc);
  1572. // Check for both h-feed and h-entry, as both a feed with no entries
  1573. // and a list of entries without an h-feed wrapper are both valid.
  1574. $query = '//*[contains(concat(" ", @class, " "), " h-feed ") or '.
  1575. 'contains(concat(" ", @class, " "), " h-entry ")]';
  1576. $result = $xpath->query($query);
  1577. $microformats = $result->length !== 0;
  1578. }
  1579. // Now also do feed discovery, but if microformats were found don't
  1580. // overwrite the current value of file.
  1581. $discovered = $locate->find($this->autodiscovery,
  1582. $this->all_discovered_feeds);
  1583. if ($microformats)
  1584. {
  1585. if ($hub = $locate->get_rel_link('hub'))
  1586. {
  1587. $self = $locate->get_rel_link('self');
  1588. $this->store_links($file, $hub, $self);
  1589. }
  1590. // Push the current file onto all_discovered feeds so the user can
  1591. // be shown this as one of the options.
  1592. if (isset($this->all_discovered_feeds)) {
  1593. $this->all_discovered_feeds[] = $file;
  1594. }
  1595. }
  1596. else
  1597. {
  1598. if ($discovered)
  1599. {
  1600. $file = $discovered;
  1601. }
  1602. else
  1603. {
  1604. // We need to unset this so that if SimplePie::set_file() has
  1605. // been called that object is untouched
  1606. unset($file);
  1607. $this->error = "A feed could not be found at `$this->feed_url`; the status code is `$copyStatusCode` and content-type is `$copyContentType`";
  1608. $this->registry->call('Misc', 'error', array($this->error, E_USER_NOTICE, __FILE__, __LINE__));
  1609. return false;
  1610. }
  1611. }
  1612. }
  1613. catch (SimplePie_Exception $e)
  1614. {
  1615. // We need to unset this so that if SimplePie::set_file() has been called that object is untouched
  1616. unset($file);
  1617. // This is usually because DOMDocument doesn't exist
  1618. $this->error = $e->getMessage();
  1619. $this->registry->call('Misc', 'error', array($this->error, E_USER_NOTICE, $e->getFile(), $e->getLine()));
  1620. return false;
  1621. }
  1622. if ($cache)
  1623. {
  1624. $this->data = array('url' => $this->feed_url, 'feed_url' => $file->url, 'build' => SIMPLEPIE_BUILD);
  1625. $this->data['mtime'] = time();
  1626. $this->data['md5'] = empty($md5) ? $this->cleanMd5($file->body) : $md5;
  1627. if (!$cache->save($this))
  1628. {
  1629. 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);
  1630. }
  1631. $cache = $this->registry->call('Cache', 'get_handler', array($this->cache_location, call_user_func($this->cache_name_function, $file->url), 'spc'));
  1632. }
  1633. }
  1634. $this->feed_url = $file->url;
  1635. $locate = null;
  1636. }
  1637. $file->body = trim($file->body); //FreshRSS
  1638. $this->raw_data = $file->body;
  1639. $this->permanent_url = $file->permanent_url;
  1640. $headers = $file->headers;
  1641. $sniffer = $this->registry->create('Content_Type_Sniffer', array(&$file));
  1642. $sniffed = $sniffer->get_type();
  1643. return array($headers, $sniffed);
  1644. }
  1645. /**
  1646. * Get the error message for the occurred error
  1647. *
  1648. * @return string|array Error message, or array of messages for multifeeds
  1649. */
  1650. public function error()
  1651. {
  1652. return $this->error;
  1653. }
  1654. /**
  1655. * Get the last HTTP status code
  1656. *
  1657. * @return int Status code
  1658. */
  1659. public function status_code()
  1660. {
  1661. return $this->status_code;
  1662. }
  1663. /**
  1664. * Get the raw XML
  1665. *
  1666. * This is the same as the old `$feed->enable_xml_dump(true)`, but returns
  1667. * the data instead of printing it.
  1668. *
  1669. * @return string|boolean Raw XML data, false if the cache is used
  1670. */
  1671. public function get_raw_data()
  1672. {
  1673. return $this->raw_data;
  1674. }
  1675. /**
  1676. * Get the character encoding used for output
  1677. *
  1678. * @since Preview Release
  1679. * @return string
  1680. */
  1681. public function get_encoding()
  1682. {
  1683. return $this->sanitize->output_encoding;
  1684. }
  1685. /**
  1686. * Send the content-type header with correct encoding
  1687. *
  1688. * This method ensures that the SimplePie-enabled page is being served with
  1689. * the correct {@link http://www.iana.org/assignments/media-types/ mime-type}
  1690. * and character encoding HTTP headers (character encoding determined by the
  1691. * {@see set_output_encoding} config option).
  1692. *
  1693. * This won't work properly if any content or whitespace has already been
  1694. * sent to the browser, because it relies on PHP's
  1695. * {@link http://php.net/header header()} function, and these are the
  1696. * circumstances under which the function works.
  1697. *
  1698. * Because it's setting these settings for the entire page (as is the nature
  1699. * of HTTP headers), this should only be used once per page (again, at the
  1700. * top).
  1701. *
  1702. * @param string $mime MIME type to serve the page as
  1703. */
  1704. public function handle_content_type($mime = 'text/html')
  1705. {
  1706. if (!headers_sent())
  1707. {
  1708. $header = "Content-type: $mime;";
  1709. if ($this->get_encoding())
  1710. {
  1711. $header .= ' charset=' . $this->get_encoding();
  1712. }
  1713. else
  1714. {
  1715. $header .= ' charset=UTF-8';
  1716. }
  1717. header($header);
  1718. }
  1719. }
  1720. /**
  1721. * Get the type of the feed
  1722. *
  1723. * This returns a SIMPLEPIE_TYPE_* constant, which can be tested against
  1724. * using {@link http://php.net/language.operators.bitwise bitwise operators}
  1725. *
  1726. * @since 0.8 (usage changed to using constants in 1.0)
  1727. * @see SIMPLEPIE_TYPE_NONE Unknown.
  1728. * @see SIMPLEPIE_TYPE_RSS_090 RSS 0.90.
  1729. * @see SIMPLEPIE_TYPE_RSS_091_NETSCAPE RSS 0.91 (Netscape).
  1730. * @see SIMPLEPIE_TYPE_RSS_091_USERLAND RSS 0.91 (Userland).
  1731. * @see SIMPLEPIE_TYPE_RSS_091 RSS 0.91.
  1732. * @see SIMPLEPIE_TYPE_RSS_092 RSS 0.92.
  1733. * @see SIMPLEPIE_TYPE_RSS_093 RSS 0.93.
  1734. * @see SIMPLEPIE_TYPE_RSS_094 RSS 0.94.
  1735. * @see SIMPLEPIE_TYPE_RSS_10 RSS 1.0.
  1736. * @see SIMPLEPIE_TYPE_RSS_20 RSS 2.0.x.
  1737. * @see SIMPLEPIE_TYPE_RSS_RDF RDF-based RSS.
  1738. * @see SIMPLEPIE_TYPE_RSS_SYNDICATION Non-RDF-based RSS (truly intended as syndication format).
  1739. * @see SIMPLEPIE_TYPE_RSS_ALL Any version of RSS.
  1740. * @see SIMPLEPIE_TYPE_ATOM_03 Atom 0.3.
  1741. * @see SIMPLEPIE_TYPE_ATOM_10 Atom 1.0.
  1742. * @see SIMPLEPIE_TYPE_ATOM_ALL Any version of Atom.
  1743. * @see SIMPLEPIE_TYPE_ALL Any known/supported feed type.
  1744. * @return int SIMPLEPIE_TYPE_* constant
  1745. */
  1746. public function get_type()
  1747. {
  1748. if (!isset($this->data['type']))
  1749. {
  1750. $this->data['type'] = SIMPLEPIE_TYPE_ALL;
  1751. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed']))
  1752. {
  1753. $this->data['type'] &= SIMPLEPIE_TYPE_ATOM_10;
  1754. }
  1755. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed']))
  1756. {
  1757. $this->data['type'] &= SIMPLEPIE_TYPE_ATOM_03;
  1758. }
  1759. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF']))
  1760. {
  1761. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_10]['channel'])
  1762. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_10]['image'])
  1763. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_10]['item'])
  1764. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_10]['textinput']))
  1765. {
  1766. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_10;
  1767. }
  1768. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_090]['channel'])
  1769. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_090]['image'])
  1770. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_090]['item'])
  1771. || isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_090]['textinput']))
  1772. {
  1773. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_090;
  1774. }
  1775. }
  1776. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss']))
  1777. {
  1778. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_ALL;
  1779. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['attribs']['']['version']))
  1780. {
  1781. switch (trim($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['attribs']['']['version']))
  1782. {
  1783. case '0.91':
  1784. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_091;
  1785. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_20]['skiphours']['hour'][0]['data']))
  1786. {
  1787. switch (trim($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['child'][SIMPLEPIE_NAMESPACE_RSS_20]['skiphours']['hour'][0]['data']))
  1788. {
  1789. case '0':
  1790. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_091_NETSCAPE;
  1791. break;
  1792. case '24':
  1793. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_091_USERLAND;
  1794. break;
  1795. }
  1796. }
  1797. break;
  1798. case '0.92':
  1799. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_092;
  1800. break;
  1801. case '0.93':
  1802. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_093;
  1803. break;
  1804. case '0.94':
  1805. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_094;
  1806. break;
  1807. case '2.0':
  1808. $this->data['type'] &= SIMPLEPIE_TYPE_RSS_20;
  1809. break;
  1810. }
  1811. }
  1812. }
  1813. else
  1814. {
  1815. $this->data['type'] = SIMPLEPIE_TYPE_NONE;
  1816. }
  1817. }
  1818. return $this->data['type'];
  1819. }
  1820. /**
  1821. * Get the URL for the feed
  1822. *
  1823. * When the 'permanent' mode is enabled, returns the original feed URL,
  1824. * except in the case of an `HTTP 301 Moved Permanently` status response,
  1825. * in which case the location of the first redirection is returned.
  1826. *
  1827. * When the 'permanent' mode is disabled (default),
  1828. * may or may not be different from the URL passed to {@see set_feed_url()},
  1829. * depending on whether auto-discovery was used, and whether there were
  1830. * any redirects along the way.
  1831. *
  1832. * @since Preview Release (previously called `get_feed_url()` since SimplePie 0.8.)
  1833. * @todo Support <itunes:new-feed-url>
  1834. * @todo Also, |atom:link|@rel=self
  1835. * @param bool $permanent Permanent mode to return only the original URL or the first redirection
  1836. * iff it is a 301 redirection
  1837. * @return string|null
  1838. */
  1839. public function subscribe_url($permanent = false)
  1840. {
  1841. if ($permanent)
  1842. {
  1843. if ($this->permanent_url !== null)
  1844. {
  1845. // sanitize encodes ampersands which are required when used in a url.
  1846. return str_replace('&amp;', '&',
  1847. $this->sanitize($this->permanent_url,
  1848. SIMPLEPIE_CONSTRUCT_IRI));
  1849. }
  1850. }
  1851. else
  1852. {
  1853. if ($this->feed_url !== null)
  1854. {
  1855. return str_replace('&amp;', '&',
  1856. $this->sanitize($this->feed_url,
  1857. SIMPLEPIE_CONSTRUCT_IRI));
  1858. }
  1859. }
  1860. return null;
  1861. }
  1862. /**
  1863. * Get data for an feed-level element
  1864. *
  1865. * This method allows you to get access to ANY element/attribute that is a
  1866. * sub-element of the opening feed tag.
  1867. *
  1868. * The return value is an indexed array of elements matching the given
  1869. * namespace and tag name. Each element has `attribs`, `data` and `child`
  1870. * subkeys. For `attribs` and `child`, these contain namespace subkeys.
  1871. * `attribs` then has one level of associative name => value data (where
  1872. * `value` is a string) after the namespace. `child` has tag-indexed keys
  1873. * after the namespace, each member of which is an indexed array matching
  1874. * this same format.
  1875. *
  1876. * For example:
  1877. * <pre>
  1878. * // This is probably a bad example because we already support
  1879. * // <media:content> natively, but it shows you how to parse through
  1880. * // the nodes.
  1881. * $group = $item->get_item_tags(SIMPLEPIE_NAMESPACE_MEDIARSS, 'group');
  1882. * $content = $group[0]['child'][SIMPLEPIE_NAMESPACE_MEDIARSS]['content'];
  1883. * $file = $content[0]['attribs']['']['url'];
  1884. * echo $file;
  1885. * </pre>
  1886. *
  1887. * @since 1.0
  1888. * @see http://simplepie.org/wiki/faq/supported_xml_namespaces
  1889. * @param string $namespace The URL of the XML namespace of the elements you're trying to access
  1890. * @param string $tag Tag name
  1891. * @return array
  1892. */
  1893. public function get_feed_tags($namespace, $tag)
  1894. {
  1895. $type = $this->get_type();
  1896. if ($type & SIMPLEPIE_TYPE_ATOM_10)
  1897. {
  1898. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0]['child'][$namespace][$tag]))
  1899. {
  1900. return $this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0]['child'][$namespace][$tag];
  1901. }
  1902. }
  1903. if ($type & SIMPLEPIE_TYPE_ATOM_03)
  1904. {
  1905. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0]['child'][$namespace][$tag]))
  1906. {
  1907. return $this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0]['child'][$namespace][$tag];
  1908. }
  1909. }
  1910. if ($type & SIMPLEPIE_TYPE_RSS_RDF)
  1911. {
  1912. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][$namespace][$tag]))
  1913. {
  1914. return $this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['child'][$namespace][$tag];
  1915. }
  1916. }
  1917. if ($type & SIMPLEPIE_TYPE_RSS_SYNDICATION)
  1918. {
  1919. if (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['child'][$namespace][$tag]))
  1920. {
  1921. return $this->data['child'][SIMPLEPIE_NAMESPACE_RSS_20]['rss'][0]['child'][$namespace][$tag];
  1922. }
  1923. }
  1924. return null;
  1925. }
  1926. /**
  1927. * Get data for an channel-level element
  1928. *
  1929. * This method allows you to get access to ANY element/attribute in the
  1930. * channel/header section of the feed.
  1931. *
  1932. * See {@see SimplePie::get_feed_tags()} for a description of the return value
  1933. *
  1934. * @since 1.0
  1935. * @see http://simplepie.org/wiki/faq/supported_xml_namespaces
  1936. * @param string $namespace The URL of the XML namespace of the elements you're trying to access
  1937. * @param string $tag Tag name
  1938. * @return array
  1939. */
  1940. public function get_channel_tags($namespace, $tag)
  1941. {
  1942. $type = $this->get_type();
  1943. if ($type & SIMPLEPIE_TYPE_ATOM_ALL)
  1944. {
  1945. if ($return = $this->get_feed_tags($namespace, $tag))
  1946. {
  1947. return $return;
  1948. }
  1949. }
  1950. if ($type & SIMPLEPIE_TYPE_RSS_10)
  1951. {
  1952. if ($channel = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'channel'))
  1953. {
  1954. if (isset($channel[0]['child'][$namespace][$tag]))
  1955. {
  1956. return $channel[0]['child'][$namespace][$tag];
  1957. }
  1958. }
  1959. }
  1960. if ($type & SIMPLEPIE_TYPE_RSS_090)
  1961. {
  1962. if ($channel = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'channel'))
  1963. {
  1964. if (isset($channel[0]['child'][$namespace][$tag]))
  1965. {
  1966. return $channel[0]['child'][$namespace][$tag];
  1967. }
  1968. }
  1969. }
  1970. if ($type & SIMPLEPIE_TYPE_RSS_SYNDICATION)
  1971. {
  1972. if ($channel = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'channel'))
  1973. {
  1974. if (isset($channel[0]['child'][$namespace][$tag]))
  1975. {
  1976. return $channel[0]['child'][$namespace][$tag];
  1977. }
  1978. }
  1979. }
  1980. return null;
  1981. }
  1982. /**
  1983. * Get data for an channel-level element
  1984. *
  1985. * This method allows you to get access to ANY element/attribute in the
  1986. * image/logo section of the feed.
  1987. *
  1988. * See {@see SimplePie::get_feed_tags()} for a description of the return value
  1989. *
  1990. * @since 1.0
  1991. * @see http://simplepie.org/wiki/faq/supported_xml_namespaces
  1992. * @param string $namespace The URL of the XML namespace of the elements you're trying to access
  1993. * @param string $tag Tag name
  1994. * @return array
  1995. */
  1996. public function get_image_tags($namespace, $tag)
  1997. {
  1998. $type = $this->get_type();
  1999. if ($type & SIMPLEPIE_TYPE_RSS_10)
  2000. {
  2001. if ($image = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'image'))
  2002. {
  2003. if (isset($image[0]['child'][$namespace][$tag]))
  2004. {
  2005. return $image[0]['child'][$namespace][$tag];
  2006. }
  2007. }
  2008. }
  2009. if ($type & SIMPLEPIE_TYPE_RSS_090)
  2010. {
  2011. if ($image = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'image'))
  2012. {
  2013. if (isset($image[0]['child'][$namespace][$tag]))
  2014. {
  2015. return $image[0]['child'][$namespace][$tag];
  2016. }
  2017. }
  2018. }
  2019. if ($type & SIMPLEPIE_TYPE_RSS_SYNDICATION)
  2020. {
  2021. if ($image = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'image'))
  2022. {
  2023. if (isset($image[0]['child'][$namespace][$tag]))
  2024. {
  2025. return $image[0]['child'][$namespace][$tag];
  2026. }
  2027. }
  2028. }
  2029. return null;
  2030. }
  2031. /**
  2032. * Get the base URL value from the feed
  2033. *
  2034. * Uses `<xml:base>` if available, otherwise uses the first link in the
  2035. * feed, or failing that, the URL of the feed itself.
  2036. *
  2037. * @see get_link
  2038. * @see subscribe_url
  2039. *
  2040. * @param array $element
  2041. * @return string
  2042. */
  2043. public function get_base($element = array())
  2044. {
  2045. if (!($this->get_type() & SIMPLEPIE_TYPE_RSS_SYNDICATION) && !empty($element['xml_base_explicit']) && isset($element['xml_base']))
  2046. {
  2047. return $element['xml_base'];
  2048. }
  2049. elseif ($this->get_link() !== null)
  2050. {
  2051. return $this->get_link();
  2052. }
  2053. return $this->subscribe_url();
  2054. }
  2055. /**
  2056. * Sanitize feed data
  2057. *
  2058. * @access private
  2059. * @see SimplePie_Sanitize::sanitize()
  2060. * @param string $data Data to sanitize
  2061. * @param int $type One of the SIMPLEPIE_CONSTRUCT_* constants
  2062. * @param string $base Base URL to resolve URLs against
  2063. * @return string Sanitized data
  2064. */
  2065. public function sanitize($data, $type, $base = '')
  2066. {
  2067. try
  2068. {
  2069. return $this->sanitize->sanitize($data, $type, $base);
  2070. }
  2071. catch (SimplePie_Exception $e)
  2072. {
  2073. if (!$this->enable_exceptions)
  2074. {
  2075. $this->error = $e->getMessage();
  2076. $this->registry->call('Misc', 'error', array($this->error, E_USER_WARNING, $e->getFile(), $e->getLine()));
  2077. return '';
  2078. }
  2079. throw $e;
  2080. }
  2081. }
  2082. /**
  2083. * Get the title of the feed
  2084. *
  2085. * Uses `<atom:title>`, `<title>` or `<dc:title>`
  2086. *
  2087. * @since 1.0 (previously called `get_feed_title` since 0.8)
  2088. * @return string|null
  2089. */
  2090. public function get_title()
  2091. {
  2092. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'title'))
  2093. {
  2094. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_10_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  2095. }
  2096. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'title'))
  2097. {
  2098. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_03_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  2099. }
  2100. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'title'))
  2101. {
  2102. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));
  2103. }
  2104. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'title'))
  2105. {
  2106. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));
  2107. }
  2108. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'title'))
  2109. {
  2110. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));
  2111. }
  2112. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'title'))
  2113. {
  2114. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2115. }
  2116. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'title'))
  2117. {
  2118. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2119. }
  2120. return null;
  2121. }
  2122. /**
  2123. * Get a category for the feed
  2124. *
  2125. * @since Unknown
  2126. * @param int $key The category that you want to return. Remember that arrays begin with 0, not 1
  2127. * @return SimplePie_Category|null
  2128. */
  2129. public function get_category($key = 0)
  2130. {
  2131. $categories = $this->get_categories();
  2132. if (isset($categories[$key]))
  2133. {
  2134. return $categories[$key];
  2135. }
  2136. return null;
  2137. }
  2138. /**
  2139. * Get all categories for the feed
  2140. *
  2141. * Uses `<atom:category>`, `<category>` or `<dc:subject>`
  2142. *
  2143. * @since Unknown
  2144. * @return array|null List of {@see SimplePie_Category} objects
  2145. */
  2146. public function get_categories()
  2147. {
  2148. $categories = array();
  2149. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'category') as $category)
  2150. {
  2151. $term = null;
  2152. $scheme = null;
  2153. $label = null;
  2154. if (isset($category['attribs']['']['term']))
  2155. {
  2156. $term = $this->sanitize($category['attribs']['']['term'], SIMPLEPIE_CONSTRUCT_TEXT);
  2157. }
  2158. if (isset($category['attribs']['']['scheme']))
  2159. {
  2160. $scheme = $this->sanitize($category['attribs']['']['scheme'], SIMPLEPIE_CONSTRUCT_TEXT);
  2161. }
  2162. if (isset($category['attribs']['']['label']))
  2163. {
  2164. $label = $this->sanitize($category['attribs']['']['label'], SIMPLEPIE_CONSTRUCT_TEXT);
  2165. }
  2166. $categories[] = $this->registry->create('Category', array($term, $scheme, $label));
  2167. }
  2168. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'category') as $category)
  2169. {
  2170. // This is really the label, but keep this as the term also for BC.
  2171. // Label will also work on retrieving because that falls back to term.
  2172. $term = $this->sanitize($category['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2173. if (isset($category['attribs']['']['domain']))
  2174. {
  2175. $scheme = $this->sanitize($category['attribs']['']['domain'], SIMPLEPIE_CONSTRUCT_TEXT);
  2176. }
  2177. else
  2178. {
  2179. $scheme = null;
  2180. }
  2181. $categories[] = $this->registry->create('Category', array($term, $scheme, null));
  2182. }
  2183. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'subject') as $category)
  2184. {
  2185. $categories[] = $this->registry->create('Category', array($this->sanitize($category['data'], SIMPLEPIE_CONSTRUCT_TEXT), null, null));
  2186. }
  2187. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'subject') as $category)
  2188. {
  2189. $categories[] = $this->registry->create('Category', array($this->sanitize($category['data'], SIMPLEPIE_CONSTRUCT_TEXT), null, null));
  2190. }
  2191. if (!empty($categories))
  2192. {
  2193. return array_unique($categories);
  2194. }
  2195. return null;
  2196. }
  2197. /**
  2198. * Get an author for the feed
  2199. *
  2200. * @since 1.1
  2201. * @param int $key The author that you want to return. Remember that arrays begin with 0, not 1
  2202. * @return SimplePie_Author|null
  2203. */
  2204. public function get_author($key = 0)
  2205. {
  2206. $authors = $this->get_authors();
  2207. if (isset($authors[$key]))
  2208. {
  2209. return $authors[$key];
  2210. }
  2211. return null;
  2212. }
  2213. /**
  2214. * Get all authors for the feed
  2215. *
  2216. * Uses `<atom:author>`, `<author>`, `<dc:creator>` or `<itunes:author>`
  2217. *
  2218. * @since 1.1
  2219. * @return array|null List of {@see SimplePie_Author} objects
  2220. */
  2221. public function get_authors()
  2222. {
  2223. $authors = array();
  2224. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'author') as $author)
  2225. {
  2226. $name = null;
  2227. $uri = null;
  2228. $email = null;
  2229. if (isset($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['name'][0]['data']))
  2230. {
  2231. $name = $this->sanitize($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['name'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2232. }
  2233. if (isset($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['uri'][0]['data']))
  2234. {
  2235. $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]));
  2236. }
  2237. if (isset($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['email'][0]['data']))
  2238. {
  2239. $email = $this->sanitize($author['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['email'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2240. }
  2241. if ($name !== null || $email !== null || $uri !== null)
  2242. {
  2243. $authors[] = $this->registry->create('Author', array($name, $uri, $email));
  2244. }
  2245. }
  2246. if ($author = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'author'))
  2247. {
  2248. $name = null;
  2249. $url = null;
  2250. $email = null;
  2251. if (isset($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['name'][0]['data']))
  2252. {
  2253. $name = $this->sanitize($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['name'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2254. }
  2255. if (isset($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['url'][0]['data']))
  2256. {
  2257. $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]));
  2258. }
  2259. if (isset($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['email'][0]['data']))
  2260. {
  2261. $email = $this->sanitize($author[0]['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['email'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2262. }
  2263. if ($name !== null || $email !== null || $url !== null)
  2264. {
  2265. $authors[] = $this->registry->create('Author', array($name, $url, $email));
  2266. }
  2267. }
  2268. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'creator') as $author)
  2269. {
  2270. $authors[] = $this->registry->create('Author', array($this->sanitize($author['data'], SIMPLEPIE_CONSTRUCT_TEXT), null, null));
  2271. }
  2272. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'creator') as $author)
  2273. {
  2274. $authors[] = $this->registry->create('Author', array($this->sanitize($author['data'], SIMPLEPIE_CONSTRUCT_TEXT), null, null));
  2275. }
  2276. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ITUNES, 'author') as $author)
  2277. {
  2278. $authors[] = $this->registry->create('Author', array($this->sanitize($author['data'], SIMPLEPIE_CONSTRUCT_TEXT), null, null));
  2279. }
  2280. if (!empty($authors))
  2281. {
  2282. return array_unique($authors);
  2283. }
  2284. return null;
  2285. }
  2286. /**
  2287. * Get a contributor for the feed
  2288. *
  2289. * @since 1.1
  2290. * @param int $key The contrbutor that you want to return. Remember that arrays begin with 0, not 1
  2291. * @return SimplePie_Author|null
  2292. */
  2293. public function get_contributor($key = 0)
  2294. {
  2295. $contributors = $this->get_contributors();
  2296. if (isset($contributors[$key]))
  2297. {
  2298. return $contributors[$key];
  2299. }
  2300. return null;
  2301. }
  2302. /**
  2303. * Get all contributors for the feed
  2304. *
  2305. * Uses `<atom:contributor>`
  2306. *
  2307. * @since 1.1
  2308. * @return array|null List of {@see SimplePie_Author} objects
  2309. */
  2310. public function get_contributors()
  2311. {
  2312. $contributors = array();
  2313. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'contributor') as $contributor)
  2314. {
  2315. $name = null;
  2316. $uri = null;
  2317. $email = null;
  2318. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['name'][0]['data']))
  2319. {
  2320. $name = $this->sanitize($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['name'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2321. }
  2322. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['uri'][0]['data']))
  2323. {
  2324. $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]));
  2325. }
  2326. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['email'][0]['data']))
  2327. {
  2328. $email = $this->sanitize($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['email'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2329. }
  2330. if ($name !== null || $email !== null || $uri !== null)
  2331. {
  2332. $contributors[] = $this->registry->create('Author', array($name, $uri, $email));
  2333. }
  2334. }
  2335. foreach ((array) $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'contributor') as $contributor)
  2336. {
  2337. $name = null;
  2338. $url = null;
  2339. $email = null;
  2340. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['name'][0]['data']))
  2341. {
  2342. $name = $this->sanitize($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['name'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2343. }
  2344. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['url'][0]['data']))
  2345. {
  2346. $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]));
  2347. }
  2348. if (isset($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['email'][0]['data']))
  2349. {
  2350. $email = $this->sanitize($contributor['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['email'][0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2351. }
  2352. if ($name !== null || $email !== null || $url !== null)
  2353. {
  2354. $contributors[] = $this->registry->create('Author', array($name, $url, $email));
  2355. }
  2356. }
  2357. if (!empty($contributors))
  2358. {
  2359. return array_unique($contributors);
  2360. }
  2361. return null;
  2362. }
  2363. /**
  2364. * Get a single link for the feed
  2365. *
  2366. * @since 1.0 (previously called `get_feed_link` since Preview Release, `get_feed_permalink()` since 0.8)
  2367. * @param int $key The link that you want to return. Remember that arrays begin with 0, not 1
  2368. * @param string $rel The relationship of the link to return
  2369. * @return string|null Link URL
  2370. */
  2371. public function get_link($key = 0, $rel = 'alternate')
  2372. {
  2373. $links = $this->get_links($rel);
  2374. if (isset($links[$key]))
  2375. {
  2376. return $links[$key];
  2377. }
  2378. return null;
  2379. }
  2380. /**
  2381. * Get the permalink for the item
  2382. *
  2383. * Returns the first link available with a relationship of "alternate".
  2384. * Identical to {@see get_link()} with key 0
  2385. *
  2386. * @see get_link
  2387. * @since 1.0 (previously called `get_feed_link` since Preview Release, `get_feed_permalink()` since 0.8)
  2388. * @internal Added for parity between the parent-level and the item/entry-level.
  2389. * @return string|null Link URL
  2390. */
  2391. public function get_permalink()
  2392. {
  2393. return $this->get_link(0);
  2394. }
  2395. /**
  2396. * Get all links for the feed
  2397. *
  2398. * Uses `<atom:link>` or `<link>`
  2399. *
  2400. * @since Beta 2
  2401. * @param string $rel The relationship of links to return
  2402. * @return array|null Links found for the feed (strings)
  2403. */
  2404. public function get_links($rel = 'alternate')
  2405. {
  2406. if (!isset($this->data['links']))
  2407. {
  2408. $this->data['links'] = array();
  2409. if ($links = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'link'))
  2410. {
  2411. foreach ($links as $link)
  2412. {
  2413. if (isset($link['attribs']['']['href']))
  2414. {
  2415. $link_rel = (isset($link['attribs']['']['rel'])) ? $link['attribs']['']['rel'] : 'alternate';
  2416. $this->data['links'][$link_rel][] = $this->sanitize($link['attribs']['']['href'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($link));
  2417. }
  2418. }
  2419. }
  2420. if ($links = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'link'))
  2421. {
  2422. foreach ($links as $link)
  2423. {
  2424. if (isset($link['attribs']['']['href']))
  2425. {
  2426. $link_rel = (isset($link['attribs']['']['rel'])) ? $link['attribs']['']['rel'] : 'alternate';
  2427. $this->data['links'][$link_rel][] = $this->sanitize($link['attribs']['']['href'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($link));
  2428. }
  2429. }
  2430. }
  2431. if ($links = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'link'))
  2432. {
  2433. $this->data['links']['alternate'][] = $this->sanitize($links[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($links[0]));
  2434. }
  2435. if ($links = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'link'))
  2436. {
  2437. $this->data['links']['alternate'][] = $this->sanitize($links[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($links[0]));
  2438. }
  2439. if ($links = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'link'))
  2440. {
  2441. $this->data['links']['alternate'][] = $this->sanitize($links[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($links[0]));
  2442. }
  2443. $keys = array_keys($this->data['links']);
  2444. foreach ($keys as $key)
  2445. {
  2446. if ($this->registry->call('Misc', 'is_isegment_nz_nc', array($key)))
  2447. {
  2448. if (isset($this->data['links'][SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY . $key]))
  2449. {
  2450. $this->data['links'][SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY . $key] = array_merge($this->data['links'][$key], $this->data['links'][SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY . $key]);
  2451. $this->data['links'][$key] =& $this->data['links'][SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY . $key];
  2452. }
  2453. else
  2454. {
  2455. $this->data['links'][SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY . $key] =& $this->data['links'][$key];
  2456. }
  2457. }
  2458. elseif (substr($key, 0, 41) === SIMPLEPIE_IANA_LINK_RELATIONS_REGISTRY)
  2459. {
  2460. $this->data['links'][substr($key, 41)] =& $this->data['links'][$key];
  2461. }
  2462. $this->data['links'][$key] = array_unique($this->data['links'][$key]);
  2463. }
  2464. }
  2465. if (isset($this->data['headers']['link']))
  2466. {
  2467. $link_headers = $this->data['headers']['link'];
  2468. if (is_string($link_headers)) {
  2469. $link_headers = array($link_headers);
  2470. }
  2471. $matches = preg_filter('/<([^>]+)>; rel='.preg_quote($rel).'/', '$1', $link_headers);
  2472. if (!empty($matches)) {
  2473. return $matches;
  2474. }
  2475. }
  2476. if (isset($this->data['links'][$rel]))
  2477. {
  2478. return $this->data['links'][$rel];
  2479. }
  2480. return null;
  2481. }
  2482. public function get_all_discovered_feeds()
  2483. {
  2484. return $this->all_discovered_feeds;
  2485. }
  2486. /**
  2487. * Get the content for the item
  2488. *
  2489. * Uses `<atom:subtitle>`, `<atom:tagline>`, `<description>`,
  2490. * `<dc:description>`, `<itunes:summary>` or `<itunes:subtitle>`
  2491. *
  2492. * @since 1.0 (previously called `get_feed_description()` since 0.8)
  2493. * @return string|null
  2494. */
  2495. public function get_description()
  2496. {
  2497. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'subtitle'))
  2498. {
  2499. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_10_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  2500. }
  2501. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'tagline'))
  2502. {
  2503. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_03_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  2504. }
  2505. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'description'))
  2506. {
  2507. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));
  2508. }
  2509. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'description'))
  2510. {
  2511. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));
  2512. }
  2513. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'description'))
  2514. {
  2515. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_HTML, $this->get_base($return[0]));
  2516. }
  2517. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'description'))
  2518. {
  2519. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2520. }
  2521. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'description'))
  2522. {
  2523. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2524. }
  2525. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ITUNES, 'summary'))
  2526. {
  2527. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_HTML, $this->get_base($return[0]));
  2528. }
  2529. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ITUNES, 'subtitle'))
  2530. {
  2531. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_HTML, $this->get_base($return[0]));
  2532. }
  2533. return null;
  2534. }
  2535. /**
  2536. * Get the copyright info for the feed
  2537. *
  2538. * Uses `<atom:rights>`, `<atom:copyright>` or `<dc:rights>`
  2539. *
  2540. * @since 1.0 (previously called `get_feed_copyright()` since 0.8)
  2541. * @return string|null
  2542. */
  2543. public function get_copyright()
  2544. {
  2545. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'rights'))
  2546. {
  2547. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_10_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  2548. }
  2549. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'copyright'))
  2550. {
  2551. return $this->sanitize($return[0]['data'], $this->registry->call('Misc', 'atom_03_construct_type', array($return[0]['attribs'])), $this->get_base($return[0]));
  2552. }
  2553. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'copyright'))
  2554. {
  2555. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2556. }
  2557. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'rights'))
  2558. {
  2559. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2560. }
  2561. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'rights'))
  2562. {
  2563. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2564. }
  2565. return null;
  2566. }
  2567. /**
  2568. * Get the language for the feed
  2569. *
  2570. * Uses `<language>`, `<dc:language>`, or @xml_lang
  2571. *
  2572. * @since 1.0 (previously called `get_feed_language()` since 0.8)
  2573. * @return string|null
  2574. */
  2575. public function get_language()
  2576. {
  2577. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'language'))
  2578. {
  2579. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2580. }
  2581. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_11, 'language'))
  2582. {
  2583. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2584. }
  2585. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_DC_10, 'language'))
  2586. {
  2587. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2588. }
  2589. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0]['xml_lang']))
  2590. {
  2591. return $this->sanitize($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_10]['feed'][0]['xml_lang'], SIMPLEPIE_CONSTRUCT_TEXT);
  2592. }
  2593. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0]['xml_lang']))
  2594. {
  2595. return $this->sanitize($this->data['child'][SIMPLEPIE_NAMESPACE_ATOM_03]['feed'][0]['xml_lang'], SIMPLEPIE_CONSTRUCT_TEXT);
  2596. }
  2597. elseif (isset($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['xml_lang']))
  2598. {
  2599. return $this->sanitize($this->data['child'][SIMPLEPIE_NAMESPACE_RDF]['RDF'][0]['xml_lang'], SIMPLEPIE_CONSTRUCT_TEXT);
  2600. }
  2601. elseif (isset($this->data['headers']['content-language']))
  2602. {
  2603. return $this->sanitize($this->data['headers']['content-language'], SIMPLEPIE_CONSTRUCT_TEXT);
  2604. }
  2605. return null;
  2606. }
  2607. /**
  2608. * Get the latitude coordinates for the item
  2609. *
  2610. * Compatible with the W3C WGS84 Basic Geo and GeoRSS specifications
  2611. *
  2612. * Uses `<geo:lat>` or `<georss:point>`
  2613. *
  2614. * @since 1.0
  2615. * @link http://www.w3.org/2003/01/geo/ W3C WGS84 Basic Geo
  2616. * @link http://www.georss.org/ GeoRSS
  2617. * @return string|null
  2618. */
  2619. public function get_latitude()
  2620. {
  2621. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_W3C_BASIC_GEO, 'lat'))
  2622. {
  2623. return (float) $return[0]['data'];
  2624. }
  2625. 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))
  2626. {
  2627. return (float) $match[1];
  2628. }
  2629. return null;
  2630. }
  2631. /**
  2632. * Get the longitude coordinates for the feed
  2633. *
  2634. * Compatible with the W3C WGS84 Basic Geo and GeoRSS specifications
  2635. *
  2636. * Uses `<geo:long>`, `<geo:lon>` or `<georss:point>`
  2637. *
  2638. * @since 1.0
  2639. * @link http://www.w3.org/2003/01/geo/ W3C WGS84 Basic Geo
  2640. * @link http://www.georss.org/ GeoRSS
  2641. * @return string|null
  2642. */
  2643. public function get_longitude()
  2644. {
  2645. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_W3C_BASIC_GEO, 'long'))
  2646. {
  2647. return (float) $return[0]['data'];
  2648. }
  2649. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_W3C_BASIC_GEO, 'lon'))
  2650. {
  2651. return (float) $return[0]['data'];
  2652. }
  2653. 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))
  2654. {
  2655. return (float) $match[2];
  2656. }
  2657. return null;
  2658. }
  2659. /**
  2660. * Get the feed logo's title
  2661. *
  2662. * RSS 0.9.0, 1.0 and 2.0 feeds are allowed to have a "feed logo" title.
  2663. *
  2664. * Uses `<image><title>` or `<image><dc:title>`
  2665. *
  2666. * @return string|null
  2667. */
  2668. public function get_image_title()
  2669. {
  2670. if ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'title'))
  2671. {
  2672. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2673. }
  2674. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'title'))
  2675. {
  2676. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2677. }
  2678. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'title'))
  2679. {
  2680. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2681. }
  2682. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_DC_11, 'title'))
  2683. {
  2684. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2685. }
  2686. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_DC_10, 'title'))
  2687. {
  2688. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_TEXT);
  2689. }
  2690. return null;
  2691. }
  2692. /**
  2693. * Get the feed logo's URL
  2694. *
  2695. * RSS 0.9.0, 2.0, Atom 1.0, and feeds with iTunes RSS tags are allowed to
  2696. * have a "feed logo" URL. This points directly to the image itself.
  2697. *
  2698. * Uses `<itunes:image>`, `<atom:logo>`, `<atom:icon>`,
  2699. * `<image><title>` or `<image><dc:title>`
  2700. *
  2701. * @return string|null
  2702. */
  2703. public function get_image_url()
  2704. {
  2705. if ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ITUNES, 'image'))
  2706. {
  2707. return $this->sanitize($return[0]['attribs']['']['href'], SIMPLEPIE_CONSTRUCT_IRI);
  2708. }
  2709. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'logo'))
  2710. {
  2711. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2712. }
  2713. elseif ($return = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'icon'))
  2714. {
  2715. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2716. }
  2717. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'url'))
  2718. {
  2719. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2720. }
  2721. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'url'))
  2722. {
  2723. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2724. }
  2725. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'url'))
  2726. {
  2727. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2728. }
  2729. return null;
  2730. }
  2731. /**
  2732. * Get the feed logo's link
  2733. *
  2734. * RSS 0.9.0, 1.0 and 2.0 feeds are allowed to have a "feed logo" link. This
  2735. * points to a human-readable page that the image should link to.
  2736. *
  2737. * Uses `<itunes:image>`, `<atom:logo>`, `<atom:icon>`,
  2738. * `<image><title>` or `<image><dc:title>`
  2739. *
  2740. * @return string|null
  2741. */
  2742. public function get_image_link()
  2743. {
  2744. if ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'link'))
  2745. {
  2746. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2747. }
  2748. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'link'))
  2749. {
  2750. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2751. }
  2752. elseif ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'link'))
  2753. {
  2754. return $this->sanitize($return[0]['data'], SIMPLEPIE_CONSTRUCT_IRI, $this->get_base($return[0]));
  2755. }
  2756. return null;
  2757. }
  2758. /**
  2759. * Get the feed logo's link
  2760. *
  2761. * RSS 2.0 feeds are allowed to have a "feed logo" width.
  2762. *
  2763. * Uses `<image><width>` or defaults to 88.0 if no width is specified and
  2764. * the feed is an RSS 2.0 feed.
  2765. *
  2766. * @return int|float|null
  2767. */
  2768. public function get_image_width()
  2769. {
  2770. if ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'width'))
  2771. {
  2772. return round($return[0]['data']);
  2773. }
  2774. elseif ($this->get_type() & SIMPLEPIE_TYPE_RSS_SYNDICATION && $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'url'))
  2775. {
  2776. return 88.0;
  2777. }
  2778. return null;
  2779. }
  2780. /**
  2781. * Get the feed logo's height
  2782. *
  2783. * RSS 2.0 feeds are allowed to have a "feed logo" height.
  2784. *
  2785. * Uses `<image><height>` or defaults to 31.0 if no height is specified and
  2786. * the feed is an RSS 2.0 feed.
  2787. *
  2788. * @return int|float|null
  2789. */
  2790. public function get_image_height()
  2791. {
  2792. if ($return = $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'height'))
  2793. {
  2794. return round($return[0]['data']);
  2795. }
  2796. elseif ($this->get_type() & SIMPLEPIE_TYPE_RSS_SYNDICATION && $this->get_image_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'url'))
  2797. {
  2798. return 31.0;
  2799. }
  2800. return null;
  2801. }
  2802. /**
  2803. * Get the number of items in the feed
  2804. *
  2805. * This is well-suited for {@link http://php.net/for for()} loops with
  2806. * {@see get_item()}
  2807. *
  2808. * @param int $max Maximum value to return. 0 for no limit
  2809. * @return int Number of items in the feed
  2810. */
  2811. public function get_item_quantity($max = 0)
  2812. {
  2813. $max = (int) $max;
  2814. $qty = count($this->get_items());
  2815. if ($max === 0)
  2816. {
  2817. return $qty;
  2818. }
  2819. return ($qty > $max) ? $max : $qty;
  2820. }
  2821. /**
  2822. * Get a single item from the feed
  2823. *
  2824. * This is better suited for {@link http://php.net/for for()} loops, whereas
  2825. * {@see get_items()} is better suited for
  2826. * {@link http://php.net/foreach foreach()} loops.
  2827. *
  2828. * @see get_item_quantity()
  2829. * @since Beta 2
  2830. * @param int $key The item that you want to return. Remember that arrays begin with 0, not 1
  2831. * @return SimplePie_Item|null
  2832. */
  2833. public function get_item($key = 0)
  2834. {
  2835. $items = $this->get_items();
  2836. if (isset($items[$key]))
  2837. {
  2838. return $items[$key];
  2839. }
  2840. return null;
  2841. }
  2842. /**
  2843. * Get all items from the feed
  2844. *
  2845. * This is better suited for {@link http://php.net/for for()} loops, whereas
  2846. * {@see get_items()} is better suited for
  2847. * {@link http://php.net/foreach foreach()} loops.
  2848. *
  2849. * @see get_item_quantity
  2850. * @since Beta 2
  2851. * @param int $start Index to start at
  2852. * @param int $end Number of items to return. 0 for all items after `$start`
  2853. * @return SimplePie_Item[]|null List of {@see SimplePie_Item} objects
  2854. */
  2855. public function get_items($start = 0, $end = 0)
  2856. {
  2857. if (!isset($this->data['items']))
  2858. {
  2859. if (!empty($this->multifeed_objects))
  2860. {
  2861. $this->data['items'] = SimplePie::merge_items($this->multifeed_objects, $start, $end, $this->item_limit);
  2862. if (empty($this->data['items']))
  2863. {
  2864. return array();
  2865. }
  2866. return $this->data['items'];
  2867. }
  2868. $this->data['items'] = array();
  2869. if ($items = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_ATOM_10, 'entry'))
  2870. {
  2871. $keys = array_keys($items);
  2872. foreach ($keys as $key)
  2873. {
  2874. $this->data['items'][] = $this->registry->create('Item', array($this, $items[$key]));
  2875. }
  2876. }
  2877. if ($items = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_ATOM_03, 'entry'))
  2878. {
  2879. $keys = array_keys($items);
  2880. foreach ($keys as $key)
  2881. {
  2882. $this->data['items'][] = $this->registry->create('Item', array($this, $items[$key]));
  2883. }
  2884. }
  2885. if ($items = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_10, 'item'))
  2886. {
  2887. $keys = array_keys($items);
  2888. foreach ($keys as $key)
  2889. {
  2890. $this->data['items'][] = $this->registry->create('Item', array($this, $items[$key]));
  2891. }
  2892. }
  2893. if ($items = $this->get_feed_tags(SIMPLEPIE_NAMESPACE_RSS_090, 'item'))
  2894. {
  2895. $keys = array_keys($items);
  2896. foreach ($keys as $key)
  2897. {
  2898. $this->data['items'][] = $this->registry->create('Item', array($this, $items[$key]));
  2899. }
  2900. }
  2901. if ($items = $this->get_channel_tags(SIMPLEPIE_NAMESPACE_RSS_20, 'item'))
  2902. {
  2903. $keys = array_keys($items);
  2904. foreach ($keys as $key)
  2905. {
  2906. $this->data['items'][] = $this->registry->create('Item', array($this, $items[$key]));
  2907. }
  2908. }
  2909. }
  2910. if (empty($this->data['items']))
  2911. {
  2912. return array();
  2913. }
  2914. if ($this->order_by_date)
  2915. {
  2916. if (!isset($this->data['ordered_items']))
  2917. {
  2918. $this->data['ordered_items'] = $this->data['items'];
  2919. usort($this->data['ordered_items'], array(get_class($this), 'sort_items'));
  2920. }
  2921. $items = $this->data['ordered_items'];
  2922. }
  2923. else
  2924. {
  2925. $items = $this->data['items'];
  2926. }
  2927. // Slice the data as desired
  2928. if ($end === 0)
  2929. {
  2930. return array_slice($items, $start);
  2931. }
  2932. return array_slice($items, $start, $end);
  2933. }
  2934. /**
  2935. * Set the favicon handler
  2936. *
  2937. * @deprecated Use your own favicon handling instead
  2938. */
  2939. public function set_favicon_handler($page = false, $qs = 'i')
  2940. {
  2941. $level = defined('E_USER_DEPRECATED') ? E_USER_DEPRECATED : E_USER_WARNING;
  2942. trigger_error('Favicon handling has been removed, please use your own handling', $level);
  2943. return false;
  2944. }
  2945. /**
  2946. * Get the favicon for the current feed
  2947. *
  2948. * @deprecated Use your own favicon handling instead
  2949. */
  2950. public function get_favicon()
  2951. {
  2952. $level = defined('E_USER_DEPRECATED') ? E_USER_DEPRECATED : E_USER_WARNING;
  2953. trigger_error('Favicon handling has been removed, please use your own handling', $level);
  2954. if (($url = $this->get_link()) !== null)
  2955. {
  2956. return 'https://www.google.com/s2/favicons?domain=' . urlencode($url);
  2957. }
  2958. return false;
  2959. }
  2960. /**
  2961. * Magic method handler
  2962. *
  2963. * @param string $method Method name
  2964. * @param array $args Arguments to the method
  2965. * @return mixed
  2966. */
  2967. public function __call($method, $args)
  2968. {
  2969. if (strpos($method, 'subscribe_') === 0)
  2970. {
  2971. $level = defined('E_USER_DEPRECATED') ? E_USER_DEPRECATED : E_USER_WARNING;
  2972. trigger_error('subscribe_*() has been deprecated, implement the callback yourself', $level);
  2973. return '';
  2974. }
  2975. if ($method === 'enable_xml_dump')
  2976. {
  2977. $level = defined('E_USER_DEPRECATED') ? E_USER_DEPRECATED : E_USER_WARNING;
  2978. trigger_error('enable_xml_dump() has been deprecated, use get_raw_data() instead', $level);
  2979. return false;
  2980. }
  2981. $class = get_class($this);
  2982. $trace = debug_backtrace();
  2983. $file = $trace[0]['file'];
  2984. $line = $trace[0]['line'];
  2985. trigger_error("Call to undefined method $class::$method() in $file on line $line", E_USER_ERROR);
  2986. }
  2987. /**
  2988. * Sorting callback for items
  2989. *
  2990. * @access private
  2991. * @param SimplePie $a
  2992. * @param SimplePie $b
  2993. * @return boolean
  2994. */
  2995. public static function sort_items($a, $b)
  2996. {
  2997. $a_date = $a->get_date('U');
  2998. $b_date = $b->get_date('U');
  2999. if ($a_date && $b_date) {
  3000. return $a_date > $b_date ? -1 : 1;
  3001. }
  3002. // Sort items without dates to the top.
  3003. if ($a_date) {
  3004. return 1;
  3005. }
  3006. if ($b_date) {
  3007. return -1;
  3008. }
  3009. return 0;
  3010. }
  3011. /**
  3012. * Merge items from several feeds into one
  3013. *
  3014. * If you're merging multiple feeds together, they need to all have dates
  3015. * for the items or else SimplePie will refuse to sort them.
  3016. *
  3017. * @link http://simplepie.org/wiki/tutorial/sort_multiple_feeds_by_time_and_date#if_feeds_require_separate_per-feed_settings
  3018. * @param array $urls List of SimplePie feed objects to merge
  3019. * @param int $start Starting item
  3020. * @param int $end Number of items to return
  3021. * @param int $limit Maximum number of items per feed
  3022. * @return array
  3023. */
  3024. public static function merge_items($urls, $start = 0, $end = 0, $limit = 0)
  3025. {
  3026. if (is_array($urls) && sizeof($urls) > 0)
  3027. {
  3028. $items = array();
  3029. foreach ($urls as $arg)
  3030. {
  3031. if ($arg instanceof SimplePie)
  3032. {
  3033. $items = array_merge($items, $arg->get_items(0, $limit));
  3034. }
  3035. else
  3036. {
  3037. trigger_error('Arguments must be SimplePie objects', E_USER_WARNING);
  3038. }
  3039. }
  3040. usort($items, array(get_class($urls[0]), 'sort_items'));
  3041. if ($end === 0)
  3042. {
  3043. return array_slice($items, $start);
  3044. }
  3045. return array_slice($items, $start, $end);
  3046. }
  3047. trigger_error('Cannot merge zero SimplePie objects', E_USER_WARNING);
  3048. return array();
  3049. }
  3050. /**
  3051. * Store PubSubHubbub links as headers
  3052. *
  3053. * There is no way to find PuSH links in the body of a microformats feed,
  3054. * so they are added to the headers when found, to be used later by get_links.
  3055. * @param SimplePie_File $file
  3056. * @param string $hub
  3057. * @param string $self
  3058. */
  3059. private function store_links(&$file, $hub, $self) {
  3060. if (isset($file->headers['link']['hub']) ||
  3061. (isset($file->headers['link']) &&
  3062. preg_match('/rel=hub/', $file->headers['link'])))
  3063. {
  3064. return;
  3065. }
  3066. if ($hub)
  3067. {
  3068. if (isset($file->headers['link']))
  3069. {
  3070. if ($file->headers['link'] !== '')
  3071. {
  3072. $file->headers['link'] = ', ';
  3073. }
  3074. }
  3075. else
  3076. {
  3077. $file->headers['link'] = '';
  3078. }
  3079. $file->headers['link'] .= '<'.$hub.'>; rel=hub';
  3080. if ($self)
  3081. {
  3082. $file->headers['link'] .= ', <'.$self.'>; rel=self';
  3083. }
  3084. }
  3085. }
  3086. }