chore: add tests, update docs and actions (#299)

* docs: update documentation

* feat: validate-inputs has it's own pyproject

* security: mask DOCKERHUB_PASSWORD

* chore: add tokens, checkout, recrete docs, integration tests

* fix: add `statuses: write` permission to pr-lint

php-version-detect/action.yml

@@ -15,6 +15,10 @@ inputs:
     description: 'Default PHP version to use if no version is detected.'
     required: false
     default: '8.2'
+  token:
+    description: 'GitHub token for authentication'
+    required: false
+    default: ''
 
 outputs:
   php-version:
@@ -56,6 +60,11 @@ runs:
 
         echo "Input validation completed successfully"
 
+    - name: Checkout Repository
+      uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      with:
+        token: ${{ inputs.token || github.token }}
+
     - name: Parse PHP Version
       id: parse-version
       uses: ./version-file-parser