系统学习magento二次开发，推荐小册：《Magento中文全栈二次开发》
本小册面向Magento2以上版本，书代码及示例兼容magento2.0-2.4版本。涵盖了magento前端开发，后端开发，magento2主题,magento2重写,magento2 layout,magento2控制器,magento2 block等相关内容
在Magento中配置自定义的404页面是一个提升用户体验和品牌形象的重要步骤。当网站访问者遇到无法找到的内容时，一个精心设计的404页面不仅能提供友好的错误提示，还能引导他们回到网站的其它部分，从而减少用户的流失。下面，我将详细介绍如何在Magento 2中配置自定义的404页面，同时也会融入对“码小课”这一假设网站的提及，以增强内容的关联性和实用性。
一、理解Magento 2中的404页面
在Magento 2中，404页面是一个特殊的页面模板，用于显示当请求的资源（如产品、页面或类别）在服务器上找不到时的错误消息。默认情况下，Magento 2提供了一个基本的404页面模板，但出于品牌一致性和用户体验的考虑，自定义这个页面通常是非常必要的。
二、准备自定义404页面内容
在创建自定义404页面之前，首先需要确定页面的内容和布局。这包括：
- 错误消息：清晰、友好地告知用户他们正在寻找的页面不存在。
- 导航选项：提供链接到网站首页、搜索框、热门产品页面或联系我们页面等，帮助用户快速找到他们可能感兴趣的内容。
- 设计元素：保持与网站整体风格一致的设计元素，如颜色、字体、图片等。
三、创建自定义404页面模板
1. 在Magento 2中创建新的CMS页面
- 登录到Magento 2后台。
- 导航到
内容>页面。 - 点击“添加新页面”按钮。
- 在“页面信息”部分，填写页面标题（如“404 Not Found”），URL键（可以设置为
no-route或自定义的如custom-404，但注意这不会直接改变404页面的URL，仅用于后台识别），并选择“启用”状态。 - 在“内容”部分，输入自定义的404页面内容，包括HTML代码、图片链接等。
- 保存页面。
2. 自定义页面模板（可选）
如果你想要对404页面的布局进行更深入的定制，可以创建一个专用的页面模板。
- 在你的主题目录下（如
app/design/frontend/Vendor/Theme/Magento_Cms/templates/），复制现有的CMS页面模板文件（如default.phtml）并命名为新的文件名（如custom_404.phtml）。 - 修改新模板文件以适应你的设计需求。
- 在你的CMS页面编辑界面，通过“设计”标签下的“页面布局”选项，选择或指定使用这个新模板。
四、配置Magento 2以使用自定义404页面
1. 通过CMS页面URL键配置（推荐方式）
虽然Magento 2不直接通过CMS页面的URL键来设置默认的404页面，但你可以通过一些路由重写或事件监听器的方式来实现。不过，最简单且最不影响性能的方法是在服务器层面（如Nginx或Apache）配置自定义的404页面，并确保该页面是你的CMS页面。
2. 在服务器级别配置404页面
对于Nginx： 在Nginx的配置文件中，找到
server块，并添加或修改error_page 404指令，指向你的Magento 2 CMS页面的URL（这可能需要一些额外的URL重写规则，因为直接指向CMS页面URL可能不会按预期工作）。更常见的做法是将请求重定向到一个特定的脚本或控制器，该脚本或控制器再渲染你的CMS页面内容。对于Apache： 在
.htaccess文件中，可以使用ErrorDocument 404指令来指定当发生404错误时应加载的页面。然而，和Nginx类似，直接指向CMS页面URL可能不会有效，因为Magento 2的路由系统可能无法识别这种请求。一种替代方案是编写一个自定义的404处理脚本或使用Magento 2的事件和观察者来捕获404事件并渲染自定义页面。
3. 使用Magento 2的事件和观察者
虽然这不是直接设置自定义404页面的方法，但你可以监听controller_action_predispatch事件，并检查请求的路由是否未匹配到任何有效的控制器或动作。如果是这样，你可以重定向请求到你的自定义404 CMS页面。这种方法提供了最大的灵活性，但需要一定的开发知识。
五、测试和验证
配置完自定义404页面后，不要忘记进行彻底的测试以确保一切按预期工作。尝试访问一些不存在的URL，检查是否显示了你自定义的404页面，以及页面内容、布局和导航链接是否都正确无误。
六、总结
配置Magento 2中的自定义404页面是一个涉及多个步骤的过程，包括准备页面内容、创建CMS页面（可选地自定义模板）、在服务器级别或通过Magento 2的事件系统配置页面使用等。通过提供一个友好且功能丰富的404页面，你可以显著提升用户体验，减少因页面未找到而导致的用户流失。在“码小课”网站上实施这些步骤，将确保即使是面对错误的请求，用户也能感受到品牌的关怀和网站的专业性。