Tạo và Vận Hành Dự Án FacturaScripts Trên ServBay
FacturaScripts là giải pháp ERP (Hoạch định nguồn lực doanh nghiệp) và CRM (Quản lý quan hệ khách hàng) mã nguồn mở mạnh mẽ, linh hoạt, rất phù hợp với doanh nghiệp vừa, nhỏ và cá nhân kinh doanh tự do. Với môi trường phát triển web cục bộ tiện lợi mà ServBay cung cấp, bạn có thể dễ dàng tạo, kiểm thử và vận hành dự án FacturaScripts trên hệ điều hành macOS mà không cần cấu hình phức tạp.
Bài hướng dẫn này sẽ giúp bạn từng bước thiết lập và cấu hình FacturaScripts local trên ServBay.
Tổng Quan Về FacturaScripts
FacturaScripts là phần mềm ERP & CRM mã nguồn mở phát triển dựa trên PHP và Bootstrap, mục tiêu hỗ trợ doanh nghiệp quản lý các quy trình cốt lõi như:
- Lập và quản lý hoá đơn
- Kế toán
- Quản lý tồn kho
- Quản lý khách hàng & nhà cung cấp
- Quản lý dự án
- Và nhiều tính năng khác qua các module, plugin mở rộng...
Là dự án mã nguồn mở phát triển liên tục, FacturaScripts có cộng đồng hỗ trợ mạnh mẽ và cho phép người dùng tuỳ biến tính năng phù hợp với nhiều nhu cầu kinh doanh khác nhau.
Những Tính Năng Và Lợi Thế Nổi Bật Của FacturaScripts
- Mã nguồn mở & miễn phí: Không tốn chi phí bản quyền, tự do sử dụng, chỉnh sửa và phân phối.
- Chức năng toàn diện: Đáp ứng hầu hết nghiệp vụ cốt lõi cho doanh nghiệp vừa & nhỏ, giải pháp tích hợp mọi mặt.
- Dễ sử dụng: Giao diện trực quan, thân thiện, dễ tiếp cận cho người dùng mới.
- Khả năng mở rộng cao: Chợ plugin phong phú cùng API mở, dễ dàng bổ sung tính năng hoặc tích hợp hệ thống khác.
- Truy cập đa nền tảng: Dựa trên web, tương thích mọi thiết bị có trình duyệt hiện đại.
- Cộng đồng hỗ trợ sôi động: Được cộng đồng lập trình viên toàn cầu trợ giúp khi gặp vấn đề.
- Hỗ trợ đa ngôn ngữ: Đa dạng giao diện tiếng bản địa cho nhiều khu vực.
Ưu Thế Khi Chạy FacturaScripts Trên ServBay
ServBay là môi trường phát triển web cục bộ hiện đại dành cho lập trình viên, lý tưởng để vận hành các ứng dụng PHP như FacturaScripts. ServBay tích hợp đầy đủ thành phần thiết yếu như máy chủ web Apache/Nginx, nhiều phiên bản PHP, cơ sở dữ liệu MySQL/MariaDB/PostgreSQL, Redis... và tất cả đều quản lý dễ dàng qua giao diện đồ hoạ trực quan.
Những lợi ích và quy trình chính khi sử dụng ServBay vận hành FacturaScripts local:
- Môi trường tích hợp: ServBay đã cài đặt và cấu hình sẵn toàn bộ thành phần cần thiết (web, PHP, database), giúp bạn không phải thao tác thủ công từng phần mềm riêng lẻ.
- Quản lý phiên bản: Dễ dàng chuyển đổi giữa các phiên bản PHP tương thích với các bản khác nhau của FacturaScripts hoặc cho mục đích thử nghiệm.
- Quản trị cơ sở dữ liệu: Có sẵn phpMyAdmin, Adminer... để bạn nhanh chóng tạo, cấu hình database & user cho FacturaScripts.
- Cấu hình website đơn giản: Tạo site local, gán domain, thư mục gốc, web server và phiên bản PHP rất nhanh chóng bằng giao diện đồ hoạ của ServBay.
- Quản lý Hosts tự động: ServBay tự động sửa file hosts hệ điều hành để bạn có thể truy cập site local bằng domain tuỳ chọn (như
facturascripts.servbay.demo
). - Hỗ trợ SSL: Cấu hình SSL cục bộ bằng User CA của ServBay hoặc thông qua dịch vụ ACME công khai, mô phỏng môi trường thực tế.
Các bước chính để chạy FacturaScripts trên ServBay:
- Tải mã nguồn FacturaScripts.
- Tạo thư mục dự án dưới thư mục gốc web trên ServBay.
- Tạo cơ sở dữ liệu và user cho FacturaScripts.
- Thiết lập máy chủ web (Apache/Nginx) trỏ về thư mục dự án.
- Bật các extension PHP cần thiết.
- Truy cập domain local qua trình duyệt và hoàn tất cài đặt FacturaScripts.
Điều Kiện Chuẩn Bị
Trước khi bắt đầu, bạn cần đảm bảo:
- Đã tải, cài đặt và khởi động thành công ServBay trên macOS. Xem trang chủ ServBay để lấy bản mới nhất.
- Các gói phần mềm thiết yếu (Apache/Nginx, PHP phù hợp và MySQL/MariaDB) đã bật và hoạt động trong giao diện ServBay.
- Bạn có kiến thức cơ bản về phát triển web và cơ sở dữ liệu.
Tạo Dự Án FacturaScripts (Tải Về Gói Zip)
Đây là cách cài FacturaScripts local phổ biến, đơn giản và nhanh chóng nhất.
Tải FacturaScripts:
- Truy cập trang tải về chính thức của FacturaScripts https://facturascripts.com/descargar.
- Tìm bản ổn định mới nhất dạng
.zip
rồi tải về máy Mac của bạn.
Tạo thư mục dự án:
- Mở Finder, điều hướng tới thư mục gốc lưu website local trong ServBay. Theo mặc định là
/Applications/ServBay/www/
. - Tạo một thư mục mới trong đó để chứa dự án FacturaScripts (ví dụ: đặt tên là
facturascripts_project
). - Đường dẫn đầy đủ ví dụ:
/Applications/ServBay/www/facturascripts_project
- Mở Finder, điều hướng tới thư mục gốc lưu website local trong ServBay. Theo mặc định là
Giải nén tệp tin:
- Tìm file
.zip
vừa tải, nhấp đôi để giải nén. - Sao chép hoặc di chuyển toàn bộ các tệp/thư mục sau khi giải nén (như
index.php
,Core
,Dinamic
,Plugins
...) vào thư mục/Applications/ServBay/www/facturascripts_project
vừa tạo.
- Tìm file
Cấu Hình Khởi Tạo (Cơ Sở Dữ Liệu MySQL...)
FacturaScripts cần một cơ sở dữ liệu để lưu toàn bộ dữ liệu kinh doanh, người dùng và cấu hình hệ thống. Bạn sẽ sử dụng MySQL hoặc MariaDB được quản lý bởi ServBay.
Đảm bảo database server hoạt động:
- Mở ứng dụng ServBay.
- Chọn mục "Packages" bên trái – click MySQL hoặc MariaDB (chọn loại database bạn muốn dùng).
- Đảm bảo database đó đang bật. Nếu chưa, bấm nút bật bên cạnh.
Tạo cơ sở dữ liệu & user:
- Bạn có thể dùng phpMyAdmin tích hợp trong ServBay (kèm theo MySQL/MariaDB) hoặc tạo qua command line. Dùng phpMyAdmin sẽ trực quan hơn cho người mới.
- Dùng phpMyAdmin (khuyến nghị):
- Trong giao diện ServBay, tìm mục Database. Bấm vào biểu tượng phpMyAdmin bên phải gói database bạn dùng. ServBay sẽ mở tab trình duyệt với màn hình đăng nhập phpMyAdmin.
- Đăng nhập bằng user
root
và mật khẩu đã đặt lúc cài đặt ServBay. Nếu quên mật khẩu, có thể reset ngay trong chi tiết gói database của ServBay. - Sau khi đăng nhập, bấm tab "Cơ sở dữ liệu".
- Nhập tên database (nên đặt liên quan tới dự án, ví dụ
facturascripts_servbay_db
). - Chọn mã ký tự và collation phù hợp. Đề xuất nên dùng
utf8mb4_general_ci
hoặcutf8mb4_unicode_ci
để hỗ trợ emoji, ký tự đa dạng. - Bấm "Tạo".
- Tạo user database riêng (khuyến khích): Để tăng bảo mật, không nên dùng user
root
kết nối với FacturaScripts. Nên tạo user riêng:- Về lại trang chủ, chọn tab "Tài khoản người dùng".
- Bấm "Thêm tài khoản người dùng".
- Nhập tên user (ví dụ
facturascripts_servbay_user
). - "Máy chủ" chọn
localhost
hoặc127.0.0.1
. - Tạo mật khẩu mạnh, lưu lại để dùng khi cài FacturaScripts.
- Ở dưới cùng, có thể tick 'Tạo cùng tên database và gán toàn quyền' (nếu database trùng tên user), hoặc "Chỉ định quyền với database cụ thể" rồi tìm database vừa tạo
facturascripts_servbay_db
, tick toàn quyền (ALL PRIVILEGES
). - Bấm "Thực hiện" để lưu.
Lưu thông tin kết nối database: Bạn cần các thông tin sau để điền vào trình cài đặt FacturaScripts:
- Tên database (ví dụ
facturascripts_servbay_db
) - Database username (ví dụ
facturascripts_servbay_user
) - Mật khẩu user
- Host (thông thường là
localhost
hoặc127.0.0.1
) - Cổng (MySQL/MariaDB mặc định là
3306
, kiểm tra lại trên ServBay nếu khác)
- Tên database (ví dụ
Thiết Lập Máy Chủ Web (Apache hoặc Nginx)
Giờ cần cho ServBay biết phải truy cập tới dự án FacturaScripts qua máy chủ web nào. Cả Apache lẫn Nginx đều được ServBay hỗ trợ trọn vẹn.
Bảo đảm web server hoạt động:
- Trong giao diện "Packages" của ServBay, xác nhận Apache hoặc Nginx đã bật.
Thêm website mới:
- Chọn mục "Site" (Trang web) bên cạnh trái.
- Bấm nút "+" phía trên danh sách để tạo cấu hình site mới.
- Điền các thông tin:
- Tên (Name): Đặt tên mô tả ví dụ
FacturaScripts Demo Site
. - Tên miền (Domain): Chọn tên miền local, ví dụ
facturascripts.servbay.demo
(phù hợp chuẩn khuyến nghị của ServBay dùng hậu tố.servbay.demo
). - Loại website: Chọn
PHP
. - Thư mục gốc (Root Directory): Chọn đường dẫn tới thư mục chứa mã nguồn FacturaScripts (
/Applications/ServBay/www/facturascripts_project
). Lưu ý: đa số nên trỏ trực tiếp tới thư mục này, trừ khi FacturaScripts yêu cầu khác. - Phiên bản PHP: Chọn phiên bản PHP tương thích với bản FacturaScripts vừa tải. Thường nên dùng PHP 8.1, 8.2 hoặc mới hơn (tham khảo hướng dẫn chính thức).
- Các thiết lập khác: Đa số giữ mặc định. Nếu cần SSL, ServBay hỗ trợ cấu hình SSL nhanh chóng.
- Tên (Name): Đặt tên mô tả ví dụ
Lưu cấu hình & cập nhật Hosts:
- Bấm "Thêm" hoặc "Lưu" ở cuối cửa sổ sau khi hoàn tất thông tin.
- ServBay sẽ tự động cấu hình virtual host (Apache) hoặc server block (Nginx) và chỉnh sửa file hosts (yêu cầu quyền admin) để domain local của bạn về địa chỉ IP
127.0.0.1
. Từ đây, bạn chỉ cần truy cập domain local mà không cần tự thêm vào hosts nữa.
Kiểm tra & bật extension PHP:
- FacturaScripts yêu cầu vài extension PHP:
pdo_mysql
,gd
(xử lý ảnh),intl
(quốc tế hoá),zip
,xml
,curl
... ServBay đã cài sẵn phần lớn, nhưng nếu thiếu thì bạn cần bật thêm. - Cách bật extension trên ServBay:
- Chọn "Languages" → "PHP" trong menu trái.
- Chọn đúng phiên bản PHP mà site của bạn đang sử dụng.
- Vào tab "Extensions".
- Kiểm tra extension cần thiết đã tick chưa. Nếu chưa, tick vào rồi bấm "Apply"/"Save" để lưu.
- Một số extension cần khởi động lại dịch vụ PHP. Làm việc này trong giao diện ServBay.
- FacturaScripts yêu cầu vài extension PHP:
Ví dụ giao diện cấu hình website trên ServBay
Truy Cập Và Hoàn Tất Cài Đặt FacturaScripts
Mọi thứ đã sẵn sàng để khởi chạy trình cài đặt trực tuyến của FacturaScripts.
Mở trình duyệt: Dùng Chrome, Firefox, Safari hoặc trình duyệt yêu thích.
Nhập domain: Trên thanh địa chỉ nhập tên miền local bạn cấu hình, ví dụ
http://facturascripts.servbay.demo
. Nếu đã cấu hình SSL, có thể dùnghttps://facturascripts.servbay.demo
. Nhấn Enter.Trình cài đặt FacturaScripts:
- Nếu cấu hình ServBay, host file, web server và PHP đều đúng, bạn sẽ thấy trang chào mừng hoặc màn hình cài đặt FacturaScripts.
- Chọn ngôn ngữ giao diện.
- Kiểm tra hệ thống: Bộ cài FacturaScripts sẽ tự động kiểm tra môi trường (phiên bản PHP, extension, quyền ghi thư mục...). Nếu mọi thứ đều đúng như hướng dẫn này, tất cả sẽ hiển thị trạng thái thành công. Nếu có cảnh báo/ lỗi, hãy kiểm tra lại extension PHP, quyền thư mục hoặc phiên bản PHP trên ServBay.
- Cấu hình database: Điền thông tin đã chuẩn bị:
- Loại database: MySQL
- Host:
localhost
hoặc127.0.0.1
- Cổng:
3306
(hoặc port khác nếu chọn trong ServBay) - Tên database:
facturascripts_servbay_db
- User:
facturascripts_servbay_user
- Mật khẩu: (mật khẩu đã tạo)
- Tiền tố bảng: giữ mặc định
fs_
hoặc đổi tuỳ ý
- Tạo tài khoản quản trị viên: Đặt username, password và email cho admin hệ thống. Nhớ lưu lại thông tin này.
- Cài đặt: Bấm nút cài đặt. FacturaScripts sẽ kết nối database, tạo bảng, ghi cấu hình.
Hoàn tất cài đặt:
- Sau khi thành công, có thể bạn sẽ được yêu cầu xoá thư mục
install
khỏi thư mục gốc dự án để bảo mật. Hãy làm theo khuyến cáo. - Lúc này, bạn đã có thể truy cập FacturaScripts qua
http://facturascripts.servbay.demo
(hoặc bản https), đăng nhập bằng tài khoản admin vừa tạo và bắt đầu sử dụng!
- Sau khi thành công, có thể bạn sẽ được yêu cầu xoá thư mục
Giải Đáp Một Số Câu Hỏi Thường Gặp (FAQ)
- FacturaScripts báo thiếu extension PHP khi cài đặt?
- Hãy vào ServBay, chọn "Languages" → "PHP", chọn đúng phiên bản PHP đang chạy, vào tab "Extensions", rồi tick bật extension cần thiết (ví dụ
opcache
), bấm "Apply" và khởi động lại PHP.
- Hãy vào ServBay, chọn "Languages" → "PHP", chọn đúng phiên bản PHP đang chạy, vào tab "Extensions", rồi tick bật extension cần thiết (ví dụ
- Truy cập
facturascripts.servbay.demo
bị lỗi 'Forbidden' hoặc trắng trang?- Kiểm tra xem Apache/Nginx và PHP trên ServBay đã bật chưa. Xác nhận thư mục gốc site trỏ chính xác tới dự án FacturaScripts. Nếu trắng trang, có thể do lỗi PHP - hãy xem log lỗi của web server/PHP trên ServBay. Nếu 'Forbidden', kiểm tra lại quyền đọc/ghi file của thư mục dự án và các thư mục như
Dinamic
.
- Kiểm tra xem Apache/Nginx và PHP trên ServBay đã bật chưa. Xác nhận thư mục gốc site trỏ chính xác tới dự án FacturaScripts. Nếu trắng trang, có thể do lỗi PHP - hãy xem log lỗi của web server/PHP trên ServBay. Nếu 'Forbidden', kiểm tra lại quyền đọc/ghi file của thư mục dự án và các thư mục như
- Lỗi kết nối database FacturaScripts?
- Kiểm tra MySQL/MariaDB đã bật và port đúng chưa (thường là
3306
). Kiểm tra kỹ các thông tin kết nối nhập trong trình cài đặt FacturaScripts so với thông tin bạn đã tạo trong ServBay.
- Kiểm tra MySQL/MariaDB đã bật và port đúng chưa (thường là
Tổng Kết
Với môi trường ServBay mạnh mẽ, việc cài đặt và vận hành FacturaScripts trên macOS trở nên vô cùng đơn giản. Tất cả phần mềm phụ thuộc (web server, PHP, database) đều có sẵn, cấu hình qua giao diện đồ hoạ rất thuận tiện. Hãy làm theo hướng dẫn trên, bạn sẽ nhanh chóng dựng được môi trường phát triển hoặc test local FacturaScripts, tập trung phát triển nghiệp vụ và khám phá tính năng phần mềm, thay vì loay hoay cấu hình kỹ thuật phức tạp. Sự linh hoạt, tiện lợi của ServBay chắc chắn sẽ nâng cao hiệu suất phát triển local của bạn.