Logo
Hướng dẫn upload mã nguồn WordPress lên hosting cPanel (đầy đủ, kèm import database)

Hướng dẫn upload mã nguồn WordPress lên hosting cPanel (đầy đủ, kèm import database)

tobi
tobi•• … views

Lưu ý cập nhật: Bài viết này đăng lần đầu ngày 25/05/2023, chủ yếu là dãy ảnh chụp màn hình với rất ít chữ giải thích. Từ tháng 11/2026 bài được viết lại đầy đủ theo giao diện cPanel Jupiter hiện nay: bổ sung bước chuẩn bị và đóng gói mã nguồn đúng cách, import database bằng phpMyAdmin, sửa đường dẫn khi đổi tên miền, kiểm tra sau khi upload và mục lỗi thường gặp. Quy trình nền tảng (tải source → upload → tạo database → nối wp-config → import dữ liệu) vẫn đúng như bản cũ.

Bài này dành cho hai tình huống rất hay gặp: bạn có sẵn một bộ mã nguồn WordPress hoàn chỉnh (file nén chứa source + file .sql chứa dữ liệu) cần đưa lên hosting mới — chuyển host, hoặc dựng lại website từ bản sao lưu. Nếu muốn cài WordPress mới tinh, đa số hosting có sẵn công cụ cài 1-click (WordPress Manager by Softaculous trong cPanel) nhanh hơn nhiều; cách upload thủ công dưới đây là cho trường hợp đưa website có sẵn lên.

1. Chuẩn bị: hai thứ bắt buộc phải có

  1. File mã nguồn: tốt nhất là file .zip chứa toàn bộ thư mục gốc của website — mở ra phải thấy ngay wp-admin, wp-content, wp-includes, index.php, wp-config.php…
  2. File database: file .sql (hoặc .sql.gz) xuất từ phpMyAdmin của host cũ/phpMyAdmin localhost.

Kèm theo đó là thông tin đăng nhập cPanel của hosting mới và tên miền đã trỏ về hosting (hoặc dùng tên miền tạm/địa chỉ IP để test trước).

Lỗi kinh điển ngay từ khâu đóng gói: nén cả thư mục cha vào trong file zip. Khi giải nén trên host, source nằm ở dạng public_html/ten-thu-muc/wp-admin/... — thừa một lớp thư mục, website sẽ không chạy ở tên miền chính. Mở file zip kiểm tra trước: các thư mục wp-admin, wp-content phải nằm ở lớp ngoài cùng của file nén.

Để kiểm chứng khâu chuẩn bị này, mình đã tải gói WordPress mới nhất từ wordpress.org và giải nén thử: gói .tar.gz khoảng 35 MB, giải nén đúng cách thì index.php, wp-admin, wp-content nằm thẳng ở thư mục gốc web, và file wp-config.php tạo từ bản mẫu vượt qua kiểm tra cú pháp PHP — xem ảnh ở mục 4.

2. Bước 1 — Tạo database và user bằng MySQL Database Wizard

Trong cPanel, mở MySQL Database Wizard và đi theo 3 bước của nó:

  1. Đặt tên database → cPanel tự thêm tiền tố tài khoản, dạng taikhoan_tenweb.
  2. Tạo user database + mật khẩu mạnh (dùng nút Password Generator).
  3. Ở màn hình quyền, tick ALL PRIVILEGES rồi hoàn tất — bước “gán user vào database” này là bắt buộc; quên nó là website báo lỗi kết nối database ngay.

Ghi lại 3 thông tin để dùng ở bước 4: tên database, user database, mật khẩu user (kèm tiền tố).

3. Bước 2 — Upload mã nguồn lên public_html và giải nén

  1. Trong cPanel mở File Manager, vào thư mục gốc của website: domain chính là public_html; addon domain/subdomain thì vào đúng thư mục Document Root của nó (xem ở mục Domains trong cPanel).
  2. Bấm Upload, chọn file .zip mã nguồn, chờ thanh tiến trình đạt 100%.
  3. Quay lại File Manager, chọn file zip → Extract → giải nén ngay tại thư mục đó.
  4. Kiểm tra kết quả: trong public_html phải có thẳng wp-admin, wp-content, wp-includes, index.php. Nếu thấy một thư mục con chứa tất cả những thứ này (lỗi đóng gói ở mục 1), hãy vào trong thư mục đó, Select All → Move toàn bộ nội dung ra ngoài public_html.
  5. Xoá file zip sau khi giải nén xong để đỡ tốn dung lượng.

