Duplicate code is one of the most pungent code smells. A rule that is often used is to re-structure code once it is duplicated in three or more places.
Common duplication problems, and corresponding solutions are:
Complex classes like UserAPI often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use UserAPI, and based on these observations, apply Extract Interface, too.
| 1 | <?php  | 
            ||
| 32 | class UserAPI extends CAT { | 
            ||
| 33 | |||
| 34 |     public function __construct() { | 
            ||
| 35 | parent::__construct();  | 
            ||
| 36 | }  | 
            ||
| 37 | |||
| 38 | /**  | 
            ||
| 39 | * Prepare the device module environment and send back the link  | 
            ||
| 40 |      * This method creates a device module instance via the {@link DeviceFactory} call,  | 
            ||
| 41 | * then sets up the device module environment for the specific profile by calling  | 
            ||
| 42 |      * {@link DeviceConfig::setup()} method and finally, called the devide writeInstaller meethod | 
            ||
| 43 | * passing the returned path name.  | 
            ||
| 44 | *  | 
            ||
| 45 |      * @param string $device identifier as in {@link devices.php} | 
            ||
| 46 | * @param int $profileId profile identifier  | 
            ||
| 47 | *  | 
            ||
| 48 | * @return array  | 
            ||
| 49 | * array with the following fields:  | 
            ||
| 50 | * profile - the profile identifier;  | 
            ||
| 51 | * device - the device identifier;  | 
            ||
| 52 | * link - the path name of the resulting installer  | 
            ||
| 53 | * mime - the mimetype of the installer  | 
            ||
| 54 | */  | 
            ||
| 55 |     public function generateInstaller($device, $profileId, $generatedFor = "user", $token = NULL, $password = NULL) { | 
            ||
| 56 |         $this->languageInstance->setTextDomain("devices"); | 
            ||
| 57 | $this->loggerInstance->debug(4, "installer:$device:$profileId\n");  | 
            ||
| 58 | $validator = new \web\lib\common\InputValidation();  | 
            ||
| 59 | $profile = $validator->Profile($profileId);  | 
            ||
| 60 | $attribs = $profile->getCollapsedAttributes();  | 
            ||
| 61 | // test if the profile is production-ready and if not if the authenticated user is an owner  | 
            ||
| 62 |         if (!isset($attribs['profile:production']) || (isset($attribs['profile:production']) && $attribs['profile:production'][0] != "on")) { | 
            ||
| 63 | $this->loggerInstance->debug(4, "Attempt to download a non-production ready installer fir profile: $profileId\n");  | 
            ||
| 64 | $auth = new \web\lib\admin\Authentication();  | 
            ||
| 65 |             if (!$auth->isAuthenticated()) { | 
            ||
| 66 | $this->loggerInstance->debug(2, "User NOT authenticated, rejecting request for a non-production installer\n");  | 
            ||
| 67 |                 header("HTTP/1.0 403 Not Authorized"); | 
            ||
| 68 | return;  | 
            ||
| 69 | }  | 
            ||
| 70 | |||
| 71 | $userObject = new User($_SESSION['user']);  | 
            ||
| 72 |             if (!$userObject->isIdPOwner($profile->institution)) { | 
            ||
| 73 | $this->loggerInstance->debug(2, "User not an owner of a non-production profile - access forbidden\n");  | 
            ||
| 74 |                 header("HTTP/1.0 403 Not Authorized"); | 
            ||
| 75 | return;  | 
            ||
| 76 | }  | 
            ||
| 77 | $this->loggerInstance->debug(4, "User is the owner - allowing access\n");  | 
            ||
| 78 | }  | 
            ||
| 79 | $installerProperties = [];  | 
            ||
| 80 | $installerProperties['profile'] = $profileId;  | 
            ||
| 81 | $installerProperties['device'] = $device;  | 
            ||
| 82 | $this->installerPath = $this->getCachedPath($device, $profile);  | 
            ||
| 83 |         if ($this->installerPath && $token == NULL && $password == NULL) { | 
            ||
| 84 | $this->loggerInstance->debug(4, "Using cached installer for: $device\n");  | 
            ||
| 85 | $installerProperties['link'] = "API.php?action=downloadInstaller&lang=" . $this->languageInstance->getLang() . "&profile=$profileId&device=$device&generatedfor=$generatedFor";  | 
            ||
| 86 | $installerProperties['mime'] = $cache['mime'];  | 
            ||
| 
                                                                                                    
                        
                         | 
                |||
| 87 |         } else { | 
            ||
| 88 | $myInstaller = $this->generateNewInstaller($device, $profile, $generatedFor, $token, $password);  | 
            ||
| 89 | $installerProperties['mime'] = $myInstaller['mime'];  | 
            ||
| 90 | $installerProperties['link'] = $myInstaller['link'];  | 
            ||
| 91 | }  | 
            ||
| 92 |         $this->languageInstance->setTextDomain("web_user"); | 
            ||
| 93 | return($installerProperties);  | 
            ||
| 94 | }  | 
            ||
| 95 | |||
| 96 | /**  | 
            ||
| 97 | * This function tries to find a cached copy of an installer for a given  | 
            ||
| 98 | * combination of Profile and device  | 
            ||
| 99 | * @param string $device  | 
            ||
| 100 | * @param AbstractProfile $profile  | 
            ||
| 101 | * @return boolean|string the string with the path to the cached copy, or FALSE if no cached copy exists  | 
            ||
| 102 | */  | 
            ||
| 103 |     private function getCachedPath($device, $profile) { | 
            ||
| 122 | |||
| 123 | /**  | 
            ||
| 124 | * Generates a new installer for the given combination of device and Profile  | 
            ||
| 125 | *  | 
            ||
| 126 | * @param string $device  | 
            ||
| 127 | * @param AbstractProfile $profile  | 
            ||
| 128 | * @return array info about the new installer (mime and link)  | 
            ||
| 129 | */  | 
            ||
| 130 |     private function generateNewInstaller($device, $profile, $generatedFor, $token, $password) { | 
            ||
| 131 | $this->loggerInstance->debug(5, "generateNewInstaller() - Enter");  | 
            ||
| 132 | $factory = new DeviceFactory($device);  | 
            ||
| 133 | $this->loggerInstance->debug(5, "generateNewInstaller() - created Device");  | 
            ||
| 134 | $dev = $factory->device;  | 
            ||
| 135 | $out = [];  | 
            ||
| 136 |         if (isset($dev)) { | 
            ||
| 137 | $dev->setup($profile, $token, $password);  | 
            ||
| 138 | $this->loggerInstance->debug(5, "generateNewInstaller() - Device setup done");  | 
            ||
| 139 | $installer = $dev->writeInstaller();  | 
            ||
| 140 | $this->loggerInstance->debug(5, "generateNewInstaller() - writeInstaller complete");  | 
            ||
| 141 | $iPath = $dev->FPATH . '/tmp/' . $installer;  | 
            ||
| 142 |             if ($iPath && is_file($iPath)) { | 
            ||
| 143 |                 if (isset($dev->options['mime'])) { | 
            ||
| 144 | $out['mime'] = $dev->options['mime'];  | 
            ||
| 145 |                 } else { | 
            ||
| 146 | $info = new \finfo();  | 
            ||
| 147 | $out['mime'] = $info->file($iPath, FILEINFO_MIME_TYPE);  | 
            ||
| 148 | }  | 
            ||
| 149 | $this->installerPath = $dev->FPATH . '/' . $installer;  | 
            ||
| 150 | rename($iPath, $this->installerPath);  | 
            ||
| 151 | $integerEap = (new \core\common\EAP($dev->selectedEap))->getIntegerRep();  | 
            ||
| 152 | $profile->updateCache($device, $this->installerPath, $out['mime'], $integerEap);  | 
            ||
| 153 |                 if (CONFIG['DEBUG_LEVEL'] < 4) { | 
            ||
| 154 | \core\common\Entity::rrmdir($dev->FPATH . '/tmp');  | 
            ||
| 155 | }  | 
            ||
| 156 | $this->loggerInstance->debug(4, "Generated installer: " . $this->installerPath . ": for: $device, EAP:" . $integerEap . "\n");  | 
            ||
| 157 | $out['link'] = "API.php?action=downloadInstaller&lang=" . $this->languageInstance->getLang() . "&profile=" . $profile->identifier . "&device=$device&generatedfor=$generatedFor";  | 
            ||
| 158 |             } else { | 
            ||
| 159 | $this->loggerInstance->debug(2, "Installer generation failed for: " . $profile->identifier . ":$device:" . $this->languageInstance->getLang() . "\n");  | 
            ||
| 160 | $out['link'] = 0;  | 
            ||
| 161 | }  | 
            ||
| 162 | }  | 
            ||
| 163 | return($out);  | 
            ||
| 164 | }  | 
            ||
| 165 | |||
| 166 | /**  | 
            ||
| 167 | * interface to Devices::listDevices()  | 
            ||
| 168 | */  | 
            ||
| 169 |     public function listDevices($showHidden = 0) { | 
            ||
| 170 | $dev = \devices\Devices::listDevices();  | 
            ||
| 171 | $returnList = [];  | 
            ||
| 172 | $count = 0;  | 
            ||
| 173 |         if ($showHidden !== 0 && $showHidden != 1) { | 
            ||
| 174 |             throw new Exception("show_hidden is only be allowed to be 0 or 1, but it is $showHidden!"); | 
            ||
| 175 | }  | 
            ||
| 176 |         foreach ($dev as $device => $deviceProperties) { | 
            ||
| 177 |             if (isset($deviceProperties['options']['hidden']) && $deviceProperties['options']['hidden'] && $showHidden == 0) { | 
            ||
| 178 | continue;  | 
            ||
| 179 | }  | 
            ||
| 180 | $count ++;  | 
            ||
| 181 | |||
| 182 | $deviceProperties['device'] = $device;  | 
            ||
| 183 | |||
| 184 | $group = isset($deviceProperties['group']) ? $deviceProperties['group'] : 'other';  | 
            ||
| 185 |             if (!isset($returnList[$group])) { | 
            ||
| 186 | $returnList[$group] = [];  | 
            ||
| 187 | }  | 
            ||
| 188 | $returnList[$group][$device] = $deviceProperties;  | 
            ||
| 189 | }  | 
            ||
| 190 | return $returnList;  | 
            ||
| 191 | }  | 
            ||
| 192 | |||
| 193 |     public function deviceInfo($device, $profileId) { | 
            ||
| 194 |         $this->languageInstance->setTextDomain("devices"); | 
            ||
| 195 | $validator = new \web\lib\common\InputValidation();  | 
            ||
| 196 | $out = 0;  | 
            ||
| 197 | $profile = $validator->Profile($profileId);  | 
            ||
| 198 | $factory = new DeviceFactory($device);  | 
            ||
| 199 | $dev = $factory->device;  | 
            ||
| 200 |         if (isset($dev)) { | 
            ||
| 201 | $dev->setup($profile);  | 
            ||
| 202 | $out = $dev->writeDeviceInfo();  | 
            ||
| 203 | }  | 
            ||
| 204 |         $this->languageInstance->setTextDomain("web_user"); | 
            ||
| 205 | echo $out;  | 
            ||
| 206 | }  | 
            ||
| 207 | |||
| 208 | /**  | 
            ||
| 209 | * Prepare the support data for a given profile  | 
            ||
| 210 | *  | 
            ||
| 211 | * @param int $profId profile identifier  | 
            ||
| 212 | * @return array  | 
            ||
| 213 | * array with the following fields:  | 
            ||
| 214 | * - local_email  | 
            ||
| 215 | * - local_phone  | 
            ||
| 216 | * - local_url  | 
            ||
| 217 | * - description  | 
            ||
| 218 | * - devices - an array of device names and their statuses (for a given profile)  | 
            ||
| 219 | */  | 
            ||
| 220 |     public function profileAttributes($profId) { | 
            ||
| 221 |         $this->languageInstance->setTextDomain("devices"); | 
            ||
| 222 | $validator = new \web\lib\common\InputValidation();  | 
            ||
| 223 | $profile = $validator->Profile($profId);  | 
            ||
| 224 | $attribs = $profile->getCollapsedAttributes();  | 
            ||
| 225 | $returnArray = [];  | 
            ||
| 226 | $returnArray['silverbullet'] = $profile instanceof ProfileSilverbullet ? 1 : 0;  | 
            ||
| 227 |         if (isset($attribs['support:email'])) { | 
            ||
| 228 | $returnArray['local_email'] = $attribs['support:email'][0];  | 
            ||
| 229 | }  | 
            ||
| 230 |         if (isset($attribs['support:phone'])) { | 
            ||
| 231 | $returnArray['local_phone'] = $attribs['support:phone'][0];  | 
            ||
| 232 | }  | 
            ||
| 233 |         if (isset($attribs['support:url'])) { | 
            ||
| 234 | $returnArray['local_url'] = $attribs['support:url'][0];  | 
            ||
| 235 | }  | 
            ||
| 236 |         if (isset($attribs['profile:description'])) { | 
            ||
| 237 | $returnArray['description'] = $attribs['profile:description'][0];  | 
            ||
| 238 | }  | 
            ||
| 239 | $returnArray['devices'] = $profile->listDevices();  | 
            ||
| 240 |         $this->languageInstance->setTextDomain("web_user"); | 
            ||
| 241 | return($returnArray);  | 
            ||
| 242 | }  | 
            ||
| 243 | |||
| 244 | /*  | 
            ||
| 245 | this method needs to be used with care, it could give wrong results in some  | 
            ||
| 246 | cicumstances  | 
            ||
| 247 | */  | 
            ||
| 248 | |||
| 249 |     private function GetRootURL() { | 
            ||
| 250 | $backtrace = debug_backtrace();  | 
            ||
| 251 | $backtraceFileInfo = array_pop($backtrace);  | 
            ||
| 252 | $fileTemp = $backtraceFileInfo['file'];  | 
            ||
| 253 | $file = substr($fileTemp, strlen(dirname(__DIR__)));  | 
            ||
| 254 |         while (substr($file, 0, 1) == '/') { | 
            ||
| 255 | $file = substr($file, 1);  | 
            ||
| 256 | }  | 
            ||
| 257 |         $slashCount = count(explode('/', $file)); | 
            ||
| 258 | $out = $_SERVER['SCRIPT_NAME'];  | 
            ||
| 259 |         for ($iterator = 0; $iterator < $slashCount; $iterator++) { | 
            ||
| 260 | $out = dirname($out);  | 
            ||
| 261 | }  | 
            ||
| 262 |         if ($out == '/') { | 
            ||
| 263 | $out = '';  | 
            ||
| 264 | }  | 
            ||
| 265 | return '//' . $_SERVER['SERVER_NAME'] . $out;  | 
            ||
| 266 | }  | 
            ||
| 267 | |||
| 268 | /* JSON functions */  | 
            ||
| 269 | |||
| 270 |     public function return_json($data, $status = 1) { | 
            ||
| 271 | $returnArray = [];  | 
            ||
| 272 | $returnArray['status'] = $status;  | 
            ||
| 273 | $returnArray['data'] = $data;  | 
            ||
| 274 | $returnArray['tou'] = "Please consult Terms of Use at: " . $this->GetRootURL() . "/tou.php";  | 
            ||
| 275 | return(json_encode($returnArray));  | 
            ||
| 276 | }  | 
            ||
| 277 | |||
| 278 | /**  | 
            ||
| 279 | * Return the list of supported languages.  | 
            ||
| 280 | *  | 
            ||
| 281 | *  | 
            ||
| 282 | */  | 
            ||
| 283 |     public function JSON_listLanguages() { | 
            ||
| 284 | $returnArray = [];  | 
            ||
| 285 |         foreach (CONFIG['LANGUAGES'] as $id => $val) { | 
            ||
| 286 | $returnArray[] = ['lang' => $id, 'display' => $val['display'], 'locale' => $val['locale']];  | 
            ||
| 287 | }  | 
            ||
| 288 | echo $this->return_json($returnArray);  | 
            ||
| 289 | }  | 
            ||
| 290 | |||
| 291 | /**  | 
            ||
| 292 | * Return the list of countiers with configured IdPs  | 
            ||
| 293 | *  | 
            ||
| 294 | * @return string JSON encoded data  | 
            ||
| 295 | */  | 
            ||
| 296 |     public function JSON_listCountries() { | 
            ||
| 297 | $federations = $this->printCountryList(1);  | 
            ||
| 298 | $returnArray = [];  | 
            ||
| 299 |         foreach ($federations as $id => $val) { | 
            ||
| 300 | $returnArray[] = ['federation' => $id, 'display' => $val];  | 
            ||
| 301 | }  | 
            ||
| 302 | echo $this->return_json($returnArray);  | 
            ||
| 303 | }  | 
            ||
| 304 | |||
| 305 | /**  | 
            ||
| 306 | * Return the list of IdPs in a given country  | 
            ||
| 307 | *  | 
            ||
| 308 | * @param string $country the country we are interested in  | 
            ||
| 309 | * @return string JSON encoded data  | 
            ||
| 310 | */  | 
            ||
| 311 |     public function JSON_listIdentityProviders($country) { | 
            ||
| 312 | $idps = $this->listAllIdentityProviders(1, $country);  | 
            ||
| 313 | $returnArray = [];  | 
            ||
| 314 | View Code Duplication |         foreach ($idps as $idp) { | 
            |
| 315 | $returnArray[] = ['idp' => $idp['entityID'], 'display' => $idp['title']];  | 
            ||
| 316 | }  | 
            ||
| 317 | echo $this->return_json($returnArray);  | 
            ||
| 318 | }  | 
            ||
| 319 | |||
| 320 | /**  | 
            ||
| 321 | * return the list of all active IdPs  | 
            ||
| 322 | *  | 
            ||
| 323 | * The IdP list is formatted for DiscoJuice  | 
            ||
| 324 | * @return string JSON encoded data  | 
            ||
| 325 | */  | 
            ||
| 326 |     public function JSON_listIdentityProvidersForDisco() { | 
            ||
| 327 | $idps = $this->listAllIdentityProviders(1);  | 
            ||
| 328 | $returnArray = [];  | 
            ||
| 329 |         foreach ($idps as $idp) { | 
            ||
| 330 | $idp['idp'] = $idp['entityID'];  | 
            ||
| 331 | $returnArray[] = $idp;  | 
            ||
| 332 | }  | 
            ||
| 333 | echo json_encode($returnArray);  | 
            ||
| 334 | }  | 
            ||
| 335 | |||
| 336 | /**  | 
            ||
| 337 | * Return the list of IdPs in a given country ordered with respect to the user location  | 
            ||
| 338 | *  | 
            ||
| 339 | * @return string JSON encoded data  | 
            ||
| 340 | */  | 
            ||
| 341 |     public function JSON_orderIdentityProviders($country, $location = NULL) { | 
            ||
| 342 | $idps = $this->orderIdentityProviders($country, $location);  | 
            ||
| 343 | $returnArray = [];  | 
            ||
| 344 | View Code Duplication |         foreach ($idps as $idp) { | 
            |
| 345 | $returnArray[] = ['idp' => $idp['id'], 'display' => $idp['title']];  | 
            ||
| 346 | }  | 
            ||
| 347 | echo $this->return_json($returnArray);  | 
            ||
| 348 | }  | 
            ||
| 349 | |||
| 350 | /**  | 
            ||
| 351 | * Produce a list of profiles available for a given IdP  | 
            ||
| 352 | *  | 
            ||
| 353 | * @param int $idpIdentifier the IdP identifier  | 
            ||
| 354 | * @param int $sort should the result set be sorted? 0 = no, 1 = yes  | 
            ||
| 355 | * @return string JSON encoded data  | 
            ||
| 356 | */  | 
            ||
| 357 |     public function JSON_listProfiles($idpIdentifier, $sort = 0) { | 
            ||
| 358 |         $this->languageInstance->setTextDomain("web_user"); | 
            ||
| 359 | $returnArray = [];  | 
            ||
| 360 |         try { | 
            ||
| 361 | $idp = new IdP($idpIdentifier);  | 
            ||
| 362 |         } catch (\Exception $fail) { | 
            ||
| 363 | echo $this->return_json($returnArray, 0);  | 
            ||
| 364 | return;  | 
            ||
| 365 | }  | 
            ||
| 366 | $hasLogo = FALSE;  | 
            ||
| 367 |         $logo = $idp->getAttributes('general:logo_file'); | 
            ||
| 368 |         if (count($logo) > 0) { | 
            ||
| 369 | $hasLogo = 1;  | 
            ||
| 370 | }  | 
            ||
| 371 | $profiles = $idp->listProfiles(TRUE);  | 
            ||
| 372 |         if ($sort == 1) { | 
            ||
| 373 | usort($profiles, ["UserAPI", "profile_sort"]);  | 
            ||
| 374 | }  | 
            ||
| 375 |         foreach ($profiles as $profile) { | 
            ||
| 376 | $returnArray[] = ['profile' => $profile->identifier, 'display' => $profile->name, 'idp_name' => $profile->instName, 'logo' => $hasLogo];  | 
            ||
| 377 | }  | 
            ||
| 378 | echo $this->return_json($returnArray);  | 
            ||
| 379 | }  | 
            ||
| 380 | |||
| 381 | /**  | 
            ||
| 382 | * Return the list of devices available for the given profile  | 
            ||
| 383 | *  | 
            ||
| 384 | * @param int $profileId the Profile identifier  | 
            ||
| 385 | * @return string JSON encoded data  | 
            ||
| 386 | */  | 
            ||
| 387 |     public function JSON_listDevices($profileId) { | 
            ||
| 388 |         $this->languageInstance->setTextDomain("web_user"); | 
            ||
| 389 | $returnArray = [];  | 
            ||
| 390 | $profileAttributes = $this->profileAttributes($profileId);  | 
            ||
| 391 | $thedevices = $profileAttributes['devices'];  | 
            ||
| 392 |         if (!isset($profile_redirect) || !$profile_redirect) { | 
            ||
| 393 | $profile_redirect = 0;  | 
            ||
| 394 |             foreach ($thedevices as $D) { | 
            ||
| 395 |                 if (isset($D['options']) && isset($D['options']['hidden']) && $D['options']['hidden']) { | 
            ||
| 396 | continue;  | 
            ||
| 397 | }  | 
            ||
| 398 | $disp = $D['display'];  | 
            ||
| 399 |                 if ($D['device'] === '0') { | 
            ||
| 400 | $profile_redirect = 1;  | 
            ||
| 401 | $disp = $c;  | 
            ||
| 402 | }  | 
            ||
| 403 | $returnArray[] = ['device' => $D['id'], 'display' => $disp, 'status' => $D['status'], 'redirect' => $D['redirect']];  | 
            ||
| 404 | }  | 
            ||
| 405 | }  | 
            ||
| 406 | echo $this->return_json($returnArray);  | 
            ||
| 407 | }  | 
            ||
| 408 | |||
| 409 | /**  | 
            ||
| 410 | * Call installer generation and return the link  | 
            ||
| 411 | *  | 
            ||
| 412 |      * @param string $device identifier as in {@link devices.php} | 
            ||
| 413 | * @param int $prof_id profile identifier  | 
            ||
| 414 | * @return string JSON encoded data  | 
            ||
| 415 | */  | 
            ||
| 416 |     public function JSON_generateInstaller($device, $prof_id) { | 
            ||
| 425 | |||
| 426 | /**  | 
            ||
| 427 | * Generate and send the installer  | 
            ||
| 428 | *  | 
            ||
| 429 |      * @param string $device identifier as in {@link devices.php} | 
            ||
| 430 | * @param int $prof_id profile identifier  | 
            ||
| 431 | * @return binary installerFile  | 
            ||
| 432 | */  | 
            ||
| 433 |     public function downloadInstaller($device, $prof_id, $generated_for = 'user', $token = NULL, $password = NULL) { | 
            ||
| 434 | $this->loggerInstance->debug(4, "downloadInstaller arguments: $device,$prof_id,$generated_for\n");  | 
            ||
| 435 | $output = $this->generateInstaller($device, $prof_id, $generated_for, $token, $password);  | 
            ||
| 436 | $this->loggerInstance->debug(4, "output from GUI::generateInstaller:");  | 
            ||
| 437 | $this->loggerInstance->debug(4, print_r($output, true));  | 
            ||
| 438 |         if (!$output['link']) { | 
            ||
| 439 |             header("HTTP/1.0 404 Not Found"); | 
            ||
| 440 | return;  | 
            ||
| 441 | }  | 
            ||
| 442 | $validator = new \web\lib\common\InputValidation();  | 
            ||
| 443 | $profile = $validator->Profile($prof_id);  | 
            ||
| 444 | $profile->incrementDownloadStats($device, $generated_for);  | 
            ||
| 445 | $file = $this->installerPath;  | 
            ||
| 446 | $filetype = $output['mime'];  | 
            ||
| 447 | $this->loggerInstance->debug(4, "installer MIME type:$filetype\n");  | 
            ||
| 448 |         header("Content-type: " . $filetype); | 
            ||
| 449 |         header('Content-Disposition: inline; filename="' . basename($file) . '"'); | 
            ||
| 450 |         header('Content-Length: ' . filesize($file)); | 
            ||
| 451 | ob_clean();  | 
            ||
| 452 | flush();  | 
            ||
| 453 | readfile($file);  | 
            ||
| 454 | }  | 
            ||
| 455 | |||
| 456 |     private function processImage($inputImage, $destFile, $width, $height, $resize) { | 
            ||
| 475 | |||
| 476 | /**  | 
            ||
| 477 | * Get and prepare logo file  | 
            ||
| 478 | *  | 
            ||
| 479 | * When called for DiscoJuice, first check if file cache exists  | 
            ||
| 480 | * If not then generate the file and save it in the cache  | 
            ||
| 481 | * @param int $idp IdP identifier  | 
            ||
| 482 | * @param int $disco flag turning on image generation for DiscoJuice  | 
            ||
| 483 | * @param int $width maximum width of the generated image  | 
            ||
| 484 | * @param int $height maximum height of the generated image  | 
            ||
| 485 | * if one of these is 0 then it is treated as no upper bound  | 
            ||
| 486 | *  | 
            ||
| 487 | */  | 
            ||
| 488 | |||
| 489 | View Code Duplication |         public function getIdpLogo($idp, $width = 0, $height = 0) { | 
            |
| 490 | $expiresString = '';  | 
            ||
| 491 | $resize = 0;  | 
            ||
| 492 | $logoFile = "";  | 
            ||
| 493 | $validator = new \web\lib\common\InputValidation();  | 
            ||
| 494 | $idpInstance = $validator->IdP($idp);  | 
            ||
| 495 | $filetype = 'image/png'; // default, only one code path where it can become different  | 
            ||
| 496 |         if (($width || $height) && is_numeric($width) && is_numeric($height)) { | 
            ||
| 497 | $resize = 1;  | 
            ||
| 498 |             if ($height == 0) { | 
            ||
| 499 | $height = 10000;  | 
            ||
| 500 | }  | 
            ||
| 501 |             if ($width == 0) { | 
            ||
| 502 | $width = 10000;  | 
            ||
| 503 | }  | 
            ||
| 504 | $logoFile = ROOT . '/web/downloads/logos/' . $idp . '_' . $width . '_' . $height . '.png';  | 
            ||
| 505 | }  | 
            ||
| 506 |         if ($resize && is_file($logoFile)) { | 
            ||
| 507 | $this->loggerInstance->debug(4, "Using cached logo $logoFile for: " . $idp . "\n");  | 
            ||
| 508 | $blob = file_get_contents($logoFile);  | 
            ||
| 509 |         } else { | 
            ||
| 510 |             $logoAttribute = $idpInstance->getAttributes('general:logo_file'); | 
            ||
| 511 |             if (count($logoAttribute) == 0) { | 
            ||
| 512 | return;  | 
            ||
| 513 | }  | 
            ||
| 514 | $meta = $this->processImage($logoAttribute[0]['value'], $logoFile, $width, $height, $resize);  | 
            ||
| 515 | $filetype = $meta['filetype'];  | 
            ||
| 516 | $expiresString = $meta['expires'];  | 
            ||
| 517 | $blob = $meta['blob'];  | 
            ||
| 518 | }  | 
            ||
| 519 | return ["filetype" => $filetype, "expires" => $expiresString, "blob" => $blob];  | 
            ||
| 520 | }  | 
            ||
| 521 | |||
| 522 | /**  | 
            ||
| 523 | * Get and prepare logo file  | 
            ||
| 524 | *  | 
            ||
| 525 | * When called for DiscoJuice, first check if file cache exists  | 
            ||
| 526 | * If not then generate the file and save it in the cache  | 
            ||
| 527 | * @param string $fedIdentifier federation identifier  | 
            ||
| 528 | * @param int $width maximum width of the generated image  | 
            ||
| 529 | * @param int $height maximum height of the generated image  | 
            ||
| 530 | * if one of these is 0 then it is treated as no upper bound  | 
            ||
| 531 | *  | 
            ||
| 532 | */  | 
            ||
| 533 | View Code Duplication |     public function getFedLogo($fedIdentifier, $width = 0, $height = 0) { | 
            |
| 534 | $expiresString = '';  | 
            ||
| 535 | $resize = 0;  | 
            ||
| 536 | $logoFile = "";  | 
            ||
| 537 | $validator = new \web\lib\common\InputValidation();  | 
            ||
| 538 | $federation = $validator->Federation($fedIdentifier);  | 
            ||
| 539 |         if (($width || $height) && is_numeric($width) && is_numeric($height)) { | 
            ||
| 540 | $resize = 1;  | 
            ||
| 541 |             if ($height == 0) { | 
            ||
| 542 | $height = 10000;  | 
            ||
| 543 | }  | 
            ||
| 544 |             if ($width == 0) { | 
            ||
| 545 | $width = 10000;  | 
            ||
| 546 | }  | 
            ||
| 547 | $logoFile = ROOT . '/web/downloads/logos/' . $fedIdenifier . '_' . $width . '_' . $height . '.png';  | 
            ||
| 548 | }  | 
            ||
| 549 |         if ($resize && is_file($logoFile)) { | 
            ||
| 550 | $this->loggerInstance->debug(4, "Using cached logo $logoFile for: " . $fedIdentifier . "\n");  | 
            ||
| 551 | $blob = file_get_contents($logoFile);  | 
            ||
| 552 | $filetype = 'image/png';  | 
            ||
| 553 |         } else { | 
            ||
| 554 |             $logoAttribute = $federation->getAttributes('fed:logo_file'); | 
            ||
| 555 |             if (count($logoAttribute) == 0) { | 
            ||
| 556 | return;  | 
            ||
| 557 | }  | 
            ||
| 558 | $meta = $this->processImage($logoAttribute[0]['value'], $logoFile, $width, $height, $resize);  | 
            ||
| 559 | $filetype = $meta['filetype'];  | 
            ||
| 560 | $expiresString = $meta['expires'];  | 
            ||
| 561 | $blob = $meta['blob'];  | 
            ||
| 562 | }  | 
            ||
| 563 | return ["filetype" => $filetype, "expires" => $expiresString, "blob" => $blob];  | 
            ||
| 564 | }  | 
            ||
| 565 | |||
| 566 | |||
| 567 |     public function sendLogo($identifier, $type, $width = 0, $height = 0){ | 
            ||
| 568 |         if ($type === "federation") { | 
            ||
| 569 | $logo = $this->getFedLogo($identifier, $width, $height);  | 
            ||
| 570 | }  | 
            ||
| 571 |         if ($type === "idp") { | 
            ||
| 572 | $logo = $this->getIdpLogo($identifier, $width, $height);  | 
            ||
| 573 | }  | 
            ||
| 574 |         header("Content-type: " . $logo['filetype']); | 
            ||
| 575 |         header("Cache-Control:max-age=36000, must-revalidate"); | 
            ||
| 576 | header($logo['expires']);  | 
            ||
| 577 | echo $logo['blob'];  | 
            ||
| 578 | }  | 
            ||
| 579 | |||
| 580 |     public function locateUser() { | 
            ||
| 581 | View Code Duplication |         if (CONFIG['GEOIP']['version'] != 1) { | 
            |
| 582 | return ['status' => 'error', 'error' => 'Function for GEOIPv1 called, but config says this is not the version to use!'];  | 
            ||
| 583 | }  | 
            ||
| 584 | //$host = $_SERVER['REMOTE_ADDR'];  | 
            ||
| 585 | $host = input_filter(INPUT_SERVER,'REMOTE_ADDR',FILTER_VALIDATE_IP);  | 
            ||
| 586 | $record = geoip_record_by_name($host);  | 
            ||
| 587 |         if ($record === FALSE) { | 
            ||
| 588 | return ['status' => 'error', 'error' => 'Problem listing countries'];  | 
            ||
| 589 | }  | 
            ||
| 590 | $result = ['status' => 'ok'];  | 
            ||
| 591 | $result['country'] = $record['country_code'];  | 
            ||
| 592 | // the two lines below are a dirty hack to take of the error in naming the UK federation  | 
            ||
| 593 |         if ($result['country'] == 'GB') { | 
            ||
| 594 | $result['country'] = 'UK';  | 
            ||
| 595 | }  | 
            ||
| 596 | $result['region'] = $record['region'];  | 
            ||
| 597 | $result['geo'] = ['lat' => (float) $record['latitude'], 'lon' => (float) $record['longitude']];  | 
            ||
| 598 | return($result);  | 
            ||
| 599 | }  | 
            ||
| 600 | |||
| 601 |     public function locateUser2() { | 
            ||
| 625 | |||
| 626 |     public function JSON_locateUser() { | 
            ||
| 645 | |||
| 646 | /**  | 
            ||
| 647 |      * Produce support data prepared within {@link GUI::profileAttributes()} | 
            ||
| 648 | * @return string JSON encoded data  | 
            ||
| 649 | */  | 
            ||
| 650 |     public function JSON_profileAttributes($prof_id) { | 
            ||
| 654 | |||
| 655 | /**  | 
            ||
| 656 | * Calculate the distence in km between two points given their  | 
            ||
| 657 | * geo coordinates.  | 
            ||
| 658 | * @param array $point1 - first point as an 'lat', 'lon' array  | 
            ||
| 659 | * @param array $profile1 - second point as an 'lat', 'lon' array  | 
            ||
| 660 | * @return float distance in km  | 
            ||
| 661 | */  | 
            ||
| 662 |     private function geoDistance($point1, $profile1) { | 
            ||
| 669 | |||
| 670 | /**  | 
            ||
| 671 | * Order active identity providers according to their distance and name  | 
            ||
| 672 | * @param array $currentLocation - current location  | 
            ||
| 673 |      * @return array $IdPs -  list of arrays ('id', 'name'); | 
            ||
| 674 | */  | 
            ||
| 675 |     public function orderIdentityProviders($country, $currentLocation = NULL) { | 
            ||
| 676 | $idps = $this->listAllIdentityProviders(1, $country);  | 
            ||
| 677 | |||
| 678 |         if (is_null($currentLocation)) { | 
            ||
| 679 | $currentLocation = ['lat' => "90", 'lon' => "0"];  | 
            ||
| 680 | $userLocation = $this->locateUser();  | 
            ||
| 681 |             if ($userLocation['status'] == 'ok') { | 
            ||
| 682 | $currentLocation = $userLocation['geo'];  | 
            ||
| 683 | }  | 
            ||
| 684 | }  | 
            ||
| 685 | $idpTitle = [];  | 
            ||
| 686 | $resultSet = [];  | 
            ||
| 687 |         foreach ($idps as $idp) { | 
            ||
| 688 | $idpTitle[$idp['entityID']] = $idp['title'];  | 
            ||
| 689 | $dist = 10000;  | 
            ||
| 690 |             if (isset($idp['geo'])) { | 
            ||
| 691 | $G = $idp['geo'];  | 
            ||
| 692 |                 if (isset($G['lon'])) { | 
            ||
| 693 | $d1 = $this->geoDistance($currentLocation, $G);  | 
            ||
| 694 |                     if ($d1 < $dist) { | 
            ||
| 695 | $dist = $d1;  | 
            ||
| 696 | }  | 
            ||
| 697 |                 } else { | 
            ||
| 698 |                     foreach ($G as $g) { | 
            ||
| 699 | $d1 = $this->geoDistance($currentLocation, $g);  | 
            ||
| 700 |                         if ($d1 < $dist) { | 
            ||
| 701 | $dist = $d1;  | 
            ||
| 702 | }  | 
            ||
| 703 | }  | 
            ||
| 704 | }  | 
            ||
| 705 | }  | 
            ||
| 706 |             if ($dist > 100) { | 
            ||
| 707 | $dist = 10000;  | 
            ||
| 708 | }  | 
            ||
| 709 |             $d = sprintf("%06d", $dist); | 
            ||
| 710 | $resultSet[$idp['entityID']] = $d . " " . $idp['title'];  | 
            ||
| 711 | }  | 
            ||
| 712 | asort($resultSet);  | 
            ||
| 713 | $outarray = [];  | 
            ||
| 714 |         foreach (array_keys($resultSet) as $r) { | 
            ||
| 715 | $outarray[] = ['idp' => $r, 'title' => $idpTitle[$r]];  | 
            ||
| 716 | }  | 
            ||
| 717 | return($outarray);  | 
            ||
| 718 | }  | 
            ||
| 719 | |||
| 720 | /**  | 
            ||
| 721 | * Detect the best device driver form the browser  | 
            ||
| 722 | *  | 
            ||
| 723 | * Detects the operating system and returns its id  | 
            ||
| 724 | * display name and group membership (as in devices.php)  | 
            ||
| 725 | * @return array indexed by 'id', 'display', 'group'  | 
            ||
| 726 | */  | 
            ||
| 727 |     public function detectOS() { | 
            ||
| 728 |         $oldDomain = $this->languageInstance->setTextDomain("devices"); | 
            ||
| 729 | $Dev = \devices\Devices::listDevices();  | 
            ||
| 730 | $this->languageInstance->setTextDomain($oldDomain);  | 
            ||
| 731 |         if (isset($_REQUEST['device']) && isset($Dev[$_REQUEST['device']]) && (!isset($device['options']['hidden']) || $device['options']['hidden'] == 0)) { | 
            ||
| 732 | $dev_id = $_REQUEST['device'];  | 
            ||
| 733 | $device = $Dev[$dev_id];  | 
            ||
| 734 | return(['device' => $dev_id, 'display' => $device['display'], 'group' => $device['group']]);  | 
            ||
| 735 | }  | 
            ||
| 736 | $browser = $_SERVER['HTTP_USER_AGENT'];  | 
            ||
| 737 | $this->loggerInstance->debug(4, "HTTP_USER_AGENT=$browser\n");  | 
            ||
| 738 |         foreach ($Dev as $dev_id => $device) { | 
            ||
| 739 |             if (!isset($device['match'])) { | 
            ||
| 740 | continue;  | 
            ||
| 741 | }  | 
            ||
| 742 |             if (preg_match('/' . $device['match'] . '/', $browser)) { | 
            ||
| 743 |                 if (!isset($device['options']['hidden']) || $device['options']['hidden'] == 0) { | 
            ||
| 744 | $this->loggerInstance->debug(4, "Browser_id: $dev_id\n");  | 
            ||
| 745 | return(['device' => $dev_id, 'display' => $device['display'], 'group' => $device['group']]);  | 
            ||
| 746 |                 } else { | 
            ||
| 747 | $this->loggerInstance->debug(2, "Unrecognised system: " . filter_input(INPUT_SERVER,'HTTP_USER_AGENT', FILTER_SANITIZE_STRING) . "\n");  | 
            ||
| 748 | return(false);  | 
            ||
| 749 | }  | 
            ||
| 750 | }  | 
            ||
| 751 | }  | 
            ||
| 752 | $this->loggerInstance->debug(2, "Unrecognised system: " . filter_input(INPUT_SERVER,'HTTP_USER_AGENT', FILTER_SANITIZE_STRING) . "\n");  | 
            ||
| 753 | return(false);  | 
            ||
| 754 | }  | 
            ||
| 755 | |||
| 756 |     public function JSON_detectOS() { | 
            ||
| 765 | |||
| 766 |     public function getUserCerts($token) { | 
            ||
| 767 | $validator = new \web\lib\common\InputValidation();  | 
            ||
| 768 | $cleanToken = $validator->token($token);  | 
            ||
| 769 |         if ($cleanToken) { | 
            ||
| 770 | // check status of this silverbullet token according to info in DB:  | 
            ||
| 771 | // it can be VALID (exists and not redeemed, EXPIRED, REDEEMED or INVALID (non existent)  | 
            ||
| 772 | $tokenStatus = \core\ProfileSilverbullet::tokenStatus($cleanToken);  | 
            ||
| 773 |         } else { | 
            ||
| 774 | return false;  | 
            ||
| 775 | }  | 
            ||
| 776 | $profile = new \core\ProfileSilverbullet($tokenStatus['profile'], NULL);  | 
            ||
| 777 | $userdata = $profile->userStatus($tokenStatus['user']);  | 
            ||
| 778 | $allcerts = [];  | 
            ||
| 779 |         foreach ($userdata as $index => $content) { | 
            ||
| 780 | $allcerts = array_merge($allcerts, $content['cert_status']);  | 
            ||
| 781 | }  | 
            ||
| 782 | return $allcerts;  | 
            ||
| 783 | }  | 
            ||
| 784 | |||
| 785 |     public function JSON_getUserCerts($token) { | 
            ||
| 786 | $returnArray = $this->getUserCerts($token);  | 
            ||
| 794 | |||
| 795 | public $device;  | 
            ||
| 796 | private $installerPath;  | 
            ||
| 797 | |||
| 798 |     private static function profile_sort($profile1, $profile2) { | 
            ||
| 801 | |||
| 802 | }  | 
            ||
| 803 | 
This check marks access to variables or properties that have not been declared yet. While PHP has no explicit notion of declaring a variable, accessing it before a value is assigned to it is most likely a bug.