OpenSUSE Leap 15下Nginx中PHP联系表单报405 Not Allowed错误

问题背景 #

在OpenSUSE Leap 15服务器上部署了HTML+PHP联系表单，服务器环境为Nginx 1.21.5 + PHP8。提交表单时返回405错误，同时遇到OpenSUSE官方源无PHPMailer软件包的问题，尝试过更换Sendmail替代Postfix、关闭防火墙，均未解决。

错误现象 #

提交表单后页面显示：

405 Not Allowed

---

nginx/1.21.5

已尝试操作 #

• 尝试安装PHPMailer，发现OpenSUSE官方源未提供该软件包
• 安装Sendmail替代Postfix
• 关闭服务器防火墙

现有代码 #

PHP邮件处理文件（mailer.php） #

<?php
if ($_POST) {
    $to = 'emailaddress';
    $name = $_POST['name'];
    $email = $_POST['email'];
    $header = $_POST['header'];
    $message = $_POST['message'];
    $mes = "Navn: $name \nE-post: $email \nEmne: $header \nMelding: $message";
    if ($mes) {
        mail($to, $header, $mes, "Content-type:text/plain; charset = UTF-8\r\nFrom:$email");
    }
} else {
    header('Location: /');
    exit;
}

HTML表单代码 #

<div id="contact_us" class="modal fade modal-contact-us" role="dialog">
    <div class="modal-dialog">
        <!-- Modal content-->
        <div class="modal-content">
            <div class="modal-header-contact">
                <h4 class="text-capitalize fwSemi-bold">Contact us</h4>
                <span class="close" data-dismiss="modal"></span>
            </div>
            <div class="model-body-contact">
                <form
                    action="mailer.php"
                    class="needs-validation"
                    novalidate
                >
                    <div class="control-container">
                        <label class="fwbold" for="modal-contact-name">Name *</label>
                        <input
                            class="form-control"
                            type="text"
                            id="modal-contact-name"
                            required
                            name="name"
                            minlength="2"
                        />
                    </div>
                    <div class="control-container">
                        <label class="fwbold" for="modal-contact-email">Email *</label>
                        <input
                            class="form-control"
                            type="text"
                            id="modal-contact-email"
                            required
                            pattern="^[a-z0-9._%+-]+@[a-z0-9.-]+\.[a-z]{2,4}$"
                            name="email"
                        />
                    </div>
                    <div class="control-container">
                        <label class="fwbold" for="modal-contact-phone">Phone</label>
                        <input
                            class="form-control"
                            type="text"
                            id="modal-contact-phone"
                            pattern="^[0-9]+$"
                        />
                    </div>
                    <div class="control-container">
                        <label class="fwbold" for="modal-contact-message">Melding</label>
                        <textarea
                            id="modal-contact-message"
                            name="message"
                        ></textarea>
                    </div>
                    <input
                        type="text"
                        class="hidden"
                        name="header"
                        value="Question"
                    />
                    <div class="modal-contact-us-actions">
                        <button
                            class="btn btn-link round cancel-btn"
                            type="button"
                            data-dismiss="modal"
                        >
                            Avbryt
                        </button>
                        <button
                            class="btn-primary btn-blue md-round fwSemi-bold send-btn"
                            type="submit"
                        >
                            Send
                        </button>
                    </div>
                </form>
            </div>
        </div>
    </div>
</div>

解决方案 #

1. 修复405 Not Allowed错误 #

• 表单请求方法错误：HTML表单未指定method属性，默认使用GET请求，但PHP代码仅处理POST请求。修改
  标签，添加method="POST"：

  <form
      action="mailer.php"
      class="needs-validation"
      novalidate
      method="POST"
  >
  

• Nginx配置检查：确保Nginx允许PHP文件接收POST请求。在对应站点的server配置块中，检查location ~ \.php$段，确保没有限制请求方法的配置（如limit_except GET;），并确认权限配置正确：

  location ~ \.php$ {
      root           /path/to/your/webroot;
      fastcgi_pass   unix:/run/php-fpm.sock; # 或对应PHP-FPM端口，如127.0.0.1:9000
      fastcgi_index  index.php;
      fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
      include        fastcgi_params;
      allow all; # 确保允许所有请求
  }
  

  修改后重启Nginx：systemctl restart nginx

2. 解决邮件发送问题（PHPMailer安装及使用） #

OpenSUSE源无PHPMailer，可通过Composer安装：

1. 安装Composer：

   zypper install composer
   

2. 在项目根目录执行安装命令：

   composer require phpmailer/phpmailer
   

3. 修改PHP代码使用PHPMailer（推荐用第三方SMTP服务，比本地MTA更可靠）：

   <?php
   use PHPMailer\PHPMailer\PHPMailer;
   use PHPMailer\PHPMailer\Exception;
   
   require 'vendor/autoload.php';
   
   if ($_POST) {
       $to = 'emailaddress';
       $name = $_POST['name'];
       $email = $_POST['email'];
       $header = $_POST['header'];
       $message = $_POST['message'];
       $mes = "Navn: $name \nE-post: $email \nEmne: $header \nMelding: $message";
   
       $mail = new PHPMailer(true);
       try {
           // 配置SMTP服务器（替换为你的邮箱服务商SMTP信息）
           $mail->isSMTP();
           $mail->Host = 'smtp.example.com';
           $mail->SMTPAuth = true;
           $mail->Username = 'your-email@example.com';
           $mail->Password = 'your-email-password';
           $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
           $mail->Port = 587;
   
           // 设置收发件人
           $mail->setFrom($email, $name);
           $mail->addAddress($to);
   
           // 邮件内容
           $mail->isHTML(false);
           $mail->Subject = $header;
           $mail->Body = $mes;
   
           $mail->send();
           header('Location: /success.html'); // 发送成功跳转页面
           exit;
       } catch (Exception $e) {
           error_log("邮件发送失败: {$mail->ErrorInfo}");
           header('Location: /error.html'); // 发送失败跳转页面
           exit;
       }
   } else {
       header('Location: /');
       exit;
   }
   

3. 原生mail()函数备选方案（依赖本地MTA） #

若坚持使用原生mail()，需确保Postfix配置正确：

1. 安装Postfix：

   zypper install postfix
   

2. 启动并启用服务：

   systemctl start postfix && systemctl enable postfix
   

3. 测试本地邮件发送：

   echo "测试邮件内容" | mail -s "测试主题" your-email@example.com
   

4. 配置域名SPF、DKIM记录，避免邮件被标记为垃圾邮件。

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