OpenCart 3.0 联系我们邮件发送失败的诊断与解决指南

<form action="https://yourdomain.com/index.php?route=information/contact/send" method="post" enctype="multipart/form-data" class="form-horizontal">
    <!-- ... 表单内容 ... -->
</form>

// 文件路径: catalog/controller/information/contact.php

class ControllerInformationContact extends Controller {
    public function send() {
        // --- 添加调试语句开始 ---
        // 在开发环境中，可以使用echo和exit来快速验证
        // echo "Reached send method!";
        // exit(); 

        // 在生产环境中，推荐使用OpenCart的日志功能
        $this->log->write('Contact form: Reached send method.');
        // --- 添加调试语句结束 ---

        // ... 原始代码，例如表单验证和邮件发送逻辑
        $this->load->language('information/contact');

        if (($this->request->server['REQUEST_METHOD'] == 'POST') && $this->validate()) {
            // ... 邮件发送逻辑
        }
    }

    protected function validate() {
        // ... 验证逻辑
    }
}

public function send() {
    $this->log->write('Contact form: POST Data: ' . print_r($this->request->post, true));
    // ...
}

protected function validate() {
    // ... 验证逻辑，例如：
    if ((utf8_strlen($this->request->post['name']) < 3) || (utf8_strlen($this->request->post['name']) > 32)) {
        $this->error['name'] = $this->language->get('error_name');
    }

    if (!filter_var($this->request->post['email'], FILTER_VALIDATE_EMAIL)) {
        $this->error['email'] = $this->language->get('error_email');
    }

    // ... 其他验证，如验证码

    return !$this->error; // 如果没有错误，返回true
}

public function send() {
    // ... 前面的验证逻辑
    if (($this->request->server['REQUEST_METHOD'] == 'POST') && $this->validate()) {
        $this->load->model('setting/store');
        $store_info = $this->model_setting_store->getStore($this->config->get('config_store_id'));

        if ($store_info) {
            $store_name = $store_info['name'];
        } else {
            $store_name = $this->config->get('config_name');
        }

        $this->load->library('mail'); // 加载邮件库

        $mail = new Mail($this->config->get('config_mail_engine')); // 实例化邮件对象
        $mail->parameter = $this->config->get('config_mail_parameter');
        $mail->smtp_hostname = $this->config->get('config_mail_smtp_hostname');
        $mail->smtp_username = $this->config->get('config_mail_smtp_username');
        $mail->smtp_password = html_entity_decode($this->config->get('config_mail_smtp_password'), ENT_QUOTES, 'UTF-8');
        $mail->smtp_port = $this->config->get('config_mail_smtp_port');
        $mail->smtp_timeout = $this->config->get('config_mail_smtp_timeout');

        // 设置邮件内容
        $mail->setTo($this->config->get('config_email')); // 收件人，通常是商店邮箱
        $mail->setFrom($this->request->post['email']); // 发件人，用户填写的邮箱
        $mail->setSender(html_entity_decode($this->request->post['name'], ENT_QUOTES, 'UTF-8'));
        $mail->setSubject(html_entity_decode(sprintf($this->language->get('email_subject'), $this->request->post['name'], $store_name), ENT_QUOTES, 'UTF-8'));
        $mail->setText(html_entity_decode($this->request->post['enquiry'], ENT_QUOTES, 'UTF-8'));

        $this->log->write('Contact form: Attempting to send email. To: ' . $mail->getTo() . ', From: ' . $mail->getFrom() . ', Subject: ' . $mail->getSubject());

        try {
            $mail->send(); // 尝试发送邮件
            $this->log->write('Contact form: Email sent successfully.');
            $this->response->redirect($this->url->link('information/contact/success'));
        } catch (Exception $e) {
            $this->log->write('Contact form: Email sending failed: ' . $e->getMessage());
            // 可以在此处添加更详细的错误处理，例如将错误信息显示给用户或记录到特定日志
            $this->session->data['error'] = $this->language->get('error_email_send'); // 假设有此语言项
            $this->response->redirect($this->url->link('information/contact'));
        }
    }
    // ...
}