Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Docs: missing pieces

Đang mở
  • Có gì không ổn?
#672 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tài liệu
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Ít trao đổi
Công nghệ
php
Lĩnh vực
documentation

Hướng nghiên cứu

Hãy bắt đầu bằng cách xem xét ví dụ tối thiểu được đề xuất trong page/index.html và page/index.php, sau đó kiểm tra cấu trúc tài liệu hiện có trước khi sắp xếp các chủ đề được liệt kê. Issue này bao gồm Getting Started, cài đặt, User Guide, các tutorial và Further Reading; công việc được xem là hoàn tất khi các phần và phần giải thích được yêu cầu đã được tài liệu hóa cùng với các liên kết và ví dụ phù hợp.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Overview:

Explain the following:

  • the difference between Page View, Page Logic, API View/Logic, components, partials.
  • HTML is concatenated/assembled before DOM processing.
  • How the DOM document is manipulated with data-bind.
  • PHP is optional and added only when needed by the developer.
  • Dynamic route filenames can be used with @.
  • Magic files like _header, _footer, and _common, and when not to use with partials.
  • Logic methods go, do_* with links to read more about advanced usage (go_after, for example).
  • Where client-side build tooling fits.
  • Dependency injection and logic files (lazy loading).
  • Database access.
  • Object oriented alternatives to GLOBAL usage.

A minimal example project can be shown with page/index.html and how to manipulate the page in page/index.php.

Next page: Getting started to get set up for development quickly.

Getting started:

  • I want to build my first webpage.
  • I want to make my page dynamic.
  • I want to build an API.
  • I want to update part of a page.
  • I want reusable page parts.

Next page: information about installation on different platforms, or using gt commands

Installation:

gt commands:

Blueprints:

After this, Tutorials section.

User guide:

  • Request-response lifecycle
  • Running your application (gt run = serve + build + cron)
  • Project layout
  • Application architecture
  • Web servers (inbuilt, nginx, lighttpd, apache)
  • URIs
  • Page View
  • Dynamic URIs
  • Headers and footers
  • Partial template pages
  • Page Logic
  • Protected globals
  • User input
  • Cookies
  • Sessions
  • Dynamic pages with the DOM
  • Custom HTML components
  • Database
  • Client side assets
  • API development
  • Security
  • Configuration
  • Client side build system
  • Coding styleguide

Further reading:

  • Distinct Logic Authority
  • SPA, MPA and Hypermedia (SPAs break hypermedia, MPAs often have less UX, multi-pass rendering)
  • Fluid User Experience with Flux
  • Speed & benchmarks
  • Caching
  • Service workers
  • Repository-Entity pattern
Ngôn ngữ chính
PHP
Star
26
Fork
6
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của phpgt/WebEngine

Tất cả issue của phpgt/WebEngine

Issue tương tự

Thêm issue về PHP

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.