d_s_bisht/devsofttech_hms_ci4
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add CLI filesystem setup script

Browse Source
This commit is contained in:
DevSoftTech Server 2026-04-15 06:25:12 +05:30
parent 85ce007b26
commit a0cfbfb5e0
1 changed files with 180 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

180
scripts/setup_fs_cli.php Normal file
View File

@ -0,0 +1,180 @@
<?php
declare(strict_types=1);
/**
* First-time filesystem setup for CI4 writable/public upload folders.
*
* Run:
* php scripts/setup_fs_cli.php
* php scripts/setup_fs_cli.php --owner=www-data --group=www-data
*
* Notes:
* - Best effort only; some operations may require sudo/root.
* - Safe to run multiple times.
*/
if (PHP_SAPI !== 'cli') {
fwrite(STDERR, "This script must be run from CLI.\n");
exit(1);
}
$projectRoot = dirname(__DIR__);
$dirs = [
$projectRoot . '/writable',
$projectRoot . '/writable/cache',
$projectRoot . '/writable/logs',
$projectRoot . '/writable/session',
$projectRoot . '/writable/uploads',
$projectRoot . '/writable/debugbar',
$projectRoot . '/writable/tmp',
$projectRoot . '/public/uploads',
];
$options = getopt('', ['owner::', 'group::', 'help']);
if (isset($options['help'])) {
echo "Usage:\n";
echo " php scripts/setup_fs_cli.php [--owner=www-data] [--group=www-data]\n\n";
echo "Examples:\n";
echo " php scripts/setup_fs_cli.php\n";
echo " sudo php scripts/setup_fs_cli.php --owner=www-data --group=www-data\n";
exit(0);
}
$owner = isset($options['owner']) && is_string($options['owner']) ? trim($options['owner']) : '';
$group = isset($options['group']) && is_string($options['group']) ? trim($options['group']) : '';
$created = [];
$failedCreate = [];
foreach ($dirs as $dir) {
if (!is_dir($dir)) {
if (@mkdir($dir, 0775, true)) {
$created[] = $dir;
} else {
$failedCreate[] = $dir;
}
}
}
$chmodDirFail = [];
$chmodFileFail = [];
$chownFail = [];
$chgrpFail = [];
$applyToTree = static function (string $root, callable $onDir, callable $onFile): void {
if (!is_dir($root)) {
return;
}
$onDir($root);
$it = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($root, FilesystemIterator::SKIP_DOTS),
RecursiveIteratorIterator::SELF_FIRST
);
foreach ($it as $item) {
$path = $item->getPathname();
if ($item->isDir()) {
$onDir($path);
} else {
$onFile($path);
}
}
};
foreach ($dirs as $dir) {
$applyToTree(
$dir,
static function (string $path) use (&$chmodDirFail, $owner, $group, &$chownFail, &$chgrpFail): void {
if (!@chmod($path, 0775)) {
$chmodDirFail[] = $path;
}
if ($owner !== '' && function_exists('chown') && !@chown($path, $owner)) {
$chownFail[] = $path;
}
if ($group !== '' && function_exists('chgrp') && !@chgrp($path, $group)) {
$chgrpFail[] = $path;
}
},
static function (string $path) use (&$chmodFileFail, $owner, $group, &$chownFail, &$chgrpFail): void {
if (!@chmod($path, 0664)) {
$chmodFileFail[] = $path;
}
if ($owner !== '' && function_exists('chown') && !@chown($path, $owner)) {
$chownFail[] = $path;
}
if ($group !== '' && function_exists('chgrp') && !@chgrp($path, $group)) {
$chgrpFail[] = $path;
}
}
);
}
$writableFail = [];
foreach ($dirs as $dir) {
if (!is_dir($dir)) {
$writableFail[] = $dir;
continue;
}
$probe = rtrim($dir, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . '.write_test_' . str_replace('.', '', uniqid('', true)) . '.tmp';
$ok = @file_put_contents($probe, 'ok');
if ($ok === false) {
$writableFail[] = $dir;
continue;
}
@unlink($probe);
}
echo "Setup filesystem report\n";
echo "Project root: {$projectRoot}\n";
echo "Created dirs: " . count($created) . "\n";
echo "Failed create: " . count($failedCreate) . "\n";
echo "chmod dir failures: " . count($chmodDirFail) . "\n";
echo "chmod file failures: " . count($chmodFileFail) . "\n";
echo "chown failures: " . count($chownFail) . "\n";
echo "chgrp failures: " . count($chgrpFail) . "\n";
echo "Writable failures: " . count($writableFail) . "\n\n";
if ($created !== []) {
echo "Created:\n";
foreach ($created as $path) {
echo " - {$path}\n";
}
echo "\n";
}
$printUnique = static function (string $title, array $items): void {
$items = array_values(array_unique($items));
if ($items === []) {
return;
}
echo $title . "\n";
foreach ($items as $path) {
echo " - {$path}\n";
}
echo "\n";
};
$printUnique('Failed to create:', $failedCreate);
$printUnique('Not writable:', $writableFail);
if ($failedCreate !== [] || $writableFail !== []) {
echo "Shell fallback (Linux):\n";
echo ' sudo mkdir -p "' . $projectRoot . '/writable/cache" "' . $projectRoot . '/writable/logs" "' . $projectRoot . '/writable/session" "' . $projectRoot . '/writable/uploads" "' . $projectRoot . '/writable/debugbar" "' . $projectRoot . '/writable/tmp" "' . $projectRoot . '/public/uploads"' . "\n";
echo ' sudo chown -R www-data:www-data "' . $projectRoot . '/writable" "' . $projectRoot . '/public/uploads"' . "\n";
echo ' sudo find "' . $projectRoot . '/writable" -type d -exec chmod 775 {} \;' . "\n";
echo ' sudo find "' . $projectRoot . '/writable" -type f -exec chmod 664 {} \;' . "\n";
echo ' sudo chmod -R 775 "' . $projectRoot . '/public/uploads"' . "\n";
exit(2);
}
echo "All required folders are ready and writable.\n";
exit(0);