]> git.mxchange.org Git - friendica.git/blob - src/Worker/UpdateContact.php
spelling: effectiveness
[friendica.git] / src / Worker / UpdateContact.php
1 <?php
2 /**
3  * @copyright Copyright (C) 2010-2023, the Friendica project
4  *
5  * @license GNU AGPL version 3 or any later version
6  *
7  * This program is free software: you can redistribute it and/or modify
8  * it under the terms of the GNU Affero General Public License as
9  * published by the Free Software Foundation, either version 3 of the
10  * License, or (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU Affero General Public License for more details.
16  *
17  * You should have received a copy of the GNU Affero General Public License
18  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
19  *
20  */
21
22 namespace Friendica\Worker;
23
24 use Friendica\Core\Logger;
25 use Friendica\Core\Worker;
26 use Friendica\Model\Contact;
27 use Friendica\Network\HTTPException\InternalServerErrorException;
28 use Friendica\Util\Network;
29
30 class UpdateContact
31 {
32         /**
33          * Update contact data via probe
34          *
35          * @param int $contact_id Contact ID
36          * @return void
37          * @throws InternalServerErrorException
38          * @throws \ImagickException
39          */
40         public static function execute(int $contact_id)
41         {
42                 // Silently dropping the task if the contact is blocked
43                 if (Contact::isBlocked($contact_id)) {
44                         return;
45                 }
46
47                 $success = Contact::updateFromProbe($contact_id);
48
49                 Logger::info('Updated from probe', ['id' => $contact_id, 'success' => $success]);
50         }
51
52         /**
53          * @param array|int $run_parameters Priority constant or array of options described in Worker::add
54          * @param int       $contact_id
55          * @return int
56          * @throws InternalServerErrorException
57          */
58         public static function add($run_parameters, int $contact_id): int
59         {
60                 if (!$contact_id) {
61                         throw new \InvalidArgumentException('Invalid value provided for contact_id');
62                 }
63
64                 // Dropping the task if the contact is blocked
65                 if (Contact::isBlocked($contact_id)) {
66                         return 0;
67                 }
68
69                 return Worker::add($run_parameters, 'UpdateContact', $contact_id);
70         }
71 }