Commit | Line | Data |
---|---|---|
6a488035 | 1 | <?php |
6a488035 TO |
2 | /* |
3 | +--------------------------------------------------------------------+ | |
81621fee | 4 | | CiviCRM version 4.7 | |
6a488035 | 5 | +--------------------------------------------------------------------+ |
e7112fa7 | 6 | | Copyright CiviCRM LLC (c) 2004-2015 | |
6a488035 TO |
7 | +--------------------------------------------------------------------+ |
8 | | This file is a part of CiviCRM. | | |
9 | | | | |
10 | | CiviCRM is free software; you can copy, modify, and distribute it | | |
11 | | under the terms of the GNU Affero General Public License | | |
12 | | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. | | |
13 | | | | |
14 | | CiviCRM is distributed in the hope that it will be useful, but | | |
15 | | WITHOUT ANY WARRANTY; without even the implied warranty of | | |
16 | | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | | |
17 | | See the GNU Affero General Public License for more details. | | |
18 | | | | |
19 | | You should have received a copy of the GNU Affero General Public | | |
20 | | License and the CiviCRM Licensing Exception along | | |
21 | | with this program; if not, contact CiviCRM LLC | | |
22 | | at info[AT]civicrm[DOT]org. If you have questions about the | | |
23 | | GNU Affero General Public License or the licensing of CiviCRM, | | |
24 | | see the CiviCRM license FAQ at http://civicrm.org/licensing | | |
25 | +--------------------------------------------------------------------+ | |
26 | */ | |
27 | ||
28 | /** | |
b081365f | 29 | * This api exposes CiviCRM system functionality. |
6a488035 | 30 | * |
b081365f | 31 | * Includes caching, logging, and checking system functionality. |
6a488035 | 32 | * |
b081365f | 33 | * @package CiviCRM_APIv3 |
6a488035 TO |
34 | */ |
35 | ||
36 | /** | |
9d32e6f7 | 37 | * Flush all system caches. |
6a488035 | 38 | * |
cf470720 TO |
39 | * @param array $params |
40 | * Input parameters. | |
c28e1768 CW |
41 | * - triggers: bool, whether to drop/create SQL triggers; default: FALSE |
42 | * - session: bool, whether to reset the CiviCRM session data; default: FALSE | |
6a488035 | 43 | * |
c23f45d3 | 44 | * @return array |
6a488035 TO |
45 | */ |
46 | function civicrm_api3_system_flush($params) { | |
47 | CRM_Core_Invoke::rebuildMenuAndCaches( | |
48 | CRM_Utils_Array::value('triggers', $params, FALSE), | |
49 | CRM_Utils_Array::value('session', $params, FALSE) | |
50 | ); | |
51 | return civicrm_api3_create_success(); | |
52 | } | |
53 | ||
11e09c59 | 54 | /** |
9d32e6f7 | 55 | * Adjust Metadata for Flush action. |
6a488035 | 56 | * |
0aa0303c EM |
57 | * The metadata is used for setting defaults, documentation & validation. |
58 | * | |
cf470720 | 59 | * @param array $params |
b081365f | 60 | * Array of parameters determined by getfields. |
6a488035 | 61 | */ |
9b873358 | 62 | function _civicrm_api3_system_flush_spec(&$params) { |
b2ed8e73 CW |
63 | $params['triggers'] = array( |
64 | 'title' => 'Triggers', | |
65 | 'description' => 'rebuild triggers (boolean)', | |
66 | 'type' => CRM_Utils_Type::T_BOOLEAN, | |
67 | ); | |
68 | $params['session'] = array( | |
69 | 'title' => 'Sessions', | |
70 | 'description' => 'refresh sessions (boolean)', | |
71 | 'type' => CRM_Utils_Type::T_BOOLEAN, | |
72 | ); | |
9ef501da | 73 | } |
6a488035 | 74 | |
9ef501da | 75 | /** |
9d32e6f7 EM |
76 | * System.Check API specification (optional). |
77 | * | |
9ef501da TO |
78 | * This is used for documentation and validation. |
79 | * | |
cf470720 TO |
80 | * @param array $spec |
81 | * Description of fields supported by this API call. | |
9d32e6f7 | 82 | * |
9ef501da TO |
83 | * @see http://wiki.civicrm.org/confluence/display/CRM/API+Architecture+Standards |
84 | */ | |
85 | function _civicrm_api3_system_check_spec(&$spec) { | |
86 | // $spec['magicword']['api.required'] = 1; | |
a1c17079 | 87 | $spec['show_hushed'] = array( |
097c681e AH |
88 | 'api.default' => FALSE, |
89 | 'title' => 'Show hushed', | |
a1c17079 | 90 | 'type' => CRM_Utils_Type::T_BOOLEAN, |
097c681e | 91 | ); |
232624b1 | 92 | } |
9ef501da TO |
93 | |
94 | /** | |
b081365f | 95 | * System Check API. |
9ef501da TO |
96 | * |
97 | * @param array $params | |
9d32e6f7 | 98 | * |
a6c01b45 | 99 | * @return array |
72b3a70c | 100 | * API result descriptor; return items are alert codes/messages |
9ef501da TO |
101 | * @see civicrm_api3_create_success |
102 | * @see civicrm_api3_create_error | |
103 | * @throws API_Exception | |
104 | */ | |
105 | function civicrm_api3_system_check($params) { | |
e918c16d | 106 | // array(array('name'=> $, 'severity'=>$, ...)) |
7c6fb573 | 107 | $id = 1; |
9ef501da | 108 | $returnValues = array(); |
e918c16d NM |
109 | |
110 | // array(CRM_Utils_Check_Message) | |
46a903fb | 111 | $messages = CRM_Utils_Check::singleton()->checkAll(); |
e918c16d | 112 | |
7c6fb573 NM |
113 | foreach ($messages as $msg) { |
114 | $returnValues[] = $msg->toArray() + array('id' => $id++); | |
46a903fb NM |
115 | } |
116 | ||
7c6fb573 | 117 | return _civicrm_api3_basic_array_get('systemCheck', $params, $returnValues, id, array('id', 'name', 'message', 'title', 'severity', 'isVisible')); |
e2bef985 | 118 | } |
119 | ||
120 | /** | |
9d32e6f7 EM |
121 | * Log entry to system log table. |
122 | * | |
c490a46a | 123 | * @param array $params |
e2bef985 | 124 | * |
125 | * @return array | |
126 | */ | |
127 | function civicrm_api3_system_log($params) { | |
128 | $log = new CRM_Utils_SystemLogger(); | |
9d32e6f7 | 129 | // This part means fields with separate db storage are accepted as params which kind of seems more intuitive to me |
e2bef985 | 130 | // because I felt like not doing this required a bunch of explanation in the spec function - but perhaps other won't see it as helpful? |
22e263ad | 131 | if (!isset($params['context'])) { |
e2bef985 | 132 | $params['context'] = array(); |
133 | } | |
134 | $specialFields = array('contact_id', 'hostname'); | |
22e263ad TO |
135 | foreach ($specialFields as $specialField) { |
136 | if (isset($params[$specialField]) && !isset($params['context'])) { | |
e2bef985 | 137 | $params['context'][$specialField] = $params[$specialField]; |
138 | } | |
139 | } | |
140 | $returnValues = $log->log($params['level'], $params['message'], $params['context']); | |
141 | return civicrm_api3_create_success($returnValues, $params, 'System', 'Log'); | |
142 | } | |
143 | ||
144 | /** | |
d1b0d05e EM |
145 | * Metadata for log function. |
146 | * | |
c490a46a | 147 | * @param array $params |
e2bef985 | 148 | */ |
4f8ccea0 | 149 | function _civicrm_api3_system_log_spec(&$params) { |
e2bef985 | 150 | $params['level'] = array( |
151 | 'title' => 'Log Level', | |
152 | 'description' => 'Log level as described in PSR3 (info, debug, warning etc)', | |
153 | 'type' => CRM_Utils_Type::T_STRING, | |
154 | 'api.required' => TRUE, | |
155 | ); | |
156 | $params['message'] = array( | |
157 | 'title' => 'Log Message', | |
158 | 'description' => 'Standardised message string, you can also ', | |
159 | 'type' => CRM_Utils_Type::T_STRING, | |
160 | 'api.required' => TRUE, | |
161 | ); | |
162 | $params['context'] = array( | |
163 | 'title' => 'Log Context', | |
164 | 'description' => 'An array of additional data to store.', | |
165 | 'type' => CRM_Utils_Type::T_LONGTEXT, | |
166 | 'api.default' => array(), | |
167 | ); | |
168 | $params['contact_id'] = array( | |
169 | 'title' => 'Log Contact ID', | |
170 | 'description' => 'Optional ID of relevant contact', | |
171 | 'type' => CRM_Utils_Type::T_INT, | |
172 | ); | |
173 | $params['hostname'] = array( | |
174 | 'title' => 'Log Hostname', | |
175 | 'description' => 'Optional name of host', | |
176 | 'type' => CRM_Utils_Type::T_STRING, | |
177 | ); | |
178 | } | |
42bf9336 | 179 | |
91f1889e | 180 | /** |
d1b0d05e | 181 | * System.Get API. |
91f1889e | 182 | * |
24a70b66 | 183 | * @param array $params |
d1b0d05e | 184 | * |
24a70b66 | 185 | * @return array |
91f1889e TO |
186 | */ |
187 | function civicrm_api3_system_get($params) { | |
5bbcc823 | 188 | $config = CRM_Core_Config::singleton(); |
91f1889e TO |
189 | $returnValues = array( |
190 | array( | |
5bbcc823 TO |
191 | 'version' => CRM_Utils_System::version(), // deprecated in favor of civi.version |
192 | 'uf' => CIVICRM_UF, // deprecated in favor of cms.type | |
193 | 'php' => array( | |
194 | 'version' => phpversion(), | |
195 | 'tz' => date_default_timezone_get(), | |
196 | 'extensions' => get_loaded_extensions(), | |
197 | 'ini' => _civicrm_api3_system_get_redacted_ini(), | |
198 | ), | |
199 | 'mysql' => array( | |
200 | 'version' => CRM_Core_DAO::singleValueQuery('SELECT @@version'), | |
201 | ), | |
202 | 'cms' => array( | |
203 | 'type' => CIVICRM_UF, | |
204 | 'modules' => CRM_Core_Module::collectStatuses($config->userSystem->getModules()), | |
205 | ), | |
206 | 'civi' => array( | |
207 | 'version' => CRM_Utils_System::version(), | |
208 | 'dev' => (bool) CRM_Utils_System::isDevelopment(), | |
209 | 'components' => array_keys(CRM_Core_Component::getEnabledComponents()), | |
210 | 'extensions' => preg_grep( | |
211 | '/^uninstalled$/', | |
212 | CRM_Extension_System::singleton()->getManager()->getStatuses(), | |
213 | PREG_GREP_INVERT | |
214 | ), | |
215 | 'exampleUrl' => CRM_Utils_System::url('civicrm/example', NULL, TRUE, NULL, FALSE), | |
216 | ), | |
91f1889e TO |
217 | ), |
218 | ); | |
5bbcc823 | 219 | |
91f1889e TO |
220 | return civicrm_api3_create_success($returnValues, $params, 'System', 'get'); |
221 | } | |
5bbcc823 TO |
222 | |
223 | /** | |
224 | * Generate a sanitized/anonymized/redacted dump of the PHP configuration. | |
225 | * | |
226 | * Some INI fields contain site-identifying information (SII) -- e.g. URLs, | |
227 | * hostnames, file paths, IP addresses, passwords, or free-form comments | |
228 | * could be used to identify a site or gain access to its resources. | |
229 | * | |
230 | * A number of INI fields have been examined to determine whether they | |
231 | * contain SII. Approved fields are put in a whitelist; all other fields | |
232 | * are redacted. | |
233 | * | |
234 | * Redaction hides the substance of a field but does not completely omit | |
235 | * all information. Consider the field 'mail.log' - setting this field | |
236 | * has a functional effect (it enables or disables the logging behavior) | |
237 | * and also points to particular file. Empty values (FALSE/NULL/0/"") | |
238 | * will pass through redaction, but all other values will be replaced | |
239 | * by a string (eg "REDACTED"). This roughly indicates whether the | |
240 | * option is enabled/disabled without giving away its content. | |
241 | * | |
242 | * @return array | |
243 | */ | |
244 | function _civicrm_api3_system_get_redacted_ini() { | |
245 | static $whitelist = NULL; | |
246 | if ($whitelist === NULL) { | |
247 | $whitelistFile = __DIR__ . '/System/ini-whitelist.txt'; | |
248 | $whitelist = array_filter( | |
249 | explode("\n", file_get_contents($whitelistFile)), | |
250 | function ($k) { | |
251 | return !empty($k) && !preg_match('/^\s*#/', $k); | |
252 | } | |
253 | ); | |
254 | } | |
255 | ||
256 | $inis = ini_get_all(NULL, FALSE); | |
257 | $result = array(); | |
258 | foreach ($inis as $k => $v) { | |
259 | if (empty($v) || in_array($k, $whitelist)) { | |
260 | $result[$k] = $v; | |
261 | } | |
262 | else { | |
263 | $result[$k] = 'REDACTED'; | |
264 | } | |
265 | } | |
266 | ||
267 | return $result; | |
268 | } |