File quá lớn (vài GB) hoặc mạng yếu khiến Upload qua trình duyệt hay đứt? Dùng FTP (FileZilla) với tài khoản FTP của hosting, hoặc nếu hosting có SSH thì tải/gọn file bằng lệnh — nguyên tắc thư mục đích không thay đổi.

Minh họa upload file nén mã nguồn WordPress lên thư mục public_html của hosting cPanel

4. Bước 3 — Import database bằng phpMyAdmin

  1. Trong cPanel mở phpMyAdmin → ở cột trái, chọn đúng database vừa tạo ở bước 1.
  2. Vào tab Import → Choose File → chọn file .sql → Import ở cuối trang.
  3. Chờ thông báo import thành công (dòng chữ xanh, không lỗi đỏ). File .sql lớn quá giới hạn của phpMyAdmin (thường 50–128 MB tuỳ hosting) sẽ báo lỗi giữa chừng — xem cách xử lý ở mục lỗi thường gặp.

Nếu file dữ liệu của bạn là của website cài mới hoàn toàn (chưa từng chạy), bạn không có file .sql — bỏ qua bước này và bước 5, sau khi làm bước 4 thì mở tên miền để chạy trình cài đặt 5 phút của WordPress.

5. Bước 4 — Nối mã nguồn với database trong wp-config.php

Trong File Manager, mở file wp-config.php ở thư mục gốc web → chuột phải Edit → sửa 4 dòng sau bằng đúng thông tin đã ghi ở bước 1:

define( 'DB_NAME', 'taikhoan_tenweb' );
define( 'DB_USER', 'taikhoan_userweb' );
define( 'DB_PASSWORD', 'mat-khau-user-database' );
define( 'DB_HOST', 'localhost' );

DB_HOST ở hầu hết hosting cPanel là localhost. Một điểm nữa cần khớp: dòng $table_prefix trong wp-config phải trùng với tiền tố bảng trong database vừa import (mặc định wp_; nếu host cũ dùng tiền tố khác như abc_ mà wp-config để wp_ thì WordPress sẽ tưởng là web mới và đòi cài lại).

Lưu file. Nếu mã nguồn của bạn chưa có wp-config.php (chỉ có wp-config-sample.php), hãy nhân bản file mẫu thành wp-config.php rồi điền như trên.

Kiểm chứng thật gói mã nguồn WordPress tải từ wordpress.org: giải nén đúng cấu trúc thư mục gốc web và file wp-config.php hợp lệ

6. Bước 5 — Đổi đường dẫn nếu website chuyển sang tên miền mới

Nếu tên miền giữ nguyên như host cũ: bỏ qua bước này.

Nếu đổi tên miền (hoặc từ localhost lên host), trong database vẫn còn địa chỉ cũ ở hai chỗ quan trọng: vào phpMyAdmin → database → bảng ..._options → sửa hai dòng siteurl và home thành https://ten-mien-moi để vào được trang chủ và wp-admin trước đã.

Cảnh báo quan trọng: đừng chạy lệnh SQL UPDATE ... REPLACE() để thay toàn bộ tên miền cũ trong database. WordPress lưu nhiều dữ liệu dạng serialized (kèm độ dài chuỗi); thay chữ thô sẽ làm hỏng độ dài và gây lỗi khó lường. Cách đúng là dùng plugin Better Search Replace: cài plugin → Tools → Better Search Replace → tìm tên miền cũ, thay bằng tên miền mới → chạy thử (dry run) trước rồi mới chạy thật.

7. Bước 6 — Kiểm tra hoàn thiện

  1. Mở tên miền: trang chủ hiển thị đúng nội dung cũ.
  2. Vào /wp-admin đăng nhập bằng tài khoản quản trị cũ.
  3. Vào Settings → Permalinks → bấm Save Changes một lần (để WordPress viết lại .htaccess, tránh lỗi 404 các trang con).
  4. Bật HTTPS: trong cPanel mục SSL/TLS Status → chạy AutoSSL cho tên miền; sau khi có chứng chỉ, nếu web còn lẫn http/https thì cân nhắc plugin Really Simple SSL.
  5. Kiểm tra vài trang con, trang liên hệ và chức năng gửi form/tìm kiếm.

