Laravel 5.5项目：如何实现类WordPress配置并读写.env文件

Hey there! Let's walk through building that WordPress-style setup flow for your Laravel 5.5 app—we'll cover auto-saving database credentials to your .env file and the right ways to access those values afterward.

1. Set Up the Setup Route & Form #

First, create a route that serves your setup page (make sure this is only accessible if the app isn't already configured—you can check if .env exists or if DB credentials are set):

// routes/web.php
Route::get('/setup', 'SetupController@showForm')->name('setup.form');
Route::post('/setup', 'SetupController@processSetup')->name('setup.process');

Next, create a simple blade view (resources/views/setup.blade.php) with a form to collect database details:

<form method="POST" action="{{ route('setup.process') }}">
    @csrf
    <div>
        <label>Database Host:</label>
        <input type="text" name="db_host" value="localhost" required>
    </div>
    <div>
        <label>Database Name:</label>
        <input type="text" name="db_name" required>
    </div>
    <div>
        <label>Database Username:</label>
        <input type="text" name="db_username" required>
    </div>
    <div>
        <label>Database Password:</label>
        <input type="password" name="db_password">
    </div>
    <div>
        <label>Database Port:</label>
        <input type="text" name="db_port" value="3306" required>
    </div>
    <button type="submit">Complete Setup</button>
</form>

2. Process the Form & Update .env #

Create a SetupController to handle the form submission. The key here is to read your .env.example file (or the existing .env if it's empty), replace the placeholder values with user input, and save it as .env.

First, make sure your .env.example has the necessary DB placeholders:

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=
DB_USERNAME=
DB_PASSWORD=

Now, the controller method:

// app/Http/Controllers/SetupController.php
use Illuminate\Support\Facades\File;
use Illuminate\Support\Facades\Validator;
use Illuminate\Support\Facades\Artisan;

public function processSetup(Request $request)
{
    // Validate input
    $validator = Validator::make($request->all(), [
        'db_host' => 'required|string',
        'db_name' => 'required|string',
        'db_username' => 'required|string',
        'db_port' => 'required|numeric',
    ]);

    if ($validator->fails()) {
        return back()->withErrors($validator)->withInput();
    }

    // Get the .env.example content
    $envExampleContent = File::get(base_path('.env.example'));

    // Replace placeholders with user input
    $envContent = str_replace([
        'DB_HOST=localhost',
        'DB_PORT=3306',
        'DB_DATABASE=',
        'DB_USERNAME=',
        'DB_PASSWORD=',
    ], [
        'DB_HOST='.$request->db_host,
        'DB_PORT='.$request->db_port,
        'DB_DATABASE='.$request->db_name,
        'DB_USERNAME='.$request->db_username,
        'DB_PASSWORD='.$request->db_password,
    ], $envExampleContent);

    // Save to .env file
    File::put(base_path('.env'), $envContent);

    // Clear config cache to load new values immediately
    Artisan::call('config:clear');

    return redirect('/')->with('success', 'Setup completed successfully!');
}

Important: Make sure your web server has write permissions to the root directory of your Laravel app (so it can create/write the .env file). On most servers, you can set the directory ownership to the web server user (like www-data on Apache) or adjust file permissions temporarily during setup.

3. Optional: Test Database Connection Before Saving #

To avoid saving invalid credentials, add a quick connection test before writing to .env:

use Illuminate\Support\Facades\DB;
use PDOException;

// Add this after validation, before writing to .env
try {
    DB::connection([
        'driver' => 'mysql',
        'host' => $request->db_host,
        'port' => $request->db_port,
        'database' => $request->db_name,
        'username' => $request->db_username,
        'password' => $request->db_password,
    ])->getPdo();
} catch (PDOException $e) {
    return back()->withErrors(['db_connection' => 'Could not connect to the database: '.$e->getMessage()])->withInput();
}

4. Accessing .env Values in Laravel #

There are two main ways to access values from .env, but one is preferred for production:

Using the env() Helper #

You can directly call the env() helper anywhere in your app:

$dbHost = env('DB_HOST');

Note: If you run php artisan config:cache (which you should in production), the env() helper will stop working—cached configs don't read from .env anymore.

Using config() Helper (Recommended) #

The better approach is to reference .env values in your config files (like config/database.php), then use the config() helper to access them:

// config/database.php
'mysql' => [
    'host' => env('DB_HOST', 'localhost'),
    // ... other settings
]

// In your app code
$dbHost = config('database.connections.mysql.host');

This works even when configs are cached, making it the safe choice for all environments.

内容的提问来源于stack exchange，提问作者T.Arslan