This commit is contained in:
wangjinlei
2022-12-07 10:37:51 +08:00
parent 1271058def
commit c7cdf8a31f
668 changed files with 116142 additions and 20 deletions

View File

@@ -0,0 +1,53 @@
Contributing
============
Issue tracker
-------------
The Issue tracker serves mainly as a place to report bugs and request new features.
Please do not abuse it as a general questions or troubleshooting location.
General troubleshooting
-------------
For these questions please use [Discussions](https://github.com/mpdf/mpdf/discussions). Add your enquiry
to appropriate category and as always, include a reproducible code example when applicable (see code example guidelines below).
You can also use the [mpdf tag](https://stackoverflow.com/questions/tagged/mpdf)
at [Stack Overflow](https://stackoverflow.com/)
as the StackOverflow user base is more likely to answer you in a timely manner.
When doing so, make sure you comply to StackOverflow question guidelines.
Bug reports
-------------
* Bug reports **MUST** contain a small example in php/html that reproduces the bug.
* The code example **MUST** be reproducible by copy&paste assuming composer dependencies are installed. That means:
* No calling unrelated funcions,
* an actual final HTML code has to be present, pasting a template file is not enough,
* if the bug considers import or fonts, example source PDF/TTF/etc files have to be included.
* Failing to provide necessary information or not using the issue template will cause the issue to be closed until required information is provided.
* Please report one feature or one bug per issue.
Feature requests
-------------
Feature requests have to be labeled as such and have to include reasoning for the change in question.
Pull requests
-------------
Pull requests should be always based on the default [development](https://github.com/mpdf/mpdf/tree/development)
branch except for backports to older versions.
Guidelines:
* Use an aptly named feature branch for the Pull request.
* Only files and lines affecting the scope of the Pull request must be affected.
* Make small, *atomic* commits that keep the smallest possible related code changes together.
* Code must be accompanied by a unit test testing expected behaviour whenever possible.
* To be incorporated, the PR should contain a change in the CHANGELOG.md file describing itself
When updating a PR, do not create a new one, just `git push --force` to your former feature branch, the PR will
update itself.

1
vendor/mpdf/mpdf/.github/FUNDING.yml vendored Normal file
View File

@@ -0,0 +1 @@
custom: https://www.paypal.me/mpdf

View File

@@ -0,0 +1,29 @@
---
name: Bug report 🐛
about: The library does not work as expected (please use not for troubleshooting)
---
<!--
Fill in provided template with information about the bug
Provide a short and reproducible code example
⚠ Failing to provide necessary information will cause the issue to be closed until appropriately updated.
See Contributing guidelines for further information
-->
### I found this bug
### This is mPDF and PHP version and environment (server/fpm/cli etc) I am using
### This is the PHP code snippet I use
```
<?php
```
### This is the HTML/CSS code snippet I use
```
```

View File

@@ -0,0 +1,8 @@
---
name: Feature request 🚀
about: I would like to have a new functionality added
---
# Feature request
<!-- Please describe the new functionality as best as you can. -->

View File

@@ -0,0 +1,7 @@
contact_links:
- name: General questions and troubleshooting ❓
url: https://github.com/mpdf/mpdf/discussions
about: You can use Github Discussions for general questions and troubleshooting. Please note that asking at Stack Overflow will probably be more successful.
- name: QA at Stack Overflow ❓
url: https://stackoverflow.com/questions/tagged/mpdf
about: Ask at Stack Overflow for a greater chance of a quick and correct answer to your questions. Make sure to comply to SO rules, terms and conditions.

6
vendor/mpdf/mpdf/.github/SECURITY.md vendored Normal file
View File

@@ -0,0 +1,6 @@
How to disclose potential security issues
============
As mPDF does not have a domain or a dedicated contact apart from its Github repository, to prevent
disclosing maintainers' contacts publicly, please create an Issue about the security issue with means to contact you.
We will reach out to you as soon as possible.

View File

@@ -0,0 +1,42 @@
# https://help.github.com/en/categories/automating-your-workflow-with-github-actions
name: "Code coverage"
on:
push:
branches:
- "development"
- "coverage"
jobs:
coverage:
name: "Code coverage"
runs-on: ${{ matrix.operating-system }}
strategy:
matrix:
php-version:
- "7.4"
operating-system: [ubuntu-latest]
steps:
- name: "Checkout"
uses: "actions/checkout@v2"
- name: "Install PHP"
uses: "shivammathur/setup-php@v2"
with:
coverage: "xdebug"
php-version: "${{ matrix.php-version }}"
extensions: "mbstring, gd, bcmath, bz2"
tools: composer:v2
- name: "Install dependencies"
run: "composer install --no-interaction --no-progress"
- name: "Code coverage"
run: composer coverage

View File

@@ -0,0 +1,43 @@
# https://help.github.com/en/categories/automating-your-workflow-with-github-actions
name: "Coding standard check"
on:
pull_request:
push:
branches:
- "development"
- "test"
jobs:
cs:
name: "Coding standard"
runs-on: ${{ matrix.operating-system }}
strategy:
matrix:
php-version:
- "7.4"
operating-system: [ubuntu-latest]
steps:
- name: "Checkout"
uses: "actions/checkout@v2"
- name: "Install PHP"
uses: "shivammathur/setup-php@v2"
with:
coverage: "none"
php-version: "${{ matrix.php-version }}"
extensions: "mbstring"
tools: composer:v2
- name: "Install dependencies"
run: "composer install --no-interaction --no-progress"
- name: "CS"
run: composer cs

View File

@@ -0,0 +1,52 @@
# https://help.github.com/en/categories/automating-your-workflow-with-github-actions
name: "CI"
on:
pull_request:
push:
branches:
- "master"
- "development"
- "test"
jobs:
tests:
name: "Tests"
runs-on: ${{ matrix.operating-system }}
strategy:
fail-fast: false
matrix:
php-version:
- "5.6"
- "7.0"
- "7.1"
- "7.2"
- "7.3"
- "7.4"
- "8.0"
- "8.1"
operating-system: [ubuntu-latest, windows-latest]
steps:
- name: "Checkout"
uses: "actions/checkout@v2"
- name: "Install PHP"
uses: "shivammathur/setup-php@v2"
with:
coverage: "none"
php-version: "${{ matrix.php-version }}"
extensions: "mbstring, gd, bcmath, bz2"
tools: composer:v2
ini-values: error_reporting=-1
- name: "Install dependencies"
run: "composer install --no-interaction --no-progress"
- name: "Tests"
run: composer test