mirror of
https://github.com/nextcloud/server.git
synced 2025-02-07 18:09:45 +00:00
122 lines
3.6 KiB
PHP
122 lines
3.6 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* @copyright Copyright (c) 2023 Côme Chilliet <come.chilliet@nextcloud.com>
|
|
*
|
|
* @author Côme Chilliet <come.chilliet@nextcloud.com>
|
|
*
|
|
* @license GNU AGPL version 3 or any later version
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as
|
|
* published by the Free Software Foundation, either version 3 of the
|
|
* License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Affero General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
namespace OCA\Settings\SetupChecks;
|
|
|
|
use OCP\IL10N;
|
|
use OCP\IURLGenerator;
|
|
use OCP\SetupCheck\ISetupCheck;
|
|
use OCP\SetupCheck\SetupResult;
|
|
|
|
class PhpModules implements ISetupCheck {
|
|
protected const REQUIRED_MODULES = [
|
|
'ctype',
|
|
'curl',
|
|
'dom',
|
|
'fileinfo',
|
|
'gd',
|
|
'json',
|
|
'mbstring',
|
|
'openssl',
|
|
'posix',
|
|
'session',
|
|
'xml',
|
|
'xmlreader',
|
|
'xmlwriter',
|
|
'zip',
|
|
'zlib',
|
|
];
|
|
protected const RECOMMENDED_MODULES = [
|
|
'bcmath',
|
|
'exif',
|
|
'gmp',
|
|
'intl',
|
|
'sodium',
|
|
'sysvsem',
|
|
];
|
|
|
|
public function __construct(
|
|
private IL10N $l10n,
|
|
private IURLGenerator $urlGenerator,
|
|
) {
|
|
}
|
|
|
|
public function getName(): string {
|
|
return $this->l10n->t('PHP modules');
|
|
}
|
|
|
|
public function getCategory(): string {
|
|
return 'php';
|
|
}
|
|
|
|
protected function getRecommendedModuleDescription(string $module): string {
|
|
return match($module) {
|
|
'intl' => $this->l10n->t('increases language translation performance and fixes sorting of non-ASCII characters'),
|
|
'sodium' => $this->l10n->t('for Argon2 for password hashing'),
|
|
'bcmath' => $this->l10n->t('for WebAuthn passwordless login'),
|
|
'gmp' => $this->l10n->t('for WebAuthn passwordless login, and SFTP storage'),
|
|
'exif' => $this->l10n->t('for picture rotation in server and metadata extraction in the Photos app'),
|
|
default => '',
|
|
};
|
|
}
|
|
|
|
public function run(): SetupResult {
|
|
$missingRecommendedModules = $this->getMissingModules(self::RECOMMENDED_MODULES);
|
|
$missingRequiredModules = $this->getMissingModules(self::REQUIRED_MODULES);
|
|
if (!empty($missingRequiredModules)) {
|
|
return SetupResult::error(
|
|
$this->l10n->t('This instance is missing some required PHP modules. It is required to install them: %s.', implode(', ', $missingRequiredModules)),
|
|
$this->urlGenerator->linkToDocs('admin-php-modules')
|
|
);
|
|
} elseif (!empty($missingRecommendedModules)) {
|
|
$moduleList = implode(
|
|
"\n",
|
|
array_map(
|
|
fn (string $module) => '- '.$module.' '.$this->getRecommendedModuleDescription($module),
|
|
$missingRecommendedModules
|
|
)
|
|
);
|
|
return SetupResult::info(
|
|
$this->l10n->t("This instance is missing some recommended PHP modules. For improved performance and better compatibility it is highly recommended to install them:\n%s", $moduleList),
|
|
$this->urlGenerator->linkToDocs('admin-php-modules')
|
|
);
|
|
} else {
|
|
return SetupResult::success();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks for potential PHP modules that would improve the instance
|
|
*
|
|
* @param string[] $modules modules to test
|
|
* @return string[] A list of PHP modules which are missing
|
|
*/
|
|
protected function getMissingModules(array $modules): array {
|
|
return array_values(array_filter(
|
|
$modules,
|
|
fn (string $module) => !extension_loaded($module),
|
|
));
|
|
}
|
|
}
|