Skip to content

Latest commit

 

History

History
277 lines (208 loc) · 10.6 KB

README_vi.md

File metadata and controls

277 lines (208 loc) · 10.6 KB

Xampp vHosts Manager

Hệ thống quản lý các tên miền ảo và chứng chỉ SSL tự ký cho Xampp trên nền hệ điều hành Windows.

Ngôn ngữ hướng dẫn >>> ( Tiếng Anh | Tiếng Việt )

Xampp vHosts Manager GitHub cover

Có ai đó đã từng hỏi tôi

Làm thế nào để cấu hình và quản lý các tên miền ảo cho Xampp trên hệ điều hành Windows?

Một vài người khác lại hỏi

Làm thế nào để thêm chứng chỉ SSL tự ký vào các tên miền ảo của Xampp nhanh nhất có thể và dễ dàng quản lý chúng mà không gặp rắc rối khi sử dụng các lệnh OPENSSL?

Vì thế, dự án này đã ra đời, nhằm tăng cường sức mạnh cho Xampp, giúp người dùng tận dụng các tài nguyên vốn có của Xampp để thực hiện các mục đích trên một cách nhanh chóng và dễ dàng nhất có thể.

Lưu ý: Hiện tại dự án này chỉ hỗ trợ người dùng Windows.

Những tính năng của ứng dụng

  • Tạo tên miền ảo.
  • Xóa tên miền ảo.
  • Hiển thị thông tin của tên miền ảo.
  • Liệt kê tất cả các tiên miền ảo hiện có.
  • Thêm chứng chỉ SSL cho một tên miền ảo.
  • Gỡ bỏ chứng chỉ SSL của tên miền ảo.
  • Thay đổi Document Root của một tên miền ảo.
  • Dừng dịch vụ Apache Httpd.
  • Chạy dịch vụ Apache Httpd.
  • Khởi động lại dịch vụ Apache Httpd.

Tổng quan

Hãy tìm đọc một trong những chủ đề sau để tìm hiểu thêm về Xampp vHosts Manager (XVHM).

Sự tương thích

  • XVHM tương thích với tất cả các phiên bản Xampp sử dụng PHP 5.4 trở lên.
  • Hiện tại dự án này chưa hổ trợ các phiên bản Xampp Portable.

Yêu cầu

XVHM tận dụng tối đa những gì có trong Xampp, không cần thêm gì nữa. Vì vậy, bạn chỉ cần những điều sau đây:

  • Đã cài đặt Xampp (lẽ dĩ nhiên).
  • Đã thêm đường dẫn đến thư mục PHP của Xampp vào biến môi trường đường dẫn của Windows.
  • (Tùy chọn thêm) Đã cài đặt Composer.

Lưu ý: Xem tại đây để biết cách thêm đường dẫn vào biến môi trường đường dẫn của Windows.

Cài đặt

Có hai phương pháp cài đặt, thông qua Composer hoặc tải xuống thủ công. Bạn nên sử dụng phương thức thông qua Composer nếu bạn đã cài đặt nó.

Thông qua Composer Create-Project

  • Mở dấu nhắc lệnh.
  • Điều hướng đến thư mục bạn muốn cài đặt XVHM vào.
  • Chạy lệnh composer create-project:
$ composer create-project jackiedo/xampp-vhosts-manager xvhm "1.*"

Dùng phương thức tải về thủ công

  • Tải về phiên bản phát hành mới nhất
  • Giải nén bản cài đặt vào một nơi nào đó (ví dụ: D:\xvhm). Lưu ý: Không nên đặt trong C:\Program Files hoặc bất cứ nơi nào đỏi hỏi quyền Administrator khi ta chỉnh sửa tập tin cấu hình về sau.
  • Mở dấu nhắc lệnh trong chế độ Administrator (run as Administrator).
  • Điều hướng đến thư mục XVHM bạn đã giải nén (ví dụ: cd /D D:\xvhm).
  • Thực thi lệnh xvhost install và làm theo từng bước yêu cầu.
  • Đóng dấu nhắc lệnh (mục đích để xóa các biến tạm).

Lưu ý: Xem tại đây để biết cách mở dấu nhắc lệnh với quyền Administrator.

Cập nhật

Hiện tại, XVHM chưa có cơ chế cập nhật tự động, chúng ta phải thực hiện thủ công từng bước như sau:

  • Sao lưu tệp settings.ini và thư mục cacert trong thư mục XVHM của bạn sang một nơi khác.
  • Xóa bỏ tất cả các tệp và thư mục con bên trong thư mục ứng dụng Xampp vHosts Manager.
  • Tải về phiên bản phát hành mới nhất và giải nén nó vào thư mục ứng dụng XVHM.
  • Sao chép tập tin settings.ini và thư mục cacert đã sao lưu trước đó vào thư mục ứng dụng XVHM trở lại.

