Konfigurieren von PHP/Node.js-Datei-Uploads auf Render | Disk, Umgebungsvariablen und S3-Integration

Render ist eine beliebte Cloud-Plattform als Alternative zu Heroku. Da es ein persistentes Prozessmodell (Web Service) statt Serverless verwendet, unterscheidet sich die Architektur des Datei-Uploads von Vercel und Netlify. Dieser Artikel behandelt die Konfiguration persistenter Speicher (Disk) auf Render, wie man <code>upload_max_filesize</code> in PHP-Umgebungen ändert, S3-Konfiguration mit Umgebungsvariablen und Konfigurationsbeispiele in Infrastructure as Code (IaC) mit <code>render.yaml</code> (Blueprint).

Was ist Render Disk (Persistent Storage)

Der Web Service von Render ist standardmäßig ephemeral (das Dateisystem wird bei Neuimplementierung zurückgesetzt). Um hochgeladene Dateien zu speichern, müssen Sie ein Disk hinzufügen.

Da Render Disk das Scale-out (mehrere Instanzen) nicht unterstützt, wird die Integration mit S3 für echte Datei-Uploads empfohlen. Disk ist für Entwicklungs- und Staging-Umgebungen oder Single-Instance-Betrieb geeignet.

Disk-Konfiguration im Render Dashboard

Disk kann über die Web Service-Einstellungen im Render Dashboard hinzugefügt werden.

# render.yaml（Blueprint）での Disk 設定
services:
  - type: web
    name: my-app
    runtime: node
    buildCommand: npm install && npm run build
    startCommand: npm start
    disk:
      name: uploads-disk
      mountPath: /app/uploads  # アプリ内でのマウントパス
      sizeGB: 10               # 10GB のディスク
    envVars:
      - key: UPLOAD_DIR
        value: /app/uploads

// Node.js での Disk へのファイル保存
const path = require('path');
const fs = require('fs');

const UPLOAD_DIR = process.env.UPLOAD_DIR || path.join(__dirname, 'uploads');

// アップロードディレクトリが存在しない場合は作成
if (!fs.existsSync(UPLOAD_DIR)) {
  fs.mkdirSync(UPLOAD_DIR, { recursive: true });
}

// multer の設定例（Disk ストレージ）
const multer = require('multer');

const storage = multer.diskStorage({
  destination: (req, file, cb) => {
    cb(null, UPLOAD_DIR);
  },
  filename: (req, file, cb) => {
    const uniqueSuffix = `${Date.now()}-${Math.round(Math.random() * 1e9)}`;
    const ext = path.extname(file.originalname);
    cb(null, `upload-${uniqueSuffix}${ext}`);
  },
});

const upload = multer({
  storage,
  limits: { fileSize: 50 * 1024 * 1024 }, // 50MB
  fileFilter: (req, file, cb) => {
    const allowedTypes = ['image/jpeg', 'image/png', 'image/webp', 'application/pdf'];
    if (allowedTypes.includes(file.mimetype)) {
      cb(null, true);
    } else {
      cb(new Error('許可されていないファイル形式です。'));
    }
  },
});

Konfiguration von upload_max_filesize in der PHP-Umgebung

Bei PHP-Anwendungen in Render (Docker-basiert) können Sie die Upload-Größe durch Änderung der <code>php.ini</code>-Einstellungen anpassen. Da Render beliebige Docker-Konfigurationen ermöglicht, ist es flexibler als andere Hosting-Services.

# Dockerfile（PHP アプリ）
FROM php:8.2-fpm

# 必要な拡張をインストール
RUN docker-php-ext-install pdo pdo_mysql

# php.ini の設定をオーバーライド
RUN echo "upload_max_filesize = 100M" > /usr/local/etc/php/conf.d/uploads.ini \
 && echo "post_max_size = 110M" >> /usr/local/etc/php/conf.d/uploads.ini \
 && echo "memory_limit = 256M" >> /usr/local/etc/php/conf.d/uploads.ini \
 && echo "max_execution_time = 120" >> /usr/local/etc/php/conf.d/uploads.ini \
 && echo "max_input_time = 120" >> /usr/local/etc/php/conf.d/uploads.ini

WORKDIR /var/www/html
COPY . .

EXPOSE 9000
CMD ["php-fpm"]

# php.ini（直接配置する場合）
; ファイルアップロードの有効化
file_uploads = On

; 1ファイルあたりの上限
upload_max_filesize = 100M

; POST データ全体の上限（upload_max_filesize より大きくする）
post_max_size = 110M

; PHP スクリプトのメモリ上限
memory_limit = 256M

; スクリプトの最大実行時間（秒）
max_execution_time = 120

; ファイル入力待ちの最大時間（秒）
max_input_time = 120

; 一時ファイルのディレクトリ（Render の場合は /tmp を使用）
upload_tmp_dir = /tmp

<?php
// .htaccess が使えない場合は ini_set() で実行時に変更（共有ホスティングでは制限あり）
// Render（Docker）では Dockerfile での設定が確実