Minh họa kiểm tra website WordPress sau khi upload: dữ liệu đã nối, SSL bật, sẵn sàng hoạt động

8. Lỗi thường gặp

  • “Error establishing a database connection”: sai một trong ba thông tin DB_NAME/DB_USER/DB_PASSWORD, hoặc chưa gán user vào database (thiếu bước cuối của Database Wizard), hoặc DB_HOST không phải localhost ở một số nhà cung cấp (hỏi lại hosting nếu đã chắc các thông tin kia).
  • Trang chủ chạy nhưng trang con 404: chưa lưu lại Permalinks như bước 6, hoặc file .htaccess thiếu/sai. Lưu lại Permalinks một lần thường là xong.
  • Màn hình trắng / lỗi 500: hay gặp khi bản PHP của hosting mới quá khác so với website (plugin/theme cũ không tương thích PHP 8.x). Vào cPanel → MultiPHP Manager đổi phiên bản PHP cho khớp thời của website (7.4/8.0/8.1…), và bật hiển thị lỗi trong wp-config (WP_DEBUG) tạm thời để đọc thông báo thật khi xử lý.
  • Import .sql báo lỗi giữa chừng hoặc vượt giới hạn upload: nén file thành .sql.gz rồi import lại; vẫn quá lớn thì nhờ hosting hỗ trợ import qua SSH, hoặc chia nhỏ bằng công cụ tách file SQL.
  • Website cứ chuyển hướng về tên miền cũ: chưa sửa siteurl/home (bước 5), hoặc còn cache/dữ liệu serialized chứa tên miền cũ — xử lý bằng Better Search Replace.
  • Giải nén xong nhưng mở web thấy trang trắng hoặc danh sách file: source bị thừa một lớp thư mục như mục 1 — kiểm tra lại vị trí của index.php và wp-admin.
  • File Manager báo vượt dung lượng khi upload: gói hosting đầy (kiểm tra Disk Usage trong cPanel) hoặc file zip quá khổ — chuyển sang FTP.

Kết luận

Upload mã nguồn WordPress lên hosting cPanel gồm 6 bước mạch lạc: đóng gói đúng cấu trúc → tạo database + user (nhớ gán quyền) → upload và giải nén đúng Document Root → import .sql → điền lại wp-config.php cho khớp → kiểm tra, sửa permalink và bật SSL. Hai chỗ người mới hay vấp nhất là gán user vào database và thừa một lớp thư mục khi nén file — để ý hai điểm này thì việc chuyển một website WordPress lên host mới thường chỉ mất ít phút.

Có thắc mắc khi làm theo bài, cứ nhắn qua Telegram hoặc Zalo.

Câu hỏi thường gặp

Nên dùng File Manager hay FTP để upload? File dưới vài trăm MB và đã nén sẵn: File Manager nhanh và tiện nhất. File lớn vài GB, mạng chập chờn hoặc cần up lẻ nhiều file: FTP (FileZilla) ổn định hơn vì có resume.

Upload thủ công khác gì cài bằng Softaculous? Softaculous cài WordPress mới tinh trong 1 phút. Upload thủ công dùng khi bạn đã có website hoàn chỉnh (source + database) cần đưa lên — Softaculous không thay được bước import dữ liệu cũ.

WordPress đang chạy ở localhost, đưa lên host có khác gì không? Không khác về quy trình: xuất .sql từ phpMyAdmin của localhost, nén thư mục web, rồi làm đúng 6 bước trên — chỉ có thêm bước 5 (đổi đường dẫn từ localhost/... sang tên miền thật).

Có cần đổi mật khẩu database sau khi chuyển host không? Nên — coi như làm mới thông tin nhạy cảm sau mỗi lần di chuyển. Đổi mật khẩu user trong MySQL Databases rồi cập nhật lại DB_PASSWORD trong wp-config.

Upload xong có nên giữ file zip và file .sql trên hosting không? Không. File zip source và đặc biệt là file .sql nằm trong public_html có thể bị tải công khai nếu ai đoán được đường dẫn — xoá ngay sau khi hoàn tất, chỉ giữ bản sao lưu ở máy của bạn.

Nguồn tham khảo

Chuyên mục:Hosting

Bình luận (0)

+ =
Zalo