Sử dụng

Do đường dẫn đến thư mục ứng dụng XVHM đã được thêm vào biến môi trường đường dẫn trong quá trình cài đặt, bây giờ bạn chỉ cần mở dấu nhắc lệnh (không cần thiết mở với quyền Administrator nữa) ở bất cứ nơi đâu và thực hiện một trong các lệnh xvhost sau:

Hiển thị trợ giúp

Cú pháp:

$ xvhost help

Tạo tên miền ảo mới

Cú pháp:

$ xvhost new [HOST_NAME]

Ví dụ:

$ xvhost new demo.local

Lưu ý: Tham số HOST_NAME là tùy chọn. Nếu bạn không truyền nó vào câu lệnh lệnh, bạn cũng sẽ được yêu cầu nhập thông tin này sau đó.

Hiển thị thông tin của một tên miền ảo hiện có

Cú pháp:

$ xvhost show [HOST_NAME]

Ví dụ:

$ xvhost show demo.local

Liệt kê tất cả các tên miền ảo hiện đang có

Cú pháp:

$ xvhost list

Xóa bỏ một tên miền ảo

Cú pháp:

$ xvhost remove [HOST_NAME]

Ví dụ:

$ xvhost remove demo.local

Thêm chứng chỉ SSL cho một tên miền ảo

Cú pháp:

$ xvhost add_ssl [HOST_NAME]

Ví dụ:

$ xvhost add_ssl demo.local

Gỡ bỏ chứng chỉ SSL của một tên miền ảo

Cú pháp:

$ xvhost remove_ssl [HOST_NAME]

Ví dụ:

$ xvhost remove_ssl demo.local

Thay đổi Document Root của một tên miền ảo

Cú pháp:

$ xvhost change_docroot [HOST_NAME]

Ví dụ:

$ xvhost change_docroot demo.local

Dừng Apache Httpd

Cú pháp:

$ xvhost stop_apache

Chạy Apache Httpd

Cú pháp:

$ xvhost start_apache

Khởi động lại Apache Httpd

Cú pháp:

$ xvhost restart_apache

Đăng ký đường dẫn của ứng dụng

Tính năng này cho phép bạn đăng ký đường dẫn đến thư mục ứng dụng của XVHM vào biến môi trường đường dẫn của Windows. Thông thường, bạn hiếm khi cần điều này. Nó chỉ hữu ích khi bạn cần thay đổi tên thư mục ứng dụng của XVHM hoặc di chuyển nó đến một vị trí khác.

Để thực hiện việc này, sau khi bạn đã thay đổi vị trí hoặc tên của thư mục XVHM, hãy điều hướng đến vị trí mới của thư mục XVHM trong dấu nhắc lệnh và chạy lệnh sau:

Cú pháp:

$ xvhost register_path

Lưu ý: Bạn cần cho phép quy trình này được thực thi với quyền Administrator.

Cấp các quyền cần thiết cho tập tin Windows hosts

Tính năng này sẽ cấp quyền Modify, Read & execute, Read, Write đối với tập tin Windows hosts cho tài khoản Users. Điều này giúp XVHM có thể thêm tên miền vào tập tin Windows hosts mỗi khi bạn tạo miền ảo.

Cú pháp:

$ xvhost grantperms_winhosts

Lưu ý: Bạn cần cho phép quy trình này được thực thi với quyền Administrator.

Cấu hình

Tất cả cấu hình được đặt trong một tệp ini có tên settings.ini nằm trong thư mục ứng dụng của XVHM. Cấu trúc của tập tin này trông như sau:

[Section_1]
setting_1 = "value"
setting_2 = "value"

[Section_2]
setting_1 = "value"
setting_2 = "value"
...

Toàn bộ các cấu hình của XVHM bao gồm:

[DirectoryPaths]
;Đường dẫn đến thư mục Xampp của bạn.
Xampp = "D:\xampp"

[Suggestions]
;Đường dẫn thư mục dùng để đề xuất cho cấu hình DocumentRoot của tập tin vhost config trong mỗi quy trình tạo tên miền ảo.
;Biến {{host_name}} được sử dụng như nơi giữ chỗ cho tên miền ảo.
DocumentRoot = "D:\www\{{host_name}}"

;Một email dùng để đề xuất cho cấu hình ServerAdmin của tập tin vhost config file trong mỗi quy trình tạo tên miền ảo.
AdminEmail = "[email protected]"

[ListViewMode]
;Số lượng tên miền ảo sẽ được hiển thị trên mỗi trang khi liệt kê các tên miền ảo hiện có.
RecordPerPage = "3"

Giấy phép

MIT © Jackie Do

Lời cảm ơn

Hy vọng, ứng dụng này hữu ích cho các bạn.