php主机如何部署网站：上传文件、绑定域名与设置数据库

把 PHP 网站部署到主机，通常要完成四件事：确认主机环境满足项目要求，把代码放到正确的网站目录，将域名解析到主机并在主机面板绑定，最后配置数据库和站点运行参数。不同服务商的面板名称、目录结构和数据库连接地址可能不同，但这些步骤背后的原理基本一致。

本文适用于常见的 PHP 虚拟主机、带控制面板的云主机，以及提供 PHP 运行环境的托管服务。它不适用于所有容器平台或无服务器环境；如果服务商要求通过 Git、容器镜像或专用发布工具部署，应优先遵循其平台文档。

一、部署前确认项目与主机条件

不要先上传文件，再发现主机无法运行项目。部署前先在项目根目录查找 composer.json、框架说明、安装文档和环境配置示例，确认以下信息：

• PHP 版本：项目声明的最低和最高兼容版本。主机支持某个版本，不代表项目一定兼容它。
• 扩展：例如 PDO、PDO MySQL、OpenSSL、Mbstring、XML、cURL、GD 或 Fileinfo。实际需求应以项目文档和运行错误为准。
• 入口目录：传统项目可能以项目根目录中的 index.php 为入口；Laravel、Symfony 等项目通常应将网站根目录指向 public，而不是整个项目目录。
• 数据库类型与版本：确认项目使用 MySQL、MariaDB 或其他数据库，以及是否需要导入现有结构和数据。
• 运行限制：主机可能限制磁盘空间、单文件上传大小、请求执行时间、进程数、定时任务或 SSH 权限。

如果主机面板可以选择 PHP 版本和扩展，先按项目要求设置，再部署。若面板没有相应选项，联系服务商核实，不要用修改代码的方式绕过缺失扩展或平台限制。

二、准备待上传的网站文件

先在本地整理发布文件。不要把开发环境的所有内容不加区分地上传：日志、缓存、测试文件、编辑器配置、版本库目录和本地数据库备份通常不需要公开部署。

如果项目使用 Composer，通常应在本地或有 SSH 权限的服务器上安装依赖。生产部署常见命令如下，具体选项以项目的 Composer 版本和部署流程为准：

composer install --no-dev --prefer-dist --optimize-autoloader

--no-dev 不安装开发依赖，适合不需要在生产环境运行测试工具的项目。不要直接删除 vendor 目录后上传：如果主机不能运行 Composer，就应在本地安装好依赖，再按项目要求一并上传。使用框架时，还要阅读该框架关于生产环境缓存、密钥和权限的说明。

压缩发布文件可以缩短大量小文件的上传时间。压缩前确认归档中目录层级正确：解压后应直接得到项目文件，而不是意外多出一层同名目录。保留一份可回滚的旧版本和数据库备份，但不要把备份放在可通过浏览器访问的位置。

三、上传文件并确认网站根目录

虚拟主机常见的上传方式包括面板文件管理器、FTP/SFTP 客户端和 SSH。优先使用主机商支持的安全方式：SFTP 通过 SSH 通道传输；传统 FTP 通常不加密账号和数据，除非服务商明确配置了加密传输，否则不适合在不可信网络中使用。使用客户端时，核对主机名、端口、账号和远程目录，不要把服务器文件误传到本地目录。

常见网站目录名有 public_html、www、htdocs 或面板为每个站点创建的独立目录，但它们并非通用标准。以主机面板显示的站点根目录为准。上传完成后，先检查入口文件和目录结构是否正确，再访问站点。

如果框架要求将 public 作为文档根目录，优先在面板的站点设置中把网站根目录指向项目的 public 子目录。这样通常能避免将配置文件、依赖目录等暴露在网站目录中。若主机不允许修改文档根目录，应查阅框架和主机商给出的替代部署方式，不要简单把整个项目都放进公开目录，再依赖猜测出来的重写规则保护敏感文件。

文件权限应遵循主机和应用的要求。常见 Unix 主机上，普通文件使用 644、目录使用 755 是一种常见起点，但实际权限取决于 PHP 运行用户、文件所有者和主机配置。需要写入的缓存、上传目录应只开放给确实需要写入的程序目录。不要把所有文件设为 777：这会扩大其他用户或进程修改文件的可能性，也通常不是正确修复权限问题的方法。

四、绑定域名与配置 DNS

“绑定域名”通常包含两个不同操作，不能混为一谈：

1. 主机侧添加站点：在主机面板中创建站点，填写域名并指定对应的网站根目录。不同面板可能称为“添加网站”“域名绑定”或“站点管理”。
2. 域名侧设置解析：在域名 DNS 服务商处添加记录，让域名指向主机。常见做法是用 A 记录指向 IPv4 地址；如服务商提供并要求使用 IPv6，再按其说明配置 AAAA 记录。CNAME 将一个主机名指向另一个主机名，根域名是否能使用取决于 DNS 服务商支持的功能。

