Merge remote-tracking branch 'upstream/master' into social-master
[quix0rs-gnu-social.git] / lib / framework.php
1 <?php
2 /*
3  * StatusNet - the distributed open-source microblogging tool
4  * Copyright (C) 2008-2010, StatusNet, Inc.
5  *
6  * This program is free software: you can redistribute it and/or modify
7  * it under the terms of the GNU Affero General Public License as published by
8  * the Free Software Foundation, either version 3 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU Affero General Public License for more details.
15  *
16  * You should have received a copy of the GNU Affero General Public License
17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
18  */
19
20 if (!defined('GNUSOCIAL')) { exit(1); }
21
22 define('GNUSOCIAL_ENGINE', 'GNU social');
23 define('GNUSOCIAL_ENGINE_URL', 'https://www.gnu.org/software/social/');
24
25 define('GNUSOCIAL_BASE_VERSION', '1.2.0');
26 define('GNUSOCIAL_LIFECYCLE', 'beta3'); // 'dev', 'alpha[0-9]+', 'beta[0-9]+', 'rc[0-9]+', 'release'
27
28 define('GNUSOCIAL_VERSION', GNUSOCIAL_BASE_VERSION . '-' . GNUSOCIAL_LIFECYCLE);
29
30 define('GNUSOCIAL_CODENAME', 'Only a fixed bug is a good bug.');
31
32 define('AVATAR_PROFILE_SIZE', 96);
33 define('AVATAR_STREAM_SIZE', 48);
34 define('AVATAR_MINI_SIZE', 24);
35
36 define('NOTICES_PER_PAGE', 20);
37 define('PROFILES_PER_PAGE', 20);
38 define('MESSAGES_PER_PAGE', 20);
39 define('GROUPS_PER_PAGE', 20);
40 define('APPS_PER_PAGE', 20);
41 define('PEOPLETAGS_PER_PAGE', 20);
42
43 define('GROUPS_PER_MINILIST', 8);
44 define('PROFILES_PER_MINILIST', 8);
45
46 define('FOREIGN_NOTICE_SEND', 1);
47 define('FOREIGN_NOTICE_RECV', 2);
48 define('FOREIGN_NOTICE_SEND_REPLY', 4);
49
50 define('FOREIGN_FRIEND_SEND', 1);
51 define('FOREIGN_FRIEND_RECV', 2);
52
53 define('NOTICE_INBOX_SOURCE_SUB', 1);
54 define('NOTICE_INBOX_SOURCE_GROUP', 2);
55 define('NOTICE_INBOX_SOURCE_REPLY', 3);
56 define('NOTICE_INBOX_SOURCE_FORWARD', 4);
57 define('NOTICE_INBOX_SOURCE_PROFILE_TAG', 5);
58 define('NOTICE_INBOX_SOURCE_GATEWAY', -1);
59
60 // append our extlib dir as the last-resort place to find libs
61
62 set_include_path(get_include_path() . PATH_SEPARATOR . INSTALLDIR . '/extlib/');
63
64 // To protect against upstream libraries which haven't updated
65 // for PHP 5.3 where dl() function may not be present...
66 if (!function_exists('dl')) {
67     // function_exists() returns false for things in disable_functions,
68     // but they still exist and we'll die if we try to redefine them.
69     //
70     // Fortunately trying to call the disabled one will only trigger
71     // a warning, not a fatal, so it's safe to leave it for our case.
72     // Callers will be suppressing warnings anyway.
73     $disabled = array_filter(array_map('trim', explode(',', ini_get('disable_functions'))));
74     if (!in_array('dl', $disabled)) {
75         function dl($library) {
76             return false;
77         }
78     }
79 }
80
81 // global configuration object
82
83 require_once 'PEAR.php';
84 require_once 'PEAR/Exception.php';
85 global $_PEAR;
86 $_PEAR = new PEAR;
87 $_PEAR->setErrorHandling(PEAR_ERROR_CALLBACK, 'PEAR_ErrorToPEAR_Exception');
88
89 require_once 'DB.php';
90 require_once 'DB/DataObject.php';
91 require_once 'DB/DataObject/Cast.php'; # for dates
92 global $_DB;
93 $_DB = new DB;
94
95 require_once(INSTALLDIR.'/lib/language.php');
96
97 // This gets included before the config file, so that admin code and plugins
98 // can use it
99
100 require_once(INSTALLDIR.'/lib/event.php');
101 require_once(INSTALLDIR.'/lib/plugin.php');
102
103 function addPlugin($name, array $attrs=array())
104 {
105     return GNUsocial::addPlugin($name, $attrs);
106 }
107
108 function _have_config()
109 {
110     return GNUsocial::haveConfig();
111 }
112
113 function common_get_temp_dir()
114 {
115     // Try to get it from php.ini first
116     $temp_path = trim(ini_get('upload_tmp_dir'));
117
118     // Is it empty?
119     if (strlen($temp_path) == 0) {
120         // Then try sys_get_temp_dir()
121         $temp_path = trim(sys_get_temp_dir());
122
123         // Still empty?
124         if (strlen($temp_path) == 0) {
125             // Then set it to /tmp (ugly)
126             // @TODO Hard-coded non-Windows stuff!
127             $temp_path = '/tmp';
128         }
129     }
130
131     // Return found path
132     return $temp_path;
133 }
134
135 function GNUsocial_class_autoload($cls)
136 {
137     if (file_exists(INSTALLDIR.'/classes/' . $cls . '.php')) {
138         require_once(INSTALLDIR.'/classes/' . $cls . '.php');
139     } else if (file_exists(INSTALLDIR.'/lib/' . strtolower($cls) . '.php')) {
140         require_once(INSTALLDIR.'/lib/' . strtolower($cls) . '.php');
141     } else if (mb_substr($cls, -6) == 'Action' &&
142                file_exists(INSTALLDIR.'/actions/' . strtolower(mb_substr($cls, 0, -6)) . '.php')) {
143         require_once(INSTALLDIR.'/actions/' . strtolower(mb_substr($cls, 0, -6)) . '.php');
144     } else if ($cls === 'OAuthRequest' || $cls === 'OAuthException') {
145         require_once('OAuth.php');
146     } else {
147         Event::handle('Autoload', array(&$cls));
148     }
149 }
150
151
152 // Autoload function queue, starting with our own discovery method
153 spl_autoload_register('GNUsocial_class_autoload');
154
155 /**
156  * Extlibs with namespaces (or directly in extlib/)
157  * This covers libraries such as: Validate and \Michelf\Markdown
158  *
159  * The namespaced based structure is called "PSR-0 autoloading standard":
160  *    \<Vendor Name>\(<Namespace>\)*<Class Name>
161  * and is available here: http://www.php-fig.org/psr/psr-0/
162 */
163 spl_autoload_register(function($class){
164     $class_path = preg_replace('{\\\\|_(?!.*\\\\)}', DIRECTORY_SEPARATOR, ltrim($class, '\\')).'.php';
165     $file = INSTALLDIR.'/extlib/'.$class_path;
166     if (file_exists($file)) {
167         require_once $file;
168         return;
169     }
170
171     # Try if the system has this external library
172     $file = '/usr/share/php/'.$class_path;
173     if (file_exists($file)) {
174         require_once $file;
175         return;
176     }
177 });
178
179 require_once INSTALLDIR.'/lib/util.php';
180 require_once INSTALLDIR.'/lib/action.php';
181 require_once INSTALLDIR.'/lib/mail.php';
182
183 //set PEAR error handling to use regular PHP exceptions
184 function PEAR_ErrorToPEAR_Exception(PEAR_Error $err)
185 {
186     //DB_DataObject throws error when an empty set would be returned
187     //That behavior is weird, and not how the rest of StatusNet works.
188     //So just ignore those errors.
189     if ($err->getCode() == DB_DATAOBJECT_ERROR_NODATA) {
190         return;
191     }
192
193     $msg      = $err->getMessage();
194     $userInfo = $err->getUserInfo();
195
196     // Log this; push the message up as an exception
197
198     common_log(LOG_ERR, "PEAR Error: $msg ($userInfo)");
199
200     // HACK: queue handlers get kicked by the long-query killer, and 
201     // keep the same broken connection. We die here to get a new
202     // process started.
203
204     if (php_sapi_name() == 'cli' && preg_match('/nativecode=2006/', $userInfo)) {
205         common_log(LOG_ERR, "Lost DB connection; dying.");
206         exit(100);
207     }
208
209     if ($err->getCode()) {
210         throw new PEAR_Exception($err->getMessage(), $err->getCode());
211     }
212     throw new PEAR_Exception($err->getMessage());
213 }