如何在后台管理面板读取、修改并保存settings.ini文件配置

核心思路 #

直接通过文件读写操作，先将ini文件内容解析为可操作的数据结构，在后台面板渲染表单供用户修改，提交后重新生成符合格式的ini内容并写入文件，完成同步更新。

以PHP为例的实现代码 #

1. 读取配置并渲染表单

// 读取settings.ini，返回关联数组
$settings = parse_ini_file('settings.ini');
?>

<!-- 后台配置表单 -->
<form method="post" action="">
    <div>
        <label>站点名称：</label>
        <input type="text" name="siteName" value="<?php echo htmlspecialchars($settings['siteName']); ?>" required>
    </div>
    <div>
        <label>站点描述：</label>
        <textarea name="sideDesc" required><?php echo htmlspecialchars($settings['sideDesc']); ?></textarea>
    </div>
    <button type="submit">保存配置</button>
</form>

2. 处理表单提交并保存配置

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // 过滤用户输入，避免恶意内容
    $siteName = trim($_POST['siteName']);
    $sideDesc = trim($_POST['sideDesc']);
    
    // 生成标准ini格式内容
    $iniContent = "siteName=$siteName\nsideDesc=$sideDesc\n";
    
    // 写入文件，需确保文件有可写权限
    if (file_put_contents('settings.ini', $iniContent)) {
        echo "配置保存成功";
    } else {
        echo "保存失败，请检查文件权限";
    }
}

以Python（Flask框架）为例的实现代码 #

1. 读取配置并渲染模板

import configparser
from flask import Flask, render_template, request, redirect

app = Flask(__name__)

@app.route('/settings', methods=['GET'])
def show_settings():
    config = configparser.ConfigParser()
    config.optionxform = str  # 保留配置键的大小写
    config.read('settings.ini')
    
    # 读取无section的配置项
    site_name = config.get('', 'siteName')
    side_desc = config.get('', 'sideDesc')
    
    return render_template('settings.html', site_name=site_name, side_desc=side_desc)

2. 处理提交并保存配置

@app.route('/settings', methods=['POST'])
def save_settings():
    config = configparser.ConfigParser()
    config.optionxform = str
    config.read('settings.ini')
    
    # 获取并过滤用户输入
    site_name = request.form.get('siteName', '').strip()
    side_desc = request.form.get('sideDesc', '').strip()
    
    # 更新配置项
    config.set('', 'siteName', site_name)
    config.set('', 'sideDesc', side_desc)
    
    # 写入文件
    try:
        with open('settings.ini', 'w') as f:
            config.write(f)
        return redirect('/settings')
    except Exception as e:
        return f"保存失败：{str(e)}"

对应的settings.html模板片段：

<form method="post">
    <div>
        <label>站点名称：</label>
        <input type="text" name="siteName" value="{{ site_name }}" required>
    </div>
    <div>
        <label>站点描述：</label>
        <textarea name="sideDesc" required>{{ side_desc }}</textarea>
    </div>
    <button type="submit">保存配置</button>
</form>

关键注意事项 #

• 文件权限：确保运行后台服务的进程（如PHP的www-data、Python的进程用户）拥有settings.ini文件的读写权限，否则会导致保存失败。
• 输入过滤：对用户提交的内容做 trim、html转义等处理，防止注入恶意换行或特殊字符破坏ini文件格式。
• 备份机制：可以在写入文件前复制原文件作为备份，避免意外操作导致配置丢失。

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