SimplePie.php 97 KB

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