← Back to branch summary

~pablocapeluto/cds-php/devel-3.1

« back to all changes in this revision

Viewing changes to rss/magpierss/TROUBLESHOOTING

  • Committer: pcapeluto at gmail
  • Date: 2010-08-20 17:51:08 UTC
  • Revision ID: pcapeluto@gmail.com-20100820175108-jyi8dbyj15uy9p4i
Initial import

Show diffs side-by-side

added added

removed removed

Lines of Context:
rss/magpierss/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