主机面板有时会提供推荐的 DNS 记录，也可能要求使用指定的名称服务器。不要凭经验填写 IP 或名称服务器，应以主机商提供的站点信息为准。域名解析尚未生效时，浏览器可能仍访问旧主机；DNS 缓存和记录的 TTL 会影响变更传播时间，因此不应把“添加记录后立刻能访问”当作保证。

通常要分别检查根域名和 www 子域名，例如 example.com 与 www.example.com。如果两者都要访问，需要分别配置对应 DNS 记录，并在主机上添加这两个站点名称或设置规范跳转。根域名和 www 并不会因为其中一个可用就自动全部可用。

可以在本机查询解析结果。以下命令在安装了相应工具的系统中使用；返回结果受 DNS 缓存和网络环境影响：

nslookup example.com
nslookup www.example.com

若域名解析正确但打开的是默认页，重点检查主机面板中的域名绑定和文档根目录；若显示旧网站，可能是 DNS 仍指向旧服务器，也可能是浏览器或代理缓存。确认解析与站点配置后，再为域名启用 HTTPS 证书，并检查证书覆盖的域名是否包含实际访问的主机名。

五、创建数据库并导入数据

在主机面板中创建数据库、数据库用户，并按需要授予权限。很多托管服务会为数据库名和用户名自动添加账号前缀，因此最终名称可能与输入值不同。记录面板显示的实际数据库名、用户名、密码、数据库主机地址和端口；数据库主机不一定是 localhost，应以服务商提供的信息为准。

现有项目通常需要通过面板中的 phpMyAdmin、Adminer 或其他工具导入 SQL 文件。导入前确认备份来自兼容的数据库版本，并留意文件大小限制、字符集和排序规则。SQL 文件过大时，网页工具可能超时或拒绝上传，需使用主机支持的命令行导入方式，或询问服务商是否提供分批导入方案。

全新安装的网站可能会在首次运行时自动建表，也可能提供安装程序或迁移命令。不要在不了解操作后果的情况下重复导入初始化 SQL：重复导入可能产生重复数据、表已存在错误，甚至覆盖现有数据。生产环境执行迁移前应先备份数据库。

六、配置数据库连接与保护敏感信息

数据库连接配置因项目和框架而异。已有项目应优先使用其环境变量或配置机制，不要为了方便另造一套配置格式。下面是一个简化的 PDO 连接示例，可用于说明连接参数的来源；实际部署应将示例值替换为服务商提供的信息：

<?php
$host = 'db-host.example.net';
$port = 3306;
$dbname = 'account_site';
$username = 'account_user';
$password = 'replace-with-a-secret';

$dsn = sprintf(
    'mysql:host=%s;port=%d;dbname=%s;charset=utf8mb4',
    $host,
    $port,
    $dbname
);

$options = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
];

$pdo = new PDO($dsn, $username, $password, $options);

这段代码使用 PDO 的异常模式，连接失败时会抛出异常，适合配合应用自己的错误处理和日志记录。3306 是 MySQL 常见默认端口，不是所有主机都使用该端口；端口和主机名必须以服务商提供的信息为准。连接字符集指定为 utf8mb4，但数据库和表的字符集、排序规则也应与项目要求一致。

不要把数据库密码提交到公开代码仓库，也不要在网页中输出密码或连接异常细节。优先使用主机支持的环境变量或放在网站文档根目录之外的配置文件，并限制该文件的读取权限。某些虚拟主机不允许在文档根目录外创建文件；此时应使用服务商推荐的配置管理方式，不能假定目录位置或访问控制规则一定有效。

不要把数据库账号设为数据库服务器的全局管理员。生产应用账号只应拥有应用运行所需的权限；需要执行建表或迁移时，可根据平台能力使用单独的迁移账号，或在受控的部署阶段临时授予必要权限。完成后及时撤销不再需要的权限。

七、验证连接：一个最小化的数据库检查脚本

如果项目暂时没有可见的数据库检查入口，可以在受保护的临时环境中运行以下示例。它执行一条只读取当前数据库名称的查询，便于确认连接和权限是否基本正常：

<?php
try {
    $pdo = new PDO(
        'mysql:host=db-host.example.net;port=3306;dbname=account_site;charset=utf8mb4',
        'account_user',
        'replace-with-a-secret',
        [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        ]
    );

    $row = $pdo->query('SELECT DATABASE() AS db_name')->fetch();
    echo '数据库连接成功。';
} catch (PDOException $e) {
    http_response_code(500);
    error_log('Database connection failed: ' . $e->getMessage());
    echo '数据库连接失败，请检查服务器日志和连接配置。';
}

