Added the --php option to ronin decode (closes #213).

lib/ronin/cli/commands/decode.rb

@@ -49,6 +49,7 @@ module Commands
       #     -P, --powershell                 Encodes the data as a PowerShell String
       #         --punycode                   Decodes the data as Punycode
       #     -Q, --quoted-printable           Decodes the data as Quoted Printable
+      #     -p, --php                        PHP decodes the data
       #     -R, --ruby                       Ruby decodes the data
       #         --uudecode                   uudecodes the data
       #     -x, --xml                        XML decodes the data
@@ -155,6 +156,12 @@ class Decode < StringMethodsCommand
                                     @method_calls << :quoted_printable_decode
                                   end
 
+        option :php, short: '-R',
+                     desc: 'PHP decodes the data' do
+                       require 'ronin/support/encoding/php'
+                       @method_calls << :php_decode
+                     end
+
         option :ruby, short: '-R',
                       desc: 'Ruby decodes the data' do
                         require 'ronin/support/encoding/ruby'

man/ronin-decode.1.md

@@ -78,6 +78,9 @@ Decodes each character of the given data from a variety of formats.
 `-Q`, `--quoted-printable`
 : Decodes the data as Quoted Printable.
 
+`-p`, `--php`
+: PHP decodes the data.
+
 `-R`, `--ruby`
 : Ruby decodes the data.
 
@@ -96,4 +99,4 @@ Postmodern <[email protected]>
 
 ## SEE ALSO
 
-[ronin-encode](ronin-encode.1.md)
+[ronin-encode](ronin-encode.1.md)

spec/cli/commands/decode_spec.rb

@@ -128,6 +128,18 @@
       end
     end
 
+    describe "--php" do
+      let(:argv) { %w[--php] }
+
+      it "must require 'ronin/support/encoding/php'" do
+        expect(require('ronin/support/encoding/php')).to be(false)
+      end
+
+      it "must add :php_decode to #method_calls" do
+        expect(subject.method_calls.last).to eq(:php_decode)
+      end
+    end
+
     describe "--ruby" do
       let(:argv) { %w[--ruby] }