lib/magpie/TROUBLESHOOTING

   1 TROUBLESHOOTING
   2
   3
   4 Trouble Installing MagpieRSS:
   5
   6 1.      Fatal error: Failed opening required '/path/to/script/rss_fetch.inc'
   7         (include_path='.:/usr/local/lib/php:/usr/local/lib/php/pear')
   8
   9 2.      Cache couldn't make dir './cache'.
  10
  11 3.      Fatal error: Failed to load PHP's XML Extension.
  12         http://www.php.net/manual/en/ref.xml.php
  13
  14 Trouble Using MagpieRSS
  15
  16 4.      Warning: MagpieRSS: Failed to fetch example.com/index.rdf.
  17         (HTTP Error: Invalid protocol "")
  18
  19 5.      Warning: MagpieRSS: Failed to parse RSS file.
  20         (not well-formed (invalid token) at line 19, column 98)
  21
  22 6.      Warning: MagpieRSS: Failed to fetch http://localhost/rss/features.1-0.rss.
  23         (HTTP Response: HTTP/1.1 404 Not Found)
  24
  25 If you would rather provide a custom error, see the COOKBOOK
  26 (http://magpierss.sf.net/cookbook.html) recipe 2.
  27
  28 *************************************************************************
  29 1.      Fatal error: Failed opening required '/path/to/script/rss_fetch.inc'
  30         (include_path='.:/usr/local/lib/php:/usr/local/lib/php/pear')
  31
  32         This could mean that:
  33
  34         a) PHP can't find the MagpieRSS files.
  35         b) PHP found them the MagpieRSS files, but can't read them.
  36
  37         a. Telling PHP where to look for MagpieRSS file.
  38
  39         This might mean your PHP program can't find the MagpieRSS libraries.
  40         Magpie relies on 4 include files, rss_fetch.inc, rss_parse.inc,
  41         rss_cache.inc, rss_util.inc, and for normal use you'll need all 4 (see the
  42         cookbook for exceptions).
  43
  44         This can be fixed by making sure the MagpieRSS files are in your include
  45         path.
  46
  47         If you can edit your include path (for example your on a shared host) then
  48         you need to replace:
  49
  50         require_once('rss_fetch.inc');
  51
  52         -with-
  53
  54         define('MAGPIE_DIR', '/path/to/magpierss/');
  55         require_once(MAGPIE_DIR.'rss_fetch.inc');
  56
  57         b.  PHP can't read the MagpieRSS files
  58
  59         All PHP libraries need to be readable by your webserver.
  60
  61         On Unix you can accomplish this with:
  62
  63         chmod 755 rss_fetch.inc rss_parse.inc rss_cache.inc rss_util.inc
  64
  65 *************************************************************************
  66 2. Cache couldn't make dir './cache'.
  67
  68         MagpieRSS caches the results of fetched and parsed RSS to reduce the load on
  69         both your server, and the remote server providing the RSS.  It does this by
  70         writing files to a cache directory.
  71
  72         This error means the webserver doesn't have write access to the current
  73         directory.
  74
  75         a. Make a webserver writeable cache directory
  76
  77         Find the webserver's group. (on my system it is 'www')
  78
  79         mkdir ./cache
  80         chgrp www directory_name
  81         chmod g+w directory_name
  82
  83         (this is the best, and desired solution)
  84
  85         b. Tell MagpieRSS to create the cache directory somewhere the webserver can
  86         write to.
  87
  88         define('MAGPIE_CACHE_DIR', '/tmp/magpierss');
  89
  90         (this is not a great solution, and might have security considerations)
  91
  92         c. Turn off cacheing.
  93
  94         Magpie can work fine with cacheing, but it will be slower, and you might
  95         become a nuiance to the RSS provider, but it is an option.
  96
  97         define('MAGPIE_CACHE_ON', 0);
  98
  99         d. And lastly, do NOT
 100
 101         chmod 777 ./cache
 102
 103         Any of the above solutions are better then this.
 104
 105         NOTE: If none of this works for you, let me know.  I've got root, and a
 106         custom compiled Apache on almost any box I ever touch, so I can be a little
 107         out of touch with reality.  But I won't know that if I don't feedback.
 108
 109 ************************************************************************* 3.
 110 3.      Fatal error: Failed to load PHP's XML Extension.
 111         http://www.php.net/manual/en/ref.xml.php
 112
 113         -or-
 114
 115         Fatal error: Failed to create an instance of PHP's XML parser.
 116         http://www.php.net/manual/en/ref.xml.php
 117
 118         Make sure your PHP was built with --with-xml
 119
 120         This has been turned on by default for several versions of PHP, but it might
 121         be turned off in your build.
 122
 123         See php.net for details on building and configuring PHP.
 124
 125
 126 *************************************************************************
 127 4.      Warning: MagpieRSS: Failed to fetch index.rdf.
 128         (HTTP Error: Invalid protocol "")
 129
 130         You need to put http:// in front of your the URL to your RSS feed
 131
 132 *************************************************************************
 133 5.      Warning: MagpieRSS: Failed to parse RSS file.
 134         (not well-formed (invalid token) at line 19, column 98)
 135
 136         There is a problem with the RSS feed you are trying to read.
 137         MagpieRSS is an XML parser, and therefore can't parse RSS feed with invalid
 138         characters.  Some RSS parser are based on regular expressions, and can
 139         parse invalid RSS but they have their own problems.
 140
 141         You could try contacting the author of the RSS feed, and pointing them to
 142         the online RSS validator at:
 143
 144         http://feeds.archive.org/validator/
 145
 146 *************************************************************************
 147 6.      Warning: MagpieRSS: Failed to fetch http://example.com/index.rdf
 148         (HTTP Response: HTTP/1.1 404 Not Found)
 149
 150         Its a 404!  The RSS file ain't there.
 151
 152