.
*/
declare(strict_types=1);
namespace Fisharebest\Webtrees\Services;
use Fisharebest\Webtrees\I18N;
use Illuminate\Database\Capsule\Manager as DB;
use Illuminate\Support\Collection;
use Illuminate\Support\Str;
use SQLite3;
use stdClass;
use Throwable;
use function array_map;
use function class_exists;
use function date;
use function e;
use function explode;
use function extension_loaded;
use function function_exists;
use function in_array;
use function preg_replace;
use function strpos;
use function strtolower;
use function sys_get_temp_dir;
use function trim;
use function version_compare;
use const PATH_SEPARATOR;
use const PHP_MAJOR_VERSION;
use const PHP_MINOR_VERSION;
use const PHP_VERSION;
/**
* Check if the server meets the minimum requirements for webtrees.
*/
class ServerCheckService
{
private const PHP_SUPPORT_URL = 'https://secure.php.net/supported-versions.php';
private const PHP_MINOR_VERSION = PHP_MAJOR_VERSION . '.' . PHP_MINOR_VERSION;
private const PHP_SUPPORT_DATES = [
'7.1' => '2019-12-01',
'7.2' => '2020-11-30',
'7.3' => '2021-12-06',
];
// As required by illuminate/database 5.8
private const MINIMUM_SQLITE_VERSION = '3.7.11';
/**
* Things that may cause webtrees to break.
*
* @param string $driver
*
* @return Collection
*/
public function serverErrors($driver = ''): Collection
{
$errors = Collection::make([
$this->databaseDriverErrors($driver),
$this->checkPhpExtension('mbstring'),
$this->checkPhpExtension('iconv'),
$this->checkPhpExtension('pcre'),
$this->checkPhpExtension('session'),
$this->checkPhpExtension('xml'),
$this->checkPhpFunction('parse_ini_file'),
]);
return $errors
->flatten()
->filter();
}
/**
* Things that should be fixed, but which won't stop completely webtrees from running.
*
* @param string $driver
*
* @return Collection
*/
public function serverWarnings($driver = ''): Collection
{
$warnings = Collection::make([
$this->databaseDriverWarnings($driver),
$this->databaseEngineWarnings(),
$this->checkPhpExtension('curl'),
$this->checkPhpExtension('gd'),
$this->checkPhpExtension('zip'),
$this->checkPhpExtension('simplexml'),
$this->checkPhpIni('file_uploads', true),
$this->checkSystemTemporaryFolder(),
$this->checkPhpVersion(),
]);
return $warnings
->flatten()
->filter();
}
/**
* Check if a PHP extension is loaded.
*
* @param string $extension
*
* @return string
*/
private function checkPhpExtension(string $extension): string
{
if (!extension_loaded($extension)) {
return I18N::translate('The PHP extension “%s” is not installed.', $extension);
}
return '';
}
/**
* Check if a PHP setting is correct.
*
* @param string $varname
* @param bool $expected
*
* @return string
*/
private function checkPhpIni(string $varname, bool $expected): string
{
$ini_get = (bool) ini_get($varname);
if ($expected && $ini_get !== $expected) {
return I18N::translate('The PHP.INI setting “%1$s” is disabled.', $varname);
}
if (!$expected && $ini_get !== $expected) {
return I18N::translate('The PHP.INI setting “%1$s” is enabled.', $varname);
}
return '';
}
/**
* Check if a PHP function is in the list of disabled functions.
*
* @param string $function
*
* @return bool
*/
public function isFunctionDisabled(string $function): bool
{
$disable_functions = explode(',', ini_get('disable_functions'));
$disable_functions = array_map(static function (string $func): string {
return strtolower(trim($func));
}, $disable_functions);
$function = strtolower($function);
return in_array($function, $disable_functions, true) || !function_exists($function);
}
/**
* Create a warning message for a disabled function.
*
* @param string $function
*
* @return string
*/
private function checkPhpFunction(string $function): string
{
if ($this->isFunctionDisabled($function)) {
return I18N::translate('The PHP function “%1$s” is disabled.', $function . '()');
}
return '';
}
/**
* Some servers configure their temporary folder in an unaccessible place.
*/
private function checkPhpVersion(): string
{
$today = date('Y-m-d');
foreach (self::PHP_SUPPORT_DATES as $version => $end_date) {
if ($today > $end_date && version_compare(self::PHP_MINOR_VERSION, $version) <= 0) {
return I18N::translate('Your web server is using PHP version %s, which is no longer receiving security updates. You should upgrade to a later version as soon as possible.', PHP_VERSION) . ' ' . e(self::PHP_SUPPORT_URL) . '';
}
}
return '';
}
/**
* Check the
*
* @return string
*/
private function checkSqliteVersion(): string
{
if (class_exists(SQLite3::class)) {
$sqlite_version = SQLite3::version()['versionString'];
if (version_compare($sqlite_version, self::MINIMUM_SQLITE_VERSION) < 0) {
return I18N::translate('SQLite version %s is installed. SQLite version %s or later is required.', $sqlite_version, self::MINIMUM_SQLITE_VERSION);
}
}
return '';
}
/**
* Some servers configure their temporary folder in an unaccessible place.
*/
private function checkSystemTemporaryFolder(): string
{
$open_basedir = ini_get('open_basedir');
if ($open_basedir === '') {
// open_basedir not used.
return '';
}
$open_basedirs = explode(PATH_SEPARATOR, $open_basedir);
$sys_temp_dir = sys_get_temp_dir();
$sys_temp_dir = $this->normalizeFolder($sys_temp_dir);
foreach ($open_basedirs as $dir) {
$dir = $this->normalizeFolder($dir);
if (strpos($sys_temp_dir, $dir) === 0) {
return '';
}
}
$message = I18N::translate('The server’s temporary folder cannot be accessed.');
$message .= '
sys_get_temp_dir() = "' . e($sys_temp_dir) . '"';
$message .= '
ini_get("open_basedir") = "' . e($open_basedir) . '"';
return $message;
}
/**
* Convert a folder name to a canonical form:
* - forward slashes.
* - trailing slash.
* We can't use realpath() as this can trigger open_basedir restrictions,
* and we are using this code to find out whether open_basedir will affect us.
*
* @param string $path
*
* @return string
*/
private function normalizeFolder(string $path): string
{
$path = preg_replace('/[\\/]+/', '/', $path);
$path = Str::finish($path, '/');
return $path;
}
/**
* @param string $driver
*
* @return Collection
*/
private function databaseDriverErrors(string $driver): Collection
{
switch ($driver) {
case 'mysql':
return Collection::make([
$this->checkPhpExtension('pdo'),
$this->checkPhpExtension('pdo_mysql'),
]);
case 'sqlite':
return Collection::make([
$this->checkPhpExtension('pdo'),
$this->checkPhpExtension('sqlite3'),
$this->checkPhpExtension('pdo_sqlite'),
$this->checkSqliteVersion(),
]);
case 'pgsql':
return Collection::make([
$this->checkPhpExtension('pdo'),
$this->checkPhpExtension('pdo_pgsql'),
]);
case 'sqlsvr':
return Collection::make([
$this->checkPhpExtension('pdo'),
$this->checkPhpExtension('pdo_odbc'),
]);
default:
return new Collection();
}
}
/**
* @param string $driver
*
* @return Collection
*/
private function databaseDriverWarnings(string $driver): Collection
{
switch ($driver) {
case 'sqlite':
return new Collection([
I18N::translate('SQLite is only suitable for small sites, testing and evaluation.'),
]);
case 'pgsql':
return new Collection([
I18N::translate('Support for PostgreSQL is experimental.'),
]);
case 'sqlsvr':
return new Collection([
I18N::translate('Support for SQL Server is experimental.'),
]);
default:
return new Collection();
}
}
/**
* @return Collection
*/
private function databaseEngineWarnings(): Collection
{
$warnings = new Collection();
try {
$connection = DB::connection();
} catch (Throwable $ex) {
// During setup, there won't be a connection.
return new Collection();
}
if ($connection->getDriverName() === 'mysql') {
$sql = "SELECT table_name FROM information_schema.tables JOIN information_schema.engines USING (engine) WHERE table_schema = ? AND LEFT(table_name, ?) = ? AND transactions <> 'YES'";
$bindings = [
$connection->getDatabaseName(),
mb_strlen($connection->getTablePrefix()),
$connection->getTablePrefix(),
];
$rows = DB::connection()->select($sql, $bindings);
$rows = new Collection($rows);
$rows = $rows->map(static function (stdClass $row): string {
$table = $row->TABLE_NAME ?? $row->table_name;
return 'ALTER TABLE `' . $table . '` ENGINE=InnoDB;
';
});
if ($rows->isNotEmpty()) {
$warning =
'The database uses non-transactional tables.' .
' ' .
'You may get errors if more than one user updates data at the same time.' .
' ' .
'To fix this, run the following SQL commands.' .
'
' .
$rows->implode('
');
$warnings->push($warning);
}
}
return $warnings;
}
}