示例把详细错误写入服务器错误日志，而不是直接回显给访问者。日志可能包含主机信息或 SQL 细节，应限制访问权限。检查完成后应删除临时脚本，尤其不能留下会输出配置、服务器路径或调试信息的公开页面。

如果要查询用户输入的数据，应使用预处理语句，而不是把输入直接拼接进 SQL。参数绑定可以降低 SQL 注入风险，但它不是完整的权限管理方案，也不能替代输入校验、账号最小权限和安全的错误处理。示例：

<?php
$stmt = $pdo->prepare(
    'SELECT id, email FROM users WHERE email = :email'
);

$stmt->execute([
    'email' => $email,
]);

$user = $stmt->fetch();

八、启用 HTTPS 并完成发布检查

解析生效、域名已绑定后，通过主机面板或服务商的证书服务为站点配置 HTTPS。证书签发方式、自动续期和通配符支持取决于主机与证书服务。启用后检查证书是否有效、域名是否匹配，并确认应用没有混用 HTTP 资源。站点需要强制跳转 HTTPS 时，优先使用主机面板、应用框架或服务器支持的设置；不要直接套用 Apache 规则到 Nginx 主机。

上线前可按清单逐项检查：

• 使用目标 PHP 版本访问首页和主要功能，确认所需扩展已启用。
• 检查网站根目录是否指向项目正确入口，框架的非公开文件没有被当作站点内容访问。
• 确认根域名和 www 的解析、主机绑定、证书覆盖范围和跳转策略一致。
• 用实际页面或应用功能验证数据库连接、字符集和数据读写。
• 确认错误日志可用于排查问题，生产站点不会向访客显示堆栈、路径和密钥。
• 检查文件上传目录、缓存目录和会话目录的写入权限，不给不需要写入的目录开放权限。
• 准备代码与数据库备份，并确认恢复步骤可执行。

九、常见错误与排查方向

访问站点显示 403 或 404

先确认域名确实绑定到目标站点，再检查文档根目录是否正确、入口文件是否存在、目录权限是否允许服务进程读取。框架路由可能还需要重写规则，但 Apache 的 .htaccess 不会自动在 Nginx 上生效。使用哪种规则取决于服务器软件和主机商配置。

出现 500 错误或空白页面

先查看面板中的 PHP 错误日志和服务器错误日志。常见原因包括 PHP 版本不兼容、扩展缺失、语法错误、依赖未上传、配置文件格式错误或目录权限不正确。不要在生产站点长期开启错误直接显示；应把详细信息写入受限日志中。

数据库连接失败

逐项核对数据库主机、端口、数据库名、用户名和密码，尤其检查面板自动添加的账号前缀。还要确认数据库服务是否允许该网站连接、账号是否有目标数据库权限，以及项目实际读取的是哪份配置。localhost 不是所有主机的正确连接地址。

网站仍显示旧页面或默认页面

可能是 DNS 记录尚未更新、浏览器缓存、主机绑定错误或代码上传到了另一个目录。分别核对域名解析结果、面板绑定关系和站点根目录，不要只靠反复清缓存判断问题。

中文乱码或表情符号保存失败

检查数据库、表、连接字符集和页面编码是否一致，项目是否使用 utf8mb4。仅修改 PHP 连接字符集不一定能修复已存在的错误表结构或历史数据；变更前备份，并按项目的数据迁移方案处理。

文件上传失败

上传限制可能来自 PHP 的 upload_max_filesize、post_max_size，也可能来自面板、Web 服务器或代理层。post_max_size 限制整个 POST 请求体，通常应大于单个文件的上传限制；但这些参数的可修改方式和上限由主机商决定。不要假定在共享主机上编辑 php.ini 一定有效，先查看面板设置或询问服务商。

十、共享主机部署的适用边界

共享 PHP 主机适合流量和资源需求较为稳定、可以接受平台约束的中小型网站，例如内容站点、企业展示站或常见 PHP 应用。它的优势是运维工作相对少；限制则可能包括无法安装系统软件、不能控制 Web 服务器配置、数据库不能远程访问、SSH 或定时任务受限，以及资源使用受到配额约束。

如果项目依赖常驻进程、消息队列、特定系统服务、复杂的 Nginx 配置或大量后台任务，普通虚拟主机未必适合。部署前应核实这些能力是否由平台支持，而不是假设“能运行 PHP”就等于能运行所有 PHP 项目。遇到权限或配置限制时，优先使用服务商明确支持的方案；必要时更换匹配的主机类型，而不是通过扩大权限或公开敏感文件来勉强运行。

最稳妥的部署顺序是：先核对环境，再准备发布文件；先确定网站根目录，再上传；同时完成主机站点绑定与 DNS 配置；数据库和 HTTPS 验证通过后再开放访问。每次变更都保留可恢复的代码与数据备份。这样既能减少上线时的试错，也能在出现问题时快速定位是文件、域名、运行环境还是数据库环节出了差错。