MediaWiki找不到localsettings.php文件及相关配置升级求助

先找到LocalSettings.php文件 #

你是通过Softalicious安装的MediaWiki，托管在GreenGeeks，找文件的步骤：

• 登录GreenGeeks控制面板，打开文件管理器
• 定位到网站根目录（一般是public_html，如果是子域名/子目录安装，就找对应文件夹）
• MediaWiki的根目录里直接就能找到LocalSettings.php，要是没看到，在文件管理器的设置里开启「显示隐藏文件」选项（有些主机默认隐藏配置文件）
• 不用找commonsettings，Softalicious安装的MediaWiki核心配置都在LocalSettings.php里

一、更换站点Logo #

打开LocalSettings.php，添加或修改以下代码：

# 自定义站点Logo
$wgLogo = "$wgResourceBasePath/resources/assets/my-custom-logo.png";
# 如果你是把Logo上传到了MediaWiki的上传目录，也可以这么写：
# $wgLogo = "$wgUploadPath/your-logo-file.png";

注意：把路径换成你实际上传的Logo路径，建议尺寸控制在135×135像素左右，适配MediaWiki的布局

二、设置外部链接在新标签页打开 #

在LocalSettings.php的末尾添加这段代码：

# 让所有外部链接在新标签页打开
$wgExternalLinkTarget = '_blank';

保存文件后刷新站点，外部链接就会自动在新标签页打开了

三、添加PhpSpreadsheet库 #

1. 下载PhpSpreadsheet的稳定版压缩包，解压得到phpspreadsheet文件夹
2. 通过GreenGeeks文件管理器，把这个文件夹上传到MediaWiki的extensions目录（如果站点根目录下有vendor目录，也可以放进去）
3. 打开LocalSettings.php，添加加载代码：

# 加载PhpSpreadsheet库
require_once "$IP/extensions/phpspreadsheet/src/PhpSpreadsheet/Autoloader.php";

如果后续是要配合某个扩展使用，记得确认扩展的集成要求，调整路径即可

四、解决MediaWiki升级失败问题 #

1. 检查PHP版本：新版MediaWiki对PHP版本有要求（比如至少7.4+），登录GreenGeeks控制面板，找到PHP版本管理，切换到符合要求的版本
2. 核对文件权限：MediaWiki的文件权限设为644，目录权限设为755，在文件管理器里可以批量修改
3. 用Softalicious一键升级：回到Softalicious的应用管理页面，找到你的MediaWiki站点，点击「升级」按钮，看是否有具体报错提示
4. 手动升级（备份后操作）：
   • 先备份整个站点的文件和数据库（GreenGeeks控制面板有备份工具）
   • 下载目标版本的MediaWiki压缩包，解压后替换掉站点里除了LocalSettings.php、images目录、extensions目录之外的所有文件
   • 通过GreenGeeks的终端工具，执行php update.php完成数据库更新
5. 排查扩展冲突：先禁用所有第三方扩展，再尝试升级，排除扩展不兼容导致的失败

额外运维建议 #

• 定期备份：开启GreenGeeks的自动备份，同时每月手动备份一次文件和数据库，防止数据丢失
• 精简扩展：只安装官方维护、口碑好的必要扩展，定期更新扩展，避免安全漏洞
• 开启缓存：在LocalSettings.php里添加$wgMainCacheType = CACHE_ACCEL;，提升站点加载速度
• 权限管控：根据协作需求给用户分配对应组的权限，比如普通编辑者只给编辑权限，管理员负责站点设置
• 安全配置：开启邮箱功能（$wgEnableEmail = true;、$wgEnableUserEmail = true;），方便用户找回密码；设置强密码策略（$wgPasswordPolicy）提升账号安全

内容的提问来源于stack exchange，提问作者phillip carter