Chuyển đến nội dung
VI
Đăng nhập Đăng ký
Tài liệu

Hướng dẫn sử dụng

Cài đặt

Tài liệu này hướng dẫn bạn quy trình cài đặt Zittme. Môi trường được chia thành hai loại chính.

  • Web hosting: môi trường bạn đăng ký dùng tại nhà cung cấp hosting. DB và máy chủ web đã được chuẩn bị sẵn, bạn chỉ cần tải tệp lên.
  • Máy chủ riêng (VPS): môi trường bạn tự vận hành máy chủ. Bạn tự chuẩn bị máy chủ web và DB.

Bạn chỉ cần làm theo phần phù hợp với môi trường của mình. Từ trình hướng dẫn cài đặt trở đi, hai môi trường giống nhau.

Môi trường cài đặt

MụcYêu cầu
PHP7.4 trở lên (khuyến nghị 8.2 trở lên)
Cơ sở dữ liệuMySQL 5.7 trở lên hoặc MariaDB 10.6 trở lên (utf8mb4)
Máy chủ webnginx hoặc Apache
Tiện ích mở rộng PHP bắt buộccurl, gd, iconv hoặc mbstring, json, openssl, PDO_MySQL, SimpleXML, Zend OPcache
Tiện ích mở rộng PHP khuyến nghịapcu (hiệu năng), exif (tự xoay ảnh), fileinfo (kiểm tra bảo mật tệp đính kèm), intl, zip
Cài đặt PHPsession.auto_start=off, memory_limit từ 128MB, upload_max_filesize từ 10MB

Hầu hết các gói PHP hosting của các nhà cung cấp web hosting tại Hàn Quốc (Cafe24, Dothome, Gabia, v.v.) đều đáp ứng. Nếu có thể chọn phiên bản PHP khi đăng ký, hãy chọn 8.2 trở lên. Dù sao thì bước kiểm tra môi trường của trình hướng dẫn cài đặt cũng sẽ chỉ ra các mục còn thiếu.

Tải bản phát hành (chung)

Tải bản phát hành mới nhất từ trang phát hành của zitt.me. Trong giai đoạn beta hiện tại, chỉ thành viên đã đăng ký làm người thử nghiệm mới tải được.

---

A. Cài đặt trên web hosting

A-1. Kiểm tra thông tin DB

Với web hosting, DB được tạo cùng lúc khi bạn đăng ký. Hãy kiểm tra và ghi lại các giá trị dưới đây trong trang quản lý hosting (như mục quản lý dịch vụ của tôi). Bạn sẽ nhập nguyên các giá trị này vào trình hướng dẫn cài đặt.

  • Máy chủ DB (thường là localhost)
  • Tên DB
  • Tên người dùng DB
  • Mật khẩu DB (giá trị bạn đặt khi đăng ký)

A-2. Tải tệp lên

Giải nén bản phát hành đã tải về trên máy tính của bạn trước, rồi dùng chương trình FTP (FileZilla, v.v.) tải lên thư mục web gốc của hosting. Tên thư mục web gốc khác nhau tùy nhà cung cấp (www, public_html, html, v.v.).

  • Vì có tới hàng chục nghìn tệp nên tải lên qua FTP mất thời gian, và chương trình FTP đôi khi bỏ sót một số tệp khi tải lên hàng nghìn tệp. Nếu nhà cung cấp có chức năng giải nén (trình quản lý tệp trên web), tải tgz/zip lên rồi giải nén trên máy chủ sẽ nhanh và an toàn hơn.
  • Sau khi tải lên, hãy kiểm tra index.php nằm ngay dưới thư mục web gốc. Nếu nó nằm sâu thêm một cấp như zittme/index.php, bạn cần chuyển nội dung bên trong thư mục đó ra thư mục web gốc. Khi đó cũng phải chuyển cả các tệp ẩn như .htaccess.
  • Tạo thư mục files trong thư mục web gốc và đặt quyền 707 (hoặc 777) trong trình quản lý tệp. Mọi tệp tải lên và bộ nhớ đệm của website đều được lưu trong thư mục này.