// ini_set() による実行時オーバーライド（一部の設定のみ有効）
ini_set('memory_limit', '256M');
// upload_max_filesize と post_max_size は実行時変更不可（php.ini での設定が必要）

// 設定値の確認
echo ini_get('upload_max_filesize'); // "100M"
echo ini_get('post_max_size');       // "110M"
echo ini_get('memory_limit');        // "256M"

S3-Konfiguration mit Umgebungsvariablen

Konfigurieren Sie Umgebungsvariablen im Render Dashboard oder in <code>render.yaml</code>, damit Ihre Anwendung auf AWS S3 zugreifen kann. Verwenden Sie die Geheimnismanagement-Funktion von Render für sensible Informationen und fügen Sie nur die Schlüssel in <code>render.yaml</code> ein.

# render.yaml（Blueprint）— シークレットはキーのみ定義
services:
  - type: web
    name: my-php-app
    runtime: docker
    dockerfilePath: ./Dockerfile
    envVars:
      # 非シークレット（値を直接記載）
      - key: AWS_REGION
        value: ap-northeast-1
      - key: AWS_S3_BUCKET
        value: my-app-uploads

      # シークレット（Render Dashboard で値を設定）
      - key: AWS_ACCESS_KEY_ID
        sync: false          # sync: false でダッシュボードで手動入力
      - key: AWS_SECRET_ACCESS_KEY
        sync: false

      # または Render の Environment Group を参照
      - fromGroup: aws-credentials

    disk:
      name: tmp-uploads
      mountPath: /tmp/uploads
      sizeGB: 5

<?php
// PHP での AWS SDK を使った S3 アップロード
require 'vendor/autoload.php';

use Aws\S3\S3Client;
use Aws\Exception\AwsException;

$s3 = new S3Client([
    'version' => 'latest',
    'region'  => getenv('AWS_REGION'),
    'credentials' => [
        'key'    => getenv('AWS_ACCESS_KEY_ID'),
        'secret' => getenv('AWS_SECRET_ACCESS_KEY'),
    ],
]);

function uploadToS3(array $file, string $bucket): array
{
    global $s3;

    $key = 'uploads/' . uniqid('file_', true) . '_' . basename($file['name']);

    try {
        $result = $s3->putObject([
            'Bucket'      => $bucket,
            'Key'         => $key,
            'SourceFile'  => $file['tmp_name'],
            'ContentType' => mime_content_type($file['tmp_name']),
            'ACL'         => 'private',
        ]);

        return [
            'success' => true,
            'key'     => $key,
            'url'     => $result['ObjectURL'],
        ];
    } catch (AwsException $e) {
        return ['success' => false, 'error' => $e->getMessage()];
    }
}

// アップロード処理
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['file'])) {
    $file = $_FILES['file'];

    // バリデーション
    $maxSize = 50 * 1024 * 1024; // 50MB
    if ($file['size'] > $maxSize) {
        http_response_code(413);
        echo json_encode(['error' => 'ファイルが大きすぎます（上限50MB）。']);
        exit;
    }

    $allowedMimes = ['image/jpeg', 'image/png', 'image/webp', 'application/pdf'];
    $detectedMime = mime_content_type($file['tmp_name']); // サーバー側でMIMEを検出
    if (!in_array($detectedMime, $allowedMimes)) {
        http_response_code(415);
        echo json_encode(['error' => '許可されていないファイル形式です。']);
        exit;
    }

    $result = uploadToS3($file, getenv('AWS_S3_BUCKET'));
    echo json_encode($result);
}

Vollständiges Konfigurationsbeispiel in render.yaml (Blueprint)

Mit Blueprint können Sie die Infrastruktur von Render mit Code verwalten. Sie können Web Service, Datenbank, Redis, Disk und Umgebungsvariablen zusammen definieren.

# render.yaml
version: "1"

services:
  # Web アプリケーション
  - type: web
    name: file-upload-app
    runtime: node
    plan: starter           # free / starter / standard / pro
    region: singapore       # oregon / frankfurt / singapore / ohio
    buildCommand: npm ci && npm run build
    startCommand: node server.js
    healthCheckPath: /health
    autoDeploy: true        # Git push で自動デプロイ

    # 永続ストレージ（スケールアウト不可）
    disk:
      name: user-uploads
      mountPath: /app/data/uploads
      sizeGB: 20

    # 環境変数
    envVars:
      - key: NODE_ENV
        value: production
      - key: PORT
        value: 3000
      - key: UPLOAD_DIR
        value: /app/data/uploads
      - key: AWS_REGION
        value: ap-northeast-1
      - key: AWS_S3_BUCKET
        value: my-production-bucket

      # シークレット（ダッシュボードで値を設定）
      - key: AWS_ACCESS_KEY_ID
        sync: false
      - key: AWS_SECRET_ACCESS_KEY
        sync: false
      - key: DATABASE_URL
        fromDatabase:
          name: app-db
          property: connectionString

  # PostgreSQL データベース
  - type: pserv
    name: app-db
    runtime: postgres
    plan: starter
    region: singapore
    databaseName: app_production