Trong bài viết đầu tiên của Sub-Series NodeJS, nếu như bạn để ý thì thấy sau khi thực hiện xong việc cài đặt gói phần mềm tải về từ trang chủ của NodeJS, chúng ta đã thử chạy 2 câu lệnh để kiểm tra kết quả cài đặt -
CMD
node -v
:: kết quả: v16.14.2 npm -v
:: kết quả: 8.5.0
Terminal
node -v
# kết quả: v16.14.2 npm -v
# kết quả: 8.5.0
Câu lệnh đầu tiên là để kiểm tra phiên bản của NodeJS đã cài đặt thành công trên máy tính của bạn. Còn câu lệnh thứ hai là để kiểm tra phiên bản của một phần mềm có tên là npm
được đóng gói kèm theo bộ cài đặt của NodeJS. Và bây giờ thì chúng ta mới có thể bắt đầu nói về phần mềm này.
NPM là cái gì?
Vẫn xuất phát từ nhu cầu chia sẻ và tái sử dụng các bộ code miễn phí của cộng đồng lập trình viên. Đâu đó trong một thời điểm lịch sử khoảng 8 tháng sau khi NodeJS xuất hiện, thì một cơ sở dữ liệu cộng đồng dành riêng cho các gói phần mềm package
được viết trên nền NodeJS cũng được chính thức giới thiệu kèm theo một phần mềm quản lý
dành cho người sử dụng có tên là NPM
. Tên viết đầy đủ của NPM
thì như tiêu đề bài viết của chúng ta đã ghi, đó là Node Package Manager
- phần mềm quản lý manager
các gói package
trong môi trường NodeJS
.
Khái niệm package
ở đây được hiểu rộng hơn một chút so với module
mà chúng ta đã biết trước đó. Một package
có thể là một thư viện nhỏ library
cung cấp các công cụ hỗ trợ trong code của chúng ta; Một package
cũng có thể có kích cỡ lớn hơn một chút - đó là một framework
bao gồm nhiều module
để tạo nên một thành phần mang tính kiến trúc trong phần mềm mà chúng ta đang xây dựng; Và thậm chí, một package
cũng có thể là một phần mềm hoàn chỉnh, chạy trên môi trường NodeJS.
Tìm kiếm, cài đặt, và sử dụng các package
Cũng giống với các dự án cộng đồng khác, NPM có một trang web chính thức với đầy đủ tài liệu sử dụng và một công cụ tìm kiếm giúp chúng ta nhanh chóng tìm ra các package
có liên quan tới nhu cầu sử dụng đang được chia sẻ bởi nhiều lập trình viên khác. Và địa chỉ top 1 sau khi mình Google với từ khóa npm
là đây - https://www.npmjs.com/.
Ở góc phía bên phải thì chúng ta có mục tài liệu hướng dẫn là Document
và khu vực đăng ký tài khoản người dùng để tham gia vào cộng đồng lập trình viên đang chia sẻ các gói phần mềm tại npm
. Về giao diện sử dụng dòng lệnh thì chúng ta có các thao tác được liệt kê đầy đủ tại đây - Danh sách đầy đủ các câu lệnh để sử dụng npm
. Tuy nhiên thì bạn không cần phải cố gắng ghi nhớ hết mấy câu lệnh này để bắt đầu sử dụng npm
đâu. Vẫn như mọi khi thôi, chúng ta lưu lại liên kết tham khảo để dùng tới khi cần và chỉ khởi đầu với một vài câu lệnh phổ biến thôi.
Bây giờ chúng ta sẽ thử tìm và cài đặt một package
để sử dụng. Hãy giả định là chúng ta đang cần tìm một phần mềm server
cho web tĩnh giống như code server
đơn giản mà chúng ta đang có ở thời điểm hiện tại đi. Vậy chúng ta sẽ thử tìm kiếm với từ khóa http-server
.
Có ngay một kết quả trùng hợp chính xác exact-match
với từ khóa mà chúng ta tìm kiếm, và có một dòng mô tả bên dưới là - một phần mềm server http
đơn giản không yêu cầu thiết lập gì mà chỉ cần cài đặt về là dùng thôi. Nhấn vào xem ngay.
Phong cách lập tài liệu chung của các package
được chia sẻ tại npm
thì đều sẽ cung cấp cho người sử dụng hướng dẫn cài đặt Installation
và hướng dẫn sử dụng Usage
. Ở đây chúng ta có hướng dẫn cài đặt là một câu lệnh -
CMD | Terminal
npm install --global http-server
Sau khi lệnh cài đặt được thực hiện xong thì chúng ta, xem tới phần hướng dẫn sử dụng Usage
có mô tả cú pháp lệnh thế này -
CMD | Terminal
http-server [path] [options]
Trong đó thì các tham số đầu vào là đường dẫn path
tới thư mục gốc của trang web tĩnh mà chúng ta đang có, tức là thư mục static
, và các tham số phụ không bắt buộc options
. Trong trường hợp không chỉ định path
thì phần mềm http-server
sẽ tìm thư mục public
trong thư mục đang làm việc hiện tại, nếu không tìm thấy thì sẽ xem như thư mục hiện tại sẽ là thư mục gốc của trang web.
Vậy chúng ta chỉ cần di chuyển tới thư mục static
và gõ lệnh http-server
là được. Ở đây thì mình đã di chuyển thư mục nodejs-blog
vào Documents
, nếu bạn vẫn để ở Desktop
thì sửa lại lệnh cd
thành Desktop
nhé.
CMD | Terminal
cd Documents/nodejs-blog/static
http-server
Sau khi khởi chạy phần mềm thì chúng ta sẽ thấy địa chỉ truy cập được in ra trong console
. Thử mở trình duyệt web để kiểm tra ngay thôi.
Tuyệt... Mọi thứ hoạt động hoàn toàn đúng với quảng cáo tại trang tài liệu của package
.
Làm thế nào để sử dụng library
và framework
?
Ứng dụng quan trọng nhất của npm
đối vối chúng ta lúc này là tải về và nhúng các thư viện hỗ trợ hay framework
để giúp chúng ta xây dựng một trang web có logic xử lý ở server linh hoạt hơn so với code server
web tĩnh mà chúng ta đang có ở thời điểm hiện tại. Và để npm
có thể giúp chúng ta nhúng một package
vào một bộ code bất kỳ thì chúng ta cần đăng ký bộ code đó với npm
như một dự án project
. Bây giờ trong console
chúng ta cần quay trở lại thư mục nodejs-blog
để làm việc.
CMD | Terminal
cd ..
Sau đó nói với npm
là chúng ta muốn khởi đầu init
một dự án project
.
CMD | Terminal
npm init
Ở đây chúng ta đang được hướng dẫn từng bước để tạo ra một tệp khai báo để phần mềm npm
có thể hiểu được những thông tin tổng quan của project
mà chúng ta đang thực hiện. Những thao tác này sẽ tạo ra một tệp quản lý package.json
để npm
có thể giúp chúng ta kết nối code của mình tới các package
được tải về.
Sau khi thực hiện xong các khai báo ban đầu cho project
của chúng ta thì bạn sẽ thấy trong thư mục nodejs-blog
có thêm tệp package.json
. Tệp khai báo này có thể được mở và chỉnh sửa thủ công nếu muốn, tuy nhiên thì bạn sẽ cần Google một vài lần trước khi chỉnh sửa để hiểu được ý nghĩa của một số thành phần như - cách đánh số version
của một project
, hay dạng bản quyền phân phối lisence
.
Ở đây có mục script
mà chúng ta cần quan tâm đầu tiên. Đó là 2 lệnh start
và test
để khởi động hoặc chạy thao tác kiểm tra server
mà chúng ta đang code. Lúc này thay vì gõ lệnh node server.js
hay node test.js
trong console
thì chúng ta sẽ gõ npm start
hoặc npm test
. Như vậy thì npm
sẽ có thể giúp chúng ta kiểm tra các thành phần chính trong tệp khai báo package.json
trước khi khởi chạy code - bao gồm cả những thư viện mà chúng ta cài đặt thêm vào project
.
CMD | Terminal
npm test
Tới đây thì chúng ta đã có thể lên trang chủ của npm
để tìm kiếm các thư viện hay framework
liên quan đến tác vụ cần được hỗ trợ, và thực hiện cài đặt về để sử dụng cho project
này.
Dùng thử thư viện marked
hỗ trợ làm việc với mã markdown
của Github
Bây giờ chúng ta sẽ thử cài đặt một thư viện và sử dụng thử trong code của tệp test.js
. Code hiện tại đang hoạt động tốt ở tệp server.js
mà bạn copy/paste
từ test.js
sang thì chúng ta không chạm vào nhé. Thư viện marked
sẽ giúp chúng ta chuyển đổi nội dung văn bản được đánh dấu với mã markdown
của Github thành code HTML.
CMD | Terminal
npm install --save marked
Bạn để ý là ở đây chúng ta sử dụng lệnh cài đặt với tham số phụ --save
khác với ví dụ ở trên là --global
. Tham số --save
sẽ chỉ cài đặt package
này cho project
hiện tại và được lưu trong thư mục node_modules
được npm
tạo ra trong thư mục nodejs-blog
. Và hiển nhiên là package
này sẽ không được nhìn thấy bởi các project
khác mà bạn đang có. Còn nếu sử dụng tham số --global
thì package
mới sẽ được cài đặt tổng bộ và lưu ở thư mục node_modules
trong thư mục người dùng và có thể được tham chiếu tới bởi tất cả các project
.
Sau khi cài đặt xong thì bạn sẽ thấy trong tệp package.json
có thêm thuộc tính dependencies
mô tả các package
mà project
của chúng ta đang lệ thuộc vào để vận hành. Thư viện marked
được ghi lại với phiên bản tối thiểu ^
là 4.0.12
để có thể chắc chắn vận hành được code mà chúng ta viết trong project
có sử dụng đến marked
tính từ thời điểm hiện tại.
nodejs-blog/package.json
{ ... "dependencies": { "marked": "^4.0.12" }
}
Bây giờ chúng ta thử require
và sử dụng marked
trong tệp test.js
thôi. Tuy nhiên thì chúng ta cần một tệp markdown
đặt ngay bên cạnh tệp test.js
để thử đọc và in ra console
.
nodejs-blog/npm-intro.md
## NPM là cái gì? Vẫn xuất phát từ nhu cầu chia sẻ và tái sử dụng các bộ code miễn phí của cộng đồng lập trình viên... [**https://www.npmjs.com/**](https://www.npmjs.com/). ![](https://images.viblo.asia/677ee91c-9549-497f-ae61-3b29a7f3d313.png)
nodejs-blog/test.js
var fsPromises = require('fs/promises'); fsPromises.readFile('npm-intro.md', 'utf-8') .then(function(data) { var markdown = require('marked'); var html = markdown.parse(data); console.log(html); }) .catch(function (error) { console.error(error); });
Ở đây thì chúng ta cần truyền thêm một tham số nữa cho phương thức readFile
để kết quả data
thu được ở dạng ký tự utf-8
, và có thể sẵn sàng sử dụng cho công cụ biên dịch mã markdown
. Chạy npm test
để xem kết quả được in ra ở console
thôi.
Như vậy là chúng ta đã có thể soạn thảo và lưu trữ nội dung của các bài viết blog ở dạng tệp markdown
rồi, bởi vì đã có một phiên dịch viên tên là marked
giúp đỡ. Bạn đã có thể suy nghĩ tới khả năng tự động hóa công việc biên dịch các tệp bai-viet.md
thành các tệp bai-viet.html
đặt trong thư mục nodejs-blog/static/post
.
Thế còn framework
thì sao? Chúng ta đã có thể bắt đầu sử dụng framework
trên nền NodeJS chưa?
Có ngay và luôn. Chúng ta đã có thể bắt đầu học cách sử dụng một framework
ở thời điểm hiện tại. Bởi vì như bạn thấy đấy, việc sử dụng các module
của NodeJS cung cấp cũng rất trừu tượng. Chúng ta cần quan tâm nhiều tới logic hoạt động của các hàm được cung cấp mà chỉ đơn giản là học cách truyền đúng tham số cần thiết để thu được kết quả xử lý với logic input/output
đơn giản.
Tiến trình học tập hiện tại của chúng ta đã khác rất nhiều so với thời điểm mới bắt đầu học những khái niệm lập trình đầu tiên. Chúng ta không cần phải chờ đợi cho đến khi biến hết mọi thứ về các module
mặc định của NodeJS cung cấp rồi mới tìm hiểu những công nghệ ở lớp trừu tượng cao hơn. Và thậm chí việc học ngược lại các module
mặc định của NodeJS khi chúng ta đang sử dụng các framework
sẽ đem cho chúng ta nhiều cảm hứng học tập hơn. Bởi vì chúng ta sẽ học tốt hơn trong tiến trình xây dựng và hoàn thiện phần mềm mong muốn thay vì chỉ học lý thuyết bằng cách đọc hiểu từ tài liệu của NodeJS cung cấp.
Vậy, chúng ta hãy bắt đầu với một framework
rất phổ biến của NodeJS, giúp chúng ta đơn giản hóa nhiều tác vụ xử lý như phân tích yêu cầu nhận được từ trình duyệt web, phân chia lộ trình xử lý cho các kiểu yêu cầu nhận được, v.v... Đó là ExpressJS - https://expressjs.com/.
(Sắp đăng tải) [ExpressJS] Bài 1 - Làm Quen Với ExpressJS
Song song với việc khởi hành một Sub-Series
mới về ExpressJS
, chúng ta vẫn sẽ tiếp tục tìm hiểu những kiến thức về các module
mặc định của NodeJS có liên quan đến những yếu tố được sử dụng khi dùng ExpressJS
. Mình rất hy vọng là bạn sẽ tiếp tục đồng hành cùng mình trong chặng đường tự học ExpressJS
xuất phát từ đây.
Hẹn gặp lại bạn trong các bài viết tiếp theo.
(Sắp đăng tải) [NodeJS] Bài 6 - Từ Từ Để Xem Chúng Ta Cần Học Thêm Gì Tiếp Theo Đã. Học Theo Cách Tự Nhiên Mà!