A-3. Truy cập

Khi bạn truy cập tên miền của mình (hoặc địa chỉ tạm do hosting cấp) bằng trình duyệt, trình hướng dẫn cài đặt sẽ bắt đầu. Hãy chuyển tới mục "Trình hướng dẫn cài đặt" bên dưới.

Hầu hết web hosting dùng Apache nên tệp .htaccess có trong bản phát hành sẽ tự xử lý địa chỉ ngắn. Không cần cài đặt thêm.

---

B. Cài đặt trên máy chủ riêng (VPS)

Hướng dẫn này dành cho máy chủ có thể truy cập shell (SSH).

B-1. Tải tệp lên

tar xzf zittme-0.0.01.tgz -C /var/www/mysite
mkdir -p /var/www/mysite/files
chown -R www-data:www-data /var/www/mysite

Tài khoản máy chủ web (trong ví dụ trên là www-data) phải ghi được vào thư mục files thì quá trình cài đặt mới tiếp tục. Mọi tệp tải lên, bộ nhớ đệm và cài đặt của website đều được lưu trong thư mục này.

B-2. Tạo cơ sở dữ liệu

CREATE DATABASE mysite DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'mysite'@'localhost' IDENTIFIED BY '비밀번호';
GRANT ALL PRIVILEGES ON mysite.* TO 'mysite'@'localhost';
FLUSH PRIVILEGES;

B-3. Cấu hình máy chủ web (nginx)

Zittme cung cấp công cụ hỗ trợ cấu hình nginx.

  • Màn hình kiểm tra môi trường của trình hướng dẫn cài đặt: phát hiện môi trường máy chủ và tạo cấu hình phù hợp cùng lệnh áp dụng.
  • common/scripts/setup-nginx.sh trong bản phát hành: script áp dụng tất cả trong một lần.
  • Ví dụ cấu hình: common/manual/server_config/zittme-nginx.conf

Nếu dùng Apache, tệp .htaccess trong bản phát hành sẽ xử lý, bạn chỉ cần bật mod_rewrite.

---

Trình hướng dẫn cài đặt (chung)

Khi bạn truy cập địa chỉ website bằng trình duyệt, trình hướng dẫn cài đặt sẽ bắt đầu. Làm theo chỉ báo các bước ở phía trên màn hình.

  • Kiểm tra môi trường: tự động kiểm tra máy chủ có đáp ứng yêu cầu hay không. Nếu có vấn đề, hướng dẫn sẽ hiện theo từng mục.
  • Đồng ý giấy phép: Zittme là phần mềm tự do theo GPL v2.
  • Nhập thông tin DB: với web hosting, nhập các giá trị đã kiểm tra ở A-1; với máy chủ riêng, nhập các giá trị đã tạo ở B-2.
  • Tạo tài khoản quản trị: đặt email và mật khẩu của quản trị viên cao nhất của website.

Khi cài đặt xong, website sẽ mở cùng menu mặc định (Trang chủ, Bảng tin), và trình soạn thảo mặc định được đặt là zittEditor.

Những việc cần kiểm tra ngay sau khi cài đặt

  • Truy cập trang quản trị: your-site/admin
  • Cài đặt hệ thống > Cài đặt cơ bản: tiêu đề website, ngôn ngữ mặc định, múi giờ
  • Cài đặt màn hình quản trị: vị trí menu quản trị (trên, trái, phải), đăng ký logo quản trị
  • Kiểm tra tải tệp lên: viết thử một bài trong bảng tin và đính kèm ảnh. Nếu thất bại, hãy kiểm tra quyền ghi của thư mục files/. Với web hosting, bạn có thể chỉnh quyền thành 707 hoặc 755 trong trình quản lý tệp.

Cập nhật

Khi bảng điều khiển quản trị hiện thông báo có phiên bản mới, hãy tải bản phát hành mới từ trang phát hành và ghi đè lên. Sau khi ghi đè, truy cập trang quản trị thì các thay đổi DB cần thiết sẽ được áp dụng tự động. Trước khi cập nhật, luôn sao lưu files/